{"_id":"@agentir-annotators/ai-sdk","_rev":"2-a37a6275716672c7fad2770687c5c852","name":"@agentir-annotators/ai-sdk","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@agentir-annotators/ai-sdk","version":"0.1.0","keywords":["agentir","ai-sdk","vercel-ai-sdk","annotations","agents","workflow","llm"],"author":{"name":"Krish Modi"},"license":"MIT","_id":"@agentir-annotators/ai-sdk@0.1.0","maintainers":[{"name":"agentir-annotators","email":"krishmodi404@gmail.com"}],"dist":{"shasum":"c4876284bd4b30c459291216cdf5663fccedd69d","tarball":"https://registry.npmjs.org/@agentir-annotators/ai-sdk/-/ai-sdk-0.1.0.tgz","fileCount":33,"integrity":"sha512-GNBUPSd3FQxFlzNOKsZgjW7gf/3mxTWFZZHRhjZBBv9fFF30Di79HeLrSOkGv79Oc1FwHR3+HdJLzyzxDdO2XQ==","signatures":[{"sig":"MEUCICgIdy1DSfOoziYz4bJsHU+sFix1396PdyKlQnvHOfZ/AiEAgjdiSGnqdZMFUQbIMOLcQ3geducjGR4rE+jqhz0hvH0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":97162},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./package.json":"./package.json"},"gitHead":"2dc486fe2cee212ba7a05133f9913df9d09c8d6e","scripts":{"test":"npm run build","build":"npm run clean && tsc -p tsconfig.json","clean":"node --eval \"import('node:fs').then((fs) => fs.rmSync('dist', { recursive: true, force: true }))\"","prepack":"npm run build","pack:check":"npm pack --dry-run"},"_npmUser":{"name":"agentir-annotators","email":"krishmodi404@gmail.com"},"_npmVersion":"11.6.2","description":"AgentIR integration for Vercel AI SDK: decorators, contract tooling, and runtime helpers.","directories":{},"sideEffects":false,"_nodeVersion":"24.13.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"ai":"^6.0.177","typescript":"^6.0.3","@types/node":"^25.6.2"},"peerDependencies":{"ai":"^6.0.177"},"_npmOperationalInternal":{"tmp":"tmp/ai-sdk_0.1.0_1778790109479_0.40455843785447576","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@agentir-annotators/ai-sdk","version":"0.2.0","description":"AgentIR integration for Vercel AI SDK: decorators, contract tooling, and runtime helpers.","type":"module","sideEffects":false,"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./package.json":"./package.json"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"engines":{"node":">=18"},"scripts":{"clean":"node --eval \"import('node:fs').then((fs) => fs.rmSync('dist', { recursive: true, force: true }))\"","build":"npm run clean && tsc -p tsconfig.json","prepack":"npm run build","test":"npm run build","pack:check":"npm pack --dry-run"},"keywords":["agentir","ai-sdk","vercel-ai-sdk","annotations","agents","workflow","llm"],"author":{"name":"Krish Modi"},"license":"MIT","peerDependencies":{"ai":"^6.0.177"},"devDependencies":{"@types/node":"^25.6.2","ai":"^6.0.177","typescript":"^6.0.3"},"gitHead":"cca16ab911a6651a4a2b4a218a5846c533e3f0fa","_id":"@agentir-annotators/ai-sdk@0.2.0","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-yWzM+Uu7JPQILCKbEiSILYB2mr+D4jqpaDIPwGBy993RBN6x9F0zQVbEjXsBWjFNmwilUdMp0hwqeik3Mn5JJA==","shasum":"cbb9ba5dd74858b53f5060572f026f670184e34d","tarball":"https://registry.npmjs.org/@agentir-annotators/ai-sdk/-/ai-sdk-0.2.0.tgz","fileCount":33,"unpackedSize":107202,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDv7HVAlLZbBZIzkF1V0hGK+UbyfLn8efRGiJRNZHFnhwIhAMEytcsI2lTgRnDvSfU4ohTePtLSn4ifQmlJI5tpwtUF"}]},"_npmUser":{"name":"agentir-annotators","email":"krishmodi404@gmail.com"},"directories":{},"maintainers":[{"name":"agentir-annotators","email":"krishmodi404@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ai-sdk_0.2.0_1780248045761_0.43988684312054427"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-14T20:21:49.304Z","modified":"2026-05-31T17:20:46.069Z","0.1.0":"2026-05-14T20:21:49.663Z","0.2.0":"2026-05-31T17:20:45.962Z"},"author":{"name":"Krish Modi"},"license":"MIT","keywords":["agentir","ai-sdk","vercel-ai-sdk","annotations","agents","workflow","llm"],"description":"AgentIR integration for Vercel AI SDK: decorators, contract tooling, and runtime helpers.","maintainers":[{"name":"agentir-annotators","email":"krishmodi404@gmail.com"}],"readme":"# AgentIR AI SDK\n\n`agentir-ai-sdk` is the standalone TypeScript annotation module for wiring\nVercel AI SDK agents into AgentIR.\n\n## Purpose\n\n- annotate AI SDK agents and tools with compile-time structure\n- build scheduler-facing contracts for ReAct-style loops\n- propagate RID and node-name metadata into scheduler-backed model calls\n- bind scheduler headers into custom model or gateway wrappers\n- support real AI SDK `ToolLoopAgent` executions against OpenAI-compatible\n  `/v1/chat/completions` endpoints\n\nRead the full interface and implementation docs here:\n\n- `interface.md`\n- `docs/README.md`\n- `docs/how-it-works.md`\n- `docs/runtime.md`\n- `docs/annotation-patterns.md`\n- `docs/limitations.md`\n\n## What Belongs Here\n\n- public API exports in `src/index.ts`\n- contract structures in `src/contract.ts`\n- the contract compiler in `src/compiler.ts`\n- runtime RID and node-name propagation in `src/context.ts`\n- agent and tool wrappers in `src/definitions.ts`\n- marker helpers in `src/markers.ts`\n- usage guidance in `interface.md` and `docs/`\n- Blackbox runtime header helpers for OpenAI-compatible chat requests\n\n## Install\n\n```bash\nnpm install agentir-ai-sdk ai\n```\n\nIf your tool schemas use Zod, install `zod` in your application as usual.\n\nImport the annotation API from the package root:\n\n```ts\nimport {\n  buildContract,\n  defineAgentIRTool,\n  defineManualAgent,\n  defineToolLoopAgent,\n  llmCall,\n} from \"agentir-ai-sdk\";\n```\n\n## Important Invariants\n\n- Agent loop bounds must be explicit. The compiler does not infer or tolerate unbounded loops.\n- Tool fanout must be declared through `allowedToolSets`. The compiler does not infer dynamic tool availability.\n- Helper bodies are compile-visible only through the explicit marker calls above.\n- Runtime RID and node-name propagation is mandatory for scheduler-backed model calls.\n- Use `bindBlackboxHeaders(workflowApiKey, headers?)` or `getBlackboxHeaders(workflowApiKey, headers?)`\n  when a runtime client needs bearer auth plus the current `rid` and `node-name`.\n- Tool `execute(...)` and compile-visible `body` markers must describe the same\n  LLM work. The `body` is annotation metadata, not a fallback runtime path.\n","readmeFilename":"README.md"}