@agi-cli/sdk 0.1.50 → 0.1.51

package/README.md

@@ -1,675 +1,374 @@
 # @agi-cli/sdk
 
-**Batteries-included AI agent SDK.** Build AI assistants with tools, streaming, and multi-provider support in minutes.
+> **The single source of truth for AGI CLI functionality** - Comprehensive, tree-shakable, and developer-friendly.
+
+## Overview
+
+`@agi-cli/sdk` is the unified SDK for building AI agents with AGI CLI. It re-exports all functionality from the underlying packages (`@agi-cli/core`, `@agi-cli/providers`, `@agi-cli/auth`, etc.) in a tree-shakable way.
+
+**Why use the SDK?**
+- ✅ **Single import**: All functionality from one package
+- ✅ **Tree-shakable**: Bundlers only include what you use
+- ✅ **Type-safe**: Full TypeScript support with comprehensive types
+- ✅ **Zero circular dependencies**: Clean architecture
+- ✅ **Consistent API**: No need to remember which package exports what
 
 ## Installation
 
 ```bash
-npm install @agi-cli/sdk
-# or
 bun add @agi-cli/sdk
 ```
 
-**That's it. No need to install `ai`, `@ai-sdk/anthropic`, `hono`, or anything else.** Everything is included.
-
----
-
 ## Quick Start
 
-### 1. Simple AI Call
-
 ```typescript
 import { generateText, resolveModel } from '@agi-cli/sdk';
+import type { ProviderId } from '@agi-cli/sdk';
 
-const model = await resolveModel('anthropic', 'claude-sonnet-4');
+const model = resolveModel('anthropic', 'claude-3-5-sonnet-20241022');
 
-const result = await generateText({
+const { text } = await generateText({
   model,
-  prompt: 'Explain quantum computing in one sentence'
+  prompt: 'What is the meaning of life?',
 });
 
-console.log(result.text);
+console.log(text);
 ```
 
-### 2. AI Agent with Tools
+## What's Included?
 
-```typescript
-import { generateText, resolveModel, discoverProjectTools } from '@agi-cli/sdk';
+### Types (from `@agi-cli/types`)
 
-const model = await resolveModel('anthropic', 'claude-sonnet-4');
-const tools = await discoverProjectTools(process.cwd());
+All shared types are available:
 
-const result = await generateText({
-  model,
-  prompt: 'List all TypeScript files and count total lines',
-  tools: Object.fromEntries(tools.map(t => [t.name, t.tool])),
-  maxSteps: 10
-});
-
-console.log(result.text);
+```typescript
+import type { 
+  ProviderId, 
+  ModelInfo, 
+  AuthInfo, 
+  AGIConfig,
+  ProviderConfig,
+  Scope
+} from '@agi-cli/sdk';
 ```
 
-**That's it!** Your agent now has access to:
-- File operations (read, write, edit, ls, tree)
-- Code search (glob, grep, ripgrep)
-- Git operations (status, diff, commit, log)
-- Shell execution (bash)
-- And more...
+### Providers (from `@agi-cli/providers`)
 
-### 3. HTTP Server
+Provider catalog and utilities:
 
 ```typescript
-import { createServer } from '@agi-cli/sdk';
+import { 
+  catalog,
+  isProviderId,
+  providerIds,
+  defaultModelFor,
+  hasModel,
+  isProviderAuthorized,
+  validateProviderModel,
+  estimateModelCostUsd,
+  providerEnvVar,
+  readEnvKey,
+  setEnvKey
+} from '@agi-cli/sdk';
 
-const app = createServer();
+// Check available providers
+console.log(providerIds); // ['openai', 'anthropic', 'google', 'openrouter', 'opencode']
 
