agent-dir 0.0.0-stage → 0.1.2

package/dist/src/tools/git.d.ts

@@ -0,0 +1,15 @@
+export interface GitResult {
+    command: string;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function gitStage(root: string, paths: string[]): Promise<GitResult>;
+export declare function gitUnstage(root: string, paths: string[]): Promise<GitResult>;
+export declare function gitCommit(root: string, message: string): Promise<GitResult>;
+export declare function gitPush(root: string, remote?: string, branch?: string): Promise<GitResult>;
+export declare function gitStatus(root: string): Promise<GitResult>;
+export declare function gitDiff(root: string, staged?: boolean, pathspec?: string): Promise<GitResult>;
+export declare function gitRestore(root: string, paths: string[], staged?: boolean): Promise<GitResult>;
+export declare function gitLog(root: string, limit?: number, pathspec?: string): Promise<GitResult>;
+//# sourceMappingURL=git.d.ts.map

package/dist/src/tools/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/tools/git.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AA6CD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAG1E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAG5E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAG3E;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAa1F;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAE1D;AACD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,UAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAK3F;AACD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAG5F;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAatF"}

package/dist/src/tools/git.js

@@ -0,0 +1,104 @@
+import { spawn } from "node:child_process";
+function validatePaths(paths) {
+    if (!Array.isArray(paths) ||
+        paths.length === 0 ||
+        paths.some((path) => typeof path !== "string" || !path)) {
+        throw new Error("paths must contain at least one non-empty path.");
+    }
+}
+function runGit(root, args, timeoutMs = 30000) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("git", args, { cwd: root, shell: false, env: process.env });
+        let stdout = "";
+        let stderr = "";
+        let finished = false;
+        const timer = setTimeout(() => {
+            if (finished)
+                return;
+            finished = true;
+            child.kill("SIGTERM");
+            reject(new Error(`git ${args.join(" ")} timed out after ${timeoutMs}ms.`));
+        }, timeoutMs);
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on("error", (error) => {
+            if (finished)
+                return;
+            finished = true;
+            clearTimeout(timer);
+            reject(error);
+        });
+        child.on("close", (code) => {
+            if (finished)
+                return;
+            finished = true;
+            clearTimeout(timer);
+            resolve({ command: ["git", ...args].join(" "), exitCode: code ?? 1, stdout, stderr });
+        });
+    });
+}
+export function gitStage(root, paths) {
+    validatePaths(paths);
+    return runGit(root, ["add", "--", ...paths]);
+}
+export function gitUnstage(root, paths) {
+    validatePaths(paths);
+    return runGit(root, ["restore", "--staged", "--", ...paths]);
+}
+export function gitCommit(root, message) {
+    if (!message.trim())
+        throw new Error("commit message must not be empty.");
+    return runGit(root, ["commit", "-m", message]);
+}
+export function gitPush(root, remote, branch) {
+    const args = ["push"];
+    if (remote) {
+        if (!/^[A-Za-z0-9._-]+$/.test(remote))
+            throw new Error("Invalid Git remote name.");
+        args.push(remote);
+        if (branch) {
+            if (!/^[A-Za-z0-9._/-]+$/.test(branch))
+                throw new Error("Invalid Git branch name.");
+            args.push(branch);
+        }
+    }
+    else if (branch) {
+        throw new Error("A Git remote is required when specifying a branch.");
+    }
+    return runGit(root, args);
+}
+export function gitStatus(root) {
+    return runGit(root, ["status", "--short", "--branch"]);
+}
+export function gitDiff(root, staged = false, pathspec) {
+    const args = ["diff", "--no-ext-diff", "--no-color"];
+    if (staged)
+        args.push("--cached");
+    if (pathspec)
+        args.push("--", pathspec);
+    return runGit(root, args);
+}
+export function gitRestore(root, paths, staged = false) {
+    validatePaths(paths);
+    return runGit(root, ["restore", ...(staged ? ["--staged"] : []), "--", ...paths]);
+}
+export function gitLog(root, limit = 20, pathspec) {
+    if (!Number.isInteger(limit) || limit < 1 || limit > 200)
+        throw new Error("limit must be an integer between 1 and 200.");
+    const args = [
+        "log",
+        "--no-color",
+        "--date=iso-strict",
+        "--format=%H%x09%ad%x09%an%x09%s",
+        "-n",
+        String(limit),
+    ];
+    if (pathspec)
+        args.push("--", pathspec);
+    return runGit(root, args);
+}
+//# sourceMappingURL=git.js.map

package/dist/src/tools/git.js.map

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

package/dist/src/tools/metadata.d.ts

