@some-useful-agents/core 0.1.0

package/dist/agent-executor.d.ts

@@ -0,0 +1,12 @@
+import type { AgentDefinition } from './types.js';
+export interface ExecutionResult {
+    result: string;
+    exitCode: number;
+    error?: string;
+}
+export interface ExecutionHandle {
+    promise: Promise<ExecutionResult>;
+    kill: () => void;
+}
+export declare function executeAgent(agent: AgentDefinition, env?: Record<string, string>): ExecutionHandle;
+//# sourceMappingURL=agent-executor.d.ts.map

package/dist/agent-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-executor.d.ts","sourceRoot":"","sources":["../src/agent-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,CAKlG"}

package/dist/agent-executor.js

@@ -0,0 +1,121 @@
+import { spawn } from 'node:child_process';
+export function executeAgent(agent, env) {
+    if (agent.type === 'shell') {
+        return executeShellAgent(agent, env);
+    }
+    return executeClaudeCodeAgent(agent, env);
+}
+function executeShellAgent(agent, prebuiltEnv) {
+    if (!agent.command) {
+        throw new Error(`Shell agent "${agent.name}" has no command`);
+    }
+    let child;
+    let killed = false;
+    let timer;
+    const promise = new Promise((resolve) => {
+        const env = prebuiltEnv ?? { ...process.env, ...(agent.env ?? {}) };
+        child = spawn('bash', ['-c', agent.command], {
+            cwd: agent.workingDirectory ?? process.cwd(),
+            env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (data) => { stdout += data.toString(); });
+        child.stderr.on('data', (data) => { stderr += data.toString(); });
+        const timeoutMs = (agent.timeout ?? 300) * 1000;
+        timer = setTimeout(() => {
+            killed = true;
+            child.kill('SIGTERM');
+            setTimeout(() => { if (!child.killed)
+                child.kill('SIGKILL'); }, 5000);
+        }, timeoutMs);
+        child.on('close', (code) => {
+            if (timer)
+                clearTimeout(timer);
+            if (killed) {
+                resolve({ result: stdout, exitCode: 124, error: `Agent timed out after ${agent.timeout ?? 300}s` });
+            }
+            else {
+                resolve({
+                    result: stdout,
+                    exitCode: code ?? 1,
+                    error: code !== 0 ? stderr || `Process exited with code ${code}` : undefined,
+                });
+            }
+        });
+        child.on('error', (err) => {
+            if (timer)
+                clearTimeout(timer);
+            resolve({ result: '', exitCode: 127, error: err.message });
+        });
+    });
+    return {
+        promise,
+        kill: () => { killed = true; child?.kill('SIGTERM'); },
+    };
+}
+function executeClaudeCodeAgent(agent, prebuiltEnv) {
+    if (!agent.prompt) {
+        throw new Error(`Claude-code agent "${agent.name}" has no prompt`);
+    }
+    let child;
+    let killed = false;
+    let timer;
+    const promise = new Promise((resolve) => {
+        const args = ['--print', agent.prompt];
+        if (agent.model) {
+            args.push('--model', agent.model);
+        }
+        if (agent.maxTurns) {
+            args.push('--max-turns', String(agent.maxTurns));
+        }
+        if (agent.allowedTools?.length) {
+            args.push('--allowedTools', agent.allowedTools.join(','));
+        }
+        const env = prebuiltEnv ?? { ...process.env, ...(agent.env ?? {}) };
+        child = spawn('claude', args, {
+            cwd: agent.workingDirectory ?? process.cwd(),
+            env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (data) => { stdout += data.toString(); });
+        child.stderr.on('data', (data) => { stderr += data.toString(); });
+        const timeoutMs = (agent.timeout ?? 300) * 1000;
+        timer = setTimeout(() => {
+            killed = true;
+            child.kill('SIGTERM');
+        }, timeoutMs);
+        child.on('close', (code) => {
+            if (timer)
+                clearTimeout(timer);
+            if (killed) {
+                resolve({ result: stdout, exitCode: 124, error: `Agent timed out after ${agent.timeout ?? 300}s` });
+            }
+            else {
+                resolve({
+                    result: stdout,
+                    exitCode: code ?? 1,
+                    error: code !== 0 ? stderr || `Claude exited with code ${code}` : undefined,
+                });
+            }
+        });
+        child.on('error', (err) => {
+            if (timer)
+                clearTimeout(timer);
+            if (err.message.includes('ENOENT')) {
+                resolve({ result: '', exitCode: 127, error: 'Claude Code CLI not found. Install it: https://docs.anthropic.com/en/docs/claude-code' });
+            }
+            else {
+                resolve({ result: '', exitCode: 127, error: err.message });
+            }
+        });
+    });
+    return {
+        promise,
+        kill: () => { killed = true; child?.kill('SIGTERM'); },
+    };
+}
+//# sourceMappingURL=agent-executor.js.map

package/dist/agent-executor.js.map

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

package/dist/agent-loader.d.ts

@@ -0,0 +1,19 @@
+import type { AgentDefinition } from './types.js';
+export type AgentSource = 'examples' | 'local' | 'community';
+export interface AgentDirConfig {
+    path: string;
+    source: AgentSource;
+}
+export interface LoadAgentsOptions {
+    directories: (string | AgentDirConfig)[];
+    onWarning?: (file: string, message: string) => void;
+}
+export interface LoadAgentsResult {
+    agents: Map<string, AgentDefinition>;
+    warnings: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+export declare function loadAgents(options: LoadAgentsOptions): LoadAgentsResult;
+//# sourceMappingURL=agent-loader.d.ts.map

package/dist/agent-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loader.d.ts","sourceRoot":"","sources":["../src/agent-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,CAAC,MAAM,GAAG,cAAc,CAAC,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACrC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAuEvE"}

package/dist/agent-loader.js

@@ -0,0 +1,76 @@
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, extname } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { agentDefinitionSchema } from './schema.js';
+export function loadAgents(options) {
+    const agents = new Map();
+    const warnings = [];
+    const warn = (file, message) => {
+        warnings.push({ file, message });
+        options.onWarning?.(file, message);
+    };
+    for (const dirEntry of options.directories) {
+        const dir = typeof dirEntry === 'string' ? dirEntry : dirEntry.path;
+        const source = typeof dirEntry === 'string' ? inferSource(dir) : dirEntry.source;
+        if (!existsSync(dir)) {
+            warn(dir, `Directory does not exist: ${dir}`);
+            continue;
+        }
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch (err) {
+            warn(dir, `Cannot read directory: ${err.message}`);
+            continue;
+        }
+        for (const entry of entries) {
+            const ext = extname(entry).toLowerCase();
+            if (ext !== '.yaml' && ext !== '.yml')
+                continue;
+            const filePath = join(dir, entry);
+            let raw;
+            try {
+                raw = readFileSync(filePath, 'utf-8');
+            }
+            catch (err) {
+                warn(filePath, `Cannot read file: ${err.message}`);
+                continue;
+            }
+            if (!raw.trim()) {
+                warn(filePath, 'Empty file');
+                continue;
+            }
+            let parsed;
+            try {
+                parsed = parseYaml(raw);
+            }
+            catch (err) {
+                warn(filePath, `Invalid YAML: ${err.message}`);
+                continue;
+            }
+            const result = agentDefinitionSchema.safeParse(parsed);
+            if (!result.success) {
+                const issues = result.error.issues.map(i => `${i.path.join('.')}: ${i.message}`).join(', ');
+                warn(filePath, `Validation failed: ${issues}`);
+                continue;
+            }
+            const agent = result.data;
+            agent.source = source;
+            if (agents.has(agent.name)) {
+                warn(filePath, `Duplicate agent name "${agent.name}" (overwriting previous)`);
+            }
+            agents.set(agent.name, agent);
+        }
+    }
+    return { agents, warnings };
+}
+function inferSource(dirPath) {
+    const normalized = dirPath.replace(/\\/g, '/');
+    if (normalized.includes('/community'))
+        return 'community';
+    if (normalized.includes('/examples'))
+        return 'examples';
+    return 'local';
+}
+//# sourceMappingURL=agent-loader.js.map

package/dist/agent-loader.js.map

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

package/dist/agent-loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-loader.test.d.ts.map

package/dist/agent-loader.test.d.ts.map

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

package/dist/agent-loader.test.js

@@ -0,0 +1,82 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdirSync, writeFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadAgents } from './agent-loader.js';
+const TEST_DIR = join(import.meta.dirname, '__test-agents__');
+function writeAgent(dir, filename, content) {
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, filename), content);
+}
+beforeEach(() => {
+    mkdirSync(TEST_DIR, { recursive: true });
+});
+afterEach(() => {
+    rmSync(TEST_DIR, { recursive: true, force: true });
+});
+describe('loadAgents', () => {
+    it('loads valid agents from directory', () => {
+        writeAgent(TEST_DIR, 'test.yaml', 'name: test\ntype: shell\ncommand: "echo hi"\n');
+        const { agents, warnings } = loadAgents({ directories: [TEST_DIR] });
+        expect(agents.size).toBe(1);
+        expect(agents.get('test')?.command).toBe('echo hi');
+        expect(warnings.length).toBe(0);
+    });
+    it('warns when directory does not exist', () => {
+        const { agents, warnings } = loadAgents({ directories: ['/nonexistent'] });
+        expect(agents.size).toBe(0);
+        expect(warnings.length).toBe(1);
+        expect(warnings[0].message).toContain('does not exist');
+    });
+    it('handles empty directory', () => {
+        const { agents, warnings } = loadAgents({ directories: [TEST_DIR] });
+        expect(agents.size).toBe(0);
+        expect(warnings.length).toBe(0);
+    });
+    it('skips invalid YAML and loads valid ones', () => {
+        writeAgent(TEST_DIR, 'good.yaml', 'name: good\ntype: shell\ncommand: "echo"\n');
+        writeAgent(TEST_DIR, 'bad.yaml', 'name: bad\ntype: shell\n'); // missing command
+        const { agents, warnings } = loadAgents({ directories: [TEST_DIR] });
+        expect(agents.size).toBe(1);
+        expect(agents.has('good')).toBe(true);
+        expect(warnings.length).toBe(1);
+    });
+    it('warns on duplicate agent names', () => {
+        const dir2 = join(TEST_DIR, 'dir2');
+        writeAgent(TEST_DIR, 'a.yaml', 'name: dup\ntype: shell\ncommand: "echo 1"\n');
+        writeAgent(dir2, 'b.yaml', 'name: dup\ntype: shell\ncommand: "echo 2"\n');
+        const { agents, warnings } = loadAgents({ directories: [TEST_DIR, dir2] });
+        expect(agents.size).toBe(1);
+        expect(warnings.some(w => w.message.includes('Duplicate'))).toBe(true);
+    });
+    it('skips non-YAML files', () => {
+        writeAgent(TEST_DIR, 'README.md', '# Not an agent');
+        writeAgent(TEST_DIR, '.gitkeep', '');
+        writeAgent(TEST_DIR, 'test.yaml', 'name: test\ntype: shell\ncommand: "echo"\n');
+        const { agents } = loadAgents({ directories: [TEST_DIR] });
+        expect(agents.size).toBe(1);
+    });
+    it('warns on empty YAML files', () => {
+        writeAgent(TEST_DIR, 'empty.yaml', '');
+        const { warnings } = loadAgents({ directories: [TEST_DIR] });
+        expect(warnings.length).toBe(1);
+        expect(warnings[0].message).toContain('Empty');
+    });
+    it('warns on malformed YAML', () => {
+        writeAgent(TEST_DIR, 'bad.yaml', '{{{{not yaml');
+        const { warnings } = loadAgents({ directories: [TEST_DIR] });
+        expect(warnings.length).toBe(1);
+        expect(warnings[0].message).toContain('Invalid YAML');
+    });
+    it('loads .yml files too', () => {
+        writeAgent(TEST_DIR, 'test.yml', 'name: test\ntype: shell\ncommand: "echo"\n');
+        const { agents } = loadAgents({ directories: [TEST_DIR] });
+        expect(agents.size).toBe(1);
+    });
+    it('calls onWarning callback', () => {
+        writeAgent(TEST_DIR, 'bad.yaml', 'name: bad\ntype: shell\n');
+        const warned = [];
+        loadAgents({ directories: [TEST_DIR], onWarning: (f, m) => warned.push(m) });
+        expect(warned.length).toBe(1);
+    });
+});
+//# sourceMappingURL=agent-loader.test.js.map

