@wudao-org/server 0.0.0-stage → 0.4.20

package/dist/ports.d.ts

@@ -0,0 +1,364 @@
+import type { RecoveryStatusRow } from "./recovery.js";
+export type { RecoveryJournalEntry, RecoveryJournalFold, FoldSessionState, RecoveryObservation, RecoveryClassification, RecoverySettle, RecoveryPort, RecoveryStatusRow, RecoveryCoordinatorOptions, RecoveryCoordinator, } from "./recovery.js";
+export { createRecoveryJournal, foldRecoveryLines, classifyRecovery, createRecoveryCoordinator, RECOVERY_INTERVAL_MS, RECOVERY_CONCURRENCY, RECOVERY_ROTATION_BOUND, } from "./recovery.js";
+/** Loopback hostnames the Host header may carry (DNS-rebinding guard)。*/
+/** Close codes (documented in PROTOCOL.md)。*/
+/** ω99-225: the resume verdict relayed verbatim — a structural mirror of the
+ *  CLI's ResumeOutcome (this package never imports the CLI; the shapes are
+ *  kept identical by the twin tests in each package). `occupied` carries the
+ *  live lease holder's pid so the web can tell a busy session from a missing
+ *  one instead of guessing off the old bare boolean. */
+export type ResumeOutcome = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly reason: "not_found";
+} | {
+    readonly ok: false;
+    readonly reason: "occupied";
+    readonly holderPid: number;
+};
+/** The driver surface this server speaks to (structural — no CLI import).
+ *  Payloads are JSON-serializable values the server relays verbatim. */
+export interface UiDriverPort {
+    subscribe(cb: () => void): () => void;
+    getStatus(): unknown;
+    getHistory(): readonly unknown[];
+    onHistory(cb: (entries: readonly unknown[], reset: boolean) => void): () => void;
+    onLoopEvent(cb: (event: unknown) => void): () => void;
+    submit(text: string, opts?: {
+        readonly plan?: boolean;
+        readonly expand?: boolean;
+        readonly images?: readonly unknown[];
+        readonly files?: readonly unknown[];
+    }): unknown;
+    interrupt(): void;
+    /** 0.4.0 集成缝：车道工厂打开后恢复到该会话（主 driver 的同形方法）。 */
+    resume(id: string): Promise<{
+        ok: boolean;
+        not_found?: boolean;
+        occupied?: {
+            pid: number;
+        };
+    }>;
+    setMode(mode: string): void;
+    answerPermission(allow: boolean, reason?: string, scope?: "session" | "always"): boolean;
+    /** 借鉴弧 α2（CC 2.1.269 思想）— recall ONE still-queued steering message
+     *  (CAS: index+text from the same status frame; consumed entries → false).
+     *  User lane only. OPTIONAL like searchSessions: the ui host's ask-lane
+     *  wrapper mounts it; a driver without it cleanly refuses (server op). */
+    recallSteer?(index: number, text: string): boolean;
+    /** 借鉴弧 α1（Codex 0.154 思想）— answer the parked ask_user clarification
+     *  card (an absent/empty answer = dismiss → the tool's error result tells
+     *  the model to decide itself). Returns false when nothing is parked.
+     *  OPTIONAL — mounted by the same ask-lane wrapper. */
+    answerAskUser?(answer?: string): boolean;
+    /** 借鉴弧 δ（penguin 367ab084 思想）— move ONE in-flight tool call to the
+     *  background (its result stops blocking the turn; the run closes at the
+     *  turn boundary; the landed result merges later). callId from the status
+     *  frame's busyTools rows; absent = the first detachable row. Typed
+     *  refusals: {kind:"refused", reason:"not_detachable"|"not_in_flight"}.
+     *  OPTIONAL like recallSteer — mounted by the settings-ops wrapper. */
+    detachToolCall?(callId?: string): unknown;
+    listSlashCommands(): readonly unknown[];
+    sessions(): Promise<readonly unknown[]>;
+    searchSessions?(q: string): Promise<readonly unknown[]>;
+    deleteSession?(id: string): Promise<unknown>;
+    trashSessions?(): Promise<readonly unknown[]>;
+    restoreSession?(id: string): Promise<unknown>;
+    continueSession?(id: string): Promise<unknown>;
+    forkSession?(id: string): Promise<unknown>;
+    schedulesList?(): Promise<unknown>;
+    schedulesSetEnabled?(id: string, enabled: boolean): Promise<unknown>;
+    schedulesRemove?(id: string): Promise<unknown>;
+    schedulesRunNow?(id: string, opts?: {
+        readonly resetBreaker?: boolean;
+    }): Promise<unknown>;
+    resume(id: string): Promise<ResumeOutcome>;
+    rewind(target: number | "last" | "list"): Promise<string>;
+    /** M53 §1: /edit arming — returns the original text (null when out of
+     *  range or a run is in flight) so the web input can present it. */
+    beginEdit(n: number): string | undefined;
+    /** M53 §1: /tree //switch notice text. */
+    tree(): Promise<string>;
+    switchBranch(n?: number): Promise<string>;
+    /** ω99-258: the structured branch leaf table (PROTOCOL "branchLeaves") —
+     *  tree()'s data twin for the web branch panel: rows of {n, leafKey,
+     *  forkPreview, messageCount, isCurrent}. OPTIONAL like the settings ops —
+     *  a driver without it gets a clean "unsupported" error (old-server
+     *  degradation is the CLIENT's chip-hidden branch). Read-only, never
+     *  vaulted. */
+    branchLeaves?(): Promise<unknown>;
+    /** ω99-258: void a pending /edit arm (the web banner's 取消 — edit op with
+     *  n:0). OPTIONAL for the same reason; absent → the op refuses. */
+    disarmEdit?(): boolean;
+    /** ω99-260: the full memory ledger (PROTOCOL "memoryList") — the store's
+     *  load() table passed through structured (file order, active + pending)
+     *  for the web memory faces. OPTIONAL like branchLeaves — a driver without
+     *  it gets a clean "unsupported" error (old-server degradation is the
+     *  CLIENT's hidden face). Read-only, never vaulted. */
+    memoryList?(): Promise<unknown>;
+    /** ω99-260: decide one pending memory (PROTOCOL "memoryDecide") — ok
+     *  (confirm, pending→active) or del (remove the line); store.confirm/
+     *  remove are the single source. VAULTED: the decision is a side effect
+     *  that must survive a mid-flap replay exactly once, and ok/del converge
+     *  (a replayed second ok answers ok:false, never breaks). */
+    memoryDecide?(id: string, action: "ok" | "del"): Promise<unknown>;
+    /** ω99-264: #2 — rewrite one memory entry's content (PROTOCOL "memoryEdit") —
+     *  update + a conditional confirm (status-preserving: active stays active,
+     *  pending stays pending; tags/hits ride verbatim). VAULTED like the
+     *  decision, but the convergence lives in the DRIVER: a bare update is
+     *  NOT idempotent (v+1 per call), so the driver short-circuits a
+     *  content-equal replay (ok:true, zero writes) — a mid-flap replay lands
+     *  exactly once. */
+    memoryEdit?(id: string, content: string): Promise<unknown>;
+    improvementFace?(action: "list" | "consent" | "ignore" | "activate" | "reject" | "undo", id?: string): Promise<unknown>;
+    /** The provider matrix + credentials count + settings values (no secrets). */
+    settingsStatus?(): Promise<unknown>;
+    /** Persist one provider key to the credentials file (cli-side write). */
+    settingsSaveKey?(provider: string, key: string): Promise<unknown>;
+    /** One minimal request through the target provider; human failure states. */
+    settingsTestConnection?(provider: string, opts?: {
+        readonly key?: string;
+        readonly model?: string;
+    }): Promise<unknown>;
+    /** Write one allowlisted settings key — the 13 writable keys (ω99-237: #2 —
+     *  see settingsSet's unknown-key error in driver/settings-ops.ts, the
+     *  single source of truth; this mirror once drifted to "8" when the
+     *  language pair landed uncounted; ω99-287: #5 bumps 12→13 with
+     *  desktop.backgroundOnClose, doc-only). */
+    settingsSet?(key: string, value: unknown): Promise<unknown>;
+    /** Register/update one provider (custom or builtin overlay) in the
+     *  machine registry; the reply is status-only. */
+    settingsSaveProvider?(id: string, config: unknown): Promise<unknown>;
+    /** Remove one registry entry (customs only); a stored defaultModel
+     *  pointing at the deleted id falls back. Idempotent. */
+    settingsDeleteProvider?(id: string): Promise<unknown>;
+    /** Probe GET ${endpoint}/models through the target provider (the
+     *  testConnection key ladder + failure states); the request key never
+     *  echoes back. */
+    settingsListModels?(provider: string, opts?: {
+        readonly key?: string;
+    }): Promise<unknown>;
+    /** M75-ux1 §2: the workspace switcher's recents (PROTOCOL "recentWorkspaces")
+     *  — read the list, or (with `add`) unshift + persist + read. No separate
+     *  write op: the switch click adds through the same handler. */
+    recentWorkspaces?(add?: string): Promise<unknown>;
+    /** M77-workspace §1: same-window switch — starts a new UI session for the
+     *  target directory and returns its URL; the client navigates there. */
+    switchWorkspace?(path: string): Promise<unknown>;
+    /** One directory level: dirs first alphabetically, then files; dotfiles
+     *  and the hidden list carry hidden:true (the CLIENT filters). */
+    fileTree?(path: string): Promise<unknown>;
+    /** One file's UTF-8 content (1MB limit / 100KB prefix, binary sniff);
+     *  sensitive paths (.git, .ssh, .env*, credentials*) reject. */
+    fileRead?(path: string): Promise<unknown>;
+    /** 高亮/编辑 spec §3: the viewer's save — user-hand edit, no permission
+     *  pipeline; the driver enforces the read-side guards + the base
+     *  compare-and-swap + the atomic write. */
+    fileWrite?(path: string, content: string, base: string): Promise<unknown>;
+    /** ω99-314: 文件级时光机——把指定文件恢复到指定快照（改动面板「恢复到
+     *  这里」的引擎）。写面 op：VAULTED（isVaultedMutation），一次重放绝不
+     *  双写。守卫序与判决联合见 driver 的 fileRevert（busy/evicted/bad-path/
+     *  no-store 拒；ok:true 带 stale 事实）。OPTIONAL like fileWrite — 无该
+     *  方法的 driver 干净拒答（老 server 降级=面板恢复钮隐藏）。 */
+    fileRevert?(path: string, sha: string): Promise<unknown>;
+    /** workspace-ux B1: switch the file panel's VIEW root (PROTOCOL
+     *  "panelRootSet") — exists-and-directory validated driver-side; the
+     *  reply carries the new root. Deliberately NOT the agent root: the
+     *  session and its tool boundary never move (that is agentRootSwitch's
+     *  job, B2). */
+    panelRootSet?(path: string): Promise<unknown>;
+    /** workspace-ux B1: the dual-root snapshot (PROTOCOL "agentRootStatus") —
+     *  panelRoot (the view) vs agentRoot (the session's workspace root) and
+     *  whether they still agree. */
+    agentRootStatus?(): Promise<unknown>;
+    /** workspace-ux B2: switch the agent's workspace root (PROTOCOL
+     *  "agentRootSwitch") — idle applies now ({applied:true}); busy parks until
+     *  the run's settle seam ({queued:true}). Moves the builtin file tools'
+     *  boundary, shell's cwd, the FileChanged watchers, and the hook
+     *  payload root — NEVER the system prompt, the session id, or any .wudao
+     *  anchor. */
+    agentRootSwitch?(path: string): Promise<unknown>;
+    /** M76-ux2 §8: the ctx hover's breakdown (PROTOCOL "ctxInfo") — the
+     *  serialized prompt's per-section token estimates + the free remainder
+     *  (the StatusBar ctx segment's tooltip data). Read-only over driver
+     *  state; the relay below is a pass-through. */
+    ctxInfo?(): Promise<unknown>;
+    /** 140（监控要看全）: the session's full anatomy — system prompt text +
+     *  the persisted message chain (user prompts, assistant content/reasoning,
+     *  tool calls/results). Optional like ctxInfo (absent → the op refuses). */
+    sessionAnatomy?(): Promise<unknown>;
+    /** The away recap (PROTOCOL "recap"): stats counted from the
+     *  session's structured history since the viewer's mark, plus an optional
+     *  narrative from one tiny background model call. The reply is the payload
+     *  or undefined (a legitimate "no recap", not an error). Session identity,
+     *  the mark, and the ≥3-new-messages gate live in the driver handler
+     *  (agent-driver.ts) — the relay stays shape-validation only. */
+    recap?(sessionId: string, sinceMark: number, sinceTs?: number): Promise<unknown>;
+    /** ω99-316 — /btw 侧问 (PROTOCOL "sideQuestion"): ask the session's
+     *  side lane a question without interrupting the main run — a detached
+     *  loop over a sanitized clone of the request-time projection (frozen
+     *  tool table, maxTurns=3), answering {answer, rounds}. Read-only over
+     *  the session (never writes JSONL/store — a replay just re-asks, never
+     *  vaulted). Session identity and the empty-text gate live in the driver
+     *  handler; the relay stays shape-validation only. */
+    sideQuestion?(sessionId: string, text: string): Promise<unknown>;
+    /** Admit a base64 image batch → durable refs (limits live in the driver's
+     *  AttachmentStore: fail-closed admission BEFORE any write). */
+    attachmentSave?(inputs: readonly {
+        data: string;
+        mediaType: string;
+    }[]): Promise<unknown>;
+    /** One stored image back as base64 (for rendering history images). */
+    attachmentGet?(ref: {
+        attachmentId: string;
+        mediaType: string;
+        byteLength: number;
+    }): Promise<unknown>;
+    /** Admit a base64 generic-file batch → content-addressed FileBlocks
+     *  (fail-closed admission BEFORE any write; equal bytes dedup). */
+    fileSave?(inputs: readonly {
+        data: string;
+        name: string;
+    }[]): Promise<unknown>;
+    /** The install registry + enable state (the settings page's 已装 list). */
+    pluginList?(): Promise<unknown>;
+    /** MCP visibility (settings page's MCP tab): every configured server
+     *  across the three tiers with runtime status. */
+    mcpList?(): Promise<unknown>;
+    /** Every registered market + its discover entries (with install-preview
+     *  counts for local-dir sources; null for git-location sources). */
+    pluginMarketList?(): Promise<unknown>;
+    /** Add a market from a source (owner/repo · git URL#ref · 本地目录 ·
+     *  marketplace.json 路径); `name` overrides the manifest's own. */
+    pluginMarketAdd?(source: string, name?: string): Promise<unknown>;
+    /** Re-pull / re-copy one registered market. */
+    pluginMarketUpdate?(name: string): Promise<unknown>;
+    /** Unregister + delete a market, cascading the uninstall of the plugins
+     *  it installed (busy → refusal error, nothing touched). */
+    pluginMarketRemove?(name: string): Promise<unknown>;
+    /** Install a market's plugin into a scope root (reply carries the loader
+     *  dry-run's InstallDetail). */
+    pluginInstall?(name: string, market: string, scope: "user" | "project"): Promise<unknown>;
+    /** 引导安装（guided-install 弧）：spec 三形态（本地路径/GitHub 简写/git URL）+ 可选预览。 */
+    pluginInstallSpec?(spec: string, preview?: boolean): Promise<unknown>;
+    /** 长期记忆（M-Memory）：列表 + tombstone 删除。 */
+    longtermMemoryList?(): Promise<unknown>;
+    longtermMemoryForget?(id: string): Promise<unknown>;
+    /** Delete the install dir + registry record + enable key (busy → refusal). */
+    pluginUninstall?(id: string): Promise<unknown>;
+    /** Re-enable a disabled plugin (deletes the enabledPlugins key). */
+    pluginEnable?(id: string): Promise<unknown>;
+    /** Hide a plugin from discovery's mapping (registry record kept). */
+    pluginDisable?(id: string): Promise<unknown>;
+    /** Every registered persona (builtin + global + workspace) with its tier
+     *  source, layers label, and edit gate (global only). */
+    personaList?(): Promise<unknown>;
+    /** One persona's full definition (unknown id rejects). */
+    personaGet?(id: string): Promise<unknown>;
+    /** Create/update one GLOBAL persona (~/.wudao/personas/<id>.json). */
+    personaSave?(definition: unknown): Promise<unknown>;
+    /** Delete one global persona; the reference inventory when bound. */
+    personaDelete?(id: string, unbind?: boolean): Promise<unknown>;
+}
+/** ω99-235: #1 — the pet lane's server surface (this file's whole lane: the
+ *  narrow port below, the optional UiServerOptions.petDriver mount, the three
+ *  pet ops (#3), the dual-lane state frames (#4/#5), the sessions lane mark
+ *  (#6), and the vaulted-set join (#2)). The desktop sprite's own session —
+ *  a SECOND driver the same host process mounts beside the main one. The
+ *  five-method slice is all the pet ops and the state frame's `pet` field
+ *  consume — history/loop-events/settings/plugin surfaces stay main-lane-only
+ *  (no /commands, no resume).
+ *  ω99-271: #2 — the "Bubble is a pure send face: no history replay" premise
+ *  is RETIRED (user report 09-10: 「很多消息没有展示完全，也看不到完整的会话
+ *  信息」): the lane driver HAS the full pet.jsonl history (ui.ts resumes it
+ *  into getHistory at boot) — the window just had no way to ask. The port
+ *  gains ONE read; the send-face discipline (no commands, no resume, no
+ *  loop-event relay) stands. */
+export interface UiPetDriverPort {
+    subscribe(cb: () => void): () => void;
+    getStatus(): unknown;
+    submit(text: string): unknown;
+    interrupt(): void;
+    answerPermission(allow: boolean, reason?: string, scope?: "session" | "always"): boolean;
+    /** ω99-271 — the lane's own session history (pet.jsonl, already
+     *  branch-walked at boot). Structurally minimal read: `text` optional so
+     *  the driver's HistoryEntry union (tool/edit/board entries lack text)
+     *  assigns without a cli-side type dependency. */
+    getHistory(): readonly {
+        kind: string;
+        text?: string;
+    }[];
+}
+/** 多 driver 并发弧 B —— sid 寻址车道的驱动面：UiDriverPort 的交互切片
+ *  （状态/历史两个中继道 + submit/interrupt/setMode/answerPermission 四个
+ *  必选写面 + recallSteer/answerAskUser/detachToolCall 三个可选写面）。
+ *  结构化注入如 UiDriverPort：本包不 import cli，真实副车道由宿主的车道
+ *  管理器装配传入（参照 pet 车道的降配清单）。完整 UiDriverPort 天然满足
+ *  本接口（必需面全在场）——主车道就是 opts.driver 原样入表（key "main"）。
+ *  会话寻址面（resume/sessions/settings/file/plugin/persona/…）刻意不在
+ *  本接口：v1 车道弧只车道化「交互写面 + 两个中继道」（见 PROTOCOL.md
+ *  Lanes 节）。 */
+export interface LaneDriverPort {
+    /** 状态帧订阅：任何车道的 emit 都触发一次全表重读合并推送。 */
+    subscribe(cb: () => void): () => void;
+    /** 车道状态快照（推送时重读——永不携带陈旧车道态）。 */
+    getStatus(): unknown;
+    /** 车道当前史（auth 重放面 + petHistory 式拉取的数据源）。 */
+    getHistory(): readonly unknown[];
+    /** 史推送道：副车道帧由 server 侧统一标注 sid，driver 自身零感知。 */
+    onHistory(cb: (entries: readonly unknown[], reset: boolean) => void): () => void;
+    submit(text: string, opts?: {
+        readonly plan?: boolean;
+        readonly expand?: boolean;
+        readonly images?: readonly unknown[];
+        readonly files?: readonly unknown[];
+    }): unknown;
+    interrupt(): void;
+    /** 0.4.0 集成缝：车道工厂打开后恢复到该会话（主 driver 的同形方法）。 */
+    resume(id: string): Promise<{
+        ok: boolean;
+        not_found?: boolean;
+        occupied?: {
+            pid: number;
+        };
+    }>;
+    setMode(mode: string): void;
+    answerPermission(allow: boolean, reason?: string, scope?: "session" | "always"): boolean;
+    /** 以下三面 OPTIONAL——与 UiDriverPort 的同款可选面同形，server op 层
+     *  沿用「not supported by this driver」干净拒答族。 */
+    recallSteer?(index: number, text: string): boolean;
+    answerAskUser?(answer?: string): boolean;
+    detachToolCall?(callId?: string): unknown;
+}
+/** ω99-242: #3 — the crash-recovery coordinator's server-facing slice (the
+ *  petDriver mounting precedent: a host process owns the coordinator and
+ *  mounts it here; the server relays its status and forwards the ONE
+ *  invalidation seam). All three members are OPTIONAL-mounted: absent → the
+ *  recoveryStatus op answers a clean "not supported" and the submit op's
+ *  invalidation call is skipped — today's byte-identical behavior.
+ *  M24 声明（§二.10）：恢复注入发生在 resume 边界=冷转预期（cold turn
+ *  expected）——详见 recovery.ts 头注与弧报告。 */
+export interface UiRecoveryPort {
+    /** A manual client submit landed on the driver's CURRENT session — cancel
+     *  that session's pending recovery (invariant 7; permission replies ride
+     *  answerPermission and deliberately never reach this seam). */
+    noteUserInput(): void;
+    /** Structured per-session rows (the web reconciliation line's X/Y). */
+    status(): readonly RecoveryStatusRow[];
+    /** Graceful-shutdown checkpoint — freeze the in-flight session before the
+     *  engine dies (the orphan self-exit path calls this before exit(0)). */
+    stop(): Promise<void>;
+}
+/** ω99-235 — the pet lane's fixed session id, as a SERVER-SIDE LITERAL: this
+ *  package never imports the CLI (the workspace graph stays acyclic), so the
+ *  twin of cli/src/ui.ts's exported PET_SESSION_ID lives here — the pet-ops
+ *  tests pin both sides to the same bytes ("pet"). */
+export declare const PET_LANE_SESSION_ID = "pet";
+export interface PetHistoryTurnWire {
+    readonly q: string;
+    readonly a: string;
+}
+/** Pair the lane driver's session history into chat turns for the pet window. */
+//# sourceMappingURL=ports.d.ts.map

