perchai-cli 2.4.12 → 2.4.13

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();
@@ -80628,13 +80627,13 @@ function buildDesktopContextSection(input) {
       label: "CLI workspace",
       content: [
         "## CLI local workspace",
-        "Perch is running from a terminal. Local filesystem, shell, sandbox-code, and AP evidence tools are available through the CLI local bridge.",
+        "Perch is running from a terminal. Local filesystem, shell, sandbox-code, and AP evidence tools are available through the CLI local runtime.",
         input.activeRootPath?.trim() ? `Workspace root: ${input.activeRootPath}. Treat relative paths as relative to this root.` : "Workspace root: current terminal directory.",
-        "Desktop-only services are not connected here: embedded browser, Google/Gmail/Calendar delivery, Desktop RAG indexing, MCP Desktop servers, and project memory writes are unavailable unless the Desktop app is running.",
+        "GUI-only services are not connected here: embedded browser, Google/Gmail/Calendar delivery, Desktop RAG indexing, MCP Desktop servers, and project memory writes are unavailable unless the desktop app is running.",
         localReadTools.length > 0 ? `Read tools: ${localReadTools.join(", ")}.` : "Read tools: none exposed for this turn.",
         localWriteTools.length > 0 ? `Write/command tools: ${localWriteTools.join(", ")}. These are governed by the selected permission mode and command policy.` : "Write/command tools: none exposed for this turn."
       ].join("\n"),
-      reason: "Terminal local bridge state and CLI tool availability for this turn.",
+      reason: "Terminal local runtime state and CLI tool availability for this turn.",
       sourcePath: input.activeRootPath,
       metadata: {
         desktopConnected: false,
@@ -80649,7 +80648,7 @@ function buildDesktopContextSection(input) {
       lane: "desktop",
       label: "Desktop workspace",
       content: "",
-      reason: "Desktop bridge is unavailable in browser mode.",
+      reason: "Local workspace runtime is unavailable in browser mode.",
       sourcePath: input.activeRootPath,
       skipped: true,
       metadata: { desktopConnected: false }
@@ -80736,7 +80735,7 @@ function buildDesktopContextSection(input) {
     label: "Desktop workspace",
     content: [
       "## Desktop environment",
-      "Desktop bridge is connected. Local filesystem tools are available to the operator runtime.",
+      "Desktop local runtime is connected. Local filesystem tools are available to the operator runtime.",
       input.activeRootPath?.trim() ? `Optional folder scope: ${input.activeRootPath} (you are NOT limited to it \u2014 absolute paths anywhere in the user's home work directly).` : "No folder scope is selected, and none is needed. When the user gives a file path, USE IT DIRECTLY \u2014 call readLocalFile / glob / grep / visionInspect with the absolute path (e.g. /Users/you/Desktop/shot.png). Full-access policy already allows any path in the user's home. NEVER tell the user to select or approve a folder, and NEVER refuse a file because no folder is selected.",
       `Visible local sources: ${totalVisibleFiles}`,
       input.localSourcesMeta?.refreshedAt ? `Local source snapshot refreshed: ${input.localSourcesMeta.refreshedAt}` : null,
@@ -80754,7 +80753,7 @@ function buildDesktopContextSection(input) {
       availableReadTools.length > 0 ? `Read tools: ${availableReadTools.join(", ")}.` : "Read tools: none exposed for this turn.",
       availableWriteTools.length > 0 ? `Write/command tools: ${availableWriteTools.join(", ")}. These are governed by the selected permission mode and command policy.` : "Write/command tools: none exposed for this turn."
     ].filter(Boolean).join("\n"),
-    reason: "Desktop bridge state, optional folder scope, and tool availability for this turn.",
+    reason: "Local runtime state, optional folder scope, and tool availability for this turn.",
     sourcePath: input.activeRootPath,
     metadata: {
       desktopConnected: true,
@@ -82928,7 +82927,6 @@ function truncateHistoryLine(value, max2) {
 }
 var init_operatorTruth = __esm({
   "features/perchTerminal/runtime/operatorTruth.ts"() {
-    "use strict";
   }
 });
 
@@ -91830,7 +91828,7 @@ function assembleContext(input) {
   );
   if (!input.desktopConnected && input.cliLocalTools !== true) {
     warnings.push(
-      "Desktop bridge is not connected. Local workspace tools are unavailable in browser mode."
+      "Local workspace runtime is not connected. Local workspace tools are unavailable in browser mode."
     );
   }
   return {
@@ -133572,7 +133570,7 @@ function validateToolCallPolicy(input) {
     return {
       ok: false,
       code: "tool_desktop_required",
-      message: "Local and browser automation tools require Perch AI Desktop. Filesystem access is validated per path by the current permission mode.",
+      message: "This tool requires a local runtime. Filesystem access is validated per path by the current permission mode.",
       riskLevel: classified.riskLevel,
       desktopRequired: true
     };
@@ -136033,7 +136031,7 @@ function getNativeToolDefinitions() {
       type: "function",
       function: {
         name: TOOL_NAMES.configInspect,
-        description: "Inspect the Perch Terminal runtime configuration: execution host, Desktop bridge status, optional folder scope, permission mode, and capabilities.",
+        description: "Inspect the Perch Terminal runtime configuration: execution host, local runtime status, optional folder scope, permission mode, and capabilities.",
         parameters: {
           type: "object",
           properties: {},
@@ -136936,7 +136934,7 @@ function notifyApprovedRootsChanged() {
 }
 async function pickFolder(request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   const result2 = await bridge.pickFolder({
     permissionMode: currentPermissionMode(),
     defaultPath: request?.defaultPath ?? null,
@@ -136949,7 +136947,7 @@ async function pickFolder(request) {
 }
 async function approveFolderAccess(path14, options) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   const result2 = await bridge.approveFolderAccess({
     path: path14,
     permissionMode: currentPermissionMode(),
@@ -136963,7 +136961,7 @@ async function checkFsAccess(request) {
   if (!bridge) {
     return {
       decision: "block",
-      reason: "Desktop bridge not available",
+      reason: "Local runtime not available",
       absolutePath: request.absolutePath,
       approvalPath: request.absolutePath
     };
@@ -136982,7 +136980,7 @@ async function checkFullDiskAccess() {
 }
 async function resolveDefaultSavePath(request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.resolveDefaultSavePath(request);
 }
 async function getApprovedRoots() {
@@ -136992,17 +136990,17 @@ async function getApprovedRoots() {
 }
 async function removeRoot(rootId) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.removeRoot(rootId);
 }
 async function listFiles(rootId, relativePath, depth) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, rootId, basePath: "", entries: [], truncated: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, rootId, basePath: "", entries: [], truncated: false, error: "Local runtime not available" };
   return bridge.listFiles(withPermissionMode({ rootId, relativePath, depth }));
 }
 async function readFile2(rootId, relativePath) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.readFile(withPermissionMode({ rootId, relativePath }));
 }
 function normalizeLegacyListResult(result2, request) {
@@ -137038,7 +137036,7 @@ async function listLocalSourcesDetailed(request) {
       query: typeof request === "object" && request ? request.query ?? null : null,
       refreshedAt: (/* @__PURE__ */ new Date()).toISOString(),
       maxSources: 0,
-      warning: "Desktop bridge not available"
+      warning: "Local runtime not available"
     };
   }
   const raw = await bridge.listLocalSources(request);
@@ -137046,7 +137044,7 @@ async function listLocalSourcesDetailed(request) {
 }
 async function readLocalSourceFile(localSourceId) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.readLocalFile(localSourceId, { permissionMode: currentPermissionMode() });
 }
 async function getProjectRules(rootId) {
@@ -137056,37 +137054,37 @@ async function getProjectRules(rootId) {
 }
 async function readProjectMemory(rootId) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.readProjectMemory({ rootId });
 }
 async function writeProjectMemory(rootId, meta) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.writeProjectMemory({ rootId, meta });
 }
 async function writeMemoryFile(rootId, request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.writeMemoryFile({ rootId, ...request });
 }
 async function writeRule(rootId, request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.writeRule({ rootId, ...request });
 }
 async function writePerchMd(rootId, request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.writePerchMd({ rootId, ...request });
 }
 async function readGlobalPerchMd() {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.readGlobalPerchMd();
 }
 async function writeGlobalPerchMd(content) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.writeGlobalPerchMd({ content });
 }
 async function getMcpStatus() {
@@ -137101,12 +137099,12 @@ async function listMcpTools() {
 }
 async function callMcpTool(request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.callMcpTool(request);
 }
 async function callEmbeddedBrowserTool(request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   if (typeof bridge.callEmbeddedBrowserTool !== "function") {
     return { ok: false, error: "Embedded browser bridge not available in this desktop build" };
   }
@@ -137114,7 +137112,7 @@ async function callEmbeddedBrowserTool(request) {
 }
 async function setEmbeddedBrowserVisible(open) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   if (typeof bridge.setEmbeddedBrowserVisible !== "function") {
     return { ok: false, error: "Embedded browser bridge not available in this desktop build" };
   }
@@ -137137,7 +137135,7 @@ function onEmbeddedBrowserState(handler) {
 }
 async function reconnectMcp() {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.reconnectMcp();
 }
 async function getOrStartBashTerminal(request) {
@@ -137182,37 +137180,37 @@ async function runLocalBash(request) {
 }
 async function readWorkspaceFile(request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.readWorkspaceFile(withPermissionMode(request, request));
 }
 async function writeWorkspaceFile(request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.writeWorkspaceFile(withPermissionMode(request, request));
 }
 async function moveLocalFile(request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.moveLocalFile(withPermissionMode(request, request));
 }
 async function copyLocalFile(request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.copyLocalFile(withPermissionMode(request, request));
 }
 async function createDirectory(request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.createDirectory(withPermissionMode(request, request));
 }
 async function deleteLocalFile(request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.deleteLocalFile(withPermissionMode(request, request));
 }
 async function printFile(request) {
   const bridge = getDesktopBridge();
-  if (!bridge) return { ok: false, error: "Desktop bridge not available" };
+  if (!bridge) return { ok: false, error: "Local runtime not available" };
   return bridge.printFile(withPermissionMode(request, request));
 }
 async function listWorkspaceFilesGlob(request) {
@@ -137271,7 +137269,7 @@ async function runLocalAPAuditPacket(request) {
   if (!bridge) {
     return {
       ok: false,
-      error: "Desktop bridge not available",
+      error: "Local runtime not available",
       errorCode: "desktop_bridge_unavailable",
       executionHost: "electron_desktop",
       durationMs: 0
@@ -137284,7 +137282,7 @@ async function runLocalPrepareAPEvidence(request) {
   if (!bridge?.runLocalPrepareAPEvidence) {
     return {
       ok: false,
-      error: "Desktop bridge AP evidence tool not available",
+      error: "AP evidence tool not available in local runtime",
       errorCode: bridge ? "missing_dependency" : "desktop_bridge_unavailable",
       executionHost: "electron_desktop",
       durationMs: 0
@@ -137297,7 +137295,7 @@ async function runLocalQueryAPCases(request) {
   if (!bridge?.runLocalQueryAPCases) {
     return {
       ok: false,
-      error: "Desktop bridge AP case query tool not available",
+      error: "AP case query tool not available in local runtime",
       errorCode: bridge ? "missing_dependency" : "desktop_bridge_unavailable",
       executionHost: "electron_desktop",
       durationMs: 0
@@ -137310,7 +137308,7 @@ async function runLocalRenderAPControlGraph(request) {
   if (!bridge?.runLocalRenderAPControlGraph) {
     return {
       ok: false,
-      error: "Desktop bridge AP control graph tool not available",
+      error: "AP control graph tool not available in local runtime",
       errorCode: bridge ? "missing_dependency" : "desktop_bridge_unavailable",
       executionHost: "electron_desktop",
       durationMs: 0
@@ -137323,7 +137321,7 @@ async function runLocalPayrollRunArtifact(request) {
   if (!bridge) {
     return {
       ok: false,
-      error: "Desktop bridge not available",
+      error: "Local runtime not available",
       errorCode: "desktop_bridge_unavailable",
       executionHost: "electron_desktop",
       durationMs: 0
@@ -137338,7 +137336,7 @@ function desktopGLReconcileAvailable() {
 async function runLocalGLReconcileArtifact(folderPath) {
   const bridge = getDesktopBridge();
   if (!bridge?.runLocalGLReconcileArtifact) {
-    return { ok: false, error: "Desktop bridge unavailable", errorCode: "desktop_bridge_unavailable", executionHost: "electron_desktop", durationMs: 0 };
+    return { ok: false, error: "Local runtime unavailable", errorCode: "desktop_bridge_unavailable", executionHost: "electron_desktop", durationMs: 0 };
   }
   return bridge.runLocalGLReconcileArtifact({ folderPath });
 }
@@ -137349,7 +137347,7 @@ function desktopStatementAuditAvailable() {
 async function runLocalStatementAuditArtifact(folderPath) {
   const bridge = getDesktopBridge();
   if (!bridge?.runLocalStatementAuditArtifact) {
-    return { ok: false, error: "Desktop bridge unavailable", errorCode: "desktop_bridge_unavailable", executionHost: "electron_desktop", durationMs: 0 };
+    return { ok: false, error: "Local runtime unavailable", errorCode: "desktop_bridge_unavailable", executionHost: "electron_desktop", durationMs: 0 };
   }
   return bridge.runLocalStatementAuditArtifact({ folderPath });
 }
@@ -137374,7 +137372,7 @@ async function runSandboxCodeJob(request) {
       kind: "blocked",
       error: bridge ? "capability_unavailable" : "not_desktop",
       executionHost: "electron-main",
-      message: bridge ? "This Perch AI Desktop bridge version does not expose runSandboxCodeJob." : "Perch AI Desktop bridge is unavailable."
+      message: bridge ? "This Perch build does not expose runSandboxCodeJob." : "Local runtime is unavailable."
     };
   }
   return bridge.runSandboxCodeJob(request);
@@ -198170,8 +198168,8 @@ async function resolvePlaybookInputs(args) {
     return {
       ok: false,
       status: "blocked",
-      errorCode: "desktop_bridge_unavailable",
-      message: "Managed playbooks require the Perch AI Desktop bridge for local source discovery and file reads.",
+      errorCode: "local_runtime_unavailable",
+      message: "Managed playbooks require the local runtime for source discovery and file reads.",
       folderPath: rawFolderPath,
       warnings: []
     };
@@ -199532,7 +199530,6 @@ function containsBrowserDeliveryTask(tasks) {
 var BROWSER_DELIVERY_ROLE_IDS;
 var init_browserDeliveryLock = __esm({
   "features/perchTerminal/agentPlatform/browserDeliveryLock.ts"() {
-    "use strict";
     BROWSER_DELIVERY_ROLE_IDS = /* @__PURE__ */ new Set([
       "doc_writer",
       "email_sender",
@@ -199903,6 +199900,30 @@ function abortRuntimeRun(runId, reason = "Run cancelled.") {
   cleanupRun(record);
   return true;
 }
+function submitRuntimeSteer(input) {
+  const runId = input.runId?.trim();
+  if (!runId) return { ok: false, error: "No active turn to steer." };
+  if (input.expectedRunId && input.expectedRunId !== runId) {
+    return { ok: false, error: `Expected active turn ${input.expectedRunId}, found ${runId}.` };
+  }
+  const record = getRuntimeRun(runId);
+  if (!record || record.status !== "running" || record.controller.signal.aborted) {
+    return { ok: false, error: "No active turn to steer." };
+  }
+  if (input.threadId && record.threadId && input.threadId !== record.threadId) {
+    return { ok: false, error: "Active turn belongs to a different thread." };
+  }
+  const text = input.text.trim();
+  if (!text) return { ok: false, error: "Steer input cannot be empty." };
+  record.steerQueue.push({
+    text,
+    mode: input.mode ?? "append",
+    clientMessageId: input.clientMessageId ?? null,
+    submittedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  record.updatedAt = nowMs();
+  return { ok: true, turnId: runId };
+}
 function consumeRuntimeSteers(runId) {
   const record = getRuntimeRun(runId);
   if (!record || record.status !== "running" || record.controller.signal.aborted) return [];
@@ -205951,14 +205972,14 @@ async function runAPAuditPacketAdapter(args) {
   const folderPath = (args.folderPath ?? "").trim();
   if (!isDesktopAvailable()) {
     return blockedEnvelope({
-      reason: "AP audit packet requires the Perch AI Desktop bridge for local filesystem access. The browser cannot read the user's filesystem.",
-      errorCode: "desktop_bridge_unavailable",
+      reason: "AP audit packet requires the local runtime for filesystem access. The browser cannot read the user's filesystem.",
+      errorCode: "local_runtime_unavailable",
       folderPath: folderPath || null
     });
   }
   if (!desktopAPAuditAvailable()) {
     return blockedEnvelope({
-      reason: "This Perch AI Desktop bridge version does not expose runLocalAPAuditPacket. Update Perch AI Desktop to a build that includes the AP audit capability.",
+      reason: "This Perch build does not expose runLocalAPAuditPacket. Update Perch CLI or rebuild the app package.",
       errorCode: "capability_unavailable",
       folderPath: folderPath || null
     });
@@ -206181,14 +206202,14 @@ function preflight(toolName) {
   if (!isDesktopAvailable()) {
     return blocked({
       toolName,
-      reason: "AP evidence tools require the Perch AI Desktop bridge for local filesystem access.",
-      errorCode: "desktop_bridge_unavailable"
+      reason: "AP evidence tools require the local runtime for filesystem access.",
+      errorCode: "local_runtime_unavailable"
     });
   }
   if (!desktopAPEvidenceAvailable()) {
     return blocked({
       toolName,
-      reason: "This Perch AI Desktop bridge version does not expose AP evidence tools. Update Desktop or run npm run desktop:compile.",
+      reason: "This Perch build does not expose AP evidence tools. Update Perch CLI or rebuild the app package.",
       errorCode: "capability_unavailable"
     });
   }
@@ -206939,13 +206960,13 @@ function blocked2(reason, errorCode) {
 async function runSandboxAnalysisAdapter(args, opts) {
   if (!isDesktopAvailable()) {
     return blocked2(
-      "runSandboxAnalysis requires the Perch AI Desktop bridge. The browser cannot execute sandbox jobs against local sources.",
-      "desktop_bridge_unavailable"
+      "runSandboxAnalysis requires the local runtime. The browser cannot execute sandbox jobs against local sources.",
+      "local_runtime_unavailable"
     );
   }
   if (!desktopSandboxAnalysisAvailable()) {
     return blocked2(
-      "This Perch AI Desktop bridge version does not expose runSandboxAnalysisJob. Update Perch AI Desktop to a build that includes the sandbox analysis capability.",
+      "This Perch build does not expose runSandboxAnalysisJob. Update Perch CLI or rebuild the app package.",
       "capability_unavailable"
     );
   }
@@ -210448,7 +210469,7 @@ function validateSuitePlan(plan, opts) {
     };
   }
   if (opts?.desktopConnected === false) {
-    return { valid: false, reason: "Desktop bridge required for local workflow tools." };
+    return { valid: false, reason: "Local runtime required for workflow tools." };
   }
   return { valid: true };
 }
@@ -213140,7 +213161,7 @@ var init_config2 = __esm({
             ok: true,
             configured: false,
             servers: [],
-            note: "Desktop bridge required for MCP."
+            note: "MCP servers are not connected in this runtime."
           };
         }
         const { getMcpStatus: getMcpStatus2 } = await Promise.resolve().then(() => (init_bridge(), bridge_exports));
@@ -213975,7 +213996,7 @@ async function executeToolCall(call, opts) {
       startMs,
       startedAt,
       code: "tool_desktop_required",
-      message: "Desktop bridge not available. Local tools require Perch AI Desktop.",
+      message: "Local runtime not available. Local tools require Perch Desktop or CLI local mode.",
       riskLevel: policy.riskLevel,
       desktopRequired: true
     });
@@ -224069,13 +224090,13 @@ function createCliNodeLocalBridge(input) {
       };
     },
     getProjectRules: async () => [],
-    readProjectMemory: async () => ({ ok: false, error: "Project memory is desktop-only in CLI local mode." }),
-    writeProjectMemory: async () => ({ ok: false, error: "Project memory is desktop-only in CLI local mode." }),
-    writeMemoryFile: async () => ({ ok: false, error: "Project memory is desktop-only in CLI local mode." }),
-    writeRule: async () => ({ ok: false, error: "Project rules are desktop-only in CLI local mode." }),
-    writePerchMd: async () => ({ ok: false, error: "PERCH.md writes are desktop-only in CLI local mode." }),
-    readGlobalPerchMd: async () => ({ ok: false, error: "Global PERCH.md is desktop-only in CLI local mode." }),
-    writeGlobalPerchMd: async () => ({ ok: false, error: "Global PERCH.md is desktop-only in CLI local mode." }),
+    readProjectMemory: async () => ({ ok: false, error: "Project memory is not available in this CLI package yet." }),
+    writeProjectMemory: async () => ({ ok: false, error: "Project memory writes are not available in this CLI package yet." }),
+    writeMemoryFile: async () => ({ ok: false, error: "Project memory files are not available in this CLI package yet." }),
+    writeRule: async () => ({ ok: false, error: "Project rule writes are not available in this CLI package yet." }),
+    writePerchMd: async () => ({ ok: false, error: "PERCH.md writes are not available in this CLI package yet." }),
+    readGlobalPerchMd: async () => ({ ok: false, error: "Global PERCH.md is not available in this CLI package yet." }),
+    writeGlobalPerchMd: async () => ({ ok: false, error: "Global PERCH.md writes are not available in this CLI package yet." }),
     getMcpStatus: async () => [],
     listMcpTools: async () => [],
     callMcpTool: async () => ({ ok: false, error: "MCP tools are not available in CLI local mode." }),
@@ -224631,6 +224652,7 @@ function buildCliTurnInput(input, resolved) {
   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,
@@ -280080,6 +280102,7 @@ async function runInkInteractivePerchCli(writer, deps, options) {
         const [pulse, setPulse] = React11.useState(0);
         const [, refresh] = React11.useState(0);
         const liveTextRef = React11.useRef("");
+        const activeRunRef = React11.useRef(null);
         React11.useEffect(() => {
           if (!working) return void 0;
           const timer = setInterval(() => setPulse((value) => value + 1), 120);
@@ -280148,6 +280171,15 @@ async function runInkInteractivePerchCli(writer, deps, options) {
           setLiveText("");
           liveTextRef.current = "";
           const toolNamesById = /* @__PURE__ */ new Map();
+          const clientRunId = createCliRunId();
+          const externalController = new AbortController();
+          const runtimeRun = registerRuntimeRun({
+            runId: clientRunId,
+            kind: "turn",
+            threadId: state.threadId,
+            parentSignal: externalController.signal
+          });
+          activeRunRef.current = { runId: clientRunId, threadId: state.threadId };
           try {
             if (!isCliModelConnectionReady(connection)) {
               addItem({
@@ -280173,8 +280205,10 @@ async function runInkInteractivePerchCli(writer, deps, options) {
               workspaceId: hostedContext.workspaceId,
               permanentMemories: hostedContext.permanentMemories,
               founderModelSelection: connection.founderModelSelection,
+              clientRunId,
               desktopConnected: state.desktopConnected,
               cliLocalTools: state.cliLocalTools,
+              signal: runtimeRun.controller.signal,
               onEvent: (event) => {
                 switch (event.type) {
                   case "content_delta":
@@ -280268,6 +280302,11 @@ async function runInkInteractivePerchCli(writer, deps, options) {
           } catch (error) {
             addItem({ label: "stop", text: humanizeCliError(errorMessage(error)), tone: "danger" });
           } finally {
+            finishRuntimeRun(clientRunId, runtimeRun.controller.signal.aborted ? "cancelled" : "completed");
+            externalController.abort();
+            if (activeRunRef.current?.runId === clientRunId) {
+              activeRunRef.current = null;
+            }
             setWorking(false);
             setWorkingText("ready");
             setLiveText("");
@@ -280275,7 +280314,44 @@ async function runInkInteractivePerchCli(writer, deps, options) {
           }
         }, [addItem, app, reconnect, runTurn, updateToolItem, working]);
         Ink2.useInput((input, key) => {
-          if (working) return;
+          if (working) {
+            if (key.ctrl && input === "c") {
+              const active = activeRunRef.current;
+              if (active && abortRuntimeRun(active.runId, "Stopped from CLI.")) {
+                addItem({ label: "stop", text: "stop requested", tone: "danger" });
+                setWorkingText("stopping");
+              }
+              return;
+            }
+            if (key.return) {
+              const steerText = draft.trim();
+              const active = activeRunRef.current;
+              if (steerText && active) {
+                const result2 = submitRuntimeSteer({
+                  runId: active.runId,
+                  expectedRunId: active.runId,
+                  threadId: active.threadId,
+                  text: steerText,
+                  mode: "append",
+                  clientMessageId: `cli-steer-${Date.now()}`
+                });
+                if (result2.ok) {
+                  addItem({ label: "you", text: steerText, tone: "touch" });
+                  addItem({ label: "system", text: "steer queued", tone: "muted" });
+                  setDraft("");
+                } else {
+                  addItem({ label: "need", text: result2.error, tone: "danger" });
+                }
+              }
+              return;
+            }
+            if (key.backspace || key.delete) {
+              setDraft((value) => value.slice(0, -1));
+              return;
+            }
+            if (input && !key.escape) setDraft((value) => value + input);
+            return;
+          }
           if (key.return) {
             void submitPrompt(draft);
             return;
@@ -280422,7 +280498,7 @@ async function runInkInteractivePerchCli(writer, deps, options) {
           )
         );
       }),
-      { exitOnCtrlC: true }
+      { exitOnCtrlC: false }
     );
     await instance.waitUntilExit();
     connection.restore();
@@ -280950,6 +281026,9 @@ function trimRecentMessages(messages) {
     messages.splice(0, messages.length - 30);
   }
 }
+function createCliRunId() {
+  return `cli-turn-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
 async function runAuthCommand(parsed, writer) {
   if (parsed.action === "logout") {
     await clearStoredCliAuthSession();
@@ -281220,6 +281299,7 @@ var init_perch_cli = __esm({
     init_cliStandaloneOAuth();
     init_contextMeterDisplay();
     init_threadSession();
+    init_runRegistry();
     execFileAsync3 = promisify3(execFile3);
     DEFAULT_CLI_LOGIN_APP_URL = "https://app.perchai.app";
     CLI_PACKAGE_VERSION = readCliPackageVersion();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perchai-cli",
-  "version": "2.4.12",
+  "version": "2.4.13",
   "description": "Perch AI command-line interface",
   "bin": {
     "perch": "bin/perch"