@calliopelabs/cli 0.8.20 → 2.0.2

package/dist/agents/decomposer.js

@@ -0,0 +1,138 @@
+/**
+ * Calliope Agents — Decomposer
+ *
+ * Decomposes a high-level task into subtasks using the overseer agent.
+ * Supports parallel, sequential, map-reduce, and pipeline strategies.
+ */
+import { randomUUID } from 'crypto';
+/**
+ * Build the decomposition prompt for the overseer
+ */
+export function buildDecompositionPrompt(task, strategy, workerAgent) {
+    const strategyInstructions = {
+        parallel: `Break this task into independent subtasks that can run in parallel.
+Each subtask should be self-contained and not depend on results from other subtasks.
+Return 2-8 subtasks.`,
+        sequential: `Break this task into ordered steps that must run one after another.
+Each step may depend on the result of the previous step.
+Return 2-8 steps.`,
+        'map-reduce': `Break this task into a map phase and a reduce phase.
+Map: Create 2-6 independent subtasks that process different parts of the problem.
+Reduce: The results will be automatically merged.`,
+        pipeline: `Break this task into pipeline stages where each stage transforms the output.
+Stage 1 produces raw output, Stage 2 refines it, Stage 3 polishes it, etc.
+Return 2-5 stages.`,
+    };
+    return `You are a task decomposition agent. Your job is to break down a complex task into smaller subtasks.
+
+Strategy: ${strategy}
+${strategyInstructions[strategy]}
+
+Worker agent: ${workerAgent}
+
+IMPORTANT: Respond ONLY with a JSON array of subtasks. No explanation, no markdown, just JSON.
+
+Each subtask object should have:
+- "prompt": string - The full task description for the worker
+- "dependsOn": number[] - Indices of subtasks this depends on (0-based, empty for parallel)
+- "priority": string - "low", "normal", "high", or "critical" (default: "normal")
+
+Example response:
+[
+  {"prompt": "Search for all TODO comments in the codebase", "dependsOn": [], "priority": "normal"},
+  {"prompt": "Categorize the TODOs by severity", "dependsOn": [0], "priority": "normal"}
+]
+
+Task to decompose:
+${task}`;
+}
+/**
+ * Parse the decomposition response from the overseer
+ */
+export function parseDecompositionResponse(response, workerAgent, maxRetries) {
+    // Try to extract JSON from the response
+    let parsed;
+    // Try direct JSON parse first
+    try {
+        parsed = JSON.parse(response.trim());
+    }
+    catch {
+        // Try to find JSON array in the response
+        const jsonMatch = response.match(/\[[\s\S]*\]/);
+        if (!jsonMatch) {
+            throw new Error('Failed to parse decomposition response: no JSON array found');
+        }
+        try {
+            parsed = JSON.parse(jsonMatch[0]);
+        }
+        catch {
+            throw new Error('Failed to parse decomposition response: invalid JSON');
+        }
+    }
+    if (!Array.isArray(parsed) || parsed.length === 0) {
+        throw new Error('Decomposition returned empty or invalid subtask list');
+    }
+    // Cap at reasonable limit
+    if (parsed.length > 20) {
+        parsed = parsed.slice(0, 20);
+    }
+    return parsed.map((item, index) => ({
+        id: randomUUID(),
+        index,
+        prompt: String(item.prompt || `Subtask ${index + 1}`),
+        agent: item.agent || workerAgent,
+        priority: item.priority || 'normal',
+        status: 'pending',
+        dependsOn: (item.dependsOn || []).map(dep => {
+            // Convert numeric indices to subtask IDs - we'll resolve later
+            return String(dep);
+        }),
+        attempts: 0,
+        maxAttempts: maxRetries + 1,
+        createdAt: new Date(),
+    }));
+}
+/**
+ * Resolve numeric dependency indices to actual subtask IDs
+ */
+export function resolveDependencies(subtasks) {
+    return subtasks.map(subtask => ({
+        ...subtask,
+        dependsOn: subtask.dependsOn
+            .map(depIndex => {
+            const idx = parseInt(depIndex, 10);
+            if (isNaN(idx) || idx < 0 || idx >= subtasks.length || idx === subtask.index) {
+                return null;
+            }
+            return subtasks[idx].id;
+        })
+            .filter((id) => id !== null),
+    }));
+}
+/**
+ * Get subtasks that are ready to execute (dependencies met)
+ */
+export function getReadySubtasks(subtasks) {
+    const completedIds = new Set(subtasks
+        .filter(s => s.status === 'completed')
+        .map(s => s.id));
+    return subtasks.filter(subtask => {
+        if (subtask.status !== 'pending')
+            return false;
+        return subtask.dependsOn.every(depId => completedIds.has(depId));
+    });
+}
+/**
+ * Check if all subtasks are done (completed or permanently failed)
+ */
+export function allSubtasksDone(subtasks) {
+    return subtasks.every(s => s.status === 'completed' ||
+        (s.status === 'failed' && s.attempts >= s.maxAttempts));
+}
+/**
+ * Check if any subtask permanently failed
+ */
+export function hasFailedSubtasks(subtasks) {
+    return subtasks.some(s => s.status === 'failed' && s.attempts >= s.maxAttempts);
+}
+//# sourceMappingURL=decomposer.js.map

