@weavecode/weave 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,7 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/** Collect the request body into a string. */
+export declare function readBody(req: IncomingMessage): Promise<string>;
+/** Parse the request body as JSON; callers catch parse errors themselves. */
+export declare function readJson(req: IncomingMessage): Promise<unknown>;
+/** Write a JSON response with status. */
+export declare function sendJson(res: ServerResponse, status: number, data: unknown): void;

package/node_modules/@weavecode/server/dist/daemon/http.js

@@ -0,0 +1 @@
+export function readBody(t){return new Promise((e,n)=>{const o=[];t.on("data",r=>o.push(r)),t.on("end",()=>e(Buffer.concat(o).toString("utf8"))),t.on("error",n)})}export async function readJson(t){return JSON.parse(await readBody(t))}export function sendJson(t,e,n){t.statusCode=e,t.setHeader("content-type","application/json"),t.end(JSON.stringify(n))}

package/node_modules/@weavecode/server/dist/daemon/inflight-counts-refresher.d.ts

@@ -0,0 +1,23 @@
+import type { DataBus } from './data-bus.js';
+import type { HookEventBus } from '../hooks/bus.js';
+/**
+ * InflightCountsRefresher — 会话行「在途消息」角标的数据面（SSE 推送）。
+ *
+ * 与 TerminalTopologyRefresher 同形状（指纹去重、值变才推），但**没有定时器**：
+ * 在途计数的变化源全是事件（`message.*` 帧），所以由 hook 帧驱动重算即可——
+ * 前端零定时器、零轮询，只看到一个推来的帧。推的是**绝对值快照**：漏帧的
+ * 客户端在下一次事件自我校正，不累积漂移。
+ */
+export declare class InflightCountsRefresher {
+    /** 现算一份在途计数（sessionId → 条数）。 */
+    private readonly snapshot;
+    private readonly bus;
+    /** 上次推送的取值指纹；相同则不再推（只推变化）。 */
+    private lastFingerprint;
+    constructor(
+    /** 现算一份在途计数（sessionId → 条数）。 */
+    snapshot: () => Map<string, number>, bus: DataBus, hookBus: HookEventBus);
+    /** 新 SSE 客户端接入时补一份快照（否则首帧要等到下一次消息事件）。 */
+    refreshNow(): void;
+    private push;
+}

package/node_modules/@weavecode/server/dist/daemon/inflight-counts-refresher.js

@@ -0,0 +1 @@
+export class InflightCountsRefresher{snapshot;bus;lastFingerprint=null;constructor(t,s,i){this.snapshot=t,this.bus=s,i.subscribe(n=>{n.kind.startsWith("message.")&&this.push()})}refreshNow(){this.push()}push(){const t=this.snapshot(),s={};for(const n of[...t.keys()].sort())s[n]=t.get(n);const i=JSON.stringify(s);i!==this.lastFingerprint&&(this.lastFingerprint=i,this.bus.emit({key:"inflightCounts",payload:{counts:s}}))}}

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

