@rowan-agent/agent 0.9.7 → 0.9.9

package/dist/index.d.ts

@@ -21,7 +21,12 @@ type Skill = {
     baseDir: string;
     /** Full body content of the SKILL.md (after frontmatter) */
     content: string;
-    disableModelInvocation: boolean;
+    /** 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 Outcome$1 = {
     id: string;
@@ -50,6 +55,481 @@ type ToolResult = {
     error?: string;
 };
 
+/** Durable and transient DTOs owned by the event-driven Agent Runtime. */
+
+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 InputRequestId = OpaqueId<"InputRequestId">;
+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$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 ToolMessage = MessageBase & Readonly<{
+    role: "tool";
+    content: ToolMessageContent;
+}>;
+type Message = UserMessage | AssistantMessage | ToolMessage;
+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 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";
+    request: Readonly<{
+        id: InputRequestId;
+        phase: string;
+        prompt: AssistantMessage;
+    }>;
+    interactions: readonly PhaseInteraction[];
+    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: "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 = MessageCommitted | MessageRevised | RunStateChanged | ToolStateChanged;
+type MessageDelta = Readonly<{
+    kind: "message_delta";
+    durability: "transient";
+    runId: RunId;
+    executionId: ExecutionId;
+    messageId: MessageId;
+    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 | ToolProgress | PhaseStatusEvent;
+
+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$1;
+    args: unknown;
+}
+interface AfterToolCallEvent {
+    type: "after_tool_call";
+    tool: Tool$1;
+    result: ToolResult;
+}
+type HookEvent = BeforePhaseEvent | AfterPhaseEvent | BeforePromptEvent | BeforeToolCallEvent | AfterToolCallEvent;
+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;
+}
+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;
+}
+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 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";
+    continuation?: ExecutionContinuationState;
+    phaseInteractions?: PhaseInteractionState;
+};
+type ExecutionContinuationState = {
+    isContinuing: boolean;
+    previousPayload?: unknown;
+    previousResults: Array<{
+        name: string;
+        output?: unknown;
+    }>;
+    pendingInstruction?: string;
+    previousPhaseMessageId?: string;
+};
+
+type PhaseInteractionKind = "user_input" | "permission" | "elicitation" | "confirmation";
+type PhaseInteractionStatus = "pending" | "answered" | "denied" | "cancelled" | "expired";
+type PhaseInteraction = Readonly<{
+    id: string;
+    phase: string;
+    kind: PhaseInteractionKind;
+    prompt: string;
+    payload?: JsonValue;
+    createdAt: string;
+    status: PhaseInteractionStatus;
+}>;
+type PhaseInteractionState = Readonly<{
+    requests: readonly PhaseInteraction[];
+    answers: Readonly<Record<string, JsonValue>>;
+    checkpoint?: JsonValue;
+}>;
+type PhaseInteractionDriver = Readonly<{
+    signal: AbortSignal;
+    request(input: Readonly<{
+        id?: string;
+        kind: PhaseInteractionKind;
+        prompt: string;
+        payload?: JsonValue;
+    }>): PhaseInteraction;
+    pending(): readonly PhaseInteraction[];
+    answers(): ReadonlyMap<string, JsonValue>;
+    suspend(input?: Readonly<{
+        checkpoint?: JsonValue;
+    }>): never;
+}>;
+declare class PhaseInteractionCancelledError extends Error {
+    readonly code: "phase_interaction_cancelled";
+    constructor();
+}
+declare class PhaseInteractionBoundary extends Error {
+    readonly state: ExecutionState;
+    readonly interactions: readonly PhaseInteraction[];
+    constructor(state: ExecutionState, interactions: readonly PhaseInteraction[]);
+}
+
 type ModelInvokeOutput = {
     text: string;
     contentBlocks: ContentBlock[];
@@ -69,9 +549,13 @@ type PhaseContextSnapshot = {
 type PhaseExecution = {
     snapshot(): PhaseContextSnapshot;
     restore(snapshot: PhaseContextSnapshot): void;
-    invokeModel(context: PhaseContext): Promise<ModelInvokeOutput>;
+    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[]): Promise<readonly ToolResult[]>;
+    interaction: PhaseInteractionDriver;
 };
 
 /**
@@ -106,14 +590,14 @@ interface ToolDefinition {
     /** Parameter schema (JSON Schema) */
     parameters: Record<string, unknown>;
     /** Execute the tool */
-    execute: (args: unknown, signal?: AbortSignal) => Promise<ToolExecutionResult$1>;
+    execute: (args: unknown, signal?: AbortSignal) => Promise<ToolExecutionResult>;
     /** Optional: per-tool execution mode override */
     executionMode?: "sequential" | "parallel";
 }
 /**
  * Result from tool execution.
  */
