@uns-kit/assistant-workflow 2.0.72

package/dist/tool-selection-replay.js

@@ -0,0 +1,88 @@
+import { buildAssistantWorkflowSerializedToolSelectionDecisionBatch, parseAssistantWorkflowSerializedToolSelectionDecisionLines, } from "./tool-selection-json.js";
+import { buildAssistantWorkflowToolSelectionEvaluationBatch, buildAssistantWorkflowToolSelectionEvaluationBatchTracePayload, buildAssistantWorkflowToolSelectionAuthorityAllowListProposal, buildAssistantWorkflowToolSelectionAuthorityAllowListProposalTracePayload, buildAssistantWorkflowToolSelectionMigrationReport, buildAssistantWorkflowToolSelectionMigrationReportTracePayload, buildAssistantWorkflowToolSelectionMigrationReviewArtifact, buildAssistantWorkflowToolSelectionMigrationReviewArtifactTracePayload, } from "./tool-selection-evaluation.js";
+export function runAssistantWorkflowToolSelectionReplayLines(input, options = {}) {
+    const decisionParse = parseAssistantWorkflowSerializedToolSelectionDecisionLines(input.decisionLines);
+    const batch = buildAssistantWorkflowSerializedToolSelectionDecisionBatch(decisionParse.decisions, options);
+    const evaluation = buildAssistantWorkflowToolSelectionEvaluationBatch(batch.decisions, options);
+    const migration = buildAssistantWorkflowToolSelectionMigrationReport(evaluation, {
+        ...(options.minMigrationDecisionCount !== undefined
+            ? { minDecisionCount: options.minMigrationDecisionCount }
+            : {}),
+    });
+    const migrationProposal = buildAssistantWorkflowToolSelectionAuthorityAllowListProposal(migration, {
+        ...(options.currentAuthorityIntentIds !== undefined
+            ? { currentAuthorityIntentIds: options.currentAuthorityIntentIds }
+            : {}),
+        ...(options.currentAuthoritySegmentKeys !== undefined
+            ? { currentAuthoritySegmentKeys: options.currentAuthoritySegmentKeys }
+            : {}),
+    });
+    const migrationReviewArtifact = buildAssistantWorkflowToolSelectionMigrationReviewArtifact({
+        report: migration,
+        proposal: migrationProposal,
+    }, {
+        ...(options.migrationReviewTitle !== undefined ? { title: options.migrationReviewTitle } : {}),
+        ...(options.migrationReviewPatchTargets !== undefined
+            ? { patchTargets: options.migrationReviewPatchTargets }
+            : {}),
+        ...(options.migrationReviewRequiredTestIds !== undefined
+            ? { requiredTestIds: options.migrationReviewRequiredTestIds }
+            : {}),
+    });
+    return {
+        decisionParse,
+        parseErrorCount: decisionParse.errorCount,
+        batch,
+        evaluation,
+        migration,
+        migrationProposal,
+        migrationReviewArtifact,
+    };
+}
+export function buildAssistantWorkflowToolSelectionReplayLinesTracePayload(result) {
+    return {
+        decisionParse: {
+            lineCount: result.decisionParse.lineCount,
+            decisionCount: result.decisionParse.decisionCount,
+            errorCount: result.decisionParse.errorCount,
+            errors: result.decisionParse.errors.map((error) => ({
+                lineNumber: error.lineNumber,
+                reason: error.reason,
+                preview: error.preview,
+            })),
+        },
+        parseErrorCount: result.parseErrorCount,
+        batch: {
+            generatedAt: result.batch.generatedAt,
+            sourceDecisionCount: result.batch.sourceDecisionCount,
+            decisionCount: result.batch.decisionCount,
+            summary: {
+                generatedAt: result.batch.summary.generatedAt,
+                sourceDecisionCount: result.batch.summary.sourceDecisionCount,
+                decisionCount: result.batch.summary.decisionCount,
+                interestingDecisionCount: result.batch.summary.interestingDecisionCount,
+                workflowAuthorityCount: result.batch.summary.workflowAuthorityCount,
+                legacyAuthorityCount: result.batch.summary.legacyAuthorityCount,
+                authoritySourceCounts: serializeCounts(result.batch.summary.authoritySourceCounts),
+                authorityReasonCounts: serializeCounts(result.batch.summary.authorityReasonCounts),
+                workflowStatusCounts: serializeCounts(result.batch.summary.workflowStatusCounts),
+                effectiveReasonCounts: serializeCounts(result.batch.summary.effectiveReasonCounts),
+                optionalToolModeCounts: serializeCounts(result.batch.summary.optionalToolModeCounts),
+                effectiveToolCounts: serializeCounts(result.batch.summary.effectiveToolCounts),
+                workflowSuggestedToolCounts: serializeCounts(result.batch.summary.workflowSuggestedToolCounts),
+                workflowSelectionCandidateToolCounts: serializeCounts(result.batch.summary.workflowSelectionCandidateToolCounts),
+            },
+        },
+        evaluation: buildAssistantWorkflowToolSelectionEvaluationBatchTracePayload(result.evaluation),
+        migration: buildAssistantWorkflowToolSelectionMigrationReportTracePayload(result.migration),
+        migrationProposal: buildAssistantWorkflowToolSelectionAuthorityAllowListProposalTracePayload(result.migrationProposal),
+        migrationReviewArtifact: buildAssistantWorkflowToolSelectionMigrationReviewArtifactTracePayload(result.migrationReviewArtifact),
+    };
+}
+function serializeCounts(counts) {
+    return counts.map((count) => ({
+        key: count.key,
+        count: count.count,
+    }));
+}
+//# sourceMappingURL=tool-selection-replay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-selection-replay.js","sourceRoot":"","sources":["../src/tool-selection-replay.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  buildAssistantWorkflowSerializedToolSelectionDecisionBatch,\n  parseAssistantWorkflowSerializedToolSelectionDecisionLines,\n  type AssistantWorkflowSerializedToolSelectionDecisionBatch,\n  type AssistantWorkflowSerializedToolSelectionDecisionBatchCount,\n  type AssistantWorkflowSerializedToolSelectionDecisionBatchOptions,\n  type AssistantWorkflowSerializedToolSelectionDecisionLinesParseResult,\n} from \"./tool-selection-json.js\";\nimport type { AssistantWorkflowJsonValue } from \"./run-report-json.js\";\nimport {\n  buildAssistantWorkflowToolSelectionEvaluationBatch,\n  buildAssistantWorkflowToolSelectionEvaluationBatchTracePayload,\n  buildAssistantWorkflowToolSelectionAuthorityAllowListProposal,\n  buildAssistantWorkflowToolSelectionAuthorityAllowListProposalTracePayload,\n  buildAssistantWorkflowToolSelectionMigrationReport,\n  buildAssistantWorkflowToolSelectionMigrationReportTracePayload,\n  buildAssistantWorkflowToolSelectionMigrationReviewArtifact,\n  buildAssistantWorkflowToolSelectionMigrationReviewArtifactTracePayload,\n  type AssistantWorkflowToolSelectionAuthorityAllowListProposal,\n  type AssistantWorkflowToolSelectionEvaluationBatch,\n  type AssistantWorkflowToolSelectionMigrationReport,\n  type AssistantWorkflowToolSelectionMigrationReviewArtifact,\n} from \"./tool-selection-evaluation.js\";\n\nexport type AssistantWorkflowToolSelectionReplayLinesOptions =\n  AssistantWorkflowSerializedToolSelectionDecisionBatchOptions & {\n    minMigrationDecisionCount?: number | null;\n    currentAuthorityIntentIds?: readonly string[] | null;\n    currentAuthoritySegmentKeys?: readonly string[] | null;\n    migrationReviewPatchTargets?: readonly string[] | null;\n    migrationReviewRequiredTestIds?: readonly string[] | null;\n    migrationReviewTitle?: string | null;\n  };\n\nexport type AssistantWorkflowToolSelectionReplayLinesInput = {\n  decisionLines: string;\n};\n\nexport type AssistantWorkflowToolSelectionReplayLinesResult = {\n  decisionParse: AssistantWorkflowSerializedToolSelectionDecisionLinesParseResult;\n  parseErrorCount: number;\n  batch: AssistantWorkflowSerializedToolSelectionDecisionBatch;\n  evaluation: AssistantWorkflowToolSelectionEvaluationBatch;\n  migration: AssistantWorkflowToolSelectionMigrationReport;\n  migrationProposal: AssistantWorkflowToolSelectionAuthorityAllowListProposal;\n  migrationReviewArtifact: AssistantWorkflowToolSelectionMigrationReviewArtifact;\n};\n\nexport function runAssistantWorkflowToolSelectionReplayLines(\n  input: AssistantWorkflowToolSelectionReplayLinesInput,\n  options: AssistantWorkflowToolSelectionReplayLinesOptions = {},\n): AssistantWorkflowToolSelectionReplayLinesResult {\n  const decisionParse = parseAssistantWorkflowSerializedToolSelectionDecisionLines(input.decisionLines);\n  const batch = buildAssistantWorkflowSerializedToolSelectionDecisionBatch(\n    decisionParse.decisions,\n    options,\n  );\n  const evaluation = buildAssistantWorkflowToolSelectionEvaluationBatch(\n    batch.decisions,\n    options,\n  );\n  const migration = buildAssistantWorkflowToolSelectionMigrationReport(evaluation, {\n    ...(options.minMigrationDecisionCount !== undefined\n      ? { minDecisionCount: options.minMigrationDecisionCount }\n      : {}),\n  });\n  const migrationProposal = buildAssistantWorkflowToolSelectionAuthorityAllowListProposal(migration, {\n    ...(options.currentAuthorityIntentIds !== undefined\n      ? { currentAuthorityIntentIds: options.currentAuthorityIntentIds }\n      : {}),\n    ...(options.currentAuthoritySegmentKeys !== undefined\n      ? { currentAuthoritySegmentKeys: options.currentAuthoritySegmentKeys }\n      : {}),\n  });\n  const migrationReviewArtifact = buildAssistantWorkflowToolSelectionMigrationReviewArtifact({\n    report: migration,\n    proposal: migrationProposal,\n  }, {\n    ...(options.migrationReviewTitle !== undefined ? { title: options.migrationReviewTitle } : {}),\n    ...(options.migrationReviewPatchTargets !== undefined\n      ? { patchTargets: options.migrationReviewPatchTargets }\n      : {}),\n    ...(options.migrationReviewRequiredTestIds !== undefined\n      ? { requiredTestIds: options.migrationReviewRequiredTestIds }\n      : {}),\n  });\n\n  return {\n    decisionParse,\n    parseErrorCount: decisionParse.errorCount,\n    batch,\n    evaluation,\n    migration,\n    migrationProposal,\n    migrationReviewArtifact,\n  };\n}\n\nexport function buildAssistantWorkflowToolSelectionReplayLinesTracePayload(\n  result: AssistantWorkflowToolSelectionReplayLinesResult,\n): Record<string, AssistantWorkflowJsonValue> {\n  return {\n    decisionParse: {\n      lineCount: result.decisionParse.lineCount,\n      decisionCount: result.decisionParse.decisionCount,\n      errorCount: result.decisionParse.errorCount,\n      errors: result.decisionParse.errors.map((error) => ({\n        lineNumber: error.lineNumber,\n        reason: error.reason,\n        preview: error.preview,\n      })),\n    },\n    parseErrorCount: result.parseErrorCount,\n    batch: {\n      generatedAt: result.batch.generatedAt,\n      sourceDecisionCount: result.batch.sourceDecisionCount,\n      decisionCount: result.batch.decisionCount,\n      summary: {\n        generatedAt: result.batch.summary.generatedAt,\n        sourceDecisionCount: result.batch.summary.sourceDecisionCount,\n        decisionCount: result.batch.summary.decisionCount,\n        interestingDecisionCount: result.batch.summary.interestingDecisionCount,\n        workflowAuthorityCount: result.batch.summary.workflowAuthorityCount,\n        legacyAuthorityCount: result.batch.summary.legacyAuthorityCount,\n        authoritySourceCounts: serializeCounts(result.batch.summary.authoritySourceCounts),\n        authorityReasonCounts: serializeCounts(result.batch.summary.authorityReasonCounts),\n        workflowStatusCounts: serializeCounts(result.batch.summary.workflowStatusCounts),\n        effectiveReasonCounts: serializeCounts(result.batch.summary.effectiveReasonCounts),\n        optionalToolModeCounts: serializeCounts(result.batch.summary.optionalToolModeCounts),\n        effectiveToolCounts: serializeCounts(result.batch.summary.effectiveToolCounts),\n        workflowSuggestedToolCounts: serializeCounts(result.batch.summary.workflowSuggestedToolCounts),\n        workflowSelectionCandidateToolCounts: serializeCounts(\n          result.batch.summary.workflowSelectionCandidateToolCounts,\n        ),\n      },\n    },\n    evaluation: buildAssistantWorkflowToolSelectionEvaluationBatchTracePayload(result.evaluation),\n    migration: buildAssistantWorkflowToolSelectionMigrationReportTracePayload(result.migration),\n    migrationProposal: buildAssistantWorkflowToolSelectionAuthorityAllowListProposalTracePayload(\n      result.migrationProposal,\n    ),\n    migrationReviewArtifact: buildAssistantWorkflowToolSelectionMigrationReviewArtifactTracePayload(\n      result.migrationReviewArtifact,\n    ),\n  };\n}\n\nfunction serializeCounts(\n  counts: readonly AssistantWorkflowSerializedToolSelectionDecisionBatchCount[],\n): Record<string, AssistantWorkflowJsonValue>[] {\n  return counts.map((count) => ({\n    key: count.key,\n    count: count.count,\n  }));\n}\n"]}

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

