margin-meter 0.1.0

package/README.md

@@ -0,0 +1,110 @@
+# margin-meter (TypeScript SDK)
+
+The tiny client a **TypeScript/JavaScript** project imports to connect to
+Margin — the TS twin of the Python [`margin-meter`](../python) package. It wraps
+your LLM calls and records their outcomes, emitting each one **over HTTP** to a
+Margin **ingest API** (`POST /api/ingest/calls` / `/api/ingest/outcomes`),
+authenticated with a per-project ingest key.
+
+- **Dependency-free.** Uses the global `fetch` — nothing to install at runtime.
+- **Fail-safe.** A failed emit resolves to `{ ok: false, … }` instead of throwing.
+  Pass `raiseOnError: true` for strict/CI behaviour.
+- **Provenance-honest.** `isSimulated` is carried through untouched; the written
+  `source` is forced server-side to your key's project — you cannot spoof another
+  project's economics.
+
+## Install
+
+Published as a git-installable subpath of the Margin repo (no npm registry
+account needed pre-launch):
+
+```bash
+npm install margin-meter
+# or, pinning the subdirectory with your package manager of choice, e.g. pnpm:
+# pnpm add "https://gitpkg.now.sh/subhsubh24/Margin.ai/sdk/ts?main"
+```
+
+Most TS projects import the source directly (their bundler compiles it); the
+package `exports` point at `src/index.ts` with types.
+
+## Configure
+
+Two environment variables — the deployed API base and your project's key:
+
+```bash
+export MARGIN_INGEST_URL="https://margin-ai-rho.vercel.app"
+export MARGIN_INGEST_KEY="mgk_…"   # issued by the Margin owner
+```
+
+The Margin owner issues your project a key with the provisioning CLI in the
+Margin repo (`python3 scripts/issue_ingest_key.py <your-project-slug>`). The raw
+`mgk_…` key is shown once — only its hash is stored.
+
+## Use
+
+```ts
+import { MarginMeter } from "margin-meter";
+
+const meter = new MarginMeter(); // reads MARGIN_INGEST_URL + MARGIN_INGEST_KEY
+
+// 1) Wrap the LLM call — latency is timed automatically, cost computed server-side.
+const answer = await meter.measure(
+  { workflowId: "cart-parse", provider: "google", model: "gemini-2.5-flash" },
+  async (m) => {
+    const resp = await callTheModel(/* … */);
+    m.setTokens({ inputTokens: 1200, outputTokens: 300, cacheReadTokens: 800 });
+    return resp;
+  },
+);
+
+// 2) Record the outcome it produced (the unit of productivity).
+await meter.recordOutcome({
+  workflowId: "cart-parse",
+  passed: true,
+  qualityScore: 0.94,
+  qualityMethod: "ground_truth",
+});
+```
+
+Or record a call directly:
+
+```ts
+const res = await meter.recordCall({
+  workflowId: "cart-parse",
+  provider: "google",
+  model: "gemini-2.5-flash",
+  inputTokens: 1200,
+  outputTokens: 300,
+});
+if (!res.ok) console.warn(`margin ingest failed: ${res.error} (${res.statusCode})`);
+```
+
+## API
+
+| Method | Emits to | Notes |
+| --- | --- | --- |
+| `recordCall(input)` | `POST /api/ingest/calls` | cost computed from the pricing table when `costUsd` omitted |
+| `recordOutcome(input)` | `POST /api/ingest/outcomes` | `qualityMethod` records HOW the score was graded |
+| `measure(input, fn)` | `recordCall` on completion | times latency; `status:"error"` + rethrow if `fn` throws; returns `fn`'s value, emit result on `m.result` |
+
+Every method resolves to an `IngestResult { ok, statusCode, body?, error? }`.
+`ok` is true only on HTTP 200; `body` holds `call_id`/`outcome_id` + `source`.
+
+## Testing against the ingest contract (no network)
+
+The network boundary is a single `post(path, { json, headers })` protocol, so a
+test can inject a fake that mimics the ingest API's documented 200/401/422/429
+responses:
+
+```ts
+const meter = new MarginMeter({ apiKey: "mgk_…", transport: fakeIngest, raiseOnError: true });
+```
+
+See `test/meter.test.mjs`. Run with `npm test`
+(`node --experimental-strip-types --test test/*.test.mjs` — zero deps).
+
+## Rate + validation bounds
+
+Ingest is auth'd, validated, and rate-bounded server-side: bad key → 401,
+malformed/implausible row → 422, full rolling per-project window → 429. In
+fail-safe mode these come back as `{ ok: false, statusCode }`.

package/dist/index.d.ts

