@tanstack/ai-reactor 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tanner Linsley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+<div align="center">
+  <picture>
+    <source
+      media="(prefers-color-scheme: dark)"
+      srcset="https://tanstack.com/api/readme/ai.png?theme=dark"
+    />
+    <source
+      media="(prefers-color-scheme: light)"
+      srcset="https://tanstack.com/api/readme/ai.png"
+    />
+    <img
+      src="https://tanstack.com/api/readme/ai.png"
+      alt="TanStack AI"
+      width="900"
+    />
+  </picture>
+</div>
+
+<br />
+
+# @tanstack/ai-reactor
+
+Reactor adapter for TanStack AI live world and video generation (Orbis, Happy Oyster, LingBot, Helios, FastH3).
+
+## Installation
+
+```bash
+npm install @tanstack/ai-reactor @tanstack/ai
+```
+
+## Usage
+
+### Server: mint a session token
+
+```typescript
+import { generateWorld } from '@tanstack/ai'
+import { reactorWorld } from '@tanstack/ai-reactor'
+
+const world = await generateWorld({
+  adapter: reactorWorld('visko-orbis-stable'),
+  prompt: 'A neon cyberpunk city at night',
+})
+
+// Hand world.token, world.model, and world.prompt to the browser.
+```
+
+### Server: mint a live video session token
+
+```typescript
+import { generateLiveVideo } from '@tanstack/ai'
+import { reactorVideo } from '@tanstack/ai-reactor'
+
+const live = await generateLiveVideo({
+  adapter: reactorVideo('helios'),
+  prompt: 'A neon cyberpunk city at night',
+})
+
+// Hand live.token, live.model, and live.prompt to the browser.
+```
+
+Set `REACTOR_API_KEY`, or pass `apiKey` in the adapter config. The browser connects with `@reactor-team/js-sdk`. See the [Reactor adapter docs](https://tanstack.com/ai/latest/docs/adapters/reactor).

package/dist/esm/adapters/video.d.ts

@@ -0,0 +1,35 @@
+import { BaseLiveVideoAdapter } from '@tanstack/ai/adapters';
+import { ReactorClientConfig } from '../utils/client.js';
+import { LiveVideoGenerationOptions, LiveVideoGenerationResult } from '@tanstack/ai';
+import { ReactorVideoModel, ReactorVideoProviderOptions } from '../model-meta.js';
+/**
+ * Reactor live-video adapter. Mints a session-scoped JWT so a browser can
+ * connect with `@reactor-team/js-sdk`, set the prompt, and start the stream.
+ *
+ * @example
+ * ```ts
+ * import { generateLiveVideo } from '@tanstack/ai'
+ * import { reactorVideo } from '@tanstack/ai-reactor'
+ *
+ * const live = await generateLiveVideo({
+ *   adapter: reactorVideo('helios'),
+ *   prompt: 'A neon cyberpunk city at night',
+ * })
+ * ```
+ */
+export declare class ReactorVideoAdapter<TModel extends ReactorVideoModel> extends BaseLiveVideoAdapter<TModel, ReactorVideoProviderOptions> {
+    readonly name: "reactor";
+    private readonly clientConfig;
+    private readonly apiKey;
+    constructor(model: TModel, config?: ReactorClientConfig);
+    createLiveVideo(options: LiveVideoGenerationOptions<ReactorVideoProviderOptions>): Promise<LiveVideoGenerationResult>;
+}
+/**
+ * Create a Reactor live-video adapter. Reads `REACTOR_API_KEY` when `apiKey` is
+ * omitted.
+ */
+export declare function reactorVideo<TModel extends ReactorVideoModel>(model: TModel, config?: ReactorClientConfig): ReactorVideoAdapter<TModel>;
+/**
+ * Create a Reactor live-video adapter with an explicit API key.
+ */
+export declare function createReactorVideo<TModel extends ReactorVideoModel>(model: TModel, apiKey: string, config?: Omit<ReactorClientConfig, 'apiKey'>): ReactorVideoAdapter<TModel>;

package/dist/esm/adapters/video.js

@@ -0,0 +1,87 @@
+import { mintReactorSessionToken, resolveReactorApiKey, resolveReactorApiUrl } from "../utils/client.js";
+import { REACTOR_VIDEO_SLUGS } from "../model-meta.js";
+import { BaseLiveVideoAdapter } from "@tanstack/ai/adapters";
+import { generateId } from "@tanstack/ai-utils";
+//#region src/adapters/video.ts
+/**
+* Reactor live-video adapter. Mints a session-scoped JWT so a browser can
+* connect with `@reactor-team/js-sdk`, set the prompt, and start the stream.
+*
+* @example
+* ```ts
+* import { generateLiveVideo } from '@tanstack/ai'
+* import { reactorVideo } from '@tanstack/ai-reactor'
+*
+* const live = await generateLiveVideo({
+*   adapter: reactorVideo('helios'),
+*   prompt: 'A neon cyberpunk city at night',
+* })
+* ```
+*/
+var ReactorVideoAdapter = class extends BaseLiveVideoAdapter {
+	name = "reactor";
+	clientConfig;
+	apiKey;
+	constructor(model, config = {}) {
+		super(model, {});
+		this.apiKey = resolveReactorApiKey(config);
+		this.clientConfig = config;
+	}
+	async createLiveVideo(options) {
+		const { logger, prompt, abortSignal } = options;
+		const modelSlug = REACTOR_VIDEO_SLUGS[this.model];
+		const apiUrl = resolveReactorApiUrl(this.clientConfig);
+		logger.request(`activity=generateLiveVideo provider=reactor model=${modelSlug}`, {
+			provider: "reactor",
+			model: modelSlug
+		});
+		try {
+			const token = await mintReactorSessionToken({
+				apiKey: this.apiKey,
+				apiUrl,
+				modelSlug,
+				fetchImpl: this.clientConfig.fetch,
+				abortSignal
+			});
+			const result = {
+				id: generateId("liveVideo"),
+				model: modelSlug,
+				token: token.jwt,
+				expiresAt: token.expires_at * 1e3,
+				prompt,
+				status: "ready"
+			};
+			logger.output(`activity=generateLiveVideo provider=reactor model=${modelSlug}`, {
+				model: modelSlug,
+				status: result.status
+			});
+			return result;
+		} catch (error) {
+			logger.errors("reactor.createLiveVideo failed", {
+				error,
+				source: "reactor.createLiveVideo"
+			});
+			throw error;
+		}
+	}
+};
+/**
+* Create a Reactor live-video adapter. Reads `REACTOR_API_KEY` when `apiKey` is
+* omitted.
+*/
+function reactorVideo(model, config) {
+	return new ReactorVideoAdapter(model, config ?? {});
+}
+/**
+* Create a Reactor live-video adapter with an explicit API key.
+*/
+function createReactorVideo(model, apiKey, config) {
+	return new ReactorVideoAdapter(model, {
+		...config,
+		apiKey
+	});
+}
+//#endregion
+export { ReactorVideoAdapter, createReactorVideo, reactorVideo };
+
+//# sourceMappingURL=video.js.map

package/dist/esm/adapters/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","names":[],"sources":["../../../src/adapters/video.ts"],"sourcesContent":["import { BaseLiveVideoAdapter } from '@tanstack/ai/adapters'\nimport { generateId } from '@tanstack/ai-utils'\nimport {\n  mintReactorSessionToken,\n  resolveReactorApiKey,\n  resolveReactorApiUrl,\n} from '../utils/client'\nimport { REACTOR_VIDEO_SLUGS } from '../model-meta'\nimport type { ReactorClientConfig } from '../utils/client'\nimport type {\n  LiveVideoGenerationOptions,\n  LiveVideoGenerationResult,\n} from '@tanstack/ai'\nimport type {\n  ReactorVideoModel,\n  ReactorVideoProviderOptions,\n} from '../model-meta'\n\n/**\n * Reactor live-video adapter. Mints a session-scoped JWT so a browser can\n * connect with `@reactor-team/js-sdk`, set the prompt, and start the stream.\n *\n * @example\n * ```ts\n * import { generateLiveVideo } from '@tanstack/ai'\n * import { reactorVideo } from '@tanstack/ai-reactor'\n *\n * const live = await generateLiveVideo({\n *   adapter: reactorVideo('helios'),\n *   prompt: 'A neon cyberpunk city at night',\n * })\n * ```\n */\nexport class ReactorVideoAdapter<\n  TModel extends ReactorVideoModel,\n> extends BaseLiveVideoAdapter<TModel, ReactorVideoProviderOptions> {\n  readonly name = 'reactor' as const\n  private readonly clientConfig: ReactorClientConfig\n  private readonly apiKey: string\n\n  constructor(model: TModel, config: ReactorClientConfig = {}) {\n    super(model, {})\n    this.apiKey = resolveReactorApiKey(config)\n    this.clientConfig = config\n  }\n\n  async createLiveVideo(\n    options: LiveVideoGenerationOptions<ReactorVideoProviderOptions>,\n  ): Promise<LiveVideoGenerationResult> {\n    const { logger, prompt, abortSignal } = options\n    const modelSlug = REACTOR_VIDEO_SLUGS[this.model]\n    const apiUrl = resolveReactorApiUrl(this.clientConfig)\n\n    logger.request(\n      `activity=generateLiveVideo provider=reactor model=${modelSlug}`,\n      { provider: 'reactor', model: modelSlug },\n    )\n\n    try {\n      const token = await mintReactorSessionToken({\n        apiKey: this.apiKey,\n        apiUrl,\n        modelSlug,\n        fetchImpl: this.clientConfig.fetch,\n        abortSignal,\n      })\n\n      const result: LiveVideoGenerationResult = {\n        id: generateId('liveVideo'),\n        model: modelSlug,\n        token: token.jwt,\n        expiresAt: token.expires_at * 1000,\n        prompt,\n        status: 'ready',\n      }\n\n      logger.output(\n        `activity=generateLiveVideo provider=reactor model=${modelSlug}`,\n        { model: modelSlug, status: result.status },\n      )\n\n      return result\n    } catch (error) {\n      logger.errors('reactor.createLiveVideo failed', {\n        error,\n        source: 'reactor.createLiveVideo',\n      })\n      throw error\n    }\n  }\n}\n\n/**\n * Create a Reactor live-video adapter. Reads `REACTOR_API_KEY` when `apiKey` is\n * omitted.\n */\nexport function reactorVideo<TModel extends ReactorVideoModel>(\n  model: TModel,\n  config?: ReactorClientConfig,\n): ReactorVideoAdapter<TModel> {\n  return new ReactorVideoAdapter(model, config ?? {})\n}\n\n/**\n * Create a Reactor live-video adapter with an explicit API key.\n */\nexport function createReactorVideo<TModel extends ReactorVideoModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<ReactorClientConfig, 'apiKey'>,\n): ReactorVideoAdapter<TModel> {\n  return new ReactorVideoAdapter(model, { ...config, apiKey })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAiCA,IAAa,sBAAb,cAEU,qBAA0D;CAClE,OAAgB;CAChB;CACA;CAEA,YAAY,OAAe,SAA8B,CAAC,GAAG;EAC3D,MAAM,OAAO,CAAC,CAAC;EACf,KAAK,SAAS,qBAAqB,MAAM;EACzC,KAAK,eAAe;CACtB;CAEA,MAAM,gBACJ,SACoC;EACpC,MAAM,EAAE,QAAQ,QAAQ,gBAAgB;EACxC,MAAM,YAAY,oBAAoB,KAAK;EAC3C,MAAM,SAAS,qBAAqB,KAAK,YAAY;EAErD,OAAO,QACL,qDAAqD,aACrD;GAAE,UAAU;GAAW,OAAO;EAAU,CAC1C;EAEA,IAAI;GACF,MAAM,QAAQ,MAAM,wBAAwB;IAC1C,QAAQ,KAAK;IACb;IACA;IACA,WAAW,KAAK,aAAa;IAC7B;GACF,CAAC;GAED,MAAM,SAAoC;IACxC,IAAI,WAAW,WAAW;IAC1B,OAAO;IACP,OAAO,MAAM;IACb,WAAW,MAAM,aAAa;IAC9B;IACA,QAAQ;GACV;GAEA,OAAO,OACL,qDAAqD,aACrD;IAAE,OAAO;IAAW,QAAQ,OAAO;GAAO,CAC5C;GAEA,OAAO;EACT,SAAS,OAAO;GACd,OAAO,OAAO,kCAAkC;IAC9C;IACA,QAAQ;GACV,CAAC;GACD,MAAM;EACR;CACF;AACF;;;;;AAMA,SAAgB,aACd,OACA,QAC6B;CAC7B,OAAO,IAAI,oBAAoB,OAAO,UAAU,CAAC,CAAC;AACpD;;;;AAKA,SAAgB,mBACd,OACA,QACA,QAC6B;CAC7B,OAAO,IAAI,oBAAoB,OAAO;EAAE,GAAG;EAAQ;CAAO,CAAC;AAC7D"}

package/dist/esm/adapters/world.d.ts

@@ -0,0 +1,36 @@
+import { BaseWorldAdapter } from '@tanstack/ai/adapters';
+import { ReactorClientConfig } from '../utils/client.js';
+import { WorldGenerationOptions, WorldGenerationResult } from '@tanstack/ai';
+import { ReactorWorldModel, ReactorWorldProviderOptions } from '../model-meta.js';
+export type { ReactorClientConfig };
+/**
+ * Reactor world adapter. Mints a session-scoped JWT so a browser can connect
+ * with `@reactor-team/js-sdk`, set the prompt, and start the live stream.
+ *
+ * @example
+ * ```ts
+ * import { generateWorld } from '@tanstack/ai'
+ * import { reactorWorld } from '@tanstack/ai-reactor'
+ *
+ * const world = await generateWorld({
+ *   adapter: reactorWorld('visko-orbis-stable'),
+ *   prompt: 'A neon cyberpunk city at night',
+ * })
+ * ```
+ */
+export declare class ReactorWorldAdapter<TModel extends ReactorWorldModel> extends BaseWorldAdapter<TModel, ReactorWorldProviderOptions> {
+    readonly name: "reactor";
+    private readonly clientConfig;
+    private readonly apiKey;
+    constructor(model: TModel, config?: ReactorClientConfig);
+    createWorld(options: WorldGenerationOptions<ReactorWorldProviderOptions>): Promise<WorldGenerationResult>;
+}
+/**
+ * Create a Reactor world adapter. Reads `REACTOR_API_KEY` when `apiKey` is
+ * omitted.
+ */
+export declare function reactorWorld<TModel extends ReactorWorldModel>(model: TModel, config?: ReactorClientConfig): ReactorWorldAdapter<TModel>;
+/**
+ * Create a Reactor world adapter with an explicit API key.
+ */
+export declare function createReactorWorld<TModel extends ReactorWorldModel>(model: TModel, apiKey: string, config?: Omit<ReactorClientConfig, 'apiKey'>): ReactorWorldAdapter<TModel>;

package/dist/esm/adapters/world.js

@@ -0,0 +1,87 @@
+import { mintReactorSessionToken, resolveReactorApiKey, resolveReactorApiUrl } from "../utils/client.js";
+import { REACTOR_WORLD_SLUGS } from "../model-meta.js";
+import { BaseWorldAdapter } from "@tanstack/ai/adapters";
+import { generateId } from "@tanstack/ai-utils";
+//#region src/adapters/world.ts
+/**
+* Reactor world adapter. Mints a session-scoped JWT so a browser can connect
+* with `@reactor-team/js-sdk`, set the prompt, and start the live stream.
+*
+* @example
+* ```ts
+* import { generateWorld } from '@tanstack/ai'
+* import { reactorWorld } from '@tanstack/ai-reactor'
+*
+* const world = await generateWorld({
+*   adapter: reactorWorld('visko-orbis-stable'),
+*   prompt: 'A neon cyberpunk city at night',
+* })
+* ```
+*/
+var ReactorWorldAdapter = class extends BaseWorldAdapter {
+	name = "reactor";
+	clientConfig;
+	apiKey;
+	constructor(model, config = {}) {
+		super(model, {});
+		this.apiKey = resolveReactorApiKey(config);
+		this.clientConfig = config;
+	}
+	async createWorld(options) {
+		const { logger, prompt, abortSignal } = options;
+		const modelSlug = REACTOR_WORLD_SLUGS[this.model];
+		const apiUrl = resolveReactorApiUrl(this.clientConfig);
+		logger.request(`activity=generateWorld provider=reactor model=${modelSlug}`, {
+			provider: "reactor",
+			model: modelSlug
+		});
+		try {
+			const token = await mintReactorSessionToken({
+				apiKey: this.apiKey,
+				apiUrl,
+				modelSlug,
+				fetchImpl: this.clientConfig.fetch,
+				abortSignal
+			});
+			const result = {
+				id: generateId("world"),
+				model: modelSlug,
+				token: token.jwt,
+				expiresAt: token.expires_at * 1e3,
+				prompt,
+				status: "ready"
+			};
+			logger.output(`activity=generateWorld provider=reactor model=${modelSlug}`, {
+				model: modelSlug,
+				status: result.status
+			});
+			return result;
+		} catch (error) {
+			logger.errors("reactor.createWorld failed", {
+				error,
+				source: "reactor.createWorld"
+			});
+			throw error;
+		}
+	}
+};
+/**
+* Create a Reactor world adapter. Reads `REACTOR_API_KEY` when `apiKey` is
+* omitted.
+*/
+function reactorWorld(model, config) {
+	return new ReactorWorldAdapter(model, config ?? {});
+}
+/**
+* Create a Reactor world adapter with an explicit API key.
+*/
+function createReactorWorld(model, apiKey, config) {
+	return new ReactorWorldAdapter(model, {
+		...config,
+		apiKey
+	});
+}
+//#endregion
+export { ReactorWorldAdapter, createReactorWorld, reactorWorld };
+
+//# sourceMappingURL=world.js.map

package/dist/esm/adapters/world.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.js","names":[],"sources":["../../../src/adapters/world.ts"],"sourcesContent":["import { BaseWorldAdapter } from '@tanstack/ai/adapters'\nimport { generateId } from '@tanstack/ai-utils'\nimport {\n  mintReactorSessionToken,\n  resolveReactorApiKey,\n  resolveReactorApiUrl,\n} from '../utils/client'\nimport { REACTOR_WORLD_SLUGS } from '../model-meta'\nimport type { ReactorClientConfig } from '../utils/client'\nimport type {\n  WorldGenerationOptions,\n  WorldGenerationResult,\n} from '@tanstack/ai'\nimport type {\n  ReactorWorldModel,\n  ReactorWorldProviderOptions,\n} from '../model-meta'\n\nexport type { ReactorClientConfig }\n\n/**\n * Reactor world adapter. Mints a session-scoped JWT so a browser can connect\n * with `@reactor-team/js-sdk`, set the prompt, and start the live stream.\n *\n * @example\n * ```ts\n * import { generateWorld } from '@tanstack/ai'\n * import { reactorWorld } from '@tanstack/ai-reactor'\n *\n * const world = await generateWorld({\n *   adapter: reactorWorld('visko-orbis-stable'),\n *   prompt: 'A neon cyberpunk city at night',\n * })\n * ```\n */\nexport class ReactorWorldAdapter<\n  TModel extends ReactorWorldModel,\n> extends BaseWorldAdapter<TModel, ReactorWorldProviderOptions> {\n  readonly name = 'reactor' as const\n  private readonly clientConfig: ReactorClientConfig\n  private readonly apiKey: string\n\n  constructor(model: TModel, config: ReactorClientConfig = {}) {\n    super(model, {})\n    this.apiKey = resolveReactorApiKey(config)\n    this.clientConfig = config\n  }\n\n  async createWorld(\n    options: WorldGenerationOptions<ReactorWorldProviderOptions>,\n  ): Promise<WorldGenerationResult> {\n    const { logger, prompt, abortSignal } = options\n    const modelSlug = REACTOR_WORLD_SLUGS[this.model]\n    const apiUrl = resolveReactorApiUrl(this.clientConfig)\n\n    logger.request(\n      `activity=generateWorld provider=reactor model=${modelSlug}`,\n      { provider: 'reactor', model: modelSlug },\n    )\n\n    try {\n      const token = await mintReactorSessionToken({\n        apiKey: this.apiKey,\n        apiUrl,\n        modelSlug,\n        fetchImpl: this.clientConfig.fetch,\n        abortSignal,\n      })\n\n      const result: WorldGenerationResult = {\n        id: generateId('world'),\n        model: modelSlug,\n        token: token.jwt,\n        expiresAt: token.expires_at * 1000,\n        prompt,\n        status: 'ready',\n      }\n\n      logger.output(\n        `activity=generateWorld provider=reactor model=${modelSlug}`,\n        { model: modelSlug, status: result.status },\n      )\n\n      return result\n    } catch (error) {\n      logger.errors('reactor.createWorld failed', {\n        error,\n        source: 'reactor.createWorld',\n      })\n      throw error\n    }\n  }\n}\n\n/**\n * Create a Reactor world adapter. Reads `REACTOR_API_KEY` when `apiKey` is\n * omitted.\n */\nexport function reactorWorld<TModel extends ReactorWorldModel>(\n  model: TModel,\n  config?: ReactorClientConfig,\n): ReactorWorldAdapter<TModel> {\n  return new ReactorWorldAdapter(model, config ?? {})\n}\n\n/**\n * Create a Reactor world adapter with an explicit API key.\n */\nexport function createReactorWorld<TModel extends ReactorWorldModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<ReactorClientConfig, 'apiKey'>,\n): ReactorWorldAdapter<TModel> {\n  return new ReactorWorldAdapter(model, { ...config, apiKey })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmCA,IAAa,sBAAb,cAEU,iBAAsD;CAC9D,OAAgB;CAChB;CACA;CAEA,YAAY,OAAe,SAA8B,CAAC,GAAG;EAC3D,MAAM,OAAO,CAAC,CAAC;EACf,KAAK,SAAS,qBAAqB,MAAM;EACzC,KAAK,eAAe;CACtB;CAEA,MAAM,YACJ,SACgC;EAChC,MAAM,EAAE,QAAQ,QAAQ,gBAAgB;EACxC,MAAM,YAAY,oBAAoB,KAAK;EAC3C,MAAM,SAAS,qBAAqB,KAAK,YAAY;EAErD,OAAO,QACL,iDAAiD,aACjD;GAAE,UAAU;GAAW,OAAO;EAAU,CAC1C;EAEA,IAAI;GACF,MAAM,QAAQ,MAAM,wBAAwB;IAC1C,QAAQ,KAAK;IACb;IACA;IACA,WAAW,KAAK,aAAa;IAC7B;GACF,CAAC;GAED,MAAM,SAAgC;IACpC,IAAI,WAAW,OAAO;IACtB,OAAO;IACP,OAAO,MAAM;IACb,WAAW,MAAM,aAAa;IAC9B;IACA,QAAQ;GACV;GAEA,OAAO,OACL,iDAAiD,aACjD;IAAE,OAAO;IAAW,QAAQ,OAAO;GAAO,CAC5C;GAEA,OAAO;EACT,SAAS,OAAO;GACd,OAAO,OAAO,8BAA8B;IAC1C;IACA,QAAQ;GACV,CAAC;GACD,MAAM;EACR;CACF;AACF;;;;;AAMA,SAAgB,aACd,OACA,QAC6B;CAC7B,OAAO,IAAI,oBAAoB,OAAO,UAAU,CAAC,CAAC;AACpD;;;;AAKA,SAAgB,mBACd,OACA,QACA,QAC6B;CAC7B,OAAO,IAAI,oBAAoB,OAAO;EAAE,GAAG;EAAQ;CAAO,CAAC;AAC7D"}

package/dist/esm/byok.d.ts

@@ -0,0 +1 @@
+export declare const reactorByok: import('@tanstack/ai/byok').ByokProvider<"reactor">;

package/dist/esm/byok.js

@@ -0,0 +1,11 @@
+import { defineByokProvider } from "@tanstack/ai/byok";
+//#region src/byok.ts
+var reactorByok = defineByokProvider({
+	id: "reactor",
+	label: "Reactor",
+	env: "REACTOR_API_KEY"
+});
+//#endregion
+export { reactorByok };
+
+//# sourceMappingURL=byok.js.map

package/dist/esm/byok.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"byok.js","names":[],"sources":["../../src/byok.ts"],"sourcesContent":["import { defineByokProvider } from '@tanstack/ai/byok'\n\nexport const reactorByok = defineByokProvider({\n  id: 'reactor',\n  label: 'Reactor',\n  env: 'REACTOR_API_KEY',\n})\n"],"mappings":";;AAEA,IAAa,cAAc,mBAAmB;CAC5C,IAAI;CACJ,OAAO;CACP,KAAK;AACP,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,6 @@
+export { ReactorWorldAdapter, reactorWorld, createReactorWorld, } from './adapters/world.js';
+export { ReactorVideoAdapter, reactorVideo, createReactorVideo, } from './adapters/video.js';
+export type { ReactorClientConfig } from './adapters/world.js';
+export { REACTOR_WORLD_MODELS, REACTOR_WORLD_SLUGS, isReactorWorldModel, REACTOR_VIDEO_MODELS, REACTOR_VIDEO_SLUGS, isReactorVideoModel, } from './model-meta.js';
+export type { ReactorWorldModel, ReactorWorldSlug, ReactorWorldResolution, ReactorWorldProviderOptions, ReactorWorldModelProviderOptionsByName, ReactorVideoModel, ReactorVideoSlug, ReactorVideoProviderOptions, ReactorVideoModelProviderOptionsByName, } from './model-meta.js';
+export { DEFAULT_REACTOR_API_URL, getReactorApiKeyFromEnv, mintReactorSessionToken, } from './utils/client.js';

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+import { DEFAULT_REACTOR_API_URL, getReactorApiKeyFromEnv, mintReactorSessionToken } from "./utils/client.js";
+import { REACTOR_VIDEO_MODELS, REACTOR_VIDEO_SLUGS, REACTOR_WORLD_MODELS, REACTOR_WORLD_SLUGS, isReactorVideoModel, isReactorWorldModel } from "./model-meta.js";
+import { ReactorWorldAdapter, createReactorWorld, reactorWorld } from "./adapters/world.js";
+import { ReactorVideoAdapter, createReactorVideo, reactorVideo } from "./adapters/video.js";
+export { DEFAULT_REACTOR_API_URL, REACTOR_VIDEO_MODELS, REACTOR_VIDEO_SLUGS, REACTOR_WORLD_MODELS, REACTOR_WORLD_SLUGS, ReactorVideoAdapter, ReactorWorldAdapter, createReactorVideo, createReactorWorld, getReactorApiKeyFromEnv, isReactorVideoModel, isReactorWorldModel, mintReactorSessionToken, reactorVideo, reactorWorld };

package/dist/esm/model-meta.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Reactor world-model ids and connect slugs.
+ *
+ * Ids are the short names passed to `reactorWorld('visko-orbis-stable')`.
+ * `REACTOR_WORLD_SLUGS` maps each id to the `modelName` the Reactor SDK
+ * connects with.
+ */
+export declare const REACTOR_WORLD_MODELS: readonly ["visko-orbis-stable", "visko-orbis-dynamic", "happy-oyster-adventure", "happy-oyster-director", "lingbot-world-2", "lingbot", "helios"];
+export type ReactorWorldModel = (typeof REACTOR_WORLD_MODELS)[number];
+export declare function isReactorWorldModel(model: string): model is ReactorWorldModel;
+export declare const REACTOR_WORLD_SLUGS: {
+    readonly 'visko-orbis-stable': "reactor/visko-orbis-stable";
+    readonly 'visko-orbis-dynamic': "reactor/visko-orbis-dynamic";
+    readonly 'happy-oyster-adventure': "reactor/happy-oyster-adventure";
+    readonly 'happy-oyster-director': "reactor/happy-oyster-director";
+    readonly 'lingbot-world-2': "reactor/lingbot-world-2";
+    readonly lingbot: "reactor/lingbot";
+    readonly helios: "reactor/helios";
+};
+export type ReactorWorldSlug = (typeof REACTOR_WORLD_SLUGS)[ReactorWorldModel];
+export type ReactorWorldResolution = '1080p' | '2k' | '4k';
+/**
+ * Browser session commands for Reactor world models (`set_resolution`,
+ * `set_seed`, `set_audio_enabled`, `set_audio_prompt`). `createWorld` does
+ * not send these. Keep them in client state and apply after connect.
+ */
+export interface ReactorWorldProviderOptions {
+    /** Delivery resolution for Orbis. Ignored by models that do not expose it. */
+    resolution?: ReactorWorldResolution;
+    /** RNG seed for the next run. */
+    seed?: number;
+    /** When false, skip audio compute on the next start. */
+    audioEnabled?: boolean;
+    /** Sound description. Empty string generates audio from the picture alone. */
+    audioPrompt?: string;
+}
+export type ReactorWorldModelProviderOptionsByName = {
+    [M in ReactorWorldModel]: ReactorWorldProviderOptions;
+};
+/**
+ * Reactor video-model ids and connect slugs.
+ *
+ * Ids are the short names passed to `reactorVideo('helios')`.
+ * `REACTOR_VIDEO_SLUGS` maps each id to the `modelName` the Reactor SDK
+ * connects with.
+ *
+ * These models stream live video over WebRTC. Use them with `generateLiveVideo()`.
+ * They do not return a download URL. X2 and SANA-Streaming need a live source
+ * track, so they are not in this list.
+ */
+export declare const REACTOR_VIDEO_MODELS: readonly ["helios", "fast-h3", "longlive-v2", "ltx2"];
+export type ReactorVideoModel = (typeof REACTOR_VIDEO_MODELS)[number];
+export declare function isReactorVideoModel(model: string): model is ReactorVideoModel;
+export declare const REACTOR_VIDEO_SLUGS: {
+    readonly helios: "reactor/helios";
+    readonly 'fast-h3': "reactor/fast-h3";
+    readonly 'longlive-v2': "reactor/longlive-v2";
+    readonly ltx2: "reactor/ltx2";
+};
+export type ReactorVideoSlug = (typeof REACTOR_VIDEO_SLUGS)[ReactorVideoModel];
+/**
+ * Browser session commands for Reactor video models. Same fields as world.
+ * `createLiveVideo` does not send these. Keep them in client state and apply after
+ * connect.
+ */
+export type ReactorVideoProviderOptions = ReactorWorldProviderOptions;
+export type ReactorVideoModelProviderOptionsByName = {
+    [M in ReactorVideoModel]: ReactorVideoProviderOptions;
+};

package/dist/esm/model-meta.js

@@ -0,0 +1,59 @@
+//#region src/model-meta.ts
+/**
+* Reactor world-model ids and connect slugs.
+*
+* Ids are the short names passed to `reactorWorld('visko-orbis-stable')`.
+* `REACTOR_WORLD_SLUGS` maps each id to the `modelName` the Reactor SDK
+* connects with.
+*/
+var REACTOR_WORLD_MODELS = [
+	"visko-orbis-stable",
+	"visko-orbis-dynamic",
+	"happy-oyster-adventure",
+	"happy-oyster-director",
+	"lingbot-world-2",
+	"lingbot",
+	"helios"
+];
+function isReactorWorldModel(model) {
+	return REACTOR_WORLD_MODELS.includes(model);
+}
+var REACTOR_WORLD_SLUGS = {
+	"visko-orbis-stable": "reactor/visko-orbis-stable",
+	"visko-orbis-dynamic": "reactor/visko-orbis-dynamic",
+	"happy-oyster-adventure": "reactor/happy-oyster-adventure",
+	"happy-oyster-director": "reactor/happy-oyster-director",
+	"lingbot-world-2": "reactor/lingbot-world-2",
+	lingbot: "reactor/lingbot",
+	helios: "reactor/helios"
+};
+/**
+* Reactor video-model ids and connect slugs.
+*
+* Ids are the short names passed to `reactorVideo('helios')`.
+* `REACTOR_VIDEO_SLUGS` maps each id to the `modelName` the Reactor SDK
+* connects with.
+*
+* These models stream live video over WebRTC. Use them with `generateLiveVideo()`.
+* They do not return a download URL. X2 and SANA-Streaming need a live source
+* track, so they are not in this list.
+*/
+var REACTOR_VIDEO_MODELS = [
+	"helios",
+	"fast-h3",
+	"longlive-v2",
+	"ltx2"
+];
+function isReactorVideoModel(model) {
+	return REACTOR_VIDEO_MODELS.includes(model);
+}
+var REACTOR_VIDEO_SLUGS = {
+	helios: "reactor/helios",
+	"fast-h3": "reactor/fast-h3",
+	"longlive-v2": "reactor/longlive-v2",
+	ltx2: "reactor/ltx2"
+};
+//#endregion
+export { REACTOR_VIDEO_MODELS, REACTOR_VIDEO_SLUGS, REACTOR_WORLD_MODELS, REACTOR_WORLD_SLUGS, isReactorVideoModel, isReactorWorldModel };
+
+//# sourceMappingURL=model-meta.js.map

package/dist/esm/model-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-meta.js","names":[],"sources":["../../src/model-meta.ts"],"sourcesContent":["/**\n * Reactor world-model ids and connect slugs.\n *\n * Ids are the short names passed to `reactorWorld('visko-orbis-stable')`.\n * `REACTOR_WORLD_SLUGS` maps each id to the `modelName` the Reactor SDK\n * connects with.\n */\n\nexport const REACTOR_WORLD_MODELS = [\n  'visko-orbis-stable',\n  'visko-orbis-dynamic',\n  'happy-oyster-adventure',\n  'happy-oyster-director',\n  'lingbot-world-2',\n  'lingbot',\n  'helios',\n] as const\n\nexport type ReactorWorldModel = (typeof REACTOR_WORLD_MODELS)[number]\n\nexport function isReactorWorldModel(model: string): model is ReactorWorldModel {\n  return (REACTOR_WORLD_MODELS as ReadonlyArray<string>).includes(model)\n}\n\nexport const REACTOR_WORLD_SLUGS = {\n  'visko-orbis-stable': 'reactor/visko-orbis-stable',\n  'visko-orbis-dynamic': 'reactor/visko-orbis-dynamic',\n  'happy-oyster-adventure': 'reactor/happy-oyster-adventure',\n  'happy-oyster-director': 'reactor/happy-oyster-director',\n  'lingbot-world-2': 'reactor/lingbot-world-2',\n  lingbot: 'reactor/lingbot',\n  helios: 'reactor/helios',\n} as const satisfies Record<ReactorWorldModel, string>\n\nexport type ReactorWorldSlug = (typeof REACTOR_WORLD_SLUGS)[ReactorWorldModel]\n\nexport type ReactorWorldResolution = '1080p' | '2k' | '4k'\n\n/**\n * Browser session commands for Reactor world models (`set_resolution`,\n * `set_seed`, `set_audio_enabled`, `set_audio_prompt`). `createWorld` does\n * not send these. Keep them in client state and apply after connect.\n */\nexport interface ReactorWorldProviderOptions {\n  /** Delivery resolution for Orbis. Ignored by models that do not expose it. */\n  resolution?: ReactorWorldResolution\n  /** RNG seed for the next run. */\n  seed?: number\n  /** When false, skip audio compute on the next start. */\n  audioEnabled?: boolean\n  /** Sound description. Empty string generates audio from the picture alone. */\n  audioPrompt?: string\n}\n\nexport type ReactorWorldModelProviderOptionsByName = {\n  [M in ReactorWorldModel]: ReactorWorldProviderOptions\n}\n\n/**\n * Reactor video-model ids and connect slugs.\n *\n * Ids are the short names passed to `reactorVideo('helios')`.\n * `REACTOR_VIDEO_SLUGS` maps each id to the `modelName` the Reactor SDK\n * connects with.\n *\n * These models stream live video over WebRTC. Use them with `generateLiveVideo()`.\n * They do not return a download URL. X2 and SANA-Streaming need a live source\n * track, so they are not in this list.\n */\n\nexport const REACTOR_VIDEO_MODELS = [\n  'helios',\n  'fast-h3',\n  'longlive-v2',\n  'ltx2',\n] as const\n\nexport type ReactorVideoModel = (typeof REACTOR_VIDEO_MODELS)[number]\n\nexport function isReactorVideoModel(model: string): model is ReactorVideoModel {\n  return (REACTOR_VIDEO_MODELS as ReadonlyArray<string>).includes(model)\n}\n\nexport const REACTOR_VIDEO_SLUGS = {\n  helios: 'reactor/helios',\n  'fast-h3': 'reactor/fast-h3',\n  'longlive-v2': 'reactor/longlive-v2',\n  ltx2: 'reactor/ltx2',\n} as const satisfies Record<ReactorVideoModel, string>\n\nexport type ReactorVideoSlug = (typeof REACTOR_VIDEO_SLUGS)[ReactorVideoModel]\n\n/**\n * Browser session commands for Reactor video models. Same fields as world.\n * `createLiveVideo` does not send these. Keep them in client state and apply after\n * connect.\n */\nexport type ReactorVideoProviderOptions = ReactorWorldProviderOptions\n\nexport type ReactorVideoModelProviderOptionsByName = {\n  [M in ReactorVideoModel]: ReactorVideoProviderOptions\n}\n"],"mappings":";;;;;;;;AAQA,IAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAIA,SAAgB,oBAAoB,OAA2C;CAC7E,OAAQ,qBAA+C,SAAS,KAAK;AACvE;AAEA,IAAa,sBAAsB;CACjC,sBAAsB;CACtB,uBAAuB;CACvB,0BAA0B;CAC1B,yBAAyB;CACzB,mBAAmB;CACnB,SAAS;CACT,QAAQ;AACV;;;;;;;;;;;;AAsCA,IAAa,uBAAuB;CAClC;CACA;CACA;CACA;AACF;AAIA,SAAgB,oBAAoB,OAA2C;CAC7E,OAAQ,qBAA+C,SAAS,KAAK;AACvE;AAEA,IAAa,sBAAsB;CACjC,QAAQ;CACR,WAAW;CACX,eAAe;CACf,MAAM;AACR"}

package/dist/esm/utils/client.d.ts

@@ -0,0 +1,20 @@
+export declare const DEFAULT_REACTOR_API_URL = "https://api.reactor.inc";
+export interface ReactorClientConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+}
+export declare function getReactorApiKeyFromEnv(): string;
+export declare function resolveReactorApiKey(config?: ReactorClientConfig): string;
+export declare function resolveReactorApiUrl(config?: ReactorClientConfig): string;
+export interface ReactorTokenResponse {
+    jwt: string;
+    expires_at: number;
+}
+export declare function mintReactorSessionToken(args: {
+    apiKey: string;
+    apiUrl: string;
+    modelSlug: string;
+    fetchImpl?: typeof fetch;
+    abortSignal?: AbortSignal;
+}): Promise<ReactorTokenResponse>;

