@hashicorp/kits 0.1.0

package/dist/cli/validate.js

@@ -0,0 +1,307 @@
+/**
+ * Validate command implementation.
+ *
+ * Validates kit repositories or individual primitive files.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import pc from "picocolors";
+import { ExitCode } from "./types.js";
+import { formatValidationSourceError, resolveValidationSource } from "../validation/source.js";
+import { validateCommands, validateSkills, validateSubagents, validateHooks, validateMcp, validateKits, } from "../validation/index.js";
+import { summarizeResults, printValidationResults } from "../validation/utils.js";
+import { debugLog, enableDebugLogging, getDebugLogPath, checkDebugLogWritable, } from "../core/debug.js";
+const VALIDATION_TITLES = {
+    commands: "Command Primitive Validation",
+    skills: "Skill Primitive Validation",
+    subagents: "Subagent Primitive Validation",
+    hooks: "Hook Primitive Validation",
+    mcp: "MCP Primitive Validation",
+    kits: "Kit Registry & Manifest Validation",
+};
+const ALL_KINDS = [
+    "commands",
+    "skills",
+    "subagents",
+    "hooks",
+    "mcp",
+    "kits",
+];
+function getSelectedKinds(options) {
+    const selected = [];
+    if (options.commands)
+        selected.push("commands");
+    if (options.skills)
+        selected.push("skills");
+    if (options.subagents)
+        selected.push("subagents");
+    if (options.hooks)
+        selected.push("hooks");
+    if (options.mcp)
+        selected.push("mcp");
+    if (options.kits)
+        selected.push("kits");
+    return selected;
+}
+async function resolveInput(source) {
+    const resolved = path.resolve(source);
+    try {
+        const stat = await fs.stat(resolved);
+        return { localPath: resolved, isFile: stat.isFile() };
+    }
+    catch {
+        const fetchResult = await resolveValidationSource(source);
+        return {
+            localPath: fetchResult.localPath,
+            isFile: false,
+            cleanup: fetchResult.cleanup,
+        };
+    }
+}
+async function pathExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findRepoRoot(filePath) {
+    let current = path.dirname(filePath);
+    while (true) {
+        const kitsJson = path.join(current, "kits.json");
+        const primitivesJson = path.join(current, "primitives.json");
+        if (await pathExists(kitsJson) || await pathExists(primitivesJson)) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+    }
+}
+function inferFileKinds(filePath, repoRoot) {
+    const relative = path.relative(repoRoot, filePath);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        return undefined;
+    }
+    const parts = relative.split(path.sep);
+    const fileName = parts[parts.length - 1] ?? "";
+    if (relative === "kits.json") {
+        return { primary: "kits", eligible: ["kits"] };
+    }
+    if (fileName === "kit.json") {
+        return { primary: "kits", eligible: ["kits", "hooks"] };
+    }
+    const primitivesIndex = parts.indexOf("primitives");
+    if (primitivesIndex !== -1 && parts[primitivesIndex + 1]) {
+        const primitiveType = parts[primitivesIndex + 1];
+        switch (primitiveType) {
+            case "commands":
+                if (fileName.endsWith(".md")) {
+                    return { primary: "commands", eligible: ["commands"] };
+                }
+                break;
+            case "skills":
+                if (fileName === "SKILL.md") {
+                    return { primary: "skills", eligible: ["skills"] };
+                }
+                break;
+            case "subagents":
+                if (fileName.endsWith(".md")) {
+                    return { primary: "subagents", eligible: ["subagents"] };
+                }
+                break;
+            case "hooks":
+                if (fileName === "config.json") {
+                    return { primary: "hooks", eligible: ["hooks"] };
+                }
+                break;
+            case "mcp":
+                if (fileName === "config.json") {
+                    return { primary: "mcp", eligible: ["mcp"] };
+                }
+                break;
+            default:
+                return undefined;
+        }
+    }
+    return undefined;
+}
+function filterSummaryToFile(summary, filePath) {
+    const resolved = path.resolve(filePath);
+    const filtered = summary.results.filter((result) => path.resolve(result.file) === resolved);
+    return summarizeResults(filtered);
+}
+async function runValidator(kind, repoRoot) {
+    switch (kind) {
+        case "commands":
+            return validateCommands(repoRoot);
+        case "skills":
+            return validateSkills(repoRoot);
+        case "subagents":
+            return validateSubagents(repoRoot);
+        case "hooks":
+            return validateHooks(repoRoot);
+        case "mcp":
+            return validateMcp(repoRoot);
+        case "kits":
+            return validateKits(repoRoot);
+        default:
+            return summarizeResults([]);
+    }
+}
+export async function runValidate(source, options) {
+    enableDebugLogging(options.debug ?? false);
+    if (options.debug) {
+        const debugCheck = checkDebugLogWritable();
+        if (!debugCheck.ok) {
+            console.error(`Warning: Debug logging enabled but cannot write to ${debugCheck.path}: ${debugCheck.error}`);
+        }
+        void debugLog({
+            level: "info",
+            event: "debug.enabled",
+            message: "Debug logging enabled",
+            data: { logPath: getDebugLogPath() },
+        });
+    }
+    const selectedKinds = getSelectedKinds(options);
+    const kindsToRun = selectedKinds.length > 0 ? selectedKinds : ALL_KINDS;
+    let fetchResult;
+    try {
+        const resolved = await resolveInput(source);
+        fetchResult = resolved.cleanup
+            ? { localPath: resolved.localPath, cleanup: resolved.cleanup }
+            : undefined;
+        if (resolved.isFile) {
+            const repoRoot = await findRepoRoot(resolved.localPath);
+            if (!repoRoot) {
+                return {
+                    success: false,
+                    exitCode: ExitCode.InvalidArguments,
+                    error: "File is not inside a kit repository (missing kits.json or primitives.json)",
+                };
+            }
+            const inferred = inferFileKinds(resolved.localPath, repoRoot);
+            if (!inferred) {
+                return {
+                    success: false,
+                    exitCode: ExitCode.InvalidArguments,
+                    error: "Unable to infer validator for file. Ensure it is within a kit repository structure.",
+                };
+            }
+            const eligible = new Set(inferred.eligible);
+            const fileKinds = selectedKinds.length === 0
+                ? [inferred.primary]
+                : selectedKinds.filter((kind) => eligible.has(kind));
+            if (fileKinds.length === 0) {
+                return {
+                    success: false,
+                    exitCode: ExitCode.InvalidArguments,
+                    error: `File does not match selected validators (${selectedKinds.join(", ")})`,
+                };
+            }
+            const output = options.json
+                ? { success: true, path: resolved.localPath, results: {} }
+                : undefined;
+            let failed = false;
+            for (const kind of fileKinds) {
+                const summary = await runValidator(kind, repoRoot);
+                const filtered = filterSummaryToFile(summary, resolved.localPath);
+                if (filtered.results.length === 0) {
+                    return {
+                        success: false,
+                        exitCode: ExitCode.InvalidArguments,
+                        error: `No matching ${kind} validator entry for ${resolved.localPath}`,
+                    };
+                }
+                if (options.json && output) {
+                    output.results[kind] = filtered;
+                }
+                else {
+                    printValidationResults(VALIDATION_TITLES[kind], filtered, repoRoot);
+                    if (filtered.total === 0) {
+                        console.log(pc.yellow(`Warning: No ${kind} files found`));
+                    }
+                }
+                if (filtered.failed > 0) {
+                    failed = true;
+                }
+            }
+            if (options.json && output) {
+                output.success = !failed;
+                console.log(JSON.stringify(output, null, 2));
+            }
+            const result = {
+                success: !failed,
+                exitCode: failed ? ExitCode.InstallationFailed : ExitCode.Success,
+            };
+            if (output) {
+                result.output = output;
+            }
+            return result;
+        }
+        const repoRoot = resolved.localPath;
+        const output = options.json
+            ? { success: true, path: repoRoot, results: {} }
+            : undefined;
+        let failed = false;
+        if (!options.json) {
+            console.log(pc.dim(`Validating kit repository at: ${repoRoot}`));
+        }
+        for (const kind of kindsToRun) {
+            const summary = await runValidator(kind, repoRoot);
+            if (options.json && output) {
+                output.results[kind] = summary;
+            }
+            else {
+                printValidationResults(VALIDATION_TITLES[kind], summary, repoRoot);
+                if (summary.total === 0) {
+                    console.log(pc.yellow(`Warning: No ${kind} files found`));
+                }
+            }
+            if (summary.failed > 0) {
+                failed = true;
+            }
+        }
+        if (options.json && output) {
+            output.success = !failed;
+            console.log(JSON.stringify(output, null, 2));
+        }
+        if (!failed && !options.json) {
+            console.log(pc.green("All validations passed"));
+        }
+        const result = {
+            success: !failed,
+            exitCode: failed ? ExitCode.InstallationFailed : ExitCode.Success,
+        };
+        if (output) {
+            result.output = output;
+        }
+        return result;
+    }
+    catch (error) {
+        if (options.json) {
+            console.log(JSON.stringify({
+                success: false,
+                path: source,
+                error: error instanceof Error ? error.message : String(error),
+            }, null, 2));
+        }
+        else {
+            const message = formatValidationSourceError(error);
+            console.error(pc.red(`Error: ${message}`));
+        }
+        return {
+            success: false,
+            exitCode: ExitCode.InvalidArguments,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+    finally {
+        await fetchResult?.cleanup?.();
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/validate.js.map

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

package/dist/core/debug.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Debug logging utilities.
+ *
+ * Writes structured JSON log lines to ~/.config/agent-kit/debug.log
+ * when debug logging is enabled.
+ */
+export type DebugLogLevel = "debug" | "info" | "warn" | "error";
+export interface DebugLogEntry {
+    level: DebugLogLevel;
+    event: string;
+    message?: string;
+    data?: Record<string, unknown>;
+}
+export declare function enableDebugLogging(enabled: boolean, logPath?: string): void;
+export declare function isDebugLoggingEnabled(): boolean;
+export declare function getDebugLogPath(): string;
+export declare function checkDebugLogWritable(): {
+    ok: boolean;
+    error?: string;
+    path: string;
+};
+export declare function debugLog(entry: DebugLogEntry): Promise<void>;
+//# sourceMappingURL=debug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/core/debug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAeD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ3E;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,qBAAqB,IAAI;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgBrF;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAclE"}

