@finalai/agents 0.8.0

package/dist/modules/agent-client/collection-events.mjs

@@ -0,0 +1,142 @@
+import {
+  agentRealtimeFrameSchema,
+  AgentRealtimeFrameType,
+  parseAgentRealtimeEvent
+} from "@finalai/agent-protocol/agent-platform";
+import { createAsyncQueue, failOnAbort } from "./async-queue.mjs";
+import {
+  isRetryableClientError,
+  isTerminalRealtimeError,
+  realtimeSubscriptionError
+} from "./errors.mjs";
+var CollectionEventKind = /* @__PURE__ */ ((CollectionEventKind2) => {
+  CollectionEventKind2["Resync"] = "collection.resync";
+  return CollectionEventKind2;
+})(CollectionEventKind || {});
+var CollectionResyncReason = /* @__PURE__ */ ((CollectionResyncReason2) => {
+  CollectionResyncReason2["Subscribed"] = "subscribed";
+  CollectionResyncReason2["ResyncRequired"] = "resync_required";
+  CollectionResyncReason2["Degraded"] = "degraded";
+  return CollectionResyncReason2;
+})(CollectionResyncReason || {});
+const MAX_LOOKUP_RETRY_MS = 3e4;
+const streamCollectionEvents = (args) => {
+  const follow = args.options?.follow ?? true;
+  const controller = new AbortController();
+  const signal = AbortSignal.any([
+    controller.signal,
+    args.context.closeSignal,
+    ...args.options?.signal == null ? [] : [args.options.signal]
+  ]);
+  let unsubscribe = null;
+  let pollTimer = null;
+  let lookupTimer = null;
+  const clearPoll = () => {
+    if (pollTimer != null) clearTimeout(pollTimer);
+    pollTimer = null;
+  };
+  let detachAbort = () => {
+  };
+  let detachClose = () => {
+  };
+  const queue = createAsyncQueue(() => {
+    controller.abort();
+    clearPoll();
+    if (lookupTimer != null) clearTimeout(lookupTimer);
+    unsubscribe?.();
+    detachAbort();
+    detachClose();
+  });
+  const resync = (topic, reason) => {
+    queue.push({ kind: "collection.resync" /* Resync */, topic, reason });
+    if (!follow) queue.end();
+  };
+  const degrade = (topic) => {
+    if (pollTimer != null || queue.closed()) return;
+    resync(topic, "degraded" /* Degraded */);
+    if (!follow || queue.closed()) return;
+    pollTimer = setTimeout(() => {
+      pollTimer = null;
+      degrade(topic);
+    }, args.context.timing.conversationPollIntervalMs);
+  };
+  const onFrame = (topic) => (raw) => {
+    const frame = agentRealtimeFrameSchema.safeParse(raw);
+    if (!frame.success || queue.closed()) return;
+    switch (frame.data.type) {
+      case AgentRealtimeFrameType.Event: {
+        const envelope = frame.data;
+        queue.push({
+          ...parseAgentRealtimeEvent(envelope),
+          topic: envelope.topic,
+          cursor: envelope.cursor,
+          createdAt: envelope.createdAt,
+          replayed: false
+        });
+        return;
+      }
+      case AgentRealtimeFrameType.Subscribed:
+        clearPoll();
+        resync(topic, "subscribed" /* Subscribed */);
+        return;
+      case AgentRealtimeFrameType.ResyncRequired:
+        resync(topic, "resync_required" /* ResyncRequired */);
+        return;
+      case AgentRealtimeFrameType.Error:
+        if (isTerminalRealtimeError(frame.data)) {
+          queue.fail(
+            realtimeSubscriptionError({
+              topic: frame.data.topic ?? topic,
+              code: frame.data.code ?? "unknown",
+              message: frame.data.message ?? "Realtime subscription was refused"
+            })
+          );
+          return;
+        }
+        degrade(topic);
+        return;
+      default:
+        return;
+    }
+  };
+  detachAbort = failOnAbort(queue, signal);
+  detachClose = failOnAbort(queue, args.context.closeSignal);
+  const userId = args.options?.userId;
+  let lookupFailures = 0;
+  const start = () => {
+    lookupTimer = null;
+    if (queue.closed()) return;
+    const topic = userId != null ? Promise.resolve(args.topicFor(userId)) : args.collection != null && args.context.realtimeCollectionTopic != null ? args.context.realtimeCollectionTopic(args.collection) : args.context.realtimeUserId().then(args.topicFor);
+    void topic.then(
+      (topic2) => {
+        if (queue.closed()) return;
+        const stop = args.context.realtime().subscribe(topic2, onFrame(topic2));
+        if (queue.closed()) stop();
+        else unsubscribe = stop;
+      },
+      (cause) => {
+        if (queue.closed()) return;
+        if (!isRetryableClientError(cause)) {
+          queue.fail(cause);
+          return;
+        }
+        resync(null, "degraded" /* Degraded */);
+        if (queue.closed()) return;
+        const delay = Math.min(
+          MAX_LOOKUP_RETRY_MS,
+          args.context.timing.conversationPollIntervalMs * 2 ** lookupFailures
+        );
+        lookupFailures += 1;
+        lookupTimer = setTimeout(start, delay);
+      }
+    );
+  };
+  start();
+  return queue.iterator;
+};
+export {
+  CollectionEventKind,
+  CollectionResyncReason,
+  streamCollectionEvents
+};
+//# sourceMappingURL=collection-events.mjs.map

