parasor 0.1.0

package/server/pty/host-daemon/daemon.d.ts

@@ -0,0 +1,111 @@
+import type { AppStateStore } from "../../state/app-state.js";
+import type { PtyHost } from "../host.js";
+import { ServerConnection } from "./server-connection.js";
+export interface PtyHostDaemonDeps {
+    host: PtyHost;
+    daemonPid?: number;
+    daemonStartedAt?: string;
+    /**
+     * daemon state ownership -- store the daemon writes when it adopts a server-pushed
+     * project-domain snapshot via PERSIST_PROJECT_DOMAINS_REQ. Optional
+     * because in-process tests / phase1 fixtures may not need the
+     * persistence handler. When omitted, the request is NACK'd with
+     * `internal-error` so misconfiguration surfaces loudly instead of
+     * silently dropping mutations.
+     */
+    store?: AppStateStore;
+}
+export declare class PtyHostDaemon {
+    private readonly host;
+    private readonly store;
+    private readonly daemonPid;
+    private readonly daemonStartedAt;
+    private currentServer;
+    private nextConnectionId;
+    private nextGeneration;
+    private disposed;
+    private readonly inFlight;
+    constructor(deps: PtyHostDaemonDeps);
+    /**
+     * Hand the daemon a freshly-accepted IPC socket. The peer is expected
+     * to send HELLO as its first frame; until then the connection sits in
+     * `awaiting-hello` and is not yet considered current.
+     *
+     * Eviction is deferred to HELLO time so that a probe connect (e.g. the
+     * server's startup health check) doesn't kick off the previous current.
+     */
+    acceptConnection(socket: import("node:stream").Duplex): ServerConnection;
+    /**
+     * Stop accepting frames and evict the current peer with a shutdown
+     * NACK so it knows not to try to reconnect. Does NOT terminate the
+     * underlying PtyHost -- that's the caller's call (see by design
+     * the in-process vs daemon-mode shutdown semantics divergence).
+     */
+    dispose(): void;
+    /**
+     * Wait for every host-call chain currently in flight to settle. Caller
+     * (bootstrap.shutdown) runs this between `dispose()` and `host.shutdownAll()`
+     * so a CREATE that won the race against SIGTERM finishes its persist
+     * step before shutdownAll iterates `this.sessions`. New frames are
+     * already blocked at this point: `dispose()` evicts the current peer
+     * and the listening sockets are closed in bootstrap before drain runs,
+     * so `inFlight` is monotonically shrinking.
+     *
+     * Bounded by `timeoutMs` (default 3s) so a hung host call (network
+     * filesystem stall, disk timeout) cannot block the entire shutdown
+     * path -- `shutdownAll`, marker write, and lock release all need to
+     * run for the user to recover (). On timeout
+     * the pending chains keep running but are no longer awaited; they
+     * will settle against a destroyed store and best-effort log the loss.
+     * Returns `true` when fully drained, `false` on timeout.
+     */
+    drain(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Track a host-call chain (the full Promise including its `.then`/`.catch`
+     * handlers, not just the host's underlying Promise). Removes itself on
+     * settle so the `Set` does not leak.
+     */
+    private track;
+    private handleFrame;
+    private handleHello;
+    private dispatchReady;
+    private handleCreate;
+    private handleRestart;
+    private handleDispose;
+    private handleDisposeAll;
+    private handleShutdownAll;
+    private handleInitClient;
+    private handleWrite;
+    private handleResize;
+    private handleRefresh;
+    private handlePauseOutput;
+    private handleResumeOutput;
+    private handleDetachClient;
+    private handleSetTitle;
+    private handleSetPinned;
+    private handleSetPtyEnv;
+    private handlePersistProjectDomains;
+    private broadcastJson;
+    private broadcastStream;
+    private broadcastDataStream;
+    private broadcastSessionUpdate;
+    /**
+     * Send a fresh SESSION_LIST snapshot to the current peer. Used by
+     * dispose paths because InProcessPtyHost.dispose() removes the session
+     * silently, so neither SESSION_UPDATE nor SESSION_EXIT carries the
+     * removal -- we instead resync via a full snapshot. Cheap: list() is
+     * just a Map values() copy.
+     */
+    private broadcastSessionListSnapshot;
+    private maybeBroadcastSessionUpdate;
+    /**
+     * Stage-3 fence (by design): called from async ack callbacks. If the
+     * connection that issued the request is no longer current, drop the
+     * ack -- its server has been evicted and any reply would arrive with
+     * a stale (connectionId, generation) pair the new peer would reject.
+     */
+    private fenceCommit;
+    private replyNack;
+    private handleConnectionClosed;
+}
+//# sourceMappingURL=daemon.d.ts.map

package/server/pty/host-daemon/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../../src/pty/host-daemon/daemon.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAmC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAqC1D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,QAAQ,CAAS;IAazB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;gBAE5C,IAAI,EAAE,iBAAiB;IA+BnC;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAM,EAAE,OAAO,aAAa,EAAE,MAAM,GAAG,gBAAgB;IAexE;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAYf;;;;;;;;;;;;;;;;OAgBG;IACG,KAAK,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAc/C;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,WAAW;IAkCnB,OAAO,CAAC,WAAW;IAsDnB,OAAO,CAAC,aAAa;IA+DrB,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,aAAa;IAiCrB,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,gBAAgB;IA+CxB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,2BAA2B;IAkFnC,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;IAkB3B,OAAO,CAAC,sBAAsB;IAQ9B;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IAMpC,OAAO,CAAC,2BAA2B;IAWnC;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,sBAAsB;CAG/B"}