@alienplatform/ai-gateway 3.3.0-dev.0d4f932037814a854d56a7e4e82a8a34cc2e35cb

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `@alienplatform/ai-gateway`: the thin TypeScript wrapper that starts the Alien
+ * AI gateway as a local subprocess.
+ *
+ * The gateway itself is a single Rust implementation (the `alien-ai-gateway`
+ * binary). This package spawns that binary once per process (or reuses the URL a
+ * container launcher already exported) and returns its loopback base URL. The app
+ * then points a plain OpenAI-compatible client at that URL, and every request and
+ * SSE stream flows over the loopback HTTP socket straight into the Rust gateway;
+ * no gateway logic is reimplemented here.
+ *
+ * @example
+ * ```typescript
+ * import { getAiConnection } from "@alienplatform/ai-gateway"
+ * import { createOpenAICompatible } from "@ai-sdk/openai-compatible"
+ * const provider = createOpenAICompatible({ name: "alien", ...(await getAiConnection("assistant")) })
+ * ```
+ */
+/** Start the AI gateway subprocess (idempotent) and return its running handle. */
+export declare const startAiGateway: () => Promise<import("./loader.js").RawAiGatewayHandle>;
+/** An OpenAI-compatible client for the named AI binding (External BYO-key or ambient). */
+export declare const ai: (name: string) => import("./client.js").Ai;
+/** Resolve an AI binding to `{ baseURL, apiKey? }`, starting the gateway for ambient bindings. */
+export declare const getAiConnection: (name: string) => Promise<import("./client.js").AiConnection>;
+export { Ai } from "./client.js";
+export type { AiConnection, AiModel, ChatCompletionCreateParams, ResponseCreateParams, } from "./client.js";
+export { aiBindingEnvVarName, isExternalAiBinding, parseAiBinding } from "./binding.js";
+export type { AiBinding, AmbientAiBinding, ExternalAiBinding } from "./binding.js";
+export { AiTransportError, AiUpstreamError, BindingNotFoundError, InvalidBindingConfigError, } from "./errors.js";
+//# 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;;;;;;;;;;;;;;;;;GAiBG;AASH,kFAAkF;AAClF,eAAO,MAAM,cAAc,yDAAyB,CAAA;AACpD,0FAA0F;AAC1F,eAAO,MAAM,EAAE,4CAAY,CAAA;AAC3B,kGAAkG;AAClG,eAAO,MAAM,eAAe,+DAAyB,CAAA;AAErD,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAChC,YAAY,EACV,YAAY,EACZ,OAAO,EACP,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AACvF,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAClF,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,30 @@
+import { a as createAiClient, c as BindingNotFoundError, d as isExternalAiBinding, f as parseAiBinding, i as Ai, l as InvalidBindingConfigError, o as AiTransportError, r as resolveGatewayBinary, s as AiUpstreamError, t as createGateway, u as aiBindingEnvVarName } from "./gateway.js";
+//#region src/index.ts
+/**
+* `@alienplatform/ai-gateway`: the thin TypeScript wrapper that starts the Alien
+* AI gateway as a local subprocess.
+*
+* The gateway itself is a single Rust implementation (the `alien-ai-gateway`
+* binary). This package spawns that binary once per process (or reuses the URL a
+* container launcher already exported) and returns its loopback base URL. The app
+* then points a plain OpenAI-compatible client at that URL, and every request and
+* SSE stream flows over the loopback HTTP socket straight into the Rust gateway;
+* no gateway logic is reimplemented here.
+*
+* @example
+* ```typescript
+* import { getAiConnection } from "@alienplatform/ai-gateway"
+* import { createOpenAICompatible } from "@ai-sdk/openai-compatible"
+* const provider = createOpenAICompatible({ name: "alien", ...(await getAiConnection("assistant")) })
+* ```
+*/
+const gateway = createGateway(resolveGatewayBinary);
+const client = createAiClient(gateway);
+/** Start the AI gateway subprocess (idempotent) and return its running handle. */
+const startAiGateway = gateway.startAiGateway;
+/** An OpenAI-compatible client for the named AI binding (External BYO-key or ambient). */
+const ai = client.ai;
+/** Resolve an AI binding to `{ baseURL, apiKey? }`, starting the gateway for ambient bindings. */
+const getAiConnection = client.getAiConnection;
+//#endregion
+export { Ai, AiTransportError, AiUpstreamError, BindingNotFoundError, InvalidBindingConfigError, ai, aiBindingEnvVarName, getAiConnection, isExternalAiBinding, parseAiBinding, startAiGateway };