package/dist/modules/agent-client/collection-events.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/collection-events.ts"],
+  "sourcesContent": ["import {\n  agentRealtimeFrameSchema,\n  AgentRealtimeFrameType,\n  parseAgentRealtimeEvent,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createAsyncQueue, failOnAbort } from \"./async-queue.mjs\";\nimport type { ClientCollection, ClientContextIface, SignalOptionsIface } from \"./context.mjs\";\nimport type { ConversationEvent } from \"./conversations.mjs\";\nimport {\n  isRetryableClientError,\n  isTerminalRealtimeError,\n  realtimeSubscriptionError,\n} from \"./errors.mjs\";\nimport type { RealtimeTransportFrameIface } from \"./realtime.mjs\";\n\n// The caller's collection topics (`user.collection:<userId>:conversations` and\n// `:pending`). They carry no replay, so a stream says when the\n// caller must re-read the collection over HTTP: on every (re)subscription and\n// resync, and while the realtime transport reports errors.\n\nexport enum CollectionEventKind {\n  /** Re-read the collection (`conversations.list()`, `pending.mine()`); events may have been missed. */\n  Resync = 'collection.resync',\n}\n\nexport enum CollectionResyncReason {\n  Subscribed = 'subscribed',\n  ResyncRequired = 'resync_required',\n  /** The realtime transport is down; repeated every `timing.conversationPollIntervalMs`. */\n  Degraded = 'degraded',\n}\n\nexport interface CollectionResyncEventIface {\n  kind: CollectionEventKind.Resync;\n  /** Null while the signed-in user, and so the topic, could not be read yet. */\n  topic: string | null;\n  reason: CollectionResyncReason;\n}\n\n/** A realtime event of the collection topic, or a cue to re-read the collection. */\nexport type CollectionEvent = ConversationEvent | CollectionResyncEventIface;\n\nexport interface CollectionEventsOptionsIface extends SignalOptionsIface {\n  /** Keep streaming; false ends after the first resync. Defaults to true. */\n  follow?: boolean;\n  /**\n   * The signed-in user the topics are keyed by. Defaults to the user of a\n   * minted realtime session (`realtime.createSession()`).\n   */\n  userId?: string;\n}\n\nconst MAX_LOOKUP_RETRY_MS = 30_000;\n\nexport const streamCollectionEvents = (args: {\n  context: ClientContextIface;\n  topicFor: (userId: string) => string;\n  collection?: ClientCollection;\n  options: CollectionEventsOptionsIface | undefined;\n}): AsyncIterableIterator<CollectionEvent> => {\n  const follow = args.options?.follow ?? true;\n  const controller = new AbortController();\n  const signal = AbortSignal.any([\n    controller.signal,\n    args.context.closeSignal,\n    ...(args.options?.signal == null ? [] : [args.options.signal]),\n  ]);\n  let unsubscribe: (() => void) | null = null;\n  let pollTimer: ReturnType<typeof setTimeout> | null = null;\n  let lookupTimer: ReturnType<typeof setTimeout> | null = null;\n  const clearPoll = (): void => {\n    if (pollTimer != null) clearTimeout(pollTimer);\n    pollTimer = null;\n  };\n  let detachAbort: () => void = () => {};\n  let detachClose: () => void = () => {};\n  const queue = createAsyncQueue<CollectionEvent>(() => {\n    controller.abort();\n    clearPoll();\n    if (lookupTimer != null) clearTimeout(lookupTimer);\n    unsubscribe?.();\n    detachAbort();\n    detachClose();\n  });\n\n  const resync = (topic: string | null, reason: CollectionResyncReason): void => {\n    queue.push({ kind: CollectionEventKind.Resync, topic, reason });\n    if (!follow) queue.end();\n  };\n\n  const degrade = (topic: string): void => {\n    if (pollTimer != null || queue.closed()) return;\n    resync(topic, CollectionResyncReason.Degraded);\n    if (!follow || queue.closed()) return;\n    pollTimer = setTimeout(() => {\n      pollTimer = null;\n      degrade(topic);\n    }, args.context.timing.conversationPollIntervalMs);\n  };\n\n  const onFrame =\n    (topic: string) =>\n    (raw: RealtimeTransportFrameIface): void => {\n      const frame = agentRealtimeFrameSchema.safeParse(raw);\n      if (!frame.success || queue.closed()) return;\n      switch (frame.data.type) {\n        case AgentRealtimeFrameType.Event: {\n          const envelope = frame.data;\n          queue.push({\n            ...parseAgentRealtimeEvent(envelope),\n            topic: envelope.topic,\n            cursor: envelope.cursor,\n            createdAt: envelope.createdAt,\n            replayed: false,\n          });\n          return;\n        }\n        case AgentRealtimeFrameType.Subscribed:\n          clearPoll();\n          resync(topic, CollectionResyncReason.Subscribed);\n          return;\n        case AgentRealtimeFrameType.ResyncRequired:\n          resync(topic, CollectionResyncReason.ResyncRequired);\n          return;\n        case AgentRealtimeFrameType.Error:\n          if (isTerminalRealtimeError(frame.data)) {\n            queue.fail(\n              realtimeSubscriptionError({\n                topic: frame.data.topic ?? topic,\n                code: frame.data.code ?? 'unknown',\n                message: frame.data.message ?? 'Realtime subscription was refused',\n              }),\n            );\n            return;\n          }\n          // The transport resubscribes; until then the caller re-reads periodically.\n          degrade(topic);\n          return;\n        default:\n          return;\n      }\n    };\n\n  detachAbort = failOnAbort(queue, signal);\n  detachClose = failOnAbort(queue, args.context.closeSignal);\n  const userId = args.options?.userId;\n  let lookupFailures = 0;\n  const start = (): void => {\n    lookupTimer = null;\n    if (queue.closed()) return;\n    const topic =\n      userId != null\n        ? Promise.resolve(args.topicFor(userId))\n        : args.collection != null && args.context.realtimeCollectionTopic != null\n          ? args.context.realtimeCollectionTopic(args.collection)\n          : args.context.realtimeUserId().then(args.topicFor);\n    void topic.then(\n      (topic) => {\n        if (queue.closed()) return;\n        const stop = args.context.realtime().subscribe(topic, onFrame(topic));\n        if (queue.closed()) stop();\n        else unsubscribe = stop;\n      },\n      (cause: unknown) => {\n        if (queue.closed()) return;\n        if (!isRetryableClientError(cause)) {\n          queue.fail(cause);\n          return;\n        }\n        // The user lookup is unreachable: the caller re-reads meanwhile, and it is retried.\n        resync(null, CollectionResyncReason.Degraded);\n        if (queue.closed()) return;\n        const delay = Math.min(\n          MAX_LOOKUP_RETRY_MS,\n          args.context.timing.conversationPollIntervalMs * 2 ** lookupFailures,\n        );\n        lookupFailures += 1;\n        lookupTimer = setTimeout(start, delay);\n      },\n    );\n  };\n  start();\n  return queue.iterator;\n};\n"],
+  "mappings": "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",
+  "names": ["CollectionEventKind", "CollectionResyncReason", "topic"]
+}

