ГЛОБАЛЬНЫЙ РЕФАКТОРИНГ АРХИТЕКТУРЫ - Рефакторинг этапов 2.34 вынос address-ветку (orchestration + lane + finalize) в единый runtime-оркестратор, чтобы handleMessage стал почти плоским.

2026-04-10 22:26:05 +03:00
parent 353cbc1763
commit 9c22460e8b
9 changed files with 869 additions and 185 deletions
@@ -0,0 +1,189 @@
+import {
+  buildAssistantAddressOrchestrationRuntime,
+  type AssistantAddressCarryoverLike,
+  type BuildAssistantAddressOrchestrationRuntimeInput,
+  type BuildAssistantAddressOrchestrationRuntimeOutput
+} from "./assistantAddressOrchestrationRuntimeAdapter";
+import {
+  runAssistantAddressLaneRuntime,
+  type AssistantAddressLaneLike,
+  type RunAssistantAddressLaneRuntimeOutput
+} from "./assistantAddressLaneRuntimeAdapter";
+import {
+  runAssistantAddressToolGateRuntime,
+  type AssistantAddressToolGateRuntimeOutput
+} from "./assistantAddressToolGateRuntimeAdapter";
+
+export interface RunAssistantAddressRuntimeInput<ResponseType = unknown> {
+  featureAssistantAddressQueryV1: boolean;
+  sessionId: string;
+  userMessage: string;
+  sessionItems: unknown[];
+  llmProvider: unknown;
+  useMock: boolean;
+  featureAddressLlmPredecomposeV1: boolean;
+  runAddressLlmPreDecompose: () => Promise<Record<string, unknown>>;
+  buildAddressLlmPredecomposeContractV1: BuildAssistantAddressOrchestrationRuntimeInput["buildAddressLlmPredecomposeContractV1"];
+  sanitizeAddressMessageForFallback: BuildAssistantAddressOrchestrationRuntimeInput["sanitizeAddressMessageForFallback"];
+  toNonEmptyString: (value: unknown) => string | null;
+  resolveAddressFollowupCarryoverContext: BuildAssistantAddressOrchestrationRuntimeInput["resolveAddressFollowupCarryoverContext"];
+  resolveAssistantOrchestrationDecision: BuildAssistantAddressOrchestrationRuntimeInput["resolveAssistantOrchestrationDecision"];
+  buildAddressDialogContinuationContractV2: BuildAssistantAddressOrchestrationRuntimeInput["buildAddressDialogContinuationContractV2"];
+  runtimeAnalysisContextAsOfDate: string | null;
+  payloadContextPeriodHint: unknown;
+  compactWhitespace: (value: string) => string;
+  runAddressLaneAttempt: (
+    messageUsed: string,
+    carryMeta: AssistantAddressCarryoverLike | null,
+    analysisDateHint: string | null
+  ) => Promise<AssistantAddressLaneLike | null>;
+  isRetryableAddressLimitedResult: (addressLane: AssistantAddressLaneLike | null | undefined) => boolean;
+  finalizeAddressLaneResponse: (
+    addressLane: AssistantAddressLaneLike,
+    effectiveAddressUserMessage: string,
+    carryoverMeta?: AssistantAddressCarryoverLike | null,
+    llmPreDecomposeMeta?: Record<string, unknown> | null
+  ) => ResponseType;
+  tryHandleLivingChat: (
+    modeDecision: { mode?: unknown; reason?: unknown },
+    addressRuntimeMeta: Record<string, unknown> | null
+  ) => Promise<ResponseType | null>;
+  logEvent: (payload: Record<string, unknown>) => void;
+  nowIso: () => string;
+  runAddressOrchestrationRuntime?: (
+    input: BuildAssistantAddressOrchestrationRuntimeInput
+  ) => Promise<BuildAssistantAddressOrchestrationRuntimeOutput>;
+  runAddressToolGateRuntime?: (
+    input: {
+      sessionId: string;
+      userMessage: string;
+      addressInputMessage: string;
+      orchestrationDecision: BuildAssistantAddressOrchestrationRuntimeOutput["orchestrationDecision"];
+      livingModeDecision: BuildAssistantAddressOrchestrationRuntimeOutput["livingModeDecision"];
+      addressRuntimeMeta: BuildAssistantAddressOrchestrationRuntimeOutput["addressRuntimeMeta"];
+      logEvent: (payload: Record<string, unknown>) => void;
+      tryHandleLivingChat: (
+        modeDecision: { mode?: unknown; reason?: unknown },
+        addressRuntimeMeta: Record<string, unknown> | null
+      ) => Promise<ResponseType | null>;
+      nowIso: () => string;
+    }
+  ) => Promise<AssistantAddressToolGateRuntimeOutput<ResponseType>>;
+  runAddressLaneRuntime?: (
+    input: {
+      userMessage: string;
+      addressInputMessage: string;
+      carryover: AssistantAddressCarryoverLike | null;
+      shouldPreferContextualLane: boolean;
+      canRetryWithRawUserMessage: boolean;
+      runAddressLaneAttempt: (
+        messageUsed: string,
+        carryMeta: AssistantAddressCarryoverLike | null
+      ) => Promise<AssistantAddressLaneLike | null>;
+      isRetryableAddressLimitedResult: (addressLane: AssistantAddressLaneLike | null | undefined) => boolean;
+    }
+  ) => Promise<RunAssistantAddressLaneRuntimeOutput>;
+}
+
+export interface RunAssistantAddressRuntimeOutput<ResponseType = unknown> {
+  handled: boolean;
+  response: ResponseType | null;
+  addressRuntimeMetaForDeep: Record<string, unknown> | null;
+}
+
+export async function runAssistantAddressRuntime<ResponseType = unknown>(
+  input: RunAssistantAddressRuntimeInput<ResponseType>
+): Promise<RunAssistantAddressRuntimeOutput<ResponseType>> {
+  if (!input.featureAssistantAddressQueryV1) {
+    return {
+      handled: false,
+      response: null,
+      addressRuntimeMetaForDeep: null
+    };
+  }
+
+  const runAddressOrchestrationRuntimeSafe =
+    input.runAddressOrchestrationRuntime ?? buildAssistantAddressOrchestrationRuntime;
+  const runAddressToolGateRuntimeSafe = input.runAddressToolGateRuntime ?? runAssistantAddressToolGateRuntime;
+  const runAddressLaneRuntimeSafe = input.runAddressLaneRuntime ?? runAssistantAddressLaneRuntime;
+
+  const addressOrchestrationRuntime = await runAddressOrchestrationRuntimeSafe({
+    userMessage: input.userMessage,
+    sessionItems: input.sessionItems,
+    llmProvider: input.llmProvider,
+    useMock: input.useMock,
+    featureAddressLlmPredecomposeV1: input.featureAddressLlmPredecomposeV1,
+    runAddressLlmPreDecompose: input.runAddressLlmPreDecompose,
+    buildAddressLlmPredecomposeContractV1: input.buildAddressLlmPredecomposeContractV1,
+    sanitizeAddressMessageForFallback: input.sanitizeAddressMessageForFallback,
+    toNonEmptyString: input.toNonEmptyString,
+    resolveAddressFollowupCarryoverContext: input.resolveAddressFollowupCarryoverContext,
+    resolveAssistantOrchestrationDecision: input.resolveAssistantOrchestrationDecision,
+    buildAddressDialogContinuationContractV2: input.buildAddressDialogContinuationContractV2
+  });
+  const addressInputMessage = addressOrchestrationRuntime.addressInputMessage;
+  const carryover = addressOrchestrationRuntime.carryover;
+  const orchestrationDecision = addressOrchestrationRuntime.orchestrationDecision;
+  const addressRuntimeMeta = addressOrchestrationRuntime.addressRuntimeMeta;
+  const livingModeDecision = addressOrchestrationRuntime.livingModeDecision;
+  const addressRuntimeMetaForDeep = addressRuntimeMeta;
+
+  const toolGateRuntime = await runAddressToolGateRuntimeSafe({
+    sessionId: input.sessionId,
+    userMessage: input.userMessage,
+    addressInputMessage,
+    orchestrationDecision,
+    livingModeDecision,
+    addressRuntimeMeta,
+    logEvent: input.logEvent,
+    tryHandleLivingChat: input.tryHandleLivingChat,
+    nowIso: input.nowIso
+  });
+  if (toolGateRuntime.handled && toolGateRuntime.response) {
+    return {
+      handled: true,
+      response: toolGateRuntime.response,
+      addressRuntimeMetaForDeep
+    };
+  }
+
+  if (Boolean(orchestrationDecision.runAddressLane)) {
+    const shouldPreferContextualLane = Boolean(carryover?.followupContext);
+    const analysisDateHint = input.runtimeAnalysisContextAsOfDate ?? input.toNonEmptyString(input.payloadContextPeriodHint);
+    const canRetryWithRawUserMessage =
+      input.compactWhitespace(String(addressInputMessage ?? "").toLowerCase()) !==
+      input.compactWhitespace(String(input.userMessage ?? "").toLowerCase());
+    const addressLaneRuntime = await runAddressLaneRuntimeSafe({
+      userMessage: input.userMessage,
+      addressInputMessage,
+      carryover,
+      shouldPreferContextualLane,
+      canRetryWithRawUserMessage,
+      runAddressLaneAttempt: (messageUsed, carryMeta) =>
+        input.runAddressLaneAttempt(messageUsed, carryMeta, analysisDateHint),
+      isRetryableAddressLimitedResult: input.isRetryableAddressLimitedResult
+    });
+    if (addressLaneRuntime.handled && addressLaneRuntime.selection) {
+      const response = input.finalizeAddressLaneResponse(
+        addressLaneRuntime.selection.addressLane,
+        addressLaneRuntime.selection.messageUsed,
+        addressLaneRuntime.selection.carryMeta,
+        {
+          ...addressRuntimeMeta,
+          addressRetryAudit: { ...addressLaneRuntime.retryAudit }
+        }
+      );
+      return {
+        handled: true,
+        response,
+        addressRuntimeMetaForDeep
+      };
+    }
+  }
+
+  return {
+    handled: false,
+    response: null,
+    addressRuntimeMetaForDeep
+  };
+}