@inneranimalmedia/agentsam-sdk 2.6.9 → 2.6.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (176) hide show
  1. package/README.md +18 -0
  2. package/apps/cad-creator/shared/cad/package.json +1 -1
  3. package/apps/client-cms-editor/backend/package.json +3 -3
  4. package/apps/client-cms-editor/frontend/package.json +4 -4
  5. package/apps/client-cms-editor/package-lock.json +8 -8
  6. package/apps/client-cms-editor/package.json +1 -1
  7. package/apps/client-cms-editor/shared/cms/package.json +2 -2
  8. package/docs/architecture/HOOKS-MODELS-SELF-HOSTING-PLAN.md +199 -0
  9. package/examples/hyperspace-demo/index.html +16 -0
  10. package/examples/hyperspace-demo/package.json +21 -0
  11. package/examples/hyperspace-demo/src/main.tsx +160 -0
  12. package/examples/hyperspace-demo/tsconfig.json +9 -0
  13. package/examples/hyperspace-demo/vite.config.ts +24 -0
  14. package/migrations/runtime/0005_agentsam_hooks.sql +87 -0
  15. package/package.json +23 -7
  16. package/packages/agentsam-brand/package.json +1 -1
  17. package/packages/agentsam-brand/src/core/v2/compile.js +1 -1
  18. package/packages/agentsam-brand/src/core/v2/schema.js +1 -1
  19. package/packages/agentsam-contracts/package.json +1 -1
  20. package/packages/agentsam-contracts/src/errors.ts +19 -10
  21. package/packages/agentsam-errors/package.json +11 -3
  22. package/packages/agentsam-errors/protocol/agentsam.error.v2.schema.json +821 -0
  23. package/packages/agentsam-errors/protocol/error-catalog.json +3512 -0
  24. package/packages/agentsam-errors/src/envelope.js +63 -11
  25. package/packages/agentsam-errors/src/error.js +6 -0
  26. package/packages/agentsam-errors/src/fingerprint.js +9 -1
  27. package/packages/agentsam-errors/src/normalize.js +51 -6
  28. package/packages/agentsam-errors/src/recovery.js +9 -35
  29. package/packages/agentsam-errors/src/transport.js +6 -1
  30. package/packages/agentsam-errors/src/vocabulary.js +515 -126
  31. package/packages/agentsam-errors/test/catalog-v2.test.mjs +106 -0
  32. package/packages/agentsam-errors/types/index.d.ts +157 -0
  33. package/packages/agentsam-goap/package.json +2 -2
  34. package/packages/agentsam-hooks/README.md +206 -0
  35. package/packages/agentsam-hooks/bin/agentsam-hooks.mjs +64 -0
  36. package/packages/agentsam-hooks/bindings/go/command.go +55 -0
  37. package/packages/agentsam-hooks/bindings/go/errors_generated.go +402 -0
  38. package/packages/agentsam-hooks/bindings/go/go.mod +3 -0
  39. package/packages/agentsam-hooks/bindings/go/hooks.go +285 -0
  40. package/packages/agentsam-hooks/bindings/go/hooks_test.go +48 -0
  41. package/packages/agentsam-hooks/bindings/rust/Cargo.toml +11 -0
  42. package/packages/agentsam-hooks/bindings/rust/src/errors_generated.rs +396 -0
  43. package/packages/agentsam-hooks/bindings/rust/src/lib.rs +397 -0
  44. package/packages/agentsam-hooks/package.json +69 -0
  45. package/packages/agentsam-hooks/schema/manifest.json +54 -0
  46. package/packages/agentsam-hooks/scripts/clean-protocol.mjs +17 -0
  47. package/packages/agentsam-hooks/scripts/sync-protocol.mjs +27 -0
  48. package/packages/agentsam-hooks/src/adapters/agents.js +82 -0
  49. package/packages/agentsam-hooks/src/adapters/callback.js +4 -0
  50. package/packages/agentsam-hooks/src/adapters/capability.js +122 -0
  51. package/packages/agentsam-hooks/src/adapters/command.js +104 -0
  52. package/packages/agentsam-hooks/src/adapters/composite.js +31 -0
  53. package/packages/agentsam-hooks/src/adapters/http.js +58 -0
  54. package/packages/agentsam-hooks/src/adapters/lsp.js +116 -0
  55. package/packages/agentsam-hooks/src/adapters/mcp.js +76 -0
  56. package/packages/agentsam-hooks/src/adapters/provider.js +129 -0
  57. package/packages/agentsam-hooks/src/config.js +143 -0
  58. package/packages/agentsam-hooks/src/contracts.js +284 -0
  59. package/packages/agentsam-hooks/src/errors-generated.js +2732 -0
  60. package/packages/agentsam-hooks/src/index.d.ts +193 -0
  61. package/packages/agentsam-hooks/src/index.js +14 -0
  62. package/packages/agentsam-hooks/src/policy.js +34 -0
  63. package/packages/agentsam-hooks/src/runtime.js +312 -0
  64. package/packages/agentsam-hooks/src/store.js +264 -0
  65. package/packages/agentsam-hooks/test/adapters.test.mjs +216 -0
  66. package/packages/agentsam-hooks/test/runtime.test.mjs +258 -0
  67. package/packages/agentsam-knowledge/package.json +1 -1
  68. package/packages/agentsam-nav/dist/Nav.d.ts +43 -0
  69. package/packages/agentsam-nav/dist/NavCollapsible.d.ts +10 -0
  70. package/packages/agentsam-nav/dist/NavContent.d.ts +2 -0
  71. package/packages/agentsam-nav/dist/NavFooter.d.ts +2 -0
  72. package/packages/agentsam-nav/dist/NavGroup.d.ts +3 -0
  73. package/packages/agentsam-nav/dist/NavHeader.d.ts +2 -0
  74. package/packages/agentsam-nav/dist/NavMenu.d.ts +22 -0
  75. package/packages/agentsam-nav/dist/NavProvider.d.ts +35 -0
  76. package/packages/agentsam-nav/dist/NavTrigger.d.ts +2 -0
  77. package/packages/agentsam-nav/dist/Surfaces.d.ts +41 -0
  78. package/packages/agentsam-nav/dist/browser.d.ts +11 -0
  79. package/packages/agentsam-nav/dist/browser.global.js +135 -0
  80. package/packages/agentsam-nav/dist/browser.js +7290 -0
  81. package/packages/agentsam-nav/dist/contracts.d.ts +76 -0
  82. package/packages/agentsam-nav/dist/index.d.ts +11 -0
  83. package/packages/agentsam-nav/dist/index.js +7291 -0
  84. package/packages/agentsam-nav/dist/legacy.css +83 -0
  85. package/packages/agentsam-nav/dist/shell.css +113 -0
  86. package/packages/agentsam-nav/dist/theme.css +113 -0
  87. package/packages/agentsam-nav/dist/utils.d.ts +1 -0
  88. package/packages/agentsam-nav/package.json +1 -1
  89. package/packages/agentsam-queue-control/package.json +1 -1
  90. package/packages/agentsam-repository/package.json +1 -1
  91. package/packages/agentsam-repository/src/goap.js.bak-20260922011251 +670 -0
  92. package/packages/agentsam-vault/package.json +1 -1
  93. package/packages/agentsam-workbench/package.json +3 -3
  94. package/packages/connectors/cloudflare/package.json +1 -1
  95. package/packages/heuristic-theme/package.json +1 -1
  96. package/packages/identity/package.json +2 -2
  97. package/packages/providers/completeful/package.json +1 -1
  98. package/packages/theme-church-site/package.json +2 -2
  99. package/packages/theme-companions-site/package.json +2 -2
  100. package/packages/theme-floors-site/package.json +2 -2
  101. package/packages/theme-fuelnfree-site/package.json +2 -2
  102. package/packages/theme-handyman-site/package.json +2 -2
  103. package/packages/theme-insurance-site/package.json +2 -2
  104. package/packages/theme-scenes/package.json +1 -1
  105. package/packages/theme-shinshu-site/package.json +2 -2
  106. package/packages/work-graph/package.json +1 -1
  107. package/protocol/apps/agentsam.app.v1.schema.json +1 -1
  108. package/protocol/apps/agentsam.host-install.v1.schema.json +1 -1
  109. package/protocol/assets/asset-record.v1.schema.json +1 -1
  110. package/protocol/brand/brandpack.v1.schema.json +1 -1
  111. package/protocol/capabilities/capability-manifest.schema.json +1 -1
  112. package/protocol/capabilities/knowledge-search-input.schema.json +1 -0
  113. package/protocol/credentials/issue.v1.schema.json +1 -1
  114. package/protocol/database/agentsam.schema-pack.v1.schema.json +1 -1
  115. package/protocol/database/connection.v1.schema.json +1 -1
  116. package/protocol/embeddings/embedding-profile.v1.schema.json +1 -1
  117. package/protocol/errors/README.md +36 -0
  118. package/protocol/errors/agentsam.error.v2.schema.json +821 -0
  119. package/protocol/errors/error-catalog.json +3506 -158
  120. package/protocol/errors/error-envelope.schema.json +195 -52
  121. package/protocol/errors/recovery.v1.schema.json +1 -1
  122. package/protocol/features/agentsam.feature.v1.schema.json +1 -1
  123. package/protocol/hooks/README.md +18 -0
  124. package/protocol/hooks/agentsam.hook.output.v1.schema.json +27 -0
  125. package/protocol/hooks/agentsam.hook.receipt.v1.schema.json +61 -0
  126. package/protocol/hooks/agentsam.hook.v1.schema.json +35 -0
  127. package/protocol/hooks/agentsam.hooks.config.v1.schema.json +78 -0
  128. package/protocol/local-engine/benchmark.v1.schema.json +1 -1
  129. package/protocol/local-engine/engine.v1.schema.json +1 -1
  130. package/protocol/models/model-inventory-v2.schema.json +1 -1
  131. package/protocol/models/provider-model-snapshot.v1.schema.json +22 -0
  132. package/protocol/rpc/v1/errors.proto +1 -0
  133. package/protocol/runtime/agentsam.runtime.v1.schema.json +1 -1
  134. package/protocol/runtime/workspace-fs.v1.schema.json +1 -1
  135. package/protocol/sam/activity.v1.schema.json +1 -1
  136. package/protocol/sam/answer.v1.schema.json +1 -1
  137. package/protocol/sam/calibration.v1.schema.json +1 -1
  138. package/protocol/sam/decision-receipt.v1.schema.json +1 -1
  139. package/protocol/sam/evaluation.v1.schema.json +1 -1
  140. package/protocol/sam/operation.schema.json +1 -1
  141. package/protocol/sam/outcome.v1.schema.json +1 -1
  142. package/protocol/sam/question.v1.schema.json +1 -1
  143. package/protocol/sam/result.schema.json +1 -1
  144. package/protocol/sam/state.v1.schema.json +1 -1
  145. package/protocol/scoring/scorecard.v1.schema.json +1 -1
  146. package/protocol/skills/agentsam.interaction.v1.schema.json +1 -1
  147. package/protocol/skills/agentsam.skill.v1.schema.json +1 -1
  148. package/protocol/theme-refinery/product-metadata.schema.json +1 -1
  149. package/protocol/theme-refinery/reconciliation-receipt.schema.json +1 -1
  150. package/protocol/ui/icon.v1.schema.json +1 -1
  151. package/python/README.md +20 -0
  152. package/python/agentsam_sdk/errors/__init__.py +4 -0
  153. package/python/agentsam_sdk/errors/vocabulary.py +2730 -0
  154. package/python/agentsam_sdk/hooks/__init__.py +32 -0
  155. package/python/agentsam_sdk/hooks/adapters.py +132 -0
  156. package/python/agentsam_sdk/hooks/contracts.py +121 -0
  157. package/python/agentsam_sdk/hooks/runtime.py +253 -0
  158. package/python/tests/test_hooks.py +115 -0
  159. package/src/agent/responses-runner.js +145 -1
  160. package/src/cli/command-catalog.js +1 -0
  161. package/src/cli.js +9 -0
  162. package/src/commands/cheat-sheet.js +1 -0
  163. package/src/commands/hooks.js +260 -0
  164. package/src/commands/models.js +1 -1
  165. package/src/commands/shell.js +114 -9
  166. package/src/errors/diagnostic.js +9 -9
  167. package/src/index.js +32 -0
  168. package/src/knowledge/service/grpc-codec.js +2 -0
  169. package/src/lib/slash-commands.js +1 -0
  170. package/src/local/runtime-store.js +46 -0
  171. package/src/models/catalog.js +0 -49
  172. package/src/models/inventory-core.js +69 -0
  173. package/src/plugins/index.js +8 -1
  174. package/src/plugins/registry.js +56 -0
  175. package/src/rpc/generated/errors_pb.js +49 -1
  176. package/src/tools/runtime.js +13 -5
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/agentsam-workbench",
3
- "version": "2.6.9",
3
+ "version": "2.6.10",
4
4
  "description": "Reusable AgentSam workbench primitives for agent threads, composer, browser, terminal and resizable work surfaces.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -39,13 +39,13 @@
