@yansirplus/cli 0.5.17 → 0.5.19

package/agent-catalog/agentOS/references/agent/recipes.json

@@ -0,0 +1,109 @@
+{
+  "generatedBy": "packages/cli/src/generate/generate-agent-docs.mjs",
+  "source": "docs/agent/recipes.source.json",
+  "recipes": [
+    {
+      "id": "recipe.natural-language-workspace-agent",
+      "title": "Build a natural-language workspace agent",
+      "intents": [
+        "compile an authored workspace agent into a static target",
+        "generate a typed client from agentos.config.jsonc"
+      ],
+      "tutorial": "docs/guides/build-natural-language-workspace-agent.md",
+      "primitives": [
+        "primitive.agent-authoring.compileAgentTree",
+        "primitive.agent-authoring.linkWorkspaceStaticTarget"
+      ],
+      "commands": ["pnpm --filter @agent-os/cli test", "pnpm run check:distribution"],
+      "evidence": [
+        "packages/cli/test/build-command.test.mjs",
+        "packages/cli/src/check/algorithmic-checks.mjs"
+      ],
+      "next": ["recipe.tool-schema-authority", "recipe.projection-reader"]
+    },
+    {
+      "id": "recipe.hello-ledger-event",
+      "title": "Append and read a ledger event",
+      "intents": [
+        "Learn the D10 ledger truth identity",
+        "Emit one durable fact and read it through the backend protocol"
+      ],
+      "tutorial": "docs/tutorials/hello-ledger-event.md",
+      "noRouteReason": "tutorial-only ledger identity exercise; product workflows should route through a higher-level primitive",
+      "primitives": [
+        "primitive.kernel.LedgerEvent",
+        "primitive.kernel.ScopeRef",
+        "primitive.kernel.AuthorityRef",
+        "primitive.runtime.Ledger"
+      ],
+      "commands": ["pnpm --filter @agent-os/core test", "pnpm --filter @agent-os/core test"],
+      "evidence": [
+        "packages/core/test/kernel/effect-claim.test.ts",
+        "packages/core/test/backend-protocol/contract/runtime-backend-contract.ts"
+      ],
+      "next": ["recipe.projection-reader", "recipe.streaming-chatbot"]
+    },
+    {
+      "id": "recipe.projection-reader",
+      "title": "Build a materialized projection reader",
+      "intents": [
+        "Derive observable state from ledger facts",
+        "Keep projection state out of the source-of-truth role"
+      ],
+      "tutorial": "docs/tutorials/projection-reader.md",
+      "primitives": [
+        "primitive.runtime.MaterializedProjectionDefinition",
+        "primitive.runtime.defineProjection",
+        "primitive.runtime.ProjectionReduceResult"
+      ],
+      "commands": ["pnpm --filter @agent-os/runtime test"],
+      "evidence": [
+        "packages/runtime/test/projection.test.ts",
+        "packages/runtime/test/in-memory/materialized-projections.test.ts"
+      ],
+      "next": ["recipe.durable-trigger-cancel", "recipe.full-small-agent-app"]
+    },
+    {
+      "id": "recipe.streaming-chatbot",
+      "title": "Stream an agent run",
+      "intents": [
+        "Submit an LLM run through the runtime",
+        "Project runtime ledger facts into browser-safe frames"
+      ],
+      "tutorial": "docs/tutorials/streaming-chatbot.md",
+      "primitives": [
+        "primitive.runtime.SubmitSpec",
+        "primitive.runtime.SubmitResult",
+        "primitive.ag-ui.projectLedgerEventToAgUiEnvelope"
+      ],
+      "commands": ["pnpm --filter @agent-os/runtime test"],
+      "evidence": [
+        "packages/runtime/test/submit-agent-runtime-events.test.ts",
+        "packages/runtime/test/cloudflare/workspace-host-helpers.test.ts"
+      ],
+      "next": ["recipe.tool-schema-authority", "recipe.full-small-agent-app"]
+    },
+    {
+      "id": "recipe.tool-schema-authority",
+      "title": "Add a tool with schema, admission, and execution domain",
+      "intents": [
+        "Define the tool schema from Effect Schema",
+        "Route effectful execution through a declared execution domain"
+      ],
+      "tutorial": "docs/tutorials/tool-schema-authority.md",
+      "primitives": [
+        "primitive.kernel.AgentSchema",
+        "primitive.kernel.Tool",
+        "primitive.kernel.ExecutionDomain",
+        "primitive.kernel.BoundaryContract"
+      ],
+      "commands": ["pnpm --filter @agent-os/core test", "pnpm --filter @agent-os/runtime test"],
+      "evidence": [
+        "packages/core/test/kernel/agent-schema.test.ts",
+        "packages/core/test/kernel/tools.test.ts",
+        "packages/runtime/test/cloudflare/workspace-host-helpers.test.ts"
+      ],
+      "next": ["recipe.provider-material-binding", "recipe.full-small-agent-app"]
+    }
+  ]
+}

