agentstudio 0.1.26 → 0.1.28

package/services/taskExecutor/taskWorker.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Task Worker - Executes tasks in isolated worker threads
+ *
+ * This worker runs in a separate thread and handles:
+ * 1. Building query options for Claude SDK
+ * 2. Executing the agent task
+ * 3. Collecting logs and results
+ * 4. Reporting results back to main thread
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const worker_threads_1 = require("worker_threads");
+const claude_agent_sdk_1 = require("@anthropic-ai/claude-agent-sdk");
+const claudeUtils_js_1 = require("../../utils/claudeUtils.js");
+const agentStorage_js_1 = require("../../services/agentStorage.js");
+// ============================================================================
+// Worker Execution
+// ============================================================================
+/**
+ * Main execution function
+ */
+async function executeTask(task) {
+    const startTime = Date.now();
+    const logs = [];
+    const addLog = (level, type, message, data) => {
+        const log = {
+            timestamp: new Date().toISOString(),
+            level,
+            type,
+            message,
+            data,
+        };
+        logs.push(log);
+        // Send log to parent process for real-time monitoring
+        worker_threads_1.parentPort?.postMessage({
+            type: 'log',
+            data: log,
+        });
+    };
+    try {
+        addLog('info', 'system', `Starting task execution: ${task.id}`);
+        addLog('info', 'system', `Task type: ${task.type}`);
+        addLog('info', 'system', `Agent: ${task.agentId}`);
+        addLog('info', 'system', `Project: ${task.projectPath}`);
+        addLog('info', 'system', `Message: ${task.message.substring(0, 100)}...`);
+        // Load agent configuration
+        const agentStorage = new agentStorage_js_1.AgentStorage();
+        const agent = agentStorage.getAgent(task.agentId);
+        if (!agent) {
+            throw new Error(`Agent not found: ${task.agentId}`);
+        }
+        addLog('info', 'system', `Agent loaded: ${agent.name}`);
+        // Determine model to use
+        // Model priority: task.modelId > project/provider config (default: sonnet)
+        const modelToUse = task.modelId || 'sonnet';
+        addLog('info', 'system', `Model: ${modelToUse}`);
+        // Determine permission mode
+        const permissionMode = task.permissionMode || 'bypassPermissions';
+        addLog('info', 'system', `Permission mode: ${permissionMode}`);
+        // Build query options
+        addLog('info', 'system', 'Building query options...');
+        const { queryOptions } = await (0, claudeUtils_js_1.buildQueryOptions)(agent, task.projectPath, undefined, // mcpTools
+        permissionMode, modelToUse, task.claudeVersionId, undefined, // defaultEnv
+        undefined, // userEnv
+        undefined, // sessionIdForAskUser
+        undefined // agentIdForAskUser
+        );
+        // Set max turns
+        queryOptions.maxTurns = task.maxTurns || agent.maxTurns || 10;
+        addLog('info', 'system', `Max turns: ${queryOptions.maxTurns}`);
+        // Execute query
+        addLog('info', 'system', 'Starting Claude query...');
+        let fullResponse = '';
+        let sessionId;
+        for await (const message of (0, claude_agent_sdk_1.query)({
+            prompt: task.message,
+            options: queryOptions,
+        })) {
+            // Capture session ID
+            if (message.session_id && !sessionId) {
+                sessionId = message.session_id;
+                addLog('info', 'system', `Session ID: ${sessionId}`);
+            }
+            // Process different message types
+            if (message.type === 'assistant' && message.message?.content) {
+                for (const block of message.message.content) {
+                    if (block.type === 'text') {
+                        fullResponse += block.text;
+                        addLog('debug', 'assistant', block.text.substring(0, 200));
+                    }
+                    else if (block.type === 'tool_use') {
+                        addLog('info', 'tool_use', `Tool: ${block.name}`);
+                    }
+                }
+            }
+            else if (message.type === 'result') {
+                addLog('info', 'result', `Query completed`, {
+                    costUsd: message.total_cost_usd,
+                    durationMs: message.duration_ms,
+                    numTurns: message.num_turns,
+                });
+            }
+        }
+        const executionTimeMs = Date.now() - startTime;
+        addLog('info', 'system', `Task completed in ${executionTimeMs}ms`);
+        return {
+            taskId: task.id,
+            status: 'completed',
+            output: fullResponse,
+            sessionId,
+            completedAt: new Date().toISOString(),
+            executionTimeMs,
+            logs,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorStack = error instanceof Error ? error.stack : undefined;
+        addLog('error', 'system', `Task failed: ${errorMessage}`, { stack: errorStack });
+        return {
+            taskId: task.id,
+            status: 'failed',
+            error: errorMessage,
+            errorStack,
+            completedAt: new Date().toISOString(),
+            executionTimeMs: Date.now() - startTime,
+            logs,
+        };
+    }
+}
+// ============================================================================
+// Worker Entry Point
+// ============================================================================
+/**
+ * Worker entry point - receives task data and executes it
+ */
+async function main() {
+    try {
+        const task = worker_threads_1.workerData;
+        if (!task || !task.id) {
+            throw new Error('Invalid task data received');
+        }
+        // Execute the task
+        const result = await executeTask(task);
+        // Send result back to parent
+        worker_threads_1.parentPort?.postMessage({
+            type: 'complete',
+            data: result,
+        });
+    }
+    catch (error) {
+        // Send error back to parent
+        worker_threads_1.parentPort?.postMessage({
+            type: 'error',
+            data: {
+                taskId: worker_threads_1.workerData?.id || 'unknown',
+                status: 'failed',
+                error: error instanceof Error ? error.message : String(error),
+                completedAt: new Date().toISOString(),
+                executionTimeMs: 0,
+            },
+        });
+    }
+}
+// Start execution
+main().catch((err) => {
+    console.error('[TaskWorker] Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=taskWorker.js.map

package/services/taskExecutor/taskWorker.js.map

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

package/services/taskExecutor/types.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Unified Task Executor Types
+ *
+ * Defines the interfaces for a pluggable task execution system that supports
+ * both A2A async tasks and scheduled tasks.
+ */
+/**
+ * Task type identifier
+ */
+export type TaskType = 'a2a_async' | 'scheduled';
+/**
+ * Permission mode for task execution
+ */
+export type PermissionMode = 'bypassPermissions' | 'default';
+/**
+ * Push Notification Configuration for task callbacks
+ */
+export interface TaskPushNotificationConfig {
+    url: string;
+    token?: string;
+    authScheme?: string;
+    authCredentials?: string;
+}
+/**
+ * Task definition - submitted to executor
+ */
+export interface TaskDefinition {
+    id: string;
+    type: TaskType;
+    priority?: number;
+    agentId: string;
+    projectPath: string;
+    message: string;
+    timeoutMs: number;
+    maxTurns?: number;
+    modelId?: string;
+    claudeVersionId?: string;
+    permissionMode?: PermissionMode;
+    createdAt: string;
+    scheduledFor?: string;
+    scheduledTaskId?: string;
+    pushNotificationConfig?: TaskPushNotificationConfig;
+}
+/**
+ * Task execution result
+ */
+export interface TaskResult {
+    taskId: string;
+    status: 'completed' | 'failed' | 'canceled';
+    output?: string;
+    sessionId?: string;
+    error?: string;
+    errorStack?: string;
+    completedAt: string;
+    executionTimeMs: number;
+    logs?: Array<{
+        timestamp: string;
+        level: 'info' | 'warn' | 'error' | 'debug';
+        type: string;
+        message: string;
+        data?: Record<string, unknown>;
+    }>;
+}
+/**
+ * Task status query result
+ */
+export interface TaskStatus {
+    taskId: string;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'canceled';
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    executionTimeMs?: number;
+    error?: string;
+}
+/**
+ * Task executor configuration
+ */
+export interface TaskExecutorConfig {
+    maxConcurrent: number;
+    defaultTimeoutMs: number;
+    maxMemoryMb?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+}
+/**
+ * Interface for task executor implementations
+ */
+export interface ITaskExecutor {
+    /**
+     * Start the executor
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the executor and cancel all running tasks
+     */
+    stop(): Promise<void>;
+    /**
+     * Submit a task for execution
+     * @param task - Task definition
+     */
+    submitTask(task: TaskDefinition): Promise<void>;
+    /**
+     * Cancel a running or pending task
+     * @param taskId - Task ID to cancel
+     * @returns true if task was canceled, false if not found or already completed
+     */
+    cancelTask(taskId: string): Promise<boolean>;
+    /**
+     * Get current status of a task
+     * @param taskId - Task ID to query
+     * @returns Task status or null if not found
+     */
+    getTaskStatus(taskId: string): Promise<TaskStatus | null>;
+    /**
+     * Check if executor is healthy
+     */
+    isHealthy(): boolean;
+    /**
+     * Get executor statistics
+     */
+    getStats(): TaskExecutorStats;
+    /**
+     * Get current executor configuration
+     */
+    getConfig(): TaskExecutorConfig;
+    /**
+     * Update executor configuration dynamically
+     * @param config - Partial configuration to update
+     */
+    updateConfig(config: Partial<TaskExecutorConfig>): void;
+}
+/**
+ * Executor statistics
+ */
+export interface TaskExecutorStats {
+    mode: string;
+    runningTasks: number;
+    queuedTasks: number;
+    completedTasks: number;
+    failedTasks: number;
+    canceledTasks: number;
+    uptimeMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/services/taskExecutor/types.d.ts.map

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

package/services/taskExecutor/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Unified Task Executor Types
+ *
+ * Defines the interfaces for a pluggable task execution system that supports
+ * both A2A async tasks and scheduled tasks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/services/taskExecutor/types.js.map

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

package/services/telemetry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Backend Telemetry Service
+ *
+ * Uses PostHog for anonymous usage data collection.
+ * - Default: disabled (opt-in model for backend)
+ * - Can be enabled via TELEMETRY_ENABLED=true
+ */
+/**
+ * Check if telemetry is enabled
+ */
+export declare function isTelemetryEnabled(): boolean;
+/**
+ * Track an event
+ */
+export declare function trackEvent(event: string, properties?: Record<string, string | number | boolean>): void;
+/**
+ * Track feature usage
+ */
+export declare function trackFeature(feature: string, action?: string): void;
+/**
+ * Track an error
+ */
+export declare function trackError(error: Error, component?: string): void;
+/**
+ * Track agent usage
+ */
+export declare function trackAgentUsage(agentId: string, action: 'chat_start' | 'chat_end' | 'tool_call', properties?: Record<string, string | number | boolean>): void;
+/**
+ * Track MCP server usage
+ */
+export declare function trackMcpUsage(serverName: string, action: 'connect' | 'disconnect' | 'tool_call' | 'error'): void;
+/**
+ * Track scheduled task execution
+ */
+export declare function trackScheduledTask(taskId: string, action: 'execute' | 'success' | 'failure'): void;
+/**
+ * Shutdown telemetry (flush pending events)
+ */
+export declare function shutdownTelemetry(): Promise<void>;
+//# sourceMappingURL=telemetry.d.ts.map

package/services/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/services/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2GH;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,IAAI,CAaN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAKnE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAwBjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,WAAW,EAC/C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,GACvD,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GACxC,IAAI,CAKN;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMvD"}

package/services/telemetry.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * Backend Telemetry Service
+ *
+ * Uses PostHog for anonymous usage data collection.
+ * - Default: disabled (opt-in model for backend)
+ * - Can be enabled via TELEMETRY_ENABLED=true
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTelemetryEnabled = isTelemetryEnabled;
+exports.trackEvent = trackEvent;
+exports.trackFeature = trackFeature;
+exports.trackError = trackError;
+exports.trackAgentUsage = trackAgentUsage;
+exports.trackMcpUsage = trackMcpUsage;
+exports.trackScheduledTask = trackScheduledTask;
+exports.shutdownTelemetry = shutdownTelemetry;
+const posthog_node_1 = require("posthog-node");
+const uuid_1 = require("uuid");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+// PostHog configuration (hardcoded for distribution)
+const POSTHOG_API_KEY = 'phc_5knpC9zvXXFaTJw4EMwrRBSYHIYW7b8ig6E14N8jYDp';
+const POSTHOG_HOST = 'https://app.posthog.com';
+// Backend telemetry can be disabled via environment variable (default: enabled for npm package users)
+const TELEMETRY_ENABLED = process.env.TELEMETRY_ENABLED !== 'false';
+// App version from package.json
+let APP_VERSION = '0.2.0';
+try {
+    const pkgPath = path.join(__dirname, '../../package.json');
+    if (fs.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        APP_VERSION = pkg.version || APP_VERSION;
+    }
+}
+catch {
+    // Ignore errors
+}
+// Instance ID storage
+const INSTANCE_ID_FILE = path.join(os.homedir(), '.agentstudio', 'instance_id');
+/**
+ * Get or create the instance ID for this backend installation
+ */
+function getInstanceId() {
+    try {
+        // Create directory if not exists
+        const dir = path.dirname(INSTANCE_ID_FILE);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Read existing ID or create new one
+        if (fs.existsSync(INSTANCE_ID_FILE)) {
+            return fs.readFileSync(INSTANCE_ID_FILE, 'utf-8').trim();
+        }
+        else {
+            const id = (0, uuid_1.v4)();
+            fs.writeFileSync(INSTANCE_ID_FILE, id);
+            return id;
+        }
+    }
+    catch {
+        // Fallback to random ID per process
+        return (0, uuid_1.v4)();
+    }
+}
+// PostHog client (lazy initialization)
+let posthogClient = null;
+let instanceId = null;
+/**
+ * Initialize the PostHog client
+ */
+function initPostHog() {
+    if (!TELEMETRY_ENABLED) {
+        console.log('[Telemetry] Backend telemetry is disabled. Set TELEMETRY_ENABLED=true to enable.');
+        return null;
+    }
+    try {
+        const client = new posthog_node_1.PostHog(POSTHOG_API_KEY, {
+            host: POSTHOG_HOST,
+            flushAt: 10,
+            flushInterval: 30000,
+        });
+        instanceId = getInstanceId();
+        console.log(`[Telemetry] Backend telemetry initialized (instance: ${instanceId.slice(0, 8)}...)`);
+        // Track backend start
+        client.capture({
+            distinctId: instanceId,
+            event: 'app_start',
+            properties: {
+                platform: 'backend',
+                app_version: APP_VERSION,
+                os: process.platform,
+                node_version: process.version,
+            },
+        });
+        return client;
+    }
+    catch (error) {
+        console.error('[Telemetry] Failed to initialize PostHog:', error);
+        return null;
+    }
+}
+/**
+ * Get the PostHog client (initializes if needed)
+ */
+function getClient() {
+    if (posthogClient === null && TELEMETRY_ENABLED) {
+        posthogClient = initPostHog();
+    }
+    return posthogClient;
+}
+/**
+ * Check if telemetry is enabled
+ */
+function isTelemetryEnabled() {
+    return TELEMETRY_ENABLED;
+}
+/**
+ * Track an event
+ */
+function trackEvent(event, properties) {
+    const client = getClient();
+    if (!client || !instanceId)
+        return;
+    client.capture({
+        distinctId: instanceId,
+        event,
+        properties: {
+            platform: 'backend',
+            app_version: APP_VERSION,
+            ...properties,
+        },
+    });
+}
+/**
+ * Track feature usage
+ */
+function trackFeature(feature, action) {
+    trackEvent('feature_used', {
+        feature,
+        action: action || 'use',
+    });
+}
+/**
+ * Track an error
+ */
+function trackError(error, component) {
+    const client = getClient();
+    if (!client || !instanceId)
+        return;
+    // Sanitize error message
+    const sanitizeMessage = (msg) => {
+        return msg
+            .replace(/(?:\/[^\s:]+)+/g, '[PATH]')
+            .replace(/(?:[A-Za-z]:\\[^\s:]+)+/g, '[PATH]')
+            .replace(/[a-zA-Z0-9]{32,}/g, '[REDACTED]')
+            .substring(0, 256);
+    };
+    client.capture({
+        distinctId: instanceId,
+        event: 'app_error',
+        properties: {
+            platform: 'backend',
+            app_version: APP_VERSION,
+            message: sanitizeMessage(error.message),
+            errorType: error.name,
+            component: component || 'unknown',
+        },
+    });
+}
+/**
+ * Track agent usage
+ */
+function trackAgentUsage(agentId, action, properties) {
+    trackEvent('agent_usage', {
+        agent_id: agentId,
+        action,
+        ...properties,
+    });
+}
+/**
+ * Track MCP server usage
+ */
+function trackMcpUsage(serverName, action) {
+    trackEvent('mcp_usage', {
+        server_name: serverName,
+        action,
+    });
+}
+/**
+ * Track scheduled task execution
+ */
+function trackScheduledTask(taskId, action) {
+    trackEvent('scheduled_task', {
+        task_id: taskId,
+        action,
+    });
+}
+/**
+ * Shutdown telemetry (flush pending events)
+ */
+async function shutdownTelemetry() {
+    const client = getClient();
+    if (client) {
+        await client.shutdown();
+        console.log('[Telemetry] Backend telemetry shutdown');
+    }
+}
+// Initialize on import if enabled
+getClient();
+//# sourceMappingURL=telemetry.js.map

package/services/telemetry.js.map

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

package/types/a2a.d.ts

@@ -91,6 +91,22 @@ export interface TaskError {
     code: string;
     stack?: string;
 }
+/**
+ * Push Notification Authentication Info (A2A Protocol)
+ */
+export interface PushNotificationAuthenticationInfo {
+    schemes: string[];
+    credentials?: string;
+}
+/**
+ * Push Notification Configuration (A2A Protocol)
+ * Configures webhook callbacks for async task completion
+ */
+export interface PushNotificationConfig {
+    url: string;
+    token?: string;
+    authentication?: PushNotificationAuthenticationInfo;
+}
 /**
  * A2A Task - represents a long-running asynchronous task
  */
@@ -109,6 +125,7 @@ export interface A2ATask {
     errorDetails?: TaskError;
     timeoutMs: number;
     contextId?: string;
+    pushNotificationConfig?: PushNotificationConfig;
 }
 /**
  * Allowed external agent configuration
@@ -198,6 +215,7 @@ export interface A2ATaskRequest {
     message: string;
     timeout?: number;
     context?: Record<string, unknown>;
+    pushNotificationConfig?: PushNotificationConfig;
 }
 /**
  * POST /a2a/:a2aAgentId/tasks response