super-dsh 0.1.9 → 0.1.10-e

package/agent-codex-sdk/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@pgmi-builds/agent-codex-sdk",
+  "version": "0.1.0",
+  "description": "Codex (SDK) provider for DeepSeek Harness (dsh) — the OPT-IN in-process SDK transport for the Codex agent: it embeds Codex threads in this Node process instead of driving a `codex app-server` child (that is @pgmi-builds/agent-codex, the PRIMARY path, because it reuses the operator's own codex binary). Delivered DISABLED by default (world key `codex-sdk`, roster label \"Codex (SDK)\"); turning the composite row on IS the switch. This package declares NO SDK dependency — not a dependency, not an optionalDependency and not a peer — and ships NO postinstall: the durable SDK tree (the codex SDK package plus the pinned codex binary package) is fetched into the world home on the first real prompt (src/sdk-runtime.ts, `npm run fetch-sdk-runtime`).",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./world": "./dist/world-plugin.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --test test/*.test.mjs",
+    "fetch-sdk-runtime": "node scripts/fetch-sdk-runtime.mjs"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-agent": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-agent-presets": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-scope": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-session": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-session-persistence": ">=0.1.5-0 <0.3.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.1.5-0 <0.3.0-0",
+    "@pgmi-builds/superd-hub": "*"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-presets": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-scope": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session-persistence": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-typert-protocol": {
+      "optional": true
+    },
+    "@pgmi-builds/superd-hub": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "typescript": "^5.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "main": "dist/index.js",
+  "engines": {
+    "node": ">=22.18"
+  }
+}

package/agent-codex-sdk/scripts/fetch-sdk-runtime.mjs

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+/**
+ * fetch-sdk-runtime.mjs — eagerly warm the durable SDK runtime for a world home.
+ *
+ * The adapter fetches this runtime lazily on the first real prompt
+ * (src/sdk-runtime.ts); this script exists for the two cases where waiting for
+ * a first turn is unacceptable: pre-provisioning a machine, and recovering from
+ * a recorded failure (`<worldHome>/sdk-runtime.error.log`).
+ *
+ *   node scripts/fetch-sdk-runtime.mjs [<home>]
+ *
+ * `<home>` is the DSH/SUPERD home (default: `$DSH_HOME`, then
+ * `$SUPERD_HOME_DIR`); the world home is `<home>/agents/codex-sdk`, exactly
+ * what the world plugin provisions (world key `codex-sdk`). There is
+ * deliberately NO default to `~/.dsh`: this is a dev/test tool and it refuses
+ * any home outside this repository's `.tests` tree — the same red line the
+ * launcher enforces (repo AGENTS §〇).
+ *
+ * Idempotent: a complete, matching runtime short-circuits (no network, no npm).
+ */
+import { dirname, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createSdkRuntimeDeps, ensureSdkRuntime, sdkRuntimeLayout } from "../dist/sdk-runtime.js";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const pluginDir = resolve(here, "..");
+const repoRoot = resolve(pluginDir, "..", "..");
+const testsRoot = resolve(repoRoot, ".tests");
+
+const home = process.argv[2] ?? process.env.DSH_HOME ?? process.env.SUPERD_HOME_DIR;
+if (home === undefined || home === "") {
+  console.error(
+    "refusing: pass a DSH home as argv[2] or set DSH_HOME / SUPERD_HOME_DIR " +
+      "(no default — ~/.dsh is a prod home)",
+  );
+  process.exit(2);
+}
+const dshHome = resolve(home);
+if (dshHome !== testsRoot && !dshHome.startsWith(testsRoot + sep)) {
+  console.error(`refusing: DSH home ${dshHome} is outside ${testsRoot} (repo red line)`);
+  process.exit(1);
+}
+const worldHome = resolve(dshHome, "agents", "codex-sdk");
+
+try {
+  // ONE implementation shared with the adapter's first-prompt fetch: the
+  // builder lives in the module, so this script cannot drift from it.
+  const record = await ensureSdkRuntime(worldHome, createSdkRuntimeDeps(pluginDir));
+  console.log(JSON.stringify(record, null, 2));
+  if (process.env.VERBOSE === "1") {
+    console.log(`layout: ${JSON.stringify(sdkRuntimeLayout(worldHome), null, 2)}`);
+  }
+} catch (error) {
+  // ensureSdkRuntime already wrote the durable trace; add the operator-facing line.
+  console.error(String(error instanceof Error ? error.message : error));
+  process.exit(1);
+}

