badgr-llm-guard 0.1.0

package/README.md

@@ -0,0 +1,171 @@
+# badgr-llm-guard
+
+Wrap any AI API call with automatic retries, spend caps, timeouts, and request receipts — so you never get a silent failure or a surprise bill.
+
+```ts
+import { withGuard } from "badgr-llm-guard";
+
+const guardedCall = withGuard({ maxRetries: 3, timeoutMs: 30_000, maxSpendUsd: 5 });
+const result = await guardedCall(() => openai.chat.completions.create(request));
+```
+
+**Free. No signup required.** Works with any AI provider.
+
+---
+
+## The problem it solves
+
+AI API calls fail in frustrating ways: rate limits with no backoff, silent timeouts that hang forever, and costs that spiral when something loops. `badgr-llm-guard` adds a safety layer around any AI call — automatic `Retry-After` handling, hard spend caps, and receipts that tell you exactly what was spent.
+
+---
+
+## Quick start
+
+```bash
+npm install badgr-llm-guard
+```
+
+```ts
+import { withGuard } from "badgr-llm-guard";
+import OpenAI from "openai";
+
+const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+
+const guardedCall = withGuard({
+  maxRetries: 3,       // retry on 429, 408, and 5xx
+  timeoutMs: 30_000,   // abort if no response after 30s
+  maxSpendUsd: 5,      // throw if cumulative spend exceeds $5
+});
+
+const result = await guardedCall(() =>
+  openai.chat.completions.create({
+    model: "gpt-4o",
+    messages: [{ role: "user", content: "Summarize this document..." }],
+  })
+);
+```
+
+---
+
+## Options
+
+```ts
+withGuard({
+  maxRetries?: number;      // How many times to retry on 429/408/5xx (default: 2)
+  timeoutMs?: number;       // Abort after this many ms (default: 30_000)
+  maxSpendUsd?: number;     // Throw if cumulative spend exceeds this amount
+  receipt?: "terminal"      // Print receipt to terminal after each call (default)
+          | "json"          // Return receipt as JSON
+          | "none";         // Suppress receipt output
+  estimateCostUsd?: (attempt: number) => number;  // Custom cost estimator
+})
+```
+
+---
+
+## Retry behaviour
+
+| HTTP status | Action |
+|---|---|
+| `429` | Read `Retry-After` header, wait, then retry |
+| `408` | Retry immediately |
+| `5xx` | Retry with exponential backoff |
+| Other errors | Do not retry — throw immediately |
+
+---
+
+## Spend cap
+
+The guard reads cost from `x-badgr-cost-usd` or `x-cost-usd` response headers. If cumulative spend plus the estimated next call would exceed `maxSpendUsd`, the call is blocked and an error is thrown — before the request is made.
+
+```ts
+const guardedCall = withGuard({ maxSpendUsd: 1 });
+
+try {
+  await guardedCall(() => openai.chat.completions.create(...)); // $0.40
+  await guardedCall(() => openai.chat.completions.create(...)); // $0.40
+  await guardedCall(() => openai.chat.completions.create(...)); // throws — would exceed $1
+} catch (e) {
+  console.log(e.message); // "Spend cap exceeded: $0.80 spent, $1.00 limit"
+}
+```
+
+---
+
+## Receipts
+
+Every call produces a receipt:
+
+```
+badgr-llm-guard receipt
+  request-id  req_7f3a9b2c
+  attempts    2 (1 retry after 429)
+  status      200
+  cost        $0.004
+  total spent $0.008
+```
+
+---
+
+## CLI — check which API keys are configured
+
+```bash
+npx badgr-llm-guard check
+# ✓  OPENAI_API_KEY      set
+# ✓  ANTHROPIC_API_KEY   set
+# ✗  GEMINI_API_KEY      not set
+# ✗  BADGR_API_KEY       not set
+
+npx badgr-llm-guard demo   # show a withGuard usage example
+```
+
+---
+
+## TypeScript API
+
+```ts
+import { withGuard, createGuardedClient } from "badgr-llm-guard";
+
+// Wrap any async function
+const guardedCall = withGuard({ maxRetries: 2, timeoutMs: 30_000 });
+const result = await guardedCall(() => myAiSdkCall());
+console.log(guardedCall.getSpentUsd());   // total spend so far
+console.log(guardedCall.getLastReport()); // full JSON report
+
+// Low-level HTTP client (for providers without an SDK)
+const client = createGuardedClient({
+  apiKey: process.env.BADGR_API_KEY,
+  baseUrl: "https://api.aibadgr.com/v1",
+  maxRetries: 3,
+  timeoutMs: 30_000,
+  maxSpendUsd: 10,
+});
+const response = await client.request("/chat/completions", {
+  method: "POST",
+  body: JSON.stringify({ model: "...", messages: [...] }),
+});
+```
+
+---
+
+## Optional: AI Badgr provider fallback
+
+If local retries are exhausted, route to AI Badgr as a fallback provider:
+
+```ts
+import OpenAI from "openai";
+
+const openai = new OpenAI({
+  apiKey: process.env.BADGR_API_KEY,
+  baseURL: "https://api.aibadgr.com/v1",  // drop-in OpenAI-compatible endpoint
+});
+
+const guardedCall = withGuard({ maxRetries: 3 });
+const result = await guardedCall(() => openai.chat.completions.create(request));
+```
+
+---
+
+## Requirements
+
+- Node.js 18+

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+import { createLogger, fireTelemetry } from "badgr-shared";
+import { withGuard } from "./index.js";
+fireTelemetry({ package: "badgr-llm-guard", command: process.argv[2] });
+function readArg(name) {
+    const index = process.argv.indexOf(name);
+    return index >= 0 ? process.argv[index + 1] : undefined;
+}
+const command = process.argv[2];
+const json = process.argv.includes("--json");
+const logger = createLogger(json);
+if (!command || command === "--help" || command === "-h") {
+    console.log(`badgr-llm-guard — local retry, spend cap, timeout, and receipt wrapper for LLM calls
+
+Usage:
+  badgr-llm-guard check                   Check which LLM API keys are configured
+  badgr-llm-guard demo                    Show withGuard usage example
+  badgr-llm-guard --help                  Show this help
+
+Flags:
+  --json                                  Output machine-readable JSON
+
+Library usage (no CLI needed):
+  import { withGuard, createGuardedClient } from "badgr-llm-guard";
+
+  const guarded = withGuard({ maxRetries: 3, timeoutMs: 30_000, maxSpendUsd: 2 });
+  const result  = await guarded(() => openai.chat.completions.create(request));
+
+Environment:
+  BADGR_TELEMETRY=0     Disable anonymous usage telemetry`);
+    process.exit(0);
+}
+if (command === "check") {
+    const providers = {
+        "OPENAI_API_KEY": Boolean(process.env.OPENAI_API_KEY),
+        "ANTHROPIC_API_KEY": Boolean(process.env.ANTHROPIC_API_KEY),
+        "GEMINI_API_KEY": Boolean(process.env.GEMINI_API_KEY),
+        "OPENROUTER_API_KEY": Boolean(process.env.OPENROUTER_API_KEY),
+        "BADGR_API_KEY": Boolean(process.env.BADGR_API_KEY),
+    };
+    const configured = Object.entries(providers).filter(([, v]) => v).map(([k]) => k);
+    const missing = Object.entries(providers).filter(([, v]) => !v).map(([k]) => k);
+    if (json) {
+        console.log(JSON.stringify({
+            tool: "badgr-llm-guard",
+            status: configured.length > 0 ? "passed" : "warning",
+            summary: configured.length > 0
+                ? `${configured.length} provider key(s) configured`
+                : "No LLM provider keys found in environment",
+            configured,
+            missing,
+            generatedAt: new Date().toISOString(),
+        }, null, 2));
+    }
+    else {
+        logger.line("badgr-llm-guard — provider key check");
+        logger.line("");
+        for (const [key, present] of Object.entries(providers)) {
+            logger.line(`${present ? "✓" : "✗"} ${key}${present ? " (set)" : " (missing)"}`);
+        }
+        logger.line("");
+        if (configured.length > 0) {
+            logger.line(`${configured.length} provider(s) ready for guarded calls.`);
+        }
+        else {
+            logger.line("No LLM API keys detected. Set one of the keys above before using withGuard.");
+        }
+        logger.line("");
+        logger.line("Optional: route calls through the AI Badgr gateway for multi-provider fallback:");
+        logger.line("  baseURL: https://api.aibadgr.com/v1");
+    }
+    process.exitCode = configured.length > 0 ? 0 : 1;
+    process.exit();
+}
+if (command === "demo") {
+    console.log(`// badgr-llm-guard — library usage demo
+
+import { withGuard, createGuardedClient } from "badgr-llm-guard";
+
+// Wrap any async SDK call:
+const guarded = withGuard({ maxRetries: 3, timeoutMs: 30_000, maxSpendUsd: 2, receipt: "terminal" });
+const result  = await guarded(() => openai.chat.completions.create({ model: "gpt-4o", messages }));
+
+// Or wrap a raw fetch client:
+const client = createGuardedClient({ apiKey: process.env.OPENAI_API_KEY, maxRetries: 2, maxSpendUsd: 5 });
+const res    = await client.request("/chat/completions", { method: "POST", body: JSON.stringify(body) });
+
+// Spend tracking:
+console.log("spent:", client.getSpentUsd(), "USD");
+
+// Optional AI Badgr gateway for multi-provider fallback (no signup required for local guarding):
+//   baseURL: "https://api.aibadgr.com/v1"`);
+    process.exit(0);
+}
+// Unrecognised command — show helpful error.
+const guardedCheck = withGuard({ maxRetries: 0, timeoutMs: 1, receipt: "none" });
+void guardedCheck;
+console.error(`badgr-llm-guard: unknown command "${command}"`);
+console.error("Run badgr-llm-guard --help for usage.");
+process.exit(2);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { type JsonReport } from "badgr-shared";
+export interface GuardedClientOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    maxRetries?: number;
+    timeoutMs?: number;
+    maxSpendUsd?: number;
+    receipt?: "terminal" | "json" | "none";
+    fetchImpl?: typeof fetch;
+}
+export interface GuardOptions extends Omit<GuardedClientOptions, "apiKey" | "baseUrl" | "fetchImpl"> {
+    estimateCostUsd?: (attempt: number) => number;
+}
+export interface GuardedRequestInit extends RequestInit {
+    estimatedCostUsd?: number;
+}
+export interface GuardReceipt {
+    requestId: string;
+    attempts: number;
+    status: number | "failed" | "completed";
+    costUsd: number;
+    spentUsd: number;
+}
+export interface GuardedClient {
+    request(path: string, init?: GuardedRequestInit): Promise<Response>;
+    getSpentUsd(): number;
+    getLastReport(): JsonReport | undefined;
+}
+export type GuardedCall = (<T>(fn: () => Promise<T> | T) => Promise<T>) & {
+    getSpentUsd(): number;
+    getLastReport(): JsonReport | undefined;
+};
+export declare function withGuard(options: GuardOptions): GuardedCall;
+export declare function createGuardedClient(options: GuardedClientOptions): GuardedClient;
+//# 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,EAAiD,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE9F,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IACvC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IAClG,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,WAAW,IAAI,MAAM,CAAC;IACtB,aAAa,IAAI,UAAU,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG;IACxE,WAAW,IAAI,MAAM,CAAC;IACtB,aAAa,IAAI,UAAU,GAAG,SAAS,CAAC;CACzC,CAAC;AAIF,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAoC5D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAqDhF"}

