@llumiverse/core 1.3.0 → 1.4.0-dev.20260629.090753Z

package/lib/http-agent.js

@@ -0,0 +1,141 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { Agent } from 'undici';
+/**
+ * Default HTTP timeouts used by {@link createDriverHttpAgent} when the
+ * caller does not override them. These are deliberately tighter than
+ * Node's undici default (5 minutes for headers and body) so a hung
+ * upstream LLM-provider call surfaces in seconds rather than blocking
+ * the whole request budget.
+ *
+ * Drivers with workloads that have legitimate long pauses (image
+ * generation, tool-using agent streams) should pass higher overrides
+ * via {@link HttpTimeoutOptions} rather than relying on the defaults.
+ */
+export const DEFAULT_DRIVER_HTTP_TIMEOUTS = {
+    headersTimeout: 60_000,
+    bodyTimeout: 60_000,
+    connectTimeout: 10_000,
+    keepAliveTimeout: 30_000,
+};
+const scopedHttpAgent = new AsyncLocalStorage();
+export function resolveDriverHttpTimeouts(opts) {
+    return {
+        headersTimeout: opts?.headersTimeout ?? DEFAULT_DRIVER_HTTP_TIMEOUTS.headersTimeout,
+        bodyTimeout: opts?.bodyTimeout ?? DEFAULT_DRIVER_HTTP_TIMEOUTS.bodyTimeout,
+        connectTimeout: opts?.connectTimeout ?? DEFAULT_DRIVER_HTTP_TIMEOUTS.connectTimeout,
+        keepAliveTimeout: opts?.keepAliveTimeout ?? DEFAULT_DRIVER_HTTP_TIMEOUTS.keepAliveTimeout,
+    };
+}
+export function mergeDriverHttpTimeoutOptions(defaults, override) {
+    if (!override) {
+        return defaults;
+    }
+    return {
+        ...(defaults ?? {}),
+        ...stripUndefinedHttpTimeoutOptions(override),
+    };
+}
+/**
+ * Build an undici `Agent` configured from {@link HttpTimeoutOptions},
+ * falling back to {@link DEFAULT_DRIVER_HTTP_TIMEOUTS} for unset fields.
+ *
+ * The Agent pools sockets — reuse it for the lifetime of the driver
+ * and close it on `destroy()`.
+ *
+ * Node-only. `@llumiverse/drivers` is itself Node-only in practice
+ * because vertexai/bedrock pull `@google-cloud/*` / `@aws-sdk/*`, so
+ * depending on undici from core is acceptable.
+ */
+export function createDriverHttpAgent(opts) {
+    const timeouts = resolveDriverHttpTimeouts(opts);
+    return new Agent({
+        headersTimeout: timeouts.headersTimeout,
+        bodyTimeout: timeouts.bodyTimeout,
+        connectTimeout: timeouts.connectTimeout,
+        keepAliveTimeout: timeouts.keepAliveTimeout,
+    });
+}
+/**
+ * Wrap the global `fetch` so every request routes through the given Agent.
+ * The returned function is type-compatible with global `fetch`, so it
+ * can be passed directly to SDKs that accept a `fetch` option (OpenAI,
+ * Anthropic, `@google/genai`, Bedrock via Smithy, …) or used as a
+ * drop-in replacement for global `fetch` in drivers that make raw HTTP
+ * calls.
+ *
+ * `@vertesia/api-fetch-client` builds requests with `globalThis.Request`,
+ * while the undici package uses its own `Request` class. Calling
+ * `undici.fetch` directly can parse a global Request as `"[object Request]"`.
+ * Use `globalThis.fetch` (undici-backed in Node/Bun) and pass the undici
+ * dispatcher extension through init so the Agent timeout behavior is still
+ * applied without crossing Request/Response implementations.
+ */
+export function createAgentBackedFetch(agent) {
+    return ((input, init) => {
+        const requestInput = typeof Request !== 'undefined' && input instanceof Request
+            ? normalizeRequestInput(input, init)
+            : { input, init };
+        const dispatcher = scopedHttpAgent.getStore() ?? agent;
+        return globalThis.fetch(requestInput.input, {
+            ...(requestInput.init ?? {}),
+            dispatcher,
+        });
+    });
+}
+const NOOP_HTTP_AGENT_SCOPE = {
+    run: (callback) => callback(),
+    close: () => Promise.resolve(),
+};
+export function createDriverHttpAgentScope(defaults, override) {
+    if (!override) {
+        return NOOP_HTTP_AGENT_SCOPE;
+    }
+    const agent = createDriverHttpAgent(mergeDriverHttpTimeoutOptions(defaults, override));
+    return {
+        run: (callback) => scopedHttpAgent.run(agent, callback),
+        close: async () => {
+            await agent.close().catch(() => {
+                /* shutdown best-effort */
+            });
+        },
+    };
+}
+function normalizeRequestInput(request, init) {
+    const overrides = stripUndefinedRequestInit(init);
+    const requestInit = {
+        method: request.method,
+        headers: request.headers,
+        body: request.body,
+        signal: request.signal,
+        cache: request.cache,
+        credentials: request.credentials,
+        integrity: request.integrity,
+        keepalive: request.keepalive,
+        mode: request.mode,
+        redirect: request.redirect,
+        referrer: request.referrer,
+        referrerPolicy: request.referrerPolicy,
+    };
+    if (request.body) {
+        requestInit.duplex = 'half';
+    }
+    return {
+        input: request.url,
+        init: {
+            ...requestInit,
+            ...overrides,
+        },
+    };
+}
+function stripUndefinedRequestInit(init) {
+    if (!init) {
+        return undefined;
+    }
+    const entries = Object.entries(init).filter(([, value]) => value !== undefined);
+    return Object.fromEntries(entries);
+}
+function stripUndefinedHttpTimeoutOptions(opts) {
+    const entries = Object.entries(opts).filter(([, value]) => value !== undefined);
+    return Object.fromEntries(entries);
+}
+//# sourceMappingURL=http-agent.js.map

