@skillfm/local 2.3.0 → 2.5.0

package/dist/skill-runner/cli.js

@@ -0,0 +1,81 @@
+// M1 skill-runner — CLI subcommand handlers (invoked from src/index.ts)
+//
+// 对应子命令：
+// - `skillfm-local run-skill <slug>` — 启动本地 skill daemon
+// - `skillfm-local stop-skill <slug>` — 停止并清理
+// - `skillfm-local list-skills` — 查本地已跑的 skill
+import { listSkills, runSkill, stopSkill } from './index.js';
+function parseFlags(args) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < args.length; i += 1) {
+        const t = args[i];
+        if (t.startsWith('--')) {
+            const eq = t.indexOf('=');
+            if (eq > 0) {
+                flags[t.slice(2, eq)] = t.slice(eq + 1);
+            }
+            else {
+                const next = args[i + 1];
+                if (next !== undefined && !next.startsWith('--')) {
+                    flags[t.slice(2)] = next;
+                    i += 1;
+                }
+                else {
+                    flags[t.slice(2)] = true;
+                }
+            }
+        }
+        else {
+            positional.push(t);
+        }
+    }
+    return { positional, flags };
+}
+export async function cmdRunSkill() {
+    const { positional, flags } = parseFlags(process.argv.slice(3));
+    const slug = positional[0];
+    if (!slug) {
+        console.error(JSON.stringify({
+            ok: false,
+            error: 'MISSING_SLUG',
+            message: 'Usage: skillfm-local run-skill <slug> [--bundle-root=<path>] [--start-daemon]',
+        }));
+        process.exit(1);
+    }
+    const result = await runSkill({
+        slug,
+        bundle_root_override: typeof flags['bundle-root'] === 'string' ? flags['bundle-root'] : undefined,
+        start_daemon: flags['start-daemon'] === true,
+        health_timeout_ms: typeof flags['health-timeout-ms'] === 'string'
+            ? Number.parseInt(flags['health-timeout-ms'], 10)
+            : undefined,
+    });
+    // 单行 JSON 输出，方便 agent parse
+    console.log(JSON.stringify(result));
+    process.exit(result.ok ? 0 : 1);
+}
+export async function cmdStopSkill() {
+    const { positional } = parseFlags(process.argv.slice(3));
+    const slug = positional[0];
+    if (!slug) {
+        console.error(JSON.stringify({
+            ok: false,
+            error: 'MISSING_SLUG',
+            message: 'Usage: skillfm-local stop-skill <slug>',
+        }));
+        process.exit(1);
+    }
+    const result = await stopSkill(slug);
+    console.log(JSON.stringify(result));
+    process.exit(result.ok ? 0 : 1);
+}
+export function cmdListSkills() {
+    const skills = listSkills();
+    console.log(JSON.stringify({
+        ok: true,
+        count: Object.keys(skills).length,
+        skills,
+    }, null, 2));
+}
+//# sourceMappingURL=cli.js.map

package/dist/skill-runner/cli.js.map

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

package/dist/skill-runner/discovery.d.ts

@@ -0,0 +1,3 @@
+import type { SkillBundleLocation } from './types.js';
+export declare function discoverSkillBundle(slug: string, bundleRootOverride?: string): SkillBundleLocation;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/skill-runner/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/skill-runner/discovery.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAwEtD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,kBAAkB,CAAC,EAAE,MAAM,GAC1B,mBAAmB,CAyDrB"}

package/dist/skill-runner/discovery.js

