@codeagentswarm/cas-cloud 0.0.12 → 0.0.16

package/dist/cas.js

@@ -14842,33 +14842,30 @@ CodeAgentSwarm shows two different things per agent:
    the context stays clear at a glance \u2014 name the feature, NOT a low-level step or file,
    and NOT a work PHASE (testing, e2e, validating, reviewing, deploying). Running the e2e
    suite for a settings redesign is titled "Settings Redesign", never "Settings E2E Tests".
-   Examples: "Promo Video for Twitter", "Minimize Agents". You set it ONCE at the start
-   and it almost never changes \u2014 the ONLY reasons to set it again are refining it when the
-   goal evolves, or REPLACING it when the agent pivots to a completely different topic.
+   Derive it from the **first user request** that established this conversation's
+   functionality and set it ONCE per conversation. It stays stable across follow-ups,
+   new turns, tasks, reviews, tests, validation, finishing, and context compaction.
 2. **Current activity** = the product-focused step you are doing RIGHT NOW. Example:
    "Implementing the analytics tracking backend". It is shown only when the user hovers
    the agent, and it accumulates as the activity log behind the clock button.
 
 ## \u{1F4E2} THE RULE
 
-**\u{1F6A6} FIRST ACTION when you start working in an agent:** set the GENERAL title right away,
-before anything else, so the agent is NEVER without info. It is ALWAYS safe to call \u2014 if
-the user manually renamed the agent the app keeps their name (a manual rename always wins
-over an MCP title). Never leave an agent with no meaningful title.
+**\u{1F6A6} FIRST ACTION in a new conversation:** set the GENERAL title from the first user
+request. On later turns, do NOT call \`set_terminal_title\`; update activity instead.
 
 **\u{1F4CD} ALWAYS leave a CURRENT SUMMARY before acting.** Right after the title, call
 \`update_terminal_activity\` with your first product-focused step, BEFORE running any other
 tool. If an agent has no activity yet, set one before you do anything else \u2014 so at every
 moment the user can see what each agent is doing. Never start working with no activity set.
 
-**At the START of work \u2192 set the GENERAL title ONCE. As you work \u2192 update the ACTIVITY often.**
+**First request \u2192 set the title ONCE. Every turn \u2192 update the ACTIVITY.**
 
-- \u2705 Set the general title once so the user always knows, at a glance, what this agent
-  is for. Set it again only to REFINE it when the overall goal changes (e.g. the user
-  expands the feature), or to REPLACE it when the topic changes RADICALLY.
+- \u2705 Keep the title from the first user request. Refining, extending, fixing, reviewing,
+  validating, or finishing that request changes the activity, not the title.
 - \u2705 RADICAL topic change \u2192 NEW general title, MANDATORY. When the user switches this
   agent to a completely different topic (e.g. from "Minimize Agents" to preparing
-  a release), call \`set_terminal_title\` again with the new topic. Updating only the
+  a release), call \`set_terminal_title\` again with \`replace_existing=true\`. Updating only the
   activity and leaving the old title is WRONG: the tab would keep describing work that
   is no longer happening.
 - \u2705 Update the activity every time your focus moves to a new step. This is what the user
@@ -14882,7 +14879,7 @@ the app's own static UI stays in English; these agent-written labels follow the
 
 **\u{1F527} THE TWO TOOLS:**
 \`\`\`
-# 1) ONCE at the start - the sticky, product-level tab title
+# 1) ONCE on the conversation's first request - the sticky tab title
 mcp__codeagentswarm-tasks__set_terminal_title(
     title="Promo Video",
     long_title="Promotional video for the Twitter launch"
@@ -14903,9 +14900,8 @@ mcp__codeagentswarm-tasks__update_terminal_activity(
   in the tab. \`long_title\` is the **GOAL**: one sentence on what this agent is FOR \u2014 the
   outcome the work aims at, not the step you are on. The user reads it in the hover under
   the title, labelled GOAL, and it is the ONLY place that answers "why does this agent
-  exist"; six words cannot carry that. Sticky: set once, refine rarely \u2014 but ALWAYS set a
-  fresh one when the agent pivots to a completely different topic. Never describe a
-  single step here.
+  exist"; six words cannot carry that. Repeated calls preserve the first title. Pass
+  \`replace_existing=true\` only after the user pivots to completely different functionality.
   \`\`\`
   \u2705 title="Orden notificaci\xF3n"
      long_title="Que las notificaciones no salgan antes de que cambie el status del agente"
@@ -14931,7 +14927,7 @@ mcp__codeagentswarm-tasks__update_terminal_activity(
 1. find_related_active_tasks(...)        \u2190 Check first
 2. create_task(...)                      \u2190 If needed
 3. start_task(task_id=123)
-4. set_terminal_title(                    \u2190 ONCE, AFTER start_task (captures task_id)
+4. set_terminal_title(                    \u2190 only if this conversation has no title
      title="Minimize Agents",
      long_title="Add the ability to minimize and restore agents"
    )
@@ -14940,7 +14936,7 @@ mcp__codeagentswarm-tasks__update_terminal_activity(
 7. ...keep calling update_terminal_activity as your focus moves to new steps...
 \`\`\`
 
-**\u{1F6A8} CRITICAL:** call set_terminal_title AFTER start_task so the task_id is captured.
+**\u{1F6A8} CRITICAL:** starting another task in the same conversation does not justify retitling it.
 
 ### \u2705 WITHOUT A TASK (research/investigation):
 \`\`\`
@@ -14959,13 +14955,10 @@ update_terminal_activity(activity="Implementing restore-from-minimized")
 update_terminal_activity(activity="Persisting minimized state across restarts")
 \`\`\`
 
-### \u2705 THE GOAL ITSELF CHANGES \u2192 refine the GENERAL title (rare):
+### \u2705 THE ORIGINAL GOAL EXPANDS \u2192 keep the title and update ACTIVITY:
 \`\`\`
-# The user expanded the feature, so the product goal genuinely changed:
-set_terminal_title(
-  title="Minimize & Restore",
-  long_title="Minimize agents and restore them later from a tray"
-)
+# The user expanded the same feature; the first title remains "Minimize Agents":
+update_terminal_activity(activity="Adding restore from the tray")
 \`\`\`
 
 ### \u2705 RADICAL TOPIC CHANGE \u2192 set a NEW general title (mandatory):
@@ -14974,7 +14967,8 @@ set_terminal_title(
 User: "leave that, now let's prepare the release notes"
 set_terminal_title(
   title="Release Notes",
-  long_title="Preparing the release notes for the next version"
+  long_title="Preparing the release notes for the next version",
+  replace_existing=true
 )
 update_terminal_activity(activity="Drafting the release notes")
 # \u274C WRONG: calling only update_terminal_activity here \u2014 the tab would still
@@ -14983,9 +14977,8 @@ update_terminal_activity(activity="Drafting the release notes")
 
 ## \u26A0\uFE0F WHEN TO USE WHICH
 
-- **General title (set_terminal_title):** once at the start; again when the overall
-  goal/feature changes or the topic changes radically. Aim for very few calls per
-  session \u2014 but NEVER leave a stale title on an agent that moved to another topic.
+- **General title (set_terminal_title):** once per conversation from the first request.
+  Replace only after a radical functionality pivot, with \`replace_existing=true\`.
 - **Current activity (update_terminal_activity):** every time you move to a new product
   step. Call it freely - it never disturbs the tab.
 
@@ -15063,14 +15056,14 @@ update_terminal_activity(activity="Investigating the output handler cost")    \u
 **Bad 3 - Never setting a general title:**
 \`\`\`
 # Only calling update_terminal_activity, so the tab never gets a product label.
-\u2705 Always set_terminal_title ONCE at the start so the tab is meaningful.
+\u2705 Set the title ONCE from the first user request so the tab is meaningful.
 \`\`\`
 
 **Bad 4 - Radical topic change but the title never changes:**
 \`\`\`
 # Title: "Promo Video". The user then says: "now let's debug the login crash"
 update_terminal_activity(activity="Debugging the login crash")   \u2190 \u274C tab still says "Promo Video"
-\u2705 set_terminal_title(title="Login Crash", long_title="Debugging the crash when logging in")
+\u2705 set_terminal_title(title="Login Crash", long_title="Debugging the crash when logging in", replace_existing=true)
 \u2705 update_terminal_activity(activity="Reproducing the login crash")
 \`\`\`
 
@@ -15111,22 +15104,21 @@ Rules:
 
 ` : ""}## \u{1F6A8} FINAL REMINDER
 
-- Set the **general title AND the GOAL once** at the start (\`set_terminal_title(title,
-  long_title)\` \u2014 always both); set them again when the goal changes or the topic pivots
-  radically \u2014 never leave a stale title.
+- Set the **general title AND GOAL once per conversation**, from the first user request.
+  Follow-ups never retitle; a radical functionality pivot uses \`replace_existing=true\`.
 - Keep the **current activity** flowing with \`update_terminal_activity\` (product-level),
   one short sentence per step.
 ${includeStatus ? `- Keep the **status badge** honest with \`set_terminal_status\` at every phase change.
 ` : ""}- The tab should stay stable; the hover + clock-button log carry the detail.
 
 **MEMORIZE:**
-${includeStatus ? `1. **Start work \u2192 \`set_terminal_title(title, long_title)\` (ONCE, the tab label AND the GOAL sentence) + \`set_terminal_status(status="working")\`**
+${includeStatus ? `1. **First request \u2192 \`set_terminal_title(title, long_title)\` once + \`set_terminal_status(status="working")\`**
 2. **New step \u2192 \`update_terminal_activity\` (product step)**
 3. **Phase changed (waiting / testing / done) \u2192 \`set_terminal_status\`**
-4. **Goal changed or RADICAL topic change \u2192 \`set_terminal_title\` again (refined or NEW title)**
-5. **\u{1F3C1} Finishing \u2192 final \`update_terminal_activity\` summary + \`set_terminal_status\` \u2192 \`complete_task\`**` : `1. **Start work \u2192 \`set_terminal_title(title, long_title)\` (ONCE, the tab label AND the GOAL sentence)**
+4. **Radical functionality pivot \u2192 \`set_terminal_title(..., replace_existing=true)\`**
+5. **\u{1F3C1} Finishing \u2192 final \`update_terminal_activity\` summary + \`set_terminal_status\` \u2192 \`complete_task\`**` : `1. **First request \u2192 \`set_terminal_title(title, long_title)\` once**
 2. **New step \u2192 \`update_terminal_activity\` (product step)**
-3. **Goal changed or RADICAL topic change \u2192 \`set_terminal_title\` again (refined or NEW title)**
+3. **Radical functionality pivot \u2192 \`set_terminal_title(..., replace_existing=true)\`**
 4. **\u{1F3C1} Finishing \u2192 final \`update_terminal_activity\` summary \u2192 \`complete_task\`**`}
 
 ### \u{1F4DD} Task Plan Management
