perchai-cli 2.4.35 → 2.4.37

package/dist/perch.mjs

@@ -75917,7 +75917,6 @@ function isTurnAbortedError(error) {
 var TURN_STOPPED_BY_USER_MESSAGE;
 var init_turnAbort = __esm({
   "features/perchTerminal/runtime/turnAbort.ts"() {
-    "use strict";
     TURN_STOPPED_BY_USER_MESSAGE = "Turn stopped by user.";
   }
 });
@@ -76218,7 +76217,6 @@ function getToolDisplayName(toolName) {
 var NON_MODULE_TOOL_OWNERS, TOOL_RISK, TOOL_DISPLAY_NAMES;
 var init_catalog = __esm({
   "features/perchTerminal/runtime/toolSystem/catalog.ts"() {
-    "use strict";
     init_toolNames();
     NON_MODULE_TOOL_OWNERS = {
       [TOOL_NAMES.listSources]: "lane",
@@ -83126,7 +83124,6 @@ function listFinancialRoleIds() {
 var FINANCIAL_ROLE_REGISTRY, evidenceScoutManifest;
 var init_financialRoles = __esm({
   "features/perchTerminal/agentPlatform/financialRoles.ts"() {
-    "use strict";
     FINANCIAL_ROLE_REGISTRY = /* @__PURE__ */ new Map();
     evidenceScoutManifest = {
       workerId: "evidence_scout",
@@ -138643,6 +138640,7 @@ function offSandboxEvent(runId, handler) {
 var LOCAL_WORKSPACE_ACCESS_UNAVAILABLE;
 var init_bridge = __esm({
   "features/perchTerminal/desktop/bridge.ts"() {
+    "use strict";
     LOCAL_WORKSPACE_ACCESS_UNAVAILABLE = "Local workspace access is unavailable. Open Perch Desktop or update the app.";
   }
 });
@@ -197922,6 +197920,15 @@ async function dispatchAgentHandler(args, ctx) {
   const agentCtx = {
     workspaceRoot,
     desktopConnected: ctx.desktopConnected,
+    // CLI surface: children inherit the local bridge and server auth, same as
+    // flock's buildSpawnContext — otherwise filesystem workers fail with
+    // worker_desktop_workspace_required on the CLI.
+    cliLocalTools: ctx.cliLocalTools === true,
+    scopedFolderPath: ctx.scopedFolderPath,
+    cliServerAppUrl: ctx.cliServerAppUrl ?? null,
+    cliServerAccessToken: ctx.cliServerAccessToken ?? null,
+    marketDeskProxyAppUrl: ctx.marketDeskProxyAppUrl ?? null,
+    marketDeskProxyAccessToken: ctx.marketDeskProxyAccessToken ?? null,
     activeRootPath: ctx.activeRootPath,
     permissionMode: ctx.permissionMode,
     workspaceId: ctx.workspaceId,
@@ -205368,7 +205375,7 @@ function clampInt(value, min2, max2, fallback) {
   const num = typeof value === "number" && Number.isFinite(value) ? Math.floor(value) : fallback;
   return Math.min(Math.max(num, min2), max2);
 }
-var ADHOC_FORBIDDEN_TOOLS, ADHOC_WRITE_TOOLS, ADHOC_MAX_ITERATIONS, MAX_NAME_CHARS, MAX_CONTRACT_CHARS, DEFAULT_OUTPUT_CONTRACT;
+var ADHOC_FORBIDDEN_TOOLS, ADHOC_WRITE_TOOLS, ADHOC_MAX_ITERATIONS, ADHOC_MAX_TOOL_CALLS, MAX_NAME_CHARS, MAX_CONTRACT_CHARS, DEFAULT_OUTPUT_CONTRACT;
 var init_adhocManifest = __esm({
   "features/perchTerminal/runtime/workers/adhocManifest.ts"() {
     "use strict";
@@ -205397,6 +205404,7 @@ var init_adhocManifest = __esm({
       TOOL_NAMES.createDirectory
     ]);
     ADHOC_MAX_ITERATIONS = 10;
+    ADHOC_MAX_TOOL_CALLS = 40;
     MAX_NAME_CHARS = 40;
     MAX_CONTRACT_CHARS = 240;
     DEFAULT_OUTPUT_CONTRACT = "Return a short structured summary of what was found or done.";
@@ -205485,6 +205493,14 @@ var init_spawnWorker = __esm({
       handler: async (args, ctx) => {
         let workerId = String(args.workerId ?? "");
         const objective = String(args.objective ?? "");
+        if (!ctx.onEvent) {
+          return {
+            ok: false,
+            workerId,
+            summary: "spawn_worker requires an event sink from the parent tool loop.",
+            errorCode: "worker_event_sink_missing"
+          };
+        }
         let adhocManifestId = null;
         let adhocNickname = null;
         const customSpec = parseAdhocSpec(args.custom);
@@ -205499,11 +205515,13 @@ var init_spawnWorker = __esm({
         if (workerId && customSpec && !resolveWorkerManifest(workerId)) {
           workerId = "";
         }
+        let adhocDisplayTitle;
         if (!workerId && customSpec) {
           const { manifest, droppedTools } = buildAdhocWorkerManifest(customSpec);
           registerWorkerManifest(manifest);
           adhocManifestId = manifest.workerId;
           adhocNickname = flockNicknameFor(manifest.workerId, 0);
+          adhocDisplayTitle = `${manifest.name} \xB7 ${adhocNickname}`;
           workerId = manifest.workerId;
           if (droppedTools.length > 0 && ctx.onEvent) {
             ctx.onEvent({
@@ -205524,15 +205542,7 @@ var init_spawnWorker = __esm({
         }
         const context = typeof args.context === "string" || typeof args.context === "object" && args.context !== null && !Array.isArray(args.context) ? args.context : void 0;
         const lane = typeof args.lane === "string" ? args.lane : void 0;
-        const maxIterations = typeof args.maxIterations === "number" ? args.maxIterations : void 0;
-        if (!ctx.onEvent) {
-          return {
-            ok: false,
-            workerId,
-            summary: "spawn_worker requires an event sink from the parent tool loop.",
-            errorCode: "worker_event_sink_missing"
-          };
-        }
+        const maxIterations = typeof args.maxIterations === "number" ? adhocManifestId ? Math.min(args.maxIterations, ADHOC_MAX_ITERATIONS) : args.maxIterations : void 0;
         const enrichedContext = await threadPriorSpecialistContext({
           threadId: ctx.threadId,
           roleId: workerId,
@@ -205554,10 +205564,30 @@ Proceed with the available context. If a missing fact is essential, ask the user
         ].filter(Boolean).join("\n\n");
         try {
           const result2 = await spawnWorker(
-            { workerId, objective: workerObjective, context: enrichedContext, lane, maxIterations },
             {
+              workerId,
+              objective: workerObjective,
+              context: enrichedContext,
+              lane,
+              maxIterations,
+              // Ad-hoc workers get a hard real-tool-call ceiling (observed live:
+              // an unbounded 66-call run). Registered workers keep their existing
+              // behavior — suites and managed workflows own their own budgets.
+              maxToolCalls: adhocManifestId ? ADHOC_MAX_TOOL_CALLS : void 0
+            },
+            {
+              displayTitle: adhocDisplayTitle,
               workspaceRoot: effectiveWorkspaceRoot(ctx),
               desktopConnected: ctx.desktopConnected,
+              // CLI surface: children inherit the local bridge and server auth,
+              // same as flock's buildSpawnContext — without these, every worker
+              // needing filesystem access dies with worker_desktop_workspace_required.
+              cliLocalTools: ctx.cliLocalTools === true,
+              scopedFolderPath: ctx.scopedFolderPath,
+              cliServerAppUrl: ctx.cliServerAppUrl ?? null,
+              cliServerAccessToken: ctx.cliServerAccessToken ?? null,
+              marketDeskProxyAppUrl: ctx.marketDeskProxyAppUrl ?? null,
+              marketDeskProxyAccessToken: ctx.marketDeskProxyAccessToken ?? null,
               activeRootPath: ctx.activeRootPath,
               permissionMode: ctx.permissionMode,
               workspaceId: ctx.workspaceId,
@@ -220218,12 +220248,13 @@ async function spawnWorker(args, ctx) {
       errorCode: "worker_not_found"
     };
   }
+  const eventTitle = ctx.displayTitle?.trim() || manifest.name;
   const runDiscriminator = ctx.runId ?? Date.now().toString(36);
   const childThreadId = args.childThreadId ?? (ctx.threadId ? `${ctx.threadId}::worker::${args.workerId}::${runDiscriminator}` : null);
   const workerRun = ctx.threadId ? await registerWorkerRun({
     threadId: ctx.threadId,
     workerId: args.workerId,
-    title: manifest.name,
+    title: eventTitle,
     objective: args.objective,
     context: args.context,
     parentToolCallId: ctx.parentToolCallId ?? null,
@@ -220246,14 +220277,14 @@ async function spawnWorker(args, ctx) {
       childThreadId,
       workerRunId: runtimeWorkerRunId,
       workerId: args.workerId,
-      title: manifest.name
+      title: eventTitle
     });
   }
   ctx.onEvent({
     type: "worker_run_started",
     workerId: args.workerId,
     workerRunId: runtimeWorkerRunId,
-    title: manifest.name,
+    title: eventTitle,
     objective: args.objective,
     contextSummary: summarizeWorkerContextForTranscript(args.context),
     childThreadId,
@@ -220460,18 +220491,24 @@ ${contextBlock}
       attachOperatorScreenshots: isBrowserDeliveryRole(args.workerId)
     };
     const result2 = await runModelToolLoop(loopInput);
+    const approvalBlocked = result2.stopReason === "approval_required" ? result2.pendingApproval ?? null : null;
     const recoveredStructuredOutput = recoverWorkerStructuredOutput(args.workerId, args.objective, args.context, result2.toolCalls);
     const structuredOutput = parseStructuredRecordFromModelText(result2.text) ?? recoveredStructuredOutput;
     const missingRequiredOutput = result2.ok && Boolean(manifest.outputSchema) && !structuredOutput;
     const verifierPartialOrFail = (args.workerId === "source_verifier" || args.workerId === "legal_citation_verifier") && structuredOutput !== null && typeof structuredOutput === "object" && structuredOutput.verificationStatus !== "pass";
     const hasUsableOutput = Boolean(structuredOutput) || Boolean(recoveredStructuredOutput) || (result2.text?.trim().length ?? 0) > 50;
-    const workerOk = (result2.ok || Boolean(recoveredStructuredOutput)) && !missingRequiredOutput;
-    const usabilityStatus = resolveWorkerUsability({
+    const workerOk = !approvalBlocked && (result2.ok || Boolean(recoveredStructuredOutput)) && !missingRequiredOutput;
+    const usabilityStatus = approvalBlocked ? "needs_user_input" : resolveWorkerUsability({
       workerOk,
       hasUsableOutput,
       verifierPartialOrFail
     });
     const workerWarnings = [];
+    if (approvalBlocked) {
+      workerWarnings.push(
+        "Worker stopped at an approval gate \u2014 the gated action did not run."
+      );
+    }
     if (verifierPartialOrFail && hasUsableOutput) {
       workerWarnings.push(`Verification returned "${structuredOutput?.verificationStatus ?? "unknown"}" \u2014 output usable with caveat.`);
     }
@@ -220483,7 +220520,7 @@ ${contextBlock}
     }
     const recoveredSummary = recoveredStructuredOutput ? summarizeRecoveredWorkerOutput(args.workerId, recoveredStructuredOutput) : null;
     const summary = truncateSummary(
-      workerOk ? !result2.ok && recoveredSummary ? recoveredSummary : result2.text || recoveredSummary || (recoveredStructuredOutput ? JSON.stringify(recoveredStructuredOutput) : "") : missingRequiredOutput ? result2.text || "Worker stopped without returning the required structured JSON output." : result2.text || result2.error || "Worker failed before producing output."
+      approvalBlocked ? `Blocked at an approval gate: ${approvalBlocked.toolName ?? "a gated tool"} requires approval in the current permission mode${approvalBlocked.reason ? ` (${approvalBlocked.reason})` : ""}. The action did not run. Approve it interactively, or re-run under /permission take_the_wheel.` : workerOk ? !result2.ok && recoveredSummary ? recoveredSummary : result2.text || recoveredSummary || (recoveredStructuredOutput ? JSON.stringify(recoveredStructuredOutput) : "") : missingRequiredOutput ? result2.text || "Worker stopped without returning the required structured JSON output." : result2.text || result2.error || "Worker failed before producing output."
     );
     const durationMs = Date.now() - startMs;
     let contextPacket = null;
@@ -220520,7 +220557,7 @@ ${contextBlock}
       type: "worker_run_completed",
       workerId: args.workerId,
       workerRunId: runtimeWorkerRunId,
-      title: manifest.name,
+      title: eventTitle,
       childThreadId,
       persistedThreadId,
       parentToolCallId: ctx.parentToolCallId ?? null,
@@ -220554,7 +220591,7 @@ ${contextBlock}
           missingRequiredOutput,
           verifierPartialOrFail,
           error: result2.error
-        }) : void 0,
+        }) : approvalBlocked ? "worker_approval_required" : void 0,
         workerOffThreadTokens: workerTokenEstimate,
         contextPacket
       }, { supabase: ctx.supabase ?? null });
@@ -220578,7 +220615,7 @@ ${contextBlock}
         missingRequiredOutput,
         verifierPartialOrFail,
         error: result2.error
-      }) : void 0,
+      }) : approvalBlocked ? "worker_approval_required" : void 0,
       warnings: workerWarnings.length > 0 ? workerWarnings : void 0
     };
   } catch (error) {
@@ -220589,7 +220626,7 @@ ${contextBlock}
       type: "worker_run_completed",
       workerId: args.workerId,
       workerRunId: runtimeWorkerRunId,
-      title: manifest.name,
+      title: eventTitle,
       childThreadId,
       parentToolCallId: ctx.parentToolCallId ?? null,
       ok: false,

package/package.json

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