@di-code/coding-agent 0.1.1 → 0.1.3

package/dist/core/resources/loader.js

@@ -0,0 +1,174 @@
+import { access, readFile, stat } from "node:fs/promises";
+import { dirname, join, parse, resolve } from "node:path";
+import { discoverSkills, loadSkill } from "./skills.js";
+const MAX_CONTEXT_FILE_BYTES = 256 * 1024;
+function isMissingPath(cause) {
+    return cause instanceof Error && "code" in cause && cause.code === "ENOENT";
+}
+function contextDiagnostic(path, stage, message) {
+    return { path, kind: "agents", stage, severity: "warning", message };
+}
+async function locateAgentsFile(directory) {
+    for (const name of ["AGENTS.md", "AGENTS.MD"]) {
+        const path = join(directory, name);
+        try {
+            if ((await stat(path)).isFile())
+                return path;
+        }
+        catch (cause) {
+            if (!isMissingPath(cause))
+                throw cause;
+        }
+    }
+    return undefined;
+}
+async function loadContextFile(path, scope) {
+    try {
+        const metadata = await stat(path);
+        if (metadata.size > MAX_CONTEXT_FILE_BYTES) {
+            return { diagnostic: contextDiagnostic(path, "read", `AGENTS.md exceeds ${MAX_CONTEXT_FILE_BYTES} byte limit`) };
+        }
+        return { file: { kind: "agents", path: resolve(path), scope, content: await readFile(path, "utf8") } };
+    }
+    catch (cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        return { diagnostic: contextDiagnostic(path, "read", `Failed to read AGENTS.md: ${message}`) };
+    }
+}
+async function loadContextFiles(options) {
+    if (options.noContextFiles)
+        return { contextFiles: [], diagnostics: [] };
+    const contextFiles = [];
+    const diagnostics = [];
+    const seen = new Set();
+    const add = async (directory, scope) => {
+        let path;
+        try {
+            path = await locateAgentsFile(directory);
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : String(cause);
+            diagnostics.push(contextDiagnostic(directory, "discover", `Failed to discover AGENTS.md: ${message}`));
+            return;
+        }
+        if (!path)
+            return;
+        const absolutePath = resolve(path);
+        if (seen.has(absolutePath))
+            return;
+        seen.add(absolutePath);
+        const loaded = await loadContextFile(absolutePath, scope);
+        if (loaded.file)
+            contextFiles.push(loaded.file);
+        if (loaded.diagnostic)
+            diagnostics.push(loaded.diagnostic);
+    };
+    await add(resolve(options.agentDir), "global");
+    const ancestors = [];
+    let current = resolve(options.cwd);
+    while (true) {
+        ancestors.unshift(current);
+        const parent = dirname(current);
+        if (parent === current || parse(current).root === current)
+            break;
+        current = parent;
+    }
+    for (const directory of ancestors)
+        await add(directory, directory === resolve(options.cwd) ? "project" : "ancestor");
+    return { contextFiles, diagnostics };
+}
+async function exists(directory) {
+    try {
+        await access(directory);
+        return true;
+    }
+    catch (cause) {
+        if (isMissingPath(cause))
+            return false;
+        throw cause;
+    }
+}
+export class DefaultResourceLoader {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async load() {
+        const context = await loadContextFiles(this.options);
+        const diagnostics = [...context.diagnostics];
+        const skills = new Map();
+        const add = (candidate, candidateDiagnostics) => {
+            diagnostics.push(...candidateDiagnostics);
+            const existing = skills.get(candidate.name);
+            if (existing) {
+                diagnostics.push({
+                    path: candidate.filePath,
+                    kind: "skill",
+                    stage: "collision",
+                    severity: "warning",
+                    message: `Skill name collision: "${candidate.name}"; using ${existing.filePath}`,
+                });
+                return;
+            }
+            skills.set(candidate.name, candidate);
+        };
+        const addResults = (results) => {
+            for (const result of results) {
+                if (result.skill)
+                    add(result.skill, result.diagnostics);
+                else
+                    diagnostics.push(...result.diagnostics);
+            }
+        };
+        if (!this.options.noSkills) {
+            for (const rawPath of this.options.skillPaths ?? []) {
+                const path = resolve(this.options.cwd, rawPath);
+                try {
+                    const metadata = await stat(path);
+                    if (metadata.isDirectory())
+                        addResults(await discoverSkills(path, "explicit"));
+                    else {
+                        const result = await loadSkill(path, "explicit");
+                        if (result.skill)
+                            add(result.skill, result.diagnostics);
+                        else
+                            diagnostics.push(...result.diagnostics);
+                    }
+                }
+                catch (cause) {
+                    const message = isMissingPath(cause)
+                        ? "Skill path does not exist"
+                        : `Failed to discover skill path: ${String(cause)}`;
+                    diagnostics.push({ path, kind: "skill", stage: "discover", severity: "warning", message });
+                }
+            }
+            const projectDirectories = [
+                join(this.options.cwd, ".di-code", "skills"),
+                join(this.options.cwd, ".pi", "skills"),
+            ];
+            if (this.options.projectTrusted === true) {
+                for (const directory of projectDirectories)
+                    addResults(await discoverSkills(directory, "project"));
+            }
+            else {
+                for (const directory of projectDirectories) {
+                    if (await exists(directory)) {
+                        diagnostics.push({
+                            path: resolve(directory),
+                            kind: "skill",
+                            stage: "trust",
+                            severity: "warning",
+                            message: "Project skill skipped because project trust is not granted",
+                        });
+                    }
+                }
+            }
+            addResults(await discoverSkills(join(this.options.agentDir, "skills"), "global"));
+        }
+        return { contextFiles: context.contextFiles, skills: [...skills.values()], diagnostics };
+    }
+}
+export async function loadResources(options) {
+    return new DefaultResourceLoader(options).load();
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/resources/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/core/resources/loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { access, readFile, stat } from \"node:fs/promises\";\nimport { dirname, join, parse, resolve } from \"node:path\";\nimport { discoverSkills, loadSkill } from \"./skills.ts\";\nimport type {\n\tContextFile,\n\tResourceDiagnostic,\n\tResourceLoader,\n\tResourceLoaderOptions,\n\tResourceScope,\n\tResourceSnapshot,\n\tSkillResource,\n} from \"./types.ts\";\n\nconst MAX_CONTEXT_FILE_BYTES = 256 * 1024;\n\nfunction isMissingPath(cause: unknown): boolean {\n\treturn cause instanceof Error && \"code\" in cause && cause.code === \"ENOENT\";\n}\n\nfunction contextDiagnostic(path: string, stage: ResourceDiagnostic[\"stage\"], message: string): ResourceDiagnostic {\n\treturn { path, kind: \"agents\", stage, severity: \"warning\", message };\n}\n\nasync function locateAgentsFile(directory: string): Promise<string | undefined> {\n\tfor (const name of [\"AGENTS.md\", \"AGENTS.MD\"]) {\n\t\tconst path = join(directory, name);\n\t\ttry {\n\t\t\tif ((await stat(path)).isFile()) return path;\n\t\t} catch (cause) {\n\t\t\tif (!isMissingPath(cause)) throw cause;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nasync function loadContextFile(\n\tpath: string,\n\tscope: ResourceScope,\n): Promise<{ file?: ContextFile; diagnostic?: ResourceDiagnostic }> {\n\ttry {\n\t\tconst metadata = await stat(path);\n\t\tif (metadata.size > MAX_CONTEXT_FILE_BYTES) {\n\t\t\treturn { diagnostic: contextDiagnostic(path, \"read\", `AGENTS.md exceeds ${MAX_CONTEXT_FILE_BYTES} byte limit`) };\n\t\t}\n\t\treturn { file: { kind: \"agents\", path: resolve(path), scope, content: await readFile(path, \"utf8\") } };\n\t} catch (cause) {\n\t\tconst message = cause instanceof Error ? cause.message : String(cause);\n\t\treturn { diagnostic: contextDiagnostic(path, \"read\", `Failed to read AGENTS.md: ${message}`) };\n\t}\n}\n\nasync function loadContextFiles(options: ResourceLoaderOptions): Promise<{\n\tcontextFiles: ContextFile[];\n\tdiagnostics: ResourceDiagnostic[];\n}> {\n\tif (options.noContextFiles) return { contextFiles: [], diagnostics: [] };\n\tconst contextFiles: ContextFile[] = [];\n\tconst diagnostics: ResourceDiagnostic[] = [];\n\tconst seen = new Set<string>();\n\tconst add = async (directory: string, scope: ResourceScope): Promise<void> => {\n\t\tlet path: string | undefined;\n\t\ttry {\n\t\t\tpath = await locateAgentsFile(directory);\n\t\t} catch (cause) {\n\t\t\tconst message = cause instanceof Error ? cause.message : String(cause);\n\t\t\tdiagnostics.push(contextDiagnostic(directory, \"discover\", `Failed to discover AGENTS.md: ${message}`));\n\t\t\treturn;\n\t\t}\n\t\tif (!path) return;\n\t\tconst absolutePath = resolve(path);\n\t\tif (seen.has(absolutePath)) return;\n\t\tseen.add(absolutePath);\n\t\tconst loaded = await loadContextFile(absolutePath, scope);\n\t\tif (loaded.file) contextFiles.push(loaded.file);\n\t\tif (loaded.diagnostic) diagnostics.push(loaded.diagnostic);\n\t};\n\n\tawait add(resolve(options.agentDir), \"global\");\n\tconst ancestors: string[] = [];\n\tlet current = resolve(options.cwd);\n\twhile (true) {\n\t\tancestors.unshift(current);\n\t\tconst parent = dirname(current);\n\t\tif (parent === current || parse(current).root === current) break;\n\t\tcurrent = parent;\n\t}\n\tfor (const directory of ancestors) await add(directory, directory === resolve(options.cwd) ? \"project\" : \"ancestor\");\n\treturn { contextFiles, diagnostics };\n}\n\nasync function exists(directory: string): Promise<boolean> {\n\ttry {\n\t\tawait access(directory);\n\t\treturn true;\n\t} catch (cause) {\n\t\tif (isMissingPath(cause)) return false;\n\t\tthrow cause;\n\t}\n}\n\nexport class DefaultResourceLoader implements ResourceLoader {\n\tprivate readonly options: ResourceLoaderOptions;\n\n\tconstructor(options: ResourceLoaderOptions) {\n\t\tthis.options = options;\n\t}\n\n\tasync load(): Promise<ResourceSnapshot> {\n\t\tconst context = await loadContextFiles(this.options);\n\t\tconst diagnostics = [...context.diagnostics];\n\t\tconst skills = new Map<string, SkillResource>();\n\t\tconst add = (candidate: SkillResource, candidateDiagnostics: readonly ResourceDiagnostic[]): void => {\n\t\t\tdiagnostics.push(...candidateDiagnostics);\n\t\t\tconst existing = skills.get(candidate.name);\n\t\t\tif (existing) {\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\tpath: candidate.filePath,\n\t\t\t\t\tkind: \"skill\",\n\t\t\t\t\tstage: \"collision\",\n\t\t\t\t\tseverity: \"warning\",\n\t\t\t\t\tmessage: `Skill name collision: \"${candidate.name}\"; using ${existing.filePath}`,\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tskills.set(candidate.name, candidate);\n\t\t};\n\t\tconst addResults = (results: Awaited<ReturnType<typeof discoverSkills>>): void => {\n\t\t\tfor (const result of results) {\n\t\t\t\tif (result.skill) add(result.skill, result.diagnostics);\n\t\t\t\telse diagnostics.push(...result.diagnostics);\n\t\t\t}\n\t\t};\n\n\t\tif (!this.options.noSkills) {\n\t\t\tfor (const rawPath of this.options.skillPaths ?? []) {\n\t\t\t\tconst path = resolve(this.options.cwd, rawPath);\n\t\t\t\ttry {\n\t\t\t\t\tconst metadata = await stat(path);\n\t\t\t\t\tif (metadata.isDirectory()) addResults(await discoverSkills(path, \"explicit\"));\n\t\t\t\t\telse {\n\t\t\t\t\t\tconst result = await loadSkill(path, \"explicit\");\n\t\t\t\t\t\tif (result.skill) add(result.skill, result.diagnostics);\n\t\t\t\t\t\telse diagnostics.push(...result.diagnostics);\n\t\t\t\t\t}\n\t\t\t\t} catch (cause) {\n\t\t\t\t\tconst message = isMissingPath(cause)\n\t\t\t\t\t\t? \"Skill path does not exist\"\n\t\t\t\t\t\t: `Failed to discover skill path: ${String(cause)}`;\n\t\t\t\t\tdiagnostics.push({ path, kind: \"skill\", stage: \"discover\", severity: \"warning\", message });\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst projectDirectories = [\n\t\t\t\tjoin(this.options.cwd, \".di-code\", \"skills\"),\n\t\t\t\tjoin(this.options.cwd, \".pi\", \"skills\"),\n\t\t\t];\n\t\t\tif (this.options.projectTrusted === true) {\n\t\t\t\tfor (const directory of projectDirectories) addResults(await discoverSkills(directory, \"project\"));\n\t\t\t} else {\n\t\t\t\tfor (const directory of projectDirectories) {\n\t\t\t\t\tif (await exists(directory)) {\n\t\t\t\t\t\tdiagnostics.push({\n\t\t\t\t\t\t\tpath: resolve(directory),\n\t\t\t\t\t\t\tkind: \"skill\",\n\t\t\t\t\t\t\tstage: \"trust\",\n\t\t\t\t\t\t\tseverity: \"warning\",\n\t\t\t\t\t\t\tmessage: \"Project skill skipped because project trust is not granted\",\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\taddResults(await discoverSkills(join(this.options.agentDir, \"skills\"), \"global\"));\n\t\t}\n\t\treturn { contextFiles: context.contextFiles, skills: [...skills.values()], diagnostics };\n\t}\n}\n\nexport async function loadResources(options: ResourceLoaderOptions): Promise<ResourceSnapshot> {\n\treturn new DefaultResourceLoader(options).load();\n}\n"]}