@@ -0,0 +1,138 @@
+/**
+ * margin-meter — the TypeScript SDK a project imports to connect to Margin.
+ *
+ * The TS twin of the Python `margin_meter` package: a tiny, dependency-free
+ * client the three TS siblings (GroceryManager, HighlightMagic, AptDesignerAI)
+ * — or any real customer — drop in to wrap their LLM calls and record the
+ * outcomes, emitting each one OVER HTTP to Margin's ingest API
+ * (`POST /api/ingest/calls` / `/api/ingest/outcomes`), authenticated with a
+ * per-project ingest key.
+ *
+ * Design goals (mirroring the Python SDK):
+ *  - **Dependency-free.** Uses the global `fetch` — no runtime deps to install.
+ *  - **Pluggable transport (hermetically testable).** The network boundary is a
+ *    single `post(path, { json, headers })` protocol, so a test can inject a
+ *    fake that faithfully mimics the ingest API's documented 200/401/422/429
+ *    responses. Production uses `fetch`.
+ *  - **Fail-safe by default.** Telemetry must never crash the host, so a failed
+ *    emit resolves to an `IngestResult { ok: false, ... }` instead of throwing.
+ *    Pass `raiseOnError: true` for strict/CI behaviour.
+ *  - **Provenance-honest.** `isSimulated` is carried through untouched; the
+ *    written `source` is forced server-side to the key's project slug — the
+ *    client cannot spoof another project's economics.
+ */
+export declare const CALLS_PATH = "/api/ingest/calls";
+export declare const OUTCOMES_PATH = "/api/ingest/outcomes";
+export declare const KEY_HEADER = "X-Margin-Key";
+export declare const DEFAULT_INGEST_URL = "http://127.0.0.1:8000";
+export declare const DEFAULT_TIMEOUT_MS = 10000;
+/** The outcome of one emit. Returned by every record call. */
+export interface IngestResult {
+    /** True only on an HTTP 200. */
+    ok: boolean;
+    /** The HTTP status, or 0 for a transport/config failure. */
+    statusCode: number;
+    /** The parsed success payload (`call_id`/`outcome_id` + `source`) when ok. */
+    body?: Record<string, unknown>;
+    /** The failure reason, when not ok. */
+    error?: string;
+}
+/** The response shape a transport returns (a subset of the `fetch` Response). */
+export interface TransportResponse {
+    status: number;
+    json(): Promise<unknown>;
+}
+/** The single network-boundary protocol. `fetch` (via FetchTransport) and any
+ *  test fake both satisfy it. */
+export interface Transport {
+    post(path: string, opts: {
+        json: unknown;
+        headers: Record<string, string>;
+    }): Promise<TransportResponse>;
+}
+/** Raised (only in strict mode) when a row is rejected by the ingest API. */
+export declare class MarginIngestError extends Error {
+    statusCode: number;
+    detail: string;
+    constructor(statusCode: number, detail: string);
+}
+/** Raised (only in strict mode) when the client is missing its ingest key. */
+export declare class MarginConfigError extends Error {
+    constructor(message: string);
+}
+/** The default transport: POST JSON over HTTP with the global `fetch`. */
+export declare class FetchTransport implements Transport {
+    baseUrl: string;
+    timeoutMs: number;
+    constructor(baseUrl: string, timeoutMs?: number);
+    post(path: string, opts: {
+        json: unknown;
+        headers: Record<string, string>;
+    }): Promise<TransportResponse>;
+}
+export interface MarginMeterOptions {
+    ingestUrl?: string;
+    apiKey?: string;
+    transport?: Transport;
+    timeoutMs?: number;
+    raiseOnError?: boolean;
+}
+export interface RecordCallInput {
+    workflowId: string;
+    provider: string;
+    model: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheReadTokens?: number;
+    latencyMs?: number;
+    status?: string;
+    isRetry?: boolean;
+    sessionId?: string;
+    promptId?: string;
+    costUsd?: number;
+    isSimulated?: boolean;
+}
+export interface RecordOutcomeInput {
+    workflowId: string;
+    passed: boolean;
+    qualityScore?: number;
+    qualityMethod?: string;
+    link?: string;
+    isSimulated?: boolean;
+}
+/** A per-project client that emits measured economics to a Margin ingest API. */
+export declare class MarginMeter {
+    ingestUrl: string;
+    apiKey?: string;
+    raiseOnError: boolean;
+    private transport;
+    constructor(options?: MarginMeterOptions);
+    private emit;
+    /** Emit one measured LLM call. Cost is computed server-side when `costUsd`
+     *  is omitted. Never throws unless `raiseOnError`. */
+    recordCall(input: RecordCallInput): Promise<IngestResult>;
+    /** Emit one outcome (a unit of productivity). `qualityMethod` records HOW the
+     *  score was graded so a self-report is never mistaken for a graded number. */
+    recordOutcome(input: RecordOutcomeInput): Promise<IngestResult>;
+    /**
+     * Time an async call and emit it on completion. The TS analogue of the
+     * Python `measure` context manager: latency is timed automatically, and the
+     * call is emitted with `status="error"` (and the error re-thrown) if `fn`
+     * throws. Set token counts inside `fn` via `m.setTokens(...)`. Returns the
+     * value `fn` produced; the emit's `IngestResult` is available as `m.result`.
+     */
+    measure<T>(input: Omit<RecordCallInput, "latencyMs" | "status">, fn: (m: Measurement) => Promise<T> | T): Promise<T>;
+}
+/** Token accumulator passed into `measure`'s callback. */
+export declare class Measurement {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    result?: IngestResult;
+    setTokens(tokens: {
+        inputTokens?: number;
+        outputTokens?: number;
+        cacheReadTokens?: number;
+    }): void;
+}
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,205 @@
+/**
+ * margin-meter — the TypeScript SDK a project imports to connect to Margin.
+ *
+ * The TS twin of the Python `margin_meter` package: a tiny, dependency-free
+ * client the three TS siblings (GroceryManager, HighlightMagic, AptDesignerAI)
+ * — or any real customer — drop in to wrap their LLM calls and record the
+ * outcomes, emitting each one OVER HTTP to Margin's ingest API
+ * (`POST /api/ingest/calls` / `/api/ingest/outcomes`), authenticated with a
+ * per-project ingest key.
+ *
+ * Design goals (mirroring the Python SDK):
+ *  - **Dependency-free.** Uses the global `fetch` — no runtime deps to install.
+ *  - **Pluggable transport (hermetically testable).** The network boundary is a
+ *    single `post(path, { json, headers })` protocol, so a test can inject a
+ *    fake that faithfully mimics the ingest API's documented 200/401/422/429
+ *    responses. Production uses `fetch`.
+ *  - **Fail-safe by default.** Telemetry must never crash the host, so a failed
+ *    emit resolves to an `IngestResult { ok: false, ... }` instead of throwing.
+ *    Pass `raiseOnError: true` for strict/CI behaviour.
+ *  - **Provenance-honest.** `isSimulated` is carried through untouched; the
+ *    written `source` is forced server-side to the key's project slug — the
+ *    client cannot spoof another project's economics.
+ */
+export const CALLS_PATH = "/api/ingest/calls";
+export const OUTCOMES_PATH = "/api/ingest/outcomes";
+export const KEY_HEADER = "X-Margin-Key";
+export const DEFAULT_INGEST_URL = "http://127.0.0.1:8000";
+export const DEFAULT_TIMEOUT_MS = 10_000;
+/** Raised (only in strict mode) when a row is rejected by the ingest API. */
+export class MarginIngestError extends Error {
+    statusCode;
+    detail;
+    constructor(statusCode, detail) {
+        super(`ingest rejected (${statusCode}): ${detail}`);
+        this.name = "MarginIngestError";
+        this.statusCode = statusCode;
+        this.detail = detail;
+    }
+}
+/** Raised (only in strict mode) when the client is missing its ingest key. */
+export class MarginConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MarginConfigError";
+    }
+}
+/** The default transport: POST JSON over HTTP with the global `fetch`. */
+export class FetchTransport {
+    baseUrl;
+    timeoutMs;
+    constructor(baseUrl, timeoutMs = DEFAULT_TIMEOUT_MS) {
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.timeoutMs = timeoutMs;
+    }
+    async post(path, opts) {
+        return await fetch(this.baseUrl + path, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...opts.headers },
+            body: JSON.stringify(opts.json),
+            signal: AbortSignal.timeout(this.timeoutMs),
+        });
+    }
+}
+/** A per-project client that emits measured economics to a Margin ingest API. */
+export class MarginMeter {
+    ingestUrl;
+    apiKey;
+    raiseOnError;
+    transport;
+    constructor(options = {}) {
+        const env = (typeof process !== "undefined" && process.env) || {};
+        this.ingestUrl = options.ingestUrl || env.MARGIN_INGEST_URL || DEFAULT_INGEST_URL;
+        this.apiKey = options.apiKey || env.MARGIN_INGEST_KEY;
+        this.raiseOnError = options.raiseOnError ?? false;
+        this.transport =
+            options.transport ||
+                new FetchTransport(this.ingestUrl, options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    }
+    async emit(path, payload) {
+        if (!this.apiKey) {
+            const error = "no ingest key (set MARGIN_INGEST_KEY or pass apiKey)";
+            if (this.raiseOnError)
+                throw new MarginConfigError(error);
+            return { ok: false, statusCode: 0, error };
+        }
+        let resp;
+        try {
+            resp = await this.transport.post(path, {
+                json: payload,
+                headers: { [KEY_HEADER]: this.apiKey },
+            });
+        }
+        catch (e) {
+            const error = `transport error: ${e.message}`;
+            if (this.raiseOnError)
+                throw new MarginIngestError(0, e.message);
+            return { ok: false, statusCode: 0, error };
+        }
+        if (resp.status === 200) {
+            const body = (await resp.json());
+            return { ok: true, statusCode: 200, body };
+        }
+        const detail = await extractDetail(resp);
+        if (this.raiseOnError)
+            throw new MarginIngestError(resp.status, detail);
+        return { ok: false, statusCode: resp.status, error: detail };
+    }
+    /** Emit one measured LLM call. Cost is computed server-side when `costUsd`
+     *  is omitted. Never throws unless `raiseOnError`. */
+    async recordCall(input) {
+        const payload = {
+            workflow_id: input.workflowId,
+            provider: input.provider,
+            model: input.model,
+            input_tokens: input.inputTokens ?? 0,
+            output_tokens: input.outputTokens ?? 0,
+            cache_read_tokens: input.cacheReadTokens ?? 0,
+            latency_ms: input.latencyMs ?? 0,
+            status: input.status ?? "ok",
+            is_retry: input.isRetry ?? false,
+            is_simulated: input.isSimulated ?? false,
+        };
+        if (input.sessionId !== undefined)
+            payload.session_id = input.sessionId;
+        if (input.promptId !== undefined)
+            payload.prompt_id = input.promptId;
+        if (input.costUsd !== undefined)
+            payload.cost_usd = input.costUsd;
+        return await this.emit(CALLS_PATH, payload);
+    }
+    /** Emit one outcome (a unit of productivity). `qualityMethod` records HOW the
+     *  score was graded so a self-report is never mistaken for a graded number. */
+    async recordOutcome(input) {
+        const payload = {
+            workflow_id: input.workflowId,
+            passed: input.passed,
+            is_simulated: input.isSimulated ?? false,
+        };
+        if (input.qualityScore !== undefined)
+            payload.quality_score = input.qualityScore;
+        if (input.qualityMethod !== undefined)
+            payload.quality_method = input.qualityMethod;
+        if (input.link !== undefined)
+            payload.link = input.link;
+        return await this.emit(OUTCOMES_PATH, payload);
+    }
+    /**
+     * Time an async call and emit it on completion. The TS analogue of the
+     * Python `measure` context manager: latency is timed automatically, and the
+     * call is emitted with `status="error"` (and the error re-thrown) if `fn`
+     * throws. Set token counts inside `fn` via `m.setTokens(...)`. Returns the
+     * value `fn` produced; the emit's `IngestResult` is available as `m.result`.
+     */
+    async measure(input, fn) {
+        const m = new Measurement();
+        const start = now();
+        let threw = false;
+        try {
+            return await fn(m);
+        }
+        catch (e) {
+            threw = true;
+            throw e;
+        }
+        finally {
+            const latencyMs = Math.round(now() - start);
+            m.result = await this.recordCall({
+                ...input,
+                inputTokens: m.inputTokens,
+                outputTokens: m.outputTokens,
+                cacheReadTokens: m.cacheReadTokens,
+                latencyMs,
+                status: threw ? "error" : "ok",
+            });
+        }
+    }
+}
+/** Token accumulator passed into `measure`'s callback. */
+export class Measurement {
+    inputTokens = 0;
+    outputTokens = 0;
+    cacheReadTokens = 0;
+    result;
+    setTokens(tokens) {
+        this.inputTokens = tokens.inputTokens ?? 0;
+        this.outputTokens = tokens.outputTokens ?? 0;
+        this.cacheReadTokens = tokens.cacheReadTokens ?? 0;
+    }
+}
+async function extractDetail(resp) {
+    try {
+        const body = await resp.json();
+        if (body && typeof body === "object" && "detail" in body) {
+            return String(body.detail);
+        }
+        return JSON.stringify(body);
+    }
+    catch {
+        return "unparseable error body";
+    }
+}
+function now() {
+    return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "margin-meter",
+  "version": "0.1.0",
+  "description": "Tiny dependency-free client that emits LLM call + outcome economics to a Margin ingest API.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "test": "node --experimental-strip-types --test test/*.test.mjs",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": ["llm", "cost", "observability", "finops", "margin"],
+  "license": "MIT",
+  "repository": { "type": "git", "url": "https://github.com/subhsubh24/Margin.ai.git", "directory": "sdk/ts" },
+  "engines": { "node": ">=18" },
+  "devDependencies": { "@types/node": "^20.0.0", "typescript": "^5.4.0" }
+}