tolvyn 1.0.1 → 1.0.2

package/README.md

@@ -0,0 +1,183 @@
+# tolvyn (Node.js / TypeScript SDK)
+
+Drop-in replacement for the `openai` and `@anthropic-ai/sdk` packages. Add cost metering, team attribution, and budget enforcement to your AI calls in one line.
+
+```bash
+npm install tolvyn
+```
+
+---
+
+## Quick Start
+
+### OpenAI (ESM / TypeScript)
+
+```typescript
+// Before
+import OpenAI from "openai";
+const client = new OpenAI();
+
+// After — one line change
+import { OpenAI } from "tolvyn";
+const client = new OpenAI({
+  tolvynApiKey: "tlv_live_...",    // or set TOLVYN_API_KEY env var
+  team: "backend",
+  service: "summariser",
+});
+
+// Everything else stays the same
+const response = await client.chat.completions.create({
+  model: "gpt-4o",
+  messages: [{ role: "user", content: "Hello" }],
+});
+```
+
+### OpenAI (CommonJS)
+
+```javascript
+const { OpenAI } = require("tolvyn");
+
+const client = new OpenAI({
+  tolvynApiKey: process.env.TOLVYN_API_KEY,
+  team: "backend",
+  service: "summariser",
+});
+```
+
+### Anthropic (ESM / TypeScript)
+
+```typescript
+// Before
+import Anthropic from "@anthropic-ai/sdk";
+const client = new Anthropic();
+
+// After
+import { Anthropic } from "tolvyn";
+const client = new Anthropic({
+  tolvynApiKey: "tlv_live_...",
+  team: "ml-team",
+  service: "classifier",
+});
+
+const message = await client.messages.create({
+  model: "claude-sonnet-4-6",
+  max_tokens: 1024,
+  messages: [{ role: "user", content: "Hello" }],
+});
+```
+
+---
+
+## Classes
+
+| Class              | Extends                       | Provider  |
+|--------------------|-------------------------------|-----------|
+| `tolvyn.OpenAI`    | `openai` OpenAI               | OpenAI    |
+| `tolvyn.Anthropic` | `@anthropic-ai/sdk` Anthropic | Anthropic |
+
+Both classes are strict drop-ins. Every method, event, and behaviour of the underlying SDK is preserved.
+
+---
+
+## Parameters
+
+### `OpenAI` (`TolvynOpenAIOptions`)
+
+Extends `openai.ClientOptions` (omitting `apiKey` and `baseURL`).
+
+| Parameter      | Type                  | Default     | Description                                                                                               |
+|----------------|-----------------------|-------------|-----------------------------------------------------------------------------------------------------------|
+| `tolvynApiKey` | `string or undefined` | `undefined` | Your TOLVYN API key. Falls back to `TOLVYN_API_KEY` env var. Required.                                    |
+| `proxyUrl`     | `string or undefined` | `undefined` | TOLVYN proxy URL. Falls back to `TOLVYN_PROXY_URL` env var, then `http://localhost:8081/v1/proxy/openai`. |
+| `team`         | `string or undefined` | `undefined` | Team name for cost attribution. Sent as `X-Tolvyn-Team` header.                                           |
+| `service`      | `string or undefined` | `undefined` | Service name. Sent as `X-Tolvyn-Service` header.                                                          |
+| `feature`      | `string or undefined` | `undefined` | Feature name. Sent as `X-Tolvyn-Feature` header.                                                          |
+| `agent`        | `string or undefined` | `undefined` | Agent name. Sent as `X-Tolvyn-Agent` header.                                                              |
+| `failOpen`     | `boolean`             | `true`      | If `true` and the proxy is unreachable, retry directly against OpenAI using `openAIApiKey`.               |
+| `openAIApiKey` | `string or undefined` | `undefined` | OpenAI key used only for fail-open fallback. Falls back to `OPENAI_API_KEY` env var.                      |
+| `...rest`      |  any                  |     —       | All other `openai.ClientOptions` fields are forwarded to the underlying client.                           |
+
+### `Anthropic` (`TolvynAnthropicOptions`)
+
+Extends `@anthropic-ai/sdk` ClientOptions (omitting `apiKey` and `baseURL`).
+
+| Parameter        | Type                  | Default     | Description                                                                                                  |
+|------------------|-----------------------|-------------|--------------------------------------------------------------------------------------------------------------|
+| `tolvynApiKey`   | `string or undefined` | `undefined` | Your TOLVYN API key. Falls back to `TOLVYN_API_KEY` env var. Required.                                       |
+| `proxyUrl`       | `string or undefined` | `undefined` | TOLVYN proxy URL. Falls back to `TOLVYN_PROXY_URL` env var, then `http://localhost:8081/v1/proxy/anthropic`. |
+| `team`           | `string or undefined` | `undefined` | Team name for cost attribution.                                                                              |
+| `service`        | `string or undefined` | `undefined` | Service name.                                                                                                |
+| `feature`        | `string or undefined` | `undefined` | Feature name.                                                                                                |
+| `agent`          | `string or undefined` | `undefined` | Agent name.                                                                                                  |
+| `failOpen`       | `boolean`             | `true`      | If `true` and the proxy is unreachable, retry directly against Anthropic.                                    |
+| `anthropicApiKey`| `string or undefined` | `undefined` | Anthropic key used only for fail-open fallback. Falls back to `ANTHROPIC_API_KEY` env var.                   |
+| `...rest`        |  any                  |      —      | All other Anthropic ClientOptions fields are forwarded.                                                      |
+
+---
+
+## Tagging
+
+```typescript
+const client = new OpenAI({
+  tolvynApiKey: "tlv_live_...",
+  team: "search-team",         // Maps to a team in TOLVYN → budget applies
+  service: "semantic-search",  // Sub-component (e.g. microservice name)
+  feature: "query-expansion",  // Feature within the service
+  agent: "reranker-v2",        // Agent name for multi-agent pipelines
+});
+```
+
+All four tags are optional and independent. They appear in `tolvyn tail` output, the dashboard, and usage breakdown endpoints.
+
+---
+
+## Fail-open behaviour
+
+By default, `failOpen: true`. When the TOLVYN proxy is unreachable (connection refused, HTTP 503), the SDK retries the request directly against the AI provider using the fallback API key.
+
+A proxy outage **never breaks your application**. Requests that bypass the proxy are not metered; they appear in the provider's billing but not in TOLVYN.
+
+To hard-fail on proxy errors:
+
+```typescript
+const client = new OpenAI({ tolvynApiKey: "tlv_live_...", failOpen: false });
+```
+
+---
+
+## Imports
+
+### ESM
+
+```typescript
+import { OpenAI, Anthropic } from "tolvyn";
+import type { TolvynOpenAIOptions, TolvynAnthropicOptions } from "tolvyn";
+```
+
+### CommonJS
+
+```javascript
+const { OpenAI, Anthropic } = require("tolvyn");
+```
+
+Both ESM (`dist/esm/`) and CJS (`dist/cjs/`) builds are included.
+
+---
+
+## Environment variables
+
+| Variable            | Used by           | Description                          |
+|---------------------|-------------------|--------------------------------------|
+| `TOLVYN_API_KEY`    | All classes       | TOLVYN API key                       |
+| `TOLVYN_PROXY_URL`  | All classes       | Proxy URL override                   |
+| `OPENAI_API_KEY`    | OpenAI classes    | OpenAI key for fail-open fallback    |
+| `ANTHROPIC_API_KEY` | Anthropic classes | Anthropic key for fail-open fallback |
+
+---
+
+## Requirements
+
+- Node.js 18+
+- `openai >= 4.0.0` (peer dependency)
+- `@anthropic-ai/sdk >= 0.20.0` (peer dependency)
+- TypeScript 5.0+ (if using TypeScript)

package/dist/cjs/anthropic.d.ts

@@ -0,0 +1,20 @@
+/**
+ * TOLVYN Anthropic wrapper — thin drop-in over @anthropic-ai/sdk.
+ */
+import AnthropicBase, { ClientOptions } from '@anthropic-ai/sdk';
+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 declare class Anthropic extends AnthropicBase {
+    readonly _tolvynFailOpen: boolean;
+    readonly _tolvynFallbackKey: string | undefined;
+    constructor(options?: TolvynAnthropicOptions);
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/cjs/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/anthropic.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,aAAa,EAAE,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMjE,MAAM,WAAW,sBACf,SAAQ,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjD,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,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,SAAU,SAAQ,aAAa;IAC1C,SAAgB,eAAe,EAAE,OAAO,CAAC;IACzC,SAAgB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3C,OAAO,GAAE,sBAA2B;CA4CjD"}

package/dist/cjs/anthropic.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Anthropic = void 0;
+/**
+ * TOLVYN Anthropic wrapper — thin drop-in over @anthropic-ai/sdk.
+ */
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const failopen_1 = require("./failopen");
+const ANTHROPIC_DEFAULT_PROXY_URL = 'https://proxy.tolvyn.io/v1/proxy/anthropic/';
+const ANTHROPIC_DIRECT_URL = 'https://api.anthropic.com';
+class Anthropic extends sdk_1.default {
+    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'] ??
+            ANTHROPIC_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.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 = {
+            ...rest,
+            apiKey: tolvynApiKey,
+            baseURL: proxyUrl,
+            defaultHeaders,
+        };
+        if (failOpen && fallbackKey && !superOptions.fetch) {
+            superOptions.fetch = (0, failopen_1.makeFailOpenFetch)(fallbackKey, ANTHROPIC_DIRECT_URL, 'Anthropic');
+        }
+        super(superOptions);
+        this._tolvynFailOpen = failOpen;
+        this._tolvynFallbackKey = fallbackKey;
+    }
+}
+exports.Anthropic = Anthropic;
+//# sourceMappingURL=anthropic.js.map

package/dist/cjs/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/anthropic.ts"],"names":[],"mappings":";;;;;;AAAA;;GAEG;AACH,4DAAiE;AACjE,yCAA+C;AAE/C,MAAM,2BAA2B,GAAG,6CAA6C,CAAC;AAClF,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAczD,MAAa,SAAU,SAAQ,aAAa;IAI1C,YAAY,UAAkC,EAAE;QAC9C,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,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ;YAChB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;YAC/B,2BAA2B,CAAC;QAE9B,MAAM,cAAc,GAA2B,EAAE,CAAC;QAClD,IAAI,OAAO,CAAC,IAAI;YAAK,cAAc,CAAC,eAAe,CAAC,GAAM,OAAO,CAAC,IAAI,CAAC;QACvE,IAAI,OAAO,CAAC,OAAO;YAAE,cAAc,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;QAC1E,IAAI,OAAO,CAAC,OAAO;YAAE,cAAc,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;QAC1E,IAAI,OAAO,CAAC,KAAK;YAAI,cAAc,CAAC,gBAAgB,CAAC,GAAK,OAAO,CAAC,KAAK,CAAC;QAExE,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAChF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;QAE1C,MAAM,EACJ,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EACxD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAC5D,GAAG,IAAI,EACR,GAAG,OAAO,CAAC;QAEZ,MAAM,YAAY,GAAkB;YAClC,GAAG,IAAI;YACP,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,QAAQ;YACjB,cAAc;SACf,CAAC;QAEF,IAAI,QAAQ,IAAI,WAAW,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YACnD,YAAY,CAAC,KAAK,GAAG,IAAA,4BAAiB,EAAC,WAAW,EAAE,oBAAoB,EAAE,WAAW,CAAC,CAAC;QACzF,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,CAAC;QAEpB,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;QAChC,IAAI,CAAC,kBAAkB,GAAG,WAAW,CAAC;IACxC,CAAC;CACF;AAhDD,8BAgDC"}

package/dist/cjs/client.d.ts