package/dist/modules/agent-client/config-options.d.mts

@@ -0,0 +1,24 @@
+import type { AgentSessionIface } from '@finalai/agent-protocol/agent-platform';
+export type SessionConfigOptionIface = AgentSessionIface['configOptions'][number];
+/** ACP's semantic categories (UX only); harnesses may add their own. */
+export declare enum ConfigOptionCategory {
+    Mode = "mode",
+    Model = "model",
+    ThoughtLevel = "thought_level"
+}
+export interface ConfigSelectChoiceIface {
+    value: string;
+    name: string;
+}
+/** A single-value selector: `setConfigOption({ configId, value })` with one of `choices`. */
+export interface ConfigSelectIface {
+    configId: string;
+    name: string;
+    category: string | null;
+    currentValue: string;
+    choices: ConfigSelectChoiceIface[];
+}
+/** The select options among a session's config options (booleans and unknown types skipped). */
+export declare const configSelectsOf: (configOptions: readonly SessionConfigOptionIface[]) => ConfigSelectIface[];
+/** The first select of a category (`model`, `thought_level`), if the harness advertises one. */
+export declare const configSelectFor: (configOptions: readonly SessionConfigOptionIface[], category: ConfigOptionCategory | string) => ConfigSelectIface | null;

package/dist/modules/agent-client/config-options.mjs

