@tensorcost/sdk 0.3.0

package/dist/config.d.ts.map

@@ -0,0 +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"}

package/dist/config.js

@@ -0,0 +1,86 @@
+/**
+ * Configuration resolution for the SDK.
+ *
+ * Resolution order:
+ *   1. Explicit options to wrap()
+ *   2. Environment variables (TENSORCOST_API_KEY, TENSORCOST_BASE_URL,
+ *      TENSORCOST_TENANT_ID, TENSORCOST_PROXY_URL)
+ *   3. Defaults (only for baseUrl)
+ *
+ * If apiKey is still missing after resolution, MissingConfigError is
+ * raised. This is the *one* case the SDK does not fail open — it means
+ * the SDK was never configured at all, and silently dropping every
+ * observation would be worse than a loud import-time failure.
+ *
+ * If appliedMode=true and proxyUrl is missing from both options and env,
+ * TensorCostConfigError is thrown. Applied mode needs an explicit proxy
+ * URL; there is no safe default.
+ */
+export const DEFAULT_BASE_URL = "https://api.tensorcost.com";
+export class MissingConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MissingConfigError";
+    }
+}
+/** Thrown when applied mode is enabled but required config is absent. */
+export class TensorCostConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TensorCostConfigError";
+    }
+}
+export function resolveConfig(options = {}) {
+    const apiKey = options.apiKey ?? process.env.TENSORCOST_API_KEY ?? "";
+    const baseUrlRaw = options.baseUrl ?? process.env.TENSORCOST_BASE_URL ?? DEFAULT_BASE_URL;
+    const tenantId = options.tenantId ?? process.env.TENSORCOST_TENANT_ID ?? null;
+    // Phase A4 batch 3 — environment tag. Trimmed; capped at 64 chars per
+    // project_environment_scoping.md. An empty / whitespace-only value
+    // collapses to null so the SDK omits the field from the envelope and
+    // the backend's column default ('production') applies.
+    const environmentRaw = options.environment ?? process.env.TENSORCOST_ENVIRONMENT ?? null;
+    let environment = null;
+    if (environmentRaw !== null) {
+        const trimmed = String(environmentRaw).trim();
+        if (trimmed.length > 64) {
+            throw new MissingConfigError("TensorCost environment must be 64 characters or fewer.");
+        }
+        environment = trimmed.length === 0 ? null : trimmed;
+    }
+    // Phase A4 batch 4 — provider-connection id. Same trim+cap rules as
+    // environment; collapsing blank to null so the SDK omits the field
+    // when not configured.
+    const connectionIdRaw = options.connectionId ?? process.env.TENSORCOST_CONNECTION_ID ?? null;
+    let connectionId = null;
+    if (connectionIdRaw !== null) {
+        const trimmed = String(connectionIdRaw).trim();
+        if (trimmed.length > 64) {
+            throw new MissingConfigError("TensorCost connectionId must be 64 characters or fewer.");
+        }
+        connectionId = trimmed.length === 0 ? null : trimmed;
+    }
+    const failOpen = options.failOpen ?? true;
+    const appliedMode = options.appliedMode ?? false;
+    const proxyUrlRaw = options.proxyUrl ?? process.env.TENSORCOST_PROXY_URL ?? null;
+    const proxyUrl = proxyUrlRaw !== null ? proxyUrlRaw.replace(/\/+$/, "") : null;
+    if (!apiKey) {
+        throw new MissingConfigError("TensorCost apiKey not found. Pass { apiKey } to wrap() or set the " +
+            "TENSORCOST_API_KEY environment variable.");
+    }
+    if (appliedMode && !proxyUrl) {
+        throw new TensorCostConfigError("TensorCost applied mode is enabled but no proxy URL was provided. " +
+            "Pass { proxyUrl } to wrap() or set the TENSORCOST_PROXY_URL " +
+            "environment variable.");
+    }
+    return {
+        apiKey,
+        baseUrl: baseUrlRaw.replace(/\/+$/, ""),
+        tenantId: tenantId || null,
+        environment,
+        connectionId,
+        failOpen,
+        appliedMode,
+        proxyUrl,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { wrap } from "./wrap.js";
+export { MissingConfigError, TensorCostConfigError } from "./config.js";
+export { UnsupportedClientError } from "./providers/detect.js";
+export type { WrapOptions, Observation, Provider } from "./types.js";
+export declare const version = "0.3.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { wrap } from "./wrap.js";
+export { MissingConfigError, TensorCostConfigError } from "./config.js";
+export { UnsupportedClientError } from "./providers/detect.js";
+export const version = "0.3.0";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Anthropic client wrapping.
+ *
+ * Intercepts `client.messages.create`. Same observation contract as the
+ * OpenAI wrapper — only metadata is captured (model, input/output tokens),
+ * never the message content itself.
+ */
+import type { ObservationTransport } from "../transport.js";
+export declare function install(client: unknown, transport: ObservationTransport, tenantId: string | null, environment: string | null, connectionId: string | null): void;
+export declare const __test__: {
+    MARKER: string;
+};
+//# sourceMappingURL=anthropic.d.ts.map

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

@@ -0,0 +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"}

package/dist/providers/anthropic.js

@@ -0,0 +1,119 @@
+/**
+ * Anthropic client wrapping.
+ *
+ * Intercepts `client.messages.create`. Same observation contract as the
+ * OpenAI wrapper — only metadata is captured (model, input/output tokens),
+ * never the message content itself.
+ */
+import { randomUUID } from "node:crypto";
+const SDK_VERSION = "tensorcost-node/0.3.0";
+const MARKER = "__tensorcost_wrapped__";
+function nowIso() {
+    return new Date().toISOString();
+}
+function extractUsage(response) {
+    if (!response || typeof response !== "object") {
+        return { input: null, output: null };
+    }
+    const usage = response.usage;
+    if (!usage || typeof usage !== "object") {
+        return { input: null, output: null };
+    }
+    const u = usage;
+    const input = typeof u.input_tokens === "number" ? u.input_tokens : null;
+    const output = typeof u.output_tokens === "number" ? u.output_tokens : null;
+    return { input, output };
+}
+function wrapMethod(bound, opts) {
+    const wrapped = async function (...args) {
+        const requestAt = nowIso();
+        const firstArg = args[0];
+        const model = (firstArg && typeof firstArg === "object" && firstArg.model) ||
+            "unknown";
+        const correlationId = randomUUID();
+        try {
+            const response = await bound.apply(this, args);
+            const { input, output } = extractUsage(response);
+            const obs = {
+                sdk_version: SDK_VERSION,
+                provider: "anthropic",
+                model: String(model),
+                operation: "messages",
+                request_at: requestAt,
+                response_at: nowIso(),
+                input_tokens: input,
+                output_tokens: output,
+                cost_usd_cents: null,
+                status: "success",
+                error_message: null,
+                correlation_id: correlationId,
+                tenant_id: opts.tenantId,
+                ...(opts.environment !== null
+                    ? { environment: opts.environment }
+                    : {}),
+                ...(opts.connectionId !== null
+                    ? { connection_id: opts.connectionId }
+                    : {}),
+            };
+            try {
+                opts.transport.post(obs);
+            }
+            catch {
+                // transport already fail-open
+            }
+            return response;
+        }
+        catch (err) {
+            const obs = {
+                sdk_version: SDK_VERSION,
+                provider: "anthropic",
+                model: String(model),
+                operation: "messages",
+                request_at: requestAt,
+                response_at: nowIso(),
+                input_tokens: null,
+                output_tokens: null,
+                cost_usd_cents: null,
+                status: "error",
+                error_message: `${err.name}: ${err.message}`,
+                correlation_id: correlationId,
+                tenant_id: opts.tenantId,
+                ...(opts.environment !== null
+                    ? { environment: opts.environment }
+                    : {}),
+                ...(opts.connectionId !== null
+                    ? { connection_id: opts.connectionId }
+                    : {}),
+            };
+            try {
+                opts.transport.post(obs);
+            }
+            catch {
+                // see above
+            }
+            throw err;
+        }
+    };
+    Object.defineProperty(wrapped, MARKER, { value: true, enumerable: false });
+    return wrapped;
+}
+export function install(client, transport, tenantId, environment, connectionId) {
+    if (!client || typeof client !== "object")
+        return;
+    const c = client;
+    const messages = c.messages;
+    if (messages &&
+        typeof messages === "object" &&
+        typeof messages.create === "function" &&
+        !messages.create[MARKER]) {
+        const bound = messages.create.bind(messages);
+        messages.create = wrapMethod(bound, {
+            transport,
+            tenantId,
+            environment,
+            connectionId,
+        });
+    }
+}
+export const __test__ = { MARKER };
+//# sourceMappingURL=anthropic.js.map

package/dist/providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAC5C,MAAM,MAAM,GAAG,wBAAwB,CAAC;AAExC,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,YAAY,CACnB,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,KAAK,GAAI,QAAgC,CAAC,KAAK,CAAC;IACtD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,MAAM,MAAM,GACV,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,UAAU,CACjB,KAA8B,EAC9B,IAOC;IAED,MAAM,OAAO,GAAG,KAAK,WAA0B,GAAG,IAAW;QAC3D,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,KAAK,GACT,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC;YAC5D,SAAS,CAAC;QACZ,MAAM,aAAa,GAAG,UAAU,EAAE,CAAC;QAEnC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC/C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACjD,MAAM,GAAG,GAAgB;gBACvB,WAAW,EAAE,WAAW;gBACxB,QAAQ,EAAE,WAAW;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;gBACpB,SAAS,EAAE,UAAU;gBACrB,UAAU,EAAE,SAAS;gBACrB,WAAW,EAAE,MAAM,EAAE;gBACrB,YAAY,EAAE,KAAK;gBACnB,aAAa,EAAE,MAAM;gBACrB,cAAc,EAAE,IAAI;gBACpB,MAAM,EAAE,SAAS;gBACjB,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,aAAa;gBAC7B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI;oBAC3B,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;oBACnC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI;oBAC5B,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE;oBACtC,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;YACF,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,8BAA8B;YAChC,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAgB;gBACvB,WAAW,EAAE,WAAW;gBACxB,QAAQ,EAAE,WAAW;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;gBACpB,SAAS,EAAE,UAAU;gBACrB,UAAU,EAAE,SAAS;gBACrB,WAAW,EAAE,MAAM,EAAE;gBACrB,YAAY,EAAE,IAAI;gBAClB,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,IAAI;gBACpB,MAAM,EAAE,OAAO;gBACf,aAAa,EAAE,GAAI,GAAa,CAAC,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE;gBAClE,cAAc,EAAE,aAAa;gBAC7B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI;oBAC3B,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;oBACnC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI;oBAC5B,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE;oBACtC,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;YACF,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,MAAe,EACf,SAA+B,EAC/B,QAAuB,EACvB,WAA0B,EAC1B,YAA2B;IAE3B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO;IAClD,MAAM,CAAC,GAAG,MAA6B,CAAC;IACxC,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC5B,IACE,QAAQ;QACR,OAAO,QAAQ,KAAK,QAAQ;QAC5B,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU;QACrC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EACxB,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE;YAClC,SAAS;YACT,QAAQ;YACR,WAAW;YACX,YAAY;SACb,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,MAAM,EAAE,CAAC"}

package/dist/providers/detect.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Provider detection — duck-typed.
+ *
+ * We avoid importing `openai` or `@anthropic-ai/sdk` at runtime so that
+ * the SDK has zero peer-dep cost when the customer only uses one of the
+ * two providers. Detection inspects the shape of the client object.
+ */
+import type { Provider } from "../types.js";
+export declare class UnsupportedClientError extends Error {
+    constructor(message: string);
+}
+export declare function detectProvider(client: unknown): Provider;
+//# sourceMappingURL=detect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/providers/detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAkCxD"}

package/dist/providers/detect.js

@@ -0,0 +1,39 @@
+/**
+ * Provider detection — duck-typed.
+ *
+ * We avoid importing `openai` or `@anthropic-ai/sdk` at runtime so that
+ * the SDK has zero peer-dep cost when the customer only uses one of the
+ * two providers. Detection inspects the shape of the client object.
+ */
+export class UnsupportedClientError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UnsupportedClientError";
+    }
+}
+export function detectProvider(client) {
+    if (client === null || typeof client !== "object") {
+        throw new UnsupportedClientError("tensorcost: wrap() requires an object (an OpenAI or Anthropic client instance).");
+    }
+    const c = client;
+    // OpenAI: has chat.completions.create OR completions.create
+    const chat = c.chat;
+    const chatCompletions = chat && typeof chat === "object" ? chat.completions : undefined;
+    const hasOpenAIShape = (chatCompletions && typeof chatCompletions.create === "function") ||
+        (c.completions && typeof c.completions.create === "function");
+    // Anthropic: has messages.create
+    const messages = c.messages;
+    const hasAnthropicShape = messages && typeof messages.create === "function";
+    // Disambiguation: OpenAI also has a top-level `completions` AND `chat`.
+    // Anthropic only exposes `messages`. If both shapes match (unusual),
+    // prefer the more specific Anthropic match only when there's no chat.
+    if (hasOpenAIShape) {
+        return "openai";
+    }
+    if (hasAnthropicShape) {
+        return "anthropic";
+    }
+    throw new UnsupportedClientError("tensorcost: client does not look like an OpenAI or Anthropic instance " +
+        "(missing chat.completions.create / completions.create / messages.create).");
+}
+//# sourceMappingURL=detect.js.map

