beth-copilot 1.0.12 → 1.0.13

package/dist/core/agents/loader.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Agent Loader
+ *
+ * Parses .agent.md files from the agents directory into typed AgentDefinition objects.
+ * Uses gray-matter to extract YAML frontmatter and markdown body.
+ */
+import type { AgentDefinition, AgentLoadResult, AgentLoadError } from './types.js';
+/**
+ * Default agents directory relative to workspace root.
+ */
+export declare const DEFAULT_AGENTS_DIR = ".github/agents";
+/**
+ * File extension for agent definition files.
+ */
+export declare const AGENT_FILE_EXTENSION = ".agent.md";
+/**
+ * Load all agents from a directory.
+ *
+ * @param agentsDir - Path to agents directory (default: .github/agents)
+ * @returns Object containing loaded agents and any errors
+ */
+export declare function loadAgents(agentsDir?: string): AgentLoadResult;
+/**
+ * Load a single agent from a file.
+ *
+ * @param filePath - Path to the .agent.md file
+ * @returns Either an agent definition or an error
+ */
+export declare function loadAgent(filePath: string): {
+    agent: AgentDefinition;
+} | {
+    error: AgentLoadError;
+};
+/**
+ * Get an agent by ID from a load result.
+ *
+ * @param result - The result from loadAgents()
+ * @param id - Agent ID to find (e.g., 'developer', 'beth')
+ * @returns The agent definition or undefined if not found
+ */
+export declare function getAgentById(result: AgentLoadResult, id: string): AgentDefinition | undefined;
+/**
+ * Get agents that can be used as subagents (infer: true).
+ *
+ * @param result - The result from loadAgents()
+ * @returns Array of agents with infer: true
+ */
+export declare function getInferableAgents(result: AgentLoadResult): AgentDefinition[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/agents/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/agents/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,eAAe,EAGf,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,GAAE,MAA2B,GAAG,eAAe,CAoClF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,CAuCxD;AA6HD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,EACvB,EAAE,EAAE,MAAM,GACT,eAAe,GAAG,SAAS,CAE7B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,EAAE,CAE7E"}

package/dist/core/agents/loader.js

@@ -0,0 +1,217 @@
+/**
+ * Agent Loader
+ *
+ * Parses .agent.md files from the agents directory into typed AgentDefinition objects.
+ * Uses gray-matter to extract YAML frontmatter and markdown body.
+ */
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import matter from 'gray-matter';
+/**
+ * Default agents directory relative to workspace root.
+ */
+export const DEFAULT_AGENTS_DIR = '.github/agents';
+/**
+ * File extension for agent definition files.
+ */
+export const AGENT_FILE_EXTENSION = '.agent.md';
+/**
+ * Load all agents from a directory.
+ *
+ * @param agentsDir - Path to agents directory (default: .github/agents)
+ * @returns Object containing loaded agents and any errors
+ */
+export function loadAgents(agentsDir = DEFAULT_AGENTS_DIR) {
+    const agents = [];
+    const errors = [];
+    if (!existsSync(agentsDir)) {
+        errors.push({
+            filePath: agentsDir,
+            message: `Agents directory not found: ${agentsDir}`,
+        });
+        return { agents, errors };
+    }
+    const files = readdirSync(agentsDir).filter((f) => f.endsWith(AGENT_FILE_EXTENSION));
+    if (files.length === 0) {
+        errors.push({
+            filePath: agentsDir,
+            message: `No ${AGENT_FILE_EXTENSION} files found in ${agentsDir}`,
+        });
+        return { agents, errors };
+    }
+    for (const file of files) {
+        const filePath = join(agentsDir, file);
+        const result = loadAgent(filePath);
+        if ('error' in result) {
+            errors.push(result.error);
+        }
+        else {
+            agents.push(result.agent);
+        }
+    }
+    return { agents, errors };
+}
+/**
+ * Load a single agent from a file.
+ *
+ * @param filePath - Path to the .agent.md file
+ * @returns Either an agent definition or an error
+ */
+export function loadAgent(filePath) {
+    try {
+        let content = readFileSync(filePath, 'utf-8');
+        // Handle GitHub Copilot agent file format: ```chatagent\n---\n...\n---\n...\n```
+        // Strip the code fence wrapper if present
+        content = stripCodeFence(content);
+        const { data, content: body } = matter(content);
+        // Validate required fields
+        const validation = validateFrontmatter(data, filePath);
+        if (validation.error) {
+            return { error: validation.error };
+        }
+        // Extract agent ID from filename (e.g., 'developer.agent.md' -> 'developer')
+        const id = basename(filePath, AGENT_FILE_EXTENSION);
+        // Normalize frontmatter
+        const frontmatter = normalizeFrontmatter(data);
+        return {
+            agent: {
+                id,
+                frontmatter,
+                body: body.trim(),
+                sourcePath: filePath,
+            },
+        };
+    }
+    catch (err) {
+        return {
+            error: {
+                filePath,
+                message: `Failed to parse agent file: ${err instanceof Error ? err.message : String(err)}`,
+                cause: err instanceof Error ? err : undefined,
+            },
+        };
+    }
+}
+/**
+ * Strip GitHub Copilot code fence wrapper from agent/skill files.
+ *
+ * Files may be wrapped in ```chatagent or ```skill code fences.
+ * This extracts the content inside the fence.
+ */
+function stripCodeFence(content) {
+    // Match opening fence: ```chatagent, ```skill, ````chatagent, etc.
+    const fenceMatch = content.match(/^(`{3,})(chatagent|skill)\s*[\r\n]/);
+    if (!fenceMatch) {
+        return content;
+    }
+    const fenceLength = fenceMatch[1].length;
+    const closingFence = '`'.repeat(fenceLength);
+    // Find the closing fence
+    const closingIndex = content.lastIndexOf(closingFence);
+    if (closingIndex === -1 || closingIndex === 0) {
+        return content;
+    }
+    // Extract content between fences
+    const startIndex = fenceMatch[0].length;
+    return content.slice(startIndex, closingIndex).trim();
+}
+/**
+ * Validate that frontmatter has required fields.
+ */
+function validateFrontmatter(data, filePath) {
+    if (!data.name || typeof data.name !== 'string') {
+        return {
+            error: {
+                filePath,
+                message: `Missing or invalid 'name' in frontmatter`,
+            },
+        };
+    }
+    // Validate handoffs if present
+    if (data.handoffs && !Array.isArray(data.handoffs)) {
+        return {
+            error: {
+                filePath,
+                message: `'handoffs' must be an array`,
+            },
+        };
+    }
+    if (Array.isArray(data.handoffs)) {
+        for (let i = 0; i < data.handoffs.length; i++) {
+            const handoff = data.handoffs[i];
+            if (!handoff.label || !handoff.agent || !handoff.prompt) {
+                return {
+                    error: {
+                        filePath,
+                        message: `Handoff at index ${i} missing required fields (label, agent, prompt)`,
+                    },
+                };
+            }
+        }
+    }
+    // Validate tools if present
+    if (data.tools && !Array.isArray(data.tools)) {
+        return {
+            error: {
+                filePath,
+                message: `'tools' must be an array`,
+            },
+        };
+    }
+    return {};
+}
+/**
+ * Normalize frontmatter data to typed AgentFrontmatter.
+ */
+function normalizeFrontmatter(data) {
+    const frontmatter = {
+        name: data.name,
+    };
+    if (data.description) {
+        frontmatter.description = String(data.description);
+    }
+    if (data.model) {
+        frontmatter.model = String(data.model);
+    }
+    if (Array.isArray(data.tools)) {
+        frontmatter.tools = data.tools.map(String);
+    }
+    if (typeof data.infer === 'boolean') {
+        frontmatter.infer = data.infer;
+    }
+    if (Array.isArray(data.handoffs)) {
+        frontmatter.handoffs = data.handoffs.map(normalizeHandoff);
+    }
+    return frontmatter;
+}
+/**
+ * Normalize a single handoff definition.
+ */
+function normalizeHandoff(data) {
+    return {
+        label: String(data.label),
+        agent: String(data.agent),
+        prompt: String(data.prompt),
+        send: typeof data.send === 'boolean' ? data.send : undefined,
+    };
+}
+/**
+ * Get an agent by ID from a load result.
+ *
+ * @param result - The result from loadAgents()
+ * @param id - Agent ID to find (e.g., 'developer', 'beth')
+ * @returns The agent definition or undefined if not found
+ */
+export function getAgentById(result, id) {
+    return result.agents.find((agent) => agent.id.toLowerCase() === id.toLowerCase());
+}
+/**
+ * Get agents that can be used as subagents (infer: true).
+ *
+ * @param result - The result from loadAgents()
+ * @returns Array of agents with infer: true
+ */
+export function getInferableAgents(result) {
+    return result.agents.filter((agent) => agent.frontmatter.infer === true);
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/agents/loader.js.map

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

package/dist/core/agents/loader.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Agent Loader Tests
+ *
+ * Tests for parsing .agent.md files into typed AgentDefinition objects.
+ */
+export {};
+//# sourceMappingURL=loader.test.d.ts.map

package/dist/core/agents/loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.test.d.ts","sourceRoot":"","sources":["../../../src/core/agents/loader.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/core/agents/loader.test.js

@@ -0,0 +1,144 @@
+/**
+ * Agent Loader Tests
+ *
+ * Tests for parsing .agent.md files into typed AgentDefinition objects.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { join } from 'node:path';
+import { loadAgents, loadAgent, getAgentById, getInferableAgents, DEFAULT_AGENTS_DIR, AGENT_FILE_EXTENSION, } from './loader.js';
+// Test against templates directory
+const TEMPLATES_AGENTS_DIR = join(process.cwd(), 'templates', '.github', 'agents');
+describe('Agent Loader', () => {
+    describe('loadAgents', () => {
+        it('should load all agents from templates directory', () => {
+            const result = loadAgents(TEMPLATES_AGENTS_DIR);
+            assert.strictEqual(result.errors.length, 0, `Unexpected errors: ${JSON.stringify(result.errors)}`);
+            assert.ok(result.agents.length >= 6, `Expected at least 6 agents, got ${result.agents.length}`);
+            // Check expected agents exist
+            const agentIds = result.agents.map((a) => a.id);
+            assert.ok(agentIds.includes('beth'), 'Should include beth agent');
+            assert.ok(agentIds.includes('developer'), 'Should include developer agent');
+            assert.ok(agentIds.includes('product-manager'), 'Should include product-manager agent');
+        });
+        it('should return error for non-existent directory', () => {
+            const result = loadAgents('/non/existent/path');
+            assert.strictEqual(result.agents.length, 0);
+            assert.strictEqual(result.errors.length, 1);
+            assert.ok(result.errors[0].message.includes('not found'));
+        });
+    });
+    describe('loadAgent', () => {
+        it('should parse Beth agent correctly', () => {
+            const filePath = join(TEMPLATES_AGENTS_DIR, 'beth.agent.md');
+            const result = loadAgent(filePath);
+            assert.ok(!('error' in result), `Unexpected error: ${JSON.stringify(result)}`);
+            const { agent } = result;
+            assert.strictEqual(agent.id, 'beth');
+            assert.strictEqual(agent.frontmatter.name, 'Beth');
+            assert.ok(agent.frontmatter.description?.includes('orchestrator'));
+            assert.strictEqual(agent.frontmatter.model, 'Claude Opus 4.5');
+            assert.strictEqual(agent.frontmatter.infer, true);
+            assert.ok(Array.isArray(agent.frontmatter.tools));
+            assert.ok(Array.isArray(agent.frontmatter.handoffs));
+            assert.ok(agent.body.length > 100, 'Should have substantial body content');
+        });
+        it('should parse handoffs correctly', () => {
+            const filePath = join(TEMPLATES_AGENTS_DIR, 'beth.agent.md');
+            const result = loadAgent(filePath);
+            assert.ok(!('error' in result));
+            const { agent } = result;
+            const handoffs = agent.frontmatter.handoffs;
+            assert.ok(Array.isArray(handoffs));
+            assert.ok(handoffs.length >= 5, 'Beth should have at least 5 handoffs');
+            // Check structure of first handoff
+            const devHandoff = handoffs.find((h) => h.agent === 'developer');
+            assert.ok(devHandoff, 'Should have developer handoff');
+            assert.ok(devHandoff.label, 'Handoff should have label');
+            assert.ok(devHandoff.prompt, 'Handoff should have prompt');
+        });
+        it('should parse developer agent with tools', () => {
+            const filePath = join(TEMPLATES_AGENTS_DIR, 'developer.agent.md');
+            const result = loadAgent(filePath);
+            assert.ok(!('error' in result));
+            const { agent } = result;
+            assert.strictEqual(agent.id, 'developer');
+            assert.ok(Array.isArray(agent.frontmatter.tools));
+            assert.ok(agent.frontmatter.tools.length > 0, 'Developer should have tools');
+        });
+        it('should extract sourcePath correctly', () => {
+            const filePath = join(TEMPLATES_AGENTS_DIR, 'developer.agent.md');
+            const result = loadAgent(filePath);
+            assert.ok(!('error' in result));
+            const { agent } = result;
+            assert.strictEqual(agent.sourcePath, filePath);
+        });
+    });
+    describe('getAgentById', () => {
+        it('should find agent by ID (case-insensitive)', () => {
+            const result = loadAgents(TEMPLATES_AGENTS_DIR);
+            const beth = getAgentById(result, 'Beth');
+            assert.ok(beth, 'Should find Beth agent');
+            assert.strictEqual(beth?.frontmatter.name, 'Beth');
+            const bethLower = getAgentById(result, 'beth');
+            assert.strictEqual(beth?.id, bethLower?.id, 'Case should not matter');
+        });
+        it('should return undefined for non-existent agent', () => {
+            const result = loadAgents(TEMPLATES_AGENTS_DIR);
+            const notFound = getAgentById(result, 'non-existent-agent');
+            assert.strictEqual(notFound, undefined);
+        });
+    });
+    describe('getInferableAgents', () => {
+        it('should return only agents with infer: true', () => {
+            const result = loadAgents(TEMPLATES_AGENTS_DIR);
+            const inferable = getInferableAgents(result);
+            assert.ok(inferable.length > 0, 'Should have at least one inferable agent');
+            for (const agent of inferable) {
+                assert.strictEqual(agent.frontmatter.infer, true, `${agent.id} should have infer: true`);
+            }
+            // Beth should be inferable
+            const bethInferable = inferable.find((a) => a.id === 'beth');
+            assert.ok(bethInferable, 'Beth should be inferable');
+        });
+    });
+    describe('validation', () => {
+        it('should reject files without name in frontmatter', () => {
+            // This tests the validation logic - we can't easily test with actual files
+            // without creating temp files, so we verify the loader handles the case
+            const result = loadAgent('/non/existent/file.agent.md');
+            assert.ok('error' in result);
+            assert.ok(result.error.message.includes('Failed to parse'));
+        });
+    });
+    describe('constants', () => {
+        it('should export correct constants', () => {
+            assert.strictEqual(DEFAULT_AGENTS_DIR, '.github/agents');
+            assert.strictEqual(AGENT_FILE_EXTENSION, '.agent.md');
+        });
+    });
+});
+describe('Agent frontmatter structure compatibility', () => {
+    it('all loaded agents should have valid frontmatter structure', () => {
+        const result = loadAgents(TEMPLATES_AGENTS_DIR);
+        for (const agent of result.agents) {
+            // Required fields
+            assert.ok(agent.frontmatter.name, `${agent.id} should have name`);
+            // Optional fields should be correct type if present
+            if (agent.frontmatter.tools !== undefined) {
+                assert.ok(Array.isArray(agent.frontmatter.tools), `${agent.id} tools should be array`);
+            }
+            if (agent.frontmatter.handoffs !== undefined) {
+                assert.ok(Array.isArray(agent.frontmatter.handoffs), `${agent.id} handoffs should be array`);
+                for (const handoff of agent.frontmatter.handoffs) {
+                    assert.ok(handoff.label, `${agent.id} handoff should have label`);
+                    assert.ok(handoff.agent, `${agent.id} handoff should have agent`);
+                    assert.ok(handoff.prompt, `${agent.id} handoff should have prompt`);
+                }
+            }
+            // Body should be non-empty
+            assert.ok(agent.body.length > 0, `${agent.id} should have body content`);
+        }
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/core/agents/loader.test.js.map

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

package/dist/core/agents/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Agent Schema Types
+ *
+ * Type definitions for Beth agent configurations parsed from .agent.md files.
+ * These types mirror the YAML frontmatter structure used by GitHub Copilot custom agents.
+ */
+/**
+ * Tools available to agents.
+ * Maps to GitHub Copilot's tool capabilities.
+ */
+export type AgentTool = 'codebase' | 'readFile' | 'editFiles' | 'createFile' | 'listDirectory' | 'fileSearch' | 'textSearch' | 'runInTerminal' | 'getTerminalOutput' | 'problems' | 'usages' | 'runSubagent' | string;
+/**
+ * Handoff definition for agent-to-agent transfers.
+ */
+export interface AgentHandoff {
+    /** UI label for the handoff action */
+    label: string;
+    /** Target agent name */
+    agent: string;
+    /** Default prompt to send with the handoff */
+    prompt: string;
+    /** Whether to automatically send or just prepare the handoff */
+    send?: boolean;
+}
+/**
+ * Agent frontmatter parsed from YAML.
+ * This is the metadata block at the top of .agent.md files.
+ */
+export interface AgentFrontmatter {
+    /** Display name of the agent */
+    name: string;
+    /** Brief description of the agent's purpose */
+    description?: string;
+    /** LLM model to use (e.g., 'Claude Opus 4.5') */
+    model?: string;
+    /** List of tools this agent can use */
+    tools?: AgentTool[];
+    /** Other agents this agent can hand off to */
+    handoffs?: AgentHandoff[];
+    /** Whether this agent can be invoked as a subagent */
+    infer?: boolean;
+}
+/**
+ * Fully parsed agent definition.
+ * Combines frontmatter metadata with the markdown body (system prompt).
+ */
+export interface AgentDefinition {
+    /** Unique identifier derived from filename (e.g., 'developer' from 'developer.agent.md') */
+    id: string;
+    /** Parsed YAML frontmatter */
+    frontmatter: AgentFrontmatter;
+    /** Raw markdown body (becomes the system prompt) */
+    body: string;
+    /** Source file path for debugging */
+    sourcePath: string;
+}
+/**
+ * Result of loading agents from a directory.
+ */
+export interface AgentLoadResult {
+    /** Successfully loaded agents */
+    agents: AgentDefinition[];
+    /** Errors encountered during loading */
+    errors: AgentLoadError[];
+}
+/**
+ * Error encountered while loading an agent file.
+ */
+export interface AgentLoadError {
+    /** Path to the problematic file */
+    filePath: string;
+    /** Human-readable error message */
+    message: string;
+    /** Original error for debugging */
+    cause?: Error;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,UAAU,GACV,WAAW,GACX,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,eAAe,GACf,mBAAmB,GACnB,UAAU,GACV,QAAQ,GACR,aAAa,GACb,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IAEd,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IAEd,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IAEf,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IAEpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAE1B,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,4FAA4F;IAC5F,EAAE,EAAE,MAAM,CAAC;IAEX,8BAA8B;IAC9B,WAAW,EAAE,gBAAgB,CAAC;IAE9B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IAEb,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,MAAM,EAAE,eAAe,EAAE,CAAC;IAE1B,wCAAwC;IACxC,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAEhB,mCAAmC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf"}

package/dist/core/agents/types.js

@@ -0,0 +1,8 @@
+/**
+ * Agent Schema Types
+ *
+ * Type definitions for Beth agent configurations parsed from .agent.md files.
+ * These types mirror the YAML frontmatter structure used by GitHub Copilot custom agents.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/agents/types.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for agent schema types and parsing.
+ * Run with: node --test dist/core/agents/types.test.js
+ */
+export {};
+//# sourceMappingURL=types.test.d.ts.map

package/dist/core/agents/types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.d.ts","sourceRoot":"","sources":["../../../src/core/agents/types.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}