stitchkit 0.115.0 → 0.116.0

package/CHANGELOG.md

@@ -15,6 +15,31 @@ additive**; the first breaking change landed in 0.10.0. Grep the file for
 
 ## [Unreleased]
 
+## [0.116.0] - 2026-11-02
+
+### ⚠️ Breaking changes
+
+**Who must act:** code that relied on a 429 from an edit or a read to stop a token's sends. See the [migration](docs/guide/upgrading.md).
+
+- `stitchkit/telegram` — **a 429 pauses the token only on a method that spends the budget.** A limit on editing one message said nothing about sending the next one, and one progress card stopped a whole campaign. An edit or a read that sees a 429 returns it unchanged and pauses nothing. `// before: budget.run('editMessageText', …) paused the token` → `// after: call budget.pauseAfter(error) where you want that` → [ADR 0277](docs/decisions/0277-a-telegram-budget-serves-replies-first.md)
+  **Affects:** `stitchkit/telegram` TelegramOutboundBudget(run)
+
+### Added
+
+- `stitchkit/telegram` — the outbound budget has `interactive` and `bulk` lanes over one rate: `run(…, { lane })`, `acquire(cost, signal, { lane })`, and `stats().queuedBulk`. A waiting interactive call is granted first, so a reply does not queue behind a campaign.
+  **Affects:** `stitchkit/telegram` TelegramOutboundBudget, TelegramOutboundLane
+
+- `stitchkit/telegram/grammy` — `telegramBudgetTransformer(budget, { lane })` runs a client's calls in one lane.
+  **Affects:** `stitchkit/telegram/grammy` telegramBudgetTransformer
+
+### Fixed
+
+- `stitchkit/agent-runtime/coding-tools` — a path spelled differently from the name stored on disk refuses before any policy reads it, so a rule on `credentials` cannot be passed by asking for `CREDENTIALS` on a case-insensitive volume.
+  **Affects:** `stitchkit/agent-runtime/coding-tools` createAgentCodingTools
+
+- `stitchkit/cli` — grouped views print largest first even when a key looks like a number, and a string equal to `null` or `(absent)` is quoted instead of merging with the missing value. `renderCliView` returns the order as `order`.
+  **Affects:** `stitchkit/cli` createCli, renderCliView
+
 ## [0.115.0] - 2026-11-02
 
 ### ⚠️ Breaking changes

package/dist/agent-runtime/coding-tool-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coding-tool-paths.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/coding-tool-paths.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,4BAA4B,EAEjC,KAAK,qBAAqB,EAE3B,MAAM,wBAAwB,CAAC;AAwChC,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CA6CR;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM;;;GAKrB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM;;;GAarB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM;;;GAQrB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAMf;AAID,2FAA2F;AAC3F,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,CAAC,CAeZ;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUtE"}
+{"version":3,"file":"coding-tool-paths.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/coding-tool-paths.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,4BAA4B,EAEjC,KAAK,qBAAqB,EAE3B,MAAM,wBAAwB,CAAC;AAwChC,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CA6CR;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM;;;GAKrB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM;;;GAarB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM;;;GAQrB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAoBf;AAID,2FAA2F;AAC3F,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,CAAC,CAeZ;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUtE"}

package/dist/entrypoints/agent-runtime/coding-tools.js

@@ -6,13 +6,13 @@ import {
   AgentCodingToolAuthorizationSchema2,
   AgentCodingToolPathAuthorizationSchema2,
   createAgentCodingTools2
-} from "../../index-7yx8j6ay.js";
+} from "../../index-n5sv4z0w.js";
 import"../../index-2kbysk9s.js";
 import"../../index-f6m4c545.js";
 import"../../index-dr3t5n1v.js";