package/dist/agent-loader.test.js.map

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

package/dist/chain-executor.d.ts

@@ -0,0 +1,16 @@
+import type { AgentDefinition, Run } from './types.js';
+import type { Provider } from './types.js';
+export interface ChainResult {
+    runs: Run[];
+    outputs: Map<string, {
+        result: string;
+        exitCode: number;
+    }>;
+    skipped: string[];
+}
+/**
+ * Execute a chain of agents in dependency order.
+ * Stops on first failure, marks downstream agents as skipped.
+ */
+export declare function executeChain(agents: Map<string, AgentDefinition>, provider: Provider, triggeredBy: Run['triggeredBy'], pollInterval?: number): Promise<ChainResult>;
+//# sourceMappingURL=chain-executor.d.ts.map

package/dist/chain-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-executor.d.ts","sourceRoot":"","sources":["../src/chain-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACpC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,GAAG,CAAC,aAAa,CAAC,EAC/B,YAAY,SAAM,GACjB,OAAO,CAAC,WAAW,CAAC,CAmDtB"}

package/dist/chain-executor.js

@@ -0,0 +1,54 @@
+import { resolveExecutionOrder, resolveTemplate } from './chain-resolver.js';
+/**
+ * Execute a chain of agents in dependency order.
+ * Stops on first failure, marks downstream agents as skipped.
+ */
+export async function executeChain(agents, provider, triggeredBy, pollInterval = 250) {
+    const order = resolveExecutionOrder(agents);
+    const outputs = new Map();
+    const runs = [];
+    const skipped = [];
+    let failed = false;
+    for (const agent of order) {
+        if (failed) {
+            skipped.push(agent.name);
+            continue;
+        }
+        // Resolve input template if present
+        let resolvedAgent = agent;
+        if (agent.input) {
+            const resolvedInput = resolveTemplate(agent.input, outputs);
+            // For claude-code agents, append to prompt. For shell agents, set as env var.
+            if (agent.type === 'claude-code' && agent.prompt) {
+                resolvedAgent = { ...agent, prompt: `${agent.prompt}\n\nInput: ${resolvedInput}` };
+            }
+            else if (agent.type === 'shell') {
+                resolvedAgent = {
+                    ...agent,
+                    env: { ...(agent.env ?? {}), SUA_CHAIN_INPUT: resolvedInput },
+                };
+            }
+        }
+        const run = await provider.submitRun({ agent: resolvedAgent, triggeredBy });
+        // Poll for completion
+        let current = run;
+        while (current.status === 'running' || current.status === 'pending') {
+            await new Promise(r => setTimeout(r, pollInterval));
+            const updated = await provider.getRun(run.id);
+            if (updated)
+                current = updated;
+        }
+        runs.push(current);
+        if (current.status === 'completed') {
+            outputs.set(agent.name, {
+                result: current.result ?? '',
+                exitCode: current.exitCode ?? 0,
+            });
+        }
+        else {
+            failed = true;
+        }
+    }
+    return { runs, outputs, skipped };
+}
+//# sourceMappingURL=chain-executor.js.map

