@jsonstudio/llms 0.6.2172 → 0.6.3214

package/dist/conversion/hub/pipeline/hub-pipeline.js

@@ -1,7 +1,6 @@
 import { Readable } from 'node:stream';
 import { isJsonObject, jsonClone } from '../types/json.js';
 import { VirtualRouterEngine } from '../../../router/virtual-router/engine.js';
-import { parseRoutingInstructions } from '../../../router/virtual-router/routing-instructions.js';
 import { providerErrorCenter } from '../../../router/virtual-router/error-center.js';
 import { providerSuccessCenter } from '../../../router/virtual-router/success-center.js';
 import { defaultSseCodecRegistry } from '../../../sse/index.js';
@@ -14,10 +13,11 @@ import { GeminiSemanticMapper } from '../semantic-mappers/gemini-mapper.js';
 import { ChatFormatAdapter } from '../format-adapters/chat-format-adapter.js';
 import { ChatSemanticMapper } from '../semantic-mappers/chat-mapper.js';
 import { createSnapshotRecorder } from '../snapshot-recorder.js';
-import { shouldRecordSnapshots } from '../../shared/snapshot-utils.js';
+import { shouldRecordSnapshots } from '../../snapshot-utils.js';
 import { runReqInboundStage1FormatParse } from './stages/req_inbound/req_inbound_stage1_format_parse/index.js';
 import { runReqInboundStage2SemanticMap } from './stages/req_inbound/req_inbound_stage2_semantic_map/index.js';
 import { runChatContextCapture, captureResponsesContextSnapshot } from './stages/req_inbound/req_inbound_stage3_context_capture/index.js';
+import { normalizeReqInboundToolCallIdStyleWithNative } from '../../../router/virtual-router/engine-selection/native-hub-pipeline-req-inbound-semantics.js';
 import { createResponsesContextCapture, createNoopContextCapture } from './stages/req_inbound/req_inbound_stage3_context_capture/context-factories.js';
 import { runReqProcessStage1ToolGovernance } from './stages/req_process/req_process_stage1_tool_governance/index.js';
 import { runReqProcessStage2RouteSelect } from './stages/req_process/req_process_stage2_route_select/index.js';
@@ -26,11 +26,12 @@ import { runReqOutboundStage2FormatBuild } from './stages/req_outbound/req_outbo
 import { runReqOutboundStage3Compat } from './stages/req_outbound/req_outbound_stage3_compat/index.js';
 import { extractSessionIdentifiersFromMetadata } from './session-identifiers.js';
 import { computeRequestTokens } from '../../../router/virtual-router/token-estimator.js';
-import { isCompactionRequest } from '../../shared/compaction-detect.js';
+import { annotatePassthroughGovernanceSkipWithNative, attachPassthroughProviderInputAuditWithNative, buildPassthroughAuditWithNative, applyOutboundStreamPreferenceWithNative, normalizeHubEndpointWithNative, extractAdapterContextMetadataFieldsWithNative, resolveApplyPatchToolModeFromToolsWithNative, resolveHubClientProtocolWithNative, resolveHubPolicyOverrideFromMetadataWithNative, resolveHubProviderProtocolWithNative, resolveOutboundStreamIntentWithNative, resolveHubShadowCompareConfigWithNative, resolveActiveProcessModeWithNative, findMappableSemanticsKeysWithNative, resolveHubSseProtocolFromMetadataWithNative, resolveStopMessageRouterMetadataWithNative, runHubPipelineOrchestrationWithNative } from '../../../router/virtual-router/engine-selection/native-hub-pipeline-orchestration-semantics.js';
+import { normalizeAliasMapWithNative, resolveAliasMapFromRespSemanticsWithNative } from '../../../router/virtual-router/engine-selection/native-hub-pipeline-resp-semantics.js';
+import { isCompactionRequest } from '../../compaction-detect.js';
 import { applyHubProviderOutboundPolicy, recordHubPolicyObservation, setHubPolicyRuntimePolicy } from '../policy/policy-engine.js';
 import { applyProviderOutboundToolSurface } from '../tool-surface/tool-surface-engine.js';
