commandmate 0.44.1 → 0.44.3

package/dist/lib/global-state.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOrInitGlobal = getOrInitGlobal;
+/**
+ * Process-wide state helper for the `globalThis.__*` cache pattern.
+ *
+ * Returns the value already stored on `globalThis[key]`, or runs `init` once and
+ * stores its result. `init` runs only when the slot is `null`/`undefined`, at the
+ * moment this function is called (so callers keep their own init timing).
+ *
+ * `key` and the initial value are typed from each file's `declare global`
+ * declaration. This module imports nothing so any layer (server, CLI) can use it.
+ */
+function getOrInitGlobal(key, init) {
+    return (globalThis[key] ??= init());
+}

package/dist/lib/polling/auto-yes-suppression-reason.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Why an auto-answer was withheld.
+ *
+ * `deny-pattern-unusable` is the fail-closed case: a deny pattern that cannot be
+ * evaluated (unsafe, unparseable, or over-long) suppresses instead of being
+ * skipped. Ignoring it would silently drop the protection the contract author
+ * asked for, which is the more dangerous of the two directions.
+ */
+export type AutoYesSuppressionReason = 'mode-off' | 'deny-pattern' | 'deny-pattern-unusable' | 'type-not-allowed'
+/**
+ * Issue #1829: not a policy verdict at all, but the same outcome recorded
+ * through the same channel. The prompt on screen is a CLI-lifecycle dialog
+ * whose answer belongs to the tool's own launch sequence, so the poller
+ * withheld one. Listed here so `capture --json` / `cmate wait` can name it
+ * instead of showing a session that has silently gone quiet.
+ */
+ | 'agent-launch-dialog'
+/**
+ * Issue #1924 (§4 D1 decision 4): the generic estimator read a numbered list
+ * on the frame and the tool's own dialog detector did not vouch for it, so
+ * nothing was sent.
+ *
+ * Also not a policy verdict. It is the reason code for the one position that
+ * can stop #1896 — an agent quoting a numbered list in its *answer* and
+ * Auto-Yes replying `1` to the prose. `detectPrompt`'s generic estimate is
+ * true on that frame and the tool-specific `detectDialog` is false, and this
+ * names the gap instead of letting the session go quiet with no record.
+ *
+ * Declared in Phase 1 (Issue #1924) and recorded from Phase 3, when the
+ * tool-specific detectors that can disagree with the estimator exist.
+ */
+ | 'unclassified-frame';
+//# sourceMappingURL=auto-yes-suppression-reason.d.ts.map

package/dist/lib/polling/auto-yes-suppression-reason.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-yes-suppression-reason.d.ts","sourceRoot":"","sources":["../../../src/lib/polling/auto-yes-suppression-reason.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAChC,UAAU,GACV,cAAc,GACd,uBAAuB,GACvB,kBAAkB;AACpB;;;;;;GAMG;GACD,qBAAqB;AACvB;;;;;;;;;;;;;GAaG;GACD,oBAAoB,CAAC"}

package/dist/lib/polling/auto-yes-suppression-reason.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/session/prompt-view.d.ts

