@dexcost/sdk 0.2.0

package/dist/integrations/langchain.js

@@ -0,0 +1,165 @@
+/**
+ * DexcostCallbackHandler — duck-typed LangChain callback handler.
+ *
+ * Works with any LangChain version without importing `@langchain/core`.
+ * Attach to a LangChain chain/agent as a callback to automatically track
+ * LLM call costs inside dexcost tasks.
+ *
+ * Usage:
+ *   const handler = new DexcostCallbackHandler(tracker);
+ *   const chain = new LLMChain({ llm, prompt, callbacks: [handler] });
+ */
+import { randomUUID } from "node:crypto";
+import { getCurrentTask } from "../core/context.js";
+import { createCostEvent } from "../core/models.js";
+// ---------------------------------------------------------------------------
+// DexcostCallbackHandler
+// ---------------------------------------------------------------------------
+/**
+ * A duck-typed LangChain callback handler that records cost events for every
+ * LLM call that occurs inside a dexcost tracked task.
+ *
+ * No `@langchain/core` dependency — the handler implements the subset of the
+ * BaseCallbackHandler interface that LangChain calls for LLM lifecycle events.
+ */
+export class DexcostCallbackHandler {
+    _pricing;
+    _buffer;
+    _pending = new Map();
+    constructor(tracker) {
+        this._pricing = tracker.pricing;
+        this._buffer = tracker.buffer;
+    }
+    /**
+     * Called by LangChain at the start of an LLM invocation.
+     *
+     * @param serialized - Serialized LLM object. Model name is extracted from
+     *   `serialized.kwargs.model_name` (preferred) or the last element of
+     *   `serialized.id` (fallback).
+     * @param prompts - The input prompt strings (unused beyond signalling start).
+     * @param runId - Unique identifier for this run, used to correlate start/end.
+     */
+    handleLLMStart(serialized, _prompts, runId) {
+        const model = this._extractModel(serialized);
+        this._pending.set(runId, { model, startTime: Date.now() });
+    }
+    /**
+     * Called by LangChain when an LLM invocation completes successfully.
+     *
+     * Records a `llm_call` cost event into the active task (if any).
+     *
+     * @param output - LLM output object. Token counts are read from
+     *   `output.llmOutput.tokenUsage.{promptTokens, completionTokens}`.
+     * @param runId - Matches the runId from the corresponding handleLLMStart.
+     */
+    handleLLMEnd(output, runId) {
+        const pending = this._pending.get(runId);
+        if (!pending)
+            return;
+        const { model, startTime } = pending;
+        const latencyMs = Date.now() - startTime;
+        // Extract token counts from output.llmOutput.tokenUsage
+        const llmOutput = output["llmOutput"];
+        const tokenUsage = llmOutput?.["tokenUsage"];
+        const promptTokens = tokenUsage?.["promptTokens"] ?? 0;
+        const completionTokens = tokenUsage?.["completionTokens"] ?? 0;
+        // Requires an active task context
+        const task = getCurrentTask();
+        if (!task) {
+            this._pending.delete(runId);
+            return;
+        }
+        // Compute cost
+        const costResult = this._pricing.getCost(model, promptTokens, completionTokens);
+        // Build event
+        const event = createCostEvent({
+            eventId: randomUUID(),
+            taskId: task.taskId,
+            eventType: "llm_call",
+            provider: "langchain",
+            model,
+            inputTokens: promptTokens,
+            outputTokens: completionTokens,
+            costUsd: costResult.costUsd,
+            costConfidence: costResult.costConfidence,
+            pricingSource: costResult.pricingSource,
+            latencyMs,
+            isRetry: false,
+        });
+        // Persist event
+        this._buffer.addEvent(event);
+        // Update task aggregates
+        task.llmCostUsd += costResult.costUsd;
+        task.totalCostUsd += costResult.costUsd;
+        task.totalInputTokens += promptTokens;
+        task.totalOutputTokens += completionTokens;
+        this._buffer.upsertTask(task);
+        this._pending.delete(runId);
+    }
+    /**
+     * Called by LangChain when an LLM invocation fails.
+     *
+     * Records a failure `llm_call` event (cost 0, `error_type` in details)
+     * when a task context is active, mirroring the Python SDK's
+     * `on_llm_error`. Never throws.
+     *
+     * @param error - The error that occurred.
+     * @param runId - Matches the runId from the corresponding handleLLMStart.
+     */
+    handleLLMError(error, runId) {
+        const pending = this._pending.get(runId);
+        this._pending.delete(runId);
+        const task = getCurrentTask();
+        if (!task) {
+            // No active task — nothing to attribute the failure to.
+            return;
+        }
+        const model = pending?.model ?? "unknown";
+        const latencyMs = pending ? Date.now() - pending.startTime : undefined;
+        const errorType = error?.name ?? "Error";
+        try {
+            const event = createCostEvent({
+                eventId: randomUUID(),
+                taskId: task.taskId,
+                eventType: "llm_call",
+                costUsd: 0,
+                costConfidence: "unknown",
+                pricingSource: "unknown",
+                provider: "langchain",
+                model,
+                latencyMs,
+                isRetry: false,
+                details: { error: String(error?.message ?? error), error_type: errorType },
+            });
+            this._buffer.addEvent(event);
+            this._buffer.upsertTask(task);
+        }
+        catch {
+            // dexcost errors must never crash user code
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Extract the model identifier from a serialized LangChain LLM object.
+     *
+     * Preference order:
+     *   1. `serialized.kwargs.model_name` — set by most ChatModel subclasses
+     *   2. last element of `serialized.id` — the class name (e.g. "ChatOpenAI")
+     */
+    _extractModel(serialized) {
+        const kwargs = serialized["kwargs"];
+        if (kwargs?.["model_name"] && typeof kwargs["model_name"] === "string") {
+            return kwargs["model_name"];
+        }
+        const id = serialized["id"];
+        if (Array.isArray(id) && id.length > 0) {
+            const last = id[id.length - 1];
+            if (typeof last === "string")
+                return last;
+        }
+        return "unknown";
+    }
+}
+//# sourceMappingURL=langchain.js.map

package/dist/integrations/langchain.js.map

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

package/dist/middleware/express.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Express/Connect middleware for automatic HTTP request cost tracking.
+ *
+ * Wraps each incoming request in a tracked task, attaching the TrackedTask
+ * instance to `req.dexcostTask` so downstream handlers can record costs.
+ */
+import type { CostTracker } from "../core/tracker.js";
+/** Options for configuring the Express middleware. */
+export interface ExpressMiddlewareOptions {
+    /**
+     * Dot-path into the request object to extract a customer ID.
+     * For example, "user.orgId" reads `req.user.orgId`.
+     */
+    customerIdFrom?: string;
+    /**
+     * Dot-path into the request object to extract a project ID.
+     * For example, "headers.x-project-id" reads `req.headers["x-project-id"]`.
+     */
+    projectIdFrom?: string;
+    /**
+     * Custom function to derive the task type from the request.
+     * Defaults to `"METHOD /path"`.
+     */
+    taskType?: (req: unknown) => string;
+    /**
+     * Predicate to skip tracking for certain requests (e.g. health checks).
+     * Return `true` to skip.
+     */
+    skip?: (req: unknown) => boolean;
+}
+/**
+ * Create an Express/Connect middleware that wraps each request in a
+ * dexcost tracked task.
+ *
+ * The middleware attaches the `TrackedTask` instance to `req.dexcostTask`
+ * so that downstream route handlers can call `req.dexcostTask.recordLlmCall()`
+ * and similar methods.
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { CostTracker } from "dexcost";
+ * import { createExpressMiddleware } from "dexcost/middleware/express";
+ *
+ * const app = express();
+ * const tracker = new CostTracker();
+ *
+ * app.use(createExpressMiddleware(tracker, {
+ *   customerIdFrom: "user.orgId",
+ *   skip: (req) => req.path === "/health",
+ * }));
+ * ```
+ */
+export declare function createExpressMiddleware(tracker: CostTracker, options?: ExpressMiddlewareOptions): (req: unknown, res: unknown, next: () => void) => void;
+//# sourceMappingURL=express.d.ts.map

package/dist/middleware/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/middleware/express.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,sDAAsD;AACtD,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;IAEpC;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CAClC;AAiBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,wBAA6B,GACrC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAkExD"}

package/dist/middleware/express.js

@@ -0,0 +1,101 @@
+/**
+ * Express/Connect middleware for automatic HTTP request cost tracking.
+ *
+ * Wraps each incoming request in a tracked task, attaching the TrackedTask
+ * instance to `req.dexcostTask` so downstream handlers can record costs.
+ */
+import { scrubUrl } from "../security/redaction.js";
+/**
+ * Resolve a dot-separated path on an object.
+ *
+ * @example getNestedValue({ user: { orgId: "acme" } }, "user.orgId") // "acme"
+ */
+function getNestedValue(obj, path) {
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current == null || typeof current !== "object")
+            return undefined;
+        current = current[part];
+    }
+    return typeof current === "string" ? current : undefined;
+}
+/**
+ * Create an Express/Connect middleware that wraps each request in a
+ * dexcost tracked task.
+ *
+ * The middleware attaches the `TrackedTask` instance to `req.dexcostTask`
+ * so that downstream route handlers can call `req.dexcostTask.recordLlmCall()`
+ * and similar methods.
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { CostTracker } from "dexcost";
+ * import { createExpressMiddleware } from "dexcost/middleware/express";
+ *
+ * const app = express();
+ * const tracker = new CostTracker();
+ *
+ * app.use(createExpressMiddleware(tracker, {
+ *   customerIdFrom: "user.orgId",
+ *   skip: (req) => req.path === "/health",
+ * }));
+ * ```
+ */
+export function createExpressMiddleware(tracker, options = {}) {
+    return (req, res, next) => {
+        const reqObj = req;
+        const resObj = res;
+        if (options.skip?.(req)) {
+            next();
+            return;
+        }
+        const method = typeof reqObj["method"] === "string" ? reqObj["method"] : "UNKNOWN";
+        // Express keeps the raw query string on originalUrl even when the
+        // body is streamed (B11 correlation); a literal scrubUrl call here
+        // strips userinfo and sensitive query params before this lands in
+        // Task.taskType, which ships to the control plane.
+        const rawUrl = typeof reqObj["originalUrl"] === "string"
+            ? reqObj["originalUrl"]
+            : typeof reqObj["path"] === "string"
+                ? reqObj["path"]
+                : "/";
+        // scrubUrl is a no-op on relative paths (no scheme), but kicks in
+        // when callers pass absolute URLs through originalUrl.
+        const url = scrubUrl(rawUrl);
+        const taskType = options.taskType?.(req) ?? `${method} ${url}`;
+        const customerId = options.customerIdFrom
+            ? getNestedValue(req, options.customerIdFrom)
+            : undefined;
+        const projectId = options.projectIdFrom
+            ? getNestedValue(req, options.projectIdFrom)
+            : undefined;
+        const onFn = typeof resObj["on"] === "function" ? resObj["on"] : null;
+        if (onFn) {
+            void tracker.track({ taskType, customerId, projectId }, async (task) => {
+                reqObj["dexcostTask"] = task;
+                next();
+                await new Promise((resolve) => {
+                    onFn.call(resObj, "finish", () => {
+                        const statusCode = typeof resObj["statusCode"] === "number" ? resObj["statusCode"] : 200;
+                        const status = statusCode >= 400 ? "failed" : "success";
+                        task.end(status);
+                        resolve();
+                    });
+                });
+            });
+        }
+        else {
+            // Can't detect response end — finalize immediately after next()
+            void tracker.track({ taskType, customerId, projectId }, async (task) => {
+                reqObj["dexcostTask"] = task;
+                next();
+                const statusCode = typeof resObj["statusCode"] === "number" ? resObj["statusCode"] : 200;
+                const status = statusCode >= 400 ? "failed" : "success";
+                task.end(status);
+            });
+        }
+    };
+}
+//# sourceMappingURL=express.js.map

