{"_id":"@agenticprimitives/orchestration","_rev":"4-f86ae7be1418600e94ec5a8fe9e75629","name":"@agenticprimitives/orchestration","dist-tags":{"latest":"0.0.0-alpha.4"},"versions":{"0.0.0-alpha.1":{"name":"@agenticprimitives/orchestration","version":"0.0.0-alpha.1","keywords":["agentic","primitives","orchestration","planner","intent","agentic-loop"],"license":"MIT","_id":"@agenticprimitives/orchestration@0.0.0-alpha.1","maintainers":[{"name":"richcanvas","email":"richardpedersen3@gmail.com"}],"homepage":"https://github.com/agentictrustlabs/agenticprimitives/tree/master/packages/orchestration","bugs":{"url":"https://github.com/agentictrustlabs/agenticprimitives/issues"},"dist":{"shasum":"746fc3efd8f0759c374e41fd109051dfca32f69e","tarball":"https://registry.npmjs.org/@agenticprimitives/orchestration/-/orchestration-0.0.0-alpha.1.tgz","fileCount":24,"integrity":"sha512-izxGsI2bwvg3bx51ReUaQUKOwi9Fh2ZwHwprarGaPEnbE0Y0eLkkgfWjS/6z5tN5XL2yu/rx3T0LWpLJyTT64Q==","signatures":[{"sig":"MEYCIQDFquQxvQOarRg/izAKiI+0BHDNIN5U6MvJragP90KsnQIhAIXw3+Q14ltoZFKenKJ4cgBcUzGksUAoNj6cUm92fdO5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36728},"main":"./dist/index.js","type":"module","_from":"file:agenticprimitives-orchestration-0.0.0-alpha.1.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsc -p tsconfig.build.json","clean":"rm -rf dist","test:unit":"vitest run test/unit --passWithNoTests","typecheck":"tsc -p tsconfig.json --noEmit","test:watch":"vitest"},"_npmUser":{"name":"richcanvas","email":"richardpedersen3@gmail.com"},"_resolved":"/tmp/18bfb672d601c349abd8d305eaa995c6/agenticprimitives-orchestration-0.0.0-alpha.1.tgz","_integrity":"sha512-izxGsI2bwvg3bx51ReUaQUKOwi9Fh2ZwHwprarGaPEnbE0Y0eLkkgfWjS/6z5tN5XL2yu/rx3T0LWpLJyTT64Q==","repository":{"url":"git+https://github.com/agentictrustlabs/agenticprimitives.git","type":"git","directory":"packages/orchestration"},"_npmVersion":"11.16.0","description":"The Ring-0 agentic orchestration core (ADR-0044): the intent→plan→execute→observe loop, the Planner + ToolInvoker ports, and a deterministic rule-based planner. A first-party app expresses a goal; the loop plans which tools compose to satisfy it and runs ","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.8"},"_npmOperationalInternal":{"tmp":"tmp/orchestration_0.0.0-alpha.1_1782902633584_0.7969153377504694","host":"s3://npm-registry-packages-npm-production"}},"0.0.0-alpha.2":{"name":"@agenticprimitives/orchestration","version":"0.0.0-alpha.2","keywords":["agentic","primitives","orchestration","planner","intent","agentic-loop"],"license":"MIT","_id":"@agenticprimitives/orchestration@0.0.0-alpha.2","maintainers":[{"name":"richcanvas","email":"richardpedersen3@gmail.com"}],"homepage":"https://github.com/agentictrustlabs/agenticprimitives/tree/master/packages/orchestration","bugs":{"url":"https://github.com/agentictrustlabs/agenticprimitives/issues"},"dist":{"shasum":"4786bef91b261fdcc0f284d1290ed6aa5c507772","tarball":"https://registry.npmjs.org/@agenticprimitives/orchestration/-/orchestration-0.0.0-alpha.2.tgz","fileCount":68,"integrity":"sha512-NOXGJFnB87GoHSuuM2SxIhb6kGjkDAvgrLnvr++XSM5BUTyNHb9R/phkmpd67BdSHfwytFbonWHbhyp5y+1xnQ==","signatures":[{"sig":"MEUCIQCeE225gfy5jkoPH8rLEV3TVl/uRoff8Re1P+zFoEbLFQIgCQrUcY74E4jS5jxmjK+Z8OsF9CHnTEQ98HJABZUnLxQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":406628},"main":"./dist/index.js","type":"module","_from":"file:agenticprimitives-orchestration-0.0.0-alpha.2.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsc -p tsconfig.build.json","clean":"rm -rf dist","test:unit":"vitest run test/unit --passWithNoTests","typecheck":"tsc -p tsconfig.json --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:33943d09-a6c9-4f2a-a6ad-155b3eba09bf"}},"_resolved":"/tmp/481f39b1a94ea933dbbd8e64c6d19039/agenticprimitives-orchestration-0.0.0-alpha.2.tgz","_integrity":"sha512-NOXGJFnB87GoHSuuM2SxIhb6kGjkDAvgrLnvr++XSM5BUTyNHb9R/phkmpd67BdSHfwytFbonWHbhyp5y+1xnQ==","repository":{"url":"git+https://github.com/agentictrustlabs/agenticprimitives.git","type":"git","directory":"packages/orchestration"},"_npmVersion":"11.19.0","description":"The Ring-0 agentic orchestration core (ADR-0044): the intent→plan→execute→observe loop, the Planner + ToolInvoker ports, and a deterministic rule-based planner. A first-party app expresses a goal; the loop plans which tools compose to satisfy it and runs ","directories":{},"_nodeVersion":"24.20.0","dependencies":{"@agenticprimitives/tool-policy":"1.0.0-alpha.23"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.8"},"_npmOperationalInternal":{"tmp":"tmp/orchestration_0.0.0-alpha.2_1789164135091_0.8089510461630145","host":"s3://npm-registry-packages-npm-production"}},"0.0.0-alpha.3":{"name":"@agenticprimitives/orchestration","version":"0.0.0-alpha.3","keywords":["agentic","primitives","orchestration","planner","intent","agentic-loop"],"license":"MIT","_id":"@agenticprimitives/orchestration@0.0.0-alpha.3","maintainers":[{"name":"richcanvas","email":"richardpedersen3@gmail.com"}],"homepage":"https://github.com/agentictrustlabs/agenticprimitives/tree/master/packages/orchestration","bugs":{"url":"https://github.com/agentictrustlabs/agenticprimitives/issues"},"dist":{"shasum":"d92df5a0a82d3ff3b5fb44143dcfaa8cf6ef29b0","tarball":"https://registry.npmjs.org/@agenticprimitives/orchestration/-/orchestration-0.0.0-alpha.3.tgz","fileCount":68,"integrity":"sha512-4bIUzQMKWluPzQC1cLSD4EcZJpiYa+Uf+efns4rtKYxiuKqohmWpgxoTD+xHLn5rxRIGtxiuPpfkx1lZ1YZ2Pw==","signatures":[{"sig":"MEQCIClpBoJQLa4PK4wRl1BW9rfqlU0OYZdcX9Oo0YmH9Jj+AiAHxgCqINuiWtvz1l/hNv4B6bi1tKdJsiK5zFnjOZs+8w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":407325},"main":"./dist/index.js","type":"module","_from":"file:agenticprimitives-orchestration-0.0.0-alpha.3.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsc -p tsconfig.build.json","clean":"rm -rf dist","test:unit":"vitest run test/unit --passWithNoTests","typecheck":"tsc -p tsconfig.json --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:33943d09-a6c9-4f2a-a6ad-155b3eba09bf"}},"_resolved":"/tmp/2e7d710b04600529518697f85bf7090f/agenticprimitives-orchestration-0.0.0-alpha.3.tgz","_integrity":"sha512-4bIUzQMKWluPzQC1cLSD4EcZJpiYa+Uf+efns4rtKYxiuKqohmWpgxoTD+xHLn5rxRIGtxiuPpfkx1lZ1YZ2Pw==","repository":{"url":"git+https://github.com/agentictrustlabs/agenticprimitives.git","type":"git","directory":"packages/orchestration"},"_npmVersion":"11.19.0","description":"The Ring-0 agentic orchestration core (ADR-0044): the intent→plan→execute→observe loop, the Planner + ToolInvoker ports, and a deterministic rule-based planner. A first-party app expresses a goal; the loop plans which tools compose to satisfy it and runs ","directories":{},"_nodeVersion":"24.20.0","dependencies":{"@agenticprimitives/tool-policy":"1.0.0-alpha.24"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.8"},"_npmOperationalInternal":{"tmp":"tmp/orchestration_0.0.0-alpha.3_1789230550537_0.198961868495243","host":"s3://npm-registry-packages-npm-production"}},"0.0.0-alpha.4":{"name":"@agenticprimitives/orchestration","version":"0.0.0-alpha.4","description":"The Ring-0 agentic orchestration core (ADR-0044): the intent→plan→execute→observe loop, the Planner + ToolInvoker ports, and a deterministic rule-based planner. A first-party app expresses a goal; the loop plans which tools compose to satisfy it and runs ","license":"MIT","repository":{"type":"git","url":"git+https://github.com/agentictrustlabs/agenticprimitives.git","directory":"packages/orchestration"},"homepage":"https://github.com/agentictrustlabs/agenticprimitives/tree/master/packages/orchestration","bugs":{"url":"https://github.com/agentictrustlabs/agenticprimitives/issues"},"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"publishConfig":{"access":"public"},"devDependencies":{"vitest":"^4.1.8"},"keywords":["agentic","primitives","orchestration","planner","intent","agentic-loop"],"dependencies":{"@agenticprimitives/tool-policy":"1.0.0-alpha.25"},"scripts":{"build":"tsc -p tsconfig.build.json","typecheck":"tsc -p tsconfig.json --noEmit","test":"vitest run","test:unit":"vitest run test/unit --passWithNoTests","test:watch":"vitest","clean":"rm -rf dist"},"_id":"@agenticprimitives/orchestration@0.0.0-alpha.4","_integrity":"sha512-OKCm4Zj6Zp/VTeGJD2Hq7d38hLnxf5Cbxaw8RnTr9J4cLsrxYPBKo7hEkJg+/7ezyqQGWgsu2Yq6T8mRt/w4vA==","_resolved":"/tmp/2b33f48f2fcaf14480b231796330dedf/agenticprimitives-orchestration-0.0.0-alpha.4.tgz","_from":"file:agenticprimitives-orchestration-0.0.0-alpha.4.tgz","_nodeVersion":"24.12.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-OKCm4Zj6Zp/VTeGJD2Hq7d38hLnxf5Cbxaw8RnTr9J4cLsrxYPBKo7hEkJg+/7ezyqQGWgsu2Yq6T8mRt/w4vA==","shasum":"90bca31b0213de2583b8283dd5d7af9472b13b32","tarball":"https://registry.npmjs.org/@agenticprimitives/orchestration/-/orchestration-0.0.0-alpha.4.tgz","fileCount":68,"unpackedSize":407325,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEDKyc6Q7ssAQT1PBcTxmUZ0EaQrlxMKiKKDfWhuYQJ8AiEA8AoI6EWM5wmuW8JGtK8n56EwLJxX1R/8BiJzUKyi8po="}]},"_npmUser":{"name":"richcanvas","email":"richardpedersen3@gmail.com"},"directories":{},"maintainers":[{"name":"richcanvas","email":"richardpedersen3@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/orchestration_0.0.0-alpha.4_1789500122311_0.6433990921308466"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-01T10:43:53.387Z","modified":"2026-09-15T19:22:02.666Z","0.0.0-alpha.1":"2026-07-01T10:43:53.732Z","0.0.0-alpha.2":"2026-09-11T22:02:15.248Z","0.0.0-alpha.3":"2026-09-12T16:29:10.669Z","0.0.0-alpha.4":"2026-09-15T19:22:02.476Z"},"bugs":{"url":"https://github.com/agentictrustlabs/agenticprimitives/issues"},"license":"MIT","homepage":"https://github.com/agentictrustlabs/agenticprimitives/tree/master/packages/orchestration","keywords":["agentic","primitives","orchestration","planner","intent","agentic-loop"],"repository":{"type":"git","url":"git+https://github.com/agentictrustlabs/agenticprimitives.git","directory":"packages/orchestration"},"description":"The Ring-0 agentic orchestration core (ADR-0044): the intent→plan→execute→observe loop, the Planner + ToolInvoker ports, and a deterministic rule-based planner. A first-party app expresses a goal; the loop plans which tools compose to satisfy it and runs ","maintainers":[{"name":"richcanvas","email":"richardpedersen3@gmail.com"}],"readme":"# @agenticprimitives/orchestration\n\nThe Ring-0 **agentic orchestration core**: the intent → plan → execute → observe loop, the `Planner` and\n`ToolInvoker` ports, and a deterministic rule-based planner. A first-party app expresses a **goal**; this\npackage plans which tools compose to satisfy it and runs them through an injected invoker — the web never\nnames a tool (ADR-0044). Pure leaf: no transport, no LLM SDK, no chain. The concrete LLM binding lives behind\nthe `Planner` port in [`@agenticprimitives/orchestration-anthropic`](../orchestration-anthropic).\n\n## Install\n\n```bash\npnpm add @agenticprimitives/orchestration\n```\n\n## Quick start\n\n```ts\nimport { runIntent, createRuleBasedPlanner, type ToolSpec } from '@agenticprimitives/orchestration';\n\nconst tools: ToolSpec[] = [\n  { id: 'get_vault_record', description: 'Read one of the principal’s vault records by recordType.' },\n  { id: 'get_pii', description: 'Read the principal’s PII (high sensitivity).' },\n];\n\n// Deterministic default planner — goal → tool. No model, no creds.\nconst planner = createRuleBasedPlanner([\n  { match: /profile/, toolId: 'get_vault_record', args: { recordType: 'impact-profile' } },\n  { match: /pii|personal/, toolId: 'get_pii' },\n]);\n\nconst result = await runIntent(\n  { goal: 'read my profile' },\n  {\n    planner,\n    tools,\n    // The invoker is where authority lives — the a2a skill binds this to the task's delegation.\n    invoke: async (toolId, args) => myMcpCall(toolId, args),\n  },\n);\n\nif (result.outcome === 'completed') console.log(result.result);\n```\n\n## Concepts\n\n- **`Intent`** — a declarative goal (`{ goal, constraints?, context? }`), never a tool name or call sequence.\n- **`Planner`** — the injected port that turns a goal + the exposed `ToolSpec[]` into a `Plan`. Swap the\n  deterministic `createRuleBasedPlanner` for the LLM adapter without touching the loop.\n- **`ToolInvoker`** — the injected port that executes one step. The orchestration core never holds a token,\n  key, or chain client; the invoker carries the on-chain authority (delegation).\n- **`runIntent`** — the loop: plan → execute (with `{ $ref }` result threading) → observe → bounded re-plan on\n  failure. Fail-closed: every error path returns a `failed` `RunResult`.\n\n## Boundaries\n\nPure leaf. Forbidden imports: `a2a`, `mcp-runtime`, `mcp-protocol`, `delegation`, `service-agent`, and any LLM\nSDK. See `spec.md` + `capability.manifest.json`.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}