quoroom 0.1.37 → 0.1.39

package/README.md

@@ -457,6 +457,11 @@ npm install              # Install dependencies
 npm run build            # Typecheck + bundle MCP server + build UI
 npm run build:mcp        # Bundle MCP server only (esbuild)
 npm run build:ui         # Build UI SPA only (Vite)
+npm run dev              # Local-only dev (links + room)
+npm run dev:with-cloud   # Local dev + cloud (requires ../cloud)
+npm run dev:isolated     # Isolated local dev (room :4700 + UI, no cloud)
+npm run dev:isolated:with-cloud # Isolated local dev + cloud
+npm run dev:cloud        # Cloud-only (runs ../cloud on :3715)
 npm run dev:ui           # UI dev server with hot reload
 npm run typecheck        # Type-check only (tsc --noEmit)
 npm test                 # Run all tests (vitest, fork pool)
@@ -464,7 +469,10 @@ npm run test:watch       # Watch mode
 npm run test:e2e         # End-to-end tests (Playwright)
 
 # Windows
+npm run dev:win              # Local-only dev (same as npm run dev)
+npm run dev:with-cloud:win   # Local dev + cloud (requires ../cloud)
 npm run dev:isolated:win    # Windows equivalent of dev:isolated
+npm run dev:isolated:with-cloud:win # Windows isolated + cloud
 npm run build:windows:local # Local Windows build (PowerShell)
 ```
 

package/out/mcp/api-server.js

@@ -9914,7 +9914,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "quoroom",
-      version: "0.1.37",
+      version: "0.1.39",
       description: "Open-source local AI agent framework \u2014 Queen, Workers, Quorum. Experimental research tool.",
       main: "./out/mcp/server.js",
       bin: {
@@ -9944,16 +9944,20 @@ var require_package = __commonJS({
         "kill:quoroom-runtime": "node scripts/kill-quoroom-runtime.js",
         "kill:dev-runtime": "npm run kill:dev-ports && npm run kill:quoroom-runtime",
         "dev:links": "node scripts/dev-links.js",
-        dev: `sh -c 'npm run kill:dev-runtime && trap "kill 0" INT TERM EXIT; npm run dev:links & npm run dev:room & npm run dev:cloud & wait'`,
+        dev: "node scripts/run-dev.js",
         "dev:win": "node scripts/run-dev.js",
+        "dev:with-cloud": "node scripts/run-dev.js --with-cloud",
+        "dev:with-cloud:win": "node scripts/run-dev.js --with-cloud",
         "dev:room": "sh -c 'npm run kill:dev-runtime && export QUOROOM_DATA_DIR=$HOME/.quoroom-dev QUOROOM_SKIP_MCP_REGISTER=1; npm run build:mcp && npm run build:ui && node scripts/dev-server.js --port 4700'",
         "dev:room:win": "node scripts/dev-room.js --port 4700",
         "dev:room:isolated:win": "node scripts/dev-room.js --isolated --port 4700",
         "dev:room:isolated": "sh -c 'npm run kill:dev-runtime && export QUOROOM_DATA_DIR=$HOME/.quoroom-dev QUOROOM_SKIP_MCP_REGISTER=1; npm run build:mcp && npm run build:ui && node scripts/dev-server.js --port 4700'",
         "dev:room:shared": "npm run kill:dev-runtime && npm run build:mcp && npm run build:ui && node scripts/dev-server.js",
         "doctor:split": "node scripts/doctor-split.js",
-        "dev:isolated": `sh -c 'npm run kill:dev-runtime && trap "kill 0" INT TERM EXIT; npm run dev:links & npm run dev:room:isolated & npm run dev:cloud & VITE_API_PORT=4700 npm run dev:ui & wait'`,
+        "dev:isolated": "node scripts/run-dev.js --isolated",
         "dev:isolated:win": "node scripts/run-dev.js --isolated",
+        "dev:isolated:with-cloud": "node scripts/run-dev.js --isolated --with-cloud",
+        "dev:isolated:with-cloud:win": "node scripts/run-dev.js --isolated --with-cloud",
         "dev:cloud": `sh -c 'npm run kill:ports -- 3715 && cd ../cloud && PORT=3715 CLOUD_PUBLIC_URL=http://127.0.0.1:3715 CLOUD_ALLOWED_ORIGINS='"'"'http://127.0.0.1:3715,http://localhost:3715,http://localhost:5173,http://127.0.0.1:5173,https://quoroom.ai,https://www.quoroom.ai,https://app.quoroom.ai'"'"' npm start'`,
         "dev:cloud:win": "node scripts/dev-cloud.js",
         "dev:ui": "vite --config src/ui/vite.config.ts",
@@ -22619,13 +22623,14 @@ Every cycle:
 1. Check if workers reported results (messages, completed goals)
 2. If work is done \u2192 send results to keeper, take next step
 3. If work is stuck \u2192 help unblock (new instructions, different approach)
-4. If new work needed \u2192 delegate to a worker with clear instructions
-5. If a decision needs input \u2192 announce it (workers can object within 10 min)
+4. If no workers exist yet \u2192 create an executor worker first
+5. If new work is needed \u2192 delegate to a worker with clear instructions, then poke/follow up
+6. If a decision needs input \u2192 announce it and process objections/votes (announce/object flow)
 
 Talk to the keeper regularly \u2014 they are your client.
 
-Do NOT do execution work yourself (research, form filling, account creation).
-Delegate it. That's what workers are for.`;
+Do NOT execute tasks directly (research, form filling, account creation, browser automation).
+Stay control-plane only: create workers, delegate, monitor, unblock, report.`;
 function createRoom2(db2, input) {
   const config = { ...DEFAULT_ROOM_CONFIG, ...input.config };
   const room = createRoom(db2, input.name, input.goal, config, input.referredByCode);
@@ -23223,7 +23228,10 @@ async function executeAgent(options) {
     }
     return executeAnthropicApi(options);
   }
-  return executeClaude(options);
+  if (model === "claude" || model.startsWith("claude-")) {
+    return executeClaude(options);
+  }
+  throw new Error(`Unsupported model "${model}". Configure an explicit supported model (claude, codex, openai:*, anthropic:*, gemini:*).`);
 }
 async function executeClaude(options) {
   const execOpts = {
@@ -24862,7 +24870,7 @@ var TOOL_WEB_SEARCH = {
   type: "function",
   function: {
     name: "quoroom_web_search",
-    description: "Search the web. Returns top 5 results.",
+    description: "Search the web. Returns top 5 results. Queen should delegate this to workers first in control-plane mode.",
     parameters: {
       type: "object",
       properties: {
@@ -24876,7 +24884,7 @@ var TOOL_WEB_FETCH = {
   type: "function",
   function: {
     name: "quoroom_web_fetch",
-    description: "Fetch any URL and return its content as clean markdown.",
+    description: "Fetch any URL and return its content as clean markdown. Queen should delegate this to workers first in control-plane mode.",
     parameters: {
       type: "object",
       properties: {
@@ -24890,7 +24898,7 @@ var TOOL_BROWSER = {
   type: "function",
   function: {
     name: "quoroom_browser",
-    description: "Control a headless browser: navigate, click, fill forms, buy services, register domains, create accounts.",
+    description: "Control a headless browser: navigate, click, fill forms, buy services, register domains, create accounts. Queen should delegate this to workers first in control-plane mode.",
     parameters: {
       type: "object",
       properties: {
@@ -25338,6 +25346,12 @@ async function deliverQueenMessage(db2, roomId, question) {
 }
 
 // src/shared/agent-loop.ts
+var QUEEN_EXECUTION_TOOLS = /* @__PURE__ */ new Set([
+  "quoroom_web_search",
+  "quoroom_web_fetch",
+  "quoroom_browser"
+]);
+var QUEEN_POLICY_WIP_HINT = "[policy] Queen control-plane mode: delegate execution tasks to workers with quoroom_delegate_task, then monitor, unblock, and report outcomes. Avoid direct web/browser execution.";
 function isInQuietHours(from14, until) {
   const now = /* @__PURE__ */ new Date();
   const nowMins = now.getHours() * 60 + now.getMinutes();
@@ -25358,7 +25372,34 @@ function msUntilQuietEnd(until) {
   if (end <= now) end.setDate(end.getDate() + 1);
   return end.getTime() - now.getTime();
 }
+function nextAutoExecutorName(workers) {
+  const names = new Set(workers.map((w) => w.name.toLowerCase()));
+  let idx = 1;
+  while (names.has(`executor-${idx}`)) idx++;
+  return `executor-${idx}`;
+}
+function extractToolNameFromConsoleLog(content) {
+  const usingMatch = content.match(/(?:Using|→)\s*([a-zA-Z0-9_]+)/);
+  if (usingMatch?.[1]) return usingMatch[1];
+  const callMatch = content.match(/^([a-zA-Z0-9_]+)\s*\(/);
+  return callMatch?.[1] ?? null;
+}
+function resolveWorkerExecutionModel(db2, roomId, worker) {
+  const explicit = worker.model?.trim();
+  if (explicit) return explicit;
+  const room = getRoom(db2, roomId);
+  if (!room) return null;
+  const roomModel = room.workerModel?.trim();
+  if (!roomModel) return null;
+  if (roomModel !== "queen") return roomModel;
+  if (!room.queenWorkerId) return null;
+  if (room.queenWorkerId === worker.id) return null;
+  const queen = getWorker(db2, room.queenWorkerId);
+  const queenModel = queen?.model?.trim();
+  return queenModel || null;
+}
 var runningLoops = /* @__PURE__ */ new Map();
+var launchedRoomIds = /* @__PURE__ */ new Set();
 var RateLimitError = class extends Error {
   constructor(info) {
     super(`Rate limited: wait ${Math.round(info.waitMs / 1e3)}s`);
@@ -25481,12 +25522,29 @@ function pauseAgent(db2, workerId) {
   }
   updateAgentState(db2, workerId, "idle");
 }
+function setRoomLaunchEnabled(roomId, enabled) {
+  if (enabled) {
+    launchedRoomIds.add(roomId);
+    return;
+  }
+  launchedRoomIds.delete(roomId);
+}
+function isRoomLaunchEnabled(roomId) {
+  return launchedRoomIds.has(roomId);
+}
+function clearRoomLaunchState() {
+  launchedRoomIds.clear();
+}
 function triggerAgent(db2, roomId, workerId, options) {
   const loop = runningLoops.get(workerId);
   if (loop?.running) {
     if (loop.waitAbort) loop.waitAbort.abort();
     return;
   }
+  const canColdStart = options?.allowColdStart === true || isRoomLaunchEnabled(roomId);
+  if (!canColdStart) {
+    return;
+  }
   startAgentLoop(db2, roomId, workerId, options).catch((err) => {
     const msg = err instanceof Error ? err.message : String(err);
     console.error(`Agent loop failed for worker ${workerId}: ${msg}`);
@@ -25534,7 +25592,7 @@ async function runCycle(db2, roomId, worker, maxTurns, options, abortSignal) {
     void 0,
     worker.id
   );
-  const model = worker.model ?? "claude";
+  const model = resolveWorkerExecutionModel(db2, roomId, worker);
   const cycle = createWorkerCycle(db2, worker.id, roomId, model);
   const logBuffer2 = createCycleLogBuffer(
     cycle.id,
@@ -25543,6 +25601,23 @@ async function runCycle(db2, roomId, worker, maxTurns, options, abortSignal) {
   );
   options?.onCycleLifecycle?.("created", cycle.id, roomId);
   try {
+    if (!model) {
+      const msg = "No model configured for this worker. Set an explicit worker model or room worker model.";
+      logBuffer2.addSynthetic("error", msg);
+      logBuffer2.flush();
+      completeWorkerCycle(db2, cycle.id, msg, void 0);
+      options?.onCycleLifecycle?.("failed", cycle.id, roomId);
+      logRoomActivity(
+        db2,
+        roomId,
+        "error",
+        `Agent cycle failed (${worker.name}): model is not configured`,
+        msg,
+        worker.id
+      );
+      updateAgentState(db2, worker.id, "idle");
+      return msg;
+    }
     const provider = getModelProvider(model);
     if (provider === "openai_api" || provider === "anthropic_api" || provider === "gemini_api") {
       const apiKeyCheck = resolveApiKeyForModel(db2, roomId, model);
@@ -25569,10 +25644,44 @@ async function runCycle(db2, roomId, worker, maxTurns, options, abortSignal) {
       status: g.status,
       assignedWorkerId: g.assignedWorkerId
     }));
-    const roomWorkers = listRoomWorkers(db2, roomId);
+    let roomWorkers = listRoomWorkers(db2, roomId);
+    const isQueen = worker.id === status2.room.queenWorkerId;
     const unreadMessages = listRoomMessages(db2, roomId, "unread").slice(0, 5);
+    if (isQueen) {
+      const nonQueenWorkers = roomWorkers.filter((w) => w.id !== worker.id);
+      if (nonQueenWorkers.length === 0) {
+        const autoName = nextAutoExecutorName(roomWorkers);
+        const executorPreset = WORKER_ROLE_PRESETS.executor;
+        const inheritedModel = status2.room.workerModel === "queen" ? model : status2.room.workerModel?.trim();
+        if (!inheritedModel) {
+          const err = "Auto-create skipped: no worker model configured for executor.";
+          logRoomActivity(db2, roomId, "error", err, "Set room worker model or queen model first.", worker.id);
+          logBuffer2.addSynthetic("error", err);
+        } else {
+          createWorker(db2, {
+            name: autoName,
+            role: "executor",
+            roomId,
+            description: "Auto-created executor for queen-delegated execution work.",
+            systemPrompt: "You are the room executor. Complete delegated tasks end-to-end, report concrete results, and save progress with quoroom_save_wip.",
+            model: inheritedModel,
+            cycleGapMs: executorPreset?.cycleGapMs,
+            maxTurns: executorPreset?.maxTurns
+          });
+          logRoomActivity(
+            db2,
+            roomId,
+            "system",
+            `Auto-created worker "${autoName}" for delegation-first execution.`,
+            "Model B (soft): queen coordinates, workers execute.",
+            worker.id
+          );
+          logBuffer2.addSynthetic("system", `Auto-created worker "${autoName}" because queen had no executors.`);
+          roomWorkers = listRoomWorkers(db2, roomId);
+        }
+      }
+    }
     const rolePreset = worker.role ? WORKER_ROLE_PRESETS[worker.role] : void 0;
-    const isQueen = worker.id === status2.room.queenWorkerId;
     const namePrefix = worker.name ? `Your name is ${worker.name}.
 
 ` : "";
@@ -25661,6 +25770,14 @@ At the end of this cycle, call quoroom_save_wip to save your updated position.`)
     if (status2.room.goal) {
       contextParts.push(`## Room Objective
 ${status2.room.goal}`);
+    }
+    if (isQueen) {
+      contextParts.push(`## Queen Controller Contract (Model B)
+- You are the control plane: create workers, delegate tasks, and monitor delivery.
+- If there are no workers besides you, create one executor first.
+- Delegate all execution via quoroom_delegate_task and follow up with worker messages/pokes.
+- Keep governance active: use quoroom_announce for decisions and process objections/votes.
+- Do not perform execution tasks directly unless strictly unavoidable.`);
     }
     if (goalUpdates.length > 0) {
       const workerMap = new Map(roomWorkers.map((w) => [w.id, w.name]));
@@ -25773,9 +25890,34 @@ ${unreadMessages.map(
     const needsQueenTools = model === "openai" || model.startsWith("openai:") || model === "anthropic" || model.startsWith("anthropic:") || model.startsWith("claude-api:");
     const roleToolDefs = isQueen ? QUEEN_TOOLS : WORKER_TOOLS;
     const filteredToolDefs = allowSet ? roleToolDefs.filter((t) => allowSet.has(t.function.name)) : roleToolDefs;
+    const queenExecutionToolsUsed = /* @__PURE__ */ new Set();
+    const trackQueenExecutionTool = (toolName) => {
+      if (!isQueen || !toolName) return;
+      if (QUEEN_EXECUTION_TOOLS.has(toolName)) queenExecutionToolsUsed.add(toolName);
+    };
+    const persistQueenPolicyDeviation = () => {
+      if (!isQueen || queenExecutionToolsUsed.size === 0) return;
+      const used = [...queenExecutionToolsUsed].sort().join(", ");
+      logRoomActivity(
+        db2,
+        roomId,
+        "system",
+        `Queen policy deviation: execution tool use detected (${used}).`,
+        "Model B (soft): queen should delegate execution to workers and remain control-plane focused.",
+        worker.id
+      );
+      const fresh = getWorker(db2, worker.id);
+      const existing = fresh?.wip?.trim() ?? "";
+      if (existing.includes(QUEEN_POLICY_WIP_HINT)) return;
+      const nextWip = existing ? `${existing}
+
+${QUEEN_POLICY_WIP_HINT}` : QUEEN_POLICY_WIP_HINT;
+      updateWorkerWip(db2, worker.id, nextWip.slice(0, 2e3));
+    };
     const apiToolOpts = needsQueenTools ? {
       toolDefs: filteredToolDefs,
       onToolCall: async (toolName, args) => {
+        trackQueenExecutionTool(toolName);
         logBuffer2.addSynthetic("tool_call", `\u2192 ${toolName}(${JSON.stringify(args)})`);
         const result2 = await executeQueenTool(db2, roomId, worker.id, toolName, args);
         logBuffer2.addSynthetic("tool_result", result2.content);
@@ -25789,7 +25931,12 @@ ${unreadMessages.map(
       apiKey,
       timeoutMs: worker.role === "executor" ? 30 * 60 * 1e3 : 15 * 60 * 1e3,
       maxTurns: maxTurns ?? 50,
-      onConsoleLog: logBuffer2.onConsoleLog,
+      onConsoleLog: (entry) => {
+        if (entry.entryType === "tool_call") {
+          trackQueenExecutionTool(extractToolNameFromConsoleLog(entry.content));
+        }
+        logBuffer2.onConsoleLog(entry);
+      },
       // CLI models: block non-quoroom MCP tools (daymon, etc.)
       disallowedTools: isCli ? "mcp__daymon*" : void 0,
       // CLI models: bypass permission prompts for headless operation
@@ -25822,6 +25969,7 @@ ${unreadMessages.map(
       completeWorkerCycle(db2, cycle.id, canceledMessage, result.usage);
       options?.onCycleLifecycle?.("failed", cycle.id, roomId);
       updateAgentState(db2, worker.id, "idle");
+      persistQueenPolicyDeviation();
       return result.output;
     }
     const rateLimitInfo = checkRateLimit(result);
@@ -25850,6 +25998,7 @@ ${unreadMessages.map(
           logBuffer2.flush();
         }
       }
+      persistQueenPolicyDeviation();
       return result.output;
     }
     if (isCli && result.sessionId) {
@@ -25858,6 +26007,7 @@ ${unreadMessages.map(
     if (result.output && model !== "claude" && !model.startsWith("codex")) {
       logBuffer2.addSynthetic("assistant_text", result.output);
     }
+    persistQueenPolicyDeviation();
     logBuffer2.addSynthetic("system", "Cycle completed");
     if (result.usage && (result.usage.inputTokens > 0 || result.usage.outputTokens > 0)) {
       logBuffer2.addSynthetic("system", `Tokens: ${result.usage.inputTokens} in / ${result.usage.outputTokens} out`);
@@ -25908,6 +26058,7 @@ function _stopAllLoops() {
     if (loop.cycleAbort) loop.cycleAbort.abort();
   }
   runningLoops.clear();
+  clearRoomLaunchState();
 }
 
 // src/server/cloud.ts
@@ -28277,13 +28428,10 @@ async function executeClerkTool(db2, toolName, args, ctx) {
         return { content: `Deleted room "${room.name}" (#${room.id}).` };
       }
       case "quoroom_start_queen": {
-        const room = resolveRoom(db2, args);
-        if (!room) return { content: "Error: room not found.", isError: true };
-        if (!room.queenWorkerId) return { content: `Error: room "${room.name}" has no queen worker.`, isError: true };
-        if (room.status !== "active") return { content: `Error: room "${room.name}" is not active.`, isError: true };
-        stopRoomRuntime(db2, room.id, "Runtime reset before queen start");
-        triggerAgent(db2, room.id, room.queenWorkerId);
-        return { content: `Started queen in "${room.name}" (#${room.id}).` };
+        return {
+          content: "Error: direct queen start is disabled. Start the room manually from the Room controls.",
+          isError: true
+        };
       }
       case "quoroom_stop_queen": {
         const room = resolveRoom(db2, args);
@@ -30484,6 +30632,9 @@ async function syncCloudRoomMessages(db2) {
 }
 function startServerRuntime(db2) {
   stopServerRuntime();
+  clearRoomLaunchState();
+  const cleanedCycles = cleanupStaleCycles(db2);
+  if (cleanedCycles > 0) console.log(`Cleaned up ${cleanedCycles} stale worker cycles`);
   ensureClerkContactCheckTasks(db2);
   refreshCronJobs(db2);
   runDueOneTimeTasks(db2);
@@ -30511,30 +30662,8 @@ function startServerRuntime(db2) {
   clerkAlertTimer = setInterval(() => {
     queueClerkAlertRelay(db2);
   }, CLERK_ALERT_RELAY_MS);
-  resumeActiveQueens(db2);
   startCommentaryEngine(db2);
 }
-function makeCycleCallbacks() {
-  return {
-    onCycleLogEntry: (entry) => {
-      eventBus.emit(`cycle:${entry.cycleId}`, "cycle:log", entry);
-    },
-    onCycleLifecycle: (event, cycleId, roomId) => {
-      eventBus.emit(`room:${roomId}`, `cycle:${event}`, { cycleId, roomId });
-    }
-  };
-}
-function resumeActiveQueens(db2) {
-  const cleaned = cleanupStaleCycles(db2);
-  if (cleaned > 0) console.log(`Cleaned up ${cleaned} stale worker cycles`);
-  const rooms = listRooms(db2, "active");
-  const callbacks = makeCycleCallbacks();
-  for (const room of rooms) {
-    if (!room.queenWorkerId) continue;
-    console.log(`Auto-resuming queen for room "${room.name}" (#${room.id})`);
-    triggerAgent(db2, room.id, room.queenWorkerId, callbacks);
-  }
-}
 function stopServerRuntime() {
   stopCommentaryEngine();
   if (schedulerTimer) clearInterval(schedulerTimer);
@@ -30579,6 +30708,16 @@ function emitQueenState(roomId, running) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
 }
+function makeCycleCallbacks(roomId) {
+  return {
+    onCycleLogEntry: (entry) => {
+      eventBus.emit(`cycle:${entry.cycleId}`, "cycle:log", entry);
+    },
+    onCycleLifecycle: (event, cycleId, _roomId) => {
+      eventBus.emit(`room:${roomId}`, `cycle:${event}`, { cycleId, roomId });
+    }
+  };
+}
 function getLocalReferredRooms(db2, roomId) {
   const keeperCode = (getSetting(db2, "keeper_referral_code") ?? "").trim();
   if (!keeperCode) return [];
@@ -30792,11 +30931,8 @@ function registerRoomRoutes(router) {
       }
     }
     if (updates.status === "stopped") {
-      const workers = listRoomWorkers(ctx.db, roomId);
-      for (const w of workers) {
-        updateAgentState(ctx.db, w.id, "idle");
-        pauseAgent(ctx.db, w.id);
-      }
+      setRoomLaunchEnabled(roomId, false);
+      stopRoomRuntime(ctx.db, roomId, "Room archived");
       logRoomActivity(ctx.db, roomId, "system", "Room archived");
     }
     const updated = getRoom(ctx.db, roomId);
@@ -30811,21 +30947,59 @@ function registerRoomRoutes(router) {
     const roomId = Number(ctx.params.id);
     try {
       pauseRoom(ctx.db, roomId);
-      const workers = listRoomWorkers(ctx.db, roomId);
-      for (const w of workers) {
-        pauseAgent(ctx.db, w.id);
-      }
+      setRoomLaunchEnabled(roomId, false);
+      stopRoomRuntime(ctx.db, roomId, "Room stopped by keeper");
       eventBus.emit(`room:${roomId}`, "room:paused", { roomId });
+      eventBus.emit(`room:${roomId}`, "room:queen_stopped", { roomId, running: false });
+      emitQueenState(roomId, false);
       emitRoomsUpdated("room_paused", { roomId });
       return { data: { ok: true } };
     } catch (e) {
       return { status: 404, error: e.message };
     }
   });
+  router.post("/api/rooms/:id/start", (ctx) => {
+    const roomId = Number(ctx.params.id);
+    const room = getRoom(ctx.db, roomId);
+    if (!room) return { status: 404, error: "Room not found" };
+    if (room.status === "stopped") return { status: 400, error: "Room is stopped" };
+    if (!room.queenWorkerId) return { status: 400, error: "No queen worker" };
+    if (room.status !== "active") {
+      updateRoom(ctx.db, roomId, { status: "active" });
+    }
+    setRoomLaunchEnabled(roomId, true);
+    stopRoomRuntime(ctx.db, roomId, "Runtime reset before room start");
+    triggerAgent(ctx.db, roomId, room.queenWorkerId, {
+      ...makeCycleCallbacks(roomId),
+      allowColdStart: true
+    });
+    eventBus.emit(`room:${roomId}`, "room:started", { roomId });
+    eventBus.emit(`room:${roomId}`, "room:queen_started", { roomId, running: true });
+    emitQueenState(roomId, true);
+    emitRoomsUpdated("room_started", { roomId });
+    return { data: { ok: true, running: true } };
+  });
+  router.post("/api/rooms/:id/stop", (ctx) => {
+    const roomId = Number(ctx.params.id);
+    const room = getRoom(ctx.db, roomId);
+    if (!room) return { status: 404, error: "Room not found" };
+    setRoomLaunchEnabled(roomId, false);
+    stopRoomRuntime(ctx.db, roomId, "Room stopped by keeper");
+    if (room.status !== "stopped") {
+      updateRoom(ctx.db, roomId, { status: "paused" });
+    }
+    eventBus.emit(`room:${roomId}`, "room:stopped", { roomId });
+    eventBus.emit(`room:${roomId}`, "room:paused", { roomId });
+    eventBus.emit(`room:${roomId}`, "room:queen_stopped", { roomId, running: false });
+    emitQueenState(roomId, false);
+    emitRoomsUpdated("room_paused", { roomId });
+    return { data: { ok: true, running: false } };
+  });
   router.post("/api/rooms/:id/restart", (ctx) => {
     const roomId = Number(ctx.params.id);
     const { goal } = ctx.body || {};
     try {
+      setRoomLaunchEnabled(roomId, false);
       restartRoom(ctx.db, roomId, goal);
       eventBus.emit(`room:${roomId}`, "room:restarted", { roomId });
       emitRoomsUpdated("room_restarted", { roomId });
@@ -30853,30 +31027,11 @@ function registerRoomRoutes(router) {
       }
     };
   });
-  router.post("/api/rooms/:id/queen/start", (ctx) => {
-    const roomId = Number(ctx.params.id);
-    const room = getRoom(ctx.db, roomId);
-    if (!room) return { status: 404, error: "Room not found" };
-    if (room.status !== "active") return { status: 400, error: "Room is not active" };
-    if (!room.queenWorkerId) return { status: 400, error: "No queen worker" };
-    stopRoomRuntime(ctx.db, roomId, "Runtime reset before queen start");
-    triggerAgent(ctx.db, roomId, room.queenWorkerId, {
-      onCycleLogEntry: (entry) => eventBus.emit(`cycle:${entry.cycleId}`, "cycle:log", entry),
-      onCycleLifecycle: (event, cycleId) => eventBus.emit(`room:${roomId}`, `cycle:${event}`, { cycleId, roomId })
-    });
-    eventBus.emit(`room:${roomId}`, "room:queen_started", { roomId, running: true });
-    emitQueenState(roomId, true);
-    return { data: { ok: true, running: true } };
+  router.post("/api/rooms/:id/queen/start", (_ctx) => {
+    return { status: 410, error: "Deprecated. Use POST /api/rooms/:id/start" };
   });
-  router.post("/api/rooms/:id/queen/stop", (ctx) => {
-    const roomId = Number(ctx.params.id);
-    const room = getRoom(ctx.db, roomId);
-    if (!room) return { status: 404, error: "Room not found" };
-    if (!room.queenWorkerId) return { status: 400, error: "No queen worker" };
-    stopRoomRuntime(ctx.db, roomId, "Queen stopped by keeper");
-    eventBus.emit(`room:${roomId}`, "room:queen_stopped", { roomId, running: false });
-    emitQueenState(roomId, false);
-    return { data: { ok: true, running: false } };
+  router.post("/api/rooms/:id/queen/stop", (_ctx) => {
+    return { status: 410, error: "Deprecated. Use POST /api/rooms/:id/stop" };
   });
   router.get("/api/rooms/:id/cycles", (ctx) => {
     const roomId = Number(ctx.params.id);
@@ -30890,8 +31045,8 @@ function registerRoomRoutes(router) {
     const today = getRoomTokenUsageToday(ctx.db, roomId);
     const room = getRoom(ctx.db, roomId);
     const queenWorker = room?.queenWorkerId ? getWorker(ctx.db, room.queenWorkerId) : null;
-    const model = queenWorker?.model ?? room?.workerModel ?? "claude";
-    const isApiModel = model.startsWith("openai") || model.startsWith("anthropic") || model.startsWith("claude-api");
+    const model = queenWorker?.model ?? room?.workerModel ?? null;
+    const isApiModel = !!model && (model.startsWith("openai") || model.startsWith("anthropic") || model.startsWith("claude-api"));
     return { data: { total, today, isApiModel } };
   });
   router.get("/api/cycles/:id/logs", (ctx) => {
@@ -30904,10 +31059,8 @@ function registerRoomRoutes(router) {
   router.delete("/api/rooms/:id", (ctx) => {
     const roomId = Number(ctx.params.id);
     try {
-      const workers = listRoomWorkers(ctx.db, roomId);
-      for (const w of workers) {
-        pauseAgent(ctx.db, w.id);
-      }
+      setRoomLaunchEnabled(roomId, false);
+      stopRoomRuntime(ctx.db, roomId, "Room deleted");
       deleteRoom2(ctx.db, roomId);
       eventBus.emit(`room:${roomId}`, "room:deleted", { roomId });
       emitRoomsUpdated("room_deleted", { roomId });
@@ -30973,6 +31126,9 @@ function registerWorkerRoutes(router) {
     const room = getRoom(ctx.db, worker.roomId);
     if (!room) return { status: 404, error: "Room not found" };
     if (room.status !== "active") return { status: 400, error: "Room is not active" };
+    if (!isRoomLaunchEnabled(worker.roomId)) {
+      return { status: 409, error: "Room runtime is not started. Start the room first." };
+    }
     triggerAgent(ctx.db, worker.roomId, id, {
       onCycleLogEntry: (entry) => eventBus.emit(`cycle:${entry.cycleId}`, "cycle:log", entry),
       onCycleLifecycle: (event, cycleId) => eventBus.emit(`room:${worker.roomId}`, `cycle:${event}`, { cycleId, roomId: worker.roomId })
@@ -32516,7 +32672,7 @@ function semverGt(a, b) {
 }
 function getCurrentVersion() {
   try {
-    return true ? "0.1.37" : null.version;
+    return true ? "0.1.39" : null.version;
   } catch {
     return "0.0.0";
   }
@@ -32697,7 +32853,7 @@ var cachedVersion = null;
 function getVersion3() {
   if (cachedVersion) return cachedVersion;
   try {
-    cachedVersion = true ? "0.1.37" : null.version;
+    cachedVersion = true ? "0.1.39" : null.version;
   } catch {
     cachedVersion = "unknown";
   }

package/out/mcp/cli.js

@@ -26937,7 +26937,10 @@ async function executeAgent(options) {
     }
     return executeAnthropicApi(options);
   }
-  return executeClaude(options);
+  if (model === "claude" || model.startsWith("claude-")) {
+    return executeClaude(options);
+  }
+  throw new Error(`Unsupported model "${model}". Configure an explicit supported model (claude, codex, openai:*, anthropic:*, gemini:*).`);
 }
 async function executeClaude(options) {
   const execOpts = {
@@ -49454,13 +49457,14 @@ Every cycle:
 1. Check if workers reported results (messages, completed goals)
 2. If work is done \u2192 send results to keeper, take next step
 3. If work is stuck \u2192 help unblock (new instructions, different approach)
-4. If new work needed \u2192 delegate to a worker with clear instructions
-5. If a decision needs input \u2192 announce it (workers can object within 10 min)
+4. If no workers exist yet \u2192 create an executor worker first
+5. If new work is needed \u2192 delegate to a worker with clear instructions, then poke/follow up
+6. If a decision needs input \u2192 announce it and process objections/votes (announce/object flow)
 
 Talk to the keeper regularly \u2014 they are your client.
 
-Do NOT do execution work yourself (research, form filling, account creation).
-Delegate it. That's what workers are for.`;
+Do NOT execute tasks directly (research, form filling, account creation, browser automation).
+Stay control-plane only: create workers, delegate, monitor, unblock, report.`;
   }
 });
 
@@ -52537,7 +52541,7 @@ var server_exports = {};
 async function main() {
   const server = new McpServer({
     name: "quoroom",
-    version: true ? "0.1.37" : "0.0.0"
+    version: true ? "0.1.39" : "0.0.0"
   });
   registerMemoryTools(server);
   registerSchedulerTools(server);
@@ -53428,7 +53432,7 @@ var init_queen_tools = __esm({
       type: "function",
       function: {
         name: "quoroom_web_search",
-        description: "Search the web. Returns top 5 results.",
+        description: "Search the web. Returns top 5 results. Queen should delegate this to workers first in control-plane mode.",
         parameters: {
           type: "object",
           properties: {
@@ -53442,7 +53446,7 @@ var init_queen_tools = __esm({
       type: "function",
       function: {
         name: "quoroom_web_fetch",
-        description: "Fetch any URL and return its content as clean markdown.",
+        description: "Fetch any URL and return its content as clean markdown. Queen should delegate this to workers first in control-plane mode.",
         parameters: {
           type: "object",
           properties: {
@@ -53456,7 +53460,7 @@ var init_queen_tools = __esm({
       type: "function",
       function: {
         name: "quoroom_browser",
-        description: "Control a headless browser: navigate, click, fill forms, buy services, register domains, create accounts.",
+        description: "Control a headless browser: navigate, click, fill forms, buy services, register domains, create accounts. Queen should delegate this to workers first in control-plane mode.",
         parameters: {
           type: "object",
           properties: {
@@ -53617,6 +53621,32 @@ function msUntilQuietEnd(until) {
   if (end <= now) end.setDate(end.getDate() + 1);
   return end.getTime() - now.getTime();
 }
+function nextAutoExecutorName(workers) {
+  const names = new Set(workers.map((w) => w.name.toLowerCase()));
+  let idx = 1;
+  while (names.has(`executor-${idx}`)) idx++;
+  return `executor-${idx}`;
+}
+function extractToolNameFromConsoleLog(content) {
+  const usingMatch = content.match(/(?:Using|→)\s*([a-zA-Z0-9_]+)/);
+  if (usingMatch?.[1]) return usingMatch[1];
+  const callMatch = content.match(/^([a-zA-Z0-9_]+)\s*\(/);
+  return callMatch?.[1] ?? null;
+}
+function resolveWorkerExecutionModel(db3, roomId, worker) {
+  const explicit = worker.model?.trim();
+  if (explicit) return explicit;
+  const room = getRoom(db3, roomId);
+  if (!room) return null;
+  const roomModel = room.workerModel?.trim();
+  if (!roomModel) return null;
+  if (roomModel !== "queen") return roomModel;
+  if (!room.queenWorkerId) return null;
+  if (room.queenWorkerId === worker.id) return null;
+  const queen = getWorker(db3, room.queenWorkerId);
+  const queenModel = queen?.model?.trim();
+  return queenModel || null;
+}
 async function startAgentLoop(db3, roomId, workerId, options) {
   const room = getRoom(db3, roomId);
   if (!room) throw new Error(`Room ${roomId} not found`);
@@ -53732,12 +53762,29 @@ function pauseAgent(db3, workerId) {
   }
   updateAgentState(db3, workerId, "idle");
 }
+function setRoomLaunchEnabled(roomId, enabled) {
+  if (enabled) {
+    launchedRoomIds.add(roomId);
+    return;
+  }
+  launchedRoomIds.delete(roomId);
+}
+function isRoomLaunchEnabled(roomId) {
+  return launchedRoomIds.has(roomId);
+}
+function clearRoomLaunchState() {
+  launchedRoomIds.clear();
+}
 function triggerAgent(db3, roomId, workerId, options) {
   const loop = runningLoops.get(workerId);
   if (loop?.running) {
     if (loop.waitAbort) loop.waitAbort.abort();
     return;
   }
+  const canColdStart = options?.allowColdStart === true || isRoomLaunchEnabled(roomId);
+  if (!canColdStart) {
+    return;
+  }
   startAgentLoop(db3, roomId, workerId, options).catch((err) => {
     const msg = err instanceof Error ? err.message : String(err);
     console.error(`Agent loop failed for worker ${workerId}: ${msg}`);
@@ -53785,7 +53832,7 @@ async function runCycle(db3, roomId, worker, maxTurns, options, abortSignal) {
     void 0,
     worker.id
   );
-  const model = worker.model ?? "claude";
+  const model = resolveWorkerExecutionModel(db3, roomId, worker);
   const cycle = createWorkerCycle(db3, worker.id, roomId, model);
   const logBuffer2 = createCycleLogBuffer(
     cycle.id,
@@ -53794,6 +53841,23 @@ async function runCycle(db3, roomId, worker, maxTurns, options, abortSignal) {
   );
   options?.onCycleLifecycle?.("created", cycle.id, roomId);
   try {
+    if (!model) {
+      const msg = "No model configured for this worker. Set an explicit worker model or room worker model.";
+      logBuffer2.addSynthetic("error", msg);
+      logBuffer2.flush();
+      completeWorkerCycle(db3, cycle.id, msg, void 0);
+      options?.onCycleLifecycle?.("failed", cycle.id, roomId);
+      logRoomActivity(
+        db3,
+        roomId,
+        "error",
+        `Agent cycle failed (${worker.name}): model is not configured`,
+        msg,
+        worker.id
+      );
+      updateAgentState(db3, worker.id, "idle");
+      return msg;
+    }
     const provider = getModelProvider(model);
     if (provider === "openai_api" || provider === "anthropic_api" || provider === "gemini_api") {
       const apiKeyCheck = resolveApiKeyForModel(db3, roomId, model);
@@ -53820,10 +53884,44 @@ async function runCycle(db3, roomId, worker, maxTurns, options, abortSignal) {
       status: g.status,
       assignedWorkerId: g.assignedWorkerId
     }));
-    const roomWorkers = listRoomWorkers(db3, roomId);
+    let roomWorkers = listRoomWorkers(db3, roomId);
+    const isQueen = worker.id === status2.room.queenWorkerId;
     const unreadMessages = listRoomMessages(db3, roomId, "unread").slice(0, 5);
+    if (isQueen) {
+      const nonQueenWorkers = roomWorkers.filter((w) => w.id !== worker.id);
+      if (nonQueenWorkers.length === 0) {
+        const autoName = nextAutoExecutorName(roomWorkers);
+        const executorPreset = WORKER_ROLE_PRESETS.executor;
+        const inheritedModel = status2.room.workerModel === "queen" ? model : status2.room.workerModel?.trim();
+        if (!inheritedModel) {
+          const err = "Auto-create skipped: no worker model configured for executor.";
+          logRoomActivity(db3, roomId, "error", err, "Set room worker model or queen model first.", worker.id);
+          logBuffer2.addSynthetic("error", err);
+        } else {
+          createWorker(db3, {
+            name: autoName,
+            role: "executor",
+            roomId,
+            description: "Auto-created executor for queen-delegated execution work.",
+            systemPrompt: "You are the room executor. Complete delegated tasks end-to-end, report concrete results, and save progress with quoroom_save_wip.",
+            model: inheritedModel,
+            cycleGapMs: executorPreset?.cycleGapMs,
+            maxTurns: executorPreset?.maxTurns
+          });
+          logRoomActivity(
+            db3,
+            roomId,
+            "system",
+            `Auto-created worker "${autoName}" for delegation-first execution.`,
+            "Model B (soft): queen coordinates, workers execute.",
+            worker.id
+          );
+          logBuffer2.addSynthetic("system", `Auto-created worker "${autoName}" because queen had no executors.`);
+          roomWorkers = listRoomWorkers(db3, roomId);
+        }
+      }
+    }
     const rolePreset = worker.role ? WORKER_ROLE_PRESETS[worker.role] : void 0;
-    const isQueen = worker.id === status2.room.queenWorkerId;
     const namePrefix = worker.name ? `Your name is ${worker.name}.
 
 ` : "";
@@ -53912,6 +54010,14 @@ At the end of this cycle, call quoroom_save_wip to save your updated position.`)
     if (status2.room.goal) {
       contextParts.push(`## Room Objective
 ${status2.room.goal}`);
+    }
+    if (isQueen) {
+      contextParts.push(`## Queen Controller Contract (Model B)
+- You are the control plane: create workers, delegate tasks, and monitor delivery.
+- If there are no workers besides you, create one executor first.
+- Delegate all execution via quoroom_delegate_task and follow up with worker messages/pokes.
+- Keep governance active: use quoroom_announce for decisions and process objections/votes.
+- Do not perform execution tasks directly unless strictly unavoidable.`);
     }
     if (goalUpdates.length > 0) {
       const workerMap = new Map(roomWorkers.map((w) => [w.id, w.name]));
@@ -54024,9 +54130,34 @@ ${unreadMessages.map(
     const needsQueenTools = model === "openai" || model.startsWith("openai:") || model === "anthropic" || model.startsWith("anthropic:") || model.startsWith("claude-api:");
     const roleToolDefs = isQueen ? QUEEN_TOOLS : WORKER_TOOLS;
     const filteredToolDefs = allowSet ? roleToolDefs.filter((t) => allowSet.has(t.function.name)) : roleToolDefs;
+    const queenExecutionToolsUsed = /* @__PURE__ */ new Set();
+    const trackQueenExecutionTool = (toolName) => {
+      if (!isQueen || !toolName) return;
+      if (QUEEN_EXECUTION_TOOLS.has(toolName)) queenExecutionToolsUsed.add(toolName);
+    };
+    const persistQueenPolicyDeviation = () => {
+      if (!isQueen || queenExecutionToolsUsed.size === 0) return;
+      const used = [...queenExecutionToolsUsed].sort().join(", ");
+      logRoomActivity(
+        db3,
+        roomId,
+        "system",
+        `Queen policy deviation: execution tool use detected (${used}).`,
+        "Model B (soft): queen should delegate execution to workers and remain control-plane focused.",
+        worker.id
+      );
+      const fresh = getWorker(db3, worker.id);
+      const existing = fresh?.wip?.trim() ?? "";
+      if (existing.includes(QUEEN_POLICY_WIP_HINT)) return;
+      const nextWip = existing ? `${existing}
+
+${QUEEN_POLICY_WIP_HINT}` : QUEEN_POLICY_WIP_HINT;
+      updateWorkerWip(db3, worker.id, nextWip.slice(0, 2e3));
+    };
     const apiToolOpts = needsQueenTools ? {
       toolDefs: filteredToolDefs,
       onToolCall: async (toolName, args2) => {
+        trackQueenExecutionTool(toolName);
         logBuffer2.addSynthetic("tool_call", `\u2192 ${toolName}(${JSON.stringify(args2)})`);
         const result2 = await executeQueenTool(db3, roomId, worker.id, toolName, args2);
         logBuffer2.addSynthetic("tool_result", result2.content);
@@ -54040,7 +54171,12 @@ ${unreadMessages.map(
       apiKey,
       timeoutMs: worker.role === "executor" ? 30 * 60 * 1e3 : 15 * 60 * 1e3,
       maxTurns: maxTurns ?? 50,
-      onConsoleLog: logBuffer2.onConsoleLog,
+      onConsoleLog: (entry) => {
+        if (entry.entryType === "tool_call") {
+          trackQueenExecutionTool(extractToolNameFromConsoleLog(entry.content));
+        }
+        logBuffer2.onConsoleLog(entry);
+      },
       // CLI models: block non-quoroom MCP tools (daymon, etc.)
       disallowedTools: isCli ? "mcp__daymon*" : void 0,
       // CLI models: bypass permission prompts for headless operation
@@ -54073,6 +54209,7 @@ ${unreadMessages.map(
       completeWorkerCycle(db3, cycle.id, canceledMessage, result.usage);
       options?.onCycleLifecycle?.("failed", cycle.id, roomId);
       updateAgentState(db3, worker.id, "idle");
+      persistQueenPolicyDeviation();
       return result.output;
     }
     const rateLimitInfo = checkRateLimit(result);
@@ -54101,6 +54238,7 @@ ${unreadMessages.map(
           logBuffer2.flush();
         }
       }
+      persistQueenPolicyDeviation();
       return result.output;
     }
     if (isCli && result.sessionId) {
@@ -54109,6 +54247,7 @@ ${unreadMessages.map(
     if (result.output && model !== "claude" && !model.startsWith("codex")) {
       logBuffer2.addSynthetic("assistant_text", result.output);
     }
+    persistQueenPolicyDeviation();
     logBuffer2.addSynthetic("system", "Cycle completed");
     if (result.usage && (result.usage.inputTokens > 0 || result.usage.outputTokens > 0)) {
       logBuffer2.addSynthetic("system", `Tokens: ${result.usage.inputTokens} in / ${result.usage.outputTokens} out`);
@@ -54159,8 +54298,9 @@ function _stopAllLoops() {
     if (loop.cycleAbort) loop.cycleAbort.abort();
   }
   runningLoops.clear();
+  clearRoomLaunchState();
 }
-var runningLoops, RateLimitError;
+var QUEEN_EXECUTION_TOOLS, QUEEN_POLICY_WIP_HINT, runningLoops, launchedRoomIds, RateLimitError;
 var init_agent_loop = __esm({
   "src/shared/agent-loop.ts"() {
     "use strict";
@@ -54173,7 +54313,14 @@ var init_agent_loop = __esm({
     init_console_log_buffer();
     init_queen_tools();
     init_constants();
+    QUEEN_EXECUTION_TOOLS = /* @__PURE__ */ new Set([
+      "quoroom_web_search",
+      "quoroom_web_fetch",
+      "quoroom_browser"
+    ]);
+    QUEEN_POLICY_WIP_HINT = "[policy] Queen control-plane mode: delegate execution tasks to workers with quoroom_delegate_task, then monitor, unblock, and report outcomes. Avoid direct web/browser execution.";
     runningLoops = /* @__PURE__ */ new Map();
+    launchedRoomIds = /* @__PURE__ */ new Set();
     RateLimitError = class extends Error {
       constructor(info) {
         super(`Rate limited: wait ${Math.round(info.waitMs / 1e3)}s`);
@@ -54189,7 +54336,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "quoroom",
-      version: "0.1.37",
+      version: "0.1.39",
       description: "Open-source local AI agent framework \u2014 Queen, Workers, Quorum. Experimental research tool.",
       main: "./out/mcp/server.js",
       bin: {
@@ -54219,16 +54366,20 @@ var require_package = __commonJS({
         "kill:quoroom-runtime": "node scripts/kill-quoroom-runtime.js",
         "kill:dev-runtime": "npm run kill:dev-ports && npm run kill:quoroom-runtime",
         "dev:links": "node scripts/dev-links.js",
-        dev: `sh -c 'npm run kill:dev-runtime && trap "kill 0" INT TERM EXIT; npm run dev:links & npm run dev:room & npm run dev:cloud & wait'`,
+        dev: "node scripts/run-dev.js",
         "dev:win": "node scripts/run-dev.js",
+        "dev:with-cloud": "node scripts/run-dev.js --with-cloud",
+        "dev:with-cloud:win": "node scripts/run-dev.js --with-cloud",
         "dev:room": "sh -c 'npm run kill:dev-runtime && export QUOROOM_DATA_DIR=$HOME/.quoroom-dev QUOROOM_SKIP_MCP_REGISTER=1; npm run build:mcp && npm run build:ui && node scripts/dev-server.js --port 4700'",
         "dev:room:win": "node scripts/dev-room.js --port 4700",
         "dev:room:isolated:win": "node scripts/dev-room.js --isolated --port 4700",
         "dev:room:isolated": "sh -c 'npm run kill:dev-runtime && export QUOROOM_DATA_DIR=$HOME/.quoroom-dev QUOROOM_SKIP_MCP_REGISTER=1; npm run build:mcp && npm run build:ui && node scripts/dev-server.js --port 4700'",
         "dev:room:shared": "npm run kill:dev-runtime && npm run build:mcp && npm run build:ui && node scripts/dev-server.js",
         "doctor:split": "node scripts/doctor-split.js",
-        "dev:isolated": `sh -c 'npm run kill:dev-runtime && trap "kill 0" INT TERM EXIT; npm run dev:links & npm run dev:room:isolated & npm run dev:cloud & VITE_API_PORT=4700 npm run dev:ui & wait'`,
+        "dev:isolated": "node scripts/run-dev.js --isolated",
         "dev:isolated:win": "node scripts/run-dev.js --isolated",
+        "dev:isolated:with-cloud": "node scripts/run-dev.js --isolated --with-cloud",
+        "dev:isolated:with-cloud:win": "node scripts/run-dev.js --isolated --with-cloud",
         "dev:cloud": `sh -c 'npm run kill:ports -- 3715 && cd ../cloud && PORT=3715 CLOUD_PUBLIC_URL=http://127.0.0.1:3715 CLOUD_ALLOWED_ORIGINS='"'"'http://127.0.0.1:3715,http://localhost:3715,http://localhost:5173,http://127.0.0.1:5173,https://quoroom.ai,https://www.quoroom.ai,https://app.quoroom.ai'"'"' npm start'`,
         "dev:cloud:win": "node scripts/dev-cloud.js",
         "dev:ui": "vite --config src/ui/vite.config.ts",
@@ -55681,13 +55832,10 @@ async function executeClerkTool(db3, toolName, args2, ctx) {
         return { content: `Deleted room "${room.name}" (#${room.id}).` };
       }
       case "quoroom_start_queen": {
-        const room = resolveRoom(db3, args2);
-        if (!room) return { content: "Error: room not found.", isError: true };
-        if (!room.queenWorkerId) return { content: `Error: room "${room.name}" has no queen worker.`, isError: true };
-        if (room.status !== "active") return { content: `Error: room "${room.name}" is not active.`, isError: true };
-        stopRoomRuntime(db3, room.id, "Runtime reset before queen start");
-        triggerAgent(db3, room.id, room.queenWorkerId);
-        return { content: `Started queen in "${room.name}" (#${room.id}).` };
+        return {
+          content: "Error: direct queen start is disabled. Start the room manually from the Room controls.",
+          isError: true
+        };
       }
       case "quoroom_stop_queen": {
         const room = resolveRoom(db3, args2);
@@ -58256,6 +58404,9 @@ async function syncCloudRoomMessages(db3) {
 }
 function startServerRuntime(db3) {
   stopServerRuntime();
+  clearRoomLaunchState();
+  const cleanedCycles = cleanupStaleCycles(db3);
+  if (cleanedCycles > 0) console.log(`Cleaned up ${cleanedCycles} stale worker cycles`);
   ensureClerkContactCheckTasks(db3);
   refreshCronJobs(db3);
   runDueOneTimeTasks(db3);
@@ -58283,30 +58434,8 @@ function startServerRuntime(db3) {
   clerkAlertTimer = setInterval(() => {
     queueClerkAlertRelay(db3);
   }, CLERK_ALERT_RELAY_MS);
-  resumeActiveQueens(db3);
   startCommentaryEngine(db3);
 }
-function makeCycleCallbacks() {
-  return {
-    onCycleLogEntry: (entry) => {
-      eventBus.emit(`cycle:${entry.cycleId}`, "cycle:log", entry);
-    },
-    onCycleLifecycle: (event, cycleId, roomId) => {
-      eventBus.emit(`room:${roomId}`, `cycle:${event}`, { cycleId, roomId });
-    }
-  };
-}
-function resumeActiveQueens(db3) {
-  const cleaned = cleanupStaleCycles(db3);
-  if (cleaned > 0) console.log(`Cleaned up ${cleaned} stale worker cycles`);
-  const rooms = listRooms(db3, "active");
-  const callbacks = makeCycleCallbacks();
-  for (const room of rooms) {
-    if (!room.queenWorkerId) continue;
-    console.log(`Auto-resuming queen for room "${room.name}" (#${room.id})`);
-    triggerAgent(db3, room.id, room.queenWorkerId, callbacks);
-  }
-}
 function stopServerRuntime() {
   stopCommentaryEngine();
   if (schedulerTimer) clearInterval(schedulerTimer);
@@ -58387,6 +58516,16 @@ function emitQueenState(roomId, running) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
 }
+function makeCycleCallbacks(roomId) {
+  return {
+    onCycleLogEntry: (entry) => {
+      eventBus.emit(`cycle:${entry.cycleId}`, "cycle:log", entry);
+    },
+    onCycleLifecycle: (event, cycleId, _roomId) => {
+      eventBus.emit(`room:${roomId}`, `cycle:${event}`, { cycleId, roomId });
+    }
+  };
+}
 function getLocalReferredRooms(db3, roomId) {
   const keeperCode = (getSetting(db3, "keeper_referral_code") ?? "").trim();
   if (!keeperCode) return [];
@@ -58600,11 +58739,8 @@ function registerRoomRoutes(router) {
       }
     }
     if (updates.status === "stopped") {
-      const workers = listRoomWorkers(ctx.db, roomId);
-      for (const w of workers) {
-        updateAgentState(ctx.db, w.id, "idle");
-        pauseAgent(ctx.db, w.id);
-      }
+      setRoomLaunchEnabled(roomId, false);
+      stopRoomRuntime(ctx.db, roomId, "Room archived");
       logRoomActivity(ctx.db, roomId, "system", "Room archived");
     }
     const updated = getRoom(ctx.db, roomId);
@@ -58619,21 +58755,59 @@ function registerRoomRoutes(router) {
     const roomId = Number(ctx.params.id);
     try {
       pauseRoom(ctx.db, roomId);
-      const workers = listRoomWorkers(ctx.db, roomId);
-      for (const w of workers) {
-        pauseAgent(ctx.db, w.id);
-      }
+      setRoomLaunchEnabled(roomId, false);
+      stopRoomRuntime(ctx.db, roomId, "Room stopped by keeper");
       eventBus.emit(`room:${roomId}`, "room:paused", { roomId });
+      eventBus.emit(`room:${roomId}`, "room:queen_stopped", { roomId, running: false });
+      emitQueenState(roomId, false);
       emitRoomsUpdated("room_paused", { roomId });
       return { data: { ok: true } };
     } catch (e) {
       return { status: 404, error: e.message };
     }
   });
+  router.post("/api/rooms/:id/start", (ctx) => {
+    const roomId = Number(ctx.params.id);
+    const room = getRoom(ctx.db, roomId);
+    if (!room) return { status: 404, error: "Room not found" };
+    if (room.status === "stopped") return { status: 400, error: "Room is stopped" };
+    if (!room.queenWorkerId) return { status: 400, error: "No queen worker" };
+    if (room.status !== "active") {
+      updateRoom(ctx.db, roomId, { status: "active" });
+    }
+    setRoomLaunchEnabled(roomId, true);
+    stopRoomRuntime(ctx.db, roomId, "Runtime reset before room start");
+    triggerAgent(ctx.db, roomId, room.queenWorkerId, {
+      ...makeCycleCallbacks(roomId),
+      allowColdStart: true
+    });
+    eventBus.emit(`room:${roomId}`, "room:started", { roomId });
+    eventBus.emit(`room:${roomId}`, "room:queen_started", { roomId, running: true });
+    emitQueenState(roomId, true);
+    emitRoomsUpdated("room_started", { roomId });
+    return { data: { ok: true, running: true } };
+  });
+  router.post("/api/rooms/:id/stop", (ctx) => {
+    const roomId = Number(ctx.params.id);
+    const room = getRoom(ctx.db, roomId);
+    if (!room) return { status: 404, error: "Room not found" };
+    setRoomLaunchEnabled(roomId, false);
+    stopRoomRuntime(ctx.db, roomId, "Room stopped by keeper");
+    if (room.status !== "stopped") {
+      updateRoom(ctx.db, roomId, { status: "paused" });
+    }
+    eventBus.emit(`room:${roomId}`, "room:stopped", { roomId });
+    eventBus.emit(`room:${roomId}`, "room:paused", { roomId });
+    eventBus.emit(`room:${roomId}`, "room:queen_stopped", { roomId, running: false });
+    emitQueenState(roomId, false);
+    emitRoomsUpdated("room_paused", { roomId });
+    return { data: { ok: true, running: false } };
+  });
   router.post("/api/rooms/:id/restart", (ctx) => {
     const roomId = Number(ctx.params.id);
     const { goal } = ctx.body || {};
     try {
+      setRoomLaunchEnabled(roomId, false);
       restartRoom(ctx.db, roomId, goal);
       eventBus.emit(`room:${roomId}`, "room:restarted", { roomId });
       emitRoomsUpdated("room_restarted", { roomId });
@@ -58661,30 +58835,11 @@ function registerRoomRoutes(router) {
       }
     };
   });
-  router.post("/api/rooms/:id/queen/start", (ctx) => {
-    const roomId = Number(ctx.params.id);
-    const room = getRoom(ctx.db, roomId);
-    if (!room) return { status: 404, error: "Room not found" };
-    if (room.status !== "active") return { status: 400, error: "Room is not active" };
-    if (!room.queenWorkerId) return { status: 400, error: "No queen worker" };
-    stopRoomRuntime(ctx.db, roomId, "Runtime reset before queen start");
-    triggerAgent(ctx.db, roomId, room.queenWorkerId, {
-      onCycleLogEntry: (entry) => eventBus.emit(`cycle:${entry.cycleId}`, "cycle:log", entry),
-      onCycleLifecycle: (event, cycleId) => eventBus.emit(`room:${roomId}`, `cycle:${event}`, { cycleId, roomId })
-    });
-    eventBus.emit(`room:${roomId}`, "room:queen_started", { roomId, running: true });
-    emitQueenState(roomId, true);
-    return { data: { ok: true, running: true } };
+  router.post("/api/rooms/:id/queen/start", (_ctx) => {
+    return { status: 410, error: "Deprecated. Use POST /api/rooms/:id/start" };
   });
-  router.post("/api/rooms/:id/queen/stop", (ctx) => {
-    const roomId = Number(ctx.params.id);
-    const room = getRoom(ctx.db, roomId);
-    if (!room) return { status: 404, error: "Room not found" };
-    if (!room.queenWorkerId) return { status: 400, error: "No queen worker" };
-    stopRoomRuntime(ctx.db, roomId, "Queen stopped by keeper");
-    eventBus.emit(`room:${roomId}`, "room:queen_stopped", { roomId, running: false });
-    emitQueenState(roomId, false);
-    return { data: { ok: true, running: false } };
+  router.post("/api/rooms/:id/queen/stop", (_ctx) => {
+    return { status: 410, error: "Deprecated. Use POST /api/rooms/:id/stop" };
   });
   router.get("/api/rooms/:id/cycles", (ctx) => {
     const roomId = Number(ctx.params.id);
@@ -58698,8 +58853,8 @@ function registerRoomRoutes(router) {
     const today = getRoomTokenUsageToday(ctx.db, roomId);
     const room = getRoom(ctx.db, roomId);
     const queenWorker = room?.queenWorkerId ? getWorker(ctx.db, room.queenWorkerId) : null;
-    const model = queenWorker?.model ?? room?.workerModel ?? "claude";
-    const isApiModel = model.startsWith("openai") || model.startsWith("anthropic") || model.startsWith("claude-api");
+    const model = queenWorker?.model ?? room?.workerModel ?? null;
+    const isApiModel = !!model && (model.startsWith("openai") || model.startsWith("anthropic") || model.startsWith("claude-api"));
     return { data: { total, today, isApiModel } };
   });
   router.get("/api/cycles/:id/logs", (ctx) => {
@@ -58712,10 +58867,8 @@ function registerRoomRoutes(router) {
   router.delete("/api/rooms/:id", (ctx) => {
     const roomId = Number(ctx.params.id);
     try {
-      const workers = listRoomWorkers(ctx.db, roomId);
-      for (const w of workers) {
-        pauseAgent(ctx.db, w.id);
-      }
+      setRoomLaunchEnabled(roomId, false);
+      stopRoomRuntime(ctx.db, roomId, "Room deleted");
       deleteRoom2(ctx.db, roomId);
       eventBus.emit(`room:${roomId}`, "room:deleted", { roomId });
       emitRoomsUpdated("room_deleted", { roomId });
@@ -58795,6 +58948,9 @@ function registerWorkerRoutes(router) {
     const room = getRoom(ctx.db, worker.roomId);
     if (!room) return { status: 404, error: "Room not found" };
     if (room.status !== "active") return { status: 400, error: "Room is not active" };
+    if (!isRoomLaunchEnabled(worker.roomId)) {
+      return { status: 409, error: "Room runtime is not started. Start the room first." };
+    }
     triggerAgent(ctx.db, worker.roomId, id, {
       onCycleLogEntry: (entry) => eventBus.emit(`cycle:${entry.cycleId}`, "cycle:log", entry),
       onCycleLifecycle: (event, cycleId) => eventBus.emit(`room:${worker.roomId}`, `cycle:${event}`, { cycleId, roomId: worker.roomId })
@@ -59755,7 +59911,7 @@ function semverGt(a, b) {
 }
 function getCurrentVersion() {
   try {
-    return true ? "0.1.37" : null.version;
+    return true ? "0.1.39" : null.version;
   } catch {
     return "0.0.0";
   }
@@ -59962,7 +60118,7 @@ var init_updateChecker = __esm({
 function getVersion3() {
   if (cachedVersion) return cachedVersion;
   try {
-    cachedVersion = true ? "0.1.37" : null.version;
+    cachedVersion = true ? "0.1.39" : null.version;
   } catch {
     cachedVersion = "unknown";
   }
@@ -66228,7 +66384,7 @@ __export(update_exports, {
 });
 function getCurrentVersion2() {
   try {
-    return true ? "0.1.37" : null.version;
+    return true ? "0.1.39" : null.version;
   } catch {
     return "0.0.0";
   }

package/out/mcp/server.js

@@ -46264,13 +46264,14 @@ Every cycle:
 1. Check if workers reported results (messages, completed goals)
 2. If work is done \u2192 send results to keeper, take next step
 3. If work is stuck \u2192 help unblock (new instructions, different approach)
-4. If new work needed \u2192 delegate to a worker with clear instructions
-5. If a decision needs input \u2192 announce it (workers can object within 10 min)
+4. If no workers exist yet \u2192 create an executor worker first
+5. If new work is needed \u2192 delegate to a worker with clear instructions, then poke/follow up
+6. If a decision needs input \u2192 announce it and process objections/votes (announce/object flow)
 
 Talk to the keeper regularly \u2014 they are your client.
 
-Do NOT do execution work yourself (research, form filling, account creation).
-Delegate it. That's what workers are for.`;
+Do NOT execute tasks directly (research, form filling, account creation, browser automation).
+Stay control-plane only: create workers, delegate, monitor, unblock, report.`;
 function createRoom2(db2, input) {
   const config2 = { ...DEFAULT_ROOM_CONFIG, ...input.config };
   const room = createRoom(db2, input.name, input.goal, config2, input.referredByCode);
@@ -49085,7 +49086,7 @@ init_db();
 async function main() {
   const server = new McpServer({
     name: "quoroom",
-    version: true ? "0.1.37" : "0.0.0"
+    version: true ? "0.1.39" : "0.0.0"
   });
   registerMemoryTools(server);
   registerSchedulerTools(server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quoroom",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "description": "Open-source local AI agent framework — Queen, Workers, Quorum. Experimental research tool.",
   "main": "./out/mcp/server.js",
   "bin": {
@@ -30,16 +30,20 @@
     "kill:quoroom-runtime": "node scripts/kill-quoroom-runtime.js",
     "kill:dev-runtime": "npm run kill:dev-ports && npm run kill:quoroom-runtime",
     "dev:links": "node scripts/dev-links.js",
-    "dev": "sh -c 'npm run kill:dev-runtime && trap \"kill 0\" INT TERM EXIT; npm run dev:links & npm run dev:room & npm run dev:cloud & wait'",
+    "dev": "node scripts/run-dev.js",
     "dev:win": "node scripts/run-dev.js",
+    "dev:with-cloud": "node scripts/run-dev.js --with-cloud",
+    "dev:with-cloud:win": "node scripts/run-dev.js --with-cloud",
     "dev:room": "sh -c 'npm run kill:dev-runtime && export QUOROOM_DATA_DIR=$HOME/.quoroom-dev QUOROOM_SKIP_MCP_REGISTER=1; npm run build:mcp && npm run build:ui && node scripts/dev-server.js --port 4700'",
     "dev:room:win": "node scripts/dev-room.js --port 4700",
     "dev:room:isolated:win": "node scripts/dev-room.js --isolated --port 4700",
     "dev:room:isolated": "sh -c 'npm run kill:dev-runtime && export QUOROOM_DATA_DIR=$HOME/.quoroom-dev QUOROOM_SKIP_MCP_REGISTER=1; npm run build:mcp && npm run build:ui && node scripts/dev-server.js --port 4700'",
     "dev:room:shared": "npm run kill:dev-runtime && npm run build:mcp && npm run build:ui && node scripts/dev-server.js",
     "doctor:split": "node scripts/doctor-split.js",
-    "dev:isolated": "sh -c 'npm run kill:dev-runtime && trap \"kill 0\" INT TERM EXIT; npm run dev:links & npm run dev:room:isolated & npm run dev:cloud & VITE_API_PORT=4700 npm run dev:ui & wait'",
+    "dev:isolated": "node scripts/run-dev.js --isolated",
     "dev:isolated:win": "node scripts/run-dev.js --isolated",
+    "dev:isolated:with-cloud": "node scripts/run-dev.js --isolated --with-cloud",
+    "dev:isolated:with-cloud:win": "node scripts/run-dev.js --isolated --with-cloud",
     "dev:cloud": "sh -c 'npm run kill:ports -- 3715 && cd ../cloud && PORT=3715 CLOUD_PUBLIC_URL=http://127.0.0.1:3715 CLOUD_ALLOWED_ORIGINS='\"'\"'http://127.0.0.1:3715,http://localhost:3715,http://localhost:5173,http://127.0.0.1:5173,https://quoroom.ai,https://www.quoroom.ai,https://app.quoroom.ai'\"'\"' npm start'",
     "dev:cloud:win": "node scripts/dev-cloud.js",
     "dev:ui": "vite --config src/ui/vite.config.ts",