@intella/sdk 0.0.1 → 0.0.3

package/examples/code-extractor/example.ts

@@ -1,145 +0,0 @@
-/**
- * Code Extractor Utility Example
- * 
- * This example demonstrates how to use the code extractor utility
- * to extract code blocks from LLM responses in markdown format.
- */
-
-import {
-  extractCodeBlocks,
-  extractCodeBlock,
-  extractCode,
-  type CodeBlock,
-} from '../../src/index';
-
-async function main() {
-  // Example markdown text with multiple code blocks
-  const markdownText = `
-Here's a TypeScript example:
-
-\`\`\`typescript
-function greet(name: string): string {
-  return \`Hello, \${name}!\`;
-}
-\`\`\`
-
-And here's a bash command:
-
-\`\`\`bash
-npm install @intella/sdk
-\`\`\`
-
-Finally, some Python code:
-
-\`\`\`python
-def calculate_sum(a, b):
-    return a + b
-\`\`\`
-  `;
-
-  console.log('=== Example 1: Extract All Code Blocks ===\n');
-  const allBlocks = extractCodeBlocks(markdownText) as CodeBlock[];
-  console.log(`Found ${allBlocks.length} code blocks:\n`);
-  allBlocks.forEach((block, index) => {
-    console.log(`Block ${index + 1}:`);
-    console.log(`  Language: ${block.language || '(none)'}`);
-    console.log(`  Code:\n${block.code}\n`);
-  });
-
-  console.log('\n=== Example 2: Extract Only TypeScript Blocks ===\n');
-  const tsBlocks = extractCodeBlocks(markdownText, {
-    languages: ['typescript'],
-  }) as CodeBlock[];
-  console.log(`Found ${tsBlocks.length} TypeScript block(s):\n`);
-  tsBlocks.forEach((block) => {
-    console.log(`Language: ${block.language}`);
-    console.log(`Code:\n${block.code}\n`);
-  });
-
-  console.log('\n=== Example 3: Extract Code Strings Only ===\n');
-  const codeStrings = extractCodeBlocks(markdownText, {
-    codeOnly: true,
-  }) as string[];
-  console.log(`Extracted ${codeStrings.length} code strings:\n`);
-  codeStrings.forEach((code, index) => {
-    console.log(`Code ${index + 1}:\n${code}\n`);
-  });
-
-  console.log('\n=== Example 4: Extract Single Code Block ===\n');
-  const bashBlock = extractCodeBlock(markdownText, 'bash');
-  if (bashBlock) {
-    console.log('Found bash block:');
-    console.log(`Language: ${bashBlock.language}`);
-    console.log(`Code: ${bashBlock.code}\n`);
-  }
-
-  console.log('\n=== Example 5: Extract Code String Only ===\n');
-  const pythonCode = extractCode(markdownText, 'python');
-  if (pythonCode) {
-    console.log('Python code:');
-    console.log(pythonCode);
-  }
-
-  console.log('\n=== Example 6: Extract with Full Match ===\n');
-  const blocksWithMatch = extractCodeBlocks(markdownText, {
-    includeFullMatch: true,
-  }) as CodeBlock[];
-  console.log('First block with full match:');
-  if (blocksWithMatch[0]?.fullMatch) {
-    console.log(blocksWithMatch[0].fullMatch);
-  }
-
-  // Example: Using with LLM response
-  console.log('\n=== Example 7: Real-world Usage with LLM Response ===\n');
-  const llmResponse = `
-I'll help you create a function. Here's the code:
-
-\`\`\`typescript
-export function add(a: number, b: number): number {
-  return a + b;
-}
-\`\`\`
-
-You can test it with:
-
-\`\`\`bash
-npm test
-\`\`\`
-  `;
-
-  const extractedCode = extractCode(llmResponse, 'typescript');
-  if (extractedCode) {
-    console.log('Extracted TypeScript code from LLM response:');
-    console.log(extractedCode);
-  }
-
-  // Example: Using custom wrapper
-  console.log('\n=== Example 8: Using Custom Wrapper ===\n');
-  const customMarkdown = `
-Here's some code with custom tags:
-
-<code>typescript
-function hello() {
-  console.log('Hello!');
-}
-</code>
-
-And another one:
-
-<code>bash
-echo "Hello World"
-</code>
-  `;
-
-  const customBlocks = extractCodeBlocks(customMarkdown, {
-    customWrapper: { start: '<code>', end: '</code>' },
-  }) as CodeBlock[];
-  console.log(`Found ${customBlocks.length} code blocks with custom wrapper:\n`);
-  customBlocks.forEach((block, index) => {
-    console.log(`Block ${index + 1}:`);
-    console.log(`  Language: ${block.language || '(none)'}`);
-    console.log(`  Code:\n${block.code}\n`);
-  });
-}
-
-main().catch(console.error);

