happy-imou-cloud 2.0.10 → 2.0.11

package/dist/{runClaude-C1W_Nw0C.cjs → runClaude-BMHlBny_.cjs}

@@ -1,47 +1,48 @@
 'use strict';
 
-var os = require('node:os');
 var node_crypto = require('node:crypto');
-var api = require('./api-DUE5TJBE.cjs');
-var index = require('./index-Cuvfa15L.cjs');
-var types = require('./types-DVk3crez.cjs');
+var api = require('./api-Ye-rPX6s.cjs');
+require('cross-spawn');
+require('@agentclientprotocol/sdk');
+var index = require('./index-J7QKJ8lc.cjs');
+require('ps-list');
+require('fs');
+require('path');
+require('os');
+require('child_process');
+var fs$1 = require('node:fs');
 var path = require('node:path');
+var os = require('node:os');
+require('./persistence-xK5CKhbn.cjs');
 var promises = require('node:fs/promises');
 var fs = require('fs/promises');
-var ink = require('ink');
-var registerKillSessionHandler = require('./registerKillSessionHandler-DCMFiXyA.cjs');
-var React = require('react');
+require('crypto');
 var node_child_process = require('node:child_process');
+require('chalk');
+require('node:events');
+require('axios');
+require('tweetnacl');
+require('open');
+var React = require('react');
+var ink = require('ink');
+var ProviderSelectionHandler = require('./ProviderSelectionHandler-DBGobhGZ.cjs');
+var types = require('./types-DVk3crez.cjs');
+var registerKillSessionHandler = require('./registerKillSessionHandler-CH6yN0eG.cjs');
 var node_readline = require('node:readline');
-var fs$1 = require('node:fs');
 var node_url = require('node:url');
-require('axios');
-require('node:events');
 require('socket.io-client');
-require('tweetnacl');
 require('expo-server-sdk');
-require('chalk');
 var node_util = require('node:util');
-var persistence = require('./persistence-D7JtnrYA.cjs');
 var node_http = require('node:http');
-require('fs');
 require('zod');
-require('child_process');
-require('util');
-require('crypto');
-require('path');
-require('os');
 require('tmp');
 require('qrcode-terminal');
 require('node:module');
-require('open');
 require('url');
-require('ps-list');
-require('cross-spawn');
 require('fastify');
 require('fastify-type-provider-zod');
 require('http');