package/dist/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,yEAAyE;AACzE,8CAA8C;AAC9C;;;;wDAIwD;AAExD,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF;wEACwE;AACxE,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACtC,SAAS,IAAI,OAAO,CAAC;IACrB,UAAU,IAAI,SAAS,OAAO,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACjF,WAAW,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACtD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;IACxK,SAAS,IAAI,IAAI,CAAC;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC9F,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzF;;;8EAG0E;IAC1E,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACnD;;;2DAGuD;IACvD,aAAa,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC;;;;;2EAKuE;IACvE,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1C,iBAAiB,IAAI,SAAS,OAAO,EAAE,CAAC;IACxC,QAAQ,IAAI,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IAIxC,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IAMxD,aAAa,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAO7C,aAAa,CAAC,IAAI,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IAC9C,cAAc,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAQ9C,eAAe,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAU/C,WAAW,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAM3C,aAAa,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAOnC,mBAAmB,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,eAAe,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,eAAe,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D;wEACoE;IACpE,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,0CAA0C;IAC1C,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1C;;;;;mBAKe;IACf,YAAY,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC;uEACmE;IACnE,UAAU,CAAC,IAAI,OAAO,CAAC;IAEvB;;;;2DAIuD;IACvD,UAAU,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC;;;;iEAI6D;IAC7D,YAAY,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE;;;;;;wBAMoB;IACpB,UAAU,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAK3D,eAAe,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAOxH,8EAA8E;IAC9E,cAAc,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,yEAAyE;IACzE,eAAe,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,6EAA6E;IAC7E,sBAAsB,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvH;;;;gDAI4C;IAC5C,WAAW,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAQ5D;sDACkD;IAClD,oBAAoB,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE;6DACyD;IACzD,sBAAsB,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD;;uBAEmB;IACnB,kBAAkB,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F;;oEAEgE;IAChE,gBAAgB,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD;4EACwE;IACxE,eAAe,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAOjD;sEACkE;IAClE,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C;oEACgE;IAChE,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C;;+CAE2C;IAC3C,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1E;;;;gDAI4C;IAC5C,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD;;;;oBAIgB;IAChB,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C;;oCAEgC;IAChC,eAAe,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC;;;;;kBAKc;IACd,eAAe,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD;;;oDAGgD;IAChD,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7B;;gFAE4E;IAC5E,cAAc,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC;;;;;qEAKiE;IACjE,KAAK,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF;;;;;;0DAMsD;IACtD,YAAY,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAMjE;oEACgE;IAChE,cAAc,CAAC,CAAC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,sEAAsE;IACtE,aAAa,CAAC,CAAC,GAAG,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAOvG;uEACmE;IACnE,QAAQ,CAAC,CAAC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAU/E,yEAAyE;IACzE,UAAU,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC;sDACkD;IAClD,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B;wEACoE;IACpE,gBAAgB,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC;qEACiE;IACjE,eAAe,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,+CAA+C;IAC/C,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD;gEAC4D;IAC5D,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD;oCACgC;IAChC,aAAa,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,qEAAqE;IACrE,iBAAiB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,wCAAwC;IACxC,kBAAkB,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,oBAAoB,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,8EAA8E;IAC9E,eAAe,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,oEAAoE;IACpE,YAAY,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,qEAAqE;IACrE,aAAa,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAS7C;6DACyD;IACzD,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,0DAA0D;IAC1D,UAAU,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,sEAAsE;IACtE,WAAW,CAAC,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,qEAAqE;IACrE,aAAa,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAED;;;;;;;;;;;;;gCAagC;AAChC,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACtC,SAAS,IAAI,OAAO,CAAC;IACrB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,SAAS,IAAI,IAAI,CAAC;IAClB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzF;;;sDAGkD;IAClD,UAAU,IAAI,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1D;AAED;;;;;;;;gBAQgB;AAChB,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACtC,gCAAgC;IAChC,SAAS,IAAI,OAAO,CAAC;IACrB,4CAA4C;IAC5C,UAAU,IAAI,SAAS,OAAO,EAAE,CAAC;IACjC,gDAAgD;IAChD,SAAS,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACjF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;IACxK,SAAS,IAAI,IAAI,CAAC;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC9F,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzF;iDAC6C;IAC7C,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACnD,aAAa,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3C;AAED;;;;;;;wCAOwC;AACxC,MAAM,WAAW,cAAc;IAC7B;;oEAEgE;IAChE,aAAa,IAAI,IAAI,CAAC;IACtB,uEAAuE;IACvE,MAAM,IAAI,SAAS,iBAAiB,EAAE,CAAC;IACvC;6EACyE;IACzE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;sDAGsD;AACtD,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAUzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iFAAiF"}

