@rowan-agent/agent 0.18.0 → 0.19.2

package/dist/index.d.ts

@@ -208,25 +208,11 @@ type PhaseMessageManager = {
     discard(messageId: string): void;
 };
 
-type UiSlot = "settings" | "model-picker";
-type UiContribution = {
-    slot: "settings";
-    id: string;
-    title: string;
-    description?: string;
-    settings: SettingsDefinition;
-} | {
-    slot: "model-picker";
-    id: string;
-    provider: string;
-    status?: {
-        kind: "ready" | "needs-setup" | "error";
-        message?: string;
-    };
-    actions?: {
-        id: string;
-        label: string;
-    }[];
+type HostContribution = {
+    readonly kind: string;
+    readonly id: string;
+} & {
+    readonly [key: string]: JsonValue;
 };
 interface ExtensionStateStore {
     get(key: string): Promise<JsonValue | undefined>;
@@ -592,10 +578,10 @@ interface ExtensionAPI {
         /** Get the message set by setMessage */
         getMessage(): string | undefined;
     };
-    /** Declarative UI contributions — settings or model picker decorations. */
-    ui: {
-        /** Contribute declarative UI to a host slot. Returns a disposer to remove the contribution. */
-        contribute(contribution: UiContribution): () => void;
+    /** Declarative host contributions. */
+    host: {
+        /** Contribute a declarative declaration to the host. Returns a disposer to remove the contribution. */
+        contribute<T extends HostContribution>(contribution: T): () => void;
     };
     /** Extension manifest from package.json `rowan` field. */
     manifest?: ExtensionManifest;
@@ -700,7 +686,7 @@ declare class ExtensionRunner {
     private bound;
     private readonly errorListeners;
     private readonly capabilityListeners;
-    private readonly uiContributionListeners;
+    private readonly hostContributionListeners;
     /** Current agent context — set by the agent before each phase */
     currentContext?: AgentContext;
     constructor(options?: ExtensionRunnerOptions);
@@ -766,13 +752,13 @@ declare class ExtensionRunner {
      * Returns an unsubscribe function.
      */
     onCapabilitiesChanged(listener: (capabilities: readonly ExtensionCapability[]) => void): () => void;
-    /** Get all contributed UI elements across all extensions. */
-    getUiContributions(): readonly UiContribution[];
+    /** Get all contributed host elements across all extensions. */
+    getHostContributions(): readonly HostContribution[];
     /**
-     * Subscribe to UI contribution changes (contributions added, removed, or extensions disposed).
+     * Subscribe to host contribution changes (contributions added, removed, or extensions disposed).
      * Returns an unsubscribe function.
      */
-    onUiContributionsChanged(listener: (contributions: readonly UiContribution[]) => void): () => void;
+    onHostContributionsChanged(listener: (contributions: readonly HostContribution[]) => void): () => void;
     triggerUiAction(event: {
         contributionId: string;
         actionId: string;
@@ -847,8 +833,8 @@ declare class ExtensionRunner {
     private unregisterTool;
     private contributeCapability;
     private notifyCapabilitiesChanged;
-    private contributeUi;
-    private notifyUiContributionsChanged;
+    private contributeToHost;
+    private notifyHostContributionsChanged;
     private registerPhase;
     private registerPhaseDefinition;
     private unregisterPhase;
@@ -1600,8 +1586,8 @@ interface AgentRuntime$1 {
     }): Promise<DurableConsumer>;
     listCapabilities(): readonly ExtensionCapability[];
     onCapabilitiesChanged(listener: (capabilities: readonly ExtensionCapability[]) => void): () => void;
-    listUiContributions(): readonly UiContribution[];
-    onUiContributionsChanged(listener: (contributions: readonly UiContribution[]) => void): () => void;
+    listHostContributions(): readonly HostContribution[];
+    onHostContributionsChanged(listener: (contributions: readonly HostContribution[]) => void): () => void;
     triggerUiAction(event: {
         contributionId: string;
         actionId: string;
@@ -1703,6 +1689,8 @@ type RunInteractionDriver = Readonly<{
     answers(): ReadonlyMap<string, JsonValue>;
     checkpoint(): JsonValue | undefined;
     clearCheckpoint(): void;
+    answer?(id: string, value: JsonValue): void;
+    clearAnswer?(id: string): void;
     suspend(input?: Readonly<{
         checkpoint?: JsonValue;
     }>): never;
@@ -2043,7 +2031,14 @@ type ModelRetry = Readonly<{
     delayMs: number;
     error: string;
 }>;
-type RunEvent = DurableRunEvent | MessageDelta | ThinkingDelta | ToolCallDelta | PhaseStatusEvent | ModelRetry | Extract<ToolStateChanged, {
+type LiveInteractionEvent = Readonly<{
+    kind: "live_interaction";
+    durability: "transient";
+    runId: RunId;
+    executionId?: ExecutionId;
+    interaction: RunInteraction;
+}>;
+type RunEvent = DurableRunEvent | MessageDelta | ThinkingDelta | ToolCallDelta | PhaseStatusEvent | ModelRetry | LiveInteractionEvent | Extract<ToolStateChanged, {
     durability: "transient";
 }>;
 
@@ -2422,6 +2417,8 @@ declare class AgentRuntime implements AgentRuntime$1 {
     private readonly retryDelayMs?;
     private constructor();
     static init(options: AgentRuntimeOptions): Promise<AgentRuntime>;
+    private publishLiveInteraction;
+    private cancelLiveInteractions;
     private handleRunEnd;
     loadAgents(input: LoadInput<AgentDefinition>): Promise<LoadResult>;
     loadSkills(input: LoadInput<Skill>): Promise<LoadResult>;
@@ -2499,8 +2496,8 @@ declare class AgentRuntime implements AgentRuntime$1 {
     }): Promise<DurableConsumer>;
     listCapabilities(): readonly ExtensionCapability[];
     onCapabilitiesChanged(listener: (capabilities: readonly ExtensionCapability[]) => void): () => void;
-    listUiContributions(): readonly UiContribution[];
-    onUiContributionsChanged(listener: (contributions: readonly UiContribution[]) => void): () => void;
+    listHostContributions(): readonly HostContribution[];
+    onHostContributionsChanged(listener: (contributions: readonly HostContribution[]) => void): () => void;
     triggerUiAction(event: {
         contributionId: string;
         actionId: string;
@@ -3306,4 +3303,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 EntryPhaseSpec, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionActivationError, type ExtensionActivationResult, type ExtensionCapability, type ExtensionCapabilityContribution, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, type ExtensionHost, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type ExtensionStateStore, type ExtensionToolContribution, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, InMemoryConfigProvider, InMemoryExtensionHost, 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 ModelRetry, 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 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 RunEndEvent, 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 RunStartEvent, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, STOP_PHASE_ID, type SettingsBadge, type SettingsControl, type SettingsDefinition, type SettingsItem, type SettingsOption, type SettingsSection, type Skill, SqliteStore, type TextContent, type ThinkingContent, type ThinkingDelta, type Tool$1 as Tool, type ToolCallContext, type ToolCallDelta, type ToolCallId, type ToolCallPresentationInput, type ToolCallPresentationOutput, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UiContribution, type UiSlot, type UserContent, type UserInput, type UserMessage, type WithdrawnUserInput, brandConfigToken, createCompactPhase, createCorePhases, createCoreTools, createDefaultPhase, createStopPhase, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhases, loadSkill, loadSkills, mergeToolCall, 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 EntryPhaseSpec, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionActivationError, type ExtensionActivationResult, type ExtensionCapability, type ExtensionCapabilityContribution, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, type ExtensionHost, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type ExtensionStateStore, type ExtensionToolContribution, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, type HostContribution, InMemoryConfigProvider, InMemoryExtensionHost, InMemoryStore, type InteractionRecord, type InvocationCatalogEntry, type InvocationSource, type JsonObject, type JsonPrimitive, type JsonValue, type LiveInteractionEvent, 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 ModelRetry, 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 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 RunEndEvent, 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 RunStartEvent, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, STOP_PHASE_ID, type SettingsBadge, type SettingsControl, type SettingsDefinition, type SettingsItem, type SettingsOption, type SettingsSection, type Skill, SqliteStore, type TextContent, type ThinkingContent, type ThinkingDelta, type Tool$1 as Tool, type ToolCallContext, type ToolCallDelta, type ToolCallId, type ToolCallPresentationInput, type ToolCallPresentationOutput, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UserContent, type UserInput, type UserMessage, type WithdrawnUserInput, brandConfigToken, createCompactPhase, createCorePhases, createCoreTools, createDefaultPhase, createStopPhase, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhases, loadSkill, loadSkills, mergeToolCall, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };

package/dist/index.js

@@ -1800,32 +1800,20 @@ function createExtensionAPI(hooks, options, runtime, eventBus) {
       getNextPhase: () => nextPhase,
       getMessage: () => outputMessage
     },
-    ui: {
+    host: {
       contribute: (contribution) => {
         assertActive();
-        if (!contribution || typeof contribution !== "object") {
-          throw new TypeError("UI contribution must be an object.");
+        if (!contribution || typeof contribution !== "object" || Array.isArray(contribution)) {
+          throw new TypeError("Host contribution must be an object.");
         }
-        if (contribution.slot !== "settings" && contribution.slot !== "model-picker") {
-          throw new TypeError(`Unsupported UI contribution slot: "${contribution.slot}".`);
+        if (typeof contribution.kind !== "string" || contribution.kind.trim() === "") {
+          throw new TypeError("Host contribution requires a non-empty kind.");
         }
         if (typeof contribution.id !== "string" || contribution.id.trim() === "") {
-          throw new TypeError("UI contribution requires a non-empty id.");
-        }
-        if (contribution.slot === "settings") {
-          if (typeof contribution.title !== "string") {
-            throw new TypeError("Settings UI contribution requires a title.");
-          }
-          if (!contribution.settings || typeof contribution.settings !== "object") {
-            throw new TypeError("Settings UI contribution requires a settings definition.");
-          }
+          throw new TypeError("Host contribution requires a non-empty id.");
         }
-        if (contribution.slot === "model-picker") {
-          if (typeof contribution.provider !== "string" || contribution.provider.trim() === "") {
-            throw new TypeError("Model-picker UI contribution requires a provider.");
-          }
-        }
-        const dispose = options?.contributeUi ? options.contributeUi(contribution) : () => {
+        assertJsonValue(contribution, "Host contribution");
+        const dispose = options?.contributeToHost ? options.contributeToHost(contribution) : () => {
         };
         trackCleanup?.(dispose);
         return dispose;
@@ -1934,6 +1922,19 @@ function createRunInteractionDriver(state, phase, signal) {
       checkpoint = void 0;
       sync();
     },
+    answer(id, value) {
+      answers.set(id, value);
+      const req = requests.get(id);
+      if (req) {
+        requests.set(id, { ...req, status: "answered", answer: value });
+      }
+      sync();
+    },
+    clearAnswer(id) {
+      answers.delete(id);
+      requests.delete(id);
+      sync();
+    },
     suspend(input = {}) {
       assertActive();
       const pending = this.pending();
@@ -3619,7 +3620,8 @@ async function executeToolCall(input) {
       toolCall: input.toolCall,
       contentBlocks: input.contentBlocks,
       driver: input.driver,
-      options: input.options
+      options: input.options,
+      ...input.providerInitiated ? { providerInitiated: true } : {}
     });
   } else {
     const toolContext = {
@@ -3664,7 +3666,7 @@ async function executeToolCalls(input) {
 }
 function createPhaseExecution(config, state, phase, messageManager, toolExecutionManager, registry) {
   const interaction = createRunInteractionDriver(state, phase.name, config.signal);
-  const executePhaseTool = async (phaseContext, toolCall, options) => {
+  const executePhaseTool = async (phaseContext, toolCall, options, providerInitiated = false) => {
     return runTurn(async () => {
       await toolExecutionManager.start(toolCall.id, toolCall.name, toolCall.args);
       const tools = phaseContext.tools.filter((tool) => tool.name !== PhaseRouteTool);
@@ -3680,7 +3682,8 @@ function createPhaseExecution(config, state, phase, messageManager, toolExecutio
         tools,
         toolCall,
         driver: interaction,
-        options
+        options,
+        providerInitiated
       });
       await toolExecutionManager.end(result.toolCallId, result.toolName, result, !result.ok);
       return result;
@@ -3763,7 +3766,7 @@ function createPhaseExecution(config, state, phase, messageManager, toolExecutio
               name,
               args
             };
-            const res = await executePhaseTool(phaseContext, toolCall, options2);
+            const res = await executePhaseTool(phaseContext, toolCall, options2, true);
             return res.ok ? { ok: true, content: res.content } : { ok: false, error: res.error ?? "Tool execution failed", ...res.content !== void 0 ? { content: res.content } : {} };
           },
           report: (update) => {
@@ -5352,7 +5355,6 @@ var TransientRunEventSubscription = class {
   stop() {
     if (this.stopped) return;
     this.stopped = true;
-    this.queue.length = 0;
     this.notify();
   }
   notify() {
@@ -5770,8 +5772,8 @@ var ExtensionRunner = class {
   errorListeners = /* @__PURE__ */ new Set();
   // Capability change listeners
   capabilityListeners = /* @__PURE__ */ new Set();
-  // UI contribution change listeners
-  uiContributionListeners = /* @__PURE__ */ new Set();
+  // Host contribution change listeners
+  hostContributionListeners = /* @__PURE__ */ new Set();
   /** Current agent context — set by the agent before each phase */
   currentContext;
   constructor(options) {
@@ -5875,7 +5877,7 @@ var ExtensionRunner = class {
         tools: /* @__PURE__ */ new Map(),
         phases: /* @__PURE__ */ new Set(),
         capabilities: /* @__PURE__ */ new Map(),
-        uiContributions: /* @__PURE__ */ new Map(),
+        hostContributions: /* @__PURE__ */ new Map(),
         cleanup: [],
         runtime: createExtensionRuntime()
       };
@@ -5888,8 +5890,8 @@ var ExtensionRunner = class {
         if (extension.capabilities.size > 0) {
           this.notifyCapabilitiesChanged();
         }
-        if (extension.uiContributions.size > 0) {
-          this.notifyUiContributionsChanged();
+        if (extension.hostContributions.size > 0) {
+          this.notifyHostContributionsChanged();
         }
       } catch (error) {
         await this.rollbackExtension(extension);
@@ -6019,23 +6021,23 @@ var ExtensionRunner = class {
     this.capabilityListeners.add(listener);
     return () => this.capabilityListeners.delete(listener);
   }
-  /** Get all contributed UI elements across all extensions. */
-  getUiContributions() {
+  /** Get all contributed host elements across all extensions. */
+  getHostContributions() {
     const result = [];
     for (const ext of this.extensions) {
-      for (const contrib of ext.uiContributions.values()) {
+      for (const contrib of ext.hostContributions.values()) {
         result.push(contrib);
       }
     }
     return Object.freeze(result);
   }
   /**
-   * Subscribe to UI contribution changes (contributions added, removed, or extensions disposed).
+   * Subscribe to host contribution changes (contributions added, removed, or extensions disposed).
    * Returns an unsubscribe function.
    */
-  onUiContributionsChanged(listener) {
-    this.uiContributionListeners.add(listener);
-    return () => this.uiContributionListeners.delete(listener);
+  onHostContributionsChanged(listener) {
+    this.hostContributionListeners.add(listener);
+    return () => this.hostContributionListeners.delete(listener);
   }
   triggerUiAction(event) {
     this.events.emit("ui.action", event);
@@ -6254,7 +6256,7 @@ var ExtensionRunner = class {
       registerTool: (tool) => this.registerTool(extension, tool),
       unregisterTool: (toolName) => this.unregisterTool(extension, toolName),
       contributeCapability: (contribution) => this.contributeCapability(extension, contribution),
-      contributeUi: (contribution) => this.contributeUi(extension, contribution),
+      contributeToHost: (contribution) => this.contributeToHost(extension, contribution),
       context: extContext,
       manifest,
       trackCleanup: (cleanup) => extension.cleanup.push(cleanup),
@@ -6364,38 +6366,38 @@ var ExtensionRunner = class {
       }
     }
   }
-  contributeUi(extension, contribution) {
-    const key = `${contribution.slot}:${contribution.id}`;
+  contributeToHost(extension, contribution) {
+    const key = `${contribution.kind}:${contribution.id}`;
     const entry = {
       ...contribution
     };
-    extension.uiContributions.set(key, entry);
+    extension.hostContributions.set(key, entry);
     if (this.extensions.includes(extension)) {
-      this.notifyUiContributionsChanged();
+      this.notifyHostContributionsChanged();
     }
     let disposed = false;
     const dispose = () => {
       if (disposed) return;
       disposed = true;
-      if (extension.uiContributions.get(key) === entry) {
-        extension.uiContributions.delete(key);
+      if (extension.hostContributions.get(key) === entry) {
+        extension.hostContributions.delete(key);
         if (this.extensions.includes(extension)) {
-          this.notifyUiContributionsChanged();
+          this.notifyHostContributionsChanged();
         }
       }
     };
     extension.cleanup.push(dispose);
     return dispose;
   }
-  notifyUiContributionsChanged() {
-    const contributions = this.getUiContributions();
-    for (const listener of this.uiContributionListeners) {
+  notifyHostContributionsChanged() {
+    const contributions = this.getHostContributions();
+    for (const listener of this.hostContributionListeners) {
       try {
         listener(contributions);
       } catch (error) {
         this.emitError({
           extensionPath: "<runtime>",
-          event: "ui_contributions_changed",
+          event: "host_contributions_changed",
           error: error instanceof Error ? error.message : String(error),
           stack: error instanceof Error ? error.stack : void 0
         });
@@ -6490,8 +6492,8 @@ var ExtensionRunner = class {
     for (const name of extension.phases) this.phases.delete(name);
     const hadCapabilities = extension.capabilities.size > 0;
     extension.capabilities.clear();
-    const hadUiContributions = extension.uiContributions.size > 0;
-    extension.uiContributions.clear();
+    const hadHostContributions = extension.hostContributions.size > 0;
+    extension.hostContributions.clear();
     for (const cleanup of [...extension.cleanup].reverse()) {
       await Promise.resolve().then(() => cleanup()).catch(() => void 0);
     }
@@ -6502,8 +6504,8 @@ var ExtensionRunner = class {
     if (hadCapabilities) {
       this.notifyCapabilitiesChanged();
     }
-    if (hadUiContributions) {
-      this.notifyUiContributionsChanged();
+    if (hadHostContributions) {
+      this.notifyHostContributionsChanged();
     }
   }
 };
@@ -7229,6 +7231,8 @@ function createToolInteractionDriver(driver, input) {
     answers: () => driver.answers(),
     checkpoint: () => resumed ? resumed.toolCheckpoint : stored,
     clearCheckpoint: () => driver.clearCheckpoint(),
+    answer: (id, val) => driver.answer?.(id, val),
+    clearAnswer: (id) => driver.clearAnswer?.(id),
     suspend(options = {}) {
       const interactionIds = [.../* @__PURE__ */ new Set([
         ...requestedIds,
@@ -7369,14 +7373,26 @@ var AgentRuntime = class _AgentRuntime {
       throw error;
     }
   }
-  async handleRunEnd(runId, agentId, outcome) {
+  publishLiveInteraction(runId, interaction) {
+    this.transientEvents.publish({
+      kind: "live_interaction",
+      durability: "transient",
+      runId,
+      executionId: this.executions.get(runId)?.executionId,
+      interaction
+    });
+  }
+  cancelLiveInteractions(runId, reason) {
     const runLive = this.liveInteractions.get(runId);
-    if (runLive) {
-      for (const live of runLive.values()) {
-        live.reject(new RunInteractionCancelledError("Run ended."));
-      }
-      this.liveInteractions.delete(runId);
+    if (!runLive) return;
+    this.liveInteractions.delete(runId);
+    for (const live of runLive.values()) {
+      this.publishLiveInteraction(runId, { ...live.interaction, status: "cancelled" });
+      live.reject(new RunInteractionCancelledError(reason));
     }
+  }
+  async handleRunEnd(runId, agentId, outcome) {
+    this.cancelLiveInteractions(runId, "Run ended.");
     if (this.startedRuns.has(runId)) {
       this.startedRuns.delete(runId);
       try {
@@ -7610,13 +7626,13 @@ var AgentRuntime = class _AgentRuntime {
     this.assertOpen();
     return this.resources.extensionRunner.onCapabilitiesChanged(listener);
   }
-  listUiContributions() {
+  listHostContributions() {
     this.assertOpen();
-    return this.resources.extensionRunner.getUiContributions();
+    return this.resources.extensionRunner.getHostContributions();
   }
-  onUiContributionsChanged(listener) {
+  onHostContributionsChanged(listener) {
     this.assertOpen();
-    return this.resources.extensionRunner.onUiContributionsChanged(listener);
+    return this.resources.extensionRunner.onHostContributionsChanged(listener);
   }
   triggerUiAction(event) {
     this.assertOpen();
@@ -7643,11 +7659,13 @@ var AgentRuntime = class _AgentRuntime {
       runLive = /* @__PURE__ */ new Map();
       this.liveInteractions.set(runId, runLive);
     }
+    this.publishLiveInteraction(runId, interaction);
     return new Promise((resolve9, reject) => {
       const onAbort = () => {
         runLive?.delete(interactionId);
         if (runLive && runLive.size === 0) this.liveInteractions.delete(runId);
         signal.removeEventListener("abort", onAbort);
+        this.publishLiveInteraction(runId, { ...interaction, status: "cancelled" });
         reject(signal.reason ?? new Error("Run aborted"));
       };
       signal.addEventListener("abort", onAbort, { once: true });
@@ -7670,12 +7688,9 @@ var AgentRuntime = class _AgentRuntime {
     if (this.heartbeat) clearInterval(this.heartbeat);
     for (const execution of this.executions.values()) execution.controller.abort();
     this.executions.clear();
-    for (const runLive of this.liveInteractions.values()) {
-      for (const live of runLive.values()) {
-        live.reject(new RunInteractionCancelledError("Runtime closed."));
-      }
+    for (const runId of [...this.liveInteractions.keys()]) {
+      this.cancelLiveInteractions(runId, "Runtime closed.");
     }
-    this.liveInteractions.clear();
     this.transientEvents.close();
     for (const subscription of this.consumers.values()) subscription.controller.abort();
     await this.resources.closeExtensions();
@@ -7705,8 +7720,10 @@ var AgentRuntime = class _AgentRuntime {
       runLive.delete(input.interactionId);
       if (runLive.size === 0) this.liveInteractions.delete(runId);
       if (input.cancel) {
+        this.publishLiveInteraction(runId, { ...live.interaction, status: "cancelled" });
         live.reject(new RunInteractionCancelledError("Run interaction cancelled."));
       } else if (input.input !== void 0) {
+        this.publishLiveInteraction(runId, { ...live.interaction, status: "answered", answer: input.input });
         live.resolve(input.input);
       } else {
         live.reject(new TypeError("respondInteraction requires input or cancel: true"));
@@ -7722,13 +7739,7 @@ var AgentRuntime = class _AgentRuntime {
   }
   async cancel(runId, reason) {
     this.assertOpen();
-    const runLive = this.liveInteractions.get(runId);
-    if (runLive) {
-      for (const live of runLive.values()) {
-        live.reject(new RunInteractionCancelledError(reason ?? "Agent run stopped."));
-      }
-      this.liveInteractions.delete(runId);
-    }
+    this.cancelLiveInteractions(runId, reason ?? "Agent run stopped.");
     const done = this.executionDone.get(runId);
     if (done) {
       this.cancellationRequested.add(runId);
@@ -7857,7 +7868,13 @@ var AgentRuntime = class _AgentRuntime {
       });
       executionRevision = claim.run.revision;
       const controller = new AbortController();
-      this.executions.set(run.id, { controller, executionId });
+      this.executions.set(run.id, {
+        controller,
+        executionId,
+        reservedToolCalls: /* @__PURE__ */ new Set(),
+        startedToolCalls: /* @__PURE__ */ new Set(),
+        providerToolCalls: /* @__PURE__ */ new Map()
+      });
       if (this.cancellationRequested.has(run.id)) controller.abort();
       if (!this.startedRuns.has(run.id)) {
         this.startedRuns.add(run.id);
@@ -8089,25 +8106,130 @@ var AgentRuntime = class _AgentRuntime {
         onContext: assembly.setContext,
         runtime: {
           interact: (request) => this.liveInteract(run.id, request, controller.signal),
-          tools: ({ toolCall, contentBlocks, driver, options }) => {
+          tools: ({ toolCall, contentBlocks, driver, options, providerInitiated }) => {
             const task = toolQueue.then(async () => {
-              const execution = await this.executeToolBatch({
-                run,
-                agentMetadata: agent.metadata,
-                execution: claim.execution,
-                expectedRevision: executionRevision,
-                toolConfig: executionTools,
-                toolCalls: [toolCall],
-                contentBlocks,
-                signal: controller.signal,
-                driver,
-                options,
-                onRevision: (rev) => {
-                  executionRevision = rev;
+              if (!providerInitiated) {
+                const execution = await this.executeToolBatch({
+                  run,
+                  agentMetadata: agent.metadata,
+                  execution: claim.execution,
+                  expectedRevision: executionRevision,
+                  toolConfig: executionTools,
+                  toolCalls: [toolCall],
+                  contentBlocks,
+                  signal: controller.signal,
+                  driver,
+                  options,
+                  onRevision: (rev) => {
+                    executionRevision = rev;
+                  }
+                });
+                executionRevision = execution.revision;
+                return execution.results[0];
+              }
+              const interactionIds = [];
+              try {
+                while (true) {
+                  try {
+                    const execution = await this.executeToolBatch({
+                      run,
+                      agentMetadata: agent.metadata,
+                      execution: claim.execution,
+                      expectedRevision: executionRevision,
+                      toolConfig: executionTools,
+                      toolCalls: [toolCall],
+                      contentBlocks,
+                      signal: controller.signal,
+                      driver,
+                      options,
+                      providerInitiated: true,
+                      interactionIds,
+                      onRevision: (rev) => {
+                        executionRevision = rev;
+                      }
+                    });
+                    executionRevision = execution.revision;
+                    return execution.results[0];
+                  } catch (error) {
+                    if (error instanceof RunInteractionBoundary) {
+                      try {
+                        for (const interaction of error.interactions) {
+                          interactionIds.push(interaction.id);
+                          const answer = await this.liveInteract(run.id, interaction, controller.signal);
+                          driver?.answer?.(interaction.id, answer);
+                        }
+                        driver?.clearCheckpoint();
+                        continue;
+                      } catch (waitError) {
+                        const active2 = this.executions.get(run.id);
+                        const toolCallId2 = active2?.providerToolCalls.get(toolCall.id) ?? error.interactions[0]?.toolCallId;
+                        const isCancel = waitError instanceof RunInteractionCancelledError;
+                        const reason = isCancel ? waitError.message : "Tool execution aborted.";
+                        if (toolCallId2) {
+                          const committed2 = await this.owned.commitToolResult({
+                            runId: run.id,
+                            execution: claim.execution,
+                            expectedRevision: executionRevision,
+                            toolCallId: toolCallId2,
+                            state: "failed",
+                            result: { ok: false, content: null, error: reason },
+                            title: toolCall.name,
+                            kind: "other"
+                          });
+                          executionRevision = committed2.run.revision;
+                          if (options?.onUpdate) {
+                            try {
+                              options.onUpdate(createMergedToolCall(
+                                toolCallId2,
+                                "failed",
+                                { rawInput: toJsonValue(toolCall.args) },
+                                toolCall.name,
+                                "other"
+                              ));
+                            } catch (err) {
+                              console.warn("Error in tool call onUpdate callback:", err);
+                            }
+                          }
+                        }
+                        if (!controller.signal.aborted && isCancel) {
+                          return {
+                            toolCallId: toolCall.id,
+                            toolName: toolCall.name,
+                            ok: false,
+                            content: null,
+                            error: reason
+                          };
+                        }
+                        throw waitError;
+                      }
+                    }
+                    const active = this.executions.get(run.id);
+                    const toolCallId = active?.providerToolCalls.get(toolCall.id);
+                    if (toolCallId && (active?.reservedToolCalls.has(toolCallId) || active?.startedToolCalls.has(toolCallId))) {
+                      try {
+                        const committed2 = await this.owned.commitToolResult({
+                          runId: run.id,
+                          execution: claim.execution,
+                          expectedRevision: executionRevision,
+                          toolCallId,
+                          state: "failed",
+                          result: { ok: false, content: null, error: error instanceof Error ? error.message : "Tool execution failed." },
+                          title: toolCall.name,
+                          kind: "other"
+                        });
+                        executionRevision = committed2.run.revision;
+                      } catch {
+                      }
+                    }
+                    throw error;
+                  }
                 }
-              });
-              executionRevision = execution.revision;
-              return execution.results[0];
+              } finally {
+                driver?.clearCheckpoint();
+                for (const id of interactionIds) driver?.clearAnswer?.(id);
+                const active = this.executions.get(run.id);
+                active?.providerToolCalls.delete(toolCall.id);
+              }
             });
             toolQueue = task.then(() => void 0, () => void 0);
             return task;
@@ -8148,6 +8270,9 @@ var AgentRuntime = class _AgentRuntime {
           result = await executeModel(executionContext);
         }
       }
+      if (result.type !== "input_required") {
+        this.cancelLiveInteractions(run.id, result.type === "failed" ? result.error instanceof Error ? result.error.message : "Model execution failed." : "Run ended.");
+      }
       await toolQueue;
       if (this.cancellationRequested.has(run.id) || controller.signal.aborted) {
         const output2 = latestAssistant(run, result.messages, executionContext.messages.length, true);
@@ -8221,6 +8346,7 @@ var AgentRuntime = class _AgentRuntime {
     } catch (error) {
       if (!claim && error instanceof RuntimeError && ["run_state_conflict", "runtime_ownership_lost", "run_not_found"].includes(error.code)) return;
       if (claim) {
+        this.cancelLiveInteractions(run.id, error instanceof Error ? error.message : "Execution failed.");
         await toolQueue;
         if (this.cancellationRequested.has(run.id)) {
           const reason = this.cancellationReasons.get(run.id) ?? "Agent run stopped.";
@@ -8457,11 +8583,17 @@ var AgentRuntime = class _AgentRuntime {
     }
     const results = suspension ? [...suspension.completedResults] : [];
     const startIndex = suspension ? suspension.pendingIndex : 0;
+    const active = this.executions.get(input.run.id);
     for (let index = startIndex; index < input.toolCalls.length; index += 1) {
       const toolCall = input.toolCalls[index];
       const durableTool = input.toolConfig.tools.find((candidate) => candidate.name === toolCall.name);
       const providerToolCallId = toolCall.id;
-      const toolCallId = suspension && index >= suspension.pendingIndex && suspension.toolCallIds?.[index] ? suspension.toolCallIds[index] : suspension && index === suspension.pendingIndex && suspension.toolCallId ? suspension.toolCallId : createId("tool");
+      const toolCallId = input.providerInitiated && active?.providerToolCalls.has(providerToolCallId) ? active.providerToolCalls.get(providerToolCallId) : suspension && index >= suspension.pendingIndex && suspension.toolCallIds?.[index] ? suspension.toolCallIds[index] : suspension && index === suspension.pendingIndex && suspension.toolCallId ? suspension.toolCallId : createId("tool");
+      if (input.providerInitiated && !active?.providerToolCalls.has(providerToolCallId)) {
+        active?.providerToolCalls.set(providerToolCallId, toolCallId);
+      }
+      const isReserved = Boolean(active?.reservedToolCalls.has(toolCallId));
+      const isStarted = Boolean(active?.startedToolCalls.has(toolCallId));
       const protocolFailure = (error) => ({
         toolCallId: providerToolCallId,
         toolName: toolCall.name,
@@ -8470,20 +8602,23 @@ var AgentRuntime = class _AgentRuntime {
         error
       });
       if (!durableTool) {
-        const reserved = await this.owned.reserveToolCalls({
-          runId: input.run.id,
-          execution: input.execution,
-          expectedRevision: revision,
-          requestMessageId: createId("msg"),
-          contentBlocks: input.contentBlocks,
-          calls: [{
-            toolCallId,
-            providerToolCallId,
-            name: toolCall.name,
-            args: toJsonValue(toolCall.args)
-          }]
-        });
-        setRevision(reserved.run.revision);
+        if (!isReserved) {
+          const reserved = await this.owned.reserveToolCalls({
+            runId: input.run.id,
+            execution: input.execution,
+            expectedRevision: revision,
+            requestMessageId: createId("msg"),
+            contentBlocks: input.contentBlocks,
+            calls: [{
+              toolCallId,
+              providerToolCallId,
+              name: toolCall.name,
+              args: toJsonValue(toolCall.args)
+            }]
+          });
+          setRevision(reserved.run.revision);
+          active?.reservedToolCalls.add(toolCallId);
+        }
         const failed = await this.owned.commitToolResult({
           runId: input.run.id,
           execution: input.execution,
@@ -8549,7 +8684,7 @@ var AgentRuntime = class _AgentRuntime {
         reportProgress: () => {
         }
       };
-      const answer = suspension && index === suspension.pendingIndex ? suspension.interactionIds?.map((id) => input.driver?.answers().get(id)).find((value) => value !== void 0) : void 0;
+      const answer = suspension && index === suspension.pendingIndex ? suspension.interactionIds?.map((id) => input.driver?.answers().get(id)).find((value) => value !== void 0) : input.providerInitiated && input.interactionIds ? input.interactionIds.map((id) => input.driver?.answers().get(id)).find((value) => value !== void 0) : void 0;
       try {
         if (input.toolConfig.beforeToolCall) {
           const decision = await input.toolConfig.beforeToolCall({
@@ -8564,7 +8699,7 @@ var AgentRuntime = class _AgentRuntime {
               throw new Error("Tool call requested interaction but no interaction driver is active.");
             }
             interactionDriver.request(decision.interaction);
-            if (!resumedStart) {
+            if (!resumedStart && !isReserved) {
               const reserved = await this.owned.reserveToolCalls({
                 runId: input.run.id,
                 execution: input.execution,
@@ -8580,11 +8715,12 @@ var AgentRuntime = class _AgentRuntime {
                 }]
               });
               setRevision(reserved.run.revision);
+              active?.reservedToolCalls.add(toolCallId);
             }
             interactionDriver.suspend();
           }
           if ("allow" in decision && !decision.allow) {
-            if (!resumedStart) {
+            if (!resumedStart && !isReserved) {
               const reserved = await this.owned.reserveToolCalls({
                 runId: input.run.id,
                 execution: input.execution,
@@ -8600,6 +8736,7 @@ var AgentRuntime = class _AgentRuntime {
                 }]
               });
               setRevision(reserved.run.revision);
+              active?.reservedToolCalls.add(toolCallId);
             }
             const failed = await this.owned.commitToolResult({
               runId: input.run.id,
@@ -8637,7 +8774,7 @@ var AgentRuntime = class _AgentRuntime {
           throw error;
         }
         const reason = error instanceof Error ? error.message : "Tool policy rejected the call.";
-        if (!resumedStart) {
+        if (!resumedStart && !isReserved) {
           const reserved = await this.owned.reserveToolCalls({
             runId: input.run.id,
             execution: input.execution,
@@ -8653,6 +8790,7 @@ var AgentRuntime = class _AgentRuntime {
             }]
           });
           setRevision(reserved.run.revision);
+          active?.reservedToolCalls.add(toolCallId);
         }
         const failed = await this.owned.commitToolResult({
           runId: input.run.id,
@@ -8684,22 +8822,25 @@ var AgentRuntime = class _AgentRuntime {
         results.push(protocolFailure(reason));
         continue;
       }
-      if (!resumedStart) {
-        const reserved = await this.owned.reserveToolCalls({
-          runId: input.run.id,
-          execution: input.execution,
-          expectedRevision: revision,
-          requestMessageId: createId("msg"),
-          contentBlocks: input.contentBlocks,
-          calls: [{
-            toolCallId,
-            providerToolCallId,
-            name: toolCall.name,
-            args: toJsonValue(toolCall.args),
-            ...pendingPres
-          }]
-        });
-        setRevision(reserved.run.revision);
+      if (!resumedStart && !isStarted) {
+        if (!isReserved) {
+          const reserved = await this.owned.reserveToolCalls({
+            runId: input.run.id,
+            execution: input.execution,
+            expectedRevision: revision,
+            requestMessageId: createId("msg"),
+            contentBlocks: input.contentBlocks,
+            calls: [{
+              toolCallId,
+              providerToolCallId,
+              name: toolCall.name,
+              args: toJsonValue(toolCall.args),
+              ...pendingPres
+            }]
+          });
+          setRevision(reserved.run.revision);
+          active?.reservedToolCalls.add(toolCallId);
+        }
         const inProgressPres = await presentToolCall(durableTool, {
           status: "in_progress",
           args: toJsonValue(toolCall.args)
@@ -8717,6 +8858,7 @@ var AgentRuntime = class _AgentRuntime {
           ...currentToolState._meta !== void 0 ? { _meta: currentToolState._meta } : {}
         });
         setRevision(started.run.revision);
+        active?.startedToolCalls.add(toolCallId);
       }
       const toolResult2 = await this.executeAndCommitTool({
         runId: input.run.id,
@@ -8741,7 +8883,8 @@ var AgentRuntime = class _AgentRuntime {
         signal: input.signal,
         afterToolCall: input.toolConfig.afterToolCall,
         currentToolState,
-        options: input.options
+        options: input.options,
+        providerInitiated: input.providerInitiated
       });
       results.push(toolResult2);
     }
@@ -8913,13 +9056,15 @@ var AgentRuntime = class _AgentRuntime {
       };
     } catch (error) {
       if (error instanceof RunInteractionBoundary) {
-        const suspended = await this.owned.suspendToolCall({
-          runId: input.runId,
-          execution: input.execution,
-          expectedRevision: input.revision,
-          toolCallId: input.toolCallId
-        });
-        input.setRevision(suspended.run.revision);
+        if (!input.providerInitiated) {
+          const suspended = await this.owned.suspendToolCall({
+            runId: input.runId,
+            execution: input.execution,
+            expectedRevision: input.revision,
+            toolCallId: input.toolCallId
+          });
+          input.setRevision(suspended.run.revision);
+        }
         throw error;
       }
       if (error instanceof RunInteractionCancelledError) throw error;

package/package.json

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