@weavecode/weave 0.1.2 → 0.1.3

package/node_modules/@weavecode/server/dist/daemon/opener.d.ts

@@ -1,4 +1,15 @@
 import { type TerminalPreset, type TerminalSettings } from './settings.js';
+export { parseTerminalAppDump, parseTerminalAppTargetId, parsePsRootPids, parseLsofCwds, pickTerminalAppWindow, terminalAppTargets, } from './opener/pty-terminals.js';
+export type { TerminalAppSurface } from './opener/pty-terminals.js';
+export { winRaiseEncodedScript } from './opener/win-raise.js';
+export { parseWtPaneId, parseWtProcDump, parseWtTargetId, wtInjectEncodedScript, wtPanePidFromEnv, wtPanes, wtWindowSlug, } from './opener/wt.js';
+export { planWeztermGrid } from './opener/wezterm-mux.js';
+export type { WtProcRow } from './opener/wt.js';
+export { quotePath } from './opener/shared.js';
+import { type WeztermMux } from './opener/wezterm-mux.js';
+import type { AttachTarget, SessionTerminal } from './opener/wezterm-mux.js';
+export { attachTargetsFromMuxes, countWindowsByDir, listAttachTargets, normalizeDirKey, parseAttachTargetId, parseWeztermPanes, planWeztermNewWindow, planWeztermReuse, sessionScreensFromEnvs, SocketProbeGate, weztermActiveWorkspaceOf, weztermCliArgs, weztermMuxKey, weztermPaneFromEnv, weztermSocketCandidates, } from './opener/wezterm-mux.js';
+export type { AttachTarget, SessionTerminal, WeztermMuxPane, } from './opener/wezterm-mux.js';
 /**
  * Cross-platform "open this directory" helpers behind the project context
  * menu: the OS file manager (Explorer/Finder/xdg-open) and a terminal at that
@@ -18,8 +29,6 @@ export interface TerminalLaunch {
     /** Run through the platform shell (custom commands only). */
     shell?: boolean;
 }
-/** Quote a path for interpolation into a custom shell command. */
-export declare function quotePath(dir: string, platform: NodeJS.Platform): string;
 /**
  * prompt 层② 兜底的注入落点：后端枚举出的可打文本 pane。
  * id 不透明、格式归各后端（wezterm = `<mux 短哈希>:<paneId>`）。
@@ -65,6 +74,8 @@ export declare abstract class TerminalBackend {
     listTargets(_dir: string): Promise<AttachTarget[]>;
     /** 定点附加（多终端弹窗选定的目标）；无通道的 preset 明确拒绝，不静默忽略。 */
     runAt(_dir: string, _argv: string[], _targetId: string): Promise<void>;
+    /** 唤出（切到前台）已开终端；无通道的 preset 明确拒绝。 */
+    focusTarget(_dir: string, _targetId: string): Promise<void>;
     /** prompt 层② 兜底：枚举可注入文本的 pane；无通道的后端空表（不谎报）。 */
     listPromptPanes(): Promise<PromptPaneTarget[]>;
     /** 层② 定位：pane env → pane id；无定位能力的后端 null（回落标题+cwd，不猜）。 */
@@ -82,30 +93,6 @@ export declare abstract class TerminalBackend {
     /** 按候选顺序起一个；全失败抛真相（含试过哪些命令）。 */
     protected spawnFirst(candidates: TerminalLaunch[], emptyReason: string): Promise<void>;
 }
