@rowan-agent/agent 0.13.0 → 0.13.2

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;
@@ -1086,7 +1087,10 @@ type ContextCompactionRecord = Readonly<{
     instructions?: string;
     createdAt: string;
 }>;
-type ToolInvocationContext = Readonly<{
+/** Who is calling which tool, without the ability to ask or suspend. Hosts that
+ * describe a call before it runs (for example to build a confirmation) only
+ * have this much. */
+type ToolCallContext = Readonly<{
     agentId: AgentId;
     runId: RunId;
     /** Opaque JSON metadata captured from the Agent and Run records. Rowan does
@@ -1095,6 +1099,8 @@ type ToolInvocationContext = Readonly<{
     runMetadata?: Metadata;
     toolCallId: ToolCallId;
     reportProgress(progress: JsonValue): void;
+}>;
+type ToolInvocationContext = ToolCallContext & Readonly<{
     interaction: RunInteractionDriver;
 }>;
 type Tool$1 = Readonly<{
@@ -1204,6 +1210,7 @@ type RunRecord = Readonly<{
         messageRevision: number;
     }>;
     metadata?: Metadata;
+    phasePayload?: JsonValue;
     pinnedConfigToken?: ConfigToken;
     checkpoint?: ExecutionCheckpoint;
     currentPhaseId?: string;
@@ -1366,6 +1373,8 @@ interface OwnedStore {
         agentId: AgentId;
         input: UserInput;
         metadata?: Metadata;
+        phasePayload?: JsonValue;
+        pinnedConfigToken?: ConfigToken;
         idempotencyKey: string;
     }): Promise<RunRecord>;
     claimRun(input: {
@@ -1544,6 +1553,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?: {
@@ -2180,6 +2190,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?: {
@@ -2315,6 +2326,8 @@ declare class InMemoryStore implements DurableStore {
         agentId: AgentId;
         input: UserInput;
         metadata?: Metadata;
+        phasePayload?: JsonValue;
+        pinnedConfigToken?: ConfigToken;
         idempotencyKey: string;
     }): RunRecord;
     claimRun(lease: OwnerLease, input: {
@@ -2518,6 +2531,8 @@ declare class SqliteStore implements DurableStore {
         agentId: AgentId;
         input: UserInput;
         metadata?: Metadata;
+        phasePayload?: JsonValue;
+        pinnedConfigToken?: ConfigToken;
         idempotencyKey: string;
     }): Promise<RunRecord>;
     claimRun(lease: OwnerLease, input: {
@@ -2846,4 +2861,4 @@ declare function parseFrontmatter<T = Record<string, unknown>>(raw: string): Fro
 
 declare function createCoreTools(input?: CoreToolContext): Tool$1[];
 
-export { type AfterToolCall, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, 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 InteractionRecord, 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 PhaseInput, type PhaseInvocation, type PhaseMessageManager, type PhaseOutput, type PhaseRegistry, type PhaseRegistrySelection, type PhaseSettingsBadge, type PhaseSettingsContext, type PhaseSettingsControl, type PhaseSettingsDefinition, type PhaseSettingsItem, type PhaseSettingsOption, type PhaseSettingsProvider, type PhaseSettingsSection, 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 RunInteraction, RunInteractionBoundary, RunInteractionCancelledError, type RunInteractionDriver, type RunInteractionKind, type RunInteractionRequest, type RunInteractionState, type RunInteractionStatus, 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 ThinkingDelta, type Tool$1 as 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, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhaseSettings, loadPhases, loadSkill, loadSkills, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };
+export { type AfterToolCall, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, 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 InteractionRecord, 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 PhaseInput, type PhaseInvocation, type PhaseMessageManager, type PhaseOutput, type PhaseRegistry, type PhaseRegistrySelection, type PhaseSettingsBadge, type PhaseSettingsContext, type PhaseSettingsControl, type PhaseSettingsDefinition, type PhaseSettingsItem, type PhaseSettingsOption, type PhaseSettingsProvider, type PhaseSettingsSection, 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 RunInteraction, RunInteractionBoundary, RunInteractionCancelledError, type RunInteractionDriver, type RunInteractionKind, type RunInteractionRequest, type RunInteractionState, type RunInteractionStatus, 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 ThinkingDelta, type Tool$1 as Tool, type ToolCallContext, 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, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhaseSettings, loadPhases, loadSkill, loadSkills, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };

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
     };

package/package.json

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