claude-auto-continue 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dakmor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# claude-auto-continue
+
+Automatically resumes Claude Code sessions after usage limits reset — no manual babysitting.
+
+[![npm version](https://img.shields.io/npm/v/claude-auto-continue.svg)](https://www.npmjs.com/package/claude-auto-continue)
+[![Node.js >=18](https://img.shields.io/node/v/claude-auto-continue.svg)](https://nodejs.org)
+[![License: ISC](https://img.shields.io/badge/license-ISC-blue.svg)](LICENSE)
+
+Claude Code pauses with a "usage limit reached" message and a reset timestamp. Instead of watching and waiting, `claude-auto-continue` wraps Claude Code in a pseudo-terminal, monitors all output for rate-limit messages, parses the exact reset timestamp, shows a live status bar and countdown timer, then sends `continue` automatically at reset time. Leave it running overnight; it resumes by itself.
+
+## Install
+
+```bash
+npm install -g claude-auto-continue
+```
+
+## Usage
+
+```bash
+claude-auto-continue          # start — launches 'claude' automatically
+clac                          # short alias
+clac -- --continue            # pass flags through to Claude Code
+```
+
+All arguments after `--` are forwarded directly to `claude`. For example, `clac -- --resume` passes `--resume` to Claude Code.
+
+## Prerequisites
+
+`claude-auto-continue` depends on `node-pty`, a native addon that compiles during install. Build tools must be present.
+
+**Linux (Debian/Ubuntu):**
+
+```bash
+sudo apt-get install build-essential python3 make g++
+```
+
+**macOS:** Xcode Command Line Tools are usually pre-installed. If not:
+
+```bash
+xcode-select --install
+```
+
+**Windows:** `windows-build-tools` may be required. Install via an elevated PowerShell:
+
+```bash
+npm install --global windows-build-tools
+```
+
+**Node.js >= 18 is required.**
+
+## How It Works
+
+1. Wraps `claude` in a pseudo-terminal (PTY) so it receives a real TTY — required for interactive operation
+2. Monitors all output with a regex-based pattern detector that strips ANSI codes and uses a rolling buffer
+3. Parses the reset timestamp from the rate-limit message when a usage limit is detected
+4. Displays a status bar and centered countdown card in the terminal while waiting
+5. Sends `continue` to the PTY at reset time, automatically resuming the session
+6. Returns to monitoring — handles multiple rate limits in a single session
+
+## License
+
+ISC

package/bin/claude-auto-continue.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/cli.js');

package/dist/CountdownCard.d.ts

@@ -0,0 +1,27 @@
+export interface CountdownCardOptions {
+    cols?: number;
+    rows?: number;
+}
+/**
+ * CountdownCard — renders a centered countdown box during WAITING state.
+ *
+ * Pure renderer: produces strings, does NOT write to stdout directly.
+ * The caller is responsible for writing the returned strings to the terminal.
+ */
+export declare class CountdownCard {
+    cols: number;
+    rows: number;
+    constructor(options?: CountdownCardOptions);
+    /**
+     * Render the countdown card as a complete ANSI string.
+     * Shows a centered box with session name, countdown, and absolute reset time.
+     */
+    render(opts: {
+        resetTime: Date | null;
+        cwd: string;
+    }): string;
+    /**
+     * Clear the card area by writing clearLine to each row the card occupied.
+     */
+    clear(): string;
+}

package/dist/CountdownCard.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CountdownCard = void 0;
+const ansi_js_1 = require("./ansi.js");
+const StatusBar_js_1 = require("./StatusBar.js");
+/** Number of lines the card occupies (border + content + border) */
+const CARD_HEIGHT = 9;
+/**
+ * CountdownCard — renders a centered countdown box during WAITING state.
+ *
+ * Pure renderer: produces strings, does NOT write to stdout directly.
+ * The caller is responsible for writing the returned strings to the terminal.
+ */
+class CountdownCard {
+    cols;
+    rows;
+    constructor(options = {}) {
+        this.cols = options.cols ?? 80;
+        this.rows = options.rows ?? 24;
+    }
+    /**
+     * Render the countdown card as a complete ANSI string.
+     * Shows a centered box with session name, countdown, and absolute reset time.
+     */
+    render(opts) {
+        const { resetTime, cwd } = opts;
+        const countdown = resetTime ? (0, StatusBar_js_1.formatCountdown)(resetTime) : 'Unknown';
+        const resetAt = resetTime ? (0, StatusBar_js_1.formatResetTime)(resetTime) : 'Unknown';
+        // Build card content lines (without borders)
+        const header = 'Waiting for rate limit reset';
+        const countdownLine = `${countdown} remaining`;
+        const resetLine = `Resets at ${resetAt}`;
+        const sessionLine = `Session: ${cwd}`;
+        // Calculate box width — fit the longest content line + padding
+        const contentLines = [header, countdownLine, resetLine, sessionLine];
+        const maxContentWidth = Math.max(...contentLines.map((l) => l.length));
+        const boxInnerWidth = Math.min(Math.max(maxContentWidth + 4, 40), this.cols - 4);
+        const boxOuterWidth = boxInnerWidth + 2; // +2 for left/right border chars
+        // Calculate centering positions
+        const startCol = Math.max(1, Math.floor((this.cols - boxOuterWidth) / 2) + 1);
+        // Vertical center: account for row 1 (status bar), so usable area is rows 2..this.rows
+        const usableRows = this.rows - 1;
+        const startRow = Math.max(2, Math.floor((usableRows - CARD_HEIGHT) / 2) + 2);
+        // Build the box
+        const topBorder = '+' + '-'.repeat(boxInnerWidth) + '+';
+        const bottomBorder = topBorder;
+        const emptyLine = '|' + ' '.repeat(boxInnerWidth) + '|';
+        const centerInBox = (text, visibleLength) => {
+            const len = visibleLength ?? text.length;
+            const padding = Math.max(0, boxInnerWidth - len);
+            const leftPad = Math.floor(padding / 2);
+            const rightPad = padding - leftPad;
+            return '|' + ' '.repeat(leftPad) + text + ' '.repeat(rightPad) + '|';
+        };
+        const lines = [
+            topBorder,
+            emptyLine,
+            centerInBox((0, ansi_js_1.bold)(header), header.length),
+            emptyLine,
+            centerInBox((0, ansi_js_1.yellow)(countdownLine), countdownLine.length),
+            centerInBox(resetLine),
+            emptyLine,
+            centerInBox(sessionLine),
+            bottomBorder,
+        ];
+        // Render each line at the calculated position
+        let output = '';
+        for (let i = 0; i < lines.length; i++) {
+            output += (0, ansi_js_1.moveTo)(startRow + i, startCol) + lines[i];
+        }
+        return output;
+    }
+    /**
+     * Clear the card area by writing clearLine to each row the card occupied.
+     */
+    clear() {
+        const boxInnerWidth = Math.min(44, this.cols - 4);
+        const boxOuterWidth = boxInnerWidth + 2;
+        const startCol = Math.max(1, Math.floor((this.cols - boxOuterWidth) / 2) + 1);
+        const usableRows = this.rows - 1;
+        const startRow = Math.max(2, Math.floor((usableRows - CARD_HEIGHT) / 2) + 2);
+        let output = '';
+        for (let i = 0; i < CARD_HEIGHT; i++) {
+            output += (0, ansi_js_1.moveTo)(startRow + i, startCol) + ansi_js_1.clearLine;
+        }
+        return output;
+    }
+}
+exports.CountdownCard = CountdownCard;
+//# sourceMappingURL=CountdownCard.js.map

package/dist/CountdownCard.js.map

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

package/dist/PatternDetector.d.ts

@@ -0,0 +1,33 @@
+import { EventEmitter } from 'events';
+/**
+ * Payload emitted with the 'limit' event.
+ */
+export interface LimitEvent {
+    /** Parsed reset time as a Date, or null when unparseable */
+    resetTime: Date | null;
+    /** Last ~500 chars of the buffer at the time of detection */
+    rawMatch: string;
+}
+export interface PatternDetectorOptions {
+    /** Override default detection pattern */
+    pattern?: RegExp;
+    /** If true, write buffer snapshots to stderr on each feed() call */
+    debug?: boolean;
+}
+/**
+ * EventEmitter subclass that detects Claude rate-limit messages in a stream of
+ * PTY output chunks. Emits a 'limit' event with a LimitEvent payload.
+ */
+export declare class PatternDetector extends EventEmitter {
+    #private;
+    constructor(options?: PatternDetectorOptions);
+    /**
+     * Feed a raw PTY output chunk into the detector.
+     * Strips ANSI codes, appends to rolling buffer, trims if >4KB, then checks pattern.
+     */
+    feed(rawChunk: string): void;
+    /**
+     * Clear the buffer and re-arm detection (allow the next match to fire again).
+     */
+    reset(): void;
+}

package/dist/PatternDetector.js

@@ -0,0 +1,128 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatternDetector = void 0;
+const events_1 = require("events");
+const strip_ansi_1 = __importDefault(require("strip-ansi"));
+const config_js_1 = require("./config.js");
+/**
+ * Default regex that matches all three known Claude rate-limit message formats:
+ *   Format A (legacy): "Claude AI usage limit reached|1760000400"
+ *   Format B (mid-era): "Claude usage limit reached. Your limit will reset at 3pm (America/Santiago)."
+ *   Format C (current): "You've hit your limit · resets 4pm (Europe/Berlin)"
+ */
+const DEFAULT_PATTERN = /(?:Claude(?:\s+AI)?\s+usage\s+limit\s+reached[|.]|you(?:'ve| have)\s+hit\s+your\s+limit)/i;
+/** Matches a 10+ digit unix timestamp after a pipe: |1760000400 */
+const UNIX_TS_PATTERN = /\|(\d{10,})/;
+/**
+ * Matches human-readable reset time in multiple forms:
+ *   "resets Feb 20, 5pm (Africa/Libreville)"
+ *   "reset at 3pm (America/Santiago)"
+ *   "resets 4pm (Europe/Berlin)"
+ */
+const HUMAN_TIME_PATTERN = /reset(?:s)?\s+(?:at\s+)?(?:\w+\s+\d{1,2},?\s*)?(\d{1,2}(?::\d{2})?\s*[ap]m)/i;
+/** Maximum rolling buffer size in characters */
+const MAX_BUFFER = 4096;
+/**
+ * EventEmitter subclass that detects Claude rate-limit messages in a stream of
+ * PTY output chunks. Emits a 'limit' event with a LimitEvent payload.
+ */
+class PatternDetector extends events_1.EventEmitter {
+    #pattern;
+    #debug;
+    #buffer = '';
+    #detected = false;
+    constructor(options = {}) {
+        super();
+        // Priority: constructor option > config file > default
+        const config = (0, config_js_1.loadConfig)();
+        this.#pattern = options.pattern ?? config.pattern ?? DEFAULT_PATTERN;
+        this.#debug = options.debug ?? false;
+    }
+    /**
+     * Feed a raw PTY output chunk into the detector.
+     * Strips ANSI codes, appends to rolling buffer, trims if >4KB, then checks pattern.
+     */
+    feed(rawChunk) {
+        // Already detected — ignore further input until reset()
+        if (this.#detected)
+            return;
+        // Strip ANSI escape codes and append to rolling buffer
+        const clean = (0, strip_ansi_1.default)(rawChunk);
+        this.#buffer += clean;
+        // Trim buffer to last MAX_BUFFER characters to avoid unbounded growth
+        if (this.#buffer.length > MAX_BUFFER) {
+            this.#buffer = this.#buffer.slice(this.#buffer.length - MAX_BUFFER);
+        }
+        if (this.#debug) {
+            process.stderr.write(`[PatternDetector] buffer(${this.#buffer.length}): ${this.#buffer}\n`);
+        }
+        // Test the pattern against the current buffer
+        if (this.#pattern.test(this.#buffer)) {
+            this.#detected = true;
+            const rawMatch = this.#buffer.slice(-500);
+            const resetTime = this.#parseResetTime(this.#buffer);
+            this.emit('limit', { resetTime, rawMatch });
+        }
+    }
+    /**
+     * Clear the buffer and re-arm detection (allow the next match to fire again).
+     */
+    reset() {
+        this.#buffer = '';
+        this.#detected = false;
+    }
+    /**
+     * Parse a reset timestamp from the buffer text.
+     * Tries unix epoch first, then human-readable time expression.
+     * Returns null if neither can be parsed.
+     */
+    #parseResetTime(text) {
+        // Try unix timestamp (Format A): |1760000400
+        const unixMatch = UNIX_TS_PATTERN.exec(text);
+        if (unixMatch) {
+            const seconds = parseInt(unixMatch[1], 10);
+            return new Date(seconds * 1000);
+        }
+        // Try human-readable time (Formats B & C)
+        return this.#parseHumanTime(text);
+    }
+    /**
+     * Parse a human-readable time expression like "3pm", "4pm", "5:30am"
+     * into an absolute Date. Rolls to tomorrow if the time is already past.
+     * Returns null if the pattern doesn't match.
+     *
+     * Note: Does not perform IANA timezone lookup — uses local clock per user decision.
+     */
+    #parseHumanTime(text) {
+        const match = HUMAN_TIME_PATTERN.exec(text);
+        if (!match)
+            return null;
+        const timeStr = match[1].trim(); // e.g. "3pm", "4pm", "5:30am"
+        const timeMatch = /^(\d{1,2})(?::(\d{2}))?\s*([ap]m)$/i.exec(timeStr);
+        if (!timeMatch)
+            return null;
+        let hours = parseInt(timeMatch[1], 10);
+        const minutes = timeMatch[2] ? parseInt(timeMatch[2], 10) : 0;
+        const meridiem = timeMatch[3].toLowerCase();
+        if (meridiem === 'am') {
+            if (hours === 12)
+                hours = 0;
+        }
+        else {
+            if (hours !== 12)
+                hours += 12;
+        }
+        const now = new Date();
+        const candidate = new Date(now.getFullYear(), now.getMonth(), now.getDate(), hours, minutes, 0, 0);
+        // If the time is in the past (or right now), roll to tomorrow
+        if (candidate.getTime() <= now.getTime()) {
+            candidate.setDate(candidate.getDate() + 1);
+        }
+        return candidate;
+    }
+}
+exports.PatternDetector = PatternDetector;
+//# sourceMappingURL=PatternDetector.js.map

package/dist/PatternDetector.js.map

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

package/dist/ProcessSupervisor.d.ts

@@ -0,0 +1,61 @@
+import { EventEmitter } from 'events';
+import * as pty from 'node-pty';
+/**
+ * Four-state machine for the PTY session lifecycle:
+ *
+ *   RUNNING        — normal operation, forwarding I/O and feeding PatternDetector
+ *   LIMIT_DETECTED — transient: rate limit seen, calling scheduler.scheduleAt()
+ *   WAITING        — blocked: scheduler is counting down to reset time
+ *   RESUMING       — transient: sending resume sequence to PTY, resetting detector
+ *
+ * Transitions: RUNNING -> LIMIT_DETECTED -> WAITING -> RESUMING -> RUNNING
+ */
+export declare const enum SessionState {
+    RUNNING = "RUNNING",
+    LIMIT_DETECTED = "LIMIT_DETECTED",
+    WAITING = "WAITING",
+    RESUMING = "RESUMING"
+}
+/** Payload emitted with the 'stateChange' event */
+export interface StateChangeEvent {
+    state: string;
+    resetTime: Date | null;
+}
+export interface ProcessSupervisorOptions {
+    /** Override node-pty spawn function for testing (dependency injection) */
+    spawnFn?: typeof pty.spawn;
+    /** Cooldown after resume — suppresses false-positive re-detections. Default: 30000ms */
+    cooldownMs?: number;
+    /** Safety buffer added to reset time before resuming. Default: 5000ms */
+    safetyMs?: number;
+    /** Override process.exit for testing. Default: process.exit */
+    onExit?: (code: number) => void;
+    /** Override PTY output handler. Default: process.stdout.write */
+    onOutput?: (data: string) => void;
+}
+/**
+ * ProcessSupervisor — the core PTY orchestrator.
+ *
+ * Spawns Claude Code in a real PTY, passes all I/O transparently, detects
+ * usage-limit messages via PatternDetector, waits via Scheduler, and
+ * auto-resumes via StdinWriter.
+ *
+ * Extends EventEmitter to broadcast 'stateChange' events for the display layer.
+ */
+export declare class ProcessSupervisor extends EventEmitter {
+    #private;
+    constructor(options?: ProcessSupervisorOptions);
+    /** Current session state — exposed for Phase 3 status display and testing */
+    get state(): SessionState;
+    /**
+     * Spawn the given command in a PTY and wire up all I/O.
+     *
+     * @param command - executable to run (e.g. 'claude')
+     * @param args    - CLI arguments (e.g. ['--continue'])
+     */
+    spawn(command: string, args: string[]): void;
+    /**
+     * Gracefully shut down: cancel pending timer, mark writer dead, kill PTY.
+     */
+    shutdown(): void;
+}

package/dist/ProcessSupervisor.js

@@ -0,0 +1,184 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessSupervisor = void 0;
+const events_1 = require("events");
+const pty = __importStar(require("node-pty"));
+const PatternDetector_js_1 = require("./PatternDetector.js");
+const Scheduler_js_1 = require("./Scheduler.js");
+const StdinWriter_js_1 = require("./StdinWriter.js");
+/**
+ * ProcessSupervisor — the core PTY orchestrator.
+ *
+ * Spawns Claude Code in a real PTY, passes all I/O transparently, detects
+ * usage-limit messages via PatternDetector, waits via Scheduler, and
+ * auto-resumes via StdinWriter.
+ *
+ * Extends EventEmitter to broadcast 'stateChange' events for the display layer.
+ */
+class ProcessSupervisor extends events_1.EventEmitter {
+    #spawnFn;
+    #cooldownMs;
+    #detector;
+    #scheduler;
+    #onExitCallback;
+    #onOutput;
+    #state = "RUNNING" /* SessionState.RUNNING */;
+    #writer = null;
+    #cooldownUntil = 0;
+    #resetTime = null;
+    constructor(options = {}) {
+        super();
+        this.#spawnFn = options.spawnFn ?? pty.spawn;
+        this.#cooldownMs = options.cooldownMs ?? 30_000;
+        this.#detector = new PatternDetector_js_1.PatternDetector();
+        this.#scheduler = new Scheduler_js_1.Scheduler(options.safetyMs ?? 5_000);
+        this.#onExitCallback = options.onExit ?? ((code) => process.exit(code));
+        this.#onOutput = options.onOutput ?? ((data) => { process.stdout.write(data); });
+        // Listen for rate-limit detections
+        this.#detector.on('limit', (event) => this.#onLimitDetected(event));
+    }
+    /** Current session state — exposed for Phase 3 status display and testing */
+    get state() {
+        return this.#state;
+    }
+    /**
+     * Set state and emit a 'stateChange' event.
+     */
+    #setState(newState) {
+        if (newState !== 'DEAD') {
+            this.#state = newState;
+        }
+        this.emit('stateChange', {
+            state: newState,
+            resetTime: this.#resetTime,
+        });
+    }
+    /**
+     * Spawn the given command in a PTY and wire up all I/O.
+     *
+     * @param command - executable to run (e.g. 'claude')
+     * @param args    - CLI arguments (e.g. ['--continue'])
+     */
+    spawn(command, args) {
+        const ptyProcess = this.#spawnFn(command, args, {
+            name: process.env['TERM'] ?? 'xterm-256color',
+            cols: process.stdout.columns ?? 80,
+            rows: process.stdout.rows ?? 24,
+            cwd: process.cwd(),
+            env: process.env,
+        });
+        this.#writer = new StdinWriter_js_1.StdinWriter(ptyProcess);
+        // --- PTY output: pass to output handler, optionally feed detector ---
+        ptyProcess.onData((data) => {
+            this.#onOutput(data);
+            // Only feed the detector when RUNNING — ignore output in all other states
+            if (this.#state === "RUNNING" /* SessionState.RUNNING */) {
+                this.#detector.feed(data);
+            }
+        });
+        // --- PTY exit: clean up and exit ---
+        ptyProcess.onExit((e) => {
+            this.#writer.markDead();
+            this.#scheduler.cancel();
+            this.#setState('DEAD');
+            // Allow Node.js event loop to drain (stdin will no longer hold the process open)
+            if (process.stdin.isTTY) {
+                process.stdin.unref();
+            }
+            this.#onExitCallback(e.exitCode ?? 0);
+        });
+        // --- Stdin forwarding (only in a real TTY environment) ---
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+            process.stdin.resume();
+            process.stdin.on('data', (chunk) => {
+                // Forward keystrokes to PTY only during RUNNING state
+                if (this.#state === "RUNNING" /* SessionState.RUNNING */) {
+                    this.#writer.write(chunk.toString('binary'));
+                }
+                // Silently discard during WAITING / RESUMING / LIMIT_DETECTED
+            });
+        }
+        // --- Terminal resize forwarding ---
+        process.stdout.on('resize', () => {
+            ptyProcess.resize(process.stdout.columns ?? 80, process.stdout.rows ?? 24);
+        });
+    }
+    /**
+     * Called when PatternDetector emits a 'limit' event.
+     * Transitions: RUNNING -> LIMIT_DETECTED -> WAITING
+     */
+    #onLimitDetected(event) {
+        // Suppress false positives during post-resume cooldown
+        if (Date.now() < this.#cooldownUntil) {
+            return;
+        }
+        this.#resetTime = event.resetTime;
+        this.#setState("LIMIT_DETECTED" /* SessionState.LIMIT_DETECTED */);
+        // Schedule the resume callback
+        this.#scheduler.scheduleAt(event.resetTime, () => this.#onResumeReady());
+        this.#setState("WAITING" /* SessionState.WAITING */);
+    }
+    /**
+     * Called by Scheduler when the reset time has elapsed.
+     * Transitions: WAITING -> RESUMING -> RUNNING
+     */
+    #onResumeReady() {
+        this.#setState("RESUMING" /* SessionState.RESUMING */);
+        // Send Escape to dismiss any rate-limit UI overlay
+        this.#writer.write('\x1b');
+        // Type "continue" and press Enter to resume the session
+        this.#writer.write('continue\r');
+        // Arm cooldown to suppress the false-positive re-detection that can occur
+        // immediately after resume (Claude Code issue #14129)
+        this.#cooldownUntil = Date.now() + this.#cooldownMs;
+        // Re-arm the detector for the next potential rate-limit cycle
+        this.#detector.reset();
+        this.#resetTime = null;
+        this.#setState("RUNNING" /* SessionState.RUNNING */);
+    }
+    /**
+     * Gracefully shut down: cancel pending timer, mark writer dead, kill PTY.
+     */
+    shutdown() {
+        this.#scheduler.cancel();
+        if (this.#writer) {
+            this.#writer.markDead();
+        }
+    }
+}
+exports.ProcessSupervisor = ProcessSupervisor;
+//# sourceMappingURL=ProcessSupervisor.js.map

package/dist/ProcessSupervisor.js.map

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

package/dist/Scheduler.d.ts

@@ -0,0 +1,18 @@
+export declare class Scheduler {
+    #private;
+    constructor(safetyMs?: number);
+    /**
+     * Schedule callback to fire at resetTime + safetyBuffer milliseconds from now.
+     * If resetTime is null → fire immediately (0ms delay) as a fallback.
+     * If resetTime is in the past → waitMs clamps to 0 (plus safety buffer).
+     * Calling scheduleAt() while a timer is pending cancels the previous timer.
+     * Calling scheduleAt() after cancel() is a no-op (cancelled flag stays true).
+     */
+    scheduleAt(resetTime: Date | null, callback: () => void): void;
+    /**
+     * Cancel any pending timer. After cancel(), the scheduler is inert —
+     * subsequent scheduleAt() calls are ignored.
+     * Safe to call when no timer is pending (no-op, no error).
+     */
+    cancel(): void;
+}

package/dist/Scheduler.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scheduler = void 0;
+class Scheduler {
+    #timer = null;
+    #cancelled = false;
+    #safetyMs;
+    constructor(safetyMs = 5000) {
+        this.#safetyMs = safetyMs;
+    }
+    /**
+     * Schedule callback to fire at resetTime + safetyBuffer milliseconds from now.
+     * If resetTime is null → fire immediately (0ms delay) as a fallback.
+     * If resetTime is in the past → waitMs clamps to 0 (plus safety buffer).
+     * Calling scheduleAt() while a timer is pending cancels the previous timer.
+     * Calling scheduleAt() after cancel() is a no-op (cancelled flag stays true).
+     */
+    scheduleAt(resetTime, callback) {
+        if (this.#cancelled)
+            return;
+        // Clear any existing timer before setting a new one
+        if (this.#timer) {
+            clearTimeout(this.#timer);
+            this.#timer = null;
+        }
+        const waitMs = resetTime
+            ? Math.max(0, resetTime.getTime() - Date.now() + this.#safetyMs)
+            : 0;
+        this.#timer = setTimeout(() => {
+            if (!this.#cancelled)
+                callback();
+        }, waitMs);
+    }
+    /**
+     * Cancel any pending timer. After cancel(), the scheduler is inert —
+     * subsequent scheduleAt() calls are ignored.
+     * Safe to call when no timer is pending (no-op, no error).
+     */
+    cancel() {
+        this.#cancelled = true;
+        if (this.#timer) {
+            clearTimeout(this.#timer);
+            this.#timer = null;
+        }
+    }
+}
+exports.Scheduler = Scheduler;
+//# sourceMappingURL=Scheduler.js.map

package/dist/Scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduler.js","sourceRoot":"","sources":["../src/Scheduler.ts"],"names":[],"mappings":";;;AAAA,MAAa,SAAS;IACpB,MAAM,GAAyC,IAAI,CAAC;IACpD,UAAU,GAAG,KAAK,CAAC;IACV,SAAS,CAAS;IAE3B,YAAY,QAAQ,GAAG,IAAI;QACzB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,SAAsB,EAAE,QAAoB;QACrD,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAE5B,oDAAoD;QACpD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QAED,MAAM,MAAM,GAAG,SAAS;YACtB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;YAChE,CAAC,CAAC,CAAC,CAAC;QAEN,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,UAAU;gBAAE,QAAQ,EAAE,CAAC;QACnC,CAAC,EAAE,MAAM,CAAC,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;CACF;AA9CD,8BA8CC"}

package/dist/StatusBar.d.ts

@@ -0,0 +1,41 @@
+export interface StatusBarOptions {
+    cols?: number;
+}
+/**
+ * Format a countdown from now until resetTime as a human-readable string.
+ * Returns "Xh Xm Xs" for durations over an hour, "Xm Xs" otherwise.
+ * Returns "0m 00s" for past or null dates.
+ */
+export declare function formatCountdown(resetTime: Date): string;
+/**
+ * Format a Date as a human-readable absolute time (e.g., "2:45 PM").
+ */
+export declare function formatResetTime(resetTime: Date): string;
+/**
+ * StatusBar — renders a fixed top-row status bar with color-coded session state.
+ *
+ * Pure renderer: produces strings, does NOT write to stdout directly.
+ * The caller is responsible for writing the returned strings to the terminal.
+ */
+export declare class StatusBar {
+    cols: number;
+    constructor(options?: StatusBarOptions);
+    /**
+     * Render the status bar string for the given state.
+     * Returns a complete ANSI sequence: save cursor, move to row 1, render bar, restore cursor.
+     */
+    render(state: string, opts?: {
+        resetTime?: Date;
+        cwd?: string;
+    }): string;
+    /**
+     * Produce the ANSI sequence to initialize the scroll region.
+     * Confines scrolling to rows 2..termRows, leaving row 1 for the status bar.
+     */
+    initScrollRegion(rows: number): string;
+    /**
+     * Produce the ANSI cleanup sequence.
+     * Resets scroll region, shows cursor, and resets all attributes.
+     */
+    cleanup(): string;
+}

package/dist/StatusBar.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusBar = void 0;
+exports.formatCountdown = formatCountdown;
+exports.formatResetTime = formatResetTime;
+const ansi_js_1 = require("./ansi.js");
+/**
+ * Format a countdown from now until resetTime as a human-readable string.
+ * Returns "Xh Xm Xs" for durations over an hour, "Xm Xs" otherwise.
+ * Returns "0m 00s" for past or null dates.
+ */
+function formatCountdown(resetTime) {
+    const remaining = Math.max(0, resetTime.getTime() - Date.now());
+    const totalSec = Math.ceil(remaining / 1000);
+    const hours = Math.floor(totalSec / 3600);
+    const minutes = Math.floor((totalSec % 3600) / 60);
+    const seconds = totalSec % 60;
+    if (hours > 0) {
+        return `${hours}h ${String(minutes).padStart(2, '0')}m ${String(seconds).padStart(2, '0')}s`;
+    }
+    return `${minutes}m ${String(seconds).padStart(2, '0')}s`;
+}
+/**
+ * Format a Date as a human-readable absolute time (e.g., "2:45 PM").
+ */
+function formatResetTime(resetTime) {
+    return resetTime.toLocaleTimeString([], { hour: 'numeric', minute: '2-digit' });
+}
+/**
+ * StatusBar — renders a fixed top-row status bar with color-coded session state.
+ *
+ * Pure renderer: produces strings, does NOT write to stdout directly.
+ * The caller is responsible for writing the returned strings to the terminal.
+ */
+class StatusBar {
+    cols;
+    constructor(options = {}) {
+        this.cols = options.cols ?? 80;
+    }
+    /**
+     * Render the status bar string for the given state.
+     * Returns a complete ANSI sequence: save cursor, move to row 1, render bar, restore cursor.
+     */
+    render(state, opts = {}) {
+        const { resetTime, cwd = '' } = opts;
+        let stateText;
+        let colorFn;
+        switch (state) {
+            case 'RUNNING':
+                stateText = 'Running';
+                colorFn = ansi_js_1.green;
+                break;
+            case 'WAITING':
+                stateText = 'Waiting';
+                colorFn = ansi_js_1.yellow;
+                break;
+            case 'RESUMING':
+                stateText = 'Resuming';
+                colorFn = ansi_js_1.green;
+                break;
+            case 'DEAD':
+                stateText = 'Dead';
+                colorFn = ansi_js_1.red;
+                break;
+            default:
+                stateText = state;
+                colorFn = ansi_js_1.green;
+        }
+        // Build bar content
+        const parts = [colorFn(stateText)];
+        if (state === 'WAITING' && resetTime) {
+            const countdown = formatCountdown(resetTime);
+            const resetAt = formatResetTime(resetTime);
+            parts.push(`${countdown} (resets ${resetAt})`);
+        }
+        if (cwd) {
+            parts.push(cwd);
+        }
+        const content = ` ${parts.join(' | ')} `;
+        const barContent = (0, ansi_js_1.inverse)(content);
+        return `${ansi_js_1.saveCursor}${(0, ansi_js_1.moveTo)(1, 1)}${ansi_js_1.clearLine}${barContent}${ansi_js_1.restoreCursor}`;
+    }
+    /**
+     * Produce the ANSI sequence to initialize the scroll region.
+     * Confines scrolling to rows 2..termRows, leaving row 1 for the status bar.
+     */
+    initScrollRegion(rows) {
+        return `${(0, ansi_js_1.setScrollRegion)(2, rows)}${(0, ansi_js_1.moveTo)(2, 1)}`;
+    }
+    /**
+     * Produce the ANSI cleanup sequence.
+     * Resets scroll region, shows cursor, and resets all attributes.
+     */
+    cleanup() {
+        return `${ansi_js_1.resetScrollRegion}${ansi_js_1.showCursor}${ansi_js_1.resetAttributes}`;
+    }
+}
+exports.StatusBar = StatusBar;
+//# sourceMappingURL=StatusBar.js.map

package/dist/StatusBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusBar.js","sourceRoot":"","sources":["../src/StatusBar.ts"],"names":[],"mappings":";;;AAwBA,0CAWC;AAKD,0CAEC;AA1CD,uCAamB;AAMnB;;;;GAIG;AACH,SAAgB,eAAe,CAAC,SAAe;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,QAAQ,GAAG,EAAE,CAAC;IAE9B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,GAAG,KAAK,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;IAC/F,CAAC;IACD,OAAO,GAAG,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,SAAe;IAC7C,OAAO,SAAS,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AAClF,CAAC;AAED;;;;;GAKG;AACH,MAAa,SAAS;IACpB,IAAI,CAAS;IAEb,YAAY,UAA4B,EAAE;QACxC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAa,EAAE,OAA2C,EAAE;QACjE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;QAErC,IAAI,SAAiB,CAAC;QACtB,IAAI,OAAiC,CAAC;QAEtC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,SAAS;gBACZ,SAAS,GAAG,SAAS,CAAC;gBACtB,OAAO,GAAG,eAAK,CAAC;gBAChB,MAAM;YACR,KAAK,SAAS;gBACZ,SAAS,GAAG,SAAS,CAAC;gBACtB,OAAO,GAAG,gBAAM,CAAC;gBACjB,MAAM;YACR,KAAK,UAAU;gBACb,SAAS,GAAG,UAAU,CAAC;gBACvB,OAAO,GAAG,eAAK,CAAC;gBAChB,MAAM;YACR,KAAK,MAAM;gBACT,SAAS,GAAG,MAAM,CAAC;gBACnB,OAAO,GAAG,aAAG,CAAC;gBACd,MAAM;YACR;gBACE,SAAS,GAAG,KAAK,CAAC;gBAClB,OAAO,GAAG,eAAK,CAAC;QACpB,CAAC;QAED,oBAAoB;QACpB,MAAM,KAAK,GAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAE7C,IAAI,KAAK,KAAK,SAAS,IAAI,SAAS,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,YAAY,OAAO,GAAG,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,GAAG,EAAE,CAAC;YACR,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QACzC,MAAM,UAAU,GAAG,IAAA,iBAAO,EAAC,OAAO,CAAC,CAAC;QAEpC,OAAO,GAAG,oBAAU,GAAG,IAAA,gBAAM,EAAC,CAAC,EAAE,CAAC,CAAC,GAAG,mBAAS,GAAG,UAAU,GAAG,uBAAa,EAAE,CAAC;IACjF,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,IAAY;QAC3B,OAAO,GAAG,IAAA,yBAAe,EAAC,CAAC,EAAE,IAAI,CAAC,GAAG,IAAA,gBAAM,EAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,GAAG,2BAAiB,GAAG,oBAAU,GAAG,yBAAe,EAAE,CAAC;IAC/D,CAAC;CACF;AAzED,8BAyEC"}

package/dist/StdinWriter.d.ts

@@ -0,0 +1,8 @@
+import type * as pty from 'node-pty';
+export declare class StdinWriter {
+    #private;
+    constructor(ptyProcess: pty.IPty);
+    write(data: string): void;
+    markDead(): void;
+    get isDead(): boolean;
+}

package/dist/StdinWriter.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StdinWriter = void 0;
+class StdinWriter {
+    #pty;
+    #dead = false;
+    constructor(ptyProcess) {
+        this.#pty = ptyProcess;
+    }
+    write(data) {
+        if (this.#dead)
+            return;
+        try {
+            this.#pty.write(data);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'EPIPE') {
+                process.stderr.write(`[StdinWriter] write error: ${code ?? String(err)}\n`);
+            }
+            // EPIPE = PTY process exited between dead-check and write — silently ignore
+        }
+    }
+    markDead() {
+        this.#dead = true;
+    }
+    get isDead() {
+        return this.#dead;
+    }
+}
+exports.StdinWriter = StdinWriter;
+//# sourceMappingURL=StdinWriter.js.map

package/dist/StdinWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StdinWriter.js","sourceRoot":"","sources":["../src/StdinWriter.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;IACb,IAAI,CAAW;IACxB,KAAK,GAAG,KAAK,CAAC;IAEd,YAAY,UAAoB;QAC9B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;YACjD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9E,CAAC;YACD,4EAA4E;QAC9E,CAAC;IACH,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AA5BD,kCA4BC"}

package/dist/ansi.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ANSI escape code helpers for terminal rendering.
+ * Pure string functions — no I/O, no dependencies.
+ */
+export declare function moveTo(row: number, col: number): string;
+export declare const saveCursor = "\u001B7";
+export declare const restoreCursor = "\u001B8";
+export declare function setScrollRegion(top: number, bottom: number): string;
+export declare const resetScrollRegion = "\u001B[r";
+export declare const clearLine = "\u001B[2K";
+export declare function green(text: string): string;
+export declare function yellow(text: string): string;
+export declare function red(text: string): string;
+export declare function bold(text: string): string;
+export declare function inverse(text: string): string;
+export declare const showCursor = "\u001B[?25h";
+export declare const hideCursor = "\u001B[?25l";
+export declare const resetAttributes = "\u001B[0m";

package/dist/ansi.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * ANSI escape code helpers for terminal rendering.
+ * Pure string functions — no I/O, no dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetAttributes = exports.hideCursor = exports.showCursor = exports.clearLine = exports.resetScrollRegion = exports.restoreCursor = exports.saveCursor = void 0;
+exports.moveTo = moveTo;
+exports.setScrollRegion = setScrollRegion;
+exports.green = green;
+exports.yellow = yellow;
+exports.red = red;
+exports.bold = bold;
+exports.inverse = inverse;
+const CSI = '\x1b[';
+// --- Cursor positioning ---
+function moveTo(row, col) {
+    return `${CSI}${row};${col}H`;
+}
+exports.saveCursor = '\x1b7';
+exports.restoreCursor = '\x1b8';
+// --- Scroll region ---
+function setScrollRegion(top, bottom) {
+    return `${CSI}${top};${bottom}r`;
+}
+exports.resetScrollRegion = `${CSI}r`;
+// --- Line operations ---
+exports.clearLine = `${CSI}2K`;
+// --- Colors (foreground) ---
+function green(text) {
+    return `${CSI}32m${text}${CSI}0m`;
+}
+function yellow(text) {
+    return `${CSI}33m${text}${CSI}0m`;
+}
+function red(text) {
+    return `${CSI}31m${text}${CSI}0m`;
+}
+// --- Text attributes ---
+function bold(text) {
+    return `${CSI}1m${text}${CSI}0m`;
+}
+function inverse(text) {
+    return `${CSI}7m${text}${CSI}0m`;
+}
+// --- Cursor visibility ---
+exports.showCursor = `${CSI}?25h`;
+exports.hideCursor = `${CSI}?25l`;
+// --- Reset ---
+exports.resetAttributes = `${CSI}0m`;
+//# sourceMappingURL=ansi.js.map

package/dist/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../src/ansi.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAMH,wBAEC;AAOD,0CAEC;AAUD,sBAEC;AAED,wBAEC;AAED,kBAEC;AAID,oBAEC;AAED,0BAEC;AA7CD,MAAM,GAAG,GAAG,OAAO,CAAC;AAEpB,6BAA6B;AAE7B,SAAgB,MAAM,CAAC,GAAW,EAAE,GAAW;IAC7C,OAAO,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC;AAChC,CAAC;AAEY,QAAA,UAAU,GAAG,OAAO,CAAC;AACrB,QAAA,aAAa,GAAG,OAAO,CAAC;AAErC,wBAAwB;AAExB,SAAgB,eAAe,CAAC,GAAW,EAAE,MAAc;IACzD,OAAO,GAAG,GAAG,GAAG,GAAG,IAAI,MAAM,GAAG,CAAC;AACnC,CAAC;AAEY,QAAA,iBAAiB,GAAG,GAAG,GAAG,GAAG,CAAC;AAE3C,0BAA0B;AAEb,QAAA,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC;AAEpC,8BAA8B;AAE9B,SAAgB,KAAK,CAAC,IAAY;IAChC,OAAO,GAAG,GAAG,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC;AACpC,CAAC;AAED,SAAgB,MAAM,CAAC,IAAY;IACjC,OAAO,GAAG,GAAG,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC;AACpC,CAAC;AAED,SAAgB,GAAG,CAAC,IAAY;IAC9B,OAAO,GAAG,GAAG,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC;AACpC,CAAC;AAED,0BAA0B;AAE1B,SAAgB,IAAI,CAAC,IAAY;IAC/B,OAAO,GAAG,GAAG,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC;AACnC,CAAC;AAED,SAAgB,OAAO,CAAC,IAAY;IAClC,OAAO,GAAG,GAAG,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC;AACnC,CAAC;AAED,4BAA4B;AAEf,QAAA,UAAU,GAAG,GAAG,GAAG,MAAM,CAAC;AAC1B,QAAA,UAAU,GAAG,GAAG,GAAG,MAAM,CAAC;AAEvC,gBAAgB;AAEH,QAAA,eAAe,GAAG,GAAG,GAAG,IAAI,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ProcessSupervisor_js_1 = require("./ProcessSupervisor.js");
+const StatusBar_js_1 = require("./StatusBar.js");
+const CountdownCard_js_1 = require("./CountdownCard.js");
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Read the version string from package.json.
+ */
+function getVersion() {
+    try {
+        const pkgPath = (0, path_1.join)(__dirname, '..', 'package.json');
+        const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, 'utf8'));
+        return pkg.version ?? 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Print usage instructions to stdout.
+ */
+function showHelp() {
+    const version = getVersion();
+    console.log(`claude-auto-continue v${version}
+
+Automatically resumes Claude Code sessions after usage limits reset.
+
+USAGE:
+  claude-auto-continue [options] [-- claude-code-args...]
+  clac [options] [-- claude-code-args...]
+
+OPTIONS:
+  --help, -h       Show this help message
+  --version, -v    Show version number
+
+EXAMPLES:
+  claude-auto-continue                  Start with defaults
+  claude-auto-continue -- --continue    Pass --continue to Claude Code
+  clac -- --resume                       Short alias, pass --resume to Claude Code
+
+WHAT IT DOES:
+  Wraps Claude Code in a PTY, monitors for rate-limit messages, waits
+  until the reset time, then sends "continue" to resume automatically.
+  A status bar and countdown timer show progress while waiting.`);
+}
+/**
+ * Parse CLI arguments, extracting Claude Code args after the -- separator.
+ */
+function parseArgs(argv) {
+    const userArgs = argv.slice(2); // strip 'node' and script path
+    const separatorIdx = userArgs.indexOf('--');
+    if (separatorIdx === -1) {
+        return { claudeArgs: [] };
+    }
+    return { claudeArgs: userArgs.slice(separatorIdx + 1) };
+}
+/**
+ * Main entry point — wires ProcessSupervisor to the status display.
+ */
+function main() {
+    const args = process.argv.slice(2);
+    // Handle --help and --version before anything else
+    if (args.includes('--help') || args.includes('-h')) {
+        showHelp();
+        process.exit(0);
+    }
+    if (args.includes('--version') || args.includes('-v')) {
+        console.log(getVersion());
+        process.exit(0);
+    }
+    const { claudeArgs } = parseArgs(process.argv);
+    const cols = () => process.stdout.columns ?? 80;
+    const rows = () => process.stdout.rows ?? 24;
+    const cwd = process.cwd();
+    // Create display components
+    const statusBar = new StatusBar_js_1.StatusBar({ cols: cols() });
+    const countdownCard = new CountdownCard_js_1.CountdownCard({ cols: cols(), rows: rows() });
+    // Set up terminal: scroll region leaves row 1 for status bar
+    process.stdout.write(statusBar.initScrollRegion(rows()));
+    // Initial status bar render
+    process.stdout.write(statusBar.render('RUNNING', { cwd }));
+    // Countdown timer handle
+    let countdownInterval = null;
+    // Create supervisor with output routed through the standard handler
+    const supervisor = new ProcessSupervisor_js_1.ProcessSupervisor({
+        onOutput: (data) => {
+            process.stdout.write(data);
+        },
+    });
+    // Handle state changes from ProcessSupervisor
+    supervisor.on('stateChange', (event) => {
+        const { state, resetTime } = event;
+        // Clear any existing countdown timer
+        if (countdownInterval) {
+            clearInterval(countdownInterval);
+            countdownInterval = null;
+        }
+        if (state === 'DEAD') {
+            // Show dead state in status bar, clear countdown card
+            process.stdout.write(statusBar.render('DEAD', { cwd }));
+            process.stdout.write(countdownCard.clear());
+            // Wait 5 seconds to show "Dead" status, then cleanup and let exit handler run
+            setTimeout(() => {
+                process.stdout.write(statusBar.cleanup());
+            }, 5000);
+            return;
+        }
+        // Re-render status bar for the current state
+        process.stdout.write(statusBar.render(state, { resetTime: resetTime ?? undefined, cwd }));
+        if (state === 'WAITING' && resetTime) {
+            // Show centered countdown card
+            process.stdout.write(countdownCard.render({ resetTime, cwd }));
+            // Start 1-second countdown tick
+            countdownInterval = setInterval(() => {
+                // Race protection: if state has moved on, stop ticking
+                if (supervisor.state !== 'WAITING') {
+                    clearInterval(countdownInterval);
+                    countdownInterval = null;
+                    return;
+                }
+                // Recalculate from resetTime - Date.now() each tick (no drift)
+                process.stdout.write(statusBar.render('WAITING', { resetTime, cwd }));
+                process.stdout.write(countdownCard.render({ resetTime, cwd }));
+            }, 1000);
+        }
+        else {
+            // Clear countdown card if it was showing
+            process.stdout.write(countdownCard.clear());
+        }
+    });
+    // Handle terminal resize
+    process.stdout.on('resize', () => {
+        // Update display component dimensions
+        statusBar.cols = cols();
+        countdownCard.cols = cols();
+        countdownCard.rows = rows();
+        // Re-initialize scroll region with new dimensions
+        process.stdout.write(statusBar.initScrollRegion(rows()));
+        // Re-render current state
+        const currentState = supervisor.state;
+        process.stdout.write(statusBar.render(currentState, { cwd }));
+    });
+    // Terminal cleanup on all exit paths
+    const cleanup = () => {
+        if (countdownInterval) {
+            clearInterval(countdownInterval);
+            countdownInterval = null;
+        }
+        process.stdout.write(statusBar.cleanup());
+    };
+    process.on('exit', cleanup);
+    process.on('SIGINT', () => {
+        cleanup();
+        process.exit(130);
+    });
+    process.on('SIGTERM', () => {
+        cleanup();
+        process.exit(143);
+    });
+    // Spawn Claude Code with passed-through arguments
+    supervisor.spawn('claude', claudeArgs);
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+export interface ToolConfig {
+    pattern?: RegExp;
+}
+export declare const CONFIG_PATH: string;
+export declare function loadConfig(): ToolConfig;

package/dist/config.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_PATH = void 0;
+exports.loadConfig = loadConfig;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+exports.CONFIG_PATH = (0, path_1.join)((0, os_1.homedir)(), '.config', 'claude-auto-continue', 'config.json');
+function loadConfig() {
+    try {
+        const raw = (0, fs_1.readFileSync)(exports.CONFIG_PATH, 'utf8');
+        const parsed = JSON.parse(raw);
+        const config = {};
+        if (typeof parsed.pattern === 'string') {
+            config.pattern = new RegExp(parsed.pattern, 'i');
+        }
+        return config;
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAUA,gCAYC;AAtBD,2BAAkC;AAClC,2BAA6B;AAC7B,+BAA4B;AAMf,QAAA,WAAW,GAAG,IAAA,WAAI,EAAC,IAAA,YAAO,GAAE,EAAE,SAAS,EAAE,sBAAsB,EAAE,aAAa,CAAC,CAAC;AAE7F,SAAgB,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,iBAAY,EAAC,mBAAW,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "claude-auto-continue",
+  "version": "1.0.0",
+  "description": "Automatically resumes Claude Code sessions after usage limits reset",
+  "main": "dist/index.js",
+  "bin": {
+    "claude-auto-continue": "bin/claude-auto-continue.js",
+    "clac": "bin/claude-auto-continue.js"
+  },
+  "files": [
+    "dist/",
+    "bin/"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "auto-continue",
+    "rate-limit",
+    "cli"
+  ],
+  "author": "dakmor",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oguztecimer/claude-auto-continue.git"
+  },
+  "homepage": "https://github.com/oguztecimer/claude-auto-continue#readme",
+  "bugs": {
+    "url": "https://github.com/oguztecimer/claude-auto-continue/issues"
+  },
+  "dependencies": {
+    "node-pty": "^1.1.0",
+    "strip-ansi": "^6.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.9"
+  }
+}