package/dist/loader.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Locate (and, for a compiled Worker, extract) the `alien-ai-gateway` executable
+ * that the gateway wrapper spawns.
+ *
+ * Resolution order (deferred to first spawn, so importing the package does no I/O):
+ *
+ *   1. An embedded binary registered by the `./native` entry. A `bun build
+ *      --compile` Worker embeds the executable and hands us its (virtual) path;
+ *      we copy it to a real, executable temp file once.
+ *   2. `ALIEN_AI_GATEWAY_BINARY_PATH`: an explicit path (dev/test escape hatch;
+ *      never set in published installs).
+ *   3. `./alien-ai-gateway` in the working directory: the versioned Worker base
+ *      stages it there for bundled Workers, which have no node_modules.
+ *   4. The per-platform prebuild package `@alienplatform/ai-gateway-<triple>`,
+ *      which ships the executable (installed via `optionalDependencies`).
+ *   5. Dev fallback: the locally-built binary under `target/{release,debug}`,
+ *      found by walking up from this module.
+ */
+/** A running gateway handle: its loopback base URL. */
+export interface RawAiGatewayHandle {
+    readonly url: string;
+}
+export type LinuxLibc = "gnu" | "musl";
+/** Detect glibc vs musl, the same way napi-rs's generated loader does. */
+export declare function detectLinuxLibc(): LinuxLibc;
+/**
+ * Map `process.platform`/`arch` to the prebuild triple. The binary is built for
+ * musl as well as glibc, so Alpine/musl images resolve a prebuild rather than
+ * being rejected for their libc.
+ */
+export declare function platformTriple(platform?: NodeJS.Platform, arch?: NodeJS.Architecture, libc?: LinuxLibc): string;
+/** Walk up from `startDir` to find the locally-built binary, or `undefined`. */
+export declare function findLocalBinary(startDir?: string): string | undefined;
+/**
+ * Register the bun-embedded binary path, so plain `@alienplatform/ai-gateway`
+ * imports (which resolve through {@link resolveGatewayBinary}) find it inside a
+ * `bun build --compile` binary, where the filesystem/prebuild resolution below
+ * cannot. In a normal install this is never called. The `/native` entry calls it.
+ */
+export declare function registerEmbeddedBinary(path: string): void;
+/** Resolve (and memoize) a runnable path to the launcher binary, or throw. */
+export declare function resolveGatewayBinary(): Promise<string>;
+/** Test-only: reset the memoized resolution. */
+export declare function resetGatewayBinaryCacheForTests(): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAgBH,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAA;AAEtC,0EAA0E;AAC1E,wBAAgB,eAAe,IAAI,SAAS,CAS3C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,IAAI,GAAE,MAAM,CAAC,YAA2B,EACxC,IAAI,GAAE,SAA4D,GACjE,MAAM,CAQR;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,QAAQ,GAAE,MAAgD,GACzD,MAAM,GAAG,SAAS,CAWpB;AAKD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,8EAA8E;AAC9E,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CA8C5D;AAsED,gDAAgD;AAChD,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD"}

package/dist/native.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `@alienplatform/ai-gateway/native` — static-embed entry for `bun build --compile`.
+ *
+ * Imports the `alien-ai-gateway` executable through a literal `with { type: "file" }`
+ * specifier so bun embeds it into the single-file binary, and registers its path so
+ * the default loader extracts and spawns it. Unlike the default entry it does not
+ * probe the filesystem: the binary must already be staged next to the built
+ * `native.js` (the build owns that copy step). The specifier is kept external at
+ * build time (tsdown.config.ts) so the literal survives into `dist/native.js`.
+ * `bun build --compile` needs `--format=cjs`.
+ */
+/**
+ * Register the bun-embedded gateway binary with the default loader, so plain
+ * `@alienplatform/ai-gateway` imports — including the SDK's re-exported `ai()`,
+ * which resolves through {@link resolveGatewayBinary}, to spawn it inside a compiled
+ * binary. `alien build` emits an explicit call to this from the compiled entry
+ * (via `@alienplatform/sdk/native`); it's an explicit exported call, not a bare
+ * side-effect import, so it survives this package's `sideEffects: false`
+ * tree-shaking.
+ */
+export declare function installEmbeddedGateway(): void;
+export declare const startAiGateway: () => Promise<import("./loader.js").RawAiGatewayHandle>;
+export declare const ai: (name: string) => import("./client.js").Ai;
+export declare const getAiConnection: (name: string) => Promise<import("./client.js").AiConnection>;
+export { Ai } from "./client.js";
+export type { AiConnection, AiModel, ChatCompletionCreateParams, ResponseCreateParams, } from "./client.js";
+export { aiBindingEnvVarName, isExternalAiBinding, parseAiBinding } from "./binding.js";
+export type { AiBinding, AmbientAiBinding, ExternalAiBinding } from "./binding.js";
+export { AiTransportError, AiUpstreamError, BindingNotFoundError, InvalidBindingConfigError, } from "./errors.js";
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAKD,eAAO,MAAM,cAAc,yDAAyB,CAAA;AACpD,eAAO,MAAM,EAAE,4CAAY,CAAA;AAC3B,eAAO,MAAM,eAAe,+DAAyB,CAAA;AAErD,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAChC,YAAY,EACV,YAAY,EACZ,OAAO,EACP,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AACvF,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAClF,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,aAAa,CAAA"}

