dsh-remote-control 1.0.0 → 1.1.0

package/dist/src/platform/qr.js

@@ -1,80 +0,0 @@
-/**
- * qr — 配对二维码：矩阵来自 `qrcode`（node-qrcode），呈现层自己写。
- *
- * 为什么不自己写编码器：旧实现试过，被第三方解码器对拍抓出码字层的系统性差异后否决
- * （取证 packages/plugin 旧 qr.ts 文件头，基线 b026d63:packages/plugin/src/qr.ts:5-9）。
- * node-qrcode 的实测结论在 docs/legacy-spec/open-source-options.md §A.3：
- * 真实配对 URI（98 B 典型 / 188 B 最坏）在 L/M/Q/H 四档纠错、12 组尺寸下全部被
- * zxing 解出，CJK 载荷 round-trip 正确，纯 JS 无原生模块。
- *
- * 呈现层必须自己写的原因：宿主的 TUI 五花八门——有的会吞连续空格、有的没有方块字形、
- * 有的用比例字体。所以默认样式是 `ascii`（`##` / `..`，每个亮模块都占一个真实字形），
- * 它在任何渲染器下都不会错位。`half` 最紧凑但最脆。
- *
- * 一个终端格子大约是"高 = 2×宽"，所以每个模块画两个字符宽，否则二维码会被拉成长方形，
- * 手机很难对上焦。
- */
-import QRCode from 'qrcode';
-/** 取二维码的布尔矩阵（含静默区）。 */
-export async function qrMatrix(text, ecc = 'M', quietZone = 2) {
-    const qr = QRCode.create(text, { errorCorrectionLevel: ecc });
-    const size = qr.modules.size;
-    const total = size + quietZone * 2;
-    const out = [];
-    for (let y = 0; y < total; y++) {
-        const row = [];
-        for (let x = 0; x < total; x++) {
-            const mx = x - quietZone;
-            const my = y - quietZone;
-            const dark = mx >= 0 && mx < size && my >= 0 && my < size && Boolean(qr.modules.get(my, mx));
-            row.push(dark);
-        }
-        out.push(row);
-    }
-    return out;
-}
-/** 渲染成终端文本。 */
-export async function renderTerminalQr(text, options = {}) {
-    const { ecc = 'M', quietZone = 2, style = 'ascii', ansi = false } = options;
-    const matrix = await qrMatrix(text, ecc, quietZone);
-    let body;
-    if (style === 'half') {
-        const lines = [];
-        for (let y = 0; y < matrix.length; y += 2) {
-            const top = matrix[y];
-            const bottom = (matrix[y + 1] ?? top.map(() => false));
-            let line = '';
-            for (let x = 0; x < top.length; x++) {
-                line += top[x] && bottom[x] ? '█' : top[x] ? '▀' : bottom[x] ? '▄' : ' ';
-            }
-            lines.push(line);
-        }
-        body = lines.join('\n');
-    }
-    else {
-        const dark = style === 'ascii' ? '##' : '██';
-        const light = style === 'ascii' ? '..' : '  ';
-        body = matrix.map((row) => row.map((cell) => (cell ? dark : light)).join('')).join('\n');
-    }
-    return ansi ? `\x1b[30;107m${body}\x1b[0m` : body;
-}
-/**
- * 生成 PNG。
- *
- * 为什么这是配对二维码的**首选输出**：DSH 的命令 API 只接受纯文本结果
- * （`{kind, text}`，没有图片或附件类型），所以命令里没法把图交给 TUI；
- * 但插件跑在主机上，可以直接写一个 PNG 并把它打开——真图像永远扫得出来。
- */
-export async function qrPng(text, options = {}) {
-    return QRCode.toBuffer(text, {
-        errorCorrectionLevel: options.ecc ?? 'M',
-        margin: options.quietZone ?? 4,
-        scale: options.scale ?? 8,
-        type: 'png',
-    });
-}
-/** 二维码的模块数（测试用来断言静默区与几何，不依赖肉眼）。 */
-export async function qrModuleCount(text, ecc = 'M') {
-    return QRCode.create(text, { errorCorrectionLevel: ecc }).modules.size;
-}
-//# sourceMappingURL=qr.js.map

