@agtlantis/core 0.5.0 → 0.6.0

package/dist/pricing/defaults.js

@@ -0,0 +1,139 @@
+/**
+ * Built-in pricing tables (USD per million tokens).
+ *
+ * These are the default prices for common models. They can be overridden
+ * using `configurePricing()` (global) or `Provider.withPricing()` (per-provider).
+ *
+ * Last updated: January 2025
+ *
+ * @module pricing/defaults
+ */
+/**
+ * OpenAI model pricing.
+ * @see https://openai.com/pricing
+ */
+export const OPENAI_PRICING = {
+    'gpt-4o': { inputPricePerMillion: 2.5, outputPricePerMillion: 10.0 },
+    'gpt-4o-mini': { inputPricePerMillion: 0.15, outputPricePerMillion: 0.6 },
+    'gpt-4-turbo': { inputPricePerMillion: 10.0, outputPricePerMillion: 30.0 },
+    'gpt-4-turbo-preview': {
+        inputPricePerMillion: 10.0,
+        outputPricePerMillion: 30.0,
+    },
+    'gpt-4': { inputPricePerMillion: 30.0, outputPricePerMillion: 60.0 },
+    'gpt-4-32k': { inputPricePerMillion: 60.0, outputPricePerMillion: 120.0 },
+    'gpt-3.5-turbo': { inputPricePerMillion: 0.5, outputPricePerMillion: 1.5 },
+    'gpt-3.5-turbo-16k': {
+        inputPricePerMillion: 3.0,
+        outputPricePerMillion: 4.0,
+    },
+    'o1': { inputPricePerMillion: 15.0, outputPricePerMillion: 60.0 },
+    'o1-mini': { inputPricePerMillion: 3.0, outputPricePerMillion: 12.0 },
+    'o1-preview': { inputPricePerMillion: 15.0, outputPricePerMillion: 60.0 },
+    'o3': { inputPricePerMillion: 20.0, outputPricePerMillion: 80.0 },
+    'o3-mini': { inputPricePerMillion: 4.0, outputPricePerMillion: 16.0 },
+};
+/**
+ * Google Gemini model pricing.
+ * @see https://ai.google.dev/gemini-api/docs/pricing
+ */
+export const GOOGLE_PRICING = {
+    'gemini-2.5-flash': {
+        inputPricePerMillion: 0.15,
+        outputPricePerMillion: 0.6,
+        cachedInputPricePerMillion: 0.0375,
+    },
+    'gemini-2.5-flash-lite': {
+        inputPricePerMillion: 0.075,
+        outputPricePerMillion: 0.3,
+        cachedInputPricePerMillion: 0.01875,
+    },
+    'gemini-2.5-pro': {
+        inputPricePerMillion: 1.25,
+        outputPricePerMillion: 10.0,
+        cachedInputPricePerMillion: 0.3125,
+    },
+    'gemini-2.0-flash': {
+        inputPricePerMillion: 0.1,
+        outputPricePerMillion: 0.4,
+        cachedInputPricePerMillion: 0.025,
+    },
+    'gemini-2.0-flash-lite': {
+        inputPricePerMillion: 0.075,
+        outputPricePerMillion: 0.3,
+        cachedInputPricePerMillion: 0.01875,
+    },
+    'gemini-1.5-pro': {
+        inputPricePerMillion: 1.25,
+        outputPricePerMillion: 5.0,
+        cachedInputPricePerMillion: 0.3125,
+    },
+    'gemini-1.5-flash': {
+        inputPricePerMillion: 0.075,
+        outputPricePerMillion: 0.3,
+        cachedInputPricePerMillion: 0.01875,
+    },
+    'gemini-1.5-flash-8b': {
+        inputPricePerMillion: 0.0375,
+        outputPricePerMillion: 0.15,
+        cachedInputPricePerMillion: 0.01,
+    },
+    'gemini-pro': { inputPricePerMillion: 0.5, outputPricePerMillion: 1.5 },
+};
+/**
+ * Anthropic Claude model pricing.
+ * @see https://www.anthropic.com/pricing
+ */
+export const ANTHROPIC_PRICING = {
+    'claude-opus-4-5-20250514': {
+        inputPricePerMillion: 15.0,
+        outputPricePerMillion: 75.0,
+        cachedInputPricePerMillion: 1.875,
+    },
+    'claude-sonnet-4-20250514': {
+        inputPricePerMillion: 3.0,
+        outputPricePerMillion: 15.0,
+        cachedInputPricePerMillion: 0.375,
+    },
+    'claude-3-5-sonnet-20241022': {
+        inputPricePerMillion: 3.0,
+        outputPricePerMillion: 15.0,
+        cachedInputPricePerMillion: 0.375,
+    },
+    'claude-3-5-haiku-20241022': {
+        inputPricePerMillion: 0.8,
+        outputPricePerMillion: 4.0,
+        cachedInputPricePerMillion: 0.1,
+    },
+    'claude-3-opus-20240229': {
+        inputPricePerMillion: 15.0,
+        outputPricePerMillion: 75.0,
+        cachedInputPricePerMillion: 1.875,
+    },
+    'claude-3-sonnet-20240229': {
+        inputPricePerMillion: 3.0,
+        outputPricePerMillion: 15.0,
+        cachedInputPricePerMillion: 0.375,
+    },
+    'claude-3-haiku-20240307': {
+        inputPricePerMillion: 0.25,
+        outputPricePerMillion: 1.25,
+        cachedInputPricePerMillion: 0.03,
+    },
+};
+export const DEFAULT_PRICING_CONFIG = {
+    providers: {
+        openai: OPENAI_PRICING,
+        google: GOOGLE_PRICING,
+        anthropic: ANTHROPIC_PRICING,
+    },
+    fallback: {
+        inputPricePerMillion: 1.0,
+        outputPricePerMillion: 5.0,
+    },
+};
+export const DEFAULT_FALLBACK_PRICING = {
+    inputPricePerMillion: 1.0,
+    outputPricePerMillion: 5.0,
+};
+//# sourceMappingURL=defaults.js.map

