skills-sdk 0.1.0

package/README.md

@@ -0,0 +1,104 @@
+# skills-sdk
+
+TypeScript SDK for fetching and managing [agent skills](https://agentskills.io) from GitHub repositories.
+
+## Install
+
+```
+npm install skills-sdk
+```
+
+## Usage
+
+```ts
+import { Client, FS } from "skills-sdk";
+
+const client = new Client(new FS(), "/tmp/skills");
+```
+
+The client takes a storage backend and a base path. `FS` writes to disk, `Memory` keeps everything in-memory (useful for tests).
+
+### Authentication
+
+Pass a GitHub token directly or set it as an environment variable:
+
+```ts
+// explicit
+const client = new Client(new FS(), "/tmp/skills", {
+  token: "ghp_...",
+});
+
+// or via environment
+// SKILLS_GITHUB_TOKEN=ghp_...
+// SKILLS_GITHUB_URL=https://github.example.com/api/v3  (optional, for GHE)
+const client = new Client(new FS(), "/tmp/skills");
+```
+
+### Fetch skills from GitHub
+
+```ts
+// fetch all skills from a repo
+await client.store("owner", "repo");
+
+// fetch a specific skill
+await client.store("owner", "repo", { name: "my-skill" });
+
+// fetch from a specific branch or tag
+await client.store("owner", "repo", { ref: "v2" });
+```
+
+### List skills
+
+```ts
+// remote — reads from GitHub without storing anything
+const remote = await client.listRemote("owner", "repo");
+
+// local — reads from whatever you've already stored
+const local = await client.listLocal();
+```
+
+Both return `Metadata[]` with `name`, `description`, and optional fields like `license`, `compatibility`, `allowedTools`.
+
+### Read stored skills
+
+```ts
+const meta = await client.getMetadata("my-skill");
+const raw = await client.getSkillMd("my-skill");
+const file = await client.getFile("my-skill", "prompt.txt");
+```
+
+## Custom storage backends
+
+The SDK ships with `FS` and `Memory`, but you can plug in any backend by implementing the `Store` interface:
+
+```ts
+import type { Store } from "skills-sdk";
+
+class S3Store implements Store {
+  async write(path: string, content: Buffer): Promise<void> {
+    /* ... */
+  }
+  async read(path: string): Promise<Buffer> {
+    /* ... */
+  }
+  async list(prefix: string): Promise<string[]> {
+    /* ... */
+  }
+  async exists(path: string): Promise<boolean> {
+    /* ... */
+  }
+  async delete(path: string): Promise<void> {
+    /* ... */
+  }
+}
+
+const client = new Client(new S3Store(), "skills/");
+```
+
+A few things to keep in mind when writing a backend:
+
+- **`write`** should create any intermediate directories/prefixes as needed.
+- **`list`** returns immediate child _directory_ names under the given prefix, not files. Think `ls`, not `find`.
+- **`exists`** should return `true` for both files and directories.
+- **`delete`** is recursive -- it removes the path and everything under it.
+- Paths use `/` as the separator. The client never sends backslashes.

package/dist/client.d.ts

@@ -0,0 +1,44 @@
+import type { Store } from "./store/index.js";
+import type { Metadata } from "./types.js";
+export interface ClientOptions {
+    token?: string;
+    baseUrl?: string;
+}
+/**
+ * Options for the {@link Client.store} method.
+ */
+export interface StoreOptions {
+    /** Fetch only the skill with this name. Fetches all skills if omitted. */
+    name?: string;
+    /** Git ref (branch, tag, or SHA) to fetch from. Uses the default branch if omitted. */
+    ref?: string;
+}
+/**
+ * Main entry point for fetching skills from GitHub and reading them from local storage.
+ *
+ * Falls back to `SKILLS_GITHUB_TOKEN` and `SKILLS_GITHUB_URL` environment
+ * variables when `ClientOptions` are not provided.
+ */
+export declare class Client {
+    private fileStore;
+    private basePath;
+    private fetcher;
+    constructor(store: Store, basePath: string, options?: ClientOptions);
+    /** List metadata for all skills in a remote GitHub repository. */
+    listRemote(owner: string, repo: string, ref?: string): Promise<Metadata[]>;
+    /**
+     * Fetch skills from a GitHub repository and write them to local storage.
+     * Downloads the entire repo as a tarball (1 API request) even when storing
+     * a single skill -- at typical repo sizes this is faster than per-file fetching.
+     */
+    store(owner: string, repo: string, options?: StoreOptions): Promise<void>;
+    /** List metadata for all skills stored locally under the base path. */
+    listLocal(): Promise<Metadata[]>;
+    /** Get the parsed frontmatter metadata for a stored skill. */
+    getMetadata(name: string): Promise<Metadata>;
+    /** Get the raw SKILL.md content for a stored skill. */
+    getSkillMd(name: string): Promise<string>;
+    /** Get a single file from a stored skill by its relative path. */
+    getFile(name: string, path: string): Promise<Buffer>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO3C,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAe;gBAElB,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAWnE,kEAAkE;IAC5D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAShF;;;;OAIG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB/E,uEAAuE;IACjE,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAoBtC,8DAA8D;IACxD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAMlD,uDAAuD;IACjD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/C,kEAAkE;IAC5D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG3D"}

package/dist/client.js

@@ -0,0 +1,93 @@
+import { join } from "node:path/posix";
+import { GitHubClient, discoverSkills } from "./github.js";
+import { parseSkillMd } from "./parser.js";
+import { SkillsError } from "./errors.js";
+const SKILL_MD = "SKILL.md";
+/**
+ * Main entry point for fetching skills from GitHub and reading them from local storage.
+ *
+ * Falls back to `SKILLS_GITHUB_TOKEN` and `SKILLS_GITHUB_URL` environment
+ * variables when `ClientOptions` are not provided.
+ */
+export class Client {
+    fileStore;
+    basePath;
+    fetcher;
+    constructor(store, basePath, options) {
+        this.fileStore = store;
+        this.basePath = basePath;
+        const token = options?.token ?? process.env.SKILLS_GITHUB_TOKEN;
+        const baseUrl = options?.baseUrl ?? process.env.SKILLS_GITHUB_URL;
+        this.fetcher = new GitHubClient({
+            ...(token ? { token } : {}),
+            ...(baseUrl ? { baseUrl } : {}),
+        });
+    }
+    /** List metadata for all skills in a remote GitHub repository. */
+    async listRemote(owner, repo, ref) {
+        const repoFiles = await this.fetcher.fetchRepo(owner, repo, ref);
+        const discovered = discoverSkills(repoFiles);
+        return discovered.map((skill) => {
+            const { metadata } = parseSkillMd(skill.skillMdContent.toString("utf-8"));
+            return metadata;
+        });
+    }
+    /**
+     * Fetch skills from a GitHub repository and write them to local storage.
+     * Downloads the entire repo as a tarball (1 API request) even when storing
+     * a single skill -- at typical repo sizes this is faster than per-file fetching.
+     */
+    async store(owner, repo, options) {
+        const repoFiles = await this.fetcher.fetchRepo(owner, repo, options?.ref);
+        let discovered = discoverSkills(repoFiles);
+        if (options?.name) {
+            discovered = discovered.filter((s) => s.directoryName === options.name);
+            if (discovered.length === 0) {
+                throw new SkillsError(`Skill "${options.name}" not found`);
+            }
+        }
+        for (const skill of discovered) {
+            const { metadata } = parseSkillMd(skill.skillMdContent.toString("utf-8"));
+            const skillDir = join(this.basePath, metadata.name);
+            await this.fileStore.write(join(skillDir, SKILL_MD), skill.skillMdContent);
+            for (const [relPath, content] of skill.files) {
+                await this.fileStore.write(join(skillDir, relPath), content);
+            }
+        }
+    }
+    /** List metadata for all skills stored locally under the base path. */
+    async listLocal() {
+        const dirs = await this.fileStore.list(this.basePath);
+        const results = [];
+        for (const dir of dirs) {
+            const skillMdPath = join(this.basePath, dir, SKILL_MD);
+            if (!(await this.fileStore.exists(skillMdPath)))
+                continue;
+            try {
+                const content = await this.fileStore.read(skillMdPath);
+                const { metadata } = parseSkillMd(content.toString("utf-8"));
+                results.push(metadata);
+            }
+            catch {
+                // skip directories with invalid SKILL.md
+            }
+        }
+        return results;
+    }
+    /** Get the parsed frontmatter metadata for a stored skill. */
+    async getMetadata(name) {
+        const content = await this.fileStore.read(join(this.basePath, name, SKILL_MD));
+        const { metadata } = parseSkillMd(content.toString("utf-8"));
+        return metadata;
+    }
+    /** Get the raw SKILL.md content for a stored skill. */
+    async getSkillMd(name) {
+        const content = await this.fileStore.read(join(this.basePath, name, SKILL_MD));
+        return content.toString("utf-8");
+    }
+    /** Get a single file from a stored skill by its relative path. */
+    async getFile(name, path) {
+        return this.fileStore.read(join(this.basePath, name, path));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Base error class for all skills-related errors.
+ */
+export declare class SkillsError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when a SKILL.md file cannot be parsed.
+ */
+export declare class ParseError extends SkillsError {
+    constructor(message: string);
+}
+/**
+ * Error thrown when a GitHub API request fails.
+ */
+export declare class GitHubFetchError extends SkillsError {
+    status: number;
+    constructor(status: number, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,MAAM,EAAE,MAAM,CAAC;gBAEH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK5C"}

package/dist/errors.js

@@ -0,0 +1,30 @@
+/**
+ * Base error class for all skills-related errors.
+ */
+export class SkillsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SkillsError";
+    }
+}
+/**
+ * Error thrown when a SKILL.md file cannot be parsed.
+ */
+export class ParseError extends SkillsError {
+    constructor(message) {
+        super(message);
+        this.name = "ParseError";
+    }
+}
+/**
+ * Error thrown when a GitHub API request fails.
+ */
+export class GitHubFetchError extends SkillsError {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.name = "GitHubFetchError";
+        this.status = status;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC/C,MAAM,CAAS;IAEf,YAAY,MAAc,EAAE,OAAe;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/github.d.ts

@@ -0,0 +1,19 @@
+export interface DiscoveredSkill {
+    path: string;
+    directoryName: string;
+    skillMdContent: Buffer;
+    files: Map<string, Buffer>;
+}
+interface GitHubClientOptions {
+    token?: string;
+    baseUrl?: string;
+}
+export declare class GitHubClient {
+    private baseUrl;
+    private token;
+    constructor(options?: GitHubClientOptions);
+    fetchRepo(owner: string, repo: string, ref?: string): Promise<Map<string, Buffer>>;
+}
+export declare function discoverSkills(files: Map<string, Buffer>): DiscoveredSkill[];
+export {};
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAqB;gBAEtB,OAAO,CAAC,EAAE,mBAAmB;IAKnC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAmBzF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,EAAE,CAoC5E"}

package/dist/github.js

@@ -0,0 +1,67 @@
+import { GitHubFetchError } from "./errors.js";
+import { parseTarGz } from "./tarball.js";
+const DEFAULT_BASE_URL = "https://api.github.com";
+export class GitHubClient {
+    baseUrl;
+    token;
+    constructor(options) {
+        this.baseUrl = options?.baseUrl ?? DEFAULT_BASE_URL;
+        this.token = options?.token;
+    }
+    async fetchRepo(owner, repo, ref) {
+        const path = ref ? `/repos/${owner}/${repo}/tarball/${ref}` : `/repos/${owner}/${repo}/tarball`;
+        const url = `${this.baseUrl}${path}`;
+        const headers = {};
+        if (this.token) {
+            headers.Authorization = `Bearer ${this.token}`;
+        }
+        const response = await fetch(url, { headers, redirect: "follow" });
+        if (!response.ok) {
+            throw new GitHubFetchError(response.status, `GitHub API error: ${response.status} ${response.statusText} for ${path}`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        return parseTarGz(Buffer.from(arrayBuffer));
+    }
+}
+export function discoverSkills(files) {
+    // Pass 1: find all SKILL.md locations
+    const skillMdEntries = [];
+    for (const [path, content] of files) {
+        if (path === "SKILL.md" || path.endsWith("/SKILL.md")) {
+            const skillDir = path === "SKILL.md" ? "" : path.slice(0, path.lastIndexOf("/"));
+            skillMdEntries.push({ skillDir, content });
+        }
+    }
+    // Pass 2: bucket each non-SKILL.md file into its owning skill directory
+    const buckets = new Map();
+    for (const { skillDir } of skillMdEntries) {
+        buckets.set(skillDir, new Map());
+    }
+    for (const [filePath, fileContent] of files) {
+        if (filePath === "SKILL.md" || filePath.endsWith("/SKILL.md"))
+            continue;
+        for (const skillDir of buckets.keys()) {
+            if (skillDir === "") {
+                if (!filePath.includes("/")) {
+                    buckets.get(skillDir).set(filePath, fileContent);
+                }
+            }
+            else if (filePath.startsWith(skillDir + "/")) {
+                buckets.get(skillDir).set(filePath.slice(skillDir.length + 1), fileContent);
+            }
+        }
+    }
+    return skillMdEntries.map(({ skillDir, content }) => ({
+        path: skillDir || ".",
+        directoryName: getDirectoryName(skillDir),
+        skillMdContent: content,
+        files: buckets.get(skillDir),
+    }));
+}
+function getDirectoryName(skillDir) {
+    if (!skillDir)
+        return "root";
+    const lastSlash = skillDir.lastIndexOf("/");
+    return lastSlash === -1 ? skillDir : skillDir.slice(lastSlash + 1);
+}
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { Client } from "./client.js";
+export type { ClientOptions, StoreOptions } from "./client.js";
+export { FS, Memory } from "./store/index.js";
+export type { Store } from "./store/index.js";
+export { SkillsError, ParseError, GitHubFetchError } from "./errors.js";
+export type { Metadata } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACxE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { Client } from "./client.js";
+export { FS, Memory } from "./store/index.js";
+export { SkillsError, ParseError, GitHubFetchError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,9 @@
+import type { Metadata } from "./types.js";
+/**
+ * Parse a SKILL.md file into its metadata and body.
+ */
+export declare function parseSkillMd(content: string): {
+    metadata: Metadata;
+    body: string;
+};
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAC7C,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAuCA"}

package/dist/parser.js

@@ -0,0 +1,39 @@
+import matter from "gray-matter";
+import { ParseError } from "./errors.js";
+/**
+ * Parse a SKILL.md file into its metadata and body.
+ */
+export function parseSkillMd(content) {
+    const { data, content: body } = matter(content);
+    if (!data.name || typeof data.name !== "string") {
+        throw new ParseError('SKILL.md frontmatter must include a "name" field');
+    }
+    if (!data.description || typeof data.description !== "string") {
+        throw new ParseError('SKILL.md frontmatter must include a "description" field');
+    }
+    const metadata = {
+        name: data.name,
+        description: data.description,
+    };
+    if (data.license != null) {
+        metadata.license = String(data.license);
+    }
+    if (data.compatibility != null) {
+        metadata.compatibility = String(data.compatibility);
+    }
+    const tools = data["allowed-tools"] ?? data.allowedTools;
+    if (tools != null) {
+        if (!Array.isArray(tools)) {
+            throw new ParseError('"allowed-tools" must be an array');
+        }
+        metadata.allowedTools = tools.map(String);
+    }
+    if (data.metadata != null) {
+        if (typeof data.metadata !== "object" || Array.isArray(data.metadata)) {
+            throw new ParseError('"metadata" must be an object');
+        }
+        metadata.metadata = data.metadata;
+    }
+    return { metadata, body: body.trim() };
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAI1C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAEhD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,UAAU,CAAC,kDAAkD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC9D,MAAM,IAAI,UAAU,CAAC,yDAAyD,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,QAAQ,GAAa;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QACzB,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;QAC/B,QAAQ,CAAC,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;IACzD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAC;QAC3D,CAAC;QACD,QAAQ,CAAC,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,CAAC;QACvD,CAAC;QACD,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAmC,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;AACzC,CAAC"}

package/dist/store/fs.d.ts

@@ -0,0 +1,9 @@
+import type { Store } from "./index.js";
+export declare class FS implements Store {
+    write(path: string, content: Buffer): Promise<void>;
+    read(path: string): Promise<Buffer>;
+    list(prefix: string): Promise<string[]>;
+    exists(path: string): Promise<boolean>;
+    delete(path: string): Promise<void>;
+}
+//# sourceMappingURL=fs.d.ts.map

package/dist/store/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/store/fs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,qBAAa,EAAG,YAAW,KAAK;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAStC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/dist/store/fs.js

@@ -0,0 +1,28 @@
+import { readFile, writeFile, readdir, stat, rm, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+export class FS {
+    async write(path, content) {
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, content);
+    }
+    async read(path) {
+        return readFile(path);
+    }
+    async list(prefix) {
+        const entries = await readdir(prefix, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    async exists(path) {
+        try {
+            await stat(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async delete(path) {
+        await rm(path, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/store/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/store/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,OAAO,EAAE;IACb,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAAe;QACvC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/store/gcs.d.ts

@@ -0,0 +1,13 @@
+import type { Storage } from "@google-cloud/storage";
+import type { Store } from "./index.js";
+export declare class GCS implements Store {
+    private storage;
+    private bucketName;
+    constructor(storage: Storage, bucketName: string);
+    write(path: string, content: Buffer): Promise<void>;
+    read(path: string): Promise<Buffer>;
+    list(prefix: string): Promise<string[]>;
+    exists(path: string): Promise<boolean>;
+    delete(path: string): Promise<void>;
+}
+//# sourceMappingURL=gcs.d.ts.map

package/dist/store/gcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs.d.ts","sourceRoot":"","sources":["../../src/store/gcs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,qBAAa,GAAI,YAAW,KAAK;IAC/B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM;IAK1C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAevC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAa1C"}

package/dist/store/gcs.js

@@ -0,0 +1,48 @@
+export class GCS {
+    storage;
+    bucketName;
+    constructor(storage, bucketName) {
+        this.storage = storage;
+        this.bucketName = bucketName;
+    }
+    async write(path, content) {
+        const bucket = this.storage.bucket(this.bucketName);
+        await bucket.file(path).save(content);
+    }
+    async read(path) {
+        const bucket = this.storage.bucket(this.bucketName);
+        const [contents] = await bucket.file(path).download();
+        return Buffer.from(contents);
+    }
+    async list(prefix) {
+        const normalizedPrefix = prefix.endsWith("/") ? prefix : prefix + "/";
+        const bucket = this.storage.bucket(this.bucketName);
+        const [, , apiResponse] = await bucket.getFiles({
+            prefix: normalizedPrefix,
+            delimiter: "/",
+            autoPaginate: false,
+        });
+        const prefixes = apiResponse?.prefixes ?? [];
+        return prefixes.map((p) => {
+            const rest = p.slice(normalizedPrefix.length);
+            return rest.endsWith("/") ? rest.slice(0, -1) : rest;
+        });
+    }
+    async exists(path) {
+        const bucket = this.storage.bucket(this.bucketName);
+        const [exists] = await bucket.file(path).exists();
+        return exists;
+    }
+    async delete(path) {
+        const bucket = this.storage.bucket(this.bucketName);
+        // Delete the exact key itself
+        await bucket.file(path).delete({ ignoreNotFound: true });
+        // Delete all children under path/
+        const normalizedPrefix = path.endsWith("/") ? path : path + "/";
+        const [files] = await bucket.getFiles({ prefix: normalizedPrefix });
+        for (const file of files) {
+            await file.delete();
+        }
+    }
+}
+//# sourceMappingURL=gcs.js.map

package/dist/store/gcs.js.map

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

package/dist/store/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Low-level storage backend for reading and writing raw files.
+ */
+export interface Store {
+    /** Write content to the given path, creating parent directories as needed. */
+    write(path: string, content: Buffer): Promise<void>;
+    /** Read raw content from the given path. */
+    read(path: string): Promise<Buffer>;
+    /** List immediate child directory names under the given prefix. */
+    list(prefix: string): Promise<string[]>;
+    /** Check whether a file or directory exists at the given path. */
+    exists(path: string): Promise<boolean>;
+    /** Recursively delete the file or directory at the given path. */
+    delete(path: string): Promise<void>;
+}
+export { Memory } from "./memory.js";
+export { FS } from "./fs.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,8EAA8E;IAC9E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,4CAA4C;IAC5C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,mEAAmE;IACnE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,kEAAkE;IAClE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,kEAAkE;IAClE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC"}

package/dist/store/index.js

@@ -0,0 +1,3 @@
+export { Memory } from "./memory.js";
+export { FS } from "./fs.js";
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC"}

package/dist/store/memory.d.ts

@@ -0,0 +1,10 @@
+import type { Store } from "./index.js";
+export declare class Memory implements Store {
+    private files;
+    write(path: string, content: Buffer): Promise<void>;
+    read(path: string): Promise<Buffer>;
+    list(prefix: string): Promise<string[]>;
+    exists(path: string): Promise<boolean>;
+    delete(path: string): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/store/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/store/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,qBAAa,MAAO,YAAW,KAAK;IAClC,OAAO,CAAC,KAAK,CAA6B;IAEpC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQnC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBvC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAStC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ1C"}

package/dist/store/memory.js

@@ -0,0 +1,48 @@
+export class Memory {
+    files = new Map();
+    async write(path, content) {
+        this.files.set(path, content);
+    }
+    async read(path) {
+        const content = this.files.get(path);
+        if (!content) {
+            throw new Error(`ENOENT: no such file: ${path}`);
+        }
+        return content;
+    }
+    async list(prefix) {
+        const normalizedPrefix = prefix.endsWith("/") ? prefix : prefix + "/";
+        const dirs = new Set();
+        for (const key of this.files.keys()) {
+            if (!key.startsWith(normalizedPrefix))
+                continue;
+            const rest = key.slice(normalizedPrefix.length);
+            const slashIndex = rest.indexOf("/");
+            if (slashIndex !== -1) {
+                dirs.add(rest.slice(0, slashIndex));
+            }
+        }
+        return [...dirs];
+    }
+    async exists(path) {
+        if (this.files.has(path))
+            return true;
+        const dirPrefix = path.endsWith("/") ? path : path + "/";
+        for (const key of this.files.keys()) {
+            if (key.startsWith(dirPrefix))
+                return true;
+        }
+        return false;
+    }
+    async delete(path) {
+        const dirPrefix = path.endsWith("/") ? path : path + "/";
+        const toDelete = [path];
+        for (const key of this.files.keys()) {
+            if (key.startsWith(dirPrefix))
+                toDelete.push(key);
+        }
+        for (const key of toDelete)
+            this.files.delete(key);
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/store/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/store/memory.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,MAAM;IACT,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAAe;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;QACtE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC;gBAAE,SAAS;YAChD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC;QACzD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC7C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC;QACzD,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,QAAQ;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/store/s3.d.ts

@@ -0,0 +1,13 @@
+import type { S3Client } from "@aws-sdk/client-s3";
+import type { Store } from "./index.js";
+export declare class S3 implements Store {
+    private client;
+    private bucket;
+    constructor(client: S3Client, bucket: string);
+    write(path: string, content: Buffer): Promise<void>;
+    read(path: string): Promise<Buffer>;
+    list(prefix: string): Promise<string[]>;
+    exists(path: string): Promise<boolean>;
+    delete(path: string): Promise<void>;
+}
+//# sourceMappingURL=s3.d.ts.map

package/dist/store/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../src/store/s3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAIT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,qBAAa,EAAG,YAAW,KAAK;IAC9B,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;IAKtC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAenC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA8BvC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA4C1C"}

package/dist/store/s3.js

@@ -0,0 +1,104 @@
+export class S3 {
+    client;
+    bucket;
+    constructor(client, bucket) {
+        this.client = client;
+        this.bucket = bucket;
+    }
+    async write(path, content) {
+        const { PutObjectCommand } = await import("@aws-sdk/client-s3");
+        const params = {
+            Bucket: this.bucket,
+            Key: path,
+            Body: content,
+        };
+        await this.client.send(new PutObjectCommand(params));
+    }
+    async read(path) {
+        const { GetObjectCommand } = await import("@aws-sdk/client-s3");
+        const params = {
+            Bucket: this.bucket,
+            Key: path,
+        };
+        const response = await this.client.send(new GetObjectCommand(params));
+        const stream = response.Body;
+        if (!stream) {
+            throw new Error(`Empty response body for key: ${path}`);
+        }
+        const bytes = await stream.transformToByteArray();
+        return Buffer.from(bytes);
+    }
+    async list(prefix) {
+        const { ListObjectsV2Command } = await import("@aws-sdk/client-s3");
+        const normalizedPrefix = prefix.endsWith("/") ? prefix : prefix + "/";
+        const dirs = [];
+        let continuationToken;
+        do {
+            const response = await this.client.send(new ListObjectsV2Command({
+                Bucket: this.bucket,
+                Prefix: normalizedPrefix,
+                Delimiter: "/",
+                ContinuationToken: continuationToken,
+            }));
+            for (const cp of response.CommonPrefixes ?? []) {
+                if (!cp.Prefix)
+                    continue;
+                const rest = cp.Prefix.slice(normalizedPrefix.length);
+                dirs.push(rest.endsWith("/") ? rest.slice(0, -1) : rest);
+            }
+            continuationToken = response.IsTruncated
+                ? response.NextContinuationToken
+                : undefined;
+        } while (continuationToken);
+        return dirs;
+    }
+    async exists(path) {
+        const { HeadObjectCommand } = await import("@aws-sdk/client-s3");
+        try {
+            const params = {
+                Bucket: this.bucket,
+                Key: path,
+            };
+            await this.client.send(new HeadObjectCommand(params));
+            return true;
+        }
+        catch (err) {
+            if (err instanceof Error &&
+                (err.name === "NotFound" || err.name === "NoSuchKey")) {
+                return false;
+            }
+            throw err;
+        }
+    }
+    async delete(path) {
+        const { ListObjectsV2Command, DeleteObjectsCommand } = await import("@aws-sdk/client-s3");
+        // Delete the exact key itself
+        await this.client.send(new DeleteObjectsCommand({
+            Bucket: this.bucket,
+            Delete: { Objects: [{ Key: path }] },
+        }));
+        // Delete all children under path/
+        const normalizedPrefix = path.endsWith("/") ? path : path + "/";
+        let continuationToken;
+        do {
+            const response = await this.client.send(new ListObjectsV2Command({
+                Bucket: this.bucket,
+                Prefix: normalizedPrefix,
+                ContinuationToken: continuationToken,
+            }));
+            const objects = (response.Contents ?? [])
+                .filter((obj) => obj.Key)
+                .map((obj) => ({ Key: obj.Key }));
+            if (objects.length > 0) {
+                await this.client.send(new DeleteObjectsCommand({
+                    Bucket: this.bucket,
+                    Delete: { Objects: objects },
+                }));
+            }
+            continuationToken = response.IsTruncated
+                ? response.NextContinuationToken
+                : undefined;
+        } while (continuationToken);
+    }
+}
+//# sourceMappingURL=s3.js.map

package/dist/store/s3.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Low-level storage backend for reading and writing raw files.
+ */
+export interface Store {
+    /** Write content to the given path, creating parent directories as needed. */
+    write(path: string, content: Buffer): Promise<void>;
+    /** Read raw content from the given path. */
+    read(path: string): Promise<Buffer>;
+    /** List immediate child directory names under the given prefix. */
+    list(prefix: string): Promise<string[]>;
+    /** Check whether a file or directory exists at the given path. */
+    exists(path: string): Promise<boolean>;
+    /** Recursively delete the file or directory at the given path. */
+    delete(path: string): Promise<void>;
+}
+/**
+ * Store implementation backed by the local filesystem.
+ */
+export declare class FileSystemStore implements Store {
+    write(path: string, content: Buffer): Promise<void>;
+    read(path: string): Promise<Buffer>;
+    list(prefix: string): Promise<string[]>;
+    exists(path: string): Promise<boolean>;
+    delete(path: string): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,8EAA8E;IAC9E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,4CAA4C;IAC5C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,mEAAmE;IACnE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,kEAAkE;IAClE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,kEAAkE;IAClE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,KAAK;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAStC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/dist/store.js

@@ -0,0 +1,31 @@
+import { readFile, writeFile, readdir, stat, rm, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+/**
+ * Store implementation backed by the local filesystem.
+ */
+export class FileSystemStore {
+    async write(path, content) {
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, content);
+    }
+    async read(path) {
+        return readFile(path);
+    }
+    async list(prefix) {
+        const entries = await readdir(prefix, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    async exists(path) {
+        try {
+            await stat(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async delete(path) {
+        await rm(path, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAAe;QACvC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/tarball.d.ts

@@ -0,0 +1,2 @@
+export declare function parseTarGz(compressed: Buffer): Map<string, Buffer>;
+//# sourceMappingURL=tarball.d.ts.map

package/dist/tarball.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tarball.d.ts","sourceRoot":"","sources":["../src/tarball.ts"],"names":[],"mappings":"AAYA,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAmDlE"}

package/dist/tarball.js

@@ -0,0 +1,68 @@
+import { gunzipSync } from "node:zlib";
+// POSIX tar header field offsets and sizes (bytes)
+const BLOCK_SIZE = 512;
+const NAME_OFFSET = 0;
+const NAME_LENGTH = 100;
+const SIZE_OFFSET = 124;
+const SIZE_LENGTH = 12;
+const TYPEFLAG_OFFSET = 156;
+const PREFIX_OFFSET = 345;
+const PREFIX_LENGTH = 155;
+export function parseTarGz(compressed) {
+    const tar = gunzipSync(compressed);
+    const files = new Map();
+    let offset = 0;
+    let paxPath;
+    // GitHub tarballs nest all files under a single prefix directory (e.g. "owner-repo-sha/").
+    // We detect this from the first path containing "/" and strip it from all entries.
+    let stripPrefix = "";
+    while (offset + BLOCK_SIZE <= tar.length) {
+        const header = tar.subarray(offset, offset + BLOCK_SIZE);
+        if (header.every((b) => b === 0))
+            break;
+        const name = readString(header, NAME_OFFSET, NAME_LENGTH);
+        const size = readOctal(header, SIZE_OFFSET, SIZE_LENGTH);
+        const typeflag = String.fromCharCode(header[TYPEFLAG_OFFSET]);
+        const prefix = readString(header, PREFIX_OFFSET, PREFIX_LENGTH);
+        const fullName = prefix ? `${prefix}/${name}` : name;
+        const dataBlocks = size > 0 ? Math.ceil(size / BLOCK_SIZE) * BLOCK_SIZE : 0;
+        offset += BLOCK_SIZE;
+        if (typeflag === "x") {
+            const paxData = tar.subarray(offset, offset + size).toString("utf-8");
+            paxPath = extractPaxPath(paxData);
+            offset += dataBlocks;
+            continue;
+        }
+        let path = paxPath ?? fullName;
+        paxPath = undefined;
+        if (!stripPrefix && path.includes("/")) {
+            stripPrefix = path.slice(0, path.indexOf("/") + 1);
+        }
+        if (stripPrefix && path.startsWith(stripPrefix)) {
+            path = path.slice(stripPrefix.length);
+        }
+        if ((typeflag === "0" || typeflag === "\0") && path) {
+            files.set(path, Buffer.from(tar.subarray(offset, offset + size)));
+        }
+        offset += dataBlocks;
+    }
+    return files;
+}
+function readString(buf, offset, length) {
+    const slice = buf.subarray(offset, offset + length);
+    const nullIdx = slice.indexOf(0);
+    return slice.subarray(0, nullIdx === -1 ? length : nullIdx).toString("utf-8");
+}
+function readOctal(buf, offset, length) {
+    const str = readString(buf, offset, length).trim();
+    return str ? parseInt(str, 8) : 0;
+}
+function extractPaxPath(data) {
+    for (const line of data.split("\n")) {
+        const match = line.match(/^\d+ path=(.+)/);
+        if (match?.[1])
+            return match[1];
+    }
+    return undefined;
+}
+//# sourceMappingURL=tarball.js.map

package/dist/tarball.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The frontmatter of a SKILL.md.
+ */
+export interface Metadata {
+    name: string;
+    description: string;
+    license?: string;
+    compatibility?: string;
+    allowedTools?: string[];
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "skills-sdk",
+  "version": "0.1.0",
+  "description": "Skills SDK for JavaScript",
+  "type": "module",
+  "keywords": [
+    "agent skills",
+    "skills"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a4s-lab/skills.git",
+    "directory": "js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "gray-matter": "^4"
+  },
+  "devDependencies": {
+    "@types/node": "^25",
+    "prettier": "^3.8.1",
+    "typescript": "^5",
+    "vitest": "^3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  }
+}