-// Start server
-export default {
-  port: 3000,
-  fetch: app.fetch
-};
-```
+// Get model information
+const models = catalog.anthropic.models;
 
-Run it:
-```bash
-bun run server.ts
+// Validate provider/model combination
+const result = validateProviderModel('anthropic', 'claude-3-5-sonnet-20241022');
 ```
 
-Your agent is now available at `http://localhost:3000` with:
-- `POST /ask` - Ask questions
-- `GET /sessions` - List sessions
-- `GET /openapi.json` - OpenAPI spec
-- And more...
-
----
+### Authentication (from `@agi-cli/auth`)
 
-## Complete Examples
-
-### Example 1: Code Review Bot
+Manage API keys and OAuth:
 
 ```typescript
-import { generateText, resolveModel, discoverProjectTools } from '@agi-cli/sdk';
-
-async function reviewFile(filePath: string) {
-  const model = await resolveModel('anthropic', 'claude-sonnet-4');
-  const tools = await discoverProjectTools(process.cwd());
-  
-  const result = await generateText({
-    model,
-    prompt: `Review ${filePath} for code quality, security, and best practices. Provide specific suggestions.`,
-    tools: Object.fromEntries(tools.map(t => [t.name, t.tool])),
-    maxSteps: 10
-  });
-  
-  return result.text;
-}
-
-// Usage
-const review = await reviewFile('src/auth.ts');
-console.log(review);
-```
+import { 
+  getAuth, 
+  setAuth, 
+  removeAuth, 
+  getAllAuth,
+  authorize,
+  createApiKey 
+} from '@agi-cli/sdk';
 
-### Example 2: Interactive Agent
+// Set API key
+await setAuth('openai', { apiKey: 'sk-...' });
 
-```typescript
-import { generateText, resolveModel, discoverProjectTools } from '@agi-cli/sdk';
-
-async function interactiveAgent() {
-  const model = await resolveModel('openai', 'gpt-4o');
-  const tools = await discoverProjectTools(process.cwd());
-  const toolMap = Object.fromEntries(tools.map(t => [t.name, t.tool]));
-  
-  const messages = [];
-  
-  while (true) {
-    const userInput = prompt('You: ');
-    if (userInput === 'exit') break;
-    
-    messages.push({ role: 'user', content: userInput });
-    
-    const result = await generateText({
-      model,
-      messages,
-      tools: toolMap,
-      maxSteps: 15
-    });
-    
-    console.log('Agent:', result.text);
-    messages.push({ role: 'assistant', content: result.text });
-  }
-}
+// Get auth info
+const auth = await getAuth('openai');
 
-interactiveAgent();
+// OAuth flow
+const url = await authorize('anthropic');
+console.log(`Visit: ${url}`);
 ```
 
-### Example 3: Streaming Responses
-
-```typescript
-import { streamText, resolveModel, discoverProjectTools } from '@agi-cli/sdk';
-
-async function streamingAgent(prompt: string) {
-  const model = await resolveModel('google', 'gemini-1.5-pro');
-  const tools = await discoverProjectTools(process.cwd());
-  
-  const stream = streamText({
-    model,
-    prompt,
-    tools: Object.fromEntries(tools.map(t => [t.name, t.tool])),
-    maxSteps: 10
-  });
-  
-  // Stream to console
-  for await (const chunk of stream.textStream) {
-    process.stdout.write(chunk);
-  }
-}
-
-streamingAgent('Refactor the authentication module for better security');
-```
+### Configuration (from `@agi-cli/config`)
 
-### Example 4: Custom Tool
+Load and manage configuration:
 
 ```typescript
-import { generateText, resolveModel, discoverProjectTools, tool, z } from '@agi-cli/sdk';
-
-// Define custom tool
-const weatherTool = tool({
-  description: 'Get weather for a city',
-  parameters: z.object({
-    city: z.string(),
-    units: z.enum(['celsius', 'fahrenheit']).default('celsius')
-  }),
-  execute: async ({ city, units }) => {
-    const data = await fetch(`https://api.weather.com/${city}`).then(r => r.json());
-    return { temperature: data.temp, city, units };
-  }
-});
-
-// Use with agent
-const model = await resolveModel('anthropic', 'claude-sonnet-4');
-const builtinTools = await discoverProjectTools(process.cwd());
-
-const result = await generateText({
-  model,
-  prompt: 'What\'s the weather in Tokyo and New York?',
-  tools: {
-    ...Object.fromEntries(builtinTools.map(t => [t.name, t.tool])),
-    weather: weatherTool
-  },
-  maxSteps: 5
-});
+import { loadConfig, readConfig } from '@agi-cli/sdk';
+import type { AGIConfig } from '@agi-cli/sdk';
 
