@kontextmind/kxm 0.7.24 → 0.7.26

package/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "kxm",
       "source": "./plugins/kxm",
       "description": "Durable workflows, peer agents, and kxm tui",
-      "version": "0.7.24",
+      "version": "0.7.26",
       "category": "development",
       "tags": ["kxm", "multi-agent", "workflows", "mcp"]
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontextmind/kxm",
-  "version": "0.7.24",
+  "version": "0.7.26",
   "description": "KXM local-first multi-agent orchestration and operator dashboard",
   "type": "module",
   "author": "KontextMind",

package/plugins/kxm/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "kxm",
   "displayName": "KXM",
-  "version": "0.7.24",
+  "version": "0.7.26",
   "description": "Headless multi-agent orchestration, durable workflows, and a live operator dashboard for Pi and Claude Code",
   "author": {
     "name": "KontextMind",

package/plugins/kxm/dist/cli.js

@@ -33642,6 +33642,9 @@ ${RUN_ENGINE_NOTICE}`);
     return 1;
   }
 }
+function formatCancelledStatus(reason) {
+  return reason.length > 0 ? `cancelled (${reason})` : "cancelled";
+}
 function formatDriveStatusLine(runStatus, drive) {
   if (!drive || typeof drive.driveId !== "string" || drive.driveId.length === 0) return void 0;
   const receipt = drive.receipt ?? null;
@@ -33659,11 +33662,20 @@ function formatDriveStatusLine(runStatus, drive) {
   if (kind === "handoff") {
     return drive.verified === true ? `drive ${drive.driveId}: handoff (receipt verified)` : `drive ${drive.driveId}: handoff`;
   }
+  if (receipt.settlement?.status === "cancelled") {
+    const label = formatCancelledStatus(reason);
+    return drive.verified === true ? `drive ${drive.driveId}: ${label} (receipt verified)` : `drive ${drive.driveId}: ${label}`;
+  }
   if (drive.verified === true) {
     return `drive ${drive.driveId}: completed (receipt verified)`;
   }
   return `drive ${drive.driveId}: completed`;
 }
+function formatRunStatusLine(run, drive) {
+  const reason = typeof drive?.receipt?.settlement?.reason === "string" ? drive.receipt.settlement.reason : "";
+  const statusLabel = run.status === "cancelled" ? formatCancelledStatus(reason) : run.status;
+  return `run ${run.runId}: ${statusLabel} (workflow ${run.workflowId}, updated ${run.updatedAt})`;
+}
 async function cmdVnextRunStatus(runtime, runId) {
   try {
     const projectRoot = discoverVnextProjectRoot(runtime.cwd);
@@ -33680,7 +33692,7 @@ async function cmdVnextRunStatus(runtime, runId) {
       runtime.io,
       runtime.json,
       { ok: true, command: "runs status", run, ...drive !== void 0 ? { drive } : {} },
-      `run ${run.runId}: ${run.status} (workflow ${run.workflowId}, updated ${run.updatedAt})${driveLine ? `
+      `${formatRunStatusLine(run, drive)}${driveLine ? `
 ${driveLine}` : ""}`
     );
     return 0;
@@ -33693,7 +33705,21 @@ ${driveLine}` : ""}`
     return 1;
   }
 }
-async function cmdVnextRunDrive(runtime, runId, simulated) {
+var DEFAULT_DRIVE_WAIT_MS = 6e4;
+var MAX_DRIVE_WAIT_MS = 6e5;
+function parseDriveWaitTimeoutMs(raw) {
+  if (raw === void 0) return DEFAULT_DRIVE_WAIT_MS;
+  const value = typeof raw === "number" ? raw : Number(typeof raw === "string" ? raw.trim() : raw);
+  if (!Number.isInteger(value) || value < 1 || value > MAX_DRIVE_WAIT_MS) return void 0;
+  return value;
+}
+function sleepMs(ms) {
+  return new Promise((resolve31) => setTimeout(resolve31, ms));
+}
+function driveWaitCompleted(drive) {
+  return drive?.verified === true && drive.receipt?.settlement?.kind === "terminal" && drive.receipt.settlement.status === "completed";
+}
+async function cmdVnextRunDrive(runtime, runId, simulated, options = {}) {
   try {
     const projectRoot = discoverVnextProjectRoot(runtime.cwd);
     if (!projectRoot) {
@@ -33705,8 +33731,19 @@ async function cmdVnextRunDrive(runtime, runId, simulated) {
       print(runtime.io, runtime.json, { ok: true, command: "runs drive", dryRun: true, runId, mode }, `drive plan: run ${runId} in ${mode} mode (no events written)`);
       return 0;
     }
+    const timeoutMs = options.wait === true ? parseDriveWaitTimeoutMs(options.timeoutMs) : DEFAULT_DRIVE_WAIT_MS;
+    if (options.wait === true && timeoutMs === void 0) {
+      print(
+        runtime.io,
+        runtime.json,
+        { ok: false, command: "runs drive", error: "run_drive_timeout_invalid" },
+        `run drive --wait --timeout-ms must be an integer between 1 and ${MAX_DRIVE_WAIT_MS}`
+      );
+      return 1;
+    }
     const supervisor = await (vnextDriveCliSeams.ensureSupervisor ?? ensureVnextSupervisor)({ env: runtime.env });
-    const result = await (vnextDriveCliSeams.runtimeRequest ?? vnextRuntimeRequest)(supervisor, "POST", `/v1/runs/${encodeURIComponent(runId)}/drive?projectRoot=${encodeURIComponent(projectRoot)}`, { mode });
+    const request = vnextDriveCliSeams.runtimeRequest ?? vnextRuntimeRequest;
+    const result = await request(supervisor, "POST", `/v1/runs/${encodeURIComponent(runId)}/drive?projectRoot=${encodeURIComponent(projectRoot)}`, { mode });
     const driveId = result.driveId;
     const poll = result.poll;
     const status = result.status;
@@ -33714,13 +33751,36 @@ async function cmdVnextRunDrive(runtime, runId, simulated) {
       print(runtime.io, runtime.json, { ok: false, command: "runs drive", error: "run_drive_io_failed" }, "run drive failed because a local operation did not complete");
       return 1;
     }
-    print(
-      runtime.io,
-      runtime.json,
-      { ok: true, command: "runs drive", runId, driveId, poll, mode, status },
-      `drive ${driveId}: accepted (poll ${poll})`
-    );
-    return 0;
+    if (options.wait !== true) {
+      print(
+        runtime.io,
+        runtime.json,
+        { ok: true, command: "runs drive", runId, driveId, poll, mode, status },
+        `drive ${driveId}: accepted (poll ${poll})`
+      );
+      return 0;
+    }
+    const deadline = Date.now() + timeoutMs;
+    let interval = 25;
+    while (true) {
+      const stateResult = await request(supervisor, "GET", `/v1/runs/${encodeURIComponent(runId)}?projectRoot=${encodeURIComponent(projectRoot)}`);
+      const drive = stateResult.drive;
+      if (drive?.receipt) {
+        print(
+          runtime.io,
+          runtime.json,
+          { ok: driveWaitCompleted(drive), command: "runs drive", receipt: drive.receipt, verified: drive.verified === true },
+          JSON.stringify(drive.receipt, null, 2)
+        );
+        return driveWaitCompleted(drive) ? 0 : 1;
+      }
+      const remaining = deadline - Date.now();
+      if (remaining <= 0) break;
+      await sleepMs(Math.min(interval, remaining));
+      interval = Math.min(Math.floor(interval * 1.5), 250);
+    }
+    print(runtime.io, runtime.json, { ok: false, command: "runs drive", error: "timeout" }, "drive wait timed out");
+    return 1;
   } catch (error) {
     if (error instanceof VnextConfigError) {
       print(runtime.io, runtime.json, { ok: false, command: "runs drive", error: "run_drive_failed", issues: error.issues }, `run drive failed: ${error.message}`);
@@ -33908,6 +33968,45 @@ async function cmdVnextRuntime(runtime, action) {
     return 1;
   }
 }
+async function cmdVnextRunReceipt(runtime, runId, options = {}) {
+  try {
+    const projectRoot = discoverVnextProjectRoot(runtime.cwd);
+    if (!projectRoot) {
+      print(runtime.io, runtime.json, { ok: false, command: "runs receipt", error: "project_required" }, "kxm runs receipt requires a vNext project (run kxm init first)");
+      return 1;
+    }
+    const supervisor = await (vnextDriveCliSeams.ensureSupervisor ?? ensureVnextSupervisor)({ env: runtime.env });
+    const result = await (vnextDriveCliSeams.runtimeRequest ?? vnextRuntimeRequest)(
+      supervisor,
+      "GET",
+      `/v1/runs/${encodeURIComponent(runId)}/drive?projectRoot=${encodeURIComponent(projectRoot)}`
+    );
+    if (!Array.isArray(result.receipts)) {
+      print(runtime.io, runtime.json, { ok: false, command: "runs receipt", error: "run_receipt_io_failed" }, "run receipt failed because a local operation did not complete");
+      return 1;
+    }
+    const receipts = result.receipts;
+    if (receipts.length === 0) {
+      print(runtime.io, runtime.json, { ok: false, command: "runs receipt", error: "no_receipts" }, `run ${runId} has no drive receipts`);
+      return 1;
+    }
+    if (options.all === true) {
+      print(runtime.io, runtime.json, { ok: true, command: "runs receipt", receipts }, JSON.stringify(receipts, null, 2));
+      return 0;
+    }
+    const latest = receipts[0];
+    const settlement = latest && typeof latest === "object" && "settlement" in latest ? latest.settlement : latest;
+    print(runtime.io, runtime.json, { ok: true, command: "runs receipt", receipt: latest }, JSON.stringify(settlement, null, 2));
+    return 0;
+  } catch (error) {
+    if (error instanceof VnextConfigError) {
+      print(runtime.io, runtime.json, { ok: false, command: "runs receipt", error: "run_receipt_failed", issues: error.issues }, `run receipt failed: ${error.message}`);
+      return 1;
+    }
+    print(runtime.io, runtime.json, { ok: false, command: "runs receipt", error: "run_receipt_io_failed" }, "run receipt failed because a local operation did not complete");
+    return 1;
+  }
+}
 
 // plugins/kxm/src/cli/tasks.ts
 async function cmdSuggest(runtime, promptParts) {
@@ -48683,8 +48782,14 @@ function createProgram(ctx, result) {
   addGlobalOptions(runCmd.command("status").description("Show the projected status of a run, including durable drive receipt state (open / receipt verified / unsettled / orphaned)")).argument("<runId>", "Run id").action(async function runStatusAction(runId) {
     result.code = await cmdVnextRunStatus(runtimeFrom(ctx, this), runId);
   });
-  addGlobalOptions(runCmd.command("drive").description("Drive a run with an explicit model-free simulation")).argument("<runId>", "Run id").option("--simulated", "Use the model-free simulation producer").action(async function runDriveAction(runId, options) {
-    result.code = await cmdVnextRunDrive(runtimeFrom(ctx, this), runId, options.simulated === true);
+  addGlobalOptions(runCmd.command("drive").description("Drive a run with an explicit model-free simulation")).argument("<runId>", "Run id").option("--simulated", "Use the model-free simulation producer").option("--wait", "Wait until a drive receipt is recorded; exits 0 only for a VERIFIED COMPLETED settlement").option("--timeout-ms <n>", "Wait timeout in milliseconds (default 60000, max 600000)").action(async function runDriveAction(runId, options) {
+    result.code = await cmdVnextRunDrive(runtimeFrom(ctx, this), runId, options.simulated === true, {
+      wait: options.wait === true,
+      ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {}
+    });
+  });
+  addGlobalOptions(runCmd.command("receipt").description("Print the newest drive receipt for a run")).argument("<runId>", "Run id").option("--all", "Print the capped receipt list for the run").action(async function runReceiptAction(runId, options) {
+    result.code = await cmdVnextRunReceipt(runtimeFrom(ctx, this), runId, { all: options.all === true });
   });
   addGlobalOptions(runCmd.command("cancel").description("Durably request cancellation of a run")).argument("<runId>", "Run id").action(async function runCancelAction(runId) {
     result.code = await cmdVnextRunCancel(runtimeFrom(ctx, this), runId);

package/plugins/kxm/dist/mcp-server.js

@@ -17121,7 +17121,7 @@ async function deliverInboxNotification(messageId, delivered, notify) {
 }
 
 // plugins/kxm/src/mcp-server.ts
-var VERSION = "0.7.24";
+var VERSION = "0.7.26";
 var inbox = /* @__PURE__ */ new Map();
 var notifiedInbox = /* @__PURE__ */ new Set();
 var meshClient;