@relay-harness/coding-agent 0.0.0-stage → 1.0.2

package/dist/cli/project-trust.js

@@ -0,0 +1,48 @@
+import chalk from "chalk";
+import { showStartupInput, showStartupSelector } from "./startup-ui.js";
+export function createProjectTrustContext(options) {
+    return {
+        cwd: options.cwd,
+        mode: options.mode === "interactive" ? "tui" : options.mode,
+        hasUI: options.hasUI,
+        ui: {
+            select: async (title, selectOptions) => {
+                if (!options.hasUI) {
+                    return undefined;
+                }
+                if (options.mode !== "interactive") {
+                    return undefined;
+                }
+                return showStartupSelector(options.settingsManager, title, selectOptions.map((option) => ({ label: option, value: option })));
+            },
+            confirm: async (title, message) => {
+                if (!options.hasUI) {
+                    return false;
+                }
+                if (options.mode !== "interactive") {
+                    return false;
+                }
+                return ((await showStartupSelector(options.settingsManager, `${title}\n${message}`, [
+                    { label: "Yes", value: true },
+                    { label: "No", value: false },
+                ])) ?? false);
+            },
+            input: async (title, placeholder) => {
+                if (!options.hasUI) {
+                    return undefined;
+                }
+                if (options.mode !== "interactive") {
+                    return undefined;
+                }
+                return showStartupInput(options.settingsManager, title, placeholder);
+            },
+            notify: (message, type = "info") => {
+                if (options.mode !== "interactive") {
+                    const color = type === "error" ? chalk.red : type === "warning" ? chalk.yellow : chalk.cyan;
+                    console.error(color(message));
+                }
+            },
+        },
+    };
+}
+//# sourceMappingURL=project-trust.js.map

package/dist/cli/project-trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-trust.js","sourceRoot":"","sources":["../../src/cli/project-trust.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAExE,MAAM,UAAU,yBAAyB,CAAC,OAKzC;IACA,OAAO;QACN,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI;QAC3D,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,EAAE,EAAE;YACH,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;gBACtC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBACpB,OAAO,SAAS,CAAC;gBAClB,CAAC;gBACD,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACpC,OAAO,SAAS,CAAC;gBAClB,CAAC;gBACD,OAAO,mBAAmB,CACzB,OAAO,CAAC,eAAe,EACvB,KAAK,EACL,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CACjE,CAAC;YACH,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBACjC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBACpB,OAAO,KAAK,CAAC;gBACd,CAAC;gBACD,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACpC,OAAO,KAAK,CAAC;gBACd,CAAC;gBACD,OAAO,CACN,CAAC,MAAM,mBAAmB,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,KAAK,KAAK,OAAO,EAAE,EAAE;oBAC3E,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;oBAC7B,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE;iBAC7B,CAAC,CAAC,IAAI,KAAK,CACZ,CAAC;YACH,CAAC;YACD,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE;gBACnC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBACpB,OAAO,SAAS,CAAC;gBAClB,CAAC;gBACD,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACpC,OAAO,SAAS,CAAC;gBAClB,CAAC;gBACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,eAAe,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,EAAE,EAAE;gBAClC,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACpC,MAAM,KAAK,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;oBAC5F,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC/B,CAAC;YACF,CAAC;SACD;KACD,CAAC;AACH,CAAC","sourcesContent":["import chalk from \"chalk\";\nimport type { ProjectTrustContext } from \"../core/extensions/types.ts\";\nimport type { AppMode } from \"../core/project-trust.ts\";\nimport type { SettingsManager } from \"../core/settings-manager.ts\";\nimport { showStartupInput, showStartupSelector } from \"./startup-ui.ts\";\n\nexport function createProjectTrustContext(options: {\n\tcwd: string;\n\tmode: AppMode;\n\tsettingsManager: SettingsManager;\n\thasUI: boolean;\n}): ProjectTrustContext {\n\treturn {\n\t\tcwd: options.cwd,\n\t\tmode: options.mode === \"interactive\" ? \"tui\" : options.mode,\n\t\thasUI: options.hasUI,\n\t\tui: {\n\t\t\tselect: async (title, selectOptions) => {\n\t\t\t\tif (!options.hasUI) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\t\t\t\tif (options.mode !== \"interactive\") {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\t\t\t\treturn showStartupSelector(\n\t\t\t\t\toptions.settingsManager,\n\t\t\t\t\ttitle,\n\t\t\t\t\tselectOptions.map((option) => ({ label: option, value: option })),\n\t\t\t\t);\n\t\t\t},\n\t\t\tconfirm: async (title, message) => {\n\t\t\t\tif (!options.hasUI) {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tif (options.mode !== \"interactive\") {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\treturn (\n\t\t\t\t\t(await showStartupSelector(options.settingsManager, `${title}\\n${message}`, [\n\t\t\t\t\t\t{ label: \"Yes\", value: true },\n\t\t\t\t\t\t{ label: \"No\", value: false },\n\t\t\t\t\t])) ?? false\n\t\t\t\t);\n\t\t\t},\n\t\t\tinput: async (title, placeholder) => {\n\t\t\t\tif (!options.hasUI) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\t\t\t\tif (options.mode !== \"interactive\") {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\t\t\t\treturn showStartupInput(options.settingsManager, title, placeholder);\n\t\t\t},\n\t\t\tnotify: (message, type = \"info\") => {\n\t\t\t\tif (options.mode !== \"interactive\") {\n\t\t\t\t\tconst color = type === \"error\" ? chalk.red : type === \"warning\" ? chalk.yellow : chalk.cyan;\n\t\t\t\t\tconsole.error(color(message));\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t};\n}\n"]}