@@ -0,0 +1,46 @@
+export type AssistantWorkflowToolSelectionSignalState<TSignal extends string = string> = Partial<Record<TSignal, boolean>>;
+export type AssistantWorkflowToolSelectionRuleCondition<TSignal extends string = string> = {
+    allSignals?: readonly TSignal[];
+    anySignals?: readonly TSignal[];
+    notSignals?: readonly TSignal[];
+    minHop?: number;
+    maxHop?: number;
+    enabled?: boolean;
+};
+export type AssistantWorkflowToolSelectionRule<TSignal extends string = string> = {
+    id: string;
+    toolNames: readonly string[];
+    condition?: AssistantWorkflowToolSelectionRuleCondition<TSignal>;
+    terminal?: boolean;
+    terminalReason?: string;
+};
+export type AssistantWorkflowRuleBasedToolSelectionReasons = {
+    noTools?: string;
+    disabled?: string;
+    emptySelection?: string;
+    selected?: string;
+};
+export type AssistantWorkflowRuleBasedToolSelectionInput<TTool, TSignal extends string = string> = {
+    allTools: readonly TTool[];
+    pruningEnabled: boolean;
+    hop?: number | null;
+    signals?: AssistantWorkflowToolSelectionSignalState<TSignal> | null;
+    classifierSuggestedToolNames?: readonly string[] | null;
+    rules?: readonly AssistantWorkflowToolSelectionRule<TSignal>[] | null;
+    fallbackToolNames?: readonly string[] | null;
+    postFallbackRules?: readonly AssistantWorkflowToolSelectionRule<TSignal>[] | null;
+    getToolName?: (tool: TTool) => string | null | undefined;
+    estimateToolCost?: (tool: TTool) => number;
+    reasons?: AssistantWorkflowRuleBasedToolSelectionReasons;
+};
+export type AssistantWorkflowRuleBasedToolSelectionResult<TTool> = {
+    tools: TTool[];
+    mode: "full" | "pruned";
+    reason: string;
+    approxSchemaChars: number;
+    toolNames: string[];
+    appliedRuleIds: string[];
+};
+export declare function estimateAssistantWorkflowToolSchemaChars<TTool>(tools: readonly TTool[], estimateToolCost?: (tool: TTool) => number): number;
+export declare function selectAssistantWorkflowToolsByRules<TTool, TSignal extends string = string>(input: AssistantWorkflowRuleBasedToolSelectionInput<TTool, TSignal>): AssistantWorkflowRuleBasedToolSelectionResult<TTool>;
+//# sourceMappingURL=tool-selection-rules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-selection-rules.d.ts","sourceRoot":"","sources":["../src/tool-selection-rules.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yCAAyC,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,IACnF,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEpC,MAAM,MAAM,2CAA2C,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI;IACzF,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kCAAkC,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI;IAChF,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,2CAA2C,CAAC,OAAO,CAAC,CAAC;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,8CAA8C,GAAG;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,4CAA4C,CAAC,KAAK,EAAE,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI;IACjG,QAAQ,EAAE,SAAS,KAAK,EAAE,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,yCAAyC,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACpE,4BAA4B,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,EAAE,SAAS,kCAAkC,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC;IACtE,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC7C,iBAAiB,CAAC,EAAE,SAAS,kCAAkC,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC;IAClF,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzD,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC;IAC3C,OAAO,CAAC,EAAE,8CAA8C,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,6CAA6C,CAAC,KAAK,IAAI;IACjE,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,wBAAgB,wCAAwC,CAAC,KAAK,EAC5D,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,gBAAgB,GAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAgC,GAClE,MAAM,CAIR;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,OAAO,SAAS,MAAM,GAAG,MAAM,EACxF,KAAK,EAAE,4CAA4C,CAAC,KAAK,EAAE,OAAO,CAAC,GAClE,6CAA6C,CAAC,KAAK,CAAC,CAyFtD"}