package/dist/src/platform/qr.js.map

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

package/dist/src/platform/sleep-posix.d.ts

@@ -1,17 +0,0 @@
-import type { SleepPort } from '../ports/index.js';
-export declare class SystemSleepBackend implements SleepPort {
-    private child;
-    private lastError;
-    /** 平台名是构造时定下的，不与接口方法 `platform()` 同名。 */
-    private readonly osName;
-    constructor(platform?: string);
-    backend(): string;
-    platform(): string;
-    isActive(): boolean;
-    start(ownerPid: number, keepDisplay: boolean): {
-        ok: boolean;
-        message?: string;
-    };
-    stop(): void;
-    get error(): string | undefined;
-}

package/dist/src/platform/sleep-posix.js

@@ -1,91 +0,0 @@
-/**
- * sleep-posix — `SleepPort` 的系统工具实现（macOS `caffeinate` / Linux `systemd-inhibit`）。
- *
- * 为什么用外部命令而不是自研或引 npm 库：第三方睡眠抑制库本质也是 spawn 这两个工具，
- * 而直接 spawn 换来的是"锁的生命周期可以由 pid 绑定来表达"。
- *
- * 三处必须留住的细节（都出自取证 docs/legacy-spec/relay-and-wireformat.md §6）：
- * - macOS 带 `-w <pid>`：**断言寿命绑到宿主进程**，宿主崩了锁随之消失，
- *   不会留下一台永远不睡机的机器；整套方案不需要 sudo。
- * - 子进程 `stdio:'ignore'` + `unref()`：插件跑在 GUI 宿主进程里，
- *   不 unref 会吊住事件循环，不 ignore 会让 caffeinate 的输出污染宿主 stdout。
- * - 失败原因（spawn error 或 exit code）要能被上层拿到，最终进
- *   `ev.keep_awake_state.reason`，手机上看得到"为什么没锁上"。
- *
- * Windows 不实现（本版明确不做，见 docs/DESIGN.md §7.2）：只有一个从未在真机验证过的
- * 内联 powershell 构造器，等于把验证不了的代码写进仓库。这里返回 unsupported，
- * 手机端与 status.json 都会如实显示。
- */
-import { spawn } from 'node:child_process';
-import { buildSleepCommand, detectBackend, isSleepSupported } from 'dsh-remote-wire';
-export class SystemSleepBackend {
-    child;
-    lastError;
-    /** 平台名是构造时定下的，不与接口方法 `platform()` 同名。 */
-    osName;
-    constructor(platform = process.platform) {
-        this.osName = platform;
-    }
-    backend() {
-        return detectBackend(this.osName);
-    }
-    platform() {
-        return this.osName;
-    }
-    isActive() {
-        return this.child !== undefined;
-    }
-    start(ownerPid, keepDisplay) {
-        if (!isSleepSupported(this.osName)) {
-            const message = `${this.osName} 没有受支持的防休眠后端`;
-            this.lastError = message;
-            return { ok: false, message };
-        }
-        if (this.child)
-            return { ok: true };
-        const command = buildSleepCommand(this.osName, ownerPid, keepDisplay);
-        if (!command) {
-            const message = '防休眠命令构造失败';
-            this.lastError = message;
-            return { ok: false, message };
-        }
-        try {
-            const child = spawn(command.command, command.args, { stdio: 'ignore' });
-            child.on('error', (error) => {
-                this.lastError = String(error?.message ?? error);
-                this.child = undefined;
-            });
-            child.on('exit', (code) => {
-                if (code !== 0 && code !== null)
-                    this.lastError = `${command.command} 退出码 ${code}`;
-                if (this.child === child)
-                    this.child = undefined;
-            });
-            child.unref();
-            this.child = child;
-            this.lastError = undefined;
-            return { ok: true };
-        }
-        catch (error) {
-            const message = String(error?.message ?? error);
-            this.lastError = message;
-            return { ok: false, message };
-        }
-    }
-    stop() {
-        const child = this.child;
-        this.child = undefined;
-        if (!child)
-            return;
-        try {
-            child.kill('SIGTERM');
-        }
-        catch {
-            /* 已经退了 */
-        }
-    }
-    get error() {
-        return this.lastError;
-    }
-}
-//# sourceMappingURL=sleep-posix.js.map

