@dsh-edge/dsh-edge-agent 0.0.0-stage → 0.1.1

package/lib/dsh-adapter/desktop-cookie-janitor.js

@@ -0,0 +1,409 @@
+/**
+ * desktop-cookie-janitor — §7.145 桌面版「起不来」的根因修复。
+ *
+ * ## 现象（主人现场，2026-10-28）
+ *
+ * 桌面版反复起不来，报 "DeepSeek Harness is unavailable"。审计链里能看到
+ * **18 次「插件加载完 0.1 秒就死」的启动**（每次只有 8 条事件：
+ * config.loaded → policy.loaded → boot.probe → 4 条 hook 注册，然后戛然而止）。
+ *
+ * ## 根因
+ *
+ * 桌面版每次启动都用**随机端口**起 web 服务
+ * （apps/desktop-host/src/index.ts: `args: ['--no-open','--host','127.0.0.1','--port','0']`），
+ * 宿主据此签发浏览器会话 cookie：
+ *
+ *   cookie 名 = "dsh-auth-" + base64url(sha256(authority))   // authority = "127.0.0.1:<port>"
+ *
+ * **端口进了 cookie 名** ⇒ 每次启动都是一条**新名字**的 cookie ⇒ 上一轮的 cookie
+ * 既不会被命中、也不会因为端口复用而覆盖 ⇒ Chromium 的 cookie jar 无限增长。
+ *
+ * Chromium 把**同一 host 的全部 cookie** 塞进 Cookie 头（cookie 不按端口隔离，
+ * 只有名字里带了端口）⇒ Electron 外壳的 welcome 握手
+ * （app.asar/lib/main.js:8885 `net.fetch(url, {credentials:'include'})`）带着
+ * 一大堆 cookie 出发 ⇒ 宿主 web 服务是裸 `createServer(listener)`
+ * （@deepseek-ai/dsh-host-webserver/lib/index.js:566，未设 maxHeaderSize）
+ * ⇒ Node 默认 16384 B 头上限 ⇒ **431 Request Header Fields Too Large**
+ * ⇒ 外壳判定 `!authenticated.ok` ⇒ 拆掉宿主 ⇒ 「unavailable」。
+ *
+ * 实测：71 条 cookie = 16.2 KB（每条 227 B）⇒ 约 69 次启动就撞线。
+ *
+ * ## 为什么是本插件来修
+ *
+ * 实测时间线（2026-10-29 01:08:23 一次真实启动）：
+ *
+ *   01:08:23.030  我们的插件加载（config.loaded）
+ *   01:08:25.979  Electron 锁住 cookie 库（welcome 握手触发网络服务）
+ *
+ * ⇒ 插件加载后有**约 3 秒的窗口**，cookie 库还没被锁 ⇒ 这时候可以把历次启动
+ * 留下的死端口 cookie 删掉。Electron 之后才打开这个库，读到的就是清理过的。
+ *
+ * 同时把宿主 web 服务的 `maxHeaderSize` 抬上去：即使清理没赶上（库已被锁），
+ * 一个已经攒胖的 jar 也不会再把启动打死 —— 两道防线，互不依赖。
+ *
+ * ## 只在桌面版生效
+ *
+ * 431 只发生在 Electron 外壳（只有它带 Chromium cookie jar）。headless profile
+ * （web / tui / dsh-edge-agent）由普通 Node 拉起，自己起 web 服务、客户端不带
+ * cookie jar ⇒ 同样场景不会发生。所以本插件用 `process.versions.electron`
+ * 判别运行环境，非桌面版一律跳过 —— 不去动无关 profile 里的宿主 web 服务。
+ *
+ * ## 不做什么
+ *
+ * - **不碰**非 `dsh-auth-*` 的 cookie（别的站点的）。
+ * - **不碰**当前活着端口的那条（= 本次会话的 cookie）。
+ * - **不删**认不出 audience 的行以外的东西；认不出的 auth cookie 视为残骸
+ *   （它多半来自旧版本/旧端口），但只在 `source_port` 也拿不到时才动它。
+ * - 任何一步失败都**静默降级**（返回一份报告，绝不抛）—— 观测/家���不能拖垮启动。
+ *
+ * @module dsh-edge-agent/desktop-cookie-janitor
+ */
+import Schema from '@deepseek-ai/schemastery';
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { createConnection } from 'node:net';
+export const name = 'desktop-cookie-janitor';
+/** 无硬依赖：web 服务用 `ctx.inject(['webServer'])` 延迟取（headless profile
+ *  未必有它），cookie 库也不依赖任何服务。 */
+export const inject = [];
+/** 宿主签发的浏览器会话 cookie 前缀（别的 cookie 一律不碰）。 */
+export const AUTH_COOKIE_PREFIX = 'dsh-auth-';
+/** Node http.Server 的默认请求头上限（bytes）。宿主 web 服务没设 maxHeaderSize，
+ *  所以这就是宿主实际生效的门槛。 */
+export const NODE_MAX_HEADER_SIZE = 16_384;
+/** 我们把上限抬到的值（bytes）。64 KB ≈ 280 条 cookie —— 远超 Chromium 的
+ *  每域 cookie 上限（180），所以清理一旦失效也不会顶到 Chromium 的淘汰线。 */
+export const DEFAULT_MAX_HEADER_BYTES = 65_536;
+/** Chromium 会话 cookie 之外的请求头估值（Host / UA / sec-ch-* / Accept-* …）。 */
+export const OTHER_HEADER_BYTES = 600;
+/** 单条 cookie 的实测字节：name 52 + value 173 + 2 个分隔符 ≈ 227。 */
+export const PER_COOKIE_BYTES = 227;
+/* ── 纯逻辑（可单测） ─────────────────────────────────────────────────────── */
+/**
+ * 从 cookie 里取出 audience（`host:port`）。
+ *
+ * 宿主签发的是 `v1.<base64url(json)>.<hmac>`，json 里带 authority；但 Chromium
+ * 在 Windows 上会用 DPAPI 加密 `value` 列 ⇒ 解析多半失败 ⇒ 退回
+ * `host_key` + `source_port`（Chromium 自己记的源端口，一直是对的）。
+ */
+export function authorityOf(cookie) {
+    const value = typeof cookie.value === 'string' ? cookie.value : '';
+    const parts = value.split('.');
+    if (parts.length >= 2 && /^v\d+$/.test(parts[0])) {
+        try {
+            const json = Buffer.from(parts[1], 'base64url').toString('utf8');
+            const payload = JSON.parse(json);
+            if (typeof payload.authority === 'string' && payload.authority.length > 0) {
+                return payload.authority;
+            }
+        }
+        catch {
+            /* 值被加密了 —— 落到下面的 source_port 兜底 */
+        }
+    }
+    if (cookie.source_port !== undefined && cookie.source_port !== null) {
+        return `${String(cookie.host_key)}:${String(cookie.source_port)}`;
+    }
+    return undefined;
+}
+/** 从 audience 里取端口。 */
+export function portOf(authority) {
+    if (typeof authority !== 'string')
+        return undefined;
+    const at = authority.lastIndexOf(':');
+    if (at < 0)
+        return undefined;
+    const port = Number(authority.slice(at + 1));
+    return Number.isInteger(port) && port > 0 && port <= 65535 ? port : undefined;
+}
+/**
+ * 请求头投影：Chromium 会把同一 host 的全部 cookie 塞进 Cookie 头。
+ *
+ * @param cookies - 参与发送的 cookie 行
+ */
+export function projectHeaderBytes(cookies) {
+    let bytes = OTHER_HEADER_BYTES;
+    for (const cookie of cookies) {
+        const name = String(cookie.name ?? '');
+        const value = String(cookie.value ?? '');
+        bytes += name.length + 1 + value.length + 1;
+    }
+    return bytes;
+}
+/** 还能撑几次启动（每次新增一条 cookie）。 */
+export function remainingLaunches(cookies) {
+    const used = projectHeaderBytes(cookies);
+    if (used >= NODE_MAX_HEADER_SIZE)
+        return 0;
+    return Math.floor((NODE_MAX_HEADER_SIZE - 1 - used) / PER_COOKIE_BYTES);
+}
+/**
+ * 把 auth cookie 分成「活的」与「死的」。
+ *
+ * @param cookies - 库里的全部行（函数自己只挑 `dsh-auth-*`）
+ * @param isAlive - (port) => Promise<boolean>，端口存活探针（可注入以便自证）
+ */
+export async function classifyCookies(cookies, isAlive) {
+    const auth = [];
+    const foreign = [];
+    for (const cookie of cookies) {
+        if (typeof cookie.name === 'string' && cookie.name.startsWith(AUTH_COOKIE_PREFIX))
+            auth.push(cookie);
+        else
+            foreign.push(cookie);
+    }
+    const stale = [];
+    const live = [];
+    for (const cookie of auth) {
+        const authority = authorityOf(cookie);
+        const port = portOf(authority);
+        if (port === undefined) {
+            // 认不出 audience：算残骸（多半来自旧版本/旧端口），宁可清掉。
+            stale.push({ cookie, authority, port, stale: true, reason: 'unparsable-audience' });
+            continue;
+        }
+        if (await isAlive(port))
+            live.push({ cookie, authority, port, stale: false, reason: 'live-port' });
+        else
+            stale.push({ cookie, authority, port, stale: true, reason: 'dead-port' });
+    }
+    return { auth, foreign, stale, live };
+}
+/**
+ * 抬高 web 服务的请求头上限。
+ *
+ * Node 在**每条连接**建立时把 `server.maxHeaderSize` 读进 parser ⇒ 在握手
+ * 之前改好即可生效。
+ *
+ * ⚠️ 实测坑：`http.createServer()` 建出来的 server 上，`maxHeaderSize` 是
+ * **undefined**（不是 16384！）—— Node 把默认值放在 parser 里。所以
+ * 「读到的不是数字 ⇒ 不是 http server」这个判据是错的，会让这道防线永远
+ * 抬不上。真正的判据是「它像不像一个 http server」（有 listen/close）。
+ *
+ * @returns 是否真的改了（false = 没接口 / 已经够大 / 被禁用 / 不是 server）
+ */
+export function applyHeaderBudget(server, bytes) {
+    if (typeof bytes !== 'number' || !Number.isFinite(bytes) || bytes <= 0)
+        return false;
+    if (server === null || typeof server !== 'object')
+        return false;
+    const target = server;
+    // 只动 http server —— 别的对象不该被塞一个 maxHeaderSize。
+    if (typeof target.listen !== 'function' || typeof target.close !== 'function')
+        return false;
+    const current = target.maxHeaderSize;
+    if (typeof current === 'number' && current >= bytes)
+        return false;
+    try {
+        target.maxHeaderSize = bytes;
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/* ── 环境探测 ───────────────────────────────────────────────────────────── */
+/** 桌面版 cookie 库的默认位置（各平台 Electron userData 目录）。 */
+export function defaultJarPath(env = process.env) {
+    if (process.platform === 'win32') {
+        const base = env.APPDATA ?? join(env.HOME ?? '', 'AppData', 'Roaming');
+        return join(base, '@deepseek-ai', 'dsh-desktop', 'Network', 'Cookies');
+    }
+    if (process.platform === 'darwin') {
+        return join(env.HOME ?? '', 'Library', 'Application Support', '@deepseek-ai', 'dsh-desktop', 'Network', 'Cookies');
+    }
+    return join(env.XDG_CONFIG_HOME ?? join(env.HOME ?? '', '.config'), '@deepseek-ai', 'dsh-desktop', 'Network', 'Cookies');
+}
+/** 端口上是否还有进程在监听（= 该 cookie 的宿主还活着）。 */
+export function probePort(port, host = '127.0.0.1', timeoutMs = 250) {
+    return new Promise((resolve) => {
+        const socket = createConnection({ host, port });
+        const done = (alive) => {
+            socket.destroy();
+            resolve(alive);
+        };
+        socket.setTimeout(timeoutMs);
+        socket.once('connect', () => done(true));
+        socket.once('timeout', () => done(false));
+        socket.once('error', () => done(false));
+    });
+}
+/**
+ * 载入 `node:sqlite`。
+ *
+ * 用 `createRequire` 而不是 `await import('node:sqlite')`：vite/vitest 的模块
+ * 解析器不认识 `node:sqlite`（会当成普通包去解析 ⇒ "Failed to load url
+ * sqlite"），`createRequire` 直接走 Node 的原生解析 ⇒ 单测跑的是**同一条**
+ * 真实路径，不是替身。
+ */
+function loadSqlite() {
+    const require = createRequire(import.meta.url);
+    return require('node:sqlite');
+}
+const READ_ROWS = `SELECT host_key, name, value, path,
+                          source_port,
+                          CAST(expires_utc AS TEXT) AS expires_utc
+                     FROM cookies`;
+function readRows(db) {
+    return db.prepare(READ_ROWS).all();
+}
+function deleteRows(db, victims) {
+    const stmt = db.prepare('DELETE FROM cookies WHERE host_key = ? AND name = ?');
+    let removed = 0;
+    for (const cookie of victims) {
+        removed += Number(stmt.run(cookie.host_key, cookie.name).changes ?? 0);
+    }
+    return removed;
+}
+/**
+ * 清一次 cookie 库。
+ *
+ * 全程不抛：库不存在 / 被 Electron 锁着 / 没有 node:sqlite —— 都只写进报告。
+ */
+export async function cleanCookieJar(jarPath, isAlive) {
+    const report = {
+        jar: jarPath,
+        opened: false,
+        authCount: 0,
+        removed: 0,
+        projectedBytes: 0,
+        launchesLeft: 0,
+    };
+    try {
+        if (!existsSync(jarPath)) {
+            report.error = 'jar-missing';
+            return report;
+        }
+        const { DatabaseSync } = loadSqlite();
+        const db = new DatabaseSync(jarPath);
+        try {
+            const rows = readRows(db);
+            // 「库可用」= 真读到了 cookie 表（SQLite 构造是惰性的：文件损坏时构造
+            // 成功、第一次读表头才炸）。所以 opened 在读完行之后才置位。
+            report.opened = true;
+            const alive = isAlive ?? ((port) => probePort(port));
+            const groups = await classifyCookies(rows, alive);
+            report.authCount = groups.auth.length;
+            if (groups.stale.length > 0) {
+                report.removed = deleteRows(db, groups.stale.map((g) => g.cookie));
+            }
+            const after = readRows(db);
+            const survivors = after.filter((c) => typeof c.name === 'string' && c.name.startsWith(AUTH_COOKIE_PREFIX));
+            report.projectedBytes = projectHeaderBytes(survivors);
+            report.launchesLeft = remainingLaunches(survivors);
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch (error) {
+        report.error = error instanceof Error ? error.message : String(error);
+    }
+    return report;
+}
+export const Config = Schema.object({
+    enabled: Schema.boolean().default(true),
+    maxHeaderBytes: Schema.natural().default(DEFAULT_MAX_HEADER_BYTES),
+    jarPath: Schema.string().default(''),
+});
+/** 宿主 web 服务（@deepseek-ai/dsh-host-webserver）注入的服务名。 */
+export const WEB_SERVER_SERVICE = 'webServer';
+/**
+ * 是不是跑在 Electron 里（= 桌面版）。
+ *
+ * 桌面版的宿主进程是 Electron 以 `ELECTRON_RUN_AS_NODE=1` 拉起来的
+ * （apps/desktop-host/src/index.ts 的 packageManager），所以宿主进程里
+ * `process.versions.electron` 有值（实测 44.7.0）。headless profile
+ * （web / tui / dsh-edge-agent）由普通 Node 拉起 ⇒ 没有这个字段。
+ */
+export function isDesktopRuntime(versions = process.versions) {
+    return typeof versions.electron === 'string' && versions.electron.length > 0;
+}
+/**
+ * 从 inject 回调拿到的 ctx 代理里取出宿主 web 服务。
+ *
+ * cordis 的 `ctx.inject(deps, cb)` 把 **ctx 代理**交给回调（不是服务本身），
+ * 注入的服务要从代理上按**服务名**取（`raw.webServer`）；直接读别的属性
+ * 会被代理拒绝（"cannot get property X without inject"）。
+ */
+export function webServerOf(raw) {
+    return raw?.[WEB_SERVER_SERVICE];
+}
+/** 立刻抬高上限（web 服务的 http server 已经存在时）。 */
+export function raiseHeaderBudget(raw, bytes) {
+    return applyHeaderBudget(webServerOf(raw)?.server, bytes);
+}
+/**
+ * 等 web 服务把 http server 建出来，再抬上限。
+ *
+ * 宿主 web 服务的 `server` 字段是在 `listen` 的 effect 里创建的
+ * （`this.server = createServer(listener)`），而 inject 回调在**服务构造**时
+ * 就触发了 ⇒ 那一刻 `server` 还是 undefined。所以这里短轮询一下：等它出现
+ * 立刻抬（赶在 Electron 的 welcome 握手之前），最多等 ~2 秒。
+ *
+ * @returns 是否抬成功
+ */
+export function raiseHeaderBudgetWhenReady(raw, bytes, attempts = 40, intervalMs = 50, schedule = setTimeout) {
+    return new Promise((resolve) => {
+        const web = webServerOf(raw);
+        let attempt = 0;
+        const tick = () => {
+            attempt += 1;
+            const changed = applyHeaderBudget(web?.server, bytes);
+            if (changed) {
+                resolve(true);
+                return;
+            }
+            if (web?.server !== undefined) {
+                resolve(false);
+                return;
+            } // 有 server 但抬不动
+            if (attempt >= attempts) {
+                resolve(false);
+                return;
+            }
+            schedule(tick, intervalMs);
+        };
+        tick();
+    });
+}
+export async function apply(ctx, config) {
+    const cfg = { ...Config, ...(config ?? {}) };
+    if (cfg.enabled === false)
+        return () => { };
+    if (!isDesktopRuntime()) {
+        // headless profile：无 Electron cookie jar ⇒ 没有 431 可修 ⇒ 不碰宿主。
+        ctx.logger?.info?.('[desktop-cookie-janitor] not an Electron runtime — skipped');
+        return () => { };
+    }
+    // ── 防线 1：抬高请求头上限 ────────────────────────────────────────────
+    //
+    // 我们的插件在宿主树里加载，早于 Electron 的 welcome 握手 ⇒ 来得及。
+    //
+    // cordis 的 `ctx.inject(deps, cb)` 把 **ctx 代理**交给回调（不是服务本身），
+    // 注入的服务要从代理上按**服务名**取（`raw.webServer`）；直接读别的属性
+    // 会被代理拒绝（"cannot get property X without inject"）。
+    const injector = ctx;
+    injector.inject([WEB_SERVER_SERVICE], (raw) => {
+        try {
+            void raiseHeaderBudgetWhenReady(raw, cfg.maxHeaderBytes).then((raised) => {
+                ctx.logger?.info?.(`[desktop-cookie-janitor] maxHeaderSize ${raised ? 'raised' : 'unchanged'} → ${cfg.maxHeaderBytes}`);
+            });
+        }
+        catch (error) {
+            // 拿不到 web 服务就只是没有这道防线 —— 不能拖垮启动，更不能刷错误。
+            ctx.logger?.warn?.(`[desktop-cookie-janitor] header budget skipped: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    });
+    // ── 防线 2：开机清掉历次启动的残骸 ────────────────────────────────────
+    //
+    // 实测这个时刻 cookie 库还没被 Electron 锁住（约 3 秒窗口）：
+    //   01:08:23.030 插件加载 → 01:08:25.979 Electron 锁库。
+    const jarPath = cfg.jarPath.length > 0 ? cfg.jarPath : defaultJarPath();
+    const report = await cleanCookieJar(jarPath);
+    ctx.logger?.info?.(`[desktop-cookie-janitor] jar=${report.jar} opened=${report.opened} auth=${report.authCount}`
+        + ` removed=${report.removed} projected=${report.projectedBytes}B launchesLeft=${report.launchesLeft}`
+        + (report.error ? ` error=${report.error}` : ''));
+    return () => { };
+}

package/lib/dsh-adapter/dsh-edge-agent.d.ts

@@ -0,0 +1,48 @@
+/**
+ * dsh-edge-agent — host-half bootstrap plugin.
+ *
+ * The `name='dsh-edge-agent'` row is the aggregate plugin that cordis
+ * 0.2.1-rc.2 mounts when the patch row uses the bare package name
+ * `name: '@scope/pkg'`. The package root (`@scope/pkg`) must re-export
+ * this module so `require('@scope/pkg')` resolves to it via `package.json#main`.
+ *
+ * Lives inside `src/dsh-adapter/` to keep the adapter boundary clean:
+ * the package root (`src/index.ts`) must NOT import `@deepseek-ai/*` directly,
+ * because `verify-adapter-boundary` restricts upstream-package imports to the
+ * `src/dsh-adapter/` subtree only. The flat-layout move (commit `1d6b9a7`)
+ * promoted this plugin from `src/dsh-adapter/index.ts` to the package root,
+ * which immediately tripped the gate — moving the plugin body back into the
+ * adapter subtree restores the invariant without changing the runtime layout
+ * (`lib/index.js` is still the compiled package root, the plugin code just
+ * lives in a different source file).
+ *
+ * Plugin surface (consumer of `@deepseek-ai/*`):
+ *   - name:    'dsh-edge-agent'
+ *   - inject:  ['auditLog', 'localStorage'] — required so `plugin.ts`
+ *              can capture shutdown disposers via `auditLogShutdown(ctx)`
+ *              / `storageShutdown(ctx)`. Subordinate plugins each declare
+ *              their own inject in their own file.
+ *   - Config:  full schemastery schema (matches cordis.yml row)
+ *   - apply:   installFileLogger → upstreamDrift warning → plugin bootstrap
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import Schema from '@deepseek-ai/schemastery';
+export declare const name = "dsh-edge-agent";
+export declare const inject: readonly ["auditLog"];
+export interface Config {
+    /** TEE backend preference. Platform-dependent; auto-detected when omitted. */
+    teeType?: 'simulated' | 'trustzone' | 'keystone' | 'sgx';
+    /** Path to the encrypted storage root. */
+    storageRoot?: string;
+    /** Privacy policy file path. Hot-reloaded on change. */
+    policyPath?: string;
+    /** Default privacy posture when the policy engine cannot classify. */
+    defaultDataLevel?: 'public' | 'sanitized' | 'internal';
+    /** Allow outbound OHTTP requests even when the relay is unreachable. */
+    allowFallbackTls?: boolean;
+    /** Number of recent turns to keep in the conversation slice. */
+    sessionWindowSize?: number;
+}
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config: Config): Promise<() => Promise<void>>;
+//# sourceMappingURL=dsh-edge-agent.d.ts.map

package/lib/dsh-adapter/dsh-edge-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-edge-agent.d.ts","sourceRoot":"","sources":["../../src/dsh-adapter/dsh-edge-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAE7C,eAAO,MAAM,IAAI,mBAAmB,CAAA;AASpC,eAAO,MAAM,MAAM,uBAAwB,CAAA;AAE3C,MAAM,WAAW,MAAM;IACrB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,KAAK,CAAA;IACxD,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAA;IACtD,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,CAahC,CAAA;AAEF,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CActF"}

package/lib/dsh-adapter/dsh-edge-agent.js

@@ -0,0 +1,64 @@
+/**
+ * dsh-edge-agent — host-half bootstrap plugin.
+ *
+ * The `name='dsh-edge-agent'` row is the aggregate plugin that cordis
+ * 0.2.1-rc.2 mounts when the patch row uses the bare package name
+ * `name: '@scope/pkg'`. The package root (`@scope/pkg`) must re-export
+ * this module so `require('@scope/pkg')` resolves to it via `package.json#main`.
+ *
+ * Lives inside `src/dsh-adapter/` to keep the adapter boundary clean:
+ * the package root (`src/index.ts`) must NOT import `@deepseek-ai/*` directly,
+ * because `verify-adapter-boundary` restricts upstream-package imports to the
+ * `src/dsh-adapter/` subtree only. The flat-layout move (commit `1d6b9a7`)
+ * promoted this plugin from `src/dsh-adapter/index.ts` to the package root,
+ * which immediately tripped the gate — moving the plugin body back into the
+ * adapter subtree restores the invariant without changing the runtime layout
+ * (`lib/index.js` is still the compiled package root, the plugin code just
+ * lives in a different source file).
+ *
+ * Plugin surface (consumer of `@deepseek-ai/*`):
+ *   - name:    'dsh-edge-agent'
+ *   - inject:  ['auditLog', 'localStorage'] — required so `plugin.ts`
+ *              can capture shutdown disposers via `auditLogShutdown(ctx)`
+ *              / `storageShutdown(ctx)`. Subordinate plugins each declare
+ *              their own inject in their own file.
+ *   - Config:  full schemastery schema (matches cordis.yml row)
+ *   - apply:   installFileLogger → upstreamDrift warning → plugin bootstrap
+ */
+import Schema from '@deepseek-ai/schemastery';
+export const name = 'dsh-edge-agent';
+// The aggregator needs `auditLog` only. `plugin.ts#apply` reads
+// `ctx.auditLog` (via `auditLogShutdown(ctx)`) and `ctx.localStorage` (via
+// `storageShutdown(ctx)`), but both calls are wrapped in try/catch in
+// `plugin.ts` itself, so we don't need to declare `localStorage` here.
+// Declaring `localStorage` would make cordis hang waiting for a service
+// the desktop-safe patch does not insert, producing the
+// "pending (waiting for service: localStorage)" error.
+export const inject = ['auditLog'];
+export const Config = Schema.object({
+    teeType: Schema.union([
+        'simulated',
+        'trustzone',
+        'keystone',
+        'sgx',
+    ]).description('TEE backend preference; auto-detected when omitted.'),
+    storageRoot: Schema.string().description('Path to the encrypted storage root (resolved at runtime).'),
+    policyPath: Schema.string().description('Privacy policy file path. Hot-reloaded on change.'),
+    defaultDataLevel: Schema.union(['public', 'sanitized', 'internal'])
+        .description('Default privacy posture when the policy engine cannot classify.'),
+    allowFallbackTls: Schema.boolean().description('Allow outbound OHTTP requests even when the relay is unreachable.'),
+    sessionWindowSize: Schema.natural().description('Number of recent turns to keep in the conversation slice.'),
+});
+export async function apply(ctx, config) {
+    // 0. Install the file-logger exporter (see ./file-logger.ts).
+    const { installFileLogger } = await import('./file-logger.js');
+    installFileLogger(ctx);
+    // 1. Drift check — warn at boot when upstream DSH has moved.
+    const { upstreamDrift } = await import('./contract.js');
+    for (const entry of await upstreamDrift()) {
+        ctx.logger?.warn?.(`[dsh-edge-agent] upstream drift: ${entry.pkg} has ${entry.installed} (expected ${entry.expected})`);
+    }
+    // 2. Delegate to the real implementation under plugin.ts.
+    const { apply: bootstrap } = await import('./plugin.js');
+    return bootstrap(ctx, config);
+}