@uns-kit/assistant-workflow 2.0.72

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

@@ -0,0 +1,59 @@
+import type { AssistantWorkflowDefinitionPackageSmokeSuiteResult } from "./definition-package-smoke.js";
+import type { AssistantWorkflowDefinitionTuningApplyResult } from "./definition-tuning.js";
+import type { AssistantWorkflowJsonValue } from "./run-report-json.js";
+export type AssistantWorkflowDefinitionTuningReviewStatus = "ready" | "warning" | "blocked";
+export type AssistantWorkflowDefinitionTuningReviewReasonSeverity = "warning" | "blocked";
+export type AssistantWorkflowDefinitionTuningReviewReasonCode = "no_change" | "smoke_required_failures" | "smoke_failures" | "smoke_not_run" | "too_many_applied_suggestions" | "too_many_changed_intents" | "too_many_changed_direct_routes" | "too_many_hints_for_intent" | "tool_output_presentation_mismatch";
+export type AssistantWorkflowDefinitionTuningReviewReason = {
+    severity: AssistantWorkflowDefinitionTuningReviewReasonSeverity;
+    code: AssistantWorkflowDefinitionTuningReviewReasonCode;
+    message: string;
+    details: Record<string, AssistantWorkflowJsonValue>;
+};
+export type AssistantWorkflowDefinitionTuningReviewOptions = {
+    maxAppliedSuggestions?: number;
+    maxChangedIntents?: number;
+    maxChangedDirectRoutes?: number;
+    maxAddedToolHintsPerIntent?: number;
+    requireSmokePass?: boolean;
+    checkToolCompatibility?: boolean;
+};
+export type AssistantWorkflowDefinitionTuningReviewSummary = {
+    changed: boolean;
+    appliedCount: number;
+    skippedCount: number;
+    changedIntentCount: number;
+    changedDirectRouteCount: number;
+    addedToolHintCount: number;
+    addedDirectRouteStrategyCount: number;
+    maxAddedToolHintsPerIntent: number;
+    changedIntents: {
+        intentId: string;
+        addedToolHintCount: number;
+        addedToolHints: string[];
+    }[];
+    changedDirectRoutes: {
+        routeId: string;
+        addedStrategyCount: number;
+        addedStrategyIds: string[];
+    }[];
+    smoke: {
+        caseCount: number;
+        passCount: number;
+        failCount: number;
+        requiredFailCount: number;
+        failedCaseIds: string[];
+        requiredFailedCaseIds: string[];
+    } | null;
+};
+export type AssistantWorkflowDefinitionTuningReview = {
+    status: AssistantWorkflowDefinitionTuningReviewStatus;
+    workflowId: string;
+    workflowVersion: number;
+    summary: AssistantWorkflowDefinitionTuningReviewSummary;
+    thresholds: Required<AssistantWorkflowDefinitionTuningReviewOptions>;
+    reasons: AssistantWorkflowDefinitionTuningReviewReason[];
+};
+export declare function buildAssistantWorkflowDefinitionTuningReview(applyResult: AssistantWorkflowDefinitionTuningApplyResult, smoke?: AssistantWorkflowDefinitionPackageSmokeSuiteResult | null, options?: AssistantWorkflowDefinitionTuningReviewOptions): AssistantWorkflowDefinitionTuningReview;
+export declare function buildAssistantWorkflowDefinitionTuningReviewTracePayload(review: AssistantWorkflowDefinitionTuningReview): Record<string, AssistantWorkflowJsonValue>;
+//# sourceMappingURL=definition-tuning-review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition-tuning-review.d.ts","sourceRoot":"","sources":["../src/definition-tuning-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kDAAkD,EAAE,MAAM,+BAA+B,CAAC;AACxG,OAAO,KAAK,EAAE,4CAA4C,EAAE,MAAM,wBAAwB,CAAC;AAC3F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,MAAM,6CAA6C,GACrD,OAAO,GACP,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,qDAAqD,GAC7D,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,iDAAiD,GACzD,WAAW,GACX,yBAAyB,GACzB,gBAAgB,GAChB,eAAe,GACf,8BAA8B,GAC9B,0BAA0B,GAC1B,gCAAgC,GAChC,2BAA2B,GAC3B,mCAAmC,CAAC;AAExC,MAAM,MAAM,6CAA6C,GAAG;IAC1D,QAAQ,EAAE,qDAAqD,CAAC;IAChE,IAAI,EAAE,iDAAiD,CAAC;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,8CAA8C,GAAG;IAC3D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,8CAA8C,GAAG;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6BAA6B,EAAE,MAAM,CAAC;IACtC,0BAA0B,EAAE,MAAM,CAAC;IACnC,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,EAAE,CAAC;IACJ,mBAAmB,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,EAAE,CAAC;IACJ,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,qBAAqB,EAAE,MAAM,EAAE,CAAC;KACjC,GAAG,IAAI,CAAC;CACV,CAAC;AAEF,MAAM,MAAM,uCAAuC,GAAG;IACpD,MAAM,EAAE,6CAA6C,CAAC;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,8CAA8C,CAAC;IACxD,UAAU,EAAE,QAAQ,CAAC,8CAA8C,CAAC,CAAC;IACrE,OAAO,EAAE,6CAA6C,EAAE,CAAC;CAC1D,CAAC;AAOF,wBAAgB,4CAA4C,CAC1D,WAAW,EAAE,4CAA4C,EACzD,KAAK,GAAE,kDAAkD,GAAG,IAAW,EACvE,OAAO,GAAE,8CAAmD,GAC3D,uCAAuC,CAmBzC;AAED,wBAAgB,wDAAwD,CACtE,MAAM,EAAE,uCAAuC,GAC9C,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAkC5C"}

package/dist/definition-tuning-review.js

