agentstudio 0.3.1 → 0.3.2

package/services/a2a/taskManager.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * A2A Task Manager Service
+ *
+ * Manages the lifecycle of A2A asynchronous tasks with file-based persistence.
+ * Tasks are stored as JSON files in {workingDirectory}/.a2a/tasks/{taskId}.json
+ *
+ * State Transitions:
+ * - pending → running
+ * - running → completed | failed | canceled
+ * - pending → canceled
+ *
+ * All state transitions are validated and atomic using file locking.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskManager = exports.TaskManager = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const uuid_1 = require("uuid");
+const proper_lockfile_1 = __importDefault(require("proper-lockfile"));
+const paths_js_1 = require("../../config/paths.js");
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_TIMEOUT_MS = 300000; // 5 minutes
+const LOCK_OPTIONS = {
+    retries: {
+        retries: 5,
+        minTimeout: 50,
+        maxTimeout: 1000,
+    },
+    stale: 10000, // Consider lock stale after 10 seconds
+};
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Get the directory path for tasks in a project
+ * @param workingDirectory - Absolute path to project working directory
+ */
+function getTasksDirectory(workingDirectory) {
+    return (0, paths_js_1.getProjectTasksDir)(workingDirectory);
+}
+/**
+ * Get the file path for a specific task
+ * @param workingDirectory - Absolute path to project working directory
+ * @param taskId - Task ID
+ */
+function getTaskFilePath(workingDirectory, taskId) {
+    return `${getTasksDirectory(workingDirectory)}/${taskId}.json`;
+}
+/**
+ * Validate state transition is legal
+ * @throws Error if transition is invalid
+ */
+function validateStateTransition(currentStatus, newStatus) {
+    const validTransitions = {
+        pending: ['running', 'canceled'],
+        running: ['completed', 'failed', 'canceled'],
+        completed: [], // Terminal state
+        failed: [], // Terminal state
+        canceled: [], // Terminal state
+    };
+    const allowedNext = validTransitions[currentStatus];
+    if (!allowedNext.includes(newStatus)) {
+        throw new Error(`Invalid state transition: ${currentStatus} → ${newStatus}. ` +
+            `Allowed transitions from ${currentStatus}: ${allowedNext.join(', ')}`);
+    }
+}
+/**
+ * Ensure tasks directory exists
+ * @param workingDirectory - Absolute path to project working directory
+ */
+async function ensureTasksDirectory(workingDirectory) {
+    const tasksDir = getTasksDirectory(workingDirectory);
+    await promises_1.default.mkdir(tasksDir, { recursive: true });
+}
+// ============================================================================
+// TaskManager Class
+// ============================================================================
+/**
+ * Task Manager Service
+ * Handles all task CRUD operations with file-based persistence
+ */
+class TaskManager {
+    /**
+     * Create a new task
+     * Task starts in 'pending' state
+     *
+     * @param params - Task creation parameters
+     * @returns Created task object
+     * @throws Error if task creation fails
+     */
+    async createTask(params) {
+        const { workingDirectory, projectId, agentId, a2aAgentId, input, timeoutMs = DEFAULT_TIMEOUT_MS, pushNotificationConfig } = params;
+        // Generate unique task ID
+        const taskId = (0, uuid_1.v4)();
+        // Ensure directory exists
+        await ensureTasksDirectory(workingDirectory);
+        // Create task object
+        const now = new Date().toISOString();
+        const task = {
+            id: taskId,
+            projectId,
+            agentId,
+            a2aAgentId,
+            status: 'pending',
+            input,
+            timeoutMs,
+            createdAt: now,
+            updatedAt: now,
+            pushNotificationConfig,
+        };
+        // Write task file
+        const taskFilePath = getTaskFilePath(workingDirectory, taskId);
+        const taskContent = JSON.stringify(task, null, 2);
+        await promises_1.default.writeFile(taskFilePath, taskContent, 'utf-8');
+        console.info('[TaskManager] Task created:', {
+            taskId,
+            projectId,
+            workingDirectory,
+            agentId,
+            timeoutMs,
+            hasWebhook: !!pushNotificationConfig?.url,
+        });
+        return task;
+    }
+    /**
+     * Get task by ID
+     *
+     * @param workingDirectory - Absolute path to project working directory
+     * @param taskId - Task ID
+     * @returns Task object or null if not found
+     */
+    async getTask(workingDirectory, taskId) {
+        try {
+            const taskFilePath = getTaskFilePath(workingDirectory, taskId);
+            const taskContent = await promises_1.default.readFile(taskFilePath, 'utf-8');
+            const task = JSON.parse(taskContent);
+            return task;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null; // Task not found
+            }
+            throw error;
+        }
+    }
+    /**
+     * Update task status and related fields
+     * Validates state transitions and uses file locking for atomicity
+     *
+     * @param workingDirectory - Absolute path to project working directory
+     * @param taskId - Task ID
+     * @param newStatus - New task status
+     * @param updates - Additional fields to update
+     * @throws Error if task not found or invalid transition
+     */
+    async updateTaskStatus(workingDirectory, taskId, newStatus, updates) {
+        const taskFilePath = getTaskFilePath(workingDirectory, taskId);
+        // First check if task exists before trying to lock
+        const task = await this.getTask(workingDirectory, taskId);
+        if (!task) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        // Acquire lock for atomic update
+        let release = null;
+        try {
+            release = await proper_lockfile_1.default.lock(taskFilePath, LOCK_OPTIONS);
+            // Validate state transition
+            validateStateTransition(task.status, newStatus);
+            // Update task
+            const now = new Date().toISOString();
+            const updatedTask = {
+                ...task,
+                status: newStatus,
+                updatedAt: now,
+                ...updates,
+            };
+            // Write updated task
+            const taskContent = JSON.stringify(updatedTask, null, 2);
+            await promises_1.default.writeFile(taskFilePath, taskContent, 'utf-8');
+            console.info('[TaskManager] Task status updated:', {
+                taskId,
+                projectId: task.projectId,
+                workingDirectory,
+                oldStatus: task.status,
+                newStatus,
+            });
+            return updatedTask;
+        }
+        finally {
+            // Release lock
+            if (release) {
+                await release();
+            }
+        }
+    }
+    /**
+     * Cancel a task
+     * Only pending or running tasks can be canceled
+     *
+     * @param workingDirectory - Absolute path to project working directory
+     * @param taskId - Task ID
+     * @returns Updated task object
+     * @throws Error if task cannot be canceled
+     */
+    async cancelTask(workingDirectory, taskId) {
+        const task = await this.getTask(workingDirectory, taskId);
+        if (!task) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        // Check if task can be canceled
+        if (['completed', 'failed', 'canceled'].includes(task.status)) {
+            throw new Error(`Cannot cancel task in ${task.status} state. Only pending or running tasks can be canceled.`);
+        }
+        // Update status to canceled
+        return this.updateTaskStatus(workingDirectory, taskId, 'canceled', {
+            completedAt: new Date().toISOString(),
+        });
+    }
+    /**
+     * List all tasks for a project
+     *
+     * @param workingDirectory - Absolute path to project working directory
+     * @param statusFilter - Optional status filter
+     * @returns Array of tasks
+     */
+    async listTasks(workingDirectory, statusFilter) {
+        try {
+            const tasksDir = getTasksDirectory(workingDirectory);
+            const files = await promises_1.default.readdir(tasksDir);
+            const tasks = [];
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                const taskId = file.replace('.json', '');
+                const task = await this.getTask(workingDirectory, taskId);
+                if (task && (!statusFilter || task.status === statusFilter)) {
+                    tasks.push(task);
+                }
+            }
+            // Sort by creation time (newest first)
+            tasks.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+            return tasks;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return []; // No tasks directory yet
+            }
+            throw error;
+        }
+    }
+}
+exports.TaskManager = TaskManager;
+// ============================================================================
+// Singleton Instance
+// ============================================================================
+/**
+ * Singleton instance of TaskManager
+ */
+exports.taskManager = new TaskManager();
+//# sourceMappingURL=taskManager.js.map

