@hashicorp/kits 0.1.0

package/dist/validation/validate-kits.js

@@ -0,0 +1,185 @@
+/**
+ * Kit manifest and registry validation script.
+ *
+ * Validates kit.json files and kits.json registries in a kit repository
+ * against their canonical JSON schemas.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { Ajv2020 } from "ajv/dist/2020.js";
+import addFormats from "ajv-formats";
+import draft7MetaSchema from "ajv/dist/refs/json-schema-draft-07.json" with { type: "json" };
+import pc from "picocolors";
+import { formatValidationSourceError, resolveValidationSource } from "./source.js";
+import { summarizeResults, printValidationResults, } from "./utils.js";
+async function pathExists(filePath) {
+    try {
+        const stat = await fs.stat(filePath);
+        return stat.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function findKitsRegistryFile(agentKitsPath) {
+    const registryPath = path.join(agentKitsPath, "kits.json");
+    return (await pathExists(registryPath)) ? registryPath : undefined;
+}
+async function findKitManifestFiles(agentKitsPath) {
+    const files = [];
+    const rootKitPath = path.join(agentKitsPath, "kit.json");
+    if (await pathExists(rootKitPath)) {
+        files.push(rootKitPath);
+    }
+    const kitsDir = path.join(agentKitsPath, "kits");
+    try {
+        const kitEntries = await fs.readdir(kitsDir, { withFileTypes: true });
+        for (const kitEntry of kitEntries) {
+            if (!kitEntry.isDirectory()) {
+                continue;
+            }
+            const kitPath = path.join(kitsDir, kitEntry.name, "kit.json");
+            if (await pathExists(kitPath)) {
+                files.push(kitPath);
+            }
+        }
+    }
+    catch {
+        // kits directory doesn't exist - ignore
+    }
+    return files;
+}
+function formatSchemaErrors(errors = []) {
+    return errors
+        .map((err) => {
+        const instancePath = err.instancePath ? `${err.instancePath} ` : "";
+        return `${instancePath}${err.message ?? "schema validation error"}`;
+    })
+        .join("; ");
+}
+export async function validateKitsRegistryFile(filePath, validateSchema) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const data = JSON.parse(content);
+        const valid = validateSchema(data);
+        if (!valid) {
+            const errorText = formatSchemaErrors((validateSchema.errors ?? []));
+            return {
+                file: filePath,
+                valid: false,
+                error: `Schema validation failed: ${errorText}`,
+            };
+        }
+        return { file: filePath, valid: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return { file: filePath, valid: false, error: errorMessage };
+    }
+}
+export async function validateKitManifestFile(filePath, validateSchema) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const data = JSON.parse(content);
+        const valid = validateSchema(data);
+        if (!valid) {
+            const errorText = formatSchemaErrors((validateSchema.errors ?? []));
+            return {
+                file: filePath,
+                valid: false,
+                error: `Schema validation failed: ${errorText}`,
+            };
+        }
+        return { file: filePath, valid: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return { file: filePath, valid: false, error: errorMessage };
+    }
+}
+export async function validateKits(agentKitsPath, options = {}) {
+    const schemaRoot = options.schemaRoot ??
+        path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../schemas");
+    const kitSchemaPath = path.join(schemaRoot, "kit.schema.json");
+    const kitsSchemaPath = path.join(schemaRoot, "kits.schema.json");
+    const kitSchemaContent = await fs.readFile(kitSchemaPath, "utf-8");
+    const kitsSchemaContent = await fs.readFile(kitsSchemaPath, "utf-8");
+    const kitSchema = JSON.parse(kitSchemaContent);
+    const kitsSchema = JSON.parse(kitsSchemaContent);
+    const ajv = new Ajv2020({ allErrors: true, strict: false, unicodeRegExp: false });
+    ajv.addMetaSchema(draft7MetaSchema);
+    ajv.addMetaSchema({
+        ...draft7MetaSchema,
+        $id: "https://json-schema.org/draft-07/schema#",
+    });
+    const applyFormats = addFormats;
+    applyFormats(ajv);
+    const validateKitSchema = ajv.compile(kitSchema);
+    const validateKitsSchema = ajv.compile(kitsSchema);
+    const results = [];
+    const kitsRegistry = await findKitsRegistryFile(agentKitsPath);
+    if (kitsRegistry) {
+        results.push(await validateKitsRegistryFile(kitsRegistry, validateKitsSchema));
+    }
+    const kitFiles = await findKitManifestFiles(agentKitsPath);
+    for (const file of kitFiles) {
+        results.push(await validateKitManifestFile(file, validateKitSchema));
+    }
+    return summarizeResults(results);
+}
+export async function main(args) {
+    let source = args[0];
+    if (!source) {
+        const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+        const fallbackPath = path.resolve(scriptDir, "../../test-kits");
+        try {
+            const stat = await fs.stat(fallbackPath);
+            if (stat.isDirectory()) {
+                source = fallbackPath;
+            }
+        }
+        catch {
+            source = undefined;
+        }
+    }
+    if (!source) {
+        console.error(pc.red("Error: no kit repository path provided"));
+        console.error(pc.dim("Usage: validate-kits <path-to-kits-repo | org/repo[@ref]>"));
+        return 1;
+    }
+    let fetchResult;
+    try {
+        fetchResult = await resolveValidationSource(source);
+    }
+    catch (error) {
+        const message = formatValidationSourceError(error);
+        console.error(pc.red(`Error: ${message}`));
+        console.error(pc.dim("Usage: validate-kits <path-to-kits-repo | org/repo[@ref]>"));
+        return 1;
+    }
+    const agentKitsPath = fetchResult.localPath;
+    console.log(pc.dim(`Validating kit manifests in: ${agentKitsPath}`));
+    try {
+        const summary = await validateKits(agentKitsPath);
+        printValidationResults("Kit Registry & Manifest Validation", summary, agentKitsPath);
+        if (summary.failed > 0) {
+            console.error(pc.red(`Validation failed: ${summary.failed} kit file(s) have invalid format`));
+            return 1;
+        }
+        if (summary.total === 0) {
+            console.log(pc.yellow("Warning: No kit manifests or registries found"));
+            return 0;
+        }
+        console.log(pc.green("All kit files are valid"));
+        return 0;
+    }
+    catch (error) {
+        console.error(pc.red(`Error during validation: ${error}`));
+        return 1;
+    }
+    finally {
+        await fetchResult.cleanup?.();
+    }
+}
+//# sourceMappingURL=validate-kits.js.map

package/dist/validation/validate-kits.js.map

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

package/dist/validation/validate-mcp.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP server primitive validation script.
+ *
+ * Validates all MCP config.json files in a kit repository against
+ * the canonical MCP server JSON schema.
+ */
+import { type ValidationSummary } from "./utils.js";
+export declare function validateMcp(agentKitsPath: string, options?: {
+    schemaRoot?: string;
+}): Promise<ValidationSummary>;
+export declare function main(args: string[]): Promise<number>;
+//# sourceMappingURL=validate-mcp.d.ts.map