-console.log(result.text);
+const config = await loadConfig();
+console.log(config.provider); // 'anthropic'
+console.log(config.model);    // 'claude-3-5-sonnet-20241022'
 ```
 
-### Example 5: HTTP API Server
+### Prompts (from `@agi-cli/prompts`)
 
-```typescript
-import { createServer, generateText, resolveModel, discoverProjectTools } from '@agi-cli/sdk';
+Pre-built system prompts:
 
-const app = createServer();
+```typescript
+import { systemPrompt, codeContext } from '@agi-cli/sdk';
 
-// Add custom route
-app.post('/custom-ask', async (c) => {
-  const { prompt } = await c.req.json();
-  
-  const model = await resolveModel('anthropic', 'claude-sonnet-4');
-  const tools = await discoverProjectTools(process.cwd());
-  
-  const result = await generateText({
-    model,
-    prompt,
-    tools: Object.fromEntries(tools.map(t => [t.name, t.tool])),
-    maxSteps: 10
-  });
-  
-  return c.json({ response: result.text });
+const prompt = systemPrompt('dev', {
+  workdir: '/home/user/project',
+  platform: 'linux',
 });
 
-export default {
-  port: 3000,
-  fetch: app.fetch
-};
+const context = codeContext({ includeGitInfo: true });
 ```
 
----
-
-## Built-in Tools (15+)
-
-Your agent has access to these tools automatically:
-
-### File Operations
-- `read` - Read file contents
-- `write` - Write to files
-- `edit` - Edit files with diff-based changes
-- `ls` - List directory contents
-- `cd` - Change directory
-- `pwd` - Print working directory
-- `tree` - Show directory tree
+### Core AI Functions (from `@agi-cli/core`)
 
-### Search & Find
-- `glob` - Find files by pattern (e.g., `*.ts`)
-- `grep` - Search file contents
-- `ripgrep` - Fast content search (if installed)
-
-### Git Operations
-- `git_status` - Show git status
-- `git_diff` - Show git diff
-- `git_commit` - Create commit
-- `git_log` - Show git log
-
-### Execution
-- `bash` - Run shell commands
-
-### Planning
-- `update_plan` - Update task plan
-- `progress_update` - Report progress
-- `finish` - Mark task complete
-
----
-
-## Supported Providers
-
-Switch providers without changing code:
+AI SDK re-exports and utilities:
 
 ```typescript
-// OpenAI
-const model = await resolveModel('openai', 'gpt-4o-mini');
-
-// Anthropic
-const model = await resolveModel('anthropic', 'claude-sonnet-4');
-
-// Google
-const model = await resolveModel('google', 'gemini-1.5-pro');
-
-// OpenRouter (100+ models)
-const model = await resolveModel('openrouter', 'anthropic/claude-3.5-sonnet');
-
-// OpenCode (specialized code models)
-const model = await resolveModel('opencode', 'qwen3-coder-14b');
-```
-
-Set API keys via environment variables:
-```bash
-export OPENAI_API_KEY=sk-...
-export ANTHROPIC_API_KEY=sk-ant-...
-export GOOGLE_GENERATIVE_AI_API_KEY=...
-```
+import { 
+  generateText, 
+  streamText, 
+  generateObject, 
+  streamObject,
+  tool,
+  resolveModel,
+  discoverProjectTools,
+  buildFsTools,
+  buildGitTools,
+  createFileDiffArtifact,
+  z
+} from '@agi-cli/sdk';
+import type { CoreMessage, Tool, DiscoveredTool } from '@agi-cli/sdk';
 
