captify 0.1.18 → 0.1.19

package/dist/model-budget/model-budget.interfaces.d.ts

@@ -0,0 +1,426 @@
+/**
+ * Model Budget module interfaces
+ *
+ * TypeScript interfaces for budget and rate limit tracking.
+ * This module contains all type definitions used across the model-budget feature.
+ */
+import type { BudgetConfig, Model } from "../llm-providers/llm-providers.schemas";
+import type { UserAwsCredentials } from "../shared/services";
+import type { Logger } from "../shared/services/logger";
+import type { ModelUsageResponseSchema, BudgetConfigFormValues } from "./model-budget.schemas";
+import type { ModelBudgetService } from "./services/model-budget.service";
+/**
+ * Extended model type with budget configuration and usage data.
+ * Used by components and hooks that display models with their budget status.
+ */
+export interface ModelWithBudget extends Model {
+    /** Display name of the provider this model belongs to */
+    providerName: string;
+    /** Current usage statistics for this model (from batch usage query) */
+    usage?: ModelUsageResponseSchema | null;
+    /** Whether usage data is currently being loaded */
+    isLoadingUsage?: boolean;
+}
+/**
+ * Result of checking budget limits.
+ * Used when checking if a request is allowed based on budget.
+ */
+export interface BudgetCheckResult {
+    allowed: boolean;
+    reason?: "budget_exceeded" | "token_limit_exceeded";
+    spent?: number;
+    limit?: number;
+    remaining?: number;
+    tokenSpent?: number;
+    tokenLimit?: number;
+    tokenRemaining?: number;
+    /** Unix timestamp (milliseconds) of period start */
+    periodStart?: number;
+    /** Unix timestamp (milliseconds) of period end */
+    periodEnd?: number;
+}
+/**
+ * Result of checking rate limits.
+ * Used when checking if a request is allowed based on rate limit.
+ */
+export interface RateLimitCheckResult {
+    allowed: boolean;
+    reason?: "rate_limit_exceeded";
+    current?: number;
+    limit?: number;
+    resetsIn?: number;
+}
+/**
+ * Combined result of checking all limits (budget + rate).
+ */
+export interface LimitCheckResult {
+    allowed: boolean;
+    reason?: "budget_exceeded" | "rate_limit_exceeded" | "token_limit_exceeded";
+    budget?: BudgetCheckResult;
+    rateLimit?: RateLimitCheckResult;
+}
+/**
+ * Base parameters for model-scoped budget operations.
+ *
+ * IMPORTANT: Uses stable Model.id (UUID) for keys, NOT the mutable modelId.
+ * This ensures usage history is preserved when display modelId changes.
+ */
+export interface ModelBudgetParams {
+    tenantId: string;
+    providerId: string;
+    /**
+     * The stable Model.id (UUID), NOT the mutable display modelId.
+     * This ensures usage records are not orphaned when modelId changes.
+     */
+    modelId: string;
+    /**
+     * User-specific AWS credentials for governance compliance.
+     * When provided, operations use these credentials instead of service account.
+     * This enables IAM-based access control per user.
+     */
+    userCredentials?: UserAwsCredentials;
+    /** Index signature for logger compatibility */
+    [key: string]: unknown;
+}
+/**
+ * Parameters for recording spend after a request completes.
+ */
+export interface RecordSpendParams extends ModelBudgetParams {
+    amount: number;
+    tokens?: number;
+    /** Index signature for logger compatibility */
+    [key: string]: unknown;
+}
+/**
+ * Parameters for checking limits before a request.
+ */
+export type CheckLimitsParams = ModelBudgetParams;
+/**
+ * Parameters for recording a request (rate limit tracking).
+ */
+export type RecordRequestParams = ModelBudgetParams;
+/**
+ * Parameters for getting current usage statistics.
+ */
+export type GetUsageParams = ModelBudgetParams;
+/**
+ * Budget usage information for API responses.
+ */
+export interface BudgetUsage {
+    limit: number;
+    spent: number;
+    remaining: number;
+    /** Unix timestamp (milliseconds) of period start */
+    periodStart: number;
+    /** Unix timestamp (milliseconds) of period end */
+    periodEnd: number;
+    requestCount?: number;
+}
+/**
+ * Token usage information for API responses.
+ */
+export interface TokenUsageInfo {
+    limit: number;
+    used: number;
+    remaining: number;
+}
+/**
+ * Rate limit information for API responses.
+ */
+export interface RateLimitInfo {
+    limit: number;
+    currentMinuteCount: number;
+    resetsIn: number;
+}
+/**
+ * Complete model usage response for API endpoints.
+ */
+export interface ModelUsageResponse {
+    modelId: string;
+    providerId: string;
+    tenantId: string;
+    budget?: BudgetUsage;
+    tokenUsage?: TokenUsageInfo;
+    rateLimit?: RateLimitInfo;
+    hasLimitsConfigured: boolean;
+}
+/**
+ * Details included in budget exceeded error responses.
+ */
+export interface BudgetExceededDetails {
+    modelId: string;
+    providerId: string;
+    spent: number;
+    limit: number;
+    /** Unix timestamp (milliseconds) when period ends */
+    periodEnds: number;
+}
+/**
+ * Details included in rate limit exceeded error responses.
+ */
+export interface RateLimitExceededDetails {
+    modelId: string;
+    providerId: string;
+    current: number;
+    limit: number;
+    retryAfter: number;
+}
+/**
+ * Details included in token limit exceeded error responses.
+ */
+export interface TokenLimitExceededDetails {
+    modelId: string;
+    providerId: string;
+    used: number;
+    limit: number;
+    /** Unix timestamp (milliseconds) when period ends */
+    periodEnds: number;
+}
+/**
+ * Cached model configuration with budget config.
+ */
+export interface CachedModelConfig {
+    budgetConfig: BudgetConfig;
+    cachedAt: number;
+}
+/**
+ * Props for BudgetModelCard component.
+ * Displays a model's budget configuration in a card format.
+ */
+export interface BudgetModelCardProps {
+    /** Model with budget configuration */
+    model: ModelWithBudget;
+    /** Callback when configure button is clicked */
+    onConfigure: (model: ModelWithBudget) => void;
+    /** Callback when enable/disable toggle is changed */
+    onToggleEnabled?: (model: ModelWithBudget, enabled: boolean) => void;
+    /** Whether toggle action is in progress */
+    isToggling?: boolean;
+    /** Whether selection mode is active */
+    selectionMode?: boolean;
+    /** Whether this card is selected */
+    isSelected?: boolean;
+    /** Callback when selection changes */
+    onSelectChange?: (model: ModelWithBudget, selected: boolean) => void;
+    /** Callback when duplicate button is clicked */
+    onDuplicate?: (model: ModelWithBudget) => void;
+    /** Whether the card is in read-only mode (hides edit actions) */
+    readOnly?: boolean;
+}
+/**
+ * Props for UsageModelCard component.
+ * Displays usage statistics for a single model.
+ */
+export interface UsageModelCardProps {
+    model: ModelWithBudget;
+}
+/**
+ * Props for BudgetUsageDisplay component.
+ * Displays current model usage statistics including budget, rate limits, and tokens.
+ */
+export interface BudgetUsageDisplayProps {
+    /** Usage data from the API */
+    usage?: ModelUsageResponseSchema | null;
+    /** Whether the data is loading */
+    isLoading?: boolean;
+    /** Error from loading data */
+    error?: Error | null;
+    /** Additional CSS classes */
+    className?: string;
+    /** Compact mode for smaller displays */
+    compact?: boolean;
+}
+/**
+ * Props for BudgetConfigDialog component.
+ * Dialog for configuring model budget and rate limits.
+ */
+export interface BudgetConfigDialogProps {
+    /** Whether the dialog is open */
+    open: boolean;
+    /** Callback when dialog open state changes */
+    onOpenChange: (open: boolean) => void;
+    /** Model display name */
+    modelName: string;
+    /** Model ID */
+    modelId: string;
+    /** Existing budget configuration */
+    budgetConfig?: BudgetConfig | null;
+    /** Callback when configuration is saved */
+    onSave: (config: BudgetConfigFormValues) => Promise<void>;
+    /** Callback when configuration is deleted */
+    onDelete: () => Promise<void>;
+    /** Whether delete is in progress */
+    isDeleting?: boolean;
+    /** Whether the dialog is in read-only mode (hides save/delete actions) */
+    readOnly?: boolean;
+}
+/**
+ * Props for AddBudgetDialog component.
+ * Dialog for adding a new budget configuration.
+ */
+export interface AddBudgetDialogProps {
+    /** Whether the dialog is open */
+    open: boolean;
+    /** Callback when dialog open state changes */
+    onOpenChange: (open: boolean) => void;
+    /** Models without budget configurations */
+    modelsWithoutBudgets: ModelWithBudget[];
+    /** Callback when budget is saved */
+    onSave: (model: ModelWithBudget, config: BudgetConfigFormValues) => Promise<void>;
+    /** Whether save is in progress */
+    isSaving?: boolean;
+}
+/**
+ * Props for DuplicateBudgetDialog component.
+ * Dialog for duplicating a budget configuration to another model.
+ */
+export interface DuplicateBudgetDialogProps {
+    /** Whether the dialog is open */
+    open: boolean;
+    /** Callback when dialog open state changes */
+    onOpenChange: (open: boolean) => void;
+    /** The model to copy configuration from */
+    sourceModel: ModelWithBudget | null;
+    /** Models without budget configurations (potential targets) */
+    targetModels: ModelWithBudget[];
+    /** Callback when duplication is confirmed */
+    onDuplicate: (targetModel: ModelWithBudget, sourceConfig: NonNullable<BudgetConfig>) => Promise<void>;
+    /** Whether duplication is in progress */
+    isDuplicating?: boolean;
+}
+/**
+ * Props for BudgetSummaryStats component.
+ * Displays summary statistics for all budget configurations.
+ */
+export interface BudgetSummaryStatsProps {
+    models: ModelWithBudget[];
+    isLoading?: boolean;
+}
+/**
+ * Props for UsageSummaryStats component.
+ * Displays aggregated usage statistics across all models.
+ */
+export interface UsageSummaryStatsProps {
+    models: ModelWithBudget[];
+    isLoading?: boolean;
+    isLoadingUsage?: boolean;
+}
+/**
+ * Props for BudgetEmptyState component.
+ * Empty state displayed when no budgets are configured.
+ */
+export interface BudgetEmptyStateProps {
+    onAddBudget: () => void;
+    /** Whether the user can add budgets (hides CTA when false) */
+    canAddBudget?: boolean;
+}
+/**
+ * Budget status filter values.
+ */
+export type BudgetStatusFilter = "all" | "active" | "disabled" | "over-budget" | "near-limit";
+/**
+ * Props for BudgetFilters component.
+ * Search and filter controls for budget management.
+ */
+export interface BudgetFiltersProps {
+    searchQuery: string;
+    onSearchChange: (query: string) => void;
+    statusFilter: BudgetStatusFilter;
+    onStatusFilterChange: (status: BudgetStatusFilter) => void;
+    counts: {
+        all: number;
+        active: number;
+        disabled: number;
+        overBudget: number;
+        nearLimit: number;
+    };
+}
+/**
+ * Violation type for budget/rate limit violations.
+ */
+export type ViolationType = "budget_exceeded" | "rate_limit_exceeded" | "token_limit_exceeded";
+/**
+ * Violation record for display in ViolationsPanel.
+ */
+export interface Violation {
+    id: string;
+    type: ViolationType;
+    modelId: string;
+    modelName: string;
+    providerId: string;
+    providerName: string;
+    timestamp: Date;
+    details: {
+        current: number;
+        limit: number;
+    };
+}
+/**
+ * Props for ViolationsPanel component.
+ * Displays recent budget/rate limit violations.
+ */
+export interface ViolationsPanelProps {
+    violations: Violation[];
+    isLoading?: boolean;
+    maxHeight?: string;
+    /** Callback when a violation is clicked */
+    onViolationClick?: (violation: Violation) => void;
+}
+/**
+ * Parameters for usage tracking operations.
+ * Used when checking limits before requests or recording usage after.
+ *
+ * IMPORTANT: Uses stable Model.id (UUID) for keys, NOT the mutable modelId.
+ */
+export interface UsageTrackingParams {
+    /** Tenant identifier for multi-tenant isolation */
+    tenantId: string;
+    /** Provider identifier (UUID) */
+    providerId: string;
+    /**
+     * The stable Model.id (UUID), NOT the mutable display modelId.
+     * This ensures usage records are not orphaned when modelId changes.
+     */
+    modelId: string;
+    /**
+     * Optional user-specific AWS credentials for governance compliance.
+     * When provided, operations use these credentials instead of service account.
+     */
+    userCredentials?: UserAwsCredentials;
+}
+/**
+ * Usage data from AI SDK response.
+ * Contains token counts from LLM completion.
+ */
+export interface UsageData {
+    /** Number of tokens in the input/prompt */
+    inputTokens?: number;
+    /** Number of tokens in the output/completion */
+    outputTokens?: number;
+    /** Total tokens (input + output) */
+    totalTokens?: number;
+    /** Tokens used for reasoning (for models that support it) */
+    reasoningTokens?: number;
+}
+/**
+ * Result of recording usage after an LLM call.
+ */
+export interface UsageRecordResult {
+    /** Total tokens used in the request */
+    tokens: number;
+    /** Estimated cost in USD */
+    cost: number;
+    /** Whether the usage was successfully recorded */
+    recorded: boolean;
+}
+/**
+ * Dependencies for UsageTrackingService.
+ * Used for dependency injection in service instantiation.
+ */
+export interface UsageTrackingServiceDeps {
+    /** Custom logger instance */
+    logger?: Logger;
+    /** Custom budget service instance */
+    budgetService?: ModelBudgetService;
+}
+//# sourceMappingURL=model-budget.interfaces.d.ts.map

