recoder-a2a-sdk 1.0.0 → 1.0.1

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/schemas/index.ts","../../src/schemas/task-envelope.ts","../../src/schemas/audit-event.ts","../../src/schemas/error-taxonomy.ts"],"sourcesContent":["/**\n * @module schemas\n *\n * Canonical TypeScript schemas for the Recoder A2A control plane.\n * Inlined from @recoder/shared/a2a/schemas for standalone publishing.\n */\n\n// Re-export shared types\nexport type {\n  RecoderAgentPlatform,\n  RecoderPayload,\n  RecoderTextPayload,\n  RecoderJsonPayload,\n  RecoderCommandPayload,\n  RecoderArtifactPayload,\n  A2AProtocolKind,\n} from './types';\n\nexport {\n  TASK_ENVELOPE_VERSION,\n  TaskStateEnum,\n  TASK_STATES,\n  TERMINAL_TASK_STATES,\n  isTerminalState,\n  ALLOWED_STATE_TRANSITIONS,\n  isValidTransition,\n  transitionTaskEnvelope,\n  createTaskEnvelope,\n  type TaskState,\n  type TaskStateTransition,\n  type TaskConnectorInfo,\n  type TaskAgentRef,\n  type TaskResult,\n  type TaskArtifact,\n  type TaskPolicySnapshot,\n  type TaskErrorInfo,\n  type TaskEnvelope,\n  type CreateTaskEnvelopeInput,\n} from './task-envelope';\n\nexport {\n  AUDIT_EVENT_VERSION,\n  AuditEventTypeEnum,\n  AUDIT_EVENT_TYPES,\n  AuditActorKindEnum,\n  AuditTargetKindEnum,\n  AuditSeverityEnum,\n  createAuditEvent,\n  type AuditEventType,\n  type AuditActorKind,\n  type AuditActor,\n  type AuditTargetKind,\n  type AuditTarget,\n  type AuditPolicyContext,\n  type AuditSeverity,\n  type AuditEvent,\n  type CreateAuditEventInput,\n} from './audit-event';\n\nexport {\n  A2AErrorSeverityEnum,\n  A2AErrorCategoryEnum,\n  A2AErrorCodeEnum,\n  A2A_ERROR_CODE_REGISTRY,\n  buildA2AError,\n  getErrorCodeMeta,\n  isA2AErrorCode,\n  A2AStructuredError,\n  type A2AErrorSeverity,\n  type A2AErrorCategory,\n  type A2AErrorCode,\n  type A2AErrorCodeMeta,\n  type A2AError,\n} from './error-taxonomy';\n","/**\n * @module task-envelope\n *\n * Canonical TaskEnvelope schema for the Recoder A2A control plane.\n */\n\nimport type {\n  RecoderAgentPlatform,\n  RecoderPayload,\n  A2AProtocolKind,\n  TaskState as ControlPlaneTaskState,\n} from './types';\n\n// ---------------------------------------------------------------------------\n// Version\n// ---------------------------------------------------------------------------\n\n/** Current version of the TaskEnvelope schema. */\nexport const TASK_ENVELOPE_VERSION = '1.0.0' as const;\n\n// ---------------------------------------------------------------------------\n// Task State\n// ---------------------------------------------------------------------------\n\nexport type TaskState = ControlPlaneTaskState;\n\nexport const TaskStateEnum = {\n  /** Task has been created and is awaiting execution. */\n  Submitted: 'submitted' as const satisfies TaskState,\n  /** Task is actively being processed by the assignee agent. */\n  Working: 'working' as const satisfies TaskState,\n  /** The assignee needs additional input before it can continue. */\n  InputRequired: 'input-required' as const satisfies TaskState,\n  /** Task finished successfully. */\n  Completed: 'completed' as const satisfies TaskState,\n  /** Task terminated with an error. */\n  Failed: 'failed' as const satisfies TaskState,\n  /** Task was explicitly cancelled by a requester or operator. */\n  Cancelled: 'cancelled' as const satisfies TaskState,\n} as const;\n\n/** Ordered list of all task states (useful for validation). */\nexport const TASK_STATES: readonly TaskState[] = [\n  TaskStateEnum.Submitted,\n  TaskStateEnum.Working,\n  TaskStateEnum.InputRequired,\n  TaskStateEnum.Completed,\n  TaskStateEnum.Failed,\n  TaskStateEnum.Cancelled,\n] as const;\n\n/** Set of terminal states -- once a task reaches one of these it cannot transition further. */\nexport const TERMINAL_TASK_STATES: ReadonlySet<TaskState> = new Set<TaskState>([\n  TaskStateEnum.Completed,\n  TaskStateEnum.Failed,\n  TaskStateEnum.Cancelled,\n]);\n\n/**\n * Returns true when the given state is a terminal state.\n */\nexport function isTerminalState(state: TaskState): boolean {\n  return TERMINAL_TASK_STATES.has(state);\n}\n\n// ---------------------------------------------------------------------------\n// Task State Transition\n// ---------------------------------------------------------------------------\n\nexport interface TaskStateTransition {\n  from: TaskState;\n  to: TaskState;\n  transitioned_at: string;\n  reason?: string;\n  triggered_by?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Connector Info\n// ---------------------------------------------------------------------------\n\nexport interface TaskConnectorInfo {\n  platform: RecoderAgentPlatform;\n  protocol: A2AProtocolKind;\n  connector_id: string;\n  name?: string;\n  metadata?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Agent Reference\n// ---------------------------------------------------------------------------\n\nexport interface TaskAgentRef {\n  agent_id: string;\n  platform: RecoderAgentPlatform;\n  name?: string;\n  instance_id?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Task Result\n// ---------------------------------------------------------------------------\n\nexport interface TaskResult {\n  text?: string;\n  data?: Record<string, unknown>;\n  artifacts?: TaskArtifact[];\n}\n\nexport interface TaskArtifact {\n  key: string;\n  artifact_type: 'patch' | 'file' | 'plan' | 'report' | 'log' | 'custom';\n  mime_type: string;\n  content: string;\n  path?: string;\n  metadata?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Policy Snapshot\n// ---------------------------------------------------------------------------\n\nexport interface TaskPolicySnapshot {\n  action: string;\n  approved: boolean;\n  rule: string;\n  reason: string;\n  checked_at: string;\n}\n\n// ---------------------------------------------------------------------------\n// Error Info\n// ---------------------------------------------------------------------------\n\nexport interface TaskErrorInfo {\n  code: string;\n  category: string;\n  message: string;\n  severity: 'low' | 'medium' | 'high' | 'critical';\n  retryable: boolean;\n  details?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// TaskEnvelope\n// ---------------------------------------------------------------------------\n\nexport interface TaskEnvelope {\n  envelope_version: string;\n  id: string;\n  workspace_id: string;\n  thread_id: string;\n  trace_id: string;\n  parent_id?: string;\n  state: TaskState;\n  history?: TaskStateTransition[];\n  requester: TaskAgentRef;\n  assignee: TaskAgentRef;\n  connector: TaskConnectorInfo;\n  payload: RecoderPayload | RecoderPayload[];\n  result?: TaskResult;\n  error?: TaskErrorInfo;\n  policy?: TaskPolicySnapshot[];\n  created_at: string;\n  updated_at: string;\n  tokensUsed?: number;\n  estimatedCostUsd?: number;\n  retryCount?: number;\n  metadata?: Record<string, unknown>;\n  tags?: string[];\n}\n\n// ---------------------------------------------------------------------------\n// Factory helper\n// ---------------------------------------------------------------------------\n\nexport interface CreateTaskEnvelopeInput {\n  id: string;\n  workspace_id: string;\n  thread_id: string;\n  trace_id: string;\n  parent_id?: string;\n  requester: TaskAgentRef;\n  assignee: TaskAgentRef;\n  connector: TaskConnectorInfo;\n  payload: RecoderPayload | RecoderPayload[];\n  metadata?: Record<string, unknown>;\n  tags?: string[];\n  initial_state?: TaskState;\n  now?: string;\n}\n\nexport function createTaskEnvelope(input: CreateTaskEnvelopeInput): TaskEnvelope {\n  const now = input.now ?? new Date().toISOString();\n  return {\n    envelope_version: TASK_ENVELOPE_VERSION,\n    id: input.id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    trace_id: input.trace_id,\n    parent_id: input.parent_id,\n    state: input.initial_state ?? TaskStateEnum.Submitted,\n    history: [],\n    requester: input.requester,\n    assignee: input.assignee,\n    connector: input.connector,\n    payload: input.payload,\n    created_at: now,\n    updated_at: now,\n    metadata: input.metadata,\n    tags: input.tags,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// State transition helper\n// ---------------------------------------------------------------------------\n\nexport const ALLOWED_STATE_TRANSITIONS: Readonly<Record<TaskState, readonly TaskState[]>> = {\n  [TaskStateEnum.Submitted]: [TaskStateEnum.Working, TaskStateEnum.Cancelled, TaskStateEnum.Failed],\n  [TaskStateEnum.Working]: [\n    TaskStateEnum.Completed,\n    TaskStateEnum.Failed,\n    TaskStateEnum.Cancelled,\n    TaskStateEnum.InputRequired,\n  ],\n  [TaskStateEnum.InputRequired]: [TaskStateEnum.Working, TaskStateEnum.Cancelled, TaskStateEnum.Failed],\n  [TaskStateEnum.Completed]: [],\n  [TaskStateEnum.Failed]: [],\n  [TaskStateEnum.Cancelled]: [],\n};\n\nexport function isValidTransition(from: TaskState, to: TaskState): boolean {\n  return (ALLOWED_STATE_TRANSITIONS[from] ?? []).includes(to);\n}\n\nexport function transitionTaskEnvelope(\n  envelope: TaskEnvelope,\n  to: TaskState,\n  options?: { reason?: string; triggered_by?: string; now?: string }\n): TaskEnvelope {\n  if (!isValidTransition(envelope.state, to)) {\n    throw new Error(\n      `Invalid task state transition: ${envelope.state} -> ${to} (task ${envelope.id})`\n    );\n  }\n\n  const now = options?.now ?? new Date().toISOString();\n  const transition: TaskStateTransition = {\n    from: envelope.state,\n    to,\n    transitioned_at: now,\n    reason: options?.reason,\n    triggered_by: options?.triggered_by,\n  };\n\n  return {\n    ...envelope,\n    state: to,\n    updated_at: now,\n    history: [...(envelope.history ?? []), transition],\n  };\n}\n","/**\n * @module audit-event\n *\n * Canonical AuditEvent schema for the Recoder A2A control plane.\n */\n\nimport type { RecoderAgentPlatform } from './types';\n\n// ---------------------------------------------------------------------------\n// Version\n// ---------------------------------------------------------------------------\n\n/** Current version of the AuditEvent schema. */\nexport const AUDIT_EVENT_VERSION = '1.0.0' as const;\n\n// ---------------------------------------------------------------------------\n// Event types\n// ---------------------------------------------------------------------------\n\nexport const AuditEventTypeEnum = {\n  // -- task lifecycle ---------------------------------------------------------\n  TaskSubmitted: 'task.submitted',\n  TaskStarted: 'task.started',\n  TaskProgress: 'task.progress',\n  TaskInputRequired: 'task.input_required',\n  TaskCompleted: 'task.completed',\n  TaskFailed: 'task.failed',\n  TaskCancelled: 'task.cancelled',\n\n  // -- policy decisions -------------------------------------------------------\n  PolicyChecked: 'policy.checked',\n  PolicyApproved: 'policy.approved',\n  PolicyDenied: 'policy.denied',\n\n  // -- connector events -------------------------------------------------------\n  ConnectorAttached: 'connector.attached',\n  ConnectorDetached: 'connector.detached',\n  ConnectorHealth: 'connector.health',\n  ConnectorError: 'connector.error',\n\n  // -- agent registry ---------------------------------------------------------\n  AgentRegistered: 'agent.registered',\n  AgentUnregistered: 'agent.unregistered',\n  AgentUpdated: 'agent.updated',\n\n  // -- collaboration ----------------------------------------------------------\n  ChannelCreated: 'collaboration.channel_created',\n  ThreadCreated: 'collaboration.thread_created',\n  MessageSent: 'collaboration.message_sent',\n\n  // -- system -----------------------------------------------------------------\n  SystemConfig: 'system.config',\n  SystemError: 'system.error',\n} as const;\n\n/** Union of all valid audit event type string values. */\nexport type AuditEventType = (typeof AuditEventTypeEnum)[keyof typeof AuditEventTypeEnum];\n\n/** Ordered list of all event types (useful for validation / UI dropdowns). */\nexport const AUDIT_EVENT_TYPES: readonly AuditEventType[] = Object.values(AuditEventTypeEnum);\n\n// ---------------------------------------------------------------------------\n// Actor\n// ---------------------------------------------------------------------------\n\nexport const AuditActorKindEnum = {\n  Agent: 'agent',\n  User: 'user',\n  System: 'system',\n  Connector: 'connector',\n} as const;\n\nexport type AuditActorKind = (typeof AuditActorKindEnum)[keyof typeof AuditActorKindEnum];\n\nexport interface AuditActor {\n  kind: AuditActorKind;\n  id: string;\n  name?: string;\n  platform?: RecoderAgentPlatform;\n  metadata?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Target\n// ---------------------------------------------------------------------------\n\nexport const AuditTargetKindEnum = {\n  Task: 'task',\n  Agent: 'agent',\n  Connector: 'connector',\n  Channel: 'channel',\n  Thread: 'thread',\n  Message: 'message',\n  Policy: 'policy',\n  Workspace: 'workspace',\n  System: 'system',\n} as const;\n\nexport type AuditTargetKind = (typeof AuditTargetKindEnum)[keyof typeof AuditTargetKindEnum];\n\nexport interface AuditTarget {\n  kind: AuditTargetKind;\n  id: string;\n  name?: string;\n  metadata?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Policy Context\n// ---------------------------------------------------------------------------\n\nexport interface AuditPolicyContext {\n  action: string;\n  rule: string;\n  approved: boolean;\n  reason: string;\n  agent_id: string;\n  details?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Severity\n// ---------------------------------------------------------------------------\n\nexport const AuditSeverityEnum = {\n  Info: 'info',\n  Warning: 'warning',\n  Error: 'error',\n  Critical: 'critical',\n} as const;\n\nexport type AuditSeverity = (typeof AuditSeverityEnum)[keyof typeof AuditSeverityEnum];\n\n// ---------------------------------------------------------------------------\n// AuditEvent\n// ---------------------------------------------------------------------------\n\nexport interface AuditEvent {\n  schema_version: string;\n  id: string;\n  event_type: AuditEventType;\n  severity?: AuditSeverity;\n  actor: AuditActor;\n  target: AuditTarget;\n  trace_id: string;\n  parent_event_id?: string;\n  workspace_id: string;\n  thread_id?: string;\n  task_id?: string;\n  timestamp: string;\n  duration_ms?: number;\n  policy?: AuditPolicyContext;\n  metadata?: Record<string, unknown>;\n  tags?: string[];\n}\n\n// ---------------------------------------------------------------------------\n// Factory helper\n// ---------------------------------------------------------------------------\n\nexport interface CreateAuditEventInput {\n  id: string;\n  event_type: AuditEventType;\n  actor: AuditActor;\n  target: AuditTarget;\n  trace_id: string;\n  workspace_id: string;\n  thread_id?: string;\n  task_id?: string;\n  parent_event_id?: string;\n  severity?: AuditSeverity;\n  policy?: AuditPolicyContext;\n  metadata?: Record<string, unknown>;\n  tags?: string[];\n  duration_ms?: number;\n  now?: string;\n}\n\nexport function createAuditEvent(input: CreateAuditEventInput): AuditEvent {\n  return {\n    schema_version: AUDIT_EVENT_VERSION,\n    id: input.id,\n    event_type: input.event_type,\n    severity: input.severity,\n    actor: input.actor,\n    target: input.target,\n    trace_id: input.trace_id,\n    parent_event_id: input.parent_event_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    timestamp: input.now ?? new Date().toISOString(),\n    duration_ms: input.duration_ms,\n    policy: input.policy,\n    metadata: input.metadata,\n    tags: input.tags,\n  };\n}\n","/**\n * @module error-taxonomy\n *\n * Canonical error taxonomy for the Recoder A2A system.\n */\n\n// ---------------------------------------------------------------------------\n// Error severity\n// ---------------------------------------------------------------------------\n\nexport const A2AErrorSeverityEnum = {\n  Low: 'low',\n  Medium: 'medium',\n  High: 'high',\n  Critical: 'critical',\n} as const;\n\nexport type A2AErrorSeverity = (typeof A2AErrorSeverityEnum)[keyof typeof A2AErrorSeverityEnum];\n\n// ---------------------------------------------------------------------------\n// Error categories\n// ---------------------------------------------------------------------------\n\nexport const A2AErrorCategoryEnum = {\n  Envelope: 'envelope',\n  Connector: 'connector',\n  Policy: 'policy',\n  Task: 'task',\n  Registry: 'registry',\n  Collaboration: 'collaboration',\n  Transport: 'transport',\n  Auth: 'auth',\n  RateLimit: 'rate_limit',\n  Internal: 'internal',\n} as const;\n\nexport type A2AErrorCategory = (typeof A2AErrorCategoryEnum)[keyof typeof A2AErrorCategoryEnum];\n\n// ---------------------------------------------------------------------------\n// Error codes\n// ---------------------------------------------------------------------------\n\nexport const A2AErrorCodeEnum = {\n  // -- envelope ---------------------------------------------------------------\n  InvalidEnvelope: 'INVALID_ENVELOPE',\n  UnsupportedEnvelopeVersion: 'UNSUPPORTED_ENVELOPE_VERSION',\n  MissingEnvelopeField: 'MISSING_ENVELOPE_FIELD',\n  InvalidPayload: 'INVALID_PAYLOAD',\n  InvalidParams: 'INVALID_ENVELOPE',\n\n  // -- connector --------------------------------------------------------------\n  ConnectorNotFound: 'CONNECTOR_NOT_FOUND',\n  ConnectorTimeout: 'CONNECTOR_TIMEOUT',\n  ConnectorError: 'CONNECTOR_ERROR',\n  ConnectorUnavailable: 'CONNECTOR_UNAVAILABLE',\n  ProtocolMismatch: 'PROTOCOL_MISMATCH',\n\n  // -- policy -----------------------------------------------------------------\n  PolicyDenied: 'POLICY_DENIED',\n  PolicyHandlerMissing: 'POLICY_HANDLER_MISSING',\n  PolicyTimeout: 'POLICY_TIMEOUT',\n\n  // -- task -------------------------------------------------------------------\n  TaskNotFound: 'TASK_NOT_FOUND',\n  InvalidStateTransition: 'INVALID_STATE_TRANSITION',\n  TaskAlreadyTerminal: 'TASK_ALREADY_TERMINAL',\n  TaskExecutionFailed: 'TASK_EXECUTION_FAILED',\n  TaskCancelled: 'TASK_CANCELLED',\n\n  // -- registry ---------------------------------------------------------------\n  AgentNotFound: 'AGENT_NOT_FOUND',\n  AgentAlreadyRegistered: 'AGENT_ALREADY_REGISTERED',\n  CapabilityNotFound: 'CAPABILITY_NOT_FOUND',\n\n  // -- collaboration ----------------------------------------------------------\n  ChannelNotFound: 'CHANNEL_NOT_FOUND',\n  ThreadNotFound: 'THREAD_NOT_FOUND',\n  MessageNotFound: 'MESSAGE_NOT_FOUND',\n  NotChannelMember: 'NOT_CHANNEL_MEMBER',\n\n  // -- transport --------------------------------------------------------------\n  NetworkError: 'NETWORK_ERROR',\n  UnexpectedStatus: 'UNEXPECTED_STATUS',\n  SerializationError: 'SERIALIZATION_ERROR',\n\n  // -- auth -------------------------------------------------------------------\n  AuthenticationFailed: 'AUTHENTICATION_FAILED',\n  AuthorizationDenied: 'AUTHORIZATION_DENIED',\n  TokenExpired: 'TOKEN_EXPIRED',\n\n  // -- rate limit -------------------------------------------------------------\n  RateLimitExceeded: 'RATE_LIMIT_EXCEEDED',\n  QuotaExceeded: 'QUOTA_EXCEEDED',\n\n  // -- internal ---------------------------------------------------------------\n  InternalError: 'INTERNAL_ERROR',\n  ConfigurationError: 'CONFIGURATION_ERROR',\n} as const;\n\nexport type A2AErrorCode = (typeof A2AErrorCodeEnum)[keyof typeof A2AErrorCodeEnum];\n\n// ---------------------------------------------------------------------------\n// Error code metadata\n// ---------------------------------------------------------------------------\n\nexport interface A2AErrorCodeMeta {\n  code: A2AErrorCode;\n  category: A2AErrorCategory;\n  severity: A2AErrorSeverity;\n  retryable: boolean;\n  description: string;\n}\n\nexport const A2A_ERROR_CODE_REGISTRY: Readonly<Record<A2AErrorCode, A2AErrorCodeMeta>> = {\n  // envelope\n  [A2AErrorCodeEnum.InvalidEnvelope]: {\n    code: A2AErrorCodeEnum.InvalidEnvelope,\n    category: A2AErrorCategoryEnum.Envelope,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The envelope failed structural validation.',\n  },\n  [A2AErrorCodeEnum.UnsupportedEnvelopeVersion]: {\n    code: A2AErrorCodeEnum.UnsupportedEnvelopeVersion,\n    category: A2AErrorCategoryEnum.Envelope,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The envelope version is not supported by this service.',\n  },\n  [A2AErrorCodeEnum.MissingEnvelopeField]: {\n    code: A2AErrorCodeEnum.MissingEnvelopeField,\n    category: A2AErrorCategoryEnum.Envelope,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'A required field is missing from the envelope.',\n  },\n  [A2AErrorCodeEnum.InvalidPayload]: {\n    code: A2AErrorCodeEnum.InvalidPayload,\n    category: A2AErrorCategoryEnum.Envelope,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The payload kind is unknown or malformed.',\n  },\n\n  // connector\n  [A2AErrorCodeEnum.ConnectorNotFound]: {\n    code: A2AErrorCodeEnum.ConnectorNotFound,\n    category: A2AErrorCategoryEnum.Connector,\n    severity: A2AErrorSeverityEnum.High,\n    retryable: false,\n    description: 'No connector is attached for the target agent.',\n  },\n  [A2AErrorCodeEnum.ConnectorTimeout]: {\n    code: A2AErrorCodeEnum.ConnectorTimeout,\n    category: A2AErrorCategoryEnum.Connector,\n    severity: A2AErrorSeverityEnum.High,\n    retryable: true,\n    description: 'The connector timed out during task execution.',\n  },\n  [A2AErrorCodeEnum.ConnectorError]: {\n    code: A2AErrorCodeEnum.ConnectorError,\n    category: A2AErrorCategoryEnum.Connector,\n    severity: A2AErrorSeverityEnum.High,\n    retryable: true,\n    description: 'The connector returned an unexpected error.',\n  },\n  [A2AErrorCodeEnum.ConnectorUnavailable]: {\n    code: A2AErrorCodeEnum.ConnectorUnavailable,\n    category: A2AErrorCategoryEnum.Connector,\n    severity: A2AErrorSeverityEnum.High,\n    retryable: true,\n    description: 'The connector is temporarily unavailable.',\n  },\n  [A2AErrorCodeEnum.ProtocolMismatch]: {\n    code: A2AErrorCodeEnum.ProtocolMismatch,\n    category: A2AErrorCategoryEnum.Connector,\n    severity: A2AErrorSeverityEnum.High,\n    retryable: false,\n    description: 'Protocol mismatch between connector and remote agent.',\n  },\n\n  // policy\n  [A2AErrorCodeEnum.PolicyDenied]: {\n    code: A2AErrorCodeEnum.PolicyDenied,\n    category: A2AErrorCategoryEnum.Policy,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The policy plane denied the requested action.',\n  },\n  [A2AErrorCodeEnum.PolicyHandlerMissing]: {\n    code: A2AErrorCodeEnum.PolicyHandlerMissing,\n    category: A2AErrorCategoryEnum.Policy,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'No prompt handler is configured for the policy rule.',\n  },\n  [A2AErrorCodeEnum.PolicyTimeout]: {\n    code: A2AErrorCodeEnum.PolicyTimeout,\n    category: A2AErrorCategoryEnum.Policy,\n    severity: A2AErrorSeverityEnum.High,\n    retryable: true,\n    description: 'The policy evaluation timed out.',\n  },\n\n  // task\n  [A2AErrorCodeEnum.TaskNotFound]: {\n    code: A2AErrorCodeEnum.TaskNotFound,\n    category: A2AErrorCategoryEnum.Task,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The task was not found.',\n  },\n  [A2AErrorCodeEnum.InvalidStateTransition]: {\n    code: A2AErrorCodeEnum.InvalidStateTransition,\n    category: A2AErrorCategoryEnum.Task,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'An invalid state transition was attempted.',\n  },\n  [A2AErrorCodeEnum.TaskAlreadyTerminal]: {\n    code: A2AErrorCodeEnum.TaskAlreadyTerminal,\n    category: A2AErrorCategoryEnum.Task,\n    severity: A2AErrorSeverityEnum.Low,\n    retryable: false,\n    description: 'The task has already reached a terminal state.',\n  },\n  [A2AErrorCodeEnum.TaskExecutionFailed]: {\n    code: A2AErrorCodeEnum.TaskExecutionFailed,\n    category: A2AErrorCategoryEnum.Task,\n    severity: A2AErrorSeverityEnum.High,\n    retryable: true,\n    description: 'The task failed during execution.',\n  },\n  [A2AErrorCodeEnum.TaskCancelled]: {\n    code: A2AErrorCodeEnum.TaskCancelled,\n    category: A2AErrorCategoryEnum.Task,\n    severity: A2AErrorSeverityEnum.Low,\n    retryable: false,\n    description: 'The task was cancelled.',\n  },\n\n  // registry\n  [A2AErrorCodeEnum.AgentNotFound]: {\n    code: A2AErrorCodeEnum.AgentNotFound,\n    category: A2AErrorCategoryEnum.Registry,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The agent was not found in the registry.',\n  },\n  [A2AErrorCodeEnum.AgentAlreadyRegistered]: {\n    code: A2AErrorCodeEnum.AgentAlreadyRegistered,\n    category: A2AErrorCategoryEnum.Registry,\n    severity: A2AErrorSeverityEnum.Low,\n    retryable: false,\n    description: 'The agent is already registered.',\n  },\n  [A2AErrorCodeEnum.CapabilityNotFound]: {\n    code: A2AErrorCodeEnum.CapabilityNotFound,\n    category: A2AErrorCategoryEnum.Registry,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The agent does not have the requested capability.',\n  },\n\n  // collaboration\n  [A2AErrorCodeEnum.ChannelNotFound]: {\n    code: A2AErrorCodeEnum.ChannelNotFound,\n    category: A2AErrorCategoryEnum.Collaboration,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The channel was not found.',\n  },\n  [A2AErrorCodeEnum.ThreadNotFound]: {\n    code: A2AErrorCodeEnum.ThreadNotFound,\n    category: A2AErrorCategoryEnum.Collaboration,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The thread was not found.',\n  },\n  [A2AErrorCodeEnum.MessageNotFound]: {\n    code: A2AErrorCodeEnum.MessageNotFound,\n    category: A2AErrorCategoryEnum.Collaboration,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The message was not found.',\n  },\n  [A2AErrorCodeEnum.NotChannelMember]: {\n    code: A2AErrorCodeEnum.NotChannelMember,\n    category: A2AErrorCategoryEnum.Collaboration,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The sender is not a member of the target channel.',\n  },\n\n  // transport\n  [A2AErrorCodeEnum.NetworkError]: {\n    code: A2AErrorCodeEnum.NetworkError,\n    category: A2AErrorCategoryEnum.Transport,\n    severity: A2AErrorSeverityEnum.High,\n    retryable: true,\n    description: 'A network request failed.',\n  },\n  [A2AErrorCodeEnum.UnexpectedStatus]: {\n    code: A2AErrorCodeEnum.UnexpectedStatus,\n    category: A2AErrorCategoryEnum.Transport,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: true,\n    description: 'The remote endpoint returned an unexpected status.',\n  },\n  [A2AErrorCodeEnum.SerializationError]: {\n    code: A2AErrorCodeEnum.SerializationError,\n    category: A2AErrorCategoryEnum.Transport,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The request or response body could not be parsed.',\n  },\n\n  // auth\n  [A2AErrorCodeEnum.AuthenticationFailed]: {\n    code: A2AErrorCodeEnum.AuthenticationFailed,\n    category: A2AErrorCategoryEnum.Auth,\n    severity: A2AErrorSeverityEnum.High,\n    retryable: false,\n    description: 'Authentication failed (invalid or missing credentials).',\n  },\n  [A2AErrorCodeEnum.AuthorizationDenied]: {\n    code: A2AErrorCodeEnum.AuthorizationDenied,\n    category: A2AErrorCategoryEnum.Auth,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The caller is not authorized for the requested operation.',\n  },\n  [A2AErrorCodeEnum.TokenExpired]: {\n    code: A2AErrorCodeEnum.TokenExpired,\n    category: A2AErrorCategoryEnum.Auth,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: true,\n    description: 'The access token has expired.',\n  },\n\n  // rate limit\n  [A2AErrorCodeEnum.RateLimitExceeded]: {\n    code: A2AErrorCodeEnum.RateLimitExceeded,\n    category: A2AErrorCategoryEnum.RateLimit,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: true,\n    description: 'The caller has exceeded the rate limit.',\n  },\n  [A2AErrorCodeEnum.QuotaExceeded]: {\n    code: A2AErrorCodeEnum.QuotaExceeded,\n    category: A2AErrorCategoryEnum.RateLimit,\n    severity: A2AErrorSeverityEnum.Medium,\n    retryable: false,\n    description: 'The caller has exceeded their usage quota.',\n  },\n\n  // internal\n  [A2AErrorCodeEnum.InternalError]: {\n    code: A2AErrorCodeEnum.InternalError,\n    category: A2AErrorCategoryEnum.Internal,\n    severity: A2AErrorSeverityEnum.Critical,\n    retryable: false,\n    description: 'An unexpected internal error occurred.',\n  },\n  [A2AErrorCodeEnum.ConfigurationError]: {\n    code: A2AErrorCodeEnum.ConfigurationError,\n    category: A2AErrorCategoryEnum.Internal,\n    severity: A2AErrorSeverityEnum.High,\n    retryable: false,\n    description: 'A configuration error was detected.',\n  },\n};\n\n// ---------------------------------------------------------------------------\n// Structured error type\n// ---------------------------------------------------------------------------\n\nexport interface A2AError {\n  code: A2AErrorCode;\n  category: A2AErrorCategory;\n  message: string;\n  severity: A2AErrorSeverity;\n  retryable: boolean;\n  details?: Record<string, unknown>;\n  timestamp?: string;\n  trace_id?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Factory helper\n// ---------------------------------------------------------------------------\n\nexport function buildA2AError(input: {\n  code: A2AErrorCode;\n  message: string;\n  details?: Record<string, unknown>;\n  trace_id?: string;\n  severity?: A2AErrorSeverity;\n  retryable?: boolean;\n  now?: string;\n}): A2AError {\n  const meta = A2A_ERROR_CODE_REGISTRY[input.code];\n  return {\n    code: input.code,\n    category: meta.category,\n    message: input.message,\n    severity: input.severity ?? meta.severity,\n    retryable: input.retryable ?? meta.retryable,\n    details: input.details,\n    timestamp: input.now ?? new Date().toISOString(),\n    trace_id: input.trace_id,\n  };\n}\n\nexport function getErrorCodeMeta(code: string): A2AErrorCodeMeta | undefined {\n  return A2A_ERROR_CODE_REGISTRY[code as A2AErrorCode];\n}\n\nexport function isA2AErrorCode(code: string): code is A2AErrorCode {\n  return code in A2A_ERROR_CODE_REGISTRY;\n}\n\n// ---------------------------------------------------------------------------\n// Error class\n// ---------------------------------------------------------------------------\n\nexport class A2AStructuredError extends Error {\n  readonly a2aError: A2AError;\n\n  constructor(a2aError: A2AError) {\n    super(`[${a2aError.code}] ${a2aError.message}`);\n    this.name = 'A2AStructuredError';\n    this.a2aError = a2aError;\n    Object.setPrototypeOf(this, A2AStructuredError.prototype);\n  }\n\n  get code(): A2AErrorCode {\n    return this.a2aError.code;\n  }\n\n  get category(): A2AErrorCategory {\n    return this.a2aError.category;\n  }\n\n  get severity(): A2AErrorSeverity {\n    return this.a2aError.severity;\n  }\n\n  get retryable(): boolean {\n    return this.a2aError.retryable;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACkBO,IAAM,wBAAwB;AAQ9B,IAAM,gBAAgB;AAAA;AAAA,EAE3B,WAAW;AAAA;AAAA,EAEX,SAAS;AAAA;AAAA,EAET,eAAe;AAAA;AAAA,EAEf,WAAW;AAAA;AAAA,EAEX,QAAQ;AAAA;AAAA,EAER,WAAW;AACb;AAGO,IAAM,cAAoC;AAAA,EAC/C,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAChB;AAGO,IAAM,uBAA+C,oBAAI,IAAe;AAAA,EAC7E,cAAc;AAAA,EACd,cAAc;AAAA,EACd,cAAc;AAChB,CAAC;AAKM,SAAS,gBAAgB,OAA2B;AACzD,SAAO,qBAAqB,IAAI,KAAK;AACvC;AAkIO,SAAS,mBAAmB,OAA8C;AAC/E,QAAM,MAAM,MAAM,QAAO,oBAAI,KAAK,GAAE,YAAY;AAChD,SAAO;AAAA,IACL,kBAAkB;AAAA,IAClB,IAAI,MAAM;AAAA,IACV,cAAc,MAAM;AAAA,IACpB,WAAW,MAAM;AAAA,IACjB,UAAU,MAAM;AAAA,IAChB,WAAW,MAAM;AAAA,IACjB,OAAO,MAAM,iBAAiB,cAAc;AAAA,IAC5C,SAAS,CAAC;AAAA,IACV,WAAW,MAAM;AAAA,IACjB,UAAU,MAAM;AAAA,IAChB,WAAW,MAAM;AAAA,IACjB,SAAS,MAAM;AAAA,IACf,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,UAAU,MAAM;AAAA,IAChB,MAAM,MAAM;AAAA,EACd;AACF;AAMO,IAAM,4BAA+E;AAAA,EAC1F,CAAC,cAAc,SAAS,GAAG,CAAC,cAAc,SAAS,cAAc,WAAW,cAAc,MAAM;AAAA,EAChG,CAAC,cAAc,OAAO,GAAG;AAAA,IACvB,cAAc;AAAA,IACd,cAAc;AAAA,IACd,cAAc;AAAA,IACd,cAAc;AAAA,EAChB;AAAA,EACA,CAAC,cAAc,aAAa,GAAG,CAAC,cAAc,SAAS,cAAc,WAAW,cAAc,MAAM;AAAA,EACpG,CAAC,cAAc,SAAS,GAAG,CAAC;AAAA,EAC5B,CAAC,cAAc,MAAM,GAAG,CAAC;AAAA,EACzB,CAAC,cAAc,SAAS,GAAG,CAAC;AAC9B;AAEO,SAAS,kBAAkB,MAAiB,IAAwB;AACzE,UAAQ,0BAA0B,IAAI,KAAK,CAAC,GAAG,SAAS,EAAE;AAC5D;AAEO,SAAS,uBACd,UACA,IACA,SACc;AACd,MAAI,CAAC,kBAAkB,SAAS,OAAO,EAAE,GAAG;AAC1C,UAAM,IAAI;AAAA,MACR,kCAAkC,SAAS,KAAK,OAAO,EAAE,UAAU,SAAS,EAAE;AAAA,IAChF;AAAA,EACF;AAEA,QAAM,MAAM,SAAS,QAAO,oBAAI,KAAK,GAAE,YAAY;AACnD,QAAM,aAAkC;AAAA,IACtC,MAAM,SAAS;AAAA,IACf;AAAA,IACA,iBAAiB;AAAA,IACjB,QAAQ,SAAS;AAAA,IACjB,cAAc,SAAS;AAAA,EACzB;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,SAAS,CAAC,GAAI,SAAS,WAAW,CAAC,GAAI,UAAU;AAAA,EACnD;AACF;;;AC1PO,IAAM,sBAAsB;AAM5B,IAAM,qBAAqB;AAAA;AAAA,EAEhC,eAAe;AAAA,EACf,aAAa;AAAA,EACb,cAAc;AAAA,EACd,mBAAmB;AAAA,EACnB,eAAe;AAAA,EACf,YAAY;AAAA,EACZ,eAAe;AAAA;AAAA,EAGf,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,cAAc;AAAA;AAAA,EAGd,mBAAmB;AAAA,EACnB,mBAAmB;AAAA,EACnB,iBAAiB;AAAA,EACjB,gBAAgB;AAAA;AAAA,EAGhB,iBAAiB;AAAA,EACjB,mBAAmB;AAAA,EACnB,cAAc;AAAA;AAAA,EAGd,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,aAAa;AAAA;AAAA,EAGb,cAAc;AAAA,EACd,aAAa;AACf;AAMO,IAAM,oBAA+C,OAAO,OAAO,kBAAkB;AAMrF,IAAM,qBAAqB;AAAA,EAChC,OAAO;AAAA,EACP,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,WAAW;AACb;AAgBO,IAAM,sBAAsB;AAAA,EACjC,MAAM;AAAA,EACN,OAAO;AAAA,EACP,WAAW;AAAA,EACX,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,QAAQ;AACV;AA4BO,IAAM,oBAAoB;AAAA,EAC/B,MAAM;AAAA,EACN,SAAS;AAAA,EACT,OAAO;AAAA,EACP,UAAU;AACZ;AAiDO,SAAS,iBAAiB,OAA0C;AACzE,SAAO;AAAA,IACL,gBAAgB;AAAA,IAChB,IAAI,MAAM;AAAA,IACV,YAAY,MAAM;AAAA,IAClB,UAAU,MAAM;AAAA,IAChB,OAAO,MAAM;AAAA,IACb,QAAQ,MAAM;AAAA,IACd,UAAU,MAAM;AAAA,IAChB,iBAAiB,MAAM;AAAA,IACvB,cAAc,MAAM;AAAA,IACpB,WAAW,MAAM;AAAA,IACjB,SAAS,MAAM;AAAA,IACf,WAAW,MAAM,QAAO,oBAAI,KAAK,GAAE,YAAY;AAAA,IAC/C,aAAa,MAAM;AAAA,IACnB,QAAQ,MAAM;AAAA,IACd,UAAU,MAAM;AAAA,IAChB,MAAM,MAAM;AAAA,EACd;AACF;;;AC3LO,IAAM,uBAAuB;AAAA,EAClC,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,UAAU;AACZ;AAQO,IAAM,uBAAuB;AAAA,EAClC,UAAU;AAAA,EACV,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,UAAU;AAAA,EACV,eAAe;AAAA,EACf,WAAW;AAAA,EACX,MAAM;AAAA,EACN,WAAW;AAAA,EACX,UAAU;AACZ;AAQO,IAAM,mBAAmB;AAAA;AAAA,EAE9B,iBAAiB;AAAA,EACjB,4BAA4B;AAAA,EAC5B,sBAAsB;AAAA,EACtB,gBAAgB;AAAA,EAChB,eAAe;AAAA;AAAA,EAGf,mBAAmB;AAAA,EACnB,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,sBAAsB;AAAA,EACtB,kBAAkB;AAAA;AAAA,EAGlB,cAAc;AAAA,EACd,sBAAsB;AAAA,EACtB,eAAe;AAAA;AAAA,EAGf,cAAc;AAAA,EACd,wBAAwB;AAAA,EACxB,qBAAqB;AAAA,EACrB,qBAAqB;AAAA,EACrB,eAAe;AAAA;AAAA,EAGf,eAAe;AAAA,EACf,wBAAwB;AAAA,EACxB,oBAAoB;AAAA;AAAA,EAGpB,iBAAiB;AAAA,EACjB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,EACjB,kBAAkB;AAAA;AAAA,EAGlB,cAAc;AAAA,EACd,kBAAkB;AAAA,EAClB,oBAAoB;AAAA;AAAA,EAGpB,sBAAsB;AAAA,EACtB,qBAAqB;AAAA,EACrB,cAAc;AAAA;AAAA,EAGd,mBAAmB;AAAA,EACnB,eAAe;AAAA;AAAA,EAGf,eAAe;AAAA,EACf,oBAAoB;AACtB;AAgBO,IAAM,0BAA4E;AAAA;AAAA,EAEvF,CAAC,iBAAiB,eAAe,GAAG;AAAA,IAClC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,0BAA0B,GAAG;AAAA,IAC7C,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,oBAAoB,GAAG;AAAA,IACvC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,cAAc,GAAG;AAAA,IACjC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA;AAAA,EAGA,CAAC,iBAAiB,iBAAiB,GAAG;AAAA,IACpC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,gBAAgB,GAAG;AAAA,IACnC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,cAAc,GAAG;AAAA,IACjC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,oBAAoB,GAAG;AAAA,IACvC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,gBAAgB,GAAG;AAAA,IACnC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA;AAAA,EAGA,CAAC,iBAAiB,YAAY,GAAG;AAAA,IAC/B,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,oBAAoB,GAAG;AAAA,IACvC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,aAAa,GAAG;AAAA,IAChC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA;AAAA,EAGA,CAAC,iBAAiB,YAAY,GAAG;AAAA,IAC/B,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,sBAAsB,GAAG;AAAA,IACzC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,mBAAmB,GAAG;AAAA,IACtC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,mBAAmB,GAAG;AAAA,IACtC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,aAAa,GAAG;AAAA,IAChC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA;AAAA,EAGA,CAAC,iBAAiB,aAAa,GAAG;AAAA,IAChC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,sBAAsB,GAAG;AAAA,IACzC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,kBAAkB,GAAG;AAAA,IACrC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA;AAAA,EAGA,CAAC,iBAAiB,eAAe,GAAG;AAAA,IAClC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,cAAc,GAAG;AAAA,IACjC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,eAAe,GAAG;AAAA,IAClC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,gBAAgB,GAAG;AAAA,IACnC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA;AAAA,EAGA,CAAC,iBAAiB,YAAY,GAAG;AAAA,IAC/B,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,gBAAgB,GAAG;AAAA,IACnC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,kBAAkB,GAAG;AAAA,IACrC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA;AAAA,EAGA,CAAC,iBAAiB,oBAAoB,GAAG;AAAA,IACvC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,mBAAmB,GAAG;AAAA,IACtC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,YAAY,GAAG;AAAA,IAC/B,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA;AAAA,EAGA,CAAC,iBAAiB,iBAAiB,GAAG;AAAA,IACpC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,aAAa,GAAG;AAAA,IAChC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA;AAAA,EAGA,CAAC,iBAAiB,aAAa,GAAG;AAAA,IAChC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AAAA,EACA,CAAC,iBAAiB,kBAAkB,GAAG;AAAA,IACrC,MAAM,iBAAiB;AAAA,IACvB,UAAU,qBAAqB;AAAA,IAC/B,UAAU,qBAAqB;AAAA,IAC/B,WAAW;AAAA,IACX,aAAa;AAAA,EACf;AACF;AAqBO,SAAS,cAAc,OAQjB;AACX,QAAM,OAAO,wBAAwB,MAAM,IAAI;AAC/C,SAAO;AAAA,IACL,MAAM,MAAM;AAAA,IACZ,UAAU,KAAK;AAAA,IACf,SAAS,MAAM;AAAA,IACf,UAAU,MAAM,YAAY,KAAK;AAAA,IACjC,WAAW,MAAM,aAAa,KAAK;AAAA,IACnC,SAAS,MAAM;AAAA,IACf,WAAW,MAAM,QAAO,oBAAI,KAAK,GAAE,YAAY;AAAA,IAC/C,UAAU,MAAM;AAAA,EAClB;AACF;AAEO,SAAS,iBAAiB,MAA4C;AAC3E,SAAO,wBAAwB,IAAoB;AACrD;AAEO,SAAS,eAAe,MAAoC;AACjE,SAAO,QAAQ;AACjB;AAMO,IAAM,qBAAN,MAAM,4BAA2B,MAAM;AAAA,EACnC;AAAA,EAET,YAAY,UAAoB;AAC9B,UAAM,IAAI,SAAS,IAAI,KAAK,SAAS,OAAO,EAAE;AAC9C,SAAK,OAAO;AACZ,SAAK,WAAW;AAChB,WAAO,eAAe,MAAM,oBAAmB,SAAS;AAAA,EAC1D;AAAA,EAEA,IAAI,OAAqB;AACvB,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,WAA6B;AAC/B,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,WAA6B;AAC/B,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,YAAqB;AACvB,WAAO,KAAK,SAAS;AAAA,EACvB;AACF;","names":[]}

