@autonav/core 1.5.0 → 1.7.0

package/dist/memento/prompts.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Prompts for Memento Loop
+ *
+ * System prompts and user prompts for navigator and implementer agents.
+ * Uses shared Agent Identity Protocol from communication-layer.
+ *
+ * Design principle: The IMPLEMENTER forgets between iterations (memento pattern).
+ * The NAVIGATOR maintains its own memory and knowledge base - we just provide
+ * git history as context about what the implementer has accomplished so far.
+ */
+import { type NavigatorIdentity } from "@autonav/communication-layer";
+import type { ImplementationPlan } from "./types.js";
+export type { NavigatorIdentity };
+/**
+ * Minimal context passed to nav prompt (no persisted state)
+ */
+interface NavPromptContext {
+    codeDirectory: string;
+    task: string;
+    iteration: number;
+    maxIterations: number;
+    branch?: string;
+}
+/**
+ * Build the prompt for the navigator to provide an implementation plan
+ *
+ * Uses Agent Identity Protocol when navigator identity is available.
+ * Git history is provided as context about what the implementer has done,
+ * but the navigator maintains its own knowledge and memory.
+ */
+export declare function buildNavPlanPrompt(context: NavPromptContext, gitLog: string, navigatorIdentity?: NavigatorIdentity | null): string;
+/**
+ * Build the system prompt for the navigator agent
+ */
+export declare function buildNavSystemPrompt(navSystemPrompt: string): string;
+/**
+ * Build the prompt for the implementer agent to implement a plan
+ */
+export declare function buildImplementerPrompt(codeDirectory: string, plan: ImplementationPlan): string;
+/**
+ * Build the system prompt for the implementer agent
+ */
+export declare function buildImplementerSystemPrompt(codeDirectory: string): string;
+/**
+ * Build the prompt for the reviewer (navigator/opus) to review a diff.
+ * Single-turn, no tools — just read the diff and respond.
+ */
+export declare function buildReviewPrompt(diff: string): string;
+/**
+ * Build the prompt for the fixer (implementer/haiku) to fix review issues.
+ */
+export declare function buildFixPrompt(codeDirectory: string, reviewResult: string): string;
+/**
+ * Build the system prompt for the fixer agent
+ */
+export declare function buildFixSystemPrompt(codeDirectory: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/memento/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/memento/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;GAEG;AACH,UAAU,gBAAgB;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAC3C,MAAM,CAoDR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAqBpE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,kBAAkB,GACvB,MAAM,CA4BR;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAsB1E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAgBlE"}

package/dist/memento/prompts.js

@@ -0,0 +1,208 @@
+/**
+ * Prompts for Memento Loop
+ *
+ * System prompts and user prompts for navigator and implementer agents.
+ * Uses shared Agent Identity Protocol from communication-layer.
+ *
+ * Design principle: The IMPLEMENTER forgets between iterations (memento pattern).
+ * The NAVIGATOR maintains its own memory and knowledge base - we just provide
+ * git history as context about what the implementer has accomplished so far.
+ */
+import { buildAgentIdentityProtocol, } from "@autonav/communication-layer";
+/**
+ * Build the prompt for the navigator to provide an implementation plan
+ *
+ * Uses Agent Identity Protocol when navigator identity is available.
+ * Git history is provided as context about what the implementer has done,
+ * but the navigator maintains its own knowledge and memory.
+ */
+export function buildNavPlanPrompt(context, gitLog, navigatorIdentity) {
+    const iterationInfo = context.maxIterations > 0
+        ? `Iteration ${context.iteration} of ${context.maxIterations}`
+        : `Iteration ${context.iteration}`;
+    // Agent Identity Protocol: Explicit role identification and mutual acknowledgment
+    const identityProtocol = buildAgentIdentityProtocol(navigatorIdentity, {
+        name: "Autonav Memento Loop",
+        request: "The memento loop is coordinating implementation work on behalf of the user. Please provide the next implementation plan using the `submit_implementation_plan` tool.",
+    });
+    return `${identityProtocol}# Memento Loop - Planning Phase
+
+You are the **Navigator** guiding a memento loop. Your job is to provide the next implementation plan for the worker agent.
+
+## Task
+
+${context.task}
+
+## Current State
+
+- **${iterationInfo}**
+- **Code Directory:** ${context.codeDirectory}
+- **Branch:** ${context.branch || "(default branch)"}
+
+## Recent Git History (Implementer's Progress)
+
+The implementer agent has made the following commits. Use this to understand what has been implemented so far:
+
+\`\`\`
+${gitLog || "(No commits yet)"}
+\`\`\`
+
+## Instructions
+
+1. **Analyze** the current state - you may explore the codebase, consult your knowledge base, or use any resources you have
+2. **Determine** what work remains to complete the task
+3. **Create** a focused implementation plan for the next iteration
+4. **Use the submit_implementation_plan tool** to submit your plan
+
+### About the Memento Loop
+
+- The **implementer agent forgets** between iterations (it has no memory of previous work)
+- **You** (the navigator) maintain continuity - use your knowledge and judgment
+- The git history shows what the implementer has accomplished so far
+- Keep plans focused and incremental - the implementer implements one plan at a time
+- Set \`isComplete: true\` when the entire task is done
+- The implementer agent will implement your plan, not you
+
+Submit your implementation plan now using the \`submit_implementation_plan\` tool.`;
+}
+/**
+ * Build the system prompt for the navigator agent
+ */
+export function buildNavSystemPrompt(navSystemPrompt) {
+    return `${navSystemPrompt}
+
+# Memento Loop Navigator Role
+
+You are acting as the **Navigator** in a memento loop. Your responsibilities:
+
+1. **Analyze** the current state of the codebase
+2. **Plan** the next implementation steps
+3. **Submit** structured plans via the \`submit_implementation_plan\` tool
+4. **Determine** when the task is complete
+
+You do NOT implement code yourself. You provide plans for the worker agent.
+
+## Key Principles
+
+- Be specific and actionable in your plans
+- Reference concrete files and commands
+- Include clear validation criteria
+- Only mark complete when ALL requirements are met
+- Use conventional commit style for plan summaries (e.g., "feat: add user auth", "fix: resolve login bug")`;
+}
+/**
+ * Build the prompt for the implementer agent to implement a plan
+ */
+export function buildImplementerPrompt(codeDirectory, plan) {
+    const stepsText = plan.steps
+        .map((step, i) => `### Step ${i + 1}: ${step.description}
+${step.files?.length ? `- Files: ${step.files.join(", ")}` : ""}
+${step.commands?.length ? `- Commands: ${step.commands.join(", ")}` : ""}`)
+        .join("\n\n");
+    return `# Implementation Task
+
+## Plan Summary
+
+${plan.summary}
+
+## Steps to Implement
+
+${stepsText}
+
+## Instructions
+
+1. Implement each step in order
+2. Report what you accomplished
+
+**Working Directory:** ${codeDirectory}
+
+Begin implementation now.`;
+}
+/**
+ * Build the system prompt for the implementer agent
+ */
+export function buildImplementerSystemPrompt(codeDirectory) {
+    return `You are an **Implementer Agent** implementing code changes.
+
+## Your Role
+
+You receive implementation plans from the Navigator and execute them precisely.
+
+## Guidelines
+
+1. **Execute** each step in the plan
+2. **Report** what you accomplished
+
+## Working Directory
+
+All file paths are relative to: ${codeDirectory}
+
+## Important
+
+- Focus on implementing the plan, not redesigning it
+- If something is unclear, make reasonable assumptions
+- Report any blockers or issues clearly
+- Do not add features beyond what the plan specifies`;
+}
+/**
+ * Build the prompt for the reviewer (navigator/opus) to review a diff.
+ * Single-turn, no tools — just read the diff and respond.
+ */
+export function buildReviewPrompt(diff) {
+    const truncatedDiff = diff.length > 8000 ? diff.substring(0, 8000) + "\n... (truncated)" : diff;
+    return `Review the following diff for bugs, correctness issues, or missing error handling. Do NOT use any tools — just read the diff and respond.
+
+Respond in EXACTLY one of these formats:
+
+If no issues: Reply with only "LGTM"
+
+If issues found: Reply with a bullet list, one issue per line:
+- [file:line] Issue description. Fix: what to do.
+- [file:line] Issue description. Fix: what to do.
+
+Do NOT suggest style improvements, refactors, or nice-to-haves. Only flag things that are bugs or will cause runtime errors.
+
+\`\`\`diff
+${truncatedDiff}
+\`\`\``;
+}
+/**
+ * Build the prompt for the fixer (implementer/haiku) to fix review issues.
+ */
+export function buildFixPrompt(codeDirectory, reviewResult) {
+    return `# Fix Review Issues
+
+Fix the following issues found during code review:
+
+${reviewResult}
+
+## Instructions
+
+1. Fix each issue listed above
+2. Report what you fixed
+
+**Working Directory:** ${codeDirectory}
+
+Begin fixing now.`;
+}
+/**
+ * Build the system prompt for the fixer agent
+ */
+export function buildFixSystemPrompt(codeDirectory) {
+    return `You are a **Code Fixer Agent** fixing issues found during code review.
+
+## Your Role
+
+You receive a list of issues from a code reviewer and fix them precisely.
+
+## Working Directory
+
+All file paths are relative to: ${codeDirectory}
+
+## Important
+
+- Fix only the issues listed — do not refactor or add features
+- If something is unclear, make a reasonable assumption
+- Report what you fixed`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/memento/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/memento/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,0BAA0B,GAE3B,MAAM,8BAA8B,CAAC;AAiBtC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAyB,EACzB,MAAc,EACd,iBAA4C;IAE5C,MAAM,aAAa,GACjB,OAAO,CAAC,aAAa,GAAG,CAAC;QACvB,CAAC,CAAC,aAAa,OAAO,CAAC,SAAS,OAAO,OAAO,CAAC,aAAa,EAAE;QAC9D,CAAC,CAAC,aAAa,OAAO,CAAC,SAAS,EAAE,CAAC;IAEvC,kFAAkF;IAClF,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,iBAAiB,EAAE;QACrE,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EACL,sKAAsK;KACzK,CAAC,CAAC;IAEH,OAAO,GAAG,gBAAgB;;;;;;EAM1B,OAAO,CAAC,IAAI;;;;MAIR,aAAa;wBACK,OAAO,CAAC,aAAa;gBAC7B,OAAO,CAAC,MAAM,IAAI,kBAAkB;;;;;;;EAOlD,MAAM,IAAI,kBAAkB;;;;;;;;;;;;;;;;;;;mFAmBqD,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,eAAuB;IAC1D,OAAO,GAAG,eAAe;;;;;;;;;;;;;;;;;;;2GAmBgF,CAAC;AAC5G,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,aAAqB,EACrB,IAAwB;IAExB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK;SACzB,GAAG,CACF,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACV,YAAY,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,WAAW;EAC5C,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;EAC7D,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACrE;SACA,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;;;;EAIP,IAAI,CAAC,OAAO;;;;EAIZ,SAAS;;;;;;;yBAOc,aAAa;;0BAEZ,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,aAAqB;IAChE,OAAO;;;;;;;;;;;;;kCAayB,aAAa;;;;;;;qDAOM,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,aAAa,GACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5E,OAAO;;;;;;;;;;;;;EAaP,aAAa;OACR,CAAC;AACR,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,aAAqB,EACrB,YAAoB;IAEpB,OAAO;;;;EAIP,YAAY;;;;;;;yBAOW,aAAa;;kBAEpB,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,OAAO;;;;;;;;kCAQyB,aAAa;;;;;;wBAMvB,CAAC;AACzB,CAAC"}

package/dist/memento/rate-limit.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Rate Limit Handling for Memento Loop
+ *
+ * Detects rate limits and implements retry with countdown.
+ */
+/**
+ * Parsed rate limit info from an error message
+ */
+export interface RateLimitInfo {
+    /** Whether this is a rate limit error */
+    isRateLimited: boolean;
+    /** Parsed reset time if available */
+    resetTime?: Date;
+    /** Raw reset time string from error */
+    resetTimeRaw?: string;
+    /** Seconds until reset (if we could calculate it) */
+    secondsUntilReset?: number;
+}
+/**
+ * Parse a rate limit error message to extract reset time
+ *
+ * Looks for patterns like:
+ * - "resets Feb 4, 9pm"
+ * - "resets in 2 hours"
+ * - "try again at 2026-02-04T21:00:00Z"
+ * - "retry after 3600 seconds"
+ */
+export declare function parseRateLimitError(errorMessage: string): RateLimitInfo;
+/**
+ * Format seconds as human-readable duration
+ */
+export declare function formatDuration(seconds: number): string;
+/**
+ * Maximum wait time: 4 hours (just under session limit window)
+ */
+export declare const MAX_WAIT_SECONDS: number;
+/**
+ * Exponential backoff delays (in seconds), capped at 4h
+ */
+export declare const BACKOFF_DELAYS: number[];
+/**
+ * Get the backoff delay for a given retry attempt
+ */
+export declare function getBackoffDelay(attempt: number): number;
+/**
+ * Sleep for a given number of milliseconds
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Wait with countdown display
+ *
+ * @param seconds - Seconds to wait
+ * @param onTick - Called every second with remaining time
+ * @returns Promise that resolves when wait is complete
+ */
+export declare function waitWithCountdown(seconds: number, onTick?: (remaining: number, formatted: string) => void): Promise<void>;
+/**
+ * Print rate limit waiting message
+ */
+export declare function printRateLimitWait(info: RateLimitInfo, attempt: number): void;
+/**
+ * Check if an error is a transient connection error worth retrying.
+ * These are common on flaky networks, CGNAT, or when connections go stale.
+ */
+export declare function isTransientConnectionError(errorMessage: string): boolean;
+/** Short delays for connection retries (seconds) — no need to wait long */
+export declare const CONNECTION_RETRY_DELAYS: number[];
+/**
+ * Get retry delay for a connection error attempt
+ */
+export declare function getConnectionRetryDelay(attempt: number): number;
+/**
+ * Configuration for rate limit retry behavior
+ */
+export interface RateLimitRetryConfig {
+    /** Maximum number of retry attempts (default: 4) */
+    maxRetries?: number;
+    /** Whether to use parsed reset time or always use backoff (default: true) */
+    useResetTime?: boolean;
+    /** Callback for countdown updates */
+    onCountdown?: (remaining: number, formatted: string) => void;
+    /** Callback when rate limit is detected */
+    onRateLimited?: (info: RateLimitInfo, attempt: number) => void;
+}
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/memento/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/memento/rate-limit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,qCAAqC;IACrC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CA6EvE;AAsCD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYtD;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAc,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,cAAc,UAM1B,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GACtD,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAU7E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAiBxE;AAED,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,UAMnC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qCAAqC;IACrC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7D,2CAA2C;IAC3C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChE"}

package/dist/memento/rate-limit.js

@@ -0,0 +1,221 @@
+/**
+ * Rate Limit Handling for Memento Loop
+ *
+ * Detects rate limits and implements retry with countdown.
+ */
+import chalk from "chalk";
+/**
+ * Parse a rate limit error message to extract reset time
+ *
+ * Looks for patterns like:
+ * - "resets Feb 4, 9pm"
+ * - "resets in 2 hours"
+ * - "try again at 2026-02-04T21:00:00Z"
+ * - "retry after 3600 seconds"
+ */
+export function parseRateLimitError(errorMessage) {
+    const lowerMessage = errorMessage.toLowerCase();
+    // Check if this is a rate limit error
+    const isRateLimited = lowerMessage.includes("rate limit") ||
+        lowerMessage.includes("rate_limit") ||
+        lowerMessage.includes("usage limit") ||
+        lowerMessage.includes("limit reached") ||
+        lowerMessage.includes("you've hit your limit");
+    if (!isRateLimited) {
+        return { isRateLimited: false };
+    }
+    // Try to parse reset time
+    let resetTime;
+    let resetTimeRaw;
+    let secondsUntilReset;
+    // Pattern: "resets Feb 4, 9pm" or "resets February 4, 9:00 PM"
+    const resetsDateMatch = errorMessage.match(/resets?\s+([A-Za-z]+\s+\d{1,2},?\s+\d{1,2}(?::\d{2})?\s*(?:am|pm)?)/i);
+    if (resetsDateMatch?.[1]) {
+        resetTimeRaw = resetsDateMatch[1];
+        const parsed = parseFuzzyDateTime(resetTimeRaw);
+        if (parsed) {
+            resetTime = parsed;
+            secondsUntilReset = Math.max(0, Math.floor((parsed.getTime() - Date.now()) / 1000));
+        }
+    }
+    // Pattern: "resets in X hours/minutes"
+    const resetsInMatch = errorMessage.match(/resets?\s+in\s+(\d+)\s*(hours?|minutes?|mins?|hrs?|seconds?|secs?)/i);
+    if (resetsInMatch && !resetTime) {
+        const amount = parseInt(resetsInMatch[1], 10);
+        const unit = resetsInMatch[2].toLowerCase();
+        let seconds = amount;
+        if (unit.startsWith("hour") || unit.startsWith("hr")) {
+            seconds = amount * 3600;
+        }
+        else if (unit.startsWith("min")) {
+            seconds = amount * 60;
+        }
+        secondsUntilReset = seconds;
+        resetTime = new Date(Date.now() + seconds * 1000);
+        resetTimeRaw = `in ${amount} ${unit}`;
+    }
+    // Pattern: "retry after X seconds"
+    const retryAfterMatch = errorMessage.match(/retry\s+after\s+(\d+)\s*(?:seconds?|secs?)?/i);
+    if (retryAfterMatch && !resetTime) {
+        const seconds = parseInt(retryAfterMatch[1], 10);
+        secondsUntilReset = seconds;
+        resetTime = new Date(Date.now() + seconds * 1000);
+        resetTimeRaw = `${seconds} seconds`;
+    }
+    // Pattern: ISO datetime "2026-02-04T21:00:00Z"
+    const isoMatch = errorMessage.match(/(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z?)/);
+    if (isoMatch && !resetTime) {
+        const parsed = new Date(isoMatch[1]);
+        if (!isNaN(parsed.getTime())) {
+            resetTime = parsed;
+            resetTimeRaw = isoMatch[1];
+            secondsUntilReset = Math.max(0, Math.floor((parsed.getTime() - Date.now()) / 1000));
+        }
+    }
+    return {
+        isRateLimited: true,
+        resetTime,
+        resetTimeRaw,
+        secondsUntilReset,
+    };
+}
+/**
+ * Parse a fuzzy date/time string like "Feb 4, 9pm"
+ */
+function parseFuzzyDateTime(str) {
+    try {
+        // Add current year if not present
+        const now = new Date();
+        let dateStr = str.trim();
+        // Normalize PM/AM
+        dateStr = dateStr.replace(/(\d)\s*(pm|am)/i, "$1 $2");
+        // Try parsing with current year
+        const withYear = `${dateStr} ${now.getFullYear()}`;
+        let parsed = new Date(withYear);
+        // If that didn't work, try next year (for dates that wrapped)
+        if (isNaN(parsed.getTime())) {
+            parsed = new Date(`${dateStr} ${now.getFullYear() + 1}`);
+        }
+        // If the date is in the past, assume it's next occurrence
+        if (parsed.getTime() < now.getTime()) {
+            // Try adding a day, week, month, or year
+            parsed = new Date(parsed.getTime() + 24 * 60 * 60 * 1000); // +1 day
+            if (parsed.getTime() < now.getTime()) {
+                parsed = new Date(`${dateStr} ${now.getFullYear() + 1}`);
+            }
+        }
+        return isNaN(parsed.getTime()) ? null : parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Format seconds as human-readable duration
+ */
+export function formatDuration(seconds) {
+    if (seconds < 60) {
+        return `${seconds}s`;
+    }
+    if (seconds < 3600) {
+        const mins = Math.floor(seconds / 60);
+        const secs = seconds % 60;
+        return secs > 0 ? `${mins}m ${secs}s` : `${mins}m`;
+    }
+    const hours = Math.floor(seconds / 3600);
+    const mins = Math.floor((seconds % 3600) / 60);
+    return mins > 0 ? `${hours}h ${mins}m` : `${hours}h`;
+}
+/**
+ * Maximum wait time: 4 hours (just under session limit window)
+ */
+export const MAX_WAIT_SECONDS = 4 * 60 * 60; // 14400
+/**
+ * Exponential backoff delays (in seconds), capped at 4h
+ */
+export const BACKOFF_DELAYS = [
+    60, // 1 minute
+    300, // 5 minutes
+    1800, // 30 minutes
+    7200, // 2 hours
+    14400, // 4 hours (cap)
+];
+/**
+ * Get the backoff delay for a given retry attempt
+ */
+export function getBackoffDelay(attempt) {
+    const index = Math.min(attempt, BACKOFF_DELAYS.length - 1);
+    return BACKOFF_DELAYS[index];
+}
+/**
+ * Sleep for a given number of milliseconds
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Wait with countdown display
+ *
+ * @param seconds - Seconds to wait
+ * @param onTick - Called every second with remaining time
+ * @returns Promise that resolves when wait is complete
+ */
+export async function waitWithCountdown(seconds, onTick) {
+    let remaining = seconds;
+    while (remaining > 0) {
+        if (onTick) {
+            onTick(remaining, formatDuration(remaining));
+        }
+        await sleep(1000);
+        remaining -= 1;
+    }
+}
+/**
+ * Print rate limit waiting message
+ */
+export function printRateLimitWait(info, attempt) {
+    const waitTime = info.secondsUntilReset ?? getBackoffDelay(attempt);
+    const formatted = formatDuration(waitTime);
+    console.log("");
+    console.log(chalk.yellow("⏳ Rate limited"));
+    if (info.resetTimeRaw) {
+        console.log(chalk.dim(`   Reset time: ${info.resetTimeRaw}`));
+    }
+    console.log(chalk.dim(`   Waiting ${formatted} before retry (attempt ${attempt + 1})...`));
+}
+/**
+ * Check if an error is a transient connection error worth retrying.
+ * These are common on flaky networks, CGNAT, or when connections go stale.
+ */
+export function isTransientConnectionError(errorMessage) {
+    const lower = errorMessage.toLowerCase();
+    return (lower.includes("econnreset") ||
+        lower.includes("etimedout") ||
+        lower.includes("econnrefused") ||
+        lower.includes("epipe") ||
+        lower.includes("ehostunreach") ||
+        lower.includes("enetunreach") ||
+        lower.includes("connection") && lower.includes("timeout") ||
+        lower.includes("socket hang up") ||
+        lower.includes("apiconnectiontimeouterror") ||
+        lower.includes("apiconnectionerror") ||
+        lower.includes("network") && lower.includes("error") ||
+        lower.includes("fetch failed") ||
+        lower.includes("aborted"));
+}
+/** Short delays for connection retries (seconds) — no need to wait long */
+export const CONNECTION_RETRY_DELAYS = [
+    5, // 5 seconds
+    15, // 15 seconds
+    30, // 30 seconds
+    60, // 1 minute
+    120, // 2 minutes
+];
+/**
+ * Get retry delay for a connection error attempt
+ */
+export function getConnectionRetryDelay(attempt) {
+    const index = Math.min(attempt, CONNECTION_RETRY_DELAYS.length - 1);
+    return CONNECTION_RETRY_DELAYS[index];
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/memento/rate-limit.js.map

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