@iowarp/clio-coder 0.3.8 → 0.4.0

package/dist/{chunk-KTYTFRMB.js → chunk-36EJLSQQ.js}

@@ -1,31 +1,33 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   DISPATCH_BRIEFING_MAX_BYTES,
-  TOOL_PROFILE_NAMES,
   classifyAgentTask,
+  classifyDispatchIntentCompatibility,
   cloneApprovedAssignmentRoute,
   cloneDispatchBudgetRequest,
+  dispatchIntentRefusals,
+  dispatchIntentScopeWidening,
   isApprovedAssignmentRoute,
   isDispatchIntent,
-  isToolProfileName,
   resolveDispatchPathScope
-} from "./chunk-A3WNZD3P.js";
+} from "./chunk-J4W7KFM7.js";
 import {
   ROUTE_POLICY_VERSION,
   isRouteDecisionAgentSelection,
   isRoutingIntent,
   parseRoutingIntent
-} from "./chunk-P43ETTHK.js";
+} from "./chunk-SJ5ZKQ4S.js";
+import {
+  TOOL_PROFILE_NAMES,
+  isToolProfileName
+} from "./chunk-42FMPA75.js";
 import {
   isExecutionRole,
   requestExecutionRole
 } from "./chunk-H7IXIC72.js";
