@skillfm/local 2.6.0 → 2.6.1

package/dist/_vendored-contracts/skill-distribution.js

@@ -0,0 +1,159 @@
+// ⚠️  AUTO-GENERATED — do not edit. Source: shared/contracts/envelope-v2/skill-distribution.ts
+//     Re-generate via `node sdk/skillfm-local/scripts/inline-contracts.ts`.
+//     Edit the source file in shared/contracts/envelope-v2/ instead.
+// @skillfm/contracts — Skill Bundle Distribution（v0.2.1-draft）
+//
+// 本文件是 brain endpoint `GET /v1/skills/<slug>/bundle.tar.gz`、CI artifact pipeline
+// 写入的 `skills.index.json`、@skillfm/local `skill_install` MCP tool input/output
+// 三处的 CANONICAL 契约。三个 subagent 并行实现时严格按此 import。
+//
+// 权威来源：
+//   docs/prd/BRAIN-SKILL-CONTRACT-DELTA-2026-04-25-v0.2.1-skill-distribution.md
+//
+// 跟 v0.2 tunnel 的关系：
+//   - v0.2 (skill-tunnel.ts) 解决 "brain 怎么调到 agent 本地 skill"
+//   - v0.2.1 (本文件) 解决 "skill 代码怎么先到 agent 节点上"
+//   - 两者无 schema 冲突，前后衔接：bundle 装好 → run-skill → tunnel 注册
+// ============================================================================
+// §1 路径常量
+// ============================================================================
+/** brain endpoint base path（namespace 预留 v0.3 第三方 skill）*/
+export const SKILL_BUNDLE_PATH = '/v1/skills/:slug/bundle.tar.gz';
+export const SKILL_BUNDLE_PATH_NAMESPACED = '/v1/skills/:owner/:slug/bundle.tar.gz';
+/** v0.2.1 默认 owner，路径上省略 */
+export const DEFAULT_BUNDLE_OWNER = 'skillfm-official';
+/** slug 校验正则（path param + tool input 共用）*/
+export const SKILL_SLUG_REGEX = /^[a-z0-9-]{2,64}$/;
+/** 赵云 bundle store 落盘路径（CI 写、brain 读）*/
+export const ZHAOYUN_BUNDLE_STORE_DIR = '/opt/skill-bundles';
+export const ZHAOYUN_BUNDLE_INDEX_FILENAME = 'skills.index.json';
+// ============================================================================
+// §4 错误码（统一前缀 SKILL.BUNDLE.*）
+// ============================================================================
+/**
+ * brain endpoint + @skillfm/local 共用错误码。
+ * 跨工作空间稳定字符串，禁止悄悄改名。
+ */
+export const SKILL_BUNDLE_ERROR_CODES = {
+    // 4xx
+    BAD_SLUG: 'SKILL.BUNDLE.BAD_SLUG',
+    AUTH_MISSING_TOKEN: 'SKILL.BUNDLE.AUTH.MISSING_TOKEN',
+    AUTH_BAD_TOKEN: 'SKILL.BUNDLE.AUTH.BAD_TOKEN',
+    AUTH_TOKEN_REVOKED: 'SKILL.BUNDLE.AUTH.TOKEN_REVOKED',
+    /** alias for AUTH_MISSING_TOKEN — used by middleware code */
+    MISSING_TOKEN: 'SKILL.BUNDLE.AUTH.MISSING_TOKEN',
+    /** alias for AUTH_BAD_TOKEN — used by middleware code */
+    INVALID_TOKEN: 'SKILL.BUNDLE.AUTH.BAD_TOKEN',
+    /** alias for AUTH_TOKEN_REVOKED — used by middleware code */
+    TOKEN_REVOKED: 'SKILL.BUNDLE.AUTH.TOKEN_REVOKED',
+    ACCESS_DENIED: 'SKILL.BUNDLE.ACCESS.DENIED',
+    NOT_FOUND: 'SKILL.BUNDLE.NOT_FOUND',
+    VERSION_NOT_FOUND: 'SKILL.BUNDLE.VERSION_NOT_FOUND',
+    CHECKSUM_MISMATCH: 'SKILL.BUNDLE.CHECKSUM_MISMATCH',
+    // 5xx
+    NOT_READY: 'SKILL.BUNDLE.NOT_READY',
+    INTERNAL: 'SKILL.BUNDLE.INTERNAL',
+};
+/** HTTP status mapping（brain handler 用查表，client 错误处理也用）*/
+export const SKILL_BUNDLE_ERROR_HTTP_STATUS = {
+    'SKILL.BUNDLE.BAD_SLUG': 400,
+    'SKILL.BUNDLE.AUTH.MISSING_TOKEN': 401,
+    'SKILL.BUNDLE.AUTH.BAD_TOKEN': 401,
+    'SKILL.BUNDLE.AUTH.TOKEN_REVOKED': 401,
+    'SKILL.BUNDLE.ACCESS.DENIED': 403,
+    'SKILL.BUNDLE.NOT_FOUND': 404,
+    'SKILL.BUNDLE.VERSION_NOT_FOUND': 404,
+    'SKILL.BUNDLE.CHECKSUM_MISMATCH': 409,
+    'SKILL.BUNDLE.NOT_READY': 503,
+    'SKILL.BUNDLE.INTERNAL': 500,
+};
+// ============================================================================
+// §6 @skillfm/local skill_install MCP tool I/O
+// ============================================================================
+/** MCP tool name — 跨工作空间共用常量 */
+export const SKILL_INSTALL_TOOL_NAME = 'skill_install';
+/**
+ * client 侧 error codes — 比服务端错误码多几个本地步骤错误。
+ * 服务端错误（SKILL.BUNDLE.*）会被 client 重命名为更短的本地形式，
+ * 见 mapServerErrorToInstallError() 实现约束（每个 subagent 必须遵守）。
+ */
+export const SKILL_INSTALL_ERROR_CODES = {
+    // 服务端错误归并
+    NETWORK_UNREACHABLE: 'NETWORK.UNREACHABLE',
+    AGENT_NOT_BOUND: 'AGENT.NOT_BOUND',
+    SKILL_NOT_FOUND: 'SKILL.NOT_FOUND',
+    SKILL_ACCESS_DENIED: 'SKILL.ACCESS.DENIED',
+    SKILL_NOT_READY: 'SKILL.NOT_READY',
+    // 本地步骤错误
+    BUNDLE_CHECKSUM_MISMATCH: 'BUNDLE.CHECKSUM_MISMATCH',
+    BUNDLE_EXTRACT_FAILED: 'BUNDLE.EXTRACT_FAILED',
+    BUNDLE_NPM_CI_FAILED: 'BUNDLE.NPM_CI_FAILED',
+    BUNDLE_MISSING_SERVER_JS: 'BUNDLE.MISSING_SERVER_JS',
+    BUNDLE_DISK_FULL: 'BUNDLE.DISK_FULL',
+    BUNDLE_LOCK_BUSY: 'BUNDLE.LOCK_BUSY',
+    // 配置 / 校验
+    INPUT_BAD_SLUG: 'INPUT.BAD_SLUG',
+    INTERNAL: 'INSTALL.INTERNAL',
+};
+// ============================================================================
+// §8 bundle tarball 内容约束（CI 产 + client 校验）
+// ============================================================================
+/**
+ * tarball 解压后**必须存在**的入口文件。client 校验缺即 BUNDLE_MISSING_SERVER_JS。
+ *
+ * Phase 4 (2026-04-26 esbuild bundle 化, audit 簇 1 解):
+ * - 删 `package-lock.json` — esbuild bundle 已 inline workspace deps,
+ *   user 节点 npm ci 只装 yaml/playwright 等真 npm 包, 不需要 per-skill lock
+ * - entry 改 `dist/bundle/server.js` — esbuild output, 0 @skillfm/* bare imports
+ *
+ * 历史 (P4 之前): ['skill.manifest.yaml', 'package.json', 'package-lock.json', 'dist/runtime/server.js']
+ *   - lock 在 monorepo workspace 模式下根本生不出 (workspace * 不在 npm registry)
+ *   - dist/runtime/server.js 含 bare @skillfm/* import → user 节点 npm ci 必爆 R-3
+ */
+export const BUNDLE_REQUIRED_ENTRY_FILES = [
+    'skill.manifest.yaml',
+    'package.json',
+    'dist/bundle/server.js',
+];
+/**
+ * tarball 故意排除的目录/glob。Subagent C tar 命令 --exclude 用此清单。
+ * 注：runtime 必须保留(里面的 server.js 是入口)。
+ */
+export const BUNDLE_EXCLUDE_GLOBS = [
+    'node_modules',
+    '*.test.*',
+    '*.test.ts',
+    '__tests__',
+    '__mocks__',
+    'src',
+    '.storage',
+    '.git*',
+    '.env*',
+    '*.local.*',
+    '.DS_Store',
+];
+// ============================================================================
+// §9 helper: server error → install error 映射
+//
+// 三个 subagent 看的同一份映射表，客户端 + 测试都按此实现。
+// ============================================================================
+export function mapServerErrorToInstallError(serverCode) {
+    switch (serverCode) {
+        case 'SKILL.BUNDLE.NOT_FOUND':
+        case 'SKILL.BUNDLE.VERSION_NOT_FOUND':
+            return SKILL_INSTALL_ERROR_CODES.SKILL_NOT_FOUND;
+        case 'SKILL.BUNDLE.ACCESS.DENIED':
+            return SKILL_INSTALL_ERROR_CODES.SKILL_ACCESS_DENIED;
+        case 'SKILL.BUNDLE.AUTH.MISSING_TOKEN':
+        case 'SKILL.BUNDLE.AUTH.BAD_TOKEN':
+        case 'SKILL.BUNDLE.AUTH.TOKEN_REVOKED':
+            return SKILL_INSTALL_ERROR_CODES.AGENT_NOT_BOUND;
+        case 'SKILL.BUNDLE.NOT_READY':
+            return SKILL_INSTALL_ERROR_CODES.SKILL_NOT_READY;
+        case 'SKILL.BUNDLE.CHECKSUM_MISMATCH':
+            return SKILL_INSTALL_ERROR_CODES.BUNDLE_CHECKSUM_MISMATCH;
+        default:
+            return SKILL_INSTALL_ERROR_CODES.INTERNAL;
+    }
+}
+//# sourceMappingURL=skill-distribution.js.map