@@ -0,0 +1,213 @@
+const DEFAULT_MAX_APPLIED_SUGGESTIONS = 10;
+const DEFAULT_MAX_CHANGED_INTENTS = 3;
+const DEFAULT_MAX_CHANGED_DIRECT_ROUTES = 5;
+const DEFAULT_MAX_ADDED_TOOL_HINTS_PER_INTENT = 5;
+export function buildAssistantWorkflowDefinitionTuningReview(applyResult, smoke = null, options = {}) {
+    const thresholds = normalizeReviewOptions(options);
+    const summary = buildReviewSummary(applyResult, smoke);
+    const reasons = buildReviewReasons(summary, thresholds, applyResult);
+    const hasBlockedReason = reasons.some((reason) => reason.severity === "blocked");
+    const status = hasBlockedReason
+        ? "blocked"
+        : reasons.length > 0
+            ? "warning"
+            : "ready";
+    return {
+        status,
+        workflowId: applyResult.definition.id,
+        workflowVersion: applyResult.definition.version,
+        summary,
+        thresholds,
+        reasons,
+    };
+}
+export function buildAssistantWorkflowDefinitionTuningReviewTracePayload(review) {
+    return {
+        status: review.status,
+        workflowId: review.workflowId,
+        workflowVersion: review.workflowVersion,
+        summary: {
+            changed: review.summary.changed,
+            appliedCount: review.summary.appliedCount,
+            skippedCount: review.summary.skippedCount,
+            changedIntentCount: review.summary.changedIntentCount,
+            changedDirectRouteCount: review.summary.changedDirectRouteCount,
+            addedToolHintCount: review.summary.addedToolHintCount,
+            addedDirectRouteStrategyCount: review.summary.addedDirectRouteStrategyCount,
+            maxAddedToolHintsPerIntent: review.summary.maxAddedToolHintsPerIntent,
+            changedIntents: review.summary.changedIntents.map((intent) => ({
+                intentId: intent.intentId,
+                addedToolHintCount: intent.addedToolHintCount,
+                addedToolHints: intent.addedToolHints,
+            })),
+            changedDirectRoutes: review.summary.changedDirectRoutes.map((route) => ({
+                routeId: route.routeId,
+                addedStrategyCount: route.addedStrategyCount,
+                addedStrategyIds: route.addedStrategyIds,
+            })),
+            smoke: review.summary.smoke,
+        },
+        thresholds: review.thresholds,
+        reasons: review.reasons.map((reason) => ({
+            severity: reason.severity,
+            code: reason.code,
+            message: reason.message,
+            details: reason.details,
+        })),
+    };
+}
+function buildReviewSummary(applyResult, smoke) {
+    const changedIntents = applyResult.diff.intentDiffs
+        .filter((intentDiff) => intentDiff.addedToolHints.length > 0)
+        .map((intentDiff) => ({
+        intentId: intentDiff.intentId,
+        addedToolHintCount: intentDiff.addedToolHints.length,
+        addedToolHints: intentDiff.addedToolHints,
+    }));
+    const addedToolHintCount = changedIntents.reduce((total, intent) => total + intent.addedToolHintCount, 0);
+    const changedDirectRoutes = applyResult.diff.directRouteDiffs
+        .filter((routeDiff) => routeDiff.addedStrategyIds.length > 0)
+        .map((routeDiff) => ({
+        routeId: routeDiff.routeId,
+        addedStrategyCount: routeDiff.addedStrategyIds.length,
+        addedStrategyIds: routeDiff.addedStrategyIds,
+    }));
+    const addedDirectRouteStrategyCount = changedDirectRoutes.reduce((total, route) => total + route.addedStrategyCount, 0);
+    return {
+        changed: applyResult.changed,
+        appliedCount: applyResult.appliedCount,
+        skippedCount: applyResult.skippedCount,
+        changedIntentCount: changedIntents.length,
+        changedDirectRouteCount: changedDirectRoutes.length,
+        addedToolHintCount,
+        addedDirectRouteStrategyCount,
+        maxAddedToolHintsPerIntent: Math.max(0, ...changedIntents.map((intent) => intent.addedToolHintCount)),
+        changedIntents,
+        changedDirectRoutes,
+        smoke: smoke
+            ? {
+                caseCount: smoke.summary.caseCount,
+                passCount: smoke.summary.passCount,
+                failCount: smoke.summary.failCount,
+                requiredFailCount: smoke.summary.requiredFailCount,
+                failedCaseIds: smoke.summary.failedCaseIds,
+                requiredFailedCaseIds: smoke.summary.requiredFailedCaseIds,
+            }
+            : null,
+    };
+}
+function buildReviewReasons(summary, thresholds, applyResult) {
+    const reasons = [];
+    if (!summary.changed) {
+        reasons.push(reason("blocked", "no_change", "No definition changes were applied.", {}));
+    }
+    if (summary.appliedCount > thresholds.maxAppliedSuggestions) {
+        reasons.push(reason("warning", "too_many_applied_suggestions", `Applied ${summary.appliedCount} suggestions, above the review threshold ${thresholds.maxAppliedSuggestions}.`, {
+            appliedCount: summary.appliedCount,
+            maxAppliedSuggestions: thresholds.maxAppliedSuggestions,
+        }));
+    }
+    if (summary.changedIntentCount > thresholds.maxChangedIntents) {
+        reasons.push(reason("warning", "too_many_changed_intents", `Changed ${summary.changedIntentCount} intents, above the review threshold ${thresholds.maxChangedIntents}.`, {
+            changedIntentCount: summary.changedIntentCount,
+            maxChangedIntents: thresholds.maxChangedIntents,
+        }));
+    }
+    if (summary.changedDirectRouteCount > thresholds.maxChangedDirectRoutes) {
+        reasons.push(reason("warning", "too_many_changed_direct_routes", `Changed ${summary.changedDirectRouteCount} direct routes, above the review threshold ${thresholds.maxChangedDirectRoutes}.`, {
+            changedDirectRouteCount: summary.changedDirectRouteCount,
+            maxChangedDirectRoutes: thresholds.maxChangedDirectRoutes,
+        }));
+    }
+    for (const changedIntent of summary.changedIntents) {
+        if (changedIntent.addedToolHintCount <= thresholds.maxAddedToolHintsPerIntent)
+            continue;
+        reasons.push(reason("warning", "too_many_hints_for_intent", `Intent ${changedIntent.intentId} gained ${changedIntent.addedToolHintCount} tool hints, above the review threshold ${thresholds.maxAddedToolHintsPerIntent}.`, {
+            intentId: changedIntent.intentId,
+            addedToolHintCount: changedIntent.addedToolHintCount,
+            maxAddedToolHintsPerIntent: thresholds.maxAddedToolHintsPerIntent,
+            addedToolHints: changedIntent.addedToolHints,
+        }));
+    }
+    if (summary.smoke) {
+        if (summary.smoke.requiredFailCount > 0) {
+            reasons.push(reason("blocked", "smoke_required_failures", `${summary.smoke.requiredFailCount} required smoke cases failed.`, {
+                requiredFailCount: summary.smoke.requiredFailCount,
+                requiredFailedCaseIds: summary.smoke.requiredFailedCaseIds,
+            }));
+        }
+        else if (summary.smoke.failCount > 0) {
+            reasons.push(reason("warning", "smoke_failures", `${summary.smoke.failCount} optional smoke cases failed.`, {
+                failCount: summary.smoke.failCount,
+                failedCaseIds: summary.smoke.failedCaseIds,
+            }));
+        }
+    }
+    else if (thresholds.requireSmokePass) {
+        reasons.push(reason("warning", "smoke_not_run", "Smoke suite was not run for this tuning review.", {}));
+    }
+    if (thresholds.checkToolCompatibility) {
+        reasons.push(...buildToolCompatibilityReasons(applyResult));
+    }
+    return reasons;
+}
+function buildToolCompatibilityReasons(applyResult) {
+    const reasons = [];
+    const intentsById = new Map(applyResult.definition.intents.map((intent) => [intent.id, intent]));
+    const toolsByName = new Map((applyResult.definition.tools ?? []).map((tool) => [tool.name, tool]));
+    for (const intentDiff of applyResult.diff.intentDiffs) {
+        const intent = intentsById.get(intentDiff.intentId);
+        if (!intent?.defaultPresentation)
+            continue;
+        for (const toolName of intentDiff.addedToolHints) {
+            const tool = toolsByName.get(toolName);
+            if (!tool)
+                continue;
+            if (!hasToolOutputPresentationMismatch(intent.defaultPresentation, tool.outputKinds))
+                continue;
+            reasons.push(reason("warning", "tool_output_presentation_mismatch", `Tool ${toolName} only produces ${tool.outputKinds.join(", ")} output, which may not fit intent ${intent.id} default presentation ${intent.defaultPresentation}.`, {
+                intentId: intent.id,
+                toolName,
+                defaultPresentation: intent.defaultPresentation,
+                outputKinds: [...tool.outputKinds],
+            }));
+        }
+    }
+    return reasons;
+}
+function hasToolOutputPresentationMismatch(presentation, outputKinds) {
+    const normalizedPresentation = presentation.trim().toLowerCase();
+    const normalizedOutputKinds = outputKinds.map((outputKind) => outputKind.trim().toLowerCase());
+    if (normalizedPresentation === "text") {
+        return normalizedOutputKinds.length > 0 &&
+            normalizedOutputKinds.every((outputKind) => outputKind === "chart" || outputKind === "artifact");
+    }
+    if (normalizedPresentation === "table") {
+        return normalizedOutputKinds.length > 0 &&
+            normalizedOutputKinds.every((outputKind) => outputKind === "chart");
+    }
+    if (normalizedPresentation === "chart") {
+        return normalizedOutputKinds.length > 0 &&
+            normalizedOutputKinds.every((outputKind) => !["chart", "data", "table", "artifact"].includes(outputKind));
+    }
+    return false;
+}
+function reason(severity, code, message, details) {
+    return { severity, code, message, details };
+}
+function normalizeReviewOptions(options) {
+    return {
+        maxAppliedSuggestions: normalizeNonNegativeInteger(options.maxAppliedSuggestions, DEFAULT_MAX_APPLIED_SUGGESTIONS),
+        maxChangedIntents: normalizeNonNegativeInteger(options.maxChangedIntents, DEFAULT_MAX_CHANGED_INTENTS),
+        maxChangedDirectRoutes: normalizeNonNegativeInteger(options.maxChangedDirectRoutes, DEFAULT_MAX_CHANGED_DIRECT_ROUTES),
+        maxAddedToolHintsPerIntent: normalizeNonNegativeInteger(options.maxAddedToolHintsPerIntent, DEFAULT_MAX_ADDED_TOOL_HINTS_PER_INTENT),
+        requireSmokePass: options.requireSmokePass !== false,
+        checkToolCompatibility: options.checkToolCompatibility !== false,
+    };
+}
+function normalizeNonNegativeInteger(value, fallback) {
+    if (value === undefined || !Number.isFinite(value) || value < 0)
+        return fallback;
+    return Math.floor(value);
+}
+//# sourceMappingURL=definition-tuning-review.js.map