@@ -0,0 +1,228 @@
+/**
+ * How a waiting prompt is shown and answered, decided once (Issue #3184).
+ *
+ * Before this module every reader of a prompt payload re-derived the same three
+ * facts for itself — "can it be answered?", "where are the choices?", "is the
+ * answer a keystroke or an API call?" — from `type`, `options`,
+ * `decisionOptions`, `decisionId` and `askUserQuestion`. The panel, the phone
+ * sheet, the chat surface, Auto-Yes and `wait` each combined them a little
+ * differently, and a fix to one surface kept missing the others (#2775 →
+ * #2810 → #2822, #3181). {@link derivePromptView} is the one combination; a
+ * reader takes its {@link PromptView} and does not look at the raw fields to
+ * decide what to show.
+ *
+ * ## No imports, on purpose
+ *
+ * The CLI (`tsconfig.cli.json`) compiles with `"paths": {}`, so it can reach a
+ * module under `src/lib` by a relative path only when nothing in that module's
+ * graph uses the `@/` alias. `types/models` and `session/structured-prompt` both
+ * do. The input is therefore a structural type ({@link PromptViewSource}) that
+ * every existing prompt shape — `LivePromptData`, `StoredPromptData`, the CLI's
+ * own `PromptData` mirror — satisfies without a cast, and this file stays
+ * importable from a client component, the server and the CLI alike.
+ *
+ * ## What it does not replace
+ *
+ * `isAnswerablePromptData()` (`types/models`) stays: it narrows to the closed
+ * `PromptData` union (#1725) for the code that builds an answer body. The two
+ * agree by construction — `derivePromptView(x)?.kind === 'screen-choices'`
+ * exactly when `isAnswerablePromptData(x)` — and
+ * `tests/unit/session/prompt-view-3184.test.ts` holds that over every fixture.
+ *
+ * @module lib/session/prompt-view
+ */
+/**
+ * `promptData.type` for a frame nothing could classify. Same value as
+ * `UNCLASSIFIED_PROMPT_TYPE` in `types/models`, restated because this module may
+ * not import it (see the module note); the test asserts the two are equal.
+ */
+export declare const UNCLASSIFIED_PROMPT_VIEW_TYPE = "unclassified";
+/**
+ * The fields {@link derivePromptView} reads. Every prompt shape in the codebase
+ * is assignable to it as it stands.
+ */
+export interface PromptViewSource {
+    type: string;
+    question?: string;
+    status?: string;
+    options?: readonly unknown[];
+    defaultOption?: unknown;
+    multiSelect?: boolean;
+    decisionId?: unknown;
+    decisionOptions?: unknown;
+    askUserQuestion?: unknown;
+    toolName?: unknown;
+}
+/**
+ * How the prompt is answered. "Free text" is not a fourth value: it is the
+ * orthogonal {@link PromptView.freeText}, because every prompt that takes typed
+ * text today also offers choices (design §2.4).
+ *
+ * - `screen-choices`: keys on the pane — the option number, or y/n
+ *   (`/prompt-response`).
+ * - `api-choices`: the agent's own API, addressed by `decisionId` (`/respond`).
+ * - `unreadable`: nothing to offer; the human answers in the terminal.
+ */
+export type PromptViewKind = 'screen-choices' | 'api-choices' | 'unreadable';
+/** What the heading above the prompt says. */
+export type PromptViewHeading = 
+/** The question read off the screen. */
+{
+    kind: 'question';
+    text: string;
+}
+/** An approval answered over the API (#3181's heading). */
+ | {
+    kind: 'approval';
+    toolName: string | null;
+}
+/** A question answered over the API (#2039). */
+ | {
+    kind: 'agent-question';
+    text: string;
+}
+/** "A dialog is open but its options could not be read." */
+ | {
+    kind: 'unreadable';
+};
+/** One choice a surface may offer. */
+export interface PromptViewChoice {
+    /**
+     * The value an answer sends: the option number (`'1'`) or `'yes'`/`'no'` on
+     * the screen; the number `respond` resolves for an API decision.
+     */
+    answer: string;
+    label: string;
+    isDefault: boolean;
+    /** Choosing it opens a text field (#2573's rule, {@link optionTakesTypedText}). */
+    takesText: boolean;
+    description?: string;
+}
+/** The one shape every surface reads (Issue #3184). */
+export interface PromptView {
+    kind: PromptViewKind;
+    heading: PromptViewHeading;
+    /** Always empty for `unreadable`. */
+    choices: readonly PromptViewChoice[];
+    /** A checkbox question (#2755). Only ever true for `screen-choices`. */
+    multiSelect: boolean;
+    /** Whether typed text is accepted, and by which channel; null when it is not. */
+    freeText: {
+        via: 'screen' | 'api';
+    } | null;
+    /** Non-null exactly when `kind === 'api-choices'` (#2031's biconditional). */
+    decisionId: string | null;
+    /** For `api-choices`, which kind of decision the id names; null otherwise. */
+    apiTarget: 'approval' | 'question' | null;
+}
+/**
+ * What a surface prints as the heading, as a `prompt.*` message key (Issue
+ * #3181, #3184). `text` is set instead of `key` for a question read off the
+ * screen, which is printed verbatim. Both answer surfaces translate THIS rather
+ * than mapping the heading kinds themselves, so the two cannot disagree about
+ * when "could not read its options" is the truth.
+ */
+export type PromptHeadingMessage = {
+    text: string;
+} | {
+    key: 'structuredApprovalTitle';
+    values: {
+        toolName: string;
+    };
+} | {
+    key: 'structuredApprovalTitleNoTool' | 'structuredQuestionTitle' | 'unclassifiedTitle';
+};
+export declare function promptHeadingMessage(heading: PromptViewHeading): PromptHeadingMessage;
+/**
+ * Labels of the rows measured to BE a text field on screen (Issue #2573).
+ *
+ * `requiresTextInput` (from {@link TEXT_INPUT_PATTERNS}) reads the WORDS of a
+ * label — "tell … what to do differently", "custom", "enter …" — and says the
+ * option is about the user's own text. It does not say where typed characters
+ * land, and for two rows it flags alike the measured answer is opposite:
+ *
+ * | row | on screen | free text + Enter |
+ * |-----|-----------|-------------------|
+ * | Command Code `AskUserQuestion` `Type something...` (#2522) | a `TextInput` | lands in the field — the answer |
+ * | Command Code permission `No, tell Command Code what to do differently` | a menu row | ignored; the Enter confirms the highlighted `1. Yes` |
+ *
+ * The second is how a "No + reason" was delivered as an approval. The same
+ * words sit on codex's and copilot's approval rows (codex's also name letter
+ * hotkeys, `(y)` / `(p)`), and the generic patterns match inside the command an
+ * approval row quotes (`… commands that start with 'npm run custom'`).
+ *
+ * So this is an allowlist of what was measured, not a denylist of what went
+ * wrong: a flagged row is a field only when its label is one of these. Anchored
+ * at the start so Command Code's folded description (`Type something... Give me
+ * a branch name …`) still matches. Command Code's reader
+ * (`tools/command-code/dialog.ts`) marks the same rows with the same expression.
+ *
+ * The one definition since Issue #3218: `isTypedTextFieldOption` in
+ * `lib/detection/prompt-detect-multiple-choice`, whose graph reaches `fs`,
+ * reads it through `optionTakesTypedText` below.
+ */
+export declare const TYPED_TEXT_FIELD_LABEL_PATTERNS: readonly RegExp[];
+/**
+ * Whether an option is a text field on screen, so its answer is the typed TEXT
+ * rather than its number (Issue #2573). `requiresTextInput` alone is also true
+ * for a menu row such as `No, tell Command Code what to do differently`.
+ */
+export declare function optionTakesTypedText(option: {
+    readonly label: string;
+    readonly requiresTextInput?: boolean;
+}): boolean;
+/**
+ * The decision id a payload names, or null (Issue #1932). A validating read:
+ * absent, empty or not a string is "no addressable decision".
+ */
+export declare function readDecisionId(source: PromptViewSource | null | undefined): string | null;
+/** The choices of a question answered over the API (Issue #2039 / #2951). */
+export interface QuestionChoices {
+    question: string;
+    /** In payload order; the answer is the 1-based POSITION in this list. */
+    labels: string[];
+    questionCount: number;
+    /** A typed answer is accepted besides the choices (#2951). */
+    custom?: true;
+}
+/**
+ * The choices a question offers when it may be answered over the API, or null
+ * (Issue #2039). All three must hold: a decision id, exactly one question with
+ * a complete label list, and NO approval verdicts on the same payload.
+ */
+export declare function readQuestionChoices(source: PromptViewSource | null | undefined): QuestionChoices | null;
+/** What a heading should say when the payload carries addressable choices (#3181). */
+export type DecisionHeading = {
+    kind: 'approval';
+    toolName: string | null;
+} | {
+    kind: 'question';
+};
+/** The heading for addressable choices, or null when there is nothing to click (#3181). */
+export declare function readDecisionHeading(source: PromptViewSource | null | undefined): DecisionHeading | null;
+/**
+ * Decide how a prompt payload is shown and answered (Issue #3184).
+ *
+ * Evaluated in this order (design §2.3):
+ *  1. any `type` but the unclassified sentinel → `screen-choices`;
+ *  2. unclassified + decision id + approval verdicts → `api-choices` (approval);
+ *  3. unclassified + decision id + one complete question → `api-choices` (question);
+ *  4. every other unclassified payload — no id, #1932's options-without-id half
+ *     state, and both stored history records — → `unreadable`.
+ *
+ * @param source - A live or stored prompt payload, or null
+ * @returns The view, or null when there is no prompt
+ */
+export declare function derivePromptView(source: PromptViewSource | null | undefined): PromptView | null;
+/**
+ * The view a `current-output` payload carries, falling back to deriving it.
+ *
+ * `??`, not `||`: a server from before #3184 sends no `promptView`, and its
+ * absence means "this daemon does not publish the field" — the same function
+ * then decides from `promptData`, so old and new servers reach the same answer.
+ */
+export declare function readPromptView(payload: {
+    promptView?: PromptView | null;
+    promptData?: PromptViewSource | null;
+} | null | undefined): PromptView | null;
+//# sourceMappingURL=prompt-view.d.ts.map

