"use strict"; Object.defineProperty(exports, "__esModule", { value: true }); exports.ASSISTANT_MCP_DISCOVERY_TURN_INPUT_SCHEMA_VERSION = void 0; exports.buildAssistantMcpDiscoveryTurnInput = buildAssistantMcpDiscoveryTurnInput; const assistantMcpDiscoveryDataNeedGraph_1 = require("./assistantMcpDiscoveryDataNeedGraph"); const addressTextRepair_1 = require("./addressTextRepair"); exports.ASSISTANT_MCP_DISCOVERY_TURN_INPUT_SCHEMA_VERSION = "assistant_mcp_discovery_turn_input_v1"; function toRecordObject(value) { if (!value || typeof value !== "object" || Array.isArray(value)) { return null; } return value; } function toNonEmptyString(value) { if (value === null || value === undefined) { return null; } const text = String(value).trim(); return text.length > 0 ? text : null; } function normalizeReasonCode(value) { const normalized = value .trim() .replace(/[^\p{L}\p{N}_.:-]+/gu, "_") .replace(/^_+|_+$/g, "") .toLowerCase(); return normalized.length > 0 ? normalized.slice(0, 120) : null; } function pushReason(target, value) { const normalized = normalizeReasonCode(value); if (normalized && !target.includes(normalized)) { target.push(normalized); } } function pushUnique(target, value) { const text = toNonEmptyString(value); if (text && !target.includes(text)) { target.push(text); } } function isReferentialEntityPlaceholder(value) { return new Set([ "он", "она", "оно", "они", "ему", "ней", "нему", "ним", "ними", "его", "ее", "их", "этому", "этой", "этим", "этими", "этом" ]).has((0, addressTextRepair_1.normalizeRussianComparableText)(value)); } function isReferentialOrganizationPlaceholder(value) { if (!value) { return false; } return new Set([ "эта организация", "этой организации", "этой организацией", "эту организацию", "эта компания", "этой компании", "этой компанией", "эту компанию", "наша организация", "нашей организации", "нашей компанией" ]).has((0, addressTextRepair_1.normalizeRussianComparableText)(value)); } function isValueFlowPredicateEntityCandidate(value) { if (!value) { return false; } const text = compactLower(value); const looksLikeRankingPredicate = /(?:прин[её]с|принес|выручк|доходн|больше\s+всего|наибольш)/iu.test(text) && /(?:организац|компан|ден[её]г|выручк|поступлен|плат[её]ж)/iu.test(text); if (!looksLikeRankingPredicate) { return false; } return !/(? normalizeFollowupCounterpartyCandidate(entity)) .filter((entity) => Boolean(entity)); const groundedDiscoveryCounterparty = ambiguityBlocksImplicitGrounding || metadataPilotCarriesScopeOnly ? null : normalizedDiscoveryEntities[0] ?? normalizeFollowupCounterpartyCandidate(loopMetadataScopeHint); const metadataScopeHint = loopMetadataScopeHint ?? (loopSubjectResolutionOptional ? normalizedDiscoveryEntities[0] ?? null : null); const previousFiltersCounterparty = normalizeFollowupCounterpartyCandidate(previousFilters?.counterparty); const rootFiltersCounterparty = normalizeFollowupCounterpartyCandidate(rootFilters?.counterparty); const previousAnchorCounterparty = toNonEmptyString(followupContext?.previous_anchor_type) === "counterparty" ? normalizeFollowupCounterpartyCandidate(followupContext?.previous_anchor_value) : null; const counterparty = groundedDiscoveryCounterparty ? groundedDiscoveryCounterparty : previousFiltersCounterparty ?? rootFiltersCounterparty ?? previousAnchorCounterparty; const organization = toNonEmptyString(previousFilters?.organization) ?? toNonEmptyString(rootFilters?.organization) ?? (toNonEmptyString(followupContext?.previous_anchor_type) === "organization" ? toNonEmptyString(followupContext?.previous_anchor_value) : null); const dateScope = collectDateScopeFromFilters(previousFilters) ?? collectDateScopeFromFilters(rootFilters); return { pilotScope: effectivePilotScope, domain: mapped.domain, action: mapped.action, unsupported: mapped.unsupported, loopStatus, loopSelectedChainId, loopPendingAxes, loopProvidedAxes, counterparty, discoveryEntity: ambiguityBlocksImplicitGrounding || loopSubjectResolutionOptional ? null : normalizedDiscoveryEntities[0] ?? null, entityResolutionStatus, entityResolutionAmbiguityCandidates, rankingNeed: toNonEmptyString(followupContext?.previous_discovery_ranking_need), organization, dateScope, metadataScopeHint, subjectResolutionOptional: loopSubjectResolutionOptional, metadataRouteFamily: normalizeMetadataRouteFamily(followupContext?.previous_discovery_metadata_route_family), metadataRouteFamilySelectionBasis: normalizeMetadataRouteFamilySelectionBasis(followupContext?.previous_discovery_metadata_route_family_selection_basis), metadataSelectedEntitySet: toNonEmptyString(followupContext?.previous_discovery_metadata_selected_entity_set), metadataSelectedSurfaceObjects: collectEntityCandidates(followupContext?.previous_discovery_metadata_selected_surface_objects), metadataRecommendedNextPrimitive: normalizeMetadataRecommendedPrimitive(followupContext?.previous_discovery_metadata_recommended_next_primitive), metadataAmbiguityDetected: followupContext?.previous_discovery_metadata_ambiguity_detected === true, metadataAmbiguityEntitySets: collectEntityCandidates(followupContext?.previous_discovery_metadata_ambiguity_entity_sets) }; } function buildMetadataSurfaceRef(followupSeed) { if (followupSeed.pilotScope !== "metadata_inspection_v1") { return null; } const hasPayload = Boolean(followupSeed.metadataRouteFamily || followupSeed.metadataSelectedEntitySet || followupSeed.metadataRecommendedNextPrimitive || followupSeed.metadataRouteFamilySelectionBasis) || followupSeed.metadataSelectedSurfaceObjects.length > 0 || followupSeed.metadataAmbiguityDetected || followupSeed.metadataAmbiguityEntitySets.length > 0; if (!hasPayload) { return null; } return { selected_entity_set: followupSeed.metadataSelectedEntitySet, selected_surface_objects: followupSeed.metadataSelectedSurfaceObjects, downstream_route_family: followupSeed.metadataRouteFamily, route_family_selection_basis: followupSeed.metadataRouteFamilySelectionBasis, recommended_next_primitive: followupSeed.metadataRecommendedNextPrimitive, ambiguity_detected: followupSeed.metadataAmbiguityDetected, ambiguity_entity_sets: followupSeed.metadataAmbiguityEntitySets }; } function metadataEntitySetsSuggestDocumentLane(values) { return values.some((value) => /(?:документ|document|invoice|waybill|накладн|счет[- ]?фактур|акт)/iu.test(value)); } function metadataEntitySetsSuggestMovementLane(values) { return values.some((value) => /(?:регистр|register|movement|движени|операц|проводк|bank)/iu.test(value)); } function metadataAmbiguityCollapsesToDocumentLane(values) { return values.length > 0 && metadataEntitySetsSuggestDocumentLane(values) && !metadataEntitySetsSuggestMovementLane(values); } function metadataAmbiguityCollapsesToMovementLane(values) { return values.length > 0 && metadataEntitySetsSuggestMovementLane(values) && !metadataEntitySetsSuggestDocumentLane(values); } function hasLifecycleSignal(text) { return /(?:сколько\s+лет|как\s+давно|давно\s+ли|возраст|перв(?:ая|ый)\s+актив|когда\s+начал|когда\s+появ|lifecycle|activity\s+duration|business\s+age|how\s+long)/iu.test(text); } function hasValueFlowSignal(text) { return /(?:оборот|выручк|оплат|плат[её]ж|заплат|перечисл|списан|расход|исходящ|входящ|получ(?:ил|ено|ен)|поступил|поступлен|денежн[а-яёa-z0-9_-]*\s+поток|(?= 2) { return candidate; } } return null; } function resolveEntityResolutionAmbiguityChoice(text, candidates) { const normalizedText = canonicalizeEntityResolutionCandidate(text); if (!normalizedText || candidates.length <= 0) { return null; } const exactMatch = candidates.find((candidate) => canonicalizeEntityResolutionCandidate(candidate) === normalizedText); if (exactMatch) { return exactMatch; } const includedMatches = candidates.filter((candidate) => { const normalizedCandidate = canonicalizeEntityResolutionCandidate(candidate); return normalizedCandidate.length > 0 && normalizedText.includes(normalizedCandidate); }); if (includedMatches.length === 1) { return includedMatches[0]; } const narrowedMatches = candidates.filter((candidate) => { const normalizedCandidate = canonicalizeEntityResolutionCandidate(candidate); return normalizedText.length >= 4 && normalizedCandidate.includes(normalizedText); }); if (narrowedMatches.length === 1) { return narrowedMatches[0]; } const normalizedLowerText = compactLower(text); const ordinalMatchers = [ { index: 0, keywords: ["первый"], numericPatterns: [ /(?:^|[^\p{L}\p{N}])(?:вариант|номер|№)?\s*1(?:$|[^\p{L}\p{N}])/iu, /^\s*1\s*$/u ] }, { index: 1, keywords: ["второй"], numericPatterns: [ /(?:^|[^\p{L}\p{N}])(?:вариант|номер|№)?\s*2(?:$|[^\p{L}\p{N}])/iu, /^\s*2\s*$/u ] }, { index: 2, keywords: ["третий"], numericPatterns: [ /(?:^|[^\p{L}\p{N}])(?:вариант|номер|№)?\s*3(?:$|[^\p{L}\p{N}])/iu, /^\s*3\s*$/u ] }, { index: 3, keywords: ["четвертый", "четвёртый"], numericPatterns: [ /(?:^|[^\p{L}\p{N}])(?:вариант|номер|№)?\s*4(?:$|[^\p{L}\p{N}])/iu, /^\s*4\s*$/u ] }, { index: 4, keywords: ["пятый"], numericPatterns: [ /(?:^|[^\p{L}\p{N}])(?:вариант|номер|№)?\s*5(?:$|[^\p{L}\p{N}])/iu, /^\s*5\s*$/u ] }, { index: 5, keywords: ["шестой"], numericPatterns: [ /(?:^|[^\p{L}\p{N}])(?:вариант|номер|№)?\s*6(?:$|[^\p{L}\p{N}])/iu, /^\s*6\s*$/u ] } ]; for (const matcher of ordinalMatchers) { if (matcher.index < candidates.length && (matcher.keywords.some((keyword) => normalizedLowerText.includes(keyword)) || matcher.numericPatterns.some((pattern) => pattern.test(normalizedLowerText)))) { return candidates[matcher.index]; } } if (candidates.length > 0 && (normalizedLowerText.includes("последний") || normalizedLowerText.includes("крайний"))) { return candidates[candidates.length - 1] ?? null; } return null; } function metadataActionFromRawText(text) { if (/(?:\u043e\u0431\u044a\u0435\u043a\u0442(?:\u044b|\u0430|\u043e\u0432)?|objects?)/iu.test(text)) { return "inspect_surface"; } if (/(?:\u043f\u043e\u043b(?:\u0435|\u044f)|field)/iu.test(text)) { return "inspect_fields"; } if (/(?:\u0440\u0435\u0433\u0438\u0441\u0442\u0440|register)/iu.test(text)) { return "inspect_registers"; } if (/(?:\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442|document)/iu.test(text)) { return "inspect_documents"; } if (/(?:\u0441\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0438\u043a|directory|catalog)/iu.test(text)) { return "inspect_catalog"; } return "inspect_catalog"; } function metadataScopeHintFromRawText(text) { if (/(?:\u043d\u0434\u0441|vat)/iu.test(text)) { return "\u041d\u0414\u0421"; } if (/(?:\u0441\u043a\u043b\u0430\u0434|inventory|stock|warehouse|\u043d\u043e\u043c\u0435\u043d\u043a\u043b\u0430\u0442\u0443\u0440)/iu.test(text)) { return "\u0441\u043a\u043b\u0430\u0434"; } if (/(?:\u043a\u043e\u043d\u0442\u0440\u0430\u0433\u0435\u043d\u0442|counterparty|customer|client|supplier|vendor)/iu.test(text)) { return "\u043a\u043e\u043d\u0442\u0440\u0430\u0433\u0435\u043d\u0442"; } return null; } function hasExplicitDateScopeLiteral(text) { return /(?:\b(?:19|20)\d{2}\b|\b\d{4}-\d{2}-\d{2}\b|\b\d{4}-\d{2}\b)/iu.test(text); } function collectDateScopeFromRawText(text) { const isoDate = text.match(/\b(\d{4}-\d{2}-\d{2})\b/u); if (isoDate?.[1]) { return isoDate[1]; } const yearMonth = text.match(/\b(\d{4}-\d{2})\b/u); if (yearMonth?.[1]) { return yearMonth[1]; } const year = text.match(/\b((?:19|20)\d{2})\b/u); if (year?.[1]) { return year[1]; } return null; } function currentIsoDate() { return new Date().toISOString().slice(0, 10); } function hasRelativeCurrentDateHint(text) { return /(?:\bсегодня\b|\bна\s+сегодня\b|\bсегодняшн(?:ий|его|ем)\b|\btoday\b|\bas\s+of\s+today\b|\bcurrent\s+date\b)/iu.test(text); } function isImplicitCurrentDateScope(value) { return Boolean(value && /^\d{4}-\d{2}-\d{2}$/.test(value) && value === currentIsoDate()); } function semanticNeedFor(input) { const combined = compactLower(`${input.domain ?? ""} ${input.action ?? ""} ${input.unsupported ?? ""}`); if (input.metadataSignal || /(?:metadata|schema|catalog|inspect_(?:catalog|documents|registers|fields))/iu.test(combined)) { return "1C metadata evidence"; } if (input.lifecycleSignal || /(?:lifecycle|activity|duration|age)/iu.test(combined)) { return "counterparty lifecycle evidence"; } if (input.valueFlowSignal || /(?:turnover|revenue|payment|payout|value|net|netting|balance|cashflow)/iu.test(combined)) { return "counterparty value-flow evidence"; } if (input.entityResolutionSignal || /(?:entity_resolution|search_business_entity|resolve_entity_reference|entity\s+discovery|counterparty\s+search)/iu.test(combined)) { return "entity discovery evidence"; } if (/(?:movement|movements|bank_operations|movement_evidence|list_movements)/iu.test(combined)) { return "movement evidence"; } if (/(?:document|documents|list_documents)/iu.test(combined)) { return "document evidence"; } if (/(?:inventory|stock|warehouse|purchase_provenance|purchase provenance|supplier provenance|supplier_overlap|supplier overlap|sale_trace|sale trace|purchase_to_sale|purchase-to-sale)/iu.test(combined)) { if (/(?:sale_trace|sale trace|purchase_to_sale|purchase-to-sale|buyer)/iu.test(combined)) { return "inventory sale trace evidence"; } if (/(?:supplier_overlap|supplier overlap|supplier stock|stock by supplier)/iu.test(combined)) { return "inventory supplier overlap evidence"; } if (/(?:purchase_provenance|purchase provenance|supplier provenance|purchase document)/iu.test(combined)) { return "inventory purchase provenance evidence"; } return "inventory stock snapshot evidence"; } return null; } function shouldRunDiscovery(input) { if (input.forceDiscoveryOverExplicitIntent && input.semanticDataNeed) { return true; } if (input.lifecycleSignal || input.unsupported) { return true; } if (input.metadataSignal) { return true; } if (input.entityResolutionSignal) { return true; } if (input.valueFlowSignal && !input.explicitIntentCandidate) { return true; } if (input.followupDiscoverySeedApplicable && !input.explicitIntentCandidate && input.semanticDataNeed) { return true; } if (!input.explicitIntentCandidate && input.semanticDataNeed) { return true; } return false; } function buildAssistantMcpDiscoveryTurnInput(input) { const assistantTurnMeaning = toRecordObject(input.assistantTurnMeaning); const predecomposeContract = toRecordObject(input.predecomposeContract); const followupContext = toRecordObject(input.followupContext); const predecomposeEntities = collectPredecomposeEntities(predecomposeContract); const followupSeed = collectFollowupDiscoverySeed(followupContext); const metadataSurfaceRef = buildMetadataSurfaceRef(followupSeed); const reasonCodes = []; const rawUserText = toNonEmptyString(input.userMessage); const rawEffectiveText = toNonEmptyString(input.effectiveMessage); const repairedUserText = rawUserText ? (0, addressTextRepair_1.repairAddressMojibakeText)(rawUserText) : null; const repairedEffectiveText = rawEffectiveText ? (0, addressTextRepair_1.repairAddressMojibakeText)(rawEffectiveText) : null; const rawSignalSourceText = `${repairedUserText ?? rawUserText ?? ""} ${repairedEffectiveText ?? rawEffectiveText ?? ""}`.trim(); const rawEntitySourceText = repairedUserText ?? rawUserText ?? repairedEffectiveText ?? rawEffectiveText ?? rawSignalSourceText; const rawText = compactLower(rawSignalSourceText); const rawReferentialDocumentExclusionSignal = hasReferentialDocumentExclusionFollowupSignal(repairedUserText ?? rawUserText ?? ""); const rawLifecycleSignal = hasLifecycleSignal(rawText); const rawBidirectionalValueFlowSignal = !rawLifecycleSignal && hasBidirectionalValueFlowSignal(rawText); const rawValueFlowSignal = !rawLifecycleSignal && (hasValueFlowSignal(rawText) || hasValueRankingSignal(rawText) || rawBidirectionalValueFlowSignal); const rawMetadataSignal = !rawLifecycleSignal && !rawValueFlowSignal && !rawReferentialDocumentExclusionSignal && hasMetadataSignal(rawText); const rawEntityResolutionSignal = !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && hasEntityResolutionSignal(rawText); const rawPayoutSignal = rawValueFlowSignal && !rawBidirectionalValueFlowSignal && hasPayoutSignal(rawText); const rawValueFlowAggregateQuestionSignal = rawValueFlowSignal && hasValueFlowAggregateQuestionSignal(rawText); const monthlyAggregationSignal = hasMonthlyAggregationSignal(rawText); const rawAllTimeScopeSignal = hasAllTimeScopeHint(rawText); const explicitDateScopeLiteralDetected = hasExplicitDateScopeLiteral(rawText); const relativeCurrentDateHintDetected = hasRelativeCurrentDateHint(rawText); const rawDateScope = collectDateScopeFromRawText(rawText); const rawMetadataScopeHint = rawMetadataSignal ? metadataScopeHintFromRawText(rawText) : null; const rawEntityCandidate = rawEntityResolutionSignal ? rawEntityResolutionCandidate(rawEntitySourceText) : null; const entityResolutionClarificationCandidate = followupSeed.pilotScope === "entity_resolution_search_v1" && followupSeed.entityResolutionStatus === "ambiguous" ? resolveEntityResolutionAmbiguityChoice(rawEntitySourceText, followupSeed.entityResolutionAmbiguityCandidates) : null; const entityResolutionSignal = rawEntityResolutionSignal || Boolean(rawEntityCandidate) || Boolean(entityResolutionClarificationCandidate); const rawEntitySearchOverridesStaleScope = Boolean(rawEntityCandidate && entityResolutionSignal); const rawDomain = toNonEmptyString(assistantTurnMeaning?.asked_domain_family); const rawAction = toNonEmptyString(assistantTurnMeaning?.asked_action_family); const rawAggregationAxis = toNonEmptyString(assistantTurnMeaning?.asked_aggregation_axis); const unsupported = toNonEmptyString(assistantTurnMeaning?.unsupported_but_understood_family); const broadBusinessEvaluationUnsupported = unsupported === "broad_business_evaluation"; const explicitIntentCandidate = toNonEmptyString(assistantTurnMeaning?.explicit_intent_candidate); const currentTurnDocumentLaneSignal = rawAction === "list_documents"; const currentTurnMovementLaneSignal = rawAction === "list_movements"; const metadataDocumentHintSignal = currentTurnDocumentLaneSignal || hasUtf8DocumentLanePivotSignal(rawText) || hasSimpleDocumentLanePivotSignal(rawText) || hasDocumentEvidenceFollowupSignal(rawText) || hasPronounDocumentEvidenceFollowupSignal(rawText); const metadataMovementHintSignal = currentTurnMovementLaneSignal || hasUtf8MovementLanePivotSignal(rawText) || hasSimpleMovementLanePivotSignal(rawText) || hasMovementEvidenceFollowupSignal(rawText) || hasPronounMovementEvidenceFollowupSignal(rawText); const assistantTurnMeaningDateScope = toNonEmptyString(assistantTurnMeaning?.explicit_date_scope); const rawAssistantTurnMeaningOrganizationScope = toNonEmptyString(assistantTurnMeaning?.explicit_organization_scope); const assistantTurnMeaningOrganizationScope = isReferentialOrganizationPlaceholder(rawAssistantTurnMeaningOrganizationScope) ? null : rawAssistantTurnMeaningOrganizationScope; const rawOrganizationMentionSignal = hasOrganizationScopeSignalUtf8(rawText); const rawOrganizationScope = extractOrganizationScopeFromRawText(rawUserText ?? rawEffectiveText ?? rawSignalSourceText); const currentTurnFreshOrganizationScope = rawOrganizationScope ?? predecomposeEntities.organization; const currentTurnOrganizationScope = currentTurnFreshOrganizationScope ?? assistantTurnMeaningOrganizationScope; const followupCounterpartyIsMetadataOrganizationScope = Boolean(followupSeed.subjectResolutionOptional && followupSeed.counterparty && (followupSeed.metadataScopeHint || followupSeed.metadataSelectedEntitySet || followupSeed.metadataSelectedSurfaceObjects.length > 0) && (isInvalidEntityCandidate(followupSeed.counterparty) || sameScopedName(followupSeed.counterparty, followupSeed.organization) || sameScopedName(followupSeed.counterparty, currentTurnOrganizationScope))); const effectiveFollowupCounterparty = followupCounterpartyIsMetadataOrganizationScope ? null : followupSeed.counterparty; const explicitOrganizationScopeSignal = Boolean(rawOrganizationMentionSignal && currentTurnOrganizationScope); const organizationClarificationFollowupApplicable = Boolean(followupSeed.domain === "counterparty_value" && !effectiveFollowupCounterparty && currentTurnOrganizationScope && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal); const rawOpenScopeValueFlowOrganizationSignal = Boolean(rawValueFlowSignal && !rawBidirectionalValueFlowSignal && explicitOrganizationScopeSignal); const predecomposeOrganizationMirrorsCounterparty = sameScopedName(predecomposeEntities.counterparty, predecomposeEntities.organization); const organizationMirrorsPredecomposeCounterparty = Boolean((rawBidirectionalValueFlowSignal || hasValueRankingSignal(rawText) || rawOpenScopeValueFlowOrganizationSignal || explicitOrganizationScopeSignal) && (sameScopedName(predecomposeEntities.counterparty, assistantTurnMeaningOrganizationScope) || predecomposeOrganizationMirrorsCounterparty)); const normalizedPredecomposeCounterparty = organizationMirrorsPredecomposeCounterparty ? null : predecomposeEntities.counterparty; const predecomposeDateScope = collectDateScope(predecomposeContract); const periodClarificationFollowupApplicable = Boolean(followupSeed.domain && followupSeed.loopStatus === "awaiting_clarification" && followupSeed.loopPendingAxes.includes("period") && !rawLifecycleSignal && !rawMetadataSignal && (rawAllTimeScopeSignal || explicitDateScopeLiteralDetected || rawDateScope || relativeCurrentDateHintDetected || (predecomposeDateScope && !isImplicitCurrentDateScope(predecomposeDateScope)))); const followupDiscoverySeedApplicable = Boolean(followupSeed.domain && !rawLifecycleSignal && !rawMetadataSignal && (periodClarificationFollowupApplicable || (!rawValueFlowSignal && (monthlyAggregationSignal || rawAllTimeScopeSignal || explicitDateScopeLiteralDetected || predecomposeDateScope || explicitOrganizationScopeSignal || organizationClarificationFollowupApplicable)))); const metadataFollowupSeedApplicable = Boolean(followupSeed.domain === "metadata" && !rawLifecycleSignal && !rawValueFlowSignal && hasMetadataObjectHint(rawText)); const metadataLaneCarryoverAvailable = Boolean(effectiveFollowupCounterparty || followupSeed.discoveryEntity || followupSeed.metadataScopeHint || followupSeed.metadataSelectedEntitySet || followupSeed.metadataSelectedSurfaceObjects.length > 0); const metadataGroundedDocumentFollowupApplicable = Boolean(followupSeed.pilotScope === "metadata_inspection_v1" && followupSeed.metadataRouteFamily === "document_evidence" && !followupSeed.metadataAmbiguityDetected && metadataLaneCarryoverAvailable && !rawLifecycleSignal && !rawValueFlowSignal && metadataDocumentHintSignal); const metadataAmbiguityResolvedDocumentFollowupApplicable = Boolean(followupSeed.pilotScope === "metadata_inspection_v1" && followupSeed.metadataAmbiguityDetected && (followupSeed.metadataAmbiguityEntitySets.length === 0 || metadataEntitySetsSuggestDocumentLane(followupSeed.metadataAmbiguityEntitySets)) && metadataLaneCarryoverAvailable && !rawLifecycleSignal && !rawValueFlowSignal && metadataDocumentHintSignal); const metadataGroundedMovementFollowupApplicable = Boolean(followupSeed.pilotScope === "metadata_inspection_v1" && followupSeed.metadataRouteFamily === "movement_evidence" && !followupSeed.metadataAmbiguityDetected && metadataLaneCarryoverAvailable && !rawLifecycleSignal && metadataMovementHintSignal); const metadataAmbiguityResolvedMovementFollowupApplicable = Boolean(followupSeed.pilotScope === "metadata_inspection_v1" && followupSeed.metadataAmbiguityDetected && (followupSeed.metadataAmbiguityEntitySets.length === 0 || metadataEntitySetsSuggestMovementLane(followupSeed.metadataAmbiguityEntitySets)) && metadataLaneCarryoverAvailable && !rawLifecycleSignal && metadataMovementHintSignal); const entityResolutionGroundedDocumentFollowupApplicable = Boolean(followupSeed.pilotScope === "entity_resolution_search_v1" && (effectiveFollowupCounterparty || followupSeed.discoveryEntity) && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && metadataDocumentHintSignal); const entityResolutionClarifiedDocumentFollowupApplicable = Boolean(followupSeed.pilotScope === "entity_resolution_search_v1" && followupSeed.entityResolutionStatus === "ambiguous" && entityResolutionClarificationCandidate && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && metadataDocumentHintSignal); const entityResolutionGroundedMovementFollowupApplicable = Boolean(followupSeed.pilotScope === "entity_resolution_search_v1" && (effectiveFollowupCounterparty || followupSeed.discoveryEntity) && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && metadataMovementHintSignal); const entityResolutionClarifiedMovementFollowupApplicable = Boolean(followupSeed.pilotScope === "entity_resolution_search_v1" && followupSeed.entityResolutionStatus === "ambiguous" && entityResolutionClarificationCandidate && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && metadataMovementHintSignal); const groundedValueFlowFollowupApplicable = Boolean(rawValueFlowSignal && !rawLifecycleSignal && !rawMetadataSignal && (effectiveFollowupCounterparty || followupSeed.discoveryEntity) && (followupSeed.pilotScope === "entity_resolution_search_v1" || followupSeed.pilotScope === "counterparty_document_evidence_query_documents_v1" || followupSeed.pilotScope === "counterparty_movement_evidence_query_movements_v1" || followupSeed.pilotScope === "counterparty_value_flow_query_movements_v1" || followupSeed.pilotScope === "counterparty_supplier_payout_query_movements_v1" || followupSeed.pilotScope === "counterparty_bidirectional_value_flow_query_movements_v1")); const groundedValueFlowEvidenceSourceApplicable = Boolean((effectiveFollowupCounterparty || followupSeed.discoveryEntity) && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && (followupSeed.domain === "counterparty_value" || followupSeed.action === "turnover" || followupSeed.action === "payout" || followupSeed.action === "net_value_flow" || followupSeed.pilotScope === "counterparty_value_flow_query_movements_v1" || followupSeed.pilotScope === "counterparty_supplier_payout_query_movements_v1" || followupSeed.pilotScope === "counterparty_bidirectional_value_flow_query_movements_v1")); const valueFlowGroundedDocumentFollowupApplicable = Boolean(groundedValueFlowEvidenceSourceApplicable && metadataDocumentHintSignal); const valueFlowGroundedMovementFollowupApplicable = Boolean(groundedValueFlowEvidenceSourceApplicable && metadataMovementHintSignal); const documentEvidenceGroundedMovementFollowupApplicable = Boolean(followupSeed.pilotScope === "counterparty_document_evidence_query_documents_v1" && (effectiveFollowupCounterparty || followupSeed.discoveryEntity) && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && metadataMovementHintSignal); const movementEvidenceGroundedDocumentFollowupApplicable = Boolean(followupSeed.pilotScope === "counterparty_movement_evidence_query_movements_v1" && (effectiveFollowupCounterparty || followupSeed.discoveryEntity) && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && metadataDocumentHintSignal); const metadataScopedMovementEvidenceToDocumentFollowupApplicable = Boolean(followupSeed.pilotScope === "counterparty_movement_evidence_query_movements_v1" && followupSeed.subjectResolutionOptional && !effectiveFollowupCounterparty && metadataLaneCarryoverAvailable && !rawLifecycleSignal && !rawValueFlowSignal && metadataDocumentHintSignal); const metadataScopedDocumentEvidenceToMovementFollowupApplicable = Boolean(followupSeed.pilotScope === "counterparty_document_evidence_query_documents_v1" && followupSeed.subjectResolutionOptional && !effectiveFollowupCounterparty && metadataLaneCarryoverAvailable && !rawLifecycleSignal && !rawValueFlowSignal && metadataMovementHintSignal); const metadataGroundedLaneContinuationApplicable = Boolean(followupSeed.pilotScope === "metadata_inspection_v1" && (followupSeed.metadataRouteFamily === "document_evidence" || followupSeed.metadataRouteFamily === "movement_evidence") && !followupSeed.metadataAmbiguityDetected && metadataLaneCarryoverAvailable && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && !metadataDocumentHintSignal && !metadataMovementHintSignal && hasMetadataDownstreamContinuationSignal(rawText)); const metadataGroundedCatalogLaneContinuationApplicable = Boolean(followupSeed.pilotScope === "metadata_inspection_v1" && followupSeed.metadataRouteFamily === "catalog_drilldown" && !followupSeed.metadataAmbiguityDetected && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && !metadataDocumentHintSignal && !metadataMovementHintSignal && hasMetadataDownstreamContinuationSignal(rawText)); const metadataAmbiguityCollapsedDocumentLaneContinuationApplicable = Boolean(followupSeed.pilotScope === "metadata_inspection_v1" && followupSeed.metadataAmbiguityDetected && metadataAmbiguityCollapsesToDocumentLane(followupSeed.metadataAmbiguityEntitySets) && metadataLaneCarryoverAvailable && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && !metadataDocumentHintSignal && !metadataMovementHintSignal && hasMetadataDownstreamContinuationSignal(rawText)); const metadataAmbiguityCollapsedMovementLaneContinuationApplicable = Boolean(followupSeed.pilotScope === "metadata_inspection_v1" && followupSeed.metadataAmbiguityDetected && metadataAmbiguityCollapsesToMovementLane(followupSeed.metadataAmbiguityEntitySets) && metadataLaneCarryoverAvailable && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && !metadataDocumentHintSignal && !metadataMovementHintSignal && hasMetadataDownstreamContinuationSignal(rawText)); const metadataAmbiguityLaneClarificationApplicable = Boolean(followupSeed.pilotScope === "metadata_inspection_v1" && followupSeed.metadataAmbiguityDetected && !metadataAmbiguityCollapsesToDocumentLane(followupSeed.metadataAmbiguityEntitySets) && !metadataAmbiguityCollapsesToMovementLane(followupSeed.metadataAmbiguityEntitySets) && metadataLaneCarryoverAvailable && !rawLifecycleSignal && !rawValueFlowSignal && !rawMetadataSignal && !metadataDocumentHintSignal && !metadataMovementHintSignal && hasMetadataDownstreamContinuationSignal(rawText)); const metadataGroundedDocumentLaneApplicable = metadataGroundedDocumentFollowupApplicable || metadataAmbiguityResolvedDocumentFollowupApplicable || (followupSeed.subjectResolutionOptional && !effectiveFollowupCounterparty && metadataLaneCarryoverAvailable && !rawLifecycleSignal && !rawValueFlowSignal && !currentTurnMovementLaneSignal && (!rawMetadataSignal || currentTurnDocumentLaneSignal) && (currentTurnDocumentLaneSignal || (followupSeed.domain === "documents" && followupSeed.action === "list_documents"))) || entityResolutionGroundedDocumentFollowupApplicable || entityResolutionClarifiedDocumentFollowupApplicable || valueFlowGroundedDocumentFollowupApplicable || movementEvidenceGroundedDocumentFollowupApplicable || metadataScopedMovementEvidenceToDocumentFollowupApplicable || (metadataGroundedLaneContinuationApplicable && followupSeed.metadataRouteFamily === "document_evidence") || metadataAmbiguityCollapsedDocumentLaneContinuationApplicable; const metadataGroundedMovementLaneApplicable = metadataGroundedMovementFollowupApplicable || metadataAmbiguityResolvedMovementFollowupApplicable || (followupSeed.subjectResolutionOptional && !effectiveFollowupCounterparty && metadataLaneCarryoverAvailable && !rawLifecycleSignal && !rawValueFlowSignal && !currentTurnDocumentLaneSignal && (!rawMetadataSignal || currentTurnMovementLaneSignal) && (currentTurnMovementLaneSignal || (followupSeed.domain === "movements" && followupSeed.action === "list_movements"))) || entityResolutionGroundedMovementFollowupApplicable || entityResolutionClarifiedMovementFollowupApplicable || valueFlowGroundedMovementFollowupApplicable || documentEvidenceGroundedMovementFollowupApplicable || metadataScopedDocumentEvidenceToMovementFollowupApplicable || (metadataGroundedLaneContinuationApplicable && followupSeed.metadataRouteFamily === "movement_evidence") || metadataAmbiguityCollapsedMovementLaneContinuationApplicable; const effectiveMetadataFollowupSeedApplicable = metadataFollowupSeedApplicable && !metadataAmbiguityLaneClarificationApplicable && !metadataGroundedDocumentLaneApplicable && !metadataGroundedMovementLaneApplicable && !metadataGroundedCatalogLaneContinuationApplicable; const seededDomain = metadataAmbiguityLaneClarificationApplicable ? "metadata" : metadataGroundedDocumentLaneApplicable ? "documents" : metadataGroundedMovementLaneApplicable ? "movements" : metadataGroundedCatalogLaneContinuationApplicable ? "metadata" : followupDiscoverySeedApplicable || effectiveMetadataFollowupSeedApplicable ? followupSeed.domain : null; const seededAction = metadataAmbiguityLaneClarificationApplicable ? "resolve_next_lane" : metadataGroundedDocumentLaneApplicable ? "list_documents" : metadataGroundedMovementLaneApplicable ? "list_movements" : metadataGroundedCatalogLaneContinuationApplicable ? "inspect_catalog" : followupDiscoverySeedApplicable || effectiveMetadataFollowupSeedApplicable ? followupSeed.action : null; const seededUnsupported = metadataAmbiguityLaneClarificationApplicable ? "metadata_lane_choice_clarification" : metadataGroundedDocumentLaneApplicable ? "document_evidence" : metadataGroundedMovementLaneApplicable ? "movement_evidence" : metadataGroundedCatalogLaneContinuationApplicable ? "schema_surface" : followupDiscoverySeedApplicable || effectiveMetadataFollowupSeedApplicable ? followupSeed.unsupported : null; const lifecycleSignal = rawLifecycleSignal || seededDomain === "counterparty_lifecycle"; const bidirectionalValueFlowSignal = !lifecycleSignal && (rawBidirectionalValueFlowSignal || seededAction === "net_value_flow"); const valueFlowSignal = !lifecycleSignal && !metadataGroundedMovementLaneApplicable && (rawValueFlowSignal || seededDomain === "counterparty_value"); const payoutSignal = valueFlowSignal && !bidirectionalValueFlowSignal && (rawPayoutSignal || seededAction === "payout"); const semanticDataNeed = metadataAmbiguityLaneClarificationApplicable ? "metadata lane clarification" : semanticNeedFor({ domain: rawDomain ?? seededDomain, action: rawAction ?? seededAction, unsupported: broadBusinessEvaluationUnsupported ? seededUnsupported : unsupported ?? seededUnsupported, lifecycleSignal, valueFlowSignal, metadataSignal: rawMetadataSignal || effectiveMetadataFollowupSeedApplicable, entityResolutionSignal: entityResolutionSignal && !metadataGroundedDocumentLaneApplicable && !metadataGroundedMovementLaneApplicable }); const explicitCurrentCounterpartyCandidate = normalizedPredecomposeCounterparty && !isReferentialEntityPlaceholder(normalizedPredecomposeCounterparty) ? normalizedPredecomposeCounterparty : null; const explicitCurrentCounterpartyOverridesFollowupEntity = Boolean(explicitCurrentCounterpartyCandidate && (effectiveFollowupCounterparty || followupSeed.discoveryEntity) && !sameScopedName(explicitCurrentCounterpartyCandidate, effectiveFollowupCounterparty ?? followupSeed.discoveryEntity) && (valueFlowSignal || lifecycleSignal || metadataGroundedDocumentLaneApplicable || metadataGroundedMovementLaneApplicable)); const metadataLaneScopeHint = rawEntitySearchOverridesStaleScope ? null : explicitCurrentCounterpartyOverridesFollowupEntity ? null : rawMetadataScopeHint ?? followupSeed.metadataScopeHint ?? followupSeed.discoveryEntity ?? followupSeed.metadataSelectedEntitySet ?? null; const metadataScopedLaneWithoutSubject = Boolean((metadataGroundedMovementLaneApplicable || metadataGroundedDocumentLaneApplicable) && !effectiveFollowupCounterparty && metadataLaneCarryoverAvailable); const groundedFollowupEntity = metadataScopedLaneWithoutSubject ? null : rawEntitySearchOverridesStaleScope ? null : explicitCurrentCounterpartyOverridesFollowupEntity ? null : effectiveFollowupCounterparty ?? followupSeed.discoveryEntity; const entityCandidates = entityResolutionSignal ? [] : []; if (entityResolutionSignal) { pushNormalizedEntityResolutionCandidate(entityCandidates, entityResolutionClarificationCandidate); pushNormalizedEntityResolutionCandidate(entityCandidates, rawEntityCandidate); for (const candidate of collectEntityCandidates(assistantTurnMeaning?.explicit_entity_candidates)) { if (!rawEntitySearchOverridesStaleScope || sameScopedName(candidate, rawEntityCandidate)) { pushNormalizedEntityResolutionCandidate(entityCandidates, candidate); } } if (!rawEntitySearchOverridesStaleScope || sameScopedName(normalizedPredecomposeCounterparty, rawEntityCandidate)) { pushNormalizedEntityResolutionCandidate(entityCandidates, normalizedPredecomposeCounterparty); } if (!rawEntitySearchOverridesStaleScope) { pushNormalizedEntityResolutionCandidate(entityCandidates, effectiveFollowupCounterparty); } } else { if (groundedFollowupEntity) { pushUnique(entityCandidates, groundedFollowupEntity); } for (const candidate of collectEntityCandidates(assistantTurnMeaning?.explicit_entity_candidates)) { pushScopedEntityCandidate(entityCandidates, candidate, groundedFollowupEntity); } pushScopedEntityCandidate(entityCandidates, normalizedPredecomposeCounterparty, groundedFollowupEntity); if (!groundedFollowupEntity) { pushScopedEntityCandidate(entityCandidates, effectiveFollowupCounterparty, null); if (!metadataScopedLaneWithoutSubject) { pushScopedEntityCandidate(entityCandidates, followupSeed.discoveryEntity, null); } } pushScopedEntityCandidate(entityCandidates, rawEntityCandidate, groundedFollowupEntity); } if ((rawMetadataSignal || metadataFollowupSeedApplicable) && !groundedFollowupEntity && !metadataScopedLaneWithoutSubject) { pushUnique(entityCandidates, followupSeed.discoveryEntity); pushUnique(entityCandidates, rawMetadataScopeHint); } const openScopeValueFlowWithoutCounterparty = valueFlowSignal && !normalizedPredecomposeCounterparty && !effectiveFollowupCounterparty; const valueFlowOrganizationStaysScope = openScopeValueFlowWithoutCounterparty && Boolean(bidirectionalValueFlowSignal || hasValueRankingSignal(rawText) || rawOpenScopeValueFlowOrganizationSignal || explicitOrganizationScopeSignal || organizationClarificationFollowupApplicable || followupSeed.organization); const openScopeValueFlowWithoutResolvedCounterparty = Boolean(valueFlowSignal && !normalizedPredecomposeCounterparty && !effectiveFollowupCounterparty); if (openScopeValueFlowWithoutCounterparty && !valueFlowOrganizationStaysScope) { pushUnique(entityCandidates, predecomposeEntities.organization); pushUnique(entityCandidates, followupSeed.organization); } const explicitOrganizationScope = rawEntitySearchOverridesStaleScope && !currentTurnFreshOrganizationScope ? null : valueFlowOrganizationStaysScope || !openScopeValueFlowWithoutCounterparty ? (rawEntitySearchOverridesStaleScope ? currentTurnFreshOrganizationScope : currentTurnOrganizationScope) ?? followupSeed.organization : null; if (explicitCurrentCounterpartyCandidate && (valueFlowSignal || lifecycleSignal || metadataGroundedDocumentLaneApplicable || metadataGroundedMovementLaneApplicable)) { for (let index = entityCandidates.length - 1; index >= 0; index -= 1) { const candidate = entityCandidates[index]; if (!candidate || sameScopedName(candidate, explicitCurrentCounterpartyCandidate)) { continue; } if ((metadataLaneScopeHint && sameScopedName(candidate, metadataLaneScopeHint)) || (explicitOrganizationScope && sameScopedName(candidate, explicitOrganizationScope)) || (followupSeed.organization && sameScopedName(candidate, followupSeed.organization)) || (effectiveFollowupCounterparty && !sameScopedName(effectiveFollowupCounterparty, explicitCurrentCounterpartyCandidate) && sameScopedName(candidate, effectiveFollowupCounterparty))) { entityCandidates.splice(index, 1); } } } if (valueFlowOrganizationStaysScope && explicitOrganizationScope) { for (let index = entityCandidates.length - 1; index >= 0; index -= 1) { if (entityCandidates[index] === explicitOrganizationScope) { entityCandidates.splice(index, 1); } } } const clarificationLoopStillNeedsPeriod = Boolean(followupSeed.loopStatus === "awaiting_clarification" && followupSeed.loopPendingAxes.includes("period")); const currentTurnCarriesExplicitPeriod = Boolean(explicitDateScopeLiteralDetected || rawDateScope || relativeCurrentDateHintDetected || (predecomposeDateScope && !isImplicitCurrentDateScope(predecomposeDateScope))); const suppressImplicitCurrentDateScope = Boolean(!currentTurnCarriesExplicitPeriod && (clarificationLoopStillNeedsPeriod || openScopeValueFlowWithoutResolvedCounterparty || (valueFlowOrganizationStaysScope && (Boolean(followupSeed.rankingNeed) || bidirectionalValueFlowSignal)))); const normalizedPredecomposeDateScope = (rawEntitySearchOverridesStaleScope && !currentTurnCarriesExplicitPeriod) || (suppressImplicitCurrentDateScope && isImplicitCurrentDateScope(predecomposeDateScope)) ? null : predecomposeDateScope; const normalizedAssistantTurnMeaningDateScope = rawEntitySearchOverridesStaleScope || (suppressImplicitCurrentDateScope && isImplicitCurrentDateScope(assistantTurnMeaningDateScope)) ? null : assistantTurnMeaningDateScope; const normalizedFollowupDateScope = rawEntitySearchOverridesStaleScope || (suppressImplicitCurrentDateScope && isImplicitCurrentDateScope(followupSeed.dateScope)) ? null : followupSeed.dateScope; const explicitDateScope = rawAllTimeScopeSignal ? null : normalizedAssistantTurnMeaningDateScope ?? normalizedPredecomposeDateScope ?? rawDateScope ?? normalizedFollowupDateScope; const followupDateScopeApplied = Boolean(!rawAllTimeScopeSignal && !normalizedAssistantTurnMeaningDateScope && !normalizedPredecomposeDateScope && !rawDateScope && normalizedFollowupDateScope); const clarificationLoopSeedApplied = Boolean(followupSeed.loopStatus === "awaiting_clarification" && followupSeed.loopSelectedChainId); const turnMeaning = { asked_domain_family: lifecycleSignal ? "counterparty_lifecycle" : valueFlowSignal ? "counterparty_value" : metadataGroundedMovementLaneApplicable ? "movements" : metadataGroundedDocumentLaneApplicable ? "documents" : entityResolutionSignal ? "entity_resolution" : rawMetadataSignal || effectiveMetadataFollowupSeedApplicable ? "metadata" : rawDomain ?? seededDomain, asked_action_family: lifecycleSignal ? "activity_duration" : valueFlowSignal ? bidirectionalValueFlowSignal ? "net_value_flow" : payoutSignal ? "payout" : rawAction ?? seededAction ?? "turnover" : metadataGroundedMovementLaneApplicable ? "list_movements" : metadataGroundedDocumentLaneApplicable ? "list_documents" : entityResolutionSignal ? "search_business_entity" : rawMetadataSignal || effectiveMetadataFollowupSeedApplicable ? metadataActionFromRawText(rawText) ?? seededAction : rawAction ?? seededAction, asked_aggregation_axis: monthlyAggregationSignal ? "month" : rawAggregationAxis, seeded_ranking_need: valueFlowSignal && followupSeed.rankingNeed && !rawEntitySearchOverridesStaleScope ? followupSeed.rankingNeed : undefined, explicit_entity_candidates: entityCandidates, metadata_ambiguity_entity_sets: metadataAmbiguityLaneClarificationApplicable && followupSeed.metadataAmbiguityEntitySets.length > 0 ? followupSeed.metadataAmbiguityEntitySets : undefined, metadata_scope_hint: metadataLaneScopeHint, explicit_organization_scope: explicitOrganizationScope, explicit_date_scope: explicitDateScope, subject_resolution_optional: metadataScopedLaneWithoutSubject || undefined, unsupported_but_understood_family: unsupported ?? (lifecycleSignal ? "counterparty_lifecycle" : valueFlowSignal ? bidirectionalValueFlowSignal ? "counterparty_bidirectional_value_flow_or_netting" : payoutSignal ? "counterparty_payouts_or_outflow" : seededUnsupported ?? "counterparty_value_or_turnover" : metadataGroundedMovementLaneApplicable ? "movement_evidence" : metadataGroundedDocumentLaneApplicable ? "document_evidence" : metadataAmbiguityLaneClarificationApplicable ? "metadata_lane_choice_clarification" : entityResolutionSignal ? "entity_resolution" : rawMetadataSignal || effectiveMetadataFollowupSeedApplicable ? "1c_metadata_surface" : followupDiscoverySeedApplicable ? seededUnsupported : null), stale_replay_forbidden: Boolean(assistantTurnMeaning?.stale_replay_forbidden || unsupported || lifecycleSignal || valueFlowSignal || metadataGroundedMovementLaneApplicable || metadataGroundedDocumentLaneApplicable || metadataAmbiguityLaneClarificationApplicable || entityResolutionSignal || rawMetadataSignal || effectiveMetadataFollowupSeedApplicable || followupDiscoverySeedApplicable) }; const cleanTurnMeaning = {}; if (toNonEmptyString(turnMeaning.asked_domain_family)) { cleanTurnMeaning.asked_domain_family = turnMeaning.asked_domain_family; } if (toNonEmptyString(turnMeaning.asked_action_family)) { cleanTurnMeaning.asked_action_family = turnMeaning.asked_action_family; } if (toNonEmptyString(turnMeaning.asked_aggregation_axis)) { cleanTurnMeaning.asked_aggregation_axis = turnMeaning.asked_aggregation_axis; } if (toNonEmptyString(turnMeaning.seeded_ranking_need)) { cleanTurnMeaning.seeded_ranking_need = turnMeaning.seeded_ranking_need; } if ((turnMeaning.explicit_entity_candidates?.length ?? 0) > 0) { cleanTurnMeaning.explicit_entity_candidates = turnMeaning.explicit_entity_candidates; } if ((turnMeaning.metadata_ambiguity_entity_sets?.length ?? 0) > 0) { cleanTurnMeaning.metadata_ambiguity_entity_sets = turnMeaning.metadata_ambiguity_entity_sets; } if (toNonEmptyString(turnMeaning.metadata_scope_hint)) { cleanTurnMeaning.metadata_scope_hint = turnMeaning.metadata_scope_hint; } if (toNonEmptyString(turnMeaning.explicit_organization_scope)) { cleanTurnMeaning.explicit_organization_scope = turnMeaning.explicit_organization_scope; } if (toNonEmptyString(turnMeaning.explicit_date_scope)) { cleanTurnMeaning.explicit_date_scope = turnMeaning.explicit_date_scope; } if (turnMeaning.subject_resolution_optional) { cleanTurnMeaning.subject_resolution_optional = true; } if (toNonEmptyString(turnMeaning.unsupported_but_understood_family)) { cleanTurnMeaning.unsupported_but_understood_family = turnMeaning.unsupported_but_understood_family; } if (turnMeaning.stale_replay_forbidden) { cleanTurnMeaning.stale_replay_forbidden = true; } const currentTurnValueFlowExactOverrideApplicable = Boolean(valueFlowSignal && explicitIntentCandidate && rawValueFlowAggregateQuestionSignal && semanticDataNeed && (entityCandidates.length > 0 || explicitOrganizationScope || openScopeValueFlowWithoutResolvedCounterparty)); const runDiscovery = shouldRunDiscovery({ unsupported: broadBusinessEvaluationUnsupported ? seededUnsupported : unsupported ?? seededUnsupported, lifecycleSignal, valueFlowSignal, metadataSignal: rawMetadataSignal || effectiveMetadataFollowupSeedApplicable, entityResolutionSignal, semanticDataNeed, explicitIntentCandidate, followupDiscoverySeedApplicable: followupDiscoverySeedApplicable || Boolean(entityResolutionClarificationCandidate) || effectiveMetadataFollowupSeedApplicable || metadataAmbiguityLaneClarificationApplicable || metadataGroundedMovementLaneApplicable || metadataGroundedDocumentLaneApplicable || groundedValueFlowFollowupApplicable, forceDiscoveryOverExplicitIntent: Boolean(entityResolutionClarificationCandidate) || organizationClarificationFollowupApplicable || periodClarificationFollowupApplicable || metadataAmbiguityLaneClarificationApplicable || metadataGroundedMovementLaneApplicable || metadataGroundedDocumentLaneApplicable || groundedValueFlowFollowupApplicable || currentTurnValueFlowExactOverrideApplicable }); const hasTurnMeaning = Object.keys(cleanTurnMeaning).length > 0; const sourceSignal = rawEntitySearchOverridesStaleScope ? "raw_text" : assistantTurnMeaning ? "assistant_turn_meaning" : followupDiscoverySeedApplicable || Boolean(entityResolutionClarificationCandidate) || effectiveMetadataFollowupSeedApplicable || metadataAmbiguityLaneClarificationApplicable ? "followup_context" : metadataGroundedMovementLaneApplicable ? "followup_context" : metadataGroundedDocumentLaneApplicable ? "followup_context" : predecomposeContract ? "predecompose_contract" : lifecycleSignal ? "raw_text" : valueFlowSignal ? "raw_text" : entityResolutionSignal ? "raw_text" : rawMetadataSignal || effectiveMetadataFollowupSeedApplicable ? "raw_text" : "none"; if (lifecycleSignal) { pushReason(reasonCodes, "mcp_discovery_lifecycle_signal_detected"); } if (valueFlowSignal) { pushReason(reasonCodes, "mcp_discovery_value_flow_signal_detected"); } if (rawMetadataSignal) { pushReason(reasonCodes, "mcp_discovery_metadata_signal_detected"); } if (entityResolutionSignal) { pushReason(reasonCodes, "mcp_discovery_entity_resolution_signal_detected"); } if (rawMetadataScopeHint) { pushReason(reasonCodes, "mcp_discovery_metadata_scope_hint_from_raw_text"); } if (rawEntityCandidate) { pushReason(reasonCodes, "mcp_discovery_entity_scope_from_raw_entity_search"); } if (entityResolutionClarificationCandidate) { pushReason(reasonCodes, "mcp_discovery_entity_resolution_clarification_candidate_selected"); } if (organizationClarificationFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_organization_clarification_followup_from_followup_context"); } if (periodClarificationFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_period_clarification_followup_from_followup_context"); } if (payoutSignal) { pushReason(reasonCodes, "mcp_discovery_payout_signal_detected"); } if (bidirectionalValueFlowSignal) { pushReason(reasonCodes, "mcp_discovery_bidirectional_value_flow_signal_detected"); } if (monthlyAggregationSignal) { pushReason(reasonCodes, "mcp_discovery_monthly_aggregation_signal_detected"); } if (rawAllTimeScopeSignal) { pushReason(reasonCodes, "mcp_discovery_all_time_scope_signal_detected"); } if (followupDiscoverySeedApplicable) { pushReason(reasonCodes, "mcp_discovery_seeded_from_followup_context"); } if (clarificationLoopSeedApplied) { pushReason(reasonCodes, "mcp_discovery_resumed_from_saved_loop_state"); } if (effectiveMetadataFollowupSeedApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_seeded_from_followup_context"); } if (metadataGroundedDocumentFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_grounded_document_followup"); } if (metadataAmbiguityResolvedDocumentFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_ambiguity_resolved_to_document_lane"); } if (metadataGroundedMovementFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_grounded_movement_followup"); } if (metadataAmbiguityResolvedMovementFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_ambiguity_resolved_to_movement_lane"); } if (metadataScopedLaneWithoutSubject) { pushReason(reasonCodes, "mcp_discovery_metadata_scoped_lane_without_subject"); } if (entityResolutionGroundedDocumentFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_entity_resolution_grounded_document_followup"); } if (entityResolutionClarifiedDocumentFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_entity_resolution_clarified_document_followup"); } if (entityResolutionGroundedMovementFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_entity_resolution_grounded_movement_followup"); } if (entityResolutionClarifiedMovementFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_entity_resolution_clarified_movement_followup"); } if (valueFlowGroundedDocumentFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_value_flow_grounded_document_followup"); } if (valueFlowGroundedMovementFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_value_flow_grounded_movement_followup"); } if (groundedValueFlowFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_grounded_value_flow_followup"); } if (currentTurnValueFlowExactOverrideApplicable) { pushReason(reasonCodes, "mcp_discovery_current_turn_value_flow_overrides_supported_exact"); } if (documentEvidenceGroundedMovementFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_document_evidence_grounded_movement_followup"); } if (movementEvidenceGroundedDocumentFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_movement_evidence_grounded_document_followup"); } if (metadataScopedMovementEvidenceToDocumentFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_scoped_movement_to_document_followup"); } if (metadataScopedDocumentEvidenceToMovementFollowupApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_scoped_document_to_movement_followup"); } if (metadataGroundedLaneContinuationApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_grounded_lane_continuation"); } if (metadataGroundedCatalogLaneContinuationApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_grounded_catalog_continuation"); } if (metadataAmbiguityCollapsedDocumentLaneContinuationApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_ambiguity_collapsed_to_document_lane"); } if (metadataAmbiguityCollapsedMovementLaneContinuationApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_ambiguity_collapsed_to_movement_lane"); } if (metadataAmbiguityLaneClarificationApplicable) { pushReason(reasonCodes, "mcp_discovery_metadata_ambiguity_requires_lane_choice"); } if (unsupported) { pushReason(reasonCodes, "mcp_discovery_unsupported_but_understood_turn"); } if (broadBusinessEvaluationUnsupported) { pushReason(reasonCodes, "mcp_discovery_broad_business_evaluation_kept_in_living_chat"); } if (!(valueFlowOrganizationStaysScope && normalizedPredecomposeCounterparty === explicitOrganizationScope) && normalizedPredecomposeCounterparty) { pushReason(reasonCodes, "mcp_discovery_counterparty_from_predecompose"); } if (effectiveFollowupCounterparty && !rawEntitySearchOverridesStaleScope) { pushReason(reasonCodes, "mcp_discovery_counterparty_from_followup_context"); } if (followupDateScopeApplied) { pushReason(reasonCodes, "mcp_discovery_date_scope_from_followup_context"); } if (metadataSurfaceRef) { pushReason(reasonCodes, "mcp_discovery_metadata_surface_ref_from_followup_context"); } if (metadataSurfaceRef?.recommended_next_primitive) { pushReason(reasonCodes, "mcp_discovery_metadata_next_primitive_from_followup_context"); } if (entityCandidates.length > 0) { pushReason(reasonCodes, "mcp_discovery_entity_scope_available"); } if (!runDiscovery) { pushReason(reasonCodes, "mcp_discovery_not_applicable_for_supported_exact_turn"); } if (runDiscovery && !hasTurnMeaning) { pushReason(reasonCodes, "mcp_discovery_turn_meaning_missing"); } const dataNeedGraph = runDiscovery && hasTurnMeaning ? (0, assistantMcpDiscoveryDataNeedGraph_1.buildAssistantMcpDiscoveryDataNeedGraph)({ semanticDataNeed, rawUtterance: rawSignalSourceText, turnMeaning: cleanTurnMeaning }) : null; if (dataNeedGraph) { pushReason(reasonCodes, "mcp_discovery_data_need_graph_built"); } return { schema_version: exports.ASSISTANT_MCP_DISCOVERY_TURN_INPUT_SCHEMA_VERSION, policy_owner: "assistantMcpDiscoveryTurnInputAdapter", adapter_status: !runDiscovery ? "not_applicable" : hasTurnMeaning ? "ready" : "needs_more_context", should_run_discovery: runDiscovery, semantic_data_need: runDiscovery ? semanticDataNeed : null, data_need_graph: dataNeedGraph, metadata_surface_ref: runDiscovery ? metadataSurfaceRef : null, turn_meaning_ref: runDiscovery && hasTurnMeaning ? cleanTurnMeaning : null, source_signal: sourceSignal, reason_codes: reasonCodes }; }