@@ -0,0 +1,20 @@
+export interface ProjectOverview {
+    root: string;
+    files: number;
+    directories: number;
+    languages: Array<{
+        extension: string;
+        files: number;
+    }>;
+    packageManagers: string[];
+    projectFiles: string[];
+    git: {
+        available: boolean;
+        branch?: string;
+        clean?: boolean;
+    };
+}
+export declare function fileInfo(root: string, relativePath: string): Promise<Record<string, unknown>>;
+export declare function packageInfo(root: string): Promise<Record<string, unknown>>;
+export declare function projectOverview(root: string): Promise<ProjectOverview>;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/src/tools/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/tools/metadata.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,GAAG,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/D;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoBlC;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBhF;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAuD5E"}

package/dist/src/tools/metadata.js

@@ -0,0 +1,101 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { listFiles } from "./files.js";
+import { gitStatus } from "./git.js";
+export async function fileInfo(root, relativePath) {
+    const resolvedRoot = await fs.realpath(root);
+    const target = path.resolve(resolvedRoot, relativePath);
+    if (target !== resolvedRoot && !target.startsWith(`${resolvedRoot}${path.sep}`))
+        throw new Error("Path escapes the exposed project directory.");
+    const stat = await fs.lstat(target);
+    return {
+        path: relativePath,
+        type: stat.isDirectory()
+            ? "directory"
+            : stat.isFile()
+                ? "file"
+                : stat.isSymbolicLink()
+                    ? "symlink"
+                    : "other",
+        size: stat.size,
+        mode: (stat.mode & 0o777).toString(8),
+        modifiedAt: stat.mtime.toISOString(),
+        createdAt: stat.birthtime.toISOString(),
+    };
+}
+export async function packageInfo(root) {
+    const packagePath = path.join(await fs.realpath(root), "package.json");
+    try {
+        const packageJson = JSON.parse(await fs.readFile(packagePath, "utf8"));
+        return {
+            path: "package.json",
+            name: packageJson.name ?? null,
+            version: packageJson.version ?? null,
+            description: packageJson.description ?? null,
+            packageManager: packageJson.packageManager ?? null,
+            engines: packageJson.engines ?? null,
+            scripts: packageJson.scripts ?? {},
+            dependencies: packageJson.dependencies ?? {},
+            devDependencies: packageJson.devDependencies ?? {},
+        };
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return { path: "package.json", exists: false };
+        throw new Error("package.json exists but is not valid JSON.");
+    }
+}
+export async function projectOverview(root) {
+    const entries = await listFiles(root);
+    const files = entries.filter((entry) => entry.type === "file");
+    const directories = entries.filter((entry) => entry.type === "directory");
+    const counts = new Map();
+    for (const file of files) {
+        const extension = path.extname(file.path).toLowerCase() || "[no extension]";
+        counts.set(extension, (counts.get(extension) ?? 0) + 1);
+    }
+    const rootEntries = await fs.readdir(await fs.realpath(root));
+    const packageManagerPairs = [
+        ["package-lock.json", "npm"],
+        ["pnpm-lock.yaml", "pnpm"],
+        ["yarn.lock", "yarn"],
+        ["bun.lock", "bun"],
+        ["bun.lockb", "bun"],
+        ["Cargo.lock", "cargo"],
+        ["go.sum", "go"],
+        ["poetry.lock", "poetry"],
+        ["uv.lock", "uv"],
+    ];
+    const packageManagers = packageManagerPairs
+        .filter(([file]) => rootEntries.includes(file))
+        .map(([, manager]) => manager);
+    const projectFiles = rootEntries.filter((name) => /^(README|LICENSE|CONTRIBUTING|CHANGELOG)(?:\.|$)|^(package|tsconfig|pyproject|Cargo|go\.mod)/i.test(name));
+    let git = { available: false };
+    try {
+        const status = await gitStatus(root);
+        if (status.exitCode === 0) {
+            const firstLine = status.stdout.split(/\r?\n/)[0] ?? "";
+            const branch = firstLine.match(/^##\s+(.+?)(?:\.\.\.|$)/)?.[1];
+            git = {
+                available: true,
+                ...(branch ? { branch } : {}),
+                clean: status.stdout.split(/\r?\n/).filter(Boolean).length <= 1,
+            };
+        }
+    }
+    catch {
+        git = { available: false };
+    }
+    return {
+        root,
+        files: files.length,
+        directories: directories.length,
+        languages: [...counts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .map(([extension, count]) => ({ extension, files: count })),
+        packageManagers,
+        projectFiles,
+        git,
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/src/tools/metadata.js.map

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

package/dist/src/tools/npm.d.ts

@@ -0,0 +1,3 @@
+import type { CommandResult } from "./commands.js";
+export declare function runNpm(root: string, script: string, timeoutMs?: number, allowedScripts?: string[], signal?: AbortSignal): Promise<CommandResult>;
+//# sourceMappingURL=npm.d.ts.map

package/dist/src/tools/npm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.d.ts","sourceRoot":"","sources":["../../../src/tools/npm.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAMnD,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,SAAS,EAClB,cAAc,GAAE,MAAM,EAAO,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAqExB"}

package/dist/src/tools/npm.js

@@ -0,0 +1,76 @@
+import { spawn } from "node:child_process";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+export function runNpm(root, script, timeoutMs = 120000, allowedScripts = [], signal) {
+    if (!/^[A-Za-z0-9:_-]+$/.test(script))
+        throw new Error("Invalid npm script name.");
+    return (async () => {
+        let packageJson;
+        try {
+            packageJson = JSON.parse(await fs.readFile(path.join(root, "package.json"), "utf8"));
+        }
+        catch {
+            throw new Error("No valid package.json found.");
+        }
+        if (!packageJson.scripts?.[script])
+            throw new Error(`npm script '${script}' does not exist in package.json.`);
+        if (!allowedScripts.includes(script))
+            throw new Error(`npm script '${script}' is not allowed by this profile.`);
+        return new Promise((resolve, reject) => {
+            const executable = process.platform === "win32" ? "npm.cmd" : "npm";
+            const child = spawn(executable, ["run", script], {
+                cwd: root,
+                shell: false,
+                env: process.env,
+            });
+            let stdout = "";
+            let stderr = "";
+            let finished = false;
+            let timer;
+            const abort = () => {
+                if (finished)
+                    return;
+                finished = true;
+                clearTimeout(timer);
+                child.kill("SIGTERM");
+                reject(new Error(`npm run ${script} was aborted.`));
+            };
+            timer = setTimeout(() => {
+                if (finished)
+                    return;
+                finished = true;
+                child.kill("SIGTERM");
+                signal?.removeEventListener("abort", abort);
+                reject(new Error(`npm run ${script} timed out after ${timeoutMs}ms.`));
+            }, timeoutMs);
+            if (signal?.aborted) {
+                abort();
+                return;
+            }
+            signal?.addEventListener("abort", abort, { once: true });
+            child.stdout.on("data", (chunk) => {
+                stdout += chunk.toString();
+            });
+            child.stderr.on("data", (chunk) => {
+                stderr += chunk.toString();
+            });
+            child.on("error", (error) => {
+                if (!finished) {
+                    finished = true;
+                    clearTimeout(timer);
+                    signal?.removeEventListener("abort", abort);
+                    reject(error);
+                }
+            });
+            child.on("close", (code) => {
+                if (!finished) {
+                    finished = true;
+                    clearTimeout(timer);
+                    signal?.removeEventListener("abort", abort);
+                    resolve({ command: `npm run ${script}`, exitCode: code ?? 1, stdout, stderr });
+                }
+            });
+        });
+    })();
+}
+//# sourceMappingURL=npm.js.map

package/dist/src/tools/npm.js.map

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

package/dist/src/tools/skills.d.ts

@@ -0,0 +1,33 @@
+export interface SkillResource {
+    uri: string;
+    digest: string;
+    size: number;
+}
+export interface SkillEntry {
+    uri: string;
+    frontmatter: Record<string, unknown> & {
+        name: string;
+        description: string;
+    };
+    resources: SkillResource[] | "dynamic";
+}
+export declare function listSkills(root: string): Promise<SkillEntry[]>;
+export declare function getSkill(root: string, uri: string): Promise<SkillEntry>;
+export declare function readSkillResource(root: string, uri: string): Promise<{
+    uri: string;
+    mimeType: string;
+    text?: string;
+    blob?: string;
+}>;
+export declare function readSkillDirectory(root: string, uri: string): Promise<Array<{
+    uri: string;
+    name: string;
+    mimeType: string;
+}>>;
+export declare function listSkillResources(root: string): Promise<Array<{
+    uri: string;
+    name: string;
+    mimeType: string;
+}>>;
+export declare function skillResourceUrisForPath(root: string, relativePath: string): Promise<string[]>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/src/tools/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/tools/skills.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,SAAS,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC;CACxC;AAMD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAEpE;AACD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAI7E;AACD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAY1E;AACD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAmCjE;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAQjE;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAUnB"}

package/dist/src/tools/skills.js

@@ -0,0 +1,240 @@
+import { createHash } from "node:crypto";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { listFiles } from "./files.js";
+const SKILL_ROOTS = ["skills", ".agents/skills", ".claude/skills", ".github/skills"];
+const MAX_RESOURCES = 512;
+const MAX_TOTAL_BYTES = 16 * 1024 * 1024;
+const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const MAX_SKILL_NAME_LENGTH = 64;
+const MAX_DESCRIPTION_LENGTH = 1024;
+export async function listSkills(root) {
+    return (await discoverSkills(root)).map((skill) => skill.entry);
+}
+export async function getSkill(root, uri) {
+    const skill = (await discoverSkills(root)).find((item) => item.entry.uri === uri);
+    if (!skill)
+        throw new Error(`Unknown skill: ${uri}`);
+    return skill.entry;
+}
+export async function readSkillResource(root, uri) {
+    for (const skill of await discoverSkills(root)) {
+        const filePath = skill.resources.get(uri);
+        if (!filePath)
+            continue;
+        const bytes = await fs.readFile(filePath);
+        const text = bytes.toString("utf8");
+        if (Buffer.from(text, "utf8").equals(bytes)) {
+            return { uri, mimeType: mimeTypeFor(filePath), text };
+        }
+        return { uri, mimeType: mimeTypeFor(filePath), blob: bytes.toString("base64") };
+    }
+    throw new Error(`Unknown skill resource: ${uri}`);
+}
+export async function readSkillDirectory(root, uri) {
+    const prefix = "skill://";
+    if (!uri.startsWith(prefix) || uri.endsWith("/") || uri === prefix)
+        throw new Error(`Unknown skill directory: ${uri}`);
+    const relativeDirectory = uri.slice(prefix.length);
+    const resolvedRoot = await fs.realpath(root);
+    for (const skillRoot of SKILL_ROOTS) {
+        const directoryPath = path.join(resolvedRoot, skillRoot, ...relativeDirectory.split("/"));
+        const candidate = path.resolve(directoryPath);
+        if (candidate !== resolvedRoot && !candidate.startsWith(`${resolvedRoot}${path.sep}`))
+            continue;
+        try {
+            const resolvedDirectory = await fs.realpath(candidate);
+            if (resolvedDirectory !== resolvedRoot &&
+                !resolvedDirectory.startsWith(`${resolvedRoot}${path.sep}`))
+                continue;
+            const stats = await fs.stat(resolvedDirectory);
+            if (!stats.isDirectory())
+                continue;
+            const entries = await fs.readdir(resolvedDirectory, { withFileTypes: true });
+            return entries
+                .map((entry) => {
+                const childUri = `${uri}/${entry.name}`;
+                return {
+                    uri: childUri,
+                    name: entry.name,
+                    mimeType: entry.isDirectory() ? "inode/directory" : mimeTypeFor(entry.name),
+                };
+            })
+                .sort((a, b) => a.uri.localeCompare(b.uri));
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+    }
+    throw new Error(`Unknown skill directory: ${uri}`);
+}
+export async function listSkillResources(root) {
+    return (await discoverSkills(root)).flatMap((skill) => [...skill.resources.entries()].map(([uri, filePath]) => ({
+        uri,
+        name: path.basename(filePath),
+        mimeType: mimeTypeFor(filePath),
+    })));
+}
+export async function skillResourceUrisForPath(root, relativePath) {
+    const resolvedRoot = await fs.realpath(root);
+    const target = path.resolve(resolvedRoot, relativePath);
+    const matches = new Set();
+    for (const skill of await discoverSkills(root)) {
+        for (const [uri, filePath] of skill.resources) {
+            if (path.resolve(filePath) === target)
+                matches.add(uri);
+        }
+    }
+    return [...matches].sort();
+}
+async function discoverSkills(root) {
+    const resolvedRoot = await fs.realpath(root);
+    const entries = await listFiles(root);
+    const skills = [];
+    for (const skillFile of entries.filter((entry) => entry.type === "file" && path.basename(entry.path) === "SKILL.md")) {
+        const normalizedSkillFile = skillFile.path.replaceAll(path.sep, "/");
+        const skillRoot = SKILL_ROOTS.find((rootName) => normalizedSkillFile === `${rootName}/SKILL.md` ||
+            normalizedSkillFile.startsWith(`${rootName}/`));
+        if (!skillRoot)
+            continue;
+        const skillPath = path.posix.dirname(normalizedSkillFile);
+        const relativeSkillPath = path.posix.relative(skillRoot, skillPath);
+        if (!relativeSkillPath ||
+            relativeSkillPath === "." ||
+            relativeSkillPath.startsWith("../") ||
+            path.posix.isAbsolute(relativeSkillPath))
+            continue;
+        const markdown = await fs.readFile(path.join(resolvedRoot, skillFile.path), "utf8");
+        const parsedFrontmatter = parseFrontmatter(markdown);
+        if (!parsedFrontmatter)
+            continue;
+        const nameValue = parsedFrontmatter.values.name;
+        const descriptionValue = parsedFrontmatter.values.description;
+        if (typeof nameValue !== "string" || typeof descriptionValue !== "string")
+            continue;
+        if (nameValue !== path.posix.basename(skillPath) ||
+            !SKILL_NAME_PATTERN.test(nameValue) ||
+            nameValue.length > MAX_SKILL_NAME_LENGTH ||
+            descriptionValue.length === 0 ||
+            descriptionValue.length > MAX_DESCRIPTION_LENGTH)
+            continue;
+        const skillUriPath = relativeSkillPath;
+        const skillUri = `skill://${skillUriPath}`;
+        const resources = [];
+        const resourceMap = new Map();
+        const descendants = entries.filter((entry) => entry.type === "file" &&
+            (entry.path === skillFile.path ||
+                entry.path.replaceAll(path.sep, "/").startsWith(`${skillPath}/`)));
+        if (descendants.length > MAX_RESOURCES)
+            continue;
+        let totalBytes = 0;
+        for (const resource of descendants) {
+            const normalizedResourcePath = resource.path.replaceAll(path.sep, "/");
+            const relative = path.posix.relative(skillPath, normalizedResourcePath);
+            const uri = `${skillUri}/${relative}`;
+            const filePath = path.join(resolvedRoot, resource.path);
+            const bytes = await fs.readFile(filePath);
+            totalBytes += bytes.length;
+            if (totalBytes > MAX_TOTAL_BYTES) {
+                totalBytes = -1;
+                break;
+            }
+            resources.push({
+                uri,
+                digest: `sha256:${createHash("sha256").update(bytes).digest("hex")}`,
+                size: bytes.length,
+            });
+            resourceMap.set(uri, filePath);
+        }
+        if (totalBytes < 0 || resources.length === 0)
+            continue;
+        resources.sort((a, b) => a.uri.localeCompare(b.uri));
+        skills.push({
+            entry: {
+                uri: `${skillUri}/SKILL.md`,
+                frontmatter: parsedFrontmatter.values,
+                resources,
+            },
+            resources: resourceMap,
+        });
+    }
+    return skills.sort((a, b) => a.entry.uri.localeCompare(b.entry.uri));
+}
+function parseFrontmatter(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    if ((lines[0] ?? "").trim() !== "---")
+        return undefined;
+    const end = lines.findIndex((line, index) => index > 0 && line.trim() === "---");
+    if (end < 0)
+        return undefined;
+    const result = {};
+    for (let index = 1; index < end; index += 1) {
+        const line = lines[index] ?? "";
+        if (!line.trim())
+            continue;
+        const match = line.match(/^([A-Za-z0-9_.-]+):\s*(.*)$/);
+        if (!match)
+            return undefined;
+        const key = match[1] ?? "";
+        if (Object.hasOwn(result, key))
+            return undefined;
+        const raw = match[2] ?? "";
+        result[key] = parseScalar(raw);
+    }
+    return { raw: lines.slice(1, end).join("\n"), values: result };
+}
+function parseScalar(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return "";
+    if (trimmed === "true")
+        return true;
+    if (trimmed === "false")
+        return false;
+    if (trimmed === "null")
+        return null;
+    if (/^-?\d+(?:\.\d+)?$/.test(trimmed))
+        return Number(trimmed);
+    if ((trimmed.startsWith("[") && trimmed.endsWith("]")) ||
+        (trimmed.startsWith("{") && trimmed.endsWith("}"))) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return trimmed;
+        }
+    }
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+function mimeTypeFor(filePath) {
+    switch (path.extname(filePath).toLowerCase()) {
+        case ".md":
+            return "text/markdown";
+        case ".json":
+            return "application/json";
+        case ".yaml":
+        case ".yml":
+            return "text/yaml";
+        case ".js":
+        case ".mjs":
+        case ".cjs":
+        case ".ts":
+        case ".mts":
+        case ".cts":
+            return "text/javascript";
+        case ".css":
+            return "text/css";
+        case ".html":
+            return "text/html";
+        case ".py":
+            return "text/x-python";
+        default:
+            return "text/plain";
+    }
+}
+//# sourceMappingURL=skills.js.map