@uns-kit/assistant-workflow 2.0.72

package/dist/tool-selection-policy.d.ts

@@ -0,0 +1,81 @@
+import { type AssistantWorkflowDefinition, type AssistantWorkflowOptionalToolSelectionMode, type AssistantWorkflowToolContextRequirement } from "./definition.js";
+import type { AssistantWorkflowDecision, AssistantWorkflowDecisionInput } from "./decision.js";
+export type { AssistantWorkflowOptionalToolSelectionMode } from "./definition.js";
+export type AssistantWorkflowToolSelectionCandidate = {
+    optionalToolSelectionMode: AssistantWorkflowOptionalToolSelectionMode;
+    toolNames: string[];
+    classifierToolNames: string[];
+    requiredToolNames: string[];
+    optionalToolNames: string[];
+    excludedOptionalToolNames: string[];
+    activeProfileIds: string[];
+    profileToolNames: string[];
+    profileExcludedToolNames: string[];
+};
+export type AssistantWorkflowToolSelectionCandidateInput = {
+    workflow: AssistantWorkflowDefinition<string, string, string, string>;
+    decision: Pick<AssistantWorkflowDecision, "intent" | "classifierTools" | "requiredToolHints" | "toolHints" | "workflowSuggestedTools">;
+    availableToolNames?: readonly string[] | null;
+    hop?: number | null;
+    selectedReason?: string | null;
+    resolvedScope?: boolean;
+    attributeCount?: number | null;
+};
+export type AssistantWorkflowToolSelectionAuthoritySource = "workflow" | "legacy-pruner";
+export type AssistantWorkflowToolSelectionAuthorityReason = "workflow_equivalent" | "workflow_authority_enabled" | "workflow_unavailable" | "workflow_authority_not_enabled" | "workflow_blocked" | "workflow_differs";
+export type AssistantWorkflowToolSelectionAuthority = {
+    source: AssistantWorkflowToolSelectionAuthoritySource;
+    reason: AssistantWorkflowToolSelectionAuthorityReason;
+    selectedToolNames: string[];
+    workflowSuggestedToolNames: string[];
+    workflowStatus: string | null;
+};
+export type AssistantWorkflowToolSelectionAuthorityInput = {
+    selectedToolNames: readonly string[];
+    workflowAvailable: boolean;
+    workflowSuggestedToolNames?: readonly string[] | null;
+    workflowSelectionCandidateToolNames?: readonly string[] | null;
+    workflowStatus?: string | null;
+    workflowAuthorityEnabled?: boolean | null;
+};
+export type AssistantWorkflowToolSelectionComparisonInput = {
+    workflow: AssistantWorkflowDefinition<string, string, string, string>;
+    classification?: AssistantWorkflowDecisionInput | null;
+    availableToolNames?: readonly string[] | null;
+    selectedToolNames: readonly string[];
+    selectedMode?: string | null;
+    selectedReason?: string | null;
+    hop?: number | null;
+    pruningEnabled?: boolean | null;
+    availableContext?: readonly AssistantWorkflowToolContextRequirement[] | null;
+    resolvedScope?: boolean;
+    workflowAuthorityIntentIds?: readonly string[] | null;
+    workflowAuthoritySegmentKeys?: readonly string[] | null;
+    workflowAuthorityProfileKeys?: readonly string[] | null;
+};
+export type AssistantWorkflowToolSelectionDecisionInput = AssistantWorkflowToolSelectionComparisonInput;
+export type AssistantWorkflowToolSelectionDecision = {
+    comparisonPayload: Record<string, unknown> | null;
+    authority: AssistantWorkflowToolSelectionAuthority;
+    effectiveToolNames: string[];
+    effectiveReason: string | null;
+};
+export declare function buildAssistantWorkflowToolSelectionCandidate(input: AssistantWorkflowToolSelectionCandidateInput): AssistantWorkflowToolSelectionCandidate;
+export declare function buildAssistantWorkflowToolSelectionDecision(input: AssistantWorkflowToolSelectionDecisionInput): AssistantWorkflowToolSelectionDecision;
+export declare function buildAssistantWorkflowToolSelectionComparisonPayload(input: AssistantWorkflowToolSelectionComparisonInput): Record<string, unknown> | null;
+export declare function buildAssistantWorkflowToolSelectionAuthority(input: AssistantWorkflowToolSelectionAuthorityInput): AssistantWorkflowToolSelectionAuthority;
+export declare function buildAssistantWorkflowToolSelectionSegmentKey(input: {
+    intentId: string | null;
+    hop: number | null;
+    selectedReason: string | null;
+}): string;
+/**
+ * Exact active profile combinations are authority scopes. A single profile can
+ * be safe in one combination and unsafe in another, so profile ids are sorted
+ * and retained together with the intent.
+ */
+export declare function buildAssistantWorkflowToolSelectionProfileKey(input: {
+    intentId: string | null;
+    profileIds: readonly unknown[] | null | undefined;
+}): string | null;
+//# sourceMappingURL=tool-selection-policy.d.ts.map

package/dist/tool-selection-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-selection-policy.d.ts","sourceRoot":"","sources":["../src/tool-selection-policy.ts"],"names":[],"mappings":"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"}

package/dist/tool-selection-policy.js

