@uns-kit/assistant-workflow 2.0.72

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition-tuning-approval.d.ts","sourceRoot":"","sources":["../src/definition-tuning-approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+CAA+C,EAAE,MAAM,wCAAwC,CAAC;AAC9G,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,eAAO,MAAM,4DAA4D,IAAI,CAAC;AAE9E,MAAM,MAAM,qDAAqD,GAC7D,SAAS,GACT,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,MAAM,iDAAiD,GAAG;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,qDAAqD,CAAC;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iDAAiD,GAAG;IAC9D,aAAa,EAAE,OAAO,4DAA4D,CAAC;IACnF,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,+BAA+B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,SAAS,EAAE,iDAAiD,EAAE,CAAC;CAChE,CAAC;AAEF,MAAM,MAAM,wDAAwD,GAAG;IACrE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,+BAA+B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,wDAAwD,GAClE,IAAI,CACF,wDAAwD,EACxD,YAAY,GAAG,iBAAiB,GAAG,iCAAiC,CACrE,GAAG;IACF,eAAe,CAAC,EAAE,qDAAqD,CAAC;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEJ,wBAAgB,sDAAsD,CACpE,SAAS,EAAE,SAAS,iDAAiD,EAAE,EACvE,OAAO,GAAE,wDAA6D,GACrE,iDAAiD,CASnD;AAED,wBAAgB,gEAAgE,CAC9E,cAAc,EAAE,+CAA+C,EAC/D,SAAS,EAAE,SAAS,iDAAiD,EAAE,EACvE,OAAO,GAAE,IAAI,CACX,wDAAwD,EACxD,YAAY,GAAG,iBAAiB,GAAG,iCAAiC,CAChE,GACL,iDAAiD,CAOnD;AAED,wBAAgB,gEAAgE,CAC9E,cAAc,EAAE,+CAA+C,EAC/D,OAAO,GAAE,wDAA6D,GACrE,iDAAiD,CAsBnD;AAED,wBAAgB,0DAA0D,CACxE,QAAQ,EAAE,iDAAiD,GAC1D,MAAM,EAAE,CAIV;AAED,wBAAgB,0DAA0D,CACxE,QAAQ,EAAE,iDAAiD,GAC1D,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CA8B5C;AAED,wBAAgB,0DAA0D,CACxE,QAAQ,EAAE,iDAAiD,EAC3D,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAER;AAED,wBAAgB,sDAAsD,CACpE,KAAK,EAAE,OAAO,GACb,iDAAiD,GAAG,IAAI,CAqB1D"}

package/dist/definition-tuning-approval.js