package/dist/_vendored-contracts/skill-distribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-distribution.js","sourceRoot":"","sources":["../../src/_vendored-contracts/skill-distribution.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,4EAA4E;AAC5E,qEAAqE;AAErE,+DAA+D;AAC/D,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,iDAAiD;AACjD,EAAE;AACF,QAAQ;AACR,gFAAgF;AAChF,EAAE;AACF,qBAAqB;AACrB,4DAA4D;AAC5D,+CAA+C;AAC/C,2DAA2D;AAE3D,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,gCAAyC,CAAC;AAC3E,MAAM,CAAC,MAAM,4BAA4B,GAAG,uCAAgD,CAAC;AAE7F,4BAA4B;AAC5B,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAA2B,CAAC;AAEhE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAEpD,wCAAwC;AACxC,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAA6B,CAAC;AACtE,MAAM,CAAC,MAAM,6BAA6B,GAAG,mBAA4B,CAAC;AAiD1E,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,MAAM;IACN,QAAQ,EAAE,uBAAuB;IACjC,kBAAkB,EAAE,iCAAiC;IACrD,cAAc,EAAE,6BAA6B;IAC7C,kBAAkB,EAAE,iCAAiC;IACrD,6DAA6D;IAC7D,aAAa,EAAE,iCAAiC;IAChD,yDAAyD;IACzD,aAAa,EAAE,6BAA6B;IAC5C,6DAA6D;IAC7D,aAAa,EAAE,iCAAiC;IAChD,aAAa,EAAE,4BAA4B;IAC3C,SAAS,EAAE,wBAAwB;IACnC,iBAAiB,EAAE,gCAAgC;IACnD,iBAAiB,EAAE,gCAAgC;IACnD,MAAM;IACN,SAAS,EAAE,wBAAwB;IACnC,QAAQ,EAAE,uBAAuB;CACzB,CAAC;AAKX,0DAA0D;AAC1D,MAAM,CAAC,MAAM,8BAA8B,GAAyC;IAClF,uBAAuB,EAAE,GAAG;IAC5B,iCAAiC,EAAE,GAAG;IACtC,6BAA6B,EAAE,GAAG;IAClC,iCAAiC,EAAE,GAAG;IACtC,4BAA4B,EAAE,GAAG;IACjC,wBAAwB,EAAE,GAAG;IAC7B,gCAAgC,EAAE,GAAG;IACrC,gCAAgC,EAAE,GAAG;IACrC,wBAAwB,EAAE,GAAG;IAC7B,uBAAuB,EAAE,GAAG;CAC7B,CAAC;AAkDF,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAE/E,gCAAgC;AAChC,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAwB,CAAC;AAkChE;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,UAAU;IACV,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAClC,SAAS;IACT,wBAAwB,EAAE,0BAA0B;IACpD,qBAAqB,EAAE,uBAAuB;IAC9C,oBAAoB,EAAE,sBAAsB;IAC5C,wBAAwB,EAAE,0BAA0B;IACpD,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,UAAU;IACV,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,kBAAkB;CACpB,CAAC;AAmCX,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,qBAAqB;IACrB,cAAc;IACd,uBAAuB;CACf,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc;IACd,UAAU;IACV,WAAW;IACX,WAAW;IACX,WAAW;IACX,KAAK;IACL,UAAU;IACV,OAAO;IACP,OAAO;IACP,WAAW;IACX,WAAW;CACH,CAAC;AAEX,+EAA+E;AAC/E,6CAA6C;AAC7C,EAAE;AACF,sCAAsC;AACtC,+EAA+E;AAE/E,MAAM,UAAU,4BAA4B,CAC1C,UAAyC;IAEzC,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,wBAAwB,CAAC;QAC9B,KAAK,gCAAgC;YACnC,OAAO,yBAAyB,CAAC,eAAe,CAAC;QACnD,KAAK,4BAA4B;YAC/B,OAAO,yBAAyB,CAAC,mBAAmB,CAAC;QACvD,KAAK,iCAAiC,CAAC;QACvC,KAAK,6BAA6B,CAAC;QACnC,KAAK,iCAAiC;YACpC,OAAO,yBAAyB,CAAC,eAAe,CAAC;QACnD,KAAK,wBAAwB;YAC3B,OAAO,yBAAyB,CAAC,eAAe,CAAC;QACnD,KAAK,gCAAgC;YACnC,OAAO,yBAAyB,CAAC,wBAAwB,CAAC;QAC5D;YACE,OAAO,yBAAyB,CAAC,QAAQ,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/_vendored-contracts/skill-tunnel.d.ts

