@0xmaxma/claude-gateway 2.0.10 → 2.0.11

package/dist/jev/computer-inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computer-inputs.d.ts","sourceRoot":"","sources":["../../src/jev/computer-inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,eAAO,MAAM,cAAc;;;;;;mBAAuN,CAAC;AACnP,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAmkB,CAAC"}

package/dist/jev/computer-inputs.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPUTER_INPUTS_SCHEMA = exports.ComputerInputs = void 0;
+const zod_1 = require("zod");
+exports.ComputerInputs = zod_1.z.array(zod_1.z.object({ application: zod_1.z.string().min(1).max(200), label: zod_1.z.string().min(1).max(500), text: zod_1.z.string().max(2000), role: zod_1.z.string().max(100).optional(), windowTitle: zod_1.z.string().max(500).optional() }).strict()).max(30);
+exports.COMPUTER_INPUTS_SCHEMA = { type: 'array', maxItems: 30, description: 'Computer tasks only. Prepare literal field values from the user request so the loop need not infer them again. Match application bundle ID and field label from evidence; do not invent personal facts. Resubmit the complete list on a goal update.', items: { type: 'object', additionalProperties: false, required: ['application', 'label', 'text'], properties: { application: { type: 'string', maxLength: 200 }, label: { type: 'string', maxLength: 500 }, text: { type: 'string', maxLength: 2000 }, role: { type: 'string', maxLength: 100 }, windowTitle: { type: 'string', maxLength: 500 } } } };
+//# sourceMappingURL=computer-inputs.js.map

package/dist/jev/computer-inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computer-inputs.js","sourceRoot":"","sources":["../../src/jev/computer-inputs.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AACT,QAAA,cAAc,GAAC,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC,EAAC,WAAW,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAC,KAAK,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAC,IAAI,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAC,IAAI,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAC,WAAW,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACtO,QAAA,sBAAsB,GAAC,EAAC,IAAI,EAAC,OAAO,EAAC,QAAQ,EAAC,EAAE,EAAC,WAAW,EAAC,sPAAsP,EAAC,KAAK,EAAC,EAAC,IAAI,EAAC,QAAQ,EAAC,oBAAoB,EAAC,KAAK,EAAC,QAAQ,EAAC,CAAC,aAAa,EAAC,OAAO,EAAC,MAAM,CAAC,EAAC,UAAU,EAAC,EAAC,WAAW,EAAC,EAAC,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,GAAG,EAAC,EAAC,KAAK,EAAC,EAAC,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,GAAG,EAAC,EAAC,IAAI,EAAC,EAAC,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,IAAI,EAAC,EAAC,IAAI,EAAC,EAAC,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,GAAG,EAAC,EAAC,WAAW,EAAC,EAAC,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,GAAG,EAAC,EAAC,EAAC,EAAC,CAAC"}

package/dist/jev/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './validation';
+export * from './service';
+export * from './browser-contract';
+export { BrowserConnectorRegistry, validateBrowserIntegration } from './browser-connector';
+//# sourceMappingURL=index.d.ts.map

package/dist/jev/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jev/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/jev/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBrowserIntegration = exports.BrowserConnectorRegistry = void 0;
+__exportStar(require("./types"), exports);
+__exportStar(require("./validation"), exports);
+__exportStar(require("./service"), exports);
+__exportStar(require("./browser-contract"), exports);
+var browser_connector_1 = require("./browser-connector");
+Object.defineProperty(exports, "BrowserConnectorRegistry", { enumerable: true, get: function () { return browser_connector_1.BrowserConnectorRegistry; } });
+Object.defineProperty(exports, "validateBrowserIntegration", { enumerable: true, get: function () { return browser_connector_1.validateBrowserIntegration; } });
+//# sourceMappingURL=index.js.map

package/dist/jev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jev/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,+CAA6B;AAC7B,4CAA0B;AAC1B,qDAAmC;AACnC,yDAA2F;AAAlF,6HAAA,wBAAwB,OAAA;AAAE,+HAAA,0BAA0B,OAAA"}

package/dist/jev/relay-grants.d.ts

@@ -0,0 +1,9 @@
+/** Most bytes a relay grant list may take; larger replies are rejected unread. */
+export declare const RELAY_GRANTS_MAX_BYTES = 262144;
+/**
+ * A relay's grant list, read with a byte cap while streaming (never buffered
+ * whole first) and parsed without throwing raw SyntaxErrors. Any malformed
+ * reply becomes the caller's own discovery code.
+ */
+export declare function readRelayGrants(response: Response, invalid: string): Promise<any[]>;
+//# sourceMappingURL=relay-grants.d.ts.map

package/dist/jev/relay-grants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-grants.d.ts","sourceRoot":"","sources":["../../src/jev/relay-grants.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAC7C;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAoBzF"}

package/dist/jev/relay-grants.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RELAY_GRANTS_MAX_BYTES = void 0;
+exports.readRelayGrants = readRelayGrants;
+/** Most bytes a relay grant list may take; larger replies are rejected unread. */
+exports.RELAY_GRANTS_MAX_BYTES = 262144;
+/**
+ * A relay's grant list, read with a byte cap while streaming (never buffered
+ * whole first) and parsed without throwing raw SyntaxErrors. Any malformed
+ * reply becomes the caller's own discovery code.
+ */
+async function readRelayGrants(response, invalid) {
+    const declared = Number(response.headers.get('content-length'));
+    if (Number.isFinite(declared) && declared > exports.RELAY_GRANTS_MAX_BYTES) {
+        void response.body?.cancel().catch(() => undefined);
+        throw Error(invalid);
+    }
+    const reader = response.body?.getReader();
+    if (!reader)
+        throw Error(invalid);
+    const chunks = [];
+    let bytes = 0;
+    try {
+        for (;;) {
+            const chunk = await reader.read();
+            if (chunk.done)
+                break;
+            bytes += chunk.value.length;
+            if (bytes > exports.RELAY_GRANTS_MAX_BYTES)
+                throw Error(invalid);
+            chunks.push(chunk.value);
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+    }
+    let body;
+    try {
+        body = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    }
+    catch {
+        throw Error(invalid);
+    }
+    if (!Array.isArray(body?.grants))
+        throw Error(invalid);
+    return body.grants;
+}
+//# sourceMappingURL=relay-grants.js.map

package/dist/jev/relay-grants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-grants.js","sourceRoot":"","sources":["../../src/jev/relay-grants.ts"],"names":[],"mappings":";;;AAOA,0CAoBC;AA3BD,kFAAkF;AACrE,QAAA,sBAAsB,GAAG,MAAM,CAAC;AAC7C;;;;GAIG;AACI,KAAK,UAAU,eAAe,CAAC,QAAkB,EAAE,OAAe;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,8BAAsB,EAAE,CAAC;QAAC,KAAK,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAAC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IAClJ,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,IAAI;gBAAE,MAAM;YACtB,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;YAC5B,IAAI,KAAK,GAAG,8BAAsB;gBAAE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;YAAS,CAAC;QAAC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IACjF,IAAI,IAAS,CAAC;IACd,IAAI,CAAC;QAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IAClG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;QAAE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC"}

package/dist/jev/service.d.ts

@@ -0,0 +1,27 @@
+import { JevConfig, JevConnection, JevContext, JevEvaluationEvent, JevRequest, JevResult } from './types';
+export declare function jevEndpoint(connection: JevConnection, provider: JevConfig['provider']): URL;
+export declare function resolveDirectJevConnection(config: JevConfig): Promise<JevConnection>;
+interface Options {
+    getConfig: () => JevConfig | undefined;
+    resolveConnection?: (config: JevConfig) => Promise<JevConnection>;
+    fetch?: typeof fetch;
+    onEvaluation?: (event: JevEvaluationEvent) => void;
+}
+/** The single queue is shared across config generations. No retries or source fallback. */
+export declare class JevService {
+    private readonly options;
+    private active;
+    private queue;
+    private requests;
+    constructor(options: Options);
+    evaluate(input: JevRequest, context: JevContext): Promise<JevResult>;
+    private run;
+    private authorized;
+    private errorMetadata;
+    private readResponse;
+    private abortable;
+    private acquire;
+    private drain;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/jev/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/jev/service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAA0B,kBAAkB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIlI,wBAAgB,WAAW,CAAC,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,GAAG,CAS3F;AACD,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAQ1F;AACD,UAAU,OAAO;IACf,SAAS,EAAE,MAAM,SAAS,GAAG,SAAS,CAAC;IACvC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAClE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACpD;AAGD,2FAA2F;AAC3F,qBAAa,UAAU;IAIT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAiG;gBACpF,OAAO,EAAE,OAAO;IAC7C,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;YAoCtD,GAAG;IAuDjB,OAAO,CAAC,UAAU;IAGlB,OAAO,CAAC,aAAa;YAKP,YAAY;IAU1B,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,KAAK;CAOd"}

package/dist/jev/service.js

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JevService = void 0;
+exports.jevEndpoint = jevEndpoint;
+exports.resolveDirectJevConnection = resolveDirectJevConnection;
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const types_1 = require("./types");
+const validation_1 = require("./validation");
+const child_env_1 = require("./child-env");
+function jevEndpoint(connection, provider) {
+    let url;
+    try {
+        url = new URL(connection.baseUrl);
+    }
+    catch {
+        throw new types_1.JevError('INVALID_CONFIG', 'Invalid Jev endpoint URL.');
+    }
+    const loopback = ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname);
+    if ((url.protocol !== 'https:' && !(url.protocol === 'http:' && loopback)) || url.username || url.password || url.search || url.hash)
+        throw new types_1.JevError('INVALID_CONFIG', 'Jev requires HTTPS (or local loopback HTTP), without URL credentials, query or fragment.');
+    const suffix = provider === 'typesafe' ? '/v1/systemone' : '/v1/jev/evaluate';
+    const path = url.pathname.replace(/\/+$/, '');
+    url.pathname = path.endsWith(suffix) ? path : path.endsWith('/v1') ? `${path}${suffix.slice(3)}` : `${path}${suffix}`;
+    return url;
+}
+async function resolveDirectJevConnection(config) {
+    if (config.provider !== 'typesafe')
+        throw new types_1.JevError('INVALID_CONFIG', 'An upstream connection resolver is required.');
+    if (config.apiKeyFile && config.apiKeyEnv)
+        throw new types_1.JevError('INVALID_CONFIG', 'Choose one Jev credential reference.');
+    let apiKey = '';
+    try {
+        apiKey = config.apiKeyFile ? (await (0, promises_1.readFile)(config.apiKeyFile, 'utf8')).trim() : (process.env[config.apiKeyEnv ?? child_env_1.JEV_DEFAULT_API_KEY_ENV] ?? '').trim();
+    }
+    catch {
+        throw new types_1.JevError('AUTHENTICATION_FAILED', 'The Jev credential file cannot be read.');
+    }
+    if (!apiKey || apiKey.length > 16384 || /[\r\n]/.test(apiKey))
+        throw new types_1.JevError('AUTHENTICATION_FAILED', 'A valid Jev credential is required.');
+    return { baseUrl: config.baseUrl ?? 'https://api.typesafe.ai', apiKey };
+}
+const LEDGER_MAX = 4096, LEDGER_PER_PRINCIPAL = 1024;
+/** The single queue is shared across config generations. No retries or source fallback. */
+class JevService {
+    constructor(options) {
+        this.options = options;
+        this.active = 0;
+        this.queue = [];
+        this.requests = new Map();
+    }
+    evaluate(input, context) {
+        const config = structuredClone(this.options.getConfig());
+        if (!config?.enabled)
+            return Promise.reject(new types_1.JevError('DISABLED', 'Jev is not enabled.'));
+        try {
+            (0, validation_1.validateJevConfig)(config);
+            if (!context.principalId || !context.consumer)
+                throw new types_1.JevError('ACCESS_DENIED', 'An authenticated evaluation context is required.');
+            if (context.authorize && !context.authorize())
+                throw new types_1.JevError('ACCESS_DENIED', 'Jev access was denied.');
+            const request = (0, validation_1.validateJevRequest)(input, config);
+            const requestId = request.requestId ?? (0, node_crypto_1.randomUUID)();
+            const key = `${context.principalId.length}:${context.principalId}:${requestId}`;
+            const digest = (0, node_crypto_1.createHash)('sha256').update(JSON.stringify({ request, config })).digest('hex');
+            const now = Date.now();
+            for (const [k, entry] of this.requests)
+                if (entry.settled && entry.expires < now)
+                    this.requests.delete(k);
+            const existing = this.requests.get(key);
+            if (existing) {
+                if (existing.digest !== digest)
+                    throw new types_1.JevError('REQUEST_CONFLICT', 'Request ID already identifies a different evaluation.');
+                // Never let a second caller detach the original cancellation/deadline contract.
+                throw new types_1.JevError('REQUEST_CONFLICT', 'Request ID has already been submitted; inspect the original evaluation result.');
+            }
+            const result = () => this.run(request, requestId, config, context);
+            // Only a caller-chosen request ID can be submitted twice; a generated one
+            // needs no idempotency entry and must not consume the shared ledger.
+            if (!request.requestId)
+                return result();
+            // One principal's burst fills only its own share; settled entries yield to new work.
+            let own = 0;
+            for (const entry of this.requests.values())
+                if (entry.principalId === context.principalId)
+                    own++;
+            if (own >= LEDGER_PER_PRINCIPAL)
+                throw new types_1.JevError('QUEUE_FULL', 'Too many recent Jev request IDs for this caller; retry later.');
+            for (const [k, entry] of this.requests) {
+                if (this.requests.size < LEDGER_MAX)
+                    break;
+                if (entry.settled)
+                    this.requests.delete(k);
+            }
+            if (this.requests.size >= LEDGER_MAX)
+                throw new types_1.JevError('QUEUE_FULL', 'The Jev request ledger is full; retry later.');
+            const entry = { principalId: context.principalId, digest, expires: now + 300000, settled: false };
+            const pending = result();
+            this.requests.set(key, entry);
+            void pending.then(() => { entry.settled = true; entry.expires = Date.now() + 300000; }, () => { entry.settled = true; entry.expires = Date.now() + 300000; });
+            return pending;
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+    }
+    async run(request, requestId, config, context) {
+        const startedAt = Date.now();
+        const wireRequestId = (0, node_crypto_1.createHash)('sha256').update(`${context.principalId.length}:${context.principalId}:${requestId}`).digest('hex');
+        const controller = new AbortController();
+        let expired = false;
+        const timeout = Math.min(config.timeoutMs ?? 5000, context.deadlineMs === undefined ? Infinity : context.deadlineMs - startedAt);
+        const abort = () => controller.abort();
+        const timer = setTimeout(() => { expired = true; controller.abort(); }, Math.max(0, timeout));
+        context.signal?.addEventListener('abort', abort, { once: true });
+        if (context.signal?.aborted)
+            abort();
+        if (timeout <= 0) {
+            expired = true;
+            abort();
+        }
+        let acquired = false;
+        let result;
+        let failure;
+        try {
+            await this.acquire(config, controller.signal);
+            acquired = true;
+            this.authorized(context);
+            const connection = await this.abortable((this.options.resolveConnection ?? resolveDirectJevConnection)(config), controller.signal);
+            this.authorized(context);
+            if (!connection.apiKey || /[\r\n]/.test(connection.apiKey))
+                throw new types_1.JevError('AUTHENTICATION_FAILED', 'A valid Jev credential is required.');
+            const endpoint = jevEndpoint(connection, config.provider);
+            const response = await this.abortable((this.options.fetch ?? fetch)(endpoint, {
+                method: 'POST', redirect: 'error', signal: controller.signal,
+                headers: { authorization: `Bearer ${connection.apiKey}`, 'content-type': 'application/json', 'x-request-id': wireRequestId },
+                body: JSON.stringify({ model: config.model, state: request.state, questions: request.questions, ...(config.provider === 'upstream' ? { request_id: wireRequestId } : {}) }),
+            }), controller.signal);
+            if (!response.ok) {
+                let code = response.status === 401 ? 'AUTHENTICATION_FAILED' : response.status === 403 ? 'ACCESS_DENIED' : response.status === 402 ? 'QUOTA_EXCEEDED' : response.status === 429 ? 'RATE_LIMITED' : response.status === 409 ? 'REQUEST_CONFLICT' : response.status === 504 ? 'DEADLINE_EXCEEDED' : response.status === 404 ? 'MODEL_UNAVAILABLE' : response.status === 400 || response.status === 413 || response.status === 422 ? 'INVALID_REQUEST' : 'PROVIDER_UNAVAILABLE';
+                const metadata = this.errorMetadata(response);
+                // Read only bounded structured codes/reset metadata. Provider prose can echo secrets or state.
+                if (config.provider === 'upstream' && response.headers.get('content-type')?.includes('application/json')) {
+                    try {
+                        const body = await this.abortable(this.readResponse(response, 16384), controller.signal);
+                        const mapped = { QUOTA_EXHAUSTED: 'QUOTA_EXCEEDED', QUOTA_EXCEEDED: 'QUOTA_EXCEEDED', MODEL_DISABLED: 'MODEL_UNAVAILABLE', UNKNOWN_MODEL: 'MODEL_UNAVAILABLE', UPSTREAM_AUTH_ERROR: 'AUTHENTICATION_FAILED', UPSTREAM_RATE_LIMITED: 'RATE_LIMITED', REQUEST_CONFLICT: 'REQUEST_CONFLICT', UPSTREAM_TIMEOUT: 'OUTCOME_UNKNOWN', UPSTREAM_OUTCOME_UNKNOWN: 'OUTCOME_UNKNOWN', CANCELLED_OUTCOME_UNKNOWN: 'OUTCOME_UNKNOWN', RESERVATION_UNKNOWN: 'OUTCOME_UNKNOWN', SETTLEMENT_UNKNOWN: 'OUTCOME_UNKNOWN' };
+                        if (body?.error?.code && Object.prototype.hasOwnProperty.call(mapped, body.error.code))
+                            code = mapped[body.error.code];
+                        const reset = body?.error?.resets_at ?? body?.error?.resetAt;
+                        if (typeof reset === 'string' && reset.length < 128 && /^[\w\s,:.+-]+$/.test(reset))
+                            metadata.resetAt = reset;
+                    }
+                    catch { /* Keep the HTTP failure; never turn a malformed error into success. */ }
+                }
+                else
+                    void response.body?.cancel().catch(() => undefined);
+                throw new types_1.JevError(code, code === 'OUTCOME_UNKNOWN' ? 'Jev outcome and charges require reconciliation. Do not retry automatically.' : `Jev evaluation failed (HTTP ${response.status}).`, { status: response.status, ...metadata });
+            }
+            const raw = await this.abortable(this.readResponse(response), controller.signal);
+            result = { ...(0, validation_1.validateJevResponse)(raw, request, config.model, wireRequestId), requestId };
+            this.authorized(context);
+            if (controller.signal.aborted)
+                throw new types_1.JevError('CANCELLED', 'Jev evaluation cancelled.');
+            return result;
+        }
+        catch (error) {
+            failure = controller.signal.aborted ? new types_1.JevError(expired ? 'DEADLINE_EXCEEDED' : 'CANCELLED', expired ? 'Jev evaluation deadline exceeded.' : 'Jev evaluation cancelled.') : error instanceof types_1.JevError ? error : new types_1.JevError('PROVIDER_UNAVAILABLE', 'Jev could not complete the evaluation.');
+            throw failure;
+        }
+        finally {
+            clearTimeout(timer);
+            context.signal?.removeEventListener('abort', abort);
+            if (acquired) {
+                this.active--;
+                this.drain();
+            }
+            try {
+                this.options.onEvaluation?.({ requestId, principalId: context.principalId, consumer: context.consumer, agentId: context.agentId, sessionId: context.sessionId, taskId: context.taskId, requestedModel: config.model, model: result?.model, startedAt, elapsedMs: Date.now() - startedAt, outcome: failure ? 'failed' : 'completed', errorCode: failure?.code, validationReason: failure?.metadata.validationReason, usage: result?.usage, billing: result?.billing });
+            }
+            catch { /* Accounting observers cannot change an already-issued inference outcome. */ }
+        }
+    }
+    authorized(context) {
+        if (!this.options.getConfig()?.enabled || (context.authorize && !context.authorize()))
+            throw new types_1.JevError('ACCESS_DENIED', 'Jev access was revoked.');
+    }
+    errorMetadata(response) {
+        const retryAfter = response.headers.get('retry-after');
+        const resetAt = response.headers.get('x-ratelimit-reset');
+        return { ...(retryAfter && retryAfter.length < 128 && /^[\w\s,:.+-]+$/.test(retryAfter) ? { retryAfter } : {}), ...(resetAt && resetAt.length < 128 && /^[\w\s,:.+-]+$/.test(resetAt) ? { resetAt } : {}) };
+    }
+    async readResponse(response, maxBytes = 2097152) {
+        if (!response.headers.get('content-type')?.toLowerCase().includes('application/json'))
+            throw new types_1.JevError('INVALID_RESPONSE', 'Jev returned a non-JSON response.');
+        const reader = response.body?.getReader();
+        if (!reader)
+            throw new types_1.JevError('INVALID_RESPONSE', 'Jev returned an empty response.');
+        const chunks = [];
+        let bytes = 0;
+        try {
+            for (;;) {
+                const chunk = await reader.read();
+                if (chunk.done)
+                    break;
+                bytes += chunk.value.length;
+                if (bytes > maxBytes)
+                    throw new types_1.JevError('INVALID_RESPONSE', 'Jev response exceeds the byte limit.');
+                chunks.push(chunk.value);
+            }
+            try {
+                return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+            }
+            catch {
+                throw new types_1.JevError('INVALID_RESPONSE', 'Jev returned malformed JSON.');
+            }
+        }
+        finally {
+            await reader.cancel().catch(() => undefined);
+            reader.releaseLock();
+        }
+    }
+    abortable(promise, signal) {
+        return new Promise((resolve, reject) => {
+            const abort = () => reject(new types_1.JevError('CANCELLED', 'Jev evaluation cancelled.'));
+            if (signal.aborted) {
+                void promise.catch(() => undefined);
+                abort();
+                return;
+            }
+            signal.addEventListener('abort', abort, { once: true });
+            promise.then(resolve, reject).finally(() => signal.removeEventListener('abort', abort));
+        });
+    }
+    acquire(config, signal) {
+        if (signal.aborted)
+            return Promise.reject(new types_1.JevError('CANCELLED', 'Jev evaluation cancelled.'));
+        const limit = config.maxConcurrentRequests ?? 4;
+        if (!this.queue.length && this.active < limit) {
+            this.active++;
+            return Promise.resolve();
+        }
+        if (this.queue.length >= (config.maxQueueSize ?? 16))
+            return Promise.reject(new types_1.JevError('QUEUE_FULL', 'Jev evaluation queue is full.'));
+        return new Promise((resolve, reject) => {
+            const waiter = { limit, accept: resolve, reject, signal, abort: () => { this.queue = this.queue.filter(x => x !== waiter); reject(new types_1.JevError('CANCELLED', 'Jev evaluation cancelled.')); this.drain(); } };
+            this.queue.push(waiter);
+            signal.addEventListener('abort', waiter.abort, { once: true });
+        });
+    }
+    drain() {
+        while (this.queue.length && this.active < this.queue[0].limit) {
+            const next = this.queue.shift();
+            next.signal.removeEventListener('abort', next.abort);
+            if (next.signal.aborted) {
+                next.reject(new types_1.JevError('CANCELLED', 'Jev evaluation cancelled.'));
+                continue;
+            }
+            this.active++;
+            next.accept();
+        }
+    }
+}
+exports.JevService = JevService;
+//# sourceMappingURL=service.js.map

package/dist/jev/service.js.map

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

package/dist/jev/thinking-provider.d.ts

@@ -0,0 +1,7 @@
+import type { ThinkingConfig } from '../../lib/automation/thinking.cjs';
+import type { BrowserTextHelperConfig } from './browser-contract';
+/** Credentials stay in the host; reasoning instructions belong to the built-in controller. */
+export declare function thinkingProvider(config: BrowserTextHelperConfig): Promise<ThinkingConfig>;
+/** Provider transport/config errors are blockers, never a request for missing user facts. */
+export declare function thinkingFailure(error: unknown): Error;
+//# sourceMappingURL=thinking-provider.d.ts.map

package/dist/jev/thinking-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-provider.d.ts","sourceRoot":"","sources":["../../src/jev/thinking-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAChE,8FAA8F;AAC9F,wBAAsB,gBAAgB,CAAC,MAAM,EAAC,uBAAuB,GAAE,OAAO,CAAC,cAAc,CAAC,CAM7F;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,KAAK,EAAC,OAAO,GAAE,KAAK,CAGnD"}

package/dist/jev/thinking-provider.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.thinkingProvider = thinkingProvider;
+exports.thinkingFailure = thinkingFailure;
+const promises_1 = require("node:fs/promises");
+/** Credentials stay in the host; reasoning instructions belong to the built-in controller. */
+async function thinkingProvider(config) {
+    let apiKey;
+    if (config.apiKeyFile) {
+        if ((await (0, promises_1.stat)(config.apiKeyFile)).size > 16384)
+            throw Error('THINKING_CREDENTIAL_INVALID');
+        apiKey = (await (0, promises_1.readFile)(config.apiKeyFile, 'utf8')).trim();
+    }
+    else
+        apiKey = process.env[config.apiKeyEnv ?? ''] ?? '';
+    if (!apiKey || apiKey.length > 16384 || /[\x00-\x20\x7f]/.test(apiKey))
+        throw Error('THINKING_CREDENTIAL_UNAVAILABLE');
+    return { api: config.api, baseUrl: config.baseUrl, model: config.model, apiKey };
+}
+/** Provider transport/config errors are blockers, never a request for missing user facts. */
+function thinkingFailure(error) {
+    const code = error instanceof Error ? error.message : '';
+    return Error(/^THINKING_(?:HTTP_[0-9]{3}|[A-Z_]{1,64})$/.test(code) ? code : 'THINKING_PROVIDER_FAILED');
+}
+//# sourceMappingURL=thinking-provider.js.map

package/dist/jev/thinking-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-provider.js","sourceRoot":"","sources":["../../src/jev/thinking-provider.ts"],"names":[],"mappings":";;AAIA,4CAMC;AAGD,0CAGC;AAhBD,+CAA+C;AAG/C,8FAA8F;AACvF,KAAK,UAAU,gBAAgB,CAAC,MAA8B;IACpE,IAAI,MAAa,CAAC;IAClB,IAAG,MAAM,CAAC,UAAU,EAAC,CAAC;QAAA,IAAG,CAAC,MAAM,IAAA,eAAI,EAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAC,KAAK;YAAC,MAAM,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAAA,MAAM,GAAC,CAAC,MAAM,IAAA,mBAAQ,EAAC,MAAM,CAAC,UAAU,EAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAAA,CAAC;;QACpK,MAAM,GAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAE,EAAE,CAAC,IAAE,EAAE,CAAC;IAClD,IAAG,CAAC,MAAM,IAAE,MAAM,CAAC,MAAM,GAAC,KAAK,IAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAC,MAAM,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC/G,OAAO,EAAC,GAAG,EAAC,MAAM,CAAC,GAAG,EAAC,OAAO,EAAC,MAAM,CAAC,OAAO,EAAC,KAAK,EAAC,MAAM,CAAC,KAAK,EAAC,MAAM,EAAC,CAAC;AAC1E,CAAC;AAED,6FAA6F;AAC7F,SAAgB,eAAe,CAAC,KAAa;IAC5C,MAAM,IAAI,GAAC,KAAK,YAAY,KAAK,CAAA,CAAC,CAAA,KAAK,CAAC,OAAO,CAAA,CAAC,CAAA,EAAE,CAAC;IACnD,OAAO,KAAK,CAAC,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAC,CAAA,IAAI,CAAA,CAAC,CAAA,0BAA0B,CAAC,CAAC;AACtG,CAAC"}

package/dist/jev/types.d.ts

@@ -0,0 +1,124 @@
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JevContent = string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JevQuestion = {
+    type: 'noul';
+    instructions: JevContent;
+    criteria?: {
+        true?: JevContent;
+        false?: JevContent;
+    };
+} | {
+    type: 'choice';
+    instructions: JevContent;
+    criteria: Record<string, JevContent | null>;
+} | {
+    type: 'score';
+    instructions: JevContent;
+    criteria: JevContent[];
+};
+export type JevAnswer = {
+    type: 'noul';
+    noul: number;
+} | {
+    type: 'choice';
+    choice: string;
+    confidence: number;
+    probabilities: Record<string, number>;
+} | {
+    type: 'score';
+    score: number;
+    confidence: number;
+    probabilities: Record<string, number>;
+    legend: Record<string, string>;
+};
+export interface JevRequest {
+    state: JevContent;
+    questions: Record<string, JevQuestion>;
+    requestId?: string;
+}
+export interface JevConfig {
+    /** Tool-free reasoning connection; instructions and output contracts live in Jev Loop. */
+    thinking?: import('./browser-contract').BrowserTextHelperConfig;
+    browser?: import('./browser-contract').BrowserIntegrationConfig;
+    enabled?: boolean;
+    provider?: 'typesafe' | 'upstream';
+    model?: string;
+    baseUrl?: string;
+    apiKeyFile?: string;
+    apiKeyEnv?: string;
+    timeoutMs?: number;
+    maxConcurrentRequests?: number;
+    maxQueueSize?: number;
+    maxInputBytes?: number;
+    maxQuestions?: number;
+    allowedAgentIds?: string[];
+    features?: Partial<Record<'computerTasks' | 'computerSteps' | 'browserTasks' | 'browserSteps', {
+        enabled?: boolean;
+    }>>;
+}
+export interface JevResult {
+    requestId: string;
+    requestedModel: string;
+    model: string;
+    answers: Record<string, JevAnswer>;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    billing?: {
+        charged_credits: number;
+        rate_version?: string;
+    };
+}
+export interface JevContext {
+    principalId: string;
+    consumer: string;
+    agentId?: string;
+    sessionId?: string;
+    taskId?: string;
+    signal?: AbortSignal;
+    deadlineMs?: number;
+    authorize?: () => boolean;
+}
+export interface JevConnection {
+    baseUrl: string;
+    apiKey: string;
+}
+export type JevErrorCode = 'DISABLED' | 'ACCESS_DENIED' | 'INVALID_CONFIG' | 'INVALID_REQUEST' | 'QUEUE_FULL' | 'CANCELLED' | 'DEADLINE_EXCEEDED' | 'AUTHENTICATION_FAILED' | 'MODEL_UNAVAILABLE' | 'QUOTA_EXCEEDED' | 'RATE_LIMITED' | 'PROVIDER_UNAVAILABLE' | 'INVALID_RESPONSE' | 'REQUEST_CONFLICT' | 'OUTCOME_UNKNOWN';
+export declare class JevError extends Error {
+    readonly code: JevErrorCode;
+    readonly metadata: {
+        status?: number;
+        retryAfter?: string;
+        resetAt?: string;
+        validationReason?: string;
+    };
+    constructor(code: JevErrorCode, message: string, metadata?: {
+        status?: number;
+        retryAfter?: string;
+        resetAt?: string;
+        validationReason?: string;
+    });
+}
+export interface JevEvaluationEvent {
+    requestId: string;
+    principalId: string;
+    consumer: string;
+    agentId?: string;
+    sessionId?: string;
+    taskId?: string;
+    requestedModel: string;
+    model?: string;
+    startedAt: number;
+    elapsedMs: number;
+    outcome: 'completed' | 'failed';
+    errorCode?: JevErrorCode;
+    validationReason?: string;
+    usage?: JevResult['usage'];
+    billing?: JevResult['billing'];
+}
+//# sourceMappingURL=types.d.ts.map

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

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