@@ -0,0 +1,384 @@
+import { type TerminalPreset, type TerminalSettings } from './settings.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
+ * directory.
+ *
+ * Launches use argument-array spawns (never a shell string), so directory
+ * names cannot inject commands. The one exception is the `custom` terminal
+ * preset, which is a user-authored command template and deliberately goes
+ * through a shell — the daemon is localhost-only and token-authenticated.
+ */
+/** One spawn candidate: earlier entries are tried first (auto-probing). */
+export interface TerminalLaunch {
+    command: string;
+    args: string[];
+    /** Working directory for the spawned process (inherited cwd). */
+    cwd?: string;
+    /** 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>`）。
+ */
+export interface PromptPaneTarget {
+    id: string;
+    /** pane 标题（claude 的 OSC 标题）——与会话标题匹配的素材；取不到 = null。 */
+    title: string | null;
+    /** pane 实时工作目录；取不到 = null（匹配不上任何项目）。 */
+    cwd: string | null;
+}
+/** prompt pane id ↔ (mux, paneId) 解码；坏 id → null。 */
+export declare function parsePromptPaneId(id: string): {
+    muxKey: string;
+    paneId: number;
+} | null;
+/** 终端后端基类。模板方法定义骨架，子类只填候选与真正不同的流程。 */
+export declare abstract class TerminalBackend {
+    readonly preset: TerminalPreset;
+    /** 能否反查已开窗口 / 可附加目标（默认否：不是每种终端都问得到）。 */
+    readonly enumerable: boolean;
+    protected readonly platform: NodeJS.Platform;
+    /** 能否给已开 pane 注入文本（prompt 层② send-text 兜底；默认否，不谎报）。 */
+    readonly textAddressable: boolean;
+    protected constructor(preset: TerminalPreset, 
+    /** 能否反查已开窗口 / 可附加目标（默认否：不是每种终端都问得到）。 */
+    enumerable: boolean, platform?: NodeJS.Platform, 
+    /** 能否给已开 pane 注入文本（prompt 层② send-text 兜底；默认否，不谎报）。 */
+    textAddressable?: boolean);
+    /** 启动候选（按序尝试，第一个起的算成功）；空 = 本平台不支持该 preset。 */
+    abstract candidates(dir: string, run?: string[]): TerminalLaunch[];
+    /** 开一个终端（模板方法）。 */
+    open(dir: string): Promise<void>;
+    /**
+     * 开一个终端并把 `argv` 送进去（模板方法）。缺省把命令并进候选参数；wezterm
+     * 覆写为走 mux——唯一流程真正不同的 preset（legacy `start -- PROG` 绕过
+     * default_prog，且 mux 在时会挂死出无窗僵尸而 trySpawn 假成功）。
+     */
+    run(dir: string, argv: string[]): Promise<void>;
+    /** 每目录已开窗口数；不支持的 preset 走这里（空表 = 角标不显示，不谎报）。 */
+    countWindows(_dirs: readonly string[]): Promise<Map<string, number>>;
+    /** 可附加目标（窗口内的 tab）；不支持的 preset 走这里。 */
+    listTargets(_dir: string): Promise<AttachTarget[]>;
+    /** 定点附加（多终端弹窗选定的目标）；无通道的 preset 明确拒绝，不静默忽略。 */
+    runAt(_dir: string, _argv: string[], _targetId: string): Promise<void>;
+    /** prompt 层② 兜底：枚举可注入文本的 pane；无通道的后端空表（不谎报）。 */
+    listPromptPanes(): Promise<PromptPaneTarget[]>;
+    /** 层② 定位：pane env → pane id；无定位能力的后端 null（回落标题+cwd，不猜）。 */
+    locatePane(_env: Record<string, string>): Promise<string | null>;
+    /** 会话 → 所在可见屏幕（会话列表分块）；无枚举能力的后端空表（不分组，不猜）。 */
+    locateScreens(_envs: Record<string, Record<string, string>>): Promise<Record<string, SessionTerminal | null>>;
+    /** prompt 层② 兜底：向枚举所得 pane 注入 prompt 原文并提交；无通道的后端明确拒绝。 */
+    sendPromptText(_paneId: string, _text: string): Promise<void>;
+    /** 阻塞问答作答：裸键序注入（模态框只吃键盘，不吃粘贴文本）；无通道的后端明确拒绝。 */
+    sendKeys(_paneId: string, _keys: string): Promise<void>;
+    /** 按候选顺序起一个；全失败抛真相（含试过哪些命令）。 */
+    protected spawnFirst(candidates: TerminalLaunch[], emptyReason: string): Promise<void>;
+}
+/** settings → 后端（未知 preset 回落 auto，与旧的 switch default 一致）。 */
+export declare function terminalBackendFor(terminal: TerminalSettings, platform?: NodeJS.Platform): TerminalBackend;
+/**
+ * prompt 层② 兜底通道适配（MessageDeliverer 的 PromptTerminal 形状）：settings
+ * 每次调用重新取后端（preset 运行期可改），`textAddressable` 即「层② 可用」的
+ * 诚实声明——能力矩阵与投递裁决都经 available() 取用，不支持的 preset 不谎报。
+ */
+export declare function promptTerminalChannel(settings: () => TerminalSettings): {
+    available(): boolean;
+    listPanes(): Promise<PromptPaneTarget[]>;
+    locatePane(env: Record<string, string>): Promise<string | null>;
+    locateScreens(envs: Record<string, Record<string, string>>): Promise<Record<string, SessionTerminal | null>>;
+    sendText(paneId: string, text: string): Promise<void>;
+    sendKeys(paneId: string, keys: 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.
+ */
+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, cwd)。 */
+export interface WeztermMuxPane {
+    muxKey: string;
+    windowId: number;
+    cwd: string | null;
+}
+/**
+ * 已打开终端窗口计数（窗口级口径：distinct (mux, windowId)、任一 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 → 不透明短标识（不回传本机路径）。 */
+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 表。键缺、socket 对
+ * 不上活 mux、pane 号已不在 = null（该会话不分组，不猜）。
+ */
+export declare function sessionScreensFromEnvs(envs: Record<string, Record<string, string>>, muxes: readonly {
+    socket: string;
+    panes: readonly WeztermPaneInfo[];
+}[], 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;
+/**
+ * 候选 mux socket：进程 env 显式指定的最优先（daemon 一般没有，pane 内才有），
+ * 其次存活 GUI 的 gui-sock-*（新的在前 ≈ 最近开的 wezterm 实例）。
+ * 跳过裸 `sock`：指向死 mux-server 时 cli 会原地拉起一个无人看的幽灵 server
+ * 还 rc=0 返回空世界，会造成新一轮假成功。
+ */
+export declare function weztermSocketCandidates(platform: NodeJS.Platform): string[];
+/**
+ * 探活失败的 socket 记忆——避免对已知坏 socket 反复 spawn `wezterm cli`。
+ *
+ * 为什么需要：陈旧的 `gui-sock-<pid>` 不会自己消失（wezterm 退出不清理，实测
+ * 攒到过 48 个），而对着死 socket 跑 `wezterm cli` 会**原地拉起幽灵 mux-server，
+ * 甚至挂死**——实测一次探活 >250s 不返回，且代码里 5s 超时后的 kill「对卡死
+ * 进程可能无效」，于是每次枚举都再堆一个。
+ *
+ * 判据的分寸：socket 路径与 GUI 的 pid 绑定，**进程死则该路径永久失效**（新 GUI
+ * 必然是新 pid → 新路径），所以「干净的非零退出」可以永久记住；而**超时/起不来
+ * 只算可疑**（本机 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——让前端报「该终端已关闭，请重选」，绝不静默换到别处（换了就是
+ * 「我点了 A，命令进了 B」）；已长满同样明确拒绝（**不擅自另开窗口**，那也是
+ * 换地方），前端同一事实置灰，用户自己决定开新终端还是挑别的。
+ */
+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>>;
+/**
+ * 每项目窗口数（projectId → 窗口数）：/terminals/counts 路由与隐藏刷新器共用
+ * 同一口径，免得两处各自拼 settings/opener 后漂移。
+ */
+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[];
+/**
+ * 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 窗口名在窗口切换器里用户可见，保留可读前缀。
+ */
+export declare function wtWindowSlug(dir: string): string;
+/** 定点目标 id ↔ 命名窗口名；坏 id → null。落点窗口由 dir 重derive（picker
+ * 条目可能陈旧，dir 才是会话真身）。 */
+export declare function parseWtTargetId(id: string): string | null;
+/** Injection seam for the open routes — tests substitute a spy. */
+export interface ProjectOpener {
+    openExplorer(dir: string): Promise<void>;
+    openTerminal(dir: string, terminal: TerminalSettings): Promise<void>;
+    runInTerminal(dir: string, argv: string[], terminal: TerminalSettings): Promise<void>;
+    /** 已打开终端窗口计数（可选：不实现的 spy 由路由回落到默认实现）。 */
+    countTerminals?(dirs: string[], terminal: TerminalSettings): Promise<Map<string, number>>;
+    /** 可附加终端目标列表（可选）：多终端选择弹窗的数据面。 */
+    listTerminals?(dir: string, terminal: TerminalSettings): Promise<AttachTarget[]>;
+    /** 定点附加到指定目标 tab（可选）：会话终端选择后的落点。 */
+    runInTerminalAt?(dir: string, argv: string[], targetId: string, terminal: TerminalSettings): Promise<void>;
+}
+export declare const defaultProjectOpener: ProjectOpener;

package/node_modules/@weavecode/server/dist/daemon/opener.js

@@ -0,0 +1,7 @@
+import{spawn as M}from"node:child_process";import{createHash as N}from"node:crypto";import{readdirSync as V}from"node:fs";import{basename as b,join as E}from"node:path";import{TERMINAL_LOCATOR_ENV as S}from"@weavecode/core";import{readDaemonSettings as q}from"./settings.js";export function quotePath(n,t){return t==="win32"?`"${n}"`:`'${n.replace(/'/g,"'\\''")}'`}function J(n,t){return t==="win32"?n!==""&&!/[\s"&|<>^%]/.test(n)?n:`"${n.replace(/"/g,'\\"')}"`:/^[A-Za-z0-9_@%+=:,./-]+$/.test(n)?n:`'${n.replace(/'/g,"'\\''")}'`}function f(n,t){return n.map(e=>J(e,t)).join(" ")}function v(n,t){return!t||!n||n.length===0?n:["cmd.exe","/k",f(n,"win32")]}function z(n,t,e){const r=`cd ${quotePath(t,"darwin")} && ${f(e,"darwin")}`.replace(/\\/g,"\\\\").replace(/"/g,'\\"');return n==="Terminal"?["-e",`tell application "Terminal" to do script "${r}"`,"-e",'tell application "Terminal" to activate']:["-e",'tell application "iTerm" to create window with default profile',"-e",`tell application "iTerm" to tell current window to write text "${r}"`]}export function parsePromptPaneId(n){const t=/^([0-9a-f]{8}):(\d+)$/.exec(n);return t?{muxKey:t[1],paneId:Number(t[2])}:null}export class TerminalBackend{preset;enumerable;platform;textAddressable;constructor(t,e,r=process.platform,o=!1){this.preset=t,this.enumerable=e,this.platform=r,this.textAddressable=o}async open(t){await this.spawnFirst(this.candidates(t),`Terminal preset "${this.preset}" is unavailable on this platform`)}async run(t,e){await this.spawnFirst(this.candidates(t,e),`Terminal preset "${this.preset}" cannot run a command here \u2014 pick another preset in settings`)}async countWindows(t){return new Map}async listTargets(t){return[]}async runAt(t,e,r){throw new Error(`Terminal preset "${this.preset}" cannot attach to a chosen pane \u2014 pick wezterm, wt or Terminal.app in settings`)}async listPromptPanes(){return[]}async locatePane(t){return null}async locateScreens(t){return{}}async sendPromptText(t,e){throw new Error(`Terminal preset "${this.preset}" cannot send text into an open pane \u2014 pick wezterm in settings`)}async sendKeys(t,e){throw new Error(`Terminal preset "${this.preset}" cannot send keys to an open pane \u2014 pick wezterm in settings`)}async spawnFirst(t,e){for(const r of t)if(await O(r))return;throw new Error(t.length===0?e:"No usable terminal found (tried: "+t.map(r=>r.command).join(", ")+")")}}class I extends TerminalBackend{make;constructor(t,e,r){super(t,!1,e),this.make=r}candidates(t,e){return this.make(t,e,this.platform)}}const w={wt:(n,t,e)=>e==="win32"?[{command:"wt.exe",args:["-w",wtWindowSlug(n),"-d",n,...v(t,!0)??[]]}]:[],powershell:(n,t,e)=>e==="win32"?[t?{command:"powershell.exe",args:["-NoExit","-Command",f(t,"win32")],cwd:n}:{command:"powershell.exe",args:["-NoExit"],cwd:n}]:[],cmd:(n,t,e)=>e==="win32"?[t?{command:"cmd.exe",args:["/K",f(t,"win32")],cwd:n}:{command:"cmd.exe",args:["/K"],cwd:n}]:[],terminal:(n,t,e)=>e!=="darwin"?[]:t?[{command:"osascript",args:z("Terminal",n,t)}]:[{command:"open",args:["-a","Terminal",n]}],iterm:(n,t,e)=>e!=="darwin"?[]:t?[{command:"osascript",args:z("iTerm",n,t)}]:[{command:"open",args:["-a","iTerm",n]}],gnome:(n,t)=>[{command:"gnome-terminal",args:[`--working-directory=${n}`,...t?["--",...t]:[]]}],konsole:(n,t)=>[{command:"konsole",args:["--workdir",n,...t?["-e",...t]:[]]}],ghostty:(n,t,e)=>e==="win32"?[]:e==="darwin"?t?[]:[{command:"open",args:["-a","Ghostty",n]}]:[{command:"ghostty",args:[`--working-directory=${n}`,...t?["-e",...t]:[]]}]};class Q extends TerminalBackend{terminal;constructor(t,e){super("custom",!1,e),this.terminal=t}candidates(t,e){const r=this.terminal.customCommand.trim();if(!r)return[];let o=r.replace(/\{path\}/g,quotePath(t,this.platform));const a=e?f(e,this.platform):"";return o=o.includes("{command}")?o.replace(/\{command\}/g,a):e?`${o} ${a}`:o,[{command:o,args:[],shell:!0}]}}class Y extends TerminalBackend{constructor(t){super("ghostty",!1,t)}candidates(t,e){return w.ghostty(t,e,this.platform)}async openViaIpcThenStandalone(t,e){if(this.platform==="linux"){const r=["+new-window",`--working-directory=${t}`,...e.length>0?["-e",...e]:[]];if((await h("ghostty",r))?.ok)return}await this.spawnFirst(this.candidates(t,e.length>0?e:void 0),`Terminal preset "${this.preset}" is unavailable on this platform`)}open(t){return this.openViaIpcThenStandalone(t,[])}run(t,e){return this.openViaIpcThenStandalone(t,e)}}class A extends TerminalBackend{constructor(t){super("wt",t==="win32",t)}candidates(t,e){return w.wt(t,e,this.platform)}async countWindows(t){if(t.length===0||this.platform!=="win32")return new Map(t.map(r=>[r,0]));const e=await H();return e.length===0?new Map(t.map(r=>[r,0])):countWindowsByDir(t,G(e))}async listTargets(t){if(this.platform!=="win32")return[];const e=await H(),r=countWindowsByDir([t],G(e)).get(t)??0;return r===0?[]:[{id:`wt:${wtWindowSlug(t)}`,windowId:0,tabId:0,title:b(t),matchCount:r,paneCount:r,active:!1,full:!1}]}async runAt(t,e,r){if(this.platform!=="win32")throw new Error(`Terminal preset "${this.preset}" is unavailable on this platform`);if(!parseWtTargetId(r))throw new Error(`Invalid terminal target "${r}"`);await this.spawnFirst([{command:"wt.exe",args:["-w",wtWindowSlug(t),"split-pane","-d",t,...v(e,!0)??[]]}],`Terminal preset "${this.preset}" is unavailable on this platform`)}}class C extends TerminalBackend{constructor(t){super("terminal",t==="darwin",t)}candidates(t,e){return w.terminal(t,e,this.platform)}async run(t,e){if(this.platform==="darwin"){const r=await listTerminalAppSurfaces(this.platform),o=pickTerminalAppWindow(r,t,this.platform);if(o&&await L(t,e,o.windowId))return}await this.spawnFirst(this.candidates(t,e),`Terminal preset "${this.preset}" is unavailable on this platform`)}async countWindows(t){if(t.length===0||this.platform!=="darwin")return new Map(t.map(r=>[r,0]));const e=await ct(this.platform);return e.length===0?new Map(t.map(r=>[r,0])):countWindowsByDir(t,e.flatMap(r=>r.cwd?[{muxKey:"terminal.app",windowId:r.windowId,cwd:r.cwd}]:[]))}listTargets(t){return dt(t,this.platform)}async runAt(t,e,r){const o=parseTerminalAppTargetId(r);if(!o)throw new Error(`Invalid terminal target "${r}"`);if(!await L(t,e,o.windowId))throw new Error("Terminal window is gone \u2014 pick a terminal again")}}class _ extends TerminalBackend{constructor(t){super("wezterm",!0,t,!0)}candidates(t,e){return[{command:"wezterm",args:["start","--cwd",t,...v(e,this.platform==="win32")??[]]}]}async open(t){await at(t)||await super.open(t)}async run(t,e){await st(t,e)}async countWindows(t){if(t.length===0)return new Map;const e=await U();return e.length===0?new Map(t.map(r=>[r,0])):countWindowsByDir(t,e.flatMap(r=>r.panes.map(o=>({muxKey:r.socket,windowId:o.windowId,cwd:o.cwd}))))}listTargets(t){return listAttachTargets(t,this.platform)}runAt(t,e,r){return runInWeztermAt(t,e,r,this.platform)}async listPromptPanes(){const{muxes:t}=await m();return t.flatMap(e=>e.panes.map(r=>({id:`${weztermMuxKey(e.socket)}:${r.paneId}`,title:r.title,cwd:r.cwd})))}async locatePane(t){const{muxes:e}=await m();return weztermPaneFromEnv(t,e,this.platform)}async locateScreens(t){return Object.keys(t).length===0?{}:sessionScreensFromEnvs(t,await U(),this.platform)}async sendPromptText(t,e){const r=parsePromptPaneId(t);if(!r)throw new Error(`Invalid prompt pane "${t}"`);const{muxes:o}=await m(),a=o.find(c=>weztermMuxKey(c.socket)===r.muxKey);if(!a)throw new Error("wezterm instance is gone \u2014 cannot deliver prompt");const s=String(r.paneId);if(e){const c=await g(["cli","send-text","--pane-id",s,e],a.socket);if(!c?.ok)throw new Error(y(["cli","send-text","--pane-id",s,"<prompt text>"],a.socket,c))}const i=await g(["cli","send-text","--pane-id",s,"--no-paste","\r"],a.socket);if(!i?.ok)throw new Error(y(["cli","send-text","--pane-id",s,"--no-paste","<CR>"],a.socket,i))}async sendKeys(t,e){const r=parsePromptPaneId(t);if(!r)throw new Error(`Invalid prompt pane "${t}"`);const{muxes:o}=await m(),a=o.find(c=>weztermMuxKey(c.socket)===r.muxKey);if(!a)throw new Error("wezterm instance is gone \u2014 cannot send keys to the pane");const s=String(r.paneId),i=await g(["cli","send-text","--pane-id",s,"--no-paste",e],a.socket);if(!i?.ok)throw new Error(y(["cli","send-text","--pane-id",s,"--no-paste","<keys>"],a.socket,i))}}class tt extends TerminalBackend{parts;constructor(t){super("auto",!0,t,t!=="win32"&&t!=="darwin");const e={win32:["wt","powershell","cmd"],darwin:["terminal","iterm"]}[t]??["gnome","konsole"];this.parts=e.map(r=>new I(r,t,w[r]))}candidates(t,e){return this.parts.flatMap(r=>e&&r.preset==="iterm"?[]:r.candidates(t,e))}attachBackend(){return this.platform==="darwin"?new C(this.platform):this.platform==="win32"?new A(this.platform):new _(this.platform)}countWindows(t){return this.attachBackend().countWindows(t)}listTargets(t){return this.attachBackend().listTargets(t)}runAt(t,e,r){return this.attachBackend().runAt(t,e,r)}listPromptPanes(){return this.attachBackend().listPromptPanes()}locatePane(t){return this.attachBackend().locatePane(t)}locateScreens(t){return this.attachBackend().locateScreens(t)}sendPromptText(t,e){return this.attachBackend().sendPromptText(t,e)}sendKeys(t,e){return this.attachBackend().sendKeys(t,e)}}const W={auto:(n,t)=>new tt(t),wt:(n,t)=>new A(t),powershell:(n,t)=>new I("powershell",t,w.powershell),cmd:(n,t)=>new I("cmd",t,w.cmd),terminal:(n,t)=>new C(t),iterm:(n,t)=>new I("iterm",t,w.iterm),gnome:(n,t)=>new I("gnome",t,w.gnome),konsole:(n,t)=>new I("konsole",t,w.konsole),ghostty:(n,t)=>new Y(t),wezterm:(n,t)=>new _(t),custom:(n,t)=>new Q(n,t)};export function terminalBackendFor(n,t=process.platform){return(W[n.preset]??W.auto)(n,t)}export function promptTerminalChannel(n){const t=()=>terminalBackendFor(n());return{available:()=>t().textAddressable,listPanes:async()=>{const e=t();return e.textAddressable?await e.listPromptPanes():[]},locatePane:async e=>{const r=t();return r.textAddressable?await r.locatePane(e):null},locateScreens:async e=>{const r=t();return r.textAddressable?await r.locateScreens(e):{}},sendText:async(e,r)=>{const o=t();if(!o.textAddressable)throw new Error(`Terminal preset "${o.preset}" cannot send text into an open pane \u2014 pick wezterm in settings`);await o.sendPromptText(e,r)},sendKeys:async(e,r)=>{const o=t();if(!o.textAddressable)throw new Error(`Terminal preset "${o.preset}" cannot send keys to an open pane \u2014 pick wezterm in settings`);await o.sendKeys(e,r)}}}export function resolveTerminalLaunch(n,t,e=process.platform,r){return terminalBackendFor(t,e).candidates(n,r)}export function resolveExplorerLaunch(n,t=process.platform){return t==="win32"?{command:"explorer.exe",args:[n]}:t==="darwin"?{command:"open",args:[n]}:{command:"xdg-open",args:[n]}}function O(n){return new Promise(t=>{let e;try{e=M(n.command,n.args,{cwd:n.cwd,shell:n.shell,detached:!0,stdio:"ignore"})}catch{t(!1);return}e.on("error",()=>t(!1)),e.on("spawn",()=>{e.unref(),t(!0)})})}export async function openInExplorer(n){const t=resolveExplorerLaunch(n);if(!await O(t))throw new Error(`Failed to open file manager (${t.command})`)}export async function openInTerminal(n,t){await terminalBackendFor(t).open(n)}export async function runInTerminal(n,t,e){await terminalBackendFor(e).run(n,t)}export function parseWeztermPanes(n){if(!n)return[];let t;try{t=JSON.parse(n)}catch{return[]}if(!Array.isArray(t))return[];const e=[];for(const r of t){const o=r;typeof o?.pane_id!="number"||typeof o?.tab_id!="number"||e.push({windowId:typeof o.window_id=="number"?o.window_id:0,tabId:o.tab_id,paneId:o.pane_id,cwd:typeof o.cwd=="string"?o.cwd:null,left:typeof o.left_col=="number"?o.left_col:0,top:typeof o.top_row=="number"?o.top_row:0,isActive:o.is_active===!0,title:typeof o.title=="string"&&o.title?o.title:null})}return e}export function normalizeDirKey(n,t){if(!n)return null;let e=n;if(e.startsWith("file://")){e=e.slice(7);try{e=decodeURIComponent(e)}catch{return null}t==="win32"&&(e=e.replace(/^\//,""))}return e=e.replace(/\\/g,"/").replace(/\/+$/,""),e?t==="win32"?e.toLowerCase():e:null}export function countWindowsByDir(n,t,e=process.platform){const r=n.map(a=>normalizeDirKey(a,e)),o=n.map(()=>new Set);for(const a of t){const s=normalizeDirKey(a.cwd,e);if(s)for(let i=0;i<n.length;i++)r[i]!==null&&r[i]===s&&o[i].add(`${a.muxKey}#${a.windowId}`)}return new Map(n.map((a,s)=>[a,o[s].size]))}export const MAX_PANES_PER_SCREEN=6;function et(n,t,e){const r=new Map,o=new Map;for(const i of t)o.set(i.tabId,(o.get(i.tabId)??0)+1),normalizeDirKey(i.cwd,e)===n&&r.set(i.tabId,(r.get(i.tabId)??0)+1);let a=null,s=0;for(const[i,c]of r)(o.get(i)??0)>=MAX_PANES_PER_SCREEN||(a===null||c>s||c===s&&i<a)&&(a=i,s=c);return a}export function planWeztermGrid(n){if(n.length===0||n.length>=MAX_PANES_PER_SCREEN)return null;if(n.length===1)return{paneId:n[0].paneId,direction:"right"};const t=new Map;for(const o of n){const a=t.get(o.left)??[];a.push(o),t.set(o.left,a)}const e=[...t.entries()].sort(([o],[a])=>o-a).map(([,o])=>[...o].sort((a,s)=>s.top-a.top));if(e.length===1)return{paneId:e[0][0].paneId,direction:"right"};let r=e[0];for(const o of e)o.length<r.length&&(r=o);return{paneId:r[0].paneId,direction:"bottom"}}export function planWeztermReuse(n,t,e=process.platform){const r=normalizeDirKey(n,e);if(!r)return null;const o=et(r,t,e);return o===null?null:planWeztermGrid(t.filter(a=>a.tabId===o))}export function planWeztermNewWindow(n,t){const e=["cli","spawn","--new-window","--cwd",n];return t&&e.push("--workspace",t),e}export function weztermMuxKey(n){return N("sha256").update(n).digest("hex").slice(0,8)}export function weztermPaneFromEnv(n,t,e){const[r,o]=S.wezterm,a=n[r],s=n[o];if(!a||!s)return null;const i=normalizeDirKey(s,e),c=t.find(l=>normalizeDirKey(l.socket,e)===i);return!c||!c.panes.some(l=>String(l.paneId)===a)?null:`${weztermMuxKey(c.socket)}:${a}`}export function sessionScreensFromEnvs(n,t,e=process.platform){const[r,o]=S.wezterm,a={};for(const[s,i]of Object.entries(n)){const c=i[r],l=i[o],p=l?t.find(u=>normalizeDirKey(u.socket,e)===normalizeDirKey(l,e)):void 0,d=p?.panes.find(u=>String(u.paneId)===c);if(!p||!d){a[s]=null;continue}a[s]={id:`${weztermMuxKey(p.socket)}:${d.windowId}:${d.tabId}`,windowId:d.windowId,tabId:d.tabId,tabsInWindow:new Set(p.panes.filter(u=>u.windowId===d.windowId).map(u=>u.tabId)).size}}return a}export function parseAttachTargetId(n){const t=/^([0-9a-f]{8}):(\d+):(\d+)$/.exec(n);return t?{muxKey:t[1],windowId:Number(t[2]),tabId:Number(t[3])}:null}export function attachTargetsFromMuxes(n,t,e=process.platform){const r=normalizeDirKey(n,e);if(!r)return[];const o=[];for(const a of[...t].sort((s,i)=>s.idleMs-i.idleMs)){const s=new Map;for(const c of a.panes){const l=`${c.windowId}:${c.tabId}`,p=s.get(l)??[];p.push(c),s.set(l,p)}const i=[];for(const[c,l]of s){const p=l.filter(x=>normalizeDirKey(x.cwd,e)===r).length;if(p===0)continue;const d=Number(c.slice(0,c.indexOf(":"))),u=Number(c.slice(c.indexOf(":")+1)),X=l.find(x=>x.isActive)??l[0];i.push({id:`${weztermMuxKey(a.socket)}:${d}:${u}`,windowId:d,tabId:u,title:X.title,matchCount:p,paneCount:l.length,active:l.some(x=>x.isActive),full:l.length>=MAX_PANES_PER_SCREEN})}i.sort((c,l)=>Number(l.active)-Number(c.active)||l.tabId-c.tabId),o.push(...i)}return o}export async function listAttachTargets(n,t=process.platform){const{muxes:e}=await m();return attachTargetsFromMuxes(n,e,t)}function R(n){if(!n)return null;let t;try{t=JSON.parse(n)}catch{return null}if(!Array.isArray(t))return null;let e=null;for(const r of t){const o=r;if(typeof o?.workspace!="string"||!o.workspace)continue;const a=o.idle_time,s=(typeof a?.secs=="number"?a.secs*1e3:0)+(typeof a?.nanos=="number"?a.nanos/1e6:0);(e===null||s<e.idleMs)&&(e={workspace:o.workspace,idleMs:s})}return e}export function weztermActiveWorkspaceOf(n){return R(n)?.workspace??null}const D=5e3;function h(n,t,e,r=D){return new Promise(o=>{let a;try{a=M(n,t,{windowsHide:!0,env:e??process.env})}catch{o(null);return}let s="",i="",c=!1;const l=d=>{c||(c=!0,clearTimeout(p),o(d))};a.stdout.on("data",d=>{s+=d.toString()}),a.stderr?.on("data",d=>{i+=d.toString()});const p=setTimeout(()=>{a.stdout.destroy(),a.stderr?.destroy(),a.unref(),a.kill(),l({ok:!1,out:s,err:i.trim(),timedOut:!0})},r);p.unref(),a.on("error",()=>l(null)),a.on("close",d=>{l({ok:d===0,out:s,err:i.trim(),timedOut:!1})})})}function g(n,t){return h("wezterm",n,{...process.env,WEZTERM_UNIX_SOCKET:t})}function y(n,t,e){const r=`wezterm[${b(t)}] ${n.join(" ")}`;return e===null?`${r}: executable not found`:e.timedOut?`${r}: timed out after ${D}ms`:e.err?`${r}: ${e.err}`:`${r}: exited with failure`}function nt(n){try{return process.kill(n,0),!0}catch{return!1}}function K(n){let t;try{t=V(n)}catch{return[]}const e=[];for(const r of t){const o=/^gui-sock-(\d+)$/.exec(r);if(!o)continue;const a=Number(o[1]);nt(a)&&e.push({path:E(n,r),pid:a})}return e.sort((r,o)=>o.pid-r.pid).map(r=>r.path)}function rt(n,t){const e=n.replace(/\\/g,"/");return t==="win32"?e.toLowerCase():e}export function weztermSocketCandidates(n){const t=[],e=new Set,r=a=>{const s=rt(a,n);e.has(s)||(e.add(s),t.push(a))};process.env.WEZTERM_UNIX_SOCKET&&r(process.env.WEZTERM_UNIX_SOCKET);const o=n==="win32"?process.env.USERPROFILE:process.env.HOME;return o&&K(E(o,".local","share","wezterm")).forEach(r),n!=="win32"&&process.env.XDG_RUNTIME_DIR&&K(E(process.env.XDG_RUNTIME_DIR,"wezterm")).forEach(r),t}const ot=6e4;export class SocketProbeGate{dead=new Set;cooling=new Map;shouldProbe(t,e=Date.now()){if(this.dead.has(t))return!1;const r=this.cooling.get(t);return r===void 0||e>=r}succeeded(t){this.cooling.delete(t)}failed(t){this.dead.add(t),this.cooling.delete(t)}cooledDown(t,e=Date.now()){this.dead.has(t)||this.cooling.set(t,e+ot)}}const P=new SocketProbeGate;async function m(n=!1){const t=weztermSocketCandidates(process.platform);return{muxes:(await Promise.all(t.map(async e=>{if(!P.shouldProbe(e))return null;const r=await g(["cli","list","--format","json"],e);if(!r?.ok)return r&&!r.timedOut?P.failed(e):P.cooledDown(e),null;P.succeeded(e);const o=parseWeztermPanes(r.out);if(n)return{socket:e,panes:o,workspace:null,idleMs:Number.POSITIVE_INFINITY};const a=await g(["cli","list-clients","--format","json"],e),s=R(a?.ok?a.out:null);return{socket:e,panes:o,workspace:s?.workspace??null,idleMs:s?.idleMs??Number.POSITIVE_INFINITY}}))).filter(e=>e!==null),candidates:t}}async function at(n){const{muxes:t}=await m();if(t.length===0)return!1;const e=t.reduce((r,o)=>o.idleMs<r.idleMs?o:r);return await B(e.socket,n,null,e.workspace),!0}async function st(n,t){const e=process.platform,{muxes:r,candidates:o}=await m();if(r.length===0)throw new Error(o.length===0?`wezterm mux undiscoverable: ${process.env.WEZTERM_UNIX_SOCKET?"WEZTERM_UNIX_SOCKET set but dead":"WEZTERM_UNIX_SOCKET unset"} and no living gui-sock under socket dirs (USERPROFILE=${process.env.USERPROFILE??"?"} HOME=${process.env.HOME??"?"}) \u2014 is wezterm running?`:`wezterm mux sockets all unreachable: ${o.map(i=>b(i)).join(", ")} \u2014 wezterm may be wedged, restart it`);let a=null,s=null;for(const i of r){const c=planWeztermReuse(n,i.panes,e);c&&(a===null||i.idleMs<a.idleMs)&&(a=i,s=c)}a??=r.reduce((i,c)=>c.idleMs<i.idleMs?c:i),await F(a.socket,n,t,s,a.workspace)}async function B(n,t,e,r){const o=e?["cli","split-pane","--pane-id",String(e.paneId),`--${e.direction}`,"--cwd",t]:planWeztermNewWindow(t,r),a=await g(o,n);if(!a?.ok)throw new Error(y(o,n,a));const s=a.out.trim();if(!/^\d+$/.test(s))throw new Error(`wezterm[${b(n)}] ${o.join(" ")}: unexpected pane id "${s}"`);return s}async function F(n,t,e,r,o,a=process.platform){const s=["cli","send-text","--pane-id",await B(n,t,r,o),"--no-paste",`${f(e,a)}\r`],i=await g(s,n);if(!i?.ok)throw new Error(y(s,n,i))}export async function runInWeztermAt(n,t,e,r=process.platform){const o=parseAttachTargetId(e);if(!o)throw new Error(`Invalid terminal target "${e}"`);const{muxes:a}=await m(),s=a.find(c=>weztermMuxKey(c.socket)===o.muxKey);if(!s)throw new Error("wezterm instance is gone \u2014 pick a terminal again");const i=s.panes.filter(c=>c.windowId===o.windowId&&c.tabId===o.tabId);if(i.length===0)throw new Error("terminal tab is gone \u2014 pick a terminal again");if(i.length>=MAX_PANES_PER_SCREEN)throw new Error(`terminal is full (${MAX_PANES_PER_SCREEN} panes) \u2014 pick another terminal or open a new one`);await F(s.socket,n,t,planWeztermGrid(i),s.workspace,r)}export async function countOpenTerminals(n,t){return terminalBackendFor(t).countWindows(n)}export async function readTerminalCounts(n,t=defaultProjectOpener){const e=await q(),r=await(t.countTerminals??countOpenTerminals)(n.map(o=>o.path),e.terminal);return Object.fromEntries(n.map(o=>[o.id,r.get(o.path)??0]))}let k=null;async function U(){if(k&&Date.now()-k.at<1e4)return k.muxes;const{muxes:n}=await m(!0);return k={at:Date.now(),muxes:n},n}const it=['if application "Terminal" is not running then return ""','tell application "Terminal"','  set out to ""',"  repeat with w in windows","    set wid to id of w","    set fm to frontmost of w as text","    repeat with t in tabs of w",'      set out to out & wid & "\\t" & (index of t) & "\\t" & tty of t & "\\t" & (selected of t as text) & "\\t" & fm & linefeed',"    end repeat","  end repeat","  return out","end tell"].join(`
+`);export function parseTerminalAppDump(n){const t=[];for(const e of n.split(`
+`)){const r=e.trim().split("	");if(r.length!==5)continue;const o=Number(r[0]),a=Number(r[1]);!Number.isInteger(o)||!Number.isInteger(a)||t.push({windowId:o,tabIndex:a,tty:r[2],selected:r[3]==="true",frontmost:r[4]==="true"})}return t}export function parsePsRootPids(n){const t=new Map,e=new Map;for(const o of n.split(`
+`)){const a=/^\s*(\d+)\s+(\d+)\s+(\S+)/.exec(o);if(!a)continue;const s=Number(a[1]),i=a[3];if(i==="??")continue;const c=t.get(i)??new Set;c.add(s),t.set(i,c),e.set(s,Number(a[2]))}const r=new Map;for(const[o,a]of t)for(const s of a)if(!a.has(e.get(s)??-1)){r.set(o,s);break}return r}export function parseLsofCwds(n){const t=new Map;let e=-1;for(const r of n.split(`
+`))r.startsWith("p")&&/^\d+$/.test(r.slice(1))?e=Number(r.slice(1)):r.startsWith("n")&&e!==-1&&(t.set(e,r.slice(1)),e=-1);return t}export async function listTerminalAppSurfaces(n){if(n!=="darwin")return[];const t=await h("osascript",["-e",it]);if(!t?.ok)return[];const e=parseTerminalAppDump(t.out);if(e.length===0)return[];const r=await h("ps",["-axo","pid=,ppid=,tty="]);if(!r?.ok)return e.map(c=>({...c,cwd:null}));const o=parsePsRootPids(r.out),a=[...new Set(e.map(c=>o.get(c.tty.replace(/^\/dev\//,""))??-1))].filter(c=>c!==-1),s=a.length>0?await h("lsof",["-a","-p",a.join(","),"-d","cwd","-Fn"]):null,i=parseLsofCwds(s?.out??"");return e.map(c=>({...c,cwd:i.get(o.get(c.tty.replace(/^\/dev\//,""))??-1)??null}))}let $=null;async function ct(n){if($&&Date.now()-$.at<1e4)return $.surfaces;const t=await listTerminalAppSurfaces(n);return $={at:Date.now(),surfaces:t},t}function lt(n,t){return`terminal:${n}:${t}`}export function parseTerminalAppTargetId(n){const t=/^terminal:(\d+):(\d+)$/.exec(n);return t?{windowId:Number(t[1]),tabIndex:Number(t[2])}:null}function j(n,t,e){const r=normalizeDirKey(t,e);return r?n.filter(o=>o.cwd!==null&&normalizeDirKey(o.cwd,e)===r):[]}export function terminalAppTargets(n,t,e=process.platform){const r=j(t,n,e);return r.sort((o,a)=>Number(a.frontmost)-Number(o.frontmost)||Number(a.selected)-Number(o.selected)||a.tabIndex-o.tabIndex),r.map(o=>({id:lt(o.windowId,o.tabIndex),windowId:o.windowId,tabId:o.tabIndex,title:null,matchCount:1,paneCount:1,active:o.frontmost&&o.selected,full:!1}))}export function pickTerminalAppWindow(n,t,e=process.platform){const r=j(n,t,e);return r.length===0?null:(r.sort((o,a)=>Number(a.frontmost)-Number(o.frontmost)||a.windowId-o.windowId),{windowId:r[0].windowId,tabIndex:r[0].tabIndex})}async function dt(n,t){return terminalAppTargets(n,await listTerminalAppSurfaces(t),t)}async function L(n,t,e){const r=`cd ${quotePath(n,"darwin")} && ${f(t,"darwin")}`.replace(/\\/g,"\\\\").replace(/"/g,'\\"');return(await h("osascript",["-e",`tell application "Terminal" to do script "${r}" in window id ${e}`]))?.ok===!0}const pt=["$ErrorActionPreference = 'SilentlyContinue'","$src = @'","using System; using System.Runtime.InteropServices;","public class WeaveWtCwd {",'  [DllImport("ntdll.dll")] static extern int NtQueryInformationProcess(IntPtr h, int c, ref PBI pbi, int size, out int rl);','  [DllImport("kernel32.dll")] static extern IntPtr OpenProcess(int a, bool inh, int pid);','  [DllImport("kernel32.dll")] static extern bool ReadProcessMemory(IntPtr h, IntPtr addr, byte[] buf, int size, out IntPtr read);','  [DllImport("kernel32.dll")] static extern bool CloseHandle(IntPtr h);',"  [StructLayout(LayoutKind.Sequential)] struct PBI { public IntPtr r1; public IntPtr Peb; public IntPtr r2; public IntPtr r3; public IntPtr Pid; public IntPtr r4; }","  static IntPtr ReadPtr(IntPtr h, IntPtr addr) { var b = new byte[8]; IntPtr r; if (!ReadProcessMemory(h, addr, b, 8, out r)) return IntPtr.Zero; long v = BitConverter.ToInt64(b, 0); return v == 0 ? IntPtr.Zero : (IntPtr)v; }","  static ushort ReadU16(IntPtr h, IntPtr addr) { var b = new byte[2]; IntPtr r; if (!ReadProcessMemory(h, addr, b, 2, out r)) return 0; return BitConverter.ToUInt16(b, 0); }","  public static string GetCwd(int pid) {","    var h = OpenProcess(0x0410, false, pid);","    if (h == IntPtr.Zero) return null;","    try {","      var pbi = new PBI(); int rl;","      if (NtQueryInformationProcess(h, 0, ref pbi, Marshal.SizeOf(typeof(PBI)), out rl) != 0) return null;","      var pp = ReadPtr(h, (IntPtr)((long)pbi.Peb + 0x20));","      if (pp == IntPtr.Zero) return null;","      ushort len = ReadU16(h, (IntPtr)((long)pp + 0x38));","      var buf = ReadPtr(h, (IntPtr)((long)pp + 0x40));","      if (buf == IntPtr.Zero || len == 0 || len > 2048) return null;","      var b = new byte[len]; IntPtr r;","      if (!ReadProcessMemory(h, buf, b, len, out r)) return null;","      return System.Text.Encoding.Unicode.GetString(b).TrimEnd('\\0');","    } finally { CloseHandle(h); }","  }","}","'@","Add-Type -TypeDefinition $src","foreach ($p in Get-CimInstance Win32_Process) {","  $cwd = [WeaveWtCwd]::GetCwd($p.ProcessId)","  if ($null -ne $cwd -or $p.Name -eq 'WindowsTerminal.exe' -or $p.Name -eq 'OpenConsole.exe') {","    $created = if ($p.CreationDate) { $p.CreationDate.ToString('yyyyMMddHHmmss') } else { '' }","    '{0}|{1}|{2}|{3}|{4}' -f $p.ProcessId, $p.ParentProcessId, $p.Name, $created, $cwd","  }","}"].join(`
+`),ut=15e3;export function parseWtProcDump(n){const t=[];for(const e of n.split(`
+`)){const r=e.trimEnd().split("|");if(r.length!==5)continue;const o=Number(r[0]),a=Number(r[1]);!Number.isInteger(o)||!Number.isInteger(a)||o<=0||a<0||r[2]&&t.push({pid:o,parentPid:a,name:r[2].toLowerCase(),created:r[3],cwd:r[4]===""?null:r[4]})}return t}const Z=new Set(["bash.exe","zsh.exe","sh.exe","fish.exe","pwsh.exe","powershell.exe","cmd.exe"]);export function wtPanes(n){const t=new Set(n.filter(o=>o.name==="windowsterminal.exe").map(o=>o.pid));if(t.size===0)return[];const e=new Map;for(const o of n){if(o.parentPid===o.pid)continue;const a=e.get(o.parentPid)??[];a.push(o),e.set(o.parentPid,a)}const r=[];for(const o of n){if(!t.has(o.parentPid)||o.name==="openconsole.exe")continue;let a=o;for(;Z.has(a.name);){const s=(e.get(a.pid)??[]).filter(i=>Z.has(i.name));if(s.length===0)break;a=s.reduce((i,c)=>c.created>i.created||c.created===i.created&&c.pid>i.pid?c:i)}r.push({pid:o.pid,cwd:a.cwd})}return r}function G(n){return n.map(t=>({muxKey:`wt:${t.pid}`,windowId:t.pid,cwd:t.cwd}))}async function wt(){if(process.platform!=="win32")return[];const n=await h("powershell.exe",["-NoProfile","-Command",pt],void 0,ut);return n?.ok?wtPanes(parseWtProcDump(n.out)):[]}let T=null;async function H(){if(T&&Date.now()-T.at<1e4)return T.panes;const n=await wt();return T={at:Date.now(),panes:n},n}export function wtWindowSlug(n){const t=normalizeDirKey(n,"win32")??"root",e=t.replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,""),r=N("sha1").update(t).digest("hex").slice(0,8);return`weave-${e.slice(0,48)||"root"}-${r}`}export function parseWtTargetId(n){const t=/^wt:(weave-[a-z0-9-]+)$/.exec(n);return t?t[1]:null}export const defaultProjectOpener={openExplorer:openInExplorer,openTerminal:openInTerminal,runInTerminal,countTerminals:countOpenTerminals,listTerminals:(n,t)=>terminalBackendFor(t).listTargets(n),runInTerminalAt:(n,t,e,r)=>terminalBackendFor(r).runAt(n,t,e)};

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

@@ -0,0 +1,13 @@
+export declare const DEFAULT_PORT = 6420;
+/** 客户端连接目标（CLI / vite 代理）：连本机永远走回环。 */
+export declare const DAEMON_HOST = "127.0.0.1";
+/**
+ * 服务端默认绑定地址（settings `server.bindHost` 可改回 127.0.0.1）。与上面的
+ * DAEMON_HOST 是**两个概念**：那个是「客户端连哪」，这个是「服务端听哪」——
+ * 绑 0.0.0.0 = 局域网可达，由 dashboard 密码认证兜底（见 daemon/auth.ts）。
+ */
+export declare const DEFAULT_BIND_HOST = "0.0.0.0";
+/** Resolve `true` when the port can be bound (no existing listener). */
+export declare function isPortFree(port: number, host?: string): Promise<boolean>;
+/** Find the first free port starting at `start`, scanning up to `maxScan` ports. */
+export declare function findFreePort(start: number, maxScan?: number): Promise<number>;

package/node_modules/@weavecode/server/dist/daemon/port.js

@@ -0,0 +1 @@
+import t from"node:net";export const DEFAULT_PORT=6420,DAEMON_HOST="127.0.0.1",DEFAULT_BIND_HOST="0.0.0.0";export function isPortFree(r,n=DAEMON_HOST){return new Promise(e=>{const o=t.createServer();o.once("error",()=>e(!1)),o.once("listening",()=>o.close(()=>e(!0))),o.listen(r,n)})}export async function findFreePort(r,n=100){for(let e=r;e<r+n;e++)if(await isPortFree(e))return e;throw new Error(`No free port found in range ${r}-${r+n-1}`)}

package/node_modules/@weavecode/server/dist/daemon/project-harnesses.d.ts

@@ -0,0 +1,18 @@
+import { type Harness } from '@weavecode/core';
+import type { HarnessRegistry } from '@weavecode/harness';
+/** 项目行 / 新建会话共用的一个已接入 harness。 */
+export interface ProjectHarness {
+    id: Harness;
+    /** true = 该 harness 有 resume 槽的裸 bin，可「在项目既有终端里新建会话」；
+     *  false（如 codex）只出现在项目卡标签里，不进新建会话的可选项。 */
+    canStartSession: boolean;
+}
+/** 项目的已接入 harness（init 选择结果）+ 各自能否起交互会话（注册表现状）。 */
+export declare function projectHarnesses(projectPath: string, registry?: HarnessRegistry): Promise<ProjectHarness[]>;
+/** 项目行补上 `harnesses` 字段（项目列表 / 归档面）——项目卡标签与新建会话的
+ *  harness 选项同源，不给 web 第二处取数。 */
+export declare function withProjectHarnesses<T extends {
+    path: string;
+}>(rows: T[], registry?: HarnessRegistry): Promise<(T & {
+    harnesses: ProjectHarness[];
+})[]>;

package/node_modules/@weavecode/server/dist/daemon/project-harnesses.js

@@ -0,0 +1,2 @@
+import{readFile as i}from"node:fs/promises";import o from"node:path";import{HARNESS_KEYS as c,isHarness as f}from"@weavecode/core";async function m(s){const r=[c[0]];let t;try{t=await i(o.join(s,".weave","config.yaml"),"utf-8")}catch{return r}const e=t.split(`
+`).find(a=>a.startsWith("harnesses:"));if(!e)return r;try{const a=JSON.parse(e.slice(e.indexOf(":")+1).trim()),n=Array.isArray(a)?a.filter(f):[];return n.length>0?n:r}catch{return r}}export async function projectHarnesses(s,r){return(await m(s)).map(t=>({id:t,canStartSession:!!r?.get(t)?.resume?.bin}))}export async function withProjectHarnesses(s,r){return Promise.all(s.map(async t=>({...t,harnesses:await projectHarnesses(t.path,r)})))}

package/node_modules/@weavecode/server/dist/daemon/project-updates-refresher.d.ts

@@ -0,0 +1,36 @@
+import type { DataBus } from './data-bus.js';
+import type { HookEventBus } from '../hooks/bus.js';
+/**
+ * ProjectUpdatesRefresher — 项目行「有更新待同步」角标的数据面（SSE 推送）。
+ *
+ * 与 InflightCountsRefresher 同形状（无定时器、指纹去重、值变才推**绝对值
+ * 快照**），但触发源有两个：项目插件根变更（plugin-loader 的 watcher 重扫后
+ * 广播 `plugin.reloaded`）与显式对账（新 SSE 客户端接入、同步落地后）——漂移
+ * 只随盘面变化而变，没有轮询的理由。前端零请求：漏帧的客户端在下一次快照
+ * 自我校正；`GET /projects/:id/updates` 仍是权威检测面（hover 兜底同源同算）。
+ */
+export declare class ProjectUpdatesRefresher {
+    /** 现算一份每项目待同步数（projectId → 条数，含 0）；失败应 throw，由本类吞掉。 */
+    private readonly snapshot;
+    private readonly bus;
+    /** 是否值得重算（一般为「有 SSE 客户端」）。缺省恒真（测试用）。 */
+    private readonly shouldRun;
+    /** 上次取到的快照（null = 还没算过）；新客户端首帧的数据源。 */
+    private lastCounts;
+    /** 上次推送的取值指纹；相同则不再推（只推变化）。 */
+    private lastFingerprint;
+    /** 重算要读盘/算指纹，防重入（并发重算会让快照乱序到达）。 */
+    private running;
+    constructor(
+    /** 现算一份每项目待同步数（projectId → 条数，含 0）；失败应 throw，由本类吞掉。 */
+    snapshot: () => Promise<Record<number, number>>, bus: DataBus, hookBus: HookEventBus, 
+    /** 是否值得重算（一般为「有 SSE 客户端」）。缺省恒真（测试用）。 */
+    shouldRun?: () => boolean);
+    /** 显式对账（用户动作/同步落地）：无视「没人看」判定，仍只在值变化时推。 */
+    refreshNow(ignoreSubscribers?: boolean): Promise<void>;
+    /**
+     * 新 SSE 客户端接入：先无条件补一帧上次快照（帧是广播，值没变也得补，
+     * 否则这个连接要等到下一次源变更），再后台对一次账补差量。
+     */
+    onSubscriberJoin(): void;
+}

package/node_modules/@weavecode/server/dist/daemon/project-updates-refresher.js

@@ -0,0 +1 @@
+export class ProjectUpdatesRefresher{snapshot;bus;shouldRun;lastCounts=null;lastFingerprint=null;running=!1;constructor(n,s,t,i=()=>!0){this.snapshot=n,this.bus=s,this.shouldRun=i,t.subscribe(r=>{r.kind==="plugin.reloaded"&&this.refreshNow()})}async refreshNow(n=!1){if(!this.running&&!(!n&&!this.shouldRun())){this.running=!0;try{const s=await this.snapshot();this.lastCounts=s;const t=JSON.stringify(s);if(t===this.lastFingerprint)return;this.lastFingerprint=t,this.bus.emit({key:"updates",payload:{counts:s}})}catch{}finally{this.running=!1}}}onSubscriberJoin(){this.lastCounts!==null&&(this.lastFingerprint=JSON.stringify(this.lastCounts),this.bus.emit({key:"updates",payload:{counts:this.lastCounts}})),this.refreshNow(!0)}}