@inneranimalmedia/agentsam-sdk 2.6.8 → 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 (203) hide show
  1. package/README.md +18 -0
  2. package/apps/README.md +25 -0
  3. package/apps/cad-creator/shared/cad/package.json +1 -1
  4. package/apps/client-cms-editor/backend/package.json +5 -7
  5. package/apps/client-cms-editor/frontend/package.json +5 -7
  6. package/apps/client-cms-editor/frontend/tsconfig.json +27 -8
  7. package/apps/client-cms-editor/package-lock.json +8 -8
  8. package/apps/client-cms-editor/package.json +1 -1
  9. package/apps/client-cms-editor/shared/cms/package.json +3 -5
  10. package/docs/LOCAL_ENGINE_COMPUTE_AUDIT_PLAN.md +299 -0
  11. package/docs/architecture/HOOKS-MODELS-SELF-HOSTING-PLAN.md +199 -0
  12. package/examples/hyperspace-demo/index.html +16 -0
  13. package/examples/hyperspace-demo/package.json +21 -0
  14. package/examples/hyperspace-demo/src/main.tsx +160 -0
  15. package/examples/hyperspace-demo/tsconfig.json +9 -0
  16. package/examples/hyperspace-demo/vite.config.ts +24 -0
  17. package/migrations/runtime/0005_agentsam_hooks.sql +87 -0
  18. package/package.json +37 -10
  19. package/packages/agentsam-brand/package.json +1 -1
  20. package/packages/agentsam-brand/src/core/v2/compile.js +1 -1
  21. package/packages/agentsam-brand/src/core/v2/schema.js +1 -1
  22. package/packages/agentsam-contracts/package.json +71 -20
  23. package/packages/agentsam-contracts/scripts/build.mjs +18 -0
  24. package/packages/agentsam-contracts/src/errors.ts +19 -10
  25. package/packages/agentsam-contracts/test/contracts.test.mjs +4 -1
  26. package/packages/agentsam-contracts/test/repository.test.mjs +4 -1
  27. package/packages/agentsam-contracts/tsconfig.build.json +10 -0
  28. package/packages/agentsam-errors/package.json +13 -4
  29. package/packages/agentsam-errors/protocol/agentsam.error.v2.schema.json +821 -0
  30. package/packages/agentsam-errors/protocol/error-catalog.json +3512 -0
  31. package/packages/agentsam-errors/src/envelope.js +63 -11
  32. package/packages/agentsam-errors/src/error.js +6 -0
  33. package/packages/agentsam-errors/src/fingerprint.js +9 -1
  34. package/packages/agentsam-errors/src/normalize.js +51 -6
  35. package/packages/agentsam-errors/src/recovery.js +9 -35
  36. package/packages/agentsam-errors/src/transport.js +6 -1
  37. package/packages/agentsam-errors/src/vocabulary.js +515 -126
  38. package/packages/agentsam-errors/test/catalog-v2.test.mjs +106 -0
  39. package/packages/agentsam-errors/types/index.d.ts +157 -0
  40. package/packages/agentsam-goap/package.json +2 -2
  41. package/packages/agentsam-hooks/README.md +206 -0
  42. package/packages/agentsam-hooks/bin/agentsam-hooks.mjs +64 -0
  43. package/packages/agentsam-hooks/bindings/go/command.go +55 -0
  44. package/packages/agentsam-hooks/bindings/go/errors_generated.go +402 -0
  45. package/packages/agentsam-hooks/bindings/go/go.mod +3 -0
  46. package/packages/agentsam-hooks/bindings/go/hooks.go +285 -0
  47. package/packages/agentsam-hooks/bindings/go/hooks_test.go +48 -0
  48. package/packages/agentsam-hooks/bindings/rust/Cargo.toml +11 -0
  49. package/packages/agentsam-hooks/bindings/rust/src/errors_generated.rs +396 -0
  50. package/packages/agentsam-hooks/bindings/rust/src/lib.rs +397 -0
  51. package/packages/agentsam-hooks/package.json +69 -0
  52. package/packages/agentsam-hooks/schema/manifest.json +54 -0
  53. package/packages/agentsam-hooks/scripts/clean-protocol.mjs +17 -0
  54. package/packages/agentsam-hooks/scripts/sync-protocol.mjs +27 -0
  55. package/packages/agentsam-hooks/src/adapters/agents.js +82 -0
  56. package/packages/agentsam-hooks/src/adapters/callback.js +4 -0
  57. package/packages/agentsam-hooks/src/adapters/capability.js +122 -0
  58. package/packages/agentsam-hooks/src/adapters/command.js +104 -0
  59. package/packages/agentsam-hooks/src/adapters/composite.js +31 -0
  60. package/packages/agentsam-hooks/src/adapters/http.js +58 -0
  61. package/packages/agentsam-hooks/src/adapters/lsp.js +116 -0
  62. package/packages/agentsam-hooks/src/adapters/mcp.js +76 -0
  63. package/packages/agentsam-hooks/src/adapters/provider.js +129 -0
  64. package/packages/agentsam-hooks/src/config.js +143 -0
  65. package/packages/agentsam-hooks/src/contracts.js +284 -0
  66. package/packages/agentsam-hooks/src/errors-generated.js +2732 -0
  67. package/packages/agentsam-hooks/src/index.d.ts +193 -0
  68. package/packages/agentsam-hooks/src/index.js +14 -0
  69. package/packages/agentsam-hooks/src/policy.js +34 -0
  70. package/packages/agentsam-hooks/src/runtime.js +312 -0
  71. package/packages/agentsam-hooks/src/store.js +264 -0
  72. package/packages/agentsam-hooks/test/adapters.test.mjs +216 -0
  73. package/packages/agentsam-hooks/test/runtime.test.mjs +258 -0
  74. package/packages/agentsam-knowledge/package.json +3 -2
  75. package/packages/agentsam-nav/package.json +1 -1
  76. package/packages/agentsam-queue-control/package.json +1 -1
  77. package/packages/agentsam-rapid-rust/src/main.rs +1 -0
  78. package/packages/agentsam-repository/package.json +3 -2
  79. package/packages/agentsam-vault/package.json +8 -5
  80. package/packages/agentsam-workbench/package.json +45 -18
  81. package/packages/connectors/cloudflare/package.json +1 -1
  82. package/packages/heuristic-theme/package.json +1 -1
  83. package/packages/identity/package.json +3 -2
  84. package/packages/identity/tests/lane1-packed-consumer.test.mjs +9 -1
  85. package/packages/providers/completeful/package.json +1 -1
  86. package/packages/theme-church-site/README.md +2 -2
  87. package/packages/theme-church-site/package.json +2 -3
  88. package/packages/theme-church-site/src/index.js +1 -1
  89. package/packages/theme-church-site/test/theme.test.mjs +1 -1
  90. package/packages/theme-companions-site/README.md +2 -2
  91. package/packages/theme-companions-site/package.json +2 -3
  92. package/packages/theme-companions-site/src/index.js +1 -1
  93. package/packages/theme-companions-site/test/theme.test.mjs +1 -1
  94. package/packages/theme-floors-site/README.md +2 -2
  95. package/packages/theme-floors-site/package.json +2 -3
  96. package/packages/theme-floors-site/src/index.js +1 -1
  97. package/packages/theme-floors-site/test/theme.test.mjs +1 -1
  98. package/packages/theme-fuelnfree-site/README.md +2 -2
  99. package/packages/theme-fuelnfree-site/package.json +2 -3
  100. package/packages/theme-fuelnfree-site/src/index.js +1 -1
  101. package/packages/theme-fuelnfree-site/test/theme.test.mjs +1 -1
  102. package/packages/theme-handyman-site/README.md +2 -2
  103. package/packages/theme-handyman-site/package.json +2 -3
  104. package/packages/theme-handyman-site/src/index.js +1 -1
  105. package/packages/theme-handyman-site/test/theme.test.mjs +1 -1
  106. package/packages/theme-insurance-site/README.md +2 -2
  107. package/packages/theme-insurance-site/package.json +2 -3
  108. package/packages/theme-insurance-site/src/index.js +1 -1
  109. package/packages/theme-insurance-site/test/theme.test.mjs +1 -1
  110. package/packages/theme-scenes/package.json +1 -1
  111. package/packages/theme-shinshu-site/README.md +2 -2
  112. package/packages/theme-shinshu-site/package.json +2 -3
  113. package/packages/theme-shinshu-site/src/index.js +1 -1
  114. package/packages/theme-shinshu-site/test/theme.test.mjs +1 -1
  115. package/packages/work-graph/package.json +3 -2
  116. package/protocol/apps/agentsam.app.v1.schema.json +1 -1
  117. package/protocol/apps/agentsam.host-install.v1.schema.json +1 -1
  118. package/protocol/assets/asset-record.v1.schema.json +1 -1
  119. package/protocol/brand/brandpack.v1.schema.json +1 -1
  120. package/protocol/capabilities/capability-manifest.schema.json +1 -1
  121. package/protocol/capabilities/knowledge-search-input.schema.json +1 -0
  122. package/protocol/credentials/issue.v1.schema.json +1 -1
  123. package/protocol/database/agentsam.schema-pack.v1.schema.json +1 -1
  124. package/protocol/database/connection.v1.schema.json +1 -1
  125. package/protocol/embeddings/embedding-profile.v1.schema.json +1 -1
  126. package/protocol/errors/README.md +36 -0
  127. package/protocol/errors/agentsam.error.v2.schema.json +821 -0
  128. package/protocol/errors/error-catalog.json +3506 -158
  129. package/protocol/errors/error-envelope.schema.json +195 -52
  130. package/protocol/errors/recovery.v1.schema.json +1 -1
  131. package/protocol/features/agentsam.feature.v1.schema.json +1 -1
  132. package/protocol/hooks/README.md +18 -0
  133. package/protocol/hooks/agentsam.hook.output.v1.schema.json +27 -0
  134. package/protocol/hooks/agentsam.hook.receipt.v1.schema.json +61 -0
  135. package/protocol/hooks/agentsam.hook.v1.schema.json +35 -0
  136. package/protocol/hooks/agentsam.hooks.config.v1.schema.json +78 -0
  137. package/protocol/local-engine/benchmark.v1.schema.json +14 -0
  138. package/protocol/local-engine/engine.v1.schema.json +17 -0
  139. package/protocol/models/model-inventory-v2.schema.json +1 -1
  140. package/protocol/models/provider-model-snapshot.v1.schema.json +22 -0
  141. package/protocol/rpc/v1/errors.proto +1 -0
  142. package/protocol/runtime/agentsam.runtime.v1.schema.json +1 -1
  143. package/protocol/runtime/workspace-fs.v1.schema.json +1 -1
  144. package/protocol/sam/activity.v1.schema.json +1 -1
  145. package/protocol/sam/answer.v1.schema.json +1 -1
  146. package/protocol/sam/calibration.v1.schema.json +1 -1
  147. package/protocol/sam/decision-receipt.v1.schema.json +1 -1
  148. package/protocol/sam/evaluation.v1.schema.json +1 -1
  149. package/protocol/sam/operation.schema.json +1 -1
  150. package/protocol/sam/outcome.v1.schema.json +1 -1
  151. package/protocol/sam/question.v1.schema.json +1 -1
  152. package/protocol/sam/result.schema.json +1 -1
  153. package/protocol/sam/state.v1.schema.json +1 -1
  154. package/protocol/scoring/scorecard.v1.schema.json +1 -1
  155. package/protocol/skills/agentsam.interaction.v1.schema.json +1 -1
  156. package/protocol/skills/agentsam.skill.v1.schema.json +1 -1
  157. package/protocol/theme-refinery/product-metadata.schema.json +1 -1
  158. package/protocol/theme-refinery/reconciliation-receipt.schema.json +1 -1
  159. package/protocol/ui/icon.v1.schema.json +1 -1
  160. package/python/README.md +20 -0
  161. package/python/agentsam_sdk/errors/__init__.py +4 -0
  162. package/python/agentsam_sdk/errors/vocabulary.py +2730 -0
  163. package/python/agentsam_sdk/hooks/__init__.py +32 -0
  164. package/python/agentsam_sdk/hooks/adapters.py +132 -0
  165. package/python/agentsam_sdk/hooks/contracts.py +121 -0
  166. package/python/agentsam_sdk/hooks/runtime.py +253 -0
  167. package/python/tests/test_hooks.py +115 -0
  168. package/src/agent/responses-runner.js +145 -1
  169. package/src/cli/command-catalog.js +2 -0
  170. package/src/cli.js +19 -0
  171. package/src/commands/app.js +10 -0
  172. package/src/commands/cheat-sheet.js +1 -0
  173. package/src/commands/engine.js +10 -0
  174. package/src/commands/hooks.js +260 -0
  175. package/src/commands/machine.js +71 -38
  176. package/src/commands/models.js +1 -1
  177. package/src/commands/package.js +10 -3
  178. package/src/commands/runtime.js +25 -10
  179. package/src/commands/setup.js +30 -6
  180. package/src/commands/shell.js +114 -9
  181. package/src/commands/terminal.js +20 -8
  182. package/src/errors/contract.js +4 -4
  183. package/src/errors/diagnostic.js +10 -10
  184. package/src/errors/index.js +1 -1
  185. package/src/index.js +52 -0
  186. package/src/indexing/ingest/materials.js +237 -30
  187. package/src/knowledge/service/grpc-codec.js +2 -0
  188. package/src/lib/setup/runtime.js +4 -2
  189. package/src/lib/slash-commands.js +1 -0
  190. package/src/local/runtime-store.js +46 -0
  191. package/src/local-engine/assets.js +37 -0
  192. package/src/local-engine/audit.js +133 -0
  193. package/src/local-engine/benchmark.js +26 -0
  194. package/src/local-engine/contracts.js +101 -0
  195. package/src/local-engine/engines.js +142 -0
  196. package/src/local-engine/index.js +18 -0
  197. package/src/local-engine/runtime.js +39 -0
  198. package/src/models/catalog.js +0 -49
  199. package/src/models/inventory-core.js +69 -0
  200. package/src/plugins/index.js +8 -1
  201. package/src/plugins/registry.js +56 -0
  202. package/src/rpc/generated/errors_pb.js +49 -1
  203. package/src/tools/runtime.js +13 -5