package/dist/esm/utils/client.js

@@ -0,0 +1,43 @@
+import { getApiKeyFromEnv } from "@tanstack/ai-utils";
+//#region src/utils/client.ts
+var DEFAULT_REACTOR_API_URL = "https://api.reactor.inc";
+function getReactorApiKeyFromEnv() {
+	return getApiKeyFromEnv("REACTOR_API_KEY");
+}
+function resolveReactorApiKey(config) {
+	return config?.apiKey ?? getReactorApiKeyFromEnv();
+}
+function resolveReactorApiUrl(config) {
+	return (config?.baseUrl ?? "https://api.reactor.inc").replace(/\/+$/, "");
+}
+async function mintReactorSessionToken(args) {
+	const fetchImpl = args.fetchImpl ?? globalThis.fetch;
+	if (typeof fetchImpl !== "function") throw new Error("global fetch is not available. Pass `fetch` in the Reactor adapter config.");
+	const response = await fetchImpl(`${args.apiUrl}/tokens`, {
+		method: "POST",
+		headers: {
+			"Reactor-API-Key": args.apiKey,
+			"Content-Type": "application/json"
+		},
+		body: JSON.stringify({ authorization_details: [{
+			type: "session",
+			resources: { models: { match: [args.modelSlug] } }
+		}] }),
+		...args.abortSignal ? { signal: args.abortSignal } : {}
+	});
+	if (!response.ok) {
+		const detail = await response.text().catch(() => "");
+		throw new Error(`Reactor token request failed (${response.status}${response.statusText ? ` ${response.statusText}` : ""})${detail ? `: ${detail}` : ""}`);
+	}
+	const body = await response.json();
+	if (typeof body.jwt !== "string" || body.jwt.length === 0) throw new Error("Reactor token response did not include a jwt.");
+	if (typeof body.expires_at !== "number" || !Number.isFinite(body.expires_at)) throw new Error("Reactor token response did not include expires_at.");
+	return {
+		jwt: body.jwt,
+		expires_at: body.expires_at
+	};
+}
+//#endregion
+export { DEFAULT_REACTOR_API_URL, getReactorApiKeyFromEnv, mintReactorSessionToken, resolveReactorApiKey, resolveReactorApiUrl };
+
+//# sourceMappingURL=client.js.map

