SwarmClaw Session Run Types (types/run.ts)

Defines TypeScript interfaces and types for managing AI agent session execution and recovery. Use this to standardize communication and state tracking for agentic workflows.

// Source: https://github.com/swarmclawai/swarmclaw | License: MIT | Copyright 2026 SwarmClaw Contributors
// Provided via justclaw.it.com; keep this notice with the code.
import type { KnowledgeCitation, KnowledgeRetrievalTrace, SSEEvent } from './misc'

// --- Session Runs ---

export type SessionRunStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled'
export type ExecutionKind =
  | 'session_turn'
  | 'task_attempt'
  | 'protocol_step'
  | 'heartbeat_tick'
  | 'schedule_wake'
  | 'repair_turn'
  | 'subagent_turn'

export type ExecutionOwnerType =
  | 'session'
  | 'task'
  | 'protocol_run'
  | 'schedule'
  | 'agent'
  | 'subagent'

export interface SessionRunHeartbeatConfig {
  ackMaxChars: number
  showOk: boolean
  showAlerts: boolean
  target: string | null
  deliveryM

... (truncated -- full source via MCP)