@inneranimalmedia/agentsam-sdk 2.6.9 → 2.6.11

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 (392) hide show
  1. package/README.md +21 -0
  2. package/TRADEMARKS.md +22 -0
  3. package/apps/README.md +3 -0
  4. package/apps/cad-creator/LICENSE +21 -0
  5. package/apps/cad-creator/README.md +4 -1
  6. package/apps/cad-creator/shared/cad/package.json +1 -1
  7. package/apps/client-cms-editor/LICENSE +21 -0
  8. package/apps/client-cms-editor/README.md +3 -0
  9. package/apps/client-cms-editor/backend/package.json +3 -3
  10. package/apps/client-cms-editor/frontend/package.json +4 -4
  11. package/apps/client-cms-editor/package-lock.json +43 -43
  12. package/apps/client-cms-editor/package.json +3 -3
  13. package/apps/client-cms-editor/reference/harvest/HARVEST_RECEIPT.json +1 -1
  14. package/apps/client-cms-editor/reference/harvest/README.md +1 -1
  15. package/apps/client-cms-editor/reference/harvest/plans/ARCHIVE-INTAKE.md +1 -1
  16. package/apps/client-cms-editor/reference/harvest/plans/HARVEST-INDEX.md +1 -1
  17. package/apps/client-cms-editor/reference/harvest/plans/TOOLING-LAB.md +1 -1
  18. package/apps/client-cms-editor/shared/cms/package.json +2 -2
  19. package/docs/MINI.md +4 -2
  20. package/docs/REPO_FILE_MAP.txt +0 -1
  21. package/docs/SOURCE_ARCHITECTURE.md +1 -1
  22. package/docs/architecture/DUAL_ANALYTICS_PRODUCT.md +140 -0
  23. package/docs/architecture/HOOKS-MODELS-SELF-HOSTING-PLAN.md +199 -0
  24. package/docs/content-studio/REVISION_GATE_2026-09-27.md +1 -1
  25. package/docs/engineering/go-portability/01-product-project-deployment-authority.md +69 -0
  26. package/docs/engineering/provider-internal-renames/01-lane-initialization.md +20 -0
  27. package/docs/engineering/provider-internal-renames/01a-runtime-environment-contract.md +115 -0
  28. package/docs/engineering/provider-internal-renames/02-cfoa.md +57 -0
  29. package/docs/engineering/provider-internal-renames/03-gclioa.md +32 -0
  30. package/docs/engineering/provider-internal-renames/04-goaude.md +50 -0
  31. package/docs/engineering/provider-internal-renames/05-gdrv.md +33 -0
  32. package/docs/engineering/provider-internal-renames/06-verification.md +103 -0
  33. package/docs/engineering/provider-internal-renames/README.md +77 -0
  34. package/docs/engineering/provider-internal-renames/runtime-environment-contract.json +220 -0
  35. package/docs/engineering/test-diagnostics/go-cli-test-hang-20261003.md +49 -0
  36. package/docs/engineering/test-diagnostics/go-skip-deploy-docker-fix.md +90 -0
  37. package/docs/knowledge-service-verification.md +3 -3
  38. package/docs/plans/AGENTSAM-SUSPEND-QUEUE-KNOWLEDGE-RDP-2026-10-03.md +870 -0
  39. package/docs/plans/LOCAL-STUDIO-GRADUATION-2026-09-26.md +9 -9
  40. package/docs/plans/MACHINE-FIRST-APPS-TUI-2026-09-24.md +11 -11
  41. package/docs/plans/RECONCILIATION-2026-09-19.md +6 -6
  42. package/docs/plans/SAM_WORK_PROTOCOL.md +667 -0
  43. package/docs/plans/TOMORROW-EXTENSIVE-TODO-2026-09-26.md +2 -2
  44. package/docs/plans/UNIVERSAL-INGEST-MACHINE-FIRST-2026-09-24.md +3 -3
  45. package/examples/hyperspace-demo/index.html +16 -0
  46. package/examples/hyperspace-demo/package.json +21 -0
  47. package/examples/hyperspace-demo/src/main.tsx +277 -0
  48. package/examples/hyperspace-demo/tsconfig.json +9 -0
  49. package/examples/hyperspace-demo/vite.config.ts +24 -0
  50. package/migrations/d1/0020_agentsam_receipt_catalog.sql +35 -0
  51. package/migrations/runtime/0005_agentsam_hooks.sql +87 -0
  52. package/migrations/runtime/0006_agent_run_suspend_activity.sql +53 -0
  53. package/migrations/runtime/0007_queue_control.sql +40 -0
  54. package/migrations/runtime/0008_agent_run_dependencies.sql +24 -0
  55. package/migrations/runtime/0008_analytics_legacy_bootstrap.sql +43 -0
  56. package/migrations/runtime/0009_analytics_authority.sql +108 -0
  57. package/package.json +45 -14
  58. package/packages/agentsam-brand/README.md +3 -0
  59. package/packages/agentsam-brand/package.json +2 -2
  60. package/packages/agentsam-brand/src/core/v2/compile.js +1 -1
  61. package/packages/agentsam-brand/src/core/v2/schema.js +1 -1
  62. package/packages/agentsam-contracts/dist/adapter.d.ts +22 -0
  63. package/packages/agentsam-contracts/dist/adapter.js +0 -0
  64. package/packages/agentsam-contracts/dist/agent.d.ts +66 -0
  65. package/packages/agentsam-contracts/dist/agent.js +15 -0
  66. package/packages/agentsam-contracts/dist/artifacts.d.ts +70 -0
  67. package/packages/agentsam-contracts/dist/artifacts.js +0 -0
  68. package/packages/agentsam-contracts/dist/authority.d.ts +21 -0
  69. package/packages/agentsam-contracts/dist/authority.js +0 -0
  70. package/packages/agentsam-contracts/dist/context.d.ts +14 -0
  71. package/packages/agentsam-contracts/dist/context.js +0 -0
  72. package/packages/agentsam-contracts/dist/errors.d.ts +121 -0
  73. package/packages/agentsam-contracts/dist/errors.js +5 -0
  74. package/packages/agentsam-contracts/dist/events.d.ts +53 -0
  75. package/packages/agentsam-contracts/dist/events.js +0 -0
  76. package/packages/agentsam-contracts/dist/execution.d.ts +38 -0
  77. package/packages/agentsam-contracts/dist/execution.js +0 -0
  78. package/packages/agentsam-contracts/dist/hooks.d.ts +31 -0
  79. package/packages/agentsam-contracts/dist/hooks.js +0 -0
  80. package/packages/agentsam-contracts/dist/identity.d.ts +15 -0
  81. package/packages/agentsam-contracts/dist/identity.js +0 -0
  82. package/packages/agentsam-contracts/dist/index.d.ts +16 -0
  83. package/packages/agentsam-contracts/dist/index.js +164 -0
  84. package/packages/agentsam-contracts/dist/models.d.ts +9 -0
  85. package/packages/agentsam-contracts/dist/models.js +0 -0
  86. package/packages/agentsam-contracts/dist/providers.d.ts +27 -0
  87. package/packages/agentsam-contracts/dist/providers.js +0 -0
  88. package/packages/agentsam-contracts/dist/repository.d.ts +56 -0
  89. package/packages/agentsam-contracts/dist/repository.js +15 -0
  90. package/packages/agentsam-contracts/dist/run.d.ts +113 -0
  91. package/packages/agentsam-contracts/dist/run.js +132 -0
  92. package/packages/agentsam-contracts/dist/tools.d.ts +82 -0
  93. package/packages/agentsam-contracts/dist/tools.js +0 -0
  94. package/packages/agentsam-contracts/dist/widgets.d.ts +38 -0
  95. package/packages/agentsam-contracts/dist/widgets.js +0 -0
  96. package/packages/agentsam-contracts/package.json +9 -1
  97. package/packages/agentsam-contracts/scripts/build.mjs +1 -1
  98. package/packages/agentsam-contracts/src/agent.ts +78 -3
  99. package/packages/agentsam-contracts/src/errors.ts +19 -10
  100. package/packages/agentsam-contracts/src/index.ts +2 -0
  101. package/packages/agentsam-contracts/src/run.ts +320 -0
  102. package/packages/agentsam-contracts/src/widgets.ts +58 -0
  103. package/packages/agentsam-contracts/test/contracts.test.mjs +1 -1
  104. package/packages/agentsam-contracts/test/run-contract.test.mjs +94 -0
  105. package/packages/agentsam-errors/package.json +11 -3
  106. package/packages/agentsam-errors/protocol/agentsam.error.v2.schema.json +821 -0
  107. package/packages/agentsam-errors/protocol/error-catalog.json +3512 -0
  108. package/packages/agentsam-errors/src/envelope.js +63 -11
  109. package/packages/agentsam-errors/src/error.js +6 -0
  110. package/packages/agentsam-errors/src/fingerprint.js +9 -1
  111. package/packages/agentsam-errors/src/normalize.js +51 -6
  112. package/packages/agentsam-errors/src/recovery.js +9 -35
  113. package/packages/agentsam-errors/src/transport.js +6 -1
  114. package/packages/agentsam-errors/src/vocabulary.js +515 -126
  115. package/packages/agentsam-errors/test/catalog-v2.test.mjs +106 -0
  116. package/packages/agentsam-errors/types/index.d.ts +157 -0
  117. package/packages/agentsam-goap/README.md +3 -0
  118. package/packages/agentsam-goap/package.json +2 -2
  119. package/packages/agentsam-hooks/README.md +206 -0
  120. package/packages/agentsam-hooks/bin/agentsam-hooks.mjs +64 -0
  121. package/packages/agentsam-hooks/bindings/go/command.go +55 -0
  122. package/packages/agentsam-hooks/bindings/go/errors_generated.go +402 -0
  123. package/packages/agentsam-hooks/bindings/go/go.mod +3 -0
  124. package/packages/agentsam-hooks/bindings/go/hooks.go +285 -0
  125. package/packages/agentsam-hooks/bindings/go/hooks_test.go +48 -0
  126. package/packages/agentsam-hooks/bindings/rust/Cargo.toml +11 -0
  127. package/packages/agentsam-hooks/bindings/rust/src/errors_generated.rs +396 -0
  128. package/packages/agentsam-hooks/bindings/rust/src/lib.rs +397 -0
  129. package/packages/agentsam-hooks/package.json +69 -0
  130. package/packages/agentsam-hooks/schema/manifest.json +54 -0
  131. package/packages/agentsam-hooks/scripts/clean-protocol.mjs +17 -0
  132. package/packages/agentsam-hooks/scripts/sync-protocol.mjs +27 -0
  133. package/packages/agentsam-hooks/src/adapters/agents.js +108 -0
  134. package/packages/agentsam-hooks/src/adapters/callback.js +4 -0
  135. package/packages/agentsam-hooks/src/adapters/capability.js +122 -0
  136. package/packages/agentsam-hooks/src/adapters/command.js +104 -0
  137. package/packages/agentsam-hooks/src/adapters/composite.js +31 -0
  138. package/packages/agentsam-hooks/src/adapters/http.js +58 -0
  139. package/packages/agentsam-hooks/src/adapters/lsp.js +116 -0
  140. package/packages/agentsam-hooks/src/adapters/mcp.js +76 -0
  141. package/packages/agentsam-hooks/src/adapters/provider.js +129 -0
  142. package/packages/agentsam-hooks/src/config.js +143 -0
  143. package/packages/agentsam-hooks/src/contracts.js +284 -0
  144. package/packages/agentsam-hooks/src/errors-generated.js +2732 -0
  145. package/packages/agentsam-hooks/src/index.d.ts +209 -0
  146. package/packages/agentsam-hooks/src/index.js +14 -0
  147. package/packages/agentsam-hooks/src/policy.js +34 -0
  148. package/packages/agentsam-hooks/src/runtime.js +312 -0
  149. package/packages/agentsam-hooks/src/store.js +264 -0
  150. package/packages/agentsam-hooks/test/adapters.test.mjs +216 -0
  151. package/packages/agentsam-hooks/test/runtime.test.mjs +258 -0
  152. package/packages/agentsam-knowledge/package.json +1 -1
  153. package/packages/agentsam-knowledge/src/backends/index.js +1 -1
  154. package/packages/agentsam-merch/README.md +62 -0
  155. package/packages/agentsam-merch/bin/agentsam-merch.mjs +16 -0
  156. package/packages/agentsam-merch/package.json +65 -0
  157. package/packages/agentsam-merch/profiles/completeful/dtg-back-large.json +42 -0
  158. package/packages/agentsam-merch/profiles/completeful/laser-engraving.json +39 -0
  159. package/packages/agentsam-merch/profiles/generic/embroidery-digitization.json +22 -0
  160. package/packages/agentsam-merch/schemas/collection-candidate.schema.json +66 -0
  161. package/packages/agentsam-merch/schemas/manufacturing-profile.schema.json +221 -0
  162. package/packages/agentsam-merch/src/adapters-completeful.js +50 -0
  163. package/packages/agentsam-merch/src/cli.js +93 -0
  164. package/packages/agentsam-merch/src/collection-lab.js +60 -0
  165. package/packages/agentsam-merch/src/compatibility.js +501 -0
  166. package/packages/agentsam-merch/src/derivatives.js +112 -0
  167. package/packages/agentsam-merch/src/index.d.ts +316 -0
  168. package/packages/agentsam-merch/src/index.js +46 -0
  169. package/packages/agentsam-merch/src/node/index.d.ts +58 -0
  170. package/packages/agentsam-merch/src/node/index.js +6 -0
  171. package/packages/agentsam-merch/src/node/raster.js +142 -0
  172. package/packages/agentsam-merch/src/node/vector.js +239 -0
  173. package/packages/agentsam-merch/src/product-concepts.js +118 -0
  174. package/packages/agentsam-merch/src/profile-registry.js +104 -0
  175. package/packages/agentsam-merch/src/profile.js +158 -0
  176. package/packages/agentsam-merch/src/transforms.js +215 -0
  177. package/packages/agentsam-merch/test/merch.test.mjs +332 -0
  178. package/packages/agentsam-merch/test/node-transforms.test.mjs +149 -0
  179. package/packages/agentsam-nav/dist/Nav.d.ts +43 -0
  180. package/packages/agentsam-nav/dist/NavCollapsible.d.ts +10 -0
  181. package/packages/agentsam-nav/dist/NavContent.d.ts +2 -0
  182. package/packages/agentsam-nav/dist/NavFooter.d.ts +2 -0
  183. package/packages/agentsam-nav/dist/NavGroup.d.ts +3 -0
  184. package/packages/agentsam-nav/dist/NavHeader.d.ts +2 -0
  185. package/packages/agentsam-nav/dist/NavMenu.d.ts +22 -0
  186. package/packages/agentsam-nav/dist/NavProvider.d.ts +35 -0
  187. package/packages/agentsam-nav/dist/NavTrigger.d.ts +2 -0
  188. package/packages/agentsam-nav/dist/Surfaces.d.ts +41 -0
  189. package/packages/agentsam-nav/dist/browser.d.ts +11 -0
  190. package/packages/agentsam-nav/dist/browser.global.js +172 -0
  191. package/packages/agentsam-nav/dist/browser.js +9688 -0
  192. package/packages/agentsam-nav/dist/contracts.d.ts +76 -0
  193. package/packages/agentsam-nav/dist/index.d.ts +11 -0
  194. package/packages/agentsam-nav/dist/index.js +9689 -0
  195. package/packages/agentsam-nav/dist/legacy.css +83 -0
  196. package/packages/agentsam-nav/dist/shell.css +113 -0
  197. package/packages/agentsam-nav/dist/theme.css +113 -0
  198. package/packages/agentsam-nav/dist/utils.d.ts +1 -0
  199. package/packages/agentsam-nav/package.json +1 -1
  200. package/packages/agentsam-queue-control/README.md +4 -1
  201. package/packages/agentsam-queue-control/package.json +4 -3
  202. package/packages/agentsam-queue-control/schemas/job-envelope.schema.json +111 -11
  203. package/packages/agentsam-queue-control/src/adapters/cloudflare.js +34 -6
  204. package/packages/agentsam-queue-control/src/adapters/memory.js +11 -2
  205. package/packages/agentsam-queue-control/src/adapters/sqlite.js +259 -0
  206. package/packages/agentsam-queue-control/src/contracts.js +207 -3
  207. package/packages/agentsam-queue-control/src/control-plane.js +62 -2
  208. package/packages/agentsam-queue-control/src/index.js +1 -0
  209. package/packages/agentsam-queue-control/test/queue-control.test.mjs +310 -0
  210. package/packages/agentsam-queue-control/test/sqlite-adapter.test.mjs +91 -0
  211. package/packages/agentsam-rapid-rust/README.md +3 -0
  212. package/packages/agentsam-repository/README.md +3 -0
  213. package/packages/agentsam-repository/package.json +1 -1
  214. package/packages/agentsam-vault/package.json +1 -1
  215. package/packages/agentsam-workbench/README.md +43 -0
  216. package/packages/agentsam-workbench/package.json +14 -4
  217. package/packages/agentsam-workbench/src/agent/AgentConversationSurface.tsx +108 -0
  218. package/packages/agentsam-workbench/src/agent/AgentPanel.tsx +25 -8
  219. package/packages/agentsam-workbench/src/agent/AgentRuntimeField.tsx +152 -0
  220. package/packages/agentsam-workbench/src/agent/Composer.tsx +10 -1
  221. package/packages/agentsam-workbench/src/agent/RunMode.ts +26 -0
  222. package/packages/agentsam-workbench/src/agent/Thread.tsx +18 -3
  223. package/packages/agentsam-workbench/src/agent/index.ts +3 -0
  224. package/packages/agentsam-workbench/src/index.ts +4 -0
  225. package/packages/agentsam-workbench/src/manufacturing/PreflightIndicator.tsx +203 -0
  226. package/packages/agentsam-workbench/src/manufacturing/index.ts +2 -0
  227. package/packages/agentsam-workbench/src/manufacturing/loading.ts +147 -0
  228. package/packages/agentsam-workbench/src/widgets/BuiltinWidget.tsx +22 -0
  229. package/packages/agentsam-workbench/src/widgets/CountdownWidget.tsx +68 -0
  230. package/packages/agentsam-workbench/src/widgets/WidgetFrame.tsx +56 -0
  231. package/packages/agentsam-workbench/src/widgets/countdown.ts +25 -0
  232. package/packages/agentsam-workbench/src/widgets/index.ts +6 -0
  233. package/packages/agentsam-workbench/src/widgets/registry.ts +13 -0
  234. package/packages/agentsam-workbench/src/widgets/useCountdown.ts +128 -0
  235. package/packages/agentsam-workbench/src/widgets/widgets.css +102 -0
  236. package/packages/connectors/{cloudflare → cfoa}/package.json +3 -3
  237. package/packages/heuristic-theme/package.json +1 -1
  238. package/packages/identity/README.md +3 -0
  239. package/packages/identity/backend/README.md +3 -0
  240. package/packages/identity/package.json +2 -2
  241. package/packages/identity/src/frontend/auth-portal/README.md +3 -0
  242. package/packages/identity/src/index.js +1 -1
  243. package/packages/identity/src/oauth/README.md +4 -1
  244. package/packages/identity/src/oauth/credentials.js +1 -1
  245. package/packages/identity/src/server/worker-router.js +1 -1
  246. package/packages/identity/tests/google-desktop-identity-login.test.mjs +1 -1
  247. package/packages/identity/tests/lane1-packed-consumer.test.mjs +1 -1
  248. package/packages/identity/tests/oauth-presets-accounts-ssot.test.mjs +1 -1
  249. package/packages/providers/completeful/package.json +1 -1
  250. package/packages/theme-church-site/package.json +2 -2
  251. package/packages/theme-companions-site/package.json +2 -2
  252. package/packages/theme-floors-site/package.json +2 -2
  253. package/packages/theme-fuelnfree-site/package.json +2 -2
  254. package/packages/theme-handyman-site/package.json +2 -2
  255. package/packages/theme-insurance-site/package.json +2 -2
  256. package/packages/theme-scenes/package.json +1 -1
  257. package/packages/theme-shinshu-site/package.json +2 -2
  258. package/packages/work-graph/package.json +1 -1
  259. package/protocol/apps/agentsam.app.v1.schema.json +1 -1
  260. package/protocol/apps/agentsam.host-install.v1.schema.json +1 -1
  261. package/protocol/assets/asset-record.v1.schema.json +1 -1
  262. package/protocol/brand/brandpack.v1.schema.json +1 -1
  263. package/protocol/capabilities/capability-manifest.schema.json +1 -1
  264. package/protocol/capabilities/knowledge-search-input.schema.json +1 -0
  265. package/protocol/credentials/issue.v1.schema.json +1 -1
  266. package/protocol/database/agentsam.schema-pack.v1.schema.json +1 -1
  267. package/protocol/database/connection.v1.schema.json +1 -1
  268. package/protocol/embeddings/embedding-profile.v1.schema.json +1 -1
  269. package/protocol/errors/README.md +36 -0
  270. package/protocol/errors/agentsam.error.v2.schema.json +821 -0
  271. package/protocol/errors/error-catalog.json +3506 -158
  272. package/protocol/errors/error-envelope.schema.json +195 -52
  273. package/protocol/errors/recovery.v1.schema.json +1 -1
  274. package/protocol/features/agentsam.feature.v1.schema.json +1 -1
  275. package/protocol/hooks/README.md +18 -0
  276. package/protocol/hooks/agentsam.hook.output.v1.schema.json +27 -0
  277. package/protocol/hooks/agentsam.hook.receipt.v1.schema.json +61 -0
  278. package/protocol/hooks/agentsam.hook.v1.schema.json +35 -0
  279. package/protocol/hooks/agentsam.hooks.config.v1.schema.json +78 -0
  280. package/protocol/local-engine/benchmark.v1.schema.json +1 -1
  281. package/protocol/local-engine/engine.v1.schema.json +1 -1
  282. package/protocol/models/README.md +3 -0
  283. package/protocol/models/model-inventory-v2.schema.json +1 -1
  284. package/protocol/models/provider-model-snapshot.v1.schema.json +22 -0
  285. package/protocol/receipts/agentsam.receipt.v1.json +95 -0
  286. package/protocol/rpc/v1/errors.proto +1 -0
  287. package/protocol/runtime/agentsam.runtime.v1.schema.json +1 -1
  288. package/protocol/runtime/workspace-fs.v1.schema.json +1 -1
  289. package/protocol/sam/activity.v1.schema.json +1 -1
  290. package/protocol/sam/answer.v1.schema.json +1 -1
  291. package/protocol/sam/calibration.v1.schema.json +1 -1
  292. package/protocol/sam/decision-receipt.v1.schema.json +1 -1
  293. package/protocol/sam/evaluation.v1.schema.json +1 -1
  294. package/protocol/sam/operation.schema.json +1 -1
  295. package/protocol/sam/outcome.v1.schema.json +1 -1
  296. package/protocol/sam/question.v1.schema.json +1 -1
  297. package/protocol/sam/result.schema.json +1 -1
  298. package/protocol/sam/state.v1.schema.json +1 -1
  299. package/protocol/scoring/scorecard.v1.schema.json +1 -1
  300. package/protocol/skills/agentsam.interaction.v1.schema.json +1 -1
  301. package/protocol/skills/agentsam.skill.v1.schema.json +1 -1
  302. package/protocol/theme-refinery/product-metadata.schema.json +1 -1
  303. package/protocol/theme-refinery/receipts/products-registry-batch-20260924.json +6 -6
  304. package/protocol/theme-refinery/receipts/theme-harvest-20260924.json +6 -6
  305. package/protocol/theme-refinery/reconciliation-receipt.schema.json +1 -1
  306. package/protocol/ui/icon.v1.schema.json +1 -1
  307. package/python/README.md +20 -0
  308. package/python/agentsam_sdk/errors/__init__.py +4 -0
  309. package/python/agentsam_sdk/errors/vocabulary.py +2730 -0
  310. package/python/agentsam_sdk/hooks/__init__.py +32 -0
  311. package/python/agentsam_sdk/hooks/adapters.py +132 -0
  312. package/python/agentsam_sdk/hooks/contracts.py +121 -0
  313. package/python/agentsam_sdk/hooks/runtime.py +253 -0
  314. package/python/tests/test_hooks.py +115 -0
  315. package/skills/README.md +3 -0
  316. package/src/acp/agent-executor.js +106 -0
  317. package/src/acp/client.js +316 -0
  318. package/src/acp/dependencies.js +426 -0
  319. package/src/acp/http.js +207 -0
  320. package/src/acp/index.js +22 -0
  321. package/src/acp/runs.js +125 -0
  322. package/src/acp/runtime-selection.js +180 -0
  323. package/src/agent/responses-runner.js +145 -1
  324. package/src/cli/command-catalog.js +4 -0
  325. package/src/cli.js +33 -0
  326. package/src/commands/cheat-sheet.js +1 -0
  327. package/src/commands/cloudflare-login.js +1 -1
  328. package/src/commands/cloudflare.js +2 -2
  329. package/src/commands/connections.js +1 -1
  330. package/src/commands/go.js +76 -6
  331. package/src/commands/hooks.js +260 -0
  332. package/src/commands/merch.js +5 -0
  333. package/src/commands/mini.js +1 -1
  334. package/src/commands/models.js +1 -1
  335. package/src/commands/receipts.js +140 -0
  336. package/src/commands/run.js +253 -0
  337. package/src/commands/shell.js +114 -9
  338. package/src/errors/diagnostic.js +9 -9
  339. package/src/go/container.js +1 -1
  340. package/src/go/contract.js +61 -18
  341. package/src/go/discover.js +0 -4
  342. package/src/go/index.js +13 -1
  343. package/src/go/probe.js +109 -0
  344. package/src/go/{cloudflare.js → providers/cloudflare.js} +36 -136
  345. package/src/go/verify.js +1 -1
  346. package/src/index.js +32 -0
  347. package/src/indexing/ingest/inventory.js +1 -1
  348. package/src/knowledge/service/grpc-codec.js +2 -0
  349. package/src/lib/deploy/local-studio.js +2 -2
  350. package/src/lib/mini/scaffold.js +1 -1
  351. package/src/lib/slash-commands.js +1 -0
  352. package/src/lib/whoami-capabilities.js +1 -1
  353. package/src/local/runtime-store.js +54 -0
  354. package/src/mcp/cloudflare-bundles.js +1 -1
  355. package/src/models/catalog.js +0 -49
  356. package/src/models/inventory-core.js +69 -0
  357. package/src/plugins/index.js +9 -1
  358. package/src/plugins/registry.js +115 -6
  359. package/src/receipts/contract.js +68 -0
  360. package/src/receipts/index.js +20 -0
  361. package/src/receipts/prune.js +64 -0
  362. package/src/receipts/sinks.js +285 -0
  363. package/src/rpc/generated/errors_pb.js +49 -1
  364. package/src/tools/runtime.js +13 -5
  365. package/templates/mini/gadget/app.js +15 -40
  366. package/templates/mini/gadget/index.html +7 -7
  367. package/templates/mini/shared/style.css +1 -1
  368. /package/packages/connectors/{cloudflare → cfoa}/OAUTH_STORAGE_AUDIT.md +0 -0
  369. /package/packages/connectors/{cloudflare → cfoa}/src/api-client.js +0 -0
  370. /package/packages/connectors/{cloudflare → cfoa}/src/capabilities.js +0 -0
  371. /package/packages/connectors/{cloudflare → cfoa}/src/credential.js +0 -0
  372. /package/packages/connectors/{cloudflare → cfoa}/src/families/brand-protection.js +0 -0
  373. /package/packages/connectors/{cloudflare → cfoa}/src/families/keyless.js +0 -0
  374. /package/packages/connectors/{cloudflare → cfoa}/src/families/pages.js +0 -0
  375. /package/packages/connectors/{cloudflare → cfoa}/src/families/scanner.js +0 -0
  376. /package/packages/connectors/{cloudflare → cfoa}/src/families/snippets.js +0 -0
  377. /package/packages/connectors/{cloudflare → cfoa}/src/families/tag-gateway.js +0 -0
  378. /package/packages/connectors/{cloudflare → cfoa}/src/families/tags.js +0 -0
  379. /package/packages/connectors/{cloudflare → cfoa}/src/families/token-validation.js +0 -0
  380. /package/packages/connectors/{cloudflare → cfoa}/src/families/vectorize.js +0 -0
  381. /package/packages/connectors/{cloudflare → cfoa}/src/families/workflows.js +0 -0
  382. /package/packages/connectors/{cloudflare → cfoa}/src/index.js +0 -0
  383. /package/packages/connectors/{cloudflare → cfoa}/src/oauth-persist.js +0 -0
  384. /package/packages/connectors/{cloudflare → cfoa}/src/owner.js +0 -0
  385. /package/packages/connectors/{cloudflare → cfoa}/src/permission-options.js +0 -0
  386. /package/packages/connectors/{cloudflare → cfoa}/src/routes.js +0 -0
  387. /package/packages/connectors/{cloudflare → cfoa}/src/scope-catalog.js +0 -0
  388. /package/packages/connectors/{cloudflare → cfoa}/src/vault.js +0 -0
  389. /package/packages/connectors/{cloudflare → cfoa}/tests/capabilities.test.mjs +0 -0
  390. /package/packages/connectors/{cloudflare → cfoa}/tests/connector.test.mjs +0 -0
  391. /package/packages/connectors/{cloudflare → cfoa}/tests/oauth-persist.test.mjs +0 -0
  392. /package/packages/identity/src/oauth/{google-desktop-exchange.js → goaude.js} +0 -0