@@ -8,7 +8,7 @@ test('floors-site theme package exports harvested (not installable) contract', (
8
8
  assert.equal(theme.installable, false);
9
9
  assert.equal(theme.lineage, "afm");
10
10
  assert.equal(theme.family, "service-gallery");
11
- assert.equal(theme.package, "@inneranimalmedia/theme-floors-site");
11
+ assert.equal(theme.package, "@inneranimalmedia/theme-grove");
12
12
  assert.ok(Array.isArray(theme.pages));
13
13
  });
14
14
 
@@ -1,10 +1,10 @@
1
- # @inneranimalmedia/theme-fuelnfree-site
1
+ # @inneranimalmedia/theme-ember
2
2
 
3
3
  Installable AgentSam theme: **Fuel & Free Time**.
4
4
 
5
5
  Gallery preview source: `apps/theme-gallery-preview/themes/fuelnfree-site`.
6
6
 
7
7
  ```js
8
- import { createTheme } from "@inneranimalmedia/theme-fuelnfree-site";
8
+ import { createTheme } from "@inneranimalmedia/theme-ember";
9
9
  const theme = createTheme();
10
10
  ```
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-ember",
3
- "version": "2.6.7",
3
+ "version": "2.6.10",
4
4
  "description": "Real Fuel & Free Time legacy storefront pages — home, shop, about, and community.",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
