parasor 0.1.0

package/server/pty/version-mismatch-recovery.js

@@ -0,0 +1,63 @@
+/**
+ * Recover from a `version-mismatch` HELLO NACK by terminating the
+ * incompatible daemon, spawning a fresh one, and re-running the
+ * handshake. Generic over the host shape so the orchestrator does not
+ * depend on `RemotePtyHost` directly -- the caller passes
+ * `connectHost: (opts) => RemotePtyHost.connect(opts)`.
+ *
+ * The four wrapped error branches surface the original `Check
+ * ${paths.logFile}.` tail so operators can immediately reach for the
+ * daemon log; the `still-alive` branch instead points at `parasor
+ * pty-host stop --force` since the failure is process-level, not log-
+ * level.
+ */
+export async function recoverFromVersionMismatch(input, deps) {
+    const mismatch = deps.parseVersionMismatch(input.originalError.message);
+    deps.logStderr(`parasor-pty-host: ${input.originalError.message}. ` +
+        `terminating incompatible daemon -- active PTY sessions will be lost.\n`);
+    const term = await deps.terminateDaemon(input.paths);
+    if (term.outcome === "still-alive") {
+        throw new Error(`parasor-pty-host: failed to terminate incompatible daemon ` +
+            `(pid ${term.pid} survived SIGKILL). ` +
+            `Run \`parasor pty-host stop --force\` and restart parasor.`);
+    }
+    try {
+        await deps.spawnDaemon({ paths: input.paths });
+    }
+    catch (spawnErr) {
+        throw new Error(`parasor-pty-host: terminated old daemon but failed to start ` +
+            `replacement: ${spawnErr.message}. ` +
+            `Check ${input.paths.logFile}.`);
+    }
+    let recoverySocket;
+    try {
+        recoverySocket = await deps.connectSocket(input.paths.socketPath);
+    }
+    catch (reconnectErr) {
+        throw new Error(`parasor-pty-host: replacement daemon socket unreachable: ` +
+            `${reconnectErr.message}. Check ${input.paths.logFile}.`);
+    }
+    try {
+        const host = await deps.connectHost({
+            socket: recoverySocket,
+            scrollbackLog: input.scrollbackLog,
+        });
+        deps.logStderr("parasor-pty-host: replacement daemon online; resuming server boot.\n");
+        input.onDaemonAutoRestarted?.({
+            serverProtocolVersion: input.protocolVersion,
+            daemonProtocolVersion: mismatch?.daemon ?? "unknown",
+        });
+        return host;
+    }
+    catch (recoveryErr) {
+        try {
+            recoverySocket.destroy();
+        }
+        catch {
+            /* socket may already be in error state */
+        }
+        throw new Error(`parasor-pty-host: handshake to replacement daemon failed: ` +
+            `${recoveryErr.message}. Check ${input.paths.logFile}.`);
+    }
+}
+//# sourceMappingURL=version-mismatch-recovery.js.map

package/server/pty/version-mismatch-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-mismatch-recovery.js","sourceRoot":"","sources":["../../src/pty/version-mismatch-recovery.ts"],"names":[],"mappings":"AAsFA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAmC,EACnC,IAAoC;IAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACxE,IAAI,CAAC,SAAS,CACZ,qBAAqB,KAAK,CAAC,aAAa,CAAC,OAAO,IAAI;QAClD,wEAAwE,CAC3E,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,4DAA4D;YAC1D,QAAQ,IAAI,CAAC,GAAG,sBAAsB;YACtC,4DAA4D,CAC/D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,QAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,8DAA8D;YAC5D,gBAAiB,QAAkB,CAAC,OAAO,IAAI;YAC/C,SAAS,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAClC,CAAC;IACJ,CAAC;IACD,IAAI,cAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,cAAc,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,YAAY,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,2DAA2D;YACzD,GAAI,YAAsB,CAAC,OAAO,WAAW,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CACtE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YAClC,MAAM,EAAE,cAAc;YACtB,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CACZ,sEAAsE,CACvE,CAAC;QACF,KAAK,CAAC,qBAAqB,EAAE,CAAC;YAC5B,qBAAqB,EAAE,KAAK,CAAC,eAAe;YAC5C,qBAAqB,EAAE,QAAQ,EAAE,MAAM,IAAI,SAAS;SACrD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,WAAW,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,cAAc,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;QACD,MAAM,IAAI,KAAK,CACb,4DAA4D;YAC1D,GAAI,WAAqB,CAAC,OAAO,WAAW,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CACrE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/server/routes/debug-agent-status.d.ts

@@ -0,0 +1,5 @@
+import type { AgentState } from "@parasor/shared";
+import { Hono } from "hono";
+import type { AgentStatusRecorder } from "../debug/agent-status-recorder.js";
+export declare function createDebugAgentStatusRoute(recorder: AgentStatusRecorder, getStates: () => Record<string, AgentState>): Hono;
+//# sourceMappingURL=debug-agent-status.d.ts.map

package/server/routes/debug-agent-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-agent-status.d.ts","sourceRoot":"","sources":["../../src/routes/debug-agent-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAC1C,IAAI,CAuBN"}

package/server/routes/debug-agent-status.js

