@misgara/ai-agent 1.0.0

package/dist/core/AgentBuilder.d.ts

@@ -0,0 +1,101 @@
+import { type ToolSet, type LanguageModel, type StreamTextResult } from 'ai';
+import type { IMemoryAdapter, AgentResult } from './types.js';
+type GeminiModel = 'gemini-1.5-pro' | 'gemini-1.5-flash' | 'gemini-2.0-flash' | 'gemini-3-flash-preview';
+type OpenAIModel = 'gpt-4o' | 'gpt-4o-mini' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5.2' | 'o1' | 'o1-mini' | 'o3' | 'o3-mini' | 'o3-pro' | 'o4-mini';
+/**
+ * AgentBuilder - Fluent interface for building AI agents
+ * Supports both Google Gemini and OpenAI models
+ *
+ * @example
+ * ```typescript
+ * // Using Gemini
+ * const agent = new AgentBuilder()
+ *   .useGemini('gemini-3-flash-preview')
+ *   .setSystem('You are a helpful assistant.')
+ *   .addTools({ time: CommonTools.time });
+ *
+ * // Using OpenAI
+ * const agent = new AgentBuilder()
+ *   .useOpenAI('gpt-4o-mini')
+ *   .setSystem('You are a helpful assistant.')
+ *   .addTools({ time: CommonTools.time });
+ *
+ * const result = await agent.run('Hello!');
+ * console.log(result.text);
+ * ```
+ */
+export declare class AgentBuilder {
+    private model;
+    private systemPrompt;
+    private tools;
+    private memory?;
+    private sessionId?;
+    private maxSteps;
+    private temperature;
+    private maxOutputTokens?;
+    /**
+     * Sets a Google Gemini model
+     */
+    useGemini(modelId: GeminiModel): this;
+    /**
+     * Sets an OpenAI model
+     */
+    useOpenAI(modelId: OpenAIModel): this;
+    /**
+     * @deprecated Use useGemini() instead
+     * Sets the Gemini model to use (legacy method)
+     */
+    useModel(modelId: GeminiModel): this;
+    /**
+     * Sets a custom LanguageModel (for other providers like Anthropic, Mistral, etc.)
+     */
+    useCustomModel(model: LanguageModel): this;
+    /**
+     * Sets the system prompt
+     */
+    setSystem(prompt: string): this;
+    /**
+     * Configures memory persistence for conversation history
+     */
+    withMemory(adapter: IMemoryAdapter, sessionId: string): this;
+    /**
+     * Adds tools to the agent (enables agentic behavior with multiple steps)
+     * Can be called multiple times to add more tools
+     */
+    addTools(tools: ToolSet): this;
+    /**
+     * Sets the temperature for generation (0-2)
+     */
+    setTemperature(temp: number): this;
+    /**
+     * Sets maximum steps for tool call loops
+     * Higher values allow more complex multi-step operations
+     */
+    setMaxSteps(steps: number): this;
+    /**
+     * Sets maximum output tokens for generation
+     */
+    setMaxOutputTokens(tokens: number): this;
+    private formatStepResult;
+    /**
+     * Runs the agent with a user prompt
+     * @param userPrompt - The user's message
+     * @param imageUrl - Optional image URL or base64 for multimodal input
+     */
+    run(userPrompt: string, imageUrl?: string): Promise<AgentResult>;
+    /**
+     * Runs the agent without saving to memory (stateless)
+     */
+    runStateless(userPrompt: string, imageUrl?: string): Promise<AgentResult>;
+    /**
+     * Runs the agent in Streaming mode
+     * Automatically saves history on finish
+     */
+    stream(userPrompt: string, imageUrl?: string): Promise<StreamTextResult<ToolSet, any>>;
+    /**
+     * Stateless version of Streaming (no persistence)
+     */
+    streamStateless(userPrompt: string, imageUrl?: string): Promise<StreamTextResult<ToolSet, any>>;
+}
+export {};
+//# sourceMappingURL=AgentBuilder.d.ts.map

