@rowan-agent/agent 0.9.11 → 0.9.13

package/dist/index.d.ts

@@ -55,6 +55,159 @@ type ToolResult = {
     error?: string;
 };
 
+interface BeforePhaseEvent {
+    type: "before_phase";
+    phaseId: string;
+    input: PhaseContext;
+}
+interface AfterPhaseEvent {
+    type: "after_phase";
+    phaseId: string;
+    output: PhaseOutput;
+}
+interface BeforePromptEvent {
+    type: "before_prompt";
+    phaseId: string;
+    input: PhaseContext;
+}
+interface BeforeToolCallEvent {
+    type: "before_tool_call";
+    tool: Tool$1;
+    args: unknown;
+}
+interface AfterToolCallEvent {
+    type: "after_tool_call";
+    tool: Tool$1;
+    result: ToolResult;
+}
+type HookEvent = BeforePhaseEvent | AfterPhaseEvent | BeforePromptEvent | BeforeToolCallEvent | AfterToolCallEvent;
+interface BeforePhaseResult {
+    abort?: Outcome$1;
+    skip?: {
+        route: string;
+        message: string;
+    };
+    input?: PhaseContext;
+}
+interface AfterPhaseResult {
+    abort?: Outcome$1;
+    retry?: PhaseContext;
+    output?: PhaseOutput;
+}
+interface BeforePromptResult {
+    input?: PhaseContext;
+}
+interface BeforeToolCallResult {
+    allow: boolean;
+    reason?: string;
+}
+interface AfterToolCallResult {
+    result?: ToolResult;
+}
+interface HookResultMap {
+    before_phase: BeforePhaseResult | undefined;
+    after_phase: AfterPhaseResult | undefined;
+    before_prompt: BeforePromptResult | undefined;
+    before_tool_call: BeforeToolCallResult | undefined;
+    after_tool_call: AfterToolCallResult | undefined;
+}
+type HookEventType = HookEvent["type"];
+type HookHandler<K extends HookEventType> = (event: Extract<HookEvent, {
+    type: K;
+}>) => HookResultMap[K] | Promise<HookResultMap[K]> | void | Promise<void>;
+declare class HooksManager {
+    private handlers;
+    on<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
+    off<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
+    emit<K extends HookEventType>(eventType: K, event: Extract<HookEvent, {
+        type: K;
+    }>): Promise<void>;
+    emitFirst<K extends HookEventType>(eventType: K, event: Extract<HookEvent, {
+        type: K;
+    }>): Promise<HookResultMap[K] | undefined>;
+}
+
+type LoopMetrics = {
+    /** Number of phase iterations executed. */
+    iterations: number;
+    /** Phase transition history. */
+    phaseTransitions: Array<{
+        from: string;
+        to: string;
+        ts: string;
+    }>;
+    /** Number of times compaction was triggered. */
+    compactionCount: number;
+    /** Number of retry attempts due to transient errors. */
+    retryCount: number;
+    /** Loop start timestamp. */
+    startedAt: string;
+    /** Loop start time as epoch ms (for duration calculation). */
+    startedAtMs: number;
+    /** Loop end timestamp (set on completion). */
+    endedAt?: string;
+    /** Total wall-clock duration in ms. */
+    durationMs?: number;
+};
+type ExecutionState = {
+    currentPhase: string;
+    attempt: number;
+    metrics: LoopMetrics;
+    status: "idle" | "running" | "suspended" | "completed" | "aborted" | "failed";
+    continuation?: ExecutionContinuationState;
+    phaseInteractions?: PhaseInteractionState;
+};
+type ExecutionContinuationState = {
+    isContinuing: boolean;
+    previousPayload?: unknown;
+    previousResults: Array<{
+        name: string;
+        output?: unknown;
+    }>;
+    pendingInstruction?: string;
+    previousPhaseMessageId?: string;
+};
+
+type PhaseInteractionKind = "user_input" | "permission" | "elicitation" | "confirmation";
+type PhaseInteractionStatus = "pending" | "answered" | "denied" | "cancelled" | "expired";
+type PhaseInteraction = Readonly<{
+    id: string;
+    phase: string;
+    kind: PhaseInteractionKind;
+    prompt: string;
+    payload?: JsonValue;
+    createdAt: string;
+    status: PhaseInteractionStatus;
+}>;
+type PhaseInteractionState = Readonly<{
+    requests: readonly PhaseInteraction[];
+    answers: Readonly<Record<string, JsonValue>>;
+    checkpoint?: JsonValue;
+}>;
+type PhaseInteractionDriver = Readonly<{
+    signal: AbortSignal;
+    request(input: Readonly<{
+        id?: string;
+        kind: PhaseInteractionKind;
+        prompt: string;
+        payload?: JsonValue;
+    }>): PhaseInteraction;
+    pending(): readonly PhaseInteraction[];
+    answers(): ReadonlyMap<string, JsonValue>;
+    suspend(input?: Readonly<{
+        checkpoint?: JsonValue;
+    }>): never;
+}>;
+declare class PhaseInteractionCancelledError extends Error {
+    readonly code: "phase_interaction_cancelled";
+    constructor();
+}
+declare class PhaseInteractionBoundary extends Error {
+    readonly state: ExecutionState;
+    readonly interactions: readonly PhaseInteraction[];
+    constructor(state: ExecutionState, interactions: readonly PhaseInteraction[]);
+}
+
 /** Durable and transient DTOs owned by the event-driven Agent Runtime. */
 
 declare const opaqueIdBrand: unique symbol;