package/dist/native.js

@@ -0,0 +1,33 @@
+import { a as createAiClient, c as BindingNotFoundError, d as isExternalAiBinding, f as parseAiBinding, i as Ai, l as InvalidBindingConfigError, n as registerEmbeddedBinary, o as AiTransportError, r as resolveGatewayBinary, s as AiUpstreamError, t as createGateway, u as aiBindingEnvVarName } from "./gateway.js";
+import embeddedBinaryPath from "./alien-ai-gateway.bin" with { type: "file" };
+//#region src/native.ts
+/**
+* `@alienplatform/ai-gateway/native` — static-embed entry for `bun build --compile`.
+*
+* Imports the `alien-ai-gateway` executable through a literal `with { type: "file" }`
+* specifier so bun embeds it into the single-file binary, and registers its path so
+* the default loader extracts and spawns it. Unlike the default entry it does not
+* probe the filesystem: the binary must already be staged next to the built
+* `native.js` (the build owns that copy step). The specifier is kept external at
+* build time (tsdown.config.ts) so the literal survives into `dist/native.js`.
+* `bun build --compile` needs `--format=cjs`.
+*/
+/**
+* Register the bun-embedded gateway binary with the default loader, so plain
+* `@alienplatform/ai-gateway` imports — including the SDK's re-exported `ai()`,
+* which resolves through {@link resolveGatewayBinary}, to spawn it inside a compiled
+* binary. `alien build` emits an explicit call to this from the compiled entry
+* (via `@alienplatform/sdk/native`); it's an explicit exported call, not a bare
+* side-effect import, so it survives this package's `sideEffects: false`
+* tree-shaking.
+*/
+function installEmbeddedGateway() {
+	registerEmbeddedBinary(embeddedBinaryPath);
+}
+const gateway = createGateway(resolveGatewayBinary);
+const client = createAiClient(gateway);
+const startAiGateway = gateway.startAiGateway;
+const ai = client.ai;
+const getAiConnection = client.getAiConnection;
+//#endregion
+export { Ai, AiTransportError, AiUpstreamError, BindingNotFoundError, InvalidBindingConfigError, ai, aiBindingEnvVarName, getAiConnection, installEmbeddedGateway, isExternalAiBinding, parseAiBinding, startAiGateway };

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@alienplatform/ai-gateway",
+  "version": "3.3.0-dev.0d4f932037814a854d56a7e4e82a8a34cc2e35cb",
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./native": {
+      "types": "./dist/native.d.ts",
+      "import": "./dist/native.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18",
+    "bun": ">=1.0.23"
+  },
+  "scripts": {
+    "build": "tsdown && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "test": "vitest run",
+    "test:ts": "tsc --noEmit",
+    "format-and-lint": "biome check .",
+    "format-and-lint:fix": "biome check . --write"
+  },
+  "keywords": [
+    "alien",
+    "ai",
+    "gateway"
+  ],
+  "author": "Alien Software, Inc. <hi@alien.dev>",
+  "license": "FSL-1.1-Apache-2.0",
+  "description": "Thin TypeScript wrapper that spawns the Alien AI gateway (a Rust binary) and points an OpenAI-compatible client at it",
+  "homepage": "https://alien.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alienplatform/alien.git",
+    "directory": "packages/ai-gateway"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@alienplatform/typescript-config": "workspace:^",
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^24.0.15",
+    "openai": "^4",
+    "tsdown": "^0.13.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  },
+  "dependencies": {
+    "@alienplatform/core": "3.3.0-dev.0d4f932037814a854d56a7e4e82a8a34cc2e35cb",
+    "zod": "4.3.2"
+  },
+  "peerDependencies": {
+    "openai": "^4"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "@alienplatform/ai-gateway-darwin-arm64": "3.3.0-dev.0d4f932037814a854d56a7e4e82a8a34cc2e35cb",
+    "@alienplatform/ai-gateway-darwin-x64": "3.3.0-dev.0d4f932037814a854d56a7e4e82a8a34cc2e35cb",
+    "@alienplatform/ai-gateway-linux-x64-gnu": "3.3.0-dev.0d4f932037814a854d56a7e4e82a8a34cc2e35cb",
+    "@alienplatform/ai-gateway-linux-x64-musl": "3.3.0-dev.0d4f932037814a854d56a7e4e82a8a34cc2e35cb",
+    "@alienplatform/ai-gateway-linux-arm64-gnu": "3.3.0-dev.0d4f932037814a854d56a7e4e82a8a34cc2e35cb",
+    "@alienplatform/ai-gateway-linux-arm64-musl": "3.3.0-dev.0d4f932037814a854d56a7e4e82a8a34cc2e35cb"
+  }
+}