@sowonai/crewx-sdk 0.1.0-dev.0 → 0.1.0-dev.1

package/README.md

@@ -433,6 +433,121 @@ export class DatabaseConversationProvider implements IConversationHistoryProvide
 }
 ```
 
+## Shared SDK/CLI Integration (WBS-9)
+
+The SDK provides reusable components that were previously CLI-only. These abstractions enable custom platform integrations while maintaining consistency.
+
+### Message Formatting (Phase 1)
+
+Create platform-specific message formatters:
+
+```typescript
+import {
+  BaseMessageFormatter,
+  StructuredMessage,
+  FormatterOptions
+} from '@sowonai/crewx-sdk';
+
+class CustomFormatter extends BaseMessageFormatter {
+  formatMessage(msg: StructuredMessage, options: FormatterOptions): string {
+    // Implement custom formatting
+    return `[${msg.userId}] ${msg.text}`;
+  }
+}
+
+const formatter = new CustomFormatter();
+const history = formatter.formatHistory(messages, {
+  includeUserId: true,
+  includeTimestamp: true,
+});
+```
+
+### AI Providers (Phase 2)
+
+Use built-in providers or create custom ones:
+
+```typescript
+import {
+  BaseAIProvider,
+  ClaudeProvider,
+  GeminiProvider,
+  CopilotProvider,
+  CodexProvider,
+  type LoggerLike,
+  type BaseAIProviderOptions
+} from '@sowonai/crewx-sdk';
+
+// Use built-in provider
+const claude = new ClaudeProvider({
+  apiKey: process.env.ANTHROPIC_API_KEY,
+  logger: console,
+  enableToolUse: true,
+  model: 'claude-3-5-sonnet-20241022',
+});
+
+// Custom provider
+class MyProvider extends BaseAIProvider {
+  constructor(options: BaseAIProviderOptions) {
+    super(options);
+  }
+
+  async query(prompt: string, options: AIQueryOptions): Promise<AIResponse> {
+    // Custom implementation
+    return { content: 'Response', metadata: {} };
+  }
+}
+```
+
+### Remote Agent Management (Phase 3)
+
+Manage remote agent communications:
+
+```typescript
+import {
+  RemoteAgentManager,
+  FetchRemoteTransport,
+  MockRemoteTransport,
+  type RemoteAgentConfig
+} from '@sowonai/crewx-sdk';
+
+// Production transport
+const transport = new FetchRemoteTransport({
+  timeout: 30000,
+  headers: { 'Authorization': `Bearer ${token}` },
+});
+
+// Testing transport
+const mockTransport = new MockRemoteTransport({
+  'agent-1': { content: 'Mocked response', success: true },
+});
+
+const manager = new RemoteAgentManager({
+  transport,
+  enableLogging: true,
+  logger: console,
+});
+
+// Load remote agent
+await manager.loadAgent({
+  id: 'backend',
+  url: 'https://api.example.com/agent',
+  apiKey: process.env.REMOTE_API_KEY,
+  tools: ['search', 'analyze'],
+});
+
+// Query remote agent
+const result = await manager.queryAgent('backend', 'Analyze codebase');
+console.log(result.content);
+```
+
+### Migration Guide
+
+For detailed migration instructions from CLI to SDK, see:
+- [WBS-9 Phase 1-5 Integration Guide](../../docs/wbs-9-phase1-5-integration.md)
+- [Phase 1: Message Formatter](../../docs/wbs-9-phase1-migration.md)
+- [Phase 2: AI Providers](../../docs/wbs-9-phase2-migration.md)
+- [Phase 3: Remote Agents](../../docs/wbs-9-phase3-migration.md)
+
 ## Advanced Usage
 
 ### Using Internal APIs

package/dist/core/parallel/index.d.ts

@@ -0,0 +1,2 @@
+export { ParallelRunner, ParallelRunnerTimeoutError, createDefaultParallelRunner, } from './parallel-runner';
+export type { ParallelRunnerMetrics, ParallelRunnerOptions, Task, TaskResult, TaskCallbacks, TaskExecutionContext, } from './types';

package/dist/core/parallel/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultParallelRunner = exports.ParallelRunnerTimeoutError = exports.ParallelRunner = void 0;
+var parallel_runner_1 = require("./parallel-runner");
+Object.defineProperty(exports, "ParallelRunner", { enumerable: true, get: function () { return parallel_runner_1.ParallelRunner; } });
+Object.defineProperty(exports, "ParallelRunnerTimeoutError", { enumerable: true, get: function () { return parallel_runner_1.ParallelRunnerTimeoutError; } });
+Object.defineProperty(exports, "createDefaultParallelRunner", { enumerable: true, get: function () { return parallel_runner_1.createDefaultParallelRunner; } });
+//# sourceMappingURL=index.js.map

package/dist/core/parallel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/parallel/index.ts"],"names":[],"mappings":";;;AAAA,qDAI2B;AAHzB,iHAAA,cAAc,OAAA;AACd,6HAAA,0BAA0B,OAAA;AAC1B,8HAAA,2BAA2B,OAAA"}

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

@@ -0,0 +1,16 @@
+import type { ParallelRunnerMetrics, ParallelRunnerOptions, Task, TaskResult } from './types';
+export declare class ParallelRunnerTimeoutError extends Error {
+    readonly taskId: string;
+    readonly timeoutMs: number;
+    constructor(taskId: string, timeoutMs: number);
+}
+export declare class ParallelRunner {
+    private readonly defaults;
+    private metrics;
+    constructor(defaults?: ParallelRunnerOptions);
+    run<T>(tasks: Task<T>[], options?: ParallelRunnerOptions<T>): Promise<TaskResult<T>[]>;
+    getMetrics(): ParallelRunnerMetrics;
+    private mergeOptions;
+    private mergeCallbacks;
+}
+export declare const createDefaultParallelRunner: () => ParallelRunner;

package/dist/core/parallel/parallel-runner.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultParallelRunner = exports.ParallelRunner = exports.ParallelRunnerTimeoutError = void 0;
+const node_perf_hooks_1 = require("node:perf_hooks");
+class ParallelRunnerTimeoutError extends Error {
+    constructor(taskId, timeoutMs) {
+        super(`Task ${taskId} timed out after ${timeoutMs}ms`);
+        this.taskId = taskId;
+        this.timeoutMs = timeoutMs;
+        this.name = 'ParallelRunnerTimeoutError';
+    }
+}
+exports.ParallelRunnerTimeoutError = ParallelRunnerTimeoutError;
+class ParallelRunner {
+    constructor(defaults = {}) {
+        this.defaults = defaults;
+        this.metrics = {
+            totalTasks: 0,
+            startedTasks: 0,
+            completedTasks: 0,
+            successCount: 0,
+            failureCount: 0,
+            totalDurationMs: 0,
+            averageDurationMs: 0,
+            throughput: 0,
+        };
+    }
+    async run(tasks, options = {}) {
+        if (!Array.isArray(tasks)) {
+            throw new TypeError('ParallelRunner.run expects an array of tasks');
+        }
+        if (tasks.length === 0) {
+            this.metrics = {
+                totalTasks: 0,
+                startedTasks: 0,
+                completedTasks: 0,
+                successCount: 0,
+                failureCount: 0,
+                totalDurationMs: 0,
+                averageDurationMs: 0,
+                throughput: 0,
+            };
+            return [];
+        }
+        const merged = this.mergeOptions(options);
+        const maxConcurrency = Math.max(1, merged.maxConcurrency ?? 5);
+        const timeoutMs = merged.timeoutMs;
+        const failFast = merged.failFast ?? false;
+        const callbacks = merged.callbacks;
+        const evaluateTaskSuccess = merged.evaluateTaskSuccess ?? (() => true);
+        const results = [];
+        let successCount = 0;
+        let failureCount = 0;
+        let startedTasks = 0;
+        let aborted = false;
+        let cursor = 0;
+        const startedAt = node_perf_hooks_1.performance.now();
+        const executeTask = async (task) => {
+            if (callbacks?.onTaskStart) {
+                await callbacks.onTaskStart(task);
+            }
+            startedTasks += 1;
+            const controller = new AbortController();
+            const context = { signal: controller.signal };
+            let timeoutId;
+            let timeoutPromise;
+            if (typeof timeoutMs === 'number' && Number.isFinite(timeoutMs) && timeoutMs > 0) {
+                timeoutPromise = new Promise((_, reject) => {
+                    timeoutId = setTimeout(() => {
+                        const timeoutError = new ParallelRunnerTimeoutError(task.id, timeoutMs);
+                        controller.abort(timeoutError);
+                        reject(timeoutError);
+                    }, timeoutMs);
+                });
+            }
+            const startedAtTask = node_perf_hooks_1.performance.now();
+            const runPromise = task.run(context);
+            const combinedPromise = timeoutPromise
+                ? Promise.race([runPromise, timeoutPromise])
+                : runPromise;
+            try {
+                const value = await combinedPromise;
+                const finishedAtTask = node_perf_hooks_1.performance.now();
+                const durationMs = finishedAtTask - startedAtTask;
+                const success = evaluateTaskSuccess(value, task);
+                const result = {
+                    taskId: task.id,
+                    success,
+                    value,
+                    durationMs,
+                    startedAt: startedAtTask,
+                    finishedAt: finishedAtTask,
+                    metadata: task.metadata,
+                    aborted: false,
+                };
+                results.push(result);
+                success ? (successCount += 1) : (failureCount += 1);
+                if (callbacks?.onTaskComplete) {
+                    await callbacks.onTaskComplete(result);
+                }
+                if (failFast && !success) {
+                    aborted = true;
+                }
+            }
+            catch (rawError) {
+                const finishedAtTask = node_perf_hooks_1.performance.now();
+                const durationMs = finishedAtTask - startedAtTask;
+                const error = rawError instanceof Error ? rawError : new Error(String(rawError));
+                const result = {
+                    taskId: task.id,
+                    success: false,
+                    error,
+                    durationMs,
+                    startedAt: startedAtTask,
+                    finishedAt: finishedAtTask,
+                    metadata: task.metadata,
+                    aborted: controller.signal.aborted,
+                };
+                results.push(result);
+                failureCount += 1;
+                if (callbacks?.onError) {
+                    await callbacks.onError(task, error, durationMs);
+                }
+                if (failFast) {
+                    aborted = true;
+                }
+            }
+            finally {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+                if (timeoutPromise) {
+                    runPromise.catch(() => undefined);
+                }
+            }
+        };
+        const worker = async () => {
+            while (true) {
+                if (aborted) {
+                    break;
+                }
+                const currentIndex = cursor;
+                if (currentIndex >= tasks.length) {
+                    break;
+                }
+                cursor += 1;
+                const task = tasks[currentIndex];
+                if (!task) {
+                    break;
+                }
+                await executeTask(task);
+                if (aborted) {
+                    break;
+                }
+            }
+        };
+        const workers = [];
+        const workerCount = Math.min(maxConcurrency, tasks.length);
+        for (let i = 0; i < workerCount; i += 1) {
+            workers.push(worker());
+        }
+        await Promise.all(workers);
+        const finishedAt = node_perf_hooks_1.performance.now();
+        const totalDurationMs = finishedAt - startedAt;
+        const averageDurationMs = results.length
+            ? results.reduce((sum, item) => sum + item.durationMs, 0) / results.length
+            : 0;
+        const throughput = totalDurationMs > 0
+            ? (results.length / (totalDurationMs / 1000))
+            : results.length;
+        this.metrics = {
+            totalTasks: tasks.length,
+            startedTasks,
+            completedTasks: results.length,
+            successCount,
+            failureCount,
+            totalDurationMs,
+            averageDurationMs,
+            throughput,
+        };
+        return results;
+    }
+    getMetrics() {
+        return this.metrics;
+    }
+    mergeOptions(options) {
+        return {
+            maxConcurrency: options.maxConcurrency ?? this.defaults.maxConcurrency,
+            timeoutMs: options.timeoutMs ?? this.defaults.timeoutMs,
+            failFast: options.failFast ?? this.defaults.failFast,
+            evaluateTaskSuccess: options.evaluateTaskSuccess ?? this.defaults.evaluateTaskSuccess,
+            callbacks: this.mergeCallbacks(this.defaults.callbacks, options.callbacks),
+        };
+    }
+    mergeCallbacks(base, override) {
+        if (!base && !override) {
+            return undefined;
+        }
+        return {
+            onTaskStart: async (task) => {
+                if (base?.onTaskStart) {
+                    await base.onTaskStart(task);
+                }
+                if (override?.onTaskStart) {
+                    await override.onTaskStart(task);
+                }
+            },
+            onTaskComplete: async (result) => {
+                if (base?.onTaskComplete) {
+                    await base.onTaskComplete(result);
+                }
+                if (override?.onTaskComplete) {
+                    await override.onTaskComplete(result);
+                }
+            },
+            onError: async (task, error, durationMs) => {
+                if (base?.onError) {
+                    await base.onError(task, error, durationMs);
+                }
+                if (override?.onError) {
+                    await override.onError(task, error, durationMs);
+                }
+            },
+        };
+    }
+}
+exports.ParallelRunner = ParallelRunner;
+const createDefaultParallelRunner = () => new ParallelRunner();
+exports.createDefaultParallelRunner = createDefaultParallelRunner;
+//# sourceMappingURL=parallel-runner.js.map

package/dist/core/parallel/parallel-runner.js.map

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

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

@@ -0,0 +1,41 @@
+export interface Task<T> {
+    id: string;
+    metadata?: Record<string, unknown>;
+    run: (context: TaskExecutionContext) => Promise<T>;
+}
+export interface TaskExecutionContext {
+    signal: AbortSignal;
+}
+export interface TaskResult<T> {
+    taskId: string;
+    success: boolean;
+    value?: T;
+    error?: Error;
+    durationMs: number;
+    startedAt: number;
+    finishedAt: number;
+    metadata?: Record<string, unknown>;
+    aborted?: boolean;
+}
+export interface TaskCallbacks<T> {
+    onTaskStart?: (task: Task<T>) => void | Promise<void>;
+    onTaskComplete?: (result: TaskResult<T>) => void | Promise<void>;
+    onError?: (task: Task<T>, error: Error, durationMs: number) => void | Promise<void>;
+}
+export interface ParallelRunnerOptions<T = unknown> {
+    maxConcurrency?: number;
+    timeoutMs?: number;
+    failFast?: boolean;
+    callbacks?: TaskCallbacks<T>;
+    evaluateTaskSuccess?: (value: T, task: Task<T>) => boolean;
+}
+export interface ParallelRunnerMetrics {
+    totalTasks: number;
+    startedTasks: number;
+    completedTasks: number;
+    successCount: number;
+    failureCount: number;
+    totalDurationMs: number;
+    averageDurationMs: number;
+    throughput: number;
+}

package/dist/core/parallel/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/parallel/types.js.map

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

package/dist/core/providers/base-ai.provider.d.ts

@@ -1,31 +1,16 @@
-import { Logger } from '@nestjs/common';
-import { AIProvider, AIQueryOptions, AIResponse } from './ai-provider.interface';
-export interface Tool {
-    name: string;
-    description: string;
-    input_schema: {
-        type: 'object';
-        properties: Record<string, any>;
-        required?: string[];
-    };
-    output_schema?: {
-        type: 'object';
-        properties: Record<string, any>;
-        required?: string[];
-    };
-}
-export interface ToolCallService {
-    list(): Tool[];
-    execute(toolName: string, toolInput: any): Promise<any>;
-}
+import { type TimeoutConfig } from '../../config/timeout.config';
+import type { AIProvider, AIQueryOptions, AIResponse } from './ai-provider.interface';
+import type { BaseAIProviderOptions, LoggerLike } from './base-ai.types';
+import type { ToolCallHandler } from './tool-call.types';
 export declare abstract class BaseAIProvider implements AIProvider {
     abstract readonly name: string;
-    protected readonly logger: Logger;
-    protected toolCallService?: ToolCallService;
+    protected readonly logger: LoggerLike;
+    protected toolCallHandler?: ToolCallHandler;
     private readonly logsDir;
+    private readonly crewxVersion;
     private cachedPath;
-    protected readonly timeoutConfig: import("../../config/timeout.config").TimeoutConfig;
-    constructor(loggerContext: string);
+    protected readonly timeoutConfig: TimeoutConfig;
+    constructor(loggerContext: string, options?: BaseAIProviderOptions);
     protected abstract getCliCommand(): string;
     protected abstract getDefaultArgs(): string[];
     protected abstract getExecuteArgs(): string[];
@@ -36,7 +21,8 @@ export declare abstract class BaseAIProvider implements AIProvider {
     protected getDefaultModel(): string | null;
     protected getEnv(): Record<string, string>;
     protected substituteModelPlaceholders(args: string[], model: string): string[];
-    protected setToolCallService(toolCallService: ToolCallService): void;
+    protected setToolCallService(toolCallHandler: ToolCallHandler): void;
+    protected setToolCallHandler(toolCallHandler: ToolCallHandler): void;
     protected parseToolUse(content: string): {
         isToolUse: boolean;
         toolName?: string;
@@ -57,7 +43,7 @@ export declare abstract class BaseAIProvider implements AIProvider {
     protected extractUserQuery(wrappedQuery: string, securityKey: string): string;
     isAvailable(): Promise<boolean>;
     private createTaskLogFile;
-    private appendTaskLog;
+    protected appendTaskLog(taskId: string, level: 'STDOUT' | 'STDERR' | 'INFO' | 'ERROR', message: string): void;
     query(prompt: string, options?: AIQueryOptions): Promise<AIResponse>;
     execute(prompt: string, options?: AIQueryOptions): Promise<AIResponse>;
     protected shouldPipeContext(_options?: AIQueryOptions): boolean;

package/dist/core/providers/base-ai.provider.js

@@ -1,27 +1,33 @@
 "use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseAIProvider = void 0;
-const common_1 = require("@nestjs/common");
 const child_process_1 = require("child_process");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const timeout_config_1 = require("../../config/timeout.config");
-const version_1 = require("../../version");
-let BaseAIProvider = class BaseAIProvider {
-    constructor(loggerContext) {
-        this.logsDir = (0, path_1.join)(process.cwd(), '.crewx', 'logs');
+class ConsoleLogger {
+    constructor(context) {
+        this.context = context;
+    }
+    log(message, ...optionalParams) {
+        console.log(`[${this.context}]`, message, ...optionalParams);
+    }
+    warn(message, ...optionalParams) {
+        console.warn(`[${this.context}]`, message, ...optionalParams);
+    }
+    error(message, ...optionalParams) {
+        const resolved = message instanceof Error ? message.message : message;
+        console.error(`[${this.context}]`, resolved, ...optionalParams);
+    }
+}
+class BaseAIProvider {
+    constructor(loggerContext, options = {}) {
         this.cachedPath = null;
-        this.timeoutConfig = (0, timeout_config_1.getTimeoutConfig)();
-        this.logger = new common_1.Logger(loggerContext);
+        this.logger = options.logger ?? new ConsoleLogger(loggerContext);
+        this.toolCallHandler = options.toolCallHandler;
+        this.timeoutConfig = options.timeoutConfig ?? (0, timeout_config_1.getTimeoutConfig)();
+        this.logsDir = options.logsDir ?? (0, path_1.join)(process.cwd(), '.crewx', 'logs');
+        this.crewxVersion = options.crewxVersion ?? 'unknown';
         try {
             (0, fs_1.mkdirSync)(this.logsDir, { recursive: true });
         }
@@ -32,20 +38,22 @@ let BaseAIProvider = class BaseAIProvider {
         return false;
     }
     getDefaultQueryTimeout() {
-        if (this.name === 'claude')
+        const providerName = this.name.toLowerCase();
+        if (providerName.includes('claude'))
             return this.timeoutConfig.claudeQuery;
-        if (this.name === 'gemini')
+        if (providerName.includes('gemini'))
             return this.timeoutConfig.geminiQuery;
-        if (this.name === 'copilot')
+        if (providerName.includes('copilot'))
             return this.timeoutConfig.copilotQuery;
         return 600000;
     }
     getDefaultExecuteTimeout() {
-        if (this.name === 'claude')
+        const providerName = this.name.toLowerCase();
+        if (providerName.includes('claude'))
             return this.timeoutConfig.claudeExecute;
-        if (this.name === 'gemini')
+        if (providerName.includes('gemini'))
             return this.timeoutConfig.geminiExecute;
-        if (this.name === 'copilot')
+        if (providerName.includes('copilot'))
             return this.timeoutConfig.copilotExecute;
         return this.timeoutConfig.parallel;
     }
@@ -58,8 +66,11 @@ let BaseAIProvider = class BaseAIProvider {
     substituteModelPlaceholders(args, model) {
         return args.map(arg => arg.replace(/\{model\}/g, model));
     }
-    setToolCallService(toolCallService) {
-        this.toolCallService = toolCallService;
+    setToolCallService(toolCallHandler) {
+        this.toolCallHandler = toolCallHandler;
+    }
+    setToolCallHandler(toolCallHandler) {
+        this.toolCallHandler = toolCallHandler;
     }
     parseToolUse(content) {
         const xmlMatch = content.match(/<crew(?:code|x)_tool_call>\s*([\s\S]*?)\s*<\/crew(?:code|x)_tool_call>/);
@@ -218,7 +229,7 @@ ${userQuery}
         const logFile = (0, path_1.join)(this.logsDir, `${taskId}.log`);
         const timestamp = new Date().toLocaleString();
         const header = `=== TASK LOG: ${taskId} ===
-CrewX Version: ${version_1.CREWX_VERSION}
+CrewX Version: ${this.crewxVersion}
 Provider: ${provider}
 Agent: ${agentId || 'N/A'}
 ${model ? `Model: ${model}\n` : ''}Command: ${command}
@@ -615,10 +626,6 @@ Started: ${timestamp}
         };
         return JSON.stringify(payload);
     }
-};
+}
 exports.BaseAIProvider = BaseAIProvider;
-exports.BaseAIProvider = BaseAIProvider = __decorate([
-    (0, common_1.Injectable)(),
-    __metadata("design:paramtypes", [String])
-], BaseAIProvider);
 //# sourceMappingURL=base-ai.provider.js.map