@kal-elsam/kairo-runtime 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -5,6 +5,20 @@ Historical entries below may reference the legacy `@kal-elsam/harness` package n
 
 ## Unreleased
 
+## 0.21.0 — 2026-09-18 (Kairo Runtime)
+
+Patch-level polish. When a role resolves to a manual-only provider
+(OpenCode Go), the `planExecution` preview now carries the exact
+real task text an automatic run would use, and the cockpit pushes it
+into the transcript ready to paste into that provider's own chat —
+instead of only naming the assigned model.
+
+### Added
+
+- `buildExecutionTaskPrompt` (service.js) is the one real formula for a
+  task's launch text, shared by `executePlan` (real automatic runs)
+  and `planExecution`'s `MANUAL_HANDOFF` preview (`taskPrompt`).
+
 ## 0.20.0 — 2026-09-18 (Kairo Runtime)
 
 Minor release. Promotes Cursor to a real automatic execution provider.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kal-elsam/kairo-runtime",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Kairo Runtime — local agent operating system for Codex, Cursor, Claude, Pi, Engram, and Graphify.",
   "type": "module",
   "homepage": "https://github.com/Kal-elSam/harness#readme",

package/src/global/cockpit/app.js

@@ -190,6 +190,16 @@ export async function runCockpitApp({
         return runAction("Asking PROJECT TEAM who should execute this", async () => {
           const decision = await service.planExecution({ cwd, taskId, role });
           view.showExecuteConfirm(taskId, decision);
+          // MANUAL_HANDOFF: Kairo can't launch this itself, so the real
+          // task text (the exact same one an automatic run would get —
+          // see service.js's buildExecutionTaskPrompt) goes into the
+          // transcript, ready to paste into the assigned provider's own
+          // chat — never just naming the model and leaving the human to
+          // reconstruct the prompt themselves.
+          if (decision.decision === "MANUAL_HANDOFF" && decision.taskPrompt) {
+            const modelLabel = decision.modelRef?.displayName ?? decision.model ?? "the assigned model";
+            pushTranscript("kairo", `${decision.provider} · ${modelLabel} can't be launched automatically — paste this into its chat:\n\n${decision.taskPrompt}`);
+          }
         });
       },
       onExecute: (taskId, decision) => {

package/src/global/conversation/service.js

@@ -367,6 +367,24 @@ export function createConversationService(deps = {}) {
 
   async function root(cwd) { return resolveRoot(cwd); }
 
+  /**
+   * The exact real task text an automatic run gets launched with (see
+   * executePlan) — the ONE real formula, never a second one invented for
+   * display purposes. Reused by toExecutionPreview so a MANUAL_HANDOFF
+   * preview can hand the human this same text, ready to paste into the
+   * manual-only provider's own chat, instead of just naming the model.
+   * @param {string} planMarkdown
+   */
+  function buildExecutionTaskPrompt(planMarkdown) {
+    return [
+      "Implement the explicitly approved architecture plan below.",
+      "Follow repository AGENTS.md and Gentle governance. Do not treat plan approval as any additional governance receipt.",
+      "Use safe, non-bypassed permissions for this session.",
+      "",
+      planMarkdown
+    ].join("\n");
+  }
+
   /**
    * Projects a real project-router decision into the public
    * ProjectExecutionPreview shape — never recalculates anything the
@@ -380,20 +398,28 @@ export function createConversationService(deps = {}) {
    * - Everything else (MANUAL_HANDOFF, or WAIT_FOR_PROJECT_TEAM with no
    *   real alternative): null — nothing to confirm into an automatic run.
    * @param {ReturnType<typeof resolveProjectRoute>} route
+   * @param {{planMarkdown: string}|null} [record] - present only from
+   *   planExecution (which already read the real plan record); used to
+   *   attach `taskPrompt` for a MANUAL_HANDOFF decision only — a ROUTED/
+   *   WAIT_FOR_PROJECT_TEAM preview never needs it, since executePlan
+   *   builds the real task text itself from the SAME buildExecutionTaskPrompt.
    */
-  function toExecutionPreview(route) {
+  function toExecutionPreview(route, record = null) {
     let confirmationTarget = null;
     if (route.decision === "ROUTED" && route.model) {
       confirmationTarget = { role: route.role, selection: "assigned", strategyFingerprint: route.strategyFingerprint, candidateKey: route.model.candidateKey ?? null };
     } else if (route.decision === "WAIT_FOR_PROJECT_TEAM" && route.suggestedAlternative?.model) {
       confirmationTarget = { role: route.role, selection: "suggested-alternative", strategyFingerprint: route.strategyFingerprint, candidateKey: route.suggestedAlternative.model.candidateKey ?? null };
     }
+    const taskPrompt = route.decision === "MANUAL_HANDOFF" && record?.planMarkdown
+      ? buildExecutionTaskPrompt(record.planMarkdown)
+      : null;
     return {
       decision: route.decision, role: route.role,
       provider: route.provider, model: route.model?.modelId ?? null, modelRef: route.model,
       assignmentSource: route.assignmentSource, strategyFingerprint: route.strategyFingerprint, why: route.why,
       blockedAssignment: route.blockedAssignment, suggestedAlternative: route.suggestedAlternative,
-      confirmationTarget
+      confirmationTarget, taskPrompt
     };
   }
 
@@ -961,7 +987,7 @@ export function createConversationService(deps = {}) {
       const record = await readPlan(projectRoot, taskId);
       if (!record) throw new Error(`Plan "${taskId}" not found.`);
       const route = await this.routeProjectExecution(role, projectRoot);
-      return { ...toExecutionPreview(route), projectRoot, taskId };
+      return { ...toExecutionPreview(route, record), projectRoot, taskId };
     },
     /**
      * @param {object} args
@@ -1010,13 +1036,7 @@ export function createConversationService(deps = {}) {
         if (!raced) throw error;
         return { ...publicPlan(record, raced), projectRoot, reused: true };
       }
-      const task = [
-        "Implement the explicitly approved architecture plan below.",
-        "Follow repository AGENTS.md and Gentle governance. Do not treat plan approval as any additional governance receipt.",
-        "Use safe, non-bypassed permissions for this session.",
-        "",
-        record.planMarkdown
-      ].join("\n");
+      const task = buildExecutionTaskPrompt(record.planMarkdown);
       try {
         const started = await launchRun({
           homeDir, runId, agentId: resolvedAgentId, task, cwd: projectRoot, model: resolvedModel,

package/src/global/observability/codex-models.js

@@ -89,7 +89,7 @@ export async function readCodexModels({
     child.once?.("close", () => { if (!finished) finish(unknown("codex app-server closed before model list")); });
 
     writeRequest(child, 1, "initialize", {
-      clientInfo: { name: "kairo", title: "Kairo", version: "0.20.0" },
+      clientInfo: { name: "kairo", title: "Kairo", version: "0.21.0" },
       capabilities: {}
     });
   });

package/src/global/observability/codex-usage.js

@@ -151,7 +151,7 @@ export async function readCodexUsage({
     child.once?.("close", () => { if (!finished) finish(unknown("codex app-server closed before rate limits")); });
 
     writeRequest(child, 1, "initialize", {
-      clientInfo: { name: "kairo", title: "Kairo", version: "0.20.0" },
+      clientInfo: { name: "kairo", title: "Kairo", version: "0.21.0" },
       capabilities: {}
     });
   });