package/dist/cli/session-picker.d.ts

@@ -0,0 +1,10 @@
+/**
+ * TUI session selector for --resume flag
+ */
+import type { SessionInfo, SessionListProgress } from "../core/session-manager.ts";
+import type { SettingsManager } from "../core/settings-manager.ts";
+type SessionsLoader = (onProgress?: SessionListProgress, signal?: AbortSignal) => Promise<SessionInfo[]>;
+/** Show TUI session selector and return selected session path or null if cancelled */
+export declare function selectSession(currentSessionsLoader: SessionsLoader, allSessionsLoader: SessionsLoader, settingsManager: SettingsManager): Promise<string | null>;
+export {};
+//# sourceMappingURL=session-picker.d.ts.map

package/dist/cli/session-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-picker.d.ts","sourceRoot":"","sources":["../../src/cli/session-picker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAInE,KAAK,cAAc,GAAG,CAAC,UAAU,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAEzG,sFAAsF;AACtF,wBAAsB,aAAa,CAClC,qBAAqB,EAAE,cAAc,EACrC,iBAAiB,EAAE,cAAc,EACjC,eAAe,EAAE,eAAe,GAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoCxB"}

package/dist/cli/session-picker.js

@@ -0,0 +1,36 @@
+/**
+ * TUI session selector for --resume flag
+ */
+import { setKeybindings } from "@relay-harness/tui";
+import { KeybindingsManager } from "../core/keybindings.js";
+import { SessionSelectorComponent } from "../modes/interactive/components/session-selector.js";
+import { createStartupTui, startStartupTui } from "./startup-ui.js";
+/** Show TUI session selector and return selected session path or null if cancelled */
+export async function selectSession(currentSessionsLoader, allSessionsLoader, settingsManager) {
+    const ui = await createStartupTui(settingsManager);
+    return new Promise((resolve) => {
+        const keybindings = KeybindingsManager.create();
+        setKeybindings(keybindings);
+        let resolved = false;
+        const selector = new SessionSelectorComponent(currentSessionsLoader, allSessionsLoader, (path) => {
+            if (!resolved) {
+                resolved = true;
+                ui.stop();
+                resolve(path);
+            }
+        }, () => {
+            if (!resolved) {
+                resolved = true;
+                ui.stop();
+                resolve(null);
+            }
+        }, () => {
+            ui.stop();
+            process.exit(0);
+        }, () => ui.requestRender(), { showRenameHint: false, keybindings });
+        ui.addChild(selector);
+        ui.setFocus(selector.getSessionList());
+        startStartupTui(ui, settingsManager);
+    });
+}
+//# sourceMappingURL=session-picker.js.map

