pi-harness-runtime 0.10.12 → 0.10.13

package/packages/cookie-sanitizer/dist/watcher.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Live cookie-folder watcher.
+ *
+ * Wraps chokidar v5 with the project-specific options:
+ *  - `atomic: 100`           — EditThisCookie / browser exporters use atomic write
+ *  - `awaitWriteFinish`      — wait for size to settle before triggering
+ *  - `ignoreInitial: true`   — startup is handled by sync.ts separately
+ *  - `depth: 2`              — one level + one subfolder
+ *  - editor temp ignored
+ *
+ * Sec-001: Cookie values are NEVER logged. Diagnostics use only
+ * basenames, file paths, and event kinds.
+ */
+import { type SyncOptions } from "./sync.js";
+import type { WatcherEvent } from "./types.js";
+/** Public watcher config. */
+export interface CookieWatcherConfig {
+    /** Folder to watch. Default: ~/.pi-harness-runtime/cookies/ */
+    dropDir: string;
+    /** Sync options passed through to the sync orchestrator. */
+    syncOptions?: SyncOptions;
+    /** Event sink. Required. */
+    onEvent: (event: WatcherEvent) => void;
+    /** Override the debounce window (ms). Default 250. */
+    debounceMs?: number;
+    /** Optional logger (defaults to console). */
+    logger?: (msg: string) => void;
+}
+/** Wraps a chokidar watcher for the drop folder. */
+export declare class CookieWatcher {
+    private watcher;
+    private debounceMs;
+    private debounceTimer;
+    private log;
+    private cfg;
+    private running;
+    constructor(config: CookieWatcherConfig);
+    /** Start watching. Idempotent — calling twice is a no-op. */
+    start(): void;
+    /** Stop watching. Idempotent. */
+    stop(): Promise<void>;
+    /** Trigger a sync immediately (bypass debounce). */
+    triggerNow(): void;
+    private schedule;
+    private runSync;
+}
+/** Factory: a watcher that writes to a default no-op logger. */
+export declare function createWatcher(dropDir: string, syncOptions: SyncOptions, onEvent: (event: WatcherEvent) => void): CookieWatcher;
+/** Compute a sensible dropDir for a given HOME override (test seam). */
+export declare function defaultDropDir(home?: string): string;
+//# sourceMappingURL=watcher.d.ts.map

package/packages/cookie-sanitizer/dist/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,6BAA6B;AAC7B,MAAM,WAAW,mBAAmB;IACnC,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,4BAA4B;IAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAID,oDAAoD;AACpD,qBAAa,aAAa;IACzB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,OAAO,CAAS;IAExB,YAAY,MAAM,EAAE,mBAAmB,EAItC;IAED,6DAA6D;IAC7D,KAAK,IAAI,IAAI,CA4CZ;IAED,iCAAiC;IAC3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAY1B;IAED,oDAAoD;IACpD,UAAU,IAAI,IAAI,CAMjB;IAED,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,OAAO;CAkCf;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACpC,aAAa,CAEf;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAC7B,IAAI,GAAE,MAAmC,GACvC,MAAM,CAER"}

package/packages/cookie-sanitizer/dist/watcher.js

