@lingxiao-office/sdk 1.0.0

package/dist/core/BughuntPolicy.js

@@ -0,0 +1,37 @@
+export const DEFAULT_BUGHUNT_POLICY = {
+    eventCapture: 'minimal',
+    evidencePack: true,
+    truthChecks: 'minimal',
+    maxEvents: 50,
+    maxEventSummaryChars: 500,
+    maxEventItems: 10,
+    maxEvidenceLineChars: 500,
+    maxRawResultChars: 20_000,
+    maxCommandChars: 800,
+    commandPrefixes: [
+        'npm', 'pnpm', 'yarn', 'node', 'npx', 'tsc', 'vitest', 'jest', 'pytest',
+        'cargo', 'go test', 'curl', 'python', 'bash', 'sh',
+    ],
+    sourcePathPrefixes: ['src', 'web', 'test', 'tests', 'scripts', 'docs'],
+    evidenceSignals: [
+        { name: 'evidence', pattern: /\bevidence\b/i },
+        { name: 'zh-evidence', pattern: /证据/ },
+        { name: 'repro', pattern: /\brepro\b/i },
+        { name: 'zh-repro', pattern: /复现/ },
+        { name: 'verified', pattern: /\bverified\b/i },
+        { name: 'zh-verified', pattern: /验证/ },
+        { name: 'confirmed', pattern: /\bconfirmed\b/i },
+        { name: 'zh-confirmed', pattern: /确认/ },
+        { name: 'failed', pattern: /\bfailed\b/i },
+        { name: 'zh-failed', pattern: /失败/ },
+        { name: 'passed', pattern: /\bpassed\b/i },
+        { name: 'zh-passed', pattern: /通过/ },
+        { name: 'curl', pattern: /\bcurl\b/i },
+        { name: 'exit-code', pattern: /\bexit code\b/i },
+        { name: 'zh-exit-code', pattern: /退出码/ },
+    ],
+};
+export function getBughuntPolicy(overrides) {
+    return { ...DEFAULT_BUGHUNT_POLICY, ...(overrides || {}) };
+}
+//# sourceMappingURL=BughuntPolicy.js.map

package/dist/core/BughuntPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BughuntPolicy.js","sourceRoot":"","sources":["../../src/core/BughuntPolicy.ts"],"names":[],"mappings":"AAuBA,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,IAAI;IAClB,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,EAAE;IACb,oBAAoB,EAAE,GAAG;IACzB,aAAa,EAAE,EAAE;IACjB,oBAAoB,EAAE,GAAG;IACzB,iBAAiB,EAAE,MAAM;IACzB,eAAe,EAAE,GAAG;IACpB,eAAe,EAAE;QACf,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ;QACvE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI;KACnD;IACD,kBAAkB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;IACtE,eAAe,EAAE;QACf,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE;QAC9C,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;QACxC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE;QACnC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE;QAC9C,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE;QACtC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE;QAChD,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE;QACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;QAC1C,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;QACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;QAC1C,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;QACpC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;QACtC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE;QAChD,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE;KACzC;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,SAAkC;IACjE,OAAO,EAAE,GAAG,sBAAsB,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;AAC7D,CAAC"}

package/dist/core/BuildDiagnosticsCollector.d.ts