package/services/a2a/taskManager.js.map

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

package/services/a2a/webhookService.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Webhook Service for A2A Task Completion Notifications
+ *
+ * Handles sending webhook callbacks when async tasks complete,
+ * with support for retries and authentication.
+ */
+import type { PushNotificationConfig } from '../../types/a2a.js';
+export interface WebhookResult {
+    success: boolean;
+    attempts: number;
+    error?: string;
+}
+/**
+ * Send task completion webhook notification
+ *
+ * @param config - Push notification configuration (URL, auth, etc.)
+ * @param taskId - Task identifier
+ * @param status - Task completion status
+ * @param output - Task output (for completed tasks)
+ * @param errorDetails - Error details (for failed tasks)
+ * @returns Result indicating success/failure and number of attempts
+ */
+export declare function sendTaskCompletionWebhook(config: PushNotificationConfig, taskId: string, status: 'completed' | 'failed' | 'canceled', output?: {
+    result: string;
+}, errorDetails?: {
+    message: string;
+    code: string;
+    stack?: string;
+}): Promise<WebhookResult>;
+//# sourceMappingURL=webhookService.d.ts.map

package/services/a2a/webhookService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhookService.d.ts","sourceRoot":"","sources":["../../../src/services/a2a/webhookService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAMjE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4BD;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,EAC3C,MAAM,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAC3B,YAAY,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,aAAa,CAAC,CA8CxB"}

