@stigmer/runner 3.15.1 → 3.15.2-dev.20260913223433

package/dist/shared/prompt-sections.d.ts

@@ -0,0 +1,163 @@
+/**
+ * The prompt glue both harnesses share: WHICH sections, in WHAT order, with
+ * WHICH lines — never the framing, never the placement.
+ *
+ * The doctrine is `plan-mode-prompt.ts`'s: "the framing is house style; the
+ * words are shared." Every section BODY already has one home
+ * (`sender-identity.ts`, `declared-preferences.ts`, `recalled-memories.ts`,
+ * `session-context.ts`, `context-bridge.ts`, `attachment-vision.ts`,
+ * `attachment-download-urls.ts`). What the two prompt builders duplicated
+ * until S3 M5 (Q-S3-10, Q-M2b-8) was the glue around those bodies: the order
+ * the five standing sections read in, with the same doctrine comments written
+ * twice; the input-files bullet and disclosure lines; which skills a prompt
+ * highlights when there are many. This module is that glue, written once.
+ *
+ * What stays with each harness, on purpose:
+ *  - Framing and placement. The native harness renders `## Heading` sections
+ *    into a system prompt rebuilt on every turn; the Cursor harness renders
+ *    `<xml_tag>` sections into the FIRST user message of a session
+ *    (`capabilities.systemPrompt` is the declared reason). Each builder maps a
+ *    section `kind` to its own label (`Record<StandingSectionKind, string>`,
+ *    exhaustive by the compiler) and wraps the body itself. This module never
+ *    learns a heading or a tag.
+ *  - Words that quote an engine's tools: the native `## Skills` activation
+ *    protocol (`read`, `execute(...)`) and Cursor's `<available_skills>` line
+ *    (`the Read tool`); the response rules; the sub-agent rules; the
+ *    structured-output directives (two mechanisms, two texts); Cursor's
+ *    tool-approval protocol, which exists because of Cursor's gate model and
+ *    would be false on a harness that interrupts before a tool runs.
+ *
+ * Fences: nothing under `shared/` imports `harness/` (and
+ * `harness/__tests__/import-direction.test.ts` forbids `shared/` reaching
+ * `activities/`), so every function here takes a plain struct that both
+ * builders' option objects satisfy structurally — never `TurnInput`. Pure:
+ * no I/O, no logging (a builder that wants to log what the selection did
+ * does so at its own call site).
+ */
+import type { ResolvedAttachment } from "./attachment-resolver.js";
+import { type NotViewableEntry } from "./attachment-vision.js";
+import { type DownloadUrlKind } from "./attachment-download-urls.js";
+import { type DeclaredPreferencesContent } from "./declared-preferences.js";
+import { type RecalledMemoriesContent } from "./recalled-memories.js";
+import { type SenderIdentity } from "./sender-identity.js";
+import type { SkillMetadata } from "./skill-resolver.js";
+/**
+ * The standing sections a prompt may carry, in the order they read. A builder
+ * labels each kind in its own vocabulary; adding a kind here fails every
+ * builder's label map until it names the new section — the point of a closed
+ * union over a bag of optional fields.
+ */
+export type StandingSectionKind = "conversation-sender" | "declared-preferences" | "recalled-memories" | "session-context" | "previous-conversation";
+export interface StandingSection {
+    readonly kind: StandingSectionKind;
+    /** The section's words, from the body's own module; the builder frames them. */
+    readonly body: string;
+}
+/**
+ * The standing facts as both builders already hold them (their option
+ * objects satisfy this structurally). Every field optional: an absent value
+ * renders no section, so a runner predating a fact simply says nothing.
+ */
+export interface StandingPromptContext {
+    readonly senderIdentity?: SenderIdentity;
+    readonly declaredPreferences?: DeclaredPreferencesContent;
+    readonly recalledMemories?: RecalledMemoriesContent;
+    readonly sessionContext?: string;
+    readonly contextBridge?: string;
+}
+/**
+ * The present standing sections in the one ruled order. The order is the
+ * doctrine, stated once:
+ *
+ *  1. The conversation sender first: standing context about WHO the
+ *     conversation is with, which everything after may refer back to.
+ *  2. Platform-declared standing facts precede embedder-supplied context
+ *     (DD-002 D3): both are standing background, but the declared preferences
+ *     are platform-authored while session context is the embedder's overlay —
+ *     the more specific overlay reads later and naturally refines.
+ *  3. Declared-by-humans precedes learned-and-confirmed (DD-006 D4): both are
+ *     platform-authored standing background, but a preference is the user's
+ *     exact words while a memory is an agent's confirmed inference — the exact
+ *     statement reads first.
+ *  4. Standing facts about the user (session context) come before the carried
+ *     conversation (bridge): the bridge may refer back to them.
+ *
+ * Where the block sits in a prompt, and on which turns, is the builder's
+ * (native: every turn, the system prompt is rebuilt; Cursor: the session's
+ * first message, the agent's own store carries it after).
+ */
+export declare function standingContextSections(standing: StandingPromptContext): readonly StandingSection[];
+/**
+ * Which images ride the user message inline (in send order) and which
+ * degraded to the file-pointer story — the vision facts a prompt discloses
+ * beside its input files (`attachment-vision.ts` owns the wording). Derived
+ * per turn from the resolved attachments; never carried across turns.
+ */
+export interface VisionPromptInfo {
+    readonly inlineFilenames: readonly string[];
+    readonly notViewable: readonly NotViewableEntry[];
+}
+/**
+ * The vision facts as the runtime's attachment phase resolves them (the
+ * `TurnInput.attachments` shape, structurally): the inline images in send
+ * order and the ones that degraded. `undefined` when the turn has neither, so
+ * the section renders no vision lines at all rather than an empty disclosure.
+ */
+export declare function visionPromptInfoOf(attachments: {
+    readonly visionImages: readonly {
+        readonly filename: string;
+    }[];
+    readonly visionNotViewable: readonly NotViewableEntry[];
+}): VisionPromptInfo | undefined;
+/** The input-files section's lines; the builder supplies the intro and the frame. */
+export interface InputFileLines {
+    /** One bullet per file: path, size, the rename disclosure, the download URL. */
+    readonly entries: readonly string[];
+    /** The URL hand-off line, present only when some listed file carries a URL. */
+    readonly urlHandoff: string | undefined;
+    /** The vision disclosure lines; empty when the turn carries no vision facts. */
+    readonly vision: readonly string[];
+}
+/**
+ * The input-files lines over the runtime's own `ResolvedAttachment` — one
+ * type, one truth (a structural twin once lived in each builder; native's
+ * silently dropped the size, Cursor's was deleted at S3 M5, Q-M5-5).
+ *
+ * Each bullet discloses the size (so the agent can weigh a read — the field's
+ * own stated purpose; Cursor's line gained it at S3 M5, Q-M5-3), the original
+ * name of a duplicate-renamed file (`attachment-naming.ts`; so the agent can
+ * connect "the two report.pdfs" in the user's message to distinct files on
+ * disk), and the download URL when one was minted
+ * (`attachment-download-urls.ts`; for the remote hand-off story). The URL
+ * hand-off line renders only when some listed file actually carries a URL —
+ * its wording keys on what kind of URL the storage backend mints. The vision
+ * lines tell the model which of these files it can already SEE inline versus
+ * which degraded to path-only; without them an agent silently ignores a photo
+ * the user believes it can see.
+ */
+export declare function inputFileLines(files: readonly ResolvedAttachment[], vision: VisionPromptInfo | undefined, downloadUrlKind: DownloadUrlKind | undefined): InputFileLines;
+/** Which mounted skills a prompt highlights, and which it only names. */
+export interface SkillSelection {
+    /** The skills the prompt describes in full, in the filter's order. */
+    readonly highlighted: readonly SkillMetadata[];
+    /** The names of the skills left out of the highlighted set; empty below the threshold. */
+    readonly alsoAvailable: readonly string[];
+}
+/**
+ * The relevance selection over the turn's message (`skill-relevance.ts`):
+ * below `SKILL_COUNT_THRESHOLD` every skill is highlighted; at and above it,
+ * the skills the message's terms reach are highlighted and the rest are
+ * named, so the agent can still activate one on its own judgement (the Agent
+ * Skills spec's progressive disclosure: metadata up front, instructions on
+ * demand). The native harness calls this on every turn; the Cursor harness
+ * lists every skill today and its adoption is S4's (Q-M5-4).
+ */
+export declare function selectSkillsForPrompt(userMessage: string, skills: readonly SkillMetadata[]): SkillSelection;
+/**
+ * The tool-neutral sentence that names the skills a prompt did not highlight
+ * (`SkillSelection.alsoAvailable`), so the agent can activate one by reading
+ * its SKILL.md at the mounted path. The sentence names no tool, so it serves
+ * any harness; the heading above it is the builder's framing. Empty for no
+ * names.
+ */
+export declare function alsoAvailableSkillsNote(excludedNames: readonly string[]): string;

