@autonav/core 1.6.0 → 1.7.0

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

@@ -1 +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,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,kBAAkB,GACvB,MAAM,CA8CR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA0BrE"}
+{"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

@@ -1,19 +1,19 @@
 /**
  * Prompts for Memento Loop
  *
- * System prompts and user prompts for navigator and worker agents.
+ * System prompts and user prompts for navigator and implementer agents.
  * Uses shared Agent Identity Protocol from communication-layer.
  *
- * Design principle: The WORKER forgets between iterations (memento pattern).
+ * 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 worker has accomplished so far.
+ * 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 worker has done,
+ * 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) {
@@ -39,9 +39,9 @@ ${context.task}
 - **Code Directory:** ${context.codeDirectory}
 - **Branch:** ${context.branch || "(default branch)"}
 
-## Recent Git History (Worker's Progress)
+## Recent Git History (Implementer's Progress)
 
-The worker agent has made the following commits. Use this to understand what has been implemented so far:
+The implementer agent has made the following commits. Use this to understand what has been implemented so far:
 
 \`\`\`
 ${gitLog || "(No commits yet)"}
@@ -56,12 +56,12 @@ ${gitLog || "(No commits yet)"}
 
 ### About the Memento Loop
 
-- The **worker agent forgets** between iterations (it has no memory of previous work)
+- 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 worker has accomplished so far
-- Keep plans focused and incremental - the worker implements one plan at a time
+- 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 worker agent will implement your plan, not you
+- The implementer agent will implement your plan, not you
 
 Submit your implementation plan now using the \`submit_implementation_plan\` tool.`;
 }
@@ -91,17 +91,14 @@ You do NOT implement code yourself. You provide plans for the worker agent.
 - Use conventional commit style for plan summaries (e.g., "feat: add user auth", "fix: resolve login bug")`;
 }
 /**
- * Build the prompt for the worker agent to implement a plan
+ * Build the prompt for the implementer agent to implement a plan
  */
-export function buildWorkerPrompt(codeDirectory, 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");
-    const validationText = plan.validationCriteria
-        .map((c, i) => `${i + 1}. ${c}`)
-        .join("\n");
     return `# Implementation Task
 
 ## Plan Summary
@@ -112,34 +109,20 @@ ${plan.summary}
 
 ${stepsText}
 
-## Validation Criteria
-
-After implementation, verify:
-${validationText}
-
 ## Instructions
 
 1. Implement each step in order
-2. After completing all steps, run the validation checks
-3. **Review your code** - read through what you wrote and check for:
-   - Bugs or logic errors
-   - Missing error handling
-   - Code style issues
-   - Incomplete implementations
-4. Fix any issues before finishing
-5. Report what you accomplished
-
-**Important:** Your changes will be committed automatically after you finish. Make sure the code is ready for commit - review and fix before completing.
+2. Report what you accomplished
 
 **Working Directory:** ${codeDirectory}
 
 Begin implementation now.`;
 }
 /**
- * Build the system prompt for the worker agent
+ * Build the system prompt for the implementer agent
  */
-export function buildWorkerSystemPrompt(codeDirectory) {
-    return `You are a **Worker Agent** implementing code changes.
+export function buildImplementerSystemPrompt(codeDirectory) {
+    return `You are an **Implementer Agent** implementing code changes.
 
 ## Your Role
 
@@ -148,10 +131,7 @@ You receive implementation plans from the Navigator and execute them precisely.
 ## Guidelines
 
 1. **Execute** each step in the plan
-2. **Verify** your work against the validation criteria
-3. **Review** your code before finishing - check for bugs, missing error handling, style issues
-4. **Fix** any issues you find
-5. **Report** what you accomplished
+2. **Report** what you accomplished
 
 ## Working Directory
 
@@ -162,7 +142,67 @@ All file paths are relative to: ${codeDirectory}
 - 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
-- **Review your code** - your changes are committed automatically when you finish`;
+- 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

@@ -1 +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,iBAAiB,CAC/B,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,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB;SAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;SAC/B,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;;EAIP,IAAI,CAAC,OAAO;;;;EAIZ,SAAS;;;;;EAKT,cAAc;;;;;;;;;;;;;;;;yBAgBS,aAAa;;0BAEZ,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,aAAqB;IAC3D,OAAO;;;;;;;;;;;;;;;;kCAgByB,aAAa;;;;;;;;kFAQmC,CAAC;AACnF,CAAC"}
+{"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":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAgB1B;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,MAAM,YAAY,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAEhD,sCAAsC;IACtC,MAAM,aAAa,GACjB,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;QACnC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;QACnC,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC;QACpC,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC;QACtC,YAAY,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IAEjD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;IAED,0BAA0B;IAC1B,IAAI,SAA2B,CAAC;IAChC,IAAI,YAAgC,CAAC;IACrC,IAAI,iBAAqC,CAAC;IAE1C,+DAA+D;IAC/D,MAAM,eAAe,GAAG,YAAY,CAAC,KAAK,CACxC,sEAAsE,CACvE,CAAC;IACF,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,YAAY,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,MAAM,EAAE,CAAC;YACX,SAAS,GAAG,MAAM,CAAC;YACnB,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,aAAa,GAAG,YAAY,CAAC,KAAK,CACtC,qEAAqE,CACtE,CAAC;IACF,IAAI,aAAa,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,OAAO,GAAG,MAAM,CAAC;QACrB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrD,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;QAC1B,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,MAAM,GAAG,EAAE,CAAC;QACxB,CAAC;QACD,iBAAiB,GAAG,OAAO,CAAC;QAC5B,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;QAClD,YAAY,GAAG,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;IACxC,CAAC;IAED,mCAAmC;IACnC,MAAM,eAAe,GAAG,YAAY,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC3F,IAAI,eAAe,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QAClD,iBAAiB,GAAG,OAAO,CAAC;QAC5B,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;QAClD,YAAY,GAAG,GAAG,OAAO,UAAU,CAAC;IACtC,CAAC;IAED,+CAA+C;IAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACzF,IAAI,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC7B,SAAS,GAAG,MAAM,CAAC;YACnB,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC3B,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,SAAS;QACT,YAAY;QACZ,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,kCAAkC;QAClC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAEzB,kBAAkB;QAClB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;QAEtD,gCAAgC;QAChC,MAAM,QAAQ,GAAG,GAAG,OAAO,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QACnD,IAAI,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEhC,8DAA8D;QAC9D,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC5B,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,OAAO,IAAI,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,0DAA0D;QAC1D,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACrC,yCAAyC;YACzC,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS;YACpE,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;gBACrC,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,OAAO,IAAI,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,GAAG,OAAO,GAAG,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,GAAG,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,OAAO,GAAG,EAAE,CAAC;QAC1B,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;IACrD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAO,WAAW;IACpB,GAAG,EAAM,YAAY;IACrB,IAAI,EAAK,aAAa;IACtB,IAAI,EAAK,UAAU;IACnB,KAAK,EAAI,gBAAgB;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3D,OAAO,cAAc,CAAC,KAAK,CAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,MAAuD;IAEvD,IAAI,SAAS,GAAG,OAAO,CAAC;IAExB,OAAO,SAAS,GAAG,CAAC,EAAE,CAAC;QACrB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAClB,SAAS,IAAI,CAAC,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAmB,EAAE,OAAe;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE3C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,SAAS,0BAA0B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,YAAoB;IAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,CACL,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC5B,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC3B,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC9B,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QACvB,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC9B,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC7B,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QACzD,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAChC,KAAK,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAC3C,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QACpC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QACpD,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC9B,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,CAAC,EAAK,YAAY;IAClB,EAAE,EAAI,aAAa;IACnB,EAAE,EAAI,aAAa;IACnB,EAAE,EAAI,WAAW;IACjB,GAAG,EAAG,YAAY;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,uBAAuB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpE,OAAO,uBAAuB,CAAC,KAAK,CAAE,CAAC;AACzC,CAAC"}

package/dist/memento/types.d.ts

@@ -2,10 +2,10 @@
  * Memento Loop Types
  *
  * Core type definitions for the context-clearing iterative development loop
- * that coordinates navigator (planning) and worker (implementation) agents.
+ * that coordinates navigator (planning) and implementer (implementation) agents.
  *
- * Design principle: The WORKER forgets between iterations (memento pattern).
- * The NAVIGATOR maintains its own memory. Git commits track worker progress.
+ * Design principle: The IMPLEMENTER forgets between iterations (memento pattern).
+ * The NAVIGATOR maintains its own memory. Git commits track implementer progress.
  * All types here are for in-memory use during loop execution.
  */
 import { z } from "zod";
@@ -70,10 +70,10 @@ export declare const ImplementationPlanSchema: z.ZodObject<{
 export type ImplementationStep = z.infer<typeof ImplementationStepSchema>;
 export type ImplementationPlan = z.infer<typeof ImplementationPlanSchema>;
 /**
- * Result from worker agent execution
+ * Result from implementer agent execution
  */
-export interface WorkerResult {
-    /** Whether the worker completed successfully */
+export interface ImplementerResult {
+    /** Whether the implementer completed successfully */
     success: boolean;
     /** Summary of what was done */
     summary: string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memento/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,EAAE,CAAC,EAAE,OAAO,CAAC;IAEb,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IAEtB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IAEjB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memento/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,EAAE,CAAC,EAAE,OAAO,CAAC;IAEb,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IAEtB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IAEjB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/memento/types.js

@@ -2,10 +2,10 @@
  * Memento Loop Types
  *
  * Core type definitions for the context-clearing iterative development loop
- * that coordinates navigator (planning) and worker (implementation) agents.
+ * that coordinates navigator (planning) and implementer (implementation) agents.
  *
- * Design principle: The WORKER forgets between iterations (memento pattern).
- * The NAVIGATOR maintains its own memory. Git commits track worker progress.
+ * Design principle: The IMPLEMENTER forgets between iterations (memento pattern).
+ * The NAVIGATOR maintains its own memory. Git commits track implementer progress.
  * All types here are for in-memory use during loop execution.
  */
 import { z } from "zod";

package/dist/memento/worker-agent.d.ts

@@ -1,9 +1,10 @@
 /**
  * Worker Agent for Memento Loop
  *
- * Executes implementation plans using the Claude Agent SDK.
+ * Executes implementation plans via the harness adapter.
  */
 import type { ImplementationPlan, WorkerResult } from "./types.js";
+import { type Harness } from "../harness/index.js";
 /**
  * Minimal context for worker (no persisted state)
  */
@@ -21,6 +22,8 @@ export interface WorkerAgentOptions {
     model?: string;
     /** Maximum turns for worker agent */
     maxTurns?: number;
+    /** Harness to use (defaults to ClaudeCodeHarness) */
+    harness?: Harness;
 }
 /**
  * Run the worker agent to implement a plan

package/dist/memento/worker-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-agent.d.ts","sourceRoot":"","sources":["../../src/memento/worker-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGnE;;GAEG;AACH,UAAU,aAAa;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAoHvB"}
+{"version":3,"file":"worker-agent.d.ts","sourceRoot":"","sources":["../../src/memento/worker-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,KAAK,OAAO,EAAqB,MAAM,qBAAqB,CAAC;AAEtE;;GAEG;AACH,UAAU,aAAa;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAoGvB"}