package/dist/cli/session-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-picker.js","sourceRoot":"","sources":["../../src/cli/session-picker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qDAAqD,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIpE,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,qBAAqC,EACrC,iBAAiC,EACjC,eAAgC;IAEhC,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,eAAe,CAAC,CAAC;IACnD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC;QAChD,cAAc,CAAC,WAAW,CAAC,CAAC;QAC5B,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,QAAQ,GAAG,IAAI,wBAAwB,CAC5C,qBAAqB,EACrB,iBAAiB,EACjB,CAAC,IAAY,EAAE,EAAE;YAChB,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,QAAQ,GAAG,IAAI,CAAC;gBAChB,EAAE,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;QACF,CAAC,EACD,GAAG,EAAE;YACJ,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,QAAQ,GAAG,IAAI,CAAC;gBAChB,EAAE,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;QACF,CAAC,EACD,GAAG,EAAE;YACJ,EAAE,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC,EACD,GAAG,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,EACxB,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,CACtC,CAAC;QAEF,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtB,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;QACvC,eAAe,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * TUI session selector for --resume flag\n */\n\nimport { setKeybindings } from \"@relay-harness/tui\";\nimport { KeybindingsManager } from \"../core/keybindings.ts\";\nimport type { SessionInfo, SessionListProgress } from \"../core/session-manager.ts\";\nimport type { SettingsManager } from \"../core/settings-manager.ts\";\nimport { SessionSelectorComponent } from \"../modes/interactive/components/session-selector.ts\";\nimport { createStartupTui, startStartupTui } from \"./startup-ui.ts\";\n\ntype SessionsLoader = (onProgress?: SessionListProgress, signal?: AbortSignal) => Promise<SessionInfo[]>;\n\n/** Show TUI session selector and return selected session path or null if cancelled */\nexport async function selectSession(\n\tcurrentSessionsLoader: SessionsLoader,\n\tallSessionsLoader: SessionsLoader,\n\tsettingsManager: SettingsManager,\n): Promise<string | null> {\n\tconst ui = await createStartupTui(settingsManager);\n\treturn new Promise((resolve) => {\n\t\tconst keybindings = KeybindingsManager.create();\n\t\tsetKeybindings(keybindings);\n\t\tlet resolved = false;\n\n\t\tconst selector = new SessionSelectorComponent(\n\t\t\tcurrentSessionsLoader,\n\t\t\tallSessionsLoader,\n\t\t\t(path: string) => {\n\t\t\t\tif (!resolved) {\n\t\t\t\t\tresolved = true;\n\t\t\t\t\tui.stop();\n\t\t\t\t\tresolve(path);\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tif (!resolved) {\n\t\t\t\t\tresolved = true;\n\t\t\t\t\tui.stop();\n\t\t\t\t\tresolve(null);\n\t\t\t\t}\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tui.stop();\n\t\t\t\tprocess.exit(0);\n\t\t\t},\n\t\t\t() => ui.requestRender(),\n\t\t\t{ showRenameHint: false, keybindings },\n\t\t);\n\n\t\tui.addChild(selector);\n\t\tui.setFocus(selector.getSessionList());\n\t\tstartStartupTui(ui, settingsManager);\n\t});\n}\n"]}

package/dist/cli/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function setupCli(): void;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAGA,wBAAgB,QAAQ,IAAI,IAAI,CAS/B"}

package/dist/cli/setup.js

@@ -0,0 +1,12 @@
+import { APP_NAME } from "../config.js";
+import { configureHttpDispatcher } from "../core/http-dispatcher.js";
+export function setupCli() {
+    process.title = APP_NAME;
+    process.env.RELAY_CODING_AGENT = "true";
+    process.env.AI_AGENT = "relay";
+    process.emitWarning = (() => { });
+    // Configure undici before provider SDKs issue requests. Settings are applied
+    // once SettingsManager has loaded global/project configuration.
+    configureHttpDispatcher();
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE,MAAM,UAAU,QAAQ;IACvB,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,MAAM,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC/B,OAAO,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,GAAE,CAAC,CAA+B,CAAC;IAE/D,6EAA6E;IAC7E,gEAAgE;IAChE,uBAAuB,EAAE,CAAC;AAC3B,CAAC","sourcesContent":["import { APP_NAME } from \"../config.ts\";\nimport { configureHttpDispatcher } from \"../core/http-dispatcher.ts\";\n\nexport function setupCli(): void {\n\tprocess.title = APP_NAME;\n\tprocess.env.RELAY_CODING_AGENT = \"true\";\n\tprocess.env.AI_AGENT = \"relay\";\n\tprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\n\t// Configure undici before provider SDKs issue requests. Settings are applied\n\t// once SettingsManager has loaded global/project configuration.\n\tconfigureHttpDispatcher();\n}\n"]}

package/dist/cli/startup-ui.d.ts

@@ -0,0 +1,20 @@
+import { type TUI } from "@relay-harness/tui";
+import { SettingsManager } from "../core/settings-manager.ts";
+export declare function createStartupTui(settingsManager: SettingsManager): Promise<TUI>;
+export declare function startStartupTui(ui: TUI, settingsManager: SettingsManager): void;
+/**
+ * First-time setup runs when all of these hold:
+ * - this is the official Relay distribution (not a fork/rebrand)
+ * - experimental features are enabled (RELAY_EXPERIMENTAL=1)
+ * - the default agent directory is used (no custom agent dir override)
+ * - setup was not completed before (settings.json does not exist)
+ */
+export declare function shouldRunFirstTimeSetup(settingsPath?: string): boolean;
+export declare function showStartupSelector<T>(settingsManager: SettingsManager, title: string, options: Array<{
+    label: string;
+    value: T;
+}>): Promise<T | undefined>;
+/** Show the first-time setup dialog and persist the result */
+export declare function showFirstTimeSetup(settingsManager: SettingsManager): Promise<void>;
+export declare function showStartupInput(settingsManager: SettingsManager, title: string, placeholder?: string): Promise<string | undefined>;
+//# sourceMappingURL=startup-ui.d.ts.map