@@ -0,0 +1,49 @@
+import * as z from "zod";
+var ConfigOptionCategory = /* @__PURE__ */ ((ConfigOptionCategory2) => {
+  ConfigOptionCategory2["Mode"] = "mode";
+  ConfigOptionCategory2["Model"] = "model";
+  ConfigOptionCategory2["ThoughtLevel"] = "thought_level";
+  return ConfigOptionCategory2;
+})(ConfigOptionCategory || {});
+const choiceSchema = z.looseObject({ value: z.string(), name: z.string().optional() });
+const groupSchema = z.looseObject({ options: z.array(choiceSchema) });
+const selectSchema = z.looseObject({
+  type: z.string().optional(),
+  configId: z.string().optional(),
+  id: z.string().optional(),
+  name: z.string().optional(),
+  category: z.string().nullish(),
+  currentValue: z.string(),
+  options: z.array(z.union([choiceSchema, groupSchema]))
+});
+const configSelectsOf = (configOptions) => configOptions.flatMap((option) => {
+  const parsed = selectSchema.safeParse(option);
+  if (!parsed.success) return [];
+  const select = parsed.data;
+  const configId = select.configId ?? select.id;
+  if (configId == null || select.type != null && select.type !== "select") return [];
+  const choices = select.options.flatMap((entry) => {
+    const single = choiceSchema.safeParse(entry);
+    if (single.success) return [single.data];
+    return groupSchema.safeParse(entry).data?.options ?? [];
+  });
+  return [
+    {
+      configId,
+      name: select.name ?? configId,
+      category: select.category ?? null,
+      currentValue: select.currentValue,
+      choices: choices.map((choice) => ({
+        value: choice.value,
+        name: choice.name ?? choice.value
+      }))
+    }
+  ];
+});
+const configSelectFor = (configOptions, category) => configSelectsOf(configOptions).find((select) => select.category === category) ?? null;
+export {
+  ConfigOptionCategory,
+  configSelectFor,
+  configSelectsOf
+};
+//# sourceMappingURL=config-options.mjs.map

package/dist/modules/agent-client/config-options.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/config-options.ts"],
+  "sourcesContent": ["import type { AgentSessionIface } from '@finalai/agent-protocol/agent-platform';\nimport * as z from 'zod';\n\n// ACP session config options as a session's harness advertises them\n// (`AgentSessionIface.configOptions`), read as pickers: what the model picker\n// and the reasoning picker render, and what `setConfigOption` takes.\n\nexport type SessionConfigOptionIface = AgentSessionIface['configOptions'][number];\n\n/** ACP's semantic categories (UX only); harnesses may add their own. */\nexport enum ConfigOptionCategory {\n  Mode = 'mode',\n  Model = 'model',\n  ThoughtLevel = 'thought_level',\n}\n\nexport interface ConfigSelectChoiceIface {\n  value: string;\n  name: string;\n}\n\n/** A single-value selector: `setConfigOption({ configId, value })` with one of `choices`. */\nexport interface ConfigSelectIface {\n  configId: string;\n  name: string;\n  category: string | null;\n  currentValue: string;\n  choices: ConfigSelectChoiceIface[];\n}\n\nconst choiceSchema = z.looseObject({ value: z.string(), name: z.string().optional() });\nconst groupSchema = z.looseObject({ options: z.array(choiceSchema) });\nconst selectSchema = z.looseObject({\n  type: z.string().optional(),\n  configId: z.string().optional(),\n  id: z.string().optional(),\n  name: z.string().optional(),\n  category: z.string().nullish(),\n  currentValue: z.string(),\n  options: z.array(z.union([choiceSchema, groupSchema])),\n});\n\n/** The select options among a session's config options (booleans and unknown types skipped). */\nexport const configSelectsOf = (\n  configOptions: readonly SessionConfigOptionIface[],\n): ConfigSelectIface[] =>\n  configOptions.flatMap((option) => {\n    const parsed = selectSchema.safeParse(option);\n    if (!parsed.success) return [];\n    const select = parsed.data;\n    const configId = select.configId ?? select.id;\n    if (configId == null || (select.type != null && select.type !== 'select')) return [];\n    const choices = select.options.flatMap((entry) => {\n      const single = choiceSchema.safeParse(entry);\n      if (single.success) return [single.data];\n      return groupSchema.safeParse(entry).data?.options ?? [];\n    });\n    return [\n      {\n        configId,\n        name: select.name ?? configId,\n        category: select.category ?? null,\n        currentValue: select.currentValue,\n        choices: choices.map((choice) => ({\n          value: choice.value,\n          name: choice.name ?? choice.value,\n        })),\n      },\n    ];\n  });\n\n/** The first select of a category (`model`, `thought_level`), if the harness advertises one. */\nexport const configSelectFor = (\n  configOptions: readonly SessionConfigOptionIface[],\n  category: ConfigOptionCategory | string,\n): ConfigSelectIface | null =>\n  configSelectsOf(configOptions).find((select) => select.category === category) ?? null;\n"],
+  "mappings": "AACA,YAAY,OAAO;AASZ,IAAK,uBAAL,kBAAKA,0BAAL;AACL,EAAAA,sBAAA,UAAO;AACP,EAAAA,sBAAA,WAAQ;AACR,EAAAA,sBAAA,kBAAe;AAHL,SAAAA;AAAA,GAAA;AAoBZ,MAAM,eAAe,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACrF,MAAM,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,EAAE,CAAC;AACpE,MAAM,eAAe,EAAE,YAAY;AAAA,EACjC,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,IAAI,EAAE,OAAO,EAAE,SAAS;AAAA,EACxB,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,UAAU,EAAE,OAAO,EAAE,QAAQ;AAAA,EAC7B,cAAc,EAAE,OAAO;AAAA,EACvB,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,cAAc,WAAW,CAAC,CAAC;AACvD,CAAC;AAGM,MAAM,kBAAkB,CAC7B,kBAEA,cAAc,QAAQ,CAAC,WAAW;AAChC,QAAM,SAAS,aAAa,UAAU,MAAM;AAC5C,MAAI,CAAC,OAAO,QAAS,QAAO,CAAC;AAC7B,QAAM,SAAS,OAAO;AACtB,QAAM,WAAW,OAAO,YAAY,OAAO;AAC3C,MAAI,YAAY,QAAS,OAAO,QAAQ,QAAQ,OAAO,SAAS,SAAW,QAAO,CAAC;AACnF,QAAM,UAAU,OAAO,QAAQ,QAAQ,CAAC,UAAU;AAChD,UAAM,SAAS,aAAa,UAAU,KAAK;AAC3C,QAAI,OAAO,QAAS,QAAO,CAAC,OAAO,IAAI;AACvC,WAAO,YAAY,UAAU,KAAK,EAAE,MAAM,WAAW,CAAC;AAAA,EACxD,CAAC;AACD,SAAO;AAAA,IACL;AAAA,MACE;AAAA,MACA,MAAM,OAAO,QAAQ;AAAA,MACrB,UAAU,OAAO,YAAY;AAAA,MAC7B,cAAc,OAAO;AAAA,MACrB,SAAS,QAAQ,IAAI,CAAC,YAAY;AAAA,QAChC,OAAO,OAAO;AAAA,QACd,MAAM,OAAO,QAAQ,OAAO;AAAA,MAC9B,EAAE;AAAA,IACJ;AAAA,EACF;AACF,CAAC;AAGI,MAAM,kBAAkB,CAC7B,eACA,aAEA,gBAAgB,aAAa,EAAE,KAAK,CAAC,WAAW,OAAO,aAAa,QAAQ,KAAK;",
+  "names": ["ConfigOptionCategory"]
+}

