llmshim 0.1.23 → 0.1.24

package/README.md

@@ -1,14 +1,11 @@
 # llmshim
 
-Thin, **dependency-free** TypeScript/JavaScript client for the [llmshim](https://crates.io/crates/llmshim) proxy.
+**Zero-runtime-dependency** TypeScript/JavaScript client for the [llmshim](https://crates.io/crates/llmshim) proxy.
 
-It is pure HTTP: it talks to a **running** llmshim proxy over the network (default `http://localhost:3000`). Unlike the Python package, it does not bundle or spawn the Rust binary — start the proxy yourself:
+Like the Python package, it bundles a prebuilt proxy binary for your platform and auto-starts it on the first request — nothing to run yourself. Pass an explicit `baseUrl` instead if you'd rather point it at a proxy you're already running (Docker, a shared server, `llmshim proxy` in another terminal).
 
-```bash
-llmshim proxy            # requires a build with --features proxy
-```
-
-- Zero runtime dependencies (built-in `fetch` + `ReadableStream`, Node 18+).
+- Bundles a prebuilt binary per platform (macOS/Linux/Windows, x64/arm64) via `optionalDependencies` — the same pattern esbuild/swc/Turborepo use. No native dependency, no postinstall scripts.
+- Zero runtime dependencies otherwise (built-in `fetch` + `ReadableStream` + Node builtins for the auto-spawn, Node 18+).
 - Faithful to the proxy's OpenAPI contract (`api/openapi.yaml`).
 - Typed responses and a typed `StreamEvent` union.
 
@@ -23,7 +20,7 @@ npm install llmshim
 ```ts
 import { Client } from "llmshim";
 
-const client = new Client(); // defaults to http://localhost:3000
+const client = new Client(); // no baseUrl -> auto-starts the bundled proxy on first request
 
 // Non-streaming
 const res = await client.chat({
@@ -51,13 +48,21 @@ console.log(await client.health());
 
 ```ts
 new Client({
-  baseUrl: "http://localhost:3000", // proxy URL
+  baseUrl: "http://localhost:3000", // connect to a proxy you're already running — disables auto-spawn
   headers: { authorization: "Bearer …" }, // sent on every request
   fetch: myFetch, // custom fetch (optional; defaults to global fetch)
 });
 ```
 
-`createClient(options)` is also exported as an equivalent factory.
+Omit `baseUrl` to auto-spawn the bundled binary instead (see below). `createClient(options)` is also exported as an equivalent factory — both are fully synchronous; the auto-spawn happens lazily inside the first `chat`/`stream`/`models`/`health` call, not at construction time.
+
+## How the bundled binary works
+
+`npm install llmshim` also installs one of five tiny `optionalDependencies` — `llmshim-darwin-arm64`, `llmshim-darwin-x64`, `llmshim-linux-x64`, `llmshim-linux-arm64`, or `@sanjay920/llmshim-win32-x64` (the Windows one is scoped to sidestep npm's spam filter on unscoped `*-win32-*` names) — npm resolves the one matching your platform automatically via each package's `os`/`cpu` fields, so only ~8MB for your actual platform ever downloads. Each contains nothing but the prebuilt `llmshim` binary.
+
+On the first `chat`/`stream`/`models`/`health` call on a `Client` constructed without `baseUrl`, the client finds that bundled binary (falling back to `PATH`, e.g. a `cargo install llmshim`), starts `llmshim proxy` on a free local port, waits for it to accept connections, and reuses that same process for every subsequent call in the same Node process — mirroring the Python client's `_server.py`. It's stopped automatically on process exit.
+
+If no bundled binary is found and nothing is on `PATH`, the first request throws a clear error explaining how to install one or pass an explicit `baseUrl`.
 
 ## Errors
 
@@ -96,3 +101,13 @@ npm install
 npm run build   # tsc → dist/
 npm test        # node --test, fully mocked (no network, no API cost)
 ```
+
+`scripts/manual-smoke-check.mjs` is a manual (not automated) end-to-end check of the auto-spawn path against a real binary — see the comment at the top of that file for how to run it. It's excluded from `npm test`'s auto-discovery and from the published package.
+
+## Publishing (maintainers)
+
+Six packages publish together on every release, all via npm's OIDC trusted publishing (no tokens stored): the five platform binary packages (`clients/typescript/packages/*`) and this root package. Each needs a one-time Trusted Publisher configured at `npmjs.com/package/<name>/access` with:
+
+- Repository owner: `sanjay920`, repository: `llmshim`, workflow filename: `release.yml`, environment: `release`.
+
+See `.github/workflows/release.yml` (`npm-macos-binaries`, `npm-linux-x64-binary`, `npm-linux-arm64-binary`, `npm-windows-binary`, `npm` jobs) and `.claude/skills/release/SKILL.md`.

package/dist/index.d.ts

@@ -1,13 +1,14 @@
 /**
  * llmshim TypeScript client.
  *
- * A thin, dependency-free HTTP client for the llmshim proxy. Talks to a running
- * proxy over HTTP (default http://localhost:3000). It does NOT spawn or bundle
- * the Rust binary — start the proxy separately with `llmshim proxy`.
+ * A dependency-free HTTP client for the llmshim proxy. If you don't pass a
+ * `baseUrl`, it bundles and auto-starts a prebuilt proxy binary for your
+ * platform (like the Python client) — nothing to run yourself. Pass an
+ * explicit `baseUrl` to talk to a proxy you're already running instead.
  *
  * @example
  * import { Client } from "llmshim";
- * const client = new Client();
+ * const client = new Client(); // auto-starts the bundled proxy on first request
  * const res = await client.chat({
  *   model: "anthropic/claude-sonnet-4-6",
  *   messages: [{ role: "user", content: "Hello!" }],
@@ -15,12 +16,17 @@
  * console.log(res.message.content);
  */
 export * from "./types.js";
+export { ensureServer, platformPackageName } from "./server.js";
 import type { ChatRequest, ChatResponse, HealthResponse, ModelsResponse, StreamEvent } from "./types.js";
 /** A `fetch` implementation. Defaults to the global `fetch` (Node 18+). */
 export type FetchLike = typeof fetch;
 /** Options for constructing a {@link Client}. */
 export interface ClientOptions {
-    /** Base URL of the running proxy. Defaults to `http://localhost:3000`. */
+    /**
+     * Base URL of a proxy you're already running. If omitted, the client
+     * bundles and auto-starts a prebuilt proxy binary on the first request
+     * (see {@link ensureServer}) instead of assuming a fixed default.
+     */
     baseUrl?: string;
     /** Custom fetch implementation. Defaults to the global `fetch`. */
     fetch?: FetchLike;
@@ -40,10 +46,20 @@ export declare class LlmshimError extends Error {
 }
 /** HTTP client for the llmshim proxy. */
 export declare class Client {
-    private readonly baseUrl;
+    /** Set only when an explicit `baseUrl` was passed at construction. */
+    private readonly explicitBaseUrl;
+    /** Memoized auto-start resolution, shared across calls on this instance. */
+    private autoBaseUrl;
     private readonly fetchImpl;
     private readonly headers;
     constructor(options?: ClientOptions);
+    /**
+     * Resolve the base URL to use for the next request: the explicit `baseUrl`
+     * if one was given at construction, otherwise the bundled proxy's URL
+     * (starting it on first call). Memoized so the bundled proxy is only
+     * started once per `Client` instance.
+     */
+    private resolveBaseUrl;
     /**
      * Send a chat completion request to POST /v1/chat.
      * Non-streaming by default; if `req.stream` is true the proxy streams instead,

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,YAAY,CAAC;AAE3B,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,cAAc,EACd,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM1D;AAED,yCAAyC;AACzC,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,OAAO,GAAE,aAAkB;IAavC;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAMnD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC;IAS3E,gDAAgD;IAC1C,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAMvC,oCAAoC;IAC9B,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAMvC,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,GAAG;CAMZ;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAE5D;AAwBD;;;;;;GAMG;AACH,wBAAuB,QAAQ,CAC7B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAC/B,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CA+B5C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,cAAc,EACd,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAGpB,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM1D;AAED,yCAAyC;AACzC,qBAAa,MAAM;IACjB,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,4EAA4E;IAC5E,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,OAAO,GAAE,aAAkB;IAavC;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAMtB;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAMnD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC;IAS3E,gDAAgD;IAC1C,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAMvC,oCAAoC;IAC9B,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;YAMzB,IAAI;YAaJ,GAAG;CAOlB;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAE5D;AAwBD;;;;;;GAMG;AACH,wBAAuB,QAAQ,CAC7B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAC/B,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CA+B5C"}

package/dist/index.js

@@ -1,13 +1,14 @@
 /**
  * llmshim TypeScript client.
  *
- * A thin, dependency-free HTTP client for the llmshim proxy. Talks to a running
- * proxy over HTTP (default http://localhost:3000). It does NOT spawn or bundle
- * the Rust binary — start the proxy separately with `llmshim proxy`.
+ * A dependency-free HTTP client for the llmshim proxy. If you don't pass a
+ * `baseUrl`, it bundles and auto-starts a prebuilt proxy binary for your
+ * platform (like the Python client) — nothing to run yourself. Pass an
+ * explicit `baseUrl` to talk to a proxy you're already running instead.
  *
  * @example
  * import { Client } from "llmshim";
- * const client = new Client();
+ * const client = new Client(); // auto-starts the bundled proxy on first request
  * const res = await client.chat({
  *   model: "anthropic/claude-sonnet-4-6",
  *   messages: [{ role: "user", content: "Hello!" }],
@@ -15,6 +16,8 @@
  * console.log(res.message.content);
  */
 export * from "./types.js";
+export { ensureServer, platformPackageName } from "./server.js";
+import { ensureServer } from "./server.js";
 /**
  * Error thrown when the proxy returns a non-2xx response.
  * Carries the HTTP status plus the `code`/`message` from the ErrorResponse body.
@@ -33,11 +36,14 @@ export class LlmshimError extends Error {
 }
 /** HTTP client for the llmshim proxy. */
 export class Client {
-    baseUrl;
+    /** Set only when an explicit `baseUrl` was passed at construction. */
+    explicitBaseUrl;
+    /** Memoized auto-start resolution, shared across calls on this instance. */
+    autoBaseUrl;
     fetchImpl;
     headers;
     constructor(options = {}) {
-        this.baseUrl = (options.baseUrl ?? "http://localhost:3000").replace(/\/+$/, "");
+        this.explicitBaseUrl = options.baseUrl?.replace(/\/+$/, "");
         const f = options.fetch ?? globalThis.fetch;
         if (typeof f !== "function") {
             throw new Error("No fetch implementation available. Use Node 18+ or pass `fetch` in ClientOptions.");
@@ -46,6 +52,19 @@ export class Client {
         this.fetchImpl = f === globalThis.fetch ? f.bind(globalThis) : f;
         this.headers = { ...options.headers };
     }
+    /**
+     * Resolve the base URL to use for the next request: the explicit `baseUrl`
+     * if one was given at construction, otherwise the bundled proxy's URL
+     * (starting it on first call). Memoized so the bundled proxy is only
+     * started once per `Client` instance.
+     */
+    resolveBaseUrl() {
+        if (this.explicitBaseUrl)
+            return Promise.resolve(this.explicitBaseUrl);
+        if (!this.autoBaseUrl)
+            this.autoBaseUrl = ensureServer();
+        return this.autoBaseUrl;
+    }
     /**
      * Send a chat completion request to POST /v1/chat.
      * Non-streaming by default; if `req.stream` is true the proxy streams instead,
@@ -85,8 +104,9 @@ export class Client {
         await throwIfError(res);
         return (await res.json());
     }
-    post(path, body) {
-        return this.fetchImpl(this.baseUrl + path, {
+    async post(path, body) {
+        const baseUrl = await this.resolveBaseUrl();
+        return this.fetchImpl(baseUrl + path, {
             method: "POST",
             headers: {
                 "content-type": "application/json",
@@ -96,8 +116,9 @@ export class Client {
             body: JSON.stringify(body),
         });
     }
-    get(path) {
-        return this.fetchImpl(this.baseUrl + path, {
+    async get(path) {
+        const baseUrl = await this.resolveBaseUrl();
+        return this.fetchImpl(baseUrl + path, {
             method: "GET",
             headers: { accept: "application/json", ...this.headers },
         });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAUhE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmB3C;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,wBAAwB;IACf,MAAM,CAAS;IACxB,yEAAyE;IAChE,IAAI,CAAS;IAEtB,YAAY,MAAc,EAAE,IAAY,EAAE,OAAe;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,yCAAyC;AACzC,MAAM,OAAO,MAAM;IACjB,sEAAsE;IACrD,eAAe,CAAqB;IACrD,4EAA4E;IACpE,WAAW,CAA8B;IAChC,SAAS,CAAY;IACrB,OAAO,CAAyB;IAEjD,YAAY,UAAyB,EAAE;QACrC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;QAC5C,IAAI,OAAO,CAAC,KAAK,UAAU,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;QACJ,CAAC;QACD,gDAAgD;QAChD,IAAI,CAAC,SAAS,GAAG,CAAC,KAAK,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACK,cAAc;QACpB,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,WAAW,GAAG,YAAY,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,GAAgB;QACzB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC7C,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACxB,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAiB,CAAC;IAC5C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,MAAM,CAAC,GAAgB;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,gCAAgC,CAAC,CAAC;QAClF,CAAC;QACD,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACzC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACxB,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;IAC9C,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;QACxB,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;IAC9C,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAAa;QAC5C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,qCAAqC;gBAC7C,GAAG,IAAI,CAAC,OAAO;aAChB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,IAAY;QAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE;SACzD,CAAC,CAAC;IACL,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,OAAuB;IAClD,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,8FAA8F;AAC9F,KAAK,UAAU,YAAY,CAAC,GAAa;IACvC,IAAI,GAAG,CAAC,EAAE;QAAE,OAAO;IACnB,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,OAAO,GAAG,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA2B,CAAC;YAC1D,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC/B,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAC7B,IAAgC;IAEhC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,KAAK;gBAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC7B,CAAC;YAED,4EAA4E;YAC5E,IAAI,GAAW,CAAC;YAChB,OAAO,CAAC,GAAG,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBACtC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;gBACzD,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;gBACzC,IAAI,MAAM;oBAAE,MAAM,MAAM,CAAC;YAC3B,CAAC;YAED,IAAI,IAAI;gBAAE,MAAM;QAClB,CAAC;QAED,mEAAmE;QACnE,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,MAAM;YAAE,MAAM,MAAM,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,SAAS,oBAAoB,CAAC,GAAW;IACvC,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,IAAI,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,yDAAyD;AACzD,SAAS,cAAc,CAAC,GAAW,EAAE,GAAW;IAC9C,OAAO,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,wFAAwF;AACxF,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC;QACrB,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,mBAAmB;QACtE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzD,oEAAoE;QACpE,IAAI,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACpD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE5C,IAAI,KAAK,KAAK,OAAO;YAAE,SAAS,GAAG,GAAG,CAAC;aAClC,IAAI,KAAK,KAAK,MAAM;YAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAE/C,IAAI,OAAgC,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,IAAI,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjF,OAAO,EAAE,GAAG,OAAO,EAAE,IAAI,EAAiB,CAAC;AAC7C,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Auto-managed llmshim proxy server.
+ *
+ * Mirrors the Python client's `_server.py`: finds the platform-specific binary
+ * bundled via an `optionalDependencies` package (e.g. `llmshim-darwin-arm64`),
+ * starts it on a free port, waits for it to be ready, and stops it on process
+ * exit. The server is a singleton shared by every {@link Client} in the same
+ * process that didn't specify an explicit `baseUrl`.
+ */
+/** Maps Node's `process.platform`/`process.arch` to the optional-dependency package name. */
+export declare function platformPackageName(): string;
+/**
+ * Ensure the bundled proxy is running, starting it if necessary. Returns its
+ * base URL. Safe to call repeatedly and concurrently — the server is started
+ * at most once per process.
+ */
+export declare function ensureServer(): Promise<string>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,6FAA6F;AAC7F,wBAAgB,mBAAmB,IAAI,MAAM,CAkB5C;AA+GD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAyC9C"}

package/dist/server.js

@@ -0,0 +1,188 @@
+/**
+ * Auto-managed llmshim proxy server.
+ *
+ * Mirrors the Python client's `_server.py`: finds the platform-specific binary
+ * bundled via an `optionalDependencies` package (e.g. `llmshim-darwin-arm64`),
+ * starts it on a free port, waits for it to be ready, and stops it on process
+ * exit. The server is a singleton shared by every {@link Client} in the same
+ * process that didn't specify an explicit `baseUrl`.
+ */
+import { spawn } from "node:child_process";
+import { accessSync, constants as fsConstants } from "node:fs";
+import { createRequire } from "node:module";
+import { createServer, createConnection } from "node:net";
+import { delimiter, join } from "node:path";
+const require = createRequire(import.meta.url);
+let serverProcess = null;
+let serverPort = null;
+let starting = null;
+/** Maps Node's `process.platform`/`process.arch` to the optional-dependency package name. */
+export function platformPackageName() {
+    const plat = process.platform;
+    const arch = process.arch;
+    const key = `${plat}-${arch}`;
+    const known = {
+        "darwin-arm64": "llmshim-darwin-arm64",
+        "darwin-x64": "llmshim-darwin-x64",
+        "linux-x64": "llmshim-linux-x64",
+        "linux-arm64": "llmshim-linux-arm64",
+        // Scoped to dodge npm's spam filter, which flags unscoped `*-win32-*`
+        // names (the darwin/linux siblings publish unscoped fine).
+        "win32-x64": "@sanjay920/llmshim-win32-x64",
+    };
+    const pkg = known[key];
+    if (!pkg) {
+        throw new Error(`No prebuilt llmshim binary is published for ${key}.`);
+    }
+    return pkg;
+}
+/** Locate the binary bundled via the platform-specific optional dependency, if installed. */
+function findBundledBinary() {
+    let pkgName;
+    try {
+        pkgName = platformPackageName();
+    }
+    catch {
+        return null;
+    }
+    try {
+        // Resolves to the platform package's package.json; its directory contains bin/.
+        const pkgJsonPath = require.resolve(`${pkgName}/package.json`);
+        const binName = process.platform === "win32" ? "llmshim.exe" : "llmshim";
+        const binPath = join(pkgJsonPath, "..", "bin", binName);
+        accessSync(binPath, fsConstants.X_OK);
+        return binPath;
+    }
+    catch {
+        return null;
+    }
+}
+/** Locate an `llmshim` executable on PATH (e.g. `cargo install llmshim`). */
+function findOnPath() {
+    const pathEnv = process.env.PATH ?? process.env.Path ?? "";
+    const binNames = process.platform === "win32" ? ["llmshim.exe", "llmshim.cmd"] : ["llmshim"];
+    for (const dir of pathEnv.split(delimiter)) {
+        if (!dir)
+            continue;
+        for (const bin of binNames) {
+            const candidate = join(dir, bin);
+            try {
+                accessSync(candidate, fsConstants.X_OK);
+                return candidate;
+            }
+            catch {
+                // not here, keep looking
+            }
+        }
+    }
+    return null;
+}
+/** Find the llmshim binary: bundled platform package first, then PATH. */
+function findBinary() {
+    const bundled = findBundledBinary();
+    if (bundled)
+        return bundled;
+    const onPath = findOnPath();
+    if (onPath)
+        return onPath;
+    throw new Error("llmshim binary not found. Install one of:\n" +
+        "  npm install llmshim                     (includes a prebuilt binary for your platform)\n" +
+        "  cargo install llmshim                   (from crates.io, puts it on PATH)\n" +
+        "  cargo build --release --features proxy  (from source)\n" +
+        "Or pass an explicit `baseUrl` to connect to a proxy you're already running.");
+}
+/** Find a free TCP port on localhost. */
+function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const srv = createServer();
+        srv.unref();
+        srv.on("error", reject);
+        srv.listen(0, "127.0.0.1", () => {
+            const address = srv.address();
+            if (address && typeof address === "object") {
+                const port = address.port;
+                srv.close(() => resolve(port));
+            }
+            else {
+                srv.close();
+                reject(new Error("Could not determine a free port"));
+            }
+        });
+    });
+}
+/** Poll until something is accepting TCP connections on `port`, or time out. */
+function waitForServer(port, timeoutMs = 10_000) {
+    const deadline = Date.now() + timeoutMs;
+    return new Promise((resolve) => {
+        const attempt = () => {
+            const socket = createConnection({ port, host: "127.0.0.1" });
+            socket.once("connect", () => {
+                socket.end();
+                resolve(true);
+            });
+            socket.once("error", () => {
+                socket.destroy();
+                if (Date.now() >= deadline) {
+                    resolve(false);
+                }
+                else {
+                    setTimeout(attempt, 100);
+                }
+            });
+        };
+        attempt();
+    });
+}
+function stopServer() {
+    if (serverProcess) {
+        try {
+            serverProcess.kill();
+        }
+        catch {
+            // already gone
+        }
+    }
+    serverProcess = null;
+    serverPort = null;
+    starting = null;
+}
+/**
+ * Ensure the bundled proxy is running, starting it if necessary. Returns its
+ * base URL. Safe to call repeatedly and concurrently — the server is started
+ * at most once per process.
+ */
+export function ensureServer() {
+    if (serverProcess && serverPort !== null) {
+        return Promise.resolve(`http://127.0.0.1:${serverPort}`);
+    }
+    if (starting)
+        return starting;
+    starting = (async () => {
+        const binary = findBinary();
+        const port = await findFreePort();
+        const child = spawn(binary, ["proxy"], {
+            env: { ...process.env, LLMSHIM_HOST: "127.0.0.1", LLMSHIM_PORT: String(port) },
+            stdio: ["ignore", "ignore", "pipe"],
+        });
+        let stderr = "";
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        process.once("exit", stopServer);
+        const ready = await waitForServer(port);
+        if (!ready) {
+            stopServer();
+            if (stderr.includes("No API keys found")) {
+                throw new Error("No API keys configured. Set them via environment variables " +
+                    "(OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, XAI_API_KEY) " +
+                    "or `llmshim configure`.");
+            }
+            throw new Error(`llmshim proxy failed to start on port ${port}.\nBinary: ${binary}\nstderr: ${stderr}`);
+        }
+        serverProcess = child;
+        serverPort = port;
+        return `http://127.0.0.1:${port}`;
+    })();
+    return starting;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "llmshim",
-  "version": "0.1.23",
-  "description": "Thin, dependency-free TypeScript client for the llmshim proxy (multi-provider LLM API).",
+  "version": "0.1.24",
+  "description": "TypeScript client for the llmshim proxy (multi-provider LLM API) — bundles a prebuilt binary and auto-starts it, or connects to a proxy you run yourself.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -19,6 +19,13 @@
   "engines": {
     "node": ">=18"
   },
+  "optionalDependencies": {
+    "llmshim-darwin-arm64": "0.1.24",
+    "llmshim-darwin-x64": "0.1.24",
+    "llmshim-linux-x64": "0.1.24",
+    "llmshim-linux-arm64": "0.1.24",
+    "@sanjay920/llmshim-win32-x64": "0.1.24"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "test": "node --test",
@@ -41,6 +48,7 @@
     "directory": "clients/typescript"
   },
   "devDependencies": {
-    "typescript": "^5.4.0"
+    "typescript": "^5.4.0",
+    "@types/node": "^22.0.0"
   }
 }