@anvailabs/sandhi 0.5.0

package/__test__/typed_error.test.mjs

@@ -0,0 +1,48 @@
+// SandhiProviderError rewrap contract (TD-0008 P2/C): typed payloads become the
+// class; binding-internal failures pass through untouched.
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { createRequire } from "node:module";
+
+const require = createRequire(import.meta.url);
+const sandhi = require("../sandhi.js");
+
+test("SandhiProviderError exposes typed fields from a ProviderErrorV1 payload", () => {
+  const payload = {
+    code: "upstream_error",
+    message: "upstream status 400: bad tool pairing",
+    retryable: false,
+    http_status: 400,
+    provider: "moonshot",
+    request_id: "req_abc",
+    details: { upstream_body: "{\"error\":\"bad tool pairing\"}" },
+  };
+  const err = new sandhi.SandhiProviderError(payload, JSON.stringify(payload));
+  assert.equal(err.name, "SandhiProviderError");
+  assert.equal(err.code, "upstream_error");
+  assert.equal(err.httpStatus, 400);
+  assert.equal(err.retryable, false);
+  assert.equal(err.requestId, "req_abc");
+  assert.ok(err instanceof Error);
+  assert.equal(err.details.upstream_body, "{\"error\":\"bad tool pairing\"}");
+});
+
+test("async iterator rewraps typed error messages and passes others through", async () => {
+  const typedJson = JSON.stringify({ code: "rate_limited", message: "rate limited (429)", retryable: true, http_status: 429 });
+  const makeStream = (error) => {
+    const stream = Object.create(sandhi.TypedEventStream.prototype);
+    stream.read = async () => { throw error; };
+    return stream;
+  };
+
+  await assert.rejects(
+    async () => { for await (const _ of makeStream(new Error(typedJson))) { /* drain */ } },
+    (err) => err instanceof sandhi.SandhiProviderError && err.code === "rate_limited" && err.retryable === true
+  );
+
+  const plain = new Error("segfault in binding");
+  await assert.rejects(
+    async () => { for await (const _ of makeStream(plain)) { /* drain */ } },
+    (err) => err === plain && !(err instanceof sandhi.SandhiProviderError)
+  );
+});

package/build.rs

@@ -0,0 +1,3 @@
+fn main() {
+    napi_build::setup();
+}

package/contracts.d.ts

