@feiyoug/skill-lab 0.0.0

package/script/skillreader/cloudStorage/mod.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudStorageSkillReader = void 0;
+const mod_js_1 = require("../utils/mod.js");
+const types_js_1 = require("../types.js");
+const manifest_js_1 = require("../manifest.js");
+const http_range_js_1 = require("../utils/http-range.js");
+const mod_js_2 = require("../../shared/mod.js");
+/**
+ * ZIP local file header signature (magic number: 0x04034b50).
+ */
+const LOCAL_FILE_HEADER_SIGNATURE = 0x04034b50;
+/**
+ * ZIP local file header fixed section length in bytes.
+ */
+const LOCAL_FILE_HEADER_LENGTH = 30;
+/**
+ * Reader for skill-lab backend cloud storage (public CDN).
+ */
+class CloudStorageSkillReader extends types_js_1.SkillReader {
+    constructor(options) {
+        super();
+        Object.defineProperty(this, "baseUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "cachedManifest", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "dataOffsetCache", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    }
+    async retrieveFiles(dir) {
+        const manifest = await this.readManifest();
+        if (!manifest) {
+            throw new Error("Manifest not found at storage URL");
+        }
+        const targetPrefix = dir ? normalizePrefix(dir) : "";
+        return manifest.files
+            .filter((file) => {
+            if (!targetPrefix)
+                return true;
+            return file.path.startsWith(`${targetPrefix}/`);
+        })
+            .map((file) => ({
+            path: file.path,
+            size: file.size,
+            contentType: (0, mod_js_2.getFileType)(file.path),
+        }));
+    }
+    async readTextFile(path) {
+        const contentType = (0, mod_js_2.getFileType)(path);
+        if (contentType === "binary")
+            return null;
+        const stream = await this.readFile(path);
+        if (!stream)
+            return null;
+        const buffer = new Uint8Array(await new Response(stream).arrayBuffer());
+        if (!(0, mod_js_1.isProbablyText)(buffer))
+            return null;
+        return new TextDecoder().decode(buffer);
+    }
+    async readFile(path) {
+        const manifest = await this.readManifest();
+        if (!manifest)
+            return null;
+        if ((0, manifest_js_1.isZipManifest)(manifest)) {
+            return await this.readFileFromZip(path, manifest);
+        }
+        const fileUrl = `${this.baseUrl}/${path.replace(/^\/+/, "")}`;
+        try {
+            const response = await fetch(fileUrl);
+            if (!response.ok)
+                return null;
+            return response.body;
+        }
+        catch {
+            return null;
+        }
+    }
+    async readManifest() {
+        if (this.cachedManifest)
+            return this.cachedManifest;
+        const manifestUrl = `${this.baseUrl}/manifest.json`;
+        try {
+            const response = await fetch(manifestUrl);
+            if (!response.ok)
+                return null;
+            const text = await response.text();
+            const manifest = (0, manifest_js_1.parseSkillManifest)(text);
+            this.cachedManifest = manifest;
+            return manifest;
+        }
+        catch {
+            return null;
+        }
+    }
+    async readFileFromZip(path, manifest) {
+        const normalizedPath = path.replace(/^\/+/, "");
+        const fileEntry = manifest.files.find((file) => file.path === normalizedPath);
+        if (!fileEntry)
+            return null;
+        const zipUrl = `${this.baseUrl}/skill.zip`;
+        const dataOffset = await this.getDataOffset(zipUrl, fileEntry);
+        const rangeStream = await (0, http_range_js_1.fetchRangeStream)(zipUrl, dataOffset, fileEntry.compressedSize);
+        if (fileEntry.compressionMethod === 0) {
+            return rangeStream;
+        }
+        if (fileEntry.compressionMethod === 8) {
+            return (0, http_range_js_1.decompressDeflateStream)(rangeStream);
+        }
+        throw new Error(`Unsupported compression: ${fileEntry.compressionMethod}`);
+    }
+    async getDataOffset(zipUrl, fileEntry) {
+        const cached = this.dataOffsetCache.get(fileEntry.path);
+        if (cached !== undefined)
+            return cached;
+        const headerStream = await (0, http_range_js_1.fetchRangeStream)(zipUrl, fileEntry.offset, LOCAL_FILE_HEADER_LENGTH);
+        const headerBuffer = new Uint8Array(await new Response(headerStream).arrayBuffer());
+        if (headerBuffer.byteLength < LOCAL_FILE_HEADER_LENGTH) {
+            throw new Error("Failed to read ZIP header");
+        }
+        const view = new DataView(headerBuffer.buffer, headerBuffer.byteOffset, headerBuffer.byteLength);
+        const signature = view.getUint32(0, true);
+        if (signature !== LOCAL_FILE_HEADER_SIGNATURE) {
+            throw new Error(`Invalid ZIP signature at offset ${fileEntry.offset}`);
+        }
+        const fileNameLength = view.getUint16(26, true);
+        const extraFieldLength = view.getUint16(28, true);
+        const dataOffset = fileEntry.offset + LOCAL_FILE_HEADER_LENGTH +
+            fileNameLength + extraFieldLength;
+        this.dataOffsetCache.set(fileEntry.path, dataOffset);
+        return dataOffset;
+    }
+}
+exports.CloudStorageSkillReader = CloudStorageSkillReader;
+function normalizePrefix(prefix) {
+    return prefix.replace(/^\/+|\/+$/g, "");
+}

package/script/skillreader/factory.d.ts

@@ -0,0 +1,11 @@
+import type { SkillReader } from "./types.js";
+export type SkillReaderFactoryOptions = {
+    source: string;
+    subDir?: string;
+    gitRef?: string;
+    githubToken?: string;
+};
+export declare class SkillReaderFactory {
+    static create(options: SkillReaderFactoryOptions): Promise<SkillReader>;
+}
+//# sourceMappingURL=factory.d.ts.map

package/script/skillreader/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/skillreader/factory.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,yBAAyB,GAAG;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,qBAAa,kBAAkB;WACd,MAAM,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,WAAW,CAAC;CAsChF"}

package/script/skillreader/factory.js

@@ -0,0 +1,92 @@
+"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.SkillReaderFactory = void 0;
+const dntShim = __importStar(require("../_dnt.shims.js"));
+const mod_js_1 = require("../deps/jsr.io/@std/path/1.1.4/mod.js");
+const mod_js_2 = require("./fs/mod.js");
+const git_js_1 = require("./fs/git.js");
+const mod_js_3 = require("./github/mod.js");
+const utils_js_1 = require("./github/utils.js");
+class SkillReaderFactory {
+    static async create(options) {
+        const source = options.source.trim();
+        if (!source) {
+            throw new Error("Source is required");
+        }
+        const githubParsed = (0, utils_js_1.parseGitHubRepo)(source);
+        if (githubParsed) {
+            return new mod_js_3.GitHubSkillReader({
+                repoUrl: source,
+                gitRef: options.gitRef,
+                dir: options.subDir,
+                token: options.githubToken ?? dntShim.Deno.env.get("GITHUB_TOKEN") ?? undefined,
+            });
+        }
+        if (isHttpUrl(source)) {
+            throw new Error("Invalid source: URL must be a GitHub repository URL or a local directory path");
+        }
+        const rootPath = options.subDir ? (0, mod_js_1.join)(source, options.subDir) : source;
+        if (options.gitRef) {
+            await ensureDirectory(source);
+            await (0, git_js_1.ensureGitRepoRoot)(source);
+            const reader = new git_js_1.LocalGitSkillReader({
+                repoRoot: source,
+                gitRef: options.gitRef,
+                subDir: options.subDir,
+            });
+            await reader.validateRepositoryRef();
+            return reader;
+        }
+        await ensureDirectory(rootPath);
+        return new mod_js_2.LocalFsSkillReader({ root: rootPath });
+    }
+}
+exports.SkillReaderFactory = SkillReaderFactory;
+function isHttpUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+async function ensureDirectory(path) {
+    try {
+        const stat = await dntShim.Deno.stat(path);
+        if (!stat.isDirectory) {
+            throw new Error("Path must be a directory");
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Local path not found: ${message}`);
+    }
+}

package/script/skillreader/fs/git.d.ts

@@ -0,0 +1,23 @@
+import type { SkillFile } from "../types.js";
+import { SkillReader } from "../types.js";
+type LocalGitSkillReaderOptions = {
+    repoRoot: string;
+    gitRef: string;
+    subDir?: string;
+};
+export declare class LocalGitSkillReader extends SkillReader {
+    private readonly repoRoot;
+    private readonly gitRef;
+    private readonly subDir;
+    constructor(options: LocalGitSkillReaderOptions);
+    retrieveFiles(dir?: string): Promise<SkillFile[]>;
+    readTextFile(path: string): Promise<string | null>;
+    readFile(path: string): Promise<ReadableStream<Uint8Array> | null>;
+    readManifest(): Promise<import("../types.js").SkillManifest | null>;
+    validateRepositoryRef(): Promise<void>;
+    private listEntries;
+    private joinWithSubDir;
+}
+export declare function ensureGitRepoRoot(path: string): Promise<void>;
+export {};
+//# sourceMappingURL=git.d.ts.map

package/script/skillreader/fs/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/skillreader/fs/git.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,KAAK,0BAA0B,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAOF,qBAAa,mBAAoB,SAAQ,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,0BAA0B;IAOzC,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAQjD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASlD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAOlE,YAAY;IAUZ,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;YAO9B,WAAW;IA6BzB,OAAO,CAAC,cAAc;CAIzB;AAkCD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnE"}

package/script/skillreader/fs/git.js

@@ -0,0 +1,172 @@
+"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.LocalGitSkillReader = void 0;
+exports.ensureGitRepoRoot = ensureGitRepoRoot;
+const dntShim = __importStar(require("../../_dnt.shims.js"));
+const mod_js_1 = require("../../shared/mod.js");
+const manifest_js_1 = require("../manifest.js");
+const types_js_1 = require("../types.js");
+const mod_js_2 = require("../utils/mod.js");
+class LocalGitSkillReader extends types_js_1.SkillReader {
+    constructor(options) {
+        super();
+        Object.defineProperty(this, "repoRoot", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "gitRef", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "subDir", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.repoRoot = options.repoRoot;
+        this.gitRef = options.gitRef;
+        this.subDir = options.subDir?.replace(/^\/+|\/+$/g, "") ?? "";
+    }
+    async retrieveFiles(dir) {
+        const entries = await this.listEntries(dir);
+        return entries.map((entry) => ({
+            path: entry.relativePath,
+            contentType: (0, mod_js_1.getFileType)(entry.relativePath),
+        }));
+    }
+    async readTextFile(path) {
+        if ((0, mod_js_1.getFileType)(path) === "binary")
+            return null;
+        const stream = await this.readFile(path);
+        if (!stream)
+            return null;
+        const bytes = new Uint8Array(await new Response(stream).arrayBuffer());
+        if (!(0, mod_js_2.isProbablyText)(bytes))
+            return null;
+        return new TextDecoder().decode(bytes);
+    }
+    async readFile(path) {
+        const fullPath = this.joinWithSubDir(path);
+        const result = await runGit(this.repoRoot, ["show", `${this.gitRef}:${fullPath}`]);
+        if (result.code !== 0)
+            return null;
+        return new Response(new Uint8Array(result.stdout)).body;
+    }
+    async readManifest() {
+        try {
+            const text = await this.readTextFile("manifest.json");
+            if (!text)
+                return null;
+            return (0, manifest_js_1.parseSkillManifest)(text);
+        }
+        catch {
+            return null;
+        }
+    }
+    async validateRepositoryRef() {
+        const result = await runGit(this.repoRoot, ["rev-parse", "--verify", this.gitRef]);
+        if (result.code !== 0) {
+            throw new Error(`Git reference not found: ${this.gitRef}`);
+        }
+    }
+    async listEntries(dir) {
+        const scoped = this.joinWithSubDir(dir);
+        const args = ["ls-tree", "-r", "--name-only", this.gitRef];
+        if (scoped) {
+            args.push("--", scoped);
+        }
+        const result = await runGit(this.repoRoot, args);
+        if (result.code !== 0) {
+            throw new Error(`Failed to list files for git reference: ${this.gitRef}`);
+        }
+        const files = new TextDecoder().decode(result.stdout)
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean);
+        const rootPrefix = this.joinWithSubDir(dir);
+        return files
+            .map((fullPath) => {
+            const relativePath = rootPrefix
+                ? fullPath.startsWith(`${rootPrefix}/`)
+                    ? fullPath.slice(rootPrefix.length + 1)
+                    : ""
+                : fullPath;
+            return { fullPath, relativePath };
+        })
+            .filter((entry) => entry.relativePath.length > 0);
+    }
+    joinWithSubDir(path) {
+        const cleaned = path?.replace(/^\/+|\/+$/g, "") ?? "";
+        return [this.subDir, cleaned].filter(Boolean).join("/");
+    }
+}
+exports.LocalGitSkillReader = LocalGitSkillReader;
+async function runGit(repoRoot, args) {
+    const denoRuntime = dntShim.Deno;
+    if (denoRuntime.Command) {
+        return await new denoRuntime.Command("git", {
+            args: ["-C", repoRoot, ...args],
+            stdout: "piped",
+            stderr: "piped",
+        }).output();
+    }
+    const { spawnSync } = await Promise.resolve().then(() => __importStar(require("node:child_process")));
+    const output = spawnSync("git", ["-C", repoRoot, ...args], {
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    return {
+        code: output.status ?? 1,
+        stdout: output.stdout ? new Uint8Array(output.stdout) : new Uint8Array(),
+        stderr: output.stderr ? new Uint8Array(output.stderr) : new Uint8Array(),
+    };
+}
+async function ensureGitRepoRoot(path) {
+    const result = await runGit(path, ["rev-parse", "--show-toplevel"]);
+    if (result.code !== 0) {
+        throw new Error("Local path is not a git repository root");
+    }
+    const topLevel = new TextDecoder().decode(result.stdout).trim();
+    const canonicalPath = await dntShim.Deno.realPath(path);
+    const canonicalTopLevel = await dntShim.Deno.realPath(topLevel);
+    if (canonicalPath !== canonicalTopLevel) {
+        throw new Error("When --gitRef is used with local sources, path must point to the git repository root");
+    }
+}

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

@@ -0,0 +1,15 @@
+import type { SkillFile } from "../types.js";
+import { SkillReader } from "../types.js";
+export type LocalFsSkillReaderOptions = {
+    root: string;
+};
+export declare class LocalFsSkillReader extends SkillReader {
+    private root;
+    constructor(options: LocalFsSkillReaderOptions);
+    retrieveFiles(dir?: string): Promise<SkillFile[]>;
+    readTextFile(path: string): Promise<string | null>;
+    readFile(path: string): Promise<ReadableStream<Uint8Array> | null>;
+    readManifest(): Promise<import("../types.js").SkillManifest | null>;
+    private walkDir;
+}
+//# sourceMappingURL=mod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/skillreader/fs/mod.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,MAAM,yBAAyB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,WAAW;IAC/C,OAAO,CAAC,IAAI,CAAS;gBAET,OAAO,EAAE,yBAAyB;IAKxC,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAiBjD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAalD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAUlE,YAAY;YAUH,OAAO;CAazB"}

package/script/skillreader/fs/mod.js

@@ -0,0 +1,117 @@
+"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.LocalFsSkillReader = void 0;
+const dntShim = __importStar(require("../../_dnt.shims.js"));
+const mod_js_1 = require("../../deps/jsr.io/@std/path/1.1.4/mod.js");
+const mod_js_2 = require("../utils/mod.js");
+const types_js_1 = require("../types.js");
+const manifest_js_1 = require("../manifest.js");
+const mod_js_3 = require("../../shared/mod.js");
+class LocalFsSkillReader extends types_js_1.SkillReader {
+    constructor(options) {
+        super();
+        Object.defineProperty(this, "root", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.root = options.root;
+    }
+    async retrieveFiles(dir) {
+        const base = dir ? (0, mod_js_1.join)(this.root, dir) : this.root;
+        const files = [];
+        for await (const entry of this.walkDir(base)) {
+            if (!entry.isFile)
+                continue;
+            const relPath = (0, mod_js_1.relative)(this.root, entry.path);
+            files.push({
+                path: relPath.replace(/\\/g, "/"),
+                size: entry.size,
+                contentType: (0, mod_js_3.getFileType)(relPath),
+            });
+        }
+        return files;
+    }
+    async readTextFile(path) {
+        const fullPath = (0, mod_js_1.join)(this.root, path);
+        const contentType = (0, mod_js_3.getFileType)(path);
+        if (contentType === "binary")
+            return null;
+        try {
+            const data = await dntShim.Deno.readFile(fullPath);
+            if (!(0, mod_js_2.isProbablyText)(data))
+                return null;
+            return new TextDecoder().decode(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    async readFile(path) {
+        const fullPath = (0, mod_js_1.join)(this.root, path);
+        try {
+            const file = await dntShim.Deno.open(fullPath, { read: true });
+            return file.readable;
+        }
+        catch {
+            return null;
+        }
+    }
+    async readManifest() {
+        const manifestPath = (0, mod_js_1.join)(this.root, "manifest.json");
+        try {
+            const text = await dntShim.Deno.readTextFile(manifestPath);
+            return (0, manifest_js_1.parseSkillManifest)(text);
+        }
+        catch {
+            return null;
+        }
+    }
+    async *walkDir(dir) {
+        for await (const entry of dntShim.Deno.readDir(dir)) {
+            const fullPath = (0, mod_js_1.join)(dir, entry.name);
+            if (entry.isDirectory) {
+                yield* this.walkDir(fullPath);
+            }
+            else if (entry.isFile) {
+                const stat = await dntShim.Deno.stat(fullPath);
+                yield { path: fullPath, size: stat.size, isFile: true };
+            }
+        }
+    }
+}
+exports.LocalFsSkillReader = LocalFsSkillReader;

package/script/skillreader/github/base.d.ts

@@ -0,0 +1,34 @@
+import type { SkillFile } from "../types.js";
+import { SkillReader } from "../types.js";
+export type GitHubTreeEntry = {
+    path: string;
+    type: string;
+    sha: string;
+    size?: number;
+};
+export type AbstractGitHubSkillReaderOptions = {
+    repoUrl: string;
+    gitRef?: string;
+    dir?: string;
+    token?: string;
+};
+export declare abstract class AbstractGitHubSkillReader extends SkillReader {
+    protected owner: string;
+    protected repo: string;
+    protected dir: string;
+    protected token?: string;
+    private requestedGitRef?;
+    private resolvedGitRef?;
+    private treeEntries;
+    constructor(options: AbstractGitHubSkillReaderOptions);
+    retrieveFiles(dir?: string): Promise<SkillFile[]>;
+    readTextFile(path: string): Promise<string | null>;
+    readFile(path: string): Promise<ReadableStream<Uint8Array> | null>;
+    readManifest(): Promise<import("../types.js").SkillManifest | null>;
+    protected abstract readFileFromEntry(entry: GitHubTreeEntry): Promise<ReadableStream<Uint8Array> | null>;
+    protected buildHeaders(): Record<string, string>;
+    protected resolveGitRef(): Promise<string>;
+    protected getTreeEntries(): Promise<Map<string, GitHubTreeEntry>>;
+    private findEntry;
+}
+//# sourceMappingURL=base.d.ts.map

package/script/skillreader/github/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/skillreader/github/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU1C,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,8BAAsB,yBAA0B,SAAQ,WAAW;IAC/D,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,WAAW,CAA6C;gBAEpD,OAAO,EAAE,gCAAgC;IAW/C,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoBjD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASlD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAMlE,YAAY;IAUlB,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAChC,KAAK,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAE7C,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;cAIhC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;cAsBhC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YAkCzD,SAAS;CAK1B"}