-/** wt 的 pane id ↔ 会话进程号；坏 id → null。 */
-export declare function parseWtPaneId(id: string): number | null;
-/**
- * 上报的 pane env → wt 要打键的那个 pid；不是 wt 会话（缺世界标记或 pid）→ null。
- * 纯函数：环境判定与取值一处写，投递路径只做存在性校验。
- */
-export declare function wtPanePidFromEnv(env: Record<string, string>): number | null;
-/** PowerShell 脚本（base64/UTF-16，`-EncodedCommand` 免引号转义）；纯函数，单测覆盖。 */
-export declare function wtInjectEncodedScript(): string;
-/** Konsole 的 pane id ↔ (D-Bus 服务名, 会话路径)；坏 id → null。 */
-export declare function parseKonsolePaneId(id: string): {
-    service: string;
-    session: string;
-} | null;
-/** 上报的 pane env → Konsole 的 pane id；不是 Konsole 会话（缺键）→ null。 */
-export declare function konsolePaneFromEnv(env: Record<string, string>): string | null;
-/** 字符 → Qt 键值：控制键给真值，其余用码位（ASCII 与 Qt::Key 一致）。 */
-export declare function qtKeyOf(ch: string): number;
-/** iTerm2 的 pane id ↔ 会话 unique id；坏 id → null。 */
-export declare function parseItermPaneId(paneId: string): string | null;
-/** 上报的 pane env → iTerm2 的 pane id；不是 iTerm 会话（缺键）→ null。 */
-export declare function itermPaneFromEnv(env: Record<string, string>): string | null;
-/** AppleScript 字符串字面量转义（反斜杠先转，免把引号转义再转一遍）。 */
-export declare function applescriptString(text: string): string;
 /** settings → 后端（未知 preset 回落 auto，与旧的 switch default 一致）。 */
 export declare function terminalBackendFor(terminal: TerminalSettings, platform?: NodeJS.Platform): TerminalBackend;
 /**
@@ -135,203 +122,15 @@ export declare function promptTerminalChannel(settings: () => TerminalSettings):
     closePane(paneId: string): Promise<void>;
 };
 /**
- * Resolve the spawn candidates that would open a terminal at `dir`. 兼容入口：
- * 候选解析已归后端（`TerminalBackend.candidates`），这里只做分发。
- *
- * `run` = argv of a command to execute inside the new terminal (e.g.
- * `['claude', '--resume', id]`); omitted = just open the directory.
+ * 项目卡「终端」角标的数据面：每个目录已打开的终端窗口数（窗口级口径；wt
+ * 归属不到窗口，按 pane 数计——前端文案「N 个终端已打开」两种口径都成立）。
+ * 「这个 preset 能不能反查」由后端回答：wezterm 走 mux `cli list`、Terminal.app
+ * 走 osascript+ps+lsof、wt 走进程表 PEB 走读；其余 preset 没有可枚举通道 →
+ * 一律 0（角标不显示，不谎报）。
  */
-export declare function resolveTerminalLaunch(dir: string, terminal: TerminalSettings, platform?: NodeJS.Platform, run?: string[]): TerminalLaunch[];
-/** File-manager command that opens `dir` (per platform). */
-export declare function resolveExplorerLaunch(dir: string, platform?: NodeJS.Platform): TerminalLaunch;
-/** Try candidates in order until one launches (auto-probe fallback). */
-/** Open the OS file manager at `dir`. */
-export declare function openInExplorer(dir: string): Promise<void>;
-/** Open a terminal at `dir` following the configured preset. `auto` tries the
- * platform candidates in order until one launches. */
-export declare function openInTerminal(dir: string, terminal: TerminalSettings): Promise<void>;
 /** Open a terminal at `dir` that runs `argv` (e.g. `claude --resume <id>`).
  * Same detached semantics as `openInTerminal` — the process outlives the daemon. */
 export declare function runInTerminal(dir: string, argv: string[], terminal: TerminalSettings): Promise<void>;
