imhcode 1.0.0

package/dist/orchestrator/loader.js

@@ -0,0 +1,203 @@
+"use strict";
+/**
+ * File loading utilities for the orchestrator.
+ * Handles YAML parsing, Markdown reading, path resolution, and memory loading.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadYaml = loadYaml;
+exports.loadMarkdown = loadMarkdown;
+exports.resolveAgentPath = resolveAgentPath;
+exports.loadMemoryFiles = loadMemoryFiles;
+exports.loadAgent = loadAgent;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const glob_1 = require("glob");
+const schema_1 = require("./schema");
+// ─── YAML Loading ─────────────────────────────────────────────────────────────
+/**
+ * Load and parse a YAML file. Throws with the file path in the error message.
+ */
+function loadYaml(filePath) {
+    if (!fs_1.default.existsSync(filePath)) {
+        throw new Error(`❌ File not found: ${filePath}\n` +
+            `  Make sure agent.yml exists in the agent directory.`);
+    }
+    const raw = fs_1.default.readFileSync(filePath, "utf-8");
+    try {
+        return js_yaml_1.default.load(raw);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`❌ Failed to parse YAML at "${filePath}":\n  ${msg}\n` +
+            `  Check for indentation errors or invalid characters.`);
+    }
+}
+// ─── Markdown Loading ─────────────────────────────────────────────────────────
+/**
+ * Read a Markdown file. Throws with a clear message if missing.
+ */
+function loadMarkdown(filePath, label) {
+    if (!fs_1.default.existsSync(filePath)) {
+        throw new Error(`❌ Markdown file not found: ${filePath}\n` +
+            `  Expected "${label}" at the path above. Create the file and retry.`);
+    }
+    return fs_1.default.readFileSync(filePath, "utf-8");
+}
+// ─── Path Resolution ──────────────────────────────────────────────────────────
+/**
+ * Resolve a path declared in agent.yml (relative to the agent directory)
+ * to an absolute path.
+ */
+function resolveAgentPath(agentDir, relativePath) {
+    return path_1.default.resolve(agentDir, relativePath);
+}
+/**
+ * Extract a skill ID from a SKILL.md path.
+ * e.g. "../../skills/premium-ui/SKILL.md" → "premium-ui"
+ */
+function extractSkillId(skillPath) {
+    const parts = skillPath.replace(/\\/g, "/").split("/");
+    // The skill ID is the folder name that contains SKILL.md
+    const skillMdIndex = parts.findIndex((p) => p === "SKILL.md");
+    if (skillMdIndex > 0) {
+        return parts[skillMdIndex - 1];
+    }
+    // Fallback: use the parent directory name
+    return path_1.default.basename(path_1.default.dirname(skillPath));
+}
+const BINARY_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.ico', '.pdf', '.zip', '.tar', '.gz',
+    '.mp4', '.mov', '.avi', '.mp3', '.wav', '.woff', '.woff2', '.ttf', '.eot',
+    '.exe', '.dll', '.so', '.dylib', '.map', '.db', '.sqlite', '.sqlite3', '.wasm',
+    '.xlsx', '.xls', '.docx', '.doc', '.pptx', '.ppt', '.ds_store'
+]);
+const EXCLUDED_DIR_SEGMENTS = [
+    '/node_modules/',
+    '/.next/',
+    '/.nuxt/',
+    '/dist/',
+    '/build/',
+    '/.git/'
+];
+const EXCLUDED_FILENAME_EXACT = new Set([
+    'package-lock.json',
+    'yarn.lock',
+    'pnpm-lock.yaml',
+    'skills-lock.json',
+    '.ds_store'
+]);
+const MAX_FILE_SIZE_BYTES = 1024 * 1024; // 1MB
+/**
+ * Load all readable memory files declared in the agent manifest.
+ * Glob patterns are expanded relative to `cwd`.
+ * Missing files are silently skipped (non-blocking).
+ */
+async function loadMemoryFiles(manifest, cwd) {
+    const results = [];
+    for (const pattern of manifest.memory.readable) {
+        let matchedPaths;
+        try {
+            matchedPaths = await (0, glob_1.glob)(pattern, {
+                cwd,
+                absolute: true,
+                nodir: true,
+                dot: true,
+                ignore: [
+                    "**/node_modules/**",
+                    "**/.next/**",
+                    "**/.nuxt/**",
+                    "**/dist/**",
+                    "**/build/**",
+                    "**/.git/**",
+                    "**/package-lock.json",
+                    "**/yarn.lock",
+                    "**/pnpm-lock.yaml",
+                    "**/skills-lock.json",
+                    "**/.DS_Store"
+                ]
+            });
+        }
+        catch {
+            // Invalid glob pattern — skip with a warning
+            console.warn(`  ⚠️  Skipping unresolvable memory glob: "${pattern}"`);
+            continue;
+        }
+        for (const filePath of matchedPaths) {
+            if (!fs_1.default.existsSync(filePath))
+                continue;
+            // 1. Check directory exclusions (defense in depth)
+            const normalizedPath = filePath.replace(/\\/g, "/");
+            const isExcludedDir = EXCLUDED_DIR_SEGMENTS.some(segment => normalizedPath.includes(segment));
+            if (isExcludedDir)
+                continue;
+            // 2. Check filename exclusions
+            const basename = path_1.default.basename(filePath).toLowerCase();
+            if (EXCLUDED_FILENAME_EXACT.has(basename))
+                continue;
+            // 3. Check binary file extensions
+            const ext = path_1.default.extname(filePath).toLowerCase();
+            if (BINARY_EXTENSIONS.has(ext))
+                continue;
+            try {
+                // 4. Check file size to avoid heap memory issues
+                const stats = fs_1.default.statSync(filePath);
+                if (stats.size > MAX_FILE_SIZE_BYTES) {
+                    console.warn(`  ⚠️  Skipping large memory file (${(stats.size / 1024).toFixed(0)} KB): "${filePath}"`);
+                    continue;
+                }
+                const content = fs_1.default.readFileSync(filePath, "utf-8");
+                results.push({ path: filePath, content });
+            }
+            catch {
+                // File exists but can't be read — skip silently
+            }
+        }
+    }
+    return results;
+}
+// ─── Agent Loader ─────────────────────────────────────────────────────────────
+/**
+ * Fully load a single agent from its directory:
+ * 1. Parse and validate agent.yml
+ * 2. Load SYSTEM.md
+ * 3. Load all referenced SKILL.md files
+ * 4. Load project memory files
+ */
+async function loadAgent(agentDir, cwd) {
+    const agentId = path_1.default.basename(agentDir);
+    const manifestPath = path_1.default.join(agentDir, "agent.yml");
+    // 1. Parse and validate agent.yml
+    const rawYaml = loadYaml(manifestPath);
+    const manifest = (0, schema_1.validateManifest)(rawYaml, agentId);
+    // 2. Load SYSTEM.md
+    const systemPromptPath = resolveAgentPath(agentDir, manifest.system_prompt);
+    const systemPrompt = loadMarkdown(systemPromptPath, "system_prompt (SYSTEM.md)");
+    // 3. Load skill files
+    const skills = [];
+    for (const skillRelPath of manifest.skills) {
+        const skillAbsPath = resolveAgentPath(agentDir, skillRelPath);
+        if (!fs_1.default.existsSync(skillAbsPath)) {
+            throw new Error(`❌ Skill file not found for agent "${agentId}":\n` +
+                `  Path: ${skillAbsPath}\n` +
+                `  Declared in agent.yml: "${skillRelPath}"\n` +
+                `  Create the SKILL.md file or fix the path in agent.yml.`);
+        }
+        const content = fs_1.default.readFileSync(skillAbsPath, "utf-8");
+        const skillId = extractSkillId(skillRelPath);
+        skills.push({ id: skillId, path: skillAbsPath, content });
+    }
+    // 4. Load memory files
+    const memoryFiles = await loadMemoryFiles(manifest, cwd);
+    return {
+        dir: agentDir,
+        manifest,
+        systemPrompt,
+        skills,
+        memoryFiles,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/orchestrator/loader.js.map

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

package/dist/orchestrator/registry.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Agent registry: discovers and loads all agents from the agents/ directory.
+ * IMH-Code — Imam Hussain Coding Harness Platform
+ * Agents are discovered by scanning for agents/{id}/agent.yml files.
+ */
+import type { LoadedAgent } from "./types";
+export interface RegistryLoadResult {
+    agents: Map<string, LoadedAgent>;
+    errors: Array<{
+        agentId: string;
+        error: string;
+    }>;
+}
+/**
+ * Scan the agents directory and return absolute paths to all agent.yml files.
+ * Pattern: <agentsDir>/{agent-id}/agent.yml
+ */
+export declare function discoverAgents(agentsDir: string): Promise<string[]>;
+/**
+ * Load and validate all agents from the agents directory.
+ * Individual load failures are collected as errors (not thrown) so that
+ * a single bad agent doesn't break listing/inspecting the rest.
+ */
+export declare function loadRegistry(agentsDir: string, cwd: string): Promise<RegistryLoadResult>;
+/**
+ * Resolves a given agent ID or short alias to the canonical agent ID.
+ *
+ * IMH-Code Generic Agent Aliases:
+ *
+ * Core Agents:
+ *   planner, plan, pm        → planner
+ *   designer, design, ui, ux → designer
+ *
+ * Frontend Executors:
+ *   nextjs, next             → nextjs-executor
+ *   react, vite              → react-executor
+ *   vue, nuxt, vue3          → vue-executor
+ *
+ * Backend Executors:
+ *   laravel, php             → laravel-executor
+ *   python, django, fastapi  → python-executor
+ *   java, spring             → java-executor
+ *   flutter, dart            → flutter-executor
+ *   rn, expo, react-native   → react-native-executor
+ *   ios, swift, swiftui      → ios-executor
+ *   android, kotlin          → android-executor
+ *   go, rust, cpp            → systems-executor
+ *   web3, solidity           → web3-executor
+ *   devops, docker           → devops-executor
+ *
+ * Quality Agents:
+ *   tester, qa, test         → tester
+ *   security, audit          → security-auditor
+ *   seo, content             → seo-optimizer
+ *   debugger, debug, fix     → debugger
+ */
+export declare function resolveAgentIdAlias(agentId: string): string;
+/**
+ * Get a single agent by ID from a pre-loaded registry.
+ * Throws with a helpful message if not found.
+ */
+export declare function getAgent(registry: Map<string, LoadedAgent>, agentId: string): LoadedAgent;
+//# sourceMappingURL=registry.d.ts.map

package/dist/orchestrator/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/orchestrator/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAID;;;GAGG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBzE;AAID;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,kBAAkB,CAAC,CAmB7B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0E3D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAClC,OAAO,EAAE,MAAM,GACd,WAAW,CAcb"}

package/dist/orchestrator/registry.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * Agent registry: discovers and loads all agents from the agents/ directory.
+ * IMH-Code — Imam Hussain Coding Harness Platform
+ * Agents are discovered by scanning for agents/{id}/agent.yml files.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverAgents = discoverAgents;
+exports.loadRegistry = loadRegistry;
+exports.resolveAgentIdAlias = resolveAgentIdAlias;
+exports.getAgent = getAgent;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const glob_1 = require("glob");
+const loader_1 = require("./loader");
+// ─── Discovery ────────────────────────────────────────────────────────────────
+/**
+ * Scan the agents directory and return absolute paths to all agent.yml files.
+ * Pattern: <agentsDir>/{agent-id}/agent.yml
+ */
+async function discoverAgents(agentsDir) {
+    if (!fs_1.default.existsSync(agentsDir)) {
+        throw new Error(`❌ Agents directory not found: ${agentsDir}\n` +
+            `  Create the directory and add at least one agent folder with agent.yml.`);
+    }
+    const manifestPaths = await (0, glob_1.glob)("*/agent.yml", {
+        cwd: agentsDir,
+        absolute: true,
+    });
+    if (manifestPaths.length === 0) {
+        console.warn(`  ⚠️  No agents found in "${agentsDir}".\n` +
+            `  Add a folder with agent.yml and SYSTEM.md to register an agent.`);
+    }
+    return manifestPaths.sort(); // deterministic order
+}
+// ─── Registry Loader ─────────────────────────────────────────────────────────
+/**
+ * Load and validate all agents from the agents directory.
+ * Individual load failures are collected as errors (not thrown) so that
+ * a single bad agent doesn't break listing/inspecting the rest.
+ */
+async function loadRegistry(agentsDir, cwd) {
+    const manifestPaths = await discoverAgents(agentsDir);
+    const agents = new Map();
+    const errors = [];
+    for (const manifestPath of manifestPaths) {
+        const agentDir = path_1.default.dirname(manifestPath);
+        const agentId = path_1.default.basename(agentDir);
+        try {
+            const loaded = await (0, loader_1.loadAgent)(agentDir, cwd);
+            agents.set(agentId, loaded);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            errors.push({ agentId, error: message });
+        }
+    }
+    return { agents, errors };
+}
+// ─── Lookup ───────────────────────────────────────────────────────────────────
+/**
+ * Resolves a given agent ID or short alias to the canonical agent ID.
+ *
+ * IMH-Code Generic Agent Aliases:
+ *
+ * Core Agents:
+ *   planner, plan, pm        → planner
+ *   designer, design, ui, ux → designer
+ *
+ * Frontend Executors:
+ *   nextjs, next             → nextjs-executor
+ *   react, vite              → react-executor
+ *   vue, nuxt, vue3          → vue-executor
+ *
+ * Backend Executors:
+ *   laravel, php             → laravel-executor
+ *   python, django, fastapi  → python-executor
+ *   java, spring             → java-executor
+ *   flutter, dart            → flutter-executor
+ *   rn, expo, react-native   → react-native-executor
+ *   ios, swift, swiftui      → ios-executor
+ *   android, kotlin          → android-executor
+ *   go, rust, cpp            → systems-executor
+ *   web3, solidity           → web3-executor
+ *   devops, docker           → devops-executor
+ *
+ * Quality Agents:
+ *   tester, qa, test         → tester
+ *   security, audit          → security-auditor
+ *   seo, content             → seo-optimizer
+ *   debugger, debug, fix     → debugger
+ */
+function resolveAgentIdAlias(agentId) {
+    const clean = agentId.toLowerCase().trim();
+    const aliases = {
+        // ── Core ─────────────────────────────────────────────────────────────────
+        "plan": "planner",
+        "orchestrator": "planner",
+        "pm": "planner",
+        "design": "designer",
+        "ui": "designer",
+        "ux": "designer",
+        // ── Frontend Executors ────────────────────────────────────────────────────
+        "nextjs": "nextjs-executor",
+        "next": "nextjs-executor",
+        "next-js": "nextjs-executor",
+        "react": "react-executor",
+        "vite": "react-executor",
+        "react-vite": "react-executor",
+        "vue": "vue-executor",
+        "nuxt": "vue-executor",
+        "vue3": "vue-executor",
+        // ── Backend Executors ─────────────────────────────────────────────────────
+        "laravel": "laravel-executor",
+        "php": "laravel-executor",
+        "python": "python-executor",
+        "django": "python-executor",
+        "fastapi": "python-executor",
+        "flask": "python-executor",
+        "java": "java-executor",
+        "spring": "java-executor",
+        "springboot": "java-executor",
+        "quarkus": "java-executor",
+        "flutter": "flutter-executor",
+        "dart": "flutter-executor",
+        "rn": "react-native-executor",
+        "react-native": "react-native-executor",
+        "expo": "react-native-executor",
+        "ios": "ios-executor",
+        "swift": "ios-executor",
+        "swiftui": "ios-executor",
+        "android": "android-executor",
+        "kotlin": "android-executor",
+        "go": "systems-executor",
+        "golang": "systems-executor",
+        "rust": "systems-executor",
+        "cpp": "systems-executor",
+        "c++": "systems-executor",
+        "systems": "systems-executor",
+        "web3": "web3-executor",
+        "solidity": "web3-executor",
+        "blockchain": "web3-executor",
+        "devops": "devops-executor",
+        "docker": "devops-executor",
+        "cicd": "devops-executor",
+        "deploy": "devops-executor",
+        // ── Quality Agents ────────────────────────────────────────────────────────
+        "qa": "tester",
+        "test": "tester",
+        "testing": "tester",
+        "security": "security-auditor",
+        "audit": "security-auditor",
+        "pentest": "security-auditor",
+        "seo": "seo-optimizer",
+        "content": "seo-optimizer",
+        "marketing": "seo-optimizer",
+        "debug": "debugger",
+        "debugging": "debugger",
+        "fix": "debugger",
+    };
+    return aliases[clean] || clean;
+}
+/**
+ * Get a single agent by ID from a pre-loaded registry.
+ * Throws with a helpful message if not found.
+ */
+function getAgent(registry, agentId) {
+    const resolvedId = resolveAgentIdAlias(agentId);
+    const agent = registry.get(resolvedId);
+    if (!agent) {
+        const available = [...registry.keys()].join(", ") || "(none)";
+        throw new Error(`❌ Agent "${agentId}" not found (resolved: "${resolvedId}").\n` +
+            `  Available agents: ${available}\n\n` +
+            `  Run "imhcode agent list" to see all agents.`);
+    }
+    return agent;
+}
+//# sourceMappingURL=registry.js.map

package/dist/orchestrator/registry.js.map

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

package/dist/orchestrator/schema.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Zod schema for agent.yml manifest validation.
+ * IMH-Code — Imam Hussain Coding Harness Platform
+ * Every agent must pass this schema or an actionable error is thrown.
+ */
+import { z } from "zod";
+export declare const AgentManifestSchema: z.ZodObject<{
+    /** Kebab-case unique identifier. Must match the folder name. */
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodDefault<z.ZodString>;
+    role: z.ZodString;
+    /** Path to the SYSTEM.md file, relative to the agent directory */
+    system_prompt: z.ZodEffects<z.ZodDefault<z.ZodString>, string, string | undefined>;
+    /** Paths to SKILL.md files, relative to the agent directory */
+    skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    preferred_engines: z.ZodArray<z.ZodString, "many">;
+    fallback_engines: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    default_model: z.ZodString;
+    permissions: z.ZodDefault<z.ZodObject<{
+        read_files: z.ZodDefault<z.ZodBoolean>;
+        write_files: z.ZodDefault<z.ZodBoolean>;
+        run_commands: z.ZodDefault<z.ZodBoolean>;
+        network_access: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        read_files: boolean;
+        write_files: boolean;
+        run_commands: boolean;
+        network_access: boolean;
+    }, {
+        read_files?: boolean | undefined;
+        write_files?: boolean | undefined;
+        run_commands?: boolean | undefined;
+        network_access?: boolean | undefined;
+    }>>;
+    memory: z.ZodDefault<z.ZodObject<{
+        scopes: z.ZodArray<z.ZodEnum<["imhdb", "project", "global", "session"]>, "many">;
+        readable: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        writable: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        scopes: ("imhdb" | "project" | "global" | "session")[];
+        readable: string[];
+        writable: string[];
+    }, {
+        scopes: ("imhdb" | "project" | "global" | "session")[];
+        readable?: string[] | undefined;
+        writable?: string[] | undefined;
+    }>>;
+    supported_task_types: z.ZodArray<z.ZodString, "many">;
+    /** Array of single-key objects like [{ lighthouse_score: ">= 90" }] */
+    quality_gates: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>>, "many">>;
+    output: z.ZodDefault<z.ZodObject<{
+        format: z.ZodDefault<z.ZodString>;
+        include_tests: z.ZodDefault<z.ZodBoolean>;
+        test_framework: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        format: string;
+        include_tests: boolean;
+        test_framework?: string | undefined;
+    }, {
+        format?: string | undefined;
+        include_tests?: boolean | undefined;
+        test_framework?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    skills: string[];
+    permissions: {
+        read_files: boolean;
+        write_files: boolean;
+        run_commands: boolean;
+        network_access: boolean;
+    };
+    memory: {
+        scopes: ("imhdb" | "project" | "global" | "session")[];
+        readable: string[];
+        writable: string[];
+    };
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    role: string;
+    system_prompt: string;
+    preferred_engines: string[];
+    fallback_engines: string[];
+    default_model: string;
+    supported_task_types: string[];
+    quality_gates: Record<string, string | number>[];
+    output: {
+        format: string;
+        include_tests: boolean;
+        test_framework?: string | undefined;
+    };
+}, {
+    id: string;
+    name: string;
+    description: string;
+    role: string;
+    preferred_engines: string[];
+    default_model: string;
+    supported_task_types: string[];
+    skills?: string[] | undefined;
+    permissions?: {
+        read_files?: boolean | undefined;
+        write_files?: boolean | undefined;
+        run_commands?: boolean | undefined;
+        network_access?: boolean | undefined;
+    } | undefined;
+    memory?: {
+        scopes: ("imhdb" | "project" | "global" | "session")[];
+        readable?: string[] | undefined;
+        writable?: string[] | undefined;
+    } | undefined;
+    version?: string | undefined;
+    system_prompt?: string | undefined;
+    fallback_engines?: string[] | undefined;
+    quality_gates?: Record<string, string | number>[] | undefined;
+    output?: {
+        format?: string | undefined;
+        include_tests?: boolean | undefined;
+        test_framework?: string | undefined;
+    } | undefined;
+}>;
+export type AgentManifestInput = z.input<typeof AgentManifestSchema>;
+export type AgentManifestOutput = z.output<typeof AgentManifestSchema>;
+/**
+ * Validates a raw YAML-parsed object against the AgentManifest schema.
+ * Returns a well-typed manifest or throws a detailed ZodError.
+ */
+export declare function validateManifest(raw: unknown, agentId: string): AgentManifestOutput;
+//# sourceMappingURL=schema.d.ts.map

package/dist/orchestrator/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/orchestrator/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB,eAAO,MAAM,mBAAmB;IAC9B,gEAAgE;;;;;;IAuBhE,kEAAkE;;IASlE,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4B/D,uEAAuE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOvE,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACrE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEvE;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,MAAM,GACd,mBAAmB,CA2BrB"}