@uns-kit/assistant-workflow 2.0.72

package/dist/definition-tuning.d.ts

@@ -0,0 +1,73 @@
+import type { AssistantWorkflowDefinition } from "./definition.js";
+import { type AssistantWorkflowDefinitionDiff } from "./definition-diff.js";
+import type { AssistantWorkflowTraceReport, AssistantWorkflowTraceReportSuggestion } from "./trace-report.js";
+import type { AssistantWorkflowJsonValue } from "./run-report-json.js";
+export type AssistantWorkflowDefinitionTuningAction = "add_intent_tool_hint" | "add_direct_route_strategy" | "register_tool_capability" | "review_tool_selection_policy" | "review_clarification_rule" | "review_direct_route_strategy" | "debug_runtime_error" | "promote_eval_case" | "review_quality_signal" | "review_memory_patch_mapping";
+export type AssistantWorkflowDefinitionTuningPatchPreview = {
+    kind: "append_intent_tool_hint";
+    intentId: string;
+    toolName: string;
+} | {
+    kind: "register_tool_capability";
+    toolName: string;
+} | {
+    kind: "append_direct_route_strategy";
+    routeId: string;
+    strategyId: string;
+    description: string;
+} | {
+    kind: "none";
+};
+export type AssistantWorkflowDefinitionTuningSuggestion = {
+    id: string;
+    action: AssistantWorkflowDefinitionTuningAction;
+    severity: "info" | "warning";
+    intentId: string | null;
+    toolName: string | null;
+    signal: string | null;
+    count: number;
+    requestIds: string[];
+    sourceSuggestionIds: string[];
+    rationale: string;
+    suggestedAction: string;
+    patchPreview: AssistantWorkflowDefinitionTuningPatchPreview;
+};
+export type AssistantWorkflowDefinitionTuningReportOptions = {
+    minCount?: number;
+    includeLowConfidence?: boolean;
+    ignoredIntentIds?: readonly string[];
+};
+export type AssistantWorkflowDefinitionTuningReport = {
+    generatedAt: string;
+    workflowId: string;
+    workflowVersion: number;
+    sourceSuggestionCount: number;
+    suggestionCount: number;
+    applicableSuggestionCount: number;
+    skippedSuggestionCount: number;
+    suggestions: AssistantWorkflowDefinitionTuningSuggestion[];
+};
+export type AssistantWorkflowDefinitionTuningApplySkipReason = "not_selected" | "unsupported_patch" | "missing_intent" | "missing_direct_route" | "tool_hint_exists" | "direct_route_strategy_exists" | "intent_apply_limit";
+export type AssistantWorkflowDefinitionTuningApplySkippedSuggestion = {
+    id: string;
+    reason: AssistantWorkflowDefinitionTuningApplySkipReason;
+};
+export type AssistantWorkflowDefinitionTuningApplyOptions = {
+    suggestionIds?: readonly string[];
+    bumpVersion?: boolean;
+    maxToolHintsPerIntent?: number;
+};
+export type AssistantWorkflowDefinitionTuningApplyResult = {
+    changed: boolean;
+    appliedCount: number;
+    skippedCount: number;
+    appliedSuggestionIds: string[];
+    skippedSuggestions: AssistantWorkflowDefinitionTuningApplySkippedSuggestion[];
+    diff: AssistantWorkflowDefinitionDiff;
+    definition: AssistantWorkflowDefinition;
+};
+export declare function buildAssistantWorkflowDefinitionTuningReport(workflow: AssistantWorkflowDefinition, traceReport: AssistantWorkflowTraceReport, options?: AssistantWorkflowDefinitionTuningReportOptions): AssistantWorkflowDefinitionTuningReport;
+export declare function buildAssistantWorkflowDefinitionTuningReportFromSuggestions(workflow: AssistantWorkflowDefinition, traceSuggestions: readonly AssistantWorkflowTraceReportSuggestion[], options?: AssistantWorkflowDefinitionTuningReportOptions): AssistantWorkflowDefinitionTuningReport;
+export declare function applyAssistantWorkflowDefinitionTuningSuggestions(workflow: AssistantWorkflowDefinition, suggestions: readonly AssistantWorkflowDefinitionTuningSuggestion[], options?: AssistantWorkflowDefinitionTuningApplyOptions): AssistantWorkflowDefinitionTuningApplyResult;
+export declare function buildAssistantWorkflowDefinitionTuningApplyTracePayload(result: AssistantWorkflowDefinitionTuningApplyResult): Record<string, AssistantWorkflowJsonValue>;
+//# sourceMappingURL=definition-tuning.d.ts.map

package/dist/definition-tuning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-tuning.d.ts","sourceRoot":"","sources":["../src/definition-tuning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAI5B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,4BAA4B,EAC5B,sCAAsC,EACvC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,MAAM,uCAAuC,GAC/C,sBAAsB,GACtB,2BAA2B,GAC3B,0BAA0B,GAC1B,8BAA8B,GAC9B,2BAA2B,GAC3B,8BAA8B,GAC9B,qBAAqB,GACrB,mBAAmB,GACnB,uBAAuB,GACvB,6BAA6B,CAAC;AAElC,MAAM,MAAM,6CAA6C,GACrD;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,MAAM,MAAM,2CAA2C,GAAG;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,uCAAuC,CAAC;IAChD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,6CAA6C,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,8CAA8C,GAAG;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,uCAAuC,GAAG;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB,EAAE,MAAM,CAAC;IAClC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,2CAA2C,EAAE,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,gDAAgD,GACxD,cAAc,GACd,mBAAmB,GACnB,gBAAgB,GAChB,sBAAsB,GACtB,kBAAkB,GAClB,8BAA8B,GAC9B,oBAAoB,CAAC;AAEzB,MAAM,MAAM,uDAAuD,GAAG;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gDAAgD,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,6CAA6C,GAAG;IAC1D,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,4CAA4C,GAAG;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,kBAAkB,EAAE,uDAAuD,EAAE,CAAC;IAC9E,IAAI,EAAE,+BAA+B,CAAC;IACtC,UAAU,EAAE,2BAA2B,CAAC;CACzC,CAAC;AAWF,wBAAgB,4CAA4C,CAC1D,QAAQ,EAAE,2BAA2B,EACrC,WAAW,EAAE,4BAA4B,EACzC,OAAO,GAAE,8CAAmD,GAC3D,uCAAuC,CAMzC;AAED,wBAAgB,2DAA2D,CACzE,QAAQ,EAAE,2BAA2B,EACrC,gBAAgB,EAAE,SAAS,sCAAsC,EAAE,EACnE,OAAO,GAAE,8CAAmD,GAC3D,uCAAuC,CA4BzC;AAED,wBAAgB,iDAAiD,CAC/D,QAAQ,EAAE,2BAA2B,EACrC,WAAW,EAAE,SAAS,2CAA2C,EAAE,EACnE,OAAO,GAAE,6CAAkD,GAC1D,4CAA4C,CAoH9C;AAED,wBAAgB,uDAAuD,CACrE,MAAM,EAAE,4CAA4C,GACnD,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAmB5C"}

