universal-llm-client 4.2.0 → 4.5.0

package/src/index.ts

@@ -1,161 +1,180 @@
-/**
- * Universal LLM Client v3
- *
- * A universal LLM client with transparent provider failover,
- * streaming tool execution, pluggable reasoning, and native observability.
- *
- * @module universal-llm-client
- */
-
-// ============================================================================
-// Public API — The Universal Client
-// ============================================================================
-
-export { AIModel } from './ai-model.js';
-
-// ============================================================================
-// Types & Interfaces
-// ============================================================================
-
-export {
-    // Enums
-    AIModelApiType,
-    AIModelType,
-    // Config
-    type AIModelConfig,
-    type ProviderConfig,
-    type LLMClientOptions,
-    // Messages
-    type LLMChatMessage,
-    type LLMMessageContent,
-    type LLMContentPart,
-    type LLMTextContent,
-    type LLMImageContent,
-    type LLMAudioContent,
-    // Responses
-    type LLMChatResponse,
-    type TokenUsageInfo,
-    // Tools
-    type LLMToolCall,
-    type LLMToolDefinition,
-    type LLMFunction,
-    type ToolHandler,
-    type ToolExecutionResult,
-    type ToolRegistry,
-    type ToolRegistryEntry,
-    // Options
-    type ChatOptions,
-    type ResponseFormat,
-    type OutputOptions,
-    // Model info
-    type ModelMetadata,
-    // Helpers
-    textContent,
-    imageContent,
-    multimodalMessage,
-    extractTextContent,
-    hasImages,
-    audioContent,
-    hasAudio,
-} from './interfaces.js';
-
-// ============================================================================
-// Observability
-// ============================================================================
-
-export {
-    type Auditor,
-    type AuditEvent,
-    type AuditEventType,
-    NoopAuditor,
-    ConsoleAuditor,
-    BufferedAuditor,
-} from './auditor.js';
-
-// ============================================================================
-// Stream Decoding
-// ============================================================================
-
-export {
-    type StreamDecoder,
-    type DecodedEvent,
-    type DecoderCallback,
-    type DecoderType,
-    type DecoderOptions,
-    type DecoderFactory,
-    createDecoder,
-    registerDecoder,
-    getRegisteredDecoders,
-    PassthroughDecoder,
-    StandardChatDecoder,
-    InterleavedReasoningDecoder,
-} from './stream-decoder.js';
-
-// ============================================================================
-// Tool Utilities
-// ============================================================================
-
-export {
-    ToolBuilder,
-    ToolExecutor,
-    createTimeTool,
-    createRandomNumberTool,
-} from './tools.js';
-
-// ============================================================================
-// HTTP Utilities (for advanced use cases)
-// ============================================================================
-
-export {
-    httpRequest,
-    httpStream,
-    parseNDJSON,
-    parseSSE,
-    buildHeaders,
-    type HttpRequestOptions,
-    type HttpResponse,
-} from './http.js';
-
-// ============================================================================
-// MCP Integration
-// ============================================================================
-
-export {
-    MCPToolBridge,
-    type MCPBridgeConfig,
-    type MCPServerConfig,
-    type MCPTool,
-} from './mcp.js';
-
-// ============================================================================
-// Structured Output
-// ============================================================================
-
-export {
-    StructuredOutputError,
-    type StructuredOutputErrorOptions,
-    type StructuredOutputOptions,
-    type StructuredOutputResult,
-    type StructuredOutputSuccess,
-    type StructuredOutputFailure,
-    type JSONSchema,
-    type SchemaProvider,
-    type ProviderSchema,
-    type SchemaConfig,
-    isStructuredOutputSuccess,
-    isStructuredOutputFailure,
-    // Schema conversion utilities
-    normalizeJsonSchema,
-    convertToProviderSchema,
-    stripUnsupportedFeatures,
-    getJsonSchema,
-    getJsonSchemaFromConfig,
-    // Validation functions
-    parseStructured,
-    tryParseStructured,
-    validateStructuredOutput,
-    stripJsonFences,
-    // Streaming parser
-    StreamingJsonParser,
-    type StreamingStructuredResult,
-} from './structured-output.js';
+/**
+ * Universal LLM Client v3
+ *
+ * A universal LLM client with transparent provider failover,
+ * streaming tool execution, pluggable reasoning, and native observability.
+ *
+ * @module universal-llm-client
+ */
+
+// ============================================================================
+// Public API — The Universal Client
+// ============================================================================
+
+export { AIModel } from './ai-model.js';
+
+// ============================================================================
+// Types & Interfaces
+// ============================================================================
+
+export {
+    // Enums
+    AIModelApiType,
+    AIModelType,
+    // Config
+    type AIModelConfig,
+    type ProviderConfig,
+    type LLMClientOptions,
+    // Messages
+    type LLMChatMessage,
+    type LLMMessageContent,
+    type LLMContentPart,
+    type LLMTextContent,
+    type LLMImageContent,
+    type LLMAudioContent,
+    // Responses
+    type LLMChatResponse,
+    type TokenUsageInfo,
+    // Tools
+    type LLMToolCall,
+    type LLMToolDefinition,
+    type LLMFunction,
+    type ToolHandler,
+    type ToolExecutionResult,
+    type ToolRegistry,
+    type ToolRegistryEntry,
+    // Options
+    type ChatOptions,
+    type ResponseFormat,
+    type OutputOptions,
+    // Thinking / reasoning
+    type ThinkingLevel,
+    // Deep Research (Gemini)
+    type DeepResearchOptions,
+    type DeepResearchResult,
+    type DeepResearchStep,
+    type DeepResearchEvent,
+    // Model info
+    type ModelMetadata,
+    // Helpers
+    textContent,
+    imageContent,
+    multimodalMessage,
+    extractTextContent,
+    hasImages,
+    audioContent,
+    hasAudio,
+} from './interfaces.js';
+
+// ============================================================================
+// Observability
+// ============================================================================
+
+export {
+    type Auditor,
+    type AuditEvent,
+    type AuditEventType,
+    NoopAuditor,
+    ConsoleAuditor,
+    BufferedAuditor,
+} from './auditor.js';
+
+// ============================================================================
+// Stream Decoding
+// ============================================================================
+
+export {
+    type StreamDecoder,
+    type DecodedEvent,
+    type DecoderCallback,
+    type DecoderType,
+    type DecoderOptions,
+    type DecoderFactory,
+    createDecoder,
+    registerDecoder,
+    getRegisteredDecoders,
+    PassthroughDecoder,
+    StandardChatDecoder,
+    InterleavedReasoningDecoder,
+} from './stream-decoder.js';
+
+// ============================================================================
+// Tool Utilities
+// ============================================================================
+
+export {
+    ToolBuilder,
+    ToolExecutor,
+    createTimeTool,
+    createRandomNumberTool,
+} from './tools.js';
+
+// ============================================================================
+// HTTP Utilities (for advanced use cases)
+// ============================================================================
+
+export {
+    httpRequest,
+    httpStream,
+    parseNDJSON,
+    parseSSE,
+    buildHeaders,
+    type HttpRequestOptions,
+    type HttpResponse,
+} from './http.js';
+
+// ============================================================================
+// DiffusionGemma Native Protocol (vLLM without server-side parsers)
+// ============================================================================
+
+export {
+    isGemmaDiffusionModel,
+    parseGemmaDiffusionOutput,
+    gemmaArgsToJson,
+    type GemmaDiffusionParsed,
+    type GemmaParsedToolCall,
+} from './gemma-diffusion.js';
+
+// ============================================================================
+// MCP Integration
+// ============================================================================
+
+export {
+    MCPToolBridge,
+    type MCPBridgeConfig,
+    type MCPServerConfig,
+    type MCPTool,
+} from './mcp.js';
+
+// ============================================================================
+// Structured Output
+// ============================================================================
+
+export {
+    StructuredOutputError,
+    type StructuredOutputErrorOptions,
+    type StructuredOutputOptions,
+    type StructuredOutputResult,
+    type StructuredOutputSuccess,
+    type StructuredOutputFailure,
+    type JSONSchema,
+    type SchemaProvider,
+    type ProviderSchema,
+    type SchemaConfig,
+    isStructuredOutputSuccess,
+    isStructuredOutputFailure,
+    // Schema conversion utilities
+    normalizeJsonSchema,
+    convertToProviderSchema,
+    stripUnsupportedFeatures,
+    getJsonSchema,
+    getJsonSchemaFromConfig,
+    // Validation functions
+    parseStructured,
+    tryParseStructured,
+    validateStructuredOutput,
+    stripJsonFences,
+    // Streaming parser
+    StreamingJsonParser,
+    type StreamingStructuredResult,
+} from './structured-output.js';