package/dist/pricing/defaults.js.map

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

package/dist/pricing/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pricing module for cost calculation.
+ *
+ * Provides types and functions for calculating LLM usage costs
+ * based on token counts and model pricing.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   configurePricing,
+ *   calculateCost,
+ *   calculateCostFromUsage,
+ * } from '@agtlantis/core';
+ *
+ * // Configure custom pricing (optional)
+ * configurePricing({
+ *   providers: {
+ *     google: {
+ *       'gemini-2.5-flash': { inputPricePerMillion: 0.5, outputPricePerMillion: 3.0 },
+ *     },
+ *   },
+ * });
+ *
+ * // Calculate cost from token counts
+ * const cost = calculateCost({
+ *   inputTokens: 1000,
+ *   outputTokens: 500,
+ *   model: 'gemini-2.5-flash',
+ *   provider: 'google',
+ * });
+ * ```
+ *
+ * @module pricing
+ */
+export type { ProviderType, ModelPricing, ProviderPricing, PricingConfig, CalculateCostParams, CostResult, } from './types.js';
+export { configurePricing, getPricingConfig, resetPricingConfig, getEffectivePricing, type PricingSource, type EffectivePricingResult, } from './config.js';
+export { validateModelPricing, validateProviderPricing, validatePricingConfig, } from './validator.js';
+export { getModelPricing, calculateCost, calculateCostFromUsage, calculateTotalCost, } from './calculator.js';
+export { OPENAI_PRICING, GOOGLE_PRICING, ANTHROPIC_PRICING, DEFAULT_PRICING_CONFIG, DEFAULT_FALLBACK_PRICING, } from './defaults.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pricing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pricing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,eAAe,CAAC"}

package/dist/pricing/index.js

@@ -0,0 +1,43 @@
+/**
+ * Pricing module for cost calculation.
+ *
+ * Provides types and functions for calculating LLM usage costs
+ * based on token counts and model pricing.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   configurePricing,
+ *   calculateCost,
+ *   calculateCostFromUsage,
+ * } from '@agtlantis/core';
+ *
+ * // Configure custom pricing (optional)
+ * configurePricing({
+ *   providers: {
+ *     google: {
+ *       'gemini-2.5-flash': { inputPricePerMillion: 0.5, outputPricePerMillion: 3.0 },
+ *     },
+ *   },
+ * });
+ *
+ * // Calculate cost from token counts
+ * const cost = calculateCost({
+ *   inputTokens: 1000,
+ *   outputTokens: 500,
+ *   model: 'gemini-2.5-flash',
+ *   provider: 'google',
+ * });
+ * ```
+ *
+ * @module pricing
+ */
+// Configuration
+export { configurePricing, getPricingConfig, resetPricingConfig, getEffectivePricing, } from './config.js';
+// Validation
+export { validateModelPricing, validateProviderPricing, validatePricingConfig, } from './validator.js';
+// Calculation
+export { getModelPricing, calculateCost, calculateCostFromUsage, calculateTotalCost, } from './calculator.js';
+// Defaults (for reference/inspection)
+export { OPENAI_PRICING, GOOGLE_PRICING, ANTHROPIC_PRICING, DEFAULT_PRICING_CONFIG, DEFAULT_FALLBACK_PRICING, } from './defaults.js';
+//# sourceMappingURL=index.js.map