package/agent-catalog/agentOS/references/agent/start-here.md

@@ -0,0 +1,25 @@
+<!-- generated by packages/cli/src/generate/generate-agent-docs.mjs; edit *.source.json and exported TSDoc @agentosPrimitive tags -->
+
+# Start Here
+
+Agent-facing docs are generated projections. Source facts live in `*.source.json`, `docs/surface.json`, package manifests, and exported TSDoc annotation tags.
+
+## Navigation
+
+| Surface          | Generated File                                 |
+| ---------------- | ---------------------------------------------- |
+| Recipes          | [recipes.json](recipes.json)                   |
+| Primitives       | [primitives.json](primitives.json)             |
+| Decision Graph   | [decision-graph.json](decision-graph.json)     |
+| Errors           | [errors.json](errors.json)                     |
+| Invariant Matrix | [invariant-matrix.json](invariant-matrix.json) |
+
+## Recipes
+
+| Recipe                                    | Tutorial                                                                                       | Primary Primitives                                                                                                                     |
+| ----------------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `recipe.natural-language-workspace-agent` | Build a natural-language workspace agent (`guides/build-natural-language-workspace-agent.md`)  | `primitive.agent-authoring.compileAgentTree`, `primitive.agent-authoring.linkWorkspaceStaticTarget`                                    |
+| `recipe.hello-ledger-event`               | Append and read a ledger event (`tutorials/hello-ledger-event.md`)                             | `primitive.kernel.LedgerEvent`, `primitive.kernel.ScopeRef`, `primitive.kernel.AuthorityRef`, `primitive.runtime.Ledger`               |
+| `recipe.projection-reader`                | Build a materialized projection reader (`tutorials/projection-reader.md`)                      | `primitive.runtime.MaterializedProjectionDefinition`, `primitive.runtime.defineProjection`, `primitive.runtime.ProjectionReduceResult` |
+| `recipe.streaming-chatbot`                | Stream an agent run (`tutorials/streaming-chatbot.md`)                                         | `primitive.runtime.SubmitSpec`, `primitive.runtime.SubmitResult`, `primitive.ag-ui.projectLedgerEventToAgUiEnvelope`                   |
+| `recipe.tool-schema-authority`            | Add a tool with schema, admission, and execution domain (`tutorials/tool-schema-authority.md`) | `primitive.kernel.AgentSchema`, `primitive.kernel.Tool`, `primitive.kernel.ExecutionDomain`, `primitive.kernel.BoundaryContract`       |

package/agent-catalog/agentOS/references/package-map.md