package/dist/shared/prompt-sections.js

@@ -0,0 +1,164 @@
+/**
+ * The prompt glue both harnesses share: WHICH sections, in WHAT order, with
+ * WHICH lines — never the framing, never the placement.
+ *
+ * The doctrine is `plan-mode-prompt.ts`'s: "the framing is house style; the
+ * words are shared." Every section BODY already has one home
+ * (`sender-identity.ts`, `declared-preferences.ts`, `recalled-memories.ts`,
+ * `session-context.ts`, `context-bridge.ts`, `attachment-vision.ts`,
+ * `attachment-download-urls.ts`). What the two prompt builders duplicated
+ * until S3 M5 (Q-S3-10, Q-M2b-8) was the glue around those bodies: the order
+ * the five standing sections read in, with the same doctrine comments written
+ * twice; the input-files bullet and disclosure lines; which skills a prompt
+ * highlights when there are many. This module is that glue, written once.
+ *
+ * What stays with each harness, on purpose:
+ *  - Framing and placement. The native harness renders `## Heading` sections
+ *    into a system prompt rebuilt on every turn; the Cursor harness renders
+ *    `<xml_tag>` sections into the FIRST user message of a session
+ *    (`capabilities.systemPrompt` is the declared reason). Each builder maps a
+ *    section `kind` to its own label (`Record<StandingSectionKind, string>`,
+ *    exhaustive by the compiler) and wraps the body itself. This module never
+ *    learns a heading or a tag.
+ *  - Words that quote an engine's tools: the native `## Skills` activation
+ *    protocol (`read`, `execute(...)`) and Cursor's `<available_skills>` line
+ *    (`the Read tool`); the response rules; the sub-agent rules; the
+ *    structured-output directives (two mechanisms, two texts); Cursor's
+ *    tool-approval protocol, which exists because of Cursor's gate model and
+ *    would be false on a harness that interrupts before a tool runs.
+ *
+ * Fences: nothing under `shared/` imports `harness/` (and
+ * `harness/__tests__/import-direction.test.ts` forbids `shared/` reaching
+ * `activities/`), so every function here takes a plain struct that both
+ * builders' option objects satisfy structurally — never `TurnInput`. Pure:
+ * no I/O, no logging (a builder that wants to log what the selection did
+ * does so at its own call site).
+ */
+import { visionDisclosureLines } from "./attachment-vision.js";
+import { downloadUrlDisclosureLine } from "./attachment-download-urls.js";
+import { formatContextBridgeText } from "./context-bridge.js";
+import { formatDeclaredPreferencesText } from "./declared-preferences.js";
+import { formatRecalledMemoriesText } from "./recalled-memories.js";
+import { formatSenderIdentityText } from "./sender-identity.js";
+import { formatSessionContextText } from "./session-context.js";
+import { filterSkills } from "./skill-relevance.js";
+import { STIGMER_LOCAL_STATE_DIR } from "./workspace/stigmer-link.js";
+/**
+ * The present standing sections in the one ruled order. The order is the
+ * doctrine, stated once:
+ *
+ *  1. The conversation sender first: standing context about WHO the
+ *     conversation is with, which everything after may refer back to.
+ *  2. Platform-declared standing facts precede embedder-supplied context
+ *     (DD-002 D3): both are standing background, but the declared preferences
+ *     are platform-authored while session context is the embedder's overlay —
+ *     the more specific overlay reads later and naturally refines.
+ *  3. Declared-by-humans precedes learned-and-confirmed (DD-006 D4): both are
+ *     platform-authored standing background, but a preference is the user's
+ *     exact words while a memory is an agent's confirmed inference — the exact
+ *     statement reads first.
+ *  4. Standing facts about the user (session context) come before the carried
+ *     conversation (bridge): the bridge may refer back to them.
+ *
+ * Where the block sits in a prompt, and on which turns, is the builder's
+ * (native: every turn, the system prompt is rebuilt; Cursor: the session's
+ * first message, the agent's own store carries it after).
+ */
+export function standingContextSections(standing) {
+    const sections = [];
+    if (standing.senderIdentity) {
+        sections.push({ kind: "conversation-sender", body: formatSenderIdentityText(standing.senderIdentity) });
+    }
+    if (standing.declaredPreferences) {
+        sections.push({ kind: "declared-preferences", body: formatDeclaredPreferencesText(standing.declaredPreferences) });
+    }
+    if (standing.recalledMemories) {
+        sections.push({ kind: "recalled-memories", body: formatRecalledMemoriesText(standing.recalledMemories) });
+    }
+    if (standing.sessionContext) {
+        sections.push({ kind: "session-context", body: formatSessionContextText(standing.sessionContext) });
+    }
+    if (standing.contextBridge) {
+        sections.push({ kind: "previous-conversation", body: formatContextBridgeText(standing.contextBridge) });
+    }
+    return sections;
+}
+/**
+ * The vision facts as the runtime's attachment phase resolves them (the
+ * `TurnInput.attachments` shape, structurally): the inline images in send
+ * order and the ones that degraded. `undefined` when the turn has neither, so
+ * the section renders no vision lines at all rather than an empty disclosure.
+ */
+export function visionPromptInfoOf(attachments) {
+    if (attachments.visionImages.length === 0 && attachments.visionNotViewable.length === 0)
+        return undefined;
+    return {
+        inlineFilenames: attachments.visionImages.map((v) => v.filename),
+        notViewable: attachments.visionNotViewable,
+    };
+}
+/**
+ * The input-files lines over the runtime's own `ResolvedAttachment` — one
+ * type, one truth (a structural twin once lived in each builder; native's
+ * silently dropped the size, Cursor's was deleted at S3 M5, Q-M5-5).
+ *
+ * Each bullet discloses the size (so the agent can weigh a read — the field's
+ * own stated purpose; Cursor's line gained it at S3 M5, Q-M5-3), the original
+ * name of a duplicate-renamed file (`attachment-naming.ts`; so the agent can
+ * connect "the two report.pdfs" in the user's message to distinct files on
+ * disk), and the download URL when one was minted
+ * (`attachment-download-urls.ts`; for the remote hand-off story). The URL
+ * hand-off line renders only when some listed file actually carries a URL —
+ * its wording keys on what kind of URL the storage backend mints. The vision
+ * lines tell the model which of these files it can already SEE inline versus
+ * which degraded to path-only; without them an agent silently ignores a photo
+ * the user believes it can see.
+ */
+export function inputFileLines(files, vision, downloadUrlKind) {
+    const entries = files.map((f) => {
+        const size = ` (${f.sizeBytes} bytes)`;
+        const rename = f.renamedFrom !== undefined ? ` (renamed from duplicate '${f.renamedFrom}')` : "";
+        const url = f.downloadUrl !== undefined ? ` — download URL: ${f.downloadUrl}` : "";
+        return `- \`${f.relativePath}\`${size}${rename}${url}`;
+    });
+    const urlHandoff = downloadUrlKind !== undefined && files.some((f) => f.downloadUrl !== undefined)
+        ? downloadUrlDisclosureLine(downloadUrlKind)
+        : undefined;
+    return {
+        entries,
+        urlHandoff,
+        vision: vision ? visionDisclosureLines(vision.inlineFilenames, vision.notViewable) : [],
+    };
+}
+/**
+ * The relevance selection over the turn's message (`skill-relevance.ts`):
+ * below `SKILL_COUNT_THRESHOLD` every skill is highlighted; at and above it,
+ * the skills the message's terms reach are highlighted and the rest are
+ * named, so the agent can still activate one on its own judgement (the Agent
+ * Skills spec's progressive disclosure: metadata up front, instructions on
+ * demand). The native harness calls this on every turn; the Cursor harness
+ * lists every skill today and its adoption is S4's (Q-M5-4).
+ */
+export function selectSkillsForPrompt(userMessage, skills) {
+    const filter = filterSkills(userMessage, skills.map((s) => s.name), skills.map((s) => s.description));
+    return {
+        highlighted: filter.includedIndices.map((i) => skills[i]),
+        alsoAvailable: filter.excludedNames,
+    };
+}
+/**
+ * The tool-neutral sentence that names the skills a prompt did not highlight
+ * (`SkillSelection.alsoAvailable`), so the agent can activate one by reading
+ * its SKILL.md at the mounted path. The sentence names no tool, so it serves
+ * any harness; the heading above it is the builder's framing. Empty for no
+ * names.
+ */
+export function alsoAvailableSkillsNote(excludedNames) {
+    if (excludedNames.length === 0)
+        return "";
+    const names = excludedNames.map((n) => `\`${n}\``).join(", ");
+    return (`These skills are installed but were not highlighted above: ${names}. ` +
+        "If you determine one of them is relevant to your task, " +
+        `read its SKILL.md at \`${STIGMER_LOCAL_STATE_DIR}/skills/<name>/SKILL.md\` to activate it.`);
+}
+//# sourceMappingURL=prompt-sections.js.map

