opencode-timeout-continuer 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 harshpreet931
+
+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,113 @@
+# opencode-timeout-continuer
+
+An OpenCode CLI plugin that automatically retries operations when timeout or retryable errors occur, using exponential backoff.
+
+## Features
+
+- **Automatic retry** on timeout and retryable API errors
+- **Exponential backoff** with configurable delays (1s → 2s → 4s → ...)
+- **Per-session tracking** - retry counts reset when session completes
+- **Silent operation** - no UI interruptions
+- **Fully configurable** - customize retry count, delays, and prompts
+
+## Installation
+
+### From npm (when published)
+
+```bash
+npm install -g opencode-timeout-continuer
+```
+
+### From source
+
+```bash
+git clone <repo-url>
+cd opencode-timeout-continuer
+npm install
+npm run build
+npm pack
+npm install -g opencode-timeout-continuer-*.tgz
+```
+
+## Configuration
+
+Add the plugin to your `opencode.json`:
+
+```json
+{
+  "plugin": ["opencode-timeout-continuer"],
+  "plugin_config": {
+    "opencode-timeout-continuer": {
+      "enabled": true,
+      "maxRetries": 3,
+      "baseDelayMs": 1000,
+      "maxDelayMs": 30000,
+      "prompt": "Continue"
+    }
+  }
+}
+```
+
+### Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `enabled` | boolean | `true` | Enable/disable auto-retry |
+| `maxRetries` | number | `3` | Maximum retry attempts per session (1-10) |
+| `baseDelayMs` | number | `1000` | Base delay for exponential backoff in ms (100-60000) |
+| `maxDelayMs` | number | `30000` | Maximum delay cap in ms (1000-300000) |
+| `prompt` | string | `"Continue"` | Prompt text sent on retry |
+
+## How It Works
+
+1. **Detect**: The plugin listens for `session.error` events from OpenCode
+2. **Analyze**: Checks if the error is retryable:
+   - API errors with `isRetryable: true`
+   - HTTP status codes: 408, 429, 502, 503, 504
+   - Error names containing "timeout" or "ETIMEDOUT"
+3. **Retry**: If retryable and under max retries:
+   - Calculates exponential backoff delay
+   - Sends a continuation prompt after the delay
+4. **Reset**: When a session goes idle, retry counts are reset
+
+### Exponential Backoff
+
+The delay between retries grows exponentially:
+
+| Attempt | Delay |
+|---------|-------|
+| 1 | 1s |
+| 2 | 2s |
+| 3 | 4s |
+| 4 | 8s (capped at maxDelayMs) |
+
+Formula: `delay = min(baseDelayMs * 2^attempt, maxDelayMs)`
+
+## Manual Testing
+
+To test the plugin:
+
+1. Install the plugin globally
+2. Add it to your `opencode.json`
+3. Start OpenCode with a prompt that might timeout (e.g., a complex query)
+4. Watch for log messages in OpenCode's output:
+   - `Plugin initialized with maxRetries=3, baseDelayMs=1000`
+   - `Retryable error detected for session xxx, scheduling retry 1/3`
+
+## Error Types Handled
+
+| Error Type | Retryable? |
+|------------|------------|
+| API Timeout | Yes |
+| HTTP 408 (Request Timeout) | Yes |
+| HTTP 429 (Too Many Requests) | Yes |
+| HTTP 502 (Bad Gateway) | Yes |
+| HTTP 503 (Service Unavailable) | Yes |
+| HTTP 504 (Gateway Timeout) | Yes |
+| ProviderAuthError | No |
+| MessageOutputLengthError | No |
+| MessageAbortedError | No |
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+import type { AutoContinueConfig } from './types';
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: AutoContinueConfig;
+/**
+ * Gets the plugin configuration by merging user config with defaults
+ *
+ * @param pluginConfig - The plugin_config section from opencode.json
+ * @returns Merged and validated configuration
+ */
+export declare function getConfig(pluginConfig?: Record<string, unknown>): AutoContinueConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,kBAM5B,CAAC;AAsCF;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,CAYpF"}

