@lyupro/skillforge-mcp 1.1.0

package/dist/config/config-schema.d.ts

@@ -0,0 +1,175 @@
+import { z } from 'zod';
+declare const folderEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    priority: z.ZodDefault<z.ZodNumber>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    priority: number;
+    enabled: boolean;
+    tags: string[];
+}, {
+    path: string;
+    priority?: number | undefined;
+    enabled?: boolean | undefined;
+    tags?: string[] | undefined;
+}>;
+export declare const configSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodLiteral<"1.0">>;
+    folders: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        priority: z.ZodDefault<z.ZodNumber>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        priority: number;
+        enabled: boolean;
+        tags: string[];
+    }, {
+        path: string;
+        priority?: number | undefined;
+        enabled?: boolean | undefined;
+        tags?: string[] | undefined;
+    }>, "many">>;
+    blacklist: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    security: z.ZodDefault<z.ZodObject<{
+        autoAudit: z.ZodDefault<z.ZodBoolean>;
+        auditPatterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        allowScripts: z.ZodDefault<z.ZodBoolean>;
+        sandboxScripts: z.ZodDefault<z.ZodBoolean>;
+        sandboxRestrictedPaths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        autoAudit: boolean;
+        auditPatterns: string[];
+        allowScripts: boolean;
+        sandboxScripts: boolean;
+        sandboxRestrictedPaths: string[];
+    }, {
+        autoAudit?: boolean | undefined;
+        auditPatterns?: string[] | undefined;
+        allowScripts?: boolean | undefined;
+        sandboxScripts?: boolean | undefined;
+        sandboxRestrictedPaths?: string[] | undefined;
+    }>>;
+    cache: z.ZodDefault<z.ZodObject<{
+        metadataTtlMs: z.ZodDefault<z.ZodNumber>;
+        contentTtlMs: z.ZodDefault<z.ZodNumber>;
+        maxSizeMb: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        metadataTtlMs: number;
+        contentTtlMs: number;
+        maxSizeMb: number;
+    }, {
+        metadataTtlMs?: number | undefined;
+        contentTtlMs?: number | undefined;
+        maxSizeMb?: number | undefined;
+    }>>;
+    watcher: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        debounceMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        debounceMs: number;
+    }, {
+        enabled?: boolean | undefined;
+        debounceMs?: number | undefined;
+    }>>;
+    logging: z.ZodDefault<z.ZodObject<{
+        level: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+        file: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        level: "debug" | "info" | "warn" | "error";
+        file: string | null;
+    }, {
+        level?: "debug" | "info" | "warn" | "error" | undefined;
+        file?: string | null | undefined;
+    }>>;
+    invocation: z.ZodDefault<z.ZodObject<{
+        defaultTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        cacheTtlMs: z.ZodDefault<z.ZodNumber>;
+        cacheMaxEntries: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        defaultTimeoutMs: number;
+        cacheTtlMs: number;
+        cacheMaxEntries: number;
+    }, {
+        defaultTimeoutMs?: number | undefined;
+        cacheTtlMs?: number | undefined;
+        cacheMaxEntries?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    version: "1.0";
+    folders: {
+        path: string;
+        priority: number;
+        enabled: boolean;
+        tags: string[];
+    }[];
+    blacklist: string[];
+    security: {
+        autoAudit: boolean;
+        auditPatterns: string[];
+        allowScripts: boolean;
+        sandboxScripts: boolean;
+        sandboxRestrictedPaths: string[];
+    };
+    cache: {
+        metadataTtlMs: number;
+        contentTtlMs: number;
+        maxSizeMb: number;
+    };
+    watcher: {
+        enabled: boolean;
+        debounceMs: number;
+    };
+    logging: {
+        level: "debug" | "info" | "warn" | "error";
+        file: string | null;
+    };
+    invocation: {
+        defaultTimeoutMs: number;
+        cacheTtlMs: number;
+        cacheMaxEntries: number;
+    };
+}, {
+    version?: "1.0" | undefined;
+    folders?: {
+        path: string;
+        priority?: number | undefined;
+        enabled?: boolean | undefined;
+        tags?: string[] | undefined;
+    }[] | undefined;
+    blacklist?: string[] | undefined;
+    security?: {
+        autoAudit?: boolean | undefined;
+        auditPatterns?: string[] | undefined;
+        allowScripts?: boolean | undefined;
+        sandboxScripts?: boolean | undefined;
+        sandboxRestrictedPaths?: string[] | undefined;
+    } | undefined;
+    cache?: {
+        metadataTtlMs?: number | undefined;
+        contentTtlMs?: number | undefined;
+        maxSizeMb?: number | undefined;
+    } | undefined;
+    watcher?: {
+        enabled?: boolean | undefined;
+        debounceMs?: number | undefined;
+    } | undefined;
+    logging?: {
+        level?: "debug" | "info" | "warn" | "error" | undefined;
+        file?: string | null | undefined;
+    } | undefined;
+    invocation?: {
+        defaultTimeoutMs?: number | undefined;
+        cacheTtlMs?: number | undefined;
+        cacheMaxEntries?: number | undefined;
+    } | undefined;
+}>;
+export type PersistedConfig = z.infer<typeof configSchema>;
+export type FolderEntry = z.infer<typeof folderEntrySchema>;
+export declare function defaultConfig(): PersistedConfig;
+export {};
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/config/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/config/config-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;EAKrB,CAAC;AAkCH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASvB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAC3D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,wBAAgB,aAAa,IAAI,eAAe,CAE/C"}

