hackwriter 0.0.7 → 0.0.9

package/dist/utils/RateLimiter.js

@@ -0,0 +1,62 @@
+import { Logger } from './Logger.js';
+/**
+ * Rate limiter using sliding window algorithm
+ * Prevents excessive API calls within a time window
+ */
+export class RateLimiter {
+    maxRequests;
+    windowMs;
+    requests = [];
+    /**
+     * @param maxRequests - Maximum number of requests allowed
+     * @param windowMs - Time window in milliseconds
+     */
+    constructor(maxRequests, windowMs) {
+        this.maxRequests = maxRequests;
+        this.windowMs = windowMs;
+    }
+    /**
+     * Acquire permission to make a request
+     * Will wait if rate limit is exceeded
+     */
+    async acquire() {
+        const now = Date.now();
+        // Remove requests outside the current window
+        this.requests = this.requests.filter(t => now - t < this.windowMs);
+        if (this.requests.length >= this.maxRequests) {
+            const oldestRequest = this.requests[0];
+            const waitTime = this.windowMs - (now - oldestRequest);
+            Logger.debug('RateLimiter', `Rate limit reached, waiting ${waitTime}ms`, { maxRequests: this.maxRequests, windowMs: this.windowMs });
+            await new Promise(resolve => setTimeout(resolve, waitTime));
+            return this.acquire(); // Retry after waiting
+        }
+        this.requests.push(now);
+    }
+    /**
+     * Check if a request can be made without waiting
+     */
+    canAcquire() {
+        const now = Date.now();
+        this.requests = this.requests.filter(t => now - t < this.windowMs);
+        return this.requests.length < this.maxRequests;
+    }
+    /**
+     * Get current usage statistics
+     */
+    getStats() {
+        const now = Date.now();
+        this.requests = this.requests.filter(t => now - t < this.windowMs);
+        return {
+            current: this.requests.length,
+            max: this.maxRequests,
+            windowMs: this.windowMs,
+        };
+    }
+    /**
+     * Reset the rate limiter
+     */
+    reset() {
+        this.requests = [];
+    }
+}
+//# sourceMappingURL=RateLimiter.js.map

package/dist/utils/RateLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.js","sourceRoot":"","sources":["../../src/utils/RateLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;GAGG;AACH,MAAM,OAAO,WAAW;IAQZ;IACA;IARF,QAAQ,GAAa,EAAE,CAAC;IAEhC;;;OAGG;IACH,YACU,WAAmB,EACnB,QAAgB;QADhB,gBAAW,GAAX,WAAW,CAAQ;QACnB,aAAQ,GAAR,QAAQ,CAAQ;IACvB,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,6CAA6C;QAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEnE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,GAAG,aAAa,CAAC,CAAC;YAEvD,MAAM,CAAC,KAAK,CACV,aAAa,EACb,+BAA+B,QAAQ,IAAI,EAC3C,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAC3D,CAAC;YAEF,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,sBAAsB;QAC/C,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEnE,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;YAC7B,GAAG,EAAE,IAAI,CAAC,WAAW;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,55 @@
+export interface RetryOptions {
+    /**
+     * Maximum number of retry attempts (default: 3)
+     */
+    maxRetries?: number;
+    /**
+     * Initial delay in milliseconds (default: 1000)
+     */
+    delayMs?: number;
+    /**
+     * Whether to use exponential backoff (default: true)
+     */
+    backoff?: boolean;
+    /**
+     * Maximum delay in milliseconds for exponential backoff (default: 30000)
+     */
+    maxDelayMs?: number;
+    /**
+     * Function to determine if error is retryable (default: all errors are retryable)
+     */
+    shouldRetry?: (error: unknown) => boolean;
+    /**
+     * Callback called before each retry
+     */
+    onRetry?: (error: unknown, attempt: number) => void;
+}
+/**
+ * Execute a function with automatic retry on failure
+ *
+ * @param fn - The async function to execute
+ * @param options - Retry configuration options
+ * @returns Promise resolving to the function result
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetch('https://api.example.com/data'),
+ *   { maxRetries: 3, backoff: true }
+ * );
+ * ```
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Check if an error is a network error that should be retried
+ */
+export declare function isNetworkError(error: unknown): boolean;
+/**
+ * Check if an HTTP status code is retryable
+ */
+export declare function isRetryableStatusCode(status: number): boolean;
+/**
+ * Create a retry predicate for HTTP errors
+ */
+export declare function shouldRetryHttpError(error: unknown): boolean;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAE1C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAqDZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAS7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgB5D"}