-/** `cli list` 里与布局决策相关的字段（left_col/top_row 是单元格坐标）。 */
-export interface WeztermPaneInfo {
-    windowId: number;
-    tabId: number;
-    paneId: number;
-    cwd: string | null;
-    left: number;
-    top: number;
-    /** 该 pane 是否当前聚焦（多终端弹窗的排序信号之一）。 */
-    isActive: boolean;
-    /** pane 标题（claude 的 OSC 标题）——弹窗标签的素材，缺省回落窗口/Tab 号。 */
-    title: string | null;
-}
-export type WeztermDirection = 'right' | 'bottom';
-/** 分屏落点：把哪个 pane 往哪个方向切。 */
-export interface WeztermSplitTarget {
-    paneId: number;
-    direction: WeztermDirection;
-}
-/** 解析 `cli list --format json`；坏输入安全落空（上层转新窗口/回退）。 */
-export declare function parseWeztermPanes(jsonText: string | null): WeztermPaneInfo[];
-/** file:/// URL/本地路径 → 规范比较键：统一斜杠、去尾斜杠，win 下压大小写。 */
-export declare function normalizeDirKey(raw: string | null, platform: NodeJS.Platform): string | null;
-/** 跨 mux 摊平的 pane 行：计数只需 (mux 判别键, windowId, tabId, cwd)。 */
-export interface WeztermMuxPane {
-    muxKey: string;
-    windowId: number;
-    /** tab 号（可见屏幕）；不给 = 该后端没有 tab 概念，按窗口计。 */
-    tabId?: number;
-    cwd: string | null;
-}
-/**
- * 已打开终端计数，单位 = 各后端的**可见屏幕**（与会话终端选择弹窗的选项同一
- * 口径）：distinct (mux, windowId, tabId)、任一 pane cwd 命中即计——不是分屏
- * pane 数、也不是会话数。同一屏多个 pane 同属一目录只计 1。
- */
-export declare function countWindowsByDir(dirs: readonly string[], panes: readonly WeztermMuxPane[], platform?: NodeJS.Platform): Map<string, number>;
-/**
- * 单个终端（一个**可见屏幕** = wezterm 的一个 tab）的 pane 上限：网格 1 2 /
- * 3 4 / 5 6 长满即停，再要新会话就只能新开窗口。各终端后端的「可见屏幕」定义
- * 不同——不支持分屏的后端（Terminal.app / 纯 shell preset）没有「挤在同一个
- * 可见屏幕里」这回事，不设限：每个会话各占一个窗口/tab。
- */
-export declare const MAX_PANES_PER_SCREEN = 6;
-/**
- * 一个 tab 内的网格生长：网格按 1 2 / 3 4 / 5 6 生长 —— 首个分屏向右开列，
- * 之后矮列的底格向下延伸，等高取左列。坐标用 `cli list` 报的 left_col/top_row，
- * 用户手工增删 pane 后依旧推导得出，不落持久状态。长满 `MAX_PANES_PER_SCREEN`
- * 即无落点（null）——调用方据此新开窗口。
- */
-export declare function planWeztermGrid(tabPanes: WeztermPaneInfo[]): WeztermSplitTarget | null;
-/**
- * 同项目复用布局：挑「cwd 匹配该项目的 pane 最多、且有空间」的 tab（平手取最早
- * tab），再按 tab 内网格生长推导落点；匹配的 tab 全满 = 无落点（null → 新窗口）。
- */
-export declare function planWeztermReuse(dir: string, panes: WeztermPaneInfo[], platform?: NodeJS.Platform): WeztermSplitTarget | null;
-/** 新项目窗：最近活跃 client 的 workspace（拿不到就省略，进 mux 默认 workspace）。 */
-export declare function planWeztermNewWindow(dir: string, workspace: string | null): string[];
-/**
- * 会话终端可附加目标（多终端弹窗的选项）：一个终端窗口内的一个 tab（wezterm
- * 的 tab 含分屏 pane，即一个可见屏幕；Terminal.app 的 tab 即整面）。id 不透明、
- * 格式归各后端（wezterm `<mux 短哈希>:<windowId>:<tabId>`，Terminal.app
- * `terminal:<win>:<tab>`）。
- */
-export interface AttachTarget {
-    id: string;
-    windowId: number;
-    tabId: number;
-    /** tab 聚焦 pane 的标题（claude 的 OSC 标题）；null 由前端回落「窗口 W · Tab T」文案。 */
-    title: string | null;
-    /** cwd 命中请求目录的 pane 数 / 该 tab 总 pane 数。 */
-    matchCount: number;
-    paneCount: number;
-    /** 该 tab 内含聚焦 pane（窗口正看着它）。 */
-    active: boolean;
-    /** 这个可见屏幕已长满（pane 数到上限）：前端置灰，后端定点附加明确拒绝。 */
-    full: boolean;
-}
-/**
- * mux socket → 不透明短标识（不回传本机路径）。**按比较键取哈希**：同一 socket
- * 有两种形态（wezterm 注进 pane env 的是混合分隔符，目录拼出来的是全反斜杠），
- * 裸串哈希会给同一实例发两个 id，投递时按 id 反查就落空。
- */
-export declare function weztermMuxKey(socket: string): string;
-/**
- * 层② 定位（纯函数）：hook 上报的 pane env × 活 mux 表 → prompt pane id。
- * 键缺、socket 对不上活 mux、pane 号已不在 = null（宁可回落，不猜）。
- */
-export declare function weztermPaneFromEnv(env: Record<string, string>, muxes: readonly {
-    socket: string;
-    panes: readonly {
-        paneId: number;
-    }[];
-}[], platform: NodeJS.Platform): string | null;
-/**
- * 会话所在的**可见屏幕**（终端里的一块屏 = wezterm 一个 tab）：会话列表按它分块
- * ——同一块屏上的会话聚在一起。id 不透明、格式归后端，只作分组键；窗口/Tab 号
- * 与同窗口 tab 数供块头文案（Tab 号只在同窗口多 tab 时有意义）。
- */
-export interface SessionTerminal {
-    id: string;
-    windowId: number;
-    tabId: number;
-    tabsInWindow: number;
-}
-/**
- * 会话 → 可见屏幕（纯函数）：hook 上报的 pane env × 活 mux 表 × 这轮的候选清单。
- * 三态各司其职——屏幕 = 反查到了；`null` = **确认不在了**（pane 已关 / 换了 mux /
- * 整个 GUI 没了）；**缺键 = 这轮没探到但实例还活着**（探活闸跳过、冷却、超时），
- * web 据此保留上次分块。探活闸的冷却窗与偶发失败都会让 mux 短暂不在枚举表里，
- * 把它们写成 null 就是「同一个终端的会话莫名掉出分块」的成因——分不清「没查」
- * 与「查了没有」。
- */
-export declare function sessionScreensFromEnvs(envs: Record<string, Record<string, string>>, muxes: readonly {
-    socket: string;
-    panes: readonly WeztermPaneInfo[];
-}[], 
-/** 这轮认定还活着的 socket（`weztermSocketCandidates` 口径 = 枚举成功 ∪ 探活
- *  失败/被闸跳过）：不在枚举表里却在这里面 = 只是这轮没探到。 */
-candidates: readonly string[], platform?: NodeJS.Platform): Record<string, SessionTerminal | null>;
-/** 目标 id ↔ (mux, window, tab) 解码；坏 id → null。 */
-export declare function parseAttachTargetId(id: string): {
-    muxKey: string;
-    windowId: number;
-    tabId: number;
-} | null;
-/**
- * 目标列表（纯函数）：**只列本项目名下的 tab**（至少一个 pane 的 cwd 命中该目录）
- * ——别的项目的终端不进来，用户不必在一堆无关窗口里挑。空表语义 = 该项目没有
- * 终端开着（调用方据此直接开新窗，而不是弹一个空选择框）。
- *
- * 排序（最近活跃从上往下）：① 整个 wezterm 实例更近活跃（mux 的 client idle
- * 更小）在前；② 同实例内含聚焦 pane 的 tab 在前；③ 其余按 tabId 降序（tab 越晚
- * 创建越可能更近用过）。`cli list` 不报任何时间戳，这是可得信号下的最佳近似。
- */
-export declare function attachTargetsFromMuxes(dir: string, muxes: readonly {
-    socket: string;
-    idleMs: number;
-    panes: WeztermPaneInfo[];
-}[], platform?: NodeJS.Platform): AttachTarget[];
-/** 目标列表（实时枚举，不吃探活缓存——用户手一划就可能关掉窗）。 */
-export declare function listAttachTargets(dir: string, platform?: NodeJS.Platform): Promise<AttachTarget[]>;
-/** list-clients JSON → 最近活跃（idle 最小）client 的 workspace；坏输入 null。 */
-export declare function weztermActiveWorkspaceOf(jsonText: string | null): string | null;
-/** cli 子命令参数 → 补上 `--no-auto-start`（须落在 `cli` 与子命令之间）。 */
-export declare function weztermCliArgs(args: readonly string[]): string[];
-/**
- * 候选 mux socket：进程 env 显式指定的最优先（daemon 一般没有，pane 内才有），
- * 其次存活 GUI 的 gui-sock-*（新的在前 ≈ 最近开的 wezterm 实例）。
- * 跳过裸 `sock`：默认 socket 不按 GUI pid 命名、判活无据——历史教训是 cli 对它
- * 原地拉起幽灵 server 后 rc=0 返回空世界、假成功一轮接一轮（见 DECISIONS）；
- * wezterm 注进 pane env 的恒是 gui-sock-<pid>，跳过它不丢发现面。
- */
-export declare function weztermSocketCandidates(platform: NodeJS.Platform): string[];
-/**
- * 探活失败的 socket 记忆——避免对已知坏 socket 反复 spawn `wezterm cli`。
- *
- * 为什么需要：陈旧的 `gui-sock-<pid>` 不会自己消失（wezterm 退出不清理，实测
- * 攒到过 48 个），对它们反复 spawn 纯属浪费（`--no-auto-start` 后死 socket
- * 是快速 rc≠0，不再是当年「原地拉起幽灵 mux-server、探活 >250s 不返回」的
- * 自伤——复盘见 docs/DECISIONS.md）。
- *
- * 判据的分寸：socket 路径与 GUI 的 pid 绑定，**进程死则该路径永久失效**（新 GUI
- * 必然是新 pid → 新路径），所以「干净的非零退出 + 这个 GUI 进程真没了」可以永久
- * 记住；而**超时/起不来/进程还活着却答不上来只算可疑**（本机 GUI 常年在 4~6 核，
- * 5s 内答不上来是可能的），只短期回避，免得把活着的 GUI 误判死。
- */
-export declare class SocketProbeGate {
-    private readonly dead;
-    private readonly cooling;
-    /** 这一轮要不要探它。 */
-    shouldProbe(socket: string, now?: number): boolean;
-    /** 探活成功：它活着，清掉回避态。 */
-    succeeded(socket: string): void;
-    /** 干净的非零退出（socket 层失败）→ 该路径永久失效。 */
-    failed(socket: string): void;
-    /** 超时 / 可执行起不来 → 只回避一段时间。 */
-    cooledDown(socket: string, now?: number): void;
-}
 /**
  * 定点附加（用户在会话终端弹窗里选的 tab）：实时重枚举定位目标，目标不在了
  * 就 throw——让前端报「该终端已关闭，请重选」，绝不静默换到别处（换了就是
@@ -339,13 +138,6 @@ export declare class SocketProbeGate {
  * 换地方），前端同一事实置灰，用户自己决定开新终端还是挑别的。
  */
 export declare function runInWeztermAt(dir: string, argv: string[], targetId: string, platform?: NodeJS.Platform): Promise<void>;