@@ -0,0 +1,172 @@
+/** 所有 frame 共享字段 */
+export interface JsonRpcBase {
+    jsonrpc: '2.0';
+    /** ULID 或 UUID。每条 request 全局唯一。response 回传同一 id */
+    id: string;
+}
+/** Brain → Agent 请求 / Agent → Brain 心跳等主动消息 */
+export interface JsonRpcRequest<M extends SkillTunnelMethod = SkillTunnelMethod, P = unknown> extends JsonRpcBase {
+    method: M;
+    params: P;
+    /** DELTA §5.4: HMAC-SHA256(id || method || JSON.stringify(params), SKILLFM_SKILL_AUTH_SECRET) */
+    meta?: {
+        hmac: string;
+    };
+}
+export interface JsonRpcSuccessResponse<R = unknown> extends JsonRpcBase {
+    result: R;
+    meta?: {
+        hmac: string;
+    };
+}
+export interface JsonRpcErrorResponse extends JsonRpcBase {
+    error: JsonRpcError;
+    meta?: {
+        hmac: string;
+    };
+}
+export type JsonRpcResponse<R = unknown> = JsonRpcSuccessResponse<R> | JsonRpcErrorResponse;
+export type JsonRpcFrame = JsonRpcRequest | JsonRpcResponse;
+/** JSON-RPC 2.0 错误结构 */
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: {
+        /** 应用层 skill 错误码（映射到 brain 侧 §3.0 错误表） */
+        skill_error_code?: string;
+        retryable?: boolean;
+        skill_meta?: SkillMetaContract;
+        [k: string]: unknown;
+    };
+}
+export declare const TUNNEL_ERROR_CODES: {
+    /** JSON-RPC 2.0 standard */
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    /** 应用层: skill 业务错误（agent 本地 skill 抛出的已知业务错）*/
+    readonly SKILL_APP_ERROR: -32000;
+    /** Tunnel 层: agent 本地 skill daemon 不可达（brain 已连到 agent，但 agent→127.0.0.1:78xx 失败）*/
+    readonly TUNNEL_DEGRADED: -32100;
+};
+export type TunnelErrorCode = (typeof TUNNEL_ERROR_CODES)[keyof typeof TUNNEL_ERROR_CODES];
+/**
+ * Brain → Agent（brain 主调，agent 被调）
+ * 对齐 BRAIN-SKILL-CONTRACT §3 的 5 接口 + abort + health
+ */
+export type SkillTunnelServerMethod = 'skill.run' | 'skill.contribute_ctx' | 'skill.declare_must_relay' | 'skill.manifest' | 'skill.tool.invoke' | 'skill.continuation.abort' | 'skill.health';
+/** Agent → Brain（agent 主调，保留给 heartbeat / 状态上报）*/
+export type SkillTunnelClientMethod = 'tunnel.heartbeat' | 'tunnel.skill_update' | 'tunnel.log';
+export type SkillTunnelMethod = SkillTunnelServerMethod | SkillTunnelClientMethod;
+/** WebSocket 子协议 ID —— 两端必须匹配 */
+export declare const TUNNEL_SUBPROTOCOL: "skillfm.skill-tunnel.v1";
+/** agent → brain: handshake 阶段携带的 headers（除 WS 标准头外的 SkillFM 私有头）*/
+export interface TunnelHandshakeHeaders {
+    /** 长期 agent_token（同 BRAIN §3 auth） */
+    'x-agent-token': string;
+    /** SHA-256(agent_token) 的 hex，避免 token 原文多处出现 */
+    'x-agent-id': string;
+    /** 逗号分隔 `slug@version`，告诉 brain 本节点起了哪些 skill daemon */
+    'x-local-skills': string;
+    /** 逗号分隔 `slug=http://127.0.0.1:<port>`，本地 skill server 的 loopback URL */
+    'x-local-skill-endpoints': string;
+    /** 16 byte 随机 hex（5 分钟滑窗防重放）*/
+    'x-tunnel-nonce': string;
+    /** HMAC-SHA256(agent_token || nonce, SKILLFM_SKILL_AUTH_SECRET) */
+    'x-tunnel-signature': string;
+    /** @skillfm/local 运行时版本，brain 可拒绝过低版本 */
+    'x-skillfm-local-version': string;
+}
+/** Handshake 失败时 brain 返回 HTTP 响应 body */
+export interface TunnelHandshakeRejectBody {
+    ok: false;
+    error: 'TUNNEL.AUTH.BAD_SIGNATURE' | 'TUNNEL.AUTH.AGENT_TOKEN_REVOKED' | 'TUNNEL.AUTH.NONCE_REUSED' | 'TUNNEL.CONN.ALREADY_CONNECTED' | 'TUNNEL.VERSION.UNSUPPORTED';
+    message: string;
+    /** 仅 VERSION.UNSUPPORTED 时返回 */
+    min_local_version?: string;
+}
+/** params for `skill.run` —— 封装现有 SkillRunRequest（见 platform/api types）*/
+export interface SkillRunTunnelParams {
+    skill_slug: string;
+    /** 完整 SkillRunRequest（§3.1），由 brain 侧 SkillRpcClient 序列化透传。
+     *  本契约不重复列字段，避免 double-source-of-truth；unknown 是有意的 —— platform/api 内部
+     *  有详细 SkillRunRequest type，客户端透传时不需要知道每个字段。*/
+    request: unknown;
+}
+/** result for `skill.run` */
+export interface SkillRunTunnelResult {
+    /** SkillRunResult 或 SkillRunLlmTasks union（§3.1 v0.1.1）*/
+    data: unknown;
+    skill_meta: SkillMetaContract;
+}
+export interface SkillMetaContract {
+    skill_slug: string;
+    skill_version: string;
+    processing_ms: number;
+}
+/** params for `skill.tool.invoke` */
+export interface SkillToolInvokeTunnelParams {
+    skill_slug: string;
+    tool_name: string;
+    args: Record<string, unknown>;
+    /** §3.5 私有工具调用上下文（部分 SkillRunContext 字段）*/
+    context: unknown;
+    request_id: string;
+}
+/** params for `tunnel.heartbeat`（agent → brain）*/
+export interface HeartbeatTunnelParams {
+    /** 本地 Unix ms 时间戳 */
+    ts: number;
+    /** 本地 skill daemon 状态快照 —— 每个 slug 的 pid + 内存 + 上次 health check */
+    local_skill_status: Record<string, {
+        pid: number;
+        rss_mb: number;
+        healthy: boolean;
+        last_check_at: number;
+    }>;
+}
+export interface HeartbeatTunnelResult {
+    /** brain 侧 Unix ms 时间戳，用于 agent 校准时钟 */
+    server_ts: number;
+}
+/** params for `tunnel.skill_update`（agent → brain，skill daemon 生命周期事件）*/
+export interface SkillUpdateTunnelParams {
+    event: 'started' | 'stopped' | 'upgraded' | 'crashed';
+    skill_slug: string;
+    skill_version: string;
+    /** stopped / crashed 时填 */
+    endpoint: string | null;
+    occurred_at: number;
+}
+/** close code 4xxx 段 —— 应用层定义，agent 据此决定是否重连 */
+export declare const TUNNEL_CLOSE_CODES: {
+    /** 心跳超时，agent 应重连 */
+    readonly HEARTBEAT_TIMEOUT: 4000;
+    /** 认证签名失败，agent 不应重连 */
+    readonly AUTH_BAD_SIGNATURE: 4001;
+    /** nonce 重用检测，agent 不应重连 */
+    readonly AUTH_NONCE_REUSED: 4002;
+    /** agent_token 已吊销，agent 不应重连 */
+    readonly AGENT_TOKEN_REVOKED: 4003;
+    /** 协议版本不兼容，agent 应升级 @skillfm/local */
+    readonly VERSION_UNSUPPORTED: 4101;
+};
+export type TunnelCloseCode = (typeof TUNNEL_CLOSE_CODES)[keyof typeof TUNNEL_CLOSE_CODES];
+export declare const TUNNEL_CONSTANTS: {
+    /** Heartbeat 发送周期（agent 侧）*/
+    readonly HEARTBEAT_INTERVAL_MS: 25000;
+    /** Heartbeat 超时（brain 或 agent 侧任一未在此时间内收到对方 → 断线）*/
+    readonly HEARTBEAT_TIMEOUT_MS: 60000;
+    /** handshake nonce 滑动窗口（brain 侧 Redis sorted set TTL）*/
+    readonly HANDSHAKE_NONCE_WINDOW_MS: 300000;
+    /** nonce 轮转周期（agent 主动 refresh_nonce）*/
+    readonly NONCE_ROTATION_MS: 600000;
+    /** Reconnect 指数退避上限 */
+    readonly RECONNECT_MAX_DELAY_MS: 30000;
+    /** Reconnect 初始延迟 */
+    readonly RECONNECT_INITIAL_DELAY_MS: 1000;
+    /** JSON-RPC request timeout（< WS keepalive，Q8 决议）*/
+    readonly RPC_REQUEST_TIMEOUT_MS: 90000;
+};
+//# sourceMappingURL=skill-tunnel.d.ts.map