package/dist/shared/prompt-sections.js.map

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

package/dist/shared/skill-resolver.d.ts

@@ -13,8 +13,10 @@
  * platform dir the runtime owns; the harness renders the returned metadata
  * into its prompt in its own placement. Moved from
  * `activities/execute-cursor/` at S2 M3b; the native harness's twin
- * (`skill-writer.ts` `fetchSkillsByRefs` + `mountSkills`) is what S3
- * reconciles it with.
+ * (`skill-writer.ts` `fetchSkillsByRefs` + `mountSkills`) retired at S3 M2b,
+ * and the module itself at S3 M5 — the one renderer it kept is
+ * `shared/prompt-sections.ts` `alsoAvailableSkillsNote`. This is the one
+ * skills path for every harness.
  *
  * The mount is cached by the skill's content-addressed version hash
  * (stigmer/stigmer#672): metadata is fetched on every execution (that keeps

package/dist/shared/skill-resolver.js

@@ -13,8 +13,10 @@
  * platform dir the runtime owns; the harness renders the returned metadata
  * into its prompt in its own placement. Moved from
  * `activities/execute-cursor/` at S2 M3b; the native harness's twin
- * (`skill-writer.ts` `fetchSkillsByRefs` + `mountSkills`) is what S3
- * reconciles it with.
+ * (`skill-writer.ts` `fetchSkillsByRefs` + `mountSkills`) retired at S3 M2b,
+ * and the module itself at S3 M5 — the one renderer it kept is
+ * `shared/prompt-sections.ts` `alsoAvailableSkillsNote`. This is the one
+ * skills path for every harness.
  *
  * The mount is cached by the skill's content-addressed version hash
  * (stigmer/stigmer#672): metadata is fetched on every execution (that keeps

package/dist/shared/skill-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-resolver.js","sourceRoot":"","sources":["../../src/shared/skill-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAc5F;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAqB,EACrB,SAAiC,EACjC,OAA6B;IAE7B,OAAO,CAAC,GAAG,CACT,6BAA6B,OAAO,CAAC,SAAS,IAAI;QAClD,uBAAuB,OAAO,CAAC,mBAAmB,IAAI,aAAa,IAAI;QACvE,iBAAiB,SAAS,CAAC,MAAM,IAAI;QACrC,SAAS,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,WAAW,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC/E,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACnD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,oBAAoB,CAAC,OAAO,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CACT,oCAAoC,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,OAAO,WAAW,EAAE,CACnH,CAAC;IAEF,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACxB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,qCAAqC,CAAC,CAAC;gBAChG,SAAS;YACX,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,IAAI,SAAS,CAAC;YAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACvC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC;YACpD,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YAChE,MAAM,IAAI,GAAkB;gBAC1B,IAAI;gBACJ,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,UAAU,IAAI,EAAE;gBACjD,IAAI,EAAE,IAAI,CAAC,uBAAuB,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,CAAC;aACrE,CAAC;YAEF,IAAI,WAAW,KAAK,EAAE,IAAI,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;gBACrF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,OAAO,CAAC,GAAG,CACT,oCAAoC,IAAI,aAAa,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,gCAAgC,CAC9G,CAAC;gBACF,SAAS;YACX,CAAC;YAED,IAAI,aAAqC,CAAC;YAC1C,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,CAAC;oBACH,aAAa,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAO,CAAC,kBAAkB,CAAC,CAAC;gBACnF,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,kEAAkE;oBAClE,kEAAkE;oBAClE,kEAAkE;oBAClE,OAAO,CAAC,KAAK,CACX,gDAAgD,GAAG,CAAC,GAAG,IAAI,WAAW,IAAI,GAAG,CAAC,IAAI,GAAG;wBACrF,QAAQ,KAAK,CAAC,MAAO,CAAC,kBAAkB,4CAA4C;wBACpF,0DAA0D,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CACrG,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CACV,2CAA2C,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAC9G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CACT,8BAA8B,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,kBAAkB,CACnF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"skill-resolver.js","sourceRoot":"","sources":["../../src/shared/skill-resolver.ts"],"names":[],"mappings":"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"}

package/dist/shared/tool-rounds.d.ts

@@ -13,6 +13,12 @@
  * The SAME resolved limit must feed both LangGraph's hard stop (the invoke
  * config) and the ExecutionBudgetMiddleware's wrap-up advisory, so the
  * "~80% of budget" warning and the enforcement point can never disagree.
