universal-llm-client 4.0.0 → 4.1.0

package/dist/structured-output.js

@@ -2,32 +2,31 @@
  * Structured Output Core Types
  *
  * Core types for structured output support in universal-llm-client.
- * Provides type-safe Zod schema integration and JSON Schema support.
+ * Zero-dependency — works with raw JSON Schema and optional validate functions.
+ *
+ * For Zod integration, use the `universal-llm-client/zod` entrypoint.
  *
  * @module structured-output
  */
-import { z } from 'zod';
 /**
  * Custom error class for structured output validation failures.
  *
  * Thrown when:
  * - JSON parsing of LLM response fails
- * - Zod schema validation fails
+ * - Schema validation fails
  *
  * Features:
  * - `rawOutput` property containing the original LLM response
- * - `cause` property for the underlying error (ZodError, SyntaxError, etc.)
+ * - `cause` property for the underlying error
  *
  * @example
  * ```typescript
  * try {
- *   const result = await model.generateStructured(UserSchema, messages);
+ *   const result = await model.generateStructured(schema, messages);
  * } catch (error) {
  *   if (error instanceof StructuredOutputError) {
  *     console.log('Raw LLM output:', error.rawOutput);
- *     if (error.cause instanceof z.ZodError) {
- *       console.log('Validation issues:', error.cause.issues);
- *     }
+ *     console.log('Cause:', error.cause);
  *   }
  * }
  * ```
@@ -35,7 +34,7 @@ import { z } from 'zod';
 export class StructuredOutputError extends Error {
     /** The raw output from the LLM that failed validation */
     rawOutput;
