@dangao/bun-server 1.12.0 → 2.0.0

package/README.md

@@ -63,6 +63,38 @@
 - 🖥️ **Zero-config cluster** — `ClusterManager` auto-spawns reusePort
   workers matching CPU core count.
 
+## AI Modules (v2.0.0)
+
+9 official AI modules for building production-grade LLM applications. All providers use Bun's native `fetch()` — zero external SDK dependencies.
+
+| Module | Purpose |
+|--------|---------|
+| `AiModule` | LLM unified access (OpenAI, Claude, Gemini, Ollama) + Tool Calling + streaming |
+| `ConversationModule` | Multi-turn conversation memory (Memory/Redis/Database stores) |
+| `PromptModule` | Reusable prompt templates with `{{variable}}` interpolation and versioning |
+| `EmbeddingModule` | Text embedding generation (OpenAI, Ollama) |
+| `VectorStoreModule` | Vector similarity search (Memory, Pinecone, Qdrant) |
+| `RagModule` | Full RAG pipeline: ingest → chunk → embed → retrieve |
+| `McpModule` | MCP protocol server (JSON-RPC 2.0, SSE transport) |
+| `AiGuardModule` | PII detection, prompt injection detection, content moderation |
+
+```typescript
+import { AiModule, OllamaProvider, AI_SERVICE_TOKEN, AiService } from '@dangao/bun-server';
+
+AiModule.forRoot({
+  providers: [{ name: 'ollama', provider: OllamaProvider, config: {}, default: true }],
+  fallback: true,
+});
+
+@Injectable()
+class ChatService {
+  constructor(@Inject(AI_SERVICE_TOKEN) private ai: AiService) {}
+  chat(message: string) { return this.ai.complete({ messages: [{ role: 'user', content: message }] }); }
+}
+```
+
+See [docs/ai.md](docs/ai.md) for the complete AI modules guide and [examples/05-ai/](examples/05-ai/) for working examples including the [AI Platform MVP Demo](examples/05-ai/ai-platform-mvp/).
+
 ## Architecture
 
 ### Request Lifecycle

package/dist/ai/ai-module.d.ts

@@ -0,0 +1,24 @@
+import { type AiModuleOptions } from './types';
+export declare class AiModule {
+    /**
+     * Configure the AI module with one or more LLM providers.
+     *
+     * @example
+     * ```typescript
+     * AiModule.forRoot({
+     *   providers: [
+     *     { name: 'openai', provider: OpenAIProvider, config: { apiKey: '...' }, default: true },
+     *     { name: 'ollama', provider: OllamaProvider, config: {} },
+     *   ],
+     *   fallback: true,
+     *   timeout: 30000,
+     * });
+     * ```
+     */
+    static forRoot(options: AiModuleOptions): typeof AiModule;
+    /**
+     * Reset module state (for testing)
+     */
+    static reset(): void;
+}
+//# sourceMappingURL=ai-module.d.ts.map

package/dist/ai/ai-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-module.d.ts","sourceRoot":"","sources":["../../src/ai/ai-module.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,SAAS,CAAC;AAGjB,qBACa,QAAQ;IACnB;;;;;;;;;;;;;;OAcG;WACW,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,QAAQ;IA2BhE;;OAEG;WACW,KAAK,IAAI,IAAI;CAG5B"}

package/dist/ai/decorators.d.ts

@@ -0,0 +1,25 @@
+import type { AiToolDefinition } from './types';
+/**
+ * Mark a service method as an AI tool available for Tool Calling.
+ *
+ * @example
+ * ```typescript
+ * \@Injectable()
+ * class CalculatorService {
+ *   \@AiTool({
+ *     name: 'calculate',
+ *     description: 'Evaluate a mathematical expression',
+ *     parameters: {
+ *       type: 'object',
+ *       properties: { expression: { type: 'string' } },
+ *       required: ['expression'],
+ *     },
+ *   })
+ *   public calculate({ expression }: { expression: string }): string {
+ *     return String(eval(expression));
+ *   }
+ * }
+ * ```
+ */
+export declare function AiTool(definition: AiToolDefinition): MethodDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/ai/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/ai/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,gBAAgB,GAAG,eAAe,CAIpE"}

