@rowan-agent/agent 0.13.1 → 0.13.3

package/dist/index.d.ts

@@ -82,6 +82,7 @@ type ExecutionState = {
     attempt: number;
     metrics: LoopMetrics;
     status: "idle" | "running" | "suspended" | "completed" | "aborted" | "failed";
+    initialPhasePayload?: JsonValue;
     continuation?: ExecutionContinuationState;
     runInteractions?: RunInteractionState;
     phaseInteractions?: RunInteractionState;
@@ -1209,6 +1210,7 @@ type RunRecord = Readonly<{
         messageRevision: number;
     }>;
     metadata?: Metadata;
+    phasePayload?: JsonValue;
     pinnedConfigToken?: ConfigToken;
     checkpoint?: ExecutionCheckpoint;
     currentPhaseId?: string;
@@ -1265,6 +1267,8 @@ type RunSnapshotBase = Readonly<{
     revision: number;
     input: UserInput;
     metadata?: Metadata;
+    /** Effective entry Phase payload the Run started with (defaults filled). */
+    phasePayload?: JsonValue;
     messageCount: number;
     toolCallCount: number;
     currentPhaseId?: string;
@@ -1371,6 +1375,8 @@ interface OwnedStore {
         agentId: AgentId;
         input: UserInput;
         metadata?: Metadata;
+        phasePayload?: JsonValue;
+        pinnedConfigToken?: ConfigToken;
         idempotencyKey: string;
     }): Promise<RunRecord>;
     claimRun(input: {
@@ -1549,6 +1555,7 @@ interface AgentRuntime$1 {
     start(agentId: AgentId, input: UserInput, options: {
         idempotencyKey: string;
         metadata?: Metadata;
+        phasePayload?: JsonValue;
     }): Promise<AgentRun>;
     run(runId: RunId): AgentRun;
     contextStatus(agentId: AgentId, options?: {
@@ -2185,6 +2192,7 @@ declare class AgentRuntime implements AgentRuntime$1 {
     start(agentId: AgentId, input: UserInput, options: {
         idempotencyKey: string;
         metadata?: Metadata;
+        phasePayload?: JsonValue;
     }): Promise<AgentRun>;
     run(runId: RunId): AgentRun;
     listAgents(input?: {
@@ -2320,6 +2328,8 @@ declare class InMemoryStore implements DurableStore {
         agentId: AgentId;
         input: UserInput;
         metadata?: Metadata;
+        phasePayload?: JsonValue;
+        pinnedConfigToken?: ConfigToken;
         idempotencyKey: string;
     }): RunRecord;
     claimRun(lease: OwnerLease, input: {
@@ -2523,6 +2533,8 @@ declare class SqliteStore implements DurableStore {
         agentId: AgentId;
         input: UserInput;
         metadata?: Metadata;
+        phasePayload?: JsonValue;
+        pinnedConfigToken?: ConfigToken;
         idempotencyKey: string;
     }): Promise<RunRecord>;
     claimRun(lease: OwnerLease, input: {

package/dist/index.js

@@ -2609,8 +2609,8 @@ async function runPhaseLoop(config, state, registry) {
   if (resumingSuspendedRun) {
     state.status = "running";
   }
-  const initialPayload = !resumingSuspendedRun ? config.execution.runMetadata?.phasePayload : void 0;
-  let previousPayload = resumingSuspendedRun ? state.continuation?.previousPayload : initialPayload;
+  const initialPayload = Object.hasOwn(state, "initialPhasePayload") ? state.initialPhasePayload : config.execution.runMetadata?.phasePayload;
+  let previousPayload = resumingSuspendedRun ? state.continuation && Object.hasOwn(state.continuation, "previousPayload") ? state.continuation.previousPayload : state.initialPhasePayload : initialPayload;
   let previousPhaseMsgId = resumingSuspendedRun ? state.continuation?.previousPhaseMessageId : void 0;
   let previousPhaseInputMsgId;
   let previousResults = resumingSuspendedRun ? state.continuation?.previousResults?.map((result) => ({ ...result })) ?? [] : [];
@@ -2793,6 +2793,7 @@ async function runPhaseLoop(config, state, registry) {
     }
     const runtime = { phase, config, state, execution, messageManager, registry, context: phaseContext };
     let output = await executePhase(runtime);
+    delete state.initialPhasePayload;
     let modelRouteDecision = resolveModelRouteDecision(output.toolCalls, registry);
     let routeDecision = modelRouteDecision;
     if (routeDecision) applyFirstDecision(routeDecision, output);
@@ -3331,7 +3332,8 @@ function encodeExecutionCheckpoint(state) {
     attempt: state.attempt,
     metrics,
     ...continuation ? { continuation } : {},
-    ...runInteractions === void 0 ? {} : { runInteractions }
+    ...runInteractions === void 0 ? {} : { runInteractions },
+    ...state.initialPhasePayload === void 0 ? {} : { initialPhasePayload: state.initialPhasePayload }
   };
   assertJsonValue(data, "execution checkpoint");
   return {
@@ -3358,6 +3360,7 @@ function decodeExecutionCheckpoint(checkpoint) {
       phaseTransitions: checkpoint.data.metrics.phaseTransitions.map((transition) => ({ ...transition }))
     },
     status: "suspended",
+    ...checkpoint.data.initialPhasePayload === void 0 ? {} : { initialPhasePayload: checkpoint.data.initialPhasePayload },
     ...checkpoint.data.continuation ? {
       continuation: {
         ...checkpoint.data.continuation,
@@ -3393,7 +3396,8 @@ async function executeOnce(input) {
     currentPhase: "",
     attempt: 0,
     status: "running",
-    metrics: createMetrics()
+    metrics: createMetrics(),
+    ...input.initialPhasePayload === void 0 ? {} : { initialPhasePayload: input.initialPhasePayload }
   };
   if (input.interactionAnswers) {
     const existing = state.runInteractions ?? state.phaseInteractions;
@@ -3488,6 +3492,7 @@ function isRecord2(value) {
 function isCheckpointData(value) {
   if (!isRecord2(value) || typeof value.currentPhase !== "string" || !Number.isInteger(value.attempt)) return false;
   if (!isMetrics(value.metrics)) return false;
+  if (value.initialPhasePayload !== void 0 && !isJsonValue(value.initialPhasePayload)) return false;
   if (value.continuation !== void 0 && !isContinuation(value.continuation)) return false;
   if (value.runInteractions !== void 0 && !isRunInteractionState(value.runInteractions)) return false;
   if (value.phaseInteractions !== void 0 && !isRunInteractionState(value.phaseInteractions)) return false;
@@ -3753,10 +3758,16 @@ function encodeIdempotencyScope(storeIncarnation, scope) {
   if (typeof storeIncarnation !== "string" || storeIncarnation.length === 0) throw new TypeError("storeIncarnation must be non-empty");
   return canonicalJson([storeIncarnation, ...scope]);
 }
-function canonicalStartRunRequest(input, metadata) {
+function canonicalStartRunRequest(input, metadata, phasePayload, pinnedConfigToken) {
   const normalized = normalizeUserInput(input);
   if (metadata !== void 0) assertUtf8ByteLimit(canonicalJson(metadata), METADATA_JSON_BYTES, "run.metadata");
-  return canonicalJson({ input: normalized, ...metadata === void 0 ? {} : { metadata } });
+  if (phasePayload !== void 0) assertUtf8ByteLimit(canonicalJson(phasePayload), MESSAGE_CONTENT_JSON_BYTES, "run.phasePayload");
+  return canonicalJson({
+    input: normalized,
+    ...metadata === void 0 ? {} : { metadata },
+    ...phasePayload === void 0 ? {} : { phasePayload },
+    ...pinnedConfigToken === void 0 ? {} : { pinnedConfigToken }
+  });
 }
 
 // src/runtime/config-provider.ts
@@ -6151,7 +6162,38 @@ var AgentRuntime = class _AgentRuntime {
     this.assertOpen();
     const agent = await this.requireAgent(agentId);
     if (!agent.activatedAt || !agent.currentConfigToken) throw new RuntimeError("agent_not_found", { agentId });
-    const run = await this.owned.createRun({ agentId, input, ...options.metadata === void 0 ? {} : { metadata: options.metadata }, idempotencyKey: options.idempotencyKey });
+    let phasePayload;
+    let pinnedConfigToken = agent.currentConfigToken;
+    if (options.phasePayload !== void 0) {
+      const resolution = await this.commands.resolve({ agent, token: agent.currentConfigToken });
+      if (resolution.kind !== "available") {
+        throw new RuntimeError("configuration_unavailable", {
+          agentId,
+          retryable: resolution.kind === "deferred",
+          reason: resolution.kind === "deferred" ? "Configuration is deferred." : resolution.reason
+        });
+      }
+      const config = this.resolveConfig(resolution.config);
+      const assembly = assembleRegisteredExtensions(config, this.resources.extensionRunner, {
+        toolArchiveDir: this.archiveDirFor(agentId)
+      });
+      const entryPhaseId = normalizePhaseRegistry(assembly.context.phases).entryPhaseId;
+      const phase = assembly.context.phases?.phases.get(entryPhaseId);
+      phasePayload = preparePhasePayload(phase?.input, options.phasePayload);
+      pinnedConfigToken = await this.commands.storeSnapshot({
+        agent,
+        config,
+        operationId: `start-run-snapshot:${agentId}:${options.idempotencyKey}`
+      });
+    }
+    const run = await this.owned.createRun({
+      agentId,
+      input,
+      ...options.metadata === void 0 ? {} : { metadata: options.metadata },
+      ...phasePayload === void 0 ? {} : { phasePayload },
+      ...pinnedConfigToken === agent.currentConfigToken ? {} : { pinnedConfigToken },
+      idempotencyKey: options.idempotencyKey
+    });
     void this.pump();
     return new DurableRun(this, run.id);
   }
@@ -6430,6 +6472,7 @@ var AgentRuntime = class _AgentRuntime {
         stream,
         maxAttempts: config.maxAttempts,
         checkpoint: claim.run.checkpoint,
+        ...claim.run.phasePayload === void 0 ? {} : { initialPhasePayload: claim.run.phasePayload },
         interactionAnswers: claim.run.interactionAnswers,
         signal: controller.signal,
         beforePhase: assembly.beforePhase,
@@ -7817,8 +7860,9 @@ var InMemoryStore = class _InMemoryStore {
     this.assertOwner(lease);
     this.requireAgent(input.agentId);
     const normalizedInput = normalizeUserInput(input.input);
+    if (input.phasePayload !== void 0) assertJsonValue(input.phasePayload, "run.phasePayload");
     const scope = createIdempotencyScope("start_run", input.agentId, input.idempotencyKey);
-    const payload = canonicalStartRunRequest(normalizedInput, input.metadata);
+    const payload = canonicalStartRunRequest(normalizedInput, input.metadata, input.phasePayload, input.pinnedConfigToken);
     const replay = this.replay(scope, payload);
     if (replay) return clone(replay);
     const waitingRun = isControlMetadata(input.metadata) ? void 0 : [...this.runs.values()].find((candidate) => candidate.agentId === input.agentId && candidate.state === "input_required");
@@ -7870,6 +7914,8 @@ var InMemoryStore = class _InMemoryStore {
       state: "queued",
       input: clone(normalizedInput),
       ...input.metadata ? { metadata: clone(input.metadata) } : {},
+      ...input.phasePayload === void 0 ? {} : { phasePayload: clone(input.phasePayload) },
+      ...input.pinnedConfigToken === void 0 ? {} : { pinnedConfigToken: input.pinnedConfigToken },
       createdAt: timestamp,
       updatedAt: timestamp
     };
@@ -8370,6 +8416,7 @@ var InMemoryStore = class _InMemoryStore {
       revision: run.revision,
       input: clone(run.input),
       ...run.metadata ? { metadata: clone(run.metadata) } : {},
+      ...run.phasePayload === void 0 ? {} : { phasePayload: clone(run.phasePayload) },
       messageCount: this.messagesForRun(run.id).length,
       toolCallCount: [...this.toolCalls.values()].filter((toolCall) => toolCall.runId === run.id).length,
       ...run.currentPhaseId === void 0 ? {} : { currentPhaseId: run.currentPhaseId },

package/package.json

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