@agent-loom/loom 1.0.0

package/dist/skill-fetcher.js

@@ -0,0 +1,99 @@
+/**
+ * Skill Fetcher — Resolves registry skills to local content
+ *
+ * Downloads/fetches skill content from external registries (craft, skills.sh)
+ * and converts them to local skills that can be placed in the workspace.
+ */
+/**
+ * Create a mock fetcher backed by a static map (for testing and offline use).
+ */
+export function createMockFetcher(skills) {
+    return async (_registry, ref) => {
+        const content = skills[ref];
+        if (content === undefined) {
+            throw new Error(`Skill "${ref}" not found in mock registry.`);
+        }
+        return content;
+    };
+}
+/**
+ * Create a fetcher for craft skills.
+ *
+ * Tries to fetch SKILL.md from the craft-skills GitHub repo.
+ * Falls back to a stub SKILL.md if the fetch fails.
+ *
+ * Supports optional authentication via tokenFn for private repos.
+ */
+export function createCraftFetcher(options) {
+    const baseUrl = options?.baseUrl
+        ?? process.env.CRAFT_SKILLS_BASE_URL
+        ?? 'https://raw.githubusercontent.com/serverless-paas-balam/craft/main/skills-repo/skills';
+    const tokenFn = options?.tokenFn;
+    const fetchImpl = options?.fetchFn ?? globalThis.fetch;
+    return async (registry, ref) => {
+        if (registry !== 'craft') {
+            return createStubSkill(registry, ref);
+        }
+        const url = `${baseUrl}/${ref}/SKILL.md`;
+        const headers = {};
+        const token = tokenFn?.();
+        if (token) {
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        try {
+            const response = await fetchImpl(url, { headers });
+            if (!response.ok) {
+                console.warn(`  ⚠ Could not fetch skill "${ref}" from ${url} (${response.status}). Using stub.`);
+                return createStubSkill(registry, ref);
+            }
+            return await response.text();
+        }
+        catch {
+            console.warn(`  ⚠ Network error fetching skill "${ref}". Using stub.`);
+            return createStubSkill(registry, ref);
+        }
+    };
+}
+/**
+ * Create a stub SKILL.md when a skill cannot be fetched.
+ */
+function createStubSkill(registry, ref) {
+    return `---
+name: ${ref}
+description: "Skill from ${registry}:${ref} — content could not be fetched. Replace this with the actual skill content."
+---
+
+# ${ref}
+
+> This is a placeholder. The original skill content from \`${registry}:${ref}\` could not be fetched.
+> Replace this file with the actual SKILL.md content.
+`;
+}
+/**
+ * Resolve registry skills by fetching their content and converting
+ * them to local skills. If no fetcher is provided, registry skills
+ * are passed through unchanged.
+ *
+ * @param skills - Array of resolved skills (may include registry type)
+ * @param fetcher - Optional function to fetch skill content
+ * @returns Updated skills array with registry skills converted to local
+ */
+export async function resolveRegistrySkills(skills, fetcher) {
+    if (!fetcher)
+        return skills;
+    return Promise.all(skills.map(async (skill) => {
+        if (skill.type !== 'registry' || !skill.registry || !skill.ref) {
+            return skill;
+        }
+        const content = await fetcher(skill.registry, skill.ref);
+        return {
+            type: 'local',
+            name: skill.ref,
+            content,
+            sourcePath: `${skill.registry}:${skill.ref}`,
+            originalRegistry: skill.registry,
+            originalRef: skill.ref,
+        };
+    }));
+}
+//# sourceMappingURL=skill-fetcher.js.map

package/dist/skill-fetcher.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,297 @@
+/**
+ * Loom — Type Definitions
+ *
+ * Core types for manifest.yaml schema, config, workspaces, and registry.
+ */
+/** Top-level manifest.yaml structure */
+export interface Manifest {
+    version: string;
+    template: TemplateMetadata;
+    extends?: string[];
+    targets: TargetType[];
+    contents: ManifestContents;
+    prerequisites?: ResourceRef[];
+}
+export type TargetType = 'copilot' | 'claude' | 'cursor';
+export interface TemplateMetadata {
+    id: string;
+    name: string;
+    description: string;
+    author: string;
+    tags: string[];
+    icon?: string;
+}
+export interface ManifestContents {
+    instructions?: InstructionEntry[];
+    skills?: SkillEntry[];
+    agents?: AgentEntry[];
+    mcp?: McpEntry[];
+    repos?: RepoEntry[];
+    prompts?: PromptEntry[];
+}
+/** References a file in the shared/ directory */
+export interface SharedRef {
+    $ref: string;
+}
+export declare function isSharedRef(entry: unknown): entry is SharedRef;
+/** References a local file within the template directory */
+export interface LocalFileRef {
+    file: string;
+}
+export declare function isLocalFileRef(entry: unknown): entry is LocalFileRef;
+/** References an external skill registry */
+export interface RegistrySkillRef {
+    registry: 'skills.sh' | 'craft';
+    ref: string;
+}
+export declare function isRegistrySkillRef(entry: unknown): entry is RegistrySkillRef;
+export type InstructionEntry = (SharedRef | LocalFileRef) & {
+    scope: string;
+};
+export type SkillEntry = RegistrySkillRef | (LocalFileRef & {
+    name?: string;
+});
+export type AgentEntry = LocalFileRef & {
+    model?: string;
+    tools?: string[];
+};
+export type McpEntry = SharedRef | McpInlineDef;
+export interface McpInlineDef {
+    id: string;
+    name?: string;
+    description?: string;
+    type: 'stdio' | 'http';
+    command?: string;
+    args?: string[];
+    url?: string;
+    authType?: string;
+    env?: Record<string, string>;
+}
+export declare function isMcpInlineDef(entry: unknown): entry is McpInlineDef;
+export type PromptEntry = SharedRef | PromptLocalRef;
+export interface PromptLocalRef {
+    file: string;
+    name?: string;
+    description?: string;
+    agent?: string;
+    model?: string;
+    tools?: string[];
+    shared?: boolean;
+    disableAutoInvoke?: boolean;
+}
+export type RepoEntry = SharedRef | RepoInlineDef;
+export interface RepoInlineDef {
+    id?: string;
+    name?: string;
+    url: string;
+    description?: string;
+    sparse?: boolean;
+    paths?: string[];
+    large?: boolean;
+    cloneStrategy?: 'prompt' | 'sparse' | 'partial' | 'skip';
+    note?: string;
+}
+export type ResourceRef = SharedRef | PrerequisiteInlineDef;
+export interface PrerequisiteInlineDef {
+    id: string;
+    name: string;
+    required: boolean;
+    description?: string;
+    check: PlatformCommands;
+    install: PlatformCommands;
+}
+export interface PlatformCommands {
+    windows?: string;
+    mac?: string;
+    linux?: string;
+}
+export interface ResolvedManifest {
+    version: string;
+    template: TemplateMetadata;
+    targets: TargetType[];
+    instructions: ResolvedInstruction[];
+    skills: ResolvedSkill[];
+    agents: ResolvedAgent[];
+    mcp: ResolvedMcp[];
+    repos: ResolvedRepo[];
+    prompts: ResolvedPrompt[];
+    prerequisites: ResolvedPrerequisite[];
+}
+export interface ResolvedInstruction {
+    scope: string;
+    content: string;
+    sourcePath: string;
+}
+export interface ResolvedSkill {
+    type: 'registry' | 'local';
+    registry?: string;
+    ref?: string;
+    name?: string;
+    content?: string;
+    sourcePath?: string;
+    /** Extra files alongside SKILL.md (e.g. references/) */
+    extraFiles?: SkillExtraFile[];
+    /** Original registry name (set when a registry skill is fetched and converted to local) */
+    originalRegistry?: string;
+    /** Original ref/ID (set when a registry skill is fetched and converted to local) */
+    originalRef?: string;
+}
+/** An extra file bundled with a local skill */
+export interface SkillExtraFile {
+    /** Path relative to the skill directory (e.g. "references/functions-icm-loops.md") */
+    relativePath: string;
+    /** File content (UTF-8 text) */
+    content: string;
+}
+export interface ResolvedAgent {
+    name: string;
+    description: string;
+    model?: string;
+    tools: string[];
+    content: string;
+    sourcePath: string;
+}
+export interface ResolvedMcp {
+    id: string;
+    name?: string;
+    description?: string;
+    type: 'stdio' | 'http';
+    command?: string;
+    args?: string[];
+    url?: string;
+    authType?: string;
+    env?: Record<string, string>;
+}
+export interface ResolvedPrompt {
+    name: string;
+    description?: string;
+    content: string;
+    sourcePath: string;
+    agent?: string;
+    model?: string;
+    tools?: string[];
+    shared?: boolean;
+    disableAutoInvoke?: boolean;
+}
+export interface ResolvedRepo {
+    id?: string;
+    name?: string;
+    url: string;
+    description?: string;
+    sparse?: boolean;
+    paths?: string[];
+    large?: boolean;
+    repoType?: 'github' | 'ado';
+    cloneStrategy?: 'prompt' | 'sparse' | 'partial' | 'skip';
+    note?: string;
+}
+export interface ResolvedPrerequisite {
+    id: string;
+    name: string;
+    required: boolean;
+    description?: string;
+    check: PlatformCommands;
+    install: PlatformCommands;
+}
+export interface LoomConfig {
+    registries: RegistryConfig[];
+    defaultTarget?: TargetType;
+}
+export interface RegistryConfig {
+    name: string;
+    url: string;
+    type?: 'github';
+}
+export interface WorkspacesFile {
+    workspaces: WorkspaceEntry[];
+}
+export interface WorkspaceEntry {
+    path: string;
+    template: string;
+    registry: string;
+    appliedAt: string;
+    lastOpenedAt?: string;
+    tags: string[];
+    notes: string;
+}
+export interface RegistryIndex {
+    version: string;
+    registry: {
+        name: string;
+        description: string;
+        url: string;
+    };
+    templates: RegistryTemplateEntry[];
+}
+export interface RegistryTemplateEntry {
+    id: string;
+    name: string;
+    description: string;
+    path: string;
+    tags: string[];
+    version: string;
+    /** Nested agent entries (for team-based templates) */
+    agents?: AgentRegistryEntry[];
+}
+/** Agent entry within a team template in index.yaml */
+export interface AgentRegistryEntry {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    path: string;
+}
+/** Per-agent manifest.yaml (lives in templates/<team>/agents/<id>/manifest.yaml) */
+export interface AgentManifest {
+    agent: AgentManifestMeta;
+    contents?: AgentManifestContents;
+    prerequisites?: ResourceRef[];
+}
+export interface AgentManifestMeta {
+    id: string;
+    name: string;
+    description: string;
+    model?: string;
+    tags?: string[];
+    tools?: string[];
+}
+/** Agent-specific content additions (merged with team manifest) */
+export interface AgentManifestContents {
+    instructions?: InstructionEntry[];
+    mcp?: McpEntry[];
+    repos?: RepoEntry[];
+    skills?: SkillEntry[];
+    prompts?: PromptEntry[];
+}
+export interface SharedMcpFile {
+    id: string;
+    name: string;
+    description?: string;
+    type: 'stdio' | 'http';
+    command?: string;
+    args?: string[];
+    url?: string;
+    authType?: string;
+    env?: Record<string, string>;
+}
+export interface SharedRepoFile {
+    id: string;
+    name: string;
+    description?: string;
+    url: string;
+    sparse?: boolean;
+    paths?: string[];
+    large?: boolean;
+    repoType?: 'github' | 'ado';
+    cloneStrategy?: 'prompt' | 'sparse' | 'skip';
+    note?: string;
+}
+export interface SharedPrerequisiteFile {
+    id: string;
+    name: string;
+    required: boolean;
+    description?: string;
+    check: PlatformCommands;
+    install: PlatformCommands;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,18 @@
+/**
+ * Loom — Type Definitions
+ *
+ * Core types for manifest.yaml schema, config, workspaces, and registry.
+ */
+export function isSharedRef(entry) {
+    return typeof entry === 'object' && entry !== null && '$ref' in entry;
+}
+export function isLocalFileRef(entry) {
+    return typeof entry === 'object' && entry !== null && 'file' in entry;
+}
+export function isRegistrySkillRef(entry) {
+    return typeof entry === 'object' && entry !== null && 'registry' in entry;
+}
+export function isMcpInlineDef(entry) {
+    return typeof entry === 'object' && entry !== null && 'id' in entry && 'type' in entry;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2CH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;AACxE,CAAC;AAOD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;AACxE,CAAC;AAQD,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,UAAU,IAAI,KAAK,CAAC;AAC5E,CAAC;AAmCD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC;AACzF,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Manifest validation — schema, reference, and registry checks.
+ */
+export interface ValidateResult {
+    templateId: string;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+    summary: {
+        instructions: number;
+        skills: number;
+        agents: number;
+        mcp: number;
+        repos: number;
+        prompts: number;
+        prerequisites: number;
+    };
+}
+export interface ValidationError {
+    level: 'schema' | 'reference' | 'registry';
+    field: string;
+    message: string;
+    path?: string;
+}
+export interface ValidationWarning {
+    field: string;
+    message: string;
+}
+/**
+ * Validate a single template directory.
+ */
+export declare function validateTemplate(templateDir: string, registryRoot: string): Promise<ValidateResult>;
+export interface RegistryIndex {
+    templates: Array<{
+        id: string;
+        path: string;
+    }>;
+}
+/**
+ * Validate all templates in a registry (reads index.yaml).
+ */
+export declare function validateRegistry(registryRoot: string): Promise<ValidateResult[]>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,CAAC,CA+GzB;AAMD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CAyC3B"}

package/dist/validate.js

@@ -0,0 +1,191 @@
+/**
+ * Manifest validation — schema, reference, and registry checks.
+ */
+import { readFile, stat } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import yaml from 'js-yaml';
+import { isSharedRef, isLocalFileRef } from './types.js';
+// =============================================================================
+// Validate Template
+// =============================================================================
+/**
+ * Validate a single template directory.
+ */
+export async function validateTemplate(templateDir, registryRoot) {
+    const manifestPath = join(templateDir, 'manifest.yaml');
+    const errors = [];
+    const warnings = [];
+    // --- Level 1: Schema validation ---
+    let manifest = null;
+    try {
+        const content = await readFile(manifestPath, 'utf-8');
+        const raw = yaml.load(content);
+        if (!raw || typeof raw !== 'object') {
+            errors.push({ level: 'schema', field: 'manifest', message: 'manifest.yaml is not a valid YAML object' });
+            return buildResult('unknown', errors, warnings);
+        }
+        manifest = raw;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            errors.push({ level: 'schema', field: 'manifest', message: 'manifest.yaml not found' });
+        }
+        else {
+            errors.push({ level: 'schema', field: 'manifest', message: `Failed to parse manifest.yaml: ${err.message}` });
+        }
+        return buildResult('unknown', errors, warnings);
+    }
+    // Required fields
+    if (!manifest.version) {
+        errors.push({ level: 'schema', field: 'version', message: 'Missing required field: version' });
+    }
+    else if (!/^\d+\.\d+\.\d+/.test(manifest.version)) {
+        errors.push({ level: 'schema', field: 'version', message: `Invalid semver: ${manifest.version}` });
+    }
+    if (!manifest.template?.id) {
+        errors.push({ level: 'schema', field: 'template.id', message: 'Missing required field: template.id' });
+    }
+    if (!manifest.template?.name) {
+        errors.push({ level: 'schema', field: 'template.name', message: 'Missing required field: template.name' });
+    }
+    if (!manifest.targets || !Array.isArray(manifest.targets) || manifest.targets.length === 0) {
+        errors.push({ level: 'schema', field: 'targets', message: 'Missing or empty required field: targets' });
+    }
+    else {
+        const validTargets = ['copilot', 'claude', 'cursor'];
+        for (const t of manifest.targets) {
+            if (!validTargets.includes(t)) {
+                errors.push({ level: 'schema', field: 'targets', message: `Invalid target: ${t}` });
+            }
+        }
+    }
+    const templateId = manifest.template?.id ?? 'unknown';
+    // --- Level 2: Reference validation ---
+    const contents = manifest.contents ?? {};
+    const instructions = contents.instructions ?? [];
+    const skills = contents.skills ?? [];
+    const agents = contents.agents ?? [];
+    const mcp = contents.mcp ?? [];
+    const repos = contents.repos ?? [];
+    const prompts = contents.prompts ?? [];
+    const prerequisites = manifest.prerequisites ?? [];
+    // Check $ref and file references
+    for (const entry of instructions) {
+        if (isSharedRef(entry)) {
+            await checkFileExists(resolve(registryRoot, entry.$ref), entry.$ref, 'instructions', errors);
+        }
+        else if (isLocalFileRef(entry)) {
+            await checkFileExists(resolve(templateDir, entry.file), entry.file, 'instructions', errors);
+        }
+    }
+    for (const entry of agents) {
+        if (isLocalFileRef(entry)) {
+            await checkFileExists(resolve(templateDir, entry.file), entry.file, 'agents', errors);
+        }
+    }
+    for (const entry of mcp) {
+        if (isSharedRef(entry)) {
+            await checkFileExists(resolve(registryRoot, entry.$ref), entry.$ref, 'mcp', errors);
+        }
+    }
+    for (const entry of repos) {
+        if (isSharedRef(entry)) {
+            await checkFileExists(resolve(registryRoot, entry.$ref), entry.$ref, 'repos', errors);
+        }
+    }
+    for (const entry of prompts) {
+        if (isSharedRef(entry)) {
+            await checkFileExists(resolve(registryRoot, entry.$ref), entry.$ref, 'prompts', errors);
+        }
+        else if (isLocalFileRef(entry)) {
+            await checkFileExists(resolve(templateDir, entry.file), entry.file, 'prompts', errors);
+        }
+    }
+    for (const entry of prerequisites) {
+        if (isSharedRef(entry)) {
+            await checkFileExists(resolve(registryRoot, entry.$ref), entry.$ref, 'prerequisites', errors);
+        }
+    }
+    return buildResult(templateId, errors, warnings, {
+        instructions: instructions.length,
+        skills: skills.length,
+        agents: agents.length,
+        mcp: mcp.length,
+        repos: repos.length,
+        prompts: prompts.length,
+        prerequisites: prerequisites.length,
+    });
+}
+/**
+ * Validate all templates in a registry (reads index.yaml).
+ */
+export async function validateRegistry(registryRoot) {
+    const indexPath = join(registryRoot, 'index.yaml');
+    const content = await readFile(indexPath, 'utf-8');
+    const index = yaml.load(content);
+    if (!index?.templates || !Array.isArray(index.templates)) {
+        return [{
+                templateId: '__registry__',
+                errors: [{ level: 'registry', field: 'index.yaml', message: 'index.yaml has no templates array' }],
+                warnings: [],
+                summary: { instructions: 0, skills: 0, agents: 0, mcp: 0, repos: 0, prompts: 0, prerequisites: 0 },
+            }];
+    }
+    // Check for duplicate IDs
+    const ids = index.templates.map((t) => t.id);
+    const duplicates = ids.filter((id, i) => ids.indexOf(id) !== i);
+    const results = [];
+    if (duplicates.length > 0) {
+        results.push({
+            templateId: '__registry__',
+            errors: duplicates.map((id) => ({
+                level: 'registry',
+                field: 'index.yaml',
+                message: `Duplicate template ID: ${id}`,
+            })),
+            warnings: [],
+            summary: { instructions: 0, skills: 0, agents: 0, mcp: 0, repos: 0, prompts: 0, prerequisites: 0 },
+        });
+    }
+    // Validate each template
+    for (const entry of index.templates) {
+        const templateDir = join(registryRoot, entry.path);
+        const result = await validateTemplate(templateDir, registryRoot);
+        results.push(result);
+    }
+    return results;
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+async function checkFileExists(absolutePath, refPath, field, errors) {
+    try {
+        await stat(absolutePath);
+    }
+    catch {
+        errors.push({
+            level: 'reference',
+            field,
+            message: `Missing reference: ${refPath}`,
+            path: refPath,
+        });
+    }
+}
+function buildResult(templateId, errors, warnings, summary) {
+    return {
+        templateId,
+        errors,
+        warnings,
+        summary: {
+            instructions: 0,
+            skills: 0,
+            agents: 0,
+            mcp: 0,
+            repos: 0,
+            prompts: 0,
+            prerequisites: 0,
+            ...summary,
+        },
+    };
+}
+//# sourceMappingURL=validate.js.map