perchai-cli 2.4.48 → 2.4.50

package/dist/perch.mjs

@@ -75566,7 +75566,6 @@ var init_payroll = __esm({
 // lib/perchBusinessTools/index.ts
 var init_perchBusinessTools = __esm({
   "lib/perchBusinessTools/index.ts"() {
-    "use strict";
     init_generateAPAuditPacket();
     init_inventoryFolder();
     init_loadBusinessTables();
@@ -83486,6 +83485,8 @@ Browser Operator skill contract:
 - Prefer browser_execute_task for short multi-step jobs: include the goal, requiredValues, successCriteria, allowSharingChange only when the user explicitly approved access changes, and a bounded steps array.
 - Use semantic browser tools for ordinary controls with text, role, or aria labels.
 - Use browser_visual_click or browser_focus_type for canvas, iframe, document-body, drag/drop, or targets that are visible but not exposed as DOM elements.
+- When a semantic click reports no DOM match, the runner auto-escalates to a coordinate/visual (CUA) click on the same target before failing. Do not re-issue the identical semantic click; if it still fails, escalate yourself with browser_visual_click on the target you can see, then report a blocker only if the coordinate click also fails.
+- For targets behind a menu, dropdown, or kebab/overflow (e.g. Reddit "Mod Tools", a "More" menu): observe \u2192 click the parent menu/trigger to open it \u2192 observe \u2192 then click the now-visible item. Do not click a hidden menu item directly; open its parent first.
 - If coordinate tools are unavailable and the target is only visually reachable, do not loop empty semantic clicks; report the missing visual-action capability.
 - For Google Docs: never inspect, open, or change the Viewing / Editing / Suggesting mode dropdown during normal writing or recovery. New Docs should already start editable. If the visible toolbar is already read-only, Viewing, or Suggesting, stop with a permission/mode blocker instead of trying to switch modes yourself. Collapse Document tabs/outlines if they cover the page, click/type into the visible paper area, and verify with URL/title/save status/screenshot. Do not trust DOM body readback as required proof because Kix can be visually written while DOM snapshots stay blank.
 - Never claim completion from intent alone; require visible proof, save/sent status, URL, receipt, or screenshot evidence.
@@ -83591,17 +83592,20 @@ Rules:
       name: "Browser Operator",
       description: "Operates a logged-in browser turn-by-turn for Quill delivery and web tasks.",
       // Browser work runs on the selected main model. Native vision models see
-      // screenshots directly; text-only models can call the plain vision observer
-      // with visionInspect({ currentScreen: true }) when visual confirmation matters.
+      // screenshots directly; for text-only models the loop automatically runs each
+      // post-action screenshot through the vision sidecar and injects the readout,
+      // so the operator is always sighted. visionInspect({ currentScreen: true })
+      // remains available for targeted follow-up questions.
       lane: "chat",
       systemPrompt: `You are Quill's Browser Operator. You operate the user's logged-in browser like a careful human.
 
 Rules:
 - Drive the browser by looking and acting on what you see by name. Never use remembered IDs, refs, CSS selectors, or raw Playwright tools.
 - Before tool calls, send short live preambles so the user sees steady progress: 1-2 friendly sentences, usually 8-12 words. Group related actions. Examples: "I've created the doc; now opening it to verify the title rendered." / "Email's filled; sending and watching for the confirmation." Final summary stays concise, 10 lines or fewer.
-- Use browser_execute_task for short verified sequences, or browser_navigate, browser_observe, browser_click, browser_type, browser_visual_click, browser_focus_type, browser_press_key, browser_read, browser_wait, and browser_handle_dialog for one-off recovery steps. For browser_click/browser_type, pass a semantic target with text, role, ariaLabel, and optional nth. For browser_visual_click/browser_focus_type, pass screenshot-relative x/y coordinates, usually 0-1 viewport fractions.
+- Use browser_execute_task for short verified sequences, or browser_navigate, browser_observe, browser_click, browser_type, browser_visual_click, browser_focus_type, browser_press_key, browser_read, browser_wait, and browser_handle_dialog for one-off recovery steps. For browser_click/browser_type, pass a semantic target with text, role, ariaLabel, and optional nth. For browser_visual_click/browser_focus_type, ALWAYS pass a label naming the target \u2014 the runner grounds that label against the live DOM (including shadow-DOM web components) and clicks the real element; the x/y you pass is only a last-resort fallback for true canvas/non-DOM targets (e.g. the Google Docs paper). Prefer naming the target over guessing coordinates.
+- To fill a field on a web-component/shadow-DOM site (e.g. Reddit's title/body): browser_visual_click the field to focus it, then browser_type the text \u2014 typing goes into the focused field, so you do not need a semantic target. If a type reports the field is still empty, visual_click the field again to focus it, then retype; do not repeat a type into an unfocused field.
 - One action, then look at the result, then choose the next action. If a click does nothing, observe again and try a different visible target; do not repeat the same failed click more than once.
-- After each action, inspect the fresh browser result before deciding the next action. If you can see an attached screenshot, use it as the source of truth. If you cannot see images and visual details matter, call visionInspect with {"currentScreen": true, "prompt": "what to verify"}.
+- After each action, inspect the fresh browser result before deciding the next action. If you can see an attached screenshot, use it as the source of truth. If the result instead carries a "Vision readout of the current screen" message, a vision sidecar already looked for you \u2014 trust it as the source of truth and use the x/y viewport fractions it names for any browser_visual_click. Only call visionInspect with {"currentScreen": true, "prompt": "..."} when you need a more specific visual question answered.
 - Safety: never click anything that grants access or changes sharing/permissions, such as "Share & send", "Share", or "Grant access". If a share/permission dialog appears, choose the option that sends without changing permissions, such as "Send without sharing" or "Send anyway".
 - Do not claim completion unless the browser shows a confirmation, URL, saved state, sent state, or other visible receipt.
 
@@ -86236,7 +86240,8 @@ var init_desktopContextSection = __esm({
     BROWSER_EXECUTION_GUIDANCE = `## Browser execution \u2014 logged-in web surface
 Use the embedded browser as the logged-in execution surface for web apps, account-bound pages, SPAs, and recovery paths. Google delivery uses verified shortcuts first; non-Google apps and pages without a verified surface tool are browser-first.
 Prefer browser_execute_task for short multi-step browser jobs because it carries the goal, requiredValues, successCriteria, sharing/mode flags, and enforced policy in one guarded runner. Use browser_navigate, browser_observe, browser_click, browser_type, browser_visual_click, browser_focus_type, browser_press_key, and browser_wait for single-step recovery. You already have these tools here; do not spawn browser_operator unless you are explicitly running a coordinator/suite workflow where workers own tools.
-Every browser step returns fresh snapshot text and perception fields. Vision-capable turns also receive one annotated screenshot; successful clicks include clickPoint/bounds so you can verify exactly what changed.
+Every browser step returns fresh snapshot text and perception fields. Vision-capable turns also receive one annotated screenshot; successful clicks include clickPoint/bounds so you can verify exactly what changed. On a text-only model the loop automatically runs each post-action screenshot through the vision sidecar and injects a "Vision readout of the current screen" message \u2014 trust it as the source of truth and use the x/y viewport fractions it names for any browser_visual_click instead of guessing coordinates.
+When a semantic browser_click finds no DOM match, the runner auto-escalates to a coordinate/visual (CUA) click on the same target before returning a failure, so the cursor still moves. Never re-issue the identical semantic click; if it still fails, escalate yourself with browser_visual_click on the visible target, and report a blocker only after the coordinate click also fails. browser_visual_click grounds its label against the live DOM (including shadow-DOM web components) and clicks the real element \u2014 always pass a label; the x/y is only a fallback for true canvas/non-DOM targets. To fill a field on a web-component/shadow-DOM site (e.g. Reddit), browser_visual_click the field to focus it then browser_type the text (typing goes into the focused field; no semantic target needed); if the type reports the field still empty, visual_click it again and retype. For a target behind a menu/dropdown/overflow (e.g. Reddit "Mod Tools"), observe \u2192 click the parent trigger to open the menu \u2192 observe \u2192 then click the now-visible item rather than clicking a hidden item.
 If a verified tool returns needs_operator with a live URL/snapshot/screenshot, continue from that evidence with the browser primitives. If it reports the embedded browser/session is disconnected or unavailable, report that blocker instead of trying raw MCP/Playwright or claiming success. Do not restart the task or dispatch a separate browser worker.`;
   }
 });
@@ -87398,7 +87403,7 @@ var init_threadLedger = __esm({
 });
 
 // features/perchTerminal/runtime/perchMemoryGuidance.ts
-var VISIBLE_OUTPUT_STYLE_GUIDANCE, SAFFRON_STYLE_CONTRACT, QUILL_STYLE_CONTRACT, SAFFRON_CORE_IDENTITY, QUILL_CORE_IDENTITY, PERCH_MEMORY_GUIDANCE;
+var VISIBLE_OUTPUT_STYLE_GUIDANCE, PERCH_OPERATOR_CAPABILITIES, SAFFRON_STYLE_CONTRACT, QUILL_STYLE_CONTRACT, SAFFRON_CORE_IDENTITY, QUILL_CORE_IDENTITY, PERCH_MEMORY_GUIDANCE;
 var init_perchMemoryGuidance = __esm({
   "features/perchTerminal/runtime/perchMemoryGuidance.ts"() {
     "use strict";
@@ -87413,6 +87418,36 @@ Avoid stock AI phrases: "delve," "nuanced," "robust," "seamless,"
 Be concise when the user is moving fast.
 Preserve the persona: Quill is warm, literate, and direct; Saffron is sharp,
 practical, and confident.
+`.trim();
+    PERCH_OPERATOR_CAPABILITIES = `
+## What you can do (and you can do a lot)
+
+You run on the user's Mac through Perch Desktop. You are a real operator, not a
+chat box, and you have the tools to act. When someone asks what you can do, or
+whether you can control their computer, answer with specifics and offer to show
+them rather than listing what you cannot do. You can:
+
+- Run shell commands in folders the user approves, including installing tools and
+  packages, running scripts and software, and starting long jobs in the background.
+- Work across their files: read, write, edit, search with glob and grep, move,
+  and organize anything inside approved folders.
+- Run real analysis in a sealed sandbox: write and execute Python or Node over
+  their actual data.
+- Drive a real browser: navigate, click, type, fill forms, research the web, and
+  pull sources.
+- Deliver finished work: draft and send Gmail, create Google Docs and Sheets, and
+  add calendar events.
+- Do forensic and financial work: AP audits, reconciliations, statement and
+  earnings reviews, and multi-step suites.
+
+Lead with what you can do and offer to prove it, for example "want me to run
+something to show you?". Do not talk yourself down or open with a list of limits.
+
+State the real limits once, and only when they matter: file and command access is
+scoped to the folders the user approves, and commands run under their permission
+settings. You work through the shell, their files, the sandbox, and the browser,
+not through arbitrary macOS system settings or other desktop apps. That is already
+a lot. Show it.
 `.trim();
     SAFFRON_STYLE_CONTRACT = `
 ## Voice contract \u2014 Saffron (visible output only)
@@ -87449,6 +87484,8 @@ You genuinely enjoy finding something interesting buried in a mess.
 
 You're not an assistant. You're the operator who gets the work done.
 
+${PERCH_OPERATOR_CAPABILITIES}
+
 ## How you work
 
 Lead with the finding. Skip the preamble. "Seven duplicate payments, same vendor,
@@ -87579,6 +87616,8 @@ the user needs analysis, files, data, an audit, or delivery, you do that work
 yourself with the same tools \u2014 in your own voice. You never punt real work to
 another persona.
 
+${PERCH_OPERATOR_CAPABILITIES}
+
 ## How you work
 
 Read first. Before you draft a single sentence, you know what the piece is for,
@@ -91110,6 +91149,7 @@ Final answers lead with findings, name artifacts or delivery status, and give on
 var MARKET_DESK_TOOL_NAMES;
 var init_marketDeskAccess = __esm({
   "features/perchTerminal/runtime/marketDesk/marketDeskAccess.ts"() {
+    "use strict";
     init_toolNames();
     MARKET_DESK_TOOL_NAMES = /* @__PURE__ */ new Set([
       TOOL_NAMES.getMarketSignal,
@@ -91789,6 +91829,7 @@ function listFinancialPlaybooks() {
 var AP_AUDIT_PACKET_DEF, PLAYBOOKS;
 var init_registry2 = __esm({
   "features/perchTerminal/runtime/financialPlaybooks/registry.ts"() {
+    "use strict";
     init_managedWorkflowRegistry2();
     init_toolNames();
     AP_AUDIT_PACKET_DEF = {
@@ -92416,6 +92457,297 @@ var init_coreSystemPromptLanes = __esm({
   }
 });
 
+// lib/perchTerminal/appHostGate.ts
+var PERCH_CHAT_WEB_URL, PERCH_MARKETING_SITE_URL, PERCH_MARKETING_DESKTOP_URL, PERCH_MARKETING_CLI_URL, PERCH_CLI_INSTALL_COMMAND;
+var init_appHostGate = __esm({
+  "lib/perchTerminal/appHostGate.ts"() {
+    PERCH_CHAT_WEB_URL = process.env.NEXT_PUBLIC_PERCHAI_WEB_URL?.trim() || "https://chat.perchai.app";
+    PERCH_MARKETING_SITE_URL = process.env.NEXT_PUBLIC_MARKETING_SITE_URL?.trim() || "https://perchai.app";
+    PERCH_MARKETING_DESKTOP_URL = `${PERCH_MARKETING_SITE_URL}/desktop`;
+    PERCH_MARKETING_CLI_URL = `${PERCH_MARKETING_SITE_URL}/cli`;
+    PERCH_CLI_INSTALL_COMMAND = "npm install -g perchai-cli";
+  }
+});
+
+// lib/perch-ai/plan-catalog.ts
+var PERCH_AI_PLAN_CATALOG;
+var init_plan_catalog = __esm({
+  "lib/perch-ai/plan-catalog.ts"() {
+    PERCH_AI_PLAN_CATALOG = [
+      {
+        code: "internal",
+        name: "Internal",
+        description: "Full Perch AI internal/admin access for Perch Terminal operators.",
+        entitlements: {
+          "shell.preview": { enabled: true },
+          "auth.access_codes.redeem": { enabled: true },
+          "desktop.runtime": { enabled: true },
+          "coding.workspace": { enabled: true },
+          "ap.audit": { enabled: true },
+          "writing.studio": { enabled: true },
+          "writing.studio.web": { enabled: true },
+          "admin.console": { enabled: true },
+          "limits.daily_runs": { limit: null },
+          "limits.weekly_runs": { limit: null },
+          "limits.max_context_tokens": { limit: 2e5 },
+          "limits.allowed_models": { models: ["*"] }
+        }
+      },
+      {
+        code: "pilot",
+        name: "Pilot",
+        description: "Self-serve pilot access with full product features.",
+        entitlements: {
+          "shell.preview": { enabled: true },
+          "auth.access_codes.redeem": { enabled: true },
+          "desktop.runtime": { enabled: true },
+          "coding.workspace": { enabled: true },
+          "ap.audit": { enabled: true },
+          "writing.studio": { enabled: true },
+          "writing.studio.web": { enabled: true },
+          // Admin console stays off for self-serve signups (it grants operator/admin
+          // tooling, not a product feature). Flip to true only for trusted accounts.
+          "admin.console": { enabled: false },
+          "limits.daily_runs": { limit: null },
+          "limits.weekly_runs": { limit: null },
+          "limits.max_context_tokens": { limit: 2e5 },
+          "limits.allowed_models": { models: ["*"] }
+        }
+      },
+      {
+        code: "demo",
+        name: "Demo",
+        description: "Restricted demo access for guided evaluations.",
+        entitlements: {
+          "shell.preview": { enabled: true },
+          "auth.access_codes.redeem": { enabled: true },
+          "desktop.runtime": { enabled: false },
+          "coding.workspace": { enabled: false },
+          "ap.audit": { enabled: false },
+          "writing.studio": { enabled: false },
+          "writing.studio.web": { enabled: false },
+          "admin.console": { enabled: false },
+          "limits.daily_runs": { limit: 10 },
+          "limits.weekly_runs": { limit: 30 },
+          "limits.max_context_tokens": { limit: 32e3 },
+          "limits.allowed_models": { models: ["gpt-4o-mini"] }
+        }
+      }
+    ];
+  }
+});
+
+// features/perchTerminal/runtime/roost.ts
+function normalizeRoostTier(value) {
+  if (value === "max") return "pro_max";
+  return isRoostTier(value) ? value : null;
+}
+function normalizeRoostModelChoice(value) {
+  if (value === "internal") return "internal";
+  return normalizeRoostTier(value);
+}
+function isRoostTier(value) {
+  return value === "standard" || value === "standard_max" || value === "pro" || value === "pro_max";
+}
+var ROOST_TIERS, ROOST_TIER_LABELS, ROOST_TIER_CONTEXT_LABELS;
+var init_roost = __esm({
+  "features/perchTerminal/runtime/roost.ts"() {
+    "use strict";
+    init_modelRegistry();
+    ROOST_TIERS = ["standard", "standard_max", "pro", "pro_max"];
+    ROOST_TIER_LABELS = {
+      standard: "Standard",
+      standard_max: "Standard Max",
+      pro: "Pro",
+      pro_max: "Pro Max"
+    };
+    ROOST_TIER_CONTEXT_LABELS = {
+      standard: "200K context",
+      standard_max: "1M context",
+      pro: "200K context",
+      pro_max: "1M context"
+    };
+  }
+});
+
+// lib/perch/perchFactsCore.ts
+function getPilotEntitlements() {
+  const pilot = PERCH_AI_PLAN_CATALOG.find((p) => p.code === "pilot");
+  if (!pilot) return null;
+  return pilot.entitlements;
+}
+function formatUsageLine() {
+  const ent = getPilotEntitlements();
+  if (!ent) return "Usage limits are configured per plan.";
+  const daily = ent["limits.daily_runs"]?.limit;
+  const weekly = ent["limits.weekly_runs"]?.limit;
+  if (daily === null && weekly === null) {
+    return "No credit card is required. Usage is generous for the pilot period. Perch may apply fair-use limits to keep the service reliable for everyone.";
+  }
+  const parts = [];
+  if (daily !== null && daily !== void 0) parts.push(`${daily} runs per day`);
+  if (weekly !== null && weekly !== void 0) parts.push(`${weekly} runs per week`);
+  return `Usage is capped at ${parts.join(" and ")} on this plan. No credit card is required.`;
+}
+function buildRoostTierSummary() {
+  const lines = ROOST_TIERS.map(
+    (tier) => `- ${ROOST_TIER_LABELS[tier]} (${ROOST_TIER_CONTEXT_LABELS[tier]})`
+  );
+  return lines.join("\n");
+}
+function buildWebCapabilityList() {
+  return [
+    "- Grounded answers with real inline citations from your uploaded documents.",
+    "- Upload and ask: PDF, spreadsheet, image, and document analysis.",
+    "- Web search with cited results.",
+    "- Draft citation check: marks each claim verified or unverified.",
+    "",
+    "The web chat does not run shell commands, access your local files, control a browser,",
+    `or operate your computer. Those capabilities live in Perch Terminal (Desktop and CLI).`,
+    `Get Perch Terminal at ${PERCH_MARKETING_DESKTOP_URL}.`
+  ].join("\n");
+}
+function buildTerminalCapabilityList() {
+  const skillLines = DEDUPLICATED_SKILLS.map(
+    (s) => `- ${s.id}: ${s.description}`
+  ).join("\n");
+  return [
+    "Core operator capabilities (available in Desktop and CLI):",
+    "- Run shell commands in folders the user approves.",
+    "- Read, write, edit, search, and organize files across approved folders.",
+    "- Run real analysis in a sealed sandbox: Python and Node over actual data.",
+    "- Drive a real browser: navigate, click, fill forms, research the web.",
+    "- Deliver finished work: draft and send Gmail, create Google Docs and Sheets, add calendar events.",
+    "- Financial and forensic work: AP audits, reconciliations, statement and earnings reviews, multi-step suites.",
+    "",
+    "Specialized skills (activated per task from the skill registry):",
+    skillLines
+  ].join("\n");
+}
+function buildPerchFactsCore(surface) {
+  const capabilitySection = surface === "web" ? `### What this web chat can do
+
+${buildWebCapabilityList()}` : `### What Perch Terminal can do
+
+${buildTerminalCapabilityList()}`;
+  const tierTwoNote = surface === "terminal" ? `
+For deep detail on Perch (per-tier specifics, full workflow matrix, FAQ), consult the "about-perch" skill when a question goes beyond the facts above.` : "";
+  return [
+    INSTRUCTION_PREAMBLE,
+    "",
+    WHAT_IS_PERCH,
+    "",
+    ACCESS_AND_PRICING,
+    "",
+    MODEL_STORY,
+    "",
+    capabilitySection,
+    tierTwoNote
+  ].join("\n").trim();
+}
+var PERCH_SKILL_REGISTRY, DEDUPLICATED_SKILLS, INSTRUCTION_PREAMBLE, WHAT_IS_PERCH, ACCESS_AND_PRICING, MODEL_STORY;
+var init_perchFactsCore = __esm({
+  "lib/perch/perchFactsCore.ts"() {
+    init_appHostGate();
+    init_plan_catalog();
+    init_roost();
+    PERCH_SKILL_REGISTRY = [
+      {
+        id: "workspace",
+        description: "Navigate, inspect, search, summarize, and safely edit local workspaces, attached folders, source inventories, project files, and codebases with exact file-grounded evidence."
+      },
+      {
+        id: "browser-operator",
+        description: "Operate Perch's logged-in browser surface using visual state, semantic DOM targets, and coordinate actions when available."
+      },
+      {
+        id: "research",
+        description: "Gather, compare, rank, and cite evidence from public web sources, scholarly sources, workspace files, source packets, and attached local folders."
+      },
+      {
+        id: "documents",
+        description: "Create, edit, verify, and deliver professional document artifacts such as DOCX, Google Docs, memos, letters, reports, redlines, and formal written deliverables."
+      },
+      {
+        id: "spreadsheets",
+        description: "Create, inspect, clean, calculate, format, and verify spreadsheet artifacts such as XLSX, CSV, TSV, Google Sheets, formulas, pivots, charts, and reconciliation workbooks."
+      },
+      {
+        id: "pdf",
+        description: "Extract, summarize, cite, split, merge, create, inspect, and verify PDF content, including text PDFs, scanned PDFs, tables, forms, page citations, and generated reports."
+      },
+      {
+        id: "presentations",
+        description: "Build executive decks, board decks, sales decks, research summaries, and visual narratives as PPTX or shareable slide artifacts with verified layout and source-backed content."
+      },
+      {
+        id: "data-quality",
+        description: "Profile messy data, find anomalies, reconcile systems, explain exceptions, score risk, and produce audit-ready evidence through deterministic math before narrative."
+      },
+      {
+        id: "diagrams",
+        description: "Create, edit, and verify diagrams, graphs, workflows, org charts, entity networks, control graphs, architecture maps, and evidence-backed visual structures."
+      },
+      {
+        id: "github",
+        description: "Inspect GitHub and git repository state, review commits and pull requests, debug checks, and publish local changes with clear permission boundaries."
+      },
+      {
+        id: "wait-operator",
+        description: "Watch bounded external or local conditions, poll deployment and job status, wait through short-running tasks, and resume with verified state instead of guessing."
+      },
+      {
+        id: "data-quality",
+        description: "Profile messy data, find anomalies, reconcile systems, explain exceptions, score risk, and produce audit-ready evidence through deterministic math before narrative."
+      }
+    ];
+    DEDUPLICATED_SKILLS = Array.from(
+      new Map(PERCH_SKILL_REGISTRY.map((s) => [s.id, s])).values()
+    );
+    INSTRUCTION_PREAMBLE = `## Perch product facts -- authoritative reference
+
+For any question about Perch (what it is, whether it is free, what you can do,
+what model you are, do I need an account, etc.), answer only from the facts
+below. If something is not covered here, say you are not certain rather than
+guessing.`.trim();
+    WHAT_IS_PERCH = `### What Perch is
+
+Perch is an AI platform built around verifiable AI: every claim is sourced and
+checkable. The goal is to make AI output trustworthy, not just fluent.
+
+Perch has three surfaces:
+- Perch AI Web (chat.perchai.app): a warm, accessible web chat for grounded
+  answers, document upload, web search, and citation checking.
+- Perch Terminal Desktop: a local operator that runs on your Mac, controls
+  your files, runs code in a sandbox, drives a real browser, and delivers
+  finished work. Download at ${PERCH_MARKETING_DESKTOP_URL}.
+- Perch Terminal CLI: the same operator power from your terminal.
+  Install with: ${PERCH_CLI_INSTALL_COMMAND}.`.trim();
+    ACCESS_AND_PRICING = `### Access and pricing
+
+All three surfaces are free during the current pilot. No credit card is
+required to sign up.
+
+${formatUsageLine()}
+
+A Perch account is required to use the web chat. Sign up at ${PERCH_CHAT_WEB_URL}.
+Perch Terminal Desktop and CLI are also free; sign in with your Perch account.`.trim();
+    MODEL_STORY = `### The model -- Roost
+
+Perch does not expose raw model names. The model layer is called Roost.
+Roost picks the best available model for each task and locks it for that task.
+You are powered by Roost.
+
+Roost has four tiers:
+${buildRoostTierSummary()}
+
+Standard and Pro use a 200K context window. Standard Max and Pro Max use a 1M
+context window (Max = long context). Tier selection is available in the
+composer. When someone asks what model you are, say: "I run on Roost, Perch's
+model layer. Perch does not surface the underlying model names."`.trim();
+  }
+});
+
 // features/perchTerminal/runtime/context/coreSystemSection.ts
 function buildCoreSystemSection(input) {
   const enabledToolNames = Array.from(new Set(input.enabledToolNames ?? []));
@@ -92442,6 +92774,7 @@ function buildCoreSystemSection(input) {
   });
   const lines = splitRenderedLaneText(renderedCoreLanes);
   const permissionModeHandled = corePromptPermissionModeHandled(renderedCoreLanes);
+  lines.push("", PERCH_FACTS_CORE_TERMINAL);
   if (!permissionModeHandled && input.chatMode === "plan") {
     if (planGateRejected) {
       lines.push(
@@ -92699,7 +93032,7 @@ function buildCoordinatorNotificationSynthesisInstructions(notifications) {
     hasFailure ? "If the error-code is batch_failed, state that the suite failed and that no downstream stages ran." : "If multiple notifications arrived, combine them into one concise synthesis without exposing raw XML."
   ].join("\n");
 }
-var PLATFORM_DELIVERY_GUIDANCE, LIVE_NARRATION_GUIDANCE;
+var PERCH_FACTS_CORE_TERMINAL, PLATFORM_DELIVERY_GUIDANCE, LIVE_NARRATION_GUIDANCE;
 var init_coreSystemSection = __esm({
   "features/perchTerminal/runtime/context/coreSystemSection.ts"() {
     "use strict";
@@ -92715,6 +93048,8 @@ var init_coreSystemSection = __esm({
     init_operatingCaseService();
     init_planModeStateMachine();
     init_coreSystemPromptLanes();
+    init_perchFactsCore();
+    PERCH_FACTS_CORE_TERMINAL = buildPerchFactsCore("terminal");
     PLATFORM_DELIVERY_GUIDANCE = `## Platform delivery \u2014 use the verified shortcut, do not hand off
 You own delivery end-to-end in your own loop. Do NOT dispatch a sub-agent for Gmail, Google Docs, or Calendar \u2014 handing delivery off loses your context and breaks multi-step tasks (e.g. "make a doc AND email it"). Keep one continuous thread: you drafted it, so you deliver it, and you still remember every prior step (recipients, the doc URL you just created, etc.).
 
@@ -92756,6 +93091,45 @@ var init_agentSkillRegistry = __esm({
   "generated/agentSkillRegistry.ts"() {
     "use strict";
     AGENT_SKILL_REGISTRY = [
+      {
+        "id": "about-perch",
+        "name": "about-perch",
+        "description": "Answer detailed questions about Perch the product -- what it is, surfaces, pricing, the Roost model layer, per-tier details, capabilities, web vs Terminal differences, and common user questions. Consult this skill when a Perch product question goes beyond the always-on core facts.",
+        "path": "features/perchTerminal/agentPlatform/skills/about-perch/SKILL.md",
+        "body": "\n# About Perch\n\nUse the facts in this skill to answer any detailed product question about Perch.\nDo not guess. If a fact is not here and not in the always-on core, say you are not certain.\nNever reveal underlying model names. Always refer to the model layer as Roost.\n\nSee SKILL.md for the full product FAQ, web vs Terminal matrix, and per-tier detail.",
+        "surface": {
+          "gui": "supported",
+          "cli": "supported"
+        },
+        "triggerHints": [
+          "what is perch",
+          "what can you do",
+          "what model are you",
+          "is this free",
+          "is perch free",
+          "is terminal free",
+          "is terminal paid",
+          "do i need an account",
+          "roost",
+          "roost tier",
+          "standard max",
+          "pro max",
+          "perch terminal",
+          "perch desktop",
+          "perch cli",
+          "perch vs",
+          "web vs terminal",
+          "difference between perch",
+          "how does perch work",
+          "citation verifier",
+          "what is roost"
+        ],
+        "companionSkills": [
+          "research",
+          "workspace"
+        ],
+        "preferredTools": []
+      },
       {
         "id": "browser-operator",
         "name": "browser-operator",
@@ -93407,7 +93781,8 @@ var init_skillSelector = __esm({
       "diagrams",
       "workspace",
       "browser-operator",
-      "skill-creator"
+      "skill-creator",
+      "about-perch"
     ];
     INTENT_PATTERNS = {
       "browser-operator": [
@@ -93459,6 +93834,10 @@ var init_skillSelector = __esm({
       ],
       "skill-creator": [
         /\b(skill\s+creator|create\s+(?:a\s+)?skill|skill\.md|agent\s+skill|skill\s+validation|trigger\s+collision|skill\s+test|skill\s+authoring|perch\s+skill)\b/i
+      ],
+      "about-perch": [
+        /\b(what\s+(is|are)\s+perch|what\s+can\s+you\s+do|what\s+model\s+are\s+you|is\s+(this|perch|terminal|it)\s+free|is\s+terminal\s+paid|do\s+i\s+need\s+an\s+account|account\s+required|roost\s+(tier|model|layer)|standard\s+max|pro\s+max|perch\s+terminal|perch\s+desktop|perch\s+cli|web\s+vs\s+terminal|how\s+does\s+perch\s+work|citation\s+verifier|what\s+is\s+roost)\b/i,
+        /\b(tell\s+me\s+about\s+perch|about\s+perch|perch\s+pricing|perch\s+product|perch\s+features?|how\s+much\s+does\s+perch\s+cost)\b/i
       ]
     };
   }
@@ -119131,29 +119510,18 @@ var init_browserSession = __esm({
   }
 });
 
-// features/perchTerminal/runtime/roost.ts
-function normalizeRoostTier(value) {
-  if (value === "max") return "pro_max";
-  return isRoostTier(value) ? value : null;
-}
-function normalizeRoostModelChoice(value) {
-  if (value === "internal") return "internal";
-  return normalizeRoostTier(value);
+// features/perchTerminal/runtime/cliAuthRefreshRegistry.ts
+function setCliModelProxyAuthRefresher(fn) {
+  refresher = fn;
 }
-function isRoostTier(value) {
-  return value === "standard" || value === "standard_max" || value === "pro" || value === "pro_max";
+function refreshCliModelProxyAuth() {
+  return refresher ? refresher() : Promise.resolve(null);
 }
-var ROOST_TIER_LABELS;
-var init_roost = __esm({
-  "features/perchTerminal/runtime/roost.ts"() {
+var refresher;
+var init_cliAuthRefreshRegistry = __esm({
+  "features/perchTerminal/runtime/cliAuthRefreshRegistry.ts"() {
     "use strict";
-    init_modelRegistry();
-    ROOST_TIER_LABELS = {
-      standard: "Standard",
-      standard_max: "Standard Max",
-      pro: "Pro",
-      pro_max: "Pro Max"
-    };
+    refresher = null;
   }
 });
 
@@ -119488,19 +119856,36 @@ async function callModelRouterViaServer(request, opts, endpoint = "/api/perch-te
     durationMs: 0
   };
 }
+async function syncModelProxyAuthAfter401() {
+  if (typeof globalThis.window !== "undefined") {
+    await syncBrowserAuthSession();
+    return null;
+  }
+  return refreshCliModelProxyAuth();
+}
+function withModelProxyAuthHeader(init, token) {
+  if (!token?.trim()) return init;
+  const headers = new Headers(init.headers);
+  headers.set("Authorization", `Bearer ${token}`);
+  return { ...init, headers };
+}
 async function fetchModelProxyWithRetry(endpoint, init, options) {
   const maxAttempts = Math.max(1, options?.maxAttempts ?? MODEL_PROXY_MAX_ATTEMPTS);
   let lastError = null;
   let authSynced = false;
+  let requestInit = init;
   for (let attempt = 0; attempt < maxAttempts; attempt++) {
     try {
-      const response = await fetch(endpoint, init);
-      if (response.status === 401 && !authSynced && typeof globalThis.window !== "undefined") {
+      const response = await fetch(endpoint, requestInit);
+      if (response.status === 401 && !authSynced) {
         authSynced = true;
-        await syncBrowserAuthSession();
+        const refreshedToken = await syncModelProxyAuthAfter401();
+        if (refreshedToken) {
+          requestInit = withModelProxyAuthHeader(requestInit, refreshedToken);
+        }
         options?.onRetry?.(attempt, "HTTP 401 (session sync)");
         await response.body?.cancel().catch(() => void 0);
-        await waitForModelProxyRetry(attempt, init.signal);
+        await waitForModelProxyRetry(attempt, requestInit.signal);
         continue;
       }
       if (!isRetriableModelProxyStatus(response.status) || attempt === maxAttempts - 1) {
@@ -119508,12 +119893,12 @@ async function fetchModelProxyWithRetry(endpoint, init, options) {
       }
       options?.onRetry?.(attempt, `HTTP ${response.status}`);
       await response.body?.cancel().catch(() => void 0);
-      await waitForModelProxyRetry(attempt, init.signal);
+      await waitForModelProxyRetry(attempt, requestInit.signal);
     } catch (error) {
       if (isAbortLikeError(error) || attempt === maxAttempts - 1) throw error;
       lastError = error;
       options?.onRetry?.(attempt, error instanceof Error ? error.message : String(error));
-      await waitForModelProxyRetry(attempt, init.signal);
+      await waitForModelProxyRetry(attempt, requestInit.signal);
     }
   }
   throw lastError instanceof Error ? lastError : new Error(String(lastError ?? "Model proxy request failed"));
@@ -119637,6 +120022,7 @@ var init_modelRouter = __esm({
     init_contextMeter();
     init_inferenceUsageRecorder();
     init_browserSession();
+    init_cliAuthRefreshRegistry();
     init_roostUserSelectionClient();
     init_providerModelStep();
     init_toolCallNormalizer();
@@ -197350,7 +197736,6 @@ function recordDispatchBatchResult(tasks, result2, ctx, opts = {}) {
 var lifecycleByRun, MAX_LIFECYCLE_RUNS;
 var init_workerLifecycle = __esm({
   "features/perchTerminal/runtime/workers/workerLifecycle.ts"() {
-    "use strict";
     init_workerManifest();
     lifecycleByRun = /* @__PURE__ */ new Map();
     MAX_LIFECYCLE_RUNS = 200;
@@ -198995,10 +199380,10 @@ function evaluateBrowserAction(action, observation, context = {}) {
   if (action.kind === "click" && !label && !("role" in action && action.role)) {
     return block("empty_click_target", "Refusing a browser click with no target. Observe the page and name a button/link, or use a coordinate (visual) click.");
   }
-  if ((action.kind === "click" || action.kind === "visual_click" || action.kind === "type") && context.recentFailedClickSignatures?.includes(clickSignature(action))) {
+  if ((action.kind === "click" || action.kind === "visual_click") && context.recentFailedClickSignatures?.includes(clickSignature(action))) {
     return block(
       "repeated_failed_click",
-      `The action "${label || action.kind}" already failed on this surface. Not retrying the identical click. Try a different target or report a blocker.`
+      `The action "${label || action.kind}" already failed on this surface as a semantic/DOM click. Not retrying the identical semantic click. Escalate to a coordinate/visual (CUA) click on the same target before reporting a blocker.`
     );
   }
   if (action.kind === "click" && (observation.app === "google_docs" || observation.app === "google_sheets")) {
@@ -199363,6 +199748,17 @@ async function safeBrowserAction(input, runtime = {}) {
       if (target.kind === "ambiguous") {
         lastFailure = fail("selector_ambiguous", target.message, startMs, latestSnapshot.text, latestSnapshot.url, target.candidates);
       } else if (target.kind === "missing") {
+        const escalated = await escalateMissingClickToCoordinate({
+          input,
+          snapshot: latestSnapshot,
+          callTool,
+          startMs,
+          runtime
+        });
+        if (escalated) {
+          clearPolicyClickFailure(input, runtime, latestSnapshot);
+          return escalated;
+        }
         lastFailure = fail("selector_not_found", target.message, startMs, latestSnapshot.text, latestSnapshot.url);
       } else {
         const actionResult = await executeBrowserAction(input, target.target, callTool);
@@ -199499,7 +199895,7 @@ function enforceActionPolicy(input, preSnapshot, runtime, startMs) {
 }
 function recordPolicyClickFailure(input, runtime, snapshot) {
   if (!runtime.policy) return;
-  if (input.intent !== "click" && input.intent !== "visual_click" && input.intent !== "type") return;
+  if (input.intent !== "click" && input.intent !== "visual_click") return;
   const key = policySessionKey(runtime);
   const signature = `${policySurfaceFingerprint(snapshot)}::${clickSignature(inputToProposedAction(input))}`;
   const existing = failedClickMemory.get(key) ?? [];
@@ -199611,6 +200007,7 @@ async function clickGmailComposeSendButton(callTool) {
             };
           });
           if (!target || target.result !== "target") return JSON.stringify(target || { result: "missing" });
+          await page.evaluate(${PERCH_CURSOR_OVERLAY_SNIPPET}, { x: target.x, y: target.y });
           await page.mouse.click(target.x, target.y);
           return JSON.stringify({ result: "clicked", label: target.label, x: target.x, y: target.y, bounds: target.bounds, viewport: target.viewport });
         }
@@ -199671,7 +200068,8 @@ async function dispatchSyntheticPaste(payload, runtime) {
     () => {
       const html = ${JSON.stringify(payload.html)};
       const plain = ${JSON.stringify(payload.plain)};
-      const active = document.activeElement;
+      const deepActive = () => { let n = document.activeElement; while (n && n.shadowRoot && n.shadowRoot.activeElement) n = n.shadowRoot.activeElement; return n; };
+      const active = deepActive();
       if (!active) return false;
       const isLongBody = plain.length > ${TYPE_DIRECT_MAX_CHARS} || plain.includes("\\n");
       if (isLongBody && active.tagName === "INPUT") return false;
@@ -199989,7 +200387,26 @@ async function resolveTargetForAction(input, snapshot, callTool) {
   }
   const resolved = resolveTarget(snapshot.text, input.targetDescriptor);
   if (resolved.kind === "found") return resolved;
-  if (input.intent === "type") return { kind: "found", target: null };
+  if (input.intent === "type") {
+    const desc = input.targetDescriptor;
+    const named = (desc?.text ?? "").trim() || (desc?.ariaLabel ?? "").trim();
+    if (named) {
+      return {
+        kind: "found",
+        target: {
+          kind: "semantic",
+          descriptor: {
+            ...desc?.text ? { text: desc.text } : {},
+            ...desc?.ariaLabel ? { ariaLabel: desc.ariaLabel } : {},
+            ...desc?.role ? { role: desc.role } : {},
+            nth: normalizeNth(desc?.nth)
+          },
+          matched: desc?.text ?? desc?.ariaLabel ?? "target"
+        }
+      };
+    }
+    return { kind: "found", target: null };
+  }
   return resolved;
 }
 function resolveTarget(snapshot, descriptor) {
@@ -200016,7 +200433,7 @@ function resolveTarget(snapshot, descriptor) {
       if (!match) {
         return {
           kind: "missing",
-          message: `No browser element matched "${desc.text ?? desc.ariaLabel ?? desc.role ?? "target"}" at nth=${nth}.`
+          message: `No DOM match for "${desc.text ?? desc.ariaLabel ?? desc.role ?? "target"}" at nth=${nth}. Escalate to a coordinate/visual (CUA) click on the same target before reporting a blocker.`
         };
       }
       if (matches.length > 1 && desc.nth === void 0) {
@@ -200048,7 +200465,7 @@ function resolveTarget(snapshot, descriptor) {
   }
   return {
     kind: "missing",
-    message: `No browser element matched "${desc.text ?? desc.ariaLabel ?? desc.role ?? "target"}".`
+    message: `No DOM match for "${desc.text ?? desc.ariaLabel ?? desc.role ?? "target"}". Escalate to a coordinate/visual (CUA) click on the same target before reporting a blocker.`
   };
 }
 function liveResolverSource() {
@@ -200097,17 +200514,50 @@ function liveResolverSource() {
           el.textContent,
         ].filter(Boolean).map((v) => String(v).trim()).find(Boolean) || "";
       };
-      const candidates = () => Array.from(document.querySelectorAll([
-        "button",
-        "a[href]",
-        "input",
-        "textarea",
-        "select",
-        "[role]",
-        "[aria-label]",
-        "[data-tooltip]",
-        "[contenteditable='true']"
-      ].join(","))).filter(visible);
+      const candidates = () => {
+        const INTERACTIVE_SELECTOR = [
+          "button",
+          "a[href]",
+          "input",
+          "textarea",
+          "select",
+          "[role]",
+          "[aria-label]",
+          "[data-tooltip]",
+          "[contenteditable='true']"
+        ].join(",");
+        // Collect open shadow roots recursively so the resolver reaches controls
+        // inside web components (e.g. Reddit/shreddit). Shadow-DOM elements share
+        // the top document's viewport coordinate space, so getBoundingClientRect
+        // (used for the coordinate click) stays correct. Same-origin iframes are
+        // intentionally skipped: their rects are in the frame's own space and
+        // would misplace the click.
+        const roots = [document];
+        const seenRoots = new Set();
+        const walk = (root) => {
+          let hosts;
+          try { hosts = root.querySelectorAll("*"); } catch (e) { return; }
+          for (const host of hosts) {
+            const sr = host.shadowRoot;
+            if (sr && !seenRoots.has(sr)) {
+              seenRoots.add(sr);
+              roots.push(sr);
+              walk(sr);
+            }
+          }
+        };
+        walk(document);
+        const out = [];
+        const seenEl = new Set();
+        for (const root of roots) {
+          let found;
+          try { found = root.querySelectorAll(INTERACTIVE_SELECTOR); } catch (e) { continue; }
+          for (const el of found) {
+            if (!seenEl.has(el) && visible(el)) { seenEl.add(el); out.push(el); }
+          }
+        }
+        return out;
+      };
       const rankMatch = (el, descriptor) => {
         const label = labelFor(el);
         const aria = el.getAttribute("aria-label") || "";
@@ -200145,6 +200595,32 @@ function liveResolverSource() {
       };
   `;
 }
+async function escalateMissingClickToCoordinate(args) {
+  const { input, snapshot, callTool, startMs, runtime } = args;
+  if (input.intent !== "click") return null;
+  const descriptor = input.targetDescriptor;
+  const label = descriptor?.text ?? descriptor?.ariaLabel ?? descriptor?.role;
+  if (!descriptor || !label) return null;
+  const coordinateTarget = { kind: "semantic", descriptor, matched: label };
+  const clicked = await clickTargetTrusted(callTool, coordinateTarget, label);
+  if (!clicked.ok) return null;
+  const outcome = await waitForExpectedOutcome({
+    input,
+    callTool,
+    preSnapshot: snapshot,
+    startMs,
+    signal: runtime.signal
+  });
+  if (!outcome.ok) return null;
+  return {
+    ...outcome,
+    evidence: {
+      ...outcome.evidence,
+      matched: `${clicked.matched} \xB7 escalated to coordinate (CUA) click`,
+      ...clicked.actionGeometry ? { actionGeometry: clicked.actionGeometry } : {}
+    }
+  };
+}
 async function executeBrowserAction(input, target, callTool) {
   if (input.intent === "snapshot" || input.intent === "extract") return { ok: true, matched: input.intent };
   if (input.intent === "navigate") {
@@ -200173,6 +200649,8 @@ async function executeBrowserAction(input, target, callTool) {
     if (!clicked.ok) return clicked;
     const typed = await typeViaRealKeys(callTool, input.text ?? "", clicked.matched);
     if (typed.ok) {
+      const verified = await verifyTypedTextLanded(callTool, input.text ?? "", clicked.matched);
+      if (!verified.ok) return verified;
       return {
         ok: true,
         matched: `${clicked.matched} then typed into focused surface`,
@@ -200182,7 +200660,10 @@ async function executeBrowserAction(input, target, callTool) {
     return typed;
   }
   if (input.intent === "type") {
-    return enterText(callTool, target, input.text ?? "");
+    const typed = await enterText(callTool, target, input.text ?? "");
+    if (!typed.ok) return typed;
+    const verified = await verifyTypedTextLanded(callTool, input.text ?? "", typed.matched);
+    return verified.ok ? typed : verified;
   }
   if (!target) return { ok: false, error: "target could not be resolved" };
   if (target.kind === "selector") {
@@ -200193,8 +200674,24 @@ async function executeBrowserAction(input, target, callTool) {
   }
   return { ok: false, error: `Unsupported browser intent: ${input.intent}` };
 }
+function labelGroundingVariants(label) {
+  const trimmed = (label ?? "").trim();
+  if (!trimmed || trimmed.toLowerCase() === "visual target") return [];
+  const variants = [trimmed];
+  const stripped = trimmed.replace(/\b(button|btn|field|input|textbox|tab|link|icon|menu|option|box|area|control)\b/gi, "").replace(/\s{2,}/g, " ").trim();
+  if (stripped && stripped.toLowerCase() !== trimmed.toLowerCase()) variants.push(stripped);
+  return variants;
+}
 async function clickVisualTarget(callTool, visualTarget) {
   if (!visualTarget) return { ok: false, error: "visual target requires x and y" };
+  for (const candidate of labelGroundingVariants(visualTarget.label)) {
+    const grounded = await clickTargetTrusted(
+      callTool,
+      { kind: "semantic", descriptor: { text: candidate }, matched: candidate },
+      candidate
+    );
+    if (grounded.ok) return grounded;
+  }
   const x = Number(visualTarget.x);
   const y = Number(visualTarget.y);
   if (!Number.isFinite(x) || !Number.isFinite(y)) {
@@ -200212,6 +200709,7 @@ async function clickVisualTarget(callTool, visualTarget) {
     const py = coordinateSpace === "viewport_pixels" ? rawY : rawY * viewport.height;
     const safeX = Math.max(1, Math.min(viewport.width - 1, px));
     const safeY = Math.max(1, Math.min(viewport.height - 1, py));
+    await page.evaluate(${PERCH_CURSOR_OVERLAY_SNIPPET}, { x: safeX, y: safeY });
     await page.mouse.click(safeX, safeY);
     return JSON.stringify({
       result: "clicked",
@@ -200235,17 +200733,78 @@ async function clickVisualTarget(callTool, visualTarget) {
   }
   return { ok: false, error: text || "visual click failed" };
 }
+async function verifyTypedTextLanded(callTool, text, matched) {
+  if (!text.trim()) return { ok: true };
+  const expr = `() => {
+    const url = String(location.href || "");
+    if (/docs\\.google\\.com\\/(document|spreadsheets|presentation)\\//i.test(url)) return "PERCH_DOCS_BLIND";
+    const deepActive = () => { let n = document.activeElement; while (n && n.shadowRoot && n.shadowRoot.activeElement) n = n.shadowRoot.activeElement; return n; };
+    const el = deepActive();
+    if (!el) return "PERCH_UNKNOWN";
+    const tag = (el.tagName || "").toLowerCase();
+    const readableEditable =
+      el.isContentEditable ||
+      tag === "textarea" ||
+      (tag === "input") ||
+      ("value" in el && typeof el.value === "string");
+    if (!readableEditable) return "PERCH_UNKNOWN";
+    const read = (n) => {
+      if ("value" in n && typeof n.value === "string") return n.value;
+      if (n.isContentEditable) return n.textContent || "";
+      return "";
+    };
+    const val = String(read(el) || "").replace(/\\s+/g, " ").trim();
+    return val ? "PERCH_LANDED" : "PERCH_EMPTY";
+  }`;
+  const result2 = await callTool({
+    serverName: "playwright",
+    toolName: "browser_evaluate",
+    args: { function: expr }
+  });
+  if (!result2.ok) return { ok: true };
+  if (firstText(result2.content).trim() !== "PERCH_EMPTY") return { ok: true };
+  return {
+    ok: false,
+    error: `Typed text did not land in "${matched}" \u2014 the focused field is still empty. Click the field with a visual_click to focus the real editable, then type again (typing goes into the focused field). Do not repeat the identical type into an unfocused field.`
+  };
+}
+async function hasEditableFocus(callTool) {
+  const expr = `() => {
+    const deepActive = () => { let n = document.activeElement; while (n && n.shadowRoot && n.shadowRoot.activeElement) n = n.shadowRoot.activeElement; return n; };
+    const el = deepActive();
+    if (!el) return false;
+    if (el.isContentEditable) return true;
+    const tag = (el.tagName || "").toLowerCase();
+    if (tag === "textarea") return true;
+    if (tag === "input") {
+      const t = (el.getAttribute("type") || "text").toLowerCase();
+      return !["button","submit","reset","checkbox","radio","range","file","image","color"].includes(t);
+    }
+    if ("value" in el && typeof el.value === "string") return true;
+    return false;
+  }`;
+  const result2 = await callTool({
+    serverName: "playwright",
+    toolName: "browser_evaluate",
+    args: { function: expr }
+  });
+  if (!result2.ok) return false;
+  return /^\s*true\s*$/i.test(firstText(result2.content));
+}
 async function enterText(callTool, target, text) {
   const matched = target?.matched ?? "focused field";
   const isLong = text.length > TYPE_DIRECT_MAX_CHARS || text.includes("\n");
+  const alreadyFocused = await hasEditableFocus(callTool);
   if (!isLong) {
-    if (target) {
+    let focusGeometry;
+    if (!alreadyFocused && target) {
       const focused = await focusTarget(callTool, target, matched);
-      if (!focused.ok) return focused;
+      if (focused.ok) focusGeometry = focused.actionGeometry;
     }
-    return typeViaRealKeys(callTool, text, matched);
+    const typed = await typeViaRealKeys(callTool, text, matched);
+    return typed.ok && focusGeometry ? { ...typed, actionGeometry: focusGeometry } : typed;
   }
-  if (target) {
+  if (!alreadyFocused && target) {
     const focused = await focusTarget(callTool, target, matched);
     if (focused.ok) {
       const pasted2 = await dispatchSyntheticPaste({ html: null, plain: text }, { callTool });
@@ -200273,7 +200832,8 @@ function shouldRefuseRealKeys(error) {
 async function typeIntoActiveElement(callTool, text) {
   const json = JSON.stringify(text);
   const expr = `() => {
-    const el = document.activeElement;
+    const deepActive = () => { let n = document.activeElement; while (n && n.shadowRoot && n.shadowRoot.activeElement) n = n.shadowRoot.activeElement; return n; };
+    const el = deepActive();
     if (!el) throw new Error("no active element to type into");
     const isLongBody = ${JSON.stringify(text.length > TYPE_DIRECT_MAX_CHARS || text.includes("\n"))};
     if (isLongBody && el.tagName === "INPUT") {
@@ -200359,6 +200919,7 @@ async function clickTargetTrusted(callTool, target, matched) {
       };
     }, { descriptor: ${JSON.stringify(descriptor)}, selector: ${JSON.stringify(selector)} });
     if (!target || target.result !== "target") return JSON.stringify(target || { result: "missing" });
+    await page.evaluate(${PERCH_CURSOR_OVERLAY_SNIPPET}, { x: target.x, y: target.y });
     await page.mouse.click(target.x, target.y);
     return JSON.stringify({ result: "clicked", label: target.label, x: target.x, y: target.y, bounds: target.bounds, viewport: target.viewport });
   }`;
@@ -200686,7 +201247,7 @@ function delay(ms, signal) {
     );
   });
 }
-var DEFAULT_TIMEOUT_MS, MAX_TIMEOUT_MS, SNAPSHOT_REF_PREFIX, HUMAN_RECOVERY_FAILURES, MODAL_DISMISSERS, failedClickMemory, FAILED_CLICK_MEMORY_MAX, TYPE_DIRECT_MAX_CHARS, PRESS_KEY_LOOP_MAX_CHARS;
+var DEFAULT_TIMEOUT_MS, MAX_TIMEOUT_MS, SNAPSHOT_REF_PREFIX, HUMAN_RECOVERY_FAILURES, MODAL_DISMISSERS, failedClickMemory, FAILED_CLICK_MEMORY_MAX, PERCH_CURSOR_OVERLAY_SNIPPET, TYPE_DIRECT_MAX_CHARS, PRESS_KEY_LOOP_MAX_CHARS;
 var init_safeBrowserAction = __esm({
   "features/perchTerminal/runtime/playwright/safeBrowserAction.ts"() {
     "use strict";
@@ -200713,6 +201274,26 @@ var init_safeBrowserAction = __esm({
     ];
     failedClickMemory = /* @__PURE__ */ new Map();
     FAILED_CLICK_MEMORY_MAX = 12;
+    PERCH_CURSOR_OVERLAY_SNIPPET = `(coord) => {
+  try {
+    const id = "__perch_operator_cursor__";
+    let el = document.getElementById(id);
+    if (!el) {
+      el = document.createElement("div");
+      el.id = id;
+      el.setAttribute("aria-hidden", "true");
+      el.style.cssText = "position:fixed;left:0;top:0;z-index:2147483647;pointer-events:none;width:24px;height:30px;transform-origin:0 0;transition:left .1s ease,top .1s ease,opacity .4s ease;filter:drop-shadow(0 1px 2px rgba(0,0,0,.6));";
+      el.innerHTML = '<svg width="24" height="30" viewBox="0 0 16 20" xmlns="http://www.w3.org/2000/svg"><path d="M0 0 L0 15 L4.5 11.6 L6.9 17.2 L9.2 16.2 L6.8 10.8 L11.8 10.8 Z" fill="#111827" stroke="#ffffff" stroke-width="1.4" stroke-linejoin="round"/></svg>';
+      (document.body || document.documentElement).appendChild(el);
+    }
+    // The arrow tip is at the SVG origin (0,0), so left/top place the tip on the point.
+    el.style.left = coord.x + "px";
+    el.style.top = coord.y + "px";
+    el.style.opacity = "1";
+    if (el.__perchHide) clearTimeout(el.__perchHide);
+    el.__perchHide = setTimeout(function () { el.style.opacity = "0.6"; }, 1500);
+  } catch (e) {}
+}`;
     TYPE_DIRECT_MAX_CHARS = 200;
     PRESS_KEY_LOOP_MAX_CHARS = 4e3;
   }
@@ -218837,9 +219418,19 @@ async function executeToolBatch(toolCalls, ctx) {
               { type: "image_url", image_url: { url: execution.imageDataUrl } }
             ]
           });
+        } else if (isOperatorScreenshot) {
+          const readout = await describeOperatorScreenshotViaVision(execution.imageDataUrl, ctx);
+          ctx.messages.push({
+            role: "user",
+            content: readout ? `${OPERATOR_SCREENSHOT_MARKER} Vision readout of the current screen after that action (the selected model is text-only, so a vision sidecar looked for you). Treat this as the source of truth. For a coordinate click, use the approximate x/y viewport fractions named below.
+
+${readout}` : `${OPERATOR_SCREENSHOT_MARKER} A current browser screenshot was captured after that action, but this selected model is text-only and the vision sidecar was unavailable. Call visionInspect with {"currentScreen": true, "prompt": "describe what I need to verify"} before any coordinate click. Otherwise continue from the browser snapshot/perception text.`
+          });
         } else {
-          const text = isLocalVisualAttachment ? `${LOCAL_VISUAL_ATTACHMENT_MARKER} A visual preview for ${label} was captured, but this selected model is text-only. If visual details matter, call visionInspect on the same file path/localSourceId with {"prompt": "read this file visually"}. Otherwise continue from any extracted text in the tool result.` : `${OPERATOR_SCREENSHOT_MARKER} A current browser screenshot was captured after that action, but this selected model is text-only. If visual details matter, call visionInspect with {"currentScreen": true, "prompt": "describe what I need to verify"}. Otherwise continue from the browser snapshot/perception text.`;
-          ctx.messages.push({ role: "user", content: text });
+          ctx.messages.push({
+            role: "user",
+            content: `${LOCAL_VISUAL_ATTACHMENT_MARKER} A visual preview for ${label} was captured, but this selected model is text-only. If visual details matter, call visionInspect on the same file path/localSourceId with {"prompt": "read this file visually"}. Otherwise continue from any extracted text in the tool result.`
+          });
         }
       }
     }
@@ -218860,6 +219451,26 @@ function parseImageDataUrlForTool(dataUrl) {
     base64
   };
 }
+async function describeOperatorScreenshotViaVision(dataUrl, ctx) {
+  if (ctx.signal?.aborted) return null;
+  const parsed = parseImageDataUrlForTool(dataUrl);
+  if (!parsed) return null;
+  try {
+    const result2 = await callVisionLaneModel({
+      founderModelSelection: ctx.founderModelSelection,
+      imageBase64: parsed.base64,
+      mimeType: parsed.mimeType,
+      userPrompt: OPERATOR_VISION_OBSERVER_PROMPT,
+      signal: ctx.signal ?? void 0,
+      userId: ctx.userId ?? null,
+      workspaceId: ctx.workspaceId ?? null,
+      runId: ctx.runId ?? null
+    });
+    if (result2.ok && result2.text.trim()) return result2.text.trim();
+  } catch {
+  }
+  return null;
+}
 function currentScreenVisionToolCall(input) {
   const { toolCall, imageDataUrl } = input;
   if (toolCall.name !== TOOL_NAMES.visionInspect) return { toolCall };
@@ -218918,11 +219529,12 @@ function updateConsecutiveRequiredArgFailures(counts, execution) {
 function now6() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
-var MAX_PARALLEL_TOOL_CALLS, LOCAL_VISUAL_ATTACHMENT_MARKER;
+var MAX_PARALLEL_TOOL_CALLS, LOCAL_VISUAL_ATTACHMENT_MARKER, OPERATOR_VISION_OBSERVER_PROMPT;
 var init_toolBatchExecutor = __esm({
   "features/perchTerminal/runtime/toolLoop/toolBatchExecutor.ts"() {
     "use strict";
     init_modelRegistry();
+    init_visionLaneCall();
     init_toolExecutor();
     init_fileDiff();
     init_toolNames();
@@ -218935,6 +219547,14 @@ var init_toolBatchExecutor = __esm({
     init_sourceReadPolicy();
     MAX_PARALLEL_TOOL_CALLS = 8;
     LOCAL_VISUAL_ATTACHMENT_MARKER = "[local-visual]";
+    OPERATOR_VISION_OBSERVER_PROMPT = [
+      "You are the eyes of a browser operator that cannot see this screen.",
+      "Describe the current browser screen so the operator can act precisely.",
+      "List the key interactive controls (buttons, links, text fields, tabs, menus) with their exact visible labels and approximate position as viewport fractions x,y in [0,1], where 0,0 is the top-left and 1,1 is the bottom-right.",
+      "State which field or control is focused or selected, the values already entered in visible fields, and any error, confirmation, or toast text.",
+      "If a crosshair or marker is drawn on the image, say which element it is pointing at.",
+      "Plain text only. Do not suggest or decide the next action."
+    ].join(" ");
   }
 });
 
@@ -219379,8 +219999,11 @@ async function prepareLoopMessagesForSend(input) {
     toolDefinitionsJson,
     modelContext
   });
-  const contextLimitTokens = resolveEffectiveContextLimit(input.option);
-  const compactThreshold = getAutoCompactThreshold(input.option);
+  const budgetModel = typeof input.effectiveContextLimitTokens === "number" && input.effectiveContextLimitTokens > 0 ? { ...input.option, effectiveLimitTokens: input.effectiveContextLimitTokens } : input.option;
+  const contextLimitTokens = resolveEffectiveContextLimit(
+    budgetModel
+  );
+  const compactThreshold = getAutoCompactThreshold(budgetModel);
   const postCompactTargetTokens = resolvePostCompactTargetTokens(contextLimitTokens);
   const recentTailTokenBudget = resolveRecentTailBudgetTokens({
     postCompactTargetTokens,
@@ -219406,11 +220029,6 @@ async function prepareLoopMessagesForSend(input) {
         toolDefinitionsJson,
         modelContext
       });
-      input.onEvent?.({
-        type: "activity_delta",
-        text: `Cleared ${microcompactedToolResults} old tool result(s) to free context.`,
-        ts: (/* @__PURE__ */ new Date()).toISOString()
-      });
     }
   }
   if (autoCompactEnabled && anchoredTokens(breakdown.total) >= compactThreshold) {
@@ -223197,6 +223815,7 @@ async function runFlockTurn(input, deps, options = {}) {
       emitWorkerUpdate(emit, plan, worker, "queued");
     }
     const spawnFn = options.spawnWorkerFn ?? spawnWorker;
+    let turnInput = input;
     const outcomes = [];
     const revisionOutcomes = [];
     let revisionReport = null;
@@ -223245,6 +223864,7 @@ async function runFlockTurn(input, deps, options = {}) {
         toolCallsReserved += reservedToolCalls;
         emitWorkerUpdate(emit, plan, worker, "running");
         try {
+          turnInput = deps.refreshTurnInput ? await deps.refreshTurnInput(turnInput) : turnInput;
           const context = contextOverride ?? buildWorkerContext(worker, sharedContext, outputByFlockWorkerId, plan);
           const objective = worker.role === "worker" && contextContainsSources(context) ? `${worker.objective}
 ${FLOCK_GROUNDING_CONTRACT}` : worker.objective;
@@ -223256,18 +223876,18 @@ ${FLOCK_GROUNDING_CONTRACT}` : worker.objective;
               maxIterations: worker.maxIterations,
               maxToolCalls: reservedToolCalls
             },
-            buildSpawnContext(input, plan.flockId, flockRun.controller.signal, emit, worker)
+            buildSpawnContext(turnInput, plan.flockId, flockRun.controller.signal, emit, worker)
           );
           toolCallsReserved -= reservedToolCalls;
           toolCallsUsed += Math.min(result2.toolCalls ?? 0, reservedToolCalls);
-          const ok = result2.ok;
+          const status = flockWorkerStatusFromSpawnResult(result2);
           const outcome = {
             worker,
             result: result2,
-            status: ok ? "done" : "failed",
+            status,
             detail: clampLine(result2.summary, 200)
           };
-          emitWorkerUpdate(emit, plan, worker, ok ? "done" : "failed", clampLine(result2.summary, 160));
+          emitWorkerUpdate(emit, plan, worker, status, clampLine(result2.summary, 160));
           return outcome;
         } catch (error) {
           toolCallsReserved -= reservedToolCalls;
@@ -223367,8 +223987,10 @@ ${FLOCK_GROUNDING_CONTRACT}` : worker.objective;
     }
     const userCancelled = Boolean(deps.signal?.aborted);
     const workersDone = outcomes.filter((outcome) => outcome.status === "done").length;
-    const workersFailed = outcomes.filter((outcome) => outcome.status === "failed").length;
+    const workersBlocked = outcomes.filter((outcome) => outcome.status === "blocked").length;
+    const workersFailed = outcomes.filter((outcome) => outcome.status === "failed").length + workersBlocked;
     const flockStatus = userCancelled || wallTimeHit && workersDone === 0 ? "cancelled" : workersFailed === 0 && workersDone === plan.workers.length ? "completed" : workersDone > 0 ? "partial" : "failed";
+    const permissionHint = workersBlocked > 0 && (turnInput.permissionMode ?? "default") === "default" ? "\n\nTip: flock workers inherit default permissions \u2014 run `/permission take_the_wheel` before `/flock` so bash redirects and file writes do not stall on approval gates." : "";
     const assistantText = [
       buildFlockSummary(
         plan,
@@ -223384,7 +224006,7 @@ ${FLOCK_GROUNDING_CONTRACT}` : worker.objective;
       ...modelOverrides.unavailable.map(
         (override) => `Requested model "${override.modelText}"${override.roleText ? ` for ${override.roleText}` : ""} is not available \u2014 that worker stayed on the default model path.`
       )
-    ].join("\n");
+    ].join("\n") + permissionHint;
     emit({
       type: "flock_run_completed",
       flockId: plan.flockId,
@@ -223618,6 +224240,12 @@ function buildFlockSummary(plan, outcomes, status, toolCallsUsed, wallTimeHit) {
 function friendlyOutcomeDetail(detail) {
   const clean = clampLine(detail, 220);
   if (!clean) return "";
+  if (/approval gate|requires approval|Blocked at an approval/i.test(clean)) {
+    return clean;
+  }
+  if (/No usable model response|Model proxy error|not_authenticated|Unauthorized/i.test(clean)) {
+    return clean;
+  }
   if (/Reached maximum \d+ tool-call iterations/i.test(clean)) {
     return "finished from gathered evidence";
   }
@@ -223636,6 +224264,11 @@ function clampLine(text, max2) {
 function makeFlockRunId() {
   return `flock-run-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 }
+function flockWorkerStatusFromSpawnResult(result2) {
+  if (!result2.ok || result2.usabilityStatus === "failed") return "failed";
+  if (result2.usabilityStatus === "needs_user_input") return "blocked";
+  return "done";
+}
 function now11() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
@@ -232065,13 +232698,15 @@ function getBackgroundTaskStore() {
 var STORE_FILE, BackgroundTaskStore, singleton;
 var init_backgroundTaskRegistry = __esm({
   "features/perchTerminal/runtime/background/backgroundTaskRegistry.ts"() {
-    "use strict";
     init_backgroundTaskTypes();
     STORE_FILE = "background-tasks.json";
     BackgroundTaskStore = class {
+      baseDir;
+      storePath;
+      outputDir;
+      records = /* @__PURE__ */ new Map();
+      loaded = false;
       constructor(options = {}) {
-        this.records = /* @__PURE__ */ new Map();
-        this.loaded = false;
         this.baseDir = options.baseDir ?? path11.join(os.homedir(), ".perch");
         this.storePath = path11.join(this.baseDir, STORE_FILE);
         this.outputDir = path11.join(this.baseDir, "background-output");
@@ -233621,337 +234256,11 @@ var init_nodeLocalBridge = __esm({
   }
 });
 
-// features/perchTerminal/runtime/cliHost/runCliTurn.ts
-import path14 from "node:path";
-async function runPerchCliTurn(input, options = {}) {
-  const prompt = input.prompt.trim();
-  if (!prompt) throw new Error("Missing prompt for perch run");
-  const now23 = options.now ?? (() => Date.now());
-  const cwd2 = path14.resolve(input.cwd ?? process.cwd());
-  const threadId = input.threadId?.trim() || `cli-${now23()}`;
-  const events = [];
-  let latestContextSnapshot = null;
-  const turnRunner = resolveTurnRunnerForPrompt(prompt) ?? options.turnRunner ?? runOperatorTurn;
-  const turnInput = buildCliTurnInput(input, {
-    prompt,
-    cwd: cwd2,
-    threadId
-  });
-  const deps = buildCliTurnDeps({
-    signal: input.signal ?? null,
-    events,
-    onEvent: input.onEvent,
-    onContextSnapshot: (snapshot) => {
-      latestContextSnapshot = snapshot;
-    }
-  });
-  const restoreLocalBridge = input.cliLocalTools === false ? null : installCliNodeLocalBridge({ workspaceRoot: cwd2 });
-  try {
-    const result2 = await turnRunner(turnInput, deps);
-    return buildCliTurnResult({
-      prompt,
-      cwd: cwd2,
-      threadId,
-      events,
-      contextSnapshot: latestContextSnapshot,
-      result: result2,
-      error: null
-    });
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    const runId = findRunId(events) ?? threadId;
-    return buildCliTurnResult({
-      prompt,
-      cwd: cwd2,
-      threadId,
-      events,
-      contextSnapshot: latestContextSnapshot,
-      result: {
-        status: "failed",
-        error: message,
-        runId
-      },
-      error: message
-    });
-  } finally {
-    restoreLocalBridge?.();
-  }
-}
-function buildCliTurnInput(input, resolved) {
-  const workspaceId = input.workspaceId ?? null;
-  const userId = input.userId ?? null;
-  return {
-    trimmedInput: resolved.prompt,
-    clientRunId: input.clientRunId ?? null,
-    chatMode: input.chatMode ?? "agents",
-    threadId: resolved.threadId,
-    personaId: input.personaId ?? DEFAULT_PERSONA_ID,
-    workspaceId,
-    userId,
-    selectedSourceId: input.selectedSourceId ?? null,
-    recentMessages: input.recentMessages ?? [],
-    usageRunIds: input.usageRunIds ?? [],
-    sessionContext: emptyPerchTerminalSessionContext({
-      userId,
-      workspaceId
-    }),
-    desktopConnected: input.desktopConnected ?? false,
-    cliLocalTools: input.cliLocalTools !== false,
-    activeRootPath: input.activeRootPath ?? resolved.cwd,
-    localSources: [],
-    localSourcesMeta: null,
-    projectMeta: readCliProjectMemoryState(resolved.cwd).meta,
-    permanentMemories: input.permanentMemories ?? [],
-    userMemories: input.userMemories ?? [],
-    supabase: null,
-    supabaseConfigured: false,
-    cliServerAppUrl: input.cliServerAppUrl ?? input.marketDeskProxyAppUrl ?? input.appUrl ?? null,
-    cliServerAccessToken: input.cliServerAccessToken ?? input.marketDeskProxyAccessToken ?? null,
-    marketDeskProxyAppUrl: input.marketDeskProxyAppUrl ?? input.appUrl ?? null,
-    marketDeskProxyAccessToken: input.marketDeskProxyAccessToken ?? null,
-    permissionMode: normalizePermissionMode(input.permissionMode ?? "default"),
-    founderModelSelection: input.founderModelSelection ?? null,
-    threadEvidence: [],
-    workspaceFileResolution: null,
-    folderIndexSummary: null,
-    mcpTools: [],
-    coordinatorMode: false,
-    systemNotifications: [],
-    workflowState: null,
-    skipUserMessagePersistence: false,
-    systemInitiated: input.systemInitiated === true
-  };
-}
-function buildCliTurnDeps(input) {
-  return {
-    signal: input.signal,
-    onEvent: (event) => {
-      input.events.push(event);
-      input.onEvent?.(event);
-    },
-    onContextAssembled: input.onContextSnapshot,
-    persistUserMessage: async () => null,
-    persistAssistantMessage: async () => null,
-    createWorkflowRun: async () => null,
-    finishWorkflowRun: async () => {
-    },
-    persistToolCall: async () => {
-    },
-    persistSandboxExecution: async () => null,
-    persistContextSnapshot: async () => null,
-    createManagedArtifact: async () => null,
-    createManagedReport: async () => null,
-    logProductAuditEvent: async () => {
-    }
-  };
-}
-function buildCliTurnResult(input) {
-  const segments = buildTranscriptSegments({
-    events: input.events,
-    complete: true,
-    error: input.error
-  });
-  const status = input.result.status;
-  const assistantText = "assistantText" in input.result ? input.result.assistantText : "";
-  const durationMs = "durationMs" in input.result ? input.result.durationMs : null;
-  const error = input.error ?? ("error" in input.result ? input.result.error : void 0) ?? ("reason" in input.result ? input.result.reason : void 0);
-  return {
-    ok: status === "completed",
-    status,
-    prompt: input.prompt,
-    cwd: input.cwd,
-    threadId: input.threadId,
-    runId: input.result.runId,
-    durationMs,
-    assistantText,
-    events: input.events,
-    segments,
-    contextSnapshot: input.contextSnapshot,
-    ...error ? { error } : {}
-  };
-}
-function findRunId(events) {
-  const started = events.find((event) => event.type === "turn_started");
-  return started?.type === "turn_started" ? started.runId : null;
-}
-var init_runCliTurn = __esm({
-  "features/perchTerminal/runtime/cliHost/runCliTurn.ts"() {
-    "use strict";
-    init_session();
-    init_sharedSlashCommands();
-    init_operatorStream();
-    init_permissionModes();
-    init_personaRegistry();
-    init_runOperatorTurn();
-    init_nodeLocalBridge();
-    init_nodeLocalBridge();
-  }
-});
-
-// features/perchTerminal/runtime/cliHost/renderCliTurn.ts
-function renderCliTurnText(result2, options = {}) {
-  const lines = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const event of result2.events) {
-    const line = renderEventLine(event);
-    if (!line) continue;
-    const lineKey = `${line.label}:${line.text}`;
-    if (seen.has(lineKey)) continue;
-    seen.add(lineKey);
-    lines.push(renderStreamLine(line.label, line.text, options));
-  }
-  if (result2.assistantText.trim()) {
-    if (lines.length) lines.push("");
-    lines.push(
-      renderStreamLine(
-        personaLabel(options.personaId),
-        result2.assistantText.trim(),
-        options
-      )
-    );
-  }
-  if (!result2.ok) {
-    if (lines.length) lines.push("");
-    lines.push(
-      renderStreamLine(
-        "stop",
-        `Perch stopped: ${result2.error ?? result2.status}`,
-        { ...options, color: options.color }
-      )
-    );
-  }
-  return `${lines.join("\n").trim()}
-`;
-}
-function cliExitCodeForTurn(result2) {
-  if (result2.status === "completed") return 0;
-  if (result2.status === "approval_required" || result2.status === "blocked" || result2.status === "incomplete") {
-    return 2;
-  }
-  return 1;
-}
-function renderEventLine(event) {
-  switch (event.type) {
-    case "assistant_preamble":
-    case "activity_delta":
-    case "workflow_narration":
-      return event.text.trim() ? { label: "perch", text: event.text.trim() } : null;
-    case "model_call_started":
-      return { label: "work", text: event.lane ? `Working (${event.lane})` : "Working" };
-    case "tool_call_started":
-      return { label: "tool", text: `Running ${humanizeToolName(event.toolName)}` };
-    case "tool_call_failed":
-      return {
-        label: "need",
-        text: `Needs attention: ${humanizeToolName(event.toolName)}${event.error ? ` \u2014 ${event.error}` : ""}`
-      };
-    case "live_card_start":
-      return { label: "tool", text: event.subtitle ? `${event.title} \xB7 ${event.subtitle}` : event.title };
-    case "live_step":
-      return { label: "tool", text: `${event.label} ${event.status}` };
-    case "live_card_end":
-      return event.receipt?.summary || event.error ? { label: event.error ? "need" : "tool", text: event.receipt?.summary ?? event.error ?? "" } : null;
-    case "workflow_card_start":
-      return { label: "tool", text: `${event.personaName}: ${event.workflowLabel}` };
-    case "workflow_step":
-      return { label: "tool", text: `${event.label} ${event.status}` };
-    case "managed_workflow_started":
-      return { label: "tool", text: event.title };
-    case "managed_workflow_completed":
-      return { label: "tool", text: event.summary };
-    case "capability_required":
-      return { label: "need", text: `Action needed: ${event.message}` };
-    case "executor_waiting_for_user":
-      return { label: "wait", text: `Waiting: ${event.prompt}` };
-    case "executor_result_summary":
-      return { label: "tool", text: event.summary };
-    default:
-      return null;
-  }
-}
-function humanizeToolName(name) {
-  return name.replace(/^mcp__/, "").replace(/_/g, " ");
-}
-function renderStreamLine(label, text, options) {
-  if (!options.streamLabels) return text;
-  const rawLabel = label.toLowerCase().slice(0, 7);
-  const padded = rawLabel.padEnd(7, " ");
-  const labelText = colorize(padded, colorForLabel(rawLabel), options.color);
-  const body = colorizeMultiline(text, colorForBody(rawLabel), options.color, " ".repeat(7));
-  return `${labelText} ${body}`;
-}
-function colorize(text, color, enabled) {
-  return enabled ? `${ANSI[color]}${text}${ANSI.reset}` : text;
-}
-function colorizeMultiline(text, color, enabled, continuationIndent) {
-  const painted = colorize(text, color, enabled);
-  return painted.replace(/\n/g, `
-${continuationIndent} `);
-}
-function colorForLabel(label) {
-  if (label === "need" || label === "stop") return "red";
-  if (label === "tool" || label === "work" || label === "wait") return "muted";
-  if (label === "you") return "bronze";
-  return "accent";
-}
-function colorForBody(label) {
-  if (label === "need" || label === "stop") return "red";
-  if (label === "tool" || label === "work" || label === "wait") return "muted";
-  return "cream";
-}
-function personaLabel(personaId) {
-  return personaId === "quill" ? "quill" : personaId === "saffron" ? "saffron" : "perch";
-}
-var ANSI;
-var init_renderCliTurn = __esm({
-  "features/perchTerminal/runtime/cliHost/renderCliTurn.ts"() {
-    "use strict";
-    ANSI = {
-      reset: "\x1B[0m",
-      accent: "\x1B[38;2;47;94;67m",
-      bronze: "\x1B[38;2;154;82;40m",
-      cream: "\x1B[38;2;255;248;240m",
-      muted: "\x1B[38;2;142;133;125m",
-      green: "\x1B[38;2;110;191;130m",
-      red: "\x1B[38;2;208;107;85m"
-    };
-  }
-});
-
-// features/perchTerminal/runtime/cliHost/index.ts
-var init_cliHost = __esm({
-  "features/perchTerminal/runtime/cliHost/index.ts"() {
-    "use strict";
-    init_runCliTurn();
-    init_renderCliTurn();
-    init_nodeLocalBridge();
-  }
-});
-
-// features/perchTerminal/runtime/publicModelDefault.ts
-function parsePublicModelDefaultPayload(value) {
-  const raw = value && typeof value === "object" ? value : {};
-  const selection = sanitizeFounderModelSelection(
-    raw.selection ?? DEFAULT_FOUNDER_MODEL_SELECTION
-  );
-  return {
-    selection,
-    updatedAt: typeof raw.updatedAt === "string" ? raw.updatedAt : null,
-    updatedBy: typeof raw.updatedBy === "string" ? raw.updatedBy : null
-  };
-}
-var init_publicModelDefault = __esm({
-  "features/perchTerminal/runtime/publicModelDefault.ts"() {
-    "use strict";
-    init_modelRegistry();
-  }
-});
-
 // features/perchTerminal/runtime/cliHost/cliAuthSession.ts
 import { execFile } from "node:child_process";
 import fs13 from "node:fs/promises";
 import os3 from "node:os";
-import path15 from "node:path";
+import path14 from "node:path";
 import { promisify } from "node:util";
 async function readStoredCliAuthSession() {
   const raw = shouldUseFallbackAuthFile() ? await readFallbackSecret().catch(() => null) : process.platform === "darwin" ? await readKeychainSecret().catch(() => null) : await readFallbackSecret().catch(() => null);
@@ -234028,15 +234337,15 @@ async function readKeychainSecret() {
   return stdout.trim() || null;
 }
 function fallbackSessionPath() {
-  const base = process.env.PERCH_CLI_AUTH_DIR?.trim() || path15.join(os3.homedir(), ".perch");
-  return path15.join(base, "cli-auth-session.json");
+  const base = process.env.PERCH_CLI_AUTH_DIR?.trim() || path14.join(os3.homedir(), ".perch");
+  return path14.join(base, "cli-auth-session.json");
 }
 async function readFallbackSecret() {
   return await fs13.readFile(fallbackSessionPath(), "utf8");
 }
 async function writeFallbackSecret(raw) {
   const filePath = fallbackSessionPath();
-  await fs13.mkdir(path15.dirname(filePath), { recursive: true, mode: 448 });
+  await fs13.mkdir(path14.dirname(filePath), { recursive: true, mode: 448 });
   await fs13.writeFile(filePath, raw, { mode: 384 });
 }
 var execFileAsync, KEYCHAIN_SERVICE, KEYCHAIN_ACCOUNT;
@@ -234049,6 +234358,162 @@ var init_cliAuthSession = __esm({
   }
 });
 
+// features/perchTerminal/runtime/publicModelDefault.ts
+function parsePublicModelDefaultPayload(value) {
+  const raw = value && typeof value === "object" ? value : {};
+  const selection = sanitizeFounderModelSelection(
+    raw.selection ?? DEFAULT_FOUNDER_MODEL_SELECTION
+  );
+  return {
+    selection,
+    updatedAt: typeof raw.updatedAt === "string" ? raw.updatedAt : null,
+    updatedBy: typeof raw.updatedBy === "string" ? raw.updatedBy : null
+  };
+}
+var init_publicModelDefault = __esm({
+  "features/perchTerminal/runtime/publicModelDefault.ts"() {
+    "use strict";
+    init_modelRegistry();
+  }
+});
+
+// features/perchTerminal/runtime/cliHost/installCliModelProxyAuthRefresh.ts
+function installCliModelProxyAuthRefresh() {
+  setCliModelProxyAuthRefresher(async () => {
+    const fresh = await ensureFreshCliAuthSession({
+      session: await readStoredCliAuthSession(),
+      forceRefresh: true
+    });
+    if (!fresh?.accessToken?.trim()) return null;
+    if (typeof process !== "undefined") {
+      process.env[MODEL_CALL_PROXY_TOKEN_ENV2] = fresh.accessToken;
+    }
+    return fresh.accessToken;
+  });
+  return () => setCliModelProxyAuthRefresher(null);
+}
+var MODEL_CALL_PROXY_TOKEN_ENV2;
+var init_installCliModelProxyAuthRefresh = __esm({
+  "features/perchTerminal/runtime/cliHost/installCliModelProxyAuthRefresh.ts"() {
+    "use strict";
+    init_cliAuthRefreshRegistry();
+    init_cliAuthRefresh();
+    init_cliAuthSession();
+    MODEL_CALL_PROXY_TOKEN_ENV2 = "PERCH_MODEL_CALL_PROXY_TOKEN";
+  }
+});
+
+// features/perchTerminal/runtime/cliHost/modelConnection.ts
+async function connectCliModelProxy(input = {}) {
+  installCliModelProxyAuthRefresh();
+  const storedSession = input.storedSession === void 0 ? await readStoredCliAuthSession() : input.storedSession;
+  const usableStoredSession = await ensureFreshCliAuthSession({
+    session: storedSession,
+    fetchImpl: input.fetchImpl
+  });
+  const appUrl = resolveCliAppUrl(input.appUrl, usableStoredSession?.appUrl ?? null);
+  if (!appUrl) return noCliModelConnection();
+  if (!usableStoredSession?.accessToken) return noCliModelConnection(appUrl);
+  const fetchImpl = input.fetchImpl ?? globalThis.fetch;
+  if (typeof fetchImpl !== "function") return noCliModelConnection(appUrl);
+  const selection = await fetchPublicModelDefaultSelection(
+    appUrl,
+    fetchImpl,
+    usableStoredSession?.accessToken ?? null
+  );
+  if (!selection) return noCliModelConnection(appUrl);
+  const priorProxy = process.env[MODEL_PROXY_ENV];
+  const priorToken = process.env[MODEL_PROXY_TOKEN_ENV];
+  process.env[MODEL_PROXY_ENV] = appUrl;
+  if (usableStoredSession?.accessToken) {
+    process.env[MODEL_PROXY_TOKEN_ENV] = usableStoredSession.accessToken;
+  }
+  return {
+    appUrl,
+    authenticated: !!usableStoredSession?.accessToken,
+    userId: usableStoredSession?.userId ?? null,
+    email: usableStoredSession?.email ?? null,
+    founderModelSelection: selection,
+    restore: () => {
+      if (priorProxy === void 0) {
+        delete process.env[MODEL_PROXY_ENV];
+      } else {
+        process.env[MODEL_PROXY_ENV] = priorProxy;
+      }
+      if (priorToken === void 0) {
+        delete process.env[MODEL_PROXY_TOKEN_ENV];
+      } else {
+        process.env[MODEL_PROXY_TOKEN_ENV] = priorToken;
+      }
+    }
+  };
+}
+function resolveCliAppUrl(explicit, stored) {
+  const raw = explicit?.trim() || process.env[CLI_APP_URL_ENV]?.trim() || process.env[FALLBACK_APP_URL_ENV]?.trim() || stored?.trim() || DEFAULT_CLI_APP_URL;
+  if (!raw) return null;
+  const withProtocol = /^https?:\/\//i.test(raw) ? raw : `http://${raw}`;
+  try {
+    const url = new URL(withProtocol);
+    url.pathname = url.pathname.replace(/\/+$/, "");
+    url.search = "";
+    url.hash = "";
+    return url.toString().replace(/\/+$/, "");
+  } catch {
+    return null;
+  }
+}
+async function fetchPublicModelDefaultSelection(appUrl, fetchImpl, accessToken) {
+  const url = `${appUrl}/api/perch-terminal/public-model-default`;
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 3500);
+  try {
+    const response = await fetchImpl(url, {
+      method: "GET",
+      headers: {
+        Accept: "application/json",
+        ...accessToken ? { Authorization: `Bearer ${accessToken}` } : {}
+      },
+      signal: controller.signal
+    });
+    if (!response.ok) return null;
+    const body = await response.json();
+    if (!body || typeof body !== "object") return null;
+    const record = body;
+    if (record.ok !== true) return null;
+    return parsePublicModelDefaultPayload({ selection: record.selection }).selection;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function noCliModelConnection(appUrl = null) {
+  return {
+    appUrl,
+    authenticated: false,
+    userId: null,
+    email: null,
+    founderModelSelection: null,
+    restore: () => {
+    }
+  };
+}
+var MODEL_PROXY_ENV, MODEL_PROXY_TOKEN_ENV, CLI_APP_URL_ENV, FALLBACK_APP_URL_ENV, DEFAULT_CLI_APP_URL;
+var init_modelConnection = __esm({
+  "features/perchTerminal/runtime/cliHost/modelConnection.ts"() {
+    "use strict";
+    init_publicModelDefault();
+    init_cliAuthSession();
+    init_cliAuthRefresh();
+    init_installCliModelProxyAuthRefresh();
+    MODEL_PROXY_ENV = "PERCH_MODEL_CALL_PROXY_URL";
+    MODEL_PROXY_TOKEN_ENV = "PERCH_MODEL_CALL_PROXY_TOKEN";
+    CLI_APP_URL_ENV = "PERCH_CLI_APP_URL";
+    FALLBACK_APP_URL_ENV = "PERCH_APP_URL";
+    DEFAULT_CLI_APP_URL = "https://app.perchai.app";
+  }
+});
+
 // features/perchTerminal/runtime/cliHost/cliStandaloneOAuth.ts
 import { execFile as execFile2 } from "node:child_process";
 import http from "node:http";
@@ -234263,7 +234728,7 @@ async function ensureFreshCliAuthSession(input) {
   if (!session?.accessToken?.trim()) return null;
   const nowSeconds = Math.floor(Date.now() / 1e3);
   const stillUsable = !session.expiresAt || session.expiresAt > nowSeconds + 90;
-  if (stillUsable) return session;
+  if (stillUsable && !input.forceRefresh) return session;
   if (!session.refreshToken?.trim()) return null;
   const fetchImpl = input.fetchImpl ?? globalThis.fetch;
   if (typeof fetchImpl !== "function") return null;
@@ -234308,112 +234773,340 @@ var init_cliAuthRefresh = __esm({
   }
 });
 
-// features/perchTerminal/runtime/cliHost/modelConnection.ts
-async function connectCliModelProxy(input = {}) {
-  const storedSession = input.storedSession === void 0 ? await readStoredCliAuthSession() : input.storedSession;
-  const usableStoredSession = await ensureFreshCliAuthSession({
-    session: storedSession,
-    fetchImpl: input.fetchImpl
-  });
-  const appUrl = resolveCliAppUrl(input.appUrl, usableStoredSession?.appUrl ?? null);
-  if (!appUrl) return noCliModelConnection();
-  if (!usableStoredSession?.accessToken) return noCliModelConnection(appUrl);
-  const fetchImpl = input.fetchImpl ?? globalThis.fetch;
-  if (typeof fetchImpl !== "function") return noCliModelConnection(appUrl);
-  const selection = await fetchPublicModelDefaultSelection(
-    appUrl,
-    fetchImpl,
-    usableStoredSession?.accessToken ?? null
-  );
-  if (!selection) return noCliModelConnection(appUrl);
-  const priorProxy = process.env[MODEL_PROXY_ENV];
-  const priorToken = process.env[MODEL_PROXY_TOKEN_ENV];
-  process.env[MODEL_PROXY_ENV] = appUrl;
-  if (usableStoredSession?.accessToken) {
-    process.env[MODEL_PROXY_TOKEN_ENV] = usableStoredSession.accessToken;
+// features/perchTerminal/runtime/cliHost/refreshCliTurnAuth.ts
+async function refreshCliTurnAuth(input) {
+  if (input.cliLocalTools !== true) return input;
+  const stored = await readStoredCliAuthSession();
+  if (!stored?.accessToken?.trim()) return input;
+  const turnToken = input.cliServerAccessToken?.trim();
+  if (turnToken && turnToken !== stored.accessToken) return input;
+  const fresh = await ensureFreshCliAuthSession({ session: stored });
+  if (!fresh?.accessToken?.trim()) return input;
+  if (fresh.accessToken === input.cliServerAccessToken) return input;
+  if (typeof process !== "undefined") {
+    process.env.PERCH_MODEL_CALL_PROXY_TOKEN = fresh.accessToken;
   }
   return {
-    appUrl,
-    authenticated: !!usableStoredSession?.accessToken,
-    userId: usableStoredSession?.userId ?? null,
-    email: usableStoredSession?.email ?? null,
-    founderModelSelection: selection,
-    restore: () => {
-      if (priorProxy === void 0) {
-        delete process.env[MODEL_PROXY_ENV];
-      } else {
-        process.env[MODEL_PROXY_ENV] = priorProxy;
-      }
-      if (priorToken === void 0) {
-        delete process.env[MODEL_PROXY_TOKEN_ENV];
-      } else {
-        process.env[MODEL_PROXY_TOKEN_ENV] = priorToken;
-      }
-    }
+    ...input,
+    cliServerAccessToken: fresh.accessToken,
+    marketDeskProxyAccessToken: input.marketDeskProxyAccessToken ?? fresh.accessToken
   };
 }
-function resolveCliAppUrl(explicit, stored) {
-  const raw = explicit?.trim() || process.env[CLI_APP_URL_ENV]?.trim() || process.env[FALLBACK_APP_URL_ENV]?.trim() || stored?.trim() || DEFAULT_CLI_APP_URL;
-  if (!raw) return null;
-  const withProtocol = /^https?:\/\//i.test(raw) ? raw : `http://${raw}`;
-  try {
-    const url = new URL(withProtocol);
-    url.pathname = url.pathname.replace(/\/+$/, "");
-    url.search = "";
-    url.hash = "";
-    return url.toString().replace(/\/+$/, "");
-  } catch {
-    return null;
+var init_refreshCliTurnAuth = __esm({
+  "features/perchTerminal/runtime/cliHost/refreshCliTurnAuth.ts"() {
+    "use strict";
+    init_cliAuthSession();
+    init_cliAuthRefresh();
   }
-}
-async function fetchPublicModelDefaultSelection(appUrl, fetchImpl, accessToken) {
-  const url = `${appUrl}/api/perch-terminal/public-model-default`;
-  const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), 3500);
+});
+
+// features/perchTerminal/runtime/cliHost/runCliTurn.ts
+import path15 from "node:path";
+async function runPerchCliTurn(input, options = {}) {
+  const prompt = input.prompt.trim();
+  if (!prompt) throw new Error("Missing prompt for perch run");
+  const now23 = options.now ?? (() => Date.now());
+  const cwd2 = path15.resolve(input.cwd ?? process.cwd());
+  const threadId = input.threadId?.trim() || `cli-${now23()}`;
+  const events = [];
+  let latestContextSnapshot = null;
+  const turnRunner = resolveTurnRunnerForPrompt(prompt) ?? options.turnRunner ?? runOperatorTurn;
+  const turnInput = buildCliTurnInput(input, {
+    prompt,
+    cwd: cwd2,
+    threadId
+  });
+  const deps = buildCliTurnDeps({
+    signal: input.signal ?? null,
+    events,
+    onEvent: input.onEvent,
+    onContextSnapshot: (snapshot) => {
+      latestContextSnapshot = snapshot;
+    },
+    refreshTurnInput: input.cliLocalTools !== false ? refreshCliTurnAuth : void 0
+  });
+  const restoreLocalBridge = input.cliLocalTools === false ? null : installCliNodeLocalBridge({ workspaceRoot: cwd2 });
   try {
-    const response = await fetchImpl(url, {
-      method: "GET",
-      headers: {
-        Accept: "application/json",
-        ...accessToken ? { Authorization: `Bearer ${accessToken}` } : {}
+    const result2 = await turnRunner(turnInput, deps);
+    return buildCliTurnResult({
+      prompt,
+      cwd: cwd2,
+      threadId,
+      events,
+      contextSnapshot: latestContextSnapshot,
+      result: result2,
+      error: null
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const runId = findRunId(events) ?? threadId;
+    return buildCliTurnResult({
+      prompt,
+      cwd: cwd2,
+      threadId,
+      events,
+      contextSnapshot: latestContextSnapshot,
+      result: {
+        status: "failed",
+        error: message,
+        runId
       },
-      signal: controller.signal
+      error: message
     });
-    if (!response.ok) return null;
-    const body = await response.json();
-    if (!body || typeof body !== "object") return null;
-    const record = body;
-    if (record.ok !== true) return null;
-    return parsePublicModelDefaultPayload({ selection: record.selection }).selection;
-  } catch {
-    return null;
   } finally {
-    clearTimeout(timeout);
+    restoreLocalBridge?.();
   }
 }
-function noCliModelConnection(appUrl = null) {
+function buildCliTurnInput(input, resolved) {
+  const workspaceId = input.workspaceId ?? null;
+  const userId = input.userId ?? null;
   return {
-    appUrl,
-    authenticated: false,
-    userId: null,
-    email: null,
-    founderModelSelection: null,
-    restore: () => {
+    trimmedInput: resolved.prompt,
+    clientRunId: input.clientRunId ?? null,
+    chatMode: input.chatMode ?? "agents",
+    threadId: resolved.threadId,
+    personaId: input.personaId ?? DEFAULT_PERSONA_ID,
+    workspaceId,
+    userId,
+    selectedSourceId: input.selectedSourceId ?? null,
+    recentMessages: input.recentMessages ?? [],
+    usageRunIds: input.usageRunIds ?? [],
+    sessionContext: emptyPerchTerminalSessionContext({
+      userId,
+      workspaceId
+    }),
+    desktopConnected: input.desktopConnected ?? false,
+    cliLocalTools: input.cliLocalTools !== false,
+    activeRootPath: input.activeRootPath ?? resolved.cwd,
+    localSources: [],
+    localSourcesMeta: null,
+    projectMeta: readCliProjectMemoryState(resolved.cwd).meta,
+    permanentMemories: input.permanentMemories ?? [],
+    userMemories: input.userMemories ?? [],
+    supabase: null,
+    supabaseConfigured: false,
+    cliServerAppUrl: input.cliServerAppUrl ?? input.marketDeskProxyAppUrl ?? input.appUrl ?? null,
+    cliServerAccessToken: input.cliServerAccessToken ?? input.marketDeskProxyAccessToken ?? null,
+    marketDeskProxyAppUrl: input.marketDeskProxyAppUrl ?? input.appUrl ?? null,
+    marketDeskProxyAccessToken: input.marketDeskProxyAccessToken ?? null,
+    permissionMode: normalizePermissionMode(input.permissionMode ?? "default"),
+    founderModelSelection: input.founderModelSelection ?? null,
+    threadEvidence: [],
+    workspaceFileResolution: null,
+    folderIndexSummary: null,
+    mcpTools: [],
+    coordinatorMode: false,
+    systemNotifications: [],
+    workflowState: null,
+    skipUserMessagePersistence: false,
+    systemInitiated: input.systemInitiated === true
+  };
+}
+function buildCliTurnDeps(input) {
+  return {
+    signal: input.signal,
+    onEvent: (event) => {
+      input.events.push(event);
+      input.onEvent?.(event);
+    },
+    onContextAssembled: input.onContextSnapshot,
+    ...input.refreshTurnInput ? { refreshTurnInput: input.refreshTurnInput } : {},
+    persistUserMessage: async () => null,
+    persistAssistantMessage: async () => null,
+    createWorkflowRun: async () => null,
+    finishWorkflowRun: async () => {
+    },
+    persistToolCall: async () => {
+    },
+    persistSandboxExecution: async () => null,
+    persistContextSnapshot: async () => null,
+    createManagedArtifact: async () => null,
+    createManagedReport: async () => null,
+    logProductAuditEvent: async () => {
     }
   };
 }
-var MODEL_PROXY_ENV, MODEL_PROXY_TOKEN_ENV, CLI_APP_URL_ENV, FALLBACK_APP_URL_ENV, DEFAULT_CLI_APP_URL;
-var init_modelConnection = __esm({
-  "features/perchTerminal/runtime/cliHost/modelConnection.ts"() {
+function buildCliTurnResult(input) {
+  const segments = buildTranscriptSegments({
+    events: input.events,
+    complete: true,
+    error: input.error
+  });
+  const status = input.result.status;
+  const assistantText = "assistantText" in input.result ? input.result.assistantText : "";
+  const durationMs = "durationMs" in input.result ? input.result.durationMs : null;
+  const error = input.error ?? ("error" in input.result ? input.result.error : void 0) ?? ("reason" in input.result ? input.result.reason : void 0);
+  return {
+    ok: status === "completed",
+    status,
+    prompt: input.prompt,
+    cwd: input.cwd,
+    threadId: input.threadId,
+    runId: input.result.runId,
+    durationMs,
+    assistantText,
+    events: input.events,
+    segments,
+    contextSnapshot: input.contextSnapshot,
+    ...error ? { error } : {}
+  };
+}
+function findRunId(events) {
+  const started = events.find((event) => event.type === "turn_started");
+  return started?.type === "turn_started" ? started.runId : null;
+}
+var init_runCliTurn = __esm({
+  "features/perchTerminal/runtime/cliHost/runCliTurn.ts"() {
     "use strict";
-    init_publicModelDefault();
-    init_cliAuthSession();
-    init_cliAuthRefresh();
-    MODEL_PROXY_ENV = "PERCH_MODEL_CALL_PROXY_URL";
-    MODEL_PROXY_TOKEN_ENV = "PERCH_MODEL_CALL_PROXY_TOKEN";
-    CLI_APP_URL_ENV = "PERCH_CLI_APP_URL";
-    FALLBACK_APP_URL_ENV = "PERCH_APP_URL";
-    DEFAULT_CLI_APP_URL = "https://app.perchai.app";
+    init_session();
+    init_sharedSlashCommands();
+    init_operatorStream();
+    init_permissionModes();
+    init_personaRegistry();
+    init_runOperatorTurn();
+    init_nodeLocalBridge();
+    init_nodeLocalBridge();
+    init_refreshCliTurnAuth();
+  }
+});
+
+// features/perchTerminal/runtime/cliHost/renderCliTurn.ts
+function renderCliTurnText(result2, options = {}) {
+  const lines = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const event of result2.events) {
+    const line = renderEventLine(event);
+    if (!line) continue;
+    const lineKey = `${line.label}:${line.text}`;
+    if (seen.has(lineKey)) continue;
+    seen.add(lineKey);
+    lines.push(renderStreamLine(line.label, line.text, options));
+  }
+  if (result2.assistantText.trim()) {
+    if (lines.length) lines.push("");
+    lines.push(
+      renderStreamLine(
+        personaLabel(options.personaId),
+        result2.assistantText.trim(),
+        options
+      )
+    );
+  }
+  if (!result2.ok) {
+    if (lines.length) lines.push("");
+    lines.push(
+      renderStreamLine(
+        "stop",
+        `Perch stopped: ${result2.error ?? result2.status}`,
+        { ...options, color: options.color }
+      )
+    );
+  }
+  return `${lines.join("\n").trim()}
+`;
+}
+function cliExitCodeForTurn(result2) {
+  if (result2.status === "completed") return 0;
+  if (result2.status === "approval_required" || result2.status === "blocked" || result2.status === "incomplete") {
+    return 2;
+  }
+  return 1;
+}
+function renderEventLine(event) {
+  switch (event.type) {
+    case "assistant_preamble":
+    case "activity_delta":
+    case "workflow_narration":
+      return event.text.trim() ? { label: "perch", text: event.text.trim() } : null;
+    case "model_call_started":
+      return { label: "work", text: event.lane ? `Working (${event.lane})` : "Working" };
+    case "tool_call_started":
+      return { label: "tool", text: `Running ${humanizeToolName(event.toolName)}` };
+    case "tool_call_failed":
+      return {
+        label: "need",
+        text: `Needs attention: ${humanizeToolName(event.toolName)}${event.error ? ` \u2014 ${event.error}` : ""}`
+      };
+    case "live_card_start":
+      return { label: "tool", text: event.subtitle ? `${event.title} \xB7 ${event.subtitle}` : event.title };
+    case "live_step":
+      return { label: "tool", text: `${event.label} ${event.status}` };
+    case "live_card_end":
+      return event.receipt?.summary || event.error ? { label: event.error ? "need" : "tool", text: event.receipt?.summary ?? event.error ?? "" } : null;
+    case "workflow_card_start":
+      return { label: "tool", text: `${event.personaName}: ${event.workflowLabel}` };
+    case "workflow_step":
+      return { label: "tool", text: `${event.label} ${event.status}` };
+    case "managed_workflow_started":
+      return { label: "tool", text: event.title };
+    case "managed_workflow_completed":
+      return { label: "tool", text: event.summary };
+    case "capability_required":
+      return { label: "need", text: `Action needed: ${event.message}` };
+    case "executor_waiting_for_user":
+      return { label: "wait", text: `Waiting: ${event.prompt}` };
+    case "executor_result_summary":
+      return { label: "tool", text: event.summary };
+    default:
+      return null;
+  }
+}
+function humanizeToolName(name) {
+  return name.replace(/^mcp__/, "").replace(/_/g, " ");
+}
+function renderStreamLine(label, text, options) {
+  if (!options.streamLabels) return text;
+  const rawLabel = label.toLowerCase().slice(0, 7);
+  const padded = rawLabel.padEnd(7, " ");
+  const labelText = colorize(padded, colorForLabel(rawLabel), options.color);
+  const body = colorizeMultiline(text, colorForBody(rawLabel), options.color, " ".repeat(7));
+  return `${labelText} ${body}`;
+}
+function colorize(text, color, enabled) {
+  return enabled ? `${ANSI[color]}${text}${ANSI.reset}` : text;
+}
+function colorizeMultiline(text, color, enabled, continuationIndent) {
+  const painted = colorize(text, color, enabled);
+  return painted.replace(/\n/g, `
+${continuationIndent} `);
+}
+function colorForLabel(label) {
+  if (label === "need" || label === "stop") return "red";
+  if (label === "tool" || label === "work" || label === "wait") return "muted";
+  if (label === "you") return "bronze";
+  return "accent";
+}
+function colorForBody(label) {
+  if (label === "need" || label === "stop") return "red";
+  if (label === "tool" || label === "work" || label === "wait") return "muted";
+  return "cream";
+}
+function personaLabel(personaId) {
+  return personaId === "quill" ? "quill" : personaId === "saffron" ? "saffron" : "perch";
+}
+var ANSI;
+var init_renderCliTurn = __esm({
+  "features/perchTerminal/runtime/cliHost/renderCliTurn.ts"() {
+    "use strict";
+    ANSI = {
+      reset: "\x1B[0m",
+      accent: "\x1B[38;2;47;94;67m",
+      bronze: "\x1B[38;2;154;82;40m",
+      cream: "\x1B[38;2;255;248;240m",
+      muted: "\x1B[38;2;142;133;125m",
+      green: "\x1B[38;2;110;191;130m",
+      red: "\x1B[38;2;208;107;85m"
+    };
+  }
+});
+
+// features/perchTerminal/runtime/cliHost/index.ts
+var init_cliHost = __esm({
+  "features/perchTerminal/runtime/cliHost/index.ts"() {
+    "use strict";
+    init_runCliTurn();
+    init_renderCliTurn();
+    init_nodeLocalBridge();
   }
 });
 
@@ -234937,6 +235630,17 @@ function claimFirstRun(dir = stateDir()) {
     return false;
   }
 }
+function claimFirstPrompt(dir = stateDir()) {
+  const file = path17.join(dir, "cli-first-prompt");
+  try {
+    if (fs15.existsSync(file)) return false;
+    fs15.mkdirSync(dir, { recursive: true });
+    fs15.writeFileSync(file, (/* @__PURE__ */ new Date()).toISOString());
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function postCapture(event, properties) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS2);
@@ -234963,6 +235667,17 @@ function captureCliFirstRun(version4) {
   if (!claimFirstRun()) return;
   void postCapture("cli_first_run", { version: version4, platform: process.platform });
 }
+function captureCliSessionStarted() {
+  if (!POSTHOG_KEY || telemetryDisabled()) return;
+  void postCapture("cli_session_started", { platform: process.platform });
+}
+function captureCliMessageSent() {
+  if (!POSTHOG_KEY || telemetryDisabled()) return;
+  void postCapture("message_sent", { surface: "cli" });
+  if (claimFirstPrompt()) {
+    void postCapture("first_message", { surface: "cli" });
+  }
+}
 var POSTHOG_KEY, POSTHOG_HOST, FETCH_TIMEOUT_MS2;
 var init_cliAnalytics = __esm({
   "features/perchTerminal/runtime/cliHost/cliAnalytics.ts"() {
@@ -289269,7 +289984,7 @@ function flockEventToCliRow(event) {
       return {
         id: `flock-${event.flockId}-${event.flockWorkerId}`,
         text: `${event.displayName} \xB7 ${event.nickname} \xB7 ${FLOCK_STATUS_LABELS[event.status] ?? event.status}`,
-        tone: event.status === "done" ? "success" : event.status === "failed" ? "danger" : "muted"
+        tone: event.status === "done" ? "success" : event.status === "failed" || event.status === "blocked" ? "danger" : "muted"
       };
     case "flock_run_completed":
       return {
@@ -289390,6 +290105,7 @@ ${HELP_TEXT}`);
           recentMessages: nextRecentMessages,
           contextSnapshot: result3.contextSnapshot ?? persisted?.contextSnapshot ?? null
         });
+        captureCliMessageSent();
         return cliExitCodeForTurn(result3);
       } finally {
         connection.restore();
@@ -289690,6 +290406,7 @@ async function runReadlineInteractivePerchCli(writer, deps, options) {
     terminal: true
   });
   const state = createInteractiveCliState(options);
+  captureCliSessionStarted();
   const connectModelProxy = deps.connectModelProxy ?? connectCliModelProxy;
   let connection = await connectModelProxy({ appUrl: state.appUrl });
   if (!state.appUrl && connection.appUrl) state.appUrl = connection.appUrl;
@@ -289750,6 +290467,7 @@ async function runReadlineInteractivePerchCli(writer, deps, options) {
     });
     if (!opts.systemInitiated) {
       appendRecentMessage(state.recentMessages, "user", turnPrompt);
+      captureCliMessageSent();
     }
     if (result2.assistantText.trim()) {
       appendRecentMessage(state.recentMessages, "assistant", result2.assistantText.trim());
@@ -289842,6 +290560,7 @@ async function runInkInteractivePerchCli(writer, deps, options) {
     const runTurn = deps.runCliTurn ?? runPerchCliTurn;
     const updateNotice = resolveUpdateNotice(CLI_PACKAGE_VERSION);
     captureCliFirstRun(CLI_PACKAGE_VERSION);
+    captureCliSessionStarted();
     const instance = Ink2.render(
       React11.createElement(function PerchInkApp() {
         const app = Ink2.useApp();
@@ -290463,6 +291182,7 @@ async function runInkInteractivePerchCli(writer, deps, options) {
             }
             if (!systemInitiated) {
               appendRecentMessage(state.recentMessages, "user", prompt);
+              captureCliMessageSent();
             }
             if (assistantText) appendRecentMessage(state.recentMessages, "assistant", assistantText);
             trimRecentMessages(state.recentMessages);