@tschmz/imp 0.1.0

package/dist/service/service-error.d.ts

@@ -0,0 +1,7 @@
+export type ServiceErrorCode = "unsupported" | "not_installed" | "permission_denied";
+export declare class ServiceOperationError extends Error {
+    readonly code: ServiceErrorCode;
+    readonly cause?: unknown | undefined;
+    constructor(code: ServiceErrorCode, message: string, cause?: unknown | undefined);
+}
+export declare function mapServiceError(error: unknown): ServiceOperationError;

package/dist/service/service-error.js

@@ -0,0 +1,45 @@
+export class ServiceOperationError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = "ServiceOperationError";
+    }
+}
+export function mapServiceError(error) {
+    if (error instanceof ServiceOperationError) {
+        return error;
+    }
+    if (isPermissionError(error)) {
+        return new ServiceOperationError("permission_denied", "Insufficient permissions to manage the service.", error);
+    }
+    if (isMissingServiceError(error)) {
+        return new ServiceOperationError("not_installed", getErrorMessage(error), error);
+    }
+    if (isUnsupportedError(error)) {
+        return new ServiceOperationError("unsupported", getErrorMessage(error), error);
+    }
+    throw error;
+}
+function isPermissionError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    if ("code" in error && (error.code === "EACCES" || error.code === "EPERM")) {
+        return true;
+    }
+    const message = getErrorMessage(error).toLowerCase();
+    return message.includes("permission denied") || message.includes("operation not permitted");
+}
+function isMissingServiceError(error) {
+    return getErrorMessage(error).toLowerCase().includes("service definition not found");
+}
+function isUnsupportedError(error) {
+    return getErrorMessage(error).toLowerCase().includes("not implemented yet");
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=service-error.js.map

package/dist/service/service-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-error.js","sourceRoot":"","sources":["../../src/service/service-error.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAE5B;IAEA;IAHlB,YACkB,IAAsB,EACtC,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAkB;QAEtB,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,qBAAqB,CAC9B,mBAAmB,EACnB,iDAAiD,EACjD,KAAK,CACN,CAAC;IACJ,CAAC;IAED,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,qBAAqB,CAAC,eAAe,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,qBAAqB,CAAC,aAAa,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,KAAK,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,MAAM,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,OAAO,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/service/service-installer.d.ts

@@ -0,0 +1,8 @@
+export interface ServiceInstaller {
+    run(command: string, args: string[]): Promise<void>;
+    runAndCapture?(command: string, args: string[]): Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+}
+export declare function createSystemServiceInstaller(): ServiceInstaller;

package/dist/service/service-installer.js

@@ -0,0 +1,40 @@
+export function createSystemServiceInstaller() {
+    return {
+        async run(command, args) {
+            const { execFile } = await import("node:child_process");
+            const { promisify } = await import("node:util");
+            const execFileAsync = promisify(execFile);
+            await execFileAsync(command, args, {
+                env: process.env,
+            });
+        },
+        async runAndCapture(command, args) {
+            const { execFile } = await import("node:child_process");
+            const { promisify } = await import("node:util");
+            const execFileAsync = promisify(execFile);
+            try {
+                const result = await execFileAsync(command, args, {
+                    env: process.env,
+                });
+                return {
+                    stdout: result.stdout,
+                    stderr: result.stderr,
+                };
+            }
+            catch (error) {
+                if (error instanceof Error &&
+                    "stdout" in error &&
+                    "stderr" in error &&
+                    typeof error.stdout === "string" &&
+                    typeof error.stderr === "string") {
+                    return {
+                        stdout: error.stdout,
+                        stderr: error.stderr,
+                    };
+                }
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=service-installer.js.map

package/dist/service/service-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-installer.js","sourceRoot":"","sources":["../../src/service/service-installer.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,IAAc;YACvC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YACxD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YAChD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE;gBACjC,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,IAAc;YACjD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YACxD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YAChD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;YAE1C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE;oBAChD,GAAG,EAAE,OAAO,CAAC,GAAG;iBACjB,CAAC,CAAC;gBACH,OAAO;oBACL,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IACE,KAAK,YAAY,KAAK;oBACtB,QAAQ,IAAI,KAAK;oBACjB,QAAQ,IAAI,KAAK;oBACjB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;oBAChC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAChC,CAAC;oBACD,OAAO;wBACL,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,MAAM,EAAE,KAAK,CAAC,MAAM;qBACrB,CAAC;gBACJ,CAAC;gBAED,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/service/service-operation-result.d.ts

@@ -0,0 +1,9 @@
+import type { ServicePlatform } from "./install-plan.js";
+export type ServiceOperationName = "install" | "uninstall" | "start" | "stop" | "restart" | "status" | "validate" | "diagnose";
+export interface ServiceOperationResult {
+    operation: ServiceOperationName;
+    platform: ServicePlatform;
+    serviceName: string;
+    definitionPath: string;
+    statusOutput?: string;
+}

package/dist/service/service-operation-result.js

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

package/dist/service/service-operation-result.js.map

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

package/dist/service/uninstall-service.d.ts

@@ -0,0 +1,13 @@
+import type { ServiceInstaller } from "./install-service.js";
+import type { ServiceOperationResult } from "./service-operation-result.js";
+export interface ServiceUninstallResult {
+    operation: ServiceOperationResult;
+}
+export declare function uninstallService(options: {
+    configPath: string;
+    platform?: NodeJS.Platform;
+    homeDir?: string;
+    uid?: number;
+    installer?: ServiceInstaller;
+}): Promise<ServiceUninstallResult>;
+export declare function assertServiceDefinitionExists(definitionPath: string): Promise<string>;

package/dist/service/uninstall-service.js

@@ -0,0 +1,45 @@
+import { access, rm } from "node:fs/promises";
+import { resolve } from "node:path";
+import { createServiceInstallPlan } from "./install-plan.js";
+import { resolveServiceDefinitionPath } from "./install-service.js";
+import { getServicePlatformAdapter } from "./platforms/get-service-platform-adapter.js";
+import { createSystemServiceInstaller, } from "./service-installer.js";
+import { ServiceOperationError } from "./service-error.js";
+export async function uninstallService(options) {
+    const plan = createServiceInstallPlan({ configPath: options.configPath, platform: options.platform });
+    const definitionPath = await assertServiceDefinitionExists(resolveServiceDefinitionPath({
+        platform: plan.platform,
+        homeDir: options.homeDir,
+        serviceName: plan.serviceName,
+        serviceLabel: plan.serviceLabel,
+    }));
+    const installer = options.installer ?? createSystemServiceInstaller();
+    const operation = await getServicePlatformAdapter(plan.platform).uninstall({
+        installer,
+        definitionPath,
+        serviceName: plan.serviceName,
+        serviceLabel: plan.serviceLabel,
+        uid: options.uid,
+    });
+    await rm(definitionPath, { force: true });
+    return {
+        operation,
+    };
+}
+export async function assertServiceDefinitionExists(definitionPath) {
+    const resolvedPath = resolve(definitionPath);
+    try {
+        await access(resolvedPath);
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            throw new ServiceOperationError("not_installed", `Service definition not found: ${resolvedPath}`);
+        }
+        throw error;
+    }
+    return resolvedPath;
+}
+function isMissingFileError(error) {
+    return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+//# sourceMappingURL=uninstall-service.js.map

package/dist/service/uninstall-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall-service.js","sourceRoot":"","sources":["../../src/service/uninstall-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAExF,OAAO,EACL,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAM3D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAMtC;IACC,MAAM,IAAI,GAAG,wBAAwB,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtG,MAAM,cAAc,GAAG,MAAM,6BAA6B,CACxD,4BAA4B,CAAC;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CACH,CAAC;IACF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,4BAA4B,EAAE,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC;QACzE,SAAS;QACT,cAAc;QACd,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IAEH,MAAM,EAAE,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,OAAO;QACL,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,cAAsB;IACxE,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,qBAAqB,CAAC,eAAe,EAAE,iCAAiC,YAAY,EAAE,CAAC,CAAC;QACpG,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC9E,CAAC"}

package/dist/skills/discovery.d.ts

@@ -0,0 +1,10 @@
+import type { SkillCatalog, SkillDefinition } from "./types.js";
+export interface DiscoverSkillsOptions {
+    ignoreMissingPaths?: boolean;
+}
+export interface MergeSkillCatalogsResult {
+    skills: SkillDefinition[];
+    overriddenSkillNames: string[];
+}
+export declare function discoverSkills(paths: string[], options?: DiscoverSkillsOptions): Promise<SkillCatalog>;
+export declare function mergeSkillCatalogs(baseSkills: SkillDefinition[], overridingSkills: SkillDefinition[]): MergeSkillCatalogsResult;

package/dist/skills/discovery.js

@@ -0,0 +1,216 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+const SKILL_FILE_NAME = "SKILL.md";
+const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const MAX_SKILL_NAME_LENGTH = 64;
+const MAX_SKILL_DESCRIPTION_LENGTH = 1024;
+export async function discoverSkills(paths, options = {}) {
+    const issues = [];
+    const discoveredSkills = [];
+    for (const configuredPath of paths) {
+        const directoryPath = resolve(configuredPath);
+        let entries;
+        try {
+            entries = await readdir(directoryPath, { withFileTypes: true, encoding: "utf8" });
+        }
+        catch (error) {
+            if (options.ignoreMissingPaths && isFileNotFoundError(error)) {
+                continue;
+            }
+            issues.push(`Ignored configured skill path "${directoryPath}": ${formatErrorDetail(error)}.`);
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const skillDirectoryPath = join(directoryPath, entry.name);
+            const skillFilePath = join(skillDirectoryPath, SKILL_FILE_NAME);
+            let content;
+            try {
+                content = await readFile(skillFilePath, "utf8");
+            }
+            catch (error) {
+                if (isFileNotFoundError(error)) {
+                    continue;
+                }
+                issues.push(`Ignored skill file "${skillFilePath}": ${formatErrorDetail(error)}.`);
+                continue;
+            }
+            const parsedSkill = parseSkillFile(content);
+            if (!parsedSkill.success) {
+                issues.push(`Ignored skill file "${skillFilePath}": ${parsedSkill.error}.`);
+                continue;
+            }
+            const validationError = validateSkillFrontmatter(parsedSkill.frontmatter);
+            if (validationError) {
+                issues.push(`Ignored skill file "${skillFilePath}": ${validationError}.`);
+                continue;
+            }
+            discoveredSkills.push({
+                ...parsedSkill.frontmatter,
+                directoryPath: skillDirectoryPath,
+                filePath: skillFilePath,
+                body: parsedSkill.body,
+                content,
+                references: await discoverSkillResources(skillDirectoryPath, "references"),
+                scripts: await discoverSkillResources(skillDirectoryPath, "scripts"),
+            });
+        }
+    }
+    return {
+        skills: rejectDuplicateSkills(discoveredSkills, issues),
+        issues,
+    };
+}
+export function mergeSkillCatalogs(baseSkills, overridingSkills) {
+    const skills = [...baseSkills];
+    const skillIndexes = new Map(skills.map((skill, index) => [skill.name, index]));
+    const overriddenSkillNames = [];
+    for (const skill of overridingSkills) {
+        const existingIndex = skillIndexes.get(skill.name);
+        if (existingIndex !== undefined) {
+            skills[existingIndex] = skill;
+            overriddenSkillNames.push(skill.name);
+            continue;
+        }
+        skillIndexes.set(skill.name, skills.length);
+        skills.push(skill);
+    }
+    return {
+        skills,
+        overriddenSkillNames: overriddenSkillNames.sort((left, right) => left.localeCompare(right)),
+    };
+}
+function rejectDuplicateSkills(skills, issues) {
+    const skillsByName = new Map();
+    for (const skill of skills) {
+        const entries = skillsByName.get(skill.name) ?? [];
+        entries.push(skill);
+        skillsByName.set(skill.name, entries);
+    }
+    const uniqueSkills = [];
+    for (const [name, entries] of skillsByName) {
+        if (entries.length === 1) {
+            uniqueSkills.push(entries[0]);
+            continue;
+        }
+        issues.push(`Ignored duplicate skill name "${name}" from ${entries.map((entry) => `"${entry.filePath}"`).join(", ")}.`);
+    }
+    return uniqueSkills.sort((left, right) => left.name.localeCompare(right.name));
+}
+function parseSkillFile(content) {
+    const normalizedContent = content.replace(/\r\n/g, "\n");
+    const frontmatterMatch = normalizedContent.replace(/^\uFEFF/, "").match(/^---[ \t]*\n([\s\S]*?)\n(?:---|\.\.\.)[ \t]*(?:\n|$)/);
+    if (!frontmatterMatch) {
+        return { success: false, error: "missing YAML frontmatter block" };
+    }
+    const [rawFrontmatterBlock, rawFrontmatter] = frontmatterMatch;
+    const frontmatter = parseYamlFrontmatter(rawFrontmatter);
+    if (!frontmatter.success) {
+        return frontmatter;
+    }
+    return {
+        success: true,
+        frontmatter,
+        body: normalizedContent.replace(/^\uFEFF/, "").slice(rawFrontmatterBlock.length),
+    };
+}
+function parseYamlFrontmatter(rawFrontmatter) {
+    let parsedFrontmatter;
+    try {
+        parsedFrontmatter = parseYaml(rawFrontmatter);
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `invalid YAML frontmatter (${formatErrorDetail(error)})`,
+        };
+    }
+    if (!isPlainRecord(parsedFrontmatter)) {
+        return {
+            success: false,
+            error: "frontmatter must define a YAML mapping",
+        };
+    }
+    const name = parsedFrontmatter.name;
+    if (name !== undefined && typeof name !== "string") {
+        return {
+            success: false,
+            error: 'frontmatter field "name" must define a string value',
+        };
+    }
+    const description = parsedFrontmatter.description;
+    if (description !== undefined && typeof description !== "string") {
+        return {
+            success: false,
+            error: 'frontmatter field "description" must define a string value',
+        };
+    }
+    return {
+        success: true,
+        name: name ?? "",
+        description: description ?? "",
+    };
+}
+function validateSkillFrontmatter(frontmatter) {
+    if (!frontmatter.name.trim()) {
+        return 'frontmatter field "name" is required';
+    }
+    if (frontmatter.name.length > MAX_SKILL_NAME_LENGTH) {
+        return `skill name "${frontmatter.name}" is too long; expected at most ${MAX_SKILL_NAME_LENGTH} characters`;
+    }
+    if (!SKILL_NAME_PATTERN.test(frontmatter.name)) {
+        return `skill name "${frontmatter.name}" must contain lowercase letters, digits, or single hyphens only`;
+    }
+    if (!frontmatter.description.trim()) {
+        return 'frontmatter field "description" is required';
+    }
+    if (frontmatter.description.length > MAX_SKILL_DESCRIPTION_LENGTH) {
+        return `skill description for "${frontmatter.name}" is too long; expected at most ${MAX_SKILL_DESCRIPTION_LENGTH} characters`;
+    }
+    return undefined;
+}
+function isFileNotFoundError(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+async function discoverSkillResources(skillDirectoryPath, resourceDirectoryName) {
+    const rootPath = join(skillDirectoryPath, resourceDirectoryName);
+    const discoveredResources = [];
+    await walkSkillResourceDirectory(rootPath, rootPath, discoveredResources);
+    return discoveredResources.sort((left, right) => left.relativePath.localeCompare(right.relativePath));
+}
+async function walkSkillResourceDirectory(rootPath, currentPath, discoveredResources) {
+    let entries;
+    try {
+        entries = await readdir(currentPath, { withFileTypes: true, encoding: "utf8" });
+    }
+    catch (error) {
+        if (isFileNotFoundError(error)) {
+            return;
+        }
+        throw error;
+    }
+    for (const entry of entries) {
+        const entryPath = join(currentPath, entry.name);
+        if (entry.isDirectory()) {
+            await walkSkillResourceDirectory(rootPath, entryPath, discoveredResources);
+            continue;
+        }
+        if (!entry.isFile()) {
+            continue;
+        }
+        discoveredResources.push({
+            filePath: entryPath,
+            relativePath: relative(rootPath, entryPath).replaceAll("\\", "/"),
+        });
+    }
+}
+function isPlainRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function formatErrorDetail(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=discovery.js.map

package/dist/skills/discovery.js.map

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

package/dist/skills/types.d.ts

@@ -0,0 +1,20 @@
+export interface SkillFrontmatter {
+    name: string;
+    description: string;
+}
+export interface SkillResourceDefinition {
+    relativePath: string;
+    filePath: string;
+}
+export interface SkillDefinition extends SkillFrontmatter {
+    directoryPath: string;
+    filePath: string;
+    body: string;
+    content: string;
+    references: SkillResourceDefinition[];
+    scripts: SkillResourceDefinition[];
+}
+export interface SkillCatalog {
+    skills: SkillDefinition[];
+    issues: string[];
+}

package/dist/skills/types.js

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

package/dist/skills/types.js.map

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

package/dist/storage/fs-store.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimePaths } from "../daemon/types.js";
+import type { ConversationStore } from "./types.js";
+export declare function createFsConversationStore(paths: RuntimePaths): ConversationStore;