@stigmer/sdk 3.12.6 → 3.12.7

package/execution/__tests__/transcript.test.js

@@ -0,0 +1,527 @@
+// The canonical session transcript (stigmer/stigmer#814): assembly rules,
+// offload resolution, and the two serializations.
+//
+// The Markdown format is a pinned contract: transcript.golden.md freezes the
+// exact rendering of a transcript exercising every construct (thinking,
+// system, tool calls with args/results, offloaded outputs resolved and
+// noted, sub-agent nesting, build-from-plan and in-progress markers). A
+// deliberate format change regenerates the golden with
+//   UPDATE_TRANSCRIPT_GOLDEN=1 npx vitest run src/execution/__tests__/transcript.test.ts
+// and reviews the diff; an accidental one fails here.
+import { readFileSync, writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { describe, it, expect } from "vitest";
+import { create } from "@bufbuild/protobuf";
+import { AgentExecutionSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { ExecutionPhase, MessageType, ToolCallStatus, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { AgentExecutionListSchema, GetArtifactContentResponseSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { SessionSchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+import { assembleSessionTranscript, fetchSessionTranscript, resolveOffloadedOutputs, transcriptToJson, transcriptToMarkdown, } from "../transcript";
+const here = dirname(fileURLToPath(import.meta.url));
+// ---------------------------------------------------------------------------
+// Fixture builders
+// ---------------------------------------------------------------------------
+function session() {
+    return create(SessionSchema, {
+        metadata: { id: "ses_01" },
+        spec: { subject: "Fix the flaky test", agentInstanceId: "agi_01" },
+    });
+}
+/** Turn 1: prompt echo dedupe, thinking, tool call with args + inline
+ * result + duration, offloaded text output, image output, raw system. */
+function exec1() {
+    return create(AgentExecutionSchema, {
+        metadata: { id: "aex_01a" },
+        spec: { sessionId: "ses_01", message: "Why is CI red?" },
+        status: {
+            phase: ExecutionPhase.EXECUTION_COMPLETED,
+            startedAt: "2026-08-20T10:00:00Z",
+            completedAt: "2026-08-20T10:01:00Z",
+            messages: [
+                {
+                    type: MessageType.MESSAGE_HUMAN,
+                    content: "Why is CI red?",
+                    timestamp: "2026-08-20T10:00:01Z",
+                },
+                {
+                    type: MessageType.MESSAGE_THINKING,
+                    content: "The failure is in the retry loop.\nLet me check.",
+                    timestamp: "2026-08-20T10:00:02Z",
+                },
+                {
+                    type: MessageType.MESSAGE_AI,
+                    content: "Let me look.",
+                    timestamp: "2026-08-20T10:00:04Z",
+                    toolCalls: [
+                        {
+                            id: "tc_1",
+                            name: "shell_command",
+                            args: { command: "go test ./..." },
+                            result: "FAIL: TestRetry",
+                            status: ToolCallStatus.TOOL_CALL_COMPLETED,
+                            startedAt: "2026-08-20T10:00:05Z",
+                            completedAt: "2026-08-20T10:00:07Z",
+                        },
+                    ],
+                },
+                {
+                    type: MessageType.MESSAGE_AI,
+                    content: "",
+                    timestamp: "2026-08-20T10:00:10Z",
+                    toolCalls: [
+                        {
+                            id: "tc_2",
+                            name: "read_file",
+                            args: { path: "retry.go" },
+                            status: ToolCallStatus.TOOL_CALL_COMPLETED,
+                            outputRef: {
+                                storageKey: "artifacts/aex_01a/toolcalls/tc_2.txt",
+                                sizeBytes: 2048n,
+                                mimeType: "text/plain",
+                                truncatedPreview: "package retry…",
+                            },
+                        },
+                        {
+                            id: "tc_3",
+                            name: "screenshot",
+                            status: ToolCallStatus.TOOL_CALL_COMPLETED,
+                            outputRef: {
+                                storageKey: "artifacts/aex_01a/toolcalls/tc_3.png",
+                                sizeBytes: 4096n,
+                                mimeType: "image/png",
+                                isImage: true,
+                            },
+                        },
+                    ],
+                },
+                {
+                    type: MessageType.MESSAGE_SYSTEM,
+                    content: "Approval received",
+                    timestamp: "2026-08-20T10:00:20Z",
+                },
+            ],
+        },
+    });
+}
+/** Superseded by exec3's edit-and-resubmit — excluded by default. */
+function exec2() {
+    return create(AgentExecutionSchema, {
+        metadata: { id: "aex_01b" },
+        spec: { sessionId: "ses_01", message: "old prompt" },
+        status: { phase: ExecutionPhase.EXECUTION_COMPLETED },
+    });
+}
+/** Turn 2: edit-and-resubmit successor with a sub-agent delegation. */
+function exec3() {
+    return create(AgentExecutionSchema, {
+        metadata: { id: "aex_01c" },
+        spec: {
+            sessionId: "ses_01",
+            message: "edited prompt",
+            supersedesExecutionId: "aex_01b",
+        },
+        status: {
+            phase: ExecutionPhase.EXECUTION_COMPLETED,
+            startedAt: "2026-08-20T11:00:00Z",
+            messages: [
+                {
+                    type: MessageType.MESSAGE_AI,
+                    content: "Delegating.",
+                    toolCalls: [
+                        {
+                            id: "tc_sa",
+                            name: "task",
+                            status: ToolCallStatus.TOOL_CALL_COMPLETED,
+                        },
+                    ],
+                },
+            ],
+            subAgentExecutions: [
+                {
+                    id: "tc_sa",
+                    name: "explore",
+                    subject: "Explore the repo",
+                    input: "find tests",
+                    output: "found 3",
+                    startedAt: "2026-08-20T11:00:01Z",
+                    completedAt: "2026-08-20T11:00:06Z",
+                    messages: [
+                        {
+                            type: MessageType.MESSAGE_AI,
+                            content: "Scanning.",
+                            toolCalls: [
+                                {
+                                    id: "tc_sa_1",
+                                    name: "grep",
+                                    result: "3 matches",
+                                    status: ToolCallStatus.TOOL_CALL_COMPLETED,
+                                    outputRef: {
+                                        // Sub-agent outputs are stored under the PARENT
+                                        // execution's id — the storage key is the record of it.
+                                        storageKey: "artifacts/aex_01c/toolcalls/tc_sa_1.txt",
+                                        sizeBytes: 64n,
+                                        mimeType: "text/plain",
+                                        truncatedPreview: "3 matches…",
+                                    },
+                                },
+                            ],
+                        },
+                    ],
+                },
+            ],
+        },
+    });
+}
+/** Turn 3: an in-flight Build-from-plan turn. */
+function exec4() {
+    return create(AgentExecutionSchema, {
+        metadata: { id: "aex_01d" },
+        spec: {
+            sessionId: "ses_01",
+            message: "Build from plan",
+            executionConfig: { buildFromPlan: true },
+        },
+        status: {
+            phase: ExecutionPhase.EXECUTION_IN_PROGRESS,
+            startedAt: "2026-08-20T12:00:00Z",
+            messages: [{ type: MessageType.MESSAGE_AI, content: "Working on it." }],
+        },
+    });
+}
+function allExecutions() {
+    // Deliberately scrambled: assembly must restore ULID order.
+    return [exec3(), exec1(), exec4(), exec2()];
+}
+const RESOLVED = {
+    "artifacts/aex_01a/toolcalls/tc_2.txt": {
+        storageKey: "artifacts/aex_01a/toolcalls/tc_2.txt",
+        content: "package retry\n\nfunc Do() {}",
+        truncated: false,
+        totalSizeBytes: 2048,
+        mimeType: "text/plain",
+        isImage: false,
+    },
+    "artifacts/aex_01a/toolcalls/tc_3.png": {
+        storageKey: "artifacts/aex_01a/toolcalls/tc_3.png",
+        truncated: false,
+        totalSizeBytes: 4096,
+        mimeType: "image/png",
+        isImage: true,
+    },
+    "artifacts/aex_01c/toolcalls/tc_sa_1.txt": {
+        storageKey: "artifacts/aex_01c/toolcalls/tc_sa_1.txt",
+        content: "3 matches in test/",
+        truncated: false,
+        totalSizeBytes: 64,
+        mimeType: "text/plain",
+        isImage: false,
+    },
+};
+// ---------------------------------------------------------------------------
+// Assembly
+// ---------------------------------------------------------------------------
+describe("assembleSessionTranscript", () => {
+    it("orders turns chronologically by ULID regardless of input order", () => {
+        const t = assembleSessionTranscript(session(), allExecutions());
+        expect(t.turns.map((x) => x.execution.metadata?.id)).toEqual([
+            "aex_01a",
+            "aex_01c",
+            "aex_01d",
+        ]);
+    });
+    it("excludes superseded turns by default, matching the conversation view", () => {
+        const t = assembleSessionTranscript(session(), allExecutions());
+        expect(t.turns.some((x) => x.execution.metadata?.id === "aex_01b")).toBe(false);
+        expect(t.includesSuperseded).toBe(false);
+    });
+    it("keeps superseded turns, marked, when includeSuperseded is set", () => {
+        const t = assembleSessionTranscript(session(), allExecutions(), {
+            includeSuperseded: true,
+        });
+        const ids = t.turns.map((x) => x.execution.metadata?.id);
+        expect(ids).toEqual(["aex_01a", "aex_01b", "aex_01c", "aex_01d"]);
+        expect(t.turns.map((x) => x.superseded)).toEqual([
+            false,
+            true,
+            false,
+            false,
+        ]);
+    });
+    it("synthesizes user prompts by the shared rule", () => {
+        const t = assembleSessionTranscript(session(), allExecutions());
+        expect(t.turns[0].userPrompt).toBe("Why is CI red?");
+        // Build-from-plan: machine label, no user prose.
+        expect(t.turns[2].userPrompt).toBeNull();
+        expect(t.turns[2].isBuildFromPlan).toBe(true);
+    });
+    it("suppresses the 'execute' placeholder prompt", () => {
+        const exec = create(AgentExecutionSchema, {
+            metadata: { id: "aex_x" },
+            spec: { sessionId: "ses_01", message: "execute" },
+            status: { phase: ExecutionPhase.EXECUTION_COMPLETED },
+        });
+        const t = assembleSessionTranscript(session(), [exec]);
+        expect(t.turns[0].userPrompt).toBeNull();
+        expect(t.turns[0].isBuildFromPlan).toBe(false);
+    });
+    it("marks non-terminal executions in progress", () => {
+        const t = assembleSessionTranscript(session(), allExecutions());
+        expect(t.turns.map((x) => x.inProgress)).toEqual([false, false, true]);
+    });
+});
+function fakeArtifactClient(contentByKey) {
+    const requests = [];
+    return {
+        requests,
+        client: {
+            agentExecution: {
+                listBySession: () => Promise.reject(new Error("not under test")),
+                getArtifactContent: (input) => {
+                    requests.push(input);
+                    const entry = contentByKey[input.storageKey];
+                    if (entry === undefined) {
+                        return Promise.reject(new Error(`no such key: ${input.storageKey}`));
+                    }
+                    if (entry instanceof Error)
+                        return Promise.reject(entry);
+                    return Promise.resolve(create(GetArtifactContentResponseSchema, {
+                        content: new TextEncoder().encode(entry.content),
+                        truncated: entry.truncated ?? false,
+                        totalSizeBytes: BigInt(entry.totalSizeBytes ?? entry.content.length),
+                    }));
+                },
+            },
+        },
+    };
+}
+describe("resolveOffloadedOutputs", () => {
+    it("resolves parent and sub-agent refs, deriving each execution id from the storage key", async () => {
+        const { client, requests } = fakeArtifactClient({
+            "artifacts/aex_01a/toolcalls/tc_2.txt": { content: "full file" },
+            "artifacts/aex_01c/toolcalls/tc_sa_1.txt": { content: "3 matches in test/" },
+        });
+        const resolved = await resolveOffloadedOutputs(client, allExecutions());
+        expect(resolved["artifacts/aex_01a/toolcalls/tc_2.txt"].content).toBe("full file");
+        // The sub-agent's ref (nested in exec3's sub_agent_executions) resolved
+        // under the PARENT execution's id, taken from the key itself.
+        const subAgentRequest = requests.find((r) => r.storageKey === "artifacts/aex_01c/toolcalls/tc_sa_1.txt");
+        expect(subAgentRequest?.executionId).toBe("aex_01c");
+    });
+    it("never fetches image refs, but records them for the serializers", async () => {
+        const { client, requests } = fakeArtifactClient({
+            "artifacts/aex_01a/toolcalls/tc_2.txt": { content: "full file" },
+            "artifacts/aex_01c/toolcalls/tc_sa_1.txt": { content: "x" },
+        });
+        const resolved = await resolveOffloadedOutputs(client, allExecutions());
+        const imageKey = "artifacts/aex_01a/toolcalls/tc_3.png";
+        expect(requests.some((r) => r.storageKey === imageKey)).toBe(false);
+        expect(resolved[imageKey]).toMatchObject({
+            isImage: true,
+            mimeType: "image/png",
+            totalSizeBytes: 4096,
+        });
+    });
+    it("tolerates individual fetch failures — the rest still resolve", async () => {
+        const { client } = fakeArtifactClient({
+            "artifacts/aex_01a/toolcalls/tc_2.txt": new Error("storage unavailable"),
+            "artifacts/aex_01c/toolcalls/tc_sa_1.txt": { content: "3 matches in test/" },
+        });
+        const resolved = await resolveOffloadedOutputs(client, allExecutions());
+        expect(resolved["artifacts/aex_01a/toolcalls/tc_2.txt"].error).toBe("storage unavailable");
+        expect(resolved["artifacts/aex_01a/toolcalls/tc_2.txt"].content).toBeUndefined();
+        expect(resolved["artifacts/aex_01c/toolcalls/tc_sa_1.txt"].content).toBe("3 matches in test/");
+    });
+    it("carries the server's truncation flag and true size", async () => {
+        const { client } = fakeArtifactClient({
+            "artifacts/aex_01a/toolcalls/tc_2.txt": {
+                content: "first half…",
+                truncated: true,
+                totalSizeBytes: 1048576,
+            },
+            "artifacts/aex_01c/toolcalls/tc_sa_1.txt": { content: "x" },
+        });
+        const resolved = await resolveOffloadedOutputs(client, allExecutions());
+        expect(resolved["artifacts/aex_01a/toolcalls/tc_2.txt"]).toMatchObject({
+            truncated: true,
+            totalSizeBytes: 1048576,
+        });
+    });
+});
+// ---------------------------------------------------------------------------
+// Fetch
+// ---------------------------------------------------------------------------
+describe("fetchSessionTranscript", () => {
+    function fakeClient(overrides) {
+        const artifacts = fakeArtifactClient({
+            "artifacts/aex_01a/toolcalls/tc_2.txt": { content: "full file" },
+            "artifacts/aex_01c/toolcalls/tc_sa_1.txt": { content: "3 matches" },
+        });
+        return {
+            session: { get: (id) => Promise.resolve(session()) },
+            agentExecution: {
+                ...artifacts.client.agentExecution,
+                listBySession: () => Promise.resolve(create(AgentExecutionListSchema, {
+                    totalPages: overrides?.totalPages ?? 1,
+                    entries: allExecutions(),
+                })),
+            },
+        };
+    }
+    it("assembles the full transcript with outputs resolved", async () => {
+        const t = await fetchSessionTranscript(fakeClient(), "ses_01");
+        expect(t.turns).toHaveLength(3);
+        expect(t.resolvedOutputs["artifacts/aex_01a/toolcalls/tc_2.txt"].content).toBe("full file");
+    });
+    it("skips output resolution when disabled", async () => {
+        const t = await fetchSessionTranscript(fakeClient(), "ses_01", {
+            resolveOutputs: false,
+        });
+        expect(Object.keys(t.resolvedOutputs)).toHaveLength(0);
+    });
+    it("refuses to export a silently truncated conversation if the server ever paginates", async () => {
+        await expect(fetchSessionTranscript(fakeClient({ totalPages: 2 }), "ses_01")).rejects.toThrow(/2 pages .* single page/s);
+    });
+});
+// ---------------------------------------------------------------------------
+// Markdown
+// ---------------------------------------------------------------------------
+describe("transcriptToMarkdown", () => {
+    it("matches the pinned format contract (transcript.golden.md)", () => {
+        const t = assembleSessionTranscript(session(), allExecutions(), {
+            resolvedOutputs: RESOLVED,
+        });
+        const goldenPath = resolve(here, "transcript.golden.md");
+        const actual = transcriptToMarkdown(t);
+        if (process.env.UPDATE_TRANSCRIPT_GOLDEN) {
+            writeFileSync(goldenPath, actual);
+        }
+        expect(actual).toBe(readFileSync(goldenPath, "utf8"));
+    });
+    it("stamps the export time only when provided", () => {
+        const t = assembleSessionTranscript(session(), [exec1()]);
+        expect(transcriptToMarkdown(t)).not.toContain("Exported:");
+        expect(transcriptToMarkdown(t, { generatedAt: "2026-08-22T06:00:00Z" })).toContain("- Exported: 2026-08-22T06:00:00Z");
+    });
+    it("falls back to the ref's preview, with an honest note, when an output is unresolved", () => {
+        const t = assembleSessionTranscript(session(), [exec1()]);
+        const md = transcriptToMarkdown(t);
+        expect(md).toContain("_Offloaded output not resolved — showing preview._");
+        expect(md).toContain("package retry…");
+    });
+    it("notes the fetch failure when resolution was attempted and failed", () => {
+        const t = assembleSessionTranscript(session(), [exec1()], {
+            resolvedOutputs: {
+                "artifacts/aex_01a/toolcalls/tc_2.txt": {
+                    storageKey: "artifacts/aex_01a/toolcalls/tc_2.txt",
+                    truncated: false,
+                    mimeType: "text/plain",
+                    isImage: false,
+                    error: "storage unavailable",
+                },
+            },
+        });
+        expect(transcriptToMarkdown(t)).toContain("_Offloaded output unavailable (storage unavailable) — showing preview._");
+    });
+    it("marks server-truncated outputs with the byte counts", () => {
+        const t = assembleSessionTranscript(session(), [exec1()], {
+            resolvedOutputs: {
+                "artifacts/aex_01a/toolcalls/tc_2.txt": {
+                    storageKey: "artifacts/aex_01a/toolcalls/tc_2.txt",
+                    content: "0123456789",
+                    truncated: true,
+                    totalSizeBytes: 1048576,
+                    mimeType: "text/plain",
+                    isImage: false,
+                },
+            },
+        });
+        expect(transcriptToMarkdown(t)).toContain("_Output truncated at 10 of 1048576 bytes (server content cap)._");
+    });
+    it("sizes fences past backtick runs in the content", () => {
+        const exec = create(AgentExecutionSchema, {
+            metadata: { id: "aex_x" },
+            spec: { sessionId: "ses_01", message: "prompt" },
+            status: {
+                phase: ExecutionPhase.EXECUTION_COMPLETED,
+                messages: [
+                    {
+                        type: MessageType.MESSAGE_AI,
+                        content: "",
+                        toolCalls: [
+                            {
+                                id: "tc",
+                                name: "shell_command",
+                                result: "a fence: ```md\ninside\n```",
+                                status: ToolCallStatus.TOOL_CALL_COMPLETED,
+                            },
+                        ],
+                    },
+                ],
+            },
+        });
+        const md = transcriptToMarkdown(assembleSessionTranscript(session(), [exec]));
+        expect(md).toContain("````\na fence: ```md\ninside\n```\n````");
+    });
+    it("marks kept superseded turns", () => {
+        const t = assembleSessionTranscript(session(), allExecutions(), {
+            includeSuperseded: true,
+        });
+        const md = transcriptToMarkdown(t);
+        expect(md).toContain("- Includes superseded (edited-and-resubmitted) turns");
+        expect(md).toContain("_Superseded by an edited resubmission._");
+        expect(md).toContain("old prompt");
+    });
+});
+// ---------------------------------------------------------------------------
+// JSON
+// ---------------------------------------------------------------------------
+describe("transcriptToJson", () => {
+    it("is JSON.stringify-safe despite bigint proto fields (protojson contract)", () => {
+        const t = assembleSessionTranscript(session(), allExecutions(), {
+            resolvedOutputs: RESOLVED,
+        });
+        // sizeBytes is int64 → bigint on the proto; a raw stringify of the
+        // transcript would throw. The projection must not.
+        const text = JSON.stringify(transcriptToJson(t), null, 2);
+        const parsed = JSON.parse(text);
+        expect(parsed.format).toBe("stigmer.ai/session-transcript/v1");
+        expect(parsed.session.metadata.id).toBe("ses_01");
+        expect(parsed.turns).toHaveLength(3);
+        // protojson: snake_case field names, int64 as string.
+        expect(parsed.turns[0].execution.status.messages[3].tool_calls[0].output_ref
+            .size_bytes).toBe("2048");
+    });
+    it("carries the canonical-rule verdicts per turn", () => {
+        const t = assembleSessionTranscript(session(), allExecutions(), {
+            includeSuperseded: true,
+        });
+        const parsed = JSON.parse(JSON.stringify(transcriptToJson(t)));
+        expect(parsed.includes_superseded).toBe(true);
+        expect(parsed.turns[0].user_prompt).toBe("Why is CI red?");
+        expect(parsed.turns[1].superseded).toBe(true);
+        expect(parsed.turns[3].build_from_plan).toBe(true);
+        expect(parsed.turns[3].in_progress).toBe(true);
+    });
+    it("strips the internal Temporal callback token from execution status", () => {
+        const exec = exec1();
+        exec.status.callbackToken = new TextEncoder().encode("task-token");
+        const t = assembleSessionTranscript(session(), [exec]);
+        const parsed = JSON.parse(JSON.stringify(transcriptToJson(t)));
+        expect(parsed.turns[0].execution.status.callback_token).toBeUndefined();
+        // The strip is surgical — the rest of status is intact.
+        expect(parsed.turns[0].execution.status.messages).toHaveLength(5);
+    });
+    it("keys resolved outputs by storage key with plain-JSON fields", () => {
+        const t = assembleSessionTranscript(session(), allExecutions(), {
+            resolvedOutputs: RESOLVED,
+        });
+        const parsed = JSON.parse(JSON.stringify(transcriptToJson(t)));
+        expect(parsed.resolved_outputs["artifacts/aex_01a/toolcalls/tc_2.txt"]).toMatchObject({
+            content: "package retry\n\nfunc Do() {}",
+            mime_type: "text/plain",
+            total_size_bytes: 2048,
+        });
+    });
+});
+//# sourceMappingURL=transcript.test.js.map

package/execution/__tests__/transcript.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.test.js","sourceRoot":"","sources":["../../../src/execution/__tests__/transcript.test.ts"],"names":[],"mappings":"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"}

package/execution/conversation-rules.d.ts

@@ -0,0 +1,64 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+/**
+ * Returns the executions in chronological (oldest-first) order — the order a
+ * conversation reads top-to-bottom.
+ *
+ * Defense-in-depth against an unordered list response: the executions ARE the
+ * transcript, so a scrambled order drops the newest turns out of view (they no
+ * longer sort to the bottom). The server orders this list, but consumers must
+ * never depend on that alone. Resource ids are time-sortable ULIDs
+ * (`aex_01k…`), so an ascending id sort is creation order without parsing
+ * timestamps; entries missing an id sort last but keep a stable relative order.
+ */
+export declare function sortChronologically(executions: readonly AgentExecution[]): AgentExecution[];
+/**
+ * Collects the ids of executions replaced via edit-and-resubmit.
+ *
+ * The successor execution carries `spec.supersedes_execution_id`; hiding the
+ * superseded turn makes the edited message read as a single corrected exchange
+ * (in-place replace). The raw execution list still contains superseded records
+ * — execution-history surfaces show them deliberately — so this is a
+ * conversation-view rule, applied by whoever renders or exports a
+ * conversation.
+ *
+ * @param extraSupersededId An id known only outside the list — the live stream
+ * copy's `supersedesExecutionId`: right after a resubmit, the successor
+ * streams before the list refetch delivers it.
+ */
+export declare function supersededExecutionIds(executions: readonly AgentExecution[], extraSupersededId?: string | null): Set<string>;
+/**
+ * `true` when the execution is a Build-from-plan turn.
+ *
+ * Such a turn's `spec.message` is a machine-written label ("Build from
+ * plan"), not user prose — the real instruction is runner-injected from the
+ * same flag. Rendering or exporting the label as a user message would
+ * attribute words to the user they never typed; the plan the turn builds from
+ * is the visible cause.
+ */
+export declare function isBuildFromPlanTurn(exec: AgentExecution): boolean;
+/**
+ * The user prose that opens an execution's turn, or `null` when the turn has
+ * none.
+ *
+ * `spec.message` is the submitted prompt, but three shapes of it are not user
+ * prose and synthesize no user turn:
+ *  - empty — nothing was typed (programmatic creates);
+ *  - the literal `"execute"` — the legacy placeholder stamped on runs started
+ *    without a message;
+ *  - a Build-from-plan turn's machine-written label (see
+ *    {@link isBuildFromPlanTurn}).
+ */
+export declare function syntheticUserPrompt(exec: AgentExecution): string | null;
+/**
+ * Extracts the execution id from an artifact storage key of the form
+ * `artifacts/{executionId}/...`. Returns `null` for an unexpected shape so the
+ * caller skips the fetch rather than issuing a request the server would
+ * reject.
+ *
+ * The fetch id must always derive from the key, never from render or export
+ * context: offloaded outputs inside a sub-agent's transcript are stored under
+ * the PARENT execution's id (the execution whose status was persisted), and
+ * the key is the record of that.
+ */
+export declare function execIdFromStorageKey(storageKey: string): string | null;
+//# sourceMappingURL=conversation-rules.d.ts.map

package/execution/conversation-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-rules.d.ts","sourceRoot":"","sources":["../../src/execution/conversation-rules.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAElG;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,SAAS,cAAc,EAAE,GACpC,cAAc,EAAE,CASlB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,SAAS,cAAc,EAAE,EACrC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,GAChC,GAAG,CAAC,MAAM,CAAC,CAQb;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAEjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAMvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMtE"}