package/dist/_vendored-contracts/skill-tunnel.d.ts.map

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

package/dist/_vendored-contracts/skill-tunnel.js

@@ -0,0 +1,58 @@
+// ⚠️  AUTO-GENERATED — do not edit. Source: shared/contracts/envelope-v2/skill-tunnel.ts
+//     Re-generate via `node sdk/skillfm-local/scripts/inline-contracts.ts`.
+//     Edit the source file in shared/contracts/envelope-v2/ instead.
+// ============================================================================
+// 错误码常量（DELTA §5.3）
+// ============================================================================
+export const TUNNEL_ERROR_CODES = {
+    /** JSON-RPC 2.0 standard */
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    /** 应用层: skill 业务错误（agent 本地 skill 抛出的已知业务错）*/
+    SKILL_APP_ERROR: -32000,
+    /** Tunnel 层: agent 本地 skill daemon 不可达（brain 已连到 agent，但 agent→127.0.0.1:78xx 失败）*/
+    TUNNEL_DEGRADED: -32100,
+};
+// ============================================================================
+// Handshake（DELTA §5.1）
+// ============================================================================
+/** WebSocket 子协议 ID —— 两端必须匹配 */
+export const TUNNEL_SUBPROTOCOL = 'skillfm.skill-tunnel.v1';
+// ============================================================================
+// Close codes（WebSocket close frame）
+// ============================================================================
+/** close code 4xxx 段 —— 应用层定义，agent 据此决定是否重连 */
+export const TUNNEL_CLOSE_CODES = {
+    /** 心跳超时，agent 应重连 */
+    HEARTBEAT_TIMEOUT: 4000,
+    /** 认证签名失败，agent 不应重连 */
+    AUTH_BAD_SIGNATURE: 4001,
+    /** nonce 重用检测，agent 不应重连 */
+    AUTH_NONCE_REUSED: 4002,
+    /** agent_token 已吊销，agent 不应重连 */
+    AGENT_TOKEN_REVOKED: 4003,
+    /** 协议版本不兼容，agent 应升级 @skillfm/local */
+    VERSION_UNSUPPORTED: 4101,
+};
+// ============================================================================
+// 协议级常量（供两端共用，避免 magic number 漂移）
+// ============================================================================
+export const TUNNEL_CONSTANTS = {
+    /** Heartbeat 发送周期（agent 侧）*/
+    HEARTBEAT_INTERVAL_MS: 25_000,
+    /** Heartbeat 超时（brain 或 agent 侧任一未在此时间内收到对方 → 断线）*/
+    HEARTBEAT_TIMEOUT_MS: 60_000,
+    /** handshake nonce 滑动窗口（brain 侧 Redis sorted set TTL）*/
+    HANDSHAKE_NONCE_WINDOW_MS: 300_000,
+    /** nonce 轮转周期（agent 主动 refresh_nonce）*/
+    NONCE_ROTATION_MS: 600_000,
+    /** Reconnect 指数退避上限 */
+    RECONNECT_MAX_DELAY_MS: 30_000,
+    /** Reconnect 初始延迟 */
+    RECONNECT_INITIAL_DELAY_MS: 1_000,
+    /** JSON-RPC request timeout（< WS keepalive，Q8 决议）*/
+    RPC_REQUEST_TIMEOUT_MS: 90_000,
+};
+//# sourceMappingURL=skill-tunnel.js.map

