@feiyoug/skill-lab 0.0.0

package/script/skillreader/github/base.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractGitHubSkillReader = 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 utils_js_1 = require("./utils.js");
+const mod_js_2 = require("../../shared/mod.js");
+class AbstractGitHubSkillReader extends types_js_1.SkillReader {
+    constructor(options) {
+        super();
+        Object.defineProperty(this, "owner", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "repo", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "dir", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "token", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "requestedGitRef", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "resolvedGitRef", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "treeEntries", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        const parsed = (0, utils_js_1.parseGitHubRepo)(options.repoUrl);
+        if (!parsed)
+            throw new Error("Unsupported repo URL");
+        this.owner = parsed.owner;
+        this.repo = parsed.repo;
+        this.requestedGitRef = options.gitRef;
+        this.dir = options.dir?.replace(/^\/+|\/+$/g, "") ?? "";
+        this.token = options.token;
+    }
+    async retrieveFiles(dir) {
+        const entries = await this.getTreeEntries();
+        const prefix = (0, utils_js_1.buildPrefix)(this.dir, dir);
+        const files = [];
+        for (const entry of entries.values()) {
+            if (entry.type !== "blob")
+                continue;
+            if (prefix && !entry.path.startsWith(prefix))
+                continue;
+            const relativePath = (0, utils_js_1.normalizeRelativePath)(prefix, entry.path);
+            if (!relativePath)
+                continue;
+            files.push({
+                path: relativePath,
+                size: entry.size,
+                contentType: (0, mod_js_2.getFileType)(relativePath),
+            });
+        }
+        return files;
+    }
+    async readTextFile(path) {
+        if ((0, mod_js_2.getFileType)(path) === "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 entry = await this.findEntry(path);
+        if (!entry)
+            return null;
+        return this.readFileFromEntry(entry);
+    }
+    async readManifest() {
+        try {
+            const text = await this.readTextFile("manifest.json");
+            if (!text)
+                return null;
+            return (0, manifest_js_1.parseSkillManifest)(text);
+        }
+        catch {
+            return null;
+        }
+    }
+    buildHeaders() {
+        return (0, utils_js_1.buildGitHubHeaders)(this.token);
+    }
+    async resolveGitRef() {
+        if (this.resolvedGitRef)
+            return this.resolvedGitRef;
+        if (this.requestedGitRef) {
+            this.resolvedGitRef = this.requestedGitRef;
+            return this.resolvedGitRef;
+        }
+        const response = await fetch(`https://api.github.com/repos/${this.owner}/${this.repo}`, { headers: this.buildHeaders() });
+        if (!response.ok) {
+            throw new Error(`GitHub repository fetch failed: ${response.status}`);
+        }
+        const repoData = await response.json();
+        if (!repoData.default_branch) {
+            throw new Error("GitHub repository metadata missing default branch");
+        }
+        this.resolvedGitRef = repoData.default_branch;
+        return this.resolvedGitRef;
+    }
+    async getTreeEntries() {
+        if (this.treeEntries)
+            return this.treeEntries;
+        const gitRef = await this.resolveGitRef();
+        const headers = this.buildHeaders();
+        const commitResponse = await fetch(`https://api.github.com/repos/${this.owner}/${this.repo}/commits/${gitRef}`, { headers });
+        if (!commitResponse.ok) {
+            throw new Error(`GitHub commit fetch failed: ${commitResponse.status}`);
+        }
+        const commitData = await commitResponse.json();
+        const treeSha = commitData?.commit?.tree?.sha;
+        if (!treeSha)
+            throw new Error("Missing tree SHA");
+        const treeResponse = await fetch(`https://api.github.com/repos/${this.owner}/${this.repo}/git/trees/${treeSha}?recursive=1`, { headers });
+        if (!treeResponse.ok) {
+            throw new Error(`GitHub tree fetch failed: ${treeResponse.status}`);
+        }
+        const treeData = await treeResponse.json();
+        const entries = new Map();
+        for (const entry of treeData?.tree ?? []) {
+            entries.set(entry.path, entry);
+        }
+        this.treeEntries = entries;
+        return entries;
+    }
+    async findEntry(path) {
+        const entries = await this.getTreeEntries();
+        const fullPath = this.dir ? `${this.dir}/${path}` : path;
+        return entries.get(fullPath) ?? null;
+    }
+}
+exports.AbstractGitHubSkillReader = AbstractGitHubSkillReader;

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

@@ -0,0 +1,9 @@
+import { AbstractGitHubSkillReader, type AbstractGitHubSkillReaderOptions, type GitHubTreeEntry } from "./base.js";
+export type GitHubApiSkillReaderOptions = AbstractGitHubSkillReaderOptions & {
+    token: string;
+};
+export declare class GitHubApiSkillReader extends AbstractGitHubSkillReader {
+    constructor(options: GitHubApiSkillReaderOptions);
+    protected readFileFromEntry(entry: GitHubTreeEntry): Promise<ReadableStream<Uint8Array> | null>;
+}
+//# sourceMappingURL=githubApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"githubApi.d.ts","sourceRoot":"","sources":["../../../src/skillreader/github/githubApi.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,yBAAyB,EACzB,KAAK,gCAAgC,EACrC,KAAK,eAAe,EACvB,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,2BAA2B,GAAG,gCAAgC,GAAG;IACzE,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,yBAAyB;gBACnD,OAAO,EAAE,2BAA2B;cAIhC,iBAAiB,CAC7B,KAAK,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;CAWhD"}

package/script/skillreader/github/githubApi.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubApiSkillReader = void 0;
+const base_js_1 = require("./base.js");
+class GitHubApiSkillReader extends base_js_1.AbstractGitHubSkillReader {
+    constructor(options) {
+        super(options);
+    }
+    async readFileFromEntry(entry) {
+        const blobResponse = await fetch(`https://api.github.com/repos/${this.owner}/${this.repo}/git/blobs/${entry.sha}`, { headers: this.buildHeaders() });
+        if (!blobResponse.ok)
+            return null;
+        const blobData = await blobResponse.json();
+        if (!blobData.content || blobData.encoding !== "base64")
+            return null;
+        const buffer = decodeBase64ToBuffer(blobData.content);
+        return new Response(buffer).body;
+    }
+}
+exports.GitHubApiSkillReader = GitHubApiSkillReader;
+function decodeBase64ToBuffer(input) {
+    const cleaned = input.replace(/\n/g, "");
+    const binary = atob(cleaned);
+    const buffer = new ArrayBuffer(binary.length);
+    const bytes = new Uint8Array(buffer);
+    for (let i = 0; i < binary.length; i += 1) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return buffer;
+}

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

@@ -0,0 +1,7 @@
+import { AbstractGitHubSkillReader, type AbstractGitHubSkillReaderOptions, type GitHubTreeEntry } from "./base.js";
+export type GitHubRawSkillReaderOptions = AbstractGitHubSkillReaderOptions;
+export declare class GitHubRawSkillReader extends AbstractGitHubSkillReader {
+    constructor(options: GitHubRawSkillReaderOptions);
+    protected readFileFromEntry(entry: GitHubTreeEntry): Promise<ReadableStream<Uint8Array> | null>;
+}
+//# sourceMappingURL=githubRaw.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"githubRaw.d.ts","sourceRoot":"","sources":["../../../src/skillreader/github/githubRaw.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,yBAAyB,EACzB,KAAK,gCAAgC,EACrC,KAAK,eAAe,EACvB,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,2BAA2B,GAAG,gCAAgC,CAAC;AAE3E,qBAAa,oBAAqB,SAAQ,yBAAyB;gBACnD,OAAO,EAAE,2BAA2B;cAIhC,iBAAiB,CAC7B,KAAK,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;CAQhD"}

package/script/skillreader/github/githubRaw.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubRawSkillReader = void 0;
+const base_js_1 = require("./base.js");
+class GitHubRawSkillReader extends base_js_1.AbstractGitHubSkillReader {
+    constructor(options) {
+        super(options);
+    }
+    async readFileFromEntry(entry) {
+        const gitRef = await this.resolveGitRef();
+        const rawUrl = `https://raw.githubusercontent.com/${this.owner}/${this.repo}/${gitRef}/${entry.path}`;
+        const response = await fetch(rawUrl);
+        if (!response.ok)
+            return null;
+        return response.body;
+    }
+}
+exports.GitHubRawSkillReader = GitHubRawSkillReader;

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

@@ -0,0 +1,18 @@
+import { SkillReader } from "../types.js";
+export type GitHubSkillReaderOptions = {
+    repoUrl: string;
+    gitRef?: string;
+    dir?: string;
+    token?: string;
+};
+export declare class GitHubSkillReader extends SkillReader {
+    private reader;
+    constructor(options: GitHubSkillReaderOptions);
+    retrieveFiles(dir?: string): Promise<import("../types.js").SkillFile[]>;
+    readTextFile(path: string): Promise<string | null>;
+    readFile(path: string): Promise<ReadableStream<Uint8Array<ArrayBufferLike>> | null>;
+    readManifest(): Promise<import("../types.js").SkillManifest | null>;
+}
+export { GitHubApiSkillReader } from "./githubApi.js";
+export { GitHubRawSkillReader } from "./githubRaw.js";
+//# sourceMappingURL=mod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/skillreader/github/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,MAAM,wBAAwB,GAAG;IACnC,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,qBAAa,iBAAkB,SAAQ,WAAW;IAC9C,OAAO,CAAC,MAAM,CAAc;gBAEhB,OAAO,EAAE,wBAAwB;IAY7C,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM;IAI1B,YAAY,CAAC,IAAI,EAAE,MAAM;IAIzB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAIrB,YAAY;CAGf;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/script/skillreader/github/mod.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubRawSkillReader = exports.GitHubApiSkillReader = exports.GitHubSkillReader = void 0;
+const types_js_1 = require("../types.js");
+const githubApi_js_1 = require("./githubApi.js");
+const githubRaw_js_1 = require("./githubRaw.js");
+class GitHubSkillReader extends types_js_1.SkillReader {
+    constructor(options) {
+        super();
+        Object.defineProperty(this, "reader", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        if (options.token) {
+            this.reader = new githubApi_js_1.GitHubApiSkillReader({
+                ...options,
+                token: options.token,
+            });
+        }
+        else {
+            this.reader = new githubRaw_js_1.GitHubRawSkillReader(options);
+        }
+    }
+    retrieveFiles(dir) {
+        return this.reader.retrieveFiles(dir);
+    }
+    readTextFile(path) {
+        return this.reader.readTextFile(path);
+    }
+    readFile(path) {
+        return this.reader.readFile(path);
+    }
+    readManifest() {
+        return this.reader.readManifest();
+    }
+}
+exports.GitHubSkillReader = GitHubSkillReader;
+var githubApi_js_2 = require("./githubApi.js");
+Object.defineProperty(exports, "GitHubApiSkillReader", { enumerable: true, get: function () { return githubApi_js_2.GitHubApiSkillReader; } });
+var githubRaw_js_2 = require("./githubRaw.js");
+Object.defineProperty(exports, "GitHubRawSkillReader", { enumerable: true, get: function () { return githubRaw_js_2.GitHubRawSkillReader; } });

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

@@ -0,0 +1,9 @@
+export type ParsedGitHubRepo = {
+    owner: string;
+    repo: string;
+};
+export declare function parseGitHubRepo(repoUrl: string): ParsedGitHubRepo | null;
+export declare function buildPrefix(baseDir?: string, extraDir?: string): string;
+export declare function normalizeRelativePath(prefix: string, fullPath: string): string;
+export declare function buildGitHubHeaders(token?: string): Record<string, string>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/skillreader/github/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAYxE;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI9E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOzE"}

package/script/skillreader/github/utils.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseGitHubRepo = parseGitHubRepo;
+exports.buildPrefix = buildPrefix;
+exports.normalizeRelativePath = normalizeRelativePath;
+exports.buildGitHubHeaders = buildGitHubHeaders;
+function parseGitHubRepo(repoUrl) {
+    try {
+        const parsed = new URL(repoUrl);
+        if (!(parsed.hostname === "github.com" || parsed.hostname === "www.github.com")) {
+            return null;
+        }
+        const match = parsed.pathname.match(/^\/([^\/]+)\/([^\/]+?)(\.git)?$/);
+        if (!match)
+            return null;
+        return { owner: match[1], repo: match[2] };
+    }
+    catch {
+        return null;
+    }
+}
+function buildPrefix(baseDir, extraDir) {
+    const cleanedBase = baseDir?.replace(/^\/+|\/+$/g, "") ?? "";
+    const cleanedExtra = extraDir?.replace(/^\/+|\/+$/g, "") ?? "";
+    const combined = [cleanedBase, cleanedExtra].filter(Boolean).join("/");
+    return combined ? `${combined}/` : "";
+}
+function normalizeRelativePath(prefix, fullPath) {
+    if (!prefix)
+        return fullPath;
+    if (!fullPath.startsWith(prefix))
+        return "";
+    return fullPath.slice(prefix.length);
+}
+function buildGitHubHeaders(token) {
+    const headers = {
+        Accept: "application/vnd.github.v3+json",
+        "User-Agent": "goskilla-api",
+    };
+    if (token)
+        headers.Authorization = `Bearer ${token}`;
+    return headers;
+}

package/script/skillreader/manifest.d.ts

@@ -0,0 +1,15 @@
+import type { SkillFile, SkillFileManifest, SkillManifest, SkillZipManifest, ZipManifestFile } from "./types.js";
+export declare const SKILL_MANIFEST_VERSION: 1;
+export declare const SKILL_ZIP_MANIFEST_VERSION: 2;
+export declare function createSkillManifest(files: SkillFile[]): SkillFileManifest;
+export declare function createZipManifest(files: ZipManifestFile[], metadata: {
+    skillVersionId: string;
+    repoUrl: string;
+    commitHash: string;
+    dir?: string | null;
+    checksum: string;
+    compression: "deflate" | "store";
+}): SkillZipManifest;
+export declare function parseSkillManifest(text: string): SkillManifest | null;
+export declare function isZipManifest(manifest: SkillManifest): manifest is SkillZipManifest;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/skillreader/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,eAAe,EAClB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,sBAAsB,EAAG,CAAU,CAAC;AACjD,eAAO,MAAM,0BAA0B,EAAG,CAAU,CAAC;AAErD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAMzE;AAED,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,eAAe,EAAE,EACxB,QAAQ,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC;CACpC,GACF,gBAAgB,CAalB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAkBrE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,QAAQ,IAAI,gBAAgB,CAEnF"}

package/script/skillreader/manifest.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_ZIP_MANIFEST_VERSION = exports.SKILL_MANIFEST_VERSION = void 0;
+exports.createSkillManifest = createSkillManifest;
+exports.createZipManifest = createZipManifest;
+exports.parseSkillManifest = parseSkillManifest;
+exports.isZipManifest = isZipManifest;
+exports.SKILL_MANIFEST_VERSION = 1;
+exports.SKILL_ZIP_MANIFEST_VERSION = 2;
+function createSkillManifest(files) {
+    return {
+        version: exports.SKILL_MANIFEST_VERSION,
+        generatedAt: new Date().toISOString(),
+        files,
+    };
+}
+function createZipManifest(files, metadata) {
+    return {
+        version: exports.SKILL_ZIP_MANIFEST_VERSION,
+        storage_method: "zip",
+        compression: metadata.compression,
+        skill_version_id: metadata.skillVersionId,
+        repo_url: metadata.repoUrl,
+        commit_hash: metadata.commitHash,
+        dir: metadata.dir ?? null,
+        created_at: new Date().toISOString(),
+        checksum: metadata.checksum,
+        files,
+    };
+}
+function parseSkillManifest(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        if (!Array.isArray(parsed.files))
+            return null;
+        if (parsed.version === exports.SKILL_MANIFEST_VERSION) {
+            return parsed;
+        }
+        if (parsed.version === exports.SKILL_ZIP_MANIFEST_VERSION) {
+            const zipManifest = parsed;
+            if (zipManifest.storage_method !== "zip")
+                return null;
+            if (!zipManifest.compression)
+                return null;
+            return zipManifest;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function isZipManifest(manifest) {
+    return manifest.storage_method === "zip";
+}

package/script/skillreader/mod.d.ts

@@ -0,0 +1,12 @@
+import "../_dnt.polyfills.js";
+export type { SkillFile, SkillFileManifest, SkillFrontmatter, SkillManifest, SkillReader, SkillZipManifest, ZipManifestFile, } from "./types.js";
+export { createSkillManifest, createZipManifest, isZipManifest, parseSkillManifest, SKILL_MANIFEST_VERSION, SKILL_ZIP_MANIFEST_VERSION, } from "./manifest.js";
+export { LocalFsSkillReader } from "./fs/mod.js";
+export { SkillReaderFactory } from "./factory.js";
+export type { SkillReaderFactoryOptions } from "./factory.js";
+export { Analyzer } from "../analyzer/mod.js";
+export type { AnalyzerAnalyzeInput } from "../analyzer/mod.js";
+export { GitHubApiSkillReader, GitHubRawSkillReader, GitHubSkillReader } from "./github/mod.js";
+export { CloudStorageSkillReader } from "./cloudStorage/mod.js";
+export type { CloudStorageSkillReaderOptions } from "./cloudStorage/mod.js";
+//# sourceMappingURL=mod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/skillreader/mod.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,YAAY,EACR,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,eAAe,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC"}

package/script/skillreader/mod.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudStorageSkillReader = exports.GitHubSkillReader = exports.GitHubRawSkillReader = exports.GitHubApiSkillReader = exports.Analyzer = exports.SkillReaderFactory = exports.LocalFsSkillReader = exports.SKILL_ZIP_MANIFEST_VERSION = exports.SKILL_MANIFEST_VERSION = exports.parseSkillManifest = exports.isZipManifest = exports.createZipManifest = exports.createSkillManifest = void 0;
+require("../_dnt.polyfills.js");
+var manifest_js_1 = require("./manifest.js");
+Object.defineProperty(exports, "createSkillManifest", { enumerable: true, get: function () { return manifest_js_1.createSkillManifest; } });
+Object.defineProperty(exports, "createZipManifest", { enumerable: true, get: function () { return manifest_js_1.createZipManifest; } });
+Object.defineProperty(exports, "isZipManifest", { enumerable: true, get: function () { return manifest_js_1.isZipManifest; } });
+Object.defineProperty(exports, "parseSkillManifest", { enumerable: true, get: function () { return manifest_js_1.parseSkillManifest; } });
+Object.defineProperty(exports, "SKILL_MANIFEST_VERSION", { enumerable: true, get: function () { return manifest_js_1.SKILL_MANIFEST_VERSION; } });
+Object.defineProperty(exports, "SKILL_ZIP_MANIFEST_VERSION", { enumerable: true, get: function () { return manifest_js_1.SKILL_ZIP_MANIFEST_VERSION; } });
+var mod_js_1 = require("./fs/mod.js");
+Object.defineProperty(exports, "LocalFsSkillReader", { enumerable: true, get: function () { return mod_js_1.LocalFsSkillReader; } });
+var factory_js_1 = require("./factory.js");
+Object.defineProperty(exports, "SkillReaderFactory", { enumerable: true, get: function () { return factory_js_1.SkillReaderFactory; } });
+var mod_js_2 = require("../analyzer/mod.js");
+Object.defineProperty(exports, "Analyzer", { enumerable: true, get: function () { return mod_js_2.Analyzer; } });
+var mod_js_3 = require("./github/mod.js");
+Object.defineProperty(exports, "GitHubApiSkillReader", { enumerable: true, get: function () { return mod_js_3.GitHubApiSkillReader; } });
+Object.defineProperty(exports, "GitHubRawSkillReader", { enumerable: true, get: function () { return mod_js_3.GitHubRawSkillReader; } });
+Object.defineProperty(exports, "GitHubSkillReader", { enumerable: true, get: function () { return mod_js_3.GitHubSkillReader; } });
+var mod_js_4 = require("./cloudStorage/mod.js");
+Object.defineProperty(exports, "CloudStorageSkillReader", { enumerable: true, get: function () { return mod_js_4.CloudStorageSkillReader; } });

package/script/skillreader/types.d.ts

@@ -0,0 +1,79 @@
+import { FileType } from "../shared/mod.js";
+export type SkillFile = {
+    path: string;
+    size?: number;
+    contentType: FileType;
+};
+export type SkillFileManifest = {
+    version: 1;
+    generatedAt: string;
+    files: SkillFile[];
+};
+export type ZipManifestFile = {
+    path: string;
+    size: number;
+    offset: number;
+    compressedSize: number;
+    compressionMethod: number;
+    signature: number;
+};
+export type SkillZipManifest = {
+    version: 2;
+    storage_method: "zip";
+    compression: "deflate" | "store";
+    skill_version_id: string;
+    repo_url: string;
+    commit_hash: string;
+    dir: string | null;
+    created_at: string;
+    checksum: string;
+    files: ZipManifestFile[];
+};
+export type SkillManifest = SkillFileManifest | SkillZipManifest;
+export type SkillFrontmatter = {
+    startLineNumer?: number;
+    endLineNumer?: number;
+    name: string;
+    description: string;
+    license?: string;
+    compatibility?: string;
+    metadata?: Record<string, unknown>;
+    "allowed-tools"?: string;
+    [key: string]: unknown;
+};
+export declare abstract class SkillReader {
+    /**
+     * A cached path to the root SKILL.md file in this skill repository
+     */
+    private skillMdPatah;
+    /**
+     * A cached list of files in this skill repository.
+     */
+    private files;
+    /**
+     * A cached parsed SKILL.md frontmatter.
+     */
+    private skillFrontMatter;
+    abstract retrieveFiles(dir?: string): Promise<SkillFile[]>;
+    abstract readTextFile(path: string): Promise<string | null>;
+    abstract readFile(path: string): Promise<ReadableStream<Uint8Array> | null>;
+    abstract readManifest(): Promise<SkillManifest | null>;
+    listFiles(): Promise<SkillFile[]>;
+    /**
+     * Return the path to SKILL.md if it exists, or throw if not.
+     */
+    getSkillMdPath(): Promise<string>;
+    /**
+     * Returns full SKILL.md content, or throws when the repository is not a valid skill.
+     */
+    getSkillMdContent(): Promise<string>;
+    /**
+     * Parses SKILL.md frontmatter and guarantees required fields.
+     */
+    getSkillMdFrontmatter(): Promise<SkillFrontmatter>;
+    validate(): Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skillreader/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,MAAM,SAAS,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,QAAQ,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,cAAc,EAAE,KAAK,CAAC;IACtB,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAC;AAEF,8BAAsB,WAAW;IAC7B;;OAEG;IACH,OAAO,CAAC,YAAY,CAAiC;IAErD;;OAEG;IACH,OAAO,CAAC,KAAK,CAAsC;IAEnD;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAA2C;IAEnE,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAC1D,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAC3E,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAEzC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAO9C;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAc9C;;OAEG;IACU,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IASjD;;OAEG;IACU,qBAAqB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA2BlD,QAAQ,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CASrE"}