@@ -0,0 +1,73 @@
+# agentOS Package Map
+
+Release version: `0.5.19`
+Published scope: `@yansirplus`
+
+## Packages
+
+| Source Package      | Published Package     | Path               | Status       | Role                                                                                                                                                                                                                                              |
+| ------------------- | --------------------- | ------------------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@agent-os/cli`     | `@yansirplus/cli`     | `packages/cli`     | 0.5.x public | developer command surface for generated projections, authored agent builds, structural checks, and distribution gates                                                                                                                             |
+| `@agent-os/client`  | `@yansirplus/client`  | `packages/client`  | 0.5.x public | transport-neutral agent client store, typed command surface, and optional framework subpath bridges                                                                                                                                               |
+| `@agent-os/core`    | `@yansirplus/core`    | `packages/core`    | 0.5.x public | neutral substrate axioms, owner identity helpers, value brands, protocol schemas, shared errors, material refs, AgentSchema, tool algebra, and backend/runtime/LLM/telemetry vocabulary                                                           |
+| `@agent-os/evals`   | `@yansirplus/evals`   | `packages/evals`   | 0.5.x public | eval authoring DSL, symbolic eval configuration, deterministic assertion declarations, and runner-facing case/context types for generated app behavior checks                                                                                     |
+| `@agent-os/runtime` | `@yansirplus/runtime` | `packages/runtime` | 0.5.x public | Effect Tag runtime programs, backend-neutral runtime services, projections, workspace-job observability joins, deterministic testing fixtures, and optional-peer subpath adapters for Cloudflare, in-memory, Node, Effect AI, and OTLP telemetry. |
+
+## Entrypoints
+
+| Import                                                | Audience                       | Capability                                                                                 | Owner                 |
+| ----------------------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------ | --------------------- |
+| `@yansirplus/cli`                                     | default-direct                 | developer CLI command package                                                              | `@yansirplus/cli`     |
+| `@yansirplus/client`                                  | default-direct                 | transport-neutral client store                                                             | `@yansirplus/client`  |
+| `@yansirplus/client/react`                            | default-direct                 | React client adapter                                                                       | `@yansirplus/client`  |
+| `@yansirplus/client/svelte`                           | default-direct, generated-only | Svelte client adapter                                                                      | `@yansirplus/client`  |
+| `@yansirplus/client/workspace-agent`                  | generated-only                 | generated workspace agent client                                                           | `@yansirplus/client`  |
+| `@yansirplus/core`                                    | advanced                       | neutral substrate algebra and brands                                                       | `@yansirplus/core`    |
+| `@yansirplus/core/abort`                              | advanced                       | abort vocabulary                                                                           | `@yansirplus/core`    |
+| `@yansirplus/core/agent-schema`                       | advanced                       | agent schema authoring algebra                                                             | `@yansirplus/core`    |
+| `@yansirplus/core/authored-value`                     | advanced                       | authored value ownership                                                                   | `@yansirplus/core`    |
+| `@yansirplus/core/backend-protocol`                   | advanced                       | backend protocol DTOs                                                                      | `@yansirplus/core`    |
+| `@yansirplus/core/backend-protocol/reference`         | advanced                       | backend protocol reference helpers                                                         | `@yansirplus/core`    |
+| `@yansirplus/core/boundary-contract`                  | advanced                       | boundary contract declarations                                                             | `@yansirplus/core`    |
+| `@yansirplus/core/carrier`                            | advanced                       | carrier algebra                                                                            | `@yansirplus/core`    |
+| `@yansirplus/core/context`                            | advanced                       | context value helpers                                                                      | `@yansirplus/core`    |
+| `@yansirplus/core/effect-claim`                       | advanced                       | effect claim vocabulary                                                                    | `@yansirplus/core`    |
+| `@yansirplus/core/errors`                             | advanced                       | shared error classes                                                                       | `@yansirplus/core`    |
+| `@yansirplus/core/extensions`                         | advanced                       | extension declarations                                                                     | `@yansirplus/core`    |
+| `@yansirplus/core/live-edge`                          | advanced                       | live edge protocol                                                                         | `@yansirplus/core`    |
+| `@yansirplus/core/llm-protocol`                       | advanced                       | LLM protocol DTOs                                                                          | `@yansirplus/core`    |
+| `@yansirplus/core/material-ref`                       | advanced                       | material refs                                                                              | `@yansirplus/core`    |
+| `@yansirplus/core/projection`                         | advanced                       | projection algebra                                                                         | `@yansirplus/core`    |
+| `@yansirplus/core/quota`                              | advanced                       | quota declarations                                                                         | `@yansirplus/core`    |
+| `@yansirplus/core/recorded-value`                     | advanced                       | recorded value algebra                                                                     | `@yansirplus/core`    |
+| `@yansirplus/core/ref-resolver`                       | advanced                       | material ref resolution                                                                    | `@yansirplus/core`    |
+| `@yansirplus/core/runtime-protocol`                   | generated-only                 | runtime DTOs emitted by generated targets                                                  | `@yansirplus/core`    |
+| `@yansirplus/core/runtime-scope`                      | advanced                       | runtime scope helpers                                                                      | `@yansirplus/core`    |
+| `@yansirplus/core/settlement-contract`                | advanced                       | settlement contract algebra                                                                | `@yansirplus/core`    |
+| `@yansirplus/core/telemetry-protocol`                 | advanced                       | telemetry protocol DTOs                                                                    | `@yansirplus/core`    |
+| `@yansirplus/core/tools`                              | generated-only                 | tool definitions emitted by generated targets                                              | `@yansirplus/core`    |
+| `@yansirplus/core/types`                              | advanced                       | shared type helpers                                                                        | `@yansirplus/core`    |
+| `@yansirplus/core/workspace-agent`                    | advanced                       | workspace agent command/projection vocabulary                                              | `@yansirplus/core`    |
+| `@yansirplus/evals`                                   | default-direct                 | generated app eval authoring DSL                                                           | `@yansirplus/evals`   |
+| `@yansirplus/runtime`                                 | advanced                       | backend-neutral runtime service algebra                                                    | `@yansirplus/runtime` |
+| `@yansirplus/runtime/admission`                       | advanced                       | admission service contract                                                                 | `@yansirplus/runtime` |
+| `@yansirplus/runtime/ag-ui`                           | advanced                       | AG-UI wire projection                                                                      | `@yansirplus/runtime` |
+| `@yansirplus/runtime/cloudflare`                      | generated-only, advanced       | Cloudflare Durable Object runtime adapter                                                  | `@yansirplus/runtime` |
+| `@yansirplus/runtime/cloudflare/do-rpc`               | advanced                       | Cloudflare DO RPC bridge                                                                   | `@yansirplus/runtime` |
+| `@yansirplus/runtime/cloudflare/ops-api`              | advanced                       | Cloudflare ops API bridge                                                                  | `@yansirplus/runtime` |
+| `@yansirplus/runtime/capability`                      | generated-only, advanced       | capability contract declarations and install graph resolver                                | `@yansirplus/runtime` |
+| `@yansirplus/runtime/channel`                         | generated-only, advanced       | pure verified inbound channel contract for generated targets                               | `@yansirplus/runtime` |
+| `@yansirplus/runtime/external-effect`                 | advanced                       | vocabulary-neutral idempotent external-effect attempt runner                               | `@yansirplus/runtime` |
+| `@yansirplus/runtime/schedule`                        | generated-only, advanced       | pure UTC time ingress contract and schedule fire history projection for generated targets  | `@yansirplus/runtime` |
+| `@yansirplus/runtime/in-memory`                       | advanced                       | in-memory runtime adapter                                                                  | `@yansirplus/runtime` |
+| `@yansirplus/runtime/local`                           | generated-only, advanced       | local node workspace runtime lowerer and dev/test facade                                   | `@yansirplus/runtime` |
+| `@yansirplus/runtime/llm-effect-ai`                   | advanced                       | provider-neutral Effect AI LLM transport adapter                                           | `@yansirplus/runtime` |
+| `@yansirplus/runtime/llm-effect-ai/openai-compatible` | generated-only, advanced       | OpenAI-compatible chat-completions transport adapter                                       | `@yansirplus/runtime` |
+| `@yansirplus/runtime/llm-effect-ai/anthropic`         | advanced                       | Anthropic Effect AI provider adapter                                                       | `@yansirplus/runtime` |
+| `@yansirplus/runtime/node`                            | advanced                       | Node runtime adapter                                                                       | `@yansirplus/runtime` |
+| `@yansirplus/runtime/run-projector`                   | generated-only, advanced       | runtime run projection helpers                                                             | `@yansirplus/runtime` |
+| `@yansirplus/runtime/sse-http`                        | generated-only, advanced       | SSE HTTP helpers                                                                           | `@yansirplus/runtime` |
+| `@yansirplus/runtime/telemetry-otlp`                  | advanced                       | OTLP telemetry projection                                                                  | `@yansirplus/runtime` |
+| `@yansirplus/runtime/testing`                         | advanced                       | deterministic in-memory WorkspaceEnv fixture and external-effect conformance report helper | `@yansirplus/runtime` |
+| `@yansirplus/runtime/workspace-agent`                 | generated-only                 | generated workspace agent host types                                                       | `@yansirplus/runtime` |
+| `@yansirplus/runtime/workspace-binding`               | generated-only                 | generated workspace tool binding                                                           | `@yansirplus/runtime` |

package/agent-catalog/agentOS/references/provenance.json

@@ -0,0 +1,251 @@
+{
+  "schemaVersion": 1,
+  "generatedBy": {
+    "id": "packages/cli/src/generate/generate-agent-catalog.mjs",
+    "version": 1
+  },
+  "generatedAt": "2026-06-26T03:12:17.000Z",
+  "generatedAtSource": "git-head-commit-time",
+  "package": {
+    "sourcePackage": "@agent-os/cli",
+    "publicPackage": "@yansirplus/cli",
+    "version": "0.5.19",
+    "publicScope": "@yansirplus",
+    "catalogRoot": "agent-catalog/agentOS"
+  },
+  "git": {
+    "available": false,
+    "reason": "catalog is generated before the commit that records it; inputFiles and outputFiles carry the stable content hashes"
+  },
+  "inputFiles": [
+    {
+      "path": "docs/agent/boundary-rules.source.json",
+      "sha256": "27d81dff3a4158bed444fed7e618021479fa77dc289ea80b1a0ca37185f42e63",
+      "byteSize": 42140
+    },
+    {
+      "path": "docs/agent/capability-rules.source.json",
+      "sha256": "b0519f73acdc424a9896222d0e3d7a858caf0762fbf8e7b4ca2b725a97569baf",
+      "byteSize": 6118
+    },
+    {
+      "path": "docs/agent/decision-graph.json",
+      "sha256": "d92ced96c8625079e1974d0e98b5ee12eb96014bdf1974ada3ada7c294e2efd1",
+      "byteSize": 18149
+    },
+    {
+      "path": "docs/agent/error-metadata.source.json",
+      "sha256": "6cd59f000dc30f60a9ed9823b7a0733d5bcf495d544803b025580b3c27020a40",
+      "byteSize": 21759
+    },
+    {
+      "path": "docs/agent/errors.json",
+      "sha256": "939229df05f67cecb8166a5716e73d3dcee017a311f6fd6802c466c78a082db7",
+      "byteSize": 25336
+    },
+    {
+      "path": "docs/agent/external-vocabulary.source.json",
+      "sha256": "a344487abbfcaf134d23954d9e1f291305626b5529897d010a54244d057492f9",
+      "byteSize": 1433
+    },
+    {
+      "path": "docs/agent/gates.source.json",
+      "sha256": "b4f7144c626ecc0192abc84d3122d327a27e1b64b24888a19a4f6709a301a055",
+      "byteSize": 2765
+    },
+    {
+      "path": "docs/agent/invariant-matrix.json",
+      "sha256": "9aa62077a27c2c6b26b4c02d9fe7b4efdcd01c56977720ee631260c266d290e8",
+      "byteSize": 15110
+    },
+    {
+      "path": "docs/agent/invariants.source.json",
+      "sha256": "cbf387d650629e88efa23d13bd1856146df7eb95cdb27f3d458d251322b7906d",
+      "byteSize": 7071
+    },
+    {
+      "path": "docs/agent/primitive-evidence.source.json",
+      "sha256": "c5909934699fb3c76bf66fe4c5c658e2db9a87309261506f1f5c50fa6410b45b",
+      "byteSize": 8607
+    },
+    {
+      "path": "docs/agent/primitives.json",
+      "sha256": "4bcd854d44eda53d1b4160d195be0e6af1156678439b8f222c88c5d91692366e",
+      "byteSize": 40874
+    },
+    {
+      "path": "docs/agent/recipes.json",
+      "sha256": "9e3cd1f4812e60efe0ccc6ebf35fb74c2ed3fefa8c1bef2923397046252ebe06",
+      "byteSize": 4396
+    },
+    {
+      "path": "docs/agent/recipes.source.json",
+      "sha256": "531879abc2060157a1840ea72f5f940674d9e2fb272b2b6f15b55ea816b78616",
+      "byteSize": 4302
+    },
+    {
+      "path": "docs/agent/schemas/capability-rules.source.schema.json",
+      "sha256": "1e70aeaae705c9bb3657daaf6ea568768015923cf1287c6da3d9bfa106b7d481",
+      "byteSize": 2396
+    },
+    {
+      "path": "docs/agent/schemas/error-metadata.source.schema.json",
+      "sha256": "76cc7aeb154aa2cbe6ea27225d3b7275a5df3885c667ae316d4fa95fd7a02b90",
+      "byteSize": 1191
+    },
+    {
+      "path": "docs/agent/schemas/external-vocabulary.source.schema.json",
+      "sha256": "233eb3f5c3784a0caab1ab0cc7a49812e5caacfa8288de30fcffe2b02754b961",
+      "byteSize": 1309
+    },
+    {
+      "path": "docs/agent/schemas/invariants.source.schema.json",
+      "sha256": "e92dcbbd3056d6d70ed733e53121e2217730e2466a8ac8bdd8c4d33e63e70973",
+      "byteSize": 1128
+    },
+    {
+      "path": "docs/agent/schemas/recipes.source.schema.json",
+      "sha256": "bdff4b5fccfa43f7ea5e308de35b1b25d826d1b62cdbc58043a84ee97aeaa65d",
+      "byteSize": 1802
+    },
+    {
+      "path": "docs/api/cli.md",
+      "sha256": "45e254ca97dde42c1f75407609dac457e6d2ce02234ec08339f1cd6d55e20ace",
+      "byteSize": 733
+    },
+    {
+      "path": "docs/api/client.md",
+      "sha256": "9d206ed56926e164a48569f2f36ea05dca272df458b26e400bfb47460ee144df",
+      "byteSize": 3350
+    },
+    {
+      "path": "docs/api/core.md",
+      "sha256": "e9435b92638ec068faac3e380bed907161dc365c69c487ff8bcc9bd5d971b8f1",
+      "byteSize": 69795
+    },
+    {
+      "path": "docs/api/runtime.md",
+      "sha256": "e24656ecdd2ae5b99a36cbeb85cd5e65e84ee0880ede55a46afa3311ec7b30bd",
+      "byteSize": 31356
+    },
+    {
+      "path": "docs/runtime-packages.md",
+      "sha256": "bd484dfea39f75fa97e2773e2ccec203163959261842516fb88cd13287bd708d",
+      "byteSize": 29411
+    },
+    {
+      "path": "docs/start-here.md",
+      "sha256": "9cfe1103d214681307af4a459ef77574805ae7e17af08a156b70460adcf705f6",
+      "byteSize": 2893
+    },
+    {
+      "path": "docs/surface.json",
+      "sha256": "83e13dee91fd2500ae3fa7b329f75061ec9789db92cff37184ffff6f9e7c2c9b",
+      "byteSize": 18787
+    },
+    {
+      "path": "package.json",
+      "sha256": "02940aa4cd34acac3b0b5bb1f39927754e94a23ce9b2a70a155004acb2e3afd4",
+      "byteSize": 5045
+    },
+    {
+      "path": "packages/cli/package.json",
+      "sha256": "1c2159ba24e9ef008bea31a4f6eed0b884f1b882479536ef4a0fcf8626696f57",
+      "byteSize": 691
+    },
+    {
+      "path": "packages/client/package.json",
+      "sha256": "d408d2940177fd71f73c9041d87043c476544738df9a7945eb09f2c99995ebb9",
+      "byteSize": 1246
+    },
+    {
+      "path": "packages/core/package.json",
+      "sha256": "d034f01df3a182485df8fc213441b0aaeaf3ab0cf2ea10fc2364f1ee8f11df42",
+      "byteSize": 3570
+    },
+    {
+      "path": "packages/evals/package.json",
+      "sha256": "d1b6aed4f7db19c6052b9ec9358e720ced7b106ef4ad2bd6d7cc9d37b0ab161d",
+      "byteSize": 532
+    },
+    {
+      "path": "packages/runtime/package.json",
+      "sha256": "b1ab0889c3af19999d41f66da04e54f99c24e1b3c76f88845a6b80653e17eed3",
+      "byteSize": 4008
+    },
+    {
+      "path": "tooling/docs-site/package.json",
+      "sha256": "02386636a3fbcfa1f8221f9a1648d959964cfe9ed804b80a1e13f2a21f624a68",
+      "byteSize": 303
+    }
+  ],
+  "outputFiles": [
+    {
+      "path": "agent-catalog/agentOS/SKILL.md",
+      "sha256": "a4acb0b6cdfbfa2accd1189d49f6993801dffd63be0972911b87218efee53999",
+      "byteSize": 1048
+    },
+    {
+      "path": "agent-catalog/agentOS/references/package-map.md",
+      "sha256": "da752eace7b9c924dfae92c3bb613caaf9dc2c6e367ddc444e892439d3ec8f0e",
+      "byteSize": 14055
+    },
+    {
+      "path": "agent-catalog/agentOS/references/public-api/core.md",
+      "sha256": "2caebc8ef86189ff0cea096221dfb14bfbcdb9ee507fc186af60c192eb872826",
+      "byteSize": 69797
+    },
+    {
+      "path": "agent-catalog/agentOS/references/public-api/runtime.md",
+      "sha256": "447552c27308476057d2a609bbaf5592e9b64558e795a0ff63e69c14a818b033",
+      "byteSize": 31358
+    },
+    {
+      "path": "agent-catalog/agentOS/references/public-api/client.md",
+      "sha256": "cd5b84b526ed085c4a4775e59fbadc1811fb4ee447d4edf272f4ef52eac02ec5",
+      "byteSize": 3352
+    },
+    {
+      "path": "agent-catalog/agentOS/references/public-api/cli.md",
+      "sha256": "f710dd2771ad370f003f6051eb715376a637151e046a98b06c068502abb2408a",
+      "byteSize": 735
+    },
+    {
+      "path": "agent-catalog/agentOS/references/agent/start-here.md",
+      "sha256": "9a01b676da04d3de17a1a208c528eea3a0156c2a0612340cb340c24c2f116225",
+      "byteSize": 2787
+    },
+    {
+      "path": "agent-catalog/agentOS/references/agent/recipes.json",
+      "sha256": "9e3cd1f4812e60efe0ccc6ebf35fb74c2ed3fefa8c1bef2923397046252ebe06",
+      "byteSize": 4396
+    },
+    {
+      "path": "agent-catalog/agentOS/references/agent/primitives.json",
+      "sha256": "4bcd854d44eda53d1b4160d195be0e6af1156678439b8f222c88c5d91692366e",
+      "byteSize": 40874
+    },
+    {
+      "path": "agent-catalog/agentOS/references/agent/decision-graph.json",
+      "sha256": "d92ced96c8625079e1974d0e98b5ee12eb96014bdf1974ada3ada7c294e2efd1",
+      "byteSize": 18149
+    },
+    {
+      "path": "agent-catalog/agentOS/references/agent/errors.json",
+      "sha256": "939229df05f67cecb8166a5716e73d3dcee017a311f6fd6802c466c78a082db7",
+      "byteSize": 25336
+    },
+    {
+      "path": "agent-catalog/agentOS/references/agent/invariant-matrix.json",
+      "sha256": "9aa62077a27c2c6b26b4c02d9fe7b4efdcd01c56977720ee631260c266d290e8",
+      "byteSize": 15110
+    }
+  ],
+  "outputHashScope": "all generated files except references/provenance.json to avoid a self-referential hash",
+  "prohibitedSources": [
+    "catalog.source.json",
+    "archived CST events",
+    "network/npm registry reads",
+    "runtime imports"
+  ]
+}

package/agent-catalog/agentOS/references/public-api/cli.md

@@ -0,0 +1,20 @@
+# @yansirplus/cli Public API Intent
+
+<!-- generated by packages/cli/src/generate/generate-docs.mjs; edit exported TSDoc in package source -->
+
+## Public exports
+
+- `.:compileAgentTree` - Compile an authored `agent/` tree into one normalized manifest plus provenance. Runtime facts and provider material are rejected before they can become manifest truth.
+- `.:linkWorkspaceStaticTarget` - Link normalized workspace authoring intent to a closed-target residual program. Implementation wiring is static imports and factory composition; manifest and deployment JSON remain semantic/provenance data only.
+
+## Experimental exports
+
+None.
+
+## Deprecated exports
+
+None.
+
+## Internal-only exports
+
+Any package file or symbol not listed above.

package/agent-catalog/agentOS/references/public-api/client.md

@@ -0,0 +1,90 @@
+# @yansirplus/client Public API Intent
+
+## Public exports
+
+- `.:AgentClientCommandMap`
+- `.:AgentClientCommandOptions`
+- `.:AgentClientCommandSpec`
+- `.:AgentClientConnectionSnapshot`
+- `.:AgentClientConnectionStatus`
+- `.:AgentClientController`
+- `.:AgentClientInputRequestSnapshot`
+- `.:AgentClientListener`
+- `.:AgentClientRpcInvoker`
+- `.:AgentClientRunInspectionSnapshot`
+- `.:AgentClientRunSnapshot`
+- `.:AgentClientRunStatus`
+- `.:AgentClientSelector`
+- `.:AgentClientSnapshot`
+- `.:AgentClientStore`
+- `.:AgentClientStoreController`
+- `.:AgentClientStreamCursor`
+- `.:AgentClientStreamOptions`
+- `.:AgentClientStreamSource`
+- `.:AgentClientUnsubscribe`
+- `.:appendRuntimeEventsToSnapshot`
+- `.:createAgentClient`
+- `.:CreateAgentClientOptions`
+- `.:createAgentClientStore`
+- `.:createInitialAgentClientSnapshot`
+- `.:isCurrentContinuationRef`
+- `.:isCurrentInputRequestRef`
+- `.:projectAgentClientRunInspection`
+- `.:selectAgentClientSnapshot`
+- `./react:AgentClientSelector`
+- `./react:AgentClientStore`
+- `./react:useAgentClientSnapshot`
+- `./react:useClientStore`
+- `./svelte:AgentClientSelector`
+- `./svelte:AgentClientStore`
+- `./svelte:clientReadable`
+- `./svelte:selectClientReadable`
+- `./workspace-agent:createWorkspaceAgentClient`
+- `./workspace-agent:createWorkspaceAgentClientBridge`
+- `./workspace-agent:CreateWorkspaceAgentClientOptions`
+- `./workspace-agent:WORKSPACE_AGENT_COMMAND`
+- `./workspace-agent:WORKSPACE_AGENT_PRODUCT_COMMAND`
+- `./workspace-agent:WorkspaceAgentClient`
+- `./workspace-agent:WorkspaceAgentClientBridge`
+- `./workspace-agent:WorkspaceAgentCommandInputByName`
+- `./workspace-agent:WorkspaceAgentCommandMap`
+- `./workspace-agent:WorkspaceAgentCommandName`
+- `./workspace-agent:WorkspaceAgentCommandOutputByName`
+- `./workspace-agent:WorkspaceAgentCustomCommandInput`
+- `./workspace-agent:WorkspaceAgentDecideInputRequestCommandInput`
+- `./workspace-agent:WorkspaceAgentDestroyCommandInput`
+- `./workspace-agent:WorkspaceAgentFileEntry`
+- `./workspace-agent:WorkspaceAgentMutationCommandOutput`
+- `./workspace-agent:WorkspaceAgentProductClient`
+- `./workspace-agent:WorkspaceAgentProductCommandInputByName`
+- `./workspace-agent:WorkspaceAgentProductCommandMap`
+- `./workspace-agent:WorkspaceAgentProductCommandName`
+- `./workspace-agent:WorkspaceAgentProductCommandOutputByName`
+- `./workspace-agent:WorkspaceAgentProductProjectionTypes`
+- `./workspace-agent:WorkspaceAgentProjectionName`
+- `./workspace-agent:WorkspaceAgentReadFileCommandInput`
+- `./workspace-agent:WorkspaceAgentReadFileCommandOutput`
+- `./workspace-agent:WorkspaceAgentReadStateCommandInput`
+- `./workspace-agent:WorkspaceAgentReadStateCommandOutput`
+- `./workspace-agent:WorkspaceAgentResetCommandInput`
+- `./workspace-agent:WorkspaceAgentResumeInputRequestCommandInput`
+- `./workspace-agent:WorkspaceAgentSessionInspectInput`
+- `./workspace-agent:WorkspaceAgentSessionsClient`
+- `./workspace-agent:WorkspaceAgentSessionSubmitTurnInput`
+- `./workspace-agent:WorkspaceAgentSubmitCommandInput`
+- `./workspace-agent:WorkspaceAgentWorkflowRunInput`
+- `./workspace-agent:WorkspaceAgentWorkflowRunRef`
+- `./workspace-agent:WorkspaceAgentWorkflowRunsInput`
+- `./workspace-agent:WorkspaceAgentWorkflowsClient`
+
+## Experimental exports
+
+None.
+
+## Deprecated exports
+
+None.
+
+## Internal-only exports
+
+Any package file or symbol not listed above.