Read the CLI-written CPK_INTELLIGENCE_API_KEY as the Intelligence key fallback

.env.example

@@ -131,7 +131,7 @@ INTELLIGENCE_GATEWAY_WS_URL=wss://realtime.intelligence.copilotkit.ai
 #   npx --yes copilotkit@latest project select  # writes the cpk-... key to .env as CPK_INTELLIGENCE_API_KEY
 #   bun scripts/setup-learning.ts               # copies it here, as INTELLIGENCE_API_KEY
 #
-# The server reads only INTELLIGENCE_API_KEY, so a key left as CPK_INTELLIGENCE_API_KEY is not seen.
+# The server reads INTELLIGENCE_API_KEY first and falls back to CPK_INTELLIGENCE_API_KEY, so the CLI-written key works as written.
 #
 # The runtime key is also under "API Keys" in your project at https://intelligence.copilotkit.ai
 INTELLIGENCE_API_KEY=

README.md

@@ -138,12 +138,12 @@ not a production installation. Run its
 `npx copilotkit@latest local connect` from the OpenBot root, where `.env` is.
 
 That command writes `INTELLIGENCE_API_URL`, `INTELLIGENCE_GATEWAY_WS_URL` and
-`CPK_INTELLIGENCE_API_KEY` to `.env`. OpenBot reads the first two as they are, but takes its project
-key only from `INTELLIGENCE_API_KEY` and refuses to start without it, so copy the `cpk-...` value
-across before `bash scripts/start.sh`:
+`CPK_INTELLIGENCE_API_KEY` to `.env`. OpenBot reads the first two as they are and falls back to
+`CPK_INTELLIGENCE_API_KEY` for its project key, so `bash scripts/start.sh` works as written. Set
+`INTELLIGENCE_API_KEY` only when it should differ from the CLI-written key:
 
 ```sh
-INTELLIGENCE_API_KEY=cpk-...   # the value of CPK_INTELLIGENCE_API_KEY
+INTELLIGENCE_API_KEY=cpk-...   # overrides CPK_INTELLIGENCE_API_KEY
 ```
 
 To give the Bots a Learning container on that stack, see

prompt.txt

@@ -103,9 +103,9 @@ OpenBot root where `.env` is:
   npx copilotkit@latest local connect --approve-connection
 
 `local connect` writes INTELLIGENCE_API_URL, INTELLIGENCE_GATEWAY_WS_URL and
-CPK_INTELLIGENCE_API_KEY to `.env`. OpenBot reads the first two as they are but takes its project
-key only from INTELLIGENCE_API_KEY, so copy the `cpk-...` value of CPK_INTELLIGENCE_API_KEY into
-INTELLIGENCE_API_KEY before `bash scripts/start.sh`. The local licence lasts 30 days;
+CPK_INTELLIGENCE_API_KEY to `.env`. OpenBot reads the first two as they are and falls back to
+CPK_INTELLIGENCE_API_KEY for its project key, so `bash scripts/start.sh` works as written; set
+INTELLIGENCE_API_KEY only when it should differ from the CLI-written key. The local licence lasts 30 days;
 `npx copilotkit@latest local renew` renews it as often as needed while the account is in good
 standing. Skip the managed `project select` and setup-learning commands on this path.
 

server/src/config.ts

@@ -949,7 +949,11 @@ function runtimeCapabilities(environment: Environment): RuntimeCapabilities {
   const settings = {
     apiUrl: url(environment, "INTELLIGENCE_API_URL"),
     gatewayWsUrl: url(environment, "INTELLIGENCE_GATEWAY_WS_URL"),
-    apiKey: optional(environment, "INTELLIGENCE_API_KEY"),
+    // The CopilotKit CLI writes the runtime key as CPK_INTELLIGENCE_API_KEY; setup-learning.ts
+    // copies it across, but a deployment that ran only the CLI would otherwise refuse to boot.
+    apiKey:
+      optional(environment, "INTELLIGENCE_API_KEY") ??
+      optional(environment, "CPK_INTELLIGENCE_API_KEY"),
     licenseToken: optional(environment, "COPILOTKIT_LICENSE_TOKEN"),
   };
 

server/tests/config.test.ts

@@ -117,6 +117,27 @@ describe("deployment configuration", () => {
     );
   });
 
+  test("reads the CLI-written CPK_INTELLIGENCE_API_KEY when INTELLIGENCE_API_KEY is unset", () => {
+    const environment: Record<string, string | undefined> = {
+      ...baseEnvironment,
+    };
+    delete environment.INTELLIGENCE_API_KEY;
+    environment.CPK_INTELLIGENCE_API_KEY = "cpk-cli-written";
+
+    const config = loadConfig(environment);
+
+    expect(config.runtime.intelligence.apiKey).toBe("cpk-cli-written");
+  });
+
+  test("prefers INTELLIGENCE_API_KEY over CPK_INTELLIGENCE_API_KEY when both are set", () => {
+    const config = loadConfig({
+      ...baseEnvironment,
+      CPK_INTELLIGENCE_API_KEY: "cpk-cli-written",
+    });
+
+    expect(config.runtime.intelligence.apiKey).toBe("tenant-api-key");
+  });
+
   test("starts without COPILOTKIT_LICENSE_TOKEN, because managed Intelligence no longer issues one", () => {
     const environment: Record<string, string | undefined> = {
       ...baseEnvironment,