@zswarm/cli 0.2.6 → 0.2.8

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { HOST_COMMANDS, OP_NAMES, ZellijError, cliUsage, commandUsage, wantsHelp, createServeTunnelManager, dispatchZswarm, extractOp, parseCliArgv, runHostCommand, SERVE_AWAIT_SESSION_ENV, SERVE_CORE_VERSION, serveTokenFromEnv, serveChildEnv, startServe, } from "@zswarm/core";
-import { readBodyFile } from "./input.js";
+import { readBodyFile, readHandoffFile } from "./input.js";
 import { routingNotice } from "./output.js";
 /** Wait until `session` is a live Zellij session (a crew service creates it). */
 async function awaitLiveSession(session, ms) {
@@ -50,7 +50,7 @@ catch (err) {
     process.exit(2);
 }
 try {
-    args = await readBodyFile(args);
+    args = await readHandoffFile(await readBodyFile(args));
 }
 catch (err) {
     const code = err instanceof ZellijError ? err.code : "body_file_read";

package/dist/input.d.ts

@@ -1,2 +1,9 @@
 /** Local CLI preprocessing. File paths never cross SSH or the serve protocol. */
 export declare function readBodyFile(args: Record<string, unknown>, stdin?: AsyncIterable<Uint8Array | string>): Promise<Record<string, unknown>>;
+/**
+ * Resolve `--handoff-file` on the caller. The path is remembered for the
+ * post-relaunch pointer and for `--handoff-self`, which asks the running agent
+ * to write the file, so its content is only read here when the caller supplied
+ * it (not in self mode). `-` reads stdin once, like `--body-file`.
+ */
+export declare function readHandoffFile(args: Record<string, unknown>, stdin?: AsyncIterable<Uint8Array | string>): Promise<Record<string, unknown>>;

package/dist/input.js

@@ -1,30 +1,51 @@
 import { readFile } from "node:fs/promises";
 import { ZellijError } from "@zswarm/core";
-/** Local CLI preprocessing. File paths never cross SSH or the serve protocol. */
-export async function readBodyFile(args, stdin = process.stdin) {
-    if (args.bodyFile === undefined)
-        return args;
-    if (args.op !== "send" || args.body !== undefined || args.text !== undefined) {
-        throw new ZellijError("usage", "--body-file requires send and cannot be combined with another body source");
-    }
-    const path = String(args.bodyFile);
-    let body;
+/** Read `-` (stdin) or a UTF-8 file, with a caller-shaped error. */
+async function readInput(path, stdin, code, label) {
     try {
         if (path === "-") {
             const chunks = [];
             for await (const chunk of stdin) {
                 chunks.push(typeof chunk === "string" ? Buffer.from(chunk, "utf8") : Buffer.from(chunk));
             }
-            body = Buffer.concat(chunks).toString("utf8");
-        }
-        else {
-            body = await readFile(path, "utf8");
+            return Buffer.concat(chunks).toString("utf8");
         }
+        return await readFile(path, "utf8");
     }
     catch (err) {
-        throw new ZellijError("body_file_read", `cannot read body from ${JSON.stringify(path)}: ${err instanceof Error ? err.message : String(err)}`);
+        throw new ZellijError(code, `cannot read ${label} from ${JSON.stringify(path)}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/** Local CLI preprocessing. File paths never cross SSH or the serve protocol. */
+export async function readBodyFile(args, stdin = process.stdin) {
+    if (args.bodyFile === undefined)
+        return args;
+    if (args.op !== "send" || args.body !== undefined || args.text !== undefined) {
+        throw new ZellijError("usage", "--body-file requires send and cannot be combined with another body source");
     }
+    const path = String(args.bodyFile);
+    const body = await readInput(path, stdin, "body_file_read", "body");
     const out = { ...args, body };
     delete out.bodyFile;
     return out;
 }
+/**
+ * Resolve `--handoff-file` on the caller. The path is remembered for the
+ * post-relaunch pointer and for `--handoff-self`, which asks the running agent
+ * to write the file, so its content is only read here when the caller supplied
+ * it (not in self mode). `-` reads stdin once, like `--body-file`.
+ */
+export async function readHandoffFile(args, stdin = process.stdin) {
+    if (args.handoffFile === undefined)
+        return args;
+    if (args.op !== "restart") {
+        throw new ZellijError("usage", "--handoff-file requires restart");
+    }
+    const path = String(args.handoffFile);
+    const out = { ...args, handoffPath: path };
+    delete out.handoffFile;
+    if (args.handoffSelf === true || args.handoffSelf === "true")
+        return out;
+    out.handoff = await readInput(path, stdin, "handoff_file_read", "handoff");
+    return out;
+}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@zswarm/cli",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "type": "module",
   "description": "zSwarm CLI — list, send, dump Zellij panes",
   "bin": {
     "zswarm": "./dist/cli.js"
   },
   "dependencies": {
-    "@zswarm/core": "0.2.6"
+    "@zswarm/core": "0.2.8"
   },
   "devDependencies": {
     "@types/node": "22.14.1",