package/dist/_vendored-contracts/skill-tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tunnel.js","sourceRoot":"","sources":["../../src/_vendored-contracts/skill-tunnel.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,4EAA4E;AAC5E,qEAAqE;AAwErE,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,4BAA4B;IAC5B,eAAe,EAAE,CAAC,KAAK;IACvB,gBAAgB,EAAE,CAAC,KAAK;IACxB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,8CAA8C;IAC9C,eAAe,EAAE,CAAC,KAAK;IACvB,oFAAoF;IACpF,eAAe,EAAE,CAAC,KAAK;CACf,CAAC;AAgCX,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,iCAAiC;AACjC,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAkC,CAAC;AAsGrE,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E,gDAAgD;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,qBAAqB;IACrB,iBAAiB,EAAE,IAAI;IACvB,wBAAwB;IACxB,kBAAkB,EAAE,IAAI;IACxB,4BAA4B;IAC5B,iBAAiB,EAAE,IAAI;IACvB,iCAAiC;IACjC,mBAAmB,EAAE,IAAI;IACzB,uCAAuC;IACvC,mBAAmB,EAAE,IAAI;CACjB,CAAC;AAKX,+EAA+E;AAC/E,kCAAkC;AAClC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,6BAA6B;IAC7B,qBAAqB,EAAE,MAAM;IAC7B,oDAAoD;IACpD,oBAAoB,EAAE,MAAM;IAC5B,wDAAwD;IACxD,yBAAyB,EAAE,OAAO;IAClC,wCAAwC;IACxC,iBAAiB,EAAE,OAAO;IAC1B,uBAAuB;IACvB,sBAAsB,EAAE,MAAM;IAC9B,qBAAqB;IACrB,0BAA0B,EAAE,KAAK;IACjC,oDAAoD;IACpD,sBAAsB,EAAE,MAAM;CACtB,CAAC"}

