@ai-agent-forge/agent-forge 0.88.2 → 0.88.4

package/dist/modes/interactive/interactive-queues.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Queue management for interactive mode (拆分 slice 3,
+ * docs/plans/interactive-mode拆分计划.md): the follow-up/dequeue entry points,
+ * the /queue, /dequeue, and /queue-list command faces, the merged
+ * pending-messages display under the editor, and the compaction queue
+ * (messages held back while compaction is running).
+ *
+ * InteractiveMode implements QueuesHost and keeps same-name delegate methods so
+ * prototype-level tests, the command dispatch table, and the selector surface
+ * keep working; the functions below receive the mode through QueuesHost.
+ * restoreQueuedMessagesToEditor stays on the mode (the Esc interrupt path and
+ * the selectors call it), and the queue manager overlay stays in
+ * ./interactive-selectors.ts — this module reaches it only through the host
+ * method (host.showQueueManagerSelector), so no sibling module imports another.
+ *
+ * Internal collaboration interface (same pattern as AuthUiHost): not a plugin
+ * API and not exported from the package root.
+ */
+import type { Container, EditorComponent, TUI } from "@agent-forge/tui";
+import type { CodingAgentFacadeV1 } from "../../core/facade/index.ts";
+import type { AppKeybinding } from "../../core/keybindings.ts";
+/** A message held back while compaction is running (steer or follow-up). */
+export type CompactionQueuedMessage = {
+    text: string;
+    mode: "steer" | "followUp";
+};
+/**
+ * Host surface InteractiveMode exposes to this module: the queue entry points
+ * (which stay on the mode for dispatch and prototype-level tests), the editor
+ * and pending-messages containers, the stable facade, and the compaction queue
+ * state (which lives on the mode because renderCurrentSessionState resets it).
+ *
+ * Internal collaboration interface (same pattern as AuthUiHost): not a plugin
+ * API and not exported from the package root.
+ */
+export interface QueuesHost {
+    ui: TUI;
+    editor: EditorComponent;
+    /** Stable facade (阶段 1 slice 1). */
+    facade: CodingAgentFacadeV1;
+    pendingMessagesContainer: Container;
+    /** Compaction queue state; reset by the mode's renderCurrentSessionState. */
+    compactionQueuedMessages: CompactionQueuedMessage[];
+    showStatus(message: string): void;
+    showError(message: string): void;
+    /** Restores queued messages into the editor; stays on the mode (Esc + selectors). */
+    restoreQueuedMessagesToEditor(options?: {
+        abort?: boolean;
+        /** Interrupt grading (设计 子代理运行时 §4.2): false aborts the turn
+         * without cancelling background agent tasks. */
+        cancelAgentTasks?: boolean;
+        currentText?: string;
+    }): number;
+    /** Capitalized display string for an app keybinding action (./interactive-commands.ts). */
+    getAppKeyDisplay(action: AppKeybinding): string;
+    /** Queue manager overlay; the implementation stays in ./interactive-selectors.ts. */
+    showQueueManagerSelector(): void;
+    handleFollowUp(explicitText?: string): Promise<void>;
+    handleDequeue(): void;
+    getAllQueuedMessages(): {
+        steering: string[];
+        followUp: string[];
+    };
+    updatePendingMessagesDisplay(): void;
+    queueCompactionMessage(text: string, mode: "steer" | "followUp"): void;
+}
+export declare function handleFollowUp(host: QueuesHost, explicitText?: string): Promise<void>;
+export declare function handleDequeue(host: QueuesHost): void;
+/** /queue command host face (single-entry iron law): queues the given text for after the current run. A bare /queue cannot mirror the keybinding — the editor buffer is cleared on submit before the command runs — so it prints usage instead of silently doing nothing. */
+export declare function handleQueueCommand(host: QueuesHost, text: string | undefined): Promise<void>;
+/** /dequeue command host face: restore queued messages back to the editor. */
+export declare function handleDequeueCommand(host: QueuesHost): void;
+/** /queue-list command host face: open the queued-message manager selector. Both queues empty is a status message, not an empty overlay. */
+export declare function handleQueueListCommand(host: QueuesHost): void;
+/**
+ * Get all queued messages (read-only).
+ * Combines session queue and compaction queue.
+ */
+export declare function getAllQueuedMessages(host: QueuesHost): {
+    steering: string[];
+    followUp: string[];
+};
+/**
+ * Clear all queued messages and return their contents.
+ * Clears both session queue and compaction queue.
+ */
+export declare function clearAllQueues(host: QueuesHost): {
+    steering: string[];
+    followUp: string[];
+};
+export declare function updatePendingMessagesDisplay(host: QueuesHost): void;
+export declare function queueCompactionMessage(host: QueuesHost, text: string, mode: "steer" | "followUp"): void;
+export declare function flushCompactionQueue(host: QueuesHost, options?: {
+    willRetry?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=interactive-queues.d.ts.map

package/dist/modes/interactive/interactive-queues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-queues.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/interactive-queues.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Queue management for interactive mode (拆分 slice 3,\n * docs/plans/interactive-mode拆分计划.md): the follow-up/dequeue entry points,\n * the /queue, /dequeue, and /queue-list command faces, the merged\n * pending-messages display under the editor, and the compaction queue\n * (messages held back while compaction is running).\n *\n * InteractiveMode implements QueuesHost and keeps same-name delegate methods so\n * prototype-level tests, the command dispatch table, and the selector surface\n * keep working; the functions below receive the mode through QueuesHost.\n * restoreQueuedMessagesToEditor stays on the mode (the Esc interrupt path and\n * the selectors call it), and the queue manager overlay stays in\n * ./interactive-selectors.ts — this module reaches it only through the host\n * method (host.showQueueManagerSelector), so no sibling module imports another.\n *\n * Internal collaboration interface (same pattern as AuthUiHost): not a plugin\n * API and not exported from the package root.\n */\nimport type { Container, EditorComponent, TUI } from \"@agent-forge/tui\";\nimport { Spacer, TruncatedText } from \"@agent-forge/tui\";\nimport type { CodingAgentFacadeV1 } from \"../../core/facade/index.ts\";\nimport { t } from \"../../core/i18n/index.ts\";\nimport type { AppKeybinding } from \"../../core/keybindings.ts\";\nimport { theme } from \"../../theme/theme.ts\";\n\n/** A message held back while compaction is running (steer or follow-up). */\nexport type CompactionQueuedMessage = {\n\ttext: string;\n\tmode: \"steer\" | \"followUp\";\n};\n\n/**\n * Host surface InteractiveMode exposes to this module: the queue entry points\n * (which stay on the mode for dispatch and prototype-level tests), the editor\n * and pending-messages containers, the stable facade, and the compaction queue\n * state (which lives on the mode because renderCurrentSessionState resets it).\n *\n * Internal collaboration interface (same pattern as AuthUiHost): not a plugin\n * API and not exported from the package root.\n */\nexport interface QueuesHost {\n\tui: TUI;\n\teditor: EditorComponent;\n\t/** Stable facade (阶段 1 slice 1). */\n\tfacade: CodingAgentFacadeV1;\n\tpendingMessagesContainer: Container;\n\t/** Compaction queue state; reset by the mode's renderCurrentSessionState. */\n\tcompactionQueuedMessages: CompactionQueuedMessage[];\n\n\tshowStatus(message: string): void;\n\tshowError(message: string): void;\n\t/** Restores queued messages into the editor; stays on the mode (Esc + selectors). */\n\trestoreQueuedMessagesToEditor(options?: {\n\t\tabort?: boolean;\n\t\t/** Interrupt grading (设计 子代理运行时 §4.2): false aborts the turn\n\t\t * without cancelling background agent tasks. */\n\t\tcancelAgentTasks?: boolean;\n\t\tcurrentText?: string;\n\t}): number;\n\t/** Capitalized display string for an app keybinding action (./interactive-commands.ts). */\n\tgetAppKeyDisplay(action: AppKeybinding): string;\n\t/** Queue manager overlay; the implementation stays in ./interactive-selectors.ts. */\n\tshowQueueManagerSelector(): void;\n\thandleFollowUp(explicitText?: string): Promise<void>;\n\thandleDequeue(): void;\n\tgetAllQueuedMessages(): { steering: string[]; followUp: string[] };\n\tupdatePendingMessagesDisplay(): void;\n\tqueueCompactionMessage(text: string, mode: \"steer\" | \"followUp\"): void;\n}\n\nexport async function handleFollowUp(host: QueuesHost, explicitText?: string): Promise<void> {\n\tconst text = (explicitText ?? host.editor.getExpandedText?.() ?? host.editor.getText()).trim();\n\tif (!text) return;\n\n\t// Queue input during compaction (extension commands execute immediately)\n\tif (host.facade.isCompacting()) {\n\t\thost.queueCompactionMessage(text, \"followUp\");\n\t\treturn;\n\t}\n\n\t// Alt+Enter queues a follow-up message (waits until agent finishes)\n\t// This handles extension commands (execute immediately), prompt template expansion, and queueing\n\tif (host.facade.isStreaming()) {\n\t\t// An explicit /queue <text> argument must not touch the editor draft.\n\t\tif (explicitText === undefined) {\n\t\t\thost.editor.addToHistory?.(text);\n\t\t\thost.editor.setText(\"\");\n\t\t}\n\t\tawait host.facade.prompt(text, { streamingBehavior: \"followUp\" });\n\t\thost.updatePendingMessagesDisplay();\n\t\thost.ui.requestRender();\n\t}\n\t// If not streaming, Alt+Enter acts like regular Enter (trigger onSubmit)\n\telse if (host.editor.onSubmit) {\n\t\tif (explicitText === undefined) host.editor.setText(\"\");\n\t\thost.editor.onSubmit(text);\n\t}\n}\n\nexport function handleDequeue(host: QueuesHost): void {\n\tconst restored = host.restoreQueuedMessagesToEditor();\n\tif (restored === 0) {\n\t\thost.showStatus(t(\"No queued messages to restore\"));\n\t} else if (restored === 1) {\n\t\thost.showStatus(t(\"Restored {count} queued message to editor\", { count: restored }));\n\t} else {\n\t\thost.showStatus(t(\"Restored {count} queued messages to editor\", { count: restored }));\n\t}\n}\n\n/** /queue command host face (single-entry iron law): queues the given text for after the current run. A bare /queue cannot mirror the keybinding — the editor buffer is cleared on submit before the command runs — so it prints usage instead of silently doing nothing. */\nexport function handleQueueCommand(host: QueuesHost, text: string | undefined): Promise<void> {\n\tif (text === undefined || text.trim() === \"\") {\n\t\thost.showStatus(t(\"Usage: /queue <text>\"));\n\t\treturn Promise.resolve();\n\t}\n\treturn host.handleFollowUp(text);\n}\n\n/** /dequeue command host face: restore queued messages back to the editor. */\nexport function handleDequeueCommand(host: QueuesHost): void {\n\thost.handleDequeue();\n}\n\n/** /queue-list command host face: open the queued-message manager selector. Both queues empty is a status message, not an empty overlay. */\nexport function handleQueueListCommand(host: QueuesHost): void {\n\tconst steering = host.facade.getSteeringMessages();\n\tconst followUp = host.facade.getFollowUpMessages();\n\tif (steering.length === 0 && followUp.length === 0) {\n\t\thost.showStatus(t(\"No queued messages to manage\"));\n\t\treturn;\n\t}\n\thost.showQueueManagerSelector();\n}\n\n/**\n * Get all queued messages (read-only).\n * Combines session queue and compaction queue.\n */\nexport function getAllQueuedMessages(host: QueuesHost): { steering: string[]; followUp: string[] } {\n\treturn {\n\t\tsteering: [\n\t\t\t...host.facade.getSteeringMessages(),\n\t\t\t...host.compactionQueuedMessages.filter((msg) => msg.mode === \"steer\").map((msg) => msg.text),\n\t\t],\n\t\tfollowUp: [\n\t\t\t...host.facade.getFollowUpMessages(),\n\t\t\t...host.compactionQueuedMessages.filter((msg) => msg.mode === \"followUp\").map((msg) => msg.text),\n\t\t],\n\t};\n}\n\n/**\n * Clear all queued messages and return their contents.\n * Clears both session queue and compaction queue.\n */\nexport function clearAllQueues(host: QueuesHost): { steering: string[]; followUp: string[] } {\n\tconst { steering, followUp } = host.facade.clearQueue();\n\tconst compactionSteering = host.compactionQueuedMessages\n\t\t.filter((msg) => msg.mode === \"steer\")\n\t\t.map((msg) => msg.text);\n\tconst compactionFollowUp = host.compactionQueuedMessages\n\t\t.filter((msg) => msg.mode === \"followUp\")\n\t\t.map((msg) => msg.text);\n\thost.compactionQueuedMessages = [];\n\treturn {\n\t\tsteering: [...steering, ...compactionSteering],\n\t\tfollowUp: [...followUp, ...compactionFollowUp],\n\t};\n}\n\nexport function updatePendingMessagesDisplay(host: QueuesHost): void {\n\thost.pendingMessagesContainer.clear();\n\tconst { steering: steeringMessages, followUp: followUpMessages } = host.getAllQueuedMessages();\n\tif (steeringMessages.length > 0 || followUpMessages.length > 0) {\n\t\thost.pendingMessagesContainer.addChild(new Spacer(1));\n\t\tfor (const message of steeringMessages) {\n\t\t\tconst text = theme.fg(\"dim\", t(\"Steering: {message}\", { message }));\n\t\t\thost.pendingMessagesContainer.addChild(new TruncatedText(text, 1, 0));\n\t\t}\n\t\tfor (const message of followUpMessages) {\n\t\t\tconst text = theme.fg(\"dim\", t(\"Follow-up: {message}\", { message }));\n\t\t\thost.pendingMessagesContainer.addChild(new TruncatedText(text, 1, 0));\n\t\t}\n\t\t// The dequeue keybinding's shipped default was cleared (iron law):\n\t\t// /queue's sibling command is the discoverable entry.\n\t\tconst dequeueHint = host.getAppKeyDisplay(\"app.message.dequeue\") || \"/dequeue\";\n\t\tconst hintText = theme.fg(\"dim\", t(\"↳ {key} to edit all queued messages\", { key: dequeueHint }));\n\t\thost.pendingMessagesContainer.addChild(new TruncatedText(hintText, 1, 0));\n\t}\n}\n\nexport function queueCompactionMessage(host: QueuesHost, text: string, mode: \"steer\" | \"followUp\"): void {\n\thost.compactionQueuedMessages.push({ text, mode });\n\thost.editor.addToHistory?.(text);\n\thost.editor.setText(\"\");\n\thost.updatePendingMessagesDisplay();\n\thost.showStatus(t(\"Queued message for after compaction\"));\n}\n\nexport async function flushCompactionQueue(host: QueuesHost, options?: { willRetry?: boolean }): Promise<void> {\n\tif (host.compactionQueuedMessages.length === 0) {\n\t\treturn;\n\t}\n\n\tconst queuedMessages = [...host.compactionQueuedMessages];\n\thost.compactionQueuedMessages = [];\n\thost.updatePendingMessagesDisplay();\n\n\tconst restoreQueue = (error: unknown) => {\n\t\thost.facade.clearQueue();\n\t\thost.compactionQueuedMessages = queuedMessages;\n\t\thost.updatePendingMessagesDisplay();\n\t\thost.showError(\n\t\t\tqueuedMessages.length > 1\n\t\t\t\t? t(\"Failed to send queued messages: {error}\", {\n\t\t\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t})\n\t\t\t\t: t(\"Failed to send queued message: {error}\", {\n\t\t\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t}),\n\t\t);\n\t};\n\n\ttry {\n\t\tif (options?.willRetry) {\n\t\t\t// When retry is pending, queue messages for the retry turn\n\t\t\tfor (const message of queuedMessages) {\n\t\t\t\tif (message.mode === \"followUp\") {\n\t\t\t\t\tawait host.facade.followUp(message.text);\n\t\t\t\t} else {\n\t\t\t\t\tawait host.facade.steer(message.text);\n\t\t\t\t}\n\t\t\t}\n\t\t\thost.updatePendingMessagesDisplay();\n\t\t\treturn;\n\t\t}\n\n\t\tconst [firstPrompt, ...rest] = queuedMessages;\n\n\t\t// Start a prompt when idle, or queue it into a run still finishing compaction.\n\t\tconst promptPromise = host.facade\n\t\t\t.prompt(firstPrompt.text, { streamingBehavior: firstPrompt.mode })\n\t\t\t.catch((error) => {\n\t\t\t\trestoreQueue(error);\n\t\t\t});\n\n\t\t// Queue remaining messages\n\t\tfor (const message of rest) {\n\t\t\tif (message.mode === \"followUp\") {\n\t\t\t\tawait host.facade.followUp(message.text);\n\t\t\t} else {\n\t\t\t\tawait host.facade.steer(message.text);\n\t\t\t}\n\t\t}\n\t\thost.updatePendingMessagesDisplay();\n\t\tvoid promptPromise;\n\t} catch (error) {\n\t\trestoreQueue(error);\n\t}\n}\n"]}