-interface ToolExecutionResult$1 {
+interface ToolExecutionResult {
     /** Content blocks to return to the LLM */
     content: Array<{
         type: string;
@@ -230,78 +714,6 @@ interface EventBus {
     count(event: string): number;
 }
 
-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$1;
-    args: unknown;
-}
-interface AfterToolCallEvent {
-    type: "after_tool_call";
-    tool: Tool$1;
-    result: ToolResult;
-}
-type HookEvent = BeforePhaseEvent | AfterPhaseEvent | BeforePromptEvent | BeforeToolCallEvent | AfterToolCallEvent;
-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;
-}
-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;
-}
-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>;
-}
-
 /**
  * @module extensions/context
  *
@@ -455,9 +867,23 @@ 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 = {
-    message: string;
+    /** 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 */
@@ -525,6 +951,8 @@ interface PhaseContext {
 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) */
@@ -545,476 +973,174 @@ interface Phase {
     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 (default export pattern) */
     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;
-}
-
-type ToolContext = Pick<AgentContext, "skills"> & {
-    toolCallId: string;
-};
-type ToolExecutionMode = "sequential" | "parallel";
-type Tool$1<TArgs = unknown> = {
-    name: string;
-    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;
-    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$1[];
-    /** Skills available for this run. */
-    skills: Skill[];
-    /** Custom phases for this run. Agent normalizes this with the built-in default phase. */
-    phases?: PhaseRegistry;
-};
-
-/**
- * `root` anchors relative paths and the Bash working directory. It is not a
- * filesystem sandbox: core Tools use the permissions of the host process.
- */
-type CoreToolContext = {
-    root?: string;
-    maxReadBytes?: number;
-    bashTimeoutMs?: number;
-    maxBashOutputBytes?: number;
-};
-
-type PhaseRegistrySelection = Readonly<{
-    entryPhaseId: string | null;
-    phaseIds: readonly string[];
-}>;
-type AgentDefinition = Readonly<{
-    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;
-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[];
-    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 | 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.
+ * Phase registry containing all loaded phases
  */
-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;
+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;
 }
 
-/** Durable and transient DTOs owned by the event-driven Agent Runtime. */
-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 InputRequestId = OpaqueId<"InputRequestId">;
-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 ToolContext = Pick<AgentContext, "skills"> & {
+    toolCallId: string;
 };
-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 Message = UserMessage | AssistantMessage | ToolMessage;
-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;
+type ToolExecutionMode = "sequential" | "parallel";
+type Tool$1<TArgs = unknown> = {
     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;
+    /** 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;
+    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$1[];
+    /** Skills available for this run. */
+    skills: Skill[];
+    /** Custom phases for this run. Agent normalizes this with the built-in default phase. */
+    phases?: PhaseRegistry;
+};
+
+/**
+ * `root` anchors relative paths and the Bash working directory. It is not a
+ * filesystem sandbox: core Tools use the permissions of the host process.
+ */
+type CoreToolContext = {
+    root?: string;
+    /** Directory for complete Tool Result spill files. */
+    archiveDir?: string;
+    maxReadBytes?: number;
+    maxReadLines?: number;
+    bashTimeoutMs?: number;
+    maxBashOutputBytes?: number;
+};
+
+type PhaseRegistrySelection = Readonly<{
+    entryPhaseId: string | null;
+    phaseIds: readonly string[];
 }>;