-Or pass directly:
-```typescript
-const model = await resolveModel('openai', 'gpt-4o', {
-  apiKey: 'sk-...'
+// Generate text
+const { text } = await generateText({
+  model: resolveModel('anthropic'),
+  prompt: 'Hello!',
 });
-```
-
----
-
-## Configuration
-
-The SDK integrates with AGI's configuration system:
 
-```typescript
-import { loadConfig, readConfig } from '@agi-cli/sdk';
-
-// Load config from .agi/config.json
-const config = await loadConfig(process.cwd());
-
-console.log(config.defaults);
-// { agent: 'general', provider: 'anthropic', model: 'claude-sonnet-4' }
+// Stream text with tools
+const { textStream } = streamText({
+  model: resolveModel('openai'),
+  prompt: 'What files are in the current directory?',
+  tools: buildFsTools(),
+});
 
-// Use configured defaults
-const model = await resolveModel(
-  config.defaults.provider,
-  config.defaults.model
-);
-```
+// Generate structured output
+const { object } = await generateObject({
+  model: resolveModel('anthropic'),
+  schema: z.object({
+    name: z.string(),
+    age: z.number(),
+  }),
+  prompt: 'Generate a person',
+});
 
----
-
-## Custom Tools (Plugins)
-
-Create reusable tools in `.agi/tools/{name}/tool.js`:
-
-```javascript
-// .agi/tools/database/tool.js
-export default {
-  name: 'query_database',
-  description: 'Query the database',
-  parameters: {
-    query: {
-      type: 'string',
-      description: 'SQL query to execute'
-    }
-  },
-  async execute({ input, exec, fs }) {
-    const result = await exec('sqlite3', ['db.sqlite', input.query]);
-    return {
-      success: true,
-      data: result.stdout
-    };
-  }
-};
+// Discover project tools
+const tools = await discoverProjectTools('/path/to/project');
 ```
 
-Tools are auto-discovered by `discoverProjectTools()`.
+### Database (from `@agi-cli/database`)
 
-**Available helpers in `execute()`:**
-- `input` - Tool parameters
-- `exec(cmd, args)` - Run shell commands
-- `fs.readFile(path)` - Read files
-- `fs.writeFile(path, content)` - Write files
-- `fs.exists(path)` - Check file exists
-- `project` / `projectRoot` / `directory` - Path info
-- `env` - Environment variables
-
----
-
-## Database & Sessions
-
-Store conversation history:
+Database access:
 
 ```typescript
 import { getDb, dbSchema } from '@agi-cli/sdk';
 
-const db = await getDb(process.cwd());
-
-// Query sessions
-const sessions = await db.select().from(dbSchema.sessions).limit(10);
-
-// Query messages
-const messages = await db
-  .select()
-  .from(dbSchema.messages)
-  .where(eq(dbSchema.messages.sessionId, sessionId));
+const db = getDb();
+const messages = await db.select().from(dbSchema.messages);
 ```
 
----
+### Server (from `@agi-cli/server`)
 
-## Authentication
-
-Manage provider credentials:
+Create an HTTP server:
 
 ```typescript
-import { getAllAuth, setAuth, getAuth } from '@agi-cli/sdk';
-
-// Get all stored credentials
-const auth = await getAllAuth();
-
-// Set API key
-await setAuth('openai', {
-  type: 'api',
-  key: 'sk-...'
-});
+import { createServer } from '@agi-cli/sdk';
 
-// Get provider auth
-const openaiAuth = await getAuth('openai');
+const app = createServer();
 ```
 
