jazz-ai 0.1.0

package/dist/cli/commands/task-agent.js

@@ -0,0 +1,345 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgentCommand = createAgentCommand;
+exports.listAgentsCommand = listAgentsCommand;
+exports.runAgentCommand = runAgentCommand;
+exports.deleteAgentCommand = deleteAgentCommand;
+exports.getAgentCommand = getAgentCommand;
+const effect_1 = require("effect");
+const agent_service_1 = require("../../core/agent/agent-service");
+const gmail_agent_1 = require("../../core/agent/gmail-agent");
+/**
+ * CLI commands for task-based agent management
+ *
+ * These commands handle traditional automation agents that execute predefined tasks
+ * like Gmail operations, shell commands, API calls, etc. They focus on workflow
+ * automation rather than conversational AI interactions.
+ */
+/**
+ * Create a new agent via CLI command
+ *
+ * Creates a new agent with the specified name, description, and configuration options.
+ * The command validates input parameters and displays success information including
+ * the agent ID, configuration details, and timestamps.
+ *
+ * @param name - The unique name for the agent
+ * @param description - A description of what the agent does
+ * @param options - Configuration options including timeout, retry policy settings
+ * @returns An Effect that resolves when the agent is created successfully
+ *
+ * @throws {StorageError} When there's an error saving the agent
+ * @throws {AgentAlreadyExistsError} When an agent with the same name already exists
+ * @throws {AgentConfigurationError} When the configuration is invalid
+ * @throws {ValidationError} When input validation fails
+ *
+ * @example
+ * ```typescript
+ * yield* createAgentCommand(
+ *   "email-processor",
+ *   "Processes incoming emails",
+ *   { timeout: 30000, maxRetries: 3, retryDelay: 1000 }
+ * );
+ * ```
+ */
+function createAgentCommand(name, description, options) {
+    return effect_1.Effect.gen(function* () {
+        const agentService = yield* agent_service_1.AgentServiceTag;
+        // Use provided description or default
+        const agentDescription = description || options.description || `Agent for ${name}`;
+        // Build agent configuration from options
+        const config = {};
+        if (options.timeout) {
+            config.timeout = options.timeout;
+        }
+        if (options.maxRetries !== undefined ||
+            options.retryDelay !== undefined ||
+            options.retryBackoff) {
+            config.retryPolicy = {
+                maxRetries: options.maxRetries || 3,
+                delay: options.retryDelay || 1000,
+                backoff: options.retryBackoff || "exponential",
+            };
+        }
+        // Create the agent
+        const agent = yield* agentService.createAgent(name, agentDescription, config);
+        // Display success message
+        console.log(`✅ Agent created successfully!`);
+        console.log(`   ID: ${agent.id}`);
+        console.log(`   Name: ${agent.name}`);
+        console.log(`   Description: ${agent.description}`);
+        console.log(`   Status: ${agent.status}`);
+        console.log(`   Created: ${agent.createdAt.toISOString()}`);
+        if (config.timeout) {
+            console.log(`   Timeout: ${config.timeout}ms`);
+        }
+        if (config.retryPolicy) {
+            console.log(`   Retry Policy: ${config.retryPolicy.maxRetries} retries, ${config.retryPolicy.delay}ms delay, ${config.retryPolicy.backoff} backoff`);
+        }
+    });
+}
+/**
+ * List all agents via CLI command
+ *
+ * Retrieves and displays all available agents in a formatted table showing
+ * their ID, name, description, status, and creation date.
+ *
+ * @returns An Effect that resolves when the agents are listed successfully
+ *
+ * @throws {StorageError} When there's an error accessing storage
+ *
+ * @example
+ * ```typescript
+ * yield* listAgentsCommand();
+ * // Output: Table showing all agents with their details
+ * ```
+ */
+function listAgentsCommand() {
+    return effect_1.Effect.gen(function* () {
+        const agents = yield* (0, agent_service_1.listAllAgents)();
+        if (agents.length === 0) {
+            console.log("No agents found. Create your first agent with: jazz agent create");
+            return;
+        }
+        console.log(`Found ${agents.length} agent(s):`);
+        console.log();
+        agents.forEach((agent, index) => {
+            console.log(`${index + 1}. ${agent.name} (${agent.id})`);
+            console.log(`   Description: ${agent.description}`);
+            console.log(`   Status: ${agent.status}`);
+            console.log(`   Tasks: ${agent.config.tasks.length}`);
+            console.log(`   Created: ${agent.createdAt.toISOString()}`);
+            console.log(`   Updated: ${agent.updatedAt.toISOString()}`);
+            console.log();
+        });
+    });
+}
+/**
+ * Run an agent via CLI command
+ *
+ * Executes the specified agent, including all its configured tasks. Supports
+ * dry-run mode for testing and watch mode for continuous execution. For Gmail
+ * tasks, it displays formatted email results including subject, sender, date,
+ * and snippet information.
+ *
+ * @param agentId - The unique identifier of the agent to run
+ * @param options - Execution options including watch and dry-run modes
+ * @returns An Effect that resolves when the agent execution completes
+ *
+ * @throws {StorageError} When there's an error accessing storage
+ * @throws {StorageNotFoundError} When the agent with the given ID doesn't exist
+ *
+ * @example
+ * ```typescript
+ * yield* runAgentCommand("agent-123", { dryRun: true });
+ * // Output: Shows what would be executed without actually running
+ * ```
+ */
+function runAgentCommand(agentId, options) {
+    return effect_1.Effect.gen(function* () {
+        const agent = yield* (0, agent_service_1.getAgentById)(agentId);
+        console.log(`🚀 Running agent: ${agent.name} (${agent.id})`);
+        console.log(`   Description: ${agent.description}`);
+        console.log(`   Status: ${agent.status}`);
+        console.log(`   Tasks: ${agent.config.tasks.length}`);
+        if (options.dryRun) {
+            console.log(`   Mode: DRY RUN (no actual execution)`);
+            console.log();
+            console.log("Tasks that would be executed:");
+            agent.config.tasks.forEach((task, index) => {
+                console.log(`   ${index + 1}. ${task.name} (${task.type})`);
+                console.log(`      Description: ${task.description}`);
+                if (task.dependencies && task.dependencies.length > 0) {
+                    console.log(`      Dependencies: ${task.dependencies.join(", ")}`);
+                }
+            });
+            return;
+        }
+        if (options.watch) {
+            console.log(`   Mode: WATCH (continuous execution)`);
+        }
+        console.log();
+        // Check if this agent has Gmail tasks
+        const gmailTasks = agent.config.tasks.filter((task) => task.type === "gmail");
+        if (gmailTasks.length > 0) {
+            console.log(`🔍 Found ${gmailTasks.length} Gmail task(s) to execute`);
+            // Import the Gmail task executor dynamically
+            // Execute each Gmail task
+            for (const task of gmailTasks) {
+                console.log(`\n📨 Executing Gmail task: ${task.name}`);
+                console.log(`   Operation: ${task.config.gmailOperation}`);
+                const result = yield* (0, gmail_agent_1.executeGmailTask)(task).pipe(effect_1.Effect.catchAll((error) => effect_1.Effect.succeed({
+                    taskId: task.id,
+                    status: "failure",
+                    error: error instanceof Error ? error.message : String(error),
+                    duration: 0,
+                    timestamp: new Date(),
+                    output: "[]",
+                })));
+                if (result.status === "success") {
+                    console.log(`✅ Task completed successfully in ${result.duration}ms`);
+                    // Display the output based on the operation
+                    if (task.config.gmailOperation === "listEmails" ||
+                        task.config.gmailOperation === "searchEmails") {
+                        try {
+                            const emails = JSON.parse(result.output || "[]");
+                            console.log(`\n📬 Found ${emails.length} email(s):`);
+                            emails.forEach((email, index) => {
+                                console.log(`\n${index + 1}. ${email.subject}`);
+                                console.log(`   From: ${email.from}`);
+                                console.log(`   Date: ${new Date(email.date).toLocaleString()}`);
+                                console.log(`   ${email.snippet}`);
+                            });
+                        }
+                        catch {
+                            console.log(`\n${result.output}`);
+                        }
+                    }
+                    else {
+                        console.log(`\n${result.output}`);
+                    }
+                }
+                else {
+                    console.log(`❌ Task failed: ${result.error}`);
+                }
+            }
+        }
+        else {
+            console.log("⚠️  No Gmail tasks found in this agent.");
+            console.log("   Other task types are not yet implemented.");
+        }
+    });
+}
+/**
+ * Delete an agent via CLI command
+ *
+ * Removes the specified agent from storage after confirming the deletion.
+ * This operation is irreversible and will permanently delete the agent
+ * and all its associated data.
+ *
+ * @param agentId - The unique identifier of the agent to delete
+ * @returns An Effect that resolves when the agent is deleted successfully
+ *
+ * @throws {StorageError} When there's an error accessing storage
+ * @throws {StorageNotFoundError} When the agent with the given ID doesn't exist
+ *
+ * @example
+ * ```typescript
+ * yield* deleteAgentCommand("agent-123");
+ * // Output: Confirmation message and deletion success
+ * ```
+ */
+function deleteAgentCommand(agentId) {
+    return effect_1.Effect.gen(function* () {
+        const agentService = yield* agent_service_1.AgentServiceTag;
+        // First check if agent exists
+        const agent = yield* agentService.getAgent(agentId);
+        // Delete the agent
+        yield* agentService.deleteAgent(agentId);
+        console.log(`🗑️  Agent deleted successfully!`);
+        console.log(`   Name: ${agent.name}`);
+        console.log(`   ID: ${agent.id}`);
+    });
+}
+/**
+ * Get agent details via CLI command
+ *
+ * Retrieves and displays detailed information about a specific agent including
+ * its configuration, tasks, and metadata in a formatted output.
+ *
+ * @param agentId - The unique identifier of the agent to retrieve
+ * @returns An Effect that resolves when the agent details are displayed
+ *
+ * @throws {StorageError} When there's an error accessing storage
+ * @throws {StorageNotFoundError} When the agent with the given ID doesn't exist
+ *
+ * @example
+ * ```typescript
+ * yield* getAgentCommand("agent-123");
+ * // Output: Detailed agent information including config and tasks
+ * ```
+ */
+function getAgentCommand(agentId) {
+    return effect_1.Effect.gen(function* () {
+        const agent = yield* (0, agent_service_1.getAgentById)(agentId);
+        console.log(`📋 Agent Details:`);
+        console.log(`   ID: ${agent.id}`);
+        console.log(`   Name: ${agent.name}`);
+        console.log(`   Description: ${agent.description}`);
+        console.log(`   Status: ${agent.status}`);
+        console.log(`   Created: ${agent.createdAt.toISOString()}`);
+        console.log(`   Updated: ${agent.updatedAt.toISOString()}`);
+        console.log();
+        console.log(`⚙️  Configuration:`);
+        console.log(`   Timeout: ${agent.config.timeout || "default"}ms`);
+        console.log(`   Tasks: ${agent.config.tasks.length}`);
+        if (agent.config.retryPolicy) {
+            console.log(`   Retry Policy:`);
+            console.log(`     Max Retries: ${agent.config.retryPolicy.maxRetries}`);
+            console.log(`     Delay: ${agent.config.retryPolicy.delay}ms`);
+            console.log(`     Backoff: ${agent.config.retryPolicy.backoff}`);
+        }
+        if (agent.config.environment && Object.keys(agent.config.environment).length > 0) {
+            console.log(`   Environment Variables: ${Object.keys(agent.config.environment).length}`);
+        }
+        if (agent.config.schedule) {
+            console.log(`   Schedule: ${agent.config.schedule.type} - ${agent.config.schedule.value}`);
+        }
+        console.log();
+        if (agent.config.tasks.length > 0) {
+            console.log(`📝 Tasks:`);
+            agent.config.tasks.forEach((task, index) => {
+                console.log(`   ${index + 1}. ${task.name} (${task.type})`);
+                console.log(`      Description: ${task.description}`);
+                console.log(`      ID: ${task.id}`);
+                if (task.dependencies && task.dependencies.length > 0) {
+                    console.log(`      Dependencies: ${task.dependencies.join(", ")}`);
+                }
+                if (task.maxRetries !== undefined) {
+                    console.log(`      Max Retries: ${task.maxRetries}`);
+                }
+                // Show task-specific config
+                switch (task.type) {
+                    case "command":
+                        if (task.config.command) {
+                            console.log(`      Command: ${task.config.command}`);
+                        }
+                        break;
+                    case "script":
+                        if (task.config.script) {
+                            console.log(`      Script: ${task.config.script.substring(0, 100)}${task.config.script.length > 100 ? "..." : ""}`);
+                        }
+                        break;
+                    case "api":
+                        if (task.config.url) {
+                            console.log(`      URL: ${task.config.url}`);
+                            if (task.config.method) {
+                                console.log(`      Method: ${task.config.method}`);
+                            }
+                        }
+                        break;
+                    case "file":
+                        if (task.config.filePath) {
+                            console.log(`      File Path: ${task.config.filePath}`);
+                        }
+                        break;
+                    case "gmail":
+                        if (task.config.gmailOperation) {
+                            console.log(`      Gmail Operation: ${task.config.gmailOperation}`);
+                            if (task.config.gmailQuery) {
+                                console.log(`      Query: ${task.config.gmailQuery}`);
+                            }
+                            if (task.config.gmailMaxResults) {
+                                console.log(`      Max Results: ${task.config.gmailMaxResults}`);
+                            }
+                        }
+                        break;
+                }
+                console.log();
+            });
+        }
+        else {
+            console.log(`📝 No tasks configured for this agent.`);
+        }
+    });
+}
+//# sourceMappingURL=task-agent.js.map