@@ -37,6 +37,5 @@
37
37
  "type": "git",
38
38
  "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
39
39
  "directory": "packages/theme-fuelnfree-site"
40
- },
41
- "private": true
40
+ }
42
41
  }
@@ -8,7 +8,7 @@ const THEME = {
8
8
  "version": "0.1.0",
9
9
  "kind": "gallery-theme",
10
10
  "icon": "theme",
11
- "package": "@inneranimalmedia/theme-fuelnfree-site",
11
+ "package": "@inneranimalmedia/theme-ember",
12
12
  "category": "Commerce",
13
13
  "industries": [
14
14
  "Retail",
@@ -8,7 +8,7 @@ test('fuelnfree-site theme package exports harvested (not installable) contract'
8
8
  assert.equal(theme.installable, false);
9
9
  assert.equal(theme.lineage, "fnf");
10
10
  assert.equal(theme.family, "editorial-commerce");
11
- assert.equal(theme.package, "@inneranimalmedia/theme-fuelnfree-site");
11
+ assert.equal(theme.package, "@inneranimalmedia/theme-ember");
12
12
  assert.ok(Array.isArray(theme.pages));
13
13
  });
14
14
 
@@ -1,10 +1,10 @@
1
- # @inneranimalmedia/theme-handyman-site
1
+ # @inneranimalmedia/theme-forge
2
2
 
3
3
  Installable AgentSam theme: **Primeaux Handyman Services**.
4
4
 
5
5
  Gallery preview source: `apps/theme-gallery-preview/themes/handyman-site`.
6
6
 
7
7
  ```js
8
- import { createTheme } from "@inneranimalmedia/theme-handyman-site";
8
+ import { createTheme } from "@inneranimalmedia/theme-forge";
9
9
  const theme = createTheme();
10
10
  ```
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-forge",
3
- "version": "2.6.7",
3
+ "version": "2.6.10",
4
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",
@@ -37,6 +37,5 @@
37
37
  "type": "git",
38
38
  "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
39
39
  "directory": "packages/theme-handyman-site"
40
- },
41
- "private": true
40
+ }
42
41
  }
