@bendyline/docblocks 2.7.6 → 2.7.7

package/THIRD_PARTY_NOTICES.txt

@@ -14,7 +14,7 @@ This notice is included in the published npm tarball. Transitive packages instal
 
 | Package | Version | License | Source |
 | --- | --- | --- | --- |
-| @bendyline/squisq | 2.13.0 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq | 2.13.3 | MIT | https://github.com/bendyline/squisq |
 | @bendyline/squisq-graph | 2.13.0 | MIT | https://github.com/bendyline/squisq |
 | @types/debug | 4.1.12 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
 | @types/hast | 3.0.4 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
@@ -133,7 +133,7 @@ This notice is included in the published npm tarball. Transitive packages instal
 Package-local license, copying, and notice files are reproduced below. Where a published package omits its repository license, the reviewed aggregate or README identified in `Source files` supplies the retained material.
 
 ==============================================================================
-Components: @bendyline/squisq-graph@2.13.0, @bendyline/squisq@2.13.0
+Components: @bendyline/squisq-graph@2.13.0, @bendyline/squisq@2.13.3
 Source files: node_modules/@bendyline/squisq-graph/LICENSE, node_modules/@bendyline/squisq/LICENSE
 ==============================================================================
 MIT License
@@ -189,7 +189,7 @@ repository license, the pinned upstream copy is vendored and identified below.
 COMPONENTS
 
 ==============================================================================
-Components: @bendyline/squisq@2.13.0
+Components: @bendyline/squisq@2.13.3
 Source files: node_modules/@bendyline/squisq/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq
@@ -220,7 +220,7 @@ third-party license texts for bundled code and data are shipped in
 THIRD_PARTY_LICENSES.txt.
 
 ==============================================================================
-Components: @bendyline/squisq@2.13.0
+Components: @bendyline/squisq@2.13.3
 Source files: node_modules/@bendyline/squisq/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq

package/dist/{capabilities-DJ7X9EOt.d.ts → capabilities-D4Z1xYZV.d.ts}

