fix(sync): enforce agent preset version immutability on replay

frontend/src/client/schemas.gen.ts

@@ -9301,6 +9301,202 @@ export const $CaseViewedEventRead = {
   description: "Event for when a case is viewed.",
 } as const
 
+export const $CatalogMappingAffectedPreset = {
+  properties: {
+    preset_slug: {
+      type: "string",
+      title: "Preset Slug",
+    },
+    preset_name: {
+      type: "string",
+      title: "Preset Name",
+    },
+    version: {
+      type: "integer",
+      title: "Version",
+    },
+    path: {
+      type: "string",
+      title: "Path",
+    },
+  },
+  type: "object",
+  required: ["preset_slug", "preset_name", "version", "path"],
+  title: "CatalogMappingAffectedPreset",
+} as const
+
+export const $CatalogMappingAffectedWorkflow = {
+  properties: {
+    workflow_source_id: {
+      type: "string",
+      title: "Workflow Source Id",
+    },
+    workflow_path: {
+      type: "string",
+      title: "Workflow Path",
+    },
+    workflow_title: {
+      type: "string",
+      title: "Workflow Title",
+    },
+    action_ref: {
+      type: "string",
+      title: "Action Ref",
+    },
+  },
+  type: "object",
+  required: [
+    "workflow_source_id",
+    "workflow_path",
+    "workflow_title",
+    "action_ref",
+  ],
+  title: "CatalogMappingAffectedWorkflow",
+} as const
+
+export const $CatalogMappingCandidate = {
+  properties: {
+    catalog_id: {
+      type: "string",
+      format: "uuid",
+      title: "Catalog Id",
+    },
+    model_provider: {
+      type: "string",
+      title: "Model Provider",
+    },
+    model_name: {
+      type: "string",
+      title: "Model Name",
+    },
+    provider_name: {
+      type: "string",
+      title: "Provider Name",
+    },
+    model_display_name: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Model Display Name",
+    },
+    endpoint_hostname: {
+      anyOf: [
+        {
+          type: "string",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Endpoint Hostname",
+    },
+    origin: {
+      type: "string",
+      enum: ["platform", "organization", "custom_provider"],
+      title: "Origin",
+    },
+  },
+  type: "object",
+  required: [
+    "catalog_id",
+    "model_provider",
+    "model_name",
+    "provider_name",
+    "model_display_name",
+    "endpoint_hostname",
+    "origin",
+  ],
+  title: "CatalogMappingCandidate",
+} as const
+
+export const $CatalogMappingRequirement = {
+  properties: {
+    source_catalog_id: {
+      type: "string",
+      format: "uuid",
+      title: "Source Catalog Id",
+    },
+    model_provider: {
+      type: "string",
+      title: "Model Provider",
+    },
+    model_name: {
+      type: "string",
+      title: "Model Name",
+    },
+    reason: {
+      $ref: "#/components/schemas/CatalogMappingRequirementReason",
+    },
+    message: {
+      type: "string",
+      title: "Message",
+    },
+    candidates: {
+      items: {
+        $ref: "#/components/schemas/CatalogMappingCandidate",
+      },
+      type: "array",
+      title: "Candidates",
+    },
+    affected_presets: {
+      items: {
+        $ref: "#/components/schemas/CatalogMappingAffectedPreset",
+      },
+      type: "array",
+      title: "Affected Presets",
+    },
+    affected_workflows: {
+      items: {
+        $ref: "#/components/schemas/CatalogMappingAffectedWorkflow",
+      },
+      type: "array",
+      title: "Affected Workflows",
+    },
+  },
+  type: "object",
+  required: [
+    "source_catalog_id",
+    "model_provider",
+    "model_name",
+    "reason",
+    "message",
+    "candidates",
+    "affected_presets",
+    "affected_workflows",
+  ],
+  title: "CatalogMappingRequirement",
+} as const
+
+export const $CatalogMappingRequirementReason = {
+  type: "string",
+  enum: ["ambiguous", "invalid_selection"],
+} as const
+
+export const $CatalogMappingSelection = {
+  properties: {
+    source_catalog_id: {
+      type: "string",
+      format: "uuid",
+      title: "Source Catalog Id",
+    },
+    target_catalog_id: {
+      type: "string",
+      format: "uuid",
+      title: "Target Catalog Id",
+    },
+  },
+  type: "object",
+  required: ["source_catalog_id", "target_catalog_id"],
+  title: "CatalogMappingSelection",
+  description:
+    "User-selected target catalog row for one source catalog reference.",
+} as const
+
 export const $ChannelType = {
   type: "string",
   enum: ["slack"],
@@ -19660,6 +19856,20 @@ export const $PullResult = {
       ],
       title: "Resources",
     },
+    catalog_mapping_requirements: {
+      anyOf: [
+        {
+          items: {
+            $ref: "#/components/schemas/CatalogMappingRequirement",
+          },
+          type: "array",
+        },
+        {
+          type: "null",
+        },
+      ],
+      title: "Catalog Mapping Requirements",
+    },
   },
   type: "object",
   required: [
@@ -31963,6 +32173,15 @@ export const $WorkflowSyncPullRequest = {
         "Apply schedule definitions from Git. Defaults off to preserve destination schedules.",
       default: false,
     },
+    catalog_mappings: {
+      items: {
+        $ref: "#/components/schemas/CatalogMappingSelection",
+      },
+      type: "array",
+      title: "Catalog Mappings",
+      description:
+        "Explicit source-to-target model choices from the pull preview.",
+    },
   },
   type: "object",
   required: ["commit_sha"],