package/examples/filesystem/basic-usage.ts

@@ -1,84 +0,0 @@
-import { IntellaSDK } from '../../src/index.js';
-
-/**
- * Basic example demonstrating filesystem usage with Intella SDK
- */
-async function main() {
-  const sdk = new IntellaSDK();
-
-  // Initialize filesystem with AgentFS provider
-  console.log('Initializing AgentFS filesystem...');
-  await sdk.initializeFilesystem('agentfs', {
-    agentId: 'example-agent',
-  });
-
-  // Filesystem operations
-  console.log('\n=== Filesystem Operations ===');
-  
-  // Write a file
-  await sdk.writeFile('/hello.txt', 'Hello from Intella SDK!');
-  console.log('✓ Wrote /hello.txt');
-
-  // Read the file
-  const content = await sdk.readFile('/hello.txt');
-  console.log(`✓ Read /hello.txt: ${content}`);
-
-  // Create a directory
-  await sdk.createDirectory('/output', true);
-  console.log('✓ Created /output directory');
-
-  // Write a file in the directory
-  await sdk.writeFile('/output/report.txt', 'This is a report');
-  console.log('✓ Wrote /output/report.txt');
-
-  // List directory contents
-  const entries = await sdk.readDirectory('/output');
-  console.log(`✓ Directory /output contains ${entries.length} entries:`);
-  for (const entry of entries) {
-    console.log(`  - ${entry.name} (${entry.stats.isDirectory ? 'dir' : 'file'})`);
-  }
-
-  // Key-value operations
-  console.log('\n=== Key-Value Operations ===');
-  
-  await sdk.setValue('user:preferences', { theme: 'dark', language: 'en' });
-  console.log('✓ Set user preferences');
-
-  const preferences = await sdk.getValue('user:preferences');
-  console.log(`✓ Got user preferences:`, preferences);
-
-  // Tool call tracking
-  console.log('\n=== Tool Call Tracking ===');
-  
-  await sdk.recordToolCall({
-    tool: 'web_search',
-    startedAt: Date.now() / 1000 - 5,
-    endedAt: Date.now() / 1000 - 4,
-    input: { query: 'AI agents' },
-    output: { results: ['result1', 'result2'] },
-    status: 'success',
-  });
-  console.log('✓ Recorded tool call');
-
-  const history = await sdk.getToolCallHistory({ limit: 10 });
-  console.log(`✓ Retrieved ${history.length} tool calls from history`);
-
-  // Using memory provider (ephemeral, in-memory)
-  console.log('\n=== Memory Provider (Ephemeral) ===');
-  
-  await sdk.closeFilesystem();
-  await sdk.initializeFilesystem('memory');
-  
-  await sdk.writeFile('/temp.txt', 'Temporary file');
-  console.log('✓ Wrote temporary file to memory filesystem');
-
-  const tempContent = await sdk.readFile('/temp.txt');
-  console.log(`✓ Read temporary file: ${tempContent}`);
-
-  // Cleanup
-  await sdk.closeFilesystem();
-  console.log('\n✓ Closed filesystem');
-}
-
-main().catch(console.error);
-

package/examples/integrated-task/README.md

