@rowan-agent/agent 0.19.2 → 0.20.0

package/dist/index.d.ts

@@ -1,60 +1,53 @@
 import * as _rowan_agent_models from '@rowan-agent/models';
-import { LlmContentPart, ModelRef, ContentBlock, ScopeRef, ToolKind, ToolAnnotations, ToolCallStatus, ToolProgress, ToolCallContent, ToolCallLocation, JsonValue as JsonValue$1, JsonObject as JsonObject$1, ModelConfig, StreamFn, ThinkingLevel, ToolCall as ToolCall$1, ToolCallUpdate } from '@rowan-agent/models';
+import { ContentBlock, LlmContentPart, ModelRef, ScopeRef, ToolCallStatus, JsonValue as JsonValue$1, ToolProgress, ToolCallContent, ToolCallLocation, JsonObject as JsonObject$1, ToolKind, ModelConfig, StreamFn, ToolAnnotations, ThinkingLevel, ToolCall as ToolCall$1, ToolCallUpdate } from '@rowan-agent/models';
 export { ModelConfig, ModelRef, ProviderCallContext, ProviderConfig, ProviderModelConfig, ProviderStreamFn, ScopeRef, StreamFn, ThinkingLevel, ToolAnnotations, ToolCall, ToolCallContent, ToolCallLocation, ToolCallOptions, ToolCallOutcome, ToolCallStatus, ToolCallUpdate, ToolDefinitionSummary, ToolKind, ToolProgress } from '@rowan-agent/models';
 import Type from 'typebox';
 
