@threadbase-sh/streamer 1.62.0 → 1.64.0

package/dist/lifecycle/constants.d.ts

@@ -0,0 +1,21 @@
+export declare const LAUNCHD_LABEL = "com.ronen.threadbase";
+export declare const TASK_NAME: string;
+export declare const DEFAULT_PROD_PORT = 8766;
+export declare function installDir(): string;
+export declare function markerPath(): string;
+export declare function prefsPath(): string;
+export declare function activeLink(): string;
+/**
+ * Absolute paths to the supervised streamer's stdout/stderr logs — the single
+ * source of truth every supervisor backend and deploy script must agree on.
+ *
+ * macOS points the plist's StandardOutPath/StandardErrorPath here; Windows has
+ * no native redirection, so `scripts/deploy.ps1` writes the same two paths into
+ * launch.cmd as cmd `>>` targets. That agreement is what `tb-streamer prod logs`
+ * depends on, and it is locked by `__tests__/deploy-windows-script.test.ts`.
+ */
+export declare function logPaths(): {
+    stdout: string;
+    stderr: string;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/lifecycle/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/lifecycle/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,yBAAyB,CAAC;AACpD,eAAO,MAAM,SAAS,QAAmD,CAAC;AAC1E,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAG7D"}

package/dist/lifecycle/process-liveness.d.ts

@@ -0,0 +1,7 @@
+/**
+ * POSIX trick: kill(pid, 0) sends no signal but throws ESRCH if no such PID,
+ * EPERM if the PID exists but is owned by another user. Either way the
+ * process exists; ESRCH alone means dead.
+ */
+export declare function isPidAlive(pid: number): boolean;
+//# sourceMappingURL=process-liveness.d.ts.map

package/dist/lifecycle/process-liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-liveness.d.ts","sourceRoot":"","sources":["../../src/lifecycle/process-liveness.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAS/C"}

package/dist/live-session-manager.d.ts

@@ -0,0 +1,59 @@
+import { type ProviderName } from "./providers";
+import type { HostHeartbeatState, HostTransport } from "./pty-host/protocol";
+import type { ManagedSession, PTYManagerOptions, StartForkSessionOptions, StartFreshSessionOptions, StartSessionOptions, UserMessage } from "./types";
+export declare class LiveSessionManager {
+    private runners;
+    private remoteRunner;
+    private options;
+    constructor(options?: PTYManagerOptions);
+    useRemoteRunner(transport: HostTransport): Promise<ManagedSession[]>;
+    isRemote(): boolean;
+    startRemoteHeartbeat(getState: () => HostHeartbeatState): void;
+    start(sessionId: string, options: StartSessionOptions & {
+        provider?: ProviderName;
+    }): Promise<ManagedSession>;
+    startFresh(options: StartFreshSessionOptions & {
+        provider?: ProviderName;
+    }): Promise<ManagedSession>;
+    /**
+     * Fork an existing conversation into a new session. Codex-only: `codex fork`
+     * has no Claude Code equivalent, and there is no safe generic fallback — a
+     * silent downgrade to resume would attach to the very writer the caller is
+     * trying to leave alone.
+     */
+    startFork(options: StartForkSessionOptions & {
+        provider?: ProviderName;
+    }): Promise<ManagedSession>;
+    sendInput(sessionId: string, input: string): number;
+    sendKeys(sessionId: string, keys: string): void;
+    cancel(sessionId: string): void;
+    killPid(pid: number): void;
+    putOnHold(sessionId: string): void;
+    getOutput(sessionId: string): string;
+    getOutputLines(sessionId: string, maxLines: number): Promise<string[]>;
+    getInputHistory(sessionId: string): UserMessage[];
+    getSession(sessionId: string): ManagedSession | null;
+    getPid(sessionId: string): number | null;
+    hasSession(sessionId: string): boolean;
+    listSessions(): ManagedSession[];
+    dispose(): void;
+    private runnerFor;
+    /**
+     * Refuse before spawning when the provider's CLI is not on this machine.
+     *
+     * Without this the spawn "succeeds": on POSIX execvp fails inside the forked
+     * child, so a session appears, exits ~12ms later with code 1 and no output,
+     * and the caller is told only that it "exited before becoming ready" — or,
+     * on the Claude resume path, is told nothing at all, since that path answers
+     * 200 before the process has had a chance to die. Every start route funnels
+     * through here, so one check covers start, resume, adopt and fork.
+     *
+     * 503, not 500: the request was well-formed and the fault is this machine's
+     * environment. `code` is what mobile branches on (it reads `errBody.code`),
+     * and `PROVIDER_NOT_INSTALLED` is a remediation string it already knows.
+     */
+    private assertProviderInstalled;
+    private assertSupportedProvider;
+    private activeRunners;
+}
+//# sourceMappingURL=live-session-manager.d.ts.map

package/dist/live-session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-session-manager.d.ts","sourceRoot":"","sources":["../src/live-session-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4C,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAEjB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,OAAO,CAAoB;IAEnC,YAAY,OAAO,GAAE,iBAAsB,EAM1C;IAEK,eAAe,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAQzE;IAED,QAAQ,IAAI,OAAO,CAElB;IAED,oBAAoB,CAAC,QAAQ,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAE7D;IAEK,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mBAAmB,GAAG;QAAE,QAAQ,CAAC,EAAE,YAAY,CAAA;KAAE,GACzD,OAAO,CAAC,cAAc,CAAC,CAKzB;IAEK,UAAU,CACd,OAAO,EAAE,wBAAwB,GAAG;QAAE,QAAQ,CAAC,EAAE,YAAY,CAAA;KAAE,GAC9D,OAAO,CAAC,cAAc,CAAC,CAKzB;IAED;;;;;OAKG;IACG,SAAS,CACb,OAAO,EAAE,uBAAuB,GAAG;QAAE,QAAQ,CAAC,EAAE,YAAY,CAAA;KAAE,GAC7D,OAAO,CAAC,cAAc,CAAC,CAczB;IAED,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;IAED,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C;IAED,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9B;IAED,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIzB;IAOD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAUjC;IAED,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnC;IAED,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAErE;IAED,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAEhD;IAED,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAMnD;IAKD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMvC;IAED,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAKrC;IAED,YAAY,IAAI,cAAc,EAAE,CAE/B;IAED,OAAO,IAAI,IAAI,CAId;IAKD,OAAO,CAAC,SAAS;IAOjB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,aAAa;CAGtB"}

package/dist/logger.d.ts

@@ -0,0 +1,14 @@
+import { type Logger as PinoLogger } from "pino";
+export type LogDest = "console" | "pino" | "both";
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface Logger {
+    debug(msg: string, fields?: Record<string, unknown>, dest?: LogDest): void;
+    info(msg: string, fields?: Record<string, unknown>, dest?: LogDest): void;
+    warn(msg: string, fields?: Record<string, unknown>, dest?: LogDest): void;
+    error(msg: string, fields?: Record<string, unknown>, dest?: LogDest): void;
+    log(level: LogLevel, msg: string, fields?: Record<string, unknown>, dest?: LogDest): void;
+    pino: PinoLogger;
+}
+export declare function getLogger(component?: string): Logger;
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAa,EAAE,KAAK,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvD,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAClD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAY3D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3E,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1E,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1E,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3E,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1F,IAAI,EAAE,UAAU,CAAC;CAClB;AAiDD,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,eAAO,MAAM,MAAM,EAAE,MAA0B,CAAC"}

package/dist/pair-store.d.ts

@@ -0,0 +1,60 @@
+export interface PairTokenRecord {
+    token: string;
+    expiresAt: number;
+    used: boolean;
+}
+export interface MintResult {
+    token: string;
+    expiresAt: number;
+    expiresInSeconds: number;
+}
+export interface ConsumeOk {
+    ok: true;
+}
+export interface ConsumeErr {
+    ok: false;
+    reason: "unknown" | "expired" | "used";
+}
+export type ConsumeResult = ConsumeOk | ConsumeErr;
+export declare class PairTokenStore {
+    private current;
+    private readonly ttlMs;
+    private sweepTimer;
+    constructor(opts?: {
+        ttlSeconds?: number;
+        autoSweep?: boolean;
+    });
+    mint(): MintResult;
+    /**
+     * What `consume` would answer right now, WITHOUT spending the token.
+     *
+     * Exists so a caller can reject a bad token before doing any work, and still
+     * spend the token only once the work has succeeded. A pair token is
+     * single-use and lives 180 seconds, so spending it on a request that then
+     * fails costs the user a whole new QR — and, worse, makes their retry
+     * indistinguishable from an attacker replaying a photographed code, which is
+     * the one signal `design.md` §2.6 designates as replay detection.
+     *
+     * **Named for its relationship to `consume`, deliberately.** It reserves
+     * nothing and takes no lock, so two callers can both be told `{ ok: true }`
+     * for the same token. A name like `verify` would read as a gate that had
+     * decided something, and inviting a caller to act on this alone is precisely
+     * the misuse the ordering it enables exists to prevent. A reader who sees
+     * `wouldConsume` asks where the `consume` is, which is the right question.
+     */
+    wouldConsume(token: string): ConsumeResult;
+    consume(token: string): ConsumeResult;
+    /**
+     * The shared predicate behind `verify` and `consume`.
+     *
+     * One implementation on purpose: two copies of "is this token usable" is two
+     * places for the expiry or single-use rule to drift, and a drift in this
+     * direction fails open.
+     */
+    private check;
+    peek(): PairTokenRecord | null;
+    clear(): void;
+    sweep(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=pair-store.d.ts.map

package/dist/pair-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pair-store.d.ts","sourceRoot":"","sources":["../src/pair-store.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,IAAI,CAAC;CACV;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAKnD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,UAAU,CAA+C;IAEjE,YAAY,IAAI,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,EAMlE;IAED,IAAI,IAAI,UAAU,CASjB;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAGzC;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAKpC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAK;IAWb,IAAI,IAAI,eAAe,GAAG,IAAI,CAE7B;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,KAAK,IAAI,IAAI,CAIZ;IAED,OAAO,IAAI,IAAI,CAId;CACF"}

package/dist/platform.d.ts

@@ -0,0 +1,25 @@
+import { execFileSync } from "child_process";
+import { type ProviderName } from "./providers";
+export declare const isWindows: boolean;
+export declare function clearClaudeExeCache(): void;
+export declare function resolveClaudeExe(): string;
+export declare function clearCodexExeCache(): void;
+export declare function resolveCodexExe(): string;
+/**
+ * Where `exe` — a resolver's output — actually lives, or null if nowhere.
+ *
+ * A value carrying a path separator is checked directly; a bare command name is
+ * searched along PATH exactly the way execvp will search it. node-pty inherits
+ * the streamer's own environment (`buildSpawnEnv`), so the PATH walked here is
+ * the PATH the spawned child gets — which is what makes this predictive of the
+ * spawn rather than merely correlated with it.
+ */
+export declare function locateExecutable(exe: string): string | null;
+/** Where this provider's CLI lives on this machine, or null if it is absent. */
+export declare function locateProviderExe(provider: ProviderName): string | null;
+type SyncOptions = Parameters<typeof execFileSync>[2];
+export declare function execHidden(file: string, args: string[], opts?: SyncOptions & {
+    encoding: "utf-8";
+}): string;
+export {};
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEpE,eAAO,MAAM,SAAS,SAAyB,CAAC;AAkChD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAiEzC;AAWD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAiExC;AA2BD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuB3D;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAWvE;AAOD,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE,WAAW,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GACzC,MAAM,CAKR"}

package/dist/process-discovery.d.ts

@@ -0,0 +1,35 @@
+import type { DiscoveredProcess } from "./types";
+export declare function discoverClaudeProcesses(): Promise<DiscoveredProcess[]>;
+export declare function tokenizeCommandLine(commandLine: string): string[];
+/**
+ * Whether a command line is a Claude Code CLI process.
+ *
+ * Accepts a native binary invoked by any path, and a JS runtime hosting the
+ * published CLI entry point. Deliberately conservative: it inspects only the
+ * executable and the script it runs, never the whole string, so an unrelated
+ * process that merely mentions "claude" in a flag (an editor session, this
+ * streamer itself) is not mistaken for an agent.
+ */
+export declare function looksLikeClaudeProcess(commandLine: string): boolean;
+export declare function parsePsOutput(stdout: string): number[];
+/**
+ * Full command line of a single live process, or "" if it cannot be read.
+ *
+ * Used by the boot reconciler's pid-reuse guard: a recorded pid being alive is
+ * never sufficient evidence that the process is still ours, because pids get
+ * recycled. The caller matches its stored token against this before claiming a
+ * surviving session — and treats an unreadable command line as "cannot confirm"
+ * rather than "confirmed", so a failure here can never promote an unrelated
+ * process into a managed session.
+ */
+export declare function getProcessArgs(pid: number): Promise<string>;
+interface CimProcess {
+    ProcessId: number;
+    CommandLine: string | null;
+    CreationDate: string | null;
+}
+export declare function parseCimProcesses(stdout: string): CimProcess[];
+export declare function parseCimDate(value: string | null): Date;
+export declare function extractResumeId(args: string): string | null;
+export {};
+//# sourceMappingURL=process-discovery.d.ts.map

package/dist/process-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-discovery.d.ts","sourceRoot":"","sources":["../src/process-discovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAG5E;AAaD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBjE;AAWD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAenE;AAwFD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAYtD;AAiCD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAajE;AAUD,UAAU,UAAU;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAKD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAK9D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAQvD;AAgHD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO3D"}

package/dist/providers.d.ts

@@ -0,0 +1,7 @@
+export declare const CLAUDE_CODE_PROVIDER: "claude-code";
+export declare const CODEX_CLI_PROVIDER: "codex-cli";
+export type ProviderName = typeof CLAUDE_CODE_PROVIDER | typeof CODEX_CLI_PROVIDER;
+export declare function isProviderName(value: unknown): value is ProviderName;
+export declare function coerceProviderForRunner(value: unknown): ProviderName;
+export declare function isProviderResumable(_provider: string | null | undefined, availabilityResumable: boolean): boolean;
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,EAAG,aAAsB,CAAC;AAC3D,eAAO,MAAM,kBAAkB,EAAG,WAAoB,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,OAAO,oBAAoB,GAAG,OAAO,kBAAkB,CAAC;AAEnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAEpE;AAQD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,qBAAqB,EAAE,OAAO,GAC7B,OAAO,CAET"}

package/dist/pty-host/protocol.d.ts

@@ -0,0 +1,270 @@
+import type { ProviderName } from "../providers";
+import type { AgentPhase, AskQuestion, ManagedSession, PermissionOption, StartFreshSessionOptions, StartSessionOptions, UserMessage } from "../types";
+/**
+ * Wire protocol between the streamer and `tb-streamer pty-host`
+ * (persistence plan Phase 6a).
+ * See docs/plans/live-sessions-persistence-plan.md §4 and
+ * docs/architecture/2026-07-24-durable-session-runtime.md (alternative D).
+ *
+ * The point of the host is that the PTY master fd is held by a process that is
+ * NOT being restarted. Everything the audit lists as lost with the streamer —
+ * node-pty, the ring buffer, the xterm screen, inputHistory, pendingReady,
+ * queuedInputs, and the prompt/gate detectors — lives on the host side of this
+ * boundary; the streamer keeps only a mirror it can rebuild from `status`.
+ *
+ * Newline-delimited JSON rather than a binary framing: PTY output is already
+ * being JSON-escaped for the WebSocket hub a layer above, the volumes are a
+ * terminal's worth of bytes rather than a video stream, and a protocol you can
+ * read with `nc` is worth more during an incident than the bytes it saves.
+ *
+ * Two message directions, never mixed:
+ *
+ *  - **Requests** (streamer → host) each carry an `id` and are answered by
+ *    exactly one `Response` with the same `id`.
+ *  - **Events** (host → streamer) are unsolicited and carry no `id`. They are
+ *    the transport for what are callbacks in `PTYManagerOptions` today; the
+ *    detectors that fire them run in the host, so every one of those callbacks
+ *    needs an event here or the feature silently stops working when the flag
+ *    is on. That is why this list is longer than the sketch in the plan.
+ *
+ * Deliberately absent: `resize`. The plan lists it, but PTY dimensions are the
+ * fixed `PTY_COLS`/`PTY_ROWS` constants and `SessionRunner` has no resize
+ * method, so the verb would be one nothing could ever send. Add it with the
+ * caller that needs it.
+ */
+/**
+ * Bumped on any incompatible change to the shapes below. Version 2 adds the
+ * heartbeat and shutdown controls required for host supervision. Version 3
+ * adds the `phase-change` event — the detector runs in the host, so without a
+ * verb here the agent-phase indicator silently stops working when the flag is
+ * on, which is exactly the failure this file's header warns about.
+ */
+export declare const PTY_HOST_PROTOCOL_VERSION = 3;
+export interface HostHeartbeatState {
+    registryState: "known" | "unknown";
+    referencedSessionIds: string[];
+}
+/** `spawn` with a null sessionId means startFresh — the host assigns the id. */
+export type SpawnRequest = {
+    id: number;
+    type: "spawn";
+    provider: ProviderName;
+} & ({
+    sessionId: string;
+    options: StartSessionOptions;
+} | {
+    sessionId: null;
+    options: StartFreshSessionOptions;
+});
+export type HostRequest = SpawnRequest
+/** A submitted user message. Answered with the session's new promptCount. */
+ | {
+    id: number;
+    type: "write";
+    sessionId: string;
+    input: string;
+}
+/** Raw keystrokes — never recorded as a user message. */
+ | {
+    id: number;
+    type: "keys";
+    sessionId: string;
+    keys: string;
+}
+/** Begin receiving events. Sent once per connection after status passes the version check. */
+ | {
+    id: number;
+    type: "subscribe";
+}
+/** The rendered screen, newest `maxLines` rows, in true on-screen order. */
+ | {
+    id: number;
+    type: "replay";
+    sessionId: string;
+    maxLines: number;
+} | {
+    id: number;
+    type: "input-history";
+    sessionId: string;
+} | {
+    id: number;
+    type: "cancel";
+    sessionId: string;
+}
+/**
+ * Stop a session. `hold` is `putOnHold` (SIGINT, history intact, resumable);
+ * without it, and addressed by `pid`, it is `killPid`. One verb because the
+ * host's answer is the same either way: that process is no longer running.
+ */
+ | {
+    id: number;
+    type: "kill";
+    sessionId: string;
+    hold: true;
+} | {
+    id: number;
+    type: "kill";
+    pid: number;
+    hold?: false;
+} | ({
+    id: number;
+    type: "heartbeat";
+} & HostHeartbeatState)
+/** Stop this host after acknowledging the request. Used only on version skew. */
+ | {
+    id: number;
+    type: "shutdown-host";
+}
+/** Every session the host owns. Seeds the streamer's mirror on connect. */
+ | {
+    id: number;
+    type: "status";
+};
+export type HostRequestType = HostRequest["type"];
+/**
+ * One response per request, correlated by `id`.
+ *
+ * A failure is a value, not a dropped message: a request that never gets a
+ * response leaves the caller's promise pending forever, which is how a
+ * transport bug turns into a hung session start rather than an error.
+ */
+export type HostResponse = {
+    id: number;
+    ok: true;
+    result: unknown;
+} | {
+    id: number;
+    ok: false;
+    error: string;
+};
+/**
+ * Unsolicited host → streamer messages. One per `PTYManagerOptions` callback,
+ * plus `exit`, which is `onStatusChange` with the process actually gone.
+ */
+export type HostEvent = {
+    type: "event";
+    event: "output";
+    sessionId: string;
+    data: string;
+} | {
+    type: "event";
+    event: "status-change";
+    session: ManagedSession;
+} | {
+    type: "event";
+    event: "ready";
+    session: ManagedSession;
+} | {
+    type: "event";
+    event: "permission-change";
+    sessionId: string;
+    gate: {
+        prompt?: string;
+        detail?: string;
+        options: PermissionOption[];
+        cursor?: number;
+    } | null;
+}
+/**
+ * Agent phase changed within a running turn, including to `null` at turn
+ * end. Carries the same always-present/nullable contract as the wire field:
+ * absence must never mean "cleared", because the consumer merges state.
+ */
+ | {
+    type: "event";
+    event: "phase-change";
+    sessionId: string;
+    phase: AgentPhase | null;
+} | {
+    type: "event";
+    event: "live-question";
+    sessionId: string;
+    questions: AskQuestion[];
+} | {
+    type: "event";
+    event: "live-question-gone";
+    sessionId: string;
+} | {
+    type: "event";
+    event: "user-message";
+    sessionId: string;
+    text: string;
+    ts: number;
+} | {
+    type: "event";
+    event: "exit";
+    sessionId: string;
+    exitCode: number;
+};
+export type HostMessage = HostResponse | HostEvent;
+export declare function isHostEvent(message: HostMessage): message is HostEvent;
+/**
+ * A request minus the `id` the sender assigns.
+ *
+ * Distributive on purpose: a plain `Omit<HostRequest, "id">` collapses the
+ * union into its common keys, which loses `sessionId`, `provider` and the rest
+ * — so every call site fails to type-check against a request shape that is
+ * actually correct.
+ */
+export type HostRequestBody = HostRequest extends infer T ? T extends {
+    id: number;
+} ? Omit<T, "id"> : never : never;
+/**
+ * A session plus the one thing `ManagedSession` does not carry: the OS pid.
+ *
+ * The in-process runners read it off the node-pty handle, which lives on the
+ * host now — and the durable registry needs it at spawn to record something a
+ * later boot can probe. It is fixed for the life of a session, so `spawn` and
+ * `status` are the only messages that carry it.
+ */
+export interface HostSession {
+    session: ManagedSession;
+    pid: number | null;
+}
+/** Result shapes, named so both ends agree on what a given request answers. */
+export interface StatusResult {
+    protocolVersion: number;
+    sessions: HostSession[];
+}
+export interface InputHistoryResult {
+    history: UserMessage[];
+}
+export interface ReplayResult {
+    lines: string[];
+    /** The raw ring buffer, so a reconnecting streamer can restore `getOutput`. */
+    output: string;
+}
+/**
+ * A duplex line channel. Deliberately not a socket: the runner is tested
+ * against an in-memory pair, and PR 7 supplies the real one over a unix socket
+ * (POSIX) or named pipe (Windows).
+ */
+export interface HostTransport {
+    send(line: string): void;
+    onLine(handler: (line: string) => void): void;
+    onClose(handler: () => void): void;
+    close(): void;
+}
+/**
+ * Restore a `ManagedSession` that crossed the wire.
+ *
+ * JSON turns every `Date` into a string, and `ManagedSession.startedAt` is read
+ * as a Date all over the server (`elapsedMs` arithmetic, `toISOString()`).
+ * Without this the failure is a string where a Date is expected — which does
+ * not throw, it produces `NaN` elapsed times and a crash only at the
+ * `.toISOString()` call sites.
+ */
+export declare function reviveSession(raw: unknown): ManagedSession;
+export declare function encodeMessage(message: HostRequest | HostMessage): string;
+/**
+ * Reassemble newline-delimited JSON from arbitrarily-chunked reads.
+ *
+ * A socket splits wherever it likes, so "one chunk is one message" holds right
+ * up until a PTY burst makes it false. Stateful for exactly that reason: the
+ * tail of a chunk is held until its newline arrives.
+ */
+export declare class LineDecoder {
+    private buffer;
+    push(chunk: string): string[];
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/pty-host/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/pty-host/protocol.ts"],"names":[],"mappings":"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"}