package/dist/cli/startup-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-ui.d.ts","sourceRoot":"","sources":["../../src/cli/startup-ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2D,KAAK,GAAG,EAAiB,MAAM,oBAAoB,CAAC;AAMtH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAwE9D,wBAAsB,gBAAgB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CAUrF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,eAAe,GAAG,IAAI,CAM/E;AAqBD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,GAAE,MAA0B,GAAG,OAAO,CAiBzF;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EAC1C,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,GACzC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAyBxB;AAED,8DAA8D;AAC9D,wBAAsB,kBAAkB,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCxF;AAED,wBAAsB,gBAAgB,CACrC,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA4B7B"}

package/dist/cli/startup-ui.js

@@ -0,0 +1,193 @@
+import { ProcessTerminal, setCapabilityOverrides, setKeybindings, TuiMainScreen } from "@relay-harness/tui";
+import { existsSync } from "fs";
+import { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR, getAgentDir, getSettingsPath, PACKAGE_NAME } from "../config.js";
+import { areExperimentalFeaturesEnabled } from "../core/experimental.js";
+import { KeybindingsManager } from "../core/keybindings.js";
+import { DefaultPackageManager } from "../core/package-manager.js";
+import { SettingsManager } from "../core/settings-manager.js";
+import { ExtensionInputComponent } from "../modes/interactive/components/extension-input.js";
+import { ExtensionSelectorComponent } from "../modes/interactive/components/extension-selector.js";
+import { FirstTimeSetupComponent, } from "../modes/interactive/components/first-time-setup.js";
+import { SYSTEM_THEME_NAME } from "../modes/interactive/theme/system-theme.js";
+import { getTerminalTheme, initTheme, loadThemeFromPath, markTerminalColorsPending, resolveThemeSetting, setRegisteredThemes, setTerminalColors, setTheme, } from "../modes/interactive/theme/theme.js";
+import { requestTerminalColors } from "../modes/interactive/theme/theme-controller.js";
+const OFFICIAL_PACKAGE_NAME = "@relay-harness/coding-agent";
+const OFFICIAL_APP_NAME = "relay";
+const OFFICIAL_CONFIG_DIR_NAME = ".relay";
+function isOfficialDistribution({ packageName, appName, configDirName }) {
+    return (packageName === OFFICIAL_PACKAGE_NAME &&
+        appName === OFFICIAL_APP_NAME &&
+        configDirName === OFFICIAL_CONFIG_DIR_NAME);
+}
+function loadThemes(resources) {
+    const themes = [];
+    const seen = new Set();
+    for (const resource of resources) {
+        if (!resource.enabled)
+            continue;
+        try {
+            const loadedTheme = loadThemeFromPath(resource.path);
+            if (loadedTheme.name) {
+                if (seen.has(loadedTheme.name))
+                    continue;
+                seen.add(loadedTheme.name);
+            }
+            themes.push(loadedTheme);
+        }
+        catch {
+            // Startup prompts should not fail because a theme is broken. The normal
+            // resource loader reports theme diagnostics later in startup.
+        }
+    }
+    return themes;
+}
+async function loadStartupThemes(settingsManager) {
+    const globalSettingsManager = SettingsManager.inMemory(settingsManager.getGlobalSettings(), {
+        projectTrusted: false,
+    });
+    const packageManager = new DefaultPackageManager({
+        cwd: process.cwd(),
+        agentDir: getAgentDir(),
+        settingsManager: globalSettingsManager,
+    });
+    const resolvedPaths = await packageManager.resolve(async () => "skip");
+    return loadThemes(resolvedPaths.themes);
+}
+export async function createStartupTui(settingsManager) {
+    setCapabilityOverrides(settingsManager.getTerminalCapabilityOverrides());
+    setRegisteredThemes(await loadStartupThemes(settingsManager));
+    // The system theme starts in grayscale until the terminal reports its colors.
+    markTerminalColorsPending();
+    initTheme(resolveThemeSetting(settingsManager.getThemeSetting(), getTerminalTheme()) ?? SYSTEM_THEME_NAME);
+    setKeybindings(KeybindingsManager.create());
+    const ui = new TuiMainScreen(new ProcessTerminal(), settingsManager.getShowHardwareCursor(), getAgentDir());
+    ui.setClearOnShrink(settingsManager.getClearOnShrink());
+    return ui;
+}
+export function startStartupTui(ui, settingsManager) {
+    ui.start();
+    const themeSetting = settingsManager.getThemeSetting();
+    queryStartupTerminalColors(ui, () => {
+        setTheme(resolveThemeSetting(themeSetting, getTerminalTheme()) ?? SYSTEM_THEME_NAME);
+    });
+}
+/**
+ * Query the terminal's colors without waiting for them. When they arrive, including after the timeout,
+ * record them for the system theme and "" (terminal default) tokens, run `onColors`, and re-render.
+ */
+function queryStartupTerminalColors(ui, onColors) {
+    void requestTerminalColors(ui, (colors) => {
+        setTerminalColors(colors);
+        onColors();
+        ui.invalidate();
+        ui.requestRender();
+    });
+}
+async function clearStartupTui(ui) {
+    ui.clear();
+    ui.requestRender();
+    await new Promise((resolve) => setTimeout(resolve, 25));
+}
+/**
+ * First-time setup runs when all of these hold:
+ * - this is the official Relay distribution (not a fork/rebrand)
+ * - experimental features are enabled (RELAY_EXPERIMENTAL=1)
+ * - the default agent directory is used (no custom agent dir override)
+ * - setup was not completed before (settings.json does not exist)
+ */
+export function shouldRunFirstTimeSetup(settingsPath = getSettingsPath()) {
+    if (!isOfficialDistribution({
+        packageName: PACKAGE_NAME,
+        appName: APP_NAME,
+        configDirName: CONFIG_DIR_NAME,
+    })) {
+        return false;
+    }
+    if (!areExperimentalFeaturesEnabled()) {
+        return false;
+    }
+    if (process.env[ENV_AGENT_DIR]) {
+        return false;
+    }
+    return !existsSync(settingsPath);
+}
+export async function showStartupSelector(settingsManager, title, options) {
+    const ui = await createStartupTui(settingsManager);
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = async (result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            await clearStartupTui(ui);
+            ui.stop();
+            resolve(result);
+        };
+        const selector = new ExtensionSelectorComponent(title, options.map((option) => option.label), (option) => void finish(options.find((entry) => entry.label === option)?.value), () => void finish(undefined), { tui: ui });
+        ui.addChild(selector);
+        ui.setFocus(selector);
+        startStartupTui(ui, settingsManager);
+    });
+}
+/** Show the first-time setup dialog and persist the result */
+export async function showFirstTimeSetup(settingsManager) {
+    const ui = await createStartupTui(settingsManager);
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = async (result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            if (result) {
+                settingsManager.setTheme(result.theme);
+                settingsManager.setEnableAnalytics(result.shareAnalytics);
+                await settingsManager.flush();
+            }
+            await clearStartupTui(ui);
+            ui.stop();
+            resolve();
+        };
+        ui.start();
+        let previewTheme = SYSTEM_THEME_NAME;
+        setTheme(previewTheme);
+        const component = new FirstTimeSetupComponent({
+            onThemePreview: (themeName) => {
+                previewTheme = themeName;
+                setTheme(themeName);
+                ui.requestRender();
+            },
+            onSubmit: (result) => void finish(result),
+            onCancel: () => void finish(undefined),
+        });
+        ui.addChild(component);
+        ui.setFocus(component);
+        ui.requestRender();
+        // The terminal's colors regenerate the system theme; re-rendering rebuilds the dialog with it.
+        queryStartupTerminalColors(ui, () => setTheme(previewTheme));
+    });
+}
+export async function showStartupInput(settingsManager, title, placeholder) {
+    const ui = await createStartupTui(settingsManager);
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = async (result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            input.dispose();
+            await clearStartupTui(ui);
+            ui.stop();
+            resolve(result);
+        };
+        const input = new ExtensionInputComponent(title, placeholder, (value) => void finish(value), () => void finish(undefined), {
+            tui: ui,
+        });
+        ui.addChild(input);
+        ui.setFocus(input);
+        startStartupTui(ui, settingsManager);
+    });
+}
+//# sourceMappingURL=startup-ui.js.map

