pi-harness-runtime 0.10.11 → 0.10.13

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

@@ -0,0 +1,305 @@
+/**
+ * Performance Optimizer (RFC-0056)
+ *
+ * Analyzes runtime metrics and produces advisory optimization decisions.
+ */
+/**
+ * Detect bottlenecks from metrics
+ */
+function detectBottlenecks(metrics) {
+    const bottlenecks = [];
+    const { currentContextTokens, contextWindow, retryCount, successCount, failureCount, } = metrics;
+    // Context usage bottleneck
+    const contextUsagePercent = (currentContextTokens / contextWindow) * 100;
+    if (contextUsagePercent > 80) {
+        bottlenecks.push("high_context_usage");
+    }
+    // Retry bottleneck
+    const totalCalls = successCount + failureCount;
+    if (totalCalls > 0 && retryCount / totalCalls > 0.3) {
+        bottlenecks.push("high_retry_rate");
+    }
+    // Provider performance
+    const avgLatency = metrics.avgLatencyMs;
+    if (avgLatency > 30000) {
+        bottlenecks.push("high_latency");
+    }
+    return bottlenecks;
+}
+/**
+ * Normalize provider metrics
+ */
+function normalizeProviderStats(providerMetrics) {
+    const normalized = {};
+    for (const [providerId, stats] of Object.entries(providerMetrics)) {
+        const total = stats.callCount;
+        if (total > 0) {
+            normalized[providerId] = {
+                successRate: stats.successCount / total,
+                failureRate: stats.failureCount / total,
+            };
+        }
+    }
+    return normalized;
+}
+/**
+ * Generate context reduction recommendation
+ */
+function suggestContextReduction(metrics, policy) {
+    const { currentContextTokens, contextWindow } = metrics;
+    const usagePercent = (currentContextTokens / contextWindow) * 100;
+    if (usagePercent < 50) {
+        return null; // No reduction needed
+    }
+    // Calculate target (reduce to 60% of current)
+    const targetTokens = Math.floor(currentContextTokens * 0.6);
+    const reductionPercent = ((currentContextTokens - targetTokens) / currentContextTokens) * 100;
+    if (reductionPercent < policy.minContextReductionPercent) {
+        return null;
+    }
+    return {
+        type: "reduce_context",
+        targetTokens,
+        reason: `Context usage at ${usagePercent.toFixed(1)}% (${currentContextTokens}/${contextWindow} tokens). Reduce to ~60% to improve performance.`,
+    };
+}
+/**
+ * Generate provider change recommendation
+ */
+function suggestProviderChange(metrics, providerStates, policy) {
+    if (!policy.allowProviderSwitch) {
+        return null;
+    }
+    const providerStats = normalizeProviderStats(metrics.providerMetrics);
+    // Find worst performing provider
+    let worstProvider = null;
+    let worstFailureRate = 0;
+    for (const [providerId, stats] of Object.entries(providerStats)) {
+        if (stats.failureRate > worstFailureRate && stats.failureRate > 0.1) {
+            worstProvider = providerId;
+            worstFailureRate = stats.failureRate;
+        }
+    }
+    if (!worstProvider) {
+        return null;
+    }
+    // Check if there's a better available provider
+    const availableProviders = providerStates.filter((p) => p.state === "available" && p.providerId !== worstProvider);
+    if (availableProviders.length === 0) {
+        return null; // No alternative available
+    }
+    return {
+        type: "change_provider",
+        provider: availableProviders[0].providerId,
+        reason: `Provider '${worstProvider}' has ${(worstFailureRate * 100).toFixed(1)}% failure rate. Switch to '${availableProviders[0].providerId}' for better reliability.`,
+    };
+}
+/**
+ * Generate parallelism recommendations
+ */
+function suggestParallelismChanges(metrics, providerStates, policy, taskGraph) {
+    const recommendations = [];
+    // Check for blocked tasks that could be parallel
+    if (taskGraph) {
+        const runningTasks = taskGraph.nodes.filter((n) => n.status === "running");
+        const readyTasks = taskGraph.nodes.filter((n) => n.status === "ready");
+        // If we have many ready tasks and few running, suggest increasing parallelism
+        if (readyTasks.length > 5 && runningTasks.length < 3) {
+            const suggestedLimit = Math.min(runningTasks.length + 2, policy.maxParallelism);
+            if (suggestedLimit > runningTasks.length) {
+                recommendations.push({
+                    type: "increase_parallelism",
+                    limit: suggestedLimit,
+                    reason: `${readyTasks.length} tasks waiting. Increase parallelism to ${suggestedLimit} for faster completion.`,
+                });
+            }
+        }
+        // If too many tasks are hitting resource limits, suggest decreasing
+        const limitedProviders = providerStates.filter((p) => p.state === "limited");
+        if (limitedProviders.length > 0 && runningTasks.length > 5) {
+            recommendations.push({
+                type: "decrease_parallelism",
+                limit: Math.max(2, runningTasks.length - 2),
+                reason: `Provider quota limited. Reduce parallelism to ${Math.max(2, runningTasks.length - 2)} to avoid quota exhaustion.`,
+            });
+        }
+    }
+    return recommendations;
+}
+/**
+ * Resolve conflicting recommendations
+ */
+function resolveConflicts(recommendations, policy) {
+    // Sort by type priority (reductions first, then parallelism, then provider)
+    const priority = {
+        reduce_context: 1,
+        decrease_parallelism: 2,
+        increase_parallelism: 3,
+        change_provider: 4,
+        reuse_checkpoint: 5,
+        skip_redundant_step: 6,
+    };
+    // Remove duplicates and conflicting recommendations
+    const seen = new Set();
+    const resolved = [];
+    for (const rec of recommendations.sort((a, b) => priority[a.type] - priority[b.type])) {
+        const key = rec.type;
+        // Check for conflicts
+        if (key === "increase_parallelism" &&
+            resolved.some((r) => r.type === "decrease_parallelism")) {
+            continue; // Skip increase if decrease already added
+        }
+        if (key === "decrease_parallelism" &&
+            resolved.some((r) => r.type === "increase_parallelism")) {
+            // Remove increase and add decrease
+            const idx = resolved.findIndex((r) => r.type === "increase_parallelism");
+            if (idx !== -1)
+                resolved.splice(idx, 1);
+        }
+        if (!seen.has(key)) {
+            seen.add(key);
+            resolved.push(rec);
+        }
+    }
+    return resolved;
+}
+/**
+ * Calculate expected impact
+ */
+function calculateImpact(metrics, recommendations) {
+    let tokenReduction = 0;
+    let latencyReduction = 0;
+    let retryReduction = 0;
+    for (const rec of recommendations) {
+        switch (rec.type) {
+            case "reduce_context":
+                // Estimate 15-30% latency improvement from context reduction
+                latencyReduction += 20;
+                break;
+            case "change_provider":
+                // Estimate 10-25% latency improvement from better provider
+                latencyReduction += 15;
+                break;
+            case "decrease_parallelism":
+                // Reduce contention
+                latencyReduction += 10;
+                retryReduction += 15;
+                break;
+            case "skip_redundant_step":
+                tokenReduction += 10;
+                break;
+        }
+    }
+    return {
+        tokenReductionPercent: tokenReduction > 0 ? Math.min(tokenReduction, 50) : undefined,
+        latencyReductionPercent: latencyReduction > 0 ? Math.min(latencyReduction, 40) : undefined,
+        retryReductionPercent: retryReduction > 0 ? Math.min(retryReduction, 30) : undefined,
+    };
+}
+export class PerformanceOptimizer {
+    policy;
+    constructor(policy = {}) {
+        this.policy = {
+            minContextReductionPercent: 10,
+            maxParallelism: 10,
+            minImprovementPercent: 5,
+            allowProviderSwitch: true,
+            mandatoryStages: [],
+            ...policy,
+        };
+    }
+    /**
+     * Analyze metrics and produce optimization recommendations
+     */
+    analyze(request) {
+        const { jobId, metrics, providerStates } = request;
+        // Emit start event
+        this.emit({ type: "performance.analysis.started", jobId });
+        try {
+            // 1. Detect bottlenecks
+            const bottlenecks = detectBottlenecks(metrics);
+            // 2. Generate recommendations
+            const recommendations = [];
+            // Context reduction
+            const contextRec = suggestContextReduction(metrics, this.policy);
+            if (contextRec) {
+                recommendations.push(contextRec);
+                this.emit({
+                    type: "performance.recommendation.created",
+                    jobId,
+                    recommendation: contextRec,
+                });
+            }
+            // Provider change
+            const providerRec = suggestProviderChange(metrics, providerStates, this.policy);
+            if (providerRec) {
+                recommendations.push(providerRec);
+                this.emit({
+                    type: "performance.recommendation.created",
+                    jobId,
+                    recommendation: providerRec,
+                });
+            }
+            // Parallelism changes
+            const parallelismRecs = suggestParallelismChanges(metrics, providerStates, this.policy, request.taskGraph);
+            for (const rec of parallelismRecs) {
+                recommendations.push(rec);
+                this.emit({
+                    type: "performance.recommendation.created",
+                    jobId,
+                    recommendation: rec,
+                });
+            }
+            // 3. Resolve conflicts
+            const resolved = resolveConflicts(recommendations, this.policy);
+            // 4. Calculate impact
+            const expectedImpact = calculateImpact(metrics, resolved);
+            this.emit({ type: "performance.analysis.completed", jobId });
+            return {
+                jobId,
+                recommendations: resolved,
+                expectedImpact,
+                generatedAt: new Date().toISOString(),
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.emit({
+                type: "performance.analysis.failed",
+                jobId,
+                error: errorMessage,
+            });
+            return {
+                jobId,
+                recommendations: [],
+                expectedImpact: {},
+                generatedAt: new Date().toISOString(),
+            };
+        }
+    }
+    eventListeners = [];
+    /**
+     * Subscribe to optimizer events
+     */
+    onEvent(listener) {
+        this.eventListeners.push(listener);
+        return () => {
+            this.eventListeners = this.eventListeners.filter((l) => l !== listener);
+        };
+    }
+    emit(event) {
+        for (const listener of this.eventListeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Best effort
+            }
+        }
+    }
+}
+// --- Factory ---------------------------------------------------------------
+export function createPerformanceOptimizer(policy) {
+    return new PerformanceOptimizer(policy);
+}
+//# sourceMappingURL=optimizer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.js","sourceRoot":"","sources":["../src/optimizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;GAEG;AACH,SAAS,iBAAiB,CAAC,OAA8B;IACxD,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,EACL,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,GACZ,GAAG,OAAO,CAAC;IAEZ,2BAA2B;IAC3B,MAAM,mBAAmB,GAAG,CAAC,oBAAoB,GAAG,aAAa,CAAC,GAAG,GAAG,CAAC;IACzE,IAAI,mBAAmB,GAAG,EAAE,EAAE,CAAC;QAC9B,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IAED,mBAAmB;IACnB,MAAM,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;IAC/C,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,UAAU,GAAG,GAAG,EAAE,CAAC;QACrD,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED,uBAAuB;IACvB,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IACxC,IAAI,UAAU,GAAG,KAAK,EAAE,CAAC;QACxB,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAC9B,eAGC;IAED,MAAM,UAAU,GAGZ,EAAE,CAAC;IAEP,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QACnE,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC;QAC9B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACf,UAAU,CAAC,UAAU,CAAC,GAAG;gBACxB,WAAW,EAAE,KAAK,CAAC,YAAY,GAAG,KAAK;gBACvC,WAAW,EAAE,KAAK,CAAC,YAAY,GAAG,KAAK;aACvC,CAAC;QACH,CAAC;IACF,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAC/B,OAA8B,EAC9B,MAAyB;IAEzB,MAAM,EAAE,oBAAoB,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,YAAY,GAAG,CAAC,oBAAoB,GAAG,aAAa,CAAC,GAAG,GAAG,CAAC;IAElE,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,CAAC,sBAAsB;IACpC,CAAC;IAED,8CAA8C;IAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,GAAG,GAAG,CAAC,CAAC;IAC5D,MAAM,gBAAgB,GACrB,CAAC,CAAC,oBAAoB,GAAG,YAAY,CAAC,GAAG,oBAAoB,CAAC,GAAG,GAAG,CAAC;IAEtE,IAAI,gBAAgB,GAAG,MAAM,CAAC,0BAA0B,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO;QACN,IAAI,EAAE,gBAAgB;QACtB,YAAY;QACZ,MAAM,EAAE,oBAAoB,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,oBAAoB,IAAI,aAAa,kDAAkD;KAChJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC7B,OAA8B,EAC9B,cAAsC,EACtC,MAAyB;IAEzB,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,aAAa,GAAG,sBAAsB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAEtE,iCAAiC;IACjC,IAAI,aAAa,GAAkB,IAAI,CAAC;IACxC,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAEzB,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACjE,IAAI,KAAK,CAAC,WAAW,GAAG,gBAAgB,IAAI,KAAK,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC;YACrE,aAAa,GAAG,UAAU,CAAC;YAC3B,gBAAgB,GAAG,KAAK,CAAC,WAAW,CAAC;QACtC,CAAC;IACF,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,+CAA+C;IAC/C,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAC/C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,IAAI,CAAC,CAAC,UAAU,KAAK,aAAa,CAChE,CAAC;IAEF,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,CAAC,2BAA2B;IACzC,CAAC;IAED,OAAO;QACN,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,UAAU;QAC1C,MAAM,EAAE,aAAa,aAAa,SAAS,CAAC,gBAAgB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,kBAAkB,CAAC,CAAC,CAAC,CAAC,UAAU,2BAA2B;KACvK,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CACjC,OAA8B,EAC9B,cAAsC,EACtC,MAAyB,EACzB,SAA4D;IAE5D,MAAM,eAAe,GAAgC,EAAE,CAAC;IAExD,iDAAiD;IACjD,IAAI,SAAS,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAC3E,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QAEvE,8EAA8E;QAC9E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAC9B,YAAY,CAAC,MAAM,GAAG,CAAC,EACvB,MAAM,CAAC,cAAc,CACrB,CAAC;YACF,IAAI,cAAc,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;gBAC1C,eAAe,CAAC,IAAI,CAAC;oBACpB,IAAI,EAAE,sBAAsB;oBAC5B,KAAK,EAAE,cAAc;oBACrB,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,2CAA2C,cAAc,yBAAyB;iBAC9G,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QAED,oEAAoE;QACpE,MAAM,gBAAgB,GAAG,cAAc,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAC5B,CAAC;QACF,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,eAAe,CAAC,IAAI,CAAC;gBACpB,IAAI,EAAE,sBAAsB;gBAC5B,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC3C,MAAM,EAAE,iDAAiD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,6BAA6B;aAC1H,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,OAAO,eAAe,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACxB,eAA4C,EAC5C,MAAyB;IAEzB,4EAA4E;IAC5E,MAAM,QAAQ,GAA2B;QACxC,cAAc,EAAE,CAAC;QACjB,oBAAoB,EAAE,CAAC;QACvB,oBAAoB,EAAE,CAAC;QACvB,eAAe,EAAE,CAAC;QAClB,gBAAgB,EAAE,CAAC;QACnB,mBAAmB,EAAE,CAAC;KACtB,CAAC;IAEF,oDAAoD;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,QAAQ,GAAgC,EAAE,CAAC;IAEjD,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CACrC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAC7C,EAAE,CAAC;QACH,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC;QAErB,sBAAsB;QACtB,IACC,GAAG,KAAK,sBAAsB;YAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAC,EACtD,CAAC;YACF,SAAS,CAAC,0CAA0C;QACrD,CAAC;QACD,IACC,GAAG,KAAK,sBAAsB;YAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAC,EACtD,CAAC;YACF,mCAAmC;YACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAC,CAAC;YACzE,IAAI,GAAG,KAAK,CAAC,CAAC;gBAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACF,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CACvB,OAA8B,EAC9B,eAA4C;IAE5C,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,gBAAgB;gBACpB,6DAA6D;gBAC7D,gBAAgB,IAAI,EAAE,CAAC;gBACvB,MAAM;YACP,KAAK,iBAAiB;gBACrB,2DAA2D;gBAC3D,gBAAgB,IAAI,EAAE,CAAC;gBACvB,MAAM;YACP,KAAK,sBAAsB;gBAC1B,oBAAoB;gBACpB,gBAAgB,IAAI,EAAE,CAAC;gBACvB,cAAc,IAAI,EAAE,CAAC;gBACrB,MAAM;YACP,KAAK,qBAAqB;gBACzB,cAAc,IAAI,EAAE,CAAC;gBACrB,MAAM;QACR,CAAC;IACF,CAAC;IAED,OAAO;QACN,qBAAqB,EACpB,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QAC9D,uBAAuB,EACtB,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QAClE,qBAAqB,EACpB,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9D,CAAC;AACH,CAAC;AAED,MAAM,OAAO,oBAAoB;IACxB,MAAM,CAAoB;IAElC,YAAY,MAAM,GAA+B,EAAE;QAClD,IAAI,CAAC,MAAM,GAAG;YACb,0BAA0B,EAAE,EAAE;YAC9B,cAAc,EAAE,EAAE;YAClB,qBAAqB,EAAE,CAAC;YACxB,mBAAmB,EAAE,IAAI;YACzB,eAAe,EAAE,EAAE;YACnB,GAAG,MAAM;SACT,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO,CACN,OAAuC;QAEvC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;QAEnD,mBAAmB;QACnB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,8BAA8B,EAAE,KAAK,EAAE,CAAC,CAAC;QAE3D,IAAI,CAAC;YACJ,wBAAwB;YACxB,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAE/C,8BAA8B;YAC9B,MAAM,eAAe,GAAgC,EAAE,CAAC;YAExD,oBAAoB;YACpB,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACjE,IAAI,UAAU,EAAE,CAAC;gBAChB,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACjC,IAAI,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,oCAAoC;oBAC1C,KAAK;oBACL,cAAc,EAAE,UAAU;iBAC1B,CAAC,CAAC;YACJ,CAAC;YAED,kBAAkB;YAClB,MAAM,WAAW,GAAG,qBAAqB,CACxC,OAAO,EACP,cAAc,EACd,IAAI,CAAC,MAAM,CACX,CAAC;YACF,IAAI,WAAW,EAAE,CAAC;gBACjB,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAClC,IAAI,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,oCAAoC;oBAC1C,KAAK;oBACL,cAAc,EAAE,WAAW;iBAC3B,CAAC,CAAC;YACJ,CAAC;YAED,sBAAsB;YACtB,MAAM,eAAe,GAAG,yBAAyB,CAChD,OAAO,EACP,cAAc,EACd,IAAI,CAAC,MAAM,EACX,OAAO,CAAC,SAAS,CACjB,CAAC;YACF,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;gBACnC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,oCAAoC;oBAC1C,KAAK;oBACL,cAAc,EAAE,GAAG;iBACnB,CAAC,CAAC;YACJ,CAAC;YAED,uBAAuB;YACvB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhE,sBAAsB;YACtB,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAE1D,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gCAAgC,EAAE,KAAK,EAAE,CAAC,CAAC;YAE7D,OAAO;gBACN,KAAK;gBACL,eAAe,EAAE,QAAQ;gBACzB,cAAc;gBACd,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACrC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,YAAY,GACjB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACxD,IAAI,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,6BAA6B;gBACnC,KAAK;gBACL,KAAK,EAAE,YAAY;aACnB,CAAC,CAAC;YACH,OAAO;gBACN,KAAK;gBACL,eAAe,EAAE,EAAE;gBACnB,cAAc,EAAE,EAAE;gBAClB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACrC,CAAC;QACH,CAAC;IACF,CAAC;IAEO,cAAc,GACrB,EAAE,CAAC;IAEJ;;OAEG;IACH,OAAO,CAAC,QAAoD;QAC3D,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE;YACX,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;QACzE,CAAC,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,KAAgC;QAC5C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACJ,QAAQ,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACR,cAAc;YACf,CAAC;QACF,CAAC;IACF,CAAC;CACD;AAED,8EAA8E;AAE9E,MAAM,UAAU,0BAA0B,CACzC,MAAmC;IAEnC,OAAO,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,123 @@
+/**
+ * Performance Optimizer Types (RFC-0056)
+ *
+ * Interfaces for performance analysis and recommendations.
+ */
+export interface RuntimeMetricSnapshot {
+    jobId: string;
+    timestamp: string;
+    /** Total tokens used */
+    totalTokens: number;
+    /** Tokens used in last request */
+    lastRequestTokens: number;
+    /** Average latency in milliseconds */
+    avgLatencyMs: number;
+    /** Number of retries */
+    retryCount: number;
+    /** Number of successful calls */
+    successCount: number;
+    /** Number of failed calls */
+    failureCount: number;
+    /** Current context size in tokens */
+    currentContextTokens: number;
+    /** Max context window */
+    contextWindow: number;
+    /** Provider-specific metrics */
+    providerMetrics: Record<string, ProviderMetric>;
+}
+export interface ProviderMetric {
+    providerId: string;
+    callCount: number;
+    successCount: number;
+    failureCount: number;
+    avgLatencyMs: number;
+    avgTokensPerCall: number;
+}
+export interface ProviderRuntimeState {
+    providerId: string;
+    state: "available" | "limited" | "exhausted" | "disabled" | "unknown";
+    remainingQuota?: number;
+    avgLatencyMs?: number;
+    lastError?: string;
+}
+export interface PerformancePolicy {
+    /** Minimum context usage to consider reduction */
+    minContextReductionPercent: number;
+    /** Maximum parallelism allowed */
+    maxParallelism: number;
+    /** Minimum improvement threshold for recommendations */
+    minImprovementPercent: number;
+    /** Whether to allow provider switching */
+    allowProviderSwitch: boolean;
+    /** Mandatory stages that cannot be skipped */
+    mandatoryStages: string[];
+}
+export interface TaskGraphSnapshot {
+    nodes: Array<{
+        id: string;
+        status: string;
+    }>;
+    edges: Array<{
+        from: string;
+        to: string;
+    }>;
+}
+export interface PerformanceOptimizationRequest {
+    jobId: string;
+    taskId?: string;
+    metrics: RuntimeMetricSnapshot;
+    providerStates: ProviderRuntimeState[];
+    taskGraph: TaskGraphSnapshot;
+    policy: PerformancePolicy;
+}
+export type PerformanceRecommendation = {
+    type: "reduce_context";
+    targetTokens: number;
+    reason: string;
+} | {
+    type: "change_provider";
+    provider: string;
+    reason: string;
+} | {
+    type: "increase_parallelism";
+    limit: number;
+    reason: string;
+} | {
+    type: "decrease_parallelism";
+    limit: number;
+    reason: string;
+} | {
+    type: "reuse_checkpoint";
+    checkpointId: string;
+    reason: string;
+} | {
+    type: "skip_redundant_step";
+    taskId: string;
+    reason: string;
+};
+export interface PerformanceOptimizationPlan {
+    jobId: string;
+    recommendations: PerformanceRecommendation[];
+    expectedImpact: {
+        tokenReductionPercent?: number;
+        latencyReductionPercent?: number;
+        retryReductionPercent?: number;
+    };
+    generatedAt: string;
+}
+export type PerformanceOptimizerEvent = {
+    type: "performance.analysis.started";
+    jobId: string;
+} | {
+    type: "performance.recommendation.created";
+    jobId: string;
+    recommendation: PerformanceRecommendation;
+} | {
+    type: "performance.analysis.completed";
+    jobId: string;
+} | {
+    type: "performance.analysis.failed";
+    jobId: string;
+    error: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/packages/performance-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/performance-optimizer/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Performance Optimizer Types (RFC-0056)
+ *
+ * Interfaces for performance analysis and recommendations.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/packages/performance-optimizer/src/index.ts

@@ -0,0 +1,20 @@
+/**
+ * Performance Optimizer (RFC-0056)
+ *
+ * Re-exports all public types and classes.
+ */
+
+export {
+	PerformanceOptimizer,
+	createPerformanceOptimizer,
+} from "./optimizer.js";
+export type {
+	PerformanceOptimizationRequest,
+	PerformanceOptimizationPlan,
+	PerformanceRecommendation,
+	RuntimeMetricSnapshot,
+	ProviderMetric,
+	ProviderRuntimeState,
+	PerformancePolicy,
+	PerformanceOptimizerEvent,
+} from "./types.js";