@rowan-agent/agent 0.8.0 → 0.8.1

package/README.md

@@ -84,7 +84,7 @@ JSON-safe value. Progress is live-only and may be dropped.
 
 - transient `message_delta` and `tool_progress` events are live-only and
   best-effort;
-- durable `message_committed`, `run_transitioned`, and `tool_state_changed`
+- durable `message_committed`, `run_state_changed`, and `tool_state_changed`
   events are replayable;
 - a durable `message_committed` event is the authoritative full content if a
   transient delta was coalesced or dropped.
@@ -92,7 +92,7 @@ JSON-safe value. Progress is live-only and may be dropped.
 `runtime.consume()` delivers only `DurableRunEvent` values:
 
 - `message_committed`
-- `run_transitioned`
+- `run_state_changed`
 - `tool_state_changed`
 
 Durable events and their corresponding Run aggregate changes commit in one

package/dist/index.d.ts

@@ -747,44 +747,45 @@ type MessageCommitted = DurableEventBase & Readonly<{
     kind: "message_committed";
     message: Message;
 }>;
-type RunTransitioned = DurableEventBase & (Readonly<{
-    kind: "run_transitioned";
+type RunStateChanged = DurableEventBase & (Readonly<{
+    kind: "run_state_changed";
     from: null;
     to: "queued";
 }> | Readonly<{
-    kind: "run_transitioned";
+    kind: "run_state_changed";
     from: "input_required";
     to: "queued";
 }> | Readonly<{
-    kind: "run_transitioned";
+    kind: "run_state_changed";
     from: "queued";
     to: "running";
 }> | Readonly<{
-    kind: "run_transitioned";
+    kind: "run_state_changed";
     from: "running";
     to: "input_required";
     request: Readonly<{
         id: InputRequestId;
+        phase: string;
         prompt: AssistantMessage;
     }>;
 }> | Readonly<{
-    kind: "run_transitioned";
+    kind: "run_state_changed";
     from: "running";
     to: "completed";
     outcome: Outcome;
     output?: AssistantMessage;
 }> | Readonly<{
-    kind: "run_transitioned";
+    kind: "run_state_changed";
     from: "queued";
     to: "failed";
     failure: QueuedRunFailure;
 }> | Readonly<{
-    kind: "run_transitioned";
+    kind: "run_state_changed";
     from: "running";
     to: "failed";
     failure: RunningRunFailure;
 }> | Readonly<{
-    kind: "run_transitioned";
+    kind: "run_state_changed";
     from: "queued" | "running" | "input_required";
     to: "cancelled";
     reason?: string;
@@ -844,7 +845,7 @@ type ToolStateChanged = DurableEventBase & (Readonly<{
         state: "indeterminate";
     }>;
 }>);
-type DurableRunEvent = MessageCommitted | RunTransitioned | ToolStateChanged;
+type DurableRunEvent = MessageCommitted | RunStateChanged | ToolStateChanged;
 type MessageDelta = Readonly<{
     kind: "message_delta";
     durability: "transient";
@@ -944,6 +945,7 @@ type ExecutionCheckpoint = Readonly<{
 }>;
 type InputRequest = Readonly<{
     id: InputRequestId;
+    phase: string;
     messageId: MessageId;
     createdAt: string;
 }>;
@@ -1036,6 +1038,7 @@ type RunSnapshot = RunSnapshotBase & (Readonly<{
     state: "input_required";
     request: Readonly<{
         id: InputRequestId;
+        phase: string;
         prompt: AssistantMessage;
     }>;
 }> | Readonly<{
@@ -1052,6 +1055,7 @@ type RunSnapshot = RunSnapshotBase & (Readonly<{
 type RunBoundary = Readonly<{
     type: "input_required";
     requestId: InputRequestId;
+    phase: string;
     prompt: AssistantMessage;
 }> | Readonly<{
     type: "completed";
@@ -1132,6 +1136,7 @@ interface OwnedStore {
         execution: ExecutionToken;
         expectedRevision: number;
         requestId?: InputRequestId;
+        phase: string;
         prompt: AssistantMessage;
         checkpoint: ExecutionCheckpoint;
     }): Promise<InputRequiredCommit>;
@@ -1426,6 +1431,7 @@ declare class InMemoryStore implements DurableStore {
         execution: ExecutionToken;
         expectedRevision: number;
         requestId?: InputRequestId;
+        phase: string;
         prompt: AssistantMessage;
         checkpoint: ExecutionCheckpoint;
     }): InputRequiredCommit;
@@ -1572,6 +1578,7 @@ declare class SqliteStore implements DurableStore {
         execution: ExecutionToken;
         expectedRevision: number;
         requestId?: InputRequestId;
+        phase: string;
         prompt: AssistantMessage;
         checkpoint: ExecutionCheckpoint;
     }): Promise<InputRequiredCommit>;
@@ -1800,4 +1807,4 @@ declare function loadExtensionsFromPath(path: string): Promise<{
 
 declare function createCoreTools(input?: CoreToolContext): Tool[];
 
-export { type AfterToolCall, type AgentConfig, type AgentDefinitionContext, type AgentId, type AgentListCursor, type AgentRecord, type AgentRun, AgentRuntime, type AgentRuntimeOptions, type AgentSummary, type AnyRuntimeError, type AssistantContent, type AssistantMessage, type BeforeToolCall, type ConfigProvider, type ConfigPutResult, type ConfigResolution, type ConfigToken, type CoreToolContext, type DurableConsumer, type DurableRunEvent, type DurableStore, type DurableToolResult, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionFactory, type HookEvent, type HookEventType, type HookHandler, InMemoryConfigProvider, InMemoryStore, type InputRequest, type InputRequestId, type InputRequiredCommit, type JsonObject, type JsonPrimitive, type JsonValue, type LoadExtensionsResult, 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 PhaseExecutionIdentity, type PhaseInvocation, type PhaseOutput, type PhaseRegistry, type PhaseState, type RunBoundary, type RunClaim, type RunEvent, type RunFailure, type RunId, type RunListCursor, type RunRecord, type RunSnapshot, type RunState, type RunSummary, type RunTransitioned, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, type Skill, SqliteStore, type TextContent, type ThinkingContent, type Tool, type ToolCallId, type ToolCallSnapshot, type ToolCallState, 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, loadPhases, loadSkills };
+export { type AfterToolCall, type AgentConfig, type AgentDefinitionContext, type AgentId, type AgentListCursor, type AgentRecord, type AgentRun, AgentRuntime, type AgentRuntimeOptions, type AgentSummary, type AnyRuntimeError, type AssistantContent, type AssistantMessage, type BeforeToolCall, type ConfigProvider, type ConfigPutResult, type ConfigResolution, type ConfigToken, type CoreToolContext, type DurableConsumer, type DurableRunEvent, type DurableStore, type DurableToolResult, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionFactory, type HookEvent, type HookEventType, type HookHandler, InMemoryConfigProvider, InMemoryStore, type InputRequest, type InputRequestId, type InputRequiredCommit, type JsonObject, type JsonPrimitive, type JsonValue, type LoadExtensionsResult, 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 PhaseExecutionIdentity, type PhaseInvocation, type PhaseOutput, type PhaseRegistry, type PhaseState, type RunBoundary, type RunClaim, type RunEvent, type RunFailure, type RunId, type RunListCursor, type RunRecord, type RunSnapshot, type RunState, type RunStateChanged, type RunSummary, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, type Skill, SqliteStore, type TextContent, type ThinkingContent, type Tool, type ToolCallId, type ToolCallSnapshot, type ToolCallState, 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, loadPhases, loadSkills };

package/dist/index.js

@@ -4071,7 +4071,7 @@ var AgentRuntime = class _AgentRuntime {
       });
       if (result.type === "input_required") {
         const prompt = promptMessage(run, result.request.prompt, result.messages.length);
-        await this.owned.commitInputRequired({ runId: run.id, execution: claim.execution, expectedRevision: executionRevision, requestId: createId("input"), prompt, checkpoint: result.checkpoint });
+        await this.owned.commitInputRequired({ runId: run.id, execution: claim.execution, expectedRevision: executionRevision, requestId: createId("input"), phase: result.request.phase, prompt, checkpoint: result.checkpoint });
         this.transientEvents.clear(run.id, claim.execution.executionId);
         return;
       }
@@ -4266,7 +4266,7 @@ var AgentRuntime = class _AgentRuntime {
             subscription.clearTool(event.toolCall.id);
           }
           yield event;
-          if (event.kind === "run_transitioned" && ["completed", "failed", "cancelled"].includes(event.to)) return;
+          if (event.kind === "run_state_changed" && ["completed", "failed", "cancelled"].includes(event.to)) return;
         }
         const transient = subscription.shift();
         if (transient) {
@@ -4341,7 +4341,7 @@ function durableOutcome(outcome) {
 function boundaryFromSnapshot(snapshot) {
   switch (snapshot.state) {
     case "input_required":
-      return { type: "input_required", requestId: snapshot.request.id, prompt: snapshot.request.prompt };
+      return { type: "input_required", requestId: snapshot.request.id, phase: snapshot.request.phase, prompt: snapshot.request.prompt };
     case "completed":
       return { type: "completed", outcome: snapshot.outcome, ...snapshot.output ? { output: snapshot.output } : {} };
     case "failed":
@@ -4634,9 +4634,10 @@ var InMemoryStore = class _InMemoryStore {
   }
   commitInputRequired(lease, input) {
     this.assertOwner(lease);
+    if (typeof input.phase !== "string" || input.phase.length === 0) throw new TypeError("phase must be non-empty");
     const requestId = input.requestId ?? createId("input");
     const operationKey = `input_required:${requestId}`;
-    const operationPayload = canonicalJson([input.runId, input.expectedRevision, input.prompt.id, input.checkpoint]);
+    const operationPayload = canonicalJson([input.runId, input.expectedRevision, input.phase, input.prompt.id, input.checkpoint]);
     const replay = this.replayOperation(operationKey, operationPayload);
     if (replay) return clone(replay);
     const run = this.requireRun(input.runId);
@@ -4649,6 +4650,7 @@ var InMemoryStore = class _InMemoryStore {
     };
     const request = {
       id: requestId,
+      phase: input.phase,
       messageId: prompt.id,
       createdAt: createTimestamp()
     };
@@ -4971,7 +4973,7 @@ var InMemoryStore = class _InMemoryStore {
         const request = run.openInputRequest;
         const prompt = request && this.messages.get(request.messageId);
         if (!prompt || prompt.role !== "assistant") throw new Error(`Run ${run.id} has an invalid input prompt.`);
-        return { ...base, state: "input_required", request: { id: request.id, prompt: clone(prompt) } };
+        return { ...base, state: "input_required", request: { id: request.id, phase: request.phase, prompt: clone(prompt) } };
       }
       case "completed": {
         const output = this.messagesForRun(run.id).filter((message) => message.role === "assistant").at(-1);
@@ -5124,10 +5126,10 @@ var InMemoryStore = class _InMemoryStore {
   appendTransition(run, from, to, request, prompt, outcome, failure, reason) {
     const transition = {
       ...this.baseEvent(run),
-      kind: "run_transitioned",
+      kind: "run_state_changed",
       from,
       to,
-      ...to === "input_required" && request && prompt ? { request: { id: request.id, prompt } } : {},
+      ...to === "input_required" && request && prompt ? { request: { id: request.id, phase: request.phase, prompt } } : {},
       ...to === "completed" && outcome ? { outcome } : {},
       ...to === "failed" && failure ? { failure } : {},
       ...to === "cancelled" && reason ? { reason } : {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowan-agent/agent",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "license": "MIT",
   "repository": {
     "type": "git",