----
-
-## What Can You Build?
-
-1. **AI-Powered CLIs** - Interactive command-line tools
-2. **Code Assistants** - Review, refactor, document code
-3. **Project Automation** - Smart build tools, deployment scripts
-4. **Development Bots** - Slack/Discord bots for codebases
-5. **Custom Agents** - Task-specific AI agents
-6. **IDE Extensions** - AI features for editors
-7. **API Services** - HTTP APIs with AI + tools
-8. **Desktop Apps** - Electron/Tauri apps with AI
-9. **Documentation Generators** - Auto-generate docs
-10. **Testing Tools** - AI-powered test generation
-
----
-
-## API Reference
-
-### Core Functions
-
-#### `generateText(options)`
-Generate text with optional tools.
-
-```typescript
-const result = await generateText({
-  model,              // Model from resolveModel()
-  prompt: string,     // Or use 'messages' for multi-turn
-  tools?: object,     // Optional tools
-  maxSteps?: number,  // Max tool calls (default: 1)
-  temperature?: number,
-  maxTokens?: number
-});
-```
+### Error Handling (from `@agi-cli/core`)
 
-#### `streamText(options)`
-Stream text generation.
+Typed error classes:
 
 ```typescript
-const stream = streamText({
-  model,
-  prompt: string,
-  tools?: object,
-  maxSteps?: number
-});
+import { 
+  AGIError, 
+  AuthError, 
+  ConfigError, 
+  ToolError,
+  ProviderError,
+  DatabaseError,
+  ValidationError,
+  NotFoundError,
+  ServiceError
+} from '@agi-cli/sdk';
 
-for await (const chunk of stream.textStream) {
-  console.log(chunk);
+try {
+  // ... your code
+} catch (error) {
+  if (error instanceof AuthError) {
+    console.error('Authentication failed:', error.message);
+  }
 }
 ```
 
-#### `generateObject(options)`
-Generate structured JSON.
+## Tree-Shaking
+
+The SDK is fully tree-shakable. Modern bundlers (Vite, Rollup, esbuild, webpack) will only include the code you actually use:
 
 ```typescript
-const result = await generateObject({
-  model,
-  schema: z.object({ ... }),
-  prompt: string
-});
+// Only includes generateText and resolveModel code
+import { generateText, resolveModel } from '@agi-cli/sdk';
 ```
 
-#### `streamObject(options)`
-Stream structured JSON generation.
+## Direct Package Access (Not Recommended)
 
----
-
-### Provider Functions
-
-#### `resolveModel(provider, model, config?)`
-Get model instance.
+While you _can_ import directly from individual packages, we recommend using the SDK for consistency:
 
 ```typescript
-const model = await resolveModel(
-  'anthropic',          // Provider
-  'claude-sonnet-4',   // Model ID
-  { apiKey: '...' }    // Optional config
-);
+// ❌ Discouraged - fragmented imports
+import { catalog } from '@agi-cli/providers';
+import { generateText } from '@agi-cli/core';
+import type { ProviderId } from '@agi-cli/types';
+
+// ✅ Recommended - single source of truth
+import { catalog, generateText } from '@agi-cli/sdk';
+import type { ProviderId } from '@agi-cli/sdk';
 ```
 
-#### `catalog`
-Provider/model catalog.
+## Architecture
 
-```typescript
-import { catalog } from '@agi-cli/sdk';
+The SDK follows a clean dependency graph with zero circular dependencies:
 
-// List all providers
-console.log(Object.keys(catalog));
-// ['openai', 'anthropic', 'google', ...]
-
-// List OpenAI models
-console.log(catalog.openai.models.map(m => m.id));
+```
+@agi-cli/types (foundation)
+    ↓
+@agi-cli/providers, @agi-cli/auth, @agi-cli/config
+    ↓
+@agi-cli/database, @agi-cli/prompts
+    ↓
+@agi-cli/core
+    ↓
+@agi-cli/server
+    ↓
+@agi-cli/sdk ← YOU ARE HERE (single source of truth)
 ```
 
----
-
-### Tool Functions
+## Examples
 
-#### `discoverProjectTools(projectRoot, globalConfigDir?)`
-Discover all available tools.
+### Basic Agent
 
 ```typescript
