АРЧ АП11 - Подключить shadow-контракты переходов и truth gate в debug payload

This commit is contained in:
2026-04-15 23:03:11 +03:00
parent 93ad18daa3
commit 1d95ed9b60
10 changed files with 645 additions and 9 deletions
@@ -2,6 +2,7 @@
Object.defineProperty(exports, "__esModule", { value: true });
exports.runAssistantAddressLaneResponseRuntime = runAssistantAddressLaneResponseRuntime;
const assistantAddressTurnFinalizeRuntimeAdapter_1 = require("./assistantAddressTurnFinalizeRuntimeAdapter");
const assistantRuntimeContractResolver_1 = require("./assistantRuntimeContractResolver");
function toRecordObject(value) {
if (!value || typeof value !== "object") {
return null;
@@ -187,6 +188,10 @@ function runAssistantAddressLaneResponseRuntime(input) {
period_to: input.toNonEmptyString(rootFilters?.period_to)
};
}
const debugWithRuntimeContracts = (0, assistantRuntimeContractResolver_1.attachAssistantRuntimeContractShadow)(debug, {
userMessage: input.userMessage,
addressRuntimeMeta: input.llmPreDecomposeMeta
});
const finalization = finalizeAddressTurnSafe({
sessionId: input.sessionId,
userMessage: input.userMessage,
@@ -194,7 +199,7 @@ function runAssistantAddressLaneResponseRuntime(input) {
assistantReply: safeAddressReply,
replyType: normalizeAddressReplyType(input.addressLane.reply_type),
addressLaneDebug: normalizeAddressLaneDebug(input.addressLane.debug),
debug,
debug: debugWithRuntimeContracts,
carryoverMeta: normalizeCarryoverMeta(input.carryoverMeta),
llmPreDecomposeMeta: normalizeLlmPreDecomposeMeta(input.llmPreDecomposeMeta),
appendItem: input.appendItem,
@@ -206,6 +211,6 @@ function runAssistantAddressLaneResponseRuntime(input) {
});
return {
response: finalization.response,
debug
debug: debugWithRuntimeContracts
};
}
@@ -1,6 +1,7 @@
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.buildDeepAnalysisDebugPayload = buildDeepAnalysisDebugPayload;
const assistantRuntimeContractResolver_1 = require("./assistantRuntimeContractResolver");
const assistantStage4AnswerContractAudit_1 = require("./assistantStage4AnswerContractAudit");
function toAnalysisContext(input) {
if (!input.active) {
@@ -17,7 +18,7 @@ function toAnalysisContext(input) {
function buildDeepAnalysisDebugPayload(input) {
const analysisContext = toAnalysisContext(input.runtimeAnalysisContext);
const answerContractStage4Audit = (0, assistantStage4AnswerContractAudit_1.buildStage4AnswerContractAuditV1)(input.assistantReply);
return {
const debugPayload = {
trace_id: input.traceId,
prompt_version: input.promptVersion,
schema_version: input.schemaVersion,
@@ -93,4 +94,8 @@ function buildDeepAnalysisDebugPayload(input) {
investigation_state_snapshot: input.investigationStateSnapshot,
normalized: input.normalizedPayload
};
return (0, assistantRuntimeContractResolver_1.attachAssistantRuntimeContractShadow)(debugPayload, {
addressRuntimeMeta: input.addressRuntimeMetaForDeep,
groundingStatus: input.groundingCheck.status
});
}
@@ -0,0 +1,220 @@
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.resolveAssistantRuntimeContractShadow = resolveAssistantRuntimeContractShadow;
exports.buildAssistantRuntimeContractShadowFields = buildAssistantRuntimeContractShadowFields;
exports.attachAssistantRuntimeContractShadow = attachAssistantRuntimeContractShadow;
const assistantRuntimeContracts_1 = require("../types/assistantRuntimeContracts");
const assistantRuntimeContractRegistry_1 = require("./assistantRuntimeContractRegistry");
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 isAddressIntent(value) {
return Boolean(value) && value !== "unknown";
}
function asNumber(value) {
if (typeof value === "number" && Number.isFinite(value)) {
return value;
}
if (typeof value === "string" && value.trim().length > 0) {
const parsed = Number(value);
return Number.isFinite(parsed) ? parsed : null;
}
return null;
}
function runtimeMetaFrom(input) {
const direct = toRecordObject(input.addressRuntimeMeta);
if (direct) {
return direct;
}
const debug = toRecordObject(input.addressDebug);
if (!debug) {
return null;
}
const dialogContinuationContract = toRecordObject(debug.dialog_continuation_contract_v2);
const orchestrationContract = toRecordObject(debug.orchestration_contract_v1);
if (!dialogContinuationContract && !orchestrationContract) {
return null;
}
return {
dialogContinuationContract,
orchestrationContract,
toolGateDecision: debug.tool_gate_decision,
toolGateReason: debug.tool_gate_reason
};
}
function resolveCapabilityContractId(debug, meta) {
const explicitCapabilityId = toNonEmptyString(debug.capability_id);
if (explicitCapabilityId && (0, assistantRuntimeContractRegistry_1.getAssistantCapabilityContract)(explicitCapabilityId)) {
return {
capabilityId: explicitCapabilityId,
reasons: ["debug_capability_id_matched_contract"]
};
}
const orchestrationContract = toRecordObject(meta?.orchestrationContract) ?? toRecordObject(debug.orchestration_contract_v1);
const intent = toNonEmptyString(debug.detected_intent) ??
toNonEmptyString(orchestrationContract?.address_intent);
if (isAddressIntent(intent)) {
const contract = (0, assistantRuntimeContractRegistry_1.getAssistantCapabilityContractByIntent)(intent);
if (contract) {
return {
capabilityId: contract.capability_id,
reasons: ["intent_matched_capability_contract"]
};
}
}
return {
capabilityId: null,
reasons: explicitCapabilityId ? ["debug_capability_id_has_no_contract"] : ["capability_contract_not_resolved"]
};
}
function isSelectedObjectCapability(capabilityId) {
if (!capabilityId) {
return false;
}
const contract = (0, assistantRuntimeContractRegistry_1.getAssistantCapabilityContract)(capabilityId);
return Boolean(contract?.requires_focus_object);
}
function resolveTransitionId(input) {
const dialogContinuationContract = toRecordObject(input.meta?.dialogContinuationContract) ??
toRecordObject(input.debug.dialog_continuation_contract_v2);
const orchestrationContract = toRecordObject(input.meta?.orchestrationContract) ??
toRecordObject(input.debug.orchestration_contract_v1);
const finalDecision = toRecordObject(orchestrationContract?.final_decision);
const hardMetaMode = toNonEmptyString(orchestrationContract?.hard_meta_mode);
const toolGateReason = toNonEmptyString(input.meta?.toolGateReason) ??
toNonEmptyString(input.debug.tool_gate_reason) ??
toNonEmptyString(finalDecision?.tool_gate_reason);
const continuationDecision = toNonEmptyString(dialogContinuationContract?.decision);
const targetIntent = toNonEmptyString(dialogContinuationContract?.target_intent) ??
toNonEmptyString(input.debug.detected_intent);
const currentFrameKind = toNonEmptyString(toRecordObject(input.debug.address_root_frame_context)?.current_frame_kind);
const missingFilters = Array.isArray(input.debug.missing_required_filters) ? input.debug.missing_required_filters.length : 0;
if (input.groundingStatus === "route_mismatch_blocked" ||
input.debug.route_expectation_status === "mismatch" ||
input.debug.limited_reason_category === "execution_error") {
return { transitionId: "T10", reasons: ["blocked_or_route_mismatch_debug_status"] };
}
if (missingFilters > 0 || input.debug.limited_reason_category === "missing_anchor") {
return { transitionId: "T7", reasons: ["missing_anchor_or_filter_requires_clarification"] };
}
if (toolGateReason === "memory_recap_followup_detected") {
return { transitionId: "T9", reasons: ["memory_recap_tool_gate_reason"] };
}
if (hardMetaMode === "capability" || toolGateReason === "assistant_capability_query_detected") {
return { transitionId: "T8", reasons: ["capability_meta_followup_tool_gate_reason"] };
}
if (isSelectedObjectCapability(input.capabilityId)) {
if (continuationDecision === "continue_previous") {
return { transitionId: "T4", reasons: ["selected_object_capability_continue_previous"] };
}
if (continuationDecision === "new_topic") {
return { transitionId: "T3", reasons: ["selected_object_capability_explicit_entry"] };
}
return { transitionId: "T5", reasons: ["selected_object_capability_without_explicit_continuation_decision"] };
}
if (currentFrameKind === "inventory_drilldown" && targetIntent && targetIntent !== "inventory_on_hand_as_of_date") {
return { transitionId: "T6", reasons: ["root_context_reused_after_drilldown_context"] };
}
if (continuationDecision === "continue_previous") {
return { transitionId: "T2", reasons: ["root_followup_continue_previous"] };
}
if (input.capabilityId) {
return { transitionId: "T1", reasons: ["capability_contract_root_or_new_entry"] };
}
return { transitionId: null, reasons: ["transition_contract_not_resolved"] };
}
function resolveTruthGateStatus(input) {
if (input.groundingStatus === "route_mismatch_blocked" || input.debug.route_expectation_status === "mismatch") {
return "blocked_route_expectation_failure";
}
if (input.debug.limited_reason_category === "execution_error") {
return "blocked_execution_error";
}
if (input.debug.limited_reason_category === "missing_anchor") {
return "blocked_missing_anchor";
}
if (input.debug.temporal_guard_outcome === "ambiguous_limited" ||
input.debug.temporal_alignment_status === "conflicting") {
return "limited_temporal_or_contextual";
}
if (input.debug.limited_reason_category || input.groundingStatus === "partial") {
return "partial_supported";
}
const rowsMatched = asNumber(input.debug.rows_matched);
const routeExpectationStatus = toNonEmptyString(input.debug.route_expectation_status);
if ((input.groundingStatus === "grounded" || (rowsMatched !== null && rowsMatched > 0)) && (!routeExpectationStatus || routeExpectationStatus === "matched")) {
return "full_confirmed";
}
return "unknown";
}
function carryoverEligibilityFor(transitionId, truthGateStatus) {
if (truthGateStatus.startsWith("blocked")) {
return "none";
}
if (transitionId === "T3" || transitionId === "T4" || transitionId === "T5") {
return "object_only";
}
if (transitionId === "T8" || transitionId === "T9") {
return "meta_only";
}
if (transitionId === "T1" || transitionId === "T2" || transitionId === "T6") {
return "root_only";
}
if (transitionId === "T7") {
return "full";
}
return "none";
}
function resolveAssistantRuntimeContractShadow(input) {
const debug = toRecordObject(input.addressDebug) ?? {};
const meta = runtimeMetaFrom(input);
const groundingStatus = toNonEmptyString(input.groundingStatus) ??
toNonEmptyString(toRecordObject(debug.answer_grounding_check)?.status);
const capability = resolveCapabilityContractId(debug, meta);
const transition = resolveTransitionId({
debug,
meta,
capabilityId: capability.capabilityId,
groundingStatus
});
const transitionContract = transition.transitionId ? (0, assistantRuntimeContractRegistry_1.getAssistantTransitionContract)(transition.transitionId) : null;
const truthGateStatus = resolveTruthGateStatus({ debug, groundingStatus });
return {
schema_version: assistantRuntimeContracts_1.ASSISTANT_RUNTIME_CONTRACTS_SCHEMA_VERSION,
transition_contract_id: transition.transitionId,
transition_contract_title: transitionContract?.title ?? null,
transition_contract_reason: transition.reasons,
capability_contract_id: capability.capabilityId,
capability_contract_reason: capability.reasons,
truth_gate_contract_status: truthGateStatus,
carryover_eligibility: carryoverEligibilityFor(transition.transitionId, truthGateStatus)
};
}
function buildAssistantRuntimeContractShadowFields(input) {
const decision = resolveAssistantRuntimeContractShadow(input);
return {
assistant_runtime_contract_v1: decision,
transition_contract_id: decision.transition_contract_id,
capability_contract_id: decision.capability_contract_id,
truth_gate_contract_status: decision.truth_gate_contract_status
};
}
function attachAssistantRuntimeContractShadow(debugPayload, input) {
return {
...debugPayload,
...buildAssistantRuntimeContractShadowFields({
...input,
addressDebug: debugPayload
})
};
}