@dexcost/sdk 0.2.0

package/dist/core/cgroup-reader.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Cgroup v2 file readers (node-only, browser-safe).
+ *
+ * Fail-silent contract (convention §9): every read returns `null` on missing
+ * or malformed input. Non-Linux hosts, cgroup-v1 kernels, browsers, and
+ * containers without a cgroup mount all silently return `null` — the caller
+ * decides the fallback.
+ *
+ * Backed file layouts (all under `/sys/fs/cgroup/`):
+ *
+ * - `cpu.stat`         — multi-line; `usage_usec <N>` is the cumulative CPU
+ *                        time consumed (microseconds). Read at task start +
+ *                        end to compute vcpu-seconds for long-running runtimes.
+ * - `cpu.max`          — single line `<quota|"max"> <period>` (both in
+ *                        microseconds). `quota/period` is the vCPU count
+ *                        enforced on this cgroup; `"max"` means no limit
+ *                        (fall back to `os.cpus().length`).
+ * - `memory.peak`      — single integer (bytes); the high-water mark since
+ *                        cgroup creation. Available on kernels >= 5.19;
+ *                        absent otherwise.
+ * - `memory.max`       — single integer (bytes) or `"max"` (unlimited).
+ * - `memory.current`   — single integer (bytes); the current RSS.
+ *
+ * Mirrors `python/src/dexcost/cgroup_reader.py`.
+ */
+export interface CpuStat {
+    /** Cumulative CPU time consumed (microseconds). */
+    usageUsec: number;
+}
+export interface CpuMax {
+    /** Period quota in microseconds, or `null` when cgroup is unlimited. */
+    quotaUs: number | null;
+    /** Period length in microseconds. */
+    periodUs: number;
+    /** Computed `quotaUs / periodUs`; `os.cpus().length` when unlimited. */
+    vcpuCount: number;
+}
+/** Test-only — override the cgroup root. Pass `null` to restore default. */
+export declare function _setCgroupRootForTests(p: string | null): void;
+export declare function readCpuStat(): CpuStat | null;
+export declare function readCpuMax(): CpuMax | null;
+export declare function readMemoryPeak(): number | null;
+export declare function readMemoryMax(): number | null;
+export declare function readMemoryCurrent(): number | null;
+//# sourceMappingURL=cgroup-reader.d.ts.map

package/dist/core/cgroup-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cgroup-reader.d.ts","sourceRoot":"","sources":["../../src/core/cgroup-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH,MAAM,WAAW,OAAO;IACtB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,wEAAwE;IACxE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE7D;AA0BD,wBAAgB,WAAW,IAAI,OAAO,GAAG,IAAI,CAe5C;AAED,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAkB1C;AAED,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAG9C;AAED,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAG7C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAGjD"}

package/dist/core/cgroup-reader.js

