@agi-cli/sdk 0.1.49 → 0.1.51

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@agi-cli/sdk",
-	"version": "0.1.49",
-	"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",
@@ -22,12 +22,12 @@
 			"types": "./src/index.ts"
 		},
 		"./tools/builtin/fs": {
-			"import": "./src/tools/builtin/fs/index.ts",
-			"types": "./src/tools/builtin/fs/index.ts"
+			"import": "@agi-cli/core/tools/builtin/fs",
+			"types": "@agi-cli/core/tools/builtin/fs"
 		},
 		"./tools/builtin/git": {
-			"import": "./src/tools/builtin/git.ts",
-			"types": "./src/tools/builtin/git.ts"
+			"import": "@agi-cli/core/tools/builtin/git",
+			"types": "@agi-cli/core/tools/builtin/git"
 		}
 	},
 	"files": [
@@ -43,10 +43,12 @@
 	"dependencies": {
 		"@agi-cli/auth": "0.1.0",
 		"@agi-cli/config": "0.1.0",
+		"@agi-cli/core": "0.1.0",
 		"@agi-cli/database": "0.1.0",
 		"@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",
@@ -69,6 +71,8 @@
 		"anthropic",
 		"openai",
 		"development",
-		"assistant"
+		"assistant",
+		"tree-shakable",
+		"typescript"
 	]
 }

package/src/agent/types.ts

@@ -1,4 +1,4 @@
-import type { ProviderName } from '../providers/resolver.ts';
+import type { ProviderName } from '@agi-cli/core';
 
 export type AgentConfig = {
 	name: string;

package/src/index.ts

@@ -1,67 +1,56 @@
-// =======================
-// Core AI Functions
-// =======================
-export {
-	generateText,
-	streamText,
-	generateObject,
-	streamObject,
-	tool,
-} from 'ai';
-export type { CoreMessage, Tool } from 'ai';
-
-// =======================
-// Provider & Model Resolution
-// =======================
-export { resolveModel } from './providers/resolver.ts';
-export type { ProviderName, ModelConfig } from './providers/resolver.ts';
-
-// Re-export provider catalog and utilities for easy access
-export {
-	catalog,
-	providerIds,
-	isProviderId,
-	isProviderAuthorized,
-	validateProviderModel,
-} from '@agi-cli/providers';
-export type { ProviderId, ModelInfo } from '@agi-cli/providers';
+// ============================================================================
+// @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
+// ============================================================================
 
 // =======================
-// Tools
+// Types (from @agi-cli/types)
 // =======================
-export { discoverProjectTools } from './tools/loader.ts';
-export type { DiscoveredTool } from './tools/loader.ts';
+// Provider types
+export type { ProviderId, ModelInfo } from '@agi-cli/types';
 
-// Re-export for testing/advanced usage
-export { buildFsTools } from './tools/builtin/fs/index.ts';
-export { buildGitTools } from './tools/builtin/git.ts';
+// Auth types
+export type { ApiAuth, OAuth, AuthInfo, AuthFile } from '@agi-cli/types';
 
-// =======================
-// Streaming & Artifacts
-// =======================
-export {
-	createFileDiffArtifact,
-	createToolResultPayload,
-} from './streaming/artifacts.ts';
+// Config types
 export type {
-	Artifact,
-	FileDiffArtifact,
-	FileArtifact,
-} from './streaming/artifacts.ts';
-
-// =======================
-// Server
-// =======================
-export { createApp as createServer } from '@agi-cli/server';
+	Scope,
+	ProviderConfig,
+	DefaultConfig,
+	PathConfig,
+	AGIConfig,
+} from '@agi-cli/types';
 
 // =======================
-// Configuration
+// 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
+// Authentication (from @agi-cli/auth)
 // =======================
 export {
 	getAllAuth,
@@ -74,28 +63,61 @@ export {
 	openAuthUrl,
 	createApiKey,
 } from '@agi-cli/auth';
-export type { AuthInfo, OAuth } from '@agi-cli/auth';
 
 // =======================
-// Database
+// Configuration (from @agi-cli/config)
 // =======================
-export { getDb } from '@agi-cli/database';
-export * as dbSchema from '@agi-cli/database/schema';
+export { loadConfig, read as readConfig } from '@agi-cli/config';
 
 // =======================
-// Types
+// Prompts (from @agi-cli/prompts)
 // =======================
-export type { ExecutionContext, ToolResult } from './types/index.ts';
-export type { AgentConfig, AgentConfigEntry } from './agent/types.ts';
+export { providerBasePrompt } from '@agi-cli/prompts';
 
 // =======================
-// Schema Validation
+// Database (from @agi-cli/database)
 // =======================
-export { z } from 'zod';
+export { getDb } from '@agi-cli/database';
+export * as dbSchema from '@agi-cli/database/schema';
 
 // =======================
-// Error Handling
+// 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,
@@ -106,4 +128,17 @@ export {
 	ValidationError,
 	NotFoundError,
 	ServiceError,
-} from './errors.ts';
+} 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';