@@ -8,7 +8,7 @@ const THEME = {
8
8
  "version": "0.1.0",
9
9
  "kind": "gallery-theme",
10
10
  "icon": "theme",
11
- "package": "@inneranimalmedia/theme-handyman-site",
11
+ "package": "@inneranimalmedia/theme-forge",
12
12
  "category": "Services",
13
13
  "industries": [
14
14
  "Home Services",
@@ -8,7 +8,7 @@ test('handyman-site theme package exports harvested (not installable) contract',
8
8
  assert.equal(theme.installable, false);
9
9
  assert.equal(theme.lineage, "phs");
10
10
  assert.equal(theme.family, "trade-services");
11
- assert.equal(theme.package, "@inneranimalmedia/theme-handyman-site");
11
+ assert.equal(theme.package, "@inneranimalmedia/theme-forge");
12
12
  assert.ok(Array.isArray(theme.pages));
13
13
  });
14
14
 
@@ -1,10 +1,10 @@
1
- # @inneranimalmedia/theme-insurance-site
1
+ # @inneranimalmedia/theme-harbor
2
2
 
3
3
  Installable AgentSam theme: **Chrystal Clear Insurance**.
4
4
 
5
5
  Gallery preview source: `apps/theme-gallery-preview/themes/insurance-site`.
6
6
 
7
7
  ```js
8
- import { createTheme } from "@inneranimalmedia/theme-insurance-site";
8
+ import { createTheme } from "@inneranimalmedia/theme-harbor";
9
9
  const theme = createTheme();
10
10
  ```
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-harbor",
3
- "version": "2.6.7",
3
+ "version": "2.6.10",
4
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",
@@ -37,6 +37,5 @@
37
37
  "type": "git",
38
38
  "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
39
39
  "directory": "packages/theme-insurance-site"
40
- },
41
- "private": true
40
+ }
42
41
  }