package/dist/esm/utils/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/utils/client.ts"],"sourcesContent":["import { getApiKeyFromEnv } from '@tanstack/ai-utils'\n\nexport const DEFAULT_REACTOR_API_URL = 'https://api.reactor.inc'\n\nexport interface ReactorClientConfig {\n  apiKey?: string\n  baseUrl?: string\n  fetch?: typeof fetch\n}\n\nexport function getReactorApiKeyFromEnv(): string {\n  return getApiKeyFromEnv('REACTOR_API_KEY')\n}\n\nexport function resolveReactorApiKey(config?: ReactorClientConfig): string {\n  return config?.apiKey ?? getReactorApiKeyFromEnv()\n}\n\nexport function resolveReactorApiUrl(config?: ReactorClientConfig): string {\n  return (config?.baseUrl ?? DEFAULT_REACTOR_API_URL).replace(/\\/+$/, '')\n}\n\nexport interface ReactorTokenResponse {\n  jwt: string\n  expires_at: number\n}\n\nexport async function mintReactorSessionToken(args: {\n  apiKey: string\n  apiUrl: string\n  modelSlug: string\n  fetchImpl?: typeof fetch\n  abortSignal?: AbortSignal\n}): Promise<ReactorTokenResponse> {\n  const fetchImpl = args.fetchImpl ?? globalThis.fetch\n  if (typeof fetchImpl !== 'function') {\n    throw new Error(\n      'global fetch is not available. Pass `fetch` in the Reactor adapter config.',\n    )\n  }\n\n  const response = await fetchImpl(`${args.apiUrl}/tokens`, {\n    method: 'POST',\n    headers: {\n      'Reactor-API-Key': args.apiKey,\n      'Content-Type': 'application/json',\n    },\n    body: JSON.stringify({\n      authorization_details: [\n        {\n          type: 'session',\n          resources: { models: { match: [args.modelSlug] } },\n        },\n      ],\n    }),\n    ...(args.abortSignal ? { signal: args.abortSignal } : {}),\n  })\n\n  if (!response.ok) {\n    const detail = await response.text().catch(() => '')\n    throw new Error(\n      `Reactor token request failed (${response.status}${\n        response.statusText ? ` ${response.statusText}` : ''\n      })${detail ? `: ${detail}` : ''}`,\n    )\n  }\n\n  const body = (await response.json()) as {\n    jwt?: unknown\n    expires_at?: unknown\n  }\n\n  if (typeof body.jwt !== 'string' || body.jwt.length === 0) {\n    throw new Error('Reactor token response did not include a jwt.')\n  }\n\n  if (\n    typeof body.expires_at !== 'number' ||\n    !Number.isFinite(body.expires_at)\n  ) {\n    throw new Error('Reactor token response did not include expires_at.')\n  }\n\n  return { jwt: body.jwt, expires_at: body.expires_at }\n}\n"],"mappings":";;AAEA,IAAa,0BAA0B;AAQvC,SAAgB,0BAAkC;CAChD,OAAO,iBAAiB,iBAAiB;AAC3C;AAEA,SAAgB,qBAAqB,QAAsC;CACzE,OAAO,QAAQ,UAAU,wBAAwB;AACnD;AAEA,SAAgB,qBAAqB,QAAsC;CACzE,QAAQ,QAAQ,WAAA,0BAAA,CAAoC,QAAQ,QAAQ,EAAE;AACxE;AAOA,eAAsB,wBAAwB,MAMZ;CAChC,MAAM,YAAY,KAAK,aAAa,WAAW;CAC/C,IAAI,OAAO,cAAc,YACvB,MAAM,IAAI,MACR,4EACF;CAGF,MAAM,WAAW,MAAM,UAAU,GAAG,KAAK,OAAO,UAAU;EACxD,QAAQ;EACR,SAAS;GACP,mBAAmB,KAAK;GACxB,gBAAgB;EAClB;EACA,MAAM,KAAK,UAAU,EACnB,uBAAuB,CACrB;GACE,MAAM;GACN,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,KAAK,SAAS,EAAE,EAAE;EACnD,CACF,EACF,CAAC;EACD,GAAI,KAAK,cAAc,EAAE,QAAQ,KAAK,YAAY,IAAI,CAAC;CACzD,CAAC;CAED,IAAI,CAAC,SAAS,IAAI;EAChB,MAAM,SAAS,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,EAAE;EACnD,MAAM,IAAI,MACR,iCAAiC,SAAS,SACxC,SAAS,aAAa,IAAI,SAAS,eAAe,GACnD,GAAG,SAAS,KAAK,WAAW,IAC/B;CACF;CAEA,MAAM,OAAQ,MAAM,SAAS,KAAK;CAKlC,IAAI,OAAO,KAAK,QAAQ,YAAY,KAAK,IAAI,WAAW,GACtD,MAAM,IAAI,MAAM,+CAA+C;CAGjE,IACE,OAAO,KAAK,eAAe,YAC3B,CAAC,OAAO,SAAS,KAAK,UAAU,GAEhC,MAAM,IAAI,MAAM,oDAAoD;CAGtE,OAAO;EAAE,KAAK,KAAK;EAAK,YAAY,KAAK;CAAW;AACtD"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@tanstack/ai-reactor",
+  "version": "0.2.0",
+  "description": "Reactor adapter for TanStack AI live world and video generation (Orbis, Happy Oyster, LingBot, Helios, FastH3).",
+  "author": "Tanner Linsley",
+  "license": "MIT",
+  "homepage": "https://tanstack.com/ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TanStack/ai.git",
+    "directory": "packages/ai-reactor"
+  },
+  "bugs": {
+    "url": "https://github.com/TanStack/ai/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/tannerlinsley"
+  },
+  "type": "module",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js"
+    },
+    "./byok": {
+      "types": "./dist/esm/byok.d.ts",
+      "import": "./dist/esm/byok.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
+    "reactor",
+    "adapter",
+    "world-generation",
+    "video-generation",
+    "world-models",
+    "orbis",
+    "realtime-video"
+  ],
+  "dependencies": {
+    "@tanstack/ai-utils": "^0.4.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "4.1.10",
+    "vite": "^8.2.1",
+    "@tanstack/ai": "0.54.0"
+  },
+  "peerDependencies": {
+    "@tanstack/ai": "^0.54.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "clean": "premove ./build ./dist",
+    "lint:fix": "oxlint src --type-aware --fix",
+    "test:build": "publint --strict",
+    "test:oxlint": "oxlint src --type-aware",
+    "test:lib": "vitest run",
+    "test:lib:dev": "pnpm test:lib --watch",
+    "test:types": "tsc"
+  }
+}

package/src/adapters/video.ts

@@ -0,0 +1,113 @@
+import { BaseLiveVideoAdapter } from '@tanstack/ai/adapters'
+import { generateId } from '@tanstack/ai-utils'
+import {
+  mintReactorSessionToken,
+  resolveReactorApiKey,
+  resolveReactorApiUrl,
+} from '../utils/client'
+import { REACTOR_VIDEO_SLUGS } from '../model-meta'
+import type { ReactorClientConfig } from '../utils/client'
+import type {
+  LiveVideoGenerationOptions,
+  LiveVideoGenerationResult,
+} from '@tanstack/ai'
+import type {
+  ReactorVideoModel,
+  ReactorVideoProviderOptions,
+} from '../model-meta'
+
+/**
+ * Reactor live-video adapter. Mints a session-scoped JWT so a browser can
+ * connect with `@reactor-team/js-sdk`, set the prompt, and start the stream.
+ *
+ * @example
+ * ```ts
+ * import { generateLiveVideo } from '@tanstack/ai'
+ * import { reactorVideo } from '@tanstack/ai-reactor'
+ *
+ * const live = await generateLiveVideo({
+ *   adapter: reactorVideo('helios'),
+ *   prompt: 'A neon cyberpunk city at night',
+ * })
+ * ```
+ */
+export class ReactorVideoAdapter<
+  TModel extends ReactorVideoModel,
+> extends BaseLiveVideoAdapter<TModel, ReactorVideoProviderOptions> {
+  readonly name = 'reactor' as const
+  private readonly clientConfig: ReactorClientConfig
+  private readonly apiKey: string
+
+  constructor(model: TModel, config: ReactorClientConfig = {}) {
+    super(model, {})
+    this.apiKey = resolveReactorApiKey(config)
+    this.clientConfig = config
+  }
+
+  async createLiveVideo(
+    options: LiveVideoGenerationOptions<ReactorVideoProviderOptions>,
+  ): Promise<LiveVideoGenerationResult> {
+    const { logger, prompt, abortSignal } = options
+    const modelSlug = REACTOR_VIDEO_SLUGS[this.model]
+    const apiUrl = resolveReactorApiUrl(this.clientConfig)
+
+    logger.request(
+      `activity=generateLiveVideo provider=reactor model=${modelSlug}`,
+      { provider: 'reactor', model: modelSlug },
+    )
+
+    try {
+      const token = await mintReactorSessionToken({
+        apiKey: this.apiKey,
+        apiUrl,
+        modelSlug,
+        fetchImpl: this.clientConfig.fetch,
+        abortSignal,
+      })
+
+      const result: LiveVideoGenerationResult = {
+        id: generateId('liveVideo'),
+        model: modelSlug,
+        token: token.jwt,
+        expiresAt: token.expires_at * 1000,
+        prompt,
+        status: 'ready',
+      }
+
+      logger.output(
+        `activity=generateLiveVideo provider=reactor model=${modelSlug}`,
+        { model: modelSlug, status: result.status },
+      )
+
+      return result
+    } catch (error) {
+      logger.errors('reactor.createLiveVideo failed', {
+        error,
+        source: 'reactor.createLiveVideo',
+      })
+      throw error
+    }
+  }
+}
+
+/**
+ * Create a Reactor live-video adapter. Reads `REACTOR_API_KEY` when `apiKey` is
+ * omitted.
+ */
+export function reactorVideo<TModel extends ReactorVideoModel>(
+  model: TModel,
+  config?: ReactorClientConfig,
+): ReactorVideoAdapter<TModel> {
+  return new ReactorVideoAdapter(model, config ?? {})
+}
+
+/**
+ * Create a Reactor live-video adapter with an explicit API key.
+ */
+export function createReactorVideo<TModel extends ReactorVideoModel>(
+  model: TModel,
+  apiKey: string,
+  config?: Omit<ReactorClientConfig, 'apiKey'>,
+): ReactorVideoAdapter<TModel> {
+  return new ReactorVideoAdapter(model, { ...config, apiKey })
+}