package/src/errors.ts

@@ -1,102 +0,0 @@
-/**
- * Base error class for all AGI errors
- */
-export class AGIError extends Error {
-	constructor(
-		message: string,
-		public readonly code: string,
-		public readonly status: number = 500,
-		public readonly details?: Record<string, unknown>,
-	) {
-		super(message);
-		this.name = this.constructor.name;
-		Error.captureStackTrace(this, this.constructor);
-	}
-
-	toJSON() {
-		return {
-			name: this.name,
-			message: this.message,
-			code: this.code,
-			status: this.status,
-			details: this.details,
-		};
-	}
-}
-
-/**
- * Authentication and authorization errors
- */
-export class AuthError extends AGIError {
-	constructor(message: string, details?: Record<string, unknown>) {
-		super(message, 'AUTH_ERROR', 401, details);
-	}
-}
-
-/**
- * Configuration errors
- */
-export class ConfigError extends AGIError {
-	constructor(message: string, details?: Record<string, unknown>) {
-		super(message, 'CONFIG_ERROR', 500, details);
-	}
-}
-
-/**
- * Tool execution errors
- */
-export class ToolError extends AGIError {
-	constructor(message: string, details?: Record<string, unknown>) {
-		super(message, 'TOOL_ERROR', 500, details);
-	}
-}
-
-/**
- * Provider errors (API, model not found, etc.)
- */
-export class ProviderError extends AGIError {
-	constructor(message: string, details?: Record<string, unknown>) {
-		super(message, 'PROVIDER_ERROR', 500, details);
-	}
-}
-
-/**
- * Database errors
- */
-export class DatabaseError extends AGIError {
-	constructor(message: string, details?: Record<string, unknown>) {
-		super(message, 'DATABASE_ERROR', 500, details);
-	}
-}
-
-/**
- * Validation errors (bad input, schema mismatch, etc.)
- */
-export class ValidationError extends AGIError {
-	constructor(message: string, details?: Record<string, unknown>) {
-		super(message, 'VALIDATION_ERROR', 400, details);
-	}
-}
-
-/**
- * Not found errors (session, agent, tool, etc.)
- */
-export class NotFoundError extends AGIError {
-	constructor(message: string, details?: Record<string, unknown>) {
-		super(message, 'NOT_FOUND', 404, details);
-	}
-}
-
-/**
- * Service errors from ask-service, session-manager, etc.
- */
-export class ServiceError extends AGIError {
-	constructor(
-		message: string,
-		code = 'SERVICE_ERROR',
-		status = 500,
-		details?: Record<string, unknown>,
-	) {
-		super(message, code, status, details);
-	}
-}

package/src/providers/resolver.ts

@@ -1,84 +0,0 @@
-import { openai, createOpenAI } from '@ai-sdk/openai';
-import { anthropic, createAnthropic } from '@ai-sdk/anthropic';
-import { google } from '@ai-sdk/google';
-import { createOpenRouter } from '@openrouter/ai-sdk-provider';
-import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
-
-export type ProviderName =
-	| 'openai'
-	| 'anthropic'
-	| 'google'
-	| 'openrouter'
-	| 'opencode';
-
-export type ModelConfig = {
-	apiKey?: string;
-	customFetch?: typeof fetch;
-	baseURL?: string;
-};
-
-export async function resolveModel(
-	provider: ProviderName,
-	model: string,
-	config: ModelConfig = {},
-) {
-	if (provider === 'openai') {
-		if (config.apiKey) {
-			const instance = createOpenAI({ apiKey: config.apiKey });
-			return instance(model);
-		}
-		return openai(model);
-	}
-
-	if (provider === 'anthropic') {
-		if (config.customFetch) {
-			return createAnthropic({
-				apiKey: config.apiKey || '',
-				fetch: config.customFetch as typeof fetch,
-			});
-		}
-		if (config.apiKey) {
-			const instance = createAnthropic({ apiKey: config.apiKey });
-			return instance(model);
-		}
-		return anthropic(model);
-	}
-
-	if (provider === 'google') {
-		if (config.apiKey) {
-			throw new Error('Google provider config not yet supported in SDK');
-		}
-		return google(model);
-	}
-
-	if (provider === 'openrouter') {
-		const apiKey = config.apiKey || process.env.OPENROUTER_API_KEY || '';
-		const openrouter = createOpenRouter({ apiKey });
-		return openrouter.chat(model);
-	}
-
-	if (provider === 'opencode') {
-		const baseURL = config.baseURL || 'https://opencode.ai/zen/v1';
-		const apiKey = config.apiKey || process.env.OPENCODE_API_KEY || '';
-
-		const ocOpenAI = createOpenAI({ apiKey, baseURL });
-		const ocAnthropic = createAnthropic({ apiKey, baseURL });
-		const ocCompat = createOpenAICompatible({
-			name: 'opencode',
-			baseURL,
-			headers: apiKey ? { Authorization: `Bearer ${apiKey}` } : undefined,
-		});
-
-		const id = model.toLowerCase();
-		if (id.includes('claude')) return ocAnthropic(model);
-		if (
-			id.includes('qwen3-coder') ||
-			id.includes('grok-code') ||
-			id.includes('kimi-k2')
-		)
-			return ocCompat(model);
-		return ocOpenAI(model);
-	}
-
-	throw new Error(`Unsupported provider: ${provider}`);
-}