@@ -0,0 +1,21 @@
+/**
+ * TOLVYN OpenAI wrapper — thin drop-in over the official openai package.
+ */
+import OpenAIBase, { ClientOptions } from 'openai';
+export interface TolvynOpenAIOptions extends Omit<ClientOptions, 'apiKey' | 'baseURL'> {
+    tolvynApiKey?: string;
+    proxyUrl?: string;
+    team?: string;
+    service?: string;
+    feature?: string;
+    agent?: string;
+    failOpen?: boolean;
+    openAIApiKey?: string;
+}
+export declare class OpenAI extends OpenAIBase {
+    readonly _tolvynFailOpen: boolean;
+    readonly _tolvynFallbackKey: string | undefined;
+    readonly _tolvynProxyUrl: string;
+    constructor(options?: TolvynOpenAIOptions);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/cjs/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,UAAU,EAAE,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAMnD,MAAM,WAAW,mBACf,SAAQ,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjD,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;AA6CD,qBAAa,MAAO,SAAQ,UAAU;IACpC,SAAgB,eAAe,EAAE,OAAO,CAAC;IACzC,SAAgB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IACvD,SAAgB,eAAe,EAAE,MAAM,CAAC;gBAE5B,OAAO,GAAE,mBAAwB;CA6C9C"}

package/dist/cjs/client.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAI = void 0;
+/**
+ * TOLVYN OpenAI wrapper — thin drop-in over the official openai package.
+ */
+const openai_1 = __importDefault(require("openai"));
+const failopen_1 = require("./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 ((0, failopen_1.shouldNotFailOpen)(err) || !(0, failopen_1.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);
+        }
+    };
+}
+class OpenAI extends openai_1.default {
+    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;
+    }
+}
+exports.OpenAI = OpenAI;
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

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

package/dist/cjs/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/cjs/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/cjs/failopen.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Fail-open helpers: detect proxy unreachability and retry direct.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isProxyError = isProxyError;
+exports.shouldNotFailOpen = shouldNotFailOpen;
+exports.makeFailOpenFetch = makeFailOpenFetch;
+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;
+}
+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;
+}
+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/cjs/failopen.js.map

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

package/dist/cjs/index.d.ts

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

package/dist/cjs/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"}

package/dist/cjs/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Anthropic = exports.OpenAI = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "OpenAI", { enumerable: true, get: function () { return client_1.OpenAI; } });
+var anthropic_1 = require("./anthropic");
+Object.defineProperty(exports, "Anthropic", { enumerable: true, get: function () { return anthropic_1.Anthropic; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AAEf,yCAAwC;AAA/B,sGAAA,SAAS,OAAA"}

package/dist/esm/anthropic.d.ts

@@ -0,0 +1,20 @@
+/**
+ * TOLVYN Anthropic wrapper — thin drop-in over @anthropic-ai/sdk.
+ */
+import AnthropicBase, { ClientOptions } from '@anthropic-ai/sdk';
+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 declare class Anthropic extends AnthropicBase {
+    readonly _tolvynFailOpen: boolean;
+    readonly _tolvynFallbackKey: string | undefined;
+    constructor(options?: TolvynAnthropicOptions);
+}
+//# sourceMappingURL=anthropic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/anthropic.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,aAAa,EAAE,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMjE,MAAM,WAAW,sBACf,SAAQ,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjD,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,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,SAAU,SAAQ,aAAa;IAC1C,SAAgB,eAAe,EAAE,OAAO,CAAC;IACzC,SAAgB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3C,OAAO,GAAE,sBAA2B;CA4CjD"}

package/dist/esm/anthropic.js

@@ -0,0 +1,43 @@
+/**
+ * TOLVYN Anthropic wrapper — thin drop-in over @anthropic-ai/sdk.
+ */
+import AnthropicBase 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 class Anthropic extends AnthropicBase {
+    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'] ??
+            ANTHROPIC_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.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 = {
+            ...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;
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/esm/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/anthropic.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,aAAgC,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,2BAA2B,GAAG,6CAA6C,CAAC;AAClF,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAczD,MAAM,OAAO,SAAU,SAAQ,aAAa;IAI1C,YAAY,UAAkC,EAAE;QAC9C,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,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ;YAChB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;YAC/B,2BAA2B,CAAC;QAE9B,MAAM,cAAc,GAA2B,EAAE,CAAC;QAClD,IAAI,OAAO,CAAC,IAAI;YAAK,cAAc,CAAC,eAAe,CAAC,GAAM,OAAO,CAAC,IAAI,CAAC;QACvE,IAAI,OAAO,CAAC,OAAO;YAAE,cAAc,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;QAC1E,IAAI,OAAO,CAAC,OAAO;YAAE,cAAc,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;QAC1E,IAAI,OAAO,CAAC,KAAK;YAAI,cAAc,CAAC,gBAAgB,CAAC,GAAK,OAAO,CAAC,KAAK,CAAC;QAExE,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAChF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;QAE1C,MAAM,EACJ,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EACxD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAC5D,GAAG,IAAI,EACR,GAAG,OAAO,CAAC;QAEZ,MAAM,YAAY,GAAkB;YAClC,GAAG,IAAI;YACP,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,QAAQ;YACjB,cAAc;SACf,CAAC;QAEF,IAAI,QAAQ,IAAI,WAAW,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YACnD,YAAY,CAAC,KAAK,GAAG,iBAAiB,CAAC,WAAW,EAAE,oBAAoB,EAAE,WAAW,CAAC,CAAC;QACzF,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,CAAC;QAEpB,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;QAChC,IAAI,CAAC,kBAAkB,GAAG,WAAW,CAAC;IACxC,CAAC;CACF"}

package/dist/esm/client.d.ts

@@ -0,0 +1,21 @@
+/**
+ * TOLVYN OpenAI wrapper — thin drop-in over the official openai package.
+ */
+import OpenAIBase, { ClientOptions } from 'openai';
+export interface TolvynOpenAIOptions extends Omit<ClientOptions, 'apiKey' | 'baseURL'> {
+    tolvynApiKey?: string;
+    proxyUrl?: string;
+    team?: string;
+    service?: string;
+    feature?: string;
+    agent?: string;
+    failOpen?: boolean;
+    openAIApiKey?: string;
+}
+export declare class OpenAI extends OpenAIBase {
+    readonly _tolvynFailOpen: boolean;
+    readonly _tolvynFallbackKey: string | undefined;
+    readonly _tolvynProxyUrl: string;
+    constructor(options?: TolvynOpenAIOptions);
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,UAAU,EAAE,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAMnD,MAAM,WAAW,mBACf,SAAQ,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjD,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;AA6CD,qBAAa,MAAO,SAAQ,UAAU;IACpC,SAAgB,eAAe,EAAE,OAAO,CAAC;IACzC,SAAgB,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IACvD,SAAgB,eAAe,EAAE,MAAM,CAAC;gBAE5B,OAAO,GAAE,mBAAwB;CA6C9C"}

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/index.d.ts

@@ -0,0 +1,5 @@
+export { OpenAI } from './client';
+export type { TolvynOpenAIOptions } from './client';
+export { Anthropic } from './anthropic';
+export type { TolvynAnthropicOptions } from './anthropic';
+//# 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"}

package/dist/esm/index.js

@@ -0,0 +1,3 @@
+export { OpenAI } from './client';
+export { Anthropic } from './anthropic';
+//# 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"}

package/package.json

@@ -1,13 +1,46 @@
 {
   "name": "tolvyn",
-  "version": "1.0.1",
-  "description": "",
-  "main": "index.js",
+  "version": "1.0.2",
+  "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",
+    "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);
+    }
+  };
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { OpenAI } from './client';
+export type { TolvynOpenAIOptions } from './client';
+export { Anthropic } from './anthropic';
+export type { TolvynAnthropicOptions } from './anthropic';

package/index.js

@@ -1 +0,0 @@
-console.log("TOLVYN SDK coming soon");