package/dist/definition-tuning-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-tuning-review.js","sourceRoot":"","sources":["../src/definition-tuning-review.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantWorkflowDefinitionPackageSmokeSuiteResult } from \"./definition-package-smoke.js\";\nimport type { AssistantWorkflowDefinitionTuningApplyResult } from \"./definition-tuning.js\";\nimport type { AssistantWorkflowJsonValue } from \"./run-report-json.js\";\n\nexport type AssistantWorkflowDefinitionTuningReviewStatus =\n  | \"ready\"\n  | \"warning\"\n  | \"blocked\";\n\nexport type AssistantWorkflowDefinitionTuningReviewReasonSeverity =\n  | \"warning\"\n  | \"blocked\";\n\nexport type AssistantWorkflowDefinitionTuningReviewReasonCode =\n  | \"no_change\"\n  | \"smoke_required_failures\"\n  | \"smoke_failures\"\n  | \"smoke_not_run\"\n  | \"too_many_applied_suggestions\"\n  | \"too_many_changed_intents\"\n  | \"too_many_changed_direct_routes\"\n  | \"too_many_hints_for_intent\"\n  | \"tool_output_presentation_mismatch\";\n\nexport type AssistantWorkflowDefinitionTuningReviewReason = {\n  severity: AssistantWorkflowDefinitionTuningReviewReasonSeverity;\n  code: AssistantWorkflowDefinitionTuningReviewReasonCode;\n  message: string;\n  details: Record<string, AssistantWorkflowJsonValue>;\n};\n\nexport type AssistantWorkflowDefinitionTuningReviewOptions = {\n  maxAppliedSuggestions?: number;\n  maxChangedIntents?: number;\n  maxChangedDirectRoutes?: number;\n  maxAddedToolHintsPerIntent?: number;\n  requireSmokePass?: boolean;\n  checkToolCompatibility?: boolean;\n};\n\nexport type AssistantWorkflowDefinitionTuningReviewSummary = {\n  changed: boolean;\n  appliedCount: number;\n  skippedCount: number;\n  changedIntentCount: number;\n  changedDirectRouteCount: number;\n  addedToolHintCount: number;\n  addedDirectRouteStrategyCount: number;\n  maxAddedToolHintsPerIntent: number;\n  changedIntents: {\n    intentId: string;\n    addedToolHintCount: number;\n    addedToolHints: string[];\n  }[];\n  changedDirectRoutes: {\n    routeId: string;\n    addedStrategyCount: number;\n    addedStrategyIds: string[];\n  }[];\n  smoke: {\n    caseCount: number;\n    passCount: number;\n    failCount: number;\n    requiredFailCount: number;\n    failedCaseIds: string[];\n    requiredFailedCaseIds: string[];\n  } | null;\n};\n\nexport type AssistantWorkflowDefinitionTuningReview = {\n  status: AssistantWorkflowDefinitionTuningReviewStatus;\n  workflowId: string;\n  workflowVersion: number;\n  summary: AssistantWorkflowDefinitionTuningReviewSummary;\n  thresholds: Required<AssistantWorkflowDefinitionTuningReviewOptions>;\n  reasons: AssistantWorkflowDefinitionTuningReviewReason[];\n};\n\nconst DEFAULT_MAX_APPLIED_SUGGESTIONS = 10;\nconst DEFAULT_MAX_CHANGED_INTENTS = 3;\nconst DEFAULT_MAX_CHANGED_DIRECT_ROUTES = 5;\nconst DEFAULT_MAX_ADDED_TOOL_HINTS_PER_INTENT = 5;\n\nexport function buildAssistantWorkflowDefinitionTuningReview(\n  applyResult: AssistantWorkflowDefinitionTuningApplyResult,\n  smoke: AssistantWorkflowDefinitionPackageSmokeSuiteResult | null = null,\n  options: AssistantWorkflowDefinitionTuningReviewOptions = {},\n): AssistantWorkflowDefinitionTuningReview {\n  const thresholds = normalizeReviewOptions(options);\n  const summary = buildReviewSummary(applyResult, smoke);\n  const reasons = buildReviewReasons(summary, thresholds, applyResult);\n  const hasBlockedReason = reasons.some((reason) => reason.severity === \"blocked\");\n  const status: AssistantWorkflowDefinitionTuningReviewStatus = hasBlockedReason\n    ? \"blocked\"\n    : reasons.length > 0\n      ? \"warning\"\n      : \"ready\";\n\n  return {\n    status,\n    workflowId: applyResult.definition.id,\n    workflowVersion: applyResult.definition.version,\n    summary,\n    thresholds,\n    reasons,\n  };\n}\n\nexport function buildAssistantWorkflowDefinitionTuningReviewTracePayload(\n  review: AssistantWorkflowDefinitionTuningReview,\n): Record<string, AssistantWorkflowJsonValue> {\n  return {\n    status: review.status,\n    workflowId: review.workflowId,\n    workflowVersion: review.workflowVersion,\n    summary: {\n      changed: review.summary.changed,\n      appliedCount: review.summary.appliedCount,\n      skippedCount: review.summary.skippedCount,\n      changedIntentCount: review.summary.changedIntentCount,\n      changedDirectRouteCount: review.summary.changedDirectRouteCount,\n      addedToolHintCount: review.summary.addedToolHintCount,\n      addedDirectRouteStrategyCount: review.summary.addedDirectRouteStrategyCount,\n      maxAddedToolHintsPerIntent: review.summary.maxAddedToolHintsPerIntent,\n      changedIntents: review.summary.changedIntents.map((intent) => ({\n        intentId: intent.intentId,\n        addedToolHintCount: intent.addedToolHintCount,\n        addedToolHints: intent.addedToolHints,\n      })),\n      changedDirectRoutes: review.summary.changedDirectRoutes.map((route) => ({\n        routeId: route.routeId,\n        addedStrategyCount: route.addedStrategyCount,\n        addedStrategyIds: route.addedStrategyIds,\n      })),\n      smoke: review.summary.smoke,\n    },\n    thresholds: review.thresholds,\n    reasons: review.reasons.map((reason) => ({\n      severity: reason.severity,\n      code: reason.code,\n      message: reason.message,\n      details: reason.details,\n    })),\n  };\n}\n\nfunction buildReviewSummary(\n  applyResult: AssistantWorkflowDefinitionTuningApplyResult,\n  smoke: AssistantWorkflowDefinitionPackageSmokeSuiteResult | null,\n): AssistantWorkflowDefinitionTuningReviewSummary {\n  const changedIntents = applyResult.diff.intentDiffs\n    .filter((intentDiff) => intentDiff.addedToolHints.length > 0)\n    .map((intentDiff) => ({\n      intentId: intentDiff.intentId,\n      addedToolHintCount: intentDiff.addedToolHints.length,\n      addedToolHints: intentDiff.addedToolHints,\n    }));\n  const addedToolHintCount = changedIntents.reduce(\n    (total, intent) => total + intent.addedToolHintCount,\n    0,\n  );\n  const changedDirectRoutes = applyResult.diff.directRouteDiffs\n    .filter((routeDiff) => routeDiff.addedStrategyIds.length > 0)\n    .map((routeDiff) => ({\n      routeId: routeDiff.routeId,\n      addedStrategyCount: routeDiff.addedStrategyIds.length,\n      addedStrategyIds: routeDiff.addedStrategyIds,\n    }));\n  const addedDirectRouteStrategyCount = changedDirectRoutes.reduce(\n    (total, route) => total + route.addedStrategyCount,\n    0,\n  );\n\n  return {\n    changed: applyResult.changed,\n    appliedCount: applyResult.appliedCount,\n    skippedCount: applyResult.skippedCount,\n    changedIntentCount: changedIntents.length,\n    changedDirectRouteCount: changedDirectRoutes.length,\n    addedToolHintCount,\n    addedDirectRouteStrategyCount,\n    maxAddedToolHintsPerIntent: Math.max(0, ...changedIntents.map((intent) => intent.addedToolHintCount)),\n    changedIntents,\n    changedDirectRoutes,\n    smoke: smoke\n      ? {\n          caseCount: smoke.summary.caseCount,\n          passCount: smoke.summary.passCount,\n          failCount: smoke.summary.failCount,\n          requiredFailCount: smoke.summary.requiredFailCount,\n          failedCaseIds: smoke.summary.failedCaseIds,\n          requiredFailedCaseIds: smoke.summary.requiredFailedCaseIds,\n        }\n      : null,\n  };\n}\n\nfunction buildReviewReasons(\n  summary: AssistantWorkflowDefinitionTuningReviewSummary,\n  thresholds: Required<AssistantWorkflowDefinitionTuningReviewOptions>,\n  applyResult: AssistantWorkflowDefinitionTuningApplyResult,\n): AssistantWorkflowDefinitionTuningReviewReason[] {\n  const reasons: AssistantWorkflowDefinitionTuningReviewReason[] = [];\n\n  if (!summary.changed) {\n    reasons.push(reason(\n      \"blocked\",\n      \"no_change\",\n      \"No definition changes were applied.\",\n      {},\n    ));\n  }\n\n  if (summary.appliedCount > thresholds.maxAppliedSuggestions) {\n    reasons.push(reason(\n      \"warning\",\n      \"too_many_applied_suggestions\",\n      `Applied ${summary.appliedCount} suggestions, above the review threshold ${thresholds.maxAppliedSuggestions}.`,\n      {\n        appliedCount: summary.appliedCount,\n        maxAppliedSuggestions: thresholds.maxAppliedSuggestions,\n      },\n    ));\n  }\n\n  if (summary.changedIntentCount > thresholds.maxChangedIntents) {\n    reasons.push(reason(\n      \"warning\",\n      \"too_many_changed_intents\",\n      `Changed ${summary.changedIntentCount} intents, above the review threshold ${thresholds.maxChangedIntents}.`,\n      {\n        changedIntentCount: summary.changedIntentCount,\n        maxChangedIntents: thresholds.maxChangedIntents,\n      },\n    ));\n  }\n\n  if (summary.changedDirectRouteCount > thresholds.maxChangedDirectRoutes) {\n    reasons.push(reason(\n      \"warning\",\n      \"too_many_changed_direct_routes\",\n      `Changed ${summary.changedDirectRouteCount} direct routes, above the review threshold ${thresholds.maxChangedDirectRoutes}.`,\n      {\n        changedDirectRouteCount: summary.changedDirectRouteCount,\n        maxChangedDirectRoutes: thresholds.maxChangedDirectRoutes,\n      },\n    ));\n  }\n\n  for (const changedIntent of summary.changedIntents) {\n    if (changedIntent.addedToolHintCount <= thresholds.maxAddedToolHintsPerIntent) continue;\n    reasons.push(reason(\n      \"warning\",\n      \"too_many_hints_for_intent\",\n      `Intent ${changedIntent.intentId} gained ${changedIntent.addedToolHintCount} tool hints, above the review threshold ${thresholds.maxAddedToolHintsPerIntent}.`,\n      {\n        intentId: changedIntent.intentId,\n        addedToolHintCount: changedIntent.addedToolHintCount,\n        maxAddedToolHintsPerIntent: thresholds.maxAddedToolHintsPerIntent,\n        addedToolHints: changedIntent.addedToolHints,\n      },\n    ));\n  }\n\n  if (summary.smoke) {\n    if (summary.smoke.requiredFailCount > 0) {\n      reasons.push(reason(\n        \"blocked\",\n        \"smoke_required_failures\",\n        `${summary.smoke.requiredFailCount} required smoke cases failed.`,\n        {\n          requiredFailCount: summary.smoke.requiredFailCount,\n          requiredFailedCaseIds: summary.smoke.requiredFailedCaseIds,\n        },\n      ));\n    } else if (summary.smoke.failCount > 0) {\n      reasons.push(reason(\n        \"warning\",\n        \"smoke_failures\",\n        `${summary.smoke.failCount} optional smoke cases failed.`,\n        {\n          failCount: summary.smoke.failCount,\n          failedCaseIds: summary.smoke.failedCaseIds,\n        },\n      ));\n    }\n  } else if (thresholds.requireSmokePass) {\n    reasons.push(reason(\n      \"warning\",\n      \"smoke_not_run\",\n      \"Smoke suite was not run for this tuning review.\",\n      {},\n    ));\n  }\n\n  if (thresholds.checkToolCompatibility) {\n    reasons.push(...buildToolCompatibilityReasons(applyResult));\n  }\n\n  return reasons;\n}\n\nfunction buildToolCompatibilityReasons(\n  applyResult: AssistantWorkflowDefinitionTuningApplyResult,\n): AssistantWorkflowDefinitionTuningReviewReason[] {\n  const reasons: AssistantWorkflowDefinitionTuningReviewReason[] = [];\n  const intentsById = new Map(applyResult.definition.intents.map((intent) => [intent.id, intent]));\n  const toolsByName = new Map((applyResult.definition.tools ?? []).map((tool) => [tool.name, tool]));\n\n  for (const intentDiff of applyResult.diff.intentDiffs) {\n    const intent = intentsById.get(intentDiff.intentId);\n    if (!intent?.defaultPresentation) continue;\n    for (const toolName of intentDiff.addedToolHints) {\n      const tool = toolsByName.get(toolName);\n      if (!tool) continue;\n      if (!hasToolOutputPresentationMismatch(intent.defaultPresentation, tool.outputKinds)) continue;\n      reasons.push(reason(\n        \"warning\",\n        \"tool_output_presentation_mismatch\",\n        `Tool ${toolName} only produces ${tool.outputKinds.join(\", \")} output, which may not fit intent ${intent.id} default presentation ${intent.defaultPresentation}.`,\n        {\n          intentId: intent.id,\n          toolName,\n          defaultPresentation: intent.defaultPresentation,\n          outputKinds: [...tool.outputKinds],\n        },\n      ));\n    }\n  }\n\n  return reasons;\n}\n\nfunction hasToolOutputPresentationMismatch(\n  presentation: string,\n  outputKinds: readonly string[],\n): boolean {\n  const normalizedPresentation = presentation.trim().toLowerCase();\n  const normalizedOutputKinds = outputKinds.map((outputKind) => outputKind.trim().toLowerCase());\n  if (normalizedPresentation === \"text\") {\n    return normalizedOutputKinds.length > 0 &&\n      normalizedOutputKinds.every((outputKind) => outputKind === \"chart\" || outputKind === \"artifact\");\n  }\n  if (normalizedPresentation === \"table\") {\n    return normalizedOutputKinds.length > 0 &&\n      normalizedOutputKinds.every((outputKind) => outputKind === \"chart\");\n  }\n  if (normalizedPresentation === \"chart\") {\n    return normalizedOutputKinds.length > 0 &&\n      normalizedOutputKinds.every((outputKind) =>\n        ![\"chart\", \"data\", \"table\", \"artifact\"].includes(outputKind)\n      );\n  }\n  return false;\n}\n\nfunction reason(\n  severity: AssistantWorkflowDefinitionTuningReviewReasonSeverity,\n  code: AssistantWorkflowDefinitionTuningReviewReasonCode,\n  message: string,\n  details: Record<string, AssistantWorkflowJsonValue>,\n): AssistantWorkflowDefinitionTuningReviewReason {\n  return { severity, code, message, details };\n}\n\nfunction normalizeReviewOptions(\n  options: AssistantWorkflowDefinitionTuningReviewOptions,\n): Required<AssistantWorkflowDefinitionTuningReviewOptions> {\n  return {\n    maxAppliedSuggestions: normalizeNonNegativeInteger(\n      options.maxAppliedSuggestions,\n      DEFAULT_MAX_APPLIED_SUGGESTIONS,\n    ),\n    maxChangedIntents: normalizeNonNegativeInteger(\n      options.maxChangedIntents,\n      DEFAULT_MAX_CHANGED_INTENTS,\n    ),\n    maxChangedDirectRoutes: normalizeNonNegativeInteger(\n      options.maxChangedDirectRoutes,\n      DEFAULT_MAX_CHANGED_DIRECT_ROUTES,\n    ),\n    maxAddedToolHintsPerIntent: normalizeNonNegativeInteger(\n      options.maxAddedToolHintsPerIntent,\n      DEFAULT_MAX_ADDED_TOOL_HINTS_PER_INTENT,\n    ),\n    requireSmokePass: options.requireSmokePass !== false,\n    checkToolCompatibility: options.checkToolCompatibility !== false,\n  };\n}\n\nfunction normalizeNonNegativeInteger(value: number | undefined, fallback: number): number {\n  if (value === undefined || !Number.isFinite(value) || value < 0) return fallback;\n  return Math.floor(value);\n}\n"]}

