@stacksjs/ai 0.70.23 → 0.70.26

package/dist/src/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * AI Module Types
+ *
+ * Shared type definitions for AI drivers and agents.
+ */
+export declare interface AIMessage {
+  role: 'user' | 'assistant' | 'system'
+  content: string | AIMessageContent[]
+}
+export declare interface AIMessageContent {
+  type: 'text' | 'image_url' | 'image'
+  text?: string
+  image_url?: { url: string, detail?: 'auto' | 'low' | 'high' }
+  source?: { type: 'base64', media_type: string, data: string }
+}
+export declare interface AIDriver {
+  name: string
+  process: (command: string, context: string, history: AIMessage[]) => Promise<string>
+  stream?: (command: string, context: string, history: AIMessage[]) => AsyncGenerator<string>
+  embed?: (input: string | string[]) => Promise<number[] | number[][]>
+}
+export declare interface AIDriverConfig {
+  apiKey?: string
+  baseUrl?: string
+  model?: string
+  maxTokens?: number
+}
+export declare interface StreamingResult {
+  stream: ReadableStream<Uint8Array>
+  fullResponse: Promise<string>
+}
+export declare interface EmbeddingResult {
+  embedding: number[]
+  index: number
+  object: string
+}
+export declare interface EmbeddingsResponse {
+  data: EmbeddingResult[]
+  model: string
+  usage: {
+    prompt_tokens: number
+    total_tokens: number
+  }
+}
+export declare interface ChatCompletionOptions {
+  model?: string
+  maxTokens?: number
+  temperature?: number
+  topP?: number
+  stop?: string | string[]
+  stream?: boolean
+}
+export declare interface AIResult {
+  content: string
+  model: string
+  usage?: {
+    promptTokens: number
+    completionTokens: number
+    totalTokens: number
+  }
+  finishReason?: string
+}
+export declare interface ClaudeAPIResponse {
+  content: Array<{ type: string, text: string }>
+}
+export declare interface OpenAIAPIResponse {
+  choices: Array<{ message: { content: string } }>
+}
+export declare interface OllamaAPIResponse {
+  message: { content: string }
+}
+export declare interface ClaudeStreamEvent {
+  type: string
+  subtype?: string
+  message?: {
+    content: Array<{
+      type: string
+      text?: string
+      name?: string
+      input?: Record<string, unknown>
+    }>
+  }
+  delta?: { text?: string }
+  result?: string
+  index?: number
+  content_block?: {
+    type: string
+    text?: string
+  }
+}
+// Buddy Types
+export declare interface RepoState {
+  path: string
+  name: string
+  branch: string
+  hasChanges: boolean
+  lastCommit?: string
+}
+export declare interface GitHubCredentials {
+  token: string
+  username: string
+  name: string
+  email: string
+}
+export declare interface BuddyState {
+  repo: RepoState | null
+  conversationHistory: AIMessage[]
+  currentDriver: string
+  github: GitHubCredentials | null
+}
+export declare interface BuddyConfig {
+  workDir: string
+  commitMessage: string
+  ollamaHost: string
+  ollamaModel: string
+}
+export declare interface BuddyApiKeys {
+  anthropic?: string
+  openai?: string
+  claudeCliHost?: string
+}
+// Image types
+export declare interface ImageGenerationConfig {
+  provider: 'openai'
+  model?: string
+  apiKey?: string
+}
+// Search/RAG types
+export declare interface SearchConfig {
+  embeddingProvider: 'openai' | 'ollama'
+  embeddingModel?: string
+  generationProvider?: 'anthropic' | 'openai' | 'ollama'
+  generationModel?: string
+}
+// MCP types
+export declare interface MCPConfig {
+  servers: Array<{
+    name: string
+    command?: string
+    args?: string[]
+    url?: string
+    env?: Record<string, string>
+  }>
+}
+// AI module config (used by @stacksjs/config)
+export declare interface AIConfig {
+  default?: string
+  models?: string[]
+  drivers?: {
+    anthropic?: AIDriverConfig & { anthropicVersion?: string }
+    openai?: AIDriverConfig & { embeddingModel?: string }
+    ollama?: AIDriverConfig & { host?: string; embeddingModel?: string }
+  }
+  image?: ImageGenerationConfig
+  search?: SearchConfig
+  mcp?: MCPConfig
+}

package/dist/src/utils/client-bedrock-runtime.d.ts

@@ -0,0 +1,16 @@
+import type { InvokeModelCommandInput, InvokeModelCommandOutput, InvokeModelWithResponseStreamCommandInput, InvokeModelWithResponseStreamCommandOutput } from '@stacksjs/ts-cloud/aws';
+export type { InvokeModelCommandInput, InvokeModelWithResponseStreamCommandInput };
+/*
+ * Invoke Model
+ * @param {InvokeModelCommandInput} params
+ * @returns {Promise<InvokeModelCommandOutput>}
+ * @see https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/BedrockRuntime.html#invokeModel-property
+ */
+export declare function invokeModel(params: InvokeModelCommandInput): Promise<InvokeModelCommandOutput>;
+/*
+ * Invoke Model With Response Stream
+ * @param {InvokeModelWithResponseStreamCommandInput} params
+ * @returns {Promise<InvokeModelWithResponseStreamCommandOutput>}
+ * @see https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/BedrockRuntime.html#invokeModelWithResponseStream-property
+ */
+export declare function invokeModelWithResponseStream(params: InvokeModelWithResponseStreamCommandInput): Promise<InvokeModelWithResponseStreamCommandOutput>;

