@wopr-network/platform-core 1.9.0 → 1.11.0

package/dist/monetization/adapters/bootstrap.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Unified adapter bootstrap — instantiates ALL capability-specific adapter
+ * factories from a single config and returns every adapter ready to register.
+ *
+ * This is the top-level entry point for standing up the full arbitrage stack.
+ * Call `bootstrapAdapters(config)` (or `bootstrapAdaptersFromEnv()`) once at
+ * startup, then register the returned adapters with an ArbitrageRouter or
+ * AdapterSocket.
+ *
+ * Capabilities wired:
+ *   - text-generation (DeepSeek, Gemini, MiniMax, Kimi, OpenRouter)
+ *   - tts (Chatterbox GPU, ElevenLabs)
+ *   - transcription (Deepgram)
+ *   - embeddings (OpenRouter)
+ *   - image-generation (Replicate, Nano Banana)
+ */
+import { type EmbeddingsFactoryConfig } from "./embeddings-factory.js";
+import { type ImageGenFactoryConfig } from "./image-gen-factory.js";
+import { type TextGenFactoryConfig } from "./text-gen-factory.js";
+import { type TranscriptionFactoryConfig } from "./transcription-factory.js";
+import { type TTSFactoryConfig } from "./tts-factory.js";
+import type { ProviderAdapter } from "./types.js";
+/** Combined config for all adapter factories. */
+export interface BootstrapConfig {
+    /** Text-generation adapter config */
+    textGen?: TextGenFactoryConfig;
+    /** TTS adapter config */
+    tts?: TTSFactoryConfig;
+    /** Transcription adapter config */
+    transcription?: TranscriptionFactoryConfig;
+    /** Embeddings adapter config */
+    embeddings?: EmbeddingsFactoryConfig;
+    /** Image generation adapter config */
+    imageGen?: ImageGenFactoryConfig;
+}
+/** Result of bootstrapping all adapters. */
+export interface BootstrapResult {
+    /**
+     * All instantiated adapters across all capabilities, ordered by capability then cost.
+     * Register these with an ArbitrageRouter or AdapterSocket.
+     *
+     * NOTE: The same provider may appear multiple times if it serves multiple
+     * capabilities (e.g. OpenRouter for both text-gen and embeddings). Each
+     * instance is independently configured. Use the per-capability factory
+     * results if you need a name→adapter map within a single capability.
+     *
+     * NOTE: Some adapters advertise more capabilities than the factory that
+     * created them (e.g. Replicate advertises text-generation and transcription
+     * in addition to image-generation). The ArbitrageRouter should use the
+     * factory-assigned capability (reflected in byCapability), not the adapter's
+     * own capabilities array, for routing decisions.
+     */
+    adapters: ProviderAdapter[];
+    /** Names of providers that were skipped (missing config), grouped by capability. */
+    skipped: Record<string, string[]>;
+    /** Summary counts for observability. */
+    summary: {
+        total: number;
+        skipped: number;
+        byCapability: Record<string, number>;
+    };
+}
+/**
+ * Bootstrap all adapter factories from the provided config.
+ *
+ * Instantiates every capability factory and merges the results into a
+ * single unified result. Only adapters with valid config are created.
+ */
+export declare function bootstrapAdapters(config: BootstrapConfig): BootstrapResult;
+/**
+ * Bootstrap all adapter factories from environment variables.
+ *
+ * Reads API keys from:
+ *   - DEEPSEEK_API_KEY, GEMINI_API_KEY, MINIMAX_API_KEY, KIMI_API_KEY, OPENROUTER_API_KEY (text-gen)
+ *   - CHATTERBOX_BASE_URL, ELEVENLABS_API_KEY (TTS)
+ *   - DEEPGRAM_API_KEY (transcription)
+ *   - OPENROUTER_API_KEY (embeddings)
+ *   - REPLICATE_API_TOKEN, NANO_BANANA_API_KEY (image-gen)
+ *
+ * Accepts optional per-capability config overrides.
+ */
+export declare function bootstrapAdaptersFromEnv(overrides?: Partial<BootstrapConfig>): BootstrapResult;

package/dist/monetization/adapters/bootstrap.js