@@ -15374,8 +15366,9 @@ Avoid token limits:
 - Creating new? \u2192 YES
 
 **Agent Title?**
-- ALWAYS set it immediately when starting work
-- Radical topic change \u2192 set a NEW title (don't leave a stale one)
+- Set it from the first user request, once per conversation
+- Follow-up work changes activity, never the title
+- Radical functionality pivot \u2192 replace with \`replace_existing=true\`
 
 **Task Continuation?**
 - Same work <24h \u2192 Continue
@@ -15416,33 +15409,30 @@ CodeAgentSwarm shows two different things per agent:
    the context stays clear at a glance \u2014 name the feature, NOT a low-level step or file,
    and NOT a work PHASE (testing, e2e, validating, reviewing, deploying). Running the e2e
    suite for a settings redesign is titled "Settings Redesign", never "Settings E2E Tests".
-   Examples: "Promo Video for Twitter", "Minimize Agents". You set it ONCE at the start
-   and it almost never changes \u2014 the ONLY reasons to set it again are refining it when the
-   goal evolves, or REPLACING it when the agent pivots to a completely different topic.
+   Derive it from the **first user request** that established this conversation's
+   functionality and set it ONCE per conversation. It stays stable across follow-ups,
+   new turns, tasks, reviews, tests, validation, finishing, and context compaction.
 2. **Current activity** = the product-focused step you are doing RIGHT NOW. Example:
    "Implementing the analytics tracking backend". It is shown only when the user hovers
    the agent, and it accumulates as the activity log behind the clock button.
 
 ## \u{1F4E2} THE RULE
 
-**\u{1F6A6} FIRST ACTION when you start working in an agent:** set the GENERAL title right away,
-before anything else, so the agent is NEVER without info. It is ALWAYS safe to call \u2014 if
-the user manually renamed the agent the app keeps their name (a manual rename always wins
-over an MCP title). Never leave an agent with no meaningful title.
+**\u{1F6A6} FIRST ACTION in a new conversation:** set the GENERAL title from the first user
+request. On later turns, do NOT call \`set_terminal_title\`; update activity instead.
 
 **\u{1F4CD} ALWAYS leave a CURRENT SUMMARY before acting.** Right after the title, call
 \`update_terminal_activity\` with your first product-focused step, BEFORE running any other
 tool. If an agent has no activity yet, set one before you do anything else \u2014 so at every
 moment the user can see what each agent is doing. Never start working with no activity set.
 
-**At the START of work \u2192 set the GENERAL title ONCE. As you work \u2192 update the ACTIVITY often.**
+**First request \u2192 set the title ONCE. Every turn \u2192 update the ACTIVITY.**
 
-- \u2705 Set the general title once so the user always knows, at a glance, what this agent
-  is for. Set it again only to REFINE it when the overall goal changes (e.g. the user
-  expands the feature), or to REPLACE it when the topic changes RADICALLY.
+- \u2705 Keep the title from the first user request. Refining, extending, fixing, reviewing,
+  validating, or finishing that request changes the activity, not the title.
 - \u2705 RADICAL topic change \u2192 NEW general title, MANDATORY. When the user switches this
   agent to a completely different topic (e.g. from "Minimize Agents" to preparing
-  a release), call \`set_terminal_title\` again with the new topic. Updating only the
+  a release), call \`set_terminal_title\` again with \`replace_existing=true\`. Updating only the
   activity and leaving the old title is WRONG: the tab would keep describing work that
   is no longer happening.
 - \u2705 Update the activity every time your focus moves to a new step. This is what the user
@@ -15456,7 +15446,7 @@ the app's own static UI stays in English; these agent-written labels follow the
 
 **\u{1F527} THE TWO TOOLS:**
 \`\`\`
-# 1) ONCE at the start - the sticky, product-level tab title
+# 1) ONCE on the conversation's first request - the sticky tab title
 mcp__codeagentswarm-tasks__set_terminal_title(
     title="Promo Video",
     long_title="Promotional video for the Twitter launch"
@@ -15477,9 +15467,8 @@ mcp__codeagentswarm-tasks__update_terminal_activity(
   in the tab. \`long_title\` is the **GOAL**: one sentence on what this agent is FOR \u2014 the
   outcome the work aims at, not the step you are on. The user reads it in the hover under
   the title, labelled GOAL, and it is the ONLY place that answers "why does this agent
-  exist"; six words cannot carry that. Sticky: set once, refine rarely \u2014 but ALWAYS set a
-  fresh one when the agent pivots to a completely different topic. Never describe a
-  single step here.
+  exist"; six words cannot carry that. Repeated calls preserve the first title. Pass
+  \`replace_existing=true\` only after the user pivots to completely different functionality.
   \`\`\`
   \u2705 title="Orden notificaci\xF3n"
      long_title="Que las notificaciones no salgan antes de que cambie el status del agente"
@@ -15498,9 +15487,9 @@ mcp__codeagentswarm-tasks__update_terminal_activity(
 
 ## \u{1F3AF} WORKFLOW
 
-### \u2705 WHEN STARTING WORK:
+### \u2705 ON THE CONVERSATION'S FIRST REQUEST:
 \`\`\`
-1. set_terminal_title(                    \u2190 ONCE, product goal
+1. set_terminal_title(                    \u2190 once per conversation
      title="Minimize Agents",
      long_title="Add the ability to minimize and restore agents"
    )
@@ -15515,13 +15504,10 @@ update_terminal_activity(activity="Implementing restore-from-minimized")
 update_terminal_activity(activity="Persisting minimized state across restarts")
 \`\`\`
 
-### \u2705 THE GOAL ITSELF CHANGES \u2192 refine the GENERAL title (rare):
+### \u2705 THE ORIGINAL GOAL EXPANDS \u2192 keep the title and update ACTIVITY:
 \`\`\`
-# The user expanded the feature, so the product goal genuinely changed:
-set_terminal_title(
-  title="Minimize & Restore",
-  long_title="Minimize agents and restore them later from a tray"
-)
+# The user expanded the same feature; the first title remains "Minimize Agents":
+update_terminal_activity(activity="Adding restore from the tray")
 \`\`\`
 
 ### \u2705 RADICAL TOPIC CHANGE \u2192 set a NEW general title (mandatory):
@@ -15530,7 +15516,8 @@ set_terminal_title(
 User: "leave that, now let's prepare the release notes"
 set_terminal_title(
   title="Release Notes",
-  long_title="Preparing the release notes for the next version"
+  long_title="Preparing the release notes for the next version",
+  replace_existing=true
 )
 update_terminal_activity(activity="Drafting the release notes")
 # \u274C WRONG: calling only update_terminal_activity here \u2014 the tab would still
@@ -15539,9 +15526,8 @@ update_terminal_activity(activity="Drafting the release notes")
 
 ## \u26A0\uFE0F WHEN TO USE WHICH
 
-- **General title (set_terminal_title):** once at the start; again when the overall
-  goal/feature changes or the topic changes radically. Aim for very few calls per
-  session \u2014 but NEVER leave a stale title on an agent that moved to another topic.
+- **General title (set_terminal_title):** once per conversation from the first request.
+  Replace only after a radical functionality pivot, with \`replace_existing=true\`.
 - **Current activity (update_terminal_activity):** every time you move to a new product
   step. Call it freely - it never disturbs the tab.
 
@@ -15617,14 +15603,14 @@ update_terminal_activity(activity="Investigating the output handler cost")    \u
 **Bad 3 - Never setting a general title:**
 \`\`\`
 # Only calling update_terminal_activity, so the tab never gets a product label.
-\u2705 Always set_terminal_title ONCE at the start so the tab is meaningful.
+\u2705 Set the title ONCE from the first user request so the tab is meaningful.
 \`\`\`
 
 **Bad 4 - Radical topic change but the title never changes:**
 \`\`\`
 # Title: "Promo Video". The user then says: "now let's debug the login crash"
 update_terminal_activity(activity="Debugging the login crash")   \u2190 \u274C tab still says "Promo Video"
-\u2705 set_terminal_title(title="Login Crash", long_title="Debugging the crash when logging in")
+\u2705 set_terminal_title(title="Login Crash", long_title="Debugging the crash when logging in", replace_existing=true)
 \u2705 update_terminal_activity(activity="Reproducing the login crash")
 \`\`\`
 
@@ -15639,26 +15625,25 @@ set_terminal_title(title="Settings E2E Tests")   \u2190 \u274C testing is a STEP
 
 ## \u{1F6A8} FINAL REMINDER
 
-- Set the **general title AND the GOAL once** at the start (\`set_terminal_title(title,
-  long_title)\` \u2014 always both); set them again when the goal changes or the topic pivots
-  radically \u2014 never leave a stale title.
+- Set the **general title AND GOAL once per conversation**, from the first user request.
+  Follow-ups never retitle; a radical functionality pivot uses \`replace_existing=true\`.
 - Keep the **current activity** flowing with \`update_terminal_activity\` (product-level),
   one short sentence per step.
 - The tab should stay stable; the hover + clock-button log carry the detail.
 - Do NOT create or manage tasks \u2014 automatic task management is disabled.
 
 **MEMORIZE:**
-1. **Start work \u2192 \`set_terminal_title(title, long_title)\` (ONCE, the tab label AND the GOAL sentence)**
+1. **First request \u2192 \`set_terminal_title(title, long_title)\` once**
 2. **New step \u2192 \`update_terminal_activity\` (product step)**
-3. **Goal changed or RADICAL topic change \u2192 \`set_terminal_title\` again (refined or NEW title)**
+3. **Radical functionality pivot \u2192 \`set_terminal_title(..., replace_existing=true)\`**
 4. **\u{1F3C1} Finishing \u2192 final \`update_terminal_activity\` summary**
 
 ## Quick Decision Guide
 
 **Agent Title?**
-- ALWAYS set it immediately when starting work
-- Refine when the overall goal changes
-- Radical topic change \u2192 set a NEW title (don't leave a stale one)
+- Set it from the first user request, once per conversation
+- Follow-up work changes activity, never the title
+- Radical functionality pivot \u2192 replace with \`replace_existing=true\`
 
 **Tasks?**
 - Automatic task management is DISABLED \u2014 never create or manage tasks
@@ -18879,6 +18864,7 @@ var require_provider_auth = __commonJS({
       /\bunauthenticated\b/i,
       /\bauthentication required\b/i,
       /\bplease (?:run|use) [^\n]*(?:login|log in|sign in)\b/i,
+      /\brun [^\n]*(?:login|log in|sign in)\b/i,
       /\b(?:login|log in|sign in) (?:is )?required\b/i,
       /\bmissing (?:an? )?(?:api key|access token|auth token|credentials?)\b/i,
       /\b(?:invalid|expired) (?:api key|access token|auth token|credentials?)\b/i,
@@ -19240,7 +19226,6 @@ var require_codex_app_server_driver = __commonJS({
     var DEFAULT_SERVICE_TIER_ID = "default";
     var EPHEMERAL_CODEX_HOME_PREFIX = "codeagentswarm-codex-home-";
     var EPHEMERAL_CODEX_HOME_MAX_AGE_MS = 24 * 60 * 60 * 1e3;
-    var REQUIRED_TASK_MCP_TOOL = "check_active";
     var TEXT_ONLY_INSTRUCTIONS = "Answer with plain text only. Do not call tools, commands, apps, skills, web search, MCP servers, or subagents.";
     var IMAGE_ONLY_INSTRUCTIONS = "Generate exactly one image with the built-in image generation capability. Do not call commands, apps, skills, web search, MCP servers, subagents, or any other tool. Do not return prose.";
     var TEXT_ONLY_CONFIG_OVERRIDES = Object.freeze([
@@ -19397,10 +19382,6 @@ var require_codex_app_server_driver = __commonJS({
        * @param {{name: string, title: string, version: string}} [options.clientInfo]
        * @param {number} [options.requestTimeoutMs=30000] Per-request timeout.
        * @param {Function} [options.spawnFn] Injectable spawn, for tests.
-       * @param {string} [options.requiredMcpServer] MCP server whose activation
-       *   check is repaired before the first turn when possible.
-       * @param {Function} [options.repairMcpConfig] Repairs the on-disk MCP config
-       *   before the running app-server reloads it.
        * @param {{register: Function, unregister: Function}} [options.processRegistry]
        *   PID registry the child is tracked in; injectable for tests.
        */
@@ -19410,9 +19391,7 @@ var require_codex_app_server_driver = __commonJS({
         clientInfo,
         requestTimeoutMs = DEFAULT_REQUEST_TIMEOUT_MS,
         spawnFn,
-        processRegistry,
-        requiredMcpServer,
-        repairMcpConfig
+        processRegistry
       } = {}) {
         super();
         this._binaryPath = binaryPath;
@@ -19421,8 +19400,6 @@ var require_codex_app_server_driver = __commonJS({
         this._requestTimeoutMs = requestTimeoutMs;
         this._spawnFn = spawnFn || spawn;
         this._processRegistry = processRegistry || require_spawned_process_registry();
-        this._requiredMcpServer = requiredMcpServer || null;
-        this._repairMcpConfig = repairMcpConfig || null;
         this._child = null;
         this._pendingRequests = /* @__PURE__ */ new Map();
         this._pendingApprovals = /* @__PURE__ */ new Map();
@@ -19969,7 +19946,7 @@ var require_codex_app_server_driver = __commonJS({
               initialTurnsPage: {
                 limit: INITIAL_HISTORY_TURN_PAGE_SIZE,
                 sortDirection: "desc",
-                itemsView: "summary"
+                itemsView: "full"
               },
               ...threadParams
             });
@@ -19995,13 +19972,6 @@ var require_codex_app_server_driver = __commonJS({
           }
         }
         this._threadId = ((_a = result == null ? void 0 : result.thread) == null ? void 0 : _a.id) || (result == null ? void 0 : result.threadId) || (resumeSessionId || null);
-        if (!toolsDisabled && !imageGenerationOnly) {
-          try {
-            await this._ensureRequiredMcpServer(this._threadId);
-          } catch (error) {
-            console.warn(`[CodexAppServerDriver] Continuing without verified task MCP tools: ${error.message}`);
-          }
-        }
         this._sessionCwd = (result == null ? void 0 : result.cwd) || ((_b = result == null ? void 0 : result.thread) == null ? void 0 : _b.cwd) || cwd;
         let historyPage = result == null ? void 0 : result.initialTurnsPage;
         const returnedTurns = Array.isArray((_c = result == null ? void 0 : result.thread) == null ? void 0 : _c.turns) ? result.thread.turns : [];
@@ -20011,7 +19981,7 @@ var require_codex_app_server_driver = __commonJS({
               threadId: this._threadId,
               limit: INITIAL_HISTORY_TURN_PAGE_SIZE,
               sortDirection: "desc",
-              itemsView: "summary"
+              itemsView: "full"
             });
           } catch (_) {
           }
@@ -20060,15 +20030,6 @@ var require_codex_app_server_driver = __commonJS({
         } while (cursor);
         return servers;
       }
-      async _ensureRequiredMcpServer(threadId) {
-        if (!this._requiredMcpServer) return;
-        const connected = (servers) => servers.some((server) => (server == null ? void 0 : server.name) === this._requiredMcpServer && Object.values(server.tools || {}).some((tool) => (tool == null ? void 0 : tool.name) === REQUIRED_TASK_MCP_TOOL));
-        if (connected(await this._listMcpServers(threadId))) return;
-        if (this._repairMcpConfig && await this._repairMcpConfig() === false) {
-          throw new Error("CodeAgentSwarm could not repair the Codex MCP configuration. Restart CodeAgentSwarm and retry Chat.");
-        }
-        await this._request("config/mcpServer/reload", null);
-      }
       /**
        * Build a resumed thread's past items as historical `item.completed` events.
        *
@@ -30461,6 +30422,18 @@ var require_mcp_stdio_server = __commonJS({
         } catch (e) {
         }
       }
+      _hasNudgeMarker(kind) {
+        try {
+          const os2 = require("os");
+          const fs2 = require("fs");
+          const stateDir = path.join(os2.homedir(), ".codeagentswarm", "terminal-nudge-state");
+          const rawKey = process.env.CODEAGENTSWARM_TERMINAL_ID || process.env.CODEAGENTSWARM_CURRENT_QUADRANT;
+          const key = String(rawKey || "").replace(/[^A-Za-z0-9_-]/g, "_");
+          return !!key && fs2.existsSync(path.join(stateDir, `${key}.${kind}`));
+        } catch (e) {
+          return false;
+        }
+      }
       // Resolve the current terminal id (1-based) from the environment.
       _getCurrentTerminalId() {
         const terminalId = process.env.CODEAGENTSWARM_CURRENT_QUADRANT;
@@ -30479,20 +30452,30 @@ var require_mcp_stdio_server = __commonJS({
       }
       // Set the GENERAL terminal title: the sticky tab label that represents the
       // product-level goal of what this terminal is working on. Set it ONCE at the
-      // start of work; call it again only to refine when the overall functionality
-      // changes, or to replace it when the terminal pivots to a radically different
-      // topic. It does NOT represent the current step — use update_terminal_activity
-      // for that.
+      // start of the conversation. Later calls preserve it unless the caller explicitly
+      // declares a radical topic change. It does NOT represent the current step — use
+      // update_terminal_activity for that.
       async setTerminalTitle(params) {
-        const { title, long_title } = params;
+        const { title, long_title, replace_existing } = params;
         if (!title) {
           throw new Error("title is required");
         }
         if (isPlaceholderTitle(title)) {
           throw new Error(`"${title}" looks like example text copied from the tool documentation, not a real title. Call the tool again with a title that describes the ACTUAL feature or goal you are working on in this agent (max 6 words).`);
         }
-        const shortTitle = this.generateShortTitle(title);
+        if (replace_existing !== void 0 && typeof replace_existing !== "boolean") {
+          throw new Error("replace_existing must be a boolean");
+        }
         const terminalId = this._getCurrentTerminalId();
+        if (replace_existing !== true && this._hasNudgeMarker("title")) {
+          return {
+            terminal_id: terminalId,
+            updated: false,
+            preserved: true,
+            message: "The existing conversation title was preserved. Use update_terminal_activity for follow-up work; set replace_existing=true only after the user pivots to a completely different functionality."
+          };
+        }
+        const shortTitle = this.generateShortTitle(title);
         const currentTask = this._getCurrentTask(terminalId);
         const taskId = currentTask ? currentTask.id : null;
         let longTitle = long_title;
@@ -31390,7 +31373,7 @@ Use 'clear' to remove the status.`;
           },
           {
             name: "set_terminal_title",
-            description: 'Set the GENERAL agent title AND the agent GOAL \u2014 pass BOTH arguments, because the user sees them together. `title` is the sticky Agent tab label at the FEATURE level (e.g. "Promo video for Twitter", "Minimize agents"); `long_title` is one sentence on what this agent is FOR, shown in the hover under the title. Keep the title high-level: name the feature, not a low-level step or work phase. Set it once at the start, then only refine it when the overall goal changes. Use update_terminal_activity for the current step. LANGUAGE: write BOTH in the SAME language the user is speaking.',
+            description: "Set the GENERAL agent title AND the agent GOAL from the first user request that established this conversation's topic. Pass BOTH text arguments because the user sees them together. This is once per conversation, NOT once per user message, turn, task, review, validation, or resumed session. Follow-up work belongs in update_terminal_activity and repeated calls preserve the original title. Only a user pivot to a completely different functionality may replace it, by passing replace_existing=true. LANGUAGE: write both text fields in the SAME language the user is speaking.",
             inputSchema: {
               type: "object",
               properties: {
@@ -31401,6 +31384,10 @@ Use 'clear' to remove the status.`;
                 long_title: {
                   type: "string",
                   description: `The agent GOAL: one sentence saying what this agent is FOR \u2014 the outcome the work is aiming at, not the current step. ALWAYS provide it: the user reads it in the Agent hover, labelled GOAL, under the short title. Write the real goal in the user's language. Do NOT restate the title or prefix it with "Working on:".`
+                },
+                replace_existing: {
+                  type: "boolean",
+                  description: "Leave false or omit for normal follow-up work. Set true ONLY when the user explicitly pivots this existing conversation to a completely different functionality; reviews, tests, fixes, implementation phases, and refinements of the original request are activities and must not replace the title."
                 }
               },
               // long_title is NOT in `required` on purpose: some agent clients
@@ -31854,7 +31841,8 @@ Use 'clear' to remove the status.`;
           case "set_terminal_title":
             result = await this.setTerminalTitle({
               title: args.title,
-              long_title: args.long_title
+              long_title: args.long_title,
+              replace_existing: args.replace_existing
             });
             break;
           case "update_terminal_activity":
@@ -33683,18 +33671,13 @@ var require_driver_chat_manager = __commonJS({
         });
       });
     }
-    function defaultCreateDriver({ agent, env, binaryPath, requiredMcpServer, repairMcpConfig }) {
+    function defaultCreateDriver({ agent, env, binaryPath }) {
       if (agent === "claude") return new ClaudeAgentSdkDriver({ env, binaryPath });
       if (agent === "antigravity") return new AntigravityPrintDriver({ env, binaryPath });
       if (agent === "opencode" || agent === "kimi" || agent === "grok" || agent === "cursor") {
         return new AcpAgentDriver({ provider: agent, env, binaryPath });
       }
-      return new CodexAppServerDriver({
-        env,
-        binaryPath,
-        requiredMcpServer,
-        repairMcpConfig
-      });
+      return new CodexAppServerDriver({ env, binaryPath });
     }
     var DriverChatManager = class extends EventEmitter {
       /**
@@ -33961,6 +33944,7 @@ var require_driver_chat_manager = __commonJS({
             // main-process placeholder, so return that same UUID for persistence
             // and instance-safe MCP notification routing.
             terminalUuid: env.CODEAGENTSWARM_TERMINAL_ID || null,
+            communicationEnabled: env.CODEAGENTSWARM_SESSION_COMMUNICATION_ENABLED === "1",
             model: session.model,
             effort: session.effort || resolvedEffort,
             serviceTier: session.serviceTier ?? (rejected.has("serviceTier") ? null : (_a = selections.find((selection) => (selection == null ? void 0 : selection.id) === "serviceTier")) == null ? void 0 : _a.value) ?? null,
@@ -34722,11 +34706,13 @@ var require_chat_history_pagination = __commonJS({
       return Date.parse(value);
     }
     function normalizeConversationMessages(messages) {
+      let internalTurn = false;
       return (Array.isArray(messages) ? messages : []).flatMap((message) => {
         const role = (message == null ? void 0 : message.role) === "assistant" ? "assistant_message" : (message == null ? void 0 : message.role) === "user" ? "user_message" : null;
         const text = [message == null ? void 0 : message.content, message == null ? void 0 : message.text, message == null ? void 0 : message.displayText].find((value) => typeof value === "string" && value.trim());
         const attachments = Array.isArray(message == null ? void 0 : message.attachments) ? message.attachments : [];
-        return role && (text || attachments.length) && !(role === "user_message" && text && parseSessionCoordinationPrompt(text)) ? [{ role, text: text || "", attachments, timestamp: message.timestamp }] : [];
+        if (role === "user_message") internalTurn = Boolean(text && parseSessionCoordinationPrompt(text));
+        return role && (text || attachments.length) && !internalTurn ? [{ role, text: text || "", attachments, timestamp: message.timestamp }] : [];
       });
     }
     function boundedConversationMessages(messages, { limit = 30, maxMessageChars = 8e3, maxBytes = 22e4 } = {}) {
@@ -34777,12 +34763,14 @@ var require_chat_history_pagination = __commonJS({
       before,
       anchor,
       knownCount = 0,
+      hydratedCount = 0,
       limit = DEFAULT_HISTORY_PAGE_SIZE
     } = {}) {
       const normalized = normalizeConversationMessages(messages);
       const safeLimit = Number.isSafeInteger(limit) && limit > 0 ? limit : DEFAULT_HISTORY_PAGE_SIZE;
       const anchorIndex = findConversationAnchor(normalized, anchor);
-      const end = Number.isSafeInteger(before) ? Math.max(0, Math.min(before, normalized.length)) : anchorIndex ?? Math.max(0, normalized.length - Math.max(0, Number(knownCount) || 0));
+      const hydratedEnd = Math.max(0, normalized.length - Math.max(0, Number(hydratedCount) || 0));
+      const end = Number.isSafeInteger(before) ? Math.max(0, Math.min(before, normalized.length)) : Math.min(hydratedEnd, anchorIndex ?? Math.max(0, normalized.length - Math.max(0, Number(knownCount) || 0)));
       const start = Math.max(0, end - safeLimit);
       return {
         messages: normalized.slice(start, end).map((message, offset) => ({
@@ -35048,6 +35036,7 @@ var require_mobile_runtime = __commonJS({
     var { parseSessionCoordinationPrompt } = require_session_coordination_message();
     var {
       conversationMessagesToEvents,
+      normalizeConversationMessages,
       pageConversationMessages
     } = require_chat_history_pagination();
     var PROTOCOL_VERSION = 2;
@@ -35353,6 +35342,7 @@ var require_mobile_runtime = __commonJS({
         listProjectDirectories = null,
         createProject = null,
         updateProject = null,
+        gitAvailability = null,
         projectIconAvailability = null,
         generateProjectIcon = null,
         registerProject = null,
@@ -35423,6 +35413,7 @@ var require_mobile_runtime = __commonJS({
         this.listProjectDirectories = listProjectDirectories;
         this.createProject = createProject;
         this.updateProject = updateProject;
+        this.gitAvailability = gitAvailability;
         this.projectIconAvailability = projectIconAvailability;
         this.generateProjectIcon = generateProjectIcon;
         this.registerProject = registerProject;
@@ -35568,6 +35559,7 @@ var require_mobile_runtime = __commonJS({
           accountLabel: session.accountLabel,
           threadId: session.threadId,
           terminalUuid: session.terminalUuid,
+          communicationEnabled: session.communicationEnabled === true,
           terminalOrder: session.terminalOrder,
           cwd: session.cwd,
           model: session.model,
@@ -35875,13 +35867,16 @@ var require_mobile_runtime = __commonJS({
         });
       }
       publishProjectIconEvent(event = {}) {
+        const iconDataUrl = typeof event.iconDataUrl === "string" && event.iconDataUrl.length <= 1e5 ? event.iconDataUrl : null;
         return this._publish("project.icon.generated", {
           jobId: cleanText(event.jobId, 100),
           projectId: cleanText(event.projectId, 128),
           success: event.success === true,
           applied: event.applied === true,
           unavailable: event.unavailable === true,
-          ...cleanText(event.error, 500) ? { error: cleanText(event.error, 500) } : {}
+          ...cleanText(event.error, 500) ? { error: cleanText(event.error, 500) } : {},
+          ...cleanText(event.icon, 300) ? { icon: cleanText(event.icon, 300) } : {},
+          ...iconDataUrl ? { iconDataUrl } : {}
         });
       }
       publishProviderLoginEvent(event = {}) {
@@ -35939,6 +35934,7 @@ var require_mobile_runtime = __commonJS({
           accountLabel: started.accountLabel || null,
           threadId: started.threadId,
           terminalUuid: started.terminalUuid,
+          communicationEnabled: started.communicationEnabled === true,
           terminalOrder: Number.isSafeInteger(started.terminalId) && started.terminalId > 0 ? started.terminalId : null,
           desktopTerminalId: Number.isSafeInteger(started.terminalId) && started.terminalId > 0 ? started.terminalId : null,
           cwd: started.cwd,
@@ -35964,6 +35960,7 @@ var require_mobile_runtime = __commonJS({
             accountLabel: started.accountLabel || null,
             threadId: started.threadId,
             terminalUuid: started.terminalUuid,
+            communicationEnabled: started.communicationEnabled === true,
             terminalOrder: Number.isSafeInteger(started.terminalId) && started.terminalId > 0 ? started.terminalId : null,
             cwd: started.cwd,
             model: started.model,
@@ -36019,11 +36016,11 @@ var require_mobile_runtime = __commonJS({
           return;
         }
         if (!Array.isArray(messages) || !messages.length) return;
-        const recent = messages.slice(-200);
+        const recent = normalizeConversationMessages(messages).slice(-200);
         recent.forEach((message, index) => {
           var _a2, _b2;
-          const role = (message == null ? void 0 : message.role) === "assistant" ? "assistant_message" : (message == null ? void 0 : message.role) === "user" ? "user_message" : null;
-          const text = cleanText((message == null ? void 0 : message.content) ?? (message == null ? void 0 : message.text) ?? (message == null ? void 0 : message.displayText), MAX_INITIAL_PROMPT_CHARS);
+          const role = message.role;
+          const text = cleanText(message.text, MAX_INITIAL_PROMPT_CHARS);
           const attachments = Array.isArray(message == null ? void 0 : message.attachments) ? message.attachments : [];
           if (!role || !text && !attachments.length) return;
           const key = `${role}\0${text}`;
@@ -36315,6 +36312,7 @@ var require_mobile_runtime = __commonJS({
             accountLabel: null,
             threadId: null,
             terminalUuid: null,
+            communicationEnabled: false,
             terminalOrder: null,
             desktopTerminalId: null,
             cwd: null,
@@ -36579,7 +36577,7 @@ var require_mobile_runtime = __commonJS({
         }
       }
       async _executeCommand(command = {}, context = {}) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         this._pruneAttachmentUploads();
         const sessionId = command.sessionId;
         const payload = command.payload || {};
@@ -36689,10 +36687,15 @@ var require_mobile_runtime = __commonJS({
           this.publishProjects();
           return result;
         }
+        if (command.type === "project.git.availability") {
+          if (typeof this.gitAvailability !== "function") return { available: false };
+          exactPayload(["rootId"]);
+          return this.gitAvailability({ rootId: cleanText(payload.rootId, 128) });
+        }
         if (command.type === "project.icon.availability") {
           if (typeof this.projectIconAvailability !== "function") return { available: false };
-          exactPayload([]);
-          return this.projectIconAvailability();
+          exactPayload(["projectId"]);
+          return this.projectIconAvailability({ projectId: cleanText(payload.projectId, 128) });
         }
         if (command.type === "project.icon.generate") {
           if (typeof this.generateProjectIcon !== "function") throw new Error("Codex icon generation is unavailable");
@@ -36706,13 +36709,23 @@ var require_mobile_runtime = __commonJS({
         if (command.type === "project.register") {
           if (typeof this.registerProject !== "function") throw new Error("Remote project registration is unavailable");
           exactPayload(["rootId", "relativePath", "requestId"]);
-          return this.registerProject({ rootId: payload.rootId, relativePath: payload.relativePath, requestId: mutationRequestId() });
+          const result = await this.registerProject({ rootId: payload.rootId, relativePath: payload.relativePath, requestId: mutationRequestId() });
+          this.publishProjects();
+          return result;
         }
         if (command.type === "project.clone") {
           if (typeof this.cloneProject !== "function") throw new Error("Remote project cloning is unavailable");
-          exactPayload(["rootId", "url", "relativePath", "requestId"]);
+          exactPayload(["rootId", "url", "relativePath", "displayName", "color", "icon", "requestId"]);
           if (typeof payload.requestId !== "string" || !payload.requestId) throw new Error("A clone requestId is required");
-          return this.cloneProject({ rootId: payload.rootId, url: payload.url, relativePath: payload.relativePath, requestId: payload.requestId });
+          return this.cloneProject({
+            rootId: payload.rootId,
+            url: payload.url,
+            relativePath: payload.relativePath,
+            displayName: payload.displayName,
+            color: payload.color,
+            icon: payload.icon,
+            requestId: payload.requestId
+          });
         }
         if (command.type === "project.clone.cancel") {
           if (typeof this.cancelProjectClone !== "function") throw new Error("Remote clone cancellation is unavailable");
@@ -36984,6 +36997,7 @@ var require_mobile_runtime = __commonJS({
               agent: session.agent
             });
             const knownCount = Array.from(session.items.values()).filter(isConversationItem).length;
+            const hydratedCount = ((_d = (_c = context.client) == null ? void 0 : _c.subscriptions) == null ? void 0 : _d.has(sessionId)) ? this._subscriptionSnapshot(session).items.filter(isConversationItem).length : 0;
             const page = pageConversationMessages(messages, {
               before: Number.isSafeInteger(payload.before) ? payload.before : void 0,
               anchor: payload.anchor && typeof payload.anchor === "object" ? {
@@ -36992,6 +37006,7 @@ var require_mobile_runtime = __commonJS({
                 timestamp: cleanText(payload.anchor.timestamp, 64)
               } : null,
               knownCount: Number.isSafeInteger(payload.knownCount) ? payload.knownCount : knownCount,
+              hydratedCount,
               limit: 30
             });
             const events = conversationMessagesToEvents(page.messages, {
@@ -37063,7 +37078,7 @@ var require_mobile_runtime = __commonJS({
             const value = typeof payload.value === "boolean" && REASONING_CONFIG_IDS.has(configId) ? payload.value : cleanText(payload.value, 200);
             if (value === null || value === "") throw new Error("Choose a configuration value");
             const session = this._session(sessionId);
-            if (((_c = session.currentTurn) == null ? void 0 : _c.state) === "running") {
+            if (((_e = session.currentTurn) == null ? void 0 : _e.state) === "running") {
               throw new Error("Wait for the current response to finish");
             }
             return this.manager.setConfigOption(sessionId, configId, value);
@@ -37209,11 +37224,11 @@ var require_mobile_runtime = __commonJS({
               for (const uploadId of uploadIds) this.attachmentUploads.delete(uploadId);
               return { accepted: true, ...(delivered == null ? void 0 : delivered.turnId) ? { turnId: delivered.turnId } : {} };
             } catch (error) {
-              const localEcho = (_d = this.sessions.get(sessionId)) == null ? void 0 : _d.items.get(localEchoId);
+              const localEcho = (_f = this.sessions.get(sessionId)) == null ? void 0 : _f.items.get(localEchoId);
               if (localEcho == null ? void 0 : localEcho.providerItemId) return { accepted: true };
               this._publishProviderEvent(sessionId, {
                 eventId: crypto.randomUUID(),
-                provider: (_e = this.sessions.get(sessionId)) == null ? void 0 : _e.provider,
+                provider: (_g = this.sessions.get(sessionId)) == null ? void 0 : _g.provider,
                 type: "item.completed",
                 executionOrigin: "main",
                 createdAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -37223,7 +37238,7 @@ var require_mobile_runtime = __commonJS({
                   status: "failed",
                   localEcho: true,
                   remoteCommand: true,
-                  data: { text, attachments: ((_f = localEcho == null ? void 0 : localEcho.data) == null ? void 0 : _f.attachments) || [] }
+                  data: { text, attachments: ((_h = localEcho == null ? void 0 : localEcho.data) == null ? void 0 : _h.attachments) || [] }
                 }
               });
               this.remoteTurnSessions.delete(sessionId);
@@ -38677,9 +38692,14 @@ var require_remote_runtime_client = __commonJS({
       "session.resume",
       "history.older",
       "projects.list",
+      "project.directories.list",
+      "project.update",
       "project.register",
       "project.clone",
       "project.clone.cancel",
+      "project.git.availability",
+      "project.icon.availability",
+      "project.icon.generate",
       "project.unregister",
       "tasks.list",
       "task.create",
@@ -38708,6 +38728,7 @@ var require_remote_runtime_client = __commonJS({
       "coordination.transcript",
       "coordination.message",
       "projects.list",
+      "project.directories.list",
       "tasks.list",
       "providers.list",
       "provider.login.describe",
@@ -38773,15 +38794,20 @@ var require_remote_runtime_client = __commonJS({
         assertPublicPayload(child, depth + 1);
       }
     }
-    function stripPathFields(value, depth = 0) {
+    function stripPathFields(value, depth = 0, preserveRelativePaths = false) {
       if (depth > 40) throw new Error("Remote runtime payload is too deeply nested");
-      if (Array.isArray(value)) return value.map((item) => stripPathFields(item, depth + 1));
+      if (Array.isArray(value)) return value.map((item) => stripPathFields(item, depth + 1, preserveRelativePaths));
       if (!value || typeof value !== "object") return value;
       const clean = {};
       for (const [key, child] of Object.entries(value)) {
         const normalized = normalizedKey(key);
-        if (PATH_KEYS.has(normalized) || normalized.endsWith("path")) continue;
-        clean[key] = stripPathFields(child, depth + 1);
+        if (PATH_KEYS.has(normalized) || normalized.endsWith("path")) {
+          if (preserveRelativePaths && (child === null || isSafeRelativePath(child))) {
+            clean[key] = typeof child === "string" ? child.replace(/\\/g, "/") : null;
+          }
+          continue;
+        }
+        clean[key] = stripPathFields(child, depth + 1, preserveRelativePaths);
       }
       return clean;
     }
@@ -39326,7 +39352,7 @@ var require_remote_runtime_client = __commonJS({
         }
         if (command.payload !== void 0) {
           assertPublicPayload(command.payload);
-          assertPathlessCommand(command.payload, 0, command.type === "project.register" || command.type === "project.clone" || command.type.startsWith("workspace.files."));
+          assertPathlessCommand(command.payload, 0, command.type === "project.directories.list" || command.type === "project.register" || command.type === "project.clone" || command.type.startsWith("workspace.files."));
           wire.payload = clone(command.payload);
         }
         return wire;
@@ -39453,9 +39479,8 @@ var require_remote_runtime_client = __commonJS({
           return;
         }
         if (message.kind === "credential.renewed") {
-          if (!this.connection || Number(message.accessExpiresAt) !== this.connection.accessExpiresAt) {
-            return this._protocolFailure(socket);
-          }
+          const accessExpiresAt = Number(message.accessExpiresAt);
+          if (!this.connection || !Number.isFinite(accessExpiresAt) || Math.abs(accessExpiresAt - this.connection.accessExpiresAt) > 2e3) return;
           if (this.renewTimer) clearTimeout(this.renewTimer);
           this.renewTimer = null;
           this._diagnostic("remote.credential_renewed");
@@ -39578,7 +39603,7 @@ var require_remote_runtime_client = __commonJS({
         if (this.runtimeOnline) this._sendRuntimeHello();
       }
       _handleRuntimeEnvelope(envelope) {
-        var _a, _b;
+        var _a, _b, _c, _d, _e;
         let safe;
         let bytes;
         try {
@@ -39592,7 +39617,8 @@ var require_remote_runtime_client = __commonJS({
               throw new Error("Invalid runtime snapshot");
             }
           }
-          safe = stripPathFields(envelope);
+          const commandType = envelope.kind === "command.result" ? (_c = (_b = (_a = this.pendingCommands.get(envelope.commandId)) == null ? void 0 : _a.message) == null ? void 0 : _b.command) == null ? void 0 : _c.type : null;
+          safe = stripPathFields(envelope, 0, commandType === "project.directories.list");
         } catch {
           const kind = typeof (envelope == null ? void 0 : envelope.kind) === "string" && /^[a-z][a-z0-9.]{0,63}$/.test(envelope.kind) ? envelope.kind : void 0;
           this._diagnostic("remote.runtime_rejected", { reason: "invalid_envelope", kind });
@@ -39646,8 +39672,8 @@ var require_remote_runtime_client = __commonJS({
             totalMs: this.connectTrace ? this.now() - this.connectTrace.startedAt : void 0,
             reset: safe.reset === true,
             bytes,
-            sessions: Array.isArray((_a = safe.snapshot) == null ? void 0 : _a.sessions) ? safe.snapshot.sessions.length : void 0,
-            projects: Array.isArray((_b = safe.snapshot) == null ? void 0 : _b.projects) ? safe.snapshot.projects.length : void 0
+            sessions: Array.isArray((_d = safe.snapshot) == null ? void 0 : _d.sessions) ? safe.snapshot.sessions.length : void 0,
+            projects: Array.isArray((_e = safe.snapshot) == null ? void 0 : _e.projects) ? safe.snapshot.projects.length : void 0
           });
           this.connectTrace = null;
           this._emitEnvelope(safe);
@@ -40235,6 +40261,7 @@ var require_peer_runtime_network = __commonJS({
     var MAX_PEERS = 32;
     var PEER_ACCESS_TTL_MS = 7 * 24 * 60 * 6e4;
     var PEER_HANDSHAKE_TIMEOUT_MS = 5e3;
+    var PEER_DENIAL_FEATURE = "peer-denial";
     function peerRef(value) {
       return value ? crypto.createHash("sha256").update(String(value)).digest("hex").slice(0, 10) : void 0;
     }
@@ -40273,7 +40300,18 @@ var require_peer_runtime_network = __commonJS({
           return;
         }
         if (message.kind === "runtime.message" && message.box) {
-          if (!this.network.relay.sendPeerMessage(this.peer.runtimeId, message.box, "to-runtime")) {
+          let box = message.box;
+          try {
+            const payload = decryptJson(box, this.network.keyPair.secretKey, this.peer.publicKey);
+            if ((payload == null ? void 0 : payload.kind) === "hello" && !(Array.isArray(payload.features) && payload.features.includes(PEER_DENIAL_FEATURE))) {
+              box = encryptJson({
+                ...payload,
+                features: [...Array.isArray(payload.features) ? payload.features : [], PEER_DENIAL_FEATURE]
+              }, this.network.keyPair.secretKey, this.peer.publicKey);
+            }
+          } catch {
+          }
+          if (!this.network.relay.sendPeerMessage(this.peer.runtimeId, box, "to-runtime")) {
             this.network._diagnostic("peer.route_failed", { peer: peerRef(this.peer.runtimeId), stream: "to-runtime" });
             this.offline();
           } else if (this.readyState === 1 && !this.handshakeComplete && !this.handshakeTimer) {
@@ -40283,11 +40321,17 @@ var require_peer_runtime_network = __commonJS({
       }
       receive(box) {
         if (this.readyState !== 1) return;
+        let payload;
         try {
-          decryptJson(box, this.network.keyPair.secretKey, this.peer.publicKey);
+          payload = decryptJson(box, this.network.keyPair.secretKey, this.peer.publicKey);
           this.network.relay.emit("diagnostic", { event: "peer.response_verified", stream: "to-client" });
         } catch {
           this.network.relay.emit("diagnostic", { event: "peer.response_rejected", reason: "decrypt_failed" });
+          return;
+        }
+        if ((payload == null ? void 0 : payload.kind) === "peer.denied") {
+          this.network._denyPeer(this.peer.runtimeId);
+          return;
         }
         this.handshakeComplete = true;
         if (this.handshakeTimer) clearTimeout(this.handshakeTimer);
@@ -40327,6 +40371,7 @@ var require_peer_runtime_network = __commonJS({
         this.saveRosters = saveRosters;
         this.rosters = /* @__PURE__ */ new Map();
         this.revokedPeers = /* @__PURE__ */ new Set();
+        this.deniedPeers = /* @__PURE__ */ new Set();
         this.peers = /* @__PURE__ */ new Map();
         this.clients = /* @__PURE__ */ new Map();
         this.clientSockets = /* @__PURE__ */ new Map();
@@ -40374,6 +40419,7 @@ var require_peer_runtime_network = __commonJS({
           publicKey: peer.publicKey,
           name: peer.name.trim().slice(0, 200) || "Connected host"
         }])).values()];
+        for (const peer of unique) this.deniedPeers.delete(peer.runtimeId);
         if (unique.length) this.rosters.set(deviceId, unique);
         else this.rosters.delete(deviceId);
         for (const runtimeId of this.revokedPeers) {
@@ -40428,11 +40474,12 @@ var require_peer_runtime_network = __commonJS({
           const previous = this.peers.get(runtimeId);
           const current = next.get(runtimeId);
           if ((current == null ? void 0 : current.publicKey) === previous.publicKey) continue;
+          this.deniedPeers.delete(runtimeId);
           this._removePeer(runtimeId);
         }
         this.peers = next;
         for (const peer of this.peers.values()) {
-          if (!this.clients.has(peer.runtimeId)) this._addPeer(peer);
+          if (!this.deniedPeers.has(peer.runtimeId) && !this.clients.has(peer.runtimeId)) this._addPeer(peer);
         }
         this._notifyClients();
       }
@@ -40517,6 +40564,24 @@ var require_peer_runtime_network = __commonJS({
         this.serverSockets.delete(runtimeId);
         this._diagnostic("peer.removed", { peer: peerRef(runtimeId) });
       }
+      _denyPeer(runtimeId) {
+        if (!this.peers.has(runtimeId)) return;
+        this.deniedPeers.add(runtimeId);
+        this._removePeer(runtimeId);
+        this._diagnostic("peer.connection_denied", { peer: peerRef(runtimeId) });
+        this._notifyClients();
+      }
+      _rosterPeer(runtimeId) {
+        let found = null;
+        for (const roster of this.rosters.values()) {
+          for (const peer of roster) {
+            if (peer.runtimeId !== runtimeId) continue;
+            if (found && found.publicKey !== peer.publicKey) return null;
+            found = peer;
+          }
+        }
+        return found;
+      }
       _handleRelayEvent(event) {
         var _a, _b, _c;
         if ((event == null ? void 0 : event.kind) === "peer.online" && ID_PATTERN.test(event.targetRuntimeId || "")) {
@@ -40537,6 +40602,20 @@ var require_peer_runtime_network = __commonJS({
         if ((event == null ? void 0 : event.kind) !== "peer.message" || !ID_PATTERN.test(event.sourceRuntimeId || "") || !KEY_PATTERN.test(event.sourcePublicKey || "")) return;
         const peer = this.peers.get(event.sourceRuntimeId);
         if (!peer || peer.publicKey !== event.sourcePublicKey) {
+          const revokedPeer = this.revokedPeers.has(event.sourceRuntimeId) ? this._rosterPeer(event.sourceRuntimeId) : null;
+          if ((revokedPeer == null ? void 0 : revokedPeer.publicKey) === event.sourcePublicKey && event.stream === "to-runtime") {
+            let payload2;
+            try {
+              payload2 = decryptJson(event.box, this.keyPair.secretKey, revokedPeer.publicKey);
+            } catch {
+            }
+            if ((payload2 == null ? void 0 : payload2.kind) === "hello" && Array.isArray(payload2.features) && payload2.features.includes(PEER_DENIAL_FEATURE)) {
+              const box = encryptJson({ kind: "peer.denied" }, this.keyPair.secretKey, revokedPeer.publicKey);
+              if (this.relay.sendPeerMessage(revokedPeer.runtimeId, box, "to-client")) {
+                this._diagnostic("peer.denial_sent", { peer: peerRef(revokedPeer.runtimeId) });
+              }
+            }
+          }
           this._diagnostic("peer.message_rejected", {
             reason: peer ? "key_mismatch" : "not_introduced",
             peer: peerRef(event.sourceRuntimeId)
@@ -40730,7 +40809,7 @@ var require_headless_session_bridge = __commonJS({
       };
     }
     var HeadlessSessionBridge = class {
-      constructor({ runtime, remoteClient, peerRuntimeNetwork = null, dataPath, deliverMessage, createPairingLink = null, randomBytes = crypto.randomBytes } = {}) {
+      constructor({ runtime, remoteClient, peerRuntimeNetwork = null, dataPath, deliverMessage, listLocalSessions = null, readLocalTranscript = null, createPairingLink = null, randomBytes = crypto.randomBytes } = {}) {
         if (!runtime || !remoteClient || typeof deliverMessage !== "function" || !path.isAbsolute(dataPath || "")) {
           throw new Error("CAS Cloud session bridge configuration is invalid");
         }
@@ -40739,6 +40818,8 @@ var require_headless_session_bridge = __commonJS({
         this.peerRuntimeNetwork = peerRuntimeNetwork;
         this.dataPath = dataPath;
         this.deliverMessage = deliverMessage;
+        this.listLocalSessions = typeof listLocalSessions === "function" ? listLocalSessions : null;
+        this.readLocalTranscript = typeof readLocalTranscript === "function" ? readLocalTranscript : null;
         this.createPairingLink = createPairingLink;
         this.adminToken = randomBytes(32).toString("hex");
         this.sessionSecret = randomBytes(32);
@@ -40917,7 +40998,7 @@ var require_headless_session_bridge = __commonJS({
         });
       }
       async _handle(request, response) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         const url = new URL(request.url, "http://127.0.0.1");
         if (url.pathname.startsWith("/admin/")) {
           if (!safeBearer(request, this.adminToken)) return sendJson(response, 401, { error: "Unauthorized" });
@@ -40969,11 +41050,29 @@ var require_headless_session_bridge = __commonJS({
                 payload: {}
               })
             })));
-            const sessions = results.flatMap((entry) => entry.status === "fulfilled" ? (({ state, result }) => (Array.isArray(result == null ? void 0 : result.sessions) ? result.sessions : []).slice(0, 100).flatMap((session) => session && typeof session.id === "string" && session.id.length <= 128 ? [{
+            const localSessions = (((_b = (_a = this.listLocalSessions) == null ? void 0 : _a.call(this)) == null ? void 0 : _b.sessions) || []).flatMap((session) => session && typeof session.id === "string" && session.id.length <= 128 ? [{
+              id: session.id,
+              name: clip(session.name, 120),
+              agent: clip(session.agent, 60),
+              project: clip(session.project, 160),
+              agent_id: clip(session.agent_id, 60),
+              project_icon: clip(session.project_icon, 140),
+              project_color: clip(session.project_color, 32),
+              goal: clip(session.goal, 1200),
+              activity: clip(session.activity, 500),
+              status: clip(session.status, 80),
+              surface: session.surface === "terminal" ? "terminal" : "chat",
+              state: ["working", "needs_input"].includes(session.state) ? session.state : "idle",
+              is_current: session.id === sourceSessionId
+            }] : []);
+            const remoteSessions = results.flatMap((entry) => entry.status === "fulfilled" ? (({ state, result }) => (Array.isArray(result == null ? void 0 : result.sessions) ? result.sessions : []).slice(0, 100).flatMap((session) => session && typeof session.id === "string" && session.id.length <= 128 ? [{
               id: encodeRemoteSessionId(state.runtime.id, session.id),
               name: clip(session.name, 120),
               agent: clip(session.agent, 60),
               project: clip(session.project, 160),
+              agent_id: clip(session.agent_id, 60),
+              project_icon: clip(session.project_icon, 140),
+              project_color: clip(session.project_color, 32),
               goal: clip(session.goal, 1200),
               activity: clip(session.activity, 500),
               status: clip(session.status, 80),
@@ -40982,7 +41081,7 @@ var require_headless_session_bridge = __commonJS({
               host: state.runtime.name || "Paired host",
               is_current: false
             }] : []))(entry.value) : []);
-            return sendJson(response, 200, { sessions });
+            return sendJson(response, 200, { sessions: [...localSessions, ...remoteSessions] });
           } catch (_) {
             return sendJson(response, 503, { error: "The paired Mac is offline" });
           }
@@ -40993,6 +41092,25 @@ var require_headless_session_bridge = __commonJS({
           if (!Number.isSafeInteger(limit) || limit < 1 || limit > 60) {
             return sendJson(response, 400, { error: "Conversation limit must be between 1 and 60" });
           }
+          if (this._sourceSession(body.target_session_id)) {
+            if (!this.readLocalTranscript) return sendJson(response, 503, { error: "Conversation reading is unavailable" });
+            try {
+              const result = await this.readLocalTranscript({ targetSessionId: body.target_session_id, limit });
+              const snapshot = boundedConversationMessages(result == null ? void 0 : result.messages, { limit });
+              return sendJson(response, 200, {
+                session: {
+                  id: body.target_session_id,
+                  name: clip((_c = result == null ? void 0 : result.session) == null ? void 0 : _c.name, 120),
+                  agent: clip((_d = result == null ? void 0 : result.session) == null ? void 0 : _d.agent, 60),
+                  project: clip((_e = result == null ? void 0 : result.session) == null ? void 0 : _e.project, 160)
+                },
+                messages: snapshot.messages,
+                truncated: (result == null ? void 0 : result.truncated) === true || snapshot.truncated
+              });
+            } catch (_) {
+              return sendJson(response, 503, { error: "The conversation could not be read" });
+            }
+          }
           let target;
           try {
             target = decodeRemoteSessionId(body.target_session_id);
@@ -41011,9 +41129,9 @@ var require_headless_session_bridge = __commonJS({
             return sendJson(response, 200, {
               session: {
                 id: body.target_session_id,
-                name: clip((_a = result == null ? void 0 : result.session) == null ? void 0 : _a.name, 120),
-                agent: clip((_b = result == null ? void 0 : result.session) == null ? void 0 : _b.agent, 60),
-                project: clip((_c = result == null ? void 0 : result.session) == null ? void 0 : _c.project, 160),
+                name: clip((_f = result == null ? void 0 : result.session) == null ? void 0 : _f.name, 120),
+                agent: clip((_g = result == null ? void 0 : result.session) == null ? void 0 : _g.agent, 60),
+                project: clip((_h = result == null ? void 0 : result.session) == null ? void 0 : _h.project, 160),
                 host: state.runtime.name || "Paired Mac"
               },
               messages: snapshot.messages,
@@ -41033,10 +41151,30 @@ var require_headless_session_bridge = __commonJS({
           this._pruneReplies();
           if (messageType === "response") {
             const pending = this.pendingReplies.get(body.reply_to_request_id);
-            if (!pending || pending.direction !== "incoming" || pending.sourceSessionId !== body.target_session_id || pending.targetSessionId !== sourceSessionId) {
+            if (!pending || !["incoming", "local"].includes(pending.direction) || pending.sourceSessionId !== body.target_session_id || pending.targetSessionId !== sourceSessionId) {
               return sendJson(response, 409, { error: "The response does not match an active session request" });
             }
             const source2 = this._sourceSession(sourceSessionId);
+            if (pending.direction === "local") {
+              try {
+                const result = await this.deliverMessage({
+                  targetSessionId: pending.sourceSessionId,
+                  sourceSessionId,
+                  sourceName: (source2 == null ? void 0 : source2.title) || `${(source2 == null ? void 0 : source2.agent) || "CAS Cloud"} session`,
+                  sourceAgent: (source2 == null ? void 0 : source2.agent) || (source2 == null ? void 0 : source2.provider) || "agent",
+                  message: body.message.trim(),
+                  messageType: "response",
+                  communicationRequestId: body.reply_to_request_id
+                });
+                this.pendingReplies.delete(body.reply_to_request_id);
+                return sendJson(response, 200, {
+                  success: true,
+                  status: (result == null ? void 0 : result.status) === "queued" ? "queued" : "delivered"
+                });
+              } catch (_) {
+                return sendJson(response, 503, { error: "The session could not receive the response" });
+              }
+            }
             if (!pending.reply({
               sourceSessionId: pending.replyTargetSessionId,
               targetSessionId: pending.remoteSourceSessionId,
@@ -41049,6 +41187,37 @@ var require_headless_session_bridge = __commonJS({
             this.pendingReplies.delete(body.reply_to_request_id);
             return sendJson(response, 200, { success: true, status: "delivered" });
           }
+          if (body.target_session_id === sourceSessionId) {
+            return sendJson(response, 400, { error: "A session cannot message itself" });
+          }
+          const source = this._sourceSession(sourceSessionId);
+          if (this._sourceSession(body.target_session_id)) {
+            const communicationRequestId2 = crypto.randomUUID();
+            this._rememberReply(communicationRequestId2, {
+              direction: "local",
+              sourceSessionId,
+              targetSessionId: body.target_session_id
+            });
+            try {
+              const result = await this.deliverMessage({
+                targetSessionId: body.target_session_id,
+                sourceSessionId,
+                sourceName: (source == null ? void 0 : source.title) || `${(source == null ? void 0 : source.agent) || "CAS Cloud"} session`,
+                sourceAgent: (source == null ? void 0 : source.agent) || (source == null ? void 0 : source.provider) || "agent",
+                message: body.message.trim(),
+                messageType: "request",
+                communicationRequestId: communicationRequestId2
+              });
+              return sendJson(response, 200, {
+                success: true,
+                status: (result == null ? void 0 : result.status) === "queued" ? "queued" : "delivered",
+                request_id: communicationRequestId2
+              });
+            } catch (_) {
+              this.pendingReplies.delete(communicationRequestId2);
+              return sendJson(response, 503, { error: "The session could not receive the request" });
+            }
+          }
           let target;
           try {
             target = decodeRemoteSessionId(body.target_session_id);
@@ -41056,7 +41225,6 @@ var require_headless_session_bridge = __commonJS({
             return sendJson(response, 400, { error: error.message });
           }
           if (!this._remoteClient(target.runtimeId)) return sendJson(response, 404, { error: "The remote session is unavailable" });
-          const source = this._sourceSession(sourceSessionId);
           const communicationRequestId = crypto.randomUUID();
           this._rememberReply(communicationRequestId, {
             direction: "outgoing",
@@ -41398,7 +41566,8 @@ var require_headless_project_registry = __commonJS({
         onOperation = () => {
         },
         maxConcurrentClones = MAX_CLONES,
-        stopTimeoutMs = 2e3
+        stopTimeoutMs = 2e3,
+        platform = process.platform
       }) {
         if (!(database == null ? void 0 : database.db)) throw new Error("HeadlessProjectRegistry requires a SQLite database");
         this.database = database;
@@ -41409,6 +41578,7 @@ var require_headless_project_registry = __commonJS({
         this.onOperation = onOperation;
         this.maxConcurrentClones = maxConcurrentClones;
         this.stopTimeoutMs = stopTimeoutMs;
+        this.platform = platform;
         this.stopping = false;
         this.running = /* @__PURE__ */ new Map();
         this.queue = [];
@@ -41527,6 +41697,19 @@ var require_headless_project_registry = __commonJS({
           const result = this._registerPath(resolved, root ? this._rootByPath(root.rootPath).root_id : null, { legacy: true });
           if (result.changed) changed = true;
         }
+        for (const row of this.db.prepare("SELECT project_id, path FROM runtime_projects WHERE registered = 1").all()) {
+          let resolved;
+          try {
+            resolved = fs.realpathSync(row.path);
+          } catch (_) {
+            continue;
+          }
+          if (resolved === row.path) continue;
+          const canonical = this.db.prepare("SELECT project_id FROM runtime_projects WHERE path = ? AND registered = 1").get(resolved);
+          if (!canonical || canonical.project_id === row.project_id) continue;
+          this.db.prepare("UPDATE runtime_projects SET registered = 0, updated_at = CURRENT_TIMESTAMP WHERE project_id = ?").run(row.project_id);
+          changed = true;
+        }
         return changed;
       }
       _resolveDirectory(candidate, label) {
@@ -41588,7 +41771,7 @@ var require_headless_project_registry = __commonJS({
           throw runtimeError("clone_root_insecure", "The configured clone root is not secure");
         }
         const effectiveUid = typeof process.geteuid === "function" ? process.geteuid() : null;
-        if (!stat.isDirectory() || effectiveUid !== null && stat.uid !== effectiveUid || (stat.mode & 18) !== 0) {
+        if (!stat.isDirectory() || this.platform !== "win32" && (effectiveUid !== null && stat.uid !== effectiveUid || (stat.mode & 18) !== 0)) {
           throw runtimeError("clone_root_insecure", "The configured clone root is not secure");
         }
         return stat;
@@ -41635,6 +41818,46 @@ var require_headless_project_registry = __commonJS({
       getRoots() {
         return this.db.prepare("SELECT root_id, name FROM runtime_project_roots ORDER BY created_at, root_id").all().map((root) => ({ rootId: root.root_id, name: String(root.name).slice(0, 200) }));
       }
+      gitAvailability() {
+        return new Promise((resolve) => {
+          var _a, _b;
+          let child;
+          let output = "";
+          let settled = false;
+          const finish = (result) => {
+            if (settled) return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(result);
+          };
+          const timer = setTimeout(() => {
+            try {
+              child == null ? void 0 : child.kill();
+            } catch (_) {
+            }
+            finish({ available: false });
+          }, 2e3);
+          (_a = timer.unref) == null ? void 0 : _a.call(timer);
+          try {
+            child = this.spawnImpl("git", ["--version"], {
+              shell: false,
+              stdio: ["ignore", "pipe", "ignore"],
+              windowsHide: true
+            });
+            (_b = child.stdout) == null ? void 0 : _b.on("data", (chunk) => {
+              output = `${output}${String(chunk)}`.slice(0, 200);
+            });
+            child.once("error", () => finish({ available: false }));
+            child.once("close", (code) => {
+              var _a2;
+              const version = (_a2 = /^git version\s+([^\s]+)/i.exec(output.trim())) == null ? void 0 : _a2[1];
+              finish(code === 0 ? { available: true, ...version ? { version } : {} } : { available: false });
+            });
+          } catch (_) {
+            finish({ available: false });
+          }
+        });
+      }
       listDirectories({ rootId, relativePath = "." } = {}) {
         const root = this._root(rootId);
         const currentPath = validateRelativePath(relativePath || ".");
@@ -41794,12 +42017,20 @@ var require_headless_project_registry = __commonJS({
         const revision = this._bumpRevision();
         return this._recordRequest(requestId, hash, { projectId: project.projectId, revision, updated: true });
       }
-      clone({ rootId, url, relativePath, requestId }) {
+      clone({ rootId, url, relativePath, displayName, color, icon, requestId }) {
         const normalizedUrl = validateGitUrl(url);
         const root = this._root(rootId);
         this._assertSecureCloneRoot(root);
         const normalizedRelative = validateCloneChildName(relativePath || cloneDirectoryName(normalizedUrl));
-        const hash = requestHash("clone", { rootId, url: normalizedUrl, relativePath: normalizedRelative });
+        const appearance = {
+          ...displayName !== void 0 ? { displayName: String(displayName || "").trim().slice(0, 120) } : {},
+          ...color !== void 0 ? { color: String(color || "").trim().slice(0, 32) } : {},
+          ...icon !== void 0 ? { icon } : {}
+        };
+        if (appearance.displayName !== void 0 && !appearance.displayName || appearance.icon !== void 0 && appearance.icon !== null && (typeof appearance.icon !== "string" || !ICON_PATTERN.test(appearance.icon))) {
+          throw runtimeError("invalid_project_update", "Project changes are invalid");
+        }
+        const hash = requestHash("clone", { rootId, url: normalizedUrl, relativePath: normalizedRelative, ...appearance });
         const duplicate = this._request(requestId, hash);
         if (duplicate) return duplicate;
         const destinationInfo = this._cloneDestination(root, normalizedRelative, normalizedUrl);
@@ -41816,6 +42047,7 @@ var require_headless_project_registry = __commonJS({
           requestId,
           rootId,
           url: normalizedUrl,
+          appearance,
           destination: destinationInfo.destination,
           temporaryDestination: null,
           temporaryIdentity: null,
@@ -41953,7 +42185,17 @@ var require_headless_project_registry = __commonJS({
               return this._finish(operation, "failed", "path_symlink_escape");
             }
             const registered = this._registerPath(resolved, root.root_id);
-            const revision = registered.changed ? this._bumpRevision() : this.getRevision();
+            if (Object.keys(operation.appearance).length) {
+              this.db.prepare(`UPDATE runtime_projects
+            SET display_name = COALESCE(?, display_name), color = COALESCE(?, color), icon = ?, updated_at = CURRENT_TIMESTAMP
+            WHERE project_id = ?`).run(
+                operation.appearance.displayName ?? null,
+                operation.appearance.color ?? null,
+                operation.appearance.icon === void 0 ? registered.row.icon || null : operation.appearance.icon,
+                registered.row.project_id
+              );
+            }
+            const revision = registered.changed || Object.keys(operation.appearance).length ? this._bumpRevision() : this.getRevision();
             this.db.prepare(`UPDATE runtime_project_operations SET state = 'succeeded', project_id = ?, error = NULL, updated_at = CURRENT_TIMESTAMP WHERE operation_id = ?`).run(registered.row.project_id, operation.operationId);
             this.running.delete(operation.operationId);
             this.destinations.delete(operation.destination);
@@ -42035,6 +42277,7 @@ var require_headless_project_registry = __commonJS({
       contained,
       runtimeError,
       validateGitUrl,
+      cloneDirectoryName,
       validateCloneChildName,
       validateRelativePath
     };
@@ -49241,6 +49484,8 @@ var require_headless_runtime = __commonJS({
     var os = require("os");
     var path = require("path");
     var { DriverChatManager, SESSION_EVENT } = require_driver_chat_manager();
+    var { CHAT_PERMISSION_MODES } = require_chat_permission_modes();
+    var { classifyProviderStartupError } = require_provider_auth();
     var { boundedConversationMessages } = require_chat_history_pagination();
     var { MobileRuntime } = require_mobile_runtime();
     var { MobileRelayClient } = require_mobile_relay_client();
@@ -49290,6 +49535,7 @@ var require_headless_runtime = __commonJS({
       "project.register",
       "project.clone",
       "project.clone.cancel",
+      "project.git.availability",
       "project.unregister",
       "shortcuts.manage",
       "session.action",
@@ -49314,18 +49560,11 @@ var require_headless_runtime = __commonJS({
       "workspace.git.switch",
       "workspace.git.create"
     ]);
-    var FINAL_COORDINATION_STATUSES = /* @__PURE__ */ new Set(["done", "pushed", "completed", "finished"]);
-    var COORDINATION_IDLE_MS = 30 * 6e4;
     var COORDINATION_COMPLETION_GRACE_MS = 5e3;
-    function isCoordinatedSessionEligible(session, now = Date.now()) {
-      var _a, _b, _c;
-      if (!session || session.state === "stopped" || typeof session.terminalUuid !== "string" || !session.terminalUuid) return false;
-      const status = typeof session.workStatus === "string" ? session.workStatus.trim().toLowerCase() : "";
-      if (FINAL_COORDINATION_STATUSES.has(status)) return false;
-      if (((_a = session.currentTurn) == null ? void 0 : _a.state) === "running" || status === "needs_input" || status === "working") return true;
-      const lastActivity = Number(session.lastActivityAt) || Date.parse(session.lastActivityAt);
-      if (Number.isFinite(lastActivity) && now - lastActivity > COORDINATION_IDLE_MS) return false;
-      return Array.from(((_c = (_b = session.items) == null ? void 0 : _b.values) == null ? void 0 : _c.call(_b)) || []).some((item) => (item == null ? void 0 : item.itemType) === "user_message" || (item == null ? void 0 : item.itemType) === "assistant_message");
+    function isCoordinatedSessionEligible(session) {
+      return Boolean(
+        session && session.state !== "stopped" && typeof session.terminalUuid === "string" && session.terminalUuid
+      );
     }
     function appDataPath({ env = process.env, platform = process.platform, home = os.homedir() } = {}) {
       if (platform === "linux") {
@@ -49581,7 +49820,8 @@ var require_headless_runtime = __commonJS({
       quotaService: suppliedQuotaService = null,
       generateConversationTitle: generateConversationTitleFn = generateConversationTitle,
       forkConversation: forkConversationFn = forkConversation,
-      spawnImpl
+      spawnImpl,
+      getuid = typeof process.getuid === "function" ? () => process.getuid() : null
     } = {}) {
       if (typeof getToken !== "function") throw new Error("CAS CLI requires an access token provider");
       if (!validIdentity(identity)) throw new Error("CAS CLI identity is invalid");
@@ -49623,7 +49863,17 @@ var require_headless_runtime = __commonJS({
       const startSessionWithPreferences = async (options) => {
         const launchOptions = chatPreferences.apply(options.agent, options);
         if (launchOptions.permissionMode === void 0) launchOptions.permissionMode = "default";
-        const started = await manager.startSession(launchOptions);
+        if (options.agent === "claude" && launchOptions.permissionMode === CHAT_PERMISSION_MODES.FULL_ACCESS && (getuid == null ? void 0 : getuid()) === 0) launchOptions.permissionMode = "default";
+        let started;
+        try {
+          started = await manager.startSession(launchOptions);
+        } catch (error) {
+          const status = classifyProviderStartupError(options.agent, error);
+          if (status) {
+            error.code = status.state === "not_installed" ? "provider_not_installed" : "provider_unauthenticated";
+          }
+          throw error;
+        }
         chatPreferences.write(started.agent || options.agent, {
           permissionMode: started.permissionMode,
           effort: started.effort
@@ -49769,17 +50019,20 @@ var require_headless_runtime = __commonJS({
       };
       const listCoordinatedSessions = () => ({
         sessions: Array.from(runtime.sessions.values()).flatMap((session) => {
-          var _a, _b;
+          var _a, _b, _c, _d;
           return isCoordinatedSessionEligible(session) ? [{
             id: session.terminalUuid,
             name: session.title || `${session.agent || "Agent"} session`,
             agent: session.agent || session.provider || "",
+            agent_id: session.agent || session.provider || "",
             project: ((_a = session.project) == null ? void 0 : _a.name) || "",
+            project_icon: ((_b = session.project) == null ? void 0 : _b.icon) || "",
+            project_color: ((_c = session.project) == null ? void 0 : _c.color) || "",
             goal: session.goal || "",
             activity: session.activity || "",
             status: session.workStatus || "",
             surface: "chat",
-            state: session.workStatus === "needs_input" ? "needs_input" : ((_b = session.currentTurn) == null ? void 0 : _b.state) === "running" ? "working" : "idle"
+            state: session.workStatus === "needs_input" ? "needs_input" : ((_d = session.currentTurn) == null ? void 0 : _d.state) === "running" ? "working" : "idle"
           }] : [];
         }).slice(0, 100)
       });
@@ -50053,6 +50306,7 @@ ${message}`;
         registerProject: (payload) => registry.register(payload),
         cloneProject: (payload) => registry.clone(payload),
         cancelProjectClone: (payload) => registry.cancelClone(payload),
+        gitAvailability: () => registry.gitAvailability(),
         unregisterProject: (payload) => {
           const busy = startingProjects.has(payload.projectId) || Array.from(runtime.sessions.values()).some((session) => {
             var _a;
@@ -50129,6 +50383,8 @@ ${message}`;
         peerRuntimeNetwork,
         dataPath: resolvedDataPath,
         deliverMessage: deliverCoordinatedMessage,
+        listLocalSessions: listCoordinatedSessions,
+        readLocalTranscript: readCoordinatedTranscript,
         createPairingLink: async () => {
           const pairing = await relay.createPairing();
           return { url: desktopConnectionLink(pairing), expiresAt: pairing.expiresAt };
@@ -50175,7 +50431,7 @@ ${message}`;
                     }
                     terminalOrder = Math.max(terminalOrder, saved.terminalOrder || 0);
                     try {
-                      const started = await manager.startSession({
+                      const started = await startSessionWithPreferences({
                         agent: saved.agent,
                         ...saved.accountId && saved.accountId !== "current" ? { accountId: saved.accountId } : {},
                         cwd: saved.cwd,
@@ -50586,6 +50842,9 @@ var require_mobile_pairing_ipc = __commonJS({
     "use strict";
     var MOBILE_PAIRING_EVENT = "mobile-pairing:event";
     var { PRODUCTION_MOBILE_WEB_ORIGIN } = require_mobile_build_channel();
+    var WARM_PAIRING_MIN_REMAINING_MS = 2 * 6e4;
+    var WARM_PAIRING_CHECK_INTERVAL_MS = 3e4;
+    var WARM_PAIRING_SERVE_MIN_REMAINING_MS = 15e3;
     function pairingPayload(pairing, mobileWebOrigin = PRODUCTION_MOBILE_WEB_ORIGIN) {
       const credentials = new URL("codeagentswarm://pair");
       credentials.searchParams.set("relay", new URL(pairing.relayOrigin).origin);
@@ -50607,13 +50866,49 @@ var require_mobile_pairing_ipc = __commonJS({
       setKeepAvailable = () => false,
       createQrDataUrl = (payload, options) => require("qrcode").toDataURL(payload, options)
     }) {
+      var _a;
       const broadcast = (message) => {
         for (const window2 of BrowserWindow.getAllWindows()) {
           if (!window2.isDestroyed()) window2.webContents.send(MOBILE_PAIRING_EVENT, message);
         }
       };
-      relayClient.on("status", (status) => broadcast({ type: "status", status }));
-      relayClient.on("event", (event) => broadcast({ type: "relay", event }));
+      const buildPairing = async () => {
+        const pairing = await relayClient.createPairing();
+        const qrDataUrl = await createQrDataUrl(
+          pairingPayload(pairing, mobileWebOrigin),
+          {
+            scale: 8,
+            margin: 4,
+            errorCorrectionLevel: "L",
+            color: { dark: "#111827", light: "#ffffff" }
+          }
+        );
+        return { expiresAt: pairing.expiresAt, pairingCode: pairing.pairingCode, qrDataUrl };
+      };
+      let warm = null;
+      let warming = null;
+      const warmPairing = () => {
+        if (warming || relayClient.status !== "online") return warming;
+        const remaining = warm ? warm.expiresAt - Date.now() : 0;
+        if (warm && (warm.served ? remaining > 0 : remaining > WARM_PAIRING_MIN_REMAINING_MS)) return null;
+        warming = buildPairing().then((result) => {
+          warm = result;
+        }, () => {
+        }).finally(() => {
+          warming = null;
+        });
+        return warming;
+      };
+      const warmTimer = setInterval(warmPairing, WARM_PAIRING_CHECK_INTERVAL_MS);
+      (_a = warmTimer.unref) == null ? void 0 : _a.call(warmTimer);
+      relayClient.on("status", (status) => {
+        broadcast({ type: "status", status });
+        if ((status == null ? void 0 : status.status) === "online") void warmPairing();
+      });
+      relayClient.on("event", (event) => {
+        if ((event == null ? void 0 : event.kind) === "pair.scanned") warm = null;
+        broadcast({ type: "relay", event });
+      });
       ipcMain.handle("mobile-pairing:status", () => ({
         success: true,
         ...relayClient.getStatus(),
@@ -50645,23 +50940,16 @@ var require_mobile_pairing_ipc = __commonJS({
       ipcMain.handle("mobile-pairing:create", async () => {
         try {
           if (getKeepAvailable() == null) setKeepAvailable(true);
-          const pairing = await relayClient.createPairing();
-          const qrDataUrl = await createQrDataUrl(
-            pairingPayload(pairing, mobileWebOrigin),
-            {
-              scale: 8,
-              margin: 4,
-              errorCorrectionLevel: "L",
-              color: { dark: "#111827", light: "#ffffff" }
-            }
-          );
+          if (warming) await warming;
+          if (!warm || warm.expiresAt - Date.now() < WARM_PAIRING_SERVE_MIN_REMAINING_MS) warm = await buildPairing();
+          warm.served = true;
           return {
             success: true,
-            expiresAt: pairing.expiresAt,
-            pairingCode: pairing.pairingCode,
+            expiresAt: warm.expiresAt,
+            pairingCode: warm.pairingCode,
             webUrl: mobileWebOrigin,
             keepAvailable: getKeepAvailable() === true,
-            qrDataUrl
+            qrDataUrl: warm.qrDataUrl
           };
         } catch (error) {
           return { success: false, error: error.message };
@@ -50707,7 +50995,7 @@ var require_cas = __commonJS({
       loadIdentity,
       resolveProject
     } = require_headless_runtime();
-    var version = true ? "0.0.12" : JSON.parse(fs.readFileSync(path.join(__dirname, "..", "..", "package.json"), "utf8")).version;
+    var version = true ? "0.0.16" : JSON.parse(fs.readFileSync(path.join(__dirname, "..", "..", "package.json"), "utf8")).version;
     function help() {
       return `CAS CLI ${version}