pi-harness-runtime 0.9.4 → 0.9.6

package/packages/quota-manager/dist/tui-usage-monitor.js

@@ -0,0 +1,269 @@
+/**
+ * TUI Usage Monitor — Unified TUI Message Parser
+ *
+ * Hooks into pi's TUI messages to capture quota signals from all providers.
+ * Handles OpenAI, GLM, and any other provider that reports via TUI.
+ *
+ * Usage:
+ * ```typescript
+ * const monitor = new TUIUsageMonitor(quotaManager);
+ *
+ * // Hook into pi
+ * pi.on("error", (event) => monitor.processMessage(event.message));
+ * pi.on("message", (event) => monitor.processMessage(event.message));
+ * ```
+ */
+import { EventEmitter } from "node:events";
+/**
+ * Provider-specific patterns
+ */
+const PROVIDER_PATTERNS = {
+    openai: [
+        /(?:^|\s)OpenAI(?:$|\s)/i,
+        /(?:^|\s)GPT(?:$|\s)/i,
+        /openai.*(?:quota|limit|exhausted)/i,
+        /gpt.*(?:quota|limit|exhausted)/i,
+        /insufficient_quota/i,
+        /context_length_exceeded/i,
+        /openai.*rate.?limit/i,
+        /429.*openai/i,
+        /openai.*context.*(?:window|length)/i,
+    ],
+    glm: [
+        /(?:^|\s)GLM(?:$|\s)/i,
+        /(?:^|\s)Zhipu(?:$|\s)/i,
+        /glm.*(?:quota|limit|exhausted)/i,
+        /zhipu.*(?:quota|limit|exhausted)/i,
+        /glm.*context.*(?:window|length)/i,
+        /glm.*rate.?limit/i,
+    ],
+    anthropic: [
+        /(?:^|\s)Claude(?:$|\s)/i,
+        /(?:^|\s)Anthropic(?:$|\s)/i,
+        /anthropic.*(?:quota|limit|exhausted)/i,
+        /claude.*(?:quota|limit|exhausted)/i,
+        /overloaded_error/i,
+        /rate_limit_error/i,
+    ],
+    openrouter: [
+        /(?:^|\s)OpenRouter(?:$|\s)/i,
+        /openrouter.*(?:quota|limit|exhausted)/i,
+    ],
+};
+const RESET_TIME_PATTERNS = [
+    /reset(?:s)?\s+(?:at|in)\s+(\d{1,2}):(\d{2})/i,
+    /(?:at|in)\s+(\d{1,2}):(\d{2})/i,
+    /retry\s+after\s+(\d{1,2}):(\d{2})/i,
+    /(\d{1,2}):(\d{2})\s*(?:am|pm)/i,
+];
+const PERCENTAGE_PATTERN = /(\d+)%/;
+export class TUIUsageMonitor extends EventEmitter {
+    quotaManager;
+    debug;
+    lastSignals = new Map();
+    constructor(config) {
+        super();
+        this.quotaManager = config.quotaManager;
+        this.debug = config.debug ?? false;
+    }
+    /**
+     * Process a TUI message and extract quota signals
+     */
+    processMessage(message) {
+        // Try to identify provider
+        const provider = this.detectProvider(message);
+        if (!provider) {
+            return null;
+        }
+        // Parse the signal
+        const signal = this.parseSignal(message, provider);
+        if (!signal) {
+            return null;
+        }
+        // Store last signal
+        this.lastSignals.set(provider, signal);
+        // Record to QuotaManager
+        this.recordToQuotaManager(signal);
+        // Emit event
+        this.emit("signal", signal);
+        // Debug log
+        if (this.debug) {
+            console.log(`[TUIUsageMonitor] Detected ${provider}:`, signal);
+        }
+        return signal;
+    }
+    /**
+     * Detect which provider the message is about
+     */
+    detectProvider(message) {
+        for (const [provider, patterns] of Object.entries(PROVIDER_PATTERNS)) {
+            for (const pattern of patterns) {
+                if (pattern.test(message)) {
+                    return provider;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Get the last signal for a provider
+     */
+    getLastSignal(provider) {
+        return this.lastSignals.get(provider) ?? null;
+    }
+    /**
+     * Get all last signals
+     */
+    getAllLastSignals() {
+        return new Map(this.lastSignals);
+    }
+    /**
+     * Clear stored signals
+     */
+    clear() {
+        this.lastSignals.clear();
+    }
+    /**
+     * Parse the quota signal from message
+     */
+    parseSignal(message, provider) {
+        // Determine limit type
+        const limitType = this.detectLimitType(message);
+        // Parse reset time
+        const resetsAt = this.parseResetTime(message);
+        // Parse percentage if available
+        const pctMatch = message.match(PERCENTAGE_PATTERN);
+        const usedPct = pctMatch ? parseInt(pctMatch[1], 10) : undefined;
+        // Determine if exhausted
+        const exhausted = usedPct !== undefined
+            ? usedPct >= 100
+            : this.containsExhaustedKeywords(message);
+        if (!exhausted && !resetsAt) {
+            // Not a quota signal
+            return null;
+        }
+        return {
+            provider,
+            timestamp: new Date().toISOString(),
+            usedPct,
+            remainingPct: usedPct !== undefined ? 100 - usedPct : 0,
+            exhausted,
+            resetsAt,
+            limitType,
+            originalMessage: message,
+        };
+    }
+    /**
+     * Detect the type of limit that was hit
+     */
+    detectLimitType(message) {
+        const lowerMsg = message.toLowerCase();
+        // Context window
+        if (lowerMsg.includes("context") &&
+            (lowerMsg.includes("window") ||
+                lowerMsg.includes("length") ||
+                lowerMsg.includes("full") ||
+                lowerMsg.includes("exceeded"))) {
+            return "context_window";
+        }
+        // Rate limit
+        if (lowerMsg.includes("rate") ||
+            lowerMsg.includes("429") ||
+            lowerMsg.includes("too many requests")) {
+            return "rate_limit";
+        }
+        // Tokens/quota exhausted
+        if (lowerMsg.includes("quota") ||
+            lowerMsg.includes("exhausted") ||
+            lowerMsg.includes("ran out") ||
+            lowerMsg.includes("limit")) {
+            return "tokens";
+        }
+        return "unknown";
+    }
+    /**
+     * Check if message contains exhausted keywords
+     */
+    containsExhaustedKeywords(message) {
+        const keywords = [
+            "exhausted",
+            "quota",
+            "limit",
+            "rate limit",
+            "429",
+            "exceeded",
+            "ran out",
+        ];
+        const lowerMsg = message.toLowerCase();
+        return keywords.some((kw) => lowerMsg.includes(kw));
+    }
+    /**
+     * Parse reset time from message
+     */
+    parseResetTime(message) {
+        for (const pattern of RESET_TIME_PATTERNS) {
+            const match = message.match(pattern);
+            if (match) {
+                let hour = parseInt(match[1], 10);
+                const minute = parseInt(match[2], 10);
+                // Handle AM/PM
+                const matchIndex = message.indexOf(match[0]);
+                const afterMatch = message.slice(matchIndex, matchIndex + 20);
+                const isPM = /pm/i.test(afterMatch);
+                const isAM = /am/i.test(afterMatch);
+                if (isPM && hour < 12)
+                    hour += 12;
+                if (isAM && hour === 12)
+                    hour = 0;
+                // Convert to ISO string
+                const now = new Date();
+                const resetTime = new Date(now);
+                resetTime.setHours(hour, minute, 0, 0);
+                // If time has passed today, assume tomorrow
+                if (resetTime <= now) {
+                    resetTime.setDate(resetTime.getDate() + 1);
+                }
+                return resetTime.toISOString();
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Record signal to QuotaManager
+     */
+    recordToQuotaManager(signal) {
+        // Map limit type to window type
+        let windowType = "5h";
+        if (signal.limitType === "context_window") {
+            // Context window is usually daily or 5h depending on provider
+            windowType = "daily";
+        }
+        // Record to QuotaManager
+        this.quotaManager.recordSignal({
+            provider: signal.provider,
+            source: "tui_message",
+            windowType,
+            usedPct: signal.usedPct,
+            exhausted: signal.exhausted,
+            resetsAt: signal.resetsAt,
+        });
+    }
+}
+/**
+ * Create a TUI usage monitor and automatically hook into pi
+ */
+export function createTUIUsageMonitor(quotaManager, pi, config) {
+    const monitor = new TUIUsageMonitor({
+        quotaManager,
+        debug: config?.debug,
+    });
+    // Hook into pi events
+    pi.on("error", (event) => {
+        monitor.processMessage(event.message);
+    });
+    pi.on("message", (event) => {
+        monitor.processMessage(event.message);
+    });
+    return monitor;
+}
+//# sourceMappingURL=tui-usage-monitor.js.map

package/packages/quota-manager/dist/tui-usage-monitor.js.map

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

package/packages/quota-manager/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@pi-harness/quota-manager",
+  "version": "0.9.6",
+  "description": "pi-harness-runtime — quota-manager",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test"
+  },
+  "dependencies": {}
+}

package/packages/quota-manager/src/examples/tui-usage-integration.ts

@@ -0,0 +1,72 @@
+/**
+ * TUI Usage Integration Example
+ *
+ * Shows how to integrate TUIUsageMonitor with the pi extension.
+ *
+ * Usage:
+ * ```typescript
+ * import { QuotaManager, TUIUsageMonitor } from "@pi-harness/quota-manager";
+ *
+ * // In your extension setup:
+ * const quotaManager = new QuotaManager();
+ *
+ * const monitor = new TUIUsageMonitor({
+ *   quotaManager,
+ *   debug: true,
+ * });
+ *
+ * // Hook into pi events
+ * pi.on("error", (event) => {
+ *   monitor.processMessage(event.message);
+ * });
+ *
+ * pi.on("message", (event) => {
+ *   monitor.processMessage(event.message);
+ * });
+ *
+ * // Now QuotaManager automatically receives signals from all providers
+ * // Check provider availability:
+ * if (!quotaManager.isAvailable("openai")) {
+ *   console.log("OpenAI exhausted, waiting for:", quotaManager.getWaitTime("openai"));
+ * }
+ * ```
+ */
+
+// Example standalone usage
+/*
+import { QuotaManager, TUIUsageMonitor } from "./index.js";
+
+// Create quota manager
+const quotaManager = new QuotaManager();
+
+// Create TUI monitor
+const monitor = new TUIUsageMonitor({
+	quotaManager,
+	debug: true,
+});
+
+// Process some example messages
+const messages = [
+	"OpenAI: Quota exhausted. Reset at 14:30",
+	"GLM context window full. Retry in 30 minutes",
+	"Anthropic Claude rate limit hit. 429 error",
+	"OpenRouter tokens running out",
+];
+
+for (const msg of messages) {
+	const signal = monitor.processMessage(msg);
+	if (signal) {
+		console.log(`Detected: ${signal.provider} - ${signal.limitType}`);
+		console.log(`  Exhausted: ${signal.exhausted}`);
+		console.log(`  Resets at: ${signal.resetsAt}`);
+		console.log("");
+	}
+}
+
+// Check quota state
+console.log("=== Quota State ===");
+for (const provider of ["openai", "glm", "anthropic", "openrouter"]) {
+	const state = quotaManager.getProviderState(provider);
+	console.log(`${provider}: ${state.exhausted ? "EXHAUSTED" : state.limited ? "LIMITED" : "AVAILABLE"}`);
+}
+*/

package/packages/quota-manager/src/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Quota Manager (RFC-0003)
+ *
+ * Multi-provider quota tracking and reset estimation.
+ */
+
+export * from "./quota-manager.js";
+export * from "./tui-usage-monitor.js";