@mgamadeus/ddd-agents 0.0.1-stage → 0.1.0-alpha.22

package/dist/chunks/withPollingChangeSubscription-BLDAWF-o.js

@@ -0,0 +1,251 @@
+"use client";
+import { readConversationRunStatusOfRunState, CONVERSATION_RUN_STATES_THAT_END_THE_CONVERSATION, isAgentsClientError } from "../contract.js";
+const POLLING_RUNNING_INTERVAL_MS = 2e3;
+const POLLING_IDLE_INTERVAL_MS = 2e4;
+const POLLING_MAX_BACKOFF_MS = 6e4;
+const POLLING_LOCAL_ACTIVITY_WINDOW_MS = 1e4;
+class GlobalPollingTimers {
+  constructor() {
+    this.setTimeout = (callback, delayMs) => globalThis.setTimeout(callback, delayMs);
+    this.clearTimeout = (timerHandle) => globalThis.clearTimeout(timerHandle);
+    this.now = () => Date.now();
+  }
+}
+class BrowserDocumentVisibility {
+  constructor(browserDocument) {
+    this.browserDocument = browserDocument;
+    this.isHidden = () => this.browserDocument.visibilityState === "hidden";
+    this.listen = (listener) => {
+      this.browserDocument.addEventListener("visibilitychange", listener);
+      return this.browserDocument.removeEventListener.bind(this.browserDocument, "visibilitychange", listener);
+    };
+  }
+}
+const readPolledRunStatus = (conversation) => {
+  const runStatus = readConversationRunStatusOfRunState(conversation.runState);
+  return runStatus === "idle" && conversation.agentTurnOwedAt ? "running" : runStatus;
+};
+const readSubscriptionEndReasonOfReadFailure = (failure) => {
+  if (!isAgentsClientError(failure)) return null;
+  if (failure.kind === "notFound") return "gone";
+  if (failure.kind === "forbidden") return "forbidden";
+  return null;
+};
+class ConversationMetadataPoller {
+  constructor(conversationId, readMetadata, onSignal, onEnded, options, activePollers) {
+    this.conversationId = conversationId;
+    this.readMetadata = readMetadata;
+    this.onSignal = onSignal;
+    this.onEnded = onEnded;
+    this.options = options;
+    this.activePollers = activePollers;
+    this.isStopped = false;
+    this.isReading = false;
+    this.readAgainAfterCurrentRead = false;
+    this.timerHandle = null;
+    this.consecutiveFailedReads = 0;
+    this.changeCounter = 0;
+    this.summaryRevision = 0;
+    this.previousChangeFingerprint = null;
+    this.previousSummaryFingerprint = null;
+    this.runStatus = null;
+    this.hasConversationEnded = false;
+    this.runningIntervalUntil = 0;
+    this.stopListeningToVisibility = null;
+    this.start = () => {
+      this.activePollers.add(this);
+      this.stopListeningToVisibility = this.options.documentVisibility?.listen(this.receiveVisibilityChange) ?? null;
+      this.readNow();
+    };
+    this.stop = () => {
+      this.isStopped = true;
+      this.activePollers.delete(this);
+      this.clearTimer();
+      this.stopListeningToVisibility?.();
+      this.stopListeningToVisibility = null;
+    };
+    this.receiveLocalActivity = () => {
+      this.runningIntervalUntil = this.options.timers.now() + this.options.localActivityWindowMs;
+      this.readNow();
+    };
+    this.readNow = () => {
+      if (this.isStopped) return;
+      if (this.isReading) {
+        this.readAgainAfterCurrentRead = true;
+        return;
+      }
+      this.clearTimer();
+      this.isReading = true;
+      void this.readMetadataOnce();
+    };
+    this.readOnTimer = () => {
+      this.timerHandle = null;
+      this.readNow();
+    };
+    this.receiveVisibilityChange = () => {
+      if (this.isStopped) return;
+      if (this.options.documentVisibility?.isHidden()) {
+        this.clearTimer();
+        return;
+      }
+      this.readNow();
+    };
+  }
+  async readMetadataOnce() {
+    let conversation;
+    try {
+      conversation = await this.readMetadata(this.conversationId);
+    } catch (failure) {
+      this.isReading = false;
+      this.receiveReadFailure(failure);
+      return;
+    }
+    this.isReading = false;
+    if (this.isStopped) return;
+    this.consecutiveFailedReads = 0;
+    this.receiveConversation(conversation);
+    this.continueAfterRead(this.readIntervalMs());
+  }
+  receiveConversation(conversation) {
+    const runStatus = readPolledRunStatus(conversation);
+    const reportsLastMessageId = conversation.lastMessageId !== void 0;
+    const changeFingerprint = JSON.stringify([runStatus, conversation.lastMessageId ?? null, conversation.updated]);
+    const summaryFingerprint = JSON.stringify([conversation.title, conversation.summary]);
+    const isFirstRead = this.previousChangeFingerprint === null;
+    const hasChanged = changeFingerprint !== this.previousChangeFingerprint || !reportsLastMessageId && runStatus === "running";
+    const hasSummaryChanged = !isFirstRead && summaryFingerprint !== this.previousSummaryFingerprint;
+    if (!isFirstRead && hasChanged) this.changeCounter += 1;
+    if (hasSummaryChanged) this.summaryRevision += 1;
+    this.previousChangeFingerprint = changeFingerprint;
+    this.previousSummaryFingerprint = summaryFingerprint;
+    this.runStatus = runStatus;
+    this.hasConversationEnded = conversation.runState !== null && CONVERSATION_RUN_STATES_THAT_END_THE_CONVERSATION.includes(conversation.runState);
+    if (!isFirstRead && !hasChanged && !hasSummaryChanged) return;
+    this.onSignal({
+      changeCounter: this.changeCounter,
+      lastMessageId: conversation.lastMessageId ?? null,
+      runStatus,
+      summaryUpdatedAt: this.summaryRevision
+    });
+  }
+  receiveReadFailure(failure) {
+    if (this.isStopped) return;
+    const endReason = readSubscriptionEndReasonOfReadFailure(failure);
+    if (endReason !== null) {
+      this.stop();
+      this.onEnded(endReason);
+      return;
+    }
+    this.consecutiveFailedReads += 1;
+    const backoffMs = this.readIntervalMs() * 2 ** this.consecutiveFailedReads;
+    this.continueAfterRead(Math.min(backoffMs, this.options.maxBackoffMs));
+  }
+  continueAfterRead(nextReadDelayMs) {
+    if (this.readAgainAfterCurrentRead) {
+      this.readAgainAfterCurrentRead = false;
+      this.readNow();
+      return;
+    }
+    if (this.hasConversationEnded) return;
+    this.scheduleRead(nextReadDelayMs);
+  }
+  readIntervalMs() {
+    const isShortIntervalDue = this.runStatus === "running" || this.options.timers.now() < this.runningIntervalUntil;
+    return isShortIntervalDue ? this.options.runningIntervalMs : this.options.idleIntervalMs;
+  }
+  /** Arms the next read — not while the page is hidden; its return reads at once. */
+  scheduleRead(delayMs) {
+    this.clearTimer();
+    if (this.isStopped || this.options.documentVisibility?.isHidden()) return;
+    this.timerHandle = this.options.timers.setTimeout(this.readOnTimer, delayMs);
+  }
+  clearTimer() {
+    if (this.timerHandle === null) return;
+    this.options.timers.clearTimeout(this.timerHandle);
+    this.timerHandle = null;
+  }
+}
+class PollingConversationChangeSubscriptions {
+  constructor(readMetadata, options) {
+    this.readMetadata = readMetadata;
+    this.options = options;
+    this.activePollers = /* @__PURE__ */ new Set();
+    this.subscribeToConversationChanges = (conversationId, onSignal, onEnded) => {
+      const poller = new ConversationMetadataPoller(
+        conversationId,
+        this.readMetadata,
+        onSignal,
+        onEnded,
+        this.options,
+        this.activePollers
+      );
+      poller.start();
+      return poller.stop;
+    };
+    this.notifyLocalActivity = (conversationId) => {
+      for (const poller of [...this.activePollers]) {
+        if (poller.conversationId === conversationId) poller.receiveLocalActivity();
+      }
+    };
+  }
+}
+const readDefaultDocumentVisibility = () => typeof document === "undefined" ? null : new BrowserDocumentVisibility(document);
+const createPollingConversationChangeSubscription = (readMetadata, options = {}) => new PollingConversationChangeSubscriptions(readMetadata, {
+  runningIntervalMs: options.runningIntervalMs ?? POLLING_RUNNING_INTERVAL_MS,
+  idleIntervalMs: options.idleIntervalMs ?? POLLING_IDLE_INTERVAL_MS,
+  maxBackoffMs: options.maxBackoffMs ?? POLLING_MAX_BACKOFF_MS,
+  localActivityWindowMs: options.localActivityWindowMs ?? POLLING_LOCAL_ACTIVITY_WINDOW_MS,
+  timers: options.timers ?? new GlobalPollingTimers(),
+  documentVisibility: options.documentVisibility === void 0 ? readDefaultDocumentVisibility() : options.documentVisibility
+});
+class PollingAgentsConversationClient {
+  constructor(binding, polling) {
+    this.binding = binding;
+    this.polling = polling;
+    this.getConversationMetadata = (conversationId) => this.binding.getConversationMetadata(conversationId);
+    this.getNewestMessagesPage = (conversationId, pageSize) => this.binding.getNewestMessagesPage(conversationId, pageSize);
+    this.getOlderMessagesPage = (conversationId, beforeIndex, pageSize) => this.binding.getOlderMessagesPage(conversationId, beforeIndex, pageSize);
+    this.getChangedMessages = (conversationId, request) => this.binding.getChangedMessages(conversationId, request);
+    this.startConversation = (request) => this.binding.startConversation(request);
+    this.postMessage = async (conversationId, message) => {
+      const postedMessage = await this.binding.postMessage(conversationId, message);
+      this.polling.notifyLocalActivity(conversationId);
+      return postedMessage;
+    };
+    this.injectSignal = async (conversationId, signal) => {
+      await this.binding.injectSignal(conversationId, signal);
+      this.polling.notifyLocalActivity(conversationId);
+    };
+    this.retryConversation = async (conversationId) => {
+      await this.binding.retryConversation(conversationId);
+      this.polling.notifyLocalActivity(conversationId);
+    };
+    this.renameConversation = (conversationId, title) => this.binding.renameConversation(conversationId, title);
+    this.deleteConversation = (conversationId) => this.binding.deleteConversation(conversationId);
+    this.listConversations = (agentSpaceKey, options) => this.binding.listConversations(agentSpaceKey, options);
+    this.searchConversations = (text, options) => this.binding.searchConversations(text, options);
+    this.searchConversationMessages = (conversationId, text, options) => this.binding.searchConversationMessages(conversationId, text, options);
+    this.getConversationActivity = (conversationId, turnMessageId) => this.binding.getConversationActivity(conversationId, turnMessageId);
+    this.subscribeToConversationChanges = (conversationId, onSignal, onEnded) => this.polling.subscribeToConversationChanges(conversationId, onSignal, onEnded);
+    this.getSelectableModels = binding.getSelectableModels?.bind(binding);
+    this.composeSentMessageText = binding.composeSentMessageText?.bind(binding);
+    this.getMessageSentPayload = binding.getMessageSentPayload?.bind(binding);
+  }
+}
+const withPollingChangeSubscription = (client, options) => {
+  if (client.subscribeToConversationChanges) return client;
+  return new PollingAgentsConversationClient(
+    client,
+    createPollingConversationChangeSubscription(client.getConversationMetadata.bind(client), options)
+  );
+};
+export {
+  POLLING_IDLE_INTERVAL_MS as P,
+  POLLING_LOCAL_ACTIVITY_WINDOW_MS as a,
+  POLLING_MAX_BACKOFF_MS as b,
+  POLLING_RUNNING_INTERVAL_MS as c,
+  createPollingConversationChangeSubscription as d,
+  readPolledRunStatus as r,
+  withPollingChangeSubscription as w
+};
+//# sourceMappingURL=withPollingChangeSubscription-BLDAWF-o.js.map