package/dist/definition-tuning-source-patch.d.ts

@@ -0,0 +1,43 @@
+import { type AssistantWorkflowDefinitionTuningPromotion } from "./definition-tuning-promotion.js";
+import type { AssistantWorkflowDefinitionTuningReviewArtifact } from "./definition-tuning-review-artifact.js";
+import { type AssistantWorkflowSerializedDefinition } from "./definition-json.js";
+import type { AssistantWorkflowJsonValue } from "./run-report-json.js";
+export declare const ASSISTANT_WORKFLOW_DEFINITION_TUNING_SOURCE_PATCH_SCHEMA_VERSION = 1;
+export type AssistantWorkflowDefinitionTuningSourcePatchStatus = "ready" | "blocked";
+export type AssistantWorkflowDefinitionTuningSourcePatchOperation = {
+    kind: "replace_workflow_definition";
+    workflowId: string;
+    fromVersion: number | null;
+    toVersion: number | null;
+    format: "assistant_workflow_serialized_definition_json";
+    definition: AssistantWorkflowSerializedDefinition;
+};
+export type AssistantWorkflowDefinitionTuningSourcePatchArtifact = {
+    schemaVersion: typeof ASSISTANT_WORKFLOW_DEFINITION_TUNING_SOURCE_PATCH_SCHEMA_VERSION;
+    generatedAt: string;
+    workflowId: string;
+    fromVersion: number | null;
+    toVersion: number | null;
+    status: AssistantWorkflowDefinitionTuningSourcePatchStatus;
+    target: {
+        kind: "serialized_definition_file";
+        suggestedFileName: string | null;
+    };
+    promotion: Record<string, AssistantWorkflowJsonValue>;
+    brief: Record<string, AssistantWorkflowJsonValue>;
+    operations: AssistantWorkflowDefinitionTuningSourcePatchOperation[];
+    reasons: {
+        code: "promotion_not_promotable";
+        message: string;
+        details: Record<string, AssistantWorkflowJsonValue>;
+    }[];
+};
+export type AssistantWorkflowDefinitionTuningSourcePatchOptions = {
+    generatedAt?: string;
+    suggestedFileName?: string | null;
+};
+export declare function buildAssistantWorkflowDefinitionTuningSourcePatchArtifact(reviewArtifact: AssistantWorkflowDefinitionTuningReviewArtifact, promotion?: AssistantWorkflowDefinitionTuningPromotion, options?: AssistantWorkflowDefinitionTuningSourcePatchOptions): AssistantWorkflowDefinitionTuningSourcePatchArtifact;
+export declare function buildAssistantWorkflowDefinitionTuningSourcePatchTracePayload(artifact: AssistantWorkflowDefinitionTuningSourcePatchArtifact): Record<string, AssistantWorkflowJsonValue>;
+export declare function stringifyAssistantWorkflowDefinitionTuningSourcePatchArtifact(artifact: AssistantWorkflowDefinitionTuningSourcePatchArtifact, space?: number): string;
+export declare function parseAssistantWorkflowDefinitionTuningSourcePatchArtifact(value: unknown): AssistantWorkflowDefinitionTuningSourcePatchArtifact | null;
+//# sourceMappingURL=definition-tuning-source-patch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition-tuning-source-patch.d.ts","sourceRoot":"","sources":["../src/definition-tuning-source-patch.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,0CAA0C,EAChD,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,+CAA+C,EAAE,MAAM,wCAAwC,CAAC;AAC9G,OAAO,EAEL,KAAK,qCAAqC,EAC3C,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,eAAO,MAAM,gEAAgE,IAAI,CAAC;AAElF,MAAM,MAAM,kDAAkD,GAC1D,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,qDAAqD,GAAG;IAClE,IAAI,EAAE,6BAA6B,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,+CAA+C,CAAC;IACxD,UAAU,EAAE,qCAAqC,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,oDAAoD,GAAG;IACjE,aAAa,EAAE,OAAO,gEAAgE,CAAC;IACvF,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,kDAAkD,CAAC;IAC3D,MAAM,EAAE;QACN,IAAI,EAAE,4BAA4B,CAAC;QACnC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC,CAAC;IACF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IACtD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IAClD,UAAU,EAAE,qDAAqD,EAAE,CAAC;IACpE,OAAO,EAAE;QACP,IAAI,EAAE,0BAA0B,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;KACrD,EAAE,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,mDAAmD,GAAG;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF,wBAAgB,yDAAyD,CACvE,cAAc,EAAE,+CAA+C,EAC/D,SAAS,GAAE,0CAA4G,EACvH,OAAO,GAAE,mDAAwD,GAChE,oDAAoD,CAwCtD;AAED,wBAAgB,6DAA6D,CAC3E,QAAQ,EAAE,oDAAoD,GAC7D,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CA0B5C;AAED,wBAAgB,6DAA6D,CAC3E,QAAQ,EAAE,oDAAoD,EAC9D,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAER;AAED,wBAAgB,yDAAyD,CACvE,KAAK,EAAE,OAAO,GACb,oDAAoD,GAAG,IAAI,CAiC7D"}

