@stigmer/runner 3.40.0 → 3.41.0

package/dist/activities/execute-deep-agent/platform-route.js

@@ -30,9 +30,18 @@
  *
  * WHEN IT IS MOUNTED
  * ------------------
- * On the turns where the workspace link points at the platform dir — the
- * turns whose skill or attachment phase made it — so what the agent can
- * reach is exactly what the link exposes to the shell on the same turn.
+ * On every turn: `.stigmer/` is the platform's name whether or not the turn
+ * mounted anything, so a write there never reaches the workspace. Before
+ * #1123 the route existed only on linked turns, and a write under `.stigmer/`
+ * on any other turn made a real directory in the user's tree that the next
+ * link displaced. What the route exposes follows the link, so the file tools
+ * reach exactly what the shell reaches on the same turn:
+ * - on a turn whose skill or attachment phase made the link, the platform dir
+ *   ({@link PlatformContentBackend});
+ * - on any other turn, nothing ({@link NoPlatformContentBackend}): the dir
+ *   still holds earlier turns' skills and inputs, which this turn's shell
+ *   cannot reach, so the file tools must not either. The root listing then
+ *   leaves `.stigmer/` out, as the tree does.
  * The link itself stays: shell commands (a skill's own scripts among them)
  * run in the workspace and resolve `.stigmer/…` through it.
  */
@@ -40,11 +49,18 @@ import { CompositeBackend, FilesystemBackend } from "deepagents";
 import { STIGMER_LOCAL_STATE_DIR, stigmerSymlinkPointsAt } from "../../shared/workspace/stigmer-link.js";
 /** The route prefix, with the trailing slash `CompositeBackend` needs to match `/.stigmer/x` but never `/.stigmerx`. */
 export const PLATFORM_ROUTE_PREFIX = `/${STIGMER_LOCAL_STATE_DIR}/`;
+/** The path as the agent named it: the route hands its backend the path with the prefix stripped. */
+function agentPath(routedPath) {
+    return `${PLATFORM_ROUTE_PREFIX.slice(0, -1)}${routedPath}`;
+}
 function readOnly(routedPath) {
-    const agentPath = `${PLATFORM_ROUTE_PREFIX.slice(0, -1)}${routedPath}`;
-    return (`Error: '${agentPath}' is platform content (skills, attached inputs, the approved plan) ` +
+    return (`Error: '${agentPath(routedPath)}' is platform content (skills, attached inputs, the approved plan) ` +
         "and is read-only; write your own files in the workspace");
 }
+function noPlatformContent(routedPath) {
+    return (`Error: '${agentPath(routedPath)}' does not exist: this turn has no platform content ` +
+        "(no skills or attached inputs)");
+}
 /** The platform dir, virtual-rooted like every native backend, refusing every mutation. */
 export class PlatformContentBackend extends FilesystemBackend {
     constructor(platformDir) {
@@ -64,18 +80,69 @@ export class PlatformContentBackend extends FilesystemBackend {
     }
 }
 /**
- * The workspace backend with the platform mounted at {@link PLATFORM_ROUTE_PREFIX}.
+ * The `.stigmer/` route on a turn that exposes no platform content: nothing
+ * to read, list or find, and every mutation refused with the same message
+ * the platform dir's route gives. It stands on no filesystem, so it cannot
+ * create or reveal anything, and `ls` answers "does not exist" rather than
+ * an empty listing because the root listing leaves `.stigmer/` out.
+ */
+export class NoPlatformContentBackend {
+    ls(path) {
+        return { error: noPlatformContent(path) };
+    }
+    read(filePath) {
+        return { error: noPlatformContent(filePath) };
+    }
+    readRaw(filePath) {
+        return { error: noPlatformContent(filePath) };
+    }
+    grep() {
+        return { matches: [] };
+    }
+    glob() {
+        return { files: [] };
+    }
+    write(filePath) {
+        return { error: readOnly(filePath) };
+    }
+    edit(filePath) {
+        return { error: readOnly(filePath) };
+    }
+    delete(filePath) {
+        return { error: readOnly(filePath) };
+    }
+    uploadFiles(files) {
+        return files.map(([path]) => ({ path, error: "permission_denied" }));
+    }
+    downloadFiles(paths) {
+        return paths.map((path) => ({ path, content: null, error: "file_not_found" }));
+    }
+}
+/**
+ * The workspace backend with `.stigmer/` routed to {@link PLATFORM_ROUTE_PREFIX}'s
+ * backend for this turn.
  *
  * One behaviour differs from the stock router: listing `/`. The composite
- * adds each route to the root listing, and the workspace backend already
- * lists `.stigmer/` by following the link, so the stock listing names the
- * same directory twice; the root listing is de-duplicated by path.
+ * adds each route to the root listing whatever the route holds. With the
+ * platform exposed, the workspace backend also lists `.stigmer/` by following
+ * the link, so the stock listing names the same directory twice and is
+ * de-duplicated by path. With nothing exposed, `.stigmer/` is left out of the
+ * root listing altogether: the route has nothing to show, and a real
+ * `.stigmer` the workspace may hold is unreachable behind it.
  */
 export class PlatformRoutedBackend extends CompositeBackend {
+    exposesPlatform;
+    constructor(backend, platform) {
+        super(backend, { [PLATFORM_ROUTE_PREFIX]: platform });
+        this.exposesPlatform = platform instanceof PlatformContentBackend;
+    }
     async ls(path) {
         const result = await super.ls(path);
         if (path !== "/" || !result.files)
             return result;
+        if (!this.exposesPlatform) {
+            return { ...result, files: result.files.filter((entry) => entry.path !== PLATFORM_ROUTE_PREFIX) };
+        }
         const seen = new Set();
         return {
             ...result,
@@ -89,19 +156,20 @@ export class PlatformRoutedBackend extends CompositeBackend {
     }
 }
 /**
- * Mount the platform route over `backend` when this turn exposes platform
- * content; otherwise hand `backend` back unchanged. `execute` and the
- * sandbox identity stay the workspace backend's (`CompositeBackend` delegates
- * both to its default), so a shell-capable graph keeps its `execute` tool and
- * a plan-mode graph stays without one.
+ * Mount the `.stigmer/` route over `backend` for this turn: the platform dir
+ * when the workspace link points at it, the empty route otherwise. Only a
+ * session without a platform dir gets `backend` back unchanged. `execute`
+ * and the sandbox identity stay the workspace backend's (`CompositeBackend`
+ * delegates both to its default), so a shell-capable graph keeps its
+ * `execute` tool and a plan-mode graph stays without one.
  */
 export async function mountPlatformRoute(backend, options) {
     const { workspaceDir, platformDir } = options;
-    if (platformDir === undefined || !(await stigmerSymlinkPointsAt(workspaceDir, platformDir))) {
+    if (platformDir === undefined)
         return backend;
-    }
-    return new PlatformRoutedBackend(backend, {
-        [PLATFORM_ROUTE_PREFIX]: new PlatformContentBackend(platformDir),
-    });
+    const platform = (await stigmerSymlinkPointsAt(workspaceDir, platformDir))
+        ? new PlatformContentBackend(platformDir)
+        : new NoPlatformContentBackend();
+    return new PlatformRoutedBackend(backend, platform);
 }
 //# sourceMappingURL=platform-route.js.map

package/dist/activities/execute-deep-agent/platform-route.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform-route.js","sourceRoot":"","sources":["../../../src/activities/execute-deep-agent/platform-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AASjE,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAEzG,wHAAwH;AACxH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,uBAAuB,GAAG,CAAC;AAEpE,SAAS,QAAQ,CAAC,UAAkB;IAClC,MAAM,SAAS,GAAG,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,EAAE,CAAC;IACvE,OAAO,CACL,WAAW,SAAS,qEAAqE;QACzF,yDAAyD,CAC1D,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,OAAO,sBAAuB,SAAQ,iBAAiB;IAC3D,YAAY,WAAmB;QAC7B,KAAK,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAEQ,KAAK,CAAC,KAAK,CAAC,QAAgB;QACnC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IACvC,CAAC;IAEQ,KAAK,CAAC,IAAI,CAAC,QAAgB;QAClC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IACvC,CAAC;IAEQ,KAAK,CAAC,MAAM,CAAC,QAAgB;QACpC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IACvC,CAAC;IAEQ,KAAK,CAAC,WAAW,CAAC,KAAkC;QAC3D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC;IACvE,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAsB,SAAQ,gBAAgB;IAChD,KAAK,CAAC,EAAE,CAAC,IAAY;QAC5B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO,MAAM,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,OAAO;YACL,GAAG,MAAM;YACT,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;gBACnC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACvC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACrB,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;SACH,CAAC;IACJ,CAAC;CACF;AASD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA2B,EAC3B,OAA6B;IAE7B,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAC9C,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,sBAAsB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QAC5F,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,qBAAqB,CAAC,OAAO,EAAE;QACxC,CAAC,qBAAqB,CAAC,EAAE,IAAI,sBAAsB,CAAC,WAAW,CAAC;KACjE,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"platform-route.js","sourceRoot":"","sources":["../../../src/activities/execute-deep-agent/platform-route.ts"],"names":[],"mappings":"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"}

package/dist/activities/execute-deep-agent/prompt-builder.d.ts

@@ -1,19 +1,32 @@
 /**
- * The native harness's system prompt: what `createDeepAgent` receives as
- * `systemPrompt`, rebuilt on EVERY invocation (never checkpointed with the
- * message history), so every standing fact is injected on every turn by
- * design — a first-turn-only injection would vanish from turn 2 onward.
+ * The native harness's prompt: the system prompt `createDeepAgent` receives
+ * as `systemPrompt`, and the turn's user message.
+ *
+ * The system prompt is rebuilt on EVERY invocation (never checkpointed with
+ * the message history), so every standing fact is injected on every turn by
+ * design — a first-turn-only injection would vanish from turn 2 onward. It is
+ * a function of the session and of the execution's settings (its mode), never
+ * of the turn. The provider caches tools, system and messages as one prefix,
+ * so a system byte that follows the message re-writes the cached prompt and
+ * the whole conversation after it, on every turn, at the cache-write price.
+ * What belongs to one turn — its input files, the workspace paths it
+ * references, the conversation catchup — rides that turn's user message
+ * (`composeUserMessage`), which enters the checkpointer with the turn and
+ * stays in history. That is the Cursor harness's resumed-turn placement
+ * (`execute-cursor/prompt-builder.ts` `buildPrompt`) and the runner's rule
+ * that user content goes in user messages, never the system prompt.
  *
  * Pure functions: no side effects, no I/O. `turn-setup.ts` gathers the
  * inputs from the runtime's resolved record and this module renders them.
  *
  * What is this harness's and what is shared (since #1096):
  *  - Shared through `shared/prompt-sections.ts`: WHICH standing sections
- *    render and in WHAT order (`standingContextSections`), the input-files
- *    bullet and disclosure lines (`inputFileLines`), which skills a prompt
- *    highlights (`selectSkillsForPrompt`, called from `turn-setup.ts`) and
- *    the also-available sentence. Their WORDS come from each fact's own
- *    module; this builder only frames them.
+ *    render and in WHAT order (`standingContextSections`) and the
+ *    input-files bullet and disclosure lines (`inputFileLines`). Their WORDS
+ *    come from each fact's own module; this builder only frames them. Every
+ *    mounted skill is described on every turn, as the Cursor harness does:
+ *    choosing skills by the message made the system prompt follow the
+ *    message.
  *  - This harness's: the framing — `## Heading` markdown sections, the house
  *    style for a system prompt — and every text that quotes this engine's
  *    tools: the `## Skills` activation protocol, the response rules, the
@@ -24,7 +37,8 @@
  *
  * The rendered bytes are load-bearing for the hermetic tests: `ScriptedModel`
  * tells its scripted roles apart by the system prompt's text, so this
- * module's whole output is pinned by `__tests__/prompt-goldens.test.ts`.
+ * module's whole output — the system prompt and the turn's message — is
+ * pinned by `__tests__/prompt-goldens.test.ts`.
  */
 import { InteractionMode } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 import type { ProvisionResult } from "../../shared/workspace/types.js";
@@ -47,22 +61,6 @@ export interface PromptBuilderInput {
      * when the agent serves no proactive channel or nothing is sendable.
      */
     channelTemplatesPromptSection?: string;
-    workspaceFileRefs: string[];
-    workspaceRoot: string;
-    /** The turn's resolved input files, as the runtime's attachment phase returns them. */
-    inputFiles: readonly ResolvedAttachment[];
-    /**
-     * Vision facts about this turn's attachments (T04): which images the model
-     * sees inline in the user message and which degraded to path-only.
-     * Rendered inside the Input Files section.
-     */
-    vision?: VisionPromptInfo;
-    /**
-     * What kind of URL the turn's storage backend mints (issue #532) — keys
-     * the Input Files section's hand-off wording (attachment-download-urls.ts).
-     * One turn-level fact: all attachments ride the one configured storage.
-     */
-    downloadUrlKind?: DownloadUrlKind;
     /**
      * The execution's interaction mode. PLAN appends the shared plan-mode
      * directive so the model knows the turn's deliverable is a plan document.
@@ -79,6 +77,14 @@ export interface PromptBuilderInput {
      * message itself is just a short label ("Build from plan").
      */
     buildFromPlan?: boolean;
+    /**
+     * The approved plan's path among the turn's input files
+     * (`implement-plan-prompt.ts` `findApprovedPlanPath`), read only under
+     * `buildFromPlan`. Absent when the plan did not materialize, which selects
+     * the directive's conversation-plan variant. The Input Files section
+     * itself rides the turn's message (`composeUserMessage`).
+     */
+    approvedPlanPath?: string;
     /**
      * Rollover context bridge (cloud DD-013): a digest of the previous
      * session's conversation, read from `SessionSpec.metadata`. Injected on
@@ -128,17 +134,46 @@ export type { VisionPromptInfo };
  * sections. Pure function with no I/O.
  */
 export declare function buildEnhancedSystemPrompt(input: PromptBuilderInput): string;
+/** The turn's own content, composed around what the user typed. */
+export interface TurnMessageInput {
+    /** What the user typed (`spec.message`); never mutated. */
+    readonly message: string;
+    /** The conversation catchup digest (cloud DD-006), when the turn carries one. */
+    readonly conversationCatchup?: string;
+    /** This turn's resolved input files, as the runtime's attachment phase returns them. */
+    readonly inputFiles: readonly ResolvedAttachment[];
+    /**
+     * Vision facts about this turn's attachments (T04): which images the model
+     * sees inline in this same message and which degraded to path-only.
+     * Rendered inside the Input Files section.
+     */
+    readonly vision?: VisionPromptInfo;
+    /**
+     * What kind of URL the turn's storage backend mints (issue #532) — keys
+     * the Input Files section's hand-off wording (attachment-download-urls.ts).
+     * One turn-level fact: all attachments ride the one configured storage.
+     */
+    readonly downloadUrlKind?: DownloadUrlKind;
+    /** The workspace paths the user highlighted for this message (`spec.workspace_file_refs`). */
+    readonly workspaceFileRefs: readonly string[];
+}
 /**
- * Compose the turn's USER MESSAGE for the graph invocation: the framed
- * conversation catchup (cloud DD-006), when present, prepended to the
- * customer's message. In the user message and never the system prompt (A27):
- * the system prompt is rebuilt per invocation and would forget the digest one
- * turn later, while a message enters the checkpointer with the turn and
- * persists in history — the same durability the cursor harness gets from its
- * prompt prefix. The caller's `spec.message` is never mutated; the prepend
- * exists only in the graph input.
+ * Compose the turn's USER MESSAGE for the graph invocation: this turn's
+ * payload (its input files, then the workspace paths it references), then the
+ * framed conversation catchup (cloud DD-006), then what the user typed, each
+ * set off by a horizontal rule. Payload first and context closest to the task
+ * is the Cursor harness's resumed-turn order.
+ *
+ * In the user message and never the system prompt (A27, and the module
+ * header): the system prompt is rebuilt per invocation, so a turn's content
+ * there would vanish one turn later and, while it lasted, change the cached
+ * prefix; a message enters the checkpointer with the turn and persists in
+ * history, so a later turn still knows which files an earlier one carried.
+ * An approval resume sends no new message and needs none: the payload is
+ * already in the checkpointed one. The caller's `spec.message` is never
+ * mutated; the composition exists only in the graph input.
  */
-export declare function composeUserMessage(message: string, conversationCatchup: string | undefined): string;
+export declare function composeUserMessage(input: TurnMessageInput): string;
 /**
  * The `## Skills` section of this harness's system prompt, rendered from the
  * runtime's mounted-skill metadata (`shared/skill-resolver.ts`

package/dist/activities/execute-deep-agent/prompt-builder.js

@@ -1,19 +1,32 @@
 /**
- * The native harness's system prompt: what `createDeepAgent` receives as
- * `systemPrompt`, rebuilt on EVERY invocation (never checkpointed with the
- * message history), so every standing fact is injected on every turn by
- * design — a first-turn-only injection would vanish from turn 2 onward.
+ * The native harness's prompt: the system prompt `createDeepAgent` receives
+ * as `systemPrompt`, and the turn's user message.
+ *
+ * The system prompt is rebuilt on EVERY invocation (never checkpointed with
+ * the message history), so every standing fact is injected on every turn by
+ * design — a first-turn-only injection would vanish from turn 2 onward. It is
+ * a function of the session and of the execution's settings (its mode), never
+ * of the turn. The provider caches tools, system and messages as one prefix,
+ * so a system byte that follows the message re-writes the cached prompt and
+ * the whole conversation after it, on every turn, at the cache-write price.
+ * What belongs to one turn — its input files, the workspace paths it
+ * references, the conversation catchup — rides that turn's user message
+ * (`composeUserMessage`), which enters the checkpointer with the turn and
+ * stays in history. That is the Cursor harness's resumed-turn placement
+ * (`execute-cursor/prompt-builder.ts` `buildPrompt`) and the runner's rule
+ * that user content goes in user messages, never the system prompt.
  *
  * Pure functions: no side effects, no I/O. `turn-setup.ts` gathers the
  * inputs from the runtime's resolved record and this module renders them.
  *
  * What is this harness's and what is shared (since #1096):
  *  - Shared through `shared/prompt-sections.ts`: WHICH standing sections
- *    render and in WHAT order (`standingContextSections`), the input-files
- *    bullet and disclosure lines (`inputFileLines`), which skills a prompt
- *    highlights (`selectSkillsForPrompt`, called from `turn-setup.ts`) and
- *    the also-available sentence. Their WORDS come from each fact's own
- *    module; this builder only frames them.
+ *    render and in WHAT order (`standingContextSections`) and the
+ *    input-files bullet and disclosure lines (`inputFileLines`). Their WORDS
+ *    come from each fact's own module; this builder only frames them. Every
+ *    mounted skill is described on every turn, as the Cursor harness does:
+ *    choosing skills by the message made the system prompt follow the
+ *    message.
  *  - This harness's: the framing — `## Heading` markdown sections, the house
  *    style for a system prompt — and every text that quotes this engine's
  *    tools: the `## Skills` activation protocol, the response rules, the
@@ -24,7 +37,8 @@
  *
  * The rendered bytes are load-bearing for the hermetic tests: `ScriptedModel`
  * tells its scripted roles apart by the system prompt's text, so this
- * module's whole output is pinned by `__tests__/prompt-goldens.test.ts`.
+ * module's whole output — the system prompt and the turn's message — is
+ * pinned by `__tests__/prompt-goldens.test.ts`.
  */
 import { relative } from "node:path";
 import { InteractionMode } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
@@ -32,7 +46,7 @@ import { formatConversationCatchupText } from "../../shared/conversation-catchup
 import { inputFileLines, standingContextSections, } from "../../shared/prompt-sections.js";
 import { effectiveInstructions } from "../../shared/builtin-assistant-prompt.js";
 import { PLAN_MODE_DIRECTIVE } from "../../shared/plan-mode-prompt.js";
-import { buildImplementPlanDirective, findApprovedPlanPath, } from "../../shared/implement-plan-prompt.js";
+import { buildImplementPlanDirective } from "../../shared/implement-plan-prompt.js";
 import { STIGMER_LOCAL_STATE_DIR } from "../../shared/workspace/stigmer-link.js";
 import { DEFAULT_MAX_CONCURRENT } from "../../shared/subagent-gate.js";
 import { ENGINE_TOOL } from "./engine-tools.js";
@@ -127,15 +141,6 @@ export function buildEnhancedSystemPrompt(input) {
     if (input.channelTemplatesPromptSection) {
         prompt += "\n\n" + input.channelTemplatesPromptSection;
     }
-    if (input.workspaceFileRefs.length > 0) {
-        const refSection = buildReferencedFilesSection(input.workspaceFileRefs, input.workspaceRoot);
-        if (refSection) {
-            prompt += refSection;
-        }
-    }
-    if (input.inputFiles.length > 0) {
-        prompt += buildInputFilesSection(input.inputFiles, input.vision, input.downloadUrlKind);
-    }
     // The standing context, in the shared order (the doctrine is stated once,
     // on `standingContextSections`); this harness only frames each section.
     for (const section of standingContextSections(input)) {
@@ -161,27 +166,41 @@ export function buildEnhancedSystemPrompt(input) {
                 "`.stigmer/` directory); paths outside it are refused.";
     }
     if (input.buildFromPlan) {
-        const planPath = findApprovedPlanPath(input.inputFiles.map((f) => f.relativePath));
         prompt +=
             "\n\n## Implement the approved plan\n\n" +
-                buildImplementPlanDirective(planPath);
+                buildImplementPlanDirective(input.approvedPlanPath);
     }
     return prompt;
 }
 /**
- * Compose the turn's USER MESSAGE for the graph invocation: the framed
- * conversation catchup (cloud DD-006), when present, prepended to the
- * customer's message. In the user message and never the system prompt (A27):
- * the system prompt is rebuilt per invocation and would forget the digest one
- * turn later, while a message enters the checkpointer with the turn and
- * persists in history — the same durability the cursor harness gets from its
- * prompt prefix. The caller's `spec.message` is never mutated; the prepend
- * exists only in the graph input.
+ * Compose the turn's USER MESSAGE for the graph invocation: this turn's
+ * payload (its input files, then the workspace paths it references), then the
+ * framed conversation catchup (cloud DD-006), then what the user typed, each
+ * set off by a horizontal rule. Payload first and context closest to the task
+ * is the Cursor harness's resumed-turn order.
+ *
+ * In the user message and never the system prompt (A27, and the module
+ * header): the system prompt is rebuilt per invocation, so a turn's content
+ * there would vanish one turn later and, while it lasted, change the cached
+ * prefix; a message enters the checkpointer with the turn and persists in
+ * history, so a later turn still knows which files an earlier one carried.
+ * An approval resume sends no new message and needs none: the payload is
+ * already in the checkpointed one. The caller's `spec.message` is never
+ * mutated; the composition exists only in the graph input.
  */
-export function composeUserMessage(message, conversationCatchup) {
-    return conversationCatchup
-        ? `${formatConversationCatchupText(conversationCatchup)}\n\n---\n\n${message}`
-        : message;
+export function composeUserMessage(input) {
+    const parts = [];
+    if (input.inputFiles.length > 0) {
+        parts.push(buildInputFilesSection(input.inputFiles, input.vision, input.downloadUrlKind));
+    }
+    if (input.workspaceFileRefs.length > 0) {
+        parts.push(buildReferencedFilesSection(input.workspaceFileRefs));
+    }
+    if (input.conversationCatchup) {
+        parts.push(formatConversationCatchupText(input.conversationCatchup));
+    }
+    parts.push(input.message);
+    return parts.join("\n\n---\n\n");
 }
 /**
  * The `## Skills` section of this harness's system prompt, rendered from the
@@ -292,13 +311,13 @@ function formatEntryDescription(result) {
             "You are operating directly on the user's files — changes are " +
             "immediate and persistent. Use git to track and verify your changes.");
     }
+    // No commit: the clone's HEAD moves with every write-back commit, and a
+    // system prompt that names it would change on every such turn
+    // (`shared/workspace/sources/git.ts` says the same for one entry).
     if (result.sourceType === "git_repo" && result.gitMetadata) {
         const meta = result.gitMetadata;
-        const shortSha = meta.baseCommit.length >= 7
-            ? meta.baseCommit.slice(0, 7)
-            : meta.baseCommit;
-        return (`Workspace entry **${name}** was initialized from ` +
-            `${meta.repoUrl} (branch: ${meta.branch}, commit: ${shortSha}).\n` +
+        const branch = meta.branch ? ` (branch: ${meta.branch})` : "";
+        return (`Workspace entry **${name}** was initialized from ${meta.repoUrl}${branch}.\n` +
             "Changes you make will be captured as artifacts when execution completes.");
     }
     if (result.sourceType === "empty") {
@@ -307,25 +326,22 @@ function formatEntryDescription(result) {
     }
     return result.workspaceDescription;
 }
-function buildReferencedFilesSection(workspaceFileRefs, _workspaceRoot) {
-    if (workspaceFileRefs.length === 0)
-        return "";
-    let section = "\n\n## Referenced Files\n\n" +
+/** The `## Referenced Files` part of the turn's message: the paths the user highlighted, one bullet each. */
+function buildReferencedFilesSection(workspaceFileRefs) {
+    return ("## Referenced Files\n\n" +
         "The user has highlighted the following workspace paths for your " +
-        `attention. Use \`${ENGINE_TOOL.readFile}\` to access file contents.\n\n`;
-    for (const refPath of workspaceFileRefs) {
-        section += `- \`${refPath}\`\n`;
-    }
-    return section;
+        `attention. Use \`${ENGINE_TOOL.readFile}\` to access file contents.\n\n` +
+        workspaceFileRefs.map((refPath) => `- \`${refPath}\``).join("\n"));
 }
 /**
- * The `## Input Files` section: this harness's intro (it names this engine's
- * file-reading tool) around the shared lines (`prompt-sections.ts` `inputFileLines`
- * says what each bullet and disclosure carries and why). Each disclosure
- * group is set off by a blank line, the markdown idiom.
+ * The `## Input Files` part of the turn's message: this harness's intro (it
+ * names this engine's file-reading tool) around the shared lines
+ * (`prompt-sections.ts` `inputFileLines` says what each bullet and disclosure
+ * carries and why). Each disclosure group is set off by a blank line, the
+ * markdown idiom.
  */
 function buildInputFilesSection(files, vision, downloadUrlKind) {
-    let section = "\n\n## Input Files\n\n";
+    let section = "## Input Files\n\n";
     section +=
         "The following files have been provided as read-only reference " +
             "material for your task. They live under `.stigmer/inputs/` and " +
@@ -344,8 +360,7 @@ function buildInputFilesSection(files, vision, downloadUrlKind) {
     if (lines.vision.length > 0) {
         section += "\n" + lines.vision.join("\n") + "\n";
     }
-    // Every section opens with its own blank line ("\n\n## ..."), so this one
-    // ends on its last line rather than adding a second blank (#1127).
+    // The part ends on its last line; the message's rule sets it off (#1127).
     return section.replace(/\n+$/, "");
 }
 //# sourceMappingURL=prompt-builder.js.map

package/dist/activities/execute-deep-agent/prompt-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../../../src/activities/execute-deep-agent/prompt-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../../../src/activities/execute-deep-agent/prompt-builder.ts"],"names":[],"mappings":"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"}

package/dist/activities/execute-deep-agent/streaming-side-effects.d.ts

@@ -16,17 +16,34 @@
  * Until #1096 the same correlation also fed the write-back
  * coordinator's per-file commit (`onFileModified`); write-back is
  * finalize-only now, the turn runtime's, so publishing is this trigger's one
- * effect. The loop (`turn-stream.ts`) drains {@link pendingPublishPromises}
- * in the settle.
+ * effect.
+ *
+ * One instance per turn, owned by the turn's transcript
+ * (`turn-stream.ts` `createDeepAgentTranscript`) and not by the stream loop,
+ * so the in-flight publishes outlive a stream that throws: the settle
+ * drains them before its safety net, and the turn's `finally`
+ * (`turn.ts`) drains them on every exit, a thrown turn included, before the
+ * runtime writes the terminal status (stigmer#1116). Until then the loop
+ * built this and handed the list out only on its return values, so a turn
+ * that threw left its uploads to land on a status already persisted for the
+ * last time.
  */
 import type { TranscriptEvent } from "../../harness/transcript/events.js";
 import type { InlinePublisher } from "./inline-publisher.js";
 export declare class StreamingSideEffects {
     private readonly inputCache;
     private readonly inlinePublisher;
-    readonly pendingPublishPromises: Promise<void>[];
+    private readonly pending;
     constructor(opts: {
         inlinePublisher?: InlinePublisher;
     });
+    /** The publishes fired so far, in order; each resolves (a publish logs and swallows its own failure). */
+    get pendingPublishPromises(): readonly Promise<void>[];
+    /**
+     * Wait for every publish fired so far to land on the status. Idempotent:
+     * a second call over settled publishes returns at once. Bounded by the
+     * artifact storage's own per-call timeouts, as every drain has been.
+     */
+    drainPublishes(): Promise<void>;
     onEvent(event: TranscriptEvent): void;
 }