@weavecode/weave 0.0.0-stage → 0.1.0

package/node_modules/@weavecode/server/dist/hooks/message-deliverer.d.ts

@@ -0,0 +1,328 @@
+import { type Harness } from '@weavecode/core';
+import type { MessagingSurface } from '@weavecode/harness';
+import type { HookEventRepository } from '../repositories/hook-events.js';
+import type { ProjectRepository } from '../repositories/projects.js';
+import type { SessionRepository } from '../repositories/sessions.js';
+import { type SessionTerminal } from '../daemon/opener.js';
+import type { HookEventBus } from './bus.js';
+import { HeadlessRunner, type SpawnLike } from './headless-runner.js';
+/**
+ * 消息域投递器（消息域重塑：纯递送管道，非记录系统）——消息不落任何 DB 行，
+ * 唯一归宿是目标会话自己的转录；weave 仅投递前短暂持有：
+ *
+ *   prompt  → 层① 原生 peer 消息中继（claude SendMessage，经受限 headless 进程）
+ *             层② 终端 send-text 兜底（无原生机制的 harness；TerminalBackend 通道）
+ *             层③ promptbox 队列（`<dataDir>/hooks/promptbox/<shard>.jsonl`，送达即删行）
+ *   inject  → outbox 顺延注入（fire-and-forget，随目标会话下一拍 hook 事件送达）
+ *   headless → 无头强制回合（running → 终态）
+ *   auto    → turnOpen 忙 → inject（绝不无头抢占）；闲 → headless
+ *
+ * 内存态注册表只放「pending 之后」的消息（投递中 / headless 在途 / 终态结果）；
+ * pending 只存在于 promptbox 文件。重启即丢 headless 终态 = 显式高级选项的
+ * 已文档代价。通道规格全部来自 MessagingSurface 能力面，本类不含 harness 硬编码。
+ *
+ * send() 校验失败同步返回错误码；成功立即返回（inject 已落 outbox，headless
+ * 「已启动」，prompt 视层可用性返回 delivering/pending），终态经回调后台落定，
+ * 绝不 throw 出 send()。
+ */
+/** 投递模式（路由入参；auto = 裁决后落 inject/headless）。 */
+export type MessageMode = 'prompt' | 'inject' | 'headless' | 'auto';
+/** 发起方（仅信封渲染用，管道不记录来源）。 */
+export type MessageFromKind = 'dashboard' | 'session';
+/** 管道消息状态：pending 只活在 promptbox 文件，其余在内存注册表。 */
+export type PipeStatus = 'pending' | 'delivering' | 'running' | 'injected' | 'delivered' | 'succeeded' | 'failed' | 'timeout';
+/** 管道消息（内存态；发号 = uuid，全生命周期稳定）。 */
+export interface PipeMessage {
+    id: string;
+    sessionId: string;
+    text: string;
+    mode: MessageMode;
+    /** 单向注入（手动面：无接收方会话，中继载荷带「无需回复」注记）；编排域不置。 */
+    oneWay?: boolean;
+    /** prompt 通道的实际落法（socket 直投 / 中继 / 终端 send-text）。 */
+    via?: 'socket' | 'relay' | 'terminal';
+    /** 投递回执：会话自己的 UserPromptSubmit 与本文匹配上了（真到达，非「已交给」）。 */
+    acked?: boolean;
+    /** 终态落定时刻（在途视图驻留窗口的起点；在途态无值）。 */
+    settledAt?: string | null;
+    /** 本条 = 该会话暂停闸的成因（未回执 / 投递失败）；重发或回执清除。 */
+    stalled?: boolean;
+    /** 实际投递通道（auto 落定后回填；pending = 尚未裁决成通道）。 */
+    channel: 'prompt' | 'inject' | 'headless' | null;
+    status: PipeStatus;
+    output?: string | null;
+    error?: string | null;
+    at: string;
+}
+/** 终端 send-text 兜底通道（层②）：TerminalBackend 能力面的消费侧形状。 */
+export interface PromptTerminal {
+    /** 通道可用性（同步声明；装配侧随 settings 终端后端能力变化，能力矩阵取用）。 */
+    available(): boolean;
+    /** 可注入 pane（id / 标题 / 工作目录；取不到的字段为 null）。 */
+    listPanes(): Promise<Array<{
+        id: string;
+        title: string | null;
+        cwd: string | null;
+    }>>;
+    /**
+     * 终端定位（hook 旁路上报的 pane env → pane id，**含存在性校验**：解析不出、
+     * mux 或 pane 已不在 = null）。可缺省（老装配/无定位能力的终端 = 恒回落标题+cwd）。
+     */
+    locatePane?(env: Record<string, string>): Promise<string | null>;
+    /**
+     * 会话 → 所在可见屏幕（会话列表分块的数据面）。可缺省（无枚举能力的终端 =
+     * 恒空表，那些会话不分组）；env 表批量进出（后端一次枚举摊平全部会话）。
+     */
+    locateScreens?(envs: Record<string, Record<string, string>>): Promise<Record<string, SessionTerminal | null>>;
+    /** 往 pane 注入一段 prompt（原文 + 提交键）。 */
+    sendText(paneId: string, text: string): Promise<void>;
+    /** 裸键序注入（作答的选项键 / 中断的 ESC：模态框只吃键盘，不吃粘贴文本）。 */
+    sendKeys(paneId: string, keys: string): Promise<void>;
+}
+export interface MessageDelivererDeps {
+    sessions: SessionRepository;
+    projects: ProjectRepository;
+    /** harness 归属判定用：目标会话最新事件的 source（与 open-terminal 同口径）。 */
+    hookEvents: HookEventRepository;
+    bus?: HookEventBus;
+    /** 共享无头执行核（与 ResumeRunner 同实例 = 跨域同会话并发闸；中继经合成键不占目标会话闸）。 */
+    headless?: HeadlessRunner;
+    /** 测试注入的 spawn 实现；缺省经 HeadlessRunner 用 node:child_process.spawn。 */
+    spawnImpl?: SpawnLike;
+    /** 测试注入的强杀实现。 */
+    killImpl?: (pid: number) => void;
+    /** harness 可执行覆盖（测试用）；缺省环境变量，再缺省 spec.bin。 */
+    bin?: string;
+    /** 无头回合超时（毫秒）；缺省 HeadlessRunner 默认 300s。 */
+    timeoutMs?: number;
+    /** prompt 中继超时（毫秒）；**缺省 0 = 不设超时**——投递的等待发生在目标
+     *  会话内（忙则等它下一拍 tool round 取走），设上限会把正常投递误判 timeout。 */
+    relayTimeoutMs?: number;
+    /** hooks 根目录（测试注入）；缺省 hooksRoot()。 */
+    hooksDir?: string;
+    /** 能力面访问器（测试注入）；缺省 surfaces.ts 模块级 registry。 */
+    surfaceFor?: (harness: Harness) => MessagingSurface;
+    /** 层② 终端 send-text 通道（装配侧按 TerminalBackend 能力注入；缺省无兜底）。 */
+    terminal?: PromptTerminal;
+    /** 冲洗节流：同一会话两次投递之间的最小间隔（毫秒）；缺省 1000。Claude Code 对
+     *  同一会话的快速突发会在**发送侧**拒收（见 docs/plan/session-orchestration.md）。 */
+    flushGapMs?: number;
+    /** 终态驻留窗口（毫秒）；缺省 60s——delivered/injected/succeeded 短时留在在途
+     *  视图展示 via/acked，过后消失（failed/timeout/暂停闸成因常驻）。 */
+    visibleTtlMs?: number;
+    /** 未回执闸窗口（毫秒）；缺省 120s——prompt 送达后没等到 UPS 回执即暂停该会话
+     *  的队列冲洗（防继续向 Held/Refused 的会话灌消息），手动重发或回执解除。 */
+    ackStallMs?: number;
+}
+/** send() 入参（路由层已做 zod 形状校验）。 */
+export interface SendInput {
+    toSessionId: string;
+    text: string;
+    mode: MessageMode;
+    fromKind: MessageFromKind;
+    fromSessionId?: string | null;
+    /** 单向注入（手动面置 true：无接收方会话）；编排域省略 = 双向对话保留。 */
+    oneWay?: boolean;
+}
+/** send() 返回：ok 由路由映射 200，否则 status 即 HTTP 码。 */
+export type SendResult = {
+    ok: true;
+    messageId: string;
+    status: PipeStatus;
+    message: PipeMessage;
+} | {
+    ok: false;
+    status: 400 | 404 | 409;
+    error: string;
+};
+/** answer() 返回（作答不建消息条目，无 messageId）。 */
+export type AnswerResult = {
+    ok: true;
+} | {
+    ok: false;
+    status: 400 | 404 | 409;
+    error: string;
+};
+export declare class MessageDeliverer {
+    private readonly deps;
+    private readonly headless;
+    private readonly hooksDir;
+    /** 内存态注册表（pending 之后的生命周期）。 */
+    private readonly memory;
+    /** 有队列行的会话（ingest 冲洗守卫 + 刷新器探活索引；构造时从磁盘重建）。 */
+    private readonly queuedSessions;
+    /** 会话 inbox 直投目标（hook 旁路上报；token 只在内存）。 */
+    private readonly inboxSockets;
+    /** 会话所在终端 pane 的定位 env（hook 旁路上报；纯内存，随会话走）。 */
+    private readonly paneEnvs;
+    /** 已排自续冲洗的会话（防重复排拍）。 */
+    private readonly flushScheduled;
+    /** 正在冲洗的会话（重入闸：异步冲洗 + 多条触发源，防同批行被投两次）。 */
+    private readonly flushing;
+    /** 队列暂停闸（sessionId → 成因消息）：未回执超窗 / 投递失败即置；重发或回执解除。 */
+    private readonly stalled;
+    /**
+     * 刚删掉的队列行 id：冲洗「先把队列读进内存、再逐条投递」——这中间被删的行
+     * 仍在手里那一批里，靠它跳过（否则删掉的消息照样发出去）。只兜这一个窗口，
+     * 故只留最近 `DISMISS_GUARD_MAX` 条。
+     */
+    private readonly dismissedIds;
+    constructor(deps: MessageDelivererDeps);
+    /**
+     * 裁决表（规格顺序）：session 404 → harness 无法判定 400 → 按模式落通道
+     * （auto 忙闲 / prompt 层可用性）→ 通道不支持 409+reason → 无项目 400/404 →
+     * headless 被占 409。通过后发号、广播 message.created 并立即投递。
+     */
+    send(input: SendInput): Promise<SendResult>;
+    /** 管道消息现查（内存态；sequence 引擎 / 路由回显用）。 */
+    getMessage(id: string): PipeMessage | null;
+    /**
+     * 在途视图（GET /sessions/:id/messages）：promptbox 待递送 ∪ 内存态——
+     * 在途（delivering/running）与 failed/timeout/暂停闸成因常驻；delivered/
+     * injected/succeeded 在驻留窗口（visibleTtlMs）内展示 via/acked，过后消失
+     * （历史在目标会话自己的转录里）。
+     */
+    listVisible(sessionId: string): PipeMessage[];
+    /** 该会话是否有队列行（ingest 冲洗守卫，O(1)）。 */
+    hasQueued(sessionId: string): boolean;
+    /**
+     * 在途计数（sessionId → 条数）：队列 pending（未送达）∪ 内存 delivering/running
+     * （在飞）。会话行角标用——终态（injected/delivered/succeeded/…）不计。
+     */
+    listInflightCounts(): Map<string, number>;
+    /** 层② 终端 send-text 通道是否装配（能力矩阵 prompt 列合成用）。 */
+    hasTerminalChannel(): boolean;
+    /**
+     * 自续冲洗：本轮投出去过（有进展）但队列仍有行 → 隔一拍继续，直到排空。
+     * 只有「有进展」才续（通道不可用时不续，避免热循环）；沿用节流间隔作拍长。
+     */
+    private scheduleFlushContinuation;
+    /**
+     * hook 旁路上报的会话 inbox 目标（内存态；socket 空 = 该会话此刻不可直投）。
+     * token 只在此存活，不落库、不进 UI、不写日志。
+     */
+    noteInboxSocket(sessionId: string, target: {
+        socket: string;
+        token: string | null;
+    } | null): void;
+    /**
+     * hook 旁路上报的会话 pane 定位 env（**每个 hook 事件覆盖刷新**：会话换 pane /
+     * resume 到新窗口后，下一次事件就把定位改过来，与 inbox 凭据同一自愈口径）。
+     */
+    notePaneEnv(sessionId: string, env: Record<string, string>): void;
+    /**
+     * 会话 → 所在可见屏幕（会话列表分块的数据面，只读）。旁路 env 与投递路径共用
+     * 同一份缓存，不另采一次；后端没有反查能力 = 空表（那些会话不分组）。
+     */
+    sessionTerminals(): Promise<Record<string, SessionTerminal | null>>;
+    /**
+     * 投递回执：会话自己的 UserPromptSubmit 到了 —— 其 prompt 原文与在途条目匹配
+     * 即成真（`acked`）。中继/终端/socket 三路通用（中继的原文外面裹着 Claude Code
+     * 自己的 `<cross-session-message …>` 壳，比对时归一掉）。
+     */
+    onSessionPrompt(sessionId: string, prompt: string): void;
+    /** 未回执闸布防：prompt 送达后 ackStallMs 内没等到 UPS 回执 → 暂停该会话队列。 */
+    private armAckWatch;
+    /** 置闸：成因消息标记 stalled（常驻在途视图）+ message.stalled 帧（web 重拉）。 */
+    private stall;
+    /**
+     * 远程作答（阻塞式交互）：向目标会话所在 pane 发裸键序——模态框只吃键盘，
+     * inbox/中继投递答不了。键序经白名单（`ANSWER_KEYS`）；pane 匹配复用层② 的
+     * 标题 + cwd 判定（歧义/找不到 pane = 409，不去别的终端乱打）。成功由调用
+     * 方乐观标记已答（PostToolUse 到达照常清除）。
+     */
+    answer(sessionId: string, atoms: readonly string[]): Promise<AnswerResult>;
+    /**
+     * 中断目标会话正在跑的回合（dashboard 停止按钮）：往 pane 打**一记 ESC**。
+     * 键序固定死在服务端（**不当参数收**）——这条通道一放开就是任意击键注入；
+     * 且只打一记：claude 里 ESC 一次是中断，连打两次是开历史回退菜单。
+     */
+    interrupt(sessionId: string): Promise<AnswerResult>;
+    /**
+     * 键序注入路径（作答 / 中断）共用的落点解析：会话 → 项目 → 终端通道 → pane。
+     * 全部失败原因是**可判定的语义拒绝**（404/409），调用方原样回给 HTTP。
+     */
+    private sessionKeysTarget;
+    /**
+     * 手动重发（暂停闸的解除动作）：prompt 通道 failed 或 delivered-未回执 的消息
+     * 重走投递（socket → 中继 → 终端 → 队列），重发即解闸并重新布防回执闸。
+     */
+    resend(messageId: string): Promise<SendResult>;
+    /**
+     * 删除一条在途视图里的消息行（dashboard「删除」）：内存行摘掉、队列待递送行
+     * （pending 只活在 promptbox 文件里）删行——两种都不再出现在这个会话的对话尾巴上。
+     * 内存行**不影响已投递的内容**（真到了会话，转录里的记录仍在）；队列行则是
+     * **取消发送**（还没出去）。内存行若正是暂停闸的成因 → 一并解闸（否则闸留着却
+     * 没有成因行可看、可操作），并续排空积压（下一条各自重新布防回执闸）。在飞
+     * （delivering/running）的行不删：落定回调会把行写回来，删了也白删。
+     */
+    dismiss(sessionId: string, messageId: string): AnswerResult;
+    /** 删掉队列里的一条待递送行（读到的行自己带 sessionId，配不上即不算命中）。 */
+    private dropQueued;
+    /**
+     * 队列冲洗（幂等）：直投命中即走；否则中继 / 终端按面定序（手动面终端优先）；
+     * 都不行留队列。
+     * **节流**（Claude Code 对同一会话的快速突发在发送侧拒收）：一轮最多 `FLUSH_PASS_MAX`
+     * 条、条间至少 `flushGapMs`（中继路径本就被同会话中继闸天然间隔，终端路径没有，
+     * 所以节流在这里统一兜）。超出的留队列，下轮触发（ingest / 刷新器）继续。
+     */
+    flushSession(sessionId: string): Promise<void>;
+    private flushSessionInner;
+    /** 刷新器入口：扫全部队列会话（只在队列非空时被调用才有意义）。 */
+    flushAll(): Promise<void>;
+    /** 会话删除级联：内存态 + 队列行。返回清理行数（口径与旧 DB 计数一致）。 */
+    forgetSession(sessionId: string): number;
+    /** 项目归档级联（内存态按会话→项目归属判定；队列行按会话逐个清）。 */
+    forgetProject(projectId: number): number;
+    /** harness 归属 = 最新事件 source（open-terminal 同口径）。 */
+    private surfaceOfSession;
+    /**
+     * mode → 实际通道。prompt = 层① 原生 || 层② 终端通道（都没有才 409）；
+     * auto 的忙/闲基准 = turnOpenOf，忙 → inject（无通道才拒绝，绝不无头抢占），
+     * 闲 → headless。对象 = 拒绝（409 reason）；字符串 = 选中的通道。
+     */
+    private resolveChannel;
+    /** 不支持原因：面声明优先，缺省兜底文案。 */
+    private unsupportedReason;
+    /**
+     * 目标会话的 pane：① **hook 旁路上报的终端定位**（精确——会话自己所在的 pane，
+     * 与标题是否漂移无关，也覆盖从没上报过标题的会话；后端已做存在性校验）→
+     * ② 回落「标题（剥 spinner 前缀，字符集含 ◐ 等输入等待态）+ 项目 cwd」启发式
+     * （无定位能力的终端 / 老 hook），歧义拒绝不打。
+     */
+    private terminalPaneFor;
+    /** 层② 通道现取（available 是随 settings 变的诚实声明，不可缓存到构造期）。 */
+    private terminalChannel;
+    /** prompt 通道入口（send 的即时路径）：层① 命中即时中继，层② 异步找 pane，都不行入队。 */
+    private deliverPrompt;
+    /**
+     * 层①-a 直投尝试：成功返回落定后的内存行；回落（无面 / 非手动 / 无目标 / 写失败）
+     * 返回 null。**队列冲洗也走它**——冲洗恰好由「刚上报凭据的那条 hook 事件」触发，
+     * 命中率最高；队列绕过它直奔中继，手动面就会凭空多出跨会话包裹与英文注记。
+     */
+    private tryInboxDeliver;
+    /** 入队（promptbox 追加 + 会话索引登记）。 */
+    private queueEntry;
+    /**
+     * 层① 中继：复用 HeadlessRunner 的 spawn 基建（win32 shell 单串 + stdin +
+     * 超时），键 = 合成键（不占目标会话的 headless 并发闸）。返回是否启动成功。
+     */
+    private runRelay;
+    /**
+     * 中继终态：成功 = delivered（+message.delivered，布防回执闸；中继闸释放后若还有
+     * 积压继续下一批）；失败 = failed 留内存可见（+message.finished）并置暂停闸——
+     * 不自动重试（避免对活着但拒收的会话反复打中继），手动重发解除。
+     */
+    private settleRelay;
+    /** 层② 终端注入终态（语义同中继：成功 delivered / 失败 failed 可见）。 */
+    private runTerminalPrompt;
+    /** inject 通道：信封写 outbox → injected（fire-and-forget 语义）。 */
+    private deliverInject;
+    /** headless 通道：置 running → 无头 spawn；终态经 onSettle 后台回写。 */
+    private deliverHeadless;
+    /** 信封：面可覆写（harness 自己的表示法）；缺省 weave 通用头 + 正文。 */
+    private renderEnvelope;
+    /** 终态落定（幂等，per-run state 守卫）：回写 → message.finished。 */
+    private settle;
+    private bus;
+}