+ *
+ * The knob and its terminal copy live together (the `cost-guard.ts` shape):
+ * when the budget is exhausted the adapter ends its turn `tool_call_limit`
+ * and the runtime's `toolCallLimitArm` writes TERMINATED with the copy
+ * below — the platform deliberately stopped the run, work is checkpointed,
+ * and the conversation continues on the next message.
  */
 export declare const SUPER_STEPS_PER_ROUND = 6;
 export declare const MIN_TOOL_ROUNDS = 10;
@@ -28,3 +34,29 @@ export declare const UNBOUNDED_ADVISORY_RECURSION_LIMIT = 6000;
  * unbounded (max_tool_rounds 0/unset — the pre-existing default posture).
  */
 export declare function resolveRecursionLimit(maxToolRounds: number | undefined): number | null;
+/**
+ * Stable prefix of the tool-call-limit terminal error. This is a cross-repo
+ * contract: consumers that need to distinguish "ran out of tool-call budget"
+ * from other TERMINATED causes (Stigmer Cloud's channel reply extractor,
+ * which shows channel users a friendly limit message instead of generic
+ * error copy) match on this prefix with `startsWith`, because
+ * AgentExecutionStatus carries no structured termination reason. Do not
+ * reword without updating them. `COST_LIMIT_ERROR_PREFIX` (`cost-guard.ts`)
+ * mirrors it.
+ */
+export declare const TOOL_CALL_LIMIT_ERROR_PREFIX = "Agent reached the tool-call limit";
+/** The terminal `status.error` for a tool-call-limit stop; the prefix is the contract, the rest is prose. */
+export declare function formatToolCallLimitError(): string;
+/**
+ * User-facing system message for a tool-call-limit stop. Honest about the
+ * limit, clear that nothing is lost; the cost-cap copy is its parallel.
+ */
+export declare const TOOL_CALL_LIMIT_USER_COPY: string;
+/**
+ * Whether an error thrown out of a LangGraph run is the graph exhausting the
+ * recursion limit `resolveRecursionLimit` placed on it — the budget's own
+ * signal, not a failure: the adapter ends the turn `tool_call_limit`.
+ * Matched by class name and message because the error class is not
+ * exported on a stable path across `@langchain/langgraph` versions.
+ */
+export declare function isGraphRecursionError(err: unknown): boolean;

