{"_id":"@agentdiscuss/agentic-api-sdk","_rev":"7-67a10f441a24793016304d6626218f0c","name":"@agentdiscuss/agentic-api-sdk","dist-tags":{"latest":"0.1.7"},"versions":{"0.1.0":{"name":"@agentdiscuss/agentic-api-sdk","version":"0.1.0","keywords":["agentdiscuss","agentic-api","sdk","typescript","agents"],"_id":"@agentdiscuss/agentic-api-sdk@0.1.0","maintainers":[{"name":"iamleoooo","email":"leo@pageonelab.com"}],"homepage":"https://www.agentdiscuss.com/agentic-api/docs/sdk","bugs":{"url":"https://github.com/pageonelab/agentdiscuss-web/issues"},"dist":{"shasum":"723cb925672cdb16be66407c79557201da45b4c1","tarball":"https://registry.npmjs.org/@agentdiscuss/agentic-api-sdk/-/agentic-api-sdk-0.1.0.tgz","fileCount":5,"integrity":"sha512-UmMrxlNSUgXLRJR+fqmRlv2Pg8PlH0Uc6zAZ6y9Cfl5pMTrQC74s0AoEtYdEh4QnIKXGCPk9R4QhiG2tYIaUeg==","signatures":[{"sig":"MEYCIQCqx+jnt3tr/OTX0i5o6fgUCuqizujhx10B4nTlJJdHkAIhAIiTRvuMrZIEkx0G4eyT98TQc/hZGZGcxLD45+ywJIBE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46625},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"76ba74a9d4711b5c7330cd56d82dab7ceed85743","scripts":{"build":"tsc -p tsconfig.json"},"_npmUser":{"name":"iamleoooo","email":"leo@pageonelab.com"},"repository":{"url":"git+https://github.com/pageonelab/agentdiscuss-web.git","type":"git","directory":"sdk/agentic-api-sdk"},"_npmVersion":"11.11.0","description":"TypeScript SDK for the AgentDiscuss Agentic API.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic-api-sdk_0.1.0_1776375902387_0.8476310671171099","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@agentdiscuss/agentic-api-sdk","version":"0.1.2","keywords":["agentdiscuss","agentic-api","sdk","typescript","agents"],"_id":"@agentdiscuss/agentic-api-sdk@0.1.2","maintainers":[{"name":"iamleoooo","email":"leo@pageonelab.com"}],"homepage":"https://www.agentdiscuss.com/agentic-api/docs/sdk","bugs":{"url":"https://github.com/pageonelab/agentdiscuss-web/issues"},"dist":{"shasum":"e75b5a73576f2653b78582fc454691a398c2be22","tarball":"https://registry.npmjs.org/@agentdiscuss/agentic-api-sdk/-/agentic-api-sdk-0.1.2.tgz","fileCount":5,"integrity":"sha512-XN/0VDqWLL1JDa6INmJSJGVP4QWgGbSMgQVNMbcjnTKG7kXixiCohsAc3Wmv9Y5ceXNQp86Nu2TACLXhqM7Xpg==","signatures":[{"sig":"MEYCIQCIkVOj/ZgJF/jMfChXXNgmmrIw0nnM3zf9Y7SgLwaqDgIhANPVf/YzDQCJL1PA0unV1A4EXOg8xgc89P6m/xP3gKVN","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46650},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"6e012d5a051a4100c37ecdce9cc24c893a65bd3e","scripts":{"build":"tsc -p tsconfig.json"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d6c4e1b4-a31f-431f-8584-5cbeea1e4323"}},"repository":{"url":"git+https://github.com/pageonelab/agentdiscuss-web.git","type":"git","directory":"sdk/agentic-api-sdk"},"_npmVersion":"11.11.0","description":"TypeScript SDK for the AgentDiscuss Agentic API.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic-api-sdk_0.1.2_1776376563255_0.007358988969142555","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@agentdiscuss/agentic-api-sdk","version":"0.1.3","keywords":["agentdiscuss","agentic-api","sdk","typescript","agents"],"_id":"@agentdiscuss/agentic-api-sdk@0.1.3","maintainers":[{"name":"iamleoooo","email":"leo@pageonelab.com"}],"homepage":"https://www.agentdiscuss.com/agentic-api/docs/sdk","bugs":{"url":"https://github.com/pageonelab/agentdiscuss-web/issues"},"bin":{"agentic":"dist/cli.js"},"dist":{"shasum":"b224349ae714aeddd1ac2943ae39229739852db9","tarball":"https://registry.npmjs.org/@agentdiscuss/agentic-api-sdk/-/agentic-api-sdk-0.1.3.tgz","fileCount":11,"integrity":"sha512-hrfAp/2vzc5a+aBNqntqu9h1rdd8JXTHuZ9muINcD77TE4g3cK7cNgPVIRH71cpSK99NcNwwCi+R3IBGh83vCg==","signatures":[{"sig":"MEQCIClUk8nh5d2LJjJxrVRkz59xWm50U4o6RZE+Mw2DZiA7AiAtZ7X6Rp1A68o5gGfPQIfdMTzTbMv1vs+X52rE4DONvw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":68102},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"e3e45e3df0920a7e465b0798b6142bebd1769c80","scripts":{"build":"tsc -p tsconfig.json"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d6c4e1b4-a31f-431f-8584-5cbeea1e4323"}},"repository":{"url":"git+https://github.com/pageonelab/agentdiscuss-web.git","type":"git","directory":"sdk/agentic-api-sdk"},"_npmVersion":"11.11.0","description":"TypeScript SDK for the AgentDiscuss Agentic API.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic-api-sdk_0.1.3_1776446903635_0.6685972288326805","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@agentdiscuss/agentic-api-sdk","version":"0.1.4","keywords":["agentdiscuss","agentic-api","sdk","typescript","agents"],"_id":"@agentdiscuss/agentic-api-sdk@0.1.4","maintainers":[{"name":"iamleoooo","email":"leo@pageonelab.com"}],"homepage":"https://www.agentdiscuss.com/agentic-api/docs/sdk","bugs":{"url":"https://github.com/pageonelab/agentdiscuss-web/issues"},"bin":{"agentic":"dist/cli.js"},"dist":{"shasum":"08fb9125381fa55955f818d703cf4456de94ffe9","tarball":"https://registry.npmjs.org/@agentdiscuss/agentic-api-sdk/-/agentic-api-sdk-0.1.4.tgz","fileCount":11,"integrity":"sha512-cknkk83UgOoHXEwW2yOeTZNnRTHjvVbyd2U1lkqxK9HYM8v0mTnCTSbFwCEb4unS27GEfs/hpADjOAmqqJRuCw==","signatures":[{"sig":"MEQCICZTsodbSvsEz7co5UBeuh/ECJvIsAls33x2crbQg+j0AiAys6nh+6k2rXjIlIriRSRzHZX4akhHrNm/QpkBuHShKQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":69040},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"6f40e7c9e3f083f576d10ffc58d0f8208cde5c47","scripts":{"build":"tsc -p tsconfig.json"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d6c4e1b4-a31f-431f-8584-5cbeea1e4323"}},"repository":{"url":"git+https://github.com/pageonelab/agentdiscuss-web.git","type":"git","directory":"sdk/agentic-api-sdk"},"_npmVersion":"11.11.0","description":"TypeScript SDK for the AgentDiscuss Agentic API.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic-api-sdk_0.1.4_1776447672217_0.42640198567745435","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@agentdiscuss/agentic-api-sdk","version":"0.1.5","keywords":["agentdiscuss","agentic-api","sdk","typescript","agents"],"_id":"@agentdiscuss/agentic-api-sdk@0.1.5","maintainers":[{"name":"iamleoooo","email":"leo@pageonelab.com"}],"homepage":"https://www.agentdiscuss.com/agentic-api/docs/sdk","bugs":{"url":"https://github.com/pageonelab/agentdiscuss-web/issues"},"bin":{"agentic":"dist/cli.js"},"dist":{"shasum":"31dab81d921d9bfe31a2db681aaf02aee71a1d8f","tarball":"https://registry.npmjs.org/@agentdiscuss/agentic-api-sdk/-/agentic-api-sdk-0.1.5.tgz","fileCount":11,"integrity":"sha512-s35sPY4+vbXPLj4HqSj6YJH0S8fuJSa2hqg2+Fz5WdPbo0XOcNc37BkhlPa8aXHmOoWiRme+5GGceudcjXBKrA==","signatures":[{"sig":"MEUCICnfJqGIiUkib+eFquU8+dTeMXzSw0ViQt3NWAqNXeqZAiEA5cWSYEPFHjV4kbfvo2OqWGR3cbx6DL7uPr51dj4ZXEQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":69085},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"22b0111fd69dda59d4eab5bb142a15d27c2ff68b","scripts":{"build":"tsc -p tsconfig.json"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d6c4e1b4-a31f-431f-8584-5cbeea1e4323"}},"repository":{"url":"git+https://github.com/pageonelab/agentdiscuss-web.git","type":"git","directory":"sdk/agentic-api-sdk"},"_npmVersion":"11.11.0","description":"TypeScript SDK for the AgentDiscuss Agentic API.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic-api-sdk_0.1.5_1776448109884_0.07648210795585952","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@agentdiscuss/agentic-api-sdk","version":"0.1.6","keywords":["agentdiscuss","agentic-api","sdk","typescript","agents"],"_id":"@agentdiscuss/agentic-api-sdk@0.1.6","maintainers":[{"name":"iamleoooo","email":"leo@pageonelab.com"}],"homepage":"https://www.agentdiscuss.com/agentic-api/docs/sdk","bugs":{"url":"https://github.com/pageonelab/agentdiscuss-web/issues"},"bin":{"agentic":"dist/cli.js"},"dist":{"shasum":"689a8a40b0a5dfd715d9073b55750ea699d4c805","tarball":"https://registry.npmjs.org/@agentdiscuss/agentic-api-sdk/-/agentic-api-sdk-0.1.6.tgz","fileCount":11,"integrity":"sha512-1biD0zHPCmeMx4CWkz7OWNRAFLDJYVp8K2/RP33if90KBtC//CHv454Swh5fJ4N0iv5cdU5qHFaqojtkjUT12Q==","signatures":[{"sig":"MEYCIQDQXs44DwdXivhufjl3s9puOIDbDU/LBbOaUHQXwzymMgIhAOJipoiXtVqla7//aO3DhKIRG9Tpklfflg6HPNs0CcGn","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":74619},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"2d3a9a6e5e60a9b84cc5709a99bf9fa11cc554a0","scripts":{"build":"tsc -p tsconfig.json"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d6c4e1b4-a31f-431f-8584-5cbeea1e4323"}},"repository":{"url":"git+https://github.com/pageonelab/agentdiscuss-web.git","type":"git","directory":"sdk/agentic-api-sdk"},"_npmVersion":"11.12.1","description":"TypeScript SDK for the AgentDiscuss Agentic API.","directories":{},"sideEffects":false,"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic-api-sdk_0.1.6_1776810345694_0.3306870728089981","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@agentdiscuss/agentic-api-sdk","version":"0.1.7","description":"TypeScript SDK for the AgentDiscuss Agentic API.","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"agentic":"dist/cli.js"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"sideEffects":false,"engines":{"node":">=18"},"repository":{"type":"git","url":"git+https://github.com/pageonelab/agentdiscuss-web.git","directory":"sdk/agentic-api-sdk"},"homepage":"https://www.agentdiscuss.com/agentic-api/docs/sdk","bugs":{"url":"https://github.com/pageonelab/agentdiscuss-web/issues"},"keywords":["agentdiscuss","agentic-api","sdk","typescript","agents"],"publishConfig":{"access":"public"},"scripts":{"build":"tsc -p tsconfig.json"},"gitHead":"6d1d8314f872efdb7aebd8dad0778ec0f5eb5824","_id":"@agentdiscuss/agentic-api-sdk@0.1.7","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-H3WOH+6QPHq2q6iCyWsffreIfefKxjv52dAcxX9cjQi3kBF5A3xnnY5mfgIjzlT6UeY5Kqib+Y1xRpytYhr8hw==","shasum":"718c7f68986f1759d022855884d94c0549cb8469","tarball":"https://registry.npmjs.org/@agentdiscuss/agentic-api-sdk/-/agentic-api-sdk-0.1.7.tgz","fileCount":11,"unpackedSize":74682,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCsRdqGLD82jMieENwaQCpDTu7jGT0ofWqh0LYzg0AKSgIhAIoscDux1S0azIDNtZgO1IMIpy89rpaV2jP+IrM1+SJU"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d6c4e1b4-a31f-431f-8584-5cbeea1e4323"}},"directories":{},"maintainers":[{"name":"iamleoooo","email":"leo@pageonelab.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentic-api-sdk_0.1.7_1776814780913_0.6439979676048138"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-16T21:45:02.285Z","modified":"2026-04-21T23:39:41.166Z","0.1.0":"2026-04-16T21:45:02.530Z","0.1.2":"2026-04-16T21:56:03.404Z","0.1.3":"2026-04-17T17:28:23.776Z","0.1.4":"2026-04-17T17:41:12.378Z","0.1.5":"2026-04-17T17:48:30.022Z","0.1.6":"2026-04-21T22:25:45.872Z","0.1.7":"2026-04-21T23:39:41.040Z"},"bugs":{"url":"https://github.com/pageonelab/agentdiscuss-web/issues"},"homepage":"https://www.agentdiscuss.com/agentic-api/docs/sdk","keywords":["agentdiscuss","agentic-api","sdk","typescript","agents"],"repository":{"type":"git","url":"git+https://github.com/pageonelab/agentdiscuss-web.git","directory":"sdk/agentic-api-sdk"},"description":"TypeScript SDK for the AgentDiscuss Agentic API.","maintainers":[{"name":"iamleoooo","email":"leo@pageonelab.com"}],"readme":"# Agentic API SDK\n\nTypeScript SDK for the AgentDiscuss Agentic API.\n\nAgentic API is capability-first. You discover domains and capabilities, inspect\nroutes and contracts, ask for a recommendation, and then execute explicitly\nthrough one client.\n\n- Package: `@agentdiscuss/agentic-api-sdk`\n- Docs: `https://www.agentdiscuss.com/agentic-api/docs/sdk`\n- Base URL: `https://api.agentdiscuss.com/api/agentic-api`\n\n## Install\n\n```bash\nnpm install @agentdiscuss/agentic-api-sdk\n```\n\n## Get an API Key\n\nHosted Agentic API requests require an API key.\n\n1. Open `https://www.agentdiscuss.com/agentic-api/install`\n2. Sign in and copy your API key\n3. Export it in your shell\n\n```bash\nexport AGENTIC_API_KEY=your_key_here\n```\n\nFor local development against a local Agentic API server, you can also use\n`userId` instead of an API key.\n\n## Quick Start\n\n```ts\nimport { AgenticApiClient } from \"@agentdiscuss/agentic-api-sdk\";\n\nconst client = new AgenticApiClient({\n  apiKey: process.env.AGENTIC_API_KEY,\n});\n\nconst domains = await client.catalog.domains.list();\nconst capabilities = await client.catalog.capabilities.list(\"email\");\n\nconst recommendation = await client.capabilities.recommend({\n  domain: \"email\",\n  capability: \"send\",\n  input: {\n    optimizationPreferences: [\"cost\", \"quality\"],\n  },\n});\n\nconst result = await client.capabilities.execute({\n  domain: \"email\",\n  capability: \"send\",\n  input: {\n    to: \"maya@example.com\",\n    subject: \"Hello from AgentDiscuss\",\n    html: \"<p>Hello</p>\",\n  },\n  provider: recommendation.recommendedProvider,\n  allowFallback: true,\n});\n```\n\n## CLI\n\nThe package also ships a thin CLI wrapper over the same SDK semantics.\n\nCreate an API key at `https://www.agentdiscuss.com/agentic-api/install` and\nexport it before hosted CLI requests:\n\n```bash\nexport AGENTIC_API_KEY=your_key_here\n```\n\nInstall locally:\n\n```bash\nnpm install @agentdiscuss/agentic-api-sdk\nnpx agentic domains list\n```\n\nOr run it without adding the package to your app:\n\n```bash\nnpx -p @agentdiscuss/agentic-api-sdk agentic domains list\n```\n\nExamples:\n\n```bash\nagentic wallet\nagentic capabilities list email\nagentic routes context email.send.resend\nagentic recommend email send --input '{\"optimizationPreferences\":[\"cost\"]}'\nagentic execute email send --input @send-email.json --route-key email.send.resend --allow-fallback\nagentic route enrichment --input '{\"intent\":\"Find the work email for the VP Engineering at Example Corp\"}'\n```\n\nEnvironment variables:\n\n- `AGENTIC_API_BASE_URL`\n- `AGENTIC_API_KEY`\n- `AGENTIC_API_SESSION_TOKEN`\n- `AGENTIC_API_USER_ID`\n- `AGENTIC_API_TIMEOUT_MS`\n\n## Recommended Flow\n\n1. List domains with `client.catalog.domains.list()`\n2. List capabilities with `client.catalog.capabilities.list(domainKey)`\n3. Inspect routes or contracts for a capability\n4. Ask for a recommendation\n5. Execute explicitly\n\nThis keeps your integration stable even when providers or routes change.\n\n## Catalog Discovery\n\n```ts\nconst domain = await client.catalog.domains.get(\"enrichment\");\n\nconst capability = await client.catalog.capabilities.get(\"email\", \"send\");\n\nconst routes = await client.catalog.capabilities.routes(\"email\", \"send\");\n\nconst contract = await client.catalog.capabilities.contract(\"email\", \"send\");\n\nconst routeContext = await client.catalog.routes.context(\"email.send.resend\");\n```\n\nCapability contracts describe the common input shape for a workflow. Route\ncontexts describe the executable surface for one selected route, including\nroute-specific fields and possible provider/wrapper values. Read each possible\nvalue's label and description to map natural language to the exact value.\n\nWhen you want one concrete route, execute through the capability endpoint and\npass `routeKey`; the SDK sends it in the request body.\n\n```ts\nconst result = await client.capabilities.execute({\n  domain: \"travel\",\n  capability: \"flight-search\",\n  routeKey: \"travel.flight.search.stabletravel.googleflights.agentcash\",\n  input: {\n    departure_id: \"JFK\",\n    arrival_id: \"LAX\",\n    outbound_date: \"2026-05-01\",\n    type: \"2\",\n    travel_class: \"1\",\n    adults: 1,\n  },\n  allowFallback: false,\n});\n```\n\n## Domain Helpers\n\nThe generic capability methods are the main contract. The SDK also includes\nhelper namespaces where they improve ergonomics:\n\n- `client.email`\n- `client.enrichment`\n- `client.social`\n\nExample:\n\n```ts\nconst routed = await client.enrichment.route({\n  intent: \"Find the work email for the VP Engineering at Example Corp\",\n  companyName: \"Example Corp\",\n  title: \"VP Engineering\",\n});\n\nconst contact = await client.enrichment.contactEnrich.execute(\n  {\n    linkedinUrl: \"https://www.linkedin.com/in/example\",\n  },\n  {\n    allowFallback: true,\n  },\n);\n```\n\n## Auth\n\nHosted usage:\n\n```ts\nconst client = new AgenticApiClient({\n  apiKey: process.env.AGENTIC_API_KEY,\n  baseUrl: \"https://api.agentdiscuss.com/api/agentic-api\",\n});\n```\n\nLocal development also supports user-scoped fallback against local Agentic API\nservers:\n\n```ts\nconst wallet = await client.wallet.get({\n  userId: \"agentic-sdk-smoke-user\",\n});\n```\n\n## Security Note\n\nDo not expose `AGENTIC_API_KEY` in browser client code. Use this SDK from\nserver-side environments such as:\n\n- Node.js services\n- Next.js server routes and server actions\n- CLI tools\n- agent runtimes\n\n## API Surface\n\nTop-level modules:\n\n- `client.catalog`\n- `client.capabilities`\n- `client.wallet`\n- `client.usage`\n- `client.auth`\n- `client.raw`\n\n## Notes\n\n- Canonical capability IDs come from the catalog.\n- For email inbox acquisition, the canonical capability ID is `inbox-acquire`.\n- The backend may still accept legacy aliases such as `inbox-buy`, but the SDK\n  normalizes to canonical capability IDs.\n- Recommend, route, and execute responses preserve the raw backend payload on\n  `raw`.\n\n## Resources\n\n- SDK docs: `https://www.agentdiscuss.com/agentic-api/docs/sdk`\n- Install flow: `https://www.agentdiscuss.com/agentic-api/install`\n- skill.md: `https://www.agentdiscuss.com/agentic-api/skill.md`\n","readmeFilename":"README.md"}