@@ -0,0 +1,207 @@
+export const ASSISTANT_WORKFLOW_DEFINITION_TUNING_APPROVAL_SCHEMA_VERSION = 1;
+export function buildAssistantWorkflowDefinitionTuningApprovalArtifact(decisions, options = {}) {
+    return {
+        schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_APPROVAL_SCHEMA_VERSION,
+        generatedAt: normalizeGeneratedAt(options.generatedAt) ?? new Date().toISOString(),
+        workflowId: normalizeOptionalString(options.workflowId),
+        workflowVersion: normalizeOptionalNumber(options.workflowVersion),
+        sourceReviewArtifactGeneratedAt: normalizeOptionalString(options.sourceReviewArtifactGeneratedAt),
+        decisions: normalizeApprovalDecisions(decisions),
+    };
+}
+export function buildAssistantWorkflowDefinitionTuningApprovalArtifactFromReview(reviewArtifact, decisions, options = {}) {
+    return buildAssistantWorkflowDefinitionTuningApprovalArtifact(decisions, {
+        ...options,
+        workflowId: reviewArtifact.workflowId,
+        workflowVersion: reviewArtifact.workflowVersion,
+        sourceReviewArtifactGeneratedAt: reviewArtifact.generatedAt,
+    });
+}
+export function buildAssistantWorkflowDefinitionTuningApprovalTemplateFromReview(reviewArtifact, options = {}) {
+    const defaultDecision = isApprovalDecisionKind(options.defaultDecision)
+        ? options.defaultDecision
+        : "pending";
+    const decidedAt = normalizeGeneratedAt(options.decidedAt);
+    const decisions = reviewArtifact.suggestions.applied.map((suggestion) => {
+        const reviewNote = buildSuggestionReviewNote(reviewArtifact, suggestion);
+        return {
+            suggestionId: suggestion.id,
+            decision: defaultDecision,
+            ...(options.note?.trim() ? { note: options.note.trim() } : reviewNote ? { note: reviewNote } : {}),
+            ...(options.decidedBy?.trim() ? { decidedBy: options.decidedBy.trim() } : {}),
+            ...(decidedAt ? { decidedAt } : {}),
+        };
+    });
+    return buildAssistantWorkflowDefinitionTuningApprovalArtifactFromReview(reviewArtifact, decisions, options.generatedAt ? { generatedAt: options.generatedAt } : {});
+}
+export function readApprovedAssistantWorkflowDefinitionTuningSuggestionIds(artifact) {
+    return artifact.decisions
+        .filter((decision) => decision.decision === "approved")
+        .map((decision) => decision.suggestionId);
+}
+export function buildAssistantWorkflowDefinitionTuningApprovalTracePayload(artifact) {
+    const approvedSuggestionIds = readApprovedAssistantWorkflowDefinitionTuningSuggestionIds(artifact);
+    const rejectedSuggestionIds = artifact.decisions
+        .filter((decision) => decision.decision === "rejected")
+        .map((decision) => decision.suggestionId);
+    const pendingSuggestionIds = artifact.decisions
+        .filter((decision) => decision.decision === "pending")
+        .map((decision) => decision.suggestionId);
+    return {
+        schemaVersion: artifact.schemaVersion,
+        generatedAt: artifact.generatedAt,
+        workflowId: artifact.workflowId,
+        workflowVersion: artifact.workflowVersion,
+        sourceReviewArtifactGeneratedAt: artifact.sourceReviewArtifactGeneratedAt,
+        decisionCount: artifact.decisions.length,
+        approvedCount: approvedSuggestionIds.length,
+        rejectedCount: rejectedSuggestionIds.length,
+        pendingCount: pendingSuggestionIds.length,
+        approvedSuggestionIds,
+        rejectedSuggestionIds,
+        pendingSuggestionIds,
+        decisions: artifact.decisions.map((decision) => ({
+            suggestionId: decision.suggestionId,
+            decision: decision.decision,
+            note: decision.note ?? null,
+            decidedBy: decision.decidedBy ?? null,
+            decidedAt: decision.decidedAt ?? null,
+        })),
+    };
+}
+export function stringifyAssistantWorkflowDefinitionTuningApprovalArtifact(artifact, space) {
+    return JSON.stringify(artifact, null, space);
+}
+export function parseAssistantWorkflowDefinitionTuningApprovalArtifact(value) {
+    if (!isRecord(value))
+        return null;
+    if (value["schemaVersion"] !== ASSISTANT_WORKFLOW_DEFINITION_TUNING_APPROVAL_SCHEMA_VERSION)
+        return null;
+    if (typeof value["generatedAt"] !== "string" || !value["generatedAt"].trim().length)
+        return null;
+    if (!isNullableString(value["workflowId"]))
+        return null;
+    if (!isNullableNumber(value["workflowVersion"]))
+        return null;
+    if (!isNullableString(value["sourceReviewArtifactGeneratedAt"]))
+        return null;
+    if (!Array.isArray(value["decisions"]))
+        return null;
+    const decisions = value["decisions"].map(parseApprovalDecision);
+    if (decisions.some((decision) => decision === null))
+        return null;
+    return {
+        schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_APPROVAL_SCHEMA_VERSION,
+        generatedAt: value["generatedAt"],
+        workflowId: value["workflowId"],
+        workflowVersion: value["workflowVersion"],
+        sourceReviewArtifactGeneratedAt: value["sourceReviewArtifactGeneratedAt"],
+        decisions: decisions.filter((decision) => decision !== null),
+    };
+}
+function normalizeApprovalDecisions(decisions) {
+    const bySuggestionId = new Map();
+    for (const decision of decisions) {
+        const suggestionId = normalizeRequiredString(decision.suggestionId);
+        if (!suggestionId)
+            continue;
+        const decidedAt = normalizeGeneratedAt(decision.decidedAt);
+        bySuggestionId.set(suggestionId, {
+            suggestionId,
+            decision: decision.decision,
+            ...(decision.note?.trim() ? { note: decision.note.trim() } : {}),
+            ...(decision.decidedBy?.trim() ? { decidedBy: decision.decidedBy.trim() } : {}),
+            ...(decidedAt ? { decidedAt } : {}),
+        });
+    }
+    return [...bySuggestionId.values()].sort((left, right) => left.suggestionId.localeCompare(right.suggestionId));
+}
+function parseApprovalDecision(value) {
+    if (!isRecord(value))
+        return null;
+    if (typeof value["suggestionId"] !== "string" || !value["suggestionId"].trim().length)
+        return null;
+    if (!isApprovalDecisionKind(value["decision"]))
+        return null;
+    if (value["note"] !== undefined && typeof value["note"] !== "string")
+        return null;
+    if (value["decidedBy"] !== undefined && typeof value["decidedBy"] !== "string")
+        return null;
+    if (value["decidedAt"] !== undefined && typeof value["decidedAt"] !== "string")
+        return null;
+    return {
+        suggestionId: value["suggestionId"],
+        decision: value["decision"],
+        ...(value["note"] ? { note: value["note"] } : {}),
+        ...(value["decidedBy"] ? { decidedBy: value["decidedBy"] } : {}),
+        ...(value["decidedAt"] ? { decidedAt: value["decidedAt"] } : {}),
+    };
+}
+function buildSuggestionReviewNote(artifact, suggestion) {
+    const reasons = Array.isArray(artifact.review["reasons"]) ? artifact.review["reasons"] : [];
+    const matchingReason = reasons.find((reason) => isMatchingSuggestionReviewReason(reason, suggestion));
+    if (matchingReason && isRecord(matchingReason) && typeof matchingReason["code"] === "string") {
+        return `Review required: ${matchingReason["code"]}.`;
+    }
+    const deferredSignals = readDeferredReviewSignalsForSuggestion(artifact, suggestion);
+    if (deferredSignals.length > 0) {
+        return `Review required: deferred_review_signals (${deferredSignals.join(", ")}).`;
+    }
+    return "Pending semantic review.";
+}
+function readDeferredReviewSignalsForSuggestion(artifact, suggestion) {
+    if (!suggestion.intentId)
+        return [];
+    return uniqueStrings(artifact.suggestions.reviewOnly
+        .filter((reviewOnly) => reviewOnly.intentId === suggestion.intentId)
+        .map((reviewOnly) => reviewOnly.signal ?? reviewOnly.action));
+}
+function isMatchingSuggestionReviewReason(value, suggestion) {
+    if (!isRecord(value) || !isRecord(value["details"]))
+        return false;
+    const details = value["details"];
+    const intentMatches = typeof details["intentId"] !== "string" || details["intentId"] === suggestion.intentId;
+    const toolMatches = typeof details["toolName"] !== "string" || details["toolName"] === suggestion.toolName;
+    return intentMatches && toolMatches;
+}
+function isApprovalDecisionKind(value) {
+    return value === "pending" || value === "approved" || value === "rejected";
+}
+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 normalizeOptionalNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function normalizeRequiredString(value) {
+    const trimmed = value.trim();
+    return trimmed.length ? trimmed : null;
+}
+function uniqueStrings(values) {
+    const out = [];
+    for (const value of values) {
+        if (!value.length || out.includes(value))
+            continue;
+        out.push(value);
+    }
+    return out.sort((left, right) => left.localeCompare(right));
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(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-approval.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition-tuning-approval.js","sourceRoot":"","sources":["../src/definition-tuning-approval.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantWorkflowDefinitionTuningReviewArtifact } from \"./definition-tuning-review-artifact.js\";\nimport type { AssistantWorkflowJsonValue } from \"./run-report-json.js\";\n\nexport const ASSISTANT_WORKFLOW_DEFINITION_TUNING_APPROVAL_SCHEMA_VERSION = 1;\n\nexport type AssistantWorkflowDefinitionTuningApprovalDecisionKind =\n  | \"pending\"\n  | \"approved\"\n  | \"rejected\";\n\nexport type AssistantWorkflowDefinitionTuningApprovalDecision = {\n  suggestionId: string;\n  decision: AssistantWorkflowDefinitionTuningApprovalDecisionKind;\n  note?: string;\n  decidedBy?: string;\n  decidedAt?: string;\n};\n\nexport type AssistantWorkflowDefinitionTuningApprovalArtifact = {\n  schemaVersion: typeof ASSISTANT_WORKFLOW_DEFINITION_TUNING_APPROVAL_SCHEMA_VERSION;\n  generatedAt: string;\n  workflowId: string | null;\n  workflowVersion: number | null;\n  sourceReviewArtifactGeneratedAt: string | null;\n  decisions: AssistantWorkflowDefinitionTuningApprovalDecision[];\n};\n\nexport type AssistantWorkflowDefinitionTuningApprovalArtifactOptions = {\n  workflowId?: string | null;\n  workflowVersion?: number | null;\n  sourceReviewArtifactGeneratedAt?: string | null;\n  generatedAt?: string;\n};\n\nexport type AssistantWorkflowDefinitionTuningApprovalTemplateOptions =\n  Omit<\n    AssistantWorkflowDefinitionTuningApprovalArtifactOptions,\n    \"workflowId\" | \"workflowVersion\" | \"sourceReviewArtifactGeneratedAt\"\n  > & {\n    defaultDecision?: AssistantWorkflowDefinitionTuningApprovalDecisionKind;\n    decidedBy?: string;\n    decidedAt?: string;\n    note?: string;\n  };\n\nexport function buildAssistantWorkflowDefinitionTuningApprovalArtifact(\n  decisions: readonly AssistantWorkflowDefinitionTuningApprovalDecision[],\n  options: AssistantWorkflowDefinitionTuningApprovalArtifactOptions = {},\n): AssistantWorkflowDefinitionTuningApprovalArtifact {\n  return {\n    schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_APPROVAL_SCHEMA_VERSION,\n    generatedAt: normalizeGeneratedAt(options.generatedAt) ?? new Date().toISOString(),\n    workflowId: normalizeOptionalString(options.workflowId),\n    workflowVersion: normalizeOptionalNumber(options.workflowVersion),\n    sourceReviewArtifactGeneratedAt: normalizeOptionalString(options.sourceReviewArtifactGeneratedAt),\n    decisions: normalizeApprovalDecisions(decisions),\n  };\n}\n\nexport function buildAssistantWorkflowDefinitionTuningApprovalArtifactFromReview(\n  reviewArtifact: AssistantWorkflowDefinitionTuningReviewArtifact,\n  decisions: readonly AssistantWorkflowDefinitionTuningApprovalDecision[],\n  options: Omit<\n    AssistantWorkflowDefinitionTuningApprovalArtifactOptions,\n    \"workflowId\" | \"workflowVersion\" | \"sourceReviewArtifactGeneratedAt\"\n  > = {},\n): AssistantWorkflowDefinitionTuningApprovalArtifact {\n  return buildAssistantWorkflowDefinitionTuningApprovalArtifact(decisions, {\n    ...options,\n    workflowId: reviewArtifact.workflowId,\n    workflowVersion: reviewArtifact.workflowVersion,\n    sourceReviewArtifactGeneratedAt: reviewArtifact.generatedAt,\n  });\n}\n\nexport function buildAssistantWorkflowDefinitionTuningApprovalTemplateFromReview(\n  reviewArtifact: AssistantWorkflowDefinitionTuningReviewArtifact,\n  options: AssistantWorkflowDefinitionTuningApprovalTemplateOptions = {},\n): AssistantWorkflowDefinitionTuningApprovalArtifact {\n  const defaultDecision = isApprovalDecisionKind(options.defaultDecision)\n    ? options.defaultDecision\n    : \"pending\";\n  const decidedAt = normalizeGeneratedAt(options.decidedAt);\n  const decisions = reviewArtifact.suggestions.applied.map((suggestion) => {\n    const reviewNote = buildSuggestionReviewNote(reviewArtifact, suggestion);\n\n    return {\n      suggestionId: suggestion.id,\n      decision: defaultDecision,\n      ...(options.note?.trim() ? { note: options.note.trim() } : reviewNote ? { note: reviewNote } : {}),\n      ...(options.decidedBy?.trim() ? { decidedBy: options.decidedBy.trim() } : {}),\n      ...(decidedAt ? { decidedAt } : {}),\n    };\n  });\n\n  return buildAssistantWorkflowDefinitionTuningApprovalArtifactFromReview(\n    reviewArtifact,\n    decisions,\n    options.generatedAt ? { generatedAt: options.generatedAt } : {},\n  );\n}\n\nexport function readApprovedAssistantWorkflowDefinitionTuningSuggestionIds(\n  artifact: AssistantWorkflowDefinitionTuningApprovalArtifact,\n): string[] {\n  return artifact.decisions\n    .filter((decision) => decision.decision === \"approved\")\n    .map((decision) => decision.suggestionId);\n}\n\nexport function buildAssistantWorkflowDefinitionTuningApprovalTracePayload(\n  artifact: AssistantWorkflowDefinitionTuningApprovalArtifact,\n): Record<string, AssistantWorkflowJsonValue> {\n  const approvedSuggestionIds = readApprovedAssistantWorkflowDefinitionTuningSuggestionIds(artifact);\n  const rejectedSuggestionIds = artifact.decisions\n    .filter((decision) => decision.decision === \"rejected\")\n    .map((decision) => decision.suggestionId);\n  const pendingSuggestionIds = artifact.decisions\n    .filter((decision) => decision.decision === \"pending\")\n    .map((decision) => decision.suggestionId);\n\n  return {\n    schemaVersion: artifact.schemaVersion,\n    generatedAt: artifact.generatedAt,\n    workflowId: artifact.workflowId,\n    workflowVersion: artifact.workflowVersion,\n    sourceReviewArtifactGeneratedAt: artifact.sourceReviewArtifactGeneratedAt,\n    decisionCount: artifact.decisions.length,\n    approvedCount: approvedSuggestionIds.length,\n    rejectedCount: rejectedSuggestionIds.length,\n    pendingCount: pendingSuggestionIds.length,\n    approvedSuggestionIds,\n    rejectedSuggestionIds,\n    pendingSuggestionIds,\n    decisions: artifact.decisions.map((decision) => ({\n      suggestionId: decision.suggestionId,\n      decision: decision.decision,\n      note: decision.note ?? null,\n      decidedBy: decision.decidedBy ?? null,\n      decidedAt: decision.decidedAt ?? null,\n    })),\n  };\n}\n\nexport function stringifyAssistantWorkflowDefinitionTuningApprovalArtifact(\n  artifact: AssistantWorkflowDefinitionTuningApprovalArtifact,\n  space?: number,\n): string {\n  return JSON.stringify(artifact, null, space);\n}\n\nexport function parseAssistantWorkflowDefinitionTuningApprovalArtifact(\n  value: unknown,\n): AssistantWorkflowDefinitionTuningApprovalArtifact | null {\n  if (!isRecord(value)) return null;\n  if (value[\"schemaVersion\"] !== ASSISTANT_WORKFLOW_DEFINITION_TUNING_APPROVAL_SCHEMA_VERSION) return null;\n  if (typeof value[\"generatedAt\"] !== \"string\" || !value[\"generatedAt\"].trim().length) return null;\n  if (!isNullableString(value[\"workflowId\"])) return null;\n  if (!isNullableNumber(value[\"workflowVersion\"])) return null;\n  if (!isNullableString(value[\"sourceReviewArtifactGeneratedAt\"])) return null;\n  if (!Array.isArray(value[\"decisions\"])) return null;\n  const decisions = value[\"decisions\"].map(parseApprovalDecision);\n  if (decisions.some((decision) => decision === null)) return null;\n\n  return {\n    schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_APPROVAL_SCHEMA_VERSION,\n    generatedAt: value[\"generatedAt\"],\n    workflowId: value[\"workflowId\"],\n    workflowVersion: value[\"workflowVersion\"],\n    sourceReviewArtifactGeneratedAt: value[\"sourceReviewArtifactGeneratedAt\"],\n    decisions: decisions.filter((decision): decision is AssistantWorkflowDefinitionTuningApprovalDecision =>\n      decision !== null\n    ),\n  };\n}\n\nfunction normalizeApprovalDecisions(\n  decisions: readonly AssistantWorkflowDefinitionTuningApprovalDecision[],\n): AssistantWorkflowDefinitionTuningApprovalDecision[] {\n  const bySuggestionId = new Map<string, AssistantWorkflowDefinitionTuningApprovalDecision>();\n  for (const decision of decisions) {\n    const suggestionId = normalizeRequiredString(decision.suggestionId);\n    if (!suggestionId) continue;\n    const decidedAt = normalizeGeneratedAt(decision.decidedAt);\n    bySuggestionId.set(suggestionId, {\n      suggestionId,\n      decision: decision.decision,\n      ...(decision.note?.trim() ? { note: decision.note.trim() } : {}),\n      ...(decision.decidedBy?.trim() ? { decidedBy: decision.decidedBy.trim() } : {}),\n      ...(decidedAt ? { decidedAt } : {}),\n    });\n  }\n  return [...bySuggestionId.values()].sort((left, right) => left.suggestionId.localeCompare(right.suggestionId));\n}\n\nfunction parseApprovalDecision(value: unknown): AssistantWorkflowDefinitionTuningApprovalDecision | null {\n  if (!isRecord(value)) return null;\n  if (typeof value[\"suggestionId\"] !== \"string\" || !value[\"suggestionId\"].trim().length) return null;\n  if (!isApprovalDecisionKind(value[\"decision\"])) return null;\n  if (value[\"note\"] !== undefined && typeof value[\"note\"] !== \"string\") return null;\n  if (value[\"decidedBy\"] !== undefined && typeof value[\"decidedBy\"] !== \"string\") return null;\n  if (value[\"decidedAt\"] !== undefined && typeof value[\"decidedAt\"] !== \"string\") return null;\n\n  return {\n    suggestionId: value[\"suggestionId\"],\n    decision: value[\"decision\"],\n    ...(value[\"note\"] ? { note: value[\"note\"] } : {}),\n    ...(value[\"decidedBy\"] ? { decidedBy: value[\"decidedBy\"] } : {}),\n    ...(value[\"decidedAt\"] ? { decidedAt: value[\"decidedAt\"] } : {}),\n  };\n}\n\nfunction buildSuggestionReviewNote(\n  artifact: AssistantWorkflowDefinitionTuningReviewArtifact,\n  suggestion: AssistantWorkflowDefinitionTuningReviewArtifact[\"suggestions\"][\"applied\"][number],\n): string | null {\n  const reasons = Array.isArray(artifact.review[\"reasons\"]) ? artifact.review[\"reasons\"] : [];\n  const matchingReason = reasons.find((reason) => isMatchingSuggestionReviewReason(reason, suggestion));\n  if (matchingReason && isRecord(matchingReason) && typeof matchingReason[\"code\"] === \"string\") {\n    return `Review required: ${matchingReason[\"code\"]}.`;\n  }\n  const deferredSignals = readDeferredReviewSignalsForSuggestion(artifact, suggestion);\n  if (deferredSignals.length > 0) {\n    return `Review required: deferred_review_signals (${deferredSignals.join(\", \")}).`;\n  }\n  return \"Pending semantic review.\";\n}\n\nfunction readDeferredReviewSignalsForSuggestion(\n  artifact: AssistantWorkflowDefinitionTuningReviewArtifact,\n  suggestion: AssistantWorkflowDefinitionTuningReviewArtifact[\"suggestions\"][\"applied\"][number],\n): string[] {\n  if (!suggestion.intentId) return [];\n  return uniqueStrings(\n    artifact.suggestions.reviewOnly\n      .filter((reviewOnly) => reviewOnly.intentId === suggestion.intentId)\n      .map((reviewOnly) => reviewOnly.signal ?? reviewOnly.action),\n  );\n}\n\nfunction isMatchingSuggestionReviewReason(\n  value: unknown,\n  suggestion: AssistantWorkflowDefinitionTuningReviewArtifact[\"suggestions\"][\"applied\"][number],\n): boolean {\n  if (!isRecord(value) || !isRecord(value[\"details\"])) return false;\n  const details = value[\"details\"];\n  const intentMatches = typeof details[\"intentId\"] !== \"string\" || details[\"intentId\"] === suggestion.intentId;\n  const toolMatches = typeof details[\"toolName\"] !== \"string\" || details[\"toolName\"] === suggestion.toolName;\n  return intentMatches && toolMatches;\n}\n\nfunction isApprovalDecisionKind(value: unknown): value is AssistantWorkflowDefinitionTuningApprovalDecisionKind {\n  return value === \"pending\" || value === \"approved\" || value === \"rejected\";\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 normalizeOptionalNumber(value: number | null | undefined): number | null {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : null;\n}\n\nfunction normalizeRequiredString(value: string): string | null {\n  const trimmed = value.trim();\n  return trimmed.length ? trimmed : null;\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.sort((left, right) => left.localeCompare(right));\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === \"object\" && !Array.isArray(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"]}

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

