copilotkit 4.9.0 → 4.9.1

package/index.js

@@ -96,14 +96,14 @@ function getTelemetryEndpointUrl() {
 }
 function getBuildInfo() {
   return {
-    version: true ? "4.9.0" : "dev",
-    buildNumber: true ? "32886074334" : "dev",
-    commitSha: true ? "fab380427c6324aaf090b195af0f51eaf4a1a407" : "dev",
+    version: true ? "4.9.1" : "dev",
+    buildNumber: true ? "32915219082" : "dev",
+    commitSha: true ? "0528d9de0d7915386d789deb676d44c4668842b1" : "dev",
     copilotKitCommit: getTemplateRef()
   };
 }
 function getTemplateRef() {
-  return true ? "bf2068734bcc42b9dc9999b183d0fd07a673f713" : "main";
+  return true ? "2ad03320fe1f0834b138113fffe791781e5b226e" : "main";
 }
 function getC15tBackendUrl() {
   return true ? "https://calm-hazelnut-joy-copilotkit.inth.app" : "";
@@ -93909,11 +93909,15 @@ function BrowserLoginConfirmation({
 } = {}) {
   const { state, confirmBrowserLoginStart, submitManualClerkToken } = useBrowserLogin();
   const [manualTokenInput, setManualTokenInput] = (0, import_react35.useState)("");
-  use_input_default((_input, key) => {
-    if (state.phase === "confirming" && key.return) {
-      confirmBrowserLoginStart();
-    }
-  });
+  const canPrompt = isBrowserLoginConfirmationInteractive();
+  use_input_default(
+    (_input, key) => {
+      if (state.phase === "confirming" && key.return) {
+        confirmBrowserLoginStart();
+      }
+    },
+    { isActive: canPrompt }
+  );
   if (state.phase === "idle") {
     return null;
   }
@@ -93931,7 +93935,7 @@ function BrowserLoginConfirmation({
         /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { dimColor: true, children: BROWSER_LOGIN_MANUAL_URL_LABEL }),
         /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { children: state.loginUrl })
       ] }) : null,
-      /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(Box_default, { marginTop: 1, flexDirection: "column", children: [
+      canPrompt ? /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(Box_default, { marginTop: 1, flexDirection: "column", children: [
         /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { dimColor: true, children: BROWSER_LOGIN_MANUAL_PASTE_LABEL }),
         /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(Box_default, { children: [
           /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(Text, { children: [
@@ -93951,7 +93955,7 @@ function BrowserLoginConfirmation({
             }
           )
         ] })
-      ] }),
+      ] }) : null,
       /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(CliTip, {})
     ] });
   }
@@ -95687,15 +95691,15 @@ function createFlagPrompts(request) {
   };
   return { prompts, refusal };
 }
-function formatFlagRefusal(refusal) {
+function formatFlagRefusal(refusal, command2 = "project select") {
   if (refusal.kind === "name-rejected") {
-    const remedy = refusal.duplicateSlug === void 0 ? "Pass a different --create name." : `Pass a different --create name, or select it with \`copilotkit project select --project ${refusal.duplicateSlug}\`.`;
+    const remedy = refusal.duplicateSlug === void 0 ? "Pass a different --create name." : `Pass a different --create name, or select it with \`copilotkit ${command2} --project ${refusal.duplicateSlug}\`.`;
     return `${refusal.message} ${remedy}
 `;
   }
   if (refusal.available.length === 0) {
     return `No hosted Intelligence projects exist in this organization, so --project ${refusal.requested} cannot be selected.
-Create one with \`copilotkit project select --create <name>\`.
+Create one with \`copilotkit ${command2} --create <name>\`.
 `;
   }
   return `No hosted project matches --project ${refusal.requested} in this organization.
@@ -377321,6 +377325,146 @@ var init_env_file = __esm({
   }
 });
 
+// apps/cli/src/commands/init-project-flag.ts
+var init_project_flag_exports = {};
+__export(init_project_flag_exports, {
+  hostedProjectFlagUnsupportedError: () => hostedProjectFlagUnsupportedError,
+  resolveInitProjectFlag: () => resolveInitProjectFlag,
+  selectHostedProjectFromFlag: () => selectHostedProjectFromFlag
+});
+function resolveInitProjectFlag(input) {
+  const project = input.project?.trim();
+  const create3 = input.create?.trim();
+  if (input.project !== void 0 && input.create !== void 0) {
+    return {
+      status: "invalid",
+      message: "`--project` and `--create` cannot be combined: one selects an existing hosted Intelligence project, the other makes a new one.\nRun `copilotkit project list --json` to see what already exists."
+    };
+  }
+  if (input.project !== void 0) {
+    if (project === void 0 || project === "") {
+      return {
+        status: "invalid",
+        message: "`--project` needs a project slug or id.\nRun `copilotkit project list --json` to see them."
+      };
+    }
+    return resolveAgainstFramework(
+      { kind: "project", value: project },
+      input.framework
+    );
+  }
+  if (input.create !== void 0) {
+    if (create3 === void 0 || create3 === "") {
+      return {
+        status: "invalid",
+        message: "`--create` needs a project name."
+      };
+    }
+    return resolveAgainstFramework(
+      { kind: "create", name: create3 },
+      input.framework
+    );
+  }
+  return { status: "ok", request: null };
+}
+function resolveAgainstFramework(request, framework) {
+  const unsupported = hostedProjectFlagUnsupportedError(
+    request,
+    framework ?? null
+  );
+  return unsupported === void 0 ? { status: "ok", request } : { status: "invalid", message: unsupported };
+}
+function hostedProjectFlagUnsupportedError(hostedProject, framework) {
+  if (hostedProject === null || framework === null)
+    return void 0;
+  const resolved = resolveFrameworkAlias(framework);
+  if (!isAgentFramework(resolved) || THREADS_FRAMEWORKS.has(resolved)) {
+    return void 0;
+  }
+  const flag = hostedProject.kind === "project" ? `--project ${hostedProject.value}` : `--create ${hostedProject.name}`;
+  return `The ${resolved} starter ships no Intelligence threads, so there is no hosted project to bind and \`${flag}\` cannot be used with it.
+Run \`copilotkit framework list\` to see which frameworks bind a project, or scaffold without the flag.`;
+}
+async function selectHostedProjectFromFlag(apiClient, request, telemetry) {
+  const { prompts, refusal } = createFlagPrompts(request);
+  const result = await selectOrCreateHostedProject({
+    apiClient,
+    prompts,
+    ...telemetry ? { telemetry } : {}
+  });
+  if ("canceled" in result) {
+    const recorded = refusal.value;
+    throw tagError(
+      new Error(
+        recorded === null ? "Project selection canceled." : formatFlagRefusal(recorded, "init").trimEnd()
+      ),
+      TELEMETRY_ERROR_CODES.PROJECT_NOT_FOUND
+    );
+  }
+  return result;
+}
+var init_init_project_flag = __esm({
+  "apps/cli/src/commands/init-project-flag.ts"() {
+    "use strict";
+    init_hosted_project2();
+    init_types();
+    init_event_properties();
+    init_project_select_flags();
+  }
+});
+
+// apps/cli/src/commands/init-non-interactive.ts
+var init_non_interactive_exports = {};
+__export(init_non_interactive_exports, {
+  NON_INTERACTIVE_LOGIN_MESSAGE: () => NON_INTERACTIVE_LOGIN_MESSAGE,
+  formatNonInteractiveInitRefusal: () => formatNonInteractiveInitRefusal,
+  missingNonInteractiveInitFlags: () => missingNonInteractiveInitFlags,
+  resolveInitInstallFlag: () => resolveInitInstallFlag
+});
+function missingNonInteractiveInitFlags(answers) {
+  const missing = [];
+  if (answers.name === void 0 || answers.name.trim() === "") {
+    missing.push("--name");
+  }
+  const framework = answers.framework === void 0 ? void 0 : resolveFrameworkAlias(answers.framework);
+  if (framework === void 0 || framework.trim() === "") {
+    missing.push("--framework");
+  } else if (isAgentFramework(framework) && THREADS_FRAMEWORKS.has(framework) && !answers.hostedProjectNamed) {
+    missing.push("--project");
+  }
+  if (!answers.installAnswered) {
+    missing.push("--yes");
+  }
+  return missing;
+}
+function formatNonInteractiveInitRefusal(missing) {
+  return `\`copilotkit init\` prompts for anything you do not name, and this shell has no terminal to prompt in.
+Name the rest up front: ${missing.join(", ")}
+` + (missing.includes("--project") ? "Run `copilotkit project list --json` to see your projects, or pass `--create <name>` to make one.\n" : "") + (missing.includes("--framework") ? "Run `copilotkit framework list` to see the frameworks and the flags each accepts.\n" : "") + (missing.includes("--yes") ? "`--yes` installs dependencies; pass `--no-install` to answer the same question without installing.\n" : "");
+}
+function resolveInitInstallFlag(input) {
+  const wantsInstall = input.yes === true || input.install === true;
+  if (wantsInstall && input.noInstall === true) {
+    return {
+      status: "invalid",
+      message: "Pass either `--install` (or `--yes`) or `--no-install`, not both: they answer the same question in opposite ways."
+    };
+  }
+  if (wantsInstall)
+    return { status: "ok", install: true };
+  if (input.noInstall === true)
+    return { status: "ok", install: false };
+  return { status: "ok", install: null };
+}
+var NON_INTERACTIVE_LOGIN_MESSAGE;
+var init_init_non_interactive = __esm({
+  "apps/cli/src/commands/init-non-interactive.ts"() {
+    "use strict";
+    init_types();
+    NON_INTERACTIVE_LOGIN_MESSAGE = "`copilotkit init` needs a CopilotKit session, and signing in opens a browser that finishes back at a terminal this shell does not have.\nRun `copilotkit login` in a terminal, then re-run this command.";
+  }
+});
+
 // apps/cli/src/ui/init-flow.tsx
 import * as path26 from "node:path";
 function FrameworkIndicator({ isSelected = false }) {
@@ -379110,6 +379254,12 @@ import {
   rmSync as rmSync4
 } from "node:fs";
 import * as path33 from "node:path";
+function markDisplayedAtTerminal(error98) {
+  if (process.stdout.isTTY === true) {
+    error98.displayed = true;
+  }
+  return error98;
+}
 function shouldRenderInitBrowserLoginConfirmation(phase) {
   return phase === "confirming" || phase === "waiting" || phase === "finalizing";
 }
@@ -379137,6 +379287,16 @@ function commandExists(command2, environment = process.env, platform4 = process.
 function vendorKeyPromptInteractive() {
   return process.stdin.isTTY === true && process.stdout.isTTY === true;
 }
+function createHostedProjectApiClient(auth2) {
+  return createApiClient(getOpsApiUrl(), auth2.cliToken, {
+    onProductCredential: (productCredential) => {
+      authStore.save({ ...auth2, productCredential });
+    },
+    productBaseUrl: getAppApiUrl(),
+    productCredential: auth2.productCredential,
+    productOrganizationId: auth2.clerkOrgId
+  });
+}
 function buildInitNextSteps(templateDefinition, projectName, result, unsatisfiedKeys, installAlreadyRan = false, mockProvider = void 0) {
   const missingPrerequisites = templateDefinition.prerequisites.filter(
     (prerequisite) => result.missingPrerequisites.includes(prerequisite.command)
@@ -379322,6 +379482,12 @@ async function ensureCliToken2(dependencies, onTerminalSessionInvalidation, onBr
     }
   };
   const openBrowser = async () => {
+    if (!(dependencies.isBrowserLoginInteractive ?? isBrowserLoginConfirmationInteractive)()) {
+      throw tagError(
+        new Error(NON_INTERACTIVE_LOGIN_MESSAGE),
+        TELEMETRY_ERROR_CODES.NON_INTERACTIVE
+      );
+    }
     emitGate(false);
     if (!openedBrowser) {
       openedBrowser = true;
@@ -379579,13 +379745,16 @@ async function scaffoldInitProject(options, dependencies = defaultInitScaffoldDe
         });
       } catch (selectionError) {
         const detail = selectionError instanceof Error ? selectionError.message : String(selectionError);
-        warnings.push(
-          `Project not selected (${detail}); run \`copilotkit project select\` in the project to choose one.`
-        );
         writeCliLog("error", {
           event: "init.project_select_failed",
           detail
         });
+        if (options.hostedProject !== null && options.hostedProject !== void 0) {
+          throw selectionError instanceof Error ? selectionError : new Error(detail);
+        }
+        warnings.push(
+          `Project not selected (${detail}); run \`copilotkit project select\` in the project to choose one.`
+        );
       }
     }
     telemetry?.onScaffoldSucceeded({
@@ -379757,6 +379926,7 @@ function ScaffoldProgress({
   const channelOfferDeferredRef = (0, import_react48.useRef)(null);
   const channelCompletionOfferedRef = (0, import_react48.useRef)(false);
   const installAlreadyRanRef = (0, import_react48.useRef)(false);
+  const installAnsweredRef = (0, import_react48.useRef)(false);
   const [credentialRequest, setCredentialRequest] = (0, import_react48.useState)(null);
   const [attachingChannel, setAttachingChannel] = (0, import_react48.useState)(false);
   const channelFlagError = (0, import_react48.useMemo)(
@@ -379766,6 +379936,13 @@ function ScaffoldProgress({
     ),
     [options.channel, options.framework]
   );
+  const hostedProjectFlagError = (0, import_react48.useMemo)(
+    () => hostedProjectFlagUnsupportedError(
+      options.hostedProject ?? null,
+      options.framework ?? null
+    ),
+    [options.hostedProject, options.framework]
+  );
   const flagChannelOffer = (0, import_react48.useMemo)(
     () => channelOfferFromFlag(options.channel ?? null),
     [options.channel]
@@ -379781,6 +379958,19 @@ function ScaffoldProgress({
             new Error("Not authenticated for project selection.")
           );
         }
+        const named = options.hostedProject;
+        if (named !== null && named !== void 0) {
+          return selectHostedProjectFromFlag(
+            createHostedProjectApiClient(auth2),
+            named,
+            {
+              onPickerViewed: (projectCount) => telemetry?.onProjectPickerViewed({ projectCount }),
+              onResolved: (outcome, projectCount) => telemetry?.onProjectResolved({ outcome, projectCount }),
+              onCreateNameRejected: (reason) => telemetry?.onProjectCreateNameRejected({ reason }),
+              onBack: () => telemetry?.onProjectPickerBack()
+            }
+          );
+        }
         return new Promise((resolve9, reject) => {
           selectionDeferredRef.current = { resolve: resolve9, reject };
         });
@@ -379846,11 +380036,11 @@ function ScaffoldProgress({
   }, [phase, scaffoldResult]);
   (0, import_react48.useEffect)(() => {
     let cancelled = false;
-    if (channelFlagError !== void 0) {
-      const error98 = new Error(channelFlagError);
-      error98.displayed = true;
+    const flagError = channelFlagError ?? hostedProjectFlagError;
+    if (flagError !== void 0) {
+      const error98 = markDisplayedAtTerminal(new Error(flagError));
       scaffoldErrorRef.current = error98;
-      setErrorMessage(channelFlagError);
+      setErrorMessage(flagError);
       setPhase("error");
       return () => {
         cancelled = true;
@@ -379892,8 +380082,9 @@ function ScaffoldProgress({
     run().catch((err2) => {
       if (cancelled)
         return;
-      const error98 = err2 instanceof Error ? err2 : new Error("An unexpected error occurred.");
-      error98.displayed = true;
+      const error98 = markDisplayedAtTerminal(
+        err2 instanceof Error ? err2 : new Error("An unexpected error occurred.")
+      );
       scaffoldErrorRef.current = error98;
       setErrorMessage(error98.message);
       setPhase("error");
@@ -379940,6 +380131,45 @@ function ScaffoldProgress({
     }
     setPhase("success");
   }
+  function answerInstall(result, install) {
+    if (!install) {
+      finalizeSuccess(result);
+      return;
+    }
+    setPhase("installing");
+    scaffoldDependencies.installDependencies({
+      cwd: result.projectDir,
+      command: templateDefinition.installCommand,
+      log: writeCliLog
+    }).then((r2) => {
+      if (r2.ok)
+        return true;
+      if (isMountedRef.current) {
+        setInstallError(r2.stderrTail || "install failed");
+      }
+      return false;
+    }).catch((e2) => {
+      if (isMountedRef.current) {
+        setInstallError(e2 instanceof Error ? e2.message : String(e2));
+      }
+      return false;
+    }).then((installSucceeded) => {
+      if (!isMountedRef.current)
+        return;
+      finalizeSuccess(result, installSucceeded);
+    });
+  }
+  (0, import_react48.useEffect)(() => {
+    if (phase !== "install-prompt" || scaffoldResult === null)
+      return;
+    const answer = options.installDependencies;
+    if (answer !== true && answer !== false)
+      return;
+    if (installAnsweredRef.current)
+      return;
+    installAnsweredRef.current = true;
+    answerInstall(scaffoldResult, answer);
+  }, [phase, scaffoldResult, options.installDependencies]);
   function completeChannel(result, channel2) {
     const complete = scaffoldDependencies.completeChannelSetup;
     if (complete === void 0) {
@@ -380033,6 +380263,9 @@ function ScaffoldProgress({
     return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Box_default, { children: /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Spinner, { label: "\u{1FA81} Downloading template\u2026" }) });
   }
   if (phase === "select-project") {
+    if (options.hostedProject !== null && options.hostedProject !== void 0) {
+      return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Spinner, { label: "\u{1FA81} Selecting your Intelligence project\u2026" });
+    }
     const auth2 = authStore.get();
     if (auth2 === null) {
       return null;
@@ -380040,14 +380273,7 @@ function ScaffoldProgress({
     return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
       HostedProjectSelect,
       {
-        apiClient: createApiClient(getOpsApiUrl(), auth2.cliToken, {
-          onProductCredential: (productCredential) => {
-            authStore.save({ ...auth2, productCredential });
-          },
-          productBaseUrl: getAppApiUrl(),
-          productCredential: auth2.productCredential,
-          productOrganizationId: auth2.clerkOrgId
-        }),
+        apiClient: createHostedProjectApiClient(auth2),
         defaultName: options.name,
         telemetry: {
           onPickerViewed: (projectCount) => telemetry?.onProjectPickerViewed({ projectCount }),
@@ -380163,38 +380389,17 @@ function ScaffoldProgress({
     );
   }
   if (phase === "install-prompt" && scaffoldResult) {
+    if (options.installDependencies === true) {
+      return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(Spinner, { label: "\u{1FA81} Installing dependencies\u2026" });
+    }
+    if (options.installDependencies === false) {
+      return null;
+    }
     return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
       InstallPrompt,
       {
         installCommand: templateDefinition.installCommand,
-        onAnswer: (install) => {
-          if (!install) {
-            finalizeSuccess(scaffoldResult);
-            return;
-          }
-          setPhase("installing");
-          scaffoldDependencies.installDependencies({
-            cwd: scaffoldResult.projectDir,
-            command: templateDefinition.installCommand,
-            log: writeCliLog
-          }).then((r2) => {
-            if (r2.ok)
-              return true;
-            if (isMountedRef.current) {
-              setInstallError(r2.stderrTail || "install failed");
-            }
-            return false;
-          }).catch((e2) => {
-            if (isMountedRef.current) {
-              setInstallError(e2 instanceof Error ? e2.message : String(e2));
-            }
-            return false;
-          }).then((installSucceeded) => {
-            if (!isMountedRef.current)
-              return;
-            finalizeSuccess(scaffoldResult, installSucceeded);
-          });
-        }
+        onAnswer: (install) => answerInstall(scaffoldResult, install)
       }
     );
   }
@@ -380269,6 +380474,8 @@ function InitApp({
   noBanner = false,
   initialMock = false,
   initialChannel = null,
+  initialHostedProject = null,
+  initialInstall = null,
   renderScaffoldProgress = renderDefaultScaffoldProgress,
   onIntelligenceSelected,
   onFrameworkSelected,
@@ -380281,7 +380488,12 @@ function InitApp({
     initialFramework,
     mock
   );
-  const prefilled = prefilledBase === null ? null : { ...prefilledBase, channel: initialChannel };
+  const prefilled = prefilledBase === null ? null : {
+    ...prefilledBase,
+    channel: initialChannel,
+    hostedProject: initialHostedProject,
+    installDependencies: initialInstall
+  };
   const [options, setOptions] = (0, import_react48.useState)(prefilled);
   (0, import_react48.useEffect)(() => {
     if (prefilled !== null) {
@@ -380315,7 +380527,13 @@ function InitApp({
           onFrameworkSelected,
           onComplete: (resolved) => {
             if (resolved !== null) {
-              setOptions({ ...resolved, mock, channel: initialChannel });
+              setOptions({
+                ...resolved,
+                mock,
+                channel: initialChannel,
+                hostedProject: initialHostedProject,
+                installDependencies: initialInstall
+              });
             }
           }
         }
@@ -380359,6 +380577,8 @@ async function runInit(flags, callbacks) {
         initialFramework,
         initialMock: flags.mock ?? false,
         initialChannel: flags.channel ?? null,
+        initialHostedProject: flags.hostedProject ?? null,
+        initialInstall: flags.installDependencies ?? null,
         noBanner: flags.noBanner === true,
         onIntelligenceSelected: callbacks?.onIntelligenceSelected,
         onFrameworkSelected: callbacks?.onFrameworkSelected,
@@ -380387,6 +380607,8 @@ var init_init = __esm({
     await init_vendor_key_prompt();
     init_feature_flags();
     await init_install_prompt();
+    init_init_project_flag();
+    init_init_non_interactive();
     init_config_service();
     init_event_properties();
     init_cli_logs();
@@ -380449,7 +380671,8 @@ var init_init = __esm({
       appendIntelligenceReadme,
       writeHostedApiKey,
       writeVendorKey,
-      isVendorKeyPromptInteractive: vendorKeyPromptInteractive
+      isVendorKeyPromptInteractive: vendorKeyPromptInteractive,
+      isBrowserLoginInteractive: isBrowserLoginConfirmationInteractive
     };
   }
 });
@@ -380965,6 +381188,56 @@ var init_onboarding_state = __esm({
   }
 });
 
+// apps/cli/src/services/onboarding-classification.ts
+function requireOnboardingChoice(flag, value, choices) {
+  const selected = choices.find((choice) => choice === value);
+  if (selected === void 0) {
+    throw new Error(`${flag} must be one of: ${choices.join(", ")}.`);
+  }
+  return selected;
+}
+var ONBOARDING_STARTING_STATES, ONBOARDING_AGENT_FRAMEWORKS, ONBOARDING_FRONTENDS;
+var init_onboarding_classification = __esm({
+  "apps/cli/src/services/onboarding-classification.ts"() {
+    "use strict";
+    ONBOARDING_STARTING_STATES = [
+      "empty",
+      "agent-only",
+      "frontend-only",
+      "both",
+      "both-oss"
+    ];
+    ONBOARDING_AGENT_FRAMEWORKS = [
+      "ag2",
+      "agno",
+      "built-in",
+      "claude-sdk-python",
+      "claude-sdk-typescript",
+      "crewai-flows",
+      "deep-agents",
+      "google-adk",
+      "langgraph-fastapi",
+      "langgraph-python",
+      "langgraph-typescript",
+      "llamaindex",
+      "mastra",
+      "ms-agent-dotnet",
+      "ms-agent-harness-dotnet",
+      "ms-agent-python",
+      "pydantic-ai",
+      "strands-python",
+      "strands-typescript"
+    ];
+    ONBOARDING_FRONTENDS = [
+      "react-spa",
+      "nextjs",
+      "angular",
+      "vue",
+      "react-native"
+    ];
+  }
+});
+
 // apps/cli/src/commands/onboard.ts
 var onboard_exports = {};
 __export(onboard_exports, {
@@ -381024,25 +381297,61 @@ async function runOnboard(argv, dependencies) {
     return;
   }
   if (subcommand === "complete") {
-    const visualCheck = parseVisualCheck(argv.slice(1));
-    if (visualCheck === void 0) {
-      throw new Error(
-        "Usage: copilotkit onboard complete --visual-check <performed|skipped-no-browser-tool|failed>"
-      );
-    }
+    const check4 = parseSurfaceCheck(argv.slice(1));
+    if (check4 === void 0)
+      throw new Error(SURFACE_CHECK_USAGE);
     recordBestEffort(deps, {
       event: "cli.onboarding.completed",
       properties: {
         command: "onboard",
         onboarding_run_id: binding.runId,
         cli_version: deps.cliVersion,
-        visual_check: visualCheck
+        ...check4.kind === "visual" ? { visual_check: check4.outcome } : { device_check: check4.outcome }
       }
     });
-    deps.stdout.write("CopilotKit onboarding marked complete.\n");
-    if (visualCheck !== "performed") {
-      deps.stdout.write(visualCheckWarning(visualCheck));
-    }
+    deps.stdout.write(
+      check4.outcome === "performed" ? "CopilotKit onboarding marked complete.\n" : blockedWithoutSurfaceProof(check4)
+    );
+    return;
+  }
+  if (subcommand === "classify") {
+    const parsed = parseArgs2({
+      args: [...argv.slice(1)],
+      allowPositionals: false,
+      options: {
+        "starting-state": { type: "string" },
+        "agent-framework": { type: "string" },
+        frontend: { type: "string" }
+      },
+      strict: true
+    });
+    const startingState = requireOnboardingChoice(
+      "--starting-state",
+      parsed.values["starting-state"],
+      ONBOARDING_STARTING_STATES
+    );
+    const agentFramework = requireOnboardingChoice(
+      "--agent-framework",
+      parsed.values["agent-framework"],
+      ONBOARDING_AGENT_FRAMEWORKS
+    );
+    const frontend = requireOnboardingChoice(
+      "--frontend",
+      parsed.values.frontend,
+      ONBOARDING_FRONTENDS
+    );
+    recordBestEffort(deps, {
+      event: "cli.onboarding.classified",
+      properties: {
+        command: "onboard",
+        onboarding_run_id: binding.runId,
+        cli_version: deps.cliVersion,
+        starting_state: startingState,
+        agent_framework: agentFramework,
+        frontend
+      }
+    });
+    deps.stdout.write("Onboarding path included in telemetry when enabled.\n");
     return;
   }
   if (subcommand === "feedback") {
@@ -381057,28 +381366,66 @@ async function runOnboard(argv, dependencies) {
     return;
   }
   throw new Error(
-    "Usage: copilotkit onboard <start|read|complete|feedback|friction>"
+    "Usage: copilotkit onboard <start|read|classify|complete|feedback|friction>"
   );
 }
-function parseVisualCheck(rest) {
-  if (rest.length !== 2 || rest[0] !== "--visual-check")
+function parseSurfaceCheck(rest) {
+  if (rest.length !== 2)
     return void 0;
-  const value = rest[1];
-  return VISUAL_CHECK_OUTCOMES.find((outcome) => outcome === value);
+  const [flag, value] = rest;
+  if (flag === "--visual-check") {
+    const outcome = VISUAL_CHECK_OUTCOMES.find((known) => known === value);
+    return outcome === void 0 ? void 0 : { kind: "visual", outcome };
+  }
+  if (flag === "--device-check") {
+    const outcome = DEVICE_CHECK_OUTCOMES.find((known) => known === value);
+    return outcome === void 0 ? void 0 : { kind: "device", outcome };
+  }
+  return void 0;
 }
-function visualCheckWarning(outcome) {
-  const cause = outcome === "failed" ? "it did not succeed" : "no browser automation was available to the coding agent, so nothing drove the real frontend";
+function blockedWithoutSurfaceProof(check4) {
+  const failed2 = check4.outcome === "failed";
+  const visual = {
+    headline: [
+      "  The live UI check was NOT performed:",
+      failed2 ? "  it did not succeed." : "  no browser automation was available, so nothing drove the real frontend."
+    ],
+    uncovered: [
+      "realtime delivery to a browser over the gateway",
+      "browser-origin CORS and CSP, which a CLI request never exercises",
+      "the frontend provider being wired to this runtime",
+      "generative UI actually rendering a component"
+    ],
+    reach: "which reaches no browser",
+    close: "configure a browser MCP server for your coding agent and drive\n  the app once by hand, then run this command again with\n  `--visual-check performed`"
+  };
+  const device = {
+    headline: [
+      "  The on-device check was NOT performed:",
+      failed2 ? "  it did not succeed." : "  no device or emulator was available, so nothing ran the real app."
+    ],
+    uncovered: [
+      "the app rendering at all on a real screen",
+      "a tool-rendered component painted in the view tree",
+      "an unresolved redbox, which no terminal output shows",
+      "realtime delivery to the app over the gateway"
+    ],
+    reach: "which reaches no screen",
+    close: "run the app on a device or emulator and capture the terminal state --\n  `adb exec-out screencap -p` on Android -- then run this command again\n  with `--device-check performed`"
+  };
+  const surface = check4.kind === "visual" ? visual : device;
   return [
     "",
-    `! The live UI check was NOT performed: ${cause}.`,
-    "  The agent round trip itself was proven with `copilotkit verify --round-trip`.",
-    "  Not covered by that, and still unverified here:",
-    "    - realtime delivery to a browser over the gateway",
-    "    - browser-origin CORS and CSP, which a CLI request never exercises",
-    "    - the frontend provider being wired to this runtime",
-    "    - generative UI actually rendering a component",
-    "  To close it, configure a browser MCP server for your coding agent and",
-    "  drive the app once by hand.",
+    "! Onboarding is NOT complete.",
+    ...surface.headline,
+    `  The agent round trip is what \`copilotkit verify --round-trip\` proves, ${surface.reach}.`,
+    "  Not covered by it, and still unverified here:",
+    ...surface.uncovered.map((line) => `    - ${line}`),
+    "",
+    "  Report this run as blocked, and name the unverified lines above as the",
+    "  evidence it is missing. Do not report it as complete: every other check in",
+    "  this graph can pass while all four of those fail.",
+    `  To close it, ${surface.close}.`,
     ""
   ].join("\n");
 }
@@ -381232,7 +381579,7 @@ function recordBestEffort(dependencies, event) {
   } catch {
   }
 }
-var VISUAL_CHECK_OUTCOMES;
+var VISUAL_CHECK_OUTCOMES, DEVICE_CHECK_OUTCOMES, SURFACE_CHECK_USAGE;
 var init_onboard = __esm({
   async "apps/cli/src/commands/onboard.ts"() {
     "use strict";
@@ -381242,12 +381589,19 @@ var init_onboard = __esm({
     init_onboarding_friction();
     init_onboarding_feedback();
     init_onboarding_state();
+    init_onboarding_classification();
     await init_telemetry();
     VISUAL_CHECK_OUTCOMES = [
       "performed",
       "skipped-no-browser-tool",
       "failed"
     ];
+    DEVICE_CHECK_OUTCOMES = [
+      "performed",
+      "skipped-no-device",
+      "failed"
+    ];
+    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.";
   }
 });
 
@@ -384427,6 +384781,7 @@ Options:
 `,
   onboard: `Usage: copilotkit onboard start [--run <id>] [--coding-agent <slug>]
        copilotkit onboard read <prompt-name>
+       copilotkit onboard classify --starting-state <state> --agent-framework <framework> --frontend <frontend>
        copilotkit onboard complete
        copilotkit onboard feedback
        copilotkit onboard friction --category <slug> --cost-seconds <seconds>
@@ -384436,6 +384791,7 @@ Guide a coding agent through the Markdown graph bundled with this exact CLI.
 Subcommands:
   start                  Start or replace the repository-bound onboarding run
   read                   Print one rendered prompt as the only stdout payload
+  classify               Send the bounded matrix path for this run
   complete               Mark a proven onboarding run complete
   feedback               Read one non-empty message from standard input
   friction               Report one papercut that slowed a run down
@@ -384552,9 +384908,28 @@ ${isCliFlagEnabled("cli.aimock-mock-mode") ? `      --mock             Run keyle
                          provider will ask you for. A named provider is set up as
                          far as it can go without credentials, then reports what
                          is left -- it never prompts for a secret.
+      --project <ref>    Select an existing hosted Intelligence project by slug
+                         or id, instead of showing the picker
+      --create <name>    Create a hosted Intelligence project with this name and
+                         select it
+  -y, --yes              Install dependencies without asking
+      --install          Install dependencies without asking (same as --yes)
+      --no-install       Skip the install without asking
       --no-banner        Suppress the CopilotKit welcome banner (used when a
                          parent tool, e.g. create-ag-ui-app, shows its own)
   -h, --help             Show help for init
+
+Pass --project or --create, never both. They resolve the same way
+\`copilotkit project select\` does: a typo fails with the real slugs rather than
+creating something you did not ask for.
+
+init prompts for anything you do not name, so a shell with no terminal needs the
+answers up front: -n, -f, -y, and --project or --create. It then refuses only the
+ones still missing, and names them.
+
+Signing in is the one answer no flag supplies: it opens a browser and finishes
+back at the terminal. Run \`copilotkit login\` first, or a run with no terminal is
+refused rather than opening a browser it cannot finish with.
 `,
   license: `Usage: copilotkit license [create]
        copilotkit license list [options]
@@ -385735,6 +386110,11 @@ var INIT_PARSE_OPTIONS = {
   framework: { type: "string", short: "f" },
   mock: { type: "boolean" },
   channel: { type: "string" },
+  project: { type: "string" },
+  create: { type: "string" },
+  yes: { type: "boolean", short: "y" },
+  install: { type: "boolean" },
+  "no-install": { type: "boolean" },
   "no-banner": { type: "boolean" }
 };
 async function runInitCommand(invokedAs, argv) {
@@ -385775,17 +386155,22 @@ async function runInitCommand(invokedAs, argv) {
     await exitWithFlush(1);
     return;
   }
-  if (!process.stdin.isTTY) {
+  const { resolveInitProjectFlag: resolveInitProjectFlag2 } = await Promise.resolve().then(() => (init_init_project_flag(), init_project_flag_exports));
+  const projectResolution = resolveInitProjectFlag2({
+    project: parsed.values["project"],
+    create: parsed.values["create"],
+    framework: frameworkFlag
+  });
+  if (projectResolution.status === "invalid") {
     recordTelemetryEvent({
       properties: {
         ...telemetryBase,
         outcome: "failed",
-        error_code: "non_interactive"
+        error_code: "validation"
       }
     });
-    process.stderr.write(
-      "Error: `copilotkit init` must be run in an interactive terminal.\nIt prompts for project options, and Intelligence templates open a browser to sign in.\nRe-run it directly in a terminal (not piped, redirected, or in a non-interactive CI step).\n"
-    );
+    process.stderr.write(`Error: ${projectResolution.message}
+`);
     await exitWithFlush(1);
     return;
   }
@@ -385817,12 +386202,74 @@ async function runInitCommand(invokedAs, argv) {
     await exitWithFlush(1);
     return;
   }
+  const {
+    formatNonInteractiveInitRefusal: formatNonInteractiveInitRefusal2,
+    missingNonInteractiveInitFlags: missingNonInteractiveInitFlags2,
+    resolveInitInstallFlag: resolveInitInstallFlag2,
+    NON_INTERACTIVE_LOGIN_MESSAGE: NON_INTERACTIVE_LOGIN_MESSAGE2
+  } = await Promise.resolve().then(() => (init_init_non_interactive(), init_non_interactive_exports));
+  const installResolution = resolveInitInstallFlag2({
+    yes: parsed.values["yes"],
+    install: parsed.values["install"],
+    noInstall: parsed.values["no-install"]
+  });
+  if (installResolution.status === "invalid") {
+    recordTelemetryEvent({
+      properties: {
+        ...telemetryBase,
+        outcome: "failed",
+        error_code: "validation"
+      }
+    });
+    process.stderr.write(`Error: ${installResolution.message}
+`);
+    await exitWithFlush(1);
+    return;
+  }
+  if (!process.stdin.isTTY) {
+    const missing = missingNonInteractiveInitFlags2({
+      name: parsed.values["name"],
+      framework: frameworkFlag,
+      hostedProjectNamed: projectResolution.request !== null,
+      installAnswered: installResolution.install !== null
+    });
+    if (missing.length > 0) {
+      recordTelemetryEvent({
+        properties: {
+          ...telemetryBase,
+          outcome: "failed",
+          error_code: "non_interactive"
+        }
+      });
+      process.stderr.write(
+        `Error: ${formatNonInteractiveInitRefusal2(missing)}`
+      );
+      await exitWithFlush(1);
+      return;
+    }
+    const { authStore: authStore2 } = await Promise.resolve().then(() => (init_config_service(), config_service_exports));
+    if (authStore2.get() === null) {
+      recordTelemetryEvent({
+        properties: {
+          ...telemetryBase,
+          outcome: "failed",
+          error_code: "non_interactive"
+        }
+      });
+      process.stderr.write(`Error: ${NON_INTERACTIVE_LOGIN_MESSAGE2}
+`);
+      await exitWithFlush(1);
+      return;
+    }
+  }
   const flags = {
     name: parsed.values["name"],
     intelligence,
     framework,
     mock,
     channel: channelResolution.channel,
+    hostedProject: projectResolution.request,
+    installDependencies: installResolution.install,
     noBanner: parsed.values["no-banner"]
   };
   await withTelemetry(telemetryBase, async (ctx) => {