@directive-run/ai 0.3.0 → 0.4.0

package/dist/{types-Co4BzMiH.d.cts → types-D5veI9su.d.cts}

@@ -29,6 +29,11 @@ interface MultiAgentCheckpointLocalState {
     pendingHandoffs: unknown[];
     handoffResults: unknown[];
     roundRobinCounters: Record<string, number> | null;
+    /** Serialized task states (task run functions are closures, not serializable) */
+    taskStates?: Record<string, {
+        lastOutput?: string;
+        lastError?: string;
+    }>;
 }
 /** Union of local state types */
 type CheckpointLocalState = SingleAgentCheckpointLocalState | MultiAgentCheckpointLocalState;
@@ -521,12 +526,14 @@ interface MultiAgentLifecycleHooks {
         patternId: string;
         nodeId: string;
         agentId: string;
+        nodeType: "agent" | "task";
         timestamp: number;
     }) => void;
     onDagNodeComplete?: (event: {
         patternId: string;
         nodeId: string;
         agentId: string;
+        nodeType: "agent" | "task";
         durationMs: number;
         timestamp: number;
     }) => void;
@@ -534,6 +541,7 @@ interface MultiAgentLifecycleHooks {
         patternId: string;
         nodeId: string;
         agentId: string;
+        nodeType: "agent" | "task";
         error: Error;
         durationMs: number;
         timestamp: number;
@@ -542,6 +550,7 @@ interface MultiAgentLifecycleHooks {
         patternId: string;
         nodeId: string;
         agentId: string;
+        nodeType: "agent" | "task";
         reason: string;
         timestamp: number;
     }) => void;
@@ -571,6 +580,39 @@ interface MultiAgentLifecycleHooks {
         keys: string[];
         timestamp: number;
     }) => void;
