Orchestration events and error taxonomy

{
  id: string
  seq?: number            // assigned atomically by SQLite on insert (cross-process monotonic)
  ts: number              // emit timestamp (epoch ms)
  kind: OrchestrationEventKind
  teamId?: string | null
  taskId?: string | null
  agentId?: string | null
  runtime?: string | null
  traceId?: string | null      // ties every span/event of one board task together
  spanId?: string | null       // forms the span tree (run span, tool sub-spans)
  parentSpanId?: string | null
  correlationId?: string | null
  tenantId?: string | null     // future seam: dormant multi-tenant scoping
  data: Record<string, unknown>  // open by design; defaults to {}
}

{
  title?: string | null
  status?: string
  parentTaskId?: string | null
  priority?: string | null
}

{
  assigneeAgentId?: string | null
  assigneeRuntime?: string | null
}

{
  from?: string | null
  to: string
}

{
  authorType?: string
  body?: string
}

{
  dependsOnTaskId: string
}

{
  execId: string
  executorType?: string
  runReason?: string | null
}

{
  execId: string
  status: string
  costUsd?: number | null
  inputTokens?: number
  outputTokens?: number
  error?: string | null
}

{
  toolCallId: string
  name: string
  input?: unknown
}

{
  toolCallId: string
  name: string
  isError: boolean
  output?: string
}

{
  costUsd?: number | null
  inputTokens?: number
  outputTokens?: number
  model?: string | null
}

{
  approvalId?: string
  scopeKey?: string
  kind?: string
}

{
  approvalId?: string
  decision?: string
}

{
  code?: string | null
  message: string
  errorClass: string   // a RuntimeErrorClass, or 'PolicyDenied' for a non-error policy denial
  harnessBug: boolean  // classifyError(...) === 'Unknown'
  fatal?: boolean
}

{
  name: string
  spanKind?: 'task' | 'tool' | 'run'
}

{
  name: string
  status?: 'ok' | 'error'
  durationMs?: number
}

{
  from: string          // predecessor session stream key
  to: string            // successor session stream key
  reason: 'max_turns' | 'context_watermark'
  tokensUsed?: number   // tokens the predecessor consumed before rotating
  rotationIndex?: number // 1-based rotation index within the task's run chain
}

{
  scheduledRunId: string
  cronSpec: string
  scheduledBy: string // the firing owner of record ('clawboo' for the Routines engine)
}

{
  scheduledRunId: string
  taskId: string
  runtime: string
  dispatchPath: 'one-shot' | 'connected' | 'human'
}

{
  scheduledRunId: string
  taskId?: string | null
  status: string
  nextRunAt?: number | null
}

{
  scheduledRunId: string
  code?: string | null
  message: string
}

{
  roomId: string
  seq: number // per-room monotonic ordering key assigned at write time
  authorAgentId: string
  postKind: 'peer' | 'system' | 'user' // peer = teammate post; system = board-mutation narration
}

{
  roomId: string
  speakerAgentId: string
  policy: 'leader-nominated' | 'round-robin'
  exchangeTurn: number // 1-based turn index within the current bounded exchange
}

{
  roomId: string
  reason: 'max_turns' | 'no_pending_obligation'
  maxExchangeTurns: number // the cap that bounded the exchange
  turnsTaken: number // how many peer turns the exchange actually ran
}

function classifyError(code?: string | null, message?: string | null): RuntimeErrorClass

function isHarnessBug(cls: RuntimeErrorClass): boolean

function isUnexpectedFor(runtime: string | null | undefined, cls: RuntimeErrorClass): boolean