package/dist/src/platform/sleep-posix.js.map

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

package/dist/src/ports/index.d.ts

@@ -1,246 +0,0 @@
-/**
- * ports — 插件的端口定义（内核/传输/防休眠/时钟/存储）。
- *
- * 这一层是整个插件的"可测性契约"：**只有 `platform/` 与 `shell/` 允许 import cordis
- * 与 `@deepseek-ai/*`**，`core/` 只认这里的形状。旧实现做不到这一点——它的
- * 36 项测试全靠手写 cordis 替身，因为内核调用与业务逻辑写在同一个对象里。
- *
- * 三条设计约束：
- *
- * 1. **内核面必须能被"部分实现"**。真实宿主在不同代际暴露的能力不一样
- *    （列会话有两条路、审批有 waterfall、提问是单提供者服务），所以可选方法
- *    用 `?:` 表达，调用方负责探测与降级——不是用一个 `capabilities` 位图，
- *    那会退化成"猜平台有什么"。
- * 2. **审批与提问走"参与者"语义，不是观测**。`respondApproval` / `ask` 返回 Promise
- *    并由调用方（`core/runtime`）挂到手机上；平台侧的 `approval/request` 是 waterfall，
- *    返回 outcome 即声明"这个决定我认领了"，不调 `next()` 就不会轮到桌面 UI。
- * 3. **所有返回给 core 的形状都是插件自己的类型**（`KernelSession`、`PendingApproval`…），
- *    平台对象一律在适配器里折叠完再出来。这样协议层的 `SessionSummary` 与内核
- *    代际变化之间有一层可测的翻译，而不是满屏 `as any`。
- */
-import type { QuestionItem, SessionSummary } from 'dsh-remote-wire';
-/** 插件端口只需要四个方法形状的 socket，方便用内存替身测试。 */
-export interface PeerSink {
-    /** 向某个会话的所有在线客户端发一条已加密载荷；返回是否有活客户端。 */
-    broadcast(payload: unknown): boolean;
-    /** 单播到某个客户端（用于只回给发起者）。 */
-    toClient(clientId: string, payload: unknown): boolean;
-}
-/** 内核报告的一条会话在插件内部的形状（还没变成线格式）。 */
-export interface KernelSession {
-    summary: SessionSummary;
-    /** 该会话此刻是否有活的 agent 在跑（决定要不要持锁）。 */
-    live: boolean;
-    /** 列表来自哪条路（持久化语料 / 仅本进程活会话）；"只报一个会话"是不是故障，看这个字段。 */
-    listingSource?: 'sessionQuery' | 'sessions';
-}
-/** 会话的一次事件，已经翻译成插件词汇。 */
-export type KernelEvent = {
-    kind: 'delta';
-    sessionId: string;
-    messageId: string;
-    text: string;
-    done: boolean;
-    role?: 'assistant' | 'user' | 'system';
-} | {
-    kind: 'tool';
-    sessionId: string;
-    callId: string;
-    phase: 'started' | 'args' | 'completed' | 'failed';
-    tool?: string;
-    title?: string;
-    argsPreview?: string;
-    resultPreview?: string;
-} | {
-    kind: 'run-state';
-    sessionId: string;
-    state: 'running' | 'idle';
-    detail?: string;
-} | {
-    kind: 'title';
-    sessionId: string;
-    title: string;
-} | {
-    kind: 'sessions-changed';
-    reason?: string;
-};
-/**
- * 一页历史。
- *
- * `events` 用的是**与实时流同一套 KernelEvent 词汇**，而不是另立一套"历史消息"形状：
- * 内核日志里的事件和实时 `session/event` 本来就是同一种东西（都是
- * `{type, seq, data}`），所以翻译函数可以原样复用，出站构造器也可以原样复用。
- * 另立一套的话，同一段翻译逻辑要写两遍，而两份实现分叉的表现是
- * "实时看着对、历史看着怪"——靠肉眼很难发现。
- *
- * `nextBeforeSeq` 省略 = 这是最初的一页（没有更早的内容了）。
- */
-export interface KernelHistoryPage {
-    events: KernelEvent[];
-    nextBeforeSeq?: number;
-}
-/** 一次待决审批。`id` 是插件自己生成的关联键（手机回传时逐字带回）。 */
-export interface PendingApproval {
-    id: string;
-    sessionId: string;
-    /** 平台侧的审计 id（`approval/asked` 里那个），有就带着，便于取证。 */
-    platformId?: string;
-    action: string;
-    reason?: string;
-    /** 挂起的 abort 信号：手机一直不回答案时由平台侧撤销。 */
-    signal?: AbortSignal;
-    /** 认领这次决定：返回平台词汇的 outcome。 */
-    settle(outcome: ApprovalOutcomeValue): void;
-}
-/** 平台词汇（`@deepseek-ai/dsh-user-approval` 的 `ApprovalOutcome`）。 */
-export type ApprovalOutcomeValue = 'allowed-once' | 'rejected' | 'cancelled' | 'unavailable';
-/** 一次待答提问。选项用 label 与平台交换，`id` 只在插件与手机之间使用。 */
-export interface PendingQuestion {
-    id: string;
-    sessionId: string;
-    questions: QuestionItem[];
-    settle(answer: AskUserQuestionAnswerValue): void;
-    cancel(): void;
-}
-/** 平台侧的答案形状（`selected` 装的是**选项 label**，不是我们的 id）。 */
-export interface AskUserQuestionAnswerValue {
-    answers: Array<{
-        id: string;
-        selected: string[];
-        custom?: string;
-    }>;
-}
-/**
- * 内核端口。`listSessions` / `sendPrompt` / `interrupt` 是手机三大动作的落点，
- * 其余是可选能力面：宿主代际不同就有不同，缺失时调用方必须能报出"缺哪个成员 +
- * 该服务对象实际有哪些 key"，而不是静默换一个载体。
- */
-/** core 提供给内核适配器的人工交互入口。 */
-export interface InteractionSink {
-    /** 一次审批请求。返回 `'decline'` 让适配器去调平台的 `next()`。 */
-    approval(info: {
-        sessionId: string;
-        action: string;
-        reason?: string;
-        signal?: AbortSignal;
-    }): Promise<ApprovalDecision>;
-    /** 一次提问请求。返回 null 表示无人应答（适配器须转成明确失败，不许静默挂住 agent）。 */
-    question(info: {
-        sessionId: string;
-        questions: QuestionItem[];
-        signal?: AbortSignal;
-    }): Promise<AskUserQuestionAnswerValue | null>;
-}
-/** 审批结论，外加一个"我不认领"。 */
-export type ApprovalDecision = ApprovalOutcomeValue | 'decline';
-export interface KernelPort {
-    /** 这条载体的名字，会进 status.json（`services` / `apiproxy` / `mock`）。 */
-    readonly carrier: string;
-    listSessions(limit: number): Promise<KernelSession[]>;
-    runState(sessionId: string): Promise<{
-        running: boolean;
-        state: SessionSummary['state'];
-    }>;
-    sendPrompt(sessionId: string, text: string): Promise<{
-        ok: boolean;
-        message?: string;
-    }>;
-    interrupt(sessionId: string): Promise<{
-        ok: boolean;
-        message?: string;
-    }>;
-    /**
-     * 读一条会话已有的历史（手机打开会话时用）。
-     *
-     * **可选**：读历史依赖宿主暴露 `sessionQuery`（`listSessions` / `readTitleSnapshots`
-     * 那条路线的同一个服务），而不同代际的能力面不一样。缺失时调用方必须能明确报出
-     * "这一代没有这个能力"，而不是回一个空列表——空列表在手机上就是"这个会话没内容"，
-     * 那是一个会让人查错方向的假事实。
-     *
-     * `options.beforeSeq` 是上一页给的游标（取 `seq < beforeSeq`）；省略表示要最新一页。
-     */
-    readHistory?(sessionId: string, options: {
-        beforeSeq?: number;
-        limit: number;
-    }): Promise<KernelHistoryPage>;
-    /**
-     * 新建一条会话（手机上那个「新建会话」）。
-     *
-     * **可选**：它依赖宿主暴露 `sessionController`，而不同代际暴露的服务面不一样。
-     * 缺失时调用方必须明确拒绝并说出缺哪一层，**不许**回一条"已创建"——
-     * 手机拿着一个假的 sessionId 一路走下去，失败点会离病根很远。
-     *
-     * 成功时返回**主机分配**的 id。刻意不接受标题：命名是主机那一侧的事
-     * （创建时不传 sessionId 由内核分配，不传 cwd 就用默认项目目录）。
-     */
-    newSession?(): Promise<{
-        ok: boolean;
-        sessionId?: string;
-        message?: string;
-    }>;
-    /** 订阅会话事件；返回退订函数。实现必须拒绝订阅 waterfall（见 guard.ts）。 */
-    subscribe(onEvent: (event: KernelEvent) => void): () => void;
-    /**
-     * 登记"谁来处理一次人工交互"。
-     *
-     * 方向很重要：**交互由平台发起**（审批是 `approval/request` waterfall 的参与者、
-     * 提问是 `ctx.userQuestions` 的提供者），适配器只负责把它转交给 core，
-     * 并在 core 给出结论后把结论送回平台。所以这里是 sink 注册，不是 `ask()` 调用。
-     *
-     * core 返回 `'decline'` 表示"这局我不认领"（例如此刻没有已配对的手机在线），
-     * 审批适配器此时**必须**调用平台的 `next()` 把决定权交还桌面 UI；
-     * 提问服务是单提供者、没有 next 可交还，因此 decline 一律转成明确失败，
-     * 绝不静默挂住 agent（取证：dsh-user-questions 只允许一个活跃 provider）。
-     */
-    attachInteractionSink?(sink: InteractionSink): () => void;
-    /** 冷会话续跑（归档/未加载的会话发指令前需要）。 */
-    ensureRunnable?(sessionId: string): Promise<{
-        ok: boolean;
-        message?: string;
-    }>;
-    /**
-     * 一条会话的工作区目录（会话头里的 `cwd`）。
-     *
-     * **可选**：宿主代际不同，能拿到 `cwd` 的面也不同。只查**活会话**（`sessions.get(id)`，
-     * 同步、零成本）——用到它的两个调用点（`/drc pair` 与右栏那条路由）都发生在用户正在
-     * 那条会话里操作的时刻，活会话这条足以覆盖；查不到就返回 undefined，调用方退回
-     * `~/.dsh/` 并在卡片上如实显示那个路径。
-     *
-     * 返回值必须是绝对路径（会话头里的 `cwd` 被内核校验为绝对路径），调用方直接当目录用。
-     */
-    sessionWorkspace?(sessionId: string): string | undefined;
-    /** 当前模型选择，仅用于展示与"没模型就拒绝"的前置判断。 */
-    modelSelection?(): {
-        provider: string;
-        model: string;
-    } | undefined;
-    /** 诊断：内核服务实际暴露了哪些成员，出错时打出来。 */
-    describe(): Record<string, string | number | boolean>;
-}
-/** 传输端口：core 通过它发消息，不关心 socket。 */
-export interface TransportPort {
-    /** 有没有能收这条会话消息的对端（决定审批要不要自己认领）。 */
-    hasPeer(sessionId: string): boolean;
-    broadcast(payload: unknown, sessionId?: string): void;
-}
-/** 防休眠后端端口。 */
-export interface SleepPort {
-    backend(): string;
-    platform(): string;
-    start(ownerPid: number, keepDisplay: boolean): {
-        ok: boolean;
-        message?: string;
-    };
-    stop(): void;
-    isActive(): boolean;
-}
-/** 时间与随机性注入点：窗口化与退避策略因此可以确定性测试。 */
-export interface Clock {
-    now(): number;
-    setTimeout(fn: () => void, ms: number): unknown;
-    clearTimeout(handle: unknown): void;
-}
-/** 状态快照落盘（GUI 宿主没人看 stdout，这个文件是排错第一入口）。 */
-export interface StatusSink {
-    write(snapshot: Record<string, unknown>): void;
-}