@@ -387,159 +540,6 @@ type PhaseStatusEvent = Readonly<{
 }>;
 type RunEvent = DurableRunEvent | MessageDelta | ThinkingDelta | ToolProgress | PhaseStatusEvent;
 
-interface BeforePhaseEvent {
-    type: "before_phase";
-    phaseId: string;
-    input: PhaseContext;
-}
-interface AfterPhaseEvent {
-    type: "after_phase";
-    phaseId: string;
-    output: PhaseOutput;
-}
-interface BeforePromptEvent {
-    type: "before_prompt";
-    phaseId: string;
-    input: PhaseContext;
-}
-interface BeforeToolCallEvent {
-    type: "before_tool_call";
-    tool: Tool$1;
-    args: unknown;
-}
-interface AfterToolCallEvent {
-    type: "after_tool_call";
-    tool: Tool$1;
-    result: ToolResult;
-}
-type HookEvent = BeforePhaseEvent | AfterPhaseEvent | BeforePromptEvent | BeforeToolCallEvent | AfterToolCallEvent;
-interface BeforePhaseResult {
-    abort?: Outcome$1;
-    skip?: {
-        route: string;
-        message: string;
-    };
-    input?: PhaseContext;
-}
-interface AfterPhaseResult {
-    abort?: Outcome$1;
-    retry?: PhaseContext;
-    output?: PhaseOutput;
-}
-interface BeforePromptResult {
-    input?: PhaseContext;
-}
-interface BeforeToolCallResult {
-    allow: boolean;
-    reason?: string;
-}
-interface AfterToolCallResult {
-    result?: ToolResult;
-}
-interface HookResultMap {
-    before_phase: BeforePhaseResult | undefined;
-    after_phase: AfterPhaseResult | undefined;
-    before_prompt: BeforePromptResult | undefined;
-    before_tool_call: BeforeToolCallResult | undefined;
-    after_tool_call: AfterToolCallResult | undefined;
-}
-type HookEventType = HookEvent["type"];
-type HookHandler<K extends HookEventType> = (event: Extract<HookEvent, {
-    type: K;
-}>) => HookResultMap[K] | Promise<HookResultMap[K]> | void | Promise<void>;
-declare class HooksManager {
-    private handlers;
-    on<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
-    off<K extends HookEventType>(eventType: K, handler: HookHandler<K>): void;
-    emit<K extends HookEventType>(eventType: K, event: Extract<HookEvent, {
-        type: K;
-    }>): Promise<void>;
-    emitFirst<K extends HookEventType>(eventType: K, event: Extract<HookEvent, {
-        type: K;
-    }>): Promise<HookResultMap[K] | undefined>;
-}
-
-type LoopMetrics = {
-    /** Number of phase iterations executed. */
-    iterations: number;
-    /** Phase transition history. */
-    phaseTransitions: Array<{
-        from: string;
-        to: string;
-        ts: string;
-    }>;
-    /** Number of times compaction was triggered. */
-    compactionCount: number;
-    /** Number of retry attempts due to transient errors. */
-    retryCount: number;
-    /** Loop start timestamp. */
-    startedAt: string;
-    /** Loop start time as epoch ms (for duration calculation). */
-    startedAtMs: number;
-    /** Loop end timestamp (set on completion). */
-    endedAt?: string;
-    /** Total wall-clock duration in ms. */
-    durationMs?: number;
-};
-type ExecutionState = {
-    currentPhase: string;
-    attempt: number;
-    metrics: LoopMetrics;
-    status: "idle" | "running" | "suspended" | "completed" | "aborted" | "failed";
-    continuation?: ExecutionContinuationState;
-    phaseInteractions?: PhaseInteractionState;
-};
-type ExecutionContinuationState = {
-    isContinuing: boolean;
-    previousPayload?: unknown;
-    previousResults: Array<{
-        name: string;
-        output?: unknown;
-    }>;
-    pendingInstruction?: string;
-    previousPhaseMessageId?: string;
-};
-
-type PhaseInteractionKind = "user_input" | "permission" | "elicitation" | "confirmation";
-type PhaseInteractionStatus = "pending" | "answered" | "denied" | "cancelled" | "expired";
-type PhaseInteraction = Readonly<{
-    id: string;
-    phase: string;
-    kind: PhaseInteractionKind;
-    prompt: string;
-    payload?: JsonValue;
-    createdAt: string;
-    status: PhaseInteractionStatus;
-}>;
-type PhaseInteractionState = Readonly<{
-    requests: readonly PhaseInteraction[];
-    answers: Readonly<Record<string, JsonValue>>;
-    checkpoint?: JsonValue;
-}>;
-type PhaseInteractionDriver = Readonly<{
-    signal: AbortSignal;
-    request(input: Readonly<{
-        id?: string;
-        kind: PhaseInteractionKind;
-        prompt: string;
-        payload?: JsonValue;
-    }>): PhaseInteraction;
-    pending(): readonly PhaseInteraction[];
-    answers(): ReadonlyMap<string, JsonValue>;
-    suspend(input?: Readonly<{
-        checkpoint?: JsonValue;
-    }>): never;
-}>;
-declare class PhaseInteractionCancelledError extends Error {
-    readonly code: "phase_interaction_cancelled";
-    constructor();
-}
-declare class PhaseInteractionBoundary extends Error {
-    readonly state: ExecutionState;
-    readonly interactions: readonly PhaseInteraction[];
-    constructor(state: ExecutionState, interactions: readonly PhaseInteraction[]);
-}
-
 type ModelInvokeOutput = {
     text: string;
     contentBlocks: ContentBlock[];
@@ -932,6 +932,8 @@ type PhaseExecutionIdentity = Readonly<{
     agentId: string;
     runId: string;
     executionId: string;
+    /** Original durable Run input, before any Phase-local interpretation. */
+    input?: UserContent;
     /** Opaque metadata captured at the durable boundary; Rowan does not decode it. */
     agentMetadata?: Readonly<Record<string, unknown>>;
     runMetadata?: Readonly<Record<string, unknown>>;
@@ -1378,6 +1380,8 @@ type AgentConfiguration = Readonly<{
     }>;
     resourceView: ResourceView;
     contexts?: readonly ContextCandidate[];
+    /** Trusted Host-owned Contexts rendered as durable user messages. */
+    additionalContexts?: readonly ContextCandidate[];
     cwd?: string;
     maxAttempts?: number;
     model: ModelConfig | ModelRef;
@@ -1394,6 +1398,7 @@ type ConfigurationSnapshot = Readonly<{
         refs: Readonly<Record<ResourceKind, readonly ResourceRef[]>>;
     }>;
     contexts: readonly ContextCandidate[];
+    additionalContexts: readonly ContextCandidate[];
     resourceView: ResourceView;
     cwd?: string;
     maxAttempts?: number;
@@ -1502,6 +1507,8 @@ type AgentConfig = Readonly<{
     identity: string;
     definition: AgentDefinition;
     resources: AgentResources;
+    /** Host-owned Contexts are rendered as durable user messages for a Run. */
+    additionalContexts?: readonly ContextCandidate[];
     cwd?: string;
     maxAttempts?: number;
     beforeToolCall?: BeforeToolCall;
@@ -1766,6 +1773,7 @@ interface OwnedStore {
         executionId?: ExecutionId;
         messageId?: MessageId;
         configToken?: ConfigToken;
+        inputContext?: UserInput;
     }): Promise<RunClaim>;
     failQueuedRun(input: {
         runId: RunId;
@@ -1938,6 +1946,7 @@ interface AgentRuntime$1 {
         contextWindow?: number;
     }): Promise<ContextStatus>;
     compactContext(agentId: AgentId, options?: {
+        input?: UserInput;
         instructions?: string;
         idempotencyKey?: string;
     }): Promise<AgentRun>;
@@ -2029,6 +2038,7 @@ declare class AgentRuntime implements AgentRuntime$1 {
         contextWindow?: number;
     }): Promise<ContextStatus>;
     compactContext(agentId: AgentId, options?: {
+        input?: UserInput;
         instructions?: string;
         idempotencyKey?: string;
     }): Promise<AgentRun>;
@@ -2178,6 +2188,7 @@ declare class InMemoryStore implements DurableStore {
         executionId?: ExecutionId;
         messageId?: MessageId;
         configToken?: ConfigToken;
+        inputContext?: UserInput;
     }): RunClaim;
     failQueuedRun(lease: OwnerLease, input: {
         runId: RunId;
@@ -2361,6 +2372,7 @@ declare class SqliteStore implements DurableStore {
         executionId?: ExecutionId;
         messageId?: MessageId;
         configToken?: ConfigToken;
+        inputContext?: UserInput;
     }): Promise<RunClaim>;
     failQueuedRun(lease: OwnerLease, input: {
         runId: RunId;

package/dist/index.js

@@ -46,6 +46,9 @@ function buildContextDescription(contexts) {
   lines.push("</agent_context>");
   return lines.join("\n");
 }
+function buildAdditionalContextMessage(contexts) {
+  return buildContextDescription(contexts);
+}
 function formatResourceOutput(resource) {
   const parts = [`<${resource.type} name="${escapeXml(resource.name)}" location="${escapeXml(resource.location)}">`];
   if (resource.baseDir) {
@@ -1751,7 +1754,7 @@ async function loadPhaseCode(codePath) {
   throw new Error(`Phase code at "${codePath}" must export a default function or a run() function.`);
 }
 
-// src/harness/phases/default.ts
+// src/harness/phases/core-phases.ts
 var DEFAULT_PHASE_ID = "default";
 var STOP_PHASE_ID = "stop";
 var COMPACT_PHASE_ID = "compact";
@@ -1809,6 +1812,14 @@ function createCompactPhase() {
       });
       const tools = context.tools.filter((tool) => tool.core && (tool.name === "read" || tool.name === "bash"));
       const working = { ...context, tools, skills: [...context.skills], messages: [...context.messages] };
+      const instructions = compactInstructions(context);
+      if (instructions) {
+        working.messages.push(createMessage("user", `Additional compaction instructions:
+${instructions}`, {
+          kind: "phase_input",
+          phase: COMPACT_PHASE_ID
+        }));
+      }
       let result = await execution.invokeModel(working, { output: "internal" });
       for (let attempt = 0; attempt < 8 && result.toolCalls.length > 0; attempt += 1) {
         const calls = result.toolCalls.filter((call) => tools.some((tool) => tool.name === call.name));
@@ -1860,7 +1871,11 @@ function createCompactPhase() {
       return {
         route: "stop",
         phase: COMPACT_PHASE_ID,
-        payload: { kind: "context_compaction", summary: result.text },
+        payload: {
+          kind: "context_compaction",
+          summary: result.text,
+          ...instructions ? { instructions } : {}
+        },
         status: {
           state: "completed",
           kind: "compacted",
@@ -1870,6 +1885,21 @@ function createCompactPhase() {
     }
   };
 }
+function compactInstructions(context) {
+  const rowan = context.execution.runMetadata?.rowan;
+  if (typeof rowan === "object" && rowan !== null && !Array.isArray(rowan)) {
+    const configured = rowan.instructions;
+    if (typeof configured === "string" && configured.trim().length > 0) {
+      return configured.trim();
+    }
+  }
+  const input = context.execution.input;
+  if (input === void 0) return void 0;
+  const text = typeof input === "string" ? input : input.filter((part) => part.type === "text").map((part) => part.text).join("");
+  const match = text.match(/^\/compact(?:\s+([\s\S]*))?$/i);
+  const instructions = match?.[1]?.trim();
+  return instructions || void 0;
+}
 function createCorePhases() {
   return [createDefaultPhase(), createStopPhase(), createCompactPhase()];
 }
@@ -2096,7 +2126,7 @@ function findLatestUserInputMessage(messages) {
   for (let index = messages.length - 1; index >= 0; index -= 1) {
     const message = messages[index];
     const kind = message.metadata?.kind;
-    if (message.role === "user" && kind !== "phase_prompt" && kind !== "phase_input") {
+    if (message.role === "user" && kind !== "phase_prompt" && kind !== "phase_input" && kind !== "host_context") {
       return message;
     }
   }
@@ -3249,6 +3279,7 @@ function isContinuation(value) {
 }
 
 // src/runtime/contracts.ts
+var HOST_CONTEXT_MESSAGE_KIND = "host_context";
 var THINKING_LEVELS = [
   "off",
   "minimal",
@@ -3271,7 +3302,7 @@ function thinkingLevelFromMessages(messages) {
     if (message?.role !== "user") continue;
     const metadata = message.metadata;
     const kind = isRecord3(metadata) && typeof metadata.kind === "string" ? metadata.kind : void 0;
-    if (kind === "phase_prompt" || kind === "phase_input") continue;
+    if (kind === "phase_prompt" || kind === "phase_input" || kind === HOST_CONTEXT_MESSAGE_KIND) continue;
     return thinkingLevelFromMetadata(metadata);
   }
   return void 0;
@@ -3325,6 +3356,9 @@ function normalizeUserInput(input) {
   assertJsonValue(normalized, "input");
   return normalized;
 }
+function canonicalUserInput(input) {
+  return canonicalJson(normalizeUserInput(input));
+}
 function isAssistantMessage(value) {
   return isRecord3(value) && hasOnlyKeys(value, ["id", "agentId", "runId", "messageRevision", "role", "content", "metadata", "sequenceWithinRun", "createdAt", "interrupted"]) && typeof value.id === "string" && typeof value.agentId === "string" && typeof value.runId === "string" && value.role === "assistant" && (value.messageRevision === void 0 || Number.isInteger(value.messageRevision) && value.messageRevision >= 0) && Number.isInteger(value.sequenceWithinRun) && value.sequenceWithinRun >= 0 && typeof value.createdAt === "string" && isAssistantContent(value.content) && (value.metadata === void 0 || isMetadata(value.metadata)) && (value.interrupted === void 0 || typeof value.interrupted === "boolean");
 }
@@ -3351,6 +3385,12 @@ function assertAgentConfig(config) {
     names.add(context.name);
     assertJsonValue(context.value, `Context candidate "${context.name}" value`);
   }
+  for (const context of config.additionalContexts ?? []) {
+    if (typeof context.name !== "string" || context.name.trim() === "") {
+      throw new TypeError("Additional Context candidate name must be non-empty");
+    }
+    assertJsonValue(context.value, `Additional Context candidate "${context.name}" value`);
+  }
 }
 function assertAgentConfigRequest(config) {
   if (!isAgentConfiguration(config)) {
@@ -3378,6 +3418,10 @@ function assertAgentConfigRequest(config) {
     if (typeof context.name !== "string" || context.name.trim() === "") throw new TypeError("Context candidate name must be non-empty");
     assertJsonValue(context.value, `Context candidate "${context.name}" value`);
   }
+  for (const context of config.additionalContexts ?? []) {
+    if (typeof context.name !== "string" || context.name.trim() === "") throw new TypeError("Additional Context candidate name must be non-empty");
+    assertJsonValue(context.value, `Additional Context candidate "${context.name}" value`);
+  }
 }
 function assertToolExecutionResult(value) {
   if (!isToolResult(value)) throw new TypeError("Tool result must be JSON-safe and contain no Runtime identity");
@@ -3514,7 +3558,17 @@ function snapshotConfig(config) {
       })))
     } : {}
   });
-  return Object.freeze({ ...config, definition, resources });
+  return Object.freeze({
+    ...config,
+    definition,
+    resources,
+    ...config.additionalContexts ? {
+      additionalContexts: Object.freeze(config.additionalContexts.map((context) => Object.freeze({
+        name: context.name,
+        value: snapshotJsonValue(context.value)
+      })))
+    } : {}
+  });
 }
 function snapshotPhaseRegistry(registry) {
   const phases = /* @__PURE__ */ new Map();
@@ -3563,6 +3617,12 @@ function snapshotConfiguration(config) {
         name: context.name,
         value: snapshotJsonValue(context.value)
       })))
+    } : {},
+    ...config.additionalContexts ? {
+      additionalContexts: Object.freeze(config.additionalContexts.map((context) => Object.freeze({
+        name: context.name,
+        value: snapshotJsonValue(context.value)
+      })))
     } : {}
   });
 }