package/dist/schemas/index.mjs

@@ -0,0 +1,53 @@
+import {
+  A2AErrorCategoryEnum,
+  A2AErrorCodeEnum,
+  A2AErrorSeverityEnum,
+  A2AStructuredError,
+  A2A_ERROR_CODE_REGISTRY,
+  ALLOWED_STATE_TRANSITIONS,
+  AUDIT_EVENT_TYPES,
+  AUDIT_EVENT_VERSION,
+  AuditActorKindEnum,
+  AuditEventTypeEnum,
+  AuditSeverityEnum,
+  AuditTargetKindEnum,
+  TASK_ENVELOPE_VERSION,
+  TASK_STATES,
+  TERMINAL_TASK_STATES,
+  TaskStateEnum,
+  buildA2AError,
+  createAuditEvent,
+  createTaskEnvelope,
+  getErrorCodeMeta,
+  isA2AErrorCode,
+  isTerminalState,
+  isValidTransition,
+  transitionTaskEnvelope
+} from "../chunk-KTGZQV57.mjs";
+export {
+  A2AErrorCategoryEnum,
+  A2AErrorCodeEnum,
+  A2AErrorSeverityEnum,
+  A2AStructuredError,
+  A2A_ERROR_CODE_REGISTRY,
+  ALLOWED_STATE_TRANSITIONS,
+  AUDIT_EVENT_TYPES,
+  AUDIT_EVENT_VERSION,
+  AuditActorKindEnum,
+  AuditEventTypeEnum,
+  AuditSeverityEnum,
+  AuditTargetKindEnum,
+  TASK_ENVELOPE_VERSION,
+  TASK_STATES,
+  TERMINAL_TASK_STATES,
+  TaskStateEnum,
+  buildA2AError,
+  createAuditEvent,
+  createTaskEnvelope,
+  getErrorCodeMeta,
+  isA2AErrorCode,
+  isTerminalState,
+  isValidTransition,
+  transitionTaskEnvelope
+};
+//# sourceMappingURL=index.mjs.map