@@ -0,0 +1,63 @@
+// Generated by scripts/gen-binding-contract-facades.py; DO NOT EDIT.
+// schema-sha256: 0eff7885fe2a40495027f8ae846d4acef93c0b76cf712b6c16f72fa4c97bebe7
+export type JsonValue = unknown
+export type Role = "developer" | "system" | "user" | "assistant" | "tool" | "function"
+export type FinishReasonV1 = "stop" | "length" | "tool_calls" | "content_filter" | "function_call" | "unknown"
+export type UsageCompleteness = "final" | "partial" | "unavailable"
+export type UsageBasis = "provider_reported" | "estimated"
+export type ContentPart =
+  | { type: "text"; text: string }
+  | { type: "image_url"; image_url: string; detail?: string }
+  | { type: "input_audio"; data: string; format: string }
+  | { type: "file"; file_id?: string; file_data?: string; filename?: string }
+export type MessageContent = string | ContentPart[]
+export interface ToolCallV1 { id: string; name: string; arguments: string; extensions?: Record<string, JsonValue> }
+export type ChatMessageV1 =
+  | { role: "developer" | "system" | "user"; content: MessageContent; name?: string }
+  | { role: "assistant"; content?: MessageContent; name?: string; tool_calls?: ToolCallV1[]; refusal?: string }
+  | { role: "tool"; content: MessageContent; tool_call_id: string }
+  | { role: "function"; content: MessageContent; name: string }
+export interface ToolDefinitionV1 { name: string; parameters: JsonValue; description?: string; strict?: boolean }
+export interface RequestMetadataV1 { session_id?: string; virtual_key_id?: string; subject_id?: string; group_id?: string; route?: string }
+export interface ThinkingV1 { enabled: boolean; budget_tokens?: number }
+export interface ChatRequestV1 {
+  schema_version?: "1"; model: string; messages: ChatMessageV1[]; tools?: ToolDefinitionV1[]
+  tool_choice?: "none" | "auto" | "required" | { name: string }; temperature?: number
+  max_output_tokens?: number; stop?: string[]; response_format?: JsonValue; seed?: number
+  metadata?: RequestMetadataV1; reasoning_effort?: string; thinking?: ThinkingV1
+  include_native_response?: boolean
+  extensions?: Record<string, JsonValue>
+}
+export interface UsageV2 {
+  tokens_in: number; tokens_out: number; cache_creation_tokens: number; cache_read_tokens: number
+  completeness?: UsageCompleteness; basis?: UsageBasis; attempts?: number; outcome?: string
+  upstream_request_id?: string
+  duration_ms?: number; time_to_first_token_ms?: number
+  audio_input_tokens?: number; audio_output_tokens?: number; reasoning_tokens?: number
+  accepted_prediction_tokens?: number; rejected_prediction_tokens?: number
+}
+export interface LatencySummary { samples: number; p50_ms: number; p95_ms: number; ttft_p50_ms?: number }
+export interface UsageAggregateV1 {
+  key: string; calls: number; tokens_in: number; tokens_out: number;
+  cache_creation_tokens: number; cache_read_tokens: number; reasoning_tokens: number;
+  billable_tokens: number; latency?: LatencySummary
+}
+export interface AssistantOutputV1 { content?: MessageContent; tool_calls?: ToolCallV1[]; refusal?: string }
+export interface ChatResponseV1 {
+  schema_version: "1"; id?: string; model: string; output: AssistantOutputV1
+  finish_reason?: FinishReasonV1; usage: UsageV2; extensions?: Record<string, JsonValue>
+}
+export interface ProviderErrorV1 { code: string; message: string; retryable: boolean; http_status?: number; provider?: string; request_id?: string; details?: Record<string, JsonValue> }
+export type ChatStreamEventV1 =
+  | { event: "response_start"; id?: string; model: string }
+  | { event: "text_delta" | "reasoning_delta" | "refusal_delta"; delta: string }
+  | { event: "tool_call_start"; index: number; id: string; name: string }
+  | { event: "tool_call_arguments_delta"; index: number; delta: string }
+  | { event: "tool_call_end"; index: number }
+  | { event: "usage"; usage: UsageV2 }
+  | { event: "finish"; reason: FinishReasonV1 }
+  | { event: "error"; error: ProviderErrorV1 }
+export interface ProviderDescriptorV1 {
+  schema_version: "1"; slug: string; aliases?: string[]; endpoint_family: string; base_url: string
+  capabilities: Record<string, boolean>; models?: JsonValue[]; extensions?: Record<string, JsonValue>
+}

package/index.d.ts

