ГЛОБАЛЬНЫЙ РЕФАКТОРИНГ АРХИТЕКТУРЫ - Рефакторинг этапов 2.25 финализацию address-ветки в отдельный adapter \ Переподключил assistantService на новый adapter (без смены поведения)

2026-04-10 19:37:56 +03:00
parent 80d108e506
commit 205daeccc5
9 changed files with 794 additions and 209 deletions
@@ -0,0 +1,190 @@
+import { nanoid } from "nanoid";
+import type {
+  AssistantConversationItem,
+  AssistantDebugPayload,
+  AssistantMessageResponsePayload,
+  AssistantReplyType
+} from "../types/assistant";
+import type { AddressExecutionDebug } from "../types/addressQuery";
+import type { CommitAssistantTurnAndLogOutput } from "./assistantTurnCommitRuntimeAdapter";
+import { commitAssistantTurnAndLog } from "./assistantTurnCommitRuntimeAdapter";
+
+export interface AddressCarryoverMetaLogInput {
+  previousAddressIntent?: string | null;
+  previousAddressAnchor?: string | null;
+}
+
+export interface AddressLlmPreDecomposeMetaLogInput {
+  attempted?: boolean;
+  applied?: boolean;
+  provider?: string | null;
+  traceId?: string | null;
+  reason?: string | null;
+  fallbackRuleHit?: string | null;
+  sanitizedUserMessage?: string | null;
+  toolGateDecision?: string | null;
+  toolGateReason?: string | null;
+  dialogContinuationContract?: {
+    decision?: string | null;
+    target_intent?: string | null;
+  } | null;
+  addressRetryAudit?: {
+    attempted?: boolean;
+    reason?: string | null;
+    initial_limited_category?: string | null;
+    retry_result_category?: string | null;
+  } | null;
+  predecomposeContract?: {
+    intent?: string | null;
+    aggregation_profile?: string | null;
+    period?: {
+      scope?: string | null;
+    } | null;
+  } | null;
+}
+
+export interface FinalizeAssistantAddressTurnInput {
+  sessionId: string;
+  userMessage: string;
+  effectiveAddressUserMessage: string;
+  assistantReply: string;
+  replyType: AssistantReplyType;
+  addressLaneDebug: AddressExecutionDebug;
+  debug: AssistantDebugPayload | Record<string, unknown>;
+  carryoverMeta?: AddressCarryoverMetaLogInput | null;
+  llmPreDecomposeMeta?: AddressLlmPreDecomposeMetaLogInput | null;
+  appendItem: Parameters<typeof commitAssistantTurnAndLog>[0]["appendItem"];
+  getSession: Parameters<typeof commitAssistantTurnAndLog>[0]["getSession"];
+  persistSession: Parameters<typeof commitAssistantTurnAndLog>[0]["persistSession"];
+  cloneConversation: Parameters<typeof commitAssistantTurnAndLog>[0]["cloneConversation"];
+  logEvent: Parameters<typeof commitAssistantTurnAndLog>[0]["logEvent"];
+  nowIso?: () => string;
+  messageIdFactory?: () => string;
+  commitFn?: typeof commitAssistantTurnAndLog;
+}
+
+export interface FinalizeAssistantAddressTurnOutput {
+  assistantItem: AssistantConversationItem;
+  commitResult: CommitAssistantTurnAndLogOutput;
+  response: AssistantMessageResponsePayload;
+}
+
+function toTraceId(debug: AssistantDebugPayload | Record<string, unknown>): string | null {
+  const value = (debug as Record<string, unknown> | null | undefined)?.trace_id;
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+
+function buildAddressProcessedLogDetails(input: FinalizeAssistantAddressTurnInput, assistantItem: AssistantConversationItem) {
+  const laneDebug = input.addressLaneDebug;
+  const llmMeta = input.llmPreDecomposeMeta;
+  const carryover = input.carryoverMeta;
+
+  return {
+    session_id: input.sessionId,
+    message_id: assistantItem.message_id,
+    user_message: input.userMessage,
+    effective_address_user_message: input.effectiveAddressUserMessage,
+    address_followup_context_applied: Boolean(carryover),
+    address_followup_context_previous_intent: carryover?.previousAddressIntent ?? null,
+    address_followup_context_previous_anchor: carryover?.previousAddressAnchor ?? null,
+    address_llm_predecompose_attempted: Boolean(llmMeta?.attempted),
+    address_llm_predecompose_applied: Boolean(llmMeta?.applied),
+    address_llm_predecompose_provider: llmMeta?.provider ?? null,
+    address_llm_predecompose_trace_id: llmMeta?.traceId ?? null,
+    address_llm_predecompose_reason: llmMeta?.reason ?? null,
+    address_fallback_rule_hit: llmMeta?.fallbackRuleHit ?? null,
+    address_sanitized_user_message: llmMeta?.sanitizedUserMessage ?? null,
+    address_tool_gate_decision: llmMeta?.toolGateDecision ?? null,
+    address_tool_gate_reason: llmMeta?.toolGateReason ?? null,
+    address_dialog_continuation_decision: llmMeta?.dialogContinuationContract?.decision ?? null,
+    address_dialog_continuation_target_intent: llmMeta?.dialogContinuationContract?.target_intent ?? null,
+    address_retry_attempted: Boolean(llmMeta?.addressRetryAudit?.attempted),
+    address_retry_reason: llmMeta?.addressRetryAudit?.reason ?? null,
+    address_retry_initial_limited_category: llmMeta?.addressRetryAudit?.initial_limited_category ?? null,
+    address_retry_result_category: llmMeta?.addressRetryAudit?.retry_result_category ?? null,
+    address_llm_predecompose_contract_intent: llmMeta?.predecomposeContract?.intent ?? null,
+    address_llm_predecompose_contract_aggregation_profile: llmMeta?.predecomposeContract?.aggregation_profile ?? null,
+    address_llm_predecompose_contract_period_scope: llmMeta?.predecomposeContract?.period?.scope ?? null,
+    detected_mode: laneDebug.detected_mode,
+    query_shape: laneDebug.query_shape,
+    detected_intent: laneDebug.detected_intent,
+    extracted_filters: laneDebug.extracted_filters,
+    selected_recipe: laneDebug.selected_recipe,
+    mcp_call_status_legacy: laneDebug.mcp_call_status_legacy,
+    account_scope_mode: laneDebug.account_scope_mode,
+    account_scope_fallback_applied: laneDebug.account_scope_fallback_applied,
+    anchor_type: laneDebug.anchor_type,
+    resolver_confidence: laneDebug.resolver_confidence,
+    match_failure_stage: laneDebug.match_failure_stage,
+    match_failure_reason: laneDebug.match_failure_reason,
+    mcp_call_status: laneDebug.mcp_call_status,
+    rows_fetched: laneDebug.rows_fetched,
+    raw_rows_received: laneDebug.raw_rows_received,
+    rows_after_account_scope: laneDebug.rows_after_account_scope,
+    rows_after_recipe_filter: laneDebug.rows_after_recipe_filter,
+    rows_materialized: laneDebug.rows_materialized,
+    rows_matched: laneDebug.rows_matched,
+    materialization_drop_reason: laneDebug.materialization_drop_reason,
+    account_token_raw: laneDebug.account_token_raw,
+    account_token_normalized: laneDebug.account_token_normalized,
+    account_scope_fields_checked: laneDebug.account_scope_fields_checked,
+    account_scope_match_strategy: laneDebug.account_scope_match_strategy,
+    account_scope_drop_reason: laneDebug.account_scope_drop_reason,
+    runtime_readiness: laneDebug.runtime_readiness,
+    limited_reason_category: laneDebug.limited_reason_category,
+    response_type: laneDebug.response_type,
+    limitations: laneDebug.limitations,
+    assistant_reply: assistantItem.text,
+    reply_type: assistantItem.reply_type,
+    trace_id: assistantItem.trace_id
+  };
+}
+
+export function finalizeAssistantAddressTurn(
+  input: FinalizeAssistantAddressTurnInput
+): FinalizeAssistantAddressTurnOutput {
+  const nowIso = input.nowIso ?? (() => new Date().toISOString());
+  const messageIdFactory = input.messageIdFactory ?? (() => `msg-${nanoid(10)}`);
+  const commitSafe = input.commitFn ?? commitAssistantTurnAndLog;
+  const assistantItem: AssistantConversationItem = {
+    message_id: messageIdFactory(),
+    session_id: input.sessionId,
+    role: "assistant",
+    text: input.assistantReply,
+    reply_type: input.replyType,
+    created_at: nowIso(),
+    trace_id: toTraceId(input.debug),
+    debug: input.debug as AssistantDebugPayload
+  };
+  const logDetails = buildAddressProcessedLogDetails(input, assistantItem);
+  const commitResult = commitSafe({
+    sessionId: input.sessionId,
+    assistantItem,
+    eventType: "assistant_message_address",
+    logDetails,
+    appendItem: input.appendItem,
+    getSession: input.getSession,
+    persistSession: input.persistSession,
+    cloneConversation: input.cloneConversation,
+    logEvent: input.logEvent
+  });
+  const response: AssistantMessageResponsePayload = {
+    ok: true,
+    session_id: input.sessionId,
+    assistant_reply: assistantItem.text,
+    reply_type: assistantItem.reply_type as AssistantReplyType,
+    conversation_item: assistantItem,
+    debug: input.debug as AssistantDebugPayload,
+    conversation: commitResult.conversation
+  };
+
+  return {
+    assistantItem,
+    commitResult,
+    response
+  };
+}