@@ -0,0 +1,97 @@
+/**
+ * BuildDiagnosticsCollector — 结构化构建诊断收集器
+ *
+ * 面向巨型项目设计：
+ * - 调用真实 build 工具，获取**结构化**输出（JSON/machine-readable 格式）
+ * - 不做关键词匹配 —— 直接解析工具原生的诊断格式
+ * - 支持 TypeScript (tsc)、ESLint、Cargo、Go、Python (mypy)
+ *
+ * 设计原则：
+ * - 确定性: 输出由 build 工具决定，不是我们猜
+ * - 可组合: 每种 build 工具是独立 adapter，返回统一 Diagnostic 结构
+ * - 增量友好: 只收集当前 build 状态，不缓存历史诊断
+ *
+ * 用途:
+ * - Worker 写完代码后调用 → 拿到精确错误位置 + 消息
+ * - Leader 据此判断 worker 是否需要重试 (不是猜，是看 diagnostics.length > 0)
+ * - Self-verification: build pass = diagnostics 为空
+ */
+/** 统一诊断结构 (所有 build 工具的输出都归一化到这个格式) */
+export interface Diagnostic {
+    /** 严重级别 */
+    severity: 'error' | 'warning' | 'info';
+    /** 文件路径 (相对项目根) */
+    file: string;
+    /** 行号 (1-based) */
+    line: number;
+    /** 列号 (1-based) */
+    column: number;
+    /** 诊断消息 */
+    message: string;
+    /** 错误代码 (如 TS2345, E0308) */
+    code?: string;
+    /** 来源工具 */
+    source: string;
+}
+/** 构建结果 */
+export interface BuildResult {
+    /** 是否通过 (零 error 级别诊断) */
+    passed: boolean;
+    /** 所有诊断 */
+    diagnostics: Diagnostic[];
+    /** 执行的命令 */
+    command: string;
+    /** 退出码 */
+    exitCode: number;
+    /** 耗时 ms */
+    durationMs: number;
+}
+/** Build adapter 接口 — 每种构建工具实现一个 */
+export interface BuildAdapter {
+    /** 工具名 */
+    name: string;
+    /** 检测当前项目是否适用此 adapter (确定性: 检查配置文件存在性) */
+    detect(projectRoot: string): boolean;
+    /** 执行构建并返回结构化诊断 */
+    collect(projectRoot: string, timeoutMs?: number): Promise<BuildResult>;
+}
+/**
+ * TypeScript adapter: `tsc --noEmit --pretty false`
+ * tsc 原生格式: `file(line,col): error TSxxxx: message`
+ * 这里用 --pretty false 确保输出是 machine-parseable 单行格式。
+ */
+export declare class TypeScriptAdapter implements BuildAdapter {
+    name: string;
+    detect(projectRoot: string): boolean;
+    collect(projectRoot: string, timeoutMs?: number): Promise<BuildResult>;
+    /** 解析 tsc --pretty false 输出: `path(line,col): severity TScode: message` */
+    private parseTscOutput;
+}
+/**
+ * ESLint adapter: `eslint --format json`
+ * 输出为 JSON 数组，每项包含 messages[].
+ */
+export declare class ESLintAdapter implements BuildAdapter {
+    name: string;
+    detect(projectRoot: string): boolean;
+    collect(projectRoot: string, timeoutMs?: number): Promise<BuildResult>;
+    private parseEslintJson;
+}
+/**
+ * 统一收集器：自动检测项目类型并运行对应 adapter。
+ */
+export declare class BuildDiagnosticsCollector {
+    private readonly adapters;
+    constructor(customAdapters?: BuildAdapter[]);
+    /** 检测当前项目适用的所有 adapter */
+    detectApplicable(projectRoot: string): BuildAdapter[];
+    /** 运行所有适用的 adapter，合并诊断 */
+    collectAll(projectRoot: string, timeoutMs?: number): Promise<BuildResult[]>;
+    /** 快速判断: 运行主 build adapter, 返回是否通过 */
+    quickCheck(projectRoot: string, timeoutMs?: number): Promise<{
+        passed: boolean;
+        errorCount: number;
+        diagnostics: Diagnostic[];
+    }>;
+}
+//# sourceMappingURL=BuildDiagnosticsCollector.d.ts.map

package/dist/core/BuildDiagnosticsCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildDiagnosticsCollector.d.ts","sourceRoot":"","sources":["../../src/core/BuildDiagnosticsCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA8BH,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW;IACX,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,UAAU;IACV,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,mBAAmB;IACnB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxE;AAMD;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,IAAI,SAAS;IAEb,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAI9B,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,SAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;IAgCxF,2EAA2E;IAC3E,OAAO,CAAC,cAAc;CAmBvB;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,YAAY;IAChD,IAAI,SAAY;IAEhB,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAQ9B,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,SAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BxF,OAAO,CAAC,eAAe;CAuBxB;AAED;;GAEG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAE9B,cAAc,CAAC,EAAE,YAAY,EAAE;IAO3C,0BAA0B;IAC1B,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE;IAIrD,2BAA2B;IACrB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IASjF,sCAAsC;IAChC,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;CAUvI"}

package/dist/core/BuildDiagnosticsCollector.js