package/dist/core/AgentBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentBuilder.d.ts","sourceRoot":"","sources":["../../src/core/AgentBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAA4D,KAAK,OAAO,EAAE,KAAK,aAAa,EAAsB,KAAK,gBAAgB,EAAE,MAAM,IAAI,CAAC;AAI3J,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAA0C,MAAM,YAAY,CAAC;AAOtG,KAAK,WAAW,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,wBAAwB,CAAC;AACzG,KAAK,WAAW,GACV,QAAQ,GAAG,aAAa,GACxB,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,GACjD,IAAI,GAAG,SAAS,GAChB,IAAI,GAAG,SAAS,GAAG,QAAQ,GAC3B,SAAS,CAAC;AAEhB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAAmD;IAChE,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,WAAW,CAAO;IAC1B,OAAO,CAAC,eAAe,CAAC,CAAS;IAIjC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKrC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKrC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAIpC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAK1C;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAM5D;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAS9B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKlC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOxC,OAAO,CAAC,gBAAgB;IAsBxB;;;;OAIG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAoDtE;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAmC/E;;;OAGG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IA2C5F;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;CAuBxG"}

package/dist/core/AgentBuilder.js

@@ -0,0 +1,281 @@
+// src/core/AgentBuilder.ts
+import { generateText, streamText, stepCountIs } from 'ai';
+import { google } from '@ai-sdk/google';
+import { openai } from '@ai-sdk/openai';
+/**
+ * AgentBuilder - Fluent interface for building AI agents
+ * Supports both Google Gemini and OpenAI models
+ *
+ * @example
+ * ```typescript
+ * // Using Gemini
+ * const agent = new AgentBuilder()
+ *   .useGemini('gemini-3-flash-preview')
+ *   .setSystem('You are a helpful assistant.')
+ *   .addTools({ time: CommonTools.time });
+ *
+ * // Using OpenAI
+ * const agent = new AgentBuilder()
+ *   .useOpenAI('gpt-4o-mini')
+ *   .setSystem('You are a helpful assistant.')
+ *   .addTools({ time: CommonTools.time });
+ *
+ * const result = await agent.run('Hello!');
+ * console.log(result.text);
+ * ```
+ */
+export class AgentBuilder {
+    model = google('gemini-3-flash-preview');
+    systemPrompt = 'Eres un asistente útil y directo.';
+    tools = {};
+    memory;
+    sessionId;
+    maxSteps = 1; // 1 = Single turn, >1 = Agent mode with tool loops
+    temperature = 0.5;
+    maxOutputTokens;
+    // --- CONFIGURATION (Fluent Interface) ---
+    /**
+     * Sets a Google Gemini model
+     */
+    useGemini(modelId) {
+        this.model = google(modelId);
+        return this;
+    }
+    /**
+     * Sets an OpenAI model
+     */
+    useOpenAI(modelId) {
+        this.model = openai(modelId);
+        return this;
+    }
+    /**
+     * @deprecated Use useGemini() instead
+     * Sets the Gemini model to use (legacy method)
+     */
+    useModel(modelId) {
+        return this.useGemini(modelId);
+    }
+    /**
+     * Sets a custom LanguageModel (for other providers like Anthropic, Mistral, etc.)
+     */
+    useCustomModel(model) {
+        this.model = model;
+        return this;
+    }
+    /**
+     * Sets the system prompt
+     */
+    setSystem(prompt) {
+        this.systemPrompt = prompt;
+        return this;
+    }
+    /**
+     * Configures memory persistence for conversation history
+     */
+    withMemory(adapter, sessionId) {
+        this.memory = adapter;
+        this.sessionId = sessionId;
+        return this;
+    }
+    /**
+     * Adds tools to the agent (enables agentic behavior with multiple steps)
+     * Can be called multiple times to add more tools
+     */
+    addTools(tools) {
+        this.tools = { ...this.tools, ...tools };
+        // If adding tools, enable agentic behavior
+        if (this.maxSteps === 1) {
+            this.maxSteps = 10;
+        }
+        return this;
+    }
+    /**
+     * Sets the temperature for generation (0-2)
+     */
+    setTemperature(temp) {
+        this.temperature = Math.max(0, Math.min(2, temp));
+        return this;
+    }
+    /**
+     * Sets maximum steps for tool call loops
+     * Higher values allow more complex multi-step operations
+     */
+    setMaxSteps(steps) {
+        this.maxSteps = Math.max(1, steps);
+        return this;
+    }
+    /**
+     * Sets maximum output tokens for generation
+     */
+    setMaxOutputTokens(tokens) {
+        this.maxOutputTokens = tokens;
+        return this;
+    }
+    // --- PRIVATE HELPERS ---
+    formatStepResult(steps) {
+        return steps.map((step) => ({
+            text: step.text,
+            finishReason: step.finishReason,
+            toolCalls: step.toolCalls.map((tc) => ({
+                toolName: tc.toolName,
+                input: tc.input,
+            })),
+            toolResults: step.toolResults.map((tr) => ({
+                toolName: tr.toolName,
+                output: tr.output,
+            })),
+        }));
+    }
+    // --- EXECUTION ---
+    /**
+     * Runs the agent with a user prompt
+     * @param userPrompt - The user's message
+     * @param imageUrl - Optional image URL or base64 for multimodal input
+     */
+    async run(userPrompt, imageUrl) {
+        // 1. Load History
+        let history = [];
+        if (this.memory && this.sessionId) {
+            history = await this.memory.get(this.sessionId);
+        }
+        // 2. Prepare Current Message (supports multimodal)
+        const currentMessage = {
+            role: 'user',
+            content: imageUrl
+                ? [
+                    { type: 'text', text: userPrompt },
+                    { type: 'image', image: imageUrl },
+                ]
+                : userPrompt,
+        };
+        // 3. Call AI SDK with generateText
+        // In v6, stopWhen with stepCountIs controls the multi-step behavior
+        const hasTools = Object.keys(this.tools).length > 0;
+        const result = await generateText({
+            model: this.model,
+            system: this.systemPrompt,
+            messages: [...history, currentMessage],
+            tools: hasTools ? this.tools : undefined,
+            stopWhen: hasTools ? stepCountIs(this.maxSteps) : undefined,
+            temperature: this.temperature,
+            maxOutputTokens: this.maxOutputTokens,
+        });
+        // 4. Save Updated History
+        // result.response.messages contains all new messages (responses, tool calls, tool results)
+        if (this.memory && this.sessionId) {
+            const updatedHistory = [...history, currentMessage, ...result.response.messages];
+            await this.memory.add(this.sessionId, updatedHistory);
+        }
+        // 5. Format and return result
+        return {
+            text: result.text,
+            steps: this.formatStepResult(result.steps),
+            usage: {
+                inputTokens: result.usage.inputTokens,
+                outputTokens: result.usage.outputTokens,
+                totalTokens: result.usage.totalTokens,
+            },
+            totalUsage: result.usage,
+        };
+    }
+    /**
+     * Runs the agent without saving to memory (stateless)
+     */
+    async runStateless(userPrompt, imageUrl) {
+        const currentMessage = {
+            role: 'user',
+            content: imageUrl
+                ? [
+                    { type: 'text', text: userPrompt },
+                    { type: 'image', image: imageUrl },
+                ]
+                : userPrompt,
+        };
+        const hasTools = Object.keys(this.tools).length > 0;
+        const result = await generateText({
+            model: this.model,
+            system: this.systemPrompt,
+            messages: [currentMessage],
+            tools: hasTools ? this.tools : undefined,
+            stopWhen: hasTools ? stepCountIs(this.maxSteps) : undefined,
+            temperature: this.temperature,
+            maxOutputTokens: this.maxOutputTokens,
+        });
+        return {
+            text: result.text,
+            steps: this.formatStepResult(result.steps),
+            usage: {
+                inputTokens: result.usage.inputTokens,
+                outputTokens: result.usage.outputTokens,
+                totalTokens: result.usage.totalTokens,
+            },
+            totalUsage: result.usage,
+        };
+    }
+    /**
+     * Runs the agent in Streaming mode
+     * Automatically saves history on finish
+     */
+    async stream(userPrompt, imageUrl) {
+        // 1. Load History
+        let history = [];
+        if (this.memory && this.sessionId) {
+            history = await this.memory.get(this.sessionId);
+        }
+        // 2. Prepare Current Message
+        const currentMessage = {
+            role: 'user',
+            content: imageUrl
+                ? [
+                    { type: 'text', text: userPrompt },
+                    { type: 'image', image: imageUrl },
+                ]
+                : userPrompt,
+        };
+        const hasTools = Object.keys(this.tools).length > 0;
+        // 3. Start Stream
+        const result = streamText({
+            model: this.model,
+            system: this.systemPrompt,
+            messages: [...history, currentMessage],
+            tools: hasTools ? this.tools : undefined,
+            stopWhen: hasTools ? stepCountIs(this.maxSteps) : undefined,
+            temperature: this.temperature,
+            maxOutputTokens: this.maxOutputTokens,
+            // Callback for persistence
+            onFinish: async ({ response }) => {
+                if (this.memory && this.sessionId) {
+                    // response.messages includes the full roundtrip (tool calls, results, final response)
+                    const updatedHistory = [...history, currentMessage, ...response.messages];
+                    await this.memory.add(this.sessionId, updatedHistory);
+                }
+            },
+        });
+        return result;
+    }
+    /**
+     * Stateless version of Streaming (no persistence)
+     */
+    async streamStateless(userPrompt, imageUrl) {
+        const currentMessage = {
+            role: 'user',
+            content: imageUrl
+                ? [
+                    { type: 'text', text: userPrompt },
+                    { type: 'image', image: imageUrl },
+                ]
+                : userPrompt,
+        };
+        const hasTools = Object.keys(this.tools).length > 0;
+        return streamText({
+            model: this.model,
+            system: this.systemPrompt,
+            messages: [currentMessage],
+            tools: hasTools ? this.tools : undefined,
+            stopWhen: hasTools ? stepCountIs(this.maxSteps) : undefined,
+            temperature: this.temperature,
+            maxOutputTokens: this.maxOutputTokens,
+        });
+    }
+}
+//# sourceMappingURL=AgentBuilder.js.map