@@ -5474,6 +5534,8 @@ function resolveConfigurationSnapshot(registry, input) {
     throw new Error(`Agent Definition "${input.definition.name}" is not available in the Resource View.`);
   }
   const layer = input.definition.layer;
+  const selectedContexts = selectNamedResources(input.contexts ?? [], base.contexts, "Context");
+  const additionalContexts = deduplicateContexts(input.additionalContexts ?? [], selectedContexts);
   const definition = applyDefinitionLayer(base, layer);
   const tools = selectNamedResources(resolved.tools, definition.tools, "Tool");
   const skills = mergeSkills(
@@ -5481,7 +5543,6 @@ function resolveConfigurationSnapshot(registry, input) {
     definition.bundledSkills
   );
   const phases = resolvePhases(resolved.phases, definition.phases);
-  const contexts = selectNamedResources(input.contexts ?? [], base.contexts, "Context");
   return {
     identity: input.identity,
     definition,
@@ -5497,7 +5558,8 @@ function resolveConfigurationSnapshot(registry, input) {
         phase: selectedRefs(resolved.refs.phase, [...phases?.phases.keys() ?? []])
       }
     },
-    contexts,
+    contexts: selectedContexts,
+    additionalContexts,
     resourceView: input.resourceView,
     ...input.cwd === void 0 ? {} : { cwd: input.cwd },
     ...input.maxAttempts === void 0 ? {} : { maxAttempts: input.maxAttempts },
@@ -5522,6 +5584,7 @@ function materializeConfigurationSnapshot(snapshot) {
       ],
       resourceRevisions: snapshot.resources.revisions
     },
