@anycon/protocol 0.1.0

package/dist/rpc.js

@@ -0,0 +1,310 @@
+/**
+ * 内层 JSON-RPC 2.0：类型、编解码、类型守卫，以及与传输无关的 `RpcPeer`。
+ *
+ * 一个 `data` 信封 = 一条 JSON-RPC 消息（请求 / 响应 / 通知之一），不合并。
+ * 错误以 `error.data.code`（稳定 snake_case）为准，`AnyconRpcError.code` 直接给出它。
+ */
+import { ERROR_CODE_NUMBERS } from './constants.js';
+import { ProtocolError } from './errors.js';
+const JSONRPC = '2.0';
+// ---------- 守卫 ----------
+/** 有 `method` 且有 `id`。 */
+export function isRequest(m) {
+    return 'method' in m && 'id' in m && m.id !== undefined && m.id !== null;
+}
+/** 有 `method` 无 `id`。 */
+export function isNotification(m) {
+    return 'method' in m && !('id' in m && m.id !== undefined && m.id !== null);
+}
+/** 没有 `method`。 */
+export function isResponse(m) {
+    return !('method' in m);
+}
+// ---------- 构造（键序与 Rust 结构体声明一致） ----------
+export function makeRequest(id, method, params = {}) {
+    return { jsonrpc: JSONRPC, id, method, params: params };
+}
+export function makeNotification(method, params = {}) {
+    return { jsonrpc: JSONRPC, method, params: params };
+}
+export function makeResult(id, result) {
+    return { jsonrpc: JSONRPC, id, result };
+}
+export function makeError(id, error) {
+    return { jsonrpc: JSONRPC, id, error };
+}
+// ---------- 编解码 ----------
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder('utf-8', { fatal: true });
+const isSet = (v) => v !== null && v !== undefined;
+/** `RpcError` 的字段顺序 code, message, data；`data` 里的可选字段为 null / undefined 时省略。 */
+function canonicalError(err) {
+    const out = { code: err.code, message: err.message };
+    const data = err.data;
+    if (data !== undefined && data !== null) {
+        const d = { code: data.code };
+        if (isSet(data.field))
+            d.field = data.field;
+        if (isSet(data.reason))
+            d.reason = data.reason;
+        if (isSet(data.retry_after_ms))
+            d.retry_after_ms = data.retry_after_ms;
+        out.data = d;
+    }
+    return out;
+}
+/** 按 Rust 侧的字段顺序重排，保证和 `serde_json::to_vec` 字节一致。 */
+function canonicalRpc(msg) {
+    if (isRequest(msg))
+        return makeRequest(msg.id, msg.method, msg.params ?? {});
+    if (isNotification(msg))
+        return makeNotification(msg.method, msg.params ?? {});
+    const out = { jsonrpc: JSONRPC, id: msg.id };
+    if (msg.result !== undefined)
+        out.result = msg.result;
+    if (msg.error !== undefined && msg.error !== null)
+        out.error = canonicalError(msg.error);
+    return out;
+}
+export function encodeRpc(msg) {
+    return textEncoder.encode(JSON.stringify(canonicalRpc(msg)));
+}
+export function decodeRpc(bytes) {
+    let value;
+    try {
+        value = JSON.parse(textDecoder.decode(bytes));
+    }
+    catch (cause) {
+        throw new ProtocolError('rpc message is not valid JSON', { cause });
+    }
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new ProtocolError('rpc message must be a JSON object');
+    }
+    const m = value;
+    if (m.jsonrpc !== JSONRPC)
+        throw new ProtocolError('rpc message is not jsonrpc 2.0');
+    const hasId = typeof m.id === 'number' || typeof m.id === 'string';
+    if ('method' in m) {
+        if (typeof m.method !== 'string')
+            throw new ProtocolError('rpc method must be a string');
+        if ('id' in m && !hasId)
+            throw new ProtocolError('rpc id must be a number or string');
+        return value;
+    }
+    if (!hasId)
+        throw new ProtocolError('rpc response needs a numeric or string id');
+    return value;
+}
+// ---------- 错误 ----------
+const CODE_BY_NUMBER = new Map(Object.entries(ERROR_CODE_NUMBERS).map(([code, n]) => [n, code]));
+/** 远端返回（或本地构造）的 JSON-RPC 错误。`code` 是稳定的 snake_case，客户端据此 i18n。 */
+export class AnyconRpcError extends Error {
+    name = 'AnyconRpcError';
+    /** JSON-RPC 数字 code。 */
+    rpcCode;
+    data;
+    constructor(rpcCode, message, data) {
+        super(message);
+        this.rpcCode = rpcCode;
+        this.data = data ?? null;
+    }
+    /** 稳定错误码：优先 `data.code`，没有就按数字 code 反查，再不行是 `internal`。 */
+    get code() {
+        return this.data?.code ?? CODE_BY_NUMBER.get(this.rpcCode) ?? 'internal';
+    }
+    /** `invalid_settings` 时指出出错字段。 */
+    get field() {
+        return this.data?.field ?? undefined;
+    }
+    get reason() {
+        return this.data?.reason ?? undefined;
+    }
+    get retryAfterMs() {
+        return this.data?.retry_after_ms ?? undefined;
+    }
+    static fromWire(err) {
+        return new AnyconRpcError(err.code, err.message, err.data);
+    }
+    /** 构造稳定码对应的错误（daemon 侧请求处理器、测试用）。 */
+    static of(code, message, extra) {
+        return new AnyconRpcError(ERROR_CODE_NUMBERS[code], message, { code, ...extra });
+    }
+    toWire() {
+        const wire = { code: this.rpcCode, message: this.message };
+        if (this.data)
+            wire.data = this.data;
+        return wire;
+    }
+}
+/** 请求超时。 */
+export class RpcTimeoutError extends Error {
+    method;
+    timeoutMs;
+    name = 'RpcTimeoutError';
+    constructor(method, timeoutMs) {
+        super(`rpc ${method} timed out after ${timeoutMs}ms`);
+        this.method = method;
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * 与传输无关的 JSON-RPC 端点。`send` 注入，入站字节喂给 `handle()`。
+ * 请求 id 是递增整数；响应按 id 关联；通知按方法名分发（`'*'` 收所有）。
+ */
+export class RpcPeer {
+    #send;
+    #defaultTimeoutMs;
+    #pending = new Map();
+    #notificationHandlers = new Map();
+    #requestHandlers = new Map();
+    #nextId = 1;
+    constructor(options) {
+        this.#send = options.send;
+        this.#defaultTimeoutMs = options.timeoutMs ?? 30_000;
+    }
+    /** 未答复的请求数。 */
+    get pending() {
+        return this.#pending.size;
+    }
+    request(method, params, options = {}) {
+        const id = this.#nextId++;
+        const timeoutMs = options.timeoutMs ?? this.#defaultTimeoutMs;
+        return new Promise((resolve, reject) => {
+            const { signal } = options;
+            if (signal?.aborted) {
+                reject(signal.reason ?? new Error('aborted'));
+                return;
+            }
+            const entry = {
+                method,
+                resolve: resolve,
+                reject,
+                timer: undefined,
+                cleanup: () => {
+                    if (entry.timer !== undefined)
+                        clearTimeout(entry.timer);
+                    signal?.removeEventListener('abort', onAbort);
+                    this.#pending.delete(id);
+                },
+            };
+            const onAbort = () => {
+                entry.cleanup();
+                reject(signal?.reason ?? new Error('aborted'));
+            };
+            if (timeoutMs > 0 && Number.isFinite(timeoutMs)) {
+                entry.timer = setTimeout(() => {
+                    entry.cleanup();
+                    reject(new RpcTimeoutError(method, timeoutMs));
+                }, timeoutMs);
+            }
+            signal?.addEventListener('abort', onAbort, { once: true });
+            this.#pending.set(id, entry);
+            try {
+                this.#send(encodeRpc(makeRequest(id, method, params ?? {})));
+            }
+            catch (err) {
+                entry.cleanup();
+                reject(err);
+            }
+        });
+    }
+    notify(method, params) {
+        this.#send(encodeRpc(makeNotification(method, params ?? {})));
+    }
+    /** 订阅通知。`method = '*'` 收全部。返回取消订阅函数。 */
+    onNotification(method, handler) {
+        let set = this.#notificationHandlers.get(method);
+        if (!set) {
+            set = new Set();
+            this.#notificationHandlers.set(method, set);
+        }
+        const h = handler;
+        set.add(h);
+        return () => {
+            set.delete(h);
+        };
+    }
+    /** 注册对端发来的请求的处理器（目前方向是 D→C，留给以后）。每个方法至多一个。 */
+    onRequest(method, handler) {
+        this.#requestHandlers.set(method, handler);
+        return () => {
+            if (this.#requestHandlers.get(method) === handler) {
+                this.#requestHandlers.delete(method);
+            }
+        };
+    }
+    /** 处理一条入站消息。解析失败抛 `ProtocolError`；处理器内部的错误不会向外抛。 */
+    handle(bytes) {
+        const msg = decodeRpc(bytes);
+        if (isResponse(msg)) {
+            this.#onResponse(msg);
+        }
+        else if (isRequest(msg)) {
+            void this.#onRequest(msg);
+        }
+        else {
+            this.#onNotification(msg);
+        }
+    }
+    /** 拒绝所有未答复请求（连接断开时调用）。 */
+    failAll(error) {
+        const entries = Array.from(this.#pending.values());
+        for (const entry of entries) {
+            entry.cleanup();
+            entry.reject(error);
+        }
+    }
+    #onResponse(msg) {
+        const entry = this.#pending.get(msg.id);
+        if (!entry)
+            return;
+        entry.cleanup();
+        if (msg.error)
+            entry.reject(AnyconRpcError.fromWire(msg.error));
+        else
+            entry.resolve(msg.result);
+    }
+    #onNotification(msg) {
+        for (const key of [msg.method, '*']) {
+            // 先拷贝：订阅者可能在回调里取消订阅。
+            const handlers = Array.from(this.#notificationHandlers.get(key) ?? []);
+            for (const handler of handlers) {
+                try {
+                    handler(msg.params, msg.method);
+                }
+                catch {
+                    // 订阅者的异常不能影响其他订阅者和连接。
+                }
+            }
+        }
+    }
+    async #onRequest(msg) {
+        const handler = this.#requestHandlers.get(msg.method);
+        let reply;
+        if (!handler) {
+            reply = makeError(msg.id, {
+                code: -32601,
+                message: `method not found: ${msg.method}`,
+                data: { code: 'unsupported' },
+            });
+        }
+        else {
+            try {
+                reply = makeResult(msg.id, (await handler(msg.params)) ?? null);
+            }
+            catch (err) {
+                const rpcErr = err instanceof AnyconRpcError
+                    ? err
+                    : AnyconRpcError.of('internal', err instanceof Error ? err.message : String(err));
+                reply = makeError(msg.id, rpcErr.toWire());
+            }
+        }
+        try {
+            this.#send(encodeRpc(reply));
+        }
+        catch {
+            // 连接已断，对端也拿不到答复了。
+        }
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@anycon/protocol",
+  "version": "0.1.0",
+  "description": "TypeScript side of the Anycon protocol: generated types, envelope msgpack codec, JSON-RPC, and the Noise wasm wrapper.",
+  "homepage": "https://github.com/anycon-ai/anycon/tree/main/packages/protocol#readme",
+  "bugs": {
+    "url": "https://github.com/anycon-ai/anycon/issues"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anycon-ai/anycon.git",
+    "directory": "packages/protocol"
+  },
+  "files": [
+    "dist",
+    "!dist/.tsbuildinfo",
+    "src",
+    "wasm/anycon_crypto.js",
+    "wasm/anycon_crypto.d.ts",
+    "wasm/anycon_crypto_bg.wasm",
+    "wasm/anycon_crypto_bg.wasm.d.ts",
+    "wasm/THIRD-PARTY-LICENSES.txt",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./wasm/*": "./wasm/*",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "bun test",
+    "test:node": "node --import tsx --conditions source --test \"tests/**/*.test.ts\"",
+    "lint": "oxlint -c ../../.oxlintrc.json src tests tools",
+    "fmt": "oxfmt --config ../../.oxfmtrc.json src tests tools",
+    "prepack": "bash tools/prepack.sh"
+  },
+  "dependencies": {
+    "@msgpack/msgpack": "^3.1.3"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.2",
+    "@types/node": "^24.0.0",
+    "tsx": "^4.23.15",
+    "typescript": "~5.9.3"
+  }
+}

package/src/constants.ts

@@ -0,0 +1,173 @@
+/**
+ * 常量。全部镜像 `crates/protocol`，`constants.test.ts` 会解析 Rust 源码做漂移检查：
+ * 改了 Rust 侧的方法名 / 版本号 / close code / 错误码数值，这里不同步测试就会红。
+ */
+
+/** 内层 JSON-RPC 协议版本。相邻 minor 兼容，0.x 阶段可 break。 */
+export const PROTOCOL_VERSION = 1
+/** 外层信封版本。极少改动。 */
+export const ENVELOPE_VERSION = 1
+
+/** 短码字母表：大写字母数字去掉 0 O 1 I L。 */
+export const PAIR_CODE_ALPHABET = '23456789ABCDEFGHJKMNPQRSTUVWXYZ'
+/** 短码长度：8 位（约 40 bit），`anycon pair --short` 生成的；只适合自建 hub，经不信任的 hub 配对不要用。 */
+export const PAIR_CODE_LEN = 8
+/** 长短码长度：16 位（约 79 bit），`anycon pair` 的**默认**长度，链接 / 二维码 / `--json` 都是它。与 `crates/crypto` 的 `PAIR_CODE_LEN_LONG` 一致。 */
+export const PAIR_CODE_LEN_LONG = 16
+
+/** WebSocket close code（hub → 设备）。 */
+export const CLOSE_CODE = {
+  /** 同一设备的新连接顶掉了这条。不要自动重连，否则两条连接会互相踢。 */
+  SUPERSEDED: 4001,
+  /** hub 优雅关停。1–3 秒抖动后重连，而不是指数退避。 */
+  RESTARTING: 4002,
+  /** 接收太慢，发送缓冲持续满。 */
+  SLOW_CONSUMER: 4003,
+  /** 设备已被吊销。 */
+  REVOKED: 4004,
+  /** 第一帧 auth 超时。 */
+  AUTH_TIMEOUT: 4005,
+} as const
+
+/** 内层方法名。`域.动作`。键名与 `crates/protocol/src/methods.rs` 的常量名一致。 */
+export const METHODS = {
+  // pairing（握手刚完成、PairDone 之后，daemon → joiner 的第一条加密通知；joiner 收到并校验后才落盘）
+  /** D→C notification，params = PairAck */
+  PAIR_ACK: 'pair.ack',
+
+  // node
+  NODE_INFO: 'node.info',
+  NODE_DEVICES: 'node.devices',
+  NODE_REVOKE_DEVICE: 'node.revoke_device',
+  NODE_PAIR_BEGIN: 'node.pair_begin',
+  NODE_STATS: 'node.stats',
+  NODE_DOCTOR: 'node.doctor',
+  NODE_AUDIT: 'node.audit',
+  NODE_SET_AGENT_DEFAULTS: 'node.set_agent_defaults',
+
+  // 账号内接入（ADR-36）
+  /** 进行中的接入会话。 */
+  NODE_ENROLL_LIST: 'node.enroll_list',
+  /** 批准一个接入请求：`code` 返回 6 位码，`scan` 带二维码里的密钥。 */
+  NODE_ENROLL_APPROVE: 'node.enroll_approve',
+  NODE_ENROLL_DENY: 'node.enroll_deny',
+  /** 主动生成 6 位接入码（「添加设备」、`anycon pair --enroll`）。 */
+  NODE_ENROLL_CODE: 'node.enroll_code',
+  NODE_ENROLL_STATUS: 'node.enroll_status',
+  NODE_SET_ENROLL_PASSWORD: 'node.set_enroll_password',
+  NODE_SET_ENROLL_ENABLED: 'node.set_enroll_enabled',
+  /** D→C notification，params = EnrollInfo */
+  NODE_ENROLL_REQUESTED: 'node.enroll_requested',
+  /** D→C notification，params = NodeEnrollResolved */
+  NODE_ENROLL_RESOLVED: 'node.enroll_resolved',
+  /** D→C notification，params = NodeSecurityEvent */
+  NODE_SECURITY_EVENT: 'node.security_event',
+
+  // agent
+  AGENT_LIST: 'agent.list',
+  AGENT_DIAGNOSE: 'agent.diagnose',
+  /** D→C notification，params = AgentListResult */
+  AGENT_CHANGED: 'agent.changed',
+
+  // workspace
+  WORKSPACE_LIST: 'workspace.list',
+  WORKSPACE_CREATE: 'workspace.create',
+  WORKSPACE_CLONE: 'workspace.clone',
+  WORKSPACE_RENAME: 'workspace.rename',
+  WORKSPACE_TRASH: 'workspace.trash',
+  WORKSPACE_TRASH_LIST: 'workspace.trash_list',
+  WORKSPACE_RESTORE: 'workspace.restore',
+  WORKSPACE_PURGE: 'workspace.purge',
+  /** 把本机已有目录关联为项目（params = WorkspaceLinkParams → Project）。 */
+  WORKSPACE_LINK: 'workspace.link',
+  /** 解除关联（不删除目录；params = WorkspaceNameParams）。 */
+  WORKSPACE_UNLINK: 'workspace.unlink',
+  /** 列本机目录供选择（params = WorkspaceBrowseParams → WorkspaceBrowseResult）。 */
+  WORKSPACE_BROWSE: 'workspace.browse',
+  /** 列项目的分支（params = WorkspaceBranchesParams → WorkspaceBranchesResult，ADR-34）。 */
+  WORKSPACE_BRANCHES: 'workspace.branches',
+  /** 列 anycon 建的 worktree（params = WorkspaceWorktreesParams → WorkspaceWorktreesResult）。 */
+  WORKSPACE_WORKTREES: 'workspace.worktrees',
+  /** 删掉一个已保留 / 没有会话的 worktree（params = WorkspaceRemoveWorktreeParams）。 */
+  WORKSPACE_REMOVE_WORKTREE: 'workspace.remove_worktree',
+  /** D→C notification */
+  WORKSPACE_CHANGED: 'workspace.changed',
+  /** D→C notification */
+  JOB_PROGRESS: 'job.progress',
+  /** D→C notification */
+  JOB_DONE: 'job.done',
+  JOB_CANCEL: 'job.cancel',
+
+  // fs
+  FS_LIST: 'fs.list',
+  FS_READ: 'fs.read',
+
+  // session
+  SESSION_LIST: 'session.list',
+  SESSION_GET: 'session.get',
+  SESSION_CREATE: 'session.create',
+  SESSION_SEND: 'session.send',
+  SESSION_CANCEL: 'session.cancel',
+  SESSION_SET_SETTINGS: 'session.set_settings',
+  SESSION_WATCH: 'session.watch',
+  SESSION_UNWATCH: 'session.unwatch',
+  SESSION_HISTORY: 'session.history',
+  /** D→C notification，params = SessionEvent */
+  SESSION_EVENT: 'session.event',
+  /** D→C notification，params = SessionChanged */
+  SESSION_CHANGED: 'session.changed',
+  SESSION_RENAME: 'session.rename',
+  SESSION_ARCHIVE: 'session.archive',
+  SESSION_UNARCHIVE: 'session.unarchive',
+  SESSION_DELETE: 'session.delete',
+  SESSION_RESTART: 'session.restart',
+  SESSION_SEARCH: 'session.search',
+  SESSION_PROMOTE: 'session.promote',
+  /** params = SessionGitStatusParams → SessionGitStatus（ADR-34） */
+  SESSION_GIT_STATUS: 'session.git_status',
+  /** params = SessionDiffParams → SessionDiffResult */
+  SESSION_DIFF: 'session.diff',
+  /** params = SessionSyncBaseParams → SessionSyncBaseResult */
+  SESSION_SYNC_BASE: 'session.sync_base',
+
+  // blob（附件，ADR-35）
+  /** params = BlobPutBeginParams → BlobPutBeginResult */
+  BLOB_PUT_BEGIN: 'blob.put_begin',
+  /** params = BlobPutChunkParams */
+  BLOB_PUT_CHUNK: 'blob.put_chunk',
+  /** params = BlobIdParams → AttachmentRef */
+  BLOB_PUT_END: 'blob.put_end',
+  /** params = BlobGetParams → BlobGetResult */
+  BLOB_GET: 'blob.get',
+  /** params = BlobIdParams */
+  BLOB_DISCARD: 'blob.discard',
+
+  // permission
+  /** D→C notification，params = PermissionRequest */
+  PERMISSION_REQUEST: 'permission.request',
+  PERMISSION_RESPOND: 'permission.respond',
+  /** D→C notification，params = PermissionResolved */
+  PERMISSION_RESOLVED: 'permission.resolved',
+  PERMISSION_LIST: 'permission.list',
+} as const
+
+export type MethodName = (typeof METHODS)[keyof typeof METHODS]
+
+/**
+ * `ErrorCode` → JSON-RPC 数字 code（`crates/protocol/src/error.rs` 的 `rpc_code`）。
+ * 客户端只应依赖 `error.data.code`；数字 code 仅在对端没带 `data` 时做兜底。
+ */
+export const ERROR_CODE_NUMBERS = {
+  invalid: -32602,
+  invalid_settings: -32001,
+  agent_unavailable: -32002,
+  node_busy: -32003,
+  busy: -32004,
+  already_resolved: -32005,
+  exists: -32006,
+  not_found: -32007,
+  forbidden: -32008,
+  unsupported: -32009,
+  protocol_mismatch: -32010,
+  internal: -32603,
+} as const