@@ -0,0 +1,200 @@
+/**
+ * BuildDiagnosticsCollector — 结构化构建诊断收集器
+ *
+ * 面向巨型项目设计：
+ * - 调用真实 build 工具，获取**结构化**输出（JSON/machine-readable 格式）
+ * - 不做关键词匹配 —— 直接解析工具原生的诊断格式
+ * - 支持 TypeScript (tsc)、ESLint、Cargo、Go、Python (mypy)
+ *
+ * 设计原则：
+ * - 确定性: 输出由 build 工具决定，不是我们猜
+ * - 可组合: 每种 build 工具是独立 adapter，返回统一 Diagnostic 结构
+ * - 增量友好: 只收集当前 build 状态，不缓存历史诊断
+ *
+ * 用途:
+ * - Worker 写完代码后调用 → 拿到精确错误位置 + 消息
+ * - Leader 据此判断 worker 是否需要重试 (不是猜，是看 diagnostics.length > 0)
+ * - Self-verification: build pass = diagnostics 为空
+ */
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+function stringOutput(value) {
+    if (typeof value === 'string')
+        return value;
+    if (Buffer.isBuffer(value))
+        return value.toString('utf-8');
+    return '';
+}
+function normalizeExecFileFailure(error) {
+    const failure = error;
+    return {
+        stdout: stringOutput(failure.stdout),
+        stderr: stringOutput(failure.stderr),
+        exitCode: typeof failure.code === 'number' ? failure.code : 1,
+    };
+}
+// PLACEHOLDER_ADAPTERS
+const DEFAULT_TIMEOUT_MS = 120_000;
+/**
+ * TypeScript adapter: `tsc --noEmit --pretty false`
+ * tsc 原生格式: `file(line,col): error TSxxxx: message`
+ * 这里用 --pretty false 确保输出是 machine-parseable 单行格式。
+ */
+export class TypeScriptAdapter {
+    name = 'tsc';
+    detect(projectRoot) {
+        return existsSync(join(projectRoot, 'tsconfig.json'));
+    }
+    async collect(projectRoot, timeoutMs = DEFAULT_TIMEOUT_MS) {
+        const start = Date.now();
+        const command = 'npx tsc --noEmit --pretty false';
+        let stdout = '';
+        let stderr = '';
+        let exitCode = 0;
+        try {
+            const result = await execFileAsync('npx', ['tsc', '--noEmit', '--pretty', 'false'], {
+                cwd: projectRoot,
+                timeout: timeoutMs,
+                maxBuffer: 10 * 1024 * 1024,
+            });
+            stdout = result.stdout;
+            stderr = result.stderr;
+        }
+        catch (err) {
+            const failure = normalizeExecFileFailure(err);
+            stdout = failure.stdout;
+            stderr = failure.stderr;
+            exitCode = failure.exitCode;
+        }
+        const diagnostics = this.parseTscOutput(stdout || stderr);
+        return {
+            passed: diagnostics.filter(d => d.severity === 'error').length === 0,
+            diagnostics,
+            command,
+            exitCode,
+            durationMs: Date.now() - start,
+        };
+    }
+    /** 解析 tsc --pretty false 输出: `path(line,col): severity TScode: message` */
+    parseTscOutput(output) {
+        const diagnostics = [];
+        const TSC_LINE_RE = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+(TS\d+):\s+(.+)$/;
+        for (const line of output.split('\n')) {
+            const match = TSC_LINE_RE.exec(line.trim());
+            if (!match)
+                continue;
+            diagnostics.push({
+                severity: match[4],
+                file: match[1],
+                line: parseInt(match[2], 10),
+                column: parseInt(match[3], 10),
+                message: match[6],
+                code: match[5],
+                source: 'tsc',
+            });
+        }
+        return diagnostics;
+    }
+}
+/**
+ * ESLint adapter: `eslint --format json`
+ * 输出为 JSON 数组，每项包含 messages[].
+ */
+export class ESLintAdapter {
+    name = 'eslint';
+    detect(projectRoot) {
+        return existsSync(join(projectRoot, '.eslintrc.json'))
+            || existsSync(join(projectRoot, '.eslintrc.js'))
+            || existsSync(join(projectRoot, '.eslintrc.cjs'))
+            || existsSync(join(projectRoot, 'eslint.config.js'))
+            || existsSync(join(projectRoot, 'eslint.config.mjs'));
+    }
+    async collect(projectRoot, timeoutMs = DEFAULT_TIMEOUT_MS) {
+        const start = Date.now();
+        const command = 'npx eslint --format json .';
+        let stdout = '';
+        let exitCode = 0;
+        try {
+            const result = await execFileAsync('npx', ['eslint', '--format', 'json', '.'], {
+                cwd: projectRoot,
+                timeout: timeoutMs,
+                maxBuffer: 10 * 1024 * 1024,
+            });
+            stdout = result.stdout;
+        }
+        catch (err) {
+            const failure = normalizeExecFileFailure(err);
+            stdout = failure.stdout;
+            exitCode = failure.exitCode;
+        }
+        const diagnostics = this.parseEslintJson(stdout);
+        return {
+            passed: diagnostics.filter(d => d.severity === 'error').length === 0,
+            diagnostics,
+            command,
+            exitCode,
+            durationMs: Date.now() - start,
+        };
+    }
+    parseEslintJson(output) {
+        const diagnostics = [];
+        try {
+            const results = JSON.parse(output);
+            for (const file of results) {
+                for (const msg of file.messages) {
+                    diagnostics.push({
+                        severity: msg.severity >= 2 ? 'error' : 'warning',
+                        file: file.filePath,
+                        line: msg.line,
+                        column: msg.column,
+                        message: msg.message,
+                        code: msg.ruleId ?? undefined,
+                        source: 'eslint',
+                    });
+                }
+            }
+        }
+        catch { /* 非 JSON 输出 = 无诊断 */ }
+        return diagnostics;
+    }
+}
+/**
+ * 统一收集器：自动检测项目类型并运行对应 adapter。
+ */
+export class BuildDiagnosticsCollector {
+    adapters;
+    constructor(customAdapters) {
+        this.adapters = customAdapters ?? [
+            new TypeScriptAdapter(),
+            new ESLintAdapter(),
+        ];
+    }
+    /** 检测当前项目适用的所有 adapter */
+    detectApplicable(projectRoot) {
+        return this.adapters.filter(a => a.detect(projectRoot));
+    }
+    /** 运行所有适用的 adapter，合并诊断 */
+    async collectAll(projectRoot, timeoutMs) {
+        const applicable = this.detectApplicable(projectRoot);
+        const results = [];
+        for (const adapter of applicable) {
+            results.push(await adapter.collect(projectRoot, timeoutMs));
+        }
+        return results;
+    }
+    /** 快速判断: 运行主 build adapter, 返回是否通过 */
+    async quickCheck(projectRoot, timeoutMs) {
+        const applicable = this.detectApplicable(projectRoot);
+        if (applicable.length === 0) {
+            return { passed: true, errorCount: 0, diagnostics: [] };
+        }
+        // 只跑第一个（通常是 tsc, 最权威的类型检查）
+        const result = await applicable[0].collect(projectRoot, timeoutMs);
+        const errors = result.diagnostics.filter(d => d.severity === 'error');
+        return { passed: errors.length === 0, errorCount: errors.length, diagnostics: errors };
+    }
+}
+//# sourceMappingURL=BuildDiagnosticsCollector.js.map