@@ -0,0 +1,22 @@
+import { Hono } from "hono";
+export function createDebugAgentStatusRoute(recorder, getStates) {
+    const routes = new Hono();
+    routes.get("/", (c) => {
+        const sinceRaw = c.req.query("since");
+        const since = sinceRaw === undefined ? null : Number(sinceRaw);
+        const events = since !== null && Number.isFinite(since)
+            ? recorder.listSince(since)
+            : recorder.list();
+        return c.json({
+            states: getStates(),
+            events,
+        });
+    });
+    routes.delete("/", async (c) => {
+        recorder.clear();
+        await recorder.clearPersistedLog();
+        return c.json({ ok: true });
+    });
+    return routes;
+}
+//# sourceMappingURL=debug-agent-status.js.map

package/server/routes/debug-agent-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-agent-status.js","sourceRoot":"","sources":["../../src/routes/debug-agent-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,MAAM,UAAU,2BAA2B,CACzC,QAA6B,EAC7B,SAA2C;IAE3C,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;IAE1B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACpB,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/D,MAAM,MAAM,GACV,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACtC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC;YAC3B,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,SAAS,EAAE;YACnB,MAAM;SACP,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QACnC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/server/routes/debug-diagnostics.d.ts

@@ -0,0 +1,8 @@
+import { Hono } from "hono";
+import type { TerminalTraceRecorder } from "../debug/terminal-trace-recorder.js";
+interface DebugDiagnosticsRouteDeps {
+    terminalTraceRecorder: TerminalTraceRecorder;
+}
+export declare function createDebugDiagnosticsRoute({ terminalTraceRecorder, }: DebugDiagnosticsRouteDeps): Hono;
+export {};
+//# sourceMappingURL=debug-diagnostics.d.ts.map

package/server/routes/debug-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-diagnostics.d.ts","sourceRoot":"","sources":["../../src/routes/debug-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF,UAAU,yBAAyB;IACjC,qBAAqB,EAAE,qBAAqB,CAAC;CAC9C;AAWD,wBAAgB,2BAA2B,CAAC,EAC1C,qBAAqB,GACtB,EAAE,yBAAyB,GAAG,IAAI,CA6BlC"}

package/server/routes/debug-diagnostics.js

@@ -0,0 +1,34 @@
+import { Hono } from "hono";
+function diagnosticsSummary(terminalTraceRecorder) {
+    return {
+        diagnostics: {
+            enabled: terminalTraceRecorder.isEnabled(),
+        },
+        terminalTrace: terminalTraceRecorder.summary(),
+    };
+}
+export function createDebugDiagnosticsRoute({ terminalTraceRecorder, }) {
+    const routes = new Hono();
+    routes.get("/", (c) => {
+        return c.json(diagnosticsSummary(terminalTraceRecorder));
+    });
+    routes.post("/", async (c) => {
+        const body = await c.req
+            .json()
+            .catch(() => ({}));
+        if (typeof body.enabled === "boolean") {
+            terminalTraceRecorder.setEnabled(body.enabled);
+        }
+        if (body.clear === true) {
+            terminalTraceRecorder.clear();
+        }
+        return c.json(diagnosticsSummary(terminalTraceRecorder));
+    });
+    routes.delete("/", (c) => {
+        terminalTraceRecorder.setEnabled(false);
+        terminalTraceRecorder.clear();
+        return c.json(diagnosticsSummary(terminalTraceRecorder));
+    });
+    return routes;
+}
+//# sourceMappingURL=debug-diagnostics.js.map

package/server/routes/debug-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-diagnostics.js","sourceRoot":"","sources":["../../src/routes/debug-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAO5B,SAAS,kBAAkB,CAAC,qBAA4C;IACtE,OAAO;QACL,WAAW,EAAE;YACX,OAAO,EAAE,qBAAqB,CAAC,SAAS,EAAE;SAC3C;QACD,aAAa,EAAE,qBAAqB,CAAC,OAAO,EAAE;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,EAC1C,qBAAqB,GACK;IAC1B,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;IAE1B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACpB,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG;aACrB,IAAI,EAA0C;aAC9C,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAA2C,CAAC,CAAC;QAE/D,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACtC,qBAAqB,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,qBAAqB,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;QAED,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;QACvB,qBAAqB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACxC,qBAAqB,CAAC,KAAK,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/server/routes/debug-terminal-trace.d.ts

@@ -0,0 +1,16 @@
+import { Hono } from "hono";
+import type { TerminalTraceRecorder } from "../debug/terminal-trace-recorder.js";
+import type { PtyHost } from "../pty/host.js";
+import type { AppStateStore } from "../state/app-state.js";
+import type { ProjectManager } from "../state/project-manager.js";
+import type { EventBus } from "../ws/events.js";
+interface DebugTerminalTraceRouteDeps {
+    recorder: TerminalTraceRecorder;
+    ptyManager: PtyHost;
+    eventBus: EventBus;
+    appStateStore: AppStateStore;
+    projectManager: ProjectManager;
+}
+export declare function createDebugTerminalTraceRoute({ recorder, ptyManager, eventBus, appStateStore, projectManager, }: DebugTerminalTraceRouteDeps): Hono;
+export {};
+//# sourceMappingURL=debug-terminal-trace.d.ts.map

package/server/routes/debug-terminal-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-terminal-trace.d.ts","sourceRoot":"","sources":["../../src/routes/debug-terminal-trace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAOhD,UAAU,2BAA2B;IACnC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;CAChC;AA8fD,wBAAgB,6BAA6B,CAAC,EAC5C,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,aAAa,EACb,cAAc,GACf,EAAE,2BAA2B,GAAG,IAAI,CAgLpC"}