@nextclaw/companion 0.1.1-beta.0 → 0.1.1-beta.1

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @nextclaw/companion
 
+## 0.1.1-beta.1
+
+### Patch Changes
+
+- Auto-generated patch release for packages with meaningful drift after their latest version commit.
+
+  Packages:
+  - @nextclaw/agent-chat
+  - @nextclaw/app-runtime
+  - @nextclaw/app-sdk
+  - @nextclaw/channel-plugin-dingtalk
+  - @nextclaw/channel-plugin-discord
+  - @nextclaw/channel-plugin-email
+  - @nextclaw/channel-plugin-mochat
+  - @nextclaw/channel-plugin-qq
+  - @nextclaw/channel-plugin-slack
+  - @nextclaw/channel-plugin-telegram
+  - @nextclaw/channel-plugin-wecom
+  - @nextclaw/channel-plugin-whatsapp
+  - @nextclaw/channel-runtime
+  - @nextclaw/client-sdk
+  - @nextclaw/companion
+  - @nextclaw/kernel
+  - @nextclaw/mcp
+  - @nextclaw/ncp-agent-runtime
+  - @nextclaw/ncp-http-agent-client
+  - @nextclaw/ncp-http-agent-server
+  - @nextclaw/ncp-mcp
+  - @nextclaw/ncp-react
+  - @nextclaw/nextclaw-hermes-acp-bridge
+  - @nextclaw/nextclaw-ncp-runtime-adapter-hermes-http
+  - @nextclaw/nextclaw-ncp-runtime-claude-code-sdk
+  - @nextclaw/nextclaw-ncp-runtime-codex-sdk
+  - @nextclaw/nextclaw-ncp-runtime-http-client
+  - @nextclaw/nextclaw-ncp-runtime-plugin-claude-code-sdk
+  - @nextclaw/nextclaw-ncp-runtime-plugin-codex-sdk
+  - @nextclaw/nextclaw-ncp-runtime-stdio-client
+  - @nextclaw/openclaw-compat
+  - @nextclaw/remote
+
+- Updated dependencies
+  - @nextclaw/client-sdk@0.1.1-beta.1
+
 ## 0.1.1-beta.0
 
 ### Patch Changes

package/dist/{src/launcher/index.js → electron/launcher.js}

@@ -6,10 +6,10 @@ const node_module_1 = require("node:module");
 const node_path_1 = require("node:path");
 const loadModule = (0, node_module_1.createRequire)(__filename);
 const electronBinary = loadModule("electron");
-const appRoot = (0, node_path_1.resolve)(__dirname, "..", "..", "..");
+const mainEntryPath = (0, node_path_1.resolve)(__dirname, "main.js");
 const env = { ...process.env };
 delete env.ELECTRON_RUN_AS_NODE;