package/dist/core/resources/skills.d.ts

@@ -0,0 +1,10 @@
+import type { ResourceDiagnostic, ResourceScope, SkillResource } from "./types.ts";
+interface ParsedSkill {
+    readonly skill?: SkillResource;
+    readonly diagnostics: readonly ResourceDiagnostic[];
+}
+export declare function loadSkill(path: string, scope: ResourceScope): Promise<ParsedSkill>;
+export declare function readSkillContent(skill: SkillResource, signal?: AbortSignal): Promise<string>;
+export declare function discoverSkills(directory: string, scope: ResourceScope): Promise<ParsedSkill[]>;
+export {};
+//# sourceMappingURL=skills.d.ts.map

package/dist/core/resources/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/core/resources/skills.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMnF,UAAU,WAAW;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACpD;AAyDD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA6CxF;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBlG;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA2BpG"}

package/dist/core/resources/skills.js

@@ -0,0 +1,167 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+const MAX_SKILL_BYTES = 256 * 1024;
+const MAX_NAME_LENGTH = 64;
+const MAX_DESCRIPTION_LENGTH = 1024;
+function diagnostic(path, stage, message, severity = "warning") {
+    return { path, kind: "skill", stage, severity, message };
+}
+function parseScalar(value) {
+    const trimmed = value.trim();
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+function parseFrontmatter(source) {
+    const lines = source.replace(/^\uFEFF/, "").split(/\r?\n/);
+    if (lines[0] !== "---")
+        return undefined;
+    const end = lines.findIndex((line, index) => index > 0 && line === "---");
+    if (end < 0)
+        return undefined;
+    const entries = {};
+    for (const line of lines.slice(1, end)) {
+        if (!line.trim() || line.trimStart().startsWith("#"))
+            continue;
+        const separator = line.indexOf(":");
+        if (separator < 1)
+            continue;
+        entries[line.slice(0, separator).trim()] = parseScalar(line.slice(separator + 1));
+    }
+    return entries;
+}
+function extractSkillBody(source) {
+    const lines = source.replace(/^\uFEFF/, "").split(/\r?\n/);
+    if (lines[0] !== "---")
+        return undefined;
+    const end = lines.findIndex((line, index) => index > 0 && line === "---");
+    if (end < 0)
+        return undefined;
+    return lines.slice(end + 1).join("\n");
+}
+function validateName(name) {
+    if (name.length === 0)
+        return "name is required";
+    if (name.length > MAX_NAME_LENGTH)
+        return `name exceeds ${MAX_NAME_LENGTH} characters`;
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name)) {
+        return "name must contain only lowercase letters, numbers, and single hyphens";
+    }
+    return undefined;
+}
+function validateDescription(description) {
+    if (description.length === 0)
+        return "description is required";
+    if (description.length > MAX_DESCRIPTION_LENGTH)
+        return `description exceeds ${MAX_DESCRIPTION_LENGTH} characters`;
+    return undefined;
+}
+export async function loadSkill(path, scope) {
+    const filePath = resolve(path);
+    const diagnostics = [];
+    try {
+        const metadata = await stat(filePath);
+        if (!metadata.isFile())
+            return { diagnostics: [diagnostic(filePath, "discover", "Skill path is not a file")] };
+        if (metadata.size > MAX_SKILL_BYTES) {
+            return { diagnostics: [diagnostic(filePath, "read", `Skill exceeds ${MAX_SKILL_BYTES} byte limit`)] };
+        }
+        const source = await readFile(filePath, "utf8");
+        const frontmatter = parseFrontmatter(source);
+        if (!frontmatter)
+            return { diagnostics: [diagnostic(filePath, "parse", "Skill frontmatter is required")] };
+        const name = frontmatter.name ?? "";
+        const description = frontmatter.description ?? "";
+        const nameError = validateName(name);
+        const descriptionError = validateDescription(description);
+        if (nameError)
+            diagnostics.push(diagnostic(filePath, "parse", nameError));
+        if (descriptionError)
+            diagnostics.push(diagnostic(filePath, "parse", descriptionError));
+        if (nameError || descriptionError)
+            return { diagnostics };
+        const disableModelInvocationValue = frontmatter["disable-model-invocation"];
+        if (disableModelInvocationValue !== undefined &&
+            disableModelInvocationValue !== "true" &&
+            disableModelInvocationValue !== "false") {
+            return {
+                diagnostics: [diagnostic(filePath, "parse", "disable-model-invocation must be true or false")],
+            };
+        }
+        return {
+            skill: {
+                kind: "skill",
+                name,
+                description,
+                filePath,
+                baseDir: dirname(filePath),
+                scope,
+                disableModelInvocation: disableModelInvocationValue === "true",
+            },
+            diagnostics,
+        };
+    }
+    catch (cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        return { diagnostics: [diagnostic(filePath, "read", `Failed to read skill: ${message}`, "error")] };
+    }
+}
+export async function readSkillContent(skill, signal) {
+    if (signal?.aborted)
+        throw new Error("Operation aborted");
+    const path = resolve(skill.filePath);
+    try {
+        const metadata = await stat(path);
+        if (!metadata.isFile())
+            throw new Error("Skill path is not a file");
+        if (metadata.size > MAX_SKILL_BYTES)
+            throw new Error(`Skill exceeds ${MAX_SKILL_BYTES} byte limit`);
+        const source = await readFile(path, { encoding: "utf8", signal });
+        const body = extractSkillBody(source);
+        if (body === undefined)
+            throw new Error("Skill frontmatter is required");
+        return body;
+    }
+    catch (cause) {
+        if (cause instanceof Error && cause.message === "Operation aborted")
+            throw cause;
+        const message = cause instanceof Error ? cause.message : String(cause);
+        throw new Error(`Failed to load skill "${skill.name}": ${message}`, { cause });
+    }
+}
+export async function discoverSkills(directory, scope) {
+    const root = resolve(directory);
+    const results = [];
+    async function visit(current) {
+        let entries;
+        try {
+            entries = await readdir(current, { withFileTypes: true });
+        }
+        catch (cause) {
+            if (isMissingPath(cause))
+                return;
+            const message = cause instanceof Error ? cause.message : String(cause);
+            results.push({
+                diagnostics: [diagnostic(current, "discover", `Failed to read skill directory: ${message}`, "error")],
+            });
+            return;
+        }
+        const skillEntry = entries.find((entry) => entry.name === "SKILL.md" && entry.isFile());
+        if (skillEntry) {
+            results.push(await loadSkill(join(current, skillEntry.name), scope));
+            return;
+        }
+        for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+            if (entry.name.startsWith(".") || entry.name === "node_modules" || !entry.isDirectory())
+                continue;
+            await visit(join(current, entry.name));
+        }
+    }
+    await visit(root);
+    return results;
+}
+function isMissingPath(cause) {
+    return cause instanceof Error && "code" in cause && cause.code === "ENOENT";
+}
+//# sourceMappingURL=skills.js.map

