@push.rocks/smartagent 1.0.2

package/dist_ts/smartagent.classes.smartagent.d.ts

@@ -0,0 +1,123 @@
+import * as plugins from './plugins.js';
+/**
+ * Configuration options for SmartAgent
+ */
+export interface ISmartAgentOptions extends plugins.smartai.ISmartAiOptions {
+    /** Name of the agent for identification */
+    name?: string;
+    /** Default provider to use for agent operations */
+    defaultProvider?: plugins.smartai.TProvider;
+    /** System message that defines the agent's behavior */
+    systemMessage?: string;
+    /** Maximum number of reasoning steps before forcing completion */
+    maxIterations?: number;
+}
+/**
+ * Represents a tool that an agent can use
+ */
+export interface IAgentTool {
+    /** Unique name for the tool */
+    name: string;
+    /** Description of what the tool does (used by the AI to decide when to use it) */
+    description: string;
+    /** JSON schema defining the tool's parameters */
+    parameters: Record<string, unknown>;
+    /** The function to execute when the tool is called */
+    execute: (params: Record<string, unknown>) => Promise<unknown>;
+}
+/**
+ * Represents a message in the agent's conversation history
+ */
+export interface IAgentMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    toolName?: string;
+    toolResult?: unknown;
+}
+/**
+ * Result of an agent run
+ */
+export interface IAgentRunResult {
+    /** The final response from the agent */
+    response: string;
+    /** Number of iterations the agent took */
+    iterations: number;
+    /** Full message history from this run */
+    messages: IAgentMessage[];
+    /** Whether the agent completed successfully or hit max iterations */
+    completed: boolean;
+}
+/**
+ * SmartAgent - An agentic framework built on top of @push.rocks/smartai
+ *
+ * Provides autonomous agent capabilities including:
+ * - Tool use and function calling
+ * - Multi-step reasoning
+ * - Conversation memory
+ * - Multiple AI provider support
+ */
+export declare class SmartAgent {
+    options: ISmartAgentOptions;
+    smartai: plugins.smartai.SmartAi;
+    tools: Map<string, IAgentTool>;
+    messageHistory: IAgentMessage[];
+    private isStarted;
+    constructor(optionsArg: ISmartAgentOptions);
+    /**
+     * Starts the agent and initializes the underlying SmartAi instance
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the agent and cleans up resources
+     */
+    stop(): Promise<void>;
+    /**
+     * Registers a tool that the agent can use
+     */
+    registerTool(tool: IAgentTool): void;
+    /**
+     * Removes a tool from the agent
+     */
+    unregisterTool(toolName: string): void;
+    /**
+     * Gets all registered tools
+     */
+    getTools(): IAgentTool[];
+    /**
+     * Sets or updates the system message
+     */
+    setSystemMessage(message: string): void;
+    /**
+     * Clears the conversation history (except system message)
+     */
+    clearHistory(): void;
+    /**
+     * Runs the agent with a user message
+     * The agent will reason, use tools, and respond autonomously
+     */
+    run(userMessage: string): Promise<IAgentRunResult>;
+    /**
+     * Simple chat without tool use
+     */
+    chat(message: string): Promise<string>;
+    /**
+     * Gets the AI provider based on configuration
+     */
+    private getProvider;
+    /**
+     * Builds tool descriptions for the system prompt
+     */
+    private buildToolDescriptions;
+    /**
+     * Builds the system prompt including tool descriptions
+     */
+    private buildSystemPrompt;
+    /**
+     * Builds the contextual prompt from message history
+     */
+    private buildContextualPrompt;
+    /**
+     * Parses a tool call from the AI response
+     */
+    private parseToolCall;
+}

package/dist_ts/smartagent.classes.smartagent.js