-import"../../index-nregbbsc.js";
-import"../../index-j8kf56wx.js";
-import"../../index-x0ddbj85.js";
+import"../../index-6f49krb5.js";
+import"../../index-q968hy6y.js";
+import"../../index-arjmb6de.js";
 import"../../index-ega3yz4c.js";
 export {
   AgentCodingToolAuthorizationSchema2 as AgentCodingToolAuthorizationSchema,

package/dist/entrypoints/agent-runtime/harness.js

@@ -26,8 +26,8 @@ import {
 import"../../index-4qnzda76.js";
 import {
   walkContainedFiles
-} from "../../index-nregbbsc.js";
-import"../../index-x0ddbj85.js";
+} from "../../index-6f49krb5.js";
+import"../../index-arjmb6de.js";
 import {
   defineRuntimeTool2
 } from "../../index-ega3yz4c.js";

package/dist/entrypoints/agent-runtime/sandbox.js

@@ -3,7 +3,7 @@ import {
   missingSandboxRestrictions2,
   codingRefusal,
   createAgentCodingTools2
-} from "../../index-7yx8j6ay.js";
+} from "../../index-n5sv4z0w.js";
 import"../../index-2kbysk9s.js";
 import"../../index-ct75c3at.js";
 import"../../index-rhzkndr5.js";
@@ -18,9 +18,9 @@ import {
   terminateOwnedGroup,
   startNativeCommand
 } from "../../index-dr3t5n1v.js";
-import"../../index-nregbbsc.js";
-import"../../index-j8kf56wx.js";
-import"../../index-x0ddbj85.js";
+import"../../index-6f49krb5.js";
+import"../../index-q968hy6y.js";
+import"../../index-arjmb6de.js";
 import"../../index-ega3yz4c.js";
 import {
   errnoOf

package/dist/entrypoints/agent-runtime/sqlite/bun.js

@@ -1,13 +1,13 @@
 import"../../../index-fggxgbrk.js";
-import"../../../index-944x38nv.js";
+import"../../../index-jq2ky8fw.js";
 import"../../../index-8kzct1d6.js";
 import {
   initializeAgentRuntimeSqlite2,
   createSqliteAgentRuntimeStore2
-} from "../../../index-crmswbrt.js";
+} from "../../../index-fa435yq2.js";
 import"../../../index-kqnd6a85.js";
 import"../../../index-5w6t91ze.js";
-import"../../../index-7yx8j6ay.js";
+import"../../../index-n5sv4z0w.js";
 import"../../../index-ct75c3at.js";
 import"../../../index-rhzkndr5.js";
 import"../../../index-k42ckyzx.js";
@@ -15,9 +15,9 @@ import"../../../index-2kbysk9s.js";
 import"../../../index-f6m4c545.js";
 import"../../../index-dr3t5n1v.js";
 import"../../../index-snef22zr.js";
-import"../../../index-nregbbsc.js";
-import"../../../index-j8kf56wx.js";
-import"../../../index-x0ddbj85.js";
+import"../../../index-6f49krb5.js";
+import"../../../index-q968hy6y.js";
+import"../../../index-arjmb6de.js";
 import"../../../index-ega3yz4c.js";
 
 // src/agent-runtime/sqlite-bun.ts

package/dist/entrypoints/agent-runtime/sqlite/node.js

@@ -1,13 +1,13 @@
 import"../../../index-fggxgbrk.js";
-import"../../../index-944x38nv.js";
+import"../../../index-jq2ky8fw.js";
 import"../../../index-8kzct1d6.js";
 import {
   initializeAgentRuntimeSqlite2,
   createSqliteAgentRuntimeStore2
-} from "../../../index-crmswbrt.js";
+} from "../../../index-fa435yq2.js";
 import"../../../index-kqnd6a85.js";
 import"../../../index-5w6t91ze.js";
-import"../../../index-7yx8j6ay.js";
+import"../../../index-n5sv4z0w.js";
 import"../../../index-ct75c3at.js";
 import"../../../index-rhzkndr5.js";
 import"../../../index-k42ckyzx.js";
@@ -15,9 +15,9 @@ import"../../../index-2kbysk9s.js";
 import"../../../index-f6m4c545.js";
 import"../../../index-dr3t5n1v.js";
 import"../../../index-snef22zr.js";
-import"../../../index-nregbbsc.js";
-import"../../../index-j8kf56wx.js";
-import"../../../index-x0ddbj85.js";
+import"../../../index-6f49krb5.js";
+import"../../../index-q968hy6y.js";
+import"../../../index-arjmb6de.js";
 import"../../../index-ega3yz4c.js";
 
 // src/agent-runtime/sqlite-node.ts

