@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/modes/interactive/components/user-message.js

@@ -0,0 +1,42 @@
+import { Container, Markdown, Spacer } from "@hansjm10/volt-tui";
+import { getMarkdownTheme, theme } from "../../../core/theme/runtime.js";
+const OSC133_ZONE_START = "\x1b]133;A\x07";
+const OSC133_ZONE_END = "\x1b]133;B\x07";
+const OSC133_ZONE_FINAL = "\x1b]133;C\x07";
+class UserMessageRail {
+    content;
+    constructor(content) {
+        this.content = content;
+    }
+    render(width) {
+        if (width <= 2)
+            return this.content.render(width);
+        const prefix = `${theme.fg("borderAccent", "│")} `;
+        return this.content.render(width - 2).map((line) => prefix + line);
+    }
+    invalidate() {
+        this.content.invalidate();
+    }
+}
+/**
+ * Component that renders a user message
+ */
+export class UserMessageComponent extends Container {
+    constructor(text, markdownTheme = getMarkdownTheme()) {
+        super();
+        this.addChild(new Spacer(1));
+        this.addChild(new UserMessageRail(new Markdown(text, 0, 0, markdownTheme, {
+            color: (content) => theme.fg("userMessageText", content),
+        }, { preserveOrderedListMarkers: true })));
+    }
+    render(width) {
+        const lines = super.render(width);
+        if (lines.length === 0) {
+            return lines;
+        }
+        lines[0] = OSC133_ZONE_START + lines[0];
+        lines[lines.length - 1] = OSC133_ZONE_END + OSC133_ZONE_FINAL + lines[lines.length - 1];
+        return lines;
+    }
+}
+//# sourceMappingURL=user-message.js.map

package/dist/modes/interactive/components/user-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-message.js","sourceRoot":"","sources":["../../../../src/modes/interactive/components/user-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,QAAQ,EAAsB,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACrG,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAEzE,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAC3C,MAAM,eAAe,GAAG,gBAAgB,CAAC;AACzC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAE3C,MAAM,eAAe;IACZ,OAAO,CAAY;IAE3B,YAAY,OAAkB,EAAE;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAAA,CACvB;IAED,MAAM,CAAC,KAAa,EAAY;QAC/B,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC,cAAc,EAAE,KAAG,CAAC,GAAG,CAAC;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAAA,CACnE;IAED,UAAU,GAAS;QAClB,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IAAA,CAC1B;CACD;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IAClD,YAAY,IAAY,EAAE,aAAa,GAAkB,gBAAgB,EAAE,EAAE;QAC5E,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CACZ,IAAI,eAAe,CAClB,IAAI,QAAQ,CACX,IAAI,EACJ,CAAC,EACD,CAAC,EACD,aAAa,EACb;YACC,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,iBAAiB,EAAE,OAAO,CAAC;SAChE,EACD,EAAE,0BAA0B,EAAE,IAAI,EAAE,CACpC,CACD,CACD,CAAC;IAAA,CACF;IAEQ,MAAM,CAAC,KAAa,EAAY;QACxC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACd,CAAC;QAED,KAAK,CAAC,CAAC,CAAC,GAAG,iBAAiB,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,eAAe,GAAG,iBAAiB,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACxF,OAAO,KAAK,CAAC;IAAA,CACb;CACD","sourcesContent":["import { type Component, Container, Markdown, type MarkdownTheme, Spacer } from \"@hansjm10/volt-tui\";\nimport { getMarkdownTheme, theme } from \"../../../core/theme/runtime.ts\";\n\nconst OSC133_ZONE_START = \"\\x1b]133;A\\x07\";\nconst OSC133_ZONE_END = \"\\x1b]133;B\\x07\";\nconst OSC133_ZONE_FINAL = \"\\x1b]133;C\\x07\";\n\nclass UserMessageRail implements Component {\n\tprivate content: Component;\n\n\tconstructor(content: Component) {\n\t\tthis.content = content;\n\t}\n\n\trender(width: number): string[] {\n\t\tif (width <= 2) return this.content.render(width);\n\t\tconst prefix = `${theme.fg(\"borderAccent\", \"│\")} `;\n\t\treturn this.content.render(width - 2).map((line) => prefix + line);\n\t}\n\n\tinvalidate(): void {\n\t\tthis.content.invalidate();\n\t}\n}\n\n/**\n * Component that renders a user message\n */\nexport class UserMessageComponent extends Container {\n\tconstructor(text: string, markdownTheme: MarkdownTheme = getMarkdownTheme()) {\n\t\tsuper();\n\t\tthis.addChild(new Spacer(1));\n\t\tthis.addChild(\n\t\t\tnew UserMessageRail(\n\t\t\t\tnew Markdown(\n\t\t\t\t\ttext,\n\t\t\t\t\t0,\n\t\t\t\t\t0,\n\t\t\t\t\tmarkdownTheme,\n\t\t\t\t\t{\n\t\t\t\t\t\tcolor: (content: string) => theme.fg(\"userMessageText\", content),\n\t\t\t\t\t},\n\t\t\t\t\t{ preserveOrderedListMarkers: true },\n\t\t\t\t),\n\t\t\t),\n\t\t);\n\t}\n\n\toverride render(width: number): string[] {\n\t\tconst lines = super.render(width);\n\t\tif (lines.length === 0) {\n\t\t\treturn lines;\n\t\t}\n\n\t\tlines[0] = OSC133_ZONE_START + lines[0];\n\t\tlines[lines.length - 1] = OSC133_ZONE_END + OSC133_ZONE_FINAL + lines[lines.length - 1];\n\t\treturn lines;\n\t}\n}\n"]}

package/dist/modes/interactive/components/visual-truncate.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared utility for truncating text to visual lines (accounting for line wrapping).
+ * Used by both tool-execution.ts and bash-execution.ts for consistent behavior.
+ */
+export interface VisualTruncateResult {
+    /** The visual lines to display */
+    visualLines: string[];
+    /** Number of visual lines that were skipped (hidden) */
+    skippedCount: number;
+}
+/**
+ * Truncate text to a maximum number of visual lines (from the end).
+ * This accounts for line wrapping based on terminal width.
+ *
+ * @param text - The text content (may contain newlines)
+ * @param maxVisualLines - Maximum number of visual lines to show
+ * @param width - Terminal/render width
+ * @param paddingX - Horizontal padding for Text component (default 0).
+ *                   Use 0 when result will be placed in a Box (Box adds its own padding).
+ *                   Use 1 when result will be placed in a plain Container.
+ * @returns The truncated visual lines and count of skipped lines
+ */
+export declare function truncateToVisualLines(text: string, maxVisualLines: number, width: number, paddingX?: number): VisualTruncateResult;
+//# sourceMappingURL=visual-truncate.d.ts.map

