@bendyline/docblocks 2.4.0 → 2.5.0

package/dist/{chunk-LMMOFRGQ.js → chunk-FBCGLK6N.js}

@@ -1,5 +1,7 @@
 // src/share/index.ts
 var SHARED_DOCUMENT_LIMITS = Object.freeze({
+  /** Conservative ceiling for a locally rendered, medium-correction QR code. */
+  qrUrlCharacters: 2048,
   /** A conservative interoperability threshold, not a universal browser limit. */
   portableUrlCharacters: 4096,
   /** Hard cap applied before a hash is copied or decoded. */

package/dist/{chunk-6L3JRDE7.js → chunk-KLQKU74Q.js}

@@ -273,6 +273,11 @@ var DocumentSession = class {
       if (this.conflict.localContent === this.content && this.conflict.localRevision === this.revision && this.conflict.externalContent === change.content && this.conflict.externalVersion === externalVersion) {
         return "ignored";
       }
+      const localBranchIsStillClean = this.savingRevision === null && this.lifecycle === "open" && this.persistedRevision === this.revision && this.persistedContent === this.content && this.conflict.localRevision === this.revision && this.conflict.localContent === this.content;
+      if (localBranchIsStillClean && change.content !== null) {
+        this.adoptExternalContent(change.content);
+        return "applied";
+      }
       this.clearAutoSaveTimer();
       this.haltDrain = true;
       this.conflict = {
@@ -292,13 +297,7 @@ var DocumentSession = class {
     }
     const isClean = this.persistedRevision === this.revision && this.savingRevision === null && this.error === null && this.conflict === null;
     if (isClean && change.content !== null) {
-      this.content = change.content;
-      this.revision += 1;
-      this.persistedRevision = this.revision;
-      this.persistedContent = change.content;
-      this.generation += 1;
-      this.discardRecoverySnapshot();
-      this.emit();
+      this.adoptExternalContent(change.content);
       return "applied";
     }
     this.clearAutoSaveTimer();
@@ -315,6 +314,20 @@ var DocumentSession = class {
     this.emit();
     return "conflict";
   }
+  adoptExternalContent(content) {
+    this.clearAutoSaveTimer();
+    this.autoSaveRetryAttempt = 0;
+    this.content = content;
+    this.revision += 1;
+    this.persistedRevision = this.revision;
+    this.persistedContent = content;
+    this.generation += 1;
+    this.haltDrain = false;
+    this.error = null;
+    this.conflict = null;
+    this.discardRecoverySnapshot();
+    this.emit();
+  }
   resolveConflict(strategy) {
     return this.enqueueOperation(async () => {
       if (!this.conflict) return this.snapshot;

package/dist/{chunk-EG3WGSZH.js → chunk-YWYT6K6J.js}

@@ -102,6 +102,19 @@ function parseArtifactRef(value) {
   };
 }
 function parseDocumentSource(value) {
+  if (typeof value === "string") {
+    const text = value.trim();
+    if (text.startsWith("{")) {
+      try {
+        return parseDocumentSource(JSON.parse(text));
+      } catch {
+        return null;
+      }
+    }
+    if (isArtifactUri(text)) return { kind: "artifact", uri: text };
+    const parsedPath = parseNonRootWorkspacePath(text);
+    return parsedPath === null ? null : { kind: "file", rootId: null, path: parsedPath, format: null };
+  }
   if (!isRecord(value) || typeof value.kind !== "string") return null;
   switch (value.kind) {
     case "markdown": {
@@ -116,13 +129,14 @@ function parseDocumentSource(value) {
       return { kind: "markdown", markdown, name };
     }
     case "file": {
-      if (!hasExactKeys(value, ["kind", "rootId", "path"]) && !hasExactKeys(value, ["kind", "rootId", "path", "format"])) {
+      if (!hasExactKeys(value, ["kind", "rootId", "path"]) && !hasExactKeys(value, ["kind", "rootId", "path", "format"]) && !hasExactKeys(value, ["kind", "path"]) && !hasExactKeys(value, ["kind", "path", "format"])) {
         return null;
       }
-      const { rootId, path } = value;
+      const path = value.path;
+      const rootId = Object.prototype.hasOwnProperty.call(value, "rootId") ? value.rootId : null;
       const format = Object.prototype.hasOwnProperty.call(value, "format") ? value.format : null;
       const parsedPath = parseNonRootWorkspacePath(path);
-      if (!isIdentifier(rootId) || parsedPath === null || !(format === null || isFormat(format))) {
+      if (!(rootId === null || isIdentifier(rootId)) || parsedPath === null || !(format === null || isFormat(format))) {
         return null;
       }
       return { kind: "file", rootId, path: parsedPath, format };

package/dist/document/index.d.ts

@@ -310,6 +310,7 @@ declare class DocumentSession {
      * adopt it. Dirty or saving sessions preserve local text and enter conflict.
      */
     observeExternal(change: DocumentExternalSnapshot): DocumentExternalChangeResult;
+    private adoptExternalContent;
     resolveConflict(strategy: DocumentConflictStrategy): Promise<DocumentSessionSnapshot>;
     /**
      * Freeze edits and flush through the latest revision. A successful call

package/dist/document/index.js

@@ -7,7 +7,7 @@ import {
   DocumentSessionConflictError,
   createFileSystemDocumentTarget,
   getDefaultDocumentRecoveryStorage
-} from "../chunk-6L3JRDE7.js";
+} from "../chunk-KLQKU74Q.js";
 import "../chunk-QI6YKTQV.js";
 import "../chunk-M5ZNQGR5.js";
 import "../chunk-AYWKIZLD.js";

package/dist/filesystem/electron.d.ts

@@ -1,7 +1,7 @@
 import { s as FileSystemProviderV2, r as FileSystemProviderCapabilities, k as FileSystemEntrySnapshot, m as FileSystemFileRead, K as FileSystemWriteOptions, n as FileSystemFileSnapshot, g as FileSystemCreateDirectoryOptions, h as FileSystemDirectorySnapshot, u as FileSystemRemoveOptions, v as FileSystemRemoveResult, o as FileSystemMoveOptions, w as FileSystemSnapshot, C as FileSystemWatchEvent, H as FileSystemWatchOptions, I as FileSystemWatchSubscription, q as FileSystemProvider, F as FileCommitResult, j as FileSystemEntry, b as FileMeta } from '../types-Bb3yccTH.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 export { isElectronHost } from '../host/index.js';
-import '../types-D2CRLJB6.js';
+import '../types-ZU8tTM7T.js';
 
 /** Pure renderer-side client for the typed Electron filesystem v2 transport. */
 declare class ElectronFileSystemProviderV2 implements FileSystemProviderV2 {

package/dist/filesystem/index.d.ts

@@ -10,7 +10,7 @@ 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 '../types-D2CRLJB6.js';
+import '../types-ZU8tTM7T.js';
 
 interface DecodeUtf8TextOptions {
     /** User-facing description of the payload being decoded. */

package/dist/host/index.d.ts

@@ -1,5 +1,5 @@
-import { Q as OpenRequest, M as HostPinnedDocument, D as DocBlocksHostAPI } from '../types-D2CRLJB6.js';
-export { a as DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, F as HostEnvironment, I as HostExportTargetGrant, J as HostFileSystemV2OpenRequest, K as HostFileSystemV2Result, L as HostFileSystemV2WatchMessage, N as HostPrepareCloseRequest, O as HostPrepareCloseResult, P as MenuCommand, U as UpdateCheckResult, R as UpdateInstallResult, S as UpdaterStatus } from '../types-D2CRLJB6.js';
+import { Q as OpenRequest, M as HostPinnedDocument, D as DocBlocksHostAPI } from '../types-ZU8tTM7T.js';
+export { a as DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, F as HostEnvironment, I as HostExportTargetGrant, J as HostFileSystemV2OpenRequest, K as HostFileSystemV2Result, L as HostFileSystemV2WatchMessage, N as HostPrepareCloseRequest, O as HostPrepareCloseResult, P as MenuCommand, U as UpdateCheckResult, R as UpdateInstallResult, S as UpdaterStatus } from '../types-ZU8tTM7T.js';
 import '../types-Bb3yccTH.js';
 import '../workspace-path-CWVrcuPL.js';
 

package/dist/index.d.ts

@@ -9,6 +9,6 @@ export { DOCUMENT_RECOVERY_JOURNAL_SCHEMA_VERSION, DOCUMENT_RECOVERY_JOURNAL_STO
 export { ElectronWorkspaceReconciliation, TransientOrigin, WorkspaceDescriptor, ensureDefaultWorkspace, getTransientWorkspace, getWorkspace, listWorkspaces, parsePersistedWorkspaceList, reconcileElectronWorkspaceDescriptors, registerTransientWorkspace, removeWorkspace, saveWorkspace, touchWorkspace, unregisterTransientWorkspace } from './workspace/index.js';
 export { HOST_WIRE_LIMITS, MAX_HOST_PINNED_DOCUMENTS, getDocBlocksHost, isBoundedBytePayload, isBoundedString, isElectronHost, isTrustedRendererUrl, maybeGetDocBlocksHost, parseExternalHttpUrl, parseOpenRequest, parsePinnedMenuDocuments } from './host/index.js';
 export { SHARED_DOCUMENT_LIMITS, SharedDocumentHashParseResult, SharedDocumentMode, SharedDocumentPayload, createSharedDocumentHash, createSharedDocumentUrl, parseSharedDocumentHash } from './share/index.js';
-export { D as DocBlocksHostAPI, a as DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, F as HostEnvironment, I as HostExportTargetGrant, J as HostFileSystemV2OpenRequest, K as HostFileSystemV2Result, L as HostFileSystemV2WatchMessage, M as HostPinnedDocument, N as HostPrepareCloseRequest, O as HostPrepareCloseResult, P as MenuCommand, Q as OpenRequest, U as UpdateCheckResult, R as UpdateInstallResult, S as UpdaterStatus } from './types-D2CRLJB6.js';
+export { D as DocBlocksHostAPI, a as DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, F as HostEnvironment, I as HostExportTargetGrant, J as HostFileSystemV2OpenRequest, K as HostFileSystemV2Result, L as HostFileSystemV2WatchMessage, M as HostPinnedDocument, N as HostPrepareCloseRequest, O as HostPrepareCloseResult, P as MenuCommand, Q as OpenRequest, U as UpdateCheckResult, R as UpdateInstallResult, S as UpdaterStatus } from './types-ZU8tTM7T.js';
 import '@bendyline/squisq/storage';
 import '@bendyline/squisq/schemas';

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   createSharedDocumentHash,
   createSharedDocumentUrl,
   parseSharedDocumentHash
-} from "./chunk-LMMOFRGQ.js";
+} from "./chunk-FBCGLK6N.js";
 import {
   FileSystemContentContainer,
   LegacyFileSystemProviderV2Adapter,
@@ -69,7 +69,7 @@ import {
   DocumentSessionConflictError,
   createFileSystemDocumentTarget,
   getDefaultDocumentRecoveryStorage
-} from "./chunk-6L3JRDE7.js";
+} from "./chunk-KLQKU74Q.js";
 import {
   FileSystemMoveRecoveryError,
   FileSystemPartialMoveError,

package/dist/mcp/index.d.ts

@@ -1,5 +1,5 @@
-import { A as ArtifactRef, C as ComparisonResult, a as ConversionResult, D as DocumentSource, I as InspectionResult, M as MaterializationOptions, b as McpDiagnostic, c as McpErrorResult, P as PreviewResult } from '../types-DapJIsC2.js';
-export { d as AppliedOption, e as AppliedOptionValue, f as ApplyInferredThemeResult, g as ArtifactDocumentSource, h as AssetSummary, i as AuthoringContextResult, j as AuthoringGoal, k as AuthoringSyntaxSummary, l as AuthoringTemplateSummary, B as BlockSummary, m as BundleAssetContentSource, n as BundleAssetRef, o as BundleDocumentSource, p as ComparisonCategory, q as ComparisonChange, r as ComparisonMetric, s as ComparisonStatus, t as ConversionFidelity, u as ConvertDocumentResult, v as DOCBLOCKS_MCP_TOOL_NAMES, w as DOCBLOCKS_MCP_WIRE_VERSION, x as DescribeTemplateResult, y as DescribeThemeResult, z as DescribedTemplate, E as DiagnosticLocation, F as DiagnosticSeverity, G as DiagnosticStage, H as DocBlocksMcpToolName, J as DocBlocksMcpWireVersion, K as DocumentItemSummary, L as DocumentMetadataSummary, N as DocumentStatistics, O as EngineVersion, Q as FileDocumentSource, R as FormatCapabilitySummary, S as FormatDirectionCapability, T as InferThemeResult, U as InferredLayoutSummary, V as InspectPptxLayoutsResult, W as LinkSummary, X as ListFormatsResult, Y as ListRootsResult, Z as ListTemplatesResult, _ as ListThemesResult, $ as ListTransformStylesResult, a0 as MarkdownDocumentSource, a1 as McpErrorDetail, a2 as McpSuccessResult, a3 as OutlineEntry, a4 as PptxLayoutSummary, a5 as PptxSlideSize, a6 as PreviewItem, a7 as PreviewItemKind, a8 as RecommendTemplatesResult, a9 as RootGrantSummary, aa as SaveArtifactResult, ab as SavedArtifactDestination, ac as SourceRange, ad as TableSummary, ae as TemplateAuthoringRole, af as TemplateBodyPolicy, ag as TemplateContentProfile, ah as TemplateInputSummary, ai as TemplateRecommendation, aj as TemplateSummary, ak as ThemeCatalogEntry, al as ThemeDescription, am as ThemeDescriptionColors, an as ThemeSummary, ao as TransformStyleSummary } from '../types-DapJIsC2.js';
+import { A as ArtifactRef, C as ComparisonResult, a as ConversionResult, D as DocumentSource, I as InspectionResult, M as MaterializationOptions, b as McpDiagnostic, c as McpErrorResult, P as PreviewResult } from '../types-Oy9U5FST.js';
+export { d as AppliedOption, e as AppliedOptionValue, f as ApplyInferredThemeResult, g as ArtifactDocumentSource, h as AssetSummary, i as AuthoringContextResult, j as AuthoringGoal, k as AuthoringSyntaxSummary, l as AuthoringTemplateSummary, B as BlockSummary, m as BundleAssetContentSource, n as BundleAssetRef, o as BundleDocumentSource, p as ComparisonCategory, q as ComparisonChange, r as ComparisonMetric, s as ComparisonStatus, t as ConversionFidelity, u as ConvertDocumentResult, v as DOCBLOCKS_MCP_TOOL_NAMES, w as DOCBLOCKS_MCP_WIRE_VERSION, x as DescribeTemplateResult, y as DescribeThemeResult, z as DescribedTemplate, E as DiagnosticLocation, F as DiagnosticSeverity, G as DiagnosticStage, H as DocBlocksMcpToolName, J as DocBlocksMcpWireVersion, K as DocumentItemSummary, L as DocumentMetadataSummary, N as DocumentStatistics, O as EngineVersion, Q as FileDocumentSource, R as FormatCapabilitySummary, S as FormatDirectionCapability, T as InferThemeResult, U as InferredLayoutSummary, V as InspectPptxLayoutsResult, W as LinkSummary, X as ListFormatsResult, Y as ListRootsResult, Z as ListTemplatesResult, _ as ListThemesResult, $ as ListTransformStylesResult, a0 as MarkdownDocumentSource, a1 as McpErrorDetail, a2 as McpSuccessResult, a3 as OutlineEntry, a4 as PptxLayoutSummary, a5 as PptxSlideSize, a6 as PreviewItem, a7 as PreviewItemKind, a8 as RecommendTemplatesResult, a9 as RootGrantSummary, aa as SaveArtifactResult, ab as SavedArtifactDestination, ac as SourceRange, ad as TableSummary, ae as TemplateAuthoringRole, af as TemplateBodyPolicy, ag as TemplateContentProfile, ah as TemplateInputSummary, ai as TemplateRecommendation, aj as TemplateSummary, ak as ThemeCatalogEntry, al as ThemeDescription, am as ThemeDescriptionColors, an as ThemeSummary, ao as TransformStyleSummary } from '../types-Oy9U5FST.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /** Quantitative limits for untrusted MCP payloads. */

package/dist/mcp/index.js

@@ -11,7 +11,7 @@ import {
   parseMcpDiagnostic,
   parseMcpErrorResult,
   parsePreviewResult
-} from "../chunk-EG3WGSZH.js";
+} from "../chunk-YWYT6K6J.js";
 import "../chunk-AYWKIZLD.js";
 export {
   DOCBLOCKS_MCP_TOOL_NAMES,

package/dist/mcp/zod.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { z as z$1 } from 'zod/v4';
-import { H as DocBlocksMcpToolName } from '../types-DapJIsC2.js';
+import { H as DocBlocksMcpToolName } from '../types-Oy9U5FST.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /** Canonical Zod projection of the exact MCP wire contract for protocol SDKs. */
@@ -167,7 +167,22 @@ declare const bundleDocumentSourceSchema: z.ZodObject<{
     }[];
     name?: string | null | undefined;
 }>;
-declare const documentSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+/**
+ * Document source, with a flat-string convenience form.
+ *
+ * Small local models emitting tool calls through textual salvage produce
+ * flat KEY→string argument maps, so a structured `source` object arrives
+ * as a plain string — historically an instant .strict() rejection, and
+ * the first structural-args toolset turned that into unbreakable retry
+ * loops for every sub-frontier model (gezel's 2026-08-22 scorecard:
+ * PPTX production 0/33 across 11 local models). Accept the string
+ * spelling at the schema boundary instead: an artifact URI string is an
+ * artifact source, anything else is a root-relative file path. Inline
+ * markdown must still use the structured `{kind:"markdown"}` form — a
+ * bare string is far more often a path, and silently turning a mistyped
+ * path into a one-line document would be worse than rejecting it.
+ */
+declare const documentSourceSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"markdown">;
     markdown: z.ZodString;
     name: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -181,19 +196,19 @@ declare const documentSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject
     name?: string | null | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"file">;
-    rootId: z.ZodString;
+    rootId: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     path: z.ZodEffects<z.ZodString, string, string>;
     format: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
 }, "strict", z.ZodTypeAny, {
     path: string;
     format: string | null;
     kind: "file";
-    rootId: string;
+    rootId: string | null;
 }, {
     path: string;
     kind: "file";
-    rootId: string;
     format?: string | null | undefined;
+    rootId?: string | null | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"artifact">;
     uri: z.ZodString;
@@ -302,7 +317,38 @@ declare const documentSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject
         license: string | null;
     }[];
     name?: string | null | undefined;
-}>]>;
+}>]>, {
+    name: string | null;
+    markdown: string;
+    kind: "bundle";
+    assets: {
+        path: string;
+        source: {
+            path: string;
+            kind: "file";
+            rootId: string;
+        } | {
+            uri: string;
+            kind: "artifact";
+        };
+        mimeType: string | null;
+        altText: string | null;
+        credit: string | null;
+        license: string | null;
+    }[];
+} | {
+    name: string | null;
+    markdown: string;
+    kind: "markdown";
+} | {
+    path: string;
+    format: string | null;
+    kind: "file";
+    rootId: string | null;
+} | {
+    uri: string;
+    kind: "artifact";
+}, unknown>;
 declare const artifactRefSchema: z.ZodEffects<z.ZodObject<{
     id: z.ZodString;
     uri: z.ZodString;

package/dist/mcp/zod.js

@@ -5,7 +5,7 @@ import {
   parseConversionResult,
   parseInspectionResult,
   parsePreviewResult
-} from "../chunk-EG3WGSZH.js";
+} from "../chunk-YWYT6K6J.js";
 import "../chunk-AYWKIZLD.js";
 
 // src/mcp/zod.ts
@@ -70,7 +70,7 @@ var bundleDocumentSourceSchema = z.object({
   assets: z.array(bundleAssetSchema).max(MCP_WIRE_LIMITS.bundleAssets),
   name: labelSchema.nullable().optional().default(null)
 }).strict();
-var documentSourceSchema = z.discriminatedUnion("kind", [
+var structuredDocumentSourceSchema = z.discriminatedUnion("kind", [
   z.object({
     kind: z.literal("markdown"),
     markdown: z.string().max(MAX_MARKDOWN_CHARACTERS).regex(WIRE_STRING_PATTERN, "NUL and DEL are not permitted on the MCP wire"),
@@ -78,13 +78,31 @@ var documentSourceSchema = z.discriminatedUnion("kind", [
   }).strict(),
   z.object({
     kind: z.literal("file"),
-    rootId: idSchema,
+    // Nullable-with-default: a null rootId means "the server's sole
+    // read-enabled root". Agents on a one-root server (the common MCP
+    // setup) no longer round-trip list_roots before every conversion;
+    // multi-root servers still get an actionable error naming the
+    // candidates. See McpFileAuthority.authorizeRootRead.
+    rootId: idSchema.nullable().optional().default(null),
     path: workspacePathSchema,
     format: formatSchema.nullable().optional().default(null)
   }).strict(),
   z.object({ kind: z.literal("artifact"), uri: artifactUriSchema }).strict(),
   bundleDocumentSourceSchema
 ]);
+var documentSourceSchema = z.preprocess((value) => {
+  if (typeof value !== "string") return value;
+  const text = value.trim();
+  if (text.startsWith("{")) {
+    try {
+      return JSON.parse(text);
+    } catch {
+      return value;
+    }
+  }
+  if (ARTIFACT_URI_PATTERN.test(text)) return { kind: "artifact", uri: text };
+  return { kind: "file", path: text };
+}, structuredDocumentSourceSchema);
 var appliedOptionSchema = z.object({
   name: idSchema,
   value: z.union([boundedString, z.number().finite(), z.boolean(), z.null()])

package/dist/share/index.d.ts

@@ -24,6 +24,8 @@ type SharedDocumentHashParseResult = {
     readonly message: string;
 };
 declare const SHARED_DOCUMENT_LIMITS: Readonly<{
+    /** Conservative ceiling for a locally rendered, medium-correction QR code. */
+    qrUrlCharacters: 2048;
     /** A conservative interoperability threshold, not a universal browser limit. */
     portableUrlCharacters: 4096;
     /** Hard cap applied before a hash is copied or decoded. */

package/dist/share/index.js

@@ -3,7 +3,7 @@ import {
   createSharedDocumentHash,
   createSharedDocumentUrl,
   parseSharedDocumentHash
-} from "../chunk-LMMOFRGQ.js";
+} from "../chunk-FBCGLK6N.js";
 export {
   SHARED_DOCUMENT_LIMITS,
   createSharedDocumentHash,

package/dist/{types-DapJIsC2.d.ts → types-Oy9U5FST.d.ts}

@@ -55,10 +55,17 @@ interface MarkdownDocumentSource {
     readonly markdown: string;
     readonly name: string | null;
 }
-/** A file selected from a server-configured, authority-scoped root. */
+/**
+ * A file selected from a server-configured, authority-scoped root.
+ *
+ * A null rootId means "the server's sole read-enabled root": callers on
+ * a one-root server may omit it, and the authority resolves or rejects
+ * with the candidate ids. It never grants new authority — resolution
+ * still goes through the same root allow-list.
+ */
 interface FileDocumentSource {
     readonly kind: 'file';
-    readonly rootId: string;
+    readonly rootId: string | null;
     readonly path: WorkspacePath;
     readonly format: string | null;
 }

package/dist/{types-D2CRLJB6.d.ts → types-ZU8tTM7T.d.ts}

@@ -306,6 +306,8 @@ interface DocBlocksHostWorkspacesAPI {
 interface DocBlocksHostShellAPI {
     /** Reveal a registered workspace root or one root-relative entry. */
     revealInFolder(workspaceId: string, workspacePath?: string): Promise<void>;
+    /** Open a registered workspace root in Finder or the platform file manager. */
+    openWorkspaceFolder(workspaceId: string): Promise<void>;
     /** Open a URL in the default browser. */
     openExternal(url: string): Promise<void>;
 }
@@ -313,6 +315,8 @@ interface DocBlocksHostShellAPI {
 interface DocBlocksHostClipboardAPI {
     /** Replace the system clipboard's plain-text contents. */
     writeText(text: string): Promise<void>;
+    /** Resolve a registered workspace entry in main and copy its absolute path. */
+    writeWorkspacePath(workspaceId: string, workspacePath: string): Promise<void>;
 }
 /** Exact, main-owned export authority. The display path is never authority. */
 interface HostExportTargetGrant {

package/dist/workspace/index.d.ts

@@ -1,5 +1,5 @@
 import { q as FileSystemProvider } from '../types-Bb3yccTH.js';
-import { m as ElectronWorkspaceInfo, F as HostEnvironment } from '../types-D2CRLJB6.js';
+import { m as ElectronWorkspaceInfo, F as HostEnvironment } from '../types-ZU8tTM7T.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Core data structures and filesystem abstractions for DocBlocks",
   "license": "MIT",
   "author": "Bendyline",
@@ -106,7 +106,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.8.0",
+    "@bendyline/squisq": "2.9.0",
     "zod": "3.25.76"
   }
 }