package/dist/agents/decomposer.js.map

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

package/dist/agents/dynamic-tools.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Dynamic Tool System
+ *
+ * Allows agents to create, register, and use tools at runtime.
+ * Tools can be shell commands with template placeholders or code
+ * executed via node/python/bash. Persistent tools are saved to
+ * `.calliope/tools/` as JSON files and reloaded on startup.
+ */
+import type { Tool, ToolCall, ToolResult } from '../types.js';
+export interface DynamicTool {
+    name: string;
+    description: string;
+    parameters: Tool['parameters'];
+    /** Shell command template with {{param}} placeholders */
+    command?: string;
+    /** JavaScript/TypeScript code to execute */
+    code?: string;
+    /** Language for code execution */
+    language?: 'node' | 'python' | 'bash';
+    /** Who created this tool */
+    createdBy: string;
+    /** When created */
+    createdAt: Date;
+    /** Persist across sessions */
+    persistent?: boolean;
+}
+export declare class DynamicToolRegistry {
+    private static instance;
+    private tools;
+    private constructor();
+    static getInstance(): DynamicToolRegistry;
+    register(tool: DynamicTool): void;
+    unregister(name: string): boolean;
+    get(name: string): DynamicTool | undefined;
+    getAll(): DynamicTool[];
+    isDynamic(name: string): boolean;
+    reset(): void;
+    /** Return Tool[] definitions suitable for sending to the LLM. */
+    getToolDefinitions(): Tool[];
+    execute(toolCall: ToolCall, cwd: string): Promise<ToolResult>;
+    private run;
+    private toolsDir;
+    save(cwd: string): void;
+    load(cwd: string): void;
+}
+export declare const dynamicToolRegistry: DynamicToolRegistry;
+export declare function isDynamicTool(name: string): boolean;
+export declare function executeDynamicTool(toolCall: ToolCall, cwd: string): Promise<ToolResult>;
+export declare const DYNAMIC_TOOL_NAMES: readonly ["create_tool", "list_dynamic_tools", "remove_tool"];
+export declare function getDynamicToolDefs(): Tool[];
+export declare function executeMetaTool(toolCall: ToolCall, cwd: string, agentId?: string): Promise<ToolResult>;
+//# sourceMappingURL=dynamic-tools.d.ts.map

package/dist/agents/dynamic-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-tools.d.ts","sourceRoot":"","sources":["../../src/agents/dynamic-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA2ED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoC;IAC3D,OAAO,CAAC,KAAK,CAAkC;IAE/C,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,mBAAmB;IASzC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAQjC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1C,MAAM,IAAI,WAAW,EAAE;IAIvB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,KAAK,IAAI,IAAI;IAMb,iEAAiE;IACjE,kBAAkB,IAAI,IAAI,EAAE;IAUtB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA0BnE,OAAO,CAAC,GAAG;IAgDX,OAAO,CAAC,QAAQ;IAIhB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAyBvB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAmBxB;AAcD,eAAO,MAAM,mBAAmB,qBAAoC,CAAC;AAErE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAEvF;AAMD,eAAO,MAAM,kBAAkB,+DAIrB,CAAC;AAEX,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CAqE3C;AAMD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAe,GACvB,OAAO,CAAC,UAAU,CAAC,CAyFrB"}

