@jsonstudio/llms 0.6.3551 → 0.6.3686

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

@@ -1,5 +1,6 @@
 import { Readable } from "node:stream";
 import { isJsonObject, jsonClone } from "../types/json.js";
+import { convertMessagesToBridgeInput } from "../../bridge-message-utils.js";
 import { VirtualRouterEngine } from "../../../router/virtual-router/engine.js";
 import { providerErrorCenter } from "../../../router/virtual-router/error-center.js";
 import { providerSuccessCenter } from "../../../router/virtual-router/success-center.js";
@@ -26,12 +27,15 @@ 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 { estimateSessionBoundTokens } from "../process/chat-process-session-usage.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 { cloneRuntimeMetadata, ensureRuntimeMetadata, readRuntimeMetadata, } from "../../runtime-metadata.js";
+import { containsImageAttachment, stripHistoricalImageAttachments, stripHistoricalVisualToolOutputs, repairIncompleteToolCalls, } from "../process/chat-process-media.js";
+import { measureHubStage, logHubStageTiming } from "./hub-stage-timing.js";
 function isTruthyEnv(value) {
     const v = typeof value === "string" ? value.trim().toLowerCase() : "";
     return v === "1" || v === "true" || v === "yes" || v === "on";
@@ -52,6 +56,109 @@ function resolveApplyPatchToolModeFromEnv() {
         return "freeform";
     return undefined;
 }
+function applyChatProcessEntryMediaCleanup(request) {
+    return {
+        ...request,
+        messages: repairIncompleteToolCalls(stripHistoricalVisualToolOutputs(stripHistoricalImageAttachments(request.messages))),
+    };
+}
+function readResponsesResumeFromMetadata(metadata) {
+    if (!metadata || typeof metadata !== "object") {
+        return undefined;
+    }
+    const resume = metadata.responsesResume;
+    return resume && isJsonObject(resume)
+        ? resume
+        : undefined;
+}
+function readResponsesResumeFromRequestSemantics(request) {
+    try {
+        const semantics = request?.semantics;
+        const responses = semantics &&
+            typeof semantics === "object" &&
+            !Array.isArray(semantics) &&
+            semantics.responses &&
+            typeof semantics.responses === "object" &&
+            !Array.isArray(semantics.responses)
+            ? semantics.responses
+            : undefined;
+        const resume = responses &&
+            responses.resume &&
+            typeof responses.resume === "object" &&
+            !Array.isArray(responses.resume)
+            ? responses.resume
+            : undefined;
+        return resume;
+    }
+    catch {
+        return undefined;
+    }
+}
+function liftResponsesResumeIntoSemantics(request, metadata) {
+    const resumeMeta = readResponsesResumeFromMetadata(metadata);
+    if (!resumeMeta) {
+        return request;
+    }
+    const next = {
+        ...request,
+        semantics: {
+            ...(request.semantics ??
+                {}),
+        },
+    };
+    const semantics = next.semantics;
+    if (!semantics.responses ||
+        typeof semantics.responses !== "object" ||
+        Array.isArray(semantics.responses)) {
+        semantics.responses = {};
+    }
+    const responsesNode = semantics.responses;
+    if (responsesNode.resume === undefined) {
+        responsesNode.resume = jsonClone(resumeMeta);
+    }
+    delete metadata.responsesResume;
+    return next;
+}
+function syncResponsesContextFromCanonicalMessages(request) {
+    const semantics = request?.semantics;
+    const responsesNode = semantics &&
+        typeof semantics === "object" &&
+        !Array.isArray(semantics) &&
+        semantics.responses &&
+        typeof semantics.responses === "object" &&
+        !Array.isArray(semantics.responses)
+        ? semantics.responses
+        : undefined;
+    const contextNode = responsesNode &&
+        responsesNode.context &&
+        typeof responsesNode.context === "object" &&
+        !Array.isArray(responsesNode.context)
+        ? responsesNode.context
+        : undefined;
+    if (!contextNode) {
+        return request;
+    }
+    const bridge = convertMessagesToBridgeInput({
+        messages: request.messages ?? [],
+        tools: Array.isArray(request.tools)
+            ? request.tools
+            : undefined,
+    });
+    return {
+        ...request,
+        semantics: {
+            ...semantics,
+            responses: {
+                ...responsesNode,
+                context: {
+                    ...contextNode,
+                    input: jsonClone(bridge.input),
+                    originalSystemMessages: jsonClone(bridge.originalSystemMessages),
+                },
+            },
+        },
+    };
+}
 function resolveApplyPatchToolModeFromTools(toolsRaw) {
     return resolveApplyPatchToolModeFromToolsWithNative(toolsRaw);
 }
@@ -341,16 +448,13 @@ export class HubPipeline {
             stageRecorder: inboundRecorder,
             requestId: normalized.id,
         });
