@stacksjs/ai 0.70.23 → 0.70.26

package/README.md

@@ -3,6 +3,7 @@
 This package contains a set of tools to help you build AI-powered applications.
 
 1. Request model access from AWS: <https://us-east-1.console.aws.amazon.com/bedrock/home?region=us-east-1#/modelaccess>
+
 2.
 
 ## ☘️ Features

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

@@ -0,0 +1,29 @@
+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/src/agents/index.d.ts

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

package/dist/src/buddy.d.ts

@@ -0,0 +1,67 @@
+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/src/drivers/anthropic/index.d.ts

@@ -0,0 +1,34 @@
+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
+ */
+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: {
+  createDriver: unknown
+};
+export declare interface AnthropicDriverConfig extends AIDriverConfig {
+  apiKey: string
+  model?: string
+  maxTokens?: number
+  anthropicVersion?: string
+}
+export default anthropic;

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

@@ -0,0 +1,36 @@
+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
+};
+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/src/drivers/index.d.ts

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

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

@@ -0,0 +1,83 @@
+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: {
+  createDriver: unknown
+};
+export declare interface OllamaDriverConfig extends AIDriverConfig {
+  host?: string
+  model?: string
+  embeddingModel?: string
+}
+export default ollama;

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

@@ -0,0 +1,59 @@
+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: {
+  createDriver: unknown
+};
+export declare interface OpenAIDriverConfig extends AIDriverConfig {
+  apiKey: string
+  model?: string
+  maxTokens?: number
+  embeddingModel?: string
+  baseUrl?: string
+}
+export default openai;

package/dist/src/image.d.ts

@@ -0,0 +1,83 @@
+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/src/index.d.ts

@@ -0,0 +1,22 @@
+// Types
+export * from './types';
+// Drivers
+export * from './drivers';
+// Agents
+export * from './agents';
+// 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';
+export * from './utils/model-access';