@tinkerlandai/indiana-sdk 0.8.0 → 0.8.3

package/dist/ai-usage-BV-FlgWr.d.ts

@@ -0,0 +1,247 @@
+import { LanguageModelV4Usage, LanguageModelV4Middleware } from '@ai-sdk/provider';
+import { F as FoundationApi, A as ApiInput } from './api-B3FIE41b.js';
+import { z } from 'zod';
+
+declare const tokenCounts: z.ZodObject<{
+    output: z.ZodNumber;
+    input: z.ZodNumber;
+    cache_read: z.ZodNumber;
+    cache_write: z.ZodNumber;
+    reasoning: z.ZodNumber;
+    input_audio: z.ZodNumber;
+    output_audio: z.ZodNumber;
+}, z.core.$strict>;
+declare const aiPriceSnapshotSchema: z.ZodObject<{
+    modelId: z.ZodString;
+    source: z.ZodEnum<{
+        custom: "custom";
+        "models.dev": "models.dev";
+    }>;
+    fetchedAt: z.ZodISODateTime;
+    rates: z.ZodObject<{
+        input: z.ZodString;
+        output: z.ZodString;
+        cache_read: z.ZodOptional<z.ZodString>;
+        cache_write: z.ZodOptional<z.ZodString>;
+        reasoning: z.ZodOptional<z.ZodString>;
+        input_audio: z.ZodOptional<z.ZodString>;
+        output_audio: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    contextTier: z.ZodNumber;
+    markupPercent: z.ZodNumber;
+}, z.core.$strict>;
+declare const aiTokenQuoteSchema: z.ZodObject<{
+    pricing: z.ZodObject<{
+        modelId: z.ZodString;
+        source: z.ZodEnum<{
+            custom: "custom";
+            "models.dev": "models.dev";
+        }>;
+        fetchedAt: z.ZodISODateTime;
+        rates: z.ZodObject<{
+            input: z.ZodString;
+            output: z.ZodString;
+            cache_read: z.ZodOptional<z.ZodString>;
+            cache_write: z.ZodOptional<z.ZodString>;
+            reasoning: z.ZodOptional<z.ZodString>;
+            input_audio: z.ZodOptional<z.ZodString>;
+            output_audio: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        contextTier: z.ZodNumber;
+        markupPercent: z.ZodNumber;
+    }, z.core.$strict>;
+    tokens: z.ZodObject<{
+        output: z.ZodNumber;
+        input: z.ZodNumber;
+        cache_read: z.ZodNumber;
+        cache_write: z.ZodNumber;
+        reasoning: z.ZodNumber;
+        input_audio: z.ZodNumber;
+        output_audio: z.ZodNumber;
+    }, z.core.$strict>;
+    quantity: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    digest: z.ZodString;
+}, z.core.$strict>;
+type AiTokenQuote = z.infer<typeof aiTokenQuoteSchema>;
+type AiTokenUsage = z.infer<typeof tokenCounts>;
+type AiPricingOptions = {
+    defaultMarkup?: number;
+    providerMarkups?: Record<string, number>;
+    modelMarkups?: Record<string, number>;
+    customModels?: Record<string, Partial<z.infer<typeof aiPriceSnapshotSchema>["rates"]>>;
+    fetch?: typeof fetch;
+};
+/** Fetch automatic model prices on a trusted backend. Quotes can be saved with a job and reused verbatim on retries. */
+declare function createAiPricing(options?: AiPricingOptions): {
+    /** Explicit refresh affects future quotes only, including their immutable timestamps and digest. */
+    refreshPrices(): void;
+    quoteTokens(input: {
+        modelId: string;
+        tokens: AiTokenUsage;
+    }): Promise<AiTokenQuote>;
+    /** All pools become one atomic balance operation. The metered entitlement unit must be one micro USD. */
+    trackTokens(client: Pick<FoundationApi, "mutateBalance">, input: {
+        customerId: string;
+        internal_feature_id: string;
+        entityId?: string;
+        idempotencyKey: string;
+        quote: AiTokenQuote;
+        properties?: Record<string, string>;
+        providerCostUsd?: string;
+        generationId?: string;
+    }): Promise<{
+        requestId: string;
+        scope: {
+            projectId: string;
+            environment: "sandbox" | "live";
+        };
+        receipt: {
+            id: string;
+            internal_feature_id: string;
+            kind: "consume" | "reserve" | "confirm" | "refund" | "release" | "expire";
+            originalId: string | null;
+            quantity: string;
+            accepted: boolean;
+            reason: "expired" | "unavailable" | "insufficient_balance" | "limit_exceeded" | "awaiting_topup" | "authorization_required" | "payment_blocked" | "cash_budget_exceeded" | null;
+            createdAt: string;
+            reservationStatus: "pending" | "expired" | "confirmed" | "released" | null;
+            expiresAt: string | null;
+            allocations: ({
+                funding: "prepaid";
+                sourceId: string;
+                units: string;
+                amount: string;
+                pricing: {
+                    internal_credit_feature_id: string | null;
+                    internal_metered_feature_id: string;
+                    dimension: string;
+                    counterKey: string;
+                    cycleStart: string;
+                    unitCost: string;
+                    units: string;
+                    amount: string;
+                    tier: number | null;
+                }[];
+            } | {
+                funding: "balance";
+                sourceId: string;
+                rolloverId: string | null;
+                units: string;
+                amount: string;
+            } | {
+                funding: "unbilled";
+                units: string;
+            } | {
+                funding: "postpaid";
+                invoiceLineId: string | null;
+                units: string;
+                authorizationId: string;
+            })[];
+            requestedQuantity?: string | undefined;
+            overageBehavior?: "cap" | "overflow" | undefined;
+        };
+    }>;
+};
+/** Read one published configuration for new provider calls. Saved quotes keep their original rules. */
+declare function createConfiguredAiPricing(client: Pick<FoundationApi, "readAiPricing">, input: ApiInput<"readAiPricing">, options?: Pick<AiPricingOptions, "fetch">): Promise<{
+    /** Explicit refresh affects future quotes only, including their immutable timestamps and digest. */
+    refreshPrices(): void;
+    quoteTokens(input: {
+        modelId: string;
+        tokens: AiTokenUsage;
+    }): Promise<AiTokenQuote>;
+    /** All pools become one atomic balance operation. The metered entitlement unit must be one micro USD. */
+    trackTokens(client: Pick<FoundationApi, "mutateBalance">, input: {
+        customerId: string;
+        internal_feature_id: string;
+        entityId?: string;
+        idempotencyKey: string;
+        quote: AiTokenQuote;
+        properties?: Record<string, string>;
+        providerCostUsd?: string;
+        generationId?: string;
+    }): Promise<{
+        requestId: string;
+        scope: {
+            projectId: string;
+            environment: "sandbox" | "live";
+        };
+        receipt: {
+            id: string;
+            internal_feature_id: string;
+            kind: "consume" | "reserve" | "confirm" | "refund" | "release" | "expire";
+            originalId: string | null;
+            quantity: string;
+            accepted: boolean;
+            reason: "expired" | "unavailable" | "insufficient_balance" | "limit_exceeded" | "awaiting_topup" | "authorization_required" | "payment_blocked" | "cash_budget_exceeded" | null;
+            createdAt: string;
+            reservationStatus: "pending" | "expired" | "confirmed" | "released" | null;
+            expiresAt: string | null;
+            allocations: ({
+                funding: "prepaid";
+                sourceId: string;
+                units: string;
+                amount: string;
+                pricing: {
+                    internal_credit_feature_id: string | null;
+                    internal_metered_feature_id: string;
+                    dimension: string;
+                    counterKey: string;
+                    cycleStart: string;
+                    unitCost: string;
+                    units: string;
+                    amount: string;
+                    tier: number | null;
+                }[];
+            } | {
+                funding: "balance";
+                sourceId: string;
+                rolloverId: string | null;
+                units: string;
+                amount: string;
+            } | {
+                funding: "unbilled";
+                units: string;
+            } | {
+                funding: "postpaid";
+                invoiceLineId: string | null;
+                units: string;
+                authorizationId: string;
+            })[];
+            requestedQuantity?: string | undefined;
+            overageBehavior?: "cap" | "overflow" | undefined;
+        };
+    }>;
+}>;
+
+type AiUsageContext = {
+    customerId: string;
+    internal_feature_id: string;
+    entityId?: string;
+    idempotencyKey: string;
+    properties?: Record<string, string>;
+};
+type AiUsageRecord = {
+    context: AiUsageContext;
+    modelId: string;
+    usage: LanguageModelV4Usage | null;
+    tokens: AiTokenUsage | null;
+    quote: AiTokenQuote | null;
+    receipt: Awaited<ReturnType<FoundationApi["mutateBalance"]>> | null;
+    phase: "captured" | "quoted" | "settled" | "incomplete";
+};
+type AiUsageMiddlewareOptions = {
+    pricing: ReturnType<typeof createAiPricing>;
+    client: Pick<FoundationApi, "mutateBalance">;
+    modelId: string;
+    /** Allocate a durable, unique ID per provider call, including each tool step. */
+    context: () => AiUsageContext | Promise<AiUsageContext>;
+    /** Save raw usage before pricing, and the frozen quote before a balance request. */
+    persist: (record: AiUsageRecord) => Promise<void>;
+    reasoning: "output" | "separate";
+    mapTokens?: (usage: LanguageModelV4Usage) => AiTokenUsage;
+};
+/** Current AI SDK v7 / LanguageModelV4 only. Never suppress a failed financial settlement. */
+declare function createAiUsageMiddleware(options: AiUsageMiddlewareOptions): LanguageModelV4Middleware;
+
+export { type AiUsageContext as A, type AiTokenUsage as a, type AiTokenQuote as b, createAiPricing as c, type AiPricingOptions as d, type AiUsageMiddlewareOptions as e, type AiUsageRecord as f, aiPriceSnapshotSchema as g, aiTokenQuoteSchema as h, createAiUsageMiddleware as i, createConfiguredAiPricing as j };