package/dist/core/resources/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/core/resources/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGnD,MAAM,eAAe,GAAG,GAAG,GAAG,IAAI,CAAC;AACnC,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAOpC,SAAS,UAAU,CAClB,IAAY,EACZ,KAAkC,EAClC,OAAe,EACf,WAA2C,SAAS;IAEpD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9G,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC;IAC1E,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,SAAS,GAAG,CAAC;YAAE,SAAS;QAC5B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC;IAC1E,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kBAAkB,CAAC;IACjD,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe;QAAE,OAAO,gBAAgB,eAAe,aAAa,CAAC;IACvF,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,OAAO,uEAAuE,CAAC;IAChF,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,mBAAmB,CAAC,WAAmB;IAC/C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,yBAAyB,CAAC;IAC/D,IAAI,WAAW,CAAC,MAAM,GAAG,sBAAsB;QAAE,OAAO,uBAAuB,sBAAsB,aAAa,CAAC;IACnH,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,KAAoB;IACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,WAAW,GAAyB,EAAE,CAAC;IAC7C,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,OAAO,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,0BAA0B,CAAC,CAAC,EAAE,CAAC;QAC/G,IAAI,QAAQ,CAAC,IAAI,GAAG,eAAe,EAAE,CAAC;YACrC,OAAO,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,eAAe,aAAa,CAAC,CAAC,EAAE,CAAC;QACvG,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,WAAW;YAAE,OAAO,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,+BAA+B,CAAC,CAAC,EAAE,CAAC;QAC3G,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,IAAI,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC1D,IAAI,SAAS;YAAE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAC1E,IAAI,gBAAgB;YAAE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACxF,IAAI,SAAS,IAAI,gBAAgB;YAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QAC1D,MAAM,2BAA2B,GAAG,WAAW,CAAC,0BAA0B,CAAC,CAAC;QAC5E,IACC,2BAA2B,KAAK,SAAS;YACzC,2BAA2B,KAAK,MAAM;YACtC,2BAA2B,KAAK,OAAO,EACtC,CAAC;YACF,OAAO;gBACN,WAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,gDAAgD,CAAC,CAAC;aAC9F,CAAC;QACH,CAAC;QACD,OAAO;YACN,KAAK,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,IAAI;gBACJ,WAAW;gBACX,QAAQ;gBACR,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC;gBAC1B,KAAK;gBACL,sBAAsB,EAAE,2BAA2B,KAAK,MAAM;aAC9D;YACD,WAAW;SACX,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,yBAAyB,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IACrG,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAoB,EAAE,MAAoB;IAChF,IAAI,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACpE,IAAI,QAAQ,CAAC,IAAI,GAAG,eAAe;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,eAAe,aAAa,CAAC,CAAC;QACpG,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,mBAAmB;YAAE,MAAM,KAAK,CAAC;QACjF,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,CAAC,IAAI,MAAM,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAChF,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB,EAAE,KAAoB;IAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,UAAU,KAAK,CAAC,OAAe;QACnC,IAAI,OAA2C,CAAC;QAChD,IAAI,CAAC;YACJ,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,aAAa,CAAC,KAAK,CAAC;gBAAE,OAAO;YACjC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC;gBACZ,WAAW,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,mCAAmC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;aACrG,CAAC,CAAC;YACH,OAAO;QACR,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACxF,IAAI,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YACrE,OAAO;QACR,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACxF,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YAClG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,CAAC;IACF,CAAC;IACD,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAClB,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC7E,CAAC","sourcesContent":["import { readdir, readFile, stat } from \"node:fs/promises\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { ResourceDiagnostic, ResourceScope, SkillResource } from \"./types.ts\";\n\nconst MAX_SKILL_BYTES = 256 * 1024;\nconst MAX_NAME_LENGTH = 64;\nconst MAX_DESCRIPTION_LENGTH = 1024;\n\ninterface ParsedSkill {\n\treadonly skill?: SkillResource;\n\treadonly diagnostics: readonly ResourceDiagnostic[];\n}\n\nfunction diagnostic(\n\tpath: string,\n\tstage: ResourceDiagnostic[\"stage\"],\n\tmessage: string,\n\tseverity: ResourceDiagnostic[\"severity\"] = \"warning\",\n): ResourceDiagnostic {\n\treturn { path, kind: \"skill\", stage, severity, message };\n}\n\nfunction parseScalar(value: string): string {\n\tconst trimmed = value.trim();\n\tif ((trimmed.startsWith('\"') && trimmed.endsWith('\"')) || (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\"))) {\n\t\treturn trimmed.slice(1, -1);\n\t}\n\treturn trimmed;\n}\n\nfunction parseFrontmatter(source: string): Record<string, string> | undefined {\n\tconst lines = source.replace(/^\\uFEFF/, \"\").split(/\\r?\\n/);\n\tif (lines[0] !== \"---\") return undefined;\n\tconst end = lines.findIndex((line, index) => index > 0 && line === \"---\");\n\tif (end < 0) return undefined;\n\tconst entries: Record<string, string> = {};\n\tfor (const line of lines.slice(1, end)) {\n\t\tif (!line.trim() || line.trimStart().startsWith(\"#\")) continue;\n\t\tconst separator = line.indexOf(\":\");\n\t\tif (separator < 1) continue;\n\t\tentries[line.slice(0, separator).trim()] = parseScalar(line.slice(separator + 1));\n\t}\n\treturn entries;\n}\n\nfunction extractSkillBody(source: string): string | undefined {\n\tconst lines = source.replace(/^\\uFEFF/, \"\").split(/\\r?\\n/);\n\tif (lines[0] !== \"---\") return undefined;\n\tconst end = lines.findIndex((line, index) => index > 0 && line === \"---\");\n\tif (end < 0) return undefined;\n\treturn lines.slice(end + 1).join(\"\\n\");\n}\n\nfunction validateName(name: string): string | undefined {\n\tif (name.length === 0) return \"name is required\";\n\tif (name.length > MAX_NAME_LENGTH) return `name exceeds ${MAX_NAME_LENGTH} characters`;\n\tif (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name)) {\n\t\treturn \"name must contain only lowercase letters, numbers, and single hyphens\";\n\t}\n\treturn undefined;\n}\n\nfunction validateDescription(description: string): string | undefined {\n\tif (description.length === 0) return \"description is required\";\n\tif (description.length > MAX_DESCRIPTION_LENGTH) return `description exceeds ${MAX_DESCRIPTION_LENGTH} characters`;\n\treturn undefined;\n}\n\nexport async function loadSkill(path: string, scope: ResourceScope): Promise<ParsedSkill> {\n\tconst filePath = resolve(path);\n\tconst diagnostics: ResourceDiagnostic[] = [];\n\ttry {\n\t\tconst metadata = await stat(filePath);\n\t\tif (!metadata.isFile()) return { diagnostics: [diagnostic(filePath, \"discover\", \"Skill path is not a file\")] };\n\t\tif (metadata.size > MAX_SKILL_BYTES) {\n\t\t\treturn { diagnostics: [diagnostic(filePath, \"read\", `Skill exceeds ${MAX_SKILL_BYTES} byte limit`)] };\n\t\t}\n\t\tconst source = await readFile(filePath, \"utf8\");\n\t\tconst frontmatter = parseFrontmatter(source);\n\t\tif (!frontmatter) return { diagnostics: [diagnostic(filePath, \"parse\", \"Skill frontmatter is required\")] };\n\t\tconst name = frontmatter.name ?? \"\";\n\t\tconst description = frontmatter.description ?? \"\";\n\t\tconst nameError = validateName(name);\n\t\tconst descriptionError = validateDescription(description);\n\t\tif (nameError) diagnostics.push(diagnostic(filePath, \"parse\", nameError));\n\t\tif (descriptionError) diagnostics.push(diagnostic(filePath, \"parse\", descriptionError));\n\t\tif (nameError || descriptionError) return { diagnostics };\n\t\tconst disableModelInvocationValue = frontmatter[\"disable-model-invocation\"];\n\t\tif (\n\t\t\tdisableModelInvocationValue !== undefined &&\n\t\t\tdisableModelInvocationValue !== \"true\" &&\n\t\t\tdisableModelInvocationValue !== \"false\"\n\t\t) {\n\t\t\treturn {\n\t\t\t\tdiagnostics: [diagnostic(filePath, \"parse\", \"disable-model-invocation must be true or false\")],\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tskill: {\n\t\t\t\tkind: \"skill\",\n\t\t\t\tname,\n\t\t\t\tdescription,\n\t\t\t\tfilePath,\n\t\t\t\tbaseDir: dirname(filePath),\n\t\t\t\tscope,\n\t\t\t\tdisableModelInvocation: disableModelInvocationValue === \"true\",\n\t\t\t},\n\t\t\tdiagnostics,\n\t\t};\n\t} catch (cause) {\n\t\tconst message = cause instanceof Error ? cause.message : String(cause);\n\t\treturn { diagnostics: [diagnostic(filePath, \"read\", `Failed to read skill: ${message}`, \"error\")] };\n\t}\n}\n\nexport async function readSkillContent(skill: SkillResource, signal?: AbortSignal): Promise<string> {\n\tif (signal?.aborted) throw new Error(\"Operation aborted\");\n\tconst path = resolve(skill.filePath);\n\ttry {\n\t\tconst metadata = await stat(path);\n\t\tif (!metadata.isFile()) throw new Error(\"Skill path is not a file\");\n\t\tif (metadata.size > MAX_SKILL_BYTES) throw new Error(`Skill exceeds ${MAX_SKILL_BYTES} byte limit`);\n\t\tconst source = await readFile(path, { encoding: \"utf8\", signal });\n\t\tconst body = extractSkillBody(source);\n\t\tif (body === undefined) throw new Error(\"Skill frontmatter is required\");\n\t\treturn body;\n\t} catch (cause) {\n\t\tif (cause instanceof Error && cause.message === \"Operation aborted\") throw cause;\n\t\tconst message = cause instanceof Error ? cause.message : String(cause);\n\t\tthrow new Error(`Failed to load skill \"${skill.name}\": ${message}`, { cause });\n\t}\n}\n\nexport async function discoverSkills(directory: string, scope: ResourceScope): Promise<ParsedSkill[]> {\n\tconst root = resolve(directory);\n\tconst results: ParsedSkill[] = [];\n\tasync function visit(current: string): Promise<void> {\n\t\tlet entries: import(\"node:fs\").Dirent<string>[];\n\t\ttry {\n\t\t\tentries = await readdir(current, { withFileTypes: true });\n\t\t} catch (cause) {\n\t\t\tif (isMissingPath(cause)) return;\n\t\t\tconst message = cause instanceof Error ? cause.message : String(cause);\n\t\t\tresults.push({\n\t\t\t\tdiagnostics: [diagnostic(current, \"discover\", `Failed to read skill directory: ${message}`, \"error\")],\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\t\tconst skillEntry = entries.find((entry) => entry.name === \"SKILL.md\" && entry.isFile());\n\t\tif (skillEntry) {\n\t\t\tresults.push(await loadSkill(join(current, skillEntry.name), scope));\n\t\t\treturn;\n\t\t}\n\t\tfor (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {\n\t\t\tif (entry.name.startsWith(\".\") || entry.name === \"node_modules\" || !entry.isDirectory()) continue;\n\t\t\tawait visit(join(current, entry.name));\n\t\t}\n\t}\n\tawait visit(root);\n\treturn results;\n}\n\nfunction isMissingPath(cause: unknown): boolean {\n\treturn cause instanceof Error && \"code\" in cause && cause.code === \"ENOENT\";\n}\n"]}

