@cicctencent/agent-core 1.0.17 → 1.0.18

package/dist/esm/skill/frontmatter.js

@@ -0,0 +1,326 @@
+// ============================================================
+// 轻量 YAML Frontmatter 解析器
+// ============================================================
+// 支持 Agent Skills 规范（agentskills.io）所需的 YAML 子集：
+//   - 单行标量:        `key: value`
+//   - 带引号字符串:     `key: "value"` / `key: 'value'`
+//   - 多行折叠:        `key: >-` / `key: >`（换行折叠为空格）
+//   - 多行保留:        `key: |-` / `key: |`（保留换行）
+//   - 嵌套 map（一层）: `metadata:` 后跟缩进的 `sub: value`
+//   - 行内数组:        `key: [a, b, c]`
+//   - 块状数组:        `key:` 后跟 `- item` 行
+//   - 数字/布尔/null 自动转型（version: 1.1.0 这类保留为字符串）
+//
+// 设计目标：零依赖、行为可预期、对非法输入降级为字符串而非抛错。
+// ============================================================
+/** 统计行首空格数（tab 按 2 空格计） */
+function countIndent(line) {
+    let n = 0;
+    for (const ch of line) {
+        if (ch === ' ')
+            n += 1;
+        else if (ch === '\t')
+            n += 2;
+        else
+            break;
+    }
+    return n;
+}
+/** 去除行内注释（仅在值非引号包裹且 # 前有空格时） */
+function stripInlineComment(value) {
+    const trimmed = value.trim();
+    if (trimmed.startsWith('"') || trimmed.startsWith("'"))
+        return value;
+    const idx = value.indexOf(' #');
+    return idx > 0 ? value.substring(0, idx) : value;
+}
+/** 解析标量：引号字符串 / 数字 / 布尔 / null / 行内数组 / 普通字符串 */
+function parseScalar(raw) {
+    const v = stripInlineComment(raw).trim();
+    if (v === '')
+        return '';
+    // 行内数组 [a, b, c]
+    if (v.startsWith('[') && v.endsWith(']')) {
+        return parseInlineArray(v);
+    }
+    // 双引号
+    if (v.startsWith('"') && v.endsWith('"') && v.length >= 2) {
+        return v.slice(1, -1).replace(/\\"/g, '"').replace(/\\n/g, '\n');
+    }
+    // 单引号
+    if (v.startsWith("'") && v.endsWith("'") && v.length >= 2) {
+        return v.slice(1, -1).replace(/''/g, "'");
+    }
+    // null / 空
+    if (v === 'null' || v === '~')
+        return null;
+    // 布尔
+    if (v === 'true')
+        return true;
+    if (v === 'false')
+        return false;
+    // 数字（严格整数或小数；version: 1.1.0 不匹配，保留字符串）
+    if (/^-?\d+$/.test(v))
+        return parseInt(v, 10);
+    if (/^-?\d+\.\d+$/.test(v))
+        return parseFloat(v);
+    // 普通字符串
+    return v;
+}
+/** 解析行内数组 `[a, b, "c,d"]`，支持引号内逗号 */
+function parseInlineArray(v) {
+    const inner = v.slice(1, -1).trim();
+    if (!inner)
+        return [];
+    const items = [];
+    let cur = '';
+    let inQuote = null;
+    for (let i = 0; i < inner.length; i++) {
+        const ch = inner[i];
+        if (inQuote) {
+            if (ch === inQuote && inner[i - 1] !== '\\')
+                inQuote = null;
+            else
+                cur += ch;
+        }
+        else if (ch === '"' || ch === "'") {
+            inQuote = ch;
+        }
+        else if (ch === ',') {
+            if (cur.trim())
+                items.push(cur.trim());
+            cur = '';
+        }
+        else {
+            cur += ch;
+        }
+    }
+    if (cur.trim())
+        items.push(cur.trim());
+    return items;
+}
+/**
+ * 读取多行标量（`>` 折叠 / `|` 保留），从 startIdx 开始读取所有缩进续行。
+ * 返回解析后的字符串与下一待处理行索引。
+ */
+function readMultiline(lines, startIdx, folded, keepTrailingNewline) {
+    const collected = [];
+    let i = startIdx;
+    let baseIndent = -1;
+    while (i < lines.length) {
+        const line = lines[i];
+        const indent = countIndent(line);
+        // 遇到非空且顶格的行 → 多行块结束
+        if (line.trim() !== '' && indent === 0)
+            break;
+        if (line.trim() !== '') {
+            if (baseIndent === -1)
+                baseIndent = indent;
+            collected.push(line.substring(Math.min(baseIndent, line.length)));
+        }
+        else {
+            collected.push('');
+        }
+        i++;
+    }
+    // 去除尾部空行
+    while (collected.length > 0 && collected[collected.length - 1] === '') {
+        collected.pop();
+    }
+    let value;
+    if (folded) {
+        // 折叠：单换行变空格，空行变换行
+        const out = [];
+        for (let k = 0; k < collected.length; k++) {
+            const cur = collected[k];
+            if (cur === '') {
+                out.push('\n');
+            }
+            else {
+                out.push(cur);
+                const nextLine = collected[k + 1];
+                if (nextLine !== undefined && nextLine !== '')
+                    out.push(' ');
+            }
+        }
+        value = out.join('');
+    }
+    else {
+        value = collected.join('\n');
+    }
+    if (keepTrailingNewline)
+        value += '\n';
+    return { value, next: i };
+}
+/**
+ * 读取嵌套结构（缩进的 map 或块状数组），从 startIdx 开始。
+ * 返回嵌套对象/数组与下一待处理行索引。
+ */
+function readNested(lines, startIdx) {
+    // 探测：找到第一个非空缩进行，判断是 map（含冒号）还是数组（- 开头）
+    let i = startIdx;
+    let baseIndent = -1;
+    const blockLines = [];
+    while (i < lines.length) {
+        const line = lines[i];
+        const indent = countIndent(line);
+        if (line.trim() !== '' && indent === 0)
+            break;
+        if (line.trim() !== '') {
+            if (baseIndent === -1)
+                baseIndent = indent;
+            blockLines.push(line.substring(Math.min(baseIndent, line.length)));
+        }
+        else {
+            blockLines.push('');
+        }
+        i++;
+    }
+    const firstMeaningful = blockLines.find(l => l.trim() !== '');
+    if (firstMeaningful === undefined) {
+        return { value: null, next: i };
+    }
+    // 块状数组（- item）
+    if (firstMeaningful.trim().startsWith('- ')) {
+        const arr = blockLines
+            .map(l => l.trim())
+            .filter(l => l.startsWith('- '))
+            .map(l => parseScalar(l.substring(2)))
+            .map(v => (typeof v === 'string' ? v : String(v)));
+        return { value: arr, next: i };
+    }
+    // 嵌套 map
+    if (firstMeaningful.includes(':')) {
+        const obj = {};
+        let j = 0;
+        while (j < blockLines.length) {
+            const l = blockLines[j];
+            if (l.trim() === '') {
+                j++;
+                continue;
+            }
+            const m = l.match(/^([A-Za-z0-9_-]+)\s*:\s*(.*)$/);
+            if (!m) {
+                j++;
+                continue;
+            }
+            const subKey = m[1];
+            const subRest = m[2];
+            if (subRest === '>' || subRest === '>-' || subRest === '|' || subRest === '|-') {
+                const folded = subRest.startsWith('>');
+                const { value, next } = readMultiline(blockLines, j + 1, folded, subRest === '|');
+                obj[subKey] = value;
+                j = next;
+                continue;
+            }
+            if (subRest === '') {
+                const { value, next } = readNested(blockLines, j + 1);
+                obj[subKey] = value;
+                j = next;
+                continue;
+            }
+            obj[subKey] = parseScalar(subRest);
+            j++;
+        }
+        return { value: obj, next: i };
+    }
+    // 无法识别 → 返回 null
+    return { value: null, next: i };
+}
+/** 解析 YAML 块为键值对象 */
+function parseYamlBlock(block) {
+    const lines = block.split('\n');
+    const root = {};
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (line.trim() === '' || line.trim().startsWith('#')) {
+            i++;
+            continue;
+        }
+        const indent = countIndent(line);
+        if (indent !== 0) {
+            i++;
+            continue;
+        }
+        const m = line.match(/^([A-Za-z0-9_-]+)\s*:\s*(.*)$/);
+        if (!m) {
+            i++;
+            continue;
+        }
+        const key = m[1];
+        const rest = m[2].trimEnd();
+        if (rest === '>' || rest === '>-' || rest === '|' || rest === '|-') {
+            const folded = rest.startsWith('>');
+            const { value, next } = readMultiline(lines, i + 1, folded, rest === '|');
+            root[key] = value;
+            i = next;
+            continue;
+        }
+        if (rest === '') {
+            const { value, next } = readNested(lines, i + 1);
+            root[key] = value;
+            i = next;
+            continue;
+        }
+        root[key] = parseScalar(rest);
+        i++;
+    }
+    return root;
+}
+/**
+ * 解析含 frontmatter 的 Markdown 文本。
+ * 无 frontmatter 时返回 `{ data: {}, body: raw }`。
+ */
+export function parseFrontmatter(raw) {
+    const normalized = (raw || '').replace(/\r\n/g, '\n');
+    const match = normalized.match(/^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/);
+    if (!match) {
+        return { data: {}, body: raw };
+    }
+    return { data: parseYamlBlock(match[1]), body: match[2] };
+}
+// ---- 字段读取辅助（统一处理命名变体与类型） ----
+/** 读取字符串字段（兼容下划线/驼峰命名），缺失返回 '' */
+export function fmString(data, ...keys) {
+    for (const k of keys) {
+        const v = data[k];
+        if (v === undefined || v === null)
+            continue;
+        return typeof v === 'string' ? v : String(v);
+    }
+    return '';
+}
+/** 读取字符串数组字段（兼容数组/逗号分隔/行内数组），缺失返回 [] */
+export function fmStringArray(data, ...keys) {
+    for (const k of keys) {
+        const v = data[k];
+        if (v === undefined || v === null)
+            continue;
+        if (Array.isArray(v))
+            return v.map(String).filter(Boolean);
+        if (typeof v === 'string') {
+            const s = v.trim();
+            if (!s)
+                return [];
+            if (s.startsWith('[')) {
+                try {
+                    return parseInlineArray(s);
+                }
+                catch { /* fallthrough */ }
+            }
+            return s.split(',').map(t => t.trim()).filter(Boolean);
+        }
+        return [String(v)];
+    }
+    return [];
+}
+/** 读取嵌套 map 字段（metadata），缺失返回 undefined */
+export function fmMap(data, key) {
+    const v = data[key];
+    if (v && typeof v === 'object' && !Array.isArray(v)) {
+        return v;
+    }
+    return undefined;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/esm/skill/frontmatter.js.map

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

package/dist/esm/skill/manager.d.ts

@@ -1,4 +1,4 @@
-import type { Skill, SkillManifest, SkillSource } from './types.js';
+import type { Skill, SkillManifest, SkillSource, SkillResources } from './types.js';
 /** 懒加载配置 */
 interface LazyLoadConfig {
     /** content LRU 缓存容量（默认 30） */
@@ -37,6 +37,13 @@ export declare class SkillManager {
      * - lazy=false（默认）：全量读取，保持向后兼容
      */
     loadFromDir(dir: string, source: SkillSource, connectorId?: string): void;
+    /** 扫描目录包的资源清单（scripts/ references/ assets/），返回相对路径（POSIX 风格） */
+    static scanPackageResources(packageDir: string): SkillResources;
+    /**
+     * 加载单个标准目录包（含 SKILL.md 的目录）。
+     * 自动扫描资源目录并注册资源清单。
+     */
+    loadPackageDir(packageDir: string, source: SkillSource, connectorId?: string): void;
     /** 手动注册 Skill（全量，含 content） */
     register(skill: Skill): void;
     /**
@@ -81,6 +88,24 @@ export declare class SkillManager {
         cachedContentCount: number;
         lazyMode: boolean;
     };
+    /**
+     * 注册 Skill 包的资源清单与根目录（标准目录包形态）。
+     * 供管理端注入运行时 Skill 时调用，或 loadFromDir 扫描目录包时自动调用。
+     */
+    registerPackageResources(skillId: string, resources: SkillResources, packageDir: string): void;
+    /** 列出 Skill 的资源清单（无则返回 null） */
+    listResources(skillIdOrName: string): SkillResources | null;
+    /**
+     * 按需加载 Skill 资源文件文本内容（references/ assets/ 等）。
+     * 仅允许读取 packageDir 内的文件，含路径穿越防护。
+     */
+    loadResource(skillIdOrName: string, resourcePath: string): string | null;
+    /** 获取资源文件绝对路径（供执行/二进制读取），含路径穿越防护 */
+    resolveResourcePathByName(skillIdOrName: string, resourcePath: string): string | null;
+    /** 解析脚本绝对路径（scripts/ 下），供脚本执行工具调用 */
+    resolveScriptPath(skillIdOrName: string, scriptRel: string): string | null;
+    /** 内部：解析并校验资源路径，确保位于 packageDir 内（防路径穿越） */
+    private resolveResourcePath;
     /** 重新加载（文件变更后刷新） */
     reload(): void;
     /**
@@ -97,15 +122,17 @@ export declare class SkillManager {
     private toManifest;
     /**
      * 仅解析 front matter（不读 content），用于懒加载模式
-     * 通过读取文件前 N 字节提取 YAML front matter，避免加载整个文件
+     * 通过读取文件前 32KB 提取 YAML front matter，避免加载整个文件。
+     * 使用标准解析器，兼容嵌套 map / 多行折叠语法。
      */
     private parseManifest;
+    /**
+     * 由解析后的 frontmatter data 构建 SkillManifest（公共逻辑，parse/parseManifest 复用）。
+     * content 字段由调用方按需补充（parse 全量 / parseManifest 仅清单）。
+     */
+    private buildManifest;
     /** 解析完整的 Markdown 文件（含 content），用于兼容模式 */
     private parse;
-    /** 解析 referenced_skills 字段 */
-    private parseReferencedSkills;
-    private extractField;
-    private parseTags;
 }
 export {};
 //# sourceMappingURL=manager.d.ts.map

package/dist/esm/skill/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/skill/manager.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAiDpE,YAAY;AACZ,UAAU,cAAc;IACtB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB,wCAAwC;IACxC,OAAO,CAAC,SAAS,CAAoC;IACrD;;;OAGG;IACH,OAAO,CAAC,SAAS,CAA6B;IAC9C,+BAA+B;IAC/B,OAAO,CAAC,YAAY,CAAmB;IACvC,cAAc;IACd,OAAO,CAAC,IAAI,CAAU;IACtB,wBAAwB;IACxB,OAAO,CAAC,UAAU,CAAyE;gBAE/E,MAAM,CAAC,EAAE,cAAc;IAKnC;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAItE;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMnE;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAqDzE,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAQ5B;;;OAGG;IACH,OAAO,CAAC,aAAa;IASrB,eAAe;IACf,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAY5B;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAmBlC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIlD;;;OAGG;IACH,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,oBAAoB;IAS5B;;;OAGG;IACH,eAAe,IAAI,aAAa,EAAE;IAIlC,qCAAqC;IACrC,MAAM,IAAI,KAAK,EAAE;IAIjB,YAAY;IACZ,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE;IAM9B,sBAAsB;IACtB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAYlC,eAAe;IACf,aAAa,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE;IAQzF,oBAAoB;IACpB,MAAM,IAAI,IAAI;IAad;;;OAGG;IACH,OAAO,CAAC,WAAW;IAiBnB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAY/B,iCAAiC;IACjC,OAAO,CAAC,UAAU;IASlB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAyDrB,0CAA0C;IAC1C,OAAO,CAAC,KAAK;IA8Cb,8BAA8B;IAC9B,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,SAAS;CASlB"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/skill/manager.ts"],"names":[],"mappings":"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"}