@dexcost/sdk 0.2.0

package/dist/pricing/service-catalog.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Service Catalog — cost extraction engine for non-LLM services.
+ *
+ * Loads the bundled service_prices.json catalog and matches HTTP requests
+ * against known service domains to extract per-request costs automatically.
+ *
+ * Implements US-035 service catalog cost extraction.
+ */
+/** A cost extraction definition from the catalog. */
+export interface CostExtractionDef {
+    type: "response_body" | "response_header" | "endpoint_match" | "fixed";
+    path?: string;
+    header?: string;
+    transform?: string;
+    fallback_credits?: number;
+    units?: number;
+}
+/** A single service entry from the catalog JSON. */
+export interface ServiceEntry {
+    display_name: string;
+    domains: string[];
+    endpoints?: string[];
+    category: string;
+    pricing_model: string;
+    cost_extraction: CostExtractionDef;
+    source: string;
+    last_verified: string;
+    note?: string;
+    cost_per_credit_usd?: string;
+    default_credits_per_request?: number;
+    cost_per_request_usd?: string;
+    cost_per_page_usd?: string;
+    cost_per_minute_usd?: string;
+    cost_per_compute_unit_usd?: string;
+    cost_per_message_usd?: string;
+    cost_per_email_usd?: string;
+    cost_per_second_usd?: string;
+    cost_per_search_usd?: string;
+    cost_per_query_usd?: string;
+    cost_per_read_unit_usd?: string;
+    cost_per_1k_characters_usd?: string;
+    percentage?: string;
+    fixed_fee_usd?: string;
+}
+/** Result of extracting cost from a service response. */
+export interface CostExtractionResult {
+    costUsd: number;
+    confidence: string;
+    serviceName: string;
+    pricingSource: string;
+}
+export declare class ServiceCatalog {
+    private _entries;
+    private _overrides;
+    private _version;
+    constructor(catalogPath?: string);
+    /** Deterministic hash of the loaded catalog. */
+    get catalogVersion(): string;
+    /**
+     * Look up a service entry by URL.
+     *
+     * Domain matching supports wildcards (e.g. `*.pinecone.io`).
+     * Endpoint matching checks if the URL pathname starts with any entry endpoint.
+     */
+    lookup(url: string): ServiceEntry | null;
+    /**
+     * Extract cost from a service response.
+     *
+     * @param entry    The matched ServiceEntry from lookup()
+     * @param headers  Response headers
+     * @param body     Parsed response body (or null/undefined if not available)
+     */
+    extractCost(entry: ServiceEntry, headers: Headers, body: unknown): CostExtractionResult | null;
+    /**
+     * Register a user override for a service key. Overrides take precedence
+     * over catalog-extracted costs.
+     */
+    registerOverride(serviceKey: string, costPerUnit: number, per: string): void;
+    /**
+     * Refresh the catalog from a remote URL.
+     */
+    refreshFromUrl(url: string): Promise<void>;
+    private _loadFromJson;
+    private _computeCostFromUnits;
+    private _fallbackResult;
+}
+//# sourceMappingURL=service-catalog.d.ts.map

package/dist/pricing/service-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-catalog.d.ts","sourceRoot":"","sources":["../../src/pricing/service-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,OAAO,CAAC;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,iBAAiB,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AA2ID,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,UAAU,CAAgE;IAClF,OAAO,CAAC,QAAQ,CAAS;gBAEb,WAAW,CAAC,EAAE,MAAM;IAsBhC,gDAAgD;IAChD,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IA8CxC;;;;;;OAMG;IACH,WAAW,CACT,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,GACZ,oBAAoB,GAAG,IAAI;IAyF9B;;;OAGG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5E;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BhD,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,qBAAqB;IAgC7B,OAAO,CAAC,eAAe;CAsBxB"}

package/dist/pricing/service-catalog.js