-type AgentMessage = {
-    id: string;
-    role: "system" | "user" | "assistant" | "tool";
-    content: string | LlmContentPart[];
-    createdAt: string;
-    metadata?: Record<string, unknown> & {
-        phase?: string;
-    };
-};
-type Skill = {
-    name: string;
-    description: string;
-    /** Absolute path to the SKILL.md file */
-    filePath: string;
-    /** Directory containing the SKILL.md file */
-    baseDir: string;
-    /** Full body content of the SKILL.md (after frontmatter) */
-    content: string;
-    /** Do not automatically inject this Skill into the model Context. */
-    disableAutoInvocation?: boolean;
-    /** Do not expose this Skill to direct user invocation. */
-    disableImplicitInvocation?: boolean;
-    /** @deprecated Use disableAutoInvocation; kept only for old in-memory callers during cutover. */
-    disableModelInvocation?: boolean;
+type ModelInvokeOutput = {
+    text: string;
+    contentBlocks: ContentBlock[];
+    toolCalls: ToolCall[];
+    stopReason?: string;
 };
-type Outcome$1 = {
-    id: string;
-    message: string;
-    /** Publish this outcome's message as an assistant message before completing the run. */
-    display?: boolean;
+/** Snapshot of phase-level context for restore */
+type PhaseContextSnapshot = {
+    systemPrompt: string;
+    messages: AgentMessage[];
+    currentPhase: string;
+    availablePhases: string[];
+    turnNumber: number;
     payload?: unknown;
-    toolResults?: Array<{
-        toolCallId: string;
-        toolName: string;
-        ok: boolean;
-        content: unknown;
-        error?: string;
-    }>;
 };
-type ToolCall = {
-    id: string;
-    name: string;
-    args: 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;
 };
-type ToolResult = {
-    toolCallId: string;
-    toolName: string;
-    ok: boolean;
-    content: unknown;
-    error?: string;
-    structuredContent?: unknown;
-    isError?: boolean;
+/** 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<{
@@ -161,261 +154,45 @@ declare class ResourceRegistry {
     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;
-};
-
-type HostContribution = {
-    readonly kind: string;
-    readonly id: string;
-} & {
-    readonly [key: string]: JsonValue;
-};
-interface ExtensionStateStore {
-    get(key: string): Promise<JsonValue | undefined>;
-    set(key: string, value: JsonValue): Promise<void>;
-    delete(key: string): Promise<void>;
-}
-interface ExtensionHost {
-    getConfig(extensionId: string, scope?: ScopeRef): Promise<JsonObject | null> | JsonObject | null;
-    onConfigChanged?(listener: (extensionId: string, scope: ScopeRef) => void): (() => void) | void;
-    getAgentState(extensionId: string, agentId: string, key: string): Promise<JsonValue | undefined> | JsonValue | undefined;
-    setAgentState(extensionId: string, agentId: string, key: string, value: JsonValue): Promise<void> | void;
-    deleteAgentState(extensionId: string, agentId: string, key: string): Promise<void> | void;
-    getGlobalState(extensionId: string, key: string): Promise<JsonValue | undefined> | JsonValue | undefined;
-    setGlobalState(extensionId: string, key: string, value: JsonValue): Promise<void> | void;
-    deleteGlobalState(extensionId: string, key: string): Promise<void> | void;
-}
-type ExtensionToolContribution = {
-    kind: "tool";
-    name: string;
-    description: string;
-};
-type ExtensionCapabilityContribution = ExtensionToolContribution;
-type ExtensionCapability = {
-    extensionId: string;
-    kind: "tool";
-    name: string;
-    description: string;
-};
-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.tools.register()`.
+ * EventBus — simple pub/sub for inter-extension communication.
+ *
+ * Extensions can emit and subscribe to arbitrary events via `api.events`.
+ * This allows extensions to coordinate without direct coupling.
  *
  * @example
  * ```typescript
- * api.tools.register({
- *   name: "search_docs",
- *   description: "Search documentation",
- *   parameters: { type: "object", properties: { query: { type: "string" } } },
- *   execute: async (args, ctx) => {
- *     return { content: [{ type: "text", text: "result" }] };
- *   },
+ * // Extension A
+ * api.events.on("my-plugin:ready", (data) => {
+ *   console.log("Plugin ready:", data);
  * });
+ *
+ * // Extension B
+ * api.events.emit("my-plugin:ready", { version: "1.0" });
  * ```
  */
-interface ToolDefinition {
-    /** Tool name (used in LLM tool calls) */
-    name: string;
-    /** Description for LLM */
-    description: string;
-    /** Parameter schema (JSON Schema) */
-    parameters: Record<string, unknown>;
-    /** Optional: one-line snippet shown in the system prompt tool list */
-    promptSnippet?: string;
-    /** Optional: additional guidelines appended to system prompt */
-    promptGuidelines?: string[];
-    kind?: ToolKind;
-    annotations?: ToolAnnotations;
-    _meta?: JsonObject;
-    present?: (call: {
-        status: ToolCallStatus;
-        args: JsonValue;
-        progress?: ToolProgress;
-        result?: ToolExecutionResult;
-    }) => {
-        title?: string;
-        content?: ToolCallContent[];
-        locations?: ToolCallLocation[];
-        _meta?: JsonObject;
-    } | undefined | void | Promise<{
-        title?: string;
-        content?: ToolCallContent[];
-        locations?: ToolCallLocation[];
-        _meta?: JsonObject;
-    } | undefined | void>;
-    /** Execute the tool */
-    execute: (args: unknown, context: ToolInvocationContext, signal?: AbortSignal) => Promise<ToolExecutionResult>;
-    /** Optional: per-tool execution mode override */
-    executionMode?: "sequential" | "parallel";
+type Listener = (...args: unknown[]) => void;
+interface EventBus {
+    /** Subscribe to an event. Returns unsubscribe function. */
+    on(event: string, listener: Listener): () => void;
+    /** Emit an event to all subscribers. */
+    emit(event: string, ...args: unknown[]): void;
+    /** Remove all listeners for an event, or all listeners if no event specified. */
+    off(event?: string): void;
+    /** Check if there are listeners for an event. */
+    has(event: string): boolean;
+    /** Get listener count for an event. */
+    count(event: string): number;
 }
 
 /**
- * Registered tool with source metadata.
+ * @module extensions/context
+ *
+ * Extension context types — runtime state and phase execution context.
+ *
+ * For ExtensionAPI and createExtensionAPI, see ./api.ts
  */
-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;
-    }>;
-};
-/**
- * Pre-initialization extension form — factory + metadata.
- * Runner.loadExtensions() calls the factory and creates the full Extension object.
- */
-interface LoadedExtension {
-    id?: string;
-    path: string;
-    name: string;
-    factory: ExtensionFactory;
-    manifest?: ExtensionManifest;
-}
-/** Extension manifest from package.json `rowan` field. */
-interface ExtensionManifest {
-    id?: string;
-    entry?: string;
-    name?: string;
-}
-
-/**
- * EventBus — simple pub/sub for inter-extension communication.
- *
- * Extensions can emit and subscribe to arbitrary events via `api.events`.
- * This allows extensions to coordinate without direct coupling.
- *
- * @example
- * ```typescript
- * // Extension A
- * api.events.on("my-plugin:ready", (data) => {
- *   console.log("Plugin ready:", data);
- * });
- *
- * // Extension B
- * api.events.emit("my-plugin:ready", { version: "1.0" });
- * ```
- */
-type Listener = (...args: unknown[]) => void;
-interface EventBus {
-    /** Subscribe to an event. Returns unsubscribe function. */
-    on(event: string, listener: Listener): () => void;
-    /** Emit an event to all subscribers. */
-    emit(event: string, ...args: unknown[]): void;
-    /** Remove all listeners for an event, or all listeners if no event specified. */
-    off(event?: string): void;
-    /** Check if there are listeners for an event. */
-    has(event: string): boolean;
-    /** Get listener count for an event. */
-    count(event: string): number;
-}
-
-/**
- * @module extensions/context
- *
- * Extension context types — runtime state and phase execution context.
- *
- * For ExtensionAPI and createExtensionAPI, see ./api.ts
- */
-
+
 /**
  * Runtime context available to extensions during event handler execution.
  *
@@ -499,107 +276,6 @@ 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 {
-    /** Hook events — subscribe or unsubscribe. */
-    hooks: {
-        /**
-         * 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;
-    };
-    /** Extension configuration — read own layered config or listen for changes. */
-    config: {
-        /** Get the extension's own effective configuration block. */
-        get(scope?: ScopeRef): Promise<JsonObject | null>;
-        /** Listen for configuration changes for a scope. */
-        changed(handler: (scope: ScopeRef) => void): void;
-    };
-    /** Extension state — scoped to run (in-memory) or agent (durable) or global (durable). */
-    state: {
-        /** Run-scoped in-memory state; dropped when the Run ends. */
-        run(runId: string): ExtensionStateStore;
-        /** Agent-scoped durable state; persisted with the Agent record. */
-        agent(agentId: string): ExtensionStateStore;
-        /** Extension-scoped durable state; survives process restarts. */
-        global(): ExtensionStateStore;
-    };
-    /** Tool capabilities — register and unregister custom tools. */
-    tools: {
-        /** Register a custom LLM-callable tool. */
-        register(tool: ToolDefinition): void;
-        /** Unregister a previously registered tool by name. */
-        unregister(toolName: string): void;
-    };
-    /** Capability contributions — advertise tools or features to the host. */
-    capabilities: {
-        /** Contribute a capability to the host. Returns a disposer to remove the contribution. */
-        contribute(contribution: ExtensionCapabilityContribution): () => void;
-    };
-    /** Model provider registration. */
-    providers: {
-        /** Register a model provider. Registering with an existing id replaces it. */
-        register(config: _rowan_agent_models.ProviderConfig): void;
-        /** Unregister a model provider by id. */
-        unregister(id: string): void;
-    };
-    /** Phase execution capabilities — provides Phase In/Out, phase identity, phase routing, and registration. */
-    phases: {
-        /** 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;
-    };
-    /** Declarative host contributions. */
-    host: {
-        /** Contribute a declarative declaration to the host. Returns a disposer to remove the contribution. */
-        contribute<T extends HostContribution>(contribution: T): () => 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;
-}
-/**
- * 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 class InMemoryExtensionHost implements ExtensionHost {
     private readonly configs;
     private readonly agentState;
@@ -983,6 +659,7 @@ type UserInput = string | Readonly<{
     content: UserContent;
     metadata?: Metadata;
     thinkingLevel?: ThinkingLevel;
+    providerOptions?: JsonObject;
 }>;
 type HistorySeed = readonly Message[];
 type ContextStatus = Readonly<{
@@ -1052,10 +729,6 @@ type Tool$1 = Readonly<{
     } | undefined | void>;
     execute(args: JsonValue, context: ToolInvocationContext, signal: AbortSignal): Promise<ToolExecutionResult>;
 }>;
-type ContextCandidate = Readonly<{
-    name: string;
-    value: JsonValue;
-}>;
 type BeforeToolCallDecision = Readonly<{
     allow: true;
 }> | Readonly<{
@@ -1170,7 +843,7 @@ type RunRecord = Readonly<{
     openInteractions?: readonly RunInteraction[];
     interactionAnswers?: Readonly<Record<string, JsonValue>>;
     execution?: ExecutionToken;
-    outcome?: Outcome;
+    outcome?: Outcome$1;
     failure?: RunFailure;
     cancellationReason?: string;
     createdAt: string;
@@ -1242,7 +915,7 @@ type RunSnapshot = RunSnapshotBase & (Readonly<{
     answers: Readonly<Record<string, JsonValue>>;
 }> | Readonly<{
     state: "completed";
-    outcome: Outcome;
+    outcome: Outcome$1;
     output?: AssistantMessage;
 }> | Readonly<{
     state: "failed";
@@ -1257,7 +930,7 @@ type RunBoundary = Readonly<{
     answers: Readonly<Record<string, JsonValue>>;
 }> | Readonly<{
     type: "completed";
-    outcome: Outcome;
+    outcome: Outcome$1;
     output?: AssistantMessage;
 }> | Readonly<{
     type: "failed";
@@ -1345,6 +1018,7 @@ interface OwnedStore {
         executionId?: ExecutionId;
         messageId?: MessageId;
         configToken?: ConfigToken;
+        additionalContexts?: readonly ContextCandidate[];
     }): Promise<RunClaim>;
     failQueuedRun(input: {
         runId: RunId;
@@ -1386,7 +1060,7 @@ interface OwnedStore {
         runId: RunId;
         execution: ExecutionToken;
         expectedRevision: number;
-        outcome?: Outcome;
+        outcome?: Outcome$1;
         failure?: RunFailure;
         output?: AssistantMessage;
     }): Promise<RunRecord>;
@@ -1600,48 +1274,656 @@ type ConsumerRegistration = Readonly<{
     waterline: EventCursor;
 }>;
 
-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;
-    entryPhases?: readonly EntryPhaseSpec[];
-    continuation?: ExecutionContinuationState;
-    runInteractions?: RunInteractionState;
-    phaseInteractions?: RunInteractionState;
-};
-type ExecutionContinuationState = {
-    isContinuing: boolean;
-    previousPayload?: unknown;
-    previousResults: Array<{
-        name: string;
-        output?: unknown;
-    }>;
-    pendingInstruction?: string;
-    previousPhaseMessageId?: string;
+type HostContribution = {
+    readonly kind: string;
+    readonly id: string;
+} & {
+    readonly [key: string]: JsonValue;
+};
+interface ExtensionStateStore {
+    get(key: string): Promise<JsonValue | undefined>;
+    set(key: string, value: JsonValue): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+interface ExtensionHost {
+    getConfig(extensionId: string, scope?: ScopeRef): Promise<JsonObject | null> | JsonObject | null;
+    onConfigChanged?(listener: (extensionId: string, scope: ScopeRef) => void): (() => void) | void;
+    getAgentState(extensionId: string, agentId: string, key: string): Promise<JsonValue | undefined> | JsonValue | undefined;
+    setAgentState(extensionId: string, agentId: string, key: string, value: JsonValue): Promise<void> | void;
+    deleteAgentState(extensionId: string, agentId: string, key: string): Promise<void> | void;
+    getGlobalState(extensionId: string, key: string): Promise<JsonValue | undefined> | JsonValue | undefined;
+    setGlobalState(extensionId: string, key: string, value: JsonValue): Promise<void> | void;
+    deleteGlobalState(extensionId: string, key: string): Promise<void> | void;
+}
+type ExtensionToolContribution = {
+    kind: "tool";
+    name: string;
+    description: string;
+};
+type ExtensionCapabilityContribution = ExtensionToolContribution;
+type ExtensionCapability = {
+    extensionId: string;
+    kind: "tool";
+    name: string;
+    description: string;
+};
+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.tools.register()`.
+ *
+ * @example
+ * ```typescript
+ * api.tools.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>;
+    /** Optional: one-line snippet shown in the system prompt tool list */
+    promptSnippet?: string;
+    /** Optional: additional guidelines appended to system prompt */
+    promptGuidelines?: string[];
+    kind?: ToolKind;
+    annotations?: ToolAnnotations;
+    _meta?: JsonObject;
+    present?: (call: {
+        status: ToolCallStatus;
+        args: JsonValue;
+        progress?: ToolProgress;
+        result?: ToolExecutionResult;
+    }) => {
+        title?: string;
+        content?: ToolCallContent[];
+        locations?: ToolCallLocation[];
+        _meta?: JsonObject;
+    } | undefined | void | Promise<{
+        title?: string;
+        content?: ToolCallContent[];
+        locations?: ToolCallLocation[];
+        _meta?: JsonObject;
+    } | undefined | void>;
+    /** Execute the tool */
+    execute: (args: unknown, context: ToolInvocationContext, signal?: AbortSignal) => Promise<ToolExecutionResult>;
+    /** Optional: per-tool execution mode override */
+    executionMode?: "sequential" | "parallel";
+}
+
+/**
+ * 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;
+    }>;
+};
+/**
+ * Pre-initialization extension form — factory + metadata.
+ * Runner.loadExtensions() calls the factory and creates the full Extension object.
+ */
+interface LoadedExtension {
+    id?: string;
+    path: string;
+    name: string;
+    factory: ExtensionFactory;
+    manifest?: ExtensionManifest;
+}
+/** Extension manifest from package.json `rowan` field. */
+interface ExtensionManifest {
+    id?: string;
+    entry?: string;
+    name?: string;
+}
+
+/**
+ * Extension API object passed to extension factory function.
+ *
+ * @example
+ * ```typescript
+ * export default function(api: ExtensionAPI) {
+ *   // api provides all extension APIs
+ * }
+ * ```
+ */
+interface ExtensionAPI {
+    /** Hook events — subscribe or unsubscribe. */
+    hooks: {
+        /**
+         * 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;
+    };
+    /** Extension configuration — read own layered config or listen for changes. */
+    config: {
+        /** Get the extension's own effective configuration block. */
+        get(scope?: ScopeRef): Promise<JsonObject | null>;
+        /** Listen for configuration changes for a scope. */
+        changed(handler: (scope: ScopeRef) => void): void;
+    };
+    /** Extension state — scoped to run (in-memory) or agent (durable) or global (durable). */
+    state: {
+        /** Run-scoped in-memory state; dropped when the Run ends. */
+        run(runId: string): ExtensionStateStore;
+        /** Agent-scoped durable state; persisted with the Agent record. */
+        agent(agentId: string): ExtensionStateStore;
+        /** Extension-scoped durable state; survives process restarts. */
+        global(): ExtensionStateStore;
+    };
+    /** Tool capabilities — register and unregister custom tools. */
+    tools: {
+        /** Register a custom LLM-callable tool. */
+        register(tool: ToolDefinition): void;
+        /** Unregister a previously registered tool by name. */
+        unregister(toolName: string): void;
+    };
+    /** Capability contributions — advertise tools or features to the host. */
+    capabilities: {
+        /** Contribute a capability to the host. Returns a disposer to remove the contribution. */
+        contribute(contribution: ExtensionCapabilityContribution): () => void;
+    };
+    /** Model provider registration. */
+    providers: {
+        /** Register a model provider. Registering with an existing id replaces it. */
+        register(config: _rowan_agent_models.ProviderConfig): void;
+        /** Unregister a model provider by id. */
+        unregister(id: string): void;
+    };
+    /** Phase execution capabilities — provides Phase In/Out, phase identity, phase routing, and registration. */
+    phases: {
+        /** 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;
+    };
+    /** Declarative host contributions. */
+    host: {
+        /** Contribute a declarative declaration to the host. Returns a disposer to remove the contribution. */
+        contribute<T extends HostContribution>(contribution: T): () => 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;
+}
+/**
+ * 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>;
+
+type PhaseStatusState = "running" | "completed";
+/** Normalized status event exposed to Runtime consumers. */
+type PhaseStatus = Readonly<{
+    state: PhaseStatusState;
+    /** Stable consumer-facing status identifier, e.g. `compacting`. */
+    kind: string;
+    /** Optional human-readable detail for UI/status consumers. */
+    message?: string;
+    /** Structured status payload. */
+    payload?: unknown;
+}>;
+/** Unified phase output — model-driven routing is optional; programmatic phases may normalize omission to stop. */
+type PhaseOutput = {
+    /** User-visible assistant message. */
+    message?: string;
+    /** Final status update for non-conversational consumers. */
+    status?: PhaseStatus;
+    /** Route to next phase, or "continue" to re-execute current phase, or "stop" to end. Undefined means no model route. */
+    route?: string;
+    /** Phase name that produced this output */
+    phase?: string;
+    /** Tool calls from the model invocation (used by framework for route extraction) */
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        args: unknown;
+    }>;
+    /** Route reason extracted from route tool call (for hooks to inspect) */
+    routeReason?: string;
+    /** Structured data from this phase, passed to the next phase */
+    payload?: unknown;
+};
+/** Phase machine state — tracks position and inter-phase data */
+interface PhaseState {
+    current: string;
+    available: string[];
+    iterations: number;
+    payload?: unknown;
+}
+type PhaseInvocation = {
+    mode: "serial";
+    instanceId: string;
+} | {
+    mode: "parallel";
+    instanceId: string;
+    groupId: string;
+    index: number;
+    count: number;
+    sourcePhaseId: string;
+};
+/** Durable identity of the Run execution currently invoking a Phase. */
+type PhaseExecutionIdentity = Readonly<{
+    agentId: string;
+    runId: string;
+    executionId: string;
+    /** Original durable Run input, before any Phase-local interpretation. */
+    input?: UserContent;
+    /** Opaque metadata captured at the durable boundary; Rowan does not decode it. */
+    agentMetadata?: Readonly<Record<string, unknown>>;
+    runMetadata?: Readonly<Record<string, unknown>>;
+    scope?: _rowan_agent_models.ScopeRef;
+    cwd?: string;
+}>;
+/** Everything a phase needs to execute */
+interface PhaseContext {
+    systemPrompt: string;
+    messages: AgentMessage[];
+    /** Phase-filtered tools */
+    tools: Tool[];
+    /** Phase-filtered skills */
+    skills: Skill[];
+    /** Phase machine state */
+    state: PhaseState;
+    /** Identity and dispatch metadata for this phase execution */
+    readonly invocation: PhaseInvocation;
+    /** Durable Run identity for cross-store integrations and idempotent commands. */
+    readonly execution: PhaseExecutionIdentity;
+    /** Additional guideline bullets appended to the system prompt */
+    promptGuidelines?: string[];
+    /** Text to append after the system prompt */
+    appendSystemPrompt?: string;
+}
+/** JSON-safe structural defaults declared by a Phase's `input` mapping. */
+type PhaseInput = Readonly<Record<string, JsonValue>>;
+/** JSON-safe option metadata exposed to a host Settings surface. */
+interface SettingsOption {
+    value: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+}
+interface SettingsBadge {
+    label: string;
+    tone?: "neutral" | "success" | "review" | "danger";
+}
+interface SettingsItem {
+    id: string;
+    title: string;
+    description?: string;
+    badges?: readonly SettingsBadge[];
+}
+type SettingsControl = {
+    type: "boolean";
+    path: string;
+    label: string;
+    description?: string;
+} | {
+    type: "number";
+    path: string;
+    label: string;
+    description?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+    scale?: number;
+} | {
+    type: "select";
+    path: string;
+    label: string;
+    description?: string;
+    options: readonly SettingsOption[];
+} | {
+    type: "text";
+    path: string;
+    label: string;
+    description?: string;
+    placeholder?: string;
+    format?: "string" | "string-array" | "key-value";
+    multiline?: boolean;
+} | {
+    type: "collection";
+    path: string;
+    label: string;
+    description?: string;
+    items: readonly SettingsItem[];
+    fields: readonly SettingsControl[];
+    add?: {
+        label: string;
+        idLabel?: string;
+        fields: readonly SettingsControl[];
+    };
+    removeLabel?: string;
+};
+interface SettingsSection {
+    id: string;
+    title: string;
+    description?: string;
+    controls: readonly SettingsControl[];
+}
+/** Declarative, host-neutral Settings surface. */
+interface SettingsDefinition {
+    description?: string;
+    sections: readonly SettingsSection[];
+}
+/**
+ * Loaded Phase object
+ */
+interface Phase {
+    /** Unique phase identity and display name. */
+    name: string;
+    /** Rowan-owned built-in Phase; built-ins are never filtered or disabled. */
+    core?: boolean;
+    /** Description */
+    description: string;
+    /** Restricted tools (undefined = all tools available) */
+    tools?: string[];
+    /** Skills bundled directly inside this phase directory. Inline phases may omit this (equivalent to []). */
+    skills?: Skill[];
+    /** Forced next phase */
+    target?: string;
+    /** Structural JSON-safe input defaults */
+    input?: PhaseInput;
+    /** If true, phase gets a fresh context when executed in parallel */
+    isolated?: boolean;
+    /** Path to PHASE.md file */
+    filePath: string;
+    /** Phase directory path */
+    baseDir: string;
+    /** PHASE.md body content */
+    content: string;
+    /** Model override for this phase (resolved from frontmatter) */
+    model?: ModelRef;
+    /** Do not automatically inject this Phase into the model route catalog/context. */
+    disableAutoInvocation?: boolean;
+    /** Do not expose this Phase to direct user invocation. */
+    disableImplicitInvocation?: boolean;
+    /** ExtensionAPI factory function used for registration or programmatic execution. */
+    factory?: (api: ExtensionAPI) => Promise<void>;
+    /** Direct run function */
+    run?: (context: PhaseContext, execution: PhaseExecution) => Promise<PhaseOutput | void>;
+}
+/**
+ * Phase registry containing all loaded phases
+ */
+interface PhaseRegistry {
+    /** Map of phase name to Phase object */
+    phases: Map<string, Phase>;
+    /** Entry phase name (null until Agent applies its default phase) */
+    entryPhaseId: string | null;
+}
+
+interface BeforePhaseEvent {
+    type: "before_phase";
+    phaseId: string;
+    input: PhaseContext;
+}
+interface AfterPhaseEvent {
+    type: "after_phase";
+    phaseId: string;
+    output: PhaseOutput;
+}
+interface BeforePromptEvent {
+    type: "before_prompt";
+    phaseId: string;
+    input: PhaseContext;
+}
+interface BeforeToolCallEvent {
+    type: "before_tool_call";
+    tool: Tool;
+    args: unknown;
+    readonly runId?: string;
+    readonly agentId?: string;
+    readonly toolCallId?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly answer?: unknown;
+    readonly scope?: ScopeRef;
+    readonly turn?: JsonObject;
+}
+interface AfterToolCallEvent {
+    type: "after_tool_call";
+    tool: Tool;
+    result: ToolResult;
+    readonly runId?: string;
+    readonly agentId?: string;
+    readonly toolCallId?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly scope?: ScopeRef;
+    readonly turn?: JsonObject;
+}
+interface RunStartEvent {
+    type: "run_start";
+    runId: string;
+    agentId: string;
+    metadata: Readonly<Record<string, unknown>>;
+    turn: JsonObject;
+}
+interface RunEndEvent {
+    type: "run_end";
+    runId: string;
+    agentId: string;
+    outcome: unknown;
+}
+type HookEvent = BeforePhaseEvent | AfterPhaseEvent | BeforePromptEvent | BeforeToolCallEvent | AfterToolCallEvent | RunStartEvent | RunEndEvent;
+interface BeforePhaseResult {
+    abort?: Outcome;
+    skip?: {
+        route: string;
+        message: string;
+    };
+    input?: PhaseContext;
+}
+interface AfterPhaseResult {
+    abort?: Outcome;
+    retry?: PhaseContext;
+    output?: PhaseOutput;
+}
+interface BeforePromptResult {
+    input?: PhaseContext;
+}
+interface BeforeToolCallResult {
+    allow?: boolean;
+    reason?: string;
+    interaction?: RunInteractionRequest;
+}
+interface AfterToolCallResult {
+    result?: ToolResult;
+}
+interface HookResultMap {
+    before_phase: BeforePhaseResult | undefined;
+    after_phase: AfterPhaseResult | undefined;
+    before_prompt: BeforePromptResult | undefined;
+    before_tool_call: BeforeToolCallResult | undefined;
+    after_tool_call: AfterToolCallResult | undefined;
+    run_start: void;
+    run_end: void;
+}
+type HookEventType = HookEvent["type"];
+type HookHandler<K extends HookEventType> = (event: Extract<HookEvent, {
+    type: K;
+}>) => HookResultMap[K] | Promise<HookResultMap[K]> | void | Promise<void>;
+declare class HooksManager {
+    private handlers;
+    on<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
+    off<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
+    emit<K extends HookEventType>(eventType: K, event: Extract<HookEvent, {
+        type: K;
+    }>): Promise<void>;
+    emitFirst<K extends HookEventType>(eventType: K, event: Extract<HookEvent, {
+        type: K;
+    }>): Promise<HookResultMap[K] | undefined>;
+}
+
+type ToolContext = Pick<AgentContext, "skills"> & {
+    toolCallId: string;
+    interaction?: RunInteractionDriver;
+};
+type ToolExecutionMode = "sequential" | "parallel";
+type Tool<TArgs = unknown> = {
+    name: string;
+    /** Rowan-owned Core Tool; Core Tools bypass Phase filtering. */
+    core?: boolean;
+    description: string;
+    parameters: Type.TSchema;
+    /** One-line snippet shown in the system prompt tool list. */
+    promptSnippet?: string;
+    /** Additional guidelines appended to the system prompt when this tool is active. */
+    promptGuidelines?: string[];
+    /** Whether this tool can run concurrently with others. Default: "parallel". */
+    executionMode?: ToolExecutionMode;
+    _meta?: JsonObject$1;
+    execute(args: TArgs, context: ToolContext, signal?: AbortSignal): Promise<ToolResult>;
+};
+/** Context snapshot passed into the low-level agent loop. */
+type AgentContext = {
+    /** System prompt included with the request. */
+    systemPrompt: string;
+    /** Transcript visible to the model. */
+    messages: AgentMessage[];
+    /** Tools available for this run. */
+    tools: Tool[];
+    /** Skills available for this run. */
+    skills: Skill[];
+    /** Custom phases for this run. Agent normalizes this with the built-in default phase. */
+    phases?: PhaseRegistry;
+    cwd?: 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;
+    entryPhases?: readonly EntryPhaseSpec[];
+    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";
@@ -1792,9 +2074,14 @@ type MessageBase = Readonly<{
     sequenceWithinRun: number;
     createdAt: string;
 }>;
+type ContextCandidate = Readonly<{
+    name: string;
+    value: JsonValue;
+}>;
 type UserMessage = MessageBase & Readonly<{
     role: "user";
     content: UserContent;
+    contexts?: readonly ContextCandidate[];
 }>;
 type AssistantMessage = MessageBase & Readonly<{
     role: "assistant";
@@ -1822,7 +2109,7 @@ type InteractionRecord = MessageBase & Readonly<{
     }>;
 }>;
 type Message = UserMessage | AssistantMessage | ToolMessage | InteractionRecord;
-type Outcome = Readonly<{
+type Outcome$1 = Readonly<{
     id: OutcomeId;
     message: string;
     payload?: JsonValue;
@@ -1940,7 +2227,7 @@ type RunStateChanged = DurableEventBase & (Readonly<{
     kind: "run_state_changed";
     from: "running";
     to: "completed";
-    outcome: Outcome;
+    outcome: Outcome$1;
     output?: AssistantMessage;
 }> | Readonly<{
     kind: "run_state_changed";
@@ -2007,377 +2294,94 @@ type ToolCallDelta = Readonly<{
     durability: "transient";
     runId: RunId;
     executionId: ExecutionId;
-    messageId: MessageId;
-    providerToolCallId: string;
-    toolName: string;
-    arguments: string;
-    args: JsonValue | undefined;
-}>;
-type PhaseStatusEvent = Readonly<{
-    kind: "phase_status";
-    durability: "transient";
-    runId: RunId;
-    executionId: ExecutionId;
-    phaseId: string;
-    status: PhaseStatus;
-}>;
-type ModelRetry = Readonly<{
-    kind: "model_retry";
-    durability: "transient";
-    runId: RunId;
-    executionId: ExecutionId;
-    attempt: number;
-    maxRetries: number;
-    delayMs: number;
-    error: string;
-}>;
-type LiveInteractionEvent = Readonly<{
-    kind: "live_interaction";
-    durability: "transient";
-    runId: RunId;
-    executionId?: ExecutionId;
-    interaction: RunInteraction;
-}>;
-type RunEvent = DurableRunEvent | MessageDelta | ThinkingDelta | ToolCallDelta | PhaseStatusEvent | ModelRetry | LiveInteractionEvent | Extract<ToolStateChanged, {
-    durability: "transient";
-}>;
-
-type PhaseStatusState = "running" | "completed";
-/** Normalized status event exposed to Runtime consumers. */
-type PhaseStatus = Readonly<{
-    state: PhaseStatusState;
-    /** Stable consumer-facing status identifier, e.g. `compacting`. */
-    kind: string;
-    /** Optional human-readable detail for UI/status consumers. */
-    message?: string;
-    /** Structured status payload. */
-    payload?: unknown;
-}>;
-/** Unified phase output — model-driven routing is optional; programmatic phases may normalize omission to stop. */
-type PhaseOutput = {
-    /** User-visible assistant message. */
-    message?: string;
-    /** Final status update for non-conversational consumers. */
-    status?: PhaseStatus;
-    /** Route to next phase, or "continue" to re-execute current phase, or "stop" to end. Undefined means no model route. */
-    route?: string;
-    /** Phase name that produced this output */
-    phase?: string;
-    /** Tool calls from the model invocation (used by framework for route extraction) */
-    toolCalls?: Array<{
-        id: string;
-        name: string;
-        args: unknown;
-    }>;
-    /** Route reason extracted from route tool call (for hooks to inspect) */
-    routeReason?: string;
-    /** Structured data from this phase, passed to the next phase */
-    payload?: unknown;
-};
-/** Phase machine state — tracks position and inter-phase data */
-interface PhaseState {
-    current: string;
-    available: string[];
-    iterations: number;
-    payload?: unknown;
-}
-type PhaseInvocation = {
-    mode: "serial";
-    instanceId: string;
-} | {
-    mode: "parallel";
-    instanceId: string;
-    groupId: string;
-    index: number;
-    count: number;
-    sourcePhaseId: string;
-};
-/** Durable identity of the Run execution currently invoking a Phase. */
-type PhaseExecutionIdentity = Readonly<{
-    agentId: string;
-    runId: string;
-    executionId: string;
-    /** Original durable Run input, before any Phase-local interpretation. */
-    input?: UserContent;
-    /** Opaque metadata captured at the durable boundary; Rowan does not decode it. */
-    agentMetadata?: Readonly<Record<string, unknown>>;
-    runMetadata?: Readonly<Record<string, unknown>>;
-    scope?: _rowan_agent_models.ScopeRef;
-    cwd?: string;
-}>;
-/** Everything a phase needs to execute */
-interface PhaseContext {
-    systemPrompt: string;
-    messages: AgentMessage[];
-    /** Phase-filtered tools */
-    tools: Tool[];
-    /** Phase-filtered skills */
-    skills: Skill[];
-    /** Phase machine state */
-    state: PhaseState;
-    /** Identity and dispatch metadata for this phase execution */
-    readonly invocation: PhaseInvocation;
-    /** Durable Run identity for cross-store integrations and idempotent commands. */
-    readonly execution: PhaseExecutionIdentity;
-    /** Additional guideline bullets appended to the system prompt */
-    promptGuidelines?: string[];
-    /** Text to append after the system prompt */
-    appendSystemPrompt?: string;
-}
-/** JSON-safe structural defaults declared by a Phase's `input` mapping. */
-type PhaseInput = Readonly<Record<string, JsonValue>>;
-/** JSON-safe option metadata exposed to a host Settings surface. */
-interface SettingsOption {
-    value: string;
-    label: string;
-    description?: string;
-    disabled?: boolean;
-}
-interface SettingsBadge {
-    label: string;
-    tone?: "neutral" | "success" | "review" | "danger";
-}
-interface SettingsItem {
-    id: string;
-    title: string;
-    description?: string;
-    badges?: readonly SettingsBadge[];
-}
-type SettingsControl = {
-    type: "boolean";
-    path: string;
-    label: string;
-    description?: string;
-} | {
-    type: "number";
-    path: string;
-    label: string;
-    description?: string;
-    min?: number;
-    max?: number;
-    step?: number;
-    unit?: string;
-    scale?: number;
-} | {
-    type: "select";
-    path: string;
-    label: string;
-    description?: string;
-    options: readonly SettingsOption[];
-} | {
-    type: "text";
-    path: string;
-    label: string;
-    description?: string;
-    placeholder?: string;
-    format?: "string" | "string-array" | "key-value";
-    multiline?: boolean;
-} | {
-    type: "collection";
-    path: string;
-    label: string;
-    description?: string;
-    items: readonly SettingsItem[];
-    fields: readonly SettingsControl[];
-    add?: {
-        label: string;
-        idLabel?: string;
-        fields: readonly SettingsControl[];
+    messageId: MessageId;
+    providerToolCallId: string;
+    toolName: string;
+    arguments: string;
+    args: JsonValue | undefined;
+}>;
+type PhaseStatusEvent = Readonly<{
+    kind: "phase_status";
+    durability: "transient";
+    runId: RunId;
+    executionId: ExecutionId;
+    phaseId: string;
+    status: PhaseStatus;
+}>;
+type ModelRetry = Readonly<{
+    kind: "model_retry";
+    durability: "transient";
+    runId: RunId;
+    executionId: ExecutionId;
+    attempt: number;
+    maxRetries: number;
+    delayMs: number;
+    error: string;
+}>;
+type LiveInteractionEvent = Readonly<{
+    kind: "live_interaction";
+    durability: "transient";
+    runId: RunId;
+    executionId?: ExecutionId;
+    interaction: RunInteraction;
+}>;
+type RunEvent = DurableRunEvent | MessageDelta | ThinkingDelta | ToolCallDelta | PhaseStatusEvent | ModelRetry | LiveInteractionEvent | Extract<ToolStateChanged, {
+    durability: "transient";
+}>;
+
+type AgentMessage = {
+    id: string;
+    role: "system" | "user" | "assistant" | "tool";
+    content: string | LlmContentPart[];
+    createdAt: string;
+    metadata?: Record<string, unknown> & {
+        phase?: string;
     };
-    removeLabel?: string;
+    contexts?: readonly ContextCandidate[];
 };
-interface SettingsSection {
-    id: string;
-    title: string;
-    description?: string;
-    controls: readonly SettingsControl[];
-}
-/** Declarative, host-neutral Settings surface. */
-interface SettingsDefinition {
-    description?: string;
-    sections: readonly SettingsSection[];
-}
-/**
- * Loaded Phase object
- */
-interface Phase {
-    /** Unique phase identity and display name. */
+type Skill = {
     name: string;
-    /** Rowan-owned built-in Phase; built-ins are never filtered or disabled. */
-    core?: boolean;
-    /** Description */
     description: string;
-    /** Restricted tools (undefined = all tools available) */
-    tools?: string[];
-    /** Skills bundled directly inside this phase directory. Inline phases may omit this (equivalent to []). */
-    skills?: Skill[];
-    /** Forced next phase */
-    target?: string;
-    /** Structural JSON-safe input defaults */
-    input?: PhaseInput;
-    /** If true, phase gets a fresh context when executed in parallel */
-    isolated?: boolean;
-    /** Path to PHASE.md file */
+    /** Absolute path to the SKILL.md file */
     filePath: string;
-    /** Phase directory path */
+    /** Directory containing the SKILL.md file */
     baseDir: string;
-    /** PHASE.md body content */
+    /** Full body content of the SKILL.md (after frontmatter) */
     content: string;
-    /** Model override for this phase (resolved from frontmatter) */
-    model?: ModelRef;
-    /** Do not automatically inject this Phase into the model route catalog/context. */
+    /** Do not automatically inject this Skill into the model Context. */
     disableAutoInvocation?: boolean;
-    /** Do not expose this Phase to direct user invocation. */
+    /** Do not expose this Skill to direct user invocation. */
     disableImplicitInvocation?: boolean;
-    /** ExtensionAPI factory function used for registration or programmatic execution. */
-    factory?: (api: ExtensionAPI) => Promise<void>;
-    /** Direct run function */
-    run?: (context: PhaseContext, execution: PhaseExecution) => Promise<PhaseOutput | void>;
-}
-/**
- * Phase registry containing all loaded phases
- */
-interface PhaseRegistry {
-    /** Map of phase name to Phase object */
-    phases: Map<string, Phase>;
-    /** Entry phase name (null until Agent applies its default phase) */
-    entryPhaseId: string | null;
-}
-
-interface BeforePhaseEvent {
-    type: "before_phase";
-    phaseId: string;
-    input: PhaseContext;
-}
-interface AfterPhaseEvent {
-    type: "after_phase";
-    phaseId: string;
-    output: PhaseOutput;
-}
-interface BeforePromptEvent {
-    type: "before_prompt";
-    phaseId: string;
-    input: PhaseContext;
-}
-interface BeforeToolCallEvent {
-    type: "before_tool_call";
-    tool: Tool;
-    args: unknown;
-    readonly runId?: string;
-    readonly agentId?: string;
-    readonly toolCallId?: string;
-    readonly metadata?: Readonly<Record<string, unknown>>;
-    readonly answer?: unknown;
-    readonly scope?: ScopeRef;
-    readonly turn?: JsonObject;
-}
-interface AfterToolCallEvent {
-    type: "after_tool_call";
-    tool: Tool;
-    result: ToolResult;
-    readonly runId?: string;
-    readonly agentId?: string;
-    readonly toolCallId?: string;
-    readonly metadata?: Readonly<Record<string, unknown>>;
-    readonly scope?: ScopeRef;
-    readonly turn?: JsonObject;
-}
-interface RunStartEvent {
-    type: "run_start";
-    runId: string;
-    agentId: string;
-    metadata: Readonly<Record<string, unknown>>;
-    turn: JsonObject;
-}
-interface RunEndEvent {
-    type: "run_end";
-    runId: string;
-    agentId: string;
-    outcome: unknown;
-}
-type HookEvent = BeforePhaseEvent | AfterPhaseEvent | BeforePromptEvent | BeforeToolCallEvent | AfterToolCallEvent | RunStartEvent | RunEndEvent;
-interface BeforePhaseResult {
-    abort?: Outcome$1;
-    skip?: {
-        route: string;
-        message: string;
-    };
-    input?: PhaseContext;
-}
-interface AfterPhaseResult {
-    abort?: Outcome$1;
-    retry?: PhaseContext;
-    output?: PhaseOutput;
-}
-interface BeforePromptResult {
-    input?: PhaseContext;
-}
-interface BeforeToolCallResult {
-    allow?: boolean;
-    reason?: string;
-    interaction?: RunInteractionRequest;
-}
-interface AfterToolCallResult {
-    result?: ToolResult;
-}
-interface HookResultMap {
-    before_phase: BeforePhaseResult | undefined;
-    after_phase: AfterPhaseResult | undefined;
-    before_prompt: BeforePromptResult | undefined;
-    before_tool_call: BeforeToolCallResult | undefined;
-    after_tool_call: AfterToolCallResult | undefined;
-    run_start: void;
-    run_end: void;
-}
-type HookEventType = HookEvent["type"];
-type HookHandler<K extends HookEventType> = (event: Extract<HookEvent, {
-    type: K;
-}>) => HookResultMap[K] | Promise<HookResultMap[K]> | void | Promise<void>;
-declare class HooksManager {
-    private handlers;
-    on<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
-    off<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
-    emit<K extends HookEventType>(eventType: K, event: Extract<HookEvent, {
-        type: K;
-    }>): Promise<void>;
-    emitFirst<K extends HookEventType>(eventType: K, event: Extract<HookEvent, {
-        type: K;
-    }>): Promise<HookResultMap[K] | undefined>;
-}
-
-type ToolContext = Pick<AgentContext, "skills"> & {
-    toolCallId: string;
-    interaction?: RunInteractionDriver;
+    /** @deprecated Use disableAutoInvocation; kept only for old in-memory callers during cutover. */
+    disableModelInvocation?: boolean;
 };
-type ToolExecutionMode = "sequential" | "parallel";
-type Tool<TArgs = unknown> = {
+type Outcome = {
+    id: string;
+    message: string;
+    /** Publish this outcome's message as an assistant message before completing the run. */
+    display?: boolean;
+    payload?: unknown;
+    toolResults?: Array<{
+        toolCallId: string;
+        toolName: string;
+        ok: boolean;
+        content: unknown;
+        error?: string;
+    }>;
+};
+type ToolCall = {
+    id: string;
     name: string;
-    /** Rowan-owned Core Tool; Core Tools bypass Phase filtering. */
-    core?: boolean;
-    description: string;
-    parameters: Type.TSchema;
-    /** One-line snippet shown in the system prompt tool list. */
-    promptSnippet?: string;
-    /** Additional guidelines appended to the system prompt when this tool is active. */
-    promptGuidelines?: string[];
-    /** Whether this tool can run concurrently with others. Default: "parallel". */
-    executionMode?: ToolExecutionMode;
-    _meta?: JsonObject$1;
-    execute(args: TArgs, context: ToolContext, signal?: AbortSignal): Promise<ToolResult>;
+    args: unknown;
 };
-/** Context snapshot passed into the low-level agent loop. */
-type AgentContext = {
-    /** System prompt included with the request. */
-    systemPrompt: string;
-    /** Transcript visible to the model. */
-    messages: AgentMessage[];
-    /** Tools available for this run. */
-    tools: Tool[];
-    /** Skills available for this run. */
-    skills: Skill[];
-    /** Custom phases for this run. Agent normalizes this with the built-in default phase. */
-    phases?: PhaseRegistry;
-    cwd?: string;
+type ToolResult = {
+    toolCallId: string;
+    toolName: string;
+    ok: boolean;
+    content: unknown;
+    error?: string;
+    structuredContent?: unknown;
+    isError?: boolean;
 };
 
 /**
@@ -2694,6 +2698,7 @@ declare class InMemoryStore implements DurableStore {
         executionId?: ExecutionId;
         messageId?: MessageId;
         configToken?: ConfigToken;
+        additionalContexts?: readonly ContextCandidate[];
     }): RunClaim;
     failQueuedRun(lease: OwnerLease, input: {
         runId: RunId;
@@ -2789,7 +2794,7 @@ declare class InMemoryStore implements DurableStore {
         runId: RunId;
         execution: ExecutionToken;
         expectedRevision: number;
-        outcome?: Outcome;
+        outcome?: Outcome$1;
         failure?: RunFailure;
         output?: AssistantMessage;
     }): RunRecord;
@@ -2944,6 +2949,7 @@ declare class SqliteStore implements DurableStore {
         executionId?: ExecutionId;
         messageId?: MessageId;
         configToken?: ConfigToken;
+        additionalContexts?: readonly ContextCandidate[];
     }): Promise<RunClaim>;
     failQueuedRun(lease: OwnerLease, input: {
         runId: RunId;
@@ -2987,7 +2993,7 @@ declare class SqliteStore implements DurableStore {
         runId: RunId;
         execution: ExecutionToken;
         expectedRevision: number;
-        outcome?: Outcome;
+        outcome?: Outcome$1;
         failure?: RunFailure;
         output?: AssistantMessage;
     }): Promise<RunRecord>;
@@ -3303,4 +3309,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 EntryPhaseSpec, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionActivationError, type ExtensionActivationResult, type ExtensionCapability, type ExtensionCapabilityContribution, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, type ExtensionHost, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type ExtensionStateStore, type ExtensionToolContribution, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, type HostContribution, InMemoryConfigProvider, InMemoryExtensionHost, InMemoryStore, type InteractionRecord, type InvocationCatalogEntry, type InvocationSource, type JsonObject, type JsonPrimitive, type JsonValue, type LiveInteractionEvent, 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 ModelRetry, 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 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 RunEndEvent, 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 RunStartEvent, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, STOP_PHASE_ID, type SettingsBadge, type SettingsControl, type SettingsDefinition, type SettingsItem, type SettingsOption, type SettingsSection, type Skill, SqliteStore, type TextContent, type ThinkingContent, type ThinkingDelta, type Tool$1 as Tool, type ToolCallContext, type ToolCallDelta, type ToolCallId, type ToolCallPresentationInput, type ToolCallPresentationOutput, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UserContent, type UserInput, type UserMessage, type WithdrawnUserInput, brandConfigToken, createCompactPhase, createCorePhases, createCoreTools, createDefaultPhase, createStopPhase, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhases, loadSkill, loadSkills, mergeToolCall, 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 ExtensionCapability, type ExtensionCapabilityContribution, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, type ExtensionHost, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type ExtensionStateStore, type ExtensionToolContribution, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, type HostContribution, InMemoryConfigProvider, InMemoryExtensionHost, InMemoryStore, type InteractionRecord, type InvocationCatalogEntry, type InvocationSource, type JsonObject, type JsonPrimitive, type JsonValue, type LiveInteractionEvent, 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 ModelRetry, type OpaqueId, type Outcome$1 as 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 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 RunEndEvent, 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 RunStartEvent, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, STOP_PHASE_ID, type SettingsBadge, type SettingsControl, type SettingsDefinition, type SettingsItem, type SettingsOption, type SettingsSection, type Skill, SqliteStore, type TextContent, type ThinkingContent, type ThinkingDelta, type Tool$1 as Tool, type ToolCallContext, type ToolCallDelta, type ToolCallId, type ToolCallPresentationInput, type ToolCallPresentationOutput, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UserContent, type UserInput, type UserMessage, type WithdrawnUserInput, brandConfigToken, createCompactPhase, createCorePhases, createCoreTools, createDefaultPhase, createStopPhase, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhases, loadSkill, loadSkills, mergeToolCall, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };