stitchkit 0.99.0 → 0.100.1

package/dist/{index-px2gm2jp.js → index-fhwqwxe0.js}

@@ -1,21 +1,17 @@
+import {
+  loadDarwinBinding
+} from "./index-zjjyynm3.js";
+
 // src/agent-runtime/contained-scan.ts
-import path3 from "node:path";
+import path2 from "node:path";
 
 // src/agent-runtime/contained-files.ts
 import { constants } from "node:fs";
 import { lstat, mkdir, open, readdir, realpath } from "node:fs/promises";
-import path2 from "node:path";
+import path from "node:path";
 
 // src/agent-runtime/contained-darwin.ts
-import {
-  close as closeDescriptor,
-  existsSync,
-  fstat,
-  read as readDescriptor
-} from "node:fs";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
+import { close as closeDescriptor, fstat, read as readDescriptor } from "node:fs";
 var FILE_TYPE_MASK = 61440;
 var FILE_TYPE_DIRECTORY = 16384;
 var FILE_TYPE_REGULAR = 32768;
@@ -23,40 +19,6 @@ var FILE_TYPE_SYMLINK = 40960;
 function modeIs(mode, type) {
   return (mode & FILE_TYPE_MASK) === type;
 }
-function hasFunctions(value, names) {
-  return typeof value === "object" && value !== null && names.every((name) => typeof Reflect.get(value, name) === "function");
-}
-var darwinBinding;
-function loadDarwinBinding() {
-  if (darwinBinding)
-    return darwinBinding;
-  const directory = path.dirname(fileURLToPath(import.meta.url));
-  const binary = `darwin-${process.arch}.node`;
-  const candidates = [
-    path.resolve(directory, "../native", binary),
-    path.resolve(directory, "../../native", binary)
-  ];
-  const selected = candidates.find((candidate) => existsSync(candidate));
-  if (!selected) {
-    throw new Error(`Contained filesystem operations need the packaged Darwin ${process.arch} backend`);
-  }
-  const loaded = createRequire(import.meta.url)(selected);
-  const methods = [
-    "openDirectoryAt",
-    "openFileAt",
-    "createFileAt",
-    "createDirectoryAt",
-    "statAt",
-    "listAt",
-    "renameAt",
-    "unlinkAt"
-  ];
-  if (!hasFunctions(loaded, methods)) {
-    throw new Error("The packaged Darwin contained-files backend has an invalid surface");
-  }
-  darwinBinding = loaded;
-  return darwinBinding;
-}
 
 class NumericFileHandle {
   fd;
@@ -110,7 +72,7 @@ async function openPinnedDirectory(absolute) {
   }
 }
 function safeSegments(relative) {
-  if (path2.isAbsolute(relative))
+  if (path.isAbsolute(relative))
     throw new Error("Contained paths must be relative");
   const segments = relative.split(/[\\/]/u);
   if (segments.length === 0 || segments.some((segment) => segment === "" || segment === "." || segment === "..")) {
@@ -122,13 +84,13 @@ async function openDirectoryAt(directory, name) {
   if (process.platform === "darwin") {
     return new NumericFileHandle(loadDarwinBinding().openDirectoryAt(directory.fd, name));
   }
-  return open(path2.join(descriptorPath(directory), name), constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
+  return open(path.join(descriptorPath(directory), name), constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
 }
 async function openFileAt(directory, name) {
   if (process.platform === "darwin") {
     return new NumericFileHandle(loadDarwinBinding().openFileAt(directory.fd, name));
   }
-  return open(path2.join(descriptorPath(directory), name), constants.O_RDONLY | constants.O_NOFOLLOW);
+  return open(path.join(descriptorPath(directory), name), constants.O_RDONLY | constants.O_NOFOLLOW);
 }
 function entryMetadata(mode, size) {
   return {
@@ -144,7 +106,7 @@ async function statAt(directory, name) {
     const metadata = loadDarwinBinding().statAt(directory.fd, name);
     return metadata ? entryMetadata(metadata.mode, metadata.size) : null;
   }
-  return lstat(path2.join(descriptorPath(directory), name)).catch((error) => {
+  return lstat(path.join(descriptorPath(directory), name)).catch((error) => {
     if (error.code === "ENOENT")
       return null;
     throw error;
@@ -176,7 +138,7 @@ async function listContainedDirectory(root, relative, maxEntries, authorizePath)
     const admitted = [];
     const denied = [];
     for (const entry of raw) {
-      const entryPath = relative === "." ? entry.name : path2.join(relative, entry.name);
+      const entryPath = relative === "." ? entry.name : path.join(relative, entry.name);
       if (authorizePath && !await authorizePath(entryPath)) {
         denied.push({ name: entry.name, kind: containedEntryKind(entry) });
         continue;
@@ -217,7 +179,7 @@ async function createDirectoryAt(directory, name) {
     return loadDarwinBinding().createDirectoryAt(directory.fd, name, 511);
   }
   try {
-    await mkdir(path2.join(descriptorPath(directory), name));
+    await mkdir(path.join(descriptorPath(directory), name));
     return true;
   } catch (error) {
     if (error.code === "EEXIST")
@@ -235,7 +197,7 @@ async function missingContainedDirectories(root, relative) {
     for (const segment of segments) {
       walked = [...walked, segment];
       if (missing.length > 0) {
-        missing.push(walked.join(path2.sep));
+        missing.push(walked.join(path.sep));
         continue;
       }
       const next = await openDirectoryAt(current, segment).catch((error) => {
@@ -244,7 +206,7 @@ async function missingContainedDirectories(root, relative) {
         throw error;
       });
       if (!next) {
-        missing.push(walked.join(path2.sep));
+        missing.push(walked.join(path.sep));
         continue;
       }
       await current.close();
@@ -373,7 +335,7 @@ async function scanContainedFiles(input) {
     const entries = [...await listAt(directory)];
     entries.sort((left, right) => left.name.localeCompare(right.name));
     for (const entry of entries) {
-      const relative = relativeDirectory ? path3.join(relativeDirectory, entry.name) : entry.name;
+      const relative = relativeDirectory ? path2.join(relativeDirectory, entry.name) : entry.name;
       const kind = entry.isDirectory() ? "directory" : entry.isSymbolicLink() ? "symlink" : entry.isFile() ? "file" : "other";
       if (kind === "file" && input.includeFile && !input.includeFile(relative))
         continue;
@@ -445,4 +407,4 @@ async function scanContainedFiles(input) {
   return { files, truncated, skippedDirectories, skippedSymlinks, denied, deniedTruncated };
 }
 
-export { loadDarwinBinding, NumericFileHandle, descriptorPath, listContainedDirectory, missingContainedDirectories, openContainedParent, openContainedFile, assertContainedFileCurrent, assertContainedParentCurrent, containedEntryMetadata, openContainedParentFile, readContainedUtf8Handle, walkContainedFiles, scanContainedFiles };
+export { NumericFileHandle, descriptorPath, listContainedDirectory, missingContainedDirectories, openContainedParent, openContainedFile, assertContainedFileCurrent, assertContainedParentCurrent, containedEntryMetadata, openContainedParentFile, readContainedUtf8Handle, walkContainedFiles, scanContainedFiles };

package/dist/{index-e4hkgm5t.js → index-gw8bmyaj.js}

@@ -5,14 +5,16 @@ import {
   containedEntryMetadata,
   descriptorPath,
   listContainedDirectory,
-  loadDarwinBinding,
   missingContainedDirectories,
   openContainedFile,
   openContainedParent,
   openContainedParentFile,
   readContainedUtf8Handle,
   scanContainedFiles
-} from "./index-px2gm2jp.js";
+} from "./index-fhwqwxe0.js";
+import {
+  loadDarwinBinding
+} from "./index-zjjyynm3.js";
 import {
   codingPathRefusal,
   codingRefusal,

package/dist/{index-p3vsv1fb.js → index-hadmp193.js}

@@ -2365,11 +2365,20 @@ function bindRealtimeServer(contract, handle, options = {}) {
           onRejected: options.onRejected,
           logger: options.logger
         });
-        handler({
-          raw,
-          events,
-          to: (room) => outbound(raw.to(room))
-        });
+        const failed = (error) => {
+          try {
+            raw.disconnect(true);
+          } catch {}
+          if (options.logger)
+            options.logger.error("Realtime connection handler failed", { error });
+          else
+            console.error("[stitchkit] realtime connection handler failed", error);
+        };
+        try {
+          Promise.resolve(handler({ raw, events, to: (room) => outbound(raw.to(room)) })).catch(failed);
+        } catch (error) {
+          failed(error);
+        }
       };
       handle.io.on("connection", listener);
       return () => {

package/dist/{index-wt743f7f.js → index-k6gpggb9.js}

@@ -175,6 +175,7 @@ function deltaWins(delta, value) {
 import { z as z2 } from "zod";
 var WatchKeySchema = z2.object({
   service: z2.string().min(1),
+  instance: z2.string().min(1).max(128).optional(),
   action: z2.string().min(1),
   digest: z2.string().min(1)
 }).strict().readonly();
@@ -221,7 +222,7 @@ var watchContract = {
   }
 };
 function watchKeyString(key) {
-  return `${key.service}/${key.action}/${key.digest}`;
+  return `${key.service}/${key.action}/${key.digest}${key.instance === undefined ? "" : `/${encodeURIComponent(key.instance)}`}`;
 }
 
 export { WatchDeltaSchema, WatchArrayOpSchema, diff, apply, deltaWins, WatchKeySchema, WatchHaveSchema, WatchValueSchema, WatchStateSchema, WATCH_OPEN, WATCH_CLOSE, WATCH_VALUE, WATCH_STATE, watchContract, watchKeyString };

package/dist/index-q3pyb9n0.js

@@ -0,0 +1,22 @@
+// src/internal/mutation-queue.ts
+function createMutationQueue(maxPending = Number.POSITIVE_INFINITY) {
+  if (maxPending !== Number.POSITIVE_INFINITY && (!Number.isInteger(maxPending) || maxPending < 1)) {
+    throw new RangeError("maxPending must be a positive integer");
+  }
+  let tail = Promise.resolve();
+  let pending = 0;
+  return (mutation) => {
+    if (pending >= maxPending)
+      return Promise.reject(new Error("Mutation queue capacity exceeded"));
+    pending += 1;
+    const result = tail.then(mutation, mutation);
+    tail = result.then(() => {
+      pending -= 1;
+    }, () => {
+      pending -= 1;
+    });
+    return result;
+  };
+}
+
+export { createMutationQueue };

package/dist/{index-wsm5w4ee.js → index-vqr7f7v8.js}

@@ -19,7 +19,7 @@ import {
   canonicalAgentJson,
   decodeAgentConversationArchive,
   encodeAgentConversationArchive
-} from "./index-gxrt5h6v.js";
+} from "./index-cyktc4bp.js";
 import {
   AgentMessageSchema,
   AgentRecordIdSchema,
@@ -427,6 +427,52 @@ async function importConversation(driver, bytes) {
   });
 }
 
+// src/agent-runtime/store-event-once.ts
+import { createHash } from "node:crypto";
+function eventOnceId(conversationId, kind, key) {
+  if (!key)
+    throw new TypeError("Event admission key must not be empty");
+  return createHash("sha256").update(JSON.stringify([conversationId, kind, key])).digest("hex");
+}
+async function findEvent(driver, transaction, conversationId, eventId) {
+  if (driver.events.find)
+    return driver.events.find(transaction, { conversationId, eventId });
+  let fromSeq;
+  do {
+    const page = await driver.events.list(transaction, {
+      conversationId,
+      fromSeq,
+      limit: 1e4
+    });
+    const found = page.items.find((event) => event.eventId === eventId);
+    if (found)
+      return found;
+    fromSeq = page.nextSeq;
+  } while (fromSeq !== undefined);
+  return;
+}
+function appendEventOnce(driver, input, key) {
+  const parsed = AppendAgentStoreEventSchema.parse(input);
+  const eventId = eventOnceId(parsed.conversationId, parsed.kind, key);
+  return driver.transaction(async (transaction) => {
+    if (await driver.conversations?.isPurged(transaction, parsed.conversationId)) {
+      throw new AgentConversationPurgedError;
+    }
+    const previous = await findEvent(driver, transaction, parsed.conversationId, eventId);
+    if (previous)
+      return { outcome: "duplicate", event: previous };
+    const event = await driver.events.append(transaction, {
+      ...agentStoreEventDraft(parsed),
+      eventId
+    });
+    return { outcome: "applied", event };
+  });
+}
+function findEventOnce(driver, input) {
+  const eventId = eventOnceId(input.conversationId, input.kind, input.key);
+  return driver.transaction((transaction) => findEvent(driver, transaction, input.conversationId, eventId), { access: "read" });
+}
+
 // src/agent-runtime/store-mutate.ts
 import { z as z4 } from "zod";
 
@@ -453,7 +499,7 @@ function applied(current, input, effects) {
 }
 
 // src/agent-runtime/store-reducer.ts
-import { createHash } from "node:crypto";
+import { createHash as createHash2 } from "node:crypto";
 
 // src/agent-runtime/store-reduce-history.ts
 function reduceAccept(current, input) {
@@ -737,7 +783,7 @@ function transitionRecord(operation) {
       assistant: {
         id: assistant.id,
         status: assistant.status,
-        sha256: createHash("sha256").update(body).digest("hex"),
+        sha256: createHash2("sha256").update(body).digest("hex"),
         parts: assistant.parts.length,
         bytes: Buffer.byteLength(body)
       }
@@ -979,6 +1025,8 @@ function createAgentRuntimeStore(driver) {
     loadSnapshot: (conversationId) => loadSnapshot(driver, conversationId),
     loadRun: (input) => loadRun(driver, input),
     listActiveRuns: (conversationId) => listActiveRuns(driver, conversationId),
+    appendEventOnce: (input, key) => appendEventOnce(driver, input, key),
+    findEventOnce: (input) => findEventOnce(driver, input),
     appendEvent: (input) => appendEvent(driver, input),
     readEvents: (input) => readEvents(driver, input),
     exportConversation: (conversationId) => exportConversation(driver, conversationId),

package/dist/index-zjjyynm3.js

@@ -0,0 +1,42 @@
+// src/internal/darwin-binding.ts
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+function hasFunctions(value, names) {
+  return typeof value === "object" && value !== null && names.every((name) => typeof Reflect.get(value, name) === "function");
+}
+var darwinBinding;
+function loadDarwinBinding() {
+  if (darwinBinding)
+    return darwinBinding;
+  const directory = path.dirname(fileURLToPath(import.meta.url));
+  const binary = `darwin-${process.arch}.node`;
+  const candidates = [
+    path.resolve(directory, "../native", binary),
+    path.resolve(directory, "../../native", binary)
+  ];
+  const selected = candidates.find((candidate) => existsSync(candidate));
+  if (!selected) {
+    throw new Error(`Contained filesystem operations need the packaged Darwin ${process.arch} backend`);
+  }
+  const loaded = createRequire(import.meta.url)(selected);
+  const methods = [
+    "openDirectoryAt",
+    "openFileAt",
+    "createFileAt",
+    "createDirectoryAt",
+    "statAt",
+    "listAt",
+    "renameAt",
+    "unlinkAt",
+    "processIdentity"
+  ];
+  if (!hasFunctions(loaded, methods)) {
+    throw new Error("The packaged Darwin contained-files backend has an invalid surface");
+  }
+  darwinBinding = loaded;
+  return darwinBinding;
+}
+
+export { loadDarwinBinding };

package/dist/internal/coalesced-task.d.ts

@@ -0,0 +1,17 @@
+import { type BackoffPolicy } from './backoff.js';
+export interface CoalescedTask {
+    readonly running: boolean;
+    /** A trigger arrived that no pass has served yet. */
+    readonly pending: boolean;
+    trigger(): void;
+    pauseRetry(): void;
+    close(): void;
+}
+/** One job per key; hints during work become one trailing pass, failures retain retry. */
+export declare function createCoalescedTask(config: {
+    run(): Promise<void>;
+    active(): boolean;
+    onError(error: unknown): void;
+    backoff: BackoffPolicy;
+}): CoalescedTask;
+//# sourceMappingURL=coalesced-task.d.ts.map

package/dist/internal/coalesced-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coalesced-task.d.ts","sourceRoot":"","sources":["../../src/internal/coalesced-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,WAAW,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,IAAI,IAAI,CAAC;IAChB,UAAU,IAAI,IAAI,CAAC;IACnB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,MAAM,IAAI,OAAO,CAAC;IAClB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,aAAa,CAAC;CACxB,GAAG,aAAa,CAuDhB"}

package/dist/internal/darwin-binding.d.ts

@@ -0,0 +1,19 @@
+export interface DarwinEntry {
+    name: string;
+    mode: number;
+    size: number;
+}
+export interface DarwinBinding {
+    processIdentity(pid: number): unknown;
+    openDirectoryAt(directory: number, name: string): number;
+    openFileAt(directory: number, name: string): number;
+    createFileAt(directory: number, name: string, mode: number): number;
+    createDirectoryAt(directory: number, name: string, mode: number): boolean;
+    statAt(directory: number, name: string): Omit<DarwinEntry, 'name'> | null;
+    listAt(directory: number): readonly DarwinEntry[];
+    renameAt(directory: number, source: string, target: string): void;
+    unlinkAt(directory: number, name: string): void;
+}
+export declare function hasFunctions(value: unknown, names: readonly string[]): boolean;
+export declare function loadDarwinBinding(): DarwinBinding;
+//# sourceMappingURL=darwin-binding.d.ts.map

package/dist/internal/darwin-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"darwin-binding.d.ts","sourceRoot":"","sources":["../../src/internal/darwin-binding.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACzD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACpD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACpE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC1E,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACjD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAM9E;AAID,wBAAgB,iBAAiB,IAAI,aAAa,CAgCjD"}

package/dist/internal/exclusive-lock.d.ts

@@ -1,15 +1,27 @@
+import { z } from 'zod';
+import { type ProcessOwnerEvidence } from './process-instance.js';
 /** Who holds a lock, as its file records it. */
-export interface ExclusiveLockOwner {
-    readonly pid: number;
-    readonly host: string;
-    readonly acquiredAt: string;
-    /** Stable machine identity; absent where the platform offers none, and in older locks. */
-    readonly machine?: string;
-}
+declare const ExclusiveLockOwnerSchema: z.ZodObject<{
+    pid: z.ZodNumber;
+    host: z.ZodString;
+    acquiredAt: z.ZodString;
+    machine: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    process: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        platform: z.ZodEnum<{
+            darwin: "darwin";
+            linux: "linux";
+        }>;
+        bootId: z.ZodString;
+        namespace: z.ZodString;
+        startId: z.ZodString;
+    }, z.core.$strict>>>>;
+}, z.core.$strip>;
+export type ExclusiveLockOwner = z.infer<typeof ExclusiveLockOwnerSchema>;
 /** Why a present lock was not taken. */
 export interface ExclusiveLockDiagnosis {
     readonly attribution: 'this-machine' | 'another-machine' | 'unattributable';
     readonly liveness: 'alive' | 'gone' | 'not-probed';
+    readonly identity?: ProcessOwnerEvidence['identity'];
     readonly owner: ExclusiveLockOwner | null;
 }
 /** A lock this process holds. */
@@ -48,4 +60,5 @@ export type ExclusiveLockAttempt = {
 export declare function attemptExclusiveLock(path: string, options: ExclusiveLockAttemptOptions): Promise<ExclusiveLockAttempt>;
 /** Read the owner a present lock records, for a refusal that has to name it. */
 export declare function readExclusiveLockOwner(path: string): Promise<ExclusiveLockOwner | null>;
+export {};
 //# sourceMappingURL=exclusive-lock.d.ts.map

package/dist/internal/exclusive-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exclusive-lock.d.ts","sourceRoot":"","sources":["../../src/internal/exclusive-lock.ts"],"names":[],"mappings":"AA8BA,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wCAAwC;AACxC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;IAC5E,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC3C;AAED,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,uFAAuF;IACvF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACpC;IACE,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,CAAC;CAC7C,CAAC;AAsLN;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AAED,gFAAgF;AAChF,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAEpC"}
+{"version":3,"file":"exclusive-lock.d.ts","sourceRoot":"","sources":["../../src/internal/exclusive-lock.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,KAAK,oBAAoB,EAG1B,MAAM,oBAAoB,CAAC;AAK5B,gDAAgD;AAChD,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;iBAO5B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,wCAAwC;AACxC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;IAC5E,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC3C;AAED,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,uFAAuF;IACvF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACpC;IACE,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,CAAC;CAC7C,CAAC;AAmLN;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AAED,gFAAgF;AAChF,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAEpC"}

package/dist/internal/mutation-queue.d.ts

@@ -0,0 +1,4 @@
+/** FIFO mutations with caller-visible failures and an optional finite admission bound. */
+export type MutationQueue = <T>(mutation: () => Promise<T>) => Promise<T>;
+export declare function createMutationQueue(maxPending?: number): MutationQueue;
+//# sourceMappingURL=mutation-queue.d.ts.map

package/dist/internal/mutation-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-queue.d.ts","sourceRoot":"","sources":["../../src/internal/mutation-queue.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE1E,wBAAgB,mBAAmB,CAAC,UAAU,SAA2B,GAAG,aAAa,CAwBxF"}

package/dist/internal/process-identity.d.ts

@@ -29,7 +29,7 @@ export declare function machineIdentity(declared: string | undefined): Promise<s
  * carries the ordinary doubt about reuse. Found by a consuming application, which measured `Z` and a
  * successful signal on both platforms of its fleet. → ADR 0147.
  */
-export declare function probeLiveness(pid: number): Promise<'alive' | 'gone'>;
+export declare function probeLiveness(pid: number, reach?: (target: number) => true): Promise<'alive' | 'gone'>;
 /**
  * The state letter of a pid, or `null` where this platform will not say.
  *

package/dist/internal/process-identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-identity.d.ts","sourceRoot":"","sources":["../../src/internal/process-identity.ts"],"names":[],"mappings":"AA8CA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,SAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBtF;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW1F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAY1E;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,OAAO,CAAC,CAuBlB"}
+{"version":3,"file":"process-identity.d.ts","sourceRoot":"","sources":["../../src/internal/process-identity.ts"],"names":[],"mappings":"AA8CA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,SAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBtF;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW1F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,YAAY,MAAM,SAA4B,GAClD,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAY3B;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,OAAO,CAAC,CAuBlB"}

package/dist/internal/process-instance.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { probeLiveness } from './process-identity.js';
+export declare const ProcessInstanceSchema: z.ZodObject<{
+    platform: z.ZodEnum<{
+        darwin: "darwin";
+        linux: "linux";
+    }>;
+    bootId: z.ZodString;
+    namespace: z.ZodString;
+    startId: z.ZodString;
+}, z.core.$strict>;
+export type ProcessInstance = z.infer<typeof ProcessInstanceSchema>;
+/** /proc stat field 22 follows a command name that may itself contain spaces and parentheses. */
+export declare function linuxProcessStart(stat: string, pid: number): string | null;
+/** @internal procRoot permits kernel-format fixtures without changing a real process or boot. */
+export declare function readProcessInstance(pid: number, procRoot?: string): Promise<ProcessInstance | null>;
+export interface ProcessOwnerEvidence {
+    readonly liveness: 'alive' | 'gone' | 'not-probed';
+    readonly identity: 'matched' | 'different-boot' | 'reused-pid' | 'pid-gone' | 'legacy' | 'unavailable';
+}
+/** Compare identities only inside one machine (the caller establishes that boundary). */
+export declare function probeProcessOwner(pid: number, recorded: ProcessInstance | null | undefined, probes?: {
+    read: typeof readProcessInstance;
+    liveness: typeof probeLiveness;
+}): Promise<ProcessOwnerEvidence>;
+//# sourceMappingURL=process-instance.d.ts.map

package/dist/internal/process-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-instance.d.ts","sourceRoot":"","sources":["../../src/internal/process-instance.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAO,MAAM,qBAAqB;;;;;;;;kBAOvB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS1E;AAED,iGAAiG;AACjG,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,QAAQ,SAAU,GACjB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA6CjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;IACnD,QAAQ,CAAC,QAAQ,EACb,SAAS,GACT,gBAAgB,GAChB,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,aAAa,CAAC;CACnB;AAED,yFAAyF;AACzF,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC5C,MAAM;IAAK,IAAI;IAAuB,QAAQ;CAAiB,GAC9D,OAAO,CAAC,oBAAoB,CAAC,CAyB/B"}

package/dist/internal/with-exclusive-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-exclusive-lock.d.ts","sourceRoot":"","sources":["../../src/internal/with-exclusive-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEjF,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,4CAA4C;AAC5C,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,qEAAqE;AACrE,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IALnC,IAAI,SAAwB;IACrC,YACW,IAAI,EAAE,cAAc,GAAG,cAAc,EACrC,KAAK,EAAE,MAAM;IACtB,wFAAwF;IAC/E,MAAM,EAAE,kBAAkB,GAAG,IAAI,EAC1C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAG9B;CACF;AAkCD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC5C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,CAAC,CAAC,CAwDZ"}
+{"version":3,"file":"with-exclusive-lock.d.ts","sourceRoot":"","sources":["../../src/internal/with-exclusive-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,4CAA4C;AAC5C,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,qEAAqE;AACrE,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IALnC,IAAI,SAAwB;IACrC,YACW,IAAI,EAAE,cAAc,GAAG,cAAc,EACrC,KAAK,EAAE,MAAM;IACtB,wFAAwF;IAC/E,MAAM,EAAE,kBAAkB,GAAG,IAAI,EAC1C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAG9B;CACF;AAyCD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC5C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,CAAC,CAAC,CAwDZ"}

package/dist/live/watch-client-state.d.ts

@@ -0,0 +1,71 @@
+import type { WatchClientConfig, WatchListeners } from './watch-client.js';
+import { type WatchKey, type WatchStateFrame, type WatchValueFrame } from './watch-contract.js';
+type Listeners<T> = WatchListeners<T>;
+export interface WatchClientEntry {
+    epoch: number;
+    released: boolean;
+    readonly key: WatchKey;
+    readonly args: Record<string, unknown>;
+    readonly listeners: Set<Listeners<unknown>>;
+    revision: number;
+    value?: unknown;
+    hasValue: boolean;
+    /**
+     * The server's identity for the value held, carried back on the next `open`.
+     *
+     * Kept rather than recomputed so that what is offered is what the server
+     * actually said, not this client's opinion of the value it built — if those
+     * two ever disagree, offering the recomputed one would hide the disagreement
+     * and offering the server's one surfaces it as a difference that will not
+     * apply.
+     */
+    fingerprint?: string;
+    /**
+     * Whether the **current** connection has been told about this key.
+     *
+     * On the entry rather than on a handle: two handles asking one question share
+     * a subscription, so the second must not send a second `open` — and a
+     * reconnect has to clear it for both.
+     */
+    opened: boolean;
+    /**
+     * Whether a value frame has answered the latest `open`.
+     *
+     * A revision is a counter of one hub's life of the key, so it orders frames
+     * within one open and says nothing across two: a restarted API starts at 1
+     * again. Until the first answer to an open arrives, the held revision is not
+     * a floor — without this, a client that held revision 40 from the previous
+     * process dropped every full value of the new one as "no newer" until its
+     * counter passed 40, while showing itself live.
+     */
+    answered: boolean;
+    state: WatchStateFrame;
+    release?: ReturnType<typeof setTimeout>;
+}
+export declare function publishState(entry: WatchClientEntry, state: WatchStateFrame): void;
+/**
+ * Tell the server about a key, and turn every way that can fail into a state.
+ *
+ * Nothing here rejects. It runs from a subscribe and from a reconnect, neither
+ * of which has anywhere to put a rejected promise — and a disconnected socket
+ * rejects the request, which is exactly the moment this runs. An unhandled
+ * rejection in a console is also the one outcome that tells the subscriber
+ * nothing at all.
+ */
+export declare function openWatch(config: WatchClientConfig, openTimeoutMs: number, entry: WatchClientEntry): Promise<void>;
+/**
+ * What one value frame does to an entry: a new value, a confirmation of the
+ * held one, a late answer to drop, or a reason the key has to start over.
+ * The entry's revision, value and fingerprint move here and nowhere else.
+ */
+export declare function applyWatchFrame(entry: WatchClientEntry, frame: WatchValueFrame): {
+    kind: 'value';
+    value: unknown;
+} | {
+    kind: 'confirmed' | 'stale';
+} | {
+    kind: 'resync';
+    message: string;
+};
+export {};
+//# sourceMappingURL=watch-client-state.d.ts.map

package/dist/live/watch-client-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-client-state.d.ts","sourceRoot":"","sources":["../../src/live/watch-client-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAG1B,KAAK,SAAS,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;;;;;OASG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CACzC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAGlF;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAsDf;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,eAAe,GAEpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA2DtC"}

package/dist/live/watch-client.d.ts

@@ -1,3 +1,4 @@
+import type { SessionOperation } from '../browser/session.js';
 /**
  * The client half of a watched read.
  *
@@ -44,7 +45,7 @@
  * sense a rendering component can use.
  */
 import type { ContractDef, EndpointDef } from '../contract/define.js';
-import { WATCH_CLOSE, WATCH_OPEN, WATCH_STATE, WATCH_VALUE, type WatchHave, type WatchKey, type WatchStateFrame, type WatchValueFrame } from './watch-contract.js';
+import { WATCH_CLOSE, type WATCH_OPEN, WATCH_STATE, WATCH_VALUE, type WatchHave, type WatchKey, type WatchStateFrame, type WatchValueFrame } from './watch-contract.js';
 export interface WatchListeners<TValue> {
     value(value: TValue): void;
     /** Phase and, when unhealthy, the read's own code and message. */
@@ -125,6 +126,9 @@ export interface WatchTransport {
     onConnectionChange(listener: (connected: boolean, reason?: string) => void): () => void;
 }
 export interface WatchClientConfig {
+    readonly session?: SessionOperation<unknown>;
+    readonly maxKeys?: number;
+    readonly maxListenersPerKey?: number;
     readonly transport: WatchTransport;
     /** How long a key's value is retained after its last subscriber. Default 0. */
     readonly holdMs?: number;