package/dist/core/debug.js

@@ -0,0 +1,69 @@
+/**
+ * Debug logging utilities.
+ *
+ * Writes structured JSON log lines to ~/.config/agent-kit/debug.log
+ * when debug logging is enabled.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+const defaultLogPath = path.join(os.homedir(), ".config", "agent-kit", "debug.log");
+let debugEnabled = false;
+let debugLogPath = defaultLogPath;
+let initDone = false;
+function ensureLogDirSync() {
+    if (initDone)
+        return;
+    const dir = path.dirname(debugLogPath);
+    fs.mkdirSync(dir, { recursive: true });
+    initDone = true;
+}
+export function enableDebugLogging(enabled, logPath) {
+    debugEnabled = enabled;
+    if (logPath) {
+        debugLogPath = logPath;
+    }
+    if (debugEnabled) {
+        initDone = false;
+    }
+}
+export function isDebugLoggingEnabled() {
+    return debugEnabled;
+}
+export function getDebugLogPath() {
+    return debugLogPath;
+}
+export function checkDebugLogWritable() {
+    if (!debugEnabled) {
+        return { ok: true, path: debugLogPath };
+    }
+    try {
+        ensureLogDirSync();
+        fs.appendFileSync(debugLogPath, "", { encoding: "utf-8" });
+        return { ok: true, path: debugLogPath };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            path: debugLogPath,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+export async function debugLog(entry) {
+    if (!debugEnabled)
+        return;
+    try {
+        ensureLogDirSync();
+        const payload = {
+            ts: new Date().toISOString(),
+            pid: process.pid,
+            ...entry,
+        };
+        fs.appendFileSync(debugLogPath, `${JSON.stringify(payload)}\n`, { encoding: "utf-8" });
+    }
+    catch {
+        // Never throw from debug logging
+    }
+}
+//# sourceMappingURL=debug.js.map

package/dist/core/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/core/debug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAW9B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAEpF,IAAI,YAAY,GAAG,KAAK,CAAC;AACzB,IAAI,YAAY,GAAG,cAAc,CAAC;AAClC,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,SAAS,gBAAgB;IACvB,IAAI,QAAQ;QAAE,OAAO;IACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,OAAgB;IACnE,YAAY,GAAG,OAAO,CAAC;IACvB,IAAI,OAAO,EAAE,CAAC;QACZ,YAAY,GAAG,OAAO,CAAC;IACzB,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,QAAQ,GAAG,KAAK,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC;QACH,gBAAgB,EAAE,CAAC;QACnB,EAAE,CAAC,cAAc,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAoB;IACjD,IAAI,CAAC,YAAY;QAAE,OAAO;IAE1B,IAAI,CAAC;QACH,gBAAgB,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG;YACd,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,KAAK;SACT,CAAC;QACF,EAAE,CAAC,cAAc,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,iCAAiC;IACnC,CAAC;AACH,CAAC"}

package/dist/core/hook-instance.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hook instance hashing utilities.
+ *
+ * Produces a stable hash for a hook program config + binding overrides.
+ */
+import type { HookProgramConfig, HookBinding } from "./types.js";
+export declare function hashHookConfig(program: HookProgramConfig, binding: HookBinding): string;
+//# sourceMappingURL=hook-instance.d.ts.map