@@ -0,0 +1,274 @@
+import * as plugins from './plugins.js';
+/**
+ * SmartAgent - An agentic framework built on top of @push.rocks/smartai
+ *
+ * Provides autonomous agent capabilities including:
+ * - Tool use and function calling
+ * - Multi-step reasoning
+ * - Conversation memory
+ * - Multiple AI provider support
+ */
+export class SmartAgent {
+    options;
+    smartai;
+    tools = new Map();
+    messageHistory = [];
+    isStarted = false;
+    constructor(optionsArg) {
+        this.options = {
+            name: 'SmartAgent',
+            defaultProvider: 'openai',
+            maxIterations: 10,
+            ...optionsArg,
+        };
+        this.smartai = new plugins.smartai.SmartAi(this.options);
+        if (this.options.systemMessage) {
+            this.messageHistory.push({
+                role: 'system',
+                content: this.options.systemMessage,
+            });
+        }
+    }
+    /**
+     * Starts the agent and initializes the underlying SmartAi instance
+     */
+    async start() {
+        if (this.isStarted)
+            return;
+        await this.smartai.start();
+        this.isStarted = true;
+    }
+    /**
+     * Stops the agent and cleans up resources
+     */
+    async stop() {
+        if (!this.isStarted)
+            return;
+        await this.smartai.stop();
+        this.isStarted = false;
+    }
+    /**
+     * Registers a tool that the agent can use
+     */
+    registerTool(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    /**
+     * Removes a tool from the agent
+     */
+    unregisterTool(toolName) {
+        this.tools.delete(toolName);
+    }
+    /**
+     * Gets all registered tools
+     */
+    getTools() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Sets or updates the system message
+     */
+    setSystemMessage(message) {
+        const existingIndex = this.messageHistory.findIndex(m => m.role === 'system');
+        if (existingIndex >= 0) {
+            this.messageHistory[existingIndex].content = message;
+        }
+        else {
+            this.messageHistory.unshift({
+                role: 'system',
+                content: message,
+            });
+        }
+    }
+    /**
+     * Clears the conversation history (except system message)
+     */
+    clearHistory() {
+        this.messageHistory = this.messageHistory.filter(m => m.role === 'system');
+    }
+    /**
+     * Runs the agent with a user message
+     * The agent will reason, use tools, and respond autonomously
+     */
+    async run(userMessage) {
+        if (!this.isStarted) {
+            await this.start();
+        }
+        // Add user message to history
+        this.messageHistory.push({
+            role: 'user',
+            content: userMessage,
+        });
+        let iterations = 0;
+        let completed = false;
+        let response = '';
+        while (iterations < (this.options.maxIterations || 10) && !completed) {
+            iterations++;
+            // Build the prompt with tool descriptions if tools are available
+            const toolDescriptions = this.buildToolDescriptions();
+            const systemPrompt = this.buildSystemPrompt(toolDescriptions);
+            // Get response from AI
+            const provider = this.getProvider();
+            const chatResponse = await provider.chat({
+                systemMessage: systemPrompt,
+                userMessage: this.buildContextualPrompt(),
+                messageHistory: [],
+            });
+            response = chatResponse.message;
+            // Check if the response contains a tool call
+            const toolCall = this.parseToolCall(response);
+            if (toolCall) {
+                // Execute the tool
+                const tool = this.tools.get(toolCall.name);
+                if (tool) {
+                    try {
+                        const toolResult = await tool.execute(toolCall.params);
+                        // Add tool interaction to history
+                        this.messageHistory.push({
+                            role: 'assistant',
+                            content: response,
+                        });
+                        this.messageHistory.push({
+                            role: 'tool',
+                            content: JSON.stringify(toolResult),
+                            toolName: toolCall.name,
+                            toolResult,
+                        });
+                    }
+                    catch (error) {
+                        // Add error to history
+                        this.messageHistory.push({
+                            role: 'tool',
+                            content: `Error executing tool ${toolCall.name}: ${error}`,
+                            toolName: toolCall.name,
+                        });
+                    }
+                }
+                else {
+                    // Unknown tool
+                    this.messageHistory.push({
+                        role: 'tool',
+                        content: `Unknown tool: ${toolCall.name}`,
+                        toolName: toolCall.name,
+                    });
+                }
+            }
+            else {
+                // No tool call, this is the final response
+                this.messageHistory.push({
+                    role: 'assistant',
+                    content: response,
+                });
+                completed = true;
+            }
+        }
+        return {
+            response,
+            iterations,
+            messages: [...this.messageHistory],
+            completed,
+        };
+    }
+    /**
+     * Simple chat without tool use
+     */
+    async chat(message) {
+        if (!this.isStarted) {
+            await this.start();
+        }
+        const systemMessage = this.messageHistory.find(m => m.role === 'system')?.content || 'You are a helpful assistant.';
+        const provider = this.getProvider();
+        const response = await provider.chat({
+            systemMessage,
+            userMessage: message,
+            messageHistory: this.messageHistory
+                .filter(m => m.role !== 'system')
+                .map(m => ({
+                role: m.role === 'tool' ? 'user' : m.role,
+                content: m.content,
+            })),
+        });
+        this.messageHistory.push({ role: 'user', content: message });
+        this.messageHistory.push({ role: 'assistant', content: response.message });
+        return response.message;
+    }
+    /**
+     * Gets the AI provider based on configuration
+     */
+    getProvider() {
+        const providerName = this.options.defaultProvider || 'openai';
+        switch (providerName) {
+            case 'openai':
+                return this.smartai.openaiProvider;
+            case 'anthropic':
+                return this.smartai.anthropicProvider;
+            case 'perplexity':
+                return this.smartai.perplexityProvider;
+            case 'groq':
+                return this.smartai.groqProvider;
+            case 'ollama':
+                return this.smartai.ollamaProvider;
+            case 'xai':
+                return this.smartai.xaiProvider;
+            case 'exo':
+                return this.smartai.exoProvider;
+            default:
+                return this.smartai.openaiProvider;
+        }
+    }
+    /**
+     * Builds tool descriptions for the system prompt
+     */
+    buildToolDescriptions() {
+        if (this.tools.size === 0)
+            return '';
+        const toolList = Array.from(this.tools.values())
+            .map(tool => `- ${tool.name}: ${tool.description}\n  Parameters: ${JSON.stringify(tool.parameters)}`)
+            .join('\n');
+        return `\nYou have access to the following tools:\n${toolList}\n\nTo use a tool, respond with:\n<tool_call>\n{"name": "tool_name", "params": {...}}\n</tool_call>\n\nAfter receiving the tool result, continue your reasoning or provide a final response.`;
+    }
+    /**
+     * Builds the system prompt including tool descriptions
+     */
+    buildSystemPrompt(toolDescriptions) {
+        const baseSystemMessage = this.messageHistory.find(m => m.role === 'system')?.content ||
+            'You are a helpful AI assistant.';
+        return baseSystemMessage + toolDescriptions;
+    }
+    /**
+     * Builds the contextual prompt from message history
+     */
+    buildContextualPrompt() {
+        return this.messageHistory
+            .filter(m => m.role !== 'system')
+            .map(m => {
+            if (m.role === 'tool') {
+                return `[Tool Result from ${m.toolName}]: ${m.content}`;
+            }
+            return `[${m.role}]: ${m.content}`;
+        })
+            .join('\n\n');
+    }
+    /**
+     * Parses a tool call from the AI response
+     */
+    parseToolCall(response) {
+        const toolCallMatch = response.match(/<tool_call>\s*(\{[\s\S]*?\})\s*<\/tool_call>/);
+        if (!toolCallMatch)
+            return null;
+        try {
+            const parsed = JSON.parse(toolCallMatch[1]);
+            if (parsed.name && typeof parsed.name === 'string') {
+                return {
+                    name: parsed.name,
+                    params: parsed.params || {},
+                };
+            }
+        }
+        catch {
+            return null;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC5jbGFzc2VzLnNtYXJ0YWdlbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9zbWFydGFnZW50LmNsYXNzZXMuc21hcnRhZ2VudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQXNEeEM7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFNLE9BQU8sVUFBVTtJQUNkLE9BQU8sQ0FBcUI7SUFDNUIsT0FBTyxDQUEwQjtJQUNqQyxLQUFLLEdBQTRCLElBQUksR0FBRyxFQUFFLENBQUM7SUFDM0MsY0FBYyxHQUFvQixFQUFFLENBQUM7SUFFcEMsU0FBUyxHQUFHLEtBQUssQ0FBQztJQUUxQixZQUFZLFVBQThCO1FBQ3hDLElBQUksQ0FBQyxPQUFPLEdBQUc7WUFDYixJQUFJLEVBQUUsWUFBWTtZQUNsQixlQUFlLEVBQUUsUUFBUTtZQUN6QixhQUFhLEVBQUUsRUFBRTtZQUNqQixHQUFHLFVBQVU7U0FDZCxDQUFDO1FBRUYsSUFBSSxDQUFDLE9BQU8sR0FBRyxJQUFJLE9BQU8sQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUV6RCxJQUFJLElBQUksQ0FBQyxPQUFPLENBQUMsYUFBYSxFQUFFLENBQUM7WUFDL0IsSUFBSSxDQUFDLGNBQWMsQ0FBQyxJQUFJLENBQUM7Z0JBQ3ZCLElBQUksRUFBRSxRQUFRO2dCQUNkLE9BQU8sRUFBRSxJQUFJLENBQUMsT0FBTyxDQUFDLGFBQWE7YUFDcEMsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztJQUNILENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxLQUFLO1FBQ2hCLElBQUksSUFBSSxDQUFDLFNBQVM7WUFBRSxPQUFPO1FBQzNCLE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUMzQixJQUFJLENBQUMsU0FBUyxHQUFHLElBQUksQ0FBQztJQUN4QixDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsSUFBSTtRQUNmLElBQUksQ0FBQyxJQUFJLENBQUMsU0FBUztZQUFFLE9BQU87UUFDNUIsTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxDQUFDO1FBQzFCLElBQUksQ0FBQyxTQUFTLEdBQUcsS0FBSyxDQUFDO0lBQ3pCLENBQUM7SUFFRDs7T0FFRztJQUNJLFlBQVksQ0FBQyxJQUFnQjtRQUNsQyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxDQUFDO0lBQ2xDLENBQUM7SUFFRDs7T0FFRztJQUNJLGNBQWMsQ0FBQyxRQUFnQjtRQUNwQyxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUM5QixDQUFDO0lBRUQ7O09BRUc7SUFDSSxRQUFRO1FBQ2IsT0FBTyxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQztJQUN6QyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxnQkFBZ0IsQ0FBQyxPQUFlO1FBQ3JDLE1BQU0sYUFBYSxHQUFHLElBQUksQ0FBQyxjQUFjLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLElBQUksS0FBSyxRQUFRLENBQUMsQ0FBQztRQUM5RSxJQUFJLGFBQWEsSUFBSSxDQUFDLEVBQUUsQ0FBQztZQUN2QixJQUFJLENBQUMsY0FBYyxDQUFDLGFBQWEsQ0FBQyxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUM7UUFDdkQsQ0FBQzthQUFNLENBQUM7WUFDTixJQUFJLENBQUMsY0FBYyxDQUFDLE9BQU8sQ0FBQztnQkFDMUIsSUFBSSxFQUFFLFFBQVE7Z0JBQ2QsT0FBTyxFQUFFLE9BQU87YUFDakIsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztJQUNILENBQUM7SUFFRDs7T0FFRztJQUNJLFlBQVk7UUFDakIsSUFBSSxDQUFDLGNBQWMsR0FBRyxJQUFJLENBQUMsY0FBYyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLEtBQUssUUFBUSxDQUFDLENBQUM7SUFDN0UsQ0FBQztJQUVEOzs7T0FHRztJQUNJLEtBQUssQ0FBQyxHQUFHLENBQUMsV0FBbUI7UUFDbEMsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUNwQixNQUFNLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUNyQixDQUFDO1FBRUQsOEJBQThCO1FBQzlCLElBQUksQ0FBQyxjQUFjLENBQUMsSUFBSSxDQUFDO1lBQ3ZCLElBQUksRUFBRSxNQUFNO1lBQ1osT0FBTyxFQUFFLFdBQVc7U0FDckIsQ0FBQyxDQUFDO1FBRUgsSUFBSSxVQUFVLEdBQUcsQ0FBQyxDQUFDO1FBQ25CLElBQUksU0FBUyxHQUFHLEtBQUssQ0FBQztRQUN0QixJQUFJLFFBQVEsR0FBRyxFQUFFLENBQUM7UUFFbEIsT0FBTyxVQUFVLEdBQUcsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLGFBQWEsSUFBSSxFQUFFLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQ3JFLFVBQVUsRUFBRSxDQUFDO1lBRWIsaUVBQWlFO1lBQ2pFLE1BQU0sZ0JBQWdCLEdBQUcsSUFBSSxDQUFDLHFCQUFxQixFQUFFLENBQUM7WUFDdEQsTUFBTSxZQUFZLEdBQUcsSUFBSSxDQUFDLGlCQUFpQixDQUFDLGdCQUFnQixDQUFDLENBQUM7WUFFOUQsdUJBQXVCO1lBQ3ZCLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUNwQyxNQUFNLFlBQVksR0FBRyxNQUFNLFFBQVEsQ0FBQyxJQUFJLENBQUM7Z0JBQ3ZDLGFBQWEsRUFBRSxZQUFZO2dCQUMzQixXQUFXLEVBQUUsSUFBSSxDQUFDLHFCQUFxQixFQUFFO2dCQUN6QyxjQUFjLEVBQUUsRUFBRTthQUNuQixDQUFDLENBQUM7WUFFSCxRQUFRLEdBQUcsWUFBWSxDQUFDLE9BQU8sQ0FBQztZQUVoQyw2Q0FBNkM7WUFDN0MsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLGFBQWEsQ0FBQyxRQUFRLENBQUMsQ0FBQztZQUU5QyxJQUFJLFFBQVEsRUFBRSxDQUFDO2dCQUNiLG1CQUFtQjtnQkFDbkIsTUFBTSxJQUFJLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxDQUFDO2dCQUMzQyxJQUFJLElBQUksRUFBRSxDQUFDO29CQUNULElBQUksQ0FBQzt3QkFDSCxNQUFNLFVBQVUsR0FBRyxNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxDQUFDO3dCQUV2RCxrQ0FBa0M7d0JBQ2xDLElBQUksQ0FBQyxjQUFjLENBQUMsSUFBSSxDQUFDOzRCQUN2QixJQUFJLEVBQUUsV0FBVzs0QkFDakIsT0FBTyxFQUFFLFFBQVE7eUJBQ2xCLENBQUMsQ0FBQzt3QkFDSCxJQUFJLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQzs0QkFDdkIsSUFBSSxFQUFFLE1BQU07NEJBQ1osT0FBTyxFQUFFLElBQUksQ0FBQyxTQUFTLENBQUMsVUFBVSxDQUFDOzRCQUNuQyxRQUFRLEVBQUUsUUFBUSxDQUFDLElBQUk7NEJBQ3ZCLFVBQVU7eUJBQ1gsQ0FBQyxDQUFDO29CQUNMLENBQUM7b0JBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQzt3QkFDZix1QkFBdUI7d0JBQ3ZCLElBQUksQ0FBQyxjQUFjLENBQUMsSUFBSSxDQUFDOzRCQUN2QixJQUFJLEVBQUUsTUFBTTs0QkFDWixPQUFPLEVBQUUsd0JBQXdCLFFBQVEsQ0FBQyxJQUFJLEtBQUssS0FBSyxFQUFFOzRCQUMxRCxRQUFRLEVBQUUsUUFBUSxDQUFDLElBQUk7eUJBQ3hCLENBQUMsQ0FBQztvQkFDTCxDQUFDO2dCQUNILENBQUM7cUJBQU0sQ0FBQztvQkFDTixlQUFlO29CQUNmLElBQUksQ0FBQyxjQUFjLENBQUMsSUFBSSxDQUFDO3dCQUN2QixJQUFJLEVBQUUsTUFBTTt3QkFDWixPQUFPLEVBQUUsaUJBQWlCLFFBQVEsQ0FBQyxJQUFJLEVBQUU7d0JBQ3pDLFFBQVEsRUFBRSxRQUFRLENBQUMsSUFBSTtxQkFDeEIsQ0FBQyxDQUFDO2dCQUNMLENBQUM7WUFDSCxDQUFDO2lCQUFNLENBQUM7Z0JBQ04sMkNBQTJDO2dCQUMzQyxJQUFJLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQztvQkFDdkIsSUFBSSxFQUFFLFdBQVc7b0JBQ2pCLE9BQU8sRUFBRSxRQUFRO2lCQUNsQixDQUFDLENBQUM7Z0JBQ0gsU0FBUyxHQUFHLElBQUksQ0FBQztZQUNuQixDQUFDO1FBQ0gsQ0FBQztRQUVELE9BQU87WUFDTCxRQUFRO1lBQ1IsVUFBVTtZQUNWLFFBQVEsRUFBRSxDQUFDLEdBQUcsSUFBSSxDQUFDLGNBQWMsQ0FBQztZQUNsQyxTQUFTO1NBQ1YsQ0FBQztJQUNKLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxJQUFJLENBQUMsT0FBZTtRQUMvQixJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQ3BCLE1BQU0sSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ3JCLENBQUM7UUFFRCxNQUFNLGFBQWEsR0FBRyxJQUFJLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLEtBQUssUUFBUSxDQUFDLEVBQUUsT0FBTyxJQUFJLDhCQUE4QixDQUFDO1FBRXBILE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztRQUNwQyxNQUFNLFFBQVEsR0FBRyxNQUFNLFFBQVEsQ0FBQyxJQUFJLENBQUM7WUFDbkMsYUFBYTtZQUNiLFdBQVcsRUFBRSxPQUFPO1lBQ3BCLGNBQWMsRUFBRSxJQUFJLENBQUMsY0FBYztpQkFDaEMsTUFBTSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLElBQUksS0FBSyxRQUFRLENBQUM7aUJBQ2hDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUM7Z0JBQ1QsSUFBSSxFQUFFLENBQUMsQ0FBQyxJQUFJLEtBQUssTUFBTSxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUE0QjtnQkFDakUsT0FBTyxFQUFFLENBQUMsQ0FBQyxPQUFPO2FBQ25CLENBQUMsQ0FBQztTQUNOLENBQUMsQ0FBQztRQUVILElBQUksQ0FBQyxjQUFjLENBQUMsSUFBSSxDQUFDLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLENBQUMsQ0FBQztRQUM3RCxJQUFJLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQyxFQUFFLElBQUksRUFBRSxXQUFXLEVBQUUsT0FBTyxFQUFFLFFBQVEsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDO1FBRTNFLE9BQU8sUUFBUSxDQUFDLE9BQU8sQ0FBQztJQUMxQixDQUFDO0lBRUQ7O09BRUc7SUFDSyxXQUFXO1FBQ2pCLE1BQU0sWUFBWSxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsZUFBZSxJQUFJLFFBQVEsQ0FBQztRQUM5RCxRQUFRLFlBQVksRUFBRSxDQUFDO1lBQ3JCLEtBQUssUUFBUTtnQkFDWCxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsY0FBYyxDQUFDO1lBQ3JDLEtBQUssV0FBVztnQkFDZCxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsaUJBQWlCLENBQUM7WUFDeEMsS0FBSyxZQUFZO2dCQUNmLE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQztZQUN6QyxLQUFLLE1BQU07Z0JBQ1QsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLFlBQVksQ0FBQztZQUNuQyxLQUFLLFFBQVE7Z0JBQ1gsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLGNBQWMsQ0FBQztZQUNyQyxLQUFLLEtBQUs7Z0JBQ1IsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLFdBQVcsQ0FBQztZQUNsQyxLQUFLLEtBQUs7Z0JBQ1IsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLFdBQVcsQ0FBQztZQUNsQztnQkFDRSxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsY0FBYyxDQUFDO1FBQ3ZDLENBQUM7SUFDSCxDQUFDO0lBRUQ7O09BRUc7SUFDSyxxQkFBcUI7UUFDM0IsSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksS0FBSyxDQUFDO1lBQUUsT0FBTyxFQUFFLENBQUM7UUFFckMsTUFBTSxRQUFRLEdBQUcsS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sRUFBRSxDQUFDO2FBQzdDLEdBQUcsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLEtBQUssSUFBSSxDQUFDLElBQUksS0FBSyxJQUFJLENBQUMsV0FBVyxtQkFBbUIsSUFBSSxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQzthQUNwRyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7UUFFZCxPQUFPLDhDQUE4QyxRQUFRLDhMQUE4TCxDQUFDO0lBQzlQLENBQUM7SUFFRDs7T0FFRztJQUNLLGlCQUFpQixDQUFDLGdCQUF3QjtRQUNoRCxNQUFNLGlCQUFpQixHQUFHLElBQUksQ0FBQyxjQUFjLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLElBQUksS0FBSyxRQUFRLENBQUMsRUFBRSxPQUFPO1lBQ25GLGlDQUFpQyxDQUFDO1FBQ3BDLE9BQU8saUJBQWlCLEdBQUcsZ0JBQWdCLENBQUM7SUFDOUMsQ0FBQztJQUVEOztPQUVHO0lBQ0sscUJBQXFCO1FBQzNCLE9BQU8sSUFBSSxDQUFDLGNBQWM7YUFDdkIsTUFBTSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLElBQUksS0FBSyxRQUFRLENBQUM7YUFDaEMsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFO1lBQ1AsSUFBSSxDQUFDLENBQUMsSUFBSSxLQUFLLE1BQU0sRUFBRSxDQUFDO2dCQUN0QixPQUFPLHFCQUFxQixDQUFDLENBQUMsUUFBUSxNQUFNLENBQUMsQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUMxRCxDQUFDO1lBQ0QsT0FBTyxJQUFJLENBQUMsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxDQUFDLE9BQU8sRUFBRSxDQUFDO1FBQ3JDLENBQUMsQ0FBQzthQUNELElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUNsQixDQUFDO0lBRUQ7O09BRUc7SUFDSyxhQUFhLENBQUMsUUFBZ0I7UUFDcEMsTUFBTSxhQUFhLEdBQUcsUUFBUSxDQUFDLEtBQUssQ0FBQyw4Q0FBOEMsQ0FBQyxDQUFDO1FBQ3JGLElBQUksQ0FBQyxhQUFhO1lBQUUsT0FBTyxJQUFJLENBQUM7UUFFaEMsSUFBSSxDQUFDO1lBQ0gsTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUM1QyxJQUFJLE1BQU0sQ0FBQyxJQUFJLElBQUksT0FBTyxNQUFNLENBQUMsSUFBSSxLQUFLLFFBQVEsRUFBRSxDQUFDO2dCQUNuRCxPQUFPO29CQUNMLElBQUksRUFBRSxNQUFNLENBQUMsSUFBSTtvQkFDakIsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNLElBQUksRUFBRTtpQkFDNUIsQ0FBQztZQUNKLENBQUM7UUFDSCxDQUFDO1FBQUMsTUFBTSxDQUFDO1lBQ1AsT0FBTyxJQUFJLENBQUM7UUFDZCxDQUFDO1FBRUQsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0NBQ0YifQ==

package/dist_ts/smartagent.interfaces.d.ts

@@ -0,0 +1,165 @@
+import * as plugins from './plugins.js';
+/**
+ * Configuration options for the DualAgentOrchestrator
+ */
+export interface IDualAgentOptions extends plugins.smartai.ISmartAiOptions {
+    /** Name of the agent system */
+    name?: string;
+    /** Default AI provider for both Driver and Guardian */
+    defaultProvider?: plugins.smartai.TProvider;
+    /** Optional separate provider for Guardian (for cost optimization) */
+    guardianProvider?: plugins.smartai.TProvider;
+    /** System message for the Driver agent */
+    driverSystemMessage?: string;
+    /** Policy prompt for the Guardian agent - REQUIRED */
+    guardianPolicyPrompt: string;
+    /** Maximum iterations for task completion (default: 20) */
+    maxIterations?: number;
+    /** Maximum consecutive rejections before aborting (default: 3) */
+    maxConsecutiveRejections?: number;
+    /** Enable verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Represents a message in the agent's conversation history
+ */
+export interface IAgentMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool' | 'guardian';
+    content: string;
+    toolName?: string;
+    toolResult?: unknown;
+    toolCall?: IToolCallProposal;
+    guardianDecision?: IGuardianDecision;
+    timestamp?: Date;
+}
+/**
+ * Represents an action that a tool can perform
+ */
+export interface IToolAction {
+    /** Action name (e.g., 'read', 'write', 'delete') */
+    name: string;
+    /** Description of what this action does */
+    description: string;
+    /** JSON schema for action parameters */
+    parameters: Record<string, unknown>;
+}
+/**
+ * Proposed tool call from the Driver
+ */
+export interface IToolCallProposal {
+    /** Unique ID for this proposal */
+    proposalId: string;
+    /** Name of the tool */
+    toolName: string;
+    /** Specific action to perform */
+    action: string;
+    /** Parameters for the action */
+    params: Record<string, unknown>;
+    /** Driver's reasoning for this call */
+    reasoning?: string;
+}
+/**
+ * Result of tool execution
+ */
+export interface IToolExecutionResult {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+}
+/**
+ * Base interface for wrapped tools
+ */
+export interface IAgentToolWrapper {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Available actions */
+    actions: IToolAction[];
+    /** Initialize the tool */
+    initialize(): Promise<void>;
+    /** Cleanup resources */
+    cleanup(): Promise<void>;
+    /** Execute an action */
+    execute(action: string, params: Record<string, unknown>): Promise<IToolExecutionResult>;
+    /** Get a summary for Guardian review */
+    getCallSummary(action: string, params: Record<string, unknown>): string;
+}
+/**
+ * Request for Guardian evaluation
+ */
+export interface IGuardianEvaluationRequest {
+    /** The proposed tool call */
+    proposal: IToolCallProposal;
+    /** Current task context */
+    taskContext: string;
+    /** Recent conversation history (last N messages) */
+    recentHistory: IAgentMessage[];
+    /** Summary of what the tool call will do */
+    callSummary: string;
+}
+/**
+ * Guardian's decision
+ */
+export interface IGuardianDecision {
+    /** Approve or reject */
+    decision: 'approve' | 'reject';
+    /** Explanation of the decision */
+    reason: string;
+    /** Specific concerns if rejected */
+    concerns?: string[];
+    /** Suggestions for the Driver if rejected */
+    suggestions?: string;
+    /** Confidence level (0-1) */
+    confidence?: number;
+}
+/**
+ * Log entry for tool executions
+ */
+export interface IToolExecutionLog {
+    timestamp: Date;
+    toolName: string;
+    action: string;
+    params: Record<string, unknown>;
+    guardianDecision: 'approved' | 'rejected';
+    guardianReason: string;
+    executionResult?: unknown;
+    executionError?: string;
+}
+/**
+ * Status of a dual-agent run
+ */
+export type TDualAgentRunStatus = 'completed' | 'in_progress' | 'max_iterations_reached' | 'max_rejections_reached' | 'clarification_needed' | 'error';
+/**
+ * Result of a dual-agent run
+ */
+export interface IDualAgentRunResult {
+    /** Whether the task was successful */
+    success: boolean;
+    /** Whether the task is completed */
+    completed: boolean;
+    /** Final result or response */
+    result: string;
+    /** Total iterations taken */
+    iterations: number;
+    /** Full conversation history */
+    history: IAgentMessage[];
+    /** Current status */
+    status: TDualAgentRunStatus;
+    /** Number of tool calls made */
+    toolCallCount?: number;
+    /** Number of Guardian rejections */
+    rejectionCount?: number;
+    /** Tool execution log */
+    toolLog?: IToolExecutionLog[];
+    /** Error message if status is 'error' */
+    error?: string;
+}
+/**
+ * Available tool names
+ */
+export type TToolName = 'filesystem' | 'http' | 'browser' | 'shell';
+/**
+ * Generate a unique proposal ID
+ */
+export declare function generateProposalId(): string;

package/dist_ts/smartagent.interfaces.js

@@ -0,0 +1,8 @@
+import * as plugins from './plugins.js';
+/**
+ * Generate a unique proposal ID
+ */
+export function generateProposalId() {
+    return `proposal_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC5pbnRlcmZhY2VzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvc21hcnRhZ2VudC5pbnRlcmZhY2VzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBNE14Qzs7R0FFRztBQUNILE1BQU0sVUFBVSxrQkFBa0I7SUFDaEMsT0FBTyxZQUFZLElBQUksQ0FBQyxHQUFHLEVBQUUsSUFBSSxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQztBQUNoRixDQUFDIn0=

package/dist_ts/smartagent.tools.base.d.ts

@@ -0,0 +1,46 @@
+import * as interfaces from './smartagent.interfaces.js';
+/**
+ * Abstract base class for tool wrappers
+ * All tool implementations should extend this class
+ */
+export declare abstract class BaseToolWrapper implements interfaces.IAgentToolWrapper {
+    abstract name: string;
+    abstract description: string;
+    abstract actions: interfaces.IToolAction[];
+    protected isInitialized: boolean;
+    /**
+     * Initialize the tool and any required resources
+     */
+    abstract initialize(): Promise<void>;
+    /**
+     * Cleanup any resources used by the tool
+     */
+    abstract cleanup(): Promise<void>;
+    /**
+     * Execute an action with the given parameters
+     */
+    abstract execute(action: string, params: Record<string, unknown>): Promise<interfaces.IToolExecutionResult>;
+    /**
+     * Generate a human-readable summary of what the action will do
+     * This is used by the Guardian to understand the proposed action
+     */
+    abstract getCallSummary(action: string, params: Record<string, unknown>): string;
+    /**
+     * Validate that an action exists for this tool
+     * @throws Error if the action is not valid
+     */
+    protected validateAction(action: string): void;
+    /**
+     * Check if the tool is initialized
+     */
+    protected ensureInitialized(): void;
+    /**
+     * Get the full tool description including all actions
+     * Used for Driver's tool awareness
+     */
+    getFullDescription(): string;
+    /**
+     * Get the JSON schema for a specific action
+     */
+    getActionSchema(action: string): Record<string, unknown> | undefined;
+}

package/dist_ts/smartagent.tools.base.js

@@ -0,0 +1,45 @@
+import * as interfaces from './smartagent.interfaces.js';
+/**
+ * Abstract base class for tool wrappers
+ * All tool implementations should extend this class
+ */
+export class BaseToolWrapper {
+    isInitialized = false;
+    /**
+     * Validate that an action exists for this tool
+     * @throws Error if the action is not valid
+     */
+    validateAction(action) {
+        const validAction = this.actions.find((a) => a.name === action);
+        if (!validAction) {
+            const availableActions = this.actions.map((a) => a.name).join(', ');
+            throw new Error(`Unknown action "${action}" for tool "${this.name}". Available actions: ${availableActions}`);
+        }
+    }
+    /**
+     * Check if the tool is initialized
+     */
+    ensureInitialized() {
+        if (!this.isInitialized) {
+            throw new Error(`Tool "${this.name}" is not initialized. Call initialize() first.`);
+        }
+    }
+    /**
+     * Get the full tool description including all actions
+     * Used for Driver's tool awareness
+     */
+    getFullDescription() {
+        const actionDescriptions = this.actions
+            .map((a) => `  - ${a.name}: ${a.description}`)
+            .join('\n');
+        return `${this.name}: ${this.description}\nActions:\n${actionDescriptions}`;
+    }
+    /**
+     * Get the JSON schema for a specific action
+     */
+    getActionSchema(action) {
+        const actionDef = this.actions.find((a) => a.name === action);
+        return actionDef?.parameters;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC50b29scy5iYXNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvc21hcnRhZ2VudC50b29scy5iYXNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxVQUFVLE1BQU0sNEJBQTRCLENBQUM7QUFFekQ7OztHQUdHO0FBQ0gsTUFBTSxPQUFnQixlQUFlO0lBS3pCLGFBQWEsR0FBRyxLQUFLLENBQUM7SUEwQmhDOzs7T0FHRztJQUNPLGNBQWMsQ0FBQyxNQUFjO1FBQ3JDLE1BQU0sV0FBVyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxLQUFLLE1BQU0sQ0FBQyxDQUFDO1FBQ2hFLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUNqQixNQUFNLGdCQUFnQixHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQ3BFLE1BQU0sSUFBSSxLQUFLLENBQ2IsbUJBQW1CLE1BQU0sZUFBZSxJQUFJLENBQUMsSUFBSSx5QkFBeUIsZ0JBQWdCLEVBQUUsQ0FDN0YsQ0FBQztRQUNKLENBQUM7SUFDSCxDQUFDO0lBRUQ7O09BRUc7SUFDTyxpQkFBaUI7UUFDekIsSUFBSSxDQUFDLElBQUksQ0FBQyxhQUFhLEVBQUUsQ0FBQztZQUN4QixNQUFNLElBQUksS0FBSyxDQUFDLFNBQVMsSUFBSSxDQUFDLElBQUksZ0RBQWdELENBQUMsQ0FBQztRQUN0RixDQUFDO0lBQ0gsQ0FBQztJQUVEOzs7T0FHRztJQUNJLGtCQUFrQjtRQUN2QixNQUFNLGtCQUFrQixHQUFHLElBQUksQ0FBQyxPQUFPO2FBQ3BDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsT0FBTyxDQUFDLENBQUMsSUFBSSxLQUFLLENBQUMsQ0FBQyxXQUFXLEVBQUUsQ0FBQzthQUM3QyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7UUFFZCxPQUFPLEdBQUcsSUFBSSxDQUFDLElBQUksS0FBSyxJQUFJLENBQUMsV0FBVyxlQUFlLGtCQUFrQixFQUFFLENBQUM7SUFDOUUsQ0FBQztJQUVEOztPQUVHO0lBQ0ksZUFBZSxDQUFDLE1BQWM7UUFDbkMsTUFBTSxTQUFTLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLEtBQUssTUFBTSxDQUFDLENBQUM7UUFDOUQsT0FBTyxTQUFTLEVBQUUsVUFBVSxDQUFDO0lBQy9CLENBQUM7Q0FDRiJ9