package/dist/modes/interactive/interactive-queues.js

@@ -0,0 +1,183 @@
+import { Spacer, TruncatedText } from "@agent-forge/tui";
+import { t } from "../../core/i18n/index.js";
+import { theme } from "../../theme/theme.js";
+export async function handleFollowUp(host, explicitText) {
+    const text = (explicitText ?? host.editor.getExpandedText?.() ?? host.editor.getText()).trim();
+    if (!text)
+        return;
+    // Queue input during compaction (extension commands execute immediately)
+    if (host.facade.isCompacting()) {
+        host.queueCompactionMessage(text, "followUp");
+        return;
+    }
+    // Alt+Enter queues a follow-up message (waits until agent finishes)
+    // This handles extension commands (execute immediately), prompt template expansion, and queueing
+    if (host.facade.isStreaming()) {
+        // An explicit /queue <text> argument must not touch the editor draft.
+        if (explicitText === undefined) {
+            host.editor.addToHistory?.(text);
+            host.editor.setText("");
+        }
+        await host.facade.prompt(text, { streamingBehavior: "followUp" });
+        host.updatePendingMessagesDisplay();
+        host.ui.requestRender();
+    }
+    // If not streaming, Alt+Enter acts like regular Enter (trigger onSubmit)
+    else if (host.editor.onSubmit) {
+        if (explicitText === undefined)
+            host.editor.setText("");
+        host.editor.onSubmit(text);
+    }
+}
+export function handleDequeue(host) {
+    const restored = host.restoreQueuedMessagesToEditor();
+    if (restored === 0) {
+        host.showStatus(t("No queued messages to restore"));
+    }
+    else if (restored === 1) {
+        host.showStatus(t("Restored {count} queued message to editor", { count: restored }));
+    }
+    else {
+        host.showStatus(t("Restored {count} queued messages to editor", { count: restored }));
+    }
+}
+/** /queue command host face (single-entry iron law): queues the given text for after the current run. A bare /queue cannot mirror the keybinding — the editor buffer is cleared on submit before the command runs — so it prints usage instead of silently doing nothing. */
+export function handleQueueCommand(host, text) {
+    if (text === undefined || text.trim() === "") {
+        host.showStatus(t("Usage: /queue <text>"));
+        return Promise.resolve();
+    }
+    return host.handleFollowUp(text);
+}
+/** /dequeue command host face: restore queued messages back to the editor. */
+export function handleDequeueCommand(host) {
+    host.handleDequeue();
+}
+/** /queue-list command host face: open the queued-message manager selector. Both queues empty is a status message, not an empty overlay. */
+export function handleQueueListCommand(host) {
+    const steering = host.facade.getSteeringMessages();
+    const followUp = host.facade.getFollowUpMessages();
+    if (steering.length === 0 && followUp.length === 0) {
+        host.showStatus(t("No queued messages to manage"));
+        return;
+    }
+    host.showQueueManagerSelector();
+}
+/**
+ * Get all queued messages (read-only).
+ * Combines session queue and compaction queue.
+ */
+export function getAllQueuedMessages(host) {
+    return {
+        steering: [
+            ...host.facade.getSteeringMessages(),
+            ...host.compactionQueuedMessages.filter((msg) => msg.mode === "steer").map((msg) => msg.text),
+        ],
+        followUp: [
+            ...host.facade.getFollowUpMessages(),
+            ...host.compactionQueuedMessages.filter((msg) => msg.mode === "followUp").map((msg) => msg.text),
+        ],
+    };
+}
+/**
+ * Clear all queued messages and return their contents.
+ * Clears both session queue and compaction queue.
+ */
+export function clearAllQueues(host) {
+    const { steering, followUp } = host.facade.clearQueue();
+    const compactionSteering = host.compactionQueuedMessages
+        .filter((msg) => msg.mode === "steer")
+        .map((msg) => msg.text);
+    const compactionFollowUp = host.compactionQueuedMessages
+        .filter((msg) => msg.mode === "followUp")
+        .map((msg) => msg.text);
+    host.compactionQueuedMessages = [];
+    return {
+        steering: [...steering, ...compactionSteering],
+        followUp: [...followUp, ...compactionFollowUp],
+    };
+}
+export function updatePendingMessagesDisplay(host) {
+    host.pendingMessagesContainer.clear();
+    const { steering: steeringMessages, followUp: followUpMessages } = host.getAllQueuedMessages();
+    if (steeringMessages.length > 0 || followUpMessages.length > 0) {
+        host.pendingMessagesContainer.addChild(new Spacer(1));
+        for (const message of steeringMessages) {
+            const text = theme.fg("dim", t("Steering: {message}", { message }));
+            host.pendingMessagesContainer.addChild(new TruncatedText(text, 1, 0));
+        }
+        for (const message of followUpMessages) {
+            const text = theme.fg("dim", t("Follow-up: {message}", { message }));
+            host.pendingMessagesContainer.addChild(new TruncatedText(text, 1, 0));
+        }
+        // The dequeue keybinding's shipped default was cleared (iron law):
+        // /queue's sibling command is the discoverable entry.
+        const dequeueHint = host.getAppKeyDisplay("app.message.dequeue") || "/dequeue";
+        const hintText = theme.fg("dim", t("↳ {key} to edit all queued messages", { key: dequeueHint }));
+        host.pendingMessagesContainer.addChild(new TruncatedText(hintText, 1, 0));
+    }
+}
+export function queueCompactionMessage(host, text, mode) {
+    host.compactionQueuedMessages.push({ text, mode });
+    host.editor.addToHistory?.(text);
+    host.editor.setText("");
+    host.updatePendingMessagesDisplay();
+    host.showStatus(t("Queued message for after compaction"));
+}
+export async function flushCompactionQueue(host, options) {
+    if (host.compactionQueuedMessages.length === 0) {
+        return;
+    }
+    const queuedMessages = [...host.compactionQueuedMessages];
+    host.compactionQueuedMessages = [];
+    host.updatePendingMessagesDisplay();
+    const restoreQueue = (error) => {
+        host.facade.clearQueue();
+        host.compactionQueuedMessages = queuedMessages;
+        host.updatePendingMessagesDisplay();
+        host.showError(queuedMessages.length > 1
+            ? t("Failed to send queued messages: {error}", {
+                error: error instanceof Error ? error.message : String(error),
+            })
+            : t("Failed to send queued message: {error}", {
+                error: error instanceof Error ? error.message : String(error),
+            }));
+    };
+    try {
+        if (options?.willRetry) {
+            // When retry is pending, queue messages for the retry turn
+            for (const message of queuedMessages) {
+                if (message.mode === "followUp") {
+                    await host.facade.followUp(message.text);
+                }
+                else {
+                    await host.facade.steer(message.text);
+                }
+            }
+            host.updatePendingMessagesDisplay();
+            return;
+        }
+        const [firstPrompt, ...rest] = queuedMessages;
+        // Start a prompt when idle, or queue it into a run still finishing compaction.
+        const promptPromise = host.facade
+            .prompt(firstPrompt.text, { streamingBehavior: firstPrompt.mode })
+            .catch((error) => {
+            restoreQueue(error);
+        });
+        // Queue remaining messages
+        for (const message of rest) {
+            if (message.mode === "followUp") {
+                await host.facade.followUp(message.text);
+            }
+            else {
+                await host.facade.steer(message.text);
+            }
+        }
+        host.updatePendingMessagesDisplay();
+        void promptPromise;
+    }
+    catch (error) {
+        restoreQueue(error);
+    }
+}
+//# sourceMappingURL=interactive-queues.js.map