package/lib/http-agent.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,8 @@
+export * from '@llumiverse/common';
+export * from './conversation-utils.js';
+export type { AbstractDriver, Driver } from './Driver.js';
+export * from './embeddings.js';
+export * from './json.js';
+export * from './logger.js';
+export * from './stream.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1D,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/lib/index.js

@@ -0,0 +1,7 @@
+export * from '@llumiverse/common';
+export * from './conversation-utils.js';
+export * from './embeddings.js';
+export * from './json.js';
+export * from './logger.js';
+export * from './stream.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AAExC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/lib/{types/json.d.ts → json.d.ts}

@@ -1,4 +1,4 @@
-import { JSONValue } from "@llumiverse/common";
+import type { JSONValue } from '@llumiverse/common';
 export declare function extractAndParseJSON(text: string): JSONValue;
 export declare function parseJSON(text: string): JSONValue;
 //# sourceMappingURL=json.d.ts.map

package/lib/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AASpD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAE3D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAajD"}

package/lib/{esm/json.js → json.js}

@@ -1,7 +1,7 @@
 import { jsonrepair } from 'jsonrepair';
 function extractJsonFromText(text) {
-    const start = text.indexOf("{");
-    const end = text.lastIndexOf("}");
+    const start = text.indexOf('{');
+    const end = text.lastIndexOf('}');
     return text.substring(start, end + 1);
 }
 export function extractAndParseJSON(text) {
@@ -17,7 +17,8 @@ export function parseJSON(text) {
         try {
             return JSON.parse(jsonrepair(text));
         }
-        catch (err2) { // throw the original error
+        catch {
+            // throw the original error
             throw err;
         }
     }

package/lib/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,SAAS,mBAAmB,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC5C,OAAO,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IAClC,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACnB,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACpB,uBAAuB;QACvB,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACL,2BAA2B;YAC3B,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;AACL,CAAC"}

package/lib/logger.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from '@llumiverse/common';
+export declare function createLogger(logger: Logger | 'console' | undefined): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAiCjD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,UAQlE"}

package/lib/logger.js

@@ -0,0 +1,42 @@
+// Helper to create logger methods that support both message-only and object-first signatures.
+function createConsoleLoggerMethod(consoleMethod) {
+    return ((objOrMsg, msgOrNever, ...args) => {
+        if (typeof objOrMsg === 'string') {
+            // Message-only: logger.info("message", ...args)
+            consoleMethod(objOrMsg, msgOrNever, ...args);
+        }
+        else if (msgOrNever !== undefined) {
+            // Object-first: logger.info({ obj }, "message", ...args)
+            consoleMethod(msgOrNever, objOrMsg, ...args);
+        }
+        else {
+            // Object-only: logger.info({ obj })
+            consoleMethod(objOrMsg, ...args);
+        }
+    });
+}
+const ConsoleLogger = {
+    debug: createConsoleLoggerMethod(console.debug.bind(console)),
+    info: createConsoleLoggerMethod(console.info.bind(console)),
+    warn: createConsoleLoggerMethod(console.warn.bind(console)),
+    error: createConsoleLoggerMethod(console.error.bind(console)),
+};
+const noop = () => void 0;
+const NoopLogger = {
+    debug: noop,
+    info: noop,
+    warn: noop,
+    error: noop,
+};
+export function createLogger(logger) {
+    if (logger === 'console') {
+        return ConsoleLogger;
+    }
+    else if (logger) {
+        return logger;
+    }
+    else {
+        return NoopLogger;
+    }
+}
+//# sourceMappingURL=logger.js.map

package/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,8FAA8F;AAC9F,SAAS,yBAAyB,CAAC,aAA2C;IAC1E,OAAO,CAAC,CAAC,QAAiB,EAAE,UAAmB,EAAE,GAAG,IAAmC,EAAE,EAAE;QACvF,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC/B,gDAAgD;YAChD,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,yDAAyD;YACzD,aAAa,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACJ,oCAAoC;YACpC,aAAa,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;QACrC,CAAC;IACL,CAAC,CAAmB,CAAC;AACzB,CAAC;AAED,MAAM,aAAa,GAAW;IAC1B,KAAK,EAAE,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,EAAE,yBAAyB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,EAAE,yBAAyB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,KAAK,EAAE,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;CAChE,CAAC;AAEF,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AAC1B,MAAM,UAAU,GAAW;IACvB,KAAK,EAAE,IAAuB;IAC9B,IAAI,EAAE,IAAsB;IAC5B,IAAI,EAAE,IAAsB;IAC5B,KAAK,EAAE,IAAuB;CACjC,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAAsC;IAC/D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,aAAa,CAAC;IACzB,CAAC;SAAM,IAAI,MAAM,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC;IAClB,CAAC;SAAM,CAAC;QACJ,OAAO,UAAU,CAAC;IACtB,CAAC;AACL,CAAC"}

package/lib/resolver.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveField(object: unknown, path: string[]): unknown;
+//# sourceMappingURL=resolver.d.ts.map

package/lib/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AA6BA,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAYrE"}

package/lib/{esm/resolver.js → resolver.js}

@@ -7,22 +7,25 @@
  * @returns the property value
  */
 function _prop(object, name) {
-    if (object === undefined) {
+    if (object === undefined || object === null) {
         return undefined;
     }
     if (Array.isArray(object)) {
         const index = +name;
-        if (isNaN(index)) {
+        if (Number.isNaN(index)) {
             // map array to property
-            return object.map(item => item[name]);
+            return object.map((item) => item && typeof item === 'object' ? item[name] : undefined);
         }
         else {
             return object[index];
         }
     }
-    else {
+    else if (typeof object === 'object') {
         return object[name];
     }
+    else {
+        return undefined;
+    }
 }
 export function resolveField(object, path) {
     let p = object;

package/lib/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,SAAS,KAAK,CAAC,MAAe,EAAE,IAAY;IACxC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC;QACpB,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,wBAAwB;YACxB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACvB,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAgC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CACzF,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAQ,MAAkC,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACJ,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAe,EAAE,IAAc;IACxD,IAAI,CAAC,GAAY,MAAM,CAAC;IACxB,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,CAAC,EAAE,CAAC;YACL,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/lib/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhF;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhF;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBxF"}

package/lib/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAsB;IAC3D,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAsB;IAC3D,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAsB;IAC/D,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;QAE/E,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxB,WAAW,IAAI,UAAU,CAAC,MAAM,CAAC;IACrC,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/lib/{types/validation.d.ts → validation.d.ts}

@@ -1,4 +1,4 @@
-import { CompletionResult, ResultValidationError } from "@llumiverse/common";
+import type { CompletionResult, ResultValidationError } from '@llumiverse/common';
 export declare class ValidationError extends Error implements ResultValidationError {
     code: 'validation_error' | 'json_error';
     constructor(code: 'validation_error' | 'json_error', message: string);

package/lib/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAa,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AA8B7F,qBAAa,eAAgB,SAAQ,KAAM,YAAW,qBAAqB;IAE5D,IAAI,EAAE,kBAAkB,GAAG,YAAY;gBAAvC,IAAI,EAAE,kBAAkB,GAAG,YAAY,EAC9C,OAAO,EAAE,MAAM;CAKtB;AAoBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAoD3F"}

package/lib/validation.js

@@ -0,0 +1,100 @@
+import { Ajv } from 'ajv';
+import addFormats from 'ajv-formats';
+import { extractAndParseJSON } from './json.js';
+import { resolveField } from './resolver.js';
+const ajv = new Ajv({
+    coerceTypes: 'array',
+    allowDate: true,
+    strict: false,
+    useDefaults: true,
+    removeAdditional: 'failing',
+});
+// biome-ignore lint/suspicious/noTsIgnore: ajv-formats default export inconsistently callable under ESM/CJS interop
+// @ts-ignore - ajv-formats default export is not callable under one of the TS configs in this monorepo
+addFormats(ajv);
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function getRequiredFields(schemaField) {
+    if (!schemaField || typeof schemaField !== 'object') {
+        return [];
+    }
+    const required = schemaField.required;
+    return Array.isArray(required) ? required.filter((field) => typeof field === 'string') : [];
+}
+export class ValidationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ValidationError';
+    }
+}
+function parseCompletionAsJson(data) {
+    let lastError;
+    for (const part of data) {
+        if (part.type === 'text') {
+            const text = part.value.trim();
+            try {
+                return extractAndParseJSON(text);
+            }
+            catch (error) {
+                lastError = new ValidationError('json_error', errorMessage(error));
+            }
+        }
+    }
+    if (!lastError) {
+        lastError = new ValidationError('json_error', 'No JSON compatible response found in completion result');
+    }
+    throw lastError;
+}
+export function validateResult(data, schema) {
+    let json;
+    if (Array.isArray(data)) {
+        const jsonResults = data.filter((r) => r.type === 'json');
+        if (jsonResults.length > 0) {
+            json = jsonResults[0].value;
+        }
+        else {
+            try {
+                json = parseCompletionAsJson(data);
+            }
+            catch (error) {
+                throw new ValidationError('json_error', errorMessage(error));
+            }
+        }
+    }
+    else {
+        throw new Error('Data to validate must be an array');
+    }
+    const validate = ajv.compile(schema);
+    const valid = validate(json);
+    if (!valid && validate.errors) {
+        const errors = [];
+        for (const e of validate.errors) {
+            const path = e.instancePath.split('/').slice(1);
+            const value = resolveField(json, path);
+            const schemaPath = e.schemaPath.split('/').slice(1);
+            const schemaFieldFormat = resolveField(schema, schemaPath);
+            const schemaField = resolveField(schema, schemaPath.slice(0, -3));
+            //ignore date if empty or null
+            if (!value &&
+                typeof schemaFieldFormat === 'string' &&
+                ['date', 'date-time'].includes(schemaFieldFormat) &&
+                !getRequiredFields(schemaField).includes(path[path.length - 1])) {
+            }
+            else {
+                errors.push(e);
+            }
+        }
+        //console.log("Errors", errors)
+        if (errors.length > 0) {
+            const errorsMessage = errors
+                .map((e) => `${e.instancePath}: ${e.message}\n${JSON.stringify(e.params)}`)
+                .join(',\n\n');
+            throw new ValidationError('validation_error', errorsMessage);
+        }
+    }
+    return [{ type: 'json', value: json }];
+}
+//# sourceMappingURL=validation.js.map

package/lib/validation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llumiverse/core",
-  "version": "1.3.0",
+  "version": "1.4.0-dev.20260629.090753Z",
   "type": "module",
   "description": "Provide an universal API to LLMs. Support for existing LLMs can be added by writing a driver.",
   "files": [
@@ -27,32 +27,28 @@
     "huggingface",
     "togetherai"
   ],
-  "types": "./lib/types/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "async": [
-        "./lib/types/async.d.ts"
-      ],
-      "formatters": [
-        "./lib/types/formatters/index.d.ts"
-      ]
-    }
-  },
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
   "exports": {
     ".": {
-      "types": "./lib/types/index.d.ts",
-      "import": "./lib/esm/index.js",
-      "require": "./lib/cjs/index.js"
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
     },
     "./async": {
-      "types": "./lib/types/async.d.ts",
-      "import": "./lib/esm/async.js",
-      "require": "./lib/cjs/async.js"
+      "types": "./lib/async.d.ts",
+      "default": "./lib/async.js"
+    },
+    "./driver": {
+      "types": "./lib/Driver.d.ts",
+      "default": "./lib/Driver.js"
     },
     "./formatters": {
-      "types": "./lib/types/formatters/index.d.ts",
-      "import": "./lib/esm/formatters/index.js",
-      "require": "./lib/cjs/formatters/index.js"
+      "types": "./lib/formatters/index.d.ts",
+      "default": "./lib/formatters/index.js"
+    },
+    "./http-agent": {
+      "types": "./lib/http-agent.d.ts",
+      "default": "./lib/http-agent.js"
     }
   },
   "author": "Llumiverse",
@@ -63,30 +59,24 @@
     "url": "git+ssh://git@github.com/vertesia/llumiverse.git"
   },
   "devDependencies": {
-    "@vertesia/api-fetch-client": "^1.2.0",
-    "rimraf": "^6.1.2",
-    "ts-dual-module": "^0.6.3",
-    "typescript": "^6.0.2",
-    "vitest": "^4.0.18"
+    "@vertesia/api-fetch-client": "^1.3.0",
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
   },
   "dependencies": {
-    "@types/node": "^24.1.0",
-    "ajv": "^8.18.0",
+    "@types/node": "^24.13.2",
+    "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
-    "jsonrepair": "^3.13.2",
-    "@llumiverse/common": "1.3.0"
-  },
-  "ts_dual_module": {
-    "outDir": "lib",
-    "exports": {
-      "async": "async.js",
-      "formatters": "formatters/index.js"
-    }
+    "jsonrepair": "^3.14.0",
+    "undici": "^7.27.2",
+    "@llumiverse/common": "1.4.0-dev.20260629.090753Z"
   },
   "scripts": {
     "lint": "biome lint src",
     "test": "vitest run",
-    "build": "pnpm exec tsmod build",
+    "typecheck:test": "tsc -p tsconfig.test.json --noEmit",
+    "build": "pnpm exec rimraf ./lib ./tsconfig.tsbuildinfo && tsc",
     "clean": "rimraf ./lib tsconfig.tsbuildinfo"
   }
 }