@yesod/core 0.0.2 → 0.1.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/events.ts","../src/bus.ts","../src/vantage.ts","../src/storage.ts"],"sourcesContent":["export { EventType } from \"./events.js\";\nexport type { YesodEvent } from \"./events.js\";\n\nexport { EventBus } from \"./bus.js\";\nexport type { EventHandler, EventFilter } from \"./bus.js\";\n\nexport { VantageEngine } from \"./vantage.js\";\nexport type {\n  Subscription,\n  SubscriptionCondition,\n  NotificationEvent,\n} from \"./vantage.js\";\n\nexport { InMemoryStorageAdapter } from \"./storage.js\";\nexport type { StorageAdapter, StorageQuery } from \"./storage.js\";\n\nexport type {\n  SessionState,\n  SessionControl,\n  CodingSession,\n} from \"./session.js\";\n\nexport type { Scheduler, ReadyStep } from \"./scheduler.js\";\n\nexport type { Router, RuntimeRecommendation } from \"./router.js\";\n\nexport type { Workflow, WorkflowStep, WorkflowState } from \"./workflow.js\";\n","export enum EventType {\n  OrchestrationStarted = \"orchestration.started\",\n  TaskCreated = \"task.created\",\n  TaskDependency = \"task.dependency\",\n  SessionSpawned = \"session.spawned\",\n  SessionEvent = \"session.event\",\n  SessionSteered = \"session.steered\",\n  SessionArtifact = \"session.artifact\",\n  SessionCompleted = \"session.completed\",\n  TaskCompleted = \"task.completed\",\n  OrchestrationCompleted = \"orchestration.completed\",\n  SubscriptionTriggered = \"subscription.triggered\",\n}\n\nexport interface YesodEvent {\n  id: string;\n  type: EventType;\n  timestamp: string;\n  sessionId?: string;\n  orchestrationId?: string;\n  taskId?: string;\n  payload: Record<string, unknown>;\n}\n","import type { YesodEvent, EventType } from \"./events.js\";\n\nexport type EventHandler = (event: YesodEvent) => void | Promise<void>;\n\nexport interface EventFilter {\n  type?: EventType;\n  sessionId?: string;\n  orchestrationId?: string;\n}\n\nexport class EventBus {\n  private handlers = new Map<string, { filter: EventFilter; handler: EventHandler }>();\n  private nextId = 0;\n\n  subscribe(filter: EventFilter, handler: EventHandler): string {\n    const id = String(this.nextId++);\n    this.handlers.set(id, { filter, handler });\n    return id;\n  }\n\n  unsubscribe(id: string): void {\n    this.handlers.delete(id);\n  }\n\n  async emit(event: YesodEvent): Promise<void> {\n    const promises: Promise<void>[] = [];\n    for (const [, { filter, handler }] of this.handlers) {\n      if (this.matches(event, filter)) {\n        const result = handler(event);\n        if (result instanceof Promise) {\n          promises.push(result);\n        }\n      }\n    }\n    await Promise.all(promises);\n  }\n\n  private matches(event: YesodEvent, filter: EventFilter): boolean {\n    if (filter.type && event.type !== filter.type) return false;\n    if (filter.sessionId && event.sessionId !== filter.sessionId) return false;\n    if (filter.orchestrationId && event.orchestrationId !== filter.orchestrationId) return false;\n    return true;\n  }\n}\n","import type { YesodEvent, EventType } from \"./events.js\";\n\nexport interface SubscriptionCondition {\n  sessionId?: string;\n  eventType: EventType;\n  filter?: Record<string, unknown>;\n}\n\nexport interface Subscription {\n  id: string;\n  orchestratorSession: string;\n  conditions: SubscriptionCondition[];\n  mode: \"any\" | \"all\";\n}\n\nexport interface NotificationEvent {\n  type: \"subscription.triggered\";\n  subscriptionId: string;\n  matchedEvents: YesodEvent[];\n}\n\nexport class VantageEngine {\n  private subscriptions = new Map<string, Subscription>();\n\n  register(subscription: Subscription): void {\n    this.subscriptions.set(subscription.id, subscription);\n  }\n\n  remove(subscriptionId: string): void {\n    this.subscriptions.delete(subscriptionId);\n  }\n\n  /** Evaluate an incoming event against all subscriptions. Returns notifications for any triggered subscriptions. */\n  evaluate(_event: YesodEvent): NotificationEvent[] {\n    // Stub — will implement condition matching and barrier tracking\n    return [];\n  }\n\n  getSubscription(id: string): Subscription | undefined {\n    return this.subscriptions.get(id);\n  }\n\n  listSubscriptions(): Subscription[] {\n    return Array.from(this.subscriptions.values());\n  }\n}\n","export interface StorageQuery {\n  type?: string;\n  sessionId?: string;\n  orchestrationId?: string;\n  from?: string;\n  to?: string;\n  limit?: number;\n}\n\nexport interface StorageAdapter {\n  get(key: string): Promise<unknown | undefined>;\n  put(key: string, value: unknown): Promise<void>;\n  query(query: StorageQuery): Promise<unknown[]>;\n  delete(key: string): Promise<boolean>;\n}\n\nexport class InMemoryStorageAdapter implements StorageAdapter {\n  private store = new Map<string, unknown>();\n\n  async get(key: string): Promise<unknown | undefined> {\n    return this.store.get(key);\n  }\n\n  async put(key: string, value: unknown): Promise<void> {\n    this.store.set(key, value);\n  }\n\n  async query(_query: StorageQuery): Promise<unknown[]> {\n    // Stub — returns all values; real implementation would filter\n    return Array.from(this.store.values());\n  }\n\n  async delete(key: string): Promise<boolean> {\n    return this.store.delete(key);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,0BAAuB;AACvB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,4BAAyB;AACzB,EAAAA,WAAA,2BAAwB;AAXd,SAAAA;AAAA,GAAA;;;ACUL,IAAM,WAAN,MAAe;AAAA,EACZ,WAAW,oBAAI,IAA4D;AAAA,EAC3E,SAAS;AAAA,EAEjB,UAAU,QAAqB,SAA+B;AAC5D,UAAM,KAAK,OAAO,KAAK,QAAQ;AAC/B,SAAK,SAAS,IAAI,IAAI,EAAE,QAAQ,QAAQ,CAAC;AACzC,WAAO;AAAA,EACT;AAAA,EAEA,YAAY,IAAkB;AAC5B,SAAK,SAAS,OAAO,EAAE;AAAA,EACzB;AAAA,EAEA,MAAM,KAAK,OAAkC;AAC3C,UAAM,WAA4B,CAAC;AACnC,eAAW,CAAC,EAAE,EAAE,QAAQ,QAAQ,CAAC,KAAK,KAAK,UAAU;AACnD,UAAI,KAAK,QAAQ,OAAO,MAAM,GAAG;AAC/B,cAAM,SAAS,QAAQ,KAAK;AAC5B,YAAI,kBAAkB,SAAS;AAC7B,mBAAS,KAAK,MAAM;AAAA,QACtB;AAAA,MACF;AAAA,IACF;AACA,UAAM,QAAQ,IAAI,QAAQ;AAAA,EAC5B;AAAA,EAEQ,QAAQ,OAAmB,QAA8B;AAC/D,QAAI,OAAO,QAAQ,MAAM,SAAS,OAAO,KAAM,QAAO;AACtD,QAAI,OAAO,aAAa,MAAM,cAAc,OAAO,UAAW,QAAO;AACrE,QAAI,OAAO,mBAAmB,MAAM,oBAAoB,OAAO,gBAAiB,QAAO;AACvF,WAAO;AAAA,EACT;AACF;;;ACtBO,IAAM,gBAAN,MAAoB;AAAA,EACjB,gBAAgB,oBAAI,IAA0B;AAAA,EAEtD,SAAS,cAAkC;AACzC,SAAK,cAAc,IAAI,aAAa,IAAI,YAAY;AAAA,EACtD;AAAA,EAEA,OAAO,gBAA8B;AACnC,SAAK,cAAc,OAAO,cAAc;AAAA,EAC1C;AAAA;AAAA,EAGA,SAAS,QAAyC;AAEhD,WAAO,CAAC;AAAA,EACV;AAAA,EAEA,gBAAgB,IAAsC;AACpD,WAAO,KAAK,cAAc,IAAI,EAAE;AAAA,EAClC;AAAA,EAEA,oBAAoC;AAClC,WAAO,MAAM,KAAK,KAAK,cAAc,OAAO,CAAC;AAAA,EAC/C;AACF;;;AC7BO,IAAM,yBAAN,MAAuD;AAAA,EACpD,QAAQ,oBAAI,IAAqB;AAAA,EAEzC,MAAM,IAAI,KAA2C;AACnD,WAAO,KAAK,MAAM,IAAI,GAAG;AAAA,EAC3B;AAAA,EAEA,MAAM,IAAI,KAAa,OAA+B;AACpD,SAAK,MAAM,IAAI,KAAK,KAAK;AAAA,EAC3B;AAAA,EAEA,MAAM,MAAM,QAA0C;AAEpD,WAAO,MAAM,KAAK,KAAK,MAAM,OAAO,CAAC;AAAA,EACvC;AAAA,EAEA,MAAM,OAAO,KAA+B;AAC1C,WAAO,KAAK,MAAM,OAAO,GAAG;AAAA,EAC9B;AACF;","names":["EventType"]}
+{"version":3,"sources":["../src/index.ts","../src/events.ts","../src/bus.ts","../src/vantage.ts","../src/storage.ts","../src/scheduler.ts","../src/engine.ts","../src/tools.ts"],"sourcesContent":["export { EventType } from \"./events.js\";\nexport type { YesodEvent, CostRecord } from \"./events.js\";\n\nexport { EventBus } from \"./bus.js\";\nexport type { EventHandler, EventFilter } from \"./bus.js\";\n\nexport { VantageEngine } from \"./vantage.js\";\nexport type {\n  Subscription,\n  SubscriptionCondition,\n  NotificationEvent,\n} from \"./vantage.js\";\n\nexport { InMemoryStorageAdapter } from \"./storage.js\";\nexport type { StorageAdapter, StorageQuery } from \"./storage.js\";\n\nexport type {\n  SessionState,\n  SessionControl,\n  CodingSession,\n} from \"./session.js\";\n\nexport { SimpleScheduler } from \"./scheduler.js\";\nexport type { Scheduler, ReadyStep, StepState } from \"./scheduler.js\";\n\nexport type {\n  Workflow,\n  WorkflowStep,\n  WorkflowState,\n  WorkflowInput,\n  WorkflowTrigger,\n} from \"./workflow.js\";\n\nexport { OrchestrationEngine } from \"./engine.js\";\nexport type {\n  WorkflowExecution,\n  EngineWorkflowState,\n  WorkflowStatus,\n  CostSummary,\n} from \"./engine.js\";\n\nexport { YESOD_TOOLS } from \"./tools.js\";\n\nexport type {\n  RuntimeAdapter,\n  SpawnOptions,\n  CodingSpawnOptions,\n  TaskSpec,\n  ResultSpec,\n  RuntimeDecision,\n  SessionHandle,\n  SessionStatus,\n  StepResult,\n  StructuredOutput,\n  SummaryOutput,\n  DiffOutput,\n  ReviewOutput,\n  TestOutput,\n  StructuredFieldsOutput,\n  RawFallbackOutput,\n  RetryPolicy,\n} from \"./runtime.js\";\n","export enum EventType {\n  // Orchestration lifecycle\n  OrchestrationStarted = \"orchestration.started\",\n  OrchestrationCompleted = \"orchestration.completed\",\n\n  // Workflow lifecycle\n  WorkflowStarted = \"workflow.started\",\n  WorkflowCompleted = \"workflow.completed\",\n  WorkflowFailed = \"workflow.failed\",\n  WorkflowStepStarted = \"workflow.step.started\",\n  WorkflowStepCompleted = \"workflow.step.completed\",\n  WorkflowStepFailed = \"workflow.step.failed\",\n\n  // Task lifecycle\n  TaskCreated = \"task.created\",\n  TaskDependency = \"task.dependency\",\n  TaskCompleted = \"task.completed\",\n\n  // Session lifecycle\n  SessionSpawned = \"session.spawned\",\n  SessionMessage = \"session.message\",\n  SessionEvent = \"session.event\",\n  SessionSteered = \"session.steered\",\n  SessionArtifact = \"session.artifact\",\n  SessionCompleted = \"session.completed\",\n  SessionFailed = \"session.failed\",\n  SessionKilled = \"session.killed\",\n\n  // Cost\n  CostIncurred = \"cost.incurred\",\n\n  // Subscriptions\n  SubscriptionTriggered = \"subscription.triggered\",\n}\n\nexport interface CostRecord {\n  tokens: {\n    input: number;\n    output: number;\n    cacheRead?: number;\n    cacheWrite?: number;\n  };\n  usd: number;\n  runtime?: string;\n}\n\nexport interface YesodEvent {\n  id: string;\n  type: EventType;\n  source: string;\n  timestamp: number;\n  sessionId?: string;\n  orchestrationId?: string;\n  taskId?: string;\n  workflowId?: string;\n  stepId?: string;\n  payload: Record<string, unknown>;\n  metadata?: {\n    cost?: CostRecord;\n    duration?: number;\n  };\n}\n","import type { YesodEvent, EventType } from \"./events.js\";\n\nexport type EventHandler = (event: YesodEvent) => void | Promise<void>;\n\nexport interface EventFilter {\n  type?: EventType | EventType[];\n  sessionId?: string;\n  orchestrationId?: string;\n  workflowId?: string;\n}\n\nexport class EventBus {\n  private handlers = new Map<\n    string,\n    { filter: EventFilter; handler: EventHandler }\n  >();\n  private nextId = 0;\n\n  subscribe(filter: EventFilter, handler: EventHandler): string {\n    const id = String(this.nextId++);\n    this.handlers.set(id, { filter, handler });\n    return id;\n  }\n\n  subscribeAll(handler: EventHandler): string {\n    return this.subscribe({}, handler);\n  }\n\n  unsubscribe(id: string): void {\n    this.handlers.delete(id);\n  }\n\n  async emit(event: YesodEvent): Promise<void> {\n    const promises: Promise<void>[] = [];\n    for (const [, { filter, handler }] of this.handlers) {\n      if (this.matches(event, filter)) {\n        const result = handler(event);\n        if (result instanceof Promise) {\n          promises.push(result);\n        }\n      }\n    }\n    await Promise.all(promises);\n  }\n\n  private matches(event: YesodEvent, filter: EventFilter): boolean {\n    if (filter.type) {\n      if (Array.isArray(filter.type)) {\n        if (!filter.type.includes(event.type)) return false;\n      } else {\n        if (event.type !== filter.type) return false;\n      }\n    }\n    if (filter.sessionId && event.sessionId !== filter.sessionId) return false;\n    if (\n      filter.orchestrationId &&\n      event.orchestrationId !== filter.orchestrationId\n    )\n      return false;\n    if (filter.workflowId && event.workflowId !== filter.workflowId)\n      return false;\n    return true;\n  }\n}\n","import type { YesodEvent, EventType } from \"./events.js\";\n\nexport interface SubscriptionCondition {\n  sessionId?: string;\n  eventType: EventType;\n  filter?: Record<string, unknown>;\n}\n\nexport interface Subscription {\n  id: string;\n  orchestratorSession: string;\n  conditions: SubscriptionCondition[];\n  mode: \"any\" | \"all\";\n  once?: boolean;\n  ttl?: number;\n  registeredAt?: number;\n}\n\nexport interface NotificationEvent {\n  type: \"subscription.triggered\";\n  subscriptionId: string;\n  matchedEvents: YesodEvent[];\n}\n\nexport class VantageEngine {\n  private subscriptions = new Map<string, Subscription>();\n  private barrierState = new Map<string, Map<number, YesodEvent[]>>();\n\n  register(subscription: Subscription): void {\n    const sub = { ...subscription, registeredAt: subscription.registeredAt ?? Date.now() };\n    this.subscriptions.set(sub.id, sub);\n    if (sub.mode === \"all\") {\n      this.barrierState.set(sub.id, new Map());\n    }\n  }\n\n  remove(subscriptionId: string): void {\n    this.subscriptions.delete(subscriptionId);\n    this.barrierState.delete(subscriptionId);\n  }\n\n  evaluate(event: YesodEvent): NotificationEvent[] {\n    const notifications: NotificationEvent[] = [];\n    const toRemove: string[] = [];\n\n    for (const [id, sub] of this.subscriptions) {\n      // TTL expiration\n      if (sub.ttl && sub.registeredAt) {\n        if (Date.now() - sub.registeredAt > sub.ttl) {\n          toRemove.push(id);\n          continue;\n        }\n      }\n\n      if (sub.mode === \"any\") {\n        const matched = this.matchAny(event, sub);\n        if (matched) {\n          notifications.push({\n            type: \"subscription.triggered\",\n            subscriptionId: id,\n            matchedEvents: [event],\n          });\n          if (sub.once) toRemove.push(id);\n        }\n      } else {\n        // \"all\" — barrier mode\n        const notification = this.matchBarrier(event, sub);\n        if (notification) {\n          notifications.push(notification);\n          if (sub.once) toRemove.push(id);\n        }\n      }\n    }\n\n    for (const id of toRemove) {\n      this.remove(id);\n    }\n\n    return notifications;\n  }\n\n  getSubscription(id: string): Subscription | undefined {\n    return this.subscriptions.get(id);\n  }\n\n  listSubscriptions(): Subscription[] {\n    return Array.from(this.subscriptions.values());\n  }\n\n  activeCount(): number {\n    return this.subscriptions.size;\n  }\n\n  private matchAny(event: YesodEvent, sub: Subscription): boolean {\n    return sub.conditions.some((cond) => this.matchCondition(event, cond));\n  }\n\n  private matchBarrier(\n    event: YesodEvent,\n    sub: Subscription,\n  ): NotificationEvent | null {\n    let barrier = this.barrierState.get(sub.id);\n    if (!barrier) {\n      barrier = new Map();\n      this.barrierState.set(sub.id, barrier);\n    }\n\n    // Check each condition — if this event matches, record it\n    for (let i = 0; i < sub.conditions.length; i++) {\n      if (barrier.has(i)) continue; // already satisfied\n      if (this.matchCondition(event, sub.conditions[i])) {\n        barrier.set(i, [event]);\n      }\n    }\n\n    // Check if all conditions are now satisfied\n    if (barrier.size === sub.conditions.length) {\n      const allEvents: YesodEvent[] = [];\n      for (const events of barrier.values()) {\n        allEvents.push(...events);\n      }\n      this.barrierState.delete(sub.id);\n      return {\n        type: \"subscription.triggered\",\n        subscriptionId: sub.id,\n        matchedEvents: allEvents,\n      };\n    }\n\n    return null;\n  }\n\n  private matchCondition(\n    event: YesodEvent,\n    cond: SubscriptionCondition,\n  ): boolean {\n    if (event.type !== cond.eventType) return false;\n    if (cond.sessionId && event.sessionId !== cond.sessionId) return false;\n    if (cond.filter) {\n      for (const [key, value] of Object.entries(cond.filter)) {\n        if (event.payload[key] !== value) return false;\n      }\n    }\n    return true;\n  }\n}\n","export interface StorageQuery {\n  type?: string;\n  sessionId?: string;\n  orchestrationId?: string;\n  from?: string;\n  to?: string;\n  limit?: number;\n}\n\nexport interface StorageAdapter {\n  get(key: string): Promise<unknown | undefined>;\n  put(key: string, value: unknown): Promise<void>;\n  query(query: StorageQuery): Promise<unknown[]>;\n  delete(key: string): Promise<boolean>;\n}\n\nexport class InMemoryStorageAdapter implements StorageAdapter {\n  private store = new Map<string, unknown>();\n\n  async get(key: string): Promise<unknown | undefined> {\n    return this.store.get(key);\n  }\n\n  async put(key: string, value: unknown): Promise<void> {\n    this.store.set(key, value);\n  }\n\n  async query(_query: StorageQuery): Promise<unknown[]> {\n    // Stub — returns all values; real implementation would filter\n    return Array.from(this.store.values());\n  }\n\n  async delete(key: string): Promise<boolean> {\n    return this.store.delete(key);\n  }\n}\n","import type { WorkflowStep } from \"./workflow.js\";\n\nexport interface ReadyStep {\n  step: WorkflowStep;\n  reason: string;\n}\n\nexport interface Scheduler {\n  getReadySteps(): ReadyStep[];\n}\n\nexport type StepState = \"pending\" | \"running\" | \"completed\" | \"failed\";\n\nexport class SimpleScheduler implements Scheduler {\n  private stepStates = new Map<string, StepState>();\n  private stepMap = new Map<string, WorkflowStep>();\n\n  constructor(steps: WorkflowStep[]) {\n    for (const step of steps) {\n      this.stepMap.set(step.id, step);\n      this.stepStates.set(step.id, \"pending\");\n    }\n  }\n\n  getReadySteps(): ReadyStep[] {\n    const ready: ReadyStep[] = [];\n    for (const [id, state] of this.stepStates) {\n      if (state !== \"pending\") continue;\n      const step = this.stepMap.get(id)!;\n      const deps = step.dependsOn ?? [];\n      const allDepsCompleted = deps.every(\n        (depId) => this.stepStates.get(depId) === \"completed\",\n      );\n      if (allDepsCompleted) {\n        const reason =\n          deps.length === 0\n            ? \"No dependencies\"\n            : `Dependencies satisfied: ${deps.join(\", \")}`;\n        ready.push({ step, reason });\n      }\n    }\n    return ready;\n  }\n\n  markRunning(stepId: string): void {\n    this.stepStates.set(stepId, \"running\");\n  }\n\n  markCompleted(stepId: string): void {\n    this.stepStates.set(stepId, \"completed\");\n  }\n\n  markFailed(stepId: string): void {\n    this.stepStates.set(stepId, \"failed\");\n  }\n\n  getState(stepId: string): StepState | undefined {\n    return this.stepStates.get(stepId);\n  }\n\n  isComplete(): boolean {\n    for (const state of this.stepStates.values()) {\n      if (state !== \"completed\" && state !== \"failed\") return false;\n    }\n    return true;\n  }\n\n  allSucceeded(): boolean {\n    for (const state of this.stepStates.values()) {\n      if (state !== \"completed\") return false;\n    }\n    return true;\n  }\n\n  /**\n   * Mark any pending step whose dependencies include a failed step as failed.\n   * Returns IDs of newly failed steps.\n   */\n  markUnreachable(): string[] {\n    const failed: string[] = [];\n    let changed = true;\n    while (changed) {\n      changed = false;\n      for (const [id, state] of this.stepStates) {\n        if (state !== \"pending\") continue;\n        const step = this.stepMap.get(id)!;\n        const deps = step.dependsOn ?? [];\n        const hasFailedDep = deps.some(\n          (depId) => this.stepStates.get(depId) === \"failed\",\n        );\n        if (hasFailedDep) {\n          this.stepStates.set(id, \"failed\");\n          failed.push(id);\n          changed = true;\n        }\n      }\n    }\n    return failed;\n  }\n}\n","import { EventType } from \"./events.js\";\nimport type { YesodEvent, CostRecord } from \"./events.js\";\nimport type {\n  RuntimeAdapter,\n  SpawnOptions,\n  SessionHandle,\n  StepResult,\n  TaskSpec,\n} from \"./runtime.js\";\nimport type { Workflow, WorkflowStep } from \"./workflow.js\";\nimport type { StorageAdapter } from \"./storage.js\";\nimport { EventBus } from \"./bus.js\";\nimport { SimpleScheduler } from \"./scheduler.js\";\n\nlet idCounter = 0;\nfunction uid(): string {\n  return `evt-${Date.now()}-${++idCounter}`;\n}\n\nexport type EngineWorkflowState = \"created\" | \"running\" | \"completed\" | \"failed\";\n\nexport interface WorkflowExecution {\n  workflow: Workflow;\n  state: EngineWorkflowState;\n  scheduler: SimpleScheduler;\n  stepResults: Map<string, StepResult>;\n  activeSessions: Map<string, SessionHandle>; // stepId -> handle\n  startedAt: number;\n  completedAt?: number;\n}\n\nexport interface WorkflowStatus {\n  workflowId: string;\n  state: EngineWorkflowState;\n  steps: Array<{\n    stepId: string;\n    state: string;\n    result?: StepResult;\n  }>;\n  startedAt: number;\n  completedAt?: number;\n}\n\nexport interface CostSummary {\n  totalUsd: number;\n  totalTokens: { input: number; output: number };\n  perStep: Array<{\n    stepId: string;\n    cost: CostRecord;\n    durationMs: number;\n  }>;\n}\n\nexport class OrchestrationEngine {\n  private executions = new Map<string, WorkflowExecution>();\n\n  constructor(\n    private adapter: RuntimeAdapter,\n    private bus: EventBus,\n    private storage: StorageAdapter,\n  ) {\n    // Listen for session completions from the adapter\n    this.adapter.onEvent((event) => this.handleAdapterEvent(event));\n  }\n\n  createWorkflow(def: Workflow): Workflow {\n    const workflow: Workflow = {\n      ...def,\n      id: def.id || uid(),\n      state: \"created\",\n      createdAt: Date.now(),\n    };\n\n    const scheduler = new SimpleScheduler(workflow.steps);\n    this.executions.set(workflow.id, {\n      workflow,\n      state: \"created\",\n      scheduler,\n      stepResults: new Map(),\n      activeSessions: new Map(),\n      startedAt: 0,\n    });\n\n    return workflow;\n  }\n\n  async startWorkflow(workflowId: string): Promise<void> {\n    const exec = this.executions.get(workflowId);\n    if (!exec) throw new Error(`Unknown workflow: ${workflowId}`);\n    if (exec.state !== \"created\") {\n      throw new Error(`Workflow ${workflowId} is already ${exec.state}`);\n    }\n\n    exec.state = \"running\";\n    exec.startedAt = Date.now();\n\n    await this.bus.emit({\n      id: uid(),\n      type: EventType.WorkflowStarted,\n      source: \"engine\",\n      timestamp: Date.now(),\n      workflowId,\n      payload: { name: exec.workflow.name },\n    });\n\n    await this.advanceWorkflow(workflowId);\n  }\n\n  async cancelWorkflow(workflowId: string): Promise<void> {\n    const exec = this.executions.get(workflowId);\n    if (!exec) throw new Error(`Unknown workflow: ${workflowId}`);\n\n    // Kill all active sessions\n    for (const [stepId, handle] of exec.activeSessions) {\n      try {\n        await this.adapter.kill(handle);\n      } catch {\n        // best effort\n      }\n      exec.scheduler.markFailed(stepId);\n    }\n    exec.activeSessions.clear();\n\n    exec.state = \"failed\";\n    exec.completedAt = Date.now();\n\n    await this.bus.emit({\n      id: uid(),\n      type: EventType.WorkflowFailed,\n      source: \"engine\",\n      timestamp: Date.now(),\n      workflowId,\n      payload: { reason: \"cancelled\" },\n    });\n  }\n\n  getWorkflowStatus(workflowId: string): WorkflowStatus {\n    const exec = this.executions.get(workflowId);\n    if (!exec) throw new Error(`Unknown workflow: ${workflowId}`);\n\n    return {\n      workflowId,\n      state: exec.state,\n      steps: exec.workflow.steps.map((step) => ({\n        stepId: step.id,\n        state: exec.scheduler.getState(step.id) ?? \"pending\",\n        result: exec.stepResults.get(step.id),\n      })),\n      startedAt: exec.startedAt,\n      completedAt: exec.completedAt,\n    };\n  }\n\n  getCostSummary(workflowId?: string): CostSummary {\n    let results: StepResult[] = [];\n\n    if (workflowId) {\n      const exec = this.executions.get(workflowId);\n      if (exec) {\n        results = Array.from(exec.stepResults.values());\n      }\n    } else {\n      for (const exec of this.executions.values()) {\n        results.push(...exec.stepResults.values());\n      }\n    }\n\n    let totalUsd = 0;\n    let totalInput = 0;\n    let totalOutput = 0;\n    const perStep: CostSummary[\"perStep\"] = [];\n\n    for (const r of results) {\n      totalUsd += r.meta.cost.usd;\n      totalInput += r.meta.cost.tokens.input;\n      totalOutput += r.meta.cost.tokens.output;\n      perStep.push({\n        stepId: r.stepId,\n        cost: r.meta.cost,\n        durationMs: r.meta.durationMs,\n      });\n    }\n\n    return {\n      totalUsd,\n      totalTokens: { input: totalInput, output: totalOutput },\n      perStep,\n    };\n  }\n\n  // --- Internal ---\n\n  private async advanceWorkflow(workflowId: string): Promise<void> {\n    const exec = this.executions.get(workflowId);\n    if (!exec || exec.state !== \"running\") return;\n\n    const readySteps = exec.scheduler.getReadySteps();\n\n    for (const { step } of readySteps) {\n      exec.scheduler.markRunning(step.id);\n      try {\n        await this.spawnStep(exec, step, workflowId);\n      } catch (err) {\n        exec.scheduler.markFailed(step.id);\n        await this.bus.emit({\n          id: uid(),\n          type: EventType.WorkflowStepFailed,\n          source: \"engine\",\n          timestamp: Date.now(),\n          workflowId,\n          stepId: step.id,\n          payload: {\n            error: err instanceof Error ? err.message : String(err),\n          },\n        });\n      }\n    }\n\n    // Mark steps that can never run due to failed dependencies\n    exec.scheduler.markUnreachable();\n\n    // Check if workflow is done (no more ready steps and nothing running)\n    if (exec.scheduler.isComplete()) {\n      exec.state = exec.scheduler.allSucceeded() ? \"completed\" : \"failed\";\n      exec.completedAt = Date.now();\n\n      const eventType = exec.state === \"completed\"\n        ? EventType.WorkflowCompleted\n        : EventType.WorkflowFailed;\n\n      await this.bus.emit({\n        id: uid(),\n        type: eventType,\n        source: \"engine\",\n        timestamp: Date.now(),\n        workflowId,\n        payload: {\n          duration: exec.completedAt - exec.startedAt,\n        },\n      });\n    }\n  }\n\n  private async spawnStep(\n    exec: WorkflowExecution,\n    step: WorkflowStep,\n    workflowId: string,\n  ): Promise<void> {\n    // Collect prior context from dependencies\n    const priorContext: StepResult[] = [];\n    for (const depId of step.dependsOn ?? []) {\n      const depResult = exec.stepResults.get(depId);\n      if (depResult) priorContext.push(depResult);\n    }\n\n    const taskSpec: TaskSpec = {\n      instruction: step.task,\n      expectedResult: step.expectedResult,\n      priorContext: priorContext.length > 0 ? priorContext : undefined,\n    };\n\n    const spawnOpts: SpawnOptions = {\n      task: taskSpec,\n      runtime: step.runtime,\n      decision: step.decision,\n      timeout: step.timeout,\n      context: { workflowId, stepId: step.id, attempt: 1 },\n    };\n\n    await this.bus.emit({\n      id: uid(),\n      type: EventType.WorkflowStepStarted,\n      source: \"engine\",\n      timestamp: Date.now(),\n      workflowId,\n      stepId: step.id,\n      payload: { runtime: step.runtime },\n    });\n\n    const handle = await this.adapter.spawn(spawnOpts);\n    exec.activeSessions.set(step.id, handle);\n  }\n\n  private async handleAdapterEvent(event: YesodEvent): Promise<void> {\n    // Forward all adapter events through the bus\n    await this.bus.emit(event);\n\n    if (event.type === EventType.SessionCompleted && event.stepId) {\n      await this.handleStepCompleted(event);\n    } else if (event.type === EventType.SessionFailed && event.stepId) {\n      await this.handleStepFailed(event);\n    }\n  }\n\n  private async handleStepCompleted(event: YesodEvent): Promise<void> {\n    const workflowId = event.workflowId;\n    const stepId = event.stepId;\n    if (!workflowId || !stepId) return;\n\n    const exec = this.executions.get(workflowId);\n    if (!exec) return;\n\n    const stepResult = event.payload.stepResult as StepResult | undefined;\n    if (stepResult) {\n      exec.stepResults.set(stepId, stepResult);\n    }\n\n    exec.activeSessions.delete(stepId);\n    exec.scheduler.markCompleted(stepId);\n\n    await this.bus.emit({\n      id: uid(),\n      type: EventType.WorkflowStepCompleted,\n      source: \"engine\",\n      timestamp: Date.now(),\n      workflowId,\n      stepId,\n      payload: { result: stepResult },\n    });\n\n    // Continue advancing the workflow\n    await this.advanceWorkflow(workflowId);\n  }\n\n  private async handleStepFailed(event: YesodEvent): Promise<void> {\n    const workflowId = event.workflowId;\n    const stepId = event.stepId;\n    if (!workflowId || !stepId) return;\n\n    const exec = this.executions.get(workflowId);\n    if (!exec) return;\n\n    exec.activeSessions.delete(stepId);\n    exec.scheduler.markFailed(stepId);\n\n    await this.bus.emit({\n      id: uid(),\n      type: EventType.WorkflowStepFailed,\n      source: \"engine\",\n      timestamp: Date.now(),\n      workflowId,\n      stepId,\n      payload: { error: event.payload.error },\n    });\n\n    await this.advanceWorkflow(workflowId);\n  }\n}\n","/**\n * MCP tool JSON Schema definitions for Yesod agent-facing tools.\n */\n\nexport const YESOD_TOOLS = {\n  yesod_create_workflow: {\n    name: \"yesod_create_workflow\",\n    description:\n      \"Create and start a multi-step workflow. Define the steps, their dependencies, and expected output formats. Yesod will orchestrate execution, spawn child agents, and chain results automatically.\",\n    inputSchema: {\n      type: \"object\" as const,\n      properties: {\n        name: {\n          type: \"string\",\n          description: \"Human-readable name for the workflow\",\n        },\n        steps: {\n          type: \"array\",\n          description: \"Workflow steps to execute\",\n          items: {\n            type: \"object\",\n            properties: {\n              id: {\n                type: \"string\",\n                description: \"Unique step identifier\",\n              },\n              name: {\n                type: \"string\",\n                description: \"Human-readable step name\",\n              },\n              task: {\n                type: \"string\",\n                description: \"Instruction for the agent performing this step\",\n              },\n              expectedResult: {\n                type: \"object\",\n                description: \"Expected output format\",\n                properties: {\n                  format: {\n                    type: \"string\",\n                    enum: [\"summary\", \"structured\", \"diff\", \"review\", \"test\"],\n                  },\n                  fields: {\n                    type: \"array\",\n                    items: { type: \"string\" },\n                    description: \"Fields to include (for structured format)\",\n                  },\n                  maxLength: {\n                    type: \"number\",\n                    description: \"Max output length in characters\",\n                  },\n                },\n                required: [\"format\"],\n              },\n              runtime: {\n                type: \"string\",\n                description:\n                  \"Runtime to use (e.g. claude-code, codex)\",\n              },\n              decision: {\n                type: \"object\",\n                description: \"Why this runtime was chosen\",\n                properties: {\n                  reason: { type: \"string\" },\n                  considered: {\n                    type: \"array\",\n                    items: { type: \"string\" },\n                  },\n                  chosen: { type: \"string\" },\n                },\n                required: [\"reason\", \"considered\", \"chosen\"],\n              },\n              dependsOn: {\n                type: \"array\",\n                items: { type: \"string\" },\n                description: \"Step IDs this step depends on\",\n              },\n              timeout: {\n                type: \"number\",\n                description: \"Timeout in milliseconds\",\n              },\n            },\n            required: [\n              \"id\",\n              \"name\",\n              \"task\",\n              \"expectedResult\",\n              \"runtime\",\n              \"decision\",\n            ],\n          },\n        },\n      },\n      required: [\"name\", \"steps\"],\n    },\n  },\n\n  yesod_workflow_status: {\n    name: \"yesod_workflow_status\",\n    description:\n      \"Check the current status of a running workflow, including per-step progress and results.\",\n    inputSchema: {\n      type: \"object\" as const,\n      properties: {\n        workflowId: {\n          type: \"string\",\n          description: \"ID of the workflow to check\",\n        },\n      },\n      required: [\"workflowId\"],\n    },\n  },\n\n  yesod_cancel_workflow: {\n    name: \"yesod_cancel_workflow\",\n    description:\n      \"Cancel a running workflow. Kills all active sessions and marks the workflow as failed.\",\n    inputSchema: {\n      type: \"object\" as const,\n      properties: {\n        workflowId: {\n          type: \"string\",\n          description: \"ID of the workflow to cancel\",\n        },\n      },\n      required: [\"workflowId\"],\n    },\n  },\n\n  yesod_cost_summary: {\n    name: \"yesod_cost_summary\",\n    description:\n      \"Get a cost breakdown showing token usage and USD cost, optionally filtered to a specific workflow.\",\n    inputSchema: {\n      type: \"object\" as const,\n      properties: {\n        workflowId: {\n          type: \"string\",\n          description: \"Optional: filter to a specific workflow\",\n        },\n      },\n    },\n  },\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAK,YAAL,kBAAKA,eAAL;AAEL,EAAAA,WAAA,0BAAuB;AACvB,EAAAA,WAAA,4BAAyB;AAGzB,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,uBAAoB;AACpB,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,yBAAsB;AACtB,EAAAA,WAAA,2BAAwB;AACxB,EAAAA,WAAA,wBAAqB;AAGrB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,mBAAgB;AAGhB,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,mBAAgB;AAGhB,EAAAA,WAAA,kBAAe;AAGf,EAAAA,WAAA,2BAAwB;AAhCd,SAAAA;AAAA,GAAA;;;ACWL,IAAM,WAAN,MAAe;AAAA,EACZ,WAAW,oBAAI,IAGrB;AAAA,EACM,SAAS;AAAA,EAEjB,UAAU,QAAqB,SAA+B;AAC5D,UAAM,KAAK,OAAO,KAAK,QAAQ;AAC/B,SAAK,SAAS,IAAI,IAAI,EAAE,QAAQ,QAAQ,CAAC;AACzC,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,SAA+B;AAC1C,WAAO,KAAK,UAAU,CAAC,GAAG,OAAO;AAAA,EACnC;AAAA,EAEA,YAAY,IAAkB;AAC5B,SAAK,SAAS,OAAO,EAAE;AAAA,EACzB;AAAA,EAEA,MAAM,KAAK,OAAkC;AAC3C,UAAM,WAA4B,CAAC;AACnC,eAAW,CAAC,EAAE,EAAE,QAAQ,QAAQ,CAAC,KAAK,KAAK,UAAU;AACnD,UAAI,KAAK,QAAQ,OAAO,MAAM,GAAG;AAC/B,cAAM,SAAS,QAAQ,KAAK;AAC5B,YAAI,kBAAkB,SAAS;AAC7B,mBAAS,KAAK,MAAM;AAAA,QACtB;AAAA,MACF;AAAA,IACF;AACA,UAAM,QAAQ,IAAI,QAAQ;AAAA,EAC5B;AAAA,EAEQ,QAAQ,OAAmB,QAA8B;AAC/D,QAAI,OAAO,MAAM;AACf,UAAI,MAAM,QAAQ,OAAO,IAAI,GAAG;AAC9B,YAAI,CAAC,OAAO,KAAK,SAAS,MAAM,IAAI,EAAG,QAAO;AAAA,MAChD,OAAO;AACL,YAAI,MAAM,SAAS,OAAO,KAAM,QAAO;AAAA,MACzC;AAAA,IACF;AACA,QAAI,OAAO,aAAa,MAAM,cAAc,OAAO,UAAW,QAAO;AACrE,QACE,OAAO,mBACP,MAAM,oBAAoB,OAAO;AAEjC,aAAO;AACT,QAAI,OAAO,cAAc,MAAM,eAAe,OAAO;AACnD,aAAO;AACT,WAAO;AAAA,EACT;AACF;;;ACvCO,IAAM,gBAAN,MAAoB;AAAA,EACjB,gBAAgB,oBAAI,IAA0B;AAAA,EAC9C,eAAe,oBAAI,IAAuC;AAAA,EAElE,SAAS,cAAkC;AACzC,UAAM,MAAM,EAAE,GAAG,cAAc,cAAc,aAAa,gBAAgB,KAAK,IAAI,EAAE;AACrF,SAAK,cAAc,IAAI,IAAI,IAAI,GAAG;AAClC,QAAI,IAAI,SAAS,OAAO;AACtB,WAAK,aAAa,IAAI,IAAI,IAAI,oBAAI,IAAI,CAAC;AAAA,IACzC;AAAA,EACF;AAAA,EAEA,OAAO,gBAA8B;AACnC,SAAK,cAAc,OAAO,cAAc;AACxC,SAAK,aAAa,OAAO,cAAc;AAAA,EACzC;AAAA,EAEA,SAAS,OAAwC;AAC/C,UAAM,gBAAqC,CAAC;AAC5C,UAAM,WAAqB,CAAC;AAE5B,eAAW,CAAC,IAAI,GAAG,KAAK,KAAK,eAAe;AAE1C,UAAI,IAAI,OAAO,IAAI,cAAc;AAC/B,YAAI,KAAK,IAAI,IAAI,IAAI,eAAe,IAAI,KAAK;AAC3C,mBAAS,KAAK,EAAE;AAChB;AAAA,QACF;AAAA,MACF;AAEA,UAAI,IAAI,SAAS,OAAO;AACtB,cAAM,UAAU,KAAK,SAAS,OAAO,GAAG;AACxC,YAAI,SAAS;AACX,wBAAc,KAAK;AAAA,YACjB,MAAM;AAAA,YACN,gBAAgB;AAAA,YAChB,eAAe,CAAC,KAAK;AAAA,UACvB,CAAC;AACD,cAAI,IAAI,KAAM,UAAS,KAAK,EAAE;AAAA,QAChC;AAAA,MACF,OAAO;AAEL,cAAM,eAAe,KAAK,aAAa,OAAO,GAAG;AACjD,YAAI,cAAc;AAChB,wBAAc,KAAK,YAAY;AAC/B,cAAI,IAAI,KAAM,UAAS,KAAK,EAAE;AAAA,QAChC;AAAA,MACF;AAAA,IACF;AAEA,eAAW,MAAM,UAAU;AACzB,WAAK,OAAO,EAAE;AAAA,IAChB;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,gBAAgB,IAAsC;AACpD,WAAO,KAAK,cAAc,IAAI,EAAE;AAAA,EAClC;AAAA,EAEA,oBAAoC;AAClC,WAAO,MAAM,KAAK,KAAK,cAAc,OAAO,CAAC;AAAA,EAC/C;AAAA,EAEA,cAAsB;AACpB,WAAO,KAAK,cAAc;AAAA,EAC5B;AAAA,EAEQ,SAAS,OAAmB,KAA4B;AAC9D,WAAO,IAAI,WAAW,KAAK,CAAC,SAAS,KAAK,eAAe,OAAO,IAAI,CAAC;AAAA,EACvE;AAAA,EAEQ,aACN,OACA,KAC0B;AAC1B,QAAI,UAAU,KAAK,aAAa,IAAI,IAAI,EAAE;AAC1C,QAAI,CAAC,SAAS;AACZ,gBAAU,oBAAI,IAAI;AAClB,WAAK,aAAa,IAAI,IAAI,IAAI,OAAO;AAAA,IACvC;AAGA,aAAS,IAAI,GAAG,IAAI,IAAI,WAAW,QAAQ,KAAK;AAC9C,UAAI,QAAQ,IAAI,CAAC,EAAG;AACpB,UAAI,KAAK,eAAe,OAAO,IAAI,WAAW,CAAC,CAAC,GAAG;AACjD,gBAAQ,IAAI,GAAG,CAAC,KAAK,CAAC;AAAA,MACxB;AAAA,IACF;AAGA,QAAI,QAAQ,SAAS,IAAI,WAAW,QAAQ;AAC1C,YAAM,YAA0B,CAAC;AACjC,iBAAW,UAAU,QAAQ,OAAO,GAAG;AACrC,kBAAU,KAAK,GAAG,MAAM;AAAA,MAC1B;AACA,WAAK,aAAa,OAAO,IAAI,EAAE;AAC/B,aAAO;AAAA,QACL,MAAM;AAAA,QACN,gBAAgB,IAAI;AAAA,QACpB,eAAe;AAAA,MACjB;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,eACN,OACA,MACS;AACT,QAAI,MAAM,SAAS,KAAK,UAAW,QAAO;AAC1C,QAAI,KAAK,aAAa,MAAM,cAAc,KAAK,UAAW,QAAO;AACjE,QAAI,KAAK,QAAQ;AACf,iBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,MAAM,GAAG;AACtD,YAAI,MAAM,QAAQ,GAAG,MAAM,MAAO,QAAO;AAAA,MAC3C;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACF;;;ACjIO,IAAM,yBAAN,MAAuD;AAAA,EACpD,QAAQ,oBAAI,IAAqB;AAAA,EAEzC,MAAM,IAAI,KAA2C;AACnD,WAAO,KAAK,MAAM,IAAI,GAAG;AAAA,EAC3B;AAAA,EAEA,MAAM,IAAI,KAAa,OAA+B;AACpD,SAAK,MAAM,IAAI,KAAK,KAAK;AAAA,EAC3B;AAAA,EAEA,MAAM,MAAM,QAA0C;AAEpD,WAAO,MAAM,KAAK,KAAK,MAAM,OAAO,CAAC;AAAA,EACvC;AAAA,EAEA,MAAM,OAAO,KAA+B;AAC1C,WAAO,KAAK,MAAM,OAAO,GAAG;AAAA,EAC9B;AACF;;;ACtBO,IAAM,kBAAN,MAA2C;AAAA,EACxC,aAAa,oBAAI,IAAuB;AAAA,EACxC,UAAU,oBAAI,IAA0B;AAAA,EAEhD,YAAY,OAAuB;AACjC,eAAW,QAAQ,OAAO;AACxB,WAAK,QAAQ,IAAI,KAAK,IAAI,IAAI;AAC9B,WAAK,WAAW,IAAI,KAAK,IAAI,SAAS;AAAA,IACxC;AAAA,EACF;AAAA,EAEA,gBAA6B;AAC3B,UAAM,QAAqB,CAAC;AAC5B,eAAW,CAAC,IAAI,KAAK,KAAK,KAAK,YAAY;AACzC,UAAI,UAAU,UAAW;AACzB,YAAM,OAAO,KAAK,QAAQ,IAAI,EAAE;AAChC,YAAM,OAAO,KAAK,aAAa,CAAC;AAChC,YAAM,mBAAmB,KAAK;AAAA,QAC5B,CAAC,UAAU,KAAK,WAAW,IAAI,KAAK,MAAM;AAAA,MAC5C;AACA,UAAI,kBAAkB;AACpB,cAAM,SACJ,KAAK,WAAW,IACZ,oBACA,2BAA2B,KAAK,KAAK,IAAI,CAAC;AAChD,cAAM,KAAK,EAAE,MAAM,OAAO,CAAC;AAAA,MAC7B;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAEA,YAAY,QAAsB;AAChC,SAAK,WAAW,IAAI,QAAQ,SAAS;AAAA,EACvC;AAAA,EAEA,cAAc,QAAsB;AAClC,SAAK,WAAW,IAAI,QAAQ,WAAW;AAAA,EACzC;AAAA,EAEA,WAAW,QAAsB;AAC/B,SAAK,WAAW,IAAI,QAAQ,QAAQ;AAAA,EACtC;AAAA,EAEA,SAAS,QAAuC;AAC9C,WAAO,KAAK,WAAW,IAAI,MAAM;AAAA,EACnC;AAAA,EAEA,aAAsB;AACpB,eAAW,SAAS,KAAK,WAAW,OAAO,GAAG;AAC5C,UAAI,UAAU,eAAe,UAAU,SAAU,QAAO;AAAA,IAC1D;AACA,WAAO;AAAA,EACT;AAAA,EAEA,eAAwB;AACtB,eAAW,SAAS,KAAK,WAAW,OAAO,GAAG;AAC5C,UAAI,UAAU,YAAa,QAAO;AAAA,IACpC;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,kBAA4B;AAC1B,UAAM,SAAmB,CAAC;AAC1B,QAAI,UAAU;AACd,WAAO,SAAS;AACd,gBAAU;AACV,iBAAW,CAAC,IAAI,KAAK,KAAK,KAAK,YAAY;AACzC,YAAI,UAAU,UAAW;AACzB,cAAM,OAAO,KAAK,QAAQ,IAAI,EAAE;AAChC,cAAM,OAAO,KAAK,aAAa,CAAC;AAChC,cAAM,eAAe,KAAK;AAAA,UACxB,CAAC,UAAU,KAAK,WAAW,IAAI,KAAK,MAAM;AAAA,QAC5C;AACA,YAAI,cAAc;AAChB,eAAK,WAAW,IAAI,IAAI,QAAQ;AAChC,iBAAO,KAAK,EAAE;AACd,oBAAU;AAAA,QACZ;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACF;;;ACrFA,IAAI,YAAY;AAChB,SAAS,MAAc;AACrB,SAAO,OAAO,KAAK,IAAI,CAAC,IAAI,EAAE,SAAS;AACzC;AAoCO,IAAM,sBAAN,MAA0B;AAAA,EAG/B,YACU,SACA,KACA,SACR;AAHQ;AACA;AACA;AAGR,SAAK,QAAQ,QAAQ,CAAC,UAAU,KAAK,mBAAmB,KAAK,CAAC;AAAA,EAChE;AAAA,EANU;AAAA,EACA;AAAA,EACA;AAAA,EALF,aAAa,oBAAI,IAA+B;AAAA,EAWxD,eAAe,KAAyB;AACtC,UAAM,WAAqB;AAAA,MACzB,GAAG;AAAA,MACH,IAAI,IAAI,MAAM,IAAI;AAAA,MAClB,OAAO;AAAA,MACP,WAAW,KAAK,IAAI;AAAA,IACtB;AAEA,UAAM,YAAY,IAAI,gBAAgB,SAAS,KAAK;AACpD,SAAK,WAAW,IAAI,SAAS,IAAI;AAAA,MAC/B;AAAA,MACA,OAAO;AAAA,MACP;AAAA,MACA,aAAa,oBAAI,IAAI;AAAA,MACrB,gBAAgB,oBAAI,IAAI;AAAA,MACxB,WAAW;AAAA,IACb,CAAC;AAED,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,cAAc,YAAmC;AACrD,UAAM,OAAO,KAAK,WAAW,IAAI,UAAU;AAC3C,QAAI,CAAC,KAAM,OAAM,IAAI,MAAM,qBAAqB,UAAU,EAAE;AAC5D,QAAI,KAAK,UAAU,WAAW;AAC5B,YAAM,IAAI,MAAM,YAAY,UAAU,eAAe,KAAK,KAAK,EAAE;AAAA,IACnE;AAEA,SAAK,QAAQ;AACb,SAAK,YAAY,KAAK,IAAI;AAE1B,UAAM,KAAK,IAAI,KAAK;AAAA,MAClB,IAAI,IAAI;AAAA,MACR;AAAA,MACA,QAAQ;AAAA,MACR,WAAW,KAAK,IAAI;AAAA,MACpB;AAAA,MACA,SAAS,EAAE,MAAM,KAAK,SAAS,KAAK;AAAA,IACtC,CAAC;AAED,UAAM,KAAK,gBAAgB,UAAU;AAAA,EACvC;AAAA,EAEA,MAAM,eAAe,YAAmC;AACtD,UAAM,OAAO,KAAK,WAAW,IAAI,UAAU;AAC3C,QAAI,CAAC,KAAM,OAAM,IAAI,MAAM,qBAAqB,UAAU,EAAE;AAG5D,eAAW,CAAC,QAAQ,MAAM,KAAK,KAAK,gBAAgB;AAClD,UAAI;AACF,cAAM,KAAK,QAAQ,KAAK,MAAM;AAAA,MAChC,QAAQ;AAAA,MAER;AACA,WAAK,UAAU,WAAW,MAAM;AAAA,IAClC;AACA,SAAK,eAAe,MAAM;AAE1B,SAAK,QAAQ;AACb,SAAK,cAAc,KAAK,IAAI;AAE5B,UAAM,KAAK,IAAI,KAAK;AAAA,MAClB,IAAI,IAAI;AAAA,MACR;AAAA,MACA,QAAQ;AAAA,MACR,WAAW,KAAK,IAAI;AAAA,MACpB;AAAA,MACA,SAAS,EAAE,QAAQ,YAAY;AAAA,IACjC,CAAC;AAAA,EACH;AAAA,EAEA,kBAAkB,YAAoC;AACpD,UAAM,OAAO,KAAK,WAAW,IAAI,UAAU;AAC3C,QAAI,CAAC,KAAM,OAAM,IAAI,MAAM,qBAAqB,UAAU,EAAE;AAE5D,WAAO;AAAA,MACL;AAAA,MACA,OAAO,KAAK;AAAA,MACZ,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC,UAAU;AAAA,QACxC,QAAQ,KAAK;AAAA,QACb,OAAO,KAAK,UAAU,SAAS,KAAK,EAAE,KAAK;AAAA,QAC3C,QAAQ,KAAK,YAAY,IAAI,KAAK,EAAE;AAAA,MACtC,EAAE;AAAA,MACF,WAAW,KAAK;AAAA,MAChB,aAAa,KAAK;AAAA,IACpB;AAAA,EACF;AAAA,EAEA,eAAe,YAAkC;AAC/C,QAAI,UAAwB,CAAC;AAE7B,QAAI,YAAY;AACd,YAAM,OAAO,KAAK,WAAW,IAAI,UAAU;AAC3C,UAAI,MAAM;AACR,kBAAU,MAAM,KAAK,KAAK,YAAY,OAAO,CAAC;AAAA,MAChD;AAAA,IACF,OAAO;AACL,iBAAW,QAAQ,KAAK,WAAW,OAAO,GAAG;AAC3C,gBAAQ,KAAK,GAAG,KAAK,YAAY,OAAO,CAAC;AAAA,MAC3C;AAAA,IACF;AAEA,QAAI,WAAW;AACf,QAAI,aAAa;AACjB,QAAI,cAAc;AAClB,UAAM,UAAkC,CAAC;AAEzC,eAAW,KAAK,SAAS;AACvB,kBAAY,EAAE,KAAK,KAAK;AACxB,oBAAc,EAAE,KAAK,KAAK,OAAO;AACjC,qBAAe,EAAE,KAAK,KAAK,OAAO;AAClC,cAAQ,KAAK;AAAA,QACX,QAAQ,EAAE;AAAA,QACV,MAAM,EAAE,KAAK;AAAA,QACb,YAAY,EAAE,KAAK;AAAA,MACrB,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,MACL;AAAA,MACA,aAAa,EAAE,OAAO,YAAY,QAAQ,YAAY;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAIA,MAAc,gBAAgB,YAAmC;AAC/D,UAAM,OAAO,KAAK,WAAW,IAAI,UAAU;AAC3C,QAAI,CAAC,QAAQ,KAAK,UAAU,UAAW;AAEvC,UAAM,aAAa,KAAK,UAAU,cAAc;AAEhD,eAAW,EAAE,KAAK,KAAK,YAAY;AACjC,WAAK,UAAU,YAAY,KAAK,EAAE;AAClC,UAAI;AACF,cAAM,KAAK,UAAU,MAAM,MAAM,UAAU;AAAA,MAC7C,SAAS,KAAK;AACZ,aAAK,UAAU,WAAW,KAAK,EAAE;AACjC,cAAM,KAAK,IAAI,KAAK;AAAA,UAClB,IAAI,IAAI;AAAA,UACR;AAAA,UACA,QAAQ;AAAA,UACR,WAAW,KAAK,IAAI;AAAA,UACpB;AAAA,UACA,QAAQ,KAAK;AAAA,UACb,SAAS;AAAA,YACP,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,UACxD;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AAGA,SAAK,UAAU,gBAAgB;AAG/B,QAAI,KAAK,UAAU,WAAW,GAAG;AAC/B,WAAK,QAAQ,KAAK,UAAU,aAAa,IAAI,cAAc;AAC3D,WAAK,cAAc,KAAK,IAAI;AAE5B,YAAM,YAAY,KAAK,UAAU;AAIjC,YAAM,KAAK,IAAI,KAAK;AAAA,QAClB,IAAI,IAAI;AAAA,QACR,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,WAAW,KAAK,IAAI;AAAA,QACpB;AAAA,QACA,SAAS;AAAA,UACP,UAAU,KAAK,cAAc,KAAK;AAAA,QACpC;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,MAAc,UACZ,MACA,MACA,YACe;AAEf,UAAM,eAA6B,CAAC;AACpC,eAAW,SAAS,KAAK,aAAa,CAAC,GAAG;AACxC,YAAM,YAAY,KAAK,YAAY,IAAI,KAAK;AAC5C,UAAI,UAAW,cAAa,KAAK,SAAS;AAAA,IAC5C;AAEA,UAAM,WAAqB;AAAA,MACzB,aAAa,KAAK;AAAA,MAClB,gBAAgB,KAAK;AAAA,MACrB,cAAc,aAAa,SAAS,IAAI,eAAe;AAAA,IACzD;AAEA,UAAM,YAA0B;AAAA,MAC9B,MAAM;AAAA,MACN,SAAS,KAAK;AAAA,MACd,UAAU,KAAK;AAAA,MACf,SAAS,KAAK;AAAA,MACd,SAAS,EAAE,YAAY,QAAQ,KAAK,IAAI,SAAS,EAAE;AAAA,IACrD;AAEA,UAAM,KAAK,IAAI,KAAK;AAAA,MAClB,IAAI,IAAI;AAAA,MACR;AAAA,MACA,QAAQ;AAAA,MACR,WAAW,KAAK,IAAI;AAAA,MACpB;AAAA,MACA,QAAQ,KAAK;AAAA,MACb,SAAS,EAAE,SAAS,KAAK,QAAQ;AAAA,IACnC,CAAC;AAED,UAAM,SAAS,MAAM,KAAK,QAAQ,MAAM,SAAS;AACjD,SAAK,eAAe,IAAI,KAAK,IAAI,MAAM;AAAA,EACzC;AAAA,EAEA,MAAc,mBAAmB,OAAkC;AAEjE,UAAM,KAAK,IAAI,KAAK,KAAK;AAEzB,QAAI,MAAM,uDAAuC,MAAM,QAAQ;AAC7D,YAAM,KAAK,oBAAoB,KAAK;AAAA,IACtC,WAAW,MAAM,iDAAoC,MAAM,QAAQ;AACjE,YAAM,KAAK,iBAAiB,KAAK;AAAA,IACnC;AAAA,EACF;AAAA,EAEA,MAAc,oBAAoB,OAAkC;AAClE,UAAM,aAAa,MAAM;AACzB,UAAM,SAAS,MAAM;AACrB,QAAI,CAAC,cAAc,CAAC,OAAQ;AAE5B,UAAM,OAAO,KAAK,WAAW,IAAI,UAAU;AAC3C,QAAI,CAAC,KAAM;AAEX,UAAM,aAAa,MAAM,QAAQ;AACjC,QAAI,YAAY;AACd,WAAK,YAAY,IAAI,QAAQ,UAAU;AAAA,IACzC;AAEA,SAAK,eAAe,OAAO,MAAM;AACjC,SAAK,UAAU,cAAc,MAAM;AAEnC,UAAM,KAAK,IAAI,KAAK;AAAA,MAClB,IAAI,IAAI;AAAA,MACR;AAAA,MACA,QAAQ;AAAA,MACR,WAAW,KAAK,IAAI;AAAA,MACpB;AAAA,MACA;AAAA,MACA,SAAS,EAAE,QAAQ,WAAW;AAAA,IAChC,CAAC;AAGD,UAAM,KAAK,gBAAgB,UAAU;AAAA,EACvC;AAAA,EAEA,MAAc,iBAAiB,OAAkC;AAC/D,UAAM,aAAa,MAAM;AACzB,UAAM,SAAS,MAAM;AACrB,QAAI,CAAC,cAAc,CAAC,OAAQ;AAE5B,UAAM,OAAO,KAAK,WAAW,IAAI,UAAU;AAC3C,QAAI,CAAC,KAAM;AAEX,SAAK,eAAe,OAAO,MAAM;AACjC,SAAK,UAAU,WAAW,MAAM;AAEhC,UAAM,KAAK,IAAI,KAAK;AAAA,MAClB,IAAI,IAAI;AAAA,MACR;AAAA,MACA,QAAQ;AAAA,MACR,WAAW,KAAK,IAAI;AAAA,MACpB;AAAA,MACA;AAAA,MACA,SAAS,EAAE,OAAO,MAAM,QAAQ,MAAM;AAAA,IACxC,CAAC;AAED,UAAM,KAAK,gBAAgB,UAAU;AAAA,EACvC;AACF;;;ACvVO,IAAM,cAAc;AAAA,EACzB,uBAAuB;AAAA,IACrB,MAAM;AAAA,IACN,aACE;AAAA,IACF,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,aAAa;AAAA,QACf;AAAA,QACA,OAAO;AAAA,UACL,MAAM;AAAA,UACN,aAAa;AAAA,UACb,OAAO;AAAA,YACL,MAAM;AAAA,YACN,YAAY;AAAA,cACV,IAAI;AAAA,gBACF,MAAM;AAAA,gBACN,aAAa;AAAA,cACf;AAAA,cACA,MAAM;AAAA,gBACJ,MAAM;AAAA,gBACN,aAAa;AAAA,cACf;AAAA,cACA,MAAM;AAAA,gBACJ,MAAM;AAAA,gBACN,aAAa;AAAA,cACf;AAAA,cACA,gBAAgB;AAAA,gBACd,MAAM;AAAA,gBACN,aAAa;AAAA,gBACb,YAAY;AAAA,kBACV,QAAQ;AAAA,oBACN,MAAM;AAAA,oBACN,MAAM,CAAC,WAAW,cAAc,QAAQ,UAAU,MAAM;AAAA,kBAC1D;AAAA,kBACA,QAAQ;AAAA,oBACN,MAAM;AAAA,oBACN,OAAO,EAAE,MAAM,SAAS;AAAA,oBACxB,aAAa;AAAA,kBACf;AAAA,kBACA,WAAW;AAAA,oBACT,MAAM;AAAA,oBACN,aAAa;AAAA,kBACf;AAAA,gBACF;AAAA,gBACA,UAAU,CAAC,QAAQ;AAAA,cACrB;AAAA,cACA,SAAS;AAAA,gBACP,MAAM;AAAA,gBACN,aACE;AAAA,cACJ;AAAA,cACA,UAAU;AAAA,gBACR,MAAM;AAAA,gBACN,aAAa;AAAA,gBACb,YAAY;AAAA,kBACV,QAAQ,EAAE,MAAM,SAAS;AAAA,kBACzB,YAAY;AAAA,oBACV,MAAM;AAAA,oBACN,OAAO,EAAE,MAAM,SAAS;AAAA,kBAC1B;AAAA,kBACA,QAAQ,EAAE,MAAM,SAAS;AAAA,gBAC3B;AAAA,gBACA,UAAU,CAAC,UAAU,cAAc,QAAQ;AAAA,cAC7C;AAAA,cACA,WAAW;AAAA,gBACT,MAAM;AAAA,gBACN,OAAO,EAAE,MAAM,SAAS;AAAA,gBACxB,aAAa;AAAA,cACf;AAAA,cACA,SAAS;AAAA,gBACP,MAAM;AAAA,gBACN,aAAa;AAAA,cACf;AAAA,YACF;AAAA,YACA,UAAU;AAAA,cACR;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,MACA,UAAU,CAAC,QAAQ,OAAO;AAAA,IAC5B;AAAA,EACF;AAAA,EAEA,uBAAuB;AAAA,IACrB,MAAM;AAAA,IACN,aACE;AAAA,IACF,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,YAAY;AAAA,UACV,MAAM;AAAA,UACN,aAAa;AAAA,QACf;AAAA,MACF;AAAA,MACA,UAAU,CAAC,YAAY;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,uBAAuB;AAAA,IACrB,MAAM;AAAA,IACN,aACE;AAAA,IACF,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,YAAY;AAAA,UACV,MAAM;AAAA,UACN,aAAa;AAAA,QACf;AAAA,MACF;AAAA,MACA,UAAU,CAAC,YAAY;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,oBAAoB;AAAA,IAClB,MAAM;AAAA,IACN,aACE;AAAA,IACF,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,YAAY;AAAA,UACV,MAAM;AAAA,UACN,aAAa;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":["EventType"]}

package/dist/index.d.cts

@@ -1,36 +1,65 @@
 declare enum EventType {
     OrchestrationStarted = "orchestration.started",
+    OrchestrationCompleted = "orchestration.completed",
+    WorkflowStarted = "workflow.started",
+    WorkflowCompleted = "workflow.completed",
+    WorkflowFailed = "workflow.failed",
+    WorkflowStepStarted = "workflow.step.started",
+    WorkflowStepCompleted = "workflow.step.completed",
+    WorkflowStepFailed = "workflow.step.failed",
     TaskCreated = "task.created",
     TaskDependency = "task.dependency",
+    TaskCompleted = "task.completed",
     SessionSpawned = "session.spawned",
+    SessionMessage = "session.message",
     SessionEvent = "session.event",
     SessionSteered = "session.steered",
     SessionArtifact = "session.artifact",
     SessionCompleted = "session.completed",
-    TaskCompleted = "task.completed",
-    OrchestrationCompleted = "orchestration.completed",
+    SessionFailed = "session.failed",
+    SessionKilled = "session.killed",
+    CostIncurred = "cost.incurred",
     SubscriptionTriggered = "subscription.triggered"
 }
+interface CostRecord {
+    tokens: {
+        input: number;
+        output: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+    };
+    usd: number;
+    runtime?: string;
+}
 interface YesodEvent {
     id: string;
     type: EventType;
-    timestamp: string;
+    source: string;
+    timestamp: number;
     sessionId?: string;
     orchestrationId?: string;
     taskId?: string;
+    workflowId?: string;
+    stepId?: string;
     payload: Record<string, unknown>;
+    metadata?: {
+        cost?: CostRecord;
+        duration?: number;
+    };
 }
 
 type EventHandler = (event: YesodEvent) => void | Promise<void>;
 interface EventFilter {
-    type?: EventType;
+    type?: EventType | EventType[];
     sessionId?: string;
     orchestrationId?: string;
+    workflowId?: string;
 }
 declare class EventBus {
     private handlers;
     private nextId;
     subscribe(filter: EventFilter, handler: EventHandler): string;
+    subscribeAll(handler: EventHandler): string;
     unsubscribe(id: string): void;
     emit(event: YesodEvent): Promise<void>;
     private matches;
@@ -46,6 +75,9 @@ interface Subscription {
     orchestratorSession: string;
     conditions: SubscriptionCondition[];
     mode: "any" | "all";
+    once?: boolean;
+    ttl?: number;
+    registeredAt?: number;
 }
 interface NotificationEvent {
     type: "subscription.triggered";
@@ -54,12 +86,16 @@ interface NotificationEvent {
 }
 declare class VantageEngine {
     private subscriptions;
+    private barrierState;
     register(subscription: Subscription): void;
     remove(subscriptionId: string): void;
-    /** Evaluate an incoming event against all subscriptions. Returns notifications for any triggered subscriptions. */
-    evaluate(_event: YesodEvent): NotificationEvent[];
+    evaluate(event: YesodEvent): NotificationEvent[];
     getSubscription(id: string): Subscription | undefined;
     listSubscriptions(): Subscription[];
+    activeCount(): number;
+    private matchAny;
+    private matchBarrier;
+    private matchCondition;
 }
 
 interface StorageQuery {
@@ -84,6 +120,120 @@ declare class InMemoryStorageAdapter implements StorageAdapter {
     delete(key: string): Promise<boolean>;
 }
 
+interface SessionHandle {
+    id: string;
+    adapter: string;
+    metadata: Record<string, unknown>;
+}
+type SessionStatus = "running" | "completed" | "failed" | "timeout" | "killed" | "unknown";
+interface RuntimeDecision {
+    reason: string;
+    considered: string[];
+    chosen: string;
+}
+interface TaskSpec {
+    instruction: string;
+    expectedResult: ResultSpec;
+    priorContext?: StepResult[];
+}
+interface ResultSpec {
+    format: "summary" | "structured" | "diff" | "review" | "test";
+    fields?: string[];
+    maxLength?: number;
+}
+interface StepResult {
+    stepId: string;
+    status: "completed" | "failed" | "timeout";
+    output: StructuredOutput;
+    meta: {
+        runtime: string;
+        decision: RuntimeDecision;
+        cost: CostRecord;
+        durationMs: number;
+        retries: number;
+    };
+}
+type StructuredOutput = SummaryOutput | DiffOutput | ReviewOutput | TestOutput | StructuredFieldsOutput | RawFallbackOutput;
+interface SummaryOutput {
+    format: "summary";
+    summary: string;
+}
+interface DiffOutput {
+    format: "diff";
+    summary: string;
+    filesChanged: Array<{
+        path: string;
+        linesAdded: number;
+        linesRemoved: number;
+    }>;
+}
+interface ReviewOutput {
+    format: "review";
+    summary: string;
+    findings: Array<{
+        severity: "critical" | "high" | "medium" | "low" | "info";
+        location: string;
+        issue: string;
+    }>;
+    filesReviewed: string[];
+}
+interface TestOutput {
+    format: "test";
+    summary: string;
+    passed: number;
+    failed: number;
+    skipped: number;
+    failures: Array<{
+        test: string;
+        error: string;
+    }>;
+}
+interface StructuredFieldsOutput {
+    format: "structured";
+    fields: Record<string, unknown>;
+}
+interface RawFallbackOutput {
+    format: "raw";
+    raw: string;
+    parseError?: string;
+}
+interface SpawnOptions {
+    task: TaskSpec;
+    runtime: string;
+    decision: RuntimeDecision;
+    mode?: "run" | "session";
+    cwd?: string;
+    timeout?: number;
+    labels?: Record<string, string>;
+    context?: {
+        workflowId: string;
+        stepId: string;
+        attempt: number;
+    };
+    adapterConfig?: Record<string, unknown>;
+}
+interface CodingSpawnOptions extends SpawnOptions {
+    repo?: string;
+    branch?: string;
+    files?: string[];
+}
+interface RetryPolicy {
+    maxAttempts: number;
+    backoffMs?: number;
+    backoffMultiplier?: number;
+    retryOn?: string[];
+}
+interface RuntimeAdapter {
+    readonly name: string;
+    readonly description?: string;
+    spawn(opts: SpawnOptions): Promise<SessionHandle>;
+    send(session: SessionHandle, message: string): Promise<void>;
+    kill(session: SessionHandle): Promise<void>;
+    status(session: SessionHandle): Promise<SessionStatus | null>;
+    onEvent(handler: (event: YesodEvent) => void): void;
+    dispose(): Promise<void>;
+}
+
 type SessionState = "pending" | "running" | "yielded" | "completed" | "failed" | "cancelled";
 interface SessionControl {
     maxTurns?: number;
@@ -99,8 +249,10 @@ interface CodingSession {
     parentSessionId?: string;
     state: SessionState;
     controls: SessionControl;
-    startedAt?: string;
-    completedAt?: string;
+    runtimeDecision?: RuntimeDecision;
+    stepResult?: StepResult;
+    startedAt?: number;
+    completedAt?: number;
     result?: Record<string, unknown>;
 }
 
@@ -108,19 +260,44 @@ type WorkflowState = "created" | "running" | "paused" | "completed" | "failed";
 interface WorkflowStep {
     id: string;
     name: string;
+    task: string;
+    expectedResult: ResultSpec;
+    runtime: string;
+    decision: RuntimeDecision;
+    dependsOn?: string[];
+    condition?: string;
+    retry?: RetryPolicy;
+    timeout?: number;
+    config?: Record<string, unknown>;
+    outputMapping?: Record<string, string>;
+}
+interface WorkflowInput {
+    name: string;
+    type: "string" | "number" | "boolean";
+    required?: boolean;
+    default?: unknown;
     description?: string;
-    dependsOn: string[];
-    taskId?: string;
-    state: WorkflowState;
+}
+interface WorkflowTrigger {
+    type: "event" | "schedule" | "manual";
+    config: Record<string, unknown>;
 }
 interface Workflow {
     id: string;
-    orchestrationId: string;
     name: string;
+    description?: string;
+    version?: string;
+    inputs?: WorkflowInput[];
     steps: WorkflowStep[];
+    triggers?: WorkflowTrigger[];
+    defaults?: {
+        runtime?: string;
+        timeout?: number;
+        retry?: RetryPolicy;
+    };
     state: WorkflowState;
-    createdAt: string;
-    completedAt?: string;
+    createdAt: number;
+    completedAt?: number;
 }
 
 interface ReadyStep {
@@ -128,19 +305,215 @@ interface ReadyStep {
     reason: string;
 }
 interface Scheduler {
-    /** Reports which steps have all dependencies satisfied and are ready to execute. The agent decides what to actually run. */
-    getReadySteps(workflowId: string): ReadyStep[];
+    getReadySteps(): ReadyStep[];
+}
+type StepState = "pending" | "running" | "completed" | "failed";
+declare class SimpleScheduler implements Scheduler {
+    private stepStates;
+    private stepMap;
+    constructor(steps: WorkflowStep[]);
+    getReadySteps(): ReadyStep[];
+    markRunning(stepId: string): void;
+    markCompleted(stepId: string): void;
+    markFailed(stepId: string): void;
+    getState(stepId: string): StepState | undefined;
+    isComplete(): boolean;
+    allSucceeded(): boolean;
+    /**
+     * Mark any pending step whose dependencies include a failed step as failed.
+     * Returns IDs of newly failed steps.
+     */
+    markUnreachable(): string[];
 }
 
-interface RuntimeRecommendation {
-    runtimeId: string;
-    name: string;
-    score: number;
-    reason: string;
+type EngineWorkflowState = "created" | "running" | "completed" | "failed";
+interface WorkflowExecution {
+    workflow: Workflow;
+    state: EngineWorkflowState;
+    scheduler: SimpleScheduler;
+    stepResults: Map<string, StepResult>;
+    activeSessions: Map<string, SessionHandle>;
+    startedAt: number;
+    completedAt?: number;
+}
+interface WorkflowStatus {
+    workflowId: string;
+    state: EngineWorkflowState;
+    steps: Array<{
+        stepId: string;
+        state: string;
+        result?: StepResult;
+    }>;
+    startedAt: number;
+    completedAt?: number;
 }
-interface Router {
-    /** Recommends available runtimes for a given task. The agent decides which to use. */
-    recommend(taskType: string): RuntimeRecommendation[];
+interface CostSummary {
+    totalUsd: number;
+    totalTokens: {
+        input: number;
+        output: number;
+    };
+    perStep: Array<{
+        stepId: string;
+        cost: CostRecord;
+        durationMs: number;
+    }>;
 }
+declare class OrchestrationEngine {
+    private adapter;
+    private bus;
+    private storage;
+    private executions;
+    constructor(adapter: RuntimeAdapter, bus: EventBus, storage: StorageAdapter);
+    createWorkflow(def: Workflow): Workflow;
+    startWorkflow(workflowId: string): Promise<void>;
+    cancelWorkflow(workflowId: string): Promise<void>;
+    getWorkflowStatus(workflowId: string): WorkflowStatus;
+    getCostSummary(workflowId?: string): CostSummary;
+    private advanceWorkflow;
+    private spawnStep;
+    private handleAdapterEvent;
+    private handleStepCompleted;
+    private handleStepFailed;
+}
+
+/**
+ * MCP tool JSON Schema definitions for Yesod agent-facing tools.
+ */
+declare const YESOD_TOOLS: {
+    readonly yesod_create_workflow: {
+        readonly name: "yesod_create_workflow";
+        readonly description: "Create and start a multi-step workflow. Define the steps, their dependencies, and expected output formats. Yesod will orchestrate execution, spawn child agents, and chain results automatically.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly name: {
+                    readonly type: "string";
+                    readonly description: "Human-readable name for the workflow";
+                };
+                readonly steps: {
+                    readonly type: "array";
+                    readonly description: "Workflow steps to execute";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "string";
+                                readonly description: "Unique step identifier";
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                                readonly description: "Human-readable step name";
+                            };
+                            readonly task: {
+                                readonly type: "string";
+                                readonly description: "Instruction for the agent performing this step";
+                            };
+                            readonly expectedResult: {
+                                readonly type: "object";
+                                readonly description: "Expected output format";
+                                readonly properties: {
+                                    readonly format: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["summary", "structured", "diff", "review", "test"];
+                                    };
+                                    readonly fields: {
+                                        readonly type: "array";
+                                        readonly items: {
+                                            readonly type: "string";
+                                        };
+                                        readonly description: "Fields to include (for structured format)";
+                                    };
+                                    readonly maxLength: {
+                                        readonly type: "number";
+                                        readonly description: "Max output length in characters";
+                                    };
+                                };
+                                readonly required: readonly ["format"];
+                            };
+                            readonly runtime: {
+                                readonly type: "string";
+                                readonly description: "Runtime to use (e.g. claude-code, codex)";
+                            };
+                            readonly decision: {
+                                readonly type: "object";
+                                readonly description: "Why this runtime was chosen";
+                                readonly properties: {
+                                    readonly reason: {
+                                        readonly type: "string";
+                                    };
+                                    readonly considered: {
+                                        readonly type: "array";
+                                        readonly items: {
+                                            readonly type: "string";
+                                        };
+                                    };
+                                    readonly chosen: {
+                                        readonly type: "string";
+                                    };
+                                };
+                                readonly required: readonly ["reason", "considered", "chosen"];
+                            };
+                            readonly dependsOn: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly description: "Step IDs this step depends on";
+                            };
+                            readonly timeout: {
+                                readonly type: "number";
+                                readonly description: "Timeout in milliseconds";
+                            };
+                        };
+                        readonly required: readonly ["id", "name", "task", "expectedResult", "runtime", "decision"];
+                    };
+                };
+            };
+            readonly required: readonly ["name", "steps"];
+        };
+    };
+    readonly yesod_workflow_status: {
+        readonly name: "yesod_workflow_status";
+        readonly description: "Check the current status of a running workflow, including per-step progress and results.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly workflowId: {
+                    readonly type: "string";
+                    readonly description: "ID of the workflow to check";
+                };
+            };
+            readonly required: readonly ["workflowId"];
+        };
+    };
+    readonly yesod_cancel_workflow: {
+        readonly name: "yesod_cancel_workflow";
+        readonly description: "Cancel a running workflow. Kills all active sessions and marks the workflow as failed.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly workflowId: {
+                    readonly type: "string";
+                    readonly description: "ID of the workflow to cancel";
+                };
+            };
+            readonly required: readonly ["workflowId"];
+        };
+    };
+    readonly yesod_cost_summary: {
+        readonly name: "yesod_cost_summary";
+        readonly description: "Get a cost breakdown showing token usage and USD cost, optionally filtered to a specific workflow.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly workflowId: {
+                    readonly type: "string";
+                    readonly description: "Optional: filter to a specific workflow";
+                };
+            };
+        };
+    };
+};
 