+    /** Called when a task starts executing */
+    onTaskStart?: (event: {
+        patternId: string;
+        taskId: string;
+        label: string;
+        timestamp: number;
+    }) => void;
+    /** Called when a task completes successfully */
+    onTaskComplete?: (event: {
+        patternId: string;
+        taskId: string;
+        label: string;
+        durationMs: number;
+        timestamp: number;
+    }) => void;
+    /** Called when a task fails */
+    onTaskError?: (event: {
+        patternId: string;
+        taskId: string;
+        label: string;
+        error: Error;
+        durationMs: number;
+        timestamp: number;
+    }) => void;
+    /** Called when a task reports progress */
+    onTaskProgress?: (event: {
+        patternId: string;
+        taskId: string;
+        label: string;
+        percent: number;
+        message?: string;
+        timestamp: number;
+    }) => void;
     /** Called when a pattern checkpoint is saved */
     onCheckpointSave?: (event: {
         checkpointId: string;
@@ -641,8 +683,8 @@ interface DagExecutionContext {
 }
 /** A node in a DAG execution pattern */
 interface DagNode {
-    /** Registered agent ID to run for this node */
-    agent: string;
+    /** Registered handler ID (agent or task) to run for this node */
+    handler: string;
     /** Upstream node IDs this node depends on */
     deps?: string[];
     /** Conditional edge — evaluated when deps are met. @default unconditional */
@@ -672,11 +714,10 @@ interface DagPattern<T = unknown> {
 }
 /** Debug configuration for orchestrators */
 interface OrchestratorDebugConfig {
-    /** Include truncated input/output in timeline events for prompt/completion viewing */
     verboseTimeline?: boolean;
 }
 /** All debug event types */
-type DebugEventType = "agent_start" | "agent_complete" | "agent_error" | "agent_retry" | "guardrail_check" | "constraint_evaluate" | "resolver_start" | "resolver_complete" | "resolver_error" | "approval_request" | "approval_response" | "handoff_start" | "handoff_complete" | "pattern_start" | "pattern_complete" | "dag_node_update" | "breakpoint_hit" | "breakpoint_resumed" | "derivation_update" | "scratchpad_update" | "reflection_iteration" | "race_start" | "race_winner" | "race_cancelled" | "debate_round" | "reroute" | "checkpoint_save" | "checkpoint_restore";
+type DebugEventType = "agent_start" | "agent_complete" | "agent_error" | "agent_retry" | "guardrail_check" | "constraint_evaluate" | "resolver_start" | "resolver_complete" | "resolver_error" | "approval_request" | "approval_response" | "handoff_start" | "handoff_complete" | "pattern_start" | "pattern_complete" | "dag_node_update" | "breakpoint_hit" | "breakpoint_resumed" | "derivation_update" | "scratchpad_update" | "reflection_iteration" | "race_start" | "race_winner" | "race_cancelled" | "debate_round" | "reroute" | "checkpoint_save" | "checkpoint_restore" | "task_start" | "task_complete" | "task_error" | "task_progress" | "goal_step";
 /** Base debug event */
 interface DebugEventBase {
     id: number;
@@ -690,7 +731,7 @@ interface AgentStartEvent extends DebugEventBase {
     type: "agent_start";
     agentId: string;
     inputLength: number;
-    /** Truncated input text (only when verboseTimeline is enabled) */
+    /** Truncated input text (max 5000 chars) */
     input?: string;
 }
 /** Agent complete event */
@@ -703,7 +744,7 @@ interface AgentCompleteEvent extends DebugEventBase {
     outputTokens: number;
     durationMs: number;
     modelId?: string;
-    /** Truncated output text (only when verboseTimeline is enabled) */
+    /** Truncated output text (max 5000 chars) */
     output?: string;
 }
 /** Agent error event */
@@ -786,6 +827,10 @@ interface PatternStartEvent extends DebugEventBase {
     type: "pattern_start";
     patternId: string;
     patternType: "parallel" | "sequential" | "supervisor" | "dag" | "reflect" | "race" | "debate" | "goal";
+    /** All handler IDs in this pattern (agents + tasks) */
+    handlers?: string[];
+    /** Which handler IDs are tasks (rest are agents) */
+    taskIds?: string[];
 }
 /** Pattern complete event */
 interface PatternCompleteEvent extends DebugEventBase {
@@ -889,8 +934,49 @@ interface CheckpointRestoreEvent extends DebugEventBase {
     patternType: string;
     step: number;
 }
+/** Task start event */
+interface TaskStartEvent extends DebugEventBase {
+    type: "task_start";
+    taskId: string;
+    label: string;
+    description?: string;
+    inputLength: number;
+}
+/** Task complete event */
+interface TaskCompleteEvent extends DebugEventBase {
+    type: "task_complete";
+    taskId: string;
+    label: string;
+    durationMs: number;
+}
+/** Task error event */
+interface TaskErrorEvent extends DebugEventBase {
+    type: "task_error";
+    taskId: string;
+    label: string;
+    error: string;
+    durationMs: number;
+    attempt?: number;
+}
+/** Task progress event */
+interface TaskProgressEvent extends DebugEventBase {
+    type: "task_progress";
+    taskId: string;
+    label: string;
+    percent: number;
+    message?: string;
+}
+/** Goal step event — emitted for each agent invocation within a goal step */
+interface GoalStepEvent extends DebugEventBase {
+    type: "goal_step";
+    agentId: string;
+    step: number;
+    nodeId: string;
+    satisfaction: number;
+    satisfactionDelta: number;
+}
 /** Union of all debug event types */
-type DebugEvent = AgentStartEvent | AgentCompleteEvent | AgentErrorEvent | AgentRetryEvent | GuardrailCheckEvent | ConstraintEvaluateEvent | ResolverStartEvent | ResolverCompleteEvent | ResolverErrorEvent | ApprovalRequestEvent | ApprovalResponseEvent | HandoffStartEvent | HandoffCompleteEvent | PatternStartEvent | PatternCompleteEvent | DagNodeUpdateEvent | BreakpointHitEvent | BreakpointResumedEvent | DerivationUpdateEvent | ScratchpadUpdateEvent | ReflectionIterationEvent | RaceStartEvent | RaceWinnerEvent | RaceCancelledEvent | DebateRoundEvent | RerouteDebugEvent | CheckpointSaveEvent | CheckpointRestoreEvent;
+type DebugEvent = AgentStartEvent | AgentCompleteEvent | AgentErrorEvent | AgentRetryEvent | GuardrailCheckEvent | ConstraintEvaluateEvent | ResolverStartEvent | ResolverCompleteEvent | ResolverErrorEvent | ApprovalRequestEvent | ApprovalResponseEvent | HandoffStartEvent | HandoffCompleteEvent | PatternStartEvent | PatternCompleteEvent | DagNodeUpdateEvent | BreakpointHitEvent | BreakpointResumedEvent | DerivationUpdateEvent | ScratchpadUpdateEvent | ReflectionIterationEvent | RaceStartEvent | RaceWinnerEvent | RaceCancelledEvent | DebateRoundEvent | RerouteDebugEvent | CheckpointSaveEvent | CheckpointRestoreEvent | TaskStartEvent | TaskCompleteEvent | TaskErrorEvent | TaskProgressEvent | GoalStepEvent;
 /** Health state for an agent stored in facts */
 interface AgentHealthState {
     circuitState: "CLOSED" | "OPEN" | "HALF_OPEN";
@@ -1013,8 +1099,8 @@ interface Scratchpad<T extends Record<string, unknown> = Record<string, unknown>
 }
 /** A node in a goal execution pattern */
 interface GoalNode {
-    /** Agent ID (registered on the orchestrator) */
-    agent: string;
+    /** Handler ID — agent or task registered on the orchestrator */
+    handler: string;
     /** Fact keys this node can produce */
     produces: string[];
     /** Fact keys this node needs (must be satisfied before running) */
@@ -1175,9 +1261,6 @@ interface CheckpointContext {
     /** Satisfaction score 0-1 (goal only) */
     satisfaction?: number;
 }
-/**
- * @deprecated Use `PatternCheckpointConfig` instead. Alias kept for backward compatibility.
- */
 type GoalCheckpointConfig = PatternCheckpointConfig;
 /** Common fields present on all pattern checkpoint states */
 interface PatternCheckpointBase {
@@ -1370,4 +1453,4 @@ interface CheckpointDiff {
     nodesCompleted?: string[];
 }
 
-export { type DebateRoundEvent as $, type AgentLike as A, type BreakpointState as B, type Checkpoint as C, type DebugEvent as D, type CheckpointDiff as E, type CheckpointLocalState as F, type GuardrailFn as G, type CheckpointProgress as H, type InputGuardrailData as I, type CheckpointRestoreEvent as J, type CheckpointSaveEvent as K, type CheckpointStore as L, type Message as M, type ConstraintEvaluateEvent as N, type OutputGuardrailData as O, type CrossAgentDerivationFn as P, type CrossAgentSnapshot as Q, type RunOptions as R, type SchemaValidator as S, type ToolCallGuardrailData as T, type DagCheckpointState as U, type DagExecutionContext as V, type DagNode as W, type DagNodeStatus as X, type DagNodeUpdateEvent as Y, type DagPattern as Z, type DebateCheckpointState as _, type AdapterHooks as a, createBreakpointId as a$, type DebugEventBase as a0, type DebugEventType as a1, type DerivationUpdateEvent as a2, type GoalCheckpointConfig as a3, type GoalCheckpointState as a4, type GoalMetrics as a5, type GoalNode as a6, type GoalPattern as a7, type GoalStepMetrics as a8, type GuardrailCheckEvent as a9, type PatternCompleteEvent as aA, type PatternStartEvent as aB, type RaceCancelledEvent as aC, type RaceStartEvent as aD, type RaceWinnerEvent as aE, type ReflectCheckpointState as aF, type ReflectionIterationEvent as aG, type RejectedRequest as aH, type RelaxationContext as aI, type RelaxationRecord as aJ, type RelaxationStrategy as aK, type RelaxationTier as aL, type RerouteDebugEvent as aM, type RerouteEvent as aN, type ResolverCompleteEvent as aO, type ResolverErrorEvent as aP, type ResolverStartEvent as aQ, type SchemaValidationResult as aR, type Scratchpad as aS, type ScratchpadUpdateEvent as aT, type SelfHealingConfig as aU, type SequentialCheckpointState as aV, type SingleAgentCheckpointLocalState as aW, type StreamingCallbackRunner as aX, type SupervisorCheckpointState as aY, type TokenUsage as aZ, type ToolCall as a_, type GuardrailContext as aa, GuardrailError as ab, type GuardrailErrorCode as ac, type GuardrailResult as ad, type GuardrailRetryConfig as ae, type GuardrailsConfig as af, type HandoffCompleteEvent as ag, type HandoffStartEvent as ah, type HealthMonitorConfig as ai, InMemoryCheckpointStore as aj, type InMemoryCheckpointStoreOptions as ak, MAX_BREAKPOINT_HISTORY as al, type MultiAgentBreakpointType as am, type MultiAgentCheckpointLocalState as an, type MultiAgentLifecycleHooks as ao, type MultiAgentSelfHealingConfig as ap, type NamedGuardrail as aq, type OrchestratorConstraint as ar, type OrchestratorDebugConfig as as, type OrchestratorLifecycleHooks as at, type OrchestratorResolver as au, type OrchestratorResolverContext as av, type OrchestratorState as aw, type PatternCheckpointBase as ax, type PatternCheckpointConfig as ay, type PatternCheckpointState as az, type AgentRunner as b, createCheckpointId as b0, createInitialBreakpointState as b1, isGuardrailError as b2, matchBreakpoint as b3, validateCheckpoint as b4, type ApprovalState as c, type AgentState as d, type RunResult as e, type GoalResult as f, type AgentCircuitBreakerConfig as g, type AgentCompleteEvent as h, type AgentErrorEvent as i, type AgentHealthState as j, type AgentRetryConfig as k, type AgentRetryEvent as l, type AgentSelectionStrategy as m, type AgentStartEvent as n, type ApprovalRequest as o, type ApprovalRequestEvent as p, type ApprovalResponseEvent as q, type BreakpointConfig as r, type BreakpointContext as s, type BreakpointHitEvent as t, type BreakpointModifications as u, type BreakpointRequest as v, type BreakpointResumedEvent as w, type BreakpointState$1 as x, type BreakpointType as y, type CheckpointContext as z };
+export { type DebateRoundEvent as $, type AgentLike as A, type BreakpointState as B, type Checkpoint as C, type DebugEvent as D, type CheckpointDiff as E, type CheckpointLocalState as F, type GuardrailFn as G, type CheckpointProgress as H, type InputGuardrailData as I, type CheckpointRestoreEvent as J, type CheckpointSaveEvent as K, type CheckpointStore as L, type Message as M, type ConstraintEvaluateEvent as N, type OutputGuardrailData as O, type CrossAgentDerivationFn as P, type CrossAgentSnapshot as Q, type RunOptions as R, type SchemaValidator as S, type ToolCallGuardrailData as T, type DagCheckpointState as U, type DagExecutionContext as V, type DagNode as W, type DagNodeStatus as X, type DagNodeUpdateEvent as Y, type DagPattern as Z, type DebateCheckpointState as _, type AdapterHooks as a, type TaskProgressEvent as a$, type DebugEventBase as a0, type DebugEventType as a1, type DerivationUpdateEvent as a2, type GoalCheckpointConfig as a3, type GoalCheckpointState as a4, type GoalMetrics as a5, type GoalNode as a6, type GoalPattern as a7, type GoalStepMetrics as a8, type GuardrailCheckEvent as a9, type PatternCompleteEvent as aA, type PatternStartEvent as aB, type RaceCancelledEvent as aC, type RaceStartEvent as aD, type RaceWinnerEvent as aE, type ReflectCheckpointState as aF, type ReflectionIterationEvent as aG, type RejectedRequest as aH, type RelaxationContext as aI, type RelaxationRecord as aJ, type RelaxationStrategy as aK, type RelaxationTier as aL, type RerouteDebugEvent as aM, type RerouteEvent as aN, type ResolverCompleteEvent as aO, type ResolverErrorEvent as aP, type ResolverStartEvent as aQ, type SchemaValidationResult as aR, type Scratchpad as aS, type ScratchpadUpdateEvent as aT, type SelfHealingConfig as aU, type SequentialCheckpointState as aV, type SingleAgentCheckpointLocalState as aW, type StreamingCallbackRunner as aX, type SupervisorCheckpointState as aY, type TaskCompleteEvent as aZ, type TaskErrorEvent as a_, type GuardrailContext as aa, GuardrailError as ab, type GuardrailErrorCode as ac, type GuardrailResult as ad, type GuardrailRetryConfig as ae, type GuardrailsConfig as af, type HandoffCompleteEvent as ag, type HandoffStartEvent as ah, type HealthMonitorConfig as ai, InMemoryCheckpointStore as aj, type InMemoryCheckpointStoreOptions as ak, MAX_BREAKPOINT_HISTORY as al, type MultiAgentBreakpointType as am, type MultiAgentCheckpointLocalState as an, type MultiAgentLifecycleHooks as ao, type MultiAgentSelfHealingConfig as ap, type NamedGuardrail as aq, type OrchestratorConstraint as ar, type OrchestratorDebugConfig as as, type OrchestratorLifecycleHooks as at, type OrchestratorResolver as au, type OrchestratorResolverContext as av, type OrchestratorState as aw, type PatternCheckpointBase as ax, type PatternCheckpointConfig as ay, type PatternCheckpointState as az, type AgentRunner as b, type TaskStartEvent as b0, type TokenUsage as b1, type ToolCall as b2, createBreakpointId as b3, createCheckpointId as b4, createInitialBreakpointState as b5, isGuardrailError as b6, matchBreakpoint as b7, validateCheckpoint as b8, type ApprovalState as c, type AgentState as d, type RunResult as e, type GoalResult as f, type AgentCircuitBreakerConfig as g, type AgentCompleteEvent as h, type AgentErrorEvent as i, type AgentHealthState as j, type AgentRetryConfig as k, type AgentRetryEvent as l, type AgentSelectionStrategy as m, type AgentStartEvent as n, type ApprovalRequest as o, type ApprovalRequestEvent as p, type ApprovalResponseEvent as q, type BreakpointConfig as r, type BreakpointContext as s, type BreakpointHitEvent as t, type BreakpointModifications as u, type BreakpointRequest as v, type BreakpointResumedEvent as w, type BreakpointState$1 as x, type BreakpointType as y, type CheckpointContext as z };

package/dist/{types-Co4BzMiH.d.ts → types-D5veI9su.d.ts}

@@ -29,6 +29,11 @@ interface MultiAgentCheckpointLocalState {
     pendingHandoffs: unknown[];
     handoffResults: unknown[];
     roundRobinCounters: Record<string, number> | null;
+    /** Serialized task states (task run functions are closures, not serializable) */
+    taskStates?: Record<string, {
+        lastOutput?: string;
+        lastError?: string;
+    }>;
 }
 /** Union of local state types */
 type CheckpointLocalState = SingleAgentCheckpointLocalState | MultiAgentCheckpointLocalState;
@@ -521,12 +526,14 @@ interface MultiAgentLifecycleHooks {
         patternId: string;
         nodeId: string;
         agentId: string;
+        nodeType: "agent" | "task";
         timestamp: number;
     }) => void;
     onDagNodeComplete?: (event: {
         patternId: string;
         nodeId: string;
         agentId: string;
+        nodeType: "agent" | "task";
         durationMs: number;
         timestamp: number;
     }) => void;
@@ -534,6 +541,7 @@ interface MultiAgentLifecycleHooks {
         patternId: string;
         nodeId: string;
         agentId: string;
+        nodeType: "agent" | "task";
         error: Error;
         durationMs: number;
         timestamp: number;
@@ -542,6 +550,7 @@ interface MultiAgentLifecycleHooks {
         patternId: string;
         nodeId: string;
         agentId: string;
+        nodeType: "agent" | "task";
         reason: string;
         timestamp: number;
     }) => void;
@@ -571,6 +580,39 @@ interface MultiAgentLifecycleHooks {
         keys: string[];
         timestamp: number;
     }) => void;
+    /** Called when a task starts executing */
+    onTaskStart?: (event: {
+        patternId: string;
+        taskId: string;
+        label: string;
+        timestamp: number;
+    }) => void;
+    /** Called when a task completes successfully */
+    onTaskComplete?: (event: {
+        patternId: string;
+        taskId: string;
+        label: string;
+        durationMs: number;
+        timestamp: number;
+    }) => void;
+    /** Called when a task fails */
+    onTaskError?: (event: {
+        patternId: string;
+        taskId: string;
+        label: string;
+        error: Error;
+        durationMs: number;
+        timestamp: number;
+    }) => void;
+    /** Called when a task reports progress */
+    onTaskProgress?: (event: {
+        patternId: string;
+        taskId: string;
+        label: string;
+        percent: number;
+        message?: string;
+        timestamp: number;
+    }) => void;
     /** Called when a pattern checkpoint is saved */
     onCheckpointSave?: (event: {
         checkpointId: string;
@@ -641,8 +683,8 @@ interface DagExecutionContext {
 }
 /** A node in a DAG execution pattern */
 interface DagNode {
-    /** Registered agent ID to run for this node */
-    agent: string;
+    /** Registered handler ID (agent or task) to run for this node */
+    handler: string;
     /** Upstream node IDs this node depends on */
     deps?: string[];
     /** Conditional edge — evaluated when deps are met. @default unconditional */
@@ -672,11 +714,10 @@ interface DagPattern<T = unknown> {
 }
 /** Debug configuration for orchestrators */
 interface OrchestratorDebugConfig {
-    /** Include truncated input/output in timeline events for prompt/completion viewing */
     verboseTimeline?: boolean;
 }
 /** All debug event types */
-type DebugEventType = "agent_start" | "agent_complete" | "agent_error" | "agent_retry" | "guardrail_check" | "constraint_evaluate" | "resolver_start" | "resolver_complete" | "resolver_error" | "approval_request" | "approval_response" | "handoff_start" | "handoff_complete" | "pattern_start" | "pattern_complete" | "dag_node_update" | "breakpoint_hit" | "breakpoint_resumed" | "derivation_update" | "scratchpad_update" | "reflection_iteration" | "race_start" | "race_winner" | "race_cancelled" | "debate_round" | "reroute" | "checkpoint_save" | "checkpoint_restore";
+type DebugEventType = "agent_start" | "agent_complete" | "agent_error" | "agent_retry" | "guardrail_check" | "constraint_evaluate" | "resolver_start" | "resolver_complete" | "resolver_error" | "approval_request" | "approval_response" | "handoff_start" | "handoff_complete" | "pattern_start" | "pattern_complete" | "dag_node_update" | "breakpoint_hit" | "breakpoint_resumed" | "derivation_update" | "scratchpad_update" | "reflection_iteration" | "race_start" | "race_winner" | "race_cancelled" | "debate_round" | "reroute" | "checkpoint_save" | "checkpoint_restore" | "task_start" | "task_complete" | "task_error" | "task_progress" | "goal_step";
 /** Base debug event */
 interface DebugEventBase {
     id: number;
@@ -690,7 +731,7 @@ interface AgentStartEvent extends DebugEventBase {
     type: "agent_start";
     agentId: string;
     inputLength: number;
-    /** Truncated input text (only when verboseTimeline is enabled) */
+    /** Truncated input text (max 5000 chars) */
     input?: string;
 }
 /** Agent complete event */
@@ -703,7 +744,7 @@ interface AgentCompleteEvent extends DebugEventBase {
     outputTokens: number;
     durationMs: number;
     modelId?: string;
-    /** Truncated output text (only when verboseTimeline is enabled) */
+    /** Truncated output text (max 5000 chars) */
     output?: string;
 }
 /** Agent error event */
@@ -786,6 +827,10 @@ interface PatternStartEvent extends DebugEventBase {
     type: "pattern_start";
     patternId: string;
     patternType: "parallel" | "sequential" | "supervisor" | "dag" | "reflect" | "race" | "debate" | "goal";
+    /** All handler IDs in this pattern (agents + tasks) */
+    handlers?: string[];
+    /** Which handler IDs are tasks (rest are agents) */
+    taskIds?: string[];
 }
 /** Pattern complete event */
 interface PatternCompleteEvent extends DebugEventBase {
@@ -889,8 +934,49 @@ interface CheckpointRestoreEvent extends DebugEventBase {
     patternType: string;
     step: number;
 }
+/** Task start event */
+interface TaskStartEvent extends DebugEventBase {
+    type: "task_start";
+    taskId: string;
+    label: string;
+    description?: string;
+    inputLength: number;
+}
+/** Task complete event */
+interface TaskCompleteEvent extends DebugEventBase {
+    type: "task_complete";
+    taskId: string;
+    label: string;
+    durationMs: number;
+}
+/** Task error event */
+interface TaskErrorEvent extends DebugEventBase {
+    type: "task_error";
+    taskId: string;
+    label: string;
+    error: string;
+    durationMs: number;
+    attempt?: number;
+}
+/** Task progress event */
+interface TaskProgressEvent extends DebugEventBase {
+    type: "task_progress";
+    taskId: string;
+    label: string;
+    percent: number;
+    message?: string;
+}
+/** Goal step event — emitted for each agent invocation within a goal step */
+interface GoalStepEvent extends DebugEventBase {
+    type: "goal_step";
+    agentId: string;
+    step: number;
+    nodeId: string;
+    satisfaction: number;
+    satisfactionDelta: number;
+}
 /** Union of all debug event types */
-type DebugEvent = AgentStartEvent | AgentCompleteEvent | AgentErrorEvent | AgentRetryEvent | GuardrailCheckEvent | ConstraintEvaluateEvent | ResolverStartEvent | ResolverCompleteEvent | ResolverErrorEvent | ApprovalRequestEvent | ApprovalResponseEvent | HandoffStartEvent | HandoffCompleteEvent | PatternStartEvent | PatternCompleteEvent | DagNodeUpdateEvent | BreakpointHitEvent | BreakpointResumedEvent | DerivationUpdateEvent | ScratchpadUpdateEvent | ReflectionIterationEvent | RaceStartEvent | RaceWinnerEvent | RaceCancelledEvent | DebateRoundEvent | RerouteDebugEvent | CheckpointSaveEvent | CheckpointRestoreEvent;
+type DebugEvent = AgentStartEvent | AgentCompleteEvent | AgentErrorEvent | AgentRetryEvent | GuardrailCheckEvent | ConstraintEvaluateEvent | ResolverStartEvent | ResolverCompleteEvent | ResolverErrorEvent | ApprovalRequestEvent | ApprovalResponseEvent | HandoffStartEvent | HandoffCompleteEvent | PatternStartEvent | PatternCompleteEvent | DagNodeUpdateEvent | BreakpointHitEvent | BreakpointResumedEvent | DerivationUpdateEvent | ScratchpadUpdateEvent | ReflectionIterationEvent | RaceStartEvent | RaceWinnerEvent | RaceCancelledEvent | DebateRoundEvent | RerouteDebugEvent | CheckpointSaveEvent | CheckpointRestoreEvent | TaskStartEvent | TaskCompleteEvent | TaskErrorEvent | TaskProgressEvent | GoalStepEvent;
 /** Health state for an agent stored in facts */
 interface AgentHealthState {
     circuitState: "CLOSED" | "OPEN" | "HALF_OPEN";
@@ -1013,8 +1099,8 @@ interface Scratchpad<T extends Record<string, unknown> = Record<string, unknown>
 }
 /** A node in a goal execution pattern */
 interface GoalNode {
-    /** Agent ID (registered on the orchestrator) */
-    agent: string;
+    /** Handler ID — agent or task registered on the orchestrator */
+    handler: string;
     /** Fact keys this node can produce */
     produces: string[];
     /** Fact keys this node needs (must be satisfied before running) */
@@ -1175,9 +1261,6 @@ interface CheckpointContext {
     /** Satisfaction score 0-1 (goal only) */
     satisfaction?: number;
 }
-/**
- * @deprecated Use `PatternCheckpointConfig` instead. Alias kept for backward compatibility.
- */
 type GoalCheckpointConfig = PatternCheckpointConfig;
 /** Common fields present on all pattern checkpoint states */
 interface PatternCheckpointBase {
@@ -1370,4 +1453,4 @@ interface CheckpointDiff {
     nodesCompleted?: string[];
 }
 
-export { type DebateRoundEvent as $, type AgentLike as A, type BreakpointState as B, type Checkpoint as C, type DebugEvent as D, type CheckpointDiff as E, type CheckpointLocalState as F, type GuardrailFn as G, type CheckpointProgress as H, type InputGuardrailData as I, type CheckpointRestoreEvent as J, type CheckpointSaveEvent as K, type CheckpointStore as L, type Message as M, type ConstraintEvaluateEvent as N, type OutputGuardrailData as O, type CrossAgentDerivationFn as P, type CrossAgentSnapshot as Q, type RunOptions as R, type SchemaValidator as S, type ToolCallGuardrailData as T, type DagCheckpointState as U, type DagExecutionContext as V, type DagNode as W, type DagNodeStatus as X, type DagNodeUpdateEvent as Y, type DagPattern as Z, type DebateCheckpointState as _, type AdapterHooks as a, createBreakpointId as a$, type DebugEventBase as a0, type DebugEventType as a1, type DerivationUpdateEvent as a2, type GoalCheckpointConfig as a3, type GoalCheckpointState as a4, type GoalMetrics as a5, type GoalNode as a6, type GoalPattern as a7, type GoalStepMetrics as a8, type GuardrailCheckEvent as a9, type PatternCompleteEvent as aA, type PatternStartEvent as aB, type RaceCancelledEvent as aC, type RaceStartEvent as aD, type RaceWinnerEvent as aE, type ReflectCheckpointState as aF, type ReflectionIterationEvent as aG, type RejectedRequest as aH, type RelaxationContext as aI, type RelaxationRecord as aJ, type RelaxationStrategy as aK, type RelaxationTier as aL, type RerouteDebugEvent as aM, type RerouteEvent as aN, type ResolverCompleteEvent as aO, type ResolverErrorEvent as aP, type ResolverStartEvent as aQ, type SchemaValidationResult as aR, type Scratchpad as aS, type ScratchpadUpdateEvent as aT, type SelfHealingConfig as aU, type SequentialCheckpointState as aV, type SingleAgentCheckpointLocalState as aW, type StreamingCallbackRunner as aX, type SupervisorCheckpointState as aY, type TokenUsage as aZ, type ToolCall as a_, type GuardrailContext as aa, GuardrailError as ab, type GuardrailErrorCode as ac, type GuardrailResult as ad, type GuardrailRetryConfig as ae, type GuardrailsConfig as af, type HandoffCompleteEvent as ag, type HandoffStartEvent as ah, type HealthMonitorConfig as ai, InMemoryCheckpointStore as aj, type InMemoryCheckpointStoreOptions as ak, MAX_BREAKPOINT_HISTORY as al, type MultiAgentBreakpointType as am, type MultiAgentCheckpointLocalState as an, type MultiAgentLifecycleHooks as ao, type MultiAgentSelfHealingConfig as ap, type NamedGuardrail as aq, type OrchestratorConstraint as ar, type OrchestratorDebugConfig as as, type OrchestratorLifecycleHooks as at, type OrchestratorResolver as au, type OrchestratorResolverContext as av, type OrchestratorState as aw, type PatternCheckpointBase as ax, type PatternCheckpointConfig as ay, type PatternCheckpointState as az, type AgentRunner as b, createCheckpointId as b0, createInitialBreakpointState as b1, isGuardrailError as b2, matchBreakpoint as b3, validateCheckpoint as b4, type ApprovalState as c, type AgentState as d, type RunResult as e, type GoalResult as f, type AgentCircuitBreakerConfig as g, type AgentCompleteEvent as h, type AgentErrorEvent as i, type AgentHealthState as j, type AgentRetryConfig as k, type AgentRetryEvent as l, type AgentSelectionStrategy as m, type AgentStartEvent as n, type ApprovalRequest as o, type ApprovalRequestEvent as p, type ApprovalResponseEvent as q, type BreakpointConfig as r, type BreakpointContext as s, type BreakpointHitEvent as t, type BreakpointModifications as u, type BreakpointRequest as v, type BreakpointResumedEvent as w, type BreakpointState$1 as x, type BreakpointType as y, type CheckpointContext as z };
+export { type DebateRoundEvent as $, type AgentLike as A, type BreakpointState as B, type Checkpoint as C, type DebugEvent as D, type CheckpointDiff as E, type CheckpointLocalState as F, type GuardrailFn as G, type CheckpointProgress as H, type InputGuardrailData as I, type CheckpointRestoreEvent as J, type CheckpointSaveEvent as K, type CheckpointStore as L, type Message as M, type ConstraintEvaluateEvent as N, type OutputGuardrailData as O, type CrossAgentDerivationFn as P, type CrossAgentSnapshot as Q, type RunOptions as R, type SchemaValidator as S, type ToolCallGuardrailData as T, type DagCheckpointState as U, type DagExecutionContext as V, type DagNode as W, type DagNodeStatus as X, type DagNodeUpdateEvent as Y, type DagPattern as Z, type DebateCheckpointState as _, type AdapterHooks as a, type TaskProgressEvent as a$, type DebugEventBase as a0, type DebugEventType as a1, type DerivationUpdateEvent as a2, type GoalCheckpointConfig as a3, type GoalCheckpointState as a4, type GoalMetrics as a5, type GoalNode as a6, type GoalPattern as a7, type GoalStepMetrics as a8, type GuardrailCheckEvent as a9, type PatternCompleteEvent as aA, type PatternStartEvent as aB, type RaceCancelledEvent as aC, type RaceStartEvent as aD, type RaceWinnerEvent as aE, type ReflectCheckpointState as aF, type ReflectionIterationEvent as aG, type RejectedRequest as aH, type RelaxationContext as aI, type RelaxationRecord as aJ, type RelaxationStrategy as aK, type RelaxationTier as aL, type RerouteDebugEvent as aM, type RerouteEvent as aN, type ResolverCompleteEvent as aO, type ResolverErrorEvent as aP, type ResolverStartEvent as aQ, type SchemaValidationResult as aR, type Scratchpad as aS, type ScratchpadUpdateEvent as aT, type SelfHealingConfig as aU, type SequentialCheckpointState as aV, type SingleAgentCheckpointLocalState as aW, type StreamingCallbackRunner as aX, type SupervisorCheckpointState as aY, type TaskCompleteEvent as aZ, type TaskErrorEvent as a_, type GuardrailContext as aa, GuardrailError as ab, type GuardrailErrorCode as ac, type GuardrailResult as ad, type GuardrailRetryConfig as ae, type GuardrailsConfig as af, type HandoffCompleteEvent as ag, type HandoffStartEvent as ah, type HealthMonitorConfig as ai, InMemoryCheckpointStore as aj, type InMemoryCheckpointStoreOptions as ak, MAX_BREAKPOINT_HISTORY as al, type MultiAgentBreakpointType as am, type MultiAgentCheckpointLocalState as an, type MultiAgentLifecycleHooks as ao, type MultiAgentSelfHealingConfig as ap, type NamedGuardrail as aq, type OrchestratorConstraint as ar, type OrchestratorDebugConfig as as, type OrchestratorLifecycleHooks as at, type OrchestratorResolver as au, type OrchestratorResolverContext as av, type OrchestratorState as aw, type PatternCheckpointBase as ax, type PatternCheckpointConfig as ay, type PatternCheckpointState as az, type AgentRunner as b, type TaskStartEvent as b0, type TokenUsage as b1, type ToolCall as b2, createBreakpointId as b3, createCheckpointId as b4, createInitialBreakpointState as b5, isGuardrailError as b6, matchBreakpoint as b7, validateCheckpoint as b8, type ApprovalState as c, type AgentState as d, type RunResult as e, type GoalResult as f, type AgentCircuitBreakerConfig as g, type AgentCompleteEvent as h, type AgentErrorEvent as i, type AgentHealthState as j, type AgentRetryConfig as k, type AgentRetryEvent as l, type AgentSelectionStrategy as m, type AgentStartEvent as n, type ApprovalRequest as o, type ApprovalRequestEvent as p, type ApprovalResponseEvent as q, type BreakpointConfig as r, type BreakpointContext as s, type BreakpointHitEvent as t, type BreakpointModifications as u, type BreakpointRequest as v, type BreakpointResumedEvent as w, type BreakpointState$1 as x, type BreakpointType as y, type CheckpointContext as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@directive-run/ai",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "AI agent orchestration, guardrails, and multi-agent coordination for Directive.",
   "license": "MIT",
   "author": "Jason Comes",
@@ -76,7 +76,7 @@
     "@types/node": "^25.2.0",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
-    "@directive-run/core": "0.3.0"
+    "@directive-run/core": "0.4.0"
   },
   "scripts": {
     "build": "tsup",