@@ -0,0 +1,115 @@
+/**
+ * Unified adapter bootstrap — instantiates ALL capability-specific adapter
+ * factories from a single config and returns every adapter ready to register.
+ *
+ * This is the top-level entry point for standing up the full arbitrage stack.
+ * Call `bootstrapAdapters(config)` (or `bootstrapAdaptersFromEnv()`) once at
+ * startup, then register the returned adapters with an ArbitrageRouter or
+ * AdapterSocket.
+ *
+ * Capabilities wired:
+ *   - text-generation (DeepSeek, Gemini, MiniMax, Kimi, OpenRouter)
+ *   - tts (Chatterbox GPU, ElevenLabs)
+ *   - transcription (Deepgram)
+ *   - embeddings (OpenRouter)
+ *   - image-generation (Replicate, Nano Banana)
+ */
+import { createEmbeddingsAdapters } from "./embeddings-factory.js";
+import { createImageGenAdapters } from "./image-gen-factory.js";
+import { createTextGenAdapters } from "./text-gen-factory.js";
+import { createTranscriptionAdapters } from "./transcription-factory.js";
+import { createTTSAdapters } from "./tts-factory.js";
+/**
+ * Bootstrap all adapter factories from the provided config.
+ *
+ * Instantiates every capability factory and merges the results into a
+ * single unified result. Only adapters with valid config are created.
+ */
+export function bootstrapAdapters(config) {
+    const textGen = createTextGenAdapters(config.textGen ?? {});
+    const tts = createTTSAdapters(config.tts ?? {});
+    const transcription = createTranscriptionAdapters(config.transcription ?? {});
+    const embeddings = createEmbeddingsAdapters(config.embeddings ?? {});
+    const imageGen = createImageGenAdapters(config.imageGen ?? {});
+    const adapters = [
+        ...textGen.adapters,
+        ...tts.adapters,
+        ...transcription.adapters,
+        ...embeddings.adapters,
+        ...imageGen.adapters,
+    ];
+    const skipped = {};
+    if (textGen.skipped.length > 0)
+        skipped["text-generation"] = textGen.skipped;
+    if (tts.skipped.length > 0)
+        skipped.tts = tts.skipped;
+    if (transcription.skipped.length > 0)
+        skipped.transcription = transcription.skipped;
+    if (embeddings.skipped.length > 0)
+        skipped.embeddings = embeddings.skipped;
+    if (imageGen.skipped.length > 0)
+        skipped["image-generation"] = imageGen.skipped;
+    let totalSkipped = 0;
+    for (const list of Object.values(skipped)) {
+        totalSkipped += list.length;
+    }
+    return {
+        adapters,
+        skipped,
+        summary: {
+            total: adapters.length,
+            skipped: totalSkipped,
+            byCapability: {
+                "text-generation": textGen.adapters.length,
+                tts: tts.adapters.length,
+                transcription: transcription.adapters.length,
+                embeddings: embeddings.adapters.length,
+                "image-generation": imageGen.adapters.length,
+            },
+        },
+    };
+}
+/**
+ * Bootstrap all adapter factories from environment variables.
+ *
+ * Reads API keys from:
+ *   - DEEPSEEK_API_KEY, GEMINI_API_KEY, MINIMAX_API_KEY, KIMI_API_KEY, OPENROUTER_API_KEY (text-gen)
+ *   - CHATTERBOX_BASE_URL, ELEVENLABS_API_KEY (TTS)
+ *   - DEEPGRAM_API_KEY (transcription)
+ *   - OPENROUTER_API_KEY (embeddings)
+ *   - REPLICATE_API_TOKEN, NANO_BANANA_API_KEY (image-gen)
+ *
+ * Accepts optional per-capability config overrides.
+ */
+export function bootstrapAdaptersFromEnv(overrides) {
+    return bootstrapAdapters({
+        textGen: {
+            deepseekApiKey: process.env.DEEPSEEK_API_KEY,
+            geminiApiKey: process.env.GEMINI_API_KEY,
+            minimaxApiKey: process.env.MINIMAX_API_KEY,
+            kimiApiKey: process.env.KIMI_API_KEY,
+            openrouterApiKey: process.env.OPENROUTER_API_KEY,
+            ...overrides?.textGen,
+        },
+        tts: {
+            chatterboxBaseUrl: process.env.CHATTERBOX_BASE_URL,
+            elevenlabsApiKey: process.env.ELEVENLABS_API_KEY,
+            ...overrides?.tts,
+        },
+        transcription: {
+            deepgramApiKey: process.env.DEEPGRAM_API_KEY,
+            ...overrides?.transcription,
+        },
+        embeddings: {
+            openrouterApiKey: process.env.OPENROUTER_API_KEY,
+            ...overrides?.embeddings,
+        },
+        imageGen: {
+            replicateApiToken: process.env.REPLICATE_API_TOKEN,
+            // Separate env var from GEMINI_API_KEY (used for text-gen) to avoid
+            // silently enabling image-gen when only text-gen is intended.
+            geminiApiKey: process.env.NANO_BANANA_API_KEY,
+            ...overrides?.imageGen,
+        },
+    });
+}

package/dist/monetization/adapters/bootstrap.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/monetization/adapters/bootstrap.test.js