package/dist/shared/tool-rounds.js

@@ -13,6 +13,12 @@
  * The SAME resolved limit must feed both LangGraph's hard stop (the invoke
  * config) and the ExecutionBudgetMiddleware's wrap-up advisory, so the
  * "~80% of budget" warning and the enforcement point can never disagree.
+ *
+ * The knob and its terminal copy live together (the `cost-guard.ts` shape):
+ * when the budget is exhausted the adapter ends its turn `tool_call_limit`
+ * and the runtime's `toolCallLimitArm` writes TERMINATED with the copy
+ * below — the platform deliberately stopped the run, work is checkpointed,
+ * and the conversation continues on the next message.
  */
 export const SUPER_STEPS_PER_ROUND = 6;
 export const MIN_TOOL_ROUNDS = 10;
@@ -46,4 +52,41 @@ function clampToolRounds(requested) {
     }
     return requested;
 }
+/**
+ * Stable prefix of the tool-call-limit terminal error. This is a cross-repo
+ * contract: consumers that need to distinguish "ran out of tool-call budget"
+ * from other TERMINATED causes (Stigmer Cloud's channel reply extractor,
+ * which shows channel users a friendly limit message instead of generic
+ * error copy) match on this prefix with `startsWith`, because
+ * AgentExecutionStatus carries no structured termination reason. Do not
+ * reword without updating them. `COST_LIMIT_ERROR_PREFIX` (`cost-guard.ts`)
+ * mirrors it.
+ */
+export const TOOL_CALL_LIMIT_ERROR_PREFIX = "Agent reached the tool-call limit";
+/** The terminal `status.error` for a tool-call-limit stop; the prefix is the contract, the rest is prose. */
+export function formatToolCallLimitError() {
+    return `${TOOL_CALL_LIMIT_ERROR_PREFIX} for this message. Send another message to continue.`;
+}
+/**
+ * User-facing system message for a tool-call-limit stop. Honest about the
+ * limit, clear that nothing is lost; the cost-cap copy is its parallel.
+ */
+export const TOOL_CALL_LIMIT_USER_COPY = "The agent reached the tool-call limit for this message. " +
+    "Work completed so far has been saved. " +
+    "Send another message to continue where the agent left off.";
+/**
+ * Whether an error thrown out of a LangGraph run is the graph exhausting the
+ * recursion limit `resolveRecursionLimit` placed on it — the budget's own
+ * signal, not a failure: the adapter ends the turn `tool_call_limit`.
+ * Matched by class name and message because the error class is not
+ * exported on a stable path across `@langchain/langgraph` versions.
+ */
+export function isGraphRecursionError(err) {
+    if (err instanceof Error) {
+        return err.constructor.name === "GraphRecursionError" ||
+            err.message.includes("GraphRecursionError") ||
+            err.message.includes("Recursion limit");
+    }
+    return false;
+}
 //# sourceMappingURL=tool-rounds.js.map

