@cogitator-ai/core 0.1.0

package/dist/utils/retry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Retry utility with exponential backoff
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Base delay in milliseconds (default: 1000) */
+    baseDelay?: number;
+    /** Maximum delay in milliseconds (default: 30000) */
+    maxDelay?: number;
+    /** Backoff strategy (default: 'exponential') */
+    backoff?: 'exponential' | 'linear' | 'constant';
+    /** Jitter factor 0-1 to randomize delays (default: 0.1) */
+    jitter?: number;
+    /** Custom function to determine if error should be retried */
+    retryIf?: (error: Error, attempt: number) => boolean;
+    /** Called before each retry attempt */
+    onRetry?: (error: Error, attempt: number, delay: number) => void;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * Execute a function with automatic retries on failure
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetchFromAPI(),
+ *   {
+ *     maxRetries: 5,
+ *     baseDelay: 1000,
+ *     backoff: 'exponential',
+ *     onRetry: (error, attempt) => {
+ *       console.log(`Retry ${attempt}: ${error.message}`);
+ *     },
+ *   }
+ * );
+ * ```
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Create a retryable version of a function
+ *
+ * @example
+ * ```typescript
+ * const retryableFetch = retryable(fetchFromAPI, { maxRetries: 3 });
+ * const result = await retryableFetch(url);
+ * ```
+ */
+export declare function retryable<T extends unknown[], R>(fn: (...args: T) => Promise<R>, options?: RetryOptions): (...args: T) => Promise<R>;
+//# 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":"AAAA;;GAEG;AASH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;IAChD,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,uCAAuC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,oCAAoC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAqED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAuCZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC9C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE,YAAiB,GACzB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAE5B"}

package/dist/utils/retry.js

@@ -0,0 +1,115 @@
+/**
+ * Retry utility with exponential backoff
+ */
+import { CogitatorError, ErrorCode, isRetryableError, getRetryDelay, } from '@cogitator-ai/types';
+const DEFAULT_OPTIONS = {
+    maxRetries: 3,
+    baseDelay: 1000,
+    maxDelay: 30000,
+    backoff: 'exponential',
+    jitter: 0.1,
+};
+/**
+ * Calculate delay for a given attempt
+ */
+function calculateDelay(attempt, baseDelay, maxDelay, backoff, jitter) {
+    let delay;
+    switch (backoff) {
+        case 'exponential':
+            delay = baseDelay * Math.pow(2, attempt - 1);
+            break;
+        case 'linear':
+            delay = baseDelay * attempt;
+            break;
+        case 'constant':
+            delay = baseDelay;
+            break;
+    }
+    delay = Math.min(delay, maxDelay);
+    if (jitter > 0) {
+        const jitterAmount = delay * jitter;
+        delay = delay + (Math.random() * 2 - 1) * jitterAmount;
+    }
+    return Math.floor(delay);
+}
+/**
+ * Sleep for a given duration with optional abort signal
+ */
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new CogitatorError({
+                message: 'Retry aborted',
+                code: ErrorCode.INTERNAL_ERROR,
+            }));
+            return;
+        }
+        const timeout = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(timeout);
+            reject(new CogitatorError({
+                message: 'Retry aborted',
+                code: ErrorCode.INTERNAL_ERROR,
+            }));
+        });
+    });
+}
+/**
+ * Execute a function with automatic retries on failure
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetchFromAPI(),
+ *   {
+ *     maxRetries: 5,
+ *     baseDelay: 1000,
+ *     backoff: 'exponential',
+ *     onRetry: (error, attempt) => {
+ *       console.log(`Retry ${attempt}: ${error.message}`);
+ *     },
+ *   }
+ * );
+ * ```
+ */
+export async function withRetry(fn, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    let lastError;
+    for (let attempt = 1; attempt <= opts.maxRetries + 1; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            const isLastAttempt = attempt > opts.maxRetries;
+            const shouldRetry = opts.retryIf
+                ? opts.retryIf(lastError, attempt)
+                : isRetryableError(lastError);
+            if (isLastAttempt || !shouldRetry) {
+                throw lastError;
+            }
+            const errorDelay = getRetryDelay(lastError, 0);
+            const calculatedDelay = calculateDelay(attempt, opts.baseDelay, opts.maxDelay, opts.backoff, opts.jitter);
+            const delay = errorDelay > 0 ? errorDelay : calculatedDelay;
+            opts.onRetry?.(lastError, attempt, delay);
+            await sleep(delay, opts.signal);
+        }
+    }
+    throw lastError ?? new CogitatorError({
+        message: 'Retry exhausted',
+        code: ErrorCode.INTERNAL_ERROR,
+    });
+}
+/**
+ * Create a retryable version of a function
+ *
+ * @example
+ * ```typescript
+ * const retryableFetch = retryable(fetchFromAPI, { maxRetries: 3 });
+ * const result = await retryableFetch(url);
+ * ```
+ */
+export function retryable(fn, options = {}) {
+    return (...args) => withRetry(() => fn(...args), options);
+}
+//# 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":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAqB7B,MAAM,eAAe,GAAmE;IACtF,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,aAAa;IACtB,MAAM,EAAE,GAAG;CACZ,CAAC;AAEF;;GAEG;AACH,SAAS,cAAc,CACrB,OAAe,EACf,SAAiB,EACjB,QAAgB,EAChB,OAA8C,EAC9C,MAAc;IAEd,IAAI,KAAa,CAAC;IAElB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,aAAa;YAChB,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YAC7C,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC;YAC5B,MAAM;QACR,KAAK,UAAU;YACb,KAAK,GAAG,SAAS,CAAC;YAClB,MAAM;IACV,CAAC;IAED,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAElC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,CAAC;QACpC,KAAK,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC;IACzD,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,cAAc,CAAC;gBACxB,OAAO,EAAE,eAAe;gBACxB,IAAI,EAAE,SAAS,CAAC,cAAc;aAC/B,CAAC,CAAC,CAAC;YACJ,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAExC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACrC,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,cAAc,CAAC;gBACxB,OAAO,EAAE,eAAe;gBACxB,IAAI,EAAE,SAAS,CAAC,cAAc;aAC/B,CAAC,CAAC,CAAC;QACN,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAwB,EAAE;IAE1B,MAAM,IAAI,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IAChD,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAChE,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAEtE,MAAM,aAAa,GAAG,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC;YAChD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO;gBAC9B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;gBAClC,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAEhC,IAAI,aAAa,IAAI,CAAC,WAAW,EAAE,CAAC;gBAClC,MAAM,SAAS,CAAC;YAClB,CAAC;YAED,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,eAAe,GAAG,cAAc,CACpC,OAAO,EACP,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,MAAM,CACZ,CAAC;YACF,MAAM,KAAK,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC;YAE5D,IAAI,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YAE1C,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,MAAM,SAAS,IAAI,IAAI,cAAc,CAAC;QACpC,OAAO,EAAE,iBAAiB;QAC1B,IAAI,EAAE,SAAS,CAAC,cAAc;KAC/B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CACvB,EAA8B,EAC9B,UAAwB,EAAE;IAE1B,OAAO,CAAC,GAAG,IAAO,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@cogitator-ai/core",
+  "version": "0.1.0",
+  "description": "Core runtime for Cogitator AI agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^3.22.4",
+    "zod-to-json-schema": "^3.22.4",
+    "openai": "^4.24.0",
+    "@anthropic-ai/sdk": "^0.39.0",
+    "nanoid": "^5.0.4",
+    "@cogitator-ai/types": "0.1.0",
+    "@cogitator-ai/memory": "0.1.0",
+    "@cogitator-ai/models": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "@cogitator-ai/sandbox": "0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@cogitator-ai/sandbox": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eL1fe/cogitator.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}