package/dist/mcp-stdio/render-pending-llm-tasks.d.ts

@@ -0,0 +1,66 @@
+/**
+ * §3.6 LlmTask 渲染器 — 把 brain.run 返回的 pending_llm_tasks 渲染成 agent 可执行的文本指令
+ *
+ * 协议: BRAIN-SKILL-CONTRACT-v1 §3.6 LlmTask Protocol
+ *
+ * 关键分支:
+ *   - kind === 'image_generation' → 引导 agent 调本地 image provider, 返回 output_images[]
+ *   - kind === 'text' (或缺省) → 原有文本 LLM 任务路径
+ *
+ * 抽出此文件原因 (2026-04-25 工程债清理窗口):
+ *   - mcp-stdio/server.ts brain_run handler 内嵌渲染逻辑没法单测
+ *   - 抽成纯函数后契约一致性可机器验证 (render-pending-llm-tasks.test.ts)
+ */
+export type ImageGenParams = {
+    prompt: string;
+    style_refs?: string[];
+    subject_ref?: string;
+    aspect_ratio?: '1:1' | '4:3' | '3:4' | '16:9' | '9:16';
+    n?: number;
+    image_model_hint?: 'seedream' | 'minimax_image' | 'dalle' | 'midjourney' | string | null;
+};
+export type PendingLlmTask = {
+    task_id: string;
+    prompt: string;
+    system?: string;
+    schema?: object;
+    max_tokens?: number;
+    temperature?: number;
+    visibility: string;
+    kind?: 'text' | 'image_generation';
+    image_params?: ImageGenParams;
+    narration_pre_zh?: string;
+    narration_pre_en?: string;
+    narration_post_zh?: string;
+    narration_post_en?: string;
+    expected_seconds?: number;
+};
+export type PipelineProgress = {
+    current_round: number;
+    total_estimate: number;
+    hard_cap: number;
+};
+/**
+ * 渲染单个 image_generation task — 对应 §3.6 image_params 字段
+ */
+export declare function renderImageGenerationTask(task: PendingLlmTask): string[];
+/**
+ * 渲染单个 text task — 原有文本 LLM 任务路径
+ */
+export declare function renderTextTask(task: PendingLlmTask): string[];
+/**
+ * 渲染整个 pending_llm_tasks 块 — 含 progress + continuation_token + 多 task 列表
+ *
+ * 输出格式:
+ *   [pipeline 进度: 1/3 轮, 上限 8]            (可选)
+ *   需要你执行 N 个 LLM 任务,完成后用 continuation_token 续跑:
+ *   continuation_token: <token>
+ *
+ *   --- task_id: T1 ---
+ *   <text task 渲染 OR image_generation 渲染>
+ *
+ *   --- task_id: T2 ---
+ *   ...
+ */
+export declare function renderPendingLlmTasks(tasks: PendingLlmTask[], contToken: string, progress?: PipelineProgress): string;
+//# sourceMappingURL=render-pending-llm-tasks.d.ts.map