-require('@agentclientprotocol/sdk');
+require('util');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 class Session {
@@ -66,8 +67,7 @@ class Session {
   thinking = false;
   /** Callbacks to be notified when session ID is found/changed */
   sessionFoundCallbacks = [];
-  /** Keep alive interval reference for cleanup */
-  keepAliveInterval;
+  keepAliveController;
   constructor(opts) {
     this.path = opts.path;
     this.api = opts.api;
@@ -82,26 +82,29 @@ class Session {
     this._onModeChange = opts.onModeChange;
     this.hookSettingsPath = opts.hookSettingsPath;
     this.jsRuntime = opts.jsRuntime ?? "node";
-    this.client.keepAlive(this.thinking, this.mode);
-    this.keepAliveInterval = setInterval(() => {
-      this.client.keepAlive(this.thinking, this.mode);
-    }, 2e3);
+    this.keepAliveController = ProviderSelectionHandler.createKeepAliveController({
+      initialMode: this.mode,
+      initialThinking: this.thinking,
+      send: (thinking, mode) => {
+        this.client.keepAlive(thinking, mode);
+      }
+    });
   }
   /**
    * Cleanup resources (call when session is no longer needed)
    */
   cleanup = () => {
-    clearInterval(this.keepAliveInterval);
+    this.keepAliveController.dispose();
     this.sessionFoundCallbacks = [];
     api.logger.debug("[Session] Cleaned up resources");
   };
   onThinkingChange = (thinking) => {
     this.thinking = thinking;
-    this.client.keepAlive(thinking, this.mode);
+    this.keepAliveController.setThinking(thinking);
   };
   onModeChange = (mode) => {
     this.mode = mode;
-    this.client.keepAlive(this.thinking, mode);
+    this.keepAliveController.setMode(mode);
     this._onModeChange(mode);
   };
   /**
@@ -715,6 +718,50 @@ async function claudeLocalLauncher(session) {
   return exitReason || { type: "exit", code: 0 };
 }
 
+function parseCompact(message) {
+  const trimmed = message.trim();
+  if (trimmed === "/compact") {
+    return {
+      isCompact: true,
+      originalMessage: trimmed
+    };
+  }
+  if (trimmed.startsWith("/compact ")) {
+    return {
+      isCompact: true,
+      originalMessage: trimmed
+    };
+  }
+  return {
+    isCompact: false,
+    originalMessage: message
+  };
+}
+function parseClear(message) {
+  const trimmed = message.trim();
+  return {
+    isClear: trimmed === "/clear"
+  };
+}
+function parseSpecialCommand(message) {
+  const compactResult = parseCompact(message);
+  if (compactResult.isCompact) {
+    return {
+      type: "compact",
+      originalMessage: compactResult.originalMessage
+    };
+  }
+  const clearResult = parseClear(message);
+  if (clearResult.isClear) {
+    return {
+      type: "clear"
+    };
+  }
+  return {
+    type: null
+  };
+}
+
 const RemoteModeDisplay = ({ messageBuffer, logPath, onExit, onSwitchToLocal }) => {
   const [messages, setMessages] = React.useState([]);
   const [confirmationMode, setConfirmationMode] = React.useState(null);
@@ -806,39 +853,615 @@ const RemoteModeDisplay = ({ messageBuffer, logPath, onExit, onSwitchToLocal })
       for (let i = 0; i < line.length; i += maxLineLength) {
         chunks.push(line.slice(i, i + maxLineLength));
       }
-      return chunks.join("\n");
-    }).join("\n");
-  };
-  return /* @__PURE__ */ React.createElement(ink.Box, { flexDirection: "column", width: terminalWidth, height: terminalHeight }, /* @__PURE__ */ React.createElement(
-    ink.Box,
-    {
-      flexDirection: "column",
-      width: terminalWidth,
-      height: terminalHeight - 4,
-      borderStyle: "round",
-      borderColor: "gray",
-      paddingX: 1,
-      overflow: "hidden"
-    },
-    /* @__PURE__ */ React.createElement(ink.Box, { flexDirection: "column", marginBottom: 1 }, /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", bold: true }, "\u{1F4E1} Remote Mode - Claude Messages"), /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", dimColor: true }, "\u2500".repeat(Math.min(terminalWidth - 4, 60)))),
-    /* @__PURE__ */ React.createElement(ink.Box, { flexDirection: "column", height: terminalHeight - 10, overflow: "hidden" }, messages.length === 0 ? /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", dimColor: true }, "Waiting for messages...") : (
-      // Show only the last messages that fit in the available space
-      messages.slice(-Math.max(1, terminalHeight - 10)).map((msg) => /* @__PURE__ */ React.createElement(ink.Box, { key: msg.id, flexDirection: "column", marginBottom: 1 }, /* @__PURE__ */ React.createElement(ink.Text, { color: getMessageColor(msg.type), dimColor: true }, formatMessage(msg))))
-    ))
-  ), /* @__PURE__ */ React.createElement(
-    ink.Box,
-    {
-      width: terminalWidth,
-      borderStyle: "round",
-      borderColor: actionInProgress ? "gray" : confirmationMode === "exit" ? "red" : confirmationMode === "switch" ? "yellow" : "green",
-      paddingX: 2,
-      justifyContent: "center",
-      alignItems: "center",
-      flexDirection: "column"
-    },
-    /* @__PURE__ */ React.createElement(ink.Box, { flexDirection: "column", alignItems: "center" }, actionInProgress === "exiting" ? /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", bold: true }, "Exiting...") : actionInProgress === "switching" ? /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", bold: true }, "Switching to local mode...") : confirmationMode === "exit" ? /* @__PURE__ */ React.createElement(ink.Text, { color: "red", bold: true }, "\u26A0\uFE0F  Press Ctrl-C again to exit completely") : confirmationMode === "switch" ? /* @__PURE__ */ React.createElement(ink.Text, { color: "yellow", bold: true }, "\u23F8\uFE0F  Press space again to switch to local mode") : /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(ink.Text, { color: "green", bold: true }, "\u{1F4F1} Press space to switch to local mode \u2022 Ctrl-C to exit")), process.env.DEBUG && logPath && /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", dimColor: true }, "Debug logs: ", logPath))
-  ));
-};
+      return chunks.join("\n");
+    }).join("\n");
+  };
+  return /* @__PURE__ */ React.createElement(ink.Box, { flexDirection: "column", width: terminalWidth, height: terminalHeight }, /* @__PURE__ */ React.createElement(
+    ink.Box,
+    {
+      flexDirection: "column",
+      width: terminalWidth,
+      height: terminalHeight - 4,
+      borderStyle: "round",
+      borderColor: "gray",
+      paddingX: 1,
+      overflow: "hidden"
+    },
+    /* @__PURE__ */ React.createElement(ink.Box, { flexDirection: "column", marginBottom: 1 }, /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", bold: true }, "\u{1F4E1} Remote Mode - Claude Messages"), /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", dimColor: true }, "\u2500".repeat(Math.min(terminalWidth - 4, 60)))),
+    /* @__PURE__ */ React.createElement(ink.Box, { flexDirection: "column", height: terminalHeight - 10, overflow: "hidden" }, messages.length === 0 ? /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", dimColor: true }, "Waiting for messages...") : (
+      // Show only the last messages that fit in the available space
+      messages.slice(-Math.max(1, terminalHeight - 10)).map((msg) => /* @__PURE__ */ React.createElement(ink.Box, { key: msg.id, flexDirection: "column", marginBottom: 1 }, /* @__PURE__ */ React.createElement(ink.Text, { color: getMessageColor(msg.type), dimColor: true }, formatMessage(msg))))
+    ))
+  ), /* @__PURE__ */ React.createElement(
+    ink.Box,
+    {
+      width: terminalWidth,
+      borderStyle: "round",
+      borderColor: actionInProgress ? "gray" : confirmationMode === "exit" ? "red" : confirmationMode === "switch" ? "yellow" : "green",
+      paddingX: 2,
+      justifyContent: "center",
+      alignItems: "center",
+      flexDirection: "column"
+    },
+    /* @__PURE__ */ React.createElement(ink.Box, { flexDirection: "column", alignItems: "center" }, actionInProgress === "exiting" ? /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", bold: true }, "Exiting...") : actionInProgress === "switching" ? /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", bold: true }, "Switching to local mode...") : confirmationMode === "exit" ? /* @__PURE__ */ React.createElement(ink.Text, { color: "red", bold: true }, "\u26A0\uFE0F  Press Ctrl-C again to exit completely") : confirmationMode === "switch" ? /* @__PURE__ */ React.createElement(ink.Text, { color: "yellow", bold: true }, "\u23F8\uFE0F  Press space again to switch to local mode") : /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(ink.Text, { color: "green", bold: true }, "\u{1F4F1} Press space to switch to local mode \u2022 Ctrl-C to exit")), process.env.DEBUG && logPath && /* @__PURE__ */ React.createElement(ink.Text, { color: "gray", dimColor: true }, "Debug logs: ", logPath))
+  ));
+};
+
+function getClaudeSettingsPath() {
+  const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), ".claude");
+  return path.join(claudeConfigDir, "settings.json");
+}
+function readClaudeSettings() {
+  try {
+    const settingsPath = getClaudeSettingsPath();
+    if (!fs$1.existsSync(settingsPath)) {
+      api.logger.debug(`[ClaudeSettings] No Claude settings file found at ${settingsPath}`);
+      return null;
+    }
+    const settingsContent = fs$1.readFileSync(settingsPath, "utf-8");
+    const settings = JSON.parse(settingsContent);
+    api.logger.debug(`[ClaudeSettings] Successfully read Claude settings from ${settingsPath}`);
+    api.logger.debug(`[ClaudeSettings] includeCoAuthoredBy: ${settings.includeCoAuthoredBy}`);
+    return settings;
+  } catch (error) {
+    api.logger.debug(`[ClaudeSettings] Error reading Claude settings: ${error}`);
+    return null;
+  }
+}
+function shouldIncludeCoAuthoredBy() {
+  const settings = readClaudeSettings();
+  if (!settings || settings.includeCoAuthoredBy === void 0) {
+    return true;
+  }
+  return settings.includeCoAuthoredBy;
+}
+
+const BASE_SYSTEM_PROMPT = (() => index.trimIdent(`
+    Help human.
+`))();
+const CO_AUTHORED_CREDITS = (() => index.trimIdent(`
+    When making commit messages, instead of just giving co-credit to Claude, also give credit to Happy like so:
+
+    <main commit message>
+
+    Generated with [Claude Code](https://claude.ai/code)
+    via [Happy](https://happy.engineering)
+
+    Co-Authored-By: Claude <noreply@anthropic.com>
+    Co-Authored-By: Happy <yesreply@happy.engineering>
+`))();
+const systemPrompt = (() => {
+  const includeCoAuthored = shouldIncludeCoAuthoredBy();
+  if (includeCoAuthored) {
+    return BASE_SYSTEM_PROMPT + "\n\n" + CO_AUTHORED_CREDITS;
+  } else {
+    return BASE_SYSTEM_PROMPT;
+  }
+})();
+
+function getToolDescriptor(toolName) {
+  if (toolName === "exit_plan_mode" || toolName === "ExitPlanMode") {
+    return { edit: false, exitPlan: true };
+  }
+  if (toolName === "Edit" || toolName === "MultiEdit" || toolName === "Write" || toolName === "NotebookEdit") {
+    return { edit: true, exitPlan: false };
+  }
+  return { edit: false, exitPlan: false };
+}
+
+class ClaudeAcpPermissionHandler extends registerKillSessionHandler.BasePermissionHandler {
+  currentPermissionMode = "default";
+  constructor(session) {
+    super(session);
+  }
+  getLogPrefix() {
+    return "[ClaudeACP]";
+  }
+  setPermissionMode(mode) {
+    this.currentPermissionMode = mode;
+    api.logger.debug(`${this.getLogPrefix()} Permission mode set to: ${mode}`);
+  }
+  shouldAutoApprove(toolName) {
+    const descriptor = getToolDescriptor(toolName);
+    switch (this.currentPermissionMode) {
+      case "bypassPermissions":
+      case "yolo":
+        return true;
+      case "acceptEdits":
+        return descriptor.edit;
+      default:
+        return false;
+    }
+  }
+  async handleToolCall(toolCallId, toolName, input) {
+    if (this.shouldAutoApprove(toolName)) {
+      const decision = this.currentPermissionMode === "bypassPermissions" || this.currentPermissionMode === "yolo" ? "approved_for_session" : "approved";
+      this.session.updateAgentState((currentState) => ({
+        ...currentState,
+        completedRequests: {
+          ...currentState.completedRequests,
+          [toolCallId]: {
+            tool: toolName,
+            arguments: input,
+            createdAt: Date.now(),
+            completedAt: Date.now(),
+            status: "approved",
+            decision
+          }
+        }
+      }));
+      api.logger.debug(`${this.getLogPrefix()} Auto-approved tool ${toolName} (${toolCallId}) in ${this.currentPermissionMode} mode`);
+      return { decision };
+    }
+    return this.registerPendingRequest(
+      toolCallId,
+      toolName,
+      input,
+      ` in ${this.currentPermissionMode} mode`
+    );
+  }
+}
+
+function normalizeClaudeBackendError(error) {
+  const record = typeof error === "object" && error !== null ? error : null;
+  const text = index.formatDisplayMessage(error).trim();
+  const stderrText = record ? index.formatDisplayMessage(record.stderr).trim() : "";
+  const detailText = record ? index.formatDisplayMessage(record.detail).trim() : "";
+  const searchable = [text, stderrText, detailText].filter(Boolean).join("\n").trim();
+  return searchable || "Claude ACP backend exited unexpectedly";
+}
+async function claudeAcpRemoteLauncher(session) {
+  const hasTTY = process.stdout.isTTY && process.stdin.isTTY;
+  const messageBuffer = new registerKillSessionHandler.MessageBuffer({ enabled: hasTTY });
+  let inkInstance = null;
+  let shouldExit = false;
+  let abortController = new AbortController();
+  let runtimeHandle = null;
+  let unsubscribeRuntimeMessages = null;
+  let currentModeHash = null;
+  let pending = null;
+  let accumulatedResponse = "";
+  let isResponseInProgress = false;
+  let taskStartedSent = false;
+  let currentAssistantMessageId = null;
+  let currentThinkingMessageId = null;
+  let shouldInjectHistoryOnNextSession = false;
+  let readyAlreadySent = false;
+  const permissionHandler = new ClaudeAcpPermissionHandler(session.client);
+  const selectionHandler = new ProviderSelectionHandler.ProviderSelectionHandler(session.client, "Claude");
+  const conversationHistory = new registerKillSessionHandler.ConversationHistory({
+    maxMessages: 20,
+    maxCharacters: 5e4
+  });
+  const rotateAbortController = () => {
+    const activeController = abortController;
+    abortController = new AbortController();
+    return activeController;
+  };
+  const sendReady = () => {
+    session.client.sendSessionEvent({ type: "ready" });
+    try {
+      session.api.push().sendToAllDevices(
+        "It's ready!",
+        "Claude is waiting for your command",
+        { sessionId: session.client.sessionId }
+      );
+    } catch (pushError) {
+      api.logger.debug("[ClaudeACP] Failed to send ready push", pushError);
+    }
+  };
+  const emitStatusMessage = (message) => {
+    messageBuffer.addMessage(message, "status");
+    session.client.sendSessionEvent({ type: "message", message });
+  };
+  const emitUserVisibleErrorMessage = (message) => {
+    emitStatusMessage(message);
+    session.client.sendAgentMessage("claude", {
+      type: "message",
+      message
+    });
+  };
+  const resetTurnState = () => {
+    accumulatedResponse = "";
+    isResponseInProgress = false;
+    taskStartedSent = false;
+    currentAssistantMessageId = null;
+    currentThinkingMessageId = null;
+    session.onThinkingChange(false);
+  };
+  const emitFinalAssistantMessage = () => {
+    const finalMessage = accumulatedResponse.trim();
+    if (!finalMessage) {
+      accumulatedResponse = "";
+      isResponseInProgress = false;
+      return;
+    }
+    conversationHistory.addAssistantMessage(finalMessage);
+    session.client.sendAgentMessage("claude", {
+      type: "message",
+      message: finalMessage
+    });
+    accumulatedResponse = "";
+    isResponseInProgress = false;
+  };
+  const disposeRuntimeHandle = async () => {
+    if (!runtimeHandle) {
+      return;
+    }
+    const activeHandle = runtimeHandle;
+    runtimeHandle = null;
+    unsubscribeRuntimeMessages?.();
+    unsubscribeRuntimeMessages = null;
+    try {
+      await activeHandle.dispose();
+    } catch (error) {
+      api.logger.debug("[ClaudeACP] Error disposing runtime handle:", error);
+    }
+  };
+  const queueHistoryInjectionForRestart = (reason) => {
+    messageBuffer.addMessage("\u2550".repeat(40), "status");
+    if (conversationHistory.hasHistory()) {
+      shouldInjectHistoryOnNextSession = true;
+      const message = `${reason} Preserving ${conversationHistory.size()} earlier messages of context.`;
+      emitStatusMessage(message);
+      api.logger.debug(`[ClaudeACP] Will inject conversation history after restart: ${conversationHistory.getSummary()}`);
+      return;
+    }
+    emitStatusMessage(reason);
+  };
+  const setupRuntimeMessageHandler = (activeRuntimeHandle) => {
+    const forwardAgentMessage = (agentMessage) => {
+      registerKillSessionHandler.forwardAgentMessageToProviderSession(agentMessage, {
+        provider: "claude",
+        send: (body) => session.client.sendAgentMessage("claude", body)
+      });
+    };
+    unsubscribeRuntimeMessages?.();
+    unsubscribeRuntimeMessages = activeRuntimeHandle.onMessage((msg) => {
+      switch (msg.type) {
+        case "model-output": {
+          const text = msg.textDelta ?? msg.fullText ?? "";
+          if (!text) {
+            return;
+          }
+          if (!isResponseInProgress) {
+            if (currentThinkingMessageId) {
+              messageBuffer.removeMessage(currentThinkingMessageId);
+              currentThinkingMessageId = null;
+            }
+            currentAssistantMessageId = messageBuffer.addMessage(text, "assistant");
+            isResponseInProgress = true;
+          } else if (currentAssistantMessageId) {
+            const updated = messageBuffer.updateMessage(currentAssistantMessageId, text);
+            if (!updated) {
+              currentAssistantMessageId = messageBuffer.addMessage(text, "assistant");
+            }
+          }
+          accumulatedResponse += text;
+          return;
+        }
+        case "status": {
+          if (msg.status === "running") {
+            session.onThinkingChange(true);
+            if (!taskStartedSent) {
+              session.client.sendAgentMessage("claude", {
+                type: "task_started",
+                id: node_crypto.randomUUID()
+              });
+              taskStartedSent = true;
+            }
+            if (!isResponseInProgress && !currentThinkingMessageId) {
+              currentThinkingMessageId = messageBuffer.addMessage("Thinking...", "system");
+            }
+            return;
+          }
+          if (msg.status === "idle" || msg.status === "stopped") {
+            session.onThinkingChange(false);
+            return;
+          }
+          if (msg.status === "error") {
+            messageBuffer.addMessage(`Error: ${normalizeClaudeBackendError(msg.detail)}`, "status");
+          }
+          return;
+        }
+        case "tool-call": {
+          const toolArgs = index.truncateDisplayMessage(msg.args, 100);
+          messageBuffer.addMessage(
+            `Executing: ${msg.toolName}${toolArgs ? ` ${toolArgs}` : ""}`,
+            "tool"
+          );
+          forwardAgentMessage(msg);
+          return;
+        }
+        case "tool-result": {
+          const resultText = index.truncateDisplayMessage(msg.result, 200);
+          messageBuffer.addMessage(resultText ? `Result: ${resultText}` : "Tool completed", "result");
+          forwardAgentMessage(msg);
+          return;
+        }
+        case "fs-edit": {
+          messageBuffer.addMessage(`File edit: ${msg.description}`, "tool");
+          forwardAgentMessage(msg);
+          return;
+        }
+        case "terminal-output": {
+          const output = index.formatDisplayMessage(msg.data);
+          messageBuffer.addMessage(output, "result");
+          forwardAgentMessage({
+            ...msg,
+            data: output
+          });
+          return;
+        }
+        case "permission-request": {
+          forwardAgentMessage(msg);
+          return;
+        }
+        case "token-count": {
+          forwardAgentMessage(msg);
+          return;
+        }
+        case "exec-approval-request":
+        case "patch-apply-begin":
+        case "patch-apply-end": {
+          forwardAgentMessage(msg);
+          return;
+        }
+        case "event": {
+          if (msg.name === "thinking") {
+            const payload = msg.payload;
+            const thinkingText = typeof payload?.text === "string" ? payload.text : "";
+            if (thinkingText) {
+              session.client.sendAgentMessage("claude", {
+                type: "thinking",
+                text: thinkingText
+              });
+              if (!isResponseInProgress) {
+                const preview = `[Thinking] ${thinkingText.substring(0, 100)}...`;
+                if (currentThinkingMessageId) {
+                  messageBuffer.updateMessage(currentThinkingMessageId, preview, { mode: "replace" });
+                } else {
+                  currentThinkingMessageId = messageBuffer.addMessage(preview, "system");
+                }
+              }
+            }
+          }
+          return;
+        }
+        default:
+          return;
+      }
+    });
+  };
+  const createRuntimeHandle = async (mode) => {
+    const { session: nextRuntimeHandle, factoryResult } = await registerKillSessionHandler.launchRuntimeHandleWithFactoryResult({
+      provider: "claude",
+      cwd: session.path,
+      createBackendResult: (opts) => index.createClaudeBackend({
+        ...opts,
+        baseArgs: session.claudeArgs,
+        mcpServers: session.mcpServers,
+        permissionHandler,
+        selectionHandler: {
+          handleSelection: (request) => selectionHandler.requestSelection(request)
+        },
+        permissionMode: mode.permissionMode,
+        model: mode.model,
+        fallbackModel: mode.fallbackModel,
+        customSystemPrompt: mode.customSystemPrompt ? `${mode.customSystemPrompt}
+
+${systemPrompt}` : void 0,
+        appendSystemPrompt: mode.appendSystemPrompt ? `${mode.appendSystemPrompt}
+
+${systemPrompt}` : systemPrompt,
+        allowedTools: mode.allowedTools ? mode.allowedTools.concat(session.allowedTools ?? []) : session.allowedTools,
+        disallowedTools: mode.disallowedTools,
+        settingsPath: session.hookSettingsPath
+      })
+    });
+    api.logger.debug("[ClaudeACP] Started Claude ACP backend", {
+      command: factoryResult.command,
+      args: factoryResult.args
+    });
+    runtimeHandle = nextRuntimeHandle;
+    setupRuntimeMessageHandler(nextRuntimeHandle);
+    session.consumeOneTimeFlags();
+    return nextRuntimeHandle;
+  };
+  const abortActiveTurn = async () => {
+    const activeController = rotateAbortController();
+    activeController.abort();
+    session.onThinkingChange(false);
+    if (runtimeHandle) {
+      await runtimeHandle.cancel().catch((error) => {
+        api.logger.debug("[ClaudeACP] Error cancelling runtime handle:", error);
+      });
+    }
+  };
+  const completeSyntheticTurn = () => {
+    session.client.sendAgentMessage("claude", {
+      type: "task_complete",
+      id: node_crypto.randomUUID()
+    });
+  };
+  const handleClearCommand = async () => {
+    api.logger.debug("[ClaudeACP] /clear command received - resetting runtime and local history");
+    conversationHistory.clear();
+    shouldInjectHistoryOnNextSession = false;
+    await disposeRuntimeHandle();
+    session.clearSessionId();
+    currentModeHash = null;
+    permissionHandler.reset();
+    selectionHandler.reset();
+    resetTurnState();
+    emitStatusMessage("Context was reset");
+    completeSyntheticTurn();
+  };
+  const handleSwitchToLocal = async () => {
+    const message = "Daemon-spawned Claude ACP sessions stay in remote mode.";
+    api.logger.debug("[ClaudeACP] Ignoring switch request because daemon sessions are remote-only");
+    emitStatusMessage(message);
+  };
+  const handleAbort = async () => {
+    api.logger.debug("[ClaudeACP] Abort requested - stopping current task");
+    await abortActiveTurn();
+  };
+  if (hasTTY) {
+    console.clear();
+    inkInstance = ink.render(React.createElement(RemoteModeDisplay, {
+      messageBuffer,
+      logPath: process.env.DEBUG ? session.logPath : void 0,
+      onExit: async () => {
+        shouldExit = true;
+        await handleAbort();
+      },
+      onSwitchToLocal: () => {
+        void handleSwitchToLocal();
+      }
+    }), {
+      exitOnCtrlC: false,
+      patchConsole: false
+    });
+  }
+  if (hasTTY) {
+    process.stdin.resume();
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+    }
+    process.stdin.setEncoding("utf8");
+  }
+  session.client.rpcHandlerManager.registerHandler("abort", handleAbort);
+  session.client.rpcHandlerManager.registerHandler("switch", handleSwitchToLocal);
+  try {
+    while (!shouldExit) {
+      let message = pending;
+      pending = null;
+      if (!message) {
+        const waitSignal = abortController.signal;
+        const batch = await session.queue.waitForMessagesAndGetAsString(waitSignal);
+        if (!batch) {
+          if (waitSignal.aborted && !shouldExit) {
+            continue;
+          }
+          break;
+        }
+        message = batch;
+      }
+      if (!message) {
+        break;
+      }
+      if (runtimeHandle && currentModeHash && message.hash !== currentModeHash) {
+        queueHistoryInjectionForRestart("Starting new Claude ACP session (execution settings changed)...");
+        await disposeRuntimeHandle();
+        session.clearSessionId();
+        currentModeHash = null;
+        pending = message;
+        permissionHandler.reset();
+        selectionHandler.reset();
+        resetTurnState();
+        continue;
+      }
+      currentModeHash = message.hash;
+      readyAlreadySent = false;
+      const specialCommand = parseSpecialCommand(message.message);
+      if (specialCommand.type === "clear") {
+        await handleClearCommand();
+        if (!shouldExit && !pending && session.queue.size() === 0 && !readyAlreadySent) {
+          sendReady();
+          readyAlreadySent = true;
+        }
+        continue;
+      }
+      permissionHandler.setPermissionMode(message.mode.permissionMode);
+      messageBuffer.addMessage(message.message, "user");
+      let shouldClearHistoryAfterTurn = false;
+      try {
+        const activeRuntimeHandle = runtimeHandle ?? await createRuntimeHandle(message.mode);
+        let promptToSend = message.message;
+        if (shouldInjectHistoryOnNextSession && conversationHistory.hasHistory()) {
+          const historyContext = conversationHistory.getContextForNewSession(
+            "Continue from the prior Claude ACP session using the conversation below as context."
+          );
+          promptToSend = historyContext + promptToSend;
+          api.logger.debug(`[ClaudeACP] Injected conversation history context (${historyContext.length} chars)`);
+        }
+        if (specialCommand.type === "compact") {
+          emitStatusMessage("Compaction started");
+        }
+        conversationHistory.addUserMessage(message.message);
+        await activeRuntimeHandle.sendPrompt(promptToSend);
+        await registerKillSessionHandler.waitForResponseCompleteWithAbort(activeRuntimeHandle.backend, abortController.signal);
+        shouldInjectHistoryOnNextSession = false;
+        shouldClearHistoryAfterTurn = specialCommand.type === "compact";
+      } catch (error) {
+        api.logger.warn("[ClaudeACP] Error in Claude ACP session:", error);
+        const isAbortError = error instanceof Error && error.name === "AbortError";
+        const isExpectedInterruption = isAbortError || abortController.signal.aborted || shouldExit;
+        if (isExpectedInterruption) {
+          session.client.sendAgentMessage("claude", {
+            type: "turn_aborted",
+            id: node_crypto.randomUUID()
+          });
+          emitStatusMessage("Aborted by user");
+        } else {
+          const errorMessage = normalizeClaudeBackendError(error);
+          emitUserVisibleErrorMessage(errorMessage);
+          if (conversationHistory.hasHistory()) {
+            shouldInjectHistoryOnNextSession = true;
+          }
+          await disposeRuntimeHandle();
+          session.clearSessionId();
+          currentModeHash = null;
+        }
+      } finally {
+        emitFinalAssistantMessage();
+        if (shouldClearHistoryAfterTurn) {
+          conversationHistory.clear();
+          emitStatusMessage("Compaction completed");
+        }
+        if (!shouldExit) {
+          session.client.sendAgentMessage("claude", {
+            type: "task_complete",
+            id: node_crypto.randomUUID()
+          });
+        }
+        permissionHandler.reset();
+        selectionHandler.reset();
+        resetTurnState();
+        if (!shouldExit && !pending && session.queue.size() === 0 && !readyAlreadySent) {
+          sendReady();
+          readyAlreadySent = true;
+        }
+      }
+    }
+  } finally {
+    await disposeRuntimeHandle();
+    permissionHandler.reset();
+    selectionHandler.reset();
+    if (process.stdin.isTTY) {
+      try {
+        process.stdin.setRawMode(false);
+      } catch {
+      }
+    }
+    if (hasTTY) {
+      try {
+        process.stdin.pause();
+      } catch {
+      }
+    }
+    session.client.rpcHandlerManager.registerHandler("abort", async () => {
+    });
+    session.client.rpcHandlerManager.registerHandler("switch", async () => {
+    });
+    if (inkInstance) {
+      inkInstance.unmount();
+    }
+    messageBuffer.clear();
+  }
+  api.logger.debug("[ClaudeACP] Remote launcher returning: exit");
+  return "exit";
+}
 
 class Stream {
   constructor(returned) {
@@ -937,7 +1560,7 @@ class AbortError extends Error {
   }
 }
 
-const __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('runClaude-C1W_Nw0C.cjs', document.baseURI).href)));
+const __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('runClaude-BMHlBny_.cjs', document.baseURI).href)));
 const __dirname$1 = path.join(__filename$1, "..");
 function getGlobalClaudeVersion() {
   try {
@@ -1365,59 +1988,6 @@ function query(config) {
   return query2;
 }
 
-function mapToClaudeMode(mode) {
-  const codexToClaudeMap = {
-    "yolo": "bypassPermissions",
-    "safe-yolo": "default",
-    "read-only": "default"
-  };
-  return codexToClaudeMap[mode] ?? mode;
-}
-
-function parseCompact(message) {
-  const trimmed = message.trim();
-  if (trimmed === "/compact") {
-    return {
-      isCompact: true,
-      originalMessage: trimmed
-    };
-  }
-  if (trimmed.startsWith("/compact ")) {
-    return {
-      isCompact: true,
-      originalMessage: trimmed
-    };
-  }
-  return {
-    isCompact: false,
-    originalMessage: message
-  };
-}
-function parseClear(message) {
-  const trimmed = message.trim();
-  return {
-    isClear: trimmed === "/clear"
-  };
-}
-function parseSpecialCommand(message) {
-  const compactResult = parseCompact(message);
-  if (compactResult.isCompact) {
-    return {
-      type: "compact",
-      originalMessage: compactResult.originalMessage
-    };
-  }
-  const clearResult = parseClear(message);
-  if (clearResult.isClear) {
-    return {
-      type: "clear"
-    };
-  }
-  return {
-    type: null
-  };
-}
-
 class PushableAsyncIterable {
   queue = [];
   waiters = [];
@@ -1557,58 +2127,6 @@ async function awaitFileExist(file, timeout = 1e4) {
   return false;
 }
 
-function getClaudeSettingsPath() {
-  const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), ".claude");
-  return path.join(claudeConfigDir, "settings.json");
-}
-function readClaudeSettings() {
-  try {
-    const settingsPath = getClaudeSettingsPath();
-    if (!fs$1.existsSync(settingsPath)) {
-      api.logger.debug(`[ClaudeSettings] No Claude settings file found at ${settingsPath}`);
-      return null;
-    }
-    const settingsContent = fs$1.readFileSync(settingsPath, "utf-8");
-    const settings = JSON.parse(settingsContent);
-    api.logger.debug(`[ClaudeSettings] Successfully read Claude settings from ${settingsPath}`);
-    api.logger.debug(`[ClaudeSettings] includeCoAuthoredBy: ${settings.includeCoAuthoredBy}`);
-    return settings;
-  } catch (error) {
-    api.logger.debug(`[ClaudeSettings] Error reading Claude settings: ${error}`);
-    return null;
-  }
-}
-function shouldIncludeCoAuthoredBy() {
-  const settings = readClaudeSettings();
-  if (!settings || settings.includeCoAuthoredBy === void 0) {
-    return true;
-  }
-  return settings.includeCoAuthoredBy;
-}
-
-const BASE_SYSTEM_PROMPT = (() => index.trimIdent(`
-    Help human.
-`))();
-const CO_AUTHORED_CREDITS = (() => index.trimIdent(`
-    When making commit messages, instead of just giving co-credit to Claude, also give credit to Happy like so:
-
-    <main commit message>
-
-    Generated with [Claude Code](https://claude.ai/code)
-    via [Happy](https://happy.engineering)
-
-    Co-Authored-By: Claude <noreply@anthropic.com>
-    Co-Authored-By: Happy <yesreply@happy.engineering>
-`))();
-const systemPrompt = (() => {
-  const includeCoAuthored = shouldIncludeCoAuthoredBy();
-  if (includeCoAuthored) {
-    return BASE_SYSTEM_PROMPT + "\n\n" + CO_AUTHORED_CREDITS;
-  } else {
-    return BASE_SYSTEM_PROMPT;
-  }
-})();
-
 async function claudeRemote(opts) {
   let startFrom = opts.sessionId;
   if (opts.sessionId && !index.claudeCheckSession(opts.sessionId, opts.path, opts.transcriptPath)) {
@@ -1666,7 +2184,7 @@ async function claudeRemote(opts) {
     cwd: opts.path,
     resume: startFrom ?? void 0,
     mcpServers: opts.mcpServers,
-    permissionMode: mapToClaudeMode(initial.mode.permissionMode),
+    permissionMode: index.mapToClaudeMode(initial.mode.permissionMode),
     model: initial.mode.model,
     fallbackModel: initial.mode.fallbackModel,
     customSystemPrompt: initial.mode.customSystemPrompt ? initial.mode.customSystemPrompt + "\n\n" + systemPrompt : void 0,
@@ -1812,16 +2330,6 @@ function getToolName(toolName) {
   return toTitleCase(toolName);
 }
 
-function getToolDescriptor(toolName) {
-  if (toolName === "exit_plan_mode" || toolName === "ExitPlanMode") {
-    return { edit: false, exitPlan: true };
-  }
-  if (toolName === "Edit" || toolName === "MultiEdit" || toolName === "Write" || toolName === "NotebookEdit") {
-    return { edit: true, exitPlan: false };
-  }
-  return { edit: false, exitPlan: false };
-}
-
 class PermissionHandler {
   toolCalls = [];
   responses = /* @__PURE__ */ new Map();
@@ -2963,36 +3471,31 @@ async function loop(opts) {
     jsRuntime: opts.jsRuntime
   });
   opts.onSessionReady?.(session);
-  let mode = opts.startingMode ?? "local";
-  while (true) {
-    api.logger.debug(`[loop] Iteration with mode: ${mode}`);
-    switch (mode) {
-      case "local": {
+  return await ProviderSelectionHandler.runModeLoop({
+    startingMode: opts.startingMode ?? "local",
+    onIteration: (mode) => {
+      api.logger.debug(`[loop] Iteration with mode: ${mode}`);
+    },
+    onModeChange: async (mode) => {
+      await opts.onModeChange(mode);
+    },
+    launchers: {
+      local: async () => {
         const result = await claudeLocalLauncher(session);
-        switch (result.type) {
-          case "switch":
-            mode = "remote";
-            opts.onModeChange?.(mode);
-            break;
-          case "exit":
-            return result.code;
+        if (result.type === "switch") {
+          return { type: "switch", mode: "remote" };
         }
-        break;
-      }
-      case "remote": {
-        const reason = await claudeRemoteLauncher(session);
-        switch (reason) {
-          case "exit":
-            return 0;
-          case "switch":
-            mode = "local";
-            opts.onModeChange?.(mode);
-            break;
+        return { type: "exit", value: result.code };
+      },
+      remote: async () => {
+        const reason = opts.startedBy === "daemon" ? await claudeAcpRemoteLauncher(session) : await claudeRemoteLauncher(session);
+        if (reason === "switch") {
+          return { type: "switch", mode: "local" };
         }
-        break;
+        return { type: "exit", value: 0 };
       }
     }
-  }
+  });
 }
 
 async function extractSDKMetadata() {
@@ -3151,6 +3654,143 @@ function cleanupHookSettingsFile(filepath) {
   }
 }
 
+async function runOfflineClaudeLocalFallback(opts) {
+  let offlineSessionId = null;
+  const reconnection = api.startOfflineReconnection({
+    serverUrl: api.configuration.serverUrl,
+    onReconnected: async () => {
+      const response = await opts.api.getOrCreateSession({
+        tag: node_crypto.randomUUID(),
+        metadata: opts.metadata,
+        state: opts.state
+      });
+      if (!response) {
+        throw new Error("Server unavailable");
+      }
+      await index.publishSessionRegistration(response.id, opts.metadata);
+      const session = opts.api.sessionSyncClient(response);
+      await registerKillSessionHandler.syncControlledByUserState(session, true);
+      const scanner = await createSessionScanner({
+        sessionId: null,
+        workingDirectory: opts.workingDirectory,
+        onMessage: (message) => session.sendClaudeSessionMessage(message)
+      });
+      if (offlineSessionId) {
+        scanner.onNewSession(offlineSessionId);
+      }
+      return { session, scanner };
+    },
+    onNotify: console.log,
+    onCleanup: () => {
+      api.logger.debug("[claude] Offline reconnection cleanup triggered");
+    }
+  });
+  try {
+    await index.claudeLocal({
+      path: opts.workingDirectory,
+      sessionId: null,
+      onSessionFound: (sessionId) => {
+        offlineSessionId = sessionId;
+      },
+      onThinkingChange: () => {
+      },
+      abort: new AbortController().signal,
+      claudeEnvVars: opts.claudeEnvVars,
+      claudeArgs: opts.claudeArgs,
+      allowedTools: []
+    });
+  } finally {
+    reconnection.cancel();
+    index.stopCaffeinate();
+  }
+}
+
+function hasMetaOverride(message, key) {
+  return Object.prototype.hasOwnProperty.call(message.meta ?? {}, key);
+}
+function resolveNullableStringOverride(message, key, currentValue) {
+  if (!hasMetaOverride(message, key)) {
+    return currentValue;
+  }
+  return message.meta?.[key] || void 0;
+}
+function resolveNullableArrayOverride(message, key, currentValue) {
+  if (!hasMetaOverride(message, key)) {
+    return currentValue;
+  }
+  return message.meta?.[key] || void 0;
+}
+function resolveClaudeQueuedMessage(message, currentState) {
+  const permissionMode = message.meta?.permissionMode ?? currentState.permissionMode;
+  const model = resolveNullableStringOverride(message, "model", currentState.model);
+  const fallbackModel = resolveNullableStringOverride(message, "fallbackModel", currentState.fallbackModel);
+  const customSystemPrompt = resolveNullableStringOverride(
+    message,
+    "customSystemPrompt",
+    currentState.customSystemPrompt
+  );
+  const appendSystemPrompt = resolveNullableStringOverride(
+    message,
+    "appendSystemPrompt",
+    currentState.appendSystemPrompt
+  );
+  const allowedTools = resolveNullableArrayOverride(message, "allowedTools", currentState.allowedTools);
+  const disallowedTools = resolveNullableArrayOverride(message, "disallowedTools", currentState.disallowedTools);
+  const mode = {
+    permissionMode: permissionMode || "default",
+    model,
+    fallbackModel,
+    customSystemPrompt,
+    appendSystemPrompt,
+    allowedTools,
+    disallowedTools
+  };
+  const specialCommand = parseSpecialCommand(message.content.text);
+  const nextState = {
+    permissionMode,
+    model,
+    fallbackModel,
+    customSystemPrompt,
+    appendSystemPrompt,
+    allowedTools,
+    disallowedTools
+  };
+  if (specialCommand.type === "compact" || specialCommand.type === "clear") {
+    return {
+      nextState,
+      queuedMessage: {
+        text: specialCommand.originalMessage || message.content.text,
+        mode,
+        isolate: true,
+        specialCommand: specialCommand.type
+      }
+    };
+  }
+  return {
+    nextState,
+    queuedMessage: {
+      text: message.content.text,
+      mode,
+      isolate: false,
+      specialCommand: null
+    }
+  };
+}
+function bindClaudeUserMessageQueue(opts) {
+  let currentState = { ...opts.initialState };
+  opts.session.onUserMessage((message) => {
+    const { nextState, queuedMessage } = resolveClaudeQueuedMessage(message, currentState);
+    currentState = nextState;
+    if (queuedMessage.isolate) {
+      api.logger.debug(`[claude] Queuing isolated special command: ${queuedMessage.specialCommand}`);
+      opts.messageQueue.pushIsolateAndClear(queuedMessage.text, queuedMessage.mode);
+    } else {
+      opts.messageQueue.push(queuedMessage.text, queuedMessage.mode);
+    }
+    api.logger.debugLargeJson("[claude] User message queued:", message);
+  });
+}
+
 async function runClaude(credentials, options = {}) {
   api.logger.debug(`[CLAUDE] ===== CLAUDE MODE STARTING =====`);
   api.logger.debug(`[CLAUDE] This is the Claude agent, NOT Gemini`);
@@ -3163,36 +3803,25 @@ async function runClaude(credentials, options = {}) {
   }
   api.connectionState.setBackend("Claude");
   const api$1 = await api.ApiClient.create(credentials);
-  let state = {};
-  const settings = await persistence.readSettings();
-  let machineId = settings?.machineId;
-  if (!machineId) {
-    console.error(`[START] No machine ID found in settings, which is unexpected since authAndSetupMachineIfNeeded should have created it. Please report this issue on https://github.com/slopus/happy-cli/issues`);
-    process.exit(1);
+  let machineId;
+  try {
+    machineId = await registerKillSessionHandler.ensureManagedProviderMachine({
+      api: api$1,
+      missingMachineIdMessage: "[START] No machine ID found in settings, which is unexpected since authAndSetupMachineIfNeeded should have created it. Please report this issue on https://github.com/slopus/happy-cli/issues"
+    });
+  } catch (error) {
+    if (error instanceof registerKillSessionHandler.MissingMachineIdError) {
+      console.error(error.message);
+      process.exit(1);
+    }
+    throw error;
   }
   api.logger.debug(`Using machineId: ${machineId}`);
-  await api$1.getOrCreateMachine({
+  const { state, metadata } = registerKillSessionHandler.createSessionMetadata({
+    flavor: "claude",
     machineId,
-    metadata: index.initialMachineMetadata
+    startedBy: options.startedBy
   });
-  let metadata = {
-    path: workingDirectory,
-    host: os.hostname(),
-    version: api.packageJson.version,
-    os: os.platform(),
-    machineId,
-    homeDir: os.homedir(),
-    happyHomeDir: api.configuration.happyCloudHomeDir,
-    happyLibDir: index.projectPath(),
-    happyToolsDir: path.resolve(index.projectPath(), "tools", "unpacked"),
-    startedFromDaemon: options.startedBy === "daemon",
-    hostPid: process.pid,
-    startedBy: options.startedBy || "terminal",
-    // Initialize lifecycle state
-    lifecycleState: "running",
-    lifecycleStateSince: Date.now(),
-    flavor: "claude"
-  };
   let response = null;
   try {
     response = await api$1.getOrCreateSession({ tag: sessionTag, metadata, state });
@@ -3203,44 +3832,14 @@ async function runClaude(credentials, options = {}) {
     api.logger.debug("[START] Falling back to local/offline mode after authentication failure");
   }
   if (!response) {
-    let offlineSessionId = null;
-    const reconnection = api.startOfflineReconnection({
-      serverUrl: api.configuration.serverUrl,
-      onReconnected: async () => {
-        const resp = await api$1.getOrCreateSession({ tag: node_crypto.randomUUID(), metadata, state });
-        if (!resp) throw new Error("Server unavailable");
-        await index.publishSessionRegistration(resp.id, metadata);
-        const session2 = api$1.sessionSyncClient(resp);
-        const scanner = await createSessionScanner({
-          sessionId: null,
-          workingDirectory,
-          onMessage: (msg) => session2.sendClaudeSessionMessage(msg)
-        });
-        if (offlineSessionId) scanner.onNewSession(offlineSessionId);
-        return { session: session2, scanner };
-      },
-      onNotify: console.log,
-      onCleanup: () => {
-      }
+    await runOfflineClaudeLocalFallback({
+      api: api$1,
+      metadata,
+      state,
+      workingDirectory,
+      claudeEnvVars: options.claudeEnvVars,
+      claudeArgs: options.claudeArgs
     });
-    try {
-      await index.claudeLocal({
-        path: workingDirectory,
-        sessionId: null,
-        onSessionFound: (id) => {
-          offlineSessionId = id;
-        },
-        onThinkingChange: () => {
-        },
-        abort: new AbortController().signal,
-        claudeEnvVars: options.claudeEnvVars,
-        claudeArgs: options.claudeArgs,
-        allowedTools: []
-      });
-    } finally {
-      reconnection.cancel();
-      index.stopCaffeinate();
-    }
     process.exit(0);
   }
   api.logger.debug(`Session created: ${response.id}`);
@@ -3274,10 +3873,7 @@ async function runClaude(credentials, options = {}) {
   const logPath = api.logger.logFilePath;
   api.logger.infoDeveloper(`Session: ${response.id}`);
   api.logger.infoDeveloper(`Logs: ${logPath}`);
-  session.updateAgentState((currentState) => ({
-    ...currentState,
-    controlledByUser: options.startingMode !== "remote"
-  }));
+  await registerKillSessionHandler.syncControlledByUserState(session, options.startingMode !== "remote");
   const caffeinateStarted = index.startCaffeinate();
   if (caffeinateStarted) {
     api.logger.infoDeveloper("Sleep prevention enabled (macOS)");
@@ -3291,128 +3887,22 @@ async function runClaude(credentials, options = {}) {
     allowedTools: mode.allowedTools,
     disallowedTools: mode.disallowedTools
   }));
-  let currentPermissionMode = options.permissionMode;
-  let currentModel = options.model;
-  let currentFallbackModel = void 0;
-  let currentCustomSystemPrompt = void 0;
-  let currentAppendSystemPrompt = void 0;
-  let currentAllowedTools = void 0;
-  let currentDisallowedTools = void 0;
-  session.onUserMessage((message) => {
-    let messagePermissionMode = currentPermissionMode;
-    if (message.meta?.permissionMode) {
-      messagePermissionMode = message.meta.permissionMode;
-      currentPermissionMode = messagePermissionMode;
-      api.logger.debug(`[loop] Permission mode updated from user message to: ${currentPermissionMode}`);
-    } else {
-      api.logger.debug(`[loop] User message received with no permission mode override, using current: ${currentPermissionMode}`);
-    }
-    let messageModel = currentModel;
-    if (message.meta?.hasOwnProperty("model")) {
-      messageModel = message.meta.model || void 0;
-      currentModel = messageModel;
-      api.logger.debug(`[loop] Model updated from user message: ${messageModel || "reset to default"}`);
-    } else {
-      api.logger.debug(`[loop] User message received with no model override, using current: ${currentModel || "default"}`);
-    }
-    let messageCustomSystemPrompt = currentCustomSystemPrompt;
-    if (message.meta?.hasOwnProperty("customSystemPrompt")) {
-      messageCustomSystemPrompt = message.meta.customSystemPrompt || void 0;
-      currentCustomSystemPrompt = messageCustomSystemPrompt;
-      api.logger.debug(`[loop] Custom system prompt updated from user message: ${messageCustomSystemPrompt ? "set" : "reset to none"}`);
-    } else {
-      api.logger.debug(`[loop] User message received with no custom system prompt override, using current: ${currentCustomSystemPrompt ? "set" : "none"}`);
-    }
-    let messageFallbackModel = currentFallbackModel;
-    if (message.meta?.hasOwnProperty("fallbackModel")) {
-      messageFallbackModel = message.meta.fallbackModel || void 0;
-      currentFallbackModel = messageFallbackModel;
-      api.logger.debug(`[loop] Fallback model updated from user message: ${messageFallbackModel || "reset to none"}`);
-    } else {
-      api.logger.debug(`[loop] User message received with no fallback model override, using current: ${currentFallbackModel || "none"}`);
-    }
-    let messageAppendSystemPrompt = currentAppendSystemPrompt;
-    if (message.meta?.hasOwnProperty("appendSystemPrompt")) {
-      messageAppendSystemPrompt = message.meta.appendSystemPrompt || void 0;
-      currentAppendSystemPrompt = messageAppendSystemPrompt;
-      api.logger.debug(`[loop] Append system prompt updated from user message: ${messageAppendSystemPrompt ? "set" : "reset to none"}`);
-    } else {
-      api.logger.debug(`[loop] User message received with no append system prompt override, using current: ${currentAppendSystemPrompt ? "set" : "none"}`);
-    }
-    let messageAllowedTools = currentAllowedTools;
-    if (message.meta?.hasOwnProperty("allowedTools")) {
-      messageAllowedTools = message.meta.allowedTools || void 0;
-      currentAllowedTools = messageAllowedTools;
-      api.logger.debug(`[loop] Allowed tools updated from user message: ${messageAllowedTools ? messageAllowedTools.join(", ") : "reset to none"}`);
-    } else {
-      api.logger.debug(`[loop] User message received with no allowed tools override, using current: ${currentAllowedTools ? currentAllowedTools.join(", ") : "none"}`);
-    }
-    let messageDisallowedTools = currentDisallowedTools;
-    if (message.meta?.hasOwnProperty("disallowedTools")) {
-      messageDisallowedTools = message.meta.disallowedTools || void 0;
-      currentDisallowedTools = messageDisallowedTools;
-      api.logger.debug(`[loop] Disallowed tools updated from user message: ${messageDisallowedTools ? messageDisallowedTools.join(", ") : "reset to none"}`);
-    } else {
-      api.logger.debug(`[loop] User message received with no disallowed tools override, using current: ${currentDisallowedTools ? currentDisallowedTools.join(", ") : "none"}`);
-    }
-    const specialCommand = parseSpecialCommand(message.content.text);
-    if (specialCommand.type === "compact") {
-      api.logger.debug("[start] Detected /compact command");
-      const enhancedMode2 = {
-        permissionMode: messagePermissionMode || "default",
-        model: messageModel,
-        fallbackModel: messageFallbackModel,
-        customSystemPrompt: messageCustomSystemPrompt,
-        appendSystemPrompt: messageAppendSystemPrompt,
-        allowedTools: messageAllowedTools,
-        disallowedTools: messageDisallowedTools
-      };
-      messageQueue.pushIsolateAndClear(specialCommand.originalMessage || message.content.text, enhancedMode2);
-      api.logger.debugLargeJson("[start] /compact command pushed to queue:", message);
-      return;
-    }
-    if (specialCommand.type === "clear") {
-      api.logger.debug("[start] Detected /clear command");
-      const enhancedMode2 = {
-        permissionMode: messagePermissionMode || "default",
-        model: messageModel,
-        fallbackModel: messageFallbackModel,
-        customSystemPrompt: messageCustomSystemPrompt,
-        appendSystemPrompt: messageAppendSystemPrompt,
-        allowedTools: messageAllowedTools,
-        disallowedTools: messageDisallowedTools
-      };
-      messageQueue.pushIsolateAndClear(specialCommand.originalMessage || message.content.text, enhancedMode2);
-      api.logger.debugLargeJson("[start] /compact command pushed to queue:", message);
-      return;
+  bindClaudeUserMessageQueue({
+    session,
+    messageQueue,
+    initialState: {
+      permissionMode: options.permissionMode,
+      model: options.model
     }
-    const enhancedMode = {
-      permissionMode: messagePermissionMode || "default",
-      model: messageModel,
-      fallbackModel: messageFallbackModel,
-      customSystemPrompt: messageCustomSystemPrompt,
-      appendSystemPrompt: messageAppendSystemPrompt,
-      allowedTools: messageAllowedTools,
-      disallowedTools: messageDisallowedTools
-    };
-    messageQueue.push(message.content.text, enhancedMode);
-    api.logger.debugLargeJson("User message pushed to queue:", message);
   });
   const cleanup = async () => {
     api.logger.debug("[START] Received termination signal, cleaning up...");
     try {
       if (session) {
-        session.updateMetadata((currentMetadata) => ({
-          ...currentMetadata,
-          lifecycleState: "archived",
-          lifecycleStateSince: Date.now(),
-          archivedBy: "cli",
-          archiveReason: "User terminated"
-        }));
         currentSession?.cleanup();
-        session.sendSessionDeath();
-        await session.flush();
-        await session.close();
+        await registerKillSessionHandler.closeProviderSession(session, {
+          archiveReason: "User terminated"
+        });
       }
       index.stopCaffeinate();
       hookServer.stop();
@@ -3444,12 +3934,9 @@ async function runClaude(credentials, options = {}) {
     api: api$1,
     allowedTools: [],
     mcpServers: {},
-    onModeChange: (newMode) => {
+    onModeChange: async (newMode) => {
       session.sendSessionEvent({ type: "switch", mode: newMode });
-      session.updateAgentState((currentState) => ({
-        ...currentState,
-        controlledByUser: newMode === "local"
-      }));
+      await registerKillSessionHandler.syncControlledByUserState(session, newMode === "local");
     },
     onSessionReady: (sessionInstance) => {
       currentSession = sessionInstance;
@@ -3458,14 +3945,13 @@ async function runClaude(credentials, options = {}) {
     claudeEnvVars: options.claudeEnvVars,
     claudeArgs: options.claudeArgs,
     hookSettingsPath,
-    jsRuntime: options.jsRuntime
+    jsRuntime: options.jsRuntime,
+    startedBy: options.startedBy
   });
   currentSession?.cleanup();
-  session.sendSessionDeath();
   api.logger.debug("Waiting for socket to flush...");
-  await session.flush();
   api.logger.debug("Closing session...");
-  await session.close();
+  await registerKillSessionHandler.closeProviderSession(session);
   index.stopCaffeinate();
   api.logger.debug("Stopped sleep prevention");
   hookServer.stop();