@stigmer/sdk 3.0.9-dev.20260615153829 → 3.1.0

package/execution/__tests__/tool-view.output-ref.test.js

@@ -0,0 +1,64 @@
+// Covers the offloaded tool-output path: when a result is spilled to artifact
+// storage the runner replaces it with a ToolCallOutputRef. The view must surface
+// the STABLE storageKey (+ contentHash) so consumers resolve the bytes/URL on
+// demand — it must never depend on a persisted (ephemeral) URL.
+import { describe, it, expect } from "vitest";
+import { create } from "@bufbuild/protobuf";
+import { ToolCallSchema, ToolCallOutputRefSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import { ToolCallStatus, ToolKind, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { normalizeToolResult } from "../tool-view";
+function toolCallWithOutputRef(ref, result = "") {
+    return create(ToolCallSchema, {
+        id: "tc-1",
+        name: "some_tool",
+        toolKind: ToolKind.UNSPECIFIED,
+        status: ToolCallStatus.TOOL_CALL_COMPLETED,
+        args: {},
+        result,
+        outputRef: ref,
+    });
+}
+describe("normalizeToolResult — offloaded output ref", () => {
+    it("emits an outputRef view carrying the stable storageKey and contentHash", () => {
+        const ref = create(ToolCallOutputRefSchema, {
+            storageKey: "artifacts/exec-1/toolcalls/tc-1.txt",
+            contentHash: "sha256:abc",
+            sizeBytes: 900000n,
+            mimeType: "text/plain",
+            isImage: false,
+            truncatedPreview: "head of the output…",
+        });
+        const view = normalizeToolResult(toolCallWithOutputRef(ref, "[output truncated]"));
+        expect(view.type).toBe("outputRef");
+        if (view.type !== "outputRef")
+            return;
+        expect(view.storageKey).toBe("artifacts/exec-1/toolcalls/tc-1.txt");
+        expect(view.contentHash).toBe("sha256:abc");
+        expect(view.isImage).toBe(false);
+        expect(view.mimeType).toBe("text/plain");
+        expect(view.sizeBytes).toBe(900_000);
+        expect(view.preview).toBe("head of the output…");
+    });
+    it("gates on storageKey, not a URL — an image ref renders inline", () => {
+        const ref = create(ToolCallOutputRefSchema, {
+            storageKey: "artifacts/exec-1/toolcalls/tc-1.png",
+            contentHash: "sha256:img",
+            sizeBytes: 12345n,
+            mimeType: "image/png",
+            isImage: true,
+        });
+        const view = normalizeToolResult(toolCallWithOutputRef(ref));
+        expect(view.type).toBe("outputRef");
+        if (view.type !== "outputRef")
+            return;
+        expect(view.isImage).toBe(true);
+        expect(view.storageKey).toBe("artifacts/exec-1/toolcalls/tc-1.png");
+    });
+    it("does not produce an outputRef view when no storageKey is present", () => {
+        // A ref with no storageKey is not a usable offload pointer; fall back to text.
+        const ref = create(ToolCallOutputRefSchema, { sizeBytes: 10n });
+        const view = normalizeToolResult(toolCallWithOutputRef(ref, "plain result"));
+        expect(view.type).not.toBe("outputRef");
+    });
+});
+//# sourceMappingURL=tool-view.output-ref.test.js.map

package/execution/__tests__/tool-view.output-ref.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-view.output-ref.test.js","sourceRoot":"","sources":["../../../src/execution/__tests__/tool-view.output-ref.test.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iFAAiF;AACjF,8EAA8E;AAC9E,gEAAgE;AAEhE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAmB,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EACL,cAAc,EACd,uBAAuB,GACxB,MAAM,iEAAiE,CAAC;AACzE,OAAO,EACL,cAAc,EACd,QAAQ,GACT,MAAM,8DAA8D,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,SAAS,qBAAqB,CAAC,GAA0E,EAAE,MAAM,GAAG,EAAE;IACpH,OAAO,MAAM,CAAC,cAAc,EAAE;QAC5B,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,QAAQ,CAAC,WAAW;QAC9B,MAAM,EAAE,cAAc,CAAC,mBAAmB;QAC1C,IAAI,EAAE,EAAgB;QACtB,MAAM;QACN,SAAS,EAAE,GAAG;KACf,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,GAAG,GAAG,MAAM,CAAC,uBAAuB,EAAE;YAC1C,UAAU,EAAE,qCAAqC;YACjD,WAAW,EAAE,YAAY;YACzB,SAAS,EAAE,OAAQ;YACnB,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE,KAAK;YACd,gBAAgB,EAAE,qBAAqB;SACxC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,mBAAmB,CAAC,qBAAqB,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC;QAEnF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO;QACtC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,GAAG,GAAG,MAAM,CAAC,uBAAuB,EAAE;YAC1C,UAAU,EAAE,qCAAqC;YACjD,WAAW,EAAE,YAAY;YACzB,SAAS,EAAE,MAAO;YAClB,QAAQ,EAAE,WAAW;YACrB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,mBAAmB,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;QAE7D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO;QACtC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,+EAA+E;QAC/E,MAAM,GAAG,GAAG,MAAM,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,mBAAmB,CAAC,qBAAqB,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/execution/__tests__/tool-view.search.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-view.search.test.d.ts.map

package/execution/__tests__/tool-view.search.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-view.search.test.d.ts","sourceRoot":"","sources":["../../../src/execution/__tests__/tool-view.search.test.ts"],"names":[],"mappings":""}

package/execution/__tests__/tool-view.search.test.js

@@ -0,0 +1,200 @@
+// Covers search normalization's envelope handling: the Cursor SDK returns search
+// results as a stringified JSON envelope (file-name search via {status,value} and
+// grep/codebase search via {workspaceResults}), which the original parser dumped
+// as a single fake "match". The cross-language fixture (result-views.json)
+// asserts the happy-path `type`/`count`; these cover the `kind`/`truncated`
+// presentation hints, the multi-workspace flatten, the content-match mapping, and
+// the unrecognized-JSON -> json degradation that is not a shared scalar fact.
+import { describe, it, expect } from "vitest";
+import { create } from "@bufbuild/protobuf";
+import { ToolCallSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import { ToolCallStatus, ToolKind, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { normalizeToolResult } from "../tool-view";
+function searchCall(args, result) {
+    return create(ToolCallSchema, {
+        id: "tc-search",
+        name: "Grep",
+        toolKind: ToolKind.SEARCH,
+        status: ToolCallStatus.TOOL_CALL_COMPLETED,
+        args: args,
+        result,
+    });
+}
+describe("normalizeToolResult — Cursor file-name search envelope", () => {
+    it("unwraps an empty {status,value} file search (the reported bug: not '1 match')", () => {
+        const view = normalizeToolResult(searchCall({ pattern: "**/*.nope" }, JSON.stringify({
+            status: "success",
+            value: { files: [], totalFiles: 0, clientTruncated: false, ripgrepTruncated: false },
+        })));
+        expect(view.type).toBe("search");
+        if (view.type !== "search")
+            return;
+        expect(view.kind).toBe("files");
+        expect(view.count).toBe(0);
+        expect(view.matches).toHaveLength(0);
+        expect(view.truncated).toBe(false);
+    });
+    it("unwraps a non-empty file search into clickable file matches", () => {
+        const view = normalizeToolResult(searchCall({ pattern: "Dockerfile" }, JSON.stringify({
+            status: "success",
+            value: { files: ["Dockerfile"], totalFiles: 1, clientTruncated: false, ripgrepTruncated: false },
+        })));
+        expect(view.type).toBe("search");
+        if (view.type !== "search")
+            return;
+        expect(view.kind).toBe("files");
+        expect(view.count).toBe(1);
+        // Both file and text are set so a kind-unaware consumer still shows the path.
+        expect(view.matches[0]).toEqual({ file: "Dockerfile", text: "Dockerfile" });
+    });
+    it("carries the engine's truncation flags and authoritative totalFiles", () => {
+        const view = normalizeToolResult(searchCall({ pattern: "*.ts" }, JSON.stringify({
+            status: "success",
+            value: { files: ["a.ts", "b.ts"], totalFiles: 200, clientTruncated: true, ripgrepTruncated: false },
+        })));
+        expect(view.type).toBe("search");
+        if (view.type !== "search")
+            return;
+        // totalFiles is authoritative and can exceed the returned page.
+        expect(view.count).toBe(200);
+        expect(view.matches).toHaveLength(2);
+        expect(view.truncated).toBe(true);
+    });
+});
+describe("normalizeToolResult — Cursor grep workspaceResults envelope", () => {
+    it("unwraps the real {status,value:{workspaceResults}} grep shape (the reported bug)", () => {
+        // The grep payload nests workspaceResults INSIDE the {status,value} envelope —
+        // the shape the runner actually persists. The original parser only looked at
+        // the top level, so this fell through to a raw JSON dump.
+        const view = normalizeToolResult(searchCall({ pattern: "pipeline" }, JSON.stringify({
+            status: "success",
+            value: {
+                workspaceResults: {
+                    "/work/demo": { type: "files", output: { files: [], count: 0 } },
+                },
+            },
+        })));
+        expect(view.type).toBe("search");
+        if (view.type !== "search")
+            return;
+        expect(view.kind).toBe("files");
+        expect(view.count).toBe(0);
+    });
+    it("still reads an un-enveloped top-level workspaceResults (defensive)", () => {
+        const view = normalizeToolResult(searchCall({ pattern: "pipeline" }, JSON.stringify({
+            workspaceResults: { "/work/demo": { type: "files", output: { files: [], count: 0 } } },
+        })));
+        expect(view.type).toBe("search");
+        if (view.type !== "search")
+            return;
+        expect(view.kind).toBe("files");
+        expect(view.count).toBe(0);
+    });
+    it("flattens file matches across multiple workspaces and sums reported counts", () => {
+        const view = normalizeToolResult(searchCall({ pattern: "TODO" }, JSON.stringify({
+            status: "success",
+            value: {
+                workspaceResults: {
+                    "/work/a": { type: "files", output: { files: ["a/x.ts"], count: 1 } },
+                    "/work/b": { type: "files", output: { files: ["b/y.ts"], count: 1 } },
+                },
+            },
+        })));
+        expect(view.type).toBe("search");
+        if (view.type !== "search")
+            return;
+        expect(view.kind).toBe("files");
+        expect(view.count).toBe(2);
+        expect(view.matches.map((m) => m.file)).toEqual(["a/x.ts", "b/y.ts"]);
+    });
+    it("renders a non-empty grep (type:files) as a file list, not 0 files", () => {
+        // The real wrapped shape with results present — proves a populated grep is
+        // shown (the user's concern that a non-empty response might render as empty).
+        const view = normalizeToolResult(searchCall({ pattern: "pipeline" }, JSON.stringify({
+            status: "success",
+            value: {
+                workspaceResults: {
+                    "/work/demo": {
+                        type: "files",
+                        output: { files: [".tekton/pipeline.yaml", "README.md"], count: 2 },
+                    },
+                },
+            },
+        })));
+        expect(view.type).toBe("search");
+        if (view.type !== "search")
+            return;
+        expect(view.kind).toBe("files");
+        expect(view.count).toBe(2);
+        expect(view.matches.map((m) => m.file)).toEqual([".tekton/pipeline.yaml", "README.md"]);
+    });
+    it("falls back to JSON (never hides data) when a count is reported but nothing extracts", () => {
+        // Shape drift: the engine says count:5 but the matches live under a key we
+        // don't recognise. Surfacing the raw JSON beats a misleading "No matches".
+        const view = normalizeToolResult(searchCall({ pattern: "x" }, JSON.stringify({
+            status: "success",
+            value: {
+                workspaceResults: {
+                    "/work/demo": { type: "weird", output: { hits: ["a", "b"], count: 5 } },
+                },
+            },
+        })));
+        expect(view.type).toBe("json");
+    });
+    it("falls back to JSON when a file search reports totalFiles but no extractable paths", () => {
+        // files are objects, not strings (a drift) — but totalFiles says 3.
+        const view = normalizeToolResult(searchCall({ pattern: "*.ts" }, JSON.stringify({
+            status: "success",
+            value: { files: [{ path: "a.ts" }], totalFiles: 3 },
+        })));
+        expect(view.type).toBe("json");
+    });
+    it("maps line-bearing matches into grouped content matches", () => {
+        const view = normalizeToolResult(searchCall({ pattern: "TODO" }, JSON.stringify({
+            status: "success",
+            value: {
+                workspaceResults: {
+                    "/work/a": {
+                        type: "matches",
+                        output: {
+                            matches: [
+                                { file: "a/x.ts", line: 12, text: "// TODO: fix" },
+                                { file: "a/x.ts", line: 30, text: "// TODO: later" },
+                            ],
+                            count: 2,
+                        },
+                    },
+                },
+            },
+        })));
+        expect(view.type).toBe("search");
+        if (view.type !== "search")
+            return;
+        expect(view.kind).toBe("content");
+        expect(view.count).toBe(2);
+        expect(view.matches[0]).toEqual({ file: "a/x.ts", line: 12, text: "// TODO: fix" });
+    });
+});
+describe("normalizeToolResult — search plain text and graceful degradation", () => {
+    it("keeps native grep line matches as content (unchanged behavior)", () => {
+        const view = normalizeToolResult(searchCall({ pattern: "TODO" }, "\n/workspace/a.go:\n  12: // TODO: fix\n/workspace/b.go:\n  7: // TODO: later"));
+        expect(view.type).toBe("search");
+        if (view.type !== "search")
+            return;
+        expect(view.kind).toBe("content");
+        expect(view.count).toBe(2);
+    });
+    it("treats native path/name lines as file matches", () => {
+        const view = normalizeToolResult(searchCall({ pattern: "*.go" }, "src/a.go\nsrc/b.go"));
+        expect(view.type).toBe("search");
+        if (view.type !== "search")
+            return;
+        expect(view.kind).toBe("files");
+        expect(view.count).toBe(2);
+    });
+    it("degrades an unrecognized JSON shape to a json view, not a fake match", () => {
+        const view = normalizeToolResult(searchCall({ pattern: "x" }, JSON.stringify({ somethingElse: true })));
+        expect(view.type).toBe("json");
+    });
+});
+//# sourceMappingURL=tool-view.search.test.js.map

package/execution/__tests__/tool-view.search.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-view.search.test.js","sourceRoot":"","sources":["../../../src/execution/__tests__/tool-view.search.test.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,kFAAkF;AAClF,iFAAiF;AACjF,2EAA2E;AAC3E,4EAA4E;AAC5E,kFAAkF;AAClF,8EAA8E;AAE9E,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAmB,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iEAAiE,CAAC;AACjG,OAAO,EACL,cAAc,EACd,QAAQ,GACT,MAAM,8DAA8D,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,SAAS,UAAU,CAAC,IAA6B,EAAE,MAAc;IAC/D,OAAO,MAAM,CAAC,cAAc,EAAE;QAC5B,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,MAAM,EAAE,cAAc,CAAC,mBAAmB;QAC1C,IAAI,EAAE,IAAkB;QACxB,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,wDAAwD,EAAE,GAAG,EAAE;IACtE,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CACR,EAAE,OAAO,EAAE,WAAW,EAAE,EACxB,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE;SACrF,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CACR,EAAE,OAAO,EAAE,YAAY,EAAE,EACzB,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE;SACjG,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,8EAA8E;QAC9E,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CACR,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;SACpG,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACnC,gEAAgE;QAChE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,6DAA6D,EAAE,GAAG,EAAE;IAC3E,EAAE,CAAC,kFAAkF,EAAE,GAAG,EAAE;QAC1F,+EAA+E;QAC/E,6EAA6E;QAC7E,0DAA0D;QAC1D,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CACR,EAAE,OAAO,EAAE,UAAU,EAAE,EACvB,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE;gBACL,gBAAgB,EAAE;oBAChB,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;iBACjE;aACF;SACF,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CACR,EAAE,OAAO,EAAE,UAAU,EAAE,EACvB,IAAI,CAAC,SAAS,CAAC;YACb,gBAAgB,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE;SACvF,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CACR,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE;gBACL,gBAAgB,EAAE;oBAChB,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;oBACrE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;iBACtE;aACF;SACF,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,2EAA2E;QAC3E,8EAA8E;QAC9E,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CACR,EAAE,OAAO,EAAE,UAAU,EAAE,EACvB,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE;gBACL,gBAAgB,EAAE;oBAChB,YAAY,EAAE;wBACZ,IAAI,EAAE,OAAO;wBACb,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,uBAAuB,EAAE,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;qBACpE;iBACF;aACF;SACF,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qFAAqF,EAAE,GAAG,EAAE;QAC7F,2EAA2E;QAC3E,2EAA2E;QAC3E,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CACR,EAAE,OAAO,EAAE,GAAG,EAAE,EAChB,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE;gBACL,gBAAgB,EAAE;oBAChB,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;iBACxE;aACF;SACF,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QAC3F,oEAAoE;QACpE,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CACR,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;SACpD,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CACR,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE;gBACL,gBAAgB,EAAE;oBAChB,SAAS,EAAE;wBACT,IAAI,EAAE,SAAS;wBACf,MAAM,EAAE;4BACN,OAAO,EAAE;gCACP,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;gCAClD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE;6BACrD;4BACD,KAAK,EAAE,CAAC;yBACT;qBACF;iBACF;aACF;SACF,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kEAAkE,EAAE,GAAG,EAAE;IAChF,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CACR,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,+EAA+E,CAChF,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,IAAI,GAAG,mBAAmB,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;QACxF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACnC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,IAAI,GAAG,mBAAmB,CAC9B,UAAU,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CACtE,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/execution/__tests__/tool-view.shell.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-view.shell.test.d.ts.map

package/execution/__tests__/tool-view.shell.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-view.shell.test.d.ts","sourceRoot":"","sources":["../../../src/execution/__tests__/tool-view.shell.test.ts"],"names":[],"mappings":""}

package/execution/__tests__/tool-view.shell.test.js

@@ -0,0 +1,104 @@
+// Covers shell normalization's `command` capture and result-shape handling: a
+// terminal view models the whole session (prompt + output), so the command is
+// echoed from args onto the view across every result shape — un-enveloped Cursor
+// JSON, the Cursor {status,value} envelope, the exit-marker form, and plain
+// text. The cross-language fixture (result-views.json) asserts the happy path;
+// these cover the branch matrix, the envelope unwrap (the reported bug), and the
+// missing-command edge.
+import { describe, it, expect } from "vitest";
+import { create } from "@bufbuild/protobuf";
+import { ToolCallSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import { ToolCallStatus, ToolKind, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { normalizeToolResult } from "../tool-view";
+function shellCall(args, result) {
+    return create(ToolCallSchema, {
+        id: "tc-shell",
+        name: "shell",
+        toolKind: ToolKind.SHELL,
+        status: ToolCallStatus.TOOL_CALL_COMPLETED,
+        args: args,
+        result,
+    });
+}
+describe("normalizeToolResult — shell command capture", () => {
+    it("captures the command on the plain (no-marker) branch", () => {
+        const view = normalizeToolResult(shellCall({ command: "echo hi" }, "hi\n"));
+        expect(view.type).toBe("terminal");
+        if (view.type !== "terminal")
+            return;
+        expect(view.command).toBe("echo hi");
+        expect(view.stdout).toBe("hi\n");
+    });
+    it("captures the command on the exit-marker branch (success and failure)", () => {
+        const ok = normalizeToolResult(shellCall({ command: "ls -la" }, "total 8\n[Command succeeded]"));
+        expect(ok.type).toBe("terminal");
+        if (ok.type !== "terminal")
+            return;
+        expect(ok.command).toBe("ls -la");
+        expect(ok.exitCode).toBe(0);
+        const bad = normalizeToolResult(shellCall({ command: "false" }, "boom\n[Command failed with exit code 2]"));
+        expect(bad.type).toBe("terminal");
+        if (bad.type !== "terminal")
+            return;
+        expect(bad.command).toBe("false");
+        expect(bad.exitCode).toBe(2);
+    });
+    it("captures the command on the structured Cursor JSON branch", () => {
+        const view = normalizeToolResult(shellCall({ command: "npm test" }, JSON.stringify({ stdout: "ok", stderr: "", exitCode: 0 })));
+        expect(view.type).toBe("terminal");
+        if (view.type !== "terminal")
+            return;
+        expect(view.command).toBe("npm test");
+        expect(view.stdout).toBe("ok");
+    });
+    it("unwraps the Cursor {status,value} envelope on success (the reported bug)", () => {
+        const view = normalizeToolResult(shellCall({ command: "ls -la" }, JSON.stringify({
+            status: "success",
+            value: {
+                exitCode: 0,
+                signal: "",
+                stdout: "total 8\ndrwxr-xr-x  2 user user 4096 .\n",
+                stderr: "",
+                executionTime: 1176,
+            },
+        })));
+        expect(view.type).toBe("terminal");
+        if (view.type !== "terminal")
+            return;
+        expect(view.command).toBe("ls -la");
+        // The real stdout surfaces — NOT the raw envelope JSON.
+        expect(view.stdout).toBe("total 8\ndrwxr-xr-x  2 user user 4096 .\n");
+        expect(view.exitCode).toBe(0);
+        // Regression guard: the envelope keys must never leak into the rendered output.
+        expect(view.stdout).not.toContain("status");
+        expect(view.stdout).not.toContain("value");
+        expect(view.stdout).not.toContain("executionTime");
+    });
+    it("unwraps the Cursor envelope on failure (surfaces stderr and exit code)", () => {
+        const view = normalizeToolResult(shellCall({ command: "ls /nope" }, JSON.stringify({
+            status: "success",
+            value: {
+                exitCode: 2,
+                signal: "",
+                stdout: "",
+                stderr: "ls: /nope: No such file or directory\n",
+                executionTime: 5,
+            },
+        })));
+        expect(view.type).toBe("terminal");
+        if (view.type !== "terminal")
+            return;
+        expect(view.command).toBe("ls /nope");
+        expect(view.stderr).toBe("ls: /nope: No such file or directory\n");
+        expect(view.exitCode).toBe(2);
+    });
+    it("leaves command undefined when args carry no command", () => {
+        const view = normalizeToolResult(shellCall({}, "orphan output\n"));
+        expect(view.type).toBe("terminal");
+        if (view.type !== "terminal")
+            return;
+        expect(view.command).toBeUndefined();
+        expect(view.stdout).toBe("orphan output\n");
+    });
+});
+//# sourceMappingURL=tool-view.shell.test.js.map

package/execution/__tests__/tool-view.shell.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-view.shell.test.js","sourceRoot":"","sources":["../../../src/execution/__tests__/tool-view.shell.test.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,iFAAiF;AACjF,4EAA4E;AAC5E,+EAA+E;AAC/E,iFAAiF;AACjF,wBAAwB;AAExB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAmB,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iEAAiE,CAAC;AACjG,OAAO,EACL,cAAc,EACd,QAAQ,GACT,MAAM,8DAA8D,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,SAAS,SAAS,CAAC,IAA6B,EAAE,MAAc;IAC9D,OAAO,MAAM,CAAC,cAAc,EAAE;QAC5B,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,MAAM,EAAE,cAAc,CAAC,mBAAmB;QAC1C,IAAI,EAAE,IAAkB;QACxB,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,6CAA6C,EAAE,GAAG,EAAE;IAC3D,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,IAAI,GAAG,mBAAmB,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,EAAE,GAAG,mBAAmB,CAC5B,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,8BAA8B,CAAC,CACjE,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,EAAE,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO;QACnC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE5B,MAAM,GAAG,GAAG,mBAAmB,CAC7B,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,yCAAyC,CAAC,CAC3E,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO;QACpC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,IAAI,GAAG,mBAAmB,CAC9B,SAAS,CACP,EAAE,OAAO,EAAE,UAAU,EAAE,EACvB,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAC1D,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,IAAI,GAAG,mBAAmB,CAC9B,SAAS,CACP,EAAE,OAAO,EAAE,QAAQ,EAAE,EACrB,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE;gBACL,QAAQ,EAAE,CAAC;gBACX,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,2CAA2C;gBACnD,MAAM,EAAE,EAAE;gBACV,aAAa,EAAE,IAAI;aACpB;SACF,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,wDAAwD;QACxD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,gFAAgF;QAChF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,IAAI,GAAG,mBAAmB,CAC9B,SAAS,CACP,EAAE,OAAO,EAAE,UAAU,EAAE,EACvB,IAAI,CAAC,SAAS,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE;gBACL,QAAQ,EAAE,CAAC;gBACX,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,wCAAwC;gBAChD,aAAa,EAAE,CAAC;aACjB;SACF,CAAC,CACH,CACF,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,IAAI,GAAG,mBAAmB,CAAC,SAAS,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/execution/approval-provenance.d.ts

@@ -0,0 +1,30 @@
+import { ApprovalPolicySource } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+export { ApprovalPolicySource };
+/**
+ * Returns a short human phrase describing a tool call's authorization
+ * provenance, or `null` for {@link ApprovalPolicySource.UNSPECIFIED} — an
+ * execution that predates this field, or a tool the gate never evaluated (e.g. a
+ * read-only built-in) — so callers render nothing rather than a misleading
+ * default.
+ */
+export declare function describeApprovalPolicySource(source: ApprovalPolicySource): string | null;
+/**
+ * Returns whether a policy source carries information worth surfacing inline at
+ * the approval gate, versus the everyday default ("this tool category just
+ * requires approval") that is noise next to the action it is already gating.
+ *
+ * The default gating reasons — {@link ApprovalPolicySource.CLASSIFIER_DEFAULT}
+ * and {@link ApprovalPolicySource.BUILTIN_CATEGORY} — explain nothing the user
+ * does not already infer from the tool itself, so they are suppressed from the
+ * card (the full phrase stays available on hover where a surface chooses to show
+ * a chip). The remaining sources each change the user's understanding of *why*
+ * this particular call is held — an explicit override, a server tightening a
+ * destructive tool, or (post-execution) a bypass/lease that cleared it — and so
+ * are worth showing. {@link ApprovalPolicySource.UNSPECIFIED} is never
+ * informative (legacy / ungated).
+ *
+ * This is the headless policy behind the gate's "smart-suppress" provenance
+ * chip; rendering lives in the consuming surface.
+ */
+export declare function isInformativePolicySource(source: ApprovalPolicySource): boolean;
+//# sourceMappingURL=approval-provenance.d.ts.map

package/execution/approval-provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-provenance.d.ts","sourceRoot":"","sources":["../../src/execution/approval-provenance.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAC;AAEpG,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,oBAAoB,GAC3B,MAAM,GAAG,IAAI,CAoBf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAcT"}

package/execution/approval-provenance.js

@@ -0,0 +1,73 @@
+// Framework-agnostic authorization-provenance labels for every Stigmer surface.
+//
+// describeApprovalPolicySource maps the wire ApprovalPolicySource — *which policy
+// layer decided a tool call's approval requirement* — to a short human phrase.
+// It is shared by @stigmer/react (the ApprovalCard "why-gated" line and the
+// tool-call detail view) and @stigmer/ink (the terminal approval prompt); the Go
+// CLI mirrors it. The phrasing is intrinsic to the source's semantics so the
+// same label reads correctly whether the call is still waiting (a gating source
+// → "required by …") or already cleared (a bypass source → "auto-approved …").
+import { ApprovalPolicySource } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+export { ApprovalPolicySource };
+/**
+ * Returns a short human phrase describing a tool call's authorization
+ * provenance, or `null` for {@link ApprovalPolicySource.UNSPECIFIED} — an
+ * execution that predates this field, or a tool the gate never evaluated (e.g. a
+ * read-only built-in) — so callers render nothing rather than a misleading
+ * default.
+ */
+export function describeApprovalPolicySource(source) {
+    switch (source) {
+        case ApprovalPolicySource.CLASSIFIER_DEFAULT:
+            return "required by the tool's default policy";
+        case ApprovalPolicySource.PINNED_OVERRIDE:
+            return "required by a pinned override";
+        case ApprovalPolicySource.AGENT_OVERRIDE:
+            return "required by agent override";
+        case ApprovalPolicySource.BUILTIN_CATEGORY:
+            return "required by built-in tool policy";
+        case ApprovalPolicySource.ANNOTATION_DESTRUCTIVE_TIGHTEN:
+            return "required: marked destructive by the server";
+        case ApprovalPolicySource.AUTO_APPROVE_ALL:
+            return "auto-approved by a run-wide bypass";
+        case ApprovalPolicySource.APPROVAL_LEASE:
+            return "auto-approved by a run lease";
+        case ApprovalPolicySource.UNSPECIFIED:
+        default:
+            return null;
+    }
+}
+/**
+ * Returns whether a policy source carries information worth surfacing inline at
+ * the approval gate, versus the everyday default ("this tool category just
+ * requires approval") that is noise next to the action it is already gating.
+ *
+ * The default gating reasons — {@link ApprovalPolicySource.CLASSIFIER_DEFAULT}
+ * and {@link ApprovalPolicySource.BUILTIN_CATEGORY} — explain nothing the user
+ * does not already infer from the tool itself, so they are suppressed from the
+ * card (the full phrase stays available on hover where a surface chooses to show
+ * a chip). The remaining sources each change the user's understanding of *why*
+ * this particular call is held — an explicit override, a server tightening a
+ * destructive tool, or (post-execution) a bypass/lease that cleared it — and so
+ * are worth showing. {@link ApprovalPolicySource.UNSPECIFIED} is never
+ * informative (legacy / ungated).
+ *
+ * This is the headless policy behind the gate's "smart-suppress" provenance
+ * chip; rendering lives in the consuming surface.
+ */
+export function isInformativePolicySource(source) {
+    switch (source) {
+        case ApprovalPolicySource.PINNED_OVERRIDE:
+        case ApprovalPolicySource.AGENT_OVERRIDE:
+        case ApprovalPolicySource.ANNOTATION_DESTRUCTIVE_TIGHTEN:
+        case ApprovalPolicySource.AUTO_APPROVE_ALL:
+        case ApprovalPolicySource.APPROVAL_LEASE:
+            return true;
+        case ApprovalPolicySource.CLASSIFIER_DEFAULT:
+        case ApprovalPolicySource.BUILTIN_CATEGORY:
+        case ApprovalPolicySource.UNSPECIFIED:
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=approval-provenance.js.map

package/execution/approval-provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-provenance.js","sourceRoot":"","sources":["../../src/execution/approval-provenance.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,kFAAkF;AAClF,+EAA+E;AAC/E,4EAA4E;AAC5E,iFAAiF;AACjF,6EAA6E;AAC7E,gFAAgF;AAChF,+EAA+E;AAE/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAC;AAEpG,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAA4B;IAE5B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,oBAAoB,CAAC,kBAAkB;YAC1C,OAAO,uCAAuC,CAAC;QACjD,KAAK,oBAAoB,CAAC,eAAe;YACvC,OAAO,+BAA+B,CAAC;QACzC,KAAK,oBAAoB,CAAC,cAAc;YACtC,OAAO,4BAA4B,CAAC;QACtC,KAAK,oBAAoB,CAAC,gBAAgB;YACxC,OAAO,kCAAkC,CAAC;QAC5C,KAAK,oBAAoB,CAAC,8BAA8B;YACtD,OAAO,4CAA4C,CAAC;QACtD,KAAK,oBAAoB,CAAC,gBAAgB;YACxC,OAAO,oCAAoC,CAAC;QAC9C,KAAK,oBAAoB,CAAC,cAAc;YACtC,OAAO,8BAA8B,CAAC;QACxC,KAAK,oBAAoB,CAAC,WAAW,CAAC;QACtC;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAA4B;IAE5B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,oBAAoB,CAAC,eAAe,CAAC;QAC1C,KAAK,oBAAoB,CAAC,cAAc,CAAC;QACzC,KAAK,oBAAoB,CAAC,8BAA8B,CAAC;QACzD,KAAK,oBAAoB,CAAC,gBAAgB,CAAC;QAC3C,KAAK,oBAAoB,CAAC,cAAc;YACtC,OAAO,IAAI,CAAC;QACd,KAAK,oBAAoB,CAAC,kBAAkB,CAAC;QAC7C,KAAK,oBAAoB,CAAC,gBAAgB,CAAC;QAC3C,KAAK,oBAAoB,CAAC,WAAW,CAAC;QACtC;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/execution/execution-phases.d.ts

@@ -0,0 +1,7 @@
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/**
+ * Returns `true` when the given phase represents a final, immutable
+ * execution state — no further updates will arrive from the server.
+ */
+export declare function isTerminalPhase(phase: ExecutionPhase): boolean;
+//# sourceMappingURL=execution-phases.d.ts.map

package/execution/execution-phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-phases.d.ts","sourceRoot":"","sources":["../../src/execution/execution-phases.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAS9F;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE9D"}

package/execution/execution-phases.js

@@ -0,0 +1,21 @@
+// Framework-agnostic execution-phase predicates.
+//
+// Lives in @stigmer/sdk (the pure layer) so it is shared by @stigmer/react and
+// @stigmer/ink and usable by pure logic here (e.g. the file-review fold's corpus
+// parity test reproduces the server's terminal-phase gate). @stigmer/react
+// re-exports it so its public API is unchanged.
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+const TERMINAL_PHASES = new Set([
+    ExecutionPhase.EXECUTION_COMPLETED,
+    ExecutionPhase.EXECUTION_FAILED,
+    ExecutionPhase.EXECUTION_CANCELLED,
+    ExecutionPhase.EXECUTION_TERMINATED,
+]);
+/**
+ * Returns `true` when the given phase represents a final, immutable
+ * execution state — no further updates will arrive from the server.
+ */
+export function isTerminalPhase(phase) {
+    return TERMINAL_PHASES.has(phase);
+}
+//# sourceMappingURL=execution-phases.js.map

package/execution/execution-phases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-phases.js","sourceRoot":"","sources":["../../src/execution/execution-phases.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,+EAA+E;AAC/E,iFAAiF;AACjF,2EAA2E;AAC3E,gDAAgD;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAE9F,MAAM,eAAe,GAAgC,IAAI,GAAG,CAAC;IAC3D,cAAc,CAAC,mBAAmB;IAClC,cAAc,CAAC,gBAAgB;IAC/B,cAAc,CAAC,mBAAmB;IAClC,cAAc,CAAC,oBAAoB;CACpC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/execution/file-review-fold.d.ts

@@ -0,0 +1,44 @@
+import type { AgentExecutionStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import type { FileChangeSet, FileReviewEventStream } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/filereview_pb";
+/**
+ * Folds a file-review event ledger into its list of {@link FileChangeSet}s,
+ * grouped by `change_set_id` in first-seen order.
+ *
+ * This is the display fold: unlike the server projection it does NOT collapse to
+ * an empty list for a terminal execution, so a completed/failed/cancelled
+ * execution still yields its settled sets for read-only display. For the LIVE
+ * (actionable) view, prefer the server-computed `status.file_change_sets`
+ * projection (it is structurally shared across stream frames); this fold is the
+ * settled/terminal complement — see {@link displayFileChangeSets}.
+ *
+ * The fold is a faithful port of the Go/Java projector: scalar and snapshot
+ * fields are last-writer-wins, `decisions` accumulate, `changes` are replaced
+ * wholesale by the latest `CANDIDATE_CAPTURED`, and terminal `RECONCILED` /
+ * `FAILED` statuses are sticky (a later non-terminal event never downgrades
+ * them).
+ *
+ * @param stream - The execution's `file_review_event_stream`, or `undefined`.
+ * @returns One {@link FileChangeSet} per `change_set_id`, in first-seen order.
+ */
+export declare function foldFileReviewEventStream(stream: FileReviewEventStream | undefined): FileChangeSet[];
+/**
+ * The single read seam for displaying an execution's file change sets.
+ *
+ * Returns the server-computed `status.file_change_sets` projection when it is
+ * present (a LIVE execution — the projection is structurally shared across
+ * stream frames, so consumers keep stable references and streaming re-renders
+ * stay scoped to the actively-changing card), and otherwise folds the ledger
+ * (a TERMINAL execution — the server projects nil there, but the ledger is
+ * preserved). The fold therefore never runs on the streaming hot path; it only
+ * reconstructs the settled sets a dead execution would otherwise not display.
+ *
+ * The two branches are equivalent by construction for a non-terminal execution
+ * (the fold minus its terminal gate IS the server projection — locked by the
+ * corpus parity test), so this accessor is a single consistent source whichever
+ * branch it takes.
+ *
+ * @param status - The execution status, or `undefined`.
+ * @returns The change sets to display, or an empty array when there are none.
+ */
+export declare function displayFileChangeSets(status: AgentExecutionStatus | undefined): FileChangeSet[];
+//# sourceMappingURL=file-review-fold.d.ts.map

package/execution/file-review-fold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-review-fold.d.ts","sourceRoot":"","sources":["../../src/execution/file-review-fold.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6DAA6D,CAAC;AACxG,OAAO,KAAK,EACV,aAAa,EAEb,qBAAqB,EACtB,MAAM,oEAAoE,CAAC;AAQ5E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,qBAAqB,GAAG,SAAS,GACxC,aAAa,EAAE,CAsBjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GACvC,aAAa,EAAE,CAIjB"}