package/dist/cli/commands/task-agent.js.map

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

package/dist/core/agent/agent-prompt.d.ts

@@ -0,0 +1,47 @@
+import { Effect } from "effect";
+import { type ChatMessage } from "../../services/llm/types";
+export interface AgentPromptTemplate {
+    readonly name: string;
+    readonly description: string;
+    readonly systemPrompt: string;
+    readonly userPromptTemplate: string;
+    readonly toolDescriptions?: Record<string, string>;
+}
+export interface AgentPromptOptions {
+    readonly agentName: string;
+    readonly agentDescription: string;
+    readonly userInput: string;
+    readonly conversationHistory?: ChatMessage[];
+    readonly toolNames?: readonly string[];
+    readonly availableTools?: Record<string, string>;
+}
+export declare class AgentPromptBuilder {
+    private templates;
+    constructor();
+    /**
+     * Get current system information including date and OS details
+     */
+    private getSystemInfo;
+    /**
+     * Get a prompt template by name
+     */
+    getTemplate(name: string): Effect.Effect<AgentPromptTemplate, Error>;
+    /**
+     * List available prompt templates
+     */
+    listTemplates(): Effect.Effect<readonly string[], never>;
+    /**
+     * Build a system prompt from a template and options
+     */
+    buildSystemPrompt(templateName: string, options: AgentPromptOptions): Effect.Effect<string, Error>;
+    /**
+     * Build a user prompt from a template and options
+     */
+    buildUserPrompt(templateName: string, options: AgentPromptOptions): Effect.Effect<string, Error>;
+    /**
+     * Build complete messages for an agent, including system prompt and conversation history
+     */
+    buildAgentMessages(templateName: string, options: AgentPromptOptions): Effect.Effect<ChatMessage[], Error>;
+}
+export declare const agentPromptBuilder: AgentPromptBuilder;
+//# sourceMappingURL=agent-prompt.d.ts.map