package/dist/modes/interactive/interactive-queues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-queues.js","sourceRoot":"","sources":["../../../src/modes/interactive/interactive-queues.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Queue management for interactive mode (拆分 slice 3,\n * docs/plans/interactive-mode拆分计划.md): the follow-up/dequeue entry points,\n * the /queue, /dequeue, and /queue-list command faces, the merged\n * pending-messages display under the editor, and the compaction queue\n * (messages held back while compaction is running).\n *\n * InteractiveMode implements QueuesHost and keeps same-name delegate methods so\n * prototype-level tests, the command dispatch table, and the selector surface\n * keep working; the functions below receive the mode through QueuesHost.\n * restoreQueuedMessagesToEditor stays on the mode (the Esc interrupt path and\n * the selectors call it), and the queue manager overlay stays in\n * ./interactive-selectors.ts — this module reaches it only through the host\n * method (host.showQueueManagerSelector), so no sibling module imports another.\n *\n * Internal collaboration interface (same pattern as AuthUiHost): not a plugin\n * API and not exported from the package root.\n */\nimport type { Container, EditorComponent, TUI } from \"@agent-forge/tui\";\nimport { Spacer, TruncatedText } from \"@agent-forge/tui\";\nimport type { CodingAgentFacadeV1 } from \"../../core/facade/index.ts\";\nimport { t } from \"../../core/i18n/index.ts\";\nimport type { AppKeybinding } from \"../../core/keybindings.ts\";\nimport { theme } from \"../../theme/theme.ts\";\n\n/** A message held back while compaction is running (steer or follow-up). */\nexport type CompactionQueuedMessage = {\n\ttext: string;\n\tmode: \"steer\" | \"followUp\";\n};\n\n/**\n * Host surface InteractiveMode exposes to this module: the queue entry points\n * (which stay on the mode for dispatch and prototype-level tests), the editor\n * and pending-messages containers, the stable facade, and the compaction queue\n * state (which lives on the mode because renderCurrentSessionState resets it).\n *\n * Internal collaboration interface (same pattern as AuthUiHost): not a plugin\n * API and not exported from the package root.\n */\nexport interface QueuesHost {\n\tui: TUI;\n\teditor: EditorComponent;\n\t/** Stable facade (阶段 1 slice 1). */\n\tfacade: CodingAgentFacadeV1;\n\tpendingMessagesContainer: Container;\n\t/** Compaction queue state; reset by the mode's renderCurrentSessionState. */\n\tcompactionQueuedMessages: CompactionQueuedMessage[];\n\n\tshowStatus(message: string): void;\n\tshowError(message: string): void;\n\t/** Restores queued messages into the editor; stays on the mode (Esc + selectors). */\n\trestoreQueuedMessagesToEditor(options?: {\n\t\tabort?: boolean;\n\t\t/** Interrupt grading (设计 子代理运行时 §4.2): false aborts the turn\n\t\t * without cancelling background agent tasks. */\n\t\tcancelAgentTasks?: boolean;\n\t\tcurrentText?: string;\n\t}): number;\n\t/** Capitalized display string for an app keybinding action (./interactive-commands.ts). */\n\tgetAppKeyDisplay(action: AppKeybinding): string;\n\t/** Queue manager overlay; the implementation stays in ./interactive-selectors.ts. */\n\tshowQueueManagerSelector(): void;\n\thandleFollowUp(explicitText?: string): Promise<void>;\n\thandleDequeue(): void;\n\tgetAllQueuedMessages(): { steering: string[]; followUp: string[] };\n\tupdatePendingMessagesDisplay(): void;\n\tqueueCompactionMessage(text: string, mode: \"steer\" | \"followUp\"): void;\n}\n\nexport async function handleFollowUp(host: QueuesHost, explicitText?: string): Promise<void> {\n\tconst text = (explicitText ?? host.editor.getExpandedText?.() ?? host.editor.getText()).trim();\n\tif (!text) return;\n\n\t// Queue input during compaction (extension commands execute immediately)\n\tif (host.facade.isCompacting()) {\n\t\thost.queueCompactionMessage(text, \"followUp\");\n\t\treturn;\n\t}\n\n\t// Alt+Enter queues a follow-up message (waits until agent finishes)\n\t// This handles extension commands (execute immediately), prompt template expansion, and queueing\n\tif (host.facade.isStreaming()) {\n\t\t// An explicit /queue <text> argument must not touch the editor draft.\n\t\tif (explicitText === undefined) {\n\t\t\thost.editor.addToHistory?.(text);\n\t\t\thost.editor.setText(\"\");\n\t\t}\n\t\tawait host.facade.prompt(text, { streamingBehavior: \"followUp\" });\n\t\thost.updatePendingMessagesDisplay();\n\t\thost.ui.requestRender();\n\t}\n\t// If not streaming, Alt+Enter acts like regular Enter (trigger onSubmit)\n\telse if (host.editor.onSubmit) {\n\t\tif (explicitText === undefined) host.editor.setText(\"\");\n\t\thost.editor.onSubmit(text);\n\t}\n}\n\nexport function handleDequeue(host: QueuesHost): void {\n\tconst restored = host.restoreQueuedMessagesToEditor();\n\tif (restored === 0) {\n\t\thost.showStatus(t(\"No queued messages to restore\"));\n\t} else if (restored === 1) {\n\t\thost.showStatus(t(\"Restored {count} queued message to editor\", { count: restored }));\n\t} else {\n\t\thost.showStatus(t(\"Restored {count} queued messages to editor\", { count: restored }));\n\t}\n}\n\n/** /queue command host face (single-entry iron law): queues the given text for after the current run. A bare /queue cannot mirror the keybinding — the editor buffer is cleared on submit before the command runs — so it prints usage instead of silently doing nothing. */\nexport function handleQueueCommand(host: QueuesHost, text: string | undefined): Promise<void> {\n\tif (text === undefined || text.trim() === \"\") {\n\t\thost.showStatus(t(\"Usage: /queue <text>\"));\n\t\treturn Promise.resolve();\n\t}\n\treturn host.handleFollowUp(text);\n}\n\n/** /dequeue command host face: restore queued messages back to the editor. */\nexport function handleDequeueCommand(host: QueuesHost): void {\n\thost.handleDequeue();\n}\n\n/** /queue-list command host face: open the queued-message manager selector. Both queues empty is a status message, not an empty overlay. */\nexport function handleQueueListCommand(host: QueuesHost): void {\n\tconst steering = host.facade.getSteeringMessages();\n\tconst followUp = host.facade.getFollowUpMessages();\n\tif (steering.length === 0 && followUp.length === 0) {\n\t\thost.showStatus(t(\"No queued messages to manage\"));\n\t\treturn;\n\t}\n\thost.showQueueManagerSelector();\n}\n\n/**\n * Get all queued messages (read-only).\n * Combines session queue and compaction queue.\n */\nexport function getAllQueuedMessages(host: QueuesHost): { steering: string[]; followUp: string[] } {\n\treturn {\n\t\tsteering: [\n\t\t\t...host.facade.getSteeringMessages(),\n\t\t\t...host.compactionQueuedMessages.filter((msg) => msg.mode === \"steer\").map((msg) => msg.text),\n\t\t],\n\t\tfollowUp: [\n\t\t\t...host.facade.getFollowUpMessages(),\n\t\t\t...host.compactionQueuedMessages.filter((msg) => msg.mode === \"followUp\").map((msg) => msg.text),\n\t\t],\n\t};\n}\n\n/**\n * Clear all queued messages and return their contents.\n * Clears both session queue and compaction queue.\n */\nexport function clearAllQueues(host: QueuesHost): { steering: string[]; followUp: string[] } {\n\tconst { steering, followUp } = host.facade.clearQueue();\n\tconst compactionSteering = host.compactionQueuedMessages\n\t\t.filter((msg) => msg.mode === \"steer\")\n\t\t.map((msg) => msg.text);\n\tconst compactionFollowUp = host.compactionQueuedMessages\n\t\t.filter((msg) => msg.mode === \"followUp\")\n\t\t.map((msg) => msg.text);\n\thost.compactionQueuedMessages = [];\n\treturn {\n\t\tsteering: [...steering, ...compactionSteering],\n\t\tfollowUp: [...followUp, ...compactionFollowUp],\n\t};\n}\n\nexport function updatePendingMessagesDisplay(host: QueuesHost): void {\n\thost.pendingMessagesContainer.clear();\n\tconst { steering: steeringMessages, followUp: followUpMessages } = host.getAllQueuedMessages();\n\tif (steeringMessages.length > 0 || followUpMessages.length > 0) {\n\t\thost.pendingMessagesContainer.addChild(new Spacer(1));\n\t\tfor (const message of steeringMessages) {\n\t\t\tconst text = theme.fg(\"dim\", t(\"Steering: {message}\", { message }));\n\t\t\thost.pendingMessagesContainer.addChild(new TruncatedText(text, 1, 0));\n\t\t}\n\t\tfor (const message of followUpMessages) {\n\t\t\tconst text = theme.fg(\"dim\", t(\"Follow-up: {message}\", { message }));\n\t\t\thost.pendingMessagesContainer.addChild(new TruncatedText(text, 1, 0));\n\t\t}\n\t\t// The dequeue keybinding's shipped default was cleared (iron law):\n\t\t// /queue's sibling command is the discoverable entry.\n\t\tconst dequeueHint = host.getAppKeyDisplay(\"app.message.dequeue\") || \"/dequeue\";\n\t\tconst hintText = theme.fg(\"dim\", t(\"↳ {key} to edit all queued messages\", { key: dequeueHint }));\n\t\thost.pendingMessagesContainer.addChild(new TruncatedText(hintText, 1, 0));\n\t}\n}\n\nexport function queueCompactionMessage(host: QueuesHost, text: string, mode: \"steer\" | \"followUp\"): void {\n\thost.compactionQueuedMessages.push({ text, mode });\n\thost.editor.addToHistory?.(text);\n\thost.editor.setText(\"\");\n\thost.updatePendingMessagesDisplay();\n\thost.showStatus(t(\"Queued message for after compaction\"));\n}\n\nexport async function flushCompactionQueue(host: QueuesHost, options?: { willRetry?: boolean }): Promise<void> {\n\tif (host.compactionQueuedMessages.length === 0) {\n\t\treturn;\n\t}\n\n\tconst queuedMessages = [...host.compactionQueuedMessages];\n\thost.compactionQueuedMessages = [];\n\thost.updatePendingMessagesDisplay();\n\n\tconst restoreQueue = (error: unknown) => {\n\t\thost.facade.clearQueue();\n\t\thost.compactionQueuedMessages = queuedMessages;\n\t\thost.updatePendingMessagesDisplay();\n\t\thost.showError(\n\t\t\tqueuedMessages.length > 1\n\t\t\t\t? t(\"Failed to send queued messages: {error}\", {\n\t\t\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t})\n\t\t\t\t: t(\"Failed to send queued message: {error}\", {\n\t\t\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t}),\n\t\t);\n\t};\n\n\ttry {\n\t\tif (options?.willRetry) {\n\t\t\t// When retry is pending, queue messages for the retry turn\n\t\t\tfor (const message of queuedMessages) {\n\t\t\t\tif (message.mode === \"followUp\") {\n\t\t\t\t\tawait host.facade.followUp(message.text);\n\t\t\t\t} else {\n\t\t\t\t\tawait host.facade.steer(message.text);\n\t\t\t\t}\n\t\t\t}\n\t\t\thost.updatePendingMessagesDisplay();\n\t\t\treturn;\n\t\t}\n\n\t\tconst [firstPrompt, ...rest] = queuedMessages;\n\n\t\t// Start a prompt when idle, or queue it into a run still finishing compaction.\n\t\tconst promptPromise = host.facade\n\t\t\t.prompt(firstPrompt.text, { streamingBehavior: firstPrompt.mode })\n\t\t\t.catch((error) => {\n\t\t\t\trestoreQueue(error);\n\t\t\t});\n\n\t\t// Queue remaining messages\n\t\tfor (const message of rest) {\n\t\t\tif (message.mode === \"followUp\") {\n\t\t\t\tawait host.facade.followUp(message.text);\n\t\t\t} else {\n\t\t\t\tawait host.facade.steer(message.text);\n\t\t\t}\n\t\t}\n\t\thost.updatePendingMessagesDisplay();\n\t\tvoid promptPromise;\n\t} catch (error) {\n\t\trestoreQueue(error);\n\t}\n}\n"]}

