stitchkit 0.83.0 → 0.83.1

package/CHANGELOG.md

@@ -15,6 +15,25 @@ additive**; the first breaking change landed in 0.10.0. Grep the file for
 
 ## [Unreleased]
 
+## [0.83.1] — 2026-09-07
+
+### Fixed
+
+- **The drain bound could not fire when it was the only thing left to fire.**
+  0.83.0 unref'd the bound's timer, which reads like hygiene — a drain bound
+  should not keep a process alive while it is shutting down — and silently
+  destroyed the feature. A pending write holds nothing, so when the stuck write
+  is the last work in the process, an unref'd timer lets the event loop empty
+  and `close({ timeoutMs })` never settles at all. That is not an edge case, it
+  is the case the bound exists for; under Node the process exits 13 on the
+  unsettled await. The timer cannot outlive the deadline the caller asked for,
+  so it is ref'd again.
+
+  Every in-process test passed against the broken build, because a test runner
+  keeps the loop alive by itself. The consumer lane now runs the real failure
+  from the packed tarball under each runtime (`node: drain bound`), which is the
+  only place it was ever visible.
+
 ## [0.83.0] — 2026-09-07
 
 ### ⚠️ Breaking changes

package/dist/agent-runtime-harness.js

@@ -2,12 +2,12 @@ import {
   composeAgentPrompt,
   createAgentRuntime,
   createAgentRuntimeEventSink
-} from "./index-pq7ak4k8.js";
+} from "./index-st8v8739.js";
 import {
   AgentModelDescriptorSchema
 } from "./index-tg3m2ec5.js";
 import"./index-y2s6h5bf.js";
-import"./index-7z1h3kbr.js";
+import"./index-wnfk50r0.js";
 import {
   walkContainedFiles
 } from "./index-rqpdar1e.js";

package/dist/agent-runtime.js

@@ -48,7 +48,7 @@ import {
   registerDeferredToolRepair,
   repairedSearchCall,
   selectAgentHistory
-} from "./index-pq7ak4k8.js";
+} from "./index-st8v8739.js";
 import {
   AgentModelCapabilitySchema,
   AgentModelCatalogEntrySchema,
@@ -72,7 +72,7 @@ import {
 } from "./index-y2s6h5bf.js";
 import {
   createBoundedSinkManager
-} from "./index-7z1h3kbr.js";
+} from "./index-wnfk50r0.js";
 import {
   AgentAdmissionEventSchema,
   AgentCheckpointEventSchema,

package/dist/application-opentelemetry.js

@@ -1,11 +1,11 @@
 import {
   ActivitySnapshotSchema,
   ManagedScheduleStatusSchema
-} from "./index-64ew0vnj.js";
+} from "./index-9f8ztey6.js";
 import {
   ApplicationSnapshotSchema
 } from "./index-3gye9wzb.js";
-import"./index-7z1h3kbr.js";
+import"./index-wnfk50r0.js";
 import"./index-7gnkny4z.js";
 
 // src/application/opentelemetry.ts

package/dist/application.js

