@intella/sdk 0.0.1 → 0.0.3

package/dist/orchestrator.d.ts

@@ -0,0 +1,32 @@
+import type { OrchestrationRequest, OrchestrationResponse } from './types.js';
+import { AgentManager } from './agent-manager.js';
+/**
+ * Orchestrator
+ * Coordinates multiple agents for task execution
+ */
+export declare class Orchestrator {
+    private agentManager;
+    constructor(agentManager: AgentManager);
+    /**
+     * Execute orchestration with multiple agents
+     */
+    orchestrate(request: OrchestrationRequest): Promise<OrchestrationResponse>;
+    /**
+     * Sequential orchestration: agents work in sequence, passing results
+     */
+    private sequentialOrchestration;
+    /**
+     * Parallel orchestration: agents work simultaneously, results combined
+     */
+    private parallelOrchestration;
+    /**
+     * Conditional orchestration: route to agents based on task characteristics
+     */
+    private conditionalOrchestration;
+    /**
+     * Register a custom orchestration strategy
+     * This allows extending the orchestrator with custom strategies
+     */
+    addCustomStrategy(name: string, strategy: (request: OrchestrationRequest) => Promise<OrchestrationResponse>): Promise<void>;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAe;gBAEvB,YAAY,EAAE,YAAY;IAItC;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAahF;;OAEG;YACW,uBAAuB;IA4CrC;;OAEG;YACW,qBAAqB;IA6CnC;;OAEG;YACW,wBAAwB;IA+BtC;;;OAGG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,qBAAqB,CAAC,GAC1E,OAAO,CAAC,IAAI,CAAC;CAKjB"}

package/dist/orchestrator.js

@@ -0,0 +1,137 @@
+/**
+ * Orchestrator
+ * Coordinates multiple agents for task execution
+ */
+export class Orchestrator {
+    agentManager;
+    constructor(agentManager) {
+        this.agentManager = agentManager;
+    }
+    /**
+     * Execute orchestration with multiple agents
+     */
+    async orchestrate(request) {
+        switch (request.strategy) {
+            case 'sequential':
+                return this.sequentialOrchestration(request);
+            case 'parallel':
+                return this.parallelOrchestration(request);
+            case 'conditional':
+                return this.conditionalOrchestration(request);
+            default:
+                throw new Error(`Unknown orchestration strategy: ${request.strategy}`);
+        }
+    }
+    /**
+     * Sequential orchestration: agents work in sequence, passing results
+     */
+    async sequentialOrchestration(request) {
+        const { task, agents, options } = request;
+        const agentResponses = [];
+        let currentTask = { ...task };
+        let accumulatedResult = '';
+        for (const agentType of agents) {
+            const agent = this.agentManager.getAgent(agentType);
+            // If passing results, include previous results in the prompt
+            if (options?.passResults && accumulatedResult) {
+                currentTask = {
+                    ...currentTask,
+                    prompt: `${currentTask.prompt}\n\nPrevious results:\n${accumulatedResult}`,
+                };
+            }
+            const response = await agent.execute(currentTask);
+            agentResponses.push({
+                agentType,
+                response: response.text,
+                metadata: response.metadata,
+            });
+            accumulatedResult = response.text;
+            // Update task for next iteration if passing results
+            if (options?.passResults) {
+                currentTask = {
+                    ...task,
+                    prompt: response.text,
+                };
+            }
+        }
+        return {
+            result: accumulatedResult,
+            agentResponses,
+            strategy: 'sequential',
+        };
+    }
+    /**
+     * Parallel orchestration: agents work simultaneously, results combined
+     */
+    async parallelOrchestration(request) {
+        const { task, agents, options } = request;
+        // Execute all agents in parallel
+        const responses = await Promise.all(agents.map(async (agentType) => {
+            const agent = this.agentManager.getAgent(agentType);
+            const response = await agent.execute(task);
+            return {
+                agentType,
+                response: response.text,
+                metadata: response.metadata,
+            };
+        }));
+        // Combine results based on strategy
+        const combineStrategy = options?.combineStrategy || 'merge';
+        let result;
+        switch (combineStrategy) {
+            case 'merge':
+                result = responses.map((r) => r.response).join('\n\n---\n\n');
+                break;
+            case 'first':
+                result = responses[0]?.response || '';
+                break;
+            case 'best':
+                // For now, just use the first response
+                // This could be enhanced with ranking/scoring logic
+                result = responses[0]?.response || '';
+                break;
+            default:
+                result = responses.map((r) => r.response).join('\n\n---\n\n');
+        }
+        return {
+            result,
+            agentResponses: responses,
+            strategy: 'parallel',
+        };
+    }
+    /**
+     * Conditional orchestration: route to agents based on task characteristics
+     */
+    async conditionalOrchestration(request) {
+        const { task, agents, options } = request;
+        // Use custom router if provided, otherwise use first agent
+        const router = options?.router || (() => agents[0]);
+        const selectedAgentType = router(task);
+        if (!agents.includes(selectedAgentType)) {
+            throw new Error(`Router selected agent ${selectedAgentType} which is not in the agents list`);
+        }
+        const agent = this.agentManager.getAgent(selectedAgentType);
+        const response = await agent.execute(task);
+        return {
+            result: response.text,
+            agentResponses: [
+                {
+                    agentType: selectedAgentType,
+                    response: response.text,
+                    metadata: response.metadata,
+                },
+            ],
+            strategy: 'conditional',
+        };
+    }
+    /**
+     * Register a custom orchestration strategy
+     * This allows extending the orchestrator with custom strategies
+     */
+    async addCustomStrategy(name, strategy) {
+        // Store custom strategies (implementation can be extended)
+        // For now, this is a placeholder for future extensibility
+        this[`${name}Orchestration`] = strategy;
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

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

package/dist/sandbox/base-provider.d.ts

@@ -0,0 +1,106 @@
+import type { SandboxProviderType, SandboxConfig, CommandResult, CodeExecutionResult, ISandboxProvider, SandboxInfo } from '../types.js';
+/**
+ * Base sandbox provider
+ * Abstract implementation that provides common functionality
+ */
+export declare abstract class BaseSandboxProvider implements ISandboxProvider {
+    protected initialized: boolean;
+    protected config: SandboxConfig;
+    protected sandboxId: string | null;
+    protected client: any | null;
+    readonly type: SandboxProviderType;
+    constructor(type: SandboxProviderType, config?: SandboxConfig);
+    abstract getClient(): any;
+    /**
+     * Initialize/create a sandbox
+     * If fromSandboxId is provided in config, will call fromSandbox instead
+     */
+    initialize(config?: SandboxConfig): Promise<void>;
+    /**
+     * Provider-specific initialization (creates new sandbox)
+     */
+    protected abstract initializeSandbox(config?: SandboxConfig): Promise<void>;
+    /**
+     * Connect to an existing sandbox by ID
+     */
+    abstract fromSandbox(sandboxId: string, config?: SandboxConfig): Promise<any>;
+    /**
+     * Check if sandbox is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Close/cleanup the sandbox
+     */
+    abstract close(): Promise<void>;
+    /**
+     * Get sandbox ID
+     */
+    getSandboxId(): string | null;
+    /**
+     * Execute a command in the sandbox
+     */
+    abstract executeCommand(command: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+    }): Promise<CommandResult>;
+    /**
+     * Run code (e.g., Python, JavaScript) in the sandbox
+     */
+    abstract runCode(code: string, options?: {
+        language?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+        onStdout?: (data: string) => void;
+        onStderr?: (data: string) => void;
+    }): Promise<CodeExecutionResult>;
+    /**
+     * Upload a file to the sandbox
+     */
+    abstract uploadFile(localPath: string, remotePath: string): Promise<void>;
+    /**
+     * Download a file from the sandbox
+     */
+    abstract downloadFile(remotePath: string, localPath: string): Promise<void>;
+    /**
+     * Read a file from the sandbox
+     */
+    abstract readFile(path: string): Promise<string>;
+    /**
+     * Write a file to the sandbox
+     */
+    abstract writeFile(path: string, content: string): Promise<void>;
+    /**
+     * List files in a directory
+     */
+    abstract listFiles(path: string): Promise<string[]>;
+    /**
+     * Check if a file exists
+     */
+    abstract fileExists(path: string): Promise<boolean>;
+    /**
+     * Delete a file
+     */
+    abstract deleteFile(path: string): Promise<void>;
+    /**
+     * Get sandbox status
+     */
+    abstract getStatus(): Promise<{
+        isRunning: boolean;
+        createdAt?: number;
+        [key: string]: unknown;
+    }>;
+    /**
+     * Get detailed sandbox information
+     */
+    abstract getInfo(sandboxId?: string): Promise<SandboxInfo>;
+    /**
+     * Ensure sandbox is initialized before operation
+     */
+    protected ensureInitialized(): void;
+    /**
+     * Normalize path (remove leading/trailing slashes, handle ..)
+     */
+    protected normalizePath(path: string): string;
+}
+//# sourceMappingURL=base-provider.d.ts.map

package/dist/sandbox/base-provider.d.ts.map

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

package/dist/sandbox/base-provider.js

@@ -0,0 +1,74 @@
+/**
+ * Base sandbox provider
+ * Abstract implementation that provides common functionality
+ */
+export class BaseSandboxProvider {
+    initialized = false;
+    config = {};
+    sandboxId = null;
+    client = null;
+    type;
+    constructor(type, config) {
+        this.type = type;
+        if (config) {
+            this.config = { ...this.config, ...config };
+            if (this.getClient) {
+                this.client = this.getClient();
+            }
+        }
+    }
+    /**
+     * Initialize/create a sandbox
+     * If fromSandboxId is provided in config, will call fromSandbox instead
+     */
+    async initialize(config) {
+        if (config) {
+            this.config = { ...this.config, ...config };
+        }
+        // If fromSandboxId is provided, use fromSandbox instead of creating new
+        if (this.config.fromSandboxId) {
+            return this.fromSandbox(this.config.fromSandboxId, config);
+        }
+        // Otherwise, call the provider-specific initialization
+        return this.initializeSandbox(config);
+    }
+    /**
+     * Check if sandbox is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get sandbox ID
+     */
+    getSandboxId() {
+        return this.sandboxId;
+    }
+    /**
+     * Ensure sandbox is initialized before operation
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error(`Sandbox provider ${this.type} is not initialized. Call initialize() first.`);
+        }
+    }
+    /**
+     * Normalize path (remove leading/trailing slashes, handle ..)
+     */
+    normalizePath(path) {
+        return path
+            .split('/')
+            .filter((segment) => segment !== '' && segment !== '.')
+            .reduce((acc, segment) => {
+            if (segment === '..') {
+                acc.pop();
+            }
+            else {
+                acc.push(segment);
+            }
+            return acc;
+        }, [])
+            .join('/');
+    }
+}
+//# sourceMappingURL=base-provider.js.map

package/dist/sandbox/base-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-provider.js","sourceRoot":"","sources":["../../src/sandbox/base-provider.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,OAAgB,mBAAmB;IAC7B,WAAW,GAAG,KAAK,CAAC;IACpB,MAAM,GAAkB,EAAE,CAAC;IAC3B,SAAS,GAAkB,IAAI,CAAC;IAChC,MAAM,GAAe,IAAI,CAAC;IACpB,IAAI,CAAsB;IAE1C,YAAY,IAAyB,EAAE,MAAsB;QAC3D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;YAC5C,IAAG,IAAI,CAAC,SAAS,EAAE,CAAC;gBAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAID;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,MAAsB;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QAC9C,CAAC;QAED,wEAAwE;QACxE,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC;QAED,uDAAuD;QACvD,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAYD;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAOD;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IA6ED;;OAEG;IACO,iBAAiB;QACzB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,CAAC,IAAI,+CAA+C,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACO,aAAa,CAAC,IAAY;QAClC,OAAO,IAAI;aACR,KAAK,CAAC,GAAG,CAAC;aACV,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,CAAC;aACtD,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YACvB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAc,CAAC;aACjB,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;CACF"}

package/dist/sandbox/daytona-provider.d.ts

@@ -0,0 +1,93 @@
+import { BaseSandboxProvider } from './base-provider.js';
+import type { SandboxConfig, CommandResult, CodeExecutionResult, SandboxInfo } from '../types.js';
+import { Daytona, Sandbox } from '@daytonaio/sdk';
+/**
+ * Daytona Sandbox Provider
+ * Provides sandbox execution capabilities using Daytona
+ */
+export declare class DaytonaSandboxProvider extends BaseSandboxProvider {
+    protected client: Daytona | null;
+    private sandboxInstance;
+    constructor(config?: SandboxConfig);
+    getClient(): Daytona;
+    /**
+     * Initialize/create a Daytona sandbox
+     */
+    protected initializeSandbox(config?: SandboxConfig): Promise<void>;
+    /**
+     * Connect to an existing Daytona sandbox by ID
+     */
+    fromSandbox(sandboxId: string, config?: SandboxConfig): Promise<Sandbox>;
+    /**
+     * Close/cleanup the Daytona sandbox
+     */
+    close(): Promise<void>;
+    /**
+     * Execute a command in the Daytona sandbox
+     * @param command - Command to execute
+     * @param options - Execution options (cwd, env, timeout)
+     */
+    executeCommand(command: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+    }): Promise<CommandResult>;
+    /**
+     * Run code (e.g., Python, JavaScript, TypeScript) in the Daytona sandbox
+     * Uses the stateless codeRun method: https://www.daytona.io/docs/en/process-code-execution/
+     */
+    runCode(code: string, options?: {
+        language?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+        onStdout?: (data: string) => void;
+        onStderr?: (data: string) => void;
+    }): Promise<CodeExecutionResult>;
+    /**
+     * Upload a file to the Daytona sandbox
+     * Uses fs.uploadFile: https://www.daytona.io/docs/en/file-system-operations/
+     */
+    uploadFile(localPath: string, remotePath: string): Promise<void>;
+    /**
+     * Download a file from the Daytona sandbox
+     * Uses fs.downloadFile: https://www.daytona.io/docs/en/file-system-operations/
+     */
+    downloadFile(remotePath: string, localPath: string): Promise<void>;
+    /**
+     * Read a file from the Daytona sandbox
+     * Uses fs.downloadFile: https://www.daytona.io/docs/en/file-system-operations/
+     */
+    readFile(path: string): Promise<string>;
+    /**
+     * Write a file to the Daytona sandbox
+     * Uses fs.uploadFile: https://www.daytona.io/docs/en/file-system-operations/
+     */
+    writeFile(path: string, content: string): Promise<void>;
+    /**
+     * List files in a directory
+     * Uses fs.listFiles: https://www.daytona.io/docs/en/file-system-operations/
+     */
+    listFiles(path: string): Promise<string[]>;
+    /**
+     * Check if a file exists
+     */
+    fileExists(path: string): Promise<boolean>;
+    /**
+     * Delete a file
+     * Uses fs.deleteFile: https://www.daytona.io/docs/en/file-system-operations/
+     */
+    deleteFile(path: string): Promise<void>;
+    /**
+     * Get sandbox status
+     */
+    getStatus(): Promise<{
+        isRunning: boolean;
+        createdAt?: number;
+        [key: string]: unknown;
+    }>;
+    /**
+     * Get detailed sandbox information
+     */
+    getInfo(sandboxId?: string): Promise<SandboxInfo>;
+}
+//# sourceMappingURL=daytona-provider.d.ts.map

package/dist/sandbox/daytona-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daytona-provider.d.ts","sourceRoot":"","sources":["../../src/sandbox/daytona-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,mBAAmB;IAC7D,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAQ;IACxC,OAAO,CAAC,eAAe,CAAwB;gBAEnC,MAAM,CAAC,EAAE,aAAa;IAQlC,SAAS,IAAI,OAAO;IAkBpB;;OAEG;cACa,iBAAiB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CxE;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IA4B9E;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;;;OAIG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,aAAa,CAAC;IA0CzB;;;OAGG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;KACnC,GACA,OAAO,CAAC,mBAAmB,CAAC;IA8D/B;;;OAGG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBtE;;;OAGG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxE;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc7C;;;OAGG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7D;;;OAGG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAehD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWhD;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QACzB,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IA4BF;;OAEG;IACG,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CA6BxD"}