package/dist/modes/interactive/interactive-selectors.d.ts

@@ -1,6 +1,9 @@
 /**
  * Selectors for interactive mode (S5 slice 5): the suite, thinking, model,
- * scoped-models, user-message fork, and clone selectors.
+ * scoped-models, user-message fork, and clone selectors. The 拆分 slice 2
+ * (docs/plans/interactive-mode拆分计划.md) moved the settings selector, the
+ * workflow/agents views, the tree/session selectors, session resume, and the
+ * startup-suite recovery selector into this module as well.
  *
  * InteractiveMode implements SelectorsHost and keeps same-name delegate
  * methods so prototype-level tests and the command dispatch table keep
@@ -8,19 +11,31 @@
  * mount every overlay through the host's selector surface (host.showSelector),
  * mirroring the AuthUiHost pattern in ./interactive-auth.ts. Model snapshot,
  * catalog-refresh, and facade access go through narrow host accessors (D-048:
- * facade projections) so this module never reads session internals directly.
+ * facade projections) so this module never reads session internals directly;
+ * the one session touchpoint (transport application) goes through the
+ * curated AgentSessionHostSurface (host.session.host.setTransport).
  *
  * Internal collaboration interface (same pattern as AuthUiHost): not a plugin
  * API and not exported from the package root.
  */
 import type { ThinkingLevel } from "@agent-forge/agent-core";
 import type { Api, Model } from "@agent-forge/ai/compat";