package/src/adapters/world.ts

@@ -0,0 +1,115 @@
+import { BaseWorldAdapter } from '@tanstack/ai/adapters'
+import { generateId } from '@tanstack/ai-utils'
+import {
+  mintReactorSessionToken,
+  resolveReactorApiKey,
+  resolveReactorApiUrl,
+} from '../utils/client'
+import { REACTOR_WORLD_SLUGS } from '../model-meta'
+import type { ReactorClientConfig } from '../utils/client'
+import type {
+  WorldGenerationOptions,
+  WorldGenerationResult,
+} from '@tanstack/ai'
+import type {
+  ReactorWorldModel,
+  ReactorWorldProviderOptions,
+} from '../model-meta'
+
+export type { ReactorClientConfig }
+
+/**
+ * Reactor world adapter. Mints a session-scoped JWT so a browser can connect
+ * with `@reactor-team/js-sdk`, set the prompt, and start the live stream.
+ *
+ * @example
+ * ```ts
+ * import { generateWorld } from '@tanstack/ai'
+ * import { reactorWorld } from '@tanstack/ai-reactor'
+ *
+ * const world = await generateWorld({
+ *   adapter: reactorWorld('visko-orbis-stable'),
+ *   prompt: 'A neon cyberpunk city at night',
+ * })
+ * ```
+ */
+export class ReactorWorldAdapter<
+  TModel extends ReactorWorldModel,
+> extends BaseWorldAdapter<TModel, ReactorWorldProviderOptions> {
+  readonly name = 'reactor' as const
+  private readonly clientConfig: ReactorClientConfig
+  private readonly apiKey: string
+
+  constructor(model: TModel, config: ReactorClientConfig = {}) {
+    super(model, {})
+    this.apiKey = resolveReactorApiKey(config)
+    this.clientConfig = config
+  }
+
+  async createWorld(
+    options: WorldGenerationOptions<ReactorWorldProviderOptions>,
+  ): Promise<WorldGenerationResult> {
+    const { logger, prompt, abortSignal } = options
+    const modelSlug = REACTOR_WORLD_SLUGS[this.model]
+    const apiUrl = resolveReactorApiUrl(this.clientConfig)
+
+    logger.request(
+      `activity=generateWorld provider=reactor model=${modelSlug}`,
+      { provider: 'reactor', model: modelSlug },
+    )
+
+    try {
+      const token = await mintReactorSessionToken({
+        apiKey: this.apiKey,
+        apiUrl,
+        modelSlug,
+        fetchImpl: this.clientConfig.fetch,
+        abortSignal,
+      })
+
+      const result: WorldGenerationResult = {
+        id: generateId('world'),
+        model: modelSlug,
+        token: token.jwt,
+        expiresAt: token.expires_at * 1000,
+        prompt,
+        status: 'ready',
+      }
+
+      logger.output(
+        `activity=generateWorld provider=reactor model=${modelSlug}`,
+        { model: modelSlug, status: result.status },
+      )
+
+      return result
+    } catch (error) {
+      logger.errors('reactor.createWorld failed', {
+        error,
+        source: 'reactor.createWorld',
+      })
+      throw error
+    }
+  }
+}
+
+/**
+ * Create a Reactor world adapter. Reads `REACTOR_API_KEY` when `apiKey` is
+ * omitted.
+ */
+export function reactorWorld<TModel extends ReactorWorldModel>(
+  model: TModel,
+  config?: ReactorClientConfig,
+): ReactorWorldAdapter<TModel> {
+  return new ReactorWorldAdapter(model, config ?? {})
+}
+
+/**
+ * Create a Reactor world adapter with an explicit API key.
+ */
+export function createReactorWorld<TModel extends ReactorWorldModel>(
+  model: TModel,
+  apiKey: string,
+  config?: Omit<ReactorClientConfig, 'apiKey'>,
+): ReactorWorldAdapter<TModel> {
+  return new ReactorWorldAdapter(model, { ...config, apiKey })
+}