-        const formatEnvelope = await runReqInboundStage1FormatParse({
+        const formatEnvelope = await measureHubStage(normalized.id, "req_inbound.stage1_format_parse", () => runReqInboundStage1FormatParse({
             rawRequest,
             adapterContext: inboundAdapterContext,
             stageRecorder: inboundRecorder,
-        });
-        const responsesResumeFromMetadata = normalized.metadata &&
-            typeof normalized.metadata.responsesResume === "object"
-            ? normalized.metadata.responsesResume
-            : undefined;
-        const inboundStage2 = await runReqInboundStage2SemanticMap({
+        }));
+        const responsesResumeFromMetadata = readResponsesResumeFromMetadata(normalized.metadata);
+        const inboundStage2 = await measureHubStage(normalized.id, "req_inbound.stage2_semantic_map", () => runReqInboundStage2SemanticMap({
             adapterContext: inboundAdapterContext,
             formatEnvelope,
             semanticMapper,
@@ -358,30 +462,24 @@ export class HubPipeline {
                 ? { responsesResume: responsesResumeFromMetadata }
                 : {}),
             stageRecorder: inboundRecorder,
-        });
+        }));
         // responsesResume must not enter chat_process as metadata; it is lifted into chat.semantics in stage2.
         if (responsesResumeFromMetadata &&
             normalized.metadata &&
             Object.prototype.hasOwnProperty.call(normalized.metadata, "responsesResume")) {
             delete normalized.metadata.responsesResume;
         }