@@ -8,7 +8,7 @@ const THEME = {
8
8
  "version": "0.1.0",
9
9
  "kind": "gallery-theme",
10
10
  "icon": "theme",
11
- "package": "@inneranimalmedia/theme-insurance-site",
11
+ "package": "@inneranimalmedia/theme-harbor",
12
12
  "category": "Professional",
13
13
  "industries": [
14
14
  "Insurance",
@@ -8,7 +8,7 @@ test('insurance-site theme package exports harvested (not installable) contract'
8
8
  assert.equal(theme.installable, false);
9
9
  assert.equal(theme.lineage, "cci");
10
10
  assert.equal(theme.family, "professional-leadgen");
11
- assert.equal(theme.package, "@inneranimalmedia/theme-insurance-site");
11
+ assert.equal(theme.package, "@inneranimalmedia/theme-harbor");
12
12
  assert.ok(Array.isArray(theme.pages));
13
13
  });
14
14
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-scenes",
3
- "version": "2.6.7",
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,10 +1,10 @@
1
- # @inneranimalmedia/theme-shinshu-site
1
+ # @inneranimalmedia/theme-summit
2
2
 
3
3
  Installable AgentSam theme: **Shinshu Solutions**.
4
4
 
5
5
  Gallery preview source: `apps/theme-gallery-preview/themes/shinshu-site`.
6
6
 
7
7
  ```js
8
- import { createTheme } from "@inneranimalmedia/theme-shinshu-site";
8
+ import { createTheme } from "@inneranimalmedia/theme-summit";
9
9
  const theme = createTheme();
10
10
  ```
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/theme-summit",
3
- "version": "2.6.7",
3
+ "version": "2.6.10",
4
4
  "description": "Real Shinshu Solutions static archive — services, gallery, and CMS-ready pages.",
5
5
  "type": "module",
6
6
  "main": "./src/index.js",
@@ -37,6 +37,5 @@
37
37
  "type": "git",
38
38
  "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
39
39
  "directory": "packages/theme-shinshu-site"
40
- },
41
- "private": true
40
+ }
42
41
  }
@@ -8,7 +8,7 @@ const THEME = {
8
8
  "version": "0.1.0",
9
9
  "kind": "gallery-theme",
10
10
  "icon": "theme",
11
- "package": "@inneranimalmedia/theme-shinshu-site",
11
+ "package": "@inneranimalmedia/theme-summit",
12
12
  "category": "Professional",
13
13
  "industries": [
14
14
  "Consulting",
@@ -8,7 +8,7 @@ test('shinshu-site theme package exports harvested (not installable) contract',
8
8
  assert.equal(theme.installable, false);
9
9
  assert.equal(theme.lineage, "shin");
10
10
  assert.equal(theme.family, "consulting-portfolio");
11
- assert.equal(theme.package, "@inneranimalmedia/theme-shinshu-site");
11
+ assert.equal(theme.package, "@inneranimalmedia/theme-summit");
12
12
  assert.ok(Array.isArray(theme.pages));
13
13
  });
14
14
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inneranimalmedia/agentsam-work-graph",
3
- "version": "2.6.7",
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",
@@ -25,5 +25,6 @@
25
25
  },
26
26
  "files": [
27
27
  "src"
28
- ]
28
+ ],
29
+ "license": "MIT"
29
30
  }
@@ -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.