{"_id":"@ank1015/agents-core","_rev":"5-4c9d369f09f9d33a3a62b694715a18a5","name":"@ank1015/agents-core","dist-tags":{"latest":"0.1.11"},"versions":{"0.1.1":{"name":"@ank1015/agents-core","version":"0.1.1","keywords":["agents","llm","runtime","transport","typescript"],"license":"UNLICENSED","_id":"@ank1015/agents-core@0.1.1","maintainers":[{"name":"ananya150","email":"ananyakhandelwal60@gmail.com"}],"homepage":"https://github.com/ank1015/agent#readme","bugs":{"url":"https://github.com/ank1015/agent/issues"},"dist":{"shasum":"7664429e05f1cacf2e1e77192f171f488698d991","tarball":"https://registry.npmjs.org/@ank1015/agents-core/-/agents-core-0.1.1.tgz","fileCount":35,"integrity":"sha512-chNLOTBSUwnT1TpfqawGhawIJpt/GRb3WcmgDGuQ/BVqksd3svI8BJbZC1LS4pRShhRtOyZXSy9RcgUPZtQycA==","signatures":[{"sig":"MEYCIQCHwE9PQ27N0a71CRn5uMtnIfxImVZWKYU1cC3UiUWsNwIhANjN3EPGzPo9GOXYobRgFX8cFaRO0xlYzyJCqCaW0cRS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33931},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./models":{"types":"./dist/models/index.d.ts","import":"./dist/models/index.js"},"./stream":{"types":"./dist/stream/index.d.ts","import":"./dist/stream/index.js"},"./transport":{"types":"./dist/transport/index.d.ts","import":"./dist/transport/index.js"}},"gitHead":"868de1e6b3422f9f2fa4499c586991d8dcd8fcc4","scripts":{"test":"vitest run","build":"tsc -b","check":"tsc -b --pretty false","clean":"rm -rf dist ../../.tsbuildinfo/core.tsbuildinfo","prepack":"tsc -b"},"_npmUser":{"name":"ananya150","email":"ananyakhandelwal60@gmail.com"},"repository":{"url":"git+https://github.com/ank1015/agent.git","type":"git","directory":"packages/core"},"_npmVersion":"11.17.0","description":"Core agent runtime primitives for @ank1015/agents.","directories":{},"sideEffects":false,"_nodeVersion":"26.4.0","dependencies":{"zod":"^4.4.3","@ank1015/agents-contracts":"^0.1.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.9"},"_npmOperationalInternal":{"tmp":"tmp/agents-core_0.1.1_1782740159078_0.33763989740937395","host":"s3://npm-registry-packages-npm-production"}},"0.1.11":{"name":"@ank1015/agents-core","version":"0.1.11","description":"Core agent runtime primitives for @ank1015/agents.","keywords":["agents","llm","runtime","transport","typescript"],"license":"UNLICENSED","type":"module","sideEffects":false,"main":"./dist/index.js","types":"./dist/index.d.ts","repository":{"type":"git","url":"git+https://github.com/ank1015/agent.git","directory":"packages/core"},"bugs":{"url":"https://github.com/ank1015/agent/issues"},"homepage":"https://github.com/ank1015/agent#readme","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./models":{"types":"./dist/models/index.d.ts","import":"./dist/models/index.js"},"./stream":{"types":"./dist/stream/index.d.ts","import":"./dist/stream/index.js"},"./transport":{"types":"./dist/transport/index.d.ts","import":"./dist/transport/index.js"}},"publishConfig":{"access":"public"},"scripts":{"prepack":"tsc -b","build":"tsc -b","check":"tsc -b --pretty false","test":"vitest run","clean":"rm -rf dist ../../.tsbuildinfo/core.tsbuildinfo"},"dependencies":{"@ank1015/agents-contracts":"^0.1.11","zod":"^4.4.3"},"devDependencies":{"vitest":"^4.1.9"},"gitHead":"621232a246d0d99569ea3cf02bdc37801c1c71df","_id":"@ank1015/agents-core@0.1.11","_nodeVersion":"26.4.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-EMi70PC6nKQbE0h+2J4LV5Gjn7H3OG7UiFAr3FVu9YZZAovgwm81cFnRN8orHGgXSKlb2EgkH9YNj9+UzpPEaw==","shasum":"641e706ca4bce9a66027234c6a2ea984396aa636","tarball":"https://registry.npmjs.org/@ank1015/agents-core/-/agents-core-0.1.11.tgz","fileCount":35,"unpackedSize":36002,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFGSP5XMOqIHgn0aB5jJwVLo1emDihIFXZpjNcq3p1spAiAqTKjT0TOY2Nzv+gvoDUJRCAb7J3yt6CGyNSb74T1biQ=="}]},"_npmUser":{"name":"ananya150","email":"ananyakhandelwal60@gmail.com"},"directories":{},"maintainers":[{"name":"ananya150","email":"ananyakhandelwal60@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agents-core_0.1.11_1783677144697_0.7362571299114602"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-29T13:35:58.951Z","modified":"2026-07-10T09:52:24.935Z","0.1.0":"2026-06-24T19:21:23.356Z","0.1.1":"2026-06-29T13:35:59.210Z","0.1.11":"2026-07-10T09:52:24.828Z"},"bugs":{"url":"https://github.com/ank1015/agent/issues"},"license":"UNLICENSED","homepage":"https://github.com/ank1015/agent#readme","keywords":["agents","llm","runtime","transport","typescript"],"repository":{"type":"git","url":"git+https://github.com/ank1015/agent.git","directory":"packages/core"},"description":"Core agent runtime primitives for @ank1015/agents.","maintainers":[{"name":"ananya150","email":"ananyakhandelwal60@gmail.com"}],"readme":"# @ank1015/agents-core\n\nCore runtime primitives for the `@ank1015/agents` packages.\n\nThis package sits above `@ank1015/agents-contracts` and below applications. It provides small, provider-neutral runtime pieces: model catalog lookup, stream creation, provider-adapter routing, and an HTTP gateway transport.\n\n## Install\n\n```sh\npnpm add @ank1015/agents-core\n```\n\n## What This Package Provides\n\n- `ModelRegistry` helpers for static provider model catalogs.\n- A process-wide model registry for app startup wiring.\n- `createAdapterTransport` for routing requests to provider adapters.\n- `GatewayTransport` for streaming assistant events from a remote gateway.\n- `createEventStream` re-exported from `@ank1015/agents-contracts`.\n\n## Import Paths\n\n```ts\nimport {\n  createGatewayTransport,\n  createModelRegistry,\n} from '@ank1015/agents-core';\n\nimport { registerModels } from '@ank1015/agents-core/models';\nimport { createEventStream } from '@ank1015/agents-core/stream';\nimport { createAdapterTransport } from '@ank1015/agents-core/transport';\n```\n\n## Model Registry\n\nUse `createModelRegistry` for isolated registries, such as tests or per-runtime containers:\n\n```ts\nimport { createModelRegistry } from '@ank1015/agents-core/models';\nimport { ANTHROPIC_MODELS } from '@ank1015/agents-provider-anthropic-spec';\n\nconst registry = createModelRegistry([ANTHROPIC_MODELS]);\nconst model = registry.get('anthropic', 'claude-sonnet-4-6');\n```\n\nUse the process-wide helpers when an app wants to register provider catalogs once at startup:\n\n```ts\nimport { getModel, registerModels } from '@ank1015/agents-core/models';\nimport { ANTHROPIC_MODELS } from '@ank1015/agents-provider-anthropic-spec';\n\nregisterModels(ANTHROPIC_MODELS);\n\nconst model = getModel('anthropic', 'claude-sonnet-4-6');\n```\n\n## Adapter Transport\n\n`createAdapterTransport` multiplexes `LLMRequest`s to provider adapters by `request.provider`:\n\n```ts\nimport { createAdapterTransport } from '@ank1015/agents-core/transport';\nimport { createAnthropicProviderAdapter } from '@ank1015/agents-provider-anthropic';\n\nconst transport = createAdapterTransport([\n  createAnthropicProviderAdapter({\n    provider: 'anthropic',\n    apiKey: { type: 'env', name: 'ANTHROPIC_API_KEY' },\n  }),\n]);\n\nconst stream = transport.stream({\n  provider: 'anthropic',\n  modelId: 'claude-sonnet-4-6',\n  messages: [],\n});\n```\n\n## Gateway Transport\n\n`createGatewayTransport` sends normalized LLM requests to a remote gateway endpoint and consumes assistant events from an SSE response.\n\n```ts\nimport { createGatewayTransport } from '@ank1015/agents-core/transport';\n\nconst transport = createGatewayTransport({\n  baseUrl: 'https://gateway.example.com',\n  apiKey: process.env.AGENTS_GATEWAY_API_KEY ?? '',\n});\n```\n\nThe gateway transport posts to:\n\n```text\nPOST /v1/llm/stream\n```\n\nIt expects server-sent event frames whose `data:` payloads are serialized `AssistantEvent` objects. The stream completes when it receives a `done`, `error`, or `aborted` event.\n\n## Streams\n\n`createEventStream` is re-exported from `@ank1015/agents-contracts` for convenience:\n\n```ts\nimport { createEventStream } from '@ank1015/agents-core/stream';\n\nconst stream = createEventStream<string, number>();\nstream.push('started');\nstream.end(1);\n\nconst result = await stream.result();\n```\n\n## Versioning\n\nThis package is currently `0.1.11`. Until `1.0.0`, public runtime APIs may still evolve as the provider packages and gateway contract settle.\n","readmeFilename":"README.md"}