@@ -1,68 +0,0 @@
-# Integrated Task Example
-
-This example demonstrates how to use **Agent**, **FileSystem**, and **Sandbox** together to carry out a complete task.
-
-## Overview
-
-The example shows a complete workflow:
-
-1. **Agent** generates Python code to calculate Fibonacci numbers
-2. **FileSystem** stores the generated code and results
-3. **Sandbox** executes the code in an isolated environment
-4. Results are read back and analyzed by the **Agent**
-
-## Prerequisites
-
-- Node.js 18+ or Bun
-- Environment variables:
-  - `E2B_API_KEY` - For E2B sandbox (or use Daytona)
-  - `ANTHROPIC_API_KEY` - For Claude agent (or use another agent)
-
-## Running the Example
-
-```bash
-# Install dependencies (if not already installed)
-cd packages/intella-sdk
-bun install
-
-# Run the example
-bun run examples/integrated-task/integrated-usage.ts
-```
-
-Or with Node.js:
-
-```bash
-npx tsx examples/integrated-task/integrated-usage.ts
-```
-
-## What It Does
-
-1. **Initializes Filesystem** - Sets up a memory-based filesystem for storing code and results
-2. **Initializes Sandbox** - Creates an E2B sandbox environment for code execution
-3. **Configures Agent** - Sets up Claude Sonnet to generate code
-4. **Generates Code** - Agent creates a Python script for Fibonacci calculation
-5. **Saves Code** - Code is stored in the filesystem
-6. **Executes in Sandbox** - The script runs in the isolated sandbox environment
-7. **Reads Results** - Results are retrieved from the sandbox
-8. **Persists Data** - Results are saved back to filesystem
-9. **Analyzes Results** - Agent analyzes the generated Fibonacci sequence
-10. **Tracks Metadata** - Tool calls are recorded for audit/debugging
-
-## Customization
-
-You can modify this example to:
-
-- Use different agents (intella-lite, codex, opencode)
-- Use different sandbox providers (daytona instead of e2b)
-- Use persistent filesystem (agentfs instead of memory)
-- Change the task to generate different types of code
-- Add more complex workflows with multiple agent interactions
-
-## Key Concepts
-
-- **Agent**: Generates code, analyzes results, provides AI capabilities
-- **FileSystem**: Persistent storage for code, data, and metadata
-- **Sandbox**: Isolated execution environment for running code safely
-
-Together, these three components enable powerful AI-driven development workflows.
-

package/examples/integrated-task/integrated-usage.ts

