@stigmer/react 3.0.9-dev.20260616060535 → 3.1.0

package/execution/tool-categories.d.ts

@@ -10,6 +10,44 @@ import { ToolKind } from "@stigmer/sdk";
  * MCP server, whose names are dynamic.
  */
 export type ToolCategory = "shell" | "read" | "write" | "edit" | "delete" | "search" | "list" | "fetch" | "web-search" | "think" | "sub-agent" | "internal" | "mcp" | "unknown";
+/**
+ * How much of a settled tool call to reveal inline by default in the thread.
+ *
+ * - `"summary"` — a compact one-line row. Used when the label + primary arg +
+ *   result summary already tell the story (`Read foo.ts`, `Edit bar.ts +40 -0`,
+ *   `Search … 2 matches`). The full detail is one click away.
+ * - `"preview"` — the row renders its result body **always** (no card chevron),
+ *   because the one-liner cannot convey what happened so the content itself IS
+ *   the information (a shell command's output, an MCP result such as a
+ *   screenshot, a fetched page, a web-search answer, or an unrecognised tool's
+ *   output). The body's own in-place reveal expands it beyond the height budget.
+ *
+ * This is the *disclosure* axis (how much of a result to show); it is
+ * orthogonal to {@link isRunGroupableCategory} (whether consecutive same-kind
+ * calls fold into one chip). A category can be result-rich but never folded
+ * (`shell`), or foldable but never previewed (`read`).
+ */
+export type ToolDisclosure = "summary" | "preview";
+/**
+ * Returns the default inline {@link ToolDisclosure} for a presentation
+ * category. This is the headless policy behind the thread's "keep a live
+ * preview for shell/MCP/unknown, keep generic tools compact" behaviour;
+ * consumers can override per {@link ToolKind} via {@link registerToolPresenter}.
+ */
+export declare function defaultDisclosureForCategory(category: ToolCategory): ToolDisclosure;
+/**
+ * Returns whether a presentation category participates in run-grouping — i.e.
+ * whether a maximal run of consecutive calls of this category folds into one
+ * collapsible chip. See {@link RUN_GROUPABLE_CATEGORIES} and `segmentToolCalls`.
+ */
+export declare function isRunGroupableCategory(category: ToolCategory): boolean;
+/**
+ * Returns whether a category's primary argument is a file path — the file
+ * tools (read / write / edit / delete). These render their path filename-first
+ * via {@link FilePathLink} (full path on hover) in headers and previews, rather
+ * than as a raw, often-absolute string.
+ */
+export declare function isFileCategory(category: ToolCategory): boolean;
 /** Resolved display metadata for a tool call, returned by {@link resolveToolCategory}. */
 export interface ToolCategoryInfo {
     /** Semantic category of the tool. */
@@ -26,6 +64,22 @@ export interface ToolCategoryInfo {
  * appear in the message thread (todos are rendered through a dedicated surface).
  */
 export declare function isInternalTool(toolName: string): boolean;
+/**
+ * Returns true for a tool call the runner collapsed in place — a superseded
+ * same-turn duplicate of an approval gate.
+ *
+ * When the agent emits one resource twice in a turn and both attempts are denied,
+ * the runner overlays the FIRST as the WAITING_APPROVAL gate and blanks the
+ * redundant twin to a content-less SKIPPED row (it cannot drop it — the backend's
+ * append-only-at-identity guard forbids removing a committed tool-call id). This
+ * predicate recognizes that blanked twin so the thread renders one card, not two.
+ *
+ * The signature is precise: a SKIPPED row with no approval flag, no result, no
+ * error, and no args preview. A genuinely user-skipped tool always retains the
+ * preview/args the user reviewed before skipping, so it is never blank and is
+ * never hidden by this.
+ */
+export declare function isCollapsedToolCall(toolCall: ToolCall): boolean;
 /** Maps a {@link ToolKind} to its presentation metadata. */
 export declare function toolKindToCategoryInfo(kind: ToolKind, toolName: string): ToolCategoryInfo;
 /**
@@ -70,8 +124,15 @@ export declare function extractPrimaryArg(toolCall: ToolCall): string | null;
  * Extracts the primary argument value from a JSON string
  * (typically `PendingApproval.argsPreview`). Returns `null` if
  * parsing fails or the expected field is not found.
+ *
+ * When the caller has the denormalized wire `tool_kind` (as `PendingApproval`
+ * does), pass it so resolution honors the same kind that drives the label/icon —
+ * a file tool whose NAME the classifier doesn't recognize still resolves to its
+ * `path` field. This mirrors {@link extractPrimaryArg}, which uses the wire kind
+ * via `resolveToolCategoryFromCall`. Falls back to name-based resolution when
+ * the kind is unset (legacy executions).
  */
-export declare function extractPrimaryArgFromPreview(toolName: string, argsPreview: string, mcpServerSlug?: string): string | null;
+export declare function extractPrimaryArgFromPreview(toolName: string, argsPreview: string, mcpServerSlug?: string, toolKind?: ToolKind): string | null;
 /**
  * Extracts the file content body from a JSON `argsPreview` string
  * for write/edit tool categories. Scans the same field names used

package/execution/tool-categories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-categories.d.ts","sourceRoot":"","sources":["../../src/execution/tool-categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iEAAiE,CAAC;AAEhG,OAAO,EAAE,QAAQ,EAA0C,MAAM,cAAc,CAAC;AAEhF;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,OAAO,GACP,YAAY,GACZ,OAAO,GACP,WAAW,GACX,UAAU,GACV,KAAK,GACL,SAAS,CAAC;AAEd,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+FAA+F;IAC/F,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,mEAAmE;IACnE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AA2BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,GACf,gBAAgB,CA0BlB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,CAKlB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,CAMlB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUrD;AA4BD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAmBnE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CAgBf;AAWD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAef"}
+{"version":3,"file":"tool-categories.d.ts","sourceRoot":"","sources":["../../src/execution/tool-categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iEAAiE,CAAC;AAGhG,OAAO,EAAE,QAAQ,EAA0C,MAAM,cAAc,CAAC;AAEhF;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,OAAO,GACP,YAAY,GACZ,OAAO,GACP,WAAW,GACX,UAAU,GACV,KAAK,GACL,SAAS,CAAC;AAEd;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAqCnD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,YAAY,GACrB,cAAc,CAEhB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAO9D;AAED,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+FAA+F;IAC/F,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,mEAAmE;IACnE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AA2BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAQ/D;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,GACf,gBAAgB,CA0BlB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,CAKlB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,CAMlB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUrD;AA4BD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAmBnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,QAAQ,GAClB,MAAM,GAAG,IAAI,CAmBf;AAWD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAef"}

package/execution/tool-categories.js

@@ -1,4 +1,67 @@
+import { ToolCallStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 import { ToolKind, resolveToolKind, resolveToolKindByName } from "@stigmer/sdk";
+/**
+ * Categories whose result is foregrounded as a persistent bounded preview by
+ * default — those for which the compact one-liner cannot convey what happened,
+ * so the output itself carries the meaning. All other categories default to
+ * `"summary"`.
+ *
+ * File edits and writes are previewed: a `+N -M` summary says how much changed
+ * but not *what* — and the change is the decision-relevant content. Surfacing a
+ * bounded diff inline (Cursor-style) is the point of a code agent. The body is
+ * height-clamped with a single in-place reveal for the rest, so density stays
+ * under control even in turns with many edits.
+ */
+const PREVIEW_CATEGORIES = new Set([
+    "shell",
+    "edit",
+    "write",
+    "mcp",
+    "web-search",
+    "fetch",
+    "unknown",
+]);
+/**
+ * Low-signal categories whose consecutive runs fold into a single collapsible
+ * "Read 5 files" chip in the thread. These are the read-only, repetitive
+ * operations whose individual rows are noise in bulk; everything else renders
+ * as a persistent row. This is the *run-grouping* axis, orthogonal to
+ * {@link ToolDisclosure} — see {@link isRunGroupableCategory}.
+ */
+const RUN_GROUPABLE_CATEGORIES = new Set([
+    "read",
+    "list",
+    "search",
+]);
+/**
+ * Returns the default inline {@link ToolDisclosure} for a presentation
+ * category. This is the headless policy behind the thread's "keep a live
+ * preview for shell/MCP/unknown, keep generic tools compact" behaviour;
+ * consumers can override per {@link ToolKind} via {@link registerToolPresenter}.
+ */
+export function defaultDisclosureForCategory(category) {
+    return PREVIEW_CATEGORIES.has(category) ? "preview" : "summary";
+}
+/**
+ * Returns whether a presentation category participates in run-grouping — i.e.
+ * whether a maximal run of consecutive calls of this category folds into one
+ * collapsible chip. See {@link RUN_GROUPABLE_CATEGORIES} and `segmentToolCalls`.
+ */
+export function isRunGroupableCategory(category) {
+    return RUN_GROUPABLE_CATEGORIES.has(category);
+}
+/**
+ * Returns whether a category's primary argument is a file path — the file
+ * tools (read / write / edit / delete). These render their path filename-first
+ * via {@link FilePathLink} (full path on hover) in headers and previews, rather
+ * than as a raw, often-absolute string.
+ */
+export function isFileCategory(category) {
+    return (category === "read" ||
+        category === "write" ||
+        category === "edit" ||
+        category === "delete");
+}
 // Presentation metadata per ToolKind. Classification (name -> kind) is owned by
 // @stigmer/sdk; this table only describes how each kind is shown. MCP and
 // unknown are resolved dynamically (label derived from the tool name).
@@ -23,6 +86,28 @@ const KIND_DISPLAY = {
 export function isInternalTool(toolName) {
     return resolveToolKindByName(toolName) === ToolKind.TODO;
 }
+/**
+ * Returns true for a tool call the runner collapsed in place — a superseded
+ * same-turn duplicate of an approval gate.
+ *
+ * When the agent emits one resource twice in a turn and both attempts are denied,
+ * the runner overlays the FIRST as the WAITING_APPROVAL gate and blanks the
+ * redundant twin to a content-less SKIPPED row (it cannot drop it — the backend's
+ * append-only-at-identity guard forbids removing a committed tool-call id). This
+ * predicate recognizes that blanked twin so the thread renders one card, not two.
+ *
+ * The signature is precise: a SKIPPED row with no approval flag, no result, no
+ * error, and no args preview. A genuinely user-skipped tool always retains the
+ * preview/args the user reviewed before skipping, so it is never blank and is
+ * never hidden by this.
+ */
+export function isCollapsedToolCall(toolCall) {
+    return (toolCall.status === ToolCallStatus.TOOL_CALL_SKIPPED &&
+        !toolCall.requiresApproval &&
+        !toolCall.result &&
+        !toolCall.error &&
+        !toolCall.argsPreview);
+}
 /** Maps a {@link ToolKind} to its presentation metadata. */
 export function toolKindToCategoryInfo(kind, toolName) {
     const entry = KIND_DISPLAY[kind];
@@ -145,15 +230,24 @@ export function extractPrimaryArg(toolCall) {
  * Extracts the primary argument value from a JSON string
  * (typically `PendingApproval.argsPreview`). Returns `null` if
  * parsing fails or the expected field is not found.
+ *
+ * When the caller has the denormalized wire `tool_kind` (as `PendingApproval`
+ * does), pass it so resolution honors the same kind that drives the label/icon —
+ * a file tool whose NAME the classifier doesn't recognize still resolves to its
+ * `path` field. This mirrors {@link extractPrimaryArg}, which uses the wire kind
+ * via `resolveToolCategoryFromCall`. Falls back to name-based resolution when
+ * the kind is unset (legacy executions).
  */
-export function extractPrimaryArgFromPreview(toolName, argsPreview, mcpServerSlug) {
+export function extractPrimaryArgFromPreview(toolName, argsPreview, mcpServerSlug, toolKind) {
     if (!argsPreview)
         return null;
     try {
         const parsed = JSON.parse(argsPreview);
         if (typeof parsed !== "object" || parsed === null)
             return null;
-        const info = resolveToolCategory(toolName, mcpServerSlug);
+        const info = toolKind !== undefined
+            ? resolveToolCategoryFromKind(toolKind, toolName, mcpServerSlug)
+            : resolveToolCategory(toolName, mcpServerSlug);
         return extractArgValue(parsed, info.primaryArgField, info.fallbackArgFields);
     }
     catch {

package/execution/tool-categories.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-categories.js","sourceRoot":"","sources":["../../src/execution/tool-categories.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AA8ChF,gFAAgF;AAChF,0EAA0E;AAC1E,uEAAuE;AACvE,MAAM,YAAY,GAAgD;IAChE,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAI,EAAE,QAAQ,EAAE,MAAM,EAAO,KAAK,EAAE,MAAM,EAAO,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE;IAClI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAG,EAAE,QAAQ,EAAE,OAAO,EAAM,KAAK,EAAE,OAAO,EAAM,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;IAC9I,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAI,EAAE,QAAQ,EAAE,MAAM,EAAO,KAAK,EAAE,MAAM,EAAO,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;IAC9I,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAK,KAAK,EAAE,QAAQ,EAAK,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;IAC9I,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAQ,EAAE,QAAQ,EAAE,OAAO,EAAM,KAAK,EAAE,OAAO,EAAM,YAAY,EAAE,SAAS,EAAE;IAC9F,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAO,EAAE,QAAQ,EAAE,QAAQ,EAAK,KAAK,EAAE,QAAQ,EAAK,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE;IAC9H,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAS,EAAE,QAAQ,EAAE,MAAM,EAAO,KAAK,EAAE,MAAM,EAAO,YAAY,EAAE,MAAM,EAAE;IAC3F,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAQ,EAAE,QAAQ,EAAE,OAAO,EAAM,KAAK,EAAE,OAAO,EAAM,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,KAAK,CAAC,EAAE;IACnH,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE;IACpI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAQ,EAAE,QAAQ,EAAE,OAAO,EAAM,KAAK,EAAE,UAAU,EAAG,YAAY,EAAE,SAAS,EAAE;IAC9F,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC9H,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAS,EAAE,QAAQ,EAAE,UAAU,EAAG,KAAK,EAAE,OAAO,EAAM,YAAY,EAAE,OAAO,EAAE;CAC7F,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,qBAAqB,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,sBAAsB,CACpC,IAAc,EACd,QAAgB;IAEhB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,eAAe,EAAE,KAAK,CAAC,YAAY;YACnC,iBAAiB,EAAE,KAAK,CAAC,cAAc,IAAI,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC1B,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC;YACjC,eAAe,EAAE,MAAM;YACvB,iBAAiB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC;QACjC,eAAe,EAAE,EAAE;QACnB,iBAAiB,EAAE,EAAE;KACtB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,aAAsB;IAEtB,OAAO,sBAAsB,CAC3B,qBAAqB,CAAC,QAAQ,EAAE,aAAa,CAAC,EAC9C,QAAQ,CACT,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAkB;IAC5D,OAAO,sBAAsB,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAAkB,EAClB,QAAgB,EAChB,aAAsB;IAEtB,MAAM,IAAI,GACR,QAAQ,KAAK,QAAQ,CAAC,WAAW;QAC/B,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,qBAAqB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACrD,OAAO,sBAAsB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3C,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC;SAC3B,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC;SACzB,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC;SAC3B,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,eAAe,CACtB,IAA4B,EAC5B,OAAe,EACf,SAA4B;IAE5B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAiB,EAAE;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvB,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,MAAM,IAAI,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,eAAe,CAC5B,QAAQ,CAAC,IAAI,EACb,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,iBAAiB,CACvB,CAAC;IAEF,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC9E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACnC,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,GAAG,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAgB,EAChB,WAAmB,EACnB,aAAsB;IAEtB,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACvC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAE/D,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC1D,OAAO,eAAe,CACpB,MAAoB,EACpB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,iBAAiB,CACvB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,oBAAoB,GAAG;IAC3B,UAAU;IACV,SAAS;IACT,cAAc;IACd,UAAU;IACV,YAAY;IACZ,aAAa;CACL,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,UAAU,8BAA8B,CAC5C,WAAmB;IAEnB,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACvC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAE/D,KAAK,MAAM,KAAK,IAAI,oBAAoB,EAAE,CAAC;YACzC,MAAM,GAAG,GAAI,MAAkC,CAAC,KAAK,CAAC,CAAC;YACvD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAC;QAC5D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"tool-categories.js","sourceRoot":"","sources":["../../src/execution/tool-categories.ts"],"names":[],"mappings":"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"}

package/execution/tool-presenter.d.ts

@@ -1,13 +1,26 @@
 import type { ToolCall } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
 import { ToolKind } from "@stigmer/sdk";
 import type { ToolResultView } from "@stigmer/sdk";
-import type { ToolCategory } from "./tool-categories";
-/** Optional per-kind overrides for label and summary. */
+import type { ToolCategory, ToolDisclosure } from "./tool-categories";
+/** Optional per-kind overrides for label, summary, disclosure, and run-grouping. */
 export interface ToolPresenter {
     /** Overrides the display label (e.g. "Shell" -> "Run command"). */
     readonly label?: (toolCall: ToolCall) => string;
     /** Overrides the one-line result summary suffix. */
     readonly summary?: (toolCall: ToolCall, result: ToolResultView) => string | null;
+    /**
+     * Overrides the default inline disclosure. Use to keep a noisy MCP tool
+     * compact (`() => "summary"`) or to foreground a custom tool's output
+     * (`() => "preview"`) without forking the components.
+     */
+    readonly disclosure?: (toolCall: ToolCall, result: ToolResultView) => ToolDisclosure;
+    /**
+     * Overrides whether consecutive same-kind calls fold into one collapsible
+     * "Read 5 files" chip. Use to fold a chatty custom tool (`() => true`) or to
+     * keep a normally-folded category as standalone rows (`() => false`) without
+     * forking the thread layout. Defaults to {@link isRunGroupableCategory}.
+     */
+    readonly runGroupable?: (toolCall: ToolCall) => boolean;
 }
 /**
  * Registers a custom presenter for a {@link ToolKind}, overriding the default
@@ -34,6 +47,16 @@ export interface ToolPresenter {
 export declare function registerToolPresenter(kind: ToolKind, presenter: ToolPresenter): () => void;
 /** Returns the registered presenter for a kind, if any. */
 export declare function getToolPresenter(kind: ToolKind): ToolPresenter | undefined;
+/**
+ * Resolves whether a tool call participates in run-grouping, honouring a
+ * registered {@link ToolPresenter.runGroupable} override before the
+ * category default ({@link isRunGroupableCategory}).
+ *
+ * This is the non-hook twin of the `runGroupable` field in
+ * {@link useToolPresentation}, so the pure `segmentToolCalls` layout pass and
+ * the component layer share one source of truth (and honour the same override).
+ */
+export declare function resolveRunGroupable(toolCall: ToolCall): boolean;
 /** The fully-resolved presentation for a tool call, returned by {@link useToolPresentation}. */
 export interface ToolPresentation {
     /** Harness-agnostic kind (wire field, with name fallback). */
@@ -48,6 +71,19 @@ export interface ToolPresentation {
     readonly result: ToolResultView;
     /** One-line result summary suffix for the collapsed row (e.g. "+40 -0"). */
     readonly resultSummary: string | null;
+    /**
+     * Default inline disclosure for this tool — `"preview"` keeps a bounded,
+     * persistent preview of the result, `"summary"` keeps a compact row. The
+     * active/awaiting state can still force a row open; this is the *settled*
+     * default.
+     */
+    readonly disclosure: ToolDisclosure;
+    /**
+     * Whether consecutive same-kind calls fold into one collapsible chip — the
+     * run-grouping axis, orthogonal to {@link disclosure}. See
+     * {@link isRunGroupableCategory}.
+     */
+    readonly runGroupable: boolean;
 }
 /**
  * Resolves the complete, render-ready presentation for a tool call.

package/execution/tool-presenter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-presenter.d.ts","sourceRoot":"","sources":["../../src/execution/tool-presenter.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iEAAiE,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAwC,MAAM,cAAc,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC;IAChD,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,KAAK,MAAM,GAAG,IAAI,CAAC;CAClF;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,aAAa,GACvB,MAAM,IAAI,CAUZ;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,CAE1E;AAED,gGAAgG;AAChG,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,CAoBxE"}
+{"version":3,"file":"tool-presenter.d.ts","sourceRoot":"","sources":["../../src/execution/tool-presenter.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iEAAiE,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAwC,MAAM,cAAc,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAOnD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGtE,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC;IAChD,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,KAAK,MAAM,GAAG,IAAI,CAAC;IACjF;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,KAAK,cAAc,CAAC;IACrF;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC;CACzD;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,aAAa,GACvB,MAAM,IAAI,CAUZ;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,CAE1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAK/D;AAED,gGAAgG;AAChG,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,CA4BxE"}

package/execution/tool-presenter.js

@@ -12,7 +12,7 @@
 // presentation seam.
 import { useMemo } from "react";
 import { resolveToolKind, normalizeToolResult } from "@stigmer/sdk";
-import { resolveToolCategoryFromCall, extractPrimaryArg } from "./tool-categories";
+import { resolveToolCategoryFromCall, extractPrimaryArg, defaultDisclosureForCategory, isRunGroupableCategory, } from "./tool-categories";
 import { summarizeResultView } from "./ResultView";
 const registry = new Map();
 /**
@@ -53,6 +53,22 @@ export function registerToolPresenter(kind, presenter) {
 export function getToolPresenter(kind) {
     return registry.get(kind);
 }
+/**
+ * Resolves whether a tool call participates in run-grouping, honouring a
+ * registered {@link ToolPresenter.runGroupable} override before the
+ * category default ({@link isRunGroupableCategory}).
+ *
+ * This is the non-hook twin of the `runGroupable` field in
+ * {@link useToolPresentation}, so the pure `segmentToolCalls` layout pass and
+ * the component layer share one source of truth (and honour the same override).
+ */
+export function resolveRunGroupable(toolCall) {
+    const kind = resolveToolKind(toolCall);
+    const override = registry.get(kind)?.runGroupable;
+    if (override)
+        return override(toolCall);
+    return isRunGroupableCategory(resolveToolCategoryFromCall(toolCall).category);
+}
 /**
  * Resolves the complete, render-ready presentation for a tool call.
  *
@@ -68,6 +84,10 @@ export function useToolPresentation(toolCall) {
         const override = registry.get(kind);
         const label = override?.label?.(toolCall) ?? categoryInfo.label;
         const resultSummary = override?.summary?.(toolCall, result) ?? summarizeResultView(result);
+        const disclosure = override?.disclosure?.(toolCall, result) ??
+            defaultDisclosureForCategory(categoryInfo.category);
+        const runGroupable = override?.runGroupable?.(toolCall) ??
+            isRunGroupableCategory(categoryInfo.category);
         return {
             kind,
             category: categoryInfo.category,
@@ -75,6 +95,8 @@ export function useToolPresentation(toolCall) {
             primaryArg: extractPrimaryArg(toolCall),
             result,
             resultSummary,
+            disclosure,
+            runGroupable,
         };
     }, [toolCall]);
 }

package/execution/tool-presenter.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-presenter.js","sourceRoot":"","sources":["../../src/execution/tool-presenter.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,2EAA2E;AAC3E,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,iFAAiF;AACjF,qBAAqB;AAErB,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAY,eAAe,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE9E,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAUnD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAc,EACd,SAAwB;IAExB,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC9B,OAAO,GAAG,EAAE;QACV,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAkBD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAkB;IACpD,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,YAAY,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEpC,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC;QAChE,MAAM,aAAa,GACjB,QAAQ,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAEvE,OAAO;YACL,IAAI;YACJ,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC/B,KAAK;YACL,UAAU,EAAE,iBAAiB,CAAC,QAAQ,CAAC;YACvC,MAAM;YACN,aAAa;SACd,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjB,CAAC"}
+{"version":3,"file":"tool-presenter.js","sourceRoot":"","sources":["../../src/execution/tool-presenter.ts"],"names":[],"mappings":"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"}

package/execution/tool-rendering-primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-rendering-primitives.d.ts","sourceRoot":"","sources":["../../src/execution/tool-rendering-primitives.tsx"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAMxC,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,oBAAoB,2CA2BlF;AAMD,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,mBAAmB,2CA0BzE;AAMD,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,yBAAyB,2CA2CjF;AAMD,0DAA0D;AAC1D,wBAAgB,YAAY,4CAkB3B;AAED,yCAAyC;AACzC,wBAAgB,aAAa,4CAqB5B;AAMD,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAM/C;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO,CAG3E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKlD"}
+{"version":3,"file":"tool-rendering-primitives.d.ts","sourceRoot":"","sources":["../../src/execution/tool-rendering-primitives.tsx"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAMxC,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,oBAAoB,2CAyBlF;AAMD,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,mBAAmB,2CAwBzE;AAMD,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,yBAAyB,2CA2CjF;AAMD,0DAA0D;AAC1D,wBAAgB,YAAY,4CAkB3B;AAED,yCAAyC;AACzC,wBAAgB,aAAa,4CAqB5B;AAMD,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAM/C;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO,CAG3E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKlD"}

package/execution/tool-rendering-primitives.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useState } from "react";
 import { cn } from "@stigmer/theme";
+import { RevealToggle } from "../internal/RevealToggle";
 /**
  * Shared truncation threshold for all collapsible tool rendering
  * primitives. Applied consistently across detail views and approval
@@ -22,7 +23,7 @@ export function CollapsibleCode({ label, content, className }) {
     const displayContent = needsTruncation && !isExpanded
         ? lines.slice(0, TRUNCATION_LINE_LIMIT).join("\n") + "\n\u2026"
         : content;
-    return (_jsxs("div", { className: cn("space-y-1", className), children: [_jsx("span", { className: "font-medium text-muted-foreground", children: label }), _jsx("pre", { className: "max-h-80 overflow-auto whitespace-pre-wrap break-words rounded-md border border-border bg-muted-subtle p-2 font-mono text-foreground", children: displayContent }), needsTruncation && (_jsx("button", { type: "button", onClick: () => setIsExpanded((v) => !v), className: "text-xs font-medium text-primary transition-colors hover:text-primary-muted", children: isExpanded ? "Show less" : `Show all ${lines.length} lines` }))] }));
+    return (_jsxs("div", { className: cn("space-y-1", className), children: [_jsx("span", { className: "font-medium text-muted-foreground", children: label }), _jsx("pre", { className: "max-h-80 overflow-auto whitespace-pre-wrap break-words rounded-md border border-border bg-muted-subtle p-2 font-mono text-foreground", children: displayContent }), needsTruncation && (_jsx(RevealToggle, { expanded: isExpanded, onToggle: () => setIsExpanded((v) => !v), moreLabel: `Show all ${lines.length} lines` }))] }));
 }
 /**
  * A bare `<pre>` element with line-based truncation. Unlike
@@ -40,7 +41,7 @@ export function CollapsiblePre({ content, className }) {
     const displayContent = needsTruncation && !isExpanded
         ? lines.slice(0, TRUNCATION_LINE_LIMIT).join("\n") + "\n\u2026"
         : content;
-    return (_jsxs(_Fragment, { children: [_jsx("pre", { className: cn("whitespace-pre-wrap break-words font-mono", className), children: displayContent }), needsTruncation && (_jsx("button", { type: "button", onClick: () => setIsExpanded((v) => !v), className: "mt-1 text-xs font-medium text-primary transition-colors hover:text-primary-muted", children: isExpanded ? "Show less" : `Show all ${lines.length} lines` }))] }));
+    return (_jsxs(_Fragment, { children: [_jsx("pre", { className: cn("whitespace-pre-wrap break-words font-mono", className), children: displayContent }), needsTruncation && (_jsx(RevealToggle, { expanded: isExpanded, onToggle: () => setIsExpanded((v) => !v), moreLabel: `Show all ${lines.length} lines` }))] }));
 }
 /**
  * A collapsible JSON section with a chevron toggle. Initially

package/execution/tool-rendering-primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-rendering-primitives.js","sourceRoot":"","sources":["../../src/execution/tool-rendering-primitives.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-rendering-primitives.js","sourceRoot":"","sources":["../../src/execution/tool-rendering-primitives.tsx"],"names":[],"mappings":"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"}

package/execution/useArtifactDownload.d.ts

@@ -0,0 +1,44 @@
+/** Return value of {@link useArtifactDownload}. */
+export interface UseArtifactDownloadReturn {
+    /**
+     * Mint a fresh presigned URL for `storageKey` and trigger a browser
+     * download. No-op when the execution id is unknown or a download is already
+     * in flight. Resolves once the download has been initiated.
+     *
+     * @param storageKey - Storage key of the artifact to download.
+     * @param fileName - Optional suggested file name for the saved file.
+     */
+    readonly download: (storageKey: string, fileName?: string) => Promise<void>;
+    /** `true` while a URL is being minted / the download is being initiated. */
+    readonly isDownloading: boolean;
+    /** Error from the last failed download attempt, or `null` when healthy. */
+    readonly error: Error | null;
+}
+/**
+ * Behavior hook that downloads an execution artifact on demand.
+ *
+ * Mirrors the click → mint fresh URL → browser download flow established by
+ * `WorkflowExecutionArtifactPanel`, generalized so every artifact "Download"
+ * affordance shares one implementation. The URL is minted at click time from
+ * the stable `storageKey` via `getArtifactDownloadUrl`, so it is always valid —
+ * unlike the previously persisted, short-lived URL that expired after an hour.
+ *
+ * Returns an imperative `download(storageKey, fileName?)` action rather than a
+ * URL, because a download is a user action, not render data. For rendering an
+ * image or showing a link, use {@link useArtifactDownloadUrl} instead.
+ *
+ * @param executionId - Execution that produced the artifacts, or `null` to
+ *   disable (the action becomes a no-op).
+ *
+ * @example
+ * ```tsx
+ * const { download, isDownloading } = useArtifactDownload(executionId);
+ * <button onClick={() => download(artifact.storageKey, artifact.name)} disabled={isDownloading}>
+ *   Download
+ * </button>
+ * ```
+ *
+ * @see useArtifactDownloadUrl — declarative URL resolver (image src, links)
+ */
+export declare function useArtifactDownload(executionId: string | null): UseArtifactDownloadReturn;
+//# sourceMappingURL=useArtifactDownload.d.ts.map

package/execution/useArtifactDownload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArtifactDownload.d.ts","sourceRoot":"","sources":["../../src/execution/useArtifactDownload.ts"],"names":[],"mappings":"AAQA,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAEhC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,yBAAyB,CA8B3B"}

package/execution/useArtifactDownload.js

@@ -0,0 +1,80 @@
+"use client";
+import { useCallback, useMemo, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { GetArtifactDownloadUrlRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Behavior hook that downloads an execution artifact on demand.
+ *
+ * Mirrors the click → mint fresh URL → browser download flow established by
+ * `WorkflowExecutionArtifactPanel`, generalized so every artifact "Download"
+ * affordance shares one implementation. The URL is minted at click time from
+ * the stable `storageKey` via `getArtifactDownloadUrl`, so it is always valid —
+ * unlike the previously persisted, short-lived URL that expired after an hour.
+ *
+ * Returns an imperative `download(storageKey, fileName?)` action rather than a
+ * URL, because a download is a user action, not render data. For rendering an
+ * image or showing a link, use {@link useArtifactDownloadUrl} instead.
+ *
+ * @param executionId - Execution that produced the artifacts, or `null` to
+ *   disable (the action becomes a no-op).
+ *
+ * @example
+ * ```tsx
+ * const { download, isDownloading } = useArtifactDownload(executionId);
+ * <button onClick={() => download(artifact.storageKey, artifact.name)} disabled={isDownloading}>
+ *   Download
+ * </button>
+ * ```
+ *
+ * @see useArtifactDownloadUrl — declarative URL resolver (image src, links)
+ */
+export function useArtifactDownload(executionId) {
+    const stigmer = useStigmer();
+    const [isDownloading, setIsDownloading] = useState(false);
+    const [error, setError] = useState(null);
+    const download = useCallback(async (storageKey, fileName) => {
+        if (!executionId || !storageKey || isDownloading)
+            return;
+        setIsDownloading(true);
+        setError(null);
+        try {
+            const result = await stigmer.agentExecution.getArtifactDownloadUrl(create(GetArtifactDownloadUrlRequestSchema, { executionId, storageKey }));
+            if (result.downloadUrl) {
+                triggerBrowserDownload(result.downloadUrl, fileName);
+            }
+        }
+        catch (err) {
+            setError(toError(err));
+        }
+        finally {
+            setIsDownloading(false);
+        }
+    }, [executionId, stigmer, isDownloading]);
+    return useMemo(() => ({ download, isDownloading, error }), [download, isDownloading, error]);
+}
+/**
+ * Trigger a browser download for a URL via a transient anchor click. The
+ * `download` hint is best-effort: browsers ignore it for cross-origin URLs
+ * (e.g. R2), in which case the navigation still serves the file. Falls back to
+ * a new tab in non-DOM environments.
+ */
+function triggerBrowserDownload(url, fileName) {
+    if (typeof document === "undefined") {
+        if (typeof window !== "undefined") {
+            window.open(url, "_blank", "noopener,noreferrer");
+        }
+        return;
+    }
+    const anchor = document.createElement("a");
+    anchor.href = url;
+    if (fileName)
+        anchor.download = fileName;
+    anchor.rel = "noopener noreferrer";
+    anchor.target = "_blank";
+    document.body.appendChild(anchor);
+    anchor.click();
+    document.body.removeChild(anchor);
+}
+//# sourceMappingURL=useArtifactDownload.js.map

package/execution/useArtifactDownload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArtifactDownload.js","sourceRoot":"","sources":["../../src/execution/useArtifactDownload.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,mCAAmC,EAAE,MAAM,4DAA4D,CAAC;AACjH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAqB9C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAA0B;IAE1B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAG,WAAW,CAC1B,KAAK,EAAE,UAAkB,EAAE,QAAiB,EAAE,EAAE;QAC9C,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,IAAI,aAAa;YAAE,OAAO;QACzD,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,sBAAsB,CAChE,MAAM,CAAC,mCAAmC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CACzE,CAAC;YACF,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,sBAAsB,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,CAAC;gBAAS,CAAC;YACT,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,EACD,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,CACtC,CAAC;IAEF,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAC1C,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,CAAC,CACjC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,sBAAsB,CAAC,GAAW,EAAE,QAAiB;IAC5D,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QACpD,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,IAAI,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACzC,MAAM,CAAC,GAAG,GAAG,qBAAqB,CAAC;IACnC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}