@kal-elsam/kairo-runtime 0.2.2 → 0.3.0

package/src/global/orchestrator.js

@@ -2,9 +2,15 @@ import { stdin as input, stdout as output } from "node:process";
 import { resolveHomeDir } from "./paths.js";
 import { canUseOrchestratorShell } from "./ink/orchestrator-state.js";
 import { runOrchestratorInk as defaultRunOrchestratorInk } from "./ink/run-orchestrator-ink.js";
+import { createFullscreenSession } from "./ink/fullscreen-session.js";
 import { formatCliCommand } from "./brand/cli.js";
 import { BRAND } from "./brand/index.js";
 import { buildReadOnlyDiagnostics, shouldExecutePlan } from "./action-planner.js";
+import { runHarnessSetup as defaultRunHarnessSetup } from "./setup.js";
+import {
+  INITIAL_EXPERIENCE,
+  hasConfiguredGlobalState
+} from "./initial-experience.js";
 
 export { canUseOrchestratorShell };
 
@@ -23,7 +29,12 @@ export async function runOrchestratorShell({
   packageManifest,
   workspaceRoot,
   interactive = Boolean(input.isTTY && output.isTTY),
-  runOrchestratorInkImpl = defaultRunOrchestratorInk
+  initialMode = INITIAL_EXPERIENCE.DASHBOARD,
+  shellCapable = canUseOrchestratorShell({ interactive }),
+  runOrchestratorInkImpl = defaultRunOrchestratorInk,
+  runHarnessSetupImpl = defaultRunHarnessSetup,
+  fullscreenSession = null,
+  stdout = output
 }) {
   if (!interactive) {
     throw new Error(
@@ -31,30 +42,75 @@ export async function runOrchestratorShell({
     );
   }
 
-  if (!canUseOrchestratorShell({ interactive })) {
+  if (!shellCapable) {
     throw new Error(
       `Interactive shell requires a capable TTY. Use ${formatCliCommand("runs list")} or explicit commands.`
     );
   }
 
   const homeDir = resolveHomeDir();
-  const outcome = await runOrchestratorInkImpl({
-    homeDir,
-    workspaceRoot,
-    packageRoot,
-    packageName: packageManifest.name,
-    cliVersion: packageManifest.version
+  const ownsSession = !fullscreenSession;
+  const session = fullscreenSession ?? createFullscreenSession({
+    stdout,
+    enabled: Boolean(stdout?.isTTY)
   });
 
-  if (outcome.error) {
-    throw outcome.error;
+  if (ownsSession) {
+    session.enter();
   }
 
-  return {
-    cancelled: Boolean(outcome.cancelled),
-    wrote: false,
-    action: outcome.action ?? null
-  };
+  let setupOutcome = null;
+
+  try {
+    if (initialMode === INITIAL_EXPERIENCE.ONBOARDING) {
+      setupOutcome = await runHarnessSetupImpl({
+        packageRoot,
+        packageName: packageManifest.name,
+        cliVersion: packageManifest.version,
+        homeDir,
+        workspaceRoot,
+        onboarding: true,
+        interactive: true,
+        fullscreenSession: session
+      });
+
+      if (setupOutcome?.cancelled) {
+        return {
+          cancelled: true,
+          wrote: false,
+          action: null,
+          initialMode,
+          setup: setupOutcome
+        };
+      }
+    }
+
+    const outcome = await runOrchestratorInkImpl({
+      homeDir,
+      workspaceRoot,
+      packageRoot,
+      packageName: packageManifest.name,
+      cliVersion: packageManifest.version,
+      hasGlobalState: hasConfiguredGlobalState(homeDir),
+      fullscreenSession: session
+    });
+
+    if (outcome.error) {
+      throw outcome.error;
+    }
+
+    return {
+      cancelled: Boolean(outcome.cancelled),
+      wrote: Boolean(setupOutcome && !setupOutcome.cancelled),
+      action: outcome.action ?? null,
+      initialMode,
+      setup: setupOutcome
+    };
+  } finally {
+    if (ownsSession) {
+      session.leave();
+    }
+  }
 }
 
 export async function runOrchestratorDiagnostics({

package/src/global/setup.js

@@ -1,5 +1,5 @@
 import { stdin as input, stdout as output } from "node:process";
-import { BRAND } from "./brand/index.js";
+import { BRAND, ONBOARDING_COPY } from "./brand/index.js";
 import { installGlobalHarness } from "./global-installer.js";
 import {
   assertExplicitApplyConsent,
@@ -59,11 +59,13 @@ export async function runHarnessSetup({
   confirmExplicit = false,
   json = false,
   simple = false,
+  onboarding = false,
   interactive = Boolean(input.isTTY && output.isTTY),
   createPrompt = createReadlinePrompt,
   runSetupInkImpl = defaultRunSetupInk,
   runSetupWizardImpl = defaultRunSetupWizard,
-  inkCapable = canUseSetupInk({ interactive })
+  inkCapable = canUseSetupInk({ interactive }),
+  fullscreenSession = null
 }) {
   const routing = { interactive, simple, inkCapable, dryRun, yes, confirm, json, agents, components, noDefaultComponents };
   const useInk = evaluateSetupInk(routing);
@@ -76,7 +78,7 @@ export async function runHarnessSetup({
   let usedInk = false;
 
   if (!useInk && !useWizard) {
-    printSetupIntro({ homeDir });
+    printSetupIntro({ homeDir, onboarding });
   }
 
   const setupUiArgs = {
@@ -86,13 +88,15 @@ export async function runHarnessSetup({
     packageName,
     cliVersion,
     dryRun,
+    onboarding,
     preflight,
     yes,
     confirm,
     preflightExplicit,
     yesExplicit,
     confirmExplicit,
-    interactive
+    interactive,
+    fullscreenSession
   };
 
   if (useInk) {
@@ -254,11 +258,17 @@ export async function runHarnessSetup({
   return { cancelled: false, result, usedWizard, usedInk };
 }
 
-function printSetupIntro({ homeDir }) {
+function printSetupIntro({ homeDir, onboarding = false }) {
   const detected = detectInstalledAdapters({ homeDir });
 
-  console.log(`${BRAND.displayName} setup — local AI ecosystem configurator`);
-  console.log("Configures and coordinates local agents. Does not install the AI apps themselves.");
+  if (onboarding) {
+    console.log(ONBOARDING_COPY.welcomeTitle);
+    console.log(ONBOARDING_COPY.purpose);
+    console.log(ONBOARDING_COPY.safety);
+  } else {
+    console.log(`${BRAND.displayName} setup — local AI ecosystem configurator`);
+    console.log("Configures and coordinates local agents. Does not install the AI apps themselves.");
+  }
   console.log("");
   console.log(`Detected agents: ${detected.join(", ") || "none"}`);
   console.log(`Supported agents: ${GLOBAL_AGENT_IDS.join(", ")}`);