233 lines
10 KiB
JavaScript
233 lines
10 KiB
JavaScript
"use strict";
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.resolveAssistantRuntimeContractShadow = resolveAssistantRuntimeContractShadow;
|
|
exports.buildAssistantRuntimeContractShadowFields = buildAssistantRuntimeContractShadowFields;
|
|
exports.attachAssistantRuntimeContractShadow = attachAssistantRuntimeContractShadow;
|
|
const assistantRuntimeContracts_1 = require("../types/assistantRuntimeContracts");
|
|
const addressTruthGatePolicy_1 = require("./addressTruthGatePolicy");
|
|
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.explicitTruthGateStatus) {
|
|
return input.explicitTruthGateStatus;
|
|
}
|
|
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, explicitCarryoverEligibility) {
|
|
if (truthGateStatus.startsWith("blocked")) {
|
|
return "none";
|
|
}
|
|
if (explicitCarryoverEligibility) {
|
|
return explicitCarryoverEligibility;
|
|
}
|
|
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 addressTruthGate = (0, addressTruthGatePolicy_1.toAddressTruthGateContract)(debug.address_truth_gate_v1);
|
|
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,
|
|
explicitTruthGateStatus: addressTruthGate?.truth_gate_status ?? null
|
|
});
|
|
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, addressTruthGate?.carryover_eligibility ?? null)
|
|
};
|
|
}
|
|
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
|
|
})
|
|
};
|
|
}
|