@rowan-agent/agent 0.9.3 → 0.9.5

package/dist/index.d.ts

@@ -455,11 +455,11 @@ type ExtensionDisposer = () => void | Promise<void>;
 type ExtensionFactoryResult = void | ExtensionDisposer;
 type ExtensionFactory = (api: ExtensionAPI) => ExtensionFactoryResult | Promise<ExtensionFactoryResult>;
 
-/** Unified phase output — model decides routing via route. */
+/** Unified phase output — model-driven routing is optional; programmatic phases may normalize omission to stop. */
 type PhaseOutput = {
     message: string;
-    /** Route to next phase, or "continue" to re-execute current phase, or "stop" to end */
-    route: string;
+    /** 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) */
@@ -778,6 +778,8 @@ 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;
@@ -888,6 +890,14 @@ 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;
@@ -986,7 +996,7 @@ type ToolStateChanged = DurableEventBase & (Readonly<{
         state: "indeterminate";
     }>;
 }>);
-type DurableRunEvent = MessageCommitted | RunStateChanged | ToolStateChanged;
+type DurableRunEvent = MessageCommitted | MessageRevised | RunStateChanged | ToolStateChanged;
 type MessageDelta = Readonly<{
     kind: "message_delta";
     durability: "transient";
@@ -1265,6 +1275,7 @@ type UserInput = string | Readonly<{
     content: UserContent;
     metadata?: Metadata;
 }>;
+type HistorySeed = readonly Message[];
 type ToolInvocationContext = Readonly<{
     agentId: AgentId;
     runId: RunId;
@@ -1402,6 +1413,11 @@ type RunRecord = Readonly<{
     revision: number;
     state: RunState;
     input: UserInput;
+    initialMessageId?: MessageId;
+    invalidatedBy?: Readonly<{
+        messageId: MessageId;
+        messageRevision: number;
+    }>;
     metadata?: Metadata;
     pinnedConfigToken?: ConfigToken;
     checkpoint?: ExecutionCheckpoint;
@@ -1413,6 +1429,22 @@ type RunRecord = Readonly<{
     createdAt: string;
     updatedAt: string;
 }>;
+type MessageRevisionResult = Readonly<{
+    message: UserMessage & Readonly<{
+        messageRevision: number;
+    }>;
+    replacementRun: RunRecord;
+    invalidatedRunIds: readonly RunId[];
+    affectedToolCallIds: readonly ToolCallId[];
+    effectDigest?: string;
+}>;
+type RetentionResult = Readonly<{
+    deletedRunIds: readonly RunId[];
+    deletedToolCallIds: readonly ToolCallId[];
+    deletedEventCount: number;
+    retentionFloor: EventCursor;
+    skipped?: "active_consumers" | "no_eligible_events";
+}>;
 type AgentSummary = Readonly<{
     id: AgentId;
     metadata?: Metadata;
@@ -1520,6 +1552,7 @@ interface OwnedStore {
         idempotencyKey: string;
         metadata?: Metadata;
         configIdentity?: string;
+        historySeed?: HistorySeed;
     }): Promise<AgentRecord>;
     activateAgent(agentId: AgentId, configToken?: ConfigToken, configIdentity?: string): Promise<AgentRecord>;
     updateAgentConfigToken(input: {
@@ -1529,6 +1562,18 @@ interface OwnedStore {
         idempotencyKey: string;
     }): Promise<AgentRecord>;
     deleteAgent(input: AgentDeletionRequest): Promise<void>;
+    reviseMessage(input: {
+        agentId: AgentId;
+        messageId: MessageId;
+        expectedMessageRevision: number;
+        content: UserContent;
+        operationId: string;
+        effectDigestConfirmation?: string;
+    }): Promise<MessageRevisionResult>;
+    compact(input?: {
+        now?: string;
+        retentionMs?: number;
+    }): Promise<RetentionResult>;
     createRun(input: {
         agentId: AgentId;
         input: UserInput;
@@ -1610,6 +1655,7 @@ interface OwnedStore {
         output?: AssistantMessage;
     }): Promise<RunRecord>;
     snapshotRun(runId: RunId): Promise<RunSnapshot>;
+    history(agentId: AgentId): Promise<readonly Message[]>;
     listAgents(): Promise<readonly AgentRecord[]>;
     listRuns(input?: {
         agentId?: AgentId;
@@ -1674,16 +1720,29 @@ interface AgentRuntime$1 {
     createAgent(config: AgentConfigRequest, options?: {
         idempotencyKey?: string;
         metadata?: Metadata;
+        historySeed?: HistorySeed;
     }): Promise<AgentId>;
     updateAgentConfig(agentId: AgentId, config: AgentConfigRequest, options: {
         idempotencyKey: string;
     }): Promise<void>;
     deleteAgent(input: AgentDeletionRequest): Promise<void>;
+    revise(agentId: AgentId, input: {
+        messageId: MessageId;
+        expectedMessageRevision: number;
+        content: UserContent;
+        operationId: string;
+        effectDigestConfirmation?: string;
+    }): Promise<MessageRevisionResult>;
+    compact(input?: {
+        now?: string;
+        retentionMs?: number;
+    }): Promise<RetentionResult>;
     start(agentId: AgentId, input: UserInput, options: {
         idempotencyKey: string;
         metadata?: Metadata;
     }): Promise<AgentRun>;
     run(runId: RunId): AgentRun;
+    history(agentId: AgentId): Promise<readonly Message[]>;
     listAgents(input?: {
         after?: AgentListCursor;
         limit?: number;
@@ -1740,11 +1799,29 @@ declare class AgentRuntime implements AgentRuntime$1 {
     createAgent(config: AgentConfigRequest, options?: {
         idempotencyKey?: string;
         metadata?: Metadata;
+        historySeed?: HistorySeed;
     }): Promise<AgentId>;
     updateAgentConfig(agentId: AgentId, config: AgentConfigRequest, options: {
         idempotencyKey: string;
     }): Promise<void>;
     deleteAgent(input: AgentDeletionRequest): Promise<void>;
+    revise(agentId: AgentId, input: {
+        messageId: MessageId;
+        expectedMessageRevision: number;
+        content: UserContent;
+        operationId: string;
+        effectDigestConfirmation?: string;
+    }): Promise<MessageRevisionResult>;
+    compact(input?: {
+        now?: string;
+        retentionMs?: number;
+    }): Promise<Readonly<{
+        deletedRunIds: readonly RunId[];
+        deletedToolCallIds: readonly ToolCallId[];
+        deletedEventCount: number;
+        retentionFloor: EventCursor;
+        skipped?: "active_consumers" | "no_eligible_events";
+    }>>;
     start(agentId: AgentId, input: UserInput, options: {
         idempotencyKey: string;
         metadata?: Metadata;
@@ -1769,6 +1846,7 @@ declare class AgentRuntime implements AgentRuntime$1 {
     }): Promise<DurableConsumer>;
     close(): Promise<void>;
     snapshot(runId: RunId): Promise<RunSnapshot>;
+    history(agentId: AgentId): Promise<readonly Message[]>;
     respond(runId: RunId, input: {
         requestId: InputRequestId;
         input: UserInput;
@@ -1807,7 +1885,9 @@ type InMemoryStoreState = Readonly<{
     events: readonly DurableRunEvent[];
     idempotency: readonly (readonly [string, IdempotencyReceipt])[];
     operationReceipts: readonly (readonly [string, IdempotencyReceipt])[];
+    historySeeds?: readonly (readonly [AgentId, readonly Message[]])[];
     consumerCheckpoints: readonly (readonly [string, EventCursor])[];
+    retentionFloor?: number;
     nextAgentSequence: readonly (readonly [AgentId, number])[];
     nextReadySequence: readonly (readonly [AgentId, number])[];
     eventSequence: number;
@@ -1821,12 +1901,14 @@ declare class InMemoryStore implements DurableStore {
     private readonly events;
     private readonly idempotency;
     private readonly operationReceipts;
+    private readonly historySeeds;
     private readonly consumerCheckpoints;
     private readonly nextAgentSequence;
     private readonly nextReadySequence;
     private owner?;
     private ownerEpoch;
     private eventSequence;
+    private retentionFloor;
     constructor(options?: {
         incarnation?: string;
     });
@@ -1845,6 +1927,7 @@ declare class InMemoryStore implements DurableStore {
         idempotencyKey: string;
         metadata?: Metadata;
         configIdentity?: string;
+        historySeed?: HistorySeed;
     }): AgentRecord;
     activateAgent(lease: OwnerLease, agentId: AgentId, configToken?: ConfigToken, configIdentity?: string): AgentRecord;
     updateAgentConfigToken(lease: OwnerLease, input: {
@@ -1854,6 +1937,14 @@ declare class InMemoryStore implements DurableStore {
         idempotencyKey: string;
     }): AgentRecord;
     deleteAgent(lease: OwnerLease, input: AgentDeletionRequest): void;
+    reviseMessage(lease: OwnerLease, input: {
+        agentId: AgentId;
+        messageId: MessageId;
+        expectedMessageRevision: number;
+        content: UserContent;
+        operationId: string;
+        effectDigestConfirmation?: string;
+    }): MessageRevisionResult;
     createRun(lease: OwnerLease, input: {
         agentId: AgentId;
         input: UserInput;
@@ -1955,6 +2046,10 @@ declare class InMemoryStore implements DurableStore {
         consumerId: string;
         cursor: EventCursor;
     }): void;
+    compact(lease: OwnerLease, input?: {
+        now?: string;
+        retentionMs?: number;
+    }): RetentionResult;
     private replay;
     private writeReceipt;
     private replayOperation;
@@ -1971,7 +2066,8 @@ declare class InMemoryStore implements DurableStore {
     private nextReady;
     private nextMessageSequence;
     private messagesForRun;
-    private history;
+    history(lease: OwnerLease, agentId: AgentId): readonly Message[];
+    private activeHistory;
     private appendMessage;
     private appendTransition;
     private appendToolTransition;
@@ -1994,6 +2090,7 @@ declare class SqliteStore implements DurableStore {
         idempotencyKey: string;
         metadata?: Metadata;
         configIdentity?: string;
+        historySeed?: HistorySeed;
     }): Promise<AgentRecord>;
     activateAgent(lease: OwnerLease, agentId: AgentId, configToken?: ConfigToken, configIdentity?: string): Promise<AgentRecord>;
     updateAgentConfigToken(lease: OwnerLease, input: {
@@ -2003,6 +2100,14 @@ declare class SqliteStore implements DurableStore {
         idempotencyKey: string;
     }): Promise<AgentRecord>;
     deleteAgent(lease: OwnerLease, input: AgentDeletionRequest): Promise<void>;
+    reviseMessage(lease: OwnerLease, input: {
+        agentId: AgentId;
+        messageId: MessageId;
+        expectedMessageRevision: number;
+        content: UserContent;
+        operationId: string;
+        effectDigestConfirmation?: string;
+    }): Promise<MessageRevisionResult>;
     createRun(lease: OwnerLease, input: {
         agentId: AgentId;
         input: UserInput;
@@ -2091,6 +2196,7 @@ declare class SqliteStore implements DurableStore {
         output?: AssistantMessage;
     }): Promise<RunRecord>;
     snapshotRun(lease: OwnerLease, runId: RunId): Promise<RunSnapshot>;
+    history(lease: OwnerLease, agentId: AgentId): Promise<readonly Message[]>;
     listAgents(lease: OwnerLease): Promise<readonly AgentRecord[]>;
     listRuns(lease: OwnerLease, input?: {
         agentId?: AgentId;
@@ -2104,6 +2210,10 @@ declare class SqliteStore implements DurableStore {
         consumerId: string;
         cursor: EventCursor;
     }): Promise<void>;
+    compact(lease: OwnerLease, input?: {
+        now?: string;
+        retentionMs?: number;
+    }): Promise<RetentionResult>;
     renewOwner(lease: OwnerLease, leaseMs: number): Promise<OwnerLease>;
     sealAndReleaseOwner(lease: OwnerLease): Promise<void>;
     private invoke;
@@ -2142,7 +2252,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" | "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" | "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;
@@ -2170,6 +2280,18 @@ type RuntimeErrorDetails = {
         expected: readonly RunState[];
         actual: RunState;
     }>;
+    message_revision_conflict: Readonly<{
+        agentId: AgentId;
+        messageId: MessageId;
+        expected: number;
+        actual: number;
+    }>;
+    tool_effect_confirmation_required: Readonly<{
+        agentId: AgentId;
+        messageId: MessageId;
+        effectDigest: string;
+        toolCallIds: readonly ToolCallId[];
+    }>;
     input_request_conflict: Readonly<{
         runId: RunId;
         requestId: InputRequestId;
@@ -2201,7 +2323,7 @@ type RuntimeErrorDetails = {
     }>;
     invalid_cursor: Readonly<{
         cursorType: "agent_list" | "run_list" | "event";
-        reason: "malformed" | "wrong_store" | "wrong_collection" | "filter_mismatch" | "beyond_waterline";
+        reason: "malformed" | "wrong_store" | "wrong_collection" | "filter_mismatch" | "beyond_waterline" | "expired";
     }>;
     store_unavailable: Readonly<{
         operation: string;
@@ -2277,4 +2399,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 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 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 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, 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 };