package/dist/modes/interactive/components/visual-truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-truncate.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/visual-truncate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,oBAAoB;IACpC,kCAAkC;IAClC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAU,GAClB,oBAAoB,CAkBtB","sourcesContent":["/**\n * Shared utility for truncating text to visual lines (accounting for line wrapping).\n * Used by both tool-execution.ts and bash-execution.ts for consistent behavior.\n */\n\nimport { Text } from \"@hansjm10/volt-tui\";\n\nexport interface VisualTruncateResult {\n\t/** The visual lines to display */\n\tvisualLines: string[];\n\t/** Number of visual lines that were skipped (hidden) */\n\tskippedCount: number;\n}\n\n/**\n * Truncate text to a maximum number of visual lines (from the end).\n * This accounts for line wrapping based on terminal width.\n *\n * @param text - The text content (may contain newlines)\n * @param maxVisualLines - Maximum number of visual lines to show\n * @param width - Terminal/render width\n * @param paddingX - Horizontal padding for Text component (default 0).\n *                   Use 0 when result will be placed in a Box (Box adds its own padding).\n *                   Use 1 when result will be placed in a plain Container.\n * @returns The truncated visual lines and count of skipped lines\n */\nexport function truncateToVisualLines(\n\ttext: string,\n\tmaxVisualLines: number,\n\twidth: number,\n\tpaddingX: number = 0,\n): VisualTruncateResult {\n\tif (!text) {\n\t\treturn { visualLines: [], skippedCount: 0 };\n\t}\n\n\t// Create a temporary Text component to render and get visual lines\n\tconst tempText = new Text(text, paddingX, 0);\n\tconst allVisualLines = tempText.render(width);\n\n\tif (allVisualLines.length <= maxVisualLines) {\n\t\treturn { visualLines: allVisualLines, skippedCount: 0 };\n\t}\n\n\t// Take the last N visual lines\n\tconst truncatedLines = allVisualLines.slice(-maxVisualLines);\n\tconst skippedCount = allVisualLines.length - maxVisualLines;\n\n\treturn { visualLines: truncatedLines, skippedCount };\n}\n"]}

package/dist/modes/interactive/components/visual-truncate.js

@@ -0,0 +1,33 @@
+/**
+ * Shared utility for truncating text to visual lines (accounting for line wrapping).
+ * Used by both tool-execution.ts and bash-execution.ts for consistent behavior.
+ */
+import { Text } from "@hansjm10/volt-tui";
+/**
+ * Truncate text to a maximum number of visual lines (from the end).
+ * This accounts for line wrapping based on terminal width.
+ *
+ * @param text - The text content (may contain newlines)
+ * @param maxVisualLines - Maximum number of visual lines to show
+ * @param width - Terminal/render width
+ * @param paddingX - Horizontal padding for Text component (default 0).
+ *                   Use 0 when result will be placed in a Box (Box adds its own padding).
+ *                   Use 1 when result will be placed in a plain Container.
+ * @returns The truncated visual lines and count of skipped lines
+ */
+export function truncateToVisualLines(text, maxVisualLines, width, paddingX = 0) {
+    if (!text) {
+        return { visualLines: [], skippedCount: 0 };
+    }
+    // Create a temporary Text component to render and get visual lines
+    const tempText = new Text(text, paddingX, 0);
+    const allVisualLines = tempText.render(width);
+    if (allVisualLines.length <= maxVisualLines) {
+        return { visualLines: allVisualLines, skippedCount: 0 };
+    }
+    // Take the last N visual lines
+    const truncatedLines = allVisualLines.slice(-maxVisualLines);
+    const skippedCount = allVisualLines.length - maxVisualLines;
+    return { visualLines: truncatedLines, skippedCount };
+}
+//# sourceMappingURL=visual-truncate.js.map

package/dist/modes/interactive/components/visual-truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-truncate.js","sourceRoot":"","sources":["../../../../src/modes/interactive/components/visual-truncate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAS1C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACpC,IAAY,EACZ,cAAsB,EACtB,KAAa,EACb,QAAQ,GAAW,CAAC,EACG;IACvB,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,mEAAmE;IACnE,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC7C,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,cAAc,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;QAC7C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,+BAA+B;IAC/B,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,GAAG,cAAc,CAAC;IAE5D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC;AAAA,CACrD","sourcesContent":["/**\n * Shared utility for truncating text to visual lines (accounting for line wrapping).\n * Used by both tool-execution.ts and bash-execution.ts for consistent behavior.\n */\n\nimport { Text } from \"@hansjm10/volt-tui\";\n\nexport interface VisualTruncateResult {\n\t/** The visual lines to display */\n\tvisualLines: string[];\n\t/** Number of visual lines that were skipped (hidden) */\n\tskippedCount: number;\n}\n\n/**\n * Truncate text to a maximum number of visual lines (from the end).\n * This accounts for line wrapping based on terminal width.\n *\n * @param text - The text content (may contain newlines)\n * @param maxVisualLines - Maximum number of visual lines to show\n * @param width - Terminal/render width\n * @param paddingX - Horizontal padding for Text component (default 0).\n *                   Use 0 when result will be placed in a Box (Box adds its own padding).\n *                   Use 1 when result will be placed in a plain Container.\n * @returns The truncated visual lines and count of skipped lines\n */\nexport function truncateToVisualLines(\n\ttext: string,\n\tmaxVisualLines: number,\n\twidth: number,\n\tpaddingX: number = 0,\n): VisualTruncateResult {\n\tif (!text) {\n\t\treturn { visualLines: [], skippedCount: 0 };\n\t}\n\n\t// Create a temporary Text component to render and get visual lines\n\tconst tempText = new Text(text, paddingX, 0);\n\tconst allVisualLines = tempText.render(width);\n\n\tif (allVisualLines.length <= maxVisualLines) {\n\t\treturn { visualLines: allVisualLines, skippedCount: 0 };\n\t}\n\n\t// Take the last N visual lines\n\tconst truncatedLines = allVisualLines.slice(-maxVisualLines);\n\tconst skippedCount = allVisualLines.length - maxVisualLines;\n\n\treturn { visualLines: truncatedLines, skippedCount };\n}\n"]}

package/dist/modes/interactive/components/volt-announcement.d.ts

@@ -0,0 +1,5 @@
+import { Container } from "@hansjm10/volt-tui";
+export declare class VoltAnnouncementComponent extends Container {
+    constructor();
+}
+//# sourceMappingURL=volt-announcement.d.ts.map

package/dist/modes/interactive/components/volt-announcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volt-announcement.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/volt-announcement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,MAAM,oBAAoB,CAAC;AAI7D,qBAAa,yBAA0B,SAAQ,SAAS;IACvD,cAWC;CACD","sourcesContent":["import { Container, Spacer, Text } from \"@hansjm10/volt-tui\";\nimport { theme } from \"../../../core/theme/runtime.ts\";\nimport { DynamicBorder } from \"./dynamic-border.ts\";\n\nexport class VoltAnnouncementComponent extends Container {\n\tconstructor() {\n\t\tsuper();\n\n\t\tthis.addChild(new DynamicBorder((text) => theme.fg(\"accent\", text)));\n\t\tthis.addChild(new Text(theme.bold(theme.fg(\"accent\", \"Volt beta is taking shape\")), 1, 0));\n\t\tthis.addChild(new Spacer(1));\n\t\tthis.addChild(\n\t\t\tnew Text(theme.fg(\"muted\", \"Maintained by Jordan Hans · github.com/hansjm10/Volt · @hansjm10 on npm\"), 1, 0),\n\t\t);\n\t\tthis.addChild(new Spacer(1));\n\t\tthis.addChild(new DynamicBorder((text) => theme.fg(\"accent\", text)));\n\t}\n}\n"]}

