@intella/sdk 0.0.1 → 0.0.3

package/dist/types.d.ts

@@ -0,0 +1,423 @@
+import type { LanguageModel } from 'ai';
+/**
+ * Supported agent types
+ */
+export type AgentType = 'intella-lite' | 'claude' | 'codex' | 'opencode';
+/**
+ * Agent configuration interface
+ */
+export interface AgentConfig {
+    /** API key for the agent (provider-specific) */
+    apiKey?: string;
+    /** Model identifier to use */
+    model?: string;
+    /** Temperature for generation (0-2) */
+    temperature?: number;
+    /** Maximum tokens to generate */
+    maxTokens?: number;
+    /** Working directory */
+    cwd?: string;
+    /** Custom headers for the provider */
+    headers?: Record<string, string>;
+    /** Base URL for the provider (if applicable) */
+    baseURL?: string;
+    /** Additional provider-specific options */
+    [key: string]: unknown;
+}
+/**
+ * Text part for message content
+ */
+export interface TextPart {
+    type: 'text';
+    text: string;
+}
+/**
+ * File part for message content (attachments)
+ */
+export interface FilePart {
+    type: 'file';
+    data: string | Uint8Array | ArrayBuffer | Buffer | URL;
+    filename?: string;
+    mediaType: string;
+}
+/**
+ * Message content can be a string or array of parts (text and/or files)
+ */
+export type MessageContent = string | Array<TextPart | FilePart>;
+/**
+ * Task execution request
+ */
+export interface TaskRequest {
+    /** The prompt or task description */
+    prompt: string;
+    /** System prompt (optional) */
+    systemPrompt?: string;
+    /** Additional messages for context */
+    messages?: Array<{
+        role: 'user' | 'assistant' | 'system';
+        content: MessageContent;
+    }>;
+    /** Generation parameters */
+    temperature?: number;
+    maxTokens?: number;
+    /** Additional options */
+    [key: string]: unknown;
+}
+/**
+ * Task execution response
+ */
+export interface TaskResponse {
+    /** Generated text response */
+    text: string;
+    /** Agent type that generated the response */
+    agentType: AgentType;
+    /** Additional metadata */
+    metadata?: {
+        usage?: {
+            promptTokens?: number;
+            completionTokens?: number;
+            totalTokens?: number;
+        };
+        finishReason?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Streaming response chunk
+ */
+export interface StreamChunk {
+    /** Chunk ID */
+    id: string;
+    /** Text chunk */
+    text: string;
+    /** Agent type */
+    agentType: AgentType;
+    /** Whether this is the final chunk */
+    isDone: boolean;
+}
+/**
+ * Orchestration strategy types
+ */
+export type OrchestrationStrategy = 'sequential' | 'parallel' | 'conditional';
+/**
+ * Multi-agent orchestration request
+ */
+export interface OrchestrationRequest {
+    /** The task to execute */
+    task: TaskRequest;
+    /** List of agent types to use */
+    agents: AgentType[];
+    /** Orchestration strategy */
+    strategy: OrchestrationStrategy;
+    /** Strategy-specific options */
+    options?: {
+        /** For sequential: whether to pass previous results to next agent */
+        passResults?: boolean;
+        /** For parallel: how to combine results */
+        combineStrategy?: 'merge' | 'first' | 'best';
+        /** For conditional: routing function */
+        router?: (task: TaskRequest) => AgentType;
+    };
+}
+/**
+ * Multi-agent orchestration response
+ */
+export interface OrchestrationResponse {
+    /** Final result */
+    result: string;
+    /** Individual agent responses */
+    agentResponses: Array<{
+        agentType: AgentType;
+        response: string;
+        metadata?: TaskResponse['metadata'];
+    }>;
+    /** Strategy used */
+    strategy: OrchestrationStrategy;
+}
+/**
+ * Base agent interface
+ */
+export interface IAgent {
+    /** Agent type */
+    readonly type: AgentType;
+    /** Execute a task and return the response */
+    execute(request: TaskRequest): Promise<TaskResponse>;
+    /** Stream a task execution */
+    stream(request: TaskRequest): AsyncIterable<StreamChunk>;
+    /** Configure the agent */
+    configure(config: AgentConfig): void;
+    /** Get current configuration */
+    getConfig(): AgentConfig;
+    /** Get the underlying language model */
+    getModel(): LanguageModel | Promise<LanguageModel>;
+}
+/**
+ * Supported filesystem provider types
+ */
+export type FilesystemProviderType = 'agentfs' | 'memory' | 'sandbox';
+/**
+ * Filesystem provider configuration
+ */
+export interface FilesystemConfig {
+    /** Provider-specific configuration */
+    provider?: FilesystemProviderType;
+    /** Agent ID for the filesystem (used by AgentFS) */
+    agentId?: string;
+    /** Database path for AgentFS */
+    dbPath?: string;
+    /** Additional provider-specific options */
+    [key: string]: unknown;
+}
+/**
+ * File statistics
+ */
+export interface FileStats {
+    /** File size in bytes */
+    size: number;
+    /** Whether it's a directory */
+    isDirectory: boolean;
+    /** Whether it's a file */
+    isFile: boolean;
+    /** Creation time (Unix timestamp) */
+    createdAt?: number;
+    /** Modification time (Unix timestamp) */
+    modifiedAt?: number;
+}
+/**
+ * Directory entry
+ */
+export interface DirectoryEntry {
+    /** Entry name */
+    name: string;
+    /** Entry path */
+    path: string;
+    /** Entry statistics */
+    stats: FileStats;
+}
+/**
+ * Tool call metadata for recording
+ */
+export interface ToolCallMetadata {
+    /** Tool name */
+    tool: string;
+    /** Start time (Unix timestamp in seconds) */
+    startedAt: number;
+    /** End time (Unix timestamp in seconds) */
+    endedAt: number;
+    /** Tool input parameters */
+    input?: Record<string, unknown>;
+    /** Tool output/result */
+    output?: unknown;
+    /** Tool status */
+    status?: 'success' | 'error' | 'pending';
+    /** Error message if status is 'error' */
+    error?: string;
+}
+/**
+ * Filesystem provider interface
+ */
+export interface IFilesystemProvider {
+    /** Provider type */
+    readonly type: FilesystemProviderType;
+    /** Initialize the filesystem */
+    initialize(config?: FilesystemConfig): Promise<void>;
+    /** Check if filesystem is initialized */
+    isInitialized(): boolean;
+    /** Close/cleanup the filesystem */
+    close(): Promise<void>;
+    /** Read file contents */
+    readFile(path: string): Promise<Buffer | string>;
+    /** Write file contents */
+    writeFile(path: string, data: Buffer | string): Promise<void>;
+    /** Append to file */
+    appendFile(path: string, data: Buffer | string): Promise<void>;
+    /** Check if file/directory exists */
+    exists(path: string): Promise<boolean>;
+    /** Get file/directory statistics */
+    stat(path: string): Promise<FileStats>;
+    /** Read directory contents */
+    readdir(path: string): Promise<DirectoryEntry[]>;
+    /** Create directory */
+    mkdir(path: string, recursive?: boolean): Promise<void>;
+    /** Remove file or directory */
+    unlink(path: string, recursive?: boolean): Promise<void>;
+    /** Copy file or directory */
+    copy(src: string, dest: string): Promise<void>;
+    /** Move/rename file or directory */
+    move(src: string, dest: string): Promise<void>;
+    /** Get value by key */
+    get(key: string): Promise<unknown>;
+    /** Set value for key */
+    set(key: string, value: unknown): Promise<void>;
+    /** Delete key */
+    delete(key: string): Promise<void>;
+    /** List all keys (optionally with prefix) */
+    listKeys(prefix?: string): Promise<string[]>;
+    /** Check if key exists */
+    hasKey(key: string): Promise<boolean>;
+    /** Record a tool call */
+    recordToolCall(metadata: ToolCallMetadata): Promise<void>;
+    /** Get tool call history (optionally filtered) */
+    getToolCallHistory(filter?: {
+        tool?: string;
+        status?: ToolCallMetadata['status'];
+        since?: number;
+        until?: number;
+        limit?: number;
+    }): Promise<ToolCallMetadata[]>;
+}
+/**
+ * Supported sandbox provider types
+ */
+export type SandboxProviderType = 'e2b' | 'daytona' | 'modal';
+/**
+ * Sandbox provider configuration
+ */
+export interface SandboxConfig {
+    fromSandboxId?: string;
+    /** Provider-specific configuration */
+    provider?: SandboxProviderType;
+    /** API key for the sandbox provider */
+    apiKey?: string;
+    /** Sandbox template ID (for E2B) or workspace ID (for Daytona) */
+    templateId?: string;
+    /** Base URL for the provider (if applicable) */
+    baseURL?: string;
+    /** Environment variables to set in the sandbox */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Additional provider-specific options */
+    [key: string]: unknown;
+}
+/**
+ * Command execution result
+ */
+export interface CommandResult {
+    /** Exit code */
+    exitCode: number;
+    /** Standard output */
+    stdout: string;
+    /** Standard error */
+    stderr: string;
+    /** Execution time in milliseconds */
+    executionTime?: number;
+}
+/**
+ * Code execution result (for interpreted code like Python, JavaScript, etc.)
+ */
+export interface CodeExecutionResult {
+    /** Text representation of the main result */
+    text?: string;
+    /** All results from the execution (including charts, tables, etc.) */
+    results: Array<{
+        text?: string;
+        html?: string;
+        markdown?: string;
+        [key: string]: unknown;
+    }>;
+    /** Logs printed to stdout during execution */
+    stdout: string[];
+    /** Logs printed to stderr during execution */
+    stderr: string[];
+    /** Error information if execution failed */
+    error?: {
+        name: string;
+        value: string;
+        traceback: string;
+    };
+    /** Execution time in milliseconds */
+    executionTime?: number;
+}
+/**
+ * Sandbox execution result
+ */
+export interface SandboxExecutionResult {
+    /** Command execution result */
+    result: CommandResult;
+    /** Sandbox ID */
+    sandboxId: string;
+    /** Provider type */
+    provider: SandboxProviderType;
+    /** Additional metadata */
+    metadata?: {
+        [key: string]: unknown;
+    };
+}
+/**
+ * Sandbox information
+ */
+export interface SandboxInfo {
+    /** Sandbox ID */
+    sandboxId: string;
+    /** Provider type */
+    provider: SandboxProviderType;
+    /** Whether the sandbox is running */
+    isRunning: boolean;
+    /** Whether the sandbox is initialized */
+    isInitialized: boolean;
+    /** Creation timestamp (Unix timestamp in milliseconds) */
+    createdAt?: Date | string | number;
+    /** Additional provider-specific information */
+    metadata?: {
+        [key: string]: any;
+    };
+    /** Sandbox raw info from the provider*/
+    info?: any;
+}
+/**
+ * Sandbox provider interface
+ */
+export interface ISandboxProvider {
+    /** Provider type */
+    readonly type: SandboxProviderType;
+    /** Get the client */
+    getClient(): any;
+    /** Initialize/create a sandbox (or connect to existing if fromSandboxId is provided) */
+    initialize(config?: SandboxConfig): Promise<void>;
+    /** Connect to an existing sandbox by ID */
+    fromSandbox(sandboxId: string, config?: SandboxConfig): Promise<any>;
+    /** Check if sandbox is initialized */
+    isInitialized(): boolean;
+    /** Close/cleanup the sandbox */
+    close(): Promise<void>;
+    /** Get sandbox ID */
+    getSandboxId(): string | null;
+    /** Execute a command in the sandbox */
+    executeCommand(command: string, options?: {
+        cwd?: string;
+        env?: Record<string, string>;
+        timeout?: number;
+    }): Promise<CommandResult>;
+    /** Run code (e.g., Python, JavaScript) in the sandbox */
+    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 */
+    uploadFile(localPath: string, remotePath: string): Promise<void>;
+    /** Download a file from the sandbox */
+    downloadFile(remotePath: string, localPath: string): Promise<void>;
+    /** Read a file from the sandbox */
+    readFile(path: string): Promise<string>;
+    /** Write a file to the sandbox */
+    writeFile(path: string, content: string): Promise<void>;
+    /** List files in a directory */
+    listFiles(path: string): Promise<string[]>;
+    /** Check if a file exists */
+    fileExists(path: string): Promise<boolean>;
+    /** Delete a file */
+    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=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/code-extractor.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Represents a code block extracted from markdown
+ */
+export interface CodeBlock {
+    /** The language identifier (e.g., 'typescript', 'bash', 'python') */
+    language: string;
+    /** The code content without the markdown fences */
+    code: string;
+    /** The full match including fences (for reference) */
+    fullMatch?: string;
+}
+/**
+ * Options for extracting code blocks
+ */
+export interface ExtractCodeBlocksOptions {
+    /** If true, only extract code blocks with the specified language(s) */
+    languages?: string[];
+    /** If true, return only the code content without language info */
+    codeOnly?: boolean;
+    /** If true, include the full match in the result */
+    includeFullMatch?: boolean;
+    /** Custom wrapper for code blocks */
+    customWrapper?: {
+        start: string;
+        end: string;
+    };
+}
+/**
+ * Extracts code blocks from markdown text.
+ * Handles multiple code blocks and returns an array of extracted blocks.
+ *
+ * @param text - The markdown text containing code blocks
+ * @param options - Optional configuration for extraction
+ * @returns Array of code blocks or code strings (if codeOnly is true)
+ *
+ * @example
+ * ```typescript
+ * const markdown = `
+ * Here's some code:
+ * \`\`\`typescript
+ * const x = 1;
+ * \`\`\`
+ *
+ * And a command:
+ * \`\`\`bash
+ * npm install
+ * \`\`\`
+ * `;
+ *
+ * const blocks = extractCodeBlocks(markdown);
+ * // Returns:
+ * // [
+ * //   { language: 'typescript', code: 'const x = 1;' },
+ * //   { language: 'bash', code: 'npm install' }
+ * // ]
+ *
+ * const typescriptOnly = extractCodeBlocks(markdown, { languages: ['typescript'] });
+ * const codeStrings = extractCodeBlocks(markdown, { codeOnly: true });
+ *
+ * // Using custom wrapper
+ * const customMarkdown = '<code>typescript\nconst x = 1;\n</code>';
+ * const customBlocks = extractCodeBlocks(customMarkdown, {
+ *   customWrapper: { start: '<code>', end: '</code>' }
+ * });
+ * ```
+ */
+export declare function extractCodeBlocks(text: string, options?: ExtractCodeBlocksOptions): CodeBlock[] | string[];
+/**
+ * Extracts a single code block from markdown text.
+ * Returns the first matching code block, or null if none found.
+ *
+ * @param text - The markdown text containing code blocks
+ * @param language - Optional language filter (case-insensitive)
+ * @returns The first matching code block, or null
+ *
+ * @example
+ * ```typescript
+ * const markdown = '```bash\nnpm install\n```';
+ * const block = extractCodeBlock(markdown);
+ * // Returns: { language: 'bash', code: 'npm install' }
+ *
+ * const tsBlock = extractCodeBlock(markdown, 'typescript');
+ * // Returns: null (no typescript block found)
+ * ```
+ */
+export declare function extractCodeBlock(text: string, language?: string): CodeBlock | null;
+/**
+ * Extracts code content from a single code block (without language info).
+ * Returns the code string, or null if no code block found.
+ *
+ * @param text - The markdown text containing code blocks
+ * @param language - Optional language filter (case-insensitive)
+ * @returns The code content as a string, or null
+ *
+ * @example
+ * ```typescript
+ * const markdown = '```bash\nnpm install\n```';
+ * const code = extractCode(markdown);
+ * // Returns: 'npm install'
+ * ```
+ */
+export declare function extractCode(text: string, language?: string): string | null;
+//# sourceMappingURL=code-extractor.d.ts.map

package/dist/utils/code-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-extractor.d.ts","sourceRoot":"","sources":["../../src/utils/code-extractor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qCAAqC;IACrC,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,SAAS,EAAE,GAAG,MAAM,EAAE,CAqExB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,SAAS,GAAG,IAAI,CAOlB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAGf"}

package/dist/utils/code-extractor.js

@@ -0,0 +1,133 @@
+/**
+ * Extracts code blocks from markdown text.
+ * Handles multiple code blocks and returns an array of extracted blocks.
+ *
+ * @param text - The markdown text containing code blocks
+ * @param options - Optional configuration for extraction
+ * @returns Array of code blocks or code strings (if codeOnly is true)
+ *
+ * @example
+ * ```typescript
+ * const markdown = `
+ * Here's some code:
+ * \`\`\`typescript
+ * const x = 1;
+ * \`\`\`
+ *
+ * And a command:
+ * \`\`\`bash
+ * npm install
+ * \`\`\`
+ * `;
+ *
+ * const blocks = extractCodeBlocks(markdown);
+ * // Returns:
+ * // [
+ * //   { language: 'typescript', code: 'const x = 1;' },
+ * //   { language: 'bash', code: 'npm install' }
+ * // ]
+ *
+ * const typescriptOnly = extractCodeBlocks(markdown, { languages: ['typescript'] });
+ * const codeStrings = extractCodeBlocks(markdown, { codeOnly: true });
+ *
+ * // Using custom wrapper
+ * const customMarkdown = '<code>typescript\nconst x = 1;\n</code>';
+ * const customBlocks = extractCodeBlocks(customMarkdown, {
+ *   customWrapper: { start: '<code>', end: '</code>' }
+ * });
+ * ```
+ */
+export function extractCodeBlocks(text, options = {}) {
+    const { languages, codeOnly = false, includeFullMatch = false, customWrapper, } = options;
+    // Determine the wrapper strings to use
+    const startWrapper = customWrapper?.start ?? '```';
+    const endWrapper = customWrapper?.end ?? '```';
+    // Escape special regex characters in the wrapper strings
+    const escapeRegex = (str) => {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    };
+    const escapedStart = escapeRegex(startWrapper);
+    const escapedEnd = escapeRegex(endWrapper);
+    // Build regex pattern: startWrapper language?\n?code\nendWrapper
+    // Handles:
+    // - Optional language identifier (with optional whitespace)
+    // - Code blocks with or without newline after language
+    // - Empty code blocks
+    // - Code blocks without language
+    // - Custom wrappers
+    const codeBlockRegex = new RegExp(`${escapedStart}(\\w+)?\\s*\\n?([\\s\\S]*?)${escapedEnd}`, 'g');
+    const blocks = [];
+    let match;
+    // Reset regex lastIndex to ensure we start from the beginning
+    codeBlockRegex.lastIndex = 0;
+    while ((match = codeBlockRegex.exec(text)) !== null) {
+        const language = match[1] || '';
+        const code = match[2]?.trim() || '';
+        // Filter by language if specified
+        if (languages && languages.length > 0) {
+            const normalizedLanguage = language.toLowerCase();
+            const normalizedLanguages = languages.map((lang) => lang.toLowerCase());
+            if (!normalizedLanguages.includes(normalizedLanguage)) {
+                continue;
+            }
+        }
+        const codeBlock = {
+            language,
+            code,
+        };
+        if (includeFullMatch) {
+            codeBlock.fullMatch = match[0];
+        }
+        blocks.push(codeBlock);
+    }
+    // Return code strings only if requested
+    if (codeOnly) {
+        return blocks.map((block) => block.code);
+    }
+    return blocks;
+}
+/**
+ * Extracts a single code block from markdown text.
+ * Returns the first matching code block, or null if none found.
+ *
+ * @param text - The markdown text containing code blocks
+ * @param language - Optional language filter (case-insensitive)
+ * @returns The first matching code block, or null
+ *
+ * @example
+ * ```typescript
+ * const markdown = '```bash\nnpm install\n```';
+ * const block = extractCodeBlock(markdown);
+ * // Returns: { language: 'bash', code: 'npm install' }
+ *
+ * const tsBlock = extractCodeBlock(markdown, 'typescript');
+ * // Returns: null (no typescript block found)
+ * ```
+ */
+export function extractCodeBlock(text, language) {
+    const options = language
+        ? { languages: [language] }
+        : {};
+    const blocks = extractCodeBlocks(text, options);
+    return blocks.length > 0 ? blocks[0] : null;
+}
+/**
+ * Extracts code content from a single code block (without language info).
+ * Returns the code string, or null if no code block found.
+ *
+ * @param text - The markdown text containing code blocks
+ * @param language - Optional language filter (case-insensitive)
+ * @returns The code content as a string, or null
+ *
+ * @example
+ * ```typescript
+ * const markdown = '```bash\nnpm install\n```';
+ * const code = extractCode(markdown);
+ * // Returns: 'npm install'
+ * ```
+ */
+export function extractCode(text, language) {
+    const block = extractCodeBlock(text, language);
+    return block ? block.code : null;
+}
+//# sourceMappingURL=code-extractor.js.map