@zswarm/core 0.2.4 → 0.2.6

package/dist/host/cli.js

@@ -1,7 +1,7 @@
 import { readFileSync } from "node:fs";
 import { ZellijError } from "../errors.js";
 import { createStateStore } from "../state.js";
-import { crewCheck, crewDown, crewStart, crewStatus, crewUp } from "./crew.js";
+import { crewCheck, crewClient, crewDown, crewStart, crewStatus, crewUp } from "./crew.js";
 import { hostDoctor, hostInstall, hostInstallArgs, hostScriptPath } from "./host.js";
 import { listLeases } from "./lease.js";
 import { cancelAllTo, cancelRelay, listRelays, pruneRelays, runRelayDir, startRelay, waitForRelay } from "./relay.js";
@@ -75,6 +75,10 @@ async function crew(argv) {
             return crewStart(session);
         case "check":
             return crewCheck(session);
+        case "client":
+            // What the minimized console window on Windows runs: attach (and create)
+            // the session so its panes render and take input.
+            return crewClient(session);
         default:
             process.stderr.write(`${COMMANDS.crew.usage}\n`);
             return 2;
@@ -227,10 +231,13 @@ const COMMANDS = {
     crew: {
         usage: [
             "zswarm crew up <session> --layout L.kdl [--config C.kdl] [--env-file F] [--first-pane NAME] [--run-as USER]",
-            "                                  keep the session running from its layout (service + 2-min watchdog)",
+            "                                  keep the session running from its layout (service + 2-min watchdog;",
+            "                                  on Windows: Scheduled Tasks under \\zswarm\\ + an attached client window)",
             "zswarm crew status <session> [--run-as USER]   services, session, panes",
             "zswarm crew down <session> [--run-as USER]     remove the services and kill the session",
             "zswarm crew start|check <session>              what the service and the watchdog run",
+            "zswarm crew client <session>                   what the minimized console window runs (Windows)",
+            "--run-as installs for another account and is Linux/macOS only; a Windows crew runs as the signed-in user",
         ].join("\n"),
         run: crew,
     },

package/dist/host/crew-windows.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Windows half of `zswarm crew`.
+ *
+ * A background Zellij session started with `zellij attach --create-background`
+ * on Windows renders empty pane grids and drops pasted input, because nothing
+ * is attached in a real console. The fix is two Scheduled Tasks under
+ * `\zswarm\` plus a minimized attached-client console window:
+ *
+ *   zswarm-crew-<session>        starts the session (interactive, highest)
+ *   zswarm-crew-<session>-watch  `crew check` every two minutes, so the crew
+ *                                restarts only when the session or its first
+ *                                layout pane is gone, and the client window is
+ *                                reopened when it is gone but the session lives
+ *
+ * This module is pure PowerShell text (unit-tested by text) plus thin async
+ * wrappers. It deliberately mirrors `buildServeTaskScript` in
+ * `ops/serve-install.ts`: same preamble helpers, same base64 UTF-8 round-trip
+ * for the cmd.exe action body, same `-EncodedCommand` invocation. It must not
+ * import `./crew.js`; that module imports this one.
+ */
+/** Scheduled-task folder every crew task lives in. */
+export declare const CREW_TASK_FOLDER = "\\zswarm\\";
+/** Watchdog cadence, matching the Linux/macOS `crew-<s>-watch` timer. */
+export declare const CREW_WATCH_MINUTES = 2;
+export type PowerShellResult = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+export type PowerShellExec = (script: string, options: {
+    timeoutMs: number;
+    signal?: AbortSignal;
+}) => Promise<PowerShellResult>;
+export type CrewTaskNames = {
+    folder: string;
+    start: string;
+    watch: string;
+};
+export type CrewTaskState = {
+    /** Which of the two crew tasks this is. */
+    name: "start" | "watch";
+    /** Task name only, e.g. `zswarm-crew-crew`. */
+    task: string;
+    /** `\zswarm\zswarm-crew-crew`. */
+    path: string;
+    /** `Ready` | `Running` | `Disabled` | `missing` ... */
+    state: string;
+    /** Registered at all: Ready/Running/Disabled count; `missing` does not. */
+    active: boolean;
+    lastResult: number | null;
+    lastRun: string | null;
+};
+export type CrewClientWindow = {
+    present: boolean;
+    pid: number | null;
+    count: number;
+};
+/** `zswarm-crew-<session>`: task names, and the client window's title marker. */
+export declare function crewTaskNames(session: string): CrewTaskNames;
+/** The token that proves a console window is this crew's client: its title and
+ *  the string in its launcher's command line. */
+export declare function crewClientMarker(session: string): string;
+/** The cmd.exe action body for a task: `set "K=V"&& ...` then the CLI argv. */
+export declare function crewTaskCommand(input: {
+    launch: {
+        execPath: string;
+        scriptPath: string;
+    };
+    mode: "start" | "check";
+    session: string;
+    env: NodeJS.ProcessEnv;
+}): string;
+/** Pure PowerShell text, unit-tested by text. */
+export declare function buildCrewTaskScript(action: "register" | "inspect" | "start" | "unregister", params: {
+    session: string;
+    startCommand?: string;
+    watchCommand?: string;
+    intervalMinutes?: number;
+}): string;
+/**
+ * The command line the client window runs. The marker is both the window title
+ * and the token `ensure`/`close` look for in a process command line; the crew
+ * CLI does the actual `zellij attach --create`, so the window can read the crew
+ * dir (and its env file) itself instead of taking secrets on a command line.
+ */
+export declare function crewClientCommand(input: {
+    session: string;
+    launch: {
+        execPath: string;
+        scriptPath: string;
+    };
+}): string;
+/** The minimized attached-client window that makes a Windows Zellij session render. */
+export declare function buildCrewClientScript(action: "ensure" | "close", params: {
+    session: string;
+    clientCommand?: string;
+}): string;
+/** Last line that parses as a JSON object, else the first; null when none does. */
+export declare function parseCrewJson(stdout: string): Record<string, unknown> | null;
+/** Powershell runner used in production; injected in tests. Never throws. */
+export declare const defaultPowerShellExec: PowerShellExec;
+export declare function inspectCrewTasks(input: {
+    session: string;
+    runPowerShell: PowerShellExec;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<{
+    tasks: CrewTaskState[];
+    client: CrewClientWindow;
+}>;
+export declare function installCrewTasks(input: {
+    session: string;
+    startCommand: string;
+    watchCommand: string;
+    intervalMinutes?: number;
+    runPowerShell: PowerShellExec;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<{
+    lines: string[];
+    notes: string[];
+    tasks: CrewTaskState[];
+    client: CrewClientWindow;
+}>;
+export declare function removeCrewTasks(input: {
+    session: string;
+    runPowerShell: PowerShellExec;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<{
+    lines: string[];
+    tasks: CrewTaskState[];
+}>;
+export declare function ensureCrewClient(input: {
+    session: string;
+    clientCommand: string;
+    runPowerShell: PowerShellExec;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<{
+    opened: boolean;
+    pid: number | null;
+    title: string;
+    present: boolean;
+    count: number;
+}>;
+export declare function closeCrewClient(input: {
+    session: string;
+    runPowerShell: PowerShellExec;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<{
+    closed: number[];
+    count: number;
+}>;