SDK Overview

// OpenAI integration
import OpenAI from '@openfiles-ai/sdk/openai'

// Tools integration
import { OpenFilesTools } from '@openfiles-ai/sdk/tools'

// Core client
import { OpenFilesClient } from '@openfiles-ai/sdk/core'

const ai = new OpenAI({
  apiKey: string,                    // OpenAI API key (required)
  openFilesApiKey: string,           // OpenFiles API key (required)  
  basePath?: string,                 // File path prefix (optional)
  timeout?: number,                  // Request timeout ms (default: 60000)
  maxRetries?: number                // Failed request retries (default: 3)
})

const tools = new OpenFilesTools({
  apiKey: string,                    // OpenFiles API key (required)
  basePath?: string,                 // File path prefix (optional)
  timeout?: number,                  // Request timeout ms (default: 60000)
  maxRetries?: number                // Failed request retries (default: 3)
})

// Access provider-specific tools
tools.openai.definitions           // OpenAI tool definitions
tools.anthropic.definitions        // Anthropic tool definitions

const client = new OpenFilesClient({
  apiKey: string,                    // OpenFiles API key (required)
  baseUrl?: string,                  // API base URL (default: https://api.openfiles.ai/functions/v1/api)
  basePath?: string,                 // File path prefix (optional) 
  timeout?: number,                  // Request timeout ms (default: 60000)
  maxRetries?: number                // Failed request retries (default: 3)
})

import { FileOperationError } from '@openfiles-ai/sdk/core'

try {
  await client.writeFile({ path: 'file.txt', content: 'hello' })
} catch (error) {
  if (error instanceof FileOperationError) {
    console.log(error.statusCode)  // HTTP status
    console.log(error.code)        // Error code
    console.log(error.message)     // Error description
  }
}