-const tools = await discoverProjectTools(process.cwd());
-
-// Convert to object for generateText()
-const toolMap = Object.fromEntries(
-  tools.map(t => [t.name, t.tool])
-);
-```
-
-#### `tool(definition)`
-Create custom tool.
+import { generateText, resolveModel } from '@agi-cli/sdk';
 
-```typescript
-import { tool, z } from '@agi-cli/sdk';
+const model = resolveModel('anthropic');
 
-const myTool = tool({
-  description: 'Tool description',
-  parameters: z.object({ ... }),
-  execute: async (params) => { ... }
+const { text } = await generateText({
+  model,
+  prompt: 'Explain TypeScript generics',
 });
-```
 
----
-
-### Server Functions
+console.log(text);
+```
 
-#### `createServer()`
-Create HTTP server.
+### Agent with Tools
 
 ```typescript
-const app = createServer();
-
-// The server includes:
-// - POST /ask - Ask questions
-// - GET /sessions - List sessions
-// - GET /sessions/:id/messages - Get messages
-// - GET /openapi.json - OpenAPI spec
-```
+import { streamText, resolveModel, buildFsTools, buildGitTools } from '@agi-cli/sdk';
 
----
-
-### Configuration Functions
+const tools = {
+  ...buildFsTools(),
+  ...buildGitTools(),
+};
 
-#### `loadConfig(projectRoot?)`
-Load AGI configuration.
+const { textStream } = streamText({
+  model: resolveModel('openai'),
+  prompt: 'What Git branch am I on? List the files in the current directory.',
+  tools,
+});
 
-```typescript
-const config = await loadConfig(process.cwd());
-// Returns: { defaults, providers, paths }
+for await (const chunk of textStream) {
+  process.stdout.write(chunk);
+}
 ```
 
-#### `readConfig(projectRoot?)`
-Load config + auth.
+### Structured Output
 
 ```typescript
-const { cfg, auth } = await readConfig(process.cwd());
-```
+import { generateObject, resolveModel, z } from '@agi-cli/sdk';
+
+const schema = z.object({
+  sentiment: z.enum(['positive', 'negative', 'neutral']),
+  confidence: z.number().min(0).max(1),
+  keywords: z.array(z.string()),
+});
 
----
+const { object } = await generateObject({
+  model: resolveModel('anthropic'),
+  schema,
+  prompt: 'Analyze: "This SDK is amazing!"',
+});
 
-### Database Functions
+console.log(object);
+// { sentiment: 'positive', confidence: 0.95, keywords: ['amazing', 'SDK'] }
+```
 
-#### `getDb(projectRoot?)`
-Get database instance.
+### With Configuration
 
 ```typescript
-const db = await getDb(process.cwd());
+import { generateText, resolveModel, loadConfig } from '@agi-cli/sdk';
 
-// Use with Drizzle ORM
-import { dbSchema } from '@agi-cli/sdk';
-const sessions = await db.select().from(dbSchema.sessions);
-```
+const config = await loadConfig();
+const model = resolveModel(config.provider, config.model);
 
----
+const { text } = await generateText({
+  model,
+  prompt: 'Hello from AGI CLI!',
+  temperature: config.temperature,
+});
+```
 
-## Types
+## TypeScript
 
-All types are exported:
+Full TypeScript support with comprehensive types:
 
 ```typescript
-import type {
-  // AI SDK types
+import type { 
+  ProviderId, 
+  ModelInfo, 
+  AGIConfig,
   CoreMessage,
   Tool,
-  
-  // Provider types
-  ProviderName,
-  ProviderId,
-  ModelInfo,
-  ModelConfig,
-  
-  // Tool types
   DiscoveredTool,
-  
-  // Config types
-  AGIConfig,
-  ProviderConfig,
-  Scope,
-  
-  // Auth types
-  AuthInfo,
-  OAuth,
-  
-  // Other types
-  ExecutionContext,
-  ToolResult,
   Artifact,
-  FileDiffArtifact
+  ExecutionContext
 } from '@agi-cli/sdk';
-```
-
----
-
-## Environment Variables
 
-```bash
-# Provider API Keys
-OPENAI_API_KEY=sk-...
-ANTHROPIC_API_KEY=sk-ant-...
-GOOGLE_GENERATIVE_AI_API_KEY=...
-OPENROUTER_API_KEY=...
-OPENCODE_API_KEY=...
-
-# Optional
-AGI_DEBUG_TOOLS=1  # Debug tool loading
+// All types are fully documented and type-safe
+const providerId: ProviderId = 'anthropic';
+const config: AGIConfig = await loadConfig();
 ```
 
----
-
-## Why Use This SDK?
-
-### ✅ **Batteries Included**
-Everything you need in one package. No need to install `ai`, provider packages, or anything else.
-
-### ✅ **Zero Configuration**
-Works out of the box. Add config only if you need it.
-
-### ✅ **15+ Built-in Tools**
-File operations, Git, search, bash - ready to use.
-
-### ✅ **Multi-Provider**
-Switch between OpenAI, Anthropic, Google without code changes.
-
-### ✅ **HTTP Server Included**
-Create API endpoints in seconds.
-
-### ✅ **Extensible**
-Add custom tools easily with the plugin system.
-
-### ✅ **Type-Safe**
-Full TypeScript support with exported types.
-
----
-
 ## License
 
-MIT - see [LICENSE](../../LICENSE)
-
----
+MIT
 
-## Links
+## Contributing
 
-- [GitHub](https://github.com/ntishxyz/agi)
-- [Documentation](https://github.com/ntishxyz/agi#readme)
-- [Architecture](https://github.com/ntishxyz/agi/blob/main/ARCHITECTURE.md)
-- [Issues](https://github.com/ntishxyz/agi/issues)
+See the main repository for contribution guidelines.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@agi-cli/sdk",
-	"version": "0.1.50",
-	"description": "AI agent SDK for building intelligent assistants",
+	"version": "0.1.51",
+	"description": "AI agent SDK for building intelligent assistants - tree-shakable and comprehensive",
 	"author": "ntishxyz",
 	"license": "MIT",
 	"homepage": "https://github.com/ntishxyz/agi#readme",
@@ -48,6 +48,7 @@
 		"@agi-cli/providers": "0.1.0",
 		"@agi-cli/prompts": "0.1.0",
 		"@agi-cli/server": "0.1.0",
+		"@agi-cli/types": "0.1.0",
 		"ai": "^5.0.43",
 		"@ai-sdk/anthropic": "^2.0.16",
 		"@ai-sdk/openai": "^2.0.30",
@@ -70,6 +71,8 @@
 		"anthropic",
 		"openai",
 		"development",
-		"assistant"
+		"assistant",
+		"tree-shakable",
+		"typescript"
 	]
 }

package/src/index.ts

@@ -1,27 +1,56 @@
-// =======================
-// Re-export everything from @agi-cli/core
-// =======================
-export * from '@agi-cli/core';
+// ============================================================================
+// @agi-cli/sdk - Tree-shakable AI Agent SDK
+// ============================================================================
+// This is the SINGLE source of truth for all AGI CLI functionality.
+// All exports are tree-shakable - bundlers will only include what you use.
+//
+// Usage:
+//   import { generateText, resolveModel } from '@agi-cli/sdk';
+//   import type { ProviderId, AGIConfig } from '@agi-cli/sdk';
+//
+// Note: Direct package imports are still available but discouraged:
+//   import { catalog } from '@agi-cli/providers'; // ❌ Discouraged
+//   import { catalog } from '@agi-cli/sdk';       // ✅ Recommended
+// ============================================================================
 
 // =======================
-// Server (batteries included)
+// Types (from @agi-cli/types)
 // =======================
-export { createApp as createServer } from '@agi-cli/server';
+// Provider types
+export type { ProviderId, ModelInfo } from '@agi-cli/types';
 
-// =======================
-// Database (convenience re-export)
-// =======================
-export { getDb } from '@agi-cli/database';
-export * as dbSchema from '@agi-cli/database/schema';
+// Auth types
+export type { ApiAuth, OAuth, AuthInfo, AuthFile } from '@agi-cli/types';
+
+// Config types
+export type {
+	Scope,
+	ProviderConfig,
+	DefaultConfig,
+	PathConfig,
+	AGIConfig,
+} from '@agi-cli/types';
 
 // =======================
-// Configuration (convenience re-export)
+// Providers (from @agi-cli/providers)
 // =======================
-export { loadConfig, read as readConfig } from '@agi-cli/config';
-export type { AGIConfig, ProviderConfig, Scope } from '@agi-cli/config';
+export { catalog } from '@agi-cli/providers';
+export {
+	isProviderId,
+	providerIds,
+	defaultModelFor,
+	hasModel,
+} from '@agi-cli/providers';
+export {
+	isProviderAuthorized,
+	ensureProviderEnv,
+} from '@agi-cli/providers';
+export { validateProviderModel } from '@agi-cli/providers';
+export { estimateModelCostUsd } from '@agi-cli/providers';
+export { providerEnvVar, readEnvKey, setEnvKey } from '@agi-cli/providers';
 
 // =======================
-// Authentication (convenience re-export)
+// Authentication (from @agi-cli/auth)
 // =======================
 export {
 	getAllAuth,
@@ -34,9 +63,82 @@ export {
 	openAuthUrl,
 	createApiKey,
 } from '@agi-cli/auth';
-export type { AuthInfo, OAuth } from '@agi-cli/auth';
 
 // =======================
-// Agent Types (from SDK-specific modules)
+// Configuration (from @agi-cli/config)
+// =======================
+export { loadConfig, read as readConfig } from '@agi-cli/config';
+
+// =======================
+// Prompts (from @agi-cli/prompts)
+// =======================
+export { providerBasePrompt } from '@agi-cli/prompts';
+
+// =======================
+// Database (from @agi-cli/database)
+// =======================
+export { getDb } from '@agi-cli/database';
+export * as dbSchema from '@agi-cli/database/schema';
+
+// =======================
+// Core AI Functions (from @agi-cli/core)
+// =======================
+// AI SDK re-exports
+export {
+	generateText,
+	streamText,
+	generateObject,
+	streamObject,
+	tool,
+} from '@agi-cli/core';
+export type { CoreMessage, Tool } from '@agi-cli/core';
+
+// Provider & Model Resolution
+export { resolveModel } from '@agi-cli/core';
+export type { ProviderName, ModelConfig } from '@agi-cli/core';
+
+// Tools
+export { discoverProjectTools } from '@agi-cli/core';
+export type { DiscoveredTool } from '@agi-cli/core';
+export { buildFsTools } from '@agi-cli/core';
+export { buildGitTools } from '@agi-cli/core';
+
+// Streaming & Artifacts
+export {
+	createFileDiffArtifact,
+	createToolResultPayload,
+} from '@agi-cli/core';
+export type {
+	Artifact,
+	FileDiffArtifact,
+	FileArtifact,
+} from '@agi-cli/core';
+
+// Core Types
+export type { ExecutionContext, ToolResult } from '@agi-cli/core';
+
+// Error Handling
+export {
+	AGIError,
+	AuthError,
+	ConfigError,
+	ToolError,
+	ProviderError,
+	DatabaseError,
+	ValidationError,
+	NotFoundError,
+	ServiceError,
+} from '@agi-cli/core';
+
+// Schema Validation
+export { z } from '@agi-cli/core';
+
+// =======================
+// Server (from @agi-cli/server)
+// =======================
+export { createApp as createServer } from '@agi-cli/server';
+
+// =======================
+// SDK-specific Agent Types
 // =======================
 export type { AgentConfig, AgentConfigEntry } from './agent/types.ts';