package/dist/shared/tool-rounds.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-rounds.js","sourceRoot":"","sources":["../../src/shared/tool-rounds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAI,CAAC;AAEvD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,aAAiC;IACrE,IAAI,CAAC,aAAa,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,eAAe,CAAC,aAAa,CAAC,GAAG,qBAAqB,CAAC;AAChE,CAAC;AAED,SAAS,eAAe,CAAC,SAAiB;IACxC,IAAI,SAAS,GAAG,eAAe,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CACV,iCAAiC,SAAS,yBAAyB;YACnE,IAAI,eAAe,IAAI,eAAe,kBAAkB,eAAe,EAAE,CAC1E,CAAC;QACF,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,SAAS,GAAG,eAAe,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CACV,iCAAiC,SAAS,yBAAyB;YACnE,IAAI,eAAe,IAAI,eAAe,kBAAkB,eAAe,EAAE,CAC1E,CAAC;QACF,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"tool-rounds.js","sourceRoot":"","sources":["../../src/shared/tool-rounds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,IAAI,CAAC;AAEvD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,aAAiC;IACrE,IAAI,CAAC,aAAa,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,eAAe,CAAC,aAAa,CAAC,GAAG,qBAAqB,CAAC;AAChE,CAAC;AAED,SAAS,eAAe,CAAC,SAAiB;IACxC,IAAI,SAAS,GAAG,eAAe,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CACV,iCAAiC,SAAS,yBAAyB;YACnE,IAAI,eAAe,IAAI,eAAe,kBAAkB,eAAe,EAAE,CAC1E,CAAC;QACF,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,SAAS,GAAG,eAAe,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CACV,iCAAiC,SAAS,yBAAyB;YACnE,IAAI,eAAe,IAAI,eAAe,kBAAkB,eAAe,EAAE,CAC1E,CAAC;QACF,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,mCAAmC,CAAC;AAEhF,6GAA6G;AAC7G,MAAM,UAAU,wBAAwB;IACtC,OAAO,GAAG,4BAA4B,sDAAsD,CAAC;AAC/F,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GACpC,0DAA0D;IAC1D,wCAAwC;IACxC,4DAA4D,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,qBAAqB;YACnD,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YAC3C,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/shared/tool-row.d.ts

@@ -43,6 +43,40 @@ import type { SubAgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agent
  * path cannot be determined is stripped rather than trusted.
  */
 export declare function stampFileEditRow(tc: ToolCall, changeSetId: string): void;
+/**
+ * The turn-boundary pass over a transcript: stamp every file-edit row
+ * (category write/delete) that FLOWED this turn with the change set id, so
+ * the row stays visible in place as an observational record while
+ * `file_change_sets` remains the single decision surface (DD-24). Skips:
+ *
+ *  - already-stamped rows — the idempotency AND cross-turn guard: a resume
+ *    seeds prior turns' rows into this transcript, and re-stamping them with
+ *    this turn's id would mis-attribute them ({@link stampFileEditRow});
+ *  - legacy hidden rows (sessions persisted before stamping existed) — they
+ *    belong to an earlier turn's set;
+ *  - ids in `skipToolCallIds` — the sub-agent callers' pre-turn snapshot
+ *    ({@link collectSubAgentToolCallIds}), since sub-agent rows have neither
+ *    of the two shields above; top-level callers omit it;
+ *  - rows `flowed` refuses — the caller's evidence that a row did NOT flow
+ *    (the Cursor deny-gate's ledger tokens; a status rule). Omit to stamp
+ *    every write/delete row, the deep-agent posture where every such row flowed.
+ *
+ * One pass for every harness (S3 M4; until then each adapter carried a copy
+ * differing only in the `flowed` predicate).
+ */
+export declare function stampFlowedFileEditRows(messages: readonly AgentMessage[], changeSetId: string, opts?: {
+    readonly skipToolCallIds?: ReadonlySet<string>;
+    readonly flowed?: (tc: ToolCall) => boolean;
+}): void;
+/**
+ * The same pass over the turn's sub-agent transcripts. Sub-agent writes fold
+ * their files into the SAME parent turn set (shared git diff + one shared CAS
+ * observation, DD-19), so they carry the parent change set id and badge
+ * against the same set the parent's rows do. Scoped to this turn by
+ * `priorToolCallIds` (the sub-agent tool-call ids that existed before the
+ * turn's stream), because sub-agent rows lack the top-level pass's shields.
+ */
+export declare function stampFlowedSubAgentFileEditRows(subAgents: readonly SubAgentExecution[], changeSetId: string, priorToolCallIds: ReadonlySet<string>, flowed?: (tc: ToolCall) => boolean): void;
 /**
  * Withhold a file-mutating row's CONTENT while keeping its path visible: reduce
  * `args` to `{ path }` (or `undefined` when the path cannot be determined) and

package/dist/shared/tool-row.js

@@ -57,6 +57,58 @@ export function stampFileEditRow(tc, changeSetId) {
         tc.result = "";
     }
 }
+/**
+ * The turn-boundary pass over a transcript: stamp every file-edit row
+ * (category write/delete) that FLOWED this turn with the change set id, so
+ * the row stays visible in place as an observational record while
+ * `file_change_sets` remains the single decision surface (DD-24). Skips:
+ *
+ *  - already-stamped rows — the idempotency AND cross-turn guard: a resume
+ *    seeds prior turns' rows into this transcript, and re-stamping them with
+ *    this turn's id would mis-attribute them ({@link stampFileEditRow});
+ *  - legacy hidden rows (sessions persisted before stamping existed) — they
+ *    belong to an earlier turn's set;
+ *  - ids in `skipToolCallIds` — the sub-agent callers' pre-turn snapshot
+ *    ({@link collectSubAgentToolCallIds}), since sub-agent rows have neither
+ *    of the two shields above; top-level callers omit it;
+ *  - rows `flowed` refuses — the caller's evidence that a row did NOT flow
+ *    (the Cursor deny-gate's ledger tokens; a status rule). Omit to stamp
+ *    every write/delete row, the deep-agent posture where every such row flowed.
+ *
+ * One pass for every harness (S3 M4; until then each adapter carried a copy
+ * differing only in the `flowed` predicate).
+ */
+export function stampFlowedFileEditRows(messages, changeSetId, opts = {}) {
+    for (const msg of messages) {
+        for (const tc of msg.toolCalls) {
+            if (tc.fileChangeSetId)
+                continue;
+            if (opts.skipToolCallIds?.has(tc.id))
+                continue;
+            if (isToolCallRowHidden(tc))
+                continue;
+            const category = toolApprovalCategory(tc.name);
+            if (category !== "write" && category !== "delete")
+                continue;
+            if (opts.flowed && !opts.flowed(tc))
+                continue;
+            stampFileEditRow(tc, changeSetId);
+        }
+    }
+}
+/**
+ * The same pass over the turn's sub-agent transcripts. Sub-agent writes fold
+ * their files into the SAME parent turn set (shared git diff + one shared CAS
+ * observation, DD-19), so they carry the parent change set id and badge
+ * against the same set the parent's rows do. Scoped to this turn by
+ * `priorToolCallIds` (the sub-agent tool-call ids that existed before the
+ * turn's stream), because sub-agent rows lack the top-level pass's shields.
+ */
+export function stampFlowedSubAgentFileEditRows(subAgents, changeSetId, priorToolCallIds, flowed) {
+    for (const sa of subAgents) {
+        stampFlowedFileEditRows(sa.messages, changeSetId, { skipToolCallIds: priorToolCallIds, flowed });
+    }
+}
 /**
  * Withhold a file-mutating row's CONTENT while keeping its path visible: reduce
  * `args` to `{ path }` (or `undefined` when the path cannot be determined) and

package/dist/shared/tool-row.js.map

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

package/dist/shared/workspace/session-provision.d.ts

@@ -1,9 +1,9 @@
 /**
  * Local workspace provisioning for a harness turn.
  *
- * Harness-agnostic: the Cursor activity is today's only caller, the turn
- * runtime takes it over in S2 M3, and S3 retires the native twin
- * (execute-deep-agent/setup.ts `provisionWorkspace`). Agents run LOCAL
+ * Harness-agnostic: the turn runtime's workspace phase, serving both
+ * adapters (the native orchestrator's twin, `provisionWorkspace`, retired
+ * with it at S3 M2b; Q-S3-8 carried its one difference). Agents run LOCAL
  * (cloud is disabled — see execute-cursor/cursor-mode.ts), so the runner
  * must clone git-repo workspace entries itself and mount local-path entries
  * before the agent runs. Cloud agents previously cloned git repos

package/dist/shared/workspace/session-provision.js

@@ -1,9 +1,9 @@
 /**
  * Local workspace provisioning for a harness turn.
  *
- * Harness-agnostic: the Cursor activity is today's only caller, the turn
- * runtime takes it over in S2 M3, and S3 retires the native twin
- * (execute-deep-agent/setup.ts `provisionWorkspace`). Agents run LOCAL
+ * Harness-agnostic: the turn runtime's workspace phase, serving both
+ * adapters (the native orchestrator's twin, `provisionWorkspace`, retired
+ * with it at S3 M2b; Q-S3-8 carried its one difference). Agents run LOCAL
  * (cloud is disabled — see execute-cursor/cursor-mode.ts), so the runner
  * must clone git-repo workspace entries itself and mount local-path entries
  * before the agent runs. Cloud agents previously cloned git repos