package/dist/core/BuildDiagnosticsCollector.js.map

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

package/dist/core/BundledSkillRegistry.d.ts

@@ -0,0 +1,25 @@
+import type { SkillSource } from './SkillCatalog.js';
+export interface BundledSkillRegistryEntry {
+    id: string;
+    dir: string;
+    source: SkillSource;
+    syncToGlobalByDefault: boolean;
+    description: string;
+}
+export declare function getBundledSkillsDir(): string;
+export declare function getBundledSkillRegistry(_workspace: string): BundledSkillRegistryEntry[];
+export declare function getGlobalSkillsDir(): string;
+export interface BundledSkillSyncOptions {
+    workspace: string;
+    targetDir?: string;
+    overwrite?: boolean;
+}
+export interface BundledSkillSyncResult {
+    targetDir: string;
+    copied: string[];
+    skipped: string[];
+    removed: string[];
+    missingSources: string[];
+}
+export declare function syncBundledSkillsToGlobalDir(options: BundledSkillSyncOptions): BundledSkillSyncResult;
+//# sourceMappingURL=BundledSkillRegistry.d.ts.map

package/dist/core/BundledSkillRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BundledSkillRegistry.d.ts","sourceRoot":"","sources":["../../src/core/BundledSkillRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,yBAAyB,EAAE,CAUvF;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAyBD,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAwCrG"}