package/dist/chain-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-executor.js","sourceRoot":"","sources":["../src/chain-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAQ7E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAoC,EACpC,QAAkB,EAClB,WAA+B,EAC/B,YAAY,GAAG,GAAG;IAElB,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgD,CAAC;IACxE,MAAM,IAAI,GAAU,EAAE,CAAC;IACvB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QAED,oCAAoC;QACpC,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC5D,8EAA8E;YAC9E,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjD,aAAa,GAAG,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,cAAc,aAAa,EAAE,EAAE,CAAC;YACrF,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAClC,aAAa,GAAG;oBACd,GAAG,KAAK;oBACR,GAAG,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,eAAe,EAAE,aAAa,EAAE;iBAC9D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC,CAAC;QAE5E,sBAAsB;QACtB,IAAI,OAAO,GAAG,GAAG,CAAC;QAClB,OAAO,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACpE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;YACpD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,OAAO;gBAAE,OAAO,GAAG,OAAO,CAAC;QACjC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnB,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;gBAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;aAChC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/chain-resolver.d.ts

@@ -0,0 +1,27 @@
+import type { AgentDefinition } from './types.js';
+export declare class CycleError extends Error {
+    readonly cycle: string[];
+    constructor(cycle: string[]);
+}
+export declare class MissingDependencyError extends Error {
+    readonly agent: string;
+    readonly missing: string;
+    constructor(agent: string, missing: string);
+}
+/**
+ * Topological sort of agents based on dependsOn fields.
+ * Returns agents in execution order (dependencies first).
+ * Throws CycleError if circular dependencies exist.
+ * Throws MissingDependencyError if a dependency doesn't exist.
+ */
+export declare function resolveExecutionOrder(agents: Map<string, AgentDefinition>): AgentDefinition[];
+/**
+ * Resolve template strings like {{outputs.agent-name.result}}
+ * against a map of completed agent outputs.
+ */
+export declare function resolveTemplate(template: string, outputs: Map<string, {
+    result: string;
+    exitCode: number;
+}>): string;
+export declare function validateChainDepth(agents: Map<string, AgentDefinition>): void;
+//# sourceMappingURL=chain-resolver.d.ts.map