@@ -0,0 +1,143 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/** The neutral token breakdown parsed from a provider response. */
+export interface UsageBreakdown {
+  tokensIn: number
+  tokensOut: number
+  cacheCreationTokens: number
+  cacheReadTokens: number
+}
+/** A neutral usage event (mirrors `usage-event.v1.schema.json`). */
+export interface Event {
+  schemaVersion: string
+  requestId: string
+  occurredAt: string
+  provider: string
+  model: string
+  backend: string
+  virtualKeyId?: string
+  subjectId?: string
+  groupId?: string
+  route?: string
+  sessionId?: string
+  tokensIn: number
+  tokensOut: number
+  cacheCreationTokens: number
+  cacheReadTokens: number
+  usageCompleteness: string
+  attempts: number
+  outcome?: string
+  upstreamRequestId?: string
+  gpuSeconds?: number
+}
+/** The usage-event wire-contract major version this build targets. */
+export declare function wireContractVersion(): string
+/**
+ * The neutral chat-contract (ChatRequestV1/ChatStreamEventV1) major version this
+ * build targets. Today equal to `wire_contract_version()` (pinned by a
+ * sandhi-core test); exported separately so a future split cannot silently
+ * invalidate consumer handshakes that validate the chat contract.
+ */
+export declare function chatContractVersion(): string
+/**
+ * Additive growth counter within the v1 chat contract (W3c). Consumers
+ * feature-detect this export — an older binding without it reads as minor 0
+ * — and gate trust in newer additive fields on a minimum minor.
+ */
+export declare function chatContractMinor(): number
+/**
+ * Resolve an OpenAI-compatible provider spec (slug, aliases, base_url) as JSON.
+ * Parity with the Python binding's `provider_spec` (TD-0008 P4); JSON here
+ * because napi objects would otherwise diverge from the schema'd facades.
+ */
+export declare function providerSpecJson(provider: string, model?: string | undefined | null): string
+/**
+ * Return a checked chat-contract JSON Schema document by name
+ * (e.g. "chat-stream-event.v1"). Parity with the Python binding.
+ */
+export declare function chatContractSchemaJson(name: string): string
+/** Return the versioned typed descriptor for a known provider as JSON. */
+export declare function providerDescriptorJson(provider: string): string
+/**
+ * Return the curated model descriptors for a known provider as a JSON list (TD-0004 catalog DATA).
+ * Carries facts only (id, context window, max output, capabilities); no pricing.
+ */
+export declare function providerModelsJson(provider: string): string
+/**
+ * Parse a provider response body (JSON string) into the neutral token breakdown. `provider`
+ * selects the parser: `anthropic` → the Anthropic Messages shape; anything else → OpenAI-compat.
+ */
+export declare function parseUsage(provider: string, responseJson: string): UsageBreakdown
+export type JsProviderRuntime = ProviderRuntime
+/**
+ * Persistent factory for typed provider handles. The HTTP pool, retry policy, and circuit
+ * breaker belong to each returned handle rather than being rebuilt for every request.
+ */
+export declare class ProviderRuntime {
+  constructor()
+  openaiCompat(provider: string, baseUrl: string, apiKey: string, headersJson?: string | undefined | null, maxRetries?: number | undefined | null, timeoutSecs?: number | undefined | null, streamIdleTimeoutSecs?: number | undefined | null): TypedProvider
+  openaiResponses(provider: string, baseUrl: string, bearerToken: string, headersJson?: string | undefined | null, maxRetries?: number | undefined | null, timeoutSecs?: number | undefined | null, streamIdleTimeoutSecs?: number | undefined | null): TypedProvider
+  provider(provider: string, model: string, apiKey: string, baseUrl?: string | undefined | null, headersJson?: string | undefined | null, maxRetries?: number | undefined | null, timeoutSecs?: number | undefined | null, streamIdleTimeoutSecs?: number | undefined | null, authScheme?: string | undefined | null, protocol?: string | undefined | null): TypedProvider
+}
+/** A persistent provider handle accepting Sandhi chat-contract v1 JSON documents. */
+export declare class TypedProvider {
+  get provider(): string
+  /**
+   * `wireHeadersJson` (optional, TD-0022 D1): per-call wire headers — a string map sent
+   * with THIS call only, for gateway-path metadata that changes per turn (e.g.
+   * `x-sandhi-step-id`). Transport-owned names are stripped and can never override the
+   * credential.
+   */
+  completeJson(requestJson: string, wireHeadersJson?: string | undefined | null): Promise<string>
+  /** `wireHeadersJson` (optional, TD-0022 D1): per-call wire headers, as `completeJson`. */
+  streamJson(requestJson: string, wireHeadersJson?: string | undefined | null): TypedEventStream
+}
+/** Pull-based stream of serialized `ChatStreamEventV1` documents. */
+export declare class TypedEventStream {
+  read(): Promise<string | null>
+}
+/** In-process metering middleware: virtual keys, budgets, and usage-event emission. */
+export declare class Gateway {
+  /** `sinkPath` — append emitted events as JSONL to this file (plus an in-memory buffer). */
+  constructor(sinkPath?: string | undefined | null)
+  /** Register a virtual key: `id` → subject/group attribution + an opaque `upstream` ref. */
+  addVirtualKey(id: string, subject?: string | undefined | null, group?: string | undefined | null, upstream?: string | undefined | null): void
+  /**
+   * Set a token budget on a scope (e.g. `group:platform`). Exposed as a 64-bit `bigint` (napi
+   * has no bare `u64`); negatives clamp to 0 — a budget is a non-negative token count.
+   */
+  setBudget(scope: string, tokens: number): void
+  /** Would `add` more tokens be within the scope's budget? */
+  checkBudget(scope: string, add: number): boolean
+  /** Tokens spent so far on a scope. */
+  spent(scope: string): number
+  /**
+   * Meter one completed call: parse usage from `responseJson` (built-in parser for `provider`),
+   * attribute it to `virtualKey`, emit the neutral event + record the budget, and return the
+   * event. Throws on an unknown virtual key or bad JSON.
+   */
+  meter(virtualKey: string, provider: string, model: string, responseJson: string, sessionId?: string | undefined | null, route?: string | undefined | null): Event
+  /**
+   * Meter from token counts you supply directly (bypass parsing) — the escape hatch for any
+   * provider Sandhi doesn't natively parse: do your own parsing and pass the counts. Same
+   * attribution + budget + emit as `meter()`.
+   */
+  meterTokens(virtualKey: string, provider: string, model: string, tokensIn: number, tokensOut: number, cacheCreationTokens?: number | undefined | null, cacheReadTokens?: number | undefined | null, sessionId?: string | undefined | null, route?: string | undefined | null): Event
+  /** All events emitted so far (in-memory). */
+  events(): Array<Event>
+  /**
+   * Fold the events recorded so far into `UsageAggregateV1` rows for one attribution
+   * `dimension`, serialized as a JSON array (TD-0009 P2). `dimension` is one of `subject`
+   * (`user`), `group`, `provider`, `model`, `key` (`virtual_key`), `session`, or `total`.
+   *
+   * The fold is `sandhi_core::UsageAggregator` — the same definition the proxy, the CLI, and
+   * the dashboard read, so the in-process path cannot disagree with them. `cap` bounds the
+   * number of distinct keys before the rest fold into `"(overflow)"` (default 1024): a
+   * long-lived process metering unbounded `sessionId`s loses per-key detail, never the sum —
+   * the rows always add up to the exact total. Throws on an unknown dimension.
+   */
+  usageSnapshotJson(dimension: string, cap?: number | undefined | null): string
+}

