@feiyoug/skill-lab 0.0.0

package/script/skillreader/types.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillReader = void 0;
+const mod_js_1 = require("../deps/jsr.io/@std/yaml/1.0.11/mod.js");
+const frontmatter_parser_js_1 = require("./utils/frontmatter-parser.js");
+class SkillReader {
+    constructor() {
+        /**
+         * A cached path to the root SKILL.md file in this skill repository
+         */
+        Object.defineProperty(this, "skillMdPatah", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: undefined
+        });
+        /**
+         * A cached list of files in this skill repository.
+         */
+        Object.defineProperty(this, "files", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: undefined
+        });
+        /**
+         * A cached parsed SKILL.md frontmatter.
+         */
+        Object.defineProperty(this, "skillFrontMatter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: undefined
+        });
+    }
+    async listFiles() {
+        if (!this.files) {
+            this.files = await this.retrieveFiles();
+        }
+        return this.files;
+    }
+    /**
+     * Return the path to SKILL.md if it exists, or throw if not.
+     */
+    async getSkillMdPath() {
+        if (this.skillMdPatah)
+            return this.skillMdPatah;
+        const files = await this.retrieveFiles();
+        const rootPath = files.find((file) => file.path.toLowerCase() === "skill.md");
+        if (!rootPath?.path) {
+            throw new Error("Invalid skill repository: SKILL.md not found");
+        }
+        this.skillMdPatah = rootPath.path;
+        return this.skillMdPatah;
+    }
+    /**
+     * Returns full SKILL.md content, or throws when the repository is not a valid skill.
+     */
+    async getSkillMdContent() {
+        const skillMdPath = await this.getSkillMdPath();
+        const content = await this.readTextFile(skillMdPath);
+        if (!content) {
+            throw new Error("Invalid skill repository: SKILL.md is unreadable");
+        }
+        return content;
+    }
+    /**
+     * Parses SKILL.md frontmatter and guarantees required fields.
+     */
+    async getSkillMdFrontmatter() {
+        if (this.skillFrontMatter)
+            return this.skillFrontMatter;
+        const content = await this.getSkillMdContent();
+        const frontmatter = await (0, frontmatter_parser_js_1.extractFrontmatter)(content);
+        if (!frontmatter) {
+            throw new Error("Invalid skill repository: SKILL.md missing YAML frontmatter");
+        }
+        let parsed;
+        try {
+            parsed = (0, mod_js_1.parse)(frontmatter.content) ??
+                {};
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Invalid skill repository: YAML frontmatter parse failed: ${message}`);
+        }
+        if (!parsed.name || !parsed.description) {
+            throw new Error("Invalid skill repository: frontmatter requires name and description");
+        }
+        parsed.startLineNumer = frontmatter.startLine;
+        parsed.endLineNumer = frontmatter.endLine;
+        this.skillFrontMatter = parsed;
+        return this.skillFrontMatter;
+    }
+    async validate() {
+        try {
+            await this.getSkillMdFrontmatter();
+            return { ok: true };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { ok: false, reason: message };
+        }
+    }
+}
+exports.SkillReader = SkillReader;

package/script/skillreader/utils/frontmatter-parser.d.ts

@@ -0,0 +1,7 @@
+export type FrontmatterInfo = {
+    content: string;
+    startLine: number;
+    endLine: number;
+};
+export declare function extractFrontmatter(content: string): Promise<FrontmatterInfo | null>;
+//# sourceMappingURL=frontmatter-parser.d.ts.map

package/script/skillreader/utils/frontmatter-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-parser.d.ts","sourceRoot":"","sources":["../../../src/skillreader/utils/frontmatter-parser.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,eAAe,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAMF,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAwBzF"}

package/script/skillreader/utils/frontmatter-parser.js

@@ -0,0 +1,87 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractFrontmatter = extractFrontmatter;
+let parserInstance = null;
+async function extractFrontmatter(content) {
+    try {
+        const parser = await getParser();
+        const tree = parser.parse(content);
+        const frontmatterNode = findFrontmatterNode(tree.rootNode);
+        if (!frontmatterNode)
+            return null;
+        const matched = frontmatterNode.text.match(/^---\n([\s\S]*?)\n---/);
+        if (!matched)
+            return null;
+        return {
+            content: matched[1],
+            startLine: frontmatterNode.startPosition.row + 1,
+            endLine: frontmatterNode.endPosition.row + 1,
+        };
+    }
+    catch {
+        const matched = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!matched)
+            return null;
+        return {
+            content: matched[1],
+            startLine: 1,
+            endLine: matched[0].split("\n").length,
+        };
+    }
+}
+function findFrontmatterNode(node) {
+    if (node.type.includes("yaml") && node.startPosition.row === 0) {
+        return node;
+    }
+    for (const child of node.children) {
+        const found = findFrontmatterNode(child);
+        if (found)
+            return found;
+    }
+    return null;
+}
+async function getParser() {
+    if (parserInstance)
+        return parserInstance;
+    const [{ default: Parser }, markdownModule] = await Promise.all([
+        Promise.resolve().then(() => __importStar(require("tree-sitter"))),
+        Promise.resolve().then(() => __importStar(require("@tree-sitter-grammars/tree-sitter-markdown"))),
+    ]);
+    const parser = new Parser();
+    parser.setLanguage((markdownModule.default ?? markdownModule));
+    parserInstance = parser;
+    return parser;
+}

package/script/skillreader/utils/http-range.d.ts

@@ -0,0 +1,4 @@
+export declare function fetchContentLength(url: string): Promise<number>;
+export declare function fetchRangeStream(url: string, start: number, length: number): Promise<ReadableStream<Uint8Array>>;
+export declare function decompressDeflateStream(stream: ReadableStream<Uint8Array>): ReadableStream<Uint8Array>;
+//# sourceMappingURL=http-range.d.ts.map

package/script/skillreader/utils/http-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-range.d.ts","sourceRoot":"","sources":["../../../src/skillreader/utils/http-range.ts"],"names":[],"mappings":"AAIA,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUrE;AAED,wBAAsB,gBAAgB,CAClC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAQrC;AAED,wBAAgB,uBAAuB,CACnC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,cAAc,CAAC,UAAU,CAAC,CAK5B"}

package/script/skillreader/utils/http-range.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchContentLength = fetchContentLength;
+exports.fetchRangeStream = fetchRangeStream;
+exports.decompressDeflateStream = decompressDeflateStream;
+const node_stream_1 = require("node:stream");
+const node_zlib_1 = require("node:zlib");
+async function fetchContentLength(url) {
+    const res = await fetch(url, { method: "HEAD" });
+    if (!res.ok) {
+        throw new Error(`HEAD ${url} failed: ${res.status} ${res.statusText}`);
+    }
+    const len = res.headers.get("content-length");
+    if (!len)
+        throw new Error("No content-length header");
+    const size = Number.parseInt(len, 10);
+    if (Number.isNaN(size))
+        throw new Error(`Invalid content-length: ${len}`);
+    return size;
+}
+async function fetchRangeStream(url, start, length) {
+    const end = start + length - 1;
+    const range = `bytes=${start}-${end}`;
+    const res = await fetch(url, { headers: { Range: range } });
+    if (!res.ok || !res.body) {
+        throw new Error(`Range read failed: ${res.status} ${res.statusText}`);
+    }
+    return res.body;
+}
+function decompressDeflateStream(stream) {
+    const nodeStream = node_stream_1.Readable.fromWeb(stream);
+    const inflater = (0, node_zlib_1.createInflateRaw)();
+    const decompressed = nodeStream.pipe(inflater);
+    return node_stream_1.Readable.toWeb(decompressed);
+}

package/script/skillreader/utils/mod.d.ts

@@ -0,0 +1,4 @@
+export declare function isProbablyText(bytes: Uint8Array): boolean;
+export * from "./frontmatter-parser.js";
+export * from "./http-range.js";
+//# sourceMappingURL=mod.d.ts.map

package/script/skillreader/utils/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/skillreader/utils/mod.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAQzD;AAED,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC"}

package/script/skillreader/utils/mod.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isProbablyText = isProbablyText;
+function isProbablyText(bytes) {
+    const sample = bytes.subarray(0, Math.min(bytes.length, 2048));
+    let controlCount = 0;
+    for (const byte of sample) {
+        if (byte === 0)
+            return false;
+        if (byte < 9 || (byte > 13 && byte < 32))
+            controlCount += 1;
+    }
+    return controlCount / Math.max(sample.length, 1) < 0.1;
+}
+__exportStar(require("./frontmatter-parser.js"), exports);
+__exportStar(require("./http-range.js"), exports);