@shop-os/modelkit 0.2.12 → 0.2.14

package/dist/catalog.js

@@ -126,7 +126,9 @@ function normalizeExposure(value) {
   if (value === "catalog") return ["cowork", "space_builder"];
   if (value === "internal") return [];
   if (Array.isArray(value)) {
-    if (value.every((entry) => SURFACES.includes(entry))) {
+    if (value.every(
+      (entry) => SURFACES.includes(entry)
+    )) {
       const present = new Set(value);
       return SURFACES.filter((surface) => present.has(surface));
     }
@@ -1824,7 +1826,215 @@ var MODELS = [
 ];
 
 // src/catalog/schema.ts
+import { z as z2 } from "zod";
+
+// src/catalog/collisions.ts
+function collisionIssues(rows) {
+  const issues = [];
+  const seenIds = /* @__PURE__ */ new Map();
+  const seenAliases = /* @__PURE__ */ new Map();
+  rows.forEach((row, index) => {
+    if (seenIds.has(row.id)) {
+      issues.push({
+        index,
+        path: ["id"],
+        message: `Duplicate model id "${row.id}"`
+      });
+    } else {
+      const aliasOwner = seenAliases.get(row.id);
+      if (aliasOwner !== void 0) {
+        issues.push({
+          index: aliasOwner.index,
+          path: ["aliases", aliasOwner.aliasIndex],
+          message: `Alias "${row.id}" collides with a model id`
+        });
+      }
+      seenIds.set(row.id, index);
+    }
+    const local = /* @__PURE__ */ new Set();
+    for (const [aliasIndex, alias] of row.aliases.entries()) {
+      if (alias === row.id || seenIds.has(alias)) {
+        issues.push({
+          index,
+          path: ["aliases", aliasIndex],
+          message: `Alias "${alias}" collides with a model id`
+        });
+      } else if (local.has(alias) || seenAliases.has(alias)) {
+        issues.push({
+          index,
+          path: ["aliases", aliasIndex],
+          message: `Duplicate alias "${alias}"`
+        });
+      }
+      local.add(alias);
+      if (!seenAliases.has(alias)) seenAliases.set(alias, { index, aliasIndex });
+    }
+  });
+  return issues;
+}
+
+// src/catalog/input-spec.ts
 import { z } from "zod";
+var VIDEO_INPUT_SPEC_KEYS = [
+  "prompt",
+  "durationSeconds",
+  "aspectRatio",
+  "resolution",
+  "firstFrame",
+  "lastFrame",
+  "seed",
+  "negativePrompt",
+  "generateAudio",
+  "cfgScale",
+  "promptExpansion",
+  "referenceImages"
+];
+var AUDIO_INPUT_SPEC_KEYS = [
+  "prompt",
+  "durationSeconds",
+  "seed",
+  "negativePrompt",
+  "references",
+  "sourceVideo",
+  "instrumental"
+];
+var INPUT_SPEC_SUPPORTS_KEYS = [
+  "lastFrame",
+  "seed",
+  "negativePrompt",
+  "generateAudio",
+  "cfgScale",
+  "promptExpansion",
+  "instrumental"
+];
+var VIDEO_KEY_SET = new Set(VIDEO_INPUT_SPEC_KEYS);
+var AUDIO_KEY_SET = new Set(AUDIO_INPUT_SPEC_KEYS);
+var ALL_KEY_SET = /* @__PURE__ */ new Set([
+  ...VIDEO_INPUT_SPEC_KEYS,
+  ...AUDIO_INPUT_SPEC_KEYS
+]);
+var ProviderScalarSchema = z.union([z.string(), z.number(), z.boolean()]);
+var FieldsSchema = z.record(z.string(), z.string().min(1)).superRefine((fields, ctx) => {
+  const keys = Object.keys(fields);
+  if (keys.length === 0) {
+    ctx.addIssue({
+      code: "custom",
+      message: "inputSpec.fields must name at least one field"
+    });
+    return;
+  }
+  for (const key of keys) {
+    if (!ALL_KEY_SET.has(key)) {
+      ctx.addIssue({
+        code: "custom",
+        message: `inputSpec.fields has unknown canonical key "${key}"`
+      });
+    }
+  }
+});
+var ValuesSchema = z.record(z.string(), z.record(z.string(), ProviderScalarSchema)).superRefine((values, ctx) => {
+  for (const key of Object.keys(values)) {
+    if (!ALL_KEY_SET.has(key)) {
+      ctx.addIssue({
+        code: "custom",
+        message: `inputSpec.values has unknown canonical key "${key}"`
+      });
+    }
+  }
+});
+var StaticSchema = z.record(z.string(), ProviderScalarSchema);
+var InputSpecSchema = z.strictObject({
+  fields: FieldsSchema,
+  values: ValuesSchema.optional(),
+  static: StaticSchema.optional()
+}).superRefine((spec, ctx) => {
+  const mappedNames = new Set(Object.values(spec.fields));
+  for (const key of Object.keys(spec.static ?? {})) {
+    if (mappedNames.has(key)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["static", key],
+        message: `inputSpec.static "${key}" collides with a mapped field name`
+      });
+    }
+  }
+});
+function validateInputSpec(raw, row) {
+  const parsed = InputSpecSchema.safeParse(raw);
+  if (!parsed.success) {
+    return {
+      ok: false,
+      issues: parsed.error.issues.map((issue) => ({
+        path: issue.path,
+        message: issue.message
+      }))
+    };
+  }
+  const spec = parsed.data;
+  if (row.adapter !== "replicate") {
+    return {
+      ok: false,
+      issues: [{ path: [], message: "inputSpec is only supported on replicate rows" }]
+    };
+  }
+  const issues = [];
+  if (row.type !== "video" && row.type !== "audio") {
+    issues.push({
+      path: [],
+      message: `inputSpec is not supported for "${row.type}" rows`
+    });
+  } else {
+    const allowed = row.type === "video" ? VIDEO_KEY_SET : AUDIO_KEY_SET;
+    for (const key of Object.keys(spec.fields)) {
+      if (!allowed.has(key)) {
+        issues.push({
+          path: ["fields", key],
+          message: `inputSpec.fields "${key}" is not supported for ${row.type} rows`
+        });
+      }
+    }
+    for (const key of Object.keys(spec.values ?? {})) {
+      if (!allowed.has(key)) {
+        issues.push({
+          path: ["values", key],
+          message: `inputSpec.values "${key}" is not supported for ${row.type} rows`
+        });
+      }
+    }
+  }
+  const seenNames = /* @__PURE__ */ new Map();
+  for (const [key, name] of Object.entries(spec.fields)) {
+    const first = seenNames.get(name);
+    if (first === void 0) seenNames.set(name, key);
+    else {
+      issues.push({
+        path: ["fields", key],
+        message: `inputSpec.fields "${first}" and "${key}" both map to "${name}"`
+      });
+    }
+  }
+  for (const key of Object.keys(spec.values ?? {})) {
+    if (!(key in spec.fields)) {
+      issues.push({
+        path: ["values", key],
+        message: `inputSpec.values "${key}" has no matching fields entry`
+      });
+    }
+  }
+  const supports = row.constraints.supports ?? [];
+  for (const key of INPUT_SPEC_SUPPORTS_KEYS) {
+    if (key in spec.fields && !supports.includes(key)) {
+      issues.push({
+        path: ["fields", key],
+        message: `inputSpec.fields "${key}" needs "${key}" in constraints.supports`
+      });
+    }
+  }
+  if (issues.length > 0) return { ok: false, issues };
+  return { ok: true, spec };
+}
+
+// src/catalog/schema.ts
 var ADAPTER_IDS = [
   "ai-sdk-text",
   "google-image",
@@ -1837,16 +2047,16 @@ var ADAPTER_IDS = [
   "higgsfield",
   "xai-video"
 ];
-var ModelTypeSchema = z.enum(["text", "image", "video", "audio", "upscale", "bg-remove"]);
-var LifecycleSchema = z.enum(["active", "deprecated", "retired"]);
-var SurfaceSchema = z.enum(["cowork", "space_builder"]);
+var ModelTypeSchema = z2.enum(["text", "image", "video", "audio", "upscale", "bg-remove"]);
+var LifecycleSchema = z2.enum(["active", "deprecated", "retired"]);
+var SurfaceSchema = z2.enum(["cowork", "space_builder"]);
 var SURFACES2 = SurfaceSchema.options;
-var ExposureSchema = z.preprocess(
+var ExposureSchema = z2.preprocess(
   normalizeExposure,
-  z.array(SurfaceSchema)
+  z2.array(SurfaceSchema)
 );
-var AdapterSchema = z.enum(ADAPTER_IDS);
-var AspectRatioSchema = z.enum([
+var AdapterSchema = z2.enum(ADAPTER_IDS);
+var AspectRatioSchema = z2.enum([
   "1:1",
   "16:9",
   "9:16",
@@ -1861,12 +2071,12 @@ var AspectRatioSchema = z.enum([
   "97:30",
   "adaptive"
 ]);
-var ImageSizeSchema = z.enum(["512", "1K", "2K", "4K"]);
-var VideoResolutionSchema = z.enum(["360p", "480p", "720p", "768p", "1080p", "2k", "4k"]);
-var ImageQualitySchema = z.enum(["auto", "low", "medium", "high", "xhigh", "max"]);
-var OutputFormatSchema = z.enum(["png", "jpeg", "webp"]);
-var RequiredInputSchema = z.enum(["firstFrame", "sourceVideo", "references"]);
-var SupportedOptionSchema = z.enum([
+var ImageSizeSchema = z2.enum(["512", "1K", "2K", "4K"]);
+var VideoResolutionSchema = z2.enum(["360p", "480p", "720p", "768p", "1080p", "2k", "4k"]);
+var ImageQualitySchema = z2.enum(["auto", "low", "medium", "high", "xhigh", "max"]);
+var OutputFormatSchema = z2.enum(["png", "jpeg", "webp"]);
+var RequiredInputSchema = z2.enum(["firstFrame", "sourceVideo", "references"]);
+var SupportedOptionSchema = z2.enum([
   "seed",
   "quality",
   "negativePrompt",
@@ -1885,128 +2095,128 @@ var SupportedOptionSchema = z.enum([
   "taskType",
   "instrumental"
 ]);
-var UsageUnitSchema = z.enum([
+var UsageUnitSchema = z2.enum([
   "tokens",
   "images",
   "seconds",
   "reported_cost_usd",
   "compute_seconds"
 ]);
-var PricingKindSchema = z.enum(["token", "image_size", "video_per_second", "flat"]);
-var ProviderOptionValueSchema = z.lazy(
-  () => z.union([
-    z.string(),
-    z.number(),
-    z.boolean(),
-    z.array(ProviderOptionValueSchema),
-    z.record(z.string(), ProviderOptionValueSchema)
+var PricingKindSchema = z2.enum(["token", "image_size", "video_per_second", "flat"]);
+var ProviderOptionValueSchema = z2.lazy(
+  () => z2.union([
+    z2.string(),
+    z2.number(),
+    z2.boolean(),
+    z2.array(ProviderOptionValueSchema),
+    z2.record(z2.string(), ProviderOptionValueSchema)
   ])
 );
-var ProviderOptionsSchema = z.record(z.string(), z.record(z.string(), ProviderOptionValueSchema));
-var ReferenceLimitsSchema = z.looseObject({
-  images: z.number().optional(),
-  imagesWithVideo: z.number().optional(),
-  videos: z.number().optional(),
-  audios: z.number().optional(),
-  total: z.number().optional(),
-  audioOnly: z.boolean().optional()
+var ProviderOptionsSchema = z2.record(z2.string(), z2.record(z2.string(), ProviderOptionValueSchema));
+var ReferenceLimitsSchema = z2.looseObject({
+  images: z2.number().optional(),
+  imagesWithVideo: z2.number().optional(),
+  videos: z2.number().optional(),
+  audios: z2.number().optional(),
+  total: z2.number().optional(),
+  audioOnly: z2.boolean().optional()
 });
-var ModelConstraintsSchema = z.looseObject({
-  aspectRatios: z.array(AspectRatioSchema).optional(),
-  sizes: z.array(ImageSizeSchema).optional(),
-  resolutions: z.array(VideoResolutionSchema).optional(),
-  durations: z.union([z.looseObject({ min: z.number(), max: z.number() }), z.array(z.number())]).optional(),
-  durationPresets: z.array(z.number()).optional(),
-  qualityOptions: z.array(z.string()).optional(),
-  exactSizes: z.record(z.string(), z.string()).optional(),
+var ModelConstraintsSchema = z2.looseObject({
+  aspectRatios: z2.array(AspectRatioSchema).optional(),
+  sizes: z2.array(ImageSizeSchema).optional(),
+  resolutions: z2.array(VideoResolutionSchema).optional(),
+  durations: z2.union([z2.looseObject({ min: z2.number(), max: z2.number() }), z2.array(z2.number())]).optional(),
+  durationPresets: z2.array(z2.number()).optional(),
+  qualityOptions: z2.array(z2.string()).optional(),
+  exactSizes: z2.record(z2.string(), z2.string()).optional(),
   references: ReferenceLimitsSchema.optional(),
-  requires: z.array(RequiredInputSchema).optional(),
-  supports: z.array(SupportedOptionSchema).optional(),
-  ratioIgnoredWith: z.array(z.enum(["firstFrame", "sourceVideo"])).optional()
+  requires: z2.array(RequiredInputSchema).optional(),
+  supports: z2.array(SupportedOptionSchema).optional(),
+  ratioIgnoredWith: z2.array(z2.enum(["firstFrame", "sourceVideo"])).optional()
 });
-var MediaRefSchema = z.union([
-  z.looseObject({ url: z.string(), label: z.string().optional() }),
-  z.looseObject({
-    bytes: z.instanceof(Uint8Array),
-    mime: z.string(),
-    label: z.string().optional()
+var MediaRefSchema = z2.union([
+  z2.looseObject({ url: z2.string(), label: z2.string().optional() }),
+  z2.looseObject({
+    bytes: z2.instanceof(Uint8Array),
+    mime: z2.string(),
+    label: z2.string().optional()
   })
 ]);
-var ImageSafetySettingSchema = z.looseObject({ category: z.string(), threshold: z.string() });
-var UpscaleOptionsSchema = z.looseObject({
-  enhanceModel: z.string().optional(),
-  subjectDetection: z.string().optional(),
-  faceEnhancement: z.boolean().optional(),
-  faceEnhancementCreativity: z.number().optional(),
-  faceEnhancementStrength: z.number().optional()
+var ImageSafetySettingSchema = z2.looseObject({ category: z2.string(), threshold: z2.string() });
+var UpscaleOptionsSchema = z2.looseObject({
+  enhanceModel: z2.string().optional(),
+  subjectDetection: z2.string().optional(),
+  faceEnhancement: z2.boolean().optional(),
+  faceEnhancementCreativity: z2.number().optional(),
+  faceEnhancementStrength: z2.number().optional()
 });
-var DefaultsSchema = z.looseObject({
-  references: z.array(MediaRefSchema).optional(),
+var DefaultsSchema = z2.looseObject({
+  references: z2.array(MediaRefSchema).optional(),
   aspectRatio: AspectRatioSchema.optional(),
   size: ImageSizeSchema.optional(),
-  exactSize: z.string().optional(),
+  exactSize: z2.string().optional(),
   quality: ImageQualitySchema.optional(),
-  seed: z.number().optional(),
-  count: z.number().optional(),
+  seed: z2.number().optional(),
+  count: z2.number().optional(),
   outputFormat: OutputFormatSchema.optional(),
-  scaleFactor: z.number().optional(),
-  safetySettings: z.array(ImageSafetySettingSchema).optional(),
-  temperature: z.number().optional(),
+  scaleFactor: z2.number().optional(),
+  safetySettings: z2.array(ImageSafetySettingSchema).optional(),
+  temperature: z2.number().optional(),
   upscale: UpscaleOptionsSchema.optional(),
   firstFrame: MediaRefSchema.optional(),
   lastFrame: MediaRefSchema.optional(),
   sourceVideo: MediaRefSchema.optional(),
-  referenceImages: z.array(MediaRefSchema).optional(),
-  referenceVideos: z.array(MediaRefSchema).optional(),
-  referenceAudios: z.array(MediaRefSchema).optional(),
+  referenceImages: z2.array(MediaRefSchema).optional(),
+  referenceVideos: z2.array(MediaRefSchema).optional(),
+  referenceAudios: z2.array(MediaRefSchema).optional(),
   resolution: VideoResolutionSchema.optional(),
-  durationSeconds: z.number().optional(),
-  generateAudio: z.boolean().optional(),
-  negativePrompt: z.string().optional(),
-  cfgScale: z.number().optional(),
-  promptExpansion: z.enum(["fast", "balanced", "quality"]).optional(),
-  watermark: z.boolean().optional(),
-  safetyChecker: z.boolean().optional(),
-  taskType: z.enum(["reference", "edit", "extend"]).optional(),
-  mode: z.enum(["standard", "pro"]).optional(),
-  instrumental: z.boolean().optional()
+  durationSeconds: z2.number().optional(),
+  generateAudio: z2.boolean().optional(),
+  negativePrompt: z2.string().optional(),
+  cfgScale: z2.number().optional(),
+  promptExpansion: z2.enum(["fast", "balanced", "quality"]).optional(),
+  watermark: z2.boolean().optional(),
+  safetyChecker: z2.boolean().optional(),
+  taskType: z2.enum(["reference", "edit", "extend"]).optional(),
+  mode: z2.enum(["standard", "pro"]).optional(),
+  instrumental: z2.boolean().optional()
 });
-var CatalogDisplaySchema = z.looseObject({
-  provider: z.string(),
-  description: z.string(),
-  logo: z.string().optional(),
-  costTier: z.union([z.literal(1), z.literal(2), z.literal(3)]).optional(),
-  recommended: z.boolean().optional(),
-  sortOrder: z.number().optional(),
-  chat: z.looseObject({
+var CatalogDisplaySchema = z2.looseObject({
+  provider: z2.string(),
+  description: z2.string(),
+  logo: z2.string().optional(),
+  costTier: z2.union([z2.literal(1), z2.literal(2), z2.literal(3)]).optional(),
+  recommended: z2.boolean().optional(),
+  sortOrder: z2.number().optional(),
+  chat: z2.looseObject({
     providerOptions: ProviderOptionsSchema.optional(),
-    temperature: z.number().optional()
+    temperature: z2.number().optional()
   }).optional()
 });
-var CatalogCapabilitiesSchema = z.looseObject({
-  acceptsSourceVideo: z.boolean().optional(),
-  framesExcludeReferences: z.boolean().optional(),
-  reasoning: z.boolean().optional(),
-  vision: z.boolean().optional(),
-  contextWindow: z.number().optional()
+var CatalogCapabilitiesSchema = z2.looseObject({
+  acceptsSourceVideo: z2.boolean().optional(),
+  framesExcludeReferences: z2.boolean().optional(),
+  reasoning: z2.boolean().optional(),
+  vision: z2.boolean().optional(),
+  contextWindow: z2.number().optional()
 });
-var CatalogModelSchemaBase = z.looseObject({
-  id: z.string().min(1),
-  aliases: z.array(z.string()).default([]),
-  label: z.string().min(1),
+var CatalogModelSchemaBase = z2.looseObject({
+  id: z2.string().min(1),
+  aliases: z2.array(z2.string()).default([]),
+  label: z2.string().min(1),
   type: ModelTypeSchema,
   adapter: AdapterSchema,
-  providerModelId: z.string().min(1),
+  providerModelId: z2.string().min(1),
   lifecycle: LifecycleSchema,
-  replacedBy: z.string().optional(),
+  replacedBy: z2.string().optional(),
   exposure: ExposureSchema,
   constraints: ModelConstraintsSchema,
   defaults: DefaultsSchema,
   providerOptions: ProviderOptionsSchema.optional(),
-  usage: z.looseObject({
+  usage: z2.looseObject({
     unit: UsageUnitSchema,
-    slug: z.string().optional(),
-    providerLabel: z.string().optional()
+    slug: z2.string().optional(),
+    providerLabel: z2.string().optional()
   }),
   pricingKind: PricingKindSchema,
   display: CatalogDisplaySchema.optional(),
@@ -2044,44 +2254,29 @@ var CatalogModelSchema = CatalogModelSchemaBase.superRefine(
         message: 'transport must be "direct" or "bedrock"'
       });
     }
+    const inputSpecRaw = row.providerOptions?.["modelkit"]?.["inputSpec"];
+    if (inputSpecRaw !== void 0) {
+      const result = validateInputSpec(inputSpecRaw, row);
+      if (!result.ok) {
+        for (const issue of result.issues) {
+          ctx.addIssue({
+            code: "custom",
+            path: ["providerOptions", "modelkit", "inputSpec", ...issue.path],
+            message: issue.message
+          });
+        }
+      }
+    }
   }
 );
-var CatalogSchema = z.array(CatalogModelSchemaBase).superRefine((rows, ctx) => {
-  const seenIds = /* @__PURE__ */ new Map();
-  rows.forEach((row, index) => {
-    if (seenIds.has(row.id)) {
-      ctx.addIssue({
-        code: "custom",
-        path: [index, "id"],
-        message: `Duplicate model id "${row.id}"`
-      });
-    } else {
-      seenIds.set(row.id, index);
-    }
-  });
-  const seenAliases = /* @__PURE__ */ new Map();
-  rows.forEach((row, index) => {
-    row.aliases.forEach((alias, aliasIndex) => {
-      const path = [index, "aliases", aliasIndex];
-      if (alias === row.id || seenIds.has(alias)) {
-        ctx.addIssue({
-          code: "custom",
-          path,
-          message: `Alias "${alias}" collides with a model id`
-        });
-        return;
-      }
-      if (seenAliases.has(alias)) {
-        ctx.addIssue({
-          code: "custom",
-          path,
-          message: `Duplicate alias "${alias}"`
-        });
-      } else {
-        seenAliases.set(alias, index);
-      }
+var CatalogSchema = z2.array(CatalogModelSchemaBase).superRefine((rows, ctx) => {
+  for (const issue of collisionIssues(rows)) {
+    ctx.addIssue({
+      code: "custom",
+      path: [issue.index, ...issue.path],
+      message: issue.message
     });
-  });
+  }
 });
 
 // src/catalog/live.ts
@@ -2096,26 +2291,102 @@ var liveState = store[KEY] ??= {
 };
 var liveCatalog = liveState.catalog;
 
+// src/json.ts
+import { z as z3 } from "zod";
+var JsonValueSchema = z3.lazy(
+  () => z3.union([
+    z3.string(),
+    z3.number(),
+    z3.boolean(),
+    z3.null(),
+    z3.array(JsonValueSchema),
+    z3.record(z3.string(), JsonValueSchema)
+  ])
+);
+var JsonObjectSchema = z3.record(z3.string(), JsonValueSchema);
+var thrownErrorSchema = z3.object({
+  message: z3.string().optional(),
+  status: z3.number().optional(),
+  statusCode: z3.number().optional(),
+  responseBody: z3.string().optional()
+});
+
 // src/catalog/load.ts
-import { z as z2 } from "zod";
+import { z as z4 } from "zod";
 function rowCount() {
   return liveCatalog.list({ lifecycle: ["active", "deprecated", "retired"] }).length;
 }
 function authHeaders(auth) {
   return "bearer" in auth ? { Authorization: `Bearer ${auth.bearer}` } : { "x-api-key": auth.apiKey };
 }
-var EnvelopeSchema = z2.object({
-  rows: CatalogSchema,
-  revision: z2.string().optional()
+var EnvelopeSchema = z4.object({
+  rows: z4.array(JsonValueSchema),
+  revision: z4.string().optional()
 });
-function toEnvelope(data) {
-  if (data.rows.length === 0) throw new Error("invalid catalog response: no rows");
-  const envelope = { rows: data.rows };
+function dropReason(path, message) {
+  return path.length === 0 ? message : `${path.map((part) => String(part)).join(".")} ${message}`;
+}
+function rowId(raw) {
+  const parsed = z4.object({ id: z4.string().min(1) }).loose().safeParse(raw);
+  if (!parsed.success) return "?";
+  return parsed.data.id;
+}
+function quarantine(rawRows, logger) {
+  const valid = [];
+  let dropped = 0;
+  for (const raw of rawRows) {
+    const parsed = CatalogModelSchemaBase.safeParse(raw);
+    if (!parsed.success) {
+      const first = parsed.error.issues[0];
+      const reason = first ? dropReason(first.path, first.message) : "invalid row";
+      logger.warn(`[modelkit] catalog row dropped id=${rowId(raw)} reason=${reason}`);
+      dropped += 1;
+      continue;
+    }
+    const row = parsed.data;
+    const inputSpecRaw = row.providerOptions?.["modelkit"]?.["inputSpec"];
+    if (inputSpecRaw !== void 0) {
+      const result = validateInputSpec(inputSpecRaw, row);
+      if (!result.ok) {
+        const first = result.issues[0];
+        const detail = first ? dropReason(first.path, first.message) : "invalid inputSpec";
+        logger.warn(
+          `[modelkit] catalog row ${row.id} has an invalid providerOptions.modelkit.inputSpec: ${detail}; calls fail until it is fixed`
+        );
+      }
+    }
+    valid.push(row);
+  }
+  let kept = valid;
+  for (; ; ) {
+    const issues = collisionIssues(kept);
+    if (issues.length === 0) break;
+    const firstByIndex = /* @__PURE__ */ new Map();
+    for (const issue of issues) {
+      if (!firstByIndex.has(issue.index)) firstByIndex.set(issue.index, issue);
+    }
+    for (const [index, issue] of [...firstByIndex.entries()].sort((a, b) => a[0] - b[0])) {
+      const row = kept[index];
+      if (!row) continue;
+      logger.warn(
+        `[modelkit] catalog row dropped id=${row.id} reason=${String(issue.path[0] ?? "")} ${issue.message}`
+      );
+    }
+    const dropSet = new Set(firstByIndex.keys());
+    kept = kept.filter((_, index) => !dropSet.has(index));
+    dropped += dropSet.size;
+  }
+  return { rows: kept, dropped };
+}
+function toEnvelope(data, logger) {
+  const { rows, dropped } = quarantine(data.rows, logger);
+  if (rows.length === 0) throw new Error("invalid catalog response: no rows");
+  const envelope = { rows, dropped };
   if (data.revision !== void 0) envelope.revision = data.revision;
   return envelope;
 }
-function describeError(err) {
-  return err instanceof Error ? err.message : String(err);
+function describeError(cause) {
+  return cause instanceof Error ? cause.message : String(cause);
 }
 function logPrimed(logger, result) {
   const revision = result.revision === void 0 ? "" : ` revision=${result.revision}`;
@@ -2136,9 +2407,9 @@ async function fetchRemote(source, logger) {
   const json = await res.json();
   const parsed = EnvelopeSchema.safeParse(json);
   if (!parsed.success) throw new Error("invalid catalog response: missing rows");
-  const { rows, revision: rev } = toEnvelope(parsed.data);
-  if (rev === void 0) return { rows, fromCache: false };
-  return { rows, revision: rev, fromCache: false };
+  const { rows, revision: rev, dropped } = toEnvelope(parsed.data, logger);
+  if (rev === void 0) return { rows, fromCache: false, dropped };
+  return { rows, revision: rev, fromCache: false, dropped };
 }
 async function writeCache(source, logger, rows, rev) {
   if (!source.cache) return;
@@ -2163,6 +2434,7 @@ async function prime(source, logger) {
     await writeCache(source, logger, fetched.rows, fetched.revision);
     const result = { origin: liveState.origin, rowCount: rowCount() };
     if (fetched.revision !== void 0) result.revision = fetched.revision;
+    if (fetched.dropped > 0) result.droppedRows = fetched.dropped;
     logPrimed(logger, result);
     return result;
   } catch (err) {
@@ -2173,7 +2445,7 @@ async function prime(source, logger) {
       if (!cached) throw new Error("no cached catalog");
       const cachedParsed = EnvelopeSchema.safeParse(JSON.parse(cached));
       if (!cachedParsed.success) throw new Error("invalid catalog response: missing rows");
-      const { rows, revision: rev } = toEnvelope(cachedParsed.data);
+      const { rows, revision: rev, dropped } = toEnvelope(cachedParsed.data, logger);
       liveCatalog.replace(rows);
       liveState.origin = "last-good";
       liveState.revision = rev;
@@ -2183,6 +2455,7 @@ async function prime(source, logger) {
         error
       };
       if (rev !== void 0) result.revision = rev;
+      if (dropped > 0) result.droppedRows = dropped;
       logPrimed(logger, result);
       return result;
     } catch (cacheErr) {
@@ -2630,6 +2903,7 @@ export {
   ADAPTER_IDS,
   Catalog,
   CatalogModelSchema,
+  CatalogModelSchemaBase,
   CatalogSchema,
   ExposureSchema,
   IMAGE_MODELS,