package/dist/core/agent/agent-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-prompt.d.ts","sourceRoot":"","sources":["../../../src/core/agent/agent-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClD;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAsC;;IAkCvD;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,KAAK,CAAC;IAapE;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,KAAK,CAAC;IAIxD;;OAEG;IACH,iBAAiB,CACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAoB/B;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAUhG;;OAEG;IACH,kBAAkB,CAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC;CA6CvC;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/core/agent/agent-prompt.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentPromptBuilder = exports.AgentPromptBuilder = void 0;
+const tslib_1 = require("tslib");
+const effect_1 = require("effect");
+const os = tslib_1.__importStar(require("os"));
+const v2_1 = require("./prompts/default/v2");
+const v2_2 = require("./prompts/gmail/v2");
+class AgentPromptBuilder {
+    templates;
+    constructor() {
+        this.templates = {
+            default: {
+                name: "Default Agent",
+                description: "A general-purpose agent that can assist with various tasks.",
+                systemPrompt: v2_1.DEFAULT_PROMPT_V2,
+                userPromptTemplate: "{userInput}",
+            },
+            gmail: {
+                name: "Gmail Agent",
+                description: "An agent specialized in handling email-related tasks.",
+                systemPrompt: v2_2.GMAIL_PROMPT_V2,
+                userPromptTemplate: "{userInput}",
+                toolDescriptions: {
+                    listEmails: "List the user's emails with optional filtering.",
+                    getEmail: "Get the full content of a specific email by ID.",
+                    searchEmails: "Search for emails matching specific criteria.",
+                    sendEmail: "Draft an email on behalf of the user (does not send).",
+                    trashEmail: "Trash an email by ID.",
+                    batchModifyEmails: "Batch modify emails by ID.",
+                    deleteEmail: "Delete an email by ID.",
+                    deleteLabel: "Delete a label by ID.",
+                    addLabelsToEmail: "Add labels to an email by ID.",
+                    removeLabelsFromEmail: "Remove labels from an email by ID.",
+                    listLabels: "List the user's labels.",
+                    createLabel: "Create a new label.",
+                    updateLabel: "Update a label by ID.",
+                },
+            },
+        };
+    }
+    /**
+     * Get current system information including date and OS details
+     */
+    getSystemInfo() {
+        return effect_1.Effect.sync(() => {
+            const currentDate = new Date().toISOString();
+            const platform = os.platform();
+            const arch = os.arch();
+            const release = os.release();
+            const hostname = os.hostname();
+            const username = os.userInfo().username;
+            const shell = process.env["SHELL"] || "unknown";
+            const workingDirectory = process.cwd();
+            const systemInfo = `${platform} ${release} (${arch}) on ${hostname}`;
+            const userInfo = `${username} using ${shell.split("/").pop() || "shell"}`;
+            return { currentDate, systemInfo, userInfo, workingDirectory };
+        });
+    }
+    /**
+     * Get a prompt template by name
+     */
+    getTemplate(name) {
+        return effect_1.Effect.try({
+            try: () => {
+                const template = this.templates[name];
+                if (!template) {
+                    throw new Error(`Prompt template not found: ${name}`);
+                }
+                return template;
+            },
+            catch: (error) => (error instanceof Error ? error : new Error(String(error))),
+        });
+    }
+    /**
+     * List available prompt templates
+     */
+    listTemplates() {
+        return effect_1.Effect.succeed(Object.keys(this.templates));
+    }
+    /**
+     * Build a system prompt from a template and options
+     */
+    buildSystemPrompt(templateName, options) {
+        return effect_1.Effect.gen(function* () {
+            const template = yield* this.getTemplate(templateName);
+            const { currentDate, systemInfo, userInfo, workingDirectory } = yield* this.getSystemInfo();
+            // Replace placeholders in system prompt
+            const systemPrompt = template.systemPrompt
+                .replace("{agentName}", options.agentName)
+                .replace("{agentDescription}", options.agentDescription)
+                .replace("{currentDate}", currentDate)
+                .replace("{systemInfo}", systemInfo)
+                .replace("{userInfo}", userInfo)
+                .replace("{workingDirectory}", workingDirectory);
+            return systemPrompt;
+        }.bind(this));
+    }
+    /**
+     * Build a user prompt from a template and options
+     */
+    buildUserPrompt(templateName, options) {
+        return effect_1.Effect.gen(function* () {
+            const template = yield* this.getTemplate(templateName);
+            return template.userPromptTemplate.replace("{userInput}", options.userInput);
+        }.bind(this));
+    }
+    /**
+     * Build complete messages for an agent, including system prompt and conversation history
+     */
+    buildAgentMessages(templateName, options) {
+        return effect_1.Effect.gen(function* () {
+            const systemPrompt = yield* this.buildSystemPrompt(templateName, options);
+            const userPrompt = yield* this.buildUserPrompt(templateName, options);
+            const messages = [{ role: "system", content: systemPrompt }];
+            // Add conversation history if available
+            if (options.conversationHistory && options.conversationHistory.length > 0) {
+                // Filter out system messages from history
+                const filteredHistory = options.conversationHistory.filter((msg) => msg.role !== "system");
+                messages.push(...filteredHistory);
+            }
+            // Add the current user input if not already in history
+            if (!options.conversationHistory ||
+                options.conversationHistory[options.conversationHistory.length - 1]?.role !== "user") {
+                // Safety check: ensure userPrompt is not empty
+                if (userPrompt && userPrompt.trim().length > 0) {
+                    messages.push({ role: "user", content: userPrompt });
+                }
+                else {
+                    // If userPrompt is empty, use the original userInput
+                    if (options.userInput && options.userInput.trim().length > 0) {
+                        messages.push({ role: "user", content: options.userInput });
+                    }
+                }
+            }
+            // Final safety check: ensure we never return an empty messages array
+            if (messages.length === 0) {
+                throw new Error(`Cannot create empty messages array - at least system message should be present. Template: ${templateName}, userInput: "${options.userInput}", userPrompt: "${userPrompt}"`);
+            }
+            return messages;
+        }.bind(this));
+    }
+}
+exports.AgentPromptBuilder = AgentPromptBuilder;
+exports.agentPromptBuilder = new AgentPromptBuilder();
+//# sourceMappingURL=agent-prompt.js.map