39
39
  "./project-control.css": "./dist/project-control.css"
40
40
  },
41
41
  "scripts": {
42
- "typecheck": "tsc --noEmit -p tsconfig.json",
42
+ "typecheck": "node scripts/ensure-local-deps.mjs && tsc --noEmit -p tsconfig.json",
43
43
  "test": "node --test test/*.test.mjs",
44
44
  "build": "node scripts/build.mjs",
45
45
  "prepack": "npm run build"
46
46
  },
47
47
  "dependencies": {
48
- "@inneranimalmedia/agentsam-contracts": "2.6.9"
48
+ "@inneranimalmedia/agentsam-contracts": "2.6.10"
49
49
  },
50
50
  "peerDependencies": {
51
51
  "react": ">=18",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/agentsam-connector-cloudflare",
3
- "version": "2.6.9",
3
+ "version": "2.6.10",
4
4
  "type": "module",
5
5
  "main": "./src/index.js",
6
6
  "exports": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-heuristic",
3
- "version": "2.6.9",
3
+ "version": "2.6.10",
4
4
  "description": "Stock AgentSam CMS storefront shell theme contract (heuristic-theme).",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/agentsam-identity",
3
- "version": "2.6.9",
3
+ "version": "2.6.10",
4
4
  "type": "module",
5
- "description": "Identity module for @inneranimalmedia/agentsam-sdk (workspace \u2014 publish via root SDK)",
5
+ "description": "Identity module for @inneranimalmedia/agentsam-sdk (workspace — publish via root SDK)",
6
6
  "agentsam": {
7
7
  "system": "identity",
8
8
  "kind": "library",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/agentsam-provider-completeful",
3
- "version": "2.6.9",
3
+ "version": "2.6.10",
4
4
  "private": false,
5
5
  "description": "Portable Completeful provider adapter and AgentSam tool definitions.",
6
6
  "type": "module",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-cypress",
3
- "version": "2.6.9",
4
- "description": "Real New Iberia Church of Christ public pages \u2014 visit, groups, mission, and giving.",
3
+ "version": "2.6.10",
4
+ "description": "Real New Iberia Church of Christ public pages — visit, groups, mission, and giving.",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
7
7
  "exports": {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-violet",
3
- "version": "2.6.9",
4
- "description": "Real Companions of Caddo public static surface \u2014 mission, campaigns, and involvement paths.",
3
+ "version": "2.6.10",
4
+ "description": "Real Companions of Caddo public static surface — mission, campaigns, and involvement paths.",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
7
7
  "exports": {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-grove",
3
- "version": "2.6.9",
4
- "description": "Real Anything Floors & More public site \u2014 services, gallery, process, and contact.",
3
+ "version": "2.6.10",
4
+ "description": "Real Anything Floors & More public site — services, gallery, process, and contact.",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
7
7
  "exports": {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-ember",
3
- "version": "2.6.9",
4
- "description": "Real Fuel & Free Time legacy storefront pages \u2014 home, shop, about, and community.",
3
+ "version": "2.6.10",
4
+ "description": "Real Fuel & Free Time legacy storefront pages — home, shop, about, and community.",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
7
7
  "exports": {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-forge",
3
- "version": "2.6.9",
4
- "description": "Real Primeaux Handyman PWA build \u2014 mobile-first service site with estimates and project proof.",
3
+ "version": "2.6.10",
4
+ "description": "Real Primeaux Handyman PWA build — mobile-first service site with estimates and project proof.",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
7
7
  "exports": {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-harbor",
3
- "version": "2.6.9",
4
- "description": "Real Chrystal Clear Insurance build \u2014 editorial insurance storefront with coverage storytelling and quote capture.",
3
+ "version": "2.6.10",
4
+ "description": "Real Chrystal Clear Insurance build — editorial insurance storefront with coverage storytelling and quote capture.",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
7
7
  "exports": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-scenes",
3
- "version": "2.6.9",
3
+ "version": "2.6.10",
4
4
  "description": "Reusable scene / shell / block vocabulary for branded website experiences. BrandPack owns look; theme-scenes owns composition.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-summit",
3
- "version": "2.6.9",
4
- "description": "Real Shinshu Solutions static archive \u2014 services, gallery, and CMS-ready pages.",
3
+ "version": "2.6.10",
4
+ "description": "Real Shinshu Solutions static archive — services, gallery, and CMS-ready pages.",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
7
7
  "exports": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/agentsam-work-graph",
3
- "version": "2.6.9",
3
+ "version": "2.6.10",
4
4
  "description": "Core AgentSam work-graph primitive: one graph model (WorkItem, Dependency, TimelineEvent, Artifact, Evidence, Actor) powering an engineering adapter (git/MCP/tests/deploys) and a business adapter (projects/clients/approvals/milestones), with Gantt/timeline rendering as a pure projection over the graph rather than its own source of truth.",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://agentsam.inneranimalmedia.com/protocol/apps/agentsam.app.v1.schema.json",
3
+ "$id": "https://schemas.inneranimalmedia.com/agentsam/apps/agentsam.app.v1.schema.json",
4
4
  "title": "agentsam.app.v1",
5
5
  "description": "Installable AgentSam product APP. Canonical identity is id (kebab-case). Package, Worker, route, desktop, and service names live in other namespaces.",
6
6
  "type": "object",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://agentsam.inneranimalmedia.com/protocol/apps/agentsam.host-install.v1.schema.json",
3
+ "$id": "https://schemas.inneranimalmedia.com/agentsam/apps/agentsam.host-install.v1.schema.json",
4
4
  "title": "agentsam.host-install.v1",
5
5
  "description": "Host/installation state for an AgentSam APP. Lives under .agentsam/app.json. References APP.id; must not redefine product identity (enforced by agentsam app validate).",
6
6
  "type": "object",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://agentsam.inneranimalmedia.com/protocol/assets/asset-record.v1.schema.json",
3
+ "$id": "https://schemas.inneranimalmedia.com/agentsam/assets/asset-record.v1.schema.json",
4
4
  "title": "AgentSamAssetRecord",
5
5
  "description": "Shared Asset Core — canonical ast_* identity. BrandPack and Content are peer domains over this record. Providers hold representations only.",
6
6
  "type": "object",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://agentsam.inneranimalmedia.com/protocol/brand/brandpack.v1.schema.json",
3
+ "$id": "https://schemas.inneranimalmedia.com/agentsam/brand/brandpack.v1.schema.json",
4
4
  "title": "AgentSamBrandPack",
5
5
  "type": "object",
6
6
  "required": ["schema", "id"],
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://schemas.inneranimalmedia.com/agentsam/capabilities/manifest.schema.json",
3
+ "$id": "https://schemas.inneranimalmedia.com/agentsam/capabilities/capability-manifest.schema.json",
4
4
  "title": "AgentSam capability manifest",
5
5
  "type": "object",
6
6
  "additionalProperties": false,
@@ -1,5 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.inneranimalmedia.com/agentsam/capabilities/knowledge-search-input.schema.json",
3
4
  "type": "object",
4
5
  "additionalProperties": false,
5
6
  "required": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://agentsam.inneranimalmedia.com/protocol/credentials/issue.v1.schema.json",
3
+ "$id": "https://schemas.inneranimalmedia.com/agentsam/credentials/issue.v1.schema.json",
4
4
  "title": "credentials.issue",
5
5
  "description": "Mint an AgentSam API credential (aak_*). Host stores hash only; secret returned once.",
6
6
  "type": "object",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://agentsam.dev/protocol/database/agentsam.schema-pack.v1.schema.json",
3
+ "$id": "https://schemas.inneranimalmedia.com/agentsam/database/agentsam.schema-pack.v1.schema.json",
4
4
  "title": "AgentSam schema pack family manifest",
5
5
  "description": "Generic reusable contract for product schema packs (Identity, CMS, CAD, …). Packs own their manifests; this schema is protocol authority.",
6
6
  "type": "object",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "agentsam.database-connection.v1",
3
+ "$id": "https://schemas.inneranimalmedia.com/agentsam/database/connection.v1.schema.json",
4
4
  "title": "AgentSamDatabaseConnection",
5
5
  "type": "object",
6
6
  "required": ["id", "engine", "provider", "connection"],
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "agentsam.embedding-profile.v1",
3
+ "$id": "https://schemas.inneranimalmedia.com/agentsam/embeddings/embedding-profile.v1.schema.json",
4
4
  "title": "AgentSamEmbeddingProfile",
5
5
  "type": "object",
6
6
  "required": ["schema", "id", "provider", "dimensions", "revision", "fingerprint"],
@@ -0,0 +1,36 @@
1
+ # AgentSam error protocol
2
+
3
+ `error-catalog.json` is the sole authority for the AgentSam failure vocabulary. Run `npm run errors:generate` after changing it; `npm run errors:check` rejects stale JavaScript, TypeScript, Go, Rust, Python, or JSON Schema projections.
4
+
5
+ ## Layering law
6
+
7
+ Canonical `code` values are the small, stable gRPC-style transport status set. Product detail belongs in orthogonal dimensions:
8
+
9
+ - `reason`: precise machine cause, including adapter-specific causes such as `hook_http_timeout`, `hook_mcp_timeout`, and `hook_lsp_timeout`;
10
+ - `domain` and `failure_class`: ownership and category;
11
+ - `stage` plus optional `native_stage`: portable operation phase and subsystem evidence;
12
+ - `feature`: open, syntax-validated dotted capability ID;
13
+ - `adapter`, `protocol`, and `transport`: distinct delivery layers;
14
+ - `failure_behavior`, `retryable`, and `side_effect_state`: what policy did and whether replay is safe;
15
+ - source, owner, remediation, redacted native evidence, and fingerprint.
16
+
17
+ For example, HTTP, MCP, LSP, and command hook timeouts all use `DEADLINE_EXCEEDED` while retaining different reasons and adapter/protocol/transport facts. Do not add combination codes such as `HOOK_MCP_TIMEOUT_CODE`.
18
+
19
+ Legacy native strings live only as aliases on canonical reasons. Normalizers retain the native value as redacted evidence while emitting the canonical reason. Aliases are a migration bridge, not a second taxonomy.
20
+
21
+ ## Generated outputs
22
+
23
+ The generator currently owns:
24
+
25
+ - `packages/agentsam-errors/src/vocabulary.js`
26
+ - `packages/agentsam-errors/types/index.d.ts`
27
+ - `packages/agentsam-errors/protocol/{error-catalog.json,agentsam.error.v2.schema.json}` for standalone npm artifacts
28
+ - `packages/agentsam-contracts/src/errors.ts`
29
+ - `protocol/errors/agentsam.error.v2.schema.json`
30
+ - `protocol/errors/error-envelope.schema.json` (stable compatibility export)
31
+ - `packages/agentsam-hooks/src/errors-generated.js`
32
+ - `packages/agentsam-hooks/bindings/go/errors_generated.go`
33
+ - `packages/agentsam-hooks/bindings/rust/src/errors_generated.rs`
34
+ - `python/agentsam_sdk/errors/vocabulary.py`
35
+
36
+ Feature IDs are intentionally not a compiled enum. Their dotted syntax is stable while installed apps and tools may introduce new IDs.