@@ -216,6 +216,17 @@ interface AiChatRequest {
     readonly maxTokens?: number;
     readonly purpose: AiChatPurpose;
     readonly responseFormat?: AiResponseFormat;
+    /**
+     * What to search knowledge catalogs for. Without it a provider searches with
+     * the last user message, which for a templated prompt is mostly document.
+     */
+    readonly knowledgeQuery?: string;
+    /**
+     * Number knowledge passages and ask the model to cite them as `[n]`. Only a
+     * caller that checks and renders citations should: the markers otherwise
+     * end up in its output.
+     */
+    readonly knowledgeCitations?: boolean;
 }
 interface AiChatCompletion {
     readonly text: string;
@@ -235,6 +246,12 @@ interface AiChatProgress {
     readonly outputTokens: number | null;
     readonly tokensPerSecond: number | null;
 }
+/** One reference passage the model was given; its citation number is its position from 1. */
+interface AiChatEvidence {
+    readonly title: string;
+    readonly catalogId: string;
+    readonly text: string;
+}
 /** One knowledge catalog that contributed reference passages to a request. */
 interface AiChatKnowledgeSource {
     readonly catalogId: string;
@@ -251,8 +268,11 @@ interface AiChatKnowledgeSource {
 type AiChatKnowledge = {
     readonly outcome: 'used';
     readonly sources: readonly AiChatKnowledgeSource[];
-    /** The passage texts the model was given, so its output can be checked against them. */
-    readonly evidence: readonly string[];
+    /**
+     * The passages the model was given, in citation order: it was asked to
+     * cite `evidence[0]` as `[1]`. Its output can be checked against them.
+     */
+    readonly evidence: readonly AiChatEvidence[];
 }
 /** The catalogs were searched and nothing relevant came back. */
  | {
@@ -282,14 +302,22 @@ type AiChatEvent = {
 interface AiFactCheckRequest {
     /** The output, as Markdown. */
     readonly text: string;
-    /** Reference passages the model was given. */
+    /** Reference passage texts the model was given, `[1]` first. */
     readonly evidence: readonly string[];
+    /**
+     * The model was asked to cite passages by number, and its numbers match
+     * `evidence`: check each sentence against what it cites. Otherwise each
+     * sentence is checked against all of the evidence and markers are ignored.
+     */
+    readonly citations: boolean;
     /** What the person supplied: their instructions and document. Details found here need no source. */
     readonly given: string;
 }
 interface AiFactCheckSentence {
-    /** The sentence, possibly shortened. */
+    /** The sentence without citation markers, possibly shortened. */
     readonly text: string;
+    /** `bad-citation`: it cites a passage number the model was never given. */
+    readonly problem: 'unsourced' | 'bad-citation';
     /** The names, dates, numbers or quotations no source shows. */
     readonly missing: readonly string[];
     /**
@@ -1123,6 +1151,14 @@ interface DocBlocksHostExternalAPI {
     writeBinary(resourceId: string, data: ArrayBuffer | Uint8Array): Promise<void>;
     commitText(resourceId: string, content: string, expectedContent: string | null): Promise<FileCommitResult>;
     commitBinary(resourceId: string, data: ArrayBuffer | Uint8Array, expectedVersion: string | null): Promise<ExternalBinaryCommitResult>;
+    /**
+     * Read, never write, a media file inside the folder of a loose markdown
+     * grant, so the document's relative image paths render. `relativePath` is a
+     * canonical `WorkspacePath` from that folder naming an image, audio, or video
+     * file; it cannot climb out or follow a symbolic link. Resolves null when
+     * the file does not exist. Bundle grants carry their media and refuse this.
+     */
+    readRelativeMedia?(resourceId: string, relativePath: string): Promise<ArrayBuffer | null>;
     /** Revoke one external resource when its transient document is closed. */
     revoke(resourceId: string): Promise<void>;
 }
@@ -1277,6 +1313,8 @@ interface HostCapabilities {
     readonly exportRememberedTargets: boolean;
     readonly openSavedExports: boolean;
     readonly externalResources: boolean;
+    /** A loose OS-opened file's relative images can be read from beside it. */
+    readonly externalRelativeMedia: boolean;
     readonly openRequests: boolean;
     readonly menuCommands: boolean;
     readonly pinnedDocumentMirror: boolean;
@@ -1340,4 +1378,4 @@ declare function parseHostEnvironment(value: unknown): HostEnvironment | null;
  */
 declare function deriveHostCapabilities(host: unknown): HostCapabilities;
 
-export { type DocBlocksHostShellAPI as $, type AiChatCompletion as A, type AiPreferences as B, type AiPreferencesPatch as C, type AiProgress as D, type AiProviderInfo as E, type AiResponseFormat as F, type AiResult as G, type AiReviewMode as H, type AiSearchHit as I, type AiSearchQuery as J, type AiSearchResult as K, type AiSpeechAudio as L, type AiStatus as M, type AiSynthesizeRequest as N, type AiTranscribeRequest as O, type AiTranscript as P, type AiUnavailableReason as Q, type DocBlocksHostAPI as R, type DocBlocksHostAiAPI as S, type DocBlocksHostClipboardAPI as T, type DocBlocksHostExportAPI as U, type DocBlocksHostExternalAPI as V, type DocBlocksHostFfmpegAPI as W, type DocBlocksHostFsAPI as X, type DocBlocksHostGitAPI as Y, type DocBlocksHostLifecycleAPI as Z, type DocBlocksHostMenuAPI as _, type AiChatEvent as a, parseAiKnowledgeAction as a$, type DocBlocksHostSpeechAPI as a0, type DocBlocksHostUpdaterAPI as a1, type DocBlocksHostWorkspacesAPI as a2, type ElectronWorkspaceInfo as a3, type ExternalBinaryCommitResult as a4, type GitBranchInfo as a5, type GitCapabilities as a6, type GitCloneHandle as a7, type GitCloneProgress as a8, type GitError as a9, type SpeechCatalog as aA, type SpeechError as aB, type SpeechErrorCode as aC, type SpeechInstallEvent as aD, type SpeechInstallHandle as aE, type SpeechModelInfo as aF, type SpeechModelKind as aG, type SpeechPreferences as aH, type SpeechPreferencesPatch as aI, type SpeechProgress as aJ, type SpeechReadiness as aK, type SpeechReadinessState as aL, type SpeechResult as aM, type SpeechSegment as aN, type SpeechStatus as aO, type SpeechSynthesisHandle as aP, type SpeechSynthesisSummary as aQ, type SpeechSynthesizeEvent as aR, type SpeechSynthesizeRequest as aS, type SpeechTranscribeRequest as aT, type SpeechTranscript as aU, type SpeechVoiceInfo as aV, type SpeechWordTiming as aW, type UpdateCheckResult as aX, type UpdateInstallResult as aY, type UpdaterStatus as aZ, deriveHostCapabilities as a_, type GitErrorCode as aa, type GitFileAtRevision as ab, type GitFileChange as ac, type GitFileStatusCode as ad, type GitLogEntry as ae, type GitLogOptions as af, type GitRemoteInfo as ag, type GitRepoDetection as ah, type GitResult as ai, type GitRevision as aj, type GitStatus as ak, HOST_PLATFORMS as al, HOST_SURFACE_KINDS as am, type HostCapabilities as an, type HostCloseReason as ao, type HostEnvironment as ap, type HostExportTargetGrant as aq, type HostPinnedDocument as ar, type HostPlatform as as, type HostPrepareCloseRequest as at, type HostPrepareCloseResult as au, type HostSurfaceKind as av, type MenuCommand as aw, NO_HOST_CAPABILITIES as ax, type OpenRequest as ay, type SpeechAudioChunk as az, type AiChatHandle as b, parseAiKnowledgeState as b0, parseHostEnvironment as b1, type AiChatKnowledge as c, type AiChatKnowledgeSource as d, type AiChatMessage as e, type AiChatProgress as f, type AiChatPurpose as g, type AiChatRequest as h, type AiConnectionStep as i, type AiEnsureWorkspaceHandle as j, type AiError as k, type AiErrorCode as l, type AiFactCheck as m, type AiFactCheckRequest as n, type AiFactCheckSentence as o, type AiImageRequest as p, type AiImageResult as q, type AiKnowledgeAPI as r, type AiKnowledgeAction as s, type AiKnowledgeCatalog as t, type AiKnowledgeState as u, type AiModelDownloadInfo as v, type AiModelFit as w, type AiModelInfo as x, type AiModelInstallEvent as y, type AiModelInstallHandle as z };
+export { type DocBlocksHostMenuAPI as $, type AiChatCompletion as A, type AiModelInstallHandle as B, type AiPreferences as C, type AiPreferencesPatch as D, type AiProgress as E, type AiProviderInfo as F, type AiResponseFormat as G, type AiResult as H, type AiReviewMode as I, type AiSearchHit as J, type AiSearchQuery as K, type AiSearchResult as L, type AiSpeechAudio as M, type AiStatus as N, type AiSynthesizeRequest as O, type AiTranscribeRequest as P, type AiTranscript as Q, type AiUnavailableReason as R, type DocBlocksHostAPI as S, type DocBlocksHostAiAPI as T, type DocBlocksHostClipboardAPI as U, type DocBlocksHostExportAPI as V, type DocBlocksHostExternalAPI as W, type DocBlocksHostFfmpegAPI as X, type DocBlocksHostFsAPI as Y, type DocBlocksHostGitAPI as Z, type DocBlocksHostLifecycleAPI as _, type AiChatEvent as a, deriveHostCapabilities as a$, type DocBlocksHostShellAPI as a0, type DocBlocksHostSpeechAPI as a1, type DocBlocksHostUpdaterAPI as a2, type DocBlocksHostWorkspacesAPI as a3, type ElectronWorkspaceInfo as a4, type ExternalBinaryCommitResult as a5, type GitBranchInfo as a6, type GitCapabilities as a7, type GitCloneHandle as a8, type GitCloneProgress as a9, type SpeechAudioChunk as aA, type SpeechCatalog as aB, type SpeechError as aC, type SpeechErrorCode as aD, type SpeechInstallEvent as aE, type SpeechInstallHandle as aF, type SpeechModelInfo as aG, type SpeechModelKind as aH, type SpeechPreferences as aI, type SpeechPreferencesPatch as aJ, type SpeechProgress as aK, type SpeechReadiness as aL, type SpeechReadinessState as aM, type SpeechResult as aN, type SpeechSegment as aO, type SpeechStatus as aP, type SpeechSynthesisHandle as aQ, type SpeechSynthesisSummary as aR, type SpeechSynthesizeEvent as aS, type SpeechSynthesizeRequest as aT, type SpeechTranscribeRequest as aU, type SpeechTranscript as aV, type SpeechVoiceInfo as aW, type SpeechWordTiming as aX, type UpdateCheckResult as aY, type UpdateInstallResult as aZ, type UpdaterStatus as a_, type GitError as aa, type GitErrorCode as ab, type GitFileAtRevision as ac, type GitFileChange as ad, type GitFileStatusCode as ae, type GitLogEntry as af, type GitLogOptions as ag, type GitRemoteInfo as ah, type GitRepoDetection as ai, type GitResult as aj, type GitRevision as ak, type GitStatus as al, HOST_PLATFORMS as am, HOST_SURFACE_KINDS as an, type HostCapabilities as ao, type HostCloseReason as ap, type HostEnvironment as aq, type HostExportTargetGrant as ar, type HostPinnedDocument as as, type HostPlatform as at, type HostPrepareCloseRequest as au, type HostPrepareCloseResult as av, type HostSurfaceKind as aw, type MenuCommand as ax, NO_HOST_CAPABILITIES as ay, type OpenRequest as az, type AiChatEvidence as b, parseAiKnowledgeAction as b0, parseAiKnowledgeState as b1, parseHostEnvironment as b2, type AiChatHandle as c, type AiChatKnowledge as d, type AiChatKnowledgeSource as e, type AiChatMessage as f, type AiChatProgress as g, type AiChatPurpose as h, type AiChatRequest as i, type AiConnectionStep as j, type AiEnsureWorkspaceHandle as k, type AiError as l, type AiErrorCode as m, type AiFactCheck as n, type AiFactCheckRequest as o, type AiFactCheckSentence as p, type AiImageRequest as q, type AiImageResult as r, type AiKnowledgeAPI as s, type AiKnowledgeAction as t, type AiKnowledgeCatalog as u, type AiKnowledgeState as v, type AiModelDownloadInfo as w, type AiModelFit as x, type AiModelInfo as y, type AiModelInstallEvent as z };

package/dist/{chunk-Q3OFZWJS.js → chunk-3HUKGWDK.js}

@@ -1,7 +1,7 @@
 import {
   RawIndexedDBFileSystemStore,
   indexedDBWorkspaceDatabaseName
-} from "./chunk-DAPFSEKY.js";
+} from "./chunk-OPLU2CYA.js";
 import {
   withFileCommitLock
 } from "./chunk-DZB666V7.js";
@@ -1616,11 +1616,23 @@ var EXTENSION_MIME_MAP = {
   ".svg": "image/svg+xml",
   ".webp": "image/webp",
   ".avif": "image/avif",
+  // Video and audio match the extensions Squisq inserts as players, so a file
+  // dropped into a document lists as the same media it was inserted as.
   ".mp4": "video/mp4",
+  ".m4v": "video/mp4",
+  ".mov": "video/quicktime",
   ".webm": "video/webm",
+  ".ogv": "video/ogg",
+  ".mkv": "video/x-matroska",
   ".mp3": "audio/mpeg",
+  ".m4a": "audio/mp4",
+  ".aac": "audio/aac",
   ".wav": "audio/wav",
-  ".ogg": "audio/ogg"
+  ".ogg": "audio/ogg",
+  ".oga": "audio/ogg",
+  ".opus": "audio/opus",
+  ".flac": "audio/flac",
+  ".weba": "audio/webm"
 };
 function guessMimeType(path) {
   const dot = path.lastIndexOf(".");

package/dist/{chunk-LJLQYXVL.js → chunk-5VEIEFFC.js}

@@ -1,6 +1,6 @@
 import {
   guessMimeType
-} from "./chunk-Q3OFZWJS.js";
+} from "./chunk-3HUKGWDK.js";
 import {
   bytesEqual,
   compareSnapshotsByName,
@@ -26,6 +26,7 @@ import {
   WORKSPACE_ROOT,
   fsErrorFromUnknown,
   parseWorkspacePath,
+  tryParseWorkspacePath,
   workspacePathBasename,
   workspacePathContains,
   workspacePathDirname,
@@ -1111,7 +1112,7 @@ var FileSystemContentContainer = class {
 function stripExt(name) {
   return name.replace(/\.[^.]+$/, "");
 }
-function createFileMediaProvider(container, markdownBasename) {
+function createFileMediaProvider(container, markdownBasename, options = {}) {
   const folder = stripExt(markdownBasename) + "_files";
   const prefix = folder + "/";
   const blobUrlCache = /* @__PURE__ */ new Map();
@@ -1122,35 +1123,63 @@ function createFileMediaProvider(container, markdownBasename) {
     const clean = ref.replace(/^\/+/, "");
     return clean.startsWith(prefix) ? clean : prefix + clean;
   }
+  function fallbackSlot(key) {
+    return "\0" + key;
+  }
   function invalidate(key) {
     generations.set(key, (generations.get(key) ?? 0) + 1);
-    pending.delete(key);
-    const cached = blobUrlCache.get(key);
-    if (cached) URL.revokeObjectURL(cached);
-    blobUrlCache.delete(key);
+    for (const slot of [key, fallbackSlot(key)]) {
+      pending.delete(slot);
+      const cached = blobUrlCache.get(slot);
+      if (cached) URL.revokeObjectURL(cached);
+      blobUrlCache.delete(slot);
+    }
   }
   function resolveUrl(ref) {
     if (disposed) return Promise.resolve(ref);
     const key = toKey(ref);
-    const cached = blobUrlCache.get(key);
+    const readDocumentRelative = options.readDocumentRelative;
+    if (!readDocumentRelative || ref.startsWith("/") || ref.startsWith(prefix)) {
+      return resolveSlot(ref, key, key, () => container.readFile(key));
+    }
+    const found = blobUrlCache.get(key) ?? blobUrlCache.get(fallbackSlot(key));
+    if (found) return Promise.resolve(found);
+    const resolveFallback = () => resolveSlot(
+      ref,
+      key,
+      fallbackSlot(key),
+      () => (
+        // The fallback can only add resolutions, never new failures.
+        readDocumentRelative(ref).catch(() => null)
+      )
+    );
+    if (key.split("/").some((segment) => segment === "." || segment === "..")) {
+      return resolveFallback();
+    }
+    return resolveSlot(ref, key, key, () => container.readFile(key)).then(
+      (url) => url !== ref || disposed ? url : resolveFallback()
+    );
+  }
+  function resolveSlot(ref, key, slot, read) {
+    const cached = blobUrlCache.get(slot);
     if (cached) return Promise.resolve(cached);
-    const existing = pending.get(key);
+    const existing = pending.get(slot);
     if (existing) {
       return existing.promise.then((url) => url === existing.ref ? ref : url);
     }
     const generation = generations.get(key) ?? 0;
     const work = (async () => {
-      const data = await container.readFile(key);
+      const data = await read();
       if (disposed) return ref;
       if ((generations.get(key) ?? 0) !== generation) return resolveUrl(ref);
       if (!data) return ref;
       const url = URL.createObjectURL(new Blob([data], { type: guessMimeType(key) }));
-      blobUrlCache.set(key, url);
+      blobUrlCache.set(slot, url);
       return url;
     })().finally(() => {
-      if (pending.get(key)?.promise === work) pending.delete(key);
+      if (pending.get(slot)?.promise === work) pending.delete(slot);
     });
-    pending.set(key, { ref, promise: work });
+    pending.set(slot, { ref, promise: work });
     return work;
   }
   return {
@@ -1194,6 +1223,35 @@ function createFileMediaProvider(container, markdownBasename) {
   };
 }
 
+// src/filesystem/document-relative-media.ts
+function isDocumentMediaPath(path) {
+  return /^(?:image|audio|video)\//.test(guessMimeType(path));
+}
+function resolveDocumentRelativeMediaPath(documentDirectory, ref) {
+  const directory = tryParseWorkspacePath(documentDirectory);
+  if (directory === null) return null;
+  const queryAt = ref.search(/[?#]/);
+  const raw = (queryAt === -1 ? ref : ref.slice(0, queryAt)).trim();
+  if (!raw || /^[a-z][a-z0-9+.-]*:/i.test(raw) || /^[\\/]/.test(raw)) return null;
+  let decoded = raw;
+  try {
+    decoded = decodeURIComponent(raw);
+  } catch {
+  }
+  const segments = directory ? directory.split("/") : [];
+  for (const segment of decoded.replace(/\\/g, "/").split("/")) {
+    if (segment === "" || segment === ".") continue;
+    if (segment === "..") {
+      if (segments.length === 0) return null;
+      segments.pop();
+      continue;
+    }
+    segments.push(segment);
+  }
+  const resolved = tryParseWorkspacePath(segments.join("/"));
+  return resolved && isDocumentMediaPath(resolved) ? resolved : null;
+}
+
 export {
   suggestWikiArticles,
   resolveWikiArticlePath,
@@ -1207,5 +1265,7 @@ export {
   createDbkWorkspaceSnapshot,
   replaceMemoryWorkspaceFromDbk,
   FileSystemContentContainer,
-  createFileMediaProvider
+  createFileMediaProvider,
+  isDocumentMediaPath,
+  resolveDocumentRelativeMediaPath
 };

package/dist/{chunk-56QRV45P.js → chunk-66WTIYYG.js}

@@ -1,10 +1,10 @@
 import {
   HostFileSystemProviderV2
-} from "./chunk-45XD424D.js";
+} from "./chunk-NECMAJHS.js";
 import {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
   maybeGetDocBlocksHost
-} from "./chunk-P4VIU7MB.js";
+} from "./chunk-RFEB4N5Q.js";
 
 // src/filesystem/electron-provider-v2.ts
 var ElectronFileSystemProviderV2 = class extends HostFileSystemProviderV2 {

package/dist/{chunk-XI2LYBRR.js → chunk-FGT6AW2D.js}

@@ -1,6 +1,6 @@
 import {
   RawIndexedDBFileSystemStore
-} from "./chunk-DAPFSEKY.js";
+} from "./chunk-OPLU2CYA.js";
 import {
   getFileSystemProviderV2
 } from "./chunk-XAMILHQP.js";

package/dist/{chunk-45XD424D.js → chunk-NECMAJHS.js}

@@ -1,7 +1,7 @@
 import {
   FILE_SYSTEM_TRANSFER_LIMITS,
   maybeGetDocBlocksHost
-} from "./chunk-P4VIU7MB.js";
+} from "./chunk-RFEB4N5Q.js";
 import {
   parseFileSystemCapabilities
 } from "./chunk-245W57QP.js";

package/dist/{chunk-DAPFSEKY.js → chunk-OPLU2CYA.js}

@@ -24,8 +24,7 @@ var RawIndexedDBFileSystemStore = class {
     this.closed = false;
   }
   async transaction(mode, operation) {
-    const database = await this.getDatabase();
-    const nativeTransaction = database.transaction(this.storeName, mode);
+    const nativeTransaction = await this.beginTransaction(mode);
     const completion = waitForTransaction(nativeTransaction);
     const transaction = new RawIndexedDBFileSystemTransaction(
       nativeTransaction.objectStore(this.storeName)
@@ -51,6 +50,30 @@ var RawIndexedDBFileSystemStore = class {
     this.database = null;
     this.opening = null;
   }
+  /**
+   * Start a native transaction, reconnecting once if the cached connection
+   * was closed underneath this store. Browsers close IndexedDB connections on
+   * their own (after the device sleeps, when site data is cleared, or when
+   * the storage backend restarts), and a closed connection rejects every
+   * later `transaction()` call with InvalidStateError ("The database
+   * connection is closing"). No work has run at that point, so reopening and
+   * starting again is safe.
+   */
+  async beginTransaction(mode) {
+    const database = await this.getDatabase();
+    try {
+      return database.transaction(this.storeName, mode);
+    } catch (error) {
+      if (!isClosedConnectionError(error)) throw error;
+      this.forgetDatabase(database);
+      const reopened = await this.getDatabase();
+      return reopened.transaction(this.storeName, mode);
+    }
+  }
+  forgetDatabase(database) {
+    if (this.database === database) this.database = null;
+    database.close();
+  }
   getDatabase() {
     if (this.closed) {
       return Promise.reject(new Error("The IndexedDB filesystem store is closed."));
@@ -67,10 +90,8 @@ var RawIndexedDBFileSystemStore = class {
       }
       this.database = database;
       this.opening = null;
-      database.onversionchange = () => {
-        database.close();
-        if (this.database === database) this.database = null;
-      };
+      database.onversionchange = () => this.forgetDatabase(database);
+      database.onclose = () => this.forgetDatabase(database);
       return database;
     }).catch((error) => {
       this.opening = null;
@@ -182,6 +203,9 @@ function openDatabase(databaseName, version, upgrade) {
     };
   });
 }
+function isClosedConnectionError(error) {
+  return typeof error === "object" && error !== null && error.name === "InvalidStateError";
+}
 function requestResult(request) {
   return new Promise((resolve, reject) => {
     request.onsuccess = () => resolve(request.result);

package/dist/{chunk-P4VIU7MB.js → chunk-RFEB4N5Q.js}

@@ -29,6 +29,7 @@ var NO_CAPABILITIES = Object.freeze({
   exportRememberedTargets: false,
   openSavedExports: false,
   externalResources: false,
+  externalRelativeMedia: false,
   openRequests: false,
   menuCommands: false,
   pinnedDocumentMirror: false,
@@ -107,6 +108,7 @@ function deriveHostCapabilities(host) {
     exportRememberedTargets: hasMethod(exports, "resolveTarget") && hasMethod(exports, "pickTarget"),
     openSavedExports: hasMethod(exports, "openSaved"),
     externalResources: hasMethod(host.external, "readText"),
+    externalRelativeMedia: hasMethod(host.external, "readRelativeMedia"),
     openRequests: hasMethod(host, "onOpenRequest"),
     menuCommands: hasMethod(host, "onMenuCommand"),
     pinnedDocumentMirror: hasMethod(host.menu, "setPinnedDocuments"),
@@ -153,6 +155,8 @@ var AI_WIRE_LIMITS = Object.freeze({
   knowledgeSources: 8,
   knowledgeTitles: 8,
   knowledgeTitleCharacters: 256,
+  /** A knowledge search; Gezel accepts up to 8,192 characters. */
+  knowledgeQueryCharacters: 8192,
   /** Passage texts sent with a knowledge report; Gezel caps a retrieval at 24,000 characters. */
   knowledgeEvidence: 8,
   knowledgeEvidenceCharacters: 24 * 1024,
@@ -412,7 +416,14 @@ function parseAiChatRequest(value) {
   if (!hasKeysWithin(
     value,
     ["messages", "purpose"],
-    ["model", "temperature", "maxTokens", "responseFormat"]
+    [
+      "model",
+      "temperature",
+      "maxTokens",
+      "responseFormat",
+      "knowledgeQuery",
+      "knowledgeCitations"
+    ]
   )) {
     return null;
   }
@@ -440,13 +451,21 @@ function parseAiChatRequest(value) {
   }
   const responseFormat = value.responseFormat === void 0 ? void 0 : parseAiResponseFormat(value.responseFormat);
   if (responseFormat === null) return null;
+  if (value.knowledgeQuery !== void 0 && !isBoundedString(value.knowledgeQuery, AI_WIRE_LIMITS.knowledgeQueryCharacters, 1)) {
+    return null;
+  }
+  if (value.knowledgeCitations !== void 0 && typeof value.knowledgeCitations !== "boolean") {
+    return null;
+  }
   return {
     messages,
     purpose: value.purpose,
     ...value.model === void 0 ? {} : { model: value.model },
     ...value.temperature === void 0 ? {} : { temperature: value.temperature },
     ...value.maxTokens === void 0 ? {} : { maxTokens: value.maxTokens },
-    ...responseFormat === void 0 ? {} : { responseFormat }
+    ...responseFormat === void 0 ? {} : { responseFormat },
+    ...value.knowledgeQuery === void 0 ? {} : { knowledgeQuery: value.knowledgeQuery },
+    ...value.knowledgeCitations === void 0 ? {} : { knowledgeCitations: value.knowledgeCitations }
   };
 }
 function parseAiChatProgress(value) {
@@ -489,12 +508,8 @@ function parseAiChatKnowledge(value) {
   if (value.outcome !== "used" || !hasExactKeys(value, ["outcome", "sources", "evidence"])) {
     return null;
   }
-  const evidence = parseTextList(
-    value.evidence,
-    AI_WIRE_LIMITS.knowledgeEvidence,
-    AI_WIRE_LIMITS.knowledgeEvidenceCharacters
-  );
-  if (!evidence || evidence.length === 0) return null;
+  const evidence = parseAiChatEvidence(value.evidence);
+  if (!evidence) return null;
   if (!Array.isArray(value.sources) || value.sources.length === 0 || value.sources.length > AI_WIRE_LIMITS.knowledgeSources) {
     return null;
   }
@@ -508,6 +523,23 @@ function parseAiChatKnowledge(value) {
   }
   return { outcome: "used", sources, evidence };
 }
+function parseAiChatEvidence(value) {
+  if (!Array.isArray(value) || value.length === 0 || value.length > AI_WIRE_LIMITS.knowledgeEvidence) {
+    return null;
+  }
+  const evidence = [];
+  let total = 0;
+  for (const entry of value) {
+    if (!isRecord2(entry) || !hasExactKeys(entry, ["title", "catalogId", "text"])) return null;
+    if (!isBoundedString(entry.title, AI_WIRE_LIMITS.knowledgeTitleCharacters)) return null;
+    if (!isBoundedString(entry.catalogId, HOST_WIRE_LIMITS.identifierCharacters, 1)) return null;
+    if (!isBoundedString(entry.text, AI_WIRE_LIMITS.knowledgeEvidenceCharacters, 1)) return null;
+    total += entry.text.length;
+    if (total > AI_WIRE_LIMITS.knowledgeEvidenceCharacters) return null;
+    evidence.push({ title: entry.title, catalogId: entry.catalogId, text: entry.text });
+  }
+  return evidence;
+}
 function parseTextList(value, entries, characters) {
   if (!Array.isArray(value) || value.length > entries) return null;
   let total = 0;
@@ -521,7 +553,10 @@ function parseTextList(value, entries, characters) {
   return texts;
 }
 function parseAiFactCheckRequest(value) {
-  if (!isRecord2(value) || !hasExactKeys(value, ["text", "evidence", "given"])) return null;
+  if (!isRecord2(value) || !hasExactKeys(value, ["text", "evidence", "given", "citations"])) {
+    return null;
+  }
+  if (typeof value.citations !== "boolean") return null;
   if (!isBoundedString(value.text, AI_WIRE_LIMITS.factCheckTextCharacters)) return null;
   if (!isBoundedString(value.given, AI_WIRE_LIMITS.factCheckGivenCharacters)) return null;
   const evidence = parseTextList(
@@ -529,11 +564,14 @@ function parseAiFactCheckRequest(value) {
     AI_WIRE_LIMITS.factCheckEvidence,
     AI_WIRE_LIMITS.factCheckEvidenceCharacters
   );
-  return evidence ? { text: value.text, evidence, given: value.given } : null;
+  return evidence ? { text: value.text, evidence, given: value.given, citations: value.citations } : null;
 }
 function parseAiFactCheckSentence(value) {
-  if (!isRecord2(value) || !hasExactKeys(value, ["text", "missing", "strong"])) return null;
+  if (!isRecord2(value) || !hasExactKeys(value, ["text", "problem", "missing", "strong"])) {
+    return null;
+  }
   if (!isBoundedString(value.text, AI_WIRE_LIMITS.factCheckSentenceCharacters, 1)) return null;
+  if (value.problem !== "unsourced" && value.problem !== "bad-citation") return null;
   if (typeof value.strong !== "boolean") return null;
   if (!Array.isArray(value.missing) || value.missing.length > AI_WIRE_LIMITS.factCheckDetails) {
     return null;
@@ -543,7 +581,7 @@ function parseAiFactCheckSentence(value) {
     if (!isBoundedString(detail, AI_WIRE_LIMITS.knowledgeTitleCharacters, 1)) return null;
     missing.push(detail);
   }
-  return { text: value.text, missing, strong: value.strong };
+  return { text: value.text, problem: value.problem, missing, strong: value.strong };
 }
 function parseAiFactCheck(value) {
   if (!isRecord2(value) || !hasExactKeys(value, ["checked", "unsourced"])) return null;

package/dist/filesystem/electron.d.ts

@@ -4,7 +4,7 @@ export { isElectronHost } from '../host/index.js';
 import '../v2-DwxWjFC0.js';
 import '../workspace-path-CWVrcuPL.js';
 import '../filesystem-v2-CXdAPR27.js';
-import '../capabilities-DJ7X9EOt.js';
+import '../capabilities-D4Z1xYZV.js';
 
 /** Compatibility entry point retaining the Electron backend's exact guarantees. */
 declare class ElectronFileSystemProviderV2 extends HostFileSystemProviderV2 {

package/dist/filesystem/electron.js

@@ -1,11 +1,11 @@
 import {
   ElectronFileSystemProvider,
   ElectronFileSystemProviderV2
-} from "../chunk-56QRV45P.js";
-import "../chunk-45XD424D.js";
+} from "../chunk-66WTIYYG.js";
+import "../chunk-NECMAJHS.js";
 import {
   isElectronHost
-} from "../chunk-P4VIU7MB.js";
+} from "../chunk-RFEB4N5Q.js";
 import "../chunk-245W57QP.js";
 import "../chunk-V5SWLUZY.js";
 import "../chunk-73OOROXH.js";

package/dist/filesystem/host.js

@@ -1,10 +1,10 @@
 import {
   HostFileSystemProviderV2
-} from "../chunk-45XD424D.js";
+} from "../chunk-NECMAJHS.js";
 import {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
   maybeGetDocBlocksHost
-} from "../chunk-P4VIU7MB.js";
+} from "../chunk-RFEB4N5Q.js";
 import "../chunk-245W57QP.js";
 import "../chunk-V5SWLUZY.js";
 import "../chunk-73OOROXH.js";