{"_id":"@argentor/sdk","_rev":"7-e1a22737efce68e240bb573e4bffc637","name":"@argentor/sdk","dist-tags":{"latest":"1.4.7"},"versions":{"1.1.1":{"name":"@argentor/sdk","version":"1.1.1","keywords":["argentor","ai","agent","sdk","client","llm","typescript"],"license":"AGPL-3.0-only","_id":"@argentor/sdk@1.1.1","maintainers":[{"name":"fboiero","email":"fboiero@gmail.com"}],"homepage":"https://github.com/fboiero/Agentor/tree/master/sdks/typescript","bugs":{"url":"https://github.com/fboiero/Agentor/issues"},"dist":{"shasum":"a52150a44ce5e7a033d8dee1f2ad149dae124b35","tarball":"https://registry.npmjs.org/@argentor/sdk/-/sdk-1.1.1.tgz","fileCount":29,"integrity":"sha512-TFDhjAtqarsE1HA7GPoFy4VBm1Pi73N74VCcR1tlfXqp7jDQysezQAeIA6ZUTNV6xu78MuQHhzz+DWx4VjYbNg==","signatures":[{"sig":"MEUCIFOI0lotD3SCodfjjVvinXHiwtlAWd163yp0ZgOq6W2nAiEAzAh6JKm1NGob/aR5EXzktpsj2joh+LYr/D5LIrzgNVA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":145833},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.js"},"./errors":{"types":"./dist/errors.d.ts","import":"./dist/errors.js"},"./streaming":{"types":"./dist/streaming.d.ts","import":"./dist/streaming.js"}},"gitHead":"d180a4e24f42a3e99aa9b21324a9fe64eb08a548","scripts":{"lint":"eslint src/","test":"vitest run","build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"fboiero","email":"fboiero@gmail.com"},"repository":{"url":"git+https://github.com/fboiero/Agentor.git","type":"git","directory":"sdks/typescript"},"_npmVersion":"10.9.4","description":"TypeScript SDK client for the Argentor AI agent framework REST API","directories":{},"_nodeVersion":"22.22.0","_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.0.0","vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^25.6.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.1.1_1776035838851_0.5747594294375502","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@argentor/sdk","version":"1.3.0","keywords":["argentor","ai","agent","sdk","client","llm","typescript"],"license":"AGPL-3.0-only","_id":"@argentor/sdk@1.3.0","maintainers":[{"name":"fboiero","email":"fboiero@gmail.com"}],"homepage":"https://github.com/fboiero/Agentor/tree/master/sdks/typescript","bugs":{"url":"https://github.com/fboiero/Agentor/issues"},"dist":{"shasum":"ce8eb3e01296a00dc3930e0d6b4d433bad452c2d","tarball":"https://registry.npmjs.org/@argentor/sdk/-/sdk-1.3.0.tgz","fileCount":29,"integrity":"sha512-GFjG8CDfXl4sf3wcUcWtWHj0LAvO0qRHbjPcd/Q0ZKTtLqCuNT6q4S9h169saw+pdNQAV00Grm6zKmVWQ0B2mg==","signatures":[{"sig":"MEYCIQDYCv4miwpTV/D0kvs7uTP5klYUmNKrz5/GRQKIR94OAAIhAJgXP0SRejff2i+E6j+e/JTFyWIIYHR8GKGDMrlRoC4/","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":145833},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.js"},"./errors":{"types":"./dist/errors.d.ts","import":"./dist/errors.js"},"./streaming":{"types":"./dist/streaming.d.ts","import":"./dist/streaming.js"}},"gitHead":"2856cbe05c06cee9f909c734372045c2ea052de9","scripts":{"lint":"eslint src/","test":"vitest run","build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"fboiero","email":"fboiero@gmail.com"},"repository":{"url":"git+https://github.com/fboiero/Agentor.git","type":"git","directory":"sdks/typescript"},"_npmVersion":"10.8.2","description":"TypeScript SDK client for the Argentor AI agent framework REST API","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.0.0","vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^25.6.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.3.0_1778450804892_0.5586296607082644","host":"s3://npm-registry-packages-npm-production"}},"1.4.3":{"name":"@argentor/sdk","version":"1.4.3","keywords":["argentor","ai","agent","sdk","client","llm","typescript"],"license":"AGPL-3.0-only","_id":"@argentor/sdk@1.4.3","maintainers":[{"name":"fboiero","email":"fboiero@gmail.com"}],"homepage":"https://github.com/fboiero/Agentor/tree/master/sdks/typescript","bugs":{"url":"https://github.com/fboiero/Agentor/issues"},"dist":{"shasum":"73b75ab8dd72be64fbb7ca8f9bc242ece6eee69e","tarball":"https://registry.npmjs.org/@argentor/sdk/-/sdk-1.4.3.tgz","fileCount":29,"integrity":"sha512-x8BHuXEG2HHee1TsutlZj3BxNrotc+HyR1a3B3gjJ2bUUIPOaWh+3hONo/akEzyIYxMapXFwsN/AqzkI4obZxg==","signatures":[{"sig":"MEYCIQCGQNOB1GmcPc9X1ioxqORseRiZrvwl4DNiZzp/tj8z6AIhAMwVCwLfducRU6Osk56QgsebAXZFFWswu6BtyRsWduxU","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":150183},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.js"},"./errors":{"types":"./dist/errors.d.ts","import":"./dist/errors.js"},"./streaming":{"types":"./dist/streaming.d.ts","import":"./dist/streaming.js"}},"gitHead":"0db173f3c834891d60c60c317eb9fbbb5044c9fe","scripts":{"lint":"eslint src/","test":"vitest run","build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"fboiero","email":"fboiero@gmail.com"},"repository":{"url":"git+https://github.com/fboiero/Agentor.git","type":"git","directory":"sdks/typescript"},"_npmVersion":"10.8.2","description":"TypeScript SDK client for the Argentor AI agent framework REST API","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.0.0","vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^25.6.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.4.3_1778933893565_0.21563544429091852","host":"s3://npm-registry-packages-npm-production"}},"1.4.4":{"name":"@argentor/sdk","version":"1.4.4","keywords":["argentor","ai","agent","sdk","client","llm","typescript"],"license":"AGPL-3.0-only","_id":"@argentor/sdk@1.4.4","maintainers":[{"name":"fboiero","email":"fboiero@gmail.com"}],"homepage":"https://github.com/fboiero/Agentor/tree/master/sdks/typescript","bugs":{"url":"https://github.com/fboiero/Agentor/issues"},"dist":{"shasum":"ee1e9e71ed3a4c66b1888007ac7b3691544ab1ea","tarball":"https://registry.npmjs.org/@argentor/sdk/-/sdk-1.4.4.tgz","fileCount":29,"integrity":"sha512-4xGSMhng0gFMjf8SO5bfYwtGUYemr7VOlOGgmLVuIAnwvARJMJ+pS7mUbAqwmhCnTbdsUNEwlsD7KoXzOlCQZg==","signatures":[{"sig":"MEQCIHXqRh62002wBhPVfmkRaQCUnMX7NT6VSZrqGeXdOdy5AiAE115zKGs4prXfbStqQYU5MVQCQ4xXtF40/abom/NpnQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":150183},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.js"},"./errors":{"types":"./dist/errors.d.ts","import":"./dist/errors.js"},"./streaming":{"types":"./dist/streaming.d.ts","import":"./dist/streaming.js"}},"gitHead":"feb3a45216a77239b42154d0ecc19df0af1f966b","scripts":{"lint":"eslint src/","test":"vitest run","build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"fboiero","email":"fboiero@gmail.com"},"repository":{"url":"git+https://github.com/fboiero/Agentor.git","type":"git","directory":"sdks/typescript"},"_npmVersion":"10.8.2","description":"TypeScript SDK client for the Argentor AI agent framework REST API","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.0.0","vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^25.6.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.4.4_1778935131569_0.9625852911809998","host":"s3://npm-registry-packages-npm-production"}},"1.4.5":{"name":"@argentor/sdk","version":"1.4.5","keywords":["argentor","ai","agent","sdk","client","llm","typescript"],"license":"AGPL-3.0-only","_id":"@argentor/sdk@1.4.5","maintainers":[{"name":"fboiero","email":"fboiero@gmail.com"}],"homepage":"https://github.com/fboiero/Agentor/tree/master/sdks/typescript","bugs":{"url":"https://github.com/fboiero/Agentor/issues"},"dist":{"shasum":"312b22caa565a6f6df6a13a3f23a4209e9a4bd08","tarball":"https://registry.npmjs.org/@argentor/sdk/-/sdk-1.4.5.tgz","fileCount":29,"integrity":"sha512-ckOseEo/6pXcV/9MzKx2LIGYwS1zZMeQhGTn/yM/RDl4S8QRUfoKdUcEGK0qdmA/hhFm5NhBEmuGqOv787xr0A==","signatures":[{"sig":"MEUCIHyw6vLcU7gl1hM8QNlV6ToROjWMkR53IgO8kc8387gTAiEAhzBsecwwLILw0jibl//Dp514W2s4QFIhm/LsjIJI4EY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":150183},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.js"},"./errors":{"types":"./dist/errors.d.ts","import":"./dist/errors.js"},"./streaming":{"types":"./dist/streaming.d.ts","import":"./dist/streaming.js"}},"gitHead":"357cce3f35e4a1ac46a2a09bc2bd7aaf042107d6","scripts":{"lint":"eslint src/","test":"vitest run","build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"fboiero","email":"fboiero@gmail.com"},"repository":{"url":"git+https://github.com/fboiero/Agentor.git","type":"git","directory":"sdks/typescript"},"_npmVersion":"10.8.2","description":"TypeScript SDK client for the Argentor AI agent framework REST API","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.0.0","vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^25.6.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.4.5_1778936783215_0.7861760107864464","host":"s3://npm-registry-packages-npm-production"}},"1.4.6":{"name":"@argentor/sdk","version":"1.4.6","keywords":["argentor","ai","agent","sdk","client","llm","typescript"],"license":"AGPL-3.0-only","_id":"@argentor/sdk@1.4.6","maintainers":[{"name":"fboiero","email":"fboiero@gmail.com"}],"homepage":"https://github.com/fboiero/Agentor/tree/master/sdks/typescript","bugs":{"url":"https://github.com/fboiero/Agentor/issues"},"dist":{"shasum":"d4d1a257d940fa779bf81e2a16cf398c72f8f4db","tarball":"https://registry.npmjs.org/@argentor/sdk/-/sdk-1.4.6.tgz","fileCount":29,"integrity":"sha512-XTVGfHLKrjNqchXHz4o/NASNi2YQpi4sZ+SB7TDMwth+WomLJAdmCFYsTOdo3z8HFFA9vMa+M2cpyLCNyQ4SCA==","signatures":[{"sig":"MEYCIQCjsNxgvuHqnbk/2xPwxXJbdp0QiX2PaL/6YcdG5MOx9wIhAMVmWou5ZlfnscAh35rwOguTLe7bZaFYg85bqyUMo/Ak","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":150183},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.js"},"./errors":{"types":"./dist/errors.d.ts","import":"./dist/errors.js"},"./streaming":{"types":"./dist/streaming.d.ts","import":"./dist/streaming.js"}},"gitHead":"0a60f6f2e016243fe80fa876c797153e1f91e137","scripts":{"lint":"eslint src/","test":"vitest run","build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"fboiero","email":"fboiero@gmail.com"},"repository":{"url":"git+https://github.com/fboiero/Agentor.git","type":"git","directory":"sdks/typescript"},"_npmVersion":"10.8.2","description":"TypeScript SDK client for the Argentor AI agent framework REST API","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.0.0","vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^25.6.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.4.6_1778940196298_0.8248676137337234","host":"s3://npm-registry-packages-npm-production"}},"1.4.7":{"name":"@argentor/sdk","version":"1.4.7","description":"TypeScript SDK client for the Argentor AI agent framework REST API","main":"dist/index.js","module":"dist/index.js","types":"dist/index.d.ts","type":"module","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"},"./types":{"import":"./dist/types.js","types":"./dist/types.d.ts"},"./errors":{"import":"./dist/errors.js","types":"./dist/errors.d.ts"},"./streaming":{"import":"./dist/streaming.js","types":"./dist/streaming.d.ts"}},"scripts":{"build":"tsc","clean":"rm -rf dist","prepublishOnly":"npm run build","typecheck":"tsc --noEmit","test":"vitest run","lint":"eslint src/"},"keywords":["argentor","ai","agent","sdk","client","llm","typescript"],"license":"AGPL-3.0-only","repository":{"type":"git","url":"git+https://github.com/fboiero/Agentor.git","directory":"sdks/typescript"},"homepage":"https://github.com/fboiero/Agentor/tree/master/sdks/typescript","bugs":{"url":"https://github.com/fboiero/Agentor/issues"},"engines":{"node":">=18.0.0"},"devDependencies":{"@types/node":"^25.6.0","eslint":"^9.0.0","typescript":"^5.4.0","vitest":"^1.6.0"},"_id":"@argentor/sdk@1.4.7","gitHead":"f0bbfa9008b1ad65f545ce724a58480294131af2","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-CDsQpltqHT/tcINd9NrkPz5UjCnP6KCqQWRqwNjbuAaWXEUdhKlq3QtxHOmuflQdry6UF6O4pRozKxmNxfocUg==","shasum":"f107707098c86c90c401f74857b9b3820ba61ba2","tarball":"https://registry.npmjs.org/@argentor/sdk/-/sdk-1.4.7.tgz","fileCount":29,"unpackedSize":150183,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIF2FuxD9iZTcwVCwtnVMEJr5aca/g+PxRWKHjE8is069AiB4XKRgmVlDmHN2qr74umjdAKBlvn873KpWyMUhDOFdRQ=="}]},"_npmUser":{"name":"fboiero","email":"fboiero@gmail.com"},"directories":{},"maintainers":[{"name":"fboiero","email":"fboiero@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_1.4.7_1778941915313_0.7960312932684308"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-12T23:17:18.752Z","modified":"2026-05-16T14:31:55.601Z","1.1.1":"2026-04-12T23:17:19.001Z","1.3.0":"2026-05-10T22:06:45.033Z","1.4.3":"2026-05-16T12:18:13.738Z","1.4.4":"2026-05-16T12:38:51.739Z","1.4.5":"2026-05-16T13:06:23.374Z","1.4.6":"2026-05-16T14:03:16.478Z","1.4.7":"2026-05-16T14:31:55.479Z"},"bugs":{"url":"https://github.com/fboiero/Agentor/issues"},"license":"AGPL-3.0-only","homepage":"https://github.com/fboiero/Agentor/tree/master/sdks/typescript","keywords":["argentor","ai","agent","sdk","client","llm","typescript"],"repository":{"type":"git","url":"git+https://github.com/fboiero/Agentor.git","directory":"sdks/typescript"},"description":"TypeScript SDK client for the Argentor AI agent framework REST API","maintainers":[{"name":"fboiero","email":"fboiero@gmail.com"}],"readme":"# @argentor/sdk v1.4.7\n\nTypeScript SDK client for the [Argentor](https://github.com/fboiero/Agentor) AI agent framework REST API.\n\n## Installation\n\n```bash\nnpm install @argentor/sdk\n```\n\n## Quick Start\n\n```typescript\nimport { ArgentorClient } from '@argentor/sdk';\n\nconst client = new ArgentorClient({\n  baseUrl: 'http://localhost:8080',\n  apiKey: 'your-api-key',\n});\n\n// Run a task\nconst result = await client.runTask({\n  role: 'code_reviewer',\n  context: 'Review the following pull request...',\n});\nconsole.log(result);\n\n// Stream results via SSE\nfor await (const event of client.runTaskStream({\n  role: 'assistant',\n  context: 'Explain how Argentor works',\n})) {\n  process.stdout.write(JSON.stringify(event));\n}\n\n// Batch execution\nconst batch = await client.batchTasks(\n  [\n    { agent_role: 'analyst', context: 'Analyze Q1 sales data' },\n    { agent_role: 'analyst', context: 'Analyze Q2 sales data' },\n  ],\n  5,\n);\nconsole.log(batch);\n\n// Evaluate a response\nconst evaluation = await client.evaluate({\n  text: 'The code looks clean and follows best practices.',\n  context: 'Code review task',\n  criteria: ['accuracy', 'completeness', 'helpfulness'],\n});\nconsole.log(evaluation);\n\n// List skills\nconst skills = await client.listSkills();\nfor (const skill of skills) {\n  console.log(skill.name);\n}\n\n// Execute a skill\nconst skillResult = await client.executeSkill('echo', { text: 'Hello!' });\nconsole.log(skillResult);\n\n// Health check\nconst health = await client.health();\nconsole.log(health);\n```\n\n## Agent SDK (subprocess wrapper)\n\nThe agent module wraps the `argentor` CLI binary as a subprocess,\nsimilar to how Claude Agent SDK wraps Claude Code.  It communicates\nvia NDJSON over stdin/stdout and works with any LLM provider.\n\n```typescript\nimport { agentQuery, claudeOptions } from '@argentor/sdk';\n\n// Stream events from the agent\nfor await (const event of agentQuery('What files are in this directory?', claudeOptions('sk-...'))) {\n  if (event.type === 'assistant') console.log(event.text);\n  if (event.type === 'tool_use') console.log(`[tool] ${event.name}`);\n  if (event.type === 'result') console.log('Done:', event.text ?? event.output);\n}\n```\n\n### One-liner convenience functions\n\n```typescript\nimport { askClaude, askOpenai, askGemini, askOllama } from '@argentor/sdk';\n\nconst result = await askClaude('Explain Argentor', 'sk-...');\nconst result2 = await askOpenai('Explain Argentor', 'sk-...');\nconst result3 = await askGemini('Explain Argentor', 'AIza...');\nconst result4 = await askOllama('Explain Argentor', 'llama3');\n```\n\n### Provider presets\n\n```typescript\nimport { claudeOptions, openaiOptions, geminiOptions, ollamaOptions } from '@argentor/sdk';\n\nclaudeOptions('sk-...');              // Anthropic Claude\nopenaiOptions('sk-...');              // OpenAI GPT-4o\ngeminiOptions('AIza...');             // Google Gemini\nollamaOptions('llama3');              // Local Ollama (no key)\n```\n\n### AgentOptions\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `provider` | `string` | `\"claude\"` | LLM provider |\n| `model` | `string` | `\"claude-sonnet-4-20250514\"` | Model name |\n| `apiKey` | `string` | `\"\"` | API key |\n| `systemPrompt` | `string` | - | System prompt override |\n| `maxTurns` | `number` | `10` | Max agentic turns |\n| `temperature` | `number` | `0.7` | Sampling temperature |\n| `tools` | `string[]` | - | Tool names (undefined = builtins) |\n| `permissionMode` | `string` | `\"default\"` | `\"default\"`, `\"strict\"`, `\"permissive\"`, `\"plan\"` |\n| `workingDirectory` | `string` | - | Working directory |\n| `mcpServers` | `McpServerConfig[]` | - | MCP server configs |\n| `argentorBinary` | `string` | - | Path to binary (auto-detected if omitted) |\n\n## Error Handling\n\n```typescript\nimport { ArgentorClient, ArgentorAPIError, ArgentorConnectionError } from '@argentor/sdk';\n\nconst client = new ArgentorClient({ baseUrl: 'http://localhost:8080' });\n\ntry {\n  const result = await client.runTask({ role: 'assistant', context: 'Hello' });\n} catch (err) {\n  if (err instanceof ArgentorAPIError) {\n    console.error(`API error ${err.statusCode}: ${err.message}`);\n    console.error('Response body:', err.responseBody);\n  } else if (err instanceof ArgentorConnectionError) {\n    console.error(`Connection failed: ${err.message}`);\n  }\n}\n```\n\n## API Reference\n\n### `new ArgentorClient(options?)`\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `baseUrl` | `string` | `http://localhost:8080` | Argentor API base URL |\n| `apiKey` | `string` | - | API key for `X-API-Key` header |\n| `tenantId` | `string` | - | Tenant ID for `X-Tenant-ID` header |\n| `timeoutMs` | `number` | `60000` | Request timeout in ms |\n\n### Methods\n\n| Method | Description |\n|--------|-------------|\n| `runTask(params)` | Execute a single agent task |\n| `runTaskStream(params)` | Stream task results via SSE |\n| `batchTasks(tasks, maxConcurrent?)` | Submit a batch of tasks |\n| `evaluate(params)` | Evaluate text against criteria |\n| `agentChat(params)` | Send a message via agent chat |\n| `agentStatus()` | Get agent status |\n| `createSession()` | Create a new session |\n| `getSession(id)` | Retrieve a session |\n| `listSessions()` | List all sessions |\n| `deleteSession(id)` | Delete a session |\n| `listSkills()` | List registered skills |\n| `getSkill(name)` | Get skill details |\n| `executeSkill(name, args?)` | Execute a skill |\n| `health()` | Check API health |\n| `healthReady()` | Readiness probe |\n| `metrics()` | Get Prometheus metrics (string) |\n| `listConnections()` | List WebSocket connections |\n| `createPersona(tenantId, agentRole, persona)` | Create persona |\n| `listPersonas(tenantId)` | List tenant personas |\n| `getUsage(tenantId)` | Get usage breakdown |\n| `webhookProxy(params)` | Forward a webhook event |\n| `searchMarketplace(query?, category?)` | Search skill marketplace |\n| `installSkill(name)` | Install from marketplace |\n\n## Requirements\n\n- Node.js >= 18 (uses native `fetch`)\n- TypeScript >= 5.4 (for development)\n\n## License\n\nAGPL-3.0-only\n","readmeFilename":"README.md"}