@hasna/machines 0.0.28 → 0.0.29

package/dist/commands/runtime.d.ts

@@ -0,0 +1,32 @@
+import { EventsClient, type EmitResult } from "@hasna/events";
+export interface TmuxPaneProbeResult {
+    target: string;
+    exists: boolean;
+    paneId?: string;
+    checkedAt: string;
+    exitCode?: number | null;
+    error?: string;
+    stderr?: string;
+}
+export interface TmuxWatchOptions {
+    target: string;
+    intervalMs?: number;
+    maxChecks?: number;
+    emitInitialMissing?: boolean;
+    deliver?: boolean;
+    tmuxCommand?: string;
+    client?: Pick<EventsClient, "emit">;
+    probe?: (target: string) => TmuxPaneProbeResult | Promise<TmuxPaneProbeResult>;
+    sleep?: (ms: number) => Promise<void>;
+    onProbe?: (probe: TmuxPaneProbeResult) => void;
+}
+export interface TmuxWatchResult {
+    target: string;
+    checks: number;
+    status: "present" | "missing" | "died" | "stopped";
+    lastProbe: TmuxPaneProbeResult;
+    emitted?: EmitResult;
+}
+export declare function probeTmuxPane(target: string, tmuxCommand?: string): TmuxPaneProbeResult;
+export declare function watchTmuxPane(options: TmuxWatchOptions): Promise<TmuxWatchResult>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/commands/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAmB,MAAM,eAAe,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC/E,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD,SAAS,EAAE,mBAAmB,CAAC;IAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,SAAmD,GAAG,mBAAmB,CAmBjI;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA6CvF"}

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export * from "./commands/install-claude.js";
 export * from "./commands/install-tailscale.js";
 export * from "./commands/notifications.js";
 export * from "./commands/ports.js";
+export * from "./commands/runtime.js";
 export * from "./commands/self-test.js";
 export * from "./commands/serve.js";
 export * from "./commands/setup.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,yBAAyB,EACzB,kCAAkC,EAClC,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtH,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,yBAAyB,EACzB,kCAAkC,EAClC,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtH,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -13427,6 +13427,10 @@ function listPorts(machineId) {
     listeners: parsePortOutput(result.stdout, format)
   };
 }
+// src/commands/runtime.ts
+import { spawnSync as spawnSync4 } from "child_process";
+import { setTimeout as sleep } from "timers/promises";
+
 // node_modules/@hasna/events/dist/index.js
 import { chmod, mkdir, readFile, rename, writeFile } from "fs/promises";
 import { existsSync as existsSync7 } from "fs";
@@ -13947,6 +13951,91 @@ function normalizeRetryPolicy(policy) {
   };
 }
 
+// src/commands/runtime.ts
+function probeTmuxPane(target, tmuxCommand = process.env["HASNA_MACHINES_TMUX_BIN"] || "tmux") {
+  const checkedAt = new Date().toISOString();
+  const result = spawnSync4(tmuxCommand, ["display-message", "-p", "-t", target, "#{pane_id}"], {
+    encoding: "utf8",
+    timeout: 5000
+  });
+  const stdout = result.stdout?.trim();
+  const stderr = result.stderr?.trim();
+  const exists = result.status === 0 && Boolean(stdout);
+  return {
+    target,
+    exists,
+    paneId: exists ? stdout : undefined,
+    checkedAt,
+    exitCode: result.status,
+    error: result.error?.message,
+    stderr: stderr || undefined
+  };
+}
+async function watchTmuxPane(options) {
+  const target = options.target.trim();
+  if (!target)
+    throw new Error("tmux pane target is required");
+  const intervalMs = Math.max(0, options.intervalMs ?? 5000);
+  const maxChecks = options.maxChecks ?? Number.POSITIVE_INFINITY;
+  const client = options.client ?? new EventsClient;
+  const probe = options.probe ?? ((paneTarget) => probeTmuxPane(paneTarget, options.tmuxCommand));
+  const wait = options.sleep ?? sleep;
+  let lastPresent;
+  let lastProbe;
+  for (let checks = 1;checks <= maxChecks; checks += 1) {
+    const current = await probe(target);
+    lastProbe = current;
+    options.onProbe?.(current);
+    if (current.exists) {
+      lastPresent = current;
+    } else if (lastPresent) {
+      const emitted = await emitTmuxEvent(client, "machines.tmux.pane_died", current, lastPresent, options.deliver !== false);
+      return { target, checks, status: "died", lastProbe: current, emitted };
+    } else if (options.emitInitialMissing) {
+      const emitted = await emitTmuxEvent(client, "machines.tmux.pane_missing", current, undefined, options.deliver !== false);
+      return { target, checks, status: "missing", lastProbe: current, emitted };
+    }
+    if (checks < maxChecks)
+      await wait(intervalMs);
+  }
+  if (!lastProbe) {
+    lastProbe = {
+      target,
+      exists: false,
+      checkedAt: new Date().toISOString(),
+      error: "No probe executed"
+    };
+  }
+  return {
+    target,
+    checks: Number.isFinite(maxChecks) ? maxChecks : 0,
+    status: lastProbe.exists ? "present" : "stopped",
+    lastProbe
+  };
+}
+async function emitTmuxEvent(client, type, probe, lastPresent, deliver) {
+  const input = {
+    source: "machines",
+    type,
+    subject: `tmux:${probe.target}`,
+    severity: type === "machines.tmux.pane_died" ? "warning" : "notice",
+    message: type === "machines.tmux.pane_died" ? `tmux pane disappeared: ${probe.target}` : `tmux pane is missing: ${probe.target}`,
+    data: {
+      target: probe.target,
+      paneId: lastPresent?.paneId,
+      lastSeenAt: lastPresent?.checkedAt,
+      checkedAt: probe.checkedAt,
+      exitCode: probe.exitCode,
+      error: probe.error,
+      stderr: probe.stderr
+    },
+    metadata: {
+      monitor: "tmux-pane",
+      runtime: "machines"
+    }
+  };
+  return client.emit(input, { deliver });
+}
 // src/commands/status.ts
 function getStatus() {
   const manifest = readManifest();
@@ -24057,6 +24146,7 @@ export {
   writeNotificationConfig,
   writeManifest,
   writeHeartbeat,
+  watchTmuxPane,
   validateManifest,
   upsertHeartbeat,
   testNotificationChannel,
@@ -24090,6 +24180,7 @@ export {
   recordSetupRun,
   readNotificationConfig,
   readManifest,
+  probeTmuxPane,
   parseStorageTables,
   parsePortOutput,
   markOffline,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/machines",
-  "version": "0.0.28",
+  "version": "0.0.29",
   "description": "Machine fleet management CLI + MCP for developers",
   "type": "module",
   "license": "Apache-2.0",