@intella/sdk 0.0.1 → 0.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intella/sdk",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Agent orchestrator SDK for managing tasks across multiple AI agents using AI SDK v6",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,9 +11,14 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
+     "prepublishOnly": "pnpm run build",
     "clean": "rm -rf dist",
     "example:basic": "tsx examples/claude-code/basic-usage.ts",
     "example:streaming": "tsx examples/claude-code/streaming.ts",

package/examples/claude-code/README.md

@@ -1,178 +0,0 @@
-# Claude Code Agent Examples
-
-This folder contains examples demonstrating how to use the Claude Code agent through the Intella SDK.
-
-## Prerequisites
-
-1. **Install dependencies:**
-   ```bash
-   npm install @intella/sdk ai ai-sdk-provider-claude-code
-   ```
-
-2. **Install Claude Code CLI:**
-   ```bash
-   npm install -g @anthropic-ai/claude-code
-   ```
-
-3. **Authenticate:**
-   ```bash
-   claude login
-   ```
-   This will open a browser window for authentication. You need a Claude Pro or Max subscription.
-
-## Examples
-
-### 1. Basic Usage (`basic-usage.ts`)
-
-Demonstrates the simplest way to use the Claude Code agent:
-
-```bash
-npx tsx examples/claude-code/basic-usage.ts
-```
-
-**Features:**
-- Basic agent configuration
-- Simple task execution
-- Response handling
-
-### 2. Advanced Configuration (`advanced-config.ts`)
-
-Shows how to configure the Claude Code agent with advanced options:
-
-```bash
-npx tsx examples/claude-code/advanced-config.ts
-```
-
-**Features:**
-- Tool permissions (allowedTools, disallowedTools)
-- Permission modes
-- MCP server configuration
-- Custom working directory
-- Verbose logging
-
-### 3. Streaming (`streaming.ts`)
-
-Demonstrates streaming responses from the Claude Code agent:
-
-```bash
-npx tsx examples/claude-code/streaming.ts
-```
-
-**Features:**
-- Real-time response streaming
-- Chunk-by-chunk output
-- Completion detection
-
-### 4. Orchestration (`orchestration.ts`)
-
-Shows how to orchestrate multiple agents including Claude Code:
-
-```bash
-npx tsx examples/claude-code/orchestration.ts
-```
-
-**Features:**
-- Sequential orchestration (agents work in sequence)
-- Parallel orchestration (agents work simultaneously)
-- Result combination strategies
-
-### 5. Model Comparison (`model-comparison.ts`)
-
-Compares different Claude models (Opus, Sonnet, Haiku) on the same task:
-
-```bash
-npx tsx examples/claude-code/model-comparison.ts
-```
-
-**Features:**
-- Model performance comparison
-- Response time analysis
-- Token usage tracking
-
-## Claude Code Models
-
-The Claude Code provider supports three model shortcuts:
-
-- **`opus`**: Claude Opus - Most capable model, best for complex reasoning
-- **`sonnet`**: Claude Sonnet - Balanced performance and capability (default)
-- **`haiku`**: Claude Haiku - Fastest model, good for simple tasks
-
-You can also use full model identifiers:
-- `claude-opus-4-5`
-- `claude-sonnet-4-5-20250929`
-- `claude-haiku-4-5`
-
-## Configuration Options
-
-### Basic Configuration
-
-```typescript
-sdk.configureAgent('claude', {
-  model: 'sonnet', // Model shortcut or full ID
-});
-```
-
-### Advanced Configuration
-
-```typescript
-sdk.configureAgent('claude', {
-  model: 'opus',
-  allowedTools: ['Read', 'Write', 'Edit'],
-  disallowedTools: ['Bash'],
-  permissionMode: 'default',
-  maxTurns: 10,
-  cwd: process.cwd(),
-  verbose: true,
-});
-```
-
-## Tool Permissions
-
-Claude Code has built-in tools (Bash, Edit, Read, Write, etc.) that execute autonomously. You can control which tools are available:
-
-- **`allowedTools`**: Array of tool names to allow (whitelist)
-- **`disallowedTools`**: Array of tool names to disallow (blacklist)
-- **`permissionMode`**: How to handle tool permissions
-  - `'default'`: Standard permission handling
-  - `'acceptEdits'`: Automatically accept file edits
-  - `'bypassPermissions'`: Skip permission prompts
-  - `'plan'`: Show plan before execution
-
-## MCP Servers
-
-You can configure Model Context Protocol (MCP) servers for extended functionality:
-
-```typescript
-sdk.configureAgent('claude', {
-  mcpServers: {
-    'my-server': {
-      command: 'node',
-      args: ['server.js'],
-    },
-  },
-});
-```
-
-## Authentication
-
-Claude Code uses CLI authentication. After running `claude login`, your Claude Pro or Max subscription is automatically used. No API keys are needed in your code.
-
-## More Information
-
-- [Claude Code Provider Documentation](https://ai-sdk.dev/providers/community-providers/claude-code)
-- [Intella SDK Documentation](../../README.md)
-- [Claude Code CLI Documentation](https://github.com/anthropics/claude-code)
-
-## Running Examples
-
-Make sure you have TypeScript execution support. You can use:
-
-- `tsx` (recommended): `npm install -g tsx`
-- `ts-node`: `npm install -g ts-node`
-- Or compile first: `tsc` then `node dist/example.js`
-
-Example:
-```bash
-npx tsx examples/claude-code/basic-usage.ts
-```
-

package/examples/claude-code/advanced-config.ts

@@ -1,55 +0,0 @@
-/**
- * Advanced Claude Code Agent Configuration
- * 
- * This example demonstrates advanced configuration options for the Claude Code agent,
- * including tool permissions, MCP servers, and custom settings.
- * 
- * Prerequisites:
- * 1. Install dependencies: npm install @intella/sdk ai ai-sdk-provider-claude-code
- * 2. Install Claude Code CLI: npm install -g @anthropic-ai/claude-code
- * 3. Authenticate: claude login
- */
-
-import { IntellaSDK } from '../../src/index';
-
-async function main() {
-  const sdk = new IntellaSDK();
-
-  // Select and configure Claude agent with advanced options
-  sdk.selectAgent('claude', {
-    model: 'opus', // Most capable model
-    
-    // Tool permissions
-    allowedTools: ['Read', 'Write', 'Edit'], // Only allow these tools
-    disallowedTools: ['Bash'], // Explicitly disallow Bash
-    
-    // Permission mode
-    permissionMode: 'default', // Options: 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan'
-    
-    // MCP server configuration (optional)
-    // mcpServers: {
-    //   'my-server': {
-    //     command: 'node',
-    //     args: ['server.js'],
-    //   },
-    // },
-    
-    // Other options
-    maxTurns: 10, // Maximum conversation turns
-    cwd: process.cwd(), // Working directory
-    verbose: true, // Enable debug logging
-  });
-
-  console.log('Claude agent configured with advanced settings\n');
-
-  // Execute a task that might use tools
-  const response = await sdk.executeTask({
-    prompt: 'Read the package.json file and summarize the dependencies.',
-    systemPrompt: 'You are a helpful coding assistant.',
-  });
-
-  console.log('Response:', response.text);
-}
-
-main().catch(console.error);
-

package/examples/claude-code/basic-usage.ts

@@ -1,56 +0,0 @@
-/**
- * Basic Claude Code Agent Usage
- * 
- * This example demonstrates basic usage of the Claude Code agent
- * through the Intella SDK.
- * 
- * Prerequisites:
- * 1. Install dependencies: npm install @intella/sdk ai ai-sdk-provider-claude-code
- * 2. Install Claude Code CLI: npm install -g @anthropic-ai/claude-code
- * 3. Authenticate: claude login
- */
-
-import { IntellaSDK } from '../../src/index';
-
-async function main() {
-  const sdk = new IntellaSDK();
-
-  // Verify default agent before selection
-  console.log('Default agent before selection:', sdk.getDefaultAgentType());
-  console.log('Available agents:', sdk.listAgents());
-  console.log('');
-
-  // Select and configure Claude agent as default
-  // Claude Code uses CLI authentication (claude login)
-  sdk.selectAgent('claude', {
-    model: 'sonnet', // Options: 'opus', 'sonnet', 'haiku'
-    verbose: true, // Enable verbose logging to see Claude Code in action
-  });
-
-  // Verify agent selection
-  console.log('Default agent after selection:', sdk.getDefaultAgentType());
-  console.log('Claude agent config:', sdk.getAgentConfig('claude'));
-  console.log('');
-
-  // Execute a simple task (will use Claude as it's now the default)
-  console.log('Executing task with Claude Code agent...\n');
-  const response = await sdk.executeTask(
-    'Write a brief explanation of quantum computing in 2-3 sentences.'
-  );
-
-  console.log('\n=== Response ===');
-  console.log('Agent Type:', response.agentType);
-  console.log('Response:', response.text);
-  console.log('\n=== Metadata ===');
-  console.log(JSON.stringify(response.metadata, null, 2));
-  
-  // Final verification
-  if (response.agentType === 'claude') {
-    console.log('\n✅ SUCCESS: Claude Code agent was used!');
-  } else {
-    console.log(`\n❌ WARNING: Expected 'claude' but got '${response.agentType}'`);
-  }
-}
-
-main().catch(console.error);
-

package/examples/claude-code/model-comparison.ts

@@ -1,50 +0,0 @@
-/**
- * Claude Code Model Comparison
- * 
- * This example demonstrates using different Claude models (Opus, Sonnet, Haiku)
- * to compare their responses to the same prompt.
- * 
- * Prerequisites:
- * 1. Install dependencies: npm install @intella/sdk ai ai-sdk-provider-claude-code
- * 2. Install Claude Code CLI: npm install -g @anthropic-ai/claude-code
- * 3. Authenticate: claude login
- */
-
-import { IntellaSDK } from '../../src/index';
-
-async function main() {
-  const sdk = new IntellaSDK();
-
-  const prompt = 'Explain the concept of recursion in programming with a simple example.';
-  const models = ['haiku', 'sonnet', 'opus'] as const;
-
-  console.log('Comparing Claude models on the same prompt...\n');
-  console.log('Prompt:', prompt);
-  console.log('='.repeat(80) + '\n');
-
-  for (const model of models) {
-    console.log(`\n${model.toUpperCase()} Model:`);
-    console.log('-'.repeat(80));
-
-    // Select agent with specific model
-    sdk.selectAgent('claude', { model });
-
-    const startTime = Date.now();
-    const response = await sdk.executeTask(prompt);
-    const duration = Date.now() - startTime;
-
-    console.log(response.text);
-    console.log(`\nResponse time: ${duration}ms`);
-    console.log(`Tokens: ${response.metadata?.usage?.totalTokens || 'N/A'}`);
-    console.log('='.repeat(80));
-  }
-
-  console.log('\nComparison complete!');
-  console.log('\nModel characteristics:');
-  console.log('- Haiku: Fastest, good for simple tasks');
-  console.log('- Sonnet: Balanced performance and capability');
-  console.log('- Opus: Most capable, best for complex reasoning');
-}
-
-main().catch(console.error);
-

package/examples/claude-code/orchestration.ts

@@ -1,70 +0,0 @@
-/**
- * Multi-Agent Orchestration with Claude Code
- * 
- * This example demonstrates orchestrating multiple agents including Claude Code
- * for complex tasks that benefit from multiple AI perspectives.
- * 
- * Prerequisites:
- * 1. Install dependencies: npm install @intella/sdk ai ai-sdk-provider-claude-code
- * 2. Install Claude Code CLI: npm install -g @anthropic-ai/claude-code
- * 3. Authenticate: claude login
- */
-
-import { IntellaSDK } from '../../src/index';
-
-async function main() {
-  const sdk = new IntellaSDK();
-
-  // Configure multiple agents
-  sdk.configureAgent('claude', {
-    model: 'sonnet',
-  });
-
-  sdk.configureAgent('intella-lite', {
-    apiKey: process.env.OPENAI_API_KEY,
-    model: 'gpt-4o-mini',
-  });
-
-  console.log('Orchestrating task across multiple agents...\n');
-
-  // Sequential orchestration: Claude analyzes, then Intella Lite refines
-  const sequentialResult = await sdk.orchestrateTask(
-    {
-      prompt: 'Analyze the pros and cons of microservices architecture, then create a summary.',
-      systemPrompt: 'You are a software architecture expert.',
-    },
-    ['claude', 'intella-lite'],
-    'sequential',
-    {
-      passResults: true, // Pass Claude's analysis to Intella Lite for summarization
-    }
-  );
-
-  console.log('Sequential Orchestration Result:');
-  console.log('='.repeat(50));
-  console.log(sequentialResult.result);
-  console.log('\nAgent Responses:');
-  sequentialResult.agentResponses.forEach((agentResponse, index) => {
-    console.log(`\n${index + 1}. ${agentResponse.agentType}:`);
-    console.log(agentResponse.response.substring(0, 200) + '...');
-  });
-
-  console.log('\n\n' + '='.repeat(50) + '\n');
-
-  // Parallel orchestration: Get multiple perspectives simultaneously
-  const parallelResult = await sdk.orchestrateTask(
-    'What are the key considerations when choosing a database for a new project?',
-    ['claude', 'intella-lite'],
-    'parallel',
-    {
-      combineStrategy: 'merge', // Combine all responses
-    }
-  );
-
-  console.log('Parallel Orchestration Result:');
-  console.log('='.repeat(50));
-  console.log(parallelResult.result);
-}
-
-main().catch(console.error);
-

package/examples/claude-code/streaming.ts

@@ -1,69 +0,0 @@
-/**
- * Streaming with Claude Code Agent
- * 
- * This example demonstrates how to stream responses from the Claude Code agent.
- * 
- * Prerequisites:
- * 1. Install dependencies: npm install @intella/sdk ai ai-sdk-provider-claude-code
- * 2. Install Claude Code CLI: npm install -g @anthropic-ai/claude-code
- * 3. Authenticate: claude login
- */
-
-import { IntellaSDK, extractCodeBlock } from '../../src/index';
-
-async function main() {
-  const sdk = new IntellaSDK();
-
-  // Select and configure Claude agent
-  sdk.selectAgent('intella-lite', {
-    model: 'gpt-4o-mini',
-  });
-
-  console.log('Streaming response from Claude Code agent...\n');
-
-  let code = ''
-
-  let chunks = []
-
-  // Stream the response
-  for await (const chunk of sdk.streamTask(
-    'Write a python script to generate ascii art of a cat'
-  )) {
-    // Write each chunk as it arrives
-    process.stdout.write(chunk.text);
-    chunks.push(chunk.text);
-    
-    if (chunk.isDone) {
-      console.log('\n\nStreaming complete!');
-      console.log('Agent Type:', chunk.agentType);
-    }
-  }
-
-  let response = chunks.join('');
-
-  console.log('Response:', response);
-
-  // Extract the code from the response
-
-  const codeBlock = extractCodeBlock(response, 'python');
-  if (!codeBlock) {
-    throw new Error('No python code block found');
-  }
-  code = codeBlock.code;
-
-  // Execute the code
-
-  console.log('Code:', code);
-
-  const sandbox = await sdk.initializeSandbox('e2b', {
-    templateId: 'base',
-  });
-  const result = await sandbox.runCode(code, {
-    language: 'python',
-  });
-  console.log('Result:', result);
-
-}
-
-main().catch(console.error);
-

package/examples/claude-code/tsconfig.json

@@ -1,19 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "../..",
-    "moduleResolution": "node",
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "types": ["node"],
-    "lib": ["ES2020"],
-    "baseUrl": "../..",
-    "paths": {
-      "@intella/sdk": ["./src/index.ts"]
-    }
-  },
-  "include": ["*.ts", "../../src/**/*.ts"],
-  "exclude": ["node_modules", "dist"]
-}
-

