@tensorcost/sdk 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,79 @@
 # Changelog
 
+## 0.4.0 — 2026-05-13
+
+Applied-mode hardening. Five new subsystems sit between `wrap()` and the
+proxy POST; all are opt-in with safe defaults and zero impact on the
+observe-only path.
+
+### Added
+
+**Typed error hierarchy** — every failure from the proxy path is a subclass of
+`TensorCostError`. Customer code can `instanceof`-branch without importing raw
+HTTP exception types.
+
+- `TensorCostError` (base)
+- `TensorCostNetworkError` — could not reach the proxy at all
+- `TensorCostTimeoutError` — wall-clock or idle timeout fired; carries `timeoutKind: "total" | "idle"`
+- `TensorCostProxyError` — proxy returned 5xx
+- `TensorCostQuotaError` — proxy returned 429; carries `retryAfterMs`
+- `TensorCostProviderError` — proxy forwarded a 4xx from the upstream AI provider
+
+All carry `status`, `requestId`, `attempt`, and `rootCause` (avoiding the clash
+with ES2022 `Error.cause`).
+
+**Retries with jittered exponential backoff** — configurable via `RetryConfig`:
+
+```ts
+const client = wrap(new OpenAI(...), {
+  retry: { maxAttempts: 5, baseDelayMs: 500, maxDelayMs: 30_000 },
+});
+```
+
+Retry rules: 5xx + network errors + 429 always retry; 4xx (except 429) never
+retry; 429 with a `Retry-After` header uses that value, capped at `maxDelayMs`.
+
+**Request timeouts** — non-streaming proxy calls have a 60-second default total
+timeout, controllable via `timeoutMs`. Surfaces as `TensorCostTimeoutError`.
+
+```ts
+const client = wrap(new OpenAI(...), { timeoutMs: 30_000 });
+```
+
+**Lifecycle telemetry hooks** — optional `onLifecycleEvent` callback fires on
+each stage. Events contain only request metadata — never prompt content or
+credentials:
+
+```ts
+const client = wrap(new OpenAI(...), {
+  onLifecycleEvent(event) {
+    console.log(event.kind, event.model, event.attemptNumber);
+  },
+});
+```
+
+Five event kinds: `before_request`, `after_response`, `on_retry`, `on_error`,
+`on_fallback`. Errors in the callback are swallowed.
+
+**Fail-open circuit breaker** — after 3 consecutive proxy 5xx responses the
+circuit opens and all requests route directly to the provider. Closes again
+after 5 consecutive probe successes. Controlled by `failOpenEnabled` (default
+`true`):
+
+```ts
+// In-VPC: no direct provider access — raise on proxy failure instead of
+// falling back.
+const client = wrap(new OpenAI(...), { failOpenEnabled: false });
+```
+
+When `failOpenEnabled: true` (default) and the circuit is open, an
+`on_fallback` lifecycle event fires before the direct-provider call.
+
+### No breaking changes
+
+All new options default to values that preserve 0.3.x behaviour.
+`appliedMode` still defaults to `false`; the observe-only path is unchanged.
+
 ## 0.3.0 — 2026-05-12
 
 - Added: `appliedMode` config flag. When true and `proxyUrl` (or `TENSORCOST_PROXY_URL`) is set, requests route through the TensorCost inference-proxy. See `docs/features/inference-proxy-applied-mode.md`.

package/README.md

@@ -88,6 +88,94 @@ const resp = await client.chat.completions.create({
 
 See [`docs/features/inference-proxy-applied-mode.md`](../../docs/features/inference-proxy-applied-mode.md) for the proxy-side design.
 
+## Applied-mode hardening (v0.4.0)
+
+When `appliedMode: true`, you can configure retry policy, timeouts, lifecycle hooks, and the fail-open circuit breaker.
+
+### Retries
+
+```ts
+import { wrap, RetryConfig } from "@tensorcost/sdk";
+
+const client = wrap(new OpenAI(...), {
+  appliedMode: true,
+  proxyUrl: "...",
+  retry: { maxAttempts: 5, baseDelayMs: 500, maxDelayMs: 30_000 },
+});
+```
+
+5xx responses, network errors, and 429 are retried with jittered exponential backoff. A `Retry-After` header on 429 is honoured. 4xx errors (except 429) are never retried.
+
+### Timeouts
+
+```ts
+const client = wrap(new OpenAI(...), {
+  appliedMode: true,
+  proxyUrl: "...",
+  timeoutMs: 30_000, // 30 seconds; default 60_000
+});
+```
+
+Surfaces as `TensorCostTimeoutError` (with `timeoutKind: "total"`) when exceeded.
+
+### Lifecycle telemetry hooks
+
+```ts
+import { wrap, LifecycleEvent } from "@tensorcost/sdk";
+
+const client = wrap(new OpenAI(...), {
+  appliedMode: true,
+  proxyUrl: "...",
+  onLifecycleEvent(event: LifecycleEvent) {
+    // event.kind is one of:
+    //   "before_request" | "after_response" | "on_retry"
+    //   | "on_error" | "on_fallback"
+    console.log(event.kind, event.model, event.attemptNumber);
+  },
+});
+```
+
+Events contain only request metadata — never prompt content, response bodies, or credentials. Errors thrown by the callback are swallowed.
+
+### Typed errors
+
+Every failure from the proxy path is a subclass of `TensorCostError`. Import the classes from `@tensorcost/sdk`:
+
+```ts
+import {
+  TensorCostError,
+  TensorCostNetworkError,
+  TensorCostTimeoutError,
+  TensorCostProxyError,
+  TensorCostQuotaError,
+  TensorCostProviderError,
+} from "@tensorcost/sdk";
+
+try {
+  await client.chat.completions.create({ model: "gpt-4o-mini", messages: [] });
+} catch (err) {
+  if (err instanceof TensorCostQuotaError) {
+    console.log("rate limited; retry after", err.retryAfterMs, "ms");
+  } else if (err instanceof TensorCostError) {
+    console.log("tensorcost error", err.status, err.attempt);
+  }
+}
+```
+
+### Circuit breaker
+
+After 3 consecutive proxy 5xx responses the circuit opens and requests route directly to the provider (fail-open). The circuit closes after 5 consecutive probe successes.
+
+Set `failOpenEnabled: false` if direct provider access is unavailable (e.g. in-VPC deployments) — proxy failures then surface as `TensorCostProxyError` instead of falling back.
+
+```ts
+const client = wrap(new OpenAI(...), {
+  appliedMode: true,
+  proxyUrl: "...",
+  failOpenEnabled: false, // raise on proxy error instead of falling through
+});
+```
+
 ## Fail-open guarantee
 
 If TensorCost is slow, down, or misconfigured, your customer call STILL succeeds. The SDK swallows internal errors and surfaces them via `console.warn`. The one exception: a missing API key throws `MissingConfigError` at `wrap()` time — silently dropping every observation would be worse than a loud import-time failure.
@@ -116,4 +204,4 @@ Only metadata — never prompt or completion content:
 
 ## License
 
-Proprietary — Vaadh Labs / TensorCost.
+Proprietary — TensorCost.

package/dist/circuit.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Circuit breaker for the fail-open fallback (Feature E).
+ *
+ * Tracks consecutive proxy failures. When the failure count hits
+ * `openThreshold`, the circuit opens and all subsequent requests route
+ * directly to the provider instead of through the proxy. The circuit
+ * moves back to closed once `closeThreshold` consecutive probe calls
+ * (which go through the proxy) succeed.
+ *
+ * State machine:
+ *
+ *   CLOSED ──(failures >= openThreshold)──> OPEN
+ *   OPEN   ──(next call, always probes)───> HALF_OPEN
+ *   HALF_OPEN ──(proxy 2xx)──────────────> probeSuccesses++
+ *              ──(proxy 5xx/err)──────────> back to OPEN (resets probes)
+ *   HALF_OPEN ──(probeSuccesses >= closeThreshold)──> CLOSED
+ *
+ * This is intentionally simple and synchronous — the circuit lives on the
+ * SDK client instance and is not shared across network calls.
+ */
+export type CircuitState = "CLOSED" | "OPEN" | "HALF_OPEN";
+export interface CircuitBreakerConfig {
+    /** Number of consecutive proxy failures before the circuit opens. Default: 3. */
+    openThreshold: number;
+    /** Number of consecutive successful probes before the circuit closes. Default: 5. */
+    closeThreshold: number;
+}
+export declare const DEFAULT_CIRCUIT_CONFIG: CircuitBreakerConfig;
+export declare class CircuitBreaker {
+    private state;
+    private consecutiveFailures;
+    private probeSuccesses;
+    readonly config: CircuitBreakerConfig;
+    constructor(config?: CircuitBreakerConfig);
+    /** Current circuit state. */
+    get currentState(): CircuitState;
+    /** How many consecutive failures have been recorded. */
+    get failures(): number;
+    /**
+     * Returns true when calls should bypass the proxy and go directly to the
+     * provider. The caller must always call `recordSuccess` or `recordFailure`
+     * afterwards to keep the state machine moving.
+     */
+    shouldBypass(): boolean;
+    /**
+     * Returns true when the next call should be a probe (the circuit is
+     * OPEN and we are transitioning to HALF_OPEN to test the proxy).
+     */
+    shouldProbe(): boolean;
+    /** Call after a proxy request succeeds. */
+    recordSuccess(): void;
+    /** Call after a proxy request fails (5xx or network error). */
+    recordFailure(): void;
+    private reset;
+}
+//# sourceMappingURL=circuit.d.ts.map

package/dist/circuit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit.d.ts","sourceRoot":"","sources":["../src/circuit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,sBAAsB,EAAE,oBAGpC,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,cAAc,CAAK;IAC3B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;gBAE1B,MAAM,GAAE,oBAA6C;IAIjE,6BAA6B;IAC7B,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED,wDAAwD;IACxD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;OAIG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,WAAW,IAAI,OAAO;IAStB,2CAA2C;IAC3C,aAAa,IAAI,IAAI;IAWrB,+DAA+D;IAC/D,aAAa,IAAI,IAAI;IAcrB,OAAO,CAAC,KAAK;CAKd"}

package/dist/circuit.js

@@ -0,0 +1,93 @@
+/**
+ * Circuit breaker for the fail-open fallback (Feature E).
+ *
+ * Tracks consecutive proxy failures. When the failure count hits
+ * `openThreshold`, the circuit opens and all subsequent requests route
+ * directly to the provider instead of through the proxy. The circuit
+ * moves back to closed once `closeThreshold` consecutive probe calls
+ * (which go through the proxy) succeed.
+ *
+ * State machine:
+ *
+ *   CLOSED ──(failures >= openThreshold)──> OPEN
+ *   OPEN   ──(next call, always probes)───> HALF_OPEN
+ *   HALF_OPEN ──(proxy 2xx)──────────────> probeSuccesses++
+ *              ──(proxy 5xx/err)──────────> back to OPEN (resets probes)
+ *   HALF_OPEN ──(probeSuccesses >= closeThreshold)──> CLOSED
+ *
+ * This is intentionally simple and synchronous — the circuit lives on the
+ * SDK client instance and is not shared across network calls.
+ */
+export const DEFAULT_CIRCUIT_CONFIG = {
+    openThreshold: 3,
+    closeThreshold: 5,
+};
+export class CircuitBreaker {
+    constructor(config = DEFAULT_CIRCUIT_CONFIG) {
+        this.state = "CLOSED";
+        this.consecutiveFailures = 0;
+        this.probeSuccesses = 0;
+        this.config = config;
+    }
+    /** Current circuit state. */
+    get currentState() {
+        return this.state;
+    }
+    /** How many consecutive failures have been recorded. */
+    get failures() {
+        return this.consecutiveFailures;
+    }
+    /**
+     * Returns true when calls should bypass the proxy and go directly to the
+     * provider. The caller must always call `recordSuccess` or `recordFailure`
+     * afterwards to keep the state machine moving.
+     */
+    shouldBypass() {
+        return this.state === "OPEN";
+    }
+    /**
+     * Returns true when the next call should be a probe (the circuit is
+     * OPEN and we are transitioning to HALF_OPEN to test the proxy).
+     */
+    shouldProbe() {
+        if (this.state === "OPEN") {
+            // Transition to HALF_OPEN for the probe attempt.
+            this.state = "HALF_OPEN";
+            return true;
+        }
+        return false;
+    }
+    /** Call after a proxy request succeeds. */
+    recordSuccess() {
+        if (this.state === "HALF_OPEN") {
+            this.probeSuccesses += 1;
+            if (this.probeSuccesses >= this.config.closeThreshold) {
+                this.reset();
+            }
+        }
+        else if (this.state === "CLOSED") {
+            this.consecutiveFailures = 0;
+        }
+    }
+    /** Call after a proxy request fails (5xx or network error). */
+    recordFailure() {
+        if (this.state === "HALF_OPEN") {
+            // Probe failed — go back to fully open.
+            this.state = "OPEN";
+            this.probeSuccesses = 0;
+        }
+        else if (this.state === "CLOSED") {
+            this.consecutiveFailures += 1;
+            if (this.consecutiveFailures >= this.config.openThreshold) {
+                this.state = "OPEN";
+            }
+        }
+        // OPEN + another failure: stay open, no state change needed.
+    }
+    reset() {
+        this.state = "CLOSED";
+        this.consecutiveFailures = 0;
+        this.probeSuccesses = 0;
+    }
+}
+//# sourceMappingURL=circuit.js.map

package/dist/circuit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit.js","sourceRoot":"","sources":["../src/circuit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAWH,MAAM,CAAC,MAAM,sBAAsB,GAAyB;IAC1D,aAAa,EAAE,CAAC;IAChB,cAAc,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,OAAO,cAAc;IAMzB,YAAY,SAA+B,sBAAsB;QALzD,UAAK,GAAiB,QAAQ,CAAC;QAC/B,wBAAmB,GAAG,CAAC,CAAC;QACxB,mBAAc,GAAG,CAAC,CAAC;QAIzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,6BAA6B;IAC7B,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,wDAAwD;IACxD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1B,iDAAiD;YACjD,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2CAA2C;IAC3C,aAAa;QACX,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;YACzB,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBACtD,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,aAAa;QACX,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC/B,wCAAwC;YACxC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACpB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QAC1B,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnC,IAAI,CAAC,mBAAmB,IAAI,CAAC,CAAC;YAC9B,IAAI,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;gBAC1D,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACtB,CAAC;QACH,CAAC;QACD,6DAA6D;IAC/D,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QACtB,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAE7D,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,yEAAyE;AACzE,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,WAAgB,GAAG,cAAc,CAsEvE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9D,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAE7D,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,yEAAyE;AACzE,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,WAAgB,GAAG,cAAc,CAuFvE"}

package/dist/config.js

@@ -16,6 +16,7 @@
  * TensorCostConfigError is thrown. Applied mode needs an explicit proxy
  * URL; there is no safe default.
  */
+import { DEFAULT_RETRY_CONFIG } from "./retry.js";
 export const DEFAULT_BASE_URL = "https://api.tensorcost.com";
 export class MissingConfigError extends Error {
     constructor(message) {
@@ -72,6 +73,16 @@ export function resolveConfig(options = {}) {
             "Pass { proxyUrl } to wrap() or set the TENSORCOST_PROXY_URL " +
             "environment variable.");
     }
+    // Hardening defaults.
+    const retry = {
+        ...DEFAULT_RETRY_CONFIG,
+        ...options.retry,
+    };
+    const timeoutMs = options.timeoutMs ?? 60_000;
+    const idleTimeoutMs = options.idleTimeoutMs ?? 30_000;
+    const onLifecycleEvent = options.onLifecycleEvent;
+    const failOpenEnabled = options.failOpenEnabled ?? true;
+    const providerApiKey = options.providerApiKey ?? null;
     return {
         apiKey,
         baseUrl: baseUrlRaw.replace(/\/+$/, ""),
@@ -81,6 +92,12 @@ export function resolveConfig(options = {}) {
         failOpen,
         appliedMode,
         proxyUrl,
+        retry,
+        timeoutMs,
+        idleTimeoutMs,
+        onLifecycleEvent,
+        failOpenEnabled,
+        providerApiKey,
     };
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Typed error hierarchy for the TensorCost Node SDK.
+ *
+ * Every error thrown by the SDK's applied-mode request path is one of
+ * these classes. Customer code can `instanceof`-branch on any of them
+ * without importing raw Error types from the underlying http layer.
+ *
+ * Hierarchy:
+ *
+ *   TensorCostError (base)
+ *   ├── TensorCostNetworkError    couldn't reach the proxy at all
+ *   ├── TensorCostTimeoutError    request or idle window exceeded limit
+ *   ├── TensorCostProxyError      proxy responded with 5xx
+ *   ├── TensorCostQuotaError      proxy responded with 429
+ *   └── TensorCostProviderError   proxy forwarded an upstream provider error
+ *
+ * All subclasses carry:
+ *   - `rootCause`   the underlying Error, if any (avoids clash with ES2022 Error.cause)
+ *   - `status`      HTTP status code (null when the request never completed)
+ *   - `requestId`   value of the X-TC-Request-ID header the proxy stamps
+ *   - `attempt`     1-based attempt number at the time the error occurred
+ */
+export interface TensorCostErrorOptions {
+    cause?: Error;
+    status?: number | null;
+    requestId?: string | null;
+    attempt?: number;
+}
+export declare abstract class TensorCostError extends Error {
+    /** The underlying Error that triggered this one, if any. */
+    readonly rootCause: Error | undefined;
+    readonly status: number | null;
+    readonly requestId: string | null;
+    readonly attempt: number;
+    constructor(message: string, opts?: TensorCostErrorOptions);
+}
+/** The SDK could not establish a connection to the proxy at all. */
+export declare class TensorCostNetworkError extends TensorCostError {
+    constructor(message: string, opts?: TensorCostErrorOptions);
+}
+/** A request or idle-window timeout fired before the operation completed. */
+export declare class TensorCostTimeoutError extends TensorCostError {
+    /** "total" — wall-clock limit exceeded; "idle" — no bytes for N seconds. */
+    readonly timeoutKind: "total" | "idle";
+    constructor(message: string, timeoutKind: "total" | "idle", opts?: TensorCostErrorOptions);
+}
+/** The proxy returned a 5xx response (TensorCost's own infrastructure error). */
+export declare class TensorCostProxyError extends TensorCostError {
+    constructor(message: string, opts?: TensorCostErrorOptions);
+}
+/**
+ * The proxy returned 429 Too Many Requests.
+ * `retryAfterMs` is set when the response included a `Retry-After` header.
+ */
+export declare class TensorCostQuotaError extends TensorCostError {
+    readonly retryAfterMs: number | null;
+    constructor(message: string, retryAfterMs: number | null, opts?: TensorCostErrorOptions);
+}
+/**
+ * The proxy successfully reached the upstream provider, but the provider
+ * itself returned an error (4xx/5xx from OpenAI, Anthropic, etc.). The
+ * proxy's response still carries the provider's status in `status`.
+ */
+export declare class TensorCostProviderError extends TensorCostError {
+    constructor(message: string, opts?: TensorCostErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8BAAsB,eAAgB,SAAQ,KAAK;IACjD,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B;CAqB/D;AAED,oEAAoE;AACpE,qBAAa,sBAAuB,SAAQ,eAAe;gBAC7C,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B;CAG/D;AAED,6EAA6E;AAC7E,qBAAa,sBAAuB,SAAQ,eAAe;IACzD,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC;gBAGrC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,OAAO,GAAG,MAAM,EAC7B,IAAI,GAAE,sBAA2B;CAKpC;AAED,iFAAiF;AACjF,qBAAa,oBAAqB,SAAQ,eAAe;gBAC3C,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B;CAG/D;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGnC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,IAAI,GAAE,sBAA2B;CAKpC;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B;CAG/D"}

package/dist/errors.js

@@ -0,0 +1,84 @@
+/**
+ * Typed error hierarchy for the TensorCost Node SDK.
+ *
+ * Every error thrown by the SDK's applied-mode request path is one of
+ * these classes. Customer code can `instanceof`-branch on any of them
+ * without importing raw Error types from the underlying http layer.
+ *
+ * Hierarchy:
+ *
+ *   TensorCostError (base)
+ *   ├── TensorCostNetworkError    couldn't reach the proxy at all
+ *   ├── TensorCostTimeoutError    request or idle window exceeded limit
+ *   ├── TensorCostProxyError      proxy responded with 5xx
+ *   ├── TensorCostQuotaError      proxy responded with 429
+ *   └── TensorCostProviderError   proxy forwarded an upstream provider error
+ *
+ * All subclasses carry:
+ *   - `rootCause`   the underlying Error, if any (avoids clash with ES2022 Error.cause)
+ *   - `status`      HTTP status code (null when the request never completed)
+ *   - `requestId`   value of the X-TC-Request-ID header the proxy stamps
+ *   - `attempt`     1-based attempt number at the time the error occurred
+ */
+export class TensorCostError extends Error {
+    constructor(message, opts = {}) {
+        super(message);
+        // noImplicitOverride requires `override` for inherited props.
+        // We set name on the *instance* without re-declaring the property type,
+        // which is the correct approach for custom Error subclasses in strict TS.
+        Object.defineProperty(this, "name", {
+            value: this.constructor.name,
+            writable: true,
+            enumerable: false,
+            configurable: true,
+        });
+        this.rootCause = opts.cause;
+        this.status = opts.status ?? null;
+        this.requestId = opts.requestId ?? null;
+        this.attempt = opts.attempt ?? 1;
+        // Keep stack traces clean in V8 environments.
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+/** The SDK could not establish a connection to the proxy at all. */
+export class TensorCostNetworkError extends TensorCostError {
+    constructor(message, opts = {}) {
+        super(message, opts);
+    }
+}
+/** A request or idle-window timeout fired before the operation completed. */
+export class TensorCostTimeoutError extends TensorCostError {
+    constructor(message, timeoutKind, opts = {}) {
+        super(message, opts);
+        this.timeoutKind = timeoutKind;
+    }
+}
+/** The proxy returned a 5xx response (TensorCost's own infrastructure error). */
+export class TensorCostProxyError extends TensorCostError {
+    constructor(message, opts = {}) {
+        super(message, opts);
+    }
+}
+/**
+ * The proxy returned 429 Too Many Requests.
+ * `retryAfterMs` is set when the response included a `Retry-After` header.
+ */
+export class TensorCostQuotaError extends TensorCostError {
+    constructor(message, retryAfterMs, opts = {}) {
+        super(message, { ...opts, status: opts.status ?? 429 });
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+/**
+ * The proxy successfully reached the upstream provider, but the provider
+ * itself returned an error (4xx/5xx from OpenAI, Anthropic, etc.). The
+ * proxy's response still carries the provider's status in `status`.
+ */
+export class TensorCostProviderError extends TensorCostError {
+    constructor(message, opts = {}) {
+        super(message, opts);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,MAAM,OAAgB,eAAgB,SAAQ,KAAK;IAOjD,YAAY,OAAe,EAAE,OAA+B,EAAE;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,8DAA8D;QAC9D,wEAAwE;QACxE,0EAA0E;QAC1E,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE;YAClC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YAC5B,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAEjC,8CAA8C;QAC9C,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,OAAO,sBAAuB,SAAQ,eAAe;IACzD,YAAY,OAAe,EAAE,OAA+B,EAAE;QAC5D,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;CACF;AAED,6EAA6E;AAC7E,MAAM,OAAO,sBAAuB,SAAQ,eAAe;IAIzD,YACE,OAAe,EACf,WAA6B,EAC7B,OAA+B,EAAE;QAEjC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IACvD,YAAY,OAAe,EAAE,OAA+B,EAAE;QAC5D,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IAGvD,YACE,OAAe,EACf,YAA2B,EAC3B,OAA+B,EAAE;QAEjC,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,YAAY,OAAe,EAAE,OAA+B,EAAE;QAC5D,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 export { wrap } from "./wrap.js";
 export { MissingConfigError, TensorCostConfigError } from "./config.js";
 export { UnsupportedClientError } from "./providers/detect.js";
+export { TensorCostError, TensorCostNetworkError, TensorCostTimeoutError, TensorCostProxyError, TensorCostQuotaError, TensorCostProviderError, } from "./errors.js";
+export type { LifecycleEvent, BeforeRequestEvent, AfterResponseEvent, OnRetryEvent, OnErrorEvent, OnFallbackEvent, LifecycleEventCallback, } from "./telemetry.js";
+export type { RetryConfig } from "./retry.js";
 export type { WrapOptions, Observation, Provider } from "./types.js";
-export declare const version = "0.3.0";
+export declare const version = "0.4.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErE,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErE,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { wrap } from "./wrap.js";
 export { MissingConfigError, TensorCostConfigError } from "./config.js";
 export { UnsupportedClientError } from "./providers/detect.js";
-export const version = "0.3.0";
+export { TensorCostError, TensorCostNetworkError, TensorCostTimeoutError, TensorCostProxyError, TensorCostQuotaError, TensorCostProviderError, } from "./errors.js";
+export const version = "0.4.0";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAarB,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/providers/anthropic.d.ts

@@ -4,9 +4,25 @@
  * Intercepts `client.messages.create`. Same observation contract as the
  * OpenAI wrapper — only metadata is captured (model, input/output tokens),
  * never the message content itself.
+ *
+ * Applied-mode hardening (v0.4.0): messages.create routes through the
+ * proxy-client module, which handles retries, timeouts, typed errors,
+ * telemetry hooks, and the fail-open circuit breaker.
  */
 import type { ObservationTransport } from "../transport.js";
-export declare function install(client: unknown, transport: ObservationTransport, tenantId: string | null, environment: string | null, connectionId: string | null): void;
+import type { CircuitBreaker } from "../circuit.js";
+import type { LifecycleEventCallback } from "../telemetry.js";
+import type { RetryConfig } from "../retry.js";
+export interface AppliedModeHardeningOpts {
+    appliedMode: boolean;
+    proxyUrl: string | null;
+    retry: RetryConfig;
+    timeoutMs: number;
+    onLifecycleEvent: LifecycleEventCallback | undefined;
+    failOpenEnabled: boolean;
+    circuit: CircuitBreaker;
+}
+export declare function install(client: unknown, transport: ObservationTransport, tenantId: string | null, environment: string | null, connectionId: string | null, hardening: AppliedModeHardeningOpts): void;
 export declare const __test__: {
     MARKER: string;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AA8G5D,wBAAgB,OAAO,CACrB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,oBAAoB,EAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,IAAI,CAkBN;AAED,eAAO,MAAM,QAAQ;;CAAa,CAAC"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACrD,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;CACzB;AA6PD,wBAAgB,OAAO,CACrB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,oBAAoB,EAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,SAAS,EAAE,wBAAwB,GAClC,IAAI,CAoBN;AAED,eAAO,MAAM,QAAQ;;CAAa,CAAC"}