perchai-cli 2.4.31 → 2.4.33

package/dist/perch.mjs

@@ -75917,6 +75917,7 @@ 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.";
   }
 });
@@ -76217,7 +76218,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",
@@ -83125,6 +83125,7 @@ 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",
@@ -91687,7 +91688,6 @@ 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 = {
@@ -196813,6 +196813,7 @@ 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;
@@ -216864,6 +216865,58 @@ function createSourceReadBudgetState() {
     syntheticResultIssued: false
   };
 }
+function createFailedReadBreakerState() {
+  return { consecutiveFailedReads: 0, tripped: false };
+}
+function buildFailedReadBreakerSuppressionExecution(toolCall, state) {
+  if (!state.tripped) return null;
+  if (!FAILED_READ_BREAKER_TOOLS.has(toolCall.name)) return null;
+  const timestamp = now5();
+  return {
+    toolCallId: toolCall.id,
+    toolName: toolCall.name,
+    toolKind: "read",
+    riskLevel: "read",
+    input: sanitizeToolInput(toolCall.arguments),
+    ok: true,
+    result: FAILED_READ_BREAKER_MESSAGE,
+    output: {
+      ok: true,
+      suppressedFailedReadBreaker: true,
+      consecutiveFailedReads: state.consecutiveFailedReads,
+      message: FAILED_READ_BREAKER_MESSAGE
+    },
+    outputSummary: FAILED_READ_BREAKER_MESSAGE,
+    durationMs: 0,
+    startedAt: timestamp,
+    completedAt: timestamp,
+    desktopRequired: false,
+    resultTruncated: false,
+    evidence: []
+  };
+}
+function recordFailedReadBreakerExecution(state, execution) {
+  if (!FAILED_READ_BREAKER_TOOLS.has(execution.toolName)) return false;
+  if (isSyntheticReadSuppressionExecution(execution) || execution.errorCode === "tool_call_budget_exhausted" || isFailedReadBreakerSuppressionExecution(execution)) {
+    return false;
+  }
+  if (execution.ok) {
+    state.consecutiveFailedReads = 0;
+    return false;
+  }
+  state.consecutiveFailedReads += 1;
+  if (!state.tripped && state.consecutiveFailedReads >= FAILED_READ_BREAKER_LIMIT) {
+    state.tripped = true;
+    return true;
+  }
+  return false;
+}
+function isFailedReadBreakerSuppressionExecution(execution) {
+  const output = execution.output;
+  return Boolean(
+    output && typeof output === "object" && output.suppressedFailedReadBreaker === true
+  );
+}
 function buildSourceReadBudgetSuppressionExecution(toolCall, budget, opts) {
   const limits = resolveSourceReadBudgetLimits(opts);
   if (!limits) return null;
@@ -217242,7 +217295,7 @@ function sanitizeMaxIterations(value, cap = MAX_ITERATIONS) {
 function now5() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
-var MAX_ITERATIONS, MAX_WORKER_ITERATIONS, SOURCE_ANALYSIS_MAX_ITERATIONS, SUBSTANTIAL_FINAL_TEXT_MIN_CHARS, SUBSTANTIAL_FINAL_TEXT_MIN_WORDS, CHAT_SOURCE_READ_TOTAL_BUDGET, CHAT_SOURCE_READ_FAMILY_BUDGET, SOURCE_ANALYSIS_SOURCE_READ_TOTAL_BUDGET, SOURCE_ANALYSIS_SOURCE_READ_FAMILY_BUDGET, SOURCE_READ_BUDGET_MESSAGE, FINAL_TEXT_SUPPRESSIBLE_READ_TOOLS, DUPLICATE_READ_SUPPRESSIBLE_TOOLS, SOURCE_READ_BUDGET_COUNTED_TOOLS, SOURCE_READ_BUDGET_SUPPRESSIBLE_TOOLS, POST_BUDGET_SOURCE_ANALYSIS_FINISHER_TOOLS;
+var MAX_ITERATIONS, MAX_WORKER_ITERATIONS, SOURCE_ANALYSIS_MAX_ITERATIONS, SUBSTANTIAL_FINAL_TEXT_MIN_CHARS, SUBSTANTIAL_FINAL_TEXT_MIN_WORDS, CHAT_SOURCE_READ_TOTAL_BUDGET, CHAT_SOURCE_READ_FAMILY_BUDGET, SOURCE_ANALYSIS_SOURCE_READ_TOTAL_BUDGET, SOURCE_ANALYSIS_SOURCE_READ_FAMILY_BUDGET, SOURCE_READ_BUDGET_MESSAGE, FINAL_TEXT_SUPPRESSIBLE_READ_TOOLS, DUPLICATE_READ_SUPPRESSIBLE_TOOLS, SOURCE_READ_BUDGET_COUNTED_TOOLS, SOURCE_READ_BUDGET_SUPPRESSIBLE_TOOLS, POST_BUDGET_SOURCE_ANALYSIS_FINISHER_TOOLS, FAILED_READ_BREAKER_TOOLS, FAILED_READ_BREAKER_LIMIT, FAILED_READ_BREAKER_MESSAGE;
 var init_sourceReadPolicy = __esm({
   "features/perchTerminal/runtime/toolLoop/sourceReadPolicy.ts"() {
     "use strict";
@@ -217315,6 +217368,13 @@ var init_sourceReadPolicy = __esm({
       TOOL_NAMES.prepareSandboxInputs,
       TOOL_NAMES.runSandboxCode
     ]);
+    FAILED_READ_BREAKER_TOOLS = /* @__PURE__ */ new Set([
+      TOOL_NAMES.readLocalFile,
+      TOOL_NAMES.readLocalSourceFile,
+      TOOL_NAMES.printFile
+    ]);
+    FAILED_READ_BREAKER_LIMIT = 6;
+    FAILED_READ_BREAKER_MESSAGE = `Stopped file reads after ${FAILED_READ_BREAKER_LIMIT} consecutive misses \u2014 the paths being guessed do not exist. Do not probe further paths. Use the context you were given, or finish from gathered evidence now.`;
   }
 });
 
@@ -217423,6 +217483,14 @@ async function executeToolBatch(toolCalls, ctx) {
         });
         return budgetSuppression;
       }