+    ...snapshot.additionalContexts.length > 0 ? { additionalContexts: snapshot.additionalContexts } : {},
     ...snapshot.cwd === void 0 ? {} : { cwd: snapshot.cwd },
     ...snapshot.maxAttempts === void 0 ? {} : { maxAttempts: snapshot.maxAttempts },
     ..."stream" in snapshot && snapshot.stream ? { model: snapshot.model, stream: snapshot.stream } : { model: snapshot.model }
@@ -5539,6 +5602,16 @@ function applyDefinitionLayer(base, layer) {
     ...layer.phases === void 0 ? {} : { phases: intersectPhaseSelection(base.phases, layer.phases) }
   };
 }
+function deduplicateContexts(additional, existing = []) {
+  const contexts = [];
+  const seen = new Set(existing.map(({ name }) => name));
+  for (const context of additional) {
+    if (seen.has(context.name)) continue;
+    seen.add(context.name);
+    contexts.push(context);
+  }
+  return contexts;
+}
 function intersectNames(parent, layer, kind) {
   if (parent === void 0) return [...layer];
   const parentNames = new Set(parent);
@@ -5735,7 +5808,9 @@ var AgentRuntime = class _AgentRuntime {
     };
     const run = await this.owned.createRun({
       agentId,
-      input: "",
+      // An empty input is a system-triggered Control Run. A non-empty input
+      // represents a user invocation and is committed by the Durable Store.
+      input: options.input ?? "",
       metadata,
       idempotencyKey: options.idempotencyKey ?? createId("compact")
     });
@@ -5974,7 +6049,13 @@ var AgentRuntime = class _AgentRuntime {
         }
       }
       const executionId = createId("exec");