-const child = (0, node_child_process_1.spawn)(electronBinary, [appRoot, ...process.argv.slice(2)], {
+const child = (0, node_child_process_1.spawn)(electronBinary, [mainEntryPath, ...process.argv.slice(2)], {
     stdio: "inherit",
     env
 });

package/dist/{src → electron}/main.js

@@ -13,10 +13,10 @@ function resolveBaseUrl(argv) {
     return process.env.NEXTCLAW_COMPANION_BASE_URL?.trim() || "http://127.0.0.1:55667";
 }
 async function main() {
-    const application = new companion_application_service_js_1.CompanionApplicationService({
+    const options = {
         baseUrl: resolveBaseUrl(process.argv.slice(1)),
         runtimeStatePath: process.env.NEXTCLAW_COMPANION_RUNTIME_STATE_PATH?.trim() || undefined
-    });
-    await application.run();
+    };
+    await new companion_application_service_js_1.CompanionApplicationService(options).run();
 }
 void main();

package/dist/{src/preload/index.js → electron/preload.js}

@@ -2,12 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const electron_1 = require("electron");
 electron_1.contextBridge.exposeInMainWorld("nextclawCompanion", {
-    onView: (listener) => {
-        electron_1.ipcRenderer.on("companion:view", (_event, view) => {
-            listener(view);
-        });
-    },
     open: () => electron_1.ipcRenderer.invoke("companion:open"),
     quit: () => electron_1.ipcRenderer.invoke("companion:quit"),
-    ready: () => electron_1.ipcRenderer.send("companion:ready")
+    getBootstrap: () => electron_1.ipcRenderer.invoke("companion:get-bootstrap")
 });

package/dist/{src → electron}/services/companion-application.service.js

@@ -3,26 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CompanionApplicationService = void 0;
 const electron_1 = require("electron");
 const node_path_1 = require("node:path");
-const companion_runtime_state_store_js_1 = require("../stores/companion-runtime-state.store.js");
-const companion_window_position_store_js_1 = require("../stores/companion-window-position.store.js");
-const companion_runtime_client_service_js_1 = require("./companion-runtime-client.service.js");
+const companion_runtime_state_persistence_service_js_1 = require("./companion-runtime-state-persistence.service.js");
 const companion_tray_service_js_1 = require("./companion-tray.service.js");
+const companion_window_position_persistence_service_js_1 = require("./companion-window-position-persistence.service.js");
 const companion_window_service_js_1 = require("./companion-window.service.js");
 class CompanionApplicationService {
     options;
-    runtimeClient;
-    runtimeStateStore;
+    runtimeStatePersistenceService;
     windowService;
     trayService;
     quitting = false;
     constructor(options) {
         this.options = options;
-        const preloadPath = (0, node_path_1.resolve)(__dirname, "..", "preload", "index.js");
-        this.runtimeClient = new companion_runtime_client_service_js_1.CompanionRuntimeClientService(options.baseUrl);
-        this.runtimeStateStore = options.runtimeStatePath
-            ? new companion_runtime_state_store_js_1.CompanionRuntimeStateStore(options.runtimeStatePath)
+        this.runtimeStatePersistenceService = options.runtimeStatePath
+            ? new companion_runtime_state_persistence_service_js_1.CompanionRuntimeStatePersistenceService(options.runtimeStatePath)
             : null;
-        this.windowService = new companion_window_service_js_1.CompanionWindowService(preloadPath, companion_window_position_store_js_1.CompanionWindowPositionStore.fromUserData(electron_1.app.getPath("userData")));
+        this.windowService = new companion_window_service_js_1.CompanionWindowService({
+            preloadPath: (0, node_path_1.resolve)(__dirname, "..", "preload.js"),
+            rendererEntryPath: (0, node_path_1.resolve)(__dirname, "..", "..", "ui", "index.html"),
+            positionPersistenceService: companion_window_position_persistence_service_js_1.CompanionWindowPositionPersistenceService.fromUserData(electron_1.app.getPath("userData")),
+            baseUrl: options.baseUrl,
+            onQuit: () => this.quit()
+        });
         this.trayService = new companion_tray_service_js_1.CompanionTrayService(options.baseUrl, () => this.windowService.toggleVisibility(), () => this.quit());
     }
     run = async () => {
@@ -36,16 +38,15 @@ class CompanionApplicationService {
         electron_1.app.on("window-all-closed", () => undefined);
         electron_1.app.on("before-quit", () => {
             this.quitting = true;
-            this.runtimeClient.stop();
             this.trayService.destroy();
             this.windowService.destroy();
-            this.runtimeStateStore?.clear();
+            this.runtimeStatePersistenceService?.clear();
         });
         electron_1.app.on("activate", () => {
             this.windowService.show();
         });
         await electron_1.app.whenReady();
-        this.runtimeStateStore?.write({
+        this.runtimeStatePersistenceService?.write({
             pid: process.pid,
             startedAt: new Date().toISOString(),
             baseUrl: this.options.baseUrl
@@ -53,9 +54,6 @@ class CompanionApplicationService {
         await this.windowService.create();
         this.windowService.show();
         this.trayService.create();
-        await this.runtimeClient.start((view) => {
-            this.windowService.updateView(view);
-        });
     };
     quit = () => {
         if (this.quitting) {

package/dist/{src/stores/companion-runtime-state.store.js → electron/services/companion-runtime-state-persistence.service.js}

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CompanionRuntimeStateStore = void 0;
+exports.CompanionRuntimeStatePersistenceService = void 0;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-class CompanionRuntimeStateStore {
+class CompanionRuntimeStatePersistenceService {
     filePath;
     constructor(filePath) {
         this.filePath = filePath;
@@ -18,4 +18,4 @@ class CompanionRuntimeStateStore {
         }
     };
 }
-exports.CompanionRuntimeStateStore = CompanionRuntimeStateStore;
+exports.CompanionRuntimeStatePersistenceService = CompanionRuntimeStatePersistenceService;

package/dist/{src/stores/companion-window-position.store.js → electron/services/companion-window-position-persistence.service.js}

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CompanionWindowPositionStore = void 0;
+exports.CompanionWindowPositionPersistenceService = void 0;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-class CompanionWindowPositionStore {
+class CompanionWindowPositionPersistenceService {
     filePath;
     constructor(filePath) {
         this.filePath = filePath;
@@ -24,7 +24,7 @@ class CompanionWindowPositionStore {
         (0, node_fs_1.writeFileSync)(this.filePath, JSON.stringify(bounds, null, 2));
     };
     static fromUserData = (userDataPath) => {
-        return new CompanionWindowPositionStore((0, node_path_1.resolve)(userDataPath, "companion-window.json"));
+        return new CompanionWindowPositionPersistenceService((0, node_path_1.resolve)(userDataPath, "companion-window.json"));
     };
 }
-exports.CompanionWindowPositionStore = CompanionWindowPositionStore;
+exports.CompanionWindowPositionPersistenceService = CompanionWindowPositionPersistenceService;

package/dist/{src → electron}/services/companion-window.service.js

@@ -2,21 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CompanionWindowService = void 0;
 const electron_1 = require("electron");
-const companion_renderer_html_utils_js_1 = require("../utils/companion-renderer-html.utils.js");
 class CompanionWindowService {
-    preloadPath;
-    positionStore;
+    options;
     window = null;
-    currentView = null;
-    constructor(preloadPath, positionStore) {
-        this.preloadPath = preloadPath;
-        this.positionStore = positionStore;
+    constructor(options) {
+        this.options = options;
     }
     create = async () => {
         if (this.window) {
             return;
         }
-        const bounds = this.positionStore.read();
+        const bounds = this.options.positionPersistenceService.read();
         this.window = new electron_1.BrowserWindow({
             width: 112,
             height: 132,
@@ -30,7 +26,7 @@ class CompanionWindowService {
             skipTaskbar: true,
             hasShadow: false,
             webPreferences: {
-                preload: this.preloadPath,
+                preload: this.options.preloadPath,
                 contextIsolation: true,
                 nodeIntegration: false
             }
@@ -49,24 +45,21 @@ class CompanionWindowService {
         });
         electron_1.ipcMain.removeHandler("companion:open");
         electron_1.ipcMain.handle("companion:open", async () => {
-            const openUrl = this.currentView?.openUrl;
-            if (openUrl) {
-                await electron_1.shell.openExternal(openUrl);
-            }
+            await electron_1.shell.openExternal(this.options.baseUrl);
             return null;
         });
         electron_1.ipcMain.removeHandler("companion:quit");
         electron_1.ipcMain.handle("companion:quit", async () => {
-            electron_1.app.quit();
+            this.options.onQuit();
             return null;
         });
-        electron_1.ipcMain.removeAllListeners("companion:ready");
-        electron_1.ipcMain.on("companion:ready", () => {
-            if (this.currentView) {
-                this.window?.webContents.send("companion:view", this.currentView);
-            }
+        electron_1.ipcMain.removeHandler("companion:get-bootstrap");
+        electron_1.ipcMain.handle("companion:get-bootstrap", async () => {
+            return {
+                baseUrl: this.options.baseUrl
+            };
         });
-        await this.window.loadURL(`data:text/html;charset=utf-8,${encodeURIComponent((0, companion_renderer_html_utils_js_1.renderCompanionHtml)())}`);
+        await this.window.loadFile(this.options.rendererEntryPath);
     };
     show = () => {
         this.window?.showInactive();
@@ -81,14 +74,10 @@ class CompanionWindowService {
         }
         this.window.showInactive();
     };
-    updateView = (view) => {
-        this.currentView = view;
-        this.window?.webContents.send("companion:view", view);
-    };
     destroy = () => {
         electron_1.ipcMain.removeHandler("companion:open");
         electron_1.ipcMain.removeHandler("companion:quit");
-        electron_1.ipcMain.removeAllListeners("companion:ready");
+        electron_1.ipcMain.removeHandler("companion:get-bootstrap");
         this.window?.destroy();
         this.window = null;
     };
@@ -97,7 +86,7 @@ class CompanionWindowService {
         if (!bounds) {
             return;
         }
-        this.positionStore.write({
+        this.options.positionPersistenceService.write({
             x: bounds.x,
             y: bounds.y
         });

package/dist/electron/types/companion-shell.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/app/app.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.App = App;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const companion_shell_container_js_1 = require("./components/companion-shell.container.js");
+const companion_presenter_provider_js_1 = require("./providers/companion-presenter.provider.js");
+function App() {
+    const presenter = (0, companion_presenter_provider_js_1.usePresenter)();
+    (0, react_1.useEffect)(() => {
+        void presenter.bootstrap();
+        return () => {
+            presenter.shutdown();
+        };
+    }, [presenter]);
+    return (0, jsx_runtime_1.jsx)(companion_shell_container_js_1.CompanionShellContainer, {});
+}

package/dist/src/app/components/companion-shell.container.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompanionShellContainer = CompanionShellContainer;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const lucide_react_1 = require("lucide-react");
+const companion_runtime_store_js_1 = require("../../stores/companion-runtime.store.js");
+const companion_shell_store_js_1 = require("../../stores/companion-shell.store.js");
+const companion_presenter_provider_js_1 = require("../providers/companion-presenter.provider.js");
+function CompanionShellContainer() {
+    const presenter = (0, companion_presenter_provider_js_1.usePresenter)();
+    const view = (0, companion_runtime_store_js_1.useCompanionRuntimeStore)((state) => state.snapshot.currentView);
+    const connectionState = (0, companion_runtime_store_js_1.useCompanionRuntimeStore)((state) => state.snapshot.connectionState);
+    const bootstrapped = (0, companion_shell_store_js_1.useCompanionShellStore)((state) => state.snapshot.bootstrapped);
+    const statusColorClass = connectionState === "running"
+        ? "bg-success"
+        : connectionState === "offline"
+            ? "bg-danger"
+            : "bg-slate-300";
+    return ((0, jsx_runtime_1.jsx)("div", { className: "h-screen w-screen overflow-hidden bg-transparent", children: (0, jsx_runtime_1.jsx)("div", { className: "grid h-full place-items-center", children: (0, jsx_runtime_1.jsxs)("div", { className: "grid w-[112px] justify-items-center gap-2", children: [(0, jsx_runtime_1.jsxs)("div", { className: "drag-region relative grid h-24 w-24 place-items-center overflow-hidden rounded-[28px] border border-white/70 bg-white/90 shadow-companion backdrop-blur-xl", children: [(0, jsx_runtime_1.jsxs)("div", { className: "no-drag absolute right-1.5 top-1.5 z-20 flex gap-1", children: [(0, jsx_runtime_1.jsx)("button", { type: "button", "aria-label": "Open NextClaw", onClick: () => void presenter.companionShellManager.open(), className: "grid h-5 w-5 place-items-center rounded-full bg-slate-900/10 text-slate-700 transition hover:bg-slate-900/15", children: (0, jsx_runtime_1.jsx)(lucide_react_1.ExternalLink, { className: "h-3 w-3" }) }), (0, jsx_runtime_1.jsx)("button", { type: "button", "aria-label": "Quit Companion", onClick: () => void presenter.companionShellManager.quit(), className: "grid h-5 w-5 place-items-center rounded-full bg-slate-900/10 text-slate-700 transition hover:bg-slate-900/15", children: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { className: "h-3 w-3" }) })] }), view.avatarUrl ? ((0, jsx_runtime_1.jsx)("img", { src: view.avatarUrl, alt: "", className: "h-full w-full object-cover" })) : ((0, jsx_runtime_1.jsx)("span", { className: "grid h-full w-full place-items-center bg-gradient-to-b from-white to-slate-200 text-[28px] font-bold text-slate-800", children: (view.title || "NC").slice(0, 2).toUpperCase() })), (0, jsx_runtime_1.jsx)("span", { className: `absolute bottom-2 right-2 h-3.5 w-3.5 rounded-full border-2 border-white ${statusColorClass}` })] }), (0, jsx_runtime_1.jsxs)("button", { type: "button", onClick: () => void presenter.companionShellManager.open(), className: "no-drag w-full rounded-xl px-1 text-center", children: [(0, jsx_runtime_1.jsx)("div", { className: "truncate text-[12px] font-semibold leading-4 text-slate-900", children: bootstrapped ? view.title : "NextClaw" }), (0, jsx_runtime_1.jsx)("div", { className: "truncate pt-0.5 text-[11px] leading-4 text-slate-500", children: bootstrapped ? view.subtitle : "Connecting" })] })] }) }) }));
+}

package/dist/src/app/main.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const client_1 = require("react-dom/client");
+const app_js_1 = require("./app.js");
+const companion_presenter_provider_js_1 = require("./providers/companion-presenter.provider.js");
+const companion_presenter_js_1 = require("../presenters/companion.presenter.js");
+require("./index.css");
+(0, client_1.createRoot)(document.getElementById("root")).render((0, jsx_runtime_1.jsx)(react_1.StrictMode, { children: (0, jsx_runtime_1.jsx)(companion_presenter_provider_js_1.CompanionPresenterProvider, { presenter: companion_presenter_js_1.companionPresenter, children: (0, jsx_runtime_1.jsx)(app_js_1.App, {}) }) }));

package/dist/src/app/providers/companion-presenter.provider.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompanionPresenterProvider = CompanionPresenterProvider;
+exports.usePresenter = usePresenter;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const CompanionPresenterContext = (0, react_1.createContext)(null);
+function CompanionPresenterProvider({ presenter, children }) {
+    return ((0, jsx_runtime_1.jsx)(CompanionPresenterContext.Provider, { value: presenter, children: children }));
+}
+function usePresenter() {
+    const presenter = (0, react_1.useContext)(CompanionPresenterContext);
+    if (!presenter) {
+        throw new Error("usePresenter must be used inside CompanionPresenterProvider");
+    }
+    return presenter;
+}

package/dist/src/managers/companion-runtime.manager.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompanionRuntimeManager = void 0;
+const companion_runtime_client_service_js_1 = require("../services/companion-runtime-client.service.js");
+const companion_runtime_store_js_1 = require("../stores/companion-runtime.store.js");
+class CompanionRuntimeManager {
+    clientService = null;
+    baseUrl = null;
+    refreshTimer = null;
+    subscription = null;
+    started = false;
+    start = async (baseUrl) => {
+        if (this.started && this.baseUrl === baseUrl) {
+            return;
+        }
+        this.stop();
+        this.baseUrl = baseUrl;
+        this.clientService = new companion_runtime_client_service_js_1.CompanionRuntimeClientService(baseUrl);
+        await this.clientService.initialize();
+        companion_runtime_store_js_1.useCompanionRuntimeStore.getState().setSnapshot((0, companion_runtime_store_js_1.createInitialCompanionRuntimeSnapshot)(baseUrl));
+        await this.refresh();
+        this.subscription = this.ensureClientService().subscribeToSessions(async () => {
+            await this.refresh();
+        }, {
+            reconnectDelayMs: 1000,
+            onError: async () => {
+                await this.refresh();
+            }
+        });
+        this.refreshTimer = setInterval(() => {
+            void this.refresh();
+        }, 10000);
+        this.started = true;
+    };
+    stop = () => {
+        this.subscription?.close();
+        this.subscription = null;
+        if (this.refreshTimer !== null) {
+            clearInterval(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+        this.clientService = null;
+        this.baseUrl = null;
+        this.started = false;
+        companion_runtime_store_js_1.useCompanionRuntimeStore.getState().reset();
+    };
+    getSnapshot = () => {
+        return companion_runtime_store_js_1.useCompanionRuntimeStore.getState().snapshot;
+    };
+    syncRuntimeSnapshot = ({ agents, sessions }) => {
+        const baseUrl = this.ensureBaseUrl();
+        const currentView = this.resolveCurrentView({
+            baseUrl,
+            agents,
+            sessions
+        });
+        const connectionState = currentView.state === "running" ? "running" : "idle";
+        const snapshot = {
+            baseUrl,
+            agents,
+            sessions,
+            connectionState,
+            offlineReason: null,
+            currentView
+        };
+        companion_runtime_store_js_1.useCompanionRuntimeStore.getState().setSnapshot(snapshot);
+        return snapshot;
+    };
+    applyOfflineState = (reason) => {
+        const baseUrl = this.baseUrl ?? companion_runtime_store_js_1.useCompanionRuntimeStore.getState().snapshot.baseUrl ?? "http://127.0.0.1:55667";
+        const snapshot = {
+            baseUrl,
+            agents: [],
+            sessions: [],
+            connectionState: "offline",
+            offlineReason: reason ?? null,
+            currentView: {
+                state: "offline",
+                title: "NextClaw",
+                subtitle: reason?.summary?.trim() || "Runtime unavailable",
+                openUrl: baseUrl
+            }
+        };
+        companion_runtime_store_js_1.useCompanionRuntimeStore.getState().setSnapshot(snapshot);
+        return snapshot;
+    };
+    refresh = async () => {
+        try {
+            const [agents, sessions] = await Promise.all([
+                this.ensureClientService().listAgents(),
+                this.ensureClientService().listSessions()
+            ]);
+            this.syncRuntimeSnapshot({
+                agents,
+                sessions: sessions.sessions
+            });
+        }
+        catch (error) {
+            this.applyOfflineState(error instanceof Error
+                ? { summary: this.summarizeOfflineError(error.message) }
+                : undefined);
+        }
+    };
+    ensureClientService = () => {
+        if (!this.clientService) {
+            this.clientService = new companion_runtime_client_service_js_1.CompanionRuntimeClientService(this.ensureBaseUrl());
+        }
+        return this.clientService;
+    };
+    ensureBaseUrl = () => {
+        if (!this.baseUrl) {
+            throw new Error("CompanionRuntimeManager baseUrl has not been initialized.");
+        }
+        return this.baseUrl;
+    };
+    resolveCurrentView = ({ baseUrl, agents, sessions }) => {
+        const runningSession = [...sessions]
+            .filter((session) => session.status === "running")
+            .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt))[0];
+        if (!runningSession) {
+            return {
+                state: "idle",
+                title: "NextClaw",
+                subtitle: "No active agent",
+                openUrl: baseUrl
+            };
+        }
+        const agent = agents.find((entry) => entry.id === runningSession.agentId) ?? null;
+        return {
+            state: "running",
+            title: agent?.displayName?.trim() || runningSession.agentId || "Active Agent",
+            subtitle: runningSession.sessionId,
+            avatarUrl: runningSession.agentId
+                ? agent?.avatarUrl?.trim() || this.ensureClientService().resolveAvatarUrl(runningSession.agentId)
+                : undefined,
+            sessionId: runningSession.sessionId,
+            agentId: runningSession.agentId,
+            openUrl: baseUrl
+        };
+    };
+    summarizeOfflineError = (message) => {
+        if (/fetch failed/i.test(message)) {
+            return "Cannot reach runtime";
+        }
+        if (/timed out/i.test(message)) {
+            return "Runtime timeout";
+        }
+        const trimmed = message.trim();
+        return trimmed.length > 28 ? `${trimmed.slice(0, 25)}...` : trimmed || "Runtime unavailable";
+    };
+}
+exports.CompanionRuntimeManager = CompanionRuntimeManager;

package/dist/src/managers/companion-runtime.manager.test.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const companion_runtime_store_js_1 = require("../stores/companion-runtime.store.js");
+const companion_runtime_manager_js_1 = require("./companion-runtime.manager.js");
+(0, vitest_1.describe)("CompanionRuntimeManager", () => {
+    (0, vitest_1.beforeEach)(() => {
+        companion_runtime_store_js_1.useCompanionRuntimeStore.getState().reset();
+    });
+    (0, vitest_1.it)("prefers the most recently updated running session", () => {
+        const manager = new companion_runtime_manager_js_1.CompanionRuntimeManager();
+        const baseUrl = "http://127.0.0.1:55667";
+        manager.baseUrl = baseUrl;
+        const snapshot = manager.syncRuntimeSnapshot({
+            agents: [{ id: "writer", displayName: "Writer" }],
+            sessions: [
+                { sessionId: "older", agentId: "writer", messageCount: 1, updatedAt: "2026-05-05T00:00:00.000Z", status: "running" },
+                { sessionId: "newer", agentId: "writer", messageCount: 2, updatedAt: "2026-05-06T00:00:00.000Z", status: "running" }
+            ]
+        });
+        (0, vitest_1.expect)(snapshot.currentView.sessionId).toBe("newer");
+        (0, vitest_1.expect)(snapshot.currentView.title).toBe("Writer");
+        (0, vitest_1.expect)(snapshot.connectionState).toBe("running");
+    });
+    (0, vitest_1.it)("falls back to an idle shell view when no running session exists", () => {
+        const manager = new companion_runtime_manager_js_1.CompanionRuntimeManager();
+        const baseUrl = "http://127.0.0.1:55667";
+        manager.baseUrl = baseUrl;
+        const snapshot = manager.syncRuntimeSnapshot({
+            agents: [],
+            sessions: []
+        });
+        (0, vitest_1.expect)(snapshot.currentView.state).toBe("idle");
+        (0, vitest_1.expect)(snapshot.currentView.subtitle).toBe("No active agent");
+        (0, vitest_1.expect)(snapshot.connectionState).toBe("idle");
+    });
+    (0, vitest_1.it)("produces an offline snapshot with a readable reason", () => {
+        const manager = new companion_runtime_manager_js_1.CompanionRuntimeManager();
+        manager.baseUrl = "http://127.0.0.1:55667";
+        const snapshot = manager.applyOfflineState({ summary: "Cannot reach runtime" });
+        (0, vitest_1.expect)(snapshot.connectionState).toBe("offline");
+        (0, vitest_1.expect)(snapshot.currentView.state).toBe("offline");
+        (0, vitest_1.expect)(snapshot.currentView.subtitle).toBe("Cannot reach runtime");
+    });
+});

package/dist/src/managers/companion-shell.manager.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompanionShellManager = void 0;
+const companion_shell_store_js_1 = require("../stores/companion-shell.store.js");
+class CompanionShellManager {
+    bootstrap = async () => {
+        const bootstrap = await window.nextclawCompanion.getBootstrap();
+        const snapshot = {
+            baseUrl: bootstrap.baseUrl,
+            bootstrapped: true
+        };
+        companion_shell_store_js_1.useCompanionShellStore.getState().setSnapshot(snapshot);
+        return snapshot;
+    };
+    open = async () => {
+        await window.nextclawCompanion.open();
+    };
+    quit = async () => {
+        await window.nextclawCompanion.quit();
+    };
+}
+exports.CompanionShellManager = CompanionShellManager;

package/dist/src/presenters/companion.presenter.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.companionPresenter = exports.CompanionPresenter = void 0;
+const companion_runtime_manager_js_1 = require("../managers/companion-runtime.manager.js");
+const companion_shell_manager_js_1 = require("../managers/companion-shell.manager.js");
+class CompanionPresenter {
+    companionRuntimeManager = new companion_runtime_manager_js_1.CompanionRuntimeManager();
+    companionShellManager = new companion_shell_manager_js_1.CompanionShellManager();
+    bootstrapPromise = null;
+    bootstrapped = false;
+    bootstrap = async () => {
+        if (this.bootstrapped) {
+            return;
+        }
+        if (this.bootstrapPromise) {
+            return await this.bootstrapPromise;
+        }
+        this.bootstrapPromise = (async () => {
+            const shellSnapshot = await this.companionShellManager.bootstrap();
+            await this.companionRuntimeManager.start(shellSnapshot.baseUrl);
+            this.bootstrapped = true;
+        })();
+        try {
+            await this.bootstrapPromise;
+        }
+        finally {
+            this.bootstrapPromise = null;
+        }
+    };
+    shutdown = () => {
+        this.companionRuntimeManager.stop();
+        this.bootstrapped = false;
+        this.bootstrapPromise = null;
+    };
+}
+exports.CompanionPresenter = CompanionPresenter;
+exports.companionPresenter = new CompanionPresenter();