-import { applyHubOperations } from '../ops/operations.js';
-import { cloneRuntimeMetadata, ensureRuntimeMetadata, readRuntimeMetadata } from '../../shared/runtime-metadata.js';
+import { cloneRuntimeMetadata, ensureRuntimeMetadata, readRuntimeMetadata } from '../../runtime-metadata.js';
 function isTruthyEnv(value) {
     const v = typeof value === 'string' ? value.trim().toLowerCase() : '';
     return v === '1' || v === 'true' || v === 'yes' || v === 'on';
@@ -49,142 +50,51 @@ function resolveApplyPatchToolModeFromEnv() {
     return undefined;
 }
 function resolveApplyPatchToolModeFromTools(toolsRaw) {
-    if (!Array.isArray(toolsRaw) || toolsRaw.length === 0) {
-        return undefined;
-    }
-    for (const entry of toolsRaw) {
-        if (!entry || typeof entry !== 'object' || Array.isArray(entry))
-            continue;
-        const record = entry;
-        const type = typeof record.type === 'string' ? record.type.trim().toLowerCase() : '';
-        if (type && type !== 'function')
-            continue;
-        const fn = record.function && typeof record.function === 'object' && !Array.isArray(record.function)
-            ? record.function
-            : undefined;
-        const name = typeof fn?.name === 'string' ? fn.name.trim().toLowerCase() : '';
-        if (name !== 'apply_patch')
-            continue;
-        const format = typeof record.format === 'string'
-            ? record.format.trim().toLowerCase()
-            : typeof fn?.format === 'string'
-                ? String(fn.format).trim().toLowerCase()
-                : '';
-        if (format === 'freeform')
-            return 'freeform';
-        // If apply_patch is present without explicit freeform marker, default to schema mode.
-        return 'schema';
-    }
-    return undefined;
+    return resolveApplyPatchToolModeFromToolsWithNative(toolsRaw);
 }
 function extractHubPolicyOverride(metadata) {
-    const raw = metadata ? metadata.__hubPolicyOverride : undefined;
-    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
-        return undefined;
-    }
-    const obj = raw;
-    const mode = typeof obj.mode === 'string' ? obj.mode.trim().toLowerCase() : '';
-    const sampleRate = typeof obj.sampleRate === 'number' && Number.isFinite(obj.sampleRate) ? obj.sampleRate : undefined;
-    if (mode !== 'off' && mode !== 'observe' && mode !== 'enforce') {
+    const parsed = resolveHubPolicyOverrideFromMetadataWithNative(metadata);
+    if (!parsed) {
         return undefined;
     }
     return {
-        mode: mode,
-        ...(sampleRate !== undefined ? { sampleRate } : {})
+        mode: parsed.mode,
+        ...(parsed.sampleRate !== undefined ? { sampleRate: parsed.sampleRate } : {})
     };
 }
+function propagateAdapterContextMetadataFields(adapterContext, metadata, keys) {
+    const picked = extractAdapterContextMetadataFieldsWithNative(metadata, keys);
+    Object.assign(adapterContext, picked);
+}
+function resolveStopMessageRouterMetadata(metadata) {
+    return resolveStopMessageRouterMetadataWithNative(metadata);
+}
 function extractHubShadowCompareConfig(metadata) {
-    const raw = metadata ? metadata.__hubShadowCompare : undefined;
-    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
-        return undefined;
-    }
-    const obj = raw;
-    const modeCandidate = typeof obj.baselineMode === 'string'
-        ? obj.baselineMode.trim().toLowerCase()
-        : typeof obj.mode === 'string'
-            ? obj.mode.trim().toLowerCase()
-            : '';
-    if (modeCandidate !== 'off' && modeCandidate !== 'observe' && modeCandidate !== 'enforce') {
+    const parsed = resolveHubShadowCompareConfigWithNative(metadata);
+    if (!parsed) {
         return undefined;
     }
-    return { baselineMode: modeCandidate };
-}
-const PASSTHROUGH_CANONICAL_CHAT_KEYS = new Set([
-    'model',
-    'messages',
-    'tools',
-    'parameters',
-    'metadata',
-    'semantics',
-    'stream'
-]);
-function cloneJsonRecord(payload) {
-    try {
-        return jsonClone(payload);
-    }
-    catch {
-        return { ...payload };
-    }
-}
-function collectPassthroughTodoTopLevelKeys(payload) {
-    return Object.keys(payload)
-        .filter((key) => !PASSTHROUGH_CANONICAL_CHAT_KEYS.has(key))
-        .sort();
+    return { baselineMode: parsed.baselineMode };
 }
 function buildPassthroughAudit(rawInbound, providerProtocol) {
-    return {
-        raw: {
-            inbound: cloneJsonRecord(rawInbound)
-        },
-        todo: {
-            inbound: {
-                unmappedTopLevelKeys: collectPassthroughTodoTopLevelKeys(rawInbound),
-                providerProtocol,
-                note: 'passthrough_mode_parse_record_only'
-            }
-        }
-    };
+    return buildPassthroughAuditWithNative(rawInbound, providerProtocol);
 }
 function annotatePassthroughGovernanceSkip(audit) {
-    const todo = audit.todo && typeof audit.todo === 'object' && !Array.isArray(audit.todo)
-        ? audit.todo
-        : (audit.todo = {});
-    todo.governance = {
-        skipped: true,
-        reason: 'process_mode_passthrough'
-    };
+    const next = annotatePassthroughGovernanceSkipWithNative(audit);
+    for (const key of Object.keys(audit)) {
+        delete audit[key];
+    }
+    Object.assign(audit, next);
 }
 function attachPassthroughProviderInputAudit(audit, providerPayload, providerProtocol) {
-    const raw = audit.raw && typeof audit.raw === 'object' && !Array.isArray(audit.raw)
-        ? audit.raw
-        : (audit.raw = {});
-    raw.providerInput = cloneJsonRecord(providerPayload);
-    const todo = audit.todo && typeof audit.todo === 'object' && !Array.isArray(audit.todo)
-        ? audit.todo
-        : (audit.todo = {});
-    todo.outbound = {
-        unmappedTopLevelKeys: collectPassthroughTodoTopLevelKeys(providerPayload),
-        providerProtocol,
-        note: 'provider_payload_not_mapped_back_to_chat_semantics'
-    };
-}
-function hasInstructionRequestedPassthrough(messages) {
-    if (!Array.isArray(messages) || messages.length === 0) {
-        return false;
-    }
-    try {
-        const instructions = parseRoutingInstructions(messages);
-        return instructions.some((instruction) => instruction.processMode === 'passthrough');
-    }
-    catch {
-        return false;
+    const next = attachPassthroughProviderInputAuditWithNative(audit, providerPayload, providerProtocol);
+    for (const key of Object.keys(audit)) {
+        delete audit[key];
     }
+    Object.assign(audit, next);
 }
 function resolveActiveProcessMode(baseMode, messages) {
-    if (baseMode === 'passthrough') {
-        return 'passthrough';
-    }
-    return hasInstructionRequestedPassthrough(messages) ? 'passthrough' : 'chat';
+    return resolveActiveProcessModeWithNative(baseMode, messages);
 }
 export class HubPipeline {
     routerEngine;
@@ -279,7 +189,6 @@ export class HubPipeline {
         }
     }
     async executeRequestStagePipeline(normalized, hooks) {
-        const formatAdapter = hooks.createFormatAdapter();
         const semanticMapper = hooks.createSemanticMapper();
         const rawRequest = this.asJsonObject(normalized.payload);
         // Detect applyPatchToolMode (runtime/tooling hint). Client tool schemas are captured as chat semantics
@@ -320,7 +229,6 @@ export class HubPipeline {
         const formatEnvelope = await runReqInboundStage1FormatParse({
             rawRequest,
             adapterContext: inboundAdapterContext,
-            formatAdapter,
             stageRecorder: inboundRecorder
         });
         const responsesResumeFromMetadata = normalized.metadata && typeof normalized.metadata.responsesResume === 'object'
@@ -483,6 +391,11 @@ export class HubPipeline {
             normalized.metadata.conversationId = sessionIdentifiers.conversationId;
         }
         const disableStickyRoutes = readRuntimeMetadata(normalized.metadata)?.disableStickyRoutes === true;
+        const stopMessageRouterMetadata = resolveStopMessageRouterMetadata(normalized.metadata);
+        const estimatedInputTokens = (() => {
+            const value = normalized.metadata?.estimatedInputTokens;
+            return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+        })();
         const metadataInput = {
             requestId: normalized.id,
             entryEndpoint: normalized.entryEndpoint,
@@ -493,10 +406,12 @@ export class HubPipeline {
             routeHint: normalized.routeHint,
             stage: normalized.stage,
             responsesResume: responsesResume,
+            ...(estimatedInputTokens !== undefined ? { estimatedInputTokens } : {}),
             ...(disableStickyRoutes ? { disableStickyRoutes: true } : {}),
             ...(serverToolRequired ? { serverToolRequired: true } : {}),
             ...(sessionIdentifiers.sessionId ? { sessionId: sessionIdentifiers.sessionId } : {}),
-            ...(sessionIdentifiers.conversationId ? { conversationId: sessionIdentifiers.conversationId } : {})
+            ...(sessionIdentifiers.conversationId ? { conversationId: sessionIdentifiers.conversationId } : {}),
+            ...stopMessageRouterMetadata
         };
         const routing = runReqProcessStage2RouteSelect({
             routerEngine: this.routerEngine,
@@ -531,6 +446,7 @@ export class HubPipeline {
         }
         const outboundStream = this.resolveOutboundStreamIntent(routing.target?.streaming);
         workingRequest = this.applyOutboundStreamPreference(workingRequest, outboundStream, activeProcessMode);
+        this.applyMaxTokensPolicy(workingRequest, routing.target);
         const outboundAdapterContext = this.buildAdapterContext(normalized, routing.target);
         if (routing.target?.compatibilityProfile) {
             outboundAdapterContext.compatibilityProfile = routing.target.compatibilityProfile;
@@ -549,7 +465,7 @@ export class HubPipeline {
         let providerPayload;
         let shadowBaselineProviderPayload;
         if (activeProcessMode === 'passthrough') {
-            providerPayload = cloneJsonRecord(rawRequest);
+            providerPayload = jsonClone(rawRequest);
             if (typeof outboundStream === 'boolean') {
                 providerPayload.stream = outboundStream;
             }
@@ -564,7 +480,6 @@ export class HubPipeline {
                 throw new Error(`[HubPipeline] Unsupported provider protocol for hub pipeline: ${outboundProtocol}`);
             }
             const outboundSemanticMapper = protocolSwitch ? outboundHooks.createSemanticMapper() : semanticMapper;
-            const outboundFormatAdapter = protocolSwitch ? outboundHooks.createFormatAdapter() : formatAdapter;
             const outboundContextMetadataKey = protocolSwitch ? outboundHooks.contextMetadataKey : hooks.contextMetadataKey;
             const outboundContextSnapshot = protocolSwitch ? undefined : contextSnapshot;
             const outboundStage1 = await runReqOutboundStage1SemanticMap({
@@ -577,8 +492,6 @@ export class HubPipeline {
             });
             let formattedPayload = await runReqOutboundStage2FormatBuild({
                 formatEnvelope: outboundStage1.formatEnvelope,
-                adapterContext: outboundAdapterContext,
-                formatAdapter: outboundFormatAdapter,
                 stageRecorder: outboundRecorder
             });
             formattedPayload = await runReqOutboundStage3Compat({
@@ -734,11 +647,10 @@ export class HubPipeline {
         };
     }
     resolveClientProtocol(entryEndpoint) {
-        const lowered = String(entryEndpoint || '').toLowerCase();
-        if (lowered.includes('/v1/responses'))
-            return 'openai-responses';
-        if (lowered.includes('/v1/messages'))
-            return 'anthropic-messages';
+        const protocol = resolveHubClientProtocolWithNative(entryEndpoint);
+        if (protocol === 'openai-responses' || protocol === 'anthropic-messages' || protocol === 'openai-chat') {
+            return protocol;
+        }
         return 'openai-chat';
     }
     coerceStandardizedRequestFromPayload(payload, normalized) {
@@ -964,6 +876,7 @@ export class HubPipeline {
             normalized.metadata.conversationId = sessionIdentifiers.conversationId;
         }
         const disableStickyRoutes = readRuntimeMetadata(normalized.metadata)?.disableStickyRoutes === true;
+        const stopMessageRouterMetadata = resolveStopMessageRouterMetadata(normalized.metadata);
         const metadataInput = {
             requestId: normalized.id,
             entryEndpoint: normalized.entryEndpoint,
@@ -977,7 +890,8 @@ export class HubPipeline {
             ...(disableStickyRoutes ? { disableStickyRoutes: true } : {}),
             ...(serverToolRequired ? { serverToolRequired: true } : {}),
             ...(sessionIdentifiers.sessionId ? { sessionId: sessionIdentifiers.sessionId } : {}),
-            ...(sessionIdentifiers.conversationId ? { conversationId: sessionIdentifiers.conversationId } : {})
+            ...(sessionIdentifiers.conversationId ? { conversationId: sessionIdentifiers.conversationId } : {}),
+            ...stopMessageRouterMetadata
         };
         const routing = runReqProcessStage2RouteSelect({
             routerEngine: this.routerEngine,
@@ -1026,7 +940,7 @@ export class HubPipeline {
         const outboundStart = Date.now();
         let providerPayload;
         if (activeProcessMode === 'passthrough') {
-            providerPayload = cloneJsonRecord(rawPayloadInput);
+            providerPayload = jsonClone(rawPayloadInput);
             if (typeof outboundStream === 'boolean') {
                 providerPayload.stream = outboundStream;
             }
@@ -1041,7 +955,6 @@ export class HubPipeline {
                 throw new Error(`[HubPipeline] Unsupported provider protocol for hub pipeline: ${outboundProtocol}`);
             }
             const outboundSemanticMapper = protocolSwitch ? outboundHooks.createSemanticMapper() : hooks.createSemanticMapper();
-            const outboundFormatAdapter = protocolSwitch ? outboundHooks.createFormatAdapter() : hooks.createFormatAdapter();
             const outboundContextMetadataKey = protocolSwitch ? outboundHooks.contextMetadataKey : hooks.contextMetadataKey;
             const outboundContextSnapshot = undefined;
             const outboundStage1 = await runReqOutboundStage1SemanticMap({
@@ -1054,8 +967,6 @@ export class HubPipeline {
             });
             let formattedPayload = await runReqOutboundStage2FormatBuild({
                 formatEnvelope: outboundStage1.formatEnvelope,
-                adapterContext: outboundAdapterContext,
-                formatAdapter: outboundFormatAdapter,
                 stageRecorder: outboundRecorder
             });
             formattedPayload = await runReqOutboundStage3Compat({
@@ -1260,7 +1171,7 @@ export class HubPipeline {
         // Never inherit stale top-level metadata.compatibilityProfile from a previous hop.
         const compatibilityProfile = target ? targetCompatProfile : metadataCompatProfile;
         const streamingHint = normalized.stream === true ? 'force' : normalized.stream === false ? 'disable' : 'auto';
-        const toolCallIdStyle = normalizeToolCallIdStyleCandidate(metadata.toolCallIdStyle);
+        const toolCallIdStyle = normalizeReqInboundToolCallIdStyleWithNative(metadata.toolCallIdStyle);
         const adapterContext = {
             requestId: normalized.id,
             entryEndpoint: normalized.entryEndpoint || '/v1/chat/completions',
@@ -1338,6 +1249,23 @@ export class HubPipeline {
         if (conversationId) {
             adapterContext.conversationId = conversationId;
         }
+        propagateAdapterContextMetadataFields(adapterContext, metadata, [
+            'clockDaemonId',
+            'clockClientDaemonId',
+            'clock_daemon_id',
+            'clock_client_daemon_id',
+            'tmuxSessionId',
+            'tmux_session_id',
+            'clientType',
+            'clockClientType',
+            'clientInjectReady',
+            'clientInjectReason',
+            'client_inject_ready',
+            'client_inject_reason',
+            'workdir',
+            'cwd',
+            'workingDirectory'
+        ]);
         const clientConnectionState = metadata.clientConnectionState;
         if (clientConnectionState && typeof clientConnectionState === 'object' && !Array.isArray(clientConnectionState)) {
             const stateRecord = clientConnectionState;
@@ -1356,6 +1284,47 @@ export class HubPipeline {
         }
         return adapterContext;
     }
+    applyMaxTokensPolicy(request, target) {
+        if (!target) {
+            return;
+        }
+        const params = request.parameters || (request.parameters = {});
+        const direct = typeof params.max_tokens === 'number' && Number.isFinite(params.max_tokens)
+            ? Math.floor(params.max_tokens)
+            : undefined;
+        const maxOutputRaw = typeof params.max_output_tokens === 'number' &&
+            Number.isFinite(params.max_output_tokens)
+            ? Math.floor(params.max_output_tokens)
+            : undefined;
+        let desired = direct ?? maxOutputRaw;
+        // Default max tokens = 8k when client does not set.
+        if (!desired || desired <= 0) {
+            desired = 8192;
+        }
+        let providerCap = typeof target.maxOutputTokens === 'number' && Number.isFinite(target.maxOutputTokens)
+            ? Math.floor(target.maxOutputTokens)
+            : undefined;
+        if (!providerCap) {
+            const registry = this.routerEngine
+                .providerRegistry;
+            const profile = registry?.get?.(target.providerKey);
+            const candidate = typeof profile?.maxOutputTokens === 'number' && Number.isFinite(profile.maxOutputTokens)
+                ? Math.floor(profile.maxOutputTokens)
+                : undefined;
+            if (candidate && candidate > 0) {
+                providerCap = candidate;
+            }
+        }
+        if (providerCap && providerCap > 0) {
+            desired = Math.min(desired, providerCap);
+        }
+        if (desired && desired > 0) {
+            params.max_tokens = desired;
+            if (params.max_output_tokens !== undefined) {
+                params.max_output_tokens = desired;
+            }
+        }
+    }
     maybeCreateStageRecorder(context, endpoint, options) {
         if (options?.disableSnapshots === true) {
             return undefined;
@@ -1418,12 +1387,45 @@ export class HubPipeline {
         const stream = Boolean(metadataRecord.stream ||
             resolvedReadable ||
             (request.payload && typeof request.payload === 'object' && request.payload.stream));
-        const payload = await this.materializePayload(request.payload, {
+        let payload = await this.materializePayload(request.payload, {
             requestId: id,
             entryEndpoint,
             providerProtocol,
             metadata: metadataRecord
         }, resolvedReadable);
+        const routeHint = typeof metadataRecord.routeHint === 'string' ? metadataRecord.routeHint : undefined;
+        const orchestrationResult = runHubPipelineOrchestrationWithNative({
+            requestId: id,
+            endpoint,
+            entryEndpoint,
+            providerProtocol,
+            payload,
+            metadata: {
+                entryEndpoint,
+                providerProtocol,
+                processMode,
+                direction,
+                stage,
+                stream,
+                ...(routeHint ? { routeHint } : {})
+            },
+            stream,
+            processMode,
+            direction,
+            stage
+        });
+        if (!orchestrationResult.success) {
+            const code = orchestrationResult.error && typeof orchestrationResult.error.code === 'string'
+                ? orchestrationResult.error.code.trim()
+                : 'hub_pipeline_native_failed';
+            const message = orchestrationResult.error && typeof orchestrationResult.error.message === 'string'
+                ? orchestrationResult.error.message.trim()
+                : 'Native hub pipeline orchestration failed';
+            throw new Error(`[${code}] ${message}`);
+        }
+        if (orchestrationResult.payload) {
+            payload = orchestrationResult.payload;
+        }
         const normalizedMetadata = {
             ...metadataRecord,
             entryEndpoint,
@@ -1431,9 +1433,9 @@ export class HubPipeline {
             processMode,
             direction,
             stage,
-            stream
+            stream,
+            ...(orchestrationResult.metadata ?? {})
         };
-        const routeHint = typeof metadataRecord.routeHint === 'string' ? metadataRecord.routeHint : undefined;
         if (routeHint) {
             normalizedMetadata.routeHint = routeHint;
         }
@@ -1538,156 +1540,54 @@ export class HubPipeline {
         return undefined;
     }
     resolveOutboundStreamIntent(providerPreference) {
-        if (providerPreference === 'always') {
-            return true;
-        }
-        if (providerPreference === 'never') {
-            return false;
-        }
-        return undefined;
+        return resolveOutboundStreamIntentWithNative(providerPreference);
     }
     applyOutboundStreamPreference(request, stream, processMode) {
         if (!request || typeof request !== 'object') {
             return request;
         }
-        if (processMode === 'passthrough' && stream === undefined) {
-            return request;
-        }
-        const ops = [];
-        if (typeof stream === 'boolean') {
-            ops.push({ op: 'set_request_parameter_fields', fields: { stream } });
-            ops.push({ op: 'set_request_metadata_fields', fields: { outboundStream: stream } });
-        }
-        else {
-            ops.push({ op: 'unset_request_parameter_keys', keys: ['stream'] });
-            ops.push({ op: 'unset_request_metadata_keys', keys: ['outboundStream'] });
-        }
-        return applyHubOperations(request, ops);
-    }
-}
-function normalizeToolCallIdStyleCandidate(value) {
-    if (typeof value !== 'string') {
-        return undefined;
-    }
-    const normalized = value.trim().toLowerCase();
-    if (normalized === 'fc') {
-        return 'fc';
+        return applyOutboundStreamPreferenceWithNative(request, stream, processMode);
     }
-    if (normalized === 'preserve') {
-        return 'preserve';
-    }
-    return undefined;
 }
 function normalizeEndpoint(endpoint) {
-    if (!endpoint)
-        return '/v1/chat/completions';
-    const trimmed = endpoint.trim();
-    if (!trimmed)
-        return '/v1/chat/completions';
-    const normalized = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
-    return normalized.replace(/\/{2,}/g, '/');
+    return normalizeHubEndpointWithNative(endpoint);
 }
 function resolveProviderProtocol(value) {
-    if (typeof value !== 'string' || !value.trim()) {
-        return 'openai-chat';
+    try {
+        const normalized = resolveHubProviderProtocolWithNative(value);
+        if (normalized === 'openai-chat' ||
+            normalized === 'openai-responses' ||
+            normalized === 'anthropic-messages' ||
+            normalized === 'gemini-chat') {
+            return normalized;
+        }
     }
-    const normalized = value.trim().toLowerCase();
-    const mapped = PROVIDER_PROTOCOL_ALIASES[normalized];
-    if (mapped) {
-        return mapped;
+    catch {
+        // Keep legacy caller-facing error shape below.
     }
     throw new Error(`[HubPipeline] Unsupported providerProtocol "${value}". Configure a valid protocol (openai-chat|openai-responses|anthropic-messages|gemini-chat).`);
 }
-const PROVIDER_PROTOCOL_ALIASES = {
-    'openai-chat': 'openai-chat',
-    openai: 'openai-chat',
-    chat: 'openai-chat',
-    'responses': 'openai-responses',
-    'openai-responses': 'openai-responses',
-    'anthropic': 'anthropic-messages',
-    'anthropic-messages': 'anthropic-messages',
-    'messages': 'anthropic-messages',
-    'gemini': 'gemini-chat',
-    'google-gemini': 'gemini-chat',
-    'gemini-chat': 'gemini-chat'
-};
-function resolveEndpointForProviderProtocol(protocol) {
-    if (!protocol) {
-        return undefined;
-    }
-    const value = protocol.toLowerCase();
-    if (value === 'openai-responses')
-        return '/v1/responses';
-    if (value === 'openai-chat')
-        return '/v1/chat/completions';
-    if (value === 'anthropic-messages' || value === 'anthropic')
-        return '/v1/messages';
-    if (value === 'gemini-chat' || value === 'gemini' || value === 'google-gemini')
-        return '/v1/responses';
-    return undefined;
-}
 function resolveSseProtocolFromMetadata(metadata) {
-    const candidate = metadata.sseProtocol ?? metadata.clientSseProtocol ?? metadata.routeSseProtocol;
-    if (typeof candidate !== 'string' || !candidate.trim()) {
+    const resolved = resolveHubSseProtocolFromMetadataWithNative(metadata);
+    if (!resolved) {
         return undefined;
     }
-    return resolveProviderProtocol(candidate);
+    return resolveProviderProtocol(resolved);
 }
 function coerceAliasMap(candidate) {
-    if (!candidate || typeof candidate !== 'object' || Array.isArray(candidate)) {
-        return undefined;
-    }
-    const normalized = {};
-    for (const [key, value] of Object.entries(candidate)) {
-        if (typeof key !== 'string' || typeof value !== 'string') {
-            continue;
-        }
-        const trimmedKey = key.trim();
-        const trimmedValue = value.trim();
-        if (!trimmedKey.length || !trimmedValue.length) {
-            continue;
-        }
-        normalized[trimmedKey] = trimmedValue;
-    }
-    return Object.keys(normalized).length ? normalized : undefined;
+    return normalizeAliasMapWithNative(candidate);
 }
 function readAliasMapFromSemantics(chatEnvelope) {
-    if (!chatEnvelope?.semantics || typeof chatEnvelope.semantics !== 'object') {
-        return undefined;
-    }
-    const node = chatEnvelope.semantics.tools;
-    if (!node || !isJsonObject(node)) {
+    if (!chatEnvelope?.semantics || typeof chatEnvelope.semantics !== 'object' || Array.isArray(chatEnvelope.semantics)) {
         return undefined;
     }
-    const candidate = node.toolNameAliasMap ??
-        node.toolAliasMap;
-    return coerceAliasMap(candidate);
+    return resolveAliasMapFromRespSemanticsWithNative(chatEnvelope.semantics);
 }
 function assertNoMappableSemanticsInMetadata(metadata, scope) {
     if (!metadata || typeof metadata !== 'object') {
         return;
     }
-    const banned = [
-        'responsesResume',
-        'responses_resume',
-        'clientToolsRaw',
-        'client_tools_raw',
-        'anthropicToolNameMap',
-        'anthropic_tool_name_map',
-        // Responses semantics must be stored in chat.semantics.responses.context, not metadata.
-        'responsesContext',
-        'responses_context',
-        'responseFormat',
-        'response_format',
-        // OpenAI Chat legacy semantics must be stored in chat.semantics (system/tools/providerExtras), not metadata.
-        'systemInstructions',
-        'system_instructions',
-        'toolsFieldPresent',
-        'tools_field_present',
-        'extraFields',
-        'extra_fields'
-    ];
-    const present = banned.filter((k) => Object.prototype.hasOwnProperty.call(metadata, k));
+    const present = findMappableSemanticsKeysWithNative(metadata);
     if (present.length) {
         throw new Error(`[HubPipeline][semantic_gate] Mappable semantics must not be stored in metadata (${scope}): ${present.join(', ')}`);
     }