package/dist/entrypoints/agent-runtime/testing.js

@@ -10,8 +10,8 @@ import {
   advanceToolChronology
 } from "../../index-fggxgbrk.js";
 import"../../index-5w6t91ze.js";
-import"../../index-7yx8j6ay.js";
-import"../../index-944x38nv.js";
+import"../../index-n5sv4z0w.js";
+import"../../index-jq2ky8fw.js";
 import"../../index-ct75c3at.js";
 import"../../index-rhzkndr5.js";
 import"../../index-k42ckyzx.js";
@@ -21,10 +21,10 @@ import"../../index-dr3t5n1v.js";
 import"../../index-snef22zr.js";
 import {
   createMemoryAgentRuntimeStore2
-} from "../../index-dx5cm9pc.js";
-import"../../index-nregbbsc.js";
-import"../../index-j8kf56wx.js";
-import"../../index-x0ddbj85.js";
+} from "../../index-4g6qmgdx.js";
+import"../../index-6f49krb5.js";
+import"../../index-q968hy6y.js";
+import"../../index-arjmb6de.js";
 import"../../index-ega3yz4c.js";
 import {
   assertPositiveSafeInteger

package/dist/entrypoints/agent-runtime.js

@@ -5,7 +5,7 @@ import {
   missingSandboxRestrictions2,
   recordAgentSandboxProbe2,
   refuseUnknownSpillReference
-} from "../index-7yx8j6ay.js";
+} from "../index-n5sv4z0w.js";
 import {
   AgentRecordIdSchema2,
   AgentRecordVersionSchema2,
@@ -58,7 +58,7 @@ import {
   AgentHistoryMutationSchema2,
   ACTIVE_AGENT_RUN_STATES2,
   createAgentRuntimeStore2
-} from "../index-944x38nv.js";
+} from "../index-jq2ky8fw.js";
 import {
   AgentStoreEventKindSchema2,
   AgentStoreEventEnvelopeSchema2,
@@ -191,13 +191,13 @@ import"../index-f6m4c545.js";
 import"../index-dr3t5n1v.js";
 import {
   createMemoryAgentRuntimeStore2
-} from "../index-dx5cm9pc.js";
+} from "../index-4g6qmgdx.js";
 import {
   createAgentRuntimeEventSink2
 } from "../index-4qnzda76.js";
-import"../index-nregbbsc.js";
-import"../index-j8kf56wx.js";
-import"../index-x0ddbj85.js";
+import"../index-6f49krb5.js";
+import"../index-q968hy6y.js";
+import"../index-arjmb6de.js";
 import"../index-86nbfysb.js";
 import {
   defineRuntimeTool2,

package/dist/entrypoints/cli.js

@@ -16,7 +16,7 @@ import {
   renderCliView2,
   pollUntilDone2,
   createCli2
-} from "../index-3qqdqwxe.js";
+} from "../index-w7jq3fz9.js";
 import"../index-k42ckyzx.js";
 import"../index-ct75c3at.js";
 import"../index-rhzkndr5.js";
@@ -42,8 +42,8 @@ import {
   applyCliUpdate2,
   rollbackCliUpdate2
 } from "../index-90p34rts.js";
-import"../index-j8kf56wx.js";
-import"../index-x0ddbj85.js";
+import"../index-q968hy6y.js";
+import"../index-arjmb6de.js";
 import"../index-86nbfysb.js";
 import"../index-ega3yz4c.js";
 import {

package/dist/entrypoints/telegram/grammy.js

@@ -26,7 +26,7 @@ function platformSignal(signal) {
     release: () => signal.removeEventListener("abort", abort)
   };
 }