package/src/byok.ts

@@ -0,0 +1,7 @@
+import { defineByokProvider } from '@tanstack/ai/byok'
+
+export const reactorByok = defineByokProvider({
+  id: 'reactor',
+  label: 'Reactor',
+  env: 'REACTOR_API_KEY',
+})

package/src/index.ts

@@ -0,0 +1,37 @@
+export {
+  ReactorWorldAdapter,
+  reactorWorld,
+  createReactorWorld,
+} from './adapters/world'
+export {
+  ReactorVideoAdapter,
+  reactorVideo,
+  createReactorVideo,
+} from './adapters/video'
+export type { ReactorClientConfig } from './adapters/world'
+
+export {
+  REACTOR_WORLD_MODELS,
+  REACTOR_WORLD_SLUGS,
+  isReactorWorldModel,
+  REACTOR_VIDEO_MODELS,
+  REACTOR_VIDEO_SLUGS,
+  isReactorVideoModel,
+} from './model-meta'
+export type {
+  ReactorWorldModel,
+  ReactorWorldSlug,
+  ReactorWorldResolution,
+  ReactorWorldProviderOptions,
+  ReactorWorldModelProviderOptionsByName,
+  ReactorVideoModel,
+  ReactorVideoSlug,
+  ReactorVideoProviderOptions,
+  ReactorVideoModelProviderOptionsByName,
+} from './model-meta'
+
+export {
+  DEFAULT_REACTOR_API_URL,
+  getReactorApiKeyFromEnv,
+  mintReactorSessionToken,
+} from './utils/client'

