@f3d1/llmkit-shared 0.0.1

package/dist/errors.d.ts

@@ -0,0 +1,32 @@
+export declare class LLMKitError extends Error {
+    code: ErrorCode;
+    statusCode: number;
+    provider?: string | undefined;
+    constructor(message: string, code: ErrorCode, statusCode?: number, provider?: string | undefined);
+}
+export declare class BudgetExceededError extends LLMKitError {
+    budgetId: string;
+    limitCents: number;
+    usedCents: number;
+    constructor(budgetId: string, limitCents: number, usedCents: number);
+}
+export declare class ProviderError extends LLMKitError {
+    upstreamStatus?: number | undefined;
+    constructor(message: string, provider: string, upstreamStatus?: number | undefined);
+}
+export declare class AllProvidersFailedError extends LLMKitError {
+    errors: ProviderError[];
+    constructor(errors: ProviderError[]);
+}
+export declare class AuthError extends LLMKitError {
+    constructor(message?: string);
+}
+export declare class ValidationError extends LLMKitError {
+    constructor(message: string);
+}
+export declare class RateLimitError extends LLMKitError {
+    retryAfterMs?: number | undefined;
+    constructor(retryAfterMs?: number | undefined, provider?: string);
+}
+export type ErrorCode = 'BUDGET_EXCEEDED' | 'PROVIDER_ERROR' | 'ALL_PROVIDERS_FAILED' | 'AUTH_ERROR' | 'RATE_LIMIT' | 'INVALID_REQUEST' | 'INTERNAL_ERROR';
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IAG3B,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,MAAM;IAClB,QAAQ,CAAC,EAAE,MAAM;gBAHxB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,SAAS,EACf,UAAU,GAAE,MAAY,EACxB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAK3B;AAED,qBAAa,mBAAoB,SAAQ,WAAW;IAEzC,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,MAAM;gBAFjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM;CAS3B;AAED,qBAAa,aAAc,SAAQ,WAAW;IAInC,cAAc,CAAC,EAAE,MAAM;gBAF9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EACT,cAAc,CAAC,EAAE,MAAM,YAAA;CAKjC;AAED,qBAAa,uBAAwB,SAAQ,WAAW;IACnC,MAAM,EAAE,aAAa,EAAE;gBAAvB,MAAM,EAAE,aAAa,EAAE;CAO3C;AAED,qBAAa,SAAU,SAAQ,WAAW;gBAC5B,OAAO,SAA+B;CAInD;AAED,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,WAAW;IAEpC,YAAY,CAAC,EAAE,MAAM;gBAArB,YAAY,CAAC,EAAE,MAAM,YAAA,EAC5B,QAAQ,CAAC,EAAE,MAAM;CAKpB;AAED,MAAM,MAAM,SAAS,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,sBAAsB,GACtB,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,gBAAgB,CAAC"}

package/dist/errors.js