package/dist/src/utils/client-bedrock.d.ts

@@ -0,0 +1,27 @@
+import type { CreateModelCustomizationJobCommandInput, CreateModelCustomizationJobCommandOutput, GetModelCustomizationJobCommandInput, GetModelCustomizationJobCommandOutput, ListFoundationModelsCommandInput, ListFoundationModelsCommandOutput } from '@stacksjs/ts-cloud/aws';
+export type {
+  CreateModelCustomizationJobCommandInput,
+  GetModelCustomizationJobCommandInput,
+  ListFoundationModelsCommandInput,
+};
+/*
+ * Create Model Customization Job
+ * @param {CreateModelCustomizationJobCommandInput} params
+ * @returns {Promise<CreateModelCustomizationJobCommandOutput>}
+ * @see https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Bedrock.html#CreateModelCustomizationJob-property
+ */
+export declare function createModelCustomizationJob(param: CreateModelCustomizationJobCommandInput): Promise<CreateModelCustomizationJobCommandOutput>;
+/*
+ * Get Model Customization Job
+ * @param {GetModelCustomizationJobCommandInput} params
+ * @returns {Promise<GetModelCustomizationJobCommandOutput>}
+ * @see https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Bedrock.html#getModelCustomizationJob-property
+ */
+export declare function getModelCustomizationJob(params: GetModelCustomizationJobCommandInput): Promise<GetModelCustomizationJobCommandOutput>;
+/*
+ * List Foundation Models
+ * @param {ListFoundationModelsCommandInput} params
+ * @returns {Promise<ListFoundationModelsCommandOutput>}
+ * @see https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Bedrock.html#listFoundationModels-property
+ */
+export declare function listFoundationModels(params: ListFoundationModelsCommandInput): Promise<ListFoundationModelsCommandOutput>;

package/dist/src/utils/model-access.d.ts

@@ -0,0 +1 @@
+export declare function requestModelAccess(): Promise<void>;

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@stacksjs/ai",
   "type": "module",
-  "version": "0.70.23",
+  "version": "0.70.26",
   "description": "Stacks Artificial Intelligence.",
   "author": "Chris Breuer",
-  "contributors": ["Chris Breuer <chris@stacksjs.org>"],
+  "contributors": [
+    "Chris Breuer <chris@stacksjs.com>"
+  ],
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",
   "homepage": "https://github.com/stacksjs/stacks/tree/main/storage/framework/core/ai#readme",
@@ -18,33 +20,52 @@
   },
   "keywords": [
     "ai",
-    "huggingface",
+    "anthropic",
     "openai",
+    "ollama",
+    "embeddings",
+    "rag",
+    "mcp",
+    "vision",
     "artificial intelligence",
     "api",
     "stacks"
   ],
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
       "import": "./dist/index.js"
     },
     "./*": {
+      "bun": "./src/*",
       "import": "./dist/*"
     }
   },
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "files": ["README.md", "dist"],
+  "files": [
+    "README.md",
+    "dist"
+  ],
   "scripts": {
     "build": "bun build.ts",
     "typecheck": "bun tsc --noEmit",
     "test": "bun test",
     "prepublishOnly": "bun run build"
   },
+  "dependencies": {
+    "@stacksjs/ts-cloud": "^0.2.15"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.79"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/claude-agent-sdk": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "@aws-sdk/client-bedrock-runtime": "^3.779.0",
-    "@aws-sdk/credential-providers": "^3.778.0",
-    "@stacksjs/development": "0.70.22",
-    "aws-sdk-client-mock": "^4.1.0"
+    "better-dx": "^0.2.12"
   }
 }

package/dist/client-bedrock-runtime.d.ts

@@ -1,7 +0,0 @@
-export type { InvokeModelCommandInput, InvokeModelWithResponseStreamCommandInput }
-export declare const client: BedrockRuntimeClient;
-declare const logger: unknown;
-export declare function invokeModel(params: InvokeModelCommandInput): Promise<InvokeModelCommandOutput>;
-export declare function invokeModelWithResponseStream(params: InvokeModelWithResponseStreamCommandInput): Promise<InvokeModelWithResponseStreamCommandOutput>;
-
-export { InvokeModelCommand }

package/dist/client-bedrock.d.ts

@@ -1,5 +0,0 @@
-export type {
-declare const client: unknown;
-export declare function createModelCustomizationJob(param: CreateModelCustomizationJobCommandInput): Promise<CreateModelCustomizationJobCommandOutput>;
-export declare function getModelCustomizationJob(params: GetModelCustomizationJobCommandInput): Promise<GetModelCustomizationJobCommandOutput>;
-export declare function listFoundationModels(params: ListFoundationModelsCommandInput): Promise<ListFoundationModelsCommandOutput>;

package/dist/index.d.ts

@@ -1,4 +0,0 @@
-export * from './text'
-export * from './utils/client-bedrock'
-export * from './utils/client-bedrock-runtime'
-export * from './utils/model-access'