package/src/model-meta.ts

@@ -0,0 +1,102 @@
+/**
+ * Reactor world-model ids and connect slugs.
+ *
+ * Ids are the short names passed to `reactorWorld('visko-orbis-stable')`.
+ * `REACTOR_WORLD_SLUGS` maps each id to the `modelName` the Reactor SDK
+ * connects with.
+ */
+
+export const REACTOR_WORLD_MODELS = [
+  'visko-orbis-stable',
+  'visko-orbis-dynamic',
+  'happy-oyster-adventure',
+  'happy-oyster-director',
+  'lingbot-world-2',
+  'lingbot',
+  'helios',
+] as const
+
+export type ReactorWorldModel = (typeof REACTOR_WORLD_MODELS)[number]
+
+export function isReactorWorldModel(model: string): model is ReactorWorldModel {
+  return (REACTOR_WORLD_MODELS as ReadonlyArray<string>).includes(model)
+}
+
+export const REACTOR_WORLD_SLUGS = {
+  'visko-orbis-stable': 'reactor/visko-orbis-stable',
+  'visko-orbis-dynamic': 'reactor/visko-orbis-dynamic',
+  'happy-oyster-adventure': 'reactor/happy-oyster-adventure',
+  'happy-oyster-director': 'reactor/happy-oyster-director',
+  'lingbot-world-2': 'reactor/lingbot-world-2',
+  lingbot: 'reactor/lingbot',
+  helios: 'reactor/helios',
+} as const satisfies Record<ReactorWorldModel, string>
+
+export type ReactorWorldSlug = (typeof REACTOR_WORLD_SLUGS)[ReactorWorldModel]
+
+export type ReactorWorldResolution = '1080p' | '2k' | '4k'
+
+/**
+ * Browser session commands for Reactor world models (`set_resolution`,
+ * `set_seed`, `set_audio_enabled`, `set_audio_prompt`). `createWorld` does
+ * not send these. Keep them in client state and apply after connect.
+ */
+export interface ReactorWorldProviderOptions {
+  /** Delivery resolution for Orbis. Ignored by models that do not expose it. */
+  resolution?: ReactorWorldResolution
+  /** RNG seed for the next run. */
+  seed?: number
+  /** When false, skip audio compute on the next start. */
+  audioEnabled?: boolean
+  /** Sound description. Empty string generates audio from the picture alone. */
+  audioPrompt?: string
+}
+
+export type ReactorWorldModelProviderOptionsByName = {
+  [M in ReactorWorldModel]: ReactorWorldProviderOptions
+}
+
+/**
+ * Reactor video-model ids and connect slugs.
+ *
+ * Ids are the short names passed to `reactorVideo('helios')`.
+ * `REACTOR_VIDEO_SLUGS` maps each id to the `modelName` the Reactor SDK
+ * connects with.
+ *
+ * These models stream live video over WebRTC. Use them with `generateLiveVideo()`.
+ * They do not return a download URL. X2 and SANA-Streaming need a live source
+ * track, so they are not in this list.
+ */
+
+export const REACTOR_VIDEO_MODELS = [
+  'helios',
+  'fast-h3',
+  'longlive-v2',
+  'ltx2',
+] as const
+
+export type ReactorVideoModel = (typeof REACTOR_VIDEO_MODELS)[number]
+
+export function isReactorVideoModel(model: string): model is ReactorVideoModel {
+  return (REACTOR_VIDEO_MODELS as ReadonlyArray<string>).includes(model)
+}
+
+export const REACTOR_VIDEO_SLUGS = {
+  helios: 'reactor/helios',
+  'fast-h3': 'reactor/fast-h3',
+  'longlive-v2': 'reactor/longlive-v2',
+  ltx2: 'reactor/ltx2',
+} as const satisfies Record<ReactorVideoModel, string>
+
+export type ReactorVideoSlug = (typeof REACTOR_VIDEO_SLUGS)[ReactorVideoModel]
+
+/**
+ * Browser session commands for Reactor video models. Same fields as world.
+ * `createLiveVideo` does not send these. Keep them in client state and apply after
+ * connect.
+ */
+export type ReactorVideoProviderOptions = ReactorWorldProviderOptions
+
+export type ReactorVideoModelProviderOptionsByName = {
+  [M in ReactorVideoModel]: ReactorVideoProviderOptions
+}