+      const failedReadSuppression = buildFailedReadBreakerSuppressionExecution(
+        toolCall,
+        ctx.failedReadBreaker
+      );
+      if (failedReadSuppression) {
+        ctx.sourceReadBudget.syntheticResultIssued = true;
+        return failedReadSuppression;
+      }
       const duplicateRead = buildDuplicateReadSuppressionExecution(
         toolCall,
         ctx.successfulReadToolSignatures
@@ -217521,6 +217589,14 @@ async function executeToolBatch(toolCalls, ctx) {
       ctx.untrustedContextAvailable = true;
       rememberSuccessfulReadExecution(ctx.successfulReadToolSignatures, execution);
       recordSuccessfulSourceReadExecution(ctx.sourceReadBudget, execution);
+      if (recordFailedReadBreakerExecution(ctx.failedReadBreaker, execution)) {
+        ctx.onEvent({
+          type: "diagnostic",
+          code: "failed_read_breaker_tripped",
+          message: `${FAILED_READ_BREAKER_LIMIT} consecutive file reads failed \u2014 suppressing further file reads this run and finishing from gathered evidence.`,
+          ts: now6()
+        });
+      }
       const updatedMode = permissionModeFromExecution(execution);
       if (updatedMode) ctx.permissionMode = updatedMode;
       const consecutiveArgFailureCount = updateConsecutiveRequiredArgFailures(
@@ -219281,6 +219357,7 @@ async function runModelToolLoop(input) {
   const successfulReadToolSignatures = /* @__PURE__ */ new Map();
   const sourceReadBudget = createSourceReadBudgetState();
   const consecutiveRequiredArgFailures = /* @__PURE__ */ new Map();
+  const failedReadBreaker = createFailedReadBreakerState();
   const startMs = Date.now();
   let iterations = 0;
   let lastProvider = "unknown";
@@ -219573,6 +219650,7 @@ async function runModelToolLoop(input) {
       sourceReadBudget,
       successfulReadToolSignatures,
       consecutiveRequiredArgFailures,
+      failedReadBreaker,
       permissionMode: effectivePermissionMode,
       realToolCallsStarted,
       firstPartyToolIntentUsed,
@@ -221349,6 +221427,27 @@ var init_flockRoles = __esm({
           "Return JSON with verificationStatus (pass|partial|fail), verifiedClaims, unsupportedClaims, warnings."
         )
       },
+      consistency_checker: {
+        roleId: "consistency_checker",
+        workerId: "flock_consistency_checker",
+        displayName: "Consistency Checker",
+        role: "verifier",
+        lane: "verifier",
+        allowedTools: [
+          TOOL_NAMES.searchKnowledge,
+          TOOL_NAMES.readLocalFile,
+          TOOL_NAMES.listLocalSources,
+          TOOL_NAMES.readLocalSourceFile
+        ],
+        writesWorkspace: false,
+        maxIterations: 8,
+        outputContract: "JSON { continuityStatus: 'pass'|'partial'|'fail', contradictions, styleIssues, warnings }",
+        objectiveTemplate: (task) => bounded(
+          task,
+          "Review the provided draft for internal consistency and craft: continuity of characters, names, timeline, and established facts; tone and voice drift; pacing; clich\xE9s. Do not fact-check against external sources.",
+          "Return JSON with continuityStatus (pass|partial|fail), contradictions (string[]), styleIssues (string[]), warnings (string[])."
+        )
+      },
       browser_operator: {
         roleId: "browser_operator",
         // Reuses the roster manifest from workers/registry — its system prompt and
@@ -221423,7 +221522,16 @@ function planFlock(rawTask, options = {}) {
   if (selected.has("patch_worker") || selected.has("test_runner") || selected.has("ui_reviewer")) {
     selected.add("workspace_scout");
   }
-  if (selected.has("writer")) selected.add("researcher");
+  if (selected.has("writer")) {
+    const grounded = selected.has("researcher") || selected.has("citation_checker") || selected.has("source_verifier");
+    if (grounded) {
+      selected.add("researcher");
+      selected.add("citation_checker");
+      selected.delete("consistency_checker");
+    } else {
+      selected.add("consistency_checker");
+    }
+  }
   if (selected.size === 0) {
     selected.add("workspace_scout");
     selected.add("evidence_reviewer");
@@ -221483,6 +221591,7 @@ var init_flockPlanner = __esm({
       { roleId: "researcher", pattern: /\b(research|sources?|find|look up|references?|citations?|academic|papers?|literature|background)\b/i },
       { roleId: "writer", pattern: /\b(write|draft|compose|essay|memo|report|article|document|copy)\b/i },
       { roleId: "citation_checker", pattern: /\b(citations?|verify|check sources?|fact.?check|references?)\b/i },
+      { roleId: "consistency_checker", pattern: /\b(fiction|stor(?:y|ies)|novel|chapters?|poems?|screenplay|scripts?|lyrics)\b/i },
       { roleId: "browser_operator", pattern: /\b(browser|open|navigate|click|fill|submit|login|webpage|url|site)\b/i }
     ];
     ROLE_TRIM_PRIORITY = [
@@ -221492,6 +221601,7 @@ var init_flockPlanner = __esm({
       "workspace_scout",
       "researcher",
       "citation_checker",
+      "consistency_checker",
       "evidence_reviewer",
       "source_verifier",
       "ui_reviewer",
@@ -221529,12 +221639,19 @@ function buildFlockPlannerPrompts(ctx) {
     `- At most ${writeCap} workers with writesWorkspace=true; each writer needs a disjoint, clearly scoped responsibility, and writeJustification is required for more than ${resolveFlockWriteWorkerCap({ permissionMode: null, planJustifiesMoreWriters: false })}.`,
     `- maxIterations: 1-${caps.maxIterationsPerWorker}.`,
     "- dependsOn: ids of earlier workers whose output this worker needs. No cycles. You decide the graph: parallel where independent, chained where not. Final verifier/reducer workers usually benefit from depending on the workers they check \u2014 guidance, not a requirement.",
-    "- baseWorkerId: set ONLY to reuse an id from existingWorkers; otherwise null.",
+    "- baseWorkerId: set ONLY to reuse an id from existingWorkers; otherwise null. Prefer reusing existingWorkers ids when a role matches instead of inventing a near-duplicate.",
+    "- Writing tasks: pair the draft with exactly ONE draft verifier \u2014 reuse flock_citation_checker (together with flock_researcher) when the piece makes factual or source-backed claims, or flock_consistency_checker for creative/fiction drafts (continuity, voice, pacing \u2014 no researcher, never demand citations from fiction).",
     "- Decline (accepted=false, with reason) tasks that are trivial, conversational, or need no fanout."
   ].join("\n");
-  const roster = listWorkerContracts().filter(
+  ensureFlockWorkersRegistered();
+  const archetypeIds = new Set(listFlockRoleSpecs().map((spec) => spec.workerId));
+  const surfacedContracts = listWorkerContracts().filter(
     (contract) => ctx.surface !== "cli" || !GUI_ONLY_WORKER_IDS.includes(contract.workerId)
-  ).slice(0, MAX_ROSTER_IN_PROMPT).map((contract) => ({ id: contract.workerId, name: contract.name }));
+  );
+  const roster = [
+    ...surfacedContracts.filter((contract) => archetypeIds.has(contract.workerId)),
+    ...surfacedContracts.filter((contract) => !archetypeIds.has(contract.workerId))
+  ].slice(0, MAX_ROSTER_IN_PROMPT).map((contract) => ({ id: contract.workerId, name: contract.name }));
   const userPrompt = JSON.stringify({
     task: ctx.task,
     surface: ctx.surface,
@@ -221706,6 +221823,32 @@ function validateLlmFlockPlan(record, ctx) {
       }
     }
   }
+  const writerWorker = surfacedWorkers.find(
+    (worker) => worker.workerId === FLOCK_ROLES.writer.workerId
+  );
+  if (writerWorker && !surfacedWorkers.some((worker) => worker.role === "verifier") && surfacedWorkers.length < FLOCK_MAX_WORKERS) {
+    const hasResearch = surfacedWorkers.some(
+      (worker) => worker.workerId === FLOCK_ROLES.researcher.workerId
+    );
+    const spec = hasResearch ? FLOCK_ROLES.citation_checker : FLOCK_ROLES.consistency_checker;
+    const index = surfacedWorkers.length;
+    surfacedWorkers.push({
+      flockWorkerId: `fw${index + 1}_${spec.roleId}`,
+      workerId: spec.workerId,
+      displayName: spec.displayName,
+      nickname: flockNicknameFor(ctx.flockId, index),
+      role: spec.role,
+      objective: spec.objectiveTemplate(ctx.task),
+      maxIterations: Math.min(spec.maxIterations, caps.maxIterationsPerWorker),
+      allowedTools: [...spec.allowedTools],
+      writesWorkspace: false,
+      writeScope: null,
+      outputContract: spec.outputContract,
+      dependsOn: [writerWorker.flockWorkerId],
+      modelOverride: null,
+      dynamicManifest: null
+    });
+  }
   surfacedWorkers.sort((a, b2) => FLOCK_ROLE_ORDER[a.role] - FLOCK_ROLE_ORDER[b2.role]);
   const summary = sanitizeLine(record.summary, 200) || `${surfacedWorkers.length} workers: ${surfacedWorkers.map((worker) => worker.displayName).join(", ")}`;
   return {
@@ -221774,6 +221917,7 @@ var init_flockLlmPlanner = __esm({
     init_flockLimits();
     init_flockNicknames();
     init_flockPlanner();
+    init_flockRoles();
     init_flockPlanner();
     FLOCK_FORBIDDEN_TOOLS = [
       ...WORKER_DISALLOWED_TOOLS,
@@ -221878,6 +222022,7 @@ async function runFlockTurn(input, deps, options = {}) {
       task: task.slice(0, 300),
       ts: now11()
     });
+    ensureFlockWorkersRegistered();
     let plan = null;
     if (options.plannerModelCall !== null) {
       const llmCtx = {
@@ -221917,7 +222062,6 @@ async function runFlockTurn(input, deps, options = {}) {
       });
       return await finishTurn(plan.reason);
     }
-    ensureFlockWorkersRegistered();
     for (const worker of plan.workers) {
       if (!worker.dynamicManifest) continue;
       registerWorkerManifest(worker.dynamicManifest);

package/package.json

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