package/dist/core/AgentBuilder.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,60 @@
+import type { ModelMessage, LanguageModelUsage } from 'ai';
+/**
+ * Interface for memory adapters (Port)
+ * Allows the agent to persist conversation history
+ */
+export interface IMemoryAdapter {
+    /**
+     * Retrieves conversation history for a session
+     */
+    get(sessionId: string): Promise<ModelMessage[]>;
+    /**
+     * Adds/updates messages in the conversation history
+     */
+    add(sessionId: string, messages: ModelMessage[]): Promise<void>;
+    /**
+     * Clears all conversation history for a session
+     */
+    clear(sessionId: string): Promise<void>;
+}
+/**
+ * Tool call information
+ */
+export interface ToolCallInfo {
+    toolName: string;
+    input: unknown;
+}
+/**
+ * Tool result information
+ */
+export interface ToolResultInfo {
+    toolName: string;
+    output: unknown;
+}
+/**
+ * Step information for debugging
+ */
+export interface StepInfo {
+    toolCalls: ToolCallInfo[];
+    toolResults: ToolResultInfo[];
+    text: string;
+    finishReason: string;
+}
+/**
+ * Result returned from agent execution
+ */
+export interface AgentResult {
+    /** The final text response from the agent */
+    text: string;
+    /** Details about each step taken (useful for debugging tool usage) */
+    steps: StepInfo[];
+    /** Token usage statistics */
+    usage: {
+        inputTokens: number | undefined;
+        outputTokens: number | undefined;
+        totalTokens: number | undefined;
+    };
+    /** Total usage across all steps */
+    totalUsage: LanguageModelUsage;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEhD;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE;QACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;KACnC,CAAC;IACF,mCAAmC;IACnC,UAAU,EAAE,kBAAkB,CAAC;CAClC"}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import 'dotenv/config';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,76 @@
+// src/index.ts - Example usage of the AI Agent Library
+import 'dotenv/config';
+import { tool } from 'ai';
+import { z } from 'zod/v4';
+import { AgentBuilder } from './core/AgentBuilder.js';
+import { InMemoryAdapter } from './infrastructure/InMemory.js';
+import { CommonTools } from './tools/common.js';
+async function main() {
+    const userId = 'usuario-dev-01';
+    // Choose your memory adapter:
+    // Option 1: Redis (requires Redis running)
+    // const memory = new RedisMemory();
+    // Option 2: In-Memory (for development, no external deps)
+    const memory = new InMemoryAdapter();
+    // Build the agent with fluent interface
+    const agent = new AgentBuilder()
+        .useModel('gemini-3-flash-preview')
+        .setSystem('Eres un asistente financiero sarcástico pero muy útil.')
+        .withMemory(memory, userId)
+        .setTemperature(0.7)
+        // 1. Inject pre-built common tools
+        .addTools({
+        hora: CommonTools.time,
+        web: CommonTools.webSearchMock,
+        calcular: CommonTools.calculator,
+    })
+        // 2. Inject an ad-hoc project-specific tool
+        .addTools({
+        comprarCripto: tool({
+            description: 'Compra una criptomoneda específica',
+            inputSchema: z.object({
+                moneda: z.string().describe('El símbolo de la criptomoneda (BTC, ETH, etc.)'),
+                cantidad: z.number().describe('La cantidad a comprar'),
+            }),
+            execute: async ({ moneda, cantidad }) => {
+                // Simulated order - replace with actual exchange API
+                const orderId = Math.random().toString(36).substring(7);
+                return JSON.stringify({
+                    success: true,
+                    orderId,
+                    message: `Orden de compra creada: ${cantidad} ${moneda.toUpperCase()}`,
+                    estimatedPrice: `$${(Math.random() * 50000 + 20000).toFixed(2)} USD`,
+                });
+            },
+        }),
+    });
+    console.log('--- 🤖 Inicio del Chat ---\n');
+    // Prompt 1: Requires web search and time
+    console.log('👤 Usuario: Hola, ¿qué hora es y busca en internet a cuánto está el Bitcoin hoy?');
+    const resp1 = await agent.run('Hola, ¿qué hora es y busca en internet a cuánto está el Bitcoin hoy?');
+    console.log('🤖 IA:', resp1.text);
+    console.log('📊 Tokens usados:', resp1.usage.totalTokens);
+    console.log('🔧 Tools usadas:', resp1.steps.flatMap((s) => s.toolCalls.map((t) => t.toolName)).join(', ') || 'ninguna');
+    console.log();
+    // Prompt 2: Context + new tool (Buy crypto)
+    // Thanks to memory, the agent knows we were talking about Bitcoin
+    console.log('👤 Usuario: Ok, compra 5 unidades de esa moneda entonces.');
+    const resp2 = await agent.run('Ok, compra 5 unidades de esa moneda entonces.');
+    console.log('🤖 IA:', resp2.text);
+    console.log('📊 Tokens usados:', resp2.usage.totalTokens);
+    console.log('🔧 Tools usadas:', resp2.steps.flatMap((s) => s.toolCalls.map((t) => t.toolName)).join(', ') || 'ninguna');
+    console.log();
+    // Prompt 3: Using calculator
+    console.log('👤 Usuario: Si compré a $45000, ¿cuánto gasto en total?');
+    const resp3 = await agent.run('Si compré a $45000, ¿cuánto gasto en total por las 5 unidades?');
+    console.log('🤖 IA:', resp3.text);
+    console.log('📊 Tokens usados:', resp3.usage.totalTokens);
+    console.log('🔧 Tools usadas:', resp3.steps.flatMap((s) => s.toolCalls.map((t) => t.toolName)).join(', ') || 'ninguna');
+    console.log('\n--- ✅ Chat Finalizado ---');
+    process.exit(0);
+}
+main().catch((err) => {
+    console.error('❌ Error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/infrastructure/InMemory.d.ts

@@ -0,0 +1,20 @@
+import type { ModelMessage } from 'ai';
+import type { IMemoryAdapter } from '../core/types.js';
+/**
+ * In-memory adapter for development/testing (no external dependencies)
+ */
+export declare class InMemoryAdapter implements IMemoryAdapter {
+    private store;
+    private maxMessages;
+    constructor(options?: {
+        maxMessages?: number;
+    });
+    get(sessionId: string): Promise<ModelMessage[]>;
+    add(sessionId: string, messages: ModelMessage[]): Promise<void>;
+    clear(sessionId: string): Promise<void>;
+    /**
+     * Clears all stored sessions
+     */
+    clearAll(): void;
+}
+//# sourceMappingURL=InMemory.d.ts.map

package/dist/infrastructure/InMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemory.d.ts","sourceRoot":"","sources":["../../src/infrastructure/InMemory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,qBAAa,eAAgB,YAAW,cAAc;IAClD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAIxC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI/C,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;OAEG;IACH,QAAQ,IAAI,IAAI;CAGnB"}

package/dist/infrastructure/InMemory.js

@@ -0,0 +1,26 @@
+/**
+ * In-memory adapter for development/testing (no external dependencies)
+ */
+export class InMemoryAdapter {
+    store = new Map();
+    maxMessages;
+    constructor(options) {
+        this.maxMessages = options?.maxMessages || 30;
+    }
+    async get(sessionId) {
+        return this.store.get(sessionId) || [];
+    }
+    async add(sessionId, messages) {
+        this.store.set(sessionId, messages.slice(-this.maxMessages));
+    }
+    async clear(sessionId) {
+        this.store.delete(sessionId);
+    }
+    /**
+     * Clears all stored sessions
+     */
+    clearAll() {
+        this.store.clear();
+    }
+}
+//# sourceMappingURL=InMemory.js.map

package/dist/infrastructure/InMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemory.js","sourceRoot":"","sources":["../../src/infrastructure/InMemory.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,eAAe;IAChB,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC1C,WAAW,CAAS;IAE5B,YAAY,OAAkC;QAC1C,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAiB;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,QAAwB;QACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB;QACzB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACJ"}

package/dist/infrastructure/RedisMemory.d.ts

@@ -0,0 +1,26 @@
+import type { ModelMessage } from 'ai';
+import type { IMemoryAdapter } from '../core/types.js';
+/**
+ * Redis-based memory adapter for conversation persistence
+ */
+export declare class RedisMemory implements IMemoryAdapter {
+    private client;
+    private keyPrefix;
+    private maxMessages;
+    private ttlSeconds;
+    constructor(options?: {
+        connectionString?: string;
+        keyPrefix?: string;
+        maxMessages?: number;
+        ttlSeconds?: number;
+    });
+    private getKey;
+    get(sessionId: string): Promise<ModelMessage[]>;
+    add(sessionId: string, newMessages: ModelMessage[]): Promise<void>;
+    clear(sessionId: string): Promise<void>;
+    /**
+     * Gracefully close the Redis connection
+     */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=RedisMemory.d.ts.map

package/dist/infrastructure/RedisMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisMemory.d.ts","sourceRoot":"","sources":["../../src/infrastructure/RedisMemory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,qBAAa,WAAY,YAAW,cAAc;IAC9C,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,CAAC,EAAE;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB;IAOD,OAAO,CAAC,MAAM;IAIR,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAK/C,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}

package/dist/infrastructure/RedisMemory.js

@@ -0,0 +1,39 @@
+// src/infrastructure/RedisMemory.ts
+import { Redis } from 'ioredis';
+/**
+ * Redis-based memory adapter for conversation persistence
+ */
+export class RedisMemory {
+    client;
+    keyPrefix;
+    maxMessages;
+    ttlSeconds;
+    constructor(options) {
+        this.client = new Redis(options?.connectionString || 'redis://localhost:6379');
+        this.keyPrefix = options?.keyPrefix || 'agent';
+        this.maxMessages = options?.maxMessages || 30;
+        this.ttlSeconds = options?.ttlSeconds || 86400; // 24 hours default
+    }
+    getKey(sessionId) {
+        return `${this.keyPrefix}:${sessionId}`;
+    }
+    async get(sessionId) {
+        const data = await this.client.get(this.getKey(sessionId));
+        return data ? JSON.parse(data) : [];
+    }
+    async add(sessionId, newMessages) {
+        // Keep only the last N messages (sliding window for context management)
+        const serialized = JSON.stringify(newMessages.slice(-this.maxMessages));
+        await this.client.set(this.getKey(sessionId), serialized, 'EX', this.ttlSeconds);
+    }
+    async clear(sessionId) {
+        await this.client.del(this.getKey(sessionId));
+    }
+    /**
+     * Gracefully close the Redis connection
+     */
+    async disconnect() {
+        await this.client.quit();
+    }
+}
+//# sourceMappingURL=RedisMemory.js.map

package/dist/infrastructure/RedisMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisMemory.js","sourceRoot":"","sources":["../../src/infrastructure/RedisMemory.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAIhC;;GAEG;AACH,MAAM,OAAO,WAAW;IACZ,MAAM,CAAQ;IACd,SAAS,CAAS;IAClB,WAAW,CAAS;IACpB,UAAU,CAAS;IAE3B,YAAY,OAKX;QACG,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,gBAAgB,IAAI,wBAAwB,CAAC,CAAC;QAC/E,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC;QAC/C,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC,CAAC,mBAAmB;IACvE,CAAC;IAEO,MAAM,CAAC,SAAiB;QAC5B,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAiB;QACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,WAA2B;QACpD,wEAAwE;QACxE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACxE,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB;QACzB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACZ,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;CACJ"}

package/dist/tools/common.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Collection of pre-built common tools
+ */
+export declare const CommonTools: {
+    /**
+     * Tool 1: Current date and time
+     */
+    time: import("ai").Tool<Record<string, never>, string>;
+    calculator: import("ai").Tool<{
+        expression: string;
+    }, string>;
+    /**
+     * Tool 3: Web search mock (replace with actual API in production)
+     */
+    webSearchMock: import("ai").Tool<{
+        query: string;
+    }, string>;
+    /**
+     * Tool 4: Random number generator
+     */
+    randomNumber: import("ai").Tool<{
+        min: number;
+        max: number;
+    }, string>;
+    /**
+     * Tool 5: Text utilities
+     */
+    textUtils: import("ai").Tool<{
+        text: string;
+        operation: "reverse" | "wordCount" | "charCount" | "uppercase" | "lowercase";
+    }, string>;
+};
+//# sourceMappingURL=common.d.ts.map

package/dist/tools/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/tools/common.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,eAAO,MAAM,WAAW;IACpB;;OAEG;;;;;IA+BH;;OAEG;;;;IAqBH;;OAEG;;;;;IAaH;;OAEG;;;;;CAyBN,CAAC"}

package/dist/tools/common.js

@@ -0,0 +1,105 @@
+// src/tools/common.ts
+import { tool } from 'ai';
+import { z } from 'zod/v4';
+import { evaluate } from 'mathjs';
+/**
+ * Collection of pre-built common tools
+ */
+export const CommonTools = {
+    /**
+     * Tool 1: Current date and time
+     */
+    time: tool({
+        description: 'Obtiene la fecha y hora actual (útil para contextos temporales)',
+        inputSchema: z.object({}),
+        execute: async () => {
+            const now = new Date();
+            return JSON.stringify({
+                iso: now.toISOString(),
+                local: now.toLocaleString(),
+                timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+            });
+        },
+    }),
+    // Tool 2: Safe calculator using mathjs
+    calculator: tool({
+        description: 'Realiza cálculos matemáticos seguros. Soporta +, -, *, /, potencias y funciones básicas.',
+        inputSchema: z.object({
+            expression: z.string().describe('La expresión matemática a evaluar, ej: "2 + 2", "sqrt(16)", o "(10 * 5) / 2"'),
+        }),
+        execute: async ({ expression }) => {
+            try {
+                // evaluate from mathjs is safer and more powerful
+                const result = evaluate(expression);
+                return JSON.stringify({ result: result.toString(), expression });
+            }
+            catch {
+                return JSON.stringify({ error: 'Error en el cálculo: Expresión inválida o no soportada', result: null });
+            }
+        },
+    }),
+    /**
+     * Tool 3: Web search mock (replace with actual API in production)
+     */
+    webSearchMock: tool({
+        description: 'Busca información actual en internet sobre un tópico',
+        inputSchema: z.object({
+            query: z.string().describe('El término o frase a buscar'),
+        }),
+        execute: async ({ query }) => {
+            console.log(`[🔍 Buscando en la web: ${query}]`);
+            // Mock response - replace with actual search API (SerpAPI, Tavily, etc.)
+            return JSON.stringify({
+                query,
+                results: [
+                    { title: 'Resultado simulado 1', snippet: `Información sobre: ${query}` },
+                    { title: 'Resultado simulado 2', snippet: 'El clima está soleado en Madrid.' },
+                    { title: 'Resultado simulado 3', snippet: 'El dólar está a 1.05 EUR.' },
+                ],
+                note: 'Esto es una respuesta simulada. Implementa una API real en producción.',
+            });
+        },
+    }),
+    /**
+     * Tool 4: Random number generator
+     */
+    randomNumber: tool({
+        description: 'Genera un número aleatorio entre un mínimo y máximo',
+        inputSchema: z.object({
+            min: z.number().describe('Valor mínimo (incluido)'),
+            max: z.number().describe('Valor máximo (incluido)'),
+        }),
+        execute: async ({ min, max }) => {
+            const result = Math.floor(Math.random() * (max - min + 1)) + min;
+            return JSON.stringify({ min, max, result });
+        },
+    }),
+    /**
+     * Tool 5: Text utilities
+     */
+    textUtils: tool({
+        description: 'Realiza operaciones de texto: contar palabras, caracteres, o transformar texto',
+        inputSchema: z.object({
+            text: z.string().describe('El texto a procesar'),
+            operation: z.enum(['wordCount', 'charCount', 'uppercase', 'lowercase', 'reverse'])
+                .describe('La operación a realizar'),
+        }),
+        execute: async ({ text, operation }) => {
+            switch (operation) {
+                case 'wordCount':
+                    return JSON.stringify({ operation, result: text.split(/\s+/).filter((w) => w.length > 0).length });
+                case 'charCount':
+                    return JSON.stringify({ operation, result: text.length });
+                case 'uppercase':
+                    return JSON.stringify({ operation, result: text.toUpperCase() });
+                case 'lowercase':
+                    return JSON.stringify({ operation, result: text.toLowerCase() });
+                case 'reverse':
+                    return JSON.stringify({ operation, result: text.split('').reverse().join('') });
+                default:
+                    return JSON.stringify({ operation, error: 'Operación no reconocida' });
+            }
+        },
+    }),
+};
+//# sourceMappingURL=common.js.map

package/dist/tools/common.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@misgara/ai-agent",
+  "version": "1.0.0",
+  "description": "Librería hexagonal para agentes de IA",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "ai",
+    "agent",
+    "gemini",
+    "vercel-ai-sdk"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "misgara",
+  "license": "ISC",
+  "type": "module",
+  "dependencies": {
+    "@ai-sdk/google": "^3.0.6",
+    "@ai-sdk/openai": "^3.0.7",
+    "ai": "^6.0.27",
+    "dotenv": "^17.2.3",
+    "ioredis": "^5.9.1",
+    "mathjs": "^15.1.0",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/ioredis": "^4.28.10",
+    "@types/node": "^25.0.6",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}