package/dist/middleware/express.js.map

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

package/dist/middleware/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * HTTP middleware integrations for automatic request cost tracking.
+ */
+export { createExpressMiddleware } from "./express.js";
+export type { ExpressMiddlewareOptions } from "./express.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1,5 @@
+/**
+ * HTTP middleware integrations for automatic request cost tracking.
+ */
+export { createExpressMiddleware } from "./express.js";
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/pricing/compute-pricing.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Compute pricing engine — dispatches on `details.billing_model` and applies
+ * the per-billing-model math from spec §6.
+ *
+ * The per-runtime memory-unit conversion table (Decision #7) is pinned at the
+ * catalog-lookup boundary in §6.2 of the spec; the implementation enforces
+ * it via two Decimal divisor constants (decimal GB vs binary GiB) selected
+ * per billing model. Confusing them silently over-attributes Fargate memory
+ * cost by ~4.86% — the pricing tests pin the divisor choice per model.
+ *
+ * Fail-silent contract (convention §9): every code path returns a usable
+ * `ComputeCost` — the five-tier degradation ladder from convention §7
+ * applies (per-region exact → per-runtime default → universal _meta default
+ * → hardcoded constants → cost=0 with warning).
+ *
+ * Mirrors python/src/dexcost/compute_pricing.py.
+ */
+import { Decimal } from "decimal.js";
+import type { CloudEnv } from "../cloud-detect.js";
+export declare function _resetWarningStateForTests(): void;
+export interface ComputeCost {
+    costUsd: Decimal;
+    pricingSource: string;
+    costConfidence: "exact" | "computed" | "estimated" | "unknown";
+}
+export interface ComputePricingEngineOptions {
+    /** Override path to the catalog JSON; defaults to the bundled file. */
+    catalogPath?: string;
+    /** Already-parsed catalog object — overrides both `catalogPath` and bundled load. */
+    catalog?: Record<string, any>;
+}
+export declare class ComputePricingEngine {
+    private _catalog;
+    private _catalogVersion;
+    constructor(opts?: ComputePricingEngineOptions);
+    private _load;
+    get catalogVersion(): string;
+    resolveComputeCost(details: Record<string, any>, cloudEnv: CloudEnv, overrides: Record<string, string> | null | undefined, windowS?: Decimal): ComputeCost;
+    private _dispatch;
+    private _lambda;
+    private _resolveLambdaRate;
+    private _fargate;
+    private _resolveFargateRate;
+    private _cloudRunRequest;
+    private _cloudRunInstanceOverride;
+    private _resolveCloudRunRate;
+    private _cloudFunctions;
+    private _azureFunctions;
+    private _resolveAzureFunctionsRate;
+    private _vercel;
+    private _resolveVercelRate;
+    private _iaasShare;
+    private _resolveIaasRate;
+    private _k8sPodLimits;
+    private _resolveK8sPodRate;
+}
+//# sourceMappingURL=compute-pricing.d.ts.map

package/dist/pricing/compute-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-pricing.d.ts","sourceRoot":"","sources":["../../src/pricing/compute-pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAMnD,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AA4DD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;CAChE;AAED,MAAM,WAAW,2BAA2B;IAC1C,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAsBD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,eAAe,CAAqB;gBAEhC,IAAI,CAAC,EAAE,2BAA2B;IAgB9C,OAAO,CAAC,KAAK;IAuDb,IAAI,cAAc,IAAI,MAAM,CAE3B;IAMD,kBAAkB,CAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EACpD,OAAO,CAAC,EAAE,OAAO,GAChB,WAAW;IAuBd,OAAO,CAAC,SAAS;IAqCjB,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,kBAAkB;IA+C1B,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,mBAAmB;IA+C3B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,yBAAyB;IAuBjC,OAAO,CAAC,oBAAoB;IAgD5B,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,0BAA0B;IA2ClC,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,kBAAkB;IA0C1B,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,gBAAgB;IA0DxB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,kBAAkB;CAoB3B"}