package/src/streaming/artifacts.ts

@@ -1,41 +0,0 @@
-// Shared types and helpers for tool artifacts persisted in message parts.
-
-export type FileDiffArtifact = {
-	kind: 'file_diff';
-	patchFormat: 'unified';
-	patch: string; // full unified patch text
-	summary?: { files?: number; additions?: number; deletions?: number };
-};
-
-export type FileArtifact = {
-	kind: 'file';
-	path: string; // repository-relative path
-	mime?: string;
-	size?: number;
-	sha256?: string;
-};
-
-export type Artifact =
-	| FileDiffArtifact
-	| FileArtifact
-	| { kind: string; [k: string]: unknown };
-
-export function createFileDiffArtifact(
-	patch: string,
-	summary?: { files?: number; additions?: number; deletions?: number },
-): FileDiffArtifact {
-	return { kind: 'file_diff', patchFormat: 'unified', patch, summary };
-}
-
-export function createToolResultPayload(
-	name: string,
-	result?: unknown,
-	artifact?: Artifact,
-) {
-	const payload: { name: string; result?: unknown; artifact?: Artifact } = {
-		name,
-	};
-	if (result !== undefined) payload.result = result;
-	if (artifact) payload.artifact = artifact;
-	return payload;
-}

package/src/tools/builtin/bash.ts

@@ -1,73 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod';
-import { spawn } from 'bun';
-import DESCRIPTION from './bash.txt' with { type: 'text' };
-
-function normalizePath(p: string) {
-	const parts = p.replace(/\\/g, '/').split('/');
-	const stack: string[] = [];
-	for (const part of parts) {
-		if (!part || part === '.') continue;
-		if (part === '..') stack.pop();
-		else stack.push(part);
-	}
-	return `/${stack.join('/')}`;
-}
-
-function resolveSafePath(projectRoot: string, p: string) {
-	const root = normalizePath(projectRoot);
-	const abs = normalizePath(`${root}/${p || '.'}`);
-	if (!(abs === root || abs.startsWith(`${root}/`))) {
-		throw new Error(`cwd escapes project root: ${p}`);
-	}
-	return abs;
-}
-
-export function buildBashTool(projectRoot: string): {
-	name: string;
-	tool: Tool;
-} {
-	const bash = tool({
-		description: DESCRIPTION,
-		inputSchema: z
-			.object({
-				cmd: z.string().describe('Shell command to run (bash -lc <cmd>)'),
-				cwd: z
-					.string()
-					.default('.')
-					.describe('Working directory relative to project root'),
-				allowNonZeroExit: z
-					.boolean()
-					.optional()
-					.default(false)
-					.describe('If true, do not throw on non-zero exit'),
-			})
-			.strict(),
-		async execute({
-			cmd,
-			cwd,
-			allowNonZeroExit,
-		}: {
-			cmd: string;
-			cwd?: string;
-			allowNonZeroExit?: boolean;
-		}) {
-			const absCwd = resolveSafePath(projectRoot, cwd || '.');
-			const proc = spawn({
-				cmd: ['bash', '-lc', cmd],
-				cwd: absCwd,
-				stdout: 'pipe',
-				stderr: 'pipe',
-			});
-			const exitCode = await proc.exited;
-			const stdout = await new Response(proc.stdout).text();
-			const stderr = await new Response(proc.stderr).text();
-			if (exitCode !== 0 && !allowNonZeroExit) {
-				const msg = (stderr || stdout || `Command failed: ${cmd}`).trim();
-				throw new Error(msg);
-			}
-			return { exitCode, stdout, stderr };
-		},
-	});
-	return { name: 'bash', tool: bash };
-}

package/src/tools/builtin/bash.txt

@@ -1,7 +0,0 @@
-- Execute a shell command using `bash -lc`
-- Returns `stdout`, `stderr`, and `exitCode`
-- `cwd` is relative to the project root and sandboxed within it
-
-Usage tips:
-- Chain multiple commands with `&&` to fail-fast
-- For long outputs, consider redirecting to a file and reading it