package/dist/agents/dynamic-tools.js

@@ -0,0 +1,395 @@
+/**
+ * Dynamic Tool System
+ *
+ * Allows agents to create, register, and use tools at runtime.
+ * Tools can be shell commands with template placeholders or code
+ * executed via node/python/bash. Persistent tools are saved to
+ * `.calliope/tools/` as JSON files and reloaded on startup.
+ */
+import { execSync } from 'child_process';
+import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from 'fs';
+import { join, resolve } from 'path';
+// ---------------------------------------------------------------------------
+// Validation helpers
+// ---------------------------------------------------------------------------
+const RESERVED_NAMES = new Set([
+    'create_tool', 'list_dynamic_tools', 'remove_tool',
+    'execute_command', 'read_file', 'write_file', 'think',
+    'create_plan', 'list_files', 'search_files', 'search_code',
+]);
+const DANGEROUS_PATTERNS = [
+    /\.\.\//, // path traversal
+    /\.\.\\/, // windows path traversal
+    /;\s*rm\s+-rf/i, // rm -rf injection
+    /;\s*sudo\b/i, // sudo injection
+    /;\s*dd\b/i, // dd injection
+    /;\s*mkfs\b/i, // mkfs injection
+    /\$\(.*\)/, // command substitution
+    /`[^`]*`/, // backtick substitution
+];
+function validateName(name) {
+    if (!/^[a-z][a-z0-9_]{1,63}$/.test(name)) {
+        throw new Error(`Invalid tool name "${name}". Must be lowercase letters, digits, underscores, 2-64 chars, start with a letter.`);
+    }
+    if (RESERVED_NAMES.has(name)) {
+        throw new Error(`Tool name "${name}" is reserved and cannot be used.`);
+    }
+}
+function sanitizeArg(value) {
+    const str = String(value);
+    for (const pat of DANGEROUS_PATTERNS) {
+        if (pat.test(str)) {
+            throw new Error(`Argument value rejected by security check: ${str}`);
+        }
+    }
+    return str;
+}
+function substituteParams(template, args) {
+    return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+        if (!(key in args)) {
+            throw new Error(`Missing required parameter: ${key}`);
+        }
+        return sanitizeArg(args[key]);
+    });
+}
+function toolToJSON(tool) {
+    return { ...tool, createdAt: tool.createdAt.toISOString() };
+}
+function toolFromJSON(json) {
+    return { ...json, createdAt: new Date(json.createdAt) };
+}
+// ---------------------------------------------------------------------------
+// Registry
+// ---------------------------------------------------------------------------
+const DEFAULT_TIMEOUT = 30_000; // 30 seconds
+export class DynamicToolRegistry {
+    static instance = null;
+    tools = new Map();
+    constructor() { }
+    static getInstance() {
+        if (!DynamicToolRegistry.instance) {
+            DynamicToolRegistry.instance = new DynamicToolRegistry();
+        }
+        return DynamicToolRegistry.instance;
+    }
+    // -- CRUD ----------------------------------------------------------------
+    register(tool) {
+        validateName(tool.name);
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Dynamic tool "${tool.name}" is already registered. Remove it first.`);
+        }
+        this.tools.set(tool.name, { ...tool });
+    }
+    unregister(name) {
+        return this.tools.delete(name);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    isDynamic(name) {
+        return this.tools.has(name);
+    }
+    reset() {
+        this.tools.clear();
+    }
+    // -- LLM integration -----------------------------------------------------
+    /** Return Tool[] definitions suitable for sending to the LLM. */
+    getToolDefinitions() {
+        return Array.from(this.tools.values()).map((t) => ({
+            name: t.name,
+            description: `[dynamic] ${t.description}`,
+            parameters: t.parameters,
+        }));
+    }
+    // -- Execution -----------------------------------------------------------
+    async execute(toolCall, cwd) {
+        const tool = this.tools.get(toolCall.name);
+        if (!tool) {
+            return {
+                toolCallId: toolCall.id,
+                result: `Error: dynamic tool "${toolCall.name}" not found.`,
+                isError: true,
+            };
+        }
+        try {
+            const output = this.run(tool, toolCall.arguments, cwd);
+            return {
+                toolCallId: toolCall.id,
+                result: output.slice(0, 50_000), // cap output size
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                toolCallId: toolCall.id,
+                result: `Error executing dynamic tool "${toolCall.name}": ${msg}`,
+                isError: true,
+            };
+        }
+    }
+    run(tool, args, cwd) {
+        const resolvedCwd = resolve(cwd);
+        if (tool.command) {
+            const cmd = substituteParams(tool.command, args);
+            return execSync(cmd, {
+                cwd: resolvedCwd,
+                timeout: DEFAULT_TIMEOUT,
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+                maxBuffer: 10 * 1024 * 1024,
+            }).trim();
+        }
+        if (tool.code) {
+            const lang = tool.language ?? 'bash';
+            const code = substituteParams(tool.code, args);
+            let cmd;
+            switch (lang) {
+                case 'node':
+                    // Wrap in an IIFE so multi-statement code works and last expression is printed
+                    cmd = `node -e ${shellEscape(code)}`;
+                    break;
+                case 'python':
+                    cmd = `python3 -c ${shellEscape(code)}`;
+                    break;
+                case 'bash':
+                    cmd = `bash -c ${shellEscape(code)}`;
+                    break;
+                default:
+                    throw new Error(`Unsupported language: ${lang}`);
+            }
+            return execSync(cmd, {
+                cwd: resolvedCwd,
+                timeout: DEFAULT_TIMEOUT,
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+                maxBuffer: 10 * 1024 * 1024,
+            }).trim();
+        }
+        throw new Error('Dynamic tool has neither "command" nor "code" defined.');
+    }
+    // -- Persistence ---------------------------------------------------------
+    toolsDir(cwd) {
+        return join(resolve(cwd), '.calliope', 'tools');
+    }
+    save(cwd) {
+        const dir = this.toolsDir(cwd);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Write each persistent tool as its own JSON file
+        for (const tool of this.tools.values()) {
+            if (!tool.persistent)
+                continue;
+            const filePath = join(dir, `${tool.name}.json`);
+            writeFileSync(filePath, JSON.stringify(toolToJSON(tool), null, 2), 'utf-8');
+        }
+        // Remove JSON files for tools that no longer exist
+        if (existsSync(dir)) {
+            for (const file of readdirSync(dir)) {
+                if (!file.endsWith('.json'))
+                    continue;
+                const name = file.replace(/\.json$/, '');
+                if (!this.tools.has(name)) {
+                    unlinkSync(join(dir, file));
+                }
+            }
+        }
+    }
+    load(cwd) {
+        const dir = this.toolsDir(cwd);
+        if (!existsSync(dir))
+            return;
+        for (const file of readdirSync(dir)) {
+            if (!file.endsWith('.json'))
+                continue;
+            try {
+                const raw = readFileSync(join(dir, file), 'utf-8');
+                const json = JSON.parse(raw);
+                const tool = toolFromJSON(json);
+                // Skip if already registered (runtime takes precedence)
+                if (!this.tools.has(tool.name)) {
+                    this.tools.set(tool.name, tool);
+                }
+            }
+            catch {
+                // Silently skip malformed files
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Shell escape helper
+// ---------------------------------------------------------------------------
+function shellEscape(s) {
+    return "'" + s.replace(/'/g, "'\\''") + "'";
+}
+// ---------------------------------------------------------------------------
+// Singleton & convenience exports
+// ---------------------------------------------------------------------------
+export const dynamicToolRegistry = DynamicToolRegistry.getInstance();
+export function isDynamicTool(name) {
+    return dynamicToolRegistry.isDynamic(name);
+}
+export function executeDynamicTool(toolCall, cwd) {
+    return dynamicToolRegistry.execute(toolCall, cwd);
+}
+// ---------------------------------------------------------------------------
+// Meta-tool definitions (create_tool, list_dynamic_tools, remove_tool)
+// ---------------------------------------------------------------------------
+export const DYNAMIC_TOOL_NAMES = [
+    'create_tool',
+    'list_dynamic_tools',
+    'remove_tool',
+];
+export function getDynamicToolDefs() {
+    return [
+        {
+            name: 'create_tool',
+            description: 'Create a new dynamic tool that can be used in future turns. ' +
+                'Provide either a shell command template (with {{param}} placeholders) or code to execute.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                        description: 'Tool name (lowercase, underscores, 2-64 chars, starts with letter). E.g. "count_lines".',
+                    },
+                    description: {
+                        type: 'string',
+                        description: 'What the tool does — shown to the LLM.',
+                    },
+                    parameters: {
+                        type: 'string',
+                        description: 'JSON string describing parameters object: { "type": "object", "properties": { ... }, "required": [...] }',
+                    },
+                    command: {
+                        type: 'string',
+                        description: 'Shell command template. Use {{param}} for parameter substitution. E.g. "wc -l {{file}}".',
+                    },
+                    code: {
+                        type: 'string',
+                        description: 'Code to execute (used if command is not provided).',
+                    },
+                    language: {
+                        type: 'string',
+                        description: 'Language for code execution.',
+                        enum: ['node', 'python', 'bash'],
+                    },
+                    persistent: {
+                        type: 'string',
+                        description: 'Set to "true" to persist this tool across sessions.',
+                    },
+                },
+                required: ['name', 'description', 'parameters'],
+            },
+        },
+        {
+            name: 'list_dynamic_tools',
+            description: 'List all dynamically created tools.',
+            parameters: {
+                type: 'object',
+                properties: {},
+            },
+        },
+        {
+            name: 'remove_tool',
+            description: 'Remove a dynamically created tool by name.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                        description: 'Name of the dynamic tool to remove.',
+                    },
+                },
+                required: ['name'],
+            },
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Meta-tool executor
+// ---------------------------------------------------------------------------
+export async function executeMetaTool(toolCall, cwd, agentId = 'user') {
+    const { name, arguments: args } = toolCall;
+    switch (name) {
+        case 'create_tool': {
+            try {
+                const toolName = String(args.name ?? '');
+                const description = String(args.description ?? '');
+                let params;
+                try {
+                    params = JSON.parse(String(args.parameters ?? '{}'));
+                }
+                catch {
+                    return {
+                        toolCallId: toolCall.id,
+                        result: 'Error: "parameters" must be a valid JSON string.',
+                        isError: true,
+                    };
+                }
+                const newTool = {
+                    name: toolName,
+                    description,
+                    parameters: params,
+                    command: args.command ? String(args.command) : undefined,
+                    code: args.code ? String(args.code) : undefined,
+                    language: args.language ?? undefined,
+                    createdBy: agentId,
+                    createdAt: new Date(),
+                    persistent: String(args.persistent) === 'true',
+                };
+                if (!newTool.command && !newTool.code) {
+                    return {
+                        toolCallId: toolCall.id,
+                        result: 'Error: provide either "command" or "code" for the tool implementation.',
+                        isError: true,
+                    };
+                }
+                dynamicToolRegistry.register(newTool);
+                if (newTool.persistent) {
+                    dynamicToolRegistry.save(cwd);
+                }
+                return {
+                    toolCallId: toolCall.id,
+                    result: `Dynamic tool "${toolName}" created successfully.${newTool.persistent ? ' (persistent)' : ''}`,
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { toolCallId: toolCall.id, result: `Error: ${msg}`, isError: true };
+            }
+        }
+        case 'list_dynamic_tools': {
+            const tools = dynamicToolRegistry.getAll();
+            if (tools.length === 0) {
+                return { toolCallId: toolCall.id, result: 'No dynamic tools registered.' };
+            }
+            const lines = tools.map((t) => `- ${t.name}: ${t.description} (by ${t.createdBy}, ${t.persistent ? 'persistent' : 'session-only'})`);
+            return { toolCallId: toolCall.id, result: lines.join('\n') };
+        }
+        case 'remove_tool': {
+            const toolName = String(args.name ?? '');
+            const removed = dynamicToolRegistry.unregister(toolName);
+            if (removed) {
+                dynamicToolRegistry.save(cwd);
+                return { toolCallId: toolCall.id, result: `Dynamic tool "${toolName}" removed.` };
+            }
+            return {
+                toolCallId: toolCall.id,
+                result: `Dynamic tool "${toolName}" not found.`,
+                isError: true,
+            };
+        }
+        default:
+            return {
+                toolCallId: toolCall.id,
+                result: `Unknown meta-tool: ${name}`,
+                isError: true,
+            };
+    }
+}
+//# sourceMappingURL=dynamic-tools.js.map

package/dist/agents/dynamic-tools.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Calliope Agents — Multi-Agent Module
+ *
+ * Provides sub-agent orchestration capabilities.
+ */
+export type { SubAgentType, SubAgentTaskStatus, TaskPriority, SubAgentTask, OrchestratorConfig, AgentCLIInfo, AgentEventType, AgentEvent, } from './types.js';
+export { DEFAULT_ORCHESTRATOR_CONFIG, AGENT_CLI_MAP, } from './types.js';
+export { detectAgents, getAvailableAgents, isAgentAvailable, getAgentCLI, getAgentEnvVar, getAgentStatusReport, } from './agent-detection.js';
+export { executeAgent, cancelTask, getTaskOutput, isTaskRunning, getRunningTaskCount, killAllTasks, } from './cli-backend.js';
+export { orchestrator } from './orchestrator.js';
+export { getAgtermTools, AGTERM_TOOL_NAMES, isAgtermTool, executeAgtermTool, setCommandDispatcher, } from './tools.js';
+export type { SwarmSession, SwarmSubtask, SwarmConfig, SwarmStatus, SwarmSubtaskStatus, DecompositionStrategy, AggregationStrategy, } from './swarm-types.js';
+export { DEFAULT_SWARM_CONFIG } from './swarm-types.js';
+export { swarmManager } from './swarm.js';
+export { buildDecompositionPrompt, parseDecompositionResponse, resolveDependencies, getReadySubtasks, allSubtasksDone, hasFailedSubtasks, } from './decomposer.js';
+export { aggregateResults, buildAggregationPrompt, } from './aggregator.js';
+export type { CouncilSession, CouncilConfig, CouncilMember, CouncilMode, CouncilStatus, CouncilTemplate, DeliberationEntry, Vote, Score, TieBreaker, } from './council-types.js';
+export { DEFAULT_COUNCIL_CONFIG, COUNCIL_TEMPLATES, } from './council-types.js';
+export { councilManager } from './council.js';
+export type { TaskExecutor } from './types.js';
+export { isClaudeSdkAvailable, isOpenaiSdkAvailable, isGoogleAdkAvailable, getAvailableExecutors, executeSdkAgent, } from './sdk-backend.js';
+export { getInstallableItems, getInstallReport, installItem, installAllMissing, } from './installer.js';
+export type { InstallableItem } from './installer.js';
+export type { DynamicTool } from './dynamic-tools.js';
+export { dynamicToolRegistry, getDynamicToolDefs, isDynamicTool, executeDynamicTool, executeMetaTool, DYNAMIC_TOOL_NAMES, } from './dynamic-tools.js';
+export type { AgentDefinition, TeamDefinition, TeamMember, ResolvedTeam, ResolvedTeamMember, } from './agent-config-types.js';
+export { getAgent, getTeam, listAgentDefs, listTeamDefs, resolveTeam, loadAgentDefinitions, loadTeamDefinitions, scaffoldAgentsDir, saveAgentDef, saveTeamDef, mapEngineToAgentType, } from './agent-config-loader.js';
+export { BUILTIN_AGENTS, BUILTIN_TEAMS, } from './agent-config-presets.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,2BAA2B,EAC3B,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,WAAW,EACX,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,IAAI,EACJ,KAAK,EACL,UAAU,GACX,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,QAAQ,EACR,OAAO,EACP,aAAa,EACb,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,cAAc,EACd,aAAa,GACd,MAAM,2BAA2B,CAAC"}