package/agent-omp/README.md

@@ -1,77 +1,94 @@
-# @pgmi-builds/agent-omp（OMP adapter，SDK 线）
+# @pgmi-builds/agent-omp（OMP adapter，RPC 线）
 
-OMP Web 的 SDK 线：**衔接层（DSH 契约/术语/类形状）沿用 `apps/omp-web` 现行源码，内核从 `omp --mode rpc` 子进程换成 `@oh-my-pi/pi-coding-agent` SDK**。数据面目标 = `docs/plans/sdk-data-surface-assessment.md` 的 A1–A8 / S1–S10。
+OMP provider for DeepSeek Harness（[dsh](https://www.npmjs.com/package/@deepseek-ai/dsh)）。
 
-## 集成形态（承 sdk-direction §3 裁决 (a)）
+**不内嵌任何 OMP 代码副本**：适配器用操作员本机已在用的 `omp` binary，以 `omp --mode rpc` 子进程形态驱动，
+stdio 上跑 OMP 的 NDJSON 协议（v1），把 OMP 的 RPC 面（prompt / follow_up / steer / abort / get_state /
+get_messages / set_model / resume / compact）桥接进 Dash 的 Agent/Session 契约，标准 DSH Web UI 即可驱动 OMP 会话。
+模型选择由 OMP 数据面的 `LlmAdapter` 承接（`config.yml` 的 `modelRoles`）。
+
+## 集成形态
 
 ```
-dsh 宿主 (Node 22, 本包 dist/)            Bun sidecar (本包 sidecar/)
-  omp-web 衔接层（agent/adapter/      ←→     createAgentSession / ModelRegistry /
-  replay/store/supervisor 移植）            Settings / SessionManager / discover*
+dsh 宿主 (Node 22, 本包 dist/)               操作员本机的 omp binary
+  omp-web 衔接层（agent/adapter/       ←→     `omp --mode rpc`（NDJSON v1 over stdio）
+  replay/store/supervisor）                    ~/.omp 是其唯一的 app home
 ```
 
-- dsh 进程树保持纯 Node；SDK 只活在 sidecar 进程（bun run）。
-- 协议不再是 omp 的 rpc 面，而是**自有 sidecar 协议**：在数据流等价（prompt/steer/followUp/abort/事件流）之上，新增 app 层命令（settings 读写、auth/provider 状态、模型注册表、session list/open/fork、system prompt、custom message / messages 手术、compact）——即把 A/S 清单映射成方法表。
+- **没有 sidecar，没有 Bun，没有 SDK 依赖**：一会话一 `omp --mode rpc` 子进程，进程生命周期跟随会话。
+- **binary 解析**（`src/rpc-client.ts` 的 `resolveOmpExecutable()`）：
+  `$OMP_EXECUTABLE` → `PATH` 上的 `omp` → `~/.local/bin/omp` / `/usr/local/bin/omp` → 裸 `"omp"`（让 spawn 报 ENOENT）。
+- **进程组隔离**：子进程 `detached` 自成进程组，teardown 走 SIGTERM + 2s 宽限后 SIGKILL，保证 `omp` 及其工具子进程不残留。
+
+## 安装与启用
 
-## Spike 实测记录（2026-09-09，SDK 18.1.14 + bun 1.4.2）
+本包是 `super-dsh` 单一交付包内的兄弟目录，**不单独安装**（`dsh plugin --profile <name> add super-dsh`），
+也不需要预装任何 OMP SDK。唯一的外部前置条件 = **操作员机器上有 `omp`**：
 
-- 安装：`npm i @oh-my-pi/pi-coding-agent`（main 直指 `./src/index.ts`，无需构建步骤）+ devDep `bun`（node_modules 内二进制，不装全局）。
-- 根 exports 619 个。桥关心的全部在位：`createAgentSession` `AgentSession` `SessionManager(.create/.open/.continueRecent/.inMemory/.list/.listAll/.forkFrom)` `Settings(.init/.isolated/.loadReadOnly)` `ModelRegistry` `AuthStorage` `discoverAuthStorage` `AgentRegistry` `createSessionManager` `listSessions` `listAllSessions` `loadSessionMessagesReadOnly` `discoverSkills/SlashCommands/Extensions/ContextFiles/PromptTemplates` `buildSystemPrompt` `createCustomMessage` `wrapSteeringForModel` `expandPromptTemplate`。
-- **pi 文档 vs omp 实现**：`createAgentSessionRuntime`/`ModelRuntime`/`DefaultResourceLoader`/`SettingsManager`/`defineTool`/`createEventBus` 不在 omp 根 exports——对应能力由 `AgentSession` 实例面与 `Settings`/`discover*` 家族承担。评估文档中标 [pi] 的条目按此折算。
-- **`AgentSession` 实例面远超 pi 文档**：`state{systemPrompt,model,thinkingLevel,tools,messages,isStreaming,streamMessage,pendingToolCalls,error}`、`messages`、`systemPrompt`、`prompt`/`promptCustomMessage`/`sendCustomMessage`/`sendUserMessage`、`steer`/`followUp`、`setModel`/`cycleModel`/`applyRoleModel`、`compact`/`abortCompaction`、`switchSession`/`branch`/`navigateTree`/`fork`/`handoff`、`newSession`/`moveSession`、`abort`、`beginDispose`/`dispose`。S1/S2/S3/S6/S7/S8/S10 均有一等 API；S5（messages 手术）通道结构性在位（`state` 暴露 messages/tools 键），赋值语义待 TS 类型面确认。
-- **真机冒烟**：`OMP_HOME=~/.omp` 下 `discoverAuthStorage`+`ModelRegistry.refresh()` 得 50 模型 / 5 provider（deepseek,xai,bailian,kimi-plan,zai-plan）——与 `omp models --json` 完全一致；`SessionManager.inMemory()` 建会话成功、dispose 干净、零 LLM 调用。
-- **沙箱注意**：SDK 以读写模式打开 `~/.omp/agent/agent.db`；agent 沙箱内跑 sidecar/spike 需要对该库的写权限（本轮以 danger-full-access 实测通过）。
+- 缺失时不静默回落：adapter 在 `apply()` 做一次二进制可解析性探测并打显式诊断，首轮 prompt 以 spawn 错误 fail loud 冒到会话。
+- 启用由包内 `cordis.patch.yml` 承担（挂 OMP provider + 禁用原生 agent-loop / llm 路由），profile 无需手改。
 
-## 下一步（M2 → M3 收敛）
+## Home 布局（两个 home，别混）
 
-1. sidecar 骨架：bun 入口 + 方法表协议（JSON lines over stdio）+ 生命周期（spawn/健康检查/退出）。
-2. 移植衔接层：从 `apps/omp-web/src` 拷 `agent.ts`/`adapter.ts`/`replay.ts`/`session-persistence-omp.ts`/`store/`，把 `rpc.ts` 调用点逐个改打 sidecar 协议；`omp-cli.ts` 的 models/config 面改走 SDK（A1/A3）。
-3. S5 spike：`state.messages` 注入 toolResult + 真 turn 验证 journal 落盘。
-4. 会话所有权对齐：SDK 写 OMP session store 后与 bridge-store/supervisor/TUI 的三方避让（dev_0.0.3 §9 过一遍）。
+| 名字 | 是什么 | 定义（`src/knobs.ts`） | 默认 |
+|---|---|---|---|
+| **`OMP_HOME`** | OMP runtime app home（`agent.db`/`models.db`/`sessions/` 的写入目标，也是数据面子进程的 cwd） | `$OMP_HOME ?? resolveOmpNativeHome()` | **原生 `~/.omp`**（`$OMP_HOME` 只作测试 / 适配器级隔离 knob） |
+| **`OMP_NATIVE_HOME`** | 操作员的原生 OMP 安装（TUI/CLI）读面：`agent/config.yml`、`agent/models.yml`、原生 session store | `$OMP_NATIVE_HOME ?? join(homedir(), ".omp")` | `~/.omp` |
+| `<DSH_HOME>/agents/omp/` | 该 world 的 **DSH** home（DSH 会话日志、storages、settings） | dsh 宿主解析 | 非 app home |
 
-## As-built：sidecar 骨架（2026-09-09，已完成 ✅）
+- spawn **零重定向**：不把 `OMP_HOME` 喂给子进程；`~/.omp` 是唯一 OMP app home。
+- 绝不要把 `OMP_NATIVE_HOME` 指到空目录 / 测试 home——它是 models.yml 的读取来源，读空 ⇒ 适配器零 provider ⇒ `session/prompt` 报 `model-unavailable`。
 
-- `sidecar/main.ts`（bun 入口）：ready 握手 + JSON-lines 请求/响应/事件三帧协议；app 级共享单例 `authStorage`/`modelRegistry`；session 池（create/dispose/事件转发）。
-- `src/protocol.ts`：协议与方法表类型（sys.ping / models.list / settings.get / session.create|info|prompt|steer|followUp|abort|dispose / sessions.list）。
-- `src/sidecar-client.ts`：Node 侧 spawn/关联/事件分发/优雅关停；`src/index.ts` 暂导出 client。
-- ~~冒烟 `test/sidecar-smoke.test.mjs`~~（2026-09-24 场景退役删除；整包验证走 superd 的 4999 pack 线 + dev3）。
-- 坑已修：`ModelRegistry.refreshInBackground()` 此版本返回 void（非 Promise），可选链后接 `.catch` 会炸；ready-timeout 定时器必须 clear 否则 Node 进程挂 60s。
+## 数据面（`omp` 子进程）
 
-## As-built：衔接层移植（2026-09-09，已完成 ✅）
+`src/omp-cli.ts` 把操作员 binary 作为模型目录与 `modelRoles` 的**第一源**（不吃 RPC 帧）；原生 `~/.omp` 的文件只作失败回落与排序读面：
 
-- `src/rpc-types.ts`：从 omp-web `rpc.ts` 提取的 OMP wire 类型（verbatim），两条线共用同一载荷形状。
-- `src/sdk-client.ts`：**`OmpSdkClient`——与 `OmpRpcClient` 同公共面**（on/onFailure/sendRaw/send/getState/getMessages/getSessionStats/getSubagents/prompt/followUp/steer/setModel/abort/newSession/close），底层复用单个共享 sidecar（模块级单例 + 引用计数，refcount 归零自动关停）。spawn args 解析 `--approval-mode`（yolo→autoApprove）与 `--resume`；未知 flag fail-loud。
-- 衔接层整体移植（与 omp-web 逐字节同源，仅换接缝）：`agent.ts` `adapter.ts` `index.ts` `models.ts` `knobs.ts` `pairing.ts` `permission.ts` `replay.ts` `session-persistence-omp.ts` `supervisor.ts` `omp-store.ts` `agent-preset-omp.ts` `omp-cli.ts` `store/`。
-- sidecar 升级：session handle 化（`newSession` 换 OMP session id 但 handle 稳定）；补齐 `session.state/messages/stats/subagents/setModel/new`；`getSessionStats` 实测返回 contextUsage（contextWindow 1000000）。
-- 测试：omp-web 单测四件（content-detection/omp-store/replay/store）+ sidecar 冒烟 + sdk-client 集成 = **20/20 绿，3.6s**；tsc 0 错。
-- 本地 dev fixture：`node_modules/@deepseek-ai/*` symlink 至真实 dsh 安装（照 omp-web 惯例，node_modules 不入库）。
+- `omp models --json` → 凭证解析后的可用模型目录（含 agent.db 里的 OAuth/login key 等配置面看不见的凭证）；子进程失败才回落磁盘 `models.db` ∪ `models.yml`（并打 stderr 提示）。
+- `omp config get modelRoles --json` → role → `"provider/model[:effort]"` 映射（含持久化的 `default` 选择），每次现读。
+- `omp config set modelRoles --json <obj>` → 整对象回写（拒绝点号 key），OMP 自己持久化 `modelRoles.default`。
+- provider 排序与 boot 期默认模型仍首选 `agent/config.yml` 磁盘读（`omp-store.ts` 的 mini-YAML 扫描），`ompModelRolesSync` 兜底。
+- 每次调用都按 `resolveOmpExecutable()` 现解析、`cwd = OMP_HOME`；**fail-soft**：binary 缺失/损坏/无响应 → 读 `undefined`、写 `false`，provider 永因 CLI 挂掉而 boot 失败。
 
-### 已知差异（SDK 线 vs RPC 线，待办）
+## 实现要点
 
-- `extension_ui_response`（审批卡应答）在 SDK 线暂为 no-op：SDK 侧审批走 `autoApprove`/approval 事件，卡片化审批的等价通道待接。
-- `getSubagents` 暂返回 `[]`（SDK 的 subagent registry 暴露面待查）。
-- 未跑 4999 全链路（dsh 宿主内 provider 挂载）——下一步。
+- **传输**：`src/rpc-client.ts` 的 `OmpRpcClient` —— NDJSON 读取（按 `\n` 切帧）、`ready` 握手（默认 120s 上限，`OMP_READY_TIMEOUT_MS`）、
+  per-command 响应 deadline（默认 30s，`OMP_COMMAND_TIMEOUT_MS`）、`on`/`onTitle`/`onFailure` 事件分发。
+- **不协商协议**：不发 `negotiate_protocol`，停在 v1 = 纯 NDJSON（旧读取器即正确）。协商到 v2 会切换到 >1MiB 分帧，需要重组器——列为已知 gap。
+- **lazy 铁律**：`src/lazy-rpc.ts` 的 `LazyOmpRpc` 是唯一 spawn 点，构造零 spawn；`prompt`/`followUp`/`steer`/`ensureStarted` 才拉起子进程，
+  被动查询（`getState`/`getSubagents`/`getSessionStats`/`getSystemPrompt`/`abort`/`sendRaw`）合成应答、绝不 spawn。
+  `createAgent` 与 `resume` 两条路径都走它（resume 有映射时加 `--resume <ompFile>`），生成参数 `--approval-mode <mode>`。
+- **两平面**：dsh 原生 session log 是 WebUI 唯一读面（插件当 producer：OMP RPC 事件 → SessionEvent → `ctx.sessionPersistence`）；
+  OMP 原生会话文件是 runtime 权威（插件当 bridge：`bridge-store.sqlite` 只存 dsh↔omp 映射）。双份存储显式接受，单向阀 = 不回读。
+- **已删除面**（本 RPC 轮，2026-10-03）：`src/sdk-client.ts`、`src/sidecar-client.ts`、`src/protocol.ts`、`sidecar/`，以及 SDK/Bun 依赖与 `test/sidecar-*.test.mjs`；`scripts/build-client.ts` 与 `src/client/`、`src/mobile/` 保留（client 半边与 sidecar 无关）。
 
-## As-built：4999 全链路冒烟（2026-09-09，PASS ✅）
+## 协议与实测记录（2026-10-03）
 
-- test profile `omp-web-test` 切换 dep 至 `link:…/apps/omp-web`（bundle 位同步换 `@pgmi-builds/omp-web`，patch 语义同 omp-web：mount omp-provider + 禁 agent-loop/llm 路由/agent-presets）。
-- systemd-run `omp-web-4999-test`（DSH_HOME=~/.omp/omp-web、OMP_HOME=~/.omp、port 4999）拉起全局 dsh 0.1.3-alpha.2，unit active。
-- 验证链：auth 200 → `session/create` ok → **dsh 进程树内 1 个共享 bun sidecar** → `session/prompt`（mode:queue + requestId，typert request 形状）accepted → `session/page`（`records[].event`，`throughSeq ≤ cursor`）回读：turn/start、user/message、2×step（reasoning + `think` 工具调用 + tool/result）、assistant/message（text "sdk-line-alive"，xai/grok-4.6，含 stream chunks）、turn/end。
-- wire 备忘：`session/prompt` 必填 `requestId`/`mode`/`content`；`session/page` 用 `args.request`（非 `_request`），`address:{kind:"session",sessionId}` + `throughSeq` 超 cursor 直接报错并回吐当前 cursor。
+`ready` 帧实测：
+
+```json
+{"type":"ready","protocolVersion":1,"supportedProtocolVersions":[1,2],
+ "maxFrameBytes":1048576,"maxReassembledFrameBytes":67108864}
+```
 
-## As-built：四阶段增强（2026-09-09，全部 doer(v4-pro)+verify 双签 PASS ✅）
+- 只要求 `type === "ready"`；`protocolVersion` / `supportedProtocolVersions` / `maxFrameBytes` / `maxReassembledFrameBytes` 记录不校验。
+- 不协商的路径实测停在 v1；`get_state` / `get_available_models` 未协商也照常应答；事件词表
+  （`agent_start` / `turn_start` / `message_start` / `message_update` / `message_end` / `tool_execution_start` / `tool_execution_end` / `turn_end` / `agent_end`）与 `agent.ts` 的 switch 对齐。
+- 已知 gap：v2 分帧未实现（单帧 >1MiB 靠大行承载）；对 `omp` 版本门仅实测 v18.4.9。
+
+## 测试
+
+```bash
+npm run build                  # tsc -p tsconfig.json && tsc -p tsconfig.client.json
+node --test test/*.test.mjs    # 全 fakes / 源级断言，零真 runtime、零真 omp spawn
+```
 
-- **P1 `7e44412`** preset 槽位：桥自供 `agentPresets` typert remote（服务 key==wire namespace==ctx.remote.agentPresets），roster 恰一条 `omp`/`OMP`/isDefault；copy/delete 报 `agent-preset/read-only`，未知 id 报 `not-found`。关键：注册必须挂顶层 fiber（嵌套 ctx.plugin 会 404）。4999 wire 实测单条 OMP 行。
-- **P2 `fee6406`** system prompt → UI：`request/header.data.header.system`（EpochHeader.system）即 UI System-prompt 行的数据源。sidecar 加 `session.systemPrompt`（live，refreshBaseSystemPrompt 后 38807 字符）与 `session.systemPrompt.forFile`（冷会话 throwaway 渲染，dispose 前 releaseRetainedEntries 抑制 session_exit 落盘，实测只读）。replay/cold-shadow/open 注入；live turn 不合成 header（无 per-turn 成本）。已知 gap：live 会话要到 replay 路径才显示 System prompt 行。
-- **P3 `8e9f21d`** settings/models 切 sidecar：`settings.modelRoles.get/set`（set 带 flush→loadReadOnly→deepEquals 读回校验，shadow-key 只在真实落盘后推进；echo roundtrip 实测 config.yml SHA 不变）+ 富化 `models.list`（12 键与 normalizeModel 逐一对照）。omp-cli 四导出改缓存+异步暖缓存语义，Sync 变体冷启动 undefined→on-disk 回退。4999 实测 modelCatalog 5 provider 全量。
-- **P3.1 `e4db900`** EPIPE 加固（verify 发现的历史崩溃）：child stdin 永久 no-op error sink + `#writeSafe` per-write 降级——sidecar 死亡从崩宿主变为拒绝当次调用。
-- **P4 `97cbc7b`** JSONL 解析切 SDK：`sessions.listAll` 一次全库索引（147 会话 26ms；id/cwd/size 0 diff，20 处 title 差异经实证为 SDK 当前 title slot 更正确）+ `sessions.messagesReadOnly` 按需 transcript（compaction 折叠语义）；自研解析保留为 fail-soft fallback；顺带修了 `sessions.list {all:true}` 恒 0 的旧 bug。supervisor 热路径保留 naive 防游标错位。
-- 总验收：29/29 测试、4999 wire 三连（roster 单条 OMP / session list 147 / modelCatalog）、实例留 4999 供手动验收。
-- 遗留（低）：forFile 对个别大文件 "Agent Main was replaced"（~1/tick，fail-soft）；SDK 元数据快照滞后一个 tick；`sessions.messagesReadOnly` 大文件双读。
+- `test/no-sidecar.test.mjs` = RPC 轮的删除面 + tick 门双重把守（源级断言：`src/` 不得再出现 SDK/sidecar client；
+  `index.ts` 只能 `new LazyOmpRpc(`；tick 的目录刷新必须挂在 `liveOmpSessionExists` 上，并对编译后的 `dist/index.js` 跑行为真值表）。
+- `rpc-client` / `lazy-rpc` / `omp-cli-rpc` / `resolve-executable` / `package-contract` 覆盖传输、lazy 不变量、数据面与交付清单。
+- **场景级验证只走整包**：`super-dsh` 的 4999 pack 线（`test/start-4999.sh`）+ dev3 目标机实装；本目录不再有 per-agent 场景 rig。
 
-## As-built：P1.1 修复 + P5 mobile 包（2026-09-09）
+## 历史
 
-- **P1.1 `434f046`**（"no omp mode" 根因修复）：P1 的 roster 服务 200 但 chip 仍不显示——UI 的 preset chip 门控在 `session.projectionValues.agentPreset` 上，该投影原本由（被我们禁用的）dsh-agent-presets 宿主半驱动。桥现在自己注册同一 fold（`ctx.inject(['sessionProjections'])` + `agent-preset/selected` 事件推进），headless 截图确认 hero 行渲染 `OMP ˅` chip。配套 vendored `dsh-session-projection` 类型（父 repo）。
-- **P5 `29b043b`**（dashr mobile 包移植，本插件首个 client 半）：`src/mobile/`（gesture/zoom-guard/client）+ `src/client/index.ts` 入口 + `scripts/build-client.ts`（tsdown 闭包工厂 → `lib/client/index.js`，id=包名）+ host 半 `src/mobile-boot.ts`（`window.__OMP_WEB_MOBILE__` + iOS zoom-guard 经 webserver/index-inject）。`dsh.client` manifest inject 只挂 ui-layout。测试 41/41。
-- **P5 视觉验证**（5199 实测，4999 当时被 superd 的 ui-preact 实例占用）：桌面回归 OK（OMP chip 在）；390x844 断点折叠（rail→0px、无横向滚动）；全局注入 OK；边缘滑动手势开关侧栏实测通过；截图证据 `.scratch/p5-verify/`。
-- 遗留：移动端侧栏为 push-drawer 语义（打开时内容窗格被压窄，与 dashr 原行为一致）；`npm install` 会剪掉 `node_modules/@deepseek-ai` symlink（需重挂）；4999 端口与 superd 测试线冲突时用 `--patch` overlay 换端口。
+本包在 2026-10-03 前是内嵌 SDK + Bun 子进程（sidecar）线（SDK 事件 → SessionEvent，单进程多路复用）；该线连同
+762M SDK 树 + 76M bun 二进制一起从交付面删除，改用操作员本机 binary 的 RPC 传输（设计正本：
+`docs/specs/omp-rpc-transport/spec.md`）。

package/agent-omp/dist/agent.js

@@ -2,6 +2,7 @@ import { agentEvents } from "@deepseek-ai/dsh-agent";
 import { Inbox } from "./inbox.js";
 import { LlmAttemptId, ToolCallId, QUOTA_EXCEEDED_CODE, createAssistantMessage, createSystemMessage, createToolResultMessage, createUserMessage } from "@deepseek-ai/dsh-llm";
 import { createScope } from "@deepseek-ai/dsh-scope";
+import { ompPermissionCommand } from "./permission.js";
 import { getBridgeStore } from "./store/index.js";
 import { withSystemHead } from "../../superd-hub/dist/index.js";
 /**
@@ -312,20 +313,20 @@ export class OmpAgent {
         // so a freshly created session announces completely blank, exactly like
         // the native agent-loop factory's: the backend takes zero part in the
         // UI's browser-local new-session draft.
-        // `/permission` cannot work here: OMP pins `--approval-mode` at launch and
-        // no RPC changes it mid-session. Registering the SAME name on this agent's
-        // own scope (a command-injected child of `agent.ctx`) SHADOWS the global
-        // permission command for this agent only — the switch then fails cleanly
-        // instead of appending approval/policy events OMP cannot honor. (The
-        // `inject` narration drop below stays as the backstop.)
+        // `/permission` — a launch fact, so the shadow routes it by child state:
+        // OMP pins `--approval-mode` at spawn and no RPC moves it mid-session, so
+        // an accepted switch only exists while this session's child does NOT. This
+        // agent-scoped registration (a child of `agent.ctx`) shadows the global
+        // command; before the first prompt it writes the same durable preset the
+        // global handler would (`permissionPresets.set`, no live-agent narration),
+        // and afterwards it refuses instead of appending a preset the running
+        // `omp` cannot honor. The spawn reads exactly those events
+        // (`resolveSpawnPermission`), so the pick reaches the child's argv.
         this.ctx.inject(["commands"], (cmdCtx) => cmdCtx.commands.register({
             name: "permission",
-            description: "Unavailable for OMP sessions (approval policy is fixed at OMP launch)",
+            description: "Switch the permission preset (takes effect at the OMP child's launch)",
             input: { hint: "<preset>" },
-            handler: () => ({
-                kind: "error",
-                text: "Approval policy is fixed at OMP launch; runtime switching is not supported for OMP sessions.",
-            }),
+            handler: (invocation) => this.#handlePermissionCommand(invocation.rawInput),
         }));
         // `/compact` parity (route 1): OMP owns context compaction — the Dash log
         // is only the UI's scrollback projection, so no compaction/* events are
@@ -522,6 +523,30 @@ export class OmpAgent {
             }
         }
     }
+    /**
+     * `/permission` handler: mirror the global command's write for a session whose
+     * `omp` child does not exist yet (the pick then lands in the launch flag via
+     * {@link resolveSpawnPermission}), and refuse it once the child does — the
+     * policy is a launch flag, so accepting later would desync UI from runtime.
+     * Uses `permissionPresets.set` (log-only preset + knob events) rather than the
+     * global handler's `approval.setPolicy`, which would inject a narration user
+     * message into the OMP session for a change OMP never sees.
+     */
+    #handlePermissionCommand(rawInput) {
+        const presets = this.#loopCtx.get("permissionPresets");
+        if (presets === undefined) {
+            return { kind: "error", text: "permission presets are not available on this host" };
+        }
+        const decision = ompPermissionCommand({
+            rawInput,
+            spawned: this.#rpc.spawned,
+            names: presets.names,
+            current: presets.current(this.session),
+        });
+        if (decision.action === "apply")
+            presets.set(this.session, decision.preset);
+        return decision.result;
+    }
     /**
      * /compact handler (route 1): run OMP's own compaction on the live child
      * and report its real metering as the command outcome. No compaction/*