package/dist/src/ports/index.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.js.map

package/dist/src/ports/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ports/index.ts"],"names":[],"mappings":""}

package/dist/src/shell/config.d.ts

@@ -1,56 +0,0 @@
-export interface PluginConfig {
-    enabled: boolean;
-    serverUrl: string;
-    hostToken: string;
-    /** 指向真正的 token 所在的环境变量名（token 本身不进 patch 文件也可以）。 */
-    hostTokenEnv: string;
-    hostId: string;
-    hostLabel: string;
-    keepAwake: {
-        enabled: boolean;
-        idleReleaseSec: number;
-        keepDisplay: boolean;
-    };
-    mockBridge: boolean;
-    statusFile: string;
-    unarchiveOnPrompt: boolean;
-    /** 启动后自动发布一张配对码并把 QR 写进 status.json（验证辅助，默认关）。 */
-    pairOnStartSec: number;
-    /** 向中继申请 PSK 有效期；服务端权威值会覆盖它（见 transport/relay.ts）。 */
-    pairTtlMs: number;
-    /** 是否把配对二维码写成 PNG（默认**开**：文本二维码在 DSH 命令卡里扫不出来，见下方默认值注释）。 */
-    qrImage: boolean;
-    qrOpen: boolean;
-    /** 是否给文本二维码套 ANSI 反色。默认关：宿主按纯文本渲染时会把转义序列打成乱码。 */
-    qrAnsi: boolean;
-    qrStyle: 'ascii' | 'block' | 'half';
-    /** 强 carrier 未到时，等多久才落到弱 carrier。 */
-    carrierGraceMs: number;
-    /** 提问接管：会剥夺桌面 UI 的提问能力，所以默认关（见 core/runtime.ts）。 */
-    takeOverQuestions: boolean;
-    approvalTimeoutSec: number;
-    listingRefreshSec: number;
-    /**
-     * 一条配对通道多久没有任何收发就可以被剪掉（秒）。
-     *
-     * 为什么需要：D3 之后配对通道跨断连长存，而**中继侧的空闲 TTL 是 7 天**
-     * （`DRC_CONV_IDLE_TTL_MS`），"中继先忘掉这条会话"几乎不会发生。不剪的话，
-     * 每天配一次对的主机两周就能攒两百多条密钥，且每次广播都对它们逐个密封一遍。
-     * 剪枝一定同时发 `session-leave`，所以手机不会因此静默转圈——它撞上的是
-     * 中文的"会话已失效，请重新配对"。
-     */
-    conversationIdleTtlSec: number;
-}
-export declare const DEFAULT_CONFIG: PluginConfig;
-export interface ConfigProblem {
-    level: 'error' | 'warn';
-    field: string;
-    message: string;
-}
-/** 合成三级配置。`injected` 来自 cordis 的 patch 层。 */
-export declare function readConfig(injected: Partial<PluginConfig> | undefined, env?: NodeJS.ProcessEnv): PluginConfig;
-/** 校验 + 就地夹取。error 级问题会让上层拒绝启动 runtime（但仍留 status 面包屑）。 */
-export declare function validateConfig(config: PluginConfig): ConfigProblem[];
-/** 令牌脱敏：日志与 status.json 里都只允许出现这个形态。 */
-export declare function redactSecret(value: string): string;
-export { redactSecret as redact };