@@ -26,7 +26,7 @@ import {
   createActivityProjection,
   createApplicationSnapshotSink,
   createManagedSchedule
-} from "./index-64ew0vnj.js";
+} from "./index-9f8ztey6.js";
 import {
   DiagnosticJournalCloseResultSchema,
   DiagnosticJournalFailurePhaseSchema,
@@ -60,7 +60,7 @@ import {
 import"./index-3z73fh2c.js";
 import {
   createBoundedSinkManager
-} from "./index-7z1h3kbr.js";
+} from "./index-wnfk50r0.js";
 import {
   backoffDelay,
   createBackoff

package/dist/{index-64ew0vnj.js → index-9f8ztey6.js}

@@ -4,7 +4,7 @@ import {
 import {
   assertDrainBound,
   withinBound
-} from "./index-7z1h3kbr.js";
+} from "./index-wnfk50r0.js";
 import {
   createBoundedChannel
 } from "./index-7gnkny4z.js";

package/dist/{index-pq7ak4k8.js → index-st8v8739.js}

@@ -8,7 +8,7 @@ import {
 } from "./index-y2s6h5bf.js";
 import {
   createBoundedSinkManager
-} from "./index-7z1h3kbr.js";
+} from "./index-wnfk50r0.js";
 import {
   AgentRuntimeEventSchema,
   agentDurableEventId

package/dist/{index-7z1h3kbr.js → index-wnfk50r0.js}

@@ -82,10 +82,8 @@ function withinBound(work, bound) {
       onAbort = give;
       signal.addEventListener("abort", onAbort, { once: true });
     }
-    if (timeoutMs !== undefined) {
+    if (timeoutMs !== undefined)
       timer = setTimeout(give, timeoutMs);
-      timer.unref?.();
-    }
   });
   return Promise.race([work.then(() => true), reached]).finally(() => {
     if (timer !== undefined)

package/dist/internal/observability-sink.d.ts

@@ -53,8 +53,16 @@ export declare function assertDrainBound(bound: ObservabilityDrainBound | undefi
  * `flush({ signal })` per batch is exactly the shape that accumulates them.
  * A listener and a timer, both disposed here, cost nothing and leave nothing.
  *
- * The timer is unref'd: a drain bound must never be the thing keeping a process
- * alive when the whole point is shutting down.
+ * The timer is REF'D, and that is the whole mechanism. Unref'ing it reads like
+ * good hygiene — a drain bound should not keep a process alive while it is
+ * shutting down — and it silently destroys the feature: a pending write holds
+ * nothing, so when the stuck write is the last thing left, an unref'd timer
+ * lets the loop empty and the bound never fires at all. That is not an edge
+ * case, it is the case this exists for. The timer cannot outlive the deadline
+ * the caller itself asked for, so holding the loop for exactly that long is
+ * what was wanted. Found only by installing the published package and running
+ * it under `node`, where the process exits 13 on an unsettled top-level await;
+ * every in-process test passes because the runner keeps the loop alive.
  */
 export declare function withinBound(work: Promise<unknown>, bound: ObservabilityDrainBound | undefined): Promise<boolean>;
 export interface BoundedSinkManager<EVENT> {

package/dist/internal/observability-sink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observability-sink.d.ts","sourceRoot":"","sources":["../../src/internal/observability-sink.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,gBAAgB,CAAC,KAAK;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB,CAAC,KAAK;IACtC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,CAAC,CAAC,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,uBAAuB;IACtC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI,CAMjF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EACtB,KAAK,EAAE,uBAAuB,GAAG,SAAS,GACzC,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAED,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACvC,MAAM,CAAC,OAAO,EAAE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACpD,iFAAiF;IACjF,KAAK,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,SAAS,IAAI,uBAAuB,CAAC;IACrC;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC1E;AAaD,wBAAgB,wBAAwB,CAAC,KAAK,EAC5C,MAAM,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAC/B,kBAAkB,CAAC,KAAK,CAAC,CAuJ3B"}
+{"version":3,"file":"observability-sink.d.ts","sourceRoot":"","sources":["../../src/internal/observability-sink.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,gBAAgB,CAAC,KAAK;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB,CAAC,KAAK;IACtC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,CAAC,CAAC,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,uBAAuB;IACtC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI,CAMjF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EACtB,KAAK,EAAE,uBAAuB,GAAG,SAAS,GACzC,OAAO,CAAC,OAAO,CAAC,CA2BlB;AAED,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACvC,MAAM,CAAC,OAAO,EAAE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACpD,iFAAiF;IACjF,KAAK,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,SAAS,IAAI,uBAAuB,CAAC;IACrC;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC1E;AAaD,wBAAgB,wBAAwB,CAAC,KAAK,EAC5C,MAAM,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAC/B,kBAAkB,CAAC,KAAK,CAAC,CAuJ3B"}

package/dist/observability/index.js

@@ -6,7 +6,7 @@ import {
   assertDrainBound,
   createBoundedSinkManager,
   withinBound
-} from "../index-7z1h3kbr.js";
+} from "../index-wnfk50r0.js";
 import {
   measureSize,
   redact,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.83.0",
+  "version": "0.83.1",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",