@@ -0,0 +1,124 @@
+/**
+ * Cgroup v2 file readers (node-only, browser-safe).
+ *
+ * Fail-silent contract (convention §9): every read returns `null` on missing
+ * or malformed input. Non-Linux hosts, cgroup-v1 kernels, browsers, and
+ * containers without a cgroup mount all silently return `null` — the caller
+ * decides the fallback.
+ *
+ * Backed file layouts (all under `/sys/fs/cgroup/`):
+ *
+ * - `cpu.stat`         — multi-line; `usage_usec <N>` is the cumulative CPU
+ *                        time consumed (microseconds). Read at task start +
+ *                        end to compute vcpu-seconds for long-running runtimes.
+ * - `cpu.max`          — single line `<quota|"max"> <period>` (both in
+ *                        microseconds). `quota/period` is the vCPU count
+ *                        enforced on this cgroup; `"max"` means no limit
+ *                        (fall back to `os.cpus().length`).
+ * - `memory.peak`      — single integer (bytes); the high-water mark since
+ *                        cgroup creation. Available on kernels >= 5.19;
+ *                        absent otherwise.
+ * - `memory.max`       — single integer (bytes) or `"max"` (unlimited).
+ * - `memory.current`   — single integer (bytes); the current RSS.
+ *
+ * Mirrors `python/src/dexcost/cgroup_reader.py`.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { cpus } from "node:os";
+let _cgroupRoot = "/sys/fs/cgroup";
+/** Test-only — override the cgroup root. Pass `null` to restore default. */
+export function _setCgroupRootForTests(p) {
+    _cgroupRoot = p ?? "/sys/fs/cgroup";
+}
+function _isNode() {
+    return typeof process !== "undefined" && !!process.versions?.node;
+}
+function _readText(name) {
+    if (!_isNode())
+        return null;
+    try {
+        return readFileSync(join(_cgroupRoot, name), "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+function _readInt(name) {
+    const raw = _readText(name);
+    if (raw === null)
+        return null;
+    const trimmed = raw.trim();
+    if (trimmed === "max")
+        return null;
+    const n = Number(trimmed);
+    if (!Number.isFinite(n) || Number.isNaN(n))
+        return null;
+    if (!/^-?\d+$/.test(trimmed))
+        return null;
+    return n;
+}
+export function readCpuStat() {
+    if (!_isNode())
+        return null;
+    const raw = _readText("cpu.stat");
+    if (raw === null)
+        return null;
+    for (const line of raw.split("\n")) {
+        if (line.startsWith("usage_usec ")) {
+            const parts = line.split(/\s+/);
+            if (parts.length < 2)
+                return null;
+            const n = Number(parts[1]);
+            if (!Number.isFinite(n) || Number.isNaN(n))
+                return null;
+            if (!/^-?\d+$/.test(parts[1]))
+                return null;
+            return { usageUsec: n };
+        }
+    }
+    return null;
+}
+export function readCpuMax() {
+    if (!_isNode())
+        return null;
+    const raw = _readText("cpu.max");
+    if (raw === null)
+        return null;
+    const parts = raw.trim().split(/\s+/);
+    if (parts.length !== 2)
+        return null;
+    const periodUs = Number(parts[1]);
+    if (!Number.isFinite(periodUs) || Number.isNaN(periodUs))
+        return null;
+    if (!/^-?\d+$/.test(parts[1]))
+        return null;
+    if (periodUs <= 0)
+        return null;
+    if (parts[0] === "max") {
+        const n = cpus().length || 1;
+        return { quotaUs: null, periodUs, vcpuCount: n };
+    }
+    const quotaUs = Number(parts[0]);
+    if (!Number.isFinite(quotaUs) || Number.isNaN(quotaUs))
+        return null;
+    if (!/^-?\d+$/.test(parts[0]))
+        return null;
+    return { quotaUs, periodUs, vcpuCount: quotaUs / periodUs };
+}
+export function readMemoryPeak() {
+    if (!_isNode())
+        return null;
+    return _readInt("memory.peak");
+}
+export function readMemoryMax() {
+    if (!_isNode())
+        return null;
+    return _readInt("memory.max");
+}
+export function readMemoryCurrent() {
+    if (!_isNode())
+        return null;
+    return _readInt("memory.current");
+}
+//# sourceMappingURL=cgroup-reader.js.map

package/dist/core/cgroup-reader.js.map

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

package/dist/core/cgroup-walker.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Cgroup-scope classifier — Phase 2 GPU foundation Decision #1.
+ *
+ * Reads `/proc/self/cgroup` and classifies the cgroup scope by prefix into
+ * one of:
+ *
+ * - "container"            — kubepods.slice / docker / containerd / crio /
+ *                            system.slice/{docker,containerd,crio}-.
+ *                            cgroup.procs enumerates the container's PIDs.
+ * - "bare_metal_user_slice" — `/user.slice/...` (systemd user session).
+ *                            Walking would capture every PID in the SSH
+ *                            session, not just dexcost's task. Degrade to
+ *                            self-PID-only at `estimated` confidence with
+ *                            pricing_source suffix :no_container_scope.
+ * - "root_cgroup"          — `/` (privileged single-tenant host). Ambiguous;
+ *                            degrade to self-PID-only.
+ * - "cgroup_v1"            — multi-line file (multiple v1 controllers).
+ *                            v1.1 will walk; v1 degrades to self-PID-only.
+ * - "unknown"              — anything else.
+ *
+ * **Browser safety**: returns "unknown" off-Node.
+ *
+ * Mirrors python/src/dexcost/cgroup_walker.py.
+ */
+/** Test-only — override /proc/self/cgroup path. Pass null to restore. */
+export declare function _setProcSelfCgroupPathForTests(p: string | null): void;
+/** Test-only — override the cgroup root. Pass null to restore. */
+export declare function _setCgroupRootForTests(p: string | null): void;
+export declare function _resetWarningStateForTests(): void;
+export type CgroupScopeKind = "container" | "bare_metal_user_slice" | "root_cgroup" | "cgroup_v1" | "unknown";
+export interface CgroupScope {
+    kind: CgroupScopeKind;
+    /** Unified cgroup-v2 path for `container` scope; null for every other kind. */
+    path: string | null;
+}
+export declare function classifyScope(): CgroupScope;
+/**
+ * Return the PID set to attribute GPU usage to.
+ *
+ * - container scope → walk `<cgroupRoot><scope.path>/cgroup.procs`. Returns
+ *   `null` (NOT empty list) on read failure — signals the caller to log-
+ *   once `gpu_cgroup_walk_forbidden` and fall back.
+ * - every other scope → return `[process.pid]`. Bare-metal-no-container
+ *   deliberately does NOT walk the systemd user slice (which would capture
+ *   unrelated user PIDs — the silent-overcount case).
+ *
+ * Off-Node, returns `[1]` as a non-failing placeholder (matches Python
+ * semantics where `os.getpid()` is always available in CPython; in TS the
+ * browser doesn't have a PID so we surface a benign sentinel).
+ */
+export declare function enumeratePids(scope: CgroupScope): number[] | null;
+/**
+ * Map scope kind to the pricing_source suffix per Decision #1.
+ *
+ * - container → null (full-fidelity attribution; no suffix)
+ * - bare_metal_user_slice / root_cgroup → "no_container_scope"
+ * - cgroup_v1 / unknown → "self_pid_only"
+ */
+export declare function fallbackLabelFor(scope: CgroupScope): string | null;
+//# sourceMappingURL=cgroup-walker.d.ts.map

package/dist/core/cgroup-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cgroup-walker.d.ts","sourceRoot":"","sources":["../../src/core/cgroup-walker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAUH,yEAAyE;AACzE,wBAAgB,8BAA8B,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAErE;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE7D;AAMD,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAkCD,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,uBAAuB,GACvB,aAAa,GACb,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAID,wBAAgB,aAAa,IAAI,WAAW,CAwC3C;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,GAAG,IAAI,CA6BjE;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAMlE"}

package/dist/core/cgroup-walker.js

@@ -0,0 +1,166 @@
+/**
+ * Cgroup-scope classifier — Phase 2 GPU foundation Decision #1.
+ *
+ * Reads `/proc/self/cgroup` and classifies the cgroup scope by prefix into
+ * one of:
+ *
+ * - "container"            — kubepods.slice / docker / containerd / crio /
+ *                            system.slice/{docker,containerd,crio}-.
+ *                            cgroup.procs enumerates the container's PIDs.
+ * - "bare_metal_user_slice" — `/user.slice/...` (systemd user session).
+ *                            Walking would capture every PID in the SSH
+ *                            session, not just dexcost's task. Degrade to
+ *                            self-PID-only at `estimated` confidence with
+ *                            pricing_source suffix :no_container_scope.
+ * - "root_cgroup"          — `/` (privileged single-tenant host). Ambiguous;
+ *                            degrade to self-PID-only.
+ * - "cgroup_v1"            — multi-line file (multiple v1 controllers).
+ *                            v1.1 will walk; v1 degrades to self-PID-only.
+ * - "unknown"              — anything else.
+ *
+ * **Browser safety**: returns "unknown" off-Node.
+ *
+ * Mirrors python/src/dexcost/cgroup_walker.py.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+// ─── Module state (testable) ────────────────────────────────────────────────
+let _procSelfCgroupPath = "/proc/self/cgroup";
+let _cgroupRoot = "/sys/fs/cgroup";
+/** Test-only — override /proc/self/cgroup path. Pass null to restore. */
+export function _setProcSelfCgroupPathForTests(p) {
+    _procSelfCgroupPath = p ?? "/proc/self/cgroup";
+}
+/** Test-only — override the cgroup root. Pass null to restore. */
+export function _setCgroupRootForTests(p) {
+    _cgroupRoot = p ?? "/sys/fs/cgroup";
+}
+// ─── Warn-once state ────────────────────────────────────────────────────────
+const _warnedModes = new Set();
+export function _resetWarningStateForTests() {
+    _warnedModes.clear();
+}
+function _warnOnce(mode, message) {
+    if (_warnedModes.has(mode))
+        return;
+    _warnedModes.add(mode);
+    // eslint-disable-next-line no-console
+    console.warn(message);
+}
+// ─── Browser-safety guard ───────────────────────────────────────────────────
+function _isNode() {
+    return typeof process !== "undefined" && !!process.versions?.node;
+}
+// ─── Decision #1 prefix table (priority order) ──────────────────────────────
+const CONTAINER_PREFIXES = [
+    "/kubepods.slice/",
+    "/kubepods/",
+    "/docker/",
+    "/system.slice/docker-",
+    "/containerd/",
+    "/system.slice/containerd-",
+    "/crio/",
+    "/system.slice/crio-",
+];
+const BARE_METAL_PREFIXES = [
+    "/user.slice/",
+];
+// ─── Classification ─────────────────────────────────────────────────────────
+export function classifyScope() {
+    if (!_isNode()) {
+        return { kind: "unknown", path: null };
+    }
+    let raw;
+    try {
+        raw = readFileSync(_procSelfCgroupPath, "utf-8");
+    }
+    catch {
+        return { kind: "unknown", path: null };
+    }
+    const lines = raw
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0);
+    if (lines.length === 0) {
+        return { kind: "unknown", path: null };
+    }
+    // cgroup v1 → multiple controller lines; cgroup v2 → single "0::/path".
+    if (lines.length > 1 || !lines[0].startsWith("0::")) {
+        return { kind: "cgroup_v1", path: null };
+    }
+    const path = lines[0].substring(3); // strip "0::" prefix
+    if (path === "/" || path === "") {
+        return { kind: "root_cgroup", path: null };
+    }
+    for (const prefix of CONTAINER_PREFIXES) {
+        if (path.startsWith(prefix)) {
+            return { kind: "container", path };
+        }
+    }
+    for (const prefix of BARE_METAL_PREFIXES) {
+        if (path.startsWith(prefix)) {
+            return { kind: "bare_metal_user_slice", path: null };
+        }
+    }
+    return { kind: "unknown", path: null };
+}
+// ─── PID enumeration ────────────────────────────────────────────────────────
+/**
+ * Return the PID set to attribute GPU usage to.
+ *
+ * - container scope → walk `<cgroupRoot><scope.path>/cgroup.procs`. Returns
+ *   `null` (NOT empty list) on read failure — signals the caller to log-
+ *   once `gpu_cgroup_walk_forbidden` and fall back.
+ * - every other scope → return `[process.pid]`. Bare-metal-no-container
+ *   deliberately does NOT walk the systemd user slice (which would capture
+ *   unrelated user PIDs — the silent-overcount case).
+ *
+ * Off-Node, returns `[1]` as a non-failing placeholder (matches Python
+ * semantics where `os.getpid()` is always available in CPython; in TS the
+ * browser doesn't have a PID so we surface a benign sentinel).
+ */
+export function enumeratePids(scope) {
+    if (!_isNode()) {
+        return [1];
+    }
+    if (scope.kind !== "container" || scope.path === null) {
+        return [process.pid];
+    }
+    const cgroupProcsPath = join(_cgroupRoot + scope.path, "cgroup.procs");
+    let raw;
+    try {
+        raw = readFileSync(cgroupProcsPath, "utf-8");
+    }
+    catch (err) {
+        _warnOnce("gpu_cgroup_walk_forbidden", `Could not read ${cgroupProcsPath} (${String(err)}); ` +
+            `GpuAccountant will degrade to self-PID-only`);
+        return null;
+    }
+    const pids = [];
+    for (const line of raw.split("\n")) {
+        const s = line.trim();
+        if (!s)
+            continue;
+        const n = parseInt(s, 10);
+        if (!Number.isNaN(n))
+            pids.push(n);
+    }
+    return pids;
+}
+// ─── Decision #1 confidence labelling ───────────────────────────────────────
+/**
+ * Map scope kind to the pricing_source suffix per Decision #1.
+ *
+ * - container → null (full-fidelity attribution; no suffix)
+ * - bare_metal_user_slice / root_cgroup → "no_container_scope"
+ * - cgroup_v1 / unknown → "self_pid_only"
+ */
+export function fallbackLabelFor(scope) {
+    if (scope.kind === "container")
+        return null;
+    if (scope.kind === "bare_metal_user_slice" || scope.kind === "root_cgroup") {
+        return "no_container_scope";
+    }
+    return "self_pid_only";
+}
+//# sourceMappingURL=cgroup-walker.js.map

package/dist/core/cgroup-walker.js.map

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

package/dist/core/compute-accountant.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Per-task compute accountant.
+ *
+ * Holds start cgroup snapshot + runtime context for one dexcost task. At
+ * task finalize, emits exactly one `compute_cost` event with
+ * `cost_pending: true` — the pricing engine back-fills `cost_usd` via the
+ * deferred-cost pattern inherited from network v2 §6.4.
+ *
+ * Capture §5.3 invariant: at most one event per task per runtime. Idempotent —
+ * second call to snapshotEndAndBuild / buildServerlessEvent returns null.
+ *
+ * TS is single-threaded → freeze flag is sufficient, no mutex needed.
+ *
+ * Mirrors python/src/dexcost/compute_accountant.py.
+ */
+import { RuntimeKind } from "./compute-runtime.js";
+export interface ComputeAccountantOptions {
+    runtime: RuntimeKind;
+    lambdaMemoryMb?: number;
+    fargateVcpu?: number;
+    fargateMemoryMib?: number;
+    architecture?: string;
+    initializationType?: string;
+    region?: string;
+}
+export declare class ComputeAccountant {
+    private _frozen;
+    private _startCpuUsec;
+    readonly runtime: RuntimeKind;
+    readonly lambdaMemoryMb: number | undefined;
+    readonly fargateVcpu: number | undefined;
+    readonly fargateMemoryMib: number | undefined;
+    readonly architecture: string;
+    readonly initializationType: string | undefined;
+    readonly region: string | undefined;
+    constructor(opts: ComputeAccountantOptions);
+    /** Capture the cgroup CPU counter at task start. Idempotent. */
+    snapshotStart(): void;
+    /**
+     * Capture cgroup CPU/memory at task end and build the event details.
+     *
+     * Returns null if already frozen (second call) or runtime is unknown.
+     */
+    snapshotEndAndBuild(durationMs: number): Record<string, any> | null;
+    /**
+     * Build a per-invocation event for Lambda / Cloud Run / Cloud Functions /
+     * Azure Functions / Vercel.
+     */
+    buildServerlessEvent(durationMs: number, memoryBytesPeak: number): Record<string, any> | null;
+}
+//# sourceMappingURL=compute-accountant.d.ts.map

package/dist/core/compute-accountant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-accountant.d.ts","sourceRoot":"","sources":["../../src/core/compute-accountant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAyCnD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,WAAW,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAuB;IAE5C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;gBAExB,IAAI,EAAE,wBAAwB;IAe1C,gEAAgE;IAChE,aAAa,IAAI,IAAI;IAMrB;;;;OAIG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAwCnE;;;OAGG;IACH,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;CAmC9B"}

package/dist/core/compute-accountant.js

@@ -0,0 +1,179 @@
+/**
+ * Per-task compute accountant.
+ *
+ * Holds start cgroup snapshot + runtime context for one dexcost task. At
+ * task finalize, emits exactly one `compute_cost` event with
+ * `cost_pending: true` — the pricing engine back-fills `cost_usd` via the
+ * deferred-cost pattern inherited from network v2 §6.4.
+ *
+ * Capture §5.3 invariant: at most one event per task per runtime. Idempotent —
+ * second call to snapshotEndAndBuild / buildServerlessEvent returns null.
+ *
+ * TS is single-threaded → freeze flag is sufficient, no mutex needed.
+ *
+ * Mirrors python/src/dexcost/compute_accountant.py.
+ */
+import { cpus } from "node:os";
+import { readCpuMax, readCpuStat, readMemoryCurrent, readMemoryMax, readMemoryPeak, } from "./cgroup-reader.js";
+import { RuntimeKind } from "./compute-runtime.js";
+/** Map a RuntimeKind to the details.billing_model discriminator. */
+function billingModelFor(runtime) {
+    switch (runtime) {
+        case RuntimeKind.Lambda:
+            return "lambda";
+        case RuntimeKind.Fargate:
+            return "fargate";
+        case RuntimeKind.Ec2:
+            return "ec2";
+        case RuntimeKind.Gce:
+            return "gce";
+        case RuntimeKind.AzureVm:
+            return "azure_vm";
+        case RuntimeKind.CloudRun:
+            return "cloud_run_request";
+        case RuntimeKind.CloudFunctions:
+            return "cloud_functions";
+        case RuntimeKind.AzureFunctions:
+            return "azure_functions";
+        case RuntimeKind.Vercel:
+            return "vercel_fluid";
+        case RuntimeKind.K8sPod:
+            return "k8s_pod";
+        default:
+            return "unknown";
+    }
+}
+function _isNode() {
+    return typeof process !== "undefined" && !!process.versions?.node;
+}
+function detectArch() {
+    if (!_isNode())
+        return "x86_64";
+    const a = process.arch;
+    if (a === "arm64" || a === "arm")
+        return "arm64";
+    return "x86_64";
+}
+export class ComputeAccountant {
+    _frozen = false;
+    _startCpuUsec = null;
+    runtime;
+    lambdaMemoryMb;
+    fargateVcpu;
+    fargateMemoryMib;
+    architecture;
+    initializationType;
+    region;
+    constructor(opts) {
+        this.runtime = opts.runtime;
+        this.lambdaMemoryMb = opts.lambdaMemoryMb;
+        this.fargateVcpu = opts.fargateVcpu;
+        this.fargateMemoryMib = opts.fargateMemoryMib;
+        this.architecture = opts.architecture ?? detectArch();
+        this.initializationType = opts.initializationType;
+        this.region = opts.region;
+    }
+    // ------------------------------------------------------------------
+    // Long-running runtimes (Fargate / EC2 / GCE / Azure VM / K8s pod /
+    // Cloud Run instance-based)
+    // ------------------------------------------------------------------
+    /** Capture the cgroup CPU counter at task start. Idempotent. */
+    snapshotStart() {
+        if (this._startCpuUsec !== null)
+            return;
+        const s = readCpuStat();
+        this._startCpuUsec = s ? s.usageUsec : 0;
+    }
+    /**
+     * Capture cgroup CPU/memory at task end and build the event details.
+     *
+     * Returns null if already frozen (second call) or runtime is unknown.
+     */
+    snapshotEndAndBuild(durationMs) {
+        if (this._frozen)
+            return null;
+        this._frozen = true;
+        const startCpu = this._startCpuUsec ?? 0;
+        const end = readCpuStat();
+        const cpuMax = readCpuMax();
+        // Capture §6 case 6 — memory.peak missing → fall back to memory.current.
+        let memPeak = readMemoryPeak();
+        if (memPeak === null) {
+            memPeak = readMemoryCurrent() ?? 0;
+        }
+        const memLimit = readMemoryMax() ?? 0;
+        let vcpuSecondsUsed = 0;
+        if (end !== null && end.usageUsec >= startCpu) {
+            vcpuSecondsUsed = (end.usageUsec - startCpu) / 1_000_000;
+        }
+        const vcpuCount = cpuMax ? cpuMax.vcpuCount : _nproc();
+        return {
+            billing_model: billingModelFor(this.runtime),
+            duration_ms: durationMs,
+            memory_bytes_peak: Math.trunc(memPeak),
+            memory_bytes_limit: Math.trunc(memLimit),
+            vcpu_count: vcpuCount,
+            vcpu_seconds_used: vcpuSecondsUsed,
+            invocation_count: 0,
+            region: this.region ?? null,
+            architecture: this.architecture,
+            initialization_type: null,
+            cost_pending: true,
+        };
+    }
+    // ------------------------------------------------------------------
+    // Serverless runtimes
+    // ------------------------------------------------------------------
+    /**
+     * Build a per-invocation event for Lambda / Cloud Run / Cloud Functions /
+     * Azure Functions / Vercel.
+     */
+    buildServerlessEvent(durationMs, memoryBytesPeak) {
+        if (this._frozen)
+            return null;
+        this._frozen = true;
+        let memLimit;
+        let vcpuCount;
+        if (this.runtime === RuntimeKind.Lambda) {
+            // Lambda's AWS_LAMBDA_FUNCTION_MEMORY_SIZE is DECIMAL MB.
+            memLimit = (this.lambdaMemoryMb ?? 128) * 1_000_000;
+            vcpuCount = vcpuCountFromCgroup();
+        }
+        else if (this.runtime === RuntimeKind.Fargate) {
+            memLimit = (this.fargateMemoryMib ?? 0) * 1024 * 1024;
+            vcpuCount =
+                this.fargateVcpu !== undefined ? this.fargateVcpu : vcpuCountFromCgroup();
+        }
+        else {
+            // Cloud Run / Cloud Functions / Azure Functions / Vercel —
+            // cgroup memory.max is the declared limit.
+            memLimit = readMemoryMax() ?? memoryBytesPeak;
+            vcpuCount = vcpuCountFromCgroup();
+        }
+        return {
+            billing_model: billingModelFor(this.runtime),
+            duration_ms: durationMs,
+            memory_bytes_peak: memoryBytesPeak,
+            memory_bytes_limit: memLimit,
+            vcpu_count: vcpuCount,
+            vcpu_seconds_used: 0,
+            invocation_count: 1,
+            region: this.region ?? null,
+            architecture: this.architecture,
+            initialization_type: this.initializationType ?? null,
+            cost_pending: true,
+        };
+    }
+}
+function _nproc() {
+    if (!_isNode())
+        return 1;
+    return cpus().length || 1;
+}
+function vcpuCountFromCgroup() {
+    const cpuMax = readCpuMax();
+    if (cpuMax !== null)
+        return cpuMax.vcpuCount;
+    return _nproc();
+}
+//# sourceMappingURL=compute-accountant.js.map

package/dist/core/compute-accountant.js.map

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