package/dist/mcp-stdio/render-pending-llm-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-pending-llm-tasks.d.ts","sourceRoot":"","sources":["../../src/mcp-stdio/render-pending-llm-tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACvD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,gBAAgB,CAAC,EAAE,UAAU,GAAG,eAAe,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,IAAI,CAAC;CAC1F,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC;IACnC,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CA+BxE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAO7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,MAAM,CAoBR"}

package/dist/mcp-stdio/render-pending-llm-tasks.js

@@ -0,0 +1,98 @@
+/**
+ * §3.6 LlmTask 渲染器 — 把 brain.run 返回的 pending_llm_tasks 渲染成 agent 可执行的文本指令
+ *
+ * 协议: BRAIN-SKILL-CONTRACT-v1 §3.6 LlmTask Protocol
+ *
+ * 关键分支:
+ *   - kind === 'image_generation' → 引导 agent 调本地 image provider, 返回 output_images[]
+ *   - kind === 'text' (或缺省) → 原有文本 LLM 任务路径
+ *
+ * 抽出此文件原因 (2026-04-25 工程债清理窗口):
+ *   - mcp-stdio/server.ts brain_run handler 内嵌渲染逻辑没法单测
+ *   - 抽成纯函数后契约一致性可机器验证 (render-pending-llm-tasks.test.ts)
+ */
+/**
+ * 渲染单个 image_generation task — 对应 §3.6 image_params 字段
+ */
+export function renderImageGenerationTask(task) {
+    const lines = [];
+    if (!task.image_params) {
+        // 异常: kind 是 image_generation 但没 image_params,fallback 到原 prompt 渲染 + 警告
+        lines.push('[task type] image_generation (⚠️ 缺 image_params 字段, fallback 文本渲染)');
+        lines.push(task.prompt);
+        return lines;
+    }
+    lines.push('[task type] image_generation');
+    lines.push('');
+    lines.push('⚠️ 这是图像生成任务,不是文本任务。');
+    lines.push('你需要调用你本地配置的 image provider (火山方舟 Seedream / MiniMax image-01 / DALL-E 等) 出图,');
+    lines.push('返回 `output_images: [{ url, ttl_seconds?, model_used?, metadata? }]` 数组到 LlmTaskResult。');
+    lines.push('');
+    lines.push('[image_params]');
+    lines.push(`  prompt: ${task.image_params.prompt}`);
+    if (task.image_params.style_refs?.length) {
+        lines.push(`  style_refs (风格参考图,可多张): ${task.image_params.style_refs.join(', ')}`);
+    }
+    if (task.image_params.subject_ref) {
+        lines.push(`  subject_ref (主体参考图,人物一致性): ${task.image_params.subject_ref}`);
+    }
+    lines.push(`  aspect_ratio: ${task.image_params.aspect_ratio ?? '1:1'}`);
+    lines.push(`  n (生成张数): ${task.image_params.n ?? 1}`);
+    if (task.image_params.image_model_hint) {
+        lines.push(`  image_model_hint (建议模型,可不理): ${task.image_params.image_model_hint}`);
+    }
+    if (task.system)
+        lines.push(`[system] ${task.system}`);
+    if (task.expected_seconds)
+        lines.push(`[expected_seconds: ${task.expected_seconds}]`);
+    return lines;
+}
+/**
+ * 渲染单个 text task — 原有文本 LLM 任务路径
+ */
+export function renderTextTask(task) {
+    const lines = [];
+    if (task.system)
+        lines.push(`[system] ${task.system}`);
+    lines.push(task.prompt);
+    if (task.schema)
+        lines.push(`[期望输出 schema] ${JSON.stringify(task.schema)}`);
+    if (task.max_tokens)
+        lines.push(`[max_tokens: ${task.max_tokens}]`);
+    return lines;
+}
+/**
+ * 渲染整个 pending_llm_tasks 块 — 含 progress + continuation_token + 多 task 列表
+ *
+ * 输出格式:
+ *   [pipeline 进度: 1/3 轮, 上限 8]            (可选)
+ *   需要你执行 N 个 LLM 任务,完成后用 continuation_token 续跑:
+ *   continuation_token: <token>
+ *
+ *   --- task_id: T1 ---
+ *   <text task 渲染 OR image_generation 渲染>
+ *
+ *   --- task_id: T2 ---
+ *   ...
+ */
+export function renderPendingLlmTasks(tasks, contToken, progress) {
+    const lines = [];
+    if (progress) {
+        lines.push(`[pipeline 进度: ${progress.current_round}/${progress.total_estimate} 轮, 上限 ${progress.hard_cap}]`);
+    }
+    lines.push(`需要你执行 ${tasks.length} 个 LLM 任务,完成后用 continuation_token 续跑:`);
+    lines.push(`continuation_token: ${contToken}`);
+    lines.push('');
+    for (const task of tasks) {
+        lines.push(`--- task_id: ${task.task_id} ---`);
+        if (task.kind === 'image_generation') {
+            lines.push(...renderImageGenerationTask(task));
+        }
+        else {
+            lines.push(...renderTextTask(task));
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=render-pending-llm-tasks.js.map

package/dist/mcp-stdio/render-pending-llm-tasks.js.map

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

package/dist/mcp-stdio/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-stdio/server.ts"],"names":[],"mappings":";AAyBA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAOtF,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGzF,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQ5E;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA0CjH;AAWD,yCAAyC;AACzC,wBAAgB,uBAAuB,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAEtE;AAuCD,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,KAAK,cAAc,CAAC;AAEpG;;;GAGG;AACH,iBAAS,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CA8zB9D;AA4BD,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAU1C"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-stdio/server.ts"],"names":[],"mappings":";AAyBA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAQtF,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAMzF,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQ5E;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA0CjH;AAWD,yCAAyC;AACzC,wBAAgB,uBAAuB,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAEtE;AAuCD,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,KAAK,cAAc,CAAC;AAEpG;;;GAGG;AACH,iBAAS,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAmzB9D;AA4BD,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAU1C"}