@@ -0,0 +1,406 @@
+/**
+ * Service Catalog — cost extraction engine for non-LLM services.
+ *
+ * Loads the bundled service_prices.json catalog and matches HTTP requests
+ * against known service domains to extract per-request costs automatically.
+ *
+ * Implements US-035 service catalog cost extraction.
+ */
+import { createHash } from "node:crypto";
+import { createRequire } from "node:module";
+import { readFileSync } from "node:fs";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Check if a hostname matches a domain pattern (supports `*.example.com` wildcards).
+ */
+function domainMatches(hostname, pattern) {
+    if (pattern.startsWith("*.")) {
+        const suffix = pattern.slice(1); // ".example.com"
+        return hostname.endsWith(suffix) || hostname === pattern.slice(2);
+    }
+    return hostname === pattern;
+}
+/**
+ * Navigate a nested object by dot-separated path (e.g. "data.stats.computeUnits").
+ */
+function getNestedValue(obj, path) {
+    let current = obj;
+    for (const key of path.split(".")) {
+        if (current === null || current === undefined || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Apply a named transform to a raw numeric value + service entry to get costUsd.
+ */
+function applyTransform(transform, rawValue, entry) {
+    switch (transform) {
+        case "ms_to_seconds": {
+            const seconds = rawValue / 1000;
+            const rate = parseFloat(entry.cost_per_second_usd ?? "0");
+            if (isNaN(rate))
+                return null;
+            return seconds * rate;
+        }
+        case "ms_to_minutes": {
+            const minutes = rawValue / 60000;
+            const rate = parseFloat(entry.cost_per_minute_usd ?? "0");
+            if (isNaN(rate))
+                return null;
+            return minutes * rate;
+        }
+        case "stripe_fee": {
+            // rawValue is amount in cents; Stripe charges 2.9% + $0.30
+            const percentage = parseFloat(entry.percentage ?? "0.029");
+            if (isNaN(percentage))
+                return null;
+            const fixedFee = parseFloat(entry.fixed_fee_usd ?? "0.30");
+            if (isNaN(fixedFee))
+                return null;
+            const amountUsd = rawValue / 100;
+            return amountUsd * percentage + fixedFee;
+        }
+        default:
+            return rawValue;
+    }
+}
+/**
+ * Get the fixed per-unit cost from a service entry.
+ */
+function getFixedCost(entry) {
+    // Try each known cost field
+    if (entry.cost_per_request_usd !== undefined) {
+        const v = parseFloat(entry.cost_per_request_usd);
+        return isNaN(v) ? null : v;
+    }
+    if (entry.cost_per_page_usd !== undefined) {
+        const v = parseFloat(entry.cost_per_page_usd);
+        return isNaN(v) ? null : v;
+    }
+    if (entry.cost_per_search_usd !== undefined) {
+        const v = parseFloat(entry.cost_per_search_usd);
+        return isNaN(v) ? null : v;
+    }
+    if (entry.cost_per_query_usd !== undefined) {
+        const v = parseFloat(entry.cost_per_query_usd);
+        return isNaN(v) ? null : v;
+    }
+    if (entry.cost_per_message_usd !== undefined) {
+        const v = parseFloat(entry.cost_per_message_usd);
+        return isNaN(v) ? null : v;
+    }
+    if (entry.cost_per_email_usd !== undefined) {
+        const v = parseFloat(entry.cost_per_email_usd);
+        return isNaN(v) ? null : v;
+    }
+    if (entry.cost_per_second_usd !== undefined) {
+        const v = parseFloat(entry.cost_per_second_usd);
+        return isNaN(v) ? null : v;
+    }
+    if (entry.cost_per_minute_usd !== undefined) {
+        const v = parseFloat(entry.cost_per_minute_usd);
+        return isNaN(v) ? null : v;
+    }
+    if (entry.cost_per_credit_usd !== undefined) {
+        const credits = entry.default_credits_per_request ?? 1;
+        const v = parseFloat(entry.cost_per_credit_usd);
+        return isNaN(v) ? null : v * credits;
+    }
+    if (entry.cost_per_read_unit_usd !== undefined) {
+        const v = parseFloat(entry.cost_per_read_unit_usd);
+        return isNaN(v) ? null : v;
+    }
+    if (entry.cost_per_compute_unit_usd !== undefined) {
+        const v = parseFloat(entry.cost_per_compute_unit_usd);
+        return isNaN(v) ? null : v;
+    }
+    if (entry.cost_per_1k_characters_usd !== undefined) {
+        const v = parseFloat(entry.cost_per_1k_characters_usd);
+        return isNaN(v) ? null : v;
+    }
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// ServiceCatalog
+// ---------------------------------------------------------------------------
+export class ServiceCatalog {
+    _entries = new Map();
+    _overrides = new Map();
+    _version;
+    constructor(catalogPath) {
+        let raw;
+        if (catalogPath) {
+            try {
+                const content = readFileSync(catalogPath, "utf-8");
+                raw = JSON.parse(content);
+            }
+            catch {
+                // Fall back to bundled catalog on any error (missing file, corrupt JSON)
+                const req = createRequire(import.meta.url);
+                raw = req("../data/service_prices.json");
+            }
+        }
+        else {
+            const req = createRequire(import.meta.url);
+            raw = req("../data/service_prices.json");
+        }
+        this._loadFromJson(raw);
+        this._version = createHash("sha256")
+            .update(JSON.stringify(raw))
+            .digest("hex")
+            .slice(0, 12);
+    }
+    /** Deterministic hash of the loaded catalog. */
+    get catalogVersion() {
+        return this._version;
+    }
+    /**
+     * Look up a service entry by URL.
+     *
+     * Domain matching supports wildcards (e.g. `*.pinecone.io`).
+     * Endpoint matching checks if the URL pathname starts with any entry endpoint.
+     */
+    lookup(url) {
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(url);
+        }
+        catch {
+            return null;
+        }
+        const hostname = parsedUrl.hostname;
+        const pathname = parsedUrl.pathname;
+        // First pass: find all entries whose domain matches
+        const candidates = [];
+        for (const [key, entry] of this._entries) {
+            for (const domain of entry.domains) {
+                if (domainMatches(hostname, domain)) {
+                    candidates.push({ key, entry });
+                    break;
+                }
+            }
+        }
+        if (candidates.length === 0)
+            return null;
+        // If any candidate has endpoint restrictions, prefer exact endpoint match
+        for (const { entry } of candidates) {
+            if (entry.endpoints && entry.endpoints.length > 0) {
+                for (const ep of entry.endpoints) {
+                    if (pathname.startsWith(ep)) {
+                        return entry;
+                    }
+                }
+            }
+        }
+        // Return first candidate without endpoint restriction
+        for (const { entry } of candidates) {
+            if (!entry.endpoints || entry.endpoints.length === 0) {
+                return entry;
+            }
+        }
+        // All candidates had endpoints but none matched
+        return null;
+    }
+    /**
+     * Extract cost from a service response.
+     *
+     * @param entry    The matched ServiceEntry from lookup()
+     * @param headers  Response headers
+     * @param body     Parsed response body (or null/undefined if not available)
+     */
+    extractCost(entry, headers, body) {
+        const extraction = entry.cost_extraction;
+        const serviceName = entry.display_name;
+        // Check for user override first
+        for (const [key, override] of this._overrides) {
+            const catalogEntry = this._entries.get(key);
+            if (catalogEntry && catalogEntry.display_name === serviceName) {
+                return {
+                    costUsd: override.costPerUnit,
+                    confidence: "computed",
+                    serviceName,
+                    pricingSource: "user_override",
+                };
+            }
+        }
+        switch (extraction.type) {
+            case "response_body": {
+                if (body === null || body === undefined) {
+                    // Fall back to defaults
+                    return this._fallbackResult(entry, serviceName);
+                }
+                const path = extraction.path;
+                if (!path)
+                    return this._fallbackResult(entry, serviceName);
+                const rawValue = getNestedValue(body, path);
+                if (rawValue === undefined || rawValue === null) {
+                    return this._fallbackResult(entry, serviceName);
+                }
+                const numValue = typeof rawValue === "number" ? rawValue : parseFloat(String(rawValue));
+                if (isNaN(numValue))
+                    return this._fallbackResult(entry, serviceName);
+                let costUsd;
+                if (extraction.transform) {
+                    costUsd = applyTransform(extraction.transform, numValue, entry);
+                }
+                else {
+                    // Multiply raw value by per-unit cost
+                    costUsd = this._computeCostFromUnits(numValue, entry);
+                }
+                if (costUsd === null)
+                    return null;
+                return {
+                    costUsd,
+                    confidence: "exact",
+                    serviceName,
+                    pricingSource: "service_catalog",
+                };
+            }
+            case "response_header": {
+                const headerName = extraction.header;
+                if (!headerName)
+                    return this._fallbackResult(entry, serviceName);
+                const headerValue = headers.get(headerName);
+                if (headerValue === null)
+                    return this._fallbackResult(entry, serviceName);
+                const numValue = parseFloat(headerValue);
+                if (isNaN(numValue))
+                    return null;
+                const costUsd = this._computeCostFromUnits(numValue, entry);
+                if (costUsd === null)
+                    return null;
+                return {
+                    costUsd,
+                    confidence: "exact",
+                    serviceName,
+                    pricingSource: "service_catalog",
+                };
+            }
+            case "endpoint_match":
+            case "fixed": {
+                const costUsd = getFixedCost(entry);
+                if (costUsd === null)
+                    return null;
+                return {
+                    costUsd,
+                    confidence: "computed",
+                    serviceName,
+                    pricingSource: "service_catalog",
+                };
+            }
+            default:
+                return null;
+        }
+    }
+    /**
+     * Register a user override for a service key. Overrides take precedence
+     * over catalog-extracted costs.
+     */
+    registerOverride(serviceKey, costPerUnit, per) {
+        this._overrides.set(serviceKey, { costPerUnit, per });
+    }
+    /**
+     * Refresh the catalog from a remote URL.
+     */
+    async refreshFromUrl(url) {
+        try {
+            const response = await fetch(url);
+            if (!response.ok)
+                return;
+            const text = await response.text();
+            let raw;
+            try {
+                raw = JSON.parse(text);
+            }
+            catch {
+                return; // Malformed JSON — keep using existing catalog
+            }
+            this._entries.clear();
+            this._loadFromJson(raw);
+            this._version = createHash("sha256")
+                .update(JSON.stringify(raw))
+                .digest("hex")
+                .slice(0, 12);
+        }
+        catch {
+            // Network error — keep using existing catalog
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    _loadFromJson(raw) {
+        for (const [key, value] of Object.entries(raw)) {
+            if (key === "_meta")
+                continue;
+            this._entries.set(key, value);
+        }
+    }
+    _computeCostFromUnits(units, entry) {
+        if (entry.cost_per_credit_usd !== undefined) {
+            const rate = parseFloat(entry.cost_per_credit_usd);
+            if (isNaN(rate))
+                return null;
+            return units * rate;
+        }
+        if (entry.cost_per_read_unit_usd !== undefined) {
+            const rate = parseFloat(entry.cost_per_read_unit_usd);
+            if (isNaN(rate))
+                return null;
+            return units * rate;
+        }
+        if (entry.cost_per_compute_unit_usd !== undefined) {
+            const rate = parseFloat(entry.cost_per_compute_unit_usd);
+            if (isNaN(rate))
+                return null;
+            return units * rate;
+        }
+        if (entry.cost_per_1k_characters_usd !== undefined) {
+            const rate = parseFloat(entry.cost_per_1k_characters_usd);
+            if (isNaN(rate))
+                return null;
+            return (units / 1000) * rate;
+        }
+        if (entry.cost_per_minute_usd !== undefined) {
+            const rate = parseFloat(entry.cost_per_minute_usd);
+            if (isNaN(rate))
+                return null;
+            return units * rate;
+        }
+        // Default: multiply units by fixed cost
+        const fixedCost = getFixedCost(entry);
+        if (fixedCost === null)
+            return null;
+        return units * fixedCost;
+    }
+    _fallbackResult(entry, serviceName) {
+        const extraction = entry.cost_extraction;
+        if (extraction.fallback_credits !== undefined && entry.cost_per_credit_usd !== undefined) {
+            const rate = parseFloat(entry.cost_per_credit_usd);
+            if (isNaN(rate))
+                return null;
+            return {
+                costUsd: extraction.fallback_credits * rate,
+                confidence: "estimated",
+                serviceName,
+                pricingSource: "service_catalog",
+            };
+        }
+        // Fall back to fixed cost
+        const costUsd = getFixedCost(entry);
+        if (costUsd === null)
+            return null;
+        return {
+            costUsd,
+            confidence: costUsd > 0 ? "estimated" : "unknown",
+            serviceName,
+            pricingSource: "service_catalog",
+        };
+    }
+}
+//# sourceMappingURL=service-catalog.js.map

package/dist/pricing/service-catalog.js.map

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

package/dist/schema/dexcost-event.v1.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://dexcost.io/schemas/dexcost-event.v1.json",
+  "title": "Dexcost Event v1",
+  "description": "Standard Event Schema v1 — Event payload. Represents a single cost-generating event within a task.",
+  "type": "object",
+  "required": [
+    "event_id",
+    "task_id",
+    "event_type",
+    "occurred_at",
+    "cost_usd",
+    "cost_confidence",
+    "schema_version"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "event_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Unique identifier for the event."
+    },
+    "task_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "UUID of the parent task this event belongs to."
+    },
+    "event_type": {
+      "type": "string",
+      "enum": ["llm_call", "external_cost", "compute_cost", "retry_marker", "network", "gpu_cost", "gpu_utilization_signal"],
+      "description": "Discriminator for the event category."
+    },
+    "occurred_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO-8601 timestamp when the event occurred."
+    },
+    "cost_usd": {
+      "type": "string",
+      "pattern": "^-?\\d+(\\.\\d+)?$",
+      "description": "Cost of this event in USD (Decimal as string)."
+    },
+    "cost_confidence": {
+      "type": "string",
+      "enum": ["exact", "computed", "estimated", "unknown"],
+      "description": "How trustworthy the reported cost_usd value is."
+    },
+    "pricing_source": {
+      "type": ["string", "null"],
+      "description": "Where the cost_usd figure was derived from (litellm, tokencost, provider_response, manual)."
+    },
+    "pricing_version": {
+      "type": ["string", "null"],
+      "description": "Version of the pricing data used."
+    },
+    "service_name": {
+      "type": ["string", "null"],
+      "description": "Name of the service that generated this cost event."
+    },
+    "provider": {
+      "type": ["string", "null"],
+      "description": "LLM provider name (e.g. openai, anthropic). Null for non-LLM events."
+    },
+    "model": {
+      "type": ["string", "null"],
+      "description": "LLM model identifier (e.g. gpt-4o). Null for non-LLM events."
+    },
+    "input_tokens": {
+      "type": ["integer", "null"],
+      "minimum": 0,
+      "description": "Input token count. Null for non-LLM events."
+    },
+    "output_tokens": {
+      "type": ["integer", "null"],
+      "minimum": 0,
+      "description": "Output token count. Null for non-LLM events."
+    },
+    "cached_tokens": {
+      "type": ["integer", "null"],
+      "minimum": 0,
+      "description": "Cached token count. Null for non-LLM events."
+    },
+    "latency_ms": {
+      "type": ["integer", "null"],
+      "minimum": 0,
+      "description": "Latency in milliseconds. Null for non-LLM events."
+    },
+    "is_retry": {
+      "type": "boolean",
+      "description": "Whether this event is a retry of a previous event."
+    },
+    "retry_reason": {
+      "type": ["string", "null"],
+      "description": "Reason for the retry (rate_limit, timeout, parse_error, 5xx)."
+    },
+    "retry_of": {
+      "type": ["string", "null"],
+      "format": "uuid",
+      "description": "UUID of the original event this is a retry of."
+    },
+    "details": {
+      "type": "object",
+      "description": "Extensible type-specific details."
+    },
+    "schema_version": {
+      "type": "string",
+      "const": "1",
+      "description": "Schema version — always '1' for v1 payloads."
+    }
+  }
+}