package/dist/chain-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-resolver.d.ts","sourceRoot":"","sources":["../src/chain-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,UAAW,SAAQ,KAAK;aACP,KAAK,EAAE,MAAM,EAAE;gBAAf,KAAK,EAAE,MAAM,EAAE;CAI5C;AAED,qBAAa,sBAAuB,SAAQ,KAAK;aACnB,KAAK,EAAE,MAAM;aAAkB,OAAO,EAAE,MAAM;gBAA9C,KAAK,EAAE,MAAM,EAAkB,OAAO,EAAE,MAAM;CAI3E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,eAAe,EAAE,CAuC7F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GACzD,MAAM,CAQR;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI,CAK7E"}

package/dist/chain-resolver.js

@@ -0,0 +1,82 @@
+export class CycleError extends Error {
+    cycle;
+    constructor(cycle) {
+        super(`Circular dependency detected: ${cycle.join(' -> ')}`);
+        this.cycle = cycle;
+        this.name = 'CycleError';
+    }
+}
+export class MissingDependencyError extends Error {
+    agent;
+    missing;
+    constructor(agent, missing) {
+        super(`Agent "${agent}" depends on "${missing}" which does not exist`);
+        this.agent = agent;
+        this.missing = missing;
+        this.name = 'MissingDependencyError';
+    }
+}
+/**
+ * Topological sort of agents based on dependsOn fields.
+ * Returns agents in execution order (dependencies first).
+ * Throws CycleError if circular dependencies exist.
+ * Throws MissingDependencyError if a dependency doesn't exist.
+ */
+export function resolveExecutionOrder(agents) {
+    // Validate all dependencies exist
+    for (const [name, agent] of agents) {
+        for (const dep of agent.dependsOn ?? []) {
+            if (!agents.has(dep)) {
+                throw new MissingDependencyError(name, dep);
+            }
+        }
+    }
+    const sorted = [];
+    const visited = new Set();
+    const visiting = new Set();
+    function visit(name, path) {
+        if (visited.has(name))
+            return;
+        if (visiting.has(name)) {
+            const cycleStart = path.indexOf(name);
+            throw new CycleError([...path.slice(cycleStart), name]);
+        }
+        visiting.add(name);
+        path.push(name);
+        const agent = agents.get(name);
+        for (const dep of agent.dependsOn ?? []) {
+            visit(dep, [...path]);
+        }
+        visiting.delete(name);
+        visited.add(name);
+        sorted.push(agent);
+    }
+    for (const name of agents.keys()) {
+        visit(name, []);
+    }
+    return sorted;
+}
+/**
+ * Resolve template strings like {{outputs.agent-name.result}}
+ * against a map of completed agent outputs.
+ */
+export function resolveTemplate(template, outputs) {
+    return template.replace(/\{\{outputs\.([a-z0-9-]+)\.(result|exitCode)\}\}/g, (_, agentName, field) => {
+        const output = outputs.get(agentName);
+        if (!output)
+            return '';
+        if (field === 'result')
+            return output.result;
+        if (field === 'exitCode')
+            return String(output.exitCode);
+        return '';
+    });
+}
+const MAX_CHAIN_DEPTH = 20;
+export function validateChainDepth(agents) {
+    const order = resolveExecutionOrder(agents);
+    if (order.length > MAX_CHAIN_DEPTH) {
+        throw new Error(`Chain exceeds maximum depth of ${MAX_CHAIN_DEPTH} agents (has ${order.length})`);
+    }
+}
+//# sourceMappingURL=chain-resolver.js.map

package/dist/chain-resolver.js.map

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

package/dist/chain-resolver.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chain-resolver.test.d.ts.map

package/dist/chain-resolver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-resolver.test.d.ts","sourceRoot":"","sources":["../src/chain-resolver.test.ts"],"names":[],"mappings":""}