package/src/utils/client.ts

@@ -0,0 +1,85 @@
+import { getApiKeyFromEnv } from '@tanstack/ai-utils'
+
+export const DEFAULT_REACTOR_API_URL = 'https://api.reactor.inc'
+
+export interface ReactorClientConfig {
+  apiKey?: string
+  baseUrl?: string
+  fetch?: typeof fetch
+}
+
+export function getReactorApiKeyFromEnv(): string {
+  return getApiKeyFromEnv('REACTOR_API_KEY')
+}
+
+export function resolveReactorApiKey(config?: ReactorClientConfig): string {
+  return config?.apiKey ?? getReactorApiKeyFromEnv()
+}
+
+export function resolveReactorApiUrl(config?: ReactorClientConfig): string {
+  return (config?.baseUrl ?? DEFAULT_REACTOR_API_URL).replace(/\/+$/, '')
+}
+
+export interface ReactorTokenResponse {
+  jwt: string
+  expires_at: number
+}
+
+export async function mintReactorSessionToken(args: {
+  apiKey: string
+  apiUrl: string
+  modelSlug: string
+  fetchImpl?: typeof fetch
+  abortSignal?: AbortSignal
+}): Promise<ReactorTokenResponse> {
+  const fetchImpl = args.fetchImpl ?? globalThis.fetch
+  if (typeof fetchImpl !== 'function') {
+    throw new Error(
+      'global fetch is not available. Pass `fetch` in the Reactor adapter config.',
+    )
+  }
+
+  const response = await fetchImpl(`${args.apiUrl}/tokens`, {
+    method: 'POST',
+    headers: {
+      'Reactor-API-Key': args.apiKey,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      authorization_details: [
+        {
+          type: 'session',
+          resources: { models: { match: [args.modelSlug] } },
+        },
+      ],
+    }),
+    ...(args.abortSignal ? { signal: args.abortSignal } : {}),
+  })
+
+  if (!response.ok) {
+    const detail = await response.text().catch(() => '')
+    throw new Error(
+      `Reactor token request failed (${response.status}${
+        response.statusText ? ` ${response.statusText}` : ''
+      })${detail ? `: ${detail}` : ''}`,
+    )
+  }
+
+  const body = (await response.json()) as {
+    jwt?: unknown
+    expires_at?: unknown
+  }
+
+  if (typeof body.jwt !== 'string' || body.jwt.length === 0) {
+    throw new Error('Reactor token response did not include a jwt.')
+  }
+
+  if (
+    typeof body.expires_at !== 'number' ||
+    !Number.isFinite(body.expires_at)
+  ) {
+    throw new Error('Reactor token response did not include expires_at.')
+  }
+
+  return { jwt: body.jwt, expires_at: body.expires_at }
+}