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