package/dist/schemas/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/state-mapping.d.mts

@@ -1,4 +1,5 @@
-import { TaskState } from '@recoder/shared/a2a/schemas';
+import { j as TaskState } from './task-envelope-QkecqlWq.mjs';
+import './types-Bt96SgOS.mjs';
 
 /**
  * @module state-mapping

package/dist/state-mapping.d.ts

@@ -1,4 +1,5 @@
-import { TaskState } from '@recoder/shared/a2a/schemas';
+import { j as TaskState } from './task-envelope-B3X3seKp.js';
+import './types-Bt96SgOS.js';
 
 /**
  * @module state-mapping

package/dist/state-mapping.js

@@ -34,7 +34,7 @@ __export(state_mapping_exports, {
 });
 module.exports = __toCommonJS(state_mapping_exports);
 
-// ../../shared/src/a2a/schemas/task-envelope.ts
+// src/schemas/task-envelope.ts
 var TaskStateEnum = {
   /** Task has been created and is awaiting execution. */
   Submitted: "submitted",
@@ -82,174 +82,103 @@ function isValidTransition(from, to) {
   return (ALLOWED_STATE_TRANSITIONS[from] ?? []).includes(to);
 }
 
-// ../../shared/src/a2a/schemas/audit-event.ts
+// src/schemas/audit-event.ts
 var AuditEventTypeEnum = {
   // -- task lifecycle ---------------------------------------------------------
-  /** A new task was submitted. */
   TaskSubmitted: "task.submitted",
-  /** Task execution started. */
   TaskStarted: "task.started",
-  /** Task made progress (intermediate update). */
   TaskProgress: "task.progress",
-  /** Assignee agent needs additional input. */
   TaskInputRequired: "task.input_required",
-  /** Task completed successfully. */
   TaskCompleted: "task.completed",
-  /** Task failed with an error. */
   TaskFailed: "task.failed",
-  /** Task was cancelled. */
   TaskCancelled: "task.cancelled",
   // -- policy decisions -------------------------------------------------------
-  /** A policy check was performed. */
   PolicyChecked: "policy.checked",
-  /** A policy action was approved (auto or prompt). */
   PolicyApproved: "policy.approved",
-  /** A policy action was denied. */
   PolicyDenied: "policy.denied",
   // -- connector events -------------------------------------------------------
-  /** A connector was attached to an agent. */
   ConnectorAttached: "connector.attached",
-  /** A connector was detached from an agent. */
   ConnectorDetached: "connector.detached",
-  /** A connector emitted a diagnostic or health event. */
   ConnectorHealth: "connector.health",
-  /** A connector encountered an error. */
   ConnectorError: "connector.error",
   // -- agent registry ---------------------------------------------------------
-  /** An agent was registered. */
   AgentRegistered: "agent.registered",
-  /** An agent was unregistered. */
   AgentUnregistered: "agent.unregistered",
-  /** An agent's capabilities were updated. */
   AgentUpdated: "agent.updated",
   // -- collaboration ----------------------------------------------------------
-  /** A collaboration channel was created. */
   ChannelCreated: "collaboration.channel_created",
-  /** A collaboration thread was created. */
   ThreadCreated: "collaboration.thread_created",
-  /** A message was sent in a collaboration thread. */
   MessageSent: "collaboration.message_sent",
   // -- system -----------------------------------------------------------------
-  /** A system-level configuration change. */
   SystemConfig: "system.config",
-  /** A system-level error or warning. */
   SystemError: "system.error"
 };
 var AUDIT_EVENT_TYPES = Object.values(AuditEventTypeEnum);
 
