@dudousxd/nestjs-agent-core 0.44.1 → 0.45.1

package/dist/index.cjs

@@ -68,6 +68,7 @@ __export(src_exports, {
   DEFAULT_MAX_FACT_CHARS: () => DEFAULT_MAX_FACT_CHARS,
   DEFAULT_MAX_MEMORIES: () => DEFAULT_MAX_MEMORIES,
   DEFAULT_MAX_SKILLS: () => DEFAULT_MAX_SKILLS,
+  DEFAULT_PREVIEW_THROTTLE_MS: () => DEFAULT_PREVIEW_THROTTLE_MS,
   DEFAULT_REFUSAL_REASON: () => DEFAULT_REFUSAL_REASON,
   DEFAULT_STRUCTURED_OUTPUT_INSTRUCTION: () => DEFAULT_STRUCTURED_OUTPUT_INSTRUCTION,
   DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES: () => DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES,
@@ -186,9 +187,12 @@ __export(src_exports, {
   observeTurnFrames: () => observeTurnFrames,
   offerMemories: () => offerMemories,
   offerSkills: () => offerSkills,
+  parsePartialJson: () => parsePartialJson,
   parseTextActionProposalCommand: () => parseTextActionProposalCommand,
   personaCatalogEntry: () => personaCatalogEntry,
   prepareActionProposal: () => prepareActionProposal,
+  previewToolInputs: () => previewToolInputs,
+  previewUiId: () => previewUiId,
   ptBrActionProposalText: () => ptBrActionProposalText,
   publishAgentDelegated: () => publishAgentDelegated,
   publishAgentMemoryResolved: () => publishAgentMemoryResolved,
@@ -209,6 +213,7 @@ __export(src_exports, {
   quotaWarning: () => quotaWarning,
   readElicitationInput: () => readElicitationInput,
   readElicitationQuestions: () => readElicitationQuestions,
+  registryInputPreviews: () => registryInputPreviews,
   releaseGatedFrames: () => releaseGatedFrames,
   releaseThreadRun: () => releaseThreadRun,
   rememberInputSchema: () => rememberInputSchema,
@@ -251,6 +256,8 @@ __export(src_exports, {
   toActionProposalView: () => toActionProposalView,
   toolCallApprovalFromRow: () => toolCallApprovalFromRow,
   toolCallContext: () => toolCallContext,
+  toolCallUpdateForProposal: () => toolCallUpdateForProposal,
+  toolCallUpdateForTransition: () => toolCallUpdateForTransition,
   traceLlmTurn: () => traceLlmTurn,
   traceToolExecution: () => traceToolExecution,
   transitionActionProposalClaim: () => transitionActionProposalClaim,
@@ -277,6 +284,7 @@ __export(src_exports, {
   withSkillTool: () => withSkillTool,
   withToolTimeout: () => withToolTimeout,
   withTurnFrames: () => withTurnFrames,
+  withdrawPreviewEvent: () => withdrawPreviewEvent,
   wrapToolPreflightDenied: () => wrapToolPreflightDenied,
   wrapToolStepOutput: () => wrapToolStepOutput,
   writeMemory: () => writeMemory
@@ -398,7 +406,7 @@ function observeTurnFrames(writer, now = Date.now) {
       return;
     }
     closeBurst();
-    if (event.kind === "ui") {
+    if (event.kind === "ui" && event.partial !== true) {
       ui.set(event.id, {
         id: event.id,
         component: event.component,
@@ -468,6 +476,423 @@ function withTurnFrames(result2, frames) {
 }
 __name(withTurnFrames, "withTurnFrames");
 
+// src/partial-json.ts
+var Cut = class Cut2 extends Error {
+  static {
+    __name(this, "Cut");
+  }
+};
+function parsePartialJson(text) {
+  const open = /* @__PURE__ */ new WeakSet();
+  const pending = /* @__PURE__ */ new WeakMap();
+  let at = 0;
+  const skipSpace = /* @__PURE__ */ __name(() => {
+    while (at < text.length) {
+      const char = text.charCodeAt(at);
+      if (char === 32 || char === 9 || char === 10 || char === 13) at += 1;
+      else break;
+    }
+  }, "skipSpace");
+  const fail = /* @__PURE__ */ __name(() => {
+    throw new SyntaxError(`unexpected character at ${at}`);
+  }, "fail");
+  const readString = /* @__PURE__ */ __name(() => {
+    at += 1;
+    let out = "";
+    while (at < text.length) {
+      const char = text[at];
+      if (char === '"') {
+        at += 1;
+        return {
+          value: out,
+          cut: false
+        };
+      }
+      if (char === "\\") {
+        const next = text[at + 1];
+        if (next === void 0) {
+          at = text.length;
+          return {
+            value: out,
+            cut: true
+          };
+        }
+        if (next === "u") {
+          const hex = text.slice(at + 2, at + 6);
+          if (hex.length < 4) {
+            at = text.length;
+            return {
+              value: out,
+              cut: true
+            };
+          }
+          if (!/^[0-9a-fA-F]{4}$/.test(hex)) fail();
+          out += String.fromCharCode(Number.parseInt(hex, 16));
+          at += 6;
+          continue;
+        }
+        const escapes = {
+          '"': '"',
+          "\\": "\\",
+          "/": "/",
+          b: "\b",
+          f: "\f",
+          n: "\n",
+          r: "\r",
+          t: "	"
+        };
+        const escaped = escapes[next];
+        if (escaped === void 0) fail();
+        out += escaped;
+        at += 2;
+        continue;
+      }
+      out += char;
+      at += 1;
+    }
+    return {
+      value: out,
+      cut: true
+    };
+  }, "readString");
+  const readValue = /* @__PURE__ */ __name(() => {
+    skipSpace();
+    if (at >= text.length) throw new Cut();
+    const char = text[at];
+    if (char === "{") return readObject();
+    if (char === "[") return readArray();
+    if (char === '"') return readString();
+    const rest = text.slice(at);
+    const number = /^-?\d*(?:\.\d*)?(?:[eE][+-]?\d*)?/.exec(rest)?.[0] ?? "";
+    if (number.length > 0) {
+      if (at + number.length >= text.length) throw new Cut();
+      if (!/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/.test(number)) fail();
+      at += number.length;
+      return {
+        value: Number(number),
+        cut: false
+      };
+    }
+    for (const [word, value] of [
+      [
+        "true",
+        true
+      ],
+      [
+        "false",
+        false
+      ],
+      [
+        "null",
+        null
+      ]
+    ]) {
+      if (rest.startsWith(word)) {
+        at += word.length;
+        return {
+          value,
+          cut: false
+        };
+      }
+      if (word.startsWith(rest)) throw new Cut();
+    }
+    return fail();
+  }, "readValue");
+  const readObject = /* @__PURE__ */ __name(() => {
+    const object = {};
+    open.add(object);
+    at += 1;
+    skipSpace();
+    if (text[at] === "}") {
+      at += 1;
+      open.delete(object);
+      return {
+        value: object,
+        cut: false
+      };
+    }
+    for (; ; ) {
+      skipSpace();
+      if (at >= text.length) return {
+        value: object,
+        cut: true
+      };
+      if (text[at] !== '"') fail();
+      const key = readString();
+      if (key.cut) return {
+        value: object,
+        cut: true
+      };
+      skipSpace();
+      if (at >= text.length) {
+        pending.set(object, key.value);
+        return {
+          value: object,
+          cut: true
+        };
+      }
+      if (text[at] !== ":") fail();
+      at += 1;
+      let member;
+      try {
+        member = readValue();
+      } catch (error) {
+        if (!(error instanceof Cut)) throw error;
+        pending.set(object, key.value);
+        return {
+          value: object,
+          cut: true
+        };
+      }
+      object[key.value] = member.value;
+      if (member.cut) {
+        pending.set(object, key.value);
+        return {
+          value: object,
+          cut: true
+        };
+      }
+      skipSpace();
+      if (at >= text.length) return {
+        value: object,
+        cut: true
+      };
+      if (text[at] === ",") {
+        at += 1;
+        continue;
+      }
+      if (text[at] === "}") {
+        at += 1;
+        open.delete(object);
+        return {
+          value: object,
+          cut: false
+        };
+      }
+      fail();
+    }
+  }, "readObject");
+  const readArray = /* @__PURE__ */ __name(() => {
+    const array = [];
+    open.add(array);
+    at += 1;
+    skipSpace();
+    if (text[at] === "]") {
+      at += 1;
+      open.delete(array);
+      return {
+        value: array,
+        cut: false
+      };
+    }
+    for (; ; ) {
+      let item;
+      try {
+        item = readValue();
+      } catch (error) {
+        if (!(error instanceof Cut)) throw error;
+        pending.set(array, array.length);
+        return {
+          value: array,
+          cut: true
+        };
+      }
+      array.push(item.value);
+      if (item.cut) {
+        pending.set(array, array.length - 1);
+        return {
+          value: array,
+          cut: true
+        };
+      }
+      skipSpace();
+      if (at >= text.length) return {
+        value: array,
+        cut: true
+      };
+      if (text[at] === ",") {
+        at += 1;
+        continue;
+      }
+      if (text[at] === "]") {
+        at += 1;
+        open.delete(array);
+        return {
+          value: array,
+          cut: false
+        };
+      }
+      fail();
+    }
+  }, "readArray");
+  let root;
+  try {
+    root = readValue();
+  } catch (error) {
+    if (error instanceof Cut) root = {
+      value: void 0,
+      cut: true
+    };
+    else return void 0;
+  }
+  skipSpace();
+  return {
+    value: root.value,
+    complete: !root.cut && at >= text.length,
+    isOpen: /* @__PURE__ */ __name((container) => open.has(container), "isOpen"),
+    pendingMember: /* @__PURE__ */ __name((container) => pending.get(container), "pendingMember")
+  };
+}
+__name(parsePartialJson, "parsePartialJson");
+
+// src/tool-input-preview.ts
+var DEFAULT_PREVIEW_THROTTLE_MS = 100;
+function previewUiId(toolCallId) {
+  return `${toolCallId}:ui:0`;
+}
+__name(previewUiId, "previewUiId");
+function withdrawPreviewEvent(shown) {
+  return {
+    kind: "ui",
+    id: shown.id,
+    component: shown.component,
+    props: {},
+    toolCallId: shown.toolCallId,
+    partial: true
+  };
+}
+__name(withdrawPreviewEvent, "withdrawPreviewEvent");
+function previewToolInputs(inner, resolve, now = Date.now) {
+  const calls = /* @__PURE__ */ new Map();
+  const shown = /* @__PURE__ */ new Map();
+  const decoder3 = new TextDecoder();
+  let pending = "";
+  async function emit2(id, state, input, done) {
+    let rendered;
+    try {
+      const parsed = done && input !== void 0 ? {
+        value: input,
+        complete: true,
+        isOpen: /* @__PURE__ */ __name(() => false, "isOpen"),
+        pendingMember: /* @__PURE__ */ __name(() => void 0, "pendingMember")
+      } : parsePartialJson(state.text);
+      if (parsed === void 0) return;
+      rendered = state.preview.render({
+        value: parsed.value,
+        done: done || parsed.complete,
+        isOpen: parsed.isOpen,
+        pendingMember: parsed.pendingMember
+      });
+    } catch {
+      rendered = null;
+    }
+    if (rendered === void 0) return;
+    const uiId = previewUiId(id);
+    if (rendered === null) {
+      state.stopped = true;
+      const standing = shown.get(uiId);
+      if (standing !== void 0) {
+        shown.delete(uiId);
+        await inner.write(encodeStreamEvent(withdrawPreviewEvent(standing)));
+      }
+      return;
+    }
+    const props = JSON.stringify(rendered.props);
+    if (props === state.lastProps && rendered.component === state.component) return;
+    state.lastProps = props;
+    state.component = rendered.component;
+    state.lastAt = now();
+    shown.set(uiId, {
+      id: uiId,
+      component: rendered.component,
+      toolCallId: id
+    });
+    await inner.write(encodeStreamEvent({
+      kind: "ui",
+      id: uiId,
+      component: rendered.component,
+      props: JSON.parse(props),
+      ...rendered.version !== void 0 ? {
+        version: rendered.version
+      } : {},
+      toolCallId: id,
+      partial: true
+    }));
+  }
+  __name(emit2, "emit");
+  async function observe(event) {
+    if (event.kind === "tool-input-start") {
+      if (calls.has(event.id)) return;
+      let preview;
+      try {
+        preview = await resolve(event.name, event.id);
+      } catch {
+        preview = void 0;
+      }
+      if (preview !== void 0) {
+        calls.set(event.id, {
+          preview,
+          text: "",
+          lastAt: void 0,
+          lastProps: void 0,
+          component: void 0,
+          stopped: false
+        });
+      }
+      return;
+    }
+    if (event.kind === "tool-input-delta") {
+      const state = calls.get(event.id);
+      if (state === void 0 || state.stopped) return;
+      state.text += event.delta;
+      const throttle = state.preview.throttleMs ?? DEFAULT_PREVIEW_THROTTLE_MS;
+      if (state.lastAt !== void 0 && now() - state.lastAt < throttle) return;
+      await emit2(event.id, state, void 0, false);
+      return;
+    }
+    if (event.kind === "tool-input-available") {
+      const state = calls.get(event.id);
+      if (state === void 0) return;
+      calls.delete(event.id);
+      if (state.stopped) return;
+      await emit2(event.id, state, event.input, true);
+    }
+  }
+  __name(observe, "observe");
+  return {
+    writer: {
+      async write(chunk) {
+        await inner.write(chunk);
+        pending += decoder3.decode(chunk, {
+          stream: true
+        });
+        let newline = pending.indexOf("\n");
+        while (newline !== -1) {
+          const line = pending.slice(0, newline);
+          pending = pending.slice(newline + 1);
+          const event = line.trim().length > 0 ? decodeStreamEvent(line) : null;
+          if (event !== null) await observe(event);
+          newline = pending.indexOf("\n");
+        }
+      },
+      end: /* @__PURE__ */ __name(() => inner.end(), "end"),
+      fail: /* @__PURE__ */ __name((error) => inner.fail(error), "fail")
+    },
+    shown: /* @__PURE__ */ __name(() => [
+      ...shown.values()
+    ], "shown")
+  };
+}
+__name(previewToolInputs, "previewToolInputs");
+function registryInputPreviews(registry, offered, scope) {
+  const names = new Set(offered.map((tool) => tool.name));
+  return async (toolName, toolCallId) => names.has(toolName) ? registry.previewInput(toolName, {
+    ...scope,
+    toolCallId
+  }) : void 0;
+}
+__name(registryInputPreviews, "registryInputPreviews");
+
 // src/tool-ui.ts
 var TOOL_STEP_UI = "@@nestjs-agent/tool-step-ui";
 function wrapToolStepOutput(output, ui, text) {
@@ -3354,6 +3779,7 @@ function defineComponent(definition) {
   }
   if (definition.version !== void 0 && (!Number.isSafeInteger(definition.version) || definition.version <= 0)) throw new RangeError("genui: component version must be a positive safe integer");
   if (definition.fallbackText !== void 0 && typeof definition.fallbackText !== "function") throw new TypeError("genui: fallbackText must be a function");
+  if (definition.streaming !== void 0 && definition.streaming !== "partial" && definition.streaming !== "complete") throw new TypeError("genui: streaming must be 'partial' or 'complete'");
   return definition;
 }
 __name(defineComponent, "defineComponent");
@@ -4712,6 +5138,19 @@ var ToolRegistry = class {
   unregister(name) {
     return this.entries.delete(name);
   }
+  /**
+  * How a streamed call of `name` is previewed while its input arrives (`ToolHandler.previewInput`),
+  * or `undefined`. A preview that fails to build is no preview: it never fails the turn.
+  */
+  async previewInput(name, scope) {
+    const handler = this.entries.get(name)?.handler;
+    if (handler?.previewInput === void 0) return void 0;
+    try {
+      return await handler.previewInput(scope) ?? void 0;
+    } catch {
+      return void 0;
+    }
+  }
   spec(name) {
     return this.entries.get(name)?.spec;
   }
@@ -4770,6 +5209,9 @@ var ToolRegistry = class {
   * Run a tool. Re-checks that the tool is enabled and that the role allows it (defense-in-depth —
   * a call can reach here from a replayed durable step or an approval granted before the flag
   * moved, neither of which went through `definitionsFor` again) and re-parses the input via Zod.
+  * A tool whose `describe()` answers `available: false` for the call's scope (actor, thread, agent,
+  * `uiCapabilities`) is refused with {@link ToolNotFoundError}, as the unknown tool it was to the
+  * model.
   */
   async invoke(name, input, ctx, policy, options = {}) {
     const { entry, value, ctx: withEmit } = await this.validated(name, input, ctx, policy, options);
@@ -4823,6 +5265,10 @@ var ToolRegistry = class {
     if (options.allowedTools !== void 0 && !options.allowedTools.includes(name)) {
       throw new ToolForbiddenError(name);
     }
+    if (entry.handler.describe !== void 0) {
+      const described = await entry.handler.describe(describeScopeOf(ctx));
+      if (described?.available === false) throw new ToolNotFoundError(name);
+    }
     const validation = await entry.spec.inputSchema["~standard"].validate(input);
     if (validation.issues !== void 0) {
       throw new ToolInputInvalidError(name, validation.issues);
@@ -4838,6 +5284,21 @@ var ToolRegistry = class {
     };
   }
 };
+function describeScopeOf(ctx) {
+  return {
+    actor: ctx.actor,
+    ...ctx.threadId ? {
+      threadId: ctx.threadId
+    } : {},
+    ...ctx.agentName !== void 0 ? {
+      agentName: ctx.agentName
+    } : {},
+    ...ctx.uiCapabilities !== void 0 ? {
+      uiCapabilities: ctx.uiCapabilities
+    } : {}
+  };
+}
+__name(describeScopeOf, "describeScopeOf");
 var DefaultRolesPolicy = class {
   static {
     __name(this, "DefaultRolesPolicy");
@@ -5221,6 +5682,21 @@ var RunCancelledError = class extends Error {
     this.name = "RunCancelledError";
   }
 };
+async function abortableModelCall(hooks, call) {
+  const signal = hooks.abortSignal;
+  let result2;
+  try {
+    result2 = await call(signal !== void 0 ? {
+      abortSignal: signal
+    } : {});
+  } catch (error) {
+    if (signal?.aborted === true) throw new RunCancelledError();
+    throw error;
+  }
+  if (signal?.aborted === true) throw new RunCancelledError();
+  return result2;
+}
+__name(abortableModelCall, "abortableModelCall");
 function agentFailureCode(error) {
   if (error instanceof RunCancelledError) {
     return "cancelled";
@@ -5678,13 +6154,14 @@ async function structureAnswer(schema, deps, input, hooks, messages, step) {
         fail: /* @__PURE__ */ __name(() => {
         }, "fail")
       };
-      const turn = await deps.model.runTurn({
+      const turn = await abortableModelCall(hooks, (signal) => deps.model.runTurn({
         system,
         messages,
         tools: [],
         sink: discard,
-        outputSchema: schema
-      });
+        outputSchema: schema,
+        ...signal
+      }));
       return {
         text: turn.text,
         usage: turn.usage,
@@ -5806,6 +6283,9 @@ function toolContext(deps, input, hooks) {
     ...deps.host !== void 0 ? {
       host: deps.host
     } : {},
+    ...hooks.abortSignal !== void 0 ? {
+      abortSignal: hooks.abortSignal
+    } : {},
     // Replaced per tool call by the call's own collector (see the tool step); this one only serves
     // what runs outside a call — the elicitation wait.
     emitUi: createNoopEmitUi(hooks.runId)
@@ -7173,26 +7653,46 @@ ${block}`;
           writer
         }) : void 0;
         const buffer = gateMode === "whole" ? createFrameBuffer() : void 0;
-        const frames = observeTurnFrames(incremental?.writer ?? buffer?.writer ?? writer);
-        const result2 = stampToolKinds(withTurnFrames(await traceLlmTurn(hooks.runId, i, () => deps.model.runTurn({
+        const previews = previewToolInputs(incremental?.writer ?? buffer?.writer ?? writer, registryInputPreviews(deps.registry, tools, {
+          actor: input.actor,
+          threadId: input.threadId,
+          ...input.agentName !== void 0 ? {
+            agentName: input.agentName
+          } : {},
+          ...input.uiCapabilities !== void 0 ? {
+            uiCapabilities: input.uiCapabilities
+          } : {}
+        }));
+        const frames = observeTurnFrames(previews.writer);
+        const result2 = stampToolKinds(withTurnFrames(await traceLlmTurn(hooks.runId, i, () => abortableModelCall(hooks, (signal) => deps.model.runTurn({
           system: prompt.system,
           messages: prompt.messages,
           tools,
-          sink: frames.writer
-        })), frames.summary()), deps);
+          sink: frames.writer,
+          ...signal
+        }))), frames.summary()), deps);
+        const shownPreviews = previews.shown();
+        const previewed = shownPreviews.length > 0 ? {
+          previews: shownPreviews
+        } : {};
         if (incremental !== void 0) {
           await incremental.settled();
           const refusal = incremental.rejection();
           return {
             ...result2,
+            ...previewed,
             releasedText: incremental.released(),
             ...refusal !== void 0 ? {
               gateRejection: refusal
             } : {}
           };
         }
-        return buffer === void 0 ? result2 : {
+        return buffer === void 0 ? {
+          ...result2,
+          ...previewed
+        } : {
           ...result2,
+          ...previewed,
           bufferedFrames: buffer.frames()
         };
       });
@@ -7511,6 +8011,12 @@ ${block}`;
       if (toolUi.length > 0) {
         await deps.store.setMessageUi?.(assistant.id, mergeUi(turn.ui, toolUi));
       }
+      for (const preview of turn.previews ?? []) {
+        const pushed = turnCalls.toolUi.get(preview.toolCallId) ?? [];
+        if (!pushed.some((component) => component.id === preview.id)) {
+          await writer.write(encodeStreamEvent(withdrawPreviewEvent(preview)));
+        }
+      }
       for (const result2 of results) {
         await writer.write(encodeStreamEvent(outputFrame(result2)));
       }
@@ -7592,6 +8098,98 @@ ${toolText}`;
 }
 __name(runAgentLoop, "runAgentLoop");
 
+// src/action-proposal-tool-call.ts
+function toolCallUpdateForProposal(proposal) {
+  const audit = proposal.decisionAudit;
+  const toolCallId = proposal.originToolCallId;
+  const decidedBy = {
+    ...audit?.actorRef !== void 0 ? {
+      executedByRef: audit.actorRef
+    } : {},
+    ...audit?.via !== void 0 ? {
+      decidedVia: audit.via
+    } : {}
+  };
+  switch (proposal.decision) {
+    case "rejected":
+      return {
+        toolCallId,
+        status: "rejected",
+        ...decidedBy,
+        ...audit?.reason !== void 0 ? {
+          error: storableText2(audit.reason)
+        } : {}
+      };
+    case "expired":
+      return {
+        toolCallId,
+        status: "expired",
+        ...audit?.via !== void 0 ? {
+          decidedVia: audit.via
+        } : {}
+      };
+    case "superseded":
+      return {
+        toolCallId,
+        status: "expired",
+        decidedVia: audit?.via ?? "supersession",
+        error: proposal.supersededBy !== void 0 ? `superseded by proposal ${proposal.supersededBy}` : "superseded by a newer proposal"
+      };
+    case "approved": {
+      const execution = proposal.execution;
+      const remember = audit?.remember !== void 0 ? {
+        remember: audit.remember
+      } : {};
+      if (execution?.status === "succeeded") {
+        return {
+          toolCallId,
+          status: "executed",
+          ...storableOutput(execution.result) ? {
+            output: execution.result
+          } : {},
+          ...decidedBy,
+          ...remember
+        };
+      }
+      if (execution?.status === "failed") {
+        return {
+          toolCallId,
+          status: "failed",
+          error: storableText2(execution.error ?? "the approved action failed"),
+          ...decidedBy,
+          ...remember
+        };
+      }
+      return null;
+    }
+    default:
+      return null;
+  }
+}
+__name(toolCallUpdateForProposal, "toolCallUpdateForProposal");
+function toolCallUpdateForTransition(previous, next) {
+  const update = toolCallUpdateForProposal(next);
+  if (update === null) return null;
+  const before = previous === void 0 ? null : toolCallUpdateForProposal(previous);
+  return before?.status === update.status ? null : update;
+}
+__name(toolCallUpdateForTransition, "toolCallUpdateForTransition");
+function storableOutput(result2) {
+  if (result2 === void 0) return false;
+  let json;
+  try {
+    json = JSON.stringify(result2);
+  } catch {
+    return false;
+  }
+  return json !== void 0 && !/\\u0000|\\ud[89ab][0-9a-f]{2}(?!\\ud[c-f])|(?<!\\ud[89ab][0-9a-f]{2})\\ud[c-f][0-9a-f]{2}/i.test(json);
+}
+__name(storableOutput, "storableOutput");
+function storableText2(text) {
+  return text.replaceAll("\0", "");
+}
+__name(storableText2, "storableText");
+
 // src/in-memory-action-proposal-store.ts
 var import_node_crypto2 = require("crypto");
 var InMemoryActionProposalStore = class {
@@ -7638,9 +8236,19 @@ var InMemoryActionProposalStore = class {
       status: "not_found"
     };
     const result2 = transition(row2, this.clock());
-    if (result2.proposal) this.rows.set(id, snapshotActionProposal(result2.proposal));
+    if (result2.proposal) {
+      this.rows.set(id, snapshotActionProposal(result2.proposal));
+      this.proposalChanged(row2, result2.proposal);
+    }
     return result2;
   }
+  /**
+  * Called after every proposal transition, with the row before and after — synchronously, so no
+  * reader sees one without the other. {@link InMemoryAgentStore} settles the proposal's tool-call
+  * record here (see `toolCallUpdateForTransition`).
+  */
+  proposalChanged(_previous, _next) {
+  }
   async decideActionProposal(scope, id, command) {
     return this.mutate(scope, id, (row2, now) => transitionActionProposalDecision(row2, command, now));
   }
@@ -7721,7 +8329,11 @@ var InMemoryActionProposalStore = class {
       if (result2.proposal) replacements.push(result2.proposal);
     }
     this.rows.set(proposal.id, proposal);
-    for (const row2 of replacements) this.rows.set(row2.id, row2);
+    for (const row2 of replacements) {
+      const previous = this.rows.get(row2.id);
+      this.rows.set(row2.id, row2);
+      if (previous) this.proposalChanged(previous, row2);
+    }
     return {
       status: "created",
       proposal: snapshotActionProposal(proposal)
@@ -8442,6 +9054,15 @@ var InMemoryAgentStore = class extends InMemoryActionProposalStore {
     return settled;
   }
   async updateToolCall(input) {
+    this.applyToolCallUpdate(input);
+  }
+  /** An independent proposal moved: its `proposed` tool-call record follows it. */
+  proposalChanged(previous, next) {
+    const update = toolCallUpdateForTransition(previous, next);
+    if (update === null || this.toolCalls.get(update.toolCallId)?.proposalId !== next.id) return;
+    this.applyToolCallUpdate(update);
+  }
+  applyToolCallUpdate(input) {
     const row2 = this.toolCalls.get(input.toolCallId);
     if (row2 === void 0) {
       return;
@@ -9796,6 +10417,7 @@ __name(createFunctionalTool, "createFunctionalTool");
   DEFAULT_MAX_FACT_CHARS,
   DEFAULT_MAX_MEMORIES,
   DEFAULT_MAX_SKILLS,
+  DEFAULT_PREVIEW_THROTTLE_MS,
   DEFAULT_REFUSAL_REASON,
   DEFAULT_STRUCTURED_OUTPUT_INSTRUCTION,
   DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES,
@@ -9914,9 +10536,12 @@ __name(createFunctionalTool, "createFunctionalTool");
   observeTurnFrames,
   offerMemories,
   offerSkills,
+  parsePartialJson,
   parseTextActionProposalCommand,
   personaCatalogEntry,
   prepareActionProposal,
+  previewToolInputs,
+  previewUiId,
   ptBrActionProposalText,
   publishAgentDelegated,
   publishAgentMemoryResolved,
@@ -9937,6 +10562,7 @@ __name(createFunctionalTool, "createFunctionalTool");
   quotaWarning,
   readElicitationInput,
   readElicitationQuestions,
+  registryInputPreviews,
   releaseGatedFrames,
   releaseThreadRun,
   rememberInputSchema,
@@ -9979,6 +10605,8 @@ __name(createFunctionalTool, "createFunctionalTool");
   toActionProposalView,
   toolCallApprovalFromRow,
   toolCallContext,
+  toolCallUpdateForProposal,
+  toolCallUpdateForTransition,
   traceLlmTurn,
   traceToolExecution,
   transitionActionProposalClaim,
@@ -10005,6 +10633,7 @@ __name(createFunctionalTool, "createFunctionalTool");
   withSkillTool,
   withToolTimeout,
   withTurnFrames,
+  withdrawPreviewEvent,
   wrapToolPreflightDenied,
   wrapToolStepOutput,
   writeMemory