@@ -0,0 +1,159 @@
+import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
+import { bootstrapAdapters, bootstrapAdaptersFromEnv } from "./bootstrap.js";
+describe("bootstrapAdapters", () => {
+    it("creates all adapters when all keys provided", () => {
+        const result = bootstrapAdapters({
+            textGen: {
+                deepseekApiKey: "sk-ds",
+                geminiApiKey: "sk-gem",
+                minimaxApiKey: "sk-mm",
+                kimiApiKey: "sk-kimi",
+                openrouterApiKey: "sk-or",
+            },
+            tts: {
+                chatterboxBaseUrl: "http://chatterbox:8000",
+                elevenlabsApiKey: "sk-el",
+            },
+            transcription: {
+                deepgramApiKey: "sk-dg",
+            },
+            embeddings: {
+                openrouterApiKey: "sk-or",
+            },
+            imageGen: {
+                replicateApiToken: "r8-rep",
+                geminiApiKey: "sk-gem",
+            },
+        });
+        // 5 text-gen + 2 TTS + 1 transcription + 1 embeddings + 2 image-gen = 11
+        expect(result.adapters).toHaveLength(11);
+        expect(result.summary.total).toBe(11);
+        expect(result.summary.skipped).toBe(0);
+    });
+    it("allows duplicate provider names across capabilities", () => {
+        const result = bootstrapAdapters({
+            textGen: { openrouterApiKey: "sk-or" },
+            embeddings: { openrouterApiKey: "sk-or" },
+        });
+        // OpenRouter appears twice — once for text-gen, once for embeddings
+        const openrouters = result.adapters.filter((a) => a.name === "openrouter");
+        expect(openrouters).toHaveLength(2);
+        expect(result.summary.total).toBe(2);
+    });
+    it("returns correct per-capability counts", () => {
+        const result = bootstrapAdapters({
+            textGen: { deepseekApiKey: "sk-ds" },
+            tts: { chatterboxBaseUrl: "http://chatterbox:8000" },
+            transcription: { deepgramApiKey: "sk-dg" },
+            embeddings: { openrouterApiKey: "sk-or" },
+        });
+        expect(result.summary.byCapability).toEqual({
+            "text-generation": 1,
+            tts: 1,
+            transcription: 1,
+            embeddings: 1,
+            "image-generation": 0,
+        });
+    });
+    it("tracks skipped providers by capability", () => {
+        const result = bootstrapAdapters({
+            textGen: { deepseekApiKey: "sk-ds" },
+            tts: {},
+            transcription: {},
+            embeddings: {},
+        });
+        expect(result.skipped.tts).toEqual(["chatterbox-tts", "elevenlabs"]);
+        expect(result.skipped.transcription).toEqual(["deepgram"]);
+        expect(result.skipped.embeddings).toEqual(["openrouter"]);
+        expect(result.skipped["text-generation"]).toEqual(["gemini", "minimax", "kimi", "openrouter"]);
+        expect(result.skipped["image-generation"]).toEqual(["replicate", "nano-banana"]);
+    });
+    it("returns empty result when no config provided", () => {
+        const result = bootstrapAdapters({});
+        expect(result.adapters).toHaveLength(0);
+        expect(result.summary.total).toBe(0);
+        expect(result.summary.skipped).toBeGreaterThan(0);
+    });
+    it("omits capability from skipped when all providers created", () => {
+        const result = bootstrapAdapters({
+            transcription: { deepgramApiKey: "sk-dg" },
+        });
+        expect(result.skipped.transcription).toBeUndefined();
+    });
+    it("handles partial config — only text-gen", () => {
+        const result = bootstrapAdapters({
+            textGen: { openrouterApiKey: "sk-or" },
+        });
+        expect(result.summary.byCapability["text-generation"]).toBe(1);
+        expect(result.summary.byCapability.tts).toBe(0);
+        expect(result.summary.byCapability.transcription).toBe(0);
+        expect(result.summary.byCapability.embeddings).toBe(0);
+        expect(result.summary.byCapability["image-generation"]).toBe(0);
+    });
+    it("passes per-adapter overrides through", () => {
+        const result = bootstrapAdapters({
+            textGen: {
+                deepseekApiKey: "sk-ds",
+                deepseek: { marginMultiplier: 1.5 },
+            },
+        });
+        expect(result.adapters).toHaveLength(1);
+        expect(result.adapters[0].name).toBe("deepseek");
+    });
+});
+describe("bootstrapAdaptersFromEnv", () => {
+    beforeEach(() => {
+        vi.unstubAllEnvs();
+    });
+    afterAll(() => {
+        vi.unstubAllEnvs();
+    });
+    it("reads all keys from environment variables", () => {
+        vi.stubEnv("DEEPSEEK_API_KEY", "env-ds");
+        vi.stubEnv("GEMINI_API_KEY", "env-gem");
+        vi.stubEnv("MINIMAX_API_KEY", "env-mm");
+        vi.stubEnv("KIMI_API_KEY", "env-kimi");
+        vi.stubEnv("OPENROUTER_API_KEY", "env-or");
+        vi.stubEnv("CHATTERBOX_BASE_URL", "http://chatterbox:8000");
+        vi.stubEnv("ELEVENLABS_API_KEY", "env-el");
+        vi.stubEnv("DEEPGRAM_API_KEY", "env-dg");
+        vi.stubEnv("REPLICATE_API_TOKEN", "r8-rep");
+        vi.stubEnv("NANO_BANANA_API_KEY", "env-nb");
+        const result = bootstrapAdaptersFromEnv();
+        // 5 text-gen + 2 TTS + 1 transcription + 1 embeddings + 2 image-gen = 11
+        expect(result.adapters).toHaveLength(11);
+        expect(result.summary.total).toBe(11);
+    });
+    it("returns empty when no env vars set", () => {
+        vi.stubEnv("DEEPSEEK_API_KEY", "");
+        vi.stubEnv("GEMINI_API_KEY", "");
+        vi.stubEnv("MINIMAX_API_KEY", "");
+        vi.stubEnv("KIMI_API_KEY", "");
+        vi.stubEnv("OPENROUTER_API_KEY", "");
+        vi.stubEnv("CHATTERBOX_BASE_URL", "");
+        vi.stubEnv("ELEVENLABS_API_KEY", "");
+        vi.stubEnv("DEEPGRAM_API_KEY", "");
+        vi.stubEnv("REPLICATE_API_TOKEN", "");
+        vi.stubEnv("NANO_BANANA_API_KEY", "");
+        const result = bootstrapAdaptersFromEnv();
+        expect(result.adapters).toHaveLength(0);
+        expect(result.summary.skipped).toBeGreaterThan(0);
+    });
+    it("accepts per-capability overrides", () => {
+        vi.stubEnv("DEEPSEEK_API_KEY", "env-ds");
+        vi.stubEnv("GEMINI_API_KEY", "");
+        vi.stubEnv("MINIMAX_API_KEY", "");
+        vi.stubEnv("KIMI_API_KEY", "");
+        vi.stubEnv("OPENROUTER_API_KEY", "");
+        vi.stubEnv("CHATTERBOX_BASE_URL", "");
+        vi.stubEnv("ELEVENLABS_API_KEY", "");
+        vi.stubEnv("DEEPGRAM_API_KEY", "");
+        vi.stubEnv("REPLICATE_API_TOKEN", "");
+        vi.stubEnv("NANO_BANANA_API_KEY", "");
+        const result = bootstrapAdaptersFromEnv({
+            textGen: { deepseek: { marginMultiplier: 2.0 } },
+        });
+        expect(result.adapters).toHaveLength(1);
+        expect(result.adapters[0].name).toBe("deepseek");
+    });
+});