package/dist/validation/validate-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-mcp.d.ts","sourceRoot":"","sources":["../../src/validation/validate-mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAwDpB,wBAAsB,WAAW,CAC/B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAqB5B;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkE1D"}

package/dist/validation/validate-mcp.js

@@ -0,0 +1,132 @@
+/**
+ * MCP server primitive validation script.
+ *
+ * Validates all MCP config.json files in a kit repository against
+ * the canonical MCP server JSON schema.
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+import { fileURLToPath } from "node:url";
+import { Ajv2020 } from "ajv/dist/2020.js";
+import addFormats from "ajv-formats";
+import pc from "picocolors";
+import { formatValidationSourceError, resolveValidationSource, } from "./source.js";
+import { findFilesByName, summarizeResults, printValidationResults, } from "./utils.js";
+async function findMcpConfigFiles(agentKitsPath) {
+    const files = [];
+    const sharedMcpDir = path.join(agentKitsPath, "primitives/mcp");
+    files.push(...(await findFilesByName(sharedMcpDir, "config.json")));
+    const kitsDir = path.join(agentKitsPath, "kits");
+    try {
+        const kitEntries = await fs.readdir(kitsDir, { withFileTypes: true });
+        for (const kitEntry of kitEntries) {
+            if (!kitEntry.isDirectory()) {
+                continue;
+            }
+            const kitMcpDir = path.join(kitsDir, kitEntry.name, "primitives/mcp");
+            files.push(...(await findFilesByName(kitMcpDir, "config.json")));
+        }
+    }
+    catch {
+        // kits directory doesn't exist - ignore
+    }
+    return files;
+}
+async function validateMcpFile(filePath, validateSchema) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const data = JSON.parse(content);
+        const valid = validateSchema(data);
+        if (!valid) {
+            const errors = (validateSchema.errors ?? []);
+            const errorText = errors
+                .map((err) => {
+                const instancePath = err.instancePath ? `${err.instancePath} ` : "";
+                return `${instancePath}${err.message ?? "schema validation error"}`;
+            })
+                .join("; ");
+            return {
+                file: filePath,
+                valid: false,
+                error: `Schema validation failed: ${errorText}`,
+            };
+        }
+        return { file: filePath, valid: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return { file: filePath, valid: false, error: errorMessage };
+    }
+}
+export async function validateMcp(agentKitsPath, options = {}) {
+    const schemaRoot = options.schemaRoot ??
+        path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../schemas");
+    const schemaPath = path.join(schemaRoot, "mcp-server.schema.json");
+    const schemaContent = await fs.readFile(schemaPath, "utf-8");
+    const schema = JSON.parse(schemaContent);
+    const ajv = new Ajv2020({ allErrors: true, strict: false });
+    const applyFormats = addFormats;
+    applyFormats(ajv);
+    const validateSchema = ajv.compile(schema);
+    const mcpFiles = await findMcpConfigFiles(agentKitsPath);
+    const results = [];
+    for (const file of mcpFiles) {
+        results.push(await validateMcpFile(file, validateSchema));
+    }
+    return summarizeResults(results);
+}
+export async function main(args) {
+    let source = args[0];
+    if (!source) {
+        const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+        const fallbackPath = path.resolve(scriptDir, "../../test-kits");
+        try {
+            const stat = await fs.stat(fallbackPath);
+            if (stat.isDirectory()) {
+                source = fallbackPath;
+            }
+        }
+        catch {
+            source = undefined;
+        }
+    }
+    if (!source) {
+        console.error(pc.red("Error: no kit repository path provided"));
+        console.error(pc.dim("Usage: validate-mcp <path-to-kits-repo | org/repo[@ref]>"));
+        return 1;
+    }
+    let fetchResult;
+    try {
+        fetchResult = await resolveValidationSource(source);
+    }
+    catch (error) {
+        const message = formatValidationSourceError(error);
+        console.error(pc.red(`Error: ${message}`));
+        console.error(pc.dim("Usage: validate-mcp <path-to-kits-repo | org/repo[@ref]>"));
+        return 1;
+    }
+    const agentKitsPath = fetchResult.localPath;
+    console.log(pc.dim(`Validating MCP configs in: ${agentKitsPath}`));
+    try {
+        const summary = await validateMcp(agentKitsPath);
+        printValidationResults("MCP Primitive Validation", summary, agentKitsPath);
+        if (summary.failed > 0) {
+            console.error(pc.red(`Validation failed: ${summary.failed} MCP config(s) have invalid format`));
+            return 1;
+        }
+        if (summary.total === 0) {
+            console.log(pc.yellow("Warning: No MCP config files found"));
+            return 0;
+        }
+        console.log(pc.green("All MCP config files are valid"));
+        return 0;
+    }
+    catch (error) {
+        console.error(pc.red(`Error during validation: ${error}`));
+        return 1;
+    }
+    finally {
+        await fetchResult.cleanup?.();
+    }
+}
+//# sourceMappingURL=validate-mcp.js.map

package/dist/validation/validate-mcp.js.map

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

package/dist/validation/validate-skills.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Skill primitive validation script.
+ *
+ * Validates all SKILL.md files in a kit repository against
+ * the canonical format specification:
+ * - YAML frontmatter required
+ * - `name` field required and non-empty
+ * - `description` field required and non-empty
+ * - `allowedTools` optional but must be string or array of strings if present
+ * - `hooks` optional but must be an array of bindings if present
+ * - Body content required and non-empty
+ *
+ * Exits with code 0 on success, 1 on validation failure.
+ */
+import { type ValidationSummary } from "./utils.js";
+/**
+ * Validate all skill files in a kit repository.
+ */
+export declare function validateSkills(agentKitsPath: string): Promise<ValidationSummary>;
+/**
+ * Main entry point for CLI execution.
+ */
+export declare function main(args: string[]): Promise<number>;
+//# sourceMappingURL=validate-skills.d.ts.map