package/dist/ai/errors.d.ts

@@ -0,0 +1,39 @@
+import { HttpException } from '../error/http-exception';
+/**
+ * Base AI provider error
+ */
+export declare class AiProviderError extends HttpException {
+    readonly provider: string;
+    constructor(message: string, provider: string, statusCode?: number);
+}
+/**
+ * LLM rate limit exceeded
+ */
+export declare class AiRateLimitError extends AiProviderError {
+    constructor(provider: string, retryAfterMs?: number);
+}
+/**
+ * Input exceeds model context window
+ */
+export declare class AiContextLengthError extends AiProviderError {
+    constructor(provider: string, maxTokens?: number);
+}
+/**
+ * LLM request timed out
+ */
+export declare class AiTimeoutError extends AiProviderError {
+    constructor(provider: string, timeoutMs: number);
+}
+/**
+ * No AI providers configured
+ */
+export declare class AiNoProviderError extends HttpException {
+    constructor();
+}
+/**
+ * All providers in fallback chain failed
+ */
+export declare class AiAllProvidersFailed extends HttpException {
+    constructor(errors: string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/ai/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ai/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;aAG9B,QAAQ,EAAE,MAAM;gBADhC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChC,UAAU,SAAM;CAInB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;gBAChC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAS3D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;gBACpC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CASxD;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,eAAe;gBAC9B,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAGvD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;;CAInD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;gBAClC,MAAM,EAAE,MAAM,EAAE;CAGpC"}

package/dist/ai/index.d.ts

@@ -0,0 +1,12 @@
+export * from './types';
+export * from './errors';
+export * from './decorators';
+export * from './service';
+export * from './ai-module';
+export * from './tools/tool-registry';
+export * from './tools/tool-executor';
+export * from './providers/openai-provider';
+export * from './providers/anthropic-provider';
+export * from './providers/ollama-provider';
+export * from './providers/google-provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC"}

package/dist/ai/providers/anthropic-provider.d.ts

@@ -0,0 +1,23 @@
+import type { LlmProvider, AiRequest, AiResponse, AiMessage } from '../types';
+export interface AnthropicProviderConfig {
+    apiKey: string;
+    /** Default: https://api.anthropic.com */
+    baseUrl?: string;
+    /** Default: claude-3-7-sonnet-20250219 */
+    defaultModel?: string;
+    /** API version header */
+    anthropicVersion?: string;
+}
+export declare class AnthropicProvider implements LlmProvider {
+    readonly name = "anthropic";
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModel;
+    private readonly anthropicVersion;
+    constructor(config: AnthropicProviderConfig);
+    complete(request: AiRequest): Promise<AiResponse>;
+    stream(request: AiRequest): ReadableStream<Uint8Array>;
+    countTokens(messages: AiMessage[]): number;
+    private post;
+}
+//# sourceMappingURL=anthropic-provider.d.ts.map

package/dist/ai/providers/anthropic-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/anthropic-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,iBAAkB,YAAW,WAAW;IACnD,SAAgB,IAAI,eAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAEvB,MAAM,EAAE,uBAAuB;IAOrC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IA+DvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IA8EtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;YAInC,IAAI;CAiBnB"}

package/dist/ai/providers/google-provider.d.ts

@@ -0,0 +1,20 @@
+import type { LlmProvider, AiRequest, AiResponse, AiMessage } from '../types';
+export interface GoogleProviderConfig {
+    apiKey: string;
+    /** Default: gemini-2.0-flash */
+    defaultModel?: string;
+    /** Default: https://generativelanguage.googleapis.com/v1beta */
+    baseUrl?: string;
+}
+export declare class GoogleProvider implements LlmProvider {
+    readonly name = "google";
+    private readonly apiKey;
+    private readonly defaultModel;
+    private readonly baseUrl;
+    constructor(config: GoogleProviderConfig);
+    complete(request: AiRequest): Promise<AiResponse>;
+    stream(request: AiRequest): ReadableStream<Uint8Array>;
+    countTokens(messages: AiMessage[]): number;
+    private toGeminiMessages;
+}
+//# sourceMappingURL=google-provider.d.ts.map

package/dist/ai/providers/google-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/google-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAEd,MAAM,EAAE,oBAAoB;IAMlC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAoEvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IAkEtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;IAIjD,OAAO,CAAC,gBAAgB;CAiBzB"}

package/dist/ai/providers/ollama-provider.d.ts

@@ -0,0 +1,17 @@
+import type { LlmProvider, AiRequest, AiResponse, AiMessage } from '../types';
+export interface OllamaProviderConfig {
+    /** Default: http://localhost:11434 */
+    baseUrl?: string;
+    /** Default model to use */
+    defaultModel?: string;
+}
+export declare class OllamaProvider implements LlmProvider {
+    readonly name = "ollama";
+    private readonly baseUrl;
+    private readonly defaultModel;
+    constructor(config?: OllamaProviderConfig);
+    complete(request: AiRequest): Promise<AiResponse>;
+    stream(request: AiRequest): ReadableStream<Uint8Array>;
+    countTokens(messages: AiMessage[]): number;
+}
+//# sourceMappingURL=ollama-provider.d.ts.map

package/dist/ai/providers/ollama-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/ollama-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAEnB,MAAM,GAAE,oBAAyB;IAKvC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAuCvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IA+DtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;CAGlD"}

package/dist/ai/providers/openai-provider.d.ts

@@ -0,0 +1,28 @@
+import type { LlmProvider, AiRequest, AiResponse, AiMessage } from '../types';
+export interface OpenAIProviderConfig {
+    apiKey: string;
+    /** Default: https://api.openai.com/v1 */
+    baseUrl?: string;
+    /** Default: gpt-4o */
+    defaultModel?: string;
+    /** Pricing per 1M tokens (input/output) for cost estimation */
+    pricing?: Record<string, {
+        input: number;
+        output: number;
+    }>;
+}
+export declare class OpenAIProvider implements LlmProvider {
+    readonly name = "openai";
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly defaultModel;
+    private readonly pricing;
+    constructor(config: OpenAIProviderConfig);
+    complete(request: AiRequest): Promise<AiResponse>;
+    stream(request: AiRequest): ReadableStream<Uint8Array>;
+    countTokens(messages: AiMessage[]): number;
+    private post;
+    private safeParseToolArguments;
+    private estimateCost;
+}
+//# sourceMappingURL=openai-provider.d.ts.map

package/dist/ai/providers/openai-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/openai-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAwCD,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoD;gBAEzD,MAAM,EAAE,oBAAoB;IAOlC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IA4CvD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IA+EtD,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;YAKnC,IAAI;IA4BlB,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,YAAY;CAKrB"}

package/dist/ai/service.d.ts

@@ -0,0 +1,40 @@
+import type { LlmProvider, AiRequest, AiResponse, AiModuleOptions, AiMessage } from './types';
+import type { ToolRegistry } from './tools/tool-registry';
+/**
+ * Core AI service — manages multiple LLM providers, fallback, streaming,
+ * Tool Calling loop, and cost tracking.
+ */
+export declare class AiService {
+    private readonly providers;
+    private defaultProviderName;
+    private readonly options;
+    private toolExecutor;
+    constructor(options: AiModuleOptions);
+    /**
+     * Attach a ToolRegistry so the service can run Tool Calling loops
+     */
+    setToolRegistry(registry: ToolRegistry): void;
+    /**
+     * Non-streaming completion with optional Tool Calling loop
+     */
+    complete(request: AiRequest): Promise<AiResponse>;
+    /**
+     * Streaming completion — returns SSE ReadableStream
+     */
+    stream(request: AiRequest): ReadableStream<Uint8Array>;
+    /**
+     * Estimate token count for messages using the default provider
+     */
+    countTokens(messages: AiMessage[]): number;
+    /**
+     * Get a provider by name (or default)
+     */
+    getProvider(name?: string): LlmProvider;
+    /**
+     * List all registered provider names
+     */
+    getProviderNames(): string[];
+    private completeSingle;
+    private withTimeout;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/ai/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/ai/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,eAAe,EACf,SAAS,EACV,MAAM,SAAS,CAAC;AAIjB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D;;;GAGG;AACH,qBACa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAA6B;gBAGd,OAAO,EAAE,eAAe;IAY3D;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIpD;;OAEG;IACU,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IA8B9D;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC;IAK7D;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;IAKjD;;OAEG;IACI,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW;IAU9C;;OAEG;IACI,gBAAgB,IAAI,MAAM,EAAE;YAIrB,cAAc;IA+B5B,OAAO,CAAC,WAAW;CASpB"}

package/dist/ai/tools/tool-executor.d.ts

@@ -0,0 +1,15 @@
+import type { AiMessage, AiToolCall } from '../types';
+import type { ToolRegistry } from './tool-registry';
+/**
+ * Executes tool calls from LLM responses and formats results as AiMessages
+ */
+export declare class ToolExecutor {
+    private readonly registry;
+    constructor(registry: ToolRegistry);
+    /**
+     * Execute all tool calls in parallel and return result messages
+     */
+    executeAll(toolCalls: AiToolCall[]): Promise<AiMessage[]>;
+    private executeOne;
+}
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/ai/tools/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../../src/ai/tools/tool-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;GAEG;AACH,qBAAa,YAAY;IACJ,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAE1D;;OAEG;IACU,UAAU,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YAOxD,UAAU;CAkBzB"}

package/dist/ai/tools/tool-registry.d.ts

@@ -0,0 +1,39 @@
+import type { AiToolDefinition } from '../types';
+/**
+ * Registered tool entry
+ */
+export interface RegisteredTool extends AiToolDefinition {
+    /** Bound execute function */
+    execute(args: Record<string, unknown>): Promise<unknown>;
+}
+/**
+ * Registry for all @AiTool()-decorated methods
+ */
+export declare class ToolRegistry {
+    private readonly tools;
+    /**
+     * Register a tool manually
+     */
+    register(tool: RegisteredTool): void;
+    /**
+     * Scan an object instance for @AiTool() decorated methods and register them
+     */
+    scanAndRegister(instance: object): void;
+    /**
+     * Get all registered tools as definitions (for LLM request)
+     */
+    getDefinitions(): AiToolDefinition[];
+    /**
+     * Execute a tool by name
+     */
+    execute(name: string, args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Check whether a tool exists
+     */
+    has(name: string): boolean;
+    /**
+     * Number of registered tools
+     */
+    get size(): number;
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/ai/tools/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/ai/tools/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,6BAA6B;IAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAI3C;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IA4B9C;;OAEG;IACI,cAAc,IAAI,gBAAgB,EAAE;IAQ3C;;OAEG;IACU,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAQnF;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;CACF"}

package/dist/ai/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * AI message role
+ */
+export type AiMessageRole = 'system' | 'user' | 'assistant' | 'tool';
+/**
+ * Single AI message
+ */
+export interface AiMessage {
+    role: AiMessageRole;
+    content: string;
+    /** Tool call ID (only for role='tool') */
+    toolCallId?: string;
+    /** Tool calls returned by assistant */
+    toolCalls?: AiToolCall[];
+}
+/**
+ * AI tool call from LLM response
+ */
+export interface AiToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * AI tool definition (for function calling)
+ */
+export interface AiToolDefinition {
+    name: string;
+    description: string;
+    /** JSON Schema for parameters */
+    parameters: Record<string, unknown>;
+}
+/**
+ * AI request to LLM
+ */
+export interface AiRequest {
+    messages: AiMessage[];
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    tools?: AiToolDefinition[];
+    /** Provider name override */
+    provider?: string;
+}
+/**
+ * Non-streaming AI response
+ */
+export interface AiResponse {
+    content: string;
+    toolCalls?: AiToolCall[];
+    model: string;
+    provider: string;
+    usage: AiUsage;
+    finishReason: 'stop' | 'tool_calls' | 'length' | 'error';
+}
+/**
+ * Streaming AI chunk
+ */
+export interface AiChunk {
+    content?: string;
+    toolCallDelta?: {
+        index: number;
+        id?: string;
+        name?: string;
+        argumentsDelta?: string;
+    };
+    done: boolean;
+    model?: string;
+    usage?: AiUsage;
+}
+/**
+ * Token usage statistics
+ */
+export interface AiUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    /** Estimated cost in USD */
+    estimatedCostUsd?: number;
+}
+/**
+ * LLM provider abstraction interface
+ */
+export interface LlmProvider {
+    /**
+     * Non-streaming completion
+     */
+    complete(request: AiRequest): Promise<AiResponse>;
+    /**
+     * Streaming completion — returns SSE-encoded ReadableStream
+     */
+    stream(request: AiRequest): ReadableStream<Uint8Array>;
+    /**
+     * Approximate token count for messages
+     */
+    countTokens(messages: AiMessage[]): number;
+    /** Provider name */
+    readonly name: string;
+}
+/**
+ * Provider configuration entry
+ */
+export interface AiProviderConfig<T = unknown> {
+    name: string;
+    provider: new (config: T) => LlmProvider;
+    config: T;
+    /** Use this provider by default */
+    default?: boolean;
+}
+/**
+ * AiModule configuration
+ */
+export interface AiModuleOptions {
+    providers: AiProviderConfig[];
+    /** Enable provider fallback chain on error */
+    fallback?: boolean;
+    /** Request timeout in ms */
+    timeout?: number;
+    /** Tool calling configuration */
+    tools?: {
+        /** Auto-discover @AiTool() decorated methods */
+        autoDiscover?: boolean;
+        /** Max tool call iterations per request */
+        maxIterations?: number;
+    };
+}
+export declare const AI_SERVICE_TOKEN: unique symbol;
+export declare const AI_MODULE_OPTIONS_TOKEN: unique symbol;
+export declare const AI_TOOL_REGISTRY_TOKEN: unique symbol;
+/**
+ * Metadata key for @AiTool decorator
+ */
+export declare const AI_TOOL_METADATA_KEY = "@dangao/bun-server:ai:tool";
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"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"}

package/dist/ai-guard/ai-guard-module.d.ts

@@ -0,0 +1,18 @@
+import { type AiGuardModuleOptions } from './types';
+export declare class AiGuardModule {
+    /**
+     * Configure AI safety guards.
+     *
+     * @example
+     * ```typescript
+     * AiGuardModule.forRoot({
+     *   piiDetection: true,
+     *   moderation: { openaiApiKey: process.env.OPENAI_API_KEY },
+     *   promptInjection: { sensitivity: 'medium' },
+     * });
+     * ```
+     */
+    static forRoot(options?: AiGuardModuleOptions): typeof AiGuardModule;
+    static reset(): void;
+}
+//# sourceMappingURL=ai-guard-module.d.ts.map

package/dist/ai-guard/ai-guard-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-guard-module.d.ts","sourceRoot":"","sources":["../../src/ai-guard/ai-guard-module.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,SAAS,CAAC;AAEjB,qBACa,aAAa;IACxB;;;;;;;;;;;OAWG;WACW,OAAO,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,aAAa;WAuBjE,KAAK,IAAI,IAAI;CAG5B"}

package/dist/ai-guard/decorators.d.ts

@@ -0,0 +1,16 @@
+import type { AiGuardModuleOptions } from './types';
+/**
+ * Mark a controller method to run AI guard checks on the request body.
+ * Requires `AiGuardModule` to be configured.
+ *
+ * @example
+ * ```typescript
+ * \@POST('/chat')
+ * \@AiGuard({ piiDetection: true, moderation: true, promptInjection: true })
+ * public async chat(\@Body() body: { message: string }) {
+ *   // body.message has already been checked and sanitized
+ * }
+ * ```
+ */
+export declare function AiGuard(options?: Partial<AiGuardModuleOptions>): MethodDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/ai-guard/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/ai-guard/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,OAAO,CAAC,oBAAoB,CAAM,GAAG,eAAe,CAIpF"}

package/dist/ai-guard/detectors/content-moderator.d.ts

@@ -0,0 +1,26 @@
+import type { ModerationResult } from '../types';
+export interface ContentModeratorConfig {
+    /** OpenAI API key for the Moderation API */
+    openaiApiKey?: string;
+    /** Custom moderator function (overrides OpenAI if provided) */
+    moderator?: (text: string) => Promise<ModerationResult>;
+    /** Categories that will cause content to be flagged */
+    blockCategories?: string[];
+}
+/**
+ * Content moderation using OpenAI Moderation API or a custom function.
+ */
+export declare class ContentModerator {
+    private readonly config;
+    constructor(config?: ContentModeratorConfig);
+    /**
+     * Check text for harmful content
+     */
+    moderate(text: string): Promise<ModerationResult>;
+    /**
+     * Check whether the result should block the request
+     */
+    isBlocked(result: ModerationResult): boolean;
+    private moderateWithOpenAI;
+}
+//# sourceMappingURL=content-moderator.d.ts.map

package/dist/ai-guard/detectors/content-moderator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-moderator.d.ts","sourceRoot":"","sources":["../../../src/ai-guard/detectors/content-moderator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxD,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAE7B,MAAM,GAAE,sBAA2B;IAItD;;OAEG;IACU,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAa9D;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;YAOrC,kBAAkB;CAgCjC"}

package/dist/ai-guard/detectors/injection-detector.d.ts

@@ -0,0 +1,13 @@
+import type { InjectionDetectionResult } from '../types';
+/**
+ * Detects prompt injection attacks using heuristic pattern matching.
+ */
+export declare class PromptInjectionDetector {
+    private readonly threshold;
+    constructor(sensitivity?: 'low' | 'medium' | 'high');
+    /**
+     * Analyze text for prompt injection patterns
+     */
+    detect(text: string): InjectionDetectionResult;
+}
+//# sourceMappingURL=injection-detector.d.ts.map

package/dist/ai-guard/detectors/injection-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection-detector.d.ts","sourceRoot":"","sources":["../../../src/ai-guard/detectors/injection-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAezD;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEhB,WAAW,GAAE,KAAK,GAAG,QAAQ,GAAG,MAAiB;IAIpE;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB;CAmBtD"}

package/dist/ai-guard/detectors/pii-detector.d.ts

@@ -0,0 +1,11 @@
+import type { PiiDetectionResult } from '../types';
+/**
+ * Detects and optionally redacts PII from text using regex patterns.
+ */
+export declare class PiiDetector {
+    /**
+     * Analyze text for PII
+     */
+    detect(text: string, redact?: boolean): PiiDetectionResult;
+}
+//# sourceMappingURL=pii-detector.d.ts.map

package/dist/ai-guard/detectors/pii-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pii-detector.d.ts","sourceRoot":"","sources":["../../../src/ai-guard/detectors/pii-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAmCnD;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,UAAO,GAAG,kBAAkB;CAqB/D"}

package/dist/ai-guard/index.d.ts

@@ -0,0 +1,8 @@
+export * from './types';
+export * from './decorators';
+export * from './service';
+export * from './ai-guard-module';
+export * from './detectors/pii-detector';
+export * from './detectors/content-moderator';
+export * from './detectors/injection-detector';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-guard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai-guard/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC"}