@oh-my-pi/pi-catalog 18.11.2 → 18.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/dist/types/compat/behavior.d.ts +5 -0
  3. package/dist/types/compat/catalog-endpoint.d.ts +8 -0
  4. package/dist/types/compat/judgment-images.d.ts +25 -0
  5. package/dist/types/compat/request-compression.d.ts +21 -0
  6. package/dist/types/compat/request-size.d.ts +2 -1
  7. package/dist/types/compat/types.d.ts +2 -0
  8. package/dist/types/model-cache.d.ts +7 -0
  9. package/dist/types/provider-models/openai-compat.d.ts +0 -46
  10. package/dist/types/types.d.ts +14 -1
  11. package/package.json +4 -4
  12. package/src/build.ts +13 -0
  13. package/src/compat/axes.ts +51 -1
  14. package/src/compat/behavior.ts +9 -1
  15. package/src/compat/catalog-endpoint.ts +43 -0
  16. package/src/compat/judgment-images.ts +83 -0
  17. package/src/compat/request-compression.ts +41 -0
  18. package/src/compat/request-size.ts +3 -1
  19. package/src/compat/resolve.ts +34 -49
  20. package/src/compat/rules/README.md +17 -1
  21. package/src/compat/rules/auth/google-antigravity.kdl +1 -1
  22. package/src/compat/rules/classes/anthropic.kdl +2 -3
  23. package/src/compat/rules/classes/deepseek.kdl +4 -0
  24. package/src/compat/rules/classes/minimax.kdl +10 -0
  25. package/src/compat/rules/classes/openai.kdl +8 -0
  26. package/src/compat/rules/providers/anthropic.kdl +4 -0
  27. package/src/compat/rules/providers/azure.kdl +2 -0
  28. package/src/compat/rules/providers/cerebras.kdl +3 -0
  29. package/src/compat/rules/providers/cline-pass.kdl +16 -0
  30. package/src/compat/rules/providers/commandcode.kdl +10 -0
  31. package/src/compat/rules/providers/deepinfra.kdl +3 -1
  32. package/src/compat/rules/providers/devin.kdl +7 -1
  33. package/src/compat/rules/providers/factory-droid.kdl +6 -0
  34. package/src/compat/rules/providers/firepass.kdl +15 -0
  35. package/src/compat/rules/providers/fireworks.kdl +26 -0
  36. package/src/compat/rules/providers/github-copilot.kdl +24 -0
  37. package/src/compat/rules/providers/google-antigravity.kdl +11 -0
  38. package/src/compat/rules/providers/moonshot.kdl +2 -0
  39. package/src/compat/rules/providers/ollama-cloud.kdl +3 -0
  40. package/src/compat/rules/providers/openai-codex.kdl +9 -0
  41. package/src/compat/rules/providers/opencode-go.kdl +4 -0
  42. package/src/compat/rules/providers/opencode-zen.kdl +4 -0
  43. package/src/compat/rules/providers/openrouter.kdl +15 -0
  44. package/src/compat/rules/providers/tool-call-names.kdl +37 -0
  45. package/src/compat/rules/providers/typesafe.kdl +8 -0
  46. package/src/compat/rules/providers/umans.kdl +6 -0
  47. package/src/compat/rules/providers/venice.kdl +7 -0
  48. package/src/compat/rules/providers/xai-oauth.kdl +4 -0
  49. package/src/compat/rules/providers/zai.kdl +5 -0
  50. package/src/compat/rules/runtime/behavior.kdl +115 -4
  51. package/src/compat/rules.json +1 -1
  52. package/src/compat/types.ts +2 -0
  53. package/src/model-cache.ts +8 -0
  54. package/src/model-manager.ts +29 -20
  55. package/src/models.json +1 -1
  56. package/src/provider-models/openai-compat.ts +8 -90
  57. package/src/types.ts +14 -0
@@ -352,6 +352,8 @@ export interface CompiledBehavior {
352
352
  retryResetTimezones: CompiledRetryResetTimezone[];
353
353
  retiredProviders: string[];
354
354
  referenceIsolatedProviders: string[];
355
+ /** Built-in model selector chains per agent role, keyed by role in declaration order. */
356
+ roleDefaults: Record<string, string[]>;
355
357
  }
356
358
 
