@rowan-agent/agent 0.14.2 → 0.15.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _rowan_agent_models from '@rowan-agent/models';
-import { LlmContentPart, ContentBlock, ModelRef, ModelConfig, StreamFn } from '@rowan-agent/models';
+import { LlmContentPart, ModelRef, ContentBlock, ModelConfig, StreamFn } from '@rowan-agent/models';
 export { ModelConfig, ModelRef, StreamFn, ThinkingLevel } from '@rowan-agent/models';
 import Type from 'typebox';
 
@@ -55,622 +55,279 @@ type ToolResult = {
     error?: string;
 };
 
-type LoopMetrics = {
-    /** Number of phase iterations executed. */
-    iterations: number;
-    /** Phase transition history. */
-    phaseTransitions: Array<{
-        from: string;
-        to: string;
-        ts: string;
-    }>;
-    /** Number of times compaction was triggered. */
-    compactionCount: number;
-    /** Number of retry attempts due to transient errors. */
-    retryCount: number;
-    /** Loop start timestamp. */
-    startedAt: string;
-    /** Loop start time as epoch ms (for duration calculation). */
-    startedAtMs: number;
-    /** Loop end timestamp (set on completion). */
-    endedAt?: string;
-    /** Total wall-clock duration in ms. */
-    durationMs?: number;
-};
-type ExecutionState = {
-    currentPhase: string;
-    attempt: number;
-    metrics: LoopMetrics;
-    status: "idle" | "running" | "suspended" | "completed" | "aborted" | "failed";
-    initialPhasePayload?: JsonValue;
-    continuation?: ExecutionContinuationState;
-    runInteractions?: RunInteractionState;
-    phaseInteractions?: RunInteractionState;
-};
-type ExecutionContinuationState = {
-    isContinuing: boolean;
-    previousPayload?: unknown;
-    previousResults: Array<{
-        name: string;
-        output?: unknown;
-    }>;
-    pendingInstruction?: string;
-    previousPhaseMessageId?: string;
-};
-
-type RunInteractionKind = "user_input" | "permission" | "elicitation" | "confirmation";
-type RunInteractionStatus = "pending" | "answered" | "replied" | "cancelled";
-type RunInteraction = Readonly<{
-    id: string;
-    phase: string;
-    kind: RunInteractionKind;
-    prompt: string;
-    payload?: JsonValue;
-    createdAt: string;
-    status: RunInteractionStatus;
-    answer?: JsonValue;
-    reply?: string;
-    /** The Run is only waiting for the next user message, not asking a question. */
-    turnBoundary?: true;
-    toolCallId?: string;
-    result?: Readonly<{
-        answered?: string;
-        replied?: string;
-        cancelled?: string;
-    }>;
+type PhaseRegistrySelection = Readonly<{
+    entryPhaseId: string | null;
+    phaseIds: readonly string[];
 }>;
-type RunInteractionRequest = Readonly<{
-    id?: string;
-    kind: RunInteractionKind;
+type AgentDefinition = Readonly<{
+    name: string;
+    description: string;
     prompt: string;
-    payload?: JsonValue;
-    toolCallId?: string;
-    result?: Readonly<{
-        answered?: string;
-        replied?: string;
-        cancelled?: string;
-    }>;
-}>;
-type RunInteractionState = Readonly<{
-    requests: readonly RunInteraction[];
-    answers: Readonly<Record<string, JsonValue>>;
-    checkpoint?: JsonValue;
-}>;
-type RunInteractionDriver = Readonly<{
-    signal: AbortSignal;
-    request(input: RunInteractionRequest): RunInteraction;
-    pending(): readonly RunInteraction[];
-    answers(): ReadonlyMap<string, JsonValue>;
-    checkpoint(): JsonValue | undefined;
-    clearCheckpoint(): void;
-    suspend(input?: Readonly<{
-        checkpoint?: JsonValue;
-    }>): never;
+    tools?: readonly string[];
+    skills?: readonly string[];
+    /** Host-supplied Skills private to this Agent Definition/Bundle. */
+    bundledSkills?: readonly Skill[];
+    phases?: PhaseRegistrySelection;
+    contexts?: readonly string[];
+    model?: ModelRef;
 }>;
-declare class RunInteractionCancelledError extends Error {
-    readonly code: "run_interaction_cancelled";
-    constructor();
-}
-declare class RunInteractionBoundary extends Error {
-    readonly state: ExecutionState;
-    readonly interactions: readonly RunInteraction[];
-    constructor(state: ExecutionState, interactions: readonly RunInteraction[]);
-}
+/** Parse one Markdown definition using the same frontmatter vocabulary as Phase resources. */
+declare function parseAgentDefinition(raw: string): AgentDefinition;
 
-declare const opaqueIdBrand: unique symbol;
-type OpaqueId<Kind extends string> = string & {
-    readonly [opaqueIdBrand]: Kind;
-};
-type AgentId = OpaqueId<"AgentId">;
-type RunId = OpaqueId<"RunId">;
-type MessageId = OpaqueId<"MessageId">;
-type ToolCallId = OpaqueId<"ToolCallId">;
-type EventId = OpaqueId<"EventId">;
-type ExecutionId = OpaqueId<"ExecutionId">;
-type OutcomeId = OpaqueId<"OutcomeId">;
-type ConfigToken = OpaqueId<"ConfigToken">;
-type OwnerToken = OpaqueId<"OwnerToken">;
-type EventCursor = OpaqueId<"EventCursor">;
-type AgentListCursor = OpaqueId<"AgentListCursor">;
-type RunListCursor = OpaqueId<"RunListCursor">;
-type JsonPrimitive = null | boolean | number | string;
-type JsonValue = JsonPrimitive | readonly JsonValue[] | {
-    readonly [key: string]: JsonValue;
-};
-type JsonObject = Readonly<Record<string, JsonValue>>;
-type Metadata = JsonObject;
-type TextContent = Readonly<{
-    type: "text";
-    text: string;
-}>;
-type ImageContent = Readonly<{
-    type: "image";
-    data: string;
-    mimeType: string;
-}>;
-type ThinkingContent = Readonly<{
-    type: "thinking";
-    thinking: string;
-    signature?: string;
+type ResourceKind = "agent" | "tool" | "skill" | "phase";
+type ResourceSourceId = string;
+/** Rowan-native contribution aliases. Hosts may adapt their domain handlers to
+ * these existing Tool/Phase lifecycles without importing host Scope types. */
+type ToolContribution = Tool$1;
+type PhaseContribution = Phase;
+type ResourceView = Readonly<{
+    agents: readonly ResourceSourceId[];
+    tools: readonly ResourceSourceId[];
+    skills: readonly ResourceSourceId[];
+    phases: readonly ResourceSourceId[];
 }>;
-type ToolUseContent = Readonly<{
-    type: "tool_use";
-    toolCallId: ToolCallId;
-    /** Provider/model correlation, retained only to reconstruct the next request. */
-    providerToolCallId?: string;
+type ResourceRef = Readonly<{
+    kind: ResourceKind;
+    sourceId: ResourceSourceId;
     name: string;
-    input: JsonValue;
-}>;
-type ToolExecutionResult$1 = Readonly<{
-    ok: true;
-    content: JsonValue;
-}> | Readonly<{
-    ok: false;
-    content: JsonValue;
-    error: string;
-}>;
-type DurableToolResult = Readonly<{
-    toolCallId: ToolCallId;
-    toolName: string;
-}> & ToolExecutionResult$1;
-type ToolResultContent = Readonly<{
-    type: "tool_result";
-    toolCallId: ToolCallId;
-    /** Provider/model correlation, retained only to reconstruct the next request. */
-    providerToolCallId?: string;
-    result: ToolExecutionResult$1;
-}>;
-type UserContent = string | readonly (TextContent | ImageContent)[];
-type AssistantContent = string | readonly (TextContent | ThinkingContent | ToolUseContent)[];
-type ToolMessageContent = readonly [ToolResultContent, ...ToolResultContent[]];
-type MessageContent = UserContent | AssistantContent | ToolMessageContent;
-type MessageBase = Readonly<{
-    id: MessageId;
-    agentId: AgentId;
-    runId: RunId;
-    /** Monotonic active revision. Omitted on legacy/initial messages and read as 0. */
-    messageRevision?: number;
-    metadata?: Metadata;
-    sequenceWithinRun: number;
-    createdAt: string;
-}>;
-type UserMessage = MessageBase & Readonly<{
-    role: "user";
-    content: UserContent;
 }>;
-type AssistantMessage = MessageBase & Readonly<{
-    role: "assistant";
-    content: AssistantContent;
-    interrupted?: boolean;
+type ResourceDiagnostic = Readonly<{
+    kind: "invalid" | "missing" | "collision";
+    sourceId: ResourceSourceId;
+    message: string;
+    path?: string;
 }>;
-type ToolMessage = MessageBase & Readonly<{
-    role: "tool";
-    content: ToolMessageContent;
+type LoadResult = Readonly<{
+    revision: string;
+    registered: readonly ResourceRef[];
+    skipped: readonly ResourceDiagnostic[];
 }>;
-type InteractionRecord = MessageBase & Readonly<{
-    role: "interaction";
-    interactionId: string;
-    kind: "user_input" | "permission" | "elicitation" | "confirmation";
-    prompt: string;
-    phase: string;
-    status: "answered" | "replied" | "cancelled";
-    answer?: JsonValue;
-    reply?: string;
-    toolCallId?: ToolCallId;
-    result?: Readonly<{
-        answered?: string;
-        replied?: string;
-        cancelled?: string;
-    }>;
+type LoadInput<T> = Readonly<{
+    sourceId: ResourceSourceId;
+    directory?: string;
+    values?: readonly T[];
 }>;
-type Message = UserMessage | AssistantMessage | ToolMessage | InteractionRecord;
-type Outcome = Readonly<{
-    id: OutcomeId;
-    message: string;
-    payload?: JsonValue;
-    toolResults?: readonly DurableToolResult[];
+type ResolvedResourceView = Readonly<{
+    agents: readonly AgentDefinition[];
+    tools: readonly Tool$1[];
+    skills: readonly Skill[];
+    phases: readonly Phase[];
+    revisions: Readonly<Record<ResourceKind, readonly string[]>>;
+    refs: Readonly<Record<ResourceKind, readonly ResourceRef[]>>;
 }>;
-type RunState = "queued" | "running" | "input_required" | "completed" | "failed" | "cancelled";
-type RunFailure = Readonly<{
-    code: "configuration_unavailable";
-    message: string;
-}> | Readonly<{
-    code: "checkpoint_incompatible";
-    message: string;
-    expected: Readonly<{
-        codec: string;
-        versions: readonly number[];
-    }>;
-    actual: Readonly<{
-        codec: string;
-        version: number;
-    }>;
-}> | Readonly<{
-    code: "runtime_interrupted";
-    message: string;
-    ownerEpoch: number;
-}> | Readonly<{
-    code: "tool_indeterminate";
-    message: string;
-    toolCallIds: readonly [ToolCallId, ...ToolCallId[]];
-}> | Readonly<{
-    code: "execution_failed";
-    message: string;
-    details?: JsonValue;
-}>;
-type QueuedRunFailure = Extract<RunFailure, {
-    code: "configuration_unavailable" | "checkpoint_incompatible";
-}>;
-type RunningRunFailure = Extract<RunFailure, {
-    code: "runtime_interrupted" | "tool_indeterminate" | "execution_failed";
-}>;
-type ToolCallState = "pending" | "running" | "completed" | "failed" | "indeterminate";
-type ToolCallSnapshotBase = Readonly<{
-    id: ToolCallId;
-    providerToolCallId: string;
-    agentId: AgentId;
-    runId: RunId;
-    executionId: ExecutionId;
-    requestMessageId: MessageId;
+type ResourceRegistryErrorCode = "invalid_source_id" | "invalid_resource_name" | "resource_collision" | "resource_input_missing" | "resource_directory_not_supported" | "unknown_resource_source" | "implicit_source_protected";
+declare class ResourceRegistryError extends Error {
+    readonly code: ResourceRegistryErrorCode;
+    constructor(code: ResourceRegistryErrorCode, message: string);
+}
+type RegistryValue = AgentDefinition | Tool$1 | Skill | Phase;
+/**
+ * Runtime Resource Registry source transaction and view resolver.
+ *
+ * Directory normalization is intentionally added by the typed loader slice;
+ * this first module owns only the atomic source/revision/collision semantics.
+ */
+declare class ResourceRegistry {
+    private readonly sources;
+    /** Sources registered by the bootstrap boundary (currently Extensions). */
+    private readonly implicitSources;
+    private revisionSequence;
+    loadAgents(input: LoadInput<AgentDefinition>): Promise<LoadResult>;
+    loadSkills(input: LoadInput<Skill>): Promise<LoadResult>;
+    loadPhases(input: LoadInput<Phase>): Promise<LoadResult>;
+    loadTools(input: Readonly<{
+        sourceId: ResourceSourceId;
+        values: readonly ToolContribution[];
+    }>): Promise<LoadResult>;
+    unload(input: Readonly<{
+        kind: ResourceKind;
+        sourceId: ResourceSourceId;
+    }>): Promise<LoadResult>;
+    resolveView(view: ResourceView): ResolvedResourceView;
+    /** Mark one already-loaded source as implicit for every Resource View. */
+    protected markImplicit(kind: ResourceKind, sourceId: ResourceSourceId): void;
+    /** Bootstrap-only helper for replacing an implicit contribution source. */
+    protected replaceImplicit<T extends RegistryValue>(kind: ResourceKind, sourceId: ResourceSourceId, values: readonly T[]): Promise<LoadResult>;
+    protected hasImplicit(kind: ResourceKind, sourceId: ResourceSourceId): boolean;
+    private withImplicit;
+    private collect;
+    private commit;
+    private resolveKind;
+    private resolveRevisions;
+    private resolveRefs;
+    private sourcesFor;
+    private nextRevision;
+}
+
+type ModelInvokeOutput = {
+    text: string;
+    contentBlocks: ContentBlock[];
+    toolCalls: ToolCall[];
+    stopReason?: string;
+};
+/** Snapshot of phase-level context for restore */
+type PhaseContextSnapshot = {
+    systemPrompt: string;
+    messages: AgentMessage[];
+    currentPhase: string;
+    availablePhases: string[];
+    turnNumber: number;
+    payload?: unknown;
+};
+/** Execution capabilities for a phase — operates on PhaseContext. */
+type PhaseExecution = {
+    snapshot(): PhaseContextSnapshot;
+    restore(snapshot: PhaseContextSnapshot): void;
+    invokeModel(context: PhaseContext, options?: {
+        output?: "reply" | "internal";
+    }): Promise<ModelInvokeOutput>;
+    reportStatus(status: PhaseStatus): Promise<void>;
+    executeTool(context: AgentContext, toolCall: ToolCall): Promise<ToolResult>;
+    executeTools(context: AgentContext, toolCalls: readonly ToolCall[], contentBlocks?: readonly ContentBlock[]): Promise<readonly ToolResult[]>;
+    interaction: RunInteractionDriver;
+    /** Message lifecycle manager for streaming updates from programmatic phases */
+    messages: PhaseMessageManager;
+};
+/** Message lifecycle manager for streaming updates */
+type PhaseMessageManager = {
+    /** Get all visible messages in the transcript */
+    visible(): AgentMessage[];
+    /** Reserve the eventual message identity before stream deltas arrive. */
+    reserve(role: "assistant" | "tool", metadata?: Record<string, unknown>): string;
+    /** Start a new message stream, returns message id */
+    start(role: "assistant" | "tool", content: AgentMessage["content"], metadata?: Record<string, unknown>): string;
+    /** Stream a text delta */
+    update(messageId: string, delta: string): Promise<void>;
+    /** Replace the active message content with model-native content parts */
+    replaceContent(messageId: string, content: string | LlmContentPart[]): void;
+    /** End the message stream, appends to transcript */
+    end(messageId: string): Promise<void>;
+    /** Drop an unstarted stream that produced no content. */
+    discard(messageId: string): void;
+};
+
+interface SourceInfo {
+    source: string;
+    baseDir?: string;
+    displayName?: string;
+}
+/** Register a Phase by directory path or Phase object; PHASE.md and direct child Skills are loaded atomically when a path is supplied. */
+type PhaseRegistration = string | Phase;
+/**
+ * Tool definition for registering LLM-callable tools via `api.tool.register()`.
+ *
+ * @example
+ * ```typescript
+ * api.tool.register({
+ *   name: "search_docs",
+ *   description: "Search documentation",
+ *   parameters: { type: "object", properties: { query: { type: "string" } } },
+ *   execute: async (args, ctx) => {
+ *     return { content: [{ type: "text", text: "result" }] };
+ *   },
+ * });
+ * ```
+ */
+interface ToolDefinition {
+    /** Tool name (used in LLM tool calls) */
     name: string;
-    args: JsonValue;
-    createdAt: string;
-    updatedAt: string;
-}>;
-type ToolCallSnapshot = ToolCallSnapshotBase & (Readonly<{
-    state: "pending";
-}> | Readonly<{
-    state: "running";
-}> | Readonly<{
-    state: "completed";
-    result: DurableToolResult & Readonly<{
-        ok: true;
-    }>;
-    resultMessageId: MessageId;
-}> | Readonly<{
-    state: "failed";
-    result: DurableToolResult & Readonly<{
-        ok: false;
+    /** Description for LLM */
+    description: string;
+    /** Parameter schema (JSON Schema) */
+    parameters: Record<string, unknown>;
+    /** Execute the tool */
+    execute: (args: unknown, context: ToolInvocationContext, signal?: AbortSignal) => Promise<ToolExecutionResult$1>;
+    /** Optional: per-tool execution mode override */
+    executionMode?: "sequential" | "parallel";
+}
+/**
+ * Result from tool execution.
+ */
+interface ToolExecutionResult$1 {
+    /** Content blocks to return to the LLM */
+    content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
     }>;
-    resultMessageId: MessageId;
-}> | Readonly<{
-    state: "indeterminate";
-    result: DurableToolResult & Readonly<{
-        ok: false;
+    /** Whether this is an error result */
+    isError?: boolean;
+}
+/**
+ * Registered tool with source metadata.
+ */
+interface RegisteredTool {
+    definition: ToolDefinition;
+    sourceInfo: SourceInfo;
+}
+/**
+ * Structured extension error with attribution.
+ */
+interface ExtensionError {
+    /** Path of the extension that caused the error */
+    extensionPath: string;
+    /** Event or operation that caused the error */
+    event: string;
+    /** Error message */
+    error: string;
+    /** Optional stack trace */
+    stack?: string;
+}
+/** Error listener callback type. */
+type ExtensionErrorListener = (error: ExtensionError) => void;
+type ExecOptions = {
+    /** Working directory for the command. Defaults to cwd passed to runtime. */
+    cwd?: string;
+    /** Environment variables to add/override. */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds. */
+    timeout?: number;
+    /** AbortSignal for cancellation. */
+    signal?: AbortSignal;
+};
+type ExecResult = {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+};
+/**
+ * Shared runtime state created by loader, used during registration and runtime.
+ * All ExtensionAPI instances reference this shared state.
+ *
+ * It only owns the lifetime guard shared by captured Extension API objects.
+ */
+interface ExtensionRuntime {
+    /** Throws when this extension instance is stale after runtime replacement. */
+    assertActive: () => void;
+    /** Marks this extension instance as stale after runtime replacement or reload. */
+    invalidate: (message?: string) => void;
+}
+/**
+ * Result of loading extensions from filesystem.
+ * The runner takes these and creates Extension tracking objects.
+ */
+type LoadExtensionsResult = {
+    extensions: LoadedExtension[];
+    errors: Array<{
+        path: string;
+        error: string;
     }>;
-    resultMessageId: MessageId;
-    reason: string;
-}>);
-type DurableEventBase = Readonly<{
-    id: EventId;
-    schemaVersion: 1;
-    cursor: EventCursor;
-    durability: "durable";
-    agentId: AgentId;
-    runId: RunId;
-    runRevision: number;
-    metadata?: Metadata;
-    createdAt: string;
-}>;
-type PhaseEntered = DurableEventBase & Readonly<{
-    kind: "phase_entered";
-    executionId: ExecutionId;
-    phaseId: string;
-    visit: number;
-}>;
-type MessageCommitted = DurableEventBase & Readonly<{
-    kind: "message_committed";
-    message: Message;
-}>;
-type MessageRevised = DurableEventBase & Readonly<{
-    kind: "message_revised";
-    message: UserMessage;
-    previousRevision: number;
-    invalidatedRunIds: readonly RunId[];
-    targetRunId: RunId;
-    cutoffSequenceWithinRun: number;
-}>;
-type RunStateChanged = DurableEventBase & (Readonly<{
-    kind: "run_state_changed";
-    from: null;
-    to: "queued";
-}> | Readonly<{
-    kind: "run_state_changed";
-    from: "input_required";
-    to: "queued";
-}> | Readonly<{
-    kind: "run_state_changed";
-    from: "queued";
-    to: "running";
-}> | Readonly<{
-    kind: "run_state_changed";
-    from: "running";
-    to: "input_required";
-    interactions: readonly RunInteraction[];
-    answers: Readonly<Record<string, JsonValue>>;
-}> | Readonly<{
-    kind: "run_state_changed";
-    from: "running";
-    to: "completed";
-    outcome: Outcome;
-    output?: AssistantMessage;
-}> | Readonly<{
-    kind: "run_state_changed";
-    from: "queued";
-    to: "failed";
-    failure: QueuedRunFailure;
-}> | Readonly<{
-    kind: "run_state_changed";
-    from: "running";
-    to: "failed";
-    failure: RunningRunFailure;
-}> | Readonly<{
-    kind: "run_state_changed";
-    from: "queued" | "running" | "input_required";
-    to: "cancelled";
-    reason?: string;
-}>);
-type ToolStateChanged = DurableEventBase & (Readonly<{
-    kind: "tool_state_changed";
-    transition: Readonly<{
-        from: null;
-        to: "pending";
-    }>;
-    toolCall: Extract<ToolCallSnapshot, {
-        state: "pending";
-    }>;
-}> | Readonly<{
-    kind: "tool_state_changed";
-    transition: Readonly<{
-        from: "pending";
-        to: "running";
-    }>;
-    toolCall: Extract<ToolCallSnapshot, {
-        state: "running";
-    }>;
-}> | Readonly<{
-    kind: "tool_state_changed";
-    transition: Readonly<{
-        from: "pending";
-        to: "failed";
-    }>;
-    toolCall: Extract<ToolCallSnapshot, {
-        state: "failed";
-    }>;
-}> | Readonly<{
-    kind: "tool_state_changed";
-    transition: Readonly<{
-        from: "running";
-        to: "pending";
-    }>;
-    toolCall: Extract<ToolCallSnapshot, {
-        state: "pending";
-    }>;
-}> | Readonly<{
-    kind: "tool_state_changed";
-    transition: Readonly<{
-        from: "running";
-        to: "pending";
-    }>;
-    toolCall: Extract<ToolCallSnapshot, {
-        state: "pending";
-    }>;
-}> | Readonly<{
-    kind: "tool_state_changed";
-    transition: Readonly<{
-        from: "running";
-        to: "completed";
-    }>;
-    toolCall: Extract<ToolCallSnapshot, {
-        state: "completed";
-    }>;
-}> | Readonly<{
-    kind: "tool_state_changed";
-    transition: Readonly<{
-        from: "running";
-        to: "failed";
-    }>;
-    toolCall: Extract<ToolCallSnapshot, {
-        state: "failed";
-    }>;
-}> | Readonly<{
-    kind: "tool_state_changed";
-    transition: Readonly<{
-        from: "running";
-        to: "indeterminate";
-    }>;
-    toolCall: Extract<ToolCallSnapshot, {
-        state: "indeterminate";
-    }>;
-}>);
-type DurableRunEvent = PhaseEntered | MessageCommitted | MessageRevised | RunStateChanged | ToolStateChanged;
-type MessageDelta = Readonly<{
-    kind: "message_delta";
-    durability: "transient";
-    runId: RunId;
-    executionId: ExecutionId;
-    messageId: MessageId;
-    offset: number;
-    text: string;
-}>;
-type ThinkingDelta = Readonly<{
-    kind: "thinking_delta";
-    durability: "transient";
-    runId: RunId;
-    executionId: ExecutionId;
-    messageId: MessageId;
-    blockIndex: number;
-    offset: number;
-    text: string;
-}>;
-type ToolProgress = Readonly<{
-    kind: "tool_progress";
-    durability: "transient";
-    runId: RunId;
-    executionId: ExecutionId;
-    toolCallId: ToolCallId;
-    progress: JsonValue;
-}>;
-type PhaseStatusEvent = Readonly<{
-    kind: "phase_status";
-    durability: "transient";
-    runId: RunId;
-    executionId: ExecutionId;
-    phaseId: string;
-    status: PhaseStatus;
-}>;
-type RunEvent = DurableRunEvent | MessageDelta | ThinkingDelta | ToolProgress | PhaseStatusEvent;
-
-type ModelInvokeOutput = {
-    text: string;
-    contentBlocks: ContentBlock[];
-    toolCalls: ToolCall[];
-    stopReason?: string;
-};
-/** Snapshot of phase-level context for restore */
-type PhaseContextSnapshot = {
-    systemPrompt: string;
-    messages: AgentMessage[];
-    currentPhase: string;
-    availablePhases: string[];
-    turnNumber: number;
-    payload?: unknown;
 };
-/** Execution capabilities for a phase — operates on PhaseContext. */
-type PhaseExecution = {
-    snapshot(): PhaseContextSnapshot;
-    restore(snapshot: PhaseContextSnapshot): void;
-    invokeModel(context: PhaseContext, options?: {
-        output?: "reply" | "internal";
-    }): Promise<ModelInvokeOutput>;
-    reportStatus(status: PhaseStatus): Promise<void>;
-    executeTool(context: AgentContext, toolCall: ToolCall): Promise<ToolResult>;
-    executeTools(context: AgentContext, toolCalls: readonly ToolCall[], contentBlocks?: readonly ContentBlock[]): Promise<readonly ToolResult[]>;
-    interaction: RunInteractionDriver;
-    /** Message lifecycle manager for streaming updates from programmatic phases */
-    messages: PhaseMessageManager;
-};
-/** Message lifecycle manager for streaming updates */
-type PhaseMessageManager = {
-    /** Get all visible messages in the transcript */
-    visible(): AgentMessage[];
-    /** Reserve the eventual message identity before stream deltas arrive. */
-    reserve(role: "assistant" | "tool", metadata?: Record<string, unknown>): string;
-    /** Start a new message stream, returns message id */
-    start(role: "assistant" | "tool", content: AgentMessage["content"], metadata?: Record<string, unknown>): string;
-    /** Stream a text delta */
-    update(messageId: string, delta: string): Promise<void>;
-    /** Replace the active message content with model-native content parts */
-    replaceContent(messageId: string, content: string | LlmContentPart[]): void;
-    /** End the message stream, appends to transcript */
-    end(messageId: string): Promise<void>;
-    /** Drop an unstarted stream that produced no content. */
-    discard(messageId: string): void;
-};
-
-type PhaseRegistrySelection = Readonly<{
-    entryPhaseId: string | null;
-    phaseIds: readonly string[];
-}>;
-type AgentDefinition = Readonly<{
+/**
+ * Pre-initialization extension form — factory + metadata.
+ * Runner.loadExtensions() calls the factory and creates the full Extension object.
+ */
+interface LoadedExtension {
+    path: string;
     name: string;
-    description: string;
-    prompt: string;
-    tools?: readonly string[];
-    skills?: readonly string[];
-    /** Host-supplied Skills private to this Agent Definition/Bundle. */
-    bundledSkills?: readonly Skill[];
-    phases?: PhaseRegistrySelection;
-    contexts?: readonly string[];
-    model?: ModelRef;
-}>;
-/** Parse one Markdown definition using the same frontmatter vocabulary as Phase resources. */
-declare function parseAgentDefinition(raw: string): AgentDefinition;
-
-type ResourceKind = "agent" | "tool" | "skill" | "phase";
-type ResourceSourceId = string;
-/** Rowan-native contribution aliases. Hosts may adapt their domain handlers to
- * these existing Tool/Phase lifecycles without importing host Scope types. */
-type ToolContribution = Tool$1;
-type PhaseContribution = Phase;
-type ResourceView = Readonly<{
-    agents: readonly ResourceSourceId[];
-    tools: readonly ResourceSourceId[];
-    skills: readonly ResourceSourceId[];
-    phases: readonly ResourceSourceId[];
-}>;
-type ResourceRef = Readonly<{
-    kind: ResourceKind;
-    sourceId: ResourceSourceId;
-    name: string;
-}>;
-type ResourceDiagnostic = Readonly<{
-    kind: "invalid" | "missing" | "collision";
-    sourceId: ResourceSourceId;
-    message: string;
-    path?: string;
-}>;
-type LoadResult = Readonly<{
-    revision: string;
-    registered: readonly ResourceRef[];
-    skipped: readonly ResourceDiagnostic[];
-}>;
-type LoadInput<T> = Readonly<{
-    sourceId: ResourceSourceId;
-    directory?: string;
-    values?: readonly T[];
-}>;
-type ResolvedResourceView = Readonly<{
-    agents: readonly AgentDefinition[];
-    tools: readonly Tool$1[];
-    skills: readonly Skill[];
-    phases: readonly Phase[];
-    revisions: Readonly<Record<ResourceKind, readonly string[]>>;
-    refs: Readonly<Record<ResourceKind, readonly ResourceRef[]>>;
-}>;
-type ResourceRegistryErrorCode = "invalid_source_id" | "invalid_resource_name" | "resource_collision" | "resource_input_missing" | "resource_directory_not_supported" | "unknown_resource_source" | "implicit_source_protected";
-declare class ResourceRegistryError extends Error {
-    readonly code: ResourceRegistryErrorCode;
-    constructor(code: ResourceRegistryErrorCode, message: string);
-}
-type RegistryValue = AgentDefinition | Tool$1 | Skill | Phase;
-/**
- * Runtime Resource Registry source transaction and view resolver.
- *
- * Directory normalization is intentionally added by the typed loader slice;
- * this first module owns only the atomic source/revision/collision semantics.
- */
-declare class ResourceRegistry {
-    private readonly sources;
-    /** Sources registered by the bootstrap boundary (currently Extensions). */
-    private readonly implicitSources;
-    private revisionSequence;
-    loadAgents(input: LoadInput<AgentDefinition>): Promise<LoadResult>;
-    loadSkills(input: LoadInput<Skill>): Promise<LoadResult>;
-    loadPhases(input: LoadInput<Phase>): Promise<LoadResult>;
-    loadTools(input: Readonly<{
-        sourceId: ResourceSourceId;
-        values: readonly ToolContribution[];
-    }>): Promise<LoadResult>;
-    unload(input: Readonly<{
-        kind: ResourceKind;
-        sourceId: ResourceSourceId;
-    }>): Promise<LoadResult>;
-    resolveView(view: ResourceView): ResolvedResourceView;
-    /** Mark one already-loaded source as implicit for every Resource View. */
-    protected markImplicit(kind: ResourceKind, sourceId: ResourceSourceId): void;
-    /** Bootstrap-only helper for replacing an implicit contribution source. */
-    protected replaceImplicit<T extends RegistryValue>(kind: ResourceKind, sourceId: ResourceSourceId, values: readonly T[]): Promise<LoadResult>;
-    protected hasImplicit(kind: ResourceKind, sourceId: ResourceSourceId): boolean;
-    private withImplicit;
-    private collect;
-    private commit;
-    private resolveKind;
-    private resolveRevisions;
-    private resolveRefs;
-    private sourcesFor;
-    private nextRevision;
-}
+    factory: ExtensionFactory;
+    manifest?: ExtensionManifest;
+}
+/** Extension manifest from package.json `rowan` field. */
+interface ExtensionManifest {
+    entry?: string;
+    name?: string;
+}
 
 /**
  * EventBus — simple pub/sub for inter-extension communication.
@@ -794,6 +451,79 @@ interface ExtensionUtils {
     formatJson(value: unknown): string;
 }
 
+/**
+ * Extension API object passed to extension factory function.
+ *
+ * @example
+ * ```typescript
+ * export default function(api: ExtensionAPI) {
+ *   // api provides all extension APIs
+ * }
+ * ```
+ */
+interface ExtensionAPI {
+    /**
+     * Subscribe to a hook event.
+     *
+     * @param eventType - Hook type, e.g. "before_tool_call"
+     * @param handler - Hook handler, can return result to modify behavior
+     */
+    on<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
+    /** Unsubscribe from a hook event. */
+    off<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
+    /** Tool capabilities — register and unregister custom tools. */
+    tool: {
+        /** Register a custom LLM-callable tool. */
+        register(tool: ToolDefinition): void;
+        /** Unregister a previously registered tool by name. */
+        unregister(toolName: string): void;
+    };
+    /** Register a model provider. */
+    registerProvider(config: _rowan_agent_models.ProviderConfig): void;
+    /** Unregister a model provider. */
+    unregisterProvider(name: string): void;
+    /** Extension manifest from package.json `rowan` field. */
+    manifest?: ExtensionManifest;
+    /** Utility functions. */
+    utils: ExtensionUtils;
+    /** Runtime context — cwd, signal, exec, message access, etc. */
+    context: ExtensionContext;
+    /** Shared event bus for inter-extension communication. */
+    events: EventBus;
+    /** Phase execution capabilities — provides Phase In/Out, phase identity, phase routing, and registration. */
+    phase: {
+        /** Register a Phase directory bundle or Phase object. */
+        register(phase: PhaseRegistration): Promise<void>;
+        /** Unregister a previously registered phase by name. */
+        unregister(phaseName: string): void;
+        /** Phase In: get payload from previous phase */
+        getPayload(): unknown;
+        /** Phase Out: set payload for next phase */
+        setPayload(payload: unknown): void;
+        /** Phase Out: set outcome message */
+        setMessage(message: string): void;
+        /** Get current phase name */
+        getCurrentPhase(): string;
+        /** Set next phase (lower priority than PHASE.md target) */
+        setNextPhase(phaseName: string): void;
+        /** Get the next phase set by setNextPhase */
+        getNextPhase(): string | undefined;
+        /** Get the message set by setMessage */
+        getMessage(): string | undefined;
+        /** Phase Settings contributions registered by the Phase extension. */
+        settings: {
+            register(provider: PhaseSettingsProvider): void;
+        };
+    };
+}
+/**
+ * Extension factory function.
+ * Receives ExtensionAPI for registering hooks, phases, and providers.
+ */
+type ExtensionDisposer = () => void | Promise<void>;
+type ExtensionFactoryResult = void | ExtensionDisposer;
+type ExtensionFactory = (api: ExtensionAPI) => ExtensionFactoryResult | Promise<ExtensionFactoryResult>;
+
 /**
  * Extension runner — manages extension loading and hook execution.
  *
@@ -1111,7 +841,7 @@ type Tool$1 = Readonly<{
     core?: boolean;
     description: string;
     parameters: Type.TSchema;
-    execute(args: JsonValue, context: ToolInvocationContext, signal: AbortSignal): Promise<ToolExecutionResult$1>;
+    execute(args: JsonValue, context: ToolInvocationContext, signal: AbortSignal): Promise<ToolExecutionResult>;
 }>;
 type ContextCandidate = Readonly<{
     name: string;
@@ -1134,10 +864,10 @@ type BeforeToolCall = (input: Readonly<{
 }>) => BeforeToolCallDecision | Promise<BeforeToolCallDecision>;
 type AfterToolCall = (input: Readonly<{
     tool: Tool$1;
-    result: ToolExecutionResult$1;
+    result: ToolExecutionResult;
     context: ToolInvocationContext;
     signal: AbortSignal;
-}>) => ToolExecutionResult$1 | Promise<ToolExecutionResult$1>;
+}>) => ToolExecutionResult | Promise<ToolExecutionResult>;
 type InvocationSource = "auto" | "implicit" | "external";
 type InvocationCatalogEntry = Readonly<{
     kind: "phase" | "skill";
@@ -1198,6 +928,10 @@ type ToolBatchCommit = Readonly<{
     run: RunRecord;
     toolCalls: readonly ToolCallSnapshot[];
 }>;
+type EntryPhaseSpec = Readonly<{
+    phase: string;
+    payload?: JsonValue;
+}>;
 type RunRecord = Readonly<{
     id: RunId;
     agentId: AgentId;
@@ -1213,6 +947,7 @@ type RunRecord = Readonly<{
     }>;
     metadata?: Metadata;
     phasePayload?: JsonValue;
+    entryPhases?: readonly EntryPhaseSpec[];
     pinnedConfigToken?: ConfigToken;
     checkpoint?: ExecutionCheckpoint;
     currentPhaseId?: string;
@@ -1271,6 +1006,7 @@ type RunSnapshotBase = Readonly<{
     metadata?: Metadata;
     /** Effective entry Phase payload the Run started with (defaults filled). */
     phasePayload?: JsonValue;
+    entryPhases?: readonly EntryPhaseSpec[];
     messageCount: number;
     toolCallCount: number;
     currentPhaseId?: string;
@@ -1378,6 +1114,7 @@ interface OwnedStore {
         input: UserInput;
         metadata?: Metadata;
         phasePayload?: JsonValue;
+        entryPhases?: readonly EntryPhaseSpec[];
         pinnedConfigToken?: ConfigToken;
         idempotencyKey: string;
     }): Promise<RunRecord>;
@@ -1462,7 +1199,7 @@ interface OwnedStore {
         execution: ExecutionToken;
         expectedRevision: number;
         toolCallId: ToolCallId;
-        result: ToolExecutionResult$1;
+        result: ToolExecutionResult;
         state: "completed" | "failed" | "indeterminate";
         reason?: string;
     }): Promise<ToolCommit>;
@@ -1560,6 +1297,7 @@ interface AgentRuntime$1 {
         idempotencyKey: string;
         metadata?: Metadata;
         phasePayload?: JsonValue;
+        entryPhases?: ReadonlyArray<EntryPhaseSpec>;
     }): Promise<AgentRun>;
     run(runId: RunId): AgentRun;
     contextStatus(agentId: AgentId, options?: {
@@ -1598,201 +1336,472 @@ type ConsumerRegistration = Readonly<{
     waterline: EventCursor;
 }>;
 
-interface SourceInfo {
-    source: string;
-    baseDir?: string;
-    displayName?: string;
-}
-/** Register a Phase by directory path or Phase object; PHASE.md and direct child Skills are loaded atomically when a path is supplied. */
-type PhaseRegistration = string | Phase;
-/**
- * Tool definition for registering LLM-callable tools via `api.tool.register()`.
- *
- * @example
- * ```typescript
- * api.tool.register({
- *   name: "search_docs",
- *   description: "Search documentation",
- *   parameters: { type: "object", properties: { query: { type: "string" } } },
- *   execute: async (args, ctx) => {
- *     return { content: [{ type: "text", text: "result" }] };
- *   },
- * });
- * ```
- */
-interface ToolDefinition {
-    /** Tool name (used in LLM tool calls) */
-    name: string;
-    /** Description for LLM */
-    description: string;
-    /** Parameter schema (JSON Schema) */
-    parameters: Record<string, unknown>;
-    /** Execute the tool */
-    execute: (args: unknown, context: ToolInvocationContext, signal?: AbortSignal) => Promise<ToolExecutionResult>;
-    /** Optional: per-tool execution mode override */
-    executionMode?: "sequential" | "parallel";
-}
-/**
- * Result from tool execution.
- */
-interface ToolExecutionResult {
-    /** Content blocks to return to the LLM */
-    content: Array<{
-        type: string;
-        text?: string;
-        [key: string]: unknown;
+type LoopMetrics = {
+    /** Number of phase iterations executed. */
+    iterations: number;
+    /** Phase transition history. */
+    phaseTransitions: Array<{
+        from: string;
+        to: string;
+        ts: string;
     }>;
-    /** Whether this is an error result */
-    isError?: boolean;
-}
-/**
- * Registered tool with source metadata.
- */
-interface RegisteredTool {
-    definition: ToolDefinition;
-    sourceInfo: SourceInfo;
-}
-/**
- * Structured extension error with attribution.
- */
-interface ExtensionError {
-    /** Path of the extension that caused the error */
-    extensionPath: string;
-    /** Event or operation that caused the error */
-    event: string;
-    /** Error message */
-    error: string;
-    /** Optional stack trace */
-    stack?: string;
-}
-/** Error listener callback type. */
-type ExtensionErrorListener = (error: ExtensionError) => void;
-type ExecOptions = {
-    /** Working directory for the command. Defaults to cwd passed to runtime. */
-    cwd?: string;
-    /** Environment variables to add/override. */
-    env?: Record<string, string>;
-    /** Timeout in milliseconds. */
-    timeout?: number;
-    /** AbortSignal for cancellation. */
-    signal?: AbortSignal;
+    /** Number of times compaction was triggered. */
+    compactionCount: number;
+    /** Number of retry attempts due to transient errors. */
+    retryCount: number;
+    /** Loop start timestamp. */
+    startedAt: string;
+    /** Loop start time as epoch ms (for duration calculation). */
+    startedAtMs: number;
+    /** Loop end timestamp (set on completion). */
+    endedAt?: string;
+    /** Total wall-clock duration in ms. */
+    durationMs?: number;
 };
-type ExecResult = {
-    exitCode: number;
-    stdout: string;
-    stderr: string;
+type ExecutionState = {
+    currentPhase: string;
+    attempt: number;
+    metrics: LoopMetrics;
+    status: "idle" | "running" | "suspended" | "completed" | "aborted" | "failed";
+    initialPhasePayload?: JsonValue;
+    entryPhases?: readonly EntryPhaseSpec[];
+    continuation?: ExecutionContinuationState;
+    runInteractions?: RunInteractionState;
+    phaseInteractions?: RunInteractionState;
 };
-/**
- * Shared runtime state created by loader, used during registration and runtime.
- * All ExtensionAPI instances reference this shared state.
- *
- * It only owns the lifetime guard shared by captured Extension API objects.
- */
-interface ExtensionRuntime {
-    /** Throws when this extension instance is stale after runtime replacement. */
-    assertActive: () => void;
-    /** Marks this extension instance as stale after runtime replacement or reload. */
-    invalidate: (message?: string) => void;
-}
-/**
- * Result of loading extensions from filesystem.
- * The runner takes these and creates Extension tracking objects.
- */
-type LoadExtensionsResult = {
-    extensions: LoadedExtension[];
-    errors: Array<{
-        path: string;
-        error: string;
+type ExecutionContinuationState = {
+    isContinuing: boolean;
+    previousPayload?: unknown;
+    previousResults: Array<{
+        name: string;
+        output?: unknown;
     }>;
+    pendingInstruction?: string;
+    previousPhaseMessageId?: string;
 };
-/**
- * Pre-initialization extension form — factory + metadata.
- * Runner.loadExtensions() calls the factory and creates the full Extension object.
- */
-interface LoadedExtension {
-    path: string;
-    name: string;
-    factory: ExtensionFactory;
-    manifest?: ExtensionManifest;
+
+type RunInteractionKind = "user_input" | "permission" | "elicitation" | "confirmation";
+type RunInteractionStatus = "pending" | "answered" | "replied" | "cancelled";
+type RunInteraction = Readonly<{
+    id: string;
+    phase: string;
+    kind: RunInteractionKind;
+    prompt: string;
+    payload?: JsonValue;
+    createdAt: string;
+    status: RunInteractionStatus;
+    answer?: JsonValue;
+    reply?: string;
+    /** The Run is only waiting for the next user message, not asking a question. */
+    turnBoundary?: true;
+    toolCallId?: string;
+    result?: Readonly<{
+        answered?: string;
+        replied?: string;
+        cancelled?: string;
+    }>;
+}>;
+type RunInteractionRequest = Readonly<{
+    id?: string;
+    kind: RunInteractionKind;
+    prompt: string;
+    payload?: JsonValue;
+    toolCallId?: string;
+    result?: Readonly<{
+        answered?: string;
+        replied?: string;
+        cancelled?: string;
+    }>;
+}>;
+type RunInteractionState = Readonly<{
+    requests: readonly RunInteraction[];
+    answers: Readonly<Record<string, JsonValue>>;
+    checkpoint?: JsonValue;
+}>;
+type RunInteractionDriver = Readonly<{
+    signal: AbortSignal;
+    request(input: RunInteractionRequest): RunInteraction;
+    pending(): readonly RunInteraction[];
+    answers(): ReadonlyMap<string, JsonValue>;
+    checkpoint(): JsonValue | undefined;
+    clearCheckpoint(): void;
+    suspend(input?: Readonly<{
+        checkpoint?: JsonValue;
+    }>): never;
+}>;
+declare class RunInteractionCancelledError extends Error {
+    readonly code: "run_interaction_cancelled";
+    constructor();
 }
-/** Extension manifest from package.json `rowan` field. */
-interface ExtensionManifest {
-    entry?: string;
-    name?: string;
+declare class RunInteractionBoundary extends Error {
+    readonly state: ExecutionState;
+    readonly interactions: readonly RunInteraction[];
+    constructor(state: ExecutionState, interactions: readonly RunInteraction[]);
 }
 
-/**
- * Extension API object passed to extension factory function.
- *
- * @example
- * ```typescript
- * export default function(api: ExtensionAPI) {
- *   // api provides all extension APIs
- * }
- * ```
- */
-interface ExtensionAPI {
-    /**
-     * Subscribe to a hook event.
-     *
-     * @param eventType - Hook type, e.g. "before_tool_call"
-     * @param handler - Hook handler, can return result to modify behavior
-     */
-    on<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
-    /** Unsubscribe from a hook event. */
-    off<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
-    /** Tool capabilities — register and unregister custom tools. */
-    tool: {
-        /** Register a custom LLM-callable tool. */
-        register(tool: ToolDefinition): void;
-        /** Unregister a previously registered tool by name. */
-        unregister(toolName: string): void;
-    };
-    /** Register a model provider. */
-    registerProvider(config: _rowan_agent_models.ProviderConfig): void;
-    /** Unregister a model provider. */
-    unregisterProvider(name: string): void;
-    /** Extension manifest from package.json `rowan` field. */
-    manifest?: ExtensionManifest;
-    /** Utility functions. */
-    utils: ExtensionUtils;
-    /** Runtime context — cwd, signal, exec, message access, etc. */
-    context: ExtensionContext;
-    /** Shared event bus for inter-extension communication. */
-    events: EventBus;
-    /** Phase execution capabilities — provides Phase In/Out, phase identity, phase routing, and registration. */
-    phase: {
-        /** Register a Phase directory bundle or Phase object. */
-        register(phase: PhaseRegistration): Promise<void>;
-        /** Unregister a previously registered phase by name. */
-        unregister(phaseName: string): void;
-        /** Phase In: get payload from previous phase */
-        getPayload(): unknown;
-        /** Phase Out: set payload for next phase */
-        setPayload(payload: unknown): void;
-        /** Phase Out: set outcome message */
-        setMessage(message: string): void;
-        /** Get current phase name */
-        getCurrentPhase(): string;
-        /** Set next phase (lower priority than PHASE.md target) */
-        setNextPhase(phaseName: string): void;
-        /** Get the next phase set by setNextPhase */
-        getNextPhase(): string | undefined;
-        /** Get the message set by setMessage */
-        getMessage(): string | undefined;
-        /** Phase Settings contributions registered by the Phase extension. */
-        settings: {
-            register(provider: PhaseSettingsProvider): void;
-        };
-    };
-}
-/**
- * Extension factory function.
- * Receives ExtensionAPI for registering hooks, phases, and providers.
- */
-type ExtensionDisposer = () => void | Promise<void>;
-type ExtensionFactoryResult = void | ExtensionDisposer;
-type ExtensionFactory = (api: ExtensionAPI) => ExtensionFactoryResult | Promise<ExtensionFactoryResult>;
+declare const opaqueIdBrand: unique symbol;
+type OpaqueId<Kind extends string> = string & {
+    readonly [opaqueIdBrand]: Kind;
+};
+type AgentId = OpaqueId<"AgentId">;
+type RunId = OpaqueId<"RunId">;
+type MessageId = OpaqueId<"MessageId">;
+type ToolCallId = OpaqueId<"ToolCallId">;
+type EventId = OpaqueId<"EventId">;
+type ExecutionId = OpaqueId<"ExecutionId">;
+type OutcomeId = OpaqueId<"OutcomeId">;
+type ConfigToken = OpaqueId<"ConfigToken">;
+type OwnerToken = OpaqueId<"OwnerToken">;
+type EventCursor = OpaqueId<"EventCursor">;
+type AgentListCursor = OpaqueId<"AgentListCursor">;
+type RunListCursor = OpaqueId<"RunListCursor">;
+type JsonPrimitive = null | boolean | number | string;
+type JsonValue = JsonPrimitive | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+type JsonObject = Readonly<Record<string, JsonValue>>;
+type Metadata = JsonObject;
+type TextContent = Readonly<{
+    type: "text";
+    text: string;
+}>;
+type ImageContent = Readonly<{
+    type: "image";
+    data: string;
+    mimeType: string;
+}>;
+type ThinkingContent = Readonly<{
+    type: "thinking";
+    thinking: string;
+    signature?: string;
+}>;
+type ToolUseContent = Readonly<{
+    type: "tool_use";
+    toolCallId: ToolCallId;
+    /** Provider/model correlation, retained only to reconstruct the next request. */
+    providerToolCallId?: string;
+    name: string;
+    input: JsonValue;
+}>;
+type ToolExecutionResult = Readonly<{
+    ok: true;
+    content: JsonValue;
+}> | Readonly<{
+    ok: false;
+    content: JsonValue;
+    error: string;
+}>;
+type DurableToolResult = Readonly<{
+    toolCallId: ToolCallId;
+    toolName: string;
+}> & ToolExecutionResult;
+type ToolResultContent = Readonly<{
+    type: "tool_result";
+    toolCallId: ToolCallId;
+    /** Provider/model correlation, retained only to reconstruct the next request. */
+    providerToolCallId?: string;
+    result: ToolExecutionResult;
+}>;
+type UserContent = string | readonly (TextContent | ImageContent)[];
+type AssistantContent = string | readonly (TextContent | ThinkingContent | ToolUseContent)[];
+type ToolMessageContent = readonly [ToolResultContent, ...ToolResultContent[]];
+type MessageContent = UserContent | AssistantContent | ToolMessageContent;
+type MessageBase = Readonly<{
+    id: MessageId;
+    agentId: AgentId;
+    runId: RunId;
+    /** Monotonic active revision. Omitted on legacy/initial messages and read as 0. */
+    messageRevision?: number;
+    metadata?: Metadata;
+    sequenceWithinRun: number;
+    createdAt: string;
+}>;
+type UserMessage = MessageBase & Readonly<{
+    role: "user";
+    content: UserContent;
+}>;
+type AssistantMessage = MessageBase & Readonly<{
+    role: "assistant";
+    content: AssistantContent;
+    interrupted?: boolean;
+}>;
+type ToolMessage = MessageBase & Readonly<{
+    role: "tool";
+    content: ToolMessageContent;
+}>;
+type InteractionRecord = MessageBase & Readonly<{
+    role: "interaction";
+    interactionId: string;
+    kind: "user_input" | "permission" | "elicitation" | "confirmation";
+    prompt: string;
+    phase: string;
+    status: "answered" | "replied" | "cancelled";
+    answer?: JsonValue;
+    reply?: string;
+    toolCallId?: ToolCallId;
+    result?: Readonly<{
+        answered?: string;
+        replied?: string;
+        cancelled?: string;
+    }>;
+}>;
+type Message = UserMessage | AssistantMessage | ToolMessage | InteractionRecord;
+type Outcome = Readonly<{
+    id: OutcomeId;
+    message: string;
+    payload?: JsonValue;
+    toolResults?: readonly DurableToolResult[];
+}>;
+type RunState = "queued" | "running" | "input_required" | "completed" | "failed" | "cancelled";
+type RunFailure = Readonly<{
+    code: "configuration_unavailable";
+    message: string;
+}> | Readonly<{
+    code: "checkpoint_incompatible";
+    message: string;
+    expected: Readonly<{
+        codec: string;
+        versions: readonly number[];
+    }>;
+    actual: Readonly<{
+        codec: string;
+        version: number;
+    }>;
+}> | Readonly<{
+    code: "runtime_interrupted";
+    message: string;
+    ownerEpoch: number;
+}> | Readonly<{
+    code: "tool_indeterminate";
+    message: string;
+    toolCallIds: readonly [ToolCallId, ...ToolCallId[]];
+}> | Readonly<{
+    code: "execution_failed";
+    message: string;
+    details?: JsonValue;
+}>;
+type QueuedRunFailure = Extract<RunFailure, {
+    code: "configuration_unavailable" | "checkpoint_incompatible";
+}>;
+type RunningRunFailure = Extract<RunFailure, {
+    code: "runtime_interrupted" | "tool_indeterminate" | "execution_failed";
+}>;
+type ToolCallState = "pending" | "running" | "completed" | "failed" | "indeterminate";
+type ToolCallSnapshotBase = Readonly<{
+    id: ToolCallId;
+    providerToolCallId: string;
+    agentId: AgentId;
+    runId: RunId;
+    executionId: ExecutionId;
+    requestMessageId: MessageId;
+    name: string;
+    args: JsonValue;
+    createdAt: string;
+    updatedAt: string;
+}>;
+type ToolCallSnapshot = ToolCallSnapshotBase & (Readonly<{
+    state: "pending";
+}> | Readonly<{
+    state: "running";
+}> | Readonly<{
+    state: "completed";
+    result: DurableToolResult & Readonly<{
+        ok: true;
+    }>;
+    resultMessageId: MessageId;
+}> | Readonly<{
+    state: "failed";
+    result: DurableToolResult & Readonly<{
+        ok: false;
+    }>;
+    resultMessageId: MessageId;
+}> | Readonly<{
+    state: "indeterminate";
+    result: DurableToolResult & Readonly<{
+        ok: false;
+    }>;
+    resultMessageId: MessageId;
+    reason: string;
+}>);
+type DurableEventBase = Readonly<{
+    id: EventId;
+    schemaVersion: 1;
+    cursor: EventCursor;
+    durability: "durable";
+    agentId: AgentId;
+    runId: RunId;
+    runRevision: number;
+    metadata?: Metadata;
+    createdAt: string;
+}>;
+type PhaseEntered = DurableEventBase & Readonly<{
+    kind: "phase_entered";
+    executionId: ExecutionId;
+    phaseId: string;
+    visit: number;
+}>;
+type MessageCommitted = DurableEventBase & Readonly<{
+    kind: "message_committed";
+    message: Message;
+}>;
+type MessageRevised = DurableEventBase & Readonly<{
+    kind: "message_revised";
+    message: UserMessage;
+    previousRevision: number;
+    invalidatedRunIds: readonly RunId[];
+    targetRunId: RunId;
+    cutoffSequenceWithinRun: number;
+}>;
+type RunStateChanged = DurableEventBase & (Readonly<{
+    kind: "run_state_changed";
+    from: null;
+    to: "queued";
+}> | Readonly<{
+    kind: "run_state_changed";
+    from: "input_required";
+    to: "queued";
+}> | Readonly<{
+    kind: "run_state_changed";
+    from: "queued";
+    to: "running";
+}> | Readonly<{
+    kind: "run_state_changed";
+    from: "running";
+    to: "input_required";
+    interactions: readonly RunInteraction[];
+    answers: Readonly<Record<string, JsonValue>>;
+}> | Readonly<{
+    kind: "run_state_changed";
+    from: "running";
+    to: "completed";
+    outcome: Outcome;
+    output?: AssistantMessage;
+}> | Readonly<{
+    kind: "run_state_changed";
+    from: "queued";
+    to: "failed";
+    failure: QueuedRunFailure;
+}> | Readonly<{
+    kind: "run_state_changed";
+    from: "running";
+    to: "failed";
+    failure: RunningRunFailure;
+}> | Readonly<{
+    kind: "run_state_changed";
+    from: "queued" | "running" | "input_required";
+    to: "cancelled";
+    reason?: string;
+}>);
+type ToolStateChanged = DurableEventBase & (Readonly<{
+    kind: "tool_state_changed";
+    transition: Readonly<{
+        from: null;
+        to: "pending";
+    }>;
+    toolCall: Extract<ToolCallSnapshot, {
+        state: "pending";
+    }>;
+}> | Readonly<{
+    kind: "tool_state_changed";
+    transition: Readonly<{
+        from: "pending";
+        to: "running";
+    }>;
+    toolCall: Extract<ToolCallSnapshot, {
+        state: "running";
+    }>;
+}> | Readonly<{
+    kind: "tool_state_changed";
+    transition: Readonly<{
+        from: "pending";
+        to: "failed";
+    }>;
+    toolCall: Extract<ToolCallSnapshot, {
+        state: "failed";
+    }>;
+}> | Readonly<{
+    kind: "tool_state_changed";
+    transition: Readonly<{
+        from: "running";
+        to: "pending";
+    }>;
+    toolCall: Extract<ToolCallSnapshot, {
+        state: "pending";
+    }>;
+}> | Readonly<{
+    kind: "tool_state_changed";
+    transition: Readonly<{
+        from: "running";
+        to: "pending";
+    }>;
+    toolCall: Extract<ToolCallSnapshot, {
+        state: "pending";
+    }>;
+}> | Readonly<{
+    kind: "tool_state_changed";
+    transition: Readonly<{
+        from: "running";
+        to: "completed";
+    }>;
+    toolCall: Extract<ToolCallSnapshot, {
+        state: "completed";
+    }>;
+}> | Readonly<{
+    kind: "tool_state_changed";
+    transition: Readonly<{
+        from: "running";
+        to: "failed";
+    }>;
+    toolCall: Extract<ToolCallSnapshot, {
+        state: "failed";
+    }>;
+}> | Readonly<{
+    kind: "tool_state_changed";
+    transition: Readonly<{
+        from: "running";
+        to: "indeterminate";
+    }>;
+    toolCall: Extract<ToolCallSnapshot, {
+        state: "indeterminate";
+    }>;
+}>);
+type DurableRunEvent = PhaseEntered | MessageCommitted | MessageRevised | RunStateChanged | ToolStateChanged;
+type MessageDelta = Readonly<{
+    kind: "message_delta";
+    durability: "transient";
+    runId: RunId;
+    executionId: ExecutionId;
+    messageId: MessageId;
+    offset: number;
+    text: string;
+}>;
+type ThinkingDelta = Readonly<{
+    kind: "thinking_delta";
+    durability: "transient";
+    runId: RunId;
+    executionId: ExecutionId;
+    messageId: MessageId;
+    blockIndex: number;
+    offset: number;
+    text: string;
+}>;
+type ToolProgress = Readonly<{
+    kind: "tool_progress";
+    durability: "transient";
+    runId: RunId;
+    executionId: ExecutionId;
+    toolCallId: ToolCallId;
+    progress: JsonValue;
+}>;
+type PhaseStatusEvent = Readonly<{
+    kind: "phase_status";
+    durability: "transient";
+    runId: RunId;
+    executionId: ExecutionId;
+    phaseId: string;
+    status: PhaseStatus;
+}>;
+type RunEvent = DurableRunEvent | MessageDelta | ThinkingDelta | ToolProgress | PhaseStatusEvent;
 
 type PhaseStatusState = "running" | "completed";
 /** Normalized status event exposed to Runtime consumers. */
@@ -2197,6 +2206,7 @@ declare class AgentRuntime implements AgentRuntime$1 {
         idempotencyKey: string;
         metadata?: Metadata;
         phasePayload?: JsonValue;
+        entryPhases?: ReadonlyArray<EntryPhaseSpec>;
     }): Promise<AgentRun>;
     run(runId: RunId): AgentRun;
     listAgents(input?: {
@@ -2333,6 +2343,7 @@ declare class InMemoryStore implements DurableStore {
         input: UserInput;
         metadata?: Metadata;
         phasePayload?: JsonValue;
+        entryPhases?: readonly EntryPhaseSpec[];
         pinnedConfigToken?: ConfigToken;
         idempotencyKey: string;
     }): RunRecord;
@@ -2411,7 +2422,7 @@ declare class InMemoryStore implements DurableStore {
         execution: ExecutionToken;
         expectedRevision: number;
         toolCallId: ToolCallId;
-        result: ToolExecutionResult$1;
+        result: ToolExecutionResult;
         state: "completed" | "failed" | "indeterminate";
         reason?: string;
     }): ToolCommit;
@@ -2535,6 +2546,7 @@ declare class SqliteStore implements DurableStore {
         input: UserInput;
         metadata?: Metadata;
         phasePayload?: JsonValue;
+        entryPhases?: readonly EntryPhaseSpec[];
         pinnedConfigToken?: ConfigToken;
         idempotencyKey: string;
     }): Promise<RunRecord>;
@@ -2625,7 +2637,7 @@ declare class SqliteStore implements DurableStore {
         execution: ExecutionToken;
         expectedRevision: number;
         toolCallId: ToolCallId;
-        result: ToolExecutionResult$1;
+        result: ToolExecutionResult;
         state: "completed" | "failed" | "indeterminate";
         reason?: string;
     }): Promise<ToolCommit>;
@@ -2865,4 +2877,4 @@ declare function parseFrontmatter<T = Record<string, unknown>>(raw: string): Fro
 
 declare function createCoreTools(input?: CoreToolContext): Tool$1[];
 
-export { type AfterToolCall, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, type AgentRun, AgentRuntime, type AgentRuntimeOptions, type AgentSummary, type AnyRuntimeError, type AssistantContent, type AssistantMessage, type BeforeToolCall, COMPACT_PHASE_ID, type ConfigProvider, type ConfigPutResult, type ConfigResolution, type ConfigToken, type ConfigurationSnapshot, type ContextCandidate, type ContextCompactionRecord, type ContextStatus, type CoreToolContext, DEFAULT_PHASE_ID, type DefinitionLayer, type DurableConsumer, type DurableRunEvent, type DurableStore, type DurableToolResult, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionActivationError, type ExtensionActivationResult, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, InMemoryConfigProvider, InMemoryStore, type InteractionRecord, type InvocationCatalogEntry, type InvocationSource, type JsonObject, type JsonPrimitive, type JsonValue, type LoadExtensionsResult, type LoadInput, type LoadResult, type LoadedExtension, type Message, type MessageBase, type MessageCommitted, type MessageContent, type MessageDelta, type MessageId, type MessageRevised, type MessageRevisionResult, type Metadata, type OpaqueId, type Outcome, type OwnerLease, type OwnerToken, type Page, type Phase, type PhaseContext, type PhaseContribution, type PhaseExecution, type PhaseExecutionIdentity, type PhaseInput, type PhaseInvocation, type PhaseMessageManager, type PhaseOutput, type PhaseRegistry, type PhaseRegistrySelection, type PhaseSettingsBadge, type PhaseSettingsContext, type PhaseSettingsControl, type PhaseSettingsDefinition, type PhaseSettingsItem, type PhaseSettingsOption, type PhaseSettingsProvider, type PhaseSettingsSection, type PhaseState, type PhaseStatus, type PhaseStatusState, type ResolvedResourceView, type ResourceDiagnostic, type ResourceKind, type ResourceRef, ResourceRegistry, ResourceRegistryError, type ResourceRegistryErrorCode, type ResourceSourceId, type ResourceView, type RetentionResult, type RunBoundary, type RunClaim, type RunEvent, type RunFailure, type RunId, type RunInteraction, RunInteractionBoundary, RunInteractionCancelledError, type RunInteractionDriver, type RunInteractionKind, type RunInteractionRequest, type RunInteractionState, type RunInteractionStatus, type RunListCursor, type RunRecord, type RunSnapshot, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, STOP_PHASE_ID, type Skill, SqliteStore, type TextContent, type ThinkingContent, type ThinkingDelta, type Tool$1 as Tool, type ToolCallContext, type ToolCallId, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult$1 as ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolProgress, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UserContent, type UserInput, type UserMessage, brandConfigToken, createCompactPhase, createCorePhases, createCoreTools, createDefaultPhase, createStopPhase, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhaseSettings, loadPhases, loadSkill, loadSkills, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };
+export { type AfterToolCall, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, type AgentRun, AgentRuntime, type AgentRuntimeOptions, type AgentSummary, type AnyRuntimeError, type AssistantContent, type AssistantMessage, type BeforeToolCall, COMPACT_PHASE_ID, type ConfigProvider, type ConfigPutResult, type ConfigResolution, type ConfigToken, type ConfigurationSnapshot, type ContextCandidate, type ContextCompactionRecord, type ContextStatus, type CoreToolContext, DEFAULT_PHASE_ID, type DefinitionLayer, type DurableConsumer, type DurableRunEvent, type DurableStore, type DurableToolResult, type EntryPhaseSpec, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionActivationError, type ExtensionActivationResult, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, InMemoryConfigProvider, InMemoryStore, type InteractionRecord, type InvocationCatalogEntry, type InvocationSource, type JsonObject, type JsonPrimitive, type JsonValue, type LoadExtensionsResult, type LoadInput, type LoadResult, type LoadedExtension, type Message, type MessageBase, type MessageCommitted, type MessageContent, type MessageDelta, type MessageId, type MessageRevised, type MessageRevisionResult, type Metadata, type OpaqueId, type Outcome, type OwnerLease, type OwnerToken, type Page, type Phase, type PhaseContext, type PhaseContribution, type PhaseExecution, type PhaseExecutionIdentity, type PhaseInput, type PhaseInvocation, type PhaseMessageManager, type PhaseOutput, type PhaseRegistry, type PhaseRegistrySelection, type PhaseSettingsBadge, type PhaseSettingsContext, type PhaseSettingsControl, type PhaseSettingsDefinition, type PhaseSettingsItem, type PhaseSettingsOption, type PhaseSettingsProvider, type PhaseSettingsSection, type PhaseState, type PhaseStatus, type PhaseStatusState, type ResolvedResourceView, type ResourceDiagnostic, type ResourceKind, type ResourceRef, ResourceRegistry, ResourceRegistryError, type ResourceRegistryErrorCode, type ResourceSourceId, type ResourceView, type RetentionResult, type RunBoundary, type RunClaim, type RunEvent, type RunFailure, type RunId, type RunInteraction, RunInteractionBoundary, RunInteractionCancelledError, type RunInteractionDriver, type RunInteractionKind, type RunInteractionRequest, type RunInteractionState, type RunInteractionStatus, type RunListCursor, type RunRecord, type RunSnapshot, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, STOP_PHASE_ID, type Skill, SqliteStore, type TextContent, type ThinkingContent, type ThinkingDelta, type Tool$1 as Tool, type ToolCallContext, type ToolCallId, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolProgress, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UserContent, type UserInput, type UserMessage, brandConfigToken, createCompactPhase, createCorePhases, createCoreTools, createDefaultPhase, createStopPhase, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhaseSettings, loadPhases, loadSkill, loadSkills, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };