tolvyn 1.0.1 → 1.0.3

package/dist/esm/client.js

@@ -0,0 +1,76 @@
+/**
+ * TOLVYN OpenAI wrapper — thin drop-in over the official openai package.
+ */
+import OpenAIBase from 'openai';
+import { isProxyError, shouldNotFailOpen } from './failopen';
+const OPENAI_DEFAULT_PROXY_URL = 'https://proxy.tolvyn.io/v1/proxy/openai/';
+const OPENAI_DIRECT_URL = 'https://api.openai.com/v1';
+function makeFailOpenFetch(fallbackKey, directUrl, provider) {
+    return async function failOpenFetch(input, init) {
+        try {
+            const res = await fetch(input, init);
+            if (res.status === 503) {
+                throw Object.assign(new Error('503 from proxy'), { status: 503 });
+            }
+            return res;
+        }
+        catch (err) {
+            if (shouldNotFailOpen(err) || !isProxyError(err))
+                throw err;
+            console.error(`TOLVYN proxy unreachable — routing direct to ${provider} (fail-open)`);
+            const originalUrl = typeof input === 'string'
+                ? input
+                : input instanceof URL
+                    ? input.href
+                    : input.url;
+            const url = new URL(originalUrl);
+            const directBase = new URL(directUrl);
+            url.hostname = directBase.hostname;
+            url.protocol = directBase.protocol;
+            url.port = directBase.port;
+            url.pathname = url.pathname; // keep path intact
+            const newInit = { ...(init ?? {}) };
+            const headers = new Headers(init?.headers ?? {});
+            headers.set('Authorization', `Bearer ${fallbackKey}`);
+            newInit.headers = headers;
+            return fetch(url.toString(), newInit);
+        }
+    };
+}
+export class OpenAI extends OpenAIBase {
+    constructor(options = {}) {
+        const tolvynApiKey = options.tolvynApiKey ?? process.env['TOLVYN_API_KEY'];
+        if (!tolvynApiKey) {
+            throw new Error('tolvynApiKey required. Set TOLVYN_API_KEY env var or pass tolvynApiKey.');
+        }
+        const proxyUrl = options.proxyUrl ??
+            process.env['TOLVYN_PROXY_URL'] ??
+            OPENAI_DEFAULT_PROXY_URL;
+        const defaultHeaders = {};
+        if (options.team)
+            defaultHeaders['X-Tolvyn-Team'] = options.team;
+        if (options.service)
+            defaultHeaders['X-Tolvyn-Service'] = options.service;
+        if (options.feature)
+            defaultHeaders['X-Tolvyn-Feature'] = options.feature;
+        if (options.agent)
+            defaultHeaders['X-Tolvyn-Agent'] = options.agent;
+        const fallbackKey = options.openAIApiKey ?? process.env['OPENAI_API_KEY'];
+        const failOpen = options.failOpen ?? true;
+        const { tolvynApiKey: _tk, proxyUrl: _pu, team: _t, service: _sv, feature: _f, agent: _a, failOpen: _fo, openAIApiKey: _oak, ...rest } = options;
+        const superOptions = {
+            ...rest,
+            apiKey: tolvynApiKey,
+            baseURL: proxyUrl,
+            defaultHeaders,
+        };
+        if (failOpen && fallbackKey && !superOptions.fetch) {
+            superOptions.fetch = makeFailOpenFetch(fallbackKey, OPENAI_DIRECT_URL, 'OpenAI');
+        }
+        super(superOptions);
+        this._tolvynFailOpen = failOpen;
+        this._tolvynFallbackKey = fallbackKey;
+        this._tolvynProxyUrl = proxyUrl;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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

package/dist/esm/failopen.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Fail-open helpers: detect proxy unreachability and retry direct.
+ */
+export declare function isProxyError(error: unknown): boolean;
+export declare function shouldNotFailOpen(error: unknown): boolean;
+export declare function makeFailOpenFetch(fallbackKey: string, directUrl: string, provider: string): typeof globalThis.fetch;
+//# sourceMappingURL=failopen.d.ts.map

package/dist/esm/failopen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failopen.d.ts","sourceRoot":"","sources":["../../src/failopen.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAoCpD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASzD;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,UAAU,CAAC,KAAK,CAoCzB"}

package/dist/esm/failopen.js

@@ -0,0 +1,77 @@
+/**
+ * Fail-open helpers: detect proxy unreachability and retry direct.
+ */
+export function isProxyError(error) {
+    if (!error || typeof error !== 'object')
+        return false;
+    const err = error;
+    // Node.js connection errors (ECONNREFUSED, ETIMEDOUT, etc.)
+    const code = err['code'];
+    if (typeof code === 'string' && (code === 'ECONNREFUSED' ||
+        code === 'ECONNRESET' ||
+        code === 'ETIMEDOUT' ||
+        code === 'ENOTFOUND' ||
+        code.startsWith('ERR_'))) {
+        return true;
+    }
+    // HTTP 503 from proxy
+    const status = err['status'] ?? err['statusCode'];
+    if (status === 503)
+        return true;
+    // fetch-level errors
+    const message = typeof err['message'] === 'string' ? err['message'] : '';
+    if (message.includes('ECONNREFUSED') ||
+        message.includes('ETIMEDOUT') ||
+        message.includes('fetch failed') ||
+        message.includes('connect ECONNREFUSED')) {
+        return true;
+    }
+    // Check cause (Node 18+ wraps errors)
+    const cause = err['cause'];
+    if (cause && isProxyError(cause))
+        return true;
+    return false;
+}
+export function shouldNotFailOpen(error) {
+    // Never fail-open on real API errors (401, 429, other 4xx except 503).
+    if (!error || typeof error !== 'object')
+        return false;
+    const err = error;
+    const status = err['status'] ?? err['statusCode'];
+    if (typeof status === 'number' && status >= 400 && status < 500 && status !== 503) {
+        return true;
+    }
+    return false;
+}
+export function makeFailOpenFetch(fallbackKey, directUrl, provider) {
+    return async function failOpenFetch(input, init) {
+        try {
+            const res = await fetch(input, init);
+            if (res.status === 503) {
+                throw Object.assign(new Error('503 from proxy'), { status: 503 });
+            }
+            return res;
+        }
+        catch (err) {
+            if (shouldNotFailOpen(err) || !isProxyError(err))
+                throw err;
+            console.error(`TOLVYN proxy unreachable — routing direct to ${provider} (fail-open)`);
+            const originalUrl = typeof input === 'string'
+                ? input
+                : input instanceof URL
+                    ? input.href
+                    : input.url;
+            const url = new URL(originalUrl);
+            const directBase = new URL(directUrl);
+            url.hostname = directBase.hostname;
+            url.protocol = directBase.protocol;
+            url.port = directBase.port;
+            const newInit = { ...(init ?? {}) };
+            const headers = new Headers(init?.headers ?? {});
+            headers.set('Authorization', `Bearer ${fallbackKey}`);
+            newInit.headers = headers;
+            return fetch(url.toString(), newInit);
+        }
+    };
+}
+//# sourceMappingURL=failopen.js.map

package/dist/esm/failopen.js.map

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

package/dist/esm/google.d.ts

@@ -0,0 +1,23 @@
+/**
+ * TOLVYN Google wrapper — thin drop-in over @google/generative-ai.
+ */
+import { GoogleGenerativeAI, ModelParams, RequestOptions } from '@google/generative-ai';
+export interface TolvynGoogleOptions {
+    tolvynApiKey?: string;
+    proxyUrl?: string;
+    team?: string;
+    service?: string;
+    feature?: string;
+    agent?: string;
+    failOpen?: boolean;
+    googleApiKey?: string;
+}
+export declare class TolvynGoogle extends GoogleGenerativeAI {
+    readonly _tolvynFailOpen: boolean;
+    readonly _tolvynFallbackKey: string | undefined;
+    private readonly _tolvynProxyUrl;
+    private readonly _tolvynHeaders;
+    constructor(options?: TolvynGoogleOptions);
+    getGenerativeModel(modelParams: ModelParams, requestOptions?: RequestOptions): import("@google/generative-ai").GenerativeModel;
+}
+//# sourceMappingURL=google.d.ts.map

package/dist/esm/google.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/google.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,cAAc,EACf,MAAM,uBAAuB,CAAC;AAM/B,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,YAAa,SAAQ,kBAAkB;IAClD,SAAgB,eAAe,EAAE,OAAO,CAAC;IACzC,SAAgB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IACvD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;gBAE5C,OAAO,GAAE,mBAAwB;IA4BpC,kBAAkB,CACzB,WAAW,EAAE,WAAW,EACxB,cAAc,CAAC,EAAE,cAAc;CASlC"}

package/dist/esm/google.js

@@ -0,0 +1,43 @@
+/**
+ * TOLVYN Google wrapper — thin drop-in over @google/generative-ai.
+ */
+import { GoogleGenerativeAI, } from '@google/generative-ai';
+// The proxy base URL is prepended to Google API paths (/v1beta/models/...).
+// The TOLVYN proxy strips /v1/proxy/google and forwards the remainder to Google.
+const GOOGLE_DEFAULT_PROXY_URL = 'https://proxy.tolvyn.io/v1/proxy/google';
+export class TolvynGoogle extends GoogleGenerativeAI {
+    constructor(options = {}) {
+        const tolvynApiKey = options.tolvynApiKey ?? process.env['TOLVYN_API_KEY'];
+        if (!tolvynApiKey) {
+            throw new Error('tolvynApiKey required. Set TOLVYN_API_KEY env var or pass tolvynApiKey.');
+        }
+        // GoogleGenerativeAI sends this value as x-goog-api-key.
+        // The TOLVYN proxy's extractBearer reads x-goog-api-key as a fallback.
+        super(tolvynApiKey);
+        this._tolvynProxyUrl =
+            options.proxyUrl ??
+                process.env['TOLVYN_PROXY_URL'] ??
+                GOOGLE_DEFAULT_PROXY_URL;
+        this._tolvynHeaders = {};
+        if (options.team)
+            this._tolvynHeaders['X-Tolvyn-Team'] = options.team;
+        if (options.service)
+            this._tolvynHeaders['X-Tolvyn-Service'] = options.service;
+        if (options.feature)
+            this._tolvynHeaders['X-Tolvyn-Feature'] = options.feature;
+        if (options.agent)
+            this._tolvynHeaders['X-Tolvyn-Agent'] = options.agent;
+        this._tolvynFailOpen = options.failOpen ?? true;
+        this._tolvynFallbackKey =
+            options.googleApiKey ?? process.env['GOOGLE_API_KEY'];
+    }
+    getGenerativeModel(modelParams, requestOptions) {
+        const mergedOptions = {
+            baseUrl: this._tolvynProxyUrl,
+            customHeaders: this._tolvynHeaders,
+            ...requestOptions,
+        };
+        return super.getGenerativeModel(modelParams, mergedOptions);
+    }
+}
+//# sourceMappingURL=google.js.map

package/dist/esm/google.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.js","sourceRoot":"","sources":["../../src/google.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,kBAAkB,GAGnB,MAAM,uBAAuB,CAAC;AAE/B,4EAA4E;AAC5E,iFAAiF;AACjF,MAAM,wBAAwB,GAAG,yCAAyC,CAAC;AAa3E,MAAM,OAAO,YAAa,SAAQ,kBAAkB;IAMlD,YAAY,UAA+B,EAAE;QAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC3E,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;QACJ,CAAC;QAED,yDAAyD;QACzD,uEAAuE;QACvE,KAAK,CAAC,YAAY,CAAC,CAAC;QAEpB,IAAI,CAAC,eAAe;YAClB,OAAO,CAAC,QAAQ;gBAChB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;gBAC/B,wBAAwB,CAAC;QAE3B,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI;YAAK,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,GAAM,OAAO,CAAC,IAAI,CAAC;QAC5E,IAAI,OAAO,CAAC,OAAO;YAAE,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/E,IAAI,OAAO,CAAC,OAAO;YAAE,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/E,IAAI,OAAO,CAAC,KAAK;YAAI,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,GAAK,OAAO,CAAC,KAAK,CAAC;QAE7E,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,kBAAkB;YACrB,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC1D,CAAC;IAEQ,kBAAkB,CACzB,WAAwB,EACxB,cAA+B;QAE/B,MAAM,aAAa,GAAmB;YACpC,OAAO,EAAE,IAAI,CAAC,eAAe;YAC7B,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,GAAG,cAAc;SAClB,CAAC;QACF,OAAO,KAAK,CAAC,kBAAkB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/esm/index.d.ts

@@ -0,0 +1,7 @@
+export { OpenAI } from './client';
+export type { TolvynOpenAIOptions } from './client';
+export { Anthropic } from './anthropic';
+export type { TolvynAnthropicOptions } from './anthropic';
+export { TolvynGoogle as Google } from './google';
+export type { TolvynGoogleOptions } from './google';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,YAAY,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,4 @@
+export { OpenAI } from './client';
+export { Anthropic } from './anthropic';
+export { TolvynGoogle as Google } from './google';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,YAAY,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/package.json

@@ -1,13 +1,49 @@
 {
   "name": "tolvyn",
-  "version": "1.0.1",
-  "description": "",
-  "main": "index.js",
+  "version": "1.0.3",
+  "description": "Drop-in replacement for the OpenAI/Anthropic SDK — routes through TOLVYN for cost attribution, budget enforcement, and audit logging.",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/cjs/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.20.0",
+    "@google/generative-ai": "^0.21.0",
+    "openai": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.5.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "testMatch": [
+      "**/tests/**/*.test.ts"
+    ],
+    "globals": {
+      "ts-jest": {
+        "tsconfig": "tsconfig.cjs.json"
+      }
+    }
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "type": "commonjs"
+  "license": "MIT"
 }

package/src/anthropic.ts

@@ -0,0 +1,70 @@
+/**
+ * TOLVYN Anthropic wrapper — thin drop-in over @anthropic-ai/sdk.
+ */
+import AnthropicBase, { ClientOptions } from '@anthropic-ai/sdk';
+import { makeFailOpenFetch } from './failopen';
+
+const ANTHROPIC_DEFAULT_PROXY_URL = 'https://proxy.tolvyn.io/v1/proxy/anthropic/';
+const ANTHROPIC_DIRECT_URL = 'https://api.anthropic.com';
+
+export interface TolvynAnthropicOptions
+  extends Omit<ClientOptions, 'apiKey' | 'baseURL'> {
+  tolvynApiKey?: string;
+  proxyUrl?: string;
+  team?: string;
+  service?: string;
+  feature?: string;
+  agent?: string;
+  failOpen?: boolean;
+  anthropicApiKey?: string;
+}
+
+export class Anthropic extends AnthropicBase {
+  public readonly _tolvynFailOpen: boolean;
+  public readonly _tolvynFallbackKey: string | undefined;
+
+  constructor(options: TolvynAnthropicOptions = {}) {
+    const tolvynApiKey = options.tolvynApiKey ?? process.env['TOLVYN_API_KEY'];
+    if (!tolvynApiKey) {
+      throw new Error(
+        'tolvynApiKey required. Set TOLVYN_API_KEY env var or pass tolvynApiKey.'
+      );
+    }
+
+    const proxyUrl =
+      options.proxyUrl ??
+      process.env['TOLVYN_PROXY_URL'] ??
+      ANTHROPIC_DEFAULT_PROXY_URL;
+
+    const defaultHeaders: Record<string, string> = {};
+    if (options.team)    defaultHeaders['X-Tolvyn-Team']    = options.team;
+    if (options.service) defaultHeaders['X-Tolvyn-Service'] = options.service;
+    if (options.feature) defaultHeaders['X-Tolvyn-Feature'] = options.feature;
+    if (options.agent)   defaultHeaders['X-Tolvyn-Agent']   = options.agent;
+
+    const fallbackKey = options.anthropicApiKey ?? process.env['ANTHROPIC_API_KEY'];
+    const failOpen = options.failOpen ?? true;
+
+    const {
+      tolvynApiKey: _tk, proxyUrl: _pu, team: _t, service: _sv,
+      feature: _f, agent: _a, failOpen: _fo, anthropicApiKey: _aak,
+      ...rest
+    } = options;
+
+    const superOptions: ClientOptions = {
+      ...rest,
+      apiKey: tolvynApiKey,
+      baseURL: proxyUrl,
+      defaultHeaders,
+    };
+
+    if (failOpen && fallbackKey && !superOptions.fetch) {
+      superOptions.fetch = makeFailOpenFetch(fallbackKey, ANTHROPIC_DIRECT_URL, 'Anthropic');
+    }
+
+    super(superOptions);
+
+    this._tolvynFailOpen = failOpen;
+    this._tolvynFallbackKey = fallbackKey;
+  }
+}

package/src/client.ts

@@ -0,0 +1,115 @@
+/**
+ * TOLVYN OpenAI wrapper — thin drop-in over the official openai package.
+ */
+import OpenAIBase, { ClientOptions } from 'openai';
+import { isProxyError, shouldNotFailOpen } from './failopen';
+
+const OPENAI_DEFAULT_PROXY_URL = 'https://proxy.tolvyn.io/v1/proxy/openai/';
+const OPENAI_DIRECT_URL = 'https://api.openai.com/v1';
+
+export interface TolvynOpenAIOptions
+  extends Omit<ClientOptions, 'apiKey' | 'baseURL'> {
+  tolvynApiKey?: string;
+  proxyUrl?: string;
+  team?: string;
+  service?: string;
+  feature?: string;
+  agent?: string;
+  failOpen?: boolean;
+  openAIApiKey?: string;
+}
+
+function makeFailOpenFetch(
+  fallbackKey: string,
+  directUrl: string,
+  provider: string
+): typeof globalThis.fetch {
+  return async function failOpenFetch(
+    input: RequestInfo | URL,
+    init?: RequestInit
+  ): Promise<Response> {
+    try {
+      const res = await fetch(input, init);
+      if (res.status === 503) {
+        throw Object.assign(new Error('503 from proxy'), { status: 503 });
+      }
+      return res;
+    } catch (err: unknown) {
+      if (shouldNotFailOpen(err) || !isProxyError(err)) throw err;
+      console.error(
+        `TOLVYN proxy unreachable — routing direct to ${provider} (fail-open)`
+      );
+      const originalUrl =
+        typeof input === 'string'
+          ? input
+          : input instanceof URL
+          ? input.href
+          : (input as Request).url;
+      const url = new URL(originalUrl);
+      const directBase = new URL(directUrl);
+      url.hostname = directBase.hostname;
+      url.protocol = directBase.protocol;
+      url.port = directBase.port;
+      url.pathname = url.pathname; // keep path intact
+
+      const newInit: RequestInit = { ...(init ?? {}) };
+      const headers = new Headers((init?.headers as HeadersInit) ?? {});
+      headers.set('Authorization', `Bearer ${fallbackKey}`);
+      newInit.headers = headers;
+
+      return fetch(url.toString(), newInit);
+    }
+  };
+}
+
+export class OpenAI extends OpenAIBase {
+  public readonly _tolvynFailOpen: boolean;
+  public readonly _tolvynFallbackKey: string | undefined;
+  public readonly _tolvynProxyUrl: string;
+
+  constructor(options: TolvynOpenAIOptions = {}) {
+    const tolvynApiKey = options.tolvynApiKey ?? process.env['TOLVYN_API_KEY'];
+    if (!tolvynApiKey) {
+      throw new Error(
+        'tolvynApiKey required. Set TOLVYN_API_KEY env var or pass tolvynApiKey.'
+      );
+    }
+
+    const proxyUrl =
+      options.proxyUrl ??
+      process.env['TOLVYN_PROXY_URL'] ??
+      OPENAI_DEFAULT_PROXY_URL;
+
+    const defaultHeaders: Record<string, string> = {};
+    if (options.team)    defaultHeaders['X-Tolvyn-Team']    = options.team;
+    if (options.service) defaultHeaders['X-Tolvyn-Service'] = options.service;
+    if (options.feature) defaultHeaders['X-Tolvyn-Feature'] = options.feature;
+    if (options.agent)   defaultHeaders['X-Tolvyn-Agent']   = options.agent;
+
+    const fallbackKey = options.openAIApiKey ?? process.env['OPENAI_API_KEY'];
+    const failOpen = options.failOpen ?? true;
+
+    const {
+      tolvynApiKey: _tk, proxyUrl: _pu, team: _t, service: _sv,
+      feature: _f, agent: _a, failOpen: _fo, openAIApiKey: _oak,
+      ...rest
+    } = options;
+
+    const superOptions: ClientOptions = {
+      ...rest,
+      apiKey: tolvynApiKey,
+      baseURL: proxyUrl,
+      defaultHeaders,
+    };
+
+    if (failOpen && fallbackKey && !superOptions.fetch) {
+      superOptions.fetch = makeFailOpenFetch(fallbackKey, OPENAI_DIRECT_URL, 'OpenAI');
+    }
+
+    super(superOptions);
+
+    this._tolvynFailOpen = failOpen;
+    this._tolvynFallbackKey = fallbackKey;
+    this._tolvynProxyUrl = proxyUrl;
+  }
+}

package/src/failopen.ts

@@ -0,0 +1,94 @@
+/**
+ * Fail-open helpers: detect proxy unreachability and retry direct.
+ */
+
+export function isProxyError(error: unknown): boolean {
+  if (!error || typeof error !== 'object') return false;
+  const err = error as Record<string, unknown>;
+
+  // Node.js connection errors (ECONNREFUSED, ETIMEDOUT, etc.)
+  const code = err['code'];
+  if (typeof code === 'string' && (
+    code === 'ECONNREFUSED' ||
+    code === 'ECONNRESET' ||
+    code === 'ETIMEDOUT' ||
+    code === 'ENOTFOUND' ||
+    code.startsWith('ERR_')
+  )) {
+    return true;
+  }
+
+  // HTTP 503 from proxy
+  const status = err['status'] ?? err['statusCode'];
+  if (status === 503) return true;
+
+  // fetch-level errors
+  const message = typeof err['message'] === 'string' ? err['message'] : '';
+  if (
+    message.includes('ECONNREFUSED') ||
+    message.includes('ETIMEDOUT') ||
+    message.includes('fetch failed') ||
+    message.includes('connect ECONNREFUSED')
+  ) {
+    return true;
+  }
+
+  // Check cause (Node 18+ wraps errors)
+  const cause = err['cause'];
+  if (cause && isProxyError(cause)) return true;
+
+  return false;
+}
+
+export function shouldNotFailOpen(error: unknown): boolean {
+  // Never fail-open on real API errors (401, 429, other 4xx except 503).
+  if (!error || typeof error !== 'object') return false;
+  const err = error as Record<string, unknown>;
+  const status = err['status'] ?? err['statusCode'];
+  if (typeof status === 'number' && status >= 400 && status < 500 && status !== 503) {
+    return true;
+  }
+  return false;
+}
+
+export function makeFailOpenFetch(
+  fallbackKey: string,
+  directUrl: string,
+  provider: string
+): typeof globalThis.fetch {
+  return async function failOpenFetch(
+    input: RequestInfo | URL,
+    init?: RequestInit
+  ): Promise<Response> {
+    try {
+      const res = await fetch(input, init);
+      if (res.status === 503) {
+        throw Object.assign(new Error('503 from proxy'), { status: 503 });
+      }
+      return res;
+    } catch (err: unknown) {
+      if (shouldNotFailOpen(err) || !isProxyError(err)) throw err;
+      console.error(
+        `TOLVYN proxy unreachable — routing direct to ${provider} (fail-open)`
+      );
+      const originalUrl =
+        typeof input === 'string'
+          ? input
+          : input instanceof URL
+          ? input.href
+          : (input as Request).url;
+      const url = new URL(originalUrl);
+      const directBase = new URL(directUrl);
+      url.hostname = directBase.hostname;
+      url.protocol = directBase.protocol;
+      url.port = directBase.port;
+
+      const newInit: RequestInit = { ...(init ?? {}) };
+      const headers = new Headers((init?.headers as HeadersInit) ?? {});
+      headers.set('Authorization', `Bearer ${fallbackKey}`);
+      newInit.headers = headers;
+
+      return fetch(url.toString(), newInit);
+    }
+  };
+}