@linxiraos/pi-catalog 1.2.0 → 1.3.0

package/src/models.d.ts

@@ -1,5 +1,5 @@
 import MODELS from "./models.json";
-import type { Api, KnownProvider, Model, ModelCost, ModelPricingStatus, Usage } from "./types";
+import type { Api, KnownProvider, Model, ModelCost, ModelPricingStatus, TimeBasedCost, TokenCost, Usage } from "./types";
 export type GeneratedProvider = keyof typeof MODELS;
 /** Whether `provider` has bundled rows in models.json (e.g. a provider id authored in KDL). */
 export declare function isGeneratedProvider(provider: string): provider is GeneratedProvider;
@@ -8,6 +8,21 @@ export declare function getBundledProviders(): KnownProvider[];
 export declare function getBundledModels(provider: GeneratedProvider): Model<Api>[];
 /** Resolve display semantics without mistaking an absent rate card for a free model. */
 export declare function getModelPricingStatus(model: Pick<Model<Api>, "cost" | "pricingStatus">): ModelPricingStatus;
+/**
+ * The base token card in force at `timestamp` (Unix ms, default now): the
+ * latest due `timeBased` effective rate, else the row's own legs. Price
+ * displays read this rather than the scalar legs, which keep the card current
+ * when the row was built while bundles, caches, and long sessions outlive it.
+ * Applies no long-context tier or peak/off-peak multiplier.
+ */
+export declare function getEffectiveTokenCost(cost: ModelCost, timestamp?: number): TokenCost;
+/**
+ * Whether a schedule carries a recurring peak/off-peak tariff. A schedule with
+ * no peak windows at a 1x off-peak multiplier only carries dated rate cards
+ * (`cost-patch`/`cost-fallback` `effective-rates`): its price changes on a
+ * date, never by time of day.
+ */
+export declare function hasRecurringTariff(schedule: TimeBasedCost): boolean;
 /** Return the recurring UTC tariff period, independently of its monetary multiplier. */
 export declare function getTimeBasedPricingPeriod(cost: ModelCost, timestamp?: number): "peak" | "off-peak" | undefined;
 /** Return the next actual peak/off-peak change strictly after the Unix-ms timestamp. */