frontend/src/client/types.gen.ts

@@ -2462,6 +2462,53 @@ export type CaseViewedEventRead = {
   created_at: string
 }
 
+export type CatalogMappingAffectedPreset = {
+  preset_slug: string
+  preset_name: string
+  version: number
+  path: string
+}
+
+export type CatalogMappingAffectedWorkflow = {
+  workflow_source_id: string
+  workflow_path: string
+  workflow_title: string
+  action_ref: string
+}
+
+export type CatalogMappingCandidate = {
+  catalog_id: string
+  model_provider: string
+  model_name: string
+  provider_name: string
+  model_display_name: string | null
+  endpoint_hostname: string | null
+  origin: "platform" | "organization" | "custom_provider"
+}
+
+export type origin = "platform" | "organization" | "custom_provider"
+
+export type CatalogMappingRequirement = {
+  source_catalog_id: string
+  model_provider: string
+  model_name: string
+  reason: CatalogMappingRequirementReason
+  message: string
+  candidates: Array<CatalogMappingCandidate>
+  affected_presets: Array<CatalogMappingAffectedPreset>
+  affected_workflows: Array<CatalogMappingAffectedWorkflow>
+}
+
+export type CatalogMappingRequirementReason = "ambiguous" | "invalid_selection"
+
+/**
+ * User-selected target catalog row for one source catalog reference.
+ */
+export type CatalogMappingSelection = {
+  source_catalog_id: string
+  target_catalog_id: string
+}
+
 /**
  * Supported external channel types.
  */
@@ -5944,6 +5991,7 @@ export type PullResult = {
   resource_diffs?: Array<PullResourceDiff> | null
   files?: Array<string> | null
   resources?: Array<SyncPreviewResource> | null
+  catalog_mapping_requirements?: Array<CatalogMappingRequirement> | null
 }
 
 /**
@@ -9579,6 +9627,10 @@ export type WorkflowSyncPullRequest = {
    * Apply schedule definitions from Git. Defaults off to preserve destination schedules.
    */
   sync_schedules?: boolean
+  /**
+   * Explicit source-to-target model choices from the pull preview.
+   */
+  catalog_mappings?: Array<CatalogMappingSelection>
 }
 
 export type WorkflowTagCreate = {