recoder-a2a-sdk 1.0.0

package/dist/chunk-T5GUBIFZ.mjs

@@ -0,0 +1,358 @@
+// src/audit-helpers.ts
+import {
+  AuditEventTypeEnum,
+  AuditActorKindEnum,
+  AuditTargetKindEnum,
+  AuditSeverityEnum,
+  createAuditEvent
+} from "@recoder/shared/a2a/schemas";
+function agentActor(agentId, platform, name) {
+  return {
+    kind: AuditActorKindEnum.Agent,
+    id: agentId,
+    platform,
+    name
+  };
+}
+function connectorActor(connectorId, platform, name) {
+  return {
+    kind: AuditActorKindEnum.Connector,
+    id: connectorId,
+    platform,
+    name
+  };
+}
+function systemActor(systemId = "control-plane") {
+  return {
+    kind: AuditActorKindEnum.System,
+    id: systemId,
+    name: "A2A Control Plane"
+  };
+}
+function taskTarget(taskId) {
+  return {
+    kind: AuditTargetKindEnum.Task,
+    id: taskId
+  };
+}
+function connectorTarget(connectorId, name) {
+  return {
+    kind: AuditTargetKindEnum.Connector,
+    id: connectorId,
+    name
+  };
+}
+function emitTaskSubmitted(input) {
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.TaskSubmitted,
+    severity: AuditSeverityEnum.Info,
+    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),
+    target: taskTarget(input.task_id),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    metadata: input.metadata,
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitTaskStarted(input) {
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.TaskStarted,
+    severity: AuditSeverityEnum.Info,
+    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),
+    target: taskTarget(input.task_id),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    metadata: input.metadata,
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitTaskProgress(input) {
+  const metadata = { ...input.metadata };
+  if (input.progress_pct !== void 0) {
+    metadata.progress_pct = input.progress_pct;
+  }
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.TaskProgress,
+    severity: AuditSeverityEnum.Info,
+    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),
+    target: taskTarget(input.task_id),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    metadata,
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitTaskInputRequired(input) {
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.TaskInputRequired,
+    severity: AuditSeverityEnum.Info,
+    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),
+    target: taskTarget(input.task_id),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    metadata: input.metadata,
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitTaskCompleted(input) {
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.TaskCompleted,
+    severity: AuditSeverityEnum.Info,
+    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),
+    target: taskTarget(input.task_id),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    duration_ms: input.duration_ms,
+    metadata: input.metadata,
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitTaskFailed(input) {
+  const metadata = { ...input.metadata };
+  if (input.error_code) metadata.error_code = input.error_code;
+  if (input.error_message) metadata.error_message = input.error_message;
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.TaskFailed,
+    severity: AuditSeverityEnum.Error,
+    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),
+    target: taskTarget(input.task_id),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    duration_ms: input.duration_ms,
+    metadata,
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitTaskCancelled(input) {
+  const metadata = { ...input.metadata };
+  if (input.reason) metadata.cancellation_reason = input.reason;
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.TaskCancelled,
+    severity: AuditSeverityEnum.Info,
+    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),
+    target: taskTarget(input.task_id),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    metadata,
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitConnectorAttached(input) {
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.ConnectorAttached,
+    severity: AuditSeverityEnum.Info,
+    actor: systemActor(),
+    target: connectorTarget(input.connector_id, input.connector_name),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    metadata: {
+      ...input.metadata,
+      connector_platform: input.connector_platform
+    },
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitConnectorHealth(input) {
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.ConnectorHealth,
+    severity: input.healthy ? AuditSeverityEnum.Info : AuditSeverityEnum.Warning,
+    actor: connectorActor(input.connector_id, input.connector_platform, input.connector_name),
+    target: connectorTarget(input.connector_id, input.connector_name),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    metadata: {
+      ...input.metadata,
+      healthy: input.healthy,
+      ...input.latency_ms !== void 0 ? { latency_ms: input.latency_ms } : {}
+    },
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitConnectorError(input) {
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.ConnectorError,
+    severity: AuditSeverityEnum.Error,
+    actor: connectorActor(input.connector_id, input.connector_platform, input.connector_name),
+    target: connectorTarget(input.connector_id, input.connector_name),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    metadata: {
+      ...input.metadata,
+      ...input.error_code ? { error_code: input.error_code } : {},
+      error_message: input.error_message
+    },
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitPolicyChecked(input) {
+  const policyContext = {
+    action: input.action,
+    rule: input.rule,
+    approved: input.approved,
+    reason: input.reason,
+    agent_id: input.agent_id
+  };
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.PolicyChecked,
+    severity: AuditSeverityEnum.Info,
+    actor: systemActor("policy-engine"),
+    target: taskTarget(input.task_id),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    duration_ms: input.duration_ms,
+    policy: policyContext,
+    metadata: input.metadata,
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitPolicyApproved(input) {
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.PolicyApproved,
+    severity: AuditSeverityEnum.Info,
+    actor: systemActor("policy-engine"),
+    target: taskTarget(input.task_id),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    duration_ms: input.duration_ms,
+    policy: {
+      action: input.action,
+      rule: input.rule,
+      approved: true,
+      reason: input.reason,
+      agent_id: input.agent_id
+    },
+    metadata: input.metadata,
+    tags: input.tags,
+    now: input.now
+  });
+}
+function emitPolicyDenied(input) {
+  return createAuditEvent({
+    id: input.id,
+    event_type: AuditEventTypeEnum.PolicyDenied,
+    severity: AuditSeverityEnum.Warning,
+    actor: systemActor("policy-engine"),
+    target: taskTarget(input.task_id),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    duration_ms: input.duration_ms,
+    policy: {
+      action: input.action,
+      rule: input.rule,
+      approved: false,
+      reason: input.reason,
+      agent_id: input.agent_id
+    },
+    metadata: input.metadata,
+    tags: input.tags,
+    now: input.now
+  });
+}
+var STATE_TO_EVENT_TYPE = {
+  submitted: AuditEventTypeEnum.TaskSubmitted,
+  working: AuditEventTypeEnum.TaskStarted,
+  "input-required": AuditEventTypeEnum.TaskInputRequired,
+  completed: AuditEventTypeEnum.TaskCompleted,
+  failed: AuditEventTypeEnum.TaskFailed,
+  cancelled: AuditEventTypeEnum.TaskCancelled
+};
+function emitAuditForTransition(input, newState) {
+  const eventType = STATE_TO_EVENT_TYPE[newState] ?? AuditEventTypeEnum.TaskProgress;
+  const severity = newState === "failed" ? AuditSeverityEnum.Error : newState === "cancelled" ? AuditSeverityEnum.Warning : AuditSeverityEnum.Info;
+  return createAuditEvent({
+    id: input.id,
+    event_type: eventType,
+    severity,
+    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),
+    target: taskTarget(input.task_id),
+    trace_id: input.trace_id,
+    workspace_id: input.workspace_id,
+    thread_id: input.thread_id,
+    task_id: input.task_id,
+    parent_event_id: input.parent_event_id,
+    duration_ms: input.duration_ms,
+    metadata: input.metadata,
+    tags: input.tags,
+    now: input.now
+  });
+}
+
+export {
+  emitTaskSubmitted,
+  emitTaskStarted,
+  emitTaskProgress,
+  emitTaskInputRequired,
+  emitTaskCompleted,
+  emitTaskFailed,
+  emitTaskCancelled,
+  emitConnectorAttached,
+  emitConnectorHealth,
+  emitConnectorError,
+  emitPolicyChecked,
+  emitPolicyApproved,
+  emitPolicyDenied,
+  emitAuditForTransition
+};
+//# sourceMappingURL=chunk-T5GUBIFZ.mjs.map

package/dist/chunk-T5GUBIFZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/audit-helpers.ts"],"sourcesContent":["/**\n * @module audit-helpers\n *\n * High-level audit event emitter helpers for common A2A operations.\n *\n * Instead of manually constructing `CreateAuditEventInput` objects for every\n * lifecycle event, adapter code can call these type-safe helper functions\n * which pre-fill the `event_type`, `actor`, `target`, and `severity` fields\n * for the most common scenarios.\n *\n * All helpers return an `AuditEvent` (not a side-effecting \"emit\"). The\n * caller is responsible for persisting or publishing the event through\n * the audit-log service transport layer.\n *\n * @example\n * ```ts\n * import { emitTaskSubmitted, emitConnectorInvoked } from '@recoder/a2a-sdk/audit-helpers';\n *\n * const evt = emitTaskSubmitted({\n *   id: 'evt_01',\n *   task_id: 'task_01',\n *   workspace_id: 'ws_abc',\n *   trace_id: '4bf92f3577b34da6a3ce929d0e0e4736',\n *   actor_agent_id: 'agent-pm',\n *   actor_platform: 'recoder_pm',\n * });\n * await auditLogService.persist(evt);\n * ```\n */\n\nimport {\n  type AuditEvent,\n  type AuditActor,\n  type AuditTarget,\n  type AuditSeverity,\n  type AuditPolicyContext,\n  AuditEventTypeEnum,\n  AuditActorKindEnum,\n  AuditTargetKindEnum,\n  AuditSeverityEnum,\n  createAuditEvent,\n} from '@recoder/shared/a2a/schemas';\n\nimport type { RecoderAgentPlatform } from '@recoder/shared/a2a';\n\n// ---------------------------------------------------------------------------\n// Common input base\n// ---------------------------------------------------------------------------\n\n/**\n * Common fields required by all audit event helpers.\n */\nexport interface AuditEventBase {\n  /** Unique event ID. */\n  id: string;\n  /** Workspace ID. */\n  workspace_id: string;\n  /** Trace ID for correlation with the originating TaskEnvelope. */\n  trace_id: string;\n  /** Optional thread ID. */\n  thread_id?: string;\n  /** Optional parent event ID. */\n  parent_event_id?: string;\n  /** Optional additional metadata. */\n  metadata?: Record<string, unknown>;\n  /** Optional tags. */\n  tags?: string[];\n  /** Override the timestamp (defaults to now). */\n  now?: string;\n}\n\n/**\n * Fields for task-scoped audit events.\n */\nexport interface TaskAuditEventInput extends AuditEventBase {\n  /** The task ID that this event is about. */\n  task_id: string;\n  /** The actor agent ID. */\n  actor_agent_id: string;\n  /** The actor's platform. */\n  actor_platform: RecoderAgentPlatform;\n  /** Optional actor display name. */\n  actor_name?: string;\n}\n\n/**\n * Fields for connector-scoped audit events.\n */\nexport interface ConnectorAuditEventInput extends AuditEventBase {\n  /** The connector ID. */\n  connector_id: string;\n  /** The connector platform. */\n  connector_platform: RecoderAgentPlatform;\n  /** Optional task ID. */\n  task_id?: string;\n  /** Optional connector display name. */\n  connector_name?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nfunction agentActor(\n  agentId: string,\n  platform: RecoderAgentPlatform,\n  name?: string,\n): AuditActor {\n  return {\n    kind: AuditActorKindEnum.Agent,\n    id: agentId,\n    platform,\n    name,\n  };\n}\n\nfunction connectorActor(\n  connectorId: string,\n  platform: RecoderAgentPlatform,\n  name?: string,\n): AuditActor {\n  return {\n    kind: AuditActorKindEnum.Connector,\n    id: connectorId,\n    platform,\n    name,\n  };\n}\n\nfunction systemActor(systemId: string = 'control-plane'): AuditActor {\n  return {\n    kind: AuditActorKindEnum.System,\n    id: systemId,\n    name: 'A2A Control Plane',\n  };\n}\n\nfunction taskTarget(taskId: string): AuditTarget {\n  return {\n    kind: AuditTargetKindEnum.Task,\n    id: taskId,\n  };\n}\n\nfunction connectorTarget(\n  connectorId: string,\n  name?: string,\n): AuditTarget {\n  return {\n    kind: AuditTargetKindEnum.Connector,\n    id: connectorId,\n    name,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Task lifecycle events\n// ---------------------------------------------------------------------------\n\n/**\n * Emit a `task.submitted` audit event.\n *\n * Call this when a new task envelope is created and submitted to the\n * control plane.\n */\nexport function emitTaskSubmitted(input: TaskAuditEventInput): AuditEvent {\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.TaskSubmitted,\n    severity: AuditSeverityEnum.Info,\n    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),\n    target: taskTarget(input.task_id),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    metadata: input.metadata,\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n/**\n * Emit a `task.started` audit event.\n *\n * Call this when a task transitions from `submitted` to `working`.\n */\nexport function emitTaskStarted(input: TaskAuditEventInput): AuditEvent {\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.TaskStarted,\n    severity: AuditSeverityEnum.Info,\n    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),\n    target: taskTarget(input.task_id),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    metadata: input.metadata,\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n/**\n * Emit a `task.progress` audit event.\n *\n * Call this for intermediate progress updates during task execution.\n */\nexport function emitTaskProgress(\n  input: TaskAuditEventInput & { progress_pct?: number },\n): AuditEvent {\n  const metadata = { ...input.metadata };\n  if (input.progress_pct !== undefined) {\n    metadata.progress_pct = input.progress_pct;\n  }\n\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.TaskProgress,\n    severity: AuditSeverityEnum.Info,\n    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),\n    target: taskTarget(input.task_id),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    metadata,\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n/**\n * Emit a `task.input_required` audit event.\n *\n * Call this when the assignee agent needs additional input.\n */\nexport function emitTaskInputRequired(input: TaskAuditEventInput): AuditEvent {\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.TaskInputRequired,\n    severity: AuditSeverityEnum.Info,\n    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),\n    target: taskTarget(input.task_id),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    metadata: input.metadata,\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n/**\n * Emit a `task.completed` audit event.\n *\n * Call this when a task reaches the `completed` terminal state.\n */\nexport function emitTaskCompleted(\n  input: TaskAuditEventInput & { duration_ms?: number },\n): AuditEvent {\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.TaskCompleted,\n    severity: AuditSeverityEnum.Info,\n    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),\n    target: taskTarget(input.task_id),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    duration_ms: input.duration_ms,\n    metadata: input.metadata,\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n/**\n * Emit a `task.failed` audit event.\n *\n * Call this when a task reaches the `failed` terminal state.\n */\nexport function emitTaskFailed(\n  input: TaskAuditEventInput & {\n    error_code?: string;\n    error_message?: string;\n    duration_ms?: number;\n  },\n): AuditEvent {\n  const metadata: Record<string, unknown> = { ...input.metadata };\n  if (input.error_code) metadata.error_code = input.error_code;\n  if (input.error_message) metadata.error_message = input.error_message;\n\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.TaskFailed,\n    severity: AuditSeverityEnum.Error,\n    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),\n    target: taskTarget(input.task_id),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    duration_ms: input.duration_ms,\n    metadata,\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n/**\n * Emit a `task.cancelled` audit event.\n *\n * Call this when a task is explicitly cancelled.\n */\nexport function emitTaskCancelled(\n  input: TaskAuditEventInput & { reason?: string },\n): AuditEvent {\n  const metadata: Record<string, unknown> = { ...input.metadata };\n  if (input.reason) metadata.cancellation_reason = input.reason;\n\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.TaskCancelled,\n    severity: AuditSeverityEnum.Info,\n    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),\n    target: taskTarget(input.task_id),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    metadata,\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Connector events\n// ---------------------------------------------------------------------------\n\n/**\n * Emit a `connector.attached` audit event.\n *\n * Call this when a connector is attached to an agent for task execution.\n */\nexport function emitConnectorAttached(input: ConnectorAuditEventInput): AuditEvent {\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.ConnectorAttached,\n    severity: AuditSeverityEnum.Info,\n    actor: systemActor(),\n    target: connectorTarget(input.connector_id, input.connector_name),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    metadata: {\n      ...input.metadata,\n      connector_platform: input.connector_platform,\n    },\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n/**\n * Emit a `connector.health` audit event.\n *\n * Call this when a connector emits a health check or diagnostic event.\n */\nexport function emitConnectorHealth(\n  input: ConnectorAuditEventInput & {\n    healthy: boolean;\n    latency_ms?: number;\n  },\n): AuditEvent {\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.ConnectorHealth,\n    severity: input.healthy ? AuditSeverityEnum.Info : AuditSeverityEnum.Warning,\n    actor: connectorActor(input.connector_id, input.connector_platform, input.connector_name),\n    target: connectorTarget(input.connector_id, input.connector_name),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    metadata: {\n      ...input.metadata,\n      healthy: input.healthy,\n      ...(input.latency_ms !== undefined ? { latency_ms: input.latency_ms } : {}),\n    },\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n/**\n * Emit a `connector.error` audit event.\n *\n * Call this when a connector encounters an error during task execution.\n */\nexport function emitConnectorError(\n  input: ConnectorAuditEventInput & {\n    error_code?: string;\n    error_message: string;\n  },\n): AuditEvent {\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.ConnectorError,\n    severity: AuditSeverityEnum.Error,\n    actor: connectorActor(input.connector_id, input.connector_platform, input.connector_name),\n    target: connectorTarget(input.connector_id, input.connector_name),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    metadata: {\n      ...input.metadata,\n      ...(input.error_code ? { error_code: input.error_code } : {}),\n      error_message: input.error_message,\n    },\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Policy events\n// ---------------------------------------------------------------------------\n\n/**\n * Input for policy audit events.\n */\nexport interface PolicyAuditEventInput extends AuditEventBase {\n  /** The task ID the policy was checked for. */\n  task_id: string;\n  /** The agent ID the policy was evaluated against. */\n  agent_id: string;\n  /** The policy action (e.g. 'file:write', 'bash:exec'). */\n  action: string;\n  /** The rule that was applied ('auto', 'prompt', 'deny'). */\n  rule: string;\n  /** Whether the action was approved. */\n  approved: boolean;\n  /** Human-readable reason for the decision. */\n  reason: string;\n  /** Duration of the policy check. */\n  duration_ms?: number;\n}\n\n/**\n * Emit a `policy.checked` audit event.\n *\n * Call this after a policy evaluation completes.\n */\nexport function emitPolicyChecked(input: PolicyAuditEventInput): AuditEvent {\n  const policyContext: AuditPolicyContext = {\n    action: input.action,\n    rule: input.rule,\n    approved: input.approved,\n    reason: input.reason,\n    agent_id: input.agent_id,\n  };\n\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.PolicyChecked,\n    severity: AuditSeverityEnum.Info,\n    actor: systemActor('policy-engine'),\n    target: taskTarget(input.task_id),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    duration_ms: input.duration_ms,\n    policy: policyContext,\n    metadata: input.metadata,\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n/**\n * Emit a `policy.approved` audit event.\n *\n * Convenience wrapper around `emitPolicyChecked` for approved actions.\n */\nexport function emitPolicyApproved(\n  input: Omit<PolicyAuditEventInput, 'approved'>,\n): AuditEvent {\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.PolicyApproved,\n    severity: AuditSeverityEnum.Info,\n    actor: systemActor('policy-engine'),\n    target: taskTarget(input.task_id),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    duration_ms: input.duration_ms,\n    policy: {\n      action: input.action,\n      rule: input.rule,\n      approved: true,\n      reason: input.reason,\n      agent_id: input.agent_id,\n    },\n    metadata: input.metadata,\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n/**\n * Emit a `policy.denied` audit event.\n *\n * Convenience wrapper for denied actions.\n */\nexport function emitPolicyDenied(\n  input: Omit<PolicyAuditEventInput, 'approved'>,\n): AuditEvent {\n  return createAuditEvent({\n    id: input.id,\n    event_type: AuditEventTypeEnum.PolicyDenied,\n    severity: AuditSeverityEnum.Warning,\n    actor: systemActor('policy-engine'),\n    target: taskTarget(input.task_id),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    duration_ms: input.duration_ms,\n    policy: {\n      action: input.action,\n      rule: input.rule,\n      approved: false,\n      reason: input.reason,\n      agent_id: input.agent_id,\n    },\n    metadata: input.metadata,\n    tags: input.tags,\n    now: input.now,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Compound helper: emit audit event from envelope transition\n// ---------------------------------------------------------------------------\n\n/**\n * Mapping from canonical TaskState to the appropriate audit event emitter.\n * Used by `emitAuditForTransition` to automatically produce the right\n * event type when a task envelope transitions.\n */\nconst STATE_TO_EVENT_TYPE = {\n  submitted: AuditEventTypeEnum.TaskSubmitted,\n  working: AuditEventTypeEnum.TaskStarted,\n  'input-required': AuditEventTypeEnum.TaskInputRequired,\n  completed: AuditEventTypeEnum.TaskCompleted,\n  failed: AuditEventTypeEnum.TaskFailed,\n  cancelled: AuditEventTypeEnum.TaskCancelled,\n} as const;\n\n/**\n * Automatically emit the correct audit event type for a task state\n * transition. This is the preferred method for adapter code that processes\n * state changes and wants to emit a matching audit event without manually\n * switching on the state.\n *\n * @param input - The task audit event input.\n * @param newState - The canonical state the task transitioned to.\n * @returns An `AuditEvent` with the correct event_type for the transition.\n */\nexport function emitAuditForTransition(\n  input: TaskAuditEventInput & { duration_ms?: number },\n  newState: string,\n): AuditEvent {\n  const eventType =\n    STATE_TO_EVENT_TYPE[newState as keyof typeof STATE_TO_EVENT_TYPE] ??\n    AuditEventTypeEnum.TaskProgress;\n\n  const severity =\n    newState === 'failed'\n      ? AuditSeverityEnum.Error\n      : newState === 'cancelled'\n        ? AuditSeverityEnum.Warning\n        : AuditSeverityEnum.Info;\n\n  return createAuditEvent({\n    id: input.id,\n    event_type: eventType,\n    severity,\n    actor: agentActor(input.actor_agent_id, input.actor_platform, input.actor_name),\n    target: taskTarget(input.task_id),\n    trace_id: input.trace_id,\n    workspace_id: input.workspace_id,\n    thread_id: input.thread_id,\n    task_id: input.task_id,\n    parent_event_id: input.parent_event_id,\n    duration_ms: input.duration_ms,\n    metadata: input.metadata,\n    tags: input.tags,\n    now: input.now,\n  });\n}\n"],"mappings":"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","names":[]}