@agtlantis/core 0.5.0 → 0.5.1

package/dist/validation/types.d.ts

@@ -0,0 +1,49 @@
+export interface ValidationResult {
+    valid: boolean;
+    reason?: string;
+}
+export interface ValidationAttempt<TResult> extends ValidationResult {
+    result: TResult;
+    attempt: number;
+}
+export interface ReadonlyValidationHistory<TResult> {
+    /** 1-based attempt number for the next attempt. */
+    readonly nextAttempt: number;
+    /** Last validation attempt, or undefined if no attempts yet. */
+    readonly last: ValidationAttempt<TResult> | undefined;
+    /** All validation attempts as a readonly array. */
+    readonly all: readonly ValidationAttempt<TResult>[];
+    /** Reasons from all failed attempts. */
+    readonly failureReasons: string[];
+    /** True if at least one previous attempt exists. */
+    readonly isRetry: boolean;
+}
+export interface ValidationOptions<TResult> {
+    /**
+     * Validation function that checks the result.
+     * Can access history to compare with previous attempts.
+     */
+    validate: (result: TResult, history: ReadonlyValidationHistory<TResult>) => ValidationResult | Promise<ValidationResult>;
+    /**
+     * Maximum number of attempts before throwing ValidationExhaustedError.
+     * @default 3
+     * @minimum 1
+     */
+    maxAttempts?: number;
+    /**
+     * AbortSignal for cancellation support.
+     * When aborted, throws the abort reason before the next attempt.
+     */
+    signal?: AbortSignal;
+    /**
+     * Delay between retry attempts in milliseconds.
+     * Only applied when there will be another attempt after a failure.
+     */
+    retryDelay?: number;
+    /**
+     * Callback invoked after each attempt (success or failure).
+     * Useful for logging or progress tracking.
+     */
+    onAttempt?: (attempt: ValidationAttempt<TResult>) => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/validation/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB,CAAC,OAAO,CAAE,SAAQ,gBAAgB;IAClE,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB,CAAC,OAAO;IAChD,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAEtD,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;IAEpD,wCAAwC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAElC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB,CAAC,OAAO;IACxC;;;OAGG;IACH,QAAQ,EAAE,CACR,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC,KACxC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAElD;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CAC3D"}

package/dist/validation/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/validation/types.js.map

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

package/dist/validation/validation-history.d.ts

@@ -0,0 +1,12 @@
+import type { ValidationResult, ValidationAttempt, ReadonlyValidationHistory } from './types.js';
+export declare class ValidationHistory<TResult> implements ReadonlyValidationHistory<TResult> {
+    private attempts;
+    get nextAttempt(): number;
+    get last(): ValidationAttempt<TResult> | undefined;
+    get all(): readonly ValidationAttempt<TResult>[];
+    get failureReasons(): string[];
+    get isRetry(): boolean;
+    /** Internal use only - not exposed via ReadonlyValidationHistory. */
+    add(result: TResult, validation: ValidationResult): void;
+}
+//# sourceMappingURL=validation-history.d.ts.map

package/dist/validation/validation-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-history.d.ts","sourceRoot":"","sources":["../../src/validation/validation-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAiB,CAAC,OAAO,CACpC,YAAW,yBAAyB,CAAC,OAAO,CAAC;IAE7C,OAAO,CAAC,QAAQ,CAAoC;IAEpD,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,IAAI,IAAI,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS,CAEjD;IAED,IAAI,GAAG,IAAI,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAE/C;IAED,IAAI,cAAc,IAAI,MAAM,EAAE,CAI7B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,qEAAqE;IACrE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAMvD;CACF"}

package/dist/validation/validation-history.js

@@ -0,0 +1,29 @@
+export class ValidationHistory {
+    attempts = [];
+    get nextAttempt() {
+        return this.attempts.length + 1;
+    }
+    get last() {
+        return this.attempts.at(-1);
+    }
+    get all() {
+        return this.attempts;
+    }
+    get failureReasons() {
+        return this.attempts
+            .filter((a) => !a.valid && a.reason)
+            .map((a) => a.reason);
+    }
+    get isRetry() {
+        return this.attempts.length > 0;
+    }
+    /** Internal use only - not exposed via ReadonlyValidationHistory. */
+    add(result, validation) {
+        this.attempts.push({
+            result,
+            ...validation,
+            attempt: this.attempts.length + 1,
+        });
+    }
+}
+//# sourceMappingURL=validation-history.js.map

package/dist/validation/validation-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-history.js","sourceRoot":"","sources":["../../src/validation/validation-history.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,iBAAiB;IAGpB,QAAQ,GAAiC,EAAE,CAAC;IAEpD,IAAI,WAAW,GAAW;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAAA,CACjC;IAED,IAAI,IAAI,GAA2C;QACjD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAAA,CAC7B;IAED,IAAI,GAAG,GAA0C;QAC/C,OAAO,IAAI,CAAC,QAAQ,CAAC;IAAA,CACtB;IAED,IAAI,cAAc,GAAa;QAC7B,OAAO,IAAI,CAAC,QAAQ;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;aACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAO,CAAC,CAAC;IAAA,CAC1B;IAED,IAAI,OAAO,GAAY;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAAA,CACjC;IAED,qEAAqE;IACrE,GAAG,CAAC,MAAe,EAAE,UAA4B,EAAQ;QACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjB,MAAM;YACN,GAAG,UAAU;YACb,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;SAClC,CAAC,CAAC;IAAA,CACJ;CACF"}

package/dist/validation/with-validation.d.ts

@@ -0,0 +1,38 @@
+import type { ReadonlyValidationHistory, ValidationOptions } from './types.js';
+/**
+ * Wraps an async operation with validation and retry logic.
+ *
+ * Executes the function and validates the result. If validation fails,
+ * retries up to maxAttempts times, passing the history to the execute
+ * function so it can adjust its approach based on previous failures.
+ *
+ * @param execute - Function to execute. Receives history for retry context.
+ * @param options - Validation options including the validate function.
+ * @returns The first result that passes validation.
+ * @throws {ValidationExhaustedError} If all attempts fail validation.
+ *
+ * @example
+ * ```typescript
+ * const result = await withValidation(
+ *   (history) => session.generateText({
+ *     messages: [
+ *       { role: 'user', content: prompt },
+ *       ...(history.isRetry ? [{
+ *         role: 'user' as const,
+ *         content: `Fix: ${history.last!.reason}`,
+ *       }] : []),
+ *     ],
+ *     schema,
+ *   }),
+ *   {
+ *     validate: (result) => ({
+ *       valid: result.confidence > 0.8,
+ *       reason: `Confidence ${result.confidence} below 0.8`,
+ *     }),
+ *     maxAttempts: 3,
+ *   }
+ * );
+ * ```
+ */
+export declare function withValidation<TResult>(execute: (history: ReadonlyValidationHistory<NoInfer<TResult>>) => Promise<TResult>, options: ValidationOptions<NoInfer<TResult>>): Promise<TResult>;
+//# sourceMappingURL=with-validation.d.ts.map

package/dist/validation/with-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-validation.d.ts","sourceRoot":"","sources":["../../src/validation/with-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAI/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAC1C,OAAO,EAAE,CAAC,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,EACnF,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAC3C,OAAO,CAAC,OAAO,CAAC,CA4BlB"}

package/dist/validation/with-validation.js

@@ -0,0 +1,58 @@
+import { ValidationHistory } from './validation-history.js';
+import { ValidationExhaustedError } from './errors.js';
+/**
+ * Wraps an async operation with validation and retry logic.
+ *
+ * Executes the function and validates the result. If validation fails,
+ * retries up to maxAttempts times, passing the history to the execute
+ * function so it can adjust its approach based on previous failures.
+ *
+ * @param execute - Function to execute. Receives history for retry context.
+ * @param options - Validation options including the validate function.
+ * @returns The first result that passes validation.
+ * @throws {ValidationExhaustedError} If all attempts fail validation.
+ *
+ * @example
+ * ```typescript
+ * const result = await withValidation(
+ *   (history) => session.generateText({
+ *     messages: [
+ *       { role: 'user', content: prompt },
+ *       ...(history.isRetry ? [{
+ *         role: 'user' as const,
+ *         content: `Fix: ${history.last!.reason}`,
+ *       }] : []),
+ *     ],
+ *     schema,
+ *   }),
+ *   {
+ *     validate: (result) => ({
+ *       valid: result.confidence > 0.8,
+ *       reason: `Confidence ${result.confidence} below 0.8`,
+ *     }),
+ *     maxAttempts: 3,
+ *   }
+ * );
+ * ```
+ */
+export async function withValidation(execute, options) {
+    const { validate, maxAttempts: rawMax, signal, retryDelay, onAttempt } = options;
+    const maxAttempts = Math.max(1, rawMax ?? 3);
+    const history = new ValidationHistory();
+    while (history.nextAttempt <= maxAttempts) {
+        signal?.throwIfAborted();
+        const result = await execute(history);
+        const validation = await validate(result, history);
+        history.add(result, validation);
+        onAttempt?.(history.last);
+        if (validation.valid) {
+            return result;
+        }
+        const hasMoreAttempts = history.nextAttempt <= maxAttempts;
+        if (retryDelay && hasMoreAttempts) {
+            await new Promise((resolve) => setTimeout(resolve, retryDelay));
+        }
+    }
+    throw new ValidationExhaustedError(`Validation failed after ${history.all.length} attempts`, history);
+}
+//# sourceMappingURL=with-validation.js.map

package/dist/validation/with-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-validation.js","sourceRoot":"","sources":["../../src/validation/with-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAmF,EACnF,OAA4C,EAC1B;IAClB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACjF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAW,CAAC;IAEjD,OAAO,OAAO,CAAC,WAAW,IAAI,WAAW,EAAE,CAAC;QAC1C,MAAM,EAAE,cAAc,EAAE,CAAC;QAEzB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAEhC,SAAS,EAAE,CAAC,OAAO,CAAC,IAAK,CAAC,CAAC;QAE3B,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC;QAC3D,IAAI,UAAU,IAAI,eAAe,EAAE,CAAC;YAClC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,MAAM,IAAI,wBAAwB,CAChC,2BAA2B,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,EACxD,OAAO,CACR,CAAC;AAAA,CACH"}

package/package.json

@@ -1,80 +1,76 @@
 {
-    "name": "@agtlantis/core",
-    "version": "0.5.0",
-    "description": "A framework for building Agents and Pipelines consistently on top of AI SDK",
-    "type": "module",
-    "main": "./dist/index.cjs",
-    "module": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js",
-            "require": "./dist/index.cjs"
-        },
-        "./testing": {
-            "types": "./dist/testing/index.d.ts",
-            "import": "./dist/testing/index.js",
-            "require": "./dist/testing/index.cjs"
-        }
+  "name": "@agtlantis/core",
+  "version": "0.5.1",
+  "description": "A framework for building Agents and Pipelines consistently on top of AI SDK",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
-    "files": [
-        "dist",
-        "README.md"
-    ],
-    "scripts": {
-        "build": "rm -rf dist && tsup",
-        "test": "vitest run src/",
-        "test:unit": "vitest run src/",
-        "test:e2e": "REAL_AI_ENABLED=true vitest run e2e/",
-        "test:watch": "vitest",
-        "typecheck": "tsc --noEmit"
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "handlebars": "^4.7.8",
+    "yaml": "^2.8.2",
+    "zod-to-json-schema": "^3.25.1"
+  },
+  "peerDependencies": {
+    "@ai-sdk/google": "^3.0.0",
+    "@ai-sdk/openai": "^3.0.0",
+    "@google/genai": "^1.0.0",
+    "ai": "^6.0.0",
+    "zod": "^3.23.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/google": {
+      "optional": true
     },
-    "dependencies": {
-        "handlebars": "^4.7.8",
-        "yaml": "^2.8.2",
-        "zod-to-json-schema": "^3.25.1"
+    "@ai-sdk/openai": {
+      "optional": true
     },
-    "peerDependencies": {
-        "@ai-sdk/google": "^3.0.0",
-        "@ai-sdk/openai": "^3.0.0",
-        "@google/genai": "^1.0.0",
-        "ai": "^6.0.0",
-        "zod": "^3.23.0 || ^4.0.0"
-    },
-    "peerDependenciesMeta": {
-        "@ai-sdk/google": {
-            "optional": true
-        },
-        "@ai-sdk/openai": {
-            "optional": true
-        },
-        "@google/genai": {
-            "optional": true
-        }
-    },
-    "devDependencies": {
-        "@ai-sdk/google": "^3.0.10",
-        "@ai-sdk/openai": "^3.0.12",
-        "@google/genai": "^1.37.0",
-        "ai": "^6.0.39",
-        "dotenv": "^17.2.3",
-        "tsup": "^8.5.1",
-        "typescript": "^5.9.3",
-        "vitest": "^4.0.17",
-        "zod": "^4.3.5"
-    },
-    "engines": {
-        "node": ">=18.0.0"
-    },
-    "publishConfig": {
-        "access": "public"
-    },
-    "keywords": [
-        "ai",
-        "agent",
-        "llm",
-        "framework"
-    ],
-    "license": "MIT"
-}
+    "@google/genai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@ai-sdk/google": "^3.0.10",
+    "@ai-sdk/openai": "^3.0.12",
+    "@google/genai": "^1.37.0",
+    "ai": "^6.0.39",
+    "dotenv": "^17.2.3",
+    "@typescript/native-preview": "^7.0.0-dev",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17",
+    "zod": "^4.3.5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "llm",
+    "framework"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "rm -rf dist && tsgo -p tsconfig.build.json",
+    "test": "vitest run src/",
+    "test:unit": "vitest run src/",
+    "test:e2e": "REAL_AI_ENABLED=true vitest run e2e/",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}