@elizaos/plugin-streaming 2.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 elizaOS
+
+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,7 @@
+# @elizaos/plugin-streaming
+
+Unified RTMP streaming: Twitch, YouTube Live, X (Twitter), pump.fun, `streaming.customRtmp`, and `streaming.rtmpSources[]` for named extra ingests.
+
+Default export: **`streamingPlugin`**. Preset factories: **`createTwitchDestination`**, **`createYoutubeDestination`**, **`createXStreamDestination`**, **`createPumpfunDestination`**. Helpers: **`createCustomRtmpDestination`**, **`createNamedRtmpDestination`**.
+
+Stream keys still come from each platform’s studio/dashboard (no OAuth in this package).

package/dist/api/stream-persistence.d.ts

@@ -0,0 +1,68 @@
+import { StreamingDestination } from '../core.js';
+import '@elizaos/core';
+
+/**
+ * Stream persistence layer — overlay layout and visual/voice settings I/O.
+ *
+ * Extracted from stream-routes.ts to keep that file focused on route handling.
+ * All functions here deal with reading/writing JSON files under the
+ * `data/stream/` directory.
+ *
+ * @module api/stream-persistence
+ */
+
+interface StreamVoiceSettings {
+    enabled: boolean;
+    provider?: string;
+    autoSpeak?: boolean;
+}
+interface StreamVisualSettings {
+    theme?: string;
+    avatarIndex?: number;
+    voice?: StreamVoiceSettings;
+}
+/** Sanitize destination ID for use as a filename segment. */
+declare function safeDestId(id: string): string;
+/** Extract `?destination=<id>` from the raw request URL. */
+declare function parseDestinationQuery(url?: string): string | undefined;
+/**
+ * Read overlay layout for a destination.
+ * Falls back: destination-specific -> global -> plugin default -> null.
+ */
+declare function readOverlayLayout(destinationId?: string | null, destination?: StreamingDestination): unknown;
+/** Write overlay layout (to destination-specific or global file). */
+declare function writeOverlayLayout(layout: unknown, destinationId?: string | null): void;
+/**
+ * Seed the plugin's default overlay layout on first stream start.
+ * Only writes if no destination-specific layout file exists yet.
+ */
+declare function seedOverlayDefaults(destination: StreamingDestination): void;
+/**
+ * Validate and sanitize a raw settings object into a safe StreamVisualSettings.
+ * Only allows known keys with expected types — rejects everything else.
+ * Returns null with an error message if validation fails.
+ */
+declare function validateStreamSettings(raw: unknown): {
+    settings: StreamVisualSettings;
+    error?: undefined;
+} | {
+    settings?: undefined;
+    error: string;
+};
+declare function readStreamSettings(): StreamVisualSettings;
+declare function writeStreamSettings(settings: StreamVisualSettings): void;
+/**
+ * Build the visual config for browser-capture by merging:
+ *   1. Server-side stream-settings.json (authoritative)
+ *   2. Environment variables (STREAM_THEME, STREAM_AVATAR_INDEX) as fallback
+ *
+ * Reads the active destination's overlay layout when available.
+ */
+declare function getHeadlessCaptureConfig(destinationId?: string | null): {
+    overlayLayout?: string;
+    theme?: string;
+    avatarIndex?: number;
+    destinationId?: string;
+};
+
+export { type StreamVisualSettings, type StreamVoiceSettings, getHeadlessCaptureConfig, parseDestinationQuery, readOverlayLayout, readStreamSettings, safeDestId, seedOverlayDefaults, validateStreamSettings, writeOverlayLayout, writeStreamSettings };

package/dist/api/stream-persistence.js