-// ../../shared/src/a2a/schemas/error-taxonomy.ts
+// src/schemas/error-taxonomy.ts
 var A2AErrorSeverityEnum = {
-  /** Low impact -- informational or gracefully handled. */
   Low: "low",
-  /** Medium impact -- degraded functionality but system continues. */
   Medium: "medium",
-  /** High impact -- a key operation failed and needs attention. */
   High: "high",
-  /** Critical -- system stability at risk, immediate action required. */
   Critical: "critical"
 };
 var A2AErrorCategoryEnum = {
-  /** Errors in the envelope or message format (validation, parsing). */
   Envelope: "envelope",
-  /** Errors in the connector/adapter layer. */
   Connector: "connector",
-  /** Errors in the policy/approval plane. */
   Policy: "policy",
-  /** Errors in the task orchestration layer. */
   Task: "task",
-  /** Errors in the agent registry. */
   Registry: "registry",
-  /** Errors in the collaboration service. */
   Collaboration: "collaboration",
-  /** Transport/network-level errors. */
   Transport: "transport",
-  /** Authentication and authorization errors. */
   Auth: "auth",
-  /** Rate-limiting and quota errors. */
   RateLimit: "rate_limit",
-  /** Internal / unexpected errors. */
   Internal: "internal"
 };
 var A2AErrorCodeEnum = {
   // -- envelope ---------------------------------------------------------------
-  /** The envelope failed structural validation. */
   InvalidEnvelope: "INVALID_ENVELOPE",
-  /** The envelope version is unsupported. */
   UnsupportedEnvelopeVersion: "UNSUPPORTED_ENVELOPE_VERSION",
-  /** A required field is missing from the envelope. */
   MissingEnvelopeField: "MISSING_ENVELOPE_FIELD",
-  /** The payload kind is unknown or malformed. */
   InvalidPayload: "INVALID_PAYLOAD",
-  /** Compatibility alias used by older gateway/workspace routes. */
   InvalidParams: "INVALID_ENVELOPE",
   // -- connector --------------------------------------------------------------
-  /** No connector is attached for the target agent. */
   ConnectorNotFound: "CONNECTOR_NOT_FOUND",
-  /** The connector timed out during task execution. */
   ConnectorTimeout: "CONNECTOR_TIMEOUT",
-  /** The connector returned an unexpected error. */
   ConnectorError: "CONNECTOR_ERROR",
-  /** The connector is temporarily unavailable. */
   ConnectorUnavailable: "CONNECTOR_UNAVAILABLE",
-  /** Protocol mismatch between connector and remote agent. */
   ProtocolMismatch: "PROTOCOL_MISMATCH",
   // -- policy -----------------------------------------------------------------
-  /** The policy plane denied the requested action. */
   PolicyDenied: "POLICY_DENIED",
-  /** No prompt handler is configured for the policy rule. */
   PolicyHandlerMissing: "POLICY_HANDLER_MISSING",
-  /** The policy evaluation timed out. */
   PolicyTimeout: "POLICY_TIMEOUT",
   // -- task -------------------------------------------------------------------
-  /** The task was not found. */
   TaskNotFound: "TASK_NOT_FOUND",
-  /** An invalid state transition was attempted. */
   InvalidStateTransition: "INVALID_STATE_TRANSITION",
-  /** The task has already reached a terminal state. */
   TaskAlreadyTerminal: "TASK_ALREADY_TERMINAL",
-  /** The task failed during execution. */
   TaskExecutionFailed: "TASK_EXECUTION_FAILED",
-  /** The task was cancelled. */
   TaskCancelled: "TASK_CANCELLED",
   // -- registry ---------------------------------------------------------------
-  /** The agent was not found in the registry. */
   AgentNotFound: "AGENT_NOT_FOUND",
-  /** The agent is already registered. */
   AgentAlreadyRegistered: "AGENT_ALREADY_REGISTERED",
-  /** The agent does not have the requested capability. */
   CapabilityNotFound: "CAPABILITY_NOT_FOUND",
   // -- collaboration ----------------------------------------------------------
-  /** The channel was not found. */
   ChannelNotFound: "CHANNEL_NOT_FOUND",
-  /** The thread was not found. */
   ThreadNotFound: "THREAD_NOT_FOUND",
-  /** The message was not found. */
   MessageNotFound: "MESSAGE_NOT_FOUND",
-  /** The sender is not a member of the target channel. */
   NotChannelMember: "NOT_CHANNEL_MEMBER",
   // -- transport --------------------------------------------------------------
-  /** A network request failed. */
   NetworkError: "NETWORK_ERROR",
-  /** The remote endpoint returned an unexpected status. */
   UnexpectedStatus: "UNEXPECTED_STATUS",
-  /** The request or response body could not be parsed. */
   SerializationError: "SERIALIZATION_ERROR",
   // -- auth -------------------------------------------------------------------
-  /** Authentication failed (invalid or missing credentials). */
   AuthenticationFailed: "AUTHENTICATION_FAILED",
-  /** The caller is not authorized for the requested operation. */
   AuthorizationDenied: "AUTHORIZATION_DENIED",
-  /** The access token has expired. */
   TokenExpired: "TOKEN_EXPIRED",
   // -- rate limit -------------------------------------------------------------
-  /** The caller has exceeded the rate limit. */
   RateLimitExceeded: "RATE_LIMIT_EXCEEDED",
-  /** The caller has exceeded their usage quota. */
   QuotaExceeded: "QUOTA_EXCEEDED",
   // -- internal ---------------------------------------------------------------
-  /** An unexpected internal error occurred. */
   InternalError: "INTERNAL_ERROR",
-  /** A configuration error was detected. */
   ConfigurationError: "CONFIGURATION_ERROR"
 };
 var A2A_ERROR_CODE_REGISTRY = {