pi-harness-runtime 0.10.11 → 0.10.13

package/packages/cost-optimizer/dist/budget.js

@@ -0,0 +1,101 @@
+/**
+ * Budget Management Functions (RFC-0055)
+ */
+import { isInPeriod } from "./tracker.js";
+// Note: getPeriodBoundaries is used internally by tracker.js
+/**
+ * Calculate budget status for all periods
+ */
+export function calculateBudgetStatus(entries, budget) {
+    const now = new Date();
+    // Daily period
+    const dailyPeriod = { start: "", end: "", type: "day" };
+    dailyPeriod.start = new Date(now.getFullYear(), now.getMonth(), now.getDate()).toISOString();
+    dailyPeriod.end = now.toISOString();
+    const dailyUsed = calculatePeriodTotal(entries, dailyPeriod);
+    // Weekly period
+    const weeklyPeriod = { start: "", end: "", type: "week" };
+    const weekStart = new Date(now);
+    weekStart.setDate(now.getDate() - now.getDay());
+    weekStart.setHours(0, 0, 0, 0);
+    weeklyPeriod.start = weekStart.toISOString();
+    weeklyPeriod.end = now.toISOString();
+    const weeklyUsed = calculatePeriodTotal(entries, weeklyPeriod);
+    // Monthly period
+    const monthlyPeriod = { start: "", end: "", type: "month" };
+    const monthStart = new Date(now.getFullYear(), now.getMonth(), 1);
+    monthlyPeriod.start = monthStart.toISOString();
+    monthlyPeriod.end = now.toISOString();
+    const monthlyUsed = calculatePeriodTotal(entries, monthlyPeriod);
+    // Calculate exhausted state
+    const exhausted = (budget.daily !== undefined && dailyUsed >= budget.daily) ||
+        (budget.weekly !== undefined && weeklyUsed >= budget.weekly) ||
+        (budget.monthly !== undefined && monthlyUsed >= budget.monthly);
+    // Calculate next reset time (simplified - daily reset at midnight)
+    const nextReset = new Date(now);
+    nextReset.setDate(nextReset.getDate() + 1);
+    nextReset.setHours(0, 0, 0, 0);
+    return {
+        daily: {
+            used: dailyUsed,
+            budget: budget.daily ?? 0,
+            remaining: Math.max(0, (budget.daily ?? Infinity) - dailyUsed),
+        },
+        weekly: {
+            used: weeklyUsed,
+            budget: budget.weekly ?? 0,
+            remaining: Math.max(0, (budget.weekly ?? Infinity) - weeklyUsed),
+        },
+        monthly: {
+            used: monthlyUsed,
+            budget: budget.monthly ?? 0,
+            remaining: Math.max(0, (budget.monthly ?? Infinity) - monthlyUsed),
+        },
+        exhausted,
+        nextReset: exhausted ? nextReset.toISOString() : undefined,
+    };
+}
+/**
+ * Calculate total cost for a period
+ */
+function calculatePeriodTotal(entries, period) {
+    return entries
+        .filter((e) => isInPeriod(e.timestamp, period))
+        .reduce((sum, e) => sum + e.cost, 0);
+}
+/**
+ * Check if a cost exceeds budget
+ */
+export function exceedsBudget(_cost, // eslint-disable-line @typescript-eslint/no-unused-vars
+budget, status) {
+    if (budget.daily !== undefined && _cost > status.daily.remaining) {
+        return true;
+    }
+    if (budget.weekly !== undefined && _cost > status.weekly.remaining) {
+        return true;
+    }
+    if (budget.monthly !== undefined && _cost > status.monthly.remaining) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Get the most restrictive remaining budget
+ */
+export function getMostRestrictiveBudget(_cost, // eslint-disable-line @typescript-eslint/no-unused-vars
+budget, status) {
+    const candidates = [];
+    if (budget.daily !== undefined) {
+        candidates.push({ period: "daily", remaining: status.daily.remaining });
+    }
+    if (budget.weekly !== undefined) {
+        candidates.push({ period: "weekly", remaining: status.weekly.remaining });
+    }
+    if (budget.monthly !== undefined) {
+        candidates.push({ period: "monthly", remaining: status.monthly.remaining });
+    }
+    if (candidates.length === 0)
+        return null;
+    return candidates.reduce((most, current) => current.remaining < most.remaining ? current : most);
+}
+//# sourceMappingURL=budget.js.map

package/packages/cost-optimizer/dist/budget.js.map

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

package/packages/cost-optimizer/dist/config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cost Optimizer Configuration (RFC-0055)
+ */
+import type { CostOptimizerConfig } from "./types.js";
+export declare const DEFAULT_CONFIG: CostOptimizerConfig;
+/**
+ * Create a custom optimizer config
+ */
+export declare function createOptimizerConfig(overrides: Partial<CostOptimizerConfig>): CostOptimizerConfig;
+//# sourceMappingURL=config.d.ts.map

package/packages/cost-optimizer/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,eAAO,MAAM,cAAc,EAAE,mBAU5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACrC,mBAAmB,CAUrB"}

package/packages/cost-optimizer/dist/config.js

@@ -0,0 +1,29 @@
+/**
+ * Cost Optimizer Configuration (RFC-0055)
+ */
+export const DEFAULT_CONFIG = {
+    defaultBudget: {
+        daily: 10,
+        weekly: 50,
+        monthly: 200,
+    },
+    currency: "USD",
+    alertThreshold: 0.8, // 80%
+    autoSwitchToCheaper: false,
+    maxQualityLossPercent: 15,
+};
+/**
+ * Create a custom optimizer config
+ */
+export function createOptimizerConfig(overrides) {
+    const result = {
+        ...DEFAULT_CONFIG,
+        ...overrides,
+        defaultBudget: {
+            ...DEFAULT_CONFIG.defaultBudget,
+            ...(overrides.defaultBudget ?? {}),
+        },
+    };
+    return result;
+}
+//# sourceMappingURL=config.js.map

package/packages/cost-optimizer/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,cAAc,GAAwB;IAClD,aAAa,EAAE;QACd,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,GAAG;KACZ;IACD,QAAQ,EAAE,KAAK;IACf,cAAc,EAAE,GAAG,EAAE,MAAM;IAC3B,mBAAmB,EAAE,KAAK;IAC1B,qBAAqB,EAAE,EAAE;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACpC,SAAuC;IAEvC,MAAM,MAAM,GAAwB;QACnC,GAAG,cAAc;QACjB,GAAG,SAAS;QACZ,aAAa,EAAE;YACd,GAAG,cAAc,CAAC,aAAa;YAC/B,GAAG,CAAC,SAAS,CAAC,aAAa,IAAI,EAAE,CAAC;SAClC;KACD,CAAC;IACF,OAAO,MAAM,CAAC;AACf,CAAC"}

package/packages/cost-optimizer/dist/forecast.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cost Forecasting Functions (RFC-0055)
+ */
+import type { CostForecast, TaskRequirements } from "./types.js";
+/**
+ * Forecast costs for a set of job requirements
+ */
+export declare function forecastCosts(requirements: TaskRequirements[], options?: {
+    confidence?: number;
+}): CostForecast;
+/**
+ * Quick forecast for a single task
+ */
+export declare function quickForecast(inputTokens: number, outputTokens: number): number;
+//# sourceMappingURL=forecast.d.ts.map

package/packages/cost-optimizer/dist/forecast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forecast.d.ts","sourceRoot":"","sources":["../src/forecast.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKjE;;GAEG;AACH,wBAAgB,aAAa,CAC5B,YAAY,EAAE,gBAAgB,EAAE,EAChC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,YAAY,CAgCd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAClB,MAAM,CAGR"}

package/packages/cost-optimizer/dist/forecast.js

@@ -0,0 +1,43 @@
+/**
+ * Cost Forecasting Functions (RFC-0055)
+ */
+// Default model cost per 1K tokens (input + output average)
+const AVG_COST_PER_1K = 0.003; // $0.003 per 1K tokens average
+/**
+ * Forecast costs for a set of job requirements
+ */
+export function forecastCosts(requirements, options) {
+    const byTaskType = {};
+    let total = 0;
+    const assumptions = [];
+    for (const req of requirements) {
+        // Estimate based on average cost per token
+        const avgCostPerToken = AVG_COST_PER_1K / 1000;
+        const estimated = (req.estimatedInputTokens + req.estimatedOutputTokens) * avgCostPerToken;
+        const rounded = Math.round(estimated * 10000) / 10000;
+        const taskType = req.requiredCapabilities[0] ?? "general";
+        byTaskType[taskType] = (byTaskType[taskType] ?? 0) + rounded;
+        total += rounded;
+    }
+    assumptions.push("Based on average model costs across providers");
+    assumptions.push("Does not account for provider-specific pricing variations");
+    assumptions.push("Actual costs may vary based on usage patterns");
+    // Confidence decreases with more tasks
+    const baseConfidence = options?.confidence ?? 0.8;
+    const taskCountFactor = Math.max(0.5, 1 - requirements.length * 0.02);
+    const confidence = Math.round(baseConfidence * taskCountFactor * 100) / 100;
+    return {
+        estimatedTotal: Math.round(total * 100) / 100,
+        byTaskType,
+        confidence,
+        assumptions,
+    };
+}
+/**
+ * Quick forecast for a single task
+ */
+export function quickForecast(inputTokens, outputTokens) {
+    const totalTokens = inputTokens + outputTokens;
+    return Math.round(((totalTokens * AVG_COST_PER_1K) / 1000) * 10000) / 10000;
+}
+//# sourceMappingURL=forecast.js.map

package/packages/cost-optimizer/dist/forecast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forecast.js","sourceRoot":"","sources":["../src/forecast.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,4DAA4D;AAC5D,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,+BAA+B;AAE9D;;GAEG;AACH,MAAM,UAAU,aAAa,CAC5B,YAAgC,EAChC,OAAiC;IAEjC,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAChC,2CAA2C;QAC3C,MAAM,eAAe,GAAG,eAAe,GAAG,IAAI,CAAC;QAC/C,MAAM,SAAS,GACd,CAAC,GAAG,CAAC,oBAAoB,GAAG,GAAG,CAAC,qBAAqB,CAAC,GAAG,eAAe,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;QAEtD,MAAM,QAAQ,GAAG,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QAC1D,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC;QAC7D,KAAK,IAAI,OAAO,CAAC;IAClB,CAAC;IAED,WAAW,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAClE,WAAW,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC9E,WAAW,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAElE,uCAAuC;IACvC,MAAM,cAAc,GAAG,OAAO,EAAE,UAAU,IAAI,GAAG,CAAC;IAClD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,eAAe,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAE5E,OAAO;QACN,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG;QAC7C,UAAU;QACV,UAAU;QACV,WAAW;KACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC5B,WAAmB,EACnB,YAAoB;IAEpB,MAAM,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,eAAe,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;AAC7E,CAAC"}

package/packages/cost-optimizer/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cost Optimizer Package (RFC-0055)
+ *
+ * Intelligent cost management with budget tracking, forecasting, and model selection.
+ *
+ * @example
+ * ```typescript
+ * import { createCostOptimizer } from "@pi-harness/cost-optimizer";
+ *
+ * const optimizer = createCostOptimizer();
+ *
+ * // Track a cost
+ * optimizer.trackCost({ jobId: "job-1", cost: 0.5, ... });
+ *
+ * // Check budget
+ * const status = optimizer.getBudgetStatus();
+ *
+ * // Get optimization suggestions
+ * const selections = optimizer.optimizeModelSelection("task-1", requirements);
+ * ```
+ */
+export type { CostEntry, CostBudget, BudgetStatus, CostSummary, CostPeriod, CostOptimizerConfig, SwitchOptions, ModelSwitchRecommendation, CostForecast, TaskRequirements, OptimizedSelection, CostOptimizer, CostOptimizerEvent, } from "./types.js";
+export { InMemoryCostOptimizer, createCostOptimizer } from "./optimizer.js";
+export { DEFAULT_CONFIG, createOptimizerConfig } from "./config.js";
+export { generateCostId, createCostEntry, getPeriodBoundaries, isInPeriod, calculateSummary, getTotalCost, } from "./tracker.js";
+export { calculateBudgetStatus, exceedsBudget, getMostRestrictiveBudget, } from "./budget.js";
+export { calculateModelCost, calculateQualityImpact, getQualityScore, findCheaperAlternatives, generateSwitchRecommendation, optimizeModelSelection, } from "./selection.js";
+export { forecastCosts, quickForecast } from "./forecast.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/cost-optimizer/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,YAAY,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EACN,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,YAAY,GACZ,MAAM,cAAc,CAAC;AAGtB,OAAO,EACN,qBAAqB,EACrB,aAAa,EACb,wBAAwB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/packages/cost-optimizer/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * Cost Optimizer Package (RFC-0055)
+ *
+ * Intelligent cost management with budget tracking, forecasting, and model selection.
+ *
+ * @example
+ * ```typescript
+ * import { createCostOptimizer } from "@pi-harness/cost-optimizer";
+ *
+ * const optimizer = createCostOptimizer();
+ *
+ * // Track a cost
+ * optimizer.trackCost({ jobId: "job-1", cost: 0.5, ... });
+ *
+ * // Check budget
+ * const status = optimizer.getBudgetStatus();
+ *
+ * // Get optimization suggestions
+ * const selections = optimizer.optimizeModelSelection("task-1", requirements);
+ * ```
+ */
+// Optimizer
+export { InMemoryCostOptimizer, createCostOptimizer } from "./optimizer.js";
+// Config
+export { DEFAULT_CONFIG, createOptimizerConfig } from "./config.js";
+// Tracker utilities
+export { generateCostId, createCostEntry, getPeriodBoundaries, isInPeriod, calculateSummary, getTotalCost, } from "./tracker.js";
+// Budget utilities
+export { calculateBudgetStatus, exceedsBudget, getMostRestrictiveBudget, } from "./budget.js";
+// Selection utilities
+export { calculateModelCost, calculateQualityImpact, getQualityScore, findCheaperAlternatives, generateSwitchRecommendation, optimizeModelSelection, } from "./selection.js";
+// Forecast utilities
+export { forecastCosts, quickForecast } from "./forecast.js";
+//# sourceMappingURL=index.js.map

package/packages/cost-optimizer/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAmBH,YAAY;AACZ,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpE,oBAAoB;AACpB,OAAO,EACN,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,YAAY,GACZ,MAAM,cAAc,CAAC;AAEtB,mBAAmB;AACnB,OAAO,EACN,qBAAqB,EACrB,aAAa,EACb,wBAAwB,GACxB,MAAM,aAAa,CAAC;AAErB,sBAAsB;AACtB,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,GACtB,MAAM,gBAAgB,CAAC;AAExB,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/packages/cost-optimizer/dist/optimizer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Cost Optimizer Implementation (RFC-0055)
+ */
+import type { CostEntry, CostOptimizerConfig, CostOptimizerEvent, CostPeriod, CostSummary, CostOptimizer, ModelSwitchRecommendation, OptimizedSelection, SwitchOptions, TaskRequirements } from "./types.js";
+type EventHandler = (event: CostOptimizerEvent) => void;
+/**
+ * In-memory Cost Optimizer
+ */
+export declare class InMemoryCostOptimizer implements CostOptimizer {
+    private config;
+    private history;
+    private eventHandlers;
+    constructor(config?: Partial<CostOptimizerConfig>);
+    /**
+     * Track a cost entry
+     */
+    trackCost(entry: Omit<CostEntry, "id" | "timestamp">): CostEntry;
+    /**
+     * Get cost summary for a period
+     */
+    getSummary(period: CostPeriod): CostSummary;
+    /**
+     * Get current budget status
+     */
+    getBudgetStatus(): import("./types.js").BudgetStatus;
+    /**
+     * Check if a cost can be afforded
+     */
+    canAfford(cost: number): boolean;
+    /**
+     * Suggest cheaper alternatives
+     */
+    shouldSwitchToCheaper(currentModel: {
+        id: string;
+        providerId: string;
+    }, requiredCapabilities: string[], options?: SwitchOptions): ModelSwitchRecommendation | null;
+    /**
+     * Forecast costs for job requirements
+     */
+    forecastCosts(jobRequirements: TaskRequirements[]): import("./types.js").CostForecast;
+    /**
+     * Get optimized model selections
+     */
+    optimizeModelSelection(_taskId: string, requirements: TaskRequirements): OptimizedSelection[];
+    /**
+     * Subscribe to events
+     */
+    onEvent(handler: EventHandler): () => void;
+    /**
+     * Emit an event
+     */
+    private emit;
+    /**
+     * Get cost history
+     */
+    getHistory(): CostEntry[];
+    /**
+     * Clear history
+     */
+    clearHistory(): void;
+}
+/**
+ * Create a new cost optimizer
+ */
+export declare function createCostOptimizer(config?: Partial<CostOptimizerConfig>): InMemoryCostOptimizer;
+export {};
+//# sourceMappingURL=optimizer.d.ts.map

package/packages/cost-optimizer/dist/optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../src/optimizer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,aAAa,EACb,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAWpB,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AA6DxD;;GAEG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IAC1D,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,aAAa,CAAgC;IAErD,YAAY,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,EAEhD;IAED;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,SAAS,CAoC/D;IAED;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAE1C;IAED;;OAEG;IACH,eAAe,sCAEd;IAED;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAc/B;IAED;;OAEG;IACH,qBAAqB,CACpB,YAAY,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAChD,oBAAoB,EAAE,MAAM,EAAE,EAC9B,OAAO,CAAC,EAAE,aAAa,GACrB,yBAAyB,GAAG,IAAI,CA0BlC;IAED;;OAEG;IACH,aAAa,CAAC,eAAe,EAAE,gBAAgB,EAAE,qCAUhD;IAED;;OAEG;IACH,sBAAsB,CACrB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,gBAAgB,GAC5B,kBAAkB,EAAE,CAEtB;IAED;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI,CAGzC;IAED;;OAEG;IACH,OAAO,CAAC,IAAI;IAUZ;;OAEG;IACH,UAAU,IAAI,SAAS,EAAE,CAExB;IAED;;OAEG;IACH,YAAY,IAAI,IAAI,CAEnB;CACD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACnC,qBAAqB,CAEvB"}

package/packages/cost-optimizer/dist/optimizer.js

@@ -0,0 +1,203 @@
+/**
+ * Cost Optimizer Implementation (RFC-0055)
+ */
+import { DEFAULT_CONFIG } from "./config.js";
+import { createCostEntry, calculateSummary } from "./tracker.js";
+import { calculateBudgetStatus } from "./budget.js";
+import { findCheaperAlternatives, generateSwitchRecommendation, optimizeModelSelection, } from "./selection.js";
+import { forecastCosts as calculateForecast } from "./forecast.js";
+const DEFAULT_MODELS = [
+    {
+        id: "claude-sonnet-4",
+        providerId: "anthropic",
+        name: "Claude Sonnet 4",
+        contextWindow: 200000,
+        maxOutputTokens: 8192,
+        pricing: { inputPer1M: 3, outputPer1M: 15 },
+        capabilities: ["code_generation", "code_review", "planning", "analysis"],
+        latency: "fast",
+        qualityScore: 90,
+    },
+    {
+        id: "gpt-4o-mini",
+        providerId: "openai",
+        name: "GPT-4o Mini",
+        contextWindow: 128000,
+        maxOutputTokens: 16384,
+        pricing: { inputPer1M: 0.15, outputPer1M: 0.6 },
+        capabilities: ["code_generation", "code_review", "function_calling"],
+        latency: "fast",
+        qualityScore: 82,
+    },
+    {
+        id: "MiniMax-Text-01",
+        providerId: "minimax",
+        name: "MiniMax Text 01",
+        contextWindow: 1000000,
+        maxOutputTokens: 8192,
+        pricing: { inputPer1M: 0.1, outputPer1M: 0.5 },
+        capabilities: ["code_generation", "function_calling"],
+        latency: "fast",
+        qualityScore: 75,
+    },
+    {
+        id: "gemini-1.5-flash",
+        providerId: "google",
+        name: "Gemini 1.5 Flash",
+        contextWindow: 1000000,
+        maxOutputTokens: 8192,
+        pricing: { inputPer1M: 0.035, outputPer1M: 0.14 },
+        capabilities: ["code_generation", "vision"],
+        latency: "fast",
+        qualityScore: 78,
+    },
+];
+/**
+ * In-memory Cost Optimizer
+ */
+export class InMemoryCostOptimizer {
+    config;
+    history = [];
+    eventHandlers = new Set();
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Track a cost entry
+     */
+    trackCost(entry) {
+        const costEntry = createCostEntry(entry);
+        this.history.push(costEntry);
+        // Get current total
+        const period = { start: "", end: "", type: "day" };
+        const summary = this.getSummary(period);
+        this.emit({
+            type: "cost.tracked",
+            entryId: costEntry.id,
+            cost: costEntry.cost,
+            total: summary.total,
+        });
+        // Check budget warnings
+        const status = this.getBudgetStatus();
+        const dailyPct = status.daily.budget > 0 ? status.daily.used / status.daily.budget : 0;
+        if (dailyPct >= this.config.alertThreshold) {
+            this.emit({
+                type: "cost.budget_warning",
+                threshold: this.config.alertThreshold,
+                percentage: Math.round(dailyPct * 100),
+            });
+        }
+        if (status.exhausted) {
+            this.emit({
+                type: "cost.budget_exhausted",
+                period: "daily",
+            });
+        }
+        return costEntry;
+    }
+    /**
+     * Get cost summary for a period
+     */
+    getSummary(period) {
+        return calculateSummary(this.history, period);
+    }
+    /**
+     * Get current budget status
+     */
+    getBudgetStatus() {
+        return calculateBudgetStatus(this.history, this.config.defaultBudget);
+    }
+    /**
+     * Check if a cost can be afforded
+     */
+    canAfford(cost) {
+        const status = this.getBudgetStatus();
+        if (this.config.defaultBudget.daily !== undefined) {
+            if (cost > status.daily.remaining)
+                return false;
+        }
+        if (this.config.defaultBudget.weekly !== undefined) {
+            if (cost > status.weekly.remaining)
+                return false;
+        }
+        if (this.config.defaultBudget.monthly !== undefined) {
+            if (cost > status.monthly.remaining)
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Suggest cheaper alternatives
+     */
+    shouldSwitchToCheaper(currentModel, requiredCapabilities, options) {
+        // Find current model
+        const current = DEFAULT_MODELS.find((m) => m.id === currentModel.id && m.providerId === currentModel.providerId);
+        if (!current)
+            return null;
+        // Find cheaper alternatives
+        const alternatives = findCheaperAlternatives(current, requiredCapabilities, options);
+        if (alternatives.length === 0)
+            return null;
+        // Return the best alternative
+        const best = alternatives[0];
+        return generateSwitchRecommendation(current, best, 1000, // Default input tokens for comparison
+        500);
+    }
+    /**
+     * Forecast costs for job requirements
+     */
+    forecastCosts(jobRequirements) {
+        const forecast = calculateForecast(jobRequirements);
+        this.emit({
+            type: "cost.forecast",
+            estimated: forecast.estimatedTotal,
+            confidence: forecast.confidence,
+        });
+        return forecast;
+    }
+    /**
+     * Get optimized model selections
+     */
+    optimizeModelSelection(_taskId, requirements) {
+        return optimizeModelSelection(requirements);
+    }
+    /**
+     * Subscribe to events
+     */
+    onEvent(handler) {
+        this.eventHandlers.add(handler);
+        return () => this.eventHandlers.delete(handler);
+    }
+    /**
+     * Emit an event
+     */
+    emit(event) {
+        for (const handler of this.eventHandlers) {
+            try {
+                handler(event);
+            }
+            catch {
+                // Ignore handler errors
+            }
+        }
+    }
+    /**
+     * Get cost history
+     */
+    getHistory() {
+        return [...this.history];
+    }
+    /**
+     * Clear history
+     */
+    clearHistory() {
+        this.history = [];
+    }
+}
+/**
+ * Create a new cost optimizer
+ */
+export function createCostOptimizer(config) {
+    return new InMemoryCostOptimizer(config);
+}
+//# sourceMappingURL=optimizer.js.map

package/packages/cost-optimizer/dist/optimizer.js.map

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

package/packages/cost-optimizer/dist/selection.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Model Selection Optimization Functions (RFC-0055)
+ */
+import type { ModelSwitchRecommendation, OptimizedSelection, SwitchOptions, TaskRequirements } from "./types.js";
+interface ModelData {
+    id: string;
+    providerId: string;
+    name: string;
+    contextWindow: number;
+    maxOutputTokens: number;
+    pricing: {
+        inputPer1M: number;
+        outputPer1M: number;
+    };
+    capabilities: string[];
+    latency: "fast" | "medium" | "slow";
+    qualityScore: number;
+}
+/**
+ * Calculate cost for a model
+ */
+export declare function calculateModelCost(model: ModelData, inputTokens: number, outputTokens: number): number;
+/**
+ * Calculate quality impact between models
+ */
+export declare function calculateQualityImpact(current: ModelData, candidate: ModelData): number;
+/**
+ * Get quality score for a model
+ */
+export declare function getQualityScore(model: ModelData, requiredCapabilities: string[]): number;
+/**
+ * Find cheaper alternatives for a model
+ */
+export declare function findCheaperAlternatives(currentModel: ModelData, requiredCapabilities: string[], options?: SwitchOptions): ModelData[];
+/**
+ * Generate a switch recommendation
+ */
+export declare function generateSwitchRecommendation(currentModel: ModelData, candidate: ModelData, inputTokens: number, outputTokens: number): ModelSwitchRecommendation;
+/**
+ * Optimize model selection for a task
+ */
+export declare function optimizeModelSelection(requirements: TaskRequirements, models?: ModelData[]): OptimizedSelection[];
+export {};
+//# sourceMappingURL=selection.d.ts.map

package/packages/cost-optimizer/dist/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../src/selection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAGpB,UAAU,SAAS;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;CACrB;AAiED;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAClB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,SAAS,EAClB,SAAS,EAAE,SAAS,GAClB,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,SAAS,EAChB,oBAAoB,EAAE,MAAM,EAAE,GAC5B,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,YAAY,EAAE,SAAS,EACvB,oBAAoB,EAAE,MAAM,EAAE,EAC9B,OAAO,CAAC,EAAE,aAAa,GACrB,SAAS,EAAE,CA+Bb;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC3C,YAAY,EAAE,SAAS,EACvB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAClB,yBAAyB,CAsB3B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,YAAY,EAAE,gBAAgB,EAC9B,MAAM,GAAE,SAAS,EAAmB,GAClC,kBAAkB,EAAE,CAoDtB"}