package/dist/cli/startup-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-ui.js","sourceRoot":"","sources":["../../src/cli/startup-ui.ts"],"names":[],"mappings":"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","sourcesContent":["import { ProcessTerminal, setCapabilityOverrides, setKeybindings, type TUI, TuiMainScreen } from \"@relay-harness/tui\";\nimport { existsSync } from \"fs\";\nimport { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR, getAgentDir, getSettingsPath, PACKAGE_NAME } from \"../config.ts\";\nimport { areExperimentalFeaturesEnabled } from \"../core/experimental.ts\";\nimport { KeybindingsManager } from \"../core/keybindings.ts\";\nimport { DefaultPackageManager, type ResolvedResource } from \"../core/package-manager.ts\";\nimport { SettingsManager } from \"../core/settings-manager.ts\";\nimport { ExtensionInputComponent } from \"../modes/interactive/components/extension-input.ts\";\nimport { ExtensionSelectorComponent } from \"../modes/interactive/components/extension-selector.ts\";\nimport {\n\tFirstTimeSetupComponent,\n\ttype FirstTimeSetupResult,\n} from \"../modes/interactive/components/first-time-setup.ts\";\nimport { SYSTEM_THEME_NAME } from \"../modes/interactive/theme/system-theme.ts\";\nimport {\n\tgetTerminalTheme,\n\tinitTheme,\n\tloadThemeFromPath,\n\tmarkTerminalColorsPending,\n\tresolveThemeSetting,\n\tsetRegisteredThemes,\n\tsetTerminalColors,\n\tsetTheme,\n\ttype Theme,\n} from \"../modes/interactive/theme/theme.ts\";\nimport { requestTerminalColors } from \"../modes/interactive/theme/theme-controller.ts\";\n\nconst OFFICIAL_PACKAGE_NAME = \"@relay-harness/coding-agent\";\nconst OFFICIAL_APP_NAME = \"relay\";\nconst OFFICIAL_CONFIG_DIR_NAME = \".relay\";\n\ninterface DistributionMetadata {\n\tpackageName: string;\n\tappName: string;\n\tconfigDirName: string;\n}\n\nfunction isOfficialDistribution({ packageName, appName, configDirName }: DistributionMetadata): boolean {\n\treturn (\n\t\tpackageName === OFFICIAL_PACKAGE_NAME &&\n\t\tappName === OFFICIAL_APP_NAME &&\n\t\tconfigDirName === OFFICIAL_CONFIG_DIR_NAME\n\t);\n}\n\nfunction loadThemes(resources: ResolvedResource[]): Theme[] {\n\tconst themes: Theme[] = [];\n\tconst seen = new Set<string>();\n\tfor (const resource of resources) {\n\t\tif (!resource.enabled) continue;\n\t\ttry {\n\t\t\tconst loadedTheme = loadThemeFromPath(resource.path);\n\t\t\tif (loadedTheme.name) {\n\t\t\t\tif (seen.has(loadedTheme.name)) continue;\n\t\t\t\tseen.add(loadedTheme.name);\n\t\t\t}\n\t\t\tthemes.push(loadedTheme);\n\t\t} catch {\n\t\t\t// Startup prompts should not fail because a theme is broken. The normal\n\t\t\t// resource loader reports theme diagnostics later in startup.\n\t\t}\n\t}\n\treturn themes;\n}\n\nasync function loadStartupThemes(settingsManager: SettingsManager): Promise<Theme[]> {\n\tconst globalSettingsManager = SettingsManager.inMemory(settingsManager.getGlobalSettings(), {\n\t\tprojectTrusted: false,\n\t});\n\tconst packageManager = new DefaultPackageManager({\n\t\tcwd: process.cwd(),\n\t\tagentDir: getAgentDir(),\n\t\tsettingsManager: globalSettingsManager,\n\t});\n\tconst resolvedPaths = await packageManager.resolve(async () => \"skip\");\n\treturn loadThemes(resolvedPaths.themes);\n}\n\nexport async function createStartupTui(settingsManager: SettingsManager): Promise<TUI> {\n\tsetCapabilityOverrides(settingsManager.getTerminalCapabilityOverrides());\n\tsetRegisteredThemes(await loadStartupThemes(settingsManager));\n\t// The system theme starts in grayscale until the terminal reports its colors.\n\tmarkTerminalColorsPending();\n\tinitTheme(resolveThemeSetting(settingsManager.getThemeSetting(), getTerminalTheme()) ?? SYSTEM_THEME_NAME);\n\tsetKeybindings(KeybindingsManager.create());\n\tconst ui: TUI = new TuiMainScreen(new ProcessTerminal(), settingsManager.getShowHardwareCursor(), getAgentDir());\n\tui.setClearOnShrink(settingsManager.getClearOnShrink());\n\treturn ui;\n}\n\nexport function startStartupTui(ui: TUI, settingsManager: SettingsManager): void {\n\tui.start();\n\tconst themeSetting = settingsManager.getThemeSetting();\n\tqueryStartupTerminalColors(ui, () => {\n\t\tsetTheme(resolveThemeSetting(themeSetting, getTerminalTheme()) ?? SYSTEM_THEME_NAME);\n\t});\n}\n\n/**\n * Query the terminal's colors without waiting for them. When they arrive, including after the timeout,\n * record them for the system theme and \"\" (terminal default) tokens, run `onColors`, and re-render.\n */\nfunction queryStartupTerminalColors(ui: TUI, onColors: () => void): void {\n\tvoid requestTerminalColors(ui, (colors) => {\n\t\tsetTerminalColors(colors);\n\t\tonColors();\n\t\tui.invalidate();\n\t\tui.requestRender();\n\t});\n}\n\nasync function clearStartupTui(ui: TUI): Promise<void> {\n\tui.clear();\n\tui.requestRender();\n\tawait new Promise((resolve) => setTimeout(resolve, 25));\n}\n\n/**\n * First-time setup runs when all of these hold:\n * - this is the official Relay distribution (not a fork/rebrand)\n * - experimental features are enabled (RELAY_EXPERIMENTAL=1)\n * - the default agent directory is used (no custom agent dir override)\n * - setup was not completed before (settings.json does not exist)\n */\nexport function shouldRunFirstTimeSetup(settingsPath: string = getSettingsPath()): boolean {\n\tif (\n\t\t!isOfficialDistribution({\n\t\t\tpackageName: PACKAGE_NAME,\n\t\t\tappName: APP_NAME,\n\t\t\tconfigDirName: CONFIG_DIR_NAME,\n\t\t})\n\t) {\n\t\treturn false;\n\t}\n\tif (!areExperimentalFeaturesEnabled()) {\n\t\treturn false;\n\t}\n\tif (process.env[ENV_AGENT_DIR]) {\n\t\treturn false;\n\t}\n\treturn !existsSync(settingsPath);\n}\n\nexport async function showStartupSelector<T>(\n\tsettingsManager: SettingsManager,\n\ttitle: string,\n\toptions: Array<{ label: string; value: T }>,\n): Promise<T | undefined> {\n\tconst ui = await createStartupTui(settingsManager);\n\treturn new Promise((resolve) => {\n\t\tlet settled = false;\n\t\tconst finish = async (result: T | undefined) => {\n\t\t\tif (settled) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tsettled = true;\n\t\t\tawait clearStartupTui(ui);\n\t\t\tui.stop();\n\t\t\tresolve(result);\n\t\t};\n\n\t\tconst selector = new ExtensionSelectorComponent(\n\t\t\ttitle,\n\t\t\toptions.map((option) => option.label),\n\t\t\t(option) => void finish(options.find((entry) => entry.label === option)?.value),\n\t\t\t() => void finish(undefined),\n\t\t\t{ tui: ui },\n\t\t);\n\t\tui.addChild(selector);\n\t\tui.setFocus(selector);\n\t\tstartStartupTui(ui, settingsManager);\n\t});\n}\n\n/** Show the first-time setup dialog and persist the result */\nexport async function showFirstTimeSetup(settingsManager: SettingsManager): Promise<void> {\n\tconst ui = await createStartupTui(settingsManager);\n\treturn new Promise((resolve) => {\n\t\tlet settled = false;\n\t\tconst finish = async (result: FirstTimeSetupResult | undefined) => {\n\t\t\tif (settled) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tsettled = true;\n\t\t\tif (result) {\n\t\t\t\tsettingsManager.setTheme(result.theme);\n\t\t\t\tsettingsManager.setEnableAnalytics(result.shareAnalytics);\n\t\t\t\tawait settingsManager.flush();\n\t\t\t}\n\t\t\tawait clearStartupTui(ui);\n\t\t\tui.stop();\n\t\t\tresolve();\n\t\t};\n\n\t\tui.start();\n\t\tlet previewTheme = SYSTEM_THEME_NAME;\n\t\tsetTheme(previewTheme);\n\t\tconst component = new FirstTimeSetupComponent({\n\t\t\tonThemePreview: (themeName) => {\n\t\t\t\tpreviewTheme = themeName;\n\t\t\t\tsetTheme(themeName);\n\t\t\t\tui.requestRender();\n\t\t\t},\n\t\t\tonSubmit: (result) => void finish(result),\n\t\t\tonCancel: () => void finish(undefined),\n\t\t});\n\t\tui.addChild(component);\n\t\tui.setFocus(component);\n\t\tui.requestRender();\n\t\t// The terminal's colors regenerate the system theme; re-rendering rebuilds the dialog with it.\n\t\tqueryStartupTerminalColors(ui, () => setTheme(previewTheme));\n\t});\n}\n\nexport async function showStartupInput(\n\tsettingsManager: SettingsManager,\n\ttitle: string,\n\tplaceholder?: string,\n): Promise<string | undefined> {\n\tconst ui = await createStartupTui(settingsManager);\n\treturn new Promise((resolve) => {\n\t\tlet settled = false;\n\t\tconst finish = async (result: string | undefined) => {\n\t\t\tif (settled) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tsettled = true;\n\t\t\tinput.dispose();\n\t\t\tawait clearStartupTui(ui);\n\t\t\tui.stop();\n\t\t\tresolve(result);\n\t\t};\n\n\t\tconst input = new ExtensionInputComponent(\n\t\t\ttitle,\n\t\t\tplaceholder,\n\t\t\t(value) => void finish(value),\n\t\t\t() => void finish(undefined),\n\t\t\t{\n\t\t\t\ttui: ui,\n\t\t\t},\n\t\t);\n\t\tui.addChild(input);\n\t\tui.setFocus(input);\n\t\tstartStartupTui(ui, settingsManager);\n\t});\n}\n"]}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { setupCli } from "./cli/setup.js";
+import { main } from "./main.js";
+setupCli();
+main(process.argv.slice(2));
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,QAAQ,EAAE,CAAC;AACX,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { setupCli } from \"./cli/setup.ts\";\nimport { main } from \"./main.ts\";\n\nsetupCli();\nmain(process.argv.slice(2));\n"]}

