ocr-provenance-mcp 1.0.0

package/dist/tools/workflow.js

@@ -0,0 +1,495 @@
+/**
+ * Workflow and Approval Chain Tools
+ *
+ * Provides 8 MCP tools for document workflow state management and
+ * multi-step approval chains:
+ * - ocr_workflow_submit/review/assign/status/queue (5 workflow tools)
+ * - ocr_approval_chain_create/apply (2 approval chain tools)
+ * - ocr_approval_step_decide (1 approval step tool)
+ *
+ * CRITICAL: NEVER use console.log() - stdout is reserved for JSON-RPC protocol.
+ *
+ * @module tools/workflow
+ */
+import { z } from 'zod';
+import { formatResponse, handleError } from './shared.js';
+import { successResult } from '../server/types.js';
+import { requireDatabase } from '../server/state.js';
+import { validateInput } from '../utils/validation.js';
+import { getLatestWorkflowState, createWorkflowState, listWorkflowQueue, getWorkflowHistory, } from '../services/storage/database/workflow-operations.js';
+import { createApprovalChain, applyApprovalChain, getCurrentApprovalStep, decideApprovalStep, getApprovalProgress, } from '../services/storage/database/approval-operations.js';
+// =============================================================================
+// SCHEMAS
+// =============================================================================
+const WorkflowDecisionSchema = z.enum(['approved', 'rejected', 'changes_requested']);
+const ApprovalDecisionSchema = z.enum(['approved', 'rejected']);
+// =============================================================================
+// TOOL 3.1: ocr_workflow_submit
+// =============================================================================
+async function handleWorkflowSubmit(params) {
+    try {
+        const input = validateInput(z.object({
+            document_id: z.string().min(1),
+            assigned_to: z.string().min(1).optional(),
+            due_date: z.string().min(1).optional(),
+            metadata: z.record(z.unknown()).optional(),
+        }), params);
+        const { db } = requireDatabase();
+        const conn = db.getConnection();
+        // Check current state - create draft first if no workflow history exists
+        const current = getLatestWorkflowState(conn, input.document_id);
+        if (!current) {
+            // No workflow history - create draft first, then submit
+            createWorkflowState(conn, {
+                document_id: input.document_id,
+                state: 'draft',
+            });
+        }
+        // Now transition to submitted
+        const submitted = createWorkflowState(conn, {
+            document_id: input.document_id,
+            state: 'submitted',
+            assigned_to: input.assigned_to,
+            due_date: input.due_date,
+            metadata: input.metadata,
+        });
+        return formatResponse(successResult({
+            workflow_state: submitted,
+            next_steps: [
+                { tool: 'ocr_workflow_status', description: 'Check workflow status for this document' },
+                { tool: 'ocr_workflow_assign', description: 'Assign a reviewer to this document' },
+                { tool: 'ocr_workflow_queue', description: 'View all pending review documents' },
+            ],
+        }));
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+// =============================================================================
+// TOOL 3.2: ocr_workflow_review
+// =============================================================================
+async function handleWorkflowReview(params) {
+    try {
+        const input = validateInput(z.object({
+            document_id: z.string().min(1),
+            decision: WorkflowDecisionSchema,
+            reason: z.string().max(2000).optional(),
+        }), params);
+        // Reason required for reject/changes_requested
+        if ((input.decision === 'rejected' || input.decision === 'changes_requested') && !input.reason) {
+            throw new Error(`Reason is required when decision is "${input.decision}"`);
+        }
+        const { db } = requireDatabase();
+        const conn = db.getConnection();
+        // Verify current state is in_review
+        const current = getLatestWorkflowState(conn, input.document_id);
+        if (!current) {
+            throw new Error(`No workflow history found for document ${input.document_id}`);
+        }
+        if (current.state !== 'in_review') {
+            throw new Error(`Cannot review document ${input.document_id}: current state is "${current.state}", ` +
+                `must be "in_review". Use ocr_workflow_status to check the current state.`);
+        }
+        const reviewed = createWorkflowState(conn, {
+            document_id: input.document_id,
+            state: input.decision,
+            reason: input.reason,
+            assigned_to: current.assigned_to,
+        });
+        const nextSteps = [];
+        if (input.decision === 'approved') {
+            nextSteps.push({ tool: 'ocr_workflow_status', description: 'View updated workflow status' }, { tool: 'ocr_approval_chain_apply', description: 'Apply an approval chain for formal sign-off' });
+        }
+        else if (input.decision === 'changes_requested') {
+            nextSteps.push({ tool: 'ocr_workflow_status', description: 'View updated workflow status' }, { tool: 'ocr_annotation_create', description: 'Add annotations detailing requested changes' });
+        }
+        else {
+            nextSteps.push({ tool: 'ocr_workflow_status', description: 'View updated workflow status' });
+        }
+        return formatResponse(successResult({
+            workflow_state: reviewed,
+            decision: input.decision,
+            next_steps: nextSteps,
+        }));
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+// =============================================================================
+// TOOL 3.3: ocr_workflow_assign
+// =============================================================================
+async function handleWorkflowAssign(params) {
+    try {
+        const input = validateInput(z.object({
+            document_id: z.string().min(1),
+            user_id: z.string().min(1),
+            assigned_by: z.string().min(1).optional(),
+        }), params);
+        const { db } = requireDatabase();
+        const conn = db.getConnection();
+        // Get current workflow state
+        const current = getLatestWorkflowState(conn, input.document_id);
+        if (!current) {
+            throw new Error(`No workflow history found for document ${input.document_id}`);
+        }
+        // Only allow assignment when in submitted or in_review state
+        if (current.state !== 'submitted' && current.state !== 'in_review') {
+            throw new Error(`Cannot assign reviewer: document ${input.document_id} is in state "${current.state}". ` +
+                `Document must be in "submitted" or "in_review" state.`);
+        }
+        // If submitted, transition to in_review with the assigned reviewer
+        if (current.state === 'submitted') {
+            const inReview = createWorkflowState(conn, {
+                document_id: input.document_id,
+                state: 'in_review',
+                assigned_to: input.user_id,
+                assigned_by: input.assigned_by,
+                due_date: current.due_date,
+            });
+            return formatResponse(successResult({
+                workflow_state: inReview,
+                assigned_to: input.user_id,
+                transitioned_to: 'in_review',
+                next_steps: [
+                    { tool: 'ocr_workflow_review', description: 'Review this document (approve/reject/request changes)' },
+                    { tool: 'ocr_workflow_status', description: 'Check workflow status' },
+                ],
+            }));
+        }
+        // Already in_review - update assignment via metadata
+        // We create a new in_review state with the updated assignment
+        // (This is valid because in_review -> in_review is not in transitions,
+        //  so we update the current row directly instead)
+        conn.prepare(`
+      UPDATE workflow_states SET assigned_to = ?, assigned_by = ?
+      WHERE id = ?
+    `).run(input.user_id, input.assigned_by ?? null, current.id);
+        const updated = conn.prepare('SELECT * FROM workflow_states WHERE id = ?').get(current.id);
+        return formatResponse(successResult({
+            workflow_state: updated,
+            assigned_to: input.user_id,
+            reassigned: true,
+            next_steps: [
+                { tool: 'ocr_workflow_review', description: 'Review this document' },
+                { tool: 'ocr_workflow_status', description: 'Check workflow status' },
+            ],
+        }));
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+// =============================================================================
+// TOOL 3.4: ocr_workflow_status
+// =============================================================================
+async function handleWorkflowStatus(params) {
+    try {
+        const input = validateInput(z.object({
+            document_id: z.string().min(1),
+        }), params);
+        const { db } = requireDatabase();
+        const conn = db.getConnection();
+        const current = getLatestWorkflowState(conn, input.document_id);
+        const history = getWorkflowHistory(conn, input.document_id);
+        if (!current) {
+            return formatResponse(successResult({
+                document_id: input.document_id,
+                current_state: null,
+                history: [],
+                message: 'No workflow history for this document',
+                next_steps: [
+                    { tool: 'ocr_workflow_submit', description: 'Submit this document for review' },
+                ],
+            }));
+        }
+        // Check for approval chains applied to this document
+        const approvalSteps = conn.prepare('SELECT DISTINCT chain_id FROM approval_steps WHERE document_id = ?').all(input.document_id);
+        const nextSteps = [];
+        switch (current.state) {
+            case 'draft':
+                nextSteps.push({ tool: 'ocr_workflow_submit', description: 'Submit for review' });
+                break;
+            case 'submitted':
+                nextSteps.push({ tool: 'ocr_workflow_assign', description: 'Assign a reviewer' }, { tool: 'ocr_workflow_queue', description: 'View review queue' });
+                break;
+            case 'in_review':
+                nextSteps.push({ tool: 'ocr_workflow_review', description: 'Make a review decision' });
+                break;
+            case 'changes_requested':
+                nextSteps.push({ tool: 'ocr_workflow_submit', description: 'Re-submit after changes' });
+                break;
+            case 'approved':
+                nextSteps.push({ tool: 'ocr_approval_chain_apply', description: 'Apply an approval chain' }, { tool: 'ocr_workflow_queue', description: 'View review queue' });
+                break;
+            default:
+                nextSteps.push({ tool: 'ocr_workflow_queue', description: 'View review queue' });
+        }
+        return formatResponse(successResult({
+            document_id: input.document_id,
+            current_state: current,
+            history,
+            approval_chains_applied: approvalSteps.map((s) => s.chain_id),
+            next_steps: nextSteps,
+        }));
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+// =============================================================================
+// TOOL 3.5: ocr_workflow_queue
+// =============================================================================
+async function handleWorkflowQueue(params) {
+    try {
+        const input = validateInput(z.object({
+            assigned_to: z.string().min(1).optional(),
+            state: z.string().min(1).optional(),
+            due_before: z.string().min(1).optional(),
+            limit: z.number().int().min(1).max(200).default(50),
+            offset: z.number().int().min(0).default(0),
+        }), params);
+        const { db } = requireDatabase();
+        const conn = db.getConnection();
+        const limit = input.limit ?? 50;
+        const offset = input.offset ?? 0;
+        const result = listWorkflowQueue(conn, {
+            assigned_to: input.assigned_to,
+            state: input.state,
+            due_before: input.due_before,
+            limit,
+            offset,
+        });
+        const hasMore = offset + result.items.length < result.total;
+        return formatResponse(successResult({
+            items: result.items,
+            total: result.total,
+            limit,
+            offset,
+            has_more: hasMore,
+            next_steps: hasMore
+                ? [{ tool: 'ocr_workflow_queue', description: `Get next page with offset=${offset + limit}` }]
+                : [
+                    { tool: 'ocr_workflow_status', description: 'Get details for a specific document' },
+                    { tool: 'ocr_workflow_review', description: 'Review a document from the queue' },
+                    { tool: 'ocr_workflow_assign', description: 'Assign a reviewer to a document' },
+                ],
+        }));
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+// =============================================================================
+// TOOL 3.6: ocr_approval_chain_create
+// =============================================================================
+async function handleApprovalChainCreate(params) {
+    try {
+        const input = validateInput(z.object({
+            name: z.string().min(1).max(200),
+            description: z.string().max(1000).optional(),
+            steps: z.array(z.object({
+                role: z.string().min(1),
+                required_approvals: z.number().int().min(1).optional(),
+                auto_advance: z.boolean().optional(),
+            })).min(1),
+            created_by: z.string().min(1).optional(),
+        }), params);
+        const { db } = requireDatabase();
+        const conn = db.getConnection();
+        const chain = createApprovalChain(conn, {
+            name: input.name,
+            description: input.description,
+            steps: input.steps,
+            created_by: input.created_by,
+        });
+        return formatResponse(successResult({
+            chain,
+            steps_count: input.steps.length,
+            next_steps: [
+                { tool: 'ocr_approval_chain_apply', description: 'Apply this chain to a document' },
+                { tool: 'ocr_approval_chain_create', description: 'Create another approval chain' },
+            ],
+        }));
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+// =============================================================================
+// TOOL 3.7: ocr_approval_chain_apply
+// =============================================================================
+async function handleApprovalChainApply(params) {
+    try {
+        const input = validateInput(z.object({
+            document_id: z.string().min(1),
+            chain_id: z.string().min(1),
+        }), params);
+        const { db } = requireDatabase();
+        const conn = db.getConnection();
+        const steps = applyApprovalChain(conn, input.document_id, input.chain_id);
+        const currentStep = steps.length > 0 ? steps[0] : null;
+        return formatResponse(successResult({
+            document_id: input.document_id,
+            chain_id: input.chain_id,
+            steps_created: steps.length,
+            steps,
+            current_step: currentStep,
+            next_steps: [
+                { tool: 'ocr_approval_step_decide', description: 'Decide on the current approval step' },
+                { tool: 'ocr_workflow_status', description: 'View full workflow status including approvals' },
+            ],
+        }));
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+// =============================================================================
+// TOOL 3.8: ocr_approval_step_decide
+// =============================================================================
+async function handleApprovalStepDecide(params) {
+    try {
+        const input = validateInput(z.object({
+            document_id: z.string().min(1),
+            chain_id: z.string().min(1),
+            decision: ApprovalDecisionSchema,
+            user_id: z.string().min(1),
+            reason: z.string().max(2000).optional(),
+        }), params);
+        if (input.decision === 'rejected' && !input.reason) {
+            throw new Error('Reason is required when rejecting an approval step');
+        }
+        const { db } = requireDatabase();
+        const conn = db.getConnection();
+        // Get the current step for this document+chain
+        const currentStep = getCurrentApprovalStep(conn, input.document_id, input.chain_id);
+        if (!currentStep) {
+            // Check if chain is applied
+            const anySteps = conn.prepare('SELECT id FROM approval_steps WHERE document_id = ? AND chain_id = ? LIMIT 1').get(input.document_id, input.chain_id);
+            if (!anySteps) {
+                throw new Error(`No approval chain applied. Use ocr_approval_chain_apply first to apply chain ${input.chain_id} to document ${input.document_id}`);
+            }
+            throw new Error(`All approval steps for this chain have already been decided. No pending steps remain.`);
+        }
+        const decided = decideApprovalStep(conn, currentStep.id, input.decision, input.user_id, input.reason);
+        // Get updated progress
+        const progress = getApprovalProgress(conn, input.document_id, input.chain_id);
+        const nextSteps = [];
+        if (progress.current_step) {
+            nextSteps.push({
+                tool: 'ocr_approval_step_decide',
+                description: `Decide on next step (${progress.current_step.required_role}, order ${progress.current_step.step_order})`,
+            });
+        }
+        if (progress.is_complete && !progress.is_rejected) {
+            nextSteps.push({ tool: 'ocr_workflow_status', description: 'View final workflow status' });
+        }
+        if (progress.is_rejected) {
+            nextSteps.push({ tool: 'ocr_workflow_status', description: 'View workflow status after rejection' });
+        }
+        if (nextSteps.length === 0) {
+            nextSteps.push({ tool: 'ocr_workflow_status', description: 'View workflow status' });
+        }
+        return formatResponse(successResult({
+            step: decided,
+            progress: {
+                total_steps: progress.total_steps,
+                completed_steps: progress.completed_steps,
+                is_complete: progress.is_complete,
+                is_rejected: progress.is_rejected,
+                current_step: progress.current_step,
+            },
+            next_steps: nextSteps,
+        }));
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+// =============================================================================
+// TOOL DEFINITIONS EXPORT
+// =============================================================================
+export const workflowTools = {
+    ocr_workflow_submit: {
+        description: '[MANAGE] Submit a document for review. Creates a draft state first if no workflow history exists, then transitions to submitted. Optionally assign a reviewer and set a due date.',
+        inputSchema: {
+            document_id: z.string().min(1).describe('Document ID to submit for review'),
+            assigned_to: z.string().min(1).optional().describe('User ID of the reviewer to assign'),
+            due_date: z.string().min(1).optional().describe('Due date for review (ISO 8601 datetime)'),
+            metadata: z.record(z.unknown()).optional().describe('Optional metadata object to attach to the workflow state'),
+        },
+        handler: handleWorkflowSubmit,
+    },
+    ocr_workflow_review: {
+        description: '[MANAGE] Review a document: approve, reject, or request changes. Document must be in "in_review" state. Reason is required for reject or changes_requested decisions.',
+        inputSchema: {
+            document_id: z.string().min(1).describe('Document ID to review'),
+            decision: WorkflowDecisionSchema.describe('Review decision: approved, rejected, or changes_requested'),
+            reason: z.string().max(2000).optional().describe('Reason for the decision (required for reject/changes_requested)'),
+        },
+        handler: handleWorkflowReview,
+    },
+    ocr_workflow_assign: {
+        description: '[MANAGE] Assign or reassign a reviewer to a document. If the document is in "submitted" state, it transitions to "in_review". If already "in_review", updates the assignment.',
+        inputSchema: {
+            document_id: z.string().min(1).describe('Document ID to assign reviewer to'),
+            user_id: z.string().min(1).describe('User ID of the reviewer to assign'),
+            assigned_by: z.string().min(1).optional().describe('User ID of the person making the assignment'),
+        },
+        handler: handleWorkflowAssign,
+    },
+    ocr_workflow_status: {
+        description: '[STATUS] Get the current workflow state and full history for a document. Shows current state, all transitions, and any applied approval chains.',
+        inputSchema: {
+            document_id: z.string().min(1).describe('Document ID to check workflow status for'),
+        },
+        handler: handleWorkflowStatus,
+    },
+    ocr_workflow_queue: {
+        description: '[STATUS] List documents in the workflow queue. Filter by assigned reviewer, state, or due date. Returns paginated results sorted by due date then creation time.',
+        inputSchema: {
+            assigned_to: z.string().min(1).optional().describe('Filter by assigned reviewer user ID'),
+            state: z.string().min(1).optional().describe('Filter by workflow state (e.g., "submitted", "in_review")'),
+            due_before: z.string().min(1).optional().describe('Filter documents due before this ISO 8601 datetime'),
+            limit: z.number().int().min(1).max(200).default(50).describe('Max results (1-200, default 50)'),
+            offset: z.number().int().min(0).default(0).describe('Pagination offset'),
+        },
+        handler: handleWorkflowQueue,
+    },
+    ocr_approval_chain_create: {
+        description: '[MANAGE] Create a reusable approval chain with ordered steps. Each step specifies a required role. Chains can be applied to multiple documents for formal multi-step approval.',
+        inputSchema: {
+            name: z.string().min(1).max(200).describe('Name for the approval chain'),
+            description: z.string().max(1000).optional().describe('Description of the approval chain'),
+            steps: z.array(z.object({
+                role: z.string().min(1).describe('Required role for this step (e.g., "reviewer", "legal", "manager")'),
+                required_approvals: z.number().int().min(1).optional().describe('Number of approvals needed (default 1)'),
+                auto_advance: z.boolean().optional().describe('Auto-advance to next step on approval (default true)'),
+            })).min(1).describe('Ordered list of approval steps'),
+            created_by: z.string().min(1).optional().describe('User ID of the chain creator'),
+        },
+        handler: handleApprovalChainCreate,
+    },
+    ocr_approval_chain_apply: {
+        description: '[MANAGE] Apply an existing approval chain to a document. Creates pending approval steps for each step in the chain. Steps must be decided in order.',
+        inputSchema: {
+            document_id: z.string().min(1).describe('Document ID to apply the approval chain to'),
+            chain_id: z.string().min(1).describe('Approval chain ID to apply'),
+        },
+        handler: handleApprovalChainApply,
+    },
+    ocr_approval_step_decide: {
+        description: '[MANAGE] Decide on the current approval step for a document. Approve to advance to the next step, or reject to stop the chain (remaining steps are skipped). Reason is required for rejection.',
+        inputSchema: {
+            document_id: z.string().min(1).describe('Document ID'),
+            chain_id: z.string().min(1).describe('Approval chain ID'),
+            decision: ApprovalDecisionSchema.describe('Decision: approved or rejected'),
+            user_id: z.string().min(1).describe('User ID making the decision'),
+            reason: z.string().max(2000).optional().describe('Reason for the decision (required for rejection)'),
+        },
+        handler: handleApprovalStepDecide,
+    },
+};
+//# sourceMappingURL=workflow.js.map

package/dist/tools/workflow.js.map

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

package/dist/utils/backoff.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Exponential Backoff with Jitter
+ *
+ * Replaces fixed waits for rate limits with exponential backoff.
+ * Base delay doubles each attempt: 1s, 2s, 4s, 8s, 16s (capped at 30s).
+ * Jitter adds +/-25% randomness to prevent thundering herd.
+ *
+ * CRITICAL: NEVER use console.log() - stdout is JSON-RPC protocol.
+ *
+ * @module utils/backoff
+ */
+export interface BackoffConfig {
+    /** Base delay in milliseconds (default: 1000) */
+    baseDelayMs: number;
+    /** Maximum delay in milliseconds (default: 30000) */
+    maxDelayMs: number;
+    /** Maximum number of retry attempts (default: 3) */
+    maxAttempts: number;
+    /** Jitter fraction +/- (default: 0.25 = +/-25%) */
+    jitterFraction: number;
+}
+/**
+ * Calculate delay for a given attempt (0-indexed) with jitter.
+ *
+ * Formula: min(baseDelay * 2^attempt, maxDelay) +/- jitter
+ *
+ * @param attempt - Zero-indexed attempt number
+ * @param config - Optional partial backoff configuration
+ * @returns Delay in milliseconds (always >= 0)
+ */
+export declare function calculateBackoffDelay(attempt: number, config?: Partial<BackoffConfig>): number;
+/**
+ * Sleep for the backoff duration.
+ *
+ * @param attempt - Zero-indexed attempt number
+ * @param config - Optional partial backoff configuration
+ * @returns Promise that resolves after the delay
+ */
+export declare function backoffSleep(attempt: number, config?: Partial<BackoffConfig>): Promise<void>;
+/**
+ * Execute a function with automatic retry and exponential backoff.
+ *
+ * Retries on errors that pass the shouldRetry predicate, up to maxAttempts.
+ * Non-retryable errors are re-thrown immediately.
+ *
+ * @param fn - Async function to execute
+ * @param shouldRetry - Predicate to determine if an error is retryable
+ * @param config - Optional partial backoff configuration
+ * @returns The result of fn on success
+ * @throws The last error if all attempts fail
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, shouldRetry: (error: unknown) => boolean, config?: Partial<BackoffConfig>): Promise<T>;
+//# sourceMappingURL=backoff.d.ts.map

package/dist/utils/backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../../src/utils/backoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;CACxB;AASD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,MAAM,CAU9F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5F;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,EACxC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CAiBZ"}

package/dist/utils/backoff.js

@@ -0,0 +1,78 @@
+/**
+ * Exponential Backoff with Jitter
+ *
+ * Replaces fixed waits for rate limits with exponential backoff.
+ * Base delay doubles each attempt: 1s, 2s, 4s, 8s, 16s (capped at 30s).
+ * Jitter adds +/-25% randomness to prevent thundering herd.
+ *
+ * CRITICAL: NEVER use console.log() - stdout is JSON-RPC protocol.
+ *
+ * @module utils/backoff
+ */
+const DEFAULT_BACKOFF = {
+    baseDelayMs: 1000,
+    maxDelayMs: 30000,
+    maxAttempts: 3,
+    jitterFraction: 0.25,
+};
+/**
+ * Calculate delay for a given attempt (0-indexed) with jitter.
+ *
+ * Formula: min(baseDelay * 2^attempt, maxDelay) +/- jitter
+ *
+ * @param attempt - Zero-indexed attempt number
+ * @param config - Optional partial backoff configuration
+ * @returns Delay in milliseconds (always >= 0)
+ */
+export function calculateBackoffDelay(attempt, config) {
+    const cfg = { ...DEFAULT_BACKOFF, ...config };
+    const exponentialDelay = cfg.baseDelayMs * Math.pow(2, attempt);
+    const cappedDelay = Math.min(exponentialDelay, cfg.maxDelayMs);
+    // Add jitter: +/-jitterFraction
+    const jitterRange = cappedDelay * cfg.jitterFraction;
+    const jitter = (Math.random() * 2 - 1) * jitterRange;
+    return Math.max(0, Math.round(cappedDelay + jitter));
+}
+/**
+ * Sleep for the backoff duration.
+ *
+ * @param attempt - Zero-indexed attempt number
+ * @param config - Optional partial backoff configuration
+ * @returns Promise that resolves after the delay
+ */
+export function backoffSleep(attempt, config) {
+    const delay = calculateBackoffDelay(attempt, config);
+    console.error(`[Backoff] Attempt ${attempt + 1}: waiting ${delay}ms`);
+    return new Promise((resolve) => setTimeout(resolve, delay));
+}
+/**
+ * Execute a function with automatic retry and exponential backoff.
+ *
+ * Retries on errors that pass the shouldRetry predicate, up to maxAttempts.
+ * Non-retryable errors are re-thrown immediately.
+ *
+ * @param fn - Async function to execute
+ * @param shouldRetry - Predicate to determine if an error is retryable
+ * @param config - Optional partial backoff configuration
+ * @returns The result of fn on success
+ * @throws The last error if all attempts fail
+ */
+export async function withRetry(fn, shouldRetry, config) {
+    const cfg = { ...DEFAULT_BACKOFF, ...config };
+    let lastError;
+    for (let attempt = 0; attempt < cfg.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (!shouldRetry(error))
+                throw error;
+            if (attempt < cfg.maxAttempts - 1) {
+                await backoffSleep(attempt, cfg);
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=backoff.js.map