stitchkit 0.104.1 → 0.105.0

package/dist/{index-hbd32c6a.js → index-wqmvtnkp.js}

@@ -2,22 +2,29 @@ import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2
 } from "./index-xqhede6x.js";
+import {
+  raceAbort
+} from "./index-b0kddvzw.js";
 import {
   BoundedFileReadError,
   readBoundedFile
-} from "./index-jd470k6q.js";
+} from "./index-m616f0yz.js";
 import {
   isWithinDir2
 } from "./index-5cc6r990.js";
 import {
-  AtomicFilePublicationError2,
-  publishAtomicFile
-} from "./index-8a9ksm91.js";
+  writeAllBytes,
+  writeAtomicFileStaged
+} from "./index-ef8gdaq0.js";
+import {
+  AtomicFilePublicationError2
+} from "./index-b56nnscm.js";
+import {
+  assertPositiveSafeInteger
+} from "./index-0s4xebbg.js";
 
 // src/files/boundary.ts
-import { randomUUID } from "node:crypto";
-import { constants } from "node:fs";
-import { mkdir, open as open2, realpath, stat, unlink } from "node:fs/promises";
+import { mkdir, realpath, stat } from "node:fs/promises";
 import { basename as basename2, dirname, resolve } from "node:path";
 
 // src/files/file-io.ts
@@ -25,27 +32,6 @@ var ManagedFileInspectionSchema = ManagedFileRefSchema2.pick({
   mediaType: true,
   name: true
 });
-function abortReason(signal) {
-  return signal.reason ?? new DOMException("The operation was aborted", "AbortError");
-}
-function raceWithSignal(operation, signal) {
-  signal.throwIfAborted();
-  return new Promise((resolvePromise, rejectPromise) => {
-    let settled = false;
-    const settle = (complete) => {
-      if (settled)
-        return;
-      settled = true;
-      signal.removeEventListener("abort", onAbort);
-      complete();
-    };
-    const onAbort = () => settle(() => rejectPromise(abortReason(signal)));
-    signal.addEventListener("abort", onAbort, { once: true });
-    if (signal.aborted)
-      onAbort();
-    operation.then((value) => settle(() => resolvePromise(value)), (error) => settle(() => rejectPromise(error)));
-  });
-}
 async function inspectFile(inspector, input, timeoutMs, outerSignal) {
   if (!inspector)
     return {};
@@ -53,11 +39,11 @@ async function inspectFile(inspector, input, timeoutMs, outerSignal) {
   const timeoutSignal = AbortSignal.timeout(timeoutMs);
   const signal = outerSignal ? AbortSignal.any([outerSignal, timeoutSignal]) : timeoutSignal;
   try {
-    const inspected = await raceWithSignal(Promise.resolve().then(() => inspector({ ...input, signal })), signal);
+    const inspected = await raceAbort(Promise.resolve().then(() => inspector({ ...input, signal })), signal);
     return ManagedFileInspectionSchema.parse(inspected);
   } catch (error) {
     if (outerSignal?.aborted)
-      throw abortReason(outerSignal);
+      throw outerSignal.reason;
     throw new ManagedFileError2("FILE_INSPECTION_REJECTED", "managed file rejected by inspection", { cause: error });
   }
 }
@@ -75,16 +61,7 @@ function inspectedRef(path, size, inspection, fallback = {}) {
   }
   return parsed.data;
 }