package/dist/core/hook-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-instance.d.ts","sourceRoot":"","sources":["../../src/core/hook-instance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAsDjE,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CASvF"}

package/dist/core/hook-instance.js

@@ -0,0 +1,62 @@
+/**
+ * Hook instance hashing utilities.
+ *
+ * Produces a stable hash for a hook program config + binding overrides.
+ */
+import { createHash } from "node:crypto";
+function stableStringify(value) {
+    return JSON.stringify(sortValue(value));
+}
+function sortValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => sortValue(item));
+    }
+    if (value && typeof value === "object") {
+        const record = value;
+        const sorted = {};
+        for (const key of Object.keys(record).sort()) {
+            sorted[key] = sortValue(record[key]);
+        }
+        return sorted;
+    }
+    return value;
+}
+function normalizeProgram(config) {
+    return {
+        name: config.name,
+        version: config.version,
+        runtime: {
+            type: config.runtime.type,
+            entrypoint: config.runtime.entrypoint,
+            shell: config.runtime.shell ?? null,
+            working_directory: config.runtime.working_directory ?? null,
+            args: config.runtime.args ?? [],
+            timeout_ms: config.runtime.timeout_ms ?? null,
+        },
+        io: {
+            stdin: config.io.stdin,
+            stdout: config.io.stdout,
+            error_codes: config.io.error_codes ?? null,
+        },
+        env: config.env ?? null,
+    };
+}
+function normalizeBinding(binding) {
+    return {
+        event: binding.event,
+        matcher: binding.matcher ?? null,
+        policy: binding.policy ?? null,
+        runtime: binding.runtime ?? null,
+        env: binding.env ?? null,
+    };
+}
+export function hashHookConfig(program, binding) {
+    const payload = {
+        program: normalizeProgram(program),
+        binding: normalizeBinding(binding),
+    };
+    const content = stableStringify(payload);
+    const digest = createHash("sha256").update(content).digest("hex");
+    return `sha256:${digest}`;
+}
+//# sourceMappingURL=hook-instance.js.map