package/dist/utils/retry.js

@@ -0,0 +1,97 @@
+import { Logger } from './Logger.js';
+/**
+ * Execute a function with automatic retry on failure
+ *
+ * @param fn - The async function to execute
+ * @param options - Retry configuration options
+ * @returns Promise resolving to the function result
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetch('https://api.example.com/data'),
+ *   { maxRetries: 3, backoff: true }
+ * );
+ * ```
+ */
+export async function withRetry(fn, options = {}) {
+    const { maxRetries = 3, delayMs = 1000, backoff = true, maxDelayMs = 30000, shouldRetry = () => true, onRetry, } = options;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Check if we should retry this error
+            if (!shouldRetry(error)) {
+                Logger.debug('Retry', 'Error is not retryable, throwing immediately');
+                throw error;
+            }
+            // If this was the last attempt, throw the error
+            if (attempt === maxRetries) {
+                Logger.debug('Retry', `Max retries (${maxRetries}) reached, throwing error`);
+                throw error;
+            }
+            // Calculate delay with exponential backoff
+            const delay = backoff
+                ? Math.min(delayMs * Math.pow(2, attempt), maxDelayMs)
+                : delayMs;
+            Logger.debug('Retry', `Attempt ${attempt + 1}/${maxRetries} failed, retrying in ${delay}ms`, { error: error instanceof Error ? error.message : String(error) });
+            // Call onRetry callback if provided
+            if (onRetry) {
+                onRetry(error, attempt + 1);
+            }
+            // Wait before retrying
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+    }
+    // This should never be reached, but TypeScript needs it
+    throw lastError;
+}
+/**
+ * Check if an error is a network error that should be retried
+ */
+export function isNetworkError(error) {
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        return (message.includes('network') ||
+            message.includes('timeout') ||
+            message.includes('econnrefused') ||
+            message.includes('enotfound') ||
+            message.includes('etimedout'));
+    }
+    return false;
+}
+/**
+ * Check if an HTTP status code is retryable
+ */
+export function isRetryableStatusCode(status) {
+    // Retry on:
+    // - 408 Request Timeout
+    // - 429 Too Many Requests
+    // - 500 Internal Server Error
+    // - 502 Bad Gateway
+    // - 503 Service Unavailable
+    // - 504 Gateway Timeout
+    return [408, 429, 500, 502, 503, 504].includes(status);
+}
+/**
+ * Create a retry predicate for HTTP errors
+ */
+export function shouldRetryHttpError(error) {
+    // Check for network errors
+    if (isNetworkError(error)) {
+        return true;
+    }
+    // Check for HTTP status codes
+    if (error && typeof error === 'object' && 'response' in error) {
+        const response = error.response;
+        if (response?.status) {
+            return isRetryableStatusCode(response.status);
+        }
+    }
+    // Don't retry by default for unknown errors
+    return false;
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hackwriter",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "Writing agent for HackMD",
   "type": "module",
   "main": "dist/cli.js",
@@ -32,6 +32,7 @@
     "@ai-sdk/openai": "^3.0.12",
     "@hackmd/api": "^2.5.0",
     "@inquirer/prompts": "^8.0.1",
+    "@modelcontextprotocol/sdk": "^1.25.3",
     "ai": "^6.0.39",
     "chalk": "^5.6.2",
     "commander": "^14.0.2",