@silupanda/schema-bridge 0.2.2

package/dist/providers/openai.js

@@ -0,0 +1,309 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertToOpenAI = convertToOpenAI;
+exports.wrapOpenAIResponseFormat = wrapOpenAIResponseFormat;
+const normalizer_1 = require("../normalizer");
+/**
+ * Keywords that OpenAI strict mode does not support.
+ */
+const UNSUPPORTED_KEYWORDS = [
+    'minimum', 'maximum', 'exclusiveMinimum', 'exclusiveMaximum',
+    'multipleOf', 'minLength', 'maxLength', 'minItems', 'maxItems',
+    'pattern', 'format', 'default', 'examples', '$comment',
+];
+/**
+ * Convert a JSON Schema to OpenAI's structured output format.
+ */
+function convertToOpenAI(schema, options) {
+    const strict = options?.strict !== false;
+    const transformations = [];
+    const warnings = [];
+    let result = (0, normalizer_1.deepClone)(schema);
+    if (strict) {
+        // Inject additionalProperties: false on all objects
+        result = injectAdditionalProperties(result, '$', transformations);
+        // Expand required to include all properties; make optional fields nullable
+        result = expandRequired(result, '$', transformations);
+        // Remove unsupported keywords
+        result = removeUnsupportedKeywords(result, '$', transformations, warnings, options);
+        // Simplify composition keywords
+        result = simplifyComposition(result, '$', transformations, warnings);
+    }
+    return { schema: result, transformations, warnings };
+}
+/**
+ * Wrap a converted schema in OpenAI's response_format envelope.
+ */
+function wrapOpenAIResponseFormat(schema, name, strict = true) {
+    return {
+        type: 'json_schema',
+        json_schema: {
+            name,
+            schema,
+            strict,
+        },
+    };
+}
+function injectAdditionalProperties(node, path, transformations) {
+    const result = { ...node };
+    const isObject = result.type === 'object' || result.properties !== undefined;
+    if (isObject) {
+        if (result.additionalProperties === undefined || result.additionalProperties === true) {
+            const prev = result.additionalProperties;
+            result.additionalProperties = false;
+            transformations.push({
+                type: 'ADDITIONAL_PROPERTIES_INJECTED',
+                path,
+                message: `Set additionalProperties to false (was ${prev === undefined ? 'undefined' : 'true'})`,
+                lossy: false,
+            });
+        }
+        else if (typeof result.additionalProperties === 'object') {
+            result.additionalProperties = false;
+            transformations.push({
+                type: 'ADDITIONAL_PROPERTIES_INJECTED',
+                path,
+                message: 'Replaced additionalProperties schema with false (lossy)',
+                lossy: true,
+            });
+        }
+    }
+    if (result.properties) {
+        const newProps = {};
+        for (const [key, prop] of Object.entries(result.properties)) {
+            newProps[key] = injectAdditionalProperties(prop, `${path}.properties.${key}`, transformations);
+        }
+        result.properties = newProps;
+    }
+    if (result.items && !Array.isArray(result.items)) {
+        result.items = injectAdditionalProperties(result.items, `${path}.items`, transformations);
+    }
+    if (result.anyOf) {
+        result.anyOf = result.anyOf.map((s, i) => injectAdditionalProperties(s, `${path}.anyOf[${i}]`, transformations));
+    }
+    if (result.oneOf) {
+        result.oneOf = result.oneOf.map((s, i) => injectAdditionalProperties(s, `${path}.oneOf[${i}]`, transformations));
+    }
+    if (result.allOf) {
+        result.allOf = result.allOf.map((s, i) => injectAdditionalProperties(s, `${path}.allOf[${i}]`, transformations));
+    }
+    if (result.$defs) {
+        const newDefs = {};
+        for (const [key, def] of Object.entries(result.$defs)) {
+            newDefs[key] = injectAdditionalProperties(def, `${path}.$defs.${key}`, transformations);
+        }
+        result.$defs = newDefs;
+    }
+    return result;
+}
+function expandRequired(node, path, transformations) {
+    const result = { ...node };
+    if (result.properties) {
+        const required = new Set(result.required || []);
+        const newProps = {};
+        for (const [key, prop] of Object.entries(result.properties)) {
+            let processed = expandRequired(prop, `${path}.properties.${key}`, transformations);
+            if (!required.has(key)) {
+                required.add(key);
+                processed = makeNullable(processed);
+                transformations.push({
+                    type: 'REQUIRED_EXPANDED',
+                    path: `${path}.properties.${key}`,
+                    message: `Added "${key}" to required array and made nullable`,
+                    lossy: false,
+                });
+            }
+            newProps[key] = processed;
+        }
+        result.properties = newProps;
+        result.required = Array.from(required);
+    }
+    if (result.items && !Array.isArray(result.items)) {
+        result.items = expandRequired(result.items, `${path}.items`, transformations);
+    }
+    if (result.anyOf) {
+        result.anyOf = result.anyOf.map((s, i) => expandRequired(s, `${path}.anyOf[${i}]`, transformations));
+    }
+    if (result.$defs) {
+        const newDefs = {};
+        for (const [key, def] of Object.entries(result.$defs)) {
+            newDefs[key] = expandRequired(def, `${path}.$defs.${key}`, transformations);
+        }
+        result.$defs = newDefs;
+    }
+    return result;
+}
+function makeNullable(schema) {
+    const result = { ...schema };
+    // Already nullable
+    if (Array.isArray(result.type) && result.type.includes('null')) {
+        return result;
+    }
+    if (result.anyOf) {
+        // Check if already has null option
+        const hasNull = result.anyOf.some(s => s.type === 'null');
+        if (!hasNull) {
+            result.anyOf = [...result.anyOf, { type: 'null' }];
+        }
+        return result;
+    }
+    if (result.oneOf) {
+        const hasNull = result.oneOf.some(s => s.type === 'null');
+        if (!hasNull) {
+            result.oneOf = [...result.oneOf, { type: 'null' }];
+        }
+        return result;
+    }
+    if (typeof result.type === 'string') {
+        result.type = [result.type, 'null'];
+        return result;
+    }
+    if (Array.isArray(result.type)) {
+        if (!result.type.includes('null')) {
+            result.type = [...result.type, 'null'];
+        }
+        return result;
+    }
+    // No type specified, wrap in anyOf with null
+    return {
+        anyOf: [result, { type: 'null' }],
+    };
+}
+function removeUnsupportedKeywords(node, path, transformations, warnings, options) {
+    const result = { ...node };
+    const promote = options?.promoteConstraintsToDescription ?? false;
+    for (const keyword of UNSUPPORTED_KEYWORDS) {
+        if (keyword in result) {
+            const value = result[keyword];
+            if (promote && keyword !== '$comment' && keyword !== 'examples') {
+                const constraint = `${keyword}: ${JSON.stringify(value)}`;
+                result.description = result.description
+                    ? `${result.description} (${constraint})`
+                    : `(${constraint})`;
+            }
+            delete result[keyword];
+            transformations.push({
+                type: 'KEYWORD_REMOVED',
+                path,
+                message: `Removed unsupported keyword "${keyword}" (value: ${JSON.stringify(value)})`,
+                lossy: true,
+            });
+            warnings.push(`Removed "${keyword}" at ${path} — OpenAI strict mode does not support this keyword`);
+        }
+    }
+    if (result.properties) {
+        const newProps = {};
+        for (const [key, prop] of Object.entries(result.properties)) {
+            newProps[key] = removeUnsupportedKeywords(prop, `${path}.properties.${key}`, transformations, warnings, options);
+        }
+        result.properties = newProps;
+    }
+    if (result.items && !Array.isArray(result.items)) {
+        result.items = removeUnsupportedKeywords(result.items, `${path}.items`, transformations, warnings, options);
+    }
+    if (result.anyOf) {
+        result.anyOf = result.anyOf.map((s, i) => removeUnsupportedKeywords(s, `${path}.anyOf[${i}]`, transformations, warnings, options));
+    }
+    if (result.oneOf) {
+        result.oneOf = result.oneOf.map((s, i) => removeUnsupportedKeywords(s, `${path}.oneOf[${i}]`, transformations, warnings, options));
+    }
+    if (result.allOf) {
+        result.allOf = result.allOf.map((s, i) => removeUnsupportedKeywords(s, `${path}.allOf[${i}]`, transformations, warnings, options));
+    }
+    if (result.$defs) {
+        const newDefs = {};
+        for (const [key, def] of Object.entries(result.$defs)) {
+            newDefs[key] = removeUnsupportedKeywords(def, `${path}.$defs.${key}`, transformations, warnings, options);
+        }
+        result.$defs = newDefs;
+    }
+    return result;
+}
+function simplifyComposition(node, path, transformations, warnings) {
+    let result = { ...node };
+    // Simplify allOf by merging
+    if (result.allOf && result.allOf.length > 0) {
+        let merged = {};
+        for (const sub of result.allOf) {
+            merged = mergeSchemas(merged, sub);
+        }
+        // Copy merged properties to result
+        const { allOf: _, ...rest } = result;
+        result = { ...rest, ...merged };
+        transformations.push({
+            type: 'COMPOSITION_SIMPLIFIED',
+            path,
+            message: 'Merged allOf schemas into single schema',
+            lossy: false,
+        });
+    }
+    // Convert oneOf to anyOf
+    if (result.oneOf) {
+        result.anyOf = result.oneOf;
+        delete result.oneOf;
+        transformations.push({
+            type: 'COMPOSITION_SIMPLIFIED',
+            path,
+            message: 'Converted oneOf to anyOf',
+            lossy: false,
+        });
+    }
+    // Remove not
+    if (result.not) {
+        delete result.not;
+        transformations.push({
+            type: 'COMPOSITION_SIMPLIFIED',
+            path,
+            message: 'Removed "not" keyword (not supported)',
+            lossy: true,
+        });
+        warnings.push(`Removed "not" at ${path} — cannot be represented in OpenAI strict mode`);
+    }
+    // Recurse
+    if (result.properties) {
+        const newProps = {};
+        for (const [key, prop] of Object.entries(result.properties)) {
+            newProps[key] = simplifyComposition(prop, `${path}.properties.${key}`, transformations, warnings);
+        }
+        result.properties = newProps;
+    }
+    if (result.items && !Array.isArray(result.items)) {
+        result.items = simplifyComposition(result.items, `${path}.items`, transformations, warnings);
+    }
+    if (result.anyOf) {
+        result.anyOf = result.anyOf.map((s, i) => simplifyComposition(s, `${path}.anyOf[${i}]`, transformations, warnings));
+    }
+    if (result.$defs) {
+        const newDefs = {};
+        for (const [key, def] of Object.entries(result.$defs)) {
+            newDefs[key] = simplifyComposition(def, `${path}.$defs.${key}`, transformations, warnings);
+        }
+        result.$defs = newDefs;
+    }
+    return result;
+}
+function mergeSchemas(a, b) {
+    const result = { ...a };
+    if (b.type)
+        result.type = b.type;
+    if (b.description)
+        result.description = b.description;
+    if (b.properties) {
+        result.properties = { ...(result.properties || {}), ...b.properties };
+    }
+    if (b.required) {
+        const reqSet = new Set([...(result.required || []), ...b.required]);
+        result.required = Array.from(reqSet);
+    }
+    if (b.additionalProperties !== undefined) {
+        result.additionalProperties = b.additionalProperties;
+    }
+    // Copy other keys from b that aren't in result
+    for (const key of Object.keys(b)) {
+        if (!(key in result)) {
+            result[key] = b[key];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,19 @@
+import type { Provider, ConvertOptions, ToolDefinitionInput, ToolDefinition, TransformationRecord } from './types';
+/**
+ * Create a provider-specific tool definition from a generic tool definition.
+ */
+export declare function createTool(tool: ToolDefinitionInput, provider: Provider, options?: ConvertOptions): {
+    tool: ToolDefinition;
+    transformations: TransformationRecord[];
+    warnings: string[];
+};
+/**
+ * Create tool definitions for multiple tools for a specific provider.
+ * For Gemini, wraps all tools in a single functionDeclarations object.
+ */
+export declare function createTools(tools: ToolDefinitionInput[], provider: Provider, options?: ConvertOptions): {
+    tools: ToolDefinition[];
+    transformations: TransformationRecord[][];
+    warnings: string[][];
+};
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,cAAc,EAQd,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,eAAe,EAAE,oBAAoB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAyCvF;AAwED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,mBAAmB,EAAE,EAC5B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,eAAe,EAAE,oBAAoB,EAAE,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,CAkB9F"}

package/dist/tool.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTool = createTool;
+exports.createTools = createTools;
+const providers_1 = require("./providers");
+const normalizer_1 = require("./normalizer");
+/**
+ * Create a provider-specific tool definition from a generic tool definition.
+ */
+function createTool(tool, provider, options) {
+    // Validate tool name
+    if (!/^[a-zA-Z0-9_-]+$/.test(tool.name)) {
+        throw new TypeError(`Invalid tool name "${tool.name}": must contain only alphanumeric characters, underscores, and hyphens`);
+    }
+    const converter = (0, providers_1.getConverter)(provider);
+    // Normalize and resolve refs first for providers that need inlining
+    let inputSchema = (0, normalizer_1.normalize)(tool.schema);
+    const allTransformations = [];
+    const allWarnings = [];
+    // For providers with limited $ref support, inline refs
+    const preserveRefs = provider === 'openai' || provider === 'anthropic' || provider === 'mcp' || provider === 'gemini';
+    const { schema: resolvedSchema, transformations: refTransforms } = (0, normalizer_1.resolveRefs)(inputSchema, {
+        maxRecursionDepth: options?.maxRecursionDepth,
+        preserveRefs,
+    });
+    inputSchema = resolvedSchema;
+    allTransformations.push(...refTransforms);
+    // Apply provider-specific conversion
+    const { schema: convertedSchema, transformations, warnings } = converter(inputSchema, options);
+    allTransformations.push(...transformations);
+    allWarnings.push(...warnings);
+    // Build provider-specific tool envelope
+    const toolDef = buildToolEnvelope(tool, convertedSchema, provider, options);
+    // Handle output schema for MCP
+    if (provider === 'mcp' && tool.outputSchema) {
+        const outNormalized = (0, normalizer_1.normalize)(tool.outputSchema);
+        const { schema: outResolved } = (0, normalizer_1.resolveRefs)(outNormalized, { preserveRefs: true });
+        const { schema: outConverted } = converter(outResolved, options);
+        toolDef.outputSchema = outConverted;
+    }
+    return { tool: toolDef, transformations: allTransformations, warnings: allWarnings };
+}
+function buildToolEnvelope(tool, schema, provider, options) {
+    const strict = options?.strict !== false;
+    switch (provider) {
+        case 'openai':
+            return {
+                type: 'function',
+                function: {
+                    name: tool.name,
+                    description: tool.description,
+                    parameters: schema,
+                    strict,
+                },
+            };
+        case 'anthropic':
+            return {
+                name: tool.name,
+                description: tool.description,
+                input_schema: schema,
+            };
+        case 'gemini':
+            return {
+                name: tool.name,
+                description: tool.description,
+                parameters: schema,
+            };
+        case 'cohere':
+            return {
+                type: 'function',
+                function: {
+                    name: tool.name,
+                    description: tool.description,
+                    parameters: schema,
+                },
+            };
+        case 'mcp':
+            return {
+                name: tool.name,
+                description: tool.description,
+                inputSchema: schema,
+            };
+        case 'ollama':
+            return {
+                name: tool.name,
+                description: tool.description,
+                format: schema,
+            };
+        case 'vercel-ai':
+            return {
+                name: tool.name,
+                description: tool.description,
+                parameters: schema,
+            };
+        default:
+            throw new Error(`Unsupported provider for tool definition: "${provider}"`);
+    }
+}
+/**
+ * Create tool definitions for multiple tools for a specific provider.
+ * For Gemini, wraps all tools in a single functionDeclarations object.
+ */
+function createTools(tools, provider, options) {
+    const results = tools.map(tool => createTool(tool, provider, options));
+    if (provider === 'gemini') {
+        // Wrap in functionDeclarations array
+        const declarations = results.map(r => r.tool);
+        return {
+            tools: [{ functionDeclarations: declarations }],
+            transformations: results.map(r => r.transformations),
+            warnings: results.map(r => r.warnings),
+        };
+    }
+    return {
+        tools: results.map(r => r.tool),
+        transformations: results.map(r => r.transformations),
+        warnings: results.map(r => r.warnings),
+    };
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Supported LLM provider names.
+ */
+export type Provider = 'openai' | 'anthropic' | 'gemini' | 'cohere' | 'mcp' | 'vercel-ai' | 'ollama';
+/**
+ * Recursive JSON Schema type supporting draft-07 and draft-2020-12 keywords.
+ */
+export interface JSONSchema {
+    type?: string | string[];
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema | JSONSchema[];
+    prefixItems?: JSONSchema[];
+    additionalProperties?: boolean | JSONSchema;
+    enum?: unknown[];
+    const?: unknown;
+    anyOf?: JSONSchema[];
+    oneOf?: JSONSchema[];
+    allOf?: JSONSchema[];
+    not?: JSONSchema;
+    $ref?: string;
+    $defs?: Record<string, JSONSchema>;
+    definitions?: Record<string, JSONSchema>;
+    $schema?: string;
+    $comment?: string;
+    title?: string;
+    description?: string;
+    default?: unknown;
+    examples?: unknown[];
+    format?: string;
+    pattern?: string;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+    nullable?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Options for the convert function.
+ */
+export interface ConvertOptions {
+    /** Schema name (used in OpenAI response_format envelope). */
+    name?: string;
+    /** Schema description. */
+    description?: string;
+    /** Enable strict mode for providers that support it (default: true for OpenAI). */
+    strict?: boolean;
+    /** Append removed constraints to description fields. */
+    promoteConstraintsToDescription?: boolean;
+    /** Maximum recursion depth for inlining recursive $ref (default: 5). */
+    maxRecursionDepth?: number;
+}
+/**
+ * Result of converting a schema for a provider.
+ */
+export interface ProviderSchema {
+    /** The transformed schema in the provider's expected format. */
+    schema: JSONSchema;
+    /** Transformations applied during conversion. */
+    transformations: TransformationRecord[];
+    /** Warnings about lossy conversions. */
+    warnings: string[];
+}
+/**
+ * A record of a single transformation applied during conversion.
+ */
+export interface TransformationRecord {
+    /** Type of transformation. */
+    type: TransformationType;
+    /** JSON path where the transformation was applied. */
+    path: string;
+    /** Human-readable description. */
+    message: string;
+    /** Whether the transformation is lossy. */
+    lossy: boolean;
+}
+/**
+ * Types of transformations that can be applied.
+ */
+export type TransformationType = 'REF_INLINED' | 'ADDITIONAL_PROPERTIES_INJECTED' | 'REQUIRED_EXPANDED' | 'FIELD_MADE_NULLABLE' | 'KEYWORD_REMOVED' | 'COMPOSITION_SIMPLIFIED' | 'DEFAULT_REMOVED' | 'RECURSIVE_SCHEMA_TRUNCATED';
+/**
+ * Tool definition input (provider-agnostic).
+ */
+export interface ToolDefinitionInput {
+    name: string;
+    description: string;
+    schema: JSONSchema;
+    outputSchema?: JSONSchema;
+}
+/**
+ * Provider-specific tool definition output.
+ */
+export type ToolDefinition = OpenAIToolDefinition | AnthropicToolDefinition | GeminiToolDefinition | CohereToolDefinition | MCPToolDefinition | OllamaToolDefinition | GenericToolDefinition;
+export interface OpenAIToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: JSONSchema;
+        strict?: boolean;
+    };
+}
+export interface AnthropicToolDefinition {
+    name: string;
+    description: string;
+    input_schema: JSONSchema;
+}
+export interface GeminiToolDefinition {
+    name: string;
+    description: string;
+    parameters: JSONSchema;
+}
+export interface CohereToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: JSONSchema;
+    };
+}
+export interface MCPToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+    outputSchema?: JSONSchema;
+}
+export interface OllamaToolDefinition {
+    name: string;
+    description: string;
+    format: JSONSchema;
+}
+export interface GenericToolDefinition {
+    name: string;
+    description: string;
+    parameters: JSONSchema;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}