package/dist/config.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Detect if we're running as a Bun compiled binary.
+ * Bun binaries have import.meta.url containing "$bunfs", "~BUN", or "%7EBUN" (Bun's virtual filesystem path)
+ */
+export declare const isBunBinary: boolean;
+/** Detect if Bun is the runtime (compiled binary or bun run) */
+export declare const isBunRuntime: boolean;
+export declare const isBundledNode: boolean;
+/**
+ * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).
+ * - For Bun binary: returns the directory containing the executable
+ * - For Node.js: returns the package root containing package.json
+ * - Ignores Bun binary metadata copied into dist/ when the package root is available
+ */
+export declare function findNodePackageDir(startDir: string): string;
+export declare function getPackageDir(): string;
+/**
+ * Get path to built-in themes directory (shipped with package)
+ * - For Bun binary: theme/ next to executable
+ * - For Node.js (dist/): dist/modes/interactive/theme/
+ * - For source (src/): src/modes/interactive/theme/
+ */
+export declare function getThemesDir(): string;
+/**
+ * Get path to HTML export template directory (shipped with package)
+ * - For Bun binary: export-html/ next to executable
+ * - For Node.js (dist/): dist/core/export-html/
+ * - For source (src/): src/core/export-html/
+ */
+export declare function getExportTemplateDir(): string;
+/** Get path to package.json */
+export declare function getPackageJsonPath(): string;
+/** Get path to README.md */
+export declare function getReadmePath(): string;
+/** Get path to docs directory */
+export declare function getDocsPath(): string;
+/** Get path to examples directory */
+export declare function getExamplesPath(): string;
+/** Get path to CHANGELOG.md */
+export declare function getChangelogPath(): string;
+/**
+ * Get path to built-in interactive assets directory.
+ * - For Bun binary: assets/ next to executable
+ * - For Node.js (dist/): dist/modes/interactive/assets/
+ * - For source (src/): src/modes/interactive/assets/
+ */
+export declare function getInteractiveAssetsDir(): string;
+/** Get path to a bundled interactive asset */
+export declare function getBundledInteractiveAssetPath(name: string): string;
+/** Called by the Bun entry with the path of the QuickJS wasm file embedded in the compiled executable. */
+export declare function setEmbeddedQuickJSWasmPath(path: string): void;
+/**
+ * Get path to `quickjs-wasi/quickjs.wasm`, the VM that runs codemode scripts. Resolved once so the
+ * compiled module cached per path keeps working after an update removes this install (#10439).
+ */
+export declare function getQuickJSWasmPath(): string;
+/** Resolve the codemode worker entry for a release runtime. */
+export declare function resolveCodemodeWorkerSpecifier(runtime: "bun-binary" | "bundled-node" | "unbundled", moduleUrl: string): string | URL | undefined;
+/**
+ * Get the codemode worker entry, or undefined to use the worker that ships next to relay-codemode.
+ * The Bun and Node release builds both pass the worker as an extra entrypoint.
+ */
+export declare function getCodemodeWorkerSpecifier(): string | URL | undefined;
+export type InstallChange = {
+    kind: "updated";
+    version: string;
+} | {
+    kind: "removed";
+};
+/**
+ * Detect that the package this process runs from changed on disk, for example after rebuilding the
+ * source checkout in another terminal. Code loaded on demand can then be missing or from another version.
+ *
+ * Checks the package.json read at startup. Resolving it again would walk up past a deleted install
+ * and could find an unrelated package.json, such as one in the home directory.
+ */
+export declare function detectInstallChange(packageJsonPath?: string | undefined): InstallChange | undefined;
+export declare const PACKAGE_NAME: string;
+export declare const APP_NAME: string;
+export declare const APP_TITLE: string;
+export declare const CONFIG_DIR_NAME: string;
+export declare const VERSION: string;
+export declare const ENV_AGENT_DIR: string;
+export declare const ENV_SESSION_DIR: string;
+export declare function expandTildePath(path: string): string;
+/** Get the share viewer URL for a gist ID, or undefined when RELAY_SHARE_VIEWER_URL is not set. */
+export declare function getShareViewerUrl(gistId: string): string | undefined;
+/** Get the agent config directory (e.g., ~/.relay/agent/) */
+export declare function getAgentDir(): string;
+/** Get path to user's custom themes directory */
+export declare function getCustomThemesDir(): string;
+/** Get path to models.json */
+export declare function getModelsPath(): string;
+/** Get path to auth.json */
+export declare function getAuthPath(): string;
+/** Get path to settings.json */
+export declare function getSettingsPath(): string;
+/** Get path to tools directory */
+export declare function getToolsDir(): string;
+/** Get path to managed binaries directory (fd, rg) */
+export declare function getBinDir(): string;
+/** Get path to prompt templates directory */
+export declare function getPromptsDir(): string;
+/** Get path to sessions directory */
+export declare function getSessionsDir(): string;
+/** Get path to debug log file */
+export declare function getDebugLogPath(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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