package/dist/config/config-schema.js

@@ -0,0 +1,49 @@
+// Why: camelCase keys match TS identifiers 1:1 — no key transforms needed between code and JSON.
+import { z } from 'zod';
+const folderEntrySchema = z.object({
+    path: z.string().min(1),
+    priority: z.number().int().default(100),
+    enabled: z.boolean().default(true),
+    tags: z.array(z.string()).default([]),
+});
+const securitySchema = z.object({
+    autoAudit: z.boolean().default(true),
+    auditPatterns: z
+        .array(z.string())
+        .default(['shell=True', 'eval\\(', 'exec\\(', 'base64\\.b64decode']),
+    allowScripts: z.boolean().default(false),
+    sandboxScripts: z.boolean().default(true),
+    sandboxRestrictedPaths: z.array(z.string()).default(['~/.ssh', '~/.aws', '~/.gnupg']),
+});
+const cacheSchema = z.object({
+    metadataTtlMs: z.number().nonnegative().default(300_000),
+    contentTtlMs: z.number().nonnegative().default(300_000),
+    maxSizeMb: z.number().nonnegative().default(50),
+});
+const watcherSchema = z.object({
+    enabled: z.boolean().default(true),
+    debounceMs: z.number().nonnegative().default(500),
+});
+const loggingSchema = z.object({
+    level: z.enum(['debug', 'info', 'warn', 'error']).default('info'),
+    file: z.string().nullable().default(null),
+});
+const invocationSchema = z.object({
+    defaultTimeoutMs: z.number().nonnegative().default(30_000),
+    cacheTtlMs: z.number().nonnegative().default(60_000),
+    cacheMaxEntries: z.number().nonnegative().default(128),
+});
+export const configSchema = z.object({
+    version: z.literal('1.0').default('1.0'),
+    folders: z.array(folderEntrySchema).default([]),
+    blacklist: z.array(z.string()).default([]),
+    security: securitySchema.default({}),
+    cache: cacheSchema.default({}),
+    watcher: watcherSchema.default({}),
+    logging: loggingSchema.default({}),
+    invocation: invocationSchema.default({}),
+});
+export function defaultConfig() {
+    return configSchema.parse({});
+}
+//# sourceMappingURL=config-schema.js.map

package/dist/config/config-schema.js.map

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

package/dist/config/config-store.d.ts

@@ -0,0 +1,24 @@
+import type { PersistedConfig } from './config-schema.js';
+interface FsAdapter {
+    readFile: (p: string) => Promise<string>;
+    writeFile: (p: string, contents: string) => Promise<void>;
+    rename: (oldP: string, newP: string) => Promise<void>;
+    mkdir: (p: string, opts: {
+        recursive: boolean;
+    }) => Promise<void>;
+    access: (p: string) => Promise<void>;
+}
+export interface ConfigStoreOptions {
+    filePath: string;
+    fs?: FsAdapter;
+}
+export declare class ConfigStore {
+    #private;
+    constructor(opts: ConfigStoreOptions);
+    load(): Promise<PersistedConfig>;
+    save(config: PersistedConfig): Promise<void>;
+    getFilePath(): string;
+}
+export declare function defaultConfigPath(): string;
+export {};
+//# sourceMappingURL=config-store.d.ts.map

