@inneranimalmedia/agentsam-sdk 2.6.9 → 2.6.10

package/migrations/runtime/0005_agentsam_hooks.sql

@@ -0,0 +1,87 @@
+-- Portable AgentSam hook registry and execution evidence.
+--
+-- This is the standalone/local baseline. Shared hosts may map owner_id to their
+-- account authority, but tenant_id/workspace_id are intentionally not part of
+-- the portable contract. Repository/project/session applicability belongs in
+-- scope_type + scope_ref; less common correlations stay in JSON.
+--
+-- Handler secrets are references resolved by the host. Never store API keys,
+-- bearer tokens, or decrypted credentials in handler_config_json or receipts.
+
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS agentsam_hook (
+  id TEXT PRIMARY KEY DEFAULT ('hook_' || lower(hex(randomblob(8)))),
+  owner_id TEXT NOT NULL DEFAULT 'local',
+  hook_key TEXT NOT NULL CHECK(length(trim(hook_key)) > 0 AND hook_key = trim(hook_key)),
+  event_type TEXT NOT NULL CHECK(length(trim(event_type)) > 0 AND event_type = trim(event_type)),
+  source_kind TEXT NOT NULL DEFAULT 'stored'
+    CHECK(source_kind IN ('stored','config','code','system')),
+  scope_type TEXT NOT NULL DEFAULT 'project'
+    CHECK(scope_type IN ('global','account','repository','project','session')),
+  scope_ref TEXT,
+  handler_type TEXT NOT NULL DEFAULT 'log_only'
+    CHECK(length(trim(handler_type)) > 0 AND handler_type = trim(handler_type)),
+  handler_config_json TEXT NOT NULL DEFAULT '{}'
+    CHECK(json_valid(handler_config_json)),
+  match_json TEXT NOT NULL DEFAULT '{}'
+    CHECK(json_valid(match_json)),
+  failure_mode TEXT NOT NULL DEFAULT 'open'
+    CHECK(failure_mode IN ('open','closed','error')),
+  priority INTEGER NOT NULL DEFAULT 100,
+  timeout_ms INTEGER NOT NULL DEFAULT 30000
+    CHECK(timeout_ms BETWEEN 1 AND 600000),
+  is_active INTEGER NOT NULL DEFAULT 1 CHECK(is_active IN (0,1)),
+  workflow_id TEXT,
+  description TEXT,
+  metadata_json TEXT NOT NULL DEFAULT '{}'
+    CHECK(json_valid(metadata_json)),
+  revision INTEGER NOT NULL DEFAULT 1 CHECK(revision >= 1),
+  created_at_unix INTEGER NOT NULL DEFAULT (unixepoch()),
+  updated_at_unix INTEGER NOT NULL DEFAULT (unixepoch())
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_agentsam_hook_identity
+  ON agentsam_hook(owner_id, scope_type, IFNULL(scope_ref, ''), hook_key);
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_dispatch
+  ON agentsam_hook(owner_id, event_type, is_active, priority, hook_key);
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_scope
+  ON agentsam_hook(owner_id, scope_type, scope_ref, is_active);
+
+CREATE TABLE IF NOT EXISTS agentsam_hook_execution (
+  id TEXT PRIMARY KEY DEFAULT ('hexec_' || lower(hex(randomblob(8)))),
+  owner_id TEXT NOT NULL DEFAULT 'local',
+  hook_id TEXT,
+  hook_key TEXT NOT NULL,
+  source_kind TEXT NOT NULL DEFAULT 'stored'
+    CHECK(source_kind IN ('stored','config','code','system')),
+  event_type TEXT NOT NULL,
+  invocation_id TEXT,
+  agent_run_id TEXT,
+  session_id TEXT,
+  conversation_id TEXT,
+  status TEXT NOT NULL
+    CHECK(status IN ('completed','failed','timeout','skipped','blocked')),
+  duration_ms INTEGER NOT NULL DEFAULT 0 CHECK(duration_ms >= 0),
+  input_keys_json TEXT NOT NULL DEFAULT '[]' CHECK(json_valid(input_keys_json)),
+  output_keys_json TEXT NOT NULL DEFAULT '[]' CHECK(json_valid(output_keys_json)),
+  decision TEXT,
+  reason TEXT,
+  error_code TEXT,
+  error_message TEXT,
+  receipt_json TEXT NOT NULL DEFAULT '{}' CHECK(json_valid(receipt_json)),
+  correlation_json TEXT NOT NULL DEFAULT '{}' CHECK(json_valid(correlation_json)),
+  ran_at_unix INTEGER NOT NULL DEFAULT (unixepoch())
+);
+
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_execution_hook
+  ON agentsam_hook_execution(owner_id, hook_key, ran_at_unix DESC);
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_execution_run
+  ON agentsam_hook_execution(agent_run_id, ran_at_unix DESC)
+  WHERE agent_run_id IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_execution_session
+  ON agentsam_hook_execution(session_id, ran_at_unix DESC)
+  WHERE session_id IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_execution_failure
+  ON agentsam_hook_execution(owner_id, status, ran_at_unix DESC)
+  WHERE status IN ('failed','timeout','blocked');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-sdk",
-  "version": "2.6.9",
+  "version": "2.6.10",
   "description": "Portable AgentSam SDK and CLI kits for local scaffolding, repository intelligence, incremental indexing, identity adapters, and verified dependency maintenance.",
   "type": "module",
   "main": "./src/index.js",
@@ -90,6 +90,7 @@
     "./work-graph/adapters/business/projects": "./packages/work-graph/src/adapters/business/projects.js",
     "./errors": "./src/errors/index.js",
     "./errors/schema": "./protocol/errors/error-envelope.schema.json",
+    "./errors/schema-v2": "./protocol/errors/agentsam.error.v2.schema.json",
     "./errors/catalog": "./protocol/errors/error-catalog.json",
     "./cloudflare": "./src/cloudflare/index.js",
     "./eval": "./src/eval/index.js",
@@ -119,12 +120,21 @@
     "./theme/harbor": "./packages/theme-insurance-site/src/index.js",
     "./theme/summit": "./packages/theme-shinshu-site/src/index.js",
     "./models/inventory": "./src/models/inventory-core.js",
+    "./models/provider-snapshot-schema": "./protocol/models/provider-model-snapshot.v1.schema.json",
     "./local-engine": "./src/local-engine/index.js",
     "./local-engine/contracts": "./src/local-engine/contracts.js",
     "./local-engine/audit": "./src/local-engine/audit.js",
     "./local-engine/assets": "./src/local-engine/assets.js",
     "./local-engine/benchmark": "./src/local-engine/benchmark.js",
-    "./goap": "./packages/agentsam-goap/src/index.js"
+    "./goap": "./packages/agentsam-goap/src/index.js",
+    "./hooks": "./packages/agentsam-hooks/src/index.js",
+    "./hooks/store": "./packages/agentsam-hooks/src/store.js",
+    "./hooks/protocol/input": "./protocol/hooks/agentsam.hook.v1.schema.json",
+    "./hooks/protocol/output": "./protocol/hooks/agentsam.hook.output.v1.schema.json",
+    "./hooks/protocol/config": "./protocol/hooks/agentsam.hooks.config.v1.schema.json",
+    "./hooks/protocol/receipt": "./protocol/hooks/agentsam.hook.receipt.v1.schema.json",
+    "./hooks/schema/manifest": "./packages/agentsam-hooks/schema/manifest.json",
+    "./hooks/schema/sqlite": "./migrations/runtime/0005_agentsam_hooks.sql"
   },
   "bin": {
     "agentsam": "bin/agentsam",
@@ -132,7 +142,8 @@
     "agentsam-scaffold": "bin/scaffold.mjs",
     "agentsam-auth-portal": "packages/identity/scripts/preview-auth-portal.mjs",
     "agentsam-rapid-rust": "bin/agentsam-rapid-rust",
-    "agentsam-rust": "bin/agentsam-rapid-rust"
+    "agentsam-rust": "bin/agentsam-rapid-rust",
+    "agentsam-hooks": "packages/agentsam-hooks/bin/agentsam-hooks.mjs"
   },
   "files": [
     "src",
@@ -142,6 +153,7 @@
     "packages/agentsam-brand/bin",
     "packages/agentsam-brand/src",
     "packages/agentsam-contracts",
+    "packages/agentsam-hooks",
     "packages/agentsam-errors",
     "packages/agentsam-repository",
     "packages/agentsam-knowledge",
@@ -231,9 +243,11 @@
     "packages/agentsam-docs-theme",
     "packages/agentsam-errors",
     "packages/agentsam-goap",
+    "packages/agentsam-hooks",
     "packages/agentsam-ide",
     "packages/agentsam-key-manager",
     "packages/agentsam-knowledge",
+    "packages/agentsam-loading-scene",
     "packages/agentsam-nav",
     "packages/agentsam-queue-control",
     "packages/agentsam-repository",
@@ -257,7 +271,8 @@
     "packages/theme-insurance-site",
     "packages/theme-scenes",
     "packages/theme-shinshu-site",
-    "packages/work-graph"
+    "packages/work-graph",
+    "examples/hyperspace-demo"
   ],
   "scripts": {
     "test": "npm run test:standard && npm --prefix packages/identity test && npm --prefix packages/agentsam-brand test && npm run test:connectors && npm run test:providers",
@@ -271,7 +286,7 @@
     "test:terminal:mock": "node --test test/terminal/*.test.mjs",
     "test:live:terminal": "node --test test/live/*.live.test.mjs",
     "test:identity": "npm --prefix packages/identity test",
-    "test:workspaces": "npm --prefix packages/agentsam-contracts test && npm --prefix packages/agentsam-contracts run typecheck && npm --prefix packages/agentsam-errors test && npm --prefix packages/agentsam-vault test && npm --prefix packages/agentsam-repository test && npm --prefix packages/agentsam-workbench test && npm --prefix packages/agentsam-workbench run typecheck && npm --prefix packages/agentsam-nav run typecheck && npm --prefix packages/agentsam-shell-kit run typecheck && npm --prefix packages/work-graph test && npm --prefix packages/agentsam-queue-control test && npm --prefix packages/cms-runtime test && npm --prefix packages/agentsam-goap test",
+    "test:workspaces": "npm --prefix packages/agentsam-contracts test && npm --prefix packages/agentsam-contracts run typecheck && npm --prefix packages/agentsam-errors test && npm --prefix packages/agentsam-vault test && npm --prefix packages/agentsam-repository test && npm --prefix packages/agentsam-workbench test && npm --prefix packages/agentsam-workbench run typecheck && npm --prefix packages/agentsam-nav run typecheck && npm --prefix packages/agentsam-shell-kit run typecheck && npm --prefix packages/work-graph test && npm --prefix packages/agentsam-queue-control test && npm --prefix packages/cms-runtime test && npm --prefix packages/agentsam-goap test && npm --prefix packages/agentsam-hooks test",
     "test:autorag": "npm --prefix packages/agentsam-knowledge test",
     "smoke": "node test/smoke.mjs",
     "verify:package": "node scripts/verify-package.mjs",
@@ -316,7 +331,8 @@
     "release:train:check": "node scripts/release-train.mjs check",
     "release:train:align": "node scripts/release-train.mjs align",
     "ci:products": "node scripts/ci-products.mjs",
-    "verify:packages:public": "node scripts/verify-public-packages.mjs"
+    "verify:packages:public": "node scripts/verify-public-packages.mjs",
+    "test:hooks": "npm --prefix packages/agentsam-hooks test"
   },
   "engines": {
     "node": ">=22 <25",
@@ -325,7 +341,7 @@
   "dependencies": {
     "@clack/prompts": "^1.7.0",
     "@grpc/grpc-js": "^1.14.4",
-    "@inneranimalmedia/agentsam-errors": "2.6.9",
+    "@inneranimalmedia/agentsam-errors": "2.6.10",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "google-protobuf": "^3.21.4",
     "node-pty": "^1.1.0",

package/packages/agentsam-brand/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-brand",
-  "version": "2.6.9",
+  "version": "2.6.10",
   "description": "Deterministic Brand Intelligence + portable brand-asset promotion SDK for AgentSam (inspect, derive, plan, promote, publish, verify).",
   "type": "module",
   "license": "MIT",

package/packages/agentsam-brand/src/core/v2/compile.js

@@ -35,7 +35,7 @@ function tokensToCss(tokens = {}) {
 }
 
 function tokensToJson(tokens = {}) {
-  return `${JSON.stringify({ $schema: 'https://agentsam.dev/schemas/brand-tokens/v1.json', ...tokens }, null, 2)}\n`;
+  return `${JSON.stringify({ $schema: 'https://agentsam.inneranimalmedia.com/schemas/brand-tokens/v1.json', ...tokens }, null, 2)}\n`;
 }
 
 function buildStudioHtml(pack) {

package/packages/agentsam-brand/src/core/v2/schema.js

@@ -6,7 +6,7 @@
  */
 
 export const BRAND_PACK_SCHEMA = 'agentsam.brand-pack.v2';
-export const BRAND_PACK_SCHEMA_URL = 'https://agentsam.dev/schemas/brand-pack/v2.json';
+export const BRAND_PACK_SCHEMA_URL = 'https://agentsam.inneranimalmedia.com/schemas/brand-pack/v2.json';
 export const BRAND_PACK_FILENAME = 'brand.pack.json';
 
 /** Empty brand graph — never seeds product identity. */

package/packages/agentsam-contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-contracts",
-  "version": "2.6.9",
+  "version": "2.6.10",
   "description": "Framework-neutral AgentSam contracts for workbench, tools, providers, events, hooks, execution, identity and repository context.",
   "type": "module",
   "main": "./dist/index.js",

package/packages/agentsam-contracts/src/errors.ts

@@ -1,14 +1,17 @@
 // GENERATED by scripts/generate-error-contracts.mjs. Do not edit by hand.
 
-export const AGENTSAM_ERROR_SCHEMA_VERSION = 1 as const;
+export const AGENTSAM_ERROR_SCHEMA_VERSION = 2 as const;
 
 export type AgentSamErrorCode = "OK" | "CANCELLED" | "UNKNOWN" | "INVALID_ARGUMENT" | "DEADLINE_EXCEEDED" | "NOT_FOUND" | "ALREADY_EXISTS" | "PERMISSION_DENIED" | "RESOURCE_EXHAUSTED" | "FAILED_PRECONDITION" | "ABORTED" | "OUT_OF_RANGE" | "UNIMPLEMENTED" | "INTERNAL" | "UNAVAILABLE" | "DATA_LOSS" | "UNAUTHENTICATED";
-export type AgentSamErrorReason = "unknown" | "input_invalid" | "input_out_of_range" | "precondition_failed" | "unsupported_operation" | "auth_missing" | "auth_invalid" | "permission_denied" | "user_permission_denied" | "provider_not_connected" | "provider_credential_missing" | "provider_credential_invalid" | "provider_credential_expired" | "provider_scope_insufficient" | "provider_budget_exhausted" | "provider_quota_exhausted" | "provider_rate_limited" | "provider_capacity_exhausted" | "provider_unavailable" | "provider_overloaded" | "provider_request_invalid" | "provider_model_not_found" | "provider_region_unsupported" | "provider_content_blocked" | "context_window_exceeded" | "service_tier_unsupported" | "continuation_invalid" | "target_not_found" | "already_exists" | "conflict" | "stale_version" | "rate_limited" | "quota_exhausted" | "capacity_exhausted" | "transport_unreachable" | "transport_refused" | "transport_timeout" | "upstream_invalid_response" | "dns_unresolved" | "tls_handshake_failed" | "tls_certificate_invalid" | "tunnel_connector_unavailable" | "cancelled" | "deadline_exceeded" | "execution_timeout" | "execution_failed" | "process_spawn_failed" | "process_crashed" | "process_output_limit" | "device_not_enrolled" | "device_credential_missing" | "device_credential_invalid" | "device_credential_expired" | "device_registration_missing" | "device_registration_stale" | "connection_revoked" | "connection_disabled" | "identity_resolution_failed" | "identity_mismatch" | "repository_scope_violation" | "repository_changed" | "index_stale" | "index_failed" | "embedding_failed" | "vector_store_failed" | "github_installation_missing" | "github_repository_not_found" | "github_rate_limited" | "github_secondary_rate_limited" | "github_scope_insufficient" | "cloudflare_workers_cpu_exhausted" | "cloudflare_service_binding_unavailable" | "cloudflare_durable_object_unavailable" | "cloudflare_d1_unavailable" | "cloudflare_r2_unavailable" | "docker_daemon_unavailable" | "docker_image_not_found" | "docker_build_failed" | "docker_container_failed" | "docker_registry_auth_failed" | "docker_pull_rate_limited" | "gcp_project_missing" | "gcp_api_disabled" | "gcp_quota_exhausted" | "gcp_vm_not_found" | "gcp_vm_unavailable" | "cad_tool_not_installed" | "cad_tool_not_executable" | "cad_tool_version_incompatible" | "cad_component_missing" | "cad_dependency_missing" | "cad_dependency_version_incompatible" | "cad_source_parse_failed" | "cad_input_format_unsupported" | "cad_import_failed" | "cad_model_recompute_failed" | "cad_constraint_unsatisfied" | "cad_geometry_invalid" | "cad_null_shape" | "cad_boolean_failed" | "cad_kernel_failed" | "cad_script_failed" | "cad_export_format_unsupported" | "cad_export_failed" | "cad_output_missing" | "cad_output_invalid" | "cad_render_engine_unavailable" | "cad_gpu_unavailable" | "cad_render_failed" | "cad_memory_exhausted" | "cad_process_crashed" | "cad_warning_escalated" | "policy_blocked" | "copyright_blocked" | "persistence_failed" | "data_corrupt" | "data_loss" | "internal" | "internal_invariant_violation" | "internal_configuration_invalid" | "internal_contract_violation" | "internal_adapter_failed" | "internal_dependency_failed";
+export type AgentSamErrorReason = "unknown" | "input_invalid" | "input_out_of_range" | "precondition_failed" | "unsupported_operation" | "auth_missing" | "auth_invalid" | "permission_denied" | "user_permission_denied" | "provider_not_connected" | "provider_credential_missing" | "provider_credential_invalid" | "provider_credential_expired" | "provider_scope_insufficient" | "provider_budget_exhausted" | "provider_quota_exhausted" | "provider_rate_limited" | "provider_capacity_exhausted" | "provider_unavailable" | "provider_overloaded" | "provider_request_invalid" | "provider_model_not_found" | "provider_region_unsupported" | "provider_content_blocked" | "context_window_exceeded" | "service_tier_unsupported" | "continuation_invalid" | "target_not_found" | "already_exists" | "conflict" | "stale_version" | "rate_limited" | "quota_exhausted" | "capacity_exhausted" | "transport_unreachable" | "transport_refused" | "transport_timeout" | "upstream_invalid_response" | "dns_unresolved" | "tls_handshake_failed" | "tls_certificate_invalid" | "tunnel_connector_unavailable" | "cancelled" | "deadline_exceeded" | "execution_timeout" | "execution_failed" | "process_spawn_failed" | "process_crashed" | "process_output_limit" | "device_not_enrolled" | "device_credential_missing" | "device_credential_invalid" | "device_credential_expired" | "device_registration_missing" | "device_registration_stale" | "connection_revoked" | "connection_disabled" | "identity_resolution_failed" | "identity_mismatch" | "repository_scope_violation" | "repository_changed" | "index_stale" | "index_failed" | "embedding_failed" | "vector_store_failed" | "github_installation_missing" | "github_repository_not_found" | "github_rate_limited" | "github_secondary_rate_limited" | "github_scope_insufficient" | "cloudflare_workers_cpu_exhausted" | "cloudflare_service_binding_unavailable" | "cloudflare_durable_object_unavailable" | "cloudflare_d1_unavailable" | "cloudflare_r2_unavailable" | "docker_daemon_unavailable" | "docker_image_not_found" | "docker_build_failed" | "docker_container_failed" | "docker_registry_auth_failed" | "docker_pull_rate_limited" | "gcp_project_missing" | "gcp_api_disabled" | "gcp_quota_exhausted" | "gcp_vm_not_found" | "gcp_vm_unavailable" | "cad_tool_not_installed" | "cad_tool_not_executable" | "cad_tool_version_incompatible" | "cad_component_missing" | "cad_dependency_missing" | "cad_dependency_version_incompatible" | "cad_source_parse_failed" | "cad_input_format_unsupported" | "cad_import_failed" | "cad_model_recompute_failed" | "cad_constraint_unsatisfied" | "cad_geometry_invalid" | "cad_null_shape" | "cad_boolean_failed" | "cad_kernel_failed" | "cad_script_failed" | "cad_export_format_unsupported" | "cad_export_failed" | "cad_output_missing" | "cad_output_invalid" | "cad_render_engine_unavailable" | "cad_gpu_unavailable" | "cad_render_failed" | "cad_memory_exhausted" | "cad_process_crashed" | "cad_warning_escalated" | "policy_blocked" | "copyright_blocked" | "persistence_failed" | "data_corrupt" | "data_loss" | "internal" | "internal_invariant_violation" | "internal_configuration_invalid" | "internal_contract_violation" | "internal_adapter_failed" | "internal_dependency_failed" | "hook_definition_invalid" | "hook_duplicate_id" | "hook_not_found" | "hook_disabled" | "hook_event_unsupported" | "hook_configuration_invalid" | "hook_adapter_unknown" | "hook_adapter_unavailable" | "hook_handler_unavailable" | "hook_handler_timeout" | "hook_handler_failed" | "hook_output_invalid" | "hook_output_limit_exceeded" | "hook_output_field_unsupported" | "hook_http_timeout" | "hook_http_request_failed" | "hook_http_response_invalid" | "hook_http_response_limit_exceeded" | "hook_http_protocol_unsupported" | "hook_http_credentials_forbidden" | "hook_mcp_timeout" | "hook_mcp_server_unavailable" | "hook_mcp_capability_missing" | "hook_mcp_capability_duplicate" | "hook_mcp_response_invalid" | "hook_mcp_transport_failed" | "hook_lsp_timeout" | "hook_lsp_server_unavailable" | "hook_lsp_language_required" | "hook_lsp_capability_unsupported" | "hook_lsp_initialize_failed" | "hook_lsp_response_invalid" | "hook_command_required" | "hook_command_timeout" | "hook_command_spawn_failed" | "hook_command_exit_nonzero" | "hook_command_output_limit_exceeded" | "hook_command_output_invalid" | "hook_permission_denied" | "hook_capability_unavailable" | "hook_capability_duplicate" | "hook_error_handling_invalid" | "hook_error_handling_unsupported" | "hook_retry_limit_exceeded" | "hook_stop_decision_invalid" | "package_manifest_invalid" | "package_export_missing" | "package_file_missing" | "package_unwanted_file_included" | "package_dependency_missing" | "package_dependency_version_mismatch" | "lockfile_missing" | "lockfile_stale" | "lockfile_incompatible" | "workspace_not_installed" | "workspace_resolution_failed" | "workspace_boundary_invalid" | "build_dependency_missing" | "build_failed" | "build_output_missing" | "build_output_stale" | "pack_failed" | "pack_contents_invalid" | "pack_provenance_violation" | "distribution_artifact_missing" | "distribution_identity_mismatch" | "distribution_version_mismatch" | "distribution_install_failed" | "distribution_smoke_failed" | "release_train_misaligned" | "published_artifact_stale" | "published_artifact_missing" | "schema_invalid" | "schema_version_unsupported" | "schema_contract_mismatch" | "schema_pack_missing" | "schema_pack_dependency_missing" | "schema_pack_dependency_cycle" | "schema_pack_ownership_conflict" | "migration_missing" | "migration_failed" | "migration_checksum_mismatch" | "migration_order_invalid" | "migration_already_applied_conflict" | "migration_requires_manual_repair" | "database_unreachable" | "database_driver_unsupported" | "database_authority_unresolved" | "database_authorization_failed" | "database_schema_drift" | "model_discovery_failed" | "model_catalog_stale" | "model_snapshot_missing" | "model_snapshot_stale" | "model_capability_unknown" | "model_capability_unsupported" | "model_provider_mismatch" | "model_identity_conflict" | "model_probe_failed" | "model_probe_partial" | "runtime_not_installed" | "runtime_not_running" | "runtime_version_incompatible" | "runtime_capability_missing" | "runtime_protocol_mismatch" | "runtime_connection_unresolved" | "runtime_connection_revoked" | "pty_create_failed" | "pty_attach_failed" | "pty_session_not_found" | "pty_session_expired" | "pty_replay_cursor_invalid" | "transport_not_configured" | "transport_auth_failed" | "transport_attach_failed" | "sidecar_missing" | "sidecar_start_failed" | "sidecar_health_failed" | "tool_not_found" | "tool_disabled" | "tool_handler_unavailable" | "tool_execution_failed" | "tool_timeout" | "tool_output_invalid" | "tool_permission_denied" | "mcp_timeout" | "mcp_server_unavailable" | "mcp_capability_unsupported" | "mcp_response_invalid" | "mcp_transport_failed" | "lsp_timeout" | "lsp_server_unavailable" | "lsp_capability_unsupported" | "lsp_response_invalid" | "lsp_transport_failed" | "mcp_call_failed" | "lsp_request_failed";
 export type AgentSamErrorSeverity = "transient" | "blocking_user_fixable" | "blocking_internal" | "policy_blocking";
 export type AgentSamErrorSourceKind = "user" | "agentsam" | "provider" | "dependency" | "runtime" | "policy";
 export type AgentSamErrorResolutionOwner = "user" | "agentsam" | "provider" | "organization_admin" | "policy" | "unknown";
-export type AgentSamErrorDomain = "runtime" | "provider" | "auth" | "device" | "terminal" | "transport" | "repository" | "indexing" | "knowledge" | "cad" | "deployment" | "persistence" | "policy" | "tool";
-export type AgentSamRemediationAction = "none" | "retry" | "retry_later" | "reauthenticate" | "connect_provider" | "configure_provider_credential" | "refresh_provider_credential" | "request_permission" | "reenroll_device" | "reconnect_service" | "install_dependency" | "upgrade_dependency" | "configure_dependency" | "change_configuration" | "change_input" | "reduce_scope" | "increase_quota" | "add_budget" | "select_model" | "change_region" | "restart_runtime" | "inspect_platform" | "contact_provider" | "contact_agentsam" | "contact_organization_admin";
+export type AgentSamErrorDomain = "runtime" | "provider" | "auth" | "identity" | "device" | "terminal" | "transport" | "repository" | "indexing" | "knowledge" | "cad" | "hook" | "model" | "configuration" | "schema" | "migration" | "database" | "package" | "build" | "distribution" | "deployment" | "workflow" | "persistence" | "policy" | "tool";
+export type AgentSamErrorFailureClass = "input" | "validation" | "authentication" | "authorization" | "policy" | "discovery" | "resolution" | "availability" | "transport" | "protocol" | "timeout" | "rate_limit" | "capacity" | "resource" | "configuration" | "dependency" | "filesystem" | "persistence" | "consistency" | "conflict" | "process" | "ipc" | "data_integrity" | "cancellation" | "cancelled" | "build" | "distribution" | "migration" | "schema" | "identity" | "execution" | "internal" | "unknown";
+export type AgentSamErrorStage = "discover" | "resolve" | "load" | "configure" | "validate" | "authorize" | "connect" | "prepare" | "install" | "build" | "start" | "execute" | "transform" | "persist" | "migrate" | "verify" | "publish" | "attach" | "detach" | "cleanup" | "shutdown";
+export type AgentSamErrorFailureBehavior = "fail_closed" | "fail_open" | "observe_only" | "retry_bounded" | "skip" | "abort" | "no_replay";
+export type AgentSamRemediationAction = "none" | "retry" | "retry_later" | "reauthenticate" | "connect_provider" | "configure_provider_credential" | "refresh_provider_credential" | "request_permission" | "reenroll_device" | "reconnect_service" | "install_dependency" | "upgrade_dependency" | "configure_dependency" | "change_configuration" | "change_input" | "reduce_scope" | "increase_quota" | "add_budget" | "select_model" | "change_region" | "restart_runtime" | "inspect_platform" | "contact_provider" | "contact_agentsam" | "contact_organization_admin" | "restart_service" | "repair_schema" | "run_migration" | "regenerate_artifact" | "update_lockfile" | "reinstall_workspace" | "republish_artifact";
 export type AgentSamErrorSideEffectState = "none" | "not_started" | "confirmed_not_applied" | "confirmed_applied" | "partially_applied" | "unknown";
 export type AgentSamErrorOutcomeStatus = "success" | "partial" | "failure";
 
@@ -28,14 +31,22 @@ export interface AgentSamErrorEnvelope {
   schema_version: typeof AGENTSAM_ERROR_SCHEMA_VERSION;
   code: AgentSamErrorCode;
   reason: AgentSamErrorReason | (string & {});
+  domain: AgentSamErrorDomain;
+  failure_class: AgentSamErrorFailureClass;
+  stage: AgentSamErrorStage;
+  native_stage: string | null;
+  feature: string | null;
+  failure_behavior: AgentSamErrorFailureBehavior | null;
   severity: AgentSamErrorSeverity;
-  source: AgentSamErrorSource;
+  retryable: boolean;
+  side_effect_state: AgentSamErrorSideEffectState;
   resolution_owner: AgentSamErrorResolutionOwner;
-  domain: AgentSamErrorDomain;
+  source: AgentSamErrorSource;
+  adapter: string | null;
+  protocol: string | null;
+  transport: string | null;
   tool: string | null;
-  stage: string | null;
   message: string;
-  retryable: boolean;
   retry_after_ms: number | null;
   remediation: AgentSamErrorRemediation;
   resource: AgentSamErrorResource | null;
@@ -43,7 +54,6 @@ export interface AgentSamErrorEnvelope {
   environment: AgentSamEnvironmentEvidence | null;
   http_status: number | null;
   grpc_status: number | null;
-  transport: string | null;
   provider: string | null;
   provider_code: string | null;
   request_id: string | null;
@@ -51,7 +61,6 @@ export interface AgentSamErrorEnvelope {
   fingerprint: string;
   occurrence_count: number;
   details: unknown;
-  failure_class?: string;
   operation?: AgentSamErrorOperation;
   retry?: AgentSamErrorRetry;
   fallback?: AgentSamErrorFallback;

package/packages/agentsam-errors/package.json

@@ -1,11 +1,17 @@
 {
   "name": "@inneranimalmedia/agentsam-errors",
-  "version": "2.6.9",
+  "version": "2.6.10",
   "description": "Canonical AgentSam runtime error normalization, classification, transport, remediation and rendering.",
   "type": "module",
   "main": "./src/index.js",
+  "types": "./types/index.d.ts",
   "exports": {
-    ".": "./src/index.js"
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./catalog": "./protocol/error-catalog.json",
+    "./schema": "./protocol/agentsam.error.v2.schema.json"
   },
   "scripts": {
     "test": "node --test test/*.test.mjs"
@@ -22,7 +28,9 @@
     "directory": "packages/agentsam-errors"
   },
   "files": [
-    "src"
+    "src",
+    "types",
+    "protocol"
   ],
   "license": "MIT"
 }