@jsonstudio/llms 0.4.3 → 0.4.5

package/dist/conversion/hub/semantic-mappers/anthropic-mapper.js

@@ -1,5 +1,9 @@
 import { isJsonObject, jsonClone } from '../types/json.js';
 import { buildOpenAIChatFromAnthropic, buildAnthropicRequestFromOpenAIChat } from '../../codecs/anthropic-openai-codec.js';
+import { createBridgeActionState, runBridgeActionPipeline } from '../../shared/bridge-actions.js';
+import { resolveBridgePolicy, resolvePolicyActions } from '../../shared/bridge-policies.js';
+import { encodeMetadataPassthrough, extractMetadataPassthrough } from '../../shared/metadata-passthrough.js';
+import { mapAnthropicToolsToChat } from '../../shared/anthropic-message-utils.js';
 const ANTHROPIC_PARAMETER_KEYS = [
     'model',
     'temperature',
@@ -28,55 +32,6 @@ const ANTHROPIC_TOP_LEVEL_FIELDS = new Set([
 ]);
 const PASSTHROUGH_METADATA_PREFIX = 'rcc_passthrough_';
 const PASSTHROUGH_PARAMETERS = ['tool_choice'];
-function encodePassthroughParameters(chat) {
-    if (!chat.parameters)
-        return undefined;
-    const encoded = {};
-    for (const key of PASSTHROUGH_PARAMETERS) {
-        const value = chat.parameters[key];
-        if (value === undefined)
-            continue;
-        try {
-            encoded[`${PASSTHROUGH_METADATA_PREFIX}${key}`] = JSON.stringify(value);
-        }
-        catch {
-            continue;
-        }
-    }
-    return Object.keys(encoded).length ? encoded : undefined;
-}
-function extractPassthroughParameters(metadataField) {
-    if (!isJsonObject(metadataField))
-        return {};
-    const cloned = jsonClone(metadataField);
-    const passthrough = {};
-    let metadataMutated = false;
-    let hasPassthrough = false;
-    for (const key of Object.keys(cloned)) {
-        if (!key.startsWith(PASSTHROUGH_METADATA_PREFIX))
-            continue;
-        const paramKey = key.slice(PASSTHROUGH_METADATA_PREFIX.length);
-        if (!PASSTHROUGH_PARAMETERS.includes(paramKey))
-            continue;
-        const rawValue = cloned[key];
-        if (typeof rawValue !== 'string')
-            continue;
-        try {
-            const parsed = rawValue ? JSON.parse(rawValue) : undefined;
-            passthrough[paramKey] = parsed;
-            delete cloned[key];
-            metadataMutated = true;
-            hasPassthrough = true;
-        }
-        catch {
-            continue;
-        }
-    }
-    return {
-        metadata: metadataMutated ? (Object.keys(cloned).length ? cloned : undefined) : cloned,
-        passthrough: hasPassthrough ? passthrough : undefined
-    };
-}
 function collectParameters(payload) {
     const params = {};
     for (const key of ANTHROPIC_PARAMETER_KEYS) {
@@ -89,34 +44,6 @@ function collectParameters(payload) {
     }
     return Object.keys(params).length ? params : undefined;
 }
-function normalizeAnthropicTools(rawTools, missing) {
-    if (!Array.isArray(rawTools) || rawTools.length === 0)
-        return undefined;
-    const tools = [];
-    rawTools.forEach((entry, index) => {
-        if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
-            missing.push({ path: `tools[${index}]`, reason: 'invalid_entry', originalValue: jsonClone(entry) });
-            return;
-        }
-        const nameValue = entry.name;
-        if (typeof nameValue !== 'string' || !nameValue.trim())
-            return;
-        const desc = entry.description;
-        const schema = entry.input_schema;
-        const parameters = schema && typeof schema === 'object' && !Array.isArray(schema)
-            ? schema
-            : { type: 'object', properties: {} };
-        tools.push({
-            type: 'function',
-            function: {
-                name: nameValue,
-                description: typeof desc === 'string' ? desc : undefined,
-                parameters
-            }
-        });
-    });
-    return tools.length ? tools : undefined;
-}
 function normalizeToolContent(content) {
     if (typeof content === 'string')
         return content;
@@ -149,43 +76,6 @@ function collectToolOutputsFromMessages(messages, missing) {
     });
     return outputs.length ? outputs : undefined;
 }