-async function writeChunk(handle, chunk) {
-  let offset = 0;
-  while (offset < chunk.byteLength) {
-    const { bytesWritten } = await handle.write(chunk, offset, chunk.byteLength - offset);
-    if (bytesWritten === 0)
-      throw new Error("zero-byte managed-file write");
-    offset += bytesWritten;
-  }
-}
-async function writeSource(handle, source, maxBytes, inspectionBytes, signal) {
+async function writeSource(file, source, maxBytes, inspectionBytes, signal) {
   let size = 0;
   const prefixChunks = [];
   let prefixSize = 0;
@@ -99,7 +76,7 @@ async function writeSource(handle, source, maxBytes, inspectionBytes, signal) {
       prefixChunks.push(kept);
       prefixSize += kept.byteLength;
     }
-    await writeChunk(handle, chunk);
+    await writeAllBytes(file, chunk);
   };
   if (source instanceof Uint8Array) {
     await consume(source);
@@ -157,11 +134,6 @@ async function readManagedDescriptor(target, path, maxBytes, options, inspection
 var DEFAULT_MAX_BYTES = 100 * 1024 * 1024;
 var DEFAULT_INSPECTION_BYTES = 64 * 1024;
 var DEFAULT_INSPECTION_TIMEOUT_MS = 15000;
-var nofollowFlag;
-var noFollow = () => {
-  nofollowFlag ??= constants.O_NOFOLLOW ?? 0;
-  return nofollowFlag;
-};
 
 class ManagedFileError2 extends Error {
   code;
@@ -173,9 +145,7 @@ class ManagedFileError2 extends Error {
 }
 function positiveLimit(value, fallback, name) {
   const resolved = value ?? fallback;
-  if (!Number.isSafeInteger(resolved) || resolved <= 0) {
-    throw new TypeError(`${name} must be a positive safe integer`);
-  }
+  assertPositiveSafeInteger(name, resolved);
   return resolved;
 }
 function filePath(path) {
@@ -311,37 +281,24 @@ async function createManagedFileBoundary2(config) {
       const resolved = targetFor(path);
       const parent = await existingParent(root, resolved.target);
       const maxBytes = positiveLimit(options.maxBytes, maxWriteBytes, "maxBytes");
-      const temporary = resolve(parent, `.stitchkit-${randomUUID()}.tmp`);
-      let handle;
-      let committed = false;
-      let size = 0;
       try {
-        handle = await open2(temporary, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | noFollow(), 384);
-        const written = await writeSource(handle, source, maxBytes, inspectionBytes, options.signal);
-        size = written.size;
-        if (options.durable)
-          await handle.sync();
-        await handle.close();
-        handle = undefined;
-        const inspection = await inspectFile(config.inspect, {
-          prefix: written.prefix,
-          ...options.mediaType ? { declaredMediaType: options.mediaType } : {},
-          name: options.name ?? basename2(resolved.path)
-        }, inspectionTimeoutMs, options.signal);
-        options.signal?.throwIfAborted();
-        try {
-          await publishAtomicFile(temporary, resolved.target, options.replace ?? false, options.durable ?? false);
-          committed = true;
-        } catch (error) {
-          if (error instanceof AtomicFilePublicationError2) {
-            committed = true;
-            throw error;
-          }
-          if (errorCode(error) === "EEXIST")
-            throw new ManagedFileError2("FILE_EXISTS", "managed file already exists");
-          throw error;
-        }
-        return inspectedRef(resolved.path, size, inspection, {
+        const staged = await writeAtomicFileStaged(resolve(parent, basename2(resolved.target)), {
+          async fill(file) {
+            const written = await writeSource(file, source, maxBytes, inspectionBytes, options.signal);
+            const inspection = await inspectFile(config.inspect, {
+              prefix: written.prefix,
+              ...options.mediaType ? { declaredMediaType: options.mediaType } : {},
+              name: options.name ?? basename2(resolved.path)
+            }, inspectionTimeoutMs, options.signal);
+            options.signal?.throwIfAborted();
+            return { size: written.size, inspection };
+          },
+          onCleanupError: config.onCleanupError
+        }, {
+          replace: options.replace ?? false,
+          durability: options.durable ? "directory" : "none"
+        });
+        return inspectedRef(resolved.path, staged.size, staged.inspection, {
           mediaType: options.mediaType,
           name: options.name
         });
@@ -350,17 +307,9 @@ async function createManagedFileBoundary2(config) {
           throw error;
         if (options.signal?.aborted && error === options.signal.reason)
           throw error;
+        if (errorCode(error) === "EEXIST")
+          throw new ManagedFileError2("FILE_EXISTS", "managed file already exists");
         throw ioError("failed to write managed file", error);
-      } finally {
-        await handle?.close().catch(() => {
-          return;
-        });
-        if (!options.replace || !committed) {
-          await unlink(temporary).catch((error) => {
-            if (errorCode(error) !== "ENOENT")
-              config.onCleanupError?.(error);
-          });
-        }
       }
     }
   };

package/dist/{index-hp9d77wk.js → index-x7w1z6pf.js}

@@ -1,11 +1,11 @@
 import {
   defineContract2
-} from "./index-ck71tbcf.js";
+} from "./index-fsw1ybf3.js";
 import {
   AppError2,
   STITCH_ERROR_STATUS2,
   isStitchErrorCode2
-} from "./index-x928baz2.js";
+} from "./index-j9gxbztg.js";
 import {
   bytesToBase64Url,
   base64UrlToBytes
@@ -46,10 +46,21 @@ function defineErrors2(source, mapping) {
         if ("details" in options) {
           throw new Error(`[stitchkit] Error "${name}" does not declare details`);
         }
-        return new AppError2(name, message, definition.status, undefined, options.hint, undefined, definition.retryable);
+        return new AppError2(name, {
+          message,
+          status: definition.status,
+          hint: options.hint,
+          retryable: definition.retryable
+        });
       }
       const details = definition.details.parse(options.details);
-      return new AppError2(name, message, definition.status, details, options.hint, undefined, definition.retryable);
+      return new AppError2(name, {
+        message,
+        status: definition.status,
+        details,
+        hint: options.hint,
+        retryable: definition.retryable
+      });
     };
   });
   Object.freeze(errors);

package/dist/{index-20yvtn9a.js → index-yt7gyg5x.js}

@@ -9,7 +9,7 @@ import {
   AgentControlRequestSchema2,
   AgentControlResponseSchema2,
   AgentControlDeliverySchema2
-} from "./index-n5yqxd3d.js";
+} from "./index-b0w7rbpt.js";
 
 // src/agent-runtime/browser-control-contract.ts
 import { z } from "zod";

package/dist/{index-cvda079a.js → index-yvfk3y36.js}

@@ -1,6 +1,9 @@
 import {
   projectRuntimeTool
-} from "./index-77nxk6ay.js";
+} from "./index-r393tnfp.js";
+import {
+  isRecord
+} from "./index-9jfdm5tg.js";
 
 // src/tools/runtime-tool.ts
 function defineRuntimeTool2(definition) {
@@ -52,6 +55,13 @@ function createRuntimeToolFactory2(config) {
   }
   return { define };
 }
+function isAgentPresenter(value) {
+  return typeof value === "function";
+}
+function agentPresenterOf(definition) {
+  const { present } = definition;
+  return isRecord(present) && isAgentPresenter(present.agent) ? present.agent : undefined;
+}
 function runtimeToolIdentity(definition) {
   return {
     method: definition.identity.method,
@@ -97,4 +107,4 @@ function executableAgentRuntimeTools(tools) {
   return tools;
 }
 
-export { defineRuntimeTool2, createRuntimeToolFactory2, runtimeToolMountable, executableAgentRuntimeTools };
+export { defineRuntimeTool2, createRuntimeToolFactory2, agentPresenterOf, runtimeToolMountable, executableAgentRuntimeTools };

package/dist/{index-5z6jn897.js → index-z23rfxhj.js}

@@ -1,6 +1,6 @@
 import {
   createValidatedRealtimeSocket
-} from "./index-43p08g7t.js";
+} from "./index-pzb63z66.js";
 
 // src/server/realtime.ts
 function bindRealtimeServer2(contract, handle, options = {}) {

package/dist/internal/abort-race.d.ts

@@ -1,3 +1,9 @@
-/** Releases an await on cancellation without assuming a callback cooperates with its signal. */
-export declare function raceAbort<T>(operation: Promise<T>, signal: AbortSignal): Promise<T>;
+/**
+ * Releases an await on cancellation without assuming a callback cooperates with its signal.
+ *
+ * When the signal wins and the operation settles later, a fulfilled value is handed to
+ * `disposeLate` so an owner can release what it would otherwise leak (a stream, a
+ * handle); a late rejection is swallowed because the caller already has the reason.
+ */
+export declare function raceAbort<T>(operation: Promise<T>, signal: AbortSignal, disposeLate?: (value: T) => void): Promise<T>;
 //# sourceMappingURL=abort-race.d.ts.map

package/dist/internal/abort-race.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abort-race.d.ts","sourceRoot":"","sources":["../../src/internal/abort-race.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAsBnF"}
+{"version":3,"file":"abort-race.d.ts","sourceRoot":"","sources":["../../src/internal/abort-race.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EACrB,MAAM,EAAE,WAAW,EACnB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC/B,OAAO,CAAC,CAAC,CAAC,CA+BZ"}

package/dist/internal/atomic-file.d.ts

@@ -20,6 +20,7 @@
  * synchronous `rename` on a loaded machine was measured holding a consumer's
  * main thread for ~15 s — every timer and request of a daemon stood still.
  */
+import { type AtomicPublishOptions } from './atomic-publication.js';
 /** Options of {@link writeFileAtomic} and {@link writeFileAtomicSync}. */
 export interface WriteFileAtomicOptions {
     /**
@@ -31,29 +32,74 @@ export interface WriteFileAtomicOptions {
     mode?: number;
     /** Replace by default; false atomically refuses any existing file or link. */
     replace?: boolean;
-    /** Default file: fsync bytes. directory also syncs the parent after publication. */
+    /**
+     * `'file'` (the default) fsyncs the bytes before publication; `'directory'`
+     * also fsyncs the parent after it; `'none'` does neither.
+     */
     durability?: 'none' | 'file' | 'directory';
 }
+/** The staged file as a writer sees it; a `FileHandle` satisfies it. */
+export interface StagedFile {
+    write(bytes: Uint8Array, offset: number, length: number): Promise<{
+        bytesWritten: number;
+    }>;
+    chmod(mode: number): Promise<void>;
+    sync(): Promise<void>;
+    close(): Promise<void>;
+}
+/** Write every byte of `bytes`; a short write continues and a write of zero bytes is an error. */
+export declare function writeAllBytes(file: StagedFile, bytes: Uint8Array): Promise<void>;
 /**
  * Write `data` to `target` atomically: a reader sees the old contents or the
  * new ones, never part of either, and the new file has `mode` from its first
  * visible moment. A failure before publication leaves the target untouched. Directory-sync or
  * staging-link cleanup failure after publication throws AtomicFilePublicationError
  * with published=true; do not blindly repeat an external action.
+ *
+ * The bytes are staged in the target's directory under a name {@link isAtomicStagingName}
+ * recognises (`.stitchkit-<24 hex>.tmp`, a stable public contract). A process killed before
+ * publication leaves that file behind and no later write removes it: recognising and sweeping
+ * abandoned staging ({@link sweepAtomicStaging}) is the caller's responsibility.
  */
 export declare function writeFileAtomic(target: string, data: Uint8Array | string, options?: WriteFileAtomicOptions): Promise<void>;
 interface AtomicFileWriteIO {
-    open(path: string, flags: 'wx', mode: number): Promise<{
-        writeFile(bytes: Uint8Array): Promise<void>;
-        chmod(mode: number): Promise<void>;
-        sync(): Promise<void>;
-        close(): Promise<void>;
-    }>;
+    open(path: string, flags: 'wx', mode: number): Promise<StagedFile>;
     unlink(path: string): Promise<void>;
-    publish(staged: string, target: string, replace: boolean, directorySync: boolean): Promise<void>;
+    publish(staged: string, target: string, options: AtomicPublishOptions): Promise<void>;
+}
+/** How the staged bytes of one atomic write are produced and vetted. */
+export interface AtomicFileStage<T> {
+    /** Fills the staged file; a throw discards the staging, and the result is what the write returns once published. */
+    fill(file: StagedFile): Promise<T>;
+    /** Receives a failure to remove the staging file after a failed write. */
+    onCleanupError?(error: unknown): void;
 }
-/** Internal syscall seam for publication-order and precommit fault controls. */
+/**
+ * The one staging sequence behind every asynchronous atomic write: exclusive
+ * create, fill, chmod, fsync, publication, and removal of the
+ * staging file on any failure. Also the internal syscall seam for
+ * publication-order and precommit fault controls.
+ */
+export declare function writeAtomicFileStaged<T>(target: string, stage: AtomicFileStage<T>, options: WriteFileAtomicOptions, io?: AtomicFileWriteIO): Promise<T>;
+/** {@link writeAtomicFileStaged} for bytes already in memory. */
 export declare function writeAtomicFileData(target: string, data: Uint8Array | string, options: WriteFileAtomicOptions, io?: AtomicFileWriteIO): Promise<void>;
+/** The staged file of the synchronous form. */
+interface StagedFileSync {
+    write(bytes: Uint8Array, offset: number, length: number): number;
+    chmod(mode: number): void;
+    sync(): void;
+    close(): void;
+}
+interface AtomicFileWriteSyncIO {
+    open(path: string, flags: 'wx', mode: number): StagedFileSync;
+    unlink(path: string): void;
+    publish(staged: string, target: string, options: AtomicPublishOptions): void;
+}
+/**
+ * The synchronous form of {@link writeFileAtomic}, with the same guarantees in
+ * the same order, and the same internal syscall seam.
+ */
+export declare function writeAtomicFileDataSync(target: string, data: Uint8Array | string, options: WriteFileAtomicOptions, io?: AtomicFileWriteSyncIO): void;
 /** The synchronous form of {@link writeFileAtomic}, with the same guarantees in the same order. */
 export declare function writeFileAtomicSync(target: string, data: Uint8Array | string, options?: WriteFileAtomicOptions): void;
 export {};

package/dist/internal/atomic-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atomic-file.d.ts","sourceRoot":"","sources":["../../src/internal/atomic-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAQH,0EAA0E;AAC1E,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;CAC5C;AAYD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,UAAU,iBAAiB;IACzB,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,IAAI,EACX,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QACT,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KACxB,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,CACL,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,OAAO,GACrB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,gFAAgF;AAChF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,OAAO,EAAE,sBAAsB,EAC/B,EAAE,GAAE,iBAAgE,GACnE,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,mGAAmG;AACnG,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,OAAO,GAAE,sBAA2B,GACnC,IAAI,CAiDN"}
+{"version":3,"file":"atomic-file.d.ts","sourceRoot":"","sources":["../../src/internal/atomic-file.ts"],"names":[],"mappings":"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"}

package/dist/internal/atomic-publication.d.ts

@@ -1,10 +1,16 @@
-/** The new target is visible; failure is not evidence that publication did not occur. */
+/**
+ * Thrown when the new file is already in place but a follow-up step (`phase`) failed; the
+ * content is published, so do not treat this as a failed write.
+ */
 export declare class AtomicFilePublicationError extends Error {
     readonly phase: 'cleanup' | 'directory-sync' | 'directory-close';
     readonly published = true;
     constructor(phase: 'cleanup' | 'directory-sync' | 'directory-close', cause: unknown);
 }
-/** Native publication syscalls; injectable only at this internal IO boundary for fault controls. */
+/**
+ * Native publication syscalls; injectable only at this internal IO boundary for fault
+ * controls.
+ */
 export interface PublicationIO {
     rename(from: string, to: string): Promise<void>;
     link(from: string, to: string): Promise<void>;
@@ -14,6 +20,35 @@ export interface PublicationIO {
         close(): Promise<void>;
     }>;
 }
-export declare function publishAtomicFile(staged: string, target: string, replace: boolean, directorySync: boolean, io?: PublicationIO): Promise<void>;
-export declare function publishAtomicFileSync(staged: string, target: string, replace: boolean, directorySync: boolean): void;
+/**
+ * The synchronous counterpart of {@link PublicationIO}, with the same fault-control role.
+ */
+export interface PublicationSyncIO {
+    rename(from: string, to: string): void;
+    link(from: string, to: string): void;
+    unlink(path: string): void;
+    open(path: string, flags: 'r'): {
+        sync(): void;
+        close(): void;
+    };
+}
+/** Directory fsync needs a directory descriptor, which Windows does not provide. */
+export declare function assertDirectoryDurability(): void;
+/** Make a rename, link or unlink inside `path` durable: the one directory fsync. */
+export declare function syncDirectory(path: string, io?: PublicationIO): Promise<void>;
+/**
+ * How far an atomic write is made durable: `'none'` neither syncs the bytes nor the parent,
+ * `'file'` syncs the staged bytes before publication, `'directory'` also syncs the parent after it.
+ */
+export type AtomicDurability = 'none' | 'file' | 'directory';
+/**
+ * How one staged file becomes the target: `replace` overwrites, otherwise an existing target
+ * is refused.
+ */
+export interface AtomicPublishOptions {
+    readonly replace: boolean;
+    readonly durability: AtomicDurability;
+}
+export declare function publishAtomicFile(staged: string, target: string, { replace, durability }: AtomicPublishOptions, io?: PublicationIO): Promise<void>;
+export declare function publishAtomicFileSync(staged: string, target: string, { replace, durability }: AtomicPublishOptions, io?: PublicationSyncIO): void;
 //# sourceMappingURL=atomic-publication.d.ts.map

package/dist/internal/atomic-publication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atomic-publication.d.ts","sourceRoot":"","sources":["../../src/internal/atomic-publication.ts"],"names":[],"mappings":"AAIA,yFAAyF;AACzF,qBAAa,0BAA2B,SAAQ,KAAK;aAGjC,KAAK,EAAE,SAAS,GAAG,gBAAgB,GAAG,iBAAiB;IAFzE,QAAQ,CAAC,SAAS,QAAQ;IAC1B,YACkB,KAAK,EAAE,SAAS,GAAG,gBAAgB,GAAG,iBAAiB,EACvE,KAAK,EAAE,OAAO,EAIf;CACF;AAED,oGAAoG;AACpG,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;CAC5F;AAGD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,OAAO,EACtB,EAAE,GAAE,aAAsB,GACzB,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,OAAO,GACrB,IAAI,CAmCN"}
+{"version":3,"file":"atomic-publication.d.ts","sourceRoot":"","sources":["../../src/internal/atomic-publication.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;aAGjC,KAAK,EAAE,SAAS,GAAG,gBAAgB,GAAG,iBAAiB;IAFzE,QAAQ,CAAC,SAAS,QAAQ;IAC1B,YACkB,KAAK,EAAE,SAAS,GAAG,gBAAgB,GAAG,iBAAiB,EACvE,KAAK,EAAE,OAAO,EAIf;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;CAC5F;AAGD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG;QAAE,IAAI,IAAI,IAAI,CAAC;QAAC,KAAK,IAAI,IAAI,CAAA;KAAE,CAAC;CACjE;AAWD,oFAAoF;AACpF,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAED,oFAAoF;AACpF,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAE,aAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3F;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;CACvC;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,oBAAoB,EAC7C,EAAE,GAAE,aAAsB,GACzB,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,oBAAoB,EAC7C,EAAE,GAAE,iBAA8B,GACjC,IAAI,CA+BN"}

package/dist/internal/atomic-staging.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The one name every staged file of an atomic write carries, and the means to
+ * recognise and remove the ones a killed process left behind.
+ *
+ * A staging file lives in the target's own directory until it is renamed or
+ * linked onto the target. A process killed between the exclusive create and
+ * the publication (SIGKILL, OOM, power loss) leaves it there, and no later
+ * write of this library touches it: its name is random, so nothing could tell
+ * an abandoned one from a write in flight except its age. That judgement is the
+ * caller's, so the caller is given the predicate and an age-bounded sweep.
+ *
+ * The name form is a public contract: `.stitchkit-` + 24 lowercase hex digits +
+ * `.tmp`. The writer and the predicate are built from the constants below, so
+ * they cannot disagree; changing the form is a breaking change of
+ * `stitchkit/files`.
+ */
+/** A fresh staging file name; fixed length, so a long target name cannot push it past NAME_MAX. */
+export declare function stagingName(): string;
+/** A fresh staging path beside `target`: the rename onto it must not cross a filesystem. */
+export declare function stagingPath(target: string): string;
+/**
+ * True when `name` (a directory entry, not a path) is the staging file of an atomic write
+ * of this library. The form is a stable public contract; changing it is a breaking change.
+ */
+export declare function isAtomicStagingName(name: string): boolean;
+/** Options of {@link sweepAtomicStaging}. */
+export interface SweepAtomicStagingOptions {
+    /** The directory to sweep; its subdirectories are never entered. */
+    directory: string;
+    /**
+     * Only a staging file whose last modification is older than this many milliseconds is
+     * removed. Required and positive: it must exceed the longest write in flight, or the
+     * sweep removes the staging of a write that is still running.
+     */
+    olderThanMs: number;
+    /** Stops the sweep between entries; files already removed stay removed. */
+    signal?: AbortSignal;
+}
+/**
+ * Remove the abandoned staging files of atomic writes from one directory and return their
+ * names. Only regular files matching {@link isAtomicStagingName} and older than `olderThanMs`
+ * are removed; a symlink, a directory or any other entry is left alone, and nothing is
+ * followed or recursed into.
+ */
+export declare function sweepAtomicStaging(options: SweepAtomicStagingOptions): Promise<string[]>;
+//# sourceMappingURL=atomic-staging.d.ts.map

package/dist/internal/atomic-staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-staging.d.ts","sourceRoot":"","sources":["../../src/internal/atomic-staging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH,mGAAmG;AACnG,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,6CAA6C;AAC7C,MAAM,WAAW,yBAAyB;IACxC,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAQD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBnB"}

package/dist/internal/bounded-file-read.d.ts

@@ -1,11 +1,5 @@
-export interface FileObservation {
-    dev: number;
-    ino: number;
-    size: number;
-    nlink: number;
-    mtimeMs: number;
-    ctimeMs: number;
-}
+import { type FileHandle } from 'node:fs/promises';
+import type { FileObservation } from './file-observation.js';
 interface FileReadStat extends FileObservation {
     isFile(): boolean;
 }
@@ -19,15 +13,29 @@ interface FileReadDescriptor {
 export declare class BoundedFileReadError extends Error {
     readonly code: 'FILE_UNSUPPORTED' | 'FILE_NOT_REGULAR' | 'FILE_UNSAFE_LINK' | 'FILE_TOO_LARGE' | 'FILE_CHANGED';
     readonly observation?: FileObservation | undefined;
-    constructor(code: 'FILE_UNSUPPORTED' | 'FILE_NOT_REGULAR' | 'FILE_UNSAFE_LINK' | 'FILE_TOO_LARGE' | 'FILE_CHANGED', message: string, observation?: FileObservation | undefined);
+    constructor(code: 'FILE_UNSUPPORTED' | 'FILE_NOT_REGULAR' | 'FILE_UNSAFE_LINK' | 'FILE_TOO_LARGE' | 'FILE_CHANGED', message: string, observation?: FileObservation | undefined, options?: ErrorOptions);
 }
-export interface BoundedFileReadOptions {
+export interface FileOpenOptions {
+    /** Refuse a symlink at the leaf: the open itself does not follow it. Without it a symlink is followed. */
     rejectSymlinks?: boolean;
+    /** Require descriptor nlink===1; transient publication links are also refused. */
     singleLink?: boolean;
+}
+export interface BoundedFileReadOptions extends FileOpenOptions {
     stable?: boolean;
     signal?: AbortSignal;
 }
-/** The descriptor decides kind/link/stability; bytes are capped before allocation grows. */
+/**
+ * Open a regular file by descriptor for a caller that streams it; the caller closes the
+ * handle.
+ */
+export declare function openRegularFile(target: string, options?: FileOpenOptions): Promise<{
+    handle: FileHandle;
+    before: FileObservation;
+}>;
+/**
+ * The descriptor decides kind/link/stability; bytes are capped before allocation grows.
+ */
 export declare function readBoundedFile(target: string, maxBytes: number, options?: BoundedFileReadOptions, openDescriptor?: (path: string, flags: number) => Promise<FileReadDescriptor>): Promise<{
     bytes: Uint8Array;
     observation: FileObservation;

package/dist/internal/bounded-file-read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bounded-file-read.d.ts","sourceRoot":"","sources":["../../src/internal/bounded-file-read.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,YAAa,SAAQ,eAAe;IAC5C,MAAM,IAAI,OAAO,CAAC;CACnB;AAED,UAAU,kBAAkB;IAC1B,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAE3C,QAAQ,CAAC,IAAI,EACT,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc;IAElB,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe;IARxC,YACW,IAAI,EACT,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,EAClB,OAAO,EAAE,MAAM,EACN,WAAW,CAAC,EAAE,eAAe,YAAA,EAIvC;CACF;AAWD,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,4FAA4F;AAC5F,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,EACpC,cAAc,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAQ,GAClF,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,eAAe,CAAA;CAAE,CAAC,CA+D9D;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE;IACN,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1F,EACD,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAwCrB"}
+{"version":3,"file":"bounded-file-read.d.ts","sourceRoot":"","sources":["../../src/internal/bounded-file-read.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,UAAU,YAAa,SAAQ,eAAe;IAC5C,MAAM,IAAI,OAAO,CAAC;CACnB;AAED,UAAU,kBAAkB;IAC1B,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAE3C,QAAQ,CAAC,IAAI,EACT,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc;IAElB,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe;IARxC,YACW,IAAI,EACT,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,EAClB,OAAO,EAAE,MAAM,EACN,WAAW,CAAC,EAAE,eAAe,YAAA,EACtC,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF;AAWD,MAAM,WAAW,eAAe;IAC9B,0GAA0G;IAC1G,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAyDD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAE1D;AASD;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,EACpC,cAAc,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAQ,GAClF,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,eAAe,CAAA;CAAE,CAAC,CAiC9D;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE;IACN,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1F,EACD,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAgCrB"}

package/dist/internal/bounded-lines.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bounded-lines.d.ts","sourceRoot":"","sources":["../../src/internal/bounded-lines.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,QAAc,CAAC;AAkBrD,yEAAyE;AACzE,wBAAuB,oBAAoB,CACzC,QAAQ,EAAE,QAAQ,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,mBAAmB,UAAQ,GAC1B,cAAc,CAAC,MAAM,CAAC,CAqCxB"}
+{"version":3,"file":"bounded-lines.d.ts","sourceRoot":"","sources":["../../src/internal/bounded-lines.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,yBAAyB,QAAc,CAAC;AAgBrD,yEAAyE;AACzE,wBAAuB,oBAAoB,CACzC,QAAQ,EAAE,QAAQ,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,mBAAmB,UAAQ,GAC1B,cAAc,CAAC,MAAM,CAAC,CAqCxB"}

package/dist/internal/close-after.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Run `run` with a handle that is closed afterwards on every path. A failure of
+ * `run` is the one reported; a close failure is reported only when `run`
+ * succeeded, because the first cause is the one a caller can act on.
+ */
+export declare function closeAfter<T>(handle: {
+    close(): Promise<void>;
+}, run: () => Promise<T>): Promise<T>;
+/** The synchronous form of {@link closeAfter}, with the same error order. */
+export declare function closeAfterSync<T>(close: () => void, run: () => T): T;
+//# sourceMappingURL=close-after.d.ts.map

package/dist/internal/close-after.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-after.d.ts","sourceRoot":"","sources":["../../src/internal/close-after.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,MAAM,EAAE;IAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,EAClC,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAUZ;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAcpE"}

package/dist/internal/deadline.d.ts

@@ -14,4 +14,14 @@ export declare function withDeadline(value: unknown, timeoutMs: number): Promise
 } | {
     settled: false;
 }>;
+/**
+ * Run `body` under the caller's signal and a deadline.
+ *
+ * One implementation of "caller signal plus timer": the signal handed to `body` aborts
+ * with the caller's own reason, or with `makeReason()` when `timeoutMs` passes. `body` owns its own cleanup, so the returned promise settles only when `body` does; a
+ * body that may ignore its signal wraps the wait it cannot trust in `raceAbort`. The caller's
+ * signal is only read, never changed. The timer is cleared on every outcome and is a normal
+ * (referenced) timer, so a pending wait keeps the process alive until its deadline.
+ */
+export declare function withSignalDeadline<T>(timeoutMs: number, caller: AbortSignal | undefined, makeReason: () => unknown, body: (signal: AbortSignal) => Promise<T>): Promise<T>;
 //# sourceMappingURL=deadline.d.ts.map

package/dist/internal/deadline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../../src/internal/deadline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC,CAcjE"}
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../../src/internal/deadline.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC,CAiBjE;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,OAAO,EACzB,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC,CAaZ"}