-import type { Component, EditorComponent, TUI } from "@agent-forge/tui";
+import type { Component, EditorComponent, TUI, TuiMainScreen } from "@agent-forge/tui";
+import { Container, TuiAltScreen } from "@agent-forge/tui";
+import type { AgentSession } from "../../core/agent-session.ts";
 import type { ForkableUserMessage } from "../../core/agent-session-projection.ts";
+import type { ReplacedSessionContext } from "../../core/agent-session-runtime.ts";
+import type { InteractionDialogOptions } from "../../core/extensions/index.ts";
 import type { CodingAgentFacadeV1, CodingAgentRuntimeFacadeV1 } from "../../core/facade/index.ts";
-import type { SettingsManager } from "../../core/settings-manager.ts";
+import type { KeybindingsManager } from "../../core/keybindings.ts";
+import { MissingSessionCwdError } from "../../core/session-cwd.ts";
+import type { SettingsManager, TuiMode } from "../../core/settings-manager.ts";
+import { type ModelCatalogRuntime } from "../../host/model-catalog-refresh.ts";
+import type { InteractiveThemeController } from "../../theme/theme-controller.ts";
+import { AssistantMessageComponent } from "./components/assistant-message.ts";
+import type { CustomEditor } from "./components/custom-editor.ts";
 import type { FooterComponent } from "./components/footer.ts";