package/dist/core/BundledSkillRegistry.js

@@ -0,0 +1,86 @@
+import { cpSync, existsSync, mkdirSync, readdirSync, rmSync, statSync } from 'fs';
+import { basename, dirname, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { config, CONFIG_DIR } from '../config.js';
+const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
+const RETIRED_BUNDLED_SKILLS = new Set([
+    'browser-automation',
+    'webapp-testing',
+]);
+export function getBundledSkillsDir() {
+    return process.env.LINGXIAO_BUNDLED_SKILLS_DIR || config.paths.bundled_skills_dir || resolve(MODULE_DIR, '../../skills/bundled');
+}
+export function getBundledSkillRegistry(_workspace) {
+    return [
+        {
+            id: 'package_bundled',
+            dir: getBundledSkillsDir(),
+            source: 'bundled',
+            syncToGlobalByDefault: true,
+            description: 'package-bundled default skills',
+        },
+    ];
+}
+export function getGlobalSkillsDir() {
+    return process.env.LINGXIAO_GLOBAL_SKILLS_DIR || config.paths.global_skills_dir || join(CONFIG_DIR, 'skills');
+}
+function iterSkillEntries(dir) {
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const entries = [];
+    for (const entry of readdirSync(dir)) {
+        const fullPath = join(dir, entry);
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+            const skillMd = join(fullPath, 'SKILL.md');
+            if (existsSync(skillMd)) {
+                entries.push({ name: basename(fullPath), path: fullPath, isDirectory: true });
+            }
+            continue;
+        }
+        if (stat.isFile() && entry.endsWith('.md')) {
+            entries.push({ name: entry.replace(/\.md$/, ''), path: fullPath, isDirectory: false });
+        }
+    }
+    return entries;
+}
+export function syncBundledSkillsToGlobalDir(options) {
+    const targetDir = options.targetDir || getGlobalSkillsDir();
+    const overwrite = options.overwrite === true;
+    mkdirSync(targetDir, { recursive: true });
+    const copied = [];
+    const skipped = [];
+    const removed = [];
+    const missingSources = [];
+    for (const retiredName of RETIRED_BUNDLED_SKILLS) {
+        for (const retiredPath of [join(targetDir, retiredName), join(targetDir, `${retiredName}.md`)]) {
+            if (!existsSync(retiredPath))
+                continue;
+            rmSync(retiredPath, { recursive: true, force: true });
+            removed.push(retiredName);
+        }
+    }
+    for (const entry of getBundledSkillRegistry(options.workspace)) {
+        if (!entry.syncToGlobalByDefault) {
+            continue;
+        }
+        if (!existsSync(entry.dir)) {
+            missingSources.push(entry.id);
+            continue;
+        }
+        for (const skill of iterSkillEntries(entry.dir)) {
+            const destination = skill.isDirectory
+                ? join(targetDir, skill.name)
+                : join(targetDir, `${skill.name}.md`);
+            if (existsSync(destination) && !overwrite) {
+                skipped.push(skill.name);
+                continue;
+            }
+            cpSync(skill.path, destination, { recursive: skill.isDirectory, force: overwrite });
+            copied.push(skill.name);
+        }
+    }
+    return { targetDir, copied, skipped, removed: [...new Set(removed)], missingSources };
+}
+//# sourceMappingURL=BundledSkillRegistry.js.map

package/dist/core/BundledSkillRegistry.js.map

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

package/dist/core/BusMessageTypes.d.ts