package/dist/chunks/withPollingChangeSubscription-BLDAWF-o.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withPollingChangeSubscription-BLDAWF-o.js","sources":["../../src/client/polling/createPollingConversationChangeSubscription.ts","../../src/client/polling/withPollingChangeSubscription.ts"],"sourcesContent":["import {\n  type AgentsConversation,\n  type ConversationChangeSignal,\n  type ConversationRunStatus,\n  type ConversationSubscriptionEndReason,\n  CONVERSATION_RUN_STATES_THAT_END_THE_CONVERSATION,\n  isAgentsClientError,\n  readConversationRunStatusOfRunState,\n} from \"../../contract/conversation\";\n\n/** Read interval while a turn runs (or right after a local send). */\nexport const POLLING_RUNNING_INTERVAL_MS = 2_000;\n/** Read interval while the conversation is idle or failed. */\nexport const POLLING_IDLE_INTERVAL_MS = 20_000;\n/** Ceiling of the exponential backoff after failed reads. */\nexport const POLLING_MAX_BACKOFF_MS = 60_000;\n/**\n * How long after a local send the poller keeps the running interval although the conversation still reads idle: the\n * server may store the owner's message before it marks the turn as running.\n */\nexport const POLLING_LOCAL_ACTIVITY_WINDOW_MS = 10_000;\n\n/** Reads a conversation's metadata — the port's `getConversationMetadata`. */\nexport type ConversationMetadataReader = (conversationId: number) => Promise<AgentsConversation>;\n\n/** The timer functions the poller uses; a spec hands in fake ones. */\nexport interface PollingTimers {\n  setTimeout: (callback: () => void, delayMs: number) => unknown;\n  clearTimeout: (timerHandle: unknown) => void;\n  now: () => number;\n}\n\n/** Whether the page is hidden, and a way to hear when that changes; a spec hands in its own. */\nexport interface PollingDocumentVisibility {\n  isHidden: () => boolean;\n  /** Calls `listener` on every visibility change; returns the function that stops it. */\n  listen: (listener: () => void) => () => void;\n}\n\nexport interface PollingConversationChangeSubscriptionOptions {\n  /** Default `POLLING_RUNNING_INTERVAL_MS` (2 s). */\n  runningIntervalMs?: number;\n  /** Default `POLLING_IDLE_INTERVAL_MS` (20 s). */\n  idleIntervalMs?: number;\n  /** Default `POLLING_MAX_BACKOFF_MS` (60 s). */\n  maxBackoffMs?: number;\n  /** Default `POLLING_LOCAL_ACTIVITY_WINDOW_MS` (10 s). */\n  localActivityWindowMs?: number;\n  /** Default: the global `setTimeout` / `clearTimeout` and `Date.now`. */\n  timers?: PollingTimers;\n  /** Default: the browser `document`; `null` = the page counts as always visible (no `document`, a worker). */\n  documentVisibility?: PollingDocumentVisibility | null;\n}\n\n/**\n * The polling default of the live updates: the port's `subscribeToConversationChanges` plus\n * `notifyLocalActivity`, which `withPollingChangeSubscription` calls after every send the server accepted.\n */\nexport interface PollingConversationChangeSubscription {\n  subscribeToConversationChanges: (\n    conversationId: number,\n    onSignal: (signal: ConversationChangeSignal) => void,\n    onEnded: (reason: ConversationSubscriptionEndReason) => void,\n  ) => () => void;\n  /** Reads the conversation's metadata now and keeps the running interval for the local-activity window. */\n  notifyLocalActivity: (conversationId: number) => void;\n}\n\ninterface ResolvedPollingOptions {\n  runningIntervalMs: number;\n  idleIntervalMs: number;\n  maxBackoffMs: number;\n  localActivityWindowMs: number;\n  timers: PollingTimers;\n  documentVisibility: PollingDocumentVisibility | null;\n}\n\n/** The global timer functions, looked up on each call (so a spec's fake timers installed later still apply). */\nclass GlobalPollingTimers implements PollingTimers {\n  setTimeout = (callback: () => void, delayMs: number): unknown => globalThis.setTimeout(callback, delayMs);\n\n  clearTimeout = (timerHandle: unknown): void => globalThis.clearTimeout(timerHandle as ReturnType<typeof setTimeout>);\n\n  now = (): number => Date.now();\n}\n\n/** The browser document's `visibilityState` and `visibilitychange` event. */\nclass BrowserDocumentVisibility implements PollingDocumentVisibility {\n  constructor(protected readonly browserDocument: Document) {}\n\n  isHidden = (): boolean => this.browserDocument.visibilityState === \"hidden\";\n\n  listen = (listener: () => void): (() => void) => {\n    this.browserDocument.addEventListener(\"visibilitychange\", listener);\n    return this.browserDocument.removeEventListener.bind(this.browserDocument, \"visibilitychange\", listener);\n  };\n}\n\n/**\n * The three-value run status a polled read reports: the stored run state, and \"running\" for an idle conversation the\n * server owes a turn (`agentTurnOwedAt`), as the chat's own derivation does.\n */\nexport const readPolledRunStatus = (conversation: AgentsConversation): ConversationRunStatus | null => {\n  const runStatus = readConversationRunStatusOfRunState(conversation.runState);\n  return runStatus === \"idle\" && conversation.agentTurnOwedAt ? \"running\" : runStatus;\n};\n\n/** The end of a subscription a failed read means: a vanished conversation or lost access; null for a passing failure. */\nconst readSubscriptionEndReasonOfReadFailure = (failure: unknown): ConversationSubscriptionEndReason | null => {\n  if (!isAgentsClientError(failure)) return null;\n  if (failure.kind === \"notFound\") return \"gone\";\n  if (failure.kind === \"forbidden\") return \"forbidden\";\n  return null;\n};\n\n/**\n * One subscription: reads the conversation's metadata on a timer and turns each read into the change signal.\n *\n * Numbering (the signal leaves it open; the metadata carries no server change counter): the poller keeps its own counter. It\n * starts at 0 with the first read and advances by one whenever a read differs from the previous one in the run status,\n * `lastMessageId` or `updated` — so every polled signal is an ordinary change signal (no `isStatusCheck`) and the\n * package rules apply unchanged: an advance reads the changed tail (throttled), a terminal status reads at once,\n * re-reads the metadata and converges on `lastMessageId`. A status check would carry only the run status as news and\n * would miss a new message under an unchanged status. Without `lastMessageId` in the metadata every poll of a running\n * turn counts as a change (the changed tail is read every poll). `summaryUpdatedAt` is a second local counter that\n * advances when `title` or `summary` changed. A read with no change emits nothing.\n */\nclass ConversationMetadataPoller {\n  protected isStopped = false;\n  protected isReading = false;\n  protected readAgainAfterCurrentRead = false;\n  protected timerHandle: unknown = null;\n  protected consecutiveFailedReads = 0;\n  protected changeCounter = 0;\n  protected summaryRevision = 0;\n  protected previousChangeFingerprint: string | null = null;\n  protected previousSummaryFingerprint: string | null = null;\n  protected runStatus: ConversationRunStatus | null = null;\n  protected hasConversationEnded = false;\n  protected runningIntervalUntil = 0;\n  protected stopListeningToVisibility: (() => void) | null = null;\n\n  constructor(\n    readonly conversationId: number,\n    protected readonly readMetadata: ConversationMetadataReader,\n    protected readonly onSignal: (signal: ConversationChangeSignal) => void,\n    protected readonly onEnded: (reason: ConversationSubscriptionEndReason) => void,\n    protected readonly options: ResolvedPollingOptions,\n    protected readonly activePollers: Set<ConversationMetadataPoller>,\n  ) {}\n\n  start = (): void => {\n    this.activePollers.add(this);\n    this.stopListeningToVisibility = this.options.documentVisibility?.listen(this.receiveVisibilityChange) ?? null;\n    this.readNow();\n  };\n\n  /** The unsubscribe: no read, no timer and no signal after it; a read in flight is dropped. */\n  stop = (): void => {\n    this.isStopped = true;\n    this.activePollers.delete(this);\n    this.clearTimer();\n    this.stopListeningToVisibility?.();\n    this.stopListeningToVisibility = null;\n  };\n\n  receiveLocalActivity = (): void => {\n    this.runningIntervalUntil = this.options.timers.now() + this.options.localActivityWindowMs;\n    this.readNow();\n  };\n\n  /** Reads now; a read already in flight is followed by one more read instead (two reads never overlap). */\n  protected readNow = (): void => {\n    if (this.isStopped) return;\n    if (this.isReading) {\n      this.readAgainAfterCurrentRead = true;\n      return;\n    }\n    this.clearTimer();\n    this.isReading = true;\n    void this.readMetadataOnce();\n  };\n\n  protected async readMetadataOnce(): Promise<void> {\n    let conversation: AgentsConversation;\n    try {\n      conversation = await this.readMetadata(this.conversationId);\n    } catch (failure) {\n      this.isReading = false;\n      this.receiveReadFailure(failure);\n      return;\n    }\n    this.isReading = false;\n    if (this.isStopped) return;\n    this.consecutiveFailedReads = 0;\n    this.receiveConversation(conversation);\n    this.continueAfterRead(this.readIntervalMs());\n  }\n\n  protected receiveConversation(conversation: AgentsConversation): void {\n    const runStatus = readPolledRunStatus(conversation);\n    const reportsLastMessageId = conversation.lastMessageId !== undefined;\n    const changeFingerprint = JSON.stringify([runStatus, conversation.lastMessageId ?? null, conversation.updated]);\n    const summaryFingerprint = JSON.stringify([conversation.title, conversation.summary]);\n    const isFirstRead = this.previousChangeFingerprint === null;\n    const hasChanged =\n      changeFingerprint !== this.previousChangeFingerprint || (!reportsLastMessageId && runStatus === \"running\");\n    const hasSummaryChanged = !isFirstRead && summaryFingerprint !== this.previousSummaryFingerprint;\n    if (!isFirstRead && hasChanged) this.changeCounter += 1;\n    if (hasSummaryChanged) this.summaryRevision += 1;\n    this.previousChangeFingerprint = changeFingerprint;\n    this.previousSummaryFingerprint = summaryFingerprint;\n    this.runStatus = runStatus;\n    this.hasConversationEnded =\n      conversation.runState !== null && CONVERSATION_RUN_STATES_THAT_END_THE_CONVERSATION.includes(conversation.runState);\n    if (!isFirstRead && !hasChanged && !hasSummaryChanged) return;\n    this.onSignal({\n      changeCounter: this.changeCounter,\n      lastMessageId: conversation.lastMessageId ?? null,\n      runStatus,\n      summaryUpdatedAt: this.summaryRevision,\n    });\n  }\n\n  protected receiveReadFailure(failure: unknown): void {\n    if (this.isStopped) return;\n    const endReason = readSubscriptionEndReasonOfReadFailure(failure);\n    if (endReason !== null) {\n      this.stop();\n      this.onEnded(endReason);\n      return;\n    }\n    this.consecutiveFailedReads += 1;\n    const backoffMs = this.readIntervalMs() * 2 ** this.consecutiveFailedReads;\n    this.continueAfterRead(Math.min(backoffMs, this.options.maxBackoffMs));\n  }\n\n  protected continueAfterRead(nextReadDelayMs: number): void {\n    if (this.readAgainAfterCurrentRead) {\n      this.readAgainAfterCurrentRead = false;\n      this.readNow();\n      return;\n    }\n    // A completed or cancelled conversation changes no more: only a local send or the page's return reads it again.\n    if (this.hasConversationEnded) return;\n    this.scheduleRead(nextReadDelayMs);\n  }\n\n  protected readIntervalMs(): number {\n    const isShortIntervalDue = this.runStatus === \"running\" || this.options.timers.now() < this.runningIntervalUntil;\n    return isShortIntervalDue ? this.options.runningIntervalMs : this.options.idleIntervalMs;\n  }\n\n  /** Arms the next read — not while the page is hidden; its return reads at once. */\n  protected scheduleRead(delayMs: number): void {\n    this.clearTimer();\n    if (this.isStopped || this.options.documentVisibility?.isHidden()) return;\n    this.timerHandle = this.options.timers.setTimeout(this.readOnTimer, delayMs);\n  }\n\n  protected readOnTimer = (): void => {\n    this.timerHandle = null;\n    this.readNow();\n  };\n\n  protected receiveVisibilityChange = (): void => {\n    if (this.isStopped) return;\n    if (this.options.documentVisibility?.isHidden()) {\n      this.clearTimer();\n      return;\n    }\n    this.readNow();\n  };\n\n  protected clearTimer(): void {\n    if (this.timerHandle === null) return;\n    this.options.timers.clearTimeout(this.timerHandle);\n    this.timerHandle = null;\n  }\n}\n\n/** Every subscription of one polling default; `notifyLocalActivity` reaches the subscriptions of a conversation. */\nclass PollingConversationChangeSubscriptions implements PollingConversationChangeSubscription {\n  protected readonly activePollers = new Set<ConversationMetadataPoller>();\n\n  constructor(\n    protected readonly readMetadata: ConversationMetadataReader,\n    protected readonly options: ResolvedPollingOptions,\n  ) {}\n\n  subscribeToConversationChanges = (\n    conversationId: number,\n    onSignal: (signal: ConversationChangeSignal) => void,\n    onEnded: (reason: ConversationSubscriptionEndReason) => void,\n  ): (() => void) => {\n    const poller = new ConversationMetadataPoller(\n      conversationId,\n      this.readMetadata,\n      onSignal,\n      onEnded,\n      this.options,\n      this.activePollers,\n    );\n    poller.start();\n    return poller.stop;\n  };\n\n  notifyLocalActivity = (conversationId: number): void => {\n    for (const poller of [...this.activePollers]) {\n      if (poller.conversationId === conversationId) poller.receiveLocalActivity();\n    }\n  };\n}\n\nconst readDefaultDocumentVisibility = (): PollingDocumentVisibility | null =>\n  typeof document === \"undefined\" ? null : new BrowserDocumentVisibility(document);\n\n/**\n * The polling default of `subscribeToConversationChanges` over a metadata read: every 2 s while a turn\n * runs, every 20 s while idle, at once after `notifyLocalActivity`; paused while the page is hidden and read once when\n * it shows again; exponential backoff on failed reads up to 60 s; a `notFound` / `forbidden` read ends the subscription\n * with `gone` / `forbidden`. One poller per subscription; see `ConversationMetadataPoller` for how a read becomes a\n * signal.\n */\nexport const createPollingConversationChangeSubscription = (\n  readMetadata: ConversationMetadataReader,\n  options: PollingConversationChangeSubscriptionOptions = {},\n): PollingConversationChangeSubscription =>\n  new PollingConversationChangeSubscriptions(readMetadata, {\n    runningIntervalMs: options.runningIntervalMs ?? POLLING_RUNNING_INTERVAL_MS,\n    idleIntervalMs: options.idleIntervalMs ?? POLLING_IDLE_INTERVAL_MS,\n    maxBackoffMs: options.maxBackoffMs ?? POLLING_MAX_BACKOFF_MS,\n    localActivityWindowMs: options.localActivityWindowMs ?? POLLING_LOCAL_ACTIVITY_WINDOW_MS,\n    timers: options.timers ?? new GlobalPollingTimers(),\n    documentVisibility: options.documentVisibility === undefined ? readDefaultDocumentVisibility() : options.documentVisibility,\n  });\n","import type { AgentsConversationClient } from \"../AgentsConversationClient\";\nimport type {\n  AgentsConversation,\n  ChangedConversationMessages,\n  ChangedMessagesRequest,\n  ConversationActivity,\n  ConversationAttachmentReference,\n  ConversationChangeSignal,\n  ConversationListQueryOptions,\n  ConversationMessageSearchHit,\n  ConversationMessageSentPayload,\n  ConversationMessagesPage,\n  ConversationSearchGroup,\n  ConversationSearchOptions,\n  ConversationSignal,\n  ConversationSubscriptionEndReason,\n  PostedMessage,\n  SelectableModel,\n  StartedConversation,\n} from \"../../contract/conversation\";\nimport {\n  createPollingConversationChangeSubscription,\n  type PollingConversationChangeSubscription,\n  type PollingConversationChangeSubscriptionOptions,\n} from \"./createPollingConversationChangeSubscription\";\n\n/** A conversation client whose `subscribeToConversationChanges` is present. */\nexport type AgentsConversationClientWithChangeSubscription = AgentsConversationClient &\n  Required<Pick<AgentsConversationClient, \"subscribeToConversationChanges\">>;\n\n/**\n * A binding without push, with the polling default as its subscription. Every port function goes to the binding; the\n * three that make the server start a turn on an existing conversation (post, signal, retry) tell the poller once the\n * server accepted them, so the first read does not wait for the idle interval. A start needs no notice: the chat\n * subscribes to the new conversation afterwards, and a subscription reads at once.\n */\nclass PollingAgentsConversationClient implements AgentsConversationClientWithChangeSubscription {\n  readonly getSelectableModels?: () => Promise<SelectableModel[]>;\n  readonly composeSentMessageText?: (text: string, attachments: ConversationAttachmentReference[] | undefined) => string;\n  readonly getMessageSentPayload?: (conversationId: number, messageId: number) => Promise<ConversationMessageSentPayload>;\n\n  constructor(\n    protected readonly binding: AgentsConversationClient,\n    protected readonly polling: PollingConversationChangeSubscription,\n  ) {\n    // The optional functions exist exactly when the binding has them (the chat reads their presence).\n    this.getSelectableModels = binding.getSelectableModels?.bind(binding);\n    this.composeSentMessageText = binding.composeSentMessageText?.bind(binding);\n    this.getMessageSentPayload = binding.getMessageSentPayload?.bind(binding);\n  }\n\n  getConversationMetadata = (conversationId: number): Promise<AgentsConversation> =>\n    this.binding.getConversationMetadata(conversationId);\n\n  getNewestMessagesPage = (conversationId: number, pageSize: number): Promise<ConversationMessagesPage> =>\n    this.binding.getNewestMessagesPage(conversationId, pageSize);\n\n  getOlderMessagesPage = (conversationId: number, beforeIndex: number, pageSize: number): Promise<ConversationMessagesPage> =>\n    this.binding.getOlderMessagesPage(conversationId, beforeIndex, pageSize);\n\n  getChangedMessages = (conversationId: number, request: ChangedMessagesRequest): Promise<ChangedConversationMessages> =>\n    this.binding.getChangedMessages(conversationId, request);\n\n  startConversation = (request: Parameters<AgentsConversationClient[\"startConversation\"]>[0]): Promise<StartedConversation> =>\n    this.binding.startConversation(request);\n\n  postMessage = async (\n    conversationId: number,\n    message: { text: string; model?: string; attachments?: ConversationAttachmentReference[] },\n  ): Promise<PostedMessage> => {\n    const postedMessage = await this.binding.postMessage(conversationId, message);\n    this.polling.notifyLocalActivity(conversationId);\n    return postedMessage;\n  };\n\n  injectSignal = async (conversationId: number, signal: ConversationSignal): Promise<void> => {\n    await this.binding.injectSignal(conversationId, signal);\n    this.polling.notifyLocalActivity(conversationId);\n  };\n\n  retryConversation = async (conversationId: number): Promise<void> => {\n    await this.binding.retryConversation(conversationId);\n    this.polling.notifyLocalActivity(conversationId);\n  };\n\n  renameConversation = (conversationId: number, title: string): Promise<AgentsConversation> =>\n    this.binding.renameConversation(conversationId, title);\n\n  deleteConversation = (conversationId: number): Promise<void> => this.binding.deleteConversation(conversationId);\n\n  listConversations = (agentSpaceKey: number, options?: ConversationListQueryOptions): Promise<AgentsConversation[]> =>\n    this.binding.listConversations(agentSpaceKey, options);\n\n  searchConversations = (text: string, options?: ConversationSearchOptions): Promise<ConversationSearchGroup[]> =>\n    this.binding.searchConversations(text, options);\n\n  searchConversationMessages = (\n    conversationId: number,\n    text: string,\n    options?: ConversationSearchOptions,\n  ): Promise<ConversationMessageSearchHit[]> => this.binding.searchConversationMessages(conversationId, text, options);\n\n  getConversationActivity = (conversationId: number, turnMessageId?: number | null): Promise<ConversationActivity> =>\n    this.binding.getConversationActivity(conversationId, turnMessageId);\n\n  subscribeToConversationChanges = (\n    conversationId: number,\n    onSignal: (signal: ConversationChangeSignal) => void,\n    onEnded: (reason: ConversationSubscriptionEndReason) => void,\n  ): (() => void) => this.polling.subscribeToConversationChanges(conversationId, onSignal, onEnded);\n}\n\n/**\n * The client with live updates: a client that brings its own `subscribeToConversationChanges` (a push\n * transport — the host application's Firebase binding) is returned as it is; any other gets the polling default over its\n * `getConversationMetadata` (`createPollingConversationChangeSubscription`, `options` tune the intervals). The default\n * `AgentChat` calls this by itself.\n */\nexport const withPollingChangeSubscription = (\n  client: AgentsConversationClient,\n  options?: PollingConversationChangeSubscriptionOptions,\n): AgentsConversationClientWithChangeSubscription => {\n  if (client.subscribeToConversationChanges) return client as AgentsConversationClientWithChangeSubscription;\n  return new PollingAgentsConversationClient(\n    client,\n    createPollingConversationChangeSubscription(client.getConversationMetadata.bind(client), options),\n  );\n};\n"],"names":[],"mappings":"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"}

