@intella/sdk 0.0.2 → 0.0.4

package/README.md

@@ -1,492 +1,15 @@
-# Intella SDK
+# intella-sdk
 
-An agent orchestrator SDK for managing tasks across multiple AI agents using AI SDK v6 as a consistent interface.
-
-## Features
-
-- **Unified Interface**: Consistent API for interacting with multiple AI providers
-- **Agent Management**: Easy selection and configuration of different agents
-- **Multi-Agent Orchestration**: Coordinate multiple agents working on a single task
-- **Framework Agnostic**: Works in Node.js, React, and other TypeScript/JavaScript environments
-- **Type Safe**: Full TypeScript support with comprehensive type definitions
-
-## Supported Agents
-
-- **Intella Lite**: Default lightweight agent (OpenAI-compatible)
-- **Claude Agent**: Powered by Claude Code provider
-- **Codex Agent**: Powered by Codex CLI provider
-- **OpenCode Agent**: Powered by OpenCode SDK provider
-
-## Installation
+To install dependencies:
 
 ```bash
-npm install @intella/sdk ai
+bun install
 ```
 
-### Peer Dependencies
-
-The SDK requires the following peer dependencies for specific agents:
+To run:
 
 ```bash
-# For Claude Agent
-npm install ai-sdk-provider-claude-code
-
-# For Codex Agent
-npm install ai-sdk-provider-codex-cli
-
-# For OpenCode Agent
-npm install ai-sdk-provider-opencode-sdk
-
-# For Intella Lite Agent
-npm install @ai-sdk/openai
-```
-
-**Note**: These providers use CLI authentication. Make sure you have the respective CLI tools installed and authenticated:
-- Claude Code: `npm install -g @anthropic-ai/claude-code && claude login`
-- Codex CLI: Ensure Codex CLI is installed and authenticated
-- OpenCode: `npm install -g opencode && opencode login`
-
-## Quick Start
-
-### Basic Usage
-
-```typescript
-import { IntellaSDK } from '@intella/sdk';
-
-const sdk = new IntellaSDK();
-
-// Configure an agent (Claude Code uses CLI authentication)
-sdk.configureAgent('claude', {
-  model: 'sonnet', // Shortcuts: 'opus', 'sonnet', 'haiku'
-  // Optional: allowedTools, disallowedTools, mcpServers, permissionMode, etc.
-});
-
-// Execute a task
-const response = await sdk.executeTask('Write a summary of AI SDK v6');
-console.log(response.text);
-```
-
-### Streaming Responses
-
-```typescript
-// Stream a task execution
-for await (const chunk of sdk.streamTask('Explain quantum computing')) {
-  process.stdout.write(chunk.text);
-  if (chunk.isDone) {
-    console.log('\nDone!');
-  }
-}
-```
-
-### Multi-Agent Orchestration
-
-```typescript
-// Sequential orchestration: agents work in sequence
-const result = await sdk.orchestrateTask(
-  'Analyze this code and generate tests',
-  ['claude', 'codex'],
-  'sequential',
-  {
-    passResults: true, // Pass previous results to next agent
-  }
-);
-
-console.log(result.result);
-console.log('Agent responses:', result.agentResponses);
-
-// Parallel orchestration: agents work simultaneously
-const parallelResult = await sdk.orchestrateTask(
-  'Write a blog post about AI',
-  ['claude', 'opencode'],
-  'parallel',
-  {
-    combineStrategy: 'merge', // Combine all responses
-  }
-);
-
-// Conditional orchestration: route based on task
-const conditionalResult = await sdk.orchestrateTask(
-  'Fix this bug',
-  ['claude', 'codex'],
-  'conditional',
-  {
-    router: (task) => {
-      // Custom routing logic
-      return task.prompt.includes('code') ? 'codex' : 'claude';
-    },
-  }
-);
-```
-
-## API Reference
-
-### IntellaSDK
-
-Main SDK class for orchestrating agents.
-
-#### Methods
-
-##### `configureAgent(agentType, config)`
-
-Configure an agent with model settings and provider-specific options.
-
-```typescript
-// Claude Code agent (uses CLI authentication)
-sdk.configureAgent('claude', {
-  model: 'sonnet', // or 'opus', 'haiku', or full model ID
-  allowedTools: ['Read', 'Write', 'Edit'],
-  permissionMode: 'default',
-});
-
-// Codex CLI agent (uses CLI auth or OPENAI_API_KEY env var)
-sdk.configureAgent('codex', {
-  model: 'gpt-5.2-codex',
-  reasoningEffort: 'high',
-  approvalMode: 'on-failure',
-  sandboxMode: 'workspace-write',
-});
-
-// OpenCode agent (uses CLI authentication)
-sdk.configureAgent('opencode', {
-  model: 'anthropic/claude-sonnet-4-5-20250929',
-});
-
-// Intella Lite agent (uses OpenAI API key)
-sdk.configureAgent('intella-lite', {
-  apiKey: process.env.OPENAI_API_KEY,
-  model: 'gpt-4o-mini',
-  temperature: 0.7,
-  maxTokens: 1000,
-});
-```
-
-##### `selectAgent(agentType, config?)`
-
-Select and configure an agent as the default.
-
-```typescript
-sdk.selectAgent('claude', { apiKey: 'your-api-key' });
-```
-
-##### `executeTask(task, agentType?)`
-
-Execute a task with the specified agent (or default).
-
-```typescript
-// Simple string prompt
-const response = await sdk.executeTask('Hello, world!');
-
-// Full task request
-const response = await sdk.executeTask({
-  prompt: 'Write a function',
-  systemPrompt: 'You are a helpful coding assistant',
-  temperature: 0.8,
-}, 'codex');
-```
-
-##### `streamTask(task, agentType?)`
-
-Stream a task execution.
-
-```typescript
-for await (const chunk of sdk.streamTask('Explain recursion')) {
-  console.log(chunk.text);
-}
-```
-
-##### `orchestrateTask(task, agents, strategy, options?)`
-
-Orchestrate a task across multiple agents.
-
-**Strategies:**
-- `sequential`: Agents work in sequence, optionally passing results
-- `parallel`: Agents work simultaneously, results combined
-- `conditional`: Route to agents based on task characteristics
-
-```typescript
-const result = await sdk.orchestrateTask(
-  'Complex task',
-  ['claude', 'codex'],
-  'sequential',
-  { passResults: true }
-);
-```
-
-##### `listAgents()`
-
-List all available agent types.
-
-```typescript
-const agents = sdk.listAgents();
-// ['intella-lite', 'claude', 'codex', 'opencode']
-```
-
-##### `getAgentConfig(agentType)`
-
-Get the current configuration for an agent.
-
-```typescript
-const config = sdk.getAgentConfig('claude');
-```
-
-##### `setDefaultAgent(agentType)`
-
-Set the default agent type.
-
-```typescript
-sdk.setDefaultAgent('intella-lite');
+bun run index.ts
 ```
 