package/dist/modes/interactive/components/volt-announcement.js

@@ -0,0 +1,15 @@
+import { Container, Spacer, Text } from "@hansjm10/volt-tui";
+import { theme } from "../../../core/theme/runtime.js";
+import { DynamicBorder } from "./dynamic-border.js";
+export class VoltAnnouncementComponent extends Container {
+    constructor() {
+        super();
+        this.addChild(new DynamicBorder((text) => theme.fg("accent", text)));
+        this.addChild(new Text(theme.bold(theme.fg("accent", "Volt beta is taking shape")), 1, 0));
+        this.addChild(new Spacer(1));
+        this.addChild(new Text(theme.fg("muted", "Maintained by Jordan Hans · github.com/hansjm10/Volt · @hansjm10 on npm"), 1, 0));
+        this.addChild(new Spacer(1));
+        this.addChild(new DynamicBorder((text) => theme.fg("accent", text)));
+    }
+}
+//# sourceMappingURL=volt-announcement.js.map

package/dist/modes/interactive/components/volt-announcement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volt-announcement.js","sourceRoot":"","sources":["../../../../src/modes/interactive/components/volt-announcement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,yBAA0B,SAAQ,SAAS;IACvD,cAAc;QACb,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3F,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CACZ,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,2EAAyE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAC5G,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAAA,CACrE;CACD","sourcesContent":["import { Container, Spacer, Text } from \"@hansjm10/volt-tui\";\nimport { theme } from \"../../../core/theme/runtime.ts\";\nimport { DynamicBorder } from \"./dynamic-border.ts\";\n\nexport class VoltAnnouncementComponent extends Container {\n\tconstructor() {\n\t\tsuper();\n\n\t\tthis.addChild(new DynamicBorder((text) => theme.fg(\"accent\", text)));\n\t\tthis.addChild(new Text(theme.bold(theme.fg(\"accent\", \"Volt beta is taking shape\")), 1, 0));\n\t\tthis.addChild(new Spacer(1));\n\t\tthis.addChild(\n\t\t\tnew Text(theme.fg(\"muted\", \"Maintained by Jordan Hans · github.com/hansjm10/Volt · @hansjm10 on npm\"), 1, 0),\n\t\t);\n\t\tthis.addChild(new Spacer(1));\n\t\tthis.addChild(new DynamicBorder((text) => theme.fg(\"accent\", text)));\n\t}\n}\n"]}

package/dist/modes/interactive/daemon-attach.d.ts