package/dist/client-testing.js

@@ -0,0 +1,346 @@
+"use client";
+import { AgentsClientError, CONVERSATION_RUN_STATES_THAT_END_THE_CONVERSATION, readConversationRunStatusOfRunState } from "./contract.js";
+const DEFAULT_SCRIPTED_ASSISTANT_ANSWER = "Done.";
+const DEFAULT_PAGE_SIZE = 50;
+const copyOf = (value) => JSON.parse(JSON.stringify(value));
+const sortByIndexAscending = (messages) => [...messages].sort((first, second) => (first.indexInConversation ?? 0) - (second.indexInConversation ?? 0));
+const textContains = (text, searchText) => (text ?? "").toLowerCase().includes(searchText.trim().toLowerCase());
+const buildStoredMessageText = (text, attachments) => attachments?.length ? `${text}
+
+${attachments.map((attachment) => `[Attached file: ${attachment.fileName ?? "file"} — ${attachment.publicUrl ?? ""}]`).join("\n")}` : text;
+class InMemoryAgentsConversationClient {
+  constructor(data) {
+    this.recordsByConversationId = /* @__PURE__ */ new Map();
+    this.subscribersByConversationId = /* @__PURE__ */ new Map();
+    this.signalStateByConversationId = /* @__PURE__ */ new Map();
+    this.requestCountsByOperation = /* @__PURE__ */ new Map();
+    this.scriptedAssistantAnswersUsed = 0;
+    this.listConversations = async (agentSpaceKey, options = {}) => {
+      this.countRequest("listConversations");
+      const { includeUnsummarized = false, paging = {} } = options;
+      const { top, skip = 0 } = paging;
+      const conversationsOfAgentSpace = [...this.recordsByConversationId.values()].map((recorded) => recorded.conversation).filter((conversation) => conversation.agentSpaceKey === agentSpaceKey).filter((conversation) => includeUnsummarized || conversation.title !== null).sort((first, second) => second.id - first.id);
+      const end = top === void 0 ? void 0 : skip + top;
+      return copyOf(conversationsOfAgentSpace.slice(skip, end));
+    };
+    this.searchConversations = async (text, options = {}) => {
+      this.countRequest("searchConversations");
+      const searchGroups = [];
+      for (const recorded of this.recordsByConversationId.values()) {
+        const hits = this.findMessageSearchHits(recorded, text);
+        if (hits.length === 0) continue;
+        searchGroups.push({
+          conversationId: recorded.conversation.id,
+          title: recorded.conversation.title,
+          summary: null,
+          created: recorded.messages[0]?.createdDate ?? null,
+          updated: recorded.messages[recorded.messages.length - 1]?.createdDate ?? null,
+          relevance: 1,
+          hits
+        });
+      }
+      return copyOf(searchGroups.slice(0, options.limit));
+    };
+    this.getConversationMetadata = async (conversationId) => {
+      this.countRequest("getConversationMetadata");
+      const recorded = this.readRecord(conversationId);
+      return copyOf({ ...recorded.conversation, lastMessageId: sortByIndexAscending(recorded.messages).pop()?.id ?? null });
+    };
+    this.getNewestMessagesPage = async (conversationId, pageSize) => {
+      this.countRequest("getNewestMessagesPage");
+      const newestFirst = this.readMessagesNewestFirst(conversationId);
+      return copyOf({ messages: newestFirst.slice(0, pageSize), hasMoreOlder: newestFirst.length > pageSize });
+    };
+    this.getOlderMessagesPage = async (conversationId, beforeIndex, pageSize) => {
+      this.countRequest("getOlderMessagesPage");
+      const olderMessages = this.readMessagesNewestFirst(conversationId).filter(
+        (message) => (message.indexInConversation ?? Number.MAX_SAFE_INTEGER) < beforeIndex
+      );
+      return copyOf({ messages: olderMessages.slice(0, pageSize), hasMoreOlder: olderMessages.length > pageSize });
+    };
+    this.getChangedMessages = async (conversationId, request) => {
+      this.countRequest("getChangedMessages");
+      const changedMessages = this.readMessagesNewestFirst(conversationId).filter(
+        (message) => message.id > request.highestKnownId || (message.indexInConversation ?? -1) >= request.fromIndex
+      );
+      return copyOf({ messages: changedMessages.slice(0, request.pageSize ?? this.defaultPageSize) });
+    };
+    this.searchConversationMessages = async (conversationId, text, options = {}) => {
+      this.countRequest("searchConversationMessages");
+      return copyOf(this.findMessageSearchHits(this.readRecord(conversationId), text).slice(0, options.limit));
+    };
+    this.getConversationActivity = async (conversationId) => {
+      this.countRequest("getConversationActivity");
+      return copyOf(this.readRecord(conversationId).activity ?? { turnMessageId: null, turnRunning: false, elements: [] });
+    };
+    this.startConversation = async (request) => {
+      this.countRequest("startConversation");
+      if (request.text === "" && !request.startSignalText) {
+        throw new AgentsClientError("other", { httpStatus: 400, message: "A start needs a message or a signal." });
+      }
+      const reopenedConversation = request.entryPointKey ? [...this.recordsByConversationId.values()].find(
+        (recorded2) => recorded2.conversation.agentSpaceKey === request.agentSpaceKey && recorded2.conversation.entryPointKey === request.entryPointKey
+      ) : void 0;
+      if (reopenedConversation) {
+        return { conversation: copyOf(reopenedConversation.conversation), messages: [], reopenedExisting: true };
+      }
+      const recorded = {
+        conversation: {
+          id: this.nextConversationId,
+          agentSpaceKey: request.agentSpaceKey,
+          runState: "IDLE",
+          agentTurnOwedAt: null,
+          title: null,
+          titleManuallyEdited: false,
+          summary: null,
+          created: null,
+          updated: null,
+          purposeName: null,
+          initiatorType: null,
+          scheduleId: null,
+          entryPointKey: request.entryPointKey ?? null,
+          progressSteps: []
+        },
+        messages: []
+      };
+      this.nextConversationId += 1;
+      this.recordsByConversationId.set(recorded.conversation.id, recorded);
+      if (request.startSignalText) {
+        this.appendMessage(recorded, { role: "USER", messageType: "SIGNAL", authorType: "USER", message: request.startSignalText });
+      }
+      if (request.text !== "") {
+        this.appendMessage(recorded, {
+          role: "USER",
+          messageType: "TEXT",
+          authorType: "USER",
+          message: buildStoredMessageText(request.text, request.attachments)
+        });
+      }
+      const messagesBeforeTheAnswer = copyOf(recorded.messages);
+      this.appendScriptedAssistantAnswer(recorded);
+      return { conversation: copyOf(recorded.conversation), messages: messagesBeforeTheAnswer, reopenedExisting: false };
+    };
+    this.postMessage = async (conversationId, message) => {
+      this.countRequest("postMessage");
+      const recorded = this.readOpenRecord(conversationId);
+      this.appendMessage(recorded, {
+        role: "USER",
+        messageType: "TEXT",
+        authorType: "USER",
+        message: buildStoredMessageText(message.text, message.attachments)
+      });
+      const messagesBeforeTheAnswer = copyOf(recorded.messages);
+      this.appendScriptedAssistantAnswer(recorded);
+      return { messages: messagesBeforeTheAnswer };
+    };
+    this.injectSignal = async (conversationId, signal) => {
+      this.countRequest("injectSignal");
+      const recorded = this.readOpenRecord(conversationId);
+      this.appendMessage(recorded, {
+        role: "USER",
+        messageType: "SIGNAL",
+        authorType: "USER",
+        message: signal.text,
+        signalSource: signal.source ?? "FRONTEND_WIDGET_CLICK"
+      });
+      this.appendScriptedAssistantAnswer(recorded);
+    };
+    this.retryConversation = async (conversationId) => {
+      this.countRequest("retryConversation");
+      const recorded = this.readRecord(conversationId);
+      const newestMessage = sortByIndexAscending(recorded.messages).pop();
+      if (newestMessage === void 0 || newestMessage.role === "ASSISTANT") {
+        throw new AgentsClientError("other", { httpStatus: 400, message: "Nothing to retry." });
+      }
+      this.appendScriptedAssistantAnswer(recorded);
+    };
+    this.renameConversation = async (conversationId, title) => {
+      this.countRequest("renameConversation");
+      const recorded = this.readRecord(conversationId);
+      recorded.conversation.title = title;
+      recorded.conversation.titleManuallyEdited = true;
+      return copyOf(recorded.conversation);
+    };
+    this.deleteConversation = async (conversationId) => {
+      this.countRequest("deleteConversation");
+      this.readRecord(conversationId);
+      this.recordsByConversationId.delete(conversationId);
+    };
+    this.subscribeToRecordedConversationChanges = (conversationId, onChange, onEnded) => {
+      const subscriber = { onChange, onEnded };
+      const subscribers = this.subscribersByConversationId.get(conversationId) ?? /* @__PURE__ */ new Set();
+      subscribers.add(subscriber);
+      this.subscribersByConversationId.set(conversationId, subscribers);
+      const record = this.recordsByConversationId.get(conversationId);
+      if (record) {
+        onChange(this.buildSignal(record, this.readSignalState(conversationId), null));
+      }
+      return () => {
+        subscribers.delete(subscriber);
+      };
+    };
+    this.emit = (conversationId, change = {}) => {
+      const record = this.readRecord(conversationId);
+      const signalState = this.readSignalState(conversationId);
+      signalState.changeCounter += 1;
+      if (change.summaryChanged) {
+        signalState.summaryUpdatedAt = (signalState.summaryUpdatedAt ?? 0) + 1;
+      }
+      const signal = this.buildSignal(record, signalState, change.runStatus ?? null);
+      for (const subscriber of [...this.subscribersByConversationId.get(conversationId) ?? []]) {
+        subscriber.onChange(copyOf(signal));
+      }
+      return signal;
+    };
+    this.end = (conversationId, reason) => {
+      const subscribers = [...this.subscribersByConversationId.get(conversationId) ?? []];
+      this.subscribersByConversationId.delete(conversationId);
+      for (const subscriber of subscribers) {
+        subscriber.onEnded(reason);
+      }
+    };
+    this.setRunState = (conversationId, runState) => {
+      this.readRecord(conversationId).conversation.runState = runState;
+    };
+    this.readRequestCount = (operation) => {
+      if (operation !== void 0) return this.requestCountsByOperation.get(operation) ?? 0;
+      let requestCount = 0;
+      for (const operationRequestCount of this.requestCountsByOperation.values()) requestCount += operationRequestCount;
+      return requestCount;
+    };
+    this.readStoredMessages = (conversationId) => copyOf(sortByIndexAscending(this.readRecord(conversationId).messages));
+    this.readSelectableModels = async () => {
+      this.countRequest("getSelectableModels");
+      return copyOf(this.selectableModels ?? []);
+    };
+    this.readMessageSentPayload = async (conversationId, messageId) => {
+      this.countRequest("getMessageSentPayload");
+      this.readRecord(conversationId);
+      const sentPayload = this.sentPayloadsByMessageId?.[messageId];
+      if (sentPayload === void 0) {
+        throw new AgentsClientError("notFound", { httpStatus: 404, message: `No sent payload for message ${messageId}.` });
+      }
+      return copyOf(sentPayload);
+    };
+    this.storeAssistantAnswer = (recorded, answerText) => {
+      this.appendMessage(recorded, {
+        role: "ASSISTANT",
+        messageType: "TEXT",
+        authorType: "ASSISTANT",
+        message: answerText
+      });
+      recorded.conversation.runState = "IDLE";
+    };
+    for (const recordedConversation of copyOf(data.conversations)) {
+      this.recordsByConversationId.set(recordedConversation.conversation.id, recordedConversation);
+    }
+    const scriptedAssistantAnswers = data.scriptedAssistantAnswers ?? [];
+    this.scriptedAssistantAnswers = scriptedAssistantAnswers.length > 0 ? [...scriptedAssistantAnswers] : [DEFAULT_SCRIPTED_ASSISTANT_ANSWER];
+    this.defaultPageSize = data.defaultPageSize ?? DEFAULT_PAGE_SIZE;
+    this.selectableModels = data.selectableModels ? copyOf(data.selectableModels) : void 0;
+    if (this.selectableModels) {
+      this.getSelectableModels = this.readSelectableModels;
+    }
+    this.sentPayloadsByMessageId = data.sentPayloadsByMessageId ? copyOf(data.sentPayloadsByMessageId) : void 0;
+    if (this.sentPayloadsByMessageId) {
+      this.getMessageSentPayload = this.readMessageSentPayload;
+    }
+    this.assistantAnswerDelayMs = data.assistantAnswerDelayMs ?? 0;
+    if (!data.withoutChangeSubscription) {
+      this.subscribeToConversationChanges = this.subscribeToRecordedConversationChanges;
+    }
+    const allMessageIds = data.conversations.flatMap((recorded) => recorded.messages.map((message) => message.id));
+    const allConversationIds = data.conversations.map((recorded) => recorded.conversation.id);
+    this.nextMessageId = Math.max(0, ...allMessageIds) + 1;
+    this.nextConversationId = Math.max(0, ...allConversationIds) + 1;
+  }
+  // ── Internals ─────────────────────────────────────────────────────────────────────────────────────────────────
+  countRequest(operation) {
+    this.requestCountsByOperation.set(operation, (this.requestCountsByOperation.get(operation) ?? 0) + 1);
+  }
+  readMessagesNewestFirst(conversationId) {
+    return sortByIndexAscending(this.readRecord(conversationId).messages).reverse();
+  }
+  readRecord(conversationId) {
+    const recorded = this.recordsByConversationId.get(conversationId);
+    if (!recorded) {
+      throw new AgentsClientError("notFound", { httpStatus: 404, message: `Conversation ${conversationId} not found.` });
+    }
+    return recorded;
+  }
+  /** The record of a conversation that still takes input; a completed or cancelled one refuses like the server. */
+  readOpenRecord(conversationId) {
+    const recorded = this.readRecord(conversationId);
+    const runState = recorded.conversation.runState;
+    if (runState !== null && CONVERSATION_RUN_STATES_THAT_END_THE_CONVERSATION.includes(runState)) {
+      throw new AgentsClientError("closed", { httpStatus: 400, code: "CONVERSATION_CLOSED" });
+    }
+    return recorded;
+  }
+  readSignalState(conversationId) {
+    const existingSignalState = this.signalStateByConversationId.get(conversationId);
+    if (existingSignalState) return existingSignalState;
+    const signalState = { changeCounter: 0, summaryUpdatedAt: null };
+    this.signalStateByConversationId.set(conversationId, signalState);
+    return signalState;
+  }
+  buildSignal(recorded, signalState, runStatus) {
+    const newestMessage = sortByIndexAscending(recorded.messages).pop();
+    return {
+      changeCounter: signalState.changeCounter,
+      lastMessageId: newestMessage?.id ?? null,
+      runStatus: runStatus ?? readConversationRunStatusOfRunState(recorded.conversation.runState),
+      summaryUpdatedAt: signalState.summaryUpdatedAt
+    };
+  }
+  appendMessage(recorded, fields) {
+    const highestIndex = Math.max(-1, ...recorded.messages.map((message) => message.indexInConversation ?? -1));
+    const storedMessage = {
+      id: this.nextMessageId,
+      conversationId: recorded.conversation.id,
+      indexInConversation: highestIndex + 1,
+      status: "COMPLETED",
+      signalSource: null,
+      createdDate: null,
+      toolCall: null,
+      delegatedConversations: [],
+      subAgent: null,
+      ...fields
+    };
+    this.nextMessageId += 1;
+    recorded.messages.push(storedMessage);
+    return storedMessage;
+  }
+  /** The next scripted answer: stored at once, or after `assistantAnswerDelayMs` with the run state RUNNING meanwhile. */
+  appendScriptedAssistantAnswer(recorded) {
+    const answerIndex = Math.min(this.scriptedAssistantAnswersUsed, this.scriptedAssistantAnswers.length - 1);
+    this.scriptedAssistantAnswersUsed += 1;
+    const answerText = this.scriptedAssistantAnswers[answerIndex];
+    if (this.assistantAnswerDelayMs <= 0) {
+      this.storeAssistantAnswer(recorded, answerText);
+      return;
+    }
+    recorded.conversation.runState = "RUNNING";
+    setTimeout(this.storeAssistantAnswer, this.assistantAnswerDelayMs, recorded, answerText);
+  }
+  findMessageSearchHits(recorded, text) {
+    if (text.trim() === "") return [];
+    return sortByIndexAscending(recorded.messages).filter((message) => message.messageType === "TEXT" && textContains(message.message, text)).map((message) => ({
+      messageId: message.id,
+      conversationId: recorded.conversation.id,
+      indexInConversation: message.indexInConversation,
+      role: message.role,
+      excerpt: message.message,
+      relevance: 1,
+      created: message.createdDate,
+      updated: null,
+      title: recorded.conversation.title
+    }));
+  }
+}
+const createInMemoryAgentsConversationClient = (data) => new InMemoryAgentsConversationClient(data);
+export {
+  InMemoryAgentsConversationClient,
+  createInMemoryAgentsConversationClient
+};
+//# sourceMappingURL=client-testing.js.map