-export { type CodingSession, EventBus, type EventFilter, type EventHandler, EventType, InMemoryStorageAdapter, type NotificationEvent, type ReadyStep, type Router, type RuntimeRecommendation, type Scheduler, type SessionControl, type SessionState, type StorageAdapter, type StorageQuery, type Subscription, type SubscriptionCondition, VantageEngine, type Workflow, type WorkflowState, type WorkflowStep, type YesodEvent };
+export { type CodingSession, type CodingSpawnOptions, type CostRecord, type CostSummary, type DiffOutput, type EngineWorkflowState, EventBus, type EventFilter, type EventHandler, EventType, InMemoryStorageAdapter, type NotificationEvent, OrchestrationEngine, type RawFallbackOutput, type ReadyStep, type ResultSpec, type RetryPolicy, type ReviewOutput, type RuntimeAdapter, type RuntimeDecision, type Scheduler, type SessionControl, type SessionHandle, type SessionState, type SessionStatus, SimpleScheduler, type SpawnOptions, type StepResult, type StepState, type StorageAdapter, type StorageQuery, type StructuredFieldsOutput, type StructuredOutput, type Subscription, type SubscriptionCondition, type SummaryOutput, type TaskSpec, type TestOutput, VantageEngine, type Workflow, type WorkflowExecution, type WorkflowInput, type WorkflowState, type WorkflowStatus, type WorkflowStep, type WorkflowTrigger, YESOD_TOOLS, type YesodEvent };