package/dist/core/resources/types.d.ts

@@ -0,0 +1,41 @@
+export type ResourceScope = "global" | "ancestor" | "project" | "explicit";
+export type ResourceDiagnosticStage = "discover" | "read" | "parse" | "collision" | "trust";
+export interface ResourceDiagnostic {
+    readonly path: string;
+    readonly kind: "agents" | "skill";
+    readonly stage: ResourceDiagnosticStage;
+    readonly severity: "warning" | "error";
+    readonly message: string;
+}
+export interface ContextFile {
+    readonly kind: "agents";
+    readonly path: string;
+    readonly scope: ResourceScope;
+    readonly content: string;
+}
+export interface SkillResource {
+    readonly kind: "skill";
+    readonly name: string;
+    readonly description: string;
+    readonly filePath: string;
+    readonly baseDir: string;
+    readonly scope: ResourceScope;
+    readonly disableModelInvocation: boolean;
+}
+export interface ResourceSnapshot {
+    readonly contextFiles: readonly ContextFile[];
+    readonly skills: readonly SkillResource[];
+    readonly diagnostics: readonly ResourceDiagnostic[];
+}
+export interface ResourceLoaderOptions {
+    readonly cwd: string;
+    readonly agentDir: string;
+    readonly projectTrusted?: boolean;
+    readonly noSkills?: boolean;
+    readonly noContextFiles?: boolean;
+    readonly skillPaths?: readonly string[];
+}
+export interface ResourceLoader {
+    load(): Promise<ResourceSnapshot>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/resources/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/resources/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAE3E,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;AAE5F,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAClC"}

package/dist/core/resources/types.js

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

package/dist/core/resources/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/resources/types.ts"],"names":[],"mappings":"","sourcesContent":["export type ResourceScope = \"global\" | \"ancestor\" | \"project\" | \"explicit\";\n\nexport type ResourceDiagnosticStage = \"discover\" | \"read\" | \"parse\" | \"collision\" | \"trust\";\n\nexport interface ResourceDiagnostic {\n\treadonly path: string;\n\treadonly kind: \"agents\" | \"skill\";\n\treadonly stage: ResourceDiagnosticStage;\n\treadonly severity: \"warning\" | \"error\";\n\treadonly message: string;\n}\n\nexport interface ContextFile {\n\treadonly kind: \"agents\";\n\treadonly path: string;\n\treadonly scope: ResourceScope;\n\treadonly content: string;\n}\n\nexport interface SkillResource {\n\treadonly kind: \"skill\";\n\treadonly name: string;\n\treadonly description: string;\n\treadonly filePath: string;\n\treadonly baseDir: string;\n\treadonly scope: ResourceScope;\n\treadonly disableModelInvocation: boolean;\n}\n\nexport interface ResourceSnapshot {\n\treadonly contextFiles: readonly ContextFile[];\n\treadonly skills: readonly SkillResource[];\n\treadonly diagnostics: readonly ResourceDiagnostic[];\n}\n\nexport interface ResourceLoaderOptions {\n\treadonly cwd: string;\n\treadonly agentDir: string;\n\treadonly projectTrusted?: boolean;\n\treadonly noSkills?: boolean;\n\treadonly noContextFiles?: boolean;\n\treadonly skillPaths?: readonly string[];\n}\n\nexport interface ResourceLoader {\n\tload(): Promise<ResourceSnapshot>;\n}\n"]}

