@bendyline/docblocks 2.7.12 → 2.7.13

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.10 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq | 2.13.12 | MIT | https://github.com/bendyline/squisq |
 | @bendyline/squisq-graph | 2.13.1 | 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.1, @bendyline/squisq@2.13.10
+Components: @bendyline/squisq-graph@2.13.1, @bendyline/squisq@2.13.12
 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.10
+Components: @bendyline/squisq@2.13.12
 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.10
+Components: @bendyline/squisq@2.13.12
 Source files: node_modules/@bendyline/squisq/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq

package/dist/{capabilities-CH66e2pR.d.ts → capabilities-yyRj0hyP.d.ts}

@@ -1,5 +1,5 @@
-import { F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from './types-DLteNrK0.js';
-import { D as DocBlocksHostFsV2API } from './filesystem-v2-CXdAPR27.js';
+import { F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from './types-BIaQ_gYW.js';
+import { D as DocBlocksHostFsV2API } from './filesystem-v2-CYPHqoIw.js';
 
 /**
  * On-device image generation.
@@ -61,6 +61,7 @@ interface AiImageModel {
     /** Installed in a store the provider reads but this app does not own; not removable here. */
     readonly shared: boolean;
     readonly license: string | null;
+    readonly licenseUrl?: string | null;
     /** False when the license forbids commercial use; null when the provider does not say. */
     readonly commercialUse: boolean | null;
     /** Draws legible text, which design graphics depend on. */
@@ -72,12 +73,18 @@ interface AiImageModel {
     readonly minRamGb: number | null;
     readonly fit: AiImageModelFit | null;
 }
+interface AiImageStyle extends Pick<AiImageModel, 'id' | 'label' | 'description' | 'state' | 'downloadBytes' | 'license' | 'licenseUrl' | 'commercialUse'> {
+    /** Opaque model ids this style was checked against. */
+    readonly baseModels: readonly string[];
+}
 interface AiImagePreferences {
     /** The model "Generate image" uses; null lets the provider choose an installed one. */
     readonly model: string | null;
     /** The model Illustrate's design graphics use; null offers none. */
     readonly designModel: string | null;
     readonly aspect: AiImageAspect;
+    /** Preferred rendering style for Generate image. Absent on older installs. */
+    readonly style?: string | null;
 }
 type AiImagePreferencesPatch = Partial<AiImagePreferences>;
 interface AiImageRequest {
@@ -87,6 +94,8 @@ interface AiImageRequest {
     readonly model?: string;
     readonly aspect?: AiImageAspect;
     readonly seed?: number;
+    /** An installed style compatible with model; omitted for no style. */
+    readonly style?: string;
 }
 interface AiImageResult {
     readonly mimeType: 'image/png';
@@ -124,18 +133,18 @@ interface AiImageHandle {
     /** Stop the render. The engine stops, so the next render reloads its weights. */
     cancel(): void;
 }
-type AiImageInstallEvent = {
+type AiImageInstallEvent<T = AiImageModel> = {
     readonly kind: 'progress';
     readonly progress: AiProgress;
 } | {
     readonly kind: 'done';
-    readonly model: AiImageModel;
+    readonly model: T;
 } | {
     readonly kind: 'error';
     readonly error: AiError;
 };
-interface AiImageInstallHandle {
-    readonly done: Promise<AiResult<AiImageModel>>;
+interface AiImageInstallHandle<T = AiImageModel> {
+    readonly done: Promise<AiResult<T>>;
     /** Stop the download. Starting it again resumes. */
     cancel(): void;
 }
@@ -148,6 +157,9 @@ interface AiImagesAPI {
     /** Start a model download from an explicit gesture. */
     installModel(id: string, onProgress?: (progress: AiProgress) => void): AiImageInstallHandle;
     removeModel(id: string): Promise<AiResult<null>>;
+    styles?(): Promise<AiResult<readonly AiImageStyle[]>>;
+    installStyle?(id: string, onProgress?: (progress: AiProgress) => void): AiImageInstallHandle<AiImageStyle>;
+    removeStyle?(id: string): Promise<AiResult<null>>;
     getPreferences(): Promise<AiImagePreferences>;
     setPreferences(patch: AiImagePreferencesPatch): Promise<AiImagePreferences>;
     generate(request: AiImageRequest, onEvent: (event: AiImageEvent) => void): AiImageHandle;
@@ -165,12 +177,15 @@ declare function isAiImageAspect(value: unknown): value is AiImageAspect;
 declare function parseAiImageAccess(value: unknown): AiImageAccess | null;
 declare function parseAiImageModel(value: unknown): AiImageModel | null;
 declare function parseAiImageModelList(value: unknown): AiImageModel[] | null;
+declare function parseAiImageStyle(value: unknown): AiImageStyle | null;
+declare function parseAiImageStyleList(value: unknown): AiImageStyle[] | null;
 declare function parseAiImagePreferences(value: unknown): AiImagePreferences | null;
 declare function parseAiImagePreferencesPatch(value: unknown): AiImagePreferencesPatch | null;
 declare function parseAiImageRequest(value: unknown): AiImageRequest | null;
 declare function parseAiImageResult(value: unknown): AiImageResult | null;
 declare function parseAiImageEvent(value: unknown): AiImageEvent | null;
 declare function parseAiImageInstallEvent(value: unknown): AiImageInstallEvent | null;
+declare function parseAiImageInstallEvent<T>(value: unknown, parse: (value: unknown) => T | null): AiImageInstallEvent<T> | null;
 
 /** Provider-neutral catalog management. IDs never authorize filesystem access. */
 interface AiKnowledgeCatalog {
@@ -211,6 +226,19 @@ interface AiKnowledgeAPI {
     state(): Promise<AiResult<AiKnowledgeState>>;
     update(action: AiKnowledgeAction): Promise<AiResult<null>>;
 }
+/** A reference passage a provider gave the model, as a host receives it. */
+interface AiKnowledgePassage {
+    readonly title: string;
+    readonly catalogId: string;
+    readonly text: string;
+}
+/** Group cited passages by catalog, in the order the provider ranked them. */
+declare function knowledgeSources(passages: readonly AiKnowledgePassage[], names: ReadonlyMap<string, string> | undefined): AiChatKnowledgeSource[];
+/**
+ * The `knowledge` chat event for one retrieval: what was cited, or that
+ * nothing was. Null when no catalog is enabled, so no indicator appears.
+ */
+declare function knowledgeChatEvent(status: 'used' | 'none' | 'skipped', passages: readonly AiKnowledgePassage[], names: ReadonlyMap<string, string> | undefined, anyEnabled: boolean): AiChatKnowledge | null;
 declare function parseAiKnowledgeAction(value: unknown): AiKnowledgeAction | null;
 declare function parseAiKnowledgeState(value: unknown): AiKnowledgeState | null;
 
@@ -1552,4 +1580,4 @@ declare function parseHostEnvironment(value: unknown): HostEnvironment | null;
  */
 declare function deriveHostCapabilities(host: unknown): HostCapabilities;
 
-export { type AiSearchQuery as $, AI_IMAGE_ASPECTS as A, type AiImageModelFit as B, type AiImagePhase as C, type AiImagePreferences as D, type AiImagePreferencesPatch as E, type AiImageProgress as F, type AiImageRequest as G, type AiImageResult as H, type AiImageUnavailableReason as I, type AiImagesAPI as J, type AiKnowledgeAPI as K, type AiKnowledgeAction as L, type AiKnowledgeCatalog as M, type AiKnowledgeState as N, type AiModelDownloadInfo as O, type AiModelFit as P, type AiModelInfo as Q, type AiModelInstallEvent as R, type AiModelInstallHandle as S, type AiPreferences as T, type AiPreferencesPatch as U, type AiProgress as V, type AiProviderInfo as W, type AiResponseFormat as X, type AiResult as Y, type AiReviewMode as Z, type AiSearchHit as _, AI_IMAGE_FIT_VERDICTS as a, type SpeechProgress as a$, type AiSearchResult as a0, type AiSpeechAudio as a1, type AiStatus as a2, type AiSynthesizeRequest as a3, type AiTranscribeRequest as a4, type AiTranscript as a5, type AiUnavailableReason as a6, type DocBlocksHostAPI as a7, type DocBlocksHostAiAPI as a8, type DocBlocksHostClipboardAPI as a9, type GitResult as aA, type GitRevision as aB, type GitStatus as aC, HOST_PLATFORMS as aD, HOST_SURFACE_KINDS as aE, type HostCapabilities as aF, type HostCloseReason as aG, type HostEnvironment as aH, type HostExportTargetGrant as aI, type HostPinnedDocument as aJ, type HostPlatform as aK, type HostPrepareCloseRequest as aL, type HostPrepareCloseResult as aM, type HostSurfaceKind as aN, type MenuCommand as aO, NO_HOST_CAPABILITIES as aP, type OpenRequest as aQ, type SpeechAudioChunk as aR, type SpeechCatalog as aS, type SpeechError as aT, type SpeechErrorCode as aU, type SpeechInstallEvent as aV, type SpeechInstallHandle as aW, type SpeechModelInfo as aX, type SpeechModelKind as aY, type SpeechPreferences as aZ, type SpeechPreferencesPatch as a_, type DocBlocksHostExportAPI as aa, type DocBlocksHostExternalAPI as ab, type DocBlocksHostFfmpegAPI as ac, type DocBlocksHostFsAPI as ad, type DocBlocksHostGitAPI as ae, type DocBlocksHostLifecycleAPI as af, type DocBlocksHostMenuAPI as ag, type DocBlocksHostShellAPI as ah, type DocBlocksHostSpeechAPI as ai, type DocBlocksHostUpdaterAPI as aj, type DocBlocksHostWorkspacesAPI as ak, type ElectronWorkspaceInfo as al, type ExternalBinaryCommitResult as am, type GitBranchInfo as an, type GitCapabilities as ao, type GitCloneHandle as ap, type GitCloneProgress as aq, type GitError as ar, type GitErrorCode as as, type GitFileAtRevision as at, type GitFileChange as au, type GitFileStatusCode as av, type GitLogEntry as aw, type GitLogOptions as ax, type GitRemoteInfo as ay, type GitRepoDetection as az, AI_IMAGE_WIRE_LIMITS as b, type SpeechReadiness as b0, type SpeechReadinessState as b1, type SpeechResult as b2, type SpeechSegment as b3, type SpeechStatus as b4, type SpeechSynthesisHandle as b5, type SpeechSynthesisSummary as b6, type SpeechSynthesizeEvent as b7, type SpeechSynthesizeRequest as b8, type SpeechTranscribeRequest as b9, type SpeechTranscript as ba, type SpeechVoiceInfo as bb, type SpeechWord as bc, type SpeechWordTiming as bd, type UpdateCheckResult as be, type UpdateInstallResult as bf, type UpdaterStatus as bg, deriveHostCapabilities as bh, isAiImageAspect as bi, isAiImageModelId as bj, parseAiImageAccess as bk, parseAiImageEvent as bl, parseAiImageInstallEvent as bm, parseAiImageModel as bn, parseAiImageModelList as bo, parseAiImagePreferences as bp, parseAiImagePreferencesPatch as bq, parseAiImageRequest as br, parseAiImageResult as bs, parseAiKnowledgeAction as bt, parseAiKnowledgeState as bu, parseHostEnvironment as bv, type AiChatCompletion as c, type AiChatEvent as d, type AiChatEvidence as e, type AiChatHandle as f, type AiChatKnowledge as g, type AiChatKnowledgeSource as h, type AiChatMessage as i, type AiChatProgress as j, type AiChatPurpose as k, type AiChatRequest as l, type AiConnectionStep as m, type AiEnsureWorkspaceHandle as n, type AiError as o, type AiErrorCode as p, type AiFactCheck as q, type AiFactCheckRequest as r, type AiFactCheckSentence as s, type AiImageAccess as t, type AiImageAspect as u, type AiImageEvent as v, type AiImageHandle as w, type AiImageInstallEvent as x, type AiImageInstallHandle as y, type AiImageModel as z };
+export { type AiReviewMode as $, AI_IMAGE_ASPECTS as A, type AiImageModelFit as B, type AiImagePhase as C, type AiImagePreferences as D, type AiImagePreferencesPatch as E, type AiImageProgress as F, type AiImageRequest as G, type AiImageResult as H, type AiImageStyle as I, type AiImageUnavailableReason as J, type AiImagesAPI as K, type AiKnowledgeAPI as L, type AiKnowledgeAction as M, type AiKnowledgeCatalog as N, type AiKnowledgePassage as O, type AiKnowledgeState as P, type AiModelDownloadInfo as Q, type AiModelFit as R, type AiModelInfo as S, type AiModelInstallEvent as T, type AiModelInstallHandle as U, type AiPreferences as V, type AiPreferencesPatch as W, type AiProgress as X, type AiProviderInfo as Y, type AiResponseFormat as Z, type AiResult as _, AI_IMAGE_FIT_VERDICTS as a, type SpeechPreferences as a$, type AiSearchHit as a0, type AiSearchQuery as a1, type AiSearchResult as a2, type AiSpeechAudio as a3, type AiStatus as a4, type AiSynthesizeRequest as a5, type AiTranscribeRequest as a6, type AiTranscript as a7, type AiUnavailableReason as a8, type DocBlocksHostAPI as a9, type GitRemoteInfo as aA, type GitRepoDetection as aB, type GitResult as aC, type GitRevision as aD, type GitStatus as aE, HOST_PLATFORMS as aF, HOST_SURFACE_KINDS as aG, type HostCapabilities as aH, type HostCloseReason as aI, type HostEnvironment as aJ, type HostExportTargetGrant as aK, type HostPinnedDocument as aL, type HostPlatform as aM, type HostPrepareCloseRequest as aN, type HostPrepareCloseResult as aO, type HostSurfaceKind as aP, type MenuCommand as aQ, NO_HOST_CAPABILITIES as aR, type OpenRequest as aS, type SpeechAudioChunk as aT, type SpeechCatalog as aU, type SpeechError as aV, type SpeechErrorCode as aW, type SpeechInstallEvent as aX, type SpeechInstallHandle as aY, type SpeechModelInfo as aZ, type SpeechModelKind as a_, type DocBlocksHostAiAPI as aa, type DocBlocksHostClipboardAPI as ab, type DocBlocksHostExportAPI as ac, type DocBlocksHostExternalAPI as ad, type DocBlocksHostFfmpegAPI as ae, type DocBlocksHostFsAPI as af, type DocBlocksHostGitAPI as ag, type DocBlocksHostLifecycleAPI as ah, type DocBlocksHostMenuAPI as ai, type DocBlocksHostShellAPI as aj, type DocBlocksHostSpeechAPI as ak, type DocBlocksHostUpdaterAPI as al, type DocBlocksHostWorkspacesAPI as am, type ElectronWorkspaceInfo as an, type ExternalBinaryCommitResult as ao, type GitBranchInfo as ap, type GitCapabilities as aq, type GitCloneHandle as ar, type GitCloneProgress as as, type GitError as at, type GitErrorCode as au, type GitFileAtRevision as av, type GitFileChange as aw, type GitFileStatusCode as ax, type GitLogEntry as ay, type GitLogOptions as az, AI_IMAGE_WIRE_LIMITS as b, type SpeechPreferencesPatch as b0, type SpeechProgress as b1, type SpeechReadiness as b2, type SpeechReadinessState as b3, type SpeechResult as b4, type SpeechSegment as b5, type SpeechStatus as b6, type SpeechSynthesisHandle as b7, type SpeechSynthesisSummary as b8, type SpeechSynthesizeEvent as b9, parseAiKnowledgeState as bA, parseHostEnvironment as bB, type SpeechSynthesizeRequest as ba, type SpeechTranscribeRequest as bb, type SpeechTranscript as bc, type SpeechVoiceInfo as bd, type SpeechWord as be, type SpeechWordTiming as bf, type UpdateCheckResult as bg, type UpdateInstallResult as bh, type UpdaterStatus as bi, deriveHostCapabilities as bj, isAiImageAspect as bk, isAiImageModelId as bl, knowledgeChatEvent as bm, knowledgeSources as bn, parseAiImageAccess as bo, parseAiImageEvent as bp, parseAiImageInstallEvent as bq, parseAiImageModel as br, parseAiImageModelList as bs, parseAiImagePreferences as bt, parseAiImagePreferencesPatch as bu, parseAiImageRequest as bv, parseAiImageResult as bw, parseAiImageStyle as bx, parseAiImageStyleList as by, parseAiKnowledgeAction as bz, type AiChatCompletion as c, type AiChatEvent as d, type AiChatEvidence as e, type AiChatHandle as f, type AiChatKnowledge as g, type AiChatKnowledgeSource as h, type AiChatMessage as i, type AiChatProgress as j, type AiChatPurpose as k, type AiChatRequest as l, type AiConnectionStep as m, type AiEnsureWorkspaceHandle as n, type AiError as o, type AiErrorCode as p, type AiFactCheck as q, type AiFactCheckRequest as r, type AiFactCheckSentence as s, type AiImageAccess as t, type AiImageAspect as u, type AiImageEvent as v, type AiImageHandle as w, type AiImageInstallEvent as x, type AiImageInstallHandle as y, type AiImageModel as z };

package/dist/{chunk-LP6JHGBP.js → chunk-C6J65F5C.js}

@@ -1,10 +1,10 @@
 import {
   HostFileSystemProviderV2
-} from "./chunk-ZBRXXOW5.js";
+} from "./chunk-P5VP6XMH.js";
 import {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
   maybeGetDocBlocksHost
-} from "./chunk-WE5W7BRL.js";
+} from "./chunk-OIBDXKQN.js";
 
 // src/filesystem/electron-provider-v2.ts
 var ElectronFileSystemProviderV2 = class extends HostFileSystemProviderV2 {

package/dist/{chunk-WE5W7BRL.js → chunk-OIBDXKQN.js}

@@ -1,6 +1,7 @@
 import {
   HOST_WIRE_LIMITS,
-  isBoundedString
+  isBoundedString,
+  parseExternalHttpUrl
 } from "./chunk-V5SWLUZY.js";
 
 // src/host/capabilities.ts
@@ -1245,6 +1246,37 @@ var ELECTRON_FILE_SYSTEM_V2_CAPABILITIES = Object.freeze({
 });
 
 // src/host/ai-knowledge.ts
+function knowledgeSources(passages, names) {
+  const sources = /* @__PURE__ */ new Map();
+  for (const passage of passages) {
+    let source = sources.get(passage.catalogId);
+    if (!source) {
+      if (sources.size >= AI_WIRE_LIMITS.knowledgeSources) continue;
+      const name = names?.get(passage.catalogId) ?? passage.catalogId;
+      source = { name: name.slice(0, 256), titles: [] };
+      sources.set(passage.catalogId, source);
+    }
+    const title = passage.title.trim().slice(0, AI_WIRE_LIMITS.knowledgeTitleCharacters);
+    if (title && !source.titles.includes(title) && source.titles.length < AI_WIRE_LIMITS.knowledgeTitles) {
+      source.titles.push(title);
+    }
+  }
+  return [...sources].map(([catalogId, { name, titles }]) => ({ catalogId, name, titles }));
+}
+function knowledgeChatEvent(status, passages, names, anyEnabled) {
+  if (status === "used")
+    return {
+      outcome: "used",
+      sources: knowledgeSources(passages, names),
+      // In citation order: the model was asked to cite `evidence[0]` as [1].
+      evidence: passages.map((passage) => ({
+        title: passage.title.trim().slice(0, AI_WIRE_LIMITS.knowledgeTitleCharacters),
+        catalogId: passage.catalogId,
+        text: passage.text
+      }))
+    };
+  return anyEnabled ? { outcome: status } : null;
+}
 function record(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -1398,7 +1430,9 @@ var MODEL_KEYS = [
   "fit"
 ];
 function parseAiImageModel(value) {
-  if (!record2(value) || !exact2(value, MODEL_KEYS)) return null;
+  if (!record2(value) || !within(value, MODEL_KEYS, ["licenseUrl"])) return null;
+  if (value.licenseUrl !== void 0 && value.licenseUrl !== null && !parseExternalHttpUrl(value.licenseUrl))
+    return null;
   if (!isAiImageModelId(value.id) || !label2(value.label)) return null;
   if (value.description !== null && !message2(value.description)) return null;
   if (value.state !== "installed" && value.state !== "download-required" && value.state !== "downloading")
@@ -1427,6 +1461,7 @@ function parseAiImageModel(value) {
     downloadBytes: value.downloadBytes,
     shared: value.shared,
     license: value.license,
+    ...value.licenseUrl !== void 0 ? { licenseUrl: value.licenseUrl } : {},
     commercialUse: value.commercialUse,
     rendersText: value.rendersText,
     promptStyle: value.promptStyle,
@@ -1447,15 +1482,74 @@ function parseAiImageModelList(value) {
   }
   return models;
 }
+function parseAiImageStyle(value) {
+  if (!record2(value) || !within(
+    value,
+    [
+      "id",
+      "label",
+      "description",
+      "state",
+      "downloadBytes",
+      "license",
+      "commercialUse",
+      "baseModels"
+    ],
+    ["licenseUrl"]
+  ))
+    return null;
+  if (!Array.isArray(value.baseModels) || value.baseModels.length === 0 || value.baseModels.length > AI_IMAGE_WIRE_LIMITS.models || !value.baseModels.every(isAiImageModelId))
+    return null;
+  const { baseModels, ...fields } = value;
+  const model = parseAiImageModel({
+    ...fields,
+    shared: false,
+    rendersText: false,
+    promptStyle: null,
+    hardwareTier: null,
+    minRamGb: null,
+    fit: null
+  });
+  if (!model) return null;
+  return {
+    id: model.id,
+    label: model.label,
+    description: model.description,
+    state: model.state,
+    downloadBytes: model.downloadBytes,
+    license: model.license,
+    ...model.licenseUrl !== void 0 ? { licenseUrl: model.licenseUrl } : {},
+    commercialUse: model.commercialUse,
+    baseModels: [...baseModels]
+  };
+}
+function parseAiImageStyleList(value) {
+  if (!Array.isArray(value) || value.length > AI_IMAGE_WIRE_LIMITS.models) return null;
+  const styles = [];
+  for (const raw of value) {
+    const style = parseAiImageStyle(raw);
+    if (!style || styles.some((entry) => entry.id === style.id)) return null;
+    styles.push(style);
+  }
+  return styles;
+}
 function parseAiImagePreferences(value) {
-  if (!record2(value) || !exact2(value, ["model", "designModel", "aspect"])) return null;
+  if (!record2(value) || !within(value, ["model", "designModel", "aspect"], ["style"])) return null;
   if (value.model !== null && !isAiImageModelId(value.model)) return null;
   if (value.designModel !== null && !isAiImageModelId(value.designModel)) return null;
   if (!isAiImageAspect(value.aspect)) return null;
-  return { model: value.model, designModel: value.designModel, aspect: value.aspect };
+  if (value.style !== void 0 && value.style !== null && !isAiImageModelId(value.style))
+    return null;
+  return {
+    model: value.model,
+    designModel: value.designModel,
+    aspect: value.aspect,
+    ...value.style !== void 0 ? { style: value.style } : {}
+  };
 }
 function parseAiImagePreferencesPatch(value) {
-  if (!record2(value) || !within(value, [], ["model", "designModel", "aspect"])) return null;
+  if (!record2(value) || !within(value, [], ["model", "designModel", "aspect", "style"]))
+    return null;
   const patch = {};
   if ("model" in value) {
     if (value.model !== null && !isAiImageModelId(value.model)) return null;
@@ -1469,10 +1563,14 @@ function parseAiImagePreferencesPatch(value) {
     if (!isAiImageAspect(value.aspect)) return null;
     patch.aspect = value.aspect;
   }
+  if ("style" in value) {
+    if (value.style !== null && !isAiImageModelId(value.style)) return null;
+    patch.style = value.style;
+  }
   return patch;
 }
 function parseAiImageRequest(value) {
-  if (!record2(value) || !within(value, ["prompt"], ["negativePrompt", "model", "aspect", "seed"]))
+  if (!record2(value) || !within(value, ["prompt"], ["negativePrompt", "model", "aspect", "seed", "style"]))
     return null;
   if (!isBoundedString(value.prompt, AI_IMAGE_WIRE_LIMITS.promptCharacters, 1)) return null;
   if (!value.prompt.trim()) return null;
@@ -1481,12 +1579,14 @@ function parseAiImageRequest(value) {
   if (value.model !== void 0 && !isAiImageModelId(value.model)) return null;
   if (value.aspect !== void 0 && !isAiImageAspect(value.aspect)) return null;
   if (value.seed !== void 0 && !count2(value.seed, 2147483647)) return null;
+  if (value.style !== void 0 && !isAiImageModelId(value.style)) return null;
   return {
     prompt: value.prompt,
     ...value.negativePrompt !== void 0 ? { negativePrompt: value.negativePrompt } : {},
     ...value.model !== void 0 ? { model: value.model } : {},
     ...value.aspect !== void 0 ? { aspect: value.aspect } : {},
-    ...value.seed !== void 0 ? { seed: value.seed } : {}
+    ...value.seed !== void 0 ? { seed: value.seed } : {},
+    ...value.style !== void 0 ? { style: value.style } : {}
   };
 }
 function ownedBuffer2(value, maximumBytes) {
@@ -1558,7 +1658,7 @@ function parseAiImageEvent(value) {
   }
   return null;
 }
-function parseAiImageInstallEvent(value) {
+function parseAiImageInstallEvent(value, parse = parseAiImageModel) {
   if (!record2(value)) return null;
   if (value.kind === "progress") {
     if (!exact2(value, ["kind", "progress"])) return null;
@@ -1567,7 +1667,7 @@ function parseAiImageInstallEvent(value) {
   }
   if (value.kind === "done") {
     if (!exact2(value, ["kind", "model"])) return null;
-    const model = parseAiImageModel(value.model);
+    const model = parse(value.model);
     return model ? { kind: "done", model } : null;
   }
   if (value.kind === "error") {
@@ -1657,6 +1757,8 @@ export {
   parseSpeechSynthesizeEvent,
   FILE_SYSTEM_TRANSFER_LIMITS,
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
+  knowledgeSources,
+  knowledgeChatEvent,
   parseAiKnowledgeAction,
   parseAiKnowledgeState,
   AI_IMAGE_ASPECTS,
@@ -1667,6 +1769,8 @@ export {
   parseAiImageAccess,
   parseAiImageModel,
   parseAiImageModelList,
+  parseAiImageStyle,
+  parseAiImageStyleList,
   parseAiImagePreferences,
   parseAiImagePreferencesPatch,
   parseAiImageRequest,

package/dist/{chunk-ZBRXXOW5.js → chunk-P5VP6XMH.js}

@@ -1,7 +1,7 @@
 import {
   FILE_SYSTEM_TRANSFER_LIMITS,
   maybeGetDocBlocksHost
-} from "./chunk-WE5W7BRL.js";
+} from "./chunk-OIBDXKQN.js";
 import {
   parseFileSystemCapabilities
 } from "./chunk-245W57QP.js";
@@ -421,11 +421,16 @@ function normalizeEntry(entry) {
       throw new TypeError("Filesystem file size must be a non-negative safe integer.");
     }
     const readIssue = normalizeReadIssue(entry.readIssue);
+    const onlineOnly = entry.onlineOnly;
+    if (onlineOnly !== void 0 && onlineOnly !== true) {
+      throw new TypeError("Filesystem entry online-only flag must be true when present.");
+    }
     return Object.freeze({
       ...common,
       kind: "file",
       size: entry.size,
-      ...readIssue ? { readIssue } : {}
+      ...readIssue ? { readIssue } : {},
+      ...onlineOnly === true ? { onlineOnly: true } : {}
     });
   }
   if (entry.kind === "directory") {

package/dist/document/index.d.ts

@@ -1,5 +1,5 @@
-import { d as FileSystemProvider } from '../types-DLteNrK0.js';
-import '../v2-DwxWjFC0.js';
+import { d as FileSystemProvider } from '../types-BIaQ_gYW.js';
+import '../v2-pBdrFAlW.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /**

package/dist/filesystem/electron.d.ts

@@ -1,10 +1,10 @@
-import { d as FileSystemProvider, F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from '../types-DLteNrK0.js';
-import { H as HostFileSystemProviderV2 } from '../host-provider-v2-DEWMPiRD.js';
+import { d as FileSystemProvider, F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from '../types-BIaQ_gYW.js';
+import { H as HostFileSystemProviderV2 } from '../host-provider-v2-C2g9R17A.js';
 export { isElectronHost } from '../host/index.js';
-import '../v2-DwxWjFC0.js';
+import '../v2-pBdrFAlW.js';
 import '../workspace-path-CWVrcuPL.js';
-import '../filesystem-v2-CXdAPR27.js';
-import '../capabilities-CH66e2pR.js';
+import '../filesystem-v2-CYPHqoIw.js';
+import '../capabilities-yyRj0hyP.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-LP6JHGBP.js";
-import "../chunk-ZBRXXOW5.js";
+} from "../chunk-C6J65F5C.js";
+import "../chunk-P5VP6XMH.js";
 import {
   isElectronHost
-} from "../chunk-WE5W7BRL.js";
+} from "../chunk-OIBDXKQN.js";
 import "../chunk-245W57QP.js";
 import "../chunk-V5SWLUZY.js";
 import "../chunk-73OOROXH.js";

package/dist/filesystem/host.d.ts

@@ -1,7 +1,7 @@
-import { H as HostFileSystemProviderV2, a as HostFileSystemClientOptions } from '../host-provider-v2-DEWMPiRD.js';
-import { d as FileSystemProvider, F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from '../types-DLteNrK0.js';
-import '../filesystem-v2-CXdAPR27.js';
-import '../v2-DwxWjFC0.js';
+import { H as HostFileSystemProviderV2, a as HostFileSystemClientOptions } from '../host-provider-v2-C2g9R17A.js';
+import { d as FileSystemProvider, F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from '../types-BIaQ_gYW.js';
+import '../filesystem-v2-CYPHqoIw.js';
+import '../v2-pBdrFAlW.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /** Temporary text facade; all storage and conditional mutation is owned by v2. */

package/dist/filesystem/host.js

@@ -1,10 +1,10 @@
 import {
   HostFileSystemProviderV2
-} from "../chunk-ZBRXXOW5.js";
+} from "../chunk-P5VP6XMH.js";
 import {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
   maybeGetDocBlocksHost
-} from "../chunk-WE5W7BRL.js";
+} from "../chunk-OIBDXKQN.js";
 import "../chunk-245W57QP.js";
 import "../chunk-V5SWLUZY.js";
 import "../chunk-73OOROXH.js";

package/dist/filesystem/index.d.ts

@@ -1,10 +1,10 @@
-import { d as FileSystemProvider } from '../types-DLteNrK0.js';
-export { F as FileCommitResult, a as FileEntry, b as FileMeta, c as FileSystemEntry, e as FileSystemProviderWithV2, f as FolderEntry, g as getFileSystemProviderV2, h as hasFileSystemProviderV2 } from '../types-DLteNrK0.js';
+import { d as FileSystemProvider } from '../types-BIaQ_gYW.js';
+export { F as FileCommitResult, a as FileEntry, b as FileMeta, c as FileSystemEntry, e as FileSystemProviderWithV2, f as FolderEntry, g as getFileSystemProviderV2, h as hasFileSystemProviderV2 } from '../types-BIaQ_gYW.js';
 import { WikiLinkSuggestion } from '@bendyline/squisq/markdown';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 export { W as WORKSPACE_ROOT, p as parseWorkspacePath, t as tryParseWorkspacePath, w as workspacePathBasename, b as workspacePathContains, c as workspacePathDirname, d as workspacePathJoin, e as workspacePathToLegacy } from '../workspace-path-CWVrcuPL.js';
-import { J as FsOperation, o as FileSystemProviderV2, n as FileSystemProviderCapabilities, F as FileSystemAtomicity, a as FileSystemCaseSensitivity, u as FileSystemSymlinkPolicy, f as FileSystemDurability, h as FileSystemEntrySnapshot, j as FileSystemFileRead, E as FileSystemWriteOptions, k as FileSystemFileSnapshot, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, A as FileSystemWatchListener, B as FileSystemWatchOptions, C as FileSystemWatchSubscription } from '../v2-DwxWjFC0.js';
-export { b as FileSystemConditionalWriteStrength, c as FileSystemCreateDirectoryMode, g as FileSystemEntryReadIssue, i as FileSystemEntryWatchEvent, m as FileSystemOverflowWatchEvent, s as FileSystemSnapshotEntry, t as FileSystemSnapshotFile, v as FileSystemVersion, w as FileSystemWatchErrorListener, x as FileSystemWatchEvent, y as FileSystemWatchEventOrigin, z as FileSystemWatchEventType, D as FileSystemWriteMode, G as FsError, H as FsErrorCode, I as FsErrorContext, S as SerializedFsError, K as deserializeFsError, L as fsErrorFromUnknown, M as isQuotaExceededError, N as isSerializedFsError, O as mapDomExceptionToFsErrorCode, P as mapNodeErrorCodeToFsErrorCode, Q as parseFileSystemVersion, R as serializeFsError, T as tryParseFileSystemVersion } from '../v2-DwxWjFC0.js';
+import { J as FsOperation, o as FileSystemProviderV2, n as FileSystemProviderCapabilities, F as FileSystemAtomicity, a as FileSystemCaseSensitivity, u as FileSystemSymlinkPolicy, f as FileSystemDurability, h as FileSystemEntrySnapshot, j as FileSystemFileRead, E as FileSystemWriteOptions, k as FileSystemFileSnapshot, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, A as FileSystemWatchListener, B as FileSystemWatchOptions, C as FileSystemWatchSubscription } from '../v2-pBdrFAlW.js';
+export { b as FileSystemConditionalWriteStrength, c as FileSystemCreateDirectoryMode, g as FileSystemEntryReadIssue, i as FileSystemEntryWatchEvent, m as FileSystemOverflowWatchEvent, s as FileSystemSnapshotEntry, t as FileSystemSnapshotFile, v as FileSystemVersion, w as FileSystemWatchErrorListener, x as FileSystemWatchEvent, y as FileSystemWatchEventOrigin, z as FileSystemWatchEventType, D as FileSystemWriteMode, G as FsError, H as FsErrorCode, I as FsErrorContext, S as SerializedFsError, K as deserializeFsError, L as fsErrorFromUnknown, M as isQuotaExceededError, N as isSerializedFsError, O as mapDomExceptionToFsErrorCode, P as mapNodeErrorCodeToFsErrorCode, Q as parseFileSystemVersion, R as serializeFsError, T as tryParseFileSystemVersion } from '../v2-pBdrFAlW.js';
 import { MemoryFileSystemSnapshot, MemoryFileSystemProvider } from './memory.js';
 export { MemoryFilePayloadKind, MemoryFileSystemProviderV2, MemoryFileSystemSnapshotFile, MemoryFileSystemV2CompatibilityFile, MemoryFileSystemV2Replacement, MemoryFileSystemV2ReplacementFile, MemoryFileSystemV2State, MemoryFileSystemV2StateFile } from './memory.js';
 export { IndexedDBContentContainer, IndexedDBFileSystemProvider, IndexedDBFileSystemProviderV2, IndexedDBFileSystemProviderV2Options, IndexedDBLegacyConflictReason, IndexedDBLegacyConflictResolution, IndexedDBLegacyMigrationConflict, IndexedDBLegacyOpaqueDiscardTarget, IndexedDBLegacyOpaqueRecord, IndexedDBLegacyOpaqueRecordSummary, IndexedDBLegacyOpaqueValue, IndexedDBLegacyRecoveryCandidate, IndexedDBLegacyRecoveryKind } from './indexeddb.js';
@@ -13,9 +13,9 @@ import { MediaProvider } from '@bendyline/squisq/schemas';
 export { NativeFileSystemMovePathState, NativeFileSystemMoveRecoveryError, NativeFileSystemMoveRecoveryState, NativeFileSystemProvider, NativeFileSystemProviderV2, isNativeFileSystemSupported, loadDirectoryHandle, openNativeFolder, removeDirectoryHandle, restoreNativeFolder, storeDirectoryHandle } from './native.js';
 export { ElectronFileSystemProvider, ElectronFileSystemProviderV2 } from './electron.js';
 export { isElectronHost } from '../host/index.js';
-import '../host-provider-v2-DEWMPiRD.js';
-import '../filesystem-v2-CXdAPR27.js';
-import '../capabilities-CH66e2pR.js';
+import '../host-provider-v2-C2g9R17A.js';
+import '../filesystem-v2-CYPHqoIw.js';
+import '../capabilities-yyRj0hyP.js';
 
 /** Immediate article/folder suggestions from an already bounded listing. */
 declare function suggestWikiArticles(files: readonly {

package/dist/filesystem/index.js

@@ -50,11 +50,11 @@ import "../chunk-3GSMJ4MQ.js";
 import {
   ElectronFileSystemProvider,
   ElectronFileSystemProviderV2
-} from "../chunk-LP6JHGBP.js";
-import "../chunk-ZBRXXOW5.js";
+} from "../chunk-C6J65F5C.js";
+import "../chunk-P5VP6XMH.js";
 import {
   isElectronHost
-} from "../chunk-WE5W7BRL.js";
+} from "../chunk-OIBDXKQN.js";
 import "../chunk-245W57QP.js";
 import "../chunk-V5SWLUZY.js";
 import "../chunk-73OOROXH.js";

package/dist/filesystem/indexeddb.d.ts

@@ -1,5 +1,5 @@
-import { b as FileMeta, d as FileSystemProvider, F as FileCommitResult, c as FileSystemEntry } from '../types-DLteNrK0.js';
-import { o as FileSystemProviderV2, n as FileSystemProviderCapabilities, h as FileSystemEntrySnapshot, j as FileSystemFileRead, E as FileSystemWriteOptions, k as FileSystemFileSnapshot, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, A as FileSystemWatchListener, B as FileSystemWatchOptions, C as FileSystemWatchSubscription } from '../v2-DwxWjFC0.js';
+import { b as FileMeta, d as FileSystemProvider, F as FileCommitResult, c as FileSystemEntry } from '../types-BIaQ_gYW.js';
+import { o as FileSystemProviderV2, n as FileSystemProviderCapabilities, h as FileSystemEntrySnapshot, j as FileSystemFileRead, E as FileSystemWriteOptions, k as FileSystemFileSnapshot, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, A as FileSystemWatchListener, B as FileSystemWatchOptions, C as FileSystemWatchSubscription } from '../v2-pBdrFAlW.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 import { ContentContainer, ContentEntry } from '@bendyline/squisq/storage';
 

package/dist/filesystem/memory.d.ts

@@ -1,5 +1,5 @@
-import { F as FileCommitResult, d as FileSystemProvider, c as FileSystemEntry, b as FileMeta } from '../types-DLteNrK0.js';
-import { o as FileSystemProviderV2, n as FileSystemProviderCapabilities, E as FileSystemWriteOptions, k as FileSystemFileSnapshot, h as FileSystemEntrySnapshot, j as FileSystemFileRead, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, A as FileSystemWatchListener, B as FileSystemWatchOptions, C as FileSystemWatchSubscription } from '../v2-DwxWjFC0.js';
+import { F as FileCommitResult, d as FileSystemProvider, c as FileSystemEntry, b as FileMeta } from '../types-BIaQ_gYW.js';
+import { o as FileSystemProviderV2, n as FileSystemProviderCapabilities, E as FileSystemWriteOptions, k as FileSystemFileSnapshot, h as FileSystemEntrySnapshot, j as FileSystemFileRead, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, A as FileSystemWatchListener, B as FileSystemWatchOptions, C as FileSystemWatchSubscription } from '../v2-pBdrFAlW.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 
 type MemoryFilePayloadKind = 'text' | 'binary';

package/dist/filesystem/native.d.ts

@@ -1,5 +1,5 @@
-import { d as FileSystemProvider, F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from '../types-DLteNrK0.js';
-import { G as FsError, o as FileSystemProviderV2, n as FileSystemProviderCapabilities, h as FileSystemEntrySnapshot, j as FileSystemFileRead, E as FileSystemWriteOptions, k as FileSystemFileSnapshot, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, A as FileSystemWatchListener, B as FileSystemWatchOptions, C as FileSystemWatchSubscription } from '../v2-DwxWjFC0.js';
+import { d as FileSystemProvider, F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from '../types-BIaQ_gYW.js';
+import { G as FsError, o as FileSystemProviderV2, n as FileSystemProviderCapabilities, h as FileSystemEntrySnapshot, j as FileSystemFileRead, E as FileSystemWriteOptions, k as FileSystemFileSnapshot, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, A as FileSystemWatchListener, B as FileSystemWatchOptions, C as FileSystemWatchSubscription } from '../v2-pBdrFAlW.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 
 type NativeFileSystemMovePathState = 'present' | 'missing' | 'unknown';

package/dist/{filesystem-v2-CXdAPR27.d.ts → filesystem-v2-CYPHqoIw.d.ts}

@@ -1,4 +1,4 @@
-import { n as FileSystemProviderCapabilities, S as SerializedFsError, k as FileSystemFileSnapshot, E as FileSystemWriteOptions, h as FileSystemEntrySnapshot, j as FileSystemFileRead, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, x as FileSystemWatchEvent } from './v2-DwxWjFC0.js';
+import { n as FileSystemProviderCapabilities, S as SerializedFsError, k as FileSystemFileSnapshot, E as FileSystemWriteOptions, h as FileSystemEntrySnapshot, j as FileSystemFileRead, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, x as FileSystemWatchEvent } from './v2-pBdrFAlW.js';
 import { a as WorkspacePath } from './workspace-path-CWVrcuPL.js';
 
 /** File size and per-message size are deliberately separate budgets. */

package/dist/host/index.d.ts

@@ -1,8 +1,8 @@
-import { d as AiChatEvent, g as AiChatKnowledge, j as AiChatProgress, l as AiChatRequest, o as AiError, q as AiFactCheck, r as AiFactCheckRequest, O as AiModelDownloadInfo, Q as AiModelInfo, R as AiModelInstallEvent, T as AiPreferences, U as AiPreferencesPatch, V as AiProgress, a2 as AiStatus, aR as SpeechAudioChunk, aS as SpeechCatalog, aT as SpeechError, aV as SpeechInstallEvent, aX as SpeechModelInfo, aY as SpeechModelKind, b2 as SpeechResult, aZ as SpeechPreferences, a_ as SpeechPreferencesPatch, a$ as SpeechProgress, b0 as SpeechReadiness, b4 as SpeechStatus, b6 as SpeechSynthesisSummary, b7 as SpeechSynthesizeEvent, b8 as SpeechSynthesizeRequest, b9 as SpeechTranscribeRequest, ba as SpeechTranscript, bb as SpeechVoiceInfo, aQ as OpenRequest, aJ as HostPinnedDocument, a7 as DocBlocksHostAPI, aF as HostCapabilities, aH as HostEnvironment } from '../capabilities-CH66e2pR.js';
-export { A as AI_IMAGE_ASPECTS, a as AI_IMAGE_FIT_VERDICTS, b as AI_IMAGE_WIRE_LIMITS, c as AiChatCompletion, e as AiChatEvidence, f as AiChatHandle, h as AiChatKnowledgeSource, i as AiChatMessage, k as AiChatPurpose, m as AiConnectionStep, n as AiEnsureWorkspaceHandle, p as AiErrorCode, s as AiFactCheckSentence, t as AiImageAccess, u as AiImageAspect, v as AiImageEvent, w as AiImageHandle, x as AiImageInstallEvent, y as AiImageInstallHandle, z as AiImageModel, B as AiImageModelFit, C as AiImagePhase, D as AiImagePreferences, E as AiImagePreferencesPatch, F as AiImageProgress, G as AiImageRequest, H as AiImageResult, I as AiImageUnavailableReason, J as AiImagesAPI, K as AiKnowledgeAPI, L as AiKnowledgeAction, M as AiKnowledgeCatalog, N as AiKnowledgeState, P as AiModelFit, S as AiModelInstallHandle, W as AiProviderInfo, X as AiResponseFormat, Y as AiResult, Z as AiReviewMode, _ as AiSearchHit, $ as AiSearchQuery, a0 as AiSearchResult, a1 as AiSpeechAudio, a3 as AiSynthesizeRequest, a4 as AiTranscribeRequest, a5 as AiTranscript, a6 as AiUnavailableReason, a8 as DocBlocksHostAiAPI, a9 as DocBlocksHostClipboardAPI, aa as DocBlocksHostExportAPI, ab as DocBlocksHostExternalAPI, ac as DocBlocksHostFfmpegAPI, ad as DocBlocksHostFsAPI, ae as DocBlocksHostGitAPI, af as DocBlocksHostLifecycleAPI, ag as DocBlocksHostMenuAPI, ah as DocBlocksHostShellAPI, ai as DocBlocksHostSpeechAPI, aj as DocBlocksHostUpdaterAPI, ak as DocBlocksHostWorkspacesAPI, al as ElectronWorkspaceInfo, am as ExternalBinaryCommitResult, an as GitBranchInfo, ao as GitCapabilities, ap as GitCloneHandle, aq as GitCloneProgress, ar as GitError, as as GitErrorCode, at as GitFileAtRevision, au as GitFileChange, av as GitFileStatusCode, aw as GitLogEntry, ax as GitLogOptions, ay as GitRemoteInfo, az as GitRepoDetection, aA as GitResult, aB as GitRevision, aC as GitStatus, aD as HOST_PLATFORMS, aE as HOST_SURFACE_KINDS, aG as HostCloseReason, aI as HostExportTargetGrant, aK as HostPlatform, aL as HostPrepareCloseRequest, aM as HostPrepareCloseResult, aN as HostSurfaceKind, aO as MenuCommand, aP as NO_HOST_CAPABILITIES, aU as SpeechErrorCode, aW as SpeechInstallHandle, b1 as SpeechReadinessState, b3 as SpeechSegment, b5 as SpeechSynthesisHandle, bc as SpeechWord, bd as SpeechWordTiming, be as UpdateCheckResult, bf as UpdateInstallResult, bg as UpdaterStatus, bh as deriveHostCapabilities, bi as isAiImageAspect, bj as isAiImageModelId, bk as parseAiImageAccess, bl as parseAiImageEvent, bm as parseAiImageInstallEvent, bn as parseAiImageModel, bo as parseAiImageModelList, bp as parseAiImagePreferences, bq as parseAiImagePreferencesPatch, br as parseAiImageRequest, bs as parseAiImageResult, bt as parseAiKnowledgeAction, bu as parseAiKnowledgeState, bv as parseHostEnvironment } from '../capabilities-CH66e2pR.js';
-export { D as DocBlocksHostFsV2API, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, F as FILE_SYSTEM_TRANSFER_LIMITS, H as HostFileSystemReadTransfer, a as HostFileSystemV2OpenRequest, b as HostFileSystemV2Result, c as HostFileSystemV2WatchMessage } from '../filesystem-v2-CXdAPR27.js';
-import '../types-DLteNrK0.js';
-import '../v2-DwxWjFC0.js';
+import { d as AiChatEvent, g as AiChatKnowledge, j as AiChatProgress, l as AiChatRequest, o as AiError, q as AiFactCheck, r as AiFactCheckRequest, Q as AiModelDownloadInfo, S as AiModelInfo, T as AiModelInstallEvent, V as AiPreferences, W as AiPreferencesPatch, X as AiProgress, a4 as AiStatus, aT as SpeechAudioChunk, aU as SpeechCatalog, aV as SpeechError, aX as SpeechInstallEvent, aZ as SpeechModelInfo, a_ as SpeechModelKind, b4 as SpeechResult, a$ as SpeechPreferences, b0 as SpeechPreferencesPatch, b1 as SpeechProgress, b2 as SpeechReadiness, b6 as SpeechStatus, b8 as SpeechSynthesisSummary, b9 as SpeechSynthesizeEvent, ba as SpeechSynthesizeRequest, bb as SpeechTranscribeRequest, bc as SpeechTranscript, bd as SpeechVoiceInfo, aS as OpenRequest, aL as HostPinnedDocument, a9 as DocBlocksHostAPI, aH as HostCapabilities, aJ as HostEnvironment } from '../capabilities-yyRj0hyP.js';
+export { A as AI_IMAGE_ASPECTS, a as AI_IMAGE_FIT_VERDICTS, b as AI_IMAGE_WIRE_LIMITS, c as AiChatCompletion, e as AiChatEvidence, f as AiChatHandle, h as AiChatKnowledgeSource, i as AiChatMessage, k as AiChatPurpose, m as AiConnectionStep, n as AiEnsureWorkspaceHandle, p as AiErrorCode, s as AiFactCheckSentence, t as AiImageAccess, u as AiImageAspect, v as AiImageEvent, w as AiImageHandle, x as AiImageInstallEvent, y as AiImageInstallHandle, z as AiImageModel, B as AiImageModelFit, C as AiImagePhase, D as AiImagePreferences, E as AiImagePreferencesPatch, F as AiImageProgress, G as AiImageRequest, H as AiImageResult, I as AiImageStyle, J as AiImageUnavailableReason, K as AiImagesAPI, L as AiKnowledgeAPI, M as AiKnowledgeAction, N as AiKnowledgeCatalog, O as AiKnowledgePassage, P as AiKnowledgeState, R as AiModelFit, U as AiModelInstallHandle, Y as AiProviderInfo, Z as AiResponseFormat, _ as AiResult, $ as AiReviewMode, a0 as AiSearchHit, a1 as AiSearchQuery, a2 as AiSearchResult, a3 as AiSpeechAudio, a5 as AiSynthesizeRequest, a6 as AiTranscribeRequest, a7 as AiTranscript, a8 as AiUnavailableReason, aa as DocBlocksHostAiAPI, ab as DocBlocksHostClipboardAPI, ac as DocBlocksHostExportAPI, ad as DocBlocksHostExternalAPI, ae as DocBlocksHostFfmpegAPI, af as DocBlocksHostFsAPI, ag as DocBlocksHostGitAPI, ah as DocBlocksHostLifecycleAPI, ai as DocBlocksHostMenuAPI, aj as DocBlocksHostShellAPI, ak as DocBlocksHostSpeechAPI, al as DocBlocksHostUpdaterAPI, am as DocBlocksHostWorkspacesAPI, an as ElectronWorkspaceInfo, ao as ExternalBinaryCommitResult, ap as GitBranchInfo, aq as GitCapabilities, ar as GitCloneHandle, as as GitCloneProgress, at as GitError, au as GitErrorCode, av as GitFileAtRevision, aw as GitFileChange, ax as GitFileStatusCode, ay as GitLogEntry, az as GitLogOptions, aA as GitRemoteInfo, aB as GitRepoDetection, aC as GitResult, aD as GitRevision, aE as GitStatus, aF as HOST_PLATFORMS, aG as HOST_SURFACE_KINDS, aI as HostCloseReason, aK as HostExportTargetGrant, aM as HostPlatform, aN as HostPrepareCloseRequest, aO as HostPrepareCloseResult, aP as HostSurfaceKind, aQ as MenuCommand, aR as NO_HOST_CAPABILITIES, aW as SpeechErrorCode, aY as SpeechInstallHandle, b3 as SpeechReadinessState, b5 as SpeechSegment, b7 as SpeechSynthesisHandle, be as SpeechWord, bf as SpeechWordTiming, bg as UpdateCheckResult, bh as UpdateInstallResult, bi as UpdaterStatus, bj as deriveHostCapabilities, bk as isAiImageAspect, bl as isAiImageModelId, bm as knowledgeChatEvent, bn as knowledgeSources, bo as parseAiImageAccess, bp as parseAiImageEvent, bq as parseAiImageInstallEvent, br as parseAiImageModel, bs as parseAiImageModelList, bt as parseAiImagePreferences, bu as parseAiImagePreferencesPatch, bv as parseAiImageRequest, bw as parseAiImageResult, bx as parseAiImageStyle, by as parseAiImageStyleList, bz as parseAiKnowledgeAction, bA as parseAiKnowledgeState, bB as parseHostEnvironment } from '../capabilities-yyRj0hyP.js';
+export { D as DocBlocksHostFsV2API, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, F as FILE_SYSTEM_TRANSFER_LIMITS, H as HostFileSystemReadTransfer, a as HostFileSystemV2OpenRequest, b as HostFileSystemV2Result, c as HostFileSystemV2WatchMessage } from '../filesystem-v2-CYPHqoIw.js';
+import '../types-BIaQ_gYW.js';
+import '../v2-pBdrFAlW.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /**

package/dist/host/index.js

@@ -19,6 +19,8 @@ import {
   isAiImageModelId,
   isElectronHost,
   isSpeechModelId,
+  knowledgeChatEvent,
+  knowledgeSources,
   maybeGetDocBlocksHost,
   parseAiChatEvent,
   parseAiChatKnowledge,
@@ -36,6 +38,8 @@ import {
   parseAiImagePreferencesPatch,
   parseAiImageRequest,
   parseAiImageResult,
+  parseAiImageStyle,
+  parseAiImageStyleList,
   parseAiKnowledgeAction,
   parseAiKnowledgeState,
   parseAiModelDownloadInfo,
@@ -67,7 +71,7 @@ import {
   parseSpeechTranscribeRequest,
   parseSpeechTranscript,
   parseSpeechVoiceInfo
-} from "../chunk-WE5W7BRL.js";
+} from "../chunk-OIBDXKQN.js";
 import {
   EXPORT_TRANSFER_LIMITS,
   HOST_WIRE_LIMITS,
@@ -110,6 +114,8 @@ export {
   isElectronHost,
   isSpeechModelId,
   isTrustedRendererUrl,
+  knowledgeChatEvent,
+  knowledgeSources,
   maybeGetDocBlocksHost,
   parseAiChatEvent,
   parseAiChatKnowledge,
@@ -127,6 +133,8 @@ export {
   parseAiImagePreferencesPatch,
   parseAiImageRequest,
   parseAiImageResult,
+  parseAiImageStyle,
+  parseAiImageStyleList,
   parseAiKnowledgeAction,
   parseAiKnowledgeState,
   parseAiModelDownloadInfo,

package/dist/host/mobile.d.ts

@@ -1,6 +1,6 @@
-import { n as FileSystemProviderCapabilities } from '../v2-DwxWjFC0.js';
+import { n as FileSystemProviderCapabilities } from '../v2-pBdrFAlW.js';
 import { z } from 'zod';
-import { D as DocBlocksHostFsV2API } from '../filesystem-v2-CXdAPR27.js';
+import { D as DocBlocksHostFsV2API } from '../filesystem-v2-CYPHqoIw.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /** Capabilities cross the native boundary and must describe the actual backend. */

package/dist/{host-provider-v2-DEWMPiRD.d.ts → host-provider-v2-C2g9R17A.d.ts}

@@ -1,6 +1,6 @@
-import { D as DocBlocksHostFsV2API } from './filesystem-v2-CXdAPR27.js';
+import { D as DocBlocksHostFsV2API } from './filesystem-v2-CYPHqoIw.js';
 import { a as WorkspacePath } from './workspace-path-CWVrcuPL.js';
-import { o as FileSystemProviderV2, n as FileSystemProviderCapabilities, h as FileSystemEntrySnapshot, j as FileSystemFileRead, E as FileSystemWriteOptions, k as FileSystemFileSnapshot, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, x as FileSystemWatchEvent, B as FileSystemWatchOptions, C as FileSystemWatchSubscription } from './v2-DwxWjFC0.js';
+import { o as FileSystemProviderV2, n as FileSystemProviderCapabilities, h as FileSystemEntrySnapshot, j as FileSystemFileRead, E as FileSystemWriteOptions, k as FileSystemFileSnapshot, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, l as FileSystemMoveOptions, r as FileSystemSnapshot, x as FileSystemWatchEvent, B as FileSystemWatchOptions, C as FileSystemWatchSubscription } from './v2-pBdrFAlW.js';
 
 interface HostFileSystemClientOptions {
     readonly capabilities: FileSystemProviderCapabilities;

package/dist/index.d.ts

@@ -1,18 +1,18 @@
-export { F as FileCommitResult, a as FileEntry, b as FileMeta, c as FileSystemEntry, d as FileSystemProvider, e as FileSystemProviderWithV2, f as FolderEntry, g as getFileSystemProviderV2, h as hasFileSystemProviderV2 } from './types-DLteNrK0.js';
+export { F as FileCommitResult, a as FileEntry, b as FileMeta, c as FileSystemEntry, d as FileSystemProvider, e as FileSystemProviderWithV2, f as FolderEntry, g as getFileSystemProviderV2, h as hasFileSystemProviderV2 } from './types-BIaQ_gYW.js';
 export { DbkWorkspaceAssetLayout, DbkWorkspaceSnapshot, DbkWorkspaceSnapshotOptions, DecodeUtf8TextOptions, FileMediaProviderOptions, FileSystemContentContainer, FileSystemEntryMoveOptions, FileSystemEntryMoveState, FileSystemMoveLocation, FileSystemMoveRecoveryError, FileSystemPartialMoveError, FileSystemPartialMoveState, FileSystemPathPresence, LegacyFilePayloadModel, LegacyFileSystemProviderV2Adapter, LegacyFileSystemProviderV2AdapterOptions, MARKDOWN_FILE_EXTENSIONS, SQUISQ_RUNTIME_DIRECTORY_NAME, createDbkWorkspaceSnapshot, createFileMediaProvider, decodeUtf8Text, describeEntryMove, describePartialMove, documentCompanionPath, ensureWikiArticle, findWikiArticle, isBrowsableWorkspaceEntry, isCompanionDirectoryName, isDiscoverableWorkspaceEntry, isDocumentMediaPath, isFileSystemMoveRecoveryError, isFileSystemMoveStateError, isFileSystemPartialMoveError, isIgnoredWorkspaceEntryName, isMarkdownFileName, moveFileSystemEntry, replaceMemoryWorkspaceFromDbk, resolveDocumentRelativeMediaPath, resolveWikiArticlePath, rewriteCompanionReferences, suggestWikiArticles, wikiArticleExists } from './filesystem/index.js';
 export { W as WORKSPACE_ROOT, a as WorkspacePath, p as parseWorkspacePath, t as tryParseWorkspacePath, w as workspacePathBasename, b as workspacePathContains, c as workspacePathDirname, d as workspacePathJoin, e as workspacePathToLegacy } from './workspace-path-CWVrcuPL.js';
-export { F as FileSystemAtomicity, a as FileSystemCaseSensitivity, b as FileSystemConditionalWriteStrength, c as FileSystemCreateDirectoryMode, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, f as FileSystemDurability, g as FileSystemEntryReadIssue, h as FileSystemEntrySnapshot, i as FileSystemEntryWatchEvent, j as FileSystemFileRead, k as FileSystemFileSnapshot, l as FileSystemMoveOptions, m as FileSystemOverflowWatchEvent, n as FileSystemProviderCapabilities, o as FileSystemProviderV2, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, r as FileSystemSnapshot, s as FileSystemSnapshotEntry, t as FileSystemSnapshotFile, u as FileSystemSymlinkPolicy, v as FileSystemVersion, w as FileSystemWatchErrorListener, x as FileSystemWatchEvent, y as FileSystemWatchEventOrigin, z as FileSystemWatchEventType, A as FileSystemWatchListener, B as FileSystemWatchOptions, C as FileSystemWatchSubscription, D as FileSystemWriteMode, E as FileSystemWriteOptions, G as FsError, H as FsErrorCode, I as FsErrorContext, J as FsOperation, S as SerializedFsError, K as deserializeFsError, L as fsErrorFromUnknown, M as isQuotaExceededError, N as isSerializedFsError, O as mapDomExceptionToFsErrorCode, P as mapNodeErrorCodeToFsErrorCode, Q as parseFileSystemVersion, R as serializeFsError, T as tryParseFileSystemVersion } from './v2-DwxWjFC0.js';
+export { F as FileSystemAtomicity, a as FileSystemCaseSensitivity, b as FileSystemConditionalWriteStrength, c as FileSystemCreateDirectoryMode, d as FileSystemCreateDirectoryOptions, e as FileSystemDirectorySnapshot, f as FileSystemDurability, g as FileSystemEntryReadIssue, h as FileSystemEntrySnapshot, i as FileSystemEntryWatchEvent, j as FileSystemFileRead, k as FileSystemFileSnapshot, l as FileSystemMoveOptions, m as FileSystemOverflowWatchEvent, n as FileSystemProviderCapabilities, o as FileSystemProviderV2, p as FileSystemRemoveOptions, q as FileSystemRemoveResult, r as FileSystemSnapshot, s as FileSystemSnapshotEntry, t as FileSystemSnapshotFile, u as FileSystemSymlinkPolicy, v as FileSystemVersion, w as FileSystemWatchErrorListener, x as FileSystemWatchEvent, y as FileSystemWatchEventOrigin, z as FileSystemWatchEventType, A as FileSystemWatchListener, B as FileSystemWatchOptions, C as FileSystemWatchSubscription, D as FileSystemWriteMode, E as FileSystemWriteOptions, G as FsError, H as FsErrorCode, I as FsErrorContext, J as FsOperation, S as SerializedFsError, K as deserializeFsError, L as fsErrorFromUnknown, M as isQuotaExceededError, N as isSerializedFsError, O as mapDomExceptionToFsErrorCode, P as mapNodeErrorCodeToFsErrorCode, Q as parseFileSystemVersion, R as serializeFsError, T as tryParseFileSystemVersion } from './v2-pBdrFAlW.js';
 export { MemoryFilePayloadKind, MemoryFileSystemProvider, MemoryFileSystemProviderV2, MemoryFileSystemSnapshot, MemoryFileSystemSnapshotFile, MemoryFileSystemV2CompatibilityFile, MemoryFileSystemV2Replacement, MemoryFileSystemV2ReplacementFile, MemoryFileSystemV2State, MemoryFileSystemV2StateFile } from './filesystem/memory.js';
 export { IndexedDBContentContainer, IndexedDBFileSystemProvider, IndexedDBFileSystemProviderV2, IndexedDBFileSystemProviderV2Options, IndexedDBLegacyConflictReason, IndexedDBLegacyConflictResolution, IndexedDBLegacyMigrationConflict, IndexedDBLegacyOpaqueDiscardTarget, IndexedDBLegacyOpaqueRecord, IndexedDBLegacyOpaqueRecordSummary, IndexedDBLegacyOpaqueValue, IndexedDBLegacyRecoveryCandidate, IndexedDBLegacyRecoveryKind } from './filesystem/indexeddb.js';
 export { NativeFileSystemMovePathState, NativeFileSystemMoveRecoveryError, NativeFileSystemMoveRecoveryState, NativeFileSystemProvider, NativeFileSystemProviderV2, isNativeFileSystemSupported, loadDirectoryHandle, openNativeFolder, removeDirectoryHandle, restoreNativeFolder, storeDirectoryHandle } from './filesystem/native.js';
 export { ElectronFileSystemProvider, ElectronFileSystemProviderV2 } from './filesystem/electron.js';
 export { DOCUMENT_RECOVERY_JOURNAL_SCHEMA_VERSION, DOCUMENT_RECOVERY_JOURNAL_STORAGE_KEY, DocumentCommitConflictError, DocumentCommitRequest, DocumentCommitResult, DocumentCommitTarget, DocumentConflictStrategy, DocumentExternalChangeResult, DocumentExternalSnapshot, DocumentExternalVersion, DocumentRecoveryAcknowledgement, DocumentRecoveryJournal, DocumentRecoveryJournalOptions, DocumentRecoveryRecord, DocumentRecoveryStorage, DocumentRecoveryWrite, DocumentRecoveryWriteFailure, DocumentRecoveryWriteResult, DocumentSaveReason, DocumentSession, DocumentSessionConflict, DocumentSessionConflictError, DocumentSessionEditScope, DocumentSessionLifecycle, DocumentSessionOptions, DocumentSessionSnapshot, DocumentSessionStatus, DocumentSessionTransition, FileSystemDocumentTargetOptions, createFileSystemDocumentTarget, getDefaultDocumentRecoveryStorage } from './document/index.js';
-export { D as DEFAULT_WORKSPACE_ID, E as ElectronWorkspaceReconciliation, T as TransientOrigin, W as WorkspaceDescriptor, e as ensureDefaultWorkspace, g as getTransientWorkspace, a as getWorkspace, l as listWorkspaces, p as parsePersistedWorkspaceList, r as reconcileElectronWorkspaceDescriptors, b as registerTransientWorkspace, c as removeWorkspace, s as saveWorkspace, t as touchWorkspace, u as unregisterTransientWorkspace } from './reconcile-electron-BcwJ7z5Z.js';
+export { D as DEFAULT_WORKSPACE_ID, E as ElectronWorkspaceReconciliation, T as TransientOrigin, W as WorkspaceDescriptor, e as ensureDefaultWorkspace, g as getTransientWorkspace, a as getWorkspace, l as listWorkspaces, p as parsePersistedWorkspaceList, r as reconcileElectronWorkspaceDescriptors, b as registerTransientWorkspace, c as removeWorkspace, s as saveWorkspace, t as touchWorkspace, u as unregisterTransientWorkspace } from './reconcile-electron-FvgF5oC7.js';
 export { AI_WIRE_LIMITS, EXPORT_TRANSFER_LIMITS, HOST_WIRE_LIMITS, MAX_HOST_PINNED_DOCUMENTS, SPEECH_WIRE_LIMITS, SUPPORT_EMAIL_ADDRESS, getDocBlocksHost, getHostCapabilities, getHostEnvironment, hasDocBlocksHost, hostSupports, isBoundedBytePayload, isBoundedString, isElectronHost, isSpeechModelId, isTrustedRendererUrl, maybeGetDocBlocksHost, parseAiChatEvent, parseAiChatKnowledge, parseAiChatProgress, parseAiChatRequest, parseAiError, parseAiFactCheck, parseAiFactCheckRequest, parseAiModelDownloadInfo, parseAiModelDownloadInfoList, parseAiModelInfo, parseAiModelInfoList, parseAiModelInstallEvent, parseAiPreferences, parseAiPreferencesPatch, parseAiProgress, parseAiStatus, parseExternalHttpUrl, parseOpenExternalUrl, parseOpenRequest, parsePinnedMenuDocuments, parseSpeechAudioChunk, parseSpeechCatalog, parseSpeechError, parseSpeechInstallEvent, parseSpeechModelInfo, parseSpeechModelKind, parseSpeechNullResult, parseSpeechPreferences, parseSpeechPreferencesPatch, parseSpeechProgress, parseSpeechReadiness, parseSpeechResult, parseSpeechStatus, parseSpeechSynthesisSummary, parseSpeechSynthesizeEvent, parseSpeechSynthesizeRequest, parseSpeechTranscribeRequest, parseSpeechTranscript, parseSpeechVoiceInfo, parseSupportMailtoUrl } from './host/index.js';
 export { SHARED_DOCUMENT_LIMITS, SharedDocumentHashParseResult, SharedDocumentMode, SharedDocumentPayload, createSharedDocumentHash, createSharedDocumentUrl, parseSharedDocumentHash } from './share/index.js';
-export { A as AI_IMAGE_ASPECTS, a as AI_IMAGE_FIT_VERDICTS, b as AI_IMAGE_WIRE_LIMITS, c as AiChatCompletion, d as AiChatEvent, e as AiChatEvidence, f as AiChatHandle, g as AiChatKnowledge, h as AiChatKnowledgeSource, i as AiChatMessage, j as AiChatProgress, k as AiChatPurpose, l as AiChatRequest, m as AiConnectionStep, n as AiEnsureWorkspaceHandle, o as AiError, p as AiErrorCode, q as AiFactCheck, r as AiFactCheckRequest, s as AiFactCheckSentence, t as AiImageAccess, u as AiImageAspect, v as AiImageEvent, w as AiImageHandle, x as AiImageInstallEvent, y as AiImageInstallHandle, z as AiImageModel, B as AiImageModelFit, C as AiImagePhase, D as AiImagePreferences, E as AiImagePreferencesPatch, F as AiImageProgress, G as AiImageRequest, H as AiImageResult, I as AiImageUnavailableReason, J as AiImagesAPI, K as AiKnowledgeAPI, L as AiKnowledgeAction, M as AiKnowledgeCatalog, N as AiKnowledgeState, O as AiModelDownloadInfo, P as AiModelFit, Q as AiModelInfo, R as AiModelInstallEvent, S as AiModelInstallHandle, T as AiPreferences, U as AiPreferencesPatch, V as AiProgress, W as AiProviderInfo, X as AiResponseFormat, Y as AiResult, Z as AiReviewMode, _ as AiSearchHit, $ as AiSearchQuery, a0 as AiSearchResult, a1 as AiSpeechAudio, a2 as AiStatus, a3 as AiSynthesizeRequest, a4 as AiTranscribeRequest, a5 as AiTranscript, a6 as AiUnavailableReason, a7 as DocBlocksHostAPI, a8 as DocBlocksHostAiAPI, a9 as DocBlocksHostClipboardAPI, aa as DocBlocksHostExportAPI, ab as DocBlocksHostExternalAPI, ac as DocBlocksHostFfmpegAPI, ad as DocBlocksHostFsAPI, ae as DocBlocksHostGitAPI, af as DocBlocksHostLifecycleAPI, ag as DocBlocksHostMenuAPI, ah as DocBlocksHostShellAPI, ai as DocBlocksHostSpeechAPI, aj as DocBlocksHostUpdaterAPI, ak as DocBlocksHostWorkspacesAPI, al as ElectronWorkspaceInfo, am as ExternalBinaryCommitResult, an as GitBranchInfo, ao as GitCapabilities, ap as GitCloneHandle, aq as GitCloneProgress, ar as GitError, as as GitErrorCode, at as GitFileAtRevision, au as GitFileChange, av as GitFileStatusCode, aw as GitLogEntry, ax as GitLogOptions, ay as GitRemoteInfo, az as GitRepoDetection, aA as GitResult, aB as GitRevision, aC as GitStatus, aD as HOST_PLATFORMS, aE as HOST_SURFACE_KINDS, aF as HostCapabilities, aG as HostCloseReason, aH as HostEnvironment, aI as HostExportTargetGrant, aJ as HostPinnedDocument, aK as HostPlatform, aL as HostPrepareCloseRequest, aM as HostPrepareCloseResult, aN as HostSurfaceKind, aO as MenuCommand, aP as NO_HOST_CAPABILITIES, aQ as OpenRequest, aR as SpeechAudioChunk, aS as SpeechCatalog, aT as SpeechError, aU as SpeechErrorCode, aV as SpeechInstallEvent, aW as SpeechInstallHandle, aX as SpeechModelInfo, aY as SpeechModelKind, aZ as SpeechPreferences, a_ as SpeechPreferencesPatch, a$ as SpeechProgress, b0 as SpeechReadiness, b1 as SpeechReadinessState, b2 as SpeechResult, b3 as SpeechSegment, b4 as SpeechStatus, b5 as SpeechSynthesisHandle, b6 as SpeechSynthesisSummary, b7 as SpeechSynthesizeEvent, b8 as SpeechSynthesizeRequest, b9 as SpeechTranscribeRequest, ba as SpeechTranscript, bb as SpeechVoiceInfo, bc as SpeechWord, bd as SpeechWordTiming, be as UpdateCheckResult, bf as UpdateInstallResult, bg as UpdaterStatus, bh as deriveHostCapabilities, bi as isAiImageAspect, bj as isAiImageModelId, bk as parseAiImageAccess, bl as parseAiImageEvent, bm as parseAiImageInstallEvent, bn as parseAiImageModel, bo as parseAiImageModelList, bp as parseAiImagePreferences, bq as parseAiImagePreferencesPatch, br as parseAiImageRequest, bs as parseAiImageResult, bt as parseAiKnowledgeAction, bu as parseAiKnowledgeState, bv as parseHostEnvironment } from './capabilities-CH66e2pR.js';
-export { D as DocBlocksHostFsV2API, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, F as FILE_SYSTEM_TRANSFER_LIMITS, H as HostFileSystemReadTransfer, a as HostFileSystemV2OpenRequest, b as HostFileSystemV2Result, c as HostFileSystemV2WatchMessage } from './filesystem-v2-CXdAPR27.js';
+export { A as AI_IMAGE_ASPECTS, a as AI_IMAGE_FIT_VERDICTS, b as AI_IMAGE_WIRE_LIMITS, c as AiChatCompletion, d as AiChatEvent, e as AiChatEvidence, f as AiChatHandle, g as AiChatKnowledge, h as AiChatKnowledgeSource, i as AiChatMessage, j as AiChatProgress, k as AiChatPurpose, l as AiChatRequest, m as AiConnectionStep, n as AiEnsureWorkspaceHandle, o as AiError, p as AiErrorCode, q as AiFactCheck, r as AiFactCheckRequest, s as AiFactCheckSentence, t as AiImageAccess, u as AiImageAspect, v as AiImageEvent, w as AiImageHandle, x as AiImageInstallEvent, y as AiImageInstallHandle, z as AiImageModel, B as AiImageModelFit, C as AiImagePhase, D as AiImagePreferences, E as AiImagePreferencesPatch, F as AiImageProgress, G as AiImageRequest, H as AiImageResult, I as AiImageStyle, J as AiImageUnavailableReason, K as AiImagesAPI, L as AiKnowledgeAPI, M as AiKnowledgeAction, N as AiKnowledgeCatalog, O as AiKnowledgePassage, P as AiKnowledgeState, Q as AiModelDownloadInfo, R as AiModelFit, S as AiModelInfo, T as AiModelInstallEvent, U as AiModelInstallHandle, V as AiPreferences, W as AiPreferencesPatch, X as AiProgress, Y as AiProviderInfo, Z as AiResponseFormat, _ as AiResult, $ as AiReviewMode, a0 as AiSearchHit, a1 as AiSearchQuery, a2 as AiSearchResult, a3 as AiSpeechAudio, a4 as AiStatus, a5 as AiSynthesizeRequest, a6 as AiTranscribeRequest, a7 as AiTranscript, a8 as AiUnavailableReason, a9 as DocBlocksHostAPI, aa as DocBlocksHostAiAPI, ab as DocBlocksHostClipboardAPI, ac as DocBlocksHostExportAPI, ad as DocBlocksHostExternalAPI, ae as DocBlocksHostFfmpegAPI, af as DocBlocksHostFsAPI, ag as DocBlocksHostGitAPI, ah as DocBlocksHostLifecycleAPI, ai as DocBlocksHostMenuAPI, aj as DocBlocksHostShellAPI, ak as DocBlocksHostSpeechAPI, al as DocBlocksHostUpdaterAPI, am as DocBlocksHostWorkspacesAPI, an as ElectronWorkspaceInfo, ao as ExternalBinaryCommitResult, ap as GitBranchInfo, aq as GitCapabilities, ar as GitCloneHandle, as as GitCloneProgress, at as GitError, au as GitErrorCode, av as GitFileAtRevision, aw as GitFileChange, ax as GitFileStatusCode, ay as GitLogEntry, az as GitLogOptions, aA as GitRemoteInfo, aB as GitRepoDetection, aC as GitResult, aD as GitRevision, aE as GitStatus, aF as HOST_PLATFORMS, aG as HOST_SURFACE_KINDS, aH as HostCapabilities, aI as HostCloseReason, aJ as HostEnvironment, aK as HostExportTargetGrant, aL as HostPinnedDocument, aM as HostPlatform, aN as HostPrepareCloseRequest, aO as HostPrepareCloseResult, aP as HostSurfaceKind, aQ as MenuCommand, aR as NO_HOST_CAPABILITIES, aS as OpenRequest, aT as SpeechAudioChunk, aU as SpeechCatalog, aV as SpeechError, aW as SpeechErrorCode, aX as SpeechInstallEvent, aY as SpeechInstallHandle, aZ as SpeechModelInfo, a_ as SpeechModelKind, a$ as SpeechPreferences, b0 as SpeechPreferencesPatch, b1 as SpeechProgress, b2 as SpeechReadiness, b3 as SpeechReadinessState, b4 as SpeechResult, b5 as SpeechSegment, b6 as SpeechStatus, b7 as SpeechSynthesisHandle, b8 as SpeechSynthesisSummary, b9 as SpeechSynthesizeEvent, ba as SpeechSynthesizeRequest, bb as SpeechTranscribeRequest, bc as SpeechTranscript, bd as SpeechVoiceInfo, be as SpeechWord, bf as SpeechWordTiming, bg as UpdateCheckResult, bh as UpdateInstallResult, bi as UpdaterStatus, bj as deriveHostCapabilities, bk as isAiImageAspect, bl as isAiImageModelId, bm as knowledgeChatEvent, bn as knowledgeSources, bo as parseAiImageAccess, bp as parseAiImageEvent, bq as parseAiImageInstallEvent, br as parseAiImageModel, bs as parseAiImageModelList, bt as parseAiImagePreferences, bu as parseAiImagePreferencesPatch, bv as parseAiImageRequest, bw as parseAiImageResult, bx as parseAiImageStyle, by as parseAiImageStyleList, bz as parseAiKnowledgeAction, bA as parseAiKnowledgeState, bB as parseHostEnvironment } from './capabilities-yyRj0hyP.js';
+export { D as DocBlocksHostFsV2API, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, F as FILE_SYSTEM_TRANSFER_LIMITS, H as HostFileSystemReadTransfer, a as HostFileSystemV2OpenRequest, b as HostFileSystemV2Result, c as HostFileSystemV2WatchMessage } from './filesystem-v2-CYPHqoIw.js';
 import '@bendyline/squisq/markdown';
 import '@bendyline/squisq/storage';
 import '@bendyline/squisq/schemas';
-import './host-provider-v2-DEWMPiRD.js';
+import './host-provider-v2-C2g9R17A.js';

package/dist/index.js

@@ -70,8 +70,8 @@ import "./chunk-3GSMJ4MQ.js";
 import {
   ElectronFileSystemProvider,
   ElectronFileSystemProviderV2
-} from "./chunk-LP6JHGBP.js";
-import "./chunk-ZBRXXOW5.js";
+} from "./chunk-C6J65F5C.js";
+import "./chunk-P5VP6XMH.js";
 import {
   AI_IMAGE_ASPECTS,
   AI_IMAGE_FIT_VERDICTS,
@@ -93,6 +93,8 @@ import {
   isAiImageModelId,
   isElectronHost,
   isSpeechModelId,
+  knowledgeChatEvent,
+  knowledgeSources,
   maybeGetDocBlocksHost,
   parseAiChatEvent,
   parseAiChatKnowledge,
@@ -110,6 +112,8 @@ import {
   parseAiImagePreferencesPatch,
   parseAiImageRequest,
   parseAiImageResult,
+  parseAiImageStyle,
+  parseAiImageStyleList,
   parseAiKnowledgeAction,
   parseAiKnowledgeState,
   parseAiModelDownloadInfo,
@@ -141,7 +145,7 @@ import {
   parseSpeechTranscribeRequest,
   parseSpeechTranscript,
   parseSpeechVoiceInfo
-} from "./chunk-WE5W7BRL.js";
+} from "./chunk-OIBDXKQN.js";
 import "./chunk-245W57QP.js";
 import {
   EXPORT_TRANSFER_LIMITS,
@@ -292,6 +296,8 @@ export {
   isSerializedFsError,
   isSpeechModelId,
   isTrustedRendererUrl,
+  knowledgeChatEvent,
+  knowledgeSources,
   listWorkspaces,
   loadDirectoryHandle,
   mapDomExceptionToFsErrorCode,
@@ -315,6 +321,8 @@ export {
   parseAiImagePreferencesPatch,
   parseAiImageRequest,
   parseAiImageResult,
+  parseAiImageStyle,
+  parseAiImageStyleList,
   parseAiKnowledgeAction,
   parseAiKnowledgeState,
   parseAiModelDownloadInfo,

package/dist/mcp/zod.js

@@ -596,16 +596,18 @@ var DOCBLOCKS_MCP_TOOL_OUTPUT_SCHEMAS = Object.freeze({
 });
 var materializationOptionsSchema = z.discriminatedUnion("ifExists", [
   z.object({
-    rootId: idSchema,
-    path: workspacePathSchema,
-    ifExists: z.literal("error"),
-    expectedSha256: z.null().optional().default(null)
+    rootId: idSchema.describe("A write root id from list_roots."),
+    path: workspacePathSchema.describe("Path below that root."),
+    ifExists: z.literal("error").describe("Create the file; fails if one is already there."),
+    expectedSha256: z.null().optional().default(null).describe("Omit or null when creating a file.")
   }).strict(),
   z.object({
-    rootId: idSchema,
-    path: workspacePathSchema,
-    ifExists: z.literal("replace"),
-    expectedSha256: z.string().regex(/^[a-f0-9]{64}$/u)
+    rootId: idSchema.describe("A write root id from list_roots."),
+    path: workspacePathSchema.describe("Path below that root."),
+    ifExists: z.literal("replace").describe("Replace the file already at this path; fails if nothing is there."),
+    expectedSha256: z.string().regex(/^[a-f0-9]{64}$/u).describe(
+      "SHA-256 of the file now at this path (the sha256 returned when it was saved), not of the artifact being saved."
+    )
   }).strict()
 ]);
 function addExactWireIssue(parsed, context) {

package/dist/{reconcile-electron-BcwJ7z5Z.d.ts → reconcile-electron-FvgF5oC7.d.ts}

@@ -1,5 +1,5 @@
-import { d as FileSystemProvider } from './types-DLteNrK0.js';
-import { al as ElectronWorkspaceInfo, aH as HostEnvironment } from './capabilities-CH66e2pR.js';
+import { d as FileSystemProvider } from './types-BIaQ_gYW.js';
+import { an as ElectronWorkspaceInfo, aJ as HostEnvironment } from './capabilities-yyRj0hyP.js';
 
 /**
  * Origin of a transient workspace — records where its contents came from and

package/dist/{types-DLteNrK0.d.ts → types-BIaQ_gYW.d.ts}

@@ -1,4 +1,4 @@
-import { g as FileSystemEntryReadIssue, o as FileSystemProviderV2 } from './v2-DwxWjFC0.js';
+import { g as FileSystemEntryReadIssue, o as FileSystemProviderV2 } from './v2-pBdrFAlW.js';
 
 /**
  * FileSystemProvider — abstract interface for a virtual filesystem.

package/dist/{v2-DwxWjFC0.d.ts → v2-pBdrFAlW.d.ts}

@@ -106,6 +106,14 @@ interface FileSystemFileSnapshot extends FileSystemEntrySnapshotBase {
      * then reflects metadata only; callers needing content must read the file.
      */
     readonly readIssue?: FileSystemEntryReadIssue;
+    /**
+     * Present when a cloud sync client (OneDrive, iCloud Drive) keeps the bytes
+     * online until something reads them. Reading downloads the whole file
+     * first, so background work should leave it alone. A listing or stat does
+     * not hash it, so its version may reflect metadata only; a content read
+     * still returns a content-derived version.
+     */
+    readonly onlineOnly?: true;
 }
 interface FileSystemDirectorySnapshot extends FileSystemEntrySnapshotBase {
     readonly kind: 'directory';

package/dist/workspace/index.d.ts

@@ -1,10 +1,10 @@
-export { D as DEFAULT_WORKSPACE_ID, E as ElectronWorkspaceReconciliation, T as TransientOrigin, W as WorkspaceDescriptor, e as ensureDefaultWorkspace, g as getTransientWorkspace, a as getWorkspace, l as listWorkspaces, p as parsePersistedWorkspaceList, r as reconcileElectronWorkspaceDescriptors, b as registerTransientWorkspace, c as removeWorkspace, s as saveWorkspace, t as touchWorkspace, u as unregisterTransientWorkspace } from '../reconcile-electron-BcwJ7z5Z.js';
+export { D as DEFAULT_WORKSPACE_ID, E as ElectronWorkspaceReconciliation, T as TransientOrigin, W as WorkspaceDescriptor, e as ensureDefaultWorkspace, g as getTransientWorkspace, a as getWorkspace, l as listWorkspaces, p as parsePersistedWorkspaceList, r as reconcileElectronWorkspaceDescriptors, b as registerTransientWorkspace, c as removeWorkspace, s as saveWorkspace, t as touchWorkspace, u as unregisterTransientWorkspace } from '../reconcile-electron-FvgF5oC7.js';
 import { ContentContainer } from '@bendyline/squisq/storage';
-import { o as FileSystemProviderV2 } from '../v2-DwxWjFC0.js';
+import { o as FileSystemProviderV2 } from '../v2-pBdrFAlW.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
-import '../types-DLteNrK0.js';
-import '../capabilities-CH66e2pR.js';
-import '../filesystem-v2-CXdAPR27.js';
+import '../types-BIaQ_gYW.js';
+import '../capabilities-yyRj0hyP.js';
+import '../filesystem-v2-CYPHqoIw.js';
 
 declare const WORKSPACE_BACKUP_MANIFEST = "docblocks-backup.json";
 declare const WORKSPACE_BACKUP_LIMITS: Readonly<{

package/dist/workspace-index/index.d.ts

@@ -1,4 +1,4 @@
-import { o as FileSystemProviderV2, n as FileSystemProviderCapabilities } from '../v2-DwxWjFC0.js';
+import { o as FileSystemProviderV2, n as FileSystemProviderCapabilities } from '../v2-pBdrFAlW.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 import { e as CatalogDocumentFormat, g as CatalogOutlineEntry } from '../catalog-flfSruLW.js';
 import '@bendyline/squisq/markdown';
@@ -74,7 +74,9 @@ interface WorkspaceIndexFile {
     readonly kind: WorkspaceIndexFileKind;
 }
 type IndexedDocumentContent = 'full' | 'lines' | 'name-only';
-type IndexedDocumentIssue = 'pending' | 'too-large' | 'parse-limit' | 'not-utf8' | 'read-error' | 'no-companion' | 'over-budget';
+type IndexedDocumentIssue = 'pending' | 'too-large' | 'parse-limit' | 'not-utf8' | 'read-error' | 'no-companion' | 'over-budget'
+/** Kept online by a cloud sync client; reading it would download it. */
+ | 'online-only';
 interface IndexedDocument {
     /** Navigation identity: the rendered file for outside-in documents. */
     readonly path: WorkspacePath;

package/dist/workspace-index/index.js

@@ -944,6 +944,7 @@ var WorkspaceIndexImpl = class {
       },
       entry.version,
       entry.kind === "file" ? entry.size : 0,
+      entry.kind === "file" && entry.onlineOnly === true,
       null,
       previous
     );
@@ -958,11 +959,12 @@ var WorkspaceIndexImpl = class {
       },
       source?.version ?? null,
       source?.kind === "file" ? source.size : 0,
+      source?.kind === "file" && source.onlineOnly === true,
       layout,
       previous
     );
   }
-  documentState(identity, sourceVersion, sourceSize, layout, previous) {
+  documentState(identity, sourceVersion, sourceSize, sourceOnlineOnly, layout, previous) {
     const state = {
       identity,
       sourceVersion,
@@ -981,6 +983,8 @@ var WorkspaceIndexImpl = class {
         text: previous.analysis.text
       };
       state.analysisVersion = previous.analysisVersion;
+    } else if (sourceOnlineOnly) {
+      state.analysis = nameOnlyDocument(identity, "online-only");
     }
     return state;
   }

package/dist/workspace-settings/index.d.ts

@@ -3,7 +3,7 @@ export { b as CATALOG_JSON_CONTENT_MODES, c as CATALOG_SORT_ORDERS, d as Catalog
 import { C as CatalogEntry, W as WorkspaceCatalog } from '../catalog-flfSruLW.js';
 export { a as CATALOG_FORMAT_VERSION, b as CATALOG_GENERATOR, c as CATALOG_LIMITS, d as CatalogDateRecord, e as CatalogDocumentFormat, f as CatalogEntryHints, g as CatalogOutlineEntry, h as CatalogSource, O as OUTSIDE_IN_FORMAT_IDS, i as OutsideInFormatId, j as OutsideInLayout, k as buildCatalogMarkdownDocument, l as catalogEntryForUnreadable, m as catalogEntryFromDocument, n as catalogEntryFromMarkdown, o as chooseOutsideInMarkdownPath, p as createWorkspaceCatalog, q as isGeneratedCatalogHtml, r as isGeneratedCatalogJson, s as readCatalogDateHistory, t as readCatalogHtmlDigest, u as relativeCatalogLink, v as relocateOutsideInLayout, w as resolveOutsideInLayout, x as serializeCatalogJson, y as sortCatalogEntries, z as stampCatalogDates, A as stampCatalogHtml } from '../catalog-flfSruLW.js';
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
-import { v as FileSystemVersion, o as FileSystemProviderV2 } from '../v2-DwxWjFC0.js';
+import { v as FileSystemVersion, o as FileSystemProviderV2 } from '../v2-pBdrFAlW.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks",
-  "version": "2.7.12",
+  "version": "2.7.13",
   "description": "Core data structures and filesystem abstractions for DocBlocks",
   "license": "MIT",
   "author": "Bendyline",
@@ -126,7 +126,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.13.10",
+    "@bendyline/squisq": "2.13.12",
     "zod": "3.25.76"
   }
 }