package/dist/validation/validate-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-skills.d.ts","sourceRoot":"","sources":["../../src/validation/validate-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAiKpB;;GAEG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAS5B;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkE1D"}

package/dist/validation/validate-skills.js

@@ -0,0 +1,223 @@
+/**
+ * Skill primitive validation script.
+ *
+ * Validates all SKILL.md files in a kit repository against
+ * the canonical format specification:
+ * - YAML frontmatter required
+ * - `name` field required and non-empty
+ * - `description` field required and non-empty
+ * - `allowedTools` optional but must be string or array of strings if present
+ * - `hooks` optional but must be an array of bindings if present
+ * - Body content required and non-empty
+ *
+ * Exits with code 0 on success, 1 on validation failure.
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+import { fileURLToPath } from "node:url";
+import pc from "picocolors";
+import { parseSkillFrontmatter } from "../adapters/skill-frontmatter.js";
+import { formatValidationSourceError, resolveValidationSource, } from "./source.js";
+import { findMarkdownFiles, summarizeResults, printValidationResults, } from "./utils.js";
+/**
+ * Find all skill files in a kit repository.
+ *
+ * Searches for:
+ * - Shared primitives: primitives/skills/{name}/v{version}/SKILL.md
+ * - Inline kit primitives: kits/{kit}/primitives/skills/{name}/SKILL.md
+ */
+async function findSkillFiles(agentKitsPath) {
+    const skillFiles = [];
+    const sharedSkillsDir = path.join(agentKitsPath, "primitives/skills");
+    skillFiles.push(...(await findMarkdownFiles(sharedSkillsDir, { fileName: "SKILL.md" })));
+    const kitsDir = path.join(agentKitsPath, "kits");
+    try {
+        const kitEntries = await fs.readdir(kitsDir, { withFileTypes: true });
+        for (const kitEntry of kitEntries) {
+            if (!kitEntry.isDirectory()) {
+                continue;
+            }
+            const kitSkillsDir = path.join(kitsDir, kitEntry.name, "primitives/skills");
+            skillFiles.push(...(await findMarkdownFiles(kitSkillsDir, { fileName: "SKILL.md" })));
+        }
+    }
+    catch {
+        // kits directory doesn't exist - ignore
+    }
+    return skillFiles;
+}
+/**
+ * Validate a single SKILL.md file.
+ */
+async function validateSkillFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const { frontmatter, body, hasFrontmatter } = parseSkillFrontmatter(content);
+        if (!hasFrontmatter) {
+            return {
+                file: filePath,
+                valid: false,
+                error: "skill missing YAML frontmatter; expected ---\\n...\\n--- at start of file",
+            };
+        }
+        const name = frontmatter["name"];
+        if (typeof name !== "string" || name.trim().length === 0) {
+            return {
+                file: filePath,
+                valid: false,
+                error: "skill missing required 'name' field in frontmatter",
+            };
+        }
+        const description = frontmatter["description"];
+        if (typeof description !== "string" || description.trim().length === 0) {
+            return {
+                file: filePath,
+                valid: false,
+                error: "skill missing required 'description' field in frontmatter",
+            };
+        }
+        if (Object.prototype.hasOwnProperty.call(frontmatter, "allowedTools")) {
+            const allowedTools = frontmatter["allowedTools"];
+            if (!(typeof allowedTools === "string" ||
+                (Array.isArray(allowedTools) &&
+                    allowedTools.every((entry) => typeof entry === "string")))) {
+                return {
+                    file: filePath,
+                    valid: false,
+                    error: "skill 'allowedTools' must be a string or array of strings when present",
+                };
+            }
+        }
+        if (Object.prototype.hasOwnProperty.call(frontmatter, "hooks")) {
+            const hooks = frontmatter["hooks"];
+            if (!Array.isArray(hooks)) {
+                return {
+                    file: filePath,
+                    valid: false,
+                    error: "skill 'hooks' must be an array when present",
+                };
+            }
+            for (const hookEntry of hooks) {
+                if (!hookEntry || typeof hookEntry !== "object") {
+                    return {
+                        file: filePath,
+                        valid: false,
+                        error: "skill 'hooks' entries must be objects",
+                    };
+                }
+                const ref = hookEntry["ref"];
+                if (typeof ref !== "string" || ref.trim().length === 0) {
+                    return {
+                        file: filePath,
+                        valid: false,
+                        error: "skill 'hooks' entries must include a non-empty 'ref' string",
+                    };
+                }
+                const binding = hookEntry["binding"];
+                if (!binding || typeof binding !== "object") {
+                    return {
+                        file: filePath,
+                        valid: false,
+                        error: "skill 'hooks' entries must include a 'binding' object",
+                    };
+                }
+                const event = binding["event"];
+                if (typeof event !== "string" || event.trim().length === 0) {
+                    return {
+                        file: filePath,
+                        valid: false,
+                        error: "skill hook binding requires an 'event' string",
+                    };
+                }
+                if (!["tool.before", "tool.after", "subagent.stop"].includes(event)) {
+                    return {
+                        file: filePath,
+                        valid: false,
+                        error: "skill hook binding event must be one of: tool.before, tool.after, subagent.stop",
+                    };
+                }
+            }
+        }
+        if (body.trim().length === 0) {
+            return {
+                file: filePath,
+                valid: false,
+                error: "skill body cannot be empty; content after frontmatter is required",
+            };
+        }
+        return { file: filePath, valid: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return { file: filePath, valid: false, error: errorMessage };
+    }
+}
+/**
+ * Validate all skill files in a kit repository.
+ */
+export async function validateSkills(agentKitsPath) {
+    const skillFiles = await findSkillFiles(agentKitsPath);
+    const results = [];
+    for (const file of skillFiles) {
+        results.push(await validateSkillFile(file));
+    }
+    return summarizeResults(results);
+}
+/**
+ * Main entry point for CLI execution.
+ */
+export async function main(args) {
+    let source = args[0];
+    if (!source) {
+        const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+        const fallbackPath = path.resolve(scriptDir, "../../test-kits");
+        try {
+            const stat = await fs.stat(fallbackPath);
+            if (stat.isDirectory()) {
+                source = fallbackPath;
+            }
+        }
+        catch {
+            source = undefined;
+        }
+    }
+    if (!source) {
+        console.error(pc.red("Error: no kit repository path provided"));
+        console.error(pc.dim("Usage: validate-skills <path-to-kits-repo | org/repo[@ref]>"));
+        return 1;
+    }
+    let fetchResult;
+    try {
+        fetchResult = await resolveValidationSource(source);
+    }
+    catch (error) {
+        const message = formatValidationSourceError(error);
+        console.error(pc.red(`Error: ${message}`));
+        console.error(pc.dim("Usage: validate-skills <path-to-kits-repo | org/repo[@ref]>"));
+        return 1;
+    }
+    const agentKitsPath = fetchResult.localPath;
+    console.log(pc.dim(`Validating skills in: ${agentKitsPath}`));
+    try {
+        const summary = await validateSkills(agentKitsPath);
+        printValidationResults("Skill Primitive Validation", summary, agentKitsPath);
+        if (summary.failed > 0) {
+            console.error(pc.red(`Validation failed: ${summary.failed} skill(s) have invalid format`));
+            return 1;
+        }
+        if (summary.total === 0) {
+            console.log(pc.yellow("Warning: No skill files found"));
+            return 0;
+        }
+        console.log(pc.green("All skill files are valid"));
+        return 0;
+    }
+    catch (error) {
+        console.error(pc.red(`Error during validation: ${error}`));
+        return 1;
+    }
+    finally {
+        await fetchResult.cleanup?.();
+    }
+}
+//# sourceMappingURL=validate-skills.js.map