@@ -0,0 +1,109 @@
+/**
+ * BusMessage 判别联合 — 广播消息的完全结构化类型层。
+ *
+ * 取代旧的 `{ type: string; payload: unknown }`:
+ *  - `type` 是字符串字面量联合(单一事实源),typo(如 'task_complte')编译期直接报错。
+ *  - `payload` 按 type 精确收窄:发送 `send(..., 'task_complete', x)` 时 x 必须是 TaskCompletePayload;
+ *    消费 `switch(message.type)` 后 payload 自动 narrow,消灭散落的 `as` 转型。
+ *
+ * 设计权衡:
+ *  - 6 个控制类 payload 复用 AgentProtocol.ts 已有 interface(单一事实源)。
+ *  - `message`/`user_intervention` 的 payload 真正多态(string | MessageContent | 对象 | team 协议),
+ *    用显式联合诚实建模,消费侧 typeof/in narrow —— 比 unknown 严格得多。
+ *  - `parseBusMessage` 是反序列化守卫(transport/IPC 逃逸口用),只校验 type 字面量合法 + 信封字段;
+ *    payload 形状 best-effort(多态 type 无法在守卫里强校验)。
+ *
+ * 注意:不要用 `Pick<BusMessage,'type'|'payload'>` 作函数入参 —— 会把判别联合拍扁成宽联合,丢失 narrow。
+ * 消费侧请传完整 `BusMessage`。
+ */
+import type { TaskCompletePayload, TaskFailedPayload, PermissionRequestControlPayload, PermissionResponsePayload, AgentHealthCriticalPayload, WorkerRecoveryPayload, ToolFailureLoopEscalationControlPayload } from './AgentProtocol.js';
+import type { TeamProtocolMessage } from './TeamProtocol.js';
+import type { MessageContent } from '../contracts/types/Message.js';
+import type { RemoteWorkerDescriptor } from './transport/RemoteWorkerRegistry.js';
+export type BusMessageType = 'task_complete' | 'task_failed' | 'worker_recovery' | 'permission_request' | 'permission_response' | 'agent_health_critical' | 'tool_failure_loop_escalation' | 'user_intervention' | 'message' | 'force_terminate' | 'intervene' | 'control' | 'system_context' | 'supervision_probe' | 'request_work_note' | 'eternal_goal_set' | 'worker_register';
+/** `message` type 的 payload:自由文本 / 富文本 / 会话定向消息 / team 协议封装。 */
+export type MessagePayload = string | MessageContent | {
+    sessionId: string;
+    content: string;
+} | {
+    _protocol: 'team';
+    message: TeamProtocolMessage;
+};
+/** `user_intervention` type 的 payload:自由文本 / 富文本 / 系统通知封装。 */
+export type UserInterventionPayload = string | MessageContent | {
+    _system_notice: true;
+    kind: 'task:failed' | 'task:cancelled';
+    taskId: string;
+    content: string;
+};
+export interface ForceTerminatePayload {
+    reason: string;
+    taskId: string;
+}
+export interface IntervenePayload {
+    sessionId: string;
+    content: string;
+    instruction?: string;
+}
+export interface ControlPayload {
+    action: 'nudge' | 'redirect' | 'retry_llm' | 'swap_model' | 'compact_context';
+    reason?: string;
+    message?: string;
+    model?: string;
+    newModel?: string;
+}
+export interface SupervisionProbePayload {
+    kind: 'agent_health_report';
+    source: string;
+    timestamp: number;
+    decisions: unknown[];
+}
+export interface RequestWorkNotePayload {
+    sessionId: string;
+    requesterAgentId: string;
+}
+export interface EternalGoalSetPayload {
+    goal: string;
+}
+export interface BusMessagePayloadMap {
+    task_complete: TaskCompletePayload;
+    task_failed: TaskFailedPayload;
+    worker_recovery: WorkerRecoveryPayload;
+    permission_request: PermissionRequestControlPayload;
+    permission_response: PermissionResponsePayload;
+    agent_health_critical: AgentHealthCriticalPayload;
+    tool_failure_loop_escalation: ToolFailureLoopEscalationControlPayload;
+    user_intervention: UserInterventionPayload;
+    message: MessagePayload;
+    force_terminate: ForceTerminatePayload;
+    intervene: IntervenePayload;
+    control: ControlPayload;
+    system_context: string;
+    supervision_probe: SupervisionProbePayload;
+    request_work_note: RequestWorkNotePayload;
+    eternal_goal_set: EternalGoalSetPayload;
+    worker_register: RemoteWorkerDescriptor;
+}
+export interface BusMessageEnvelope {
+    id: string;
+    from: string;
+    to: string;
+    timestamp: number;
+    seq?: number;
+    traceId?: string;
+    parentSpanId?: string;
+}
+export type BusMessage = BusMessageEnvelope & {
+    [K in BusMessageType]: {
+        type: K;
+        payload: BusMessagePayloadMap[K];
+    };
+}[BusMessageType];
+export declare function isBusMessageType(type: unknown): type is BusMessageType;
+/**
+ * 从未知来源(transport/IPC 跨进程)解析 BusMessage。
+ * 校验:type ∈ 已知集合 + 信封字段齐全。payload 形状 best-effort(多态 type 不强校验)。
+ * 不合法返回 null(调用方丢弃),合法返回窄化为 BusMessage 的对象。
+ */
+export declare function parseBusMessage(raw: unknown): BusMessage | null;
+//# sourceMappingURL=BusMessageTypes.d.ts.map