package/dist/definition-tuning.js

@@ -0,0 +1,426 @@
+import { defineAssistantWorkflow } from "./definition.js";
+import { buildAssistantWorkflowDefinitionDiff, buildAssistantWorkflowDefinitionDiffTracePayload, } from "./definition-diff.js";
+export function buildAssistantWorkflowDefinitionTuningReport(workflow, traceReport, options = {}) {
+    return buildAssistantWorkflowDefinitionTuningReportFromSuggestions(workflow, traceReport.suggestions, options);
+}
+export function buildAssistantWorkflowDefinitionTuningReportFromSuggestions(workflow, traceSuggestions, options = {}) {
+    const minCount = clampPositiveInteger(options.minCount, 1);
+    const includeLowConfidence = options.includeLowConfidence === true;
+    const ignoredIntentIds = new Set(options.ignoredIntentIds ?? ["fallback", "other", "unknown"]);
+    const builder = new DefinitionTuningSuggestionBuilder(workflow);
+    for (const suggestion of traceSuggestions) {
+        if (suggestion.count < minCount)
+            continue;
+        const tuningSuggestion = mapTraceSuggestionToDefinitionSuggestion(workflow, suggestion, includeLowConfidence, ignoredIntentIds);
+        if (tuningSuggestion)
+            builder.add(tuningSuggestion);
+    }
+    const suggestions = builder.toSuggestions();
+    return {
+        generatedAt: new Date().toISOString(),
+        workflowId: workflow.id,
+        workflowVersion: workflow.version,
+        sourceSuggestionCount: traceSuggestions.length,
+        suggestionCount: suggestions.length,
+        applicableSuggestionCount: suggestions.filter((suggestion) => suggestion.patchPreview.kind !== "none").length,
+        skippedSuggestionCount: traceSuggestions.length - suggestions.length,
+        suggestions,
+    };
+}
+export function applyAssistantWorkflowDefinitionTuningSuggestions(workflow, suggestions, options = {}) {
+    const selectedIds = options.suggestionIds ? new Set(options.suggestionIds) : null;
+    const maxToolHintsPerIntent = normalizeOptionalPositiveInteger(options.maxToolHintsPerIntent);
+    const appliedSuggestionIds = [];
+    const skippedSuggestions = [];
+    const toolHintsByIntent = new Map();
+    const strategiesByDirectRoute = new Map();
+    for (const suggestion of suggestions) {
+        if (selectedIds && !selectedIds.has(suggestion.id)) {
+            skippedSuggestions.push({ id: suggestion.id, reason: "not_selected" });
+            continue;
+        }
+        if (suggestion.patchPreview.kind === "append_intent_tool_hint") {
+            const intent = findIntent(workflow, suggestion.patchPreview.intentId);
+            if (!intent) {
+                skippedSuggestions.push({ id: suggestion.id, reason: "missing_intent" });
+                continue;
+            }
+            if (intentHasToolHint(intent, suggestion.patchPreview.toolName)) {
+                skippedSuggestions.push({ id: suggestion.id, reason: "tool_hint_exists" });
+                continue;
+            }
+            const pendingHints = toolHintsByIntent.get(intent.id) ?? [];
+            if (pendingHints.includes(suggestion.patchPreview.toolName)) {
+                skippedSuggestions.push({ id: suggestion.id, reason: "tool_hint_exists" });
+                continue;
+            }
+            if (maxToolHintsPerIntent !== null && pendingHints.length >= maxToolHintsPerIntent) {
+                skippedSuggestions.push({ id: suggestion.id, reason: "intent_apply_limit" });
+                continue;
+            }
+            pendingHints.push(suggestion.patchPreview.toolName);
+            toolHintsByIntent.set(intent.id, pendingHints);
+            appliedSuggestionIds.push(suggestion.id);
+            continue;
+        }
+        if (suggestion.patchPreview.kind === "append_direct_route_strategy") {
+            const patchPreview = suggestion.patchPreview;
+            const directRoute = findDirectRoute(workflow, patchPreview.routeId);
+            if (!directRoute) {
+                skippedSuggestions.push({ id: suggestion.id, reason: "missing_direct_route" });
+                continue;
+            }
+            if (directRouteHasStrategy(directRoute, patchPreview.strategyId)) {
+                skippedSuggestions.push({ id: suggestion.id, reason: "direct_route_strategy_exists" });
+                continue;
+            }
+            const pendingStrategies = strategiesByDirectRoute.get(directRoute.id) ?? [];
+            if (pendingStrategies.some((strategy) => strategy.id === patchPreview.strategyId)) {
+                skippedSuggestions.push({ id: suggestion.id, reason: "direct_route_strategy_exists" });
+                continue;
+            }
+            pendingStrategies.push({
+                id: patchPreview.strategyId,
+                description: patchPreview.description,
+            });
+            strategiesByDirectRoute.set(directRoute.id, pendingStrategies);
+            appliedSuggestionIds.push(suggestion.id);
+            continue;
+        }
+        {
+            skippedSuggestions.push({ id: suggestion.id, reason: "unsupported_patch" });
+            continue;
+        }
+    }
+    if (appliedSuggestionIds.length === 0) {
+        return {
+            changed: false,
+            appliedCount: 0,
+            skippedCount: skippedSuggestions.length,
+            appliedSuggestionIds,
+            skippedSuggestions,
+            diff: buildAssistantWorkflowDefinitionDiff(workflow, workflow),
+            definition: workflow,
+        };
+    }
+    const directRoutes = workflow.directRoutes?.map((directRoute) => {
+        const appendedStrategies = strategiesByDirectRoute.get(directRoute.id);
+        if (!appendedStrategies?.length)
+            return directRoute;
+        return {
+            ...directRoute,
+            strategies: [
+                ...(directRoute.strategies ?? []),
+                ...appendedStrategies,
+            ],
+        };
+    });
+    const definition = defineAssistantWorkflow({
+        ...workflow,
+        version: options.bumpVersion === false ? workflow.version : workflow.version + 1,
+        intents: workflow.intents.map((intent) => {
+            const appendedHints = toolHintsByIntent.get(intent.id);
+            if (!appendedHints?.length)
+                return intent;
+            return {
+                ...intent,
+                toolHints: uniqueStrings([
+                    ...(intent.toolHints ?? []),
+                    ...appendedHints,
+                ]),
+            };
+        }),
+        ...(directRoutes ? { directRoutes } : {}),
+    });
+    return {
+        changed: true,
+        appliedCount: appliedSuggestionIds.length,
+        skippedCount: skippedSuggestions.length,
+        appliedSuggestionIds,
+        skippedSuggestions,
+        diff: buildAssistantWorkflowDefinitionDiff(workflow, definition),
+        definition,
+    };
+}
+export function buildAssistantWorkflowDefinitionTuningApplyTracePayload(result) {
+    return {
+        changed: result.changed,
+        appliedCount: result.appliedCount,
+        skippedCount: result.skippedCount,
+        appliedSuggestionIds: result.appliedSuggestionIds,
+        skippedSuggestions: result.skippedSuggestions.map((suggestion) => ({
+            id: suggestion.id,
+            reason: suggestion.reason,
+        })),
+        definition: {
+            id: result.definition.id,
+            version: result.definition.version,
+            intentCount: result.definition.intents.length,
+            toolCapabilityCount: result.definition.tools?.length ?? 0,
+            planningStepCount: result.definition.planningSteps?.length ?? 0,
+        },
+        diff: buildAssistantWorkflowDefinitionDiffTracePayload(result.diff),
+    };
+}
+function mapTraceSuggestionToDefinitionSuggestion(workflow, suggestion, includeLowConfidence, ignoredIntentIds) {
+    const intent = findIntent(workflow, suggestion.intent);
+    const tool = findTool(workflow, suggestion.tool);
+    const ignoredIntent = suggestion.intent ? ignoredIntentIds.has(suggestion.intent) : false;
+    switch (suggestion.kind) {
+        case "review_unmodeled_selected_tool":
+        case "review_classifier_extra_tool": {
+            if (!suggestion.intent || !suggestion.tool)
+                return null;
+            if (!intent)
+                return reviewOnlySuggestion(suggestion, "review_tool_selection_policy");
+            if (ignoredIntent)
+                return reviewOnlySuggestion(suggestion, "review_tool_selection_policy");
+            if (!tool)
+                return registerToolSuggestion(suggestion);
+            if (intentHasToolHint(intent, suggestion.tool)) {
+                return includeLowConfidence
+                    ? reviewOnlySuggestion(suggestion, "review_tool_selection_policy")
+                    : null;
+            }
+            if (tool.requiresConfirmation || tool.effect === "write" || tool.sideEffectRisk === "high") {
+                return reviewOnlySuggestion(suggestion, "review_tool_selection_policy");
+            }
+            return {
+                id: buildDefinitionTuningId("add_intent_tool_hint", suggestion.intent, suggestion.tool),
+                action: "add_intent_tool_hint",
+                severity: suggestion.severity,
+                intentId: suggestion.intent,
+                toolName: suggestion.tool,
+                signal: suggestion.signal,
+                count: suggestion.count,
+                requestIds: suggestion.requestIds,
+                sourceSuggestionIds: [suggestion.id],
+                rationale: `Trace review repeatedly selected ${suggestion.tool} for ${suggestion.intent}, but the workflow intent does not hint that tool.`,
+                suggestedAction: "Add the tool as an intent toolHint after confirming it is safe for this intent.",
+                patchPreview: {
+                    kind: "append_intent_tool_hint",
+                    intentId: suggestion.intent,
+                    toolName: suggestion.tool,
+                },
+            };
+        }
+        case "review_missing_required_tool":
+            if (!suggestion.tool)
+                return null;
+            if (!tool)
+                return registerToolSuggestion(suggestion);
+            return reviewOnlySuggestion(suggestion, "review_tool_selection_policy");
+        case "review_workflow_tool_selection_gap":
+            return includeLowConfidence
+                ? reviewOnlySuggestion(suggestion, "review_tool_selection_policy")
+                : null;
+        case "review_clarification_policy":
+            return reviewOnlySuggestion(suggestion, "review_clarification_rule");
+        case "review_memory_patch_equivalence":
+            return reviewOnlySuggestion(suggestion, "review_memory_patch_mapping");
+        case "review_direct_route_strategy":
+            return directRouteStrategySuggestion(workflow, suggestion);
+        case "review_trace_error":
+            return reviewOnlySuggestion(suggestion, "debug_runtime_error");
+        case "review_quality_signal":
+            return reviewOnlySuggestion(suggestion, "review_quality_signal");
+        case "promote_bad_feedback_eval":
+            return reviewOnlySuggestion(suggestion, "promote_eval_case");
+    }
+}
+function directRouteStrategySuggestion(workflow, suggestion) {
+    const parsed = parseDirectRouteStrategySignal(suggestion.signal);
+    const route = findDirectRoute(workflow, suggestion.intent) ??
+        findDirectRouteByObservedRoute(workflow, parsed?.route ?? null);
+    if (!route || !parsed || directRouteHasStrategy(route, parsed.strategy)) {
+        return reviewOnlySuggestion(suggestion, "review_direct_route_strategy");
+    }
+    return {
+        id: buildDefinitionTuningId("add_direct_route_strategy", route.id, parsed.strategy),
+        action: "add_direct_route_strategy",
+        severity: suggestion.severity,
+        intentId: route.id,
+        toolName: null,
+        signal: suggestion.signal,
+        count: suggestion.count,
+        requestIds: suggestion.requestIds,
+        sourceSuggestionIds: [suggestion.id],
+        rationale: `Trace review observed runtime strategy ${parsed.strategy} for direct route ${route.id}, but the workflow route does not declare it.`,
+        suggestedAction: "Add the observed strategy as direct-route metadata after confirming it names a stable runtime branch.",
+        patchPreview: {
+            kind: "append_direct_route_strategy",
+            routeId: route.id,
+            strategyId: parsed.strategy,
+            description: `Observed runtime strategy ${parsed.strategy} for direct route ${route.id}.`,
+        },
+    };
+}
+function registerToolSuggestion(suggestion) {
+    const toolName = suggestion.tool ?? "unknown";
+    return {
+        id: buildDefinitionTuningId("register_tool_capability", suggestion.intent, toolName),
+        action: "register_tool_capability",
+        severity: "warning",
+        intentId: suggestion.intent,
+        toolName,
+        signal: suggestion.signal,
+        count: suggestion.count,
+        requestIds: suggestion.requestIds,
+        sourceSuggestionIds: [suggestion.id],
+        rationale: `Trace review referenced ${toolName}, but the workflow package does not define that tool capability.`,
+        suggestedAction: "Register the tool capability/binding or remove the stale tool reference from the runtime path.",
+        patchPreview: {
+            kind: "register_tool_capability",
+            toolName,
+        },
+    };
+}
+function reviewOnlySuggestion(suggestion, action) {
+    return {
+        id: buildDefinitionTuningId(action, suggestion.intent, suggestion.tool ?? suggestion.signal ?? "all"),
+        action,
+        severity: suggestion.severity,
+        intentId: suggestion.intent,
+        toolName: suggestion.tool,
+        signal: suggestion.signal,
+        count: suggestion.count,
+        requestIds: suggestion.requestIds,
+        sourceSuggestionIds: [suggestion.id],
+        rationale: suggestion.rationale,
+        suggestedAction: suggestion.suggestedAction,
+        patchPreview: { kind: "none" },
+    };
+}
+class DefinitionTuningSuggestionBuilder {
+    workflow;
+    suggestions = new Map();
+    constructor(workflow) {
+        this.workflow = workflow;
+    }
+    add(input) {
+        const existing = this.suggestions.get(input.id);
+        if (existing) {
+            existing.count += input.count;
+            existing.requestIds = mergeLimitedStrings(existing.requestIds, input.requestIds);
+            existing.sourceSuggestionIds = mergeLimitedStrings(existing.sourceSuggestionIds, input.sourceSuggestionIds);
+            if (input.severity === "warning")
+                existing.severity = "warning";
+            return;
+        }
+        this.suggestions.set(input.id, {
+            id: input.id,
+            action: input.action,
+            severity: input.severity,
+            intentId: input.intentId,
+            toolName: input.toolName,
+            signal: input.signal,
+            count: input.count,
+            requestIds: [...input.requestIds],
+            sourceSuggestionIds: [...input.sourceSuggestionIds],
+            rationale: input.rationale,
+            suggestedAction: input.suggestedAction,
+            patchPreview: input.patchPreview,
+        });
+    }
+    toSuggestions() {
+        return [...this.suggestions.values()]
+            .filter((suggestion) => !isNoopToolHintSuggestion(this.workflow, suggestion))
+            .sort((left, right) => {
+            if (left.severity !== right.severity)
+                return left.severity === "warning" ? -1 : 1;
+            if (right.count !== left.count)
+                return right.count - left.count;
+            return left.id.localeCompare(right.id);
+        });
+    }
+}
+function isNoopToolHintSuggestion(workflow, suggestion) {
+    if (suggestion.patchPreview.kind === "append_intent_tool_hint") {
+        const intent = findIntent(workflow, suggestion.patchPreview.intentId);
+        return intentHasToolHint(intent, suggestion.patchPreview.toolName);
+    }
+    if (suggestion.patchPreview.kind === "append_direct_route_strategy") {
+        const directRoute = findDirectRoute(workflow, suggestion.patchPreview.routeId);
+        return directRouteHasStrategy(directRoute, suggestion.patchPreview.strategyId);
+    }
+    return false;
+}
+function findIntent(workflow, intentId) {
+    if (!intentId)
+        return null;
+    return workflow.intents.find((intent) => intent.id === intentId) ?? null;
+}
+function findTool(workflow, toolName) {
+    if (!toolName)
+        return null;
+    return workflow.tools?.find((tool) => tool.name === toolName) ?? null;
+}
+function findDirectRoute(workflow, routeId) {
+    if (!routeId)
+        return null;
+    return workflow.directRoutes?.find((route) => route.id === routeId) ?? null;
+}
+function findDirectRouteByObservedRoute(workflow, observedRoute) {
+    if (!observedRoute)
+        return null;
+    return workflow.directRoutes?.find((route) => route.id === observedRoute || route.outcomeRoute === observedRoute) ?? null;
+}
+function directRouteHasStrategy(directRoute, strategyId) {
+    if (!directRoute)
+        return false;
+    return (directRoute.strategies ?? []).some((strategy) => strategy.id === strategyId);
+}
+function parseDirectRouteStrategySignal(signal) {
+    if (!signal)
+        return null;
+    const separatorIndex = signal.indexOf(":");
+    if (separatorIndex <= 0 || separatorIndex >= signal.length - 1)
+        return null;
+    const route = signal.slice(0, separatorIndex).trim();
+    const strategy = signal.slice(separatorIndex + 1).trim();
+    if (!route || !strategy)
+        return null;
+    return { route, strategy };
+}
+function intentHasToolHint(intent, toolName) {
+    if (!intent)
+        return false;
+    return (intent.toolHints ?? []).includes(toolName) ||
+        (intent.requiredToolHints ?? []).includes(toolName);
+}
+function mergeLimitedStrings(left, right, limit = 10) {
+    const out = [];
+    for (const value of [...left, ...right]) {
+        if (!value.length || out.includes(value))
+            continue;
+        out.push(value);
+        if (out.length >= limit)
+            break;
+    }
+    return out;
+}
+function uniqueStrings(values) {
+    const out = [];
+    for (const value of values) {
+        if (!value.length || out.includes(value))
+            continue;
+        out.push(value);
+    }
+    return out;
+}
+function buildDefinitionTuningId(action, intent, target) {
+    return [action, intent ?? "unknown", target]
+        .map((part) => part.replace(/[^a-zA-Z0-9_.-]+/g, "_").toLowerCase())
+        .join(":");
+}
+function clampPositiveInteger(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return fallback;
+    return Math.max(1, Math.floor(value));
+}
+function normalizeOptionalPositiveInteger(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return null;
+    return Math.max(1, Math.floor(value));
+}
+//# sourceMappingURL=definition-tuning.js.map

