{"_id":"@argo-mcp/argo-wf-client","_rev":"13-f568c8c0354aea8bc3451d036768c274","name":"@argo-mcp/argo-wf-client","dist-tags":{"latest":"1.2.0"},"versions":{"0.1.4":{"name":"@argo-mcp/argo-wf-client","version":"0.1.4","_id":"@argo-mcp/argo-wf-client@0.1.4","maintainers":[{"name":"odinn1984","email":"levan@sleep-coding.com"}],"homepage":"https://github.com/odinn1984/argo-mcp#readme","bugs":{"url":"https://github.com/odinn1984/argo-mcp/issues"},"dist":{"shasum":"8f3d446b7308dd91defc78dfee89c2e8e2255d2c","tarball":"https://registry.npmjs.org/@argo-mcp/argo-wf-client/-/argo-wf-client-0.1.4.tgz","fileCount":7,"integrity":"sha512-vJ4d7bi3Iie3B3uhV6KScI6Nynt40Tpzx/NpiLJVe4cIFkqI4H5j1rgnTfmktrC5+fIDu1jnbkj2+LFnhQeSlw==","signatures":[{"sig":"MEUCIQDKbeUi5LMzMWXceRZxwQ0xxHEVa9itGmzjuOs4B1uJfgIgF00oNNnd2IogsX7RJfUB7zkHafI5slPmf3f7h8A41lw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1060127},"main":"dist/index.mjs","type":"module","types":"dist/index.d.mts","engines":{"node":">=24"},"gitHead":"a9f943869046f4404180caf8b4e62ec681f92dac","scripts":{"dev":"tsdown --watch","gen":"bun scripts/gen-types.ts","lint":"eslint src --max-warnings 0","test":"bun test src","build":"tsdown","clean":"rm -rf dist *.tsbuildinfo","type-check":"tsc --noEmit -p tsconfig.lib.json && tsc --noEmit -p tsconfig.spec.json","test:integration":"bun test test-integration"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5651694a-64e6-410b-8df8-1329acd4048a"}},"repository":{"url":"git+https://github.com/odinn1984/argo-mcp.git","type":"git","directory":"clients/argo-wf-client"},"_npmVersion":"11.15.0","description":"Typed client for the Argo Workflows REST API","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/argo-wf-client_0.1.4_1779734971350_0.3180106772137252","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@argo-mcp/argo-wf-client","version":"1.0.0","_id":"@argo-mcp/argo-wf-client@1.0.0","maintainers":[{"name":"odinn1984","email":"levan@sleep-coding.com"}],"homepage":"https://github.com/odinn1984/argo-mcp#readme","bugs":{"url":"https://github.com/odinn1984/argo-mcp/issues"},"dist":{"shasum":"f67e1c36bc4dffa74dc9881be0975468450753b0","tarball":"https://registry.npmjs.org/@argo-mcp/argo-wf-client/-/argo-wf-client-1.0.0.tgz","fileCount":7,"integrity":"sha512-mnu11Wr4i/66X9H+1INinhM50ZNjBVZUUd3HSTiBXdT/tOuvJZHZ0Rx0XzqpRHMunwJ1lgX9sU8smyViOaGxsg==","signatures":[{"sig":"MEQCIE+sI5UH4dgkJBIdEbaCjyzlV/RPnPV98lXJeGfzRrs9AiAFO43UNN5vA8ahg/r9Tdi886G8SMKlxxeB5ymC8TYz9g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1060127},"main":"dist/index.mjs","type":"module","types":"dist/index.d.mts","engines":{"node":">=24"},"gitHead":"07cf5e8caf4979e37f05dbbf22971e906bdf6c72","scripts":{"dev":"tsdown --watch","gen":"bun scripts/gen-types.ts","lint":"eslint src --max-warnings 0","test":"bun test src","build":"tsdown","clean":"rm -rf dist *.tsbuildinfo","type-check":"tsc --noEmit -p tsconfig.lib.json && tsc --noEmit -p tsconfig.spec.json","test:integration":"bun test test-integration"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5651694a-64e6-410b-8df8-1329acd4048a"}},"repository":{"url":"git+https://github.com/odinn1984/argo-mcp.git","type":"git","directory":"clients/argo-wf-client"},"_npmVersion":"11.15.0","description":"Typed client for the Argo Workflows REST API","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/argo-wf-client_1.0.0_1779826437321_0.05028521378340245","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@argo-mcp/argo-wf-client","version":"1.0.1","_id":"@argo-mcp/argo-wf-client@1.0.1","maintainers":[{"name":"odinn1984","email":"levan@sleep-coding.com"}],"homepage":"https://github.com/odinn1984/argo-mcp#readme","bugs":{"url":"https://github.com/odinn1984/argo-mcp/issues"},"dist":{"shasum":"935b85a05947382e4323a93f6dcf76429f1afd3f","tarball":"https://registry.npmjs.org/@argo-mcp/argo-wf-client/-/argo-wf-client-1.0.1.tgz","fileCount":7,"integrity":"sha512-QFCpWUhK35hKVvRb+ZahJNmebGwUjnPyFJSjaf3ECcadA/gpd67uod7ktdITOKIqNoD8gSdxQ8zNL7IRwI6pDg==","signatures":[{"sig":"MEUCIDgdyip535bhRaVC/qwjH52IBe1p9zYHRJ95u9XSYE9mAiEA3PzwS54OQ76qfpoxm/HoOe13FPDvbQ311lnNR+1D8+0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1060127},"main":"dist/index.mjs","type":"module","types":"dist/index.d.mts","engines":{"node":">=24"},"gitHead":"687e228629f02f65030bae58e9d0788efd9189b5","scripts":{"dev":"tsdown --watch","gen":"bun scripts/gen-types.ts","lint":"eslint src --max-warnings 0","test":"bun test src","build":"tsdown","clean":"rm -rf dist *.tsbuildinfo","type-check":"tsc --noEmit -p tsconfig.lib.json && tsc --noEmit -p tsconfig.spec.json","test:integration":"bun test test-integration"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5651694a-64e6-410b-8df8-1329acd4048a"}},"repository":{"url":"git+https://github.com/odinn1984/argo-mcp.git","type":"git","directory":"clients/argo-wf-client"},"_npmVersion":"11.15.0","description":"Typed client for the Argo Workflows REST API","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/argo-wf-client_1.0.1_1779828197936_0.2200308554452961","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@argo-mcp/argo-wf-client","version":"1.1.0","_id":"@argo-mcp/argo-wf-client@1.1.0","maintainers":[{"name":"odinn1984","email":"levan@sleep-coding.com"}],"homepage":"https://github.com/odinn1984/argo-mcp#readme","bugs":{"url":"https://github.com/odinn1984/argo-mcp/issues"},"dist":{"shasum":"b8bd8eb4bc7445d27f102f71a074e341d96c1b98","tarball":"https://registry.npmjs.org/@argo-mcp/argo-wf-client/-/argo-wf-client-1.1.0.tgz","fileCount":7,"integrity":"sha512-+a6nDAoqCCv+vj7+U4Y1oGuz4RQV42YwbfilDbUaFvsQz8CNyzS5HLXEj03qw5lbK+/UHcLr6S5NX9Ai+hMHVg==","signatures":[{"sig":"MEQCIAz2crtyJEBa/zpDqf90yyqx5EOjn0v+6LKw5FFDLXeZAiAfg91d92lTfUt7uBjwViW73g/yIICErvBI3UPRhQBbNg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1060127},"main":"dist/index.mjs","type":"module","types":"dist/index.d.mts","engines":{"node":">=24"},"gitHead":"d4185594b08b998a555f47460e2f862f60d13ad4","scripts":{"dev":"tsdown --watch","gen":"bun scripts/gen-types.ts","lint":"eslint src --max-warnings 0","test":"bun test src","build":"tsdown","clean":"rm -rf dist *.tsbuildinfo","type-check":"tsc --noEmit -p tsconfig.lib.json && tsc --noEmit -p tsconfig.spec.json","test:integration":"bun test test-integration"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5651694a-64e6-410b-8df8-1329acd4048a"}},"repository":{"url":"git+https://github.com/odinn1984/argo-mcp.git","type":"git","directory":"clients/argo-wf-client"},"_npmVersion":"11.15.0","description":"Typed client for the Argo Workflows REST API","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/argo-wf-client_1.1.0_1779873705082_0.3087957877416372","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@argo-mcp/argo-wf-client","version":"1.2.0","description":"Typed client for the Argo Workflows REST API","type":"module","main":"dist/index.mjs","types":"dist/index.d.mts","repository":{"type":"git","url":"git+https://github.com/odinn1984/argo-mcp.git","directory":"clients/argo-wf-client"},"scripts":{"build":"tsdown","dev":"tsdown --watch","lint":"eslint src --max-warnings 0","type-check":"tsc --noEmit -p tsconfig.lib.json && tsc --noEmit -p tsconfig.spec.json","test":"bun test src","test:integration":"bun test test-integration","gen":"bun scripts/gen-types.ts","clean":"rm -rf dist *.tsbuildinfo"},"engines":{"node":">=24"},"gitHead":"46c346c0941a1769e345e9f129f62b04d723a9d9","_id":"@argo-mcp/argo-wf-client@1.2.0","bugs":{"url":"https://github.com/odinn1984/argo-mcp/issues"},"homepage":"https://github.com/odinn1984/argo-mcp#readme","_nodeVersion":"24.16.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-WjlkD9KeE+u+1ReJ2yk1eVyJtjJkIrmdZtd8N4IAAJi6v3D9bEmp3jwNvME9mhCW++tRoWzPJUHny1fzfdvCLg==","shasum":"9616a57e91fff8fd25c109037a25572ad24b8fab","tarball":"https://registry.npmjs.org/@argo-mcp/argo-wf-client/-/argo-wf-client-1.2.0.tgz","fileCount":7,"unpackedSize":1060127,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD0vGhxiQmbS8M9ygCkL5j/sWLeJpdhCSODQ4MsgsSIAAIhAO7wxV8mG82QmU688+od5OE1PSJxnvwejJNbfhhjcuWM"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5651694a-64e6-410b-8df8-1329acd4048a"}},"directories":{},"maintainers":[{"name":"odinn1984","email":"levan@sleep-coding.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/argo-wf-client_1.2.0_1780352452739_0.5175716115913689"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-25T17:53:32.379Z","modified":"2026-06-01T22:20:53.122Z","0.1.3":"2026-05-25T17:53:32.759Z","0.1.4-git-2af953f.0":"2026-05-25T18:13:51.789Z","0.1.4-git-1b3352e.0":"2026-05-25T18:15:25.755Z","0.1.4-git-329beda.0":"2026-05-25T18:24:48.159Z","0.1.4":"2026-05-25T18:49:31.531Z","1.0.0":"2026-05-26T20:13:57.469Z","1.0.1":"2026-05-26T20:43:18.186Z","1.1.0":"2026-05-27T09:21:45.331Z","1.2.0":"2026-06-01T22:20:52.986Z"},"bugs":{"url":"https://github.com/odinn1984/argo-mcp/issues"},"homepage":"https://github.com/odinn1984/argo-mcp#readme","repository":{"type":"git","url":"git+https://github.com/odinn1984/argo-mcp.git","directory":"clients/argo-wf-client"},"description":"Typed client for the Argo Workflows REST API","maintainers":[{"name":"odinn1984","email":"levan@sleep-coding.com"}],"readme":"# argo-wf-client\n\nTyped TypeScript client for the [Argo Workflows](https://argo-workflows.readthedocs.io/) REST API. Generated from the upstream swagger; resource methods are hand-written on top of an internal `rest-client` lib that is bundled into the published package.\n\nSame code is published to two registries under different scopes:\n\n| Registry        | Scope        | Package                     | Stable (`@latest`) | Prerelease (`@alpha`) | Auth                           |\n| --------------- | ------------ | --------------------------- | :----------------: | :-------------------: | ------------------------------ |\n| npm (npmjs.org) | `@argo-mcp`  | `@argo-mcp/argo-wf-client`  | ✓                  | —                     | none — public                  |\n| GitHub Packages | `@odinn1984` | `@odinn1984/argo-wf-client` | ✓                  | ✓                     | GitHub token (`read:packages`) |\n\nFor stable releases, use whichever you prefer (npmjs is the easier install). For prerelease/alpha builds, only GitHub Packages has them.\n\n## Install — npmjs (recommended for stable)\n\n```sh\nnpm install @argo-mcp/argo-wf-client\n```\n\nNo `.npmrc` config needed. Stable releases only — for alpha builds, use GitHub Packages below.\n\n## Install — GitHub Packages\n\nGitHub Packages requires auth even for reads. Point the `@odinn1984` scope at the GitHub registry with a token that has `read:packages` — add to `~/.npmrc` (user-level) or a project-level `.npmrc`:\n\n```ini\n@odinn1984:registry=https://npm.pkg.github.com\n//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}\n```\n\nThen:\n\n```sh\nnpm install @odinn1984/argo-wf-client          # newest stable release\nnpm install @odinn1984/argo-wf-client@alpha    # latest prerelease build\n```\n\nThe internal workspace dependencies are bundled into the published package — nothing else to install on either registry.\n\n## Usage\n\nReplace the import with whichever scope you installed (`@argo-mcp/argo-wf-client` from npmjs or `@odinn1984/argo-wf-client` from GitHub Packages). Example below uses the npmjs scope.\n\n```ts\nimport { ArgoWorkflowsClient } from '@argo-mcp/argo-wf-client'\n\nconst client = new ArgoWorkflowsClient({\n  baseUrl: 'https://argo.example.com',\n  auth: { kind: 'bearer', token: process.env.ARGO_TOKEN! },\n  namespace: 'argo', // default; omit and pass per-call\n})\n\n// One page\nconst page = await client.workflows.list('argo', { listOptions: { limit: '100' } })\n\n// All pages, lazily (walks `continue` tokens)\nfor await (const wf of client.workflows.listAll('argo')) {\n  console.log(wf.metadata?.name)\n}\n\n// Stream watch events\nconst ctrl = new AbortController()\nfor await (const ev of client.workflows.watch('argo', undefined, ctrl.signal)) {\n  console.log(ev.type, ev.object?.metadata?.name)\n}\n\n// Stream workflow logs\nfor await (const entry of client.workflows.logs('hello-world-abc', 'argo')) {\n  console.log(entry.content)\n}\n```\n\n## Resources\n\n| Accessor                          | Service                          | Count |\n| --------------------------------- | -------------------------------- | ----- |\n| `client.info`                     | InfoService                      | 4     |\n| `client.workflows`                | WorkflowService                  | 17    |\n| `client.workflowTemplates`        | WorkflowTemplateService          | 6     |\n| `client.clusterWorkflowTemplates` | ClusterWorkflowTemplateService   | 6     |\n| `client.cronWorkflows`            | CronWorkflowService              | 8     |\n| `client.archivedWorkflows`        | ArchivedWorkflowService          | 7     |\n| `client.artifacts`                | ArtifactService (binary)         | 5     |\n| `client.eventSources`             | EventSourceService               | 7     |\n| `client.sensors`                  | SensorService                    | 7     |\n| `client.events`                   | EventService                     | 2     |\n| `client.sync`                     | SyncService                      | 4     |\n\n## Errors\n\nEvery failure throws a typed subclass — `instanceof`-narrow at the call site:\n\n```ts\ntry {\n  await client.workflows.get('missing', 'argo')\n} catch (err) {\n  if (err instanceof NotFoundError) { /* ... */ }\n}\n```\n\n## Codegen\n\n`src/generated/{schema-types,operations}.ts` are produced by `scripts/gen-types.ts` and committed. To regenerate after updating the swagger:\n\n```bash\nbun run gen <path-to-argo-wf-swagger.json> src/generated\n```\n\nThe script has no default swagger path — pass it explicitly.\n\n## Tests\n\nUnit + transport-level E2E tests run against an in-process stub HTTP server:\n\n```bash\njust test                # repo-wide\nbun --filter @odinn1984/argo-wf-client test\n```\n\nReal-server integration tests live under `test-integration/` and run against an actual Argo Workflows server. To run them locally:\n\n```bash\njust integration-up      # boot k3d cluster + install Argo Workflows\njust integration-test    # bun --filter @odinn1984/argo-wf-client test:integration\njust integration-down    # tear down\n```\n\nIn CI, `.github/workflows/argo-wf-integration.yml` runs the same recipe on PRs that touch this client or `libs/rest-client`, plus nightly on `main`.\n","readmeFilename":"README.md"}