@alexnetrebskii/hive-agent 0.5.0

package/dist/agent.js

@@ -0,0 +1,277 @@
+/**
+ * Hive Agent
+ *
+ * Main agent class that orchestrates tool execution, sub-agents, and context management.
+ */
+import { ContextManager } from './context.js';
+import { executeLoop } from './executor.js';
+import { buildAgentListSection } from './prompt.js';
+import { TodoManager, createTodoTool } from './todo.js';
+import { ReviewManager, createReviewTool } from './review.js';
+/**
+ * Create the __ask_user__ tool
+ */
+function createAskUserTool() {
+    return {
+        name: '__ask_user__',
+        description: `Ask the user a clarifying question when you need more information.
+
+Usage:
+- Use when requirements are ambiguous
+- Use when you need the user to make a decision
+- Use when you need specific information to proceed
+
+Examples:
+- { "question": "Which database should I use?", "options": ["PostgreSQL", "MySQL", "MongoDB"] }
+- { "question": "What is the target directory for the output files?" }`,
+        parameters: {
+            type: 'object',
+            properties: {
+                question: {
+                    type: 'string',
+                    description: 'The question to ask the user'
+                },
+                options: {
+                    type: 'string',
+                    description: 'Optional array of choices for the user'
+                }
+            },
+            required: ['question']
+        },
+        execute: async () => {
+            // This tool is handled specially in the executor
+            return { success: true, data: 'Question sent to user' };
+        }
+    };
+}
+/**
+ * Create the __task__ tool for spawning sub-agents
+ */
+function createTaskTool(hive, agents) {
+    const agentNames = agents.map(a => a.name);
+    const agentList = buildAgentListSection(agents);
+    return {
+        name: '__task__',
+        description: `Spawn a sub-agent to handle a specific task.
+${agentList}
+
+Usage:
+- Use sub-agents for specialized tasks
+- Provide a clear, specific prompt for the task
+- The sub-agent will return its result`,
+        parameters: {
+            type: 'object',
+            properties: {
+                agent: {
+                    type: 'string',
+                    enum: agentNames,
+                    description: 'Which agent to spawn'
+                },
+                prompt: {
+                    type: 'string',
+                    description: 'The task for the agent to perform'
+                }
+            },
+            required: ['agent', 'prompt']
+        },
+        execute: async (params) => {
+            const { agent: agentName, prompt } = params;
+            const agentConfig = agents.find(a => a.name === agentName);
+            if (!agentConfig) {
+                return { success: false, error: `Unknown agent: ${agentName}` };
+            }
+            // Log sub-agent start
+            hive.config.logger?.info(`[Sub-Agent: ${agentName}] Starting...`);
+            hive.config.logger?.info(`[Sub-Agent: ${agentName}] Task: ${prompt.slice(0, 100)}${prompt.length > 100 ? '...' : ''}`);
+            // Progress: sub-agent starting
+            hive.config.logger?.onProgress?.({
+                type: 'sub_agent_start',
+                message: `Starting ${agentName}...`,
+                details: { agentName }
+            });
+            try {
+                // Create a wrapper logger that prefixes sub-agent logs
+                const subLogger = hive.config.logger ? {
+                    ...hive.config.logger,
+                    debug: (msg, data) => hive.config.logger?.debug(`[${agentName}] ${msg}`, data),
+                    info: (msg, data) => hive.config.logger?.info(`[${agentName}] ${msg}`, data),
+                    warn: (msg, data) => hive.config.logger?.warn(`[${agentName}] ${msg}`, data),
+                    error: (msg, data) => hive.config.logger?.error(`[${agentName}] ${msg}`, data),
+                    onToolCall: (toolName, params) => {
+                        hive.config.logger?.info(`[${agentName}] Tool: ${toolName}`);
+                        hive.config.logger?.onToolCall?.(toolName, params);
+                    },
+                    onToolResult: (toolName, result, durationMs) => {
+                        const status = result.success ? 'OK' : 'ERROR';
+                        hive.config.logger?.info(`[${agentName}] Tool ${toolName}: ${status} (${durationMs}ms)`);
+                        hive.config.logger?.onToolResult?.(toolName, result, durationMs);
+                    },
+                    onProgress: (update) => {
+                        // Prefix sub-agent progress messages
+                        hive.config.logger?.onProgress?.({
+                            ...update,
+                            message: `[${agentName}] ${update.message}`
+                        });
+                    }
+                } : undefined;
+                // Use agent-specific LLM/model or fall back to parent's
+                const subLlm = agentConfig.llm || hive.config.llm;
+                const subHive = new Hive({
+                    systemPrompt: agentConfig.systemPrompt,
+                    tools: agentConfig.tools,
+                    llm: subLlm,
+                    logger: subLogger,
+                    maxIterations: agentConfig.maxIterations || hive.config.maxIterations,
+                    thinkingMode: hive.config.thinkingMode,
+                    thinkingBudget: hive.config.thinkingBudget,
+                    disableAskUser: true // Sub-agents return questions as text, not via __ask_user__
+                });
+                const result = await subHive.run(prompt);
+                // Log sub-agent completion
+                hive.config.logger?.info(`[Sub-Agent: ${agentName}] Completed (${result.toolCalls.length} tool calls)`);
+                // Progress: sub-agent completed
+                hive.config.logger?.onProgress?.({
+                    type: 'sub_agent_end',
+                    message: `${agentName} completed`,
+                    details: { agentName, success: true }
+                });
+                if (result.status === 'needs_input') {
+                    return {
+                        success: false,
+                        error: 'Sub-agent needs user input',
+                        data: result.pendingQuestion
+                    };
+                }
+                return { success: true, data: result.response };
+            }
+            catch (error) {
+                hive.config.logger?.error(`[Sub-Agent: ${agentName}] Failed: ${error instanceof Error ? error.message : String(error)}`);
+                // Progress: sub-agent failed
+                hive.config.logger?.onProgress?.({
+                    type: 'sub_agent_end',
+                    message: `${agentName} failed`,
+                    details: { agentName, success: false }
+                });
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : String(error)
+                };
+            }
+        }
+    };
+}
+/**
+ * Hive Agent Class
+ */
+export class Hive {
+    config;
+    contextManager;
+    tools;
+    constructor(config) {
+        this.config = {
+            maxIterations: 50,
+            maxContextTokens: 100000,
+            contextStrategy: 'truncate_old',
+            ...config
+        };
+        this.contextManager = new ContextManager(this.config.maxContextTokens, this.config.contextStrategy);
+        // Build tools list with internal tools (todo tool added per-run)
+        this.tools = [...config.tools];
+        // Add __ask_user__ tool unless disabled (sub-agents shouldn't use it)
+        if (!config.disableAskUser) {
+            this.tools.push(createAskUserTool());
+        }
+        // Add __task__ tool if sub-agents are defined
+        if (config.agents && config.agents.length > 0) {
+            this.tools.push(createTaskTool(this, config.agents));
+        }
+    }
+    /**
+     * Get tools including internal tools for a specific run
+     */
+    getRunTools(todoManager, reviewManager) {
+        const tools = [
+            ...this.tools,
+            createTodoTool(todoManager)
+        ];
+        if (reviewManager?.isEnabled()) {
+            tools.push(createReviewTool(reviewManager));
+        }
+        return tools;
+    }
+    /**
+     * Run the agent with a user message
+     */
+    async run(message, options = {}) {
+        const { conversationId, userId, metadata, history: providedHistory, signal, shouldContinue } = options;
+        // Load history from repository or use provided
+        let history = [];
+        if (providedHistory) {
+            history = providedHistory;
+        }
+        else if (conversationId && this.config.repository) {
+            history = await this.config.repository.getHistory(conversationId);
+        }
+        // Check if last message was an __ask_user__ tool call (needs tool_result)
+        const messages = [...history];
+        const lastMessage = messages[messages.length - 1];
+        if (lastMessage?.role === 'assistant' && Array.isArray(lastMessage.content)) {
+            const askUserToolUse = lastMessage.content.find((block) => block.type === 'tool_use' && block.name === '__ask_user__');
+            if (askUserToolUse) {
+                // Add tool_result for the __ask_user__ call with user's response
+                messages.push({
+                    role: 'user',
+                    content: [{
+                            type: 'tool_result',
+                            tool_use_id: askUserToolUse.id,
+                            content: JSON.stringify({ success: true, data: { answer: message } })
+                        }]
+                });
+            }
+            else {
+                // Normal user message
+                messages.push({ role: 'user', content: message });
+            }
+        }
+        else {
+            // Normal user message
+            messages.push({ role: 'user', content: message });
+        }
+        // Create todo manager for this run
+        const todoManager = new TodoManager();
+        // Create review manager if review is configured
+        const reviewManager = this.config.review
+            ? new ReviewManager(this.config.review)
+            : undefined;
+        // Create tool context
+        const toolContext = {
+            remainingTokens: this.contextManager.getRemainingTokens(),
+            conversationId,
+            userId,
+            metadata
+        };
+        // Execute the agent loop
+        const result = await executeLoop({
+            systemPrompt: this.config.systemPrompt,
+            tools: this.getRunTools(todoManager, reviewManager),
+            llm: this.config.llm,
+            logger: this.config.logger,
+            maxIterations: this.config.maxIterations,
+            contextManager: this.contextManager,
+            todoManager,
+            reviewManager,
+            llmOptions: {
+                thinkingMode: this.config.thinkingMode,
+                thinkingBudget: this.config.thinkingBudget
+            },
+            signal,
+            shouldContinue
+        }, messages, toolContext);
+        // Save history to repository
+        if (conversationId && this.config.repository) {
+            await this.config.repository.saveHistory(conversationId, result.history);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Context Management
+ *
+ * Token estimation and context management utilities.
+ */
+import type { Message, ContentBlock, ContextStrategy } from './types.js';
+/**
+ * Estimate token count from text (approximately 4 chars per token)
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Estimate tokens for a message
+ */
+export declare function estimateMessageTokens(message: Message): number;
+/**
+ * Estimate tokens for a content block
+ */
+export declare function estimateContentBlockTokens(block: ContentBlock): number;
+/**
+ * Estimate total tokens for all messages
+ */
+export declare function estimateTotalTokens(messages: Message[]): number;
+/**
+ * Truncate old messages to fit within token limit
+ */
+export declare function truncateOldMessages(messages: Message[], maxTokens: number, preserveFirst?: number): Message[];
+/**
+ * Context manager for tracking token usage during execution
+ */
+export declare class ContextManager {
+    private maxTokens;
+    private strategy;
+    private currentTokens;
+    constructor(maxTokens?: number, strategy?: ContextStrategy);
+    /**
+     * Update current token count
+     */
+    updateTokenCount(messages: Message[]): void;
+    /**
+     * Get remaining tokens available
+     */
+    getRemainingTokens(): number;
+    /**
+     * Check if context is within limits
+     */
+    isWithinLimits(): boolean;
+    /**
+     * Manage context according to strategy
+     */
+    manageContext(messages: Message[]): Message[];
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAExE;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAQ9D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAatE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAU,GACxB,OAAO,EAAE,CA2BX;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,aAAa,CAAY;gBAErB,SAAS,GAAE,MAAe,EAAE,QAAQ,GAAE,eAAgC;IAKlF;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAI3C;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE;CAmB9C"}

package/dist/context.js

@@ -0,0 +1,124 @@
+/**
+ * Context Management
+ *
+ * Token estimation and context management utilities.
+ */
+/**
+ * Estimate token count from text (approximately 4 chars per token)
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Estimate tokens for a message
+ */
+export function estimateMessageTokens(message) {
+    if (typeof message.content === 'string') {
+        return estimateTokens(message.content);
+    }
+    return message.content.reduce((sum, block) => {
+        return sum + estimateContentBlockTokens(block);
+    }, 0);
+}
+/**
+ * Estimate tokens for a content block
+ */
+export function estimateContentBlockTokens(block) {
+    switch (block.type) {
+        case 'text':
+            return estimateTokens(block.text);
+        case 'thinking':
+            return estimateTokens(block.thinking);
+        case 'tool_use':
+            return estimateTokens(block.name) + estimateTokens(JSON.stringify(block.input));
+        case 'tool_result':
+            return estimateTokens(block.content);
+        default:
+            return 0;
+    }
+}
+/**
+ * Estimate total tokens for all messages
+ */
+export function estimateTotalTokens(messages) {
+    return messages.reduce((sum, msg) => sum + estimateMessageTokens(msg), 0);
+}
+/**
+ * Truncate old messages to fit within token limit
+ */
+export function truncateOldMessages(messages, maxTokens, preserveFirst = 1) {
+    if (messages.length <= preserveFirst) {
+        return messages;
+    }
+    const result = [];
+    let totalTokens = 0;
+    // Always preserve first N messages (usually system context)
+    for (let i = 0; i < preserveFirst && i < messages.length; i++) {
+        result.push(messages[i]);
+        totalTokens += estimateMessageTokens(messages[i]);
+    }
+    // Add messages from the end until we hit the limit
+    const remaining = [];
+    for (let i = messages.length - 1; i >= preserveFirst; i--) {
+        const msgTokens = estimateMessageTokens(messages[i]);
+        if (totalTokens + msgTokens <= maxTokens) {
+            remaining.unshift(messages[i]);
+            totalTokens += msgTokens;
+        }
+        else {
+            break;
+        }
+    }
+    return [...result, ...remaining];
+}
+/**
+ * Context manager for tracking token usage during execution
+ */
+export class ContextManager {
+    maxTokens;
+    strategy;
+    currentTokens = 0;
+    constructor(maxTokens = 100000, strategy = 'truncate_old') {
+        this.maxTokens = maxTokens;
+        this.strategy = strategy;
+    }
+    /**
+     * Update current token count
+     */
+    updateTokenCount(messages) {
+        this.currentTokens = estimateTotalTokens(messages);
+    }
+    /**
+     * Get remaining tokens available
+     */
+    getRemainingTokens() {
+        return Math.max(0, this.maxTokens - this.currentTokens);
+    }
+    /**
+     * Check if context is within limits
+     */
+    isWithinLimits() {
+        return this.currentTokens <= this.maxTokens;
+    }
+    /**
+     * Manage context according to strategy
+     */
+    manageContext(messages) {
+        this.updateTokenCount(messages);
+        if (this.isWithinLimits()) {
+            return messages;
+        }
+        switch (this.strategy) {
+            case 'truncate_old':
+                return truncateOldMessages(messages, this.maxTokens);
+            case 'summarize':
+                // Summarization would require LLM call - for now, fall back to truncation
+                return truncateOldMessages(messages, this.maxTokens);
+            case 'error':
+                throw new Error(`Context limit exceeded: ${this.currentTokens} > ${this.maxTokens} tokens`);
+            default:
+                return messages;
+        }
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/executor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Executor - Tool Execution Loop
+ *
+ * Core execution loop that runs tools and handles agent responses.
+ */
+import type { Message, Tool, ToolContext, LLMProvider, LLMOptions, LogProvider, AgentResult } from './types.js';
+import { ContextManager } from './context.js';
+import { TodoManager } from './todo.js';
+import { ReviewManager } from './review.js';
+export interface ExecutorConfig {
+    systemPrompt: string;
+    tools: Tool[];
+    llm: LLMProvider;
+    logger?: LogProvider;
+    maxIterations: number;
+    contextManager: ContextManager;
+    todoManager: TodoManager;
+    reviewManager?: ReviewManager;
+    llmOptions?: LLMOptions;
+    /** AbortSignal for cancellation */
+    signal?: AbortSignal;
+    /** Async function to check if should continue */
+    shouldContinue?: () => Promise<boolean>;
+}
+/**
+ * Main execution loop
+ */
+export declare function executeLoop(config: ExecutorConfig, initialMessages: Message[], toolContext: ToolContext): Promise<AgentResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,IAAI,EAIJ,WAAW,EAIX,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EAEZ,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAI3C,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,GAAG,EAAE,WAAW,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,cAAc,CAAA;IAC9B,WAAW,EAAE,WAAW,CAAA;IACxB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,UAAU,CAAC,EAAE,UAAU,CAAA;IAEvB,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAA;IAEpB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CACxC;AAkOD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,eAAe,EAAE,OAAO,EAAE,EAC1B,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,WAAW,CAAC,CAuOtB"}