package/dist/definition-tuning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-tuning.js","sourceRoot":"","sources":["../src/definition-tuning.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AssistantWorkflowDefinition,\n  AssistantWorkflowDirectRouteDefinition,\n  AssistantWorkflowIntentDefinition,\n  AssistantWorkflowToolCapabilityDefinition,\n} from \"./definition.js\";\nimport { defineAssistantWorkflow } from \"./definition.js\";\nimport {\n  buildAssistantWorkflowDefinitionDiff,\n  buildAssistantWorkflowDefinitionDiffTracePayload,\n  type AssistantWorkflowDefinitionDiff,\n} from \"./definition-diff.js\";\nimport type {\n  AssistantWorkflowTraceReport,\n  AssistantWorkflowTraceReportSuggestion,\n} from \"./trace-report.js\";\nimport type { AssistantWorkflowJsonValue } from \"./run-report-json.js\";\n\nexport type AssistantWorkflowDefinitionTuningAction =\n  | \"add_intent_tool_hint\"\n  | \"add_direct_route_strategy\"\n  | \"register_tool_capability\"\n  | \"review_tool_selection_policy\"\n  | \"review_clarification_rule\"\n  | \"review_direct_route_strategy\"\n  | \"debug_runtime_error\"\n  | \"promote_eval_case\"\n  | \"review_quality_signal\"\n  | \"review_memory_patch_mapping\";\n\nexport type AssistantWorkflowDefinitionTuningPatchPreview =\n  | {\n      kind: \"append_intent_tool_hint\";\n      intentId: string;\n      toolName: string;\n    }\n  | {\n      kind: \"register_tool_capability\";\n      toolName: string;\n    }\n  | {\n      kind: \"append_direct_route_strategy\";\n      routeId: string;\n      strategyId: string;\n      description: string;\n    }\n  | {\n      kind: \"none\";\n    };\n\nexport type AssistantWorkflowDefinitionTuningSuggestion = {\n  id: string;\n  action: AssistantWorkflowDefinitionTuningAction;\n  severity: \"info\" | \"warning\";\n  intentId: string | null;\n  toolName: string | null;\n  signal: string | null;\n  count: number;\n  requestIds: string[];\n  sourceSuggestionIds: string[];\n  rationale: string;\n  suggestedAction: string;\n  patchPreview: AssistantWorkflowDefinitionTuningPatchPreview;\n};\n\nexport type AssistantWorkflowDefinitionTuningReportOptions = {\n  minCount?: number;\n  includeLowConfidence?: boolean;\n  ignoredIntentIds?: readonly string[];\n};\n\nexport type AssistantWorkflowDefinitionTuningReport = {\n  generatedAt: string;\n  workflowId: string;\n  workflowVersion: number;\n  sourceSuggestionCount: number;\n  suggestionCount: number;\n  applicableSuggestionCount: number;\n  skippedSuggestionCount: number;\n  suggestions: AssistantWorkflowDefinitionTuningSuggestion[];\n};\n\nexport type AssistantWorkflowDefinitionTuningApplySkipReason =\n  | \"not_selected\"\n  | \"unsupported_patch\"\n  | \"missing_intent\"\n  | \"missing_direct_route\"\n  | \"tool_hint_exists\"\n  | \"direct_route_strategy_exists\"\n  | \"intent_apply_limit\";\n\nexport type AssistantWorkflowDefinitionTuningApplySkippedSuggestion = {\n  id: string;\n  reason: AssistantWorkflowDefinitionTuningApplySkipReason;\n};\n\nexport type AssistantWorkflowDefinitionTuningApplyOptions = {\n  suggestionIds?: readonly string[];\n  bumpVersion?: boolean;\n  maxToolHintsPerIntent?: number;\n};\n\nexport type AssistantWorkflowDefinitionTuningApplyResult = {\n  changed: boolean;\n  appliedCount: number;\n  skippedCount: number;\n  appliedSuggestionIds: string[];\n  skippedSuggestions: AssistantWorkflowDefinitionTuningApplySkippedSuggestion[];\n  diff: AssistantWorkflowDefinitionDiff;\n  definition: AssistantWorkflowDefinition;\n};\n\ntype SuggestionAccumulator = Omit<\n  AssistantWorkflowDefinitionTuningSuggestion,\n  \"count\" | \"requestIds\" | \"sourceSuggestionIds\"\n> & {\n  count: number;\n  requestIds: string[];\n  sourceSuggestionIds: string[];\n};\n\nexport function buildAssistantWorkflowDefinitionTuningReport(\n  workflow: AssistantWorkflowDefinition,\n  traceReport: AssistantWorkflowTraceReport,\n  options: AssistantWorkflowDefinitionTuningReportOptions = {},\n): AssistantWorkflowDefinitionTuningReport {\n  return buildAssistantWorkflowDefinitionTuningReportFromSuggestions(\n    workflow,\n    traceReport.suggestions,\n    options,\n  );\n}\n\nexport function buildAssistantWorkflowDefinitionTuningReportFromSuggestions(\n  workflow: AssistantWorkflowDefinition,\n  traceSuggestions: readonly AssistantWorkflowTraceReportSuggestion[],\n  options: AssistantWorkflowDefinitionTuningReportOptions = {},\n): AssistantWorkflowDefinitionTuningReport {\n  const minCount = clampPositiveInteger(options.minCount, 1);\n  const includeLowConfidence = options.includeLowConfidence === true;\n  const ignoredIntentIds = new Set(options.ignoredIntentIds ?? [\"fallback\", \"other\", \"unknown\"]);\n  const builder = new DefinitionTuningSuggestionBuilder(workflow);\n\n  for (const suggestion of traceSuggestions) {\n    if (suggestion.count < minCount) continue;\n    const tuningSuggestion = mapTraceSuggestionToDefinitionSuggestion(\n      workflow,\n      suggestion,\n      includeLowConfidence,\n      ignoredIntentIds,\n    );\n    if (tuningSuggestion) builder.add(tuningSuggestion);\n  }\n\n  const suggestions = builder.toSuggestions();\n  return {\n    generatedAt: new Date().toISOString(),\n    workflowId: workflow.id,\n    workflowVersion: workflow.version,\n    sourceSuggestionCount: traceSuggestions.length,\n    suggestionCount: suggestions.length,\n    applicableSuggestionCount: suggestions.filter((suggestion) => suggestion.patchPreview.kind !== \"none\").length,\n    skippedSuggestionCount: traceSuggestions.length - suggestions.length,\n    suggestions,\n  };\n}\n\nexport function applyAssistantWorkflowDefinitionTuningSuggestions(\n  workflow: AssistantWorkflowDefinition,\n  suggestions: readonly AssistantWorkflowDefinitionTuningSuggestion[],\n  options: AssistantWorkflowDefinitionTuningApplyOptions = {},\n): AssistantWorkflowDefinitionTuningApplyResult {\n  const selectedIds = options.suggestionIds ? new Set(options.suggestionIds) : null;\n  const maxToolHintsPerIntent = normalizeOptionalPositiveInteger(options.maxToolHintsPerIntent);\n  const appliedSuggestionIds: string[] = [];\n  const skippedSuggestions: AssistantWorkflowDefinitionTuningApplySkippedSuggestion[] = [];\n  const toolHintsByIntent = new Map<string, string[]>();\n  const strategiesByDirectRoute = new Map<string, Array<{ id: string; description: string }>>();\n\n  for (const suggestion of suggestions) {\n    if (selectedIds && !selectedIds.has(suggestion.id)) {\n      skippedSuggestions.push({ id: suggestion.id, reason: \"not_selected\" });\n      continue;\n    }\n    if (suggestion.patchPreview.kind === \"append_intent_tool_hint\") {\n      const intent = findIntent(workflow, suggestion.patchPreview.intentId);\n      if (!intent) {\n        skippedSuggestions.push({ id: suggestion.id, reason: \"missing_intent\" });\n        continue;\n      }\n      if (intentHasToolHint(intent, suggestion.patchPreview.toolName)) {\n        skippedSuggestions.push({ id: suggestion.id, reason: \"tool_hint_exists\" });\n        continue;\n      }\n      const pendingHints = toolHintsByIntent.get(intent.id) ?? [];\n      if (pendingHints.includes(suggestion.patchPreview.toolName)) {\n        skippedSuggestions.push({ id: suggestion.id, reason: \"tool_hint_exists\" });\n        continue;\n      }\n      if (maxToolHintsPerIntent !== null && pendingHints.length >= maxToolHintsPerIntent) {\n        skippedSuggestions.push({ id: suggestion.id, reason: \"intent_apply_limit\" });\n        continue;\n      }\n      pendingHints.push(suggestion.patchPreview.toolName);\n      toolHintsByIntent.set(intent.id, pendingHints);\n      appliedSuggestionIds.push(suggestion.id);\n      continue;\n    }\n    if (suggestion.patchPreview.kind === \"append_direct_route_strategy\") {\n      const patchPreview = suggestion.patchPreview;\n      const directRoute = findDirectRoute(workflow, patchPreview.routeId);\n      if (!directRoute) {\n        skippedSuggestions.push({ id: suggestion.id, reason: \"missing_direct_route\" });\n        continue;\n      }\n      if (directRouteHasStrategy(directRoute, patchPreview.strategyId)) {\n        skippedSuggestions.push({ id: suggestion.id, reason: \"direct_route_strategy_exists\" });\n        continue;\n      }\n      const pendingStrategies = strategiesByDirectRoute.get(directRoute.id) ?? [];\n      if (pendingStrategies.some((strategy) => strategy.id === patchPreview.strategyId)) {\n        skippedSuggestions.push({ id: suggestion.id, reason: \"direct_route_strategy_exists\" });\n        continue;\n      }\n      pendingStrategies.push({\n        id: patchPreview.strategyId,\n        description: patchPreview.description,\n      });\n      strategiesByDirectRoute.set(directRoute.id, pendingStrategies);\n      appliedSuggestionIds.push(suggestion.id);\n      continue;\n    }\n    {\n      skippedSuggestions.push({ id: suggestion.id, reason: \"unsupported_patch\" });\n      continue;\n    }\n  }\n\n  if (appliedSuggestionIds.length === 0) {\n    return {\n      changed: false,\n      appliedCount: 0,\n      skippedCount: skippedSuggestions.length,\n      appliedSuggestionIds,\n      skippedSuggestions,\n      diff: buildAssistantWorkflowDefinitionDiff(workflow, workflow),\n      definition: workflow,\n    };\n  }\n\n  const directRoutes = workflow.directRoutes?.map((directRoute) => {\n    const appendedStrategies = strategiesByDirectRoute.get(directRoute.id);\n    if (!appendedStrategies?.length) return directRoute;\n    return {\n      ...directRoute,\n      strategies: [\n        ...(directRoute.strategies ?? []),\n        ...appendedStrategies,\n      ],\n    };\n  });\n  const definition = defineAssistantWorkflow({\n    ...workflow,\n    version: options.bumpVersion === false ? workflow.version : workflow.version + 1,\n    intents: workflow.intents.map((intent) => {\n      const appendedHints = toolHintsByIntent.get(intent.id);\n      if (!appendedHints?.length) return intent;\n      return {\n        ...intent,\n        toolHints: uniqueStrings([\n          ...(intent.toolHints ?? []),\n          ...appendedHints,\n        ]),\n      };\n    }),\n    ...(directRoutes ? { directRoutes } : {}),\n  });\n\n  return {\n    changed: true,\n    appliedCount: appliedSuggestionIds.length,\n    skippedCount: skippedSuggestions.length,\n    appliedSuggestionIds,\n    skippedSuggestions,\n    diff: buildAssistantWorkflowDefinitionDiff(workflow, definition),\n    definition,\n  };\n}\n\nexport function buildAssistantWorkflowDefinitionTuningApplyTracePayload(\n  result: AssistantWorkflowDefinitionTuningApplyResult,\n): Record<string, AssistantWorkflowJsonValue> {\n  return {\n    changed: result.changed,\n    appliedCount: result.appliedCount,\n    skippedCount: result.skippedCount,\n    appliedSuggestionIds: result.appliedSuggestionIds,\n    skippedSuggestions: result.skippedSuggestions.map((suggestion) => ({\n      id: suggestion.id,\n      reason: suggestion.reason,\n    })),\n    definition: {\n      id: result.definition.id,\n      version: result.definition.version,\n      intentCount: result.definition.intents.length,\n      toolCapabilityCount: result.definition.tools?.length ?? 0,\n      planningStepCount: result.definition.planningSteps?.length ?? 0,\n    },\n    diff: buildAssistantWorkflowDefinitionDiffTracePayload(result.diff),\n  };\n}\n\nfunction mapTraceSuggestionToDefinitionSuggestion(\n  workflow: AssistantWorkflowDefinition,\n  suggestion: AssistantWorkflowTraceReportSuggestion,\n  includeLowConfidence: boolean,\n  ignoredIntentIds: ReadonlySet<string>,\n): AssistantWorkflowDefinitionTuningSuggestion | null {\n  const intent = findIntent(workflow, suggestion.intent);\n  const tool = findTool(workflow, suggestion.tool);\n  const ignoredIntent = suggestion.intent ? ignoredIntentIds.has(suggestion.intent) : false;\n\n  switch (suggestion.kind) {\n    case \"review_unmodeled_selected_tool\":\n    case \"review_classifier_extra_tool\": {\n      if (!suggestion.intent || !suggestion.tool) return null;\n      if (!intent) return reviewOnlySuggestion(suggestion, \"review_tool_selection_policy\");\n      if (ignoredIntent) return reviewOnlySuggestion(suggestion, \"review_tool_selection_policy\");\n      if (!tool) return registerToolSuggestion(suggestion);\n      if (intentHasToolHint(intent, suggestion.tool)) {\n        return includeLowConfidence\n          ? reviewOnlySuggestion(suggestion, \"review_tool_selection_policy\")\n          : null;\n      }\n      if (tool.requiresConfirmation || tool.effect === \"write\" || tool.sideEffectRisk === \"high\") {\n        return reviewOnlySuggestion(suggestion, \"review_tool_selection_policy\");\n      }\n      return {\n        id: buildDefinitionTuningId(\"add_intent_tool_hint\", suggestion.intent, suggestion.tool),\n        action: \"add_intent_tool_hint\",\n        severity: suggestion.severity,\n        intentId: suggestion.intent,\n        toolName: suggestion.tool,\n        signal: suggestion.signal,\n        count: suggestion.count,\n        requestIds: suggestion.requestIds,\n        sourceSuggestionIds: [suggestion.id],\n        rationale: `Trace review repeatedly selected ${suggestion.tool} for ${suggestion.intent}, but the workflow intent does not hint that tool.`,\n        suggestedAction: \"Add the tool as an intent toolHint after confirming it is safe for this intent.\",\n        patchPreview: {\n          kind: \"append_intent_tool_hint\",\n          intentId: suggestion.intent,\n          toolName: suggestion.tool,\n        },\n      };\n    }\n    case \"review_missing_required_tool\":\n      if (!suggestion.tool) return null;\n      if (!tool) return registerToolSuggestion(suggestion);\n      return reviewOnlySuggestion(suggestion, \"review_tool_selection_policy\");\n    case \"review_workflow_tool_selection_gap\":\n      return includeLowConfidence\n        ? reviewOnlySuggestion(suggestion, \"review_tool_selection_policy\")\n        : null;\n    case \"review_clarification_policy\":\n      return reviewOnlySuggestion(suggestion, \"review_clarification_rule\");\n    case \"review_memory_patch_equivalence\":\n      return reviewOnlySuggestion(suggestion, \"review_memory_patch_mapping\");\n    case \"review_direct_route_strategy\":\n      return directRouteStrategySuggestion(workflow, suggestion);\n    case \"review_trace_error\":\n      return reviewOnlySuggestion(suggestion, \"debug_runtime_error\");\n    case \"review_quality_signal\":\n      return reviewOnlySuggestion(suggestion, \"review_quality_signal\");\n    case \"promote_bad_feedback_eval\":\n      return reviewOnlySuggestion(suggestion, \"promote_eval_case\");\n  }\n}\n\nfunction directRouteStrategySuggestion(\n  workflow: AssistantWorkflowDefinition,\n  suggestion: AssistantWorkflowTraceReportSuggestion,\n): AssistantWorkflowDefinitionTuningSuggestion {\n  const parsed = parseDirectRouteStrategySignal(suggestion.signal);\n  const route = findDirectRoute(workflow, suggestion.intent) ??\n    findDirectRouteByObservedRoute(workflow, parsed?.route ?? null);\n  if (!route || !parsed || directRouteHasStrategy(route, parsed.strategy)) {\n    return reviewOnlySuggestion(suggestion, \"review_direct_route_strategy\");\n  }\n  return {\n    id: buildDefinitionTuningId(\"add_direct_route_strategy\", route.id, parsed.strategy),\n    action: \"add_direct_route_strategy\",\n    severity: suggestion.severity,\n    intentId: route.id,\n    toolName: null,\n    signal: suggestion.signal,\n    count: suggestion.count,\n    requestIds: suggestion.requestIds,\n    sourceSuggestionIds: [suggestion.id],\n    rationale: `Trace review observed runtime strategy ${parsed.strategy} for direct route ${route.id}, but the workflow route does not declare it.`,\n    suggestedAction: \"Add the observed strategy as direct-route metadata after confirming it names a stable runtime branch.\",\n    patchPreview: {\n      kind: \"append_direct_route_strategy\",\n      routeId: route.id,\n      strategyId: parsed.strategy,\n      description: `Observed runtime strategy ${parsed.strategy} for direct route ${route.id}.`,\n    },\n  };\n}\n\nfunction registerToolSuggestion(\n  suggestion: AssistantWorkflowTraceReportSuggestion,\n): AssistantWorkflowDefinitionTuningSuggestion {\n  const toolName = suggestion.tool ?? \"unknown\";\n  return {\n    id: buildDefinitionTuningId(\"register_tool_capability\", suggestion.intent, toolName),\n    action: \"register_tool_capability\",\n    severity: \"warning\",\n    intentId: suggestion.intent,\n    toolName,\n    signal: suggestion.signal,\n    count: suggestion.count,\n    requestIds: suggestion.requestIds,\n    sourceSuggestionIds: [suggestion.id],\n    rationale: `Trace review referenced ${toolName}, but the workflow package does not define that tool capability.`,\n    suggestedAction: \"Register the tool capability/binding or remove the stale tool reference from the runtime path.\",\n    patchPreview: {\n      kind: \"register_tool_capability\",\n      toolName,\n    },\n  };\n}\n\nfunction reviewOnlySuggestion(\n  suggestion: AssistantWorkflowTraceReportSuggestion,\n  action: AssistantWorkflowDefinitionTuningAction,\n): AssistantWorkflowDefinitionTuningSuggestion {\n  return {\n    id: buildDefinitionTuningId(action, suggestion.intent, suggestion.tool ?? suggestion.signal ?? \"all\"),\n    action,\n    severity: suggestion.severity,\n    intentId: suggestion.intent,\n    toolName: suggestion.tool,\n    signal: suggestion.signal,\n    count: suggestion.count,\n    requestIds: suggestion.requestIds,\n    sourceSuggestionIds: [suggestion.id],\n    rationale: suggestion.rationale,\n    suggestedAction: suggestion.suggestedAction,\n    patchPreview: { kind: \"none\" },\n  };\n}\n\nclass DefinitionTuningSuggestionBuilder {\n  private readonly suggestions = new Map<string, SuggestionAccumulator>();\n\n  constructor(private readonly workflow: AssistantWorkflowDefinition) {}\n\n  add(input: AssistantWorkflowDefinitionTuningSuggestion): void {\n    const existing = this.suggestions.get(input.id);\n    if (existing) {\n      existing.count += input.count;\n      existing.requestIds = mergeLimitedStrings(existing.requestIds, input.requestIds);\n      existing.sourceSuggestionIds = mergeLimitedStrings(existing.sourceSuggestionIds, input.sourceSuggestionIds);\n      if (input.severity === \"warning\") existing.severity = \"warning\";\n      return;\n    }\n    this.suggestions.set(input.id, {\n      id: input.id,\n      action: input.action,\n      severity: input.severity,\n      intentId: input.intentId,\n      toolName: input.toolName,\n      signal: input.signal,\n      count: input.count,\n      requestIds: [...input.requestIds],\n      sourceSuggestionIds: [...input.sourceSuggestionIds],\n      rationale: input.rationale,\n      suggestedAction: input.suggestedAction,\n      patchPreview: input.patchPreview,\n    });\n  }\n\n  toSuggestions(): AssistantWorkflowDefinitionTuningSuggestion[] {\n    return [...this.suggestions.values()]\n      .filter((suggestion) => !isNoopToolHintSuggestion(this.workflow, suggestion))\n      .sort((left, right) => {\n        if (left.severity !== right.severity) return left.severity === \"warning\" ? -1 : 1;\n        if (right.count !== left.count) return right.count - left.count;\n        return left.id.localeCompare(right.id);\n      });\n  }\n}\n\nfunction isNoopToolHintSuggestion(\n  workflow: AssistantWorkflowDefinition,\n  suggestion: SuggestionAccumulator,\n): boolean {\n  if (suggestion.patchPreview.kind === \"append_intent_tool_hint\") {\n    const intent = findIntent(workflow, suggestion.patchPreview.intentId);\n    return intentHasToolHint(intent, suggestion.patchPreview.toolName);\n  }\n  if (suggestion.patchPreview.kind === \"append_direct_route_strategy\") {\n    const directRoute = findDirectRoute(workflow, suggestion.patchPreview.routeId);\n    return directRouteHasStrategy(directRoute, suggestion.patchPreview.strategyId);\n  }\n  return false;\n}\n\nfunction findIntent(\n  workflow: AssistantWorkflowDefinition,\n  intentId: string | null,\n): AssistantWorkflowIntentDefinition | null {\n  if (!intentId) return null;\n  return workflow.intents.find((intent) => intent.id === intentId) ?? null;\n}\n\nfunction findTool(\n  workflow: AssistantWorkflowDefinition,\n  toolName: string | null,\n): AssistantWorkflowToolCapabilityDefinition | null {\n  if (!toolName) return null;\n  return workflow.tools?.find((tool) => tool.name === toolName) ?? null;\n}\n\nfunction findDirectRoute(\n  workflow: AssistantWorkflowDefinition,\n  routeId: string | null,\n): AssistantWorkflowDirectRouteDefinition | null {\n  if (!routeId) return null;\n  return workflow.directRoutes?.find((route) => route.id === routeId) ?? null;\n}\n\nfunction findDirectRouteByObservedRoute(\n  workflow: AssistantWorkflowDefinition,\n  observedRoute: string | null,\n): AssistantWorkflowDirectRouteDefinition | null {\n  if (!observedRoute) return null;\n  return workflow.directRoutes?.find((route) => route.id === observedRoute || route.outcomeRoute === observedRoute) ?? null;\n}\n\nfunction directRouteHasStrategy(\n  directRoute: AssistantWorkflowDirectRouteDefinition | null,\n  strategyId: string,\n): boolean {\n  if (!directRoute) return false;\n  return (directRoute.strategies ?? []).some((strategy) => strategy.id === strategyId);\n}\n\nfunction parseDirectRouteStrategySignal(signal: string | null): { route: string; strategy: string } | null {\n  if (!signal) return null;\n  const separatorIndex = signal.indexOf(\":\");\n  if (separatorIndex <= 0 || separatorIndex >= signal.length - 1) return null;\n  const route = signal.slice(0, separatorIndex).trim();\n  const strategy = signal.slice(separatorIndex + 1).trim();\n  if (!route || !strategy) return null;\n  return { route, strategy };\n}\n\nfunction intentHasToolHint(\n  intent: AssistantWorkflowIntentDefinition | null,\n  toolName: string,\n): boolean {\n  if (!intent) return false;\n  return (intent.toolHints ?? []).includes(toolName) ||\n    (intent.requiredToolHints ?? []).includes(toolName);\n}\n\nfunction mergeLimitedStrings(\n  left: readonly string[],\n  right: readonly string[],\n  limit = 10,\n): string[] {\n  const out: string[] = [];\n  for (const value of [...left, ...right]) {\n    if (!value.length || out.includes(value)) continue;\n    out.push(value);\n    if (out.length >= limit) break;\n  }\n  return out;\n}\n\nfunction uniqueStrings(values: readonly string[]): string[] {\n  const out: string[] = [];\n  for (const value of values) {\n    if (!value.length || out.includes(value)) continue;\n    out.push(value);\n  }\n  return out;\n}\n\nfunction buildDefinitionTuningId(\n  action: AssistantWorkflowDefinitionTuningAction,\n  intent: string | null,\n  target: string,\n): string {\n  return [action, intent ?? \"unknown\", target]\n    .map((part) => part.replace(/[^a-zA-Z0-9_.-]+/g, \"_\").toLowerCase())\n    .join(\":\");\n}\n\nfunction clampPositiveInteger(value: number | undefined, fallback: number): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return fallback;\n  return Math.max(1, Math.floor(value));\n}\n\nfunction normalizeOptionalPositiveInteger(value: number | undefined): number | null {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return null;\n  return Math.max(1, Math.floor(value));\n}\n"]}