package/dist/ports.js

@@ -0,0 +1,8 @@
+export { createRecoveryJournal, foldRecoveryLines, classifyRecovery, createRecoveryCoordinator, RECOVERY_INTERVAL_MS, RECOVERY_CONCURRENCY, RECOVERY_ROTATION_BOUND, } from "./recovery.js";
+/** ω99-235 — the pet lane's fixed session id, as a SERVER-SIDE LITERAL: this
+ *  package never imports the CLI (the workspace graph stays acyclic), so the
+ *  twin of cli/src/ui.ts's exported PET_SESSION_ID lives here — the pet-ops
+ *  tests pin both sides to the same bytes ("pet"). */
+export const PET_LANE_SESSION_ID = "pet";
+/** Pair the lane driver's session history into chat turns for the pet window. */
+//# sourceMappingURL=ports.js.map

package/dist/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AA8BA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAqZvB;;;sDAGsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAezC,iFAAiF"}

package/dist/probe.d.ts

@@ -0,0 +1,39 @@
+/** 探针类别（PB-1 的 cat 域，单一来源）。 */
+export declare const PROBE_CATS: readonly ["model", "tool", "ui", "system", "agent"];
+export type ProbeCat = (typeof PROBE_CATS)[number];
+/** 一条探针事件（PB-1 ProbeEvent 的 wire 镜像——结构端口，不 import core）。
+ *  `data` 是探针自带的自由负载（JSON 可序列化），server 原样中继。 */
+export interface ProbeEventWire {
+    readonly ts: number;
+    readonly cat: ProbeCat;
+    readonly name: string;
+    readonly sessionId?: string;
+    readonly lane?: string;
+    readonly data: Record<string, unknown>;
+    readonly dur?: number;
+}
+/** 宿主挂载的探针 bus 面（PB-1 ProbeBus 的结构镜像；stats 按 name 计数——
+ *  {count, lastTs}，与探针名一对一）。 */
+export interface UiProbeBusPort {
+    emit(e: ProbeEventWire): void;
+    subscribe(cat: ProbeCat | "*", cb: (e: ProbeEventWire) => void): () => void;
+    recent(cat?: string, limit?: number): readonly ProbeEventWire[];
+    stats(): Record<string, {
+        count: number;
+        lastTs: number;
+    }>;
+}
+/** probeRecent 的 limit 帽（环形缓冲同量级；防一帧拉 O(∞) 的形状门）。 */
+export declare const PROBE_RECENT_LIMIT_CAP = 1000;
+export interface ProbeRelay {
+    /** 三个 probe op 的统一入口（index.ts 的 switch case 直递；未知 op 名不
+     *  进来——dispatch 已按 case 名收敛）。 */
+    handleOp(o: Record<string, unknown>, reply: (ok: unknown, err?: string) => void): void;
+    /** 退订（server.close 时调用；未挂 bus 为 no-op）。 */
+    close(): void;
+}
+export declare function createProbeRelay(opts: {
+    readonly bus: UiProbeBusPort | undefined;
+    readonly send: (frame: unknown) => void;
+}): ProbeRelay;
+//# sourceMappingURL=probe.d.ts.map

