pi-harness-runtime 0.10.11 → 0.10.13

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

@@ -0,0 +1,189 @@
+/**
+ * Model Selection Optimization Functions (RFC-0055)
+ */
+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,
+    },
+    {
+        id: "gpt-4o",
+        providerId: "openai",
+        name: "GPT-4o",
+        contextWindow: 128000,
+        maxOutputTokens: 16384,
+        pricing: { inputPer1M: 5, outputPer1M: 15 },
+        capabilities: [
+            "code_generation",
+            "code_review",
+            "vision",
+            "function_calling",
+        ],
+        latency: "medium",
+        qualityScore: 92,
+    },
+];
+/**
+ * Calculate cost for a model
+ */
+export function calculateModelCost(model, inputTokens, outputTokens) {
+    const inputCost = (inputTokens / 1_000_000) * model.pricing.inputPer1M;
+    const outputCost = (outputTokens / 1_000_000) * model.pricing.outputPer1M;
+    return Math.round((inputCost + outputCost) * 100) / 100;
+}
+/**
+ * Calculate quality impact between models
+ */
+export function calculateQualityImpact(current, candidate) {
+    return current.qualityScore - candidate.qualityScore;
+}
+/**
+ * Get quality score for a model
+ */
+export function getQualityScore(model, requiredCapabilities) {
+    // Base score
+    let score = model.qualityScore;
+    // Bonus for matching required capabilities
+    const matchedCaps = requiredCapabilities.filter((cap) => model.capabilities.includes(cap)).length;
+    score += matchedCaps * 5;
+    return Math.min(score, 100);
+}
+/**
+ * Find cheaper alternatives for a model
+ */
+export function findCheaperAlternatives(currentModel, requiredCapabilities, options) {
+    const maxQualityLoss = options?.maxQualityLoss ?? 20;
+    return DEFAULT_MODELS.filter((m) => {
+        // Must be different model
+        if (m.id === currentModel.id)
+            return false;
+        // Must have required capabilities
+        if (!requiredCapabilities.every((cap) => m.capabilities.includes(cap))) {
+            return false;
+        }
+        // Must be cheaper
+        const currentCost = calculateModelCost(currentModel, 1000, 500);
+        const candidateCost = calculateModelCost(m, 1000, 500);
+        if (candidateCost >= currentCost)
+            return false;
+        // Must not lose too much quality
+        const qualityLoss = calculateQualityImpact(currentModel, m);
+        if (qualityLoss > maxQualityLoss)
+            return false;
+        // Must not increase latency beyond preference
+        if (options?.maxLatencyIncrease) {
+            const latencyOrder = { fast: 1, medium: 2, slow: 3 };
+            if (latencyOrder[m.latency] > latencyOrder[options.maxLatencyIncrease]) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+/**
+ * Generate a switch recommendation
+ */
+export function generateSwitchRecommendation(currentModel, candidate, inputTokens, outputTokens) {
+    const currentCost = calculateModelCost(currentModel, inputTokens, outputTokens);
+    const candidateCost = calculateModelCost(candidate, inputTokens, outputTokens);
+    const savings = currentCost - candidateCost;
+    const savingsPct = (savings / currentCost) * 100;
+    const qualityLoss = calculateQualityImpact(currentModel, candidate);
+    return {
+        currentModel: { id: currentModel.id, providerId: currentModel.providerId },
+        recommendedModel: { id: candidate.id, providerId: candidate.providerId },
+        costSavings: Math.round(savingsPct * 10) / 10,
+        qualityImpact: Math.round(qualityLoss * 10) / 10,
+        reason: `Switch from ${currentModel.name} to ${candidate.name} saves ${savingsPct.toFixed(1)}%`,
+    };
+}
+/**
+ * Optimize model selection for a task
+ */
+export function optimizeModelSelection(requirements, models = DEFAULT_MODELS) {
+    // Filter by requirements
+    const candidates = models.filter((m) => {
+        if (m.contextWindow < requirements.minContextWindow)
+            return false;
+        if (requirements.maxLatency) {
+            const latencyOrder = { fast: 1, medium: 2, slow: 3 };
+            if (latencyOrder[m.latency] > latencyOrder[requirements.maxLatency]) {
+                return false;
+            }
+        }
+        // Filter by required capabilities
+        if (requirements.requiredCapabilities?.length) {
+            const hasAllCaps = requirements.requiredCapabilities.every((cap) => m.capabilities.includes(cap));
+            if (!hasAllCaps)
+                return false;
+        }
+        return true;
+    });
+    // Calculate scores
+    const scored = candidates.map((m) => {
+        const estimatedCost = calculateModelCost(m, requirements.estimatedInputTokens, requirements.estimatedOutputTokens);
+        const qualityScore = getQualityScore(m, requirements.requiredCapabilities);
+        // Tradeoffs
+        const tradeoffs = [];
+        if (m.pricing.inputPer1M > 1)
+            tradeoffs.push("Higher input cost");
+        if (m.qualityScore < 85)
+            tradeoffs.push("Lower quality rating");
+        return {
+            model: { id: m.id, providerId: m.providerId, name: m.name },
+            estimatedCost,
+            qualityScore,
+            reason: `${m.name}: $${estimatedCost.toFixed(4)} estimated, ${qualityScore.toFixed(0)} quality`,
+            tradeoffs,
+        };
+    });
+    // Sort by quality-adjusted value (Pareto-optimal)
+    scored.sort((a, b) => {
+        // Quality weight 60%, cost weight 40%
+        const valueA = a.qualityScore * 0.6 - a.estimatedCost * 100 * 0.4;
+        const valueB = b.qualityScore * 0.6 - b.estimatedCost * 100 * 0.4;
+        return valueB - valueA;
+    });
+    return scored;
+}
+//# sourceMappingURL=selection.js.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * Cost Tracking Functions (RFC-0055)
+ */
+import type { CostEntry, CostPeriod, CostSummary } from "./types.js";
+/**
+ * Generate a unique ID for cost entries
+ */
+export declare function generateCostId(): string;
+/**
+ * Create a new cost entry
+ */
+export declare function createCostEntry(entry: Omit<CostEntry, "id" | "timestamp">, id?: string, timestamp?: string): CostEntry;
+/**
+ * Get the period boundaries for a given period type
+ */
+export declare function getPeriodBoundaries(period: CostPeriod): {
+    start: Date;
+    end: Date;
+};
+/**
+ * Check if a timestamp falls within a period
+ */
+export declare function isInPeriod(timestamp: string, period: CostPeriod): boolean;
+/**
+ * Calculate summary from cost entries
+ */
+export declare function calculateSummary(entries: CostEntry[], period: CostPeriod): CostSummary;
+/**
+ * Get total cost for a period
+ */
+export declare function getTotalCost(entries: CostEntry[], period: CostPeriod): number;
+//# sourceMappingURL=tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIrE;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,WAAW,CAAC,EAC1C,EAAE,CAAC,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GAChB,SAAS,CAMX;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG;IACxD,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;CACV,CAiCA;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAIzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,SAAS,EAAE,EACpB,MAAM,EAAE,UAAU,GAChB,WAAW,CA2Bb;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAG7E"}

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

@@ -0,0 +1,95 @@
+/**
+ * Cost Tracking Functions (RFC-0055)
+ */
+let idCounter = 0;
+/**
+ * Generate a unique ID for cost entries
+ */
+export function generateCostId() {
+    return `cost_${Date.now()}_${++idCounter}`;
+}
+/**
+ * Create a new cost entry
+ */
+export function createCostEntry(entry, id, timestamp) {
+    return {
+        ...entry,
+        id: id ?? generateCostId(),
+        timestamp: timestamp ?? new Date().toISOString(),
+    };
+}
+/**
+ * Get the period boundaries for a given period type
+ */
+export function getPeriodBoundaries(period) {
+    const now = new Date();
+    const end = new Date(now);
+    switch (period.type) {
+        case "day": {
+            const start = new Date(now);
+            start.setHours(0, 0, 0, 0);
+            return { start, end };
+        }
+        case "week": {
+            const start = new Date(now);
+            start.setDate(now.getDate() - now.getDay());
+            start.setHours(0, 0, 0, 0);
+            return { start, end };
+        }
+        case "month": {
+            const start = new Date(now.getFullYear(), now.getMonth(), 1);
+            return { start, end };
+        }
+        case "custom": {
+            return {
+                start: new Date(period.start),
+                end: new Date(period.end),
+            };
+        }
+        default:
+            return { start: new Date(0), end: now };
+    }
+}
+/**
+ * Check if a timestamp falls within a period
+ */
+export function isInPeriod(timestamp, period) {
+    const { start, end } = getPeriodBoundaries(period);
+    const ts = new Date(timestamp);
+    return ts >= start && ts <= end;
+}
+/**
+ * Calculate summary from cost entries
+ */
+export function calculateSummary(entries, period) {
+    const filtered = entries.filter((e) => isInPeriod(e.timestamp, period));
+    const total = filtered.reduce((sum, e) => sum + e.cost, 0);
+    const currency = filtered[0]?.currency ?? "USD";
+    const byProvider = {};
+    const byModel = {};
+    const byJob = {};
+    for (const entry of filtered) {
+        byProvider[entry.providerId] =
+            (byProvider[entry.providerId] ?? 0) + entry.cost;
+        byModel[entry.modelId] = (byModel[entry.modelId] ?? 0) + entry.cost;
+        if (entry.jobId) {
+            byJob[entry.jobId] = (byJob[entry.jobId] ?? 0) + entry.cost;
+        }
+    }
+    return {
+        total: Math.round(total * 10000) / 10000, // higher precision for small amounts
+        currency,
+        byProvider,
+        byModel,
+        byJob,
+        period,
+    };
+}
+/**
+ * Get total cost for a period
+ */
+export function getTotalCost(entries, period) {
+    const summary = calculateSummary(entries, period);
+    return summary.total;
+}
+//# sourceMappingURL=tracker.js.map

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

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

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

@@ -0,0 +1,142 @@
+/**
+ * Cost Optimizer Types (RFC-0055)
+ */
+export type Currency = "USD" | "THB";
+export interface CostEntry {
+    id: string;
+    jobId: string;
+    taskId?: string;
+    providerId: string;
+    modelId: string;
+    inputTokens: number;
+    outputTokens: number;
+    cost: number;
+    currency: Currency;
+    timestamp: string;
+}
+export interface CostBudget {
+    daily?: number;
+    weekly?: number;
+    monthly?: number;
+    perJob?: number;
+    perTask?: number;
+}
+export interface BudgetStatus {
+    daily: {
+        used: number;
+        budget: number;
+        remaining: number;
+    };
+    weekly: {
+        used: number;
+        budget: number;
+        remaining: number;
+    };
+    monthly: {
+        used: number;
+        budget: number;
+        remaining: number;
+    };
+    exhausted: boolean;
+    nextReset?: string;
+}
+export interface CostSummary {
+    total: number;
+    currency: Currency;
+    byProvider: Record<string, number>;
+    byModel: Record<string, number>;
+    byJob: Record<string, number>;
+    period: CostPeriod;
+}
+export interface CostPeriod {
+    start: string;
+    end: string;
+    type: "day" | "week" | "month" | "custom";
+}
+export interface CostOptimizerConfig {
+    defaultBudget: CostBudget;
+    currency: Currency;
+    alertThreshold: number;
+    autoSwitchToCheaper: boolean;
+    maxQualityLossPercent: number;
+}
+export interface SwitchOptions {
+    maxQualityLoss?: number;
+    maxLatencyIncrease?: "fast" | "medium" | "slow";
+}
+export interface ModelSwitchRecommendation {
+    currentModel: {
+        id: string;
+        providerId: string;
+    };
+    recommendedModel: {
+        id: string;
+        providerId: string;
+    };
+    costSavings: number;
+    qualityImpact: number;
+    reason: string;
+}
+export interface CostForecast {
+    estimatedTotal: number;
+    byTaskType: Record<string, number>;
+    confidence: number;
+    assumptions: string[];
+}
+export interface TaskRequirements {
+    requiredCapabilities: string[];
+    minContextWindow: number;
+    maxLatency?: "fast" | "medium" | "slow";
+    estimatedInputTokens: number;
+    estimatedOutputTokens: number;
+}
+export interface OptimizedSelection {
+    model: {
+        id: string;
+        providerId: string;
+        name: string;
+    };
+    estimatedCost: number;
+    qualityScore: number;
+    reason: string;
+    tradeoffs: string[];
+}
+export interface CostOptimizer {
+    trackCost(entry: Omit<CostEntry, "id" | "timestamp">): CostEntry;
+    getSummary(period: CostPeriod): CostSummary;
+    getBudgetStatus(): BudgetStatus;
+    canAfford(cost: number): boolean;
+    shouldSwitchToCheaper(currentModel: {
+        id: string;
+        providerId: string;
+    }, requiredCapabilities: string[], options?: SwitchOptions): ModelSwitchRecommendation | null;
+    forecastCosts(jobRequirements: TaskRequirements[]): CostForecast;
+    optimizeModelSelection(taskId: string, requirements: TaskRequirements): OptimizedSelection[];
+}
+export type CostOptimizerEvent = {
+    type: "cost.tracked";
+    entryId: string;
+    cost: number;
+    total: number;
+} | {
+    type: "cost.budget_warning";
+    threshold: number;
+    percentage: number;
+} | {
+    type: "cost.budget_exhausted";
+    period: string;
+} | {
+    type: "cost.switch_recommended";
+    from: string;
+    to: string;
+    savings: number;
+} | {
+    type: "cost.forecast";
+    estimated: number;
+    confidence: number;
+} | {
+    type: "cost.optimization_applied";
+    model: string;
+    savings: number;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,5 @@
+/**
+ * Cost Optimizer Types (RFC-0055)
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/packages/cost-optimizer/src/budget.ts

@@ -0,0 +1,138 @@
+/**
+ * Budget Management Functions (RFC-0055)
+ */
+
+import type {
+	BudgetStatus,
+	CostBudget,
+	CostEntry,
+	CostPeriod,
+} from "./types.js";
+import { isInPeriod } from "./tracker.js";
+// Note: getPeriodBoundaries is used internally by tracker.js
+
+/**
+ * Calculate budget status for all periods
+ */
+export function calculateBudgetStatus(
+	entries: CostEntry[],
+	budget: CostBudget,
+): BudgetStatus {
+	const now = new Date();
+
+	// Daily period
+	const dailyPeriod: CostPeriod = { 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: CostPeriod = { 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: CostPeriod = { 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: CostEntry[],
+	period: CostPeriod,
+): number {
+	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: number, // eslint-disable-line @typescript-eslint/no-unused-vars
+	budget: CostBudget,
+	status: BudgetStatus,
+): boolean {
+	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: number, // eslint-disable-line @typescript-eslint/no-unused-vars
+	budget: CostBudget,
+	status: BudgetStatus,
+): { period: string; remaining: number } | null {
+	const candidates: { period: string; remaining: number }[] = [];
+
+	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,
+	);
+}

package/packages/cost-optimizer/src/config.ts

@@ -0,0 +1,34 @@
+/**
+ * Cost Optimizer Configuration (RFC-0055)
+ */
+
+import type { CostOptimizerConfig } from "./types.js";
+
+export const DEFAULT_CONFIG: CostOptimizerConfig = {
+	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: Partial<CostOptimizerConfig>,
+): CostOptimizerConfig {
+	const result: CostOptimizerConfig = {
+		...DEFAULT_CONFIG,
+		...overrides,
+		defaultBudget: {
+			...DEFAULT_CONFIG.defaultBudget,
+			...(overrides.defaultBudget ?? {}),
+		},
+	};
+	return result;
+}