copilotkit 4.8.1 → 4.8.2

package/cli-build-info.json

@@ -2,20 +2,20 @@
   "schemaVersion": 1,
   "package": {
     "name": "copilotkit",
-    "version": "4.8.1"
+    "version": "4.8.2"
   },
   "intelligence": {
-    "commit": "7e4dbf17af5094cde256eeaecdbef1869ebd13e4"
+    "commit": "fca6bc8954118609a6aa51d8635e632e72626706"
   },
   "copilotKit": {
-    "submittedInput": "7e502dd4a452",
-    "commit": "7e502dd4a452feee7d26c6355fd262948f8c25e6"
+    "submittedInput": "53cf7e6575e8eae2a0dcaf64a7c3c2baf3e6dd04",
+    "commit": "53cf7e6575e8eae2a0dcaf64a7c3c2baf3e6dd04"
   },
   "channel": "production",
-  "triggeringActor": "BenTaylorDev",
+  "triggeringActor": "MikeRyanDev",
   "workflow": {
-    "runId": "31032635990",
-    "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/31032635990"
+    "runId": "31119700532",
+    "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/31119700532"
   },
   "validationResult": "passed",
   "ag2": {
@@ -24,5 +24,5 @@
     "revision": "main",
     "pinned": false
   },
-  "builtAt": "2026-08-05T18:01:39Z"
+  "builtAt": "2026-08-06T22:05:24Z"
 }

package/index.js

@@ -87,14 +87,14 @@ function getTelemetryEndpointUrl() {
 }
 function getBuildInfo() {
   return {
-    version: true ? "4.8.1" : "dev",
-    buildNumber: true ? "31032635990" : "dev",
-    commitSha: true ? "7e4dbf17af5094cde256eeaecdbef1869ebd13e4" : "dev",
+    version: true ? "4.8.2" : "dev",
+    buildNumber: true ? "31119700532" : "dev",
+    commitSha: true ? "fca6bc8954118609a6aa51d8635e632e72626706" : "dev",
     copilotKitCommit: getTemplateRef()
   };
 }
 function getTemplateRef() {
-  return true ? "7e502dd4a452feee7d26c6355fd262948f8c25e6" : "main";
+  return true ? "53cf7e6575e8eae2a0dcaf64a7c3c2baf3e6dd04" : "main";
 }
 function getC15tBackendUrl() {
   return true ? "https://calm-hazelnut-joy-copilotkit.inth.app" : "";
@@ -939,7 +939,7 @@ function deriveSkillsSelection(flags) {
     agent_count: agentCount
   };
 }
-function classifyError(err) {
+function classifyError(err, depth = 0) {
   if (!(err instanceof Error)) {
     return "unknown";
   }
@@ -994,9 +994,13 @@ function classifyError(err) {
       return "network";
     }
   }
+  const cause = err.cause;
+  if (cause !== void 0 && cause !== null && depth < MAX_CAUSE_DEPTH) {
+    return classifyError(cause, depth + 1);
+  }
   return "unknown";
 }
-var TELEMETRY_ERROR_CODES, CI_INDICATOR_VARS;
+var TELEMETRY_ERROR_CODES, CI_INDICATOR_VARS, MAX_CAUSE_DEPTH;
 var init_event_properties = __esm({
   "apps/cli/src/services/telemetry/event-properties.ts"() {
     "use strict";
@@ -1021,6 +1025,7 @@ var init_event_properties = __esm({
       "JENKINS_URL",
       "TF_BUILD"
     ];
+    MAX_CAUSE_DEPTH = 4;
   }
 });
 
@@ -28248,6 +28253,46 @@ var init_config_service = __esm({
   }
 });
 
+// apps/cli/src/services/project-config.ts
+import * as fs6 from "node:fs";
+import * as path8 from "node:path";
+function projectConfigPath(dir) {
+  return path8.join(dir, ".copilotkit", "project.json");
+}
+function readProjectConfig(dir) {
+  const configPath = projectConfigPath(dir);
+  if (!fs6.existsSync(configPath)) {
+    return void 0;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(fs6.readFileSync(configPath, "utf8"));
+  } catch {
+    return void 0;
+  }
+  const validated = projectConfigSchema.safeParse(parsed);
+  return validated.success ? validated.data : void 0;
+}
+function writeProjectConfig(dir, config2) {
+  const validated = projectConfigSchema.parse(config2);
+  const configPath = projectConfigPath(dir);
+  fs6.mkdirSync(path8.dirname(configPath), { recursive: true });
+  fs6.writeFileSync(configPath, `${JSON.stringify(validated, null, 2)}
+`);
+}
+var projectConfigSchema;
+var init_project_config = __esm({
+  "apps/cli/src/services/project-config.ts"() {
+    "use strict";
+    init_zod();
+    projectConfigSchema = external_exports.object({
+      projectId: external_exports.string().min(1),
+      projectSlug: external_exports.string().min(1),
+      clerkOrgId: external_exports.string().min(1)
+    }).strict();
+  }
+});
+
 // node_modules/.pnpm/pino-std-serializers@7.1.0/node_modules/pino-std-serializers/lib/err-helpers.js
 var require_err_helpers = __commonJS({
   "node_modules/.pnpm/pino-std-serializers@7.1.0/node_modules/pino-std-serializers/lib/err-helpers.js"(exports2, module2) {
@@ -32669,19 +32714,19 @@ __export(cli_logs_exports, {
   setCliLogsVerbose: () => setCliLogsVerbose,
   writeCliLog: () => writeCliLog
 });
-import * as fs6 from "node:fs";
+import * as fs7 from "node:fs";
 import * as os2 from "node:os";
-import * as path8 from "node:path";
+import * as path9 from "node:path";
 function ensurePrivateCliLogPath() {
-  fs6.mkdirSync(CLI_LOG_DIRECTORY, {
+  fs7.mkdirSync(CLI_LOG_DIRECTORY, {
     mode: CLI_LOG_DIRECTORY_MODE,
     recursive: true
   });
-  fs6.chmodSync(CLI_LOG_DIRECTORY, CLI_LOG_DIRECTORY_MODE);
-  if (!fs6.existsSync(CLI_LOG_PATH)) {
-    fs6.closeSync(fs6.openSync(CLI_LOG_PATH, "a", CLI_LOG_FILE_MODE));
+  fs7.chmodSync(CLI_LOG_DIRECTORY, CLI_LOG_DIRECTORY_MODE);
+  if (!fs7.existsSync(CLI_LOG_PATH)) {
+    fs7.closeSync(fs7.openSync(CLI_LOG_PATH, "a", CLI_LOG_FILE_MODE));
   }
-  fs6.chmodSync(CLI_LOG_PATH, CLI_LOG_FILE_MODE);
+  fs7.chmodSync(CLI_LOG_PATH, CLI_LOG_FILE_MODE);
 }
 function countNewlines(value) {
   let newlineCount = 0;
@@ -32712,11 +32757,11 @@ function maybeWriteCliVerboseLine(prefix, phase, details) {
 `);
 }
 function readCliLogTail(count) {
-  if (!fs6.existsSync(CLI_LOG_PATH)) {
+  if (!fs7.existsSync(CLI_LOG_PATH)) {
     return [];
   }
-  const fileDescriptor = fs6.openSync(CLI_LOG_PATH, "r");
-  const fileSize = fs6.fstatSync(fileDescriptor).size;
+  const fileDescriptor = fs7.openSync(CLI_LOG_PATH, "r");
+  const fileSize = fs7.fstatSync(fileDescriptor).size;
   let position = fileSize;
   let newlineCount = 0;
   const chunks = [];
@@ -32725,13 +32770,13 @@ function readCliLogTail(count) {
       const bytesToRead = Math.min(CLI_LOG_TAIL_CHUNK_BYTES, position);
       const buffer = Buffer.alloc(bytesToRead);
       position -= bytesToRead;
-      fs6.readSync(fileDescriptor, buffer, 0, bytesToRead, position);
+      fs7.readSync(fileDescriptor, buffer, 0, bytesToRead, position);
       const chunk = buffer.toString("utf8");
       chunks.unshift(chunk);
       newlineCount += countNewlines(chunk);
     }
   } finally {
-    fs6.closeSync(fileDescriptor);
+    fs7.closeSync(fileDescriptor);
   }
   const content = chunks.join("");
   const lines = content.split("\n").filter((line) => line.length > 0);
@@ -32742,11 +32787,11 @@ var init_cli_logs = __esm({
   "apps/cli/src/services/cli-logs.ts"() {
     "use strict";
     import_pino = __toESM(require_pino(), 1);
-    CLI_LOG_DIRECTORY = path8.join(
+    CLI_LOG_DIRECTORY = path9.join(
       process.env["XDG_STATE_HOME"] ?? os2.homedir(),
       process.env["XDG_STATE_HOME"] ? "copilotkit" : ".copilotkit"
     );
-    CLI_LOG_PATH = path8.join(CLI_LOG_DIRECTORY, "cli.log");
+    CLI_LOG_PATH = path9.join(CLI_LOG_DIRECTORY, "cli.log");
     CLI_LOG_DIRECTORY_MODE = 448;
     CLI_LOG_FILE_MODE = 384;
     CLI_LOG_TAIL_CHUNK_BYTES = 64 * 1024;
@@ -38887,7 +38932,7 @@ var init_wrap_ansi = __esm({
 // node_modules/.pnpm/terminal-size@4.0.1/node_modules/terminal-size/index.js
 import process10 from "node:process";
 import { execFileSync } from "node:child_process";
-import fs7 from "node:fs";
+import fs8 from "node:fs";
 import tty from "node:tty";
 function terminalSize() {
   const { env: env5, stdout, stderr } = process10;
@@ -38944,7 +38989,7 @@ var init_terminal_size = __esm({
         return true;
       }
       try {
-        const statContents = fs7.readFileSync("/proc/self/stat", "utf8");
+        const statContents = fs8.readFileSync("/proc/self/stat", "utf8");
         const closingParenthesisIndex = statContents.lastIndexOf(") ");
         if (closingParenthesisIndex === -1) {
           return false;
@@ -38965,8 +39010,8 @@ var init_terminal_size = __esm({
     };
     devTty = () => {
       try {
-        const flags = process10.platform === "darwin" ? fs7.constants.O_EVTONLY | fs7.constants.O_NONBLOCK : fs7.constants.O_NONBLOCK;
-        const { columns, rows } = tty.WriteStream(fs7.openSync("/dev/tty", flags));
+        const flags = process10.platform === "darwin" ? fs8.constants.O_EVTONLY | fs8.constants.O_NONBLOCK : fs8.constants.O_NONBLOCK;
+        const { columns, rows } = tty.WriteStream(fs8.openSync("/dev/tty", flags));
         return { columns, rows };
       } catch {
       }
@@ -87517,7 +87562,7 @@ var init_Text = __esm({
 });
 
 // node_modules/.pnpm/ink@6.8.0_@types+react@19.2.14_react-devtools-core@7.0.1_react@19.2.4/node_modules/ink/build/components/ErrorOverview.js
-import * as fs8 from "node:fs";
+import * as fs9 from "node:fs";
 import { cwd } from "node:process";
 function ErrorOverview({ error: error48 }) {
   const stack = error48.stack ? error48.stack.split("\n").slice(1) : void 0;
@@ -87525,8 +87570,8 @@ function ErrorOverview({ error: error48 }) {
   const filePath = cleanupPath(origin?.file);
   let excerpt;
   let lineWidth = 0;
-  if (filePath && origin?.line && fs8.existsSync(filePath)) {
-    const sourceCode = fs8.readFileSync(filePath, "utf8");
+  if (filePath && origin?.line && fs9.existsSync(filePath)) {
+    const sourceCode = fs9.readFileSync(filePath, "utf8");
     excerpt = dist_default4(sourceCode, origin.line);
     if (excerpt) {
       for (const { line } of excerpt) {
@@ -90568,6 +90613,27 @@ var init_installation_id = __esm({
   }
 });
 
+// apps/cli/src/services/telemetry/cli-state.ts
+function resolveCliStateProperties(deps) {
+  const hasProjectSelection = deps.hasProjectSelection;
+  return {
+    authenticated: safeRead(deps.hasStoredAuth),
+    ...hasProjectSelection === null ? {} : { has_selected_project: safeRead(hasProjectSelection) }
+  };
+}
+function safeRead(read) {
+  try {
+    return read();
+  } catch {
+    return false;
+  }
+}
+var init_cli_state = __esm({
+  "apps/cli/src/services/telemetry/cli-state.ts"() {
+    "use strict";
+  }
+});
+
 // apps/cli/src/services/telemetry/notice.ts
 var notice_exports = {};
 __export(notice_exports, {
@@ -90588,7 +90654,8 @@ function clearTelemetryNoticeMarker(store) {
 }
 function formatTelemetryNotice(privacyPolicyUrl) {
   return [
-    "The CopilotKit CLI collects anonymous usage data to help improve the product.",
+    "The CopilotKit CLI collects usage data to help improve the product.",
+    "While you are signed in, that data is linked to your CopilotKit account.",
     "",
     "  Disable anytime:  copilotkit telemetry disable (or set DO_NOT_TRACK=1)",
     `  Privacy policy:   ${privacyPolicyUrl}`,
@@ -90600,7 +90667,7 @@ var TELEMETRY_NOTICE_SHOWN_KEY;
 var init_notice = __esm({
   "apps/cli/src/services/telemetry/notice.ts"() {
     "use strict";
-    TELEMETRY_NOTICE_SHOWN_KEY = "telemetry.noticeShownAt";
+    TELEMETRY_NOTICE_SHOWN_KEY = "telemetry.noticeShownAt.v2";
   }
 });
 
@@ -90737,11 +90804,12 @@ __export(telemetry_exports, {
   __resetTelemetryForTests: () => __resetTelemetryForTests,
   __setConsentProviderForTests: () => __setConsentProviderForTests,
   cliLogTelemetryLogger: () => cliLogTelemetryLogger,
+  currentCliStateProperties: () => currentCliStateProperties,
   exitWithFlush: () => exitWithFlush,
   flushTelemetry: () => flushTelemetry,
   getCliConsentProvider: () => getCliConsentProvider,
+  getLinkableInstallationId: () => getLinkableInstallationId,
   getTelemetry: () => getTelemetry,
-  getTelemetryDistinctIdForUrlPropagation: () => getTelemetryDistinctIdForUrlPropagation,
   linkConsentSubjectToUser: () => linkConsentSubjectToUser,
   recordTelemetryEvent: () => recordTelemetryEvent,
   withTelemetry: () => withTelemetry
@@ -90802,6 +90870,15 @@ function getTelemetry() {
   });
   return instance;
 }
+function currentCliStateProperties(command) {
+  return resolveCliStateProperties({
+    hasStoredAuth: () => authStore.get() !== null,
+    // `init` creates the project directory it is about to fill, and runs from
+    // that directory's parent, so a cwd reading would describe the wrong
+    // directory. Omitted rather than reported as a misleading `false`.
+    hasProjectSelection: command === "init" ? null : () => readProjectConfig(process.cwd()) !== void 0
+  });
+}
 function recordTelemetryEvent(event) {
   const buildInfo = getBuildInfo();
   const provider = getConsentProvider();
@@ -90850,12 +90927,19 @@ async function withTelemetry(base, fn) {
       extra = { ...extra, ...next };
     }
   };
-  recordTelemetryEvent({ properties: { ...base, outcome: "started" } });
+  recordTelemetryEvent({
+    properties: {
+      ...base,
+      ...currentCliStateProperties(base.command),
+      outcome: "started"
+    }
+  });
   try {
     const result = await fn(ctx);
     recordTelemetryEvent({
       properties: {
         ...base,
+        ...currentCliStateProperties(base.command),
         ...extra,
         outcome: "succeeded",
         duration_ms: Date.now() - startedAt
@@ -90866,6 +90950,7 @@ async function withTelemetry(base, fn) {
     recordTelemetryEvent({
       properties: {
         ...base,
+        ...currentCliStateProperties(base.command),
         ...extra,
         outcome: "failed",
         duration_ms: Date.now() - startedAt,
@@ -90889,7 +90974,7 @@ function linkConsentSubjectToUser() {
     authSnapshot: () => authStore.get()
   });
 }
-function getTelemetryDistinctIdForUrlPropagation() {
+function getLinkableInstallationId() {
   const buildInfo = getBuildInfo();
   if (isTelemetrySuppressedByBuildOrPreference(buildInfo.version))
     return null;
@@ -90916,6 +91001,7 @@ var init_telemetry = __esm({
     "use strict";
     init_config();
     init_config_service();
+    init_project_config();
     init_cli_logs();
     init_dist5();
     init_c15t_consent_provider();
@@ -90924,6 +91010,7 @@ var init_telemetry = __esm({
     init_gate();
     init_event_properties();
     init_installation_id();
+    init_cli_state();
     init_notice();
     init_opt_out();
     init_telemetry_service();
@@ -90955,7 +91042,14 @@ function buildChannelsStageProperties(input) {
 function recordChannelsStage(input) {
   recordTelemetryEvent({
     event: CHANNELS_SETUP_STAGE_EVENT,
-    properties: buildChannelsStageProperties(input)
+    properties: {
+      ...buildChannelsStageProperties(input),
+      // Merged here, in the recorder, rather than inside the pure builder:
+      // the builder writes every key explicitly from its input so customer
+      // content cannot leak in by construction, and reading ambient process
+      // state inside it would break that guarantee. Both values are booleans.
+      ...currentCliStateProperties(input.command ?? "channels")
+    }
   });
 }
 function channelsStageFromEnvelope(envelope2) {
@@ -91255,23 +91349,30 @@ function createApiClient(baseUrl, token, options = {}) {
     return await fetchWithTimeout(url3, { ...init, headers: retryHeaders });
   }
   return {
-    async exchangeClerkToken(clerkToken) {
+    async exchangeClerkToken(clerkToken, telemetryInstallationId) {
       const res = await fetchWithTimeout(`${baseUrl}/api/cli/auth/session`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ clerkToken })
+        body: JSON.stringify({
+          clerkToken,
+          ...telemetryInstallationId === void 0 ? {} : { telemetryInstallationId }
+        })
       });
       if (!res.ok) {
         throw await readApiError(res);
       }
       return res.json();
     },
-    async verifySession() {
+    async verifySession(telemetryInstallationId) {
+      const query = telemetryInstallationId === void 0 ? "" : `?telemetryInstallationId=${encodeURIComponent(telemetryInstallationId)}`;
       const res = await retryTransient(async () => {
-        const r2 = await fetchWithTimeout(`${baseUrl}/api/cli/auth/verify`, {
-          method: "GET",
-          headers: { Authorization: `Bearer ${token}` }
-        });
+        const r2 = await fetchWithTimeout(
+          `${baseUrl}/api/cli/auth/verify${query}`,
+          {
+            method: "GET",
+            headers: { Authorization: `Bearer ${token}` }
+          }
+        );
         if (!r2.ok) {
           throw await readApiError(r2);
         }
@@ -91567,10 +91668,10 @@ var init_cli_auth_diagnostics = __esm({
 });
 
 // node_modules/.pnpm/is-docker@3.0.0/node_modules/is-docker/index.js
-import fs9 from "node:fs";
+import fs10 from "node:fs";
 function hasDockerEnv() {
   try {
-    fs9.statSync("/.dockerenv");
+    fs10.statSync("/.dockerenv");
     return true;
   } catch {
     return false;
@@ -91578,7 +91679,7 @@ function hasDockerEnv() {
 }
 function hasDockerCGroup() {
   try {
-    return fs9.readFileSync("/proc/self/cgroup", "utf8").includes("docker");
+    return fs10.readFileSync("/proc/self/cgroup", "utf8").includes("docker");
   } catch {
     return false;
   }
@@ -91597,7 +91698,7 @@ var init_is_docker = __esm({
 });
 
 // node_modules/.pnpm/is-inside-container@1.0.0/node_modules/is-inside-container/index.js
-import fs10 from "node:fs";
+import fs11 from "node:fs";
 function isInsideContainer() {
   if (cachedResult === void 0) {
     cachedResult = hasContainerEnv() || isDocker();
@@ -91611,7 +91712,7 @@ var init_is_inside_container = __esm({
     init_is_docker();
     hasContainerEnv = () => {
       try {
-        fs10.statSync("/run/.containerenv");
+        fs11.statSync("/run/.containerenv");
         return true;
       } catch {
         return false;
@@ -91623,7 +91724,7 @@ var init_is_inside_container = __esm({
 // node_modules/.pnpm/is-wsl@3.1.1/node_modules/is-wsl/index.js
 import process22 from "node:process";
 import os5 from "node:os";
-import fs11 from "node:fs";
+import fs12 from "node:fs";
 var isWsl, is_wsl_default;
 var init_is_wsl = __esm({
   "node_modules/.pnpm/is-wsl@3.1.1/node_modules/is-wsl/index.js"() {
@@ -91640,12 +91741,12 @@ var init_is_wsl = __esm({
         return true;
       }
       try {
-        if (fs11.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft")) {
+        if (fs12.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft")) {
           return !isInsideContainer();
         }
       } catch {
       }
-      if (fs11.existsSync("/proc/sys/fs/binfmt_misc/WSLInterop") || fs11.existsSync("/run/WSL")) {
+      if (fs12.existsSync("/proc/sys/fs/binfmt_misc/WSLInterop") || fs12.existsSync("/run/WSL")) {
         return !isInsideContainer();
       }
       return false;
@@ -91717,7 +91818,7 @@ var init_utilities3 = __esm({
 // node_modules/.pnpm/wsl-utils@0.3.1/node_modules/wsl-utils/index.js
 import { promisify as promisify3 } from "node:util";
 import childProcess2 from "node:child_process";
-import fs12, { constants as fsConstants } from "node:fs/promises";
+import fs13, { constants as fsConstants } from "node:fs/promises";
 var execFile2, wslDrivesMountPoint, powerShellPathFromWsl, powerShellPath2, canAccessPowerShellPromise, canAccessPowerShell, wslDefaultBrowser, convertWslPathToWindows;
 var init_wsl_utils = __esm({
   "node_modules/.pnpm/wsl-utils@0.3.1/node_modules/wsl-utils/index.js"() {
@@ -91737,14 +91838,14 @@ var init_wsl_utils = __esm({
         const configFilePath = "/etc/wsl.conf";
         let isConfigFileExists = false;
         try {
-          await fs12.access(configFilePath, fsConstants.F_OK);
+          await fs13.access(configFilePath, fsConstants.F_OK);
           isConfigFileExists = true;
         } catch {
         }
         if (!isConfigFileExists) {
           return defaultMountPoint;
         }
-        const configContent = await fs12.readFile(configFilePath, { encoding: "utf8" });
+        const configContent = await fs13.readFile(configFilePath, { encoding: "utf8" });
         const parsedMountPoint = parseMountPointFromConfig(configContent);
         if (parsedMountPoint === void 0) {
           return defaultMountPoint;
@@ -91763,7 +91864,7 @@ var init_wsl_utils = __esm({
       canAccessPowerShellPromise ??= (async () => {
         try {
           const psPath = await powerShellPath2();
-          await fs12.access(psPath, fsConstants.X_OK);
+          await fs13.access(psPath, fsConstants.X_OK);
           return true;
         } catch {
           return false;
@@ -91978,10 +92079,10 @@ __export(open_exports, {
   openApp: () => openApp
 });
 import process28 from "node:process";
-import path9 from "node:path";
+import path10 from "node:path";
 import { fileURLToPath } from "node:url";
 import childProcess3 from "node:child_process";
-import fs13, { constants as fsConstants2 } from "node:fs/promises";
+import fs14, { constants as fsConstants2 } from "node:fs/promises";
 function detectArchBinary(binary2) {
   if (typeof binary2 === "string" || Array.isArray(binary2)) {
     return binary2;
@@ -92012,8 +92113,8 @@ var init_open = __esm({
     init_is_inside_container();
     init_is_in_ssh();
     fallbackAttemptSymbol = Symbol("fallbackAttempt");
-    __dirname2 = import.meta.url ? path9.dirname(fileURLToPath(import.meta.url)) : "";
-    localXdgOpenPath = path9.join(__dirname2, "xdg-open");
+    __dirname2 = import.meta.url ? path10.dirname(fileURLToPath(import.meta.url)) : "";
+    localXdgOpenPath = path10.join(__dirname2, "xdg-open");
     ({ platform: platform2, arch } = process28);
     tryEachApp = async (apps2, opener) => {
       if (apps2.length === 0) {
@@ -92161,7 +92262,7 @@ var init_open = __esm({
           const isBundled = !__dirname2 || __dirname2 === "/";
           let exeLocalXdgOpen = false;
           try {
-            await fs13.access(localXdgOpenPath, fsConstants2.X_OK);
+            await fs14.access(localXdgOpenPath, fsConstants2.X_OK);
             exeLocalXdgOpen = true;
           } catch {
           }
@@ -92467,7 +92568,7 @@ async function login(options = {}) {
   let tokenSource = null;
   try {
     const callbackUrl = `http://127.0.0.1:${port}/callback`;
-    const posthogDistinctId = getTelemetryDistinctIdForUrlPropagation();
+    const posthogDistinctId = getLinkableInstallationId();
     const loginParams = new URLSearchParams({
       callback: callbackUrl,
       state,
@@ -92507,10 +92608,15 @@ async function login(options = {}) {
       tokenSource: source
     });
     const apiClient = createApiClient(getOpsApiUrl());
+    const previousUserId = authStore.get()?.userId ?? null;
+    const bindDuringExchange = previousUserId === null ? getLinkableInstallationId() ?? void 0 : void 0;
     let authPayload;
     try {
       diagnostics.logPhase("login.exchange-start");
-      authPayload = await apiClient.exchangeClerkToken(clerkToken);
+      authPayload = await apiClient.exchangeClerkToken(
+        clerkToken,
+        bindDuringExchange
+      );
       diagnostics.logPhase("login.exchange-complete", {
         organizationId: authPayload.organization.clerkOrgId,
         userId: authPayload.user.id
@@ -92522,9 +92628,16 @@ async function login(options = {}) {
         "Failed to exchange the browser session for a CLI session."
       );
       throw new Error(
-        `Browser sign-in completed, but CLI session exchange failed: ${concreteError.message}`
+        `Browser sign-in completed, but CLI session exchange failed: ${concreteError.message}`,
+        { cause: error48 }
       );
     }
+    if (previousUserId !== null && previousUserId !== authPayload.user.id) {
+      rotateInstallationId({ configStore });
+      diagnostics.logPhase("login.installation-id-rotated", {
+        reason: "different_user"
+      });
+    }
     try {
       authStore.save({
         cliToken: authPayload.cliToken,
@@ -92546,7 +92659,10 @@ async function login(options = {}) {
         error48,
         "Failed to persist CLI credentials."
       );
-      throw new Error(`CLI login succeeded, but credentials could not be saved: ${concreteError.message}`);
+      throw new Error(
+        `CLI login succeeded, but credentials could not be saved: ${concreteError.message}`,
+        { cause: error48 }
+      );
     }
     diagnostics.logPhase("login.complete", {
       email: authPayload.user.email,
@@ -92592,7 +92708,9 @@ async function verifyAndRefresh(options = {}) {
   const apiClient = createApiClient(getOpsApiUrl(), token);
   let result;
   try {
-    result = await apiClient.verifySession();
+    result = await apiClient.verifySession(
+      getLinkableInstallationId() ?? void 0
+    );
   } catch (error48) {
     if (clearAuthOnTerminalSessionInvalidation(error48)) {
       if (options.throwOnInvalid) {
@@ -93499,12 +93617,12 @@ var init_browser_login = __esm({
 });
 
 // apps/cli/src/services/project-scaffold.ts
-import * as fs14 from "node:fs";
-import * as path10 from "node:path";
+import * as fs15 from "node:fs";
+import * as path11 from "node:path";
 import * as os6 from "node:os";
 import { execFileSync as execFileSync3 } from "node:child_process";
 function isProjectDirOccupied(projectDir) {
-  return fs14.existsSync(projectDir) && fs14.readdirSync(projectDir).length > 0;
+  return fs15.existsSync(projectDir) && fs15.readdirSync(projectDir).length > 0;
 }
 function assertProjectDirAvailable(projectDir) {
   if (isProjectDirOccupied(projectDir)) {
@@ -93519,7 +93637,7 @@ async function scaffoldProject(options) {
   assertProjectDirAvailable(projectDir);
   const localTemplateDir = process.env["COPILOTKIT_TEMPLATE_DIR"];
   if (localTemplateDir !== void 0 && localTemplateDir !== "") {
-    if (!fs14.existsSync(localTemplateDir)) {
+    if (!fs15.existsSync(localTemplateDir)) {
       throw tagError(
         new Error(
           `COPILOTKIT_TEMPLATE_DIR points at a path that does not exist: ${localTemplateDir}`
@@ -93527,7 +93645,7 @@ async function scaffoldProject(options) {
         TELEMETRY_ERROR_CODES.TEMPLATE_FETCH_FAILED
       );
     }
-    fs14.mkdirSync(projectDir, { recursive: true });
+    fs15.mkdirSync(projectDir, { recursive: true });
     await copyDirectory(localTemplateDir, projectDir, true);
     return;
   }
@@ -93542,7 +93660,7 @@ async function scaffoldProject(options) {
 }
 function pathEntryExists(entryPath) {
   try {
-    fs14.lstatSync(entryPath);
+    fs15.lstatSync(entryPath);
     return true;
   } catch (error48) {
     if (error48 instanceof Error && "code" in error48 && error48.code === "ENOENT") {
@@ -93553,7 +93671,7 @@ function pathEntryExists(entryPath) {
 }
 async function cloneTemplate(source, destinationPath) {
   const { owner, repo, revision, subdirectoryPath, mode } = source;
-  const tempDir = fs14.mkdtempSync(path10.join(os6.tmpdir(), "copilotkit-clone-"));
+  const tempDir = fs15.mkdtempSync(path11.join(os6.tmpdir(), "copilotkit-clone-"));
   const isWholeRepo = mode === "whole-repository";
   const destinationExisted = pathEntryExists(destinationPath);
   try {
@@ -93573,8 +93691,8 @@ async function cloneTemplate(source, destinationPath) {
         { cwd: tempDir, stdio: "pipe" },
         TELEMETRY_ERROR_CODES.GIT_FAILED
       );
-      fs14.writeFileSync(
-        path10.join(tempDir, ".git/info/sparse-checkout"),
+      fs15.writeFileSync(
+        path11.join(tempDir, ".git/info/sparse-checkout"),
         subdirectoryPath
       );
     }
@@ -93588,8 +93706,8 @@ async function cloneTemplate(source, destinationPath) {
       { cwd: tempDir, stdio: "pipe" },
       TELEMETRY_ERROR_CODES.GIT_FAILED
     );
-    const sourcePath = isWholeRepo ? tempDir : path10.join(tempDir, subdirectoryPath);
-    if (!isWholeRepo && !fs14.existsSync(sourcePath)) {
+    const sourcePath = isWholeRepo ? tempDir : path11.join(tempDir, subdirectoryPath);
+    if (!isWholeRepo && !fs15.existsSync(sourcePath)) {
       throw tagError(
         new Error(
           `Template directory '${subdirectoryPath}' not found in the repository.`
@@ -93597,11 +93715,11 @@ async function cloneTemplate(source, destinationPath) {
         TELEMETRY_ERROR_CODES.TEMPLATE_FETCH_FAILED
       );
     }
-    fs14.mkdirSync(destinationPath, { recursive: true });
+    fs15.mkdirSync(destinationPath, { recursive: true });
     await copyDirectory(sourcePath, destinationPath, isWholeRepo);
   } catch (cause) {
     if (!destinationExisted) {
-      fs14.rmSync(destinationPath, { recursive: true, force: true });
+      fs15.rmSync(destinationPath, { recursive: true, force: true });
     }
     const error48 = cause instanceof Error ? cause : new Error("Starter template checkout failed");
     const code = error48.code;
@@ -93611,26 +93729,26 @@ async function cloneTemplate(source, destinationPath) {
     throw tagError(error48, TELEMETRY_ERROR_CODES.TEMPLATE_FETCH_FAILED);
   } finally {
     try {
-      fs14.rmSync(tempDir, { recursive: true, force: true });
+      fs15.rmSync(tempDir, { recursive: true, force: true });
     } catch {
     }
   }
 }
 async function copyDirectory(source, destination, excludeGit = false) {
-  if (!fs14.existsSync(destination)) {
-    fs14.mkdirSync(destination, { recursive: true });
+  if (!fs15.existsSync(destination)) {
+    fs15.mkdirSync(destination, { recursive: true });
   }
-  const entries = fs14.readdirSync(source, { withFileTypes: true });
+  const entries = fs15.readdirSync(source, { withFileTypes: true });
   for (const entry of entries) {
     if (excludeGit && entry.name === ".git") {
       continue;
     }
-    const srcPath = path10.join(source, entry.name);
-    const destPath = path10.join(destination, entry.name);
+    const srcPath = path11.join(source, entry.name);
+    const destPath = path11.join(destination, entry.name);
     if (entry.isDirectory()) {
       await copyDirectory(srcPath, destPath, excludeGit);
     } else {
-      fs14.copyFileSync(srcPath, destPath);
+      fs15.copyFileSync(srcPath, destPath);
     }
   }
 }
@@ -93668,37 +93786,37 @@ function parseGitHubUrl(githubUrl) {
   };
 }
 function copyEnvExample(projectDir) {
-  const envPath = path10.join(projectDir, ".env");
-  const envExamplePath = path10.join(projectDir, ".env.example");
-  if (fs14.existsSync(envExamplePath) && !fs14.existsSync(envPath)) {
-    fs14.copyFileSync(envExamplePath, envPath);
+  const envPath = path11.join(projectDir, ".env");
+  const envExamplePath = path11.join(projectDir, ".env.example");
+  if (fs15.existsSync(envExamplePath) && !fs15.existsSync(envPath)) {
+    fs15.copyFileSync(envExamplePath, envPath);
     return true;
   }
   return false;
 }
 function removeTestHarnessArtifacts(projectDir) {
-  const markerPath = path10.join(projectDir, "docker-compose.test.yml");
-  if (!fs14.existsSync(markerPath)) {
+  const markerPath = path11.join(projectDir, "docker-compose.test.yml");
+  if (!fs15.existsSync(markerPath)) {
     return [];
   }
   const removed = [];
   for (const artifact of TEST_HARNESS_ARTIFACTS) {
-    const target = path10.join(projectDir, artifact);
-    if (fs14.existsSync(target)) {
-      fs14.rmSync(target, { recursive: true, force: true });
+    const target = path11.join(projectDir, artifact);
+    if (fs15.existsSync(target)) {
+      fs15.rmSync(target, { recursive: true, force: true });
       removed.push(artifact);
     }
   }
   return removed;
 }
 function writeEnvLicenseKey(projectDir, licenseKey) {
-  const envPath = path10.join(projectDir, ".env");
-  const envExamplePath = path10.join(projectDir, ".env.example");
-  if (fs14.existsSync(envExamplePath) && !fs14.existsSync(envPath)) {
-    fs14.copyFileSync(envExamplePath, envPath);
+  const envPath = path11.join(projectDir, ".env");
+  const envExamplePath = path11.join(projectDir, ".env.example");
+  if (fs15.existsSync(envExamplePath) && !fs15.existsSync(envPath)) {
+    fs15.copyFileSync(envExamplePath, envPath);
   }
-  if (fs14.existsSync(envPath)) {
-    let content = fs14.readFileSync(envPath, "utf8");
+  if (fs15.existsSync(envPath)) {
+    let content = fs15.readFileSync(envPath, "utf8");
     const licenseLine = `COPILOTKIT_LICENSE_TOKEN=${licenseKey}`;
     if (LICENSE_TOKEN_LINE_RE.test(content)) {
       content = content.replace(LICENSE_TOKEN_LINE_RE, () => licenseLine);
@@ -93707,9 +93825,9 @@ function writeEnvLicenseKey(projectDir, licenseKey) {
       content = `${content}${separator}${licenseLine}
 `;
     }
-    fs14.writeFileSync(envPath, content);
+    fs15.writeFileSync(envPath, content);
   } else {
-    fs14.writeFileSync(envPath, `COPILOTKIT_LICENSE_TOKEN=${licenseKey}
+    fs15.writeFileSync(envPath, `COPILOTKIT_LICENSE_TOKEN=${licenseKey}
 `);
   }
 }
@@ -93759,7 +93877,7 @@ __export(license_delivery_exports, {
   promptYesNo: () => promptYesNo,
   resolveLicenseEnvWriteMode: () => resolveLicenseEnvWriteMode
 });
-import * as path11 from "node:path";
+import * as path12 from "node:path";
 import { createInterface } from "node:readline/promises";
 function resolveLicenseEnvWriteMode(flags, interactive) {
   if (flags.write) {
@@ -93779,7 +93897,7 @@ function applyLicenseDelivery(mode, licenseKey, deps) {
   };
   const write = () => {
     const dir = deps.cwd();
-    const envPath = path11.join(dir, ".env");
+    const envPath = path12.join(dir, ".env");
     try {
       deps.writeEnvLicenseKey(dir, licenseKey);
     } catch (error48) {
@@ -94205,46 +94323,6 @@ var init_framework_list = __esm({
   }
 });
 
-// apps/cli/src/services/project-config.ts
-import * as fs15 from "node:fs";
-import * as path12 from "node:path";
-function projectConfigPath(dir) {
-  return path12.join(dir, ".copilotkit", "project.json");
-}
-function readProjectConfig(dir) {
-  const configPath = projectConfigPath(dir);
-  if (!fs15.existsSync(configPath)) {
-    return void 0;
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(fs15.readFileSync(configPath, "utf8"));
-  } catch {
-    return void 0;
-  }
-  const validated = projectConfigSchema.safeParse(parsed);
-  return validated.success ? validated.data : void 0;
-}
-function writeProjectConfig(dir, config2) {
-  const validated = projectConfigSchema.parse(config2);
-  const configPath = projectConfigPath(dir);
-  fs15.mkdirSync(path12.dirname(configPath), { recursive: true });
-  fs15.writeFileSync(configPath, `${JSON.stringify(validated, null, 2)}
-`);
-}
-var projectConfigSchema;
-var init_project_config = __esm({
-  "apps/cli/src/services/project-config.ts"() {
-    "use strict";
-    init_zod();
-    projectConfigSchema = external_exports.object({
-      projectId: external_exports.string().min(1),
-      projectSlug: external_exports.string().min(1),
-      clerkOrgId: external_exports.string().min(1)
-    }).strict();
-  }
-});
-
 // apps/cli/src/services/intelligence-activation.ts
 import * as fs16 from "node:fs";
 import * as path13 from "node:path";
@@ -359049,7 +359127,7 @@ async function scaffoldInitProject(options, dependencies = defaultInitScaffoldDe
       );
     }
     if (!templateDefinition.provisionLicense) {
-      telemetry?.onScaffoldSucceeded({ framework });
+      telemetry?.onScaffoldSucceeded({ framework, scaffoldChannel: "none" });
       return {
         projectDir,
         envCreatedFromExample,
@@ -359145,7 +359223,16 @@ async function scaffoldInitProject(options, dependencies = defaultInitScaffoldDe
         });
       }
     }
-    telemetry?.onScaffoldSucceeded({ framework, telemetryId });
+    telemetry?.onScaffoldSucceeded({
+      framework,
+      telemetryId,
+      // `channel` is the outcome of the offer that ran above: undefined when
+      // it was declined, skipped, or never reached. Reporting the provider the
+      // run actually produced is what the parse-time `channel_flag` cannot do,
+      // since an interactively-chosen Channel leaves that flag `unset`.
+      scaffoldChannel: channel2 === void 0 ? "none" : channel2.adapter,
+      ...channel2 === void 0 ? {} : { scaffoldChannelAttached: channel2.attached }
+    });
     return {
       projectDir,
       envCreatedFromExample,
@@ -361032,6 +361119,10 @@ Usage: copilotkit channels providers [--json]
     adapterFlag === void 0 ? void 0 : String(adapterFlag)
   ) ? String(adapterFlag) : "slack";
   const driver = asJson ? "agent" : "interactive";
+  try {
+    await verifyAndRefresh();
+  } catch {
+  }
   recordChannelsStage({
     driver,
     provider: adapter2,
@@ -361263,6 +361354,7 @@ var init_channels2 = __esm({
     init_api_client();
     init_clipboard();
     init_config_service();
+    await init_auth_service();
     init_channel_artifacts();
     init_channel_credential_cleanup();
     init_channel_code_half();
@@ -361704,6 +361796,13 @@ function buildScaffoldSucceededEvent(input) {
     properties: {
       command: "init",
       framework: input.framework,
+      // Unconditional, `none` included: an absent value must mean "older CLI",
+      // never "this scaffold had no Channel".
+      scaffold_channel: input.scaffoldChannel,
+      // Only meaningful alongside a Channel. Emitted whenever one was produced,
+      // including `false`, so a declared-but-unattached Channel is countable
+      // rather than indistinguishable from a finished one.
+      ...input.scaffoldChannel === "none" || input.scaffoldChannelAttached === void 0 ? {} : { channel_attached: input.scaffoldChannelAttached },
       ...input.telemetryId ? { telemetry_id: input.telemetryId } : {}
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "copilotkit",
-  "version": "4.8.1",
+  "version": "4.8.2",
   "type": "module",
   "repository": {
     "type": "git",

package/release/release-tool.js

@@ -14683,7 +14683,7 @@ import * as path4 from "node:path";
 
 // apps/cli/src/config.ts
 function getTemplateRef() {
-  return true ? "7e502dd4a452feee7d26c6355fd262948f8c25e6" : "main";
+  return true ? "53cf7e6575e8eae2a0dcaf64a7c3c2baf3e6dd04" : "main";
 }
 
 // apps/cli/src/services/agentcore-config.ts