-/**
- * 项目卡「终端」角标的数据面：每个目录已打开的终端窗口数（窗口级口径；wt
- * 归属不到窗口，按 pane 数计——前端文案「N 个终端已打开」两种口径都成立）。
- * 「这个 preset 能不能反查」由后端回答：wezterm 走 mux `cli list`、Terminal.app
- * 走 osascript+ps+lsof、wt 走进程表 PEB 走读；其余 preset 没有可枚举通道 →
- * 一律 0（角标不显示，不谎报）。
- */
 export declare function countOpenTerminals(dirs: string[], terminal: TerminalSettings): Promise<Map<string, number>>;
 /**
  * cwd **恰为** `dir` 的 pane = 这个项目的终端（关终端的命中判据，与
@@ -375,79 +167,30 @@ export declare function closeTerminalsIn(dir: string, terminal: TerminalSettings
 export declare function readTerminalCounts(projects: readonly {
     id: number;
     path: string;
-}[], opener?: ProjectOpener): Promise<Record<number, number>>;
-/** Terminal.app 一个 tab（整面）：窗口/序号/tty + 窗口是否最前/tab 是否聚焦。 */
-export interface TerminalAppSurface {
-    /** AppleScript window id——会话期稳定，不受窗口顺序/焦点变化影响。 */
-    windowId: number;
-    /** 窗口内 tab 序号（1 起）。 */
-    tabIndex: number;
-    /** tty 设备路径（/dev/ttysNNN）——cwd 桥接键。 */
-    tty: string;
-    selected: boolean;
-    frontmost: boolean;
-    /** 根进程 cwd；取不到 = null（tab 在但不进任何目录匹配）。 */
-    cwd: string | null;
-}
-/** dump 文本 → surface 列表（cwd 另行桥接）；坏行跳过，不整体失败。 */
-export declare function parseTerminalAppDump(text: string): Omit<TerminalAppSurface, 'cwd'>[];
-/**
- * `ps -axo pid=,ppid=,tty=` → tty（ps 形如 ttys004，无 /dev/ 前缀）→ 进程树
- * 根 pid。根 = 父进程不在同一 tty 上的那个（shell 的父是 launchd，claude 的
- * 父是 shell）；被 exec 替换成 claude 时根就是 claude，cwd 口径不变。
- */
-export declare function parsePsRootPids(psText: string): Map<string, number>;
-/** `lsof -Fn` 输出 → pid → cwd（`p<pid>` 行后随 `n<路径>` 行）。 */
-export declare function parseLsofCwds(lsofText: string): Map<number, string>;
-/** 实时枚举（不吃缓存——落点决策必须看实时世界，同 wezterm 口径）。 */
-export declare function listTerminalAppSurfaces(platform: NodeJS.Platform): Promise<TerminalAppSurface[]>;
-/** 目标 id ↔ (window, tab) 解码；坏 id → null。 */
-export declare function parseTerminalAppTargetId(id: string): {
-    windowId: number;
-    tabIndex: number;
-} | null;
-/**
- * 目标列表（纯函数）：只列本项目名下的 tab。排序（最近活跃从上往下）：
- * ① 最前窗口的 tab 在前（Terminal.app 无 mux idle 信号，frontmost 是最近
- * 活跃的最佳代理）；② 窗口内聚焦 tab 在前；③ 其余按 tabIndex 降序（越晚开
- * 越可能更近用过）。matchCount/paneCount 恒 1/1——一个 tab 就一个面。
- */
-export declare function terminalAppTargets(dir: string, surfaces: readonly TerminalAppSurface[], platform?: NodeJS.Platform): AttachTarget[];
-/** run 的落点：同项目已开的窗口（frontmost 优先，否则最大 windowId——越晚
- * 创建越可能更近用过）；tab 只用于定位窗口（do script 落点本来就是窗口级
- * 新 tab，tab 顺序变动无害）。没有 → null（走新窗）。 */
-export declare function pickTerminalAppWindow(surfaces: readonly TerminalAppSurface[], dir: string, platform?: NodeJS.Platform): {
-    windowId: number;
-    tabIndex: number;
-} | null;
-/** wt 进程表一行（name 已归一小写）。 */
-export interface WtProcRow {
-    pid: number;
-    parentPid: number;
-    name: string;
-    created: string;
-    cwd: string | null;
-}
-export declare function parseWtProcDump(text: string): WtProcRow[];
+}[], opener?: ProjectOpener | undefined): Promise<Record<number, number>>;
+export declare function weztermLiveMuxesCached(): Promise<{
+    muxes: WeztermMux[];
+    candidates: string[];
+}>;
 /**
- * pane 反查（纯函数）：pane 根 = WindowsTerminal 直接子进程里非 OpenConsole
- * 的那些（shell 启动器 / cmd 包装 / claude 直跑……）。cwd 取「最深 shell 链
- * 尾」：Git Bash 的 bin/bash 只是启动器（cwd 停在启动目录），真正交互的
- * usr/bin/bash 是它的子进程；非 shell 根（如 claude）取根自己的 cwd——
- * 它的工具子进程不是 pane，不该跟。
- */
-export declare function wtPanes(rows: readonly WtProcRow[]): {
-    pid: number;
-    cwd: string | null;
-}[];
-/**
- * 项目命名窗口名：路径归一键 → 净化 + 短哈希（同路径稳定；净化后撞名的
- * 两个目录靠哈希区分）。wt 窗口名在窗口切换器里用户可见，保留可读前缀。
+ * Resolve the spawn candidates that would open a terminal at `dir`. 兼容入口：
+ * 候选解析已归后端（`TerminalBackend.candidates`），这里只做分发。
+ *
+ * `run` = argv of a command to execute inside the new terminal (e.g.
+ * `['claude', '--resume', id]`); omitted = just open the directory.
  */
