@selesai/code 0.13.39 → 0.14.0

package/dist/core/extensions/types.js

@@ -21,6 +21,9 @@ export function defineTool(tool) {
 export function isBashToolResult(e) {
     return e.toolName === "bash";
 }
+export function isPowerShellToolResult(e) {
+    return e.toolName === "powershell";
+}
 export function isReadToolResult(e) {
     return e.toolName === "read";
 }

package/dist/core/extensions/virtual-modules.js

@@ -1,5 +1,7 @@
 import * as bundledPiAgentCore from "@earendil-works/pi-agent-core";
 import * as bundledPiAiCompat from "@earendil-works/pi-ai/compat";
+import * as bundledPiAiTranscript from "@earendil-works/pi-ai/utils/transcript";
+import * as bundledPiAiClassifier from "@earendil-works/pi-ai/api/typesafe-system-one";
 import * as bundledPiAiOauth from "@earendil-works/pi-ai/oauth";
 import * as bundledPiAiProviders from "@earendil-works/pi-ai/providers/all";
 import * as bundledPiTui from "@earendil-works/pi-tui";
@@ -24,6 +26,8 @@ export const VIRTUAL_MODULES = {
     // global API keep working at runtime until compat is removed.
     "@earendil-works/pi-ai": bundledPiAiCompat,
     "@earendil-works/pi-ai/compat": bundledPiAiCompat,
+    "@earendil-works/pi-ai/utils/transcript": bundledPiAiTranscript,
+    "@earendil-works/pi-ai/api/typesafe-system-one": bundledPiAiClassifier,
     "@earendil-works/pi-ai/oauth": bundledPiAiOauth,
     "@earendil-works/pi-ai/providers/all": bundledPiAiProviders,
     "@earendil-works/pi-coding-agent": bundledPiCodingAgent,
@@ -33,6 +37,8 @@ export const VIRTUAL_MODULES = {
     "@mariozechner/pi-tui": bundledPiTui,
     "@mariozechner/pi-ai": bundledPiAiCompat,
     "@mariozechner/pi-ai/compat": bundledPiAiCompat,
+    "@mariozechner/pi-ai/utils/transcript": bundledPiAiTranscript,
+    "@mariozechner/pi-ai/api/typesafe-system-one": bundledPiAiClassifier,
     "@mariozechner/pi-ai/oauth": bundledPiAiOauth,
     "@mariozechner/pi-ai/providers/all": bundledPiAiProviders,
     "@mariozechner/pi-coding-agent": bundledPiCodingAgent,

package/dist/core/extensions/wrapper.d.ts

@@ -9,11 +9,11 @@ import type { ExtensionRunner } from "./runner.ts";
 import type { RegisteredTool } from "./types.ts";
 /**
  * Wrap a RegisteredTool into an AgentTool.
- * Uses the runner's createContext() for consistent context across tools and event handlers.
+ * Uses the runner's createToolContext() for consistent context across tools and event handlers.
  */
 export declare function wrapRegisteredTool(registeredTool: RegisteredTool, runner: ExtensionRunner): AgentTool;
 /**
  * Wrap all registered tools into AgentTools.
- * Uses the runner's createContext() for consistent context across tools and event handlers.
+ * Uses the runner's createToolContext() for consistent context across tools and event handlers.
  */
 export declare function wrapRegisteredTools(registeredTools: RegisteredTool[], runner: ExtensionRunner): AgentTool[];

package/dist/core/extensions/wrapper.js

@@ -7,14 +7,14 @@
 import { wrapToolDefinition } from "../tools/tool-definition-wrapper.js";
 /**
  * Wrap a RegisteredTool into an AgentTool.
- * Uses the runner's createContext() for consistent context across tools and event handlers.
+ * Uses the runner's createToolContext() for consistent context across tools and event handlers.
  */
 export function wrapRegisteredTool(registeredTool, runner) {
-    return wrapToolDefinition(registeredTool.definition, () => runner.createContext());
+    return wrapToolDefinition(registeredTool.definition, (toolCallId, signal) => runner.createToolContext(toolCallId, signal));
 }
 /**
  * Wrap all registered tools into AgentTools.
- * Uses the runner's createContext() for consistent context across tools and event handlers.
+ * Uses the runner's createToolContext() for consistent context across tools and event handlers.
  */
 export function wrapRegisteredTools(registeredTools, runner) {
     return registeredTools.map((tool) => wrapRegisteredTool(tool, runner));

package/dist/core/footer-data-provider.d.ts

@@ -10,7 +10,7 @@ export type GitPaths = {
 export declare function findGitPaths(cwd: string): GitPaths | null;
 /**
  * Provides git branch and extension statuses - data not otherwise accessible to extensions.
- * Token stats, model info available via ctx.sessionManager and ctx.model.
+ * Context usage on ctx.getContextUsage(), token stats on ctx.sessionManager.getEntries(), model info on ctx.model.
  */
 export declare class FooterDataProvider {
     private cwd;

package/dist/core/footer-data-provider.js

@@ -81,7 +81,7 @@ function shouldPollGitHead(repoDir) {
 }
 /**
  * Provides git branch and extension statuses - data not otherwise accessible to extensions.
- * Token stats, model info available via ctx.sessionManager and ctx.model.
+ * Context usage on ctx.getContextUsage(), token stats on ctx.sessionManager.getEntries(), model info on ctx.model.
  */
 export class FooterDataProvider {
     cwd;

package/dist/core/handoff.d.ts

@@ -3,7 +3,6 @@ import type { AssistantMessage, Context } from "@earendil-works/pi-ai";
 import type { Model } from "@earendil-works/pi-ai";
 import type { SessionEntry } from "./session-manager.ts";
 export declare const DEFAULT_HANDOFF_GOAL = "Continue the previous session from this handoff.";
-export declare const AUTO_HANDOFF_GOAL = "Continue the previous session without losing its direction. Preserve the big picture: the overall objective, why the work matters, the intended outcome and success criteria, the current approach and key decisions, relevant constraints, exact reference files or artifacts, completed and remaining work, known failures or test results, and the next concrete action. Make clear how the immediate next step contributes to the overall goal.";
 export declare function entryToMessage(entry: SessionEntry): AgentMessage | undefined;
 export declare function getHandoffMessages(branch: SessionEntry[]): AgentMessage[];
 export declare function buildAiContext(conversationText: string, goal: string): Context;

package/dist/core/handoff.js

@@ -1,7 +1,6 @@
 import { serializeConversation } from "./compaction/utils.js";
 import { convertToLlm } from "./messages.js";
 export const DEFAULT_HANDOFF_GOAL = "Continue the previous session from this handoff.";
-export const AUTO_HANDOFF_GOAL = `Continue the previous session without losing its direction. Preserve the big picture: the overall objective, why the work matters, the intended outcome and success criteria, the current approach and key decisions, relevant constraints, exact reference files or artifacts, completed and remaining work, known failures or test results, and the next concrete action. Make clear how the immediate next step contributes to the overall goal.`;
 const SYSTEM_PROMPT = `Write a handoff document for a fresh agent to continue the current conversation. Return only the handoff document text; do not save a file or describe saving one. No question, no fluff, just write the handoff. Do not reproduce, quote, or reformat the conversation history or its tool calls — distill it into what matters; never emit transcript-style markup or raw tool-call text.
 
 Include a "suggested skills" section in the document, which suggests skills that the agent should invoke.

package/dist/core/http-dispatcher.js

@@ -1,6 +1,8 @@
 import { EventEmitter } from "node:events";
 import * as undici from "undici";
 export const DEFAULT_HTTP_IDLE_TIMEOUT_MS = 300_000;
+// Node's 250ms default can terminate valid connection attempts on high-latency routes.
+const DEFAULT_AUTO_SELECT_FAMILY_ATTEMPT_TIMEOUT_MS = 2_000;
 export const HTTP_IDLE_TIMEOUT_CHOICES = [
     { label: "30 sec", timeoutMs: 30_000 },
     { label: "1 min", timeoutMs: 60_000 },
@@ -73,6 +75,9 @@ export function configureHttpDispatcher(timeoutMs = DEFAULT_HTTP_IDLE_TIMEOUT_MS
         // Keep HTTP origins on CONNECT tunnels as they were before Undici 8.7.
         proxyTunnel: true,
         bodyTimeout: normalizedTimeoutMs,
+        connect: {
+            autoSelectFamilyAttemptTimeout: DEFAULT_AUTO_SELECT_FAMILY_ATTEMPT_TIMEOUT_MS,
+        },
         headersTimeout: normalizedTimeoutMs,
         clientFactory: createUndiciClient,
         factory: createUndiciOriginDispatcher,

package/dist/core/index.d.ts

@@ -9,5 +9,5 @@ export type { CacheWarmingDecision, CacheWarmingStatus } from "./cache-warmer.ts
 export type { CompactionResult } from "./compaction/index.ts";
 export { createEventBus, type EventBus, type EventBusController } from "./event-bus.ts";
 export { areExperimentalFeaturesEnabled } from "./experimental.ts";
-export { type AgentEndEvent, type AgentSettledEvent, type AgentStartEvent, type AgentToolResult, type AgentToolUpdateCallback, type BeforeAgentStartEvent, type BeforeAgentStartEventResult, type BuildSystemPromptOptions, type CacheWarmingDecisionEvent, type CacheWarmingDecisionEventResult, type ContextEvent, defineTool, discoverAndLoadExtensions, type ExecOptions, type ExecResult, type Extension, type ExtensionAPI, type ExtensionCommandContext, type ExtensionContext, type ExtensionError, type ExtensionEvent, type ExtensionFactory, type ExtensionFlag, type ExtensionHandler, ExtensionRunner, type ExtensionShortcut, type ExtensionUIContext, type InlineExtension, type LoadExtensionsResult, type MessageRenderer, type NormalizedBuildSystemPromptOptions, type RegisteredCommand, type SessionBeforeCompactEvent, type SessionBeforeForkEvent, type SessionBeforeSwitchEvent, type SessionBeforeTreeEvent, type SessionCompactEvent, type SessionShutdownEvent, type SessionStartEvent, type SessionTreeEvent, type ToolCallEvent, type ToolCallEventResult, type ToolDefinition, type ToolRenderResultOptions, type ToolResultEvent, type TurnEndEvent, type TurnStartEvent, type WorkingIndicatorOptions, } from "./extensions/index.ts";
+export { type AgentActivityOutcome, type AgentBeforeSettleEvent, type AgentBeforeSettleEventResult, type AgentEndEvent, type AgentSettledEvent, type AgentStartEvent, type AgentToolResult, type AgentToolUpdateCallback, type BeforeAgentStartEvent, type BeforeAgentStartEventResult, type BoundaryContextPreview, type BoundaryResult, type BoundaryState, type BuildSystemPromptOptions, type CacheWarmingDecisionEvent, type CacheWarmingDecisionEventResult, type CompactionEntryDraft, type ContextEditEntryDraft, type ContextEvent, type ContextWithSystemEvent, type CustomEntryDraft, type CustomMessageEntryDraft, defineTool, discoverAndLoadExtensions, type ExecOptions, type ExecResult, type Extension, type ExtensionAPI, type ExtensionCommandContext, type ExtensionContext, type ExtensionError, type ExtensionEvent, type ExtensionFactory, type ExtensionFlag, type ExtensionHandler, ExtensionRunner, type ExtensionShortcut, type ExtensionUIContext, type InlineExtension, type LoadExtensionsResult, type MessageRenderer, type NormalizedBuildSystemPromptOptions, type RegisteredCommand, type SessionBeforeCompactEvent, type SessionBeforeForkEvent, type SessionBeforeSwitchEvent, type SessionBeforeTreeEvent, type SessionBoundaryDraft, type SessionCompactEvent, type SessionShutdownEvent, type SessionStartEvent, type SessionTreeEvent, type ToolCallEvent, type ToolCallEventResult, type ToolDefinition, type ToolRenderResultOptions, type ToolResultEvent, type TurnEndEvent, type TurnEndEventResult, type TurnStartEvent, type WorkingIndicatorOptions, } from "./extensions/index.ts";
 export { createSyntheticSourceInfo } from "./source-info.ts";

package/dist/core/intercom-rpc.d.ts

@@ -0,0 +1,135 @@
+import type { RpcObservationScope } from "./subagent-rpc.ts";
+import type { Attachment, BrokerMessage, DeliveryDetails, Message, SessionInfo } from "../extensions/pi-intercom/types.ts";
+/** Dedicated same-process bridge. These channels are not externally callable RPC bus operations. */
+export declare const INTERCOM_RPC_REQUEST_EVENT = "intercom:rpc-request";
+export declare const INTERCOM_RPC_RESULT_EVENT = "intercom:rpc-result";
+export declare const INTERCOM_RPC_EVENT = "intercom:rpc-event";
+export declare const INTERCOM_RPC_ASK_TIMEOUT_MS = 600000;
+export interface IntercomRpcMessageOptions {
+    message: string;
+    attachments?: Attachment[];
+    replyTo?: string;
+}
+export type IntercomRpcCommand = {
+    id?: string;
+    type: "intercom_status";
+} | {
+    id?: string;
+    type: "intercom_list";
+} | {
+    id?: string;
+    type: "intercom_pending";
+} | ({
+    id?: string;
+    type: "intercom_send";
+    to: string;
+} & IntercomRpcMessageOptions) | ({
+    id?: string;
+    type: "intercom_ask";
+    to: string;
+    timeoutMs?: number;
+} & IntercomRpcMessageOptions) | ({
+    id?: string;
+    type: "intercom_reply";
+    to?: string;
+} & IntercomRpcMessageOptions);
+export interface IntercomRpcStatus {
+    scope: RpcObservationScope;
+    enabled: boolean;
+    connected: boolean;
+    sessionId: string | null;
+    name?: string;
+}
+export interface IntercomRpcDelivery extends DeliveryDetails {
+    messageId: string;
+    delivered: boolean;
+    reason?: string;
+    to: string;
+    replyTo?: string;
+}
+export interface IntercomRpcDataMap {
+    intercom_status: IntercomRpcStatus;
+    intercom_list: {
+        sessionId: string;
+        sessions: SessionInfo[];
+    };
+    intercom_pending: {
+        asks: Array<{
+            from: SessionInfo;
+            message: Message;
+            receivedAt: number;
+        }>;
+    };
+    intercom_send: IntercomRpcDelivery;
+    intercom_reply: IntercomRpcDelivery;
+    intercom_ask: IntercomRpcDelivery & {
+        reply: Message;
+    };
+}
+export type IntercomRpcResponse = {
+    [K in keyof IntercomRpcDataMap]: {
+        id?: string;
+        type: "response";
+        command: K;
+        success: true;
+        data: IntercomRpcDataMap[K];
+    };
+}[keyof IntercomRpcDataMap];
+export type IntercomRpcEvent = IntercomRpcEventData & {
+    scope: RpcObservationScope;
+};
+/** Internal event data; the stdio host adds its own binding scope. */
+export type IntercomRpcEventData = {
+    type: "intercom_connection";
+    enabled: boolean;
+    connected: boolean;
+    sessionId: string | null;
+    reason?: string;
+} | {
+    type: "intercom_message";
+    from: SessionInfo;
+    message: Message;
+} | {
+    type: "intercom_presence";
+    session: SessionInfo;
+} | {
+    type: "intercom_session_joined";
+    session: SessionInfo;
+} | {
+    type: "intercom_session_left";
+    sessionId: string;
+} | {
+    type: "intercom_receipt";
+    from: SessionInfo;
+    receipt: Extract<BrokerMessage, {
+        type: "message_receipt";
+    }>["receipt"];
+} | {
+    type: "intercom_delivery";
+    result: Extract<BrokerMessage, {
+        type: "delivered" | "delivery_failed";
+    }>;
+};
+export interface IntercomRpcRequest {
+    requestId: string;
+    command: IntercomRpcCommand;
+    signal: AbortSignal;
+    /** Synchronous acknowledgement allows the host to fail promptly if the extension is missing. */
+    accept(): void;
+}
+export type IntercomRpcResult = {
+    requestId: string;
+} & ({
+    success: true;
+    data: IntercomRpcDataMap[keyof IntercomRpcDataMap] | Omit<IntercomRpcStatus, "scope">;
+} | {
+    success: false;
+    error: string;
+});
+export declare function intercomRpcTimeout(command: IntercomRpcCommand): number;
+export interface IntercomRpcEventEnvelope {
+    sessionId: string | null;
+    event: IntercomRpcEventData;
+}
+/** Fail closed before forwarding extension-bus payloads to a host client. */
+export declare function isIntercomRpcEvent(value: unknown): value is IntercomRpcEventData;

package/dist/core/intercom-rpc.js

@@ -0,0 +1,64 @@
+/** Dedicated same-process bridge. These channels are not externally callable RPC bus operations. */
+export const INTERCOM_RPC_REQUEST_EVENT = "intercom:rpc-request";
+export const INTERCOM_RPC_RESULT_EVENT = "intercom:rpc-result";
+export const INTERCOM_RPC_EVENT = "intercom:rpc-event";
+export const INTERCOM_RPC_ASK_TIMEOUT_MS = 600_000;
+export function intercomRpcTimeout(command) {
+    if (command.type !== "intercom_ask")
+        return 30_000;
+    const timeout = command.timeoutMs ?? INTERCOM_RPC_ASK_TIMEOUT_MS;
+    if (!Number.isInteger(timeout) || timeout < 1 || timeout > INTERCOM_RPC_ASK_TIMEOUT_MS) {
+        throw new Error("timeoutMs must be an integer between 1 and 600000");
+    }
+    return timeout;
+}
+/** Fail closed before forwarding extension-bus payloads to a host client. */
+export function isIntercomRpcEvent(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const event = value;
+    switch (event.type) {
+        case "intercom_connection":
+            return typeof event.enabled === "boolean" && typeof event.connected === "boolean"
+                && (event.sessionId === null || typeof event.sessionId === "string")
+                && (event.reason === undefined || typeof event.reason === "string");
+        case "intercom_message": return isSessionInfo(event.from) && isMessage(event.message);
+        case "intercom_presence":
+        case "intercom_session_joined": return isSessionInfo(event.session);
+        case "intercom_session_left": return typeof event.sessionId === "string";
+        case "intercom_receipt": return isSessionInfo(event.from) && isMessageReceipt(event.receipt);
+        case "intercom_delivery": {
+            if (!event.result || typeof event.result !== "object")
+                return false;
+            const result = event.result;
+            return typeof result.messageId === "string" && typeof result.retryable === "boolean" && typeof result.outcomeKnown === "boolean"
+                && (result.code === undefined || typeof result.code === "string")
+                && (result.type === "delivered" && (result.delivery === "queued" || result.delivery === "socket_delivered")
+                    || result.type === "delivery_failed" && typeof result.reason === "string" && (result.delivery === "failed" || result.delivery === "unknown"));
+        }
+        default: return false;
+    }
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function isSessionInfo(value) {
+    return isRecord(value) && ["id", "cwd", "model"].every(key => typeof value[key] === "string")
+        && ["pid", "startedAt", "lastActivity"].every(key => typeof value[key] === "number" && Number.isFinite(value[key]));
+}
+function isMessage(value) {
+    if (!isRecord(value) || typeof value.id !== "string" || typeof value.timestamp !== "number" || !Number.isFinite(value.timestamp)
+        || !isRecord(value.content) || typeof value.content.text !== "string")
+        return false;
+    if (value.replyTo !== undefined && typeof value.replyTo !== "string" || value.expectsReply !== undefined && typeof value.expectsReply !== "boolean")
+        return false;
+    const attachments = value.content.attachments;
+    return attachments === undefined || Array.isArray(attachments) && attachments.every(item => isRecord(item)
+        && ["file", "snippet", "context"].includes(String(item.type)) && typeof item.name === "string" && typeof item.content === "string"
+        && (item.language === undefined || typeof item.language === "string"));
+}
+function isMessageReceipt(value) {
+    return isRecord(value) && typeof value.messageId === "string" && typeof value.timestamp === "number" && Number.isFinite(value.timestamp)
+        && ["receiver_received", "queued", "injected", "acknowledged", "expired", "cancelled", "superseded", "cancellation_requested"].includes(String(value.status))
+        && (value.detail === undefined || typeof value.detail === "string");
+}

package/dist/core/keybindings.d.ts

@@ -45,6 +45,7 @@ export interface AppKeybindings {
     "app.tree.filter.cycleBackward": true;
 }
 export type AppKeybinding = keyof AppKeybindings;
+export declare function useWindowsKeybindings(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): boolean;
 declare module "@earendil-works/pi-tui" {
     interface Keybindings extends AppKeybindings {
     }
@@ -83,11 +84,11 @@ export declare const KEYBINDINGS: {
         readonly description: "Move cursor word right";
     };
     readonly "tui.editor.cursorLineStart": {
-        readonly defaultKeys: ["home", "ctrl+home", "ctrl+a"];
+        readonly defaultKeys: ["home", "ctrl+a"];
         readonly description: "Move to line start";
     };
     readonly "tui.editor.cursorLineEnd": {
-        readonly defaultKeys: ["end", "ctrl+end", "ctrl+e"];
+        readonly defaultKeys: ["end", "ctrl+e"];
         readonly description: "Move to line end";
     };
     readonly "tui.editor.jumpForward": {
@@ -138,10 +139,6 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "alt+y";
         readonly description: "Yank pop";
     };
-    readonly "tui.editor.undo": {
-        readonly defaultKeys: "ctrl+-";
-        readonly description: "Undo";
-    };
     readonly "tui.input.newLine": {
         readonly defaultKeys: ["shift+enter", "ctrl+j"];
         readonly description: "Insert newline";
@@ -206,18 +203,6 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: [];
         readonly description: "Scroll viewport down one line";
     };
-    readonly "tui.altScreen.previousPrompt": {
-        readonly defaultKeys: ["ctrl+shift+up", "ctrl+up"];
-        readonly description: "Jump to previous semantic prompt";
-    };
-    readonly "tui.altScreen.nextPrompt": {
-        readonly defaultKeys: ["ctrl+shift+down", "ctrl+down"];
-        readonly description: "Jump to next semantic prompt";
-    };
-    readonly "tui.altScreen.search": {
-        readonly defaultKeys: "ctrl+shift+f";
-        readonly description: "Search the primary scroll view";
-    };
     readonly "tui.altScreen.searchNext": {
         readonly defaultKeys: ["enter", "ctrl+g"];
         readonly description: "Select the next search match";
@@ -231,13 +216,29 @@ export declare const KEYBINDINGS: {
         readonly description: "Close transcript search";
     };
     readonly "tui.altScreen.top": {
-        readonly defaultKeys: "home";
+        readonly defaultKeys: "ctrl+home";
         readonly description: "Scroll viewport to top";
     };
     readonly "tui.altScreen.bottom": {
-        readonly defaultKeys: "end";
+        readonly defaultKeys: "ctrl+end";
         readonly description: "Scroll viewport to bottom";
     };
+    readonly "tui.editor.undo": {
+        readonly description: "Undo";
+        readonly defaultKeys: "alt+z" | "ctrl+-" | "ctrl+z";
+    };
+    readonly "tui.altScreen.previousPrompt": {
+        readonly description: "Jump to previous semantic prompt";
+        readonly defaultKeys: "ctrl+up" | ("ctrl+shift+up" | "ctrl+up")[];
+    };
+    readonly "tui.altScreen.nextPrompt": {
+        readonly description: "Jump to next semantic prompt";
+        readonly defaultKeys: "ctrl+down" | ("ctrl+down" | "ctrl+shift+down")[];
+    };
+    readonly "tui.altScreen.search": {
+        readonly description: "Search the primary scroll view";
+        readonly defaultKeys: "ctrl+f" | "ctrl+shift+f";
+    };
     readonly "app.interrupt": {
         readonly defaultKeys: "escape";
         readonly description: "Cancel or abort";
@@ -267,7 +268,7 @@ export declare const KEYBINDINGS: {
         readonly description: "Cycle to next model";
     };
     readonly "app.model.cycleBackward": {
-        readonly defaultKeys: "shift+ctrl+p";
+        readonly defaultKeys: "alt+p" | "shift+ctrl+p";
         readonly description: "Cycle to previous model";
     };
     readonly "app.model.select": {
@@ -295,16 +296,16 @@ export declare const KEYBINDINGS: {
         readonly description: "Copy selection or last assistant message";
     };
     readonly "app.message.followUp": {
-        readonly defaultKeys: "alt+enter";
+        readonly defaultKeys: "alt+enter" | "ctrl+q";
         readonly description: "Queue follow-up message";
     };
     readonly "app.message.dequeue": {
-        readonly defaultKeys: "alt+up";
+        readonly defaultKeys: "alt+q" | "alt+up";
         readonly description: "Restore queued messages";
     };
     readonly "app.clipboard.pasteImage": {
         readonly defaultKeys: "alt+v" | "ctrl+v";
-        readonly description: "Paste image from clipboard (text fallback)";
+        readonly description: "Paste files on macOS, images, or text from clipboard";
     };
     readonly "app.session.new": {
         readonly defaultKeys: [];

package/dist/core/keybindings.js

@@ -2,8 +2,29 @@ import { TUI_KEYBINDINGS, KeybindingsManager as TuiKeybindingsManager, } from "@
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { getAgentDir } from "../config.js";
+import { stripBom } from "../utils/text.js";
+export function useWindowsKeybindings(platform = process.platform, env = process.env) {
+    return platform === "win32" || (platform === "linux" && Boolean(env.WSL_DISTRO_NAME || env.WSL_INTEROP));
+}
+const windowsKeybindings = useWindowsKeybindings();
 export const KEYBINDINGS = {
     ...TUI_KEYBINDINGS,
+    "tui.editor.undo": {
+        ...TUI_KEYBINDINGS["tui.editor.undo"],
+        defaultKeys: process.platform === "win32" ? "ctrl+z" : windowsKeybindings ? "alt+z" : "ctrl+-",
+    },
+    "tui.altScreen.previousPrompt": {
+        ...TUI_KEYBINDINGS["tui.altScreen.previousPrompt"],
+        defaultKeys: windowsKeybindings ? "ctrl+up" : ["ctrl+shift+up", "ctrl+up"],
+    },
+    "tui.altScreen.nextPrompt": {
+        ...TUI_KEYBINDINGS["tui.altScreen.nextPrompt"],
+        defaultKeys: windowsKeybindings ? "ctrl+down" : ["ctrl+shift+down", "ctrl+down"],
+    },
+    "tui.altScreen.search": {
+        ...TUI_KEYBINDINGS["tui.altScreen.search"],
+        defaultKeys: windowsKeybindings ? "ctrl+f" : "ctrl+shift+f",
+    },
     "app.interrupt": { defaultKeys: "escape", description: "Cancel or abort" },
     "app.clear": { defaultKeys: "ctrl+c", description: "Clear editor" },
     "app.exit": { defaultKeys: "ctrl+d", description: "Exit when editor is empty" },
@@ -24,7 +45,7 @@ export const KEYBINDINGS = {
         description: "Cycle to next model",
     },
     "app.model.cycleBackward": {
-        defaultKeys: "shift+ctrl+p",
+        defaultKeys: windowsKeybindings ? "alt+p" : "shift+ctrl+p",
         description: "Cycle to previous model",
     },
     "app.model.select": { defaultKeys: "ctrl+l", description: "Open model selector" },
@@ -46,16 +67,16 @@ export const KEYBINDINGS = {
         description: "Copy selection or last assistant message",
     },
     "app.message.followUp": {
-        defaultKeys: "alt+enter",
+        defaultKeys: windowsKeybindings ? "ctrl+q" : "alt+enter",
         description: "Queue follow-up message",
     },
     "app.message.dequeue": {
-        defaultKeys: "alt+up",
+        defaultKeys: windowsKeybindings ? "alt+q" : "alt+up",
         description: "Restore queued messages",
     },
     "app.clipboard.pasteImage": {
-        defaultKeys: process.platform === "win32" ? "alt+v" : "ctrl+v",
-        description: "Paste image from clipboard (text fallback)",
+        defaultKeys: windowsKeybindings ? "alt+v" : "ctrl+v",
+        description: "Paste files on macOS, images, or text from clipboard",
     },
     "app.session.new": { defaultKeys: [], description: "Start a new session" },
     "app.session.tree": { defaultKeys: [], description: "Open session tree" },
@@ -262,7 +283,7 @@ function loadRawConfig(path) {
     if (!existsSync(path))
         return undefined;
     try {
-        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        const parsed = JSON.parse(stripBom(readFileSync(path, "utf-8")));
         if (typeof parsed !== "object" || parsed === null)
             return undefined;
         return parsed;