package/node_modules/@weavecode/server/dist/hooks/message-deliverer.js

@@ -0,0 +1,3 @@
+import{randomUUID as w}from"node:crypto";import{tmpdir as b}from"node:os";import{WEAVE_INJECTION_MARKER as D,isHarness as x}from"@weavecode/core";import{messagingSurfaceFor as j}from"../surfaces.js";import{normalizeDirKey as g}from"../daemon/opener.js";import{HeadlessRunner as E}from"./headless-runner.js";import{appendOutbox as O,hooksRoot as P}from"./mirror.js";import{InboxSocketRegistry as A,deliverViaInboxSocket as B}from"./inbox-socket.js";import{appendPromptbox as C,readAllPromptbox as W,readPromptbox as m,removePromptboxBySession as M,removePromptboxEntries as c,scanQueuedSessionIds as q}from"./promptbox.js";const R=()=>b(),T=5,y=1e3,$=6e4,F=12e4,K=8,N=200,S=/^(?:[1-9]|n|\t|\r|\x1b\[B)$/,H=/^[^\x00-\x1f\x7f]*$/,_="\x1B",V=120,L=D;function k(u){return u.replace(/<\/?cross-session-message[^>]*>/g,"").replace(/\s+/g," ").trim()}const v=u=>new Promise(s=>setTimeout(s,u));export class MessageDeliverer{deps;headless;hooksDir;memory=new Map;queuedSessions;inboxSockets=new A;paneEnvs=new Map;flushScheduled=new Set;flushing=new Set;stalled=new Map;dismissedIds=new Set;constructor(s){this.deps=s,this.headless=s.headless??new E({spawnImpl:s.spawnImpl,killImpl:s.killImpl}),this.hooksDir=s.hooksDir??P(),this.queuedSessions=q(this.hooksDir)}async send(s){const t=this.deps.sessions.getBySessionId(s.toSessionId);if(!t)return{ok:!1,status:404,error:"Session not found"};const e=this.surfaceOfSession(s.toSessionId);if(!e)return{ok:!1,status:400,error:"Session has no hook events to determine its harness"};const n=this.resolveChannel(s.mode,s.toSessionId,e);if(typeof n!="string")return{ok:!1,status:409,error:n.reason};if(t.projectId==null)return{ok:!1,status:400,error:"Session is not bound to a project"};const o=this.deps.projects.getById(t.projectId);if(!o)return{ok:!1,status:404,error:"Project not found"};if(n==="headless"&&this.headless.isBusy(s.toSessionId))return{ok:!1,status:409,error:"Session already has a running run"};const i={fromLabel:s.fromKind==="session"?`session ${s.fromSessionId??"unknown"}`:s.fromKind,at:new Date().toISOString(),mode:n},r={id:w(),sessionId:s.toSessionId,text:s.text,mode:s.mode,oneWay:s.oneWay===!0,channel:n,status:"pending",at:i.at},a=n==="inject"?this.deliverInject(r,o.token,i,e):n==="headless"?this.deliverHeadless(r,o.path,i,e):await this.deliverPrompt(r,t,o,e);return this.bus({kind:"message.created",messageId:r.id,sessionId:r.sessionId,mode:r.mode,at:r.at}),a}getMessage(s){return this.memory.get(s)??null}listVisible(s){const t=this.deps.visibleTtlMs??$,e=Date.now(),n=[],o=this.deps.sessions.getBySessionId(s);if(o?.projectId!=null){const i=this.deps.projects.getById(o.projectId);if(i)for(const r of m(this.hooksDir,i.token))r.sessionId===s&&n.push({id:r.id,sessionId:s,text:r.text,mode:"prompt",oneWay:r.oneWay===!0,channel:"prompt",status:"pending",at:r.at})}for(const i of this.memory.values()){if(i.sessionId!==s)continue;if(i.stalled===!0||i.status==="delivering"||i.status==="running"){n.push(i);continue}if(i.status==="failed"||i.status==="timeout"){n.push(i);continue}const r=i.settledAt?Date.parse(i.settledAt):NaN;!Number.isNaN(r)&&e-r<t&&n.push(i)}return n.sort((i,r)=>i.at<r.at?-1:1)}hasQueued(s){return this.queuedSessions.has(s)}listInflightCounts(){const s=new Map,t=e=>{s.set(e,(s.get(e)??0)+1)};for(const e of W(this.hooksDir))t(e.sessionId);for(const e of this.memory.values())(e.status==="delivering"||e.status==="running")&&t(e.sessionId);return s}hasTerminalChannel(){return this.terminalChannel()!=null}scheduleFlushContinuation(s){this.flushScheduled.has(s)||(this.flushScheduled.add(s),setTimeout(()=>{this.flushScheduled.delete(s),this.flushSession(s)},this.deps.flushGapMs??y).unref?.())}noteInboxSocket(s,t){this.inboxSockets.set(s,t)}notePaneEnv(s,t){this.paneEnvs.set(s,t)}async sessionTerminals(){const s=this.terminalChannel();return!s?.locateScreens||this.paneEnvs.size===0?{}:s.locateScreens(Object.fromEntries(this.paneEnvs))}onSessionPrompt(s,t){const e=k(t);if(e)for(const n of[...this.memory.values()].reverse()){if(n.sessionId!==s||n.acked||n.mode!=="prompt")continue;const o=k(n.text);if(!(!o||o.length<K||!e.includes(o))){this.memory.set(n.id,{...n,acked:!0,stalled:!1}),this.stalled.get(s)?.messageId===n.id&&(this.stalled.delete(s),this.queuedSessions.has(s)&&this.scheduleFlushContinuation(s)),this.bus({kind:"message.acknowledged",messageId:n.id,sessionId:s,at:new Date().toISOString()});return}}}armAckWatch(s){setTimeout(()=>{const t=this.memory.get(s.id);!t||t.acked||t.status!=="delivered"||this.stall(t.sessionId,t,"unacked")},this.deps.ackStallMs??F).unref?.()}stall(s,t,e){this.stalled.set(s,{messageId:t.id,reason:e});const n=this.memory.get(t.id);n&&this.memory.set(t.id,{...n,stalled:!0}),this.bus({kind:"message.stalled",messageId:t.id,sessionId:s,reason:e,at:new Date().toISOString()})}async answer(s,t){if(t.length===0||!S.test(t[0])||t.some(n=>!S.test(n)&&!H.test(n)))return{ok:!1,status:400,error:"Invalid answer keys"};const e=await this.sessionKeysTarget(s,"Answering");if(!e.ok)return e;try{for(const[n,o]of t.entries())n>0&&await v(V),await e.terminal.sendKeys(e.paneId,o);return{ok:!0}}catch(n){return{ok:!1,status:409,error:n instanceof Error?n.message:String(n)}}}async interrupt(s){const t=await this.sessionKeysTarget(s,"Interrupting");if(!t.ok)return t;try{return await t.terminal.sendKeys(t.paneId,_),{ok:!0}}catch(e){return{ok:!1,status:409,error:e instanceof Error?e.message:String(e)}}}async sessionKeysTarget(s,t){const e=this.deps.sessions.getBySessionId(s);if(!e)return{ok:!1,status:404,error:"Session not found"};if(e.projectId==null)return{ok:!1,status:400,error:"Session is not bound to a project"};const n=this.deps.projects.getById(e.projectId);if(!n)return{ok:!1,status:404,error:"Project not found"};const o=this.terminalChannel();if(!o)return{ok:!1,status:409,error:`${t} needs a text-capable terminal (pick wezterm in settings)`};const i=await this.terminalPaneFor(e,n);return i?{ok:!0,terminal:o,paneId:i.id}:{ok:!1,status:409,error:"Session pane not found \u2014 is the session window open?"}}async resend(s){const t=this.memory.get(s);if(!t)return{ok:!1,status:404,error:"Message not found"};if(!(t.channel==="prompt"&&(t.status==="failed"||t.status==="delivered"&&!t.acked)))return{ok:!1,status:409,error:"Message is not resendable"};const e=this.deps.sessions.getBySessionId(t.sessionId);if(!e)return{ok:!1,status:404,error:"Session not found"};if(e.projectId==null)return{ok:!1,status:400,error:"Session is not bound to a project"};const n=this.deps.projects.getById(e.projectId);if(!n)return{ok:!1,status:404,error:"Project not found"};const o=this.surfaceOfSession(t.sessionId);if(!o)return{ok:!1,status:400,error:"Session has no hook events to determine its harness"};this.stalled.get(t.sessionId)?.messageId===s&&this.stalled.delete(t.sessionId),this.memory.delete(s);const i={...t,status:"pending",stalled:!1,acked:!1,settledAt:null},r=await this.deliverPrompt(i,e,n,o);return this.bus({kind:"message.created",messageId:i.id,sessionId:i.sessionId,mode:i.mode,at:new Date().toISOString()}),r}dismiss(s,t){const e=this.memory.get(t);if(e){if(e.status==="delivering"||e.status==="running")return{ok:!1,status:409,error:"Message is still in flight"};this.memory.delete(t),this.stalled.get(e.sessionId)?.messageId===t&&(this.stalled.delete(e.sessionId),this.queuedSessions.has(e.sessionId)&&this.scheduleFlushContinuation(e.sessionId))}else if(!this.dropQueued(s,t))return{ok:!1,status:404,error:"Message not found"};return this.bus({kind:"message.dismissed",messageId:t,sessionId:s,at:new Date().toISOString()}),{ok:!0}}dropQueued(s,t){const e=this.deps.sessions.getBySessionId(s);if(e?.projectId==null)return!1;const n=this.deps.projects.getById(e.projectId);if(!n)return!1;const o=m(this.hooksDir,n.token);if(!o.some(i=>i.id===t&&i.sessionId===s))return!1;for(c(this.hooksDir,n.token,new Set([t])),this.dismissedIds.add(t);this.dismissedIds.size>N;){const i=this.dismissedIds.values().next().value;if(i===void 0)break;this.dismissedIds.delete(i)}return o.some(i=>i.sessionId===s&&i.id!==t)||this.queuedSessions.delete(s),!0}async flushSession(s){if(!this.stalled.has(s)&&!this.flushing.has(s)&&this.queuedSessions.has(s)){this.flushing.add(s);try{await this.flushSessionInner(s)}catch{}finally{this.flushing.delete(s)}}}async flushSessionInner(s){const t=this.deps.sessions.getBySessionId(s);if(t?.projectId==null)return;const e=this.deps.projects.getById(t.projectId);if(!e)return;const n=m(this.hooksDir,e.token).filter(a=>a.sessionId===s);if(n.length===0){this.queuedSessions.delete(s);return}const o=this.surfaceOfSession(s),i=o?.prompt??null;let r=0;for(const a of n){if(this.stalled.has(s))return;if(this.dismissedIds.has(a.id))continue;if(r>=T){this.scheduleFlushContinuation(s);return}r>0&&await v(this.deps.flushGapMs??y);const d={id:a.id,sessionId:s,text:a.text,mode:"prompt",oneWay:a.oneWay===!0,via:"socket",channel:"prompt",status:"pending",at:a.at};if(o&&await this.tryInboxDeliver(d,o)){c(this.hooksDir,e.token,new Set([a.id])),r++;continue}const l=i?.resolve(s)??null,h=d.oneWay===!0?["terminal","relay"]:["relay","terminal"];let p=!1;for(const f of h){if(f==="relay"&&i&&l){if(this.memory.set(d.id,{...d,status:"delivering",via:"relay"}),!this.runRelay(d,i,l.name)){this.memory.delete(d.id);return}c(this.hooksDir,e.token,new Set([a.id])),r++,p=!0;break}if(f==="terminal"&&this.terminalChannel()){const I=await this.terminalPaneFor(t,e);if(I){c(this.hooksDir,e.token,new Set([a.id])),this.memory.set(d.id,{...d,via:"terminal",status:"delivering"}),await this.runTerminalPrompt(d.id,I.id,d.text),r++,p=!0;break}}}if(!p)return}m(this.hooksDir,e.token).filter(a=>a.sessionId===s).length===0&&this.queuedSessions.delete(s)}async flushAll(){for(const s of[...this.queuedSessions])await this.flushSession(s)}forgetSession(s){let t=0;for(const[e,n]of this.memory)n.sessionId===s&&(this.memory.delete(e),t++);return t+=M(this.hooksDir,s),this.queuedSessions.delete(s),this.stalled.delete(s),this.inboxSockets.forget(s),this.paneEnvs.delete(s),t}forgetProject(s){let t=0;for(const[e,n]of this.memory)this.deps.sessions.getBySessionId(n.sessionId)?.projectId===s&&(this.memory.delete(e),this.inboxSockets.forget(n.sessionId),this.paneEnvs.delete(n.sessionId),this.stalled.delete(n.sessionId),t++);for(const e of[...this.queuedSessions])this.deps.sessions.getBySessionId(e)?.projectId===s&&(t+=this.forgetSession(e));return t}surfaceOfSession(s){const t=this.deps.hookEvents.listBySession(s,1),e=t[t.length-1]?.source;return x(e)?this.deps.surfaceFor?.(e)??j(e):null}resolveChannel(s,t,e){if(s==="prompt")return e.prompt||this.terminalChannel()?"prompt":{reason:e.unsupportedReasons?.prompt??`Harness "${e.harness}" has no native prompt channel and the configured terminal cannot inject text`};if(s==="inject"||s==="headless")return(s==="inject"?e.inject:e.headless)?s:{reason:this.unsupportedReason(e,s)};const n=this.deps.sessions.turnOpenOf(t)?"inject":"headless";return(n==="inject"?e.inject:e.headless)?n:{reason:this.unsupportedReason(e,n)}}unsupportedReason(s,t){return s.unsupportedReasons?.[t]??`Harness "${s.harness}" does not support the ${t} messaging channel`}async terminalPaneFor(s,t){const e=this.terminalChannel();if(!e)return null;const n=this.paneEnvs.get(s.sessionId);if(n){const d=await e.locatePane?.(n).catch(()=>null);if(d)return{id:d}}if(!s.title)return null;const o=s.title.replace(/^[✻✽✶✳✢⋅◦✦✧∘◐◑◒◓*]+\s*/,""),i=g(t.path,process.platform);let r;try{r=await e.listPanes()}catch{return null}const a=r.filter(d=>d.title!=null&&d.cwd!=null&&i!=null&&d.title.replace(/^[✻✽✶✳✢⋅◦✦✧∘◐◑◒◓*]+\s*/,"")===o&&g(d.cwd,process.platform)===i);return a.length===1?a[0]:null}terminalChannel(){const s=this.deps.terminal;return s&&s.available()?s:null}async deliverPrompt(s,t,e,n){const o=await this.tryInboxDeliver(s,n);if(o)return{ok:!0,messageId:s.id,status:"delivered",message:o};const i=n.prompt,r=i?.resolve(s.sessionId)??null,a=s.oneWay===!0?["terminal","relay"]:["relay","terminal"];for(const l of a){if(l==="relay"&&i&&r){if(this.memory.set(s.id,{...s,status:"delivering",via:"relay"}),this.runRelay(s,i,r.name))return{ok:!0,messageId:s.id,status:"delivering",message:this.memory.get(s.id)};this.memory.delete(s.id)}if(l==="terminal"&&this.terminalChannel()){const h=await this.terminalPaneFor(t,e);if(h)return this.memory.set(s.id,{...s,status:"delivering",via:"terminal"}),this.runTerminalPrompt(s.id,h.id,s.text),{ok:!0,messageId:s.id,status:"delivering",message:this.memory.get(s.id)}}}this.queueEntry(s,e.token);const d={...s,status:"pending"};return{ok:!0,messageId:s.id,status:"pending",message:d}}async tryInboxDeliver(s,t){const e=t.promptInbox,n=this.inboxSockets.get(s.sessionId);if(!e||s.oneWay!==!0||!n)return null;this.memory.set(s.id,{...s,status:"delivering",via:"socket"});try{await B(e,n,`${L}${s.text}`)}catch{return this.memory.delete(s.id),null}const o={...this.memory.get(s.id),status:"delivered",via:"socket",settledAt:new Date().toISOString()};return this.memory.set(s.id,o),this.armAckWatch(o),this.bus({kind:"message.delivered",messageId:s.id,sessionId:s.sessionId,at:new Date().toISOString()}),o}queueEntry(s,t){C(this.hooksDir,t,[{id:s.id,sessionId:s.sessionId,text:s.text,oneWay:s.oneWay===!0}]),this.queuedSessions.add(s.sessionId)}runRelay(s,t,e){try{return this.headless.run({sessionId:`prompt-relay:${s.sessionId}`,cwd:R(),prompt:t.instruction(e,s.text,{oneWay:s.oneWay===!0}),spec:{supported:!0,bin:t.bin,args:()=>[...t.args],promptStdin:!0},bin:this.deps.bin??process.env.WEAVE_CLAUDE_BIN??t.bin,timeoutMs:this.deps.relayTimeoutMs??0,detached:!1,onSettle:n=>this.settleRelay(s.id,n)})}catch(n){return this.settleRelay(s.id,{status:"failed",output:null,error:n instanceof Error?n.message:String(n)}),!0}}settleRelay(s,t){const e=this.memory.get(s);if(!e)return;if(t.status==="succeeded"){this.queuedSessions.has(e.sessionId)&&this.scheduleFlushContinuation(e.sessionId);const o={...e,status:"delivered",settledAt:new Date().toISOString()};this.memory.set(s,o),this.armAckWatch(o),this.bus({kind:"message.delivered",messageId:s,sessionId:e.sessionId,at:new Date().toISOString()});return}const n={...e,status:"failed",error:t.error??`prompt relay ${t.status}`,settledAt:new Date().toISOString()};this.memory.set(s,n),this.stall(e.sessionId,n,"failed"),this.bus({kind:"message.finished",messageId:s,sessionId:e.sessionId,status:"failed",at:new Date().toISOString()})}async runTerminalPrompt(s,t,e){const n=this.memory.get(s);if(!n)return;const o=this.terminalChannel();if(o)try{await o.sendText(t,e);const i={...n,status:"delivered",settledAt:new Date().toISOString()};this.memory.set(s,i),this.armAckWatch(i),this.bus({kind:"message.delivered",messageId:s,sessionId:n.sessionId,at:new Date().toISOString()})}catch(i){const r={...n,status:"failed",error:i instanceof Error?i.message:String(i),settledAt:new Date().toISOString()};this.memory.set(s,r),this.stall(n.sessionId,r,"failed"),this.bus({kind:"message.finished",messageId:s,sessionId:n.sessionId,status:"failed",at:new Date().toISOString()})}}deliverInject(s,t,e,n){const o=this.renderEnvelope(s.text,e,n);O(this.hooksDir,t,[{sessionId:s.sessionId,text:o}]);const i={...s,status:"injected",settledAt:new Date().toISOString()};return this.memory.set(i.id,i),this.bus({kind:"message.delivered",messageId:i.id,sessionId:i.sessionId,at:new Date().toISOString()}),{ok:!0,messageId:i.id,status:"injected",message:i}}deliverHeadless(s,t,e,n){const o=n.headless,i={...s,status:"running"};this.memory.set(i.id,i);const r={settled:!1};try{this.headless.run({sessionId:i.sessionId,cwd:t,prompt:this.renderEnvelope(i.text,e,n),spec:o,bin:this.deps.bin??process.env.WEAVE_CLAUDE_BIN??o.bin,timeoutMs:this.deps.timeoutMs,onSettle:a=>this.settle(i,r,a)})||this.settle(i,r,{status:"failed",output:null,error:"Session already has a running run"})}catch(a){this.settle(i,r,{status:"failed",output:null,error:a instanceof Error?a.message:String(a)})}return{ok:!0,messageId:i.id,status:"running",message:this.memory.get(i.id)}}renderEnvelope(s,t,e){return e.renderEnvelope?.(s,t)??`[weave message] from=${t.fromLabel} at=${t.at} mode=${t.mode}
+
+${s}`}settle(s,t,e){if(t.settled)return;t.settled=!0;const n=this.memory.get(s.id);if(n)try{this.memory.set(s.id,{...n,status:e.status,output:e.output,error:e.error,settledAt:new Date().toISOString()}),this.bus({kind:"message.finished",messageId:s.id,sessionId:s.sessionId,status:e.status,at:new Date().toISOString()})}catch{}}bus(s){try{this.deps.bus?.emit(s)}catch{}}}

package/node_modules/@weavecode/server/dist/hooks/mirror.d.ts

@@ -0,0 +1,81 @@
+import type { HookRule } from '@weavecode/core';
+import type { ProjectRow, ProjectRepository } from '../repositories/projects.js';
+import type { SessionRepository } from '../repositories/sessions.js';
+import type { HookRuleRegistry } from './registry.js';
+import type { HookEventBus } from './bus.js';
+/**
+ * hook 文件化管道的 daemon 侧落点（`<dataDir>/hooks/`）：
+ * - `inbox/<shard>.jsonl`  hook → daemon 事件采集（hook-handler.cjs 只追加）
+ * - `mirror/<shard>.json`  daemon → hook 注入计划（本模块原子重写）
+ * - `outbox/<shard>.jsonl` daemon → hook 顺延注入（消费侧追加、hook 消费即删行）
+ *
+ * 目录名/shard 算法/文档形是跨端契约：生成脚本无依赖不能 import，helpers-gen.ts
+ * 以字面量保持同步。
+ */
+export declare const MIRROR_VERSION = 1;
+export declare const OUTBOX_MAX_LINES = 200;
+/** shard = 项目 token 的哈希前缀：纯分片键，不含语义；行内自带 token 解析项目。 */
+export declare function hookShardId(token: string): string;
+export declare function hooksRoot(dataDir?: string): string;
+export declare function mirrorPathOf(hooksDir: string, shardId: string): string;
+export declare function outboxPathOf(hooksDir: string, shardId: string): string;
+/** mirror 规则条目（hook 本地匹配所需的投影；数组序 = 匹配序 = priority 降序）。 */
+export interface MirrorRule {
+    id: string;
+    name: string;
+    events: string[];
+    tools: string[] | null;
+    globs: string[] | null;
+    template: string;
+}
+export interface HookMirrorDoc {
+    version: number;
+    /** {project} 模板变量（项目根 basename，与 dispatcher 的 projectLabel 同源）。 */
+    project: string;
+    pendingTitles: Record<string, string>;
+    rules: MirrorRule[];
+}
+/**
+ * 项目 → hook 本地注入计划。只投影 inject 规则（manual/webhook/log/plugin 的
+ * 动作都在消费侧）：harness 必须是 claude（hook-handler.cjs 只挂在 Claude Code）；
+ * crossProjectOnly 需要全项目表参与判定、hook 无法本地裁决 → 不投影，其注入走
+ * outbox 顺延。
+ */
+export declare function buildMirrorDoc(project: ProjectRow, rules: HookRule[], pendingTitles: Record<string, string>): HookMirrorDoc;
+export interface MirrorWriterDeps {
+    /** 覆盖 dataDir（测试注入）；缺省 getDataDir()。 */
+    dataDir?: string;
+    projects: Pick<ProjectRepository, 'list' | 'getById'>;
+    rules: Pick<HookRuleRegistry, 'list'>;
+    sessions: Pick<SessionRepository, 'list' | 'getBySessionId'>;
+}
+/**
+ * 把注入计划镜像到 `<dataDir>/hooks/mirror/<shard>.json`（tmp + rename 原子换）。
+ * 同步点：规则变更（registry.onChange → syncAll）、会话标题变更（bus
+ * session.renamed / PATCH rename → syncProject）。写失败吞掉——mirror 缺失只损失
+ * 注入，采集不受影响（hook 对缺失/坏 mirror 按空计划处理）。
+ */
+export declare class MirrorWriter {
+    private readonly deps;
+    private readonly dataDir;
+    constructor(deps: MirrorWriterDeps);
+    syncAll(): void;
+    syncProject(projectId: number): void;
+    write(token: string, doc: HookMirrorDoc): void;
+    /** bus 订阅：session.renamed（改名挂起/采纳/交付落定）→ 该会话所属项目的 mirror 重同步。 */
+    attachToBus(bus: Pick<HookEventBus, 'subscribe'>): void;
+}
+export interface OutboxEntry {
+    sessionId: string;
+    text: string;
+}
+/**
+ * inbox 追加（daemon 侧）：旧版 hook-handler 的 POST /hooks 兼容口把报告转投
+ * 这里，与新版 hook 走同一条采集管道。行形 `{v, token, report}` 是跨端契约。
+ */
+export declare function appendInbox(hooksDir: string, token: string, report: unknown): void;
+/**
+ * 顺延注入追加（消费侧：dispatcher 产出的 plugin / 未镜像规则注入，交给同一
+ * 会话的下一次 hook 事件带进会话）。有界：超过行上限丢最旧。
+ */
+export declare function appendOutbox(hooksDir: string, token: string, entries: OutboxEntry[]): void;

package/node_modules/@weavecode/server/dist/hooks/mirror.js

@@ -0,0 +1,5 @@
+import{createHash as u}from"node:crypto";import{mkdirSync as a,readFileSync as f,renameSync as d,writeFileSync as l}from"node:fs";import{join as i}from"node:path";import{hookSourceHarness as m}from"@weavecode/core";import{getDataDir as h}from"../db/paths.js";import{projectLabel as y}from"./match.js";export const MIRROR_VERSION=1,OUTBOX_MAX_LINES=200;export function hookShardId(s){return u("sha256").update(s).digest("hex").slice(0,16)}export function hooksRoot(s=h()){return i(s,"hooks")}export function mirrorPathOf(s,o){return i(s,"mirror",`${o}.json`)}export function outboxPathOf(s,o){return i(s,"outbox",`${o}.jsonl`)}export function buildMirrorDoc(s,o,e){const r=o.filter(t=>!(t.source.kind!=="hook-event"||m(t.source)!=="claude"||t.handler.type!=="inject"||!t.enabled||t.projectId!==null&&t.projectId!==s.id||t.filter.crossProjectOnly)).sort((t,n)=>n.priority-t.priority).map(t=>({id:t.id,name:t.name,events:[t.source.kind==="hook-event"?t.source.event:""],tools:t.filter.toolNames?.length?[...t.filter.toolNames]:null,globs:t.filter.pathGlobs?.length?[...t.filter.pathGlobs]:null,template:t.handler.type==="inject"?t.handler.template:""}));return{version:MIRROR_VERSION,project:y(s.path),pendingTitles:e,rules:r}}export class MirrorWriter{deps;dataDir;constructor(o){this.deps=o,this.dataDir=o.dataDir??h()}syncAll(){for(const o of this.deps.projects.list())this.syncProject(o.id)}syncProject(o){const e=this.deps.projects.getById(o);if(!e||e.archivedAt)return;const r={};for(const t of this.deps.sessions.list(o))t.pendingTitle&&(r[t.sessionId]=t.pendingTitle);this.write(e.token,buildMirrorDoc(e,this.deps.rules.list(),r))}write(o,e){try{const r=mirrorPathOf(hooksRoot(this.dataDir),hookShardId(o));a(i(hooksRoot(this.dataDir),"mirror"),{recursive:!0});const t=`${r}.tmp`;l(t,JSON.stringify(e)),d(t,r)}catch{}}attachToBus(o){o.subscribe(e=>{if(e.kind!=="session.renamed"||!e.sessionId)return;const r=this.deps.sessions.getBySessionId(e.sessionId);r?.projectId!=null&&this.syncProject(r.projectId)})}}export function appendInbox(s,o,e){const r=i(s,"inbox");a(r,{recursive:!0}),l(i(r,`${hookShardId(o)}.jsonl`),JSON.stringify({v:1,token:o,report:e})+`
+`,{flag:"a"})}export function appendOutbox(s,o,e){if(e.length!==0)try{const r=outboxPathOf(s,hookShardId(o));a(i(s,"outbox"),{recursive:!0});let t=[];try{t=f(r,"utf8").split(`
+`).filter(c=>c.trim())}catch{t=[]}for(const c of e)t.push(JSON.stringify({...c,at:new Date().toISOString()}));const n=t.slice(-OUTBOX_MAX_LINES),p=`${r}.tmp`;l(p,n.length?n.join(`
+`)+`
+`:""),d(p,r)}catch{}}

package/node_modules/@weavecode/server/dist/hooks/plugin-installer.d.ts

@@ -0,0 +1,57 @@
+export declare function globalPluginRoot(): string;
+/** src 为本地路径（存在目录/含 manifest 的父目录）或 git URL（https:// 或 git@ 或 *.git 结尾）。 */
+export declare function isGitSource(src: string): boolean;
+export interface InstallResult {
+    installed: Array<{
+        id: string;
+        name: string;
+        version: string;
+        dir: string;
+    }>;
+    /** 风险提示（git/npm 来源的无沙箱警告由 CLI 转述）。 */
+    warnings: string[];
+}
+/**
+ * 安装插件到全局插件根。src = 本地目录 | git URL。
+ * 找到的每个插件包复制为 `<root>/<id>/`，写 installed.json（同 id 覆盖更新）。
+ * 路径穿越防护：目标目录名只用 manifest.id（已过 schema 的 kebab-case）。
+ */
+export declare function installPlugin(src: string, opts?: {
+    root?: string;
+}): Promise<InstallResult>;
+/** 卸载：删目录 + 清 installed.json。规则级联删除由 daemon 热重载完成。 */
+export declare function uninstallPlugin(pluginId: string, opts?: {
+    root?: string;
+}): Promise<boolean>;
+/**
+ * 导出插件为可分发目录（剔除 node_modules/.git）：`<out>/<id>`。
+ * 目标已存在则覆盖——export 是生成物而非用户数据。
+ */
+export declare function exportPlugin(pluginId: string, outDir: string, opts?: {
+    root?: string;
+}): Promise<string>;
+export interface PluginIndexEntry {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    /** 下载地址（git URL 或可直接 clone 的地址）。 */
+    url: string;
+    checksum?: string;
+}
+/**
+ * sources.json 结构：旧形为 index URL 字符串数组，新形为 `{ indexes }`。
+ * 读侧两种形都接受，写侧统一落对象形。
+ */
+export interface SourcesFileShape {
+    indexes: string[];
+}
+/** 解析 sources.json 原始值：旧 `string[]` 与新 `{indexes}` 双形兼容。 */
+export declare function parseSources(raw: unknown): SourcesFileShape;
+export declare function readSourcesFile(root?: string): Promise<SourcesFileShape>;
+export declare function writeSourcesFile(sources: SourcesFileShape, root?: string): Promise<void>;
+/**
+ * marketplace 搜索：读 sources.json（`<configDir>/weave/plugins/sources.json`）
+ * 逐 index 源拉取，按 term 过滤 id/name/description。
+ */
+export declare function searchPlugins(term: string): Promise<PluginIndexEntry[]>;

package/node_modules/@weavecode/server/dist/hooks/plugin-installer.js

@@ -0,0 +1,3 @@
+import{cp as j,mkdir as p,readFile as E,readdir as P,rm as m,writeFile as x}from"node:fs/promises";import{existsSync as F}from"node:fs";import s from"node:path";import{spawn as N}from"node:child_process";import{WEAVE_PLUGIN_MANIFEST as h,WeavePluginManifestSchema as O}from"@weavecode/core";import{getDataDir as $}from"../db/paths.js";export function globalPluginRoot(){return s.join($(),"plugins")}function A(r){return s.join(r??globalPluginRoot(),"installed.json")}async function D(r){try{const i=JSON.parse(await E(A(r),"utf8"));return Array.isArray(i)?i:[]}catch{return[]}}async function B(r,i){const e=i??globalPluginRoot();await p(e,{recursive:!0}),await x(A(i),JSON.stringify(r,null,2)+`
+`,"utf8")}async function v(r){try{const i=JSON.parse(await E(s.join(r,h),"utf8"));return O.safeParse(i).success?i:null}catch{return null}}async function J(r){const i=[],e=await v(r);if(e)return[{dir:r,manifest:e}];let t;try{t=await P(r)}catch{return i}for(const u of t){const n=s.join(r,u),o=await v(n);o&&i.push({dir:n,manifest:o})}return i}function T(r,i,e,t=6e4){return new Promise((u,n)=>{const o=N(r,i,{cwd:e,windowsHide:!0,stdio:["ignore","pipe","pipe"]});let a="";const l=setTimeout(()=>{o.kill(),n(new Error(`${r} ${i.join(" ")} \u8D85\u65F6\uFF08${t}ms\uFF09`))},t);o.stderr?.on("data",c=>a+=c.toString()),o.on("error",c=>{clearTimeout(l),n(c)}),o.on("close",c=>{clearTimeout(l),c===0?u():n(new Error(`${r} \u9000\u51FA\u7801 ${c}: ${a.slice(0,500)}`))})})}export function isGitSource(r){return/^(https?:\/\/|git@|ssh:\/\/|git:\/\/)/.test(r)||r.endsWith(".git")}export async function installPlugin(r,i){const e=[];let t,u;if(isGitSource(r)){e.push(`\u4ECE ${r} \u5B89\u88C5\u7684\u63D2\u4EF6\u672A\u7ECF\u6C99\u7BB1\u9694\u79BB\uFF0C\u8BF7\u786E\u8BA4\u6765\u6E90\u53EF\u4FE1`);const n=s.join($(),"tmp",`install-${Date.now()}`);await p(n,{recursive:!0}),await T("git",["clone","--depth","1",r,s.join(n,"repo")]),t=s.join(n,"repo"),u=()=>m(n,{recursive:!0,force:!0})}else if(t=s.resolve(r),!F(t))throw new Error(`\u672C\u5730\u8DEF\u5F84\u4E0D\u5B58\u5728: ${t}`);try{const n=await J(t);if(n.length===0)throw new Error(`\u672A\u627E\u5230 ${h}\uFF08src \u6216\u5176\u4E00\u7EA7\u5B50\u76EE\u5F55\uFF09`);const o=i?.root??globalPluginRoot();await p(o,{recursive:!0});const a=await D(i?.root),l=[];for(const{dir:c,manifest:g}of n){const f=String(g.id),y=s.join(o,f);s.resolve(y).startsWith(s.resolve(o)+s.sep)&&(await m(y,{recursive:!0,force:!0}),await j(c,y,{recursive:!0,filter:w=>!w.includes("node_modules")&&!w.includes(`${s.sep}.git`)}));const d={id:f,name:String(g.name??f),version:String(g.version??"0.0.0"),source:r,dir:f,installedAt:new Date().toISOString()},S=a.findIndex(w=>w.id===f);S>=0?a[S]=d:a.push(d),l.push({id:f,name:d.name,version:d.version,dir:f})}return await B(a,i?.root),{installed:l,warnings:e}}finally{u&&await u()}}export async function uninstallPlugin(r,i){const e=i?.root??globalPluginRoot(),t=await D(i?.root),u=t.find(o=>o.id===r),n=u?s.join(e,u.dir):s.join(e,r);return F(n)?(await m(n,{recursive:!0,force:!0}),u&&await B(t.filter(o=>o.id!==r),i?.root),!0):!1}export async function exportPlugin(r,i,e){const t=s.join(e?.root??globalPluginRoot(),r);if(!F(t))throw new Error(`\u63D2\u4EF6\u76EE\u5F55\u4E0D\u5B58\u5728: ${t}`);if(!await v(t))throw new Error(`\u63D2\u4EF6\u7F3A\u5C11\u5408\u6CD5 ${h}: ${r}`);const u=s.join(s.resolve(i),r);return await m(u,{recursive:!0,force:!0}),await j(t,u,{recursive:!0,filter:n=>!n.includes("node_modules")&&!n.includes(`${s.sep}.git`)}),u}function C(r){return s.join(r??globalPluginRoot(),"sources.json")}export function parseSources(r){if(Array.isArray(r))return{indexes:r.filter(i=>typeof i=="string")};if(r&&typeof r=="object"){const i=r.indexes;return{indexes:Array.isArray(i)?i.filter(e=>typeof e=="string"):[]}}return{indexes:[]}}export async function readSourcesFile(r){try{return parseSources(JSON.parse(await E(C(r),"utf8")))}catch{return{indexes:[]}}}export async function writeSourcesFile(r,i){const e=i??globalPluginRoot();await p(e,{recursive:!0}),await x(C(i),JSON.stringify(r,null,2)+`
+`,"utf8")}export async function searchPlugins(r){const{indexes:i}=await readSourcesFile(),e=[];for(const t of i)try{const u=await fetch(t,{signal:AbortSignal.timeout(1e4)});if(!u.ok)continue;const n=await u.json();for(const o of n.plugins??[]){const a=`${o.id} ${o.name} ${o.description??""}`.toLowerCase();(!r||a.includes(r.toLowerCase()))&&e.push(o)}}catch{}return e}