@@ -0,0 +1,58 @@
+import type { AssistantWorkflowDefinitionTuningSuggestion } from "./definition-tuning.js";
+export declare const ASSISTANT_WORKFLOW_DEFINITION_TUNING_JSON_SCHEMA_VERSION = 1;
+export type AssistantWorkflowSerializedDefinitionTuningSuggestion = AssistantWorkflowDefinitionTuningSuggestion & {
+    schemaVersion: typeof ASSISTANT_WORKFLOW_DEFINITION_TUNING_JSON_SCHEMA_VERSION;
+};
+export type AssistantWorkflowSerializedDefinitionTuningSuggestionLineErrorReason = "invalid_json" | "invalid_definition_tuning_suggestion";
+export type AssistantWorkflowSerializedDefinitionTuningSuggestionLineError = {
+    lineNumber: number;
+    reason: AssistantWorkflowSerializedDefinitionTuningSuggestionLineErrorReason;
+    preview: string;
+};
+export type AssistantWorkflowSerializedDefinitionTuningSuggestionLinesParseResult = {
+    lineCount: number;
+    suggestionCount: number;
+    errorCount: number;
+    suggestions: AssistantWorkflowSerializedDefinitionTuningSuggestion[];
+    errors: AssistantWorkflowSerializedDefinitionTuningSuggestionLineError[];
+};
+export type AssistantWorkflowSerializedDefinitionTuningSuggestionLinesOptions = {
+    trailingNewline?: boolean;
+};
+export type AssistantWorkflowSerializedDefinitionTuningBatchOptions = {
+    generatedAt?: string;
+    onlyApplicable?: boolean;
+};
+export type AssistantWorkflowSerializedDefinitionTuningBatchCount = {
+    key: string;
+    count: number;
+};
+export type AssistantWorkflowSerializedDefinitionTuningBatchSummary = {
+    generatedAt: string;
+    sourceSuggestionCount: number;
+    suggestionCount: number;
+    applicableSuggestionCount: number;
+    reviewOnlySuggestionCount: number;
+    warningCount: number;
+    actionCounts: AssistantWorkflowSerializedDefinitionTuningBatchCount[];
+    severityCounts: AssistantWorkflowSerializedDefinitionTuningBatchCount[];
+    patchKindCounts: AssistantWorkflowSerializedDefinitionTuningBatchCount[];
+    intentCounts: AssistantWorkflowSerializedDefinitionTuningBatchCount[];
+    toolCounts: AssistantWorkflowSerializedDefinitionTuningBatchCount[];
+};
+export type AssistantWorkflowSerializedDefinitionTuningBatch = {
+    schemaVersion: typeof ASSISTANT_WORKFLOW_DEFINITION_TUNING_JSON_SCHEMA_VERSION;
+    generatedAt: string;
+    sourceSuggestionCount: number;
+    suggestionCount: number;
+    summary: AssistantWorkflowSerializedDefinitionTuningBatchSummary;
+    suggestions: AssistantWorkflowSerializedDefinitionTuningSuggestion[];
+};
+export declare function serializeAssistantWorkflowDefinitionTuningSuggestion(suggestion: AssistantWorkflowDefinitionTuningSuggestion): AssistantWorkflowSerializedDefinitionTuningSuggestion;
+export declare function stringifyAssistantWorkflowDefinitionTuningSuggestionLines(suggestions: readonly AssistantWorkflowDefinitionTuningSuggestion[], options?: AssistantWorkflowSerializedDefinitionTuningSuggestionLinesOptions): string;
+export declare function stringifyAssistantWorkflowSerializedDefinitionTuningSuggestionLines(suggestions: readonly AssistantWorkflowSerializedDefinitionTuningSuggestion[], options?: AssistantWorkflowSerializedDefinitionTuningSuggestionLinesOptions): string;
+export declare function buildAssistantWorkflowSerializedDefinitionTuningBatch(allSuggestions: readonly AssistantWorkflowSerializedDefinitionTuningSuggestion[], options?: AssistantWorkflowSerializedDefinitionTuningBatchOptions): AssistantWorkflowSerializedDefinitionTuningBatch;
+export declare function parseAssistantWorkflowSerializedDefinitionTuningSuggestion(value: unknown): AssistantWorkflowSerializedDefinitionTuningSuggestion | null;
+export declare function parseAssistantWorkflowSerializedDefinitionTuningSuggestionLines(input: string): AssistantWorkflowSerializedDefinitionTuningSuggestionLinesParseResult;
+export declare function parseAssistantWorkflowSerializedDefinitionTuningBatch(value: unknown): AssistantWorkflowSerializedDefinitionTuningBatch | null;
+//# sourceMappingURL=definition-tuning-json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition-tuning-json.d.ts","sourceRoot":"","sources":["../src/definition-tuning-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,2CAA2C,EAC5C,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,wDAAwD,IAAI,CAAC;AAE1E,MAAM,MAAM,qDAAqD,GAC/D,2CAA2C,GAAG;IAC5C,aAAa,EAAE,OAAO,wDAAwD,CAAC;CAChF,CAAC;AAEJ,MAAM,MAAM,oEAAoE,GAC5E,cAAc,GACd,sCAAsC,CAAC;AAE3C,MAAM,MAAM,8DAA8D,GAAG;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,oEAAoE,CAAC;IAC7E,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qEAAqE,GAAG;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,qDAAqD,EAAE,CAAC;IACrE,MAAM,EAAE,8DAA8D,EAAE,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,iEAAiE,GAAG;IAC9E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,uDAAuD,GAAG;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,qDAAqD,GAAG;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,uDAAuD,GAAG;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,qDAAqD,EAAE,CAAC;IACtE,cAAc,EAAE,qDAAqD,EAAE,CAAC;IACxE,eAAe,EAAE,qDAAqD,EAAE,CAAC;IACzE,YAAY,EAAE,qDAAqD,EAAE,CAAC;IACtE,UAAU,EAAE,qDAAqD,EAAE,CAAC;CACrE,CAAC;AAEF,MAAM,MAAM,gDAAgD,GAAG;IAC7D,aAAa,EAAE,OAAO,wDAAwD,CAAC;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,uDAAuD,CAAC;IACjE,WAAW,EAAE,qDAAqD,EAAE,CAAC;CACtE,CAAC;AAcF,wBAAgB,oDAAoD,CAClE,UAAU,EAAE,2CAA2C,GACtD,qDAAqD,CAgBvD;AAED,wBAAgB,yDAAyD,CACvE,WAAW,EAAE,SAAS,2CAA2C,EAAE,EACnE,OAAO,GAAE,iEAAsE,GAC9E,MAAM,CAKR;AAED,wBAAgB,mEAAmE,CACjF,WAAW,EAAE,SAAS,qDAAqD,EAAE,EAC7E,OAAO,GAAE,iEAAsE,GAC9E,MAAM,CAIR;AAED,wBAAgB,qDAAqD,CACnE,cAAc,EAAE,SAAS,qDAAqD,EAAE,EAChF,OAAO,GAAE,uDAA4D,GACpE,gDAAgD,CAelD;AAED,wBAAgB,0DAA0D,CACxE,KAAK,EAAE,OAAO,GACb,qDAAqD,GAAG,IAAI,CAgC9D;AAED,wBAAgB,+DAA+D,CAC7E,KAAK,EAAE,MAAM,GACZ,qEAAqE,CAsCvE;AAED,wBAAgB,qDAAqD,CACnE,KAAK,EAAE,OAAO,GACb,gDAAgD,GAAG,IAAI,CAuBzD"}

