@sublang/playbook 13.0.0 → 13.2.0

package/reference/sdlc/pr.playbook/pr.registry.ts

@@ -0,0 +1,124 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+
+import createPlaybookRuntime, {
+  type PrPlaybookHostCapabilities,
+  type PlaybookRuntime,
+} from './pr.playbook.js';
+
+export interface PlaybookSummaryPolicy {
+  stateCountLabels: Readonly<Record<string, string>>;
+  copyPasteGuardNames: readonly string[];
+  savedCountsLine(
+    counts: { interruptions: number; copyPastes: number },
+    rounds: number,
+  ): string;
+}
+
+export type PrOptions = Readonly<Record<string, never>>;
+
+export interface PrPlaybookRegistryEntry {
+  id: 'pr';
+  command: 'pr';
+  intent: string;
+  artifactSchema: 3;
+  runtimeProfile: {
+    readonly kind: 'shared-factory';
+    readonly compat: {
+      readonly artifactSchema: 3;
+      readonly runtimeAbi: number;
+    };
+  };
+  requiredRoleIds: readonly ['coder'];
+  concurrentRoleSets: readonly [];
+  summaryPolicy: PlaybookSummaryPolicy;
+  validateOptions(optionSlice: unknown): PrOptions;
+  createRuntime(
+    options: PrOptions,
+    hostCapabilities: PrPlaybookHostCapabilities,
+  ): PlaybookRuntime;
+}
+
+// CODE owns and labels the rounds of the one fix it may make. PR's suspended
+// call state only delegates to that child and must not double-count its
+// rounds; its script states run no agent at all. Only the Coder publication
+// round is PR's own.
+export const prStateCountLabels = {
+  openPullRequest: 'publication round',
+} as const;
+
+export const prCopyPasteGuardNames = ['opened'] as const;
+
+function countNoun(
+  count: number,
+  singular: string,
+  plural = `${singular}s`,
+): string {
+  return `${count} ${count === 1 ? singular : plural}`;
+}
+
+export function prSavedCountsLine(
+  counts: { interruptions: number; copyPastes: number },
+  rounds: number,
+): string {
+  return [
+    'Saved you',
+    countNoun(counts.interruptions, 'interruption'),
+    'and',
+    countNoun(counts.copyPastes, 'copy-paste'),
+    'across',
+    countNoun(rounds, 'round'),
+    'of delivery.',
+  ].join(' ');
+}
+
+export const prSummaryPolicy: PlaybookSummaryPolicy = {
+  stateCountLabels: prStateCountLabels,
+  copyPasteGuardNames: prCopyPasteGuardNames,
+  savedCountsLine: prSavedCountsLine,
+};
+
+export function validatePrOptions(optionSlice: unknown): PrOptions {
+  if (optionSlice === undefined) return Object.freeze({});
+  if (
+    optionSlice === null ||
+    typeof optionSlice !== 'object' ||
+    Array.isArray(optionSlice)
+  ) {
+    throw new Error('captain.options.playbooks.pr.options must be an object');
+  }
+  const keys = Object.keys(optionSlice);
+  if (keys.length > 0) {
+    throw new Error(
+      `Unknown config field captain.options.playbooks.pr.options.${keys[0]}`,
+    );
+  }
+  return Object.freeze({});
+}
+
+export const prPlaybookRegistryEntry: PrPlaybookRegistryEntry = {
+  id: 'pr',
+  command: 'pr',
+  intent:
+    'publish a reviewed branch as a pull request, wait for its checks, fix red checks once through code, and merge it',
+  artifactSchema: 3,
+  runtimeProfile: Object.freeze({
+    kind: 'shared-factory',
+    compat: createPlaybookRuntime.compat,
+  }),
+  requiredRoleIds: ['coder'],
+  concurrentRoleSets: [],
+  summaryPolicy: prSummaryPolicy,
+  validateOptions: validatePrOptions,
+  createRuntime(options, hostCapabilities) {
+    // The five script states run `gh` and `git` in the repository the host
+    // governs: the linked `cwd` option is composed here from the host's
+    // authority working directory (DR-040 §2), never from configuration.
+    return createPlaybookRuntime({
+      configuredOptions: { ...options, cwd: hostCapabilities.authority.cwd },
+      hostCapabilities,
+    });
+  },
+};
+
+export default prPlaybookRegistryEntry;