@@ -0,0 +1,376 @@
+import { findAssistantWorkflowIntent, } from "./definition.js";
+import { buildAssistantWorkflowRun, buildAssistantWorkflowRunTracePayload, } from "./run.js";
+import { summarizeAssistantWorkflowToolCapabilities } from "./tool-capabilities.js";
+import { readAssistantWorkflowString as normalizeNullableString, readAssistantWorkflowStringArray as readStringArray, } from "./value-readers.js";
+export function buildAssistantWorkflowToolSelectionCandidate(input) {
+    const intent = findAssistantWorkflowIntent(input.workflow, input.decision.intent);
+    const optionalToolSelectionMode = intent?.optionalToolSelectionMode ?? "classifier-confirmed";
+    const classifierToolNames = uniqueStrings(input.decision.classifierTools);
+    const requiredToolNames = uniqueStrings(input.decision.requiredToolHints);
+    const optionalToolNames = uniqueStrings(input.decision.toolHints)
+        .filter((toolName) => !requiredToolNames.includes(toolName));
+    const classifierToolSet = new Set(classifierToolNames);
+    const availableToolNameSet = buildOptionalToolNameSet(input.availableToolNames);
+    const activeProfiles = (intent?.toolSelectionProfiles ?? [])
+        .filter((profile) => toolSelectionProfileConditionMatches(profile.condition, {
+        hop: input.hop ?? null,
+        selectedReason: input.selectedReason ?? null,
+        resolvedScope: input.resolvedScope === true,
+        attributeCount: input.attributeCount ?? null,
+        classifierToolNames: classifierToolSet,
+    }));
+    const activeProfileIds = uniqueStrings(activeProfiles.map((profile) => profile.id));
+    const profileToolNames = uniqueStrings(activeProfiles.flatMap((profile) => {
+        const mode = profile.optionalToolSelectionMode ?? "workflow-suggested";
+        const profileToolHints = uniqueStrings(profile.toolHints)
+            .filter((toolName) => !availableToolNameSet || availableToolNameSet.has(toolName));
+        return mode === "workflow-suggested"
+            ? profileToolHints
+            : profileToolHints.filter((toolName) => classifierToolSet.has(toolName));
+    }));
+    const profileExcludedToolNames = uniqueStrings(activeProfiles.flatMap((profile) => profile.toolExclusions ?? []));
+    const requiredToolSet = new Set(requiredToolNames);
+    const profileExcludedToolSet = new Set(profileExcludedToolNames.filter((toolName) => !requiredToolSet.has(toolName)));
+    const allowedOptionalToolNames = optionalToolSelectionMode === "workflow-suggested"
+        ? optionalToolNames
+        : optionalToolNames.filter((toolName) => classifierToolSet.has(toolName));
+    const allowedOptionalToolSet = new Set(allowedOptionalToolNames);
+    const allowedSet = new Set([
+        ...classifierToolNames,
+        ...requiredToolNames,
+        ...allowedOptionalToolNames,
+        ...profileToolNames,
+    ]);
+    const toolNames = orderToolNamesByAvailableCatalog(uniqueStrings([
+        ...input.decision.workflowSuggestedTools.filter((toolName) => allowedSet.has(toolName)),
+        ...classifierToolNames,
+        ...requiredToolNames,
+        ...allowedOptionalToolNames,
+        ...profileToolNames,
+    ]).filter((toolName) => !profileExcludedToolSet.has(toolName)), input.availableToolNames);
+    return {
+        optionalToolSelectionMode,
+        toolNames,
+        classifierToolNames,
+        requiredToolNames,
+        optionalToolNames,
+        excludedOptionalToolNames: uniqueStrings([
+            ...optionalToolNames.filter((toolName) => !allowedOptionalToolSet.has(toolName)),
+            ...optionalToolNames.filter((toolName) => profileExcludedToolSet.has(toolName)),
+        ]),
+        activeProfileIds,
+        profileToolNames: orderToolNamesByAvailableCatalog(profileToolNames, input.availableToolNames),
+        profileExcludedToolNames: orderToolNamesByAvailableCatalog(profileExcludedToolNames, input.availableToolNames),
+    };
+}
+export function buildAssistantWorkflowToolSelectionDecision(input) {
+    const selectedToolNames = uniqueStrings(input.selectedToolNames);
+    const comparisonPayload = buildAssistantWorkflowToolSelectionComparisonPayload(input);
+    const workflowAuthorityEnabled = comparisonPayload
+        ? isWorkflowAuthorityEnabled(input, comparisonPayload)
+        : false;
+    const authority = comparisonPayload
+        ? buildAssistantWorkflowToolSelectionAuthority({
+            selectedToolNames,
+            workflowAvailable: true,
+            workflowSuggestedToolNames: readStringArray(comparisonPayload["workflowSuggestedTools"]),
+            workflowSelectionCandidateToolNames: readStringArray(comparisonPayload["workflowSelectionCandidateTools"]),
+            workflowStatus: readWorkflowStatus(comparisonPayload),
+            workflowAuthorityEnabled,
+        })
+        : buildAssistantWorkflowToolSelectionAuthority({
+            selectedToolNames,
+            workflowAvailable: false,
+        });
+    const gatedAuthority = applyWorkflowAuthorityIntentGate(authority, input, comparisonPayload);
+    const effectiveReason = gatedAuthority.source === "workflow"
+        ? gatedAuthority.reason
+        : normalizeNullableString(input.selectedReason);
+    const effectiveToolNames = gatedAuthority.source === "workflow"
+        ? [...gatedAuthority.selectedToolNames]
+        : selectedToolNames;
+    return {
+        comparisonPayload: comparisonPayload
+            ? {
+                ...comparisonPayload,
+                selectedReason: effectiveReason,
+                selectedToolCount: effectiveToolNames.length,
+                workflowAuthoritySegmentKey: buildAssistantWorkflowToolSelectionSegmentKey({
+                    intentId: normalizeNullableString(input.classification?.intent) ?? "unknown",
+                    hop: input.hop ?? null,
+                    selectedReason: input.selectedReason ?? null,
+                }),
+                workflowAuthorityIntentIds: normalizeOptionalStringList(input.workflowAuthorityIntentIds),
+                workflowAuthoritySegmentKeys: normalizeOptionalStringList(input.workflowAuthoritySegmentKeys),
+                workflowAuthorityProfileKeys: normalizeOptionalStringList(input.workflowAuthorityProfileKeys),
+                authority: gatedAuthority,
+            }
+            : null,
+        authority: gatedAuthority,
+        effectiveToolNames,
+        effectiveReason,
+    };
+}
+export function buildAssistantWorkflowToolSelectionComparisonPayload(input) {
+    if (!input.classification)
+        return null;
+    const selectedToolNames = uniqueStrings(input.selectedToolNames);
+    const workflowRun = buildAssistantWorkflowRun(input.workflow, {
+        classification: {
+            ...input.classification,
+            ...(input.resolvedScope === true ? { resolvedScope: true } : {}),
+        },
+        availableToolNames: input.availableToolNames ?? [],
+        availableContext: input.availableContext ?? null,
+    });
+    const workflowDecision = workflowRun.decision;
+    const workflowSelectionCandidate = buildAssistantWorkflowToolSelectionCandidate({
+        workflow: input.workflow,
+        decision: workflowDecision,
+        availableToolNames: input.availableToolNames ?? [],
+        hop: input.hop ?? null,
+        selectedReason: input.selectedReason ?? null,
+        resolvedScope: input.resolvedScope === true,
+        attributeCount: countDistinctAttributes(input.classification?.entities?.attributes),
+    });
+    const selectedSet = new Set(selectedToolNames);
+    const workflowSet = new Set(workflowDecision.workflowSuggestedTools);
+    const workflowSelectionCandidateSet = new Set(workflowSelectionCandidate.toolNames);
+    const workflowAuthorityProfileKey = buildAssistantWorkflowToolSelectionProfileKey({
+        intentId: workflowDecision.intent,
+        profileIds: workflowSelectionCandidate.activeProfileIds,
+    });
+    const runTrace = buildAssistantWorkflowRunTracePayload(workflowRun);
+    const decisionTrace = runTrace["decision"];
+    const executionPlanTrace = runTrace["executionPlan"];
+    return {
+        ...(typeof input.hop === "number" ? { hop: input.hop } : {}),
+        ...(typeof input.pruningEnabled === "boolean" ? { pruningEnabled: input.pruningEnabled } : {}),
+        // Keep workflow identity flat so bounded trace payload sanitizers retain it
+        // even when the detailed workflowRun object is omitted.
+        workflowId: workflowRun.workflowId,
+        workflowVersion: workflowRun.workflowVersion,
+        resolvedScope: input.resolvedScope === true,
+        ...(input.selectedMode ? { selectedMode: input.selectedMode } : {}),
+        ...(input.selectedReason ? { selectedReason: input.selectedReason } : {}),
+        selectedToolCount: selectedToolNames.length,
+        ...decisionTrace,
+        workflowRun: runTrace,
+        executionPlan: executionPlanTrace,
+        workflowSelectionCandidateTools: workflowSelectionCandidate.toolNames,
+        workflowSelectionOptionalToolMode: workflowSelectionCandidate.optionalToolSelectionMode,
+        workflowSelectionExcludedOptionalTools: workflowSelectionCandidate.excludedOptionalToolNames,
+        workflowSelectionActiveProfileIds: workflowSelectionCandidate.activeProfileIds,
+        workflowSelectionProfileTools: workflowSelectionCandidate.profileToolNames,
+        workflowSelectionProfileExcludedTools: workflowSelectionCandidate.profileExcludedToolNames,
+        ...(workflowAuthorityProfileKey ? { workflowAuthorityProfileKey } : {}),
+        missingWorkflowSuggestedTools: workflowDecision.workflowSuggestedTools.filter((tool) => !selectedSet.has(tool)),
+        missingWorkflowSelectionCandidateTools: workflowSelectionCandidate.toolNames.filter((tool) => !selectedSet.has(tool)),
+        selectedOutsideWorkflowSuggestions: selectedToolNames.filter((tool) => !workflowSet.has(tool)),
+        selectedOutsideWorkflowSelectionCandidate: selectedToolNames.filter((tool) => !workflowSelectionCandidateSet.has(tool)),
+        selectedToolCapabilitySummary: summarizeAssistantWorkflowToolCapabilities(input.workflow, selectedToolNames),
+        workflowSuggestedToolCapabilitySummary: summarizeAssistantWorkflowToolCapabilities(input.workflow, workflowDecision.workflowSuggestedTools),
+        workflowSelectionCandidateToolCapabilitySummary: summarizeAssistantWorkflowToolCapabilities(input.workflow, workflowSelectionCandidate.toolNames),
+    };
+}
+function toolSelectionProfileConditionMatches(condition, input) {
+    if (!condition)
+        return true;
+    if (condition.minHop !== undefined && (input.hop === null || input.hop < condition.minHop))
+        return false;
+    if (condition.maxHop !== undefined && (input.hop === null || input.hop > condition.maxHop))
+        return false;
+    if (condition.selectedReason !== undefined) {
+        const expectedReason = normalizeNullableString(condition.selectedReason);
+        if (expectedReason === null || normalizeNullableString(input.selectedReason) !== expectedReason)
+            return false;
+    }
+    if (condition.resolvedScope !== undefined && condition.resolvedScope !== input.resolvedScope)
+        return false;
+    if (condition.minAttributeCount !== undefined &&
+        (input.attributeCount === null || input.attributeCount < condition.minAttributeCount)) {
+        return false;
+    }
+    if (condition.maxAttributeCount !== undefined &&
+        (input.attributeCount === null || input.attributeCount > condition.maxAttributeCount)) {
+        return false;
+    }
+    if (condition.requiredClassifierTools !== undefined &&
+        !condition.requiredClassifierTools.every((toolName) => input.classifierToolNames.has(toolName))) {
+        return false;
+    }
+    return true;
+}
+function countDistinctAttributes(values) {
+    if (!Array.isArray(values))
+        return null;
+    return new Set(values
+        .filter((value) => typeof value === "string")
+        .map((value) => value.trim().toLocaleLowerCase())
+        .filter((value) => value.length > 0)).size;
+}
+function buildOptionalToolNameSet(values) {
+    const toolNames = normalizeOptionalStringList(values);
+    return toolNames === null || toolNames.length === 0 ? null : new Set(toolNames);
+}
+function orderToolNamesByAvailableCatalog(toolNames, availableToolNames) {
+    const availableOrder = normalizeOptionalStringList(availableToolNames);
+    if (!availableOrder?.length)
+        return toolNames;
+    const toolNameSet = new Set(toolNames);
+    const ordered = availableOrder.filter((toolName) => toolNameSet.has(toolName));
+    return uniqueStrings([
+        ...ordered,
+        ...toolNames.filter((toolName) => !ordered.includes(toolName)),
+    ]);
+}
+export function buildAssistantWorkflowToolSelectionAuthority(input) {
+    const selectedToolNames = uniqueStrings(input.selectedToolNames);
+    const workflowSuggestedToolNames = uniqueStrings(input.workflowSuggestedToolNames ?? []);
+    const workflowSelectionCandidateToolNames = uniqueStrings(input.workflowSelectionCandidateToolNames ?? []);
+    const workflowStatus = normalizeNullableString(input.workflowStatus);
+    const comparableWorkflowToolNames = workflowSelectionCandidateToolNames.length > 0
+        ? workflowSelectionCandidateToolNames
+        : workflowSuggestedToolNames;
+    if (!input.workflowAvailable) {
+        return {
+            source: "legacy-pruner",
+            reason: "workflow_unavailable",
+            selectedToolNames,
+            workflowSuggestedToolNames,
+            workflowStatus: null,
+        };
+    }
+    if (workflowStatus === "blocked" || workflowStatus === "needs-clarification") {
+        return {
+            source: "legacy-pruner",
+            reason: "workflow_blocked",
+            selectedToolNames,
+            workflowSuggestedToolNames,
+            workflowStatus,
+        };
+    }
+    if (input.workflowAuthorityEnabled && comparableWorkflowToolNames.length > 0) {
+        return {
+            source: "workflow",
+            reason: sameStringSet(selectedToolNames, comparableWorkflowToolNames)
+                ? "workflow_equivalent"
+                : "workflow_authority_enabled",
+            selectedToolNames: comparableWorkflowToolNames,
+            workflowSuggestedToolNames,
+            workflowStatus,
+        };
+    }
+    if (comparableWorkflowToolNames.length > 0 && sameStringSet(selectedToolNames, comparableWorkflowToolNames)) {
+        return {
+            source: "workflow",
+            reason: "workflow_equivalent",
+            selectedToolNames: comparableWorkflowToolNames,
+            workflowSuggestedToolNames,
+            workflowStatus,
+        };
+    }
+    return {
+        source: "legacy-pruner",
+        reason: "workflow_differs",
+        selectedToolNames,
+        workflowSuggestedToolNames,
+        workflowStatus,
+    };
+}
+export function buildAssistantWorkflowToolSelectionSegmentKey(input) {
+    return `${normalizeNullableString(input.intentId) ?? "unknown"}|hop:${input.hop ?? "unknown"}|${normalizeNullableString(input.selectedReason) ?? "unknown"}`;
+}
+/**
+ * Exact active profile combinations are authority scopes. A single profile can
+ * be safe in one combination and unsafe in another, so profile ids are sorted
+ * and retained together with the intent.
+ */
+export function buildAssistantWorkflowToolSelectionProfileKey(input) {
+    const intentId = normalizeNullableString(input.intentId);
+    const profileIds = uniqueStrings(input.profileIds ?? []).sort((left, right) => left.localeCompare(right));
+    if (!intentId || !profileIds.length)
+        return null;
+    return `${intentId}|profiles:${profileIds.join(",")}`;
+}
+function uniqueStrings(values) {
+    const out = [];
+    const seen = new Set();
+    for (const value of values) {
+        if (typeof value !== "string")
+            continue;
+        const trimmed = value.trim();
+        if (!trimmed.length || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        out.push(trimmed);
+    }
+    return out;
+}
+function applyWorkflowAuthorityIntentGate(authority, input, comparisonPayload) {
+    const enabledIntentIds = normalizeOptionalStringList(input.workflowAuthorityIntentIds);
+    const enabledSegmentKeys = normalizeOptionalStringList(input.workflowAuthoritySegmentKeys);
+    const enabledProfileKeys = normalizeOptionalStringList(input.workflowAuthorityProfileKeys);
+    if (enabledIntentIds === null && enabledSegmentKeys === null && enabledProfileKeys === null)
+        return authority;
+    if (authority.source !== "workflow")
+        return authority;
+    const intentId = normalizeNullableString(input.classification?.intent);
+    if (intentId && enabledIntentIds?.includes(intentId))
+        return authority;
+    const segmentKey = buildAssistantWorkflowToolSelectionSegmentKey({
+        intentId: intentId ?? "unknown",
+        hop: input.hop ?? null,
+        selectedReason: input.selectedReason ?? null,
+    });
+    if (enabledSegmentKeys?.includes(segmentKey))
+        return authority;
+    const profileKey = comparisonPayload
+        ? normalizeNullableString(comparisonPayload["workflowAuthorityProfileKey"])
+        : null;
+    if (profileKey && enabledProfileKeys?.includes(profileKey))
+        return authority;
+    return {
+        ...authority,
+        source: "legacy-pruner",
+        reason: "workflow_authority_not_enabled",
+    };
+}
+function isWorkflowAuthorityEnabled(input, comparisonPayload) {
+    const enabledIntentIds = normalizeOptionalStringList(input.workflowAuthorityIntentIds);
+    const enabledSegmentKeys = normalizeOptionalStringList(input.workflowAuthoritySegmentKeys);
+    const enabledProfileKeys = normalizeOptionalStringList(input.workflowAuthorityProfileKeys);
+    if (enabledIntentIds === null && enabledSegmentKeys === null && enabledProfileKeys === null)
+        return false;
+    const intentId = normalizeNullableString(input.classification?.intent);
+    if (intentId && enabledIntentIds?.includes(intentId))
+        return true;
+    const segmentKey = buildAssistantWorkflowToolSelectionSegmentKey({
+        intentId: intentId ?? "unknown",
+        hop: input.hop ?? null,
+        selectedReason: input.selectedReason ?? null,
+    });
+    if (enabledSegmentKeys?.includes(segmentKey))
+        return true;
+    const profileKey = normalizeNullableString(comparisonPayload["workflowAuthorityProfileKey"]);
+    return profileKey !== null && (enabledProfileKeys?.includes(profileKey) ?? false);
+}
+function normalizeOptionalStringList(values) {
+    if (values === null || values === undefined)
+        return null;
+    return uniqueStrings(values);
+}
+function readWorkflowStatus(payload) {
+    const workflowRun = isRecord(payload["workflowRun"]) ? payload["workflowRun"] : null;
+    return normalizeNullableString(workflowRun?.["status"]);
+}
+function sameStringSet(left, right) {
+    if (left.length !== right.length)
+        return false;
+    const rightSet = new Set(right);
+    return left.every((item) => rightSet.has(item));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=tool-selection-policy.js.map

package/dist/tool-selection-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-selection-policy.js","sourceRoot":"","sources":["../src/tool-selection-policy.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  findAssistantWorkflowIntent,\n  type AssistantWorkflowDefinition,\n  type AssistantWorkflowOptionalToolSelectionMode,\n  type AssistantWorkflowToolContextRequirement,\n} from \"./definition.js\";\nimport type { AssistantWorkflowDecision, AssistantWorkflowDecisionInput } from \"./decision.js\";\nimport {\n  buildAssistantWorkflowRun,\n  buildAssistantWorkflowRunTracePayload,\n} from \"./run.js\";\nimport { summarizeAssistantWorkflowToolCapabilities } from \"./tool-capabilities.js\";\nimport {\n  readAssistantWorkflowString as normalizeNullableString,\n  readAssistantWorkflowStringArray as readStringArray,\n} from \"./value-readers.js\";\n\nexport type { AssistantWorkflowOptionalToolSelectionMode } from \"./definition.js\";\n\nexport type AssistantWorkflowToolSelectionCandidate = {\n  optionalToolSelectionMode: AssistantWorkflowOptionalToolSelectionMode;\n  toolNames: string[];\n  classifierToolNames: string[];\n  requiredToolNames: string[];\n  optionalToolNames: string[];\n  excludedOptionalToolNames: string[];\n  activeProfileIds: string[];\n  profileToolNames: string[];\n  profileExcludedToolNames: string[];\n};\n\nexport type AssistantWorkflowToolSelectionCandidateInput = {\n  workflow: AssistantWorkflowDefinition<string, string, string, string>;\n  decision: Pick<\n    AssistantWorkflowDecision,\n    \"intent\" | \"classifierTools\" | \"requiredToolHints\" | \"toolHints\" | \"workflowSuggestedTools\"\n  >;\n  availableToolNames?: readonly string[] | null;\n  hop?: number | null;\n  selectedReason?: string | null;\n  resolvedScope?: boolean;\n  attributeCount?: number | null;\n};\n\nexport type AssistantWorkflowToolSelectionAuthoritySource = \"workflow\" | \"legacy-pruner\";\n\nexport type AssistantWorkflowToolSelectionAuthorityReason =\n  | \"workflow_equivalent\"\n  | \"workflow_authority_enabled\"\n  | \"workflow_unavailable\"\n  | \"workflow_authority_not_enabled\"\n  | \"workflow_blocked\"\n  | \"workflow_differs\";\n\nexport type AssistantWorkflowToolSelectionAuthority = {\n  source: AssistantWorkflowToolSelectionAuthoritySource;\n  reason: AssistantWorkflowToolSelectionAuthorityReason;\n  selectedToolNames: string[];\n  workflowSuggestedToolNames: string[];\n  workflowStatus: string | null;\n};\n\nexport type AssistantWorkflowToolSelectionAuthorityInput = {\n  selectedToolNames: readonly string[];\n  workflowAvailable: boolean;\n  workflowSuggestedToolNames?: readonly string[] | null;\n  workflowSelectionCandidateToolNames?: readonly string[] | null;\n  workflowStatus?: string | null;\n  workflowAuthorityEnabled?: boolean | null;\n};\n\nexport type AssistantWorkflowToolSelectionComparisonInput = {\n  workflow: AssistantWorkflowDefinition<string, string, string, string>;\n  classification?: AssistantWorkflowDecisionInput | null;\n  availableToolNames?: readonly string[] | null;\n  selectedToolNames: readonly string[];\n  selectedMode?: string | null;\n  selectedReason?: string | null;\n  hop?: number | null;\n  pruningEnabled?: boolean | null;\n  availableContext?: readonly AssistantWorkflowToolContextRequirement[] | null;\n  resolvedScope?: boolean;\n  workflowAuthorityIntentIds?: readonly string[] | null;\n  workflowAuthoritySegmentKeys?: readonly string[] | null;\n  workflowAuthorityProfileKeys?: readonly string[] | null;\n};\n\nexport type AssistantWorkflowToolSelectionDecisionInput = AssistantWorkflowToolSelectionComparisonInput;\n\nexport type AssistantWorkflowToolSelectionDecision = {\n  comparisonPayload: Record<string, unknown> | null;\n  authority: AssistantWorkflowToolSelectionAuthority;\n  effectiveToolNames: string[];\n  effectiveReason: string | null;\n};\n\nexport function buildAssistantWorkflowToolSelectionCandidate(\n  input: AssistantWorkflowToolSelectionCandidateInput,\n): AssistantWorkflowToolSelectionCandidate {\n  const intent = findAssistantWorkflowIntent(input.workflow, input.decision.intent);\n  const optionalToolSelectionMode = intent?.optionalToolSelectionMode ?? \"classifier-confirmed\";\n  const classifierToolNames = uniqueStrings(input.decision.classifierTools);\n  const requiredToolNames = uniqueStrings(input.decision.requiredToolHints);\n  const optionalToolNames = uniqueStrings(input.decision.toolHints)\n    .filter((toolName) => !requiredToolNames.includes(toolName));\n  const classifierToolSet = new Set(classifierToolNames);\n  const availableToolNameSet = buildOptionalToolNameSet(input.availableToolNames);\n  const activeProfiles = (intent?.toolSelectionProfiles ?? [])\n    .filter((profile) => toolSelectionProfileConditionMatches(profile.condition, {\n      hop: input.hop ?? null,\n      selectedReason: input.selectedReason ?? null,\n      resolvedScope: input.resolvedScope === true,\n      attributeCount: input.attributeCount ?? null,\n      classifierToolNames: classifierToolSet,\n    }));\n  const activeProfileIds = uniqueStrings(activeProfiles.map((profile) => profile.id));\n  const profileToolNames = uniqueStrings(activeProfiles.flatMap((profile) => {\n    const mode = profile.optionalToolSelectionMode ?? \"workflow-suggested\";\n    const profileToolHints = uniqueStrings(profile.toolHints)\n      .filter((toolName) => !availableToolNameSet || availableToolNameSet.has(toolName));\n    return mode === \"workflow-suggested\"\n      ? profileToolHints\n      : profileToolHints.filter((toolName) => classifierToolSet.has(toolName));\n  }));\n  const profileExcludedToolNames = uniqueStrings(activeProfiles.flatMap((profile) => profile.toolExclusions ?? []));\n  const requiredToolSet = new Set(requiredToolNames);\n  const profileExcludedToolSet = new Set(profileExcludedToolNames.filter((toolName) => !requiredToolSet.has(toolName)));\n  const allowedOptionalToolNames = optionalToolSelectionMode === \"workflow-suggested\"\n    ? optionalToolNames\n    : optionalToolNames.filter((toolName) => classifierToolSet.has(toolName));\n  const allowedOptionalToolSet = new Set(allowedOptionalToolNames);\n  const allowedSet = new Set([\n    ...classifierToolNames,\n    ...requiredToolNames,\n    ...allowedOptionalToolNames,\n    ...profileToolNames,\n  ]);\n  const toolNames = orderToolNamesByAvailableCatalog(uniqueStrings([\n    ...input.decision.workflowSuggestedTools.filter((toolName) => allowedSet.has(toolName)),\n    ...classifierToolNames,\n    ...requiredToolNames,\n    ...allowedOptionalToolNames,\n    ...profileToolNames,\n  ]).filter((toolName) => !profileExcludedToolSet.has(toolName)), input.availableToolNames);\n\n  return {\n    optionalToolSelectionMode,\n    toolNames,\n    classifierToolNames,\n    requiredToolNames,\n    optionalToolNames,\n    excludedOptionalToolNames: uniqueStrings([\n      ...optionalToolNames.filter((toolName) => !allowedOptionalToolSet.has(toolName)),\n      ...optionalToolNames.filter((toolName) => profileExcludedToolSet.has(toolName)),\n    ]),\n    activeProfileIds,\n    profileToolNames: orderToolNamesByAvailableCatalog(profileToolNames, input.availableToolNames),\n    profileExcludedToolNames: orderToolNamesByAvailableCatalog(profileExcludedToolNames, input.availableToolNames),\n  };\n}\n\nexport function buildAssistantWorkflowToolSelectionDecision(\n  input: AssistantWorkflowToolSelectionDecisionInput,\n): AssistantWorkflowToolSelectionDecision {\n  const selectedToolNames = uniqueStrings(input.selectedToolNames);\n  const comparisonPayload = buildAssistantWorkflowToolSelectionComparisonPayload(input);\n  const workflowAuthorityEnabled = comparisonPayload\n    ? isWorkflowAuthorityEnabled(input, comparisonPayload)\n    : false;\n  const authority = comparisonPayload\n    ? buildAssistantWorkflowToolSelectionAuthority({\n        selectedToolNames,\n        workflowAvailable: true,\n        workflowSuggestedToolNames: readStringArray(comparisonPayload[\"workflowSuggestedTools\"]),\n        workflowSelectionCandidateToolNames: readStringArray(comparisonPayload[\"workflowSelectionCandidateTools\"]),\n        workflowStatus: readWorkflowStatus(comparisonPayload),\n        workflowAuthorityEnabled,\n      })\n    : buildAssistantWorkflowToolSelectionAuthority({\n        selectedToolNames,\n        workflowAvailable: false,\n      });\n  const gatedAuthority = applyWorkflowAuthorityIntentGate(authority, input, comparisonPayload);\n  const effectiveReason = gatedAuthority.source === \"workflow\"\n    ? gatedAuthority.reason\n    : normalizeNullableString(input.selectedReason);\n  const effectiveToolNames = gatedAuthority.source === \"workflow\"\n    ? [...gatedAuthority.selectedToolNames]\n    : selectedToolNames;\n\n  return {\n    comparisonPayload: comparisonPayload\n      ? {\n          ...comparisonPayload,\n          selectedReason: effectiveReason,\n          selectedToolCount: effectiveToolNames.length,\n          workflowAuthoritySegmentKey: buildAssistantWorkflowToolSelectionSegmentKey({\n            intentId: normalizeNullableString(input.classification?.intent) ?? \"unknown\",\n            hop: input.hop ?? null,\n            selectedReason: input.selectedReason ?? null,\n          }),\n          workflowAuthorityIntentIds: normalizeOptionalStringList(input.workflowAuthorityIntentIds),\n          workflowAuthoritySegmentKeys: normalizeOptionalStringList(input.workflowAuthoritySegmentKeys),\n          workflowAuthorityProfileKeys: normalizeOptionalStringList(input.workflowAuthorityProfileKeys),\n          authority: gatedAuthority,\n        }\n      : null,\n    authority: gatedAuthority,\n    effectiveToolNames,\n    effectiveReason,\n  };\n}\n\nexport function buildAssistantWorkflowToolSelectionComparisonPayload(\n  input: AssistantWorkflowToolSelectionComparisonInput,\n): Record<string, unknown> | null {\n  if (!input.classification) return null;\n\n  const selectedToolNames = uniqueStrings(input.selectedToolNames);\n  const workflowRun = buildAssistantWorkflowRun(input.workflow, {\n    classification: {\n      ...input.classification,\n      ...(input.resolvedScope === true ? { resolvedScope: true } : {}),\n    },\n    availableToolNames: input.availableToolNames ?? [],\n    availableContext: input.availableContext ?? null,\n  });\n  const workflowDecision = workflowRun.decision;\n  const workflowSelectionCandidate = buildAssistantWorkflowToolSelectionCandidate({\n    workflow: input.workflow,\n    decision: workflowDecision,\n    availableToolNames: input.availableToolNames ?? [],\n    hop: input.hop ?? null,\n    selectedReason: input.selectedReason ?? null,\n    resolvedScope: input.resolvedScope === true,\n    attributeCount: countDistinctAttributes(input.classification?.entities?.attributes),\n  });\n  const selectedSet = new Set(selectedToolNames);\n  const workflowSet = new Set(workflowDecision.workflowSuggestedTools);\n  const workflowSelectionCandidateSet = new Set(workflowSelectionCandidate.toolNames);\n  const workflowAuthorityProfileKey = buildAssistantWorkflowToolSelectionProfileKey({\n    intentId: workflowDecision.intent,\n    profileIds: workflowSelectionCandidate.activeProfileIds,\n  });\n  const runTrace = buildAssistantWorkflowRunTracePayload(workflowRun);\n  const decisionTrace = runTrace[\"decision\"] as Record<string, unknown>;\n  const executionPlanTrace = runTrace[\"executionPlan\"] as Record<string, unknown>;\n\n  return {\n    ...(typeof input.hop === \"number\" ? { hop: input.hop } : {}),\n    ...(typeof input.pruningEnabled === \"boolean\" ? { pruningEnabled: input.pruningEnabled } : {}),\n    // Keep workflow identity flat so bounded trace payload sanitizers retain it\n    // even when the detailed workflowRun object is omitted.\n    workflowId: workflowRun.workflowId,\n    workflowVersion: workflowRun.workflowVersion,\n    resolvedScope: input.resolvedScope === true,\n    ...(input.selectedMode ? { selectedMode: input.selectedMode } : {}),\n    ...(input.selectedReason ? { selectedReason: input.selectedReason } : {}),\n    selectedToolCount: selectedToolNames.length,\n    ...decisionTrace,\n    workflowRun: runTrace,\n    executionPlan: executionPlanTrace,\n    workflowSelectionCandidateTools: workflowSelectionCandidate.toolNames,\n    workflowSelectionOptionalToolMode: workflowSelectionCandidate.optionalToolSelectionMode,\n    workflowSelectionExcludedOptionalTools: workflowSelectionCandidate.excludedOptionalToolNames,\n    workflowSelectionActiveProfileIds: workflowSelectionCandidate.activeProfileIds,\n    workflowSelectionProfileTools: workflowSelectionCandidate.profileToolNames,\n    workflowSelectionProfileExcludedTools: workflowSelectionCandidate.profileExcludedToolNames,\n    ...(workflowAuthorityProfileKey ? { workflowAuthorityProfileKey } : {}),\n    missingWorkflowSuggestedTools: workflowDecision.workflowSuggestedTools.filter((tool) => !selectedSet.has(tool)),\n    missingWorkflowSelectionCandidateTools: workflowSelectionCandidate.toolNames.filter((tool) => !selectedSet.has(tool)),\n    selectedOutsideWorkflowSuggestions: selectedToolNames.filter((tool) => !workflowSet.has(tool)),\n    selectedOutsideWorkflowSelectionCandidate: selectedToolNames.filter((tool) => !workflowSelectionCandidateSet.has(tool)),\n    selectedToolCapabilitySummary: summarizeAssistantWorkflowToolCapabilities(\n      input.workflow,\n      selectedToolNames,\n    ),\n    workflowSuggestedToolCapabilitySummary: summarizeAssistantWorkflowToolCapabilities(\n      input.workflow,\n      workflowDecision.workflowSuggestedTools,\n    ),\n    workflowSelectionCandidateToolCapabilitySummary: summarizeAssistantWorkflowToolCapabilities(\n      input.workflow,\n      workflowSelectionCandidate.toolNames,\n    ),\n  };\n}\n\nfunction toolSelectionProfileConditionMatches(\n  condition: NonNullable<AssistantWorkflowDefinition<string, string, string, string>[\"intents\"][number][\"toolSelectionProfiles\"]>[number][\"condition\"],\n  input: {\n    hop: number | null;\n    selectedReason: string | null;\n    resolvedScope: boolean;\n    attributeCount: number | null;\n    classifierToolNames: ReadonlySet<string>;\n  },\n): boolean {\n  if (!condition) return true;\n  if (condition.minHop !== undefined && (input.hop === null || input.hop < condition.minHop)) return false;\n  if (condition.maxHop !== undefined && (input.hop === null || input.hop > condition.maxHop)) return false;\n  if (condition.selectedReason !== undefined) {\n    const expectedReason = normalizeNullableString(condition.selectedReason);\n    if (expectedReason === null || normalizeNullableString(input.selectedReason) !== expectedReason) return false;\n  }\n  if (condition.resolvedScope !== undefined && condition.resolvedScope !== input.resolvedScope) return false;\n  if (\n    condition.minAttributeCount !== undefined &&\n    (input.attributeCount === null || input.attributeCount < condition.minAttributeCount)\n  ) {\n    return false;\n  }\n  if (\n    condition.maxAttributeCount !== undefined &&\n    (input.attributeCount === null || input.attributeCount > condition.maxAttributeCount)\n  ) {\n    return false;\n  }\n  if (\n    condition.requiredClassifierTools !== undefined &&\n    !condition.requiredClassifierTools.every((toolName) => input.classifierToolNames.has(toolName))\n  ) {\n    return false;\n  }\n  return true;\n}\n\nfunction countDistinctAttributes(values: readonly string[] | null | undefined): number | null {\n  if (!Array.isArray(values)) return null;\n  return new Set(\n    values\n      .filter((value): value is string => typeof value === \"string\")\n      .map((value) => value.trim().toLocaleLowerCase())\n      .filter((value) => value.length > 0),\n  ).size;\n}\n\nfunction buildOptionalToolNameSet(values: readonly unknown[] | null | undefined): Set<string> | null {\n  const toolNames = normalizeOptionalStringList(values);\n  return toolNames === null || toolNames.length === 0 ? null : new Set(toolNames);\n}\n\nfunction orderToolNamesByAvailableCatalog(\n  toolNames: string[],\n  availableToolNames: readonly unknown[] | null | undefined,\n): string[] {\n  const availableOrder = normalizeOptionalStringList(availableToolNames);\n  if (!availableOrder?.length) return toolNames;\n  const toolNameSet = new Set(toolNames);\n  const ordered = availableOrder.filter((toolName) => toolNameSet.has(toolName));\n  return uniqueStrings([\n    ...ordered,\n    ...toolNames.filter((toolName) => !ordered.includes(toolName)),\n  ]);\n}\n\nexport function buildAssistantWorkflowToolSelectionAuthority(\n  input: AssistantWorkflowToolSelectionAuthorityInput,\n): AssistantWorkflowToolSelectionAuthority {\n  const selectedToolNames = uniqueStrings(input.selectedToolNames);\n  const workflowSuggestedToolNames = uniqueStrings(input.workflowSuggestedToolNames ?? []);\n  const workflowSelectionCandidateToolNames = uniqueStrings(input.workflowSelectionCandidateToolNames ?? []);\n  const workflowStatus = normalizeNullableString(input.workflowStatus);\n  const comparableWorkflowToolNames = workflowSelectionCandidateToolNames.length > 0\n    ? workflowSelectionCandidateToolNames\n    : workflowSuggestedToolNames;\n\n  if (!input.workflowAvailable) {\n    return {\n      source: \"legacy-pruner\",\n      reason: \"workflow_unavailable\",\n      selectedToolNames,\n      workflowSuggestedToolNames,\n      workflowStatus: null,\n    };\n  }\n\n  if (workflowStatus === \"blocked\" || workflowStatus === \"needs-clarification\") {\n    return {\n      source: \"legacy-pruner\",\n      reason: \"workflow_blocked\",\n      selectedToolNames,\n      workflowSuggestedToolNames,\n      workflowStatus,\n    };\n  }\n\n  if (input.workflowAuthorityEnabled && comparableWorkflowToolNames.length > 0) {\n    return {\n      source: \"workflow\",\n      reason: sameStringSet(selectedToolNames, comparableWorkflowToolNames)\n        ? \"workflow_equivalent\"\n        : \"workflow_authority_enabled\",\n      selectedToolNames: comparableWorkflowToolNames,\n      workflowSuggestedToolNames,\n      workflowStatus,\n    };\n  }\n\n  if (comparableWorkflowToolNames.length > 0 && sameStringSet(selectedToolNames, comparableWorkflowToolNames)) {\n    return {\n      source: \"workflow\",\n      reason: \"workflow_equivalent\",\n      selectedToolNames: comparableWorkflowToolNames,\n      workflowSuggestedToolNames,\n      workflowStatus,\n    };\n  }\n\n  return {\n    source: \"legacy-pruner\",\n    reason: \"workflow_differs\",\n    selectedToolNames,\n    workflowSuggestedToolNames,\n    workflowStatus,\n  };\n}\n\nexport function buildAssistantWorkflowToolSelectionSegmentKey(input: {\n  intentId: string | null;\n  hop: number | null;\n  selectedReason: string | null;\n}): string {\n  return `${normalizeNullableString(input.intentId) ?? \"unknown\"}|hop:${input.hop ?? \"unknown\"}|${\n    normalizeNullableString(input.selectedReason) ?? \"unknown\"\n  }`;\n}\n\n/**\n * Exact active profile combinations are authority scopes. A single profile can\n * be safe in one combination and unsafe in another, so profile ids are sorted\n * and retained together with the intent.\n */\nexport function buildAssistantWorkflowToolSelectionProfileKey(input: {\n  intentId: string | null;\n  profileIds: readonly unknown[] | null | undefined;\n}): string | null {\n  const intentId = normalizeNullableString(input.intentId);\n  const profileIds = uniqueStrings(input.profileIds ?? []).sort((left, right) => left.localeCompare(right));\n  if (!intentId || !profileIds.length) return null;\n  return `${intentId}|profiles:${profileIds.join(\",\")}`;\n}\n\nfunction uniqueStrings(values: readonly unknown[]): string[] {\n  const out: string[] = [];\n  const seen = new Set<string>();\n  for (const value of values) {\n    if (typeof value !== \"string\") continue;\n    const trimmed = value.trim();\n    if (!trimmed.length || seen.has(trimmed)) continue;\n    seen.add(trimmed);\n    out.push(trimmed);\n  }\n  return out;\n}\n\nfunction applyWorkflowAuthorityIntentGate(\n  authority: AssistantWorkflowToolSelectionAuthority,\n  input: AssistantWorkflowToolSelectionDecisionInput,\n  comparisonPayload: Record<string, unknown> | null,\n): AssistantWorkflowToolSelectionAuthority {\n  const enabledIntentIds = normalizeOptionalStringList(input.workflowAuthorityIntentIds);\n  const enabledSegmentKeys = normalizeOptionalStringList(input.workflowAuthoritySegmentKeys);\n  const enabledProfileKeys = normalizeOptionalStringList(input.workflowAuthorityProfileKeys);\n  if (enabledIntentIds === null && enabledSegmentKeys === null && enabledProfileKeys === null) return authority;\n  if (authority.source !== \"workflow\") return authority;\n  const intentId = normalizeNullableString(input.classification?.intent);\n  if (intentId && enabledIntentIds?.includes(intentId)) return authority;\n  const segmentKey = buildAssistantWorkflowToolSelectionSegmentKey({\n    intentId: intentId ?? \"unknown\",\n    hop: input.hop ?? null,\n    selectedReason: input.selectedReason ?? null,\n  });\n  if (enabledSegmentKeys?.includes(segmentKey)) return authority;\n  const profileKey = comparisonPayload\n    ? normalizeNullableString(comparisonPayload[\"workflowAuthorityProfileKey\"])\n    : null;\n  if (profileKey && enabledProfileKeys?.includes(profileKey)) return authority;\n\n  return {\n    ...authority,\n    source: \"legacy-pruner\",\n    reason: \"workflow_authority_not_enabled\",\n  };\n}\n\nfunction isWorkflowAuthorityEnabled(\n  input: AssistantWorkflowToolSelectionDecisionInput,\n  comparisonPayload: Record<string, unknown>,\n): boolean {\n  const enabledIntentIds = normalizeOptionalStringList(input.workflowAuthorityIntentIds);\n  const enabledSegmentKeys = normalizeOptionalStringList(input.workflowAuthoritySegmentKeys);\n  const enabledProfileKeys = normalizeOptionalStringList(input.workflowAuthorityProfileKeys);\n  if (enabledIntentIds === null && enabledSegmentKeys === null && enabledProfileKeys === null) return false;\n  const intentId = normalizeNullableString(input.classification?.intent);\n  if (intentId && enabledIntentIds?.includes(intentId)) return true;\n  const segmentKey = buildAssistantWorkflowToolSelectionSegmentKey({\n    intentId: intentId ?? \"unknown\",\n    hop: input.hop ?? null,\n    selectedReason: input.selectedReason ?? null,\n  });\n  if (enabledSegmentKeys?.includes(segmentKey)) return true;\n  const profileKey = normalizeNullableString(comparisonPayload[\"workflowAuthorityProfileKey\"]);\n  return profileKey !== null && (enabledProfileKeys?.includes(profileKey) ?? false);\n}\n\nfunction normalizeOptionalStringList(values: readonly unknown[] | null | undefined): string[] | null {\n  if (values === null || values === undefined) return null;\n  return uniqueStrings(values);\n}\n\nfunction readWorkflowStatus(payload: Record<string, unknown>): string | null {\n  const workflowRun = isRecord(payload[\"workflowRun\"]) ? payload[\"workflowRun\"] : null;\n  return normalizeNullableString(workflowRun?.[\"status\"]);\n}\n\nfunction sameStringSet(left: readonly string[], right: readonly string[]): boolean {\n  if (left.length !== right.length) return false;\n  const rightSet = new Set(right);\n  return left.every((item) => rightSet.has(item));\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/tool-selection-replay.d.ts

@@ -0,0 +1,26 @@
+import { type AssistantWorkflowSerializedToolSelectionDecisionBatch, type AssistantWorkflowSerializedToolSelectionDecisionBatchOptions, type AssistantWorkflowSerializedToolSelectionDecisionLinesParseResult } from "./tool-selection-json.js";
+import type { AssistantWorkflowJsonValue } from "./run-report-json.js";
+import { type AssistantWorkflowToolSelectionAuthorityAllowListProposal, type AssistantWorkflowToolSelectionEvaluationBatch, type AssistantWorkflowToolSelectionMigrationReport, type AssistantWorkflowToolSelectionMigrationReviewArtifact } from "./tool-selection-evaluation.js";
+export type AssistantWorkflowToolSelectionReplayLinesOptions = AssistantWorkflowSerializedToolSelectionDecisionBatchOptions & {
+    minMigrationDecisionCount?: number | null;
+    currentAuthorityIntentIds?: readonly string[] | null;
+    currentAuthoritySegmentKeys?: readonly string[] | null;
+    migrationReviewPatchTargets?: readonly string[] | null;
+    migrationReviewRequiredTestIds?: readonly string[] | null;
+    migrationReviewTitle?: string | null;
+};
+export type AssistantWorkflowToolSelectionReplayLinesInput = {
+    decisionLines: string;
+};
+export type AssistantWorkflowToolSelectionReplayLinesResult = {
+    decisionParse: AssistantWorkflowSerializedToolSelectionDecisionLinesParseResult;
+    parseErrorCount: number;
+    batch: AssistantWorkflowSerializedToolSelectionDecisionBatch;
+    evaluation: AssistantWorkflowToolSelectionEvaluationBatch;
+    migration: AssistantWorkflowToolSelectionMigrationReport;
+    migrationProposal: AssistantWorkflowToolSelectionAuthorityAllowListProposal;
+    migrationReviewArtifact: AssistantWorkflowToolSelectionMigrationReviewArtifact;
+};
+export declare function runAssistantWorkflowToolSelectionReplayLines(input: AssistantWorkflowToolSelectionReplayLinesInput, options?: AssistantWorkflowToolSelectionReplayLinesOptions): AssistantWorkflowToolSelectionReplayLinesResult;
+export declare function buildAssistantWorkflowToolSelectionReplayLinesTracePayload(result: AssistantWorkflowToolSelectionReplayLinesResult): Record<string, AssistantWorkflowJsonValue>;
+//# sourceMappingURL=tool-selection-replay.d.ts.map

package/dist/tool-selection-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-selection-replay.d.ts","sourceRoot":"","sources":["../src/tool-selection-replay.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qDAAqD,EAE1D,KAAK,4DAA4D,EACjE,KAAK,gEAAgE,EACtE,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EASL,KAAK,wDAAwD,EAC7D,KAAK,6CAA6C,EAClD,KAAK,6CAA6C,EAClD,KAAK,qDAAqD,EAC3D,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,gDAAgD,GAC1D,4DAA4D,GAAG;IAC7D,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,yBAAyB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACrD,2BAA2B,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACvD,2BAA2B,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACvD,8BAA8B,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1D,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC,CAAC;AAEJ,MAAM,MAAM,8CAA8C,GAAG;IAC3D,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,+CAA+C,GAAG;IAC5D,aAAa,EAAE,gEAAgE,CAAC;IAChF,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,qDAAqD,CAAC;IAC7D,UAAU,EAAE,6CAA6C,CAAC;IAC1D,SAAS,EAAE,6CAA6C,CAAC;IACzD,iBAAiB,EAAE,wDAAwD,CAAC;IAC5E,uBAAuB,EAAE,qDAAqD,CAAC;CAChF,CAAC;AAEF,wBAAgB,4CAA4C,CAC1D,KAAK,EAAE,8CAA8C,EACrD,OAAO,GAAE,gDAAqD,GAC7D,+CAA+C,CA6CjD;AAED,wBAAgB,0DAA0D,CACxE,MAAM,EAAE,+CAA+C,GACtD,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CA6C5C"}