package/dist/definition-tuning-json.js

@@ -0,0 +1,276 @@
+export const ASSISTANT_WORKFLOW_DEFINITION_TUNING_JSON_SCHEMA_VERSION = 1;
+const ACTIONS = new Set([
+    "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",
+]);
+export function serializeAssistantWorkflowDefinitionTuningSuggestion(suggestion) {
+    return {
+        schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_JSON_SCHEMA_VERSION,
+        id: suggestion.id,
+        action: suggestion.action,
+        severity: suggestion.severity,
+        intentId: suggestion.intentId,
+        toolName: suggestion.toolName,
+        signal: suggestion.signal,
+        count: suggestion.count,
+        requestIds: [...suggestion.requestIds],
+        sourceSuggestionIds: [...suggestion.sourceSuggestionIds],
+        rationale: suggestion.rationale,
+        suggestedAction: suggestion.suggestedAction,
+        patchPreview: clonePatchPreview(suggestion.patchPreview),
+    };
+}
+export function stringifyAssistantWorkflowDefinitionTuningSuggestionLines(suggestions, options = {}) {
+    return stringifyAssistantWorkflowSerializedDefinitionTuningSuggestionLines(suggestions.map(serializeAssistantWorkflowDefinitionTuningSuggestion), options);
+}
+export function stringifyAssistantWorkflowSerializedDefinitionTuningSuggestionLines(suggestions, options = {}) {
+    const lines = suggestions.map((suggestion) => JSON.stringify(suggestion));
+    if (!lines.length)
+        return "";
+    return options.trailingNewline === true ? `${lines.join("\n")}\n` : lines.join("\n");
+}
+export function buildAssistantWorkflowSerializedDefinitionTuningBatch(allSuggestions, options = {}) {
+    const suggestions = options.onlyApplicable === true
+        ? allSuggestions.filter(isApplicableSuggestion)
+        : [...allSuggestions];
+    const generatedAt = normalizeGeneratedAt(options.generatedAt) ?? new Date().toISOString();
+    const summary = buildBatchSummary(allSuggestions, suggestions, generatedAt);
+    return {
+        schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_JSON_SCHEMA_VERSION,
+        generatedAt,
+        sourceSuggestionCount: allSuggestions.length,
+        suggestionCount: suggestions.length,
+        summary,
+        suggestions,
+    };
+}
+export function parseAssistantWorkflowSerializedDefinitionTuningSuggestion(value) {
+    if (!isRecord(value))
+        return null;
+    if (value["schemaVersion"] !== ASSISTANT_WORKFLOW_DEFINITION_TUNING_JSON_SCHEMA_VERSION)
+        return null;
+    if (typeof value["id"] !== "string" || !value["id"].trim().length)
+        return null;
+    if (!isAction(value["action"]))
+        return null;
+    if (value["severity"] !== "info" && value["severity"] !== "warning")
+        return null;
+    if (!isNullableString(value["intentId"]))
+        return null;
+    if (!isNullableString(value["toolName"]))
+        return null;
+    if (!isNullableString(value["signal"]))
+        return null;
+    if (!isNonNegativeFiniteNumber(value["count"]))
+        return null;
+    if (!isStringArray(value["requestIds"]))
+        return null;
+    if (!isStringArray(value["sourceSuggestionIds"]))
+        return null;
+    if (typeof value["rationale"] !== "string")
+        return null;
+    if (typeof value["suggestedAction"] !== "string")
+        return null;
+    const patchPreview = parsePatchPreview(value["patchPreview"]);
+    if (!patchPreview)
+        return null;
+    return {
+        schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_JSON_SCHEMA_VERSION,
+        id: value["id"],
+        action: value["action"],
+        severity: value["severity"],
+        intentId: value["intentId"],
+        toolName: value["toolName"],
+        signal: value["signal"],
+        count: value["count"],
+        requestIds: value["requestIds"],
+        sourceSuggestionIds: value["sourceSuggestionIds"],
+        rationale: value["rationale"],
+        suggestedAction: value["suggestedAction"],
+        patchPreview,
+    };
+}
+export function parseAssistantWorkflowSerializedDefinitionTuningSuggestionLines(input) {
+    const suggestions = [];
+    const errors = [];
+    let lineCount = 0;
+    for (const [index, line] of input.split(/\r?\n/).entries()) {
+        const trimmed = line.trim();
+        if (!trimmed.length)
+            continue;
+        const lineNumber = index + 1;
+        lineCount += 1;
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            errors.push({ lineNumber, reason: "invalid_json", preview: previewLine(trimmed) });
+            continue;
+        }
+        const suggestion = parseAssistantWorkflowSerializedDefinitionTuningSuggestion(parsed);
+        if (!suggestion) {
+            errors.push({
+                lineNumber,
+                reason: "invalid_definition_tuning_suggestion",
+                preview: previewLine(trimmed),
+            });
+            continue;
+        }
+        suggestions.push(suggestion);
+    }
+    return {
+        lineCount,
+        suggestionCount: suggestions.length,
+        errorCount: errors.length,
+        suggestions,
+        errors,
+    };
+}
+export function parseAssistantWorkflowSerializedDefinitionTuningBatch(value) {
+    if (!isRecord(value))
+        return null;
+    if (value["schemaVersion"] !== ASSISTANT_WORKFLOW_DEFINITION_TUNING_JSON_SCHEMA_VERSION)
+        return null;
+    if (typeof value["generatedAt"] !== "string" || !value["generatedAt"].trim().length)
+        return null;
+    if (!isNonNegativeFiniteNumber(value["sourceSuggestionCount"]))
+        return null;
+    if (!isNonNegativeFiniteNumber(value["suggestionCount"]))
+        return null;
+    if (!isBatchSummary(value["summary"]))
+        return null;
+    if (!Array.isArray(value["suggestions"]))
+        return null;
+    const suggestions = value["suggestions"].map(parseAssistantWorkflowSerializedDefinitionTuningSuggestion);
+    if (suggestions.some((suggestion) => suggestion === null))
+        return null;
+    if (suggestions.length !== value["suggestionCount"])
+        return null;
+    return {
+        schemaVersion: ASSISTANT_WORKFLOW_DEFINITION_TUNING_JSON_SCHEMA_VERSION,
+        generatedAt: value["generatedAt"],
+        sourceSuggestionCount: value["sourceSuggestionCount"],
+        suggestionCount: value["suggestionCount"],
+        summary: value["summary"],
+        suggestions: suggestions.filter((suggestion) => suggestion !== null),
+    };
+}
+function buildBatchSummary(allSuggestions, suggestions, generatedAt) {
+    return {
+        generatedAt,
+        sourceSuggestionCount: allSuggestions.length,
+        suggestionCount: suggestions.length,
+        applicableSuggestionCount: suggestions.filter(isApplicableSuggestion).length,
+        reviewOnlySuggestionCount: suggestions.filter((suggestion) => suggestion.patchPreview.kind === "none").length,
+        warningCount: suggestions.filter((suggestion) => suggestion.severity === "warning").length,
+        actionCounts: buildStringCounts(suggestions.map((suggestion) => suggestion.action)),
+        severityCounts: buildStringCounts(suggestions.map((suggestion) => suggestion.severity)),
+        patchKindCounts: buildStringCounts(suggestions.map((suggestion) => suggestion.patchPreview.kind)),
+        intentCounts: buildStringCounts(suggestions.map((suggestion) => suggestion.intentId ?? "none")),
+        toolCounts: buildStringCounts(suggestions.map((suggestion) => suggestion.toolName ?? "none")),
+    };
+}
+function isApplicableSuggestion(suggestion) {
+    return suggestion.patchPreview.kind !== "none";
+}
+function clonePatchPreview(patchPreview) {
+    return { ...patchPreview };
+}
+function parsePatchPreview(value) {
+    if (!isRecord(value))
+        return null;
+    if (value["kind"] === "none")
+        return { kind: "none" };
+    if (value["kind"] === "register_tool_capability" && typeof value["toolName"] === "string") {
+        return { kind: "register_tool_capability", toolName: value["toolName"] };
+    }
+    if (value["kind"] === "append_intent_tool_hint" &&
+        typeof value["intentId"] === "string" &&
+        typeof value["toolName"] === "string") {
+        return {
+            kind: "append_intent_tool_hint",
+            intentId: value["intentId"],
+            toolName: value["toolName"],
+        };
+    }
+    if (value["kind"] === "append_direct_route_strategy" &&
+        typeof value["routeId"] === "string" &&
+        typeof value["strategyId"] === "string" &&
+        typeof value["description"] === "string") {
+        return {
+            kind: "append_direct_route_strategy",
+            routeId: value["routeId"],
+            strategyId: value["strategyId"],
+            description: value["description"],
+        };
+    }
+    return null;
+}
+function buildStringCounts(values) {
+    const counts = new Map();
+    for (const value of values) {
+        if (!value.length)
+            continue;
+        counts.set(value, (counts.get(value) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .map(([key, count]) => ({ key, count }))
+        .sort((left, right) => {
+        if (right.count !== left.count)
+            return right.count - left.count;
+        return left.key.localeCompare(right.key);
+    });
+}
+function isBatchSummary(value) {
+    if (!isRecord(value))
+        return false;
+    return (typeof value["generatedAt"] === "string" &&
+        isNonNegativeFiniteNumber(value["sourceSuggestionCount"]) &&
+        isNonNegativeFiniteNumber(value["suggestionCount"]) &&
+        isNonNegativeFiniteNumber(value["applicableSuggestionCount"]) &&
+        isNonNegativeFiniteNumber(value["reviewOnlySuggestionCount"]) &&
+        isNonNegativeFiniteNumber(value["warningCount"]) &&
+        isCountArray(value["actionCounts"]) &&
+        isCountArray(value["severityCounts"]) &&
+        isCountArray(value["patchKindCounts"]) &&
+        isCountArray(value["intentCounts"]) &&
+        isCountArray(value["toolCounts"]));
+}
+function isCountArray(value) {
+    return Array.isArray(value) && value.every((item) => isRecord(item) &&
+        typeof item["key"] === "string" &&
+        isNonNegativeFiniteNumber(item["count"]));
+}
+function isAction(value) {
+    return typeof value === "string" && ACTIONS.has(value);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isNullableString(value) {
+    return value === null || typeof value === "string";
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function isNonNegativeFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function normalizeGeneratedAt(value) {
+    if (value === undefined)
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length ? trimmed : null;
+}
+function previewLine(line) {
+    return line.length <= 120 ? line : `${line.slice(0, 117)}...`;
+}
+//# sourceMappingURL=definition-tuning-json.js.map