copilotkit 4.10.1 → 4.11.0

package/README.md

@@ -229,10 +229,13 @@ npx --yes copilotkit@latest onboard start \
 | `add-chat-suggestions`   | Configure and send visible chat suggestions                 |
 | `add-voice`              | Add documented voice transcription to the existing composer |
 | `add-realtime-sync`      | Prove managed thread changes sync between active clients    |
-| `add-channels`           | Connect Slack or Teams and prove a real mention             |
 
-Run `copilotkit channels setup` to copy `onboard start --intent add-channels` with a run id.
-`add-channels` does not need a CopilotKit web app. The graph asks Slack or Teams.
+Run `copilotkit channels setup` to copy the same small `onboard start --run <id>`
+prompt as the website CTA. There is no `--intent add-channels`. The copied
+prompt has no Channel sentence. When the project has no frontend, the root graph
+asks which frontend they want and offers Slack and Microsoft Teams there. If the
+copied prompt came from a Slack or Teams docs page, that page is the named
+frontend.
 Its first prompt records the coding agent with `onboard identify`, including when
 the entry command omitted `--coding-agent`. Channel setup stage events include
 the existing `onboarding_run_id` when the command runs inside an onboarding run;
@@ -370,8 +373,8 @@ copilotkit channels setup
 copilotkit channels setup --no-clipboard
 ```
 
-The command copies `onboard start --intent add-channels` with a run id.
-It installs the `channels-setup` skill, then prints a one-line prompt to paste
+The command copies the small `onboard start --run <id>` prompt.
+It installs the `channels-setup` skill, then prints that prompt to paste
 into your coding agent and copies it to your clipboard. The prompt is always
 printed, so you can read it before handing it over. Pass `--no-clipboard` in a
 headless or remote shell.

package/cli-build-info.json

@@ -2,20 +2,20 @@
   "schemaVersion": 1,
   "package": {
     "name": "copilotkit",
-    "version": "4.10.1"
+    "version": "4.11.0"
   },
   "intelligence": {
-    "commit": "b5b41dba88259cb723cfd2560be82b234417efa7"
+    "commit": "362d341410722307c1067c71ac14710245300cff"
   },
   "copilotKit": {
-    "submittedInput": "7e6964f",
-    "commit": "7e6964fc11092b685bbea62bc331d5d177b738c1"
+    "submittedInput": "dc1238c0bd473e259c992b85026cb30fe6b3b726",
+    "commit": "dc1238c0bd473e259c992b85026cb30fe6b3b726"
   },
   "channel": "production",
-  "triggeringActor": "AlemTuzlak",
+  "triggeringActor": "tylerslaton",
   "workflow": {
-    "runId": "35080956003",
-    "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/35080956003"
+    "runId": "35162202498",
+    "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/35162202498"
   },
   "validationResult": "passed",
   "ag2": {
@@ -24,5 +24,5 @@
     "revision": "main",
     "pinned": false
   },
-  "builtAt": "2026-09-16T09:44:44Z"
+  "builtAt": "2026-09-16T23:26:51Z"
 }

package/index.js

@@ -96,14 +96,14 @@ function getTelemetryEndpointUrl() {
 }
 function getBuildInfo() {
   return {
-    version: true ? "4.10.1" : "dev",
-    buildNumber: true ? "35080956003" : "dev",
-    commitSha: true ? "b5b41dba88259cb723cfd2560be82b234417efa7" : "dev",
+    version: true ? "4.11.0" : "dev",
+    buildNumber: true ? "35162202498" : "dev",
+    commitSha: true ? "362d341410722307c1067c71ac14710245300cff" : "dev",
     copilotKitCommit: getTemplateRef()
   };
 }
 function getTemplateRef() {
-  return true ? "7e6964fc11092b685bbea62bc331d5d177b738c1" : "main";
+  return true ? "dc1238c0bd473e259c992b85026cb30fe6b3b726" : "main";
 }
 function getC15tBackendUrl() {
   return true ? "https://calm-hazelnut-joy-copilotkit.inth.app" : "";
@@ -28668,18 +28668,22 @@ var init_repository_root = __esm({
 import * as fs7 from "node:fs";
 import * as os2 from "node:os";
 import * as path9 from "node:path";
-function prepareProjectConfig(selection, previous, generateBindingId) {
+function prepareProjectConfig(selection, previous, generateBindingId, statedRuntimeUrl) {
   const telemetryBindingId = previous?.projectId === selection.projectId && previous.clerkOrgId === selection.clerkOrgId && previous.telemetryBindingId !== void 0 ? previous.telemetryBindingId : generateBindingId();
   return projectConfigSchema.extend({ telemetryBindingId: external_exports.string().trim().min(1) }).parse({
     ...selection,
     telemetryBindingId,
-    // Carried through unconditionally, including across a change of project.
-    // Nothing in the CLI writes it, so its only possible author is a person,
-    // and it describes where this directory's app serves rather than which
+    // A stated URL wins. Otherwise the recorded one is carried through
+    // unconditionally, including across a change of project, because it
+    // describes where this directory's app serves rather than which
     // Intelligence project the app reports to (OSS-1090).
-    ...previous?.runtimeUrl === void 0 ? {} : { runtimeUrl: previous.runtimeUrl }
+    ...runtimeUrlFields(statedRuntimeUrl, previous?.runtimeUrl)
   });
 }
+function runtimeUrlFields(stated, recorded) {
+  const chosen = stated?.trim() === "" ? void 0 : stated ?? recorded;
+  return chosen === void 0 ? {} : { runtimeUrl: chosen };
+}
 function projectConfigPath(dir) {
   return path9.join(dir, ".copilotkit", "project.json");
 }
@@ -28776,15 +28780,19 @@ var init_project_config = __esm({
       telemetryBindingId: external_exports.string().trim().min(1).optional(),
       /**
        * Absolute URL of this project's CopilotKit runtime, when the project pins
-       * one by hand.
+       * one.
+       *
+       * Stated, never guessed. `copilotkit verify` works out the port from the
+       * app's own dev configuration, and this is where a project whose runtime is
+       * somewhere that cannot be worked out — a different mount path, a
+       * container, a port that only ever appears on a command line — says so once
+       * instead of passing `--runtime-url` on every invocation (OSS-1090).
        *
-       * Written by a person, not by the CLI. `copilotkit verify` works out the
-       * port from the app's own dev configuration, and this is where a project
-       * whose runtime is somewhere that cannot be worked out — a different mount
-       * path, a container, a port that only ever appears on a command line —
-       * states it once instead of passing `--runtime-url` on every invocation
-       * (OSS-1090). The schema is strict, so it has to be declared here for such
-       * a file to parse at all.
+       * A person writes it, and so does `project select --runtime-url`. An
+       * onboarding run settles a free port and then has nowhere to put it, so
+       * `verify` falls back to its assumed default and reports on whatever holds
+       * that port — in one run, an unrelated checkout (PE-58). The flag is still
+       * a statement rather than a guess: the caller has to name the URL.
        */
       runtimeUrl: external_exports.string().trim().min(1).optional()
     }).strict();
@@ -96145,6 +96153,13 @@ function validateProjectName(raw2, existing) {
       message: `Intelligence project name must be ${MAX_PROJECT_NAME_LENGTH} characters or fewer.`
     };
   }
+  if (name.length < MIN_PROJECT_NAME_LENGTH || GENERIC_PROJECT_NAMES.has(name.toLowerCase()) || THROWAWAY_PROJECT_NAME.test(name.toLowerCase())) {
+    return {
+      ok: false,
+      reason: "generic",
+      message: `"${name}" names a directory rather than a project. Give a name that says what this project does, so it can be told apart in the dashboard later.`
+    };
+  }
   const duplicate = existing.find(
     (project) => project.name.toLowerCase() === name.toLowerCase()
   );
@@ -96159,11 +96174,33 @@ function validateProjectName(raw2, existing) {
   }
   return { ok: true, name };
 }
-var MAX_PROJECT_NAME_LENGTH, NUMERIC_SUFFIX, SUGGESTION_ATTEMPTS;
+var MAX_PROJECT_NAME_LENGTH, MIN_PROJECT_NAME_LENGTH, GENERIC_PROJECT_NAMES, THROWAWAY_PROJECT_NAME, NUMERIC_SUFFIX, SUGGESTION_ATTEMPTS;
 var init_hosted_project_name = __esm({
   "apps/cli/src/services/hosted-project-name.ts"() {
     "use strict";
     MAX_PROJECT_NAME_LENGTH = 100;
+    MIN_PROJECT_NAME_LENGTH = 3;
+    GENERIC_PROJECT_NAMES = /* @__PURE__ */ new Set([
+      "api",
+      "app",
+      "apps",
+      "backend",
+      "client",
+      "frontend",
+      "lib",
+      "libs",
+      "package",
+      "packages",
+      "project",
+      "repo",
+      "server",
+      "service",
+      "site",
+      "src",
+      "web",
+      "website"
+    ]);
+    THROWAWAY_PROJECT_NAME = /^(?:bar|baz|demo|example|foo|hello|placeholder|qux|run|sample|scratch|temp|test|tmp|trial|try)(?:[-_]?(?:\d+|[a-z]))?$/u;
     NUMERIC_SUFFIX = /-\d+$/;
     SUGGESTION_ATTEMPTS = 1e3;
   }
@@ -96192,6 +96229,13 @@ function defer() {
   });
   return { promise: promise3, resolve: resolve9 };
 }
+function hostedProjectPickerWindowStart(selectedIndex, itemCount) {
+  const lastStart = Math.max(0, itemCount - MAX_HOSTED_PROJECT_PICKER_VISIBLE);
+  return Math.min(
+    Math.max(0, selectedIndex - MAX_HOSTED_PROJECT_PICKER_VISIBLE + 1),
+    lastStart
+  );
+}
 function ProjectExplainer({ dim = false }) {
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { dimColor: dim, children: "An Intelligence project is where this app's threads, messages, and analytics are stored." });
 }
@@ -96386,12 +96430,21 @@ function HostedProjectSelect({
       })),
       { label: "Create a new project", value: "__create__" }
     ];
+    const windowStart = hostedProjectPickerWindowStart(
+      pickerIndex,
+      items.length
+    );
+    const visibleItems = items.slice(
+      windowStart,
+      windowStart + MAX_HOSTED_PROJECT_PICKER_VISIBLE
+    );
     return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Box_default, { flexDirection: "column", children: [
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: "Connect this app to one of your existing projects, or create a new one." }),
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ProjectExplainer, { dim: true }),
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: " " }),
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: "Select a project (\u2191/\u2193 to move, Enter to choose, Esc to cancel):" }),
-      items.map((item, index2) => {
+      visibleItems.map((item, visibleIndex) => {
+        const index2 = windowStart + visibleIndex;
         const selected = index2 === pickerIndex;
         return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
           Text,
@@ -96442,7 +96495,7 @@ function HostedProjectSelect({
   }
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Text, { children: view.message });
 }
-var import_react37, import_jsx_runtime7;
+var import_react37, import_jsx_runtime7, MAX_HOSTED_PROJECT_PICKER_VISIBLE;
 var init_hosted_project_select = __esm({
   async "apps/cli/src/ui/hosted-project-select.tsx"() {
     "use strict";
@@ -96452,6 +96505,7 @@ var init_hosted_project_select = __esm({
     init_hosted_project_name();
     init_theme();
     import_jsx_runtime7 = __toESM(require_jsx_runtime(), 1);
+    MAX_HOSTED_PROJECT_PICKER_VISIBLE = 6;
   }
 });
 
@@ -96813,7 +96867,7 @@ var init_telemetry_identity_events = __esm({
 // apps/cli/src/commands/project-select-effects.ts
 import { randomUUID as randomUUID3 } from "node:crypto";
 import * as path18 from "node:path";
-function persistSelection(dir, selection) {
+function persistSelection(dir, selection, statedRuntimeUrl) {
   try {
     const previous = readProjectConfig(dir) ?? null;
     const config3 = prepareProjectConfig(
@@ -96823,7 +96877,8 @@ function persistSelection(dir, selection) {
         clerkOrgId: selection.organizationId
       },
       previous,
-      randomUUID3
+      randomUUID3,
+      statedRuntimeUrl
     );
     writeProjectConfig(dir, config3);
     return {
@@ -97014,9 +97069,9 @@ function toRequest(options) {
   }
   return null;
 }
-async function completeSelection(apiClient, selection) {
+async function completeSelection(apiClient, selection, statedRuntimeUrl) {
   const recordDir = resolveProjectConfigWriteDir(process.cwd());
-  const persisted = persistSelection(recordDir, selection);
+  const persisted = persistSelection(recordDir, selection, statedRuntimeUrl);
   if (persisted.bindingId === null) {
     return withoutSelection(persisted.outcome);
   }
@@ -97067,7 +97122,7 @@ The recorded selection is kept, so finish it with \`${projectSelectRetryCommand(
     configPath
   };
 }
-async function driveFlagSelect(apiClient, request) {
+async function driveFlagSelect(apiClient, request, statedRuntimeUrl) {
   const { prompts, refusal } = createFlagPrompts(request);
   let result;
   try {
@@ -97097,7 +97152,7 @@ async function driveFlagSelect(apiClient, request) {
       ...recorded.suggestedName === void 0 ? {} : { suggestedName: recorded.suggestedName }
     });
   }
-  return await completeSelection(apiClient, result);
+  return await completeSelection(apiClient, result, statedRuntimeUrl);
 }
 async function drivePicker(apiClient, options) {
   let outcome = { kind: "canceled" };
@@ -97136,7 +97191,7 @@ async function drivePicker(apiClient, options) {
   if (selection === null) {
     return withoutSelection(outcome);
   }
-  return await completeSelection(apiClient, selection);
+  return await completeSelection(apiClient, selection, options.runtimeUrl);
 }
 async function driveProjectSelect(options, render2 = { renderToStderr: false }) {
   const auth2 = authStore.get();
@@ -97155,7 +97210,10 @@ async function driveProjectSelect(options, render2 = { renderToStderr: false })
     productOrganizationId: auth2.clerkOrgId
   });
   const request = toRequest(options);
-  return request === null ? await drivePicker(apiClient, render2) : await driveFlagSelect(apiClient, request);
+  return request === null ? await drivePicker(apiClient, {
+    ...render2,
+    ...options.runtimeUrl === void 0 ? {} : { runtimeUrl: options.runtimeUrl }
+  }) : await driveFlagSelect(apiClient, request, options.runtimeUrl);
 }
 async function runProjectSelect(options = {}) {
   const { outcome } = await driveProjectSelect(options);
@@ -97863,7 +97921,9 @@ function buildSkillsOnboardPrompt() {
 }
 function buildChannelsSetupPrompt() {
   const runId = randomBytes2(9).toString("base64url");
-  return `npx --yes copilotkit@latest onboard start --intent add-channels --run=${runId}`;
+  return `Help me get started with CopilotKit. Run this command and follow the instructions:
+
+npx --yes copilotkit@latest onboard start --run=${runId}`;
 }
 var SKILLS_ONBOARD_AGENT_PROMPT, CHANNELS_SETUP_SKILL;
 var init_agent_prompt = __esm({
@@ -387601,6 +387661,9 @@ ${detail}${NOTHING_PROVED}`;
     ""
   ].join("\n");
 }
+function leavesSurfaceUnproven(check4) {
+  return check4.outcome !== "performed" && check4.outcome !== DECLINED_SURFACE_CHECK;
+}
 function parseFrontendUrl(rest) {
   const flagIndex = rest.indexOf("--frontend-url");
   if (flagIndex === -1)
@@ -387927,6 +387990,18 @@ function blockedWithoutSurfaceProof(check4) {
     ""
   ].join("\n");
 }
+function declinedSurfaceNote(check4) {
+  const surface = check4.kind === "visual" ? "browser" : "device";
+  return [
+    "CopilotKit onboarding marked complete.",
+    "",
+    `  This run cloned a starter, so it drove no ${surface} of its own.`,
+    "  That code is what the starter smoke jobs drive on every change, and",
+    "  `copilotkit verify --round-trip` proved the agent round trip here.",
+    `  To see it yourself, open the app and drive it once by hand.`,
+    ""
+  ].join("\n");
+}
 function blockedAfterProof(blocker) {
   const report = BLOCKER_REPORTS[blocker];
   return [
@@ -387950,13 +388025,15 @@ function blockedAfterProof(blocker) {
   ].join("\n");
 }
 function completionReport(input) {
-  if (input.check.outcome !== "performed") {
+  if (leavesSurfaceUnproven(input.check)) {
     const surface = blockedWithoutSurfaceProof(input.check);
     if (input.blocker === void 0)
       return surface;
     return `${surface}${blockedAfterProof(input.blocker)}`;
   }
-  return input.blocker === void 0 ? "CopilotKit onboarding marked complete.\n" : blockedAfterProof(input.blocker);
+  if (input.blocker !== void 0)
+    return blockedAfterProof(input.blocker);
+  return input.check.outcome === DECLINED_SURFACE_CHECK ? declinedSurfaceNote(input.check) : "CopilotKit onboarding marked complete.\n";
 }
 function describeSubmission(subject, submission) {
   switch (submission.status) {
@@ -388273,7 +388350,7 @@ function recordBestEffort(dependencies, event) {
   } catch {
   }
 }
-var ONBOARD_SUBCOMMANDS, READ_RUN_NOT_BOUND, IDENTIFY_RUN_NOT_BOUND, STEP_RUN_NOT_BOUND, REBASELINE_USAGE, ACCEPT_USAGE, AUTHORIZE_USAGE, ACCEPT_CREDENTIAL_USAGE, PRIOR_CHANGE_USAGE, UNPLANNED_USAGE, EXCLUSIVE_MODE_USAGE, NOTHING_PROVED, NOTHING_AUTHORIZED, NOTHING_ACCEPTED, VISUAL_CHECK_OUTCOMES, DEVICE_CHECK_OUTCOMES, BLOCKER_CAUSES, BLOCKER_USAGE, SURFACE_CHECK_USAGE, FRONTEND_URL_USAGE, PROOF_STEPS, PROOF_OUTCOMES, BASELINE_PREDICATE_COUNT, PROOF_USAGE, IDENTIFY_USAGE, BLOCKER_REPORTS;
+var ONBOARD_SUBCOMMANDS, READ_RUN_NOT_BOUND, IDENTIFY_RUN_NOT_BOUND, STEP_RUN_NOT_BOUND, REBASELINE_USAGE, ACCEPT_USAGE, AUTHORIZE_USAGE, ACCEPT_CREDENTIAL_USAGE, PRIOR_CHANGE_USAGE, UNPLANNED_USAGE, EXCLUSIVE_MODE_USAGE, NOTHING_PROVED, NOTHING_AUTHORIZED, NOTHING_ACCEPTED, DECLINED_SURFACE_CHECK, VISUAL_CHECK_OUTCOMES, DEVICE_CHECK_OUTCOMES, BLOCKER_CAUSES, BLOCKER_USAGE, SURFACE_CHECK_USAGE, FRONTEND_URL_USAGE, PROOF_STEPS, PROOF_OUTCOMES, BASELINE_PREDICATE_COUNT, PROOF_USAGE, IDENTIFY_USAGE, BLOCKER_REPORTS;
 var init_onboard = __esm({
   async "apps/cli/src/commands/onboard.ts"() {
     "use strict";
@@ -388323,14 +388400,17 @@ var init_onboard = __esm({
     NOTHING_PROVED = "This is a missing baseline, not a preservation failure: no protected path has\nbeen proved changed, and none has been proved unchanged either.\n";
     NOTHING_AUTHORIZED = "Nothing was recorded. No path in this call was authorized, including any path\nnamed before the one above.\n";
     NOTHING_ACCEPTED = "Nothing was recorded. No path in this call was accepted, including any path\nnamed before the one above.\n";
+    DECLINED_SURFACE_CHECK = "skipped-cloned-starter";
     VISUAL_CHECK_OUTCOMES = [
       "performed",
       "skipped-no-browser-tool",
+      DECLINED_SURFACE_CHECK,
       "failed"
     ];
     DEVICE_CHECK_OUTCOMES = [
       "performed",
       "skipped-no-device",
+      DECLINED_SURFACE_CHECK,
       "failed"
     ];
     BLOCKER_CAUSES = [
@@ -388344,7 +388424,7 @@ surface this run proved and what blocked it afterwards are separate facts.
 Use \`other\` rather than leaving the flag off. A run with no way to say it was
 blocked reads the unsupported terminal instead, and reports a path that works
 as one this release does not carry.`;
-    SURFACE_CHECK_USAGE = "Usage: copilotkit onboard complete --visual-check <performed|skipped-no-browser-tool|failed>\n   or: copilotkit onboard complete --device-check <performed|skipped-no-device|failed>\nPass exactly one. A web journey is proven in a browser and a mobile one on a device;\nwhich flag you pass is how this run states which surface it proved.";
+    SURFACE_CHECK_USAGE = "Usage: copilotkit onboard complete --visual-check <performed|skipped-no-browser-tool|skipped-cloned-starter|failed>\n   or: copilotkit onboard complete --device-check <performed|skipped-no-device|skipped-cloned-starter|failed>\n`skipped-cloned-starter` is for a run that cloned a starter and was told to open no\nbrowser. It does not block. Every other skip says the surface is unproven and does.\nPass exactly one. A web journey is proven in a browser and a mobile one on a device;\nwhich flag you pass is how this run states which surface it proved.";
     FRONTEND_URL_USAGE = "Usage: copilotkit onboard complete <surface-check> --frontend-url <absolute url>\nPass the URL a browser actually opened, for example http://localhost:3000.\nOnly the kind of host is recorded -- loopback hostname, loopback IP literal,\nother IP literal, other name -- never the host itself.";
     PROOF_STEPS = ONBOARDING_PROOF_STEPS;
     PROOF_OUTCOMES = ONBOARDING_PROOF_OUTCOMES;
@@ -392022,6 +392102,7 @@ name the answer up front, so they run in a non-interactive shell.
 Options:
       --project <ref>    Select an existing project by slug or id, no prompt
       --create <name>    Create a project with this name and select it
+      --runtime-url <url>  Record where this project's runtime serves
       --json             Emit a machine-readable result on stdout
   -h, --help             Show help for project select
 
@@ -392030,6 +392111,11 @@ organization's real projects, so a typo fails with the available slugs rather
 than recording a selection that points at nothing. Run
 \`copilotkit project list --json\` first to see them.
 
+--runtime-url records "runtimeUrl" in the project record, so \`copilotkit verify\`
+probes the URL this project states instead of assuming port 3000. Pass it when
+the app serves somewhere that cannot be worked out from its dev configuration: a
+non-default port, a different mount path, or a container.
+
 --json reports selected_project_slug, project_file_written,
 api_key_provisioned, and environment_file_written. The payload never contains
 the API key.
@@ -392885,6 +392971,7 @@ ${formatStaleBuildNote()}
     options: {
       project: { type: "string" },
       create: { type: "string" },
+      "runtime-url": { type: "string" },
       json: { type: "boolean" }
     },
     strict: true,
@@ -392892,7 +392979,24 @@ ${formatStaleBuildNote()}
   });
   const project = parsed.values["project"];
   const create3 = parsed.values["create"];
+  const runtimeUrl = parsed.values["runtime-url"];
   const json4 = parsed.values["json"] === true;
+  if (runtimeUrl !== void 0 && !URL.canParse(runtimeUrl)) {
+    recordTelemetryEvent({
+      properties: {
+        command: "project",
+        subcommand: "select",
+        outcome: "failed",
+        error_code: "validation"
+      }
+    });
+    process.stderr.write(
+      `Error: --runtime-url must be an absolute URL (received "${runtimeUrl}").
+`
+    );
+    await exitWithFlush(1);
+    return;
+  }
   if (project !== void 0 && create3 !== void 0) {
     recordTelemetryEvent({
       properties: {
@@ -392929,7 +393033,8 @@ ${formatStaleBuildNote()}
   }
   const options = {
     ...project === void 0 ? {} : { project },
-    ...create3 === void 0 ? {} : { create: create3 }
+    ...create3 === void 0 ? {} : { create: create3 },
+    ...runtimeUrl === void 0 ? {} : { runtimeUrl }
   };
   await withTelemetry(
     { command: "project", subcommand: "select" },

package/onboarding/index.json

@@ -1,8 +1,7 @@
 {
-  "graphTree": "6b3586ba65cfeed7befa35d0c8794713198ac438",
+  "graphTree": "31372aea9d38d802779516dc556c136faf611b32",
   "intentRoots": {
     "add-a2ui": "feature/a2ui/start",
-    "add-channels": "feature/channels/start",
     "add-chat-suggestions": "feature/chat-suggestions/start",
     "add-learning": "feature/learning/start",
     "add-open-generative-ui": "feature/open-generative-ui/start",
@@ -462,6 +461,7 @@
         "frontend/angular",
         "frontend/vue",
         "frontend/react-native",
+        "feature/channels/start",
         "unsupported/no-validated-path"
       ],
       "milestone": "frontend",

package/onboarding/prompts/authenticate/start.md

@@ -5,7 +5,7 @@
 Run this before anything else in this prompt, including the welcome message below:
 
 ```text
-npx --yes copilotkit@4.10.1 onboard identify --coding-agent <coding-agent-slug>
+npx --yes copilotkit@4.11.0 onboard identify --coding-agent <coding-agent-slug>
 ```
 
 Report your own product with one short slug, such as `codex` or `claude-code`.
@@ -37,7 +37,7 @@ Every later command must run from the directory this run started in. A command r
 somewhere else, such as a sibling of that directory, is refused rather than answered,
 because the run it belongs to cannot be found from there. That refusal is a step to take,
 not a stop to report: run
-`npx --yes copilotkit@4.10.1 onboard start --run <onboarding_run_id>` in the directory
+`npx --yes copilotkit@4.11.0 onboard start --run <onboarding_run_id>` in the directory
 you are now in, which binds it to the same run, then run the refused command again. Do not
 start a run without that id. A run started without it is a second run, and the work already
 done stops counting toward the first.
@@ -48,12 +48,18 @@ question from the documentation this graph gives you. Another checkout on this m
 not a source. The developer running this has none, so an answer taken from one is an
 answer they cannot get, and it hides the documentation gap that blocks them.
 
+Say `CopilotKit Intelligence` in full the first time you name the platform, and never the
+bare word `Intelligence`: it names nothing a developer has met yet. In a question, leave
+the product name out and say what they get. This governs what you say, not the flags you
+pass.
+
 Send this exact message once, as your first message in this onboarding run, before
 anything else:
 
 Welcome to CopilotKit. By the end of this run your own application talks to an AI agent,
 and its chat history stays. A user can close the tab, come back, and reopen any past
-conversation in full. The managed Intelligence platform is what keeps them. I prove that
+conversation in full. The managed CopilotKit Intelligence platform is what keeps them. I
+prove that
 round trip in the running app before I call it done. You finish with working software and
 the evidence that it works.
 
@@ -74,15 +80,27 @@ first send, and a developer who reads it repeatedly learns to skim the region it
 Do not ask for separate feedback consent. The feedback commands enforce the developer's
 CLI telemetry setting when a later step tries to send a report.
 
+## Where commands run
+
+Run every command from the directory this run started in. That directory is the run root,
+and every `--path` argument is read against it rather than against wherever you are
+standing, so one path names one file from anywhere in the project.
+
+One command is deliberately different. `project select` writes the credential into the
+`.env` beside the directory it runs in, because that is the file the application process
+loads. Run it from the directory whose application reads that file. It hoists the project
+record to the repository root by itself and prints where it put it.
+
 ## Report a stop, wherever it happens
 
 This run reports its own stops. If you stop this run at any point, send one short report
 before you stop. That covers a stop this prompt names, a stop a later prompt names, and a
-stop no prompt anticipated, including one your own harness causes. Run the friction command without another developer question. The CLI telemetry gate decides whether the report is
-sent.
+stop no prompt anticipated, including one your own harness causes. Run the friction
+command without another developer question. Do not ask the developer about telemetry: the
+command applies the setting they already have.
 
 ```text
-npx --yes copilotkit@4.10.1 onboard friction --phase stop --category <slug>
+npx --yes copilotkit@4.11.0 onboard friction --phase stop --category <slug>
 ```
 
 Write one or two sentences to standard input: the step you stopped at and what stopped it.
@@ -97,13 +115,9 @@ Reporting a stop is not a route change. It does not resume the run, it is not a
 for the developer, and it does not replace whatever the rule that stopped you says to do
 next: send the report, then stop.
 
-Until now the route out of an unsupported path was the only place that asked for a report,
-so a stop anywhere else left no trace at all. A stop nobody hears about is a stop this
-graph cannot fix.
-
 ## Check sign-in
 
-Run `npx --yes copilotkit@4.10.1 login --json` before any project work. This command
+Run `npx --yes copilotkit@4.11.0 login --json` before any project work. This command
 checks the current session. It starts sign-in only as needed. Treat this as a long-lived
 streaming process. Do not wait for the command to exit before you read its standard output.
 
@@ -139,8 +153,8 @@ Do not use `whoami` for this check. It has no JSON output and some failures exit
 zero. Do not put account tokens or credentials in the conversation.
 
 When sign-in is settled, run
-`npx --yes copilotkit@4.10.1 onboard read research/gather`.
+`npx --yes copilotkit@4.11.0 onboard read research/gather`.
 
 If sign-in stops onboarding, run
-`npx --yes copilotkit@4.10.1 onboard read stopped/run-failed`. It says nothing about
+`npx --yes copilotkit@4.11.0 onboard read stopped/run-failed`. It says nothing about
 whether this project's stack is supported, which is not yet known at this point.

package/onboarding/prompts/conversion/plan.md

@@ -100,7 +100,7 @@ of this journey, and a drawer that lists nothing is not a reason to mint one. Li
 tokens stay a self-hosted concern.
 
 Where this journey's frontend framework ships no threads drawer -- React Native --, the
-fifth item is proved by `npx --yes copilotkit@4.10.1 verify --round-trip`, which sends a
+fifth item is proved by `npx --yes copilotkit@4.11.0 verify --round-trip`, which sends a
 real request and reads the answer back off the thread it landed on. The run says which of
 the two it proved. Do not send a run to the managed Intelligence dashboard to prove this.
 An authenticated browser session at a hosted dashboard is the one thing an agent-driven run
@@ -116,7 +116,7 @@ and passed -- so a run scored on either one was scored on the same fact. Every r
 resolves that condition from, while `licenseStatus` is a compatibility projection of it
 for older thread surfaces and outlives them only until those surfaces go.
 
-Then run `npx --yes copilotkit@4.10.1 onboard read credentials/finalize-plan`.
+Then run `npx --yes copilotkit@4.11.0 onboard read credentials/finalize-plan`.
 
 If a selected page does not load after the second method, run
-`npx --yes copilotkit@4.10.1 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.11.0 onboard read unsupported/no-validated-path`.