package/dist/monetization/adapters/rate-table.js

@@ -73,6 +73,27 @@ export const RATE_TABLE = [
         margin: 1.3, // 30% — dashboard default; runtime uses getMargin()
         effectivePrice: 0.00009321, // = costPerUnit * margin ($93.21 per 1M seconds ≈ $5.59 per 1M minutes)
     },
+    // Image Generation
+    // NOTE: No self-hosted SDXL adapter yet — only premium tiers available.
+    // When self-hosted-sdxl lands, add a standard tier entry here.
+    {
+        capability: "image-generation",
+        tier: "premium",
+        provider: "nano-banana",
+        costPerUnit: 0.02, // $0.02 per image (Gemini Imagen via Nano Banana)
+        billingUnit: "per-image",
+        margin: 1.3, // 30% — dashboard default; runtime uses getMargin()
+        effectivePrice: 0.026, // = costPerUnit * margin ($26.00 per 1K images)
+    },
+    {
+        capability: "image-generation",
+        tier: "premium",
+        provider: "replicate",
+        costPerUnit: 0.019, // ~$0.019 per image (SDXL on A40, ~8s avg at $0.0023/s)
+        billingUnit: "per-image",
+        margin: 1.3, // 30% — dashboard default; runtime uses getMargin()
+        effectivePrice: 0.0247, // = costPerUnit * margin ($24.70 per 1K images)
+    },
     // Embeddings
     // NOTE: No self-hosted embeddings adapter yet — only premium (openrouter) available.
     // When self-hosted-embeddings lands, add a standard tier entry here.

package/dist/monetization/adapters/rate-table.test.js

@@ -83,7 +83,7 @@ describe("lookupRate", () => {
         expect(premium?.provider).toBe("openrouter");
     });
     it("returns undefined for non-existent capability", () => {
-        const rate = lookupRate("image-generation", "standard");
+        const rate = lookupRate("video-generation", "standard");
         expect(rate).toBeUndefined();
     });
     it("returns undefined for non-existent tier", () => {
@@ -148,7 +148,7 @@ describe("calculateSavings", () => {
     });
     it("returns zero when capability has no premium tier", () => {
         // This would happen if a capability only has self-hosted, no third-party
-        const savings = calculateSavings("embeddings", 1000);
+        const savings = calculateSavings("voice-cloning", 1000);
         expect(savings).toBe(0);
     });
     it("savings scale linearly with units", () => {

package/dist/monetization/index.d.ts

@@ -16,6 +16,7 @@
  */
 export type { ChargeOpts, ChargeResult, CheckoutOpts, CheckoutSession, IPaymentProcessor, PortalOpts, SavedPaymentMethod, SetupResult, WebhookResult as ProcessorWebhookResult, } from "@wopr-network/platform-core/billing";
 export { Credit } from "@wopr-network/platform-core/credits";
+export { type BootstrapConfig, type BootstrapResult, bootstrapAdapters, bootstrapAdaptersFromEnv, } from "./adapters/bootstrap.js";
 export { type ChatterboxTTSAdapterConfig, createChatterboxTTSAdapter } from "./adapters/chatterbox-tts.js";
 export { createDeepgramAdapter, type DeepgramAdapterConfig } from "./adapters/deepgram.js";
 export { createDeepSeekAdapter, type DeepSeekAdapterConfig } from "./adapters/deepseek.js";

package/dist/monetization/index.js

@@ -16,6 +16,8 @@
  */
 // Credit value object (WOP-983)
 export { Credit } from "@wopr-network/platform-core/credits";
+// Unified adapter bootstrap (WOP-2194)
+export { bootstrapAdapters, bootstrapAdaptersFromEnv, } from "./adapters/bootstrap.js";
 // Adapters (WOP-301, WOP-353, WOP-377, WOP-386, WOP-387, WOP-497)
 export { createChatterboxTTSAdapter } from "./adapters/chatterbox-tts.js";
 export { createDeepgramAdapter } from "./adapters/deepgram.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wopr-network/platform-core",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/monetization/adapters/bootstrap.test.ts

@@ -0,0 +1,186 @@
+import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
+import { bootstrapAdapters, bootstrapAdaptersFromEnv } from "./bootstrap.js";
+
+describe("bootstrapAdapters", () => {
+  it("creates all adapters when all keys provided", () => {
+    const result = bootstrapAdapters({
+      textGen: {
+        deepseekApiKey: "sk-ds",
+        geminiApiKey: "sk-gem",
+        minimaxApiKey: "sk-mm",
+        kimiApiKey: "sk-kimi",
+        openrouterApiKey: "sk-or",
+      },
+      tts: {
+        chatterboxBaseUrl: "http://chatterbox:8000",
+        elevenlabsApiKey: "sk-el",
+      },
+      transcription: {
+        deepgramApiKey: "sk-dg",
+      },
+      embeddings: {
+        openrouterApiKey: "sk-or",
+      },
+      imageGen: {
+        replicateApiToken: "r8-rep",
+        geminiApiKey: "sk-gem",
+      },
+    });
+
+    // 5 text-gen + 2 TTS + 1 transcription + 1 embeddings + 2 image-gen = 11
+    expect(result.adapters).toHaveLength(11);
+    expect(result.summary.total).toBe(11);
+    expect(result.summary.skipped).toBe(0);
+  });
+
+  it("allows duplicate provider names across capabilities", () => {
+    const result = bootstrapAdapters({
+      textGen: { openrouterApiKey: "sk-or" },
+      embeddings: { openrouterApiKey: "sk-or" },
+    });
+
+    // OpenRouter appears twice — once for text-gen, once for embeddings
+    const openrouters = result.adapters.filter((a) => a.name === "openrouter");
+    expect(openrouters).toHaveLength(2);
+    expect(result.summary.total).toBe(2);
+  });
+
+  it("returns correct per-capability counts", () => {
+    const result = bootstrapAdapters({
+      textGen: { deepseekApiKey: "sk-ds" },
+      tts: { chatterboxBaseUrl: "http://chatterbox:8000" },
+      transcription: { deepgramApiKey: "sk-dg" },
+      embeddings: { openrouterApiKey: "sk-or" },
+    });
+
+    expect(result.summary.byCapability).toEqual({
+      "text-generation": 1,
+      tts: 1,
+      transcription: 1,
+      embeddings: 1,
+      "image-generation": 0,
+    });
+  });
+
+  it("tracks skipped providers by capability", () => {
+    const result = bootstrapAdapters({
+      textGen: { deepseekApiKey: "sk-ds" },
+      tts: {},
+      transcription: {},
+      embeddings: {},
+    });
+
+    expect(result.skipped.tts).toEqual(["chatterbox-tts", "elevenlabs"]);
+    expect(result.skipped.transcription).toEqual(["deepgram"]);
+    expect(result.skipped.embeddings).toEqual(["openrouter"]);
+    expect(result.skipped["text-generation"]).toEqual(["gemini", "minimax", "kimi", "openrouter"]);
+    expect(result.skipped["image-generation"]).toEqual(["replicate", "nano-banana"]);
+  });
+
+  it("returns empty result when no config provided", () => {
+    const result = bootstrapAdapters({});
+
+    expect(result.adapters).toHaveLength(0);
+    expect(result.summary.total).toBe(0);
+    expect(result.summary.skipped).toBeGreaterThan(0);
+  });
+
+  it("omits capability from skipped when all providers created", () => {
+    const result = bootstrapAdapters({
+      transcription: { deepgramApiKey: "sk-dg" },
+    });
+
+    expect(result.skipped.transcription).toBeUndefined();
+  });
+
+  it("handles partial config — only text-gen", () => {
+    const result = bootstrapAdapters({
+      textGen: { openrouterApiKey: "sk-or" },
+    });
+
+    expect(result.summary.byCapability["text-generation"]).toBe(1);
+    expect(result.summary.byCapability.tts).toBe(0);
+    expect(result.summary.byCapability.transcription).toBe(0);
+    expect(result.summary.byCapability.embeddings).toBe(0);
+    expect(result.summary.byCapability["image-generation"]).toBe(0);
+  });
+
+  it("passes per-adapter overrides through", () => {
+    const result = bootstrapAdapters({
+      textGen: {
+        deepseekApiKey: "sk-ds",
+        deepseek: { marginMultiplier: 1.5 },
+      },
+    });
+
+    expect(result.adapters).toHaveLength(1);
+    expect(result.adapters[0].name).toBe("deepseek");
+  });
+});
+
+describe("bootstrapAdaptersFromEnv", () => {
+  beforeEach(() => {
+    vi.unstubAllEnvs();
+  });
+
+  afterAll(() => {
+    vi.unstubAllEnvs();
+  });
+
+  it("reads all keys from environment variables", () => {
+    vi.stubEnv("DEEPSEEK_API_KEY", "env-ds");
+    vi.stubEnv("GEMINI_API_KEY", "env-gem");
+    vi.stubEnv("MINIMAX_API_KEY", "env-mm");
+    vi.stubEnv("KIMI_API_KEY", "env-kimi");
+    vi.stubEnv("OPENROUTER_API_KEY", "env-or");
+    vi.stubEnv("CHATTERBOX_BASE_URL", "http://chatterbox:8000");
+    vi.stubEnv("ELEVENLABS_API_KEY", "env-el");
+    vi.stubEnv("DEEPGRAM_API_KEY", "env-dg");
+    vi.stubEnv("REPLICATE_API_TOKEN", "r8-rep");
+    vi.stubEnv("NANO_BANANA_API_KEY", "env-nb");
+
+    const result = bootstrapAdaptersFromEnv();
+
+    // 5 text-gen + 2 TTS + 1 transcription + 1 embeddings + 2 image-gen = 11
+    expect(result.adapters).toHaveLength(11);
+    expect(result.summary.total).toBe(11);
+  });
+
+  it("returns empty when no env vars set", () => {
+    vi.stubEnv("DEEPSEEK_API_KEY", "");
+    vi.stubEnv("GEMINI_API_KEY", "");
+    vi.stubEnv("MINIMAX_API_KEY", "");
+    vi.stubEnv("KIMI_API_KEY", "");
+    vi.stubEnv("OPENROUTER_API_KEY", "");
+    vi.stubEnv("CHATTERBOX_BASE_URL", "");
+    vi.stubEnv("ELEVENLABS_API_KEY", "");
+    vi.stubEnv("DEEPGRAM_API_KEY", "");
+    vi.stubEnv("REPLICATE_API_TOKEN", "");
+    vi.stubEnv("NANO_BANANA_API_KEY", "");
+
+    const result = bootstrapAdaptersFromEnv();
+
+    expect(result.adapters).toHaveLength(0);
+    expect(result.summary.skipped).toBeGreaterThan(0);
+  });
+
+  it("accepts per-capability overrides", () => {
+    vi.stubEnv("DEEPSEEK_API_KEY", "env-ds");
+    vi.stubEnv("GEMINI_API_KEY", "");
+    vi.stubEnv("MINIMAX_API_KEY", "");
+    vi.stubEnv("KIMI_API_KEY", "");
+    vi.stubEnv("OPENROUTER_API_KEY", "");
+    vi.stubEnv("CHATTERBOX_BASE_URL", "");
+    vi.stubEnv("ELEVENLABS_API_KEY", "");
+    vi.stubEnv("DEEPGRAM_API_KEY", "");
+    vi.stubEnv("REPLICATE_API_TOKEN", "");
+    vi.stubEnv("NANO_BANANA_API_KEY", "");
+
+    const result = bootstrapAdaptersFromEnv({
+      textGen: { deepseek: { marginMultiplier: 2.0 } },
+    });
+
+    expect(result.adapters).toHaveLength(1);
+    expect(result.adapters[0].name).toBe("deepseek");
+  });
+});

package/src/monetization/adapters/bootstrap.ts

@@ -0,0 +1,160 @@
+/**
+ * Unified adapter bootstrap — instantiates ALL capability-specific adapter
+ * factories from a single config and returns every adapter ready to register.
+ *
+ * This is the top-level entry point for standing up the full arbitrage stack.
+ * Call `bootstrapAdapters(config)` (or `bootstrapAdaptersFromEnv()`) once at
+ * startup, then register the returned adapters with an ArbitrageRouter or
+ * AdapterSocket.
+ *
+ * Capabilities wired:
+ *   - text-generation (DeepSeek, Gemini, MiniMax, Kimi, OpenRouter)
+ *   - tts (Chatterbox GPU, ElevenLabs)
+ *   - transcription (Deepgram)
+ *   - embeddings (OpenRouter)
+ *   - image-generation (Replicate, Nano Banana)
+ */
+
+import { createEmbeddingsAdapters, type EmbeddingsFactoryConfig } from "./embeddings-factory.js";
+import { createImageGenAdapters, type ImageGenFactoryConfig } from "./image-gen-factory.js";
+import { createTextGenAdapters, type TextGenFactoryConfig } from "./text-gen-factory.js";
+import { createTranscriptionAdapters, type TranscriptionFactoryConfig } from "./transcription-factory.js";
+import { createTTSAdapters, type TTSFactoryConfig } from "./tts-factory.js";
+import type { ProviderAdapter } from "./types.js";
+
+/** Combined config for all adapter factories. */
+export interface BootstrapConfig {
+  /** Text-generation adapter config */
+  textGen?: TextGenFactoryConfig;
+  /** TTS adapter config */
+  tts?: TTSFactoryConfig;
+  /** Transcription adapter config */
+  transcription?: TranscriptionFactoryConfig;
+  /** Embeddings adapter config */
+  embeddings?: EmbeddingsFactoryConfig;
+  /** Image generation adapter config */
+  imageGen?: ImageGenFactoryConfig;
+}
+
+/** Result of bootstrapping all adapters. */
+export interface BootstrapResult {
+  /**
+   * All instantiated adapters across all capabilities, ordered by capability then cost.
+   * Register these with an ArbitrageRouter or AdapterSocket.
+   *
+   * NOTE: The same provider may appear multiple times if it serves multiple
+   * capabilities (e.g. OpenRouter for both text-gen and embeddings). Each
+   * instance is independently configured. Use the per-capability factory
+   * results if you need a name→adapter map within a single capability.
+   *
+   * NOTE: Some adapters advertise more capabilities than the factory that
+   * created them (e.g. Replicate advertises text-generation and transcription
+   * in addition to image-generation). The ArbitrageRouter should use the
+   * factory-assigned capability (reflected in byCapability), not the adapter's
+   * own capabilities array, for routing decisions.
+   */
+  adapters: ProviderAdapter[];
+  /** Names of providers that were skipped (missing config), grouped by capability. */
+  skipped: Record<string, string[]>;
+  /** Summary counts for observability. */
+  summary: {
+    total: number;
+    skipped: number;
+    byCapability: Record<string, number>;
+  };
+}
+
+/**
+ * Bootstrap all adapter factories from the provided config.
+ *
+ * Instantiates every capability factory and merges the results into a
+ * single unified result. Only adapters with valid config are created.
+ */
+export function bootstrapAdapters(config: BootstrapConfig): BootstrapResult {
+  const textGen = createTextGenAdapters(config.textGen ?? {});
+  const tts = createTTSAdapters(config.tts ?? {});
+  const transcription = createTranscriptionAdapters(config.transcription ?? {});
+  const embeddings = createEmbeddingsAdapters(config.embeddings ?? {});
+  const imageGen = createImageGenAdapters(config.imageGen ?? {});
+
+  const adapters: ProviderAdapter[] = [
+    ...textGen.adapters,
+    ...tts.adapters,
+    ...transcription.adapters,
+    ...embeddings.adapters,
+    ...imageGen.adapters,
+  ];
+
+  const skipped: Record<string, string[]> = {};
+  if (textGen.skipped.length > 0) skipped["text-generation"] = textGen.skipped;
+  if (tts.skipped.length > 0) skipped.tts = tts.skipped;
+  if (transcription.skipped.length > 0) skipped.transcription = transcription.skipped;
+  if (embeddings.skipped.length > 0) skipped.embeddings = embeddings.skipped;
+  if (imageGen.skipped.length > 0) skipped["image-generation"] = imageGen.skipped;
+
+  let totalSkipped = 0;
+  for (const list of Object.values(skipped)) {
+    totalSkipped += list.length;
+  }
+
+  return {
+    adapters,
+    skipped,
+    summary: {
+      total: adapters.length,
+      skipped: totalSkipped,
+      byCapability: {
+        "text-generation": textGen.adapters.length,
+        tts: tts.adapters.length,
+        transcription: transcription.adapters.length,
+        embeddings: embeddings.adapters.length,
+        "image-generation": imageGen.adapters.length,
+      },
+    },
+  };
+}
+
+/**
+ * Bootstrap all adapter factories from environment variables.
+ *
+ * Reads API keys from:
+ *   - DEEPSEEK_API_KEY, GEMINI_API_KEY, MINIMAX_API_KEY, KIMI_API_KEY, OPENROUTER_API_KEY (text-gen)
+ *   - CHATTERBOX_BASE_URL, ELEVENLABS_API_KEY (TTS)
+ *   - DEEPGRAM_API_KEY (transcription)
+ *   - OPENROUTER_API_KEY (embeddings)
+ *   - REPLICATE_API_TOKEN, NANO_BANANA_API_KEY (image-gen)
+ *
+ * Accepts optional per-capability config overrides.
+ */
+export function bootstrapAdaptersFromEnv(overrides?: Partial<BootstrapConfig>): BootstrapResult {
+  return bootstrapAdapters({
+    textGen: {
+      deepseekApiKey: process.env.DEEPSEEK_API_KEY,
+      geminiApiKey: process.env.GEMINI_API_KEY,
+      minimaxApiKey: process.env.MINIMAX_API_KEY,
+      kimiApiKey: process.env.KIMI_API_KEY,
+      openrouterApiKey: process.env.OPENROUTER_API_KEY,
+      ...overrides?.textGen,
+    },
+    tts: {
+      chatterboxBaseUrl: process.env.CHATTERBOX_BASE_URL,
+      elevenlabsApiKey: process.env.ELEVENLABS_API_KEY,
+      ...overrides?.tts,
+    },
+    transcription: {
+      deepgramApiKey: process.env.DEEPGRAM_API_KEY,
+      ...overrides?.transcription,
+    },
+    embeddings: {
+      openrouterApiKey: process.env.OPENROUTER_API_KEY,
+      ...overrides?.embeddings,
+    },
+    imageGen: {
+      replicateApiToken: process.env.REPLICATE_API_TOKEN,
+      // Separate env var from GEMINI_API_KEY (used for text-gen) to avoid
+      // silently enabling image-gen when only text-gen is intended.
+      geminiApiKey: process.env.NANO_BANANA_API_KEY,
+      ...overrides?.imageGen,
+    },
+  });
+}

package/src/monetization/adapters/rate-table.test.ts

@@ -115,7 +115,7 @@ describe("lookupRate", () => {
   });
 
   it("returns undefined for non-existent capability", () => {
-    const rate = lookupRate("image-generation" as unknown as AdapterCapability, "standard");
+    const rate = lookupRate("video-generation" as unknown as AdapterCapability, "standard");
     expect(rate).toBeUndefined();
   });
 
@@ -194,7 +194,7 @@ describe("calculateSavings", () => {
 
   it("returns zero when capability has no premium tier", () => {
     // This would happen if a capability only has self-hosted, no third-party
-    const savings = calculateSavings("embeddings" as unknown as AdapterCapability, 1000);
+    const savings = calculateSavings("voice-cloning" as unknown as AdapterCapability, 1000);
     expect(savings).toBe(0);
   });
 

package/src/monetization/adapters/rate-table.ts

@@ -96,6 +96,28 @@ export const RATE_TABLE: RateEntry[] = [
     effectivePrice: 0.00009321, // = costPerUnit * margin ($93.21 per 1M seconds ≈ $5.59 per 1M minutes)
   },
 
+  // Image Generation
+  // NOTE: No self-hosted SDXL adapter yet — only premium tiers available.
+  // When self-hosted-sdxl lands, add a standard tier entry here.
+  {
+    capability: "image-generation",
+    tier: "premium",
+    provider: "nano-banana",
+    costPerUnit: 0.02, // $0.02 per image (Gemini Imagen via Nano Banana)
+    billingUnit: "per-image",
+    margin: 1.3, // 30% — dashboard default; runtime uses getMargin()
+    effectivePrice: 0.026, // = costPerUnit * margin ($26.00 per 1K images)
+  },
+  {
+    capability: "image-generation",
+    tier: "premium",
+    provider: "replicate",
+    costPerUnit: 0.019, // ~$0.019 per image (SDXL on A40, ~8s avg at $0.0023/s)
+    billingUnit: "per-image",
+    margin: 1.3, // 30% — dashboard default; runtime uses getMargin()
+    effectivePrice: 0.0247, // = costPerUnit * margin ($24.70 per 1K images)
+  },
+
   // Embeddings
   // NOTE: No self-hosted embeddings adapter yet — only premium (openrouter) available.
   // When self-hosted-embeddings lands, add a standard tier entry here.

package/src/monetization/index.ts

@@ -29,6 +29,13 @@ export type {
 } from "@wopr-network/platform-core/billing";
 // Credit value object (WOP-983)
 export { Credit } from "@wopr-network/platform-core/credits";
+// Unified adapter bootstrap (WOP-2194)
+export {
+  type BootstrapConfig,
+  type BootstrapResult,
+  bootstrapAdapters,
+  bootstrapAdaptersFromEnv,
+} from "./adapters/bootstrap.js";
 // Adapters (WOP-301, WOP-353, WOP-377, WOP-386, WOP-387, WOP-497)
 export { type ChatterboxTTSAdapterConfig, createChatterboxTTSAdapter } from "./adapters/chatterbox-tts.js";
 export { createDeepgramAdapter, type DeepgramAdapterConfig } from "./adapters/deepgram.js";