package/dist/core/agent/agent-prompt.js.map

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

package/dist/core/agent/agent-runner.d.ts

@@ -0,0 +1,63 @@
+import { Effect } from "effect";
+import { type ConfigService } from "../../services/config";
+import { LLMRateLimitError, type ChatMessage, type LLMService, type ToolCall } from "../../services/llm/types";
+import { type LoggerService } from "../../services/logger";
+import { type Agent } from "../types";
+import { type ToolExecutionContext, type ToolExecutionResult, type ToolRegistry } from "./tools/tool-registry";
+/**
+ * Agent runner for executing agent conversations
+ */
+export interface AgentRunnerOptions {
+    readonly agent: Agent;
+    readonly userInput: string;
+    readonly conversationId?: string;
+    readonly userId?: string;
+    readonly maxIterations?: number;
+    /**
+     * Full conversation history to date, including prior assistant, user, and tool messages.
+     * Use this to preserve context across turns (e.g., approval flows).
+     */
+    readonly conversationHistory?: ChatMessage[];
+}
+export interface AgentResponse {
+    readonly content: string;
+    readonly conversationId: string;
+    readonly toolCalls?: ToolCall[];
+    readonly toolResults?: Record<string, unknown>;
+    /**
+     * The full message list used for this turn, including system, user, assistant, and tool messages.
+     * Pass this back on the next turn to retain context across approvals and multi-step tasks.
+     */
+    readonly messages?: ChatMessage[] | undefined;
+}
+export declare class AgentRunner {
+    /**
+     * Run an agent conversation
+     */
+    static run(options: AgentRunnerOptions): Effect.Effect<AgentResponse, LLMRateLimitError | Error, LLMService | ToolRegistry | LoggerService | ConfigService>;
+}
+/**
+ * Execute a tool by name with the provided arguments
+ *
+ * Finds the specified tool in the registry and executes it with the given arguments
+ * and context. Provides comprehensive logging of the execution process including
+ * start, success, and error states.
+ *
+ * @param name - The name of the tool to execute
+ * @param args - The arguments to pass to the tool
+ * @param context - The execution context containing agent and conversation information
+ * @returns An Effect that resolves to the tool execution result
+ *
+ * @throws {Error} When the tool is not found or execution fails
+ *
+ * @example
+ * ```typescript
+ * const result = yield* executeTool(
+ *   "gmail_list_emails",
+ *   { query: "is:unread" },
+ *   { agentId: "agent-123", conversationId: "conv-456" }
+ * );
+ * ```
+ */
+export declare function executeTool(name: string, args: Record<string, unknown>, context: ToolExecutionContext): Effect.Effect<ToolExecutionResult, Error, ToolRegistry | LoggerService | ConfigService>;
+//# sourceMappingURL=agent-runner.d.ts.map

package/dist/core/agent/agent-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../../src/core/agent/agent-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EACL,iBAAiB,EAEjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;CAC/C;AAED,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,GAAG,CACR,OAAO,EAAE,kBAAkB,GAC1B,MAAM,CAAC,MAAM,CACd,aAAa,EACb,iBAAiB,GAAG,KAAK,EACzB,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,aAAa,CAC1D;CAsWF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,KAAK,EAAE,YAAY,GAAG,aAAa,GAAG,aAAa,CAAC,CAKzF"}