@@ -1,193 +0,0 @@
-/**
- * Integrated Task Example
- * 
- * This example demonstrates how to use Agent, FileSystem, and Sandbox together
- * to carry out a complete task:
- * 1. Use an Agent to generate code
- * 2. Save the code to FileSystem
- * 3. Execute the code in a Sandbox
- * 4. Read and process results
- * 
- * Prerequisites:
- * - For E2B: Set E2B_API_KEY environment variable
- * - For AgentFS: Configure your agent backend
- * - For Claude: Set ANTHROPIC_API_KEY environment variable
- */
-
-import { IntellaSDK } from '../../src/index.js';
-import 'dotenv/config';
-
-async function main() {
-  const sdk = new IntellaSDK();
-
-  console.log('🚀 Starting Integrated Task Example\n');
-
-  try {
-    // Step 1: Initialize Filesystem
-    console.log('📁 Step 1: Initializing Filesystem...');
-    await sdk.initializeFilesystem('memory', {
-      // Using memory provider for this example
-      // You can also use 'agentfs' for persistent storage
-    });
-    console.log('✓ Filesystem initialized\n');
-
-    // Step 2: Initialize Sandbox
-    console.log('🏖️  Step 2: Initializing Sandbox...');
-    await sdk.initializeSandbox('e2b', {
-      templateId: 'base', // Use 'base' template or your custom template ID
-      env: {
-        NODE_ENV: 'development',
-      },
-    });
-    console.log('✓ Sandbox initialized\n');
-
-    // Step 3: Configure Agent
-    console.log('🤖 Step 3: Configuring Agent...');
-    sdk.selectAgent('claude', {
-      model: 'sonnet', // or 'haiku', 'opus'
-      temperature: 0.7,
-    });
-    console.log('✓ Agent configured (Claude Sonnet)\n');
-
-    // Step 4: Task - Generate a Python script that calculates Fibonacci numbers
-    console.log('📝 Step 4: Generating code with Agent...');
-    const taskPrompt = `Write a Python script that:
-1. Calculates the first 20 Fibonacci numbers
-2. Saves them to a file called 'fibonacci.txt'
-3. Prints each number as it calculates
-
-Make the code clean and well-commented.`;
-
-    const agentResponse = await sdk.executeTask({
-      prompt: taskPrompt,
-      systemPrompt: 'You are a helpful coding assistant. Generate clean, working code.',
-    });
-
-    console.log('✓ Code generated by agent');
-    console.log('Agent response preview:', agentResponse.text.substring(0, 200) + '...\n');
-
-    // Step 5: Extract and save code to filesystem
-    console.log('💾 Step 5: Saving code to Filesystem...');
-    
-    // Extract Python code from the agent response (simple extraction)
-    // In a real scenario, you might use more sophisticated parsing
-    const codeMatch = agentResponse.text.match(/```python\n([\s\S]*?)\n```/) ||
-                      agentResponse.text.match(/```\n([\s\S]*?)\n```/);
-    
-    if (!codeMatch) {
-      throw new Error('Could not extract code from agent response');
-    }
-
-    const pythonCode = codeMatch[1];
-    const scriptPath = '/tmp/fibonacci.py';
-    
-    // Save to filesystem
-    await sdk.writeFile(scriptPath, pythonCode);
-    console.log(`✓ Code saved to ${scriptPath} in filesystem\n`);
-
-    // Step 6: Copy code from filesystem to sandbox
-    console.log('📤 Step 6: Copying code to Sandbox...');
-    const sandbox = sdk.getActiveSandbox();
-    if (!sandbox) {
-      throw new Error('No active sandbox');
-    }
-
-    // Read from filesystem and write to sandbox
-    const codeContent = await sdk.readFile(scriptPath);
-    // Convert to string if it's a Buffer
-    const codeString = typeof codeContent === 'string' ? codeContent : codeContent.toString('utf-8');
-    await sandbox.writeFile('/tmp/fibonacci.py', codeString);
-    console.log('✓ Code copied to sandbox\n');
-
-    // Step 7: Execute the script in sandbox
-    console.log('⚡ Step 7: Executing script in Sandbox...');
-    const executionResult = await sdk.executeInSandbox('python3 /tmp/fibonacci.py', {
-      cwd: '/tmp',
-      timeout: 30000, // 30 seconds
-    });
-
-    console.log('✓ Script executed');
-    console.log('Exit code:', executionResult.result.exitCode);
-    console.log('Output:', executionResult.result.stdout);
-    if (executionResult.result.stderr) {
-      console.log('Errors:', executionResult.result.stderr);
-    }
-    console.log();
-
-    // Step 8: Read results from sandbox
-    console.log('📥 Step 8: Reading results from Sandbox...');
-    const resultFile = await sandbox.readFile('/tmp/fibonacci.txt');
-    console.log('✓ Results file read');
-    console.log('Fibonacci numbers:', resultFile);
-    console.log();
-
-    // Step 9: Save results back to filesystem for persistence
-    console.log('💾 Step 9: Saving results to Filesystem...');
-    await sdk.writeFile('/results/fibonacci.txt', resultFile);
-    await sdk.setValue('task:fibonacci:completed', {
-      timestamp: new Date().toISOString(),
-      count: 20,
-      status: 'success',
-    });
-    console.log('✓ Results saved to filesystem\n');
-
-    // Step 10: Use agent to analyze results
-    console.log('🔍 Step 10: Analyzing results with Agent...');
-    const analysisResponse = await sdk.executeTask({
-      prompt: `Analyze these Fibonacci numbers: ${resultFile}\n\nProvide insights about the sequence.`,
-    });
-    console.log('✓ Analysis complete');
-    console.log('Analysis:', analysisResponse.text);
-    console.log();
-
-    // Step 11: Record tool call metadata
-    console.log('📊 Step 11: Recording tool call metadata...');
-    await sdk.recordToolCall({
-      tool: 'python_execution',
-      startedAt: Date.now() / 1000 - 10,
-      endedAt: Date.now() / 1000,
-      input: { script: scriptPath, command: 'python3 /tmp/fibonacci.py' },
-      output: { result: resultFile, exitCode: executionResult.result.exitCode },
-      status: executionResult.result.exitCode === 0 ? 'success' : 'error',
-    });
-    console.log('✓ Tool call recorded\n');
-
-    // Step 12: Retrieve tool call history
-    console.log('📜 Step 12: Retrieving tool call history...');
-    const history = await sdk.getToolCallHistory({ limit: 5 });
-    console.log(`✓ Retrieved ${history.length} tool calls`);
-    history.forEach((call, index) => {
-      console.log(`  ${index + 1}. ${call.tool} - ${call.status} (${new Date(call.startedAt * 1000).toLocaleTimeString()})`);
-    });
-    console.log();
-
-    console.log('✅ Task completed successfully!');
-
-  } catch (error) {
-    console.error('❌ Error during task execution:', error);
-    throw error;
-  } finally {
-    // Cleanup
-    console.log('\n🧹 Cleaning up...');
-    try {
-      await sdk.closeSandbox();
-      console.log('✓ Sandbox closed');
-    } catch (error) {
-      console.warn('Warning: Error closing sandbox:', error);
-    }
-
-    try {
-      await sdk.closeFilesystem();
-      console.log('✓ Filesystem closed');
-    } catch (error) {
-      console.warn('Warning: Error closing filesystem:', error);
-    }
-  }
-}
-
-// Run the example
-main().catch((error) => {
-  console.error('Fatal error:', error);
-  process.exit(1);
-});
-