package/reference/sdlc/review.md

@@ -27,6 +27,10 @@ Keep to the original intent and follow what it asks.
 When the scope names commits, read each commit message for its context and rationale; otherwise use repository history and commit messages wherever they help establish that context.
 ```
 
+Captain shall append the caller’s input in quotes (`>`):
+
+> Original request: <caller-input>
+
 After every review-fix commit, Captain shall give Reviewer the following instruction:
 
 ```markdown
@@ -35,6 +39,12 @@ Keep to the original intent and follow what it asks.
 Read the latest review-fix commit's message and see Coder's feedback below.
 ```
 
+Captain shall append the round’s context in quotes (`>`):
+
+> Original request: <caller-input>
+> Latest commit: <latest-commit>
+> Coder output: <coder-output>
+
 When Coder rejects every finding and makes no commit, Captain shall give Reviewer the following instruction:
 
 ```markdown
@@ -42,6 +52,11 @@ No new commit was made because Coder rejected every finding.
 See Coder's feedback below.
 ```
 
+Captain shall append the round’s context in quotes (`>`):
+
+> Original request: <caller-input>
+> Coder output: <coder-output>
+
 At the start of *every* review round, Captain shall relay to Reviewer the original intent, the review scope and context, the exact repository revision being evaluated, any Coder feedback from the preceding round, and any relevant run results, in quotes (`>`) after the instruction.
 
 At the start of *every* review round, Captain shall append the following instruction to the end of the prompt:
@@ -70,6 +85,9 @@ No review transition shall depend on numbering or any fixed presentation format
 
 When Reviewer raises or keeps any finding, Captain shall relay the original intent, the review scope and context, the exact repository revision being evaluated, the Reviewer's findings, and any relevant run results to Coder, in quotes (`>`), along with the following prompt:
 
+> Original request: <caller-input>
+> Reviewer findings: <reviewer-output>
+
 ```markdown
 For each review item, accept or reject it.
 Before deciding, understand the full picture and think systematically about the underlying design.

package/reference/sdlc/review.playbook/review.fsm.js