-function telegramBudgetTransformer(budget) {
+function telegramBudgetTransformer(budget, options) {
   return async (previous, method, payload, signal) => {
     const gate = platformSignal(signal);
     let handedOn = false;
@@ -34,7 +34,7 @@ function telegramBudgetTransformer(budget) {
       return await budget.run(method, payload, gate.signal, () => {
         handedOn = true;
         return previous(method, payload, signal);
-      });
+      }, options);
     } catch (error) {
       if (!handedOn && gate.signal?.aborted && error === gate.signal.reason) {
         throw new TelegramNotDispatchedError2("request", "the Telegram request was cancelled before it was sent", { cause: error });

package/dist/entrypoints/telegram.d.ts

@@ -6,7 +6,7 @@ export { createTelegramLocalFiles, TelegramLocalFileError, type TelegramLocalFil
 export { TelegramNotDispatchedError, type TelegramNotDispatchedStage, } from '../telegram/not-dispatched.js';
 export { createTelegramOperatorChannel, type TelegramChatId, type TelegramOperatorChannel, type TelegramOperatorChannelConfig, type TelegramOperatorDrop, type TelegramOperatorMessage, type TelegramOperatorSenderConfig, telegramOperatorSender, } from '../telegram/operator-channel.js';
 export { createTelegramOperatorDedupe, type TelegramOperatorDedupe, type TelegramOperatorDedupeVerdict, } from '../telegram/operator-dedupe.js';
-export { type TelegramOutboundBudget, type TelegramOutboundBudgetConfig, type TelegramOutboundBudgetStats, telegramOutboundBudget, } from '../telegram/outbound-budget.js';
+export { type TelegramOutboundBudget, type TelegramOutboundBudgetConfig, type TelegramOutboundBudgetStats, type TelegramOutboundCallOptions, type TelegramOutboundLane, telegramOutboundBudget, } from '../telegram/outbound-budget.js';
 export { classifyTelegramSendFailure, TELEGRAM_SEND_FAILURE_REASONS, type TelegramSendFailure, type TelegramSendFailureReason, } from '../telegram/send-failure.js';
 export { createTelegramBotTransport, type TelegramBotTransportOpen, type TelegramBotTransportOptions, type TelegramBotTransportResolve, type TelegramBotTransportSocket, type TelegramFetch, } from '../telegram/transport.js';
 export { createTelegramUpdateIntake, type TelegramUpdateAttemptContext, type TelegramUpdateAttemptIntakeConfig, type TelegramUpdateEnvelope, type TelegramUpdateExhaustion, type TelegramUpdateExhaustionFailure, type TelegramUpdateFailure, type TelegramUpdateIntake, type TelegramUpdateIntakeConfig, type TelegramUpdateIntakeOptions, TelegramUpdateOwnershipLostError, type TelegramUpdateStoreStep, } from '../telegram/update-intake.js';

package/dist/entrypoints/telegram.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/entrypoints/telegram.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/entrypoints/telegram.ts"],"names":[],"mappings":"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"}

package/dist/entrypoints/telegram.js

@@ -983,12 +983,14 @@ function createBudget(rate, fallback, now, sleepFor) {
     wake = undefined;
     current?.abort();
   };
+  const nextWaiter = () => queue.find((waiter) => waiter.lane === "interactive") ?? queue[0];
   const remove = (waiter) => {
     const index = queue.indexOf(waiter);
     if (index === -1)
       return;
+    const next = nextWaiter() === waiter;
     queue.splice(index, 1);
-    if (index === 0)
+    if (next)
       wakeWaiting();
   };
   const drain = async () => {
@@ -997,7 +999,7 @@ function createBudget(rate, fallback, now, sleepFor) {
     draining = true;
     try {
       while (queue.length > 0) {
-        const head = queue[0];
+        const head = nextWaiter();
         if (head === undefined)
           break;
         if (head.signal?.aborted) {
@@ -1026,7 +1028,7 @@ function createBudget(rate, fallback, now, sleepFor) {
           }
           continue;
         }
-        queue.shift();
+        queue.splice(queue.indexOf(head), 1);
         if (head.onAbort)
           head.signal?.removeEventListener("abort", head.onAbort);
         nextGrantAt = at + head.cost * interval;
@@ -1040,14 +1042,20 @@ function createBudget(rate, fallback, now, sleepFor) {
         drain();
     }
   };
-  const acquire = (cost, signal) => {
+  const acquire = (cost, signal, options) => {
     if (!Number.isSafeInteger(cost) || cost < 1) {
       return Promise.reject(new RangeError("cost must be an integer of at least one message"));
     }
     if (signal?.aborted)
       return Promise.reject(signal.reason);
     return new Promise((resolve, reject) => {
-      const waiter = { cost, resolve, reject, ...signal && { signal } };
+      const waiter = {
+        cost,
+        lane: options?.lane ?? "interactive",
+        resolve,
+        reject,
+        ...signal && { signal }
+      };
       if (signal) {
         const onAbort = () => {
           remove(waiter);
@@ -1084,23 +1092,27 @@ function createBudget(rate, fallback, now, sleepFor) {
       await wait(Math.min(remaining, MAX_TIMER_MS), signal);
     }
   };
-  const run = async (method, payload, signal, send) => {
+  const run = async (method, payload, signal, send, options) => {
     if (signal?.aborted)
       throw signal.reason;
     const cost = sendCost(method, payload);
     if (cost > 0)
-      await acquire(cost, signal);
+      await acquire(cost, signal, options);
     if (signal?.aborted)
       throw signal.reason;
+    const pauseOnRefusal = (refusal) => {
+      if (cost > 0)
+        pauseAfter(refusal);
+    };
     let result;
     try {
       result = await send();
     } catch (error) {
-      pauseAfter(error);
+      pauseOnRefusal(error);
       throw error;
     }
     if (isRecord(result) && result.ok === false)
-      pauseAfter(result);
+      pauseOnRefusal(result);
     return result;
   };
   const budget = {
@@ -1113,6 +1125,7 @@ function createBudget(rate, fallback, now, sleepFor) {
       granted,
       messages,
       queued: queue.length,
+      queuedBulk: queue.filter((waiter) => waiter.lane === "bulk").length,
       messagesPerSecond: rate,
       pausedForMs: Math.max(0, pausedUntil - now())
     })

package/dist/entrypoints/tools.js

@@ -74,7 +74,7 @@ import {
   WaitTimeoutError,
   runWaitOperation,
   createCli2
-} from "../index-3qqdqwxe.js";
+} from "../index-w7jq3fz9.js";
 import"../index-2kbysk9s.js";
 import {
   ManagedFilePathSchema2,
@@ -94,8 +94,8 @@ import {
 import {
   createToolInvoker2
 } from "../index-vwhrnp67.js";
-import"../index-j8kf56wx.js";
-import"../index-x0ddbj85.js";
+import"../index-q968hy6y.js";
+import"../index-arjmb6de.js";
 import {
   collectToolSurface
 } from "../index-86nbfysb.js";

package/dist/{index-dx5cm9pc.js → index-4g6qmgdx.js}

@@ -17,7 +17,7 @@ import {
   replaceMessage,
   ArchiveSpillSchema,
   createAgentRuntimeStore2
-} from "./index-944x38nv.js";
+} from "./index-jq2ky8fw.js";
 
 // src/agent-runtime/store-memory.ts
 import { z as z2 } from "zod";

package/dist/{index-nregbbsc.js → index-6f49krb5.js}

@@ -4,7 +4,7 @@ import {
   openFileAt,
   listAt,
   readContainedUtf8Handle
-} from "./index-x0ddbj85.js";
+} from "./index-arjmb6de.js";
 
 // src/agent-runtime/contained-scan.ts
 import path from "node:path";

package/dist/{index-x0ddbj85.js → index-arjmb6de.js}

@@ -261,6 +261,41 @@ async function missingContainedDirectories(root, relative) {
     await current.close();
   }
 }
+function alternateSpellings(name) {
+  const swapped = [...name].map((letter) => letter === letter.toLowerCase() ? letter.toUpperCase() : letter.toLowerCase()).join("");
+  return [...new Set([swapped, name.normalize("NFC"), name.normalize("NFD")])].filter((spelling) => spelling !== name);
+}
+async function misspelledContainedSegment(root, relative) {
+  const segments = safeSegments(relative);
+  let current = await openPinnedDirectory(root);
+  try {
+    for (const [index, segment] of segments.entries()) {
+      const exists = async (name) => await statAt(current, name).catch(() => null) !== null;
+      let folded = false;
+      for (const spelling of alternateSpellings(segment)) {
+        folded ||= await exists(spelling);
+      }
+      if (folded && await exists(segment)) {
+        const stored = (await listAt(current)).some(({ name }) => name === segment);
+        if (!stored)
+          return segment;
+      }
+      if (index === segments.length - 1)
+        return;
+      const next = await openDirectoryAt(current, segment).catch((error) => {
+        if (["ENOENT", "ENOTDIR", "ELOOP"].includes(errnoOf(error) ?? ""))
+          return null;
+        throw error;
+      });
+      if (!next)
+        return;
+      current = await descend(current, next);
+    }
+    return;
+  } finally {
+    await current.close();
+  }
+}
 
 class UnapprovedContainedDirectoryError extends Error {
   relative;
@@ -383,4 +418,4 @@ async function readContainedUtf8Handle(handle, maxBytes) {
   };
 }
 
-export { descriptorPath, NumericFileHandle, openDirectoryAt, openPinnedDirectory, isSafeEntryName, openFileAt, listAt, listContainedDirectory, missingContainedDirectories, UnapprovedContainedDirectoryError, openContainedParent, openContainedFile, ContainedPathChangedError, assertContainedFileCurrent, assertContainedParentCurrent, containedEntryMetadata, openContainedParentFile, readContainedUtf8Handle };
+export { descriptorPath, NumericFileHandle, openDirectoryAt, openPinnedDirectory, isSafeEntryName, openFileAt, listAt, listContainedDirectory, missingContainedDirectories, misspelledContainedSegment, UnapprovedContainedDirectoryError, openContainedParent, openContainedFile, ContainedPathChangedError, assertContainedFileCurrent, assertContainedParentCurrent, containedEntryMetadata, openContainedParentFile, readContainedUtf8Handle };

package/dist/{index-crmswbrt.js → index-fa435yq2.js}

@@ -19,7 +19,7 @@ import {
   appendEventIn,
   ArchiveProjectionSchema,
   createAgentRuntimeStore2
-} from "./index-944x38nv.js";
+} from "./index-jq2ky8fw.js";
 import {
   AgentConversationPageSchema2,
   AgentConversationMessagePageSchema2

package/dist/{index-944x38nv.js → index-jq2ky8fw.js}

@@ -4,7 +4,7 @@ import {
   AgentSandboxRestrictionSchema2,
   AgentSandboxGradeSchema2,
   AGENT_CODING_TOOL_NAMES
-} from "./index-7yx8j6ay.js";
+} from "./index-n5sv4z0w.js";
 import {
   AgentRecordIdSchema2,
   AgentRecordVersionSchema2,

package/dist/{index-7yx8j6ay.js → index-n5sv4z0w.js}

@@ -7,13 +7,14 @@ import {
 } from "./index-dr3t5n1v.js";
 import {
   scanContainedFiles
-} from "./index-nregbbsc.js";
+} from "./index-6f49krb5.js";
 import {
   writeContainedFile
-} from "./index-j8kf56wx.js";
+} from "./index-q968hy6y.js";
 import {
   listContainedDirectory,
   missingContainedDirectories,
+  misspelledContainedSegment,
   UnapprovedContainedDirectoryError,
   openContainedParent,
   openContainedFile,
@@ -23,7 +24,7 @@ import {
   containedEntryMetadata,
   openContainedParentFile,
   readContainedUtf8Handle
-} from "./index-x0ddbj85.js";
+} from "./index-arjmb6de.js";
 import {
   defineRuntimeTool2
 } from "./index-ega3yz4c.js";
@@ -438,6 +439,14 @@ async function authorizeCodingPath(config, path2) {
   }
 }
 async function authorizeCodingPathChain(config, relative) {
+  if (relative !== ".") {
+    const misspelled = await misspelledContainedSegment(await realpath(config.root), relative);
+    if (misspelled !== undefined) {
+      codingPathRefusal("BAD_REQUEST", "This path differs from the name stored on disk", relative, {
+        hint: "Use list_directory to see the stored spelling."
+      });
+    }
+  }
   if (!config.authorizePath)
     return;
   const segments = relative === "." ? ["."] : relative.split("/");

package/dist/{index-j8kf56wx.js → index-q968hy6y.js}

@@ -4,7 +4,7 @@ import {
 import {
   descriptorPath,
   NumericFileHandle
-} from "./index-x0ddbj85.js";
+} from "./index-arjmb6de.js";
 import {
   stagingName
 } from "./index-tt30h7mr.js";

package/dist/{index-3qqdqwxe.js → index-w7jq3fz9.js}

@@ -25,12 +25,12 @@ import {
 } from "./index-htxh46ej.js";
 import {
   writeContainedFile
-} from "./index-j8kf56wx.js";
+} from "./index-q968hy6y.js";
 import {
   openPinnedDirectory,
   isSafeEntryName,
   containedEntryMetadata
-} from "./index-x0ddbj85.js";
+} from "./index-arjmb6de.js";
 import {
   collectToolSurface
 } from "./index-86nbfysb.js";
@@ -1348,6 +1348,8 @@ function groupKey(value) {
     return ABSENT;
   if (value === null)
     return "null";
+  if (value === "null" || value === ABSENT)
+    return JSON.stringify(value);
   if (typeof value === "object")
     return JSON.stringify(value);
   return String(value);
@@ -1355,7 +1357,20 @@ function groupKey(value) {
 function ordered(totals, top) {
   const entries = [...totals].sort(([leftKey, left], [rightKey, right]) => right === left ? leftKey.localeCompare(rightKey) : right - left);
   const sliced = top === undefined ? entries : entries.slice(0, top);
-  return Object.fromEntries(sliced);
+  return {
+    kind: "json",
+    data: Object.fromEntries(sliced),
+    order: sliced.map(([key]) => key)
+  };
+}
+function stringifyGroups(data, order, compact) {
+  if (!isRecord(data) || order.length === 0)
+    return JSON.stringify(data);
+  const lines = order.map((key) => `${JSON.stringify(key)}:${compact ? "" : " "}${JSON.stringify(data[key])}`);
+  return compact ? `{${lines.join(",")}}` : `{
+  ${lines.join(`,
+  `)}
+}`;
 }
 function numericValue(value, field) {
   if (isAbsent(value))
@@ -1440,7 +1455,7 @@ function renderCliView2(data, view) {
       const key = groupKey(readField(record, path));
       totals.set(key, (totals.get(key) ?? 0) + 1);
     }
-    return { kind: "json", data: ordered(totals, view.top) };
+    return ordered(totals, view.top);
   }
   const path = assertFieldPresent(records, view.field);
   if (view.by === undefined) {
@@ -1455,7 +1470,7 @@ function renderCliView2(data, view) {
     const key = groupKey(readField(record, byPath));
     totals.set(key, (totals.get(key) ?? 0) + (numericValue(readField(record, path), view.field) ?? 0));
   }
-  return { kind: "json", data: ordered(totals, view.top) };
+  return ordered(totals, view.top);
 }
 
 // src/tools/operations/wait-core.ts
@@ -2350,6 +2365,11 @@ async function emitManagedResult(session, command, initial, options) {
       stdout(viewed.text);
       return exit(downloadsOk ? 0 : 1);
     }
+    if (viewed.order) {
+      stdout(`${stringifyGroups(viewed.data, viewed.order, options.json === true)}
+`);
+      return exit(downloadsOk ? 0 : 1);
+    }
     result = { ...result, data: viewed.data };
   }
   const exitCode = emitResult2(result, { stdout, stderr }, emitOptionsFor(config, options.json, command));

package/dist/internal/contained-files.d.ts

@@ -71,6 +71,16 @@ export interface ContainedParent {
  * happens, and cannot do that without knowing what would be created.
  */
 export declare function missingContainedDirectories(root: string, relative: string): Promise<string[]>;
+/**
+ * The first segment of `relative` that opens an entry stored under another spelling.
+ *
+ * A policy compares strings, and a volume that folds case or normalization opens
+ * `CREDENTIALS` for a rule written against `credentials`. An entry that answers to
+ * another spelling is the only cost here: a listing runs only then, and it decides,
+ * because two distinct entries may exist on a volume that does not fold. A missing
+ * segment is not misspelled; the caller reports it.
+ */
+export declare function misspelledContainedSegment(root: string, relative: string): Promise<string | undefined>;
 /** A directory vanished after the host approved a different creation plan. */
 export declare class UnapprovedContainedDirectoryError extends Error {
     readonly relative: string;