package/dist/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../src/probe.ts"],"names":[],"mappings":"AAeA,+BAA+B;AAC/B,eAAO,MAAM,UAAU,qDAAsD,CAAC;AAC9E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;gDACgD;AAChD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;gCACgC;AAChC,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5E,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,CAAC;IAChE,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB;qCACiC;IACjC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACvF,2CAA2C;IAC3C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACzC,GAAG,UAAU,CA0Eb"}

package/dist/probe.js

@@ -0,0 +1,96 @@
+// PB-2（探针基础设施弧）— server 侧探针遥测车道：宿主 ProbeBus 的 WS 中继。
+// 结构化注入如 petDriver/recovery（本包不 import core，工作区图保持无环——
+// PB-1 落地 core 的 ProbeBus 天然满足 UiProbeBusPort，形状由本包孪生测试钉）。
+// 三个读面 op（全部 never vaulted——不进 vault 不重放，ω99-260 memoryList 读表
+// 先例）：
+//   probeStream  {cat?}        订阅：其后每条匹配事件转发一帧 {t:"probe",event}
+//                              （139：cat:"off" 退订——仪表盘关页停流）
+//   probeEnable  {on}          139：运行时翻转探针总闸（WUDAO_PROBE）
+//   probeRecent  {cat?,limit?} 拉环形缓冲（recent 同形直通）
+//   probeStats   {}            拉统计面（stats 原样回）
+// 缺省纪律（缺省零变化）：未挂 bus → 三 op 干净拒答（optional-ops 既有文案族）、
+// 零 probe 帧、零订阅副作用；挂了 bus 但客户端未 probeStream → 同样零帧（订阅
+// 门在 relay 内，emit 永不主动上链）。UI 主车道消费：probe 帧走既有单连接（单
+// 连接车道寻址先例），绝不另开 WS。
+/** 探针类别（PB-1 的 cat 域，单一来源）。 */
+export const PROBE_CATS = ["model", "tool", "ui", "system", "agent"];
+/** probeRecent 的 limit 帽（环形缓冲同量级；防一帧拉 O(∞) 的形状门）。 */
+export const PROBE_RECENT_LIMIT_CAP = 1000;
+export function createProbeRelay(opts) {
+    const { bus, send } = opts;
+    // 订阅门：null=未订阅（零帧）；cat=undefined=订阅全部类别；其余=单类别过滤。
+    // v1-A 单客户端：一个过滤槽足够；重发 probeStream 即换槽（幂等语义，最后
+    // 一次为准）。断线重连不重置——send 已按已认证槽位门控，无槽=零帧落地。
+    let filter = null;
+    const unsubscribe = bus?.subscribe("*", (event) => {
+        if (filter !== null && (filter.cat === undefined || filter.cat === event.cat)) {
+            send({ t: "probe", event });
+        }
+    });
+    const isCat = (v) => PROBE_CATS.includes(v);
+    return {
+        handleOp(o, reply) {
+            if (bus === undefined) {
+                reply(undefined, "probe not supported by this server");
+                return;
+            }
+            switch (o.op) {
+                case "probeStream": {
+                    // cat 缺省=全部；"*" 同义（subscribe 域）；"off" 退订（139 仪表盘
+                    // 关页即停流——单过滤槽无独立 unsubscribe，语义走换槽）；其余串拒。
+                    if (o.cat !== undefined && o.cat !== "*" && o.cat !== "off" && (typeof o.cat !== "string" || !isCat(o.cat))) {
+                        reply(undefined, `probeStream cat must be one of ${PROBE_CATS.join("|")}|*|off when present`);
+                        return;
+                    }
+                    if (o.cat === "off") {
+                        filter = null;
+                        reply(true);
+                        return;
+                    }
+                    const cat = typeof o.cat === "string" && o.cat !== "*" ? o.cat : undefined;
+                    filter = { cat };
+                    reply(true);
+                    return;
+                }
+                case "probeEnable": {
+                    // 139（用户令：默认仪表盘实时采集探针）：运行时翻转探针总闸——
+                    // probeEnabled() 逐调用读环境（probe.ts §3），翻 process.env 即全
+                    // 部挂载点即时生效。loop 挂载（agent.* 与 tool.*）按 run 重裹，下一
+                    // run 起可见；model.call 的包装在 provider 工厂构造时一次成形，
+                    // 运行时开闸对它不追溯（回执字段说明，前端照实提示）。
+                    if (typeof o.on !== "boolean") {
+                        reply(undefined, "probeEnable on must be a boolean");
+                        return;
+                    }
+                    if (o.on)
+                        process.env.WUDAO_PROBE = "on";
+                    else
+                        delete process.env.WUDAO_PROBE;
+                    reply({ enabled: o.on, modelCallNeedsRestart: true });
+                    return;
+                }
+                case "probeRecent": {
+                    if (o.cat !== undefined && o.cat !== "*" && (typeof o.cat !== "string" || !isCat(o.cat))) {
+                        reply(undefined, `probeRecent cat must be one of ${PROBE_CATS.join("|")}|* when present`);
+                        return;
+                    }
+                    if (o.limit !== undefined &&
+                        (typeof o.limit !== "number" || !Number.isInteger(o.limit) || o.limit < 1 || o.limit > PROBE_RECENT_LIMIT_CAP)) {
+                        reply(undefined, `probeRecent limit must be an integer 1..${PROBE_RECENT_LIMIT_CAP} when present`);
+                        return;
+                    }
+                    const cat = typeof o.cat === "string" && o.cat !== "*" ? o.cat : undefined;
+                    reply(bus.recent(cat, typeof o.limit === "number" ? o.limit : undefined));
+                    return;
+                }
+                case "probeStats":
+                    reply(bus.stats());
+                    return;
+                default:
+                    reply(undefined, `unknown op: ${String(o.op)}`);
+            }
+        },
+        close: () => unsubscribe?.(),
+    };
+}
+//# sourceMappingURL=probe.js.map

package/dist/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../src/probe.ts"],"names":[],"mappings":"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"}