-import { type ModelCatalogRuntime } from "./model-catalog-refresh.ts";
+import { type StatusIndicator } from "./components/status-indicator.ts";
 /** Mount description accepted by the host's selector surface. */
 interface SelectorMount {
     component: Component;
@@ -68,6 +83,48 @@ export interface SelectorsHost {
         provider: string;
         id: string;
     }): void;
+    /** Live session; only its curated AgentSessionHostSurface (setTransport) is consumed here. */
+    readonly session: AgentSession;
+    /** Default editor instance (distinct from `editor` while overlays are mounted). */
+    defaultEditor: CustomEditor;
+    chatContainer: Container;
+    statusContainer: Container;
+    /** Active status indicator; TUI-mode and clear-on-shrink callbacks branch on it. */
+    activeStatusIndicator: StatusIndicator | undefined;
+    /** Streaming assistant message component, present while a response renders. */
+    streamingComponent: AssistantMessageComponent | undefined;
+    /** Active renderer; fullscreen settings callbacks probe for TuiAltScreen. */
+    renderer: TuiMainScreen | TuiAltScreen;
+    keybindings: KeybindingsManager;
+    themeController: InteractiveThemeController;
+    hideThinkingBlock: boolean;
+    outputPad: number;
+    switchTuiMode(mode: TuiMode, restoreProgress?: boolean, startRenderer?: boolean): boolean;
+    applyFullscreenScrollbarSetting(): void;
+    updateThinkingBlockVisibility(): void;
+    rebuildChatFromMessages(): void;
+    renderInitialMessages(): void;
+    showStatusIndicator(indicator: StatusIndicator): void;
+    clearStatusIndicator(kind?: StatusIndicator["kind"]): void;
+    restoreQueuedMessagesToEditor(options?: {
+        abort?: boolean;
+        cancelAgentTasks?: boolean;
+        currentText?: string;
+    }): number;
+    flushCompactionQueue(options?: {
+        willRetry?: boolean;
+    }): Promise<void>;
+    showDialogSelector(title: string, options: string[], opts?: InteractionDialogOptions): Promise<string | undefined>;
+    showDialogEditor(title: string, prefill?: string): Promise<string | undefined>;
+    /** Session-suite binding read, cached per path (设计 §10.1). */
+    readSessionSuiteId(sessionPath: string): string | undefined;
+    /** Cross-suite resume detection; stays on the mode (the startup path calls it too). */
+    detectCrossSuiteResume(): void;
+    shutdown(options?: {
+        fromSignal?: boolean;
+    }): Promise<void>;
+    handleFatalRuntimeError(title: string, error: unknown): Promise<never>;
+    promptForMissingSessionCwd(error: MissingSessionCwdError): Promise<string | undefined>;
 }
 export declare function handleSuiteCommand(host: SelectorsHost, suiteId?: string): void;
 export declare function showSuiteSelector(host: SelectorsHost, availableSuites: readonly string[]): void;