package/dist/index.js

@@ -0,0 +1,196 @@
+import { BadgrToolError, createReport, createRequestId } from "badgr-shared";
+const DEFAULT_BASE_URL = "https://api.aibadgr.com/v1";
+export function withGuard(options) {
+    const maxRetries = options.maxRetries ?? 2;
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    let spentUsd = 0;
+    let lastReport;
+    const guarded = async function guarded(fn) {
+        const requestId = createRequestId("llm");
+        let attempt = 0;
+        let lastError;
+        while (attempt <= maxRetries) {
+            attempt += 1;
+            assertSpendCap(spentUsd, options.maxSpendUsd, options.estimateCostUsd?.(attempt) ?? 0);
+            try {
+                const result = await withTimeout(Promise.resolve().then(fn), timeoutMs);
+                const costUsd = options.estimateCostUsd?.(attempt) ?? 0;
+                assertSpendCap(spentUsd, options.maxSpendUsd, costUsd);
+                spentUsd += costUsd;
+                lastReport = buildGuardReport("passed", requestId, attempt, spentUsd, undefined);
+                writeReceipt(options.receipt ?? "terminal", { requestId, attempts: attempt, status: "completed", costUsd, spentUsd }, lastReport);
+                return result;
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt > maxRetries || !isRetryableFailure(error))
+                    break;
+                await sleep(retryDelayFromError(error) ?? 250 * attempt);
+            }
+        }
+        lastReport = buildGuardReport("failed", requestId, attempt, spentUsd, lastError);
+        writeLocalOnlyFailure(lastError, maxRetries, options.receipt ?? "terminal", lastReport);
+        throw new BadgrToolError(`Primary provider failed after ${maxRetries} retries. Cause: ${failureCause(lastError)}`, "LLM_GUARD_REQUEST_FAILED", { requestId, attempts: attempt });
+    };
+    guarded.getSpentUsd = () => spentUsd;
+    guarded.getLastReport = () => lastReport;
+    return guarded;
+}
+export function createGuardedClient(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const maxRetries = options.maxRetries ?? 2;
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+    let spentUsd = 0;
+    let lastReport;
+    async function request(path, init = {}) {
+        const requestId = createRequestId("llm");
+        assertSpendCap(spentUsd, options.maxSpendUsd, init.estimatedCostUsd ?? 0);
+        let attempt = 0;
+        let lastError;
+        while (attempt <= maxRetries) {
+            attempt += 1;
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                const response = await fetchImpl(toUrl(baseUrl, path), {
+                    ...init,
+                    signal: controller.signal,
+                    headers: {
+                        ...(options.apiKey ? { authorization: `Bearer ${options.apiKey}` } : {}),
+                        "x-request-id": requestId,
+                        ...(init.headers ?? {}),
+                    },
+                });
+                clearTimeout(timer);
+                if (shouldRetry(response.status) && attempt <= maxRetries) {
+                    await sleep(retryDelayMs(response));
+                    continue;
+                }
+                const costUsd = readCostUsd(response);
+                assertSpendCap(spentUsd, options.maxSpendUsd, costUsd);
+                spentUsd += costUsd;
+                lastReport = buildGuardReport(response.ok ? "passed" : "failed", requestId, attempt, spentUsd, response.status);
+                writeReceipt(options.receipt ?? "terminal", { requestId, attempts: attempt, status: response.status, costUsd, spentUsd }, lastReport);
+                return response;
+            }
+            catch (error) {
+                clearTimeout(timer);
+                lastError = error;
+                if (attempt > maxRetries || !isTransientError(error))
+                    break;
+                await sleep(250 * attempt);
+            }
+        }
+        lastReport = buildGuardReport("failed", requestId, attempt, spentUsd, lastError);
+        writeLocalOnlyFailure(lastError, maxRetries, options.receipt ?? "terminal", lastReport);
+        throw new BadgrToolError(`AI request ${requestId} failed after ${attempt} attempts: ${String(lastError)}`, "LLM_GUARD_REQUEST_FAILED", { requestId, attempts: attempt });
+    }
+    return { request, getSpentUsd: () => spentUsd, getLastReport: () => lastReport };
+}
+function toUrl(baseUrl, path) {
+    if (/^https?:\/\//.test(path))
+        return path;
+    return `${baseUrl.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
+}
+function shouldRetry(status) {
+    return status === 429 || status === 408 || (status >= 500 && status <= 599);
+}
+function retryDelayMs(response) {
+    const retryAfter = response.headers.get("retry-after");
+    if (!retryAfter)
+        return 500;
+    const seconds = Number(retryAfter);
+    if (Number.isFinite(seconds))
+        return Math.max(0, seconds * 1000);
+    const dateMs = Date.parse(retryAfter);
+    return Number.isFinite(dateMs) ? Math.max(0, dateMs - Date.now()) : 500;
+}
+function retryDelayFromError(error) {
+    const retryAfter = readErrorStatus(error)?.retryAfter;
+    if (retryAfter === undefined)
+        return undefined;
+    const seconds = Number(retryAfter);
+    if (Number.isFinite(seconds))
+        return Math.max(0, seconds * 1000);
+    const dateMs = Date.parse(String(retryAfter));
+    return Number.isFinite(dateMs) ? Math.max(0, dateMs - Date.now()) : undefined;
+}
+function readCostUsd(response) {
+    const header = response.headers.get("x-badgr-cost-usd") ?? response.headers.get("x-cost-usd");
+    const parsed = header ? Number(header) : 0;
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function assertSpendCap(spentUsd, maxSpendUsd, nextCostUsd) {
+    if (maxSpendUsd !== undefined && spentUsd + nextCostUsd > maxSpendUsd) {
+        throw new BadgrToolError(`Spend cap exceeded: $${(spentUsd + nextCostUsd).toFixed(4)} would exceed $${maxSpendUsd.toFixed(4)}`, "LLM_GUARD_SPEND_CAP", { spentUsd, nextCostUsd, maxSpendUsd });
+    }
+}
+function isRetryableFailure(error) {
+    const status = readErrorStatus(error)?.status;
+    return status !== undefined ? shouldRetry(status) : isTransientError(error);
+}
+function isTransientError(error) {
+    return error instanceof Error && (error.name === "AbortError" || /timeout|network|fetch/i.test(error.message));
+}
+function readErrorStatus(error) {
+    if (!error || typeof error !== "object")
+        return undefined;
+    const candidate = error;
+    const status = typeof candidate.status === "number" ? candidate.status : typeof candidate.response?.status === "number" ? candidate.response.status : undefined;
+    const retryAfter = candidate.retryAfter ?? candidate.headers?.get("retry-after") ?? candidate.response?.headers?.get("retry-after") ?? undefined;
+    return { status, retryAfter: typeof retryAfter === "string" || typeof retryAfter === "number" ? retryAfter : undefined };
+}
+function failureCause(error) {
+    const status = readErrorStatus(error)?.status;
+    if (status)
+        return `HTTP ${status}`;
+    return error instanceof Error ? error.message : String(error);
+}
+function withTimeout(promise, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new DOMException("timeout", "AbortError")), timeoutMs);
+        promise.then((value) => { clearTimeout(timer); resolve(value); }, (error) => { clearTimeout(timer); reject(error); });
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, Math.min(ms, 30_000)));
+}
+function buildGuardReport(status, requestId, attempts, spentUsd, cause) {
+    const failed = status === "failed";
+    return createReport({
+        tool: "llm-guard",
+        reportId: `rpt_${requestId}`,
+        status,
+        summary: failed ? "Primary provider failed in local-only mode" : "Local LLM guard completed the request",
+        findings: [{ severity: failed ? "error" : "info", code: failed ? "LLM_PRIMARY_PROVIDER_FAILED" : "LLM_LOCAL_GUARD_OK", message: failed ? `Cause: ${failureCause(cause)}` : `Request completed after ${attempts} attempt(s).` }],
+        recommendedActions: failed ? ["Enable provider fallback with AI Badgr: baseURL https://api.aibadgr.com/v1"] : ["Keep local retry and spend caps enabled"],
+        nextCommand: "Set baseURL to https://api.aibadgr.com/v1 for provider fallback",
+        actionUrl: "https://aibadgr.com/dashboard",
+        metadata: { requestId, attempts, spentUsd },
+    });
+}
+function writeReceipt(mode, receipt, report) {
+    if (mode === "none")
+        return;
+    if (mode === "json") {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    console.log(`AI Badgr receipt ${receipt.requestId}: status ${receipt.status}, attempts ${receipt.attempts}, cost $${receipt.costUsd.toFixed(4)}, session spend $${receipt.spentUsd.toFixed(4)}`);
+}
+function writeLocalOnlyFailure(error, maxRetries, mode, report) {
+    if (mode === "none")
+        return;
+    if (mode === "json") {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    console.log(`Primary provider failed after ${maxRetries} retries.`);
+    console.log(`Cause: ${failureCause(error)}`);
+    console.log("Fallback unavailable in local-only mode.");
+    console.log("");
+    console.log("Enable provider fallback with AI Badgr:");
+    console.log('baseURL: "https://api.aibadgr.com/v1"');
+}
+//# 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,16 @@
+{
+  "name": "badgr-llm-guard",
+  "version": "0.1.0",
+  "description": "Thin guarded AI API client with retries, Retry-After support, spend caps, request IDs, and receipts.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": { "badgr-llm-guard": "dist/cli.js" },
+  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
+  "files": ["dist", "README.md"],
+  "scripts": { "build": "tsc -b", "typecheck": "tsc -b --pretty false", "test": "vitest run" },
+  "dependencies": { "badgr-shared": "0.1.1" },
+  "engines": { "node": ">=18.0.0" },
+  "keywords": ["llm", "retry", "rate-limit", "timeout", "spend-cap", "gateway"],
+  "license": "MIT"
+}