replicas-engine 0.1.729 → 0.1.731

package/dist/src/index.js

@@ -8,11 +8,12 @@ import {
   monolithService,
   reportCommandProtectionBlock,
   setAgentCredentialSnapshot
-} from "./chunk-SI3OKIHR.js";
+} from "./chunk-FOMGATAT.js";
 import {
   ACCOUNT_RATE_LIMITS_UPDATED_METHOD,
   AGENT_MESSAGE_DELTA_METHOD,
   AppServerProcess,
+  AspClient,
   COMMAND_EXECUTION_OUTPUT_DELTA_METHOD,
   FILE_CHANGE_OUTPUT_DELTA_METHOD,
   ITEM_COMPLETED_METHOD,
@@ -35,7 +36,7 @@ import {
   execFileAsync,
   putPresignedFile,
   recoverCompletedTurn
-} from "./chunk-NPXUYMVM.js";
+} from "./chunk-RUIFVQCV.js";
 import {
   isRecord as isRecord2
 } from "./chunk-2RB7SIP3.js";
@@ -73,6 +74,7 @@ import {
   CODEX_QUOTA_STATUS_EVENT_TYPE,
   COMPACTION_STATUS_EVENT_TYPE,
   CONTEXT_USAGE_EVENT_TYPE,
+  CREDENTIAL_METHOD,
   CURSOR_CONNECTION_STATUS_EVENT_TYPE,
   DEFAULT_ASTER_MODEL,
   DEFAULT_CHAT_TITLES,
@@ -83,6 +85,7 @@ import {
   DEFAULT_FX_MODEL,
   DEFAULT_HOOK_OUTPUT_PREVIEW_CHARS,
   DEFAULT_KIMI_MODEL,
+  DEFAULT_MUSE_MODEL,
   DEFAULT_OPENCODE_MODEL,
   DEFAULT_PI_MODEL,
   DEFAULT_START_HOOK_TIMEOUT_MS,
@@ -213,10 +216,11 @@ import {
   sanitizeCanvasFilename,
   sendChatMessageRequestSchema,
   serializeCanvasContentResponse,
+  serializeMuseAuthFile,
   shellQuotePosix,
   stripAgentDiagnosticErrors,
   withTimeout
-} from "./chunk-2UL5LXFV.js";
+} from "./chunk-6P3FBKKS.js";
 
 // src/index.ts
 import { serve } from "@hono/node-server";
@@ -1720,6 +1724,7 @@ import { join as join6 } from "path";
 var OPENCODE_AUTH_PATH = join6(homedir3(), ".local", "share", "opencode", "auth.json");
 var PI_AUTH_PATH = join6(homedir3(), ".pi", "agent", "auth.json");
 var DEEPSEEK_AUTH_PATH = join6(homedir3(), ".replicas", "deepseek-auth.json");
+var MUSE_AUTH_PATH = join6(homedir3(), ".config", "muse", "auth.json");
 
 // src/managers/deepseek-auth.ts
 import { readFileSync as readFileSync2 } from "fs";
@@ -1835,6 +1840,7 @@ function createDefaultDetails() {
     deepseekAuthMethod: "none",
     fxAuthMethod: "none",
     kimiAuthMethod: "none",
+    museAuthMethod: "none",
     opencodeAuthMethod: "none",
     piAuthMethod: "none",
     lastUpdatedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -1877,6 +1883,7 @@ var EnvironmentDetailsService = class {
     details.deepseekAuthMethod = detectDeepseekAuthMethod();
     details.fxAuthMethod = detectFxAuthMethod();
     details.kimiAuthMethod = detectFxAuthMethod();
+    details.museAuthMethod = existsSync2(MUSE_AUTH_PATH) ? "oauth" : "none";
     details.opencodeAuthMethod = detectOpencodeAuthMethod();
     details.piAuthMethod = detectPiAuthMethod();
     details.credentialFallbacks = listCredentialFallbacks();
@@ -2632,7 +2639,7 @@ async function registerDesktopPreview() {
 
 // src/services/chat/chat-service.ts
 import { existsSync as existsSync11 } from "fs";
-import { appendFile as appendFile4, copyFile as copyFile2, mkdir as mkdir18, readFile as readFile20, rename as rename3, rm as rm3 } from "fs/promises";
+import { appendFile as appendFile4, copyFile as copyFile2, mkdir as mkdir19, readFile as readFile20, rename as rename3, rm as rm3 } from "fs/promises";
 import { join as join28 } from "path";
 import { randomUUID as randomUUID9 } from "crypto";
 
@@ -3313,10 +3320,51 @@ async function removeTempImageFiles(paths) {
 import { existsSync as existsSync5 } from "fs";
 import { join as join13 } from "path";
 
+// src/managers/muse-token-manager.ts
+var MuseTokenManager = class extends BaseRefreshManager {
+  constructor() {
+    super("MuseTokenManager");
+  }
+  doRefresh() {
+    return Promise.resolve();
+  }
+  async fetchFreshCredentials(failureReason, failureKind = "exhausted", failedCredential = ENGINE_ENV.REPLICAS_AGENT_CREDENTIALS.muse) {
+    return this.swapCredentials({
+      provider: "muse",
+      failureKind,
+      refresh: async (exclusions) => {
+        const request = {
+          failedMethod: CREDENTIAL_METHOD.MUSE_OAUTH,
+          ...failedCredential ? { failedCredential } : {},
+          failureReason,
+          failureKind,
+          ...exclusions
+        };
+        const response = await monolithRequest("/v1/engine/muse/refresh-credentials", { body: request });
+        if (!response.ok) {
+          throw new Error(`Credentials refresh failed: ${response.status} ${await response.text()}`);
+        }
+        const data = await response.json();
+        await writeSecureCredentialFile(MUSE_AUTH_PATH, serializeMuseAuthFile(data), { ensureParentDir: true });
+        if (data.scope) {
+          setAgentCredentialSnapshot("muse", {
+            method: data.type,
+            scope: data.scope,
+            ...data.revision ? { revision: data.revision } : {}
+          });
+        }
+      },
+      isOauthNow: () => false
+    });
+  }
+};
+var museTokenManager = new MuseTokenManager();
+
 // src/managers/auth-fallback.ts
 var SWAPPABLE_AGENTS = {
   claude: claudeTokenManager,
-  codex: codexTokenManager
+  codex: codexTokenManager,
+  muse: museTokenManager
 };
 var AuthFallbackCoordinator = class {
   constructor(provider, record) {
@@ -6499,6 +6547,7 @@ var PI_HISTORY_DIR = join16(ENGINE_DIR2, "pi-histories");
 var DEEPSEEK_HISTORY_DIR = join16(ENGINE_DIR2, "deepseek-histories");
 var FX_HISTORY_DIR = join16(ENGINE_DIR2, "fx-histories");
 var KIMI_HISTORY_DIR = join16(ENGINE_DIR2, "kimi-histories");
+var MUSE_HISTORY_DIR = join16(ENGINE_DIR2, "muse-histories");
 var HISTORY_DIR_BY_PROVIDER = {
   claude: CLAUDE_HISTORY_DIR,
   relay: RELAY_HISTORY_DIR,
@@ -6507,6 +6556,7 @@ var HISTORY_DIR_BY_PROVIDER = {
   deepseek: DEEPSEEK_HISTORY_DIR,
   fx: FX_HISTORY_DIR,
   kimi: KIMI_HISTORY_DIR,
+  muse: MUSE_HISTORY_DIR,
   opencode: OPENCODE_HISTORY_DIR,
   pi: PI_HISTORY_DIR
 };
@@ -9441,11 +9491,388 @@ var KimiManager = class extends AcpManager {
   }
 };
 
+// src/managers/muse-manager.ts
+import { spawn as spawn6 } from "child_process";
+import { randomBytes as randomBytes2 } from "crypto";
+import { mkdir as mkdir15 } from "fs/promises";
+import { dirname as dirname9 } from "path";
+var MuseQuotaError = class extends Error {
+};
+function uuidV7() {
+  const bytes = randomBytes2(16);
+  let timestamp = BigInt(Date.now());
+  for (let index = 5; index >= 0; index -= 1) {
+    bytes[index] = Number(timestamp & 0xffn);
+    timestamp >>= 8n;
+  }
+  bytes[6] = bytes[6] & 15 | 112;
+  bytes[8] = bytes[8] & 63 | 128;
+  const hex = bytes.toString("hex");
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function isPendingQuestion(value) {
+  return isRecord(value) && typeof value.id === "string";
+}
+var MuseManager = class extends CodingAgentManager {
+  historyFile;
+  historyFilePath;
+  process = null;
+  client = null;
+  sessionId = null;
+  activeTurnId = null;
+  deliveredInstructions = null;
+  turnComplete = null;
+  turnError = null;
+  compactionComplete = null;
+  pendingInput = null;
+  slashCommands = null;
+  constructor(options) {
+    super({ ...options, provider: "muse" });
+    this.historyFilePath = options.historyFilePath;
+    this.historyFile = new CodexHistoryFile(options.historyFilePath);
+    this.sessionId = options.initialSessionId;
+    this.initializeManager(this.processMessageInternal.bind(this));
+  }
+  async initialize() {
+    await mkdir15(dirname9(this.historyFilePath), { recursive: true });
+  }
+  getHistorySink() {
+    return this.historyFile;
+  }
+  async start(model) {
+    if (this.process) return;
+    const child = spawn6("muse", ["serve", "--disable-sandbox", "--trust-workspace"], {
+      cwd: this.workingDirectory,
+      env: { ...process.env, MUSE_NO_AUTO_UPDATE: "1", NO_COLOR: "1" },
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    this.process = child;
+    const client2 = new AspClient({ stdin: child.stdin, stdout: child.stdout, jsonRpcVersion: "2.0" });
+    this.client = client2;
+    client2.on("notification", (notification) => this.handleNotification(notification));
+    child.stderr.on("data", (chunk) => console.error("[muse MSP]", chunk.toString().trimEnd()));
+    child.on("error", (error) => this.handleProcessExit(child, error));
+    child.on("exit", (code, signal) => this.handleProcessExit(
+      child,
+      new Error(`Muse MSP exited with code ${code ?? signal}`)
+    ));
+    await this.request("initialize", { clientInfo: { name: "replicas", version: "1" } });
+    this.notify("initialized");
+    if (this.sessionId) {
+      try {
+        await this.request("session/resume", {
+          commandId: uuidV7(),
+          sessionId: this.sessionId,
+          excludeItems: true
+        });
+      } catch {
+        this.sessionId = null;
+      }
+    }
+    if (!this.sessionId) {
+      const result = await this.request("session/start", {
+        commandId: uuidV7(),
+        approvalMode: "allowAll",
+        modelId: model,
+        providerId: "meta",
+        workspaceRoot: this.workingDirectory
+      });
+      const sessionId = isRecord(result) && isRecord(result.session) && typeof result.session.sessionId === "string" ? result.session.sessionId : void 0;
+      if (!sessionId) throw new Error("Muse did not return a session id.");
+      this.sessionId = sessionId;
+      await this.onSaveSessionId(sessionId);
+    }
+  }
+  request(method, params) {
+    if (!this.client) return Promise.reject(new Error("Muse MSP is not running."));
+    return this.client.request(method, params, { timeoutMs: 0 });
+  }
+  notify(method, params) {
+    this.client?.notify(method, params);
+  }
+  handleProcessExit(child, error) {
+    if (this.process !== child) return;
+    const hadPendingRequest = (this.client?.pendingRequestCount ?? 0) > 0;
+    this.process = null;
+    this.client?.dispose(error);
+    this.client = null;
+    if (this.turnComplete && !hadPendingRequest) {
+      this.recordHistoryEvent("muse-error", { message: error.message }, this.historyFile);
+    }
+    this.turnComplete?.resolve();
+    this.turnComplete = null;
+    this.compactionComplete?.resolve();
+    this.compactionComplete = null;
+  }
+  stopProcess() {
+    const process2 = this.process;
+    this.process = null;
+    this.client?.dispose();
+    this.client = null;
+    process2?.kill("SIGTERM");
+  }
+  createTurnInput(text, images) {
+    const input = [{ type: "text", text }];
+    for (const image of images ?? []) {
+      if (image.source.type !== "base64") throw new Error("Muse requires images to be base64 encoded.");
+      input.push({ type: "image", mediaType: image.source.media_type, base64Data: image.source.data });
+    }
+    return input;
+  }
+  handleNotification(frame) {
+    if (!isRecord(frame) || typeof frame.method !== "string" || !isRecord(frame.params)) return;
+    this.recordHistoryEvent(`muse-${frame.method.replaceAll("/", "-")}`, frame.params, this.historyFile);
+    if (frame.method === "turn/completed") {
+      this.turnError = isRecord(frame.params.error) && typeof frame.params.error.message === "string" ? frame.params.error.message : null;
+      this.activeTurnId = null;
+      this.turnComplete?.resolve();
+      this.turnComplete = null;
+    } else if (frame.method === "item/completed" && isRecord(frame.params.item) && frame.params.item.kind === "compaction") {
+      this.compactionComplete?.resolve();
+      this.compactionComplete = null;
+    } else if (frame.method === "session/tokenUsage") {
+      this.onUsageUpdate(frame.params, (/* @__PURE__ */ new Date()).toISOString());
+    } else if (frame.method === "session/contextUsage") {
+      const used = typeof frame.params.usedTokens === "number" ? frame.params.usedTokens : 0;
+      const size = typeof frame.params.windowTokens === "number" ? frame.params.windowTokens : 0;
+      this.historyFile.append(this.emitContextUsage({
+        provider: "muse",
+        source: "provider_usage",
+        model: DEFAULT_MUSE_MODEL,
+        totalTokens: used,
+        maxTokens: size,
+        percentage: size > 0 ? used / size * 100 : 0,
+        categories: [],
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+      }));
+    } else if (frame.method === "userInput/requested" && typeof frame.params.userInputId === "string") {
+      const questions = Array.isArray(frame.params.questions) ? frame.params.questions.filter(isPendingQuestion) : [];
+      this.pendingInput = {
+        userInputId: frame.params.userInputId,
+        toolCallId: typeof frame.params.toolCallId === "string" ? frame.params.toolCallId : frame.params.userInputId,
+        questions
+      };
+      this.recordHistoryEvent("replicas-tool-input-request", {
+        requestId: frame.params.userInputId,
+        toolUseId: this.pendingInput.toolCallId,
+        toolName: typeof frame.params.toolName === "string" ? frame.params.toolName : "request_user_input",
+        questions: questions.map((question) => ({
+          id: question.id,
+          prompt: question.question ?? question.id,
+          multiSelect: question.selection?.mode === "multiple",
+          options: (question.options ?? []).flatMap((option) => typeof option.label === "string" ? [{
+            id: option.label,
+            label: option.label,
+            ...option.description ? { description: option.description } : {},
+            ...option.preview?.content ? { preview: option.preview.content } : {}
+          }] : [])
+        })),
+        parent_tool_use_id: null
+      }, this.historyFile);
+    }
+  }
+  async processMessageInternal(request) {
+    let userMessageRecorded = false;
+    const dispatch = async () => {
+      const model = request.model ?? DEFAULT_MUSE_MODEL;
+      await this.start(model);
+      if (!this.sessionId) throw new Error("Muse MSP failed to initialize.");
+      if (!userMessageRecorded) {
+        this.recordUserMessageHistoryEvent(
+          request,
+          this.historyFile,
+          /^\/compact$/i.test(request.message.trim()) ? { command: "compact" } : {}
+        );
+        userMessageRecorded = true;
+      }
+      if (/^\/compact$/i.test(request.message.trim())) {
+        const completed2 = new Promise((resolve5) => {
+          this.compactionComplete = { resolve: resolve5 };
+        });
+        const result2 = await this.request("session/compact", {
+          commandId: uuidV7(),
+          sessionId: this.sessionId
+        });
+        if (isRecord(result2) && result2.status === "accepted") {
+          this.setCompacting(true);
+          await completed2;
+        } else {
+          this.compactionComplete = null;
+        }
+        return;
+      }
+      await this.request("session/setApprovalMode", {
+        commandId: uuidV7(),
+        sessionId: this.sessionId,
+        mode: request.planMode ? "denyUnmatched" : "allowAll"
+      });
+      await this.request("session/setModel", {
+        commandId: uuidV7(),
+        sessionId: this.sessionId,
+        model: { providerId: "meta", modelId: model }
+      });
+      const instructions = this.buildCombinedInstructions(request.customInstructions);
+      const pending = instructions && instructions !== this.deliveredInstructions ? instructions : null;
+      const text = `${pending ? `<workspace-instructions>
+${pending}
+</workspace-instructions>
+
+` : ""}${request.planMode ? "Plan the requested work without modifying files or running mutating commands.\n\n" : ""}${request.message}`;
+      this.turnError = null;
+      const completed = new Promise((resolve5) => {
+        this.turnComplete = { resolve: resolve5 };
+      });
+      const result = await this.request("turn/start", {
+        commandId: uuidV7(),
+        sessionId: this.sessionId,
+        input: this.createTurnInput(text, request.images),
+        displayText: request.message,
+        reasoningEffort: codexReasoningEffortForThinkingLevel(request.thinkingLevel)
+      });
+      if (!isRecord(result) || typeof result.turnId !== "string") throw new Error("Muse did not start a turn.");
+      this.activeTurnId = result.turnId;
+      if (pending) this.deliveredInstructions = pending;
+      await completed;
+      if (this.turnError && detectAgentQuotaLimit(this.turnError)) throw new MuseQuotaError(this.turnError);
+    };
+    try {
+      await dispatch();
+    } catch (error) {
+      if (error instanceof MuseQuotaError) {
+        const quotaKind = detectAgentQuotaLimit(error.message);
+        const outcome = await this.fallBackCredential(quotaKind ?? "rate_limit", error.message);
+        if (outcome === "switched") {
+          this.stopProcess();
+          try {
+            await dispatch();
+          } catch (retryError) {
+            if (retryError instanceof MuseQuotaError) return;
+            this.recordHistoryEvent("muse-error", {
+              message: retryError instanceof Error ? retryError.message : String(retryError)
+            }, this.historyFile);
+            throw retryError;
+          }
+        }
+        return;
+      }
+      this.recordHistoryEvent("muse-error", { message: error instanceof Error ? error.message : String(error) }, this.historyFile);
+      throw error;
+    } finally {
+      this.turnComplete?.resolve();
+      this.turnComplete = null;
+      this.activeTurnId = null;
+      this.turnError = null;
+      this.pendingInput = null;
+      this.compactionComplete?.resolve();
+      this.compactionComplete = null;
+      try {
+        await this.historyFile.flush();
+      } finally {
+        await this.onTurnComplete();
+      }
+    }
+  }
+  async interruptActiveTurn() {
+    if (!this.sessionId || !this.activeTurnId) return;
+    await this.request("turn/interrupt", {
+      commandId: uuidV7(),
+      sessionId: this.sessionId,
+      turnId: this.activeTurnId
+    });
+  }
+  async steerRequest(request) {
+    if (!this.sessionId || !this.activeTurnId) return false;
+    await this.request("turn/steer", {
+      commandId: uuidV7(),
+      sessionId: this.sessionId,
+      expectedTurnId: this.activeTurnId,
+      input: this.createTurnInput(request.message, request.images),
+      reasoningEffort: codexReasoningEffortForThinkingLevel(request.thinkingLevel)
+    });
+    return true;
+  }
+  async respondToToolInput(requestId, selectionId) {
+    if (!this.pendingInput || this.pendingInput.userInputId !== requestId || !this.sessionId) return false;
+    const pending = this.pendingInput;
+    if (selectionId === "declined") {
+      await this.request("userInput/cancel", {
+        commandId: uuidV7(),
+        sessionId: this.sessionId,
+        userInputId: pending.userInputId
+      });
+    } else {
+      const parsedSelections = JSON.parse(selectionId);
+      const selections = isRecord(parsedSelections) ? parsedSelections : {};
+      const answers = pending.questions.map((question) => {
+        const selection = selections[question.id];
+        const custom = isRecord(selection) && typeof selection.custom === "string" ? selection.custom.trim() : "";
+        if (custom) return { questionId: question.id, freeText: custom };
+        const options = isRecord(selection) && Array.isArray(selection.options) ? selection.options.filter((option) => typeof option === "string") : [];
+        const labels = options.flatMap((id) => question.options?.some((option) => option.label === id) ? [id] : []);
+        return question.selection?.mode === "multiple" ? { questionId: question.id, selectedLabels: labels } : { questionId: question.id, selectedLabel: labels[0] };
+      });
+      await this.request("userInput/answer", {
+        commandId: uuidV7(),
+        sessionId: this.sessionId,
+        userInputId: pending.userInputId,
+        answers
+      });
+    }
+    this.pendingInput = null;
+    this.recordHistoryEvent("replicas-tool-input-resolved", {
+      requestId,
+      toolUseId: pending.toolCallId,
+      toolName: "request_user_input",
+      selectionId: selectionId === "declined" ? "aborted" : selectionId,
+      parent_tool_use_id: null
+    }, this.historyFile);
+    return true;
+  }
+  isAwaitingInput() {
+    return this.pendingInput !== null;
+  }
+  async getHistory(page = {}) {
+    await this.historyFile.flush();
+    return { thread_id: this.sessionId, ...await this.historyFile.loadEventsPage(page), goal: null };
+  }
+  async listSlashCommands() {
+    if (this.slashCommands) return this.slashCommands;
+    try {
+      const { stdout } = await execFileAsync("muse", [
+        "skills",
+        "list",
+        "--enabled-only",
+        "--workspace",
+        this.workingDirectory,
+        "--trust-workspace",
+        "--json"
+      ], { maxBuffer: SUBPROCESS_MAX_BUFFER });
+      const parsed = JSON.parse(stdout);
+      this.slashCommands = isRecord(parsed) && Array.isArray(parsed.skills) ? parsed.skills.flatMap((skill) => {
+        if (!isRecord(skill) || typeof skill.name !== "string") return [];
+        const command = createProviderSlashCommand(
+          "muse",
+          skill.name,
+          typeof skill.description === "string" ? skill.description : void 0
+        );
+        return command ? [command] : [];
+      }) : [];
+    } catch (error) {
+      console.warn("[MuseManager] Failed to load slash commands:", error);
+      this.slashCommands = [];
+    }
+    return this.slashCommands;
+  }
+  dispose() {
+    this.stopProcess();
+  }
+};
+
 // src/managers/opencode-manager.ts
 import { existsSync as existsSync9 } from "fs";
-import { copyFile, mkdir as mkdir15, readFile as readFile15, rm as rm2 } from "fs/promises";
-import { delimiter, dirname as dirname9, join as join21 } from "path";
-import { randomBytes as randomBytes2 } from "crypto";
+import { copyFile, mkdir as mkdir16, readFile as readFile15, rm as rm2 } from "fs/promises";
+import { delimiter, dirname as dirname10, join as join21 } from "path";
+import { randomBytes as randomBytes3 } from "crypto";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { Agent } from "undici";
 import { z as z3 } from "zod";
@@ -9503,7 +9930,7 @@ async function getAllowedOpenRouterModels() {
 }
 
 // src/managers/opencode-manager.ts
-var OPENCODE_SHIM_DIR = dirname9(fileURLToPath3(new URL("../../scripts/opencode", import.meta.url)));
+var OPENCODE_SHIM_DIR = dirname10(fileURLToPath3(new URL("../../scripts/opencode", import.meta.url)));
 var OPENCODE_COMMAND_PROTECTION_PLUGIN_SOURCE = join21(OPENCODE_SHIM_DIR, "opencode-command-protection-plugin.ts");
 var OPENCODE_COMMAND_PROTECTION_PLUGIN_PATH = join21(ENGINE_ENV.HOME_DIR, ".config", "opencode", "plugins", "replicas-command-protection.ts");
 var OPENCODE_LEGACY_COMMAND_PROTECTION_PLUGIN_PATH = join21(ENGINE_ENV.HOME_DIR, ".config", "opencode", "plugins", "replicas-command-protection.mjs");
@@ -9724,7 +10151,7 @@ var OpencodeManager = class extends CodingAgentManager {
     this.initializeManager(this.processMessageInternal.bind(this));
   }
   async initialize() {
-    await mkdir15(dirname9(this.historyFilePath), { recursive: true });
+    await mkdir16(dirname10(this.historyFilePath), { recursive: true });
   }
   getHistorySink() {
     return this.historyFile;
@@ -9824,7 +10251,7 @@ var OpencodeManager = class extends CodingAgentManager {
       if (!existsSync9(OPENCODE_COMMAND_PROTECTION_PLUGIN_SOURCE)) {
         throw new Error("Opencode command protection plugin is missing from the engine package.");
       }
-      await mkdir15(dirname9(OPENCODE_COMMAND_PROTECTION_PLUGIN_PATH), { recursive: true });
+      await mkdir16(dirname10(OPENCODE_COMMAND_PROTECTION_PLUGIN_PATH), { recursive: true });
       await copyFile(OPENCODE_COMMAND_PROTECTION_PLUGIN_SOURCE, OPENCODE_COMMAND_PROTECTION_PLUGIN_PATH);
       await rm2(OPENCODE_LEGACY_COMMAND_PROTECTION_PLUGIN_PATH, { force: true });
       process.env.REPLICAS_COMMAND_PROTECTION_HOOK_PATH = getCommandProtectionHookPath();
@@ -9836,7 +10263,7 @@ var OpencodeManager = class extends CodingAgentManager {
       if (!pathEntries.includes(OPENCODE_SHIM_DIR)) {
         process.env.PATH = [OPENCODE_SHIM_DIR, ...pathEntries].join(delimiter);
       }
-      const password = process.env.OPENCODE_SERVER_PASSWORD || randomBytes2(24).toString("base64url");
+      const password = process.env.OPENCODE_SERVER_PASSWORD || randomBytes3(24).toString("base64url");
       process.env.OPENCODE_SERVER_PASSWORD = password;
       const config = opencodeConfig(providerId, configuredModel, providerModels);
       const mcp = await readProvisionedOpencodeMcpConfig();
@@ -10119,8 +10546,8 @@ var OpencodeManager = class extends CodingAgentManager {
 };
 
 // src/managers/pi-manager.ts
-import { mkdir as mkdir16 } from "fs/promises";
-import { dirname as dirname10, join as join22 } from "path";
+import { mkdir as mkdir17 } from "fs/promises";
+import { dirname as dirname11, join as join22 } from "path";
 import {
   AuthStorage,
   createAgentSession,
@@ -10239,7 +10666,7 @@ var PiManager = class extends CodingAgentManager {
     this.initializeManager(this.processMessageInternal.bind(this));
   }
   async initialize() {
-    await mkdir16(dirname10(this.historyFilePath), { recursive: true });
+    await mkdir17(dirname11(this.historyFilePath), { recursive: true });
   }
   getHistorySink() {
     return this.historyFile;
@@ -10418,6 +10845,7 @@ function getAvailableRelayProviders(availability) {
   const deepseekAvailable = availability.deepseekAvailable ?? false;
   const fxAvailable = availability.fxAvailable ?? false;
   const kimiAvailable = availability.kimiAvailable ?? false;
+  const museAvailable = availability.museAvailable ?? false;
   const opencodeAvailable = availability.opencodeAvailable ?? false;
   const piAvailable = availability.piAvailable ?? false;
   const providers = ["claude"];
@@ -10426,6 +10854,7 @@ function getAvailableRelayProviders(availability) {
   if (deepseekAvailable) providers.push("deepseek");
   if (fxAvailable) providers.push("fx");
   if (kimiAvailable) providers.push("kimi");
+  if (museAvailable) providers.push("muse");
   if (opencodeAvailable) providers.push("opencode");
   if (piAvailable) providers.push("pi");
   providers.push("relay");
@@ -10519,6 +10948,10 @@ function extractFinalResponse(history) {
       const text = getFxTextChunk(payload.update, "agent_message_chunk");
       if (text) return text;
     }
+    if (event.type === "muse-item-completed") {
+      const item = isRecord(payload.item) ? payload.item : void 0;
+      if (item?.kind === "agentMessage" && typeof item.text === "string" && item.text) return item.text;
+    }
   }
   return null;
 }
@@ -10559,11 +10992,12 @@ You will also receive the chatId so you can send follow-up messages or clean up
         `DeepSeek Harness: ${AGENT_MODELS.deepseek.join(", ")}.`,
         `fx: ${AGENT_MODELS.fx.join(", ")}.`,
         `Kimi Code: ${AGENT_MODELS.kimi.join(", ")}.`,
+        `Muse Code: ${AGENT_MODELS.muse.join(", ")}.`,
         `Opencode: ${AGENT_MODELS.opencode.join(", ")}.`,
         `Pi: ${AGENT_MODELS.pi.join(", ")}.`
       ].join(" ")),
       thinking_level: z4.enum(VALID_THINKING_LEVELS).optional().describe(
-        "Controls how much thinking/reasoning the subagent applies. low = light thinking, medium = moderate, high = deep reasoning, xhigh = extended effort, max = maximum effort, ultra = Codex ultra, ultracode = Claude Code dynamic workflows. Defaults: Claude = high; Codex, Cursor, DeepSeek Harness, fx, Kimi Code, Opencode, and Pi = medium."
+        "Controls how much thinking/reasoning the subagent applies. low = light thinking, medium = moderate, high = deep reasoning, xhigh = extended effort, max = maximum effort, ultra = Codex and Muse ultra, ultracode = Claude Code dynamic workflows. Defaults: Claude and Muse Code = high; Codex, Cursor, DeepSeek Harness, fx, Kimi Code, Opencode, and Pi = medium."
       ),
       title: z4.string().optional().describe("Optional title for the subagent chat (for identification)."),
       timeout_minutes: z4.number().positive().optional().describe("Timeout in minutes for the subagent to complete (default: 10). Set higher for large tasks to avoid losing work.")
@@ -10815,8 +11249,8 @@ function getUsingToolsSection() {
   ];
   return [`# Using your tools`, ...prependBullets(items)].join("\n");
 }
-function getDelegationSection(codexAvailable, cursorAvailable, deepseekAvailable, fxAvailable, kimiAvailable, opencodeAvailable, piAvailable) {
-  const providerList = getAvailableRelayProviders({ codexAvailable, cursorAvailable, deepseekAvailable, fxAvailable, kimiAvailable, opencodeAvailable, piAvailable }).join(", ");
+function getDelegationSection(codexAvailable, cursorAvailable, deepseekAvailable, fxAvailable, kimiAvailable, museAvailable, opencodeAvailable, piAvailable) {
+  const providerList = getAvailableRelayProviders({ codexAvailable, cursorAvailable, deepseekAvailable, fxAvailable, kimiAvailable, museAvailable, opencodeAvailable, piAvailable }).join(", ");
   const spawnDesc = `Create a new subagent with a specific provider (${providerList}), send it a prompt, and wait for its response. Returns the chatId and the agent's final response. You can set a custom timeout via the timeout_minutes parameter (default: 10 minutes).`;
   const claudeModelList = AGENT_MODELS.claude.join(", ");
   const extraAgentLines = [
@@ -10824,6 +11258,7 @@ function getDelegationSection(codexAvailable, cursorAvailable, deepseekAvailable
     deepseekAvailable ? `Use provider 'deepseek' for tasks that benefit from the DeepSeek Harness tool loop. Suggested models: ${AGENT_MODELS.deepseek.join(", ")}.` : null,
     fxAvailable ? `Use provider 'fx' for tasks that benefit from fx's minimal native coding loop. Suggested models: ${AGENT_MODELS.fx.join(", ")}.` : null,
     kimiAvailable ? `Use provider 'kimi' for tasks that benefit from Kimi Code's ACP coding loop. Suggested models: ${AGENT_MODELS.kimi.join(", ")}.` : null,
+    museAvailable ? `Use provider 'muse' for tasks that benefit from Muse Code's native coding loop. Suggested models: ${AGENT_MODELS.muse.join(", ")}.` : null,
     opencodeAvailable ? `Use provider 'opencode' for cheaper routine implementation tasks through OpenRouter-backed open source models. Suggested models: ${AGENT_MODELS.opencode.join(", ")}.` : null,
     piAvailable ? `Use provider 'pi' for coding tasks through Pi's OpenRouter-backed coding agent. Suggested models: ${AGENT_MODELS.pi.join(", ")}.` : null,
     cursorAvailable ? `Use provider 'cursor' for fast iteration on code changes. Suggested models: ${AGENT_MODELS.cursor.join(", ")}.` : null
@@ -10948,14 +11383,14 @@ function getEnvironmentSection() {
   ].join("\n");
 }
 function buildRelaySystemPrompt(options) {
-  const { customInstructions, codexAvailable, cursorAvailable, deepseekAvailable, fxAvailable, kimiAvailable, opencodeAvailable, piAvailable } = options ?? {};
+  const { customInstructions, codexAvailable, cursorAvailable, deepseekAvailable, fxAvailable, kimiAvailable, museAvailable, opencodeAvailable, piAvailable } = options ?? {};
   const sections = [
     getIntroSection(),
     getSystemSection(),
     getDoingTasksSection(),
     getActionsSection(),
     getUsingToolsSection(),
-    getDelegationSection(codexAvailable ?? false, cursorAvailable ?? false, deepseekAvailable ?? false, fxAvailable ?? false, kimiAvailable ?? false, opencodeAvailable ?? false, piAvailable ?? false),
+    getDelegationSection(codexAvailable ?? false, cursorAvailable ?? false, deepseekAvailable ?? false, fxAvailable ?? false, kimiAvailable ?? false, museAvailable ?? false, opencodeAvailable ?? false, piAvailable ?? false),
     getToneAndStyleSection(),
     getOutputEfficiencySection(),
     getEnvironmentSection(),
@@ -10990,9 +11425,10 @@ var RelayManager = class {
     const deepseekAvailable = options.deepseekAvailable ?? false;
     const fxAvailable = options.fxAvailable ?? false;
     const kimiAvailable = options.kimiAvailable ?? false;
+    const museAvailable = options.museAvailable ?? false;
     const opencodeAvailable = options.opencodeAvailable ?? false;
     const piAvailable = options.piAvailable ?? false;
-    const availability = { codexAvailable, cursorAvailable, deepseekAvailable, fxAvailable, kimiAvailable, opencodeAvailable, piAvailable };
+    const availability = { codexAvailable, cursorAvailable, deepseekAvailable, fxAvailable, kimiAvailable, museAvailable, opencodeAvailable, piAvailable };
     const getProviderAvailability = options.getProviderAvailability ?? (() => availability);
     this.inner = new ClaudeManager({
       ...options,
@@ -11070,7 +11506,7 @@ async function uploadAnalytics(endpoint, body) {
 // src/analytics/analytics-record-buffer.ts
 import {
   appendFile as appendFile3,
-  mkdir as mkdir17,
+  mkdir as mkdir18,
   readFile as readFile16,
   readdir as readdir6,
   rename as rename2,
@@ -11112,7 +11548,7 @@ var AnalyticsRecordBuffer = class {
       if (this.recordIds.has(recordId)) return;
       this.recordIds.add(recordId);
     }
-    const pending = mkdir17(ENGINE_DIR2, { recursive: true }).then(() => appendFile3(this.liveFile, `${JSON.stringify(record)}
+    const pending = mkdir18(ENGINE_DIR2, { recursive: true }).then(() => appendFile3(this.liveFile, `${JSON.stringify(record)}
 `, "utf-8")).catch((error) => {
       console.error(
         `[${this.options.storageName}] Append failed, will retry on flush:`,
@@ -11227,7 +11663,7 @@ var AnalyticsRecordBuffer = class {
 };
 
 // src/analytics/agent/activity/skill-mcp-call-extractor.ts
-var NON_MCP_SERVERS = /* @__PURE__ */ new Set(["claude", "cursor", "deepseek", "fx", "kimi", "opencode", "pi", "custom", "dynamic"]);
+var NON_MCP_SERVERS = /* @__PURE__ */ new Set(["claude", "cursor", "deepseek", "fx", "kimi", "muse", "opencode", "pi", "custom", "dynamic"]);
 function mcpNameFromToolCall(message) {
   const parsedName = parseMcpToolName(message.tool);
   if (parsedName) return parsedName.server;
@@ -11774,6 +12210,28 @@ var DeepseekTokenUsageService = class {
   }
 };
 
+// src/analytics/token-usage/muse/index.ts
+var MuseTokenUsageService = class {
+  record(event) {
+    if (event.type !== "usage-updated" || !isRecord(event.payload) || !isRecord(event.payload.usage)) return void 0;
+    const usage = {
+      inputTokens: event.payload.promptTokens,
+      outputTokens: event.payload.usage.outputTokens,
+      cacheReadInputTokens: 0,
+      cacheWriteInputTokens: 0
+    };
+    if (!isTokenUsageCounts(usage)) return void 0;
+    const record = {
+      ...event.context,
+      harness: AGENT.MUSE,
+      model: typeof event.payload.modelId === "string" ? event.payload.modelId : event.context.model,
+      ...usage,
+      occurredAt: event.occurredAt
+    };
+    return { records: [record] };
+  }
+};
+
 // src/analytics/token-usage/opencode/index.ts
 function parseOpencodeTokenUsage(payload) {
   if (!isRecord(payload) || payload.type !== "step-finish" || !isRecord(payload.tokens) || !isRecord(payload.tokens.cache)) return void 0;
@@ -11840,6 +12298,8 @@ function createAgentTokenUsageService(harness) {
       return new CursorTokenUsageService();
     case AGENT.DEEPSEEK:
       return new DeepseekTokenUsageService();
+    case AGENT.MUSE:
+      return new MuseTokenUsageService();
     case AGENT.OPENCODE:
       return new OpencodeTokenUsageService();
     case AGENT.PI:
@@ -12549,6 +13009,9 @@ function isFxAvailable() {
 function isKimiAvailable() {
   return Boolean(ENGINE_ENV.AI_GATEWAY_API_KEY);
 }
+function isMuseAvailable() {
+  return existsSync11(MUSE_AUTH_PATH);
+}
 function isPiAvailable() {
   return existsSync11(PI_AUTH_PATH);
 }
@@ -12689,13 +13152,13 @@ var ChatService = class {
   persistPromise = null;
   persistQueued = false;
   async initialize() {
-    await mkdir18(ENGINE_DIR2, { recursive: true });
-    await mkdir18(CLAUDE_HISTORY_DIR, { recursive: true });
-    await mkdir18(RELAY_HISTORY_DIR, { recursive: true });
-    await mkdir18(CODEX_HISTORY_DIR, { recursive: true });
-    await mkdir18(CURSOR_HISTORY_DIR, { recursive: true });
-    await mkdir18(OPENCODE_HISTORY_DIR, { recursive: true });
-    await mkdir18(CHAT_SENDERS_DIR, { recursive: true });
+    await mkdir19(ENGINE_DIR2, { recursive: true });
+    await mkdir19(CLAUDE_HISTORY_DIR, { recursive: true });
+    await mkdir19(RELAY_HISTORY_DIR, { recursive: true });
+    await mkdir19(CODEX_HISTORY_DIR, { recursive: true });
+    await mkdir19(CURSOR_HISTORY_DIR, { recursive: true });
+    await mkdir19(OPENCODE_HISTORY_DIR, { recursive: true });
+    await mkdir19(CHAT_SENDERS_DIR, { recursive: true });
     const persisted = await this.loadChats();
     for (const chat of persisted) {
       const runtime = this.createRuntimeChat(chat);
@@ -13281,7 +13744,8 @@ var ChatService = class {
         cursorAvailable: isCursorAvailable(),
         deepseekAvailable: isDeepseekAvailable(),
         fxAvailable: isFxAvailable(),
-        kimiAvailable: isKimiAvailable()
+        kimiAvailable: isKimiAvailable(),
+        museAvailable: isMuseAvailable()
       });
       provider = new RelayManager({
         workingDirectory: this.workingDirectory,
@@ -13342,6 +13806,18 @@ var ChatService = class {
         onProcessingChanged,
         onMessageStarted
       });
+    } else if (persisted.provider === "muse") {
+      provider = new MuseManager({
+        workingDirectory: this.workingDirectory,
+        historyFilePath: join28(MUSE_HISTORY_DIR, `${persisted.id}.jsonl`),
+        initialSessionId: persisted.providerSessionId,
+        onSaveSessionId: saveSession,
+        onTurnComplete: onProviderTurnComplete,
+        onEvent: onProviderEvent,
+        onProcessingChanged,
+        onMessageStarted,
+        onUsageUpdate: onProviderUsage
+      });
     } else if (persisted.provider === "opencode") {
       provider = new OpencodeManager({
         workingDirectory: this.workingDirectory,
@@ -14005,13 +14481,13 @@ import { readdir as readdir11, stat as stat7, readFile as readFile24 } from "fs/
 import { join as join32, resolve as resolve3 } from "path";
 
 // src/services/warm-hooks-service.ts
-import { spawn as spawn6 } from "child_process";
+import { spawn as spawn7 } from "child_process";
 import { readFile as readFile23 } from "fs/promises";
 import { existsSync as existsSync12 } from "fs";
 import { join as join31 } from "path";
 
 // src/services/warm-hook-logs-service.ts
-import { mkdir as mkdir19, readFile as readFile22, writeFile as writeFile9, readdir as readdir10, appendFile as appendFile5, unlink as unlink4 } from "fs/promises";
+import { mkdir as mkdir20, readFile as readFile22, writeFile as writeFile9, readdir as readdir10, appendFile as appendFile5, unlink as unlink4 } from "fs/promises";
 import { homedir as homedir13 } from "os";
 import { join as join30 } from "path";
 var LOGS_DIR2 = join30(homedir13(), ".replicas", "warm-hook-logs");
@@ -14023,7 +14499,7 @@ function withPreview2(stored) {
 }
 var WarmHookLogsService = class {
   async ensureDir() {
-    await mkdir19(LOGS_DIR2, { recursive: true });
+    await mkdir20(LOGS_DIR2, { recursive: true });
   }
   async saveGlobalHookLog(entry) {
     await this.ensureDir();
@@ -14180,7 +14656,7 @@ async function executeHookScriptStreaming(params) {
   params.onChunk(`$ ${params.label}
 `);
   return new Promise((resolve5) => {
-    const proc = spawn6("bash", ["-lc", params.content], {
+    const proc = spawn7("bash", ["-lc", params.content], {
       cwd: params.cwd,
       env: process.env,
       stdio: ["pipe", "pipe", "pipe"]
@@ -14391,7 +14867,7 @@ ${combinedScript}` : combinedScript;
 // src/services/terminal-service.ts
 import { randomUUID as randomUUID10 } from "crypto";
 import { existsSync as existsSync13 } from "fs";
-import { spawn as spawn7 } from "node-pty";
+import { spawn as spawn8 } from "node-pty";
 var MAX_REPLAY_CHARS = 1024 * 1024;
 var MAX_TERMINAL_SESSIONS = 8;
 var MAX_PENDING_INPUT = 64;
@@ -14410,7 +14886,7 @@ var TerminalService = class {
     }
     const id = randomUUID10();
     const shell = process.env.SHELL && existsSync13(process.env.SHELL) ? process.env.SHELL : "/bin/bash";
-    const pty = spawn7(shell, ["-l"], {
+    const pty = spawn8(shell, ["-l"], {
       name: "xterm-256color",
       cols,
       rows,
@@ -15474,17 +15950,17 @@ var HeartbeatService = class _HeartbeatService {
 var heartbeatService = new HeartbeatService();
 
 // src/services/workspace-sdk-service.ts
-import { cp, mkdir as mkdir20 } from "fs/promises";
-import { dirname as dirname11, resolve as resolve4 } from "path";
+import { cp, mkdir as mkdir21 } from "fs/promises";
+import { dirname as dirname12, resolve as resolve4 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 async function installWorkspaceSdk() {
-  const source = resolve4(dirname11(fileURLToPath4(import.meta.url)), "../../workspace-sdk");
+  const source = resolve4(dirname12(fileURLToPath4(import.meta.url)), "../../workspace-sdk");
   const targets = [
     resolve4(ENGINE_ENV.HOME_DIR, "node_modules/@replicas/sdk"),
     "/tmp/node_modules/@replicas/sdk"
   ];
   await Promise.all(targets.map(async (target) => {
-    await mkdir20(target, { recursive: true });
+    await mkdir21(target, { recursive: true });
     await cp(source, target, { recursive: true, force: true });
   }));
 }