357
359
  /**
@@ -145,6 +145,13 @@ export interface CacheEntry<TApi extends Api = Api> {
145
145
  models: Model<TApi>[];
146
146
  fresh: boolean;
147
147
  authoritative: boolean;
148
+ /**
149
+ * `authoritative` of the payload row itself, ignoring the
150
+ * `model_cache_refresh` side row. A failed refresh flips only the side row
151
+ * (freshness plus retry backoff), so this keeps answering "were `models`
152
+ * written by an authoritative discovery result?" after such a write.
153
+ */
154
+ payloadAuthoritative: boolean;
148
155
  updatedAt: number;
149
156
  /** Model ids whose live headers were intentionally omitted from disk. */
150
157
  headerOmittedModelIds: readonly string[];
@@ -596,6 +603,7 @@ function parseCacheRow<TApi extends Api>(
596
603
  models,
597
604
  fresh,
598
605
  authoritative,
606
+ payloadAuthoritative: row.authoritative === 1,
599
607
  updatedAt,
600
608
  headerOmittedModelIds,
601
609
  unrestorableHeaderModelIds,
@@ -260,11 +260,14 @@ export async function resolveProviderModels<TApi extends Api = Api, TModelsDevPa
260
260
  const staticModels = options.staticModels
261
261
  ? materializeStaticModels<TApi>(options.staticModels)
262
262
  : (getBundledModels(options.providerId as GeneratedProvider) as Model<TApi>[]);
263
- const additiveStaticModelIds =
263
+ const modelsDevAdditiveStaticModelIds =
264
264
  options.modelsDev?.additiveOnly && staticModels.length > 0
265
265
  ? new Set(staticModels.map(model => model.id))
266
266
  : undefined;
267
267
  const cache = readModelCache<TApi>(cacheProviderId, ttlMs, now, dbPath);
268
+ const dynamicModelsAuthoritative = options.dynamicModelsAuthoritative ?? false;
269
+ const isAuthoritativeDynamicCache = dynamicModelsAuthoritative && (cache?.payloadAuthoritative ?? false);
270
+ const cacheAdditiveStaticModelIds = isAuthoritativeDynamicCache ? undefined : modelsDevAdditiveStaticModelIds;
268
271
  const restoredCache = restoreCachedModelHeaders(
269
272
  cache?.models ?? [],
270
273
  staticModels,
@@ -276,7 +279,6 @@ export async function resolveProviderModels<TApi extends Api = Api, TModelsDevPa
276
279
  );
277
280
  const usableCachedModels = restoredCache.models.filter(model => !restoredCache.unresolvedModelIds.has(model.id));
278
281
  const cacheHasUnresolvedHeaders = restoredCache.unresolvedModelIds.size > 0;
279
- const dynamicModelsAuthoritative = options.dynamicModelsAuthoritative ?? false;
280
282
  const mergeAuthority: DynamicMergeAuthority = {
281
283
  input: options.dynamicInputAuthoritative ?? false,
282
284
  reasoning: options.dynamicReasoningAuthoritative ?? false,
@@ -322,10 +324,10 @@ export async function resolveProviderModels<TApi extends Api = Api, TModelsDevPa
322
324
  cacheFingerprintMatches &&
323
325
  !cacheHasUnresolvedHeaders
324
326
  ) {
325
- const cacheContribution = additiveStaticModelIds
326
- ? restoredCache.models.filter(model => !additiveStaticModelIds.has(model.id))
327
+ const cacheContribution = cacheAdditiveStaticModelIds
328
+ ? restoredCache.models.filter(model => !cacheAdditiveStaticModelIds.has(model.id))
327
329
  : restoredCache.models;
328
- const cachedModels = additiveStaticModelIds
330
+ const cachedModels = cacheAdditiveStaticModelIds
329
331
  ? mergeCatalogMetrics(
330
332
  mergeDynamicModels(staticModels, cacheContribution, mergeAuthority),
331
333
  restoredCache.models,
@@ -345,8 +347,8 @@ export async function resolveProviderModels<TApi extends Api = Api, TModelsDevPa
345
347
  : [null, null];
346
348
  const modelsDevFetchSucceeded = fetchedModelsDevModels !== null;
347
349
  const normalizedModelsDevModels = fetchedModelsDevModels?.models ?? [];
348
- const modelsDevModels = additiveStaticModelIds
349
- ? normalizedModelsDevModels.filter(model => !additiveStaticModelIds.has(model.id))
350
+ const modelsDevModels = modelsDevAdditiveStaticModelIds
351
+ ? normalizedModelsDevModels.filter(model => !modelsDevAdditiveStaticModelIds.has(model.id))
350
352
  : normalizedModelsDevModels;
351
353
  const shouldUseFreshCacheAsAuthoritative =
352
354
  strategy === "online-if-uncached" && hasUsableFreshCache && hasAuthoritativeCache;
@@ -366,10 +368,8 @@ export async function resolveProviderModels<TApi extends Api = Api, TModelsDevPa
366
368
  cacheFingerprintMatches,
367
369
  options.dropCachedModelIdsOnStaticMismatch,
368
370
  );
369
- // Additive shared-catalog rows may only introduce IDs. Apply that boundary
370
- // to cache fallback too, including snapshots written by an older binary.
371
- const cacheModels = additiveStaticModelIds
372
- ? preparedCacheModels.filter(model => !additiveStaticModelIds.has(model.id))
371
+ const cacheModels = cacheAdditiveStaticModelIds
372
+ ? preparedCacheModels.filter(model => !cacheAdditiveStaticModelIds.has(model.id))
373
373
  : preparedCacheModels;
374
374
  const dynamicModels = fetchedDynamicModels?.models ?? [];
375
375
  // A successful empty endpoint result stays authoritative for THIS cycle (so an
@@ -390,7 +390,9 @@ export async function resolveProviderModels<TApi extends Api = Api, TModelsDevPa
390
390
  fetchedModelsDevModels?.explicitKindModels,
391
391
  );
392
392
  const catalogMetricsSource = modelsDevFetchSucceeded ? normalizedModelsDevModels : preparedCacheModels;
393
- const mergedWithCatalogMetrics = additiveStaticModelIds
393
+ const mergedWithCatalogMetrics = (
394
+ modelsDevFetchSucceeded ? modelsDevAdditiveStaticModelIds : cacheAdditiveStaticModelIds
395
+ )
394
396
  ? mergeCatalogMetrics(mergedWithModelsDev, catalogMetricsSource)
395
397
  : mergedWithModelsDev;
396
398
  const mergedModels = mergeDynamicModels(
@@ -400,7 +402,11 @@ export async function resolveProviderModels<TApi extends Api = Api, TModelsDevPa
400
402
  fetchedDynamicModels?.explicitKindModels,
401
403
  );
402
404
  const models = collapseBuiltVariants(
403
- authoritativeDynamicFetchSucceeded ? retainModelIds(mergedModels, dynamicModels) : mergedModels,
405
+ authoritativeDynamicFetchSucceeded
406
+ ? retainModelIds(mergedModels, dynamicModels)
407
+ : !dynamicFetchSucceeded && isAuthoritativeDynamicCache && usableCachedModels.length > 0
408
+ ? retainModelIds(mergedModels, usableCachedModels)
409
+ : mergedModels,
404
410
  );
405
411
  const resolutionAuthoritative = !hasRemoteFetcher || remoteResolutionComplete || shouldUseFreshCacheAsAuthoritative;
406
412
  const remoteUpdatedAt = anyRemoteFetchSucceeded ? now() : undefined;
@@ -445,15 +451,18 @@ export async function resolveProviderModels<TApi extends Api = Api, TModelsDevPa
445
451
  cacheFingerprintMatches,
446
452
  options.dropCachedModelIdsOnStaticMismatch,
447
453
  );
448
- const latestCacheModels = additiveStaticModelIds
449
- ? preparedLatestCacheModels.filter(model => !additiveStaticModelIds.has(model.id))
454
+ const latestCacheModels = cacheAdditiveStaticModelIds
455
+ ? preparedLatestCacheModels.filter(model => !cacheAdditiveStaticModelIds.has(model.id))
450
456
  : preparedLatestCacheModels;
457
+ const mergedFallbackModels = mergeDynamicModels(
458
+ mergeDynamicModels(staticModels, latestCacheModels, mergeAuthority),
459
+ modelsDevModels,
460
+ mergeAuthority,
461
+ );
451
462
  const fallbackSnapshotModels = collapseBuiltVariants(
452
- mergeDynamicModels(
453
- mergeDynamicModels(staticModels, latestCacheModels, mergeAuthority),
454
- modelsDevModels,
455
- mergeAuthority,
456
- ),
463
+ isAuthoritativeDynamicCache && latestUsableCacheModels.length > 0
464
+ ? retainModelIds(mergedFallbackModels, latestUsableCacheModels)
465
+ : mergedFallbackModels,
457
466
  );
458
467
  if (fallbackSnapshotModels.length > 0 || latestCache !== null || cache !== null) {
459
468
  writeModelCache(