package/packages/agentsam-hooks/src/errors-generated.js ADDED
@@ -0,0 +1,2732 @@
1
+ // GENERATED by scripts/generate-error-contracts.mjs. Do not edit by hand.
2
+ // This binding is a projection of protocol/errors/error-catalog.json, not a hook-local taxonomy.
3
+ export const ERROR_SCHEMA_VERSION = 2;
4
+ export const ERROR_REASON_POLICY = Object.freeze({
5
+ "unknown": {
6
+ "code": "UNKNOWN",
7
+ "domain": "runtime",
8
+ "failure_class": "internal",
9
+ "severity": "blocking_internal",
10
+ "retryable": false,
11
+ "resolution_owner": "unknown",
12
+ "remediation_action": "inspect_platform",
13
+ "default_stage": "execute"
14
+ },
15
+ "input_invalid": {
16
+ "code": "INVALID_ARGUMENT",
17
+ "domain": "runtime",
18
+ "failure_class": "validation",
19
+ "severity": "blocking_user_fixable",
20
+ "retryable": false,
21
+ "resolution_owner": "user",
22
+ "remediation_action": "change_input",
23
+ "default_stage": "validate"
24
+ },
25
+ "input_out_of_range": {
26
+ "code": "OUT_OF_RANGE",
27
+ "domain": "runtime",
28
+ "failure_class": "validation",
29
+ "severity": "blocking_user_fixable",
30
+ "retryable": false,
31
+ "resolution_owner": "user",
32
+ "remediation_action": "change_input",
33
+ "default_stage": "execute"
34
+ },
35
+ "precondition_failed": {
36
+ "code": "FAILED_PRECONDITION",
37
+ "domain": "runtime",
38
+ "failure_class": "configuration",
39
+ "severity": "blocking_user_fixable",
40
+ "retryable": false,
41
+ "resolution_owner": "user",
42
+ "remediation_action": "change_configuration",
43
+ "default_stage": "validate"
44
+ },
45
+ "unsupported_operation": {
46
+ "code": "UNIMPLEMENTED",
47
+ "domain": "runtime",
48
+ "failure_class": "validation",
49
+ "severity": "blocking_user_fixable",
50
+ "retryable": false,
51
+ "resolution_owner": "user",
52
+ "remediation_action": "change_configuration",
53
+ "default_stage": "validate"
54
+ },
55
+ "auth_missing": {
56
+ "code": "UNAUTHENTICATED",
57
+ "domain": "auth",
58
+ "failure_class": "authentication",
59
+ "severity": "blocking_user_fixable",
60
+ "retryable": false,
61
+ "resolution_owner": "user",
62
+ "remediation_action": "reauthenticate",
63
+ "default_stage": "authorize"
64
+ },
65
+ "auth_invalid": {
66
+ "code": "UNAUTHENTICATED",
67
+ "domain": "auth",
68
+ "failure_class": "authentication",
69
+ "severity": "blocking_user_fixable",
70
+ "retryable": false,
71
+ "resolution_owner": "user",
72
+ "remediation_action": "reauthenticate",
73
+ "default_stage": "authorize"
74
+ },
75
+ "permission_denied": {
76
+ "code": "PERMISSION_DENIED",
77
+ "domain": "auth",
78
+ "failure_class": "authorization",
79
+ "severity": "policy_blocking",
80
+ "retryable": false,
81
+ "resolution_owner": "policy",
82
+ "remediation_action": "request_permission",
83
+ "default_stage": "authorize"
84
+ },
85
+ "user_permission_denied": {
86
+ "code": "PERMISSION_DENIED",
87
+ "domain": "auth",
88
+ "failure_class": "authorization",
89
+ "severity": "blocking_user_fixable",
90
+ "retryable": false,
91
+ "resolution_owner": "user",
92
+ "remediation_action": "request_permission",
93
+ "default_stage": "authorize"
94
+ },
95
+ "provider_not_connected": {
96
+ "code": "FAILED_PRECONDITION",
97
+ "domain": "provider",
98
+ "failure_class": "execution",
99
+ "severity": "blocking_user_fixable",
100
+ "retryable": false,
101
+ "resolution_owner": "user",
102
+ "remediation_action": "connect_provider",
103
+ "default_stage": "connect"
104
+ },
105
+ "provider_credential_missing": {
106
+ "code": "FAILED_PRECONDITION",
107
+ "domain": "provider",
108
+ "failure_class": "authentication",
109
+ "severity": "blocking_user_fixable",
110
+ "retryable": false,
111
+ "resolution_owner": "user",
112
+ "remediation_action": "configure_provider_credential",
113
+ "default_stage": "authorize"
114
+ },
115
+ "provider_credential_invalid": {
116
+ "code": "UNAUTHENTICATED",
117
+ "domain": "provider",
118
+ "failure_class": "authentication",
119
+ "severity": "blocking_user_fixable",
120
+ "retryable": false,
121
+ "resolution_owner": "user",
122
+ "remediation_action": "refresh_provider_credential",
123
+ "default_stage": "authorize"
124
+ },
125
+ "provider_credential_expired": {
126
+ "code": "UNAUTHENTICATED",
127
+ "domain": "provider",
128
+ "failure_class": "authentication",
129
+ "severity": "blocking_user_fixable",
130
+ "retryable": false,
131
+ "resolution_owner": "user",
132
+ "remediation_action": "refresh_provider_credential",
133
+ "default_stage": "authorize"
134
+ },
135
+ "provider_scope_insufficient": {
136
+ "code": "PERMISSION_DENIED",
137
+ "domain": "provider",
138
+ "failure_class": "authorization",
139
+ "severity": "blocking_user_fixable",
140
+ "retryable": false,
141
+ "resolution_owner": "user",
142
+ "remediation_action": "request_permission",
143
+ "default_stage": "authorize"
144
+ },
145
+ "provider_budget_exhausted": {
146
+ "code": "RESOURCE_EXHAUSTED",
147
+ "domain": "provider",
148
+ "failure_class": "capacity",
149
+ "severity": "blocking_user_fixable",
150
+ "retryable": false,
151
+ "resolution_owner": "user",
152
+ "remediation_action": "add_budget",
153
+ "default_stage": "execute"
154
+ },
155
+ "provider_quota_exhausted": {
156
+ "code": "RESOURCE_EXHAUSTED",
157
+ "domain": "provider",
158
+ "failure_class": "capacity",
159
+ "severity": "blocking_user_fixable",
160
+ "retryable": false,
161
+ "resolution_owner": "user",
162
+ "remediation_action": "increase_quota",
163
+ "default_stage": "execute"
164
+ },
165
+ "provider_rate_limited": {
166
+ "code": "RESOURCE_EXHAUSTED",
167
+ "domain": "provider",
168
+ "failure_class": "capacity",
169
+ "severity": "transient",
170
+ "retryable": true,
171
+ "resolution_owner": "provider",
172
+ "remediation_action": "retry_later",
173
+ "default_stage": "execute"
174
+ },
175
+ "provider_capacity_exhausted": {
176
+ "code": "RESOURCE_EXHAUSTED",
177
+ "domain": "provider",
178
+ "failure_class": "capacity",
179
+ "severity": "transient",
180
+ "retryable": true,
181
+ "resolution_owner": "provider",
182
+ "remediation_action": "retry_later",
183
+ "default_stage": "execute"
184
+ },
185
+ "provider_unavailable": {
186
+ "code": "UNAVAILABLE",
187
+ "domain": "provider",
188
+ "failure_class": "availability",
189
+ "severity": "transient",
190
+ "retryable": true,
191
+ "resolution_owner": "provider",
192
+ "remediation_action": "retry_later",
193
+ "default_stage": "execute"
194
+ },
195
+ "provider_overloaded": {
196
+ "code": "UNAVAILABLE",
197
+ "domain": "provider",
198
+ "failure_class": "execution",
199
+ "severity": "transient",
200
+ "retryable": true,
201
+ "resolution_owner": "provider",
202
+ "remediation_action": "retry_later",
203
+ "default_stage": "execute"
204
+ },
205
+ "provider_request_invalid": {
206
+ "code": "INVALID_ARGUMENT",
207
+ "domain": "provider",
208
+ "failure_class": "validation",
209
+ "severity": "blocking_user_fixable",
210
+ "retryable": false,
211
+ "resolution_owner": "user",
212
+ "remediation_action": "change_input",
213
+ "default_stage": "validate"
214
+ },
215
+ "provider_model_not_found": {
216
+ "code": "NOT_FOUND",
217
+ "domain": "provider",
218
+ "failure_class": "availability",
219
+ "severity": "blocking_user_fixable",
220
+ "retryable": false,
221
+ "resolution_owner": "user",
222
+ "remediation_action": "select_model",
223
+ "default_stage": "resolve"
224
+ },
225
+ "provider_region_unsupported": {
226
+ "code": "FAILED_PRECONDITION",
227
+ "domain": "provider",
228
+ "failure_class": "validation",
229
+ "severity": "blocking_user_fixable",
230
+ "retryable": false,
231
+ "resolution_owner": "user",
232
+ "remediation_action": "change_region",
233
+ "default_stage": "validate"
234
+ },
235
+ "provider_content_blocked": {
236
+ "code": "PERMISSION_DENIED",
237
+ "domain": "provider",
238
+ "failure_class": "authorization",
239
+ "severity": "policy_blocking",
240
+ "retryable": false,
241
+ "resolution_owner": "policy",
242
+ "remediation_action": "none",
243
+ "default_stage": "execute"
244
+ },
245
+ "context_window_exceeded": {
246
+ "code": "RESOURCE_EXHAUSTED",
247
+ "domain": "model",
248
+ "failure_class": "capacity",
249
+ "severity": "blocking_user_fixable",
250
+ "retryable": false,
251
+ "resolution_owner": "user",
252
+ "remediation_action": "reduce_scope",
253
+ "default_stage": "execute"
254
+ },
255
+ "service_tier_unsupported": {
256
+ "code": "FAILED_PRECONDITION",
257
+ "domain": "model",
258
+ "failure_class": "validation",
259
+ "severity": "blocking_user_fixable",
260
+ "retryable": false,
261
+ "resolution_owner": "user",
262
+ "remediation_action": "change_configuration",
263
+ "default_stage": "validate"
264
+ },
265
+ "continuation_invalid": {
266
+ "code": "FAILED_PRECONDITION",
267
+ "domain": "model",
268
+ "failure_class": "validation",
269
+ "severity": "transient",
270
+ "retryable": true,
271
+ "resolution_owner": "agentsam",
272
+ "remediation_action": "retry",
273
+ "default_stage": "validate"
274
+ },
275
+ "target_not_found": {
276
+ "code": "NOT_FOUND",
277
+ "domain": "runtime",
278
+ "failure_class": "availability",
279
+ "severity": "blocking_user_fixable",
280
+ "retryable": false,
281
+ "resolution_owner": "user",
282
+ "remediation_action": "change_input",
283
+ "default_stage": "resolve"
284
+ },
285
+ "already_exists": {
286
+ "code": "ALREADY_EXISTS",
287
+ "domain": "runtime",
288
+ "failure_class": "conflict",
289
+ "severity": "blocking_user_fixable",
290
+ "retryable": false,
291
+ "resolution_owner": "user",
292
+ "remediation_action": "change_input",
293
+ "default_stage": "execute"
294
+ },
295
+ "conflict": {
296
+ "code": "ABORTED",
297
+ "domain": "runtime",
298
+ "failure_class": "conflict",
299
+ "severity": "blocking_user_fixable",
300
+ "retryable": false,
301
+ "resolution_owner": "user",
302
+ "remediation_action": "change_input",
303
+ "default_stage": "execute"
304
+ },
305
+ "stale_version": {
306
+ "code": "ABORTED",
307
+ "domain": "runtime",
308
+ "failure_class": "conflict",
309
+ "severity": "transient",
310
+ "retryable": true,
311
+ "resolution_owner": "user",
312
+ "remediation_action": "retry",
313
+ "default_stage": "execute"
314
+ },
315
+ "rate_limited": {
316
+ "code": "RESOURCE_EXHAUSTED",
317
+ "domain": "runtime",
318
+ "failure_class": "capacity",
319
+ "severity": "transient",
320
+ "retryable": true,
321
+ "resolution_owner": "provider",
322
+ "remediation_action": "retry_later",
323
+ "default_stage": "execute"
324
+ },
325
+ "quota_exhausted": {
326
+ "code": "RESOURCE_EXHAUSTED",
327
+ "domain": "runtime",
328
+ "failure_class": "capacity",
329
+ "severity": "blocking_user_fixable",
330
+ "retryable": false,
331
+ "resolution_owner": "user",
332
+ "remediation_action": "increase_quota",
333
+ "default_stage": "execute"
334
+ },
335
+ "capacity_exhausted": {
336
+ "code": "RESOURCE_EXHAUSTED",
337
+ "domain": "runtime",
338
+ "failure_class": "capacity",
339
+ "severity": "transient",
340
+ "retryable": true,
341
+ "resolution_owner": "provider",
342
+ "remediation_action": "retry_later",
343
+ "default_stage": "execute"
344
+ },
345
+ "transport_unreachable": {
346
+ "code": "UNAVAILABLE",
347
+ "domain": "transport",
348
+ "failure_class": "availability",
349
+ "severity": "transient",
350
+ "retryable": true,
351
+ "resolution_owner": "provider",
352
+ "remediation_action": "retry_later",
353
+ "default_stage": "connect"
354
+ },
355
+ "transport_refused": {
356
+ "code": "UNAVAILABLE",
357
+ "domain": "transport",
358
+ "failure_class": "availability",
359
+ "severity": "transient",
360
+ "retryable": true,
361
+ "resolution_owner": "provider",
362
+ "remediation_action": "retry_later",
363
+ "default_stage": "connect"
364
+ },
365
+ "transport_timeout": {
366
+ "code": "DEADLINE_EXCEEDED",
367
+ "domain": "transport",
368
+ "failure_class": "timeout",
369
+ "severity": "transient",
370
+ "retryable": true,
371
+ "resolution_owner": "provider",
372
+ "remediation_action": "retry_later",
373
+ "default_stage": "execute"
374
+ },
375
+ "upstream_invalid_response": {
376
+ "code": "UNAVAILABLE",
377
+ "domain": "runtime",
378
+ "failure_class": "validation",
379
+ "severity": "transient",
380
+ "retryable": true,
381
+ "resolution_owner": "provider",
382
+ "remediation_action": "retry_later",
383
+ "default_stage": "validate"
384
+ },
385
+ "dns_unresolved": {
386
+ "code": "UNAVAILABLE",
387
+ "domain": "transport",
388
+ "failure_class": "transport",
389
+ "severity": "transient",
390
+ "retryable": true,
391
+ "resolution_owner": "provider",
392
+ "remediation_action": "retry_later",
393
+ "default_stage": "connect"
394
+ },
395
+ "tls_handshake_failed": {
396
+ "code": "UNAVAILABLE",
397
+ "domain": "transport",
398
+ "failure_class": "transport",
399
+ "severity": "blocking_internal",
400
+ "retryable": false,
401
+ "resolution_owner": "agentsam",
402
+ "remediation_action": "inspect_platform",
403
+ "default_stage": "connect"
404
+ },
405
+ "tls_certificate_invalid": {
406
+ "code": "UNAVAILABLE",
407
+ "domain": "transport",
408
+ "failure_class": "transport",
409
+ "severity": "blocking_internal",
410
+ "retryable": false,
411
+ "resolution_owner": "agentsam",
412
+ "remediation_action": "inspect_platform",
413
+ "default_stage": "connect"
414
+ },
415
+ "tunnel_connector_unavailable": {
416
+ "code": "UNAVAILABLE",
417
+ "domain": "transport",
418
+ "failure_class": "availability",
419
+ "severity": "transient",
420
+ "retryable": true,
421
+ "resolution_owner": "user",
422
+ "remediation_action": "reconnect_service",
423
+ "default_stage": "connect"
424
+ },
425
+ "cancelled": {
426
+ "code": "CANCELLED",
427
+ "domain": "runtime",
428
+ "failure_class": "cancellation",
429
+ "severity": "blocking_user_fixable",
430
+ "retryable": false,
431
+ "resolution_owner": "user",
432
+ "remediation_action": "none",
433
+ "default_stage": "execute"
434
+ },
435
+ "deadline_exceeded": {
436
+ "code": "DEADLINE_EXCEEDED",
437
+ "domain": "runtime",
438
+ "failure_class": "timeout",
439
+ "severity": "transient",
440
+ "retryable": true,
441
+ "resolution_owner": "unknown",
442
+ "remediation_action": "retry_later",
443
+ "default_stage": "execute"
444
+ },
445
+ "execution_timeout": {
446
+ "code": "DEADLINE_EXCEEDED",
447
+ "domain": "runtime",
448
+ "failure_class": "timeout",
449
+ "severity": "transient",
450
+ "retryable": true,
451
+ "resolution_owner": "unknown",
452
+ "remediation_action": "retry_later",
453
+ "default_stage": "execute"
454
+ },
455
+ "execution_failed": {
456
+ "code": "INTERNAL",
457
+ "domain": "runtime",
458
+ "failure_class": "internal",
459
+ "severity": "blocking_internal",
460
+ "retryable": false,
461
+ "resolution_owner": "unknown",
462
+ "remediation_action": "inspect_platform",
463
+ "default_stage": "execute"
464
+ },
465
+ "process_spawn_failed": {
466
+ "code": "FAILED_PRECONDITION",
467
+ "domain": "runtime",
468
+ "failure_class": "process",
469
+ "severity": "blocking_user_fixable",
470
+ "retryable": false,
471
+ "resolution_owner": "user",
472
+ "remediation_action": "install_dependency",
473
+ "default_stage": "execute"
474
+ },
475
+ "process_crashed": {
476
+ "code": "INTERNAL",
477
+ "domain": "runtime",
478
+ "failure_class": "process",
479
+ "severity": "blocking_internal",
480
+ "retryable": false,
481
+ "resolution_owner": "unknown",
482
+ "remediation_action": "inspect_platform",
483
+ "default_stage": "execute"
484
+ },
485
+ "process_output_limit": {
486
+ "code": "RESOURCE_EXHAUSTED",
487
+ "domain": "runtime",
488
+ "failure_class": "capacity",
489
+ "severity": "blocking_user_fixable",
490
+ "retryable": false,
491
+ "resolution_owner": "user",
492
+ "remediation_action": "reduce_scope",
493
+ "default_stage": "execute"
494
+ },
495
+ "device_not_enrolled": {
496
+ "code": "FAILED_PRECONDITION",
497
+ "domain": "device",
498
+ "failure_class": "execution",
499
+ "severity": "blocking_user_fixable",
500
+ "retryable": false,
501
+ "resolution_owner": "user",
502
+ "remediation_action": "reenroll_device",
503
+ "default_stage": "execute"
504
+ },
505
+ "device_credential_missing": {
506
+ "code": "FAILED_PRECONDITION",
507
+ "domain": "device",
508
+ "failure_class": "authentication",
509
+ "severity": "blocking_user_fixable",
510
+ "retryable": false,
511
+ "resolution_owner": "user",
512
+ "remediation_action": "reenroll_device",
513
+ "default_stage": "authorize"
514
+ },
515
+ "device_credential_invalid": {
516
+ "code": "UNAUTHENTICATED",
517
+ "domain": "device",
518
+ "failure_class": "authentication",
519
+ "severity": "blocking_user_fixable",
520
+ "retryable": false,
521
+ "resolution_owner": "user",
522
+ "remediation_action": "reenroll_device",
523
+ "default_stage": "authorize"
524
+ },
525
+ "device_credential_expired": {
526
+ "code": "UNAUTHENTICATED",
527
+ "domain": "device",
528
+ "failure_class": "authentication",
529
+ "severity": "blocking_user_fixable",
530
+ "retryable": false,
531
+ "resolution_owner": "user",
532
+ "remediation_action": "reenroll_device",
533
+ "default_stage": "authorize"
534
+ },
535
+ "device_registration_missing": {
536
+ "code": "FAILED_PRECONDITION",
537
+ "domain": "device",
538
+ "failure_class": "execution",
539
+ "severity": "blocking_user_fixable",
540
+ "retryable": false,
541
+ "resolution_owner": "user",
542
+ "remediation_action": "reenroll_device",
543
+ "default_stage": "resolve"
544
+ },
545
+ "device_registration_stale": {
546
+ "code": "FAILED_PRECONDITION",
547
+ "domain": "device",
548
+ "failure_class": "conflict",
549
+ "severity": "blocking_user_fixable",
550
+ "retryable": false,
551
+ "resolution_owner": "user",
552
+ "remediation_action": "reenroll_device",
553
+ "default_stage": "execute"
554
+ },
555
+ "connection_revoked": {
556
+ "code": "FAILED_PRECONDITION",
557
+ "domain": "identity",
558
+ "failure_class": "execution",
559
+ "severity": "blocking_user_fixable",
560
+ "retryable": false,
561
+ "resolution_owner": "user",
562
+ "remediation_action": "reenroll_device",
563
+ "default_stage": "connect"
564
+ },
565
+ "connection_disabled": {
566
+ "code": "FAILED_PRECONDITION",
567
+ "domain": "identity",
568
+ "failure_class": "execution",
569
+ "severity": "blocking_user_fixable",
570
+ "retryable": false,
571
+ "resolution_owner": "user",
572
+ "remediation_action": "reconnect_service",
573
+ "default_stage": "connect"
574
+ },
575
+ "identity_resolution_failed": {
576
+ "code": "INTERNAL",
577
+ "domain": "identity",
578
+ "failure_class": "identity",
579
+ "severity": "blocking_internal",
580
+ "retryable": false,
581
+ "resolution_owner": "agentsam",
582
+ "remediation_action": "inspect_platform",
583
+ "default_stage": "execute"
584
+ },
585
+ "identity_mismatch": {
586
+ "code": "INTERNAL",
587
+ "domain": "identity",
588
+ "failure_class": "identity",
589
+ "severity": "blocking_internal",
590
+ "retryable": false,
591
+ "resolution_owner": "agentsam",
592
+ "remediation_action": "inspect_platform",
593
+ "default_stage": "validate"
594
+ },
595
+ "repository_scope_violation": {
596
+ "code": "PERMISSION_DENIED",
597
+ "domain": "repository",
598
+ "failure_class": "authorization",
599
+ "severity": "policy_blocking",
600
+ "retryable": false,
601
+ "resolution_owner": "policy",
602
+ "remediation_action": "none",
603
+ "default_stage": "authorize"
604
+ },
605
+ "repository_changed": {
606
+ "code": "ABORTED",
607
+ "domain": "repository",
608
+ "failure_class": "conflict",
609
+ "severity": "transient",
610
+ "retryable": true,
611
+ "resolution_owner": "user",
612
+ "remediation_action": "retry",
613
+ "default_stage": "execute"
614
+ },
615
+ "index_stale": {
616
+ "code": "FAILED_PRECONDITION",
617
+ "domain": "indexing",
618
+ "failure_class": "conflict",
619
+ "severity": "blocking_user_fixable",
620
+ "retryable": false,
621
+ "resolution_owner": "user",
622
+ "remediation_action": "retry",
623
+ "default_stage": "persist"
624
+ },
625
+ "index_failed": {
626
+ "code": "INTERNAL",
627
+ "domain": "indexing",
628
+ "failure_class": "internal",
629
+ "severity": "blocking_internal",
630
+ "retryable": false,
631
+ "resolution_owner": "agentsam",
632
+ "remediation_action": "inspect_platform",
633
+ "default_stage": "persist"
634
+ },
635
+ "embedding_failed": {
636
+ "code": "INTERNAL",
637
+ "domain": "knowledge",
638
+ "failure_class": "persistence",
639
+ "severity": "blocking_internal",
640
+ "retryable": false,
641
+ "resolution_owner": "unknown",
642
+ "remediation_action": "inspect_platform",
643
+ "default_stage": "persist"
644
+ },
645
+ "vector_store_failed": {
646
+ "code": "INTERNAL",
647
+ "domain": "knowledge",
648
+ "failure_class": "persistence",
649
+ "severity": "blocking_internal",
650
+ "retryable": false,
651
+ "resolution_owner": "agentsam",
652
+ "remediation_action": "inspect_platform",
653
+ "default_stage": "persist"
654
+ },
655
+ "github_installation_missing": {
656
+ "code": "FAILED_PRECONDITION",
657
+ "domain": "repository",
658
+ "failure_class": "execution",
659
+ "severity": "blocking_user_fixable",
660
+ "retryable": false,
661
+ "resolution_owner": "user",
662
+ "remediation_action": "connect_provider",
663
+ "default_stage": "resolve"
664
+ },
665
+ "github_repository_not_found": {
666
+ "code": "NOT_FOUND",
667
+ "domain": "repository",
668
+ "failure_class": "availability",
669
+ "severity": "blocking_user_fixable",
670
+ "retryable": false,
671
+ "resolution_owner": "user",
672
+ "remediation_action": "change_input",
673
+ "default_stage": "resolve"
674
+ },
675
+ "github_rate_limited": {
676
+ "code": "RESOURCE_EXHAUSTED",
677
+ "domain": "repository",
678
+ "failure_class": "capacity",
679
+ "severity": "transient",
680
+ "retryable": true,
681
+ "resolution_owner": "provider",
682
+ "remediation_action": "retry_later",
683
+ "default_stage": "execute"
684
+ },
685
+ "github_secondary_rate_limited": {
686
+ "code": "RESOURCE_EXHAUSTED",
687
+ "domain": "repository",
688
+ "failure_class": "capacity",
689
+ "severity": "transient",
690
+ "retryable": true,
691
+ "resolution_owner": "provider",
692
+ "remediation_action": "retry_later",
693
+ "default_stage": "execute"
694
+ },
695
+ "github_scope_insufficient": {
696
+ "code": "PERMISSION_DENIED",
697
+ "domain": "repository",
698
+ "failure_class": "authorization",
699
+ "severity": "blocking_user_fixable",
700
+ "retryable": false,
701
+ "resolution_owner": "user",
702
+ "remediation_action": "request_permission",
703
+ "default_stage": "authorize"
704
+ },
705
+ "cloudflare_workers_cpu_exhausted": {
706
+ "code": "RESOURCE_EXHAUSTED",
707
+ "domain": "deployment",
708
+ "failure_class": "capacity",
709
+ "severity": "blocking_internal",
710
+ "retryable": false,
711
+ "resolution_owner": "agentsam",
712
+ "remediation_action": "inspect_platform",
713
+ "default_stage": "execute"
714
+ },
715
+ "cloudflare_service_binding_unavailable": {
716
+ "code": "UNAVAILABLE",
717
+ "domain": "deployment",
718
+ "failure_class": "availability",
719
+ "severity": "transient",
720
+ "retryable": true,
721
+ "resolution_owner": "provider",
722
+ "remediation_action": "retry_later",
723
+ "default_stage": "execute"
724
+ },
725
+ "cloudflare_durable_object_unavailable": {
726
+ "code": "UNAVAILABLE",
727
+ "domain": "deployment",
728
+ "failure_class": "availability",
729
+ "severity": "transient",
730
+ "retryable": true,
731
+ "resolution_owner": "provider",
732
+ "remediation_action": "retry_later",
733
+ "default_stage": "execute"
734
+ },
735
+ "cloudflare_d1_unavailable": {
736
+ "code": "UNAVAILABLE",
737
+ "domain": "deployment",
738
+ "failure_class": "availability",
739
+ "severity": "transient",
740
+ "retryable": true,
741
+ "resolution_owner": "provider",
742
+ "remediation_action": "retry_later",
743
+ "default_stage": "execute"
744
+ },
745
+ "cloudflare_r2_unavailable": {
746
+ "code": "UNAVAILABLE",
747
+ "domain": "deployment",
748
+ "failure_class": "availability",
749
+ "severity": "transient",
750
+ "retryable": true,
751
+ "resolution_owner": "provider",
752
+ "remediation_action": "retry_later",
753
+ "default_stage": "execute"
754
+ },
755
+ "docker_daemon_unavailable": {
756
+ "code": "UNAVAILABLE",
757
+ "domain": "runtime",
758
+ "failure_class": "availability",
759
+ "severity": "blocking_user_fixable",
760
+ "retryable": false,
761
+ "resolution_owner": "user",
762
+ "remediation_action": "restart_runtime",
763
+ "default_stage": "execute"
764
+ },
765
+ "docker_image_not_found": {
766
+ "code": "NOT_FOUND",
767
+ "domain": "runtime",
768
+ "failure_class": "availability",
769
+ "severity": "blocking_user_fixable",
770
+ "retryable": false,
771
+ "resolution_owner": "user",
772
+ "remediation_action": "change_input",
773
+ "default_stage": "resolve"
774
+ },
775
+ "docker_build_failed": {
776
+ "code": "FAILED_PRECONDITION",
777
+ "domain": "runtime",
778
+ "failure_class": "execution",
779
+ "severity": "blocking_user_fixable",
780
+ "retryable": false,
781
+ "resolution_owner": "user",
782
+ "remediation_action": "change_input",
783
+ "default_stage": "build"
784
+ },
785
+ "docker_container_failed": {
786
+ "code": "FAILED_PRECONDITION",
787
+ "domain": "runtime",
788
+ "failure_class": "execution",
789
+ "severity": "blocking_user_fixable",
790
+ "retryable": false,
791
+ "resolution_owner": "user",
792
+ "remediation_action": "change_configuration",
793
+ "default_stage": "execute"
794
+ },
795
+ "docker_registry_auth_failed": {
796
+ "code": "UNAUTHENTICATED",
797
+ "domain": "runtime",
798
+ "failure_class": "execution",
799
+ "severity": "blocking_user_fixable",
800
+ "retryable": false,
801
+ "resolution_owner": "user",
802
+ "remediation_action": "reauthenticate",
803
+ "default_stage": "execute"
804
+ },
805
+ "docker_pull_rate_limited": {
806
+ "code": "RESOURCE_EXHAUSTED",
807
+ "domain": "runtime",
808
+ "failure_class": "capacity",
809
+ "severity": "transient",
810
+ "retryable": true,
811
+ "resolution_owner": "provider",
812
+ "remediation_action": "retry_later",
813
+ "default_stage": "execute"
814
+ },
815
+ "gcp_project_missing": {
816
+ "code": "FAILED_PRECONDITION",
817
+ "domain": "deployment",
818
+ "failure_class": "execution",
819
+ "severity": "blocking_user_fixable",
820
+ "retryable": false,
821
+ "resolution_owner": "user",
822
+ "remediation_action": "change_configuration",
823
+ "default_stage": "resolve"
824
+ },
825
+ "gcp_api_disabled": {
826
+ "code": "FAILED_PRECONDITION",
827
+ "domain": "deployment",
828
+ "failure_class": "execution",
829
+ "severity": "blocking_user_fixable",
830
+ "retryable": false,
831
+ "resolution_owner": "user",
832
+ "remediation_action": "change_configuration",
833
+ "default_stage": "execute"
834
+ },
835
+ "gcp_quota_exhausted": {
836
+ "code": "RESOURCE_EXHAUSTED",
837
+ "domain": "deployment",
838
+ "failure_class": "capacity",
839
+ "severity": "blocking_user_fixable",
840
+ "retryable": false,
841
+ "resolution_owner": "user",
842
+ "remediation_action": "increase_quota",
843
+ "default_stage": "execute"
844
+ },
845
+ "gcp_vm_not_found": {
846
+ "code": "NOT_FOUND",
847
+ "domain": "deployment",
848
+ "failure_class": "availability",
849
+ "severity": "blocking_user_fixable",
850
+ "retryable": false,
851
+ "resolution_owner": "user",
852
+ "remediation_action": "change_input",
853
+ "default_stage": "resolve"
854
+ },
855
+ "gcp_vm_unavailable": {
856
+ "code": "UNAVAILABLE",
857
+ "domain": "deployment",
858
+ "failure_class": "availability",
859
+ "severity": "transient",
860
+ "retryable": true,
861
+ "resolution_owner": "provider",
862
+ "remediation_action": "retry_later",
863
+ "default_stage": "execute"
864
+ },
865
+ "cad_tool_not_installed": {
866
+ "code": "FAILED_PRECONDITION",
867
+ "domain": "cad",
868
+ "failure_class": "dependency",
869
+ "severity": "blocking_user_fixable",
870
+ "retryable": false,
871
+ "resolution_owner": "user",
872
+ "remediation_action": "install_dependency",
873
+ "default_stage": "install"
874
+ },
875
+ "cad_tool_not_executable": {
876
+ "code": "FAILED_PRECONDITION",
877
+ "domain": "cad",
878
+ "failure_class": "execution",
879
+ "severity": "blocking_user_fixable",
880
+ "retryable": false,
881
+ "resolution_owner": "user",
882
+ "remediation_action": "configure_dependency",
883
+ "default_stage": "execute"
884
+ },
885
+ "cad_tool_version_incompatible": {
886
+ "code": "FAILED_PRECONDITION",
887
+ "domain": "cad",
888
+ "failure_class": "execution",
889
+ "severity": "blocking_user_fixable",
890
+ "retryable": false,
891
+ "resolution_owner": "user",
892
+ "remediation_action": "upgrade_dependency",
893
+ "default_stage": "execute"
894
+ },
895
+ "cad_component_missing": {
896
+ "code": "FAILED_PRECONDITION",
897
+ "domain": "cad",
898
+ "failure_class": "dependency",
899
+ "severity": "blocking_user_fixable",
900
+ "retryable": false,
901
+ "resolution_owner": "user",
902
+ "remediation_action": "install_dependency",
903
+ "default_stage": "resolve"
904
+ },
905
+ "cad_dependency_missing": {
906
+ "code": "FAILED_PRECONDITION",
907
+ "domain": "cad",
908
+ "failure_class": "dependency",
909
+ "severity": "blocking_user_fixable",
910
+ "retryable": false,
911
+ "resolution_owner": "user",
912
+ "remediation_action": "install_dependency",
913
+ "default_stage": "resolve"
914
+ },
915
+ "cad_dependency_version_incompatible": {
916
+ "code": "FAILED_PRECONDITION",
917
+ "domain": "cad",
918
+ "failure_class": "dependency",
919
+ "severity": "blocking_user_fixable",
920
+ "retryable": false,
921
+ "resolution_owner": "user",
922
+ "remediation_action": "upgrade_dependency",
923
+ "default_stage": "execute"
924
+ },
925
+ "cad_source_parse_failed": {
926
+ "code": "INVALID_ARGUMENT",
927
+ "domain": "cad",
928
+ "failure_class": "execution",
929
+ "severity": "blocking_user_fixable",
930
+ "retryable": false,
931
+ "resolution_owner": "user",
932
+ "remediation_action": "change_input",
933
+ "default_stage": "execute"
934
+ },
935
+ "cad_input_format_unsupported": {
936
+ "code": "INVALID_ARGUMENT",
937
+ "domain": "cad",
938
+ "failure_class": "validation",
939
+ "severity": "blocking_user_fixable",
940
+ "retryable": false,
941
+ "resolution_owner": "user",
942
+ "remediation_action": "change_input",
943
+ "default_stage": "validate"
944
+ },
945
+ "cad_import_failed": {
946
+ "code": "INVALID_ARGUMENT",
947
+ "domain": "cad",
948
+ "failure_class": "execution",
949
+ "severity": "blocking_user_fixable",
950
+ "retryable": false,
951
+ "resolution_owner": "user",
952
+ "remediation_action": "change_input",
953
+ "default_stage": "execute"
954
+ },
955
+ "cad_model_recompute_failed": {
956
+ "code": "FAILED_PRECONDITION",
957
+ "domain": "cad",
958
+ "failure_class": "execution",
959
+ "severity": "blocking_user_fixable",
960
+ "retryable": false,
961
+ "resolution_owner": "user",
962
+ "remediation_action": "change_input",
963
+ "default_stage": "execute"
964
+ },
965
+ "cad_constraint_unsatisfied": {
966
+ "code": "FAILED_PRECONDITION",
967
+ "domain": "cad",
968
+ "failure_class": "execution",
969
+ "severity": "blocking_user_fixable",
970
+ "retryable": false,
971
+ "resolution_owner": "user",
972
+ "remediation_action": "change_input",
973
+ "default_stage": "execute"
974
+ },
975
+ "cad_geometry_invalid": {
976
+ "code": "INVALID_ARGUMENT",
977
+ "domain": "cad",
978
+ "failure_class": "validation",
979
+ "severity": "blocking_user_fixable",
980
+ "retryable": false,
981
+ "resolution_owner": "user",
982
+ "remediation_action": "change_input",
983
+ "default_stage": "validate"
984
+ },
985
+ "cad_null_shape": {
986
+ "code": "INVALID_ARGUMENT",
987
+ "domain": "cad",
988
+ "failure_class": "execution",
989
+ "severity": "blocking_user_fixable",
990
+ "retryable": false,
991
+ "resolution_owner": "user",
992
+ "remediation_action": "change_input",
993
+ "default_stage": "execute"
994
+ },
995
+ "cad_boolean_failed": {
996
+ "code": "FAILED_PRECONDITION",
997
+ "domain": "cad",
998
+ "failure_class": "execution",
999
+ "severity": "blocking_user_fixable",
1000
+ "retryable": false,
1001
+ "resolution_owner": "user",
1002
+ "remediation_action": "change_input",
1003
+ "default_stage": "execute"
1004
+ },
1005
+ "cad_kernel_failed": {
1006
+ "code": "INTERNAL",
1007
+ "domain": "cad",
1008
+ "failure_class": "internal",
1009
+ "severity": "blocking_internal",
1010
+ "retryable": false,
1011
+ "resolution_owner": "unknown",
1012
+ "remediation_action": "inspect_platform",
1013
+ "default_stage": "execute"
1014
+ },
1015
+ "cad_script_failed": {
1016
+ "code": "INVALID_ARGUMENT",
1017
+ "domain": "cad",
1018
+ "failure_class": "execution",
1019
+ "severity": "blocking_user_fixable",
1020
+ "retryable": false,
1021
+ "resolution_owner": "user",
1022
+ "remediation_action": "change_input",
1023
+ "default_stage": "execute"
1024
+ },
1025
+ "cad_export_format_unsupported": {
1026
+ "code": "INVALID_ARGUMENT",
1027
+ "domain": "cad",
1028
+ "failure_class": "validation",
1029
+ "severity": "blocking_user_fixable",
1030
+ "retryable": false,
1031
+ "resolution_owner": "user",
1032
+ "remediation_action": "change_input",
1033
+ "default_stage": "validate"
1034
+ },
1035
+ "cad_export_failed": {
1036
+ "code": "INTERNAL",
1037
+ "domain": "cad",
1038
+ "failure_class": "internal",
1039
+ "severity": "blocking_internal",
1040
+ "retryable": false,
1041
+ "resolution_owner": "unknown",
1042
+ "remediation_action": "inspect_platform",
1043
+ "default_stage": "transform"
1044
+ },
1045
+ "cad_output_missing": {
1046
+ "code": "DATA_LOSS",
1047
+ "domain": "cad",
1048
+ "failure_class": "internal",
1049
+ "severity": "blocking_internal",
1050
+ "retryable": false,
1051
+ "resolution_owner": "unknown",
1052
+ "remediation_action": "inspect_platform",
1053
+ "default_stage": "resolve"
1054
+ },
1055
+ "cad_output_invalid": {
1056
+ "code": "DATA_LOSS",
1057
+ "domain": "cad",
1058
+ "failure_class": "data_integrity",
1059
+ "severity": "blocking_internal",
1060
+ "retryable": false,
1061
+ "resolution_owner": "unknown",
1062
+ "remediation_action": "inspect_platform",
1063
+ "default_stage": "validate"
1064
+ },
1065
+ "cad_render_engine_unavailable": {
1066
+ "code": "FAILED_PRECONDITION",
1067
+ "domain": "cad",
1068
+ "failure_class": "availability",
1069
+ "severity": "blocking_user_fixable",
1070
+ "retryable": false,
1071
+ "resolution_owner": "user",
1072
+ "remediation_action": "change_configuration",
1073
+ "default_stage": "execute"
1074
+ },
1075
+ "cad_gpu_unavailable": {
1076
+ "code": "FAILED_PRECONDITION",
1077
+ "domain": "cad",
1078
+ "failure_class": "availability",
1079
+ "severity": "blocking_user_fixable",
1080
+ "retryable": false,
1081
+ "resolution_owner": "user",
1082
+ "remediation_action": "change_configuration",
1083
+ "default_stage": "execute"
1084
+ },
1085
+ "cad_render_failed": {
1086
+ "code": "INTERNAL",
1087
+ "domain": "cad",
1088
+ "failure_class": "internal",
1089
+ "severity": "blocking_internal",
1090
+ "retryable": false,
1091
+ "resolution_owner": "unknown",
1092
+ "remediation_action": "inspect_platform",
1093
+ "default_stage": "execute"
1094
+ },
1095
+ "cad_memory_exhausted": {
1096
+ "code": "RESOURCE_EXHAUSTED",
1097
+ "domain": "cad",
1098
+ "failure_class": "capacity",
1099
+ "severity": "blocking_user_fixable",
1100
+ "retryable": false,
1101
+ "resolution_owner": "user",
1102
+ "remediation_action": "change_configuration",
1103
+ "default_stage": "execute"
1104
+ },
1105
+ "cad_process_crashed": {
1106
+ "code": "INTERNAL",
1107
+ "domain": "cad",
1108
+ "failure_class": "internal",
1109
+ "severity": "blocking_internal",
1110
+ "retryable": false,
1111
+ "resolution_owner": "unknown",
1112
+ "remediation_action": "inspect_platform",
1113
+ "default_stage": "execute"
1114
+ },
1115
+ "cad_warning_escalated": {
1116
+ "code": "FAILED_PRECONDITION",
1117
+ "domain": "cad",
1118
+ "failure_class": "execution",
1119
+ "severity": "blocking_user_fixable",
1120
+ "retryable": false,
1121
+ "resolution_owner": "user",
1122
+ "remediation_action": "change_input",
1123
+ "default_stage": "execute"
1124
+ },
1125
+ "policy_blocked": {
1126
+ "code": "PERMISSION_DENIED",
1127
+ "domain": "policy",
1128
+ "failure_class": "authorization",
1129
+ "severity": "policy_blocking",
1130
+ "retryable": false,
1131
+ "resolution_owner": "policy",
1132
+ "remediation_action": "none",
1133
+ "default_stage": "execute"
1134
+ },
1135
+ "copyright_blocked": {
1136
+ "code": "PERMISSION_DENIED",
1137
+ "domain": "policy",
1138
+ "failure_class": "authorization",
1139
+ "severity": "policy_blocking",
1140
+ "retryable": false,
1141
+ "resolution_owner": "policy",
1142
+ "remediation_action": "none",
1143
+ "default_stage": "execute"
1144
+ },
1145
+ "persistence_failed": {
1146
+ "code": "INTERNAL",
1147
+ "domain": "persistence",
1148
+ "failure_class": "persistence",
1149
+ "severity": "blocking_internal",
1150
+ "retryable": false,
1151
+ "resolution_owner": "agentsam",
1152
+ "remediation_action": "inspect_platform",
1153
+ "default_stage": "persist"
1154
+ },
1155
+ "data_corrupt": {
1156
+ "code": "DATA_LOSS",
1157
+ "domain": "persistence",
1158
+ "failure_class": "data_integrity",
1159
+ "severity": "blocking_internal",
1160
+ "retryable": false,
1161
+ "resolution_owner": "agentsam",
1162
+ "remediation_action": "inspect_platform",
1163
+ "default_stage": "persist"
1164
+ },
1165
+ "data_loss": {
1166
+ "code": "DATA_LOSS",
1167
+ "domain": "persistence",
1168
+ "failure_class": "data_integrity",
1169
+ "severity": "blocking_internal",
1170
+ "retryable": false,
1171
+ "resolution_owner": "agentsam",
1172
+ "remediation_action": "inspect_platform",
1173
+ "default_stage": "persist"
1174
+ },
1175
+ "internal": {
1176
+ "code": "INTERNAL",
1177
+ "domain": "runtime",
1178
+ "failure_class": "internal",
1179
+ "severity": "blocking_internal",
1180
+ "retryable": false,
1181
+ "resolution_owner": "agentsam",
1182
+ "remediation_action": "inspect_platform",
1183
+ "default_stage": "execute"
1184
+ },
1185
+ "internal_invariant_violation": {
1186
+ "code": "INTERNAL",
1187
+ "domain": "runtime",
1188
+ "failure_class": "internal",
1189
+ "severity": "blocking_internal",
1190
+ "retryable": false,
1191
+ "resolution_owner": "agentsam",
1192
+ "remediation_action": "inspect_platform",
1193
+ "default_stage": "execute"
1194
+ },
1195
+ "internal_configuration_invalid": {
1196
+ "code": "INTERNAL",
1197
+ "domain": "runtime",
1198
+ "failure_class": "validation",
1199
+ "severity": "blocking_internal",
1200
+ "retryable": false,
1201
+ "resolution_owner": "agentsam",
1202
+ "remediation_action": "inspect_platform",
1203
+ "default_stage": "validate"
1204
+ },
1205
+ "internal_contract_violation": {
1206
+ "code": "INTERNAL",
1207
+ "domain": "runtime",
1208
+ "failure_class": "internal",
1209
+ "severity": "blocking_internal",
1210
+ "retryable": false,
1211
+ "resolution_owner": "agentsam",
1212
+ "remediation_action": "inspect_platform",
1213
+ "default_stage": "execute"
1214
+ },
1215
+ "internal_adapter_failed": {
1216
+ "code": "INTERNAL",
1217
+ "domain": "runtime",
1218
+ "failure_class": "internal",
1219
+ "severity": "blocking_internal",
1220
+ "retryable": false,
1221
+ "resolution_owner": "agentsam",
1222
+ "remediation_action": "inspect_platform",
1223
+ "default_stage": "execute"
1224
+ },
1225
+ "internal_dependency_failed": {
1226
+ "code": "INTERNAL",
1227
+ "domain": "runtime",
1228
+ "failure_class": "dependency",
1229
+ "severity": "blocking_internal",
1230
+ "retryable": false,
1231
+ "resolution_owner": "agentsam",
1232
+ "remediation_action": "inspect_platform",
1233
+ "default_stage": "execute"
1234
+ },
1235
+ "hook_definition_invalid": {
1236
+ "code": "INVALID_ARGUMENT",
1237
+ "domain": "hook",
1238
+ "failure_class": "validation",
1239
+ "severity": "blocking_user_fixable",
1240
+ "retryable": false,
1241
+ "resolution_owner": "user",
1242
+ "remediation_action": "change_configuration",
1243
+ "default_stage": "validate"
1244
+ },
1245
+ "hook_duplicate_id": {
1246
+ "code": "ALREADY_EXISTS",
1247
+ "domain": "hook",
1248
+ "failure_class": "conflict",
1249
+ "severity": "blocking_user_fixable",
1250
+ "retryable": false,
1251
+ "resolution_owner": "user",
1252
+ "remediation_action": "change_configuration",
1253
+ "default_stage": "validate"
1254
+ },
1255
+ "hook_not_found": {
1256
+ "code": "NOT_FOUND",
1257
+ "domain": "hook",
1258
+ "failure_class": "availability",
1259
+ "severity": "blocking_user_fixable",
1260
+ "retryable": false,
1261
+ "resolution_owner": "user",
1262
+ "remediation_action": "change_configuration",
1263
+ "default_stage": "validate"
1264
+ },
1265
+ "hook_disabled": {
1266
+ "code": "FAILED_PRECONDITION",
1267
+ "domain": "hook",
1268
+ "failure_class": "configuration",
1269
+ "severity": "blocking_user_fixable",
1270
+ "retryable": false,
1271
+ "resolution_owner": "user",
1272
+ "remediation_action": "change_configuration",
1273
+ "default_stage": "validate"
1274
+ },
1275
+ "hook_event_unsupported": {
1276
+ "code": "UNIMPLEMENTED",
1277
+ "domain": "hook",
1278
+ "failure_class": "protocol",
1279
+ "severity": "blocking_user_fixable",
1280
+ "retryable": false,
1281
+ "resolution_owner": "user",
1282
+ "remediation_action": "change_configuration",
1283
+ "default_stage": "validate"
1284
+ },
1285
+ "hook_configuration_invalid": {
1286
+ "code": "INVALID_ARGUMENT",
1287
+ "domain": "hook",
1288
+ "failure_class": "configuration",
1289
+ "severity": "blocking_user_fixable",
1290
+ "retryable": false,
1291
+ "resolution_owner": "user",
1292
+ "remediation_action": "change_configuration",
1293
+ "default_stage": "validate"
1294
+ },
1295
+ "hook_adapter_unknown": {
1296
+ "code": "UNIMPLEMENTED",
1297
+ "domain": "hook",
1298
+ "failure_class": "configuration",
1299
+ "severity": "blocking_user_fixable",
1300
+ "retryable": false,
1301
+ "resolution_owner": "user",
1302
+ "remediation_action": "change_configuration",
1303
+ "default_stage": "validate"
1304
+ },
1305
+ "hook_adapter_unavailable": {
1306
+ "code": "UNAVAILABLE",
1307
+ "domain": "hook",
1308
+ "failure_class": "availability",
1309
+ "severity": "transient",
1310
+ "retryable": true,
1311
+ "resolution_owner": "user",
1312
+ "remediation_action": "reconnect_service",
1313
+ "default_stage": "connect"
1314
+ },
1315
+ "hook_handler_unavailable": {
1316
+ "code": "FAILED_PRECONDITION",
1317
+ "domain": "hook",
1318
+ "failure_class": "availability",
1319
+ "severity": "blocking_user_fixable",
1320
+ "retryable": false,
1321
+ "resolution_owner": "user",
1322
+ "remediation_action": "change_configuration",
1323
+ "default_stage": "validate"
1324
+ },
1325
+ "hook_handler_timeout": {
1326
+ "code": "DEADLINE_EXCEEDED",
1327
+ "domain": "hook",
1328
+ "failure_class": "timeout",
1329
+ "severity": "transient",
1330
+ "retryable": true,
1331
+ "resolution_owner": "user",
1332
+ "remediation_action": "retry_later",
1333
+ "default_stage": "execute"
1334
+ },
1335
+ "hook_handler_failed": {
1336
+ "code": "INTERNAL",
1337
+ "domain": "hook",
1338
+ "failure_class": "execution",
1339
+ "severity": "blocking_internal",
1340
+ "retryable": false,
1341
+ "resolution_owner": "agentsam",
1342
+ "remediation_action": "inspect_platform",
1343
+ "default_stage": "execute"
1344
+ },
1345
+ "hook_output_invalid": {
1346
+ "code": "INVALID_ARGUMENT",
1347
+ "domain": "hook",
1348
+ "failure_class": "protocol",
1349
+ "severity": "blocking_user_fixable",
1350
+ "retryable": false,
1351
+ "resolution_owner": "user",
1352
+ "remediation_action": "change_configuration",
1353
+ "default_stage": "validate"
1354
+ },
1355
+ "hook_output_limit_exceeded": {
1356
+ "code": "RESOURCE_EXHAUSTED",
1357
+ "domain": "hook",
1358
+ "failure_class": "capacity",
1359
+ "severity": "blocking_user_fixable",
1360
+ "retryable": false,
1361
+ "resolution_owner": "user",
1362
+ "remediation_action": "change_configuration",
1363
+ "default_stage": "validate"
1364
+ },
1365
+ "hook_output_field_unsupported": {
1366
+ "code": "INVALID_ARGUMENT",
1367
+ "domain": "hook",
1368
+ "failure_class": "protocol",
1369
+ "severity": "blocking_user_fixable",
1370
+ "retryable": false,
1371
+ "resolution_owner": "user",
1372
+ "remediation_action": "change_configuration",
1373
+ "default_stage": "validate"
1374
+ },
1375
+ "hook_http_timeout": {
1376
+ "code": "DEADLINE_EXCEEDED",
1377
+ "domain": "hook",
1378
+ "failure_class": "timeout",
1379
+ "severity": "transient",
1380
+ "retryable": true,
1381
+ "resolution_owner": "user",
1382
+ "remediation_action": "retry_later",
1383
+ "default_stage": "execute"
1384
+ },
1385
+ "hook_http_request_failed": {
1386
+ "code": "UNAVAILABLE",
1387
+ "domain": "hook",
1388
+ "failure_class": "transport",
1389
+ "severity": "transient",
1390
+ "retryable": true,
1391
+ "resolution_owner": "provider",
1392
+ "remediation_action": "retry_later",
1393
+ "default_stage": "execute"
1394
+ },
1395
+ "hook_http_response_invalid": {
1396
+ "code": "DATA_LOSS",
1397
+ "domain": "hook",
1398
+ "failure_class": "protocol",
1399
+ "severity": "blocking_internal",
1400
+ "retryable": false,
1401
+ "resolution_owner": "agentsam",
1402
+ "remediation_action": "inspect_platform",
1403
+ "default_stage": "transform"
1404
+ },
1405
+ "hook_http_response_limit_exceeded": {
1406
+ "code": "RESOURCE_EXHAUSTED",
1407
+ "domain": "hook",
1408
+ "failure_class": "capacity",
1409
+ "severity": "blocking_user_fixable",
1410
+ "retryable": false,
1411
+ "resolution_owner": "user",
1412
+ "remediation_action": "change_configuration",
1413
+ "default_stage": "transform"
1414
+ },
1415
+ "hook_http_protocol_unsupported": {
1416
+ "code": "UNIMPLEMENTED",
1417
+ "domain": "hook",
1418
+ "failure_class": "protocol",
1419
+ "severity": "blocking_user_fixable",
1420
+ "retryable": false,
1421
+ "resolution_owner": "user",
1422
+ "remediation_action": "change_configuration",
1423
+ "default_stage": "validate"
1424
+ },
1425
+ "hook_http_credentials_forbidden": {
1426
+ "code": "INVALID_ARGUMENT",
1427
+ "domain": "hook",
1428
+ "failure_class": "policy",
1429
+ "severity": "blocking_user_fixable",
1430
+ "retryable": false,
1431
+ "resolution_owner": "policy",
1432
+ "remediation_action": "none",
1433
+ "default_stage": "authorize"
1434
+ },
1435
+ "hook_mcp_timeout": {
1436
+ "code": "DEADLINE_EXCEEDED",
1437
+ "domain": "hook",
1438
+ "failure_class": "timeout",
1439
+ "severity": "transient",
1440
+ "retryable": true,
1441
+ "resolution_owner": "user",
1442
+ "remediation_action": "retry_later",
1443
+ "default_stage": "execute"
1444
+ },
1445
+ "hook_mcp_server_unavailable": {
1446
+ "code": "UNAVAILABLE",
1447
+ "domain": "hook",
1448
+ "failure_class": "availability",
1449
+ "severity": "transient",
1450
+ "retryable": true,
1451
+ "resolution_owner": "user",
1452
+ "remediation_action": "restart_service",
1453
+ "default_stage": "connect"
1454
+ },
1455
+ "hook_mcp_capability_missing": {
1456
+ "code": "NOT_FOUND",
1457
+ "domain": "hook",
1458
+ "failure_class": "availability",
1459
+ "severity": "blocking_user_fixable",
1460
+ "retryable": false,
1461
+ "resolution_owner": "user",
1462
+ "remediation_action": "change_configuration",
1463
+ "default_stage": "validate"
1464
+ },
1465
+ "hook_mcp_capability_duplicate": {
1466
+ "code": "ALREADY_EXISTS",
1467
+ "domain": "hook",
1468
+ "failure_class": "conflict",
1469
+ "severity": "blocking_user_fixable",
1470
+ "retryable": false,
1471
+ "resolution_owner": "user",
1472
+ "remediation_action": "change_configuration",
1473
+ "default_stage": "validate"
1474
+ },
1475
+ "hook_mcp_response_invalid": {
1476
+ "code": "DATA_LOSS",
1477
+ "domain": "hook",
1478
+ "failure_class": "protocol",
1479
+ "severity": "blocking_internal",
1480
+ "retryable": false,
1481
+ "resolution_owner": "agentsam",
1482
+ "remediation_action": "inspect_platform",
1483
+ "default_stage": "transform"
1484
+ },
1485
+ "hook_mcp_transport_failed": {
1486
+ "code": "UNAVAILABLE",
1487
+ "domain": "hook",
1488
+ "failure_class": "transport",
1489
+ "severity": "transient",
1490
+ "retryable": true,
1491
+ "resolution_owner": "user",
1492
+ "remediation_action": "reconnect_service",
1493
+ "default_stage": "connect"
1494
+ },
1495
+ "hook_lsp_timeout": {
1496
+ "code": "DEADLINE_EXCEEDED",
1497
+ "domain": "hook",
1498
+ "failure_class": "timeout",
1499
+ "severity": "transient",
1500
+ "retryable": true,
1501
+ "resolution_owner": "user",
1502
+ "remediation_action": "retry_later",
1503
+ "default_stage": "execute"
1504
+ },
1505
+ "hook_lsp_server_unavailable": {
1506
+ "code": "UNAVAILABLE",
1507
+ "domain": "hook",
1508
+ "failure_class": "availability",
1509
+ "severity": "transient",
1510
+ "retryable": true,
1511
+ "resolution_owner": "user",
1512
+ "remediation_action": "restart_service",
1513
+ "default_stage": "connect"
1514
+ },
1515
+ "hook_lsp_language_required": {
1516
+ "code": "INVALID_ARGUMENT",
1517
+ "domain": "hook",
1518
+ "failure_class": "validation",
1519
+ "severity": "blocking_user_fixable",
1520
+ "retryable": false,
1521
+ "resolution_owner": "user",
1522
+ "remediation_action": "change_configuration",
1523
+ "default_stage": "validate"
1524
+ },
1525
+ "hook_lsp_capability_unsupported": {
1526
+ "code": "UNIMPLEMENTED",
1527
+ "domain": "hook",
1528
+ "failure_class": "protocol",
1529
+ "severity": "blocking_user_fixable",
1530
+ "retryable": false,
1531
+ "resolution_owner": "user",
1532
+ "remediation_action": "change_configuration",
1533
+ "default_stage": "validate"
1534
+ },
1535
+ "hook_lsp_initialize_failed": {
1536
+ "code": "UNAVAILABLE",
1537
+ "domain": "hook",
1538
+ "failure_class": "protocol",
1539
+ "severity": "transient",
1540
+ "retryable": true,
1541
+ "resolution_owner": "user",
1542
+ "remediation_action": "restart_service",
1543
+ "default_stage": "start"
1544
+ },
1545
+ "hook_lsp_response_invalid": {
1546
+ "code": "DATA_LOSS",
1547
+ "domain": "hook",
1548
+ "failure_class": "protocol",
1549
+ "severity": "blocking_internal",
1550
+ "retryable": false,
1551
+ "resolution_owner": "agentsam",
1552
+ "remediation_action": "inspect_platform",
1553
+ "default_stage": "transform"
1554
+ },
1555
+ "hook_command_required": {
1556
+ "code": "INVALID_ARGUMENT",
1557
+ "domain": "hook",
1558
+ "failure_class": "validation",
1559
+ "severity": "blocking_user_fixable",
1560
+ "retryable": false,
1561
+ "resolution_owner": "user",
1562
+ "remediation_action": "change_configuration",
1563
+ "default_stage": "validate"
1564
+ },
1565
+ "hook_command_timeout": {
1566
+ "code": "DEADLINE_EXCEEDED",
1567
+ "domain": "hook",
1568
+ "failure_class": "timeout",
1569
+ "severity": "transient",
1570
+ "retryable": true,
1571
+ "resolution_owner": "user",
1572
+ "remediation_action": "retry_later",
1573
+ "default_stage": "execute"
1574
+ },
1575
+ "hook_command_spawn_failed": {
1576
+ "code": "FAILED_PRECONDITION",
1577
+ "domain": "hook",
1578
+ "failure_class": "process",
1579
+ "severity": "blocking_user_fixable",
1580
+ "retryable": false,
1581
+ "resolution_owner": "user",
1582
+ "remediation_action": "change_configuration",
1583
+ "default_stage": "validate"
1584
+ },
1585
+ "hook_command_exit_nonzero": {
1586
+ "code": "FAILED_PRECONDITION",
1587
+ "domain": "hook",
1588
+ "failure_class": "process",
1589
+ "severity": "blocking_user_fixable",
1590
+ "retryable": false,
1591
+ "resolution_owner": "user",
1592
+ "remediation_action": "change_configuration",
1593
+ "default_stage": "validate"
1594
+ },
1595
+ "hook_command_output_limit_exceeded": {
1596
+ "code": "RESOURCE_EXHAUSTED",
1597
+ "domain": "hook",
1598
+ "failure_class": "capacity",
1599
+ "severity": "blocking_user_fixable",
1600
+ "retryable": false,
1601
+ "resolution_owner": "user",
1602
+ "remediation_action": "change_configuration",
1603
+ "default_stage": "validate"
1604
+ },
1605
+ "hook_command_output_invalid": {
1606
+ "code": "DATA_LOSS",
1607
+ "domain": "hook",
1608
+ "failure_class": "protocol",
1609
+ "severity": "blocking_internal",
1610
+ "retryable": false,
1611
+ "resolution_owner": "agentsam",
1612
+ "remediation_action": "inspect_platform",
1613
+ "default_stage": "transform"
1614
+ },
1615
+ "hook_permission_denied": {
1616
+ "code": "PERMISSION_DENIED",
1617
+ "domain": "hook",
1618
+ "failure_class": "authorization",
1619
+ "severity": "policy_blocking",
1620
+ "retryable": false,
1621
+ "resolution_owner": "policy",
1622
+ "remediation_action": "request_permission",
1623
+ "default_stage": "authorize"
1624
+ },
1625
+ "hook_capability_unavailable": {
1626
+ "code": "NOT_FOUND",
1627
+ "domain": "hook",
1628
+ "failure_class": "availability",
1629
+ "severity": "blocking_user_fixable",
1630
+ "retryable": false,
1631
+ "resolution_owner": "user",
1632
+ "remediation_action": "change_configuration",
1633
+ "default_stage": "validate"
1634
+ },
1635
+ "hook_capability_duplicate": {
1636
+ "code": "ALREADY_EXISTS",
1637
+ "domain": "hook",
1638
+ "failure_class": "conflict",
1639
+ "severity": "blocking_user_fixable",
1640
+ "retryable": false,
1641
+ "resolution_owner": "user",
1642
+ "remediation_action": "change_configuration",
1643
+ "default_stage": "validate"
1644
+ },
1645
+ "hook_error_handling_invalid": {
1646
+ "code": "INVALID_ARGUMENT",
1647
+ "domain": "hook",
1648
+ "failure_class": "protocol",
1649
+ "severity": "blocking_user_fixable",
1650
+ "retryable": false,
1651
+ "resolution_owner": "user",
1652
+ "remediation_action": "change_configuration",
1653
+ "default_stage": "validate"
1654
+ },
1655
+ "hook_error_handling_unsupported": {
1656
+ "code": "UNIMPLEMENTED",
1657
+ "domain": "hook",
1658
+ "failure_class": "protocol",
1659
+ "severity": "blocking_user_fixable",
1660
+ "retryable": false,
1661
+ "resolution_owner": "user",
1662
+ "remediation_action": "change_configuration",
1663
+ "default_stage": "validate"
1664
+ },
1665
+ "hook_retry_limit_exceeded": {
1666
+ "code": "OUT_OF_RANGE",
1667
+ "domain": "hook",
1668
+ "failure_class": "validation",
1669
+ "severity": "blocking_user_fixable",
1670
+ "retryable": false,
1671
+ "resolution_owner": "user",
1672
+ "remediation_action": "change_configuration",
1673
+ "default_stage": "validate"
1674
+ },
1675
+ "hook_stop_decision_invalid": {
1676
+ "code": "INVALID_ARGUMENT",
1677
+ "domain": "hook",
1678
+ "failure_class": "protocol",
1679
+ "severity": "blocking_user_fixable",
1680
+ "retryable": false,
1681
+ "resolution_owner": "user",
1682
+ "remediation_action": "change_configuration",
1683
+ "default_stage": "validate"
1684
+ },
1685
+ "package_manifest_invalid": {
1686
+ "code": "INVALID_ARGUMENT",
1687
+ "domain": "package",
1688
+ "failure_class": "validation",
1689
+ "severity": "blocking_user_fixable",
1690
+ "retryable": false,
1691
+ "resolution_owner": "user",
1692
+ "remediation_action": "change_configuration",
1693
+ "default_stage": "validate"
1694
+ },
1695
+ "package_export_missing": {
1696
+ "code": "FAILED_PRECONDITION",
1697
+ "domain": "package",
1698
+ "failure_class": "configuration",
1699
+ "severity": "blocking_internal",
1700
+ "retryable": false,
1701
+ "resolution_owner": "agentsam",
1702
+ "remediation_action": "regenerate_artifact",
1703
+ "default_stage": "verify"
1704
+ },
1705
+ "package_file_missing": {
1706
+ "code": "NOT_FOUND",
1707
+ "domain": "package",
1708
+ "failure_class": "availability",
1709
+ "severity": "blocking_user_fixable",
1710
+ "retryable": false,
1711
+ "resolution_owner": "user",
1712
+ "remediation_action": "change_configuration",
1713
+ "default_stage": "verify"
1714
+ },
1715
+ "package_unwanted_file_included": {
1716
+ "code": "FAILED_PRECONDITION",
1717
+ "domain": "package",
1718
+ "failure_class": "distribution",
1719
+ "severity": "blocking_user_fixable",
1720
+ "retryable": false,
1721
+ "resolution_owner": "user",
1722
+ "remediation_action": "change_configuration",
1723
+ "default_stage": "verify"
1724
+ },
1725
+ "package_dependency_missing": {
1726
+ "code": "FAILED_PRECONDITION",
1727
+ "domain": "package",
1728
+ "failure_class": "dependency",
1729
+ "severity": "blocking_user_fixable",
1730
+ "retryable": false,
1731
+ "resolution_owner": "user",
1732
+ "remediation_action": "install_dependency",
1733
+ "default_stage": "resolve"
1734
+ },
1735
+ "package_dependency_version_mismatch": {
1736
+ "code": "FAILED_PRECONDITION",
1737
+ "domain": "package",
1738
+ "failure_class": "dependency",
1739
+ "severity": "blocking_user_fixable",
1740
+ "retryable": false,
1741
+ "resolution_owner": "user",
1742
+ "remediation_action": "upgrade_dependency",
1743
+ "default_stage": "resolve"
1744
+ },
1745
+ "lockfile_missing": {
1746
+ "code": "FAILED_PRECONDITION",
1747
+ "domain": "package",
1748
+ "failure_class": "dependency",
1749
+ "severity": "blocking_user_fixable",
1750
+ "retryable": false,
1751
+ "resolution_owner": "user",
1752
+ "remediation_action": "update_lockfile",
1753
+ "default_stage": "install"
1754
+ },
1755
+ "lockfile_stale": {
1756
+ "code": "FAILED_PRECONDITION",
1757
+ "domain": "package",
1758
+ "failure_class": "dependency",
1759
+ "severity": "blocking_user_fixable",
1760
+ "retryable": false,
1761
+ "resolution_owner": "user",
1762
+ "remediation_action": "update_lockfile",
1763
+ "default_stage": "install"
1764
+ },
1765
+ "lockfile_incompatible": {
1766
+ "code": "FAILED_PRECONDITION",
1767
+ "domain": "package",
1768
+ "failure_class": "dependency",
1769
+ "severity": "blocking_user_fixable",
1770
+ "retryable": false,
1771
+ "resolution_owner": "user",
1772
+ "remediation_action": "update_lockfile",
1773
+ "default_stage": "install"
1774
+ },
1775
+ "workspace_not_installed": {
1776
+ "code": "FAILED_PRECONDITION",
1777
+ "domain": "build",
1778
+ "failure_class": "dependency",
1779
+ "severity": "blocking_user_fixable",
1780
+ "retryable": false,
1781
+ "resolution_owner": "user",
1782
+ "remediation_action": "reinstall_workspace",
1783
+ "default_stage": "build"
1784
+ },
1785
+ "workspace_resolution_failed": {
1786
+ "code": "FAILED_PRECONDITION",
1787
+ "domain": "build",
1788
+ "failure_class": "dependency",
1789
+ "severity": "blocking_user_fixable",
1790
+ "retryable": false,
1791
+ "resolution_owner": "user",
1792
+ "remediation_action": "reinstall_workspace",
1793
+ "default_stage": "resolve"
1794
+ },
1795
+ "workspace_boundary_invalid": {
1796
+ "code": "FAILED_PRECONDITION",
1797
+ "domain": "build",
1798
+ "failure_class": "configuration",
1799
+ "severity": "blocking_user_fixable",
1800
+ "retryable": false,
1801
+ "resolution_owner": "user",
1802
+ "remediation_action": "change_configuration",
1803
+ "default_stage": "validate"
1804
+ },
1805
+ "build_dependency_missing": {
1806
+ "code": "FAILED_PRECONDITION",
1807
+ "domain": "build",
1808
+ "failure_class": "dependency",
1809
+ "severity": "blocking_user_fixable",
1810
+ "retryable": false,
1811
+ "resolution_owner": "user",
1812
+ "remediation_action": "install_dependency",
1813
+ "default_stage": "build"
1814
+ },
1815
+ "build_failed": {
1816
+ "code": "INTERNAL",
1817
+ "domain": "build",
1818
+ "failure_class": "build",
1819
+ "severity": "blocking_internal",
1820
+ "retryable": false,
1821
+ "resolution_owner": "agentsam",
1822
+ "remediation_action": "inspect_platform",
1823
+ "default_stage": "build"
1824
+ },
1825
+ "build_output_missing": {
1826
+ "code": "DATA_LOSS",
1827
+ "domain": "build",
1828
+ "failure_class": "build",
1829
+ "severity": "blocking_internal",
1830
+ "retryable": false,
1831
+ "resolution_owner": "agentsam",
1832
+ "remediation_action": "regenerate_artifact",
1833
+ "default_stage": "verify"
1834
+ },
1835
+ "build_output_stale": {
1836
+ "code": "FAILED_PRECONDITION",
1837
+ "domain": "build",
1838
+ "failure_class": "build",
1839
+ "severity": "blocking_internal",
1840
+ "retryable": false,
1841
+ "resolution_owner": "agentsam",
1842
+ "remediation_action": "regenerate_artifact",
1843
+ "default_stage": "verify"
1844
+ },
1845
+ "pack_failed": {
1846
+ "code": "INTERNAL",
1847
+ "domain": "package",
1848
+ "failure_class": "distribution",
1849
+ "severity": "blocking_internal",
1850
+ "retryable": false,
1851
+ "resolution_owner": "agentsam",
1852
+ "remediation_action": "inspect_platform",
1853
+ "default_stage": "publish"
1854
+ },
1855
+ "pack_contents_invalid": {
1856
+ "code": "FAILED_PRECONDITION",
1857
+ "domain": "package",
1858
+ "failure_class": "distribution",
1859
+ "severity": "blocking_user_fixable",
1860
+ "retryable": false,
1861
+ "resolution_owner": "user",
1862
+ "remediation_action": "change_configuration",
1863
+ "default_stage": "verify"
1864
+ },
1865
+ "pack_provenance_violation": {
1866
+ "code": "PERMISSION_DENIED",
1867
+ "domain": "package",
1868
+ "failure_class": "policy",
1869
+ "severity": "policy_blocking",
1870
+ "retryable": false,
1871
+ "resolution_owner": "policy",
1872
+ "remediation_action": "none",
1873
+ "default_stage": "verify"
1874
+ },
1875
+ "distribution_artifact_missing": {
1876
+ "code": "NOT_FOUND",
1877
+ "domain": "distribution",
1878
+ "failure_class": "distribution",
1879
+ "severity": "blocking_internal",
1880
+ "retryable": false,
1881
+ "resolution_owner": "agentsam",
1882
+ "remediation_action": "republish_artifact",
1883
+ "default_stage": "publish"
1884
+ },
1885
+ "distribution_identity_mismatch": {
1886
+ "code": "FAILED_PRECONDITION",
1887
+ "domain": "distribution",
1888
+ "failure_class": "identity",
1889
+ "severity": "blocking_internal",
1890
+ "retryable": false,
1891
+ "resolution_owner": "agentsam",
1892
+ "remediation_action": "republish_artifact",
1893
+ "default_stage": "verify"
1894
+ },
1895
+ "distribution_version_mismatch": {
1896
+ "code": "FAILED_PRECONDITION",
1897
+ "domain": "distribution",
1898
+ "failure_class": "conflict",
1899
+ "severity": "blocking_internal",
1900
+ "retryable": false,
1901
+ "resolution_owner": "agentsam",
1902
+ "remediation_action": "republish_artifact",
1903
+ "default_stage": "verify"
1904
+ },
1905
+ "distribution_install_failed": {
1906
+ "code": "FAILED_PRECONDITION",
1907
+ "domain": "distribution",
1908
+ "failure_class": "distribution",
1909
+ "severity": "blocking_user_fixable",
1910
+ "retryable": false,
1911
+ "resolution_owner": "user",
1912
+ "remediation_action": "reinstall_workspace",
1913
+ "default_stage": "install"
1914
+ },
1915
+ "distribution_smoke_failed": {
1916
+ "code": "FAILED_PRECONDITION",
1917
+ "domain": "distribution",
1918
+ "failure_class": "distribution",
1919
+ "severity": "blocking_internal",
1920
+ "retryable": false,
1921
+ "resolution_owner": "agentsam",
1922
+ "remediation_action": "inspect_platform",
1923
+ "default_stage": "verify"
1924
+ },
1925
+ "release_train_misaligned": {
1926
+ "code": "FAILED_PRECONDITION",
1927
+ "domain": "distribution",
1928
+ "failure_class": "conflict",
1929
+ "severity": "blocking_user_fixable",
1930
+ "retryable": false,
1931
+ "resolution_owner": "user",
1932
+ "remediation_action": "change_configuration",
1933
+ "default_stage": "verify"
1934
+ },
1935
+ "published_artifact_stale": {
1936
+ "code": "FAILED_PRECONDITION",
1937
+ "domain": "distribution",
1938
+ "failure_class": "distribution",
1939
+ "severity": "blocking_internal",
1940
+ "retryable": false,
1941
+ "resolution_owner": "agentsam",
1942
+ "remediation_action": "republish_artifact",
1943
+ "default_stage": "verify"
1944
+ },
1945
+ "published_artifact_missing": {
1946
+ "code": "NOT_FOUND",
1947
+ "domain": "distribution",
1948
+ "failure_class": "distribution",
1949
+ "severity": "blocking_internal",
1950
+ "retryable": false,
1951
+ "resolution_owner": "agentsam",
1952
+ "remediation_action": "republish_artifact",
1953
+ "default_stage": "discover"
1954
+ },
1955
+ "schema_invalid": {
1956
+ "code": "INVALID_ARGUMENT",
1957
+ "domain": "schema",
1958
+ "failure_class": "schema",
1959
+ "severity": "blocking_user_fixable",
1960
+ "retryable": false,
1961
+ "resolution_owner": "user",
1962
+ "remediation_action": "change_input",
1963
+ "default_stage": "validate"
1964
+ },
1965
+ "schema_version_unsupported": {
1966
+ "code": "UNIMPLEMENTED",
1967
+ "domain": "schema",
1968
+ "failure_class": "schema",
1969
+ "severity": "blocking_user_fixable",
1970
+ "retryable": false,
1971
+ "resolution_owner": "user",
1972
+ "remediation_action": "upgrade_dependency",
1973
+ "default_stage": "validate"
1974
+ },
1975
+ "schema_contract_mismatch": {
1976
+ "code": "FAILED_PRECONDITION",
1977
+ "domain": "schema",
1978
+ "failure_class": "schema",
1979
+ "severity": "blocking_user_fixable",
1980
+ "retryable": false,
1981
+ "resolution_owner": "user",
1982
+ "remediation_action": "change_configuration",
1983
+ "default_stage": "validate"
1984
+ },
1985
+ "schema_pack_missing": {
1986
+ "code": "NOT_FOUND",
1987
+ "domain": "schema",
1988
+ "failure_class": "schema",
1989
+ "severity": "blocking_user_fixable",
1990
+ "retryable": false,
1991
+ "resolution_owner": "user",
1992
+ "remediation_action": "install_dependency",
1993
+ "default_stage": "resolve"
1994
+ },
1995
+ "schema_pack_dependency_missing": {
1996
+ "code": "FAILED_PRECONDITION",
1997
+ "domain": "schema",
1998
+ "failure_class": "dependency",
1999
+ "severity": "blocking_user_fixable",
2000
+ "retryable": false,
2001
+ "resolution_owner": "user",
2002
+ "remediation_action": "install_dependency",
2003
+ "default_stage": "resolve"
2004
+ },
2005
+ "schema_pack_dependency_cycle": {
2006
+ "code": "FAILED_PRECONDITION",
2007
+ "domain": "schema",
2008
+ "failure_class": "dependency",
2009
+ "severity": "blocking_user_fixable",
2010
+ "retryable": false,
2011
+ "resolution_owner": "user",
2012
+ "remediation_action": "change_configuration",
2013
+ "default_stage": "resolve"
2014
+ },
2015
+ "schema_pack_ownership_conflict": {
2016
+ "code": "ABORTED",
2017
+ "domain": "schema",
2018
+ "failure_class": "conflict",
2019
+ "severity": "blocking_user_fixable",
2020
+ "retryable": false,
2021
+ "resolution_owner": "user",
2022
+ "remediation_action": "change_configuration",
2023
+ "default_stage": "validate"
2024
+ },
2025
+ "migration_missing": {
2026
+ "code": "NOT_FOUND",
2027
+ "domain": "migration",
2028
+ "failure_class": "migration",
2029
+ "severity": "blocking_user_fixable",
2030
+ "retryable": false,
2031
+ "resolution_owner": "user",
2032
+ "remediation_action": "run_migration",
2033
+ "default_stage": "migrate"
2034
+ },
2035
+ "migration_failed": {
2036
+ "code": "INTERNAL",
2037
+ "domain": "migration",
2038
+ "failure_class": "migration",
2039
+ "severity": "blocking_internal",
2040
+ "retryable": false,
2041
+ "resolution_owner": "agentsam",
2042
+ "remediation_action": "inspect_platform",
2043
+ "default_stage": "migrate"
2044
+ },
2045
+ "migration_checksum_mismatch": {
2046
+ "code": "DATA_LOSS",
2047
+ "domain": "migration",
2048
+ "failure_class": "data_integrity",
2049
+ "severity": "blocking_user_fixable",
2050
+ "retryable": false,
2051
+ "resolution_owner": "user",
2052
+ "remediation_action": "repair_schema",
2053
+ "default_stage": "verify"
2054
+ },
2055
+ "migration_order_invalid": {
2056
+ "code": "FAILED_PRECONDITION",
2057
+ "domain": "migration",
2058
+ "failure_class": "migration",
2059
+ "severity": "blocking_user_fixable",
2060
+ "retryable": false,
2061
+ "resolution_owner": "user",
2062
+ "remediation_action": "change_configuration",
2063
+ "default_stage": "migrate"
2064
+ },
2065
+ "migration_already_applied_conflict": {
2066
+ "code": "ALREADY_EXISTS",
2067
+ "domain": "migration",
2068
+ "failure_class": "conflict",
2069
+ "severity": "blocking_user_fixable",
2070
+ "retryable": false,
2071
+ "resolution_owner": "user",
2072
+ "remediation_action": "repair_schema",
2073
+ "default_stage": "migrate"
2074
+ },
2075
+ "migration_requires_manual_repair": {
2076
+ "code": "FAILED_PRECONDITION",
2077
+ "domain": "migration",
2078
+ "failure_class": "migration",
2079
+ "severity": "blocking_user_fixable",
2080
+ "retryable": false,
2081
+ "resolution_owner": "user",
2082
+ "remediation_action": "repair_schema",
2083
+ "default_stage": "migrate"
2084
+ },
2085
+ "database_unreachable": {
2086
+ "code": "UNAVAILABLE",
2087
+ "domain": "database",
2088
+ "failure_class": "availability",
2089
+ "severity": "transient",
2090
+ "retryable": true,
2091
+ "resolution_owner": "provider",
2092
+ "remediation_action": "reconnect_service",
2093
+ "default_stage": "connect"
2094
+ },
2095
+ "database_driver_unsupported": {
2096
+ "code": "UNIMPLEMENTED",
2097
+ "domain": "database",
2098
+ "failure_class": "dependency",
2099
+ "severity": "blocking_user_fixable",
2100
+ "retryable": false,
2101
+ "resolution_owner": "user",
2102
+ "remediation_action": "install_dependency",
2103
+ "default_stage": "connect"
2104
+ },
2105
+ "database_authority_unresolved": {
2106
+ "code": "FAILED_PRECONDITION",
2107
+ "domain": "database",
2108
+ "failure_class": "configuration",
2109
+ "severity": "blocking_user_fixable",
2110
+ "retryable": false,
2111
+ "resolution_owner": "user",
2112
+ "remediation_action": "change_configuration",
2113
+ "default_stage": "resolve"
2114
+ },
2115
+ "database_authorization_failed": {
2116
+ "code": "PERMISSION_DENIED",
2117
+ "domain": "database",
2118
+ "failure_class": "authorization",
2119
+ "severity": "blocking_user_fixable",
2120
+ "retryable": false,
2121
+ "resolution_owner": "user",
2122
+ "remediation_action": "request_permission",
2123
+ "default_stage": "authorize"
2124
+ },
2125
+ "database_schema_drift": {
2126
+ "code": "FAILED_PRECONDITION",
2127
+ "domain": "database",
2128
+ "failure_class": "schema",
2129
+ "severity": "blocking_user_fixable",
2130
+ "retryable": false,
2131
+ "resolution_owner": "user",
2132
+ "remediation_action": "run_migration",
2133
+ "default_stage": "validate"
2134
+ },
2135
+ "model_discovery_failed": {
2136
+ "code": "UNAVAILABLE",
2137
+ "domain": "model",
2138
+ "failure_class": "discovery",
2139
+ "severity": "transient",
2140
+ "retryable": true,
2141
+ "resolution_owner": "provider",
2142
+ "remediation_action": "retry_later",
2143
+ "default_stage": "discover"
2144
+ },
2145
+ "model_catalog_stale": {
2146
+ "code": "FAILED_PRECONDITION",
2147
+ "domain": "model",
2148
+ "failure_class": "discovery",
2149
+ "severity": "blocking_user_fixable",
2150
+ "retryable": false,
2151
+ "resolution_owner": "user",
2152
+ "remediation_action": "select_model",
2153
+ "default_stage": "discover"
2154
+ },
2155
+ "model_snapshot_missing": {
2156
+ "code": "NOT_FOUND",
2157
+ "domain": "model",
2158
+ "failure_class": "discovery",
2159
+ "severity": "blocking_user_fixable",
2160
+ "retryable": false,
2161
+ "resolution_owner": "user",
2162
+ "remediation_action": "select_model",
2163
+ "default_stage": "load"
2164
+ },
2165
+ "model_snapshot_stale": {
2166
+ "code": "FAILED_PRECONDITION",
2167
+ "domain": "model",
2168
+ "failure_class": "discovery",
2169
+ "severity": "blocking_user_fixable",
2170
+ "retryable": false,
2171
+ "resolution_owner": "user",
2172
+ "remediation_action": "select_model",
2173
+ "default_stage": "load"
2174
+ },
2175
+ "model_capability_unknown": {
2176
+ "code": "FAILED_PRECONDITION",
2177
+ "domain": "model",
2178
+ "failure_class": "configuration",
2179
+ "severity": "blocking_user_fixable",
2180
+ "retryable": false,
2181
+ "resolution_owner": "user",
2182
+ "remediation_action": "select_model",
2183
+ "default_stage": "validate"
2184
+ },
2185
+ "model_capability_unsupported": {
2186
+ "code": "UNIMPLEMENTED",
2187
+ "domain": "model",
2188
+ "failure_class": "validation",
2189
+ "severity": "blocking_user_fixable",
2190
+ "retryable": false,
2191
+ "resolution_owner": "user",
2192
+ "remediation_action": "select_model",
2193
+ "default_stage": "validate"
2194
+ },
2195
+ "model_provider_mismatch": {
2196
+ "code": "FAILED_PRECONDITION",
2197
+ "domain": "model",
2198
+ "failure_class": "configuration",
2199
+ "severity": "blocking_user_fixable",
2200
+ "retryable": false,
2201
+ "resolution_owner": "user",
2202
+ "remediation_action": "select_model",
2203
+ "default_stage": "resolve"
2204
+ },
2205
+ "model_identity_conflict": {
2206
+ "code": "ABORTED",
2207
+ "domain": "model",
2208
+ "failure_class": "identity",
2209
+ "severity": "blocking_user_fixable",
2210
+ "retryable": false,
2211
+ "resolution_owner": "user",
2212
+ "remediation_action": "select_model",
2213
+ "default_stage": "resolve"
2214
+ },
2215
+ "model_probe_failed": {
2216
+ "code": "UNAVAILABLE",
2217
+ "domain": "model",
2218
+ "failure_class": "discovery",
2219
+ "severity": "transient",
2220
+ "retryable": true,
2221
+ "resolution_owner": "provider",
2222
+ "remediation_action": "retry_later",
2223
+ "default_stage": "verify"
2224
+ },
2225
+ "model_probe_partial": {
2226
+ "code": "UNAVAILABLE",
2227
+ "domain": "model",
2228
+ "failure_class": "discovery",
2229
+ "severity": "transient",
2230
+ "retryable": true,
2231
+ "resolution_owner": "provider",
2232
+ "remediation_action": "retry_later",
2233
+ "default_stage": "verify"
2234
+ },
2235
+ "runtime_not_installed": {
2236
+ "code": "FAILED_PRECONDITION",
2237
+ "domain": "runtime",
2238
+ "failure_class": "dependency",
2239
+ "severity": "blocking_user_fixable",
2240
+ "retryable": false,
2241
+ "resolution_owner": "user",
2242
+ "remediation_action": "install_dependency",
2243
+ "default_stage": "install"
2244
+ },
2245
+ "runtime_not_running": {
2246
+ "code": "UNAVAILABLE",
2247
+ "domain": "runtime",
2248
+ "failure_class": "availability",
2249
+ "severity": "transient",
2250
+ "retryable": true,
2251
+ "resolution_owner": "user",
2252
+ "remediation_action": "restart_runtime",
2253
+ "default_stage": "connect"
2254
+ },
2255
+ "runtime_version_incompatible": {
2256
+ "code": "FAILED_PRECONDITION",
2257
+ "domain": "runtime",
2258
+ "failure_class": "dependency",
2259
+ "severity": "blocking_user_fixable",
2260
+ "retryable": false,
2261
+ "resolution_owner": "user",
2262
+ "remediation_action": "upgrade_dependency",
2263
+ "default_stage": "validate"
2264
+ },
2265
+ "runtime_capability_missing": {
2266
+ "code": "FAILED_PRECONDITION",
2267
+ "domain": "runtime",
2268
+ "failure_class": "configuration",
2269
+ "severity": "blocking_user_fixable",
2270
+ "retryable": false,
2271
+ "resolution_owner": "user",
2272
+ "remediation_action": "change_configuration",
2273
+ "default_stage": "validate"
2274
+ },
2275
+ "runtime_protocol_mismatch": {
2276
+ "code": "FAILED_PRECONDITION",
2277
+ "domain": "runtime",
2278
+ "failure_class": "protocol",
2279
+ "severity": "blocking_user_fixable",
2280
+ "retryable": false,
2281
+ "resolution_owner": "user",
2282
+ "remediation_action": "upgrade_dependency",
2283
+ "default_stage": "connect"
2284
+ },
2285
+ "runtime_connection_unresolved": {
2286
+ "code": "UNAVAILABLE",
2287
+ "domain": "runtime",
2288
+ "failure_class": "transport",
2289
+ "severity": "transient",
2290
+ "retryable": true,
2291
+ "resolution_owner": "user",
2292
+ "remediation_action": "reconnect_service",
2293
+ "default_stage": "connect"
2294
+ },
2295
+ "runtime_connection_revoked": {
2296
+ "code": "PERMISSION_DENIED",
2297
+ "domain": "runtime",
2298
+ "failure_class": "authorization",
2299
+ "severity": "blocking_user_fixable",
2300
+ "retryable": false,
2301
+ "resolution_owner": "user",
2302
+ "remediation_action": "reenroll_device",
2303
+ "default_stage": "authorize"
2304
+ },
2305
+ "pty_create_failed": {
2306
+ "code": "INTERNAL",
2307
+ "domain": "terminal",
2308
+ "failure_class": "process",
2309
+ "severity": "blocking_internal",
2310
+ "retryable": false,
2311
+ "resolution_owner": "agentsam",
2312
+ "remediation_action": "inspect_platform",
2313
+ "default_stage": "start"
2314
+ },
2315
+ "pty_attach_failed": {
2316
+ "code": "UNAVAILABLE",
2317
+ "domain": "terminal",
2318
+ "failure_class": "transport",
2319
+ "severity": "transient",
2320
+ "retryable": true,
2321
+ "resolution_owner": "user",
2322
+ "remediation_action": "reconnect_service",
2323
+ "default_stage": "attach"
2324
+ },
2325
+ "pty_session_not_found": {
2326
+ "code": "NOT_FOUND",
2327
+ "domain": "terminal",
2328
+ "failure_class": "availability",
2329
+ "severity": "blocking_user_fixable",
2330
+ "retryable": false,
2331
+ "resolution_owner": "user",
2332
+ "remediation_action": "change_input",
2333
+ "default_stage": "attach"
2334
+ },
2335
+ "pty_session_expired": {
2336
+ "code": "FAILED_PRECONDITION",
2337
+ "domain": "terminal",
2338
+ "failure_class": "availability",
2339
+ "severity": "blocking_user_fixable",
2340
+ "retryable": false,
2341
+ "resolution_owner": "user",
2342
+ "remediation_action": "restart_runtime",
2343
+ "default_stage": "attach"
2344
+ },
2345
+ "pty_replay_cursor_invalid": {
2346
+ "code": "OUT_OF_RANGE",
2347
+ "domain": "terminal",
2348
+ "failure_class": "validation",
2349
+ "severity": "blocking_user_fixable",
2350
+ "retryable": false,
2351
+ "resolution_owner": "user",
2352
+ "remediation_action": "change_input",
2353
+ "default_stage": "attach"
2354
+ },
2355
+ "transport_not_configured": {
2356
+ "code": "FAILED_PRECONDITION",
2357
+ "domain": "transport",
2358
+ "failure_class": "configuration",
2359
+ "severity": "blocking_user_fixable",
2360
+ "retryable": false,
2361
+ "resolution_owner": "user",
2362
+ "remediation_action": "change_configuration",
2363
+ "default_stage": "configure"
2364
+ },
2365
+ "transport_auth_failed": {
2366
+ "code": "UNAUTHENTICATED",
2367
+ "domain": "transport",
2368
+ "failure_class": "authentication",
2369
+ "severity": "blocking_user_fixable",
2370
+ "retryable": false,
2371
+ "resolution_owner": "user",
2372
+ "remediation_action": "reauthenticate",
2373
+ "default_stage": "authorize"
2374
+ },
2375
+ "transport_attach_failed": {
2376
+ "code": "UNAVAILABLE",
2377
+ "domain": "transport",
2378
+ "failure_class": "transport",
2379
+ "severity": "transient",
2380
+ "retryable": true,
2381
+ "resolution_owner": "provider",
2382
+ "remediation_action": "reconnect_service",
2383
+ "default_stage": "attach"
2384
+ },
2385
+ "sidecar_missing": {
2386
+ "code": "FAILED_PRECONDITION",
2387
+ "domain": "runtime",
2388
+ "failure_class": "dependency",
2389
+ "severity": "blocking_user_fixable",
2390
+ "retryable": false,
2391
+ "resolution_owner": "user",
2392
+ "remediation_action": "install_dependency",
2393
+ "default_stage": "resolve"
2394
+ },
2395
+ "sidecar_start_failed": {
2396
+ "code": "INTERNAL",
2397
+ "domain": "runtime",
2398
+ "failure_class": "process",
2399
+ "severity": "blocking_internal",
2400
+ "retryable": false,
2401
+ "resolution_owner": "agentsam",
2402
+ "remediation_action": "inspect_platform",
2403
+ "default_stage": "start"
2404
+ },
2405
+ "sidecar_health_failed": {
2406
+ "code": "UNAVAILABLE",
2407
+ "domain": "runtime",
2408
+ "failure_class": "availability",
2409
+ "severity": "transient",
2410
+ "retryable": true,
2411
+ "resolution_owner": "user",
2412
+ "remediation_action": "restart_service",
2413
+ "default_stage": "verify"
2414
+ },
2415
+ "tool_not_found": {
2416
+ "code": "NOT_FOUND",
2417
+ "domain": "tool",
2418
+ "failure_class": "availability",
2419
+ "severity": "blocking_user_fixable",
2420
+ "retryable": false,
2421
+ "resolution_owner": "user",
2422
+ "remediation_action": "change_input",
2423
+ "default_stage": "resolve"
2424
+ },
2425
+ "tool_disabled": {
2426
+ "code": "FAILED_PRECONDITION",
2427
+ "domain": "tool",
2428
+ "failure_class": "configuration",
2429
+ "severity": "blocking_user_fixable",
2430
+ "retryable": false,
2431
+ "resolution_owner": "user",
2432
+ "remediation_action": "change_configuration",
2433
+ "default_stage": "validate"
2434
+ },
2435
+ "tool_handler_unavailable": {
2436
+ "code": "FAILED_PRECONDITION",
2437
+ "domain": "tool",
2438
+ "failure_class": "availability",
2439
+ "severity": "blocking_user_fixable",
2440
+ "retryable": false,
2441
+ "resolution_owner": "user",
2442
+ "remediation_action": "configure_dependency",
2443
+ "default_stage": "resolve"
2444
+ },
2445
+ "tool_execution_failed": {
2446
+ "code": "INTERNAL",
2447
+ "domain": "tool",
2448
+ "failure_class": "execution",
2449
+ "severity": "blocking_internal",
2450
+ "retryable": false,
2451
+ "resolution_owner": "agentsam",
2452
+ "remediation_action": "inspect_platform",
2453
+ "default_stage": "execute"
2454
+ },
2455
+ "tool_timeout": {
2456
+ "code": "DEADLINE_EXCEEDED",
2457
+ "domain": "tool",
2458
+ "failure_class": "timeout",
2459
+ "severity": "transient",
2460
+ "retryable": true,
2461
+ "resolution_owner": "unknown",
2462
+ "remediation_action": "retry_later",
2463
+ "default_stage": "execute"
2464
+ },
2465
+ "tool_output_invalid": {
2466
+ "code": "DATA_LOSS",
2467
+ "domain": "tool",
2468
+ "failure_class": "protocol",
2469
+ "severity": "blocking_internal",
2470
+ "retryable": false,
2471
+ "resolution_owner": "agentsam",
2472
+ "remediation_action": "inspect_platform",
2473
+ "default_stage": "transform"
2474
+ },
2475
+ "tool_permission_denied": {
2476
+ "code": "PERMISSION_DENIED",
2477
+ "domain": "tool",
2478
+ "failure_class": "authorization",
2479
+ "severity": "policy_blocking",
2480
+ "retryable": false,
2481
+ "resolution_owner": "policy",
2482
+ "remediation_action": "request_permission",
2483
+ "default_stage": "authorize"
2484
+ },
2485
+ "mcp_timeout": {
2486
+ "code": "DEADLINE_EXCEEDED",
2487
+ "domain": "tool",
2488
+ "failure_class": "timeout",
2489
+ "severity": "transient",
2490
+ "retryable": true,
2491
+ "resolution_owner": "user",
2492
+ "remediation_action": "retry_later",
2493
+ "default_stage": "execute"
2494
+ },
2495
+ "mcp_server_unavailable": {
2496
+ "code": "UNAVAILABLE",
2497
+ "domain": "tool",
2498
+ "failure_class": "availability",
2499
+ "severity": "transient",
2500
+ "retryable": true,
2501
+ "resolution_owner": "user",
2502
+ "remediation_action": "restart_service",
2503
+ "default_stage": "connect"
2504
+ },
2505
+ "mcp_capability_unsupported": {
2506
+ "code": "UNIMPLEMENTED",
2507
+ "domain": "tool",
2508
+ "failure_class": "protocol",
2509
+ "severity": "blocking_user_fixable",
2510
+ "retryable": false,
2511
+ "resolution_owner": "user",
2512
+ "remediation_action": "change_configuration",
2513
+ "default_stage": "validate"
2514
+ },
2515
+ "mcp_response_invalid": {
2516
+ "code": "DATA_LOSS",
2517
+ "domain": "tool",
2518
+ "failure_class": "protocol",
2519
+ "severity": "blocking_internal",
2520
+ "retryable": false,
2521
+ "resolution_owner": "agentsam",
2522
+ "remediation_action": "inspect_platform",
2523
+ "default_stage": "transform"
2524
+ },
2525
+ "mcp_transport_failed": {
2526
+ "code": "UNAVAILABLE",
2527
+ "domain": "tool",
2528
+ "failure_class": "transport",
2529
+ "severity": "transient",
2530
+ "retryable": true,
2531
+ "resolution_owner": "user",
2532
+ "remediation_action": "reconnect_service",
2533
+ "default_stage": "connect"
2534
+ },
2535
+ "lsp_timeout": {
2536
+ "code": "DEADLINE_EXCEEDED",
2537
+ "domain": "tool",
2538
+ "failure_class": "timeout",
2539
+ "severity": "transient",
2540
+ "retryable": true,
2541
+ "resolution_owner": "user",
2542
+ "remediation_action": "retry_later",
2543
+ "default_stage": "execute"
2544
+ },
2545
+ "lsp_server_unavailable": {
2546
+ "code": "UNAVAILABLE",
2547
+ "domain": "tool",
2548
+ "failure_class": "availability",
2549
+ "severity": "transient",
2550
+ "retryable": true,
2551
+ "resolution_owner": "user",
2552
+ "remediation_action": "restart_service",
2553
+ "default_stage": "connect"
2554
+ },
2555
+ "lsp_capability_unsupported": {
2556
+ "code": "UNIMPLEMENTED",
2557
+ "domain": "tool",
2558
+ "failure_class": "protocol",
2559
+ "severity": "blocking_user_fixable",
2560
+ "retryable": false,
2561
+ "resolution_owner": "user",
2562
+ "remediation_action": "change_configuration",
2563
+ "default_stage": "validate"
2564
+ },
2565
+ "lsp_response_invalid": {
2566
+ "code": "DATA_LOSS",
2567
+ "domain": "tool",
2568
+ "failure_class": "protocol",
2569
+ "severity": "blocking_internal",
2570
+ "retryable": false,
2571
+ "resolution_owner": "agentsam",
2572
+ "remediation_action": "inspect_platform",
2573
+ "default_stage": "transform"
2574
+ },
2575
+ "lsp_transport_failed": {
2576
+ "code": "UNAVAILABLE",
2577
+ "domain": "tool",
2578
+ "failure_class": "transport",
2579
+ "severity": "transient",
2580
+ "retryable": true,
2581
+ "resolution_owner": "user",
2582
+ "remediation_action": "reconnect_service",
2583
+ "default_stage": "connect"
2584
+ },
2585
+ "mcp_call_failed": {
2586
+ "code": "INTERNAL",
2587
+ "domain": "tool",
2588
+ "failure_class": "execution",
2589
+ "severity": "blocking_internal",
2590
+ "retryable": false,
2591
+ "resolution_owner": "agentsam",
2592
+ "remediation_action": "inspect_platform",
2593
+ "default_stage": "execute"
2594
+ },
2595
+ "lsp_request_failed": {
2596
+ "code": "INTERNAL",
2597
+ "domain": "tool",
2598
+ "failure_class": "execution",
2599
+ "severity": "blocking_internal",
2600
+ "retryable": false,
2601
+ "resolution_owner": "agentsam",
2602
+ "remediation_action": "inspect_platform",
2603
+ "default_stage": "execute"
2604
+ }
2605
+ });
2606
+ export const ERROR_REASON_ALIASES = Object.freeze({
2607
+ "invalid_agent_id": "input_invalid",
2608
+ "subagent_task_required": "input_invalid",
2609
+ "hook_definition_must_be_object": "hook_definition_invalid",
2610
+ "hook_id_required": "hook_definition_invalid",
2611
+ "hook_id_and_handler_required": "hook_definition_invalid",
2612
+ "invalid_hook_failure_mode": "hook_definition_invalid",
2613
+ "invalid_hook_timeout_ms": "hook_definition_invalid",
2614
+ "hook_timestamp_must_be_non_negative": "hook_definition_invalid",
2615
+ "hook_timestamp_must_be_non_negative_number": "hook_definition_invalid",
2616
+ "hook_clock_must_return_non_negative_number": "hook_definition_invalid",
2617
+ "hook_input_must_be_object": "hook_definition_invalid",
2618
+ "hook_invocation_must_be_object": "hook_definition_invalid",
2619
+ "hook_invocation_metadata_must_be_object": "hook_definition_invalid",
2620
+ "unsupported_hook_invocation_field": "hook_definition_invalid",
2621
+ "unsupported_hook_schema": "hook_definition_invalid",
2622
+ "hook_match_must_be_object": "hook_definition_invalid",
2623
+ "hook_match_$in_must_be_array": "hook_definition_invalid",
2624
+ "unsupported_hook_match_operator": "hook_definition_invalid",
2625
+ "hook_matches_must_be_function": "hook_definition_invalid",
2626
+ "hook_key_required": "hook_definition_invalid",
2627
+ "hook_receipt_hook_id_required": "hook_definition_invalid",
2628
+ "invalid_hook_id": "hook_definition_invalid",
2629
+ "invalid_hook_priority": "hook_definition_invalid",
2630
+ "invalid_hook_command_output_limit": "hook_definition_invalid",
2631
+ "invalid_hook_command_timeout": "hook_definition_invalid",
2632
+ "invalid_hook_http_response_limit": "hook_definition_invalid",
2633
+ "invalid_hook_http_timeout": "hook_definition_invalid",
2634
+ "duplicate_hook_id": "hook_duplicate_id",
2635
+ "agentsam_hook_config_not_found": "hook_not_found",
2636
+ "unsupported_hook_event": "hook_event_unsupported",
2637
+ "hook_config_must_be_object": "hook_configuration_invalid",
2638
+ "unsupported_hook_config_field": "hook_configuration_invalid",
2639
+ "unsupported_hook_config_schema": "hook_configuration_invalid",
2640
+ "hook_config_unreadable": "hook_configuration_invalid",
2641
+ "invalid_configured_hook": "hook_configuration_invalid",
2642
+ "unsupported_configured_hook_field": "hook_configuration_invalid",
2643
+ "configured_hook_match_must_be_object": "hook_configuration_invalid",
2644
+ "invalid_hook_env_reference": "hook_configuration_invalid",
2645
+ "missing_hook_environment": "hook_configuration_invalid",
2646
+ "invalid_hook_environment_key": "hook_configuration_invalid",
2647
+ "hook_command_cwd_outside_config_directory": "hook_configuration_invalid",
2648
+ "hook_store_database_required": "hook_configuration_invalid",
2649
+ "invalid_hook_adapter": "hook_adapter_unknown",
2650
+ "unknown_hook_adapter": "hook_adapter_unknown",
2651
+ "unsupported_hook_adapter_type": "hook_adapter_unknown",
2652
+ "unsupported_hook_adapter_field": "hook_adapter_unknown",
2653
+ "hook_handler_required": "hook_handler_unavailable",
2654
+ "callback_hook_handler_required": "hook_handler_unavailable",
2655
+ "base_capability_adapter_required": "hook_handler_unavailable",
2656
+ "base_provider_adapter_required": "hook_handler_unavailable",
2657
+ "hook_runtime_required": "hook_handler_unavailable",
2658
+ "invalid_hook_runtime": "hook_handler_unavailable",
2659
+ "composite_capability_adapters_required": "hook_handler_unavailable",
2660
+ "hook_http_fetch_required": "hook_handler_unavailable",
2661
+ "hook_store_required": "hook_handler_unavailable",
2662
+ "lsp_request_adapter_required": "hook_handler_unavailable",
2663
+ "mcp_call_tool_adapter_required": "hook_handler_unavailable",
2664
+ "run_agent_adapter_required": "hook_handler_unavailable",
2665
+ "stored_hook_handler_unavailable": "hook_handler_unavailable",
2666
+ "hook_timeout": "hook_handler_timeout",
2667
+ "AGENTSAM_HOOK_TIMEOUT": "hook_handler_timeout",
2668
+ "context deadline exceeded": "hook_handler_timeout",
2669
+ "deadline has elapsed": "hook_handler_timeout",
2670
+ "hook_execution_failed": "hook_handler_failed",
2671
+ "AGENTSAM_HOOK_EXECUTION_FAILED": "hook_handler_failed",
2672
+ "AGENTSAM_HOOK_FAILED": "hook_handler_failed",
2673
+ "hook_output_must_be_object": "hook_output_invalid",
2674
+ "invalid_permission_decision": "hook_output_invalid",
2675
+ "modified_args_must_be_object": "hook_output_invalid",
2676
+ "modified_request_must_be_object": "hook_output_invalid",
2677
+ "modified_prompt_must_be_string": "hook_output_invalid",
2678
+ "modified_transformed_prompt_must_be_string": "hook_output_invalid",
2679
+ "modified_config_must_be_object": "hook_output_invalid",
2680
+ "AGENTSAM_HOOK_INVALID_OUTPUT": "hook_output_invalid",
2681
+ "AGENTSAM_HOOK_OUTPUT_LIMIT": "hook_output_limit_exceeded",
2682
+ "unsupported_hook_output_field": "hook_output_field_unsupported",
2683
+ "permission_decision_not_supported": "hook_output_field_unsupported",
2684
+ "modified_args_not_supported": "hook_output_field_unsupported",
2685
+ "modified_request_not_supported": "hook_output_field_unsupported",
2686
+ "modified_result_not_supported": "hook_output_field_unsupported",
2687
+ "modified_prompt_not_supported": "hook_output_field_unsupported",
2688
+ "modified_transformed_prompt_not_supported": "hook_output_field_unsupported",
2689
+ "modified_config_not_supported": "hook_output_field_unsupported",
2690
+ "hook_http_failed": "hook_http_request_failed",
2691
+ "AGENTSAM_HOOK_HTTP_FAILED": "hook_http_request_failed",
2692
+ "hook_http_invalid_json": "hook_http_response_invalid",
2693
+ "unsupported_hook_http_protocol": "hook_http_protocol_unsupported",
2694
+ "hook_http_url_must_not_contain_credentials": "hook_http_credentials_forbidden",
2695
+ "mcp_capability_unavailable": "hook_mcp_capability_missing",
2696
+ "duplicate_mcp_capability": "hook_mcp_capability_duplicate",
2697
+ "lsp_language_not_configured": "hook_lsp_server_unavailable",
2698
+ "lsp_language_required": "hook_lsp_language_required",
2699
+ "lsp_capability_unavailable": "hook_lsp_capability_unsupported",
2700
+ "configured_hook_command_required": "hook_command_required",
2701
+ "hook_command_stdin_unavailable": "hook_command_spawn_failed",
2702
+ "hook_command_failed": "hook_command_exit_nonzero",
2703
+ "AGENTSAM_HOOK_COMMAND_FAILED": "hook_command_exit_nonzero",
2704
+ "hook_command_invalid_json": "hook_command_output_invalid",
2705
+ "AGENTSAM_HOOK_PERMISSION_DENIED": "hook_permission_denied",
2706
+ "AGENTSAM_HOOK_APPROVAL_REQUIRED": "hook_permission_denied",
2707
+ "capability_handler_unavailable": "hook_capability_unavailable",
2708
+ "agent_capability_unavailable": "hook_capability_unavailable",
2709
+ "duplicate_capability_descriptor": "hook_capability_duplicate",
2710
+ "invalid_error_handling": "hook_error_handling_invalid",
2711
+ "error_handling_not_supported": "hook_error_handling_unsupported",
2712
+ "retry_count_must_be_between_0_and_10": "hook_retry_limit_exceeded",
2713
+ "invalid_stop_decision": "hook_stop_decision_invalid",
2714
+ "distribution_command_failed": "distribution_smoke_failed"
2715
+ });
2716
+
2717
+ function token(value) {
2718
+ return String(value || '').trim().split(':', 1)[0];
2719
+ }
2720
+ export function normalizeGeneratedErrorReason(...values) {
2721
+ for (const value of values) {
2722
+ const candidate = token(value);
2723
+ if (!candidate) continue;
2724
+ if (ERROR_REASON_POLICY[candidate]) return candidate;
2725
+ const alias = ERROR_REASON_ALIASES[candidate] || ERROR_REASON_ALIASES[candidate.toLowerCase()] || ERROR_REASON_ALIASES[candidate.toUpperCase()];
2726
+ if (alias) return alias;
2727
+ }
2728
+ return 'hook_handler_failed';
2729
+ }
2730
+ export function generatedErrorPolicy(reason) {
2731
+ return ERROR_REASON_POLICY[reason] || ERROR_REASON_POLICY.hook_handler_failed;
2732
+ }