package/examples/code-extractor/README.md

@@ -1,77 +0,0 @@
-# Code Extractor Utility Example
-
-This example demonstrates how to use the code extractor utility functions to extract code blocks from LLM responses in markdown format.
-
-## Functions
-
-### `extractCodeBlocks(text, options?)`
-
-Extracts all code blocks from markdown text. Returns an array of `CodeBlock` objects or code strings.
-
-**Options:**
-- `languages?: string[]` - Filter by specific language(s) (case-insensitive)
-- `codeOnly?: boolean` - Return only code strings instead of full objects
-- `includeFullMatch?: boolean` - Include the full match including fences
-- `customWrapper?: { start: string; end: string }` - Use custom wrapper strings instead of default ``` markers
-
-### `extractCodeBlock(text, language?)`
-
-Extracts the first code block from markdown text. Optionally filter by language.
-
-### `extractCode(text, language?)`
-
-Extracts the code content from the first code block as a string. Optionally filter by language.
-
-## Usage Examples
-
-```typescript
-import { extractCodeBlocks, extractCodeBlock, extractCode } from '@intella/sdk';
-
-const markdown = `
-Here's some code:
-\`\`\`typescript
-const x = 1;
-\`\`\`
-
-And a command:
-\`\`\`bash
-npm install
-\`\`\`
-`;
-
-// Extract all code blocks
-const blocks = extractCodeBlocks(markdown);
-// Returns: [
-//   { language: 'typescript', code: 'const x = 1;' },
-//   { language: 'bash', code: 'npm install' }
-// ]
-
-// Extract only TypeScript blocks
-const tsBlocks = extractCodeBlocks(markdown, { languages: ['typescript'] });
-
-// Extract only code strings
-const codeStrings = extractCodeBlocks(markdown, { codeOnly: true });
-// Returns: ['const x = 1;', 'npm install']
-
-// Extract first block
-const firstBlock = extractCodeBlock(markdown);
-// Returns: { language: 'typescript', code: 'const x = 1;' }
-
-// Extract code string only
-const code = extractCode(markdown, 'bash');
-// Returns: 'npm install'
-
-// Using custom wrapper
-const customMarkdown = '<code>typescript\nconst x = 1;\n</code>';
-const customBlocks = extractCodeBlocks(customMarkdown, {
-  customWrapper: { start: '<code>', end: '</code>' }
-});
-// Returns: [{ language: 'typescript', code: 'const x = 1;' }]
-```
-
-## Running the Example
-
-```bash
-# From the SDK root directory
-npx tsx examples/code-extractor/example.ts
-```