-        const contextSnapshot = await hooks.captureContext({
-            rawRequest,
-            adapterContext: inboundAdapterContext,
-            stageRecorder: inboundRecorder,
+        const contextSnapshot = await measureHubStage(normalized.id, "req_inbound.stage3_context_capture", () => {
+            if (inboundStage2.responsesContext) {
+                return inboundStage2.responsesContext;
+            }
+            return hooks.captureContext({
+                rawRequest,
+                adapterContext: inboundAdapterContext,
+                stageRecorder: inboundRecorder,
+            });
         });
-        let standardizedRequest = inboundStage2.standardizedRequest;
-        // 全局唯一的历史图片清理：在 chat process 入口处，清理非最新 user 消息中的图片信息
-        try {
-            const { stripHistoricalImageAttachments } = await import("../process/chat-process-media.js");
-            standardizedRequest = {
-                ...standardizedRequest,
-                messages: stripHistoricalImageAttachments(standardizedRequest.messages),
-            };
-        }
-        catch {
-            // best-effort: don't block on media cleanup failures
-        }
+        let standardizedRequest = applyChatProcessEntryMediaCleanup(inboundStage2.standardizedRequest);
         try {
             const rt = readRuntimeMetadata(normalized.metadata);
             const mode = String(rt?.applyPatchToolMode || "")
@@ -397,9 +495,6 @@ export class HubPipeline {
         const activeProcessMode = resolveActiveProcessMode(normalized.processMode, standardizedRequest.messages);
         if (activeProcessMode !== normalized.processMode) {
             normalized.processMode = activeProcessMode;
-            normalized.metadata = normalized.metadata || {};
-            normalized.metadata.processMode =
-                activeProcessMode;
         }
         const passthroughAudit = activeProcessMode === "passthrough"
             ? buildPassthroughAudit(rawRequest, normalized.providerProtocol)
@@ -442,14 +537,14 @@ export class HubPipeline {
         let processedRequest;
         if (activeProcessMode !== "passthrough") {
             assertNoMappableSemanticsInMetadata(metaBase, "chat_process.request.entry");
-            const processResult = await runReqProcessStage1ToolGovernance({
+            const processResult = await measureHubStage(normalized.id, "req_process.stage1_tool_governance", () => runReqProcessStage1ToolGovernance({
                 request: standardizedRequest,
                 rawPayload: rawRequest,
                 metadata: metaBase,
                 entryEndpoint: normalized.entryEndpoint,
                 requestId: normalized.id,
                 stageRecorder: inboundRecorder,
-            });
+            }));
             processedRequest = processResult.processedRequest;
             // Surface request-side clock reservation into pipeline metadata so response conversion
             // can commit delivery only after a successful response is produced.
@@ -482,11 +577,11 @@ export class HubPipeline {
                 annotatePassthroughGovernanceSkip(passthroughAudit);
             }
         }
-        let workingRequest = processedRequest ?? standardizedRequest;
+        let workingRequest = syncResponsesContextFromCanonicalMessages(processedRequest ?? standardizedRequest);
         // 使用与 VirtualRouter 一致的 tiktoken 计数逻辑，对标准化请求进行一次
         // 上下文 token 估算，供后续 usage 归一化与统计使用。
         try {
-            const estimatedTokens = computeRequestTokens(workingRequest, "");
+            const estimatedTokens = estimateSessionBoundTokens(workingRequest, normalized.metadata) ?? computeRequestTokens(workingRequest, "");
             if (typeof estimatedTokens === "number" &&
                 Number.isFinite(estimatedTokens) &&
                 estimatedTokens > 0) {
@@ -501,30 +596,9 @@ export class HubPipeline {
         const normalizedMeta = normalized.metadata;
         // responsesResume is a client-protocol semantic (/v1/responses tool loop) and must live in chat.semantics.
         // Do not read it from metadata once entering chat_process.
-        const responsesResume = (() => {
-            try {
-                const semantics = workingRequest?.semantics;
-                const node = semantics &&
-                    typeof semantics === "object" &&
-                    !Array.isArray(semantics)
-                    ? semantics.responses
-                    : undefined;
-                const resume = node && typeof node === "object" && !Array.isArray(node)
-                    ? node.resume
-                    : undefined;
-                return resume && typeof resume === "object" && !Array.isArray(resume)
-                    ? resume
-                    : undefined;
-            }
-            catch {
-                return undefined;
-            }
-        })();
+        const responsesResume = readResponsesResumeFromRequestSemantics(workingRequest);
         const stdMetadata = workingRequest?.metadata;
-        const hasImageAttachment = stdMetadata?.hasImageAttachment === true ||
-            stdMetadata?.hasImageAttachment === "true" ||
-            normalizedMeta?.hasImageAttachment === true ||
-            normalizedMeta?.hasImageAttachment === "true";
+        const hasImageAttachment = containsImageAttachment((workingRequest.messages ?? []));
         const serverToolRequired = stdMetadata?.webSearchEnabled === true ||
             stdMetadata?.serverToolRequired === true;
         const sessionIdentifiers = extractSessionIdentifiersFromMetadata(normalized.metadata);
@@ -573,6 +647,7 @@ export class HubPipeline {
                 : {}),
             ...stopMessageRouterMetadata,
         };
+        logHubStageTiming(normalized.id, "req_process.stage2_route_select", "start");
         const routing = runReqProcessStage2RouteSelect({
             routerEngine: this.routerEngine,
             request: workingRequest,
@@ -580,21 +655,7 @@ export class HubPipeline {
             normalizedMetadata: normalized.metadata,
             stageRecorder: inboundRecorder,
         });
-        const stopMessageState = this.routerEngine.getStopMessageState(metadataInput);
-        const preCommandState = this.routerEngine.getPreCommandState(metadataInput);
-        if ((stopMessageState || preCommandState) &&
-            normalized.metadata &&
-            typeof normalized.metadata === "object") {
-            const rt = ensureRuntimeMetadata(normalized.metadata);
-            if (stopMessageState) {
-                rt.stopMessageState =
-                    stopMessageState;
-            }
-            if (preCommandState) {
-                rt.preCommandState =
-                    preCommandState;
-            }
-        }
+        logHubStageTiming(normalized.id, "req_process.stage2_route_select", "completed");
         // Emit virtual router hit log for debugging (orange [virtual-router] ...)
         try {
             const routeName = routing.decision?.routeName;
@@ -660,23 +721,23 @@ export class HubPipeline {
             const outboundContextSnapshot = protocolSwitch
                 ? undefined
                 : contextSnapshot;
-            const outboundStage1 = await runReqOutboundStage1SemanticMap({
+            const outboundStage1 = await measureHubStage(normalized.id, "req_outbound.stage1_semantic_map", () => runReqOutboundStage1SemanticMap({
                 request: workingRequest,
                 adapterContext: outboundAdapterContext,
                 semanticMapper: outboundSemanticMapper,
                 contextSnapshot: outboundContextSnapshot,
                 contextMetadataKey: outboundContextMetadataKey,
                 stageRecorder: outboundRecorder,
-            });
-            let formattedPayload = await runReqOutboundStage2FormatBuild({
+            }));
+            let formattedPayload = await measureHubStage(normalized.id, "req_outbound.stage2_format_build", () => runReqOutboundStage2FormatBuild({
                 formatEnvelope: outboundStage1.formatEnvelope,
                 stageRecorder: outboundRecorder,
-            });
-            formattedPayload = await runReqOutboundStage3Compat({
+            }));
+            formattedPayload = await measureHubStage(normalized.id, "req_outbound.stage3_compat", () => runReqOutboundStage3Compat({
                 payload: formattedPayload,
                 adapterContext: outboundAdapterContext,
                 stageRecorder: outboundRecorder,
-            });
+            }));
             if (shadowCompareBaselineMode) {
                 const baselinePolicy = {
                     ...(effectivePolicy ?? {}),
@@ -771,7 +832,7 @@ export class HubPipeline {
         //
         // 注意：这里不再根据 processMode(passthrough/chat) 做分支判断——即使某些
         // route 将 processMode 标记为 passthrough，我们仍然需要保留一次规范化后的
-        // Chat 请求快照，供 stopMessage / empty_reply_continue 等被动触发型
+        // Chat 请求快照，供 stopMessage 等被动触发型
         // servertool 在响应阶段使用。
         //
         // 之前这里通过 JSON.stringify/parse 做深拷贝，但在部分 Responses/Gemini
@@ -796,7 +857,6 @@ export class HubPipeline {
         };
         const metadata = {
             ...normalized.metadata,
-            ...(hasImageAttachment ? { hasImageAttachment: true } : {}),
             capturedChatRequest,
             entryEndpoint: normalized.entryEndpoint,
             providerProtocol: outboundProtocol,
@@ -819,6 +879,12 @@ export class HubPipeline {
                 }
                 : {}),
         };
+        if (hasImageAttachment) {
+            metadata.hasImageAttachment = true;
+        }
+        else {
+            delete metadata.hasImageAttachment;
+        }
         return {
             requestId: normalized.id,
             providerPayload,
@@ -956,25 +1022,11 @@ export class HubPipeline {
             rtBase.clock = clockConfig;
         }
         normalized.metadata = metaBase;
-        const standardizedRequest = standardizedRequestBase;
-        // 全局唯一的历史图片清理：在 chat process 入口处，清理非最新 user 消息中的图片信息
-        let cleanedRequest = standardizedRequest;
-        try {
-            const { stripHistoricalImageAttachments } = await import("../process/chat-process-media.js");
-            cleanedRequest = {
-                ...cleanedRequest,
-                messages: stripHistoricalImageAttachments(cleanedRequest.messages),
-            };
-        }
-        catch {
-            // best-effort: don't block on media cleanup failures
-        }
+        const cleanedRequest = applyChatProcessEntryMediaCleanup(standardizedRequestBase);
+        let standardizedRequest = cleanedRequest;
         const activeProcessMode = resolveActiveProcessMode(normalized.processMode, cleanedRequest.messages);
         if (activeProcessMode !== normalized.processMode) {
             normalized.processMode = activeProcessMode;
-            normalized.metadata = normalized.metadata || {};
-            normalized.metadata.processMode =
-                activeProcessMode;
         }
         const passthroughAudit = activeProcessMode === "passthrough"
             ? buildPassthroughAudit(rawPayload, normalized.providerProtocol)
@@ -982,26 +1034,7 @@ export class HubPipeline {
         // Semantic Gate (chat_process entry): lift any mappable protocol semantics from metadata into request.semantics.
         // This is the last chance before entering chat_process; after this point we fail-fast on banned metadata keys.
         try {
-            const resumeMeta = metaBase &&
-                typeof metaBase.responsesResume === "object" &&
-                metaBase.responsesResume
-                ? metaBase.responsesResume
-                : undefined;
-            if (resumeMeta) {
-                standardizedRequest.semantics =
-                    standardizedRequest.semantics ?? {};
-                const semantics = standardizedRequest.semantics;
-                if (!semantics.responses ||
-                    typeof semantics.responses !== "object" ||
-                    Array.isArray(semantics.responses)) {
-                    semantics.responses = {};
-                }
-                const responsesNode = semantics.responses;
-                if (responsesNode.resume === undefined) {
-                    responsesNode.resume = jsonClone(resumeMeta);
-                }
-                delete metaBase.responsesResume;
-            }
+            standardizedRequest = liftResponsesResumeIntoSemantics(standardizedRequest, metaBase);
         }
         catch {
             // best-effort; validation happens below
@@ -1065,10 +1098,10 @@ export class HubPipeline {
                 annotatePassthroughGovernanceSkip(passthroughAudit);
             }
         }
-        let workingRequest = processedRequest ?? standardizedRequest;
+        let workingRequest = syncResponsesContextFromCanonicalMessages(processedRequest ?? standardizedRequest);
         // Token estimate for stats/diagnostics (best-effort).
         try {
-            const estimatedTokens = computeRequestTokens(workingRequest, "");
+            const estimatedTokens = estimateSessionBoundTokens(workingRequest, normalized.metadata) ?? computeRequestTokens(workingRequest, "");
             if (typeof estimatedTokens === "number" &&
                 Number.isFinite(estimatedTokens) &&
                 estimatedTokens > 0) {
@@ -1083,30 +1116,9 @@ export class HubPipeline {
         const normalizedMeta = normalized.metadata;
         // responsesResume is a client-protocol semantic (/v1/responses tool loop) and must live in chat.semantics.
         // Do not read it from metadata once entering chat_process.
-        const responsesResume = (() => {
-            try {
-                const semantics = workingRequest?.semantics;
-                const node = semantics &&
-                    typeof semantics === "object" &&
-                    !Array.isArray(semantics)
-                    ? semantics.responses
-                    : undefined;
-                const resume = node && typeof node === "object" && !Array.isArray(node)
-                    ? node.resume
-                    : undefined;
-                return resume && typeof resume === "object" && !Array.isArray(resume)
-                    ? resume
-                    : undefined;
-            }
-            catch {
-                return undefined;
-            }
-        })();
+        const responsesResume = readResponsesResumeFromRequestSemantics(workingRequest);
         const stdMetadata = workingRequest?.metadata;
-        const hasImageAttachment = stdMetadata?.hasImageAttachment === true ||
-            stdMetadata?.hasImageAttachment === "true" ||
-            normalizedMeta?.hasImageAttachment === true ||
-            normalizedMeta?.hasImageAttachment === "true";
+        const hasImageAttachment = containsImageAttachment((workingRequest.messages ?? []));
         const serverToolRequired = stdMetadata?.webSearchEnabled === true ||
             stdMetadata?.serverToolRequired === true;
         const sessionIdentifiers = extractSessionIdentifiersFromMetadata(normalized.metadata);
@@ -1151,21 +1163,6 @@ export class HubPipeline {
             normalizedMetadata: normalized.metadata,
             stageRecorder,
         });
-        const stopMessageState = this.routerEngine.getStopMessageState(metadataInput);
-        const preCommandState = this.routerEngine.getPreCommandState(metadataInput);
-        if ((stopMessageState || preCommandState) &&
-            normalized.metadata &&
-            typeof normalized.metadata === "object") {
-            const rt = ensureRuntimeMetadata(normalized.metadata);
-            if (stopMessageState) {
-                rt.stopMessageState =
-                    stopMessageState;
-            }
-            if (preCommandState) {
-                rt.preCommandState =
-                    preCommandState;
-            }
-        }
         // Emit virtual router hit log for debugging (same as inbound path).
         try {
             const routeName = routing.decision?.routeName;
@@ -1224,23 +1221,23 @@ export class HubPipeline {
                 ? outboundHooks.contextMetadataKey
                 : hooks.contextMetadataKey;
             const outboundContextSnapshot = undefined;
-            const outboundStage1 = await runReqOutboundStage1SemanticMap({
+            const outboundStage1 = await measureHubStage(normalized.id, "req_outbound.stage1_semantic_map", () => runReqOutboundStage1SemanticMap({
                 request: workingRequest,
                 adapterContext: outboundAdapterContext,
                 semanticMapper: outboundSemanticMapper,
                 contextSnapshot: outboundContextSnapshot,
                 contextMetadataKey: outboundContextMetadataKey,
                 stageRecorder: outboundRecorder,
-            });
-            let formattedPayload = await runReqOutboundStage2FormatBuild({
+            }));
+            let formattedPayload = await measureHubStage(normalized.id, "req_outbound.stage2_format_build", () => runReqOutboundStage2FormatBuild({
                 formatEnvelope: outboundStage1.formatEnvelope,
                 stageRecorder: outboundRecorder,
-            });
-            formattedPayload = await runReqOutboundStage3Compat({
+            }));
+            formattedPayload = await measureHubStage(normalized.id, "req_outbound.stage3_compat", () => runReqOutboundStage3Compat({
                 payload: formattedPayload,
                 adapterContext: outboundAdapterContext,
                 stageRecorder: outboundRecorder,
-            });
+            }));
             // Phase 0/1: observe + enforce provider outbound policy and tool surface (same as inbound path).
             const effectivePolicy = normalized.policyOverride ?? this.config.policy;
             recordHubPolicyObservation({
@@ -1312,7 +1309,6 @@ export class HubPipeline {
         };
         const metadata = {
             ...normalized.metadata,
-            ...(hasImageAttachment ? { hasImageAttachment: true } : {}),
             capturedChatRequest,
             entryEndpoint: normalized.entryEndpoint,
             providerProtocol: outboundProtocol,
@@ -1325,6 +1321,12 @@ export class HubPipeline {
                 ? { providerStream: outboundStream }
                 : {}),
         };
+        if (hasImageAttachment) {
+            metadata.hasImageAttachment = true;
+        }
+        else {
+            delete metadata.hasImageAttachment;
+        }
         return {
             requestId: normalized.id,
             providerPayload,
@@ -1759,11 +1761,9 @@ export class HubPipeline {
             direction,
             stage,
             stream,
+            ...(routeHint ? { routeHint } : {}),
             ...(orchestrationResult.metadata ?? {}),
         };
-        if (routeHint) {
-            normalizedMetadata.routeHint = routeHint;
-        }
         return {
             id,
             endpoint,

package/dist/conversion/hub/pipeline/hub-stage-timing.d.ts

@@ -0,0 +1,6 @@
+export declare function logHubStageTiming(requestId: string, stage: string, phase: 'start' | 'completed' | 'error', details?: Record<string, unknown>): void;
+export declare function measureHubStage<T>(requestId: string, stage: string, fn: () => Promise<T> | T, options?: {
+    startDetails?: Record<string, unknown>;
+    mapCompletedDetails?: (value: T) => Record<string, unknown> | undefined;
+    mapErrorDetails?: (error: unknown) => Record<string, unknown> | undefined;
+}): Promise<T>;