-import {
-  pathBoundaryCovers
-} from "./chunk-TTHACPOM.js";
 import {
   AGENT_AUTOMATION_AUTHORITIES
-} from "./chunk-AOCYTWAV.js";
+} from "./chunk-DYJP44XW.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -163,10 +165,14 @@ function dispatchRequestFromArgs(args, options) {
     if (resolved.intent.writeRoots.length > 0) {
       const legacy = Array.isArray(args.writeRoots) ? args.writeRoots.filter((entry) => typeof entry === "string") : void 0;
       if (legacy !== void 0) {
-        const left = [...new Set(legacy)].sort();
-        if (JSON.stringify(left) !== JSON.stringify(resolved.intent.writeRoots)) {
-          return { ok: false, message: "intent_write_roots_contradiction" };
-        }
+        const refusal = dispatchIntentRefusals(
+          classifyDispatchIntentCompatibility({
+            intent: resolved.intent,
+            writeRoots: legacy,
+            ...cwd !== void 0 ? { cwd } : {}
+          })
+        ).find((entry) => entry.code === "intent_write_roots_contradiction");
+        if (refusal !== void 0) return { ok: false, message: refusal.message };
         request.writeRoots = legacy;
       } else {
         request.writeRoots = resolved.intent.writeRoots;
@@ -232,21 +238,9 @@ function dispatchRequestsFromArgs(args, options) {
       }
       const ceiling = options.resolveIntent(sharedIntent, parsed.request.cwd);
       if (!ceiling.ok) return { ok: false, message: `dispatch: task ${index + 1}: ${ceiling.message}` };
-      const pathCeilings = {
-        readRoots: [...ceiling.intent.readRoots, ...ceiling.intent.writeRoots],
-        writeRoots: ceiling.intent.writeRoots,
-        relevantPaths: [...ceiling.intent.readRoots, ...ceiling.intent.writeRoots, ...ceiling.intent.relevantPaths]
-      };
-      for (const field of ["readRoots", "writeRoots", "relevantPaths"]) {
-        const outside = parsed.request.intent?.[field].find(
-          (candidate) => !pathBoundaryCovers(pathCeilings[field], candidate)
-        );
-        if (outside !== void 0) {
-          return {
-            ok: false,
-            message: `dispatch: task ${index + 1}: intent_scope_widening: ${field} entry '${outside}' is outside the top-level intent ceiling`
-          };
-        }
+      const widening = parsed.request.intent === void 0 ? null : dispatchIntentScopeWidening(ceiling.intent, parsed.request.intent);
+      if (widening !== null) {
+        return { ok: false, message: `dispatch: task ${index + 1}: ${widening.message}` };
       }
     }
     requests.push(parsed.request);
@@ -329,14 +323,18 @@ function isRecord2(value) {
 function str(value) {
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 }
-function safeField(value) {
+function safeField(value, bindChangedValue = true) {
   let result = "";
   for (const character of value) {
     const code = character.codePointAt(0) ?? 0;
     result += code < 32 || code >= 127 && code <= 159 ? "?" : character;
-    if (result.length >= 256) return `${result.slice(0, 255)}\u2026`;
+    if (result.length >= 256) {
+      result = `${result.slice(0, 255)}\u2026`;
+      break;
+    }
   }
-  return result;
+  if (!bindChangedValue || result === value) return result;
+  return `${result}{sha256=${createHash("sha256").update(value, "utf8").digest("hex")}}`;
 }
 function renderLegacyPathScope(task) {
   if (task.intent !== void 0) return [];
@@ -459,7 +457,7 @@ function renderPlanText(topology, tasks, costCeilingUsd, deadlineMs, source, max
     const routing = task.routingIntent;
     const routingText = routing === void 0 ? "" : ` posture=${routing.posture} maxCostUsd=${routing.maxCostUsd ?? "none"} deadlineMs=${routing.deadlineMs ?? "none"} minimumQuality=${routing.minimumQuality ?? "none"} locality=${routing.locality}`;
     lines.push(
-      `  ${index + 1}.${role} agent=${safeField(task.agent)}${target}${model}${node}${failover}${routingText} task=${JSON.stringify(safeField(task.task))}`
+      `  ${index + 1}.${role} agent=${safeField(task.agent)}${target}${model}${node}${failover}${routingText} task_bytes=${Buffer.byteLength(task.task, "utf8")} task_sha256=${createHash("sha256").update(task.task, "utf8").digest("hex")} task_preview=${JSON.stringify(safeField(task.task, false))}`
     );
     if (task.council !== void 0) {
       lines.push(
@@ -486,22 +484,22 @@ function renderPlanText(topology, tasks, costCeilingUsd, deadlineMs, source, max
     }
     if (task.agentSelection !== null) {
       lines.push(
-        `    agent-selection=auto baseline=${safeField(task.agentSelection.baselineAgentId)} authority=${task.agentSelection.approvedAuthorities.map(safeField).join(",")} basis=${task.agentSelection.authorityBasis}`
+        `    agent-selection=auto baseline=${safeField(task.agentSelection.baselineAgentId)} authority=${task.agentSelection.approvedAuthorities.map((authority) => safeField(authority)).join(",")} basis=${task.agentSelection.authorityBasis}`
       );
     }
     if (task.stepId !== null) {
       lines.push(
-        `    step=${safeField(task.stepId)} wave=${task.wave ?? "?"} role=${task.executionRole} dependencies=${task.dependencies.map(safeField).join(",") || "none"} result=${task.expectedResultContract ?? "none"} authority=${task.authorityGrant?.requested ?? "none"} basis=${task.authorityGrant?.basis ?? "none"}`
+        `    step=${safeField(task.stepId)} wave=${task.wave ?? "?"} role=${task.executionRole} dependencies=${task.dependencies.map((dependency) => safeField(dependency)).join(",") || "none"} result=${task.expectedResultContract ?? "none"} authority=${task.authorityGrant?.requested ?? "none"} basis=${task.authorityGrant?.basis ?? "none"}`
       );
       const agentReasons = task.agentDecision?.agentSelection.evaluations.filter((evaluation) => evaluation.rejections.length > 0).slice(0, 8).map(
-        (evaluation) => `${safeField(evaluation.agentId)}:${evaluation.rejections.slice(0, 4).map(safeField).join(",")}`
+        (evaluation) => `${safeField(evaluation.agentId)}:${evaluation.rejections.slice(0, 4).map((rejection) => safeField(rejection)).join(",")}`
       );
       if (agentReasons !== void 0 && agentReasons.length > 0)
         lines.push(`    agent-exclusions=${agentReasons.join(";")}`);
     }
     if (task.briefing !== void 0) {
       lines.push(
-        `    briefing_bytes=${Buffer.byteLength(task.briefing, "utf8")} briefing_sha256=${createHash("sha256").update(task.briefing, "utf8").digest("hex")} briefing_preview=${JSON.stringify(safeField(task.briefing))}`
+        `    briefing_bytes=${Buffer.byteLength(task.briefing, "utf8")} briefing_sha256=${createHash("sha256").update(task.briefing, "utf8").digest("hex")} briefing_preview=${JSON.stringify(safeField(task.briefing, false))}`
       );
     }
     if (task.intent !== void 0) {
@@ -813,4 +811,4 @@ export {
   withResolvedDispatchPlan,
   describeDispatchPlan
 };
-//# sourceMappingURL=chunk-KTYTFRMB.js.map
+//# sourceMappingURL=chunk-36EJLSQQ.js.map

package/dist/{chunk-FHJEP5SW.js → chunk-3BT2XMV4.js}

@@ -1,29 +1,29 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  assertAgentIdNamespace
-} from "./chunk-DR52UMZW.js";
 import {
   readStrictLayeredSettings,
   updateLayeredSettings
-} from "./chunk-26LEYJZH.js";
+} from "./chunk-7MCTRUCE.js";
 import {
   resolveShutdownHookBudgetMs,
   runWithBudget,
   writeShutdownNotice
-} from "./chunk-WXY7KU3G.js";
+} from "./chunk-LDQ2ZF2M.js";
 import {
-  setGitCommitAttributionEnabled
-} from "./chunk-B5CSFE7B.js";
-import {
-  formatSettingsFailure,
-  settingsPath
-} from "./chunk-IJ7RPIYJ.js";
+  assertAgentIdNamespace
+} from "./chunk-DR52UMZW.js";
 import {
   getSharedBus
 } from "./chunk-ZGVHUX3M.js";
 import {
   BusChannels
-} from "./chunk-TT36MB5S.js";
+} from "./chunk-HLW2MRKE.js";
+import {
+  formatSettingsFailure,
+  settingsPath
+} from "./chunk-VFA6GDY5.js";
+import {
+  setGitCommitAttributionEnabled
+} from "./chunk-BBVJUZHB.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -150,6 +150,9 @@ var HOT_RELOAD_FIELDS = /* @__PURE__ */ new Set([
   "modelSelector",
   "terminal.smoothStreaming",
   "attribution.gitCommits",
+  // The bridge reads these on every explicit open; no mux re-detection is
+  // needed because the host capability rung remains `panes.enabled`.
+  "panes.yazi",
   // The watchdog registration reads its settings live on every trigger, so
   // enabling it, retargeting it, or changing its cadence takes effect on the
   // next turn boundary without a restart or a session-routing patch.
@@ -182,6 +185,9 @@ var NEXT_TURN_FIELDS = /* @__PURE__ */ new Set([
   "delegation",
   "compaction",
   "context",
+  // The pre-warm reads its setting when a trigger fires, and every trigger sits
+  // on a turn boundary, so a change takes effect before the next turn runs.
+  "prewarm",
   "retry"
 ]);
 var RESTART_REQUIRED_FIELDS = /* @__PURE__ */ new Set([
@@ -378,4 +384,4 @@ export {
   ConfigDomainModule,
   createConfigDomainModule
 };
-//# sourceMappingURL=chunk-FHJEP5SW.js.map
+//# sourceMappingURL=chunk-3BT2XMV4.js.map

package/dist/chunk-3DPEIQKN.js

@@ -0,0 +1,113 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  init_esm_shims
+} from "./chunk-3R73A4XB.js";
+
+// src/domains/session/prompt-cache.ts
+init_esm_shims();
+
+// src/core/cache-telemetry.ts
+init_esm_shims();
+function emptyCacheVerdictCounts() {
+  return { hot: 0, partial: 0, cold: 0, small: 0 };
+}
+function uncachedPrefillTokens(backend) {
+  if (backend === null || backend === void 0 || backend.cachedTokens === null) return null;
+  if (!Number.isFinite(backend.promptTokens) || backend.promptTokens < 0 || !Number.isFinite(backend.cachedTokens) || backend.cachedTokens < 0 || backend.cachedTokens > backend.promptTokens) {
+    return null;
+  }
+  return backend.promptTokens - backend.cachedTokens;
+}
+
+// src/domains/session/prompt-cache.ts
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function finiteNonNegative(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function backendTimings(value) {
+  if (!isRecord(value)) return null;
+  if (!finiteNonNegative(value.promptTokens) || !finiteNonNegative(value.predictedTokens) || !finiteNonNegative(value.promptMs) || !finiteNonNegative(value.predictedMs) || value.source !== "llamacpp-timings" && value.source !== "lmstudio-timings") {
+    return null;
+  }
+  const cachedTokens = value.cachedTokens;
+  if (cachedTokens !== null && !finiteNonNegative(cachedTokens)) return null;
+  if (typeof cachedTokens === "number" && cachedTokens > value.promptTokens) return null;
+  return {
+    promptTokens: value.promptTokens,
+    cachedTokens,
+    predictedTokens: value.predictedTokens,
+    promptMs: value.promptMs,
+    predictedMs: value.predictedMs,
+    source: value.source
+  };
+}
+function cacheVerdict(value) {
+  switch (value) {
+    case "hot":
+    case "partial":
+    case "cold":
+    case "small":
+      return value;
+    default:
+      return null;
+  }
+}
+function hasPromptCacheTelemetry(telemetry) {
+  return telemetry.verdictCalls > 0 || telemetry.uncachedPrefillCalls > 0 || Object.keys(telemetry.expectedColdReasonCounts).length > 0;
+}
+function topExpectedColdReason(telemetry) {
+  const ranked = Object.entries(telemetry.expectedColdReasonCounts).sort(
+    ([leftReason, leftCount], [rightReason, rightCount]) => rightCount - leftCount || leftReason.localeCompare(rightReason)
+  );
+  const first = ranked[0];
+  return first === void 0 ? null : { reason: first[0], count: first[1] };
+}
+function foldPromptCacheTelemetry(entries) {
+  const verdictCounts = emptyCacheVerdictCounts();
+  const expectedColdReasonCounts = {};
+  let verdictCalls = 0;
+  let uncachedTotal = 0;
+  let uncachedPrefillCalls = 0;
+  for (const entry of entries) {
+    if (entry.kind !== "message" || entry.role !== "assistant" || !isRecord(entry.payload)) continue;
+    const promptCache = entry.payload.promptCache;
+    if (!isRecord(promptCache)) continue;
+    const verdict = cacheVerdict(promptCache.backendVerdict);
+    if (verdict !== null) {
+      verdictCounts[verdict] += 1;
+      verdictCalls += 1;
+    }
+    const backend = backendTimings(promptCache.backend);
+    const uncached = uncachedPrefillTokens(backend);
+    if (uncached !== null) {
+      uncachedTotal += uncached;
+      uncachedPrefillCalls += 1;
+    }
+    if (!Array.isArray(promptCache.expectedColdReasons)) continue;
+    const reasons = new Set(
+      promptCache.expectedColdReasons.filter(
+        (reason) => typeof reason === "string" && reason.trim().length > 0
+      )
+    );
+    for (const reason of reasons) {
+      expectedColdReasonCounts[reason] = (expectedColdReasonCounts[reason] ?? 0) + 1;
+    }
+  }
+  return {
+    uncachedPrefillTokens: uncachedPrefillCalls > 0 ? uncachedTotal : null,
+    uncachedPrefillCalls,
+    verdictCounts,
+    verdictCalls,
+    expectedColdReasonCounts
+  };
+}
+
+export {
+  uncachedPrefillTokens,
+  hasPromptCacheTelemetry,
+  topExpectedColdReason,
+  foldPromptCacheTelemetry
+};
+//# sourceMappingURL=chunk-3DPEIQKN.js.map

package/dist/{chunk-GU2UIAFZ.js → chunk-3URVFKWK.js}

@@ -4,31 +4,31 @@ import {
   listChecks,
   runProjectCheck,
   runScriptCheck
-} from "./chunk-VAWNZU7Z.js";
+} from "./chunk-YDFRH54B.js";
 import {
   BROWSER_MODES,
   maxOutputArg,
   prepareVerifyArguments,
   timeoutArg,
   verifyToolSurface
-} from "./chunk-PMDBGQSJ.js";
+} from "./chunk-HWHKMHUA.js";
 import {
   escapeRegExp
 } from "./chunk-VG7TBQIY.js";
 import {
   resolveReadPath
 } from "./chunk-OQE5J4C6.js";
+import {
+  truncateUtf8
+} from "./chunk-6XLNIQDB.js";
 import {
   VERIFICATION_SCRIPT_FAMILY_HINT,
   isVerificationScriptName
 } from "./chunk-UL3WSD3F.js";
-import {
-  truncateUtf8
-} from "./chunk-6XLNIQDB.js";
 import {
   combineSafeOutput,
   runCommandVector
-} from "./chunk-B5CSFE7B.js";
+} from "./chunk-BBVJUZHB.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -633,4 +633,4 @@ var verifyTool = {
 export {
   verifyTool
 };
-//# sourceMappingURL=chunk-GU2UIAFZ.js.map
+//# sourceMappingURL=chunk-3URVFKWK.js.map

package/dist/{chunk-WEH5XRJQ.js → chunk-3XML7CDN.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-5B2AEOW5.js";
 import {
   ToolNames
-} from "./chunk-CGKSTWHD.js";
+} from "./chunk-K6BSR66V.js";
 import {
   StringEnum
-} from "./chunk-FCSXB6T2.js";
+} from "./chunk-UOSL25KY.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -29,4 +29,4 @@ var steerToolSurface = {
 export {
   steerToolSurface
 };
-//# sourceMappingURL=chunk-WEH5XRJQ.js.map
+//# sourceMappingURL=chunk-3XML7CDN.js.map

package/dist/chunk-42FMPA75.js

@@ -0,0 +1,101 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  ToolNames,
+  isBuiltinToolName
+} from "./chunk-K6BSR66V.js";
+import {
+  init_esm_shims
+} from "./chunk-3R73A4XB.js";
+
+// src/tools/profiles.ts
+init_esm_shims();
+var TOOL_PROFILE_NAMES = [
+  "minimal-local",
+  "science-local",
+  "full-agent"
+];
+var ALL_TOOL_PROFILE_NAMES = [...TOOL_PROFILE_NAMES, "council-read-only"];
+var CODEWIKI_TOOL_NAMES = [ToolNames.CodeNav];
+var MINIMAL_LOCAL_TOOLS = [
+  ToolNames.Read,
+  ToolNames.Grep,
+  ToolNames.Find,
+  ToolNames.Ls,
+  ToolNames.Git,
+  ToolNames.Context,
+  ToolNames.CodeNav,
+  // A narrowed read-only scout swarm is the surface that most needs to see
+  // what its peers already staked.
+  ToolNames.Ledger
+];
+var SCIENCE_LOCAL_TOOLS = [...MINIMAL_LOCAL_TOOLS, ToolNames.Verify];
+var COUNCIL_READ_ONLY_TOOLS = [
+  ToolNames.Read,
+  ToolNames.Grep,
+  ToolNames.Find,
+  ToolNames.Ls,
+  ToolNames.CodeNav,
+  ToolNames.Context
+];
+var NARROW_TOOL_PROFILES = {
+  "minimal-local": new Set(MINIMAL_LOCAL_TOOLS),
+  "science-local": new Set(SCIENCE_LOCAL_TOOLS),
+  "council-read-only": new Set(COUNCIL_READ_ONLY_TOOLS)
+};
+function isToolProfileName(value) {
+  return ALL_TOOL_PROFILE_NAMES.includes(value);
+}
+function narrowsToolSurface(profile) {
+  return profile !== void 0 && profile in NARROW_TOOL_PROFILES;
+}
+function assertToolProfileEnforceable(profile, runtimeLabel) {
+  if (narrowsToolSurface(profile)) {
+    throw new Error(
+      `${runtimeLabel} runtime cannot enforce tool_profile '${profile}': it runs its own tool surface without Clio per-tool mediation. Dispatch to a native or claude-sdk worker, or use tool_profile full-agent.`
+    );
+  }
+}
+function applyToolProfile(tools, profile, context) {
+  const unique = uniquePreservingOrder(tools);
+  let profiled;
+  if (profile === void 0 || profile === "full-agent") {
+    profiled = unique;
+  } else {
+    const allowed = NARROW_TOOL_PROFILES[profile];
+    profiled = unique.filter((tool) => isBuiltinToolName(tool) && allowed.has(tool));
+  }
+  return profile === "council-read-only" ? profiled : applyCodewikiWorkerPolicy(profiled, context);
+}
+function uniquePreservingOrder(tools) {
+  const seen = /* @__PURE__ */ new Set();
+  const unique = [];
+  for (const tool of tools) {
+    if (seen.has(tool)) continue;
+    seen.add(tool);
+    unique.push(tool);
+  }
+  return unique;
+}
+function isCodewikiTool(tool) {
+  return CODEWIKI_TOOL_NAMES.includes(tool);
+}
+function isNavigationHeavyTask(task) {
+  if (!task) return false;
+  return /\b(?:codewiki|symbol|symbols|entry\s*points?|where\s+is|code_nav|call\s*sites?|references?|imports?|exports?|map|mapping|navigate|navigation|topology|architecture|boundar(?:y|ies)|ownership|trace|locate|find\s+(?:the\s+)?(?:implementation|definition|module|file|path))\b|(?:^|\s)(?:src|tests?|cmd|pkg|lib)\/|\.(?:[cm]?[tj]sx?|py|pyw|go|rs|c|h|cc|cpp|cxx|hpp|hh|hxx|java|rb)\b/i.test(
+    task
+  );
+}
+function applyCodewikiWorkerPolicy(tools, context) {
+  if (!context?.agentId) return tools;
+  if (context.agentId === "scout") return tools;
+  if (isNavigationHeavyTask(context.task)) return tools;
+  return tools.filter((tool) => !isCodewikiTool(tool));
+}
+
+export {
+  TOOL_PROFILE_NAMES,
+  isToolProfileName,
+  assertToolProfileEnforceable,
+  applyToolProfile
+};
+//# sourceMappingURL=chunk-42FMPA75.js.map

package/dist/{chunk-A2NJGIB3.js → chunk-5LXZXPKX.js}

@@ -5,7 +5,7 @@ import {
 import {
   SAFE_EXEC_DEFAULT_TIMEOUT_MS,
   resolveSafeCwd
-} from "./chunk-B5CSFE7B.js";
+} from "./chunk-BBVJUZHB.js";
 import {
   require_dist
 } from "./chunk-APJ265NV.js";
@@ -310,4 +310,4 @@ export {
   parseProjectVerifierCatalogText,
   packageDeclaredCheck
 };
-//# sourceMappingURL=chunk-A2NJGIB3.js.map
+//# sourceMappingURL=chunk-5LXZXPKX.js.map

package/dist/{chunk-VCBR6CU7.js → chunk-5PSMVOLM.js}

@@ -3,7 +3,7 @@ import {
   asDirectoryPathBoundary,
   pathBoundaryEntryCovers,
   resolvePathBoundary
-} from "./chunk-TTHACPOM.js";
+} from "./chunk-HHV2GANA.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -53,4 +53,4 @@ export {
   WORKSPACE_SCOPE,
   CONFIRMED_SCOPE
 };
-//# sourceMappingURL=chunk-VCBR6CU7.js.map
+//# sourceMappingURL=chunk-5PSMVOLM.js.map