@@ -27,7 +27,7 @@ const INITIAL_REVIEW_PROMPT = [
     'Keep to the original intent and follow what it asks.',
     'When the scope names commits, read each commit message for its context and rationale; otherwise use repository history and commit messages wherever they help establish that context.',
     '',
-    '> <caller-input>',
+    '> Original request: <caller-input>',
     '',
     SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
@@ -36,9 +36,9 @@ const POST_COMMIT_REVIEW_PROMPT = [
     'Keep to the original intent and follow what it asks.',
     "Read the latest review-fix commit's message and see Coder's feedback below.",
     '',
-    '> <caller-input>',
-    '> <latest-commit>',
-    '> <coder-output>',
+    '> Original request: <caller-input>',
+    '> Latest commit: <latest-commit>',
+    '> Coder output: <coder-output>',
     '',
     SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
@@ -46,14 +46,14 @@ const REBUTTAL_REVIEW_PROMPT = [
     'No new commit was made because Coder rejected every finding.',
     "See Coder's feedback below.",
     '',
-    '> <caller-input>',
-    '> <coder-output>',
+    '> Original request: <caller-input>',
+    '> Coder output: <coder-output>',
     '',
     SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
 const CODER_DISPOSITION_PROMPT = [
-    '> <caller-input>',
-    '> <reviewer-output>',
+    '> Original request: <caller-input>',
+    '> Reviewer findings: <reviewer-output>',
     '',
     'For each review item, accept or reject it.',
     'Before deciding, understand the full picture and think systematically about the underlying design.',

package/reference/sdlc/review.playbook/review.fsm.ts

@@ -113,7 +113,7 @@ const INITIAL_REVIEW_PROMPT = [
   'Keep to the original intent and follow what it asks.',
   'When the scope names commits, read each commit message for its context and rationale; otherwise use repository history and commit messages wherever they help establish that context.',
   '',
-  '> <caller-input>',
+  '> Original request: <caller-input>',
   '',
   SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
@@ -123,9 +123,9 @@ const POST_COMMIT_REVIEW_PROMPT = [
   'Keep to the original intent and follow what it asks.',
   "Read the latest review-fix commit's message and see Coder's feedback below.",
   '',
-  '> <caller-input>',
-  '> <latest-commit>',
-  '> <coder-output>',
+  '> Original request: <caller-input>',
+  '> Latest commit: <latest-commit>',
+  '> Coder output: <coder-output>',
   '',
   SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
@@ -134,15 +134,15 @@ const REBUTTAL_REVIEW_PROMPT = [
   'No new commit was made because Coder rejected every finding.',
   "See Coder's feedback below.",
   '',
-  '> <caller-input>',
-  '> <coder-output>',
+  '> Original request: <caller-input>',
+  '> Coder output: <coder-output>',
   '',
   SHARED_REVIEW_INSTRUCTION,
 ].join('\n');
 
 const CODER_DISPOSITION_PROMPT = [
-  '> <caller-input>',
-  '> <reviewer-output>',
+  '> Original request: <caller-input>',
+  '> Reviewer findings: <reviewer-output>',
   '',
   'For each review item, accept or reject it.',
   'Before deciding, understand the full picture and think systematically about the underlying design.',

package/reference/sdlc/review.playbook/review.gears.md

@@ -23,7 +23,7 @@ When the caller starts a review, Captain shall relay the complete caller input t
 > Keep to the original intent and follow what it asks.
 > When the scope names commits, read each commit message for its context and rationale; otherwise use repository history and commit messages wherever they help establish that context.
 >
-> > <caller-input>
+> > Original request: <caller-input>
 >
 > Understand the full picture and think systematically about the underlying design.
 > Continue to identify issues or improvements, if any, without duplication.
@@ -50,8 +50,8 @@ Results:
 
 When Reviewer raises or keeps any finding, Captain shall relay the caller input and Reviewer's findings to Coder with the disposition prompt:
 
-> > <caller-input>
-> > <reviewer-output>
+> > Original request: <caller-input>
+> > Reviewer findings: <reviewer-output>
 >
 > For each review item, accept or reject it.
 > Before deciding, understand the full picture and think systematically about the underlying design.
@@ -82,9 +82,9 @@ When Coder makes a review-fix commit, Captain shall relay the caller input, the
 > Keep to the original intent and follow what it asks.
 > Read the latest review-fix commit's message and see Coder's feedback below.
 >
-> > <caller-input>
-> > <latest-commit>
-> > <coder-output>
+> > Original request: <caller-input>
+> > Latest commit: <latest-commit>
+> > Coder output: <coder-output>
 >
 > Understand the full picture and think systematically about the underlying design.
 > Continue to identify issues or improvements, if any, without duplication.
@@ -114,8 +114,8 @@ When Coder rejects every finding and makes no commit, Captain shall relay the ca
 > No new commit was made because Coder rejected every finding.
 > See Coder's feedback below.
 >
-> > <caller-input>
-> > <coder-output>
+> > Original request: <caller-input>
+> > Coder output: <coder-output>
 >
 > Understand the full picture and think systematically about the underlying design.
 > Continue to identify issues or improvements, if any, without duplication.

package/reference/sdlc/review.playbook/review.playbook.d.ts

@@ -6,7 +6,7 @@ export type { CaptainCallOptions, CaptainResult, JsonValue, NormalizedError, Pla
 export type ReviewPlaybookOptions = ReviewInput;
 export type ReviewPlaybookHostCapabilities = PlaybookHostConstructionCapabilities & XStatePlaybookRuntimeConstruction<ReviewPlaybookOptions, object>['hostCapabilities'];
 /** Keep every line of a relayed runtime value inside its authored quote. */
-declare function composePlayerPrompt(input: PlayerInput, promptIdentity: XStatePromptIdentity): string;
+declare function composePlayerPrompt(input: PlayerInput, promptIdentity: XStatePromptIdentity, resuming?: boolean): string;
 export declare const _internal: {
     composePlayerPrompt: typeof composePlayerPrompt;
     VERBATIM_PAYLOAD_FIELDS: ReadonlySet<string>;

package/reference/sdlc/review.playbook/review.playbook.js

@@ -10,10 +10,9 @@
 //                carried verbatim; latestCommit is receipt-owned effect
 //                evidence, never taken from either player's prose
 // Compat:        artifact schema 3 / runtime ABI 1
-import { createXStatePlaybookRuntime, snapshotJsonValue, } from '@sublang/playbook/xstate-runtime';
+import { createXStatePlaybookRuntime, composePlayerContinuation, snapshotJsonValue, } from '@sublang/playbook/xstate-runtime';
 import { reviewMachine, } from './review.fsm.js';
 const PLACEHOLDER = /<(#|[A-Za-z_$][A-Za-z0-9_$-]*)>/g;
-const CONTINUATION_PREAMBLE = 'You previously paused this task to ask Boss a question; Boss has now replied. Continue the same task using the reply below.';
 const VERBATIM_PAYLOAD_FIELDS = new Set([
     'reviewerOutput',
     'coderOutput',
@@ -41,7 +40,7 @@ function quotedContinuation(value) {
     return value.replaceAll('\n', '\n> ');
 }
 /** Keep every line of a relayed runtime value inside its authored quote. */
-function composePlayerPrompt(input, promptIdentity) {
+function composePlayerPrompt(input, promptIdentity, resuming = false) {
     const fields = input;
     const body = input.prompt.replace(PLACEHOLDER, (match, token, offset, source) => {
         const value = token === 'coder-llm'
@@ -52,20 +51,11 @@ function composePlayerPrompt(input, promptIdentity) {
         if (typeof value !== 'string')
             return match;
         const lineStart = source.lastIndexOf('\n', offset - 1) + 1;
-        return source.slice(lineStart, offset) === '> '
+        return source.slice(lineStart, offset).startsWith('> ')
             ? quotedContinuation(value)
             : value;
     });
-    if (input.pendingBossQuestion === undefined ||
-        input.bossReply === undefined) {
-        return body;
-    }
-    return [
-        CONTINUATION_PREAMBLE,
-        `Boss question:\n${input.pendingBossQuestion.question}`,
-        `Boss reply:\n${input.bossReply}`,
-        body,
-    ].join('\n\n');
+    return composePlayerContinuation(input, body, resuming);
 }
 export const _internal = {
     composePlayerPrompt,
@@ -175,7 +165,7 @@ const runtimeSpec = {
             },
         },
     },
-    composePlayerPrompt: (input, promptIdentity) => composePlayerPrompt(input, promptIdentity),
+    composePlayerPrompt: (input, promptIdentity, resuming) => composePlayerPrompt(input, promptIdentity, resuming),
     verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
     controlContextFields: [],
     unfinishedFinalStateIds: UNFINISHED_FINAL_STATE_IDS,

package/reference/sdlc/review.playbook/review.playbook.ts

@@ -13,6 +13,7 @@
 
 import {
   createXStatePlaybookRuntime,
+  composePlayerContinuation,
   snapshotJsonValue,
   type PlaybookPlayerInput,
   type XStatePlaybookRuntimeFactory,
@@ -84,8 +85,6 @@ export type ReviewPlaybookHostCapabilities =
     XStatePlaybookRuntimeConstruction<ReviewPlaybookOptions, object>['hostCapabilities'];
 
 const PLACEHOLDER = /<(#|[A-Za-z_$][A-Za-z0-9_$-]*)>/g;
-const CONTINUATION_PREAMBLE =
-  'You previously paused this task to ask Boss a question; Boss has now replied. Continue the same task using the reply below.';
 
 const VERBATIM_PAYLOAD_FIELDS: ReadonlySet<string> = new Set([
   'reviewerOutput',
@@ -124,6 +123,7 @@ function quotedContinuation(value: string): string {
 function composePlayerPrompt(
   input: PlayerInput,
   promptIdentity: XStatePromptIdentity,
+  resuming = false,
 ): string {
   const fields = input as unknown as Record<string, unknown>;
   const body = input.prompt.replace(
@@ -137,23 +137,12 @@ function composePlayerPrompt(
             : fields[placeholderField(token)];
       if (typeof value !== 'string') return match;
       const lineStart = source.lastIndexOf('\n', offset - 1) + 1;
-      return source.slice(lineStart, offset) === '> '
+      return source.slice(lineStart, offset).startsWith('> ')
         ? quotedContinuation(value)
         : value;
     },
   );
-  if (
-    input.pendingBossQuestion === undefined ||
-    input.bossReply === undefined
-  ) {
-    return body;
-  }
-  return [
-    CONTINUATION_PREAMBLE,
-    `Boss question:\n${input.pendingBossQuestion.question}`,
-    `Boss reply:\n${input.bossReply}`,
-    body,
-  ].join('\n\n');
+  return composePlayerContinuation(input, body, resuming);
 }
 
 export const _internal = {
@@ -271,7 +260,8 @@ const runtimeSpec = {
   composePlayerPrompt: (
     input: PlaybookPlayerInput,
     promptIdentity: XStatePromptIdentity,
-  ) => composePlayerPrompt(input as PlayerInput, promptIdentity),
+    resuming?: boolean,
+  ) => composePlayerPrompt(input as PlayerInput, promptIdentity, resuming),
   verbatimPayloadFields: VERBATIM_PAYLOAD_FIELDS,
   controlContextFields: [],
   unfinishedFinalStateIds: UNFINISHED_FINAL_STATE_IDS,

package/slc/link.md

@@ -489,6 +489,7 @@ interface PlaybookPorts {
 
 interface PlayerCallOptions {
   resume: string | false;
+  freshPrompt?: string;
 }
 
 interface CaptainCallOptions {
@@ -865,30 +866,17 @@ Those blocks are outside the domain prompt body.
 The composer shall not inject a player-visible Boss-question instruction.
 Boss-question detection is adjudicator-facing: it comes from the state's `needsBossReply` result description, not from extra prompt text.
 
-When `PlayerInput` carries both `pendingBossQuestion` and `bossReply`, the
-composer shall prepend the continuation preamble and labelled Q&A blocks before
-ordinary structured blocks and before the domain prompt body:
-
-```text
-You previously paused this task to ask Boss a question; Boss has now replied. Continue the same task using the reply below.
-
-Boss question:
-<pendingBossQuestion.question>
-
-Boss reply:
-<bossReply>
-
-```
-
-The continuation preamble is framework text supplied by the runtime.
-It is not part of the GEARS blockquote and shall not appear in `invoke.input.prompt`.
-The composer shall retain the blank line after the Boss reply before the next
-structured block or domain prompt, producing exactly two newline characters at
-that boundary.
-When implementing the prefix as an array joined with `"\n"`, the array needs
-two trailing empty strings after `bossReply`; one trailing empty string emits
-only one newline and is nonconformant. Equivalently, append `"\n\n"` exactly
-once before the following block or domain body.
+When `PlayerInput` carries both `pendingBossQuestion` and `bossReply`, the composer receives an optional third `resuming` boolean after `promptIdentity`; absent means fresh.
+The shared `composePlayerContinuation(input, body, resuming)` helper prefixes the verbatim Boss reply and, only for a fresh conversation, the pending question labeled `Your previous question:`.
+A resumed call omits that question; a fresh call includes it before `Boss reply:`.
+Both retain the authored task body exactly once, with two newlines between blocks.
+These framework blocks never enter `invoke.input.prompt` or persisted FSM context.
+
+The runtime chooses the compact prompt only after selecting a conversation token and carries the complete prompt as optional `PlayerCallOptions.freshPrompt`.
+A host starting fresh after a definite pre-execution token rejection uses `freshPrompt`, when supplied, instead of the compact prompt.
+Without that option, the given prompt remains complete.
+Traces and host observations record the respective prompts actually sent.
+Old composers may ignore the optional argument and retain their full prompt.
 
 ## Captain prompt composition
 

package/src/runtime.d.ts

@@ -6,6 +6,8 @@ export interface PlayerResult {
 }
 export interface PlayerCallOptions {
     resume: string | false;
+    /** Complete task and clarification context if the host must start fresh. */
+    freshPrompt?: string;
 }
 export interface PlayerSessionStore {
     select(roleId: string): string | false;

package/src/runtime.ts

@@ -17,6 +17,8 @@ export interface PlayerResult {
 
 export interface PlayerCallOptions {
   resume: string | false;
+  /** Complete task and clarification context if the host must start fresh. */
+  freshPrompt?: string;
 }
 
 // DR-032: a composing host may supply one frame-local role view of the

package/src/xstate-playbook-runtime.d.ts

@@ -329,7 +329,7 @@ interface XStatePlaybookRuntimeSpecBase<TOptions> {
     /** Complete FSM-derived Boss-facing metadata for every `player` state. */
     roleStates?: Readonly<Record<string, XStateRoleStateStatus>>;
     /** Compose the player prompt. Default: continuation blocks + `<field>` placeholder substitution. */
-    composePlayerPrompt?: (input: PlaybookPlayerInput, promptIdentity: XStatePromptIdentity) => string;
+    composePlayerPrompt?: (input: PlaybookPlayerInput, promptIdentity: XStatePromptIdentity, resuming?: boolean) => string;
     /** Compose the direct-Captain prompt. Default: continuation blocks + placeholder substitution with deterministic JSON rendering. */
     composeCaptainPrompt?: (input: PlaybookCaptainInput) => string;
     /** Linker-known exceptions to the default kebab-token → camel-field mapping. */
@@ -388,6 +388,8 @@ export declare function normalizeErrorFull(err: unknown): {
 } | undefined;
 /** Read the FSM context's single pending Boss question, when well-formed. */
 export declare function pendingBossQuestionFromContext(context: Record<string, unknown>): PlaybookPendingBossQuestionContext | undefined;
+/** Add clarification context without repeating the question in a live conversation. */
+export declare function composePlayerContinuation(input: Pick<PlaybookPlayerInput, 'pendingBossQuestion' | 'bossReply'>, body: string, resuming?: boolean): string;
 /**
  * Default player-prompt composer (slc/link.md §Player prompt composition).
  * One callback-based pass substitutes each `<fieldName>` placeholder whose
@@ -395,7 +397,7 @@ export declare function pendingBossQuestionFromContext(context: Record<string, u
  * placeholder-looking text inside a value is never re-substituted. The
  * continuation preamble and Q/A blocks precede the domain body on resume.
  */
-export declare function defaultComposePlayerPrompt(input: PlaybookPlayerInput, placeholderFields?: Readonly<Record<string, string>>): string;
+export declare function defaultComposePlayerPrompt(input: PlaybookPlayerInput, placeholderFields?: Readonly<Record<string, string>>, resuming?: boolean): string;
 /**
  * Default direct-Captain prompt composer (slc/link.md §Captain prompt
  * composition). Placeholder substitution is presence-based: string fields

package/src/xstate-playbook-runtime.js

@@ -402,17 +402,21 @@ export function pendingBossQuestionFromContext(context) {
 // ---------------------------------------------------------------------------
 // Generic strategy defaults.
 // ---------------------------------------------------------------------------
-const CONTINUATION_PREAMBLE = 'You previously paused this task to ask Boss a question; Boss has now replied. Continue the same task using the reply below.';
-function continuationBlocks(input) {
+const CONTINUATION_PREAMBLE = 'Continue the same task using Boss’s reply below.';
+function continuationBlocks(input, resuming = false) {
     if (input.pendingBossQuestion === undefined || input.bossReply === undefined) {
         return [];
     }
     return [
         CONTINUATION_PREAMBLE,
-        `Boss question:\n${input.pendingBossQuestion.question}`,
+        ...(resuming ? [] : [`Your previous question:\n${input.pendingBossQuestion.question}`]),
         `Boss reply:\n${input.bossReply}`,
     ];
 }
+/** Add clarification context without repeating the question in a live conversation. */
+export function composePlayerContinuation(input, body, resuming = false) {
+    return [...continuationBlocks(input, resuming), body].join('\n\n');
+}
 const PLACEHOLDER_PATTERN = /<(#|[A-Za-z_$][A-Za-z0-9_$-]*)>/g;
 function placeholderFieldName(token, fields) {
     const explicit = fields[token];
@@ -429,15 +433,13 @@ function placeholderFieldName(token, fields) {
  * placeholder-looking text inside a value is never re-substituted. The
  * continuation preamble and Q/A blocks precede the domain body on resume.
  */
-export function defaultComposePlayerPrompt(input, placeholderFields = {}) {
-    const blocks = continuationBlocks(input);
+export function defaultComposePlayerPrompt(input, placeholderFields = {}, resuming = false) {
     const fields = input;
     const body = input.prompt.replace(PLACEHOLDER_PATTERN, (match, token) => {
         const value = fields[placeholderFieldName(token, placeholderFields)];
         return typeof value === 'string' ? value : match;
     });
-    blocks.push(body);
-    return blocks.join('\n\n');
+    return composePlayerContinuation(input, body, resuming);
 }
 function sortJson(value) {
     if (Array.isArray(value))
@@ -1901,7 +1903,7 @@ export function createXStatePlaybookRuntime(machine, spec) {
         }
     }
     const composePlayerPrompt = spec.composePlayerPrompt ??
-        ((input) => defaultComposePlayerPrompt(input, spec.placeholderFields));
+        ((input, _identity, resuming = false) => defaultComposePlayerPrompt(input, spec.placeholderFields, resuming));
     const composeCaptainPrompt = spec.composeCaptainPrompt ??
         ((input) => defaultComposeCaptainPrompt(input, spec.placeholderFields));
     const extractFields = spec.extractRequiredFields ?? defaultExtractRequiredFields;
@@ -2522,7 +2524,7 @@ export function createXStatePlaybookRuntime(machine, spec) {
             }
             return session?.roleBindings?.[roleId]?.promptIdentity ?? roleId;
         }
-        function composeBoundPlayerPrompt(input) {
+        function composeBoundPlayerPrompt(input, resuming = false) {
             let active = true;
             const lookup = (roleId) => {
                 if (!active) {
@@ -2531,7 +2533,7 @@ export function createXStatePlaybookRuntime(machine, spec) {
                 return promptIdentity(roleId);
             };
             try {
-                return composePlayerPrompt(input, lookup);
+                return composePlayerPrompt(input, lookup, resuming);
             }
             finally {
                 active = false;
@@ -3372,7 +3374,7 @@ export function createXStatePlaybookRuntime(machine, spec) {
             failedGovernedAttemptId = attemptIds.values().next().value;
         }
         const boundary = {
-            async callPlayer(input, roleId, prompt, signal) {
+            async callPlayer(input, roleId, freshPrompt, signal) {
                 // State-entry telemetry/status must precede the call they describe.
                 await drainEmissions();
                 signal.throwIfAborted();
@@ -3399,6 +3401,8 @@ export function createXStatePlaybookRuntime(machine, spec) {
                         controlPlaneError ??= error;
                     throw error;
                 }
+                const prompt = selectedResume === false
+                    ? freshPrompt : composeBoundPlayerPrompt(input, true);
                 const callId = deferredContinuation?.effectBoundary.callId ??
                     `player-${++playerCallSequence}`;
                 const callIdentity = (resume) => ({
@@ -3427,7 +3431,8 @@ export function createXStatePlaybookRuntime(machine, spec) {
                 try {
                     const runTracedPlayerCall = async (resume = selectedResume) => {
                         const identity = callIdentity(resume);
-                        await emitCallStarted('player.call.started', 'player.call.finished', { ...identity, prompt }, position, signal);
+                        const callPrompt = resume === false ? freshPrompt : prompt;
+                        await emitCallStarted('player.call.started', 'player.call.finished', { ...identity, prompt: callPrompt }, position, signal);
                         let rawResult;
                         try {
                             // An abort may land while the awaited started emission drains
@@ -3435,7 +3440,7 @@ export function createXStatePlaybookRuntime(machine, spec) {
                             // never start after abort, so settle the already-started pair
                             // as `aborted` through the catch below.
                             signal.throwIfAborted();
-                            rawResult = await requireHostPorts().callPlayer(roleId, prompt, signal, { resume });
+                            rawResult = await requireHostPorts().callPlayer(roleId, callPrompt, signal, { resume, ...(callPrompt === freshPrompt ? {} : { freshPrompt }) });
                             // A host promise is not required to honor cancellation. Do not
                             // let a late result mutate continuity or publish a successful
                             // finish.