@qduc/term2 0.14.0 → 0.15.0

package/dist/services/shell/background-shell-watches.d.ts

@@ -20,8 +20,8 @@ export interface BackgroundShellOutputBundle {
  * carrying the burst, not 200 firings. The idle window is quiet *for this
  * watch*: only new matching lines extend it; unrelated output does not delay
  * the firing. Firings are counted per watch (`seq` 1, 2, …); a watch retires
- * when it has fired `notifyLimit` times, when its job settles, or when
- * cancelled by id.
+ * when it has fired `notifyLimit` times (`notifyLimit: 0` means the firing
+ * count never retires it), when its job settles, or when cancelled by id.
  *
  * Watches replay the job's retained buffer from `fromOffset` (default 0 = the
  * head of the buffer), which is the whole reason no launch-time monitor
@@ -51,7 +51,12 @@ export interface ShellOutputWatch {
     stream: ShellOutputWatchStream;
     /** Coalescing window in ms; default 1500. */
     idleMs: number;
-    /** Firing budget; default 1 when a pattern is set, 5 otherwise. */
+    /**
+     * Firing budget; 0 means unlimited (retire only on job settlement or
+     * explicit cancel). Defaults to 0 — the previous "1 with a pattern,
+     * 5 otherwise" default retired long-running watches before consumers
+     * could tell anything was being clipped.
+     */
     notifyLimit: number;
     /**
      * Number of retained complete lines to skip from the head of the job's
@@ -70,6 +75,8 @@ export interface RegisterShellOutputWatchOptions {
     fromOffset?: number;
     /** Passed through to every firing so the consumer can name the job. */
     command?: string;
+    /** Defer replay delivery to the scheduler so a launching tool can publish its result first. */
+    deferInitialDelivery?: boolean;
 }
 export interface ShellOutputFiring {
     jobId: string;
@@ -81,6 +88,24 @@ export interface ShellOutputFiring {
      * newest text.
      */
     matchedLines: string;
+    /**
+     * Number of distinct complete lines that were coalesced into this firing.
+     * Always >= 1; equal to `matchedLines.split('\n').length` while the cap
+     * is not engaged. Surfaces bursts the idle window collapsed into one
+     * delivery so consumers can detect coalescing without parsing the text.
+     */
+    coalescedCount: number;
+    /**
+     * The inclusive range of per-watch seqs this firing represents. Today
+     * every firing represents exactly one seq, so `{ first, last }` always
+     * equals `{ seq, seq }`; the explicit range is published up front so that
+     * if the engine later evolves to coalesce *across* idle windows (one
+     * firing for seqs 1..3), consumers already have a single field to read.
+     */
+    seqRange: {
+        first: number;
+        last: number;
+    };
     /** Store evictions since the job opened, from the store read at delivery. */
     droppedBytes: number;
     command?: string;

package/dist/services/shell/background-shell-watches.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"background-shell-watches.d.ts","sourceRoot":"","sources":["../../../source/services/shell/background-shell-watches.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAElH;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,0BAA0B,CAAC;IAClC,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,sBAAsB,GAAG,2BAA2B,GAAG,MAAM,CAAC;AAE1E,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACzD,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,0BAA0B,CAAC;IAClC,SAAS,EAAE,6BAA6B,CAAC;IACzC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAChD;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAsBD,qBAAa,sBAAsB;;IAOjC,YAAY,OAAO,EAAE,6BAA6B,EAIjD;IAED;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAE7E;IAED,4DAA4D;IAC5D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAExB;IAED;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,2BAA2B,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAM3E;IAED;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,+BAA+B,GAAG,MAAM,CAuD9D;IAED,sEAAsE;IACtE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIpC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAe7B;CAwFF"}
+{"version":3,"file":"background-shell-watches.d.ts","sourceRoot":"","sources":["../../../source/services/shell/background-shell-watches.ts"],"names":[],"mappings":"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"}

package/dist/services/shell/background-shell-watches.js

@@ -52,14 +52,17 @@ export class BackgroundShellWatches {
      */
     registerWatch(options) {
         const idleMs = options.idleMs ?? DEFAULT_IDLE_MS;
-        const notifyLimit = options.notifyLimit ?? (options.pattern === undefined ? 5 : 1);
+        // 0 = unlimited (default). The previous 1-with-pattern / 5-without-pattern
+        // defaults quietly retired long-running watches; consumers wanting a cap
+        // pass it explicitly.
+        const notifyLimit = options.notifyLimit ?? 0;
         const fromOffset = options.fromOffset ?? 0;
         const stream = options.stream ?? 'both';
         if (!Number.isInteger(idleMs) || idleMs < 0) {
             throw new RangeError('idleMs must be a non-negative integer.');
         }
-        if (!Number.isInteger(notifyLimit) || notifyLimit < 1) {
-            throw new RangeError('notifyLimit must be a positive integer.');
+        if (!Number.isInteger(notifyLimit) || notifyLimit < 0) {
+            throw new RangeError('notifyLimit must be a non-negative integer (0 = unlimited).');
         }
         if (!Number.isInteger(fromOffset) || fromOffset < 0) {
             throw new RangeError('fromOffset must be a non-negative integer.');
@@ -84,6 +87,9 @@ export class BackgroundShellWatches {
             lastDroppedLines: read.droppedLines,
             pending: [],
             pendingBytes: 0,
+            pendingTotalLines: 0,
+            // The first line matched (now or during replay) belongs to seq 1.
+            pendingSeqStart: 1,
             firedCount: 0,
             timer: null,
         };
@@ -96,9 +102,19 @@ export class BackgroundShellWatches {
                 this.#scheduler.cancel(record.timer);
                 record.timer = null;
             }
-            if (record.pending.length > 0)
-                this.#fire(record);
-            this.#retire(watch.watchId);
+            if (record.pending.length > 0 && options.deferInitialDelivery) {
+                record.timer = this.#scheduler.schedule(() => {
+                    record.timer = null;
+                    if (record.pending.length > 0)
+                        this.#fire(record);
+                    this.#retire(watch.watchId);
+                }, 0);
+            }
+            else {
+                if (record.pending.length > 0)
+                    this.#fire(record);
+                this.#retire(watch.watchId);
+            }
         }
         else if (record.pending.length > 0) {
             this.#reschedule(record);
@@ -158,8 +174,18 @@ export class BackgroundShellWatches {
             if (watch.pattern !== undefined && !patternMatches(watch.pattern, line.text))
                 continue;
             matched = true;
+            if (record.pending.length === 0) {
+                // First line of a fresh batch: anchor its seq so the firing can
+                // publish the range this batch will cover. After delivery, the next
+                // line is seq (firedCount + 1) again.
+                record.pendingSeqStart = record.firedCount + 1;
+            }
             record.pending.push(line.text);
             record.pendingBytes += line.text.length;
+            record.pendingTotalLines += 1;
+            // The cap evicts from the head to keep `matchedLines` bounded; the
+            // dropped lines were part of the same firing anyway, so the seq range
+            // this batch will cover is unchanged.
             while (record.pendingBytes > MAX_MATCHED_TEXT && record.pending.length > 1) {
                 const dropped = record.pending.shift();
                 if (dropped !== undefined)
@@ -187,23 +213,29 @@ export class BackgroundShellWatches {
     }
     /**
      * Delivers one firing (the next `seq`), then retires the watch if it has
-     * reached `notifyLimit` — delivering the last firing is what retires it.
+     * reached `notifyLimit` (and `notifyLimit` is not 0, the unlimited sentinel)
+     * — delivering the last firing is what retires it.
      */
     #fire(record) {
         const { watch } = record;
         record.firedCount += 1;
+        const seq = record.firedCount;
         const firing = {
             jobId: watch.jobId,
             watchId: watch.watchId,
-            seq: record.firedCount,
+            seq,
             matchedLines: joinPending(record.pending),
+            coalescedCount: record.pendingTotalLines,
+            seqRange: { first: record.pendingSeqStart, last: seq },
             droppedBytes: this.#store.readLines(watch.jobId)?.droppedBytes ?? 0,
             ...(record.command === undefined ? {} : { command: record.command }),
         };
         record.pending = [];
         record.pendingBytes = 0;
+        record.pendingTotalLines = 0;
+        record.pendingSeqStart = seq + 1;
         this.#emit(firing);
-        if (record.firedCount >= watch.notifyLimit)
+        if (watch.notifyLimit !== 0 && record.firedCount >= watch.notifyLimit)
             this.#retire(watch.watchId);
     }
     #retire(watchId) {

package/dist/services/shell/background-shell-watches.js.map

@@ -1 +1 @@
-{"version":3,"file":"background-shell-watches.js","sourceRoot":"","sources":["../../../source/services/shell/background-shell-watches.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"background-shell-watches.js","sourceRoot":"","sources":["../../../source/services/shell/background-shell-watches.ts"],"names":[],"mappings":"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"}

package/dist/services/ssh-service.d.ts

@@ -1,5 +1,5 @@
 import { Client } from 'ssh2';
-import { ISSHService } from './service-interfaces.js';
+import { ISSHService, SSHCommandOptions, SSHCommandResult } from './service-interfaces.js';
 export interface SSHConfig {
     host: string;
     port: number;
@@ -7,22 +7,94 @@ export interface SSHConfig {
     agent?: string;
     identityFile?: string;
 }
+/**
+ * Typed discriminant for how an `executeCommand` promise settled without a
+ * terminal remote exit code. The kind names the observation that settled the
+ * promise; it is not a claim about what happened on the remote host.
+ */
+export type SSHTransportErrorKind = 'not_connected' | 'exec_failed' | 'connection_error' | 'connection_end' | 'connection_close' | 'channel_error' | 'explicit_disconnect' | 'aborted' | 'timeout';
+/**
+ * Truthful remote-effect classification carried by a transport-level
+ * settlement:
+ *
+ * - `'none'` — proven pre-dispatch; no command string was ever handed to the
+ *   transport, so no remote side effect can have occurred.
+ * - `'unknown'` — the command may have completed, partially completed, or be
+ *   orphaned on the remote host. Blind replay of a non-idempotent command is
+ *   never safe on this classification.
+ */
+export type SSHRemoteEffect = 'none' | 'unknown';
+/**
+ * Typed transport settlement for a remote command. Replacing raw/unclassified
+ * rejections lets callers and recovery paths distinguish a local containment
+ * decision (`'aborted'`, `'timeout'`, `'not_connected'`) from an ambiguous
+ * transport drop without guessing at message text.
+ */
+export declare class SSHTransportError extends Error {
+    readonly kind: SSHTransportErrorKind;
+    readonly remoteEffect: SSHRemoteEffect;
+    /** Bytes received before settlement. Best effort only — never a complete result. */
+    readonly partialOutput?: {
+        stdout: string;
+        stderr: string;
+    };
+    constructor(kind: SSHTransportErrorKind, message: string, options?: {
+        cause?: unknown;
+        remoteEffect?: SSHRemoteEffect;
+        partialOutput?: {
+            stdout: string;
+            stderr: string;
+        };
+    });
+}
+/**
+ * Canonical POSIX single-quote escaping: the value is wrapped in single quotes
+ * and any embedded `'` is rewritten as `'\''` (close quote, escaped quote,
+ * reopen quote). Shell metacharacters, `$VAR`, `$(...)`, and operators inside
+ * the value become inert data. Applies to every remote path argument and the
+ * optional `cwd`.
+ */
+export declare function quoteShellArg(value: string): string;
+/**
+ * Owns the SSH transport lifecycle and remote command execution.
+ *
+ * Connection-state listeners are attached exactly once per client instance
+ * (`attachLifecycleListeners`), so repeated `connect()` calls cannot stack
+ * handlers. `connect()` is single-flight: an in-progress attempt is shared and
+ * a call while already connected is a no-op, so an old connection era's
+ * listeners can never settle a later command. Keepalive policy is explicitly
+ * **none** — no keepalive configuration and no background pings; drops are
+ * detected by socket/stream events and reported through typed settlement.
+ *
+ * Every in-flight `executeCommand` registers a settler in
+ * `activeCommandSettlers`. A terminal connection event settles all active
+ * commands with a typed `SSHTransportError`; each command also settles on its
+ * own stream close, channel error, `timeoutMs` elapse, or abort signal. The
+ * promise never hangs on a dropped transport.
+ */
 export declare class SSHService implements ISSHService {
     private config;
     private client;
     private connected;
+    private lifecycleAttached;
+    private connecting;
+    /** Settlers for commands currently in flight; a terminal transport event settles them all. */
+    private activeCommandSettlers;
     constructor(config: SSHConfig, client?: Client);
+    /**
+     * Attaches connection-level lifecycle listeners once per client instance.
+     * The first terminal event (`error`/`end`/`close`) wins per era: after the
+     * first drop the connection is marked down and every command active at that
+     * moment settles; later events from the same close sequence find an empty
+     * active set.
+     */
+    private attachLifecycleListeners;
+    private onTransportDrop;
     connect(): Promise<void>;
+    private performConnect;
     disconnect(): Promise<void>;
     isConnected(): boolean;
-    executeCommand(cmd: string, opts?: {
-        cwd?: string;
-    }): Promise<{
-        stdout: string;
-        stderr: string;
-        exitCode: number | null;
-        timedOut: boolean;
-    }>;
+    executeCommand(cmd: string, opts?: SSHCommandOptions): Promise<SSHCommandResult>;
     readFile(path: string): Promise<string>;
     writeFile(path: string, content: string): Promise<void>;
     mkdir(path: string, opts?: {

package/dist/services/ssh-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssh-service.d.ts","sourceRoot":"","sources":["../../source/services/ssh-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAG9B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,UAAW,YAAW,WAAW;IAIhC,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAkB;IAEnC,YAAoB,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,EAErD;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAmC7B;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhC;IAED,WAAW,IAAI,OAAO,CAErB;IAEK,cAAc,CAClB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GACtB,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAiCD;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5C;IAEK,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB5D;IAEK,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE;CACF"}
+{"version":3,"file":"ssh-service.d.ts","sourceRoot":"","sources":["../../source/services/ssh-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAsB,MAAM,MAAM,CAAC;AAGlD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3F,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,aAAa,GACb,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,eAAe,GACf,qBAAqB,GACrB,SAAS,GACT,SAAS,CAAC;AAEd;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,oFAAoF;IACpF,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAE5D,YACE,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,YAAY,CAAC,EAAE,eAAe,CAAC;QAC/B,aAAa,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,EAQP;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AA0BD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,UAAW,YAAW,WAAW;IAQhC,OAAO,CAAC,MAAM;IAP1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,UAAU,CAA8B;IAChD,8FAA8F;IAC9F,OAAO,CAAC,qBAAqB,CAAqE;IAElG,YAAoB,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,EAErD;IAED;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,eAAe;IASjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAO7B;YAEa,cAAc;IA8CtB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAMhC;IAED,WAAW,IAAI,OAAO,CAErB;IAEK,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuGrF;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5C;IAEK,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB5D;IAEK,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE;CACF"}

package/dist/services/ssh-service.js

@@ -1,16 +1,124 @@
 import { Client } from 'ssh2';
 import { readFileSync } from 'fs';
 import { homedir } from 'os';
+/**
+ * Typed transport settlement for a remote command. Replacing raw/unclassified
+ * rejections lets callers and recovery paths distinguish a local containment
+ * decision (`'aborted'`, `'timeout'`, `'not_connected'`) from an ambiguous
+ * transport drop without guessing at message text.
+ */
+export class SSHTransportError extends Error {
+    kind;
+    remoteEffect;
+    /** Bytes received before settlement. Best effort only — never a complete result. */
+    partialOutput;
+    constructor(kind, message, options = {}) {
+        super(message);
+        this.name = 'SSHTransportError';
+        this.kind = kind;
+        this.remoteEffect = options.remoteEffect ?? 'unknown';
+        this.cause = options.cause;
+        this.partialOutput = options.partialOutput;
+    }
+}
+/**
+ * Canonical POSIX single-quote escaping: the value is wrapped in single quotes
+ * and any embedded `'` is rewritten as `'\''` (close quote, escaped quote,
+ * reopen quote). Shell metacharacters, `$VAR`, `$(...)`, and operators inside
+ * the value become inert data. Applies to every remote path argument and the
+ * optional `cwd`.
+ */
+export function quoteShellArg(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+function transportDropMessage(kind, cause) {
+    const detail = cause instanceof Error ? `: ${cause.message}` : '';
+    switch (kind) {
+        case 'connection_error':
+            return `SSH connection error${detail}`;
+        case 'connection_end':
+            return 'SSH connection ended while a command was in flight';
+        case 'connection_close':
+            return 'SSH connection closed while a command was in flight';
+        case 'channel_error':
+            return `SSH channel error${detail}`;
+        case 'explicit_disconnect':
+            return 'SSH connection disconnected while a command was in flight';
+        case 'exec_failed':
+            return `SSH exec failed${detail}`;
+        case 'aborted':
+            return 'SSH command aborted';
+        case 'timeout':
+            return 'SSH command timed out';
+        case 'not_connected':
+            return 'SSH client not connected';
+    }
+}
+/**
+ * Owns the SSH transport lifecycle and remote command execution.
+ *
+ * Connection-state listeners are attached exactly once per client instance
+ * (`attachLifecycleListeners`), so repeated `connect()` calls cannot stack
+ * handlers. `connect()` is single-flight: an in-progress attempt is shared and
+ * a call while already connected is a no-op, so an old connection era's
+ * listeners can never settle a later command. Keepalive policy is explicitly
+ * **none** — no keepalive configuration and no background pings; drops are
+ * detected by socket/stream events and reported through typed settlement.
+ *
+ * Every in-flight `executeCommand` registers a settler in
+ * `activeCommandSettlers`. A terminal connection event settles all active
+ * commands with a typed `SSHTransportError`; each command also settles on its
+ * own stream close, channel error, `timeoutMs` elapse, or abort signal. The
+ * promise never hangs on a dropped transport.
+ */
 export class SSHService {
     config;
     client;
     connected = false;
+    lifecycleAttached = false;
+    connecting = null;
+    /** Settlers for commands currently in flight; a terminal transport event settles them all. */
+    activeCommandSettlers = new Set();
     constructor(config, client) {
         this.config = config;
         this.client = client ?? new Client();
     }
+    /**
+     * Attaches connection-level lifecycle listeners once per client instance.
+     * The first terminal event (`error`/`end`/`close`) wins per era: after the
+     * first drop the connection is marked down and every command active at that
+     * moment settles; later events from the same close sequence find an empty
+     * active set.
+     */
+    attachLifecycleListeners() {
+        if (this.lifecycleAttached)
+            return;
+        this.lifecycleAttached = true;
+        this.client.on('error', (err) => this.onTransportDrop('connection_error', err));
+        this.client.on('end', () => this.onTransportDrop('connection_end'));
+        this.client.on('close', () => this.onTransportDrop('connection_close'));
+    }
+    onTransportDrop(kind, cause) {
+        this.connected = false;
+        const settlers = Array.from(this.activeCommandSettlers);
+        this.activeCommandSettlers.clear();
+        for (const settle of settlers) {
+            settle(kind, cause);
+        }
+    }
     async connect() {
+        if (this.connected)
+            return;
+        if (this.connecting)
+            return this.connecting;
+        this.connecting = this.performConnect().finally(() => {
+            this.connecting = null;
+        });
+        return this.connecting;
+    }
+    async performConnect() {
         return new Promise((resolve, reject) => {
+            this.attachLifecycleListeners();
             // Build connection config, including private key if identity file specified
             const connectConfig = {
                 host: this.config.host,
@@ -29,25 +137,35 @@ export class SSHService {
                     return;
                 }
             }
-            this.client
-                .on('ready', () => {
+            // Per-attempt listeners are `once` and each removes the other on
+            // settlement, so repeated connect attempts never accumulate handlers.
+            let settled = false;
+            const onReady = () => {
+                if (settled)
+                    return;
+                settled = true;
+                this.client.removeListener('error', onError);
                 this.connected = true;
                 resolve();
-            })
-                .on('error', (err) => {
+            };
+            const onError = (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                this.client.removeListener('ready', onReady);
                 this.connected = false;
                 reject(err);
-            })
-                .on('end', () => {
-                this.connected = false;
-            })
-                .connect(connectConfig);
+            };
+            this.client.once('ready', onReady);
+            this.client.once('error', onError);
+            this.client.connect(connectConfig);
         });
     }
     async disconnect() {
         if (this.connected) {
-            this.client.end();
             this.connected = false;
+            this.onTransportDrop('explicit_disconnect');
+            this.client.end();
         }
     }
     isConnected() {
@@ -55,37 +173,93 @@ export class SSHService {
     }
     async executeCommand(cmd, opts) {
         if (!this.connected) {
-            throw new Error('SSH client not connected');
+            throw new SSHTransportError('not_connected', 'SSH client not connected', { remoteEffect: 'none' });
+        }
+        const signal = opts?.signal;
+        if (signal?.aborted) {
+            throw new SSHTransportError('aborted', 'SSH command aborted before dispatch', {
+                cause: signal.reason,
+                remoteEffect: 'none',
+            });
         }
         return new Promise((resolve, reject) => {
-            // If cwd is provided, wrap command to change directory first
-            // We use simple string concatenation. In a more robust system we might want to escape the cwd path.
-            const commandToExec = opts?.cwd ? `cd "${opts.cwd}" && ${cmd}` : cmd;
-            this.client.exec(commandToExec, (err, stream) => {
-                if (err)
-                    return reject(err);
-                let stdout = '';
-                let stderr = '';
-                stream
-                    .on('close', (code) => {
-                    resolve({
-                        stdout,
-                        stderr,
-                        exitCode: code, // code is null if terminated by signal
-                        timedOut: false,
-                    });
-                })
-                    .on('data', (data) => {
-                    stdout += data.toString();
-                })
-                    .stderr.on('data', (data) => {
-                    stderr += data.toString();
-                });
+            // cwd and file paths are treated strictly as data: canonical POSIX
+            // single-quote escaping keeps quotes, $VAR, $(...), and shell operators
+            // from breaking out of the command string.
+            const commandToExec = opts?.cwd ? `cd ${quoteShellArg(opts.cwd)} && ${cmd}` : cmd;
+            const timeoutMs = opts?.timeoutMs;
+            let settled = false;
+            let stream = null;
+            let timeoutHandle;
+            let stdout = '';
+            let stderr = '';
+            // Each command builds its own typed drop error so the settlement carries
+            // that command's own partial output and message.
+            const settleOnTransportDrop = (kind, cause) => rejectWith(kind, transportDropMessage(kind, cause), { cause, remoteEffect: 'unknown' });
+            const onAbort = () => rejectWith('aborted', 'SSH command aborted', { cause: signal?.reason });
+            const onStreamClose = (code) => {
+                settle(() => resolve({ stdout, stderr, exitCode: code, timedOut: false }));
+            };
+            const onStdout = (chunk) => {
+                stdout += chunk.toString();
+            };
+            const onStderr = (chunk) => {
+                stderr += chunk.toString();
+            };
+            const onStreamError = (err) => rejectWith('channel_error', `SSH channel error: ${err.message}`, { cause: err });
+            const cleanup = () => {
+                this.activeCommandSettlers.delete(settleOnTransportDrop);
+                if (timeoutHandle !== undefined) {
+                    clearTimeout(timeoutHandle);
+                    timeoutHandle = undefined;
+                }
+                if (stream) {
+                    stream.removeListener('close', onStreamClose);
+                    stream.removeListener('data', onStdout);
+                    stream.removeListener('error', onStreamError);
+                    stream.stderr.removeListener('data', onStderr);
+                }
+                if (signal) {
+                    signal.removeEventListener('abort', onAbort);
+                }
+            };
+            function settle(fn) {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                fn();
+            }
+            function rejectWith(kind, message, options) {
+                settle(() => reject(new SSHTransportError(kind, message, { ...options, partialOutput: { stdout, stderr } })));
+            }
+            this.activeCommandSettlers.add(settleOnTransportDrop);
+            if (signal) {
+                signal.addEventListener('abort', onAbort, { once: true });
+            }
+            if (timeoutMs !== undefined && timeoutMs > 0) {
+                timeoutHandle = setTimeout(() => {
+                    timeoutHandle = undefined;
+                    rejectWith('timeout', `SSH command timed out after ${timeoutMs}ms`);
+                }, timeoutMs);
+            }
+            this.client.exec(commandToExec, (err, channel) => {
+                if (settled)
+                    return;
+                if (err) {
+                    rejectWith('exec_failed', `SSH exec failed: ${err.message}`, { cause: err });
+                    return;
+                }
+                stream = channel;
+                stream.on('close', onStreamClose);
+                stream.on('data', onStdout);
+                stream.on('error', onStreamError);
+                stream.stderr.on('data', onStderr);
             });
         });
     }
     async readFile(path) {
-        const result = await this.executeCommand(`cat "${path}"`);
+        const result = await this.executeCommand(`cat ${quoteShellArg(path)}`);
         if (result.exitCode !== 0) {
             throw new Error(`Failed to read file ${path}: ${result.stderr}`);
         }
@@ -103,7 +277,7 @@ export class SSHService {
             throw new Error('Content contains internal delimiter');
         }
         // We use cat with a quoted heredoc 'EOF' to prevent variable expansion in the content
-        const cmd = `cat > "${path}" << '${delimiter}'\n${content}\n${delimiter}`;
+        const cmd = `cat > ${quoteShellArg(path)} << '${delimiter}'\n${content}\n${delimiter}`;
         const result = await this.executeCommand(cmd);
         if (result.exitCode !== 0) {
             throw new Error(`Failed to write file ${path}: ${result.stderr}`);
@@ -111,7 +285,7 @@ export class SSHService {
     }
     async mkdir(path, opts) {
         const flags = opts?.recursive ? '-p' : '';
-        const result = await this.executeCommand(`mkdir ${flags} "${path}"`);
+        const result = await this.executeCommand(`mkdir ${flags} ${quoteShellArg(path)}`);
         if (result.exitCode !== 0) {
             throw new Error(`Failed to mkdir ${path}: ${result.stderr}`);
         }