@@ -0,0 +1,148 @@
+/**
+ * Live cookie-folder watcher.
+ *
+ * Wraps chokidar v5 with the project-specific options:
+ *  - `atomic: 100`           — EditThisCookie / browser exporters use atomic write
+ *  - `awaitWriteFinish`      — wait for size to settle before triggering
+ *  - `ignoreInitial: true`   — startup is handled by sync.ts separately
+ *  - `depth: 2`              — one level + one subfolder
+ *  - editor temp ignored
+ *
+ * Sec-001: Cookie values are NEVER logged. Diagnostics use only
+ * basenames, file paths, and event kinds.
+ */
+import chokidar from "chokidar";
+import { join } from "node:path";
+import { sync } from "./sync.js";
+const DEFAULT_DEBOUNCE_MS = 250;
+/** Wraps a chokidar watcher for the drop folder. */
+export class CookieWatcher {
+    watcher = null;
+    debounceMs;
+    debounceTimer = null;
+    log;
+    cfg;
+    running = false;
+    constructor(config) {
+        this.cfg = config;
+        this.debounceMs = config.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+        this.log = config.logger ?? ((m) => console.log(`[cookie-sanitizer] ${m}`));
+    }
+    /** Start watching. Idempotent — calling twice is a no-op. */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.watcher = chokidar.watch(this.cfg.dropDir, {
+            ignored: (targetPath) => {
+                const base = targetPath.split("/").pop() ?? "";
+                if (base.startsWith("."))
+                    return true;
+                if (base.endsWith("~") || base.endsWith(".swp"))
+                    return true;
+                if (base.endsWith(".tmp"))
+                    return true;
+                // Exclude the canonical cache file (if specified) so the
+                // sanitizer's own write doesn't trigger a re-sync.
+                if (this.cfg.syncOptions?.cachePath &&
+                    targetPath === this.cfg.syncOptions.cachePath) {
+                    return true;
+                }
+                return false;
+            },
+            ignoreInitial: true,
+            persistent: true,
+            depth: 2,
+            atomic: 100,
+            awaitWriteFinish: {
+                stabilityThreshold: 200,
+                pollInterval: 50,
+            },
+        });
+        this.watcher.on("add", () => this.schedule());
+        this.watcher.on("change", () => this.schedule());
+        this.watcher.on("unlink", () => this.schedule());
+        this.watcher.on("error", (err) => {
+            this.log(`watcher error: ${err instanceof Error ? err.message : String(err)}`);
+            this.cfg.onEvent({
+                kind: "watcher-error",
+                message: err instanceof Error ? err.message : String(err),
+            });
+        });
+        this.log(`watching ${this.cfg.dropDir}`);
+    }
+    /** Stop watching. Idempotent. */
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+        }
+        this.log("stopped");
+    }
+    /** Trigger a sync immediately (bypass debounce). */
+    triggerNow() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        this.runSync();
+    }
+    schedule() {
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = null;
+            this.runSync();
+        }, this.debounceMs);
+    }
+    runSync() {
+        try {
+            const result = sync(this.cfg.syncOptions ?? {});
+            if (result.errors.length > 0) {
+                for (const err of result.errors) {
+                    this.cfg.onEvent({
+                        kind: "sync-error",
+                        message: `${err.basename}: ${err.message}`,
+                    });
+                }
+            }
+            if (result.provider && result.wrote) {
+                this.cfg.onEvent({
+                    kind: "sync-ok",
+                    provider: result.provider,
+                    cachePath: result.cachePath,
+                    cookies: result.totalCookies,
+                });
+            }
+            else if (result.processedFiles.length === 0 &&
+                result.provider === null) {
+                this.cfg.onEvent({
+                    kind: "sync-skip",
+                    reason: "no usable cookies found",
+                });
+            }
+        }
+        catch (e) {
+            this.cfg.onEvent({
+                kind: "sync-error",
+                message: e instanceof Error ? e.message : String(e),
+            });
+        }
+    }
+}
+/** Factory: a watcher that writes to a default no-op logger. */
+export function createWatcher(dropDir, syncOptions, onEvent) {
+    return new CookieWatcher({ dropDir, syncOptions, onEvent });
+}
+/** Compute a sensible dropDir for a given HOME override (test seam). */
+export function defaultDropDir(home = process.env.HOME ?? "/tmp") {
+    return join(home, ".pi-harness-runtime", "cookies");
+}
+//# sourceMappingURL=watcher.js.map

package/packages/cookie-sanitizer/dist/watcher.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * Budget Management Functions (RFC-0055)
+ */
+import type { BudgetStatus, CostBudget, CostEntry } from "./types.js";
+/**
+ * Calculate budget status for all periods
+ */
+export declare function calculateBudgetStatus(entries: CostEntry[], budget: CostBudget): BudgetStatus;
+/**
+ * Check if a cost exceeds budget
+ */
+export declare function exceedsBudget(_cost: number, // eslint-disable-line @typescript-eslint/no-unused-vars
+budget: CostBudget, status: BudgetStatus): boolean;
+/**
+ * Get the most restrictive remaining budget
+ */
+export declare function getMostRestrictiveBudget(_cost: number, // eslint-disable-line @typescript-eslint/no-unused-vars
+budget: CostBudget, status: BudgetStatus): {
+    period: string;
+    remaining: number;
+} | null;
+//# sourceMappingURL=budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,YAAY,EACZ,UAAU,EACV,SAAS,EAET,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,SAAS,EAAE,EACpB,MAAM,EAAE,UAAU,GAChB,YAAY,CA2Dd;AAcD;;GAEG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,MAAM,EAAE,wDAAwD;AACvE,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,YAAY,GAClB,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,MAAM,EAAE,wDAAwD;AACvE,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,YAAY,GAClB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB9C"}

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"}