@stacksjs/ai 0.70.87 → 0.70.88

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/ai",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.87",
+  "version": "0.70.88",
   "description": "Stacks Artificial Intelligence.",
   "author": "Chris Breuer",
   "contributors": [

package/dist/agents/claude/index.d.ts

@@ -1,29 +0,0 @@
-import type { AIDriver, StreamingResult } from '../../types';
-/**
- * Create a local Claude CLI agent
- */
-export declare function createClaudeLocalAgent(config?: ClaudeAgentConfig): AIDriver;
-/**
- * Create a remote Claude CLI agent (EC2)
- */
-export declare function createClaudeEC2Agent(config: ClaudeAgentConfig): AIDriver;
-/**
- * Process command with streaming output using Claude CLI
- *
- * Returns a ReadableStream that emits chunks of the response in real-time.
- * Uses --output-format stream-json for detailed streaming with tool usage.
- */
-export declare function processCommandStreaming(command: string, cwd: string): Promise<StreamingResult>;
-export declare function resetPromptCount(): void;
-export declare const claudeAgent: {
-  createLocal: typeof createClaudeLocalAgent
-  createEC2: typeof createClaudeEC2Agent
-  processStreaming: typeof processCommandStreaming
-  resetPromptCount: typeof resetPromptCount
-};
-export declare interface ClaudeAgentConfig {
-  cwd?: string
-  ec2Host?: string
-  ec2User?: string
-  ec2Key?: string
-}

package/dist/agents/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * AI Agents
- *
- * Export all available AI agents.
- */
-export * from './claude/index';

package/dist/buddy.d.ts

@@ -1,67 +0,0 @@
-import type { AIDriver, AIMessage, BuddyApiKeys, BuddyConfig, BuddyState, GitHubCredentials, RepoState, StreamingResult } from './types';
-/**
- * Build system prompt for AI with repository context
- */
-export declare function buildSystemPrompt(context: string): string;
-/**
- * Get driver instance by name
- */
-export declare function getDriver(driverName: string): AIDriver;
-/**
- * Get list of available AI drivers
- */
-export declare function getAvailableDrivers(): string[];
-/**
- * Get repository structure for context
- */
-export declare function getRepoContext(repoPath: string): Promise<string>;
-/**
- * Clone or open a repository
- */
-export declare function openRepository(input: string): Promise<RepoState>;
-/**
- * Apply file changes from AI response
- */
-export declare function applyChanges(aiResponse: string): Promise<string[]>;
-/**
- * Configure git user for commits
- */
-export declare function configureGitUser(): Promise<void>;
-/**
- * Stage and commit changes
- */
-export declare function commitChanges(): Promise<string>;
-/**
- * Push changes to remote
- */
-export declare function pushChanges(): Promise<void>;
-/**
- * Process command with selected AI driver
- */
-export declare function processCommand(command: string, driverName?: string): Promise<string>;
-/**
- * Process command with streaming output using Claude CLI
- */
-export declare function buddyProcessStreaming(command: string, driverName?: string, history?: Array<{role: string; content: string}>): Promise<StreamingResult>;
-/**
- * Stream a simple Q&A response using the Anthropic API directly.
- * This provides true token-by-token streaming like ChatGPT/Claude web.
- * Use this for questions/explanations that don't require agentic tool use.
- */
-export declare function buddyStreamSimple(command: string, history?: Array<{ role: string; content: string }>): Promise<StreamingResult>;
-// =============================================================================
-// Configuration
-// =============================================================================
-export declare const CONFIG: BuddyConfig;
-// API Keys state (can be set at runtime via settings endpoint)
-export declare const apiKeys: BuddyApiKeys;
-export declare const buddyState: BuddyStateManager;
-// Buddy State Manager
-export declare interface BuddyStateManager {
-  getState: () => BuddyState
-  setRepo: (repo: RepoState | null) => void
-  setCurrentDriver: (driver: string) => void
-  setGitHub: (github: GitHubCredentials | null) => void
-  addToHistory: (message: AIMessage) => void
-  clearHistory: () => void
-}

package/dist/drivers/anthropic/index.d.ts

@@ -1,40 +0,0 @@
-import type { AIDriver, AIDriverConfig, AIMessage, AIResult, ChatCompletionOptions } from '../../types';
-/**
- * Configure Anthropic globally
- */
-export declare function configure(config: AnthropicDriverConfig): void;
-export declare function createAnthropicDriver(config: AnthropicDriverConfig): AIDriver;
-/**
- * Chat completion with full options. Supports tools + structured
- * output via `responseFormat` (stacksjs/stacks#1878 A-1).
- */
-export declare function chat(messages: AIMessage[], options?: ChatCompletionOptions & { system?: string }): Promise<AIResult>;
-/**
- * Stream chat completion
- */
-export declare function streamChat(messages: AIMessage[], options?: ChatCompletionOptions & { system?: string }): AsyncGenerator<string>;
-/**
- * Simple prompt helper
- */
-export declare function prompt(text: string, options?: ChatCompletionOptions & { system?: string }): Promise<string>;
-/**
- * Count tokens (approximate)
- * Note: This is a rough estimate. For accurate counts, use the tokenizer.
- */
-export declare function estimateTokens(text: string): number;
-export declare const anthropicDriver: { create: typeof createAnthropicDriver };
-export declare const anthropic: {
-  configure: typeof configure;
-  chat: typeof chat;
-  streamChat: typeof streamChat;
-  prompt: typeof prompt;
-  estimateTokens: typeof estimateTokens;
-  createDriver: unknown
-};
-export declare interface AnthropicDriverConfig extends AIDriverConfig {
-  apiKey: string
-  model?: string
-  maxTokens?: number
-  anthropicVersion?: string
-}
-export default anthropic;

package/dist/drivers/claude-agent-sdk/index.d.ts

@@ -1,40 +0,0 @@
-import type { AIDriver, AIDriverConfig, StreamingResult } from '../../types';
-/**
- * Create a Claude Agent SDK driver instance
- */
-export declare function createClaudeAgentSDKDriver(config?: ClaudeAgentSDKConfig): AIDriver;
-/**
- * Process a command with streaming and return a StreamingResult
- */
-export declare function processStreaming(command: string, cwd?: string, config?: Omit<ClaudeAgentSDKConfig, 'cwd'>): Promise<StreamingResult>;
-/**
- * Resume a previous SDK session
- */
-export declare function resumeSession(sessionId: string, prompt: string): Promise<string>;
-/**
- * Get the last session ID for potential resume
- */
-export declare function getLastSessionId(): string | undefined;
-/**
- * Clear the stored session ID
- */
-export declare function clearSession(): void;
-// Export the driver creator and utilities
-export declare const claudeAgentSDK: {
-  createDriver: unknown;
-  processStreaming: typeof processStreaming;
-  resumeSession: typeof resumeSession;
-  getLastSessionId: typeof getLastSessionId;
-  clearSession: typeof clearSession
-};
-export declare interface ClaudeAgentSDKConfig extends AIDriverConfig {
-  maxTurns?: number
-  cwd?: string
-  allowedTools?: string[]
-  disallowedTools?: string[]
-  permissionMode?: 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan'
-  customSystemPrompt?: string
-  appendSystemPrompt?: string
-  resumeSessionId?: string
-}
-export default claudeAgentSDK;

package/dist/drivers/index.d.ts

@@ -1,13 +0,0 @@
-export type { AnthropicDriverConfig } from './anthropic/index';
-export type { OpenAIDriverConfig } from './openai/index';
-export type { OllamaDriverConfig } from './ollama/index';
-export type { ClaudeAgentSDKConfig } from './claude-agent-sdk/index';
-/**
- * AI Drivers
- *
- * Export all available AI drivers.
- */
-export { createAnthropicDriver, anthropicDriver, anthropic, estimateTokens } from './anthropic/index';
-export { createOpenAIDriver, openaiDriver, openai } from './openai/index';
-export { createOllamaDriver, ollamaDriver, ollama } from './ollama/index';
-export { createClaudeAgentSDKDriver, claudeAgentSDK, getLastSessionId, clearSession } from './claude-agent-sdk/index';

package/dist/drivers/ollama/index.d.ts

@@ -1,93 +0,0 @@
-import type { AIDriver, AIDriverConfig, AIMessage, AIResult, ChatCompletionOptions } from '../../types';
-/**
- * Configure Ollama globally
- */
-export declare function configure(config: OllamaDriverConfig): void;
-export declare function createOllamaDriver(config?: OllamaDriverConfig): AIDriver;
-/**
- * Chat completion with full options
- */
-export declare function chat(messages: AIMessage[], options?: ChatCompletionOptions): Promise<AIResult>;
-/**
- * Stream chat completion
- */
-export declare function streamChat(messages: AIMessage[], options?: ChatCompletionOptions): AsyncGenerator<string>;
-/**
- * Generate text completion (non-chat)
- */
-export declare function generate(prompt: string, options?: {
-    model?: string
-    system?: string
-    template?: string
-    context?: number[]
-    raw?: boolean
-    format?: 'json'
-    images?: string[]
-  }): Promise<AIResult>;
-/**
- * Create embeddings
- */
-export declare function embed(input: string | string[], model?: string): Promise<number[] | number[][]>;
-/**
- * List available models
- */
-export declare function listModels(): Promise<Array<{
-  name: string
-  modified_at: string
-  size: number
-  digest: string
-  details: {
-    format: string
-    family: string
-    families: string[]
-    parameter_size: string
-    quantization_level: string
-  }
-}>>;
-/**
- * Pull a model from the library
- */
-export declare function pullModel(name: string, onProgress?: (status: string, completed?: number, total?: number) => void): Promise<void>;
-/**
- * Delete a model
- */
-export declare function deleteModel(name: string): Promise<void>;
-/**
- * Show model information
- */
-export declare function showModel(_name: string): Promise<{
-  modelfile: string
-  parameters: string
-  template: string
-  details: {
-    format: string
-    family: string
-    families: string[]
-    parameter_size: string
-    quantization_level: string
-  }
-}>;
-/**
- * Check if Ollama is running
- */
-export declare function isRunning(): Promise<boolean>;
-export declare const ollamaDriver: { create: typeof createOllamaDriver };
-export declare const ollama: {
-  configure: typeof configure;
-  chat: typeof chat;
-  streamChat: typeof streamChat;
-  generate: typeof generate;
-  embed: typeof embed;
-  listModels: typeof listModels;
-  pullModel: typeof pullModel;
-  deleteModel: typeof deleteModel;
-  showModel: typeof showModel;
-  isRunning: typeof isRunning;
-  createDriver: unknown
-};
-export declare interface OllamaDriverConfig extends AIDriverConfig {
-  host?: string
-  model?: string
-  embeddingModel?: string
-}
-export default ollama;

package/dist/drivers/openai/index.d.ts

@@ -1,66 +0,0 @@
-import type { AIDriver, AIDriverConfig, AIMessage, AIResult, ChatCompletionOptions } from '../../types';
-/**
- * Configure OpenAI globally
- */
-export declare function configure(config: OpenAIDriverConfig): void;
-export declare function createOpenAIDriver(config: OpenAIDriverConfig): AIDriver;
-/**
- * Chat completion with full options
- */
-export declare function chat(messages: AIMessage[], options?: ChatCompletionOptions): Promise<AIResult>;
-/**
- * Stream chat completion
- */
-export declare function streamChat(messages: AIMessage[], options?: ChatCompletionOptions): AsyncGenerator<string>;
-/**
- * Create embeddings
- */
-export declare function embed(input: string | string[], model?: unknown): Promise<number[] | number[][]>;
-/**
- * Generate images using DALL-E
- */
-export declare function generateImage(prompt: string, options?: {
-    model?: 'dall-e-2' | 'dall-e-3'
-    size?: '256x256' | '512x512' | '1024x1024' | '1792x1024' | '1024x1792'
-    quality?: 'standard' | 'hd'
-    n?: number
-    responseFormat?: 'url' | 'b64_json'
-  }): Promise<{ url?: string, b64_json?: string }[]>;
-/**
- * Transcribe audio using Whisper
- */
-export declare function transcribe(audioFile: Blob | File, options?: {
-    model?: 'whisper-1'
-    language?: string
-    prompt?: string
-    responseFormat?: 'json' | 'text' | 'srt' | 'verbose_json' | 'vtt'
-    temperature?: number
-  }): Promise<{ text: string }>;
-/**
- * Text-to-speech using OpenAI TTS
- */
-export declare function textToSpeech(input: string, options?: {
-    model?: 'tts-1' | 'tts-1-hd'
-    voice?: 'alloy' | 'echo' | 'fable' | 'onyx' | 'nova' | 'shimmer'
-    responseFormat?: 'mp3' | 'opus' | 'aac' | 'flac' | 'wav' | 'pcm'
-    speed?: number
-  }): Promise<ArrayBuffer>;
-export declare const openaiDriver: { create: typeof createOpenAIDriver };
-export declare const openai: {
-  configure: typeof configure;
-  chat: typeof chat;
-  streamChat: typeof streamChat;
-  embed: typeof embed;
-  generateImage: typeof generateImage;
-  transcribe: typeof transcribe;
-  textToSpeech: typeof textToSpeech;
-  createDriver: unknown
-};
-export declare interface OpenAIDriverConfig extends AIDriverConfig {
-  apiKey: string
-  model?: string
-  maxTokens?: number
-  embeddingModel?: string
-  baseUrl?: string
-}
-export default openai;

package/dist/image.d.ts

@@ -1,83 +0,0 @@
-import type { AIResult } from './types';
-/**
- * Generate images from a text prompt.
- * Currently supports OpenAI DALL-E models.
- */
-export declare function generateImage(prompt: string, options?: ImageGenerationOptions): Promise<ImageGenerationResult>;
-/**
- * Edit an existing image with a text prompt (OpenAI DALL-E 2).
- */
-export declare function editImage(image: Blob | File, prompt: string, options?: ImageEditOptions): Promise<ImageGenerationResult>;
-/**
- * Create variations of an existing image (OpenAI DALL-E 2).
- */
-export declare function createImageVariation(image: Blob | File, options?: {
-    model?: 'dall-e-2'
-    n?: number
-    size?: '256x256' | '512x512' | '1024x1024'
-    responseFormat?: 'url' | 'b64_json'
-  }): Promise<ImageGenerationResult>;
-/**
- * Analyze an image using AI vision capabilities.
- * Supports Anthropic Claude, OpenAI GPT-4V, and Ollama multimodal models.
- */
-export declare function analyzeImage(imageInput: ImageInput, prompt: string, options?: VisionOptions): Promise<VisionResult>;
-/**
- * Analyze multiple images together with a prompt.
- * Useful for comparison, batch analysis, etc.
- */
-export declare function analyzeImages(images: ImageInput[], prompt: string, options?: VisionOptions): Promise<VisionResult>;
-// ============================================================================
-// Exports
-// ============================================================================
-export declare const image: {
-  generate: unknown;
-  edit: unknown;
-  variation: unknown;
-  analyze: unknown;
-  analyzeMultiple: unknown
-};
-// ============================================================================
-// Types
-// ============================================================================
-export declare interface ImageGenerationOptions {
-  provider?: 'openai' | 'ollama'
-  model?: string
-  size?: '256x256' | '512x512' | '1024x1024' | '1792x1024' | '1024x1792'
-  quality?: 'standard' | 'hd'
-  n?: number
-  responseFormat?: 'url' | 'b64_json'
-  style?: 'vivid' | 'natural'
-}
-export declare interface ImageGenerationResult {
-  images: Array<{
-    url?: string
-    b64_json?: string
-    revisedPrompt?: string
-  }>
-  provider: string
-  model: string
-}
-export declare interface VisionOptions {
-  provider?: 'anthropic' | 'openai' | 'ollama'
-  model?: string
-  maxTokens?: number
-  temperature?: number
-  detail?: 'auto' | 'low' | 'high'
-}
-export declare interface VisionResult extends AIResult {
-  provider: string
-}
-// ============================================================================
-// Image Editing
-// ============================================================================
-export declare interface ImageEditOptions {
-  mask?: Blob | File
-  model?: 'dall-e-2'
-  n?: number
-  size?: '256x256' | '512x512' | '1024x1024'
-  responseFormat?: 'url' | 'b64_json'
-}
-export type ImageInput = | { type: 'url'; url: string }
-  | { type: 'base64'; data: string; mediaType: string }
-  | { type: 'file'; path: string }

package/dist/index.d.ts

@@ -1,39 +0,0 @@
-export type { RetryConfig } from './utils/retry';
-export type { UsageRecord, UsageReporter } from './utils/usage';
-export type { SanitizeResult } from './utils/tokens';
-// Types
-export * from './types';
-// Drivers
-export * from './drivers/index';
-// Agents
-export * from './agents/index';
-// Buddy - Voice AI Code Assistant
-export * from './buddy';
-// Text utilities
-export * from './text';
-// Image generation & vision
-export * from './image';
-// Semantic search, embeddings & RAG
-export * from './search';
-// Personalization, sentiment & classification
-export * from './personalization';
-// Model Context Protocol (MCP) client
-export * from './mcp';
-// AWS Bedrock utilities
-export * from './utils/client-bedrock';
-export * from './utils/client-bedrock-runtime';
-// Cross-driver vision helpers (stacksjs/stacks#1878 A-3).
-// `buildMessageWithImages(command, images)` constructs portable
-// content arrays; `normalizeMessagesForProvider(messages, 'openai' | 'anthropic')`
-// translates between the OpenAI image_url and Anthropic image
-// source formats so apps can switch providers without rewriting.
-export { buildMessageWithImages, normalizeMessagesForProvider } from './utils/vision';
-// HTTP retry helper for 429/5xx (stacksjs/stacks#1878 A-5).
-export { fetchWithRetry } from './utils/retry';
-// Usage tracking (stacksjs/stacks#1878 A-6). Apps install reporters
-// via `onUsage(fn)`; drivers fire `recordUsage(...)` per completion.
-// Default with no reporters is a no-op.
-export { clearUsageReporters, listUsageReporters, onUsage, recordUsage } from './utils/usage';
-// Token estimation + prompt-injection heuristics (stacksjs/stacks#1878 A-7).
-export { estimateMessageTokens, estimateTokens, sanitizePrompt } from './utils/tokens';
-export * from './utils/model-access';