package/dist/lib/session/prompt-view.d.ts.map

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

package/dist/lib/session/prompt-view.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * How a waiting prompt is shown and answered, decided once (Issue #3184).
+ *
+ * Before this module every reader of a prompt payload re-derived the same three
+ * facts for itself — "can it be answered?", "where are the choices?", "is the
+ * answer a keystroke or an API call?" — from `type`, `options`,
+ * `decisionOptions`, `decisionId` and `askUserQuestion`. The panel, the phone
+ * sheet, the chat surface, Auto-Yes and `wait` each combined them a little
+ * differently, and a fix to one surface kept missing the others (#2775 →
+ * #2810 → #2822, #3181). {@link derivePromptView} is the one combination; a
+ * reader takes its {@link PromptView} and does not look at the raw fields to
+ * decide what to show.
+ *
+ * ## No imports, on purpose
+ *
+ * The CLI (`tsconfig.cli.json`) compiles with `"paths": {}`, so it can reach a
+ * module under `src/lib` by a relative path only when nothing in that module's
+ * graph uses the `@/` alias. `types/models` and `session/structured-prompt` both
+ * do. The input is therefore a structural type ({@link PromptViewSource}) that
+ * every existing prompt shape — `LivePromptData`, `StoredPromptData`, the CLI's
+ * own `PromptData` mirror — satisfies without a cast, and this file stays
+ * importable from a client component, the server and the CLI alike.
+ *
+ * ## What it does not replace
+ *
+ * `isAnswerablePromptData()` (`types/models`) stays: it narrows to the closed
+ * `PromptData` union (#1725) for the code that builds an answer body. The two
+ * agree by construction — `derivePromptView(x)?.kind === 'screen-choices'`
+ * exactly when `isAnswerablePromptData(x)` — and
+ * `tests/unit/session/prompt-view-3184.test.ts` holds that over every fixture.
+ *
+ * @module lib/session/prompt-view
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TYPED_TEXT_FIELD_LABEL_PATTERNS = exports.UNCLASSIFIED_PROMPT_VIEW_TYPE = void 0;
+exports.promptHeadingMessage = promptHeadingMessage;
+exports.optionTakesTypedText = optionTakesTypedText;
+exports.readDecisionId = readDecisionId;
+exports.readQuestionChoices = readQuestionChoices;
+exports.readDecisionHeading = readDecisionHeading;
+exports.derivePromptView = derivePromptView;
+exports.readPromptView = readPromptView;
+/**
+ * `promptData.type` for a frame nothing could classify. Same value as
+ * `UNCLASSIFIED_PROMPT_TYPE` in `types/models`, restated because this module may
+ * not import it (see the module note); the test asserts the two are equal.
+ */
+exports.UNCLASSIFIED_PROMPT_VIEW_TYPE = 'unclassified';
+function promptHeadingMessage(heading) {
+    switch (heading.kind) {
+        case 'question':
+            return { text: heading.text };
+        case 'approval':
+            return heading.toolName
+                ? { key: 'structuredApprovalTitle', values: { toolName: heading.toolName } }
+                : { key: 'structuredApprovalTitleNoTool' };
+        case 'agent-question':
+            return { key: 'structuredQuestionTitle' };
+        case 'unreadable':
+            return { key: 'unclassifiedTitle' };
+    }
+}
+// =============================================================================
+// Field readers (moved from components/worktree/prompt-decision-id, #1932/#2039/#3181)
+// =============================================================================
+/**
+ * Labels of the rows measured to BE a text field on screen (Issue #2573).
+ *
+ * `requiresTextInput` (from {@link TEXT_INPUT_PATTERNS}) reads the WORDS of a
+ * label — "tell … what to do differently", "custom", "enter …" — and says the
+ * option is about the user's own text. It does not say where typed characters
+ * land, and for two rows it flags alike the measured answer is opposite:
+ *
+ * | row | on screen | free text + Enter |
+ * |-----|-----------|-------------------|
+ * | Command Code `AskUserQuestion` `Type something...` (#2522) | a `TextInput` | lands in the field — the answer |
+ * | Command Code permission `No, tell Command Code what to do differently` | a menu row | ignored; the Enter confirms the highlighted `1. Yes` |
+ *
+ * The second is how a "No + reason" was delivered as an approval. The same
+ * words sit on codex's and copilot's approval rows (codex's also name letter
+ * hotkeys, `(y)` / `(p)`), and the generic patterns match inside the command an
+ * approval row quotes (`… commands that start with 'npm run custom'`).
+ *
+ * So this is an allowlist of what was measured, not a denylist of what went
+ * wrong: a flagged row is a field only when its label is one of these. Anchored
+ * at the start so Command Code's folded description (`Type something... Give me
+ * a branch name …`) still matches. Command Code's reader
+ * (`tools/command-code/dialog.ts`) marks the same rows with the same expression.
+ *
+ * The one definition since Issue #3218: `isTypedTextFieldOption` in
+ * `lib/detection/prompt-detect-multiple-choice`, whose graph reaches `fs`,
+ * reads it through `optionTakesTypedText` below.
+ */
+exports.TYPED_TEXT_FIELD_LABEL_PATTERNS = [
+    /^[^\S\n]*type\s+something\b/i,
+];
+/**
+ * Whether an option is a text field on screen, so its answer is the typed TEXT
+ * rather than its number (Issue #2573). `requiresTextInput` alone is also true
+ * for a menu row such as `No, tell Command Code what to do differently`.
+ */
+function optionTakesTypedText(option) {
+    return option.requiresTextInput === true
+        && exports.TYPED_TEXT_FIELD_LABEL_PATTERNS.some((pattern) => pattern.test(option.label));
+}
+/**
+ * The decision id a payload names, or null (Issue #1932). A validating read:
+ * absent, empty or not a string is "no addressable decision".
+ */
+function readDecisionId(source) {
+    if (!source)
+        return null;
+    const candidate = source.decisionId;
+    return typeof candidate === 'string' && candidate !== '' ? candidate : null;
+}
+function hasDecisionOptions(source) {
+    return Array.isArray(source.decisionOptions) && source.decisionOptions.length > 0;
+}
+/**
+ * The choices a question offers when it may be answered over the API, or null
+ * (Issue #2039). All three must hold: a decision id, exactly one question with
+ * a complete label list, and NO approval verdicts on the same payload.
+ */
+function readQuestionChoices(source) {
+    if (!source || readDecisionId(source) === null)
+        return null;
+    if (hasDecisionOptions(source))
+        return null;
+    const asked = source.askUserQuestion;
+    if (!asked || typeof asked.question !== 'string' || asked.question === '')
+        return null;
+    if (!Array.isArray(asked.labels) || asked.labels.length === 0)
+        return null;
+    const labels = asked.labels.filter((label) => typeof label === 'string' && label !== '');
+    // Partial is worse than none: the numbers are positions in this list.
+    if (labels.length !== asked.labels.length)
+        return null;
+    const questionCount = typeof asked.questionCount === 'number' ? asked.questionCount : 1;
+    if (questionCount !== 1)
+        return null;
+    return {
+        question: asked.question,
+        labels,
+        questionCount,
+        ...(asked.custom === true ? { custom: true } : {}),
+    };
+}
+/** The heading for addressable choices, or null when there is nothing to click (#3181). */
+function readDecisionHeading(source) {
+    if (!source || readDecisionId(source) === null)
+        return null;
+    if (hasDecisionOptions(source)) {
+        return {
+            kind: 'approval',
+            toolName: typeof source.toolName === 'string' && source.toolName ? source.toolName : null,
+        };
+    }
+    return readQuestionChoices(source) ? { kind: 'question' } : null;
+}
+// =============================================================================
+// The view
+// =============================================================================
+function screenChoices(source) {
+    const options = Array.isArray(source.options) ? source.options : [];
+    const choices = [];
+    for (const option of options) {
+        if (typeof option === 'string') {
+            // yes_no: `['yes', 'no']`, answered by the word itself.
+            choices.push({
+                answer: option,
+                label: option,
+                isDefault: source.defaultOption === option,
+                takesText: false,
+            });
+            continue;
+        }
+        if (!option || typeof option !== 'object')
+            continue;
+        const o = option;
+        if (typeof o.number !== 'number' || typeof o.label !== 'string')
+            continue;
+        choices.push({
+            answer: String(o.number),
+            label: o.label,
+            isDefault: o.isDefault === true,
+            takesText: optionTakesTypedText({ label: o.label, requiresTextInput: o.requiresTextInput === true }),
+            ...(typeof o.description === 'string' ? { description: o.description } : {}),
+        });
+    }
+    return choices;
+}
+function decisionChoices(decisionOptions) {
+    if (!Array.isArray(decisionOptions))
+        return [];
+    const choices = [];
+    for (const option of decisionOptions) {
+        const o = option;
+        if (!o || typeof o.number !== 'number' || typeof o.label !== 'string')
+            continue;
+        choices.push({ answer: String(o.number), label: o.label, isDefault: false, takesText: false });
+    }
+    return choices;
+}
+const UNREADABLE_VIEW = {
+    kind: 'unreadable',
+    heading: { kind: 'unreadable' },
+    choices: [],
+    multiSelect: false,
+    freeText: null,
+    decisionId: null,
+    apiTarget: null,
+};
+/**
+ * Decide how a prompt payload is shown and answered (Issue #3184).
+ *
+ * Evaluated in this order (design §2.3):
+ *  1. any `type` but the unclassified sentinel → `screen-choices`;
+ *  2. unclassified + decision id + approval verdicts → `api-choices` (approval);
+ *  3. unclassified + decision id + one complete question → `api-choices` (question);
+ *  4. every other unclassified payload — no id, #1932's options-without-id half
+ *     state, and both stored history records — → `unreadable`.
+ *
+ * @param source - A live or stored prompt payload, or null
+ * @returns The view, or null when there is no prompt
+ */
+function derivePromptView(source) {
+    if (source == null)
+        return null;
+    if (source.type !== exports.UNCLASSIFIED_PROMPT_VIEW_TYPE) {
+        const choices = screenChoices(source);
+        return {
+            kind: 'screen-choices',
+            heading: { kind: 'question', text: typeof source.question === 'string' ? source.question : '' },
+            choices,
+            multiSelect: source.multiSelect === true,
+            freeText: choices.some((choice) => choice.takesText) ? { via: 'screen' } : null,
+            decisionId: null,
+            apiTarget: null,
+        };
+    }
+    const decisionId = readDecisionId(source);
+    if (decisionId !== null && hasDecisionOptions(source)) {
+        const choices = decisionChoices(source.decisionOptions);
+        if (choices.length > 0) {
+            return {
+                kind: 'api-choices',
+                heading: {
+                    kind: 'approval',
+                    toolName: typeof source.toolName === 'string' && source.toolName ? source.toolName : null,
+                },
+                choices,
+                multiSelect: false,
+                freeText: null,
+                decisionId,
+                apiTarget: 'approval',
+            };
+        }
+    }
+    const question = readQuestionChoices(source);
+    if (decisionId !== null && question !== null) {
+        return {
+            kind: 'api-choices',
+            heading: { kind: 'agent-question', text: question.question },
+            choices: question.labels.map((label, index) => ({
+                answer: String(index + 1),
+                label,
+                isDefault: false,
+                takesText: false,
+            })),
+            multiSelect: false,
+            freeText: question.custom === true ? { via: 'api' } : null,
+            decisionId,
+            apiTarget: 'question',
+        };
+    }
+    return UNREADABLE_VIEW;
+}
+/**
+ * The view a `current-output` payload carries, falling back to deriving it.
+ *
+ * `??`, not `||`: a server from before #3184 sends no `promptView`, and its
+ * absence means "this daemon does not publish the field" — the same function
+ * then decides from `promptData`, so old and new servers reach the same answer.
+ */
+function readPromptView(payload) {
+    if (!payload)
+        return null;
+    return payload.promptView ?? derivePromptView(payload.promptData);
+}

package/dist/lib/session/status-evidence-type.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Whether a status rests on something positive, or on the absence of a negative
+ * (Issue #1924, §4 D1 決定 2).
+ *
+ * `'positive'` — a marker, a tool-specific idle-composer rule, or a structured
+ * event said so. `'none'` — nothing on the frame could be read either way, and
+ * the status is a fallback.
+ *
+ * The design policy adds this rather than a fifth `SessionStatus`: the value
+ * domain stays four wide, because `src/cli/types/api-responses.ts` enumerates it
+ * and a new member is a breaking change for every consumer older than the server
+ * — including `commandmate-skills`' `orchestrate-monitor`, which reads
+ * `capture --json` as its primary signal.
+ */
+export type StatusEvidence = 'positive' | 'none';
+//# sourceMappingURL=status-evidence-type.d.ts.map

package/dist/lib/session/status-evidence-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-evidence-type.d.ts","sourceRoot":"","sources":["../../../src/lib/session/status-evidence-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,MAAM,CAAC"}

package/dist/lib/session/status-evidence-type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/tmux/legacy-session-alias.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-session-alias.d.ts","sourceRoot":"","sources":["../../../src/lib/tmux/legacy-session-alias.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,wBAAwB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC/D;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAE7E;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAUvE;AAED,wCAAwC;AACxC,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}
+{"version":3,"file":"legacy-session-alias.d.ts","sourceRoot":"","sources":["../../../src/lib/tmux/legacy-session-alias.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,wBAAwB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC/D;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAE7E;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAUvE;AAED,wCAAwC;AACxC,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}

package/dist/lib/tmux/legacy-session-alias.js

@@ -27,8 +27,9 @@ exports.registerLegacyAlias = registerLegacyAlias;
 exports.lookupLegacyAlias = lookupLegacyAlias;
 exports.dropLegacyAliasByLegacyName = dropLegacyAliasByLegacyName;
 exports.clearLegacyAliasesForTests = clearLegacyAliasesForTests;
+const global_state_1 = require("../global-state");
 function aliases() {
-    return (globalThis.__cmLegacySessionAliases ??= new Map());
+    return (0, global_state_1.getOrInitGlobal)('__cmLegacySessionAliases', () => new Map());
 }
 /**
  * Serve the new-format session name `newName` with the existing legacy session

package/dist/server/locales/en/worktree.json

@@ -1107,9 +1107,11 @@
     },
     "promptResponse": {
         "refused": "Your answer was not sent because the dialog has changed. Please check the screen.",
+        "failed": "Could not send the answer. Please try again.",
         "stuckHint": "If sending does not work, operate the terminal in direct input mode.",
         "stuckHintLink": "Switch to direct input",
-        "unanswerable": "CommandMate cannot operate this screen. Use direct input mode instead."
+        "unanswerable": "CommandMate cannot operate this screen. Use direct input mode instead.",
+        "autoYesEnterSent": "Auto-Yes sent Enter."
     },
     "dismissPanelKeys": {
         "toolbarLabel": "Close this screen",

package/dist/server/locales/ja/worktree.json

@@ -1107,9 +1107,11 @@
     },
     "promptResponse": {
         "refused": "ダイアログの状態が変わったため送信できませんでした。画面を確認してください。",
+        "failed": "送信に失敗しました。もう一度お試しください。",
         "stuckHint": "送信がうまくいかない場合は、直接入力モードで操作してください。",
         "stuckHintLink": "直接入力に切り替える",
-        "unanswerable": "この画面は CommandMate から操作できません。直接入力モードで操作してください。"
+        "unanswerable": "この画面は CommandMate から操作できません。直接入力モードで操作してください。",
+        "autoYesEnterSent": "Auto-Yes が Enter を送りました。"
     },
     "dismissPanelKeys": {
         "toolbarLabel": "この画面を閉じる",