@rowan-agent/agent 0.6.0 → 0.6.2

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _rowan_agent_models from '@rowan-agent/models';
-import { LlmRequest, LlmResponse, LlmModelRef, LlmModelUsage, StreamFn, AgentEventListener, AgentMessage, Outcome, ToolCall, ToolResult, Skill as Skill$1, ContentBlock } from '@rowan-agent/models';
-export { AgentEvent, AgentEventListener, AgentMessage, LlmModelRef, Outcome, Skill, StreamFn, ToolResult } from '@rowan-agent/models';
+import { LlmRequest, LlmResponse, ModelRef, LlmModelUsage, Outcome, AgentMessage, ToolResult, StreamFn, AgentEventListener, ToolCall, Skill as Skill$1, ContentBlock, ModelConfig } from '@rowan-agent/models';
+export { AgentEvent, AgentEventListener, AgentMessage, ModelConfig, ModelRef, Outcome, Skill, StreamFn, ToolResult } from '@rowan-agent/models';
 import Type from 'typebox';
 
 type ExecutionTurn = {
@@ -10,7 +10,7 @@ type ExecutionTurn = {
     phase: string;
     requestedAtMs: number;
     completedAtMs: number;
-    model: LlmModelRef;
+    model: ModelRef;
     usage?: LlmModelUsage;
 };
 /** Raw model input/output for session persistence. */
@@ -19,6 +19,106 @@ type ModelTranscript = {
     response: LlmResponse;
 };
 
+declare const opaqueIdBrand: unique symbol;
+type OpaqueId<Kind extends string> = string & {
+    readonly [opaqueIdBrand]: Kind;
+};
+type AgentId = OpaqueId<"AgentId">;
+type AgentRunId = OpaqueId<"AgentRunId">;
+type RuntimeMessageId = OpaqueId<"RuntimeMessageId">;
+type RuntimeEventId = OpaqueId<"RuntimeEventId">;
+type LeaseId = OpaqueId<"LeaseId">;
+type RuntimeToolCallId = OpaqueId<"RuntimeToolCallId">;
+type AgentLifecycleState = "active" | "paused";
+type RuntimeMessageState = "queued" | "leased" | "acknowledged" | "dead_lettered";
+type AgentRunState = "queued" | "running" | "suspended" | "completed" | "failed" | "cancelled";
+/** Opaque execution checkpoint owned by the Agent loop and persisted by Runtime. */
+type AgentRunExecutionState = Readonly<Record<string, unknown>>;
+/** Host-owned correlation data persisted with a Run and echoed by Runtime Events. */
+type AgentRunMetadata = Readonly<Record<string, unknown>>;
+type AgentInputRequest = {
+    phase: string;
+    prompt: string;
+    requestedAt: string;
+};
+type RuntimeToolCallState = "queued" | "running" | "completed" | "failed" | "indeterminate";
+type AgentRecord = {
+    id: AgentId;
+    sessionId: string;
+    state: AgentLifecycleState;
+    createdAt: string;
+    updatedAt: string;
+};
+type RuntimeLease = {
+    id: LeaseId;
+    runId: AgentRunId;
+    workerId: string;
+    leasedAt: string;
+    expiresAt: string;
+};
+type RuntimeMessage = {
+    id: RuntimeMessageId;
+    agentId: AgentId;
+    kind: "agent_input";
+    input: AgentMessage;
+    state: RuntimeMessageState;
+    attempts: number;
+    runId?: AgentRunId;
+    lease?: RuntimeLease;
+    deadLetterReason?: string;
+    createdAt: string;
+    updatedAt: string;
+};
+type AgentRunRecord = {
+    id: AgentRunId;
+    agentId: AgentId;
+    messageId: RuntimeMessageId;
+    state: AgentRunState;
+    attempt: number;
+    leaseId?: LeaseId;
+    outcome?: Outcome;
+    suspensionReason?: string;
+    inputRequest?: AgentInputRequest;
+    executionState?: AgentRunExecutionState;
+    metadata?: AgentRunMetadata;
+    createdAt: string;
+    updatedAt: string;
+};
+type RuntimeEventKind = "agent_created" | "agent_paused" | "agent_resumed" | "message_enqueued" | "run_enqueued" | "run_leased" | "lease_expired" | "lease_recovered" | "run_suspended" | "run_retry_scheduled" | "run_completed" | "run_aborted" | "message_acknowledged" | "message_dead_lettered" | "tool_call_created" | "tool_call_started" | "tool_call_failed" | "tool_call_completed" | "tool_call_indeterminate";
+type RuntimeEvent = {
+    id: RuntimeEventId;
+    sequence: number;
+    kind: RuntimeEventKind;
+    agentId?: AgentId;
+    messageId?: RuntimeMessageId;
+    runId?: AgentRunId;
+    toolCallId?: RuntimeToolCallId;
+    payload?: unknown;
+    createdAt: string;
+};
+type RuntimeEventCursor = {
+    after?: RuntimeEventId;
+    limit?: number;
+};
+type RuntimeEventCheckpoint = {
+    consumerId: string;
+    sequence: number;
+    eventId?: RuntimeEventId;
+    updatedAt: string;
+};
+type RuntimeToolCall = {
+    id: RuntimeToolCallId;
+    agentId: AgentId;
+    runId: AgentRunId;
+    name: string;
+    args: unknown;
+    state: RuntimeToolCallState;
+    result?: ToolResult;
+    indeterminateReason?: string;
+    createdAt: string;
+    updatedAt: string;
+};
+
 type BeforePhaseHook = (phaseId: string, input: PhaseContext) => Promise<BeforePhaseHookResult>;
 type AfterPhaseHook = (phaseId: string, output: PhaseOutput) => Promise<AfterPhaseHookResult>;
 type BeforePromptHook = (phaseId: string, input: PhaseContext) => Promise<PhaseContext>;
@@ -48,10 +148,21 @@ type SessionState = {
     currentPhase: string;
     attempt: number;
     metrics: LoopMetrics;
-    status: "idle" | "running" | "completed" | "aborted" | "failed";
+    status: "idle" | "running" | "suspended" | "completed" | "aborted" | "failed";
+    continuation?: SessionContinuationState;
+};
+type SessionContinuationState = {
+    isContinuing: boolean;
+    previousPayload?: unknown;
+    previousResults: Array<{
+        name: string;
+        output?: unknown;
+    }>;
+    pendingInstruction?: string;
+    previousPhaseMessageId?: string;
 };
 type AgentConfig = {
-    model: LlmModelRef;
+    model: ModelRef;
     stream: StreamFn;
     context: AgentContext;
     sessionId?: string;
@@ -67,12 +178,12 @@ type AgentConfig = {
     beforePrompt?: BeforePromptHook;
     onModelTranscript?: (transcript: ModelTranscript, meta: {
         phase: string;
-        model: LlmModelRef;
+        model: ModelRef;
     }) => Promise<void>;
     onMessage?: (message: AgentMessage) => Promise<void>;
     onOutcome?: (outcome: Outcome) => Promise<void>;
     /** Internal: await next user messages before retrying the same phase. */
-    waitForInput?: () => Promise<AgentMessage[]>;
+    waitForInput?: (state?: SessionState, inputRequest?: AgentInputRequest) => Promise<AgentMessage[]>;
 };
 type ToolRunnerInput = {
     config: AgentConfig;
@@ -182,6 +293,17 @@ interface PhaseState {
     iterations: number;
     payload?: unknown;
 }
+type PhaseInvocation = {
+    mode: "serial";
+    instanceId: string;
+} | {
+    mode: "parallel";
+    instanceId: string;
+    groupId: string;
+    index: number;
+    count: number;
+    sourcePhaseId: string;
+};
 /** Everything a phase needs to execute */
 interface PhaseContext {
     systemPrompt: string;
@@ -192,6 +314,8 @@ interface PhaseContext {
     skills: Skill$1[];
     /** Phase machine state */
     state: PhaseState;
+    /** Identity and dispatch metadata for this phase execution */
+    readonly invocation: PhaseInvocation;
     /** Additional guideline bullets appended to the system prompt */
     promptGuidelines?: string[];
     /** Text to append after the system prompt */
@@ -224,10 +348,10 @@ interface Phase {
     /** PHASE.md body content */
     content: string;
     /** Model override for this phase (resolved from frontmatter) */
-    model?: LlmModelRef;
+    model?: ModelRef;
     /** ExtensionAPI factory function (default export pattern) */
     factory?: (api: ExtensionAPI) => Promise<void>;
-    /** Legacy run function */
+    /** Direct run function */
     run?: (context: PhaseContext, execution: PhaseExecution) => Promise<PhaseOutput | void>;
 }
 /**
@@ -925,95 +1049,6 @@ interface ExtensionAPI {
  */
 type ExtensionFactory = (api: ExtensionAPI) => void | Promise<void>;
 
-declare const opaqueIdBrand: unique symbol;
-type OpaqueId<Kind extends string> = string & {
-    readonly [opaqueIdBrand]: Kind;
-};
-type AgentId = OpaqueId<"AgentId">;
-type AgentRunId = OpaqueId<"AgentRunId">;
-type RuntimeMessageId = OpaqueId<"RuntimeMessageId">;
-type RuntimeEventId = OpaqueId<"RuntimeEventId">;
-type LeaseId = OpaqueId<"LeaseId">;
-type RuntimeToolCallId = OpaqueId<"RuntimeToolCallId">;
-type AgentLifecycleState = "active" | "paused";
-type RuntimeMessageState = "queued" | "leased" | "acknowledged" | "dead_lettered";
-type AgentRunState = "queued" | "running" | "suspended" | "completed" | "failed" | "cancelled";
-type RuntimeToolCallState = "queued" | "running" | "completed" | "failed" | "indeterminate";
-type AgentRecord = {
-    id: AgentId;
-    sessionId: string;
-    factoryId?: string;
-    state: AgentLifecycleState;
-    createdAt: string;
-    updatedAt: string;
-};
-type RuntimeLease = {
-    id: LeaseId;
-    runId: AgentRunId;
-    workerId: string;
-    leasedAt: string;
-    expiresAt: string;
-};
-type RuntimeMessage = {
-    id: RuntimeMessageId;
-    agentId: AgentId;
-    kind: "agent_input";
-    input: AgentMessage;
-    state: RuntimeMessageState;
-    attempts: number;
-    runId?: AgentRunId;
-    lease?: RuntimeLease;
-    deadLetterReason?: string;
-    createdAt: string;
-    updatedAt: string;
-};
-type AgentRunRecord = {
-    id: AgentRunId;
-    agentId: AgentId;
-    messageId: RuntimeMessageId;
-    state: AgentRunState;
-    attempt: number;
-    leaseId?: LeaseId;
-    outcome?: Outcome;
-    suspensionReason?: string;
-    createdAt: string;
-    updatedAt: string;
-};
-type RuntimeEventKind = "agent_created" | "agent_paused" | "agent_resumed" | "agent_recovered" | "agent_recovery_failed" | "factory_missing" | "message_enqueued" | "run_enqueued" | "run_leased" | "lease_expired" | "lease_recovered" | "run_suspended" | "run_retry_scheduled" | "run_completed" | "run_aborted" | "message_acknowledged" | "message_dead_lettered" | "tool_call_created" | "tool_call_started" | "tool_call_failed" | "tool_call_completed" | "tool_call_indeterminate";
-type RuntimeEvent = {
-    id: RuntimeEventId;
-    sequence: number;
-    kind: RuntimeEventKind;
-    agentId?: AgentId;
-    messageId?: RuntimeMessageId;
-    runId?: AgentRunId;
-    toolCallId?: RuntimeToolCallId;
-    payload?: unknown;
-    createdAt: string;
-};
-type RuntimeEventCursor = {
-    after?: RuntimeEventId;
-    limit?: number;
-};
-type RuntimeEventCheckpoint = {
-    consumerId: string;
-    sequence: number;
-    eventId?: RuntimeEventId;
-    updatedAt: string;
-};
-type RuntimeToolCall = {
-    id: RuntimeToolCallId;
-    agentId: AgentId;
-    runId: AgentRunId;
-    name: string;
-    args: unknown;
-    state: RuntimeToolCallState;
-    result?: ToolResult;
-    indeterminateReason?: string;
-    createdAt: string;
-    updatedAt: string;
-};
-
 /**
  * Load all phases from the target directory.
  *
@@ -1026,21 +1061,22 @@ type RuntimeToolCall = {
  */
 declare function loadPhases(targetPath: string): Promise<PhaseRegistry>;
 
-type AgentExecutionOptions = AgentOptions & {
+type AgentExecutionOptions = StreamAgentOptions & {
     sessionId?: string;
     agentId?: AgentId;
+    sessionState?: SessionState;
     onInput?: (message: AgentMessage) => Promise<void>;
     runtime?: AgentRuntimePort;
 };
 type RunOptions = Partial<AgentExecutionOptions>;
 type RuntimeRunHooks = {
-    onSuspend?: (reason?: string) => Promise<void> | void;
+    onSuspend?: (reason?: string, state?: SessionState, inputRequest?: AgentInputRequest) => Promise<void> | void;
 };
 type AgentStatus = {
     agentId?: AgentId;
     sessionId?: string;
     context: AgentContext;
-    model: LlmModelRef;
+    model: ModelRef;
     tools: Tool[];
     initialized: boolean;
     running: boolean;
@@ -1071,7 +1107,7 @@ declare class AgentExecution {
     runWithUserInput(input: string, options?: RunOptions): Promise<RunResult>;
     runWithMessage(message: AgentMessage, options?: RunOptions, internalHooks?: RuntimeRunHooks): Promise<RunResult>;
     /** Internal Runtime seam: executes one leased Agent Input. */
-    executeAgentInput(input: AgentMessage, runId: AgentRunId, control: AgentRunControl): Promise<Outcome>;
+    executeAgentInput(input: AgentMessage, runId: AgentRunId, control: AgentRunControl, executionState?: AgentRunExecutionState): Promise<Outcome>;
     resetInitialization(): void;
     getContext(): AgentContext;
     setContext(context: AgentContext): void;
@@ -1090,13 +1126,13 @@ declare class AgentExecution {
     getAgentId(): AgentId | undefined;
     /** Internal Runtime hook for associating Tool Calls with the leased Run. */
     getRuntimeRunId(): AgentRunId | undefined;
-    setModel(model: LlmModelRef): void;
+    setModel(model: ModelRef): void;
     setTools(tools: Tool[]): void;
     setSkills(skills: Skill$1[]): void;
     setPhases(phases: PhaseRegistry): void;
     setCwd(cwd: string): void;
     setStream(stream: StreamFn): void;
-    getModel(): LlmModelRef;
+    getModel(): ModelRef;
     getTools(): Tool[];
     getSkills(): Skill$1[];
     getPhases(): PhaseRegistry | undefined;
@@ -1135,6 +1171,7 @@ declare class AgentExecution {
     private loadExtensions;
     run(config?: RunOptions, internalHooks?: RuntimeRunHooks): Promise<RunResult>;
     abort(reason?: string): void;
+    isSuspended(): boolean;
     private abortLocal;
     /** Internal Runtime hook; public callers abort a precise AgentRun. */
     abortFromRuntime(reason?: string): void;
@@ -1208,7 +1245,7 @@ type SessionManager = {
     appendOutcome(outcome: Outcome): Promise<string>;
     appendModelTranscript(transcript: ModelTranscript, meta?: {
         phase?: string;
-        model?: LlmModelRef;
+        model?: ModelRef;
     }): Promise<string>;
     buildAgentContext<TTool = unknown>(input?: BuildAgentContextInput<TTool>): Promise<SessionAgentContext<TTool>>;
 };
@@ -1219,12 +1256,24 @@ type SessionManagerProvider = {
 
 type CreateAgentInput = {
     sessionId: string;
-    factoryId?: string;
 };
 type EnqueueAgentInput = {
     agentId: AgentId;
     input: AgentMessage;
 };
+type AcknowledgeEventAndEnqueueAgentInput = EnqueueAgentInput & {
+    consumerId: string;
+    eventId: RuntimeEventId;
+};
+type EnqueuedAgentInput = {
+    message: RuntimeMessage;
+    run: AgentRunRecord;
+    resumed: boolean;
+};
+type AcknowledgeEventAndEnqueueAgentInputResult = {
+    checkpoint: RuntimeEventCheckpoint;
+    enqueued?: EnqueuedAgentInput;
+};
 type ListRunsInput = {
     agentId?: AgentId;
     states?: AgentRunRecord["state"][];
@@ -1254,6 +1303,8 @@ type RenewLeaseInput = {
 type SuspendRunInput = {
     runId: AgentRunId;
     reason?: string;
+    inputRequest?: AgentInputRequest;
+    executionState?: AgentRunExecutionState;
 };
 type CompleteRunInput = {
     runId: AgentRunId;
@@ -1293,14 +1344,11 @@ interface RuntimeStateStore {
     getAgent(agentId: AgentId): Promise<AgentRecord | undefined>;
     listAgents(): Promise<AgentRecord[]>;
     setAgentState(agentId: AgentId, state: AgentLifecycleState): Promise<AgentRecord>;
-    enqueueAgentInput(input: EnqueueAgentInput): Promise<{
-        message: RuntimeMessage;
-        run: AgentRunRecord;
-        resumed: boolean;
-    }>;
+    enqueueAgentInput(input: EnqueueAgentInput): Promise<EnqueuedAgentInput>;
     getMessage(messageId: RuntimeMessageId): Promise<RuntimeMessage | undefined>;
     getRun(runId: AgentRunId): Promise<AgentRunRecord | undefined>;
     listRuns(input?: ListRunsInput): Promise<AgentRunRecord[]>;
+    listActiveRuns(): Promise<AgentRunRecord[]>;
     leaseRun(input: LeaseRunInput): Promise<LeasedRun>;
     renewLease(input: RenewLeaseInput): Promise<RuntimeLease>;
     suspendRun(input: SuspendRunInput): Promise<AgentRunRecord>;
@@ -1319,6 +1367,7 @@ interface RuntimeStateStore {
     recordEvent(input: RecordRuntimeEventInput): Promise<RuntimeEvent>;
     getEventCheckpoint(consumerId: string): Promise<RuntimeEventCheckpoint>;
     acknowledgeEvent(consumerId: string, eventId: RuntimeEventId): Promise<RuntimeEventCheckpoint>;
+    acknowledgeEventAndEnqueueAgentInput(input: AcknowledgeEventAndEnqueueAgentInput): Promise<AcknowledgeEventAndEnqueueAgentInputResult>;
 }
 
 type ToolRuntimePolicy = {
@@ -1328,16 +1377,9 @@ type ToolRuntimePolicy = {
     perToolMaxConcurrent?: Readonly<Record<string, number>>;
 };
 
-type AgentFactoryIdentity = {
-    agentId: AgentId;
-    sessionId: string;
-    factoryId: string;
-};
-type AgentFactory = (identity: AgentFactoryIdentity) => Promise<AgentOptions | undefined> | AgentOptions | undefined;
 type AgentRuntimeOptions = {
     stateStore: RuntimeStateStore;
     sessionProvider?: SessionManagerProvider;
-    factories?: ReadonlyMap<string, AgentFactory> | Readonly<Record<string, AgentFactory>>;
     toolPolicy?: ToolRuntimePolicy;
     maxConcurrentRuns?: number;
     maxInfrastructureAttempts?: number;
@@ -1347,7 +1389,16 @@ type AgentRuntimeOptions = {
 type RuntimeRunHandle = {
     notify(run: AgentRunRecord): void;
 };
-type RuntimeEventListener = (event: RuntimeEvent) => void | Promise<void>;
+type RuntimeEventDisposition = {
+    type: "enqueue";
+    agentId: AgentId;
+    input: AgentMessage;
+};
+type RuntimeEventListener = (event: RuntimeEvent) => RuntimeEventDisposition | void | Promise<RuntimeEventDisposition | void>;
+type RuntimeEventConsumer = {
+    caughtUp: Promise<void>;
+    stop(): void;
+};
 declare class AgentRuntime {
     private readonly stateStore;
     private readonly sessionProvider?;
@@ -1356,8 +1407,8 @@ declare class AgentRuntime {
     private readonly leaseDurationMs;
     private readonly leaseRenewalIntervalMs;
     private readonly toolRuntime;
-    private readonly factories;
     private readonly bindings;
+    private readonly agents;
     private readonly runHandles;
     private readonly runWaiters;
     private readonly pendingRuns;
@@ -1369,10 +1420,11 @@ declare class AgentRuntime {
     private runningRuns;
     private pumping;
     private nextWorkerId;
+    private leaseRecoveryTimer;
     private stopped;
     private constructor();
     static start(options: AgentRuntimeOptions): Promise<AgentRuntime>;
-    createAgent(options: AgentCreateOptions): Promise<Agent>;
+    createAgent(options: AgentOptions): Promise<Agent>;
     reconstructAgent(agentId: AgentId, options: AgentOptions): Promise<Agent>;
     stop(): Promise<void>;
     private bindAgent;
@@ -1381,10 +1433,19 @@ declare class AgentRuntime {
     private scheduleRun;
     pauseAgent(agentId: AgentId): Promise<void>;
     resumeAgent(agentId: AgentId): Promise<void>;
+    getRun(runId: AgentRunId): Promise<AgentRunRecord | undefined>;
+    listActiveRuns(): Promise<AgentRunRecord[]>;
+    listRuns(input?: ListRunsInput): Promise<AgentRunRecord[]>;
+    getAgent(agentId: AgentId): Agent | undefined;
+    getMessage(messageId: RuntimeMessageId): Promise<RuntimeMessage | undefined>;
+    getToolCall(toolCallId: RuntimeToolCallId): Promise<RuntimeToolCall | undefined>;
     abortRun(runId: AgentRunId, reason?: string): Promise<void>;
-    consumeEvents(consumerId: string, listener: RuntimeEventListener): () => void;
+    consumeEvents(consumerId: string, listener: RuntimeEventListener): RuntimeEventConsumer;
+    private registerEventConsumer;
     listEvents(cursor?: RuntimeEventCursor): Promise<RuntimeEvent[]>;
     private recover;
+    private startLeaseRecovery;
+    private recoverExpiredLeases;
     private scheduleQueuedRuns;
     private attachAgent;
     private submitAgentInput;
@@ -1404,7 +1465,7 @@ type AgentRunHost = {
     getRun(runId: AgentRunId): Promise<AgentRunRecord | undefined>;
     waitForRunChange(runId: AgentRunId, state: AgentRunState, updatedAt: string): Promise<void>;
     abortRun(runId: AgentRunId, reason: string): Promise<void>;
-    consumeEvents(consumerId: string, listener: RuntimeEventListener): () => void;
+    consumeEvents(consumerId: string, listener: RuntimeEventListener): RuntimeEventConsumer;
 };
 declare const CREATE_AGENT_RUN: unique symbol;
 declare class AgentRun implements RuntimeRunHandle {
@@ -1418,18 +1479,17 @@ declare class AgentRun implements RuntimeRunHandle {
     get messageId(): string;
     get status(): AgentRunState;
     get state(): AgentRunState;
+    get inputRequest(): AgentInputRequest | undefined;
     getStatus(): Promise<AgentRunState>;
     subscribe(listener: AgentRunListener): () => void;
-    consumeRuntimeEvents(consumerId: string, listener: RuntimeEventListener): () => void;
+    consumeRuntimeEvents(consumerId: string, listener: RuntimeEventListener): RuntimeEventConsumer;
     result(): Promise<Outcome>;
     abort(reason?: string): Promise<void>;
     notify(run: AgentRunRecord): void;
 }
 
-type AgentOptions = {
+type AgentCommonOptions = {
     context: AgentContext;
-    model: LlmModelRef;
-    stream: StreamFn;
     cwd?: string;
     extensions?: LoadedExtension[];
     maxAttempts?: number;
@@ -1439,15 +1499,23 @@ type AgentOptions = {
     onOutcome?: (outcome: Outcome) => Promise<void>;
     onModelTranscript?: (transcript: ModelTranscript, meta: {
         phase: string;
-        model: LlmModelRef;
+        model: ModelRef;
     }) => Promise<void>;
 };
-type AgentCreateOptions = AgentOptions & {
-    input?: string;
-    factoryId?: string;
+type AgentModelOptions = {
+    model: ModelConfig;
+    stream?: never;
+} | {
+    model: ModelRef;
+    stream: StreamFn;
+};
+type AgentOptions = AgentCommonOptions & AgentModelOptions;
+type StreamAgentOptions = AgentCommonOptions & {
+    model: ModelRef;
+    stream: StreamFn;
 };
 type AgentRunControl = {
-    suspend(reason?: string): Promise<void>;
+    suspend(reason?: string, state?: AgentRunExecutionState, inputRequest?: AgentInputRequest): Promise<void>;
 };
 declare const ATTACH_AGENT: unique symbol;
 declare class Agent {
@@ -1465,12 +1533,12 @@ declare class Agent {
     send(input: string | AgentMessage): Promise<AgentRun>;
 }
 
-declare class InMemorySessionProvider implements SessionManagerProvider {
+declare class InMemorySessionStore implements SessionManagerProvider {
     private readonly sessions;
     create(input: CreateSessionManagerInput): Promise<SessionManager>;
     open(sessionId: string): Promise<SessionManager | undefined>;
 }
-declare class LocalJsonlSessionProvider implements SessionManagerProvider {
+declare class JsonlSessionStore implements SessionManagerProvider {
     private readonly sessionsDir;
     constructor(sessionsDir: string);
     create(input: CreateSessionManagerInput): Promise<SessionManager>;
@@ -1497,14 +1565,12 @@ declare class InMemoryRuntimeStateStore implements RuntimeStateStore {
     getAgent(agentId: AgentId): Promise<AgentRecord | undefined>;
     listAgents(): Promise<AgentRecord[]>;
     setAgentState(agentId: AgentId, state: AgentRecord["state"]): Promise<AgentRecord>;
-    enqueueAgentInput(input: EnqueueAgentInput): Promise<{
-        message: RuntimeMessage;
-        run: AgentRunRecord;
-        resumed: boolean;
-    }>;
+    enqueueAgentInput(input: EnqueueAgentInput): Promise<EnqueuedAgentInput>;
+    private enqueueAgentInputState;
     getMessage(messageId: RuntimeMessageId): Promise<RuntimeMessage | undefined>;
     getRun(runId: AgentRunId): Promise<AgentRunRecord | undefined>;
     listRuns(input?: ListRunsInput): Promise<AgentRunRecord[]>;
+    listActiveRuns(): Promise<AgentRunRecord[]>;
     leaseRun(input: LeaseRunInput): Promise<LeasedRun>;
     renewLease(input: RenewLeaseInput): Promise<RuntimeLease>;
     suspendRun(input: SuspendRunInput): Promise<AgentRunRecord>;
@@ -1523,6 +1589,7 @@ declare class InMemoryRuntimeStateStore implements RuntimeStateStore {
     recordEvent(input: RecordRuntimeEventInput | RuntimeEventKind, related?: Pick<RuntimeEvent, "agentId" | "messageId" | "runId" | "toolCallId">, payload?: unknown): Promise<RuntimeEvent>;
     getEventCheckpoint(consumerId: string): Promise<RuntimeEventCheckpoint>;
     acknowledgeEvent(consumerId: string, eventId: RuntimeEventId): Promise<RuntimeEventCheckpoint>;
+    acknowledgeEventAndEnqueueAgentInput(input: AcknowledgeEventAndEnqueueAgentInput): Promise<AcknowledgeEventAndEnqueueAgentInputResult>;
     private requireAgent;
     private requireMessage;
     private requireRun;
@@ -1538,14 +1605,12 @@ declare class SqliteRuntimeStateStore implements RuntimeStateStore {
     getAgent(agentId: AgentId): Promise<AgentRecord | undefined>;
     listAgents(): Promise<AgentRecord[]>;
     setAgentState(agentId: AgentId, state: AgentRecord["state"]): Promise<AgentRecord>;
-    enqueueAgentInput(input: EnqueueAgentInput): Promise<{
-        message: RuntimeMessage;
-        run: AgentRunRecord;
-        resumed: boolean;
-    }>;
+    enqueueAgentInput(input: EnqueueAgentInput): Promise<EnqueuedAgentInput>;
+    private enqueueAgentInputState;
     getMessage(messageId: RuntimeMessageId): Promise<RuntimeMessage | undefined>;
     getRun(runId: AgentRunId): Promise<AgentRunRecord | undefined>;
     listRuns(input?: ListRunsInput): Promise<AgentRunRecord[]>;
+    listActiveRuns(): Promise<AgentRunRecord[]>;
     leaseRun(input: LeaseRunInput): Promise<LeasedRun>;
     renewLease(input: RenewLeaseInput): Promise<RuntimeLease>;
     suspendRun(input: SuspendRunInput): Promise<AgentRunRecord>;
@@ -1564,6 +1629,8 @@ declare class SqliteRuntimeStateStore implements RuntimeStateStore {
     recordEvent(input: RecordRuntimeEventInput | RuntimeEventKind, related?: Pick<RuntimeEvent, "agentId" | "messageId" | "runId" | "toolCallId">, payload?: unknown): Promise<RuntimeEvent>;
     getEventCheckpoint(consumerId: string): Promise<RuntimeEventCheckpoint>;
     acknowledgeEvent(consumerId: string, eventId: RuntimeEventId): Promise<RuntimeEventCheckpoint>;
+    acknowledgeEventAndEnqueueAgentInput(input: AcknowledgeEventAndEnqueueAgentInput): Promise<AcknowledgeEventAndEnqueueAgentInputResult>;
+    private acknowledgeEventState;
     private insertMessage;
     private agentFromRow;
     private messageFromRow;
@@ -1581,4 +1648,4 @@ declare class SqliteRuntimeStateStore implements RuntimeStateStore {
     private recordEventInternal;
 }
 
-export { type AfterToolCall, Agent, type AgentContext, type AgentCreateOptions, type AgentFactory, type AgentFactoryIdentity, type AgentId, type AgentOptions, AgentRun, type AgentRunId, type AgentRunListener, type AgentRunState, AgentRuntime, type AgentRuntimeOptions, type BeforeToolCall, type CoreToolContext, type ExecutionTurn, type ExtensionAPI, type ExtensionFactory, type HookEvent, type HookEventType, type HookHandler, InMemoryRuntimeStateStore, InMemorySessionProvider, type LoadExtensionsResult, type LoadedExtension, LocalJsonlSessionProvider, type LoopMetrics, type ModelTranscript, type Phase, type PhaseContext, type PhaseExecution, type PhaseOutput, type PhaseRegistration, type PhaseRegistry, type PhaseState, type RuntimeEvent, type RuntimeEventCursor, type RuntimeEventKind, type RuntimeEventListener, type SessionManagerProvider, SqliteRuntimeStateStore, type Tool, type ToolContext, type ToolDefinition, type ToolExecutionMode, type ToolExecutionResult, type ToolRuntimePolicy, type Unsubscribe, createCoreTools, createMessage };
+export { type AfterToolCall, Agent, type AgentContext, type AgentId, type AgentInputRequest, type AgentOptions, AgentRun, type AgentRunExecutionState, type AgentRunId, type AgentRunListener, type AgentRunMetadata, type AgentRunRecord, type AgentRunState, AgentRuntime, type AgentRuntimeOptions, type BeforeToolCall, type CoreToolContext, type ExecutionTurn, type ExtensionAPI, type ExtensionFactory, type HookEvent, type HookEventType, type HookHandler, InMemoryRuntimeStateStore, InMemorySessionStore, JsonlSessionStore, type LoadExtensionsResult, type LoadedExtension, type LoopMetrics, type ModelTranscript, type Phase, type PhaseContext, type PhaseExecution, type PhaseInvocation, type PhaseOutput, type PhaseRegistration, type PhaseRegistry, type PhaseState, type RuntimeEvent, type RuntimeEventConsumer, type RuntimeEventCursor, type RuntimeEventDisposition, type RuntimeEventKind, type RuntimeEventListener, type RuntimeMessage, type RuntimeMessageId, type RuntimeToolCall, type RuntimeToolCallId, type SessionManagerProvider, SqliteRuntimeStateStore, type Tool, type ToolContext, type ToolDefinition, type ToolExecutionMode, type ToolExecutionResult, type ToolRuntimePolicy, type Unsubscribe, createCoreTools, createMessage };