@vinaverse/client 0.1.0-alpha.11 → 0.1.0-alpha.13

package/dist/history/index.js

@@ -1,6 +1,6 @@
-import { isRefusal } from '../chunk-JI6HUXH3.js';
-import '../chunk-46D3FSLU.js';
-import '../chunk-GWLLUOFY.js';
+import { isRefusal } from '../chunk-WOMAGTI5.js';
+import '../chunk-5HKZB2CJ.js';
+import '../chunk-LAB2FPXF.js';
 
 // src/history/index.ts
 function continueKey(conversation, subject, thread) {
@@ -11,6 +11,10 @@ function continueKey(conversation, subject, thread) {
     ...thread ? { thread } : {}
   };
 }
+function summaryTitle(conversation, own) {
+  const anchor = conversation.anchor;
+  return typeof anchor?.title === "string" && anchor.title || own || conversation.title;
+}
 function historyItems(data) {
   return data.map((item, seq) => {
     if (item.type === "card") {
@@ -39,7 +43,8 @@ function historyItems(data) {
       text: item.text,
       state: "sent",
       ...item.interrupted ? { partial: "interrupted" } : {},
-      ...item.refusal ? { refusal: true } : {}
+      ...item.refusal ? { refusal: true } : {},
+      at: item.at
     };
     return message;
   });
@@ -256,6 +261,6 @@ function createAgentTranscript(options) {
   };
 }
 
-export { continueKey, createAgentHistory, createAgentTranscript, historyItems };
+export { continueKey, createAgentHistory, createAgentTranscript, historyItems, summaryTitle };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/history/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/history/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// @vinaverse/client/history: a person's past conversations with the agent (C2), through the tenant's backend\n// (`AgentBackend.listConversations`, `readConversation`): the list, newest activity first, a page at a time; a past\n// conversation's transcript, newest page first, earlier pages prepended; delete through the runtime. No React: the\n// kits bind to it. Nothing begun before a sign-out lands after it (the runtime's `epoch`).\nimport {\n  type AgentBackend,\n  type AgentFailureReason,\n  type AgentKey,\n  type AgentRuntime,\n  isRefusal,\n} from '../agent/runtime.js';\nimport type {\n  CardItem,\n  MessageItem,\n  TimelineItem,\n} from '../conversation/view.js';\nimport type { Schemas } from '../events.js';\n\nexport type ConversationSummary = Schemas['ConversationSummary'];\ntype HistoryItem = Schemas['TimelineItem'];\n\n/**\n * The key a past conversation continues under for this person: its side and business as it was bound when it started\n * (`experience_mode`, `business_scope_id`), the `thread` given (default `chat`). For `runtime.continue(key, id)` and\n * `deleteConversation(key, id)`, so the device forgets it only where that key still continues it.\n */\nexport function continueKey(\n  conversation: ConversationSummary,\n  subject: string | null,\n  thread?: string,\n): AgentKey {\n  return {\n    subject,\n    mode: conversation.experience_mode,\n    scope: conversation.business_scope_id ?? null,\n    ...(thread ? { thread } : {}),\n  };\n}\n\n/**\n * A past conversation's items as the kits draw them: messages as sent (an `assistant` reply is the agent's, cut-off\n * replies and refusals marked), cards restored (drawn as they were, taking no answer or action), a proposal with the\n * outcome it had. Keyed by the server's ids, so pages merge without doubles.\n */\nexport function historyItems(data: readonly HistoryItem[]): TimelineItem[] {\n  return data.map((item, seq): TimelineItem => {\n    if (item.type === 'card') {\n      const outcome = item.proposal_outcome;\n      const card: CardItem = {\n        type: 'card',\n        key: item.card.id,\n        busy: false,\n        restored: true,\n        card: {\n          id: item.card.id,\n          kind: item.card.kind,\n          card: item.card as unknown as Readonly<Record<string, unknown>>,\n          locked: [],\n          turnId: item.turn_id,\n          outcome: outcome && outcome !== 'pending' ? outcome : null,\n          seq,\n        },\n      };\n      return card;\n    }\n    const message: MessageItem = {\n      type: 'message',\n      key: `h:${item.id}`,\n      role: item.role === 'assistant' ? 'agent' : item.role,\n      text: item.text,\n      state: 'sent',\n      ...(item.interrupted ? { partial: 'interrupted' as const } : {}),\n      ...(item.refusal ? { refusal: true as const } : {}),\n    };\n    return message;\n  });\n}\n\n/** Why a page could not be read, as the runtime says it. */\nfunction reasonOf(error: unknown): AgentFailureReason {\n  if (isRefusal(error)) return error.reason;\n  const given = (error as { reason?: unknown } | null)?.reason;\n  return typeof given === 'string' ? (given as AgentFailureReason) : 'unknown';\n}\n\n/**\n * The cursor restart (`vinaverse.agent-backend/1`): a page asked with a cursor, refused `unavailable`, not retryable,\n * with the gateway's `invalid_request`, had a cursor the gateway no longer takes (stale, or of other filters). Asked\n * again from the first page, once. Any other refusal is said as it is.\n */\nfunction staleCursor(error: unknown): boolean {\n  const e = error as {\n    outcome?: unknown;\n    gatewayCode?: unknown;\n    retryable?: unknown;\n  } | null;\n  return (\n    e?.outcome === 'unavailable' &&\n    e.gatewayCode === 'invalid_request' &&\n    e.retryable === false\n  );\n}\n\n/** A paged store: one page read at a time, dropped when it lands after a newer read or a sign-out. */\nfunction paged<S extends { readonly loading: boolean }>(\n  runtime: AgentRuntime,\n  empty: S,\n) {\n  let state = empty;\n  let epoch = runtime.epoch();\n  let asked = 0;\n  const listeners = new Set<() => void>();\n  const set = (next: Partial<S>) => {\n    state = { ...state, ...next };\n    for (const l of [...listeners]) l();\n  };\n  // A sign-out empties what the last person had, as soon as anyone listens again.\n  const fresh = () => {\n    if (runtime.epoch() === epoch) return;\n    epoch = runtime.epoch();\n    asked++;\n    state = empty;\n  };\n  let off: (() => void) | null = null;\n  return {\n    get: () => {\n      fresh();\n      return state;\n    },\n    set,\n    subscribe(listener: () => void) {\n      listeners.add(listener);\n      off ??= runtime.subscribe(() => {\n        const before = state;\n        fresh();\n        if (state !== before) for (const l of [...listeners]) l();\n      });\n      return () => {\n        listeners.delete(listener);\n        if (listeners.size === 0) {\n          off?.();\n          off = null;\n        }\n      };\n    },\n    /** Reads a page; `apply` lands only for the newest read, under the same person. */\n    read<T>(\n      call: () => Promise<T>,\n      apply: (value: T) => void,\n      failed: (error: unknown) => void,\n    ) {\n      fresh();\n      const mine = ++asked;\n      const under = epoch;\n      set({ loading: true } as Partial<S>);\n      call().then(\n        (value) => {\n          if (mine === asked && under === runtime.epoch()) apply(value);\n        },\n        (error: unknown) => {\n          if (mine === asked && under === runtime.epoch()) failed(error);\n        },\n      );\n    },\n  };\n}\n\nexport interface AgentHistoryState {\n  readonly conversations: readonly ConversationSummary[];\n  /** A page is being read. */\n  readonly loading: boolean;\n  /** Why the last page could not be read; null when it was. `off` when the backend serves no history. */\n  readonly failure: AgentFailureReason | null;\n  /** Every page is read. */\n  readonly done: boolean;\n  /** The first page was asked for. */\n  readonly started: boolean;\n}\n\nexport interface AgentHistory {\n  getSnapshot(): AgentHistoryState;\n  subscribe(listener: () => void): () => void;\n  /** Reads the first page anew: the first time, after a failure, or to see what changed. */\n  refresh(): void;\n  /** The next older page, when there is one and none is being read. */\n  loadMore(): void;\n  /** Reads again the page that failed: the first (as `refresh`), or the next. */\n  retry(): void;\n  /**\n   * Deletes a past conversation (the runtime's `deleteConversation` for the key that holds it, so the device forgets\n   * it only where the key still continues it) and drops its row. One already gone (`not_found`) is dropped too.\n   */\n  remove(key: AgentKey, conversationId: string): Promise<void>;\n}\n\nexport interface AgentHistoryOptions {\n  readonly runtime: AgentRuntime;\n  /** Default: the runtime's. */\n  readonly backend?: AgentBackend;\n  /** The app's side: `customer` or `business`. */\n  readonly mode: string;\n  /** The business acted for, with `business`. */\n  readonly scope?: string | null;\n  /** The agent, for a backend that serves more than one. */\n  readonly agent?: string | null;\n  /** Conversations per page (1–50). Default 20. */\n  readonly pageSize?: number;\n}\n\nconst NO_HISTORY: AgentHistoryState = {\n  conversations: [],\n  loading: false,\n  failure: null,\n  done: false,\n  started: false,\n};\n\n/** A person's past conversations, newest activity first. */\nexport function createAgentHistory(options: AgentHistoryOptions): AgentHistory {\n  const { runtime } = options;\n  const backend = options.backend ?? runtime.backend;\n  const store = paged(runtime, NO_HISTORY);\n  let cursor: string | null = null;\n  let restarted = false;\n  const page = (from: string | null) => {\n    const list = backend.listConversations?.bind(backend);\n    if (!list) {\n      store.set({ started: true, failure: 'off', done: true });\n      return;\n    }\n    store.read(\n      () =>\n        list({\n          mode: options.mode,\n          scope: options.scope ?? null,\n          agent: options.agent ?? null,\n          limit: options.pageSize ?? 20,\n          cursor: from,\n        }),\n      (got) => {\n        const known = new Set(\n          from ? store.get().conversations.map((c) => c.id) : [],\n        );\n        cursor = got.next_cursor;\n        store.set({\n          conversations: [\n            ...(from ? store.get().conversations : []),\n            ...got.data.filter((c) => !known.has(c.id)),\n          ],\n          loading: false,\n          failure: null,\n          done: cursor === null,\n        });\n      },\n      (error) => {\n        if (from !== null && staleCursor(error) && !restarted) {\n          restarted = true;\n          cursor = null;\n          page(null);\n          return;\n        }\n        store.set({ loading: false, failure: reasonOf(error) });\n      },\n    );\n  };\n  const refresh = () => {\n    cursor = null;\n    restarted = false;\n    store.set({ started: true });\n    page(null);\n  };\n  const loadMore = () => {\n    const s = store.get();\n    if (!s.started || s.loading || s.done || cursor === null) return;\n    page(cursor);\n  };\n  return {\n    getSnapshot: store.get,\n    subscribe: store.subscribe,\n    refresh,\n    loadMore,\n    retry: () => (cursor === null ? refresh() : loadMore()),\n    async remove(key, conversationId) {\n      try {\n        await runtime.deleteConversation(key, conversationId);\n      } catch (error) {\n        if (!(isRefusal(error) && error.reason === 'not_found')) throw error;\n      }\n      store.set({\n        conversations: store\n          .get()\n          .conversations.filter((c) => c.id !== conversationId),\n      });\n    },\n  };\n}\n\nexport interface AgentTranscriptState {\n  /** The conversation's items, oldest first, as the kits draw them (`historyItems`). */\n  readonly items: readonly TimelineItem[];\n  readonly loading: boolean;\n  /** Why the last page could not be read: `not_found` (deleted, or never theirs), `expired`, … */\n  readonly failure: AgentFailureReason | null;\n  /** Nothing earlier to read. */\n  readonly done: boolean;\n  readonly started: boolean;\n}\n\nexport interface AgentTranscript {\n  getSnapshot(): AgentTranscriptState;\n  subscribe(listener: () => void): () => void;\n  /** Reads the newest page anew. */\n  load(): void;\n  /** The page before the earliest read, prepended. */\n  loadEarlier(): void;\n  /** Reads again the page that failed: the newest (as `load`), or the earlier one. */\n  retry(): void;\n}\n\nexport interface AgentTranscriptOptions {\n  readonly runtime: AgentRuntime;\n  /** Default: the runtime's. */\n  readonly backend?: AgentBackend;\n  readonly conversationId: string;\n  /** Items per page. Default 30. */\n  readonly pageSize?: number;\n}\n\nconst NO_TRANSCRIPT: AgentTranscriptState = {\n  items: [],\n  loading: false,\n  failure: null,\n  done: false,\n  started: false,\n};\n\n/** A past conversation's transcript, read-only: newest page first, earlier pages prepended. */\nexport function createAgentTranscript(\n  options: AgentTranscriptOptions,\n): AgentTranscript {\n  const { runtime } = options;\n  const backend = options.backend ?? runtime.backend;\n  const store = paged(runtime, NO_TRANSCRIPT);\n  let cursor: string | null = null;\n  let restarted = false;\n  const page = (from: string | null) => {\n    const read = backend.readConversation?.bind(backend);\n    if (!read) {\n      store.set({ started: true, failure: 'off', done: true });\n      return;\n    }\n    store.read(\n      () =>\n        read(options.conversationId, {\n          limit: options.pageSize ?? 30,\n          cursor: from,\n        }),\n      (got) => {\n        const earlier = historyItems(got.data);\n        const held = from ? store.get().items : [];\n        const keys = new Set(held.map((i) => i.key));\n        cursor = got.next_cursor;\n        store.set({\n          items: [...earlier.filter((i) => !keys.has(i.key)), ...held],\n          loading: false,\n          failure: null,\n          done: cursor === null,\n        });\n      },\n      (error) => {\n        // An earlier page's cursor went stale: read back from the newest page, once.\n        if (from !== null && staleCursor(error) && !restarted) {\n          restarted = true;\n          cursor = null;\n          page(null);\n          return;\n        }\n        store.set({ loading: false, failure: reasonOf(error) });\n      },\n    );\n  };\n  const load = () => {\n    cursor = null;\n    restarted = false;\n    store.set({ started: true });\n    page(null);\n  };\n  const loadEarlier = () => {\n    const s = store.get();\n    if (!s.started || s.loading || s.done || cursor === null) return;\n    page(cursor);\n  };\n  return {\n    getSnapshot: store.get,\n    subscribe: store.subscribe,\n    load,\n    loadEarlier,\n    retry: () => (cursor === null ? load() : loadEarlier()),\n  };\n}\n"]}
+{"version":3,"sources":["../../src/history/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// @vinaverse/client/history: a person's past conversations with the agent (C2), through the tenant's backend\n// (`AgentBackend.listConversations`, `readConversation`): the list, newest activity first, a page at a time; a past\n// conversation's transcript, newest page first, earlier pages prepended; delete through the runtime. No React: the\n// kits bind to it. Nothing begun before a sign-out lands after it (the runtime's `epoch`).\nimport {\n  type AgentBackend,\n  type AgentFailureReason,\n  type AgentKey,\n  type AgentRuntime,\n  isRefusal,\n} from '../agent/runtime.js';\nimport type {\n  CardItem,\n  MessageItem,\n  TimelineItem,\n} from '../conversation/view.js';\nimport type { Schemas } from '../events.js';\n\nexport type ConversationSummary = Schemas['ConversationSummary'];\ntype HistoryItem = Schemas['TimelineItem'];\n\n/**\n * The key a past conversation continues under for this person: its side and business as it was bound when it started\n * (`experience_mode`, `business_scope_id`), the `thread` given (default `chat`). For `runtime.continue(key, id)` and\n * `deleteConversation(key, id)`, so the device forgets it only where that key still continues it.\n */\nexport function continueKey(\n  conversation: ConversationSummary,\n  subject: string | null,\n  thread?: string,\n): AgentKey {\n  return {\n    subject,\n    mode: conversation.experience_mode,\n    scope: conversation.business_scope_id ?? null,\n    ...(thread ? { thread } : {}),\n  };\n}\n\n/**\n * A past conversation's title for its row: the object's title when the conversation is about one (`anchor.title`,\n * vinaverse-v1 v1-draft.37, read once the summary carries it), else the app's own (`own`), else the server's. Never\n * the model's words, and never the person's.\n */\nexport function summaryTitle(\n  conversation: ConversationSummary,\n  own?: string | null,\n): string {\n  const anchor = (conversation as { readonly anchor?: { title?: unknown } })\n    .anchor;\n  return (\n    (typeof anchor?.title === 'string' && anchor.title) ||\n    own ||\n    conversation.title\n  );\n}\n\n/**\n * A past conversation's items as the kits draw them: messages as sent (an `assistant` reply is the agent's, cut-off\n * replies and refusals marked), cards restored (drawn as they were, taking no answer or action), a proposal with the\n * outcome it had. Keyed by the server's ids, so pages merge without doubles.\n */\nexport function historyItems(data: readonly HistoryItem[]): TimelineItem[] {\n  return data.map((item, seq): TimelineItem => {\n    if (item.type === 'card') {\n      const outcome = item.proposal_outcome;\n      const card: CardItem = {\n        type: 'card',\n        key: item.card.id,\n        busy: false,\n        restored: true,\n        card: {\n          id: item.card.id,\n          kind: item.card.kind,\n          card: item.card as unknown as Readonly<Record<string, unknown>>,\n          locked: [],\n          turnId: item.turn_id,\n          outcome: outcome && outcome !== 'pending' ? outcome : null,\n          seq,\n        },\n      };\n      return card;\n    }\n    const message: MessageItem = {\n      type: 'message',\n      key: `h:${item.id}`,\n      role: item.role === 'assistant' ? 'agent' : item.role,\n      text: item.text,\n      state: 'sent',\n      ...(item.interrupted ? { partial: 'interrupted' as const } : {}),\n      ...(item.refusal ? { refusal: true as const } : {}),\n      at: item.at,\n    };\n    return message;\n  });\n}\n\n/** Why a page could not be read, as the runtime says it. */\nfunction reasonOf(error: unknown): AgentFailureReason {\n  if (isRefusal(error)) return error.reason;\n  const given = (error as { reason?: unknown } | null)?.reason;\n  return typeof given === 'string' ? (given as AgentFailureReason) : 'unknown';\n}\n\n/**\n * The cursor restart (`vinaverse.agent-backend/1`): a page asked with a cursor, refused `unavailable`, not retryable,\n * with the gateway's `invalid_request`, had a cursor the gateway no longer takes (stale, or of other filters). Asked\n * again from the first page, once. Any other refusal is said as it is.\n */\nfunction staleCursor(error: unknown): boolean {\n  const e = error as {\n    outcome?: unknown;\n    gatewayCode?: unknown;\n    retryable?: unknown;\n  } | null;\n  return (\n    e?.outcome === 'unavailable' &&\n    e.gatewayCode === 'invalid_request' &&\n    e.retryable === false\n  );\n}\n\n/** A paged store: one page read at a time, dropped when it lands after a newer read or a sign-out. */\nfunction paged<S extends { readonly loading: boolean }>(\n  runtime: AgentRuntime,\n  empty: S,\n) {\n  let state = empty;\n  let epoch = runtime.epoch();\n  let asked = 0;\n  const listeners = new Set<() => void>();\n  const set = (next: Partial<S>) => {\n    state = { ...state, ...next };\n    for (const l of [...listeners]) l();\n  };\n  // A sign-out empties what the last person had, as soon as anyone listens again.\n  const fresh = () => {\n    if (runtime.epoch() === epoch) return;\n    epoch = runtime.epoch();\n    asked++;\n    state = empty;\n  };\n  let off: (() => void) | null = null;\n  return {\n    get: () => {\n      fresh();\n      return state;\n    },\n    set,\n    subscribe(listener: () => void) {\n      listeners.add(listener);\n      off ??= runtime.subscribe(() => {\n        const before = state;\n        fresh();\n        if (state !== before) for (const l of [...listeners]) l();\n      });\n      return () => {\n        listeners.delete(listener);\n        if (listeners.size === 0) {\n          off?.();\n          off = null;\n        }\n      };\n    },\n    /** Reads a page; `apply` lands only for the newest read, under the same person. */\n    read<T>(\n      call: () => Promise<T>,\n      apply: (value: T) => void,\n      failed: (error: unknown) => void,\n    ) {\n      fresh();\n      const mine = ++asked;\n      const under = epoch;\n      set({ loading: true } as Partial<S>);\n      call().then(\n        (value) => {\n          if (mine === asked && under === runtime.epoch()) apply(value);\n        },\n        (error: unknown) => {\n          if (mine === asked && under === runtime.epoch()) failed(error);\n        },\n      );\n    },\n  };\n}\n\nexport interface AgentHistoryState {\n  readonly conversations: readonly ConversationSummary[];\n  /** A page is being read. */\n  readonly loading: boolean;\n  /** Why the last page could not be read; null when it was. `off` when the backend serves no history. */\n  readonly failure: AgentFailureReason | null;\n  /** Every page is read. */\n  readonly done: boolean;\n  /** The first page was asked for. */\n  readonly started: boolean;\n}\n\nexport interface AgentHistory {\n  getSnapshot(): AgentHistoryState;\n  subscribe(listener: () => void): () => void;\n  /** Reads the first page anew: the first time, after a failure, or to see what changed. */\n  refresh(): void;\n  /** The next older page, when there is one and none is being read. */\n  loadMore(): void;\n  /** Reads again the page that failed: the first (as `refresh`), or the next. */\n  retry(): void;\n  /**\n   * Deletes a past conversation (the runtime's `deleteConversation` for the key that holds it, so the device forgets\n   * it only where the key still continues it) and drops its row. One already gone (`not_found`) is dropped too.\n   */\n  remove(key: AgentKey, conversationId: string): Promise<void>;\n}\n\nexport interface AgentHistoryOptions {\n  readonly runtime: AgentRuntime;\n  /** Default: the runtime's. */\n  readonly backend?: AgentBackend;\n  /** The app's side: `customer` or `business`. */\n  readonly mode: string;\n  /** The business acted for, with `business`. */\n  readonly scope?: string | null;\n  /** The agent, for a backend that serves more than one. */\n  readonly agent?: string | null;\n  /** Conversations per page (1–50). Default 20. */\n  readonly pageSize?: number;\n}\n\nconst NO_HISTORY: AgentHistoryState = {\n  conversations: [],\n  loading: false,\n  failure: null,\n  done: false,\n  started: false,\n};\n\n/** A person's past conversations, newest activity first. */\nexport function createAgentHistory(options: AgentHistoryOptions): AgentHistory {\n  const { runtime } = options;\n  const backend = options.backend ?? runtime.backend;\n  const store = paged(runtime, NO_HISTORY);\n  let cursor: string | null = null;\n  let restarted = false;\n  const page = (from: string | null) => {\n    const list = backend.listConversations?.bind(backend);\n    if (!list) {\n      store.set({ started: true, failure: 'off', done: true });\n      return;\n    }\n    store.read(\n      () =>\n        list({\n          mode: options.mode,\n          scope: options.scope ?? null,\n          agent: options.agent ?? null,\n          limit: options.pageSize ?? 20,\n          cursor: from,\n        }),\n      (got) => {\n        const known = new Set(\n          from ? store.get().conversations.map((c) => c.id) : [],\n        );\n        cursor = got.next_cursor;\n        store.set({\n          conversations: [\n            ...(from ? store.get().conversations : []),\n            ...got.data.filter((c) => !known.has(c.id)),\n          ],\n          loading: false,\n          failure: null,\n          done: cursor === null,\n        });\n      },\n      (error) => {\n        if (from !== null && staleCursor(error) && !restarted) {\n          restarted = true;\n          cursor = null;\n          page(null);\n          return;\n        }\n        store.set({ loading: false, failure: reasonOf(error) });\n      },\n    );\n  };\n  const refresh = () => {\n    cursor = null;\n    restarted = false;\n    store.set({ started: true });\n    page(null);\n  };\n  const loadMore = () => {\n    const s = store.get();\n    if (!s.started || s.loading || s.done || cursor === null) return;\n    page(cursor);\n  };\n  return {\n    getSnapshot: store.get,\n    subscribe: store.subscribe,\n    refresh,\n    loadMore,\n    retry: () => (cursor === null ? refresh() : loadMore()),\n    async remove(key, conversationId) {\n      try {\n        await runtime.deleteConversation(key, conversationId);\n      } catch (error) {\n        if (!(isRefusal(error) && error.reason === 'not_found')) throw error;\n      }\n      store.set({\n        conversations: store\n          .get()\n          .conversations.filter((c) => c.id !== conversationId),\n      });\n    },\n  };\n}\n\nexport interface AgentTranscriptState {\n  /** The conversation's items, oldest first, as the kits draw them (`historyItems`). */\n  readonly items: readonly TimelineItem[];\n  readonly loading: boolean;\n  /** Why the last page could not be read: `not_found` (deleted, or never theirs), `expired`, … */\n  readonly failure: AgentFailureReason | null;\n  /** Nothing earlier to read. */\n  readonly done: boolean;\n  readonly started: boolean;\n}\n\nexport interface AgentTranscript {\n  getSnapshot(): AgentTranscriptState;\n  subscribe(listener: () => void): () => void;\n  /** Reads the newest page anew. */\n  load(): void;\n  /** The page before the earliest read, prepended. */\n  loadEarlier(): void;\n  /** Reads again the page that failed: the newest (as `load`), or the earlier one. */\n  retry(): void;\n}\n\nexport interface AgentTranscriptOptions {\n  readonly runtime: AgentRuntime;\n  /** Default: the runtime's. */\n  readonly backend?: AgentBackend;\n  readonly conversationId: string;\n  /** Items per page. Default 30. */\n  readonly pageSize?: number;\n}\n\nconst NO_TRANSCRIPT: AgentTranscriptState = {\n  items: [],\n  loading: false,\n  failure: null,\n  done: false,\n  started: false,\n};\n\n/** A past conversation's transcript, read-only: newest page first, earlier pages prepended. */\nexport function createAgentTranscript(\n  options: AgentTranscriptOptions,\n): AgentTranscript {\n  const { runtime } = options;\n  const backend = options.backend ?? runtime.backend;\n  const store = paged(runtime, NO_TRANSCRIPT);\n  let cursor: string | null = null;\n  let restarted = false;\n  const page = (from: string | null) => {\n    const read = backend.readConversation?.bind(backend);\n    if (!read) {\n      store.set({ started: true, failure: 'off', done: true });\n      return;\n    }\n    store.read(\n      () =>\n        read(options.conversationId, {\n          limit: options.pageSize ?? 30,\n          cursor: from,\n        }),\n      (got) => {\n        const earlier = historyItems(got.data);\n        const held = from ? store.get().items : [];\n        const keys = new Set(held.map((i) => i.key));\n        cursor = got.next_cursor;\n        store.set({\n          items: [...earlier.filter((i) => !keys.has(i.key)), ...held],\n          loading: false,\n          failure: null,\n          done: cursor === null,\n        });\n      },\n      (error) => {\n        // An earlier page's cursor went stale: read back from the newest page, once.\n        if (from !== null && staleCursor(error) && !restarted) {\n          restarted = true;\n          cursor = null;\n          page(null);\n          return;\n        }\n        store.set({ loading: false, failure: reasonOf(error) });\n      },\n    );\n  };\n  const load = () => {\n    cursor = null;\n    restarted = false;\n    store.set({ started: true });\n    page(null);\n  };\n  const loadEarlier = () => {\n    const s = store.get();\n    if (!s.started || s.loading || s.done || cursor === null) return;\n    page(cursor);\n  };\n  return {\n    getSnapshot: store.get,\n    subscribe: store.subscribe,\n    load,\n    loadEarlier,\n    retry: () => (cursor === null ? load() : loadEarlier()),\n  };\n}\n"]}

package/dist/index.cjs

@@ -18,6 +18,11 @@ var RECONNECTABLE = /* @__PURE__ */ new Set(["server_restart"]);
 var NEW_SESSION = /* @__PURE__ */ new Set(["idle", "expired", "limit_reached"]);
 var str = (v) => typeof v === "string" ? v : void 0;
 var ConversationEngine = class {
+  /** `now`: the clock a message is stamped by when the server gives no time. */
+  constructor(now = Date.now) {
+    this.now = now;
+  }
+  now;
   sessionId = null;
   conversationId = null;
   connection = null;
@@ -206,7 +211,14 @@ var ConversationEngine = class {
       case "message.staff": {
         const id = str(event.message_id);
         if (id !== void 0)
-          this.say("staff", str(event.text) ?? "", `s:${id}`);
+          this.say(
+            "staff",
+            str(event.text) ?? "",
+            `s:${id}`,
+            {},
+            void 0,
+            str(event.at)
+          );
         return;
       }
       case "input.received": {
@@ -288,7 +300,9 @@ var ConversationEngine = class {
             role,
             str(item.text) ?? "",
             transcriptKey(role, str(item.id), str(item.at)),
-            item.interrupted === true ? { partial: "interrupted" } : {}
+            item.interrupted === true ? { partial: "interrupted" } : {},
+            void 0,
+            str(item.at)
           );
         }
       }
@@ -333,7 +347,8 @@ var ConversationEngine = class {
             text,
             key,
             partial ? { partial } : {},
-            at
+            at,
+            str(item.at)
           );
         else
           this.messages = this.messages.map((m) => {
@@ -461,9 +476,16 @@ var ConversationEngine = class {
     this.unqueue(id);
   }
   /** Adds a message once: a key already held (a frame seen twice) changes nothing. */
-  say(role, text, key, extra = {}, seq) {
+  say(role, text, key, extra = {}, seq, at) {
     if (this.messages.some((m) => m.key === key)) return;
-    this.messages.push({ role, text, key, seq: seq ?? this.seq++, ...extra });
+    this.messages.push({
+      role,
+      text,
+      key,
+      seq: seq ?? this.seq++,
+      ...extra,
+      at: at || new Date(this.now()).toISOString()
+    });
   }
   /** The turn's streamed text, kept as the agent's message when the turn ends without its `message.completed`. */
   cutOff(partial) {
@@ -629,7 +651,8 @@ var CARD_KINDS = {
   question: true,
   proposal: true,
   next_step: true,
-  links: true
+  links: true,
+  anchor: true
 };
 function isKnownCard(card) {
   return Object.hasOwn(CARD_KINDS, card.kind);