@@ -0,0 +1,64 @@
+export class LLMKitError extends Error {
+    code;
+    statusCode;
+    provider;
+    constructor(message, code, statusCode = 500, provider) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.provider = provider;
+        this.name = 'LLMKitError';
+    }
+}
+export class BudgetExceededError extends LLMKitError {
+    budgetId;
+    limitCents;
+    usedCents;
+    constructor(budgetId, limitCents, usedCents) {
+        super(`Budget exceeded: ${usedCents / 100}/${limitCents / 100} USD`, 'BUDGET_EXCEEDED', 402);
+        this.budgetId = budgetId;
+        this.limitCents = limitCents;
+        this.usedCents = usedCents;
+        this.name = 'BudgetExceededError';
+    }
+}
+export class ProviderError extends LLMKitError {
+    upstreamStatus;
+    constructor(message, provider, upstreamStatus) {
+        super(message, 'PROVIDER_ERROR', 502, provider);
+        this.upstreamStatus = upstreamStatus;
+        this.name = 'ProviderError';
+    }
+}
+export class AllProvidersFailedError extends LLMKitError {
+    errors;
+    constructor(errors) {
+        const summary = errors
+            .map((e) => `${e.provider}: ${e.message}`)
+            .join('; ');
+        super(`All providers failed: ${summary}`, 'ALL_PROVIDERS_FAILED', 503);
+        this.errors = errors;
+        this.name = 'AllProvidersFailedError';
+    }
+}
+export class AuthError extends LLMKitError {
+    constructor(message = 'Invalid or missing API key') {
+        super(message, 'AUTH_ERROR', 401);
+        this.name = 'AuthError';
+    }
+}
+export class ValidationError extends LLMKitError {
+    constructor(message) {
+        super(message, 'INVALID_REQUEST', 400);
+        this.name = 'ValidationError';
+    }
+}
+export class RateLimitError extends LLMKitError {
+    retryAfterMs;
+    constructor(retryAfterMs, provider) {
+        super('Rate limit exceeded', 'RATE_LIMIT', 429, provider);
+        this.retryAfterMs = retryAfterMs;
+        this.name = 'RateLimitError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAG3B;IACA;IACA;IAJT,YACE,OAAe,EACR,IAAe,EACf,aAAqB,GAAG,EACxB,QAAiB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAW;QACf,eAAU,GAAV,UAAU,CAAc;QACxB,aAAQ,GAAR,QAAQ,CAAS;QAGxB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAEzC;IACA;IACA;IAHT,YACS,QAAgB,EAChB,UAAkB,EAClB,SAAiB;QAExB,KAAK,CACH,oBAAoB,SAAS,GAAG,GAAG,IAAI,UAAU,GAAG,GAAG,MAAM,EAC7D,iBAAiB,EACjB,GAAG,CACJ,CAAC;QARK,aAAQ,GAAR,QAAQ,CAAQ;QAChB,eAAU,GAAV,UAAU,CAAQ;QAClB,cAAS,GAAT,SAAS,CAAQ;QAOxB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,WAAW;IAInC;IAHT,YACE,OAAe,EACf,QAAgB,EACT,cAAuB;QAE9B,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAFzC,mBAAc,GAAd,cAAc,CAAS;QAG9B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IACnC;IAAnB,YAAmB,MAAuB;QACxC,MAAM,OAAO,GAAG,MAAM;aACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aACzC,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,KAAK,CAAC,yBAAyB,OAAO,EAAE,EAAE,sBAAsB,EAAE,GAAG,CAAC,CAAC;QAJtD,WAAM,GAAN,MAAM,CAAiB;QAKxC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC,YAAY,OAAO,GAAG,4BAA4B;QAChD,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAEpC;IADT,YACS,YAAqB,EAC5B,QAAiB;QAEjB,KAAK,CAAC,qBAAqB,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAHnD,iBAAY,GAAZ,YAAY,CAAS;QAI5B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './errors.js';
+export * from './providers.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './errors.js';
+export * from './providers.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,14 @@
+import type { ProviderName } from './types.js';
+interface ModelPricing {
+    inputPerMillion: number;
+    outputPerMillion: number;
+    cacheReadPerMillion?: number;
+    cacheWritePerMillion?: number;
+}
+type PricingTable = Record<string, ModelPricing>;
+declare const PRICING: Record<ProviderName, PricingTable>;
+export declare function getModelPricing(provider: ProviderName, model: string): ModelPricing | undefined;
+export declare function calculateCost(provider: ProviderName, model: string, inputTokens: number, outputTokens: number, cacheReadTokens?: number, cacheWriteTokens?: number): number;
+export { PRICING };
+export type { ModelPricing, PricingTable };
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,UAAU,YAAY;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAIjD,QAAA,MAAM,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,CAkG/C,CAAC;AAEF,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,GACZ,YAAY,GAAG,SAAS,CAwB1B;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,SAAI,EACnB,gBAAgB,SAAI,GACnB,MAAM,CAgBR;AAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/providers.js

@@ -0,0 +1,131 @@
+// last updated: 2026-02-20
+// prices in USD per 1M tokens
+const PRICING = {
+    anthropic: {
+        'claude-sonnet-4-20250514': {
+            inputPerMillion: 3.0,
+            outputPerMillion: 15.0,
+            cacheReadPerMillion: 0.3,
+            cacheWritePerMillion: 3.75,
+        },
+        'claude-3-5-haiku-20241022': {
+            inputPerMillion: 0.8,
+            outputPerMillion: 4.0,
+            cacheReadPerMillion: 0.08,
+            cacheWritePerMillion: 1.0,
+        },
+        'claude-3-haiku-20240307': {
+            inputPerMillion: 0.25,
+            outputPerMillion: 1.25,
+        },
+        'claude-opus-4-20250514': {
+            inputPerMillion: 15.0,
+            outputPerMillion: 75.0,
+            cacheReadPerMillion: 1.5,
+            cacheWritePerMillion: 18.75,
+        },
+    },
+    openai: {
+        'gpt-4o': { inputPerMillion: 2.5, outputPerMillion: 10.0 },
+        'gpt-4o-mini': { inputPerMillion: 0.15, outputPerMillion: 0.6 },
+        'o3': { inputPerMillion: 2.0, outputPerMillion: 8.0 },
+        'o3-mini': { inputPerMillion: 1.1, outputPerMillion: 4.4 },
+        'gpt-4-turbo': { inputPerMillion: 10.0, outputPerMillion: 30.0 },
+    },
+    gemini: {
+        'gemini-2.0-flash': { inputPerMillion: 0.1, outputPerMillion: 0.4 },
+        'gemini-2.5-pro': { inputPerMillion: 1.25, outputPerMillion: 10.0 },
+        'gemini-2.5-flash': { inputPerMillion: 0.15, outputPerMillion: 0.6 },
+    },
+    groq: {
+        // mixtral-8x7b discontinued on Groq as of late 2025
+        'llama-3.3-70b-versatile': { inputPerMillion: 0.59, outputPerMillion: 0.79 },
+        'llama-3.1-8b-instant': { inputPerMillion: 0.05, outputPerMillion: 0.08 },
+        'gemma2-9b-it': { inputPerMillion: 0.20, outputPerMillion: 0.20 },
+    },
+    together: {
+        'meta-llama/Meta-Llama-3.3-70B-Instruct-Turbo': { inputPerMillion: 0.88, outputPerMillion: 0.88 },
+        'meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo': { inputPerMillion: 0.18, outputPerMillion: 0.18 },
+        'Qwen/Qwen2.5-72B-Instruct-Turbo': { inputPerMillion: 1.20, outputPerMillion: 1.20 },
+        'mistralai/Mixtral-8x7B-Instruct-v0.1': { inputPerMillion: 0.60, outputPerMillion: 0.60 },
+    },
+    fireworks: {
+        // fireworks gives 50% discount on cached input automatically
+        'accounts/fireworks/models/llama-v3p3-70b-instruct': {
+            inputPerMillion: 0.90, outputPerMillion: 0.90,
+            cacheReadPerMillion: 0.45,
+        },
+        'accounts/fireworks/models/llama-v3p1-8b-instruct': {
+            inputPerMillion: 0.20, outputPerMillion: 0.20,
+            cacheReadPerMillion: 0.10,
+        },
+    },
+    deepseek: {
+        // V3.2 unified pricing (Sep 2025) - both models same rate
+        // cache hits are 90% cheaper, auto-caching no config needed
+        'deepseek-chat': {
+            inputPerMillion: 0.28,
+            outputPerMillion: 0.42,
+            cacheReadPerMillion: 0.028,
+        },
+        'deepseek-reasoner': {
+            inputPerMillion: 0.28,
+            outputPerMillion: 0.42,
+            cacheReadPerMillion: 0.028,
+        },
+    },
+    mistral: {
+        'mistral-large-latest': { inputPerMillion: 2.0, outputPerMillion: 6.0 },
+        'mistral-small-latest': { inputPerMillion: 0.10, outputPerMillion: 0.30 },
+        'codestral-latest': { inputPerMillion: 0.30, outputPerMillion: 0.90 },
+    },
+    xai: {
+        'grok-2': { inputPerMillion: 2.0, outputPerMillion: 10.0 },
+        'grok-3': { inputPerMillion: 3.0, outputPerMillion: 15.0 },
+        'grok-3-mini': { inputPerMillion: 0.30, outputPerMillion: 0.50 },
+    },
+    // local models - no cost
+    ollama: {},
+    // meta-gateway, pricing varies per model - tracked by underlying provider
+    openrouter: {},
+};
+export function getModelPricing(provider, model) {
+    const providerPricing = PRICING[provider];
+    if (!providerPricing)
+        return undefined;
+    // exact match first
+    if (providerPricing[model])
+        return providerPricing[model];
+    // prefix match for versioned models (e.g. "claude-sonnet-4" matches "claude-sonnet-4-20250514")
+    // longest match wins to avoid "gpt-4o" matching before "gpt-4o-mini"
+    let best;
+    let bestLen = 0;
+    for (const [key, pricing] of Object.entries(providerPricing)) {
+        if (model.startsWith(key) && key.length > bestLen) {
+            bestLen = key.length;
+            best = pricing;
+        }
+        if (key.startsWith(model) && model.length > bestLen) {
+            bestLen = model.length;
+            best = pricing;
+        }
+    }
+    return best;
+}
+export function calculateCost(provider, model, inputTokens, outputTokens, cacheReadTokens = 0, cacheWriteTokens = 0) {
+    const pricing = getModelPricing(provider, model);
+    if (!pricing)
+        return 0;
+    let cost = 0;
+    cost += (inputTokens / 1_000_000) * pricing.inputPerMillion;
+    cost += (outputTokens / 1_000_000) * pricing.outputPerMillion;
+    if (pricing.cacheReadPerMillion && cacheReadTokens > 0) {
+        cost += (cacheReadTokens / 1_000_000) * pricing.cacheReadPerMillion;
+    }
+    if (pricing.cacheWritePerMillion && cacheWriteTokens > 0) {
+        cost += (cacheWriteTokens / 1_000_000) * pricing.cacheWritePerMillion;
+    }
+    return cost;
+}
+export { PRICING };
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,89 @@
+export interface LLMRequest {
+    provider: ProviderName;
+    model: string;
+    messages: Message[];
+    stream?: boolean;
+    temperature?: number;
+    maxTokens?: number;
+    sessionId?: string;
+}
+export interface LLMResponse {
+    id: string;
+    provider: ProviderName;
+    model: string;
+    content: string;
+    usage: TokenUsage;
+    cost: CostBreakdown;
+    latencyMs: number;
+    cached: boolean;
+    sessionId?: string;
+}
+export interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    totalTokens: number;
+}
+export interface CostBreakdown {
+    inputCost: number;
+    outputCost: number;
+    cacheReadCost?: number;
+    cacheWriteCost?: number;
+    totalCost: number;
+    currency: 'USD';
+}
+export interface Budget {
+    id: string;
+    keyId: string;
+    limitCents: number;
+    usedCents: number;
+    period: 'daily' | 'weekly' | 'monthly';
+    resetAt: Date;
+    scope?: 'key' | 'session';
+}
+export interface BudgetAlert {
+    type: 'budget.threshold';
+    budgetId: string;
+    usedCents: number;
+    limitCents: number;
+    percentage: number;
+    period: string;
+    timestamp: string;
+}
+export interface SessionSummary {
+    sessionId: string;
+    requestCount: number;
+    totalCost: CostBreakdown;
+    totalTokens: TokenUsage;
+    providers: ProviderName[];
+    startedAt: Date;
+    lastRequestAt: Date;
+    durationMs: number;
+}
+export type ProviderName = 'anthropic' | 'openai' | 'gemini' | 'groq' | 'together' | 'fireworks' | 'deepseek' | 'mistral' | 'xai' | 'ollama' | 'openrouter';
+export interface ProviderConfig {
+    name: ProviderName;
+    apiKey: string;
+    baseUrl?: string;
+    priority: number;
+    enabled: boolean;
+}
+export interface FallbackConfig {
+    providers: ProviderName[];
+    retryOn: number[];
+    maxRetries: number;
+}
+export interface LLMKitConfig {
+    apiKey: string;
+    baseUrl?: string;
+    defaultProvider?: ProviderName;
+    fallback?: FallbackConfig;
+    sessionId?: string;
+    budgetId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvC,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,aAAa,EAAE,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,UAAU,GACV,WAAW,GACX,UAAU,GACV,SAAS,GACT,KAAK,GACL,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@f3d1/llmkit-shared",
+  "version": "0.0.1",
+  "license": "MIT",
+  "description": "Shared types, pricing data, and constants for LLMKit packages",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}