package/index.js

@@ -0,0 +1,326 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'sandhi.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sandhi.android-arm64.node')
+          } else {
+            nativeBinding = require('@anvailabs/sandhi-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'sandhi.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sandhi.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@anvailabs/sandhi-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'sandhi.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sandhi.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@anvailabs/sandhi-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'sandhi.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sandhi.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@anvailabs/sandhi-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'sandhi.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sandhi.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@anvailabs/sandhi-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'sandhi.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./sandhi.darwin-universal.node')
+      } else {
+        nativeBinding = require('@anvailabs/sandhi-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'sandhi.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sandhi.darwin-x64.node')
+          } else {
+            nativeBinding = require('@anvailabs/sandhi-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'sandhi.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sandhi.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@anvailabs/sandhi-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'sandhi.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./sandhi.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@anvailabs/sandhi-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'sandhi.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sandhi.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@anvailabs/sandhi-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'sandhi.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sandhi.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@anvailabs/sandhi-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'sandhi.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sandhi.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@anvailabs/sandhi-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'sandhi.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sandhi.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@anvailabs/sandhi-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'sandhi.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sandhi.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@anvailabs/sandhi-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'sandhi.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sandhi.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@anvailabs/sandhi-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'sandhi.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sandhi.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@anvailabs/sandhi-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'sandhi.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./sandhi.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@anvailabs/sandhi-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'sandhi.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./sandhi.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@anvailabs/sandhi-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { ProviderRuntime, TypedProvider, TypedEventStream, wireContractVersion, chatContractVersion, chatContractMinor, providerSpecJson, chatContractSchemaJson, providerDescriptorJson, providerModelsJson, parseUsage, Gateway } = nativeBinding
+
+module.exports.ProviderRuntime = ProviderRuntime
+module.exports.TypedProvider = TypedProvider
+module.exports.TypedEventStream = TypedEventStream
+module.exports.wireContractVersion = wireContractVersion
+module.exports.chatContractVersion = chatContractVersion
+module.exports.chatContractMinor = chatContractMinor
+module.exports.providerSpecJson = providerSpecJson
+module.exports.chatContractSchemaJson = chatContractSchemaJson
+module.exports.providerDescriptorJson = providerDescriptorJson
+module.exports.providerModelsJson = providerModelsJson
+module.exports.parseUsage = parseUsage
+module.exports.Gateway = Gateway

package/npm/darwin-arm64/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@anvailabs/sandhi-darwin-arm64",
+  "version": "0.5.0",
+  "main": "sandhi.darwin-arm64.node",
+  "files": [
+    "sandhi.darwin-arm64.node"
+  ],
+  "description": "Platform binary for @anvailabs/sandhi (darwin-arm64)",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">= 10"
+  },
+  "cpu": [
+    "arm64"
+  ],
+  "os": [
+    "darwin"
+  ]
+}

package/npm/linux-x64-gnu/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@anvailabs/sandhi-linux-x64-gnu",
+  "version": "0.5.0",
+  "main": "sandhi.linux-x64-gnu.node",
+  "files": [
+    "sandhi.linux-x64-gnu.node"
+  ],
+  "description": "Platform binary for @anvailabs/sandhi (linux-x64-gnu)",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">= 10"
+  },
+  "cpu": [
+    "x64"
+  ],
+  "os": [
+    "linux"
+  ],
+  "libc": [
+    "glibc"
+  ]
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@anvailabs/sandhi",
+  "version": "0.5.0",
+  "description": "Sandhi — the metering layer for AI agents (Node binding): in-process virtual keys, budgets, and neutral usage-event metering.",
+  "license": "Apache-2.0",
+  "repository": "https://github.com/anvai-labs/sandhi",
+  "keywords": [
+    "llm",
+    "gateway",
+    "usage",
+    "metering",
+    "attribution",
+    "ai"
+  ],
+  "main": "sandhi.js",
+  "types": "sandhi.d.ts",
+  "napi": {
+    "name": "sandhi",
+    "triples": {
+      "defaults": true,
+      "additional": [
+        "aarch64-apple-darwin",
+        "aarch64-unknown-linux-gnu"
+      ]
+    }
+  },
+  "engines": {
+    "node": ">= 16"
+  },
+  "scripts": {
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "test": "node --test __test__/gateway.test.mjs"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.4"
+  },
+  "optionalDependencies": {
+    "@anvailabs/sandhi-win32-x64-msvc": "0.5.0",
+    "@anvailabs/sandhi-darwin-x64": "0.5.0",
+    "@anvailabs/sandhi-linux-x64-gnu": "0.5.0",
+    "@anvailabs/sandhi-darwin-arm64": "0.5.0",
+    "@anvailabs/sandhi-linux-arm64-gnu": "0.5.0"
+  }
+}