package/dist/pricing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pricing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAYH,gBAAgB;AAChB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GAGpB,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,cAAc;AACd,OAAO,EACL,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,sCAAsC;AACtC,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,eAAe,CAAC"}

package/dist/pricing/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Pricing types for cost calculation.
+ *
+ * @module pricing/types
+ */
+/**
+ * AI provider type identifier.
+ *
+ * Common values: 'google', 'openai', 'anthropic', 'mock'
+ * Extensible to support custom providers.
+ */
+export type ProviderType = string;
+/**
+ * Pricing for a specific model in USD per million tokens.
+ *
+ * @example
+ * ```typescript
+ * const gpt4Pricing: ModelPricing = {
+ *   inputPricePerMillion: 2.5,
+ *   outputPricePerMillion: 10.0,
+ *   cachedInputPricePerMillion: 1.25, // 50% discount for cached tokens
+ * };
+ * ```
+ */
+export interface ModelPricing {
+    inputPricePerMillion: number;
+    outputPricePerMillion: number;
+    /** Defaults to inputPricePerMillion if not set */
+    cachedInputPricePerMillion?: number;
+}
+/**
+ * Pricing map for a provider's models.
+ *
+ * @example
+ * ```typescript
+ * const googlePricing: ProviderPricing = {
+ *   'gemini-2.5-flash': { inputPricePerMillion: 0.3, outputPricePerMillion: 2.5 },
+ *   'gemini-2.5-pro': { inputPricePerMillion: 1.25, outputPricePerMillion: 10.0 },
+ * };
+ * ```
+ */
+export type ProviderPricing = Record<string, ModelPricing>;
+/**
+ * Global pricing configuration.
+ *
+ * Allows overriding built-in pricing defaults for any provider/model.
+ * Used with `configurePricing()` for global overrides or
+ * `Provider.withPricing()` for provider-level overrides.
+ *
+ * @example
+ * ```typescript
+ * const config: PricingConfig = {
+ *   providers: {
+ *     google: {
+ *       'gemini-2.5-flash': { inputPricePerMillion: 0.5, outputPricePerMillion: 3.0 },
+ *     },
+ *   },
+ *   fallback: {
+ *     inputPricePerMillion: 1.0,
+ *     outputPricePerMillion: 5.0,
+ *   },
+ * };
+ * ```
+ */
+export interface PricingConfig {
+    providers?: Partial<Record<ProviderType, ProviderPricing>>;
+    fallback?: ModelPricing;
+}
+/**
+ * Parameters for cost calculation.
+ */
+export interface CalculateCostParams {
+    /**
+     * Total input tokens INCLUDING cached tokens.
+     * The cost calculator subtracts cachedInputTokens to get non-cached tokens.
+     */
+    inputTokens: number;
+    outputTokens: number;
+    /**
+     * Cached input tokens count (optional).
+     * Must be <= inputTokens. Cached tokens are billed at a lower rate.
+     */
+    cachedInputTokens?: number;
+    model: string;
+    provider: ProviderType;
+}
+/**
+ * Result of cost calculation.
+ */
+export interface CostResult {
+    total: number;
+    inputCost: number;
+    outputCost: number;
+    cachedInputCost: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pricing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pricing/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kDAAkD;IAClD,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/pricing/types.js

@@ -0,0 +1,7 @@
+/**
+ * Pricing types for cost calculation.
+ *
+ * @module pricing/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pricing/types.js.map

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

package/dist/pricing/validator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Pricing validation utilities.
+ *
+ * Provides fail-fast validation for pricing configuration to catch
+ * invalid values (negative, NaN, Infinity) at configuration time.
+ *
+ * @module pricing/validator
+ */
+import type { ModelPricing, PricingConfig, ProviderPricing } from './types.js';
+/**
+ * Validates a ModelPricing object.
+ * Ensures all price values are non-negative and finite.
+ *
+ * @throws {Error} If any price value is invalid
+ *
+ * @example
+ * ```typescript
+ * validateModelPricing(
+ *   { inputPricePerMillion: 2.5, outputPricePerMillion: 10.0 },
+ *   'openai/gpt-4o'
+ * );
+ * ```
+ */
+export declare function validateModelPricing(pricing: ModelPricing, context: string): void;
+/**
+ * Validates a ProviderPricing object.
+ *
+ * @throws {Error} If any model pricing is invalid
+ *
+ * @example
+ * ```typescript
+ * validateProviderPricing({
+ *   'gemini-2.5-flash': { inputPricePerMillion: 0.3, outputPricePerMillion: 2.5 },
+ *   'gemini-2.5-pro': { inputPricePerMillion: 1.25, outputPricePerMillion: 10.0 },
+ * }, 'google');
+ * ```
+ */
+export declare function validateProviderPricing(pricing: ProviderPricing, providerContext?: string): void;
+/**
+ * Validates a PricingConfig object.
+ *
+ * @throws {Error} If any pricing configuration is invalid
+ *
+ * @example
+ * ```typescript
+ * validatePricingConfig({
+ *   providers: {
+ *     google: { 'gemini-2.5-flash': { inputPricePerMillion: 0.3, outputPricePerMillion: 2.5 } },
+ *   },
+ *   fallback: { inputPricePerMillion: 1.0, outputPricePerMillion: 5.0 },
+ * });
+ * ```
+ */
+export declare function validatePricingConfig(config: PricingConfig): void;
+//# sourceMappingURL=validator.d.ts.map

package/dist/pricing/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/pricing/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAe/E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GACd,IAAI,CAmBN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,eAAe,CAAC,EAAE,MAAM,GACvB,IAAI,CAKN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAYjE"}

package/dist/pricing/validator.js

@@ -0,0 +1,84 @@
+/**
+ * Pricing validation utilities.
+ *
+ * Provides fail-fast validation for pricing configuration to catch
+ * invalid values (negative, NaN, Infinity) at configuration time.
+ *
+ * @module pricing/validator
+ */
+function validatePriceValue(value, fieldName, context) {
+    if (!Number.isFinite(value)) {
+        throw new Error(`${context}: ${fieldName} must be a finite number`);
+    }
+    if (value < 0) {
+        throw new Error(`${context}: ${fieldName} cannot be negative`);
+    }
+}
+/**
+ * Validates a ModelPricing object.
+ * Ensures all price values are non-negative and finite.
+ *
+ * @throws {Error} If any price value is invalid
+ *
+ * @example
+ * ```typescript
+ * validateModelPricing(
+ *   { inputPricePerMillion: 2.5, outputPricePerMillion: 10.0 },
+ *   'openai/gpt-4o'
+ * );
+ * ```
+ */
+export function validateModelPricing(pricing, context) {
+    validatePriceValue(pricing.inputPricePerMillion, 'inputPricePerMillion', context);
+    validatePriceValue(pricing.outputPricePerMillion, 'outputPricePerMillion', context);
+    if (pricing.cachedInputPricePerMillion !== undefined) {
+        validatePriceValue(pricing.cachedInputPricePerMillion, 'cachedInputPricePerMillion', context);
+    }
+}
+/**
+ * Validates a ProviderPricing object.
+ *
+ * @throws {Error} If any model pricing is invalid
+ *
+ * @example
+ * ```typescript
+ * validateProviderPricing({
+ *   'gemini-2.5-flash': { inputPricePerMillion: 0.3, outputPricePerMillion: 2.5 },
+ *   'gemini-2.5-pro': { inputPricePerMillion: 1.25, outputPricePerMillion: 10.0 },
+ * }, 'google');
+ * ```
+ */
+export function validateProviderPricing(pricing, providerContext) {
+    for (const [model, modelPricing] of Object.entries(pricing)) {
+        const context = providerContext ? `${providerContext}/${model}` : model;
+        validateModelPricing(modelPricing, context);
+    }
+}
+/**
+ * Validates a PricingConfig object.
+ *
+ * @throws {Error} If any pricing configuration is invalid
+ *
+ * @example
+ * ```typescript
+ * validatePricingConfig({
+ *   providers: {
+ *     google: { 'gemini-2.5-flash': { inputPricePerMillion: 0.3, outputPricePerMillion: 2.5 } },
+ *   },
+ *   fallback: { inputPricePerMillion: 1.0, outputPricePerMillion: 5.0 },
+ * });
+ * ```
+ */
+export function validatePricingConfig(config) {
+    if (config.providers) {
+        for (const [providerKey, pricing] of Object.entries(config.providers)) {
+            if (pricing) {
+                validateProviderPricing(pricing, providerKey);
+            }
+        }
+    }
+    if (config.fallback) {
+        validateModelPricing(config.fallback, 'fallback');
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/pricing/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/pricing/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,SAAS,kBAAkB,CACzB,KAAa,EACb,SAAiB,EACjB,OAAe;IAEf,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,KAAK,SAAS,0BAA0B,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,KAAK,SAAS,qBAAqB,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAqB,EACrB,OAAe;IAEf,kBAAkB,CAChB,OAAO,CAAC,oBAAoB,EAC5B,sBAAsB,EACtB,OAAO,CACR,CAAC;IACF,kBAAkB,CAChB,OAAO,CAAC,qBAAqB,EAC7B,uBAAuB,EACvB,OAAO,CACR,CAAC;IAEF,IAAI,OAAO,CAAC,0BAA0B,KAAK,SAAS,EAAE,CAAC;QACrD,kBAAkB,CAChB,OAAO,CAAC,0BAA0B,EAClC,4BAA4B,EAC5B,OAAO,CACR,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAwB,EACxB,eAAwB;IAExB,KAAK,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACxE,oBAAoB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAqB;IACzD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACtE,IAAI,OAAO,EAAE,CAAC;gBACZ,uBAAuB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/prompt/errors.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Prompt module error classes for @agtlantis/core.
+ *
+ * Each error type has a specific code and context for precise error handling.
+ */
+import { AgtlantisError, type AgtlantisErrorCode } from '../errors/index.js';
+export declare enum PromptErrorCode {
+    /** Generic prompt error */
+    PROMPT_ERROR = "PROMPT_ERROR",
+    /** Prompt not found in repository */
+    NOT_FOUND = "PROMPT_NOT_FOUND",
+    /** Invalid prompt file format (e.g., malformed YAML) */
+    INVALID_FORMAT = "PROMPT_INVALID_FORMAT",
+    /** Template compilation failed */
+    TEMPLATE_ERROR = "PROMPT_TEMPLATE_ERROR",
+    /** File I/O operation failed */
+    IO_ERROR = "PROMPT_IO_ERROR"
+}
+declare module '../errors/index.js' {
+    interface AgtlantisErrorCodeMap {
+        prompt: PromptErrorCode;
+    }
+}
+export interface PromptErrorOptions {
+    code?: PromptErrorCode;
+    cause?: Error;
+    context?: Record<string, unknown>;
+}
+/**
+ * Base error class for prompt operations.
+ * Use specific error subclasses for more precise error handling.
+ *
+ * @example
+ * ```typescript
+ * throw new PromptError('Something went wrong', {
+ *   code: PromptErrorCode.PROMPT_ERROR,
+ *   context: { promptId: 'greeting' }
+ * });
+ * ```
+ */
+export declare class PromptError extends AgtlantisError<PromptErrorCode & AgtlantisErrorCode> {
+    constructor(message: string, options?: PromptErrorOptions);
+    /**
+     * Creates a PromptError from an unknown error.
+     */
+    static from(error: unknown, code?: PromptErrorCode, context?: Record<string, unknown>): PromptError;
+}
+/**
+ * Error thrown when a prompt is not found in the repository.
+ *
+ * @example
+ * ```typescript
+ * throw new PromptNotFoundError('greeting', '1.0.0');
+ * // Error: Prompt 'greeting' version '1.0.0' not found
+ *
+ * throw new PromptNotFoundError('greeting');
+ * // Error: Prompt 'greeting' not found
+ * ```
+ */
+export declare class PromptNotFoundError extends PromptError {
+    readonly promptId: string;
+    readonly version?: string;
+    constructor(promptId: string, version?: string, options?: Omit<PromptErrorOptions, 'code'>);
+}
+/**
+ * Error thrown when a prompt file has invalid format.
+ * Examples: malformed YAML, missing required fields, invalid schema.
+ *
+ * @example
+ * ```typescript
+ * throw new PromptInvalidFormatError('greeting', 'Missing required field: system');
+ * // Error: Invalid format for prompt 'greeting': Missing required field: system
+ * ```
+ */
+export declare class PromptInvalidFormatError extends PromptError {
+    readonly promptId: string;
+    readonly details: string;
+    constructor(promptId: string, details: string, options?: Omit<PromptErrorOptions, 'code'>);
+}
+/**
+ * Error thrown when template compilation fails.
+ * Examples: invalid Handlebars syntax, missing helper.
+ *
+ * @example
+ * ```typescript
+ * throw new PromptTemplateError('greeting', 'Unexpected token {{/if}}');
+ * // Error: Template compilation failed for prompt 'greeting': Unexpected token {{/if}}
+ * ```
+ */
+export declare class PromptTemplateError extends PromptError {
+    readonly promptId: string;
+    readonly details: string;
+    constructor(promptId: string, details: string, options?: Omit<PromptErrorOptions, 'code'>);
+}
+/**
+ * Error thrown when file I/O operations fail.
+ * Examples: read failure, write failure, directory access denied.
+ *
+ * @example
+ * ```typescript
+ * throw new PromptIOError('read', '/path/to/prompt.yaml', {
+ *   cause: originalError
+ * });
+ * // Error: Failed to read prompt file: /path/to/prompt.yaml
+ * ```
+ */
+export declare class PromptIOError extends PromptError {
+    readonly operation: 'read' | 'write' | 'list';
+    readonly path: string;
+    constructor(operation: 'read' | 'write' | 'list', path: string, options?: Omit<PromptErrorOptions, 'code'>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/prompt/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/prompt/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAM7E,oBAAY,eAAe;IACzB,2BAA2B;IAC3B,YAAY,iBAAiB;IAC7B,qCAAqC;IACrC,SAAS,qBAAqB;IAC9B,wDAAwD;IACxD,cAAc,0BAA0B;IACxC,kCAAkC;IAClC,cAAc,0BAA0B;IACxC,gCAAgC;IAChC,QAAQ,oBAAoB;CAC7B;AAGD,OAAO,QAAQ,oBAAoB,CAAC,CAAC;IACnC,UAAU,qBAAqB;QAC7B,MAAM,EAAE,eAAe,CAAC;KACzB;CACF;AAMD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAMD;;;;;;;;;;;GAWG;AACH,qBAAa,WAAY,SAAQ,cAAc,CAAC,eAAe,GAAG,kBAAkB,CAAC;IACnF,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,EAO5D;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,eAA8C,EACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW,CAOb;CACF;AAMD;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,YAAY,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAM,EAa7F;CACF;AAMD;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,SAAQ,WAAW;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,YAAY,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAM,EAS5F;CACF;AAMD;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,YAAY,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAM,EAS5F;CACF;AAMD;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YACE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EACpC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAM,EAW/C;CACF"}