package/dist/config/config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../../src/config/config-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,UAAU,SAAS;IACjB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,SAAS,CAAC;CAChB;AAYD,qBAAa,WAAW;;gBAIV,IAAI,EAAE,kBAAkB;IAK9B,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAmChC,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD,WAAW,IAAI,MAAM;CAGtB;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/config/config-store.js

@@ -0,0 +1,67 @@
+import { readFile, writeFile, rename, mkdir, access } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { configSchema, defaultConfig } from './config-schema.js';
+function buildDefaultFs() {
+    return {
+        readFile: (p) => readFile(p, 'utf8'),
+        writeFile: (p, contents) => writeFile(p, contents),
+        rename: (oldP, newP) => rename(oldP, newP),
+        mkdir: (p, opts) => mkdir(p, opts).then(() => undefined),
+        access: (p) => access(p).then(() => undefined),
+    };
+}
+export class ConfigStore {
+    #filePath;
+    #fs;
+    constructor(opts) {
+        this.#filePath = opts.filePath;
+        this.#fs = opts.fs ?? buildDefaultFs();
+    }
+    async load() {
+        let raw;
+        try {
+            await this.#fs.access(this.#filePath);
+        }
+        catch {
+            return defaultConfig();
+        }
+        try {
+            raw = await this.#fs.readFile(this.#filePath);
+        }
+        catch (err) {
+            throw new Error(`ConfigStore: failed to read "${this.#filePath}": ${String(err)}`);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            throw new Error(`ConfigStore: invalid JSON in "${this.#filePath}": ${String(err)}`);
+        }
+        const result = configSchema.safeParse(parsed);
+        if (!result.success) {
+            throw new Error(`ConfigStore: schema validation failed for "${this.#filePath}": ${result.error.message}`);
+        }
+        return result.data;
+    }
+    async save(config) {
+        const result = configSchema.safeParse(config);
+        if (!result.success) {
+            throw new Error(`ConfigStore: cannot save invalid config: ${result.error.message}`);
+        }
+        const dir = dirname(this.#filePath);
+        await this.#fs.mkdir(dir, { recursive: true });
+        const tmpPath = `${this.#filePath}.tmp`;
+        const contents = JSON.stringify(result.data, null, 2);
+        await this.#fs.writeFile(tmpPath, contents);
+        await this.#fs.rename(tmpPath, this.#filePath);
+    }
+    getFilePath() {
+        return this.#filePath;
+    }
+}
+export function defaultConfigPath() {
+    return join(homedir(), '.lyupro', '.skillforge', 'config.json');
+}
+//# sourceMappingURL=config-store.js.map

package/dist/config/config-store.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,5 @@
+export { configSchema, defaultConfig } from './config-schema.js';
+export type { PersistedConfig, FolderEntry } from './config-schema.js';
+export { ConfigStore, defaultConfigPath } from './config-store.js';
+export type { ConfigStoreOptions } from './config-store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,3 @@
+export { configSchema, defaultConfig } from './config-schema.js';
+export { ConfigStore, defaultConfigPath } from './config-store.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+import { ConfigStore } from './config/index.js';
+import type { PersistedConfig } from './config/index.js';
+import { PatternScanner } from './security/index.js';
+export interface SkillForgeConfig {
+    /** Resolved absolute paths, deduplicated, in priority order. */
+    folders: string[];
+    /** Cache TTL in milliseconds. */
+    ttlMs: number;
+}
+export declare function loadConfig(env?: NodeJS.ProcessEnv): SkillForgeConfig;
+export interface ResolvedConfig {
+    /** Folders ultimately used by the server (env override > persisted folders > built-in default). */
+    folders: string[];
+    ttlMs: number;
+    /** Full persisted config (or schema defaults if file absent). */
+    persisted: PersistedConfig;
+}
+/** Load env + persisted config and merge. Env folders win when set; otherwise
+ *  enabled persisted folders (priority desc; ties → first-listed); otherwise
+ *  the built-in default. */
+export declare function loadResolvedConfig(env?: NodeJS.ProcessEnv, store?: ConfigStore): Promise<ResolvedConfig>;
+/** Build a PatternScanner from persisted security settings, or null if auto-audit is off
+ *  or the patterns list is empty. */
+export declare function buildPatternScanner(persisted: PersistedConfig): PatternScanner | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAqB,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAwBD,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,gBAAgB,CAQjF;AAED,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED;;4BAE4B;AAC5B,wBAAsB,kBAAkB,CACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,CAAC,CA0BzB;AAED;qCACqC;AACrC,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,eAAe,GAAG,cAAc,GAAG,IAAI,CAKrF"}

package/dist/config.js

@@ -0,0 +1,73 @@
+import { delimiter, join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { ConfigStore, defaultConfigPath } from './config/index.js';
+import { PatternScanner } from './security/index.js';
+const DEFAULT_TTL_MS = 300_000;
+function parseFolders(raw) {
+    if (!raw)
+        return [];
+    return raw
+        .split(delimiter)
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .reduce((acc, p) => {
+        const abs = resolve(p);
+        if (!acc.includes(abs))
+            acc.push(abs);
+        return acc;
+    }, []);
+}
+function parseTtl(raw) {
+    if (!raw)
+        return DEFAULT_TTL_MS;
+    const n = Number(raw);
+    if (Number.isNaN(n) || n <= 0)
+        return DEFAULT_TTL_MS;
+    return n;
+}
+export function loadConfig(env = process.env) {
+    const folders = parseFolders(env['SKILLFORGE_FOLDERS']);
+    const defaultFolder = join(homedir(), '.claude', 'plugins', 'cache', 'claude-code-skills');
+    return {
+        folders: folders.length > 0 ? folders : [defaultFolder],
+        ttlMs: parseTtl(env['SKILLFORGE_TTL_MS']),
+    };
+}
+/** Load env + persisted config and merge. Env folders win when set; otherwise
+ *  enabled persisted folders (priority desc; ties → first-listed); otherwise
+ *  the built-in default. */
+export async function loadResolvedConfig(env = process.env, store) {
+    const resolvedStore = store ?? new ConfigStore({ filePath: defaultConfigPath() });
+    const persisted = await resolvedStore.load();
+    const envFolders = parseFolders(env['SKILLFORGE_FOLDERS']);
+    const defaultFolder = join(homedir(), '.claude', 'plugins', 'cache', 'claude-code-skills');
+    let folders;
+    if (envFolders.length > 0) {
+        folders = envFolders;
+    }
+    else {
+        const enabled = persisted.folders.filter((f) => f.enabled);
+        if (enabled.length > 0) {
+            // Sort by priority descending; stable for ties (Array.sort is stable in V8).
+            const sorted = [...enabled].sort((a, b) => b.priority - a.priority);
+            folders = sorted.map((f) => resolve(f.path));
+        }
+        else {
+            folders = [defaultFolder];
+        }
+    }
+    return {
+        folders,
+        ttlMs: parseTtl(env['SKILLFORGE_TTL_MS']),
+        persisted,
+    };
+}
+/** Build a PatternScanner from persisted security settings, or null if auto-audit is off
+ *  or the patterns list is empty. */
+export function buildPatternScanner(persisted) {
+    if (!persisted.security.autoAudit || persisted.security.auditPatterns.length === 0) {
+        return null;
+    }
+    return new PatternScanner({ patterns: persisted.security.auditPatterns });
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Thrown when DFS through composite skill `skills:` references reaches
+ * a skill already on the visit path. Carries the cycle path for diagnosis.
+ */
+export declare class CyclicSkillDependencyError extends Error {
+    readonly path: readonly string[];
+    constructor(path: readonly string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;gBAErB,IAAI,EAAE,SAAS,MAAM,EAAE;CAKpC"}

package/dist/core/errors.js

@@ -0,0 +1,13 @@
+/**
+ * Thrown when DFS through composite skill `skills:` references reaches
+ * a skill already on the visit path. Carries the cycle path for diagnosis.
+ */
+export class CyclicSkillDependencyError extends Error {
+    path;
+    constructor(path) {
+        super(`composite skill cycle detected: ${path.join(' → ')}`);
+        this.name = 'CyclicSkillDependencyError';
+        this.path = path;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,CAAoB;IAEjC,YAAY,IAAuB;QACjC,KAAK,CAAC,mCAAmC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export { SkillRegistry } from './skill-registry.js';
+export { SkillResolver } from './skill-resolver.js';
+export { SkillMetadataCache } from './skill-metadata-cache.js';
+export { SkillContentCache } from './skill-content-cache.js';
+export type { SkillFormat, StrategyKind, SkillSummary, SkillMetadata, SkillContent, InvocationContext, InvocationResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,5 @@
+export { SkillRegistry } from './skill-registry.js';
+export { SkillResolver } from './skill-resolver.js';
+export { SkillMetadataCache } from './skill-metadata-cache.js';
+export { SkillContentCache } from './skill-content-cache.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/core/skill-content-cache.d.ts

@@ -0,0 +1,18 @@
+import type { SkillContent } from './types.js';
+interface ContentCacheOptions {
+    ttlMs?: number;
+    now?: () => number;
+    maxEntries?: number;
+}
+export declare class SkillContentCache {
+    #private;
+    constructor(options?: ContentCacheOptions);
+    get(name: string): SkillContent | undefined;
+    set(name: string, content: SkillContent): void;
+    invalidate(name: string): boolean;
+    clear(): void;
+    get size(): number;
+    get ttlMs(): number;
+}
+export {};
+//# sourceMappingURL=skill-content-cache.d.ts.map

package/dist/core/skill-content-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content-cache.d.ts","sourceRoot":"","sources":["../../src/core/skill-content-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,qBAAa,iBAAiB;;gBAOhB,OAAO,CAAC,EAAE,mBAAmB;IAczC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAW3C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAY9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}

package/dist/core/skill-content-cache.js

@@ -0,0 +1,56 @@
+export class SkillContentCache {
+    #ttlMs;
+    #now;
+    #maxEntries;
+    // Map preserves insertion order — first entry is least-recently-used.
+    #store = new Map();
+    constructor(options) {
+        const ttlMs = options?.ttlMs ?? 300_000;
+        const maxEntries = options?.maxEntries ?? 256;
+        if (ttlMs <= 0) {
+            throw new Error('ttlMs must be a positive number');
+        }
+        if (maxEntries <= 0) {
+            throw new Error('maxEntries must be a positive number');
+        }
+        this.#ttlMs = ttlMs;
+        this.#maxEntries = maxEntries;
+        this.#now = options?.now ?? Date.now;
+    }
+    get(name) {
+        const entry = this.#store.get(name);
+        if (entry === undefined)
+            return undefined;
+        if (this.#now() >= entry.expiresAt) {
+            // Remove stale entry rather than serving expired content.
+            this.#store.delete(name);
+            return undefined;
+        }
+        return entry.content;
+    }
+    set(name, content) {
+        // Move existing key to end (most-recently-used) by removing before re-inserting.
+        if (this.#store.has(name)) {
+            this.#store.delete(name);
+        }
+        else if (this.#store.size >= this.#maxEntries) {
+            // Evict the first (least-recently-used) entry.
+            const firstKey = this.#store.keys().next().value;
+            this.#store.delete(firstKey);
+        }
+        this.#store.set(name, { content, expiresAt: this.#now() + this.#ttlMs });
+    }
+    invalidate(name) {
+        return this.#store.delete(name);
+    }
+    clear() {
+        this.#store.clear();
+    }
+    get size() {
+        return this.#store.size;
+    }
+    get ttlMs() {
+        return this.#ttlMs;
+    }
+}
+//# sourceMappingURL=skill-content-cache.js.map

package/dist/core/skill-content-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content-cache.js","sourceRoot":"","sources":["../../src/core/skill-content-cache.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,iBAAiB;IACnB,MAAM,CAAS;IACf,IAAI,CAAe;IACnB,WAAW,CAAS;IAC7B,sEAAsE;IAC7D,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEhD,YAAY,OAA6B;QACvC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,OAAO,CAAC;QACxC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,GAAG,CAAC;QAC9C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACnC,0DAA0D;YAC1D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,OAAqB;QACrC,iFAAiF;QACjF,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAChD,+CAA+C;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/core/skill-metadata-cache.d.ts

@@ -0,0 +1,15 @@
+interface MetadataCacheOptions {
+    ttlMs?: number;
+    now?: () => number;
+}
+export declare class SkillMetadataCache {
+    #private;
+    constructor(options?: MetadataCacheOptions);
+    isValid(): boolean;
+    markFresh(): void;
+    invalidate(): void;
+    expiresAt(): number | null;
+    get ttlMs(): number;
+}
+export {};
+//# sourceMappingURL=skill-metadata-cache.d.ts.map

package/dist/core/skill-metadata-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-metadata-cache.d.ts","sourceRoot":"","sources":["../../src/core/skill-metadata-cache.ts"],"names":[],"mappings":"AAAA,UAAU,oBAAoB;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,kBAAkB;;gBAKjB,OAAO,CAAC,EAAE,oBAAoB;IAS1C,OAAO,IAAI,OAAO;IAIlB,SAAS,IAAI,IAAI;IAIjB,UAAU,IAAI,IAAI;IAIlB,SAAS,IAAI,MAAM,GAAG,IAAI;IAK1B,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}