package/dist/validation/validate-skills.js.map

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

package/dist/validation/validate-subagents.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Subagent primitive validation script.
+ *
+ * Validates all subagent Markdown files in a kit repository against
+ * the canonical format specification:
+ * - YAML frontmatter required
+ * - `name` field required and non-empty
+ * - `description` field required and non-empty
+ * - `allowedTools`/`disallowedTools` optional but must be string or array of strings if present
+ * - `skills` optional but must be array of strings if present
+ * - `hooks` optional but must be an array of bindings if present
+ * - hook binding `event` limited to tool.before, tool.after, subagent.stop
+ * - Body content required and non-empty
+ * - Body must include <agent_role> tags
+ *
+ * Exits with code 0 on success, 1 on validation failure.
+ */
+import { type ValidationSummary } from "./utils.js";
+/**
+ * Validate all subagent files in a kit repository.
+ */
+export declare function validateSubagents(agentKitsPath: string): Promise<ValidationSummary>;
+/**
+ * Main entry point for CLI execution.
+ */
+export declare function main(args: string[]): Promise<number>;
+//# sourceMappingURL=validate-subagents.d.ts.map

package/dist/validation/validate-subagents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-subagents.d.ts","sourceRoot":"","sources":["../../src/validation/validate-subagents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAoNpB;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAS5B;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4D1D"}