package/services/a2a/webhookService.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * Webhook Service for A2A Task Completion Notifications
+ *
+ * Handles sending webhook callbacks when async tasks complete,
+ * with support for retries and authentication.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendTaskCompletionWebhook = sendTaskCompletionWebhook;
+// ============================================================================
+// Configuration
+// ============================================================================
+const WEBHOOK_CONFIG = {
+    maxRetries: 3,
+    retryDelayMs: 1000, // 1 second
+    timeoutMs: 10000, // 10 seconds
+};
+// ============================================================================
+// Main Functions
+// ============================================================================
+/**
+ * Send task completion webhook notification
+ *
+ * @param config - Push notification configuration (URL, auth, etc.)
+ * @param taskId - Task identifier
+ * @param status - Task completion status
+ * @param output - Task output (for completed tasks)
+ * @param errorDetails - Error details (for failed tasks)
+ * @returns Result indicating success/failure and number of attempts
+ */
+async function sendTaskCompletionWebhook(config, taskId, status, output, errorDetails) {
+    const payload = {
+        taskId,
+        status,
+        output,
+        error: errorDetails,
+        timestamp: new Date().toISOString(),
+    };
+    let attempts = 0;
+    let lastError;
+    // Retry loop
+    for (let i = 0; i <= WEBHOOK_CONFIG.maxRetries; i++) {
+        attempts++;
+        try {
+            await sendWebhookRequest(config, payload);
+            // Success!
+            return {
+                success: true,
+                attempts,
+            };
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error.message : String(error);
+            // Log the failure
+            console.warn(`[WebhookService] Attempt ${attempts}/${WEBHOOK_CONFIG.maxRetries + 1} failed for task ${taskId}: ${lastError}`);
+            // If not the last attempt, wait before retrying
+            if (i < WEBHOOK_CONFIG.maxRetries) {
+                const delay = WEBHOOK_CONFIG.retryDelayMs * Math.pow(2, i); // Exponential backoff
+                await sleep(delay);
+            }
+        }
+    }
+    // All retries failed
+    return {
+        success: false,
+        attempts,
+        error: lastError,
+    };
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Send a single webhook HTTP request
+ */
+async function sendWebhookRequest(config, payload) {
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    // Add authentication if configured
+    if (config.authentication?.schemes && config.authentication.credentials) {
+        const scheme = config.authentication.schemes[0]; // Use first scheme
+        headers['Authorization'] = `${scheme} ${config.authentication.credentials}`;
+    }
+    else if (config.token) {
+        // Fallback to token field
+        headers['Authorization'] = `Bearer ${config.token}`;
+    }
+    // Use fetch API (available in Node 18+)
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), WEBHOOK_CONFIG.timeoutMs);
+    try {
+        const response = await fetch(config.url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(payload),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            throw new Error(`Webhook request failed with status ${response.status}: ${response.statusText}`);
+        }
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Sleep for specified milliseconds
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=webhookService.js.map

package/services/a2a/webhookService.js.map

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

package/services/agentStorage.d.ts

@@ -0,0 +1,27 @@
+import { AgentConfig, AgentSession, AgentMessage } from '../types/agents';
+export declare class AgentStorage {
+    private agentsDir;
+    private workingDir;
+    constructor(workingDir?: string);
+    private ensureDirectoriesExist;
+    private getSessionsDir;
+    private initializeBuiltinAgents;
+    getAllAgents(): AgentConfig[];
+    getAgent(agentId: string): AgentConfig | null;
+    saveAgent(agent: AgentConfig): void;
+    deleteAgent(agentId: string): boolean;
+    createAgent(agentData: Omit<AgentConfig, 'createdAt' | 'updatedAt'>): AgentConfig;
+    getAgentSessionsDir(agentId: string): string;
+    getAgentSessions(agentId: string, searchTerm?: string): AgentSession[];
+    getSession(agentId: string, sessionId: string): AgentSession | null;
+    createSession(agentId: string, title?: string): AgentSession;
+    createSessionWithId(agentId: string, sessionId: string, title?: string): AgentSession;
+    saveSession(session: AgentSession): void;
+    deleteSession(agentId: string, sessionId: string): boolean;
+    deleteAgentSessions(agentId: string): void;
+    private shouldUpdateTitle;
+    private updateSessionTitle;
+    private fallbackTitleGeneration;
+    addMessageToSession(agentId: string, sessionId: string, message: Omit<AgentMessage, 'id' | 'timestamp' | 'agentId'>): AgentMessage | null;
+}
+//# sourceMappingURL=agentStorage.d.ts.map

package/services/agentStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentStorage.d.ts","sourceRoot":"","sources":["../../src/services/agentStorage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAkB,MAAM,iBAAiB,CAAC;AAI1F,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,GAAE,MAAsB;IAW9C,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,uBAAuB;IAqB/B,YAAY,IAAI,WAAW,EAAE;IAwC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAqC7C,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAWnC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IA4CrC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG,WAAW;IAejF,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAQ5C,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAyDtE,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAcnE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY;IAiB5D,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY;IAiBrF,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAWxC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAe1D,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAe1C,OAAO,CAAC,iBAAiB;YAKX,kBAAkB;IAwFhC,OAAO,CAAC,uBAAuB;IAoB/B,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,GAAG,SAAS,CAAC,GAAG,YAAY,GAAG,IAAI;CAiC1I"}