-    /** The underlying cause (e.g., ZodError for schema validation failures) */
+    /** The underlying cause (e.g., validation error) */
     cause;
     constructor(message, options) {
         super(message);
@@ -52,39 +51,12 @@ export class StructuredOutputError extends Error {
 // ============================================================================
 /**
  * Type guard to check if a structured output result is successful.
- *
- * @param result The result to check
- * @returns true if the result is successful
- *
- * @example
- * ```typescript
- * const result = await model.tryParseStructured(UserSchema, messages);
- *
- * if (isStructuredOutputSuccess(result)) {
- *   console.log('User:', result.value.name);
- * } else {
- *   console.log('Error:', result.error.message);
- * }
- * ```
  */
 export function isStructuredOutputSuccess(result) {
     return result.ok === true;
 }
 /**
  * Type guard to check if a structured output result is a failure.
- *
- * @param result The result to check
- * @returns true if the result is a failure
- *
- * @example
- * ```typescript
- * const result = await model.tryParseStructured(UserSchema, messages);
- *
- * if (isStructuredOutputFailure(result)) {
- *   console.log('Error:', result.error.message);
- *   console.log('Raw:', result.rawOutput);
- * }
- * ```
  */
 export function isStructuredOutputFailure(result) {
     return result.ok === false;
@@ -92,36 +64,6 @@ export function isStructuredOutputFailure(result) {
 // ============================================================================
 // Schema Conversion Utilities
 // ============================================================================
-/**
- * Convert a Zod schema to JSON Schema.
- *
- * Uses Zod 4's native `z.toJSONSchema()` for conversion.
- * Handles all Zod types including objects, arrays, primitives, enums, and nested structures.
- *
- * @param schema The Zod schema to convert
- * @returns JSON Schema representation
- *
- * @example
- * ```typescript
- * const UserSchema = z.object({
- *   name: z.string(),
- *   age: z.number(),
- * });
- *
- * const jsonSchema = zodToJsonSchema(UserSchema);
- * // { type: 'object', properties: { name: { type: 'string' }, ... }, required: ['name', 'age'] }
- * ```
- */
-export function zodToJsonSchema(schema) {
-    const result = z.toJSONSchema(schema, {
-        target: 'draft-07',
-        unrepresentable: 'any',
-    });
-    // Cast to our JSONSchema type and clean up
-    const cleanResult = result;
-    delete cleanResult.$schema;
-    return cleanResult;
-}
 /**
  * Normalize a raw JSON Schema.
  *
@@ -136,21 +78,25 @@ export function normalizeJsonSchema(schema) {
     return JSON.parse(JSON.stringify(schema));
 }
 /**
- * Get the JSON Schema from options.
- *
- * Converts Zod schema to JSON Schema if necessary, or normalizes raw JSON Schema.
+ * Get the JSON Schema from a SchemaConfig or StructuredOutputOptions.
  *
  * @param options The structured output options
  * @returns JSON Schema
  */
 export function getJsonSchema(options) {
-    if (options.schema) {
-        return zodToJsonSchema(options.schema);
+    if (options.schemaConfig) {
+        return normalizeJsonSchema(options.schemaConfig.jsonSchema);
     }
     if (options.jsonSchema) {
         return normalizeJsonSchema(options.jsonSchema);
     }
-    throw new Error('Either schema or jsonSchema must be provided');
+    throw new Error('Either schemaConfig or jsonSchema must be provided');
+}
+/**
+ * Get the JSON Schema from a SchemaConfig directly.
+ */
+export function getJsonSchemaFromConfig(config) {
+    return normalizeJsonSchema(config.jsonSchema);
 }
 /**
  * Features that some providers don't support.
@@ -176,18 +122,6 @@ const GOOGLE_UNSUPPORTED_FEATURES = [
  * @param schema The JSON Schema to transform
  * @param provider The target provider
  * @returns Cleaned JSON Schema
- *
- * @example
- * ```typescript
- * const schema = {
- *   type: 'string',
- *   pattern: '^[a-z]+$',
- *   minLength: 1,
- * };
- *
- * const cleaned = stripUnsupportedFeatures(schema, 'google');
- * // { type: 'string' } - pattern and minLength removed
- * ```
  */
 export function stripUnsupportedFeatures(schema, provider) {
     // Only Google needs transformation currently
@@ -208,12 +142,12 @@ export function stripUnsupportedFeatures(schema, provider) {
             }
         }
     }
-    if (result.items) {
-        if (Array.isArray(result.items)) {
-            result.items = result.items.map(item => stripUnsupportedFeatures(item, provider));
+    if (result['items']) {
+        if (Array.isArray(result['items'])) {
+            result['items'] = result['items'].map(item => stripUnsupportedFeatures(item, provider));
         }
         else {
-            result.items = stripUnsupportedFeatures(result.items, provider);
+            result['items'] = stripUnsupportedFeatures(result['items'], provider);
         }
     }
     // Handle oneOf, anyOf, allOf
@@ -232,35 +166,18 @@ export function stripUnsupportedFeatures(schema, provider) {
  * 1. Extracts/converts the JSON Schema from options
  * 2. Applies provider-specific transformations (e.g., removing unsupported features for Google)
  * 3. Adds name/description for LLM guidance
- *
- * @param provider The target provider
- * @param options The structured output options
- * @returns Provider-ready schema with name and description
- *
- * @example
- * ```typescript
- * const result = convertToProviderSchema('openai', {
- *   schema: z.object({ name: z.string() }),
- *   name: 'User',
- *   description: 'A user object',
- * });
- *
- * // result.schema - JSON Schema
- * // result.name - 'User'
- * // result.description - 'A user object'
- * ```
  */
 export function convertToProviderSchema(provider, options) {
-    // Get the JSON Schema (convert from Zod or normalize raw)
+    // Get the JSON Schema
     const jsonSchema = getJsonSchema(options);
     // Apply provider-specific transformations
     const schema = stripUnsupportedFeatures(jsonSchema, provider);
     // Generate a default name if not provided (some providers require it)
-    const name = options.name ?? 'response';
+    const name = options.name ?? options.schemaConfig?.name ?? 'response';
     return {
         schema,
         name,
-        description: options.description,
+        description: options.description ?? options.schemaConfig?.description,
     };
 }
 // ============================================================================
@@ -271,22 +188,15 @@ export function convertToProviderSchema(provider, options) {
  *
  * This function:
  * 1. Parses JSON from the raw output string
- * 2. Validates the parsed data against the Zod schema
+ * 2. Validates using the SchemaConfig's validate function (if provided)
  * 3. Throws StructuredOutputError on failure
  *
- * @param schema The Zod schema to validate against
+ * @param config The schema configuration with optional validator
  * @param rawOutput The raw string output from the LLM
  * @returns The validated and typed data
- * @throws StructuredOutputError if JSON parsing fails or schema validation fails
- *
- * @example
- * ```typescript
- * const schema = z.object({ name: z.string(), age: z.number() });
- * const rawOutput = '{"name": "Alice", "age": 30}';
- * const result = parseStructured(schema, rawOutput); // { name: "Alice", age: 30 }
- * ```
+ * @throws StructuredOutputError if JSON parsing fails or validation fails
  */
-export function parseStructured(schema, rawOutput) {
+export function parseStructured(config, rawOutput) {
     // Step 1: Parse JSON
     let parsed;
     try {
@@ -299,13 +209,18 @@ export function parseStructured(schema, rawOutput) {
             : new SyntaxError(String(error));
         throw new StructuredOutputError(`Failed to parse JSON: ${syntaxError.message}`, { rawOutput, cause: syntaxError });
     }
-    // Step 2: Validate against Zod schema
-    const result = schema.safeParse(parsed);
-    if (!result.success) {
-        // Schema validation failed - throw with ZodError as cause
-        throw new StructuredOutputError(`Validation failed: ${result.error.issues.map((e) => e.message).join(', ')}`, { rawOutput, cause: result.error });
+    // Step 2: Validate if validator is provided
+    if (config.validate) {
+        try {
+            return config.validate(parsed);
+        }
+        catch (error) {
+            const validationError = error instanceof Error ? error : new Error(String(error));
+            throw new StructuredOutputError(`Validation failed: ${validationError.message}`, { rawOutput, cause: validationError });
+        }
     }
-    return result.data;
+    // No validator — return as-is (unsafe cast, user chose to skip validation)
+    return parsed;
 }
 /**
  * Try to parse and validate structured output, returning a result object.
@@ -314,31 +229,13 @@ export function parseStructured(schema, rawOutput) {
  * on validation failure, it returns a result object with `ok: false` and
  * the error details.
  *
- * @param schema The Zod schema to validate against
+ * @param config The schema configuration with optional validator
  * @param rawOutput The raw string output from the LLM
  * @returns A result object: `{ ok: true, value }` on success, `{ ok: false, error, rawOutput }` on failure
- *
- * @example
- * ```typescript
- * const schema = z.object({ name: z.string(), age: z.number() });
- *
- * // Success case
- * const result1 = tryParseStructured(schema, '{"name": "Alice", "age": 30}');
- * if (result1.ok) {
- *   console.log(result1.value.name); // "Alice"
- * }
- *
- * // Failure case
- * const result2 = tryParseStructured(schema, 'invalid json');
- * if (!result2.ok) {
- *   console.log(result2.error.message); // Error message
- *   console.log(result2.rawOutput); // Original output
- * }
- * ```
  */
-export function tryParseStructured(schema, rawOutput) {
+export function tryParseStructured(config, rawOutput) {
     try {
-        const value = parseStructured(schema, rawOutput);
+        const value = parseStructured(config, rawOutput);
         return { ok: true, value };
     }
     catch (error) {
@@ -354,31 +251,28 @@ export function tryParseStructured(schema, rawOutput) {
     }
 }
 /**
- * Validate already-parsed data against a Zod schema.
+ * Validate already-parsed data using a SchemaConfig's validator.
  *
- * This is useful when you have already parsed JSON and need to validate
- * it against a schema, with optional raw output for error messages.
+ * This is useful when you have already parsed JSON and need to validate it.
  *
- * @param schema The Zod schema to validate against
+ * @param config The schema configuration with optional validator
  * @param data The parsed data to validate
  * @param rawOutput Optional raw output string for error messages
  * @returns The validated and typed data
- * @throws StructuredOutputError if schema validation fails
- *
- * @example
- * ```typescript
- * const schema = z.object({ name: z.string(), age: z.number() });
- * const data = JSON.parse('{"name": "Alice", "age": 30}');
- * const result = validateStructuredOutput(schema, data); // { name: "Alice", age: 30 }
- * ```
+ * @throws StructuredOutputError if validation fails
  */
-export function validateStructuredOutput(schema, data, rawOutput) {
-    const result = schema.safeParse(data);
-    if (!result.success) {
-        const rawData = rawOutput ?? JSON.stringify(data);
-        throw new StructuredOutputError(`Validation failed: ${result.error.issues.map((e) => e.message).join(', ')}`, { rawOutput: rawData, cause: result.error });
+export function validateStructuredOutput(config, data, rawOutput) {
+    if (config.validate) {
+        try {
+            return config.validate(data);
+        }
+        catch (error) {
+            const rawData = rawOutput ?? JSON.stringify(data);
+            const validationError = error instanceof Error ? error : new Error(String(error));
+            throw new StructuredOutputError(`Validation failed: ${validationError.message}`, { rawOutput: rawData, cause: validationError });
+        }
     }
-    return result.data;
+    return data;
 }
 // ============================================================================
 // Streaming JSON Parsing
@@ -392,32 +286,30 @@ export function validateStructuredOutput(schema, data, rawOutput) {
  */
 export class StreamingJsonParser {
     buffer = '';
-    schema;
-    constructor(schema) {
-        this.schema = schema;
+    validateFn;
+    constructor(config) {
+        this.validateFn = config.validate;
     }
     /**
      * Feed a chunk of JSON text to the parser.
      * Returns a validated partial object if the current buffer can be parsed
-     * as valid JSON that passes the schema, or undefined if not yet valid.
-     *
-     * For partial objects, this attempts to:
-     * 1. Add closing braces/brackets to make valid JSON
-     * 2. Fill in missing required fields with null/empty values
-     * 3. Validate against schema
-     *
-     * @param chunk Text chunk from the stream
-     * @returns Validated partial object or undefined
+     * as valid JSON that passes validation, or undefined if not yet valid.
      */
     feed(chunk) {
         this.buffer += chunk;
         // Try to parse as complete JSON first
         try {
             const parsed = JSON.parse(this.buffer);
-            const result = this.schema.safeParse(parsed);
-            if (result.success) {
-                return { partial: result.data, complete: true };
+            if (this.validateFn) {
+                try {
+                    const validated = this.validateFn(parsed);
+                    return { partial: validated, complete: true };
+                }
+                catch {
+                    // Validation failed on complete JSON — return parsed but not validated
+                }
             }
+            return { partial: parsed, complete: true };
         }
         catch {
             // Not yet valid complete JSON
@@ -486,10 +378,15 @@ export class StreamingJsonParser {
         const candidate = this.buffer + closing;
         try {
             const parsed = JSON.parse(candidate);
-            const result = this.schema.safeParse(parsed);
-            if (result.success) {
-                return result.data;
+            if (this.validateFn) {
+                try {
+                    return this.validateFn(parsed);
+                }
+                catch {
+                    // Partial validation failed — that's expected for partials
+                }
             }
+            return parsed;
         }
         catch {
             // Silently fail for partial JSON
@@ -497,9 +394,4 @@ export class StreamingJsonParser {
         return undefined;
     }
 }
-// ============================================================================
-// Re-exports for Convenience
-// ============================================================================
-// Re-export Zod for users who need it
-export { z } from 'zod';
 //# sourceMappingURL=structured-output.js.map

package/dist/structured-output.js.map

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

package/dist/zod-adapter.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Zod Adapter for Universal LLM Client
+ *
+ * Optional entrypoint for projects that use Zod for schema validation.
+ * Import from 'universal-llm-client/zod' to use.
+ *
+ * @module universal-llm-client/zod
+ */
+import { z } from 'zod';
+import type { SchemaConfig } from './structured-output.js';
+/**
+ * Create a SchemaConfig from a Zod schema.
+ *
+ * This bridges Zod's type-safe schema definitions to the library's
+ * generic SchemaConfig interface, using Zod 4's native `z.toJSONSchema()`.
+ *
+ * @template T The type inferred from the Zod schema
+ * @param schema The Zod schema
+ * @param options Optional name and description for LLM guidance
+ * @returns SchemaConfig ready for use with generateStructured, etc.
+ *
+ * @example
+ * ```typescript
+ * import { fromZod } from 'universal-llm-client/zod';
+ * import { z } from 'zod';
+ *
+ * const UserSchema = z.object({
+ *   name: z.string(),
+ *   age: z.number(),
+ * });
+ *
+ * const config = fromZod(UserSchema, { name: 'User' });
+ *
+ * const user = await model.generateStructured(config, messages);
+ * // user.name: string, user.age: number (fully typed)
+ * ```
+ */
+export declare function fromZod<T>(schema: z.ZodType<T>, options?: {
+    name?: string;
+    description?: string;
+}): SchemaConfig<T>;
+export { z } from 'zod';
+export type { SchemaConfig } from './structured-output.js';
+//# sourceMappingURL=zod-adapter.d.ts.map

package/dist/zod-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-adapter.d.ts","sourceRoot":"","sources":["../src/zod-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACrB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,YAAY,CAAC,CAAC,CAAC,CAuBjB;AAGD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/zod-adapter.js

@@ -0,0 +1,61 @@
+/**
+ * Zod Adapter for Universal LLM Client
+ *
+ * Optional entrypoint for projects that use Zod for schema validation.
+ * Import from 'universal-llm-client/zod' to use.
+ *
+ * @module universal-llm-client/zod
+ */
+import { z } from 'zod';
+/**
+ * Create a SchemaConfig from a Zod schema.
+ *
+ * This bridges Zod's type-safe schema definitions to the library's
+ * generic SchemaConfig interface, using Zod 4's native `z.toJSONSchema()`.
+ *
+ * @template T The type inferred from the Zod schema
+ * @param schema The Zod schema
+ * @param options Optional name and description for LLM guidance
+ * @returns SchemaConfig ready for use with generateStructured, etc.
+ *
+ * @example
+ * ```typescript
+ * import { fromZod } from 'universal-llm-client/zod';
+ * import { z } from 'zod';
+ *
+ * const UserSchema = z.object({
+ *   name: z.string(),
+ *   age: z.number(),
+ * });
+ *
+ * const config = fromZod(UserSchema, { name: 'User' });
+ *
+ * const user = await model.generateStructured(config, messages);
+ * // user.name: string, user.age: number (fully typed)
+ * ```
+ */
+export function fromZod(schema, options) {
+    // Convert Zod schema to JSON Schema using Zod 4's native method
+    const rawJsonSchema = z.toJSONSchema(schema, {
+        target: 'draft-07',
+        unrepresentable: 'any',
+    });
+    // Clean up — remove $schema since providers don't need it
+    const jsonSchema = { ...rawJsonSchema };
+    delete jsonSchema.$schema;
+    return {
+        jsonSchema: jsonSchema,
+        validate: (data) => {
+            const result = schema.safeParse(data);
+            if (!result.success) {
+                throw result.error;
+            }
+            return result.data;
+        },
+        name: options?.name,
+        description: options?.description,
+    };
+}
+// Re-export z for convenience (users importing from /zod likely want it)
+export { z } from 'zod';
+//# sourceMappingURL=zod-adapter.js.map

package/dist/zod-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-adapter.js","sourceRoot":"","sources":["../src/zod-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,OAAO,CACnB,MAAoB,EACpB,OAAiD;IAEjD,gEAAgE;IAChE,MAAM,aAAa,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE;QACzC,MAAM,EAAE,UAAU;QAClB,eAAe,EAAE,KAAK;KACzB,CAAC,CAAC;IAEH,0DAA0D;IAC1D,MAAM,UAAU,GAAG,EAAE,GAAG,aAAa,EAA6B,CAAC;IACnE,OAAO,UAAU,CAAC,OAAO,CAAC;IAE1B,OAAO;QACH,UAAU,EAAE,UAAyD;QACrE,QAAQ,EAAE,CAAC,IAAa,EAAK,EAAE;YAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,MAAM,CAAC,KAAK,CAAC;YACvB,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC;QACvB,CAAC;QACD,IAAI,EAAE,OAAO,EAAE,IAAI;QACnB,WAAW,EAAE,OAAO,EAAE,WAAW;KACpC,CAAC;AACN,CAAC;AAED,yEAAyE;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-llm-client",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "type": "module",
   "description": "A universal LLM client with transparent provider failover, streaming tool execution, pluggable reasoning, and native observability.",
   "main": "./dist/index.js",
@@ -33,10 +33,15 @@
     "./structured-output": {
       "import": "./dist/structured-output.js",
       "types": "./dist/structured-output.d.ts"
+    },
+    "./zod": {
+      "import": "./dist/zod-adapter.js",
+      "types": "./dist/zod-adapter.d.ts"
     }
   },
   "files": [
     "dist",
+    "src",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -89,6 +94,9 @@
   "peerDependenciesMeta": {
     "@modelcontextprotocol/sdk": {
       "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   },
   "engines": {