package/dist/core/BusMessageTypes.d.ts.map

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

package/dist/core/BusMessageTypes.js

@@ -0,0 +1,49 @@
+/**
+ * BusMessage 判别联合 — 广播消息的完全结构化类型层。
+ *
+ * 取代旧的 `{ type: string; payload: unknown }`:
+ *  - `type` 是字符串字面量联合(单一事实源),typo(如 'task_complte')编译期直接报错。
+ *  - `payload` 按 type 精确收窄:发送 `send(..., 'task_complete', x)` 时 x 必须是 TaskCompletePayload;
+ *    消费 `switch(message.type)` 后 payload 自动 narrow,消灭散落的 `as` 转型。
+ *
+ * 设计权衡:
+ *  - 6 个控制类 payload 复用 AgentProtocol.ts 已有 interface(单一事实源)。
+ *  - `message`/`user_intervention` 的 payload 真正多态(string | MessageContent | 对象 | team 协议),
+ *    用显式联合诚实建模,消费侧 typeof/in narrow —— 比 unknown 严格得多。
+ *  - `parseBusMessage` 是反序列化守卫(transport/IPC 逃逸口用),只校验 type 字面量合法 + 信封字段;
+ *    payload 形状 best-effort(多态 type 无法在守卫里强校验)。
+ *
+ * 注意:不要用 `Pick<BusMessage,'type'|'payload'>` 作函数入参 —— 会把判别联合拍扁成宽联合,丢失 narrow。
+ * 消费侧请传完整 `BusMessage`。
+ */
+// ── 7. 反序列化守卫(堵 transport/IPC 逃逸口) ───────────────────────
+const BUS_MESSAGE_TYPES = new Set([
+    'task_complete', 'task_failed', 'worker_recovery', 'permission_request',
+    'permission_response', 'agent_health_critical', 'tool_failure_loop_escalation', 'user_intervention', 'message',
+    'force_terminate', 'intervene', 'control', 'system_context', 'supervision_probe',
+    'request_work_note', 'eternal_goal_set', 'worker_register',
+]);
+export function isBusMessageType(type) {
+    return typeof type === 'string' && BUS_MESSAGE_TYPES.has(type);
+}
+/**
+ * 从未知来源(transport/IPC 跨进程)解析 BusMessage。
+ * 校验:type ∈ 已知集合 + 信封字段齐全。payload 形状 best-effort(多态 type 不强校验)。
+ * 不合法返回 null(调用方丢弃),合法返回窄化为 BusMessage 的对象。
+ */
+export function parseBusMessage(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const m = raw;
+    if (typeof m.id !== 'string' ||
+        typeof m.from !== 'string' ||
+        typeof m.to !== 'string' ||
+        typeof m.type !== 'string' ||
+        !Object.prototype.hasOwnProperty.call(m, 'payload') ||
+        typeof m.timestamp !== 'number' ||
+        !BUS_MESSAGE_TYPES.has(m.type)) {
+        return null;
+    }
+    return { ...m };
+}
+//# sourceMappingURL=BusMessageTypes.js.map

package/dist/core/BusMessageTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BusMessageTypes.js","sourceRoot":"","sources":["../../src/core/BusMessageTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqHH,4DAA4D;AAC5D,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAiB;IACrE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB;IACvE,qBAAqB,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,SAAS;IAC9G,iBAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,mBAAmB;IAChF,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB;CAC3D,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,IACE,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC;QACnD,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAC9B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,GAAG,CAAC,EAA2B,CAAC;AAC3C,CAAC"}