-## Agent Configuration
-
-Each agent supports the following configuration options:
-
-```typescript
-interface AgentConfig {
-  apiKey?: string;           // Provider API key (for Intella Lite)
-  model?: string;            // Model identifier
-  temperature?: number;      // Generation temperature (0-2)
-  maxTokens?: number;       // Maximum tokens to generate
-  headers?: Record<string, string>; // Custom headers
-  baseURL?: string;         // Custom base URL
-  [key: string]: unknown;    // Provider-specific options
-}
-```
-
-### Provider-Specific Options
-
-#### Claude Code Agent
-- `model`: Model shortcut ('opus', 'sonnet', 'haiku') or full model ID
-- `allowedTools`: Array of allowed tool names
-- `disallowedTools`: Array of disallowed tool names
-- `mcpServers`: MCP server configurations
-- `permissionMode`: 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan'
-- `maxTurns`: Maximum conversation turns
-- `cwd`: Working directory
-- `verbose`: Enable debug logging
-
-See [Claude Code Provider docs](https://ai-sdk.dev/providers/community-providers/claude-code)
-
-#### Codex CLI Agent
-- `model`: Model ID ('gpt-5.2-codex', 'gpt-5.2', 'gpt-5.1-codex-max', etc.)
-- `reasoningEffort`: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'
-- `approvalMode`: 'untrusted' | 'on-failure' | 'on-request' | 'never'
-- `sandboxMode`: 'read-only' | 'workspace-write' | 'danger-full-access'
-- `mcpServers`: MCP server configurations
-- `verbose`: Enable verbose logging
-- `logger`: Custom logger instance
-
-See [Codex CLI Provider docs](https://ai-sdk.dev/providers/community-providers/codex-cli)
-
-#### OpenCode Agent
-- `model`: Model ID in format 'provider/model-id' (e.g., 'anthropic/claude-sonnet-4-5-20250929')
-
-See [OpenCode Provider docs](https://ai-sdk.dev/providers/community-providers/opencode-sdk)
-
-### Environment Variables
-
-- `OPENAI_API_KEY` - For Intella Lite (OpenAI-compatible) and Codex CLI (optional)
-
-**Note**: Claude Code, Codex CLI, and OpenCode providers primarily use CLI authentication. Make sure you're logged in via their respective CLI tools:
-- Claude Code: `npm install -g @anthropic-ai/claude-code && claude login`
-- Codex CLI: `npm install -g @openai/codex && codex` (follow interactive setup)
-- OpenCode: `npm install -g opencode && opencode login`
-
-## Advanced Usage
-
-### Direct Agent Access
-
-```typescript
-import { AgentManager, ClaudeAgent } from '@intella/sdk';
-
-const manager = new AgentManager();
-const claudeAgent = new ClaudeAgent({
-  apiKey: 'your-key',
-  model: 'claude-sonnet-4-5-20250929',
-});
-
-manager.registerAgent('claude', claudeAgent);
-const agent = manager.getAgent('claude');
-const response = await agent.execute({ prompt: 'Hello!' });
-```
-
-### Custom Orchestration
-
-```typescript
-import { Orchestrator, AgentManager } from '@intella/sdk';
-
-const manager = new AgentManager();
-const orchestrator = new Orchestrator(manager);
-
-const result = await orchestrator.orchestrate({
-  task: { prompt: 'Complex task' },
-  agents: ['claude', 'codex'],
-  strategy: 'parallel',
-  options: {
-    combineStrategy: 'merge',
-  },
-});
-```
-
-## Sandbox Support
-
-The SDK supports multiple sandbox providers for executing code in isolated environments.
-
-### Supported Sandbox Providers
-
-- **E2B**: Cloud sandbox environment for code execution
-- **Daytona**: Development environment sandboxes
-- **Modal**: Serverless sandbox execution
-
-### Basic Sandbox Usage
-
-```typescript
-// Initialize a sandbox
-await sdk.initializeSandbox('e2b', {
-  templateId: 'base',
-  env: {
-    NODE_ENV: 'development',
-  },
-});
-
-// Execute a command
-const result = await sdk.executeInSandbox('echo "Hello, World!"');
-console.log(result.result.stdout);
-
-// Get active sandbox and use directly
-const sandbox = sdk.getActiveSandbox();
-if (sandbox) {
-  await sandbox.writeFile('/tmp/test.txt', 'Hello!');
-  const content = await sandbox.readFile('/tmp/test.txt');
-}
-
-// Close sandbox
-await sdk.closeSandbox();
-```
-
-### Connecting to Existing Sandboxes
-
-You can connect to an existing sandbox using the `fromSandboxId` config option or by calling `fromSandbox` directly:
-
-```typescript
-// Option 1: Using fromSandboxId in config (recommended)
-await sdk.initializeSandbox('modal', {
-  fromSandboxId: 'existing-sandbox-id',
-});
-
-// Option 2: Direct fromSandbox call
-const sandbox = sdk.getActiveSandbox();
-if (sandbox) {
-  const sandboxInstance = await sandbox.fromSandbox('existing-sandbox-id');
-}
-```
-
-### Getting Sandbox Information
-
-The `getInfo` method provides detailed information about a sandbox:
-
-```typescript
-const sandbox = sdk.getActiveSandbox();
-if (sandbox) {
-  // Get info for active sandbox
-  const info = await sandbox.getInfo();
-  console.log(info);
-  // {
-  //   sandboxId: 'sb-123',
-  //   provider: 'e2b',
-  //   isRunning: true,
-  //   isInitialized: true,
-  //   createdAt: Date,
-  //   metadata: { ... },
-  //   info: { ... } // Raw provider-specific info
-  // }
-
-  // Get info for a specific sandbox by ID
-  const otherInfo = await sandbox.getInfo('another-sandbox-id');
-}
-```
-
-### Sandbox Configuration
-
-```typescript
-interface SandboxConfig {
-  fromSandboxId?: string;      // Connect to existing sandbox
-  provider?: SandboxProviderType;
-  apiKey?: string;             // Provider API key
-  templateId?: string;         // Template/workspace ID
-  baseURL?: string;            // Provider base URL
-  env?: Record<string, string>; // Environment variables
-  timeout?: number;            // Timeout in milliseconds
-  [key: string]: unknown;      // Provider-specific options
-}
-```
-
-### Provider-Specific Configuration
-
-#### E2B
-- Requires `E2B_API_KEY` environment variable or `apiKey` in config
-- Supports `templateId` for selecting sandbox templates
-- Use `fromSandboxId` to reconnect to existing sandboxes
-
-#### Daytona
-- Requires `DAYTONA_API_KEY` or `DAYTONA_API_TOKEN` environment variable
-- Supports `templateId` for workspace templates
-- Optional `baseURL` for custom Daytona server
-
-#### Modal
-- Requires `MODAL_TOKEN_ID` and `MODAL_TOKEN_SECRET` environment variables
-- Supports `appName` and `imageName` for custom app/image configuration
-- Use `fromSandboxId` to connect to existing sandboxes
-
-### Sandbox Operations
-
-All sandbox providers support:
-
-- **Command Execution**: `executeCommand(command, options?)`
-- **Code Execution**: `runCode(code, options?)`
-- **File Operations**: `readFile`, `writeFile`, `uploadFile`, `downloadFile`, `listFiles`, `fileExists`, `deleteFile`
-- **Status & Info**: `getStatus()`, `getInfo(sandboxId?)`
-- **Management**: `close()`, `getSandboxId()`, `isInitialized()`
-
-## Type Definitions
-
-The SDK exports comprehensive TypeScript types:
-
-```typescript
-import type {
-  AgentType,
-  AgentConfig,
-  TaskRequest,
-  TaskResponse,
-  OrchestrationRequest,
-  OrchestrationResponse,
-  IAgent,
-  SandboxProviderType,
-  SandboxConfig,
-  SandboxInfo,
-  ISandboxProvider,
-} from '@intella/sdk';
-```
-
-## Error Handling
-
-The SDK throws descriptive errors for common issues:
-
-```typescript
-try {
-  const response = await sdk.executeTask('Hello', 'unknown-agent');
-} catch (error) {
-  if (error.message.includes('not registered')) {
-    console.error('Agent not found');
-  }
-}
-```
-
-## Examples
-
-See the `/examples` directory for more detailed usage examples.
-
-## License
-
-ISC
-
+This project was created using `bun init` in bun v1.1.30. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.

package/dist/agent-manager.js

@@ -7,9 +7,9 @@ import { OpenCodeAgent } from './agents/opencode-agent.js';
  * Manages agent instances and configurations
  */
 export class AgentManager {
+    agents = new Map();
+    defaultAgentType = 'intella-lite';
     constructor() {
-        this.agents = new Map();
-        this.defaultAgentType = 'intella-lite';
         // Initialize default agents
         this.registerAgent('intella-lite', new IntellaLiteAgent());
         this.registerAgent('claude', new ClaudeAgent());

package/dist/agent-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-manager.js","sourceRoot":"","sources":["../src/agent-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;GAGG;AACH,MAAM,OAAO,YAAY;IAIvB;QAHQ,WAAM,GAA2B,IAAI,GAAG,EAAE,CAAC;QAC3C,qBAAgB,GAAc,cAAc,CAAC;QAGnD,4BAA4B;QAC5B,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,gBAAgB,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,WAAW,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,UAAU,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,aAAa,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,IAAe,EAAE,KAAa;QAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAgB;QACvB,MAAM,SAAS,GAAG,IAAI,IAAI,IAAI,CAAC,gBAAgB,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,SAAS,SAAS,oBAAoB,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAe;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAe,EAAE,MAAmB;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAe;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,SAAS,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAe;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,oBAAoB,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAe;QACzB,IAAI,IAAI,KAAK,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"agent-manager.js","sourceRoot":"","sources":["../src/agent-manager.ts"],"names":[],"mappings":"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"}

package/dist/agents/base-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-agent.d.ts","sourceRoot":"","sources":["../../src/agents/base-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,IAAI,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAkB,MAAM,aAAa,CAAC;AAE1H;;;GAGG;AACH,8BAAsB,SAAU,YAAW,MAAM;IAC/C,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAgB,IAAI,EAAE,SAAS,CAAC;gBAEpB,IAAI,EAAE,SAAS,EAAE,MAAM,GAAE,WAAgB;IAKrD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,IAAI,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAE3D;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAqB1D;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;IA6B/D;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIpC;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,EAAE;CAqC9D"}
+{"version":3,"file":"base-agent.d.ts","sourceRoot":"","sources":["../../src/agents/base-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,IAAI,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAkB,MAAM,aAAa,CAAC;AAE1H;;;GAGG;AACH,8BAAsB,SAAU,YAAW,MAAM;IAC/C,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAgB,IAAI,EAAE,SAAS,CAAC;gBAEpB,IAAI,EAAE,SAAS,EAAE,MAAM,GAAE,WAAgB;IAKrD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,IAAI,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAE3D;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAqB1D;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC;IAoC/D;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIpC;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,EAAE;CAqC9D"}

package/dist/agents/base-agent.js

@@ -4,6 +4,8 @@ import { generateText, streamText } from 'ai';
  * Provides common functionality using AI SDK v6
  */
 export class BaseAgent {
+    config;
+    type;
     constructor(type, config = {}) {
         this.type = type;
         this.config = { ...config };
@@ -42,16 +44,23 @@ export class BaseAgent {
             maxOutputTokens: request.maxTokens ?? this.config.maxTokens,
         });
         let fullText = '';
-        for await (const chunk of result.textStream) {
-            fullText += chunk;
+        for await (const chunk of result.fullStream) {
+            console.log('chunk', chunk);
+            let text = '';
+            if (chunk.type === 'text-delta' || 'text' in chunk) {
+                fullText += chunk.text;
+                text = chunk.text;
+            }
             yield {
-                text: chunk,
+                id: `chunk-${Date.now() * 1}`,
+                text: text,
                 agentType: this.type,
                 isDone: false,
             };
         }
         // Final chunk to indicate completion
         yield {
+            id: `chunk-${Date.now() * 1}`,
             text: '',
             agentType: this.type,
             isDone: true,

package/dist/agents/base-agent.js.map

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

package/dist/agents/claude-agent.d.ts

@@ -13,6 +13,8 @@ export declare class ClaudeAgent extends BaseAgent {
      *
      * Supports Claude Code provider options:
      * - allowedTools, disallowedTools, mcpServers, permissionMode, maxTurns, cwd, verbose
+     * - executablePath: explicit path to the claude binary (preferred)
+     * - pathToClaudeCodeExecutable: legacy option for explicit path (for backward compatibility)
      * See: https://ai-sdk.dev/providers/community-providers/claude-code
      */
     getModel(): Promise<LanguageModel>;

package/dist/agents/claude-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-agent.d.ts","sourceRoot":"","sources":["../../src/agents/claude-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAKxC;;;GAGG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACxC,OAAO,CAAC,aAAa,CAA8B;gBAEvC,MAAM,GAAE,WAAgB;IAIpC;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IA0CxC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CAKrC"}
+{"version":3,"file":"claude-agent.d.ts","sourceRoot":"","sources":["../../src/agents/claude-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAKxC;;;GAGG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACxC,OAAO,CAAC,aAAa,CAA8B;gBAEvC,MAAM,GAAE,WAAgB;IAIpC;;;;;;;;OAQG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IA4DxC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CAKrC"}

package/dist/agents/claude-agent.js

@@ -5,15 +5,17 @@ import { claudeCode, createClaudeCode } from 'ai-sdk-provider-claude-code';
  * Powered by Claude Code provider
  */
 export class ClaudeAgent extends BaseAgent {
+    modelInstance = null;
     constructor(config = {}) {
         super('claude', config);
-        this.modelInstance = null;
     }
     /**
      * Get or create the language model instance
      *
      * Supports Claude Code provider options:
      * - allowedTools, disallowedTools, mcpServers, permissionMode, maxTurns, cwd, verbose
+     * - executablePath: explicit path to the claude binary (preferred)
+     * - pathToClaudeCodeExecutable: legacy option for explicit path (for backward compatibility)
      * See: https://ai-sdk.dev/providers/community-providers/claude-code
      */
     async getModel() {
@@ -23,26 +25,40 @@ export class ClaudeAgent extends BaseAgent {
             // Uses CLI authentication (claude login) - API key not needed in code
             // Model shortcuts: 'opus', 'sonnet', 'haiku'
             const modelId = this.config.model || 'sonnet';
-            // Check if custom provider options are provided
-            const hasCustomOptions = this.config.allowedTools ||
-                this.config.disallowedTools ||
-                this.config.mcpServers ||
-                this.config.permissionMode ||
-                this.config.maxTurns ||
-                this.config.cwd !== undefined ||
-                this.config.verbose !== undefined;
+            // Get the binary path
+            // Build settings object
+            const settings = {};
+            if (this.config.executablePath) {
+                settings.pathToClaudeCodeExecutable = this.config.executablePath;
+            }
+            // Add other config options if provided
+            if (this.config.allowedTools) {
+                settings.allowedTools = this.config.allowedTools;
+            }
+            if (this.config.disallowedTools) {
+                settings.disallowedTools = this.config.disallowedTools;
+            }
+            if (this.config.mcpServers) {
+                settings.mcpServers = this.config.mcpServers;
+            }
+            if (this.config.permissionMode) {
+                settings.permissionMode = this.config.permissionMode;
+            }
+            if (this.config.maxTurns !== undefined) {
+                settings.maxTurns = this.config.maxTurns;
+            }
+            if (this.config.cwd !== undefined) {
+                settings.cwd = this.config.cwd;
+            }
+            if (this.config.verbose !== undefined) {
+                settings.verbose = this.config.verbose;
+            }
+            // Check if we have any custom options (including binary path)
+            const hasCustomOptions = Object.keys(settings).length > 1;
             if (hasCustomOptions) {
                 // Create custom provider instance with options
                 const customProvider = createClaudeCode({
-                    defaultSettings: {
-                        allowedTools: this.config.allowedTools,
-                        disallowedTools: this.config.disallowedTools,
-                        mcpServers: this.config.mcpServers,
-                        permissionMode: this.config.permissionMode,
-                        maxTurns: this.config.maxTurns,
-                        cwd: this.config.cwd,
-                        verbose: this.config.verbose,
-                    }
+                    defaultSettings: settings
                 });
                 this.modelInstance = customProvider(modelId);
             }