@@ -0,0 +1,154 @@
+import type { Duplex } from "node:stream";
+import type { IrohRemoteLiveActivityUpdateIntent, IrohRemotePushNotificationDeliveryStatus, IrohRemotePushNotificationIntent } from "../../core/remote/iroh/push.ts";
+import { type DaemonClient } from "../../daemon/control-client.ts";
+import { type ControlEvent, type ControlWorktreeStatus, type LeaseState, type RelayPreamble } from "../../daemon/control-protocol.ts";
+import { type EnsureDaemonResult } from "../../daemon/spawn.ts";
+export type DaemonAttachConnectionState = "connected" | "reconnecting" | "gone" | "disabled";
+export type AcquireOutcome = {
+    kind: "granted";
+    handoff: "cold" | "warm" | "none";
+} | {
+    kind: "pending";
+    viewerFeedId: string;
+    granted: Promise<{
+        handoff: "cold" | "warm" | "none";
+    }>;
+} | {
+    kind: "denied";
+    reason: string;
+} | {
+    kind: "noop";
+};
+export interface DaemonRelayOffer {
+    relayId: string;
+    relayToken: string;
+    workspaceName: string;
+    sessionId: string;
+    clientNodeId: string;
+    connectionId: string;
+    streamId: string;
+}
+export interface OpenedRelay {
+    preamble: RelayPreamble;
+    stream: Duplex;
+    /** Mark the relay finished locally (updates the footer count). */
+    finished(): void;
+}
+export interface RelayRpcForwardResult {
+    /** verbatim RPC response object to forward to the phone */
+    response: Record<string, unknown>;
+    /** refreshed workspace metadata after a successful unregister_workspace */
+    workspaceMetadata?: {
+        workspaceNames: string[];
+        workspaces: Array<{
+            name: string;
+            status: string;
+        }>;
+    };
+}
+export interface RelayNotificationDeliveryForwarder {
+    deliverNotification(clientNodeId: string, sessionId: string, notification: IrohRemotePushNotificationIntent): Promise<IrohRemotePushNotificationDeliveryStatus>;
+    deliverLiveActivityUpdate(clientNodeId: string, sessionId: string, update: IrohRemoteLiveActivityUpdateIntent): Promise<IrohRemotePushNotificationDeliveryStatus>;
+}
+/**
+ * TUI-side daemon integration façade. Every method resolves successfully as a
+ * no-op when the daemon is off or unreachable: InteractiveMode never throws or
+ * blocks on daemon absence.
+ */
+export interface DaemonAttach {
+    /** Connect, resolve (or auto-register) the cwd workspace. Never throws. */
+    start(): Promise<void>;
+    acquire(sessionId: string): Promise<AcquireOutcome>;
+    release(sessionId: string): Promise<void>;
+    rekey(oldSessionId: string, newSessionId: string): Promise<void>;
+    /**
+     * Forward a state-touching RPC command from a relayed phone conversation to
+     * the daemon (push targets, live activities, workspace unregister). Returns
+     * undefined when the daemon is unreachable or rejected the request.
+     */
+    forwardRelayRpc(clientNodeId: string, sessionId: string, command: Record<string, unknown> & {
+        type: string;
+    }): Promise<RelayRpcForwardResult | undefined>;
+    /** Deliver relayed completion pushes and Live Activity APNs through the daemon-owned push backend. */
+    relayNotificationDelivery: RelayNotificationDeliveryForwarder;
+    /** Viewer feed subscription (drain overlay). */
+    viewerSubscribe(viewerFeedId: string): Promise<void>;
+    viewerUnsubscribe(viewerFeedId: string): Promise<void>;
+    viewerAbort(viewerFeedId: string): Promise<void>;
+    onRelayOffer(handler: (offer: DaemonRelayOffer, openRelay: () => Promise<OpenedRelay>) => void): void;
+    onEvent(handler: (event: ControlEvent) => void): () => void;
+    /** Re-acquire outcomes after a daemon reconnect (session.reload on warm). */
+    onReacquired(handler: (sessionId: string, outcome: AcquireOutcome) => void): void;
+    relayCount(): number;
+    onRelayCountChange(callback: (count: number) => void): void;
+    connectionState(): DaemonAttachConnectionState;
+    workspaceName(): string | undefined;
+    /** Live runtime ownership for sessions in a workspace, sourced from daemon status. */
+    listRuntimeStates(workspaceName: string): Promise<ReadonlyMap<string, Exclude<LeaseState, "unowned">>>;
+    dispose(): Promise<void>;
+}
+/**
+ * Resolve the registered workspace for a cwd against the daemon: longest
+ * path-prefix match first, then (§5.2.2) a worktree_resolve lookup so a TUI
+ * launched inside a daemon-managed worktree binds to the PARENT workspace
+ * instead of auto-registering a bogus workspace under ~/.volt/agent/worktrees.
+ * Only when both miss is the cwd auto-registered.
+ */
+export declare function resolveDaemonWorkspaceForCwd(client: Pick<DaemonClient, "request">, cwd: string, log?: (message: string) => void): Promise<{
+    name: string;
+    path: string;
+} | undefined>;
+/**
+ * Sanitizer roots for serving a relayed conversation from the TUI: a
+ * worktree-bound conversation sanitizes with the worktree checkout as the
+ * root, and the parent checkout plus the worktrees root must ALSO redact
+ * (bash output like `git worktree list` prints both). §5.2.3.
+ */
+export declare function getRelayServingSanitizerOptions(authorization: RelayPreamble["authorization"], agentDir: string): {
+    remoteWorkspacePath?: string;
+    workspacePath: string;
+    additionalRedactedPaths?: string[];
+};
+export interface DaemonWorktreeControl {
+    workspaceName: string;
+    workspacePath: string;
+    listWorktrees(): Promise<ControlWorktreeStatus[]>;
+    createWorktree(name?: string): Promise<{
+        ok: true;
+        worktree: ControlWorktreeStatus;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+    /** Best-effort: records the session→worktree binding in daemon state. */
+    bindSession(worktreeId: string, sessionId: string): Promise<boolean>;
+    close(): Promise<void>;
+}
+export interface OpenDaemonWorktreeControlOptions {
+    cwd: string;
+    agentDir: string;
+    /** Injectable for tests; defaults to ensureDaemonRunning. */
+    ensureDaemon?: (agentDir: string) => Promise<EnsureDaemonResult>;
+}
+/**
+ * Control-plane handle for the TUI /worktree command (§5.2.1): ensures the
+ * daemon is running, resolves (or registers) the parent workspace for the
+ * cwd, and exposes worktree list/create/bind over the control socket.
+ */
+export declare function openDaemonWorktreeControl(options: OpenDaemonWorktreeControlOptions): Promise<{
+    ok: true;
+    control: DaemonWorktreeControl;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare function createDisabledDaemonAttach(): DaemonAttach;
+export interface CreateDaemonAttachOptions {
+    cwd: string;
+    agentDir: string;
+    /** Auto-spawn the daemon when unreachable (remote.background). */
+    autoStart?: boolean;
+    log?: (message: string) => void;
+}
+export declare function createDaemonAttach(options: CreateDaemonAttachOptions): DaemonAttach;
+//# sourceMappingURL=daemon-attach.d.ts.map

package/dist/modes/interactive/daemon-attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-attach.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/daemon-attach.ts"],"names":[],"mappings":"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","sourcesContent":["import { basename, resolve } from \"node:path\";\nimport type { Duplex } from \"node:stream\";\nimport { VERSION } from \"../../config.ts\";\nimport type {\n\tIrohRemoteLiveActivityUpdateIntent,\n\tIrohRemotePushNotificationDeliveryStatus,\n\tIrohRemotePushNotificationIntent,\n} from \"../../core/remote/iroh/push.ts\";\nimport { createDaemonClient, type DaemonClient } from \"../../daemon/control-client.ts\";\nimport {\n\tCONTROL_RPC_GRANTS_CAPABILITY,\n\tCONTROL_WORKTREES_CAPABILITY,\n\ttype ControlEvent,\n\ttype ControlWorktreeStatus,\n\ttype LeaseState,\n\ttype RelayPreamble,\n} from \"../../daemon/control-protocol.ts\";\nimport { getDaemonSocketPath } from \"../../daemon/paths.ts\";\nimport {\n\ttype EnsureDaemonResult,\n\tensureDaemonRunning,\n\tprobeDaemon,\n\treadPublishedDaemonEndpoint,\n} from \"../../daemon/spawn.ts\";\nimport { getWorktreesRoot } from \"../../daemon/worktree-manager.ts\";\n\nexport type DaemonAttachConnectionState = \"connected\" | \"reconnecting\" | \"gone\" | \"disabled\";\n\nexport type AcquireOutcome =\n\t| { kind: \"granted\"; handoff: \"cold\" | \"warm\" | \"none\" }\n\t| { kind: \"pending\"; viewerFeedId: string; granted: Promise<{ handoff: \"cold\" | \"warm\" | \"none\" }> }\n\t| { kind: \"denied\"; reason: string }\n\t| { kind: \"noop\" };\n\nexport interface DaemonRelayOffer {\n\trelayId: string;\n\trelayToken: string;\n\tworkspaceName: string;\n\tsessionId: string;\n\tclientNodeId: string;\n\tconnectionId: string;\n\tstreamId: string;\n}\n\nexport interface OpenedRelay {\n\tpreamble: RelayPreamble;\n\tstream: Duplex;\n\t/** Mark the relay finished locally (updates the footer count). */\n\tfinished(): void;\n}\n\nexport interface RelayRpcForwardResult {\n\t/** verbatim RPC response object to forward to the phone */\n\tresponse: Record<string, unknown>;\n\t/** refreshed workspace metadata after a successful unregister_workspace */\n\tworkspaceMetadata?: { workspaceNames: string[]; workspaces: Array<{ name: string; status: string }> };\n}\n\nexport interface RelayNotificationDeliveryForwarder {\n\tdeliverNotification(\n\t\tclientNodeId: string,\n\t\tsessionId: string,\n\t\tnotification: IrohRemotePushNotificationIntent,\n\t): Promise<IrohRemotePushNotificationDeliveryStatus>;\n\tdeliverLiveActivityUpdate(\n\t\tclientNodeId: string,\n\t\tsessionId: string,\n\t\tupdate: IrohRemoteLiveActivityUpdateIntent,\n\t): Promise<IrohRemotePushNotificationDeliveryStatus>;\n}\n\n/**\n * TUI-side daemon integration façade. Every method resolves successfully as a\n * no-op when the daemon is off or unreachable: InteractiveMode never throws or\n * blocks on daemon absence.\n */\nexport interface DaemonAttach {\n\t/** Connect, resolve (or auto-register) the cwd workspace. Never throws. */\n\tstart(): Promise<void>;\n\tacquire(sessionId: string): Promise<AcquireOutcome>;\n\trelease(sessionId: string): Promise<void>;\n\trekey(oldSessionId: string, newSessionId: string): Promise<void>;\n\t/**\n\t * Forward a state-touching RPC command from a relayed phone conversation to\n\t * the daemon (push targets, live activities, workspace unregister). Returns\n\t * undefined when the daemon is unreachable or rejected the request.\n\t */\n\tforwardRelayRpc(\n\t\tclientNodeId: string,\n\t\tsessionId: string,\n\t\tcommand: Record<string, unknown> & { type: string },\n\t): Promise<RelayRpcForwardResult | undefined>;\n\t/** Deliver relayed completion pushes and Live Activity APNs through the daemon-owned push backend. */\n\trelayNotificationDelivery: RelayNotificationDeliveryForwarder;\n\t/** Viewer feed subscription (drain overlay). */\n\tviewerSubscribe(viewerFeedId: string): Promise<void>;\n\tviewerUnsubscribe(viewerFeedId: string): Promise<void>;\n\tviewerAbort(viewerFeedId: string): Promise<void>;\n\tonRelayOffer(handler: (offer: DaemonRelayOffer, openRelay: () => Promise<OpenedRelay>) => void): void;\n\tonEvent(handler: (event: ControlEvent) => void): () => void;\n\t/** Re-acquire outcomes after a daemon reconnect (session.reload on warm). */\n\tonReacquired(handler: (sessionId: string, outcome: AcquireOutcome) => void): void;\n\trelayCount(): number;\n\tonRelayCountChange(callback: (count: number) => void): void;\n\tconnectionState(): DaemonAttachConnectionState;\n\tworkspaceName(): string | undefined;\n\t/** Live runtime ownership for sessions in a workspace, sourced from daemon status. */\n\tlistRuntimeStates(workspaceName: string): Promise<ReadonlyMap<string, Exclude<LeaseState, \"unowned\">>>;\n\tdispose(): Promise<void>;\n}\n\nconst NOOP_OUTCOME: AcquireOutcome = { kind: \"noop\" };\n\n/**\n * Resolve the registered workspace for a cwd against the daemon: longest\n * path-prefix match first, then (§5.2.2) a worktree_resolve lookup so a TUI\n * launched inside a daemon-managed worktree binds to the PARENT workspace\n * instead of auto-registering a bogus workspace under ~/.volt/agent/worktrees.\n * Only when both miss is the cwd auto-registered.\n */\nexport async function resolveDaemonWorkspaceForCwd(\n\tclient: Pick<DaemonClient, \"request\">,\n\tcwd: string,\n\tlog: (message: string) => void = () => {},\n): Promise<{ name: string; path: string } | undefined> {\n\tconst status = await client.request({ type: \"status\" });\n\tif (status.type !== \"status_result\") {\n\t\treturn undefined;\n\t}\n\tconst resolvedCwd = resolve(cwd);\n\tconst match = status.workspaces\n\t\t.filter((workspace) => resolvedCwd === workspace.path || resolvedCwd.startsWith(`${workspace.path}/`))\n\t\t.sort((left, right) => right.path.length - left.path.length)[0];\n\tif (match) {\n\t\treturn { name: match.name, path: match.path };\n\t}\n\t// A cwd inside a daemon-managed worktree belongs to the worktree's parent\n\t// workspace; auto-registering it would split lease keys from the daemon's\n\t// conversations for the same sessions.\n\ttry {\n\t\tconst resolved = await client.request({ type: \"worktree_resolve\", path: resolvedCwd });\n\t\tif (resolved.type === \"worktree_resolve_result\") {\n\t\t\treturn { name: resolved.workspaceName, path: resolved.workspacePath };\n\t\t}\n\t} catch {\n\t\t// Old daemon (unknown request) or transient failure: fall through.\n\t}\n\t// Auto-register the cwd so phones can reach sessions opened here.\n\tconst takenNames = new Set(status.workspaces.map((workspace) => workspace.name));\n\tconst base = basename(resolvedCwd) || \"workspace\";\n\tlet candidate = base;\n\tfor (let suffix = 2; takenNames.has(candidate); suffix++) {\n\t\tcandidate = `${base}-${suffix}`;\n\t}\n\tconst registered = await client.request({ type: \"workspace_register\", name: candidate, path: resolvedCwd });\n\tif (registered.type === \"ok\") {\n\t\tlog(`registered workspace ${candidate} -> ${resolvedCwd}`);\n\t\treturn { name: candidate, path: resolvedCwd };\n\t}\n\treturn undefined;\n}\n\n/**\n * Sanitizer roots for serving a relayed conversation from the TUI: a\n * worktree-bound conversation sanitizes with the worktree checkout as the\n * root, and the parent checkout plus the worktrees root must ALSO redact\n * (bash output like `git worktree list` prints both). §5.2.3.\n */\nexport function getRelayServingSanitizerOptions(\n\tauthorization: RelayPreamble[\"authorization\"],\n\tagentDir: string,\n): { remoteWorkspacePath?: string; workspacePath: string; additionalRedactedPaths?: string[] } {\n\tif (authorization.worktreePath === undefined) {\n\t\treturn { workspacePath: authorization.workspacePath };\n\t}\n\treturn {\n\t\t...(authorization.worktreeSourceRootRelativePath === undefined\n\t\t\t? {}\n\t\t\t: { remoteWorkspacePath: `/workspace/${authorization.worktreeSourceRootRelativePath}` }),\n\t\tworkspacePath: authorization.worktreePath,\n\t\tadditionalRedactedPaths: [authorization.workspacePath, getWorktreesRoot(agentDir)],\n\t};\n}\n\nexport interface DaemonWorktreeControl {\n\tworkspaceName: string;\n\tworkspacePath: string;\n\tlistWorktrees(): Promise<ControlWorktreeStatus[]>;\n\tcreateWorktree(name?: string): Promise<{ ok: true; worktree: ControlWorktreeStatus } | { ok: false; error: string }>;\n\t/** Best-effort: records the session→worktree binding in daemon state. */\n\tbindSession(worktreeId: string, sessionId: string): Promise<boolean>;\n\tclose(): Promise<void>;\n}\n\nexport interface OpenDaemonWorktreeControlOptions {\n\tcwd: string;\n\tagentDir: string;\n\t/** Injectable for tests; defaults to ensureDaemonRunning. */\n\tensureDaemon?: (agentDir: string) => Promise<EnsureDaemonResult>;\n}\n\n/**\n * Control-plane handle for the TUI /worktree command (§5.2.1): ensures the\n * daemon is running, resolves (or registers) the parent workspace for the\n * cwd, and exposes worktree list/create/bind over the control socket.\n */\nexport async function openDaemonWorktreeControl(\n\toptions: OpenDaemonWorktreeControlOptions,\n): Promise<{ ok: true; control: DaemonWorktreeControl } | { ok: false; error: string }> {\n\tconst ensureDaemon = options.ensureDaemon ?? ensureDaemonRunning;\n\tlet ensured: EnsureDaemonResult;\n\ttry {\n\t\tensured = await ensureDaemon(options.agentDir);\n\t} catch (error) {\n\t\treturn { ok: false, error: error instanceof Error ? error.message : String(error) };\n\t}\n\tif (!ensured.healthy) {\n\t\treturn { ok: false, error: `voltd is not available (${ensured.state}); try \\`volt daemon start\\`` };\n\t}\n\tconst client = createDaemonClient({\n\t\tsocketPath: ensured.socketPath ?? getDaemonSocketPath(options.agentDir),\n\t\tclient: \"tui\",\n\t\tversion: VERSION,\n\t\tauthToken: ensured.authToken,\n\t\treconnect: false,\n\t\tcapabilities: [CONTROL_WORKTREES_CAPABILITY, CONTROL_RPC_GRANTS_CAPABILITY],\n\t});\n\ttry {\n\t\tawait client.connect();\n\t\tconst workspace = await resolveDaemonWorkspaceForCwd(client, options.cwd);\n\t\tif (!workspace) {\n\t\t\tawait client.close();\n\t\t\treturn { ok: false, error: \"could not resolve or register a workspace for the current directory\" };\n\t\t}\n\t\tconst control: DaemonWorktreeControl = {\n\t\t\tworkspaceName: workspace.name,\n\t\t\tworkspacePath: workspace.path,\n\t\t\tasync listWorktrees() {\n\t\t\t\tconst response = await client.request({ type: \"worktree_list\", workspaceName: workspace.name });\n\t\t\t\treturn response.type === \"worktrees_result\" ? response.worktrees : [];\n\t\t\t},\n\t\t\tasync createWorktree(name?: string) {\n\t\t\t\tconst response = await client.request({\n\t\t\t\t\ttype: \"worktree_create\",\n\t\t\t\t\tworkspaceName: workspace.name,\n\t\t\t\t\t...(name === undefined ? {} : { worktreeName: name }),\n\t\t\t\t});\n\t\t\t\tif (response.type === \"worktree_result\") {\n\t\t\t\t\treturn { ok: true, worktree: response.worktree };\n\t\t\t\t}\n\t\t\t\tconst error =\n\t\t\t\t\tresponse.type === \"error\" ? `${response.code}: ${response.message}` : \"unexpected daemon response\";\n\t\t\t\treturn { ok: false, error };\n\t\t\t},\n\t\t\tasync bindSession(worktreeId: string, sessionId: string) {\n\t\t\t\ttry {\n\t\t\t\t\tconst response = await client.request({\n\t\t\t\t\t\ttype: \"worktree_bind\",\n\t\t\t\t\t\tworkspaceName: workspace.name,\n\t\t\t\t\t\tworktreeId,\n\t\t\t\t\t\tsessionId,\n\t\t\t\t\t});\n\t\t\t\t\treturn response.type === \"ok\";\n\t\t\t\t} catch {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t},\n\t\t\tclose: () => client.close(),\n\t\t};\n\t\treturn { ok: true, control };\n\t} catch (error) {\n\t\tawait client.close().catch(() => {});\n\t\treturn { ok: false, error: error instanceof Error ? error.message : String(error) };\n\t}\n}\n\nexport function createDisabledDaemonAttach(): DaemonAttach {\n\treturn {\n\t\tasync start() {},\n\t\tasync acquire() {\n\t\t\treturn NOOP_OUTCOME;\n\t\t},\n\t\tasync release() {},\n\t\tasync rekey() {},\n\t\tasync forwardRelayRpc() {\n\t\t\treturn undefined;\n\t\t},\n\t\trelayNotificationDelivery: {\n\t\t\tasync deliverNotification() {\n\t\t\t\treturn \"failed\";\n\t\t\t},\n\t\t\tasync deliverLiveActivityUpdate() {\n\t\t\t\treturn \"failed\";\n\t\t\t},\n\t\t},\n\t\tasync viewerSubscribe() {},\n\t\tasync viewerUnsubscribe() {},\n\t\tasync viewerAbort() {},\n\t\tonRelayOffer() {},\n\t\tonEvent() {\n\t\t\treturn () => {};\n\t\t},\n\t\tonReacquired() {},\n\t\trelayCount() {\n\t\t\treturn 0;\n\t\t},\n\t\tonRelayCountChange() {},\n\t\tconnectionState() {\n\t\t\treturn \"disabled\";\n\t\t},\n\t\tworkspaceName() {\n\t\t\treturn undefined;\n\t\t},\n\t\tasync listRuntimeStates() {\n\t\t\treturn new Map();\n\t\t},\n\t\tasync dispose() {},\n\t};\n}\n\nexport interface CreateDaemonAttachOptions {\n\tcwd: string;\n\tagentDir: string;\n\t/** Auto-spawn the daemon when unreachable (remote.background). */\n\tautoStart?: boolean;\n\tlog?: (message: string) => void;\n}\n\nexport function createDaemonAttach(options: CreateDaemonAttachOptions): DaemonAttach {\n\tlet client: DaemonClient | undefined;\n\tlet state: DaemonAttachConnectionState = \"reconnecting\";\n\tlet resolvedWorkspaceName: string | undefined;\n\tlet activeRelays = 0;\n\tconst activeRelayIds = new Map<string, string>();\n\tlet currentSessionId: string | undefined;\n\tlet disposed = false;\n\tlet resolvingWorkspace: Promise<void> | undefined;\n\tconst eventHandlers = new Set<(event: ControlEvent) => void>();\n\tconst relayCountCallbacks = new Set<(count: number) => void>();\n\tlet relayOfferHandler: ((offer: DaemonRelayOffer, openRelay: () => Promise<OpenedRelay>) => void) | undefined;\n\tlet reacquiredHandler: ((sessionId: string, outcome: AcquireOutcome) => void) | undefined;\n\n\tconst log = options.log ?? (() => {});\n\n\tconst setRelayCount = (next: number) => {\n\t\tif (next === activeRelays) {\n\t\t\treturn;\n\t\t}\n\t\tactiveRelays = next;\n\t\tfor (const callback of Array.from(relayCountCallbacks)) {\n\t\t\tcallback(next);\n\t\t}\n\t};\n\n\tconst parseAcquireResponse = (\n\t\tresponse: { type: string } & Record<string, unknown>,\n\t\twaitForResponse: (id: string) => Promise<{ type: string } & Record<string, unknown>>,\n\t): AcquireOutcome => {\n\t\tif (response.type === \"lease_granted\") {\n\t\t\treturn { kind: \"granted\", handoff: response.handoff as \"cold\" | \"warm\" | \"none\" };\n\t\t}\n\t\tif (response.type === \"lease_denied\") {\n\t\t\treturn { kind: \"denied\", reason: String(response.reason) };\n\t\t}\n\t\tif (response.type === \"lease_pending\") {\n\t\t\tconst id = String(response.id);\n\t\t\treturn {\n\t\t\t\tkind: \"pending\",\n\t\t\t\tviewerFeedId: String(response.viewerFeedId),\n\t\t\t\tgranted: waitForResponse(id).then((terminal) => {\n\t\t\t\t\tif (terminal.type === \"lease_granted\") {\n\t\t\t\t\t\treturn { handoff: terminal.handoff as \"cold\" | \"warm\" | \"none\" };\n\t\t\t\t\t}\n\t\t\t\t\tthrow new Error(typeof terminal.message === \"string\" ? terminal.message : \"lease drain failed\");\n\t\t\t\t}),\n\t\t\t};\n\t\t}\n\t\treturn NOOP_OUTCOME;\n\t};\n\n\tconst relayKey = (clientNodeId: string, sessionId: string) => `${clientNodeId}\\0${sessionId}`;\n\n\tconst handleRelayOffer = (offer: DaemonRelayOffer) => {\n\t\tconst handler = relayOfferHandler;\n\t\tconst activeClient = client;\n\t\tif (!handler || !activeClient) {\n\t\t\treturn;\n\t\t}\n\t\thandler(offer, async () => {\n\t\t\tconst opened = await activeClient.openRelay({ relayId: offer.relayId, relayToken: offer.relayToken });\n\t\t\tconst key = relayKey(offer.clientNodeId, offer.sessionId);\n\t\t\tactiveRelayIds.set(key, offer.relayId);\n\t\t\tsetRelayCount(activeRelays + 1);\n\t\t\tlet finished = false;\n\t\t\tconst finish = () => {\n\t\t\t\tif (!finished) {\n\t\t\t\t\tfinished = true;\n\t\t\t\t\tif (activeRelayIds.get(key) === offer.relayId) {\n\t\t\t\t\t\tactiveRelayIds.delete(key);\n\t\t\t\t\t}\n\t\t\t\t\tsetRelayCount(Math.max(0, activeRelays - 1));\n\t\t\t\t}\n\t\t\t};\n\t\t\topened.stream.once(\"close\", finish);\n\t\t\treturn { preamble: opened.preamble, stream: opened.stream, finished: finish };\n\t\t});\n\t};\n\n\tconst resolveWorkspace = async (): Promise<void> => {\n\t\tif (resolvingWorkspace) {\n\t\t\treturn resolvingWorkspace;\n\t\t}\n\t\tresolvingWorkspace = (async () => {\n\t\t\tconst activeClient = client;\n\t\t\tif (!activeClient) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst workspace = await resolveDaemonWorkspaceForCwd(activeClient, options.cwd, log);\n\t\t\tif (workspace) {\n\t\t\t\tresolvedWorkspaceName = workspace.name;\n\t\t\t}\n\t\t})().finally(() => {\n\t\t\tresolvingWorkspace = undefined;\n\t\t});\n\t\treturn resolvingWorkspace;\n\t};\n\n\tconst ensureLeaseAfterConnected = async (): Promise<void> => {\n\t\tawait resolveWorkspace();\n\t\tconst sessionId = currentSessionId;\n\t\tconst workspaceName = resolvedWorkspaceName;\n\t\tconst activeClient = client;\n\t\tif (!sessionId || !workspaceName || !activeClient || !reacquiredHandler) {\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tconst response = await activeClient.request({ type: \"lease_acquire\", workspaceName, sessionId });\n\t\t\tconst outcome = parseAcquireResponse(\n\t\t\t\tresponse as { type: string } & Record<string, unknown>,\n\t\t\t\t(id) => activeClient.waitForResponse(id) as Promise<{ type: string } & Record<string, unknown>>,\n\t\t\t);\n\t\t\treacquiredHandler(sessionId, outcome);\n\t\t} catch {\n\t\t\t// The next reconnect retries.\n\t\t}\n\t};\n\n\treturn {\n\t\tasync start() {\n\t\t\tif (disposed) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst ensured = options.autoStart\n\t\t\t\t\t? await ensureDaemonRunning(options.agentDir)\n\t\t\t\t\t: await probeDaemon(options.agentDir);\n\t\t\t\tif (disposed) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst socketPath = ensured.socketPath;\n\t\t\t\tif (options.autoStart && ensured.state === \"protocol-mismatch\") {\n\t\t\t\t\tstate = \"gone\";\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst startingClient = createDaemonClient({\n\t\t\t\t\tsocketPath: socketPath ?? getDaemonSocketPath(options.agentDir),\n\t\t\t\t\tclient: \"tui\",\n\t\t\t\t\tversion: VERSION,\n\t\t\t\t\tauthToken: ensured.authToken,\n\t\t\t\t\trefreshEndpoint: () => readPublishedDaemonEndpoint(options.agentDir),\n\t\t\t\t\tcapabilities: [CONTROL_WORKTREES_CAPABILITY, CONTROL_RPC_GRANTS_CAPABILITY],\n\t\t\t\t\treconnect: true,\n\t\t\t\t\tonEvent: (event) => {\n\t\t\t\t\t\tif (event.type === \"relay_offer\") {\n\t\t\t\t\t\t\thandleRelayOffer(event);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (event.type === \"relay_closed\") {\n\t\t\t\t\t\t\t// The socket close callback decrements the count; nothing to do\n\t\t\t\t\t\t\t// beyond fanning the event out.\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (event.type === \"daemon_shutdown\") {\n\t\t\t\t\t\t\tsetRelayCount(0);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tfor (const handler of Array.from(eventHandlers)) {\n\t\t\t\t\t\t\thandler(event);\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t\tonConnectionStateChange: (next) => {\n\t\t\t\t\t\tstate = next;\n\t\t\t\t\t\tif (next === \"connected\") {\n\t\t\t\t\t\t\tvoid ensureLeaseAfterConnected().catch(() => {});\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\tclient = startingClient;\n\t\t\t\tawait startingClient.connect();\n\t\t\t\tif (disposed || client !== startingClient) {\n\t\t\t\t\tawait startingClient.close();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tstate = \"connected\";\n\t\t\t\tawait ensureLeaseAfterConnected();\n\t\t\t} catch (error) {\n\t\t\t\tlog(`daemon unavailable: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\t\tstate = client?.connectionState ?? \"gone\";\n\t\t\t}\n\t\t},\n\t\tasync acquire(sessionId: string) {\n\t\t\tcurrentSessionId = sessionId;\n\t\t\tconst workspaceName = resolvedWorkspaceName;\n\t\t\tconst activeClient = client;\n\t\t\tif (!activeClient || !workspaceName || state !== \"connected\") {\n\t\t\t\treturn NOOP_OUTCOME;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst response = await activeClient.request({ type: \"lease_acquire\", workspaceName, sessionId });\n\t\t\t\treturn parseAcquireResponse(\n\t\t\t\t\tresponse as { type: string } & Record<string, unknown>,\n\t\t\t\t\t(id) => activeClient.waitForResponse(id) as Promise<{ type: string } & Record<string, unknown>>,\n\t\t\t\t);\n\t\t\t} catch {\n\t\t\t\treturn NOOP_OUTCOME;\n\t\t\t}\n\t\t},\n\t\tasync release(sessionId: string) {\n\t\t\tif (currentSessionId === sessionId) {\n\t\t\t\tcurrentSessionId = undefined;\n\t\t\t}\n\t\t\tconst workspaceName = resolvedWorkspaceName;\n\t\t\tconst activeClient = client;\n\t\t\tif (!activeClient || !workspaceName) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tawait activeClient.request({ type: \"lease_release\", workspaceName, sessionId });\n\t\t\t} catch {\n\t\t\t\t// Daemon-side implicit release on disconnect covers this.\n\t\t\t}\n\t\t},\n\t\tasync rekey(oldSessionId: string, newSessionId: string) {\n\t\t\tif (currentSessionId === oldSessionId) {\n\t\t\t\tcurrentSessionId = newSessionId;\n\t\t\t}\n\t\t\tconst workspaceName = resolvedWorkspaceName;\n\t\t\tconst activeClient = client;\n\t\t\tif (!activeClient || !workspaceName) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tawait activeClient.request({ type: \"lease_rekey\", workspaceName, oldSessionId, newSessionId });\n\t\t\t} catch {\n\t\t\t\t// Reconnect re-acquires with the new id.\n\t\t\t}\n\t\t},\n\t\tasync forwardRelayRpc(\n\t\t\tclientNodeId: string,\n\t\t\tsessionId: string,\n\t\t\tcommand: Record<string, unknown> & { type: string },\n\t\t) {\n\t\t\tconst workspaceName = resolvedWorkspaceName;\n\t\t\tconst activeClient = client;\n\t\t\tconst relayId = activeRelayIds.get(relayKey(clientNodeId, sessionId));\n\t\t\tif (!activeClient || !workspaceName || !relayId) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst response = await activeClient.request({\n\t\t\t\t\ttype: \"relay_rpc\",\n\t\t\t\t\trelayId,\n\t\t\t\t\tclientNodeId,\n\t\t\t\t\tworkspaceName,\n\t\t\t\t\tsessionId,\n\t\t\t\t\tcommand,\n\t\t\t\t});\n\t\t\t\tif (response.type !== \"relay_rpc_result\") {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tresponse: response.response,\n\t\t\t\t\t...(response.workspaceMetadata === undefined ? {} : { workspaceMetadata: response.workspaceMetadata }),\n\t\t\t\t};\n\t\t\t} catch {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t},\n\t\trelayNotificationDelivery: {\n\t\t\tasync deliverNotification(clientNodeId, sessionId, notification) {\n\t\t\t\tconst workspaceName = resolvedWorkspaceName;\n\t\t\t\tconst activeClient = client;\n\t\t\t\tif (!activeClient || !workspaceName) {\n\t\t\t\t\treturn \"failed\";\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tconst response = await activeClient.request({\n\t\t\t\t\t\ttype: \"relay_notification_delivery\",\n\t\t\t\t\t\tclientNodeId,\n\t\t\t\t\t\tworkspaceName,\n\t\t\t\t\t\tsessionId,\n\t\t\t\t\t\tnotification,\n\t\t\t\t\t});\n\t\t\t\t\treturn response.type === \"relay_push_delivery_result\" ? response.status : \"failed\";\n\t\t\t\t} catch {\n\t\t\t\t\treturn \"failed\";\n\t\t\t\t}\n\t\t\t},\n\t\t\tasync deliverLiveActivityUpdate(clientNodeId, sessionId, update) {\n\t\t\t\tconst workspaceName = resolvedWorkspaceName;\n\t\t\t\tconst activeClient = client;\n\t\t\t\tif (!activeClient || !workspaceName) {\n\t\t\t\t\treturn \"failed\";\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tconst response = await activeClient.request({\n\t\t\t\t\t\ttype: \"relay_live_activity_delivery\",\n\t\t\t\t\t\tclientNodeId,\n\t\t\t\t\t\tworkspaceName,\n\t\t\t\t\t\tsessionId,\n\t\t\t\t\t\tupdate,\n\t\t\t\t\t});\n\t\t\t\t\treturn response.type === \"relay_push_delivery_result\" ? response.status : \"failed\";\n\t\t\t\t} catch {\n\t\t\t\t\treturn \"failed\";\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\tasync viewerSubscribe(viewerFeedId: string) {\n\t\t\ttry {\n\t\t\t\tawait client?.request({ type: \"viewer_subscribe\", viewerFeedId });\n\t\t\t} catch {\n\t\t\t\t// Viewer feed is best-effort; the post-grant file load is authoritative.\n\t\t\t}\n\t\t},\n\t\tasync viewerUnsubscribe(viewerFeedId: string) {\n\t\t\ttry {\n\t\t\t\tawait client?.request({ type: \"viewer_unsubscribe\", viewerFeedId });\n\t\t\t} catch {\n\t\t\t\t// Best-effort.\n\t\t\t}\n\t\t},\n\t\tasync viewerAbort(viewerFeedId: string) {\n\t\t\ttry {\n\t\t\t\tawait client?.request({ type: \"viewer_abort\", viewerFeedId });\n\t\t\t} catch {\n\t\t\t\t// Best-effort.\n\t\t\t}\n\t\t},\n\t\tonRelayOffer(handler) {\n\t\t\trelayOfferHandler = handler;\n\t\t},\n\t\tonEvent(handler) {\n\t\t\teventHandlers.add(handler);\n\t\t\treturn () => {\n\t\t\t\teventHandlers.delete(handler);\n\t\t\t};\n\t\t},\n\t\tonReacquired(handler) {\n\t\t\treacquiredHandler = handler;\n\t\t},\n\t\trelayCount() {\n\t\t\treturn activeRelays;\n\t\t},\n\t\tonRelayCountChange(callback) {\n\t\t\trelayCountCallbacks.add(callback);\n\t\t},\n\t\tconnectionState() {\n\t\t\treturn state;\n\t\t},\n\t\tworkspaceName() {\n\t\t\treturn resolvedWorkspaceName;\n\t\t},\n\t\tasync listRuntimeStates(workspaceName: string) {\n\t\t\tconst states = new Map<string, Exclude<LeaseState, \"unowned\">>();\n\t\t\tconst activeClient = client;\n\t\t\tif (!activeClient || state !== \"connected\") {\n\t\t\t\treturn states;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst response = await activeClient.request({ type: \"status\" });\n\t\t\t\tif (response.type !== \"status_result\") {\n\t\t\t\t\treturn states;\n\t\t\t\t}\n\t\t\t\tfor (const lease of response.leases) {\n\t\t\t\t\tif (lease.workspaceName === workspaceName && lease.state !== \"unowned\") {\n\t\t\t\t\t\tstates.set(lease.sessionId, lease.state);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Presence is best-effort; list_sessions remains available from local state.\n\t\t\t}\n\t\t\treturn states;\n\t\t},\n\t\tasync dispose() {\n\t\t\tdisposed = true;\n\t\t\tactiveRelayIds.clear();\n\t\t\tawait client?.close();\n\t\t\tclient = undefined;\n\t\t\tstate = \"gone\";\n\t\t},\n\t};\n}\n"]}