ARCH: прикрепить debug MCP discovery

llm_normalizer/backend/src/services/assistantMcpDiscoveryDebugAttachment.ts

@@ -0,0 +1,82 @@
+import type { AssistantMcpDiscoveryRuntimeEntryPointContract } from "./assistantMcpDiscoveryRuntimeEntryPoint";
+
+export interface AssistantMcpDiscoveryDebugAttachmentFields {
+  assistant_mcp_discovery_entry_point_v1: AssistantMcpDiscoveryRuntimeEntryPointContract | null;
+  mcp_discovery_entry_status: string | null;
+  mcp_discovery_attempted: boolean;
+  mcp_discovery_hot_runtime_wired: false;
+  mcp_discovery_bridge_status: string | null;
+  mcp_discovery_answer_mode: string | null;
+  mcp_discovery_business_fact_answer_allowed: boolean;
+  mcp_discovery_user_facing_response_allowed: boolean;
+  mcp_discovery_requires_clarification: boolean;
+}
+
+export interface AttachAssistantMcpDiscoveryDebugInput {
+  entryPoint?: unknown;
+  addressRuntimeMeta?: Record<string, unknown> | null;
+}
+
+function toRecordObject(value: unknown): Record<string, unknown> | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  return value as Record<string, unknown>;
+}
+
+function toNonEmptyString(value: unknown): string | null {
+  if (value === null || value === undefined) {
+    return null;
+  }
+  const text = String(value).trim();
+  return text.length > 0 ? text : null;
+}
+
+function isMcpDiscoveryEntryPointContract(value: unknown): value is AssistantMcpDiscoveryRuntimeEntryPointContract {
+  const record = toRecordObject(value);
+  return (
+    record?.schema_version === "assistant_mcp_discovery_runtime_entry_point_v1" &&
+    record?.policy_owner === "assistantMcpDiscoveryRuntimeEntryPoint"
+  );
+}
+
+function resolveEntryPoint(input: AttachAssistantMcpDiscoveryDebugInput): AssistantMcpDiscoveryRuntimeEntryPointContract | null {
+  if (isMcpDiscoveryEntryPointContract(input.entryPoint)) {
+    return input.entryPoint;
+  }
+  const runtimeMetaEntryPoint =
+    input.addressRuntimeMeta?.mcpDiscoveryRuntimeEntryPoint ??
+    input.addressRuntimeMeta?.assistantMcpDiscoveryRuntimeEntryPoint ??
+    input.addressRuntimeMeta?.assistant_mcp_discovery_entry_point_v1;
+  return isMcpDiscoveryEntryPointContract(runtimeMetaEntryPoint) ? runtimeMetaEntryPoint : null;
+}
+
+export function buildAssistantMcpDiscoveryDebugAttachmentFields(
+  input: AttachAssistantMcpDiscoveryDebugInput
+): AssistantMcpDiscoveryDebugAttachmentFields {
+  const entryPoint = resolveEntryPoint(input);
+  const bridge = toRecordObject(entryPoint?.bridge);
+  const answerDraft = toRecordObject(bridge?.answer_draft);
+
+  return {
+    assistant_mcp_discovery_entry_point_v1: entryPoint,
+    mcp_discovery_entry_status: toNonEmptyString(entryPoint?.entry_status),
+    mcp_discovery_attempted: Boolean(entryPoint?.discovery_attempted),
+    mcp_discovery_hot_runtime_wired: false,
+    mcp_discovery_bridge_status: toNonEmptyString(bridge?.bridge_status),
+    mcp_discovery_answer_mode: toNonEmptyString(answerDraft?.answer_mode),
+    mcp_discovery_business_fact_answer_allowed: bridge?.business_fact_answer_allowed === true,
+    mcp_discovery_user_facing_response_allowed: bridge?.user_facing_response_allowed === true,
+    mcp_discovery_requires_clarification: bridge?.requires_user_clarification === true
+  };
+}
+
+export function attachAssistantMcpDiscoveryDebug<T extends Record<string, unknown>>(
+  debugPayload: T,
+  input: AttachAssistantMcpDiscoveryDebugInput
+): T & AssistantMcpDiscoveryDebugAttachmentFields {
+  return {
+    ...debugPayload,
+    ...buildAssistantMcpDiscoveryDebugAttachmentFields(input)
+  };
+}