@inneranimalmedia/agentsam-sdk 2.6.2 → 2.6.4

package/packages/agentsam-errors/src/vocabulary.js

@@ -0,0 +1,320 @@
+// GENERATED by scripts/generate-error-contracts.mjs. Do not edit by hand.
+export const ERROR_SCHEMA_VERSION = 1;
+
+export const ERROR_CODE = Object.freeze({
+  OK: "OK",
+  CANCELLED: "CANCELLED",
+  UNKNOWN: "UNKNOWN",
+  INVALID_ARGUMENT: "INVALID_ARGUMENT",
+  DEADLINE_EXCEEDED: "DEADLINE_EXCEEDED",
+  NOT_FOUND: "NOT_FOUND",
+  ALREADY_EXISTS: "ALREADY_EXISTS",
+  PERMISSION_DENIED: "PERMISSION_DENIED",
+  RESOURCE_EXHAUSTED: "RESOURCE_EXHAUSTED",
+  FAILED_PRECONDITION: "FAILED_PRECONDITION",
+  ABORTED: "ABORTED",
+  OUT_OF_RANGE: "OUT_OF_RANGE",
+  UNIMPLEMENTED: "UNIMPLEMENTED",
+  INTERNAL: "INTERNAL",
+  UNAVAILABLE: "UNAVAILABLE",
+  DATA_LOSS: "DATA_LOSS",
+  UNAUTHENTICATED: "UNAUTHENTICATED",
+});
+
+export const GRPC_STATUS = Object.freeze({
+  OK: 0,
+  CANCELLED: 1,
+  UNKNOWN: 2,
+  INVALID_ARGUMENT: 3,
+  DEADLINE_EXCEEDED: 4,
+  NOT_FOUND: 5,
+  ALREADY_EXISTS: 6,
+  PERMISSION_DENIED: 7,
+  RESOURCE_EXHAUSTED: 8,
+  FAILED_PRECONDITION: 9,
+  ABORTED: 10,
+  OUT_OF_RANGE: 11,
+  UNIMPLEMENTED: 12,
+  INTERNAL: 13,
+  UNAVAILABLE: 14,
+  DATA_LOSS: 15,
+  UNAUTHENTICATED: 16,
+});
+
+export const DEFAULT_HTTP_STATUS = Object.freeze({
+  OK: 200,
+  CANCELLED: 499,
+  UNKNOWN: 500,
+  INVALID_ARGUMENT: 400,
+  DEADLINE_EXCEEDED: 504,
+  NOT_FOUND: 404,
+  ALREADY_EXISTS: 409,
+  PERMISSION_DENIED: 403,
+  RESOURCE_EXHAUSTED: 429,
+  FAILED_PRECONDITION: 412,
+  ABORTED: 409,
+  OUT_OF_RANGE: 400,
+  UNIMPLEMENTED: 501,
+  INTERNAL: 500,
+  UNAVAILABLE: 503,
+  DATA_LOSS: 500,
+  UNAUTHENTICATED: 401,
+});
+
+export const ERROR_REASON = Object.freeze({
+  UNKNOWN: "unknown",
+  INPUT_INVALID: "input_invalid",
+  INPUT_OUT_OF_RANGE: "input_out_of_range",
+  PRECONDITION_FAILED: "precondition_failed",
+  UNSUPPORTED_OPERATION: "unsupported_operation",
+  AUTH_MISSING: "auth_missing",
+  AUTH_INVALID: "auth_invalid",
+  PERMISSION_DENIED: "permission_denied",
+  USER_PERMISSION_DENIED: "user_permission_denied",
+  PROVIDER_NOT_CONNECTED: "provider_not_connected",
+  PROVIDER_CREDENTIAL_MISSING: "provider_credential_missing",
+  PROVIDER_CREDENTIAL_INVALID: "provider_credential_invalid",
+  PROVIDER_CREDENTIAL_EXPIRED: "provider_credential_expired",
+  PROVIDER_SCOPE_INSUFFICIENT: "provider_scope_insufficient",
+  PROVIDER_BUDGET_EXHAUSTED: "provider_budget_exhausted",
+  PROVIDER_QUOTA_EXHAUSTED: "provider_quota_exhausted",
+  PROVIDER_RATE_LIMITED: "provider_rate_limited",
+  PROVIDER_CAPACITY_EXHAUSTED: "provider_capacity_exhausted",
+  PROVIDER_UNAVAILABLE: "provider_unavailable",
+  PROVIDER_OVERLOADED: "provider_overloaded",
+  PROVIDER_REQUEST_INVALID: "provider_request_invalid",
+  PROVIDER_MODEL_NOT_FOUND: "provider_model_not_found",
+  PROVIDER_REGION_UNSUPPORTED: "provider_region_unsupported",
+  PROVIDER_CONTENT_BLOCKED: "provider_content_blocked",
+  CONTEXT_WINDOW_EXCEEDED: "context_window_exceeded",
+  SERVICE_TIER_UNSUPPORTED: "service_tier_unsupported",
+  CONTINUATION_INVALID: "continuation_invalid",
+  TARGET_NOT_FOUND: "target_not_found",
+  ALREADY_EXISTS: "already_exists",
+  CONFLICT: "conflict",
+  STALE_VERSION: "stale_version",
+  RATE_LIMITED: "rate_limited",
+  QUOTA_EXHAUSTED: "quota_exhausted",
+  CAPACITY_EXHAUSTED: "capacity_exhausted",
+  TRANSPORT_UNREACHABLE: "transport_unreachable",
+  TRANSPORT_REFUSED: "transport_refused",
+  TRANSPORT_TIMEOUT: "transport_timeout",
+  UPSTREAM_INVALID_RESPONSE: "upstream_invalid_response",
+  DNS_UNRESOLVED: "dns_unresolved",
+  TLS_HANDSHAKE_FAILED: "tls_handshake_failed",
+  TLS_CERTIFICATE_INVALID: "tls_certificate_invalid",
+  TUNNEL_CONNECTOR_UNAVAILABLE: "tunnel_connector_unavailable",
+  CANCELLED: "cancelled",
+  DEADLINE_EXCEEDED: "deadline_exceeded",
+  EXECUTION_TIMEOUT: "execution_timeout",
+  EXECUTION_FAILED: "execution_failed",
+  PROCESS_SPAWN_FAILED: "process_spawn_failed",
+  PROCESS_CRASHED: "process_crashed",
+  PROCESS_OUTPUT_LIMIT: "process_output_limit",
+  DEVICE_NOT_ENROLLED: "device_not_enrolled",
+  DEVICE_CREDENTIAL_MISSING: "device_credential_missing",
+  DEVICE_CREDENTIAL_INVALID: "device_credential_invalid",
+  DEVICE_CREDENTIAL_EXPIRED: "device_credential_expired",
+  DEVICE_REGISTRATION_MISSING: "device_registration_missing",
+  DEVICE_REGISTRATION_STALE: "device_registration_stale",
+  CONNECTION_REVOKED: "connection_revoked",
+  CONNECTION_DISABLED: "connection_disabled",
+  IDENTITY_RESOLUTION_FAILED: "identity_resolution_failed",
+  IDENTITY_MISMATCH: "identity_mismatch",
+  REPOSITORY_SCOPE_VIOLATION: "repository_scope_violation",
+  REPOSITORY_CHANGED: "repository_changed",
+  INDEX_STALE: "index_stale",
+  INDEX_FAILED: "index_failed",
+  EMBEDDING_FAILED: "embedding_failed",
+  VECTOR_STORE_FAILED: "vector_store_failed",
+  GITHUB_INSTALLATION_MISSING: "github_installation_missing",
+  GITHUB_REPOSITORY_NOT_FOUND: "github_repository_not_found",
+  GITHUB_RATE_LIMITED: "github_rate_limited",
+  GITHUB_SECONDARY_RATE_LIMITED: "github_secondary_rate_limited",
+  GITHUB_SCOPE_INSUFFICIENT: "github_scope_insufficient",
+  CLOUDFLARE_WORKERS_CPU_EXHAUSTED: "cloudflare_workers_cpu_exhausted",
+  CLOUDFLARE_SERVICE_BINDING_UNAVAILABLE: "cloudflare_service_binding_unavailable",
+  CLOUDFLARE_DURABLE_OBJECT_UNAVAILABLE: "cloudflare_durable_object_unavailable",
+  CLOUDFLARE_D1_UNAVAILABLE: "cloudflare_d1_unavailable",
+  CLOUDFLARE_R2_UNAVAILABLE: "cloudflare_r2_unavailable",
+  DOCKER_DAEMON_UNAVAILABLE: "docker_daemon_unavailable",
+  DOCKER_IMAGE_NOT_FOUND: "docker_image_not_found",
+  DOCKER_BUILD_FAILED: "docker_build_failed",
+  DOCKER_CONTAINER_FAILED: "docker_container_failed",
+  DOCKER_REGISTRY_AUTH_FAILED: "docker_registry_auth_failed",
+  DOCKER_PULL_RATE_LIMITED: "docker_pull_rate_limited",
+  GCP_PROJECT_MISSING: "gcp_project_missing",
+  GCP_API_DISABLED: "gcp_api_disabled",
+  GCP_QUOTA_EXHAUSTED: "gcp_quota_exhausted",
+  GCP_VM_NOT_FOUND: "gcp_vm_not_found",
+  GCP_VM_UNAVAILABLE: "gcp_vm_unavailable",
+  CAD_TOOL_NOT_INSTALLED: "cad_tool_not_installed",
+  CAD_TOOL_NOT_EXECUTABLE: "cad_tool_not_executable",
+  CAD_TOOL_VERSION_INCOMPATIBLE: "cad_tool_version_incompatible",
+  CAD_COMPONENT_MISSING: "cad_component_missing",
+  CAD_DEPENDENCY_MISSING: "cad_dependency_missing",
+  CAD_DEPENDENCY_VERSION_INCOMPATIBLE: "cad_dependency_version_incompatible",
+  CAD_SOURCE_PARSE_FAILED: "cad_source_parse_failed",
+  CAD_INPUT_FORMAT_UNSUPPORTED: "cad_input_format_unsupported",
+  CAD_IMPORT_FAILED: "cad_import_failed",
+  CAD_MODEL_RECOMPUTE_FAILED: "cad_model_recompute_failed",
+  CAD_CONSTRAINT_UNSATISFIED: "cad_constraint_unsatisfied",
+  CAD_GEOMETRY_INVALID: "cad_geometry_invalid",
+  CAD_NULL_SHAPE: "cad_null_shape",
+  CAD_BOOLEAN_FAILED: "cad_boolean_failed",
+  CAD_KERNEL_FAILED: "cad_kernel_failed",
+  CAD_SCRIPT_FAILED: "cad_script_failed",
+  CAD_EXPORT_FORMAT_UNSUPPORTED: "cad_export_format_unsupported",
+  CAD_EXPORT_FAILED: "cad_export_failed",
+  CAD_OUTPUT_MISSING: "cad_output_missing",
+  CAD_OUTPUT_INVALID: "cad_output_invalid",
+  CAD_RENDER_ENGINE_UNAVAILABLE: "cad_render_engine_unavailable",
+  CAD_GPU_UNAVAILABLE: "cad_gpu_unavailable",
+  CAD_RENDER_FAILED: "cad_render_failed",
+  CAD_MEMORY_EXHAUSTED: "cad_memory_exhausted",
+  CAD_PROCESS_CRASHED: "cad_process_crashed",
+  CAD_WARNING_ESCALATED: "cad_warning_escalated",
+  POLICY_BLOCKED: "policy_blocked",
+  COPYRIGHT_BLOCKED: "copyright_blocked",
+  PERSISTENCE_FAILED: "persistence_failed",
+  DATA_CORRUPT: "data_corrupt",
+  DATA_LOSS: "data_loss",
+  INTERNAL: "internal",
+  INTERNAL_INVARIANT_VIOLATION: "internal_invariant_violation",
+  INTERNAL_CONFIGURATION_INVALID: "internal_configuration_invalid",
+  INTERNAL_CONTRACT_VIOLATION: "internal_contract_violation",
+  INTERNAL_ADAPTER_FAILED: "internal_adapter_failed",
+  INTERNAL_DEPENDENCY_FAILED: "internal_dependency_failed",
+});
+
+export const ERROR_SEVERITY = Object.freeze(Object.fromEntries(["transient", "blocking_user_fixable", "blocking_internal", "policy_blocking"].map(value => [value.toUpperCase(), value])));
+export const ERROR_SOURCE_KIND = Object.freeze(Object.fromEntries(["user", "agentsam", "provider", "dependency", "runtime", "policy"].map(value => [value.toUpperCase(), value])));
+export const ERROR_RESOLUTION_OWNER = Object.freeze(Object.fromEntries(["user", "agentsam", "provider", "organization_admin", "policy", "unknown"].map(value => [value.toUpperCase(), value])));
+export const ERROR_DOMAIN = Object.freeze(Object.fromEntries(["runtime", "provider", "auth", "device", "terminal", "transport", "repository", "indexing", "knowledge", "cad", "deployment", "persistence", "policy", "tool"].map(value => [value.toUpperCase(), value])));
+export const REMEDIATION_ACTION = Object.freeze(Object.fromEntries(["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"].map(value => [value.toUpperCase(), value])));
+
+export const ERROR_REASON_POLICY = Object.freeze({
+  "unknown": Object.freeze({"code":"UNKNOWN","severity":"blocking_internal","retryable":false,"resolution_owner":"unknown","remediation_action":"inspect_platform"}),
+  "input_invalid": Object.freeze({"code":"INVALID_ARGUMENT","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "input_out_of_range": Object.freeze({"code":"OUT_OF_RANGE","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "precondition_failed": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_configuration"}),
+  "unsupported_operation": Object.freeze({"code":"UNIMPLEMENTED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_configuration"}),
+  "auth_missing": Object.freeze({"code":"UNAUTHENTICATED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reauthenticate"}),
+  "auth_invalid": Object.freeze({"code":"UNAUTHENTICATED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reauthenticate"}),
+  "permission_denied": Object.freeze({"code":"PERMISSION_DENIED","severity":"policy_blocking","retryable":false,"resolution_owner":"policy","remediation_action":"request_permission"}),
+  "user_permission_denied": Object.freeze({"code":"PERMISSION_DENIED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"request_permission"}),
+  "provider_not_connected": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"connect_provider"}),
+  "provider_credential_missing": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"configure_provider_credential"}),
+  "provider_credential_invalid": Object.freeze({"code":"UNAUTHENTICATED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"refresh_provider_credential"}),
+  "provider_credential_expired": Object.freeze({"code":"UNAUTHENTICATED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"refresh_provider_credential"}),
+  "provider_scope_insufficient": Object.freeze({"code":"PERMISSION_DENIED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"request_permission"}),
+  "provider_budget_exhausted": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"add_budget"}),
+  "provider_quota_exhausted": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"increase_quota"}),
+  "provider_rate_limited": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "provider_capacity_exhausted": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "provider_unavailable": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "provider_overloaded": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "provider_request_invalid": Object.freeze({"code":"INVALID_ARGUMENT","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "provider_model_not_found": Object.freeze({"code":"NOT_FOUND","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"select_model"}),
+  "provider_region_unsupported": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_region"}),
+  "provider_content_blocked": Object.freeze({"code":"PERMISSION_DENIED","severity":"policy_blocking","retryable":false,"resolution_owner":"policy","remediation_action":"none"}),
+  "context_window_exceeded": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reduce_scope"}),
+  "service_tier_unsupported": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_configuration"}),
+  "continuation_invalid": Object.freeze({"code":"FAILED_PRECONDITION","severity":"transient","retryable":true,"resolution_owner":"agentsam","remediation_action":"retry"}),
+  "target_not_found": Object.freeze({"code":"NOT_FOUND","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "already_exists": Object.freeze({"code":"ALREADY_EXISTS","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "conflict": Object.freeze({"code":"ABORTED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "stale_version": Object.freeze({"code":"ABORTED","severity":"transient","retryable":true,"resolution_owner":"user","remediation_action":"retry"}),
+  "rate_limited": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "quota_exhausted": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"increase_quota"}),
+  "capacity_exhausted": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "transport_unreachable": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "transport_refused": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "transport_timeout": Object.freeze({"code":"DEADLINE_EXCEEDED","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "upstream_invalid_response": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "dns_unresolved": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "tls_handshake_failed": Object.freeze({"code":"UNAVAILABLE","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "tls_certificate_invalid": Object.freeze({"code":"UNAVAILABLE","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "tunnel_connector_unavailable": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"user","remediation_action":"reconnect_service"}),
+  "cancelled": Object.freeze({"code":"CANCELLED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"none"}),
+  "deadline_exceeded": Object.freeze({"code":"DEADLINE_EXCEEDED","severity":"transient","retryable":true,"resolution_owner":"unknown","remediation_action":"retry_later"}),
+  "execution_timeout": Object.freeze({"code":"DEADLINE_EXCEEDED","severity":"transient","retryable":true,"resolution_owner":"unknown","remediation_action":"retry_later"}),
+  "execution_failed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"unknown","remediation_action":"inspect_platform"}),
+  "process_spawn_failed": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"install_dependency"}),
+  "process_crashed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"unknown","remediation_action":"inspect_platform"}),
+  "process_output_limit": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reduce_scope"}),
+  "device_not_enrolled": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reenroll_device"}),
+  "device_credential_missing": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reenroll_device"}),
+  "device_credential_invalid": Object.freeze({"code":"UNAUTHENTICATED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reenroll_device"}),
+  "device_credential_expired": Object.freeze({"code":"UNAUTHENTICATED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reenroll_device"}),
+  "device_registration_missing": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reenroll_device"}),
+  "device_registration_stale": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reenroll_device"}),
+  "connection_revoked": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reenroll_device"}),
+  "connection_disabled": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reconnect_service"}),
+  "identity_resolution_failed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "identity_mismatch": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "repository_scope_violation": Object.freeze({"code":"PERMISSION_DENIED","severity":"policy_blocking","retryable":false,"resolution_owner":"policy","remediation_action":"none"}),
+  "repository_changed": Object.freeze({"code":"ABORTED","severity":"transient","retryable":true,"resolution_owner":"user","remediation_action":"retry"}),
+  "index_stale": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"retry"}),
+  "index_failed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "embedding_failed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"unknown","remediation_action":"inspect_platform"}),
+  "vector_store_failed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "github_installation_missing": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"connect_provider"}),
+  "github_repository_not_found": Object.freeze({"code":"NOT_FOUND","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "github_rate_limited": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "github_secondary_rate_limited": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "github_scope_insufficient": Object.freeze({"code":"PERMISSION_DENIED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"request_permission"}),
+  "cloudflare_workers_cpu_exhausted": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "cloudflare_service_binding_unavailable": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "cloudflare_durable_object_unavailable": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "cloudflare_d1_unavailable": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "cloudflare_r2_unavailable": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "docker_daemon_unavailable": Object.freeze({"code":"UNAVAILABLE","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"restart_runtime"}),
+  "docker_image_not_found": Object.freeze({"code":"NOT_FOUND","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "docker_build_failed": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "docker_container_failed": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_configuration"}),
+  "docker_registry_auth_failed": Object.freeze({"code":"UNAUTHENTICATED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"reauthenticate"}),
+  "docker_pull_rate_limited": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "gcp_project_missing": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_configuration"}),
+  "gcp_api_disabled": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_configuration"}),
+  "gcp_quota_exhausted": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"increase_quota"}),
+  "gcp_vm_not_found": Object.freeze({"code":"NOT_FOUND","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "gcp_vm_unavailable": Object.freeze({"code":"UNAVAILABLE","severity":"transient","retryable":true,"resolution_owner":"provider","remediation_action":"retry_later"}),
+  "cad_tool_not_installed": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"install_dependency"}),
+  "cad_tool_not_executable": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"configure_dependency"}),
+  "cad_tool_version_incompatible": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"upgrade_dependency"}),
+  "cad_component_missing": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"install_dependency"}),
+  "cad_dependency_missing": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"install_dependency"}),
+  "cad_dependency_version_incompatible": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"upgrade_dependency"}),
+  "cad_source_parse_failed": Object.freeze({"code":"INVALID_ARGUMENT","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "cad_input_format_unsupported": Object.freeze({"code":"INVALID_ARGUMENT","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "cad_import_failed": Object.freeze({"code":"INVALID_ARGUMENT","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "cad_model_recompute_failed": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "cad_constraint_unsatisfied": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "cad_geometry_invalid": Object.freeze({"code":"INVALID_ARGUMENT","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "cad_null_shape": Object.freeze({"code":"INVALID_ARGUMENT","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "cad_boolean_failed": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "cad_kernel_failed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"unknown","remediation_action":"inspect_platform"}),
+  "cad_script_failed": Object.freeze({"code":"INVALID_ARGUMENT","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "cad_export_format_unsupported": Object.freeze({"code":"INVALID_ARGUMENT","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "cad_export_failed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"unknown","remediation_action":"inspect_platform"}),
+  "cad_output_missing": Object.freeze({"code":"DATA_LOSS","severity":"blocking_internal","retryable":false,"resolution_owner":"unknown","remediation_action":"inspect_platform"}),
+  "cad_output_invalid": Object.freeze({"code":"DATA_LOSS","severity":"blocking_internal","retryable":false,"resolution_owner":"unknown","remediation_action":"inspect_platform"}),
+  "cad_render_engine_unavailable": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_configuration"}),
+  "cad_gpu_unavailable": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_configuration"}),
+  "cad_render_failed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"unknown","remediation_action":"inspect_platform"}),
+  "cad_memory_exhausted": Object.freeze({"code":"RESOURCE_EXHAUSTED","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_configuration"}),
+  "cad_process_crashed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"unknown","remediation_action":"inspect_platform"}),
+  "cad_warning_escalated": Object.freeze({"code":"FAILED_PRECONDITION","severity":"blocking_user_fixable","retryable":false,"resolution_owner":"user","remediation_action":"change_input"}),
+  "policy_blocked": Object.freeze({"code":"PERMISSION_DENIED","severity":"policy_blocking","retryable":false,"resolution_owner":"policy","remediation_action":"none"}),
+  "copyright_blocked": Object.freeze({"code":"PERMISSION_DENIED","severity":"policy_blocking","retryable":false,"resolution_owner":"policy","remediation_action":"none"}),
+  "persistence_failed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "data_corrupt": Object.freeze({"code":"DATA_LOSS","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "data_loss": Object.freeze({"code":"DATA_LOSS","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "internal": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "internal_invariant_violation": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "internal_configuration_invalid": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "internal_contract_violation": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "internal_adapter_failed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+  "internal_dependency_failed": Object.freeze({"code":"INTERNAL","severity":"blocking_internal","retryable":false,"resolution_owner":"agentsam","remediation_action":"inspect_platform"}),
+});

package/packages/agentsam-errors/test/envelope.test.mjs

@@ -0,0 +1,70 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import {
+  AgentSamError,
+  ERROR_CODE,
+  ERROR_REASON,
+  createErrorEnvelope,
+  normalizeError,
+  parseError,
+  serializeError,
+} from '../src/index.js';
+
+test('reason policy supplies canonical code severity owner and remediation', () => {
+  const error = createErrorEnvelope({
+    reason: ERROR_REASON.PROVIDER_CREDENTIAL_MISSING,
+    message: 'OpenAI is not configured.',
+    source: { kind: 'user', name: 'project_configuration', service: 'openai' },
+    domain: 'provider',
+    provider: 'openai',
+  });
+  assert.equal(error.code, ERROR_CODE.FAILED_PRECONDITION);
+  assert.equal(error.severity, 'blocking_user_fixable');
+  assert.equal(error.resolution_owner, 'user');
+  assert.equal(error.remediation.action, 'configure_provider_credential');
+  assert.equal(error.retryable, false);
+});
+
+test('known reasons cannot drift to a contradictory canonical code', () => {
+  assert.throws(() => createErrorEnvelope({
+    reason: ERROR_REASON.PROVIDER_CREDENTIAL_MISSING,
+    code: ERROR_CODE.INTERNAL,
+    message: 'wrong',
+  }), /requires canonical code/);
+});
+
+test('blocking internal failures cannot prescribe user infrastructure edits', () => {
+  assert.throws(() => createErrorEnvelope({
+    reason: ERROR_REASON.INTERNAL,
+    message: 'bad internal state',
+    remediation: { action: 'change_configuration' },
+  }), /cannot prescribe user remediation/);
+});
+
+test('canonical envelopes round-trip without semantic loss', () => {
+  const source = createErrorEnvelope({
+    reason: ERROR_REASON.IDENTITY_RESOLUTION_FAILED,
+    message: 'Control plane identity lookup failed.',
+    source: { kind: 'agentsam', name: 'inneranimalmedia', service: 'terminal_control_plane' },
+    domain: 'device',
+    trace_id: 'trace_1',
+  });
+  const roundTrip = parseError(serializeError(source));
+  assert.deepEqual(roundTrip, source);
+});
+
+test('AgentSamError is a throwable view over the immutable envelope', () => {
+  const error = new AgentSamError({ reason: ERROR_REASON.INTERNAL_ADAPTER_FAILED, message: 'adapter failed' });
+  assert.equal(error.code, 'INTERNAL');
+  assert.equal(error.reason, 'internal_adapter_failed');
+  assert.equal(error.envelope.fingerprint, error.fingerprint);
+  assert.equal(Object.isFrozen(error.envelope), true);
+});
+
+test('unknown native Errors normalize to an AgentSam-owned internal failure', () => {
+  const error = normalizeError(Object.assign(new Error('boom'), { code: 'EBOOM' }));
+  assert.equal(error.reason, 'internal');
+  assert.equal(error.source.kind, 'agentsam');
+  assert.equal(error.resolution_owner, 'agentsam');
+  assert.equal(error.native.code, 'EBOOM');
+});

package/packages/agentsam-errors/test/providers.test.mjs

@@ -0,0 +1,99 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import {
+  classifyAnthropicFailure,
+  classifyCloudflareFailure,
+  classifyCursorFailure,
+  classifyGeminiFailure,
+  classifyGitHubFailure,
+  classifyGcpFailure,
+  classifyOpenAIFailure,
+} from '../src/index.js';
+
+test('missing OpenAI key is user configuration, not an OpenAI outage', () => {
+  const error = classifyOpenAIFailure({ credential_state: 'missing' });
+  assert.equal(error.reason, 'provider_credential_missing');
+  assert.equal(error.source.kind, 'user');
+  assert.equal(error.resolution_owner, 'user');
+  assert.equal(error.provider, 'openai');
+});
+
+test('OpenAI rejected key and exhausted budget stay distinct', () => {
+  const rejected = classifyOpenAIFailure({ status: 401, code: 'invalid_api_key', message: 'Incorrect API key' });
+  const budget = classifyOpenAIFailure({ status: 429, code: 'project_spend_limit_exceeded', message: 'budget reached' });
+  assert.equal(rejected.reason, 'provider_credential_invalid');
+  assert.equal(rejected.source.kind, 'provider');
+  assert.equal(rejected.resolution_owner, 'user');
+  assert.equal(budget.reason, 'provider_budget_exhausted');
+  assert.equal(budget.retryable, false);
+  assert.equal(budget.remediation.action, 'add_budget');
+});
+
+test('the same provider budget response is internal when the provider account is AgentSam-owned', () => {
+  const error = classifyOpenAIFailure(
+    { status: 429, code: 'project_spend_limit_exceeded', message: 'budget reached' },
+    { credential_owner: 'agentsam' },
+  );
+  assert.equal(error.reason, 'provider_budget_exhausted');
+  assert.equal(error.source.kind, 'provider');
+  assert.equal(error.source.name, 'openai');
+  assert.equal(error.resolution_owner, 'agentsam');
+  assert.equal(error.severity, 'blocking_internal');
+  assert.equal(error.remediation.action, 'inspect_platform');
+});
+
+test('organization-owned provider account failures route to the organization administrator', () => {
+  const error = classifyGeminiFailure(
+    { status_name: 'RESOURCE_EXHAUSTED', message: 'Quota exceeded' },
+    { account_owner: 'organization' },
+  );
+  assert.equal(error.reason, 'provider_quota_exhausted');
+  assert.equal(error.resolution_owner, 'organization_admin');
+  assert.equal(error.remediation.action, 'contact_organization_admin');
+});
+
+test('provider invalid request can be attributed to AgentSam when AgentSam authored it', () => {
+  const error = classifyOpenAIFailure({ status: 400, code: 'invalid_request_error', message: 'invalid generated request' }, { request_origin: 'agentsam' });
+  assert.equal(error.reason, 'provider_request_invalid');
+  assert.equal(error.source.kind, 'provider');
+  assert.equal(error.resolution_owner, 'agentsam');
+  assert.equal(error.severity, 'blocking_internal');
+  assert.equal(error.remediation.action, 'inspect_platform');
+});
+
+test('Anthropic overload is transient provider ownership', () => {
+  const error = classifyAnthropicFailure({ status: 529, type: 'overloaded_error', message: 'Overloaded' });
+  assert.equal(error.reason, 'provider_overloaded');
+  assert.equal(error.retryable, true);
+  assert.equal(error.resolution_owner, 'provider');
+});
+
+test('Gemini resource exhaustion is classified separately from invalid API key', () => {
+  const quota = classifyGeminiFailure({ status: 429, status_name: 'RESOURCE_EXHAUSTED', message: 'Quota exceeded' });
+  const key = classifyGeminiFailure({ status: 400, message: 'API key not valid. Please pass a valid API key.' });
+  assert.equal(quota.reason, 'provider_quota_exhausted');
+  assert.equal(quota.resolution_owner, 'user');
+  assert.equal(key.reason, 'provider_credential_invalid');
+});
+
+test('Cursor uses the generic provider contract rather than a parallel vocabulary', () => {
+  const error = classifyCursorFailure({ status: 503, message: 'Service unavailable' });
+  assert.equal(error.reason, 'provider_unavailable');
+  assert.equal(error.provider, 'cursor');
+  assert.equal(error.retryable, true);
+});
+
+test('GitHub differentiates installation, scopes and rate limits', () => {
+  assert.equal(classifyGitHubFailure({ installation_state: 'missing' }).reason, 'github_installation_missing');
+  assert.equal(classifyGitHubFailure({ status: 403, message: 'Resource not accessible by integration' }).reason, 'github_scope_insufficient');
+  assert.equal(classifyGitHubFailure({ status: 403, message: 'API rate limit exceeded', headers: { 'x-ratelimit-remaining': '0' } }).reason, 'github_rate_limited');
+});
+
+test('Cloudflare and GCP retain infrastructure-specific actionable reasons', () => {
+  const tunnel = classifyCloudflareFailure({ status: 530, cloudflare_code: 1033, message: 'tunnel unavailable' });
+  const quota = classifyGcpFailure({ status_name: 'RESOURCE_EXHAUSTED', message: 'Compute Engine quota exceeded' }, { resource: { type: 'vm', id: 'vm_1' } });
+  assert.equal(tunnel.reason, 'tunnel_connector_unavailable');
+  assert.equal(tunnel.remediation.action, 'reconnect_service');
+  assert.equal(quota.reason, 'gcp_quota_exhausted');
+  assert.equal(quota.remediation.action, 'increase_quota');
+});

package/packages/agentsam-errors/test/redaction.test.mjs

@@ -0,0 +1,21 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { redactErrorValue, redactString } from '../src/index.js';
+
+test('redaction never leaks machine credential values', () => {
+  const leaked = redactString('key=aak_liveMachineKey12345678 secret=sk-testKey1234567890');
+  assert.ok(!leaked.includes('aak_liveMachineKey12345678'), 'agent API key must be redacted');
+  assert.ok(!leaked.includes('sk-testKey1234567890'), 'provider key must be redacted');
+  assert.ok(leaked.includes('[REDACTED]'), 'redaction marker must be present');
+});
+
+test('redaction strips credential-named object keys at any depth', () => {
+  const value = redactErrorValue({
+    provider: 'openai',
+    credentials: { api_key: 'sk-testKey1234567890', mode: 'byok' },
+    nested: { list: [{ authorization: 'Bearer abcdef123456' }] },
+  });
+  assert.equal(value.credentials, '[REDACTED]', 'credential-named objects redact wholesale');
+  assert.equal(value.nested.list[0].authorization, '[REDACTED]');
+  assert.equal(value.provider, 'openai');
+});

package/packages/agentsam-errors/test/runtime-cad-device.test.mjs

@@ -0,0 +1,76 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import {
+  classifyBlenderFailure,
+  classifyDeviceFailure,
+  classifyDockerFailure,
+  classifyFreeCadFailure,
+  classifyInternalFailure,
+  classifyMeshyFailure,
+  classifyOpenScadFailure,
+  classifyProcessFailure,
+} from '../src/index.js';
+
+test('Docker daemon absence is user-fixable runtime configuration', () => {
+  const error = classifyDockerFailure({ stderr: 'Cannot connect to the Docker daemon. Is the docker daemon running?' }, { stage: 'run' });
+  assert.equal(error.reason, 'docker_daemon_unavailable');
+  assert.equal(error.source.kind, 'runtime');
+  assert.equal(error.resolution_owner, 'user');
+  assert.equal(error.remediation.action, 'restart_runtime');
+});
+
+test('process timeout and missing executable remain separate', () => {
+  const timeout = classifyProcessFailure({ timeout: true, code: 'PROCESS_TIMEOUT' });
+  const missing = classifyProcessFailure({ spawn_failed: true, code: 'ENOENT' }, { tool: 'git' });
+  assert.equal(timeout.reason, 'execution_timeout');
+  assert.equal(timeout.retryable, true);
+  assert.equal(missing.reason, 'process_spawn_failed');
+  assert.equal(missing.tool, 'git');
+});
+
+test('FreeCAD native exception hierarchy survives normalization', () => {
+  assert.equal(classifyFreeCadFailure({ exception_type: 'Part::BooleanException' }, { stage: 'boolean' }).reason, 'cad_boolean_failed');
+  assert.equal(classifyFreeCadFailure({ exception_type: 'Part::NullShapeException' }).reason, 'cad_null_shape');
+  assert.equal(classifyFreeCadFailure({ exception_type: 'Base::CADKernelError' }).reason, 'cad_kernel_failed');
+  assert.equal(classifyFreeCadFailure({ exception_type: 'Base::MemoryException' }).reason, 'cad_memory_exhausted');
+});
+
+test('OpenSCAD parser and geometry failures are distinct', () => {
+  assert.equal(classifyOpenScadFailure({ stderr: 'ERROR: Parser error: syntax error' }, { stage: 'parse' }).reason, 'cad_source_parse_failed');
+  assert.equal(classifyOpenScadFailure({ stderr: 'WARNING: No top level geometry to render' }, { stage: 'build' }).reason, 'cad_geometry_invalid');
+});
+
+test('Blender discovery and render environment failures are actionable', () => {
+  const missing = classifyBlenderFailure({ installed: false }, { stage: 'discovery' });
+  const gpu = classifyBlenderFailure({ message: 'No compatible GPU available' }, { stage: 'render' });
+  assert.equal(missing.reason, 'cad_tool_not_installed');
+  assert.equal(missing.remediation.action, 'install_dependency');
+  assert.equal(gpu.reason, 'cad_gpu_unavailable');
+});
+
+test('Meshy is a CAD-domain provider and preserves provider quota semantics', () => {
+  const error = classifyMeshyFailure({ status: 429, message: 'quota exceeded' });
+  assert.equal(error.domain, 'cad');
+  assert.equal(error.tool, 'meshy');
+  assert.equal(error.reason, 'provider_quota_exhausted');
+});
+
+test('device user failures and InnerAnimalMedia control-plane defects cannot be confused', () => {
+  const unenrolled = classifyDeviceFailure({ state: 'not_enrolled' });
+  const internal = classifyDeviceFailure({ state: 'identity_resolution_failed', trace_id: 'tr_1' });
+  assert.equal(unenrolled.reason, 'device_not_enrolled');
+  assert.equal(unenrolled.resolution_owner, 'user');
+  assert.equal(unenrolled.remediation.action, 'reenroll_device');
+  assert.equal(internal.reason, 'identity_resolution_failed');
+  assert.equal(internal.source.kind, 'agentsam');
+  assert.equal(internal.source.name, 'inneranimalmedia');
+  assert.equal(internal.resolution_owner, 'agentsam');
+  assert.equal(internal.severity, 'blocking_internal');
+});
+
+test('explicit internal failures are always AgentSam-owned', () => {
+  const error = classifyInternalFailure({ code: 'ASSERTION', message: 'bad invariant' }, { reason: 'internal_invariant_violation', system: 'agentsam-sdk' });
+  assert.equal(error.resolution_owner, 'agentsam');
+  assert.equal(error.source.name, 'agentsam-sdk');
+  assert.equal(error.remediation.action, 'inspect_platform');
+});