-      claim = await this.owned.claimRun({ runId: run.id, expectedRevision: run.revision, executionId, configToken: token });
+      claim = await this.owned.claimRun({
+        runId: run.id,
+        expectedRevision: run.revision,
+        executionId,
+        configToken: token,
+        ...controlKind ? {} : { inputContext: additionalContextInput(config) }
+      });
       executionRevision = claim.run.revision;
       const controller = new AbortController();
       this.executions.set(run.id, { controller, executionId });
@@ -6002,17 +6083,6 @@ var AgentRuntime = class _AgentRuntime {
             ...executionContext2.phases,
             entryPhaseId: COMPACT_PHASE_ID
           };
-          const instructions = controlKind === "compact" ? compactInstructions(run) : void 0;
-          if (instructions) {
-            executionContext2.messages.push({
-              id: createId("msg"),
-              role: "user",
-              content: `Additional compaction instructions:
-${instructions}`,
-              createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-              metadata: { kind: "phase_input", phase: COMPACT_PHASE_ID }
-            });
-          }
         }
         return executionContext2;
       };
@@ -6029,6 +6099,7 @@ ${instructions}`,
           agentId: run.agentId,
           runId: run.id,
           executionId: claim.execution.executionId,
+          input: typeof run.input === "string" ? run.input : run.input.content,
           ...agent.metadata === void 0 ? {} : { agentMetadata: agent.metadata },
           ...run.metadata === void 0 ? {} : { runMetadata: run.metadata }
         },
@@ -6175,6 +6246,7 @@ ${instructions}`,
         const output = latestAssistant(run, result.messages.slice(modelMessages.length), modelMessages.length);
         if (controlKind === "compact" || isCompactionOutcome(result.outcome.payload)) {
           const summary = compactSummary(result.outcome.payload);
+          const instructions = compactInstructions2(run) ?? compactOutputInstructions(result.outcome.payload);
           if (summary) {
             const covered = claim.history.at(-1);
             const record = {
@@ -6182,7 +6254,7 @@ ${instructions}`,
               agentId: run.agentId,
               summary,
               ...covered ? { coveredThrough: { messageId: covered.id, sequence: covered.sequenceWithinRun } } : {},
-              ...compactInstructions(run) ? { instructions: compactInstructions(run) } : {},
+              ...instructions ? { instructions } : {},
               createdAt: (/* @__PURE__ */ new Date()).toISOString()
             };
             await this.owned.commitContextCompaction(record);
@@ -6452,6 +6524,12 @@ ${instructions}`,
     this.heartbeat.unref?.();
   }
 };
+function additionalContextInput(config) {
+  const contexts = config.additionalContexts ?? [];
+  if (contexts.length === 0) return void 0;
+  const content = buildAdditionalContextMessage(contexts);
+  return content.length === 0 ? void 0 : { content, metadata: { kind: HOST_CONTEXT_MESSAGE_KIND } };
+}
 var DurableRun = class {
   constructor(runtime, id) {
     this.runtime = runtime;
@@ -6527,7 +6605,7 @@ function controlRunKind(run) {
   const kind = rowan.kind;
   return typeof kind === "string" ? kind : void 0;
 }
-function compactInstructions(run) {
+function compactInstructions2(run) {
   const rowan = run.metadata?.rowan;
   if (typeof rowan !== "object" || rowan === null || !("instructions" in rowan)) return void 0;
   const instructions = rowan.instructions;
@@ -6538,6 +6616,11 @@ function compactSummary(payload) {
   const summary = payload.summary;
   return typeof summary === "string" && summary.trim().length > 0 ? summary : void 0;
 }
+function compactOutputInstructions(payload) {
+  if (typeof payload !== "object" || payload === null || !("instructions" in payload)) return void 0;
+  const instructions = payload.instructions;
+  return typeof instructions === "string" && instructions.trim().length > 0 ? instructions.trim() : void 0;
+}
 function isCompactionOutcome(payload) {
   return typeof payload === "object" && payload !== null && "kind" in payload && payload.kind === "context_compaction";
 }
@@ -6995,7 +7078,14 @@ var InMemoryStore = class _InMemoryStore {
     this.assertOwner(lease);
     const executionId = input.executionId ?? createId("exec");
     const operationKey = `claim:${executionId}`;
-    const operationPayload = canonicalJson([input.runId, input.expectedRevision, input.messageId ?? null, input.configToken ?? null]);
+    const inputContext = input.inputContext === void 0 ? void 0 : normalizeUserInput(input.inputContext);
+    const operationPayload = canonicalJson([
+      input.runId,
+      input.expectedRevision,
+      input.messageId ?? null,
+      input.configToken ?? null,
+      inputContext ?? null
+    ]);
     const replay = this.replayOperation(operationKey, operationPayload);
     if (replay) return clone(replay);
     const run = this.requireRun(input.runId);
@@ -7011,10 +7101,25 @@ var InMemoryStore = class _InMemoryStore {
       throw new RuntimeError("run_state_conflict", { runId: run.id, expected: ["queued"], actual: run.state });
     }
     if (!run.pinnedConfigToken && input.configToken) run.pinnedConfigToken = input.configToken;
-    let message;
-    if (!run.checkpoint && !run.initialMessageId && !isControlRun(run)) {
+    const committedMessages = [];
+    const existingMessages = this.messagesForRun(run.id);
+    if (inputContext && hasUserInput(inputContext) && !isControlRun(run) && !existingMessages.some((message) => message.role === "user" && message.metadata?.kind === HOST_CONTEXT_MESSAGE_KIND && canonicalUserInput({ content: message.content, metadata: message.metadata }) === canonicalUserInput(inputContext))) {
+      const contextMessage = {
+        id: createId("msg"),
+        agentId: run.agentId,
+        runId: run.id,
+        role: "user",
+        content: userInputContent(inputContext),
+        ...userInputMetadata(inputContext) ? { metadata: clone(userInputMetadata(inputContext)) } : {},
+        sequenceWithinRun: this.nextMessageSequence(run.id),
+        createdAt: createTimestamp()
+      };
+      this.messages.set(contextMessage.id, contextMessage);
+      committedMessages.push(contextMessage);
+    }
+    if (!run.checkpoint && !run.initialMessageId && (!isControlRun(run) || hasUserInput(run.input))) {
       const userInput = normalizeUserInput(run.input);
-      message = {
+      const message = {
         id: input.messageId ?? createId("msg"),
         agentId: run.agentId,
         runId: run.id,
@@ -7025,6 +7130,7 @@ var InMemoryStore = class _InMemoryStore {
         createdAt: createTimestamp()
       };
       this.messages.set(message.id, message);
+      committedMessages.push(message);
     }
     const execution = {
       runId: run.id,
@@ -7035,7 +7141,7 @@ var InMemoryStore = class _InMemoryStore {
     run.execution = execution;
     run.revision += 1;
     run.updatedAt = createTimestamp();
-    if (message) this.appendMessage(run, message);
+    for (const message of committedMessages) this.appendMessage(run, message);
     this.appendTransition(run, "queued", "running");
     const result = { run: clone(run), execution: clone(execution), history: this.activeHistory(run.agentId, run.agentSequence) };
     this.writeOperationReceipt(operationKey, operationPayload, result);
@@ -7930,12 +8036,16 @@ function ownershipLost(expected, actual, reason) {
 function userInputContent(input) {
   return typeof input === "string" ? input : input.content;
 }
+function hasUserInput(input) {
+  const content = userInputContent(input);
+  return content.length > 0;
+}
 function userInputMetadata(input) {
   return typeof input === "string" ? void 0 : input.metadata;
 }
 function isControlRun(run) {
   const rowan = run.metadata?.rowan;
-  return typeof rowan === "object" && rowan !== null && "kind" in rowan && rowan.kind === "compact";
+  return typeof rowan === "object" && rowan !== null && typeof rowan.kind === "string" && rowan.kind.length > 0;
 }
 function estimateMessageTokens(messages) {
   let characters = 0;

package/package.json

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