package/dist/providers/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/providers/detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,sBAAsB,CAC9B,iFAAiF,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,MAA6B,CAAC;IAExC,4DAA4D;IAC5D,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IACpB,MAAM,eAAe,GACnB,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,cAAc,GAClB,CAAC,eAAe,IAAI,OAAO,eAAe,CAAC,MAAM,KAAK,UAAU,CAAC;QACjE,CAAC,CAAC,CAAC,WAAW,IAAI,OAAO,CAAC,CAAC,WAAW,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IAEhE,iCAAiC;IACjC,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC5B,MAAM,iBAAiB,GACrB,QAAQ,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC;IAEpD,wEAAwE;IACxE,qEAAqE;IACrE,sEAAsE;IACtE,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,IAAI,sBAAsB,CAC9B,wEAAwE;QACtE,2EAA2E,CAC9E,CAAC;AACJ,CAAC"}

package/dist/providers/index.d.ts

@@ -0,0 +1,4 @@
+export { detectProvider, UnsupportedClientError } from "./detect.js";
+export * as openaiProvider from "./openai.js";
+export * as anthropicProvider from "./anthropic.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,cAAc,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,iBAAiB,MAAM,gBAAgB,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,4 @@
+export { detectProvider, UnsupportedClientError } from "./detect.js";
+export * as openaiProvider from "./openai.js";
+export * as anthropicProvider from "./anthropic.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,cAAc,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,iBAAiB,MAAM,gBAAgB,CAAC"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,16 @@
+/**
+ * OpenAI client wrapping.
+ *
+ * Intercepts:
+ *   * `client.chat.completions.create`
+ *   * `client.completions.create` (legacy text completions; v0 still ships)
+ *
+ * We capture only metadata (model, token usage) — never prompt content.
+ * Customer prompts stay on their machine.
+ */
+import type { ObservationTransport } from "../transport.js";
+export declare function install(client: unknown, transport: ObservationTransport, tenantId: string | null, environment: string | null, connectionId: string | null): void;
+export declare const __test__: {
+    MARKER: string;
+};
+//# sourceMappingURL=openai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAuH5D,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,CAsCN;AAED,eAAO,MAAM,QAAQ;;CAAa,CAAC"}

