@jsonstudio/llms 0.4.3 → 0.4.5

package/dist/conversion/shared/bridge-policies.js

@@ -0,0 +1,276 @@
+import { RESPONSES_INSTRUCTIONS_REASONING_FIELD } from './reasoning-normalizer.js';
+const OPENAI_CHAT_ALLOWED_FIELDS = [
+    'messages',
+    'tools',
+    'tool_outputs',
+    'model',
+    'temperature',
+    'top_p',
+    'top_k',
+    'max_tokens',
+    'frequency_penalty',
+    'presence_penalty',
+    'logit_bias',
+    'response_format',
+    'parallel_tool_calls',
+    'tool_choice',
+    'seed',
+    'user',
+    'metadata',
+    'stop',
+    'stop_sequences',
+    'stream'
+];
+const ANTHROPIC_ALLOWED_FIELDS = [
+    'model',
+    'messages',
+    'tools',
+    'system',
+    'stop_sequences',
+    'temperature',
+    'top_p',
+    'top_k',
+    'max_tokens',
+    'max_output_tokens',
+    'metadata',
+    'stream',
+    'tool_choice'
+];
+const RESPONSES_ALLOWED_FIELDS = [
+    'id',
+    'object',
+    'created_at',
+    'model',
+    'status',
+    'input',
+    'instructions',
+    'output',
+    'output_text',
+    'required_action',
+    'response_id',
+    'previous_response_id',
+    'tool_outputs',
+    'tools',
+    'metadata',
+    'include',
+    'store',
+    'user',
+    'response_format',
+    'temperature',
+    'top_p',
+    'top_k',
+    'max_tokens',
+    'max_output_tokens',
+    'logit_bias',
+    'seed',
+    'parallel_tool_calls',
+    'tool_choice',
+    'stream',
+    'instructions_is_raw'
+];
+const GEMINI_ALLOWED_FIELDS = [
+    'model',
+    'contents',
+    'systemInstruction',
+    'system_instruction',
+    'generationConfig',
+    'generation_config',
+    'safetySettings',
+    'safety_settings',
+    'metadata',
+    'toolConfig',
+    'tool_config',
+    'tools',
+    'tool_choice',
+    'parallelToolCalls',
+    'parallel_tool_calls',
+    'responseMimeType',
+    'response_mime_type',
+    'stopSequences',
+    'stop_sequences',
+    'cachedContent',
+    'prompt',
+    'response',
+    'candidates',
+    'usageMetadata',
+    'responseMetadata',
+    'promptFeedback',
+    'modelVersion',
+    'client',
+    'user',
+    'stream'
+];
+function reasoningAction(idPrefix) {
+    return {
+        name: 'reasoning.extract',
+        options: {
+            dropFromContent: true,
+            idPrefix
+        }
+    };
+}
+const RESPONSES_POLICY = {
+    id: 'openai-responses-default',
+    protocol: 'openai-responses',
+    request: {
+        inbound: [
+            {
+                name: 'messages.inject-system-instruction',
+                options: {
+                    field: 'instructions',
+                    reasoningField: RESPONSES_INSTRUCTIONS_REASONING_FIELD
+                }
+            },
+            { name: 'messages.ensure-system-instruction' },
+            reasoningAction('responses_reasoning'),
+            { name: 'tools.ensure-placeholders' },
+            { name: 'metadata.extra-fields', options: { allowedKeys: RESPONSES_ALLOWED_FIELDS } },
+            { name: 'metadata.provider-field', options: { field: 'metadata', target: 'providerMetadata' } },
+            { name: 'metadata.provider-sentinel', options: { sentinel: '__rcc_provider_metadata', target: 'providerMetadata' } }
+        ],
+        outbound: [
+            { name: 'messages.normalize-history' },
+            { name: 'tools.capture-results' },
+            { name: 'tools.ensure-placeholders' },
+            { name: 'messages.ensure-output-fields', options: { toolFallback: 'Tool call completed (no output).' } },
+            { name: 'messages.ensure-system-instruction' },
+            reasoningAction('responses_reasoning'),
+            { name: 'metadata.extra-fields', options: { allowedKeys: RESPONSES_ALLOWED_FIELDS } },
+            { name: 'metadata.provider-field', options: { field: 'metadata', target: 'providerMetadata' } },
+            { name: 'metadata.provider-sentinel', options: { sentinel: '__rcc_provider_metadata', target: 'providerMetadata' } }
+        ]
+    },
+    response: {
+        inbound: [
+            { name: 'reasoning.attach-output' },
+            reasoningAction('responses_reasoning'),
+            { name: 'metadata.extra-fields', options: { allowedKeys: RESPONSES_ALLOWED_FIELDS } }
+        ],
+        outbound: [
+            reasoningAction('responses_reasoning'),
+            { name: 'metadata.extra-fields', options: { allowedKeys: RESPONSES_ALLOWED_FIELDS } }
+        ]
+    }
+};
+const OPENAI_CHAT_POLICY = {
+    id: 'openai-chat-default',
+    protocol: 'openai-chat',
+    request: {
+        inbound: [
+            reasoningAction('openai_chat_reasoning'),
+            { name: 'messages.ensure-system-instruction' },
+            { name: 'metadata.system-sentinel', options: { sentinel: '__rcc_raw_system', target: 'rawSystem' } },
+            { name: 'metadata.extra-fields', options: { allowedKeys: OPENAI_CHAT_ALLOWED_FIELDS } },
+            { name: 'metadata.provider-field', options: { field: 'metadata', target: 'providerMetadata' } },
+            { name: 'metadata.provider-sentinel', options: { sentinel: '__rcc_provider_metadata', target: 'providerMetadata' } }
+        ],
+        outbound: [
+            { name: 'messages.normalize-history' },
+            { name: 'tools.capture-results' },
+            { name: 'tools.ensure-placeholders' },
+            { name: 'messages.ensure-output-fields', options: { toolFallback: 'Tool call completed (no output).' } },
+            { name: 'messages.ensure-system-instruction' },
+            reasoningAction('openai_chat_reasoning'),
+            { name: 'metadata.system-sentinel', options: { sentinel: '__rcc_raw_system', target: 'rawSystem' } },
+            { name: 'metadata.extra-fields', options: { allowedKeys: OPENAI_CHAT_ALLOWED_FIELDS } },
+            { name: 'metadata.provider-field', options: { field: 'metadata', target: 'providerMetadata' } },
+            { name: 'metadata.provider-sentinel', options: { sentinel: '__rcc_provider_metadata', target: 'providerMetadata' } }
+        ]
+    },
+    response: {
+        inbound: [
+            reasoningAction('openai_chat_reasoning'),
+            { name: 'metadata.extra-fields', options: { allowedKeys: OPENAI_CHAT_ALLOWED_FIELDS } }
+        ],
+        outbound: [
+            reasoningAction('openai_chat_reasoning'),
+            { name: 'metadata.extra-fields', options: { allowedKeys: OPENAI_CHAT_ALLOWED_FIELDS } }
+        ]
+    }
+};
+const ANTHROPIC_POLICY = {
+    id: 'anthropic-messages-default',
+    protocol: 'anthropic-messages',
+    request: {
+        inbound: [
+            reasoningAction('anthropic_reasoning'),
+            { name: 'messages.ensure-system-instruction' },
+            { name: 'metadata.extra-fields', options: { allowedKeys: ANTHROPIC_ALLOWED_FIELDS } }
+        ],
+        outbound: [
+            { name: 'messages.normalize-history' },
+            { name: 'tools.capture-results' },
+            { name: 'tools.ensure-placeholders' },
+            { name: 'messages.ensure-output-fields', options: { toolFallback: 'Tool call completed (no output).' } },
+            { name: 'messages.ensure-system-instruction' },
+            reasoningAction('anthropic_reasoning'),
+            { name: 'metadata.extra-fields', options: { allowedKeys: ANTHROPIC_ALLOWED_FIELDS } }
+        ]
+    },
+    response: {
+        inbound: [
+            reasoningAction('anthropic_reasoning'),
+            { name: 'metadata.extra-fields', options: { allowedKeys: ANTHROPIC_ALLOWED_FIELDS } }
+        ],
+        outbound: [
+            reasoningAction('anthropic_reasoning'),
+            { name: 'metadata.extra-fields', options: { allowedKeys: ANTHROPIC_ALLOWED_FIELDS } }
+        ]
+    }
+};
+const GEMINI_POLICY = {
+    id: 'gemini-chat-default',
+    protocol: 'gemini-chat',
+    request: {
+        inbound: [
+            reasoningAction('gemini_reasoning'),
+            { name: 'messages.ensure-system-instruction' },
+            { name: 'metadata.extra-fields', options: { allowedKeys: GEMINI_ALLOWED_FIELDS } }
+        ],
+        outbound: [
+            { name: 'messages.normalize-history' },
+            { name: 'tools.capture-results' },
+            { name: 'tools.ensure-placeholders' },
+            { name: 'messages.ensure-output-fields', options: { toolFallback: 'Tool call completed (no output).' } },
+            { name: 'messages.ensure-system-instruction' },
+            reasoningAction('gemini_reasoning'),
+            { name: 'metadata.extra-fields', options: { allowedKeys: GEMINI_ALLOWED_FIELDS } }
+        ]
+    },
+    response: {
+        inbound: [
+            reasoningAction('gemini_reasoning'),
+            { name: 'metadata.extra-fields', options: { allowedKeys: GEMINI_ALLOWED_FIELDS } }
+        ],
+        outbound: [
+            reasoningAction('gemini_reasoning'),
+            { name: 'metadata.extra-fields', options: { allowedKeys: GEMINI_ALLOWED_FIELDS } }
+        ]
+    }
+};
+const POLICIES = [RESPONSES_POLICY, OPENAI_CHAT_POLICY, ANTHROPIC_POLICY, GEMINI_POLICY];
+export function resolveBridgePolicy(options) {
+    if (!options)
+        return undefined;
+    const { protocol, moduleType } = options;
+    if (protocol) {
+        const match = POLICIES.find((policy) => policy.protocol === protocol);
+        if (match)
+            return match;
+    }
+    if (moduleType) {
+        const match = POLICIES.find((policy) => policy.moduleType === moduleType);
+        if (match)
+            return match;
+    }
+    return undefined;
+}
+export function resolvePolicyActions(policy, stage) {
+    if (!policy)
+        return undefined;
+    const [phaseKey, directionKey] = stage.split('_');
+    const phase = policy[phaseKey];
+    if (!phase)
+        return undefined;
+    return phase[directionKey];
+}

package/dist/conversion/shared/bridge-request-adapter.d.ts

@@ -0,0 +1,28 @@
+import type { BridgeInputItem, BridgeToolDefinition } from './bridge-message-types.js';
+export interface ResponsesRequestContext {
+    requestId?: string;
+    instructions?: string;
+    originalSystemMessages?: string[];
+    input?: BridgeInputItem[];
+    include?: unknown;
+    store?: unknown;
+    toolChoice?: unknown;
+    parallelToolCalls?: boolean;
+    metadata?: Record<string, unknown>;
+    responseFormat?: unknown;
+    toolsRaw?: BridgeToolDefinition[];
+    stream?: boolean;
+    instructionsIsRaw?: boolean;
+    isChatPayload?: boolean;
+    isResponsesPayload?: boolean;
+}
+export interface BuildChatRequestResult {
+    request: Record<string, unknown>;
+    toolsNormalized?: Array<Record<string, unknown>>;
+}
+export declare function captureResponsesContext(payload: Record<string, unknown>, dto?: {
+    route?: {
+        requestId?: string;
+    };
+}): ResponsesRequestContext;
+export declare function buildChatRequestFromResponses(payload: Record<string, unknown>, context: ResponsesRequestContext): BuildChatRequestResult;