package/examples/integrated-task/simple-example.ts

@@ -1,51 +0,0 @@
-/**
- * Simple Integrated Example
- * 
- * A concise example showing Agent + FileSystem + Sandbox integration
- */
-
-import { IntellaSDK } from '../../src/index.js';
-import 'dotenv/config';
-
-async function simpleTask() {
-  const sdk = new IntellaSDK();
-
-  // 1. Initialize all components
-  await sdk.initializeFilesystem('memory');
-  await sdk.initializeSandbox('e2b', { templateId: 'base' });
-  sdk.selectAgent('intella-lite', { model: 'gpt-4o' });
-
-  // 2. Generate code with Agent
-  const { text } = await sdk.executeTask({
-    prompt: 'Write a Python script that prints "Hello from integrated SDK!"',
-  });
-
-  console.log('Text:', text);
-
-  // 3. Extract and save code
-  const code = text.match(/```python\n([\s\S]*?)\n```/)?.[1] || text;
-  await sdk.writeFile('/script.py', code);
-
-  // 4. Copy to sandbox and execute
-  const codeContent = await sdk.readFile('/script.py');
-  console.log('Code content:', codeContent);
-  const codeString = typeof codeContent === 'string' ? codeContent : codeContent.toString('utf-8');
-
-  console.log('Code string:', codeString);
-  
-  const sandbox = sdk.getActiveSandbox()!;
-  await sandbox.writeFile('/tmp/script.py', codeString);
-  console.log('Script written to sandbox');
-
-  console.log('Executing script in sandbox', sandbox);
-  const result = await sdk.executeInSandbox('python3 /tmp/script.py')
-  console.log('Result:', result);
-  console.log('Output:', result.result.stdout);
-
-  // 5. Cleanup
-  await sdk.closeSandbox();
-  await sdk.closeFilesystem();
-}
-
-simpleTask().catch(console.error);
-

package/examples/integrated-task/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"]
-}
-