package/dist/core/hook-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-instance.js","sourceRoot":"","sources":["../../src/core/hook-instance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAyB;IACjD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;YACzB,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU;YACrC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI;YACnC,iBAAiB,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,IAAI,IAAI;YAC3D,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE;YAC/B,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI;SAC9C;QACD,EAAE,EAAE;YACF,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK;YACtB,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM;YACxB,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,WAAW,IAAI,IAAI;SAC3C;QACD,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAoB;IAC5C,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,IAAI;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAA0B,EAAE,OAAoB;IAC7E,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC;QAClC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC;KACnC,CAAC;IAEF,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,OAAO,UAAU,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/core/mcp-instance.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP instance hashing utilities.
+ *
+ * Produces a stable hash for an MCP server config + resolved env/header values.
+ */
+import type { McpServerConfig, ResolvedEnvVar, ResolvedHeader } from "./types.js";
+/**
+ * Compute a stable hash for an MCP server config plus resolved env/header values.
+ *
+ * The hash includes transport, env, headers, and version fields.
+ */
+export declare function hashMcpConfig(config: McpServerConfig, resolvedEnv?: ResolvedEnvVar[], resolvedHeaders?: ResolvedHeader[]): string;
+//# sourceMappingURL=mcp-instance.d.ts.map

package/dist/core/mcp-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-instance.d.ts","sourceRoot":"","sources":["../../src/core/mcp-instance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiFlF;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,WAAW,GAAE,cAAc,EAAO,EAClC,eAAe,GAAE,cAAc,EAAO,GACrC,MAAM,CAWR"}