@@ -98,5 +155,38 @@ export declare function showUserMessageSelector(host: SelectorsHost): void;
  */
 export declare function showQueueManagerSelector(host: SelectorsHost): void;
 export declare function handleCloneCommand(host: SelectorsHost): Promise<void>;
+export declare function showSettingsSelector(host: SelectorsHost): void;
+/**
+ * Workflow overlay (§9 L2/L3): read-only panorama + transition log from
+ * `workflow.state`/`workflow.transition` entries. Actions are forwarded to
+ * the editor as reviewable text; the main agent executes them via
+ * workflow_advance (rendering and execution stay separated).
+ */
+export declare function showWorkflowView(host: SelectorsHost): void;
+/**
+ * Subagent session browser (/agents): read-only list + detail of this
+ * session's subagent transcripts from the D-060 §3 on-disk store — the same
+ * parent-scoped summary source as the subagent_list model tool (only this
+ * session's children, newest first). Detail entries load lazily per
+ * session; a failed load renders inside the view instead of throwing.
+ */
+export declare function showAgentsView(host: SelectorsHost): void;
+export declare function showTreeSelector(host: SelectorsHost, initialSelectedId?: string): void;
+export declare function showSessionSelector(host: SelectorsHost): void;
+export declare function handleResumeSession(host: SelectorsHost, sessionPath: string, options?: {
+    withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
+}): Promise<{
+    cancelled: boolean;
+}>;
+/**
+ * Interactive recovery for an unresolved startup suite id (设计 §9): pick a
+ * suite, persist it as the project setting, then rebuild the session with
+ * the selected suite via the same /new assembly path. Cancelling keeps the
+ * fallback assembly the runtime started with.
+ */
+export declare function showStartupSuiteSelector(host: SelectorsHost, pending: {
+    requestedId: string;
+    available: readonly string[];
+}): Promise<void>;
 export {};
 //# sourceMappingURL=interactive-selectors.d.ts.map