package/dist/modules/agent-client/context.d.mts

@@ -0,0 +1,31 @@
+import type { StreamTimingIface } from "./frame-stream.mjs";
+import type { FetchIface, HttpIface } from "./http.mjs";
+import type { RealtimeTransportIface } from "./realtime.mjs";
+export declare enum ClientCollection {
+    Conversations = "conversations",
+    Pending = "pending"
+}
+/** What every API group gets from `createClient`. */
+export interface ClientContextIface {
+    http: HttpIface;
+    /** Aborts when `client.close()` is called; every stream ends with it. */
+    closeSignal: AbortSignal;
+    /** Presigned storage requests: no API credentials, client identity or cookies. */
+    storageFetch: FetchIface;
+    /** Resolved on first use, so clients that never stream never mint a gateway token. */
+    realtime: () => RealtimeTransportIface;
+    /** The signed-in user realtime topics are keyed by (a minted realtime session's); cached. */
+    realtimeUserId: () => Promise<string>;
+    realtimeCollectionTopic?: (collection: ClientCollection) => Promise<string>;
+    timing: StreamTimingIface;
+    /** Idempotency keys and client message ids. */
+    newKey: () => string;
+    /** Client clock in epoch ms. */
+    now: () => number;
+}
+export interface SignalOptionsIface {
+    signal?: AbortSignal;
+}
+/** Author calls may use the wire spelling or the exported enum constant. */
+export type EnumInput<E extends string> = E | `${E}`;
+export declare const encodePath: (segment: string) => string;

package/dist/modules/agent-client/context.mjs

@@ -0,0 +1,11 @@
+var ClientCollection = /* @__PURE__ */ ((ClientCollection2) => {
+  ClientCollection2["Conversations"] = "conversations";
+  ClientCollection2["Pending"] = "pending";
+  return ClientCollection2;
+})(ClientCollection || {});
+const encodePath = (segment) => encodeURIComponent(segment);
+export {
+  ClientCollection,
+  encodePath
+};
+//# sourceMappingURL=context.mjs.map

package/dist/modules/agent-client/context.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/context.ts"],
+  "sourcesContent": ["import type { StreamTimingIface } from \"./frame-stream.mjs\";\nimport type { FetchIface, HttpIface } from \"./http.mjs\";\nimport type { RealtimeTransportIface } from \"./realtime.mjs\";\n\nexport enum ClientCollection {\n  Conversations = 'conversations',\n  Pending = 'pending',\n}\n\n/** What every API group gets from `createClient`. */\nexport interface ClientContextIface {\n  http: HttpIface;\n  /** Aborts when `client.close()` is called; every stream ends with it. */\n  closeSignal: AbortSignal;\n  /** Presigned storage requests: no API credentials, client identity or cookies. */\n  storageFetch: FetchIface;\n  /** Resolved on first use, so clients that never stream never mint a gateway token. */\n  realtime: () => RealtimeTransportIface;\n  /** The signed-in user realtime topics are keyed by (a minted realtime session's); cached. */\n  realtimeUserId: () => Promise<string>;\n  realtimeCollectionTopic?: (collection: ClientCollection) => Promise<string>;\n  timing: StreamTimingIface;\n  /** Idempotency keys and client message ids. */\n  newKey: () => string;\n  /** Client clock in epoch ms. */\n  now: () => number;\n}\n\nexport interface SignalOptionsIface {\n  signal?: AbortSignal;\n}\n\n/** Author calls may use the wire spelling or the exported enum constant. */\nexport type EnumInput<E extends string> = E | `${E}`;\n\nexport const encodePath = (segment: string): string => encodeURIComponent(segment);\n"],
+  "mappings": "AAIO,IAAK,mBAAL,kBAAKA,sBAAL;AACL,EAAAA,kBAAA,mBAAgB;AAChB,EAAAA,kBAAA,aAAU;AAFA,SAAAA;AAAA,GAAA;AA+BL,MAAM,aAAa,CAAC,YAA4B,mBAAmB,OAAO;",
+  "names": ["ClientCollection"]
+}