package/dist/definition-tuning-source-patch.js

@@ -0,0 +1,214 @@
+import { buildAssistantWorkflowDefinitionTuningPromotion, buildAssistantWorkflowDefinitionTuningPromotionBrief, buildAssistantWorkflowDefinitionTuningPromotionBriefTracePayload, buildAssistantWorkflowDefinitionTuningPromotionTracePayload, } from "./definition-tuning-promotion.js";
+import { parseAssistantWorkflowSerializedDefinition, } from "./definition-json.js";
+export const ASSISTANT_WORKFLOW_DEFINITION_TUNING_SOURCE_PATCH_SCHEMA_VERSION = 1;
+export function buildAssistantWorkflowDefinitionTuningSourcePatchArtifact(reviewArtifact, promotion = buildAssistantWorkflowDefinitionTuningPromotion(reviewArtifact), options = {}) {
+    const brief = buildAssistantWorkflowDefinitionTuningPromotionBrief(reviewArtifact, promotion);
+    const ready = promotion.status === "promotable";
+    const fromVersion = promotion.summary.fromVersion;
+    const toVersion = promotion.summary.toVersion;
+    return {
+        schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_SOURCE_PATCH_SCHEMA_VERSION,
+        generatedAt: normalizeGeneratedAt(options.generatedAt) ?? new Date().toISOString(),
+        workflowId: reviewArtifact.workflowId,
+        fromVersion,
+        toVersion,
+        status: ready ? "ready" : "blocked",
+        target: {
+            kind: "serialized_definition_file",
+            suggestedFileName: normalizeOptionalString(options.suggestedFileName) ?? `${reviewArtifact.workflowId}.workflow.json`,
+        },
+        promotion: buildAssistantWorkflowDefinitionTuningPromotionTracePayload(promotion),
+        brief: buildAssistantWorkflowDefinitionTuningPromotionBriefTracePayload(brief),
+        operations: ready
+            ? [{
+                    kind: "replace_workflow_definition",
+                    workflowId: reviewArtifact.workflowId,
+                    fromVersion,
+                    toVersion,
+                    format: "assistant_workflow_serialized_definition_json",
+                    definition: reviewArtifact.patchedDefinition,
+                }]
+            : [],
+        reasons: ready
+            ? []
+            : [{
+                    code: "promotion_not_promotable",
+                    message: "Source patch preview is blocked because the definition-tuning promotion is not promotable.",
+                    details: {
+                        promotionStatus: promotion.status,
+                        reasonCodes: promotion.reasons.map((reason) => reason.code),
+                    },
+                }],
+    };
+}
+export function buildAssistantWorkflowDefinitionTuningSourcePatchTracePayload(artifact) {
+    return {
+        schemaVersion: artifact.schemaVersion,
+        generatedAt: artifact.generatedAt,
+        workflowId: artifact.workflowId,
+        fromVersion: artifact.fromVersion,
+        toVersion: artifact.toVersion,
+        status: artifact.status,
+        target: artifact.target,
+        operationCount: artifact.operations.length,
+        operations: artifact.operations.map((operation) => ({
+            kind: operation.kind,
+            workflowId: operation.workflowId,
+            fromVersion: operation.fromVersion,
+            toVersion: operation.toVersion,
+            format: operation.format,
+            definitionSummary: operation.definition.summary,
+        })),
+        promotion: artifact.promotion,
+        brief: artifact.brief,
+        reasons: artifact.reasons.map((reason) => ({
+            code: reason.code,
+            message: reason.message,
+            details: reason.details,
+        })),
+    };
+}
+export function stringifyAssistantWorkflowDefinitionTuningSourcePatchArtifact(artifact, space) {
+    return JSON.stringify(artifact, null, space);
+}
+export function parseAssistantWorkflowDefinitionTuningSourcePatchArtifact(value) {
+    if (!isRecord(value))
+        return null;
+    if (value["schemaVersion"] !== ASSISTANT_WORKFLOW_DEFINITION_TUNING_SOURCE_PATCH_SCHEMA_VERSION)
+        return null;
+    if (typeof value["generatedAt"] !== "string" || !value["generatedAt"].trim().length)
+        return null;
+    if (typeof value["workflowId"] !== "string" || !value["workflowId"].trim().length)
+        return null;
+    if (!isNullableNumber(value["fromVersion"]))
+        return null;
+    if (!isNullableNumber(value["toVersion"]))
+        return null;
+    if (value["status"] !== "ready" && value["status"] !== "blocked")
+        return null;
+    const target = parsePatchTarget(value["target"]);
+    if (!target)
+        return null;
+    if (!isJsonRecord(value["promotion"]))
+        return null;
+    if (!isJsonRecord(value["brief"]))
+        return null;
+    if (!Array.isArray(value["operations"]))
+        return null;
+    const operations = value["operations"].map(parsePatchOperation);
+    if (operations.some((operation) => operation === null))
+        return null;
+    const reasons = parsePatchReasons(value["reasons"]);
+    if (!reasons)
+        return null;
+    return {
+        schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_SOURCE_PATCH_SCHEMA_VERSION,
+        generatedAt: value["generatedAt"],
+        workflowId: value["workflowId"],
+        fromVersion: value["fromVersion"],
+        toVersion: value["toVersion"],
+        status: value["status"],
+        target,
+        promotion: value["promotion"],
+        brief: value["brief"],
+        operations: operations.filter((operation) => operation !== null),
+        reasons,
+    };
+}
+function parsePatchTarget(value) {
+    if (!isRecord(value))
+        return null;
+    if (value["kind"] !== "serialized_definition_file")
+        return null;
+    if (!isNullableString(value["suggestedFileName"]))
+        return null;
+    return {
+        kind: "serialized_definition_file",
+        suggestedFileName: value["suggestedFileName"],
+    };
+}
+function parsePatchOperation(value) {
+    if (!isRecord(value))
+        return null;
+    if (value["kind"] !== "replace_workflow_definition")
+        return null;
+    if (typeof value["workflowId"] !== "string" || !value["workflowId"].trim().length)
+        return null;
+    if (!isNullableNumber(value["fromVersion"]))
+        return null;
+    if (!isNullableNumber(value["toVersion"]))
+        return null;
+    if (value["format"] !== "assistant_workflow_serialized_definition_json")
+        return null;
+    const definition = parseAssistantWorkflowSerializedDefinition(value["definition"]);
+    if (!definition)
+        return null;
+    return {
+        kind: "replace_workflow_definition",
+        workflowId: value["workflowId"],
+        fromVersion: value["fromVersion"],
+        toVersion: value["toVersion"],
+        format: "assistant_workflow_serialized_definition_json",
+        definition,
+    };
+}
+function parsePatchReasons(value) {
+    if (!Array.isArray(value))
+        return null;
+    const reasons = value.map((reason) => {
+        if (!isRecord(reason))
+            return null;
+        if (reason["code"] !== "promotion_not_promotable")
+            return null;
+        if (typeof reason["message"] !== "string")
+            return null;
+        if (!isJsonRecord(reason["details"]))
+            return null;
+        return {
+            code: "promotion_not_promotable",
+            message: reason["message"],
+            details: reason["details"],
+        };
+    });
+    if (reasons.some((reason) => reason === null))
+        return null;
+    return reasons.filter((reason) => reason !== null);
+}
+function normalizeGeneratedAt(value) {
+    if (!value)
+        return null;
+    const date = new Date(value);
+    return Number.isNaN(date.getTime()) ? null : date.toISOString();
+}
+function normalizeOptionalString(value) {
+    if (value === null || value === undefined)
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length ? trimmed : null;
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isJsonRecord(value) {
+    if (!isRecord(value))
+        return false;
+    return Object.values(value).every(isJsonValue);
+}
+function isJsonValue(value) {
+    if (value === null)
+        return true;
+    if (typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.every(isJsonValue);
+    return isJsonRecord(value);
+}
+function isNullableString(value) {
+    return value === null || typeof value === "string";
+}
+function isNullableNumber(value) {
+    return value === null || (typeof value === "number" && Number.isFinite(value));
+}
+//# sourceMappingURL=definition-tuning-source-patch.js.map

package/dist/definition-tuning-source-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-tuning-source-patch.js","sourceRoot":"","sources":["../src/definition-tuning-source-patch.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+CAA+C,EAC/C,oDAAoD,EACpD,gEAAgE,EAChE,2DAA2D,GAE5D,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,0CAA0C,GAE3C,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,MAAM,gEAAgE,GAAG,CAAC,CAAC;AAyClF,MAAM,UAAU,yDAAyD,CACvE,cAA+D,EAC/D,YAAwD,+CAA+C,CAAC,cAAc,CAAC,EACvH,UAA+D,EAAE;IAEjE,MAAM,KAAK,GAAG,oDAAoD,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAC9F,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,KAAK,YAAY,CAAC;IAChD,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC;IAClD,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC;IAE9C,OAAO;QACL,aAAa,EAAE,gEAAgE;QAC/E,WAAW,EAAE,oBAAoB,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAClF,UAAU,EAAE,cAAc,CAAC,UAAU;QACrC,WAAW;QACX,SAAS;QACT,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACnC,MAAM,EAAE;YACN,IAAI,EAAE,4BAA4B;YAClC,iBAAiB,EAAE,uBAAuB,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,GAAG,cAAc,CAAC,UAAU,gBAAgB;SACtH;QACD,SAAS,EAAE,2DAA2D,CAAC,SAAS,CAAC;QACjF,KAAK,EAAE,gEAAgE,CAAC,KAAK,CAAC;QAC9E,UAAU,EAAE,KAAK;YACf,CAAC,CAAC,CAAC;oBACC,IAAI,EAAE,6BAA6B;oBACnC,UAAU,EAAE,cAAc,CAAC,UAAU;oBACrC,WAAW;oBACX,SAAS;oBACT,MAAM,EAAE,+CAA+C;oBACvD,UAAU,EAAE,cAAc,CAAC,iBAAiB;iBAC7C,CAAC;YACJ,CAAC,CAAC,EAAE;QACN,OAAO,EAAE,KAAK;YACZ,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC;oBACC,IAAI,EAAE,0BAA0B;oBAChC,OAAO,EAAE,4FAA4F;oBACrG,OAAO,EAAE;wBACP,eAAe,EAAE,SAAS,CAAC,MAAM;wBACjC,WAAW,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;qBAC5D;iBACF,CAAC;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6DAA6D,CAC3E,QAA8D;IAE9D,OAAO;QACL,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,cAAc,EAAE,QAAQ,CAAC,UAAU,CAAC,MAAM;QAC1C,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAClD,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,iBAAiB,EAAE,SAAS,CAAC,UAAU,CAAC,OAAO;SAChD,CAAC,CAAC;QACH,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6DAA6D,CAC3E,QAA8D,EAC9D,KAAc;IAEd,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,yDAAyD,CACvE,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,CAAC,eAAe,CAAC,KAAK,gEAAgE;QAAE,OAAO,IAAI,CAAC;IAC7G,IAAI,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjG,IAAI,OAAO,KAAK,CAAC,YAAY,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/F,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9E,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,OAAO;QACL,aAAa,EAAE,gEAAgE;QAC/E,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC;QACjC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC;QAC/B,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC;QACjC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC;QAC7B,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;QACvB,MAAM;QACN,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC;QAC7B,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;QACrB,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAsE,EAAE,CAC9G,SAAS,KAAK,IAAI,CACnB;QACD,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,4BAA4B;QAAE,OAAO,IAAI,CAAC;IAChE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO;QACL,IAAI,EAAE,4BAA4B;QAClC,iBAAiB,EAAE,KAAK,CAAC,mBAAmB,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,6BAA6B;QAAE,OAAO,IAAI,CAAC;IACjE,IAAI,OAAO,KAAK,CAAC,YAAY,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/F,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,+CAA+C;QAAE,OAAO,IAAI,CAAC;IACrF,MAAM,UAAU,GAAG,0CAA0C,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IACnF,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO;QACL,IAAI,EAAE,6BAA6B;QACnC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC;QAC/B,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC;QACjC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC;QAC7B,MAAM,EAAE,+CAA+C;QACvD,UAAU;KACX,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAc;IAEd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACnC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,0BAA0B;YAAE,OAAO,IAAI,CAAC;QAC/D,IAAI,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACvD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAClD,OAAO;YACL,IAAI,EAAE,0BAAmC;YACzC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;YAC1B,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAqF,EAAE,CAClH,MAAM,KAAK,IAAI,CAChB,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAyB;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAgC;IAC/D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACzE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1D,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACjF,CAAC","sourcesContent":["import {\n  buildAssistantWorkflowDefinitionTuningPromotion,\n  buildAssistantWorkflowDefinitionTuningPromotionBrief,\n  buildAssistantWorkflowDefinitionTuningPromotionBriefTracePayload,\n  buildAssistantWorkflowDefinitionTuningPromotionTracePayload,\n  type AssistantWorkflowDefinitionTuningPromotion,\n} from \"./definition-tuning-promotion.js\";\nimport type { AssistantWorkflowDefinitionTuningReviewArtifact } from \"./definition-tuning-review-artifact.js\";\nimport {\n  parseAssistantWorkflowSerializedDefinition,\n  type AssistantWorkflowSerializedDefinition,\n} from \"./definition-json.js\";\nimport type { AssistantWorkflowJsonValue } from \"./run-report-json.js\";\n\nexport const ASSISTANT_WORKFLOW_DEFINITION_TUNING_SOURCE_PATCH_SCHEMA_VERSION = 1;\n\nexport type AssistantWorkflowDefinitionTuningSourcePatchStatus =\n  | \"ready\"\n  | \"blocked\";\n\nexport type AssistantWorkflowDefinitionTuningSourcePatchOperation = {\n  kind: \"replace_workflow_definition\";\n  workflowId: string;\n  fromVersion: number | null;\n  toVersion: number | null;\n  format: \"assistant_workflow_serialized_definition_json\";\n  definition: AssistantWorkflowSerializedDefinition;\n};\n\nexport type AssistantWorkflowDefinitionTuningSourcePatchArtifact = {\n  schemaVersion: typeof ASSISTANT_WORKFLOW_DEFINITION_TUNING_SOURCE_PATCH_SCHEMA_VERSION;\n  generatedAt: string;\n  workflowId: string;\n  fromVersion: number | null;\n  toVersion: number | null;\n  status: AssistantWorkflowDefinitionTuningSourcePatchStatus;\n  target: {\n    kind: \"serialized_definition_file\";\n    suggestedFileName: string | null;\n  };\n  promotion: Record<string, AssistantWorkflowJsonValue>;\n  brief: Record<string, AssistantWorkflowJsonValue>;\n  operations: AssistantWorkflowDefinitionTuningSourcePatchOperation[];\n  reasons: {\n    code: \"promotion_not_promotable\";\n    message: string;\n    details: Record<string, AssistantWorkflowJsonValue>;\n  }[];\n};\n\nexport type AssistantWorkflowDefinitionTuningSourcePatchOptions = {\n  generatedAt?: string;\n  suggestedFileName?: string | null;\n};\n\nexport function buildAssistantWorkflowDefinitionTuningSourcePatchArtifact(\n  reviewArtifact: AssistantWorkflowDefinitionTuningReviewArtifact,\n  promotion: AssistantWorkflowDefinitionTuningPromotion = buildAssistantWorkflowDefinitionTuningPromotion(reviewArtifact),\n  options: AssistantWorkflowDefinitionTuningSourcePatchOptions = {},\n): AssistantWorkflowDefinitionTuningSourcePatchArtifact {\n  const brief = buildAssistantWorkflowDefinitionTuningPromotionBrief(reviewArtifact, promotion);\n  const ready = promotion.status === \"promotable\";\n  const fromVersion = promotion.summary.fromVersion;\n  const toVersion = promotion.summary.toVersion;\n\n  return {\n    schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_SOURCE_PATCH_SCHEMA_VERSION,\n    generatedAt: normalizeGeneratedAt(options.generatedAt) ?? new Date().toISOString(),\n    workflowId: reviewArtifact.workflowId,\n    fromVersion,\n    toVersion,\n    status: ready ? \"ready\" : \"blocked\",\n    target: {\n      kind: \"serialized_definition_file\",\n      suggestedFileName: normalizeOptionalString(options.suggestedFileName) ?? `${reviewArtifact.workflowId}.workflow.json`,\n    },\n    promotion: buildAssistantWorkflowDefinitionTuningPromotionTracePayload(promotion),\n    brief: buildAssistantWorkflowDefinitionTuningPromotionBriefTracePayload(brief),\n    operations: ready\n      ? [{\n          kind: \"replace_workflow_definition\",\n          workflowId: reviewArtifact.workflowId,\n          fromVersion,\n          toVersion,\n          format: \"assistant_workflow_serialized_definition_json\",\n          definition: reviewArtifact.patchedDefinition,\n        }]\n      : [],\n    reasons: ready\n      ? []\n      : [{\n          code: \"promotion_not_promotable\",\n          message: \"Source patch preview is blocked because the definition-tuning promotion is not promotable.\",\n          details: {\n            promotionStatus: promotion.status,\n            reasonCodes: promotion.reasons.map((reason) => reason.code),\n          },\n        }],\n  };\n}\n\nexport function buildAssistantWorkflowDefinitionTuningSourcePatchTracePayload(\n  artifact: AssistantWorkflowDefinitionTuningSourcePatchArtifact,\n): Record<string, AssistantWorkflowJsonValue> {\n  return {\n    schemaVersion: artifact.schemaVersion,\n    generatedAt: artifact.generatedAt,\n    workflowId: artifact.workflowId,\n    fromVersion: artifact.fromVersion,\n    toVersion: artifact.toVersion,\n    status: artifact.status,\n    target: artifact.target,\n    operationCount: artifact.operations.length,\n    operations: artifact.operations.map((operation) => ({\n      kind: operation.kind,\n      workflowId: operation.workflowId,\n      fromVersion: operation.fromVersion,\n      toVersion: operation.toVersion,\n      format: operation.format,\n      definitionSummary: operation.definition.summary,\n    })),\n    promotion: artifact.promotion,\n    brief: artifact.brief,\n    reasons: artifact.reasons.map((reason) => ({\n      code: reason.code,\n      message: reason.message,\n      details: reason.details,\n    })),\n  };\n}\n\nexport function stringifyAssistantWorkflowDefinitionTuningSourcePatchArtifact(\n  artifact: AssistantWorkflowDefinitionTuningSourcePatchArtifact,\n  space?: number,\n): string {\n  return JSON.stringify(artifact, null, space);\n}\n\nexport function parseAssistantWorkflowDefinitionTuningSourcePatchArtifact(\n  value: unknown,\n): AssistantWorkflowDefinitionTuningSourcePatchArtifact | null {\n  if (!isRecord(value)) return null;\n  if (value[\"schemaVersion\"] !== ASSISTANT_WORKFLOW_DEFINITION_TUNING_SOURCE_PATCH_SCHEMA_VERSION) return null;\n  if (typeof value[\"generatedAt\"] !== \"string\" || !value[\"generatedAt\"].trim().length) return null;\n  if (typeof value[\"workflowId\"] !== \"string\" || !value[\"workflowId\"].trim().length) return null;\n  if (!isNullableNumber(value[\"fromVersion\"])) return null;\n  if (!isNullableNumber(value[\"toVersion\"])) return null;\n  if (value[\"status\"] !== \"ready\" && value[\"status\"] !== \"blocked\") return null;\n  const target = parsePatchTarget(value[\"target\"]);\n  if (!target) return null;\n  if (!isJsonRecord(value[\"promotion\"])) return null;\n  if (!isJsonRecord(value[\"brief\"])) return null;\n  if (!Array.isArray(value[\"operations\"])) return null;\n  const operations = value[\"operations\"].map(parsePatchOperation);\n  if (operations.some((operation) => operation === null)) return null;\n  const reasons = parsePatchReasons(value[\"reasons\"]);\n  if (!reasons) return null;\n\n  return {\n    schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_SOURCE_PATCH_SCHEMA_VERSION,\n    generatedAt: value[\"generatedAt\"],\n    workflowId: value[\"workflowId\"],\n    fromVersion: value[\"fromVersion\"],\n    toVersion: value[\"toVersion\"],\n    status: value[\"status\"],\n    target,\n    promotion: value[\"promotion\"],\n    brief: value[\"brief\"],\n    operations: operations.filter((operation): operation is AssistantWorkflowDefinitionTuningSourcePatchOperation =>\n      operation !== null\n    ),\n    reasons,\n  };\n}\n\nfunction parsePatchTarget(value: unknown): AssistantWorkflowDefinitionTuningSourcePatchArtifact[\"target\"] | null {\n  if (!isRecord(value)) return null;\n  if (value[\"kind\"] !== \"serialized_definition_file\") return null;\n  if (!isNullableString(value[\"suggestedFileName\"])) return null;\n  return {\n    kind: \"serialized_definition_file\",\n    suggestedFileName: value[\"suggestedFileName\"],\n  };\n}\n\nfunction parsePatchOperation(value: unknown): AssistantWorkflowDefinitionTuningSourcePatchOperation | null {\n  if (!isRecord(value)) return null;\n  if (value[\"kind\"] !== \"replace_workflow_definition\") return null;\n  if (typeof value[\"workflowId\"] !== \"string\" || !value[\"workflowId\"].trim().length) return null;\n  if (!isNullableNumber(value[\"fromVersion\"])) return null;\n  if (!isNullableNumber(value[\"toVersion\"])) return null;\n  if (value[\"format\"] !== \"assistant_workflow_serialized_definition_json\") return null;\n  const definition = parseAssistantWorkflowSerializedDefinition(value[\"definition\"]);\n  if (!definition) return null;\n  return {\n    kind: \"replace_workflow_definition\",\n    workflowId: value[\"workflowId\"],\n    fromVersion: value[\"fromVersion\"],\n    toVersion: value[\"toVersion\"],\n    format: \"assistant_workflow_serialized_definition_json\",\n    definition,\n  };\n}\n\nfunction parsePatchReasons(\n  value: unknown,\n): AssistantWorkflowDefinitionTuningSourcePatchArtifact[\"reasons\"] | null {\n  if (!Array.isArray(value)) return null;\n  const reasons = value.map((reason) => {\n    if (!isRecord(reason)) return null;\n    if (reason[\"code\"] !== \"promotion_not_promotable\") return null;\n    if (typeof reason[\"message\"] !== \"string\") return null;\n    if (!isJsonRecord(reason[\"details\"])) return null;\n    return {\n      code: \"promotion_not_promotable\" as const,\n      message: reason[\"message\"],\n      details: reason[\"details\"],\n    };\n  });\n  if (reasons.some((reason) => reason === null)) return null;\n  return reasons.filter((reason): reason is AssistantWorkflowDefinitionTuningSourcePatchArtifact[\"reasons\"][number] =>\n    reason !== null\n  );\n}\n\nfunction normalizeGeneratedAt(value: string | undefined): string | null {\n  if (!value) return null;\n  const date = new Date(value);\n  return Number.isNaN(date.getTime()) ? null : date.toISOString();\n}\n\nfunction normalizeOptionalString(value: string | null | undefined): string | null {\n  if (value === null || value === undefined) 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 !!value && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction isJsonRecord(value: unknown): value is Record<string, AssistantWorkflowJsonValue> {\n  if (!isRecord(value)) return false;\n  return Object.values(value).every(isJsonValue);\n}\n\nfunction isJsonValue(value: unknown): value is AssistantWorkflowJsonValue {\n  if (value === null) return true;\n  if (typeof value === \"string\" || typeof value === \"boolean\") return true;\n  if (typeof value === \"number\") return Number.isFinite(value);\n  if (Array.isArray(value)) return value.every(isJsonValue);\n  return isJsonRecord(value);\n}\n\nfunction isNullableString(value: unknown): value is string | null {\n  return value === null || typeof value === \"string\";\n}\n\nfunction isNullableNumber(value: unknown): value is number | null {\n  return value === null || (typeof value === \"number\" && Number.isFinite(value));\n}\n"]}