@elhu/pit 0.1.1

package/dist/daemon/protocol.d.ts

@@ -0,0 +1,174 @@
+export declare const PROTOCOL_VERSION = "1.0";
+export type DaemonMethod = "start" | "status" | "pause" | "resume" | "log" | "stop" | "teardown" | "add" | "health" | "shutdown" | "agent-idle" | "agent-permission";
+export interface DaemonRequest {
+    id: string;
+    method: DaemonMethod;
+    params: unknown;
+}
+export interface DaemonResponse {
+    id: string;
+    success: boolean;
+    result?: unknown;
+    error?: DaemonError;
+}
+export interface DaemonError {
+    code: DaemonErrorCode;
+    message: string;
+}
+export type DaemonErrorCode = "INVALID_REQUEST" | "UNKNOWN_METHOD" | "INVALID_PARAMS" | "EPIC_NOT_FOUND" | "INVALID_STATE" | "INTERNAL_ERROR" | "TIMEOUT";
+export interface StartParams {
+    epics: string[];
+    agent?: string;
+    worktreeDir?: string;
+    baseBranch?: string;
+    promptTemplate?: string;
+    instructionsTemplate?: string;
+    /**
+     * Ticket timeout in minutes, or null to explicitly disable.
+     * Three-state semantics:
+     *   undefined = not sent (fall through to .pit.json / default)
+     *   null = user explicitly wants no timeout (override config)
+     *   number = timeout in minutes
+     */
+    ticketTimeout?: number | null;
+    /** Model to use for all epics, or null to use agent default. */
+    model?: string | null;
+    /** Per-epic model overrides, keyed by epic ID. */
+    epicModels?: Record<string, string>;
+}
+export interface StartResult {
+    sessionId: string;
+    epics: {
+        epic: string;
+        status: "ok" | "error";
+        worktreePath?: string;
+        windowName?: string;
+        error?: string;
+        /** True when this epic was already tracked and the request re-attached to it. */
+        reused?: boolean;
+        /** Current state when reused=true */
+        state?: "running" | "paused" | "done";
+        /** Progress info when reused=true */
+        progress?: {
+            done: number;
+            total: number;
+        };
+    }[];
+}
+export interface StatusResult {
+    daemonVersion: string;
+    protocolVersion: string;
+    uptime: number;
+    sessionId: string;
+    projectRoot: string;
+    tmuxSession: string;
+    epics: {
+        epic: string;
+        state: "running" | "paused" | "done";
+        progress: {
+            done: number;
+            total: number;
+        };
+        pauseReason: string | null;
+    }[];
+}
+export interface PauseParams {
+    epic: string;
+}
+export interface PauseResult {
+    epic: string;
+    previousState: string;
+    newState: "paused";
+}
+export interface ResumeParams {
+    epic: string;
+    message?: string;
+}
+export interface ResumeResult {
+    epic: string;
+    previousState: "paused";
+    newState: "running";
+    warning?: string;
+}
+export interface AgentIdleParams {
+    epicId: string;
+}
+export interface AgentIdleResult {
+    ok: boolean;
+    action?: "continue" | "done" | "paused" | "ignored";
+}
+export interface AgentPermissionParams {
+    epicId: string;
+    tool?: string;
+    input?: string;
+}
+export interface AgentPermissionResult {
+    ok: boolean;
+}
+export interface LogParams {
+    epic: string;
+    lines?: number;
+    raw?: boolean;
+}
+export interface LogResult {
+    output: string;
+    epic: string;
+    lines: number;
+}
+export interface StopParams {
+    epic?: string;
+}
+export interface StopResult {
+    success: true;
+    stopped: string[];
+}
+export interface TeardownParams {
+    epic?: string;
+    keepWorktrees?: boolean;
+    force?: boolean;
+}
+export interface TeardownResult {
+    success: true;
+    cleaned: {
+        windows: string[];
+        worktrees: string[];
+        dirtyWorktrees: string[];
+        sessionDir: string;
+    };
+}
+export interface AddParams {
+    epic: string;
+    agent?: string;
+    /** Model to use for this epic's agent. */
+    model?: string;
+}
+export interface AddResult {
+    success: true;
+    epic: string;
+    windowName: string;
+    worktreePath: string;
+    agent: string;
+}
+export interface ShutdownParams {
+    pauseEpics?: boolean;
+}
+export interface ShutdownResult {
+    success: true;
+    message: string;
+}
+export interface HealthRequest {
+    method: "health";
+}
+export interface HealthResponse {
+    success: true;
+    status: "healthy" | "degraded" | "unhealthy";
+    uptime: number;
+    memoryMB: number;
+    checks: {
+        tmuxSession: boolean;
+        epicsHealthy: number;
+        epicsDegraded: number;
+    };
+    degradedReasons: string[];
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/daemon/protocol.d.ts.map

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

package/dist/daemon/protocol.js

@@ -0,0 +1,3 @@
+// Daemon protocol definitions for JSON-based socket communication
+export const PROTOCOL_VERSION = "1.0";
+//# sourceMappingURL=protocol.js.map

package/dist/daemon/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/daemon/protocol.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC"}

package/dist/daemon/recovery.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Daemon state recovery.
+ *
+ * This module contains the logic for recovering daemon state after a restart.
+ * It is responsible for:
+ *   - Loading persisted state from disk
+ *   - Verifying the tmux session and windows still exist
+ *   - Recovering each epic's loop handle in the appropriate state
+ *   - Triggering clearAndReprompt if a ticket was completed while the daemon was down
+ *
+ * All functions accept a DaemonContext parameter instead of closing over
+ * module-level globals.
+ */
+import { type PersistedEpicState } from "./state.js";
+import type { DaemonContext, ClearAndRepromptFn } from "./context.js";
+/**
+ * Attempt to recover daemon state from a previous session.
+ *
+ * Loads persisted state, verifies the tmux session is still alive, resolves the
+ * agent adapter, and recovers each epic by calling recoverEpic(). Updates
+ * ctx.daemonState, ctx.agentInstance, ctx.debouncedSaver, and ctx.loopHandles
+ * in place.
+ */
+export declare function recoverFromPersistedState(ctx: DaemonContext, clearAndReprompt: ClearAndRepromptFn): Promise<void>;
+/**
+ * Recover a single epic from persisted state.
+ *
+ * Verifies the tmux window exists, checks whether the agent process is still
+ * running, and starts the loop handle in the appropriate state. If a ticket
+ * was closed while the daemon was down, triggers clearAndReprompt to advance
+ * to the next ticket (or transition to DONE).
+ *
+ * Returns true if recovery succeeded (loop started), false if the epic should
+ * be skipped (window gone, agent dead, etc.).
+ */
+export declare function recoverEpic(ctx: DaemonContext, epicId: string, persisted: PersistedEpicState, clearAndReprompt: ClearAndRepromptFn): Promise<boolean>;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/daemon/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/daemon/recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAyC,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAK5F,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAItE;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,aAAa,EAClB,gBAAgB,EAAE,kBAAkB,GACnC,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,kBAAkB,EAC7B,gBAAgB,EAAE,kBAAkB,GACnC,OAAO,CAAC,OAAO,CAAC,CAqIlB"}

package/dist/daemon/recovery.js

@@ -0,0 +1,197 @@
+/**
+ * Daemon state recovery.
+ *
+ * This module contains the logic for recovering daemon state after a restart.
+ * It is responsible for:
+ *   - Loading persisted state from disk
+ *   - Verifying the tmux session and windows still exist
+ *   - Recovering each epic's loop handle in the appropriate state
+ *   - Triggering clearAndReprompt if a ticket was completed while the daemon was down
+ *
+ * All functions accept a DaemonContext parameter instead of closing over
+ * module-level globals.
+ */
+import * as beads from "../beads.js";
+import { resolveAdapter } from "../adapters/index.js";
+import { createDebouncedSaver, loadDaemonState } from "./state.js";
+import { sessionExists, windowExists, sendBell } from "../tmux.js";
+import { startLoop } from "../loop.js";
+import { createLogger } from "../logger.js";
+import { makeStatusBarUpdater } from "./handlers.js";
+const logger = createLogger();
+/**
+ * Attempt to recover daemon state from a previous session.
+ *
+ * Loads persisted state, verifies the tmux session is still alive, resolves the
+ * agent adapter, and recovers each epic by calling recoverEpic(). Updates
+ * ctx.daemonState, ctx.agentInstance, ctx.debouncedSaver, and ctx.loopHandles
+ * in place.
+ */
+export async function recoverFromPersistedState(ctx, clearAndReprompt) {
+    try {
+        const persistedState = await loadDaemonState(ctx.sessionId);
+        if (!persistedState) {
+            logger.info("No persisted state found, starting fresh");
+            return;
+        }
+        // Verify tmux session still exists
+        if (!(await sessionExists(ctx.tmuxSession))) {
+            logger.warn("tmux session no longer exists, starting fresh");
+            return;
+        }
+        // Initialize daemon state with persisted data
+        ctx.agentInstance = await resolveAdapter(persistedState.agent);
+        ctx.daemonState = {
+            ...persistedState,
+            sessionId: ctx.sessionId,
+            projectRoot: ctx.projectRoot,
+            tmuxSession: ctx.tmuxSession,
+        };
+        // Create debounced saver
+        ctx.debouncedSaver = createDebouncedSaver(ctx.sessionId);
+        // Recover each epic
+        let recoveredCount = 0;
+        for (const [epicId, epicState] of Object.entries(persistedState.epics)) {
+            if (await recoverEpic(ctx, epicId, epicState, clearAndReprompt)) {
+                recoveredCount++;
+            }
+        }
+        logger.info(`Recovered ${recoveredCount} epics from persisted state`);
+        // Save recovered state
+        if (ctx.debouncedSaver && ctx.daemonState) {
+            ctx.debouncedSaver(ctx.daemonState);
+        }
+    }
+    catch (error) {
+        logger.warn("Failed to recover from persisted state, starting fresh", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+/**
+ * Recover a single epic from persisted state.
+ *
+ * Verifies the tmux window exists, checks whether the agent process is still
+ * running, and starts the loop handle in the appropriate state. If a ticket
+ * was closed while the daemon was down, triggers clearAndReprompt to advance
+ * to the next ticket (or transition to DONE).
+ *
+ * Returns true if recovery succeeded (loop started), false if the epic should
+ * be skipped (window gone, agent dead, etc.).
+ */
+export async function recoverEpic(ctx, epicId, persisted, clearAndReprompt) {
+    try {
+        // Verify tmux window exists
+        if (!(await windowExists(ctx.tmuxSession, persisted.windowName))) {
+            logger.warn(`Window for epic ${epicId} no longer exists, skipping recovery`);
+            return false;
+        }
+        // Start loop with recovered state
+        const adapter = ctx.agentInstance || (await resolveAdapter("auto"));
+        // After verifying window exists, verify agent is running
+        const agentRunning = await adapter.verifyRunning(ctx.tmuxSession, persisted.windowName);
+        if (!agentRunning) {
+            logger.warn(`Agent for epic ${epicId} is not running`, {
+                windowName: persisted.windowName,
+                lastState: persisted.state,
+            });
+            // Add this epic to daemonState with PAUSED state
+            if (ctx.daemonState) {
+                // Override recovered state to PAUSED
+                ctx.daemonState.epics[epicId] = {
+                    ...persisted,
+                    state: "PAUSED",
+                    pauseReason: "agent process not running (detected on recovery)",
+                };
+            }
+            // Ring bell to alert human
+            await sendBell(ctx.tmuxSession, persisted.windowName).catch(() => {
+                // Ignore errors - bell is best-effort
+            });
+            return false; // Don't start normal loop - agent is dead
+        }
+        // Agent is running — check beads state for current ticket
+        if (persisted.currentTicket) {
+            let ticket = null;
+            try {
+                ticket = await beads.show(persisted.currentTicket, { cwd: ctx.projectRoot });
+            }
+            catch (err) {
+                logger.warn(`[${epicId}] beads.show() failed during recovery, falling back to persisted state`, {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+            if (ticket && ticket.status === "closed") {
+                // Agent finished the ticket while daemon was down — start loop in RUNNING then
+                // immediately trigger clearAndReprompt to advance to next ticket (or DONE)
+                logger.info(`[${epicId}] Ticket ${persisted.currentTicket} closed during downtime, running clearAndReprompt`);
+                const loopHandle = startLoop({
+                    epic: epicId,
+                    tmuxSession: ctx.tmuxSession,
+                    windowName: persisted.windowName,
+                    adapter,
+                    logger: createLogger(),
+                    initialState: "RUNNING",
+                    onStatusBarUpdate: makeStatusBarUpdater(ctx),
+                });
+                ctx.loopHandles.set(epicId, loopHandle);
+                // Store initial epic state before clearAndReprompt
+                if (ctx.daemonState) {
+                    ctx.daemonState.epics[epicId] = {
+                        ...persisted,
+                        state: loopHandle.state,
+                        pauseReason: loopHandle.pauseReason,
+                    };
+                }
+                try {
+                    const { nextTicket } = await clearAndReprompt({
+                        epicId,
+                        machine: loopHandle.machine,
+                        windowName: persisted.windowName,
+                        adapter,
+                        transitionReason: "TICKET_COMPLETE",
+                        epicState: ctx.daemonState?.epics[epicId] ?? persisted,
+                    });
+                    if (ctx.daemonState) {
+                        ctx.daemonState.epics[epicId].currentTicket = nextTicket?.id ?? null;
+                        ctx.daemonState.epics[epicId].ticketStartedAt = nextTicket
+                            ? new Date().toISOString()
+                            : null;
+                        ctx.daemonState.epics[epicId].state = loopHandle.state;
+                        ctx.daemonState.epics[epicId].pauseReason = loopHandle.pauseReason;
+                        ctx.debouncedSaver?.(ctx.daemonState);
+                    }
+                }
+                catch (err) {
+                    logger.error(`[${epicId}] clearAndReprompt failed during recovery`, {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                    // Fall through — loop is still running, daemon state updated below
+                }
+                return true;
+            }
+            // else: ticket still open or beads failed → fall through to normal start
+        }
+        // Default: start loop in persisted state
+        const loopHandle = startLoop({
+            epic: epicId,
+            tmuxSession: ctx.tmuxSession,
+            windowName: persisted.windowName,
+            adapter,
+            logger: createLogger(),
+            initialState: persisted.state,
+            initialPauseReason: persisted.pauseReason,
+            onStatusBarUpdate: makeStatusBarUpdater(ctx),
+        });
+        // Store LoopHandle in daemon memory
+        ctx.loopHandles.set(epicId, loopHandle);
+        return true;
+    }
+    catch (error) {
+        logger.error(`Failed to recover epic ${epicId}`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return false;
+    }
+}
+//# sourceMappingURL=recovery.js.map

package/dist/daemon/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../src/daemon/recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAA2B,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAE9B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,GAAkB,EAClB,gBAAoC;IAEpC,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE5D,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,8CAA8C;QAC9C,GAAG,CAAC,aAAa,GAAG,MAAM,cAAc,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE/D,GAAG,CAAC,WAAW,GAAG;YAChB,GAAG,cAAc;YACjB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B,CAAC;QAEF,yBAAyB;QACzB,GAAG,CAAC,cAAc,GAAG,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEzD,oBAAoB;QACpB,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YACvE,IAAI,MAAM,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAAE,CAAC;gBAChE,cAAc,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,aAAa,cAAc,6BAA6B,CAAC,CAAC;QAEtE,uBAAuB;QACvB,IAAI,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YAC1C,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,wDAAwD,EAAE;YACpE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAkB,EAClB,MAAc,EACd,SAA6B,EAC7B,gBAAoC;IAEpC,IAAI,CAAC;QACH,4BAA4B;QAC5B,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,mBAAmB,MAAM,sCAAsC,CAAC,CAAC;YAC7E,OAAO,KAAK,CAAC;QACf,CAAC;QAED,kCAAkC;QAClC,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,IAAI,CAAC,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QAEpE,yDAAyD;QACzD,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;QAExF,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,kBAAkB,MAAM,iBAAiB,EAAE;gBACrD,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,SAAS,EAAE,SAAS,CAAC,KAAK;aAC3B,CAAC,CAAC;YAEH,iDAAiD;YACjD,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,qCAAqC;gBACrC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;oBAC9B,GAAG,SAAS;oBACZ,KAAK,EAAE,QAAQ;oBACf,WAAW,EAAE,kDAAkD;iBAChE,CAAC;YACJ,CAAC;YAED,2BAA2B;YAC3B,MAAM,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC/D,sCAAsC;YACxC,CAAC,CAAC,CAAC;YAEH,OAAO,KAAK,CAAC,CAAC,0CAA0C;QAC1D,CAAC;QAED,0DAA0D;QAC1D,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;YAC5B,IAAI,MAAM,GAA4B,IAAI,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAC/E,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CACT,IAAI,MAAM,wEAAwE,EAClF;oBACE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CACF,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACzC,+EAA+E;gBAC/E,2EAA2E;gBAC3E,MAAM,CAAC,IAAI,CACT,IAAI,MAAM,YAAY,SAAS,CAAC,aAAa,mDAAmD,CACjG,CAAC;gBAEF,MAAM,UAAU,GAAG,SAAS,CAAC;oBAC3B,IAAI,EAAE,MAAM;oBACZ,WAAW,EAAE,GAAG,CAAC,WAAW;oBAC5B,UAAU,EAAE,SAAS,CAAC,UAAU;oBAChC,OAAO;oBACP,MAAM,EAAE,YAAY,EAAE;oBACtB,YAAY,EAAE,SAAS;oBACvB,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,CAAC;iBAC7C,CAAC,CAAC;gBAEH,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBAExC,mDAAmD;gBACnD,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;oBACpB,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;wBAC9B,GAAG,SAAS;wBACZ,KAAK,EAAE,UAAU,CAAC,KAAK;wBACvB,WAAW,EAAE,UAAU,CAAC,WAAW;qBACpC,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,gBAAgB,CAAC;wBAC5C,MAAM;wBACN,OAAO,EAAE,UAAU,CAAC,OAAO;wBAC3B,UAAU,EAAE,SAAS,CAAC,UAAU;wBAChC,OAAO;wBACP,gBAAgB,EAAE,iBAAiB;wBACnC,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,SAAS;qBACvD,CAAC,CAAC;oBAEH,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;wBACpB,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,aAAa,GAAG,UAAU,EAAE,EAAE,IAAI,IAAI,CAAC;wBACrE,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,eAAe,GAAG,UAAU;4BACxD,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;4BAC1B,CAAC,CAAC,IAAI,CAAC;wBACT,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;wBACvD,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;wBACnE,GAAG,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBACxC,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,2CAA2C,EAAE;wBAClE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACxD,CAAC,CAAC;oBACH,mEAAmE;gBACrE,CAAC;gBAED,OAAO,IAAI,CAAC;YACd,CAAC;YACD,yEAAyE;QAC3E,CAAC;QAED,yCAAyC;QACzC,MAAM,UAAU,GAAG,SAAS,CAAC;YAC3B,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,OAAO;YACP,MAAM,EAAE,YAAY,EAAE;YACtB,YAAY,EAAE,SAAS,CAAC,KAAK;YAC7B,kBAAkB,EAAE,SAAS,CAAC,WAAW;YACzC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,CAAC;SAC7C,CAAC,CAAC;QAEH,oCAAoC;QACpC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAExC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,0BAA0B,MAAM,EAAE,EAAE;YAC/C,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/daemon/server.d.ts

@@ -0,0 +1,31 @@
+import { EventEmitter } from "node:events";
+import type { DaemonMethod } from "./protocol.js";
+export type RequestHandler = (params: unknown) => Promise<unknown>;
+export interface PitDaemonServerOptions {
+    sessionId: string;
+    projectRoot: string;
+    tmuxSession: string;
+    requestTimeout?: number;
+}
+export declare class PitDaemonServer extends EventEmitter {
+    private server;
+    private socketPath;
+    private requestTimeout;
+    private activeRequests;
+    private activeConnections;
+    private handlers;
+    private shuttingDown;
+    constructor(options: PitDaemonServerOptions);
+    private setupServerHandlers;
+    private handleRequest;
+    private processRequest;
+    registerHandler(method: DaemonMethod, handler: RequestHandler): void;
+    private sendResponse;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getSocketPath(): string;
+    isListening(): boolean;
+    shutdown(reason: string): Promise<void>;
+    emergencyShutdown(): void;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/daemon/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/daemon/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,KAAK,EAA8C,YAAY,EAAE,MAAM,eAAe,CAAC;AAE9F,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,sBAAsB;IAW3C,OAAO,CAAC,mBAAmB;YAoCb,aAAa;YAyIb,cAAc;IAW5B,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAIpE,OAAO,CAAC,YAAY;IAQd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,aAAa,IAAI,MAAM;IAIvB,WAAW,IAAI,OAAO;IAIhB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC7C,iBAAiB,IAAI,IAAI;CAiB1B"}