@bendyline/docblocks 2.7.6 → 2.7.8

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.6 | 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.6
 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.6
 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.6
 Source files: node_modules/@bendyline/squisq/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq

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

@@ -1,6 +1,177 @@
 import { F as FileCommitResult, c as FileSystemEntry, b as FileMeta } from './types-DLteNrK0.js';
 import { D as DocBlocksHostFsV2API } from './filesystem-v2-CXdAPR27.js';
 
+/**
+ * On-device image generation.
+ *
+ * Renders run on the provider's local image engine. They take seconds on a
+ * fast graphics card and minutes for the largest models, so a request streams
+ * phased progress and can be cancelled; cancelling stops the engine, and the
+ * next render reloads its weights. Image models are listed apart from chat
+ * models and never appear in a chat model picker.
+ */
+/** Shapes a person can ask for. The provider picks pixels inside the model's range. */
+declare const AI_IMAGE_ASPECTS: readonly ["1:1", "4:3", "3:4", "16:9", "9:16"];
+type AiImageAspect = (typeof AI_IMAGE_ASPECTS)[number];
+type AiImageUnavailableReason = 
+/** AI is off, or the provider is not connected. */
+'not-connected'
+/** The provider has no image engine that can run on this computer. */
+ | 'no-engine'
+/** The graphics driver lacks what the engine needs (Vulkan on Windows). */
+ | 'graphics-driver'
+/** This build of the app cannot run image generation. */
+ | 'platform';
+/**
+ * Whether image generation can be offered now.
+ *
+ * `needs-approval` means the provider serves images but this app has not been
+ * allowed to use them; ask with `requestAccess()` from an explicit gesture.
+ * While that request waits, the state is `awaiting-approval` with the code the
+ * person types into the provider. Chat keeps working throughout.
+ */
+type AiImageAccess = {
+    readonly kind: 'ready';
+} | {
+    readonly kind: 'needs-approval';
+} | {
+    readonly kind: 'awaiting-approval';
+    readonly verificationCode: string | null;
+} | {
+    readonly kind: 'provider-outdated';
+} | {
+    readonly kind: 'unavailable';
+    readonly reason: AiImageUnavailableReason;
+    readonly message: string;
+};
+declare const AI_IMAGE_FIT_VERDICTS: readonly ["fits", "tight", "over-limit", "may-not-run", "wont-run"];
+interface AiImageModelFit {
+    /** `wont-run` models refuse to install on this computer. */
+    readonly verdict: (typeof AI_IMAGE_FIT_VERDICTS)[number];
+    /** One sentence a person can act on; empty for a plain fit. */
+    readonly reason: string;
+}
+interface AiImageModel {
+    /** Opaque to the renderer. */
+    readonly id: string;
+    readonly label: string;
+    readonly description: string | null;
+    readonly state: 'installed' | 'download-required' | 'downloading';
+    readonly downloadBytes: number | null;
+    /** Installed in a store the provider reads but this app does not own; not removable here. */
+    readonly shared: boolean;
+    readonly license: 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. */
+    readonly rendersText: boolean;
+    /** How the model reads prompts. */
+    readonly promptStyle: 'sentences' | 'tags' | null;
+    /** `workstation` marks a model for a machine with a great deal of memory. */
+    readonly hardwareTier: 'low' | 'mid' | 'high' | 'workstation' | null;
+    readonly minRamGb: number | null;
+    readonly fit: AiImageModelFit | null;
+}
+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;
+}
+type AiImagePreferencesPatch = Partial<AiImagePreferences>;
+interface AiImageRequest {
+    readonly prompt: string;
+    readonly negativePrompt?: string;
+    /** An id from `models()`; the preferred model when absent. */
+    readonly model?: string;
+    readonly aspect?: AiImageAspect;
+    readonly seed?: number;
+}
+interface AiImageResult {
+    readonly mimeType: 'image/png';
+    readonly data: ArrayBuffer;
+    readonly width: number;
+    readonly height: number;
+    readonly seed: number;
+    readonly model: string;
+    readonly durationMs: number;
+}
+/**
+ * `loading-model` covers the first render after the engine starts, which
+ * loads the weights; `decoding` turns the result into pixels in tiles.
+ */
+type AiImagePhase = 'queued' | 'loading-model' | 'sampling' | 'decoding';
+interface AiImageProgress {
+    readonly phase: AiImagePhase;
+    /** Units done in this phase; 0 while queued or when the engine reports none. */
+    readonly step: number;
+    readonly totalSteps: number;
+    readonly secondsPerStep: number | null;
+}
+type AiImageEvent = {
+    readonly kind: 'progress';
+    readonly progress: AiImageProgress;
+} | {
+    readonly kind: 'done';
+    readonly image: AiImageResult;
+} | {
+    readonly kind: 'error';
+    readonly error: AiError;
+};
+interface AiImageHandle {
+    readonly done: Promise<AiResult<AiImageResult>>;
+    /** Stop the render. The engine stops, so the next render reloads its weights. */
+    cancel(): void;
+}
+type AiImageInstallEvent = {
+    readonly kind: 'progress';
+    readonly progress: AiProgress;
+} | {
+    readonly kind: 'done';
+    readonly model: AiImageModel;
+} | {
+    readonly kind: 'error';
+    readonly error: AiError;
+};
+interface AiImageInstallHandle {
+    readonly done: Promise<AiResult<AiImageModel>>;
+    /** Stop the download. Starting it again resumes. */
+    cancel(): void;
+}
+interface AiImagesAPI {
+    access(): Promise<AiImageAccess>;
+    onAccess(listener: (access: AiImageAccess) => void): () => void;
+    /** Ask the provider to allow image generation. Only from an explicit gesture. */
+    requestAccess(): Promise<AiResult<AiImageAccess>>;
+    models(): Promise<AiResult<readonly AiImageModel[]>>;
+    /** Start a model download from an explicit gesture. */
+    installModel(id: string, onProgress?: (progress: AiProgress) => void): AiImageInstallHandle;
+    removeModel(id: string): Promise<AiResult<null>>;
+    getPreferences(): Promise<AiImagePreferences>;
+    setPreferences(patch: AiImagePreferencesPatch): Promise<AiImagePreferences>;
+    generate(request: AiImageRequest, onEvent: (event: AiImageEvent) => void): AiImageHandle;
+}
+declare const AI_IMAGE_WIRE_LIMITS: Readonly<{
+    promptCharacters: 4000;
+    /** A PNG at the largest size a model renders. */
+    imageBytes: number;
+    models: 256;
+    pixels: 16384;
+    verificationCodeCharacters: 16;
+}>;
+declare function isAiImageModelId(value: unknown): value is string;
+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 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;
+
 /** Provider-neutral catalog management. IDs never authorize filesystem access. */
 interface AiKnowledgeCatalog {
     readonly id: string;
@@ -216,6 +387,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 +417,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 +439,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 +473,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[];
     /**
@@ -350,17 +549,6 @@ interface AiSearchResult {
     readonly hits: readonly AiSearchHit[];
     readonly truncated: boolean;
 }
-interface AiImageRequest {
-    readonly prompt: string;
-    readonly width?: number;
-    readonly height?: number;
-}
-interface AiImageResult {
-    readonly mimeType: 'image/png';
-    readonly data: ArrayBuffer;
-    readonly width: number;
-    readonly height: number;
-}
 interface AiTranscribeRequest {
     readonly audio: ArrayBuffer;
     readonly mimeType: string;
@@ -393,6 +581,8 @@ interface AiSpeechAudio {
 interface DocBlocksHostAiAPI {
     /** Optional catalog browsing, downloads, and retrieval model setup. */
     readonly knowledge?: AiKnowledgeAPI;
+    /** Optional on-device image generation and its models. */
+    readonly images?: AiImagesAPI;
     /** Whether the host's user-installed companion provider is present. */
     providerInstalled(): Promise<boolean>;
     status(): Promise<AiStatus>;
@@ -424,7 +614,6 @@ interface DocBlocksHostAiAPI {
     chat(request: AiChatRequest, onEvent: (event: AiChatEvent) => void): AiChatHandle;
     ensureWorkspace?(workspaceId: string, onProgress?: (progress: AiProgress) => void): AiEnsureWorkspaceHandle;
     search?(workspaceId: string, query: AiSearchQuery): Promise<AiResult<AiSearchResult>>;
-    generateImage?(request: AiImageRequest): Promise<AiResult<AiImageResult>>;
     /** @deprecated Speech lives on `DocBlocksHostAPI.speech`; no host implements this. */
     transcribe?(request: AiTranscribeRequest): Promise<AiResult<AiTranscript>>;
     /** @deprecated Speech lives on `DocBlocksHostAPI.speech`; no host implements this. */
@@ -785,12 +974,25 @@ interface SpeechTranscribeRequest {
      */
     readonly prompt?: string;
     readonly language?: string;
+    /**
+     * Return timed `segments` with word times (Whisper's verbose output), for
+     * timing a narration from its audio. Dictation leaves it off.
+     */
+    readonly timestamps?: boolean;
+}
+/** A recognized word. Seconds from the start of the take. */
+interface SpeechWord {
+    readonly start: number;
+    readonly end: number;
+    readonly text: string;
 }
 interface SpeechSegment {
     /** Seconds from the start of the take. */
     readonly start: number;
     readonly end: number;
     readonly text: string;
+    /** Present when the request asked for `timestamps`. */
+    readonly words?: readonly SpeechWord[];
 }
 interface SpeechTranscript {
     /** Trimmed; empty when the take held no speech. */
@@ -1123,6 +1325,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 +1487,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 +1552,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 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 };

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-CI3DHDPG.js}

@@ -1,6 +1,6 @@
 import {
   guessMimeType
-} from "./chunk-Q3OFZWJS.js";
+} from "./chunk-3HUKGWDK.js";
 import {
   bytesEqual,
   compareSnapshotsByName,
@@ -17,7 +17,7 @@ import {
   createFileSystemDocumentTarget,
   describeEntryMove,
   describePartialMove
-} from "./chunk-FIEMYP2N.js";
+} from "./chunk-D7VUEVAX.js";
 import {
   getFileSystemProviderV2
 } from "./chunk-XAMILHQP.js";