package/dist/model-budget/model-budget.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-budget.interfaces.d.ts","sourceRoot":"","sources":["../../lib/model-budget/model-budget.interfaces.ts"],"names":[],"mappings":"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"}

package/dist/model-budget/model-budget.interfaces.js

@@ -0,0 +1,8 @@
+/**
+ * Model Budget module interfaces
+ *
+ * TypeScript interfaces for budget and rate limit tracking.
+ * This module contains all type definitions used across the model-budget feature.
+ */
+export {};
+//# sourceMappingURL=model-budget.interfaces.js.map

package/dist/model-budget/model-budget.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-budget.interfaces.js","sourceRoot":"","sources":["../../lib/model-budget/model-budget.interfaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/model-budget/model-budget.schemas.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Model Budget module Zod schemas
+ *
+ * Validation schemas for API requests and responses.
+ */
+import { z } from "zod";
+/**
+ * Budget period type enum for API requests.
+ */
+export declare const budgetPeriodTypeSchema: z.ZodEnum<{
+    custom: "custom";
+    monthly: "monthly";
+    weekly: "weekly";
+    daily: "daily";
+}>;
+export type BudgetPeriodType = z.infer<typeof budgetPeriodTypeSchema>;
+/**
+ * Schema for setting/updating budget configuration via API.
+ * Used by PUT /api/llm-providers/:providerId/models/:modelId/budget
+ */
+export declare const setBudgetConfigBodySchema: z.ZodObject<{
+    budgetAmount: z.ZodNumber;
+    budgetPeriodType: z.ZodDefault<z.ZodEnum<{
+        custom: "custom";
+        monthly: "monthly";
+        weekly: "weekly";
+        daily: "daily";
+    }>>;
+    budgetPeriodDays: z.ZodOptional<z.ZodNumber>;
+    requestsPerMinute: z.ZodNumber;
+    tokenLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    isEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type SetBudgetConfigBody = z.infer<typeof setBudgetConfigBodySchema>;
+/**
+ * Schema for a single model identifier in batch requests.
+ */
+export declare const modelIdentifierSchema: z.ZodObject<{
+    providerId: z.ZodString;
+    modelId: z.ZodString;
+}, z.core.$strip>;
+export type ModelIdentifier = z.infer<typeof modelIdentifierSchema>;
+/**
+ * Schema for batch usage request body.
+ * Used by POST /api/llm-providers/usage/batch
+ */
+export declare const batchUsageBodySchema: z.ZodObject<{
+    models: z.ZodArray<z.ZodObject<{
+        providerId: z.ZodString;
+        modelId: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BatchUsageBody = z.infer<typeof batchUsageBodySchema>;
+/**
+ * Schema for budget usage in API responses.
+ */
+export declare const budgetUsageSchema: z.ZodObject<{
+    limit: z.ZodNumber;
+    spent: z.ZodNumber;
+    remaining: z.ZodNumber;
+    periodStart: z.ZodString;
+    periodEnd: z.ZodString;
+    requestCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for token usage in API responses.
+ */
+export declare const tokenUsageSchema: z.ZodObject<{
+    limit: z.ZodNumber;
+    used: z.ZodNumber;
+    remaining: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Schema for rate limit info in API responses.
+ */
+export declare const rateLimitInfoSchema: z.ZodObject<{
+    limit: z.ZodNumber;
+    currentMinuteCount: z.ZodNumber;
+    resetsIn: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Schema for complete model usage response.
+ * Used by GET /api/llm-providers/:providerId/models/:modelId/usage
+ */
+export declare const modelUsageResponseSchema: z.ZodObject<{
+    modelId: z.ZodString;
+    providerId: z.ZodString;
+    tenantId: z.ZodString;
+    budget: z.ZodOptional<z.ZodObject<{
+        limit: z.ZodNumber;
+        spent: z.ZodNumber;
+        remaining: z.ZodNumber;
+        periodStart: z.ZodString;
+        periodEnd: z.ZodString;
+        requestCount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    tokenUsage: z.ZodOptional<z.ZodObject<{
+        limit: z.ZodNumber;
+        used: z.ZodNumber;
+        remaining: z.ZodNumber;
+    }, z.core.$strip>>;
+    rateLimit: z.ZodOptional<z.ZodObject<{
+        limit: z.ZodNumber;
+        currentMinuteCount: z.ZodNumber;
+        resetsIn: z.ZodNumber;
+    }, z.core.$strip>>;
+    hasLimitsConfigured: z.ZodBoolean;
+}, z.core.$strip>;
+export type ModelUsageResponseSchema = z.infer<typeof modelUsageResponseSchema>;
+/**
+ * Schema for budget exceeded error response.
+ */
+export declare const budgetExceededResponseSchema: z.ZodObject<{
+    error: z.ZodLiteral<"budget_exceeded">;
+    message: z.ZodString;
+    details: z.ZodObject<{
+        modelId: z.ZodString;
+        providerId: z.ZodString;
+        spent: z.ZodNumber;
+        limit: z.ZodNumber;
+        periodEnds: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Schema for rate limit exceeded error response.
+ */
+export declare const rateLimitExceededResponseSchema: z.ZodObject<{
+    error: z.ZodLiteral<"rate_limit_exceeded">;
+    message: z.ZodString;
+    details: z.ZodObject<{
+        modelId: z.ZodString;
+        providerId: z.ZodString;
+        current: z.ZodNumber;
+        limit: z.ZodNumber;
+        retryAfter: z.ZodNumber;
+    }, z.core.$strip>;
+    retryAfter: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Schema for token limit exceeded error response.
+ */
+export declare const tokenLimitExceededResponseSchema: z.ZodObject<{
+    error: z.ZodLiteral<"token_limit_exceeded">;
+    message: z.ZodString;
+    details: z.ZodObject<{
+        modelId: z.ZodString;
+        providerId: z.ZodString;
+        used: z.ZodNumber;
+        limit: z.ZodNumber;
+        periodEnds: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Schema for the budget configuration form input.
+ * Used by the BudgetConfigForm component for client-side validation.
+ */
+export declare const budgetConfigFormSchema: z.ZodObject<{
+    budgetAmount: z.ZodNumber;
+    budgetPeriodType: z.ZodEnum<{
+        custom: "custom";
+        monthly: "monthly";
+        weekly: "weekly";
+        daily: "daily";
+    }>;
+    budgetPeriodDays: z.ZodOptional<z.ZodNumber>;
+    requestsPerMinute: z.ZodNumber;
+    tokenLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    isEnabled: z.ZodBoolean;
+}, z.core.$strip>;
+export type BudgetConfigFormValues = z.infer<typeof budgetConfigFormSchema>;
+//# sourceMappingURL=model-budget.schemas.d.ts.map

package/dist/model-budget/model-budget.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-budget.schemas.d.ts","sourceRoot":"","sources":["../../lib/model-budget/model-budget.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;EAEF,CAAC;AAElC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;iBAmClC,CAAC;AAEL,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;iBAM/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;iBAO5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;iBAQnC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAMhF;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;iBAUvC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;iBAW1C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;iBAU3C,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAyB/B,CAAC;AAEL,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}