@@ -0,0 +1,108 @@
+// M1 skill-runner — skill bundle 查找 + manifest 解析
+//
+// 支持两种 bundle 位置（优先级从高到低）：
+// 1. 显式 env `SKILLFM_SKILL_BUNDLE_ROOT=/path/to/monorepo` → 按 `solutions/<slug>/` 找（开发模式）
+// 2. `~/.skillfm/skills/<slug>@<version>/`（生产安装目录，未来 `skillfm install` 创建）
+//
+// manifest 解析：只读需要的最小字段（slug / version / runtime.endpoint），不做完整 schema 校验
+// （完整校验归 M6 manifest validator）。
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const DEFAULT_USER_BUNDLE_ROOT = join(homedir(), '.skillfm', 'skills');
+function parseEndpointPort(endpoint) {
+    const match = endpoint.match(/^https?:\/\/(?:127\.0\.0\.1|localhost):(\d+)(?:\/|$)/);
+    if (!match) {
+        throw new Error(`runtime.endpoint 必须是 http://127.0.0.1:<port> 或 http://localhost:<port>，实际: ${endpoint}（BYOK 红线）`);
+    }
+    const port = Number.parseInt(match[1], 10);
+    if (!Number.isInteger(port) || port < 1024 || port > 65535) {
+        throw new Error(`runtime.endpoint 端口必须在 1024-65535 范围，实际: ${port}`);
+    }
+    return port;
+}
+function extractManifestFields(yamlText) {
+    // 极简正则——只处理 SkillFM 官方 manifest 规约风格（2 空格缩进，简单标量）
+    const pick = (re) => {
+        const m = yamlText.match(re);
+        return m ? m[1].trim().replace(/^['"]|['"]$/g, '') : null;
+    };
+    const slug = pick(/^metadata:\n(?:[\s\S]*?\n)?  slug:\s*([^\n#]+)/m);
+    const version = pick(/^metadata:\n(?:[\s\S]*?\n)?  version:\s*([^\n#]+)/m);
+    const endpoint = pick(/^runtime:\n(?:[\s\S]*?\n)?  endpoint:\s*([^\n#]+)/m);
+    const modeRaw = pick(/^runtime:\n(?:[\s\S]*?\n)?  execution_mode:\s*([^\n#]+)/m);
+    if (!slug)
+        throw new Error('manifest 缺 metadata.slug');
+    if (!version)
+        throw new Error('manifest 缺 metadata.version');
+    if (!endpoint)
+        throw new Error('manifest 缺 runtime.endpoint');
+    const execution_mode = modeRaw === 'docker_shared' ? 'docker_shared' : 'agent_local';
+    return { slug, version, endpoint, execution_mode };
+}
+/** 尝试在 monorepo `solutions/<slug>/` 找（开发模式）*/
+function tryMonorepoBundle(slug, monorepoRoot) {
+    // slug 可能带 hyphen（xianyu-avatar-adult）或 underscore（xianyu_avatar_adult）
+    // solutions 目录用 hyphen
+    const candidates = [
+        join(monorepoRoot, 'solutions', slug),
+        join(monorepoRoot, 'solutions', slug.replace(/_/g, '-')),
+    ];
+    for (const dir of candidates) {
+        if (existsSync(join(dir, 'skill.manifest.yaml')))
+            return dir;
+    }
+    return null;
+}
+/** 尝试在用户安装目录找 */
+function tryUserBundle(slug, userBundleRoot) {
+    // 格式：<root>/<slug>@<version>/，取版本最新的
+    // M1 骨架：简化为固定 `<slug>` 目录（不带版本），支持 `<slug>@<version>` 作为扩展
+    const plain = join(userBundleRoot, slug);
+    if (existsSync(join(plain, 'skill.manifest.yaml')))
+        return plain;
+    // TODO(M2+): 扫描 <slug>@* 目录选最新版
+    return null;
+}
+export function discoverSkillBundle(slug, bundleRootOverride) {
+    const monorepoRoot = bundleRootOverride ?? process.env.SKILLFM_SKILL_BUNDLE_ROOT ?? null;
+    const userBundleRoot = process.env.SKILLFM_USER_BUNDLE_ROOT ?? DEFAULT_USER_BUNDLE_ROOT;
+    let bundleDir = null;
+    if (monorepoRoot)
+        bundleDir = tryMonorepoBundle(slug, monorepoRoot);
+    if (!bundleDir)
+        bundleDir = tryUserBundle(slug, userBundleRoot);
+    if (!bundleDir) {
+        throw Object.assign(new Error(`找不到 skill ${slug}。查过: ${monorepoRoot ?? '(SKILLFM_SKILL_BUNDLE_ROOT 未设)'} / ${userBundleRoot}`), { code: 'SKILL_NOT_FOUND' });
+    }
+    const manifestPath = join(bundleDir, 'skill.manifest.yaml');
+    const yaml = readFileSync(manifestPath, 'utf-8');
+    const manifest = extractManifestFields(yaml);
+    // 校验 slug 匹配（允许 hyphen/underscore 互换）
+    const normalize = (s) => s.replace(/[-_]/g, '');
+    if (normalize(manifest.slug) !== normalize(slug)) {
+        throw new Error(`manifest.slug (${manifest.slug}) 与请求的 slug (${slug}) 不匹配`);
+    }
+    // BYOK 红线：execution_mode=agent_local 时 endpoint 必须 loopback
+    if (manifest.execution_mode === 'agent_local') {
+        // parseEndpointPort 内已强制校验 127.0.0.1/localhost
+    }
+    else {
+        throw new Error(`skill ${slug} execution_mode=${manifest.execution_mode}，不应由 @skillfm/local run-skill 启动（docker_shared skill 在赵云 Docker 跑）`);
+    }
+    const port = parseEndpointPort(manifest.endpoint);
+    const serverEntry = join(bundleDir, 'runtime', 'server.js');
+    const daemonEntry = join(bundleDir, 'runtime', 'daemon.js');
+    if (!existsSync(serverEntry)) {
+        throw new Error(`skill ${slug} 缺 runtime/server.js —— 确认已 build（cd ${bundleDir} && npm run build）`);
+    }
+    return {
+        slug: manifest.slug,
+        version: manifest.version,
+        bundle_dir: bundleDir,
+        server_entry: serverEntry,
+        daemon_entry: existsSync(daemonEntry) ? daemonEntry : null,
+        port,
+    };
+}
+//# sourceMappingURL=discovery.js.map

package/dist/skill-runner/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/skill-runner/discovery.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,2BAA2B;AAC3B,0FAA0F;AAC1F,2EAA2E;AAC3E,EAAE;AACF,0EAA0E;AAC1E,iCAAiC;AAEjC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,MAAM,wBAAwB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAEvE,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;IACrF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,8EAA8E,QAAQ,WAAW,CAClG,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAWD,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,kDAAkD;IAClD,MAAM,IAAI,GAAG,CAAC,EAAU,EAAiB,EAAE;QACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,iDAAiD,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,oDAAoD,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,oDAAoD,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,0DAA0D,CAAC,CAAC;IACjF,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7D,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC9D,MAAM,cAAc,GAClB,OAAO,KAAK,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC;IAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;AACrD,CAAC;AAED,8CAA8C;AAC9C,SAAS,iBAAiB,CACxB,IAAY,EACZ,YAAoB;IAEpB,wEAAwE;IACxE,uBAAuB;IACvB,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,CAAC;QACrC,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;KACzD,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iBAAiB;AACjB,SAAS,aAAa,CAAC,IAAY,EAAE,cAAsB;IACzD,qCAAqC;IACrC,2DAA2D;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACjE,gCAAgC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,kBAA2B;IAE3B,MAAM,YAAY,GAChB,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,IAAI,CAAC;IACtE,MAAM,cAAc,GAClB,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,wBAAwB,CAAC;IAEnE,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,YAAY;QAAE,SAAS,GAAG,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACpE,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,aAAa,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAChE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CACP,aAAa,IAAI,QAAQ,YAAY,IAAI,gCAAgC,MAAM,cAAc,EAAE,CAChG,EACD,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAC5B,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAE7C,sCAAsC;IACtC,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,kBAAkB,QAAQ,CAAC,IAAI,gBAAgB,IAAI,OAAO,CAC3D,CAAC;IACJ,CAAC;IAED,4DAA4D;IAC5D,IAAI,QAAQ,CAAC,cAAc,KAAK,aAAa,EAAE,CAAC;QAC9C,+CAA+C;IACjD,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,SAAS,IAAI,mBAAmB,QAAQ,CAAC,cAAc,oEAAoE,CAC5H,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAE5D,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,SAAS,IAAI,wCAAwC,SAAS,oBAAoB,CACnF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,UAAU,EAAE,SAAS;QACrB,YAAY,EAAE,WAAW;QACzB,YAAY,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;QAC1D,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/skill-runner/index.d.ts

@@ -0,0 +1,9 @@
+import type { RunSkillError, RunSkillOptions, RunSkillResult } from './types.js';
+export declare function runSkill(opts: RunSkillOptions): Promise<RunSkillResult | RunSkillError>;
+export declare function stopSkill(slug: string): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+export declare function listSkills(): Record<string, import("./types.js").LocalSkillRegistryEntry>;
+export type { RunSkillResult, RunSkillError, RunSkillOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/skill-runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill-runner/index.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAIpB,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,cAAc,GAAG,aAAa,CAAC,CA6EzC;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ3C;AAED,wBAAgB,UAAU,iEAGzB;AAED,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/skill-runner/index.js

@@ -0,0 +1,100 @@
+// M1 skill-runner — 对外入口
+//
+// 本文件是 `skillfm-local run-skill <slug>` 子命令的主逻辑。流程：
+// 1. discover bundle（solutions/<slug>/ or ~/.skillfm/skills/<slug>/）
+// 2. 读 manifest → 得 port + execution_mode
+// 3. pruneDeadEntries → 检查是否已有 alive entry（已在跑则返回 ALREADY_RUNNING）
+// 4. spawnSkill → 返回 PID
+// 5. waitForHealthy → 最多等 20s
+// 6. upsertEntry → 写本地 registry
+// 7. 返回 JSON 给 agent
+//
+// 失败不清理子进程（便于诊断）；调用者用 kill-skill 子命令收尾。
+import { discoverSkillBundle } from './discovery.js';
+import { findEntry, isAlive, pruneDeadEntries, readRegistry, removeEntry, upsertEntry, } from './registry.js';
+import { killSkill, spawnSkill, waitForHealthy } from './spawner.js';
+const DEFAULT_HEALTH_TIMEOUT_MS = 20_000;
+export async function runSkill(opts) {
+    const { slug } = opts;
+    // Step 1: prune dead entries + check already running
+    pruneDeadEntries();
+    const existing = findEntry(slug);
+    if (existing && isAlive(existing.server_pid)) {
+        return {
+            ok: false,
+            error: 'ALREADY_RUNNING',
+            message: `skill ${slug} 已在跑 (pid=${existing.server_pid}, port=${existing.port})`,
+            hint_for_agent: `已经有一个 ${slug} 在本机运行。先 stop-skill 再 run-skill，或直接复用现有 endpoint ${existing.endpoint}`,
+        };
+    }
+    // Step 2: discover bundle + parse manifest
+    let location;
+    try {
+        location = discoverSkillBundle(slug, opts.bundle_root_override);
+    }
+    catch (err) {
+        const e = err;
+        return {
+            ok: false,
+            error: (e.code === 'SKILL_NOT_FOUND'
+                ? 'SKILL_NOT_FOUND'
+                : 'MANIFEST_INVALID'),
+            message: e.message,
+            hint_for_agent: e.code === 'SKILL_NOT_FOUND'
+                ? `找不到 skill ${slug}。确认已 git clone 仓库并设 SKILLFM_SKILL_BUNDLE_ROOT，或跑 skillfm install ${slug}`
+                : `skill ${slug} 的 manifest 损坏: ${e.message}`,
+        };
+    }
+    // Step 3: spawn
+    let handle;
+    try {
+        handle = await spawnSkill({
+            location,
+            env_overrides: opts.env_overrides,
+            start_daemon: opts.start_daemon,
+        });
+    }
+    catch (err) {
+        const e = err;
+        return {
+            ok: false,
+            error: 'SPAWN_FAILED',
+            message: e.message,
+            hint_for_agent: `spawn 失败：${e.message}。检查 Node 版本（>=20）和 bundle 是否已 build`,
+        };
+    }
+    // Step 4: 立即写 registry（哪怕 health 没过也留痕，方便诊断 kill）
+    upsertEntry(handle, location.bundle_dir);
+    // Step 5: health check
+    const healthy = await waitForHealthy(handle.endpoint, opts.health_timeout_ms ?? DEFAULT_HEALTH_TIMEOUT_MS);
+    if (!healthy) {
+        // Health 失败 —— kill 子进程 + 清 registry
+        killSkill(handle);
+        removeEntry(slug);
+        return {
+            ok: false,
+            error: 'HEALTH_TIMEOUT',
+            message: `skill ${slug} spawn 后 ${opts.health_timeout_ms ?? DEFAULT_HEALTH_TIMEOUT_MS}ms 内未通过 /health 检查`,
+            hint_for_agent: `skill ${slug} 启动后不响应。可能原因：端口被占、依赖未装、skill 代码 bug。查看 skill 日志排查`,
+        };
+    }
+    return {
+        ok: true,
+        handle,
+        hint_for_agent: `skill ${slug} 已在本机跑起来 (pid=${handle.server_pid}, endpoint=${handle.endpoint})。cookie/profile 存本节点 BYOK 安全。下一步 skillfm-local tunnel start 连 brain（M2）`,
+    };
+}
+export async function stopSkill(slug) {
+    const entry = findEntry(slug);
+    if (!entry) {
+        return { ok: false, message: `skill ${slug} 未在本地 registry 注册` };
+    }
+    killSkill(entry);
+    removeEntry(slug);
+    return { ok: true, message: `skill ${slug} 已停止 (pid=${entry.server_pid})` };
+}
+export function listSkills() {
+    pruneDeadEntries();
+    return readRegistry().skills;
+}
+//# sourceMappingURL=index.js.map

package/dist/skill-runner/index.js.map

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

package/dist/skill-runner/registry.d.ts

@@ -0,0 +1,11 @@
+import type { LocalSkillRegistry, LocalSkillRegistryEntry, SkillDaemonHandle } from './types.js';
+export declare function readRegistry(): LocalSkillRegistry;
+export declare function writeRegistry(reg: LocalSkillRegistry): void;
+export declare function upsertEntry(handle: SkillDaemonHandle, bundle_dir: string): void;
+export declare function removeEntry(slug: string): void;
+export declare function findEntry(slug: string): LocalSkillRegistryEntry | null;
+/** 判断 PID 是否仍在跑（M1 简化：kill 0 探活，失败代表进程已死）*/
+export declare function isAlive(pid: number): boolean;
+/** 清理已死进程条目（启动新 skill 前调用）*/
+export declare function pruneDeadEntries(): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/skill-runner/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/skill-runner/registry.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AASpB,wBAAgB,YAAY,IAAI,kBAAkB,CAcjD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAG3D;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,MAAM,GACjB,IAAI,CASN;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI9C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAEtE;AAED,4CAA4C;AAC5C,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO5C;AAED,6BAA6B;AAC7B,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAW3C"}

package/dist/skill-runner/registry.js

@@ -0,0 +1,79 @@
+// M1 skill-runner — 本地 skill 注册表 `~/.skillfm/skills.local.json`
+//
+// 功能：
+// - 跟踪本节点跑了哪些 skill daemon（slug → {pid, port, started_at, endpoint}）
+// - 跨进程读取（M2 SkillTunnelClient 启动时读这里得到本地 skill 列表，上报给 brain）
+// - `skillfm-local stop-skill <slug>` 清理
+// - `skillfm-local list-skills` 查看
+import { readFileSync, writeFileSync, existsSync, mkdirSync, } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+const REGISTRY_FILE = join(homedir(), '.skillfm', 'skills.local.json');
+function ensureDir() {
+    const dir = dirname(REGISTRY_FILE);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+}
+export function readRegistry() {
+    if (!existsSync(REGISTRY_FILE)) {
+        return { version: 1, skills: {} };
+    }
+    try {
+        const raw = readFileSync(REGISTRY_FILE, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== 1 || !parsed.skills) {
+            return { version: 1, skills: {} };
+        }
+        return parsed;
+    }
+    catch {
+        return { version: 1, skills: {} };
+    }
+}
+export function writeRegistry(reg) {
+    ensureDir();
+    writeFileSync(REGISTRY_FILE, JSON.stringify(reg, null, 2), { mode: 0o600 });
+}
+export function upsertEntry(handle, bundle_dir) {
+    const reg = readRegistry();
+    const entry = {
+        ...handle,
+        bundle_dir,
+        last_health_at: Date.now(),
+    };
+    reg.skills[handle.slug] = entry;
+    writeRegistry(reg);
+}
+export function removeEntry(slug) {
+    const reg = readRegistry();
+    delete reg.skills[slug];
+    writeRegistry(reg);
+}
+export function findEntry(slug) {
+    return readRegistry().skills[slug] ?? null;
+}
+/** 判断 PID 是否仍在跑（M1 简化：kill 0 探活，失败代表进程已死）*/
+export function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 清理已死进程条目（启动新 skill 前调用）*/
+export function pruneDeadEntries() {
+    const reg = readRegistry();
+    const removed = [];
+    for (const [slug, entry] of Object.entries(reg.skills)) {
+        if (!isAlive(entry.server_pid)) {
+            removed.push(slug);
+            delete reg.skills[slug];
+        }
+    }
+    if (removed.length > 0)
+        writeRegistry(reg);
+    return removed;
+}
+//# sourceMappingURL=registry.js.map

package/dist/skill-runner/registry.js.map

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

package/dist/skill-runner/spawner.d.ts

@@ -0,0 +1,14 @@
+import type { SkillBundleLocation, SkillDaemonHandle } from './types.js';
+export interface SpawnSkillParams {
+    location: SkillBundleLocation;
+    env_overrides?: Record<string, string>;
+    start_daemon?: boolean;
+    /** 子进程 stdout/stderr 写入的日志文件（可选，默认继承 parent stdout）*/
+    log_file?: string;
+}
+export declare function spawnSkill(params: SpawnSkillParams): Promise<SkillDaemonHandle>;
+/** Poll GET {endpoint}/health 直到 200 或超时 */
+export declare function waitForHealthy(endpoint: string, timeoutMs: number): Promise<boolean>;
+/** Kill a running skill process tree. Returns true if kill signal delivered. */
+export declare function killSkill(handle: Pick<SkillDaemonHandle, 'server_pid' | 'daemon_pid'>): boolean;
+//# sourceMappingURL=spawner.d.ts.map

package/dist/skill-runner/spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawner.d.ts","sourceRoot":"","sources":["../../src/skill-runner/spawner.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAuBD,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAmC5B;AAED,4CAA4C;AAC5C,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,YAAY,CAAC,GAAG,OAAO,CAa/F"}

package/dist/skill-runner/spawner.js

@@ -0,0 +1,85 @@
+// M1 skill-runner — skill 子进程 spawn + health check
+//
+// 设计原则：
+// - 一旦 spawn 成功，立即返回 PID 给调用者（不阻塞等 health ready）
+// - health check 另起一次异步 poll，失败不 kill 子进程（交给调用者决定）—— 方便诊断
+import { spawn } from 'node:child_process';
+import { setTimeout as sleep } from 'node:timers/promises';
+function spawnEntry(entryPath, env, label) {
+    const proc = spawn(process.execPath, [entryPath], {
+        env,
+        detached: true,
+        stdio: 'ignore',
+    });
+    if (!proc.pid) {
+        throw Object.assign(new Error(`spawn ${label} 失败：pid 未返回`), { code: 'SPAWN_FAILED' });
+    }
+    // 脱离 parent 事件循环，允许 @skillfm/local 退出后子进程继续跑
+    proc.unref();
+    return proc;
+}
+export async function spawnSkill(params) {
+    const { location, env_overrides, start_daemon } = params;
+    const env = {
+        ...process.env,
+        ...env_overrides,
+        SKILL_HOST: '127.0.0.1',
+        SKILL_PORT: String(location.port),
+    };
+    const serverProc = spawnEntry(location.server_entry, env, `${location.slug} server`);
+    let daemonPid = null;
+    if (start_daemon && location.daemon_entry) {
+        const daemonProc = spawnEntry(location.daemon_entry, env, `${location.slug} daemon`);
+        daemonPid = daemonProc.pid ?? null;
+    }
+    return {
+        slug: location.slug,
+        version: location.version,
+        port: location.port,
+        server_pid: serverProc.pid,
+        daemon_pid: daemonPid,
+        started_at: new Date().toISOString(),
+        endpoint: `http://127.0.0.1:${location.port}`,
+    };
+}
+/** Poll GET {endpoint}/health 直到 200 或超时 */
+export async function waitForHealthy(endpoint, timeoutMs) {
+    const healthUrl = `${endpoint}/health`;
+    const deadline = Date.now() + timeoutMs;
+    let attempt = 0;
+    while (Date.now() < deadline) {
+        attempt += 1;
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 2000);
+            const res = await fetch(healthUrl, { signal: controller.signal });
+            clearTimeout(timer);
+            if (res.ok)
+                return true;
+        }
+        catch {
+            // fall through to sleep
+        }
+        // 指数退避但 cap 在 1s
+        const delay = Math.min(200 * 2 ** Math.min(attempt, 3), 1000);
+        await sleep(delay);
+    }
+    return false;
+}
+/** Kill a running skill process tree. Returns true if kill signal delivered. */
+export function killSkill(handle) {
+    let killed = false;
+    for (const pid of [handle.server_pid, handle.daemon_pid]) {
+        if (pid && pid > 0) {
+            try {
+                process.kill(pid, 'SIGTERM');
+                killed = true;
+            }
+            catch {
+                // Process may already be dead — swallow
+            }
+        }
+    }
+    return killed;
+}
+//# sourceMappingURL=spawner.js.map

package/dist/skill-runner/spawner.js.map

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

package/dist/skill-runner/types.d.ts

@@ -0,0 +1,62 @@
+export interface SkillBundleLocation {
+    /** skill slug（manifest.metadata.slug）*/
+    slug: string;
+    /** skill 语义版本（manifest.metadata.version）*/
+    version: string;
+    /** bundle 根目录绝对路径 */
+    bundle_dir: string;
+    /** runtime server 入口脚本绝对路径（默认 <bundle>/runtime/server.js）*/
+    server_entry: string;
+    /** runtime daemon 入口脚本绝对路径（可选）*/
+    daemon_entry: string | null;
+    /** loopback 监听端口，从 manifest runtime.endpoint 解析 */
+    port: number;
+}
+export interface SkillDaemonHandle {
+    slug: string;
+    version: string;
+    port: number;
+    /** server 子进程 PID */
+    server_pid: number;
+    /** daemon 子进程 PID（可选，M1 默认不启动 daemon 进程）*/
+    daemon_pid: number | null;
+    started_at: string;
+    /** loopback URL —— 永远 127.0.0.1，守 §1.5 BYOK 红线 */
+    endpoint: string;
+}
+export interface LocalSkillRegistryEntry extends SkillDaemonHandle {
+    /** skill bundle 目录（方便 stop 命令清理时直接找）*/
+    bundle_dir: string;
+    /** 上次 health check 成功时间（ms timestamp）*/
+    last_health_at: number;
+}
+/** `~/.skillfm/skills.local.json` 顶层结构 */
+export interface LocalSkillRegistry {
+    version: 1;
+    skills: Record<string, LocalSkillRegistryEntry>;
+}
+export interface RunSkillOptions {
+    /** skill slug，例如 `xianyu-avatar-adult` */
+    slug: string;
+    /** 可选：bundle 查找根目录覆盖。默认 env `SKILLFM_SKILL_BUNDLE_ROOT` 或 `~/.skillfm/skills` */
+    bundle_root_override?: string;
+    /** health check 轮询超时（默认 20s）*/
+    health_timeout_ms?: number;
+    /** 是否同时启动 daemon 子进程（默认 false —— M1 先只启动 server）*/
+    start_daemon?: boolean;
+    /** 注入到 skill 子进程的环境变量（用于 cookie 路径等 BYOK 配置）*/
+    env_overrides?: Record<string, string>;
+}
+/** run-skill CLI 输出（成功时）*/
+export interface RunSkillResult {
+    ok: true;
+    handle: SkillDaemonHandle;
+    hint_for_agent: string;
+}
+export interface RunSkillError {
+    ok: false;
+    error: 'SKILL_NOT_FOUND' | 'MANIFEST_INVALID' | 'ALREADY_RUNNING' | 'PORT_CONFLICT' | 'SPAWN_FAILED' | 'HEALTH_TIMEOUT';
+    message: string;
+    hint_for_agent: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skill-runner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skill-runner/types.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,iBAAiB,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EACD,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,cAAc,GACd,gBAAgB,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/skill-runner/types.js

@@ -0,0 +1,6 @@
+// M1 skill-runner — shared types
+//
+// 本文件是 @skillfm/local skill daemon 管理模块的对外类型。其它 subagent（M2 tunnel client）
+// 会依赖这里的 SkillDaemonHandle / LocalSkillRegistryEntry，不依赖内部实现。
+export {};
+//# sourceMappingURL=types.js.map

package/dist/skill-runner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skill-runner/types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,2EAA2E;AAC3E,8DAA8D"}

package/dist/skill-tunnel/cli.d.ts

@@ -0,0 +1,5 @@
+export declare function cmdTunnelStart(): Promise<void>;
+export declare function cmdTunnelStop(): void;
+export declare function cmdTunnelStatus(): void;
+export declare function cmdTunnel(): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/skill-tunnel/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/skill-tunnel/cli.ts"],"names":[],"mappings":"AA2EA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAyFpD;AAED,wBAAgB,aAAa,IAAI,IAAI,CA8BpC;AAED,wBAAgB,eAAe,IAAI,IAAI,CAQtC;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAwB/C"}