-export declare function wtWindowSlug(dir: string): string;
-/** 定点目标 id ↔ 命名窗口名；坏 id → null。落点窗口由 dir 重derive（picker
- * 条目可能陈旧，dir 才是会话真身）。 */
-export declare function parseWtTargetId(id: string): string | null;
+export declare function resolveTerminalLaunch(dir: string, terminal: TerminalSettings, platform?: NodeJS.Platform, run?: string[]): TerminalLaunch[];
+/** File-manager command that opens `dir` (per platform). */
+export declare function resolveExplorerLaunch(dir: string, platform?: NodeJS.Platform): TerminalLaunch;
+/** Spawn detached and forget: the child outlives the daemon, its window is
+ * its own, and I/O is dropped so a GUI process never blocks on pipes. */
+export declare function trySpawn(launch: TerminalLaunch): Promise<boolean>;
+/** Try candidates in order until one launches (auto-probe fallback). */
+/** Open the OS file manager at `dir`. */
+export declare function openInExplorer(dir: string): Promise<void>;
+/** Open a terminal at `dir` following the configured preset. `auto` tries the
+ * platform candidates in order until one launches. */
+export declare function openInTerminal(dir: string, terminal: TerminalSettings): Promise<void>;
 /** Injection seam for the open routes — tests substitute a spy. */
 export interface ProjectOpener {
     openExplorer(dir: string): Promise<void>;
@@ -463,5 +206,21 @@ export interface ProjectOpener {
     listTerminals?(dir: string, terminal: TerminalSettings): Promise<AttachTarget[]>;
     /** 定点附加到指定目标 tab（可选）：会话终端选择后的落点。 */
     runInTerminalAt?(dir: string, argv: string[], targetId: string, terminal: TerminalSettings): Promise<void>;
+    focusTerminal?(dir: string, targetId: string, terminal: TerminalSettings): Promise<void>;
 }
+/** Konsole 的 pane id ↔ (D-Bus 服务名, 会话路径)；坏 id → null。 */
+export declare function parseKonsolePaneId(id: string): {
+    service: string;
+    session: string;
+} | null;
+/** 上报的 pane env → Konsole 的 pane id；不是 Konsole 会话（缺键）→ null。 */
+export declare function konsolePaneFromEnv(env: Record<string, string>): string | null;
+/** 字符 → Qt 键值：控制键给真值，其余用码位（ASCII 与 Qt::Key 一致）。 */
+export declare function qtKeyOf(ch: string): number;
+/** iTerm2 的 pane id ↔ 会话 unique id；坏 id → null。 */
+export declare function parseItermPaneId(paneId: string): string | null;
+/** 上报的 pane env → iTerm2 的 pane id；不是 iTerm 会话（缺键）→ null。 */
+export declare function itermPaneFromEnv(env: Record<string, string>): string | null;
+/** AppleScript 字符串字面量转义（反斜杠先转，免把引号转义再转一遍）。 */
+export declare function applescriptString(text: string): string;
 export declare const defaultProjectOpener: ProjectOpener;