package/dist/config.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.getConfig = getConfig;
+/**
+ * Default configuration values
+ */
+exports.DEFAULT_CONFIG = {
+    enabled: true,
+    maxRetries: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 30000,
+    prompt: 'Continue',
+};
+/**
+ * Validates a single config value and returns default if invalid
+ */
+function validateNumber(value, defaultValue, min, max) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return defaultValue;
+    }
+    if (min !== undefined && value < min) {
+        return defaultValue;
+    }
+    if (max !== undefined && value > max) {
+        return defaultValue;
+    }
+    return value;
+}
+/**
+ * Validates string config value
+ */
+function validateString(value, defaultValue) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        return defaultValue;
+    }
+    return value;
+}
+/**
+ * Validates boolean config value
+ */
+function validateBoolean(value, defaultValue) {
+    if (typeof value !== 'boolean') {
+        return defaultValue;
+    }
+    return value;
+}
+/**
+ * Gets the plugin configuration by merging user config with defaults
+ *
+ * @param pluginConfig - The plugin_config section from opencode.json
+ * @returns Merged and validated configuration
+ */
+function getConfig(pluginConfig) {
+    if (!pluginConfig || typeof pluginConfig !== 'object') {
+        return { ...exports.DEFAULT_CONFIG };
+    }
+    return {
+        enabled: validateBoolean(pluginConfig.enabled, exports.DEFAULT_CONFIG.enabled),
+        maxRetries: validateNumber(pluginConfig.maxRetries, exports.DEFAULT_CONFIG.maxRetries, 1, 10),
+        baseDelayMs: validateNumber(pluginConfig.baseDelayMs, exports.DEFAULT_CONFIG.baseDelayMs, 100, 60000),
+        maxDelayMs: validateNumber(pluginConfig.maxDelayMs, exports.DEFAULT_CONFIG.maxDelayMs, 1000, 300000),
+        prompt: validateString(pluginConfig.prompt, exports.DEFAULT_CONFIG.prompt),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAuDA,8BAYC;AAjED;;GAEG;AACU,QAAA,cAAc,GAAuB;IAChD,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,UAAU;CACnB,CAAC;AAEF;;GAEG;AACH,SAAS,cAAc,CAAC,KAAc,EAAE,YAAoB,EAAE,GAAY,EAAE,GAAY;IACtF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QACrC,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QACrC,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,KAAc,EAAE,YAAoB;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,KAAc,EAAE,YAAqB;IAC5D,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,YAAsC;IAC9D,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACtD,OAAO,EAAE,GAAG,sBAAc,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO;QACL,OAAO,EAAE,eAAe,CAAC,YAAY,CAAC,OAAO,EAAE,sBAAc,CAAC,OAAO,CAAC;QACtE,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC,UAAU,EAAE,sBAAc,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACrF,WAAW,EAAE,cAAc,CAAC,YAAY,CAAC,WAAW,EAAE,sBAAc,CAAC,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC;QAC7F,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC,UAAU,EAAE,sBAAc,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC;QAC5F,MAAM,EAAE,cAAc,CAAC,YAAY,CAAC,MAAM,EAAE,sBAAc,CAAC,MAAM,CAAC;KACnE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+import type { OpenCodeEvent } from './types.js';
+/**
+ * OpenCode plugin for automatic retry on timeout errors
+ *
+ * This plugin automatically retries OpenCode operations when timeout
+ * or retryable errors occur, using exponential backoff.
+ *
+ * Configuration (in opencode.json):
+ * ```json
+ * {
+ *   "plugin": ["opencode-timeout-continuer"],
+ *   "plugin_config": {
+ *     "opencode-timeout-continuer": {
+ *       "enabled": true,
+ *       "maxRetries": 3,
+ *       "baseDelayMs": 1000,
+ *       "maxDelayMs": 30000,
+ *       "prompt": "Continue"
+ *     }
+ *   }
+ * }
+ * ```
+ */
+type Plugin = (input: {
+    client: {
+        session: {
+            prompt: (params: {
+                path: {
+                    id: string;
+                };
+                body: {
+                    parts: Array<{
+                        type: string;
+                        text: string;
+                    }>;
+                };
+            }) => Promise<void>;
+        };
+        app: {
+            log: (params: {
+                body: {
+                    service: string;
+                    level: 'debug' | 'info' | 'warn' | 'error';
+                    message: string;
+                };
+            }) => Promise<void>;
+        };
+    };
+    config?: Record<string, unknown>;
+}) => Promise<{
+    event?: (params: {
+        event: OpenCodeEvent;
+    }) => Promise<void>;
+}>;
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,YAAY,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,KAAK,MAAM,GAAG,CAAC,KAAK,EAAE;IACpB,MAAM,EAAE;QACN,OAAO,EAAE;YACP,MAAM,EAAE,CAAC,MAAM,EAAE;gBACf,IAAI,EAAE;oBAAE,EAAE,EAAE,MAAM,CAAA;iBAAE,CAAC;gBACrB,IAAI,EAAE;oBAAE,KAAK,EAAE,KAAK,CAAC;wBAAE,IAAI,EAAE,MAAM,CAAC;wBAAC,IAAI,EAAE,MAAM,CAAA;qBAAE,CAAC,CAAA;iBAAE,CAAC;aACxD,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;SACrB,CAAC;QACF,GAAG,EAAE;YACH,GAAG,EAAE,CAAC,MAAM,EAAE;gBACZ,IAAI,EAAE;oBACJ,OAAO,EAAE,MAAM,CAAC;oBAChB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;oBAC3C,OAAO,EAAE,MAAM,CAAC;iBACjB,CAAC;aACH,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;SACrB,CAAC;KACH,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,KAAK,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,aAAa,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,CAAC,CAAC;AAEH,QAAA,MAAM,MAAM,EAAE,MA2Fb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const retry_manager_js_1 = require("./retry-manager.js");
+const config_js_1 = require("./config.js");
+const plugin = async ({ client, config }) => {
+    // Get plugin configuration
+    const pluginConfig = config;
+    const retryConfig = (0, config_js_1.getConfig)(pluginConfig);
+    // Initialize retry manager
+    const retryManager = new retry_manager_js_1.RetryManager(retryConfig);
+    // Log plugin initialization
+    await client.app.log({
+        body: {
+            service: 'opencode-timeout-continuer',
+            level: 'info',
+            message: `Plugin initialized with maxRetries=${retryConfig.maxRetries}, baseDelayMs=${retryConfig.baseDelayMs}`,
+        },
+    });
+    return {
+        event: async ({ event }) => {
+            // Handle session.error
+            if (event.type === 'session.error') {
+                const { sessionID, error } = event.properties;
+                if (!sessionID) {
+                    return;
+                }
+                // Check if we should retry
+                if (retryManager.shouldRetry(sessionID, error)) {
+                    const currentCount = retryManager.getCount(sessionID);
+                    await client.app.log({
+                        body: {
+                            service: 'opencode-timeout-continuer',
+                            level: 'info',
+                            message: `Retryable error detected for session ${sessionID}, scheduling retry ${currentCount + 1}/${retryConfig.maxRetries}`,
+                        },
+                    });
+                    // Schedule retry with exponential backoff
+                    retryManager.scheduleRetry(sessionID, async () => {
+                        try {
+                            await client.session.prompt({
+                                path: { id: sessionID },
+                                body: {
+                                    parts: [{ type: 'text', text: retryConfig.prompt }],
+                                },
+                            });
+                        }
+                        catch (err) {
+                            await client.app.log({
+                                body: {
+                                    service: 'opencode-timeout-continuer',
+                                    level: 'error',
+                                    message: `Failed to send retry prompt: ${err instanceof Error ? err.message : String(err)}`,
+                                },
+                            });
+                        }
+                    }, currentCount);
+                }
+                else if (error) {
+                    // Log non-retryable error for debugging
+                    const errInfo = error;
+                    await client.app.log({
+                        body: {
+                            service: 'opencode-timeout-continuer',
+                            level: 'debug',
+                            message: `Non-retryable error for session ${sessionID}: ${errInfo.name || 'unknown'} - ${errInfo.data?.message || 'no message'}`,
+                        },
+                    });
+                }
+            }
+            // Handle session.idle - reset retry state
+            if (event.type === 'session.idle') {
+                const { sessionID } = event.properties;
+                if (sessionID) {
+                    retryManager.reset(sessionID);
+                    await client.app.log({
+                        body: {
+                            service: 'opencode-timeout-continuer',
+                            level: 'debug',
+                            message: `Session ${sessionID} went idle, reset retry state`,
+                        },
+                    });
+                }
+            }
+        },
+    };
+};
+exports.default = plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/retry-manager.d.ts

@@ -0,0 +1,34 @@
+import type { AutoContinueConfig } from './types';
+/**
+ * Manages retry state and exponential backoff for session errors
+ */
+export declare class RetryManager {
+    private sessions;
+    private config;
+    constructor(config: AutoContinueConfig);
+    /**
+     * Check if an error is retryable
+     */
+    private isRetryableError;
+    /**
+     * Check if we should retry for this session
+     */
+    shouldRetry(sessionId: string, error: unknown): boolean;
+    /**
+     * Get current retry count for a session
+     */
+    getCount(sessionId: string): number;
+    /**
+     * Schedule a retry with exponential backoff
+     */
+    scheduleRetry(sessionId: string, callback: () => void | Promise<void>, attempt: number): void;
+    /**
+     * Reset retry state for a session (called on session.idle)
+     */
+    reset(sessionId: string): void;
+    /**
+     * Clear all retry state (cleanup on plugin unload)
+     */
+    clearAll(): void;
+}
+//# sourceMappingURL=retry-manager.d.ts.map

package/dist/retry-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-manager.d.ts","sourceRoot":"","sources":["../src/retry-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAqB,MAAM,SAAS,CAAC;AAErE;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,kBAAkB;IAItC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO;IAmBvD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAInC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA2B7F;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ9B;;OAEG;IACH,QAAQ,IAAI,IAAI;CAQjB"}

package/dist/retry-manager.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryManager = void 0;
+/**
+ * Manages retry state and exponential backoff for session errors
+ */
+class RetryManager {
+    sessions = new Map();
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Check if an error is retryable
+     */
+    isRetryableError(error) {
+        if (!error || typeof error !== 'object') {
+            return false;
+        }
+        const err = error;
+        // Check for ApiError with isRetryable flag
+        if (err.name === 'ApiError' && err.data?.isRetryable === true) {
+            return true;
+        }
+        // Check for timeout-related status codes
+        const statusCode = err.data?.statusCode;
+        if (statusCode && [408, 429, 502, 503, 504].includes(statusCode)) {
+            return true;
+        }
+        // Check error name for timeout patterns
+        const errorName = err.name?.toLowerCase() || '';
+        if (errorName.includes('timeout') || errorName.includes('etimedout')) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Check if we should retry for this session
+     */
+    shouldRetry(sessionId, error) {
+        // Check if plugin is enabled
+        if (!this.config.enabled) {
+            return false;
+        }
+        // Check if error is retryable
+        if (!this.isRetryableError(error)) {
+            return false;
+        }
+        // Get or create session state
+        const state = this.sessions.get(sessionId);
+        const currentCount = state?.count ?? 0;
+        // Check retry limit
+        return currentCount < this.config.maxRetries;
+    }
+    /**
+     * Get current retry count for a session
+     */
+    getCount(sessionId) {
+        return this.sessions.get(sessionId)?.count ?? 0;
+    }
+    /**
+     * Schedule a retry with exponential backoff
+     */
+    scheduleRetry(sessionId, callback, attempt) {
+        // Calculate delay with exponential backoff
+        const delay = Math.min(this.config.baseDelayMs * Math.pow(2, attempt), this.config.maxDelayMs);
+        // Increment retry count
+        const currentState = this.sessions.get(sessionId);
+        const newState = {
+            count: (currentState?.count ?? 0) + 1,
+            lastError: new Date(),
+        };
+        // Set up timeout
+        const timeoutId = setTimeout(async () => {
+            try {
+                await callback();
+            }
+            catch {
+                // Callback errors are handled by the event system
+            }
+        }, delay);
+        newState.timeoutId = timeoutId;
+        this.sessions.set(sessionId, newState);
+    }
+    /**
+     * Reset retry state for a session (called on session.idle)
+     */
+    reset(sessionId) {
+        const state = this.sessions.get(sessionId);
+        if (state?.timeoutId) {
+            clearTimeout(state.timeoutId);
+        }
+        this.sessions.delete(sessionId);
+    }
+    /**
+     * Clear all retry state (cleanup on plugin unload)
+     */
+    clearAll() {
+        for (const state of this.sessions.values()) {
+            if (state.timeoutId) {
+                clearTimeout(state.timeoutId);
+            }
+        }
+        this.sessions.clear();
+    }
+}
+exports.RetryManager = RetryManager;
+//# sourceMappingURL=retry-manager.js.map

package/dist/retry-manager.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Configuration options for the auto-continue plugin
+ */
+export interface AutoContinueConfig {
+    /** Enable/disable auto-continue functionality */
+    enabled: boolean;
+    /** Maximum number of retry attempts */
+    maxRetries: number;
+    /** Base delay in milliseconds for exponential backoff */
+    baseDelayMs: number;
+    /** Maximum delay cap in milliseconds */
+    maxDelayMs: number;
+    /** Prompt text to send when retrying */
+    prompt: string;
+}
+/**
+ * Tracks retry state for a specific session
+ */
+export interface SessionRetryState {
+    /** Current retry count */
+    count: number;
+    /** Timestamp of last error */
+    lastError: Date;
+    /** Pending timeout ID for cleanup */
+    timeoutId?: ReturnType<typeof setTimeout>;
+}
+/**
+ * API error structure from OpenCode
+ */
+export interface ApiError {
+    name: 'ApiError';
+    data: {
+        message: string;
+        statusCode?: number;
+        isRetryable: boolean;
+        responseHeaders?: Record<string, string>;
+        responseBody?: string;
+    };
+}
+/**
+ * Other error types that should NOT be retried
+ */
+export type NonRetryableError = {
+    name: 'ProviderAuthError';
+} | {
+    name: 'MessageOutputLengthError';
+} | {
+    name: 'MessageAbortedError';
+};
+/**
+ * Event properties for session.error
+ */
+export interface SessionErrorEventProperties {
+    sessionID?: string;
+    error?: ApiError | NonRetryableError | Error;
+}
+/**
+ * Event properties for session.idle
+ */
+export interface SessionIdleEventProperties {
+    sessionID: string;
+}
+/**
+ * OpenCode event types that the plugin handles
+ */
+export type OpenCodeEvent = {
+    type: 'session.error';
+    properties: SessionErrorEventProperties;
+} | {
+    type: 'session.idle';
+    properties: SessionIdleEventProperties;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,SAAS,EAAE,IAAI,CAAC;IAChB,qCAAqC;IACrC,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,0BAA0B,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,GAAG,iBAAiB,GAAG,KAAK,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,2BAA2B,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,0BAA0B,CAAA;CAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "opencode-timeout-continuer",
+  "version": "1.0.0",
+  "description": "OpenCode CLI plugin for automatic retry on timeout errors with exponential backoff",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "timeout",
+    "retry",
+    "exponential-backoff"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harshpreet931/opencode-timeout-continuer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/harshpreet931/opencode-timeout-continuer/issues"
+  },
+  "homepage": "https://github.com/harshpreet931/opencode-timeout-continuer#readme",
+  "author": "harshpreet931",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {},
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}