@arbidocs/react 0.5.124 → 0.5.126

package/dist/artifacts/useArtifactSession.js

@@ -1,4 +1,5 @@
-import { useCallback, useMemo, useState } from "react";
+import { registerDocumentTurnFlush } from "../chat/turn-flush.js";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import { useMutation, useQueryClient } from "@tanstack/react-query";
 import { useArbi } from "../useArbi.js";
 import { arbiQueryKeys, useDocumentVersionList } from "../hooks.js";
@@ -34,13 +35,14 @@ function useSaveArtifactVersion() {
   const arbi = useArbi();
   const queryClient = useQueryClient();
   return useMutation({
-    mutationFn: async ({ title, content, versionOf, configId, wpType }) => {
+    mutationFn: async ({ title, content, versionOf, configId, wpType, autosave }) => {
       const fileName = /\.md$/i.test(title) ? title : `${title}.md`;
       const result = await arbi.documents.uploadFile(
         new Blob([content], { type: "text/markdown" }),
         fileName,
         {
           wpType: wpType ?? "artifact",
+          autosave,
           versionOf: versionOf ? parseVersionRef(versionOf).docId : void 0,
           configExtId: configId ?? void 0
         }
@@ -85,6 +87,7 @@ function useArtifactSession(options) {
     enabled: !!activeCompareId
   });
   const saveVersion = useSaveArtifactVersion();
+  const autosaveVersion = saveVersion.mutateAsync;
   const current = findVersion(versions, docId);
   const save = useCallback(
     async (content) => {
@@ -121,6 +124,36 @@ function useArtifactSession(options) {
     save,
     onSaved: handleSaved
   });
+  useEffect(() => {
+    if (isLocal || !session.hasChanges || session.isSaving) return;
+    const timer = setTimeout(() => {
+      void autosaveVersion({
+        title: title ?? current?.name ?? "Untitled",
+        content: session.content,
+        versionOf: docId,
+        configId,
+        autosave: true
+      }).catch(() => void 0);
+    }, 2500);
+    return () => clearTimeout(timer);
+  }, [
+    isLocal,
+    session.content,
+    session.hasChanges,
+    session.isSaving,
+    docId,
+    title,
+    current?.name,
+    configId,
+    autosaveVersion
+  ]);
+  useEffect(() => {
+    if (!docId) return;
+    return registerDocumentTurnFlush(docId, async () => {
+      if (session.hasChanges && !await session.save())
+        throw new Error("Save the document before sending your message.");
+    });
+  }, [docId, session]);
   const { redline } = session;
   return useMemo(
     () => ({
@@ -134,7 +167,7 @@ function useArtifactSession(options) {
       view: {
         content: session.baseline,
         isEditing: session.isEditing,
-        hasChanges: session.hasChanges,
+        hasChanges: session.hasChanges || !!current?.autosave,
         isSaving: session.isSaving,
         canCompare: session.canCompare,
         comparing: !!session.compareId,
@@ -162,7 +195,18 @@ function useArtifactSession(options) {
         onRevert: (regionId) => void session.revertRegion(regionId)
       }
     }),
-    [session, redline, isLoading, status, retry, isLocal, versions, docId]
+    [
+      session,
+      redline,
+      isLoading,
+      status,
+      retry,
+      isLocal,
+      versions,
+      docId,
+      current?.id,
+      current?.autosave
+    ]
   );
 }
 export {

package/dist/artifacts/useArtifactSession.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/artifacts/useArtifactSession.ts"],
-  "sourcesContent": ["import { useCallback, useMemo, useState } from 'react'\nimport { useMutation, useQueryClient } from '@tanstack/react-query'\nimport { useArbi } from '../useArbi'\nimport { arbiQueryKeys, useDocumentVersionList } from '../hooks'\nimport { refreshDocuments, useDocuments } from '../documents/documents-data'\nimport { useArtifactText, type ArtifactTextStatus } from './useArtifactText'\nimport {\n  documentVersions,\n  findVersion,\n  isDocumentId,\n  parseVersionRef,\n  toArtifactVersions,\n  versionLabel,\n  type ArtifactVersion,\n} from './versions'\nimport {\n  useArtifactEditSession,\n  type ArtifactEditSession,\n  type ArtifactEditSessionOptions,\n  type ArtifactSaveResult,\n} from './useArtifactEditSession'\n\n/**\n * The versions of an artifact, oldest first. `docId` is a document id or a version reference\n * (`doc-\u2026@v2`). Every listed document carries its versions; a document that is not in the\n * workspace list asks for its version list.\n */\nexport function useArtifactVersions(\n  workspaceId: string | undefined,\n  docId: string | null | undefined\n): ArtifactVersion[] {\n  const plainId = docId ? parseVersionRef(docId).docId : null\n  const { data: documents } = useDocuments(workspaceId)\n  const listed = useMemo(\n    () => (documents ?? []).find((d) => d.external_id === plainId),\n    [documents, plainId]\n  )\n  // Asked only once the list has loaded and the document is not in it.\n  const { data: history } = useDocumentVersionList(plainId, {\n    enabled: !!plainId && documents !== undefined && !listed,\n  })\n  return useMemo(\n    () => (listed ? documentVersions(listed) : toArtifactVersions(plainId, history)),\n    [listed, history, plainId]\n  )\n}\n\nexport interface SaveArtifactVersionInput {\n  /** File name of the new version (`.md` is added when missing). */\n  title: string\n  content: string\n  /** Save as the next version of this document (it keeps its id); omit for a new document. */\n  versionOf?: string | null\n  /** The processing config (auto-title, parsing) to run the upload with. */\n  configId?: string | null\n  /** `artifact` (default) for AI-style drafts; `source` for a document the user typed. */\n  wpType?: 'artifact' | 'source'\n}\n\n/**\n * Save markdown as a NEW immutable version (the next version of `versionOf`'s document, which keeps\n * its id) and refresh the workspace document list, version lists and the document's text.\n */\nexport function useSaveArtifactVersion() {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  return useMutation<ArtifactSaveResult, Error, SaveArtifactVersionInput>({\n    mutationFn: async ({ title, content, versionOf, configId, wpType }) => {\n      // The backend classifies uploads by extension: a title without one is silently dropped.\n      const fileName = /\\.md$/i.test(title) ? title : `${title}.md`\n      const result = await arbi.documents.uploadFile(\n        new Blob([content], { type: 'text/markdown' }),\n        fileName,\n        {\n          wpType: wpType ?? 'artifact',\n          versionOf: versionOf ? parseVersionRef(versionOf).docId : undefined,\n          configExtId: configId ?? undefined,\n        }\n      )\n      const docId = result.doc_ext_ids?.[0]\n      // The document's row moves to the new version (its version lists re-read with it).\n      if (docId) await refreshDocuments(queryClient, arbi, [docId])\n      await queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allDocumentVersions() })\n      // The document's current text is the new version's now.\n      if (docId)\n        await queryClient.invalidateQueries({ queryKey: arbiQueryKeys.parsedDocument(docId) })\n      return { docId, version: result.version ?? undefined }\n    },\n  })\n}\n\nexport interface ArtifactSessionOptions extends Pick<\n  ArtifactEditSessionOptions,\n  | 'onSaved'\n  | 'onSaveError'\n  | 'onCompareChange'\n  | 'compareId'\n  | 'compareOpensEditor'\n  | 'redlineEngine'\n  | 'onDirtyChange'\n> {\n  workspaceId: string | undefined\n  /**\n   * The open document (its current version), a version reference `doc-\u2026@v{n}`, or the placeholder\n   * id of an unsaved local draft (anything that is not a backend document id, i.e. does not start\n   * with `doc`).\n   */\n  docId: string | null | undefined\n  /**\n   * The text of a local draft (nothing is fetched for it). The FIRST save uploads it as a real\n   * document with no parent and the session switches to the new id; later saves chain from it.\n   */\n  draftContent?: string\n  /** Name for saved versions. Defaults to the open version's file name, else \"Untitled\". */\n  title?: string\n  /** Processing config for saved versions. */\n  configId?: string | null\n}\n\n/** Everything `ArtifactEditor` (`@arbidocs/blocks/artifacts`) takes from a session, flat. */\nexport interface ArtifactSessionView {\n  content: string\n  isEditing: boolean\n  hasChanges: boolean\n  isSaving: boolean\n  canCompare: boolean\n  comparing: boolean\n  compareId: string | null\n  showTrackChanges: boolean\n  versions: ArtifactVersion[]\n  currentVersionId: string\n  onStartEdit: () => void\n  onCancel: () => void\n  onSave: () => void\n  onCompare: () => void\n  onStopCompare: () => void\n  onToggleTrackChanges: () => void\n  /**\n   * Whether the text is ready. `ArtifactEditor` renders \"Preparing editor...\" while it is\n   * `loading` or `parsing` (a fresh upload is parsed for a few seconds) and an error with Retry.\n   */\n  status: ArtifactTextStatus\n  /** Ask for the text again after an `error`. */\n  onRetry: () => void\n}\n\nexport interface ArtifactSession extends ArtifactEditSession {\n  /** The open document: the new real id once a local draft has been saved. */\n  docId: string | null | undefined\n  /** The open version is an unsaved local draft (no backend document yet). */\n  isLocal: boolean\n  isLoading: boolean\n  /** See `ArtifactTextStatus`. */\n  status: ArtifactTextStatus\n  versions: ArtifactVersion[]\n  /** \"v2\" for any version (reference) of the document. */\n  labelOf: (id: string | null | undefined) => string | null\n  /** Props for `<ArtifactEditor>`. */\n  view: ArtifactSessionView\n  /** Props for `<ArtifactMarkdownEditor>` (`@arbidocs/blocks/artifacts/editor`). */\n  editorProps: {\n    markdown: string\n    onChange: (markdown: string) => void\n    onNormalized: (markdown: string) => void\n  }\n  /** Props for `<ArtifactRedlineView>`. */\n  redlineProps: {\n    state: ArtifactEditSession['redline']['state']\n    onRevert: (regionId: string) => void\n  }\n}\n\n/**\n * Edit an artifact through the SDK: load it, edit it, save it as a new version, list its versions\n * and compare any two with track changes. Needs an `<ArbiHost>` with an `arbi` and a selected workspace.\n *\n * ```tsx\n * const session = useArtifactSession({ workspaceId, docId, onSaved: ({ docId }) => docId && open(docId) })\n * <ArtifactEditor {...session.view} onOpenVersion={open}\n *   editor={<ArtifactMarkdownEditor {...session.editorProps} />}\n *   redline={<ArtifactRedlineView {...session.redlineProps} />} />\n * ```\n */\nexport function useArtifactSession(options: ArtifactSessionOptions): ArtifactSession {\n  const {\n    workspaceId,\n    docId: hostDocId,\n    draftContent,\n    title,\n    configId,\n    compareId,\n    onCompareChange,\n    onSaved,\n    ...passthrough\n  } = options\n  // A saved local draft becomes this real document; another host docId resets it.\n  const [saved, setSaved] = useState<{\n    forId: string | null | undefined\n    id: string\n    text: string\n  } | null>(null)\n  const adopted = saved && saved.forId === hostDocId ? saved : null\n  const docId = adopted?.id ?? hostDocId\n  const isLocal = !isDocumentId(docId)\n\n  // Owned here (not in the edit session) because the compare target's text must be loaded first.\n  const [ownCompareId, setOwnCompareId] = useState<string | null>(null)\n  const activeCompareId = compareId === undefined ? ownCompareId : compareId\n  const changeCompare = useCallback(\n    (id: string | null) => {\n      setOwnCompareId(id)\n      onCompareChange?.(id)\n    },\n    [onCompareChange]\n  )\n\n  const { text, isLoading, status, retry } = useArtifactText(docId)\n  const versions = useArtifactVersions(workspaceId, isLocal ? null : docId)\n  const { text: compareText, isLoading: compareLoading } = useArtifactText(activeCompareId, {\n    enabled: !!activeCompareId,\n  })\n  const saveVersion = useSaveArtifactVersion()\n  const current = findVersion(versions, docId)\n\n  const save = useCallback(\n    async (content: string) => {\n      const result = await saveVersion.mutateAsync({\n        title: title ?? current?.name ?? 'Untitled',\n        content,\n        versionOf: isLocal ? null : docId,\n        configId,\n      })\n      const latest = versions.reduce((n, v) => Math.max(n, v.number), 0)\n      return { ...result, version: result.version ?? (isLocal ? 1 : latest + 1) }\n    },\n    [saveVersion, title, current?.name, isLocal, docId, configId, versions]\n  )\n\n  const handleSaved = useCallback(\n    (result: ArtifactSaveResult, content: string) => {\n      // A host that keeps passing the local draft's placeholder id: follow every save to the real\n      // document it created (the first save creates version 1, later ones chain from it).\n      if (!isDocumentId(hostDocId) && result.docId)\n        setSaved({ forId: hostDocId, id: result.docId, text: content })\n      onSaved?.(result, content)\n    },\n    [hostDocId, onSaved]\n  )\n\n  const session = useArtifactEditSession({\n    ...passthrough,\n    docId,\n    // A local draft has only its own text; a just-saved one shows what was saved until the parsed\n    // text of the new document arrives.\n    baseline: text ?? (isLocal ? draftContent : adopted?.text),\n    savedFromId: current?.savedFromId,\n    compareId: activeCompareId,\n    onCompareChange: changeCompare,\n    compareText,\n    compareLoading,\n    save,\n    onSaved: handleSaved,\n  })\n\n  const { redline } = session\n  return useMemo<ArtifactSession>(\n    () => ({\n      ...session,\n      docId,\n      isLocal,\n      isLoading,\n      status,\n      versions,\n      labelOf: (id) => versionLabel(versions, id),\n      view: {\n        content: session.baseline,\n        isEditing: session.isEditing,\n        hasChanges: session.hasChanges,\n        isSaving: session.isSaving,\n        canCompare: session.canCompare,\n        comparing: !!session.compareId,\n        compareId: session.compareId,\n        showTrackChanges: session.showTrackChanges,\n        versions,\n        currentVersionId: current?.id ?? docId ?? '',\n        onStartEdit: session.startEdit,\n        onCancel: session.cancel,\n        onSave: () => void session.save(),\n        onCompare: () => session.compare(),\n        onStopCompare: session.stopCompare,\n        onToggleTrackChanges: () => session.setShowTrackChanges(!session.showTrackChanges),\n        // A local draft has its text already: it is ready.\n        status: isLocal ? 'ready' : status,\n        onRetry: retry,\n      },\n      editorProps: {\n        markdown: session.content,\n        onChange: session.change,\n        onNormalized: session.normalized,\n      },\n      redlineProps: {\n        state: redline.state,\n        onRevert: (regionId) => void session.revertRegion(regionId),\n      },\n    }),\n    [session, redline, isLoading, status, retry, isLocal, versions, docId]\n  )\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { registerDocumentTurnFlush } from '../chat/turn-flush'\nimport { useCallback, useEffect, useMemo, useState } from 'react'\nimport { useMutation, useQueryClient } from '@tanstack/react-query'\nimport { useArbi } from '../useArbi'\nimport { arbiQueryKeys, useDocumentVersionList } from '../hooks'\nimport { refreshDocuments, useDocuments } from '../documents/documents-data'\nimport { useArtifactText, type ArtifactTextStatus } from './useArtifactText'\nimport {\n  documentVersions,\n  findVersion,\n  isDocumentId,\n  parseVersionRef,\n  toArtifactVersions,\n  versionLabel,\n  type ArtifactVersion,\n} from './versions'\nimport {\n  useArtifactEditSession,\n  type ArtifactEditSession,\n  type ArtifactEditSessionOptions,\n  type ArtifactSaveResult,\n} from './useArtifactEditSession'\n\n/**\n * The versions of an artifact, oldest first. `docId` is a document id or a version reference\n * (`doc-\u2026@v2`). Every listed document carries its versions; a document that is not in the\n * workspace list asks for its version list.\n */\nexport function useArtifactVersions(\n  workspaceId: string | undefined,\n  docId: string | null | undefined\n): ArtifactVersion[] {\n  const plainId = docId ? parseVersionRef(docId).docId : null\n  const { data: documents } = useDocuments(workspaceId)\n  const listed = useMemo(\n    () => (documents ?? []).find((d) => d.external_id === plainId),\n    [documents, plainId]\n  )\n  // Asked only once the list has loaded and the document is not in it.\n  const { data: history } = useDocumentVersionList(plainId, {\n    enabled: !!plainId && documents !== undefined && !listed,\n  })\n  return useMemo(\n    () => (listed ? documentVersions(listed) : toArtifactVersions(plainId, history)),\n    [listed, history, plainId]\n  )\n}\n\nexport interface SaveArtifactVersionInput {\n  /** File name of the new version (`.md` is added when missing). */\n  title: string\n  content: string\n  /** Save as the next version of this document (it keeps its id); omit for a new document. */\n  autosave?: boolean\n  versionOf?: string | null\n  /** The processing config (auto-title, parsing) to run the upload with. */\n  configId?: string | null\n  /** `artifact` (default) for AI-style drafts; `source` for a document the user typed. */\n  wpType?: 'artifact' | 'source'\n}\n\n/**\n * Save markdown as a NEW immutable version (the next version of `versionOf`'s document, which keeps\n * its id) and refresh the workspace document list, version lists and the document's text.\n */\nexport function useSaveArtifactVersion() {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  return useMutation<ArtifactSaveResult, Error, SaveArtifactVersionInput>({\n    mutationFn: async ({ title, content, versionOf, configId, wpType, autosave }) => {\n      // The backend classifies uploads by extension: a title without one is silently dropped.\n      const fileName = /\\.md$/i.test(title) ? title : `${title}.md`\n      const result = await arbi.documents.uploadFile(\n        new Blob([content], { type: 'text/markdown' }),\n        fileName,\n        {\n          wpType: wpType ?? 'artifact',\n          autosave,\n          versionOf: versionOf ? parseVersionRef(versionOf).docId : undefined,\n          configExtId: configId ?? undefined,\n        }\n      )\n      const docId = result.doc_ext_ids?.[0]\n      // The document's row moves to the new version (its version lists re-read with it).\n      if (docId) await refreshDocuments(queryClient, arbi, [docId])\n      await queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allDocumentVersions() })\n      // The document's current text is the new version's now.\n      if (docId)\n        await queryClient.invalidateQueries({ queryKey: arbiQueryKeys.parsedDocument(docId) })\n      return { docId, version: result.version ?? undefined }\n    },\n  })\n}\n\nexport interface ArtifactSessionOptions extends Pick<\n  ArtifactEditSessionOptions,\n  | 'onSaved'\n  | 'onSaveError'\n  | 'onCompareChange'\n  | 'compareId'\n  | 'compareOpensEditor'\n  | 'redlineEngine'\n  | 'onDirtyChange'\n> {\n  workspaceId: string | undefined\n  /**\n   * The open document (its current version), a version reference `doc-\u2026@v{n}`, or the placeholder\n   * id of an unsaved local draft (anything that is not a backend document id, i.e. does not start\n   * with `doc`).\n   */\n  docId: string | null | undefined\n  /**\n   * The text of a local draft (nothing is fetched for it). The FIRST save uploads it as a real\n   * document with no parent and the session switches to the new id; later saves chain from it.\n   */\n  draftContent?: string\n  /** Name for saved versions. Defaults to the open version's file name, else \"Untitled\". */\n  title?: string\n  /** Processing config for saved versions. */\n  configId?: string | null\n}\n\n/** Everything `ArtifactEditor` (`@arbidocs/blocks/artifacts`) takes from a session, flat. */\nexport interface ArtifactSessionView {\n  content: string\n  isEditing: boolean\n  hasChanges: boolean\n  isSaving: boolean\n  canCompare: boolean\n  comparing: boolean\n  compareId: string | null\n  showTrackChanges: boolean\n  versions: ArtifactVersion[]\n  currentVersionId: string\n  onStartEdit: () => void\n  onCancel: () => void\n  onSave: () => void\n  onCompare: () => void\n  onStopCompare: () => void\n  onToggleTrackChanges: () => void\n  /**\n   * Whether the text is ready. `ArtifactEditor` renders \"Preparing editor...\" while it is\n   * `loading` or `parsing` (a fresh upload is parsed for a few seconds) and an error with Retry.\n   */\n  status: ArtifactTextStatus\n  /** Ask for the text again after an `error`. */\n  onRetry: () => void\n}\n\nexport interface ArtifactSession extends ArtifactEditSession {\n  /** The open document: the new real id once a local draft has been saved. */\n  docId: string | null | undefined\n  /** The open version is an unsaved local draft (no backend document yet). */\n  isLocal: boolean\n  isLoading: boolean\n  /** See `ArtifactTextStatus`. */\n  status: ArtifactTextStatus\n  versions: ArtifactVersion[]\n  /** \"v2\" for any version (reference) of the document. */\n  labelOf: (id: string | null | undefined) => string | null\n  /** Props for `<ArtifactEditor>`. */\n  view: ArtifactSessionView\n  /** Props for `<ArtifactMarkdownEditor>` (`@arbidocs/blocks/artifacts/editor`). */\n  editorProps: {\n    markdown: string\n    onChange: (markdown: string) => void\n    onNormalized: (markdown: string) => void\n  }\n  /** Props for `<ArtifactRedlineView>`. */\n  redlineProps: {\n    state: ArtifactEditSession['redline']['state']\n    onRevert: (regionId: string) => void\n  }\n}\n\n/**\n * Edit an artifact through the SDK: load it, edit it, save it as a new version, list its versions\n * and compare any two with track changes. Needs an `<ArbiHost>` with an `arbi` and a selected workspace.\n *\n * ```tsx\n * const session = useArtifactSession({ workspaceId, docId, onSaved: ({ docId }) => docId && open(docId) })\n * <ArtifactEditor {...session.view} onOpenVersion={open}\n *   editor={<ArtifactMarkdownEditor {...session.editorProps} />}\n *   redline={<ArtifactRedlineView {...session.redlineProps} />} />\n * ```\n */\nexport function useArtifactSession(options: ArtifactSessionOptions): ArtifactSession {\n  const {\n    workspaceId,\n    docId: hostDocId,\n    draftContent,\n    title,\n    configId,\n    compareId,\n    onCompareChange,\n    onSaved,\n    ...passthrough\n  } = options\n  // A saved local draft becomes this real document; another host docId resets it.\n  const [saved, setSaved] = useState<{\n    forId: string | null | undefined\n    id: string\n    text: string\n  } | null>(null)\n  const adopted = saved && saved.forId === hostDocId ? saved : null\n  const docId = adopted?.id ?? hostDocId\n  const isLocal = !isDocumentId(docId)\n\n  // Owned here (not in the edit session) because the compare target's text must be loaded first.\n  const [ownCompareId, setOwnCompareId] = useState<string | null>(null)\n  const activeCompareId = compareId === undefined ? ownCompareId : compareId\n  const changeCompare = useCallback(\n    (id: string | null) => {\n      setOwnCompareId(id)\n      onCompareChange?.(id)\n    },\n    [onCompareChange]\n  )\n\n  const { text, isLoading, status, retry } = useArtifactText(docId)\n  const versions = useArtifactVersions(workspaceId, isLocal ? null : docId)\n  const { text: compareText, isLoading: compareLoading } = useArtifactText(activeCompareId, {\n    enabled: !!activeCompareId,\n  })\n  const saveVersion = useSaveArtifactVersion()\n  const autosaveVersion = saveVersion.mutateAsync\n  const current = findVersion(versions, docId)\n\n  const save = useCallback(\n    async (content: string) => {\n      const result = await saveVersion.mutateAsync({\n        title: title ?? current?.name ?? 'Untitled',\n        content,\n        versionOf: isLocal ? null : docId,\n        configId,\n      })\n      const latest = versions.reduce((n, v) => Math.max(n, v.number), 0)\n      return { ...result, version: result.version ?? (isLocal ? 1 : latest + 1) }\n    },\n    [saveVersion, title, current?.name, isLocal, docId, configId, versions]\n  )\n\n  const handleSaved = useCallback(\n    (result: ArtifactSaveResult, content: string) => {\n      // A host that keeps passing the local draft's placeholder id: follow every save to the real\n      // document it created (the first save creates version 1, later ones chain from it).\n      if (!isDocumentId(hostDocId) && result.docId)\n        setSaved({ forId: hostDocId, id: result.docId, text: content })\n      onSaved?.(result, content)\n    },\n    [hostDocId, onSaved]\n  )\n\n  const session = useArtifactEditSession({\n    ...passthrough,\n    docId,\n    // A local draft has only its own text; a just-saved one shows what was saved until the parsed\n    // text of the new document arrives.\n    baseline: text ?? (isLocal ? draftContent : adopted?.text),\n    savedFromId: current?.savedFromId,\n    compareId: activeCompareId,\n    onCompareChange: changeCompare,\n    compareText,\n    compareLoading,\n    save,\n    onSaved: handleSaved,\n  })\n\n  useEffect(() => {\n    if (isLocal || !session.hasChanges || session.isSaving) return\n    const timer = setTimeout(() => {\n      void autosaveVersion({\n        title: title ?? current?.name ?? 'Untitled',\n        content: session.content,\n        versionOf: docId,\n        configId,\n        autosave: true,\n      }).catch(() => undefined)\n    }, 2500)\n    return () => clearTimeout(timer)\n  }, [\n    isLocal,\n    session.content,\n    session.hasChanges,\n    session.isSaving,\n    docId,\n    title,\n    current?.name,\n    configId,\n    autosaveVersion,\n  ])\n\n  useEffect(() => {\n    if (!docId) return\n    return registerDocumentTurnFlush(docId, async () => {\n      if (session.hasChanges && !(await session.save()))\n        throw new Error('Save the document before sending your message.')\n    })\n  }, [docId, session])\n\n  const { redline } = session\n  return useMemo<ArtifactSession>(\n    () => ({\n      ...session,\n      docId,\n      isLocal,\n      isLoading,\n      status,\n      versions,\n      labelOf: (id) => versionLabel(versions, id),\n      view: {\n        content: session.baseline,\n        isEditing: session.isEditing,\n        hasChanges: session.hasChanges || !!current?.autosave,\n        isSaving: session.isSaving,\n        canCompare: session.canCompare,\n        comparing: !!session.compareId,\n        compareId: session.compareId,\n        showTrackChanges: session.showTrackChanges,\n        versions,\n        currentVersionId: current?.id ?? docId ?? '',\n        onStartEdit: session.startEdit,\n        onCancel: session.cancel,\n        onSave: () => void session.save(),\n        onCompare: () => session.compare(),\n        onStopCompare: session.stopCompare,\n        onToggleTrackChanges: () => session.setShowTrackChanges(!session.showTrackChanges),\n        // A local draft has its text already: it is ready.\n        status: isLocal ? 'ready' : status,\n        onRetry: retry,\n      },\n      editorProps: {\n        markdown: session.content,\n        onChange: session.change,\n        onNormalized: session.normalized,\n      },\n      redlineProps: {\n        state: redline.state,\n        onRevert: (regionId) => void session.revertRegion(regionId),\n      },\n    }),\n    [\n      session,\n      redline,\n      isLoading,\n      status,\n      retry,\n      isLocal,\n      versions,\n      docId,\n      current?.id,\n      current?.autosave,\n    ]\n  )\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/artifacts/versions.js

@@ -22,6 +22,7 @@ function toArtifactVersions(docId, entries, currentVersion) {
     name: e.file_name ?? "",
     createdAt: e.created_at ?? "",
     number: e.n,
+    autosave: e.autosave,
     reason: e.reason ?? "upload",
     isCurrent: current != null ? e.n === current : !!e.is_current,
     savedFromId: savedFromId(docId, e),
@@ -41,7 +42,7 @@ function findVersion(versions, ref) {
 function versionLabel(versions, ref) {
   if (!ref || versions.length <= 1) return null;
   const version = findVersion(versions, ref);
-  return version ? `v${version.number}` : null;
+  return version ? `v${version.number}${version.autosave ? " \xB7 Autosaved" : ""}` : null;
 }
 function flattenChunks(chunks, options) {
   const text = (chunks ?? []).map((c) => (c.content ?? "").trim()).join("\n\n");

package/dist/artifacts/versions.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/artifacts/versions.ts"],
-  "sourcesContent": ["/**\n * Versions of a document. A document keeps ONE id for its whole life; its versions live inside it\n * (`current_version` + `versions`, numbered 1..n). A version is named by a version reference\n * `doc-\u2026@v{n}`; a plain document id means its current version. The workspace list carries every\n * document's `versions`, and `GET /v1/document/{id}/versions` (`arbi.documents.versions`) the same\n * list on its own.\n */\n\nimport { repairParsedStructure, repairParsedTitle, unescapeMarkdown } from '../ai/stored-markdown'\nimport { normalizeMarkdown } from './normalize-markdown'\n\n/** One version entry as the API returns it (a subset of `DocVersion`). */\nexport interface DocVersionEntry {\n  n: number\n  file_name?: string | null\n  created_at?: string | null\n  reason?: string | null\n  /** The version an edit started from, when it was not the previous one. */\n  made_from?: number | null\n  is_current?: boolean | null\n  /** The assistant message whose turn made this version, and its thread (none: a person's). */\n  source_message_ext_id?: string | null\n  conversation_ext_id?: string | null\n}\n\n/** The fields of a workspace document the version list needs (a subset of the API type). */\nexport interface VersionedDoc {\n  external_id?: string | null\n  current_version?: number | null\n  versions?: readonly DocVersionEntry[] | null\n  file_name?: string | null\n  created_at?: string | null\n}\n\n/** One row of a version list. Matches `VersionEntry` of `@arbidocs/blocks/artifacts`. */\nexport interface ArtifactVersion {\n  /** The version reference `doc-\u2026@v{n}`: what opening or comparing this version names. */\n  id: string\n  /** The document (the same for every version). */\n  docId: string\n  /** File name as stored. */\n  name: string\n  /** ISO timestamp. */\n  createdAt: string\n  /** 1-based version number within the document. */\n  number: number\n  /** upload | edit | signed | sync */\n  reason: string\n  isCurrent: boolean\n  /** The version this one was saved from (an older one than the previous version when restored). */\n  savedFromId?: string | null\n  /** The thread (and its message) whose turn made this version; none for a person's. */\n  thread?: { conversationId: string; messageId: string | null } | null\n}\n\nconst VERSION_REF = /^(doc-[A-Za-z0-9]+)@v([1-9][0-9]*)$/\n\n/** `doc-\u2026@v{n}`: a reference to version `n` of a document. */\nexport function versionRef(docId: string, version: number): string {\n  return `${docId}@v${version}`\n}\n\n/**\n * Split a reference into the document and the version it names. A plain document id (or anything\n * else) names no version: the document's current one.\n */\nexport function parseVersionRef(ref: string | null | undefined): {\n  docId: string\n  version: number | null\n} {\n  const match = VERSION_REF.exec(ref ?? '')\n  if (!match) return { docId: ref ?? '', version: null }\n  return { docId: match[1], version: Number(match[2]) }\n}\n\n/** The version a version was saved from: `made_from`, else the one before it. */\nexport function savedFromId(docId: string, entry: DocVersionEntry): string | null {\n  if (entry.made_from) return versionRef(docId, entry.made_from)\n  return entry.n > 1 ? versionRef(docId, entry.n - 1) : null\n}\n\n/** A document's version entries (oldest first) as plain version rows. */\nexport function toArtifactVersions(\n  docId: string | null | undefined,\n  entries: readonly DocVersionEntry[] | null | undefined,\n  currentVersion?: number | null\n): ArtifactVersion[] {\n  if (!docId) return []\n  const current = currentVersion ?? entries?.find((e) => e.is_current)?.n ?? null\n  return [...(entries ?? [])]\n    .sort((a, b) => a.n - b.n)\n    .map((e) => ({\n      id: versionRef(docId, e.n),\n      docId,\n      name: e.file_name ?? '',\n      createdAt: e.created_at ?? '',\n      number: e.n,\n      reason: e.reason ?? 'upload',\n      isCurrent: current != null ? e.n === current : !!e.is_current,\n      savedFromId: savedFromId(docId, e),\n      thread: e.conversation_ext_id\n        ? { conversationId: e.conversation_ext_id, messageId: e.source_message_ext_id ?? null }\n        : null,\n    }))\n}\n\n/** The versions of a listed document, oldest first (`[]` when the document is not given). */\nexport function documentVersions(doc: VersionedDoc | null | undefined): ArtifactVersion[] {\n  if (!doc?.external_id) return []\n  const entries = doc.versions?.length\n    ? doc.versions\n    : [{ n: doc.current_version ?? 1, file_name: doc.file_name, created_at: doc.created_at }]\n  return toArtifactVersions(doc.external_id, entries, doc.current_version ?? null)\n}\n\n/** The row `ref` names: an exact version, or (a plain document id) the current version. */\nexport function findVersion(\n  versions: readonly ArtifactVersion[],\n  ref: string | null | undefined\n): ArtifactVersion | undefined {\n  if (!ref) return undefined\n  const { docId, version } = parseVersionRef(ref)\n  return version == null\n    ? versions.find((v) => v.docId === docId && v.isCurrent)\n    : versions.find((v) => v.docId === docId && v.number === version)\n}\n\n/**\n * \"v2\": the version number `ref` names. `null` when there is nothing to tell apart (the document\n * has a single version, or it is unknown), so unversioned documents stay unlabelled.\n */\nexport function versionLabel(\n  versions: readonly ArtifactVersion[],\n  ref: string | null | undefined\n): string | null {\n  if (!ref || versions.length <= 1) return null\n  const version = findVersion(versions, ref)\n  return version ? `v${version.number}` : null\n}\n\n/**\n * Join parsed chunks into one markdown text (blank line between chunks).\n *\n * `unescape: true` for an artifact stored from markdown: the backend's parse of a `.md` escapes\n * markdown punctuation, which `unescapeMarkdown` undoes (see its rule), and mangles its title\n * (`repairParsedTitle`, `repairParsedStructure`: doubled headings, `- ` stacked on list markers,\n * one-line tables), then normalised. Leave it off for the parse\n * of a PDF or Word file.\n */\nexport function flattenChunks(\n  chunks: readonly { content?: string | null }[] | null | undefined,\n  options?: { unescape?: boolean }\n): string {\n  const text = (chunks ?? []).map((c) => (c.content ?? '').trim()).join('\\n\\n')\n  if (!options?.unescape) return text\n  // Canonical spelling last, so the text an editor starts from is what a save would persist.\n  return normalizeMarkdown(\n    repairParsedStructure(repairParsedTitle(unescapeMarkdown(text)))\n  ).replace(/\\n$/, '')\n}\n\n/** The backend's pattern for a document id. Anything else (a streamed draft's placeholder) is local. */\nconst DOC_ID = /^doc/\n\n/** Is `id` a real, saved document id? Local drafts have placeholder ids and no backend document. */\nexport function isDocumentId(id: string | null | undefined): id is string {\n  return !!id && DOC_ID.test(id)\n}\n"],
-  "mappings": "AAQA,SAAS,uBAAuB,mBAAmB,wBAAwB;AAC3E,SAAS,yBAAyB;AA8ClC,MAAM,cAAc;AAGb,SAAS,WAAW,OAAe,SAAyB;AACjE,SAAO,GAAG,KAAK,KAAK,OAAO;AAC7B;AAMO,SAAS,gBAAgB,KAG9B;AACA,QAAM,QAAQ,YAAY,KAAK,OAAO,EAAE;AACxC,MAAI,CAAC,MAAO,QAAO,EAAE,OAAO,OAAO,IAAI,SAAS,KAAK;AACrD,SAAO,EAAE,OAAO,MAAM,CAAC,GAAG,SAAS,OAAO,MAAM,CAAC,CAAC,EAAE;AACtD;AAGO,SAAS,YAAY,OAAe,OAAuC;AAChF,MAAI,MAAM,UAAW,QAAO,WAAW,OAAO,MAAM,SAAS;AAC7D,SAAO,MAAM,IAAI,IAAI,WAAW,OAAO,MAAM,IAAI,CAAC,IAAI;AACxD;AAGO,SAAS,mBACd,OACA,SACA,gBACmB;AACnB,MAAI,CAAC,MAAO,QAAO,CAAC;AACpB,QAAM,UAAU,kBAAkB,SAAS,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK;AAC3E,SAAO,CAAC,GAAI,WAAW,CAAC,CAAE,EACvB,KAAK,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EACxB,IAAI,CAAC,OAAO;AAAA,IACX,IAAI,WAAW,OAAO,EAAE,CAAC;AAAA,IACzB;AAAA,IACA,MAAM,EAAE,aAAa;AAAA,IACrB,WAAW,EAAE,cAAc;AAAA,IAC3B,QAAQ,EAAE;AAAA,IACV,QAAQ,EAAE,UAAU;AAAA,IACpB,WAAW,WAAW,OAAO,EAAE,MAAM,UAAU,CAAC,CAAC,EAAE;AAAA,IACnD,aAAa,YAAY,OAAO,CAAC;AAAA,IACjC,QAAQ,EAAE,sBACN,EAAE,gBAAgB,EAAE,qBAAqB,WAAW,EAAE,yBAAyB,KAAK,IACpF;AAAA,EACN,EAAE;AACN;AAGO,SAAS,iBAAiB,KAAyD;AACxF,MAAI,CAAC,KAAK,YAAa,QAAO,CAAC;AAC/B,QAAM,UAAU,IAAI,UAAU,SAC1B,IAAI,WACJ,CAAC,EAAE,GAAG,IAAI,mBAAmB,GAAG,WAAW,IAAI,WAAW,YAAY,IAAI,WAAW,CAAC;AAC1F,SAAO,mBAAmB,IAAI,aAAa,SAAS,IAAI,mBAAmB,IAAI;AACjF;AAGO,SAAS,YACd,UACA,KAC6B;AAC7B,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,EAAE,OAAO,QAAQ,IAAI,gBAAgB,GAAG;AAC9C,SAAO,WAAW,OACd,SAAS,KAAK,CAAC,MAAM,EAAE,UAAU,SAAS,EAAE,SAAS,IACrD,SAAS,KAAK,CAAC,MAAM,EAAE,UAAU,SAAS,EAAE,WAAW,OAAO;AACpE;AAMO,SAAS,aACd,UACA,KACe;AACf,MAAI,CAAC,OAAO,SAAS,UAAU,EAAG,QAAO;AACzC,QAAM,UAAU,YAAY,UAAU,GAAG;AACzC,SAAO,UAAU,IAAI,QAAQ,MAAM,KAAK;AAC1C;AAWO,SAAS,cACd,QACA,SACQ;AACR,QAAM,QAAQ,UAAU,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM;AAC5E,MAAI,CAAC,SAAS,SAAU,QAAO;AAE/B,SAAO;AAAA,IACL,sBAAsB,kBAAkB,iBAAiB,IAAI,CAAC,CAAC;AAAA,EACjE,EAAE,QAAQ,OAAO,EAAE;AACrB;AAGA,MAAM,SAAS;AAGR,SAAS,aAAa,IAA6C;AACxE,SAAO,CAAC,CAAC,MAAM,OAAO,KAAK,EAAE;AAC/B;",
+  "sourcesContent": ["/**\n * Versions of a document. A document keeps ONE id for its whole life; its versions live inside it\n * (`current_version` + `versions`, numbered 1..n). A version is named by a version reference\n * `doc-\u2026@v{n}`; a plain document id means its current version. The workspace list carries every\n * document's `versions`, and `GET /v1/document/{id}/versions` (`arbi.documents.versions`) the same\n * list on its own.\n */\n\nimport { repairParsedStructure, repairParsedTitle, unescapeMarkdown } from '../ai/stored-markdown'\nimport { normalizeMarkdown } from './normalize-markdown'\n\n/** One version entry as the API returns it (a subset of `DocVersion`). */\nexport interface DocVersionEntry {\n  autosave?: boolean\n  n: number\n  file_name?: string | null\n  created_at?: string | null\n  reason?: string | null\n  /** The version an edit started from, when it was not the previous one. */\n  made_from?: number | null\n  is_current?: boolean | null\n  /** The assistant message whose turn made this version, and its thread (none: a person's). */\n  source_message_ext_id?: string | null\n  conversation_ext_id?: string | null\n}\n\n/** The fields of a workspace document the version list needs (a subset of the API type). */\nexport interface VersionedDoc {\n  external_id?: string | null\n  current_version?: number | null\n  versions?: readonly DocVersionEntry[] | null\n  file_name?: string | null\n  created_at?: string | null\n}\n\n/** One row of a version list. Matches `VersionEntry` of `@arbidocs/blocks/artifacts`. */\nexport interface ArtifactVersion {\n  /** The version reference `doc-\u2026@v{n}`: what opening or comparing this version names. */\n  id: string\n  /** The document (the same for every version). */\n  docId: string\n  /** File name as stored. */\n  name: string\n  /** ISO timestamp. */\n  createdAt: string\n  /** 1-based version number within the document. */\n  number: number\n  /** upload | edit | signed | sync */\n  reason: string\n  isCurrent: boolean\n  /** The version this one was saved from (an older one than the previous version when restored). */\n  autosave?: boolean\n  savedFromId?: string | null\n  /** The thread (and its message) whose turn made this version; none for a person's. */\n  thread?: { conversationId: string; messageId: string | null } | null\n}\n\nconst VERSION_REF = /^(doc-[A-Za-z0-9]+)@v([1-9][0-9]*)$/\n\n/** `doc-\u2026@v{n}`: a reference to version `n` of a document. */\nexport function versionRef(docId: string, version: number): string {\n  return `${docId}@v${version}`\n}\n\n/**\n * Split a reference into the document and the version it names. A plain document id (or anything\n * else) names no version: the document's current one.\n */\nexport function parseVersionRef(ref: string | null | undefined): {\n  docId: string\n  version: number | null\n} {\n  const match = VERSION_REF.exec(ref ?? '')\n  if (!match) return { docId: ref ?? '', version: null }\n  return { docId: match[1], version: Number(match[2]) }\n}\n\n/** The version a version was saved from: `made_from`, else the one before it. */\nexport function savedFromId(docId: string, entry: DocVersionEntry): string | null {\n  if (entry.made_from) return versionRef(docId, entry.made_from)\n  return entry.n > 1 ? versionRef(docId, entry.n - 1) : null\n}\n\n/** A document's version entries (oldest first) as plain version rows. */\nexport function toArtifactVersions(\n  docId: string | null | undefined,\n  entries: readonly DocVersionEntry[] | null | undefined,\n  currentVersion?: number | null\n): ArtifactVersion[] {\n  if (!docId) return []\n  const current = currentVersion ?? entries?.find((e) => e.is_current)?.n ?? null\n  return [...(entries ?? [])]\n    .sort((a, b) => a.n - b.n)\n    .map((e) => ({\n      id: versionRef(docId, e.n),\n      docId,\n      name: e.file_name ?? '',\n      createdAt: e.created_at ?? '',\n      number: e.n,\n      autosave: e.autosave,\n      reason: e.reason ?? 'upload',\n      isCurrent: current != null ? e.n === current : !!e.is_current,\n      savedFromId: savedFromId(docId, e),\n      thread: e.conversation_ext_id\n        ? { conversationId: e.conversation_ext_id, messageId: e.source_message_ext_id ?? null }\n        : null,\n    }))\n}\n\n/** The versions of a listed document, oldest first (`[]` when the document is not given). */\nexport function documentVersions(doc: VersionedDoc | null | undefined): ArtifactVersion[] {\n  if (!doc?.external_id) return []\n  const entries = doc.versions?.length\n    ? doc.versions\n    : [{ n: doc.current_version ?? 1, file_name: doc.file_name, created_at: doc.created_at }]\n  return toArtifactVersions(doc.external_id, entries, doc.current_version ?? null)\n}\n\n/** The row `ref` names: an exact version, or (a plain document id) the current version. */\nexport function findVersion(\n  versions: readonly ArtifactVersion[],\n  ref: string | null | undefined\n): ArtifactVersion | undefined {\n  if (!ref) return undefined\n  const { docId, version } = parseVersionRef(ref)\n  return version == null\n    ? versions.find((v) => v.docId === docId && v.isCurrent)\n    : versions.find((v) => v.docId === docId && v.number === version)\n}\n\n/**\n * \"v2\": the version number `ref` names. `null` when there is nothing to tell apart (the document\n * has a single version, or it is unknown), so unversioned documents stay unlabelled.\n */\nexport function versionLabel(\n  versions: readonly ArtifactVersion[],\n  ref: string | null | undefined\n): string | null {\n  if (!ref || versions.length <= 1) return null\n  const version = findVersion(versions, ref)\n  return version ? `v${version.number}${version.autosave ? ' \u00B7 Autosaved' : ''}` : null\n}\n\n/**\n * Join parsed chunks into one markdown text (blank line between chunks).\n *\n * `unescape: true` for an artifact stored from markdown: the backend's parse of a `.md` escapes\n * markdown punctuation, which `unescapeMarkdown` undoes (see its rule), and mangles its title\n * (`repairParsedTitle`, `repairParsedStructure`: doubled headings, `- ` stacked on list markers,\n * one-line tables), then normalised. Leave it off for the parse\n * of a PDF or Word file.\n */\nexport function flattenChunks(\n  chunks: readonly { content?: string | null }[] | null | undefined,\n  options?: { unescape?: boolean }\n): string {\n  const text = (chunks ?? []).map((c) => (c.content ?? '').trim()).join('\\n\\n')\n  if (!options?.unescape) return text\n  // Canonical spelling last, so the text an editor starts from is what a save would persist.\n  return normalizeMarkdown(\n    repairParsedStructure(repairParsedTitle(unescapeMarkdown(text)))\n  ).replace(/\\n$/, '')\n}\n\n/** The backend's pattern for a document id. Anything else (a streamed draft's placeholder) is local. */\nconst DOC_ID = /^doc/\n\n/** Is `id` a real, saved document id? Local drafts have placeholder ids and no backend document. */\nexport function isDocumentId(id: string | null | undefined): id is string {\n  return !!id && DOC_ID.test(id)\n}\n"],
+  "mappings": "AAQA,SAAS,uBAAuB,mBAAmB,wBAAwB;AAC3E,SAAS,yBAAyB;AAgDlC,MAAM,cAAc;AAGb,SAAS,WAAW,OAAe,SAAyB;AACjE,SAAO,GAAG,KAAK,KAAK,OAAO;AAC7B;AAMO,SAAS,gBAAgB,KAG9B;AACA,QAAM,QAAQ,YAAY,KAAK,OAAO,EAAE;AACxC,MAAI,CAAC,MAAO,QAAO,EAAE,OAAO,OAAO,IAAI,SAAS,KAAK;AACrD,SAAO,EAAE,OAAO,MAAM,CAAC,GAAG,SAAS,OAAO,MAAM,CAAC,CAAC,EAAE;AACtD;AAGO,SAAS,YAAY,OAAe,OAAuC;AAChF,MAAI,MAAM,UAAW,QAAO,WAAW,OAAO,MAAM,SAAS;AAC7D,SAAO,MAAM,IAAI,IAAI,WAAW,OAAO,MAAM,IAAI,CAAC,IAAI;AACxD;AAGO,SAAS,mBACd,OACA,SACA,gBACmB;AACnB,MAAI,CAAC,MAAO,QAAO,CAAC;AACpB,QAAM,UAAU,kBAAkB,SAAS,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK;AAC3E,SAAO,CAAC,GAAI,WAAW,CAAC,CAAE,EACvB,KAAK,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EACxB,IAAI,CAAC,OAAO;AAAA,IACX,IAAI,WAAW,OAAO,EAAE,CAAC;AAAA,IACzB;AAAA,IACA,MAAM,EAAE,aAAa;AAAA,IACrB,WAAW,EAAE,cAAc;AAAA,IAC3B,QAAQ,EAAE;AAAA,IACV,UAAU,EAAE;AAAA,IACZ,QAAQ,EAAE,UAAU;AAAA,IACpB,WAAW,WAAW,OAAO,EAAE,MAAM,UAAU,CAAC,CAAC,EAAE;AAAA,IACnD,aAAa,YAAY,OAAO,CAAC;AAAA,IACjC,QAAQ,EAAE,sBACN,EAAE,gBAAgB,EAAE,qBAAqB,WAAW,EAAE,yBAAyB,KAAK,IACpF;AAAA,EACN,EAAE;AACN;AAGO,SAAS,iBAAiB,KAAyD;AACxF,MAAI,CAAC,KAAK,YAAa,QAAO,CAAC;AAC/B,QAAM,UAAU,IAAI,UAAU,SAC1B,IAAI,WACJ,CAAC,EAAE,GAAG,IAAI,mBAAmB,GAAG,WAAW,IAAI,WAAW,YAAY,IAAI,WAAW,CAAC;AAC1F,SAAO,mBAAmB,IAAI,aAAa,SAAS,IAAI,mBAAmB,IAAI;AACjF;AAGO,SAAS,YACd,UACA,KAC6B;AAC7B,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,EAAE,OAAO,QAAQ,IAAI,gBAAgB,GAAG;AAC9C,SAAO,WAAW,OACd,SAAS,KAAK,CAAC,MAAM,EAAE,UAAU,SAAS,EAAE,SAAS,IACrD,SAAS,KAAK,CAAC,MAAM,EAAE,UAAU,SAAS,EAAE,WAAW,OAAO;AACpE;AAMO,SAAS,aACd,UACA,KACe;AACf,MAAI,CAAC,OAAO,SAAS,UAAU,EAAG,QAAO;AACzC,QAAM,UAAU,YAAY,UAAU,GAAG;AACzC,SAAO,UAAU,IAAI,QAAQ,MAAM,GAAG,QAAQ,WAAW,oBAAiB,EAAE,KAAK;AACnF;AAWO,SAAS,cACd,QACA,SACQ;AACR,QAAM,QAAQ,UAAU,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM;AAC5E,MAAI,CAAC,SAAS,SAAU,QAAO;AAE/B,SAAO;AAAA,IACL,sBAAsB,kBAAkB,iBAAiB,IAAI,CAAC,CAAC;AAAA,EACjE,EAAE,QAAQ,OAAO,EAAE;AACrB;AAGA,MAAM,SAAS;AAGR,SAAS,aAAa,IAA6C;AACxE,SAAO,CAAC,CAAC,MAAM,OAAO,KAAK,EAAE;AAC/B;",
   "names": []
 }

package/dist/calls/livekit/index.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkFAJLJDWS_cjs = require('../../chunk-FAJLJDWS.cjs');
-require('../../chunk-7L7QRIQ2.cjs');
+var chunkFOBB5U4Y_cjs = require('../../chunk-FOBB5U4Y.cjs');
+require('../../chunk-H3XHBIZ6.cjs');
 var chunkO32T7XRD_cjs = require('../../chunk-O32T7XRD.cjs');
 var chunkIX4HOS5Z_cjs = require('../../chunk-IX4HOS5Z.cjs');
 require('../../chunk-N73IMVFF.cjs');
-require('../../chunk-NDIKMOBJ.cjs');
+require('../../chunk-KULS4YWP.cjs');
 require('../../chunk-VOFNX4P6.cjs');
 require('../../chunk-EEIYXVM4.cjs');
 require('../../chunk-5NOZDH3F.cjs');
@@ -123,8 +123,8 @@ function useCallTranscriber({
   const arbi = chunkO32T7XRD_cjs.useArbi();
   const queryClient = reactQuery.useQueryClient();
   const profile = arbi.isLoggedIn ? arbi.user.profile() : null;
-  const myProfileName = profile && chunkFAJLJDWS_cjs.toProfileView(profile).fullName || null;
-  const deploymentAvailable = chunkFAJLJDWS_cjs.useCallTranscriptionAvailable();
+  const myProfileName = profile && chunkFOBB5U4Y_cjs.toProfileView(profile).fullName || null;
+  const deploymentAvailable = chunkFOBB5U4Y_cjs.useCallTranscriptionAvailable();
   const available = deploymentAvailable && !!callKey;
   const [state, setState] = react.useState(null);
   const [creatorExtId, setCreatorExtId] = react.useState(null);
@@ -167,7 +167,7 @@ function useCallTranscriber({
     };
   }, [available, callExtId]);
   react.useEffect(
-    () => chunkFAJLJDWS_cjs.onCallEvent("call.transcription", (message) => {
+    () => chunkFOBB5U4Y_cjs.onCallEvent("call.transcription", (message) => {
       if (message.call_ext_id === callExtId) applyState(message);
     }),
     [callExtId, applyState]
@@ -183,7 +183,7 @@ function useCallTranscriber({
   const persist = react.useCallback(
     (segment, speakerNeedsProxy) => {
       if (!callKey || persisted.current.has(segment.segmentId)) return;
-      const role = chunkFAJLJDWS_cjs.transcriptPersistRole({
+      const role = chunkFOBB5U4Y_cjs.transcriptPersistRole({
         myIdentity,
         canPost: canPost && (segment.speakerIdentity !== myIdentity || selfPosts.current),
         hasCallKey: true,
@@ -192,7 +192,7 @@ function useCallTranscriber({
       });
       if (!role) return;
       persisted.current.add(segment.segmentId);
-      chunkFAJLJDWS_cjs.persistTranscriptSegment(arbi, queryClient, callExtId, callKey, segment).catch(
+      chunkFOBB5U4Y_cjs.persistTranscriptSegment(arbi, queryClient, callExtId, callKey, segment).catch(
         (err) => {
           persisted.current.delete(segment.segmentId);
           if (role === "own" && err?.status === 403) {
@@ -212,7 +212,7 @@ function useCallTranscriber({
   );
   react.useEffect(() => {
     const onData = (payload, participant, _kind, topic, _encryption, participantIdentity) => {
-      if (topic === chunkFAJLJDWS_cjs.CALL_TRANSCRIPTION_TOPIC) {
+      if (topic === chunkFOBB5U4Y_cjs.CALL_TRANSCRIPTION_TOPIC) {
         if (participant || participantIdentity) return;
         try {
           const next = browser.calls.transcriptionStateFrom(JSON.parse(new TextDecoder().decode(payload)));
@@ -221,10 +221,10 @@ function useCallTranscriber({
         }
         return;
       }
-      if (topic !== chunkFAJLJDWS_cjs.CALL_CAPTION_TOPIC || !callKey) return;
+      if (topic !== chunkFOBB5U4Y_cjs.CALL_CAPTION_TOPIC || !callKey) return;
       const identity = participant?.identity ?? participantIdentity;
       if (!identity || identity === myIdentity) return;
-      void chunkFAJLJDWS_cjs.decodeCaptionPacket(payload, callKey).then((packet) => {
+      void chunkFOBB5U4Y_cjs.decodeCaptionPacket(payload, callKey).then((packet) => {
         if (!packet || packet.identity !== identity) return;
         const name = participant?.name || packet.name || identity;
         const t = Math.min(packet.t, Date.now());
@@ -264,7 +264,7 @@ function useCallTranscriber({
       })) {
         return;
       }
-      const segmentId = chunkFAJLJDWS_cjs.newSegmentId();
+      const segmentId = chunkFOBB5U4Y_cjs.newSegmentId();
       const startedAt = new Date(segment.startedAt).toISOString();
       let text;
       try {
@@ -298,7 +298,7 @@ function useCallTranscriber({
       });
       try {
         await localParticipant.publishData(
-          await chunkFAJLJDWS_cjs.encodeCaptionPacket(
+          await chunkFOBB5U4Y_cjs.encodeCaptionPacket(
             {
               v: 1,
               segment_id: segmentId,
@@ -310,7 +310,7 @@ function useCallTranscriber({
             },
             callKey
           ),
-          { reliable: true, topic: chunkFAJLJDWS_cjs.CALL_CAPTION_TOPIC }
+          { reliable: true, topic: chunkFOBB5U4Y_cjs.CALL_CAPTION_TOPIC }
         );
       } catch (err) {
         console.warn("[calls] could not broadcast a caption", err);
@@ -425,14 +425,14 @@ function useCallRecorder({
     };
   }, [callExtId]);
   react.useEffect(
-    () => chunkFAJLJDWS_cjs.onCallEvent("call.recording", (message) => {
+    () => chunkFOBB5U4Y_cjs.onCallEvent("call.recording", (message) => {
       if (message.call_ext_id === callExtId) applyState(message);
     }),
     [callExtId, applyState]
   );
   react.useEffect(() => {
     const onData = (payload, participant, _kind, topic, _encryption, participantIdentity) => {
-      if (topic !== chunkFAJLJDWS_cjs.CALL_RECORDING_TOPIC) return;
+      if (topic !== chunkFOBB5U4Y_cjs.CALL_RECORDING_TOPIC) return;
       if (participant || participantIdentity) return;
       try {
         const next = browser.calls.recordingStateFrom(JSON.parse(new TextDecoder().decode(payload)));
@@ -453,7 +453,7 @@ function useCallRecorder({
       try {
         const row = call ?? await arbi.calls.get(callExtId);
         if (!row.workspace_locked && !row.chat_ext_id && callKey) {
-          const ref = await chunkFAJLJDWS_cjs.ensureMeetingChat(arbi, queryClient, callExtId, callKey);
+          const ref = await chunkFOBB5U4Y_cjs.ensureMeetingChat(arbi, queryClient, callExtId, callKey);
           if (ref.kind === "chat") setCall({ ...row, chat_ext_id: ref.chatExtId });
         }
         const answer = await arbi.calls.recording.start(callExtId, mode);
@@ -555,7 +555,7 @@ function useTrackUploader(recording, callKey, kind, mimeType) {
   const queryClient = reactQuery.useQueryClient();
   return react.useMemo(() => {
     if (!shouldCapture || !recordingExtId || !call) return null;
-    return chunkFAJLJDWS_cjs.trackUploaderFor({
+    return chunkFOBB5U4Y_cjs.trackUploaderFor({
       arbi,
       callExtId: call.external_id,
       recordingExtId,
@@ -563,7 +563,7 @@ function useTrackUploader(recording, callKey, kind, mimeType) {
       mimeType,
       recordingStartedAt: startedAt,
       linkVersion,
-      conversationKey: () => chunkFAJLJDWS_cjs.conversationKeyForCall(arbi, queryClient, call, { callKey }),
+      conversationKey: () => chunkFOBB5U4Y_cjs.conversationKeyForCall(arbi, queryClient, call, { callKey }),
       // The server stopped the recording at the quota (its state event says so too).
       onStopped: () => markStopped()
     });
@@ -612,10 +612,10 @@ function useInCallChat({
   react.useEffect(() => {
     if (!callKey) return;
     const onData = (payload, participant, _kind, topic, _encryption, participantIdentity) => {
-      if (topic !== chunkFAJLJDWS_cjs.CALL_CHAT_TOPIC) return;
+      if (topic !== chunkFOBB5U4Y_cjs.CALL_CHAT_TOPIC) return;
       const identity = participant?.identity ?? participantIdentity;
       if (!identity || identity === myIdentity) return;
-      void chunkFAJLJDWS_cjs.decodeCallChatPacket(payload, callKey).then((packet) => {
+      void chunkFOBB5U4Y_cjs.decodeCallChatPacket(payload, callKey).then((packet) => {
         if (!packet) return;
         const key = `${identity}:${packet.id}`;
         if (seen.current.has(key)) return;
@@ -645,7 +645,7 @@ function useInCallChat({
     if (!open || !canRead || historyRequested.current) return;
     historyRequested.current = true;
     setHistoryLoading(true);
-    chunkFAJLJDWS_cjs.loadMeetingHistory(arbi, queryClient, callExtId).then((result) => {
+    chunkFOBB5U4Y_cjs.loadMeetingHistory(arbi, queryClient, callExtId).then((result) => {
       if (!result) return;
       setMeetingChat(result.ref);
       setHistory(result.messages);
@@ -656,13 +656,13 @@ function useInCallChat({
   }, [open, canRead, callExtId]);
   const send = react.useCallback(
     async (raw) => {
-      const text = raw.trim().slice(0, chunkFAJLJDWS_cjs.CALL_CHAT_MAX_CHARS);
+      const text = raw.trim().slice(0, chunkFOBB5U4Y_cjs.CALL_CHAT_MAX_CHARS);
       if (!text || !callKey || readOnly) return;
-      const id = chunkFAJLJDWS_cjs.newPacketId();
+      const id = chunkFOBB5U4Y_cjs.newPacketId();
       const at = Date.now();
       await localParticipant.publishData(
-        await chunkFAJLJDWS_cjs.encodeCallChatPacket({ v: 1, id, text, at }, callKey),
-        { reliable: true, topic: chunkFAJLJDWS_cjs.CALL_CHAT_TOPIC }
+        await chunkFOBB5U4Y_cjs.encodeCallChatPacket({ v: 1, id, text, at }, callKey),
+        { reliable: true, topic: chunkFOBB5U4Y_cjs.CALL_CHAT_TOPIC }
       );
       setLive((prev) => [
         ...prev,
@@ -681,7 +681,7 @@ function useInCallChat({
         (prev) => prev.map((l) => l.id === id && l.senderIdentity === myIdentity ? { ...l, status } : l)
       );
       try {
-        setMeetingChat(await chunkFAJLJDWS_cjs.persistMeetingMessage(arbi, queryClient, callExtId, callKey, text));
+        setMeetingChat(await chunkFOBB5U4Y_cjs.persistMeetingMessage(arbi, queryClient, callExtId, callKey, text));
         mark("saved");
       } catch (err) {
         console.warn("[calls] could not keep the message in the meeting chat", err);
@@ -693,7 +693,7 @@ function useInCallChat({
   const openMeeting = react.useCallback(async () => {
     if (!callKey) return;
     try {
-      const ref = meetingChat ?? await chunkFAJLJDWS_cjs.ensureMeetingChat(arbi, queryClient, callExtId, callKey);
+      const ref = meetingChat ?? await chunkFOBB5U4Y_cjs.ensureMeetingChat(arbi, queryClient, callExtId, callKey);
       setMeetingChat(ref);
       openMeetingChat?.(ref);
     } catch (err) {
@@ -701,7 +701,7 @@ function useInCallChat({
     }
   }, [callExtId, callKey, meetingChat]);
   const lines = react.useMemo(
-    () => chunkFAJLJDWS_cjs.mergeChatLines(history, live, {
+    () => chunkFOBB5U4Y_cjs.mergeChatLines(history, live, {
       myIdentity,
       nameOf: (identity) => identity === myIdentity ? localParticipant.name || "You" : room.remoteParticipants.get(identity)?.name || null
     }),
@@ -760,7 +760,7 @@ function useWebinar({
     const n = ++questionsRead.current;
     try {
       const rows = await webinarApi().questions.list(callExtId, linkVersion);
-      const opened = await Promise.all(rows.map((q) => chunkFAJLJDWS_cjs.openQuestion(q, callKey)));
+      const opened = await Promise.all(rows.map((q) => chunkFOBB5U4Y_cjs.openQuestion(q, callKey)));
       if (n === questionsRead.current) setQuestions(opened);
     } catch (err) {
       console.warn("[calls] could not load the questions", err);
@@ -772,7 +772,7 @@ function useWebinar({
   }, [refresh, refreshQuestions]);
   react.useEffect(() => {
     if (!enabled) return;
-    return chunkFAJLJDWS_cjs.onCallEvent("call.webinar", (m) => {
+    return chunkFOBB5U4Y_cjs.onCallEvent("call.webinar", (m) => {
       if (m.call_ext_id !== callExtId) return;
       setState((s) => s ? { ...s, live: m.live, chat: m.chat } : s);
     });
@@ -781,8 +781,8 @@ function useWebinar({
   react.useEffect(() => {
     if (!enabled) return;
     const onData = (payload, participant, _kind, topic, _encryption, participantIdentity) => {
-      if (topic !== chunkFAJLJDWS_cjs.CALL_WEBINAR_TOPIC) return;
-      const packet = chunkFAJLJDWS_cjs.parseWebinarPacket(payload, !!(participant || participantIdentity));
+      if (topic !== chunkFOBB5U4Y_cjs.CALL_WEBINAR_TOPIC) return;
+      const packet = chunkFOBB5U4Y_cjs.parseWebinarPacket(payload, !!(participant || participantIdentity));
       if (!packet) return;
       switch (packet.type) {
         case "state":
@@ -803,7 +803,7 @@ function useWebinar({
           return;
         case "demoted":
           setStageCheck(false);
-          chunkFAJLJDWS_cjs.markRejoining(callExtId);
+          chunkFOBB5U4Y_cjs.markRejoining(callExtId);
           if (fallback.current) clearTimeout(fallback.current);
           fallback.current = setTimeout(() => void room.disconnect(), DEMOTE_REJOIN_FALLBACK_MS);
           return;
@@ -830,12 +830,12 @@ function useWebinar({
     [callExtId, linkVersion]
   );
   const stepDown = react.useCallback(async () => {
-    chunkFAJLJDWS_cjs.markRejoining(callExtId);
+    chunkFOBB5U4Y_cjs.markRejoining(callExtId);
     setStageCheck(false);
     try {
       await webinarApi().demote(callExtId, myIdentity, linkVersion);
     } catch (err) {
-      chunkFAJLJDWS_cjs.markRejoining(callExtId, false);
+      chunkFOBB5U4Y_cjs.markRejoining(callExtId, false);
       failed("leave the stage")(err);
     }
   }, [callExtId, myIdentity, linkVersion]);
@@ -895,7 +895,7 @@ function useWebinar({
         if (!callKey) throw new Error("This call has no key.");
         await webinarApi().questions.ask(
           callExtId,
-          await chunkFAJLJDWS_cjs.sealQuestionText(text, callKey),
+          await chunkFOBB5U4Y_cjs.sealQuestionText(text, callKey),
           linkVersion
         );
       }, "ask the question"),
@@ -909,7 +909,7 @@ function useWebinar({
         await webinarApi().questions.update(
           callExtId,
           id,
-          { answer: await chunkFAJLJDWS_cjs.sealQuestionText(text, callKey) },
+          { answer: await chunkFOBB5U4Y_cjs.sealQuestionText(text, callKey) },
           linkVersion
         );
       }, "answer the question"),
@@ -939,15 +939,15 @@ function useWebinar({
 function useHostMuteNotice(callExtId) {
   const room = componentsReact.useRoomContext();
   react.useEffect(() => {
-    const notifyMuted = chunkFAJLJDWS_cjs.createMutedNotifier((text) => chunkIX4HOS5Z_cjs.notify.info(text));
+    const notifyMuted = chunkFOBB5U4Y_cjs.createMutedNotifier((text) => chunkIX4HOS5Z_cjs.notify.info(text));
     const onData = (payload, participant, _kind, topic, _encryption, participantIdentity) => {
-      if (topic !== chunkFAJLJDWS_cjs.CALL_MODERATION_TOPIC) return;
+      if (topic !== chunkFOBB5U4Y_cjs.CALL_MODERATION_TOPIC) return;
       if (participant || participantIdentity) return;
-      const notice = chunkFAJLJDWS_cjs.mutedNoticeFromPacket(payload);
+      const notice = chunkFOBB5U4Y_cjs.mutedNoticeFromPacket(payload);
       if (notice) notifyMuted(notice);
     };
     room.on(livekitClient.RoomEvent.DataReceived, onData);
-    const offWs = chunkFAJLJDWS_cjs.onCallEvent("call.muted", (message) => {
+    const offWs = chunkFOBB5U4Y_cjs.onCallEvent("call.muted", (message) => {
       if (message.callExtId === callExtId) notifyMuted(message);
     });
     return () => {

package/dist/chat/turn-flush.js

@@ -5,9 +5,9 @@ function registerDocumentTurnFlush(documentId, flush) {
     if (flushes.get(documentId) === flush) flushes.delete(documentId);
   };
 }
-function flushDocumentForTurn(documentId) {
-  const flush = documentId ? flushes.get(documentId) : void 0;
-  return flush ? flush() : null;
+function flushDocumentForTurn(_documentId) {
+  const pending = [...flushes.values()];
+  return pending.length ? Promise.all(pending.map((flush) => flush())).then(() => void 0) : null;
 }
 export {
   flushDocumentForTurn,

package/dist/chat/turn-flush.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/chat/turn-flush.ts"],
-  "sourcesContent": ["/**\n * Saving a document before a chat turn works on it. An editor whose changes live only on screen\n * (the slides editor: no live co-editing) registers how to save them; a turn that names that\n * document (`active_artifact_ext_id`) awaits it first, so ARBI reads and edits what the person\n * sees, not the version saved before their last changes.\n */\n\ntype Flush = () => Promise<void>\n\nconst flushes = new Map<string, Flush>()\n\n/** While mounted, `flush` saves `documentId`'s unsaved changes; returns the unregister. */\nexport function registerDocumentTurnFlush(documentId: string, flush: Flush): () => void {\n  flushes.set(documentId, flush)\n  return () => {\n    if (flushes.get(documentId) === flush) flushes.delete(documentId)\n  }\n}\n\n/**\n * The save of the document a turn names, if an editor registered one; null otherwise, so a turn\n * about anything else is not delayed at all (not even by a microtask).\n */\nexport function flushDocumentForTurn(documentId: string | null | undefined): Promise<void> | null {\n  const flush = documentId ? flushes.get(documentId) : undefined\n  return flush ? flush() : null\n}\n"],
-  "mappings": "AASA,MAAM,UAAU,oBAAI,IAAmB;AAGhC,SAAS,0BAA0B,YAAoB,OAA0B;AACtF,UAAQ,IAAI,YAAY,KAAK;AAC7B,SAAO,MAAM;AACX,QAAI,QAAQ,IAAI,UAAU,MAAM,MAAO,SAAQ,OAAO,UAAU;AAAA,EAClE;AACF;AAMO,SAAS,qBAAqB,YAA6D;AAChG,QAAM,QAAQ,aAAa,QAAQ,IAAI,UAAU,IAAI;AACrD,SAAO,QAAQ,MAAM,IAAI;AAC3B;",
+  "sourcesContent": ["/** Mounted editors save their local changes before any chat turn reads the workspace. */\n\ntype Flush = () => Promise<void>\n\nconst flushes = new Map<string, Flush>()\n\n/** While mounted, `flush` saves `documentId`'s unsaved changes; returns the unregister. */\nexport function registerDocumentTurnFlush(documentId: string, flush: Flush): () => void {\n  flushes.set(documentId, flush)\n  return () => {\n    if (flushes.get(documentId) === flush) flushes.delete(documentId)\n  }\n}\n\n/** Save every mounted editor before a turn reads workspace documents. */\nexport function flushDocumentForTurn(_documentId: string | null | undefined): Promise<void> | null {\n  const pending = [...flushes.values()]\n  return pending.length ? Promise.all(pending.map((flush) => flush())).then(() => undefined) : null\n}\n"],
+  "mappings": "AAIA,MAAM,UAAU,oBAAI,IAAmB;AAGhC,SAAS,0BAA0B,YAAoB,OAA0B;AACtF,UAAQ,IAAI,YAAY,KAAK;AAC7B,SAAO,MAAM;AACX,QAAI,QAAQ,IAAI,UAAU,MAAM,MAAO,SAAQ,OAAO,UAAU;AAAA,EAClE;AACF;AAGO,SAAS,qBAAqB,aAA8D;AACjG,QAAM,UAAU,CAAC,GAAG,QAAQ,OAAO,CAAC;AACpC,SAAO,QAAQ,SAAS,QAAQ,IAAI,QAAQ,IAAI,CAAC,UAAU,MAAM,CAAC,CAAC,EAAE,KAAK,MAAM,MAAS,IAAI;AAC/F;",
   "names": []
 }