@@ -0,0 +1,181 @@
+import fs from "node:fs";
+import path from "node:path";
+import { logger } from "@elizaos/core";
+const OVERLAY_DIR = path.join(
+  process.env.ELIZA_DATA_DIR || path.join(process.cwd(), "data"),
+  "stream"
+);
+const SETTINGS_FILE = path.join(OVERLAY_DIR, "stream-settings.json");
+function safeDestId(id) {
+  return id.replace(/[^a-zA-Z0-9_-]/g, "");
+}
+function overlayFileForDestination(destinationId) {
+  if (destinationId) {
+    return path.join(
+      OVERLAY_DIR,
+      `overlay-layout-${safeDestId(destinationId)}.json`
+    );
+  }
+  return path.join(OVERLAY_DIR, "overlay-layout.json");
+}
+function parseDestinationQuery(url) {
+  if (!url) return void 0;
+  try {
+    const u = new URL(url, "http://localhost");
+    return u.searchParams.get("destination") || void 0;
+  } catch {
+    return void 0;
+  }
+}
+function getOverlayLayoutJson(destinationId) {
+  const files = destinationId ? [
+    overlayFileForDestination(destinationId),
+    overlayFileForDestination(null)
+  ] : [overlayFileForDestination(null)];
+  for (const f of files) {
+    try {
+      if (fs.existsSync(f)) {
+        return fs.readFileSync(f, "utf-8");
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+function readOverlayLayout(destinationId, destination) {
+  if (destinationId) {
+    const destFile = overlayFileForDestination(destinationId);
+    try {
+      if (fs.existsSync(destFile)) {
+        return JSON.parse(fs.readFileSync(destFile, "utf-8"));
+      }
+    } catch {
+      logger.warn(
+        `[stream] Failed to read overlay layout for ${destinationId}`
+      );
+    }
+  }
+  const globalFile = overlayFileForDestination(null);
+  try {
+    if (fs.existsSync(globalFile)) {
+      return JSON.parse(fs.readFileSync(globalFile, "utf-8"));
+    }
+  } catch {
+    logger.warn("[stream] Failed to read global overlay layout file");
+  }
+  if (destination?.defaultOverlayLayout) {
+    return destination.defaultOverlayLayout;
+  }
+  return null;
+}
+function writeOverlayLayout(layout, destinationId) {
+  fs.mkdirSync(OVERLAY_DIR, { recursive: true });
+  const file = overlayFileForDestination(destinationId);
+  fs.writeFileSync(file, JSON.stringify(layout, null, 2), "utf-8");
+  const label = destinationId ? `[${destinationId}]` : "[global]";
+  logger.info(`[stream] Overlay layout ${label} saved`);
+}
+function seedOverlayDefaults(destination) {
+  if (!destination.defaultOverlayLayout) return;
+  const destFile = overlayFileForDestination(destination.id);
+  if (fs.existsSync(destFile)) return;
+  writeOverlayLayout(destination.defaultOverlayLayout, destination.id);
+  logger.info(`[stream] Seeded default overlay layout for ${destination.name}`);
+}
+const SETTINGS_MAX_JSON_BYTES = 4096;
+function validateStreamSettings(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    return { error: "Settings must be a non-array object" };
+  }
+  const serialized = JSON.stringify(raw);
+  if (serialized.length > SETTINGS_MAX_JSON_BYTES) {
+    return {
+      error: `Settings payload exceeds ${SETTINGS_MAX_JSON_BYTES} byte limit`
+    };
+  }
+  const input = raw;
+  const result = {};
+  if ("theme" in input) {
+    if (typeof input.theme !== "string" || input.theme.length > 64) {
+      return { error: "theme must be a string (max 64 chars)" };
+    }
+    result.theme = input.theme;
+  }
+  if ("avatarIndex" in input) {
+    if (typeof input.avatarIndex !== "number" || !Number.isInteger(input.avatarIndex) || input.avatarIndex < 0 || input.avatarIndex > 999) {
+      return { error: "avatarIndex must be an integer between 0 and 999" };
+    }
+    result.avatarIndex = input.avatarIndex;
+  }
+  if ("voice" in input) {
+    if (!input.voice || typeof input.voice !== "object" || Array.isArray(input.voice)) {
+      return { error: "voice must be an object" };
+    }
+    const v = input.voice;
+    const voice = {
+      enabled: false
+    };
+    if ("enabled" in v) {
+      if (typeof v.enabled !== "boolean") {
+        return { error: "voice.enabled must be a boolean" };
+      }
+      voice.enabled = v.enabled;
+    }
+    if ("autoSpeak" in v) {
+      if (typeof v.autoSpeak !== "boolean") {
+        return { error: "voice.autoSpeak must be a boolean" };
+      }
+      voice.autoSpeak = v.autoSpeak;
+    }
+    if ("provider" in v) {
+      if (typeof v.provider !== "string" || v.provider.length > 64) {
+        return { error: "voice.provider must be a string (max 64 chars)" };
+      }
+      voice.provider = v.provider;
+    }
+    result.voice = voice;
+  }
+  const knownKeys = /* @__PURE__ */ new Set(["theme", "avatarIndex", "voice"]);
+  for (const key of Object.keys(input)) {
+    if (!knownKeys.has(key)) {
+      return { error: `Unknown settings key: ${key}` };
+    }
+  }
+  return { settings: result };
+}
+function readStreamSettings() {
+  try {
+    if (fs.existsSync(SETTINGS_FILE)) {
+      return JSON.parse(fs.readFileSync(SETTINGS_FILE, "utf-8"));
+    }
+  } catch {
+    logger.warn("[stream] Failed to read stream settings file");
+  }
+  return {};
+}
+function writeStreamSettings(settings) {
+  fs.mkdirSync(OVERLAY_DIR, { recursive: true });
+  fs.writeFileSync(SETTINGS_FILE, JSON.stringify(settings, null, 2), "utf-8");
+  logger.info("[stream] Stream settings saved");
+}
+function getHeadlessCaptureConfig(destinationId) {
+  const settings = readStreamSettings();
+  return {
+    overlayLayout: getOverlayLayoutJson(destinationId) ?? void 0,
+    theme: settings.theme ?? process.env.STREAM_THEME,
+    avatarIndex: settings.avatarIndex ?? (process.env.STREAM_AVATAR_INDEX ? parseInt(process.env.STREAM_AVATAR_INDEX, 10) : void 0),
+    destinationId: destinationId ?? void 0
+  };
+}
+export {
+  getHeadlessCaptureConfig,
+  parseDestinationQuery,
+  readOverlayLayout,
+  readStreamSettings,
+  safeDestId,
+  seedOverlayDefaults,
+  validateStreamSettings,
+  writeOverlayLayout,
+  writeStreamSettings
+};
+//# sourceMappingURL=stream-persistence.js.map

package/dist/api/stream-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/stream-persistence.ts"],"sourcesContent":["/**\n * Stream persistence layer — overlay layout and visual/voice settings I/O.\n *\n * Extracted from stream-routes.ts to keep that file focused on route handling.\n * All functions here deal with reading/writing JSON files under the\n * `data/stream/` directory.\n *\n * @module api/stream-persistence\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { logger } from \"@elizaos/core\";\nimport type { StreamingDestination } from \"./streaming-types.js\";\n\n// ---------------------------------------------------------------------------\n// Interfaces\n// ---------------------------------------------------------------------------\n\nexport interface StreamVoiceSettings {\n  enabled: boolean;\n  provider?: string;\n  autoSpeak?: boolean;\n}\n\nexport interface StreamVisualSettings {\n  theme?: string;\n  avatarIndex?: number;\n  voice?: StreamVoiceSettings;\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst OVERLAY_DIR = path.join(\n  process.env.ELIZA_DATA_DIR || path.join(process.cwd(), \"data\"),\n  \"stream\",\n);\n\nconst SETTINGS_FILE = path.join(OVERLAY_DIR, \"stream-settings.json\");\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/** Sanitize destination ID for use as a filename segment. */\nexport function safeDestId(id: string): string {\n  return id.replace(/[^a-zA-Z0-9_-]/g, \"\");\n}\n\n/** Return the layout file path for a given destination (or global default). */\nfunction overlayFileForDestination(destinationId?: string | null): string {\n  if (destinationId) {\n    return path.join(\n      OVERLAY_DIR,\n      `overlay-layout-${safeDestId(destinationId)}.json`,\n    );\n  }\n  return path.join(OVERLAY_DIR, \"overlay-layout.json\");\n}\n\n/** Extract `?destination=<id>` from the raw request URL. */\nexport function parseDestinationQuery(url?: string): string | undefined {\n  if (!url) return undefined;\n  try {\n    const u = new URL(url, \"http://localhost\");\n    return u.searchParams.get(\"destination\") || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Overlay layout persistence (per-destination JSON files)\n// ---------------------------------------------------------------------------\n\n/** Read overlay layout as JSON string for seeding into headless browser. */\nfunction getOverlayLayoutJson(destinationId?: string | null): string | null {\n  const files = destinationId\n    ? [\n        overlayFileForDestination(destinationId),\n        overlayFileForDestination(null),\n      ]\n    : [overlayFileForDestination(null)];\n  for (const f of files) {\n    try {\n      if (fs.existsSync(f)) {\n        return fs.readFileSync(f, \"utf-8\");\n      }\n    } catch {\n      // Not available\n    }\n  }\n  return null;\n}\n\n/**\n * Read overlay layout for a destination.\n * Falls back: destination-specific -> global -> plugin default -> null.\n */\nexport function readOverlayLayout(\n  destinationId?: string | null,\n  destination?: StreamingDestination,\n): unknown {\n  if (destinationId) {\n    const destFile = overlayFileForDestination(destinationId);\n    try {\n      if (fs.existsSync(destFile)) {\n        return JSON.parse(fs.readFileSync(destFile, \"utf-8\"));\n      }\n    } catch {\n      logger.warn(\n        `[stream] Failed to read overlay layout for ${destinationId}`,\n      );\n    }\n  }\n\n  const globalFile = overlayFileForDestination(null);\n  try {\n    if (fs.existsSync(globalFile)) {\n      return JSON.parse(fs.readFileSync(globalFile, \"utf-8\"));\n    }\n  } catch {\n    logger.warn(\"[stream] Failed to read global overlay layout file\");\n  }\n\n  if (destination?.defaultOverlayLayout) {\n    return destination.defaultOverlayLayout;\n  }\n\n  return null;\n}\n\n/** Write overlay layout (to destination-specific or global file). */\nexport function writeOverlayLayout(\n  layout: unknown,\n  destinationId?: string | null,\n): void {\n  fs.mkdirSync(OVERLAY_DIR, { recursive: true });\n  const file = overlayFileForDestination(destinationId);\n  fs.writeFileSync(file, JSON.stringify(layout, null, 2), \"utf-8\");\n  const label = destinationId ? `[${destinationId}]` : \"[global]\";\n  logger.info(`[stream] Overlay layout ${label} saved`);\n}\n\n/**\n * Seed the plugin's default overlay layout on first stream start.\n * Only writes if no destination-specific layout file exists yet.\n */\nexport function seedOverlayDefaults(destination: StreamingDestination): void {\n  if (!destination.defaultOverlayLayout) return;\n  const destFile = overlayFileForDestination(destination.id);\n  if (fs.existsSync(destFile)) return;\n  writeOverlayLayout(destination.defaultOverlayLayout, destination.id);\n  logger.info(`[stream] Seeded default overlay layout for ${destination.name}`);\n}\n\n// ---------------------------------------------------------------------------\n// Stream visual/voice settings persistence\n// ---------------------------------------------------------------------------\n\nconst SETTINGS_MAX_JSON_BYTES = 4096;\n\n/**\n * Validate and sanitize a raw settings object into a safe StreamVisualSettings.\n * Only allows known keys with expected types — rejects everything else.\n * Returns null with an error message if validation fails.\n */\nexport function validateStreamSettings(\n  raw: unknown,\n):\n  | { settings: StreamVisualSettings; error?: undefined }\n  | { settings?: undefined; error: string } {\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n    return { error: \"Settings must be a non-array object\" };\n  }\n\n  // Reject if serialized payload is too large\n  const serialized = JSON.stringify(raw);\n  if (serialized.length > SETTINGS_MAX_JSON_BYTES) {\n    return {\n      error: `Settings payload exceeds ${SETTINGS_MAX_JSON_BYTES} byte limit`,\n    };\n  }\n\n  const input = raw as Record<string, unknown>;\n  const result: StreamVisualSettings = {};\n\n  // theme: optional string, max 64 chars\n  if (\"theme\" in input) {\n    if (typeof input.theme !== \"string\" || input.theme.length > 64) {\n      return { error: \"theme must be a string (max 64 chars)\" };\n    }\n    result.theme = input.theme;\n  }\n\n  // avatarIndex: optional non-negative integer\n  if (\"avatarIndex\" in input) {\n    if (\n      typeof input.avatarIndex !== \"number\" ||\n      !Number.isInteger(input.avatarIndex) ||\n      input.avatarIndex < 0 ||\n      input.avatarIndex > 999\n    ) {\n      return { error: \"avatarIndex must be an integer between 0 and 999\" };\n    }\n    result.avatarIndex = input.avatarIndex;\n  }\n\n  // voice: optional object with known fields\n  if (\"voice\" in input) {\n    if (\n      !input.voice ||\n      typeof input.voice !== \"object\" ||\n      Array.isArray(input.voice)\n    ) {\n      return { error: \"voice must be an object\" };\n    }\n    const v = input.voice as Record<string, unknown>;\n    const voice: StreamVoiceSettings = {\n      enabled: false,\n    };\n    if (\"enabled\" in v) {\n      if (typeof v.enabled !== \"boolean\") {\n        return { error: \"voice.enabled must be a boolean\" };\n      }\n      voice.enabled = v.enabled;\n    }\n    if (\"autoSpeak\" in v) {\n      if (typeof v.autoSpeak !== \"boolean\") {\n        return { error: \"voice.autoSpeak must be a boolean\" };\n      }\n      voice.autoSpeak = v.autoSpeak;\n    }\n    if (\"provider\" in v) {\n      if (typeof v.provider !== \"string\" || v.provider.length > 64) {\n        return { error: \"voice.provider must be a string (max 64 chars)\" };\n      }\n      voice.provider = v.provider;\n    }\n    result.voice = voice;\n  }\n\n  // Reject unknown top-level keys\n  const knownKeys = new Set([\"theme\", \"avatarIndex\", \"voice\"]);\n  for (const key of Object.keys(input)) {\n    if (!knownKeys.has(key)) {\n      return { error: `Unknown settings key: ${key}` };\n    }\n  }\n\n  return { settings: result };\n}\n\nexport function readStreamSettings(): StreamVisualSettings {\n  try {\n    if (fs.existsSync(SETTINGS_FILE)) {\n      return JSON.parse(fs.readFileSync(SETTINGS_FILE, \"utf-8\"));\n    }\n  } catch {\n    logger.warn(\"[stream] Failed to read stream settings file\");\n  }\n  return {};\n}\n\nexport function writeStreamSettings(settings: StreamVisualSettings): void {\n  fs.mkdirSync(OVERLAY_DIR, { recursive: true });\n  fs.writeFileSync(SETTINGS_FILE, JSON.stringify(settings, null, 2), \"utf-8\");\n  logger.info(\"[stream] Stream settings saved\");\n}\n\n/**\n * Build the visual config for browser-capture by merging:\n *   1. Server-side stream-settings.json (authoritative)\n *   2. Environment variables (STREAM_THEME, STREAM_AVATAR_INDEX) as fallback\n *\n * Reads the active destination's overlay layout when available.\n */\nexport function getHeadlessCaptureConfig(destinationId?: string | null): {\n  overlayLayout?: string;\n  theme?: string;\n  avatarIndex?: number;\n  destinationId?: string;\n} {\n  const settings = readStreamSettings();\n  return {\n    overlayLayout: getOverlayLayoutJson(destinationId) ?? undefined,\n    theme: settings.theme ?? process.env.STREAM_THEME,\n    avatarIndex:\n      settings.avatarIndex ??\n      (process.env.STREAM_AVATAR_INDEX\n        ? parseInt(process.env.STREAM_AVATAR_INDEX, 10)\n        : undefined),\n    destinationId: destinationId ?? undefined,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/api/stream-route-state.d.ts

@@ -0,0 +1,59 @@
+import { StreamingDestination } from '../core.js';
+import '@elizaos/core';
+
+interface StreamRouteState {
+    streamManager: {
+        isRunning(): boolean;
+        writeFrame(buf: Buffer): boolean;
+        start(config: unknown): Promise<void>;
+        stop(): Promise<{
+            uptime: number;
+        }>;
+        getHealth(): {
+            running: boolean;
+            ffmpegAlive: boolean;
+            uptime: number;
+            frameCount: number;
+            volume: number;
+            muted: boolean;
+            audioSource: string;
+            inputMode: string | null;
+        };
+        getVolume(): number;
+        isMuted(): boolean;
+        setVolume(level: number): Promise<void>;
+        mute(): Promise<void>;
+        unmute(): Promise<void>;
+    };
+    port?: number;
+    captureUrl?: string;
+    screenCapture?: {
+        isFrameCaptureActive(): boolean;
+        startFrameCapture(opts: {
+            fps?: number;
+            quality?: number;
+            endpoint?: string;
+            gameUrl?: string;
+        }): Promise<void>;
+        stopFrameCapture?(): void;
+    };
+    destinations: Map<string, StreamingDestination>;
+    activeDestinationId?: string;
+    activeStreamSource: {
+        type: "stream-tab" | "game" | "custom-url";
+        url?: string;
+    };
+    config?: {
+        messages?: {
+            tts?: Record<string, unknown>;
+        };
+    };
+    /**
+     * When the client saves stream visual settings, mirror `avatarIndex` into
+     * Eliza `config.ui` (and live server state). Greeting + identity read
+     * `config.ui`, while avatar taps only hit `/api/stream/settings` today.
+     */
+    mirrorStreamAvatarToElizaConfig?: (avatarIndex: number) => void;
+}
+
+export type { StreamRouteState };

package/dist/api/stream-route-state.js

@@ -0,0 +1 @@
+//# sourceMappingURL=stream-route-state.js.map

package/dist/api/stream-route-state.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/api/stream-routes.d.ts

@@ -0,0 +1,43 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { StreamConfig } from '../services/stream-manager.js';
+import { StreamRouteState } from './stream-route-state.js';
+import { StreamingDestination } from '../core.js';
+export { OverlayLayoutData } from '../core.js';
+import '../services/tts-stream-bridge.js';
+import 'node:stream';
+import '@elizaos/core';
+
+/**
+ * Generic streaming infrastructure routes.
+ *
+ * Shared pipeline for all streaming destinations (custom RTMP, Twitch,
+ * YouTube, etc.): capture mode detection, Xvfb management, browser capture,
+ * FFmpeg, frame routing, volume/mute.
+ *
+ * Platform-specific credential fetching lives in destination adapters.
+ */
+
+/** Resolve the active streaming destination from the registry. */
+declare function getActiveDestination(state: StreamRouteState): StreamingDestination | undefined;
+/**
+ * Detect the best capture mode for the current environment.
+ *
+ * Priority:
+ * 1. STREAM_MODE env var (explicit override)
+ * 2. Desktop screen capture bridge -> "pipe" (POST /api/stream/frame -> FFmpeg stdin)
+ * 3. Linux with DISPLAY or Xvfb -> "x11grab" (GPU-backed game-stream approach)
+ * 4. macOS -> "avfoundation" (native screen capture)
+ * 5. Fallback -> "file" (Puppeteer CDP -> temp JPEG -> FFmpeg)
+ */
+/** @internal Exported for testing. */
+declare function detectCaptureMode(): StreamConfig["inputMode"];
+/**
+ * Try to start Xvfb on the specified display if not already running (Linux only).
+ * Returns true if display is available, false otherwise.
+ */
+/** @internal Exported for testing. */
+declare function ensureXvfb(display: string, resolution: string): Promise<boolean>;
+/** Returns `true` if handled, `false` to fall through. */
+declare function handleStreamRoute(req: IncomingMessage, res: ServerResponse, pathname: string, method: string, state: StreamRouteState): Promise<boolean>;
+
+export { StreamRouteState, StreamingDestination, detectCaptureMode, ensureXvfb, getActiveDestination, handleStreamRoute };