-function collectExtraFields(payload) {
-    const extras = {};
-    for (const key of Object.keys(payload)) {
-        if (ANTHROPIC_TOP_LEVEL_FIELDS.has(key))
-            continue;
-        extras[key] = payload[key];
-    }
-    return Object.keys(extras).length ? extras : undefined;
-}
-function collectSystemSegments(systemField) {
-    if (!systemField)
-        return [];
-    const flatten = (value) => {
-        if (typeof value === 'string')
-            return value;
-        if (Array.isArray(value)) {
-            return value.map(v => flatten(v)).filter(Boolean).join('\n');
-        }
-        if (value && typeof value === 'object') {
-            const obj = value;
-            if (typeof obj.text === 'string')
-                return obj.text;
-            if (typeof obj.content === 'string')
-                return obj.content;
-            if (Array.isArray(obj.content))
-                return obj.content.map(v => flatten(v)).join('\n');
-        }
-        return '';
-    };
-    const text = flatten(systemField).trim();
-    return text ? [text] : [];
-}
-function systemSegmentsToAnthropicBlocks(segments) {
-    if (!segments || !segments.length)
-        return undefined;
-    return segments.map(seg => ({ type: 'text', text: seg }));
-}
 export class AnthropicSemanticMapper {
     async toChat(format, ctx) {
         const payload = (format.payload ?? {});
@@ -194,38 +84,55 @@ export class AnthropicSemanticMapper {
             missing.push({ path: 'messages', reason: 'absent' });
         if (typeof payload.model !== 'string')
             missing.push({ path: 'model', reason: 'absent' });
-        const { messages } = buildOpenAIChatFromAnthropic(payload);
+        const openaiPayload = buildOpenAIChatFromAnthropic(payload);
+        const messages = Array.isArray(openaiPayload.messages)
+            ? openaiPayload.messages
+            : [];
         const toolOutputs = collectToolOutputsFromMessages(messages, missing);
-        const tools = payload.tools ? normalizeAnthropicTools(payload.tools, missing) : undefined;
+        const tools = mapAnthropicToolsToChat(payload.tools, missing);
         let parameters = collectParameters(payload);
-        const passthrough = extractPassthroughParameters(payload.metadata);
+        const passthrough = extractMetadataPassthrough(payload.metadata, {
+            prefix: PASSTHROUGH_METADATA_PREFIX,
+            keys: PASSTHROUGH_PARAMETERS
+        });
         if (passthrough.passthrough) {
             parameters = { ...(parameters || {}), ...passthrough.passthrough };
         }
-        const systemSegments = collectSystemSegments(payload.system);
         const metadata = { context: ctx };
-        if (systemSegments.length) {
-            metadata.systemInstructions = systemSegments;
-        }
-        if (payload.system !== undefined) {
-            metadata.rawSystem = jsonClone(payload.system);
-        }
         if (payload.tools && Array.isArray(payload.tools) && payload.tools.length === 0) {
             metadata.toolsFieldPresent = true;
         }
         if (missing.length) {
             metadata.missingFields = missing;
         }
-        const extraFields = collectExtraFields(payload);
-        if (extraFields) {
-            metadata.extraFields = extraFields;
-        }
         if (passthrough.metadata) {
             metadata.providerMetadata = passthrough.metadata;
         }
         else if (payload.metadata && isJsonObject(payload.metadata)) {
             metadata.providerMetadata = jsonClone(payload.metadata);
         }
+        try {
+            const bridgePolicy = resolveBridgePolicy({ protocol: 'anthropic-messages' });
+            const actions = resolvePolicyActions(bridgePolicy, 'request_inbound');
+            if (actions?.length) {
+                const actionState = createBridgeActionState({
+                    messages: messages,
+                    rawRequest: payload,
+                    metadata: metadata
+                });
+                runBridgeActionPipeline({
+                    stage: 'request_inbound',
+                    actions,
+                    protocol: bridgePolicy?.protocol ?? 'anthropic-messages',
+                    moduleType: bridgePolicy?.moduleType ?? 'anthropic-messages',
+                    requestId: ctx.requestId,
+                    state: actionState
+                });
+            }
+        }
+        catch {
+            // best-effort metadata extraction
+        }
         return {
             messages,
             tools,
@@ -242,10 +149,13 @@ export class AnthropicSemanticMapper {
         const baseRequest = {
             ...(chat.parameters || {}),
             model,
-            messages: chat.metadata?.systemInstructions ? chat.messages.filter(message => message.role !== 'system') : chat.messages,
+            messages: chat.messages,
             tools: chat.tools
         };
-        const passthroughMetadata = encodePassthroughParameters(chat);
+        const passthroughMetadata = encodeMetadataPassthrough(chat.parameters, {
+            prefix: PASSTHROUGH_METADATA_PREFIX,
+            keys: PASSTHROUGH_PARAMETERS
+        });
         if (passthroughMetadata) {
             const rawMetadata = baseRequest.metadata;
             const existingMetadata = isJsonObject(rawMetadata)
@@ -259,43 +169,47 @@ export class AnthropicSemanticMapper {
         if (baseRequest.max_output_tokens && !baseRequest.max_tokens) {
             baseRequest.max_tokens = baseRequest.max_output_tokens;
         }
-        const systemSegmentsRaw = Array.isArray(chat.metadata?.systemInstructions)
-            ? chat.metadata?.systemInstructions
-            : undefined;
-        const systemSegments = systemSegmentsRaw?.filter((seg) => typeof seg === 'string' && seg.trim().length > 0);
-        if (chat.metadata?.rawSystem !== undefined) {
-            baseRequest.system = chat.metadata.rawSystem;
-        }
-        else if (systemSegments && systemSegments.length > 0) {
-            baseRequest.system = systemSegmentsToAnthropicBlocks(systemSegments);
-        }
         if (isJsonObject(chat.metadata?.providerMetadata)) {
             baseRequest.metadata = jsonClone(chat.metadata?.providerMetadata);
         }
         if (chat.metadata?.toolsFieldPresent && (!Array.isArray(chat.tools) || chat.tools.length === 0)) {
             baseRequest.tools = [];
         }
-        if (isJsonObject(chat.metadata?.extraFields)) {
-            for (const [key, value] of Object.entries(chat.metadata?.extraFields)) {
-                if (baseRequest[key] === undefined) {
-                    baseRequest[key] = value;
-                }
-            }
-        }
-        const payload = buildAnthropicRequestFromOpenAIChat(baseRequest);
-        if (chat.metadata?.rawSystem !== undefined) {
-            payload.system = chat.metadata.rawSystem;
-        }
+        const payloadSource = buildAnthropicRequestFromOpenAIChat(baseRequest);
+        const payload = JSON.parse(JSON.stringify(payloadSource));
         if (chat.metadata?.toolsFieldPresent && (!Array.isArray(chat.tools) || chat.tools.length === 0)) {
             payload.tools = [];
         }
-        if (isJsonObject(chat.metadata?.extraFields)) {
-            for (const [key, value] of Object.entries(chat.metadata?.extraFields)) {
-                if (payload[key] === undefined) {
-                    payload[key] = value;
-                }
+        try {
+            const bridgePolicy = resolveBridgePolicy({ protocol: 'anthropic-messages' });
+            const actions = resolvePolicyActions(bridgePolicy, 'request_outbound');
+            if (actions?.length) {
+                const capturedToolResults = Array.isArray(chat.toolOutputs)
+                    ? chat.toolOutputs.map((entry) => ({
+                        tool_call_id: entry.tool_call_id,
+                        output: entry.content,
+                        name: entry.name
+                    }))
+                    : undefined;
+                const actionState = createBridgeActionState({
+                    messages: Array.isArray(payload.messages) ? payload.messages : undefined,
+                    rawRequest: payload,
+                    metadata: chat.metadata,
+                    capturedToolResults
+                });
+                runBridgeActionPipeline({
+                    stage: 'request_outbound',
+                    actions,
+                    protocol: bridgePolicy?.protocol ?? 'anthropic-messages',
+                    moduleType: bridgePolicy?.moduleType ?? 'anthropic-messages',
+                    requestId: ctx.requestId,
+                    state: actionState
+                });
             }
         }
+        catch {
+            // ignore metadata propagation failures
+        }
         return {
             protocol: 'anthropic-messages',
             direction: 'response',

package/dist/conversion/hub/semantic-mappers/chat-mapper.js

@@ -1,4 +1,7 @@
 import { isJsonObject, jsonClone } from '../types/json.js';
+import { createBridgeActionState, runBridgeActionPipeline } from '../../shared/bridge-actions.js';
+import { resolveBridgePolicy, resolvePolicyActions } from '../../shared/bridge-policies.js';
+import { normalizeChatMessageContent } from '../../shared/chat-output-normalizer.js';
 const CHAT_PARAMETER_KEYS = [
     'model',
     'temperature',
@@ -115,6 +118,15 @@ function normalizeChatMessages(raw) {
             return;
         }
         const chatMessage = value;
+        if (roleValue !== 'system' && roleValue !== 'tool') {
+            const normalizedContent = normalizeChatMessageContent(chatMessage.content);
+            if (normalizedContent.contentText !== undefined) {
+                chatMessage.content = normalizedContent.contentText;
+            }
+            if (typeof normalizedContent.reasoningText === 'string' && normalizedContent.reasoningText.trim().length) {
+                chatMessage.reasoning_content = normalizedContent.reasoningText.trim();
+            }
+        }
         norm.messages.push(chatMessage);
         if (roleValue === 'system') {
             const segment = flattenSystemContent(chatMessage.content);
@@ -185,27 +197,10 @@ function extractParameters(body) {
     }
     return Object.keys(params).length ? params : undefined;
 }
-function collectExtraFields(payload) {
-    const extras = {};
-    for (const key of Object.keys(payload)) {
-        if (KNOWN_TOP_LEVEL_FIELDS.has(key))
-            continue;
-        extras[key] = payload[key];
-    }
-    return Object.keys(extras).length ? extras : undefined;
-}
 export class ChatSemanticMapper {
     async toChat(format, ctx) {
         const payload = (format.payload ?? {});
         const normalized = normalizeChatMessages(payload.messages);
-        const rawSystemSentinel = payload.__rcc_raw_system;
-        const providerMetadataSentinel = payload.__rcc_provider_metadata;
-        if (rawSystemSentinel !== undefined) {
-            delete payload.__rcc_raw_system;
-        }
-        if (providerMetadataSentinel !== undefined) {
-            delete payload.__rcc_provider_metadata;
-        }
         const topLevelOutputs = normalizeStandaloneToolOutputs(payload.tool_outputs, normalized.missingFields);
         const toolOutputs = [...normalized.toolOutputs];
         for (const entry of topLevelOutputs) {
@@ -214,22 +209,6 @@ export class ChatSemanticMapper {
             }
         }
         const metadata = { context: ctx };
-        if (typeof rawSystemSentinel === 'string') {
-            try {
-                metadata.rawSystem = JSON.parse(rawSystemSentinel);
-            }
-            catch {
-                // ignore parse errors
-            }
-        }
-        if (typeof providerMetadataSentinel === 'string') {
-            try {
-                metadata.providerMetadata = JSON.parse(providerMetadataSentinel);
-            }
-            catch {
-                // ignore parse errors
-            }
-        }
         if (normalized.systemSegments.length) {
             metadata.systemInstructions = normalized.systemSegments;
         }
@@ -240,9 +219,27 @@ export class ChatSemanticMapper {
         if (normalized.missingFields.length) {
             metadata.missingFields = normalized.missingFields;
         }
-        const extraFields = collectExtraFields(payload);
-        if (extraFields) {
-            metadata.extraFields = extraFields;
+        try {
+            const bridgePolicy = resolveBridgePolicy({ protocol: 'openai-chat' });
+            const actions = resolvePolicyActions(bridgePolicy, 'request_inbound');
+            if (actions?.length) {
+                const actionState = createBridgeActionState({
+                    messages: normalized.messages,
+                    rawRequest: payload,
+                    metadata: metadata
+                });
+                runBridgeActionPipeline({
+                    stage: 'request_inbound',
+                    actions,
+                    protocol: bridgePolicy?.protocol ?? 'openai-chat',
+                    moduleType: bridgePolicy?.moduleType ?? 'openai-chat',
+                    requestId: ctx.requestId,
+                    state: actionState
+                });
+            }
+        }
+        catch {
+            // noop: best-effort policy application
         }
         if (Array.isArray(payload.tools) && payload.tools.length === 0) {
             metadata.toolsFieldPresent = true;
@@ -261,17 +258,39 @@ export class ChatSemanticMapper {
             tools: chat.tools ?? (chat.metadata?.toolsFieldPresent ? [] : undefined),
             ...(chat.parameters || {})
         };
-        if (chat.metadata?.rawSystem !== undefined) {
-            try {
-                payload.__rcc_raw_system = JSON.stringify(chat.metadata.rawSystem);
-            }
-            catch {
-                // ignore serialization errors
+        try {
+            const bridgePolicy = resolveBridgePolicy({ protocol: 'openai-chat' });
+            const actions = resolvePolicyActions(bridgePolicy, 'request_outbound');
+            if (actions?.length && Array.isArray(payload.messages)) {
+                const capturedToolResults = Array.isArray(chat.toolOutputs)
+                    ? chat.toolOutputs.map((entry) => ({
+                        tool_call_id: entry.tool_call_id,
+                        output: entry.content,
+                        name: entry.name
+                    }))
+                    : undefined;
+                const actionState = createBridgeActionState({
+                    messages: payload.messages,
+                    rawRequest: payload,
+                    metadata: chat.metadata,
+                    capturedToolResults
+                });
+                runBridgeActionPipeline({
+                    stage: 'request_outbound',
+                    actions,
+                    protocol: bridgePolicy?.protocol ?? 'openai-chat',
+                    moduleType: bridgePolicy?.moduleType ?? 'openai-chat',
+                    requestId: ctx.requestId,
+                    state: actionState
+                });
             }
         }
-        if (chat.metadata?.providerMetadata && isJsonObject(chat.metadata.providerMetadata)) {
+        catch {
+            // ignore policy failures
+        }
+        if (chat.metadata?.rawSystem !== undefined) {
             try {
-                payload.__rcc_provider_metadata = JSON.stringify(chat.metadata.providerMetadata);
+                payload.__rcc_raw_system = JSON.stringify(chat.metadata.rawSystem);
             }
             catch {
                 // ignore serialization errors
@@ -284,14 +303,6 @@ export class ChatSemanticMapper {
             payload.max_tokens = payload.max_output_tokens;
             delete payload.max_output_tokens;
         }
-        const extraFields = chat.metadata?.extraFields;
-        if (isJsonObject(extraFields)) {
-            for (const [key, value] of Object.entries(extraFields)) {
-                if (payload[key] === undefined) {
-                    payload[key] = value;
-                }
-            }
-        }
         return {
             protocol: 'openai-chat',
             direction: 'response',