package/dist/core/mcp-instance.js

@@ -0,0 +1,80 @@
+/**
+ * MCP instance hashing utilities.
+ *
+ * Produces a stable hash for an MCP server config + resolved env/header values.
+ */
+import { createHash } from "node:crypto";
+function normalizeEnv(resolved = []) {
+    return [...resolved]
+        .map((r) => ({
+        name: r.name,
+        value: r.value ?? null,
+        passthrough: r.usePassthrough,
+        sensitive: r.sensitive,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+function normalizeHeaders(resolved = []) {
+    return [...resolved]
+        .map((r) => ({
+        name: r.name,
+        value: r.value ?? null,
+        envVar: r.envVar ?? null,
+        passthrough: r.usePassthrough,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+function normalizeTransport(config) {
+    if (config.transport.type === "stdio") {
+        const transport = {
+            type: "stdio",
+            command: config.transport.command,
+        };
+        if (config.transport.args !== undefined) {
+            transport["args"] = config.transport.args;
+        }
+        if (config.transport.cwd !== undefined) {
+            transport["cwd"] = config.transport.cwd;
+        }
+        return transport;
+    }
+    const transport = {
+        type: "http",
+        url: config.transport.url,
+    };
+    return transport;
+}
+function stableStringify(value) {
+    return JSON.stringify(sortValue(value));
+}
+function sortValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => sortValue(item));
+    }
+    if (value && typeof value === "object") {
+        const record = value;
+        const sorted = {};
+        for (const key of Object.keys(record).sort()) {
+            sorted[key] = sortValue(record[key]);
+        }
+        return sorted;
+    }
+    return value;
+}
+/**
+ * Compute a stable hash for an MCP server config plus resolved env/header values.
+ *
+ * The hash includes transport, env, headers, and version fields.
+ */
+export function hashMcpConfig(config, resolvedEnv = [], resolvedHeaders = []) {
+    const payload = {
+        version: config.version,
+        transport: normalizeTransport(config),
+        env: normalizeEnv(resolvedEnv),
+        headers: normalizeHeaders(resolvedHeaders),
+    };
+    const content = stableStringify(payload);
+    const digest = createHash("sha256").update(content).digest("hex");
+    return `sha256:${digest}`;
+}
+//# sourceMappingURL=mcp-instance.js.map

package/dist/core/mcp-instance.js.map

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