package/dist/tool-selection-rules.js

@@ -0,0 +1,183 @@
+export function estimateAssistantWorkflowToolSchemaChars(tools, estimateToolCost = estimateDefaultToolCost) {
+    let total = 0;
+    for (const tool of tools)
+        total += estimateToolCost(tool);
+    return total;
+}
+export function selectAssistantWorkflowToolsByRules(input) {
+    const reasons = {
+        noTools: input.reasons?.noTools ?? "no_tools",
+        disabled: input.reasons?.disabled ?? "disabled",
+        emptySelection: input.reasons?.emptySelection ?? "empty_selection",
+        selected: input.reasons?.selected ?? "intent_pruned",
+    };
+    const getToolName = input.getToolName ?? defaultGetToolName;
+    const estimateToolCost = input.estimateToolCost ?? estimateDefaultToolCost;
+    const allTools = [...input.allTools];
+    if (!allTools.length) {
+        return {
+            tools: [],
+            mode: "full",
+            reason: reasons.noTools,
+            approxSchemaChars: 0,
+            toolNames: [],
+            appliedRuleIds: [],
+        };
+    }
+    if (!input.pruningEnabled) {
+        return {
+            tools: allTools,
+            mode: "full",
+            reason: reasons.disabled,
+            approxSchemaChars: estimateAssistantWorkflowToolSchemaChars(allTools, estimateToolCost),
+            toolNames: allTools.map((tool) => normalizeToolName(getToolName(tool)) || "unknown"),
+            appliedRuleIds: [],
+        };
+    }
+    const selectedNames = new Set();
+    const appliedRuleIds = [];
+    addToolNames(selectedNames, input.classifierSuggestedToolNames ?? []);
+    if ((input.classifierSuggestedToolNames ?? []).length > 0) {
+        appliedRuleIds.push("classifier_suggested");
+    }
+    const terminal = applyRules({
+        selectedNames,
+        appliedRuleIds,
+        rules: input.rules ?? [],
+        signals: input.signals ?? {},
+        hop: input.hop ?? null,
+        allTools,
+        getToolName,
+        estimateToolCost,
+    });
+    if (terminal)
+        return terminal;
+    if (selectedNames.size === 0 && (input.fallbackToolNames ?? []).length > 0) {
+        addToolNames(selectedNames, input.fallbackToolNames ?? []);
+        appliedRuleIds.push("fallback");
+    }
+    const postFallbackTerminal = applyRules({
+        selectedNames,
+        appliedRuleIds,
+        rules: input.postFallbackRules ?? [],
+        signals: input.signals ?? {},
+        hop: input.hop ?? null,
+        allTools,
+        getToolName,
+        estimateToolCost,
+    });
+    if (postFallbackTerminal)
+        return postFallbackTerminal;
+    const selected = filterSelectedTools(allTools, selectedNames, getToolName);
+    if (!selected.tools.length) {
+        return {
+            tools: allTools,
+            mode: "full",
+            reason: reasons.emptySelection,
+            approxSchemaChars: estimateAssistantWorkflowToolSchemaChars(allTools, estimateToolCost),
+            toolNames: allTools.map((tool) => normalizeToolName(getToolName(tool)) || "unknown"),
+            appliedRuleIds,
+        };
+    }
+    return {
+        tools: selected.tools,
+        mode: "pruned",
+        reason: reasons.selected,
+        approxSchemaChars: estimateAssistantWorkflowToolSchemaChars(selected.tools, estimateToolCost),
+        toolNames: selected.toolNames,
+        appliedRuleIds,
+    };
+}
+function applyRules(input) {
+    for (const rule of input.rules) {
+        if (!ruleMatches(rule.condition, input.signals, input.hop))
+            continue;
+        addToolNames(input.selectedNames, rule.toolNames);
+        input.appliedRuleIds.push(rule.id);
+        if (rule.terminal) {
+            const selected = filterSelectedTools(input.allTools, input.selectedNames, input.getToolName);
+            if (!selected.tools.length)
+                continue;
+            return {
+                tools: selected.tools,
+                mode: "pruned",
+                reason: rule.terminalReason ?? rule.id,
+                approxSchemaChars: estimateAssistantWorkflowToolSchemaChars(selected.tools, input.estimateToolCost),
+                toolNames: selected.toolNames,
+                appliedRuleIds: [...input.appliedRuleIds],
+            };
+        }
+    }
+    return null;
+}
+function ruleMatches(condition, signals, hop) {
+    if (!condition)
+        return true;
+    if (condition.enabled === false)
+        return false;
+    if (condition.minHop !== undefined && (hop === null || hop < condition.minHop))
+        return false;
+    if (condition.maxHop !== undefined && (hop === null || hop > condition.maxHop))
+        return false;
+    if ((condition.allSignals ?? []).some((signal) => signals[signal] !== true))
+        return false;
+    if ((condition.anySignals ?? []).length > 0 && !(condition.anySignals ?? []).some((signal) => signals[signal] === true)) {
+        return false;
+    }
+    if ((condition.notSignals ?? []).some((signal) => signals[signal] === true))
+        return false;
+    return true;
+}
+function filterSelectedTools(tools, selectedNames, getToolName) {
+    const selectedTools = [];
+    const toolNames = [];
+    for (const tool of tools) {
+        const name = normalizeToolName(getToolName(tool));
+        if (!name || !selectedNames.has(name))
+            continue;
+        selectedTools.push(tool);
+        toolNames.push(name);
+    }
+    return { tools: selectedTools, toolNames };
+}
+function addToolNames(target, toolNames) {
+    for (const toolName of toolNames) {
+        const normalized = normalizeToolName(toolName);
+        if (normalized)
+            target.add(normalized);
+    }
+}
+function defaultGetToolName(tool) {
+    if (!isRecord(tool))
+        return null;
+    const functionDefinition = tool["function"];
+    if (isRecord(functionDefinition) && typeof functionDefinition["name"] === "string") {
+        return functionDefinition["name"];
+    }
+    if (typeof tool["name"] === "string")
+        return tool["name"];
+    return null;
+}
+function estimateDefaultToolCost(tool) {
+    if (!isRecord(tool))
+        return 0;
+    const functionDefinition = tool["function"];
+    if (isRecord(functionDefinition)) {
+        const name = typeof functionDefinition["name"] === "string" ? functionDefinition["name"] : "";
+        const description = typeof functionDefinition["description"] === "string" ? functionDefinition["description"] : "";
+        const parameters = functionDefinition["parameters"] ?? {};
+        return name.length + description.length + JSON.stringify(parameters).length;
+    }
+    const name = typeof tool["name"] === "string" ? tool["name"] : "";
+    return name.length + JSON.stringify(tool).length;
+}
+function normalizeToolName(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length ? trimmed : null;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=tool-selection-rules.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-selection-rules.js","sourceRoot":"","sources":["../src/tool-selection-rules.ts"],"names":[],"mappings":"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","sourcesContent":["export type AssistantWorkflowToolSelectionSignalState<TSignal extends string = string> =\n  Partial<Record<TSignal, boolean>>;\n\nexport type AssistantWorkflowToolSelectionRuleCondition<TSignal extends string = string> = {\n  allSignals?: readonly TSignal[];\n  anySignals?: readonly TSignal[];\n  notSignals?: readonly TSignal[];\n  minHop?: number;\n  maxHop?: number;\n  enabled?: boolean;\n};\n\nexport type AssistantWorkflowToolSelectionRule<TSignal extends string = string> = {\n  id: string;\n  toolNames: readonly string[];\n  condition?: AssistantWorkflowToolSelectionRuleCondition<TSignal>;\n  terminal?: boolean;\n  terminalReason?: string;\n};\n\nexport type AssistantWorkflowRuleBasedToolSelectionReasons = {\n  noTools?: string;\n  disabled?: string;\n  emptySelection?: string;\n  selected?: string;\n};\n\nexport type AssistantWorkflowRuleBasedToolSelectionInput<TTool, TSignal extends string = string> = {\n  allTools: readonly TTool[];\n  pruningEnabled: boolean;\n  hop?: number | null;\n  signals?: AssistantWorkflowToolSelectionSignalState<TSignal> | null;\n  classifierSuggestedToolNames?: readonly string[] | null;\n  rules?: readonly AssistantWorkflowToolSelectionRule<TSignal>[] | null;\n  fallbackToolNames?: readonly string[] | null;\n  postFallbackRules?: readonly AssistantWorkflowToolSelectionRule<TSignal>[] | null;\n  getToolName?: (tool: TTool) => string | null | undefined;\n  estimateToolCost?: (tool: TTool) => number;\n  reasons?: AssistantWorkflowRuleBasedToolSelectionReasons;\n};\n\nexport type AssistantWorkflowRuleBasedToolSelectionResult<TTool> = {\n  tools: TTool[];\n  mode: \"full\" | \"pruned\";\n  reason: string;\n  approxSchemaChars: number;\n  toolNames: string[];\n  appliedRuleIds: string[];\n};\n\nexport function estimateAssistantWorkflowToolSchemaChars<TTool>(\n  tools: readonly TTool[],\n  estimateToolCost: (tool: TTool) => number = estimateDefaultToolCost,\n): number {\n  let total = 0;\n  for (const tool of tools) total += estimateToolCost(tool);\n  return total;\n}\n\nexport function selectAssistantWorkflowToolsByRules<TTool, TSignal extends string = string>(\n  input: AssistantWorkflowRuleBasedToolSelectionInput<TTool, TSignal>,\n): AssistantWorkflowRuleBasedToolSelectionResult<TTool> {\n  const reasons = {\n    noTools: input.reasons?.noTools ?? \"no_tools\",\n    disabled: input.reasons?.disabled ?? \"disabled\",\n    emptySelection: input.reasons?.emptySelection ?? \"empty_selection\",\n    selected: input.reasons?.selected ?? \"intent_pruned\",\n  };\n  const getToolName = input.getToolName ?? defaultGetToolName;\n  const estimateToolCost = input.estimateToolCost ?? estimateDefaultToolCost;\n  const allTools = [...input.allTools];\n\n  if (!allTools.length) {\n    return {\n      tools: [],\n      mode: \"full\",\n      reason: reasons.noTools,\n      approxSchemaChars: 0,\n      toolNames: [],\n      appliedRuleIds: [],\n    };\n  }\n\n  if (!input.pruningEnabled) {\n    return {\n      tools: allTools,\n      mode: \"full\",\n      reason: reasons.disabled,\n      approxSchemaChars: estimateAssistantWorkflowToolSchemaChars(allTools, estimateToolCost),\n      toolNames: allTools.map((tool) => normalizeToolName(getToolName(tool)) || \"unknown\"),\n      appliedRuleIds: [],\n    };\n  }\n\n  const selectedNames = new Set<string>();\n  const appliedRuleIds: string[] = [];\n  addToolNames(selectedNames, input.classifierSuggestedToolNames ?? []);\n  if ((input.classifierSuggestedToolNames ?? []).length > 0) {\n    appliedRuleIds.push(\"classifier_suggested\");\n  }\n\n  const terminal = applyRules({\n    selectedNames,\n    appliedRuleIds,\n    rules: input.rules ?? [],\n    signals: input.signals ?? {},\n    hop: input.hop ?? null,\n    allTools,\n    getToolName,\n    estimateToolCost,\n  });\n  if (terminal) return terminal;\n\n  if (selectedNames.size === 0 && (input.fallbackToolNames ?? []).length > 0) {\n    addToolNames(selectedNames, input.fallbackToolNames ?? []);\n    appliedRuleIds.push(\"fallback\");\n  }\n\n  const postFallbackTerminal = applyRules({\n    selectedNames,\n    appliedRuleIds,\n    rules: input.postFallbackRules ?? [],\n    signals: input.signals ?? {},\n    hop: input.hop ?? null,\n    allTools,\n    getToolName,\n    estimateToolCost,\n  });\n  if (postFallbackTerminal) return postFallbackTerminal;\n\n  const selected = filterSelectedTools(allTools, selectedNames, getToolName);\n  if (!selected.tools.length) {\n    return {\n      tools: allTools,\n      mode: \"full\",\n      reason: reasons.emptySelection,\n      approxSchemaChars: estimateAssistantWorkflowToolSchemaChars(allTools, estimateToolCost),\n      toolNames: allTools.map((tool) => normalizeToolName(getToolName(tool)) || \"unknown\"),\n      appliedRuleIds,\n    };\n  }\n\n  return {\n    tools: selected.tools,\n    mode: \"pruned\",\n    reason: reasons.selected,\n    approxSchemaChars: estimateAssistantWorkflowToolSchemaChars(selected.tools, estimateToolCost),\n    toolNames: selected.toolNames,\n    appliedRuleIds,\n  };\n}\n\nfunction applyRules<TTool, TSignal extends string>(input: {\n  selectedNames: Set<string>;\n  appliedRuleIds: string[];\n  rules: readonly AssistantWorkflowToolSelectionRule<TSignal>[];\n  signals: AssistantWorkflowToolSelectionSignalState<TSignal>;\n  hop: number | null;\n  allTools: readonly TTool[];\n  getToolName: (tool: TTool) => string | null | undefined;\n  estimateToolCost: (tool: TTool) => number;\n}): AssistantWorkflowRuleBasedToolSelectionResult<TTool> | null {\n  for (const rule of input.rules) {\n    if (!ruleMatches(rule.condition, input.signals, input.hop)) continue;\n    addToolNames(input.selectedNames, rule.toolNames);\n    input.appliedRuleIds.push(rule.id);\n    if (rule.terminal) {\n      const selected = filterSelectedTools(input.allTools, input.selectedNames, input.getToolName);\n      if (!selected.tools.length) continue;\n      return {\n        tools: selected.tools,\n        mode: \"pruned\",\n        reason: rule.terminalReason ?? rule.id,\n        approxSchemaChars: estimateAssistantWorkflowToolSchemaChars(selected.tools, input.estimateToolCost),\n        toolNames: selected.toolNames,\n        appliedRuleIds: [...input.appliedRuleIds],\n      };\n    }\n  }\n  return null;\n}\n\nfunction ruleMatches<TSignal extends string>(\n  condition: AssistantWorkflowToolSelectionRuleCondition<TSignal> | undefined,\n  signals: AssistantWorkflowToolSelectionSignalState<TSignal>,\n  hop: number | null,\n): boolean {\n  if (!condition) return true;\n  if (condition.enabled === false) return false;\n  if (condition.minHop !== undefined && (hop === null || hop < condition.minHop)) return false;\n  if (condition.maxHop !== undefined && (hop === null || hop > condition.maxHop)) return false;\n  if ((condition.allSignals ?? []).some((signal) => signals[signal] !== true)) return false;\n  if ((condition.anySignals ?? []).length > 0 && !(condition.anySignals ?? []).some((signal) => signals[signal] === true)) {\n    return false;\n  }\n  if ((condition.notSignals ?? []).some((signal) => signals[signal] === true)) return false;\n  return true;\n}\n\nfunction filterSelectedTools<TTool>(\n  tools: readonly TTool[],\n  selectedNames: ReadonlySet<string>,\n  getToolName: (tool: TTool) => string | null | undefined,\n): { tools: TTool[]; toolNames: string[] } {\n  const selectedTools: TTool[] = [];\n  const toolNames: string[] = [];\n  for (const tool of tools) {\n    const name = normalizeToolName(getToolName(tool));\n    if (!name || !selectedNames.has(name)) continue;\n    selectedTools.push(tool);\n    toolNames.push(name);\n  }\n  return { tools: selectedTools, toolNames };\n}\n\nfunction addToolNames(target: Set<string>, toolNames: readonly string[]): void {\n  for (const toolName of toolNames) {\n    const normalized = normalizeToolName(toolName);\n    if (normalized) target.add(normalized);\n  }\n}\n\nfunction defaultGetToolName<TTool>(tool: TTool): string | null {\n  if (!isRecord(tool)) return null;\n  const functionDefinition = tool[\"function\"];\n  if (isRecord(functionDefinition) && typeof functionDefinition[\"name\"] === \"string\") {\n    return functionDefinition[\"name\"];\n  }\n  if (typeof tool[\"name\"] === \"string\") return tool[\"name\"];\n  return null;\n}\n\nfunction estimateDefaultToolCost<TTool>(tool: TTool): number {\n  if (!isRecord(tool)) return 0;\n  const functionDefinition = tool[\"function\"];\n  if (isRecord(functionDefinition)) {\n    const name = typeof functionDefinition[\"name\"] === \"string\" ? functionDefinition[\"name\"] : \"\";\n    const description = typeof functionDefinition[\"description\"] === \"string\" ? functionDefinition[\"description\"] : \"\";\n    const parameters = functionDefinition[\"parameters\"] ?? {};\n    return name.length + description.length + JSON.stringify(parameters).length;\n  }\n  const name = typeof tool[\"name\"] === \"string\" ? tool[\"name\"] : \"\";\n  return name.length + JSON.stringify(tool).length;\n}\n\nfunction normalizeToolName(value: string | null | undefined): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  return trimmed.length ? trimmed : null;\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-trace-export.d.ts

@@ -0,0 +1,37 @@
+import type { AssistantWorkflowJsonValue } from "./run-report-json.js";
+import { type AssistantWorkflowTraceEvent } from "./trace-events.js";
+import type { AssistantWorkflowDefinition, AssistantWorkflowToolContextRequirement } from "./definition.js";
+import { type AssistantWorkflowEvalCase, type AssistantWorkflowToolSelectionEvalCaseOptions } from "./eval-case.js";
+import { type AssistantWorkflowSerializedToolSelectionDecision } from "./tool-selection-json.js";
+export type AssistantWorkflowToolSelectionTraceExportResult = {
+    traceEventCount: number;
+    candidateEventCount: number;
+    decisionCount: number;
+    skippedCandidateEventCount: number;
+    decisions: AssistantWorkflowSerializedToolSelectionDecision[];
+};
+export type AssistantWorkflowToolSelectionTraceEvalCaseOptions = Omit<AssistantWorkflowToolSelectionEvalCaseOptions, "prompt"> & {
+    prompt?: string | null;
+};
+export type AssistantWorkflowToolSelectionTraceEvalCaseExportResult = AssistantWorkflowToolSelectionTraceExportResult & {
+    prompt: string | null;
+    evalCaseCount: number;
+    missingPromptCount: number;
+    cases: AssistantWorkflowEvalCase[];
+};
+export type AssistantWorkflowToolSelectionTraceCurrentReplayOptions = {
+    workflow: AssistantWorkflowDefinition<string, string, string, string>;
+    availableToolNames?: readonly string[] | null;
+    availableContext?: readonly AssistantWorkflowToolContextRequirement[] | null;
+    workflowAuthorityIntentIds?: readonly string[] | null;
+    workflowAuthoritySegmentKeys?: readonly string[] | null;
+    includeWorkflowToolCapabilities?: boolean;
+};
+export declare function buildAssistantWorkflowSerializedToolSelectionDecisionFromTraceEvent(event: AssistantWorkflowTraceEvent): AssistantWorkflowSerializedToolSelectionDecision | null;
+export declare function buildAssistantWorkflowSerializedToolSelectionDecisionsFromTraceEvents(events: readonly AssistantWorkflowTraceEvent[]): AssistantWorkflowToolSelectionTraceExportResult;
+export declare function buildAssistantWorkflowCurrentSerializedToolSelectionDecisionsFromTraceEvents(events: readonly AssistantWorkflowTraceEvent[], options: AssistantWorkflowToolSelectionTraceCurrentReplayOptions): AssistantWorkflowToolSelectionTraceExportResult;
+export declare function buildAssistantWorkflowCurrentSerializedToolSelectionDecisionFromTraceEvent(event: AssistantWorkflowTraceEvent, classifierPayload: Record<string, unknown> | null, options: AssistantWorkflowToolSelectionTraceCurrentReplayOptions): AssistantWorkflowSerializedToolSelectionDecision | null;
+export declare function buildAssistantWorkflowToolSelectionEvalCasesFromTraceEvents(events: readonly AssistantWorkflowTraceEvent[], options?: AssistantWorkflowToolSelectionTraceEvalCaseOptions): AssistantWorkflowToolSelectionTraceEvalCaseExportResult;
+export declare function buildAssistantWorkflowToolSelectionTraceExportPayload(result: AssistantWorkflowToolSelectionTraceExportResult): Record<string, AssistantWorkflowJsonValue>;
+export declare function buildAssistantWorkflowToolSelectionTraceEvalCaseExportPayload(result: AssistantWorkflowToolSelectionTraceEvalCaseExportResult): Record<string, AssistantWorkflowJsonValue>;
+//# sourceMappingURL=tool-selection-trace-export.d.ts.map

package/dist/tool-selection-trace-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-selection-trace-export.d.ts","sourceRoot":"","sources":["../src/tool-selection-trace-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAOL,KAAK,2BAA2B,EACjC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EACV,2BAA2B,EAC3B,uCAAuC,EACxC,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,6CAA6C,EACnD,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGL,KAAK,gDAAgD,EACtD,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,+CAA+C,GAAG;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B,EAAE,MAAM,CAAC;IACnC,SAAS,EAAE,gDAAgD,EAAE,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,kDAAkD,GAC5D,IAAI,CAAC,6CAA6C,EAAE,QAAQ,CAAC,GAAG;IAC9D,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEJ,MAAM,MAAM,uDAAuD,GACjE,+CAA+C,GAAG;IAChD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACpC,CAAC;AAEJ,MAAM,MAAM,uDAAuD,GAAG;IACpE,QAAQ,EAAE,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtE,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9C,gBAAgB,CAAC,EAAE,SAAS,uCAAuC,EAAE,GAAG,IAAI,CAAC;IAC7E,0BAA0B,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACtD,4BAA4B,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACxD,+BAA+B,CAAC,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF,wBAAgB,mEAAmE,CACjF,KAAK,EAAE,2BAA2B,GACjC,gDAAgD,GAAG,IAAI,CAuCzD;AAED,wBAAgB,qEAAqE,CACnF,MAAM,EAAE,SAAS,2BAA2B,EAAE,GAC7C,+CAA+C,CAuBjD;AAED,wBAAgB,4EAA4E,CAC1F,MAAM,EAAE,SAAS,2BAA2B,EAAE,EAC9C,OAAO,EAAE,uDAAuD,GAC/D,+CAA+C,CAiCjD;AAED,wBAAgB,0EAA0E,CACxF,KAAK,EAAE,2BAA2B,EAClC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACjD,OAAO,EAAE,uDAAuD,GAC/D,gDAAgD,GAAG,IAAI,CAkDzD;AAED,wBAAgB,2DAA2D,CACzE,MAAM,EAAE,SAAS,2BAA2B,EAAE,EAC9C,OAAO,GAAE,kDAAuD,GAC/D,uDAAuD,CA2BzD;AAED,wBAAgB,qDAAqD,CACnE,MAAM,EAAE,+CAA+C,GACtD,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAO5C;AAED,wBAAgB,6DAA6D,CAC3E,MAAM,EAAE,uDAAuD,GAC9D,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAO5C"}