package/dist/core/session.d.ts

@@ -1,5 +1,7 @@
 import { type AgentListener } from "@di-code/agent";
-import type { AssistantMessage, Message, Model, Provider, Usage } from "@di-code/ai";
+import type { AssistantMessage, ImageContent, Message, Model, Provider, Usage } from "@di-code/ai";
+import type { ExtensionHost } from "../extensions/runtime.ts";
+import type { SkillResource } from "./resources/types.ts";
 import type { SessionManager } from "./session/session-manager.ts";
 import type { SessionDiagnostic } from "./session/types.ts";
 export interface AgentSessionCompactionOptions {
@@ -23,9 +25,12 @@ export interface AgentSessionOptions {
     readonly allowedRoot: string;
     readonly provider: Provider;
     readonly model: Model;
+    readonly systemPrompt?: string;
+    readonly skills?: readonly SkillResource[];
     readonly now?: () => number;
     readonly sessionManager?: SessionManager;
     readonly compaction?: AgentSessionCompactionOptions;
+    readonly extensionHost?: ExtensionHost;
 }
 export type AgentSessionEvent = import("@di-code/agent").AgentEvent | {
     type: "compaction_start";
@@ -45,6 +50,8 @@ export declare class AgentSession {
     private readonly allowedRootValue;
     private readonly sessionManager?;
     private readonly provider;
+    private readonly skills;
+    private readonly extensionHost?;
     private model;
     private readonly sessionIdValue;
     private readonly now;
@@ -69,6 +76,8 @@ export declare class AgentSession {
     get sessionDiagnostics(): readonly SessionDiagnostic[];
     get usage(): SessionUsage;
     prompt(text: string, signal?: AbortSignal): Promise<AssistantMessage>;
+    /** Sends one text prompt with explicitly supplied image attachments. */
+    promptWithImages(text: string, images: readonly ImageContent[], signal?: AbortSignal): Promise<AssistantMessage>;
     compact(signal?: AbortSignal): Promise<void>;
     subscribe(listener: AgentListener): () => void;
     subscribeSession(listener: AgentSessionListener): () => void;

package/dist/core/session.d.ts.map

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

package/dist/core/session.js

@@ -1,6 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { Agent, estimateContextTokens, generateCompactionSummary, prepareCompaction, resolveContextBudget, shouldCompact, } from "@di-code/agent";
 import { buildSessionContext } from "./context-builder.js";
+import { resolveSkillCommand } from "./skill-command.js";
 import { createBashTool } from "./tools/bash.js";
 import { createEditTool } from "./tools/edit.js";
 import { createReadTool } from "./tools/read.js";
@@ -10,6 +11,8 @@ export class AgentSession {
     allowedRootValue;
     sessionManager;
     provider;
+    skills;
+    extensionHost;
     model;
     sessionIdValue;
     now;
@@ -24,6 +27,8 @@ export class AgentSession {
         this.allowedRootValue = options.allowedRoot;
         this.sessionManager = options.sessionManager;
         this.provider = options.provider;
+        this.skills = structuredClone([...(options.skills ?? [])]);
+        this.extensionHost = options.extensionHost;
         this.model = options.model;
         this.sessionIdValue = options.sessionManager?.header.id ?? randomUUID();
         this.now = options.now ?? Date.now;
@@ -54,12 +59,24 @@ export class AgentSession {
         this.agent = new Agent({
             provider: options.provider,
             model: options.model,
+            systemPrompt: options.systemPrompt,
             sessionId: this.sessionIdValue,
             tools: [
                 createReadTool(options.allowedRoot),
                 createWriteTool(options.allowedRoot),
                 createEditTool(options.allowedRoot),
                 createBashTool(options.allowedRoot),
+                ...(this.extensionHost?.listTools().map((tool) => ({
+                    name: tool.name,
+                    description: tool.description,
+                    parameters: tool.parameters,
+                    execute: async (toolCallId, parameters, signal) => {
+                        const result = await this.extensionHost?.runTool(tool.name, toolCallId, parameters, signal);
+                        if (result === undefined)
+                            throw new Error(`Extension tool "${tool.name}" is unavailable.`);
+                        return [...result];
+                    },
+                })) ?? []),
             ],
             now: this.now,
             initialMessages: options.sessionManager?.messages,
@@ -83,7 +100,9 @@ export class AgentSession {
             this.addUsage(event.message.usage);
             await this.emitSession({ type: "usage_update", usage: this.usage });
         });
-        this.agent.subscribe(async (event) => {
+        this.agent.subscribe(async (event, signal) => {
+            if (this.extensionHost)
+                await this.extensionHost.emit(event, signal);
             await this.emitSession(event);
         });
     }
@@ -143,6 +162,10 @@ export class AgentSession {
         };
     }
     async prompt(text, signal) {
+        return this.promptWithImages(text, [], signal);
+    }
+    /** Sends one text prompt with explicitly supplied image attachments. */
+    async promptWithImages(text, images, signal) {
         if (this.persistenceError !== undefined) {
             throw this.persistenceError;
         }
@@ -151,8 +174,13 @@ export class AgentSession {
         }
         this.promptActive = true;
         try {
-            await this.compactIfNeeded(text, signal);
-            return await this.agent.prompt(text, signal);
+            if (images.length > 0 && !this.model.input.includes("image")) {
+                throw new Error(`Model "${this.model.id}" does not support image input.`);
+            }
+            const prompt = await resolveSkillCommand(text, this.skills, signal);
+            const content = [{ type: "text", text: prompt }, ...structuredClone([...images])];
+            await this.compactIfNeeded(content, signal);
+            return await this.agent.promptWithContent(content, signal);
         }
         finally {
             this.promptActive = false;
@@ -199,13 +227,13 @@ export class AgentSession {
             },
         };
     }
-    async compactIfNeeded(text, signal) {
+    async compactIfNeeded(content, signal) {
         if (!this.compactionEnabledValue || !this.sessionManager)
             return;
         const context = buildSessionContext(this.sessionManager.entries);
         const pendingUser = {
             role: "user",
-            content: [{ type: "text", text }],
+            content: structuredClone([...content]),
             timestamp: 0,
         };
         const estimatedTokens = estimateContextTokens([...context.messages, pendingUser]);