@zswarm/cli 0.1.5 → 0.1.7

package/README.md

@@ -30,6 +30,8 @@ zswarm keys --to terminal_2 --key "Ctrl c" --key Esc
 Prints JSON. No arguments prints usage, generated from the same schema as the
 MCP tool.
 
+Spawn lifecycle, body files, guarded keys, status tabs and routing context: [crew operations](../../docs/crew-operations.md).
+
 Ops, env, and the event bus: the [zswarm README](../../README.md).
 
 ## License

package/dist/cli.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 import { ZellijError, cliUsage, dispatchZswarm, parseCliArgv, serveChildEnv, startServe, } from "@zswarm/core";
+import { readBodyFile } from "./input.js";
+import { routingNotice } from "./output.js";
 const argv = process.argv.slice(2);
 if (argv.length === 0 || argv[0] === "-h" || argv[0] === "--help") {
     process.stderr.write(cliUsage());
@@ -14,6 +16,15 @@ catch (err) {
     process.stderr.write(`${message}\n${cliUsage()}`);
     process.exit(2);
 }
+try {
+    args = await readBodyFile(args);
+}
+catch (err) {
+    const code = err instanceof ZellijError ? err.code : "body_file_read";
+    const message = err instanceof Error ? err.message : String(err);
+    process.stdout.write(JSON.stringify({ ok: false, error: { code, message } }) + "\n");
+    process.exit(1);
+}
 // TCP server holds the event loop; process.exit would tear it down.
 if (args.op === "serve" && args.install !== true && args.clear !== true) {
     const listen = typeof args.listen === "string" ? args.listen : undefined;
@@ -29,6 +40,7 @@ if (args.op === "serve" && args.install !== true && args.clear !== true) {
 }
 else {
     const result = await dispatchZswarm(args);
+    process.stderr.write(routingNotice(result, process.stderr.isTTY === true));
     process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
     process.exit(result.ok ? 0 : 1);
 }

package/dist/input.d.ts

@@ -0,0 +1,2 @@
+/** 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>>;

package/dist/input.js

@@ -0,0 +1,30 @@
+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;
+    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");
+        }
+    }
+    catch (err) {
+        throw new ZellijError("body_file_read", `cannot read body from ${JSON.stringify(path)}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const out = { ...args, body };
+    delete out.bodyFile;
+    return out;
+}

package/dist/output.d.ts

@@ -0,0 +1,3 @@
+import type { OpsResult } from "@zswarm/core";
+/** Human diagnostics stay on stderr; stdout is always one JSON response. */
+export declare function routingNotice(result: OpsResult, interactive: boolean): string;

package/dist/output.js

@@ -0,0 +1,14 @@
+/** Human diagnostics stay on stderr; stdout is always one JSON response. */
+export function routingNotice(result, interactive) {
+    const route = result.context;
+    if (!interactive || !route)
+        return "";
+    // Prevent terminal control characters or newlines in host/session labels.
+    const label = (s) => JSON.stringify(s);
+    const data = result.ok && result.data && typeof result.data === "object" ? result.data : null;
+    const polling = data?.polling;
+    return `zswarm: ${route.transport} ${label(route.host)}` +
+        (route.session ? ` session=${label(route.session)}` : "") +
+        ` (via ${route.origin.transport}; session ${route.origin.session})\n` +
+        (polling?.recommendation ? `zswarm: ${label(polling.recommendation)}\n` : "");
+}

package/package.json

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