-type MessageCommitted = DurableEventBase & Readonly<{
-    kind: "message_committed";
-    message: Message;
+type AgentDefinition = Readonly<{
+    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;
 }>;
-type MessageRevised = DurableEventBase & Readonly<{
-    kind: "message_revised";
-    message: UserMessage;
-    previousRevision: number;
-    invalidatedRunIds: readonly RunId[];
-    targetRunId: RunId;
-    cutoffSequenceWithinRun: number;
+/** 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;
+type PhaseContribution = Phase;
+type ResourceView = Readonly<{
+    agents: readonly ResourceSourceId[];
+    tools: readonly ResourceSourceId[];
+    skills: readonly ResourceSourceId[];
+    phases: readonly ResourceSourceId[];
 }>;
-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";
-    request: Readonly<{
-        id: InputRequestId;
-        phase: string;
-        prompt: AssistantMessage;
-    }>;
-}> | 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: "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 = MessageCommitted | MessageRevised | RunStateChanged | ToolStateChanged;
-type MessageDelta = Readonly<{
-    kind: "message_delta";
-    durability: "transient";
-    runId: RunId;
-    executionId: ExecutionId;
-    messageId: MessageId;
-    offset: number;
-    text: string;
+type ResourceRef = Readonly<{
+    kind: ResourceKind;
+    sourceId: ResourceSourceId;
+    name: string;
 }>;
-type ToolProgress = Readonly<{
-    kind: "tool_progress";
-    durability: "transient";
-    runId: RunId;
-    executionId: ExecutionId;
-    toolCallId: ToolCallId;
-    progress: JsonValue;
+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[];
+    skills: readonly Skill[];
+    phases: readonly Phase[];
+    revisions: Readonly<Record<ResourceKind, readonly string[]>>;
+    refs: Readonly<Record<ResourceKind, readonly ResourceRef[]>>;
 }>;
-type RunEvent = DurableRunEvent | MessageDelta | ToolProgress;
+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 | 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;
+}
 
 /**
  * Extension runner — manages extension loading and hook execution.
@@ -1276,6 +1402,28 @@ type UserInput = string | Readonly<{
     metadata?: Metadata;
 }>;
 type HistorySeed = readonly Message[];
+type ContextStatus = Readonly<{
+    tokens: number;
+    contextWindow: number;
+    percent: number;
+    thresholdTokens: number;
+    estimated: boolean;
+    coveredThrough?: Readonly<{
+        messageId: MessageId;
+        sequence: number;
+    }>;
+}>;
+type ContextCompactionRecord = Readonly<{
+    id: string;
+    agentId: AgentId;
+    summary: string;
+    coveredThrough?: Readonly<{
+        messageId: MessageId;
+        sequence: number;
+    }>;
+    instructions?: string;
+    createdAt: string;
+}>;
 type ToolInvocationContext = Readonly<{
     agentId: AgentId;
     runId: RunId;
@@ -1288,9 +1436,11 @@ type ToolInvocationContext = Readonly<{
 }>;
 type Tool = Readonly<{
     name: string;
+    /** Rowan-owned Core Tool; Core Tools bypass Definition/Phase filtering. */
+    core?: boolean;
     description: string;
     parameters: Type.TSchema;
-    execute(args: JsonValue, context: ToolInvocationContext, signal: AbortSignal): Promise<ToolExecutionResult>;
+    execute(args: JsonValue, context: ToolInvocationContext, signal: AbortSignal): Promise<ToolExecutionResult$1>;
 }>;
 type ContextCandidate = Readonly<{
     name: string;
@@ -1314,10 +1464,10 @@ type BeforeToolCall = (input: Readonly<{
 }>>;
 type AfterToolCall = (input: Readonly<{
     tool: Tool;
-    result: ToolExecutionResult;
+    result: ToolExecutionResult$1;
     context: ToolInvocationContext;
     signal: AbortSignal;
-}>) => ToolExecutionResult | Promise<ToolExecutionResult>;
+}>) => ToolExecutionResult$1 | Promise<ToolExecutionResult$1>;
 type AgentResources = Readonly<{
     tools: readonly Tool[];
     skills: readonly Skill[];
@@ -1328,6 +1478,16 @@ type AgentResources = Readonly<{
     resourceRefs?: readonly ResourceRef[];
     resourceRevisions?: Readonly<Record<ResourceKind, readonly string[]>>;
 }>;
+type InvocationSource = "auto" | "implicit" | "external";
+type InvocationCatalogEntry = Readonly<{
+    kind: "phase" | "skill";
+    name: string;
+    description: string;
+    core?: boolean;
+    disableAutoInvocation: boolean;
+    disableImplicitInvocation: boolean;
+    filePath: string;
+}>;
 type AgentConfig = Readonly<{
     identity: string;
     definition: AgentDefinition;
@@ -1390,6 +1550,7 @@ type InputRequiredCommit = Readonly<{
     run: RunRecord;
     prompt: AssistantMessage;
     request: InputRequest;
+    interactions: readonly PhaseInteraction[];
 }>;
 type ToolCallReservation = Readonly<{
     providerToolCallId: string;
@@ -1422,6 +1583,8 @@ type RunRecord = Readonly<{
     pinnedConfigToken?: ConfigToken;
     checkpoint?: ExecutionCheckpoint;
     openInputRequest?: InputRequest;
+    openInteractions?: readonly PhaseInteraction[];
+    interactionAnswers?: Readonly<Record<string, JsonValue>>;
     execution?: ExecutionToken;
     outcome?: Outcome;
     failure?: RunFailure;
@@ -1488,6 +1651,8 @@ type RunSnapshot = RunSnapshotBase & (Readonly<{
         phase: string;
         prompt: AssistantMessage;
     }>;
+    interactions: readonly PhaseInteraction[];
+    answers: Readonly<Record<string, JsonValue>>;
 }> | Readonly<{
     state: "completed";
     outcome: Outcome;
@@ -1504,6 +1669,8 @@ type RunBoundary = Readonly<{
     requestId: InputRequestId;
     phase: string;
     prompt: AssistantMessage;
+    interactions: readonly PhaseInteraction[];
+    answers: Readonly<Record<string, JsonValue>>;
 }> | Readonly<{
     type: "completed";
     outcome: Outcome;
@@ -1574,6 +1741,9 @@ interface OwnedStore {
         now?: string;
         retentionMs?: number;
     }): Promise<RetentionResult>;
+    contextStatus(agentId: AgentId, contextWindow: number): Promise<ContextStatus>;
+    contextMessages(agentId: AgentId, recentTokenBudget?: number): Promise<readonly Message[]>;
+    commitContextCompaction(record: ContextCompactionRecord): Promise<ContextCompactionRecord>;
     createRun(input: {
         agentId: AgentId;
         input: UserInput;
@@ -1600,6 +1770,8 @@ interface OwnedStore {
         phase: string;
         prompt: AssistantMessage;
         checkpoint: ExecutionCheckpoint;
+        interactions?: readonly PhaseInteraction[];
+        interactionAnswers?: Readonly<Record<string, JsonValue>>;
     }): Promise<InputRequiredCommit>;
     answerInput(input: {
         runId: RunId;
@@ -1608,6 +1780,12 @@ interface OwnedStore {
         input: UserInput;
         messageId?: MessageId;
     }): Promise<RunRecord>;
+    answerInteraction(input: {
+        runId: RunId;
+        interactionId: string;
+        expectedRevision: number;
+        input: JsonValue;
+    }): Promise<RunRecord>;
     commitOutcome(input: {
         runId: RunId;
         execution: ExecutionToken;
@@ -1644,7 +1822,7 @@ interface OwnedStore {
         execution: ExecutionToken;
         expectedRevision: number;
         toolCallId: ToolCallId;
-        result: ToolExecutionResult;
+        result: ToolExecutionResult$1;
         state: "completed" | "failed" | "indeterminate";
         reason?: string;
     }): Promise<ToolCommit>;
@@ -1703,6 +1881,10 @@ interface AgentRun {
         requestId: InputRequestId;
         input: UserInput;
     }): Promise<void>;
+    respondInteraction(input: {
+        interactionId: string;
+        input: JsonValue;
+    }): Promise<void>;
     cancel(reason?: string): Promise<RunBoundary>;
 }
 interface AgentRuntime$1 {
@@ -1742,6 +1924,16 @@ interface AgentRuntime$1 {
         metadata?: Metadata;
     }): Promise<AgentRun>;
     run(runId: RunId): AgentRun;
+    contextStatus(agentId: AgentId, options?: {
+        contextWindow?: number;
+    }): Promise<ContextStatus>;
+    compactContext(agentId: AgentId, options?: {
+        instructions?: string;
+        idempotencyKey?: string;
+    }): Promise<AgentRun>;
+    listInvocations(agentId: AgentId, options: {
+        source: InvocationSource;
+    }): Promise<readonly InvocationCatalogEntry[]>;
     history(agentId: AgentId): Promise<readonly Message[]>;
     listAgents(input?: {
         after?: AgentListCursor;
@@ -1777,6 +1969,7 @@ declare class AgentRuntime implements AgentRuntime$1 {
     private readonly executionDone;
     private readonly cancellationRequested;
     private readonly cancellationReasons;
+    private readonly autoCompactionRuns;
     private readonly consumers;
     private readonly transientEvents;
     private readonly resources;
@@ -1822,6 +2015,13 @@ declare class AgentRuntime implements AgentRuntime$1 {
         retentionFloor: EventCursor;
         skipped?: "active_consumers" | "no_eligible_events";
     }>>;
+    contextStatus(agentId: AgentId, options?: {
+        contextWindow?: number;
+    }): Promise<ContextStatus>;
+    compactContext(agentId: AgentId, options?: {
+        instructions?: string;
+        idempotencyKey?: string;
+    }): Promise<AgentRun>;
     start(agentId: AgentId, input: UserInput, options: {
         idempotencyKey: string;
         metadata?: Metadata;
@@ -1837,6 +2037,9 @@ declare class AgentRuntime implements AgentRuntime$1 {
         after?: RunListCursor;
         limit?: number;
     }): Promise<Page<RunSummary, RunListCursor>>;
+    listInvocations(agentId: AgentId, options: {
+        source: InvocationSource;
+    }): Promise<readonly InvocationCatalogEntry[]>;
     consume(input: {
         consumerId: string;
         signal: AbortSignal;
@@ -1851,14 +2054,20 @@ declare class AgentRuntime implements AgentRuntime$1 {
         requestId: InputRequestId;
         input: UserInput;
     }): Promise<void>;
+    respondInteraction(runId: RunId, input: {
+        interactionId: string;
+        input: JsonValue;
+    }): Promise<void>;
     cancel(runId: RunId, reason?: string): Promise<RunBoundary>;
     private pump;
     private execute;
     private failQueued;
+    private resolveContextWindow;
     private executeTool;
     private executeToolBatch;
     private executeReservedTool;
     private requireAgent;
+    private archiveDirFor;
     private runConsumer;
     observe(runId: RunId, options?: {
         after?: EventCursor;
@@ -1891,6 +2100,7 @@ type InMemoryStoreState = Readonly<{
     nextAgentSequence: readonly (readonly [AgentId, number])[];
     nextReadySequence: readonly (readonly [AgentId, number])[];
     eventSequence: number;
+    contextCompactions?: readonly (readonly [AgentId, ContextCompactionRecord])[];
 }>;
 declare class InMemoryStore implements DurableStore {
     private readonly incarnation;
@@ -1909,6 +2119,7 @@ declare class InMemoryStore implements DurableStore {
     private ownerEpoch;
     private eventSequence;
     private retentionFloor;
+    private readonly contextCompactions;
     constructor(options?: {
         incarnation?: string;
     });
@@ -1973,6 +2184,8 @@ declare class InMemoryStore implements DurableStore {
         phase: string;
         prompt: AssistantMessage;
         checkpoint: ExecutionCheckpoint;
+        interactions?: readonly PhaseInteraction[];
+        interactionAnswers?: Readonly<Record<string, JsonValue>>;
     }): InputRequiredCommit;
     answerInput(lease: OwnerLease, input: {
         runId: RunId;
@@ -1981,6 +2194,12 @@ declare class InMemoryStore implements DurableStore {
         input: UserInput;
         messageId?: MessageId;
     }): RunRecord;
+    answerInteraction(lease: OwnerLease, input: {
+        runId: RunId;
+        interactionId: string;
+        expectedRevision: number;
+        input: JsonValue;
+    }): RunRecord;
     reserveToolCall(lease: OwnerLease, input: {
         runId: RunId;
         execution: ExecutionToken;
@@ -2014,7 +2233,7 @@ declare class InMemoryStore implements DurableStore {
         execution: ExecutionToken;
         expectedRevision: number;
         toolCallId: ToolCallId;
-        result: ToolExecutionResult;
+        result: ToolExecutionResult$1;
         state: "completed" | "failed" | "indeterminate";
         reason?: string;
     }): ToolCommit;
@@ -2067,6 +2286,9 @@ declare class InMemoryStore implements DurableStore {
     private nextMessageSequence;
     private messagesForRun;
     history(lease: OwnerLease, agentId: AgentId): readonly Message[];
+    contextStatus(lease: OwnerLease, agentId: AgentId, contextWindow: number): ContextStatus;
+    contextMessages(lease: OwnerLease, agentId: AgentId, recentTokenBudget?: number): readonly Message[];
+    commitContextCompaction(lease: OwnerLease, record: ContextCompactionRecord): ContextCompactionRecord;
     private activeHistory;
     private appendMessage;
     private appendTransition;
@@ -2078,6 +2300,10 @@ declare class InMemoryStore implements DurableStore {
 
 declare class SqliteStore implements DurableStore {
     private readonly database;
+    private readonly archiveRoot;
+    private readonly mirroredEventIds;
+    private readonly mirroredCompactionIds;
+    private mirroredAgents;
     private closed;
     private configured;
     constructor(filename?: string);
@@ -2086,6 +2312,8 @@ declare class SqliteStore implements DurableStore {
         leaseMs: number;
     }): Promise<OwnedStore>;
     close(): void;
+    /** Filesystem location owned by this Store for one Agent's readable archive. */
+    contextArchiveDir(agentId: AgentId): string;
     reserveAgent(lease: OwnerLease, input: {
         idempotencyKey: string;
         metadata?: Metadata;
@@ -2108,6 +2336,9 @@ declare class SqliteStore implements DurableStore {
         operationId: string;
         effectDigestConfirmation?: string;
     }): Promise<MessageRevisionResult>;
+    contextStatus(lease: OwnerLease, agentId: AgentId, contextWindow: number): Promise<ContextStatus>;
+    contextMessages(lease: OwnerLease, agentId: AgentId, recentTokenBudget?: number): Promise<readonly Message[]>;
+    commitContextCompaction(lease: OwnerLease, record: ContextCompactionRecord): Promise<ContextCompactionRecord>;
     createRun(lease: OwnerLease, input: {
         agentId: AgentId;
         input: UserInput;
@@ -2136,6 +2367,8 @@ declare class SqliteStore implements DurableStore {
         phase: string;
         prompt: AssistantMessage;
         checkpoint: ExecutionCheckpoint;
+        interactions?: readonly PhaseInteraction[];
+        interactionAnswers?: Readonly<Record<string, JsonValue>>;
     }): Promise<InputRequiredCommit>;
     answerInput(lease: OwnerLease, input: {
         runId: RunId;
@@ -2144,6 +2377,12 @@ declare class SqliteStore implements DurableStore {
         input: UserInput;
         messageId?: MessageId;
     }): Promise<RunRecord>;
+    answerInteraction(lease: OwnerLease, input: {
+        runId: RunId;
+        interactionId: string;
+        expectedRevision: number;
+        input: JsonValue;
+    }): Promise<RunRecord>;
     commitOutcome(lease: OwnerLease, input: {
         runId: RunId;
         execution: ExecutionToken;
@@ -2185,7 +2424,7 @@ declare class SqliteStore implements DurableStore {
         execution: ExecutionToken;
         expectedRevision: number;
         toolCallId: ToolCallId;
-        result: ToolExecutionResult;
+        result: ToolExecutionResult$1;
         state: "completed" | "failed" | "indeterminate";
         reason?: string;
     }): Promise<ToolCommit>;
@@ -2226,6 +2465,8 @@ declare class SqliteStore implements DurableStore {
     private readState;
     private writeState;
     private persistState;
+    /** Append the semantic durable event mirror and remove deleted Agent sidecars. */
+    private mirrorState;
     private requireMatchingOwner;
     private immediateTransaction;
     private readTransaction;
@@ -2252,7 +2493,7 @@ declare class InMemoryConfigProvider implements ConfigProvider {
 }
 declare function brandConfigToken(raw: unknown): ConfigToken;
 
-type RuntimeErrorCode = "invalid_argument" | "runtime_closed" | "runtime_already_owned" | "runtime_ownership_lost" | "agent_not_found" | "run_not_found" | "run_state_conflict" | "message_revision_conflict" | "tool_effect_confirmation_required" | "input_request_conflict" | "idempotency_conflict" | "configuration_unavailable" | "checkpoint_incompatible" | "consumer_already_active" | "invalid_cursor" | "store_unavailable" | "unsupported_store_version";
+type RuntimeErrorCode = "invalid_argument" | "runtime_closed" | "runtime_already_owned" | "runtime_ownership_lost" | "agent_not_found" | "run_not_found" | "run_state_conflict" | "context_busy" | "message_history_compacted" | "message_revision_conflict" | "tool_effect_confirmation_required" | "input_request_conflict" | "idempotency_conflict" | "configuration_unavailable" | "checkpoint_incompatible" | "consumer_already_active" | "invalid_cursor" | "store_unavailable" | "unsupported_store_version";
 type RuntimeErrorDetails = {
     invalid_argument: Readonly<{
         argument: string;
@@ -2280,6 +2521,15 @@ type RuntimeErrorDetails = {
         expected: readonly RunState[];
         actual: RunState;
     }>;
+    context_busy: Readonly<{
+        agentId: AgentId;
+        runId?: RunId;
+        actual: RunState;
+    }>;
+    message_history_compacted: Readonly<{
+        agentId: AgentId;
+        messageId: MessageId;
+    }>;
     message_revision_conflict: Readonly<{
         agentId: AgentId;
         messageId: MessageId;
@@ -2366,6 +2616,14 @@ declare function loadPhase(targetPath: string): Promise<Phase>;
  */
 declare function loadPhases(targetPath: string): Promise<PhaseRegistry>;
 
+declare const DEFAULT_PHASE_ID = "default";
+declare const STOP_PHASE_ID = "stop";
+declare const COMPACT_PHASE_ID = "compact";
+declare function createDefaultPhase(): Phase;
+declare function createStopPhase(): Phase;
+declare function createCompactPhase(): Phase;
+declare function createCorePhases(): Phase[];
+
 /**
  * Extension loader — discovers and loads extensions from the filesystem.
  *
@@ -2399,4 +2657,4 @@ declare function parseFrontmatter<T = Record<string, unknown>>(raw: string): Fro
 
 declare function createCoreTools(input?: CoreToolContext): Tool[];
 
-export { type AfterToolCall, type AgentConfig, type AgentConfigRequest, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, type AgentResources, type AgentRun, AgentRuntime, type AgentRuntimeOptions, type AgentSummary, type AnyRuntimeError, type AssistantContent, type AssistantMessage, type BeforeToolCall, type ConfigProvider, type ConfigPutResult, type ConfigResolution, type ConfigToken, type ConfigurationSnapshot, type ContextCandidate, type CoreToolContext, 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 InputRequest, type InputRequestId, type InputRequiredCommit, 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 PhaseExecutionIdentity, type PhaseInvocation, type PhaseOutput, type PhaseRegistry, type PhaseRegistrySelection, type PhaseState, 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 RunListCursor, type RunRecord, type RunSnapshot, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, type Skill, SqliteStore, type TextContent, type ThinkingContent, type Tool, 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, createCoreTools, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhases, loadSkill, loadSkills, materializeConfigurationSnapshot, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };
+export { type AfterToolCall, type AgentConfig, type AgentConfigRequest, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, type AgentResources, 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 InputRequest, type InputRequestId, type InputRequiredCommit, 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 PhaseInteraction, PhaseInteractionBoundary, PhaseInteractionCancelledError, type PhaseInteractionDriver, type PhaseInteractionKind, type PhaseInteractionState, type PhaseInteractionStatus, type PhaseInvocation, 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 RunEvent, type RunFailure, type RunId, 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 Tool, 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, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhases, loadSkill, loadSkills, materializeConfigurationSnapshot, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };