@kal-elsam/kairo-runtime 0.3.0 → 0.4.0

package/src/global/ink/cockpit-focus.js

@@ -0,0 +1,92 @@
+import { COCKPIT_NAV, COCKPIT_REGIONS, regionsForLayout } from "./cockpit-models.js";
+import { ORCHESTRATOR_VIEWS } from "./orchestrator-state.js";
+import { LAYOUT_MODES } from "./layout.js";
+
+const NAV_FOCUSED_VIEWS = new Set([
+  ORCHESTRATOR_VIEWS.HOME,
+  ORCHESTRATOR_VIEWS.PROVIDERS,
+  ORCHESTRATOR_VIEWS.DIAGNOSTICS,
+  ORCHESTRATOR_VIEWS.HELP
+]);
+
+const CONTENT_INTERACTIVE_VIEWS = new Set([
+  ORCHESTRATOR_VIEWS.ACTIVE_RUNS,
+  ORCHESTRATOR_VIEWS.RECENT_RUNS,
+  ORCHESTRATOR_VIEWS.RUN_DETAIL,
+  ORCHESTRATOR_VIEWS.LAUNCH
+]);
+
+export function isNavFocusedView(view) {
+  return NAV_FOCUSED_VIEWS.has(view);
+}
+
+export function isContentInteractiveView(view) {
+  return CONTENT_INTERACTIVE_VIEWS.has(view);
+}
+
+export function defaultRegionForView(view, layoutMode = LAYOUT_MODES.COMPACT) {
+  const regions = regionsForLayout(layoutMode);
+  if (isContentInteractiveView(view) && regions.includes(COCKPIT_REGIONS.CONTENT)) {
+    return COCKPIT_REGIONS.CONTENT;
+  }
+  if (regions.includes(COCKPIT_REGIONS.NAV)) return COCKPIT_REGIONS.NAV;
+  return regions[0] ?? COCKPIT_REGIONS.CONTENT;
+}
+
+export function interactiveRegionsFor(state) {
+  const regions = regionsForLayout(state.layoutMode);
+  if (!isContentInteractiveView(state.view) || state.view === ORCHESTRATOR_VIEWS.RUN_DETAIL) {
+    return regions.filter((region) => region === COCKPIT_REGIONS.NAV);
+  }
+  return regions.filter(
+    (region) => region === COCKPIT_REGIONS.NAV || region === COCKPIT_REGIONS.CONTENT
+  );
+}
+
+export function canTabBetweenRegions(state) {
+  if (!isContentInteractiveView(state.view)) return false;
+  if (state.view === ORCHESTRATOR_VIEWS.RUN_DETAIL) return false;
+  return interactiveRegionsFor(state).length >= 2;
+}
+
+/**
+ * Map raw key intent to a reducer action (or null when inactive / view-owned).
+ */
+export function routeCockpitKey(state, keyAction) {
+  switch (keyAction.type) {
+    case "escape":
+      return { type: "escape" };
+    case "tab":
+      return canTabBetweenRegions(state) ? { type: "tab" } : null;
+    case "arrow": {
+      if (state.region === COCKPIT_REGIONS.SYSTEM) return null;
+      if (state.region === COCKPIT_REGIONS.NAV || isNavFocusedView(state.view)) {
+        return { type: "arrow", direction: keyAction.direction };
+      }
+      if (state.region === COCKPIT_REGIONS.CONTENT && isContentInteractiveView(state.view)) {
+        if (state.view === ORCHESTRATOR_VIEWS.RUN_DETAIL || state.view === ORCHESTRATOR_VIEWS.LAUNCH) {
+          return null;
+        }
+        return {
+          type: "arrow",
+          direction: keyAction.direction,
+          listLength: keyAction.listLength
+        };
+      }
+      return null;
+    }
+    case "enter":
+      if (state.region === COCKPIT_REGIONS.NAV || isNavFocusedView(state.view)) {
+        return { type: "enter-nav" };
+      }
+      return null;
+    default:
+      return null;
+  }
+}
+
+export function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, value));
+}
+
+export { COCKPIT_NAV, COCKPIT_REGIONS, LAYOUT_MODES, ORCHESTRATOR_VIEWS, regionsForLayout };

package/src/global/ink/cockpit-home.js

@@ -0,0 +1,115 @@
+import { ORCHESTRATOR_VIEWS } from "./orchestrator-state.js";
+import {
+  DASHBOARD_PURPOSE,
+  resolveDashboardRecommendation,
+  resolveProjectReadiness
+} from "../dashboard-guidance.js";
+import { LAYOUT_MODES } from "./layout.js";
+
+export function formatHomeRecentRun(run) {
+  if (!run) return null;
+  const agent = humanizeId(run.agentId);
+  const result = humanizeRunState(run.state);
+  return {
+    headline: `Last run · ${agent} · ${result}`,
+    hint: "Open History to inspect the result."
+  };
+}
+
+export function buildHomeMissionModel({
+  projectName = "project",
+  hasGlobalState = false,
+  diagnostics = null,
+  dashboard = null,
+  layoutMode = LAYOUT_MODES.COMPACT,
+  recentRuns = null
+} = {}) {
+  const readiness = resolveProjectReadiness({ hasGlobalState, diagnostics, dashboard });
+  const recommendation = resolveDashboardRecommendation({
+    hasGlobalState,
+    diagnostics,
+    dashboard
+  });
+  const runs = recentRuns ?? dashboard?.recentRuns ?? [];
+  const lastRun = formatHomeRecentRun(runs[0] ?? null);
+  const includeEmbeddedStatus = layoutMode !== LAYOUT_MODES.WIDE;
+
+  return {
+    title: `HOME — ${projectName}`,
+    purpose: DASHBOARD_PURPOSE,
+    readiness,
+    includeEmbeddedStatus,
+    next: {
+      title: "NEXT",
+      actionTitle: recommendation.title,
+      actionDetail: recommendation.detail ?? recommendation.message,
+      enterHint: "Enter →",
+      kind: recommendation.kind,
+      targetView: recommendation.targetView,
+      targetAction: recommendation.targetAction,
+      message: recommendation.message
+    },
+    recent: lastRun
+      ? {
+        title: "RECENT",
+        headline: lastRun.headline,
+        hint: lastRun.hint,
+        emptyHint: null
+      }
+      : {
+        title: "RECENT",
+        headline: null,
+        hint: null,
+        emptyHint: "No runs yet. Create a new run when an agent is ready."
+      },
+    explore: {
+      title: "EXPLORE",
+      lines: [
+        "Agents — See which installed tools Kairo can launch and audit.",
+        "System health — Inspect intelligence, authentication, and configuration."
+      ]
+    },
+    recommendedTitle: recommendation.title,
+    recommendedAction: recommendation.message,
+    recommendedKind: recommendation.kind,
+    recommendedTargetView: recommendation.targetView,
+    recommendedTargetAction: recommendation.targetAction,
+    emptyHint: lastRun ? null : "No runs yet. Create a new run when an agent is ready."
+  };
+}
+
+export function openRecommendedDestination(recommendation, { navItems } = {}) {
+  if (!recommendation?.targetView) return null;
+  const index = (navItems ?? []).findIndex((item) => item.view === recommendation.targetView
+    || (recommendation.targetAction && item.action === recommendation.targetAction));
+  return {
+    view: recommendation.targetView,
+    action: recommendation.targetAction ?? null,
+    navIndex: index >= 0 ? index : null
+  };
+}
+
+function humanizeId(value) {
+  const raw = String(value ?? "agent");
+  return raw.charAt(0).toUpperCase() + raw.slice(1);
+}
+
+function humanizeRunState(state) {
+  switch (state) {
+    case "succeeded":
+    case "completed":
+      return "Succeeded";
+    case "failed":
+      return "Failed";
+    case "cancelled":
+    case "canceled":
+      return "Cancelled";
+    case "running":
+    case "starting":
+      return "Running";
+    default:
+      return humanizeId(state);
+  }
+}
+
+export { ORCHESTRATOR_VIEWS };

package/src/global/ink/cockpit-models.js

@@ -1,9 +1,9 @@
-import { LAYOUT_MODES } from "./layout.js";
+import { LAYOUT_MODES, resolveListLimit } from "./layout.js";
 import { ORCHESTRATOR_VIEWS } from "./orchestrator-state.js";
-import { resolveDashboardRecommendation } from "../dashboard-guidance.js";
+import { resolveProjectReadiness } from "../dashboard-guidance.js";
 import { STATUS_LABELS, resolveGlyphs } from "./theme.js";
 import { windowList } from "./list-window.js";
-import { resolveListLimit } from "./layout.js";
+import { buildHomeMissionModel, formatHomeRecentRun } from "./cockpit-home.js";
 
 export const COCKPIT_REGIONS = {
   NAV: "nav",
@@ -12,12 +12,43 @@ export const COCKPIT_REGIONS = {
 };
 
 export const COCKPIT_NAV = [
-  { id: "overview", label: "Overview", view: ORCHESTRATOR_VIEWS.HOME },
-  { id: "active", label: "Active runs", view: ORCHESTRATOR_VIEWS.ACTIVE_RUNS },
-  { id: "recent", label: "Recent runs", view: ORCHESTRATOR_VIEWS.RECENT_RUNS },
-  { id: "providers", label: "Providers", view: ORCHESTRATOR_VIEWS.PROVIDERS },
-  { id: "launch", label: "Launch run", view: ORCHESTRATOR_VIEWS.LAUNCH, action: "launch" },
-  { id: "diagnostics", label: "Diagnostics", view: ORCHESTRATOR_VIEWS.DIAGNOSTICS }
+  {
+    id: "overview",
+    label: "Home",
+    view: ORCHESTRATOR_VIEWS.HOME,
+    description: "What Kairo does here, readiness, and the next useful action."
+  },
+  {
+    id: "active",
+    label: "Running now",
+    view: ORCHESTRATOR_VIEWS.ACTIVE_RUNS,
+    description: "Supervised runs executing right now."
+  },
+  {
+    id: "recent",
+    label: "History",
+    view: ORCHESTRATOR_VIEWS.RECENT_RUNS,
+    description: "Past runs with agent, state, and readable result."
+  },
+  {
+    id: "providers",
+    label: "Agents",
+    view: ORCHESTRATOR_VIEWS.PROVIDERS,
+    description: "Installed tools Kairo can launch and audit."
+  },
+  {
+    id: "launch",
+    label: "New run",
+    view: ORCHESTRATOR_VIEWS.LAUNCH,
+    action: "launch",
+    description: "Delegate a task to an executable agent."
+  },
+  {
+    id: "diagnostics",
+    label: "System health",
+    view: ORCHESTRATOR_VIEWS.DIAGNOSTICS,
+    description: "Agents, intelligence, authentication, and configuration."
+  }
 ];
 
 export function regionsForLayout(layoutMode) {
@@ -30,6 +61,11 @@ export function regionsForLayout(layoutMode) {
   return [COCKPIT_REGIONS.CONTENT];
 }
 
+export function navIndexForView(view, items = COCKPIT_NAV) {
+  const index = items.findIndex((item) => item.view === view);
+  return index >= 0 ? index : 0;
+}
+
 export function buildTopBarModel({
   projectName = "project",
   systemOnline = true,
@@ -46,28 +82,73 @@ export function buildTopBarModel({
   };
 }
 
+export function resolveNavStatusSummary(item, { dashboard = null, diagnostics = null } = {}) {
+  const active = dashboard?.activeRuns?.length ?? 0;
+  const recent = dashboard?.recentRuns?.length ?? 0;
+  const providers = dashboard?.providers ?? [];
+  const launchable = providers.filter((entry) => entry.launchable).length;
+  const detected = diagnostics?.diagnostics?.detected ?? providers.filter((p) => p.available).length;
+  const errors = diagnostics?.diagnostics?.errors ?? 0;
+
+  switch (item.id) {
+    case "overview":
+      return resolveProjectReadiness({
+        hasGlobalState: true,
+        diagnostics,
+        dashboard
+      }).label;
+    case "active":
+      return active === 0 ? "Idle" : `${active} active`;
+    case "recent":
+      return recent === 0 ? "No history" : `${recent} recent`;
+    case "providers":
+      return `${launchable}/${providers.length || detected} ready`;
+    case "launch":
+      return launchable > 0 ? "Ready" : "Unavailable";
+    case "diagnostics":
+      return errors > 0 ? `${errors} issues` : "Checked";
+    default:
+      return "";
+  }
+}
+
 export function buildNavModel({
   navIndex = 0,
+  currentView = ORCHESTRATOR_VIEWS.HOME,
   focused = false,
   unicode = true,
-  items = COCKPIT_NAV
+  items = COCKPIT_NAV,
+  dashboard = null,
+  diagnostics = null
 } = {}) {
   const glyphs = resolveGlyphs(unicode);
+  const selected = items[navIndex] ?? items[0];
+  const mapped = items.map((item, index) => {
+    const isSelected = index === navIndex;
+    const isCurrent = item.view === currentView;
+    return {
+      ...item,
+      marker: isSelected ? glyphs.focus : (isCurrent ? glyphs.bullet : " "),
+      selected: isSelected,
+      current: isCurrent,
+      focused: focused && isSelected,
+      statusSummary: resolveNavStatusSummary(item, { dashboard, diagnostics })
+    };
+  });
+
   return {
     title: "NAVIGATION",
-    items: items.map((item, index) => ({
-      ...item,
-      marker: index === navIndex ? glyphs.focus : " ",
-      selected: index === navIndex,
-      focused: focused && index === navIndex
-    }))
+    explanation: selected
+      ? `${selected.description} (${resolveNavStatusSummary(selected, { dashboard, diagnostics })})`
+      : "",
+    items: mapped
   };
 }
 
 export function buildSystemStripModel({
   dashboard = null,
   diagnostics = null,
-  healthKind = "ready"
+  readiness = null
 } = {}) {
   const agentsDetected = diagnostics?.diagnostics?.detected
     ?? (dashboard?.providers ?? []).filter((p) => p.available).length;
@@ -81,6 +162,11 @@ export function buildSystemStripModel({
     : intelligence?.cloudAuthenticated
       ? "Cloud"
       : "None";
+  const resolved = readiness ?? resolveProjectReadiness({
+    hasGlobalState: agentsDetected > 0,
+    diagnostics,
+    dashboard
+  });
 
   return {
     title: "SYSTEM",
@@ -88,62 +174,76 @@ export function buildSystemStripModel({
       { key: "Agents", value: `${agentsDetected}/${agentsTotal}`, kind: agentsDetected > 0 ? "ready" : "warn" },
       { key: "Runs", value: String(activeRuns), kind: activeRuns > 0 ? "ready" : "muted" },
       { key: "Intel", value: intelLabel, kind: intelLabel === "None" ? "warn" : "ready" },
-      { key: "Health", value: STATUS_LABELS[healthKind] ?? healthKind, kind: healthKind }
+      {
+        key: "Health",
+        value: STATUS_LABELS[resolved.kind] ?? resolved.label ?? resolved.kind,
+        kind: resolved.healthKind ?? "warn"
+      }
     ]
   };
 }
 
-export function buildHomeMissionModel({
-  hasGlobalState = false,
-  diagnostics = null,
-  dashboard = null,
-  layoutMode = LAYOUT_MODES.COMPACT,
-  activityLines = []
-} = {}) {
-  const recommendation = resolveDashboardRecommendation({
-    hasGlobalState,
-    diagnostics,
-    dashboard
-  });
-  const limit = resolveListLimit(layoutMode, { contentRows: 10 });
-  const windowed = windowList(activityLines, limit);
-
-  return {
-    title: "MISSION CONTROL",
-    recommendedTitle: "Recommended action",
-    recommendedAction: recommendation.message,
-    recommendedKind: recommendation.kind,
-    activityTitle: activityLines.length ? "Activity" : "Activity / empty state",
-    activityLines: windowed.items,
-    moreLine: windowed.moreLine,
-    emptyHint: activityLines.length === 0
-      ? "No recent activity. Launch a run when agents are ready."
-      : null
-  };
-}
-
 export function buildFooterModel({
   view = ORCHESTRATOR_VIEWS.HOME,
   region = COCKPIT_REGIONS.NAV,
   helpOpen = false,
   canCancel = false,
-  unicode = true
+  unicode = true,
+  hasError = false
 } = {}) {
   const glyphs = resolveGlyphs(unicode);
-  if (helpOpen) {
-    return {
-      text: `Esc close help ${glyphs.bullet} R refresh ${glyphs.bullet} C cancel run`
-    };
+  const parts = [];
+
+  if (hasError) {
+    parts.push("R Retry");
+    parts.push("Esc Exit");
+    return { text: parts.join(` ${glyphs.bullet} `) };
   }
-  if (view === ORCHESTRATOR_VIEWS.HOME) {
-    return {
-      text: `↑↓ Navigate ${glyphs.bullet} Tab Region ${glyphs.bullet} Enter Open ${glyphs.bullet} ? Help ${glyphs.bullet} Esc Exit`
-    };
+
+  if (helpOpen || view === ORCHESTRATOR_VIEWS.HELP) {
+    parts.push("Esc close help");
+    parts.push("? Help");
+    return { text: parts.join(` ${glyphs.bullet} `) };
   }
-  const cancel = canCancel ? ` ${glyphs.bullet} C cancel` : "";
-  return {
-    text: `↑↓ Navigate ${glyphs.bullet} Enter Open ${glyphs.bullet} R refresh${cancel} ${glyphs.bullet} Esc Back · focus:${region}`
-  };
+
+  if (view === ORCHESTRATOR_VIEWS.RUN_DETAIL) {
+    parts.push("R refresh");
+    if (canCancel) parts.push("C cancel");
+    parts.push("Esc Back");
+    return { text: parts.join(` ${glyphs.bullet} `) };
+  }
+
+  parts.push("↑↓ Navigate");
+
+  const showTab = view === ORCHESTRATOR_VIEWS.ACTIVE_RUNS
+    || view === ORCHESTRATOR_VIEWS.RECENT_RUNS
+    || view === ORCHESTRATOR_VIEWS.LAUNCH;
+  if (showTab) {
+    parts.push("Tab Region");
+  }
+
+  if (view === ORCHESTRATOR_VIEWS.HOME
+    || view === ORCHESTRATOR_VIEWS.PROVIDERS
+    || view === ORCHESTRATOR_VIEWS.DIAGNOSTICS
+    || region === COCKPIT_REGIONS.NAV
+    || view === ORCHESTRATOR_VIEWS.ACTIVE_RUNS
+    || view === ORCHESTRATOR_VIEWS.RECENT_RUNS) {
+    parts.push("Enter Open");
+  }
+
+  if (view !== ORCHESTRATOR_VIEWS.LAUNCH) {
+    parts.push("R refresh");
+  }
+
+  parts.push("? Help");
+  parts.push(view === ORCHESTRATOR_VIEWS.HOME ? "Esc Exit" : "Esc Back");
+
+  return { text: parts.join(` ${glyphs.bullet} `) };
+}
+
+export function windowLinesForLayout(lines = [], layoutMode = LAYOUT_MODES.COMPACT, contentRows = 12) {
+  const limit = resolveListLimit(layoutMode, { contentRows });
+  return windowList(lines, limit);
 }
 
 export function resolveProjectName(workspaceRoot = "") {
@@ -151,3 +251,5 @@ export function resolveProjectName(workspaceRoot = "") {
   const parts = String(workspaceRoot).split(/[/\\]/).filter(Boolean);
   return parts[parts.length - 1] || "project";
 }
+
+export { buildHomeMissionModel, formatHomeRecentRun };