package/dist/providers/openai.js

@@ -0,0 +1,137 @@
+/**
+ * OpenAI client wrapping.
+ *
+ * Intercepts:
+ *   * `client.chat.completions.create`
+ *   * `client.completions.create` (legacy text completions; v0 still ships)
+ *
+ * We capture only metadata (model, token usage) — never prompt content.
+ * Customer prompts stay on their machine.
+ */
+import { randomUUID } from "node:crypto";
+const SDK_VERSION = "tensorcost-node/0.3.0";
+const MARKER = "__tensorcost_wrapped__";
+function nowIso() {
+    return new Date().toISOString();
+}
+function extractUsage(response) {
+    if (!response || typeof response !== "object") {
+        return { input: null, output: null };
+    }
+    const usage = response.usage;
+    if (!usage || typeof usage !== "object") {
+        return { input: null, output: null };
+    }
+    const u = usage;
+    const input = typeof u.prompt_tokens === "number" ? u.prompt_tokens : null;
+    const output = typeof u.completion_tokens === "number" ? u.completion_tokens : null;
+    return { input, output };
+}
+function wrapMethod(bound, opts) {
+    const wrapped = async function (...args) {
+        const requestAt = nowIso();
+        const firstArg = args[0];
+        const model = (firstArg && typeof firstArg === "object" && firstArg.model) ||
+            "unknown";
+        const correlationId = randomUUID();
+        try {
+            const response = await bound.apply(this, args);
+            const { input, output } = extractUsage(response);
+            const obs = {
+                sdk_version: SDK_VERSION,
+                provider: "openai",
+                model: String(model),
+                operation: opts.operation,
+                request_at: requestAt,
+                response_at: nowIso(),
+                input_tokens: input,
+                output_tokens: output,
+                cost_usd_cents: null,
+                status: "success",
+                error_message: null,
+                correlation_id: correlationId,
+                tenant_id: opts.tenantId,
+                ...(opts.environment !== null
+                    ? { environment: opts.environment }
+                    : {}),
+                ...(opts.connectionId !== null
+                    ? { connection_id: opts.connectionId }
+                    : {}),
+            };
+            try {
+                opts.transport.post(obs);
+            }
+            catch {
+                // belt-and-suspenders: transport itself is fail-open
+            }
+            return response;
+        }
+        catch (err) {
+            const obs = {
+                sdk_version: SDK_VERSION,
+                provider: "openai",
+                model: String(model),
+                operation: opts.operation,
+                request_at: requestAt,
+                response_at: nowIso(),
+                input_tokens: null,
+                output_tokens: null,
+                cost_usd_cents: null,
+                status: "error",
+                error_message: `${err.name}: ${err.message}`,
+                correlation_id: correlationId,
+                tenant_id: opts.tenantId,
+                ...(opts.environment !== null
+                    ? { environment: opts.environment }
+                    : {}),
+                ...(opts.connectionId !== null
+                    ? { connection_id: opts.connectionId }
+                    : {}),
+            };
+            try {
+                opts.transport.post(obs);
+            }
+            catch {
+                // see above
+            }
+            throw err;
+        }
+    };
+    Object.defineProperty(wrapped, MARKER, { value: true, enumerable: false });
+    return wrapped;
+}
+export function install(client, transport, tenantId, environment, connectionId) {
+    if (!client || typeof client !== "object")
+        return;
+    const c = client;
+    const chat = c.chat;
+    const chatCompletions = chat && typeof chat === "object" ? chat.completions : undefined;
+    if (chatCompletions &&
+        typeof chatCompletions.create === "function" &&
+        !chatCompletions.create[MARKER]) {
+        const bound = chatCompletions.create.bind(chatCompletions);
+        chatCompletions.create = wrapMethod(bound, {
+            operation: "chat.completions",
+            transport,
+            tenantId,
+            environment,
+            connectionId,
+        });
+    }
+    const legacy = c.completions;
+    if (legacy &&
+        typeof legacy === "object" &&
+        typeof legacy.create === "function" &&
+        !legacy.create[MARKER]) {
+        const bound = legacy.create.bind(legacy);
+        legacy.create = wrapMethod(bound, {
+            operation: "completions",
+            transport,
+            tenantId,
+            environment,
+            connectionId,
+        });
+    }
+}
+export const __test__ = { MARKER };
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAC5C,MAAM,MAAM,GAAG,wBAAwB,CAAC;AAExC,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,YAAY,CACnB,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,KAAK,GAAI,QAAgC,CAAC,KAAK,CAAC;IACtD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,MAAM,MAAM,GACV,OAAO,CAAC,CAAC,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,UAAU,CACjB,KAA8B,EAC9B,IAgBC;IAED,MAAM,OAAO,GAAG,KAAK,WAA0B,GAAG,IAAW;QAC3D,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,KAAK,GACT,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC;YAC5D,SAAS,CAAC;QACZ,MAAM,aAAa,GAAG,UAAU,EAAE,CAAC;QAEnC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC/C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACjD,MAAM,GAAG,GAAgB;gBACvB,WAAW,EAAE,WAAW;gBACxB,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;gBACpB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,UAAU,EAAE,SAAS;gBACrB,WAAW,EAAE,MAAM,EAAE;gBACrB,YAAY,EAAE,KAAK;gBACnB,aAAa,EAAE,MAAM;gBACrB,cAAc,EAAE,IAAI;gBACpB,MAAM,EAAE,SAAS;gBACjB,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,aAAa;gBAC7B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI;oBAC3B,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;oBACnC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI;oBAC5B,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE;oBACtC,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;YACF,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,qDAAqD;YACvD,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAgB;gBACvB,WAAW,EAAE,WAAW;gBACxB,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;gBACpB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,UAAU,EAAE,SAAS;gBACrB,WAAW,EAAE,MAAM,EAAE;gBACrB,YAAY,EAAE,IAAI;gBAClB,aAAa,EAAE,IAAI;gBACnB,cAAc,EAAE,IAAI;gBACpB,MAAM,EAAE,OAAO;gBACf,aAAa,EAAE,GAAI,GAAa,CAAC,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE;gBAClE,cAAc,EAAE,aAAa;gBAC7B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI;oBAC3B,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;oBACnC,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI;oBAC5B,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE;oBACtC,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;YACF,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,MAAe,EACf,SAA+B,EAC/B,QAAuB,EACvB,WAA0B,EAC1B,YAA2B;IAE3B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO;IAClD,MAAM,CAAC,GAAG,MAA6B,CAAC;IAExC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IACpB,MAAM,eAAe,GACnB,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,IACE,eAAe;QACf,OAAO,eAAe,CAAC,MAAM,KAAK,UAAU;QAC5C,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,EAC/B,CAAC;QACD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3D,eAAe,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE;YACzC,SAAS,EAAE,kBAAkB;YAC7B,SAAS;YACT,QAAQ;YACR,WAAW;YACX,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC;IAC7B,IACE,MAAM;QACN,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU;QACnC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EACtB,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE;YAChC,SAAS,EAAE,aAAa;YACxB,SAAS;YACT,QAAQ;YACR,WAAW;YACX,YAAY;SACb,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,MAAM,EAAE,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Fire-and-forget HTTP transport for observation events.
+ *
+ * Design:
+ *
+ * * `post(observation)` returns synchronously the moment the observation
+ *   is enqueued. The actual fetch runs on the microtask queue via
+ *   `queueMicrotask`, so the customer's hot path is never blocked on
+ *   network IO.
+ * * If the in-flight queue saturates (>= MAX_QUEUE_DEPTH), we drop the
+ *   oldest observation rather than block. Losing one observation is
+ *   strictly preferable to slowing down the customer's request loop.
+ * * A short-lived JWT is fetched once via
+ *   `POST /api/inference-proxy/sdk-token/exchange` using the long-lived
+ *   API key.
+ *   The token is cached in-memory and refreshed when within
+ *   TOKEN_REFRESH_LEEWAY_MS of expiry.
+ * * All errors during posting are swallowed when `failOpen` is true
+ *   (the default) and surfaced via console.warn. The customer's call
+ *   site never sees an exception.
+ */
+import type { Observation } from "./types.js";
+export interface TransportOptions {
+    baseUrl: string;
+    apiKey: string;
+    timeoutMs?: number;
+    failOpen?: boolean;
+    /** Optional fetch override for testing. Defaults to global fetch. */
+    fetchImpl?: typeof fetch;
+}
+export declare class ObservationTransport {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    private readonly failOpen;
+    private readonly fetchImpl;
+    private pending;
+    private tokenCache;
+    /** In-flight token-exchange promise; coalesces concurrent refreshes. */
+    private tokenInflight;
+    constructor(opts: TransportOptions);
+    /**
+     * Enqueue an observation for fire-and-forget delivery. Returns
+     * immediately (synchronously). Errors are logged via console.warn,
+     * never thrown, when failOpen is true.
+     */
+    post(observation: Observation): void;
+    private deliver;
+    private getToken;
+    private exchangeToken;
+}
+export declare const __test__: {
+    SDK_VERSION: string;
+    MAX_QUEUE_DEPTH: number;
+};
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQ9C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAOD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,UAAU,CAA2B;IAC7C,wEAAwE;IACxE,OAAO,CAAC,aAAa,CAAgC;gBAEzC,IAAI,EAAE,gBAAgB;IAQlC;;;;OAIG;IACH,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;YAqBtB,OAAO;YAqCP,QAAQ;YAiBR,aAAa;CAuC5B;AAED,eAAO,MAAM,QAAQ;;;CAGpB,CAAC"}