@@ -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-FIEMYP2N.js → chunk-D7VUEVAX.js}

@@ -181,13 +181,15 @@ var DocumentSession = class {
     if (content === this.content) return this.revision;
     this.content = content;
     this.revision += 1;
+    this.localEditedAt = Date.now();
     this.error = null;
     this.autoSaveRetryAttempt = 0;
     if (this.conflict) {
       this.conflict = {
         ...this.conflict,
         localContent: content,
-        localRevision: this.revision
+        localRevision: this.revision,
+        localEditedAt: this.localEditedAt
       };
     }
     this.writeRecoverySnapshot();
@@ -377,6 +379,7 @@ var DocumentSession = class {
         targetKey: change.targetKey,
         localContent: this.content,
         localRevision: this.revision,
+        localEditedAt: this.localEditedAt,
         externalContent: change.content,
         externalVersion
       };
@@ -399,6 +402,7 @@ var DocumentSession = class {
       targetKey: change.targetKey,
       localContent: this.content,
       localRevision: this.revision,
+      localEditedAt: this.localEditedAt,
       externalContent: change.content,
       externalVersion: change.version ?? null
     };
@@ -411,6 +415,7 @@ var DocumentSession = class {
     this.clearAutoSaveTimer();
     this.autoSaveRetryAttempt = 0;
     this.content = content;
+    this.localEditedAt = void 0;
     this.revision += 1;
     this.persistedRevision = this.revision;
     this.persistedContent = content;
@@ -433,6 +438,7 @@ var DocumentSession = class {
         this.discardRecoverySnapshot();
         this.generation += 1;
         this.revision += 1;
+        this.localEditedAt = void 0;
         this.conflict = null;
         this.error = null;
         this.haltDrain = false;
@@ -518,6 +524,7 @@ var DocumentSession = class {
       this.externalSequence = -1;
       this.target = next.target;
       this.content = next.content;
+      this.localEditedAt = void 0;
       this.revision += 1;
       this.persistedRevision = this.revision;
       this.persistedContent = next.target ? next.content : null;
@@ -607,6 +614,7 @@ var DocumentSession = class {
             targetKey: target.key,
             localContent: this.content,
             localRevision: this.revision,
+            localEditedAt: this.localEditedAt,
             externalContent: error.externalContent,
             externalVersion: error.externalVersion
           };
@@ -715,6 +723,7 @@ var DocumentSession = class {
     this.externalSequence = -1;
     this.target = null;
     this.persistedContent = null;
+    this.localEditedAt = void 0;
     this.savingRevision = null;
     this.savingContent = null;
     this.error = null;

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-56QRV45P.js → chunk-LP6JHGBP.js}

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