pi-harness-runtime 1.1.6 → 1.1.7

package/packages/quota-manager/dist/tui-usage-monitor.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 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";
+import type { QuotaManager } from "./quota-manager.js";
+export interface TUIUsageSignal {
+    provider: "openai" | "glm" | "anthropic" | "openrouter" | "unknown";
+    timestamp: string;
+    /** Usage percentage (0-100), if available */
+    usedPct?: number;
+    /** Remaining percentage (0-100) */
+    remainingPct: number;
+    /** If exhausted */
+    exhausted: boolean;
+    /** Reset time */
+    resetsAt?: string;
+    /** Which limit was hit */
+    limitType: "tokens" | "context_window" | "rate_limit" | "unknown";
+    /** Original message */
+    originalMessage: string;
+}
+export interface TUIUsageMonitorConfig {
+    /** QuotaManager instance to feed signals into */
+    quotaManager: QuotaManager;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export declare class TUIUsageMonitor extends EventEmitter {
+    private readonly quotaManager;
+    private readonly debug;
+    private lastSignals;
+    constructor(config: TUIUsageMonitorConfig);
+    /**
+     * Process a TUI message and extract quota signals
+     */
+    processMessage(message: string): TUIUsageSignal | null;
+    /**
+     * Detect which provider the message is about
+     */
+    detectProvider(message: string): "openai" | "glm" | "anthropic" | "openrouter" | null;
+    /**
+     * Get the last signal for a provider
+     */
+    getLastSignal(provider: "openai" | "glm" | "anthropic" | "openrouter"): TUIUsageSignal | null;
+    /**
+     * Get all last signals
+     */
+    getAllLastSignals(): Map<string, TUIUsageSignal>;
+    /**
+     * Clear stored signals
+     */
+    clear(): void;
+    /**
+     * Parse the quota signal from message
+     */
+    private parseSignal;
+    /**
+     * Detect the type of limit that was hit
+     */
+    private detectLimitType;
+    /**
+     * Check if message contains exhausted keywords
+     */
+    private containsExhaustedKeywords;
+    /**
+     * Parse reset time from message
+     */
+    private parseResetTime;
+    /**
+     * Record signal to QuotaManager
+     */
+    private recordToQuotaManager;
+}
+/**
+ * Create a TUI usage monitor and automatically hook into pi
+ */
+export declare function createTUIUsageMonitor(quotaManager: QuotaManager, pi: {
+    on: (event: string, handler: (event: {
+        message: string;
+    }) => void) => void;
+}, config?: {
+    debug?: boolean;
+}): TUIUsageMonitor;
+//# sourceMappingURL=tui-usage-monitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tui-usage-monitor.d.ts","sourceRoot":"","sources":["../src/tui-usage-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,QAAQ,GAAG,KAAK,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,QAAQ,GAAG,gBAAgB,GAAG,YAAY,GAAG,SAAS,CAAC;IAClE,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACrC,iDAAiD;IACjD,YAAY,EAAE,YAAY,CAAC;IAC3B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAgDD,qBAAa,eAAgB,SAAQ,YAAY;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,WAAW,CAA0C;IAE7D,YAAY,MAAM,EAAE,qBAAqB,EAIxC;IAED;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA4BrD;IAED;;OAEG;IACH,cAAc,CACb,OAAO,EAAE,MAAM,GACb,QAAQ,GAAG,KAAK,GAAG,WAAW,GAAG,YAAY,GAAG,IAAI,CAStD;IAED;;OAEG;IACH,aAAa,CACZ,QAAQ,EAAE,QAAQ,GAAG,KAAK,GAAG,WAAW,GAAG,YAAY,GACrD,cAAc,GAAG,IAAI,CAEvB;IAED;;OAEG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAE/C;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;OAEG;IACH,OAAO,CAAC,WAAW;IAqCnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsCvB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAcjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAmB5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,YAAY,EAAE,YAAY,EAC1B,EAAE,EAAE;IACH,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,KAAK,IAAI,CAAC;CAC3E,EACD,MAAM,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,eAAe,CAgBjB"}

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

@@ -0,0 +1,268 @@
+/**
+ * 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) {
+        }
+        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/runtime/dist/command-executor.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Command Executor — RFC-0025
+ *
+ * Safe shell command execution with timeout, output capture, and security policies.
+ *
+ * Features:
+ * - Timeout enforcement
+ * - Output capture (stdout/stderr)
+ * - Working directory control
+ * - Environment variable injection
+ * - Security policy enforcement
+ * - Process management (kill, signal)
+ */
+import { EventEmitter } from "node:events";
+export interface CommandResult {
+    success: boolean;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    duration: number;
+    command: string;
+}
+export interface CommandOptions {
+    /** Working directory (default: process.cwd()) */
+    cwd?: string;
+    /** Environment variables to inject */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds (default: no timeout) */
+    timeout?: number;
+    /** Shell to use (default: /bin/sh on Unix, cmd.exe on Windows) */
+    shell?: string;
+    /** User ID to run as (if available) */
+    uid?: number;
+    /** Group ID to run as (if available) */
+    gid?: number;
+    /** Capture stdout (default: true) */
+    captureStdout?: boolean;
+    /** Capture stderr (default: true) */
+    captureStderr?: boolean;
+    /** Treat non-zero exit as success (default: false) */
+    ignoreExitCode?: boolean;
+    /** Policy to check before execution */
+    policyCheck?: boolean;
+}
+export interface CommandPolicy {
+    /** Allowed commands (exact match or pattern) */
+    allowedCommands?: RegExp[];
+    /** Denied commands (takes precedence) */
+    deniedCommands?: RegExp[];
+    /** Maximum timeout in ms */
+    maxTimeout?: number;
+    /** Allowed working directories */
+    allowedDirs?: string[];
+    /** Denied working directories */
+    deniedDirs?: string[];
+    /** Allow shell built-ins */
+    allowShellBuiltins?: boolean;
+    /** Allow environment variable injection */
+    allowEnvInjection?: boolean;
+    /** Commands that require explicit policy bypass */
+    requireApproval?: RegExp[];
+}
+export interface CommandEvent {
+    command: string;
+    timestamp: string;
+    pid?: number;
+}
+export interface CommandExecutorEvents {
+    onStart: (event: CommandEvent) => void;
+    onExit: (event: CommandEvent & {
+        exitCode: number;
+        duration: number;
+    }) => void;
+    onTimeout: (event: CommandEvent) => void;
+    onError: (error: Error, command: string) => void;
+    onPolicyViolation: (reason: string, command: string) => void;
+}
+export declare class CommandExecutor extends EventEmitter {
+    private readonly policy;
+    private runningProcesses;
+    private defaultOptions;
+    constructor(policy?: CommandPolicy);
+    /**
+     * Execute a command synchronously
+     */
+    exec(command: string, options?: CommandOptions): CommandResult;
+    /**
+     * Execute a command asynchronously (non-blocking)
+     */
+    execAsync(command: string, options?: CommandOptions): Promise<CommandResult>;
+    /**
+     * Kill a running process
+     */
+    kill(pid: number, signal?: NodeJS.Signals): boolean;
+    /**
+     * Kill all running processes
+     */
+    killAll(signal?: NodeJS.Signals): number;
+    /**
+     * Get count of running processes
+     */
+    getRunningCount(): number;
+    /**
+     * Get list of running process PIDs
+     */
+    getRunningPids(): number[];
+    /**
+     * Check policy for a command
+     */
+    checkPolicy(command: string, _options?: CommandOptions): {
+        allowed: boolean;
+        reason?: string;
+    };
+    /**
+     * Update policy at runtime
+     */
+    updatePolicy(updates: Partial<CommandPolicy>): void;
+    /**
+     * Get current policy
+     */
+    getPolicy(): CommandPolicy;
+    private waitForExit;
+}
+/**
+ * Create a CommandExecutor with safe defaults for harness runtime
+ */
+export declare function createHarnessExecutor(): CommandExecutor;
+//# sourceMappingURL=command-executor.d.ts.map

package/packages/runtime/dist/command-executor.d.ts.map

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