@bendyline/docblocks 2.1.1 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -14,6 +14,7 @@ var DOCBLOCKS_MCP_TOOL_NAMES = [
14
14
  "validate_document",
15
15
  "preview_document",
16
16
  "compare_documents",
17
+ "get_authoring_context",
17
18
  "list_templates",
18
19
  "describe_template",
19
20
  "recommend_templates",
@@ -1,7 +1,7 @@
1
1
  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-BEg5SQ1_.js';
2
2
  import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
3
3
  export { isElectronHost } from '../host/index.js';
4
- import '../types-CueK0tvU.js';
4
+ import '../types-Cv4uiosG.js';
5
5
 
6
6
  /** Pure renderer-side client for the typed Electron filesystem v2 transport. */
7
7
  declare class ElectronFileSystemProviderV2 implements FileSystemProviderV2 {
@@ -10,7 +10,7 @@ import { MediaProvider } from '@bendyline/squisq/schemas';
10
10
  export { NativeFileSystemMovePathState, NativeFileSystemMoveRecoveryError, NativeFileSystemMoveRecoveryState, NativeFileSystemProvider, NativeFileSystemProviderV2, isNativeFileSystemSupported, loadDirectoryHandle, openNativeFolder, removeDirectoryHandle, restoreNativeFolder, storeDirectoryHandle } from './native.js';
11
11
  export { ElectronFileSystemProvider, ElectronFileSystemProviderV2 } from './electron.js';
12
12
  export { isElectronHost } from '../host/index.js';
13
- import '../types-CueK0tvU.js';
13
+ import '../types-Cv4uiosG.js';
14
14
 
15
15
  interface DecodeUtf8TextOptions {
16
16
  /** User-facing description of the payload being decoded. */
@@ -1,5 +1,5 @@
1
- import { O as OpenRequest, D as DocBlocksHostAPI } from '../types-CueK0tvU.js';
2
- export { a as DocBlocksHostExportAPI, b as DocBlocksHostExternalAPI, c as DocBlocksHostFfmpegAPI, d as DocBlocksHostFsAPI, e as DocBlocksHostFsV2API, f as DocBlocksHostGitAPI, g as DocBlocksHostLifecycleAPI, h as DocBlocksHostShellAPI, i as DocBlocksHostUpdaterAPI, j as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, k as ElectronWorkspaceInfo, l as ExternalBinaryCommitResult, G as GitBranchInfo, m as GitCapabilities, n as GitCloneHandle, o as GitCloneProgress, p as GitError, q as GitErrorCode, r as GitFileAtRevision, s as GitFileChange, t as GitFileStatusCode, u as GitLogEntry, v as GitLogOptions, w as GitRemoteInfo, x as GitRepoDetection, y as GitResult, z as GitRevision, A as GitStatus, H as HostCloseReason, B as HostEnvironment, C as HostExportTargetGrant, F as HostFileSystemV2OpenRequest, I as HostFileSystemV2Result, J as HostFileSystemV2WatchMessage, K as HostPrepareCloseRequest, L as HostPrepareCloseResult, M as MenuCommand, U as UpdateCheckResult, N as UpdateInstallResult, P as UpdaterStatus } from '../types-CueK0tvU.js';
1
+ import { O as OpenRequest, D as DocBlocksHostAPI } from '../types-Cv4uiosG.js';
2
+ export { a as DocBlocksHostExportAPI, b as DocBlocksHostExternalAPI, c as DocBlocksHostFfmpegAPI, d as DocBlocksHostFsAPI, e as DocBlocksHostFsV2API, f as DocBlocksHostGitAPI, g as DocBlocksHostLifecycleAPI, h as DocBlocksHostShellAPI, i as DocBlocksHostUpdaterAPI, j as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, k as ElectronWorkspaceInfo, l as ExternalBinaryCommitResult, G as GitBranchInfo, m as GitCapabilities, n as GitCloneHandle, o as GitCloneProgress, p as GitError, q as GitErrorCode, r as GitFileAtRevision, s as GitFileChange, t as GitFileStatusCode, u as GitLogEntry, v as GitLogOptions, w as GitRemoteInfo, x as GitRepoDetection, y as GitResult, z as GitRevision, A as GitStatus, H as HostCloseReason, B as HostEnvironment, C as HostExportTargetGrant, F as HostFileSystemV2OpenRequest, I as HostFileSystemV2Result, J as HostFileSystemV2WatchMessage, K as HostPrepareCloseRequest, L as HostPrepareCloseResult, M as MenuCommand, U as UpdateCheckResult, N as UpdateInstallResult, P as UpdaterStatus } from '../types-Cv4uiosG.js';
3
3
  import '../types-BEg5SQ1_.js';
4
4
  import '../workspace-path-CWVrcuPL.js';
5
5
 
package/dist/index.d.ts CHANGED
@@ -9,6 +9,6 @@ export { DOCUMENT_RECOVERY_JOURNAL_SCHEMA_VERSION, DOCUMENT_RECOVERY_JOURNAL_STO
9
9
  export { ElectronWorkspaceReconciliation, TransientOrigin, WorkspaceDescriptor, ensureDefaultWorkspace, getTransientWorkspace, getWorkspace, listWorkspaces, parsePersistedWorkspaceList, reconcileElectronWorkspaceDescriptors, registerTransientWorkspace, removeWorkspace, saveWorkspace, touchWorkspace, unregisterTransientWorkspace } from './workspace/index.js';
10
10
  export { HOST_WIRE_LIMITS, getDocBlocksHost, isBoundedBytePayload, isBoundedString, isElectronHost, isTrustedRendererUrl, maybeGetDocBlocksHost, parseExternalHttpUrl, parseOpenRequest } from './host/index.js';
11
11
  export { SHARED_DOCUMENT_LIMITS, SharedDocumentHashParseResult, SharedDocumentMode, SharedDocumentPayload, createSharedDocumentHash, createSharedDocumentUrl, parseSharedDocumentHash } from './share/index.js';
12
- export { D as DocBlocksHostAPI, a as DocBlocksHostExportAPI, b as DocBlocksHostExternalAPI, c as DocBlocksHostFfmpegAPI, d as DocBlocksHostFsAPI, e as DocBlocksHostFsV2API, f as DocBlocksHostGitAPI, g as DocBlocksHostLifecycleAPI, h as DocBlocksHostShellAPI, i as DocBlocksHostUpdaterAPI, j as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, k as ElectronWorkspaceInfo, l as ExternalBinaryCommitResult, G as GitBranchInfo, m as GitCapabilities, n as GitCloneHandle, o as GitCloneProgress, p as GitError, q as GitErrorCode, r as GitFileAtRevision, s as GitFileChange, t as GitFileStatusCode, u as GitLogEntry, v as GitLogOptions, w as GitRemoteInfo, x as GitRepoDetection, y as GitResult, z as GitRevision, A as GitStatus, H as HostCloseReason, B as HostEnvironment, C as HostExportTargetGrant, F as HostFileSystemV2OpenRequest, I as HostFileSystemV2Result, J as HostFileSystemV2WatchMessage, K as HostPrepareCloseRequest, L as HostPrepareCloseResult, M as MenuCommand, O as OpenRequest, U as UpdateCheckResult, N as UpdateInstallResult, P as UpdaterStatus } from './types-CueK0tvU.js';
12
+ export { D as DocBlocksHostAPI, a as DocBlocksHostExportAPI, b as DocBlocksHostExternalAPI, c as DocBlocksHostFfmpegAPI, d as DocBlocksHostFsAPI, e as DocBlocksHostFsV2API, f as DocBlocksHostGitAPI, g as DocBlocksHostLifecycleAPI, h as DocBlocksHostShellAPI, i as DocBlocksHostUpdaterAPI, j as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, k as ElectronWorkspaceInfo, l as ExternalBinaryCommitResult, G as GitBranchInfo, m as GitCapabilities, n as GitCloneHandle, o as GitCloneProgress, p as GitError, q as GitErrorCode, r as GitFileAtRevision, s as GitFileChange, t as GitFileStatusCode, u as GitLogEntry, v as GitLogOptions, w as GitRemoteInfo, x as GitRepoDetection, y as GitResult, z as GitRevision, A as GitStatus, H as HostCloseReason, B as HostEnvironment, C as HostExportTargetGrant, F as HostFileSystemV2OpenRequest, I as HostFileSystemV2Result, J as HostFileSystemV2WatchMessage, K as HostPrepareCloseRequest, L as HostPrepareCloseResult, M as MenuCommand, O as OpenRequest, U as UpdateCheckResult, N as UpdateInstallResult, P as UpdaterStatus } from './types-Cv4uiosG.js';
13
13
  import '@bendyline/squisq/storage';
14
14
  import '@bendyline/squisq/schemas';
@@ -1,5 +1,5 @@
1
- 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, V as ValidationResult } from '../types-CX893hgH.js';
2
- export { d as AppliedOption, e as AppliedOptionValue, f as ApplyInferredThemeResult, g as ArtifactDocumentSource, h as AssetSummary, B as BlockSummary, i as BundleAssetContentSource, j as BundleAssetRef, k as BundleDocumentSource, l as ComparisonCategory, m as ComparisonChange, n as ComparisonMetric, o as ComparisonStatus, p as ConversionFidelity, q as ConvertDocumentResult, r as DOCBLOCKS_MCP_TOOL_NAMES, s as DOCBLOCKS_MCP_WIRE_VERSION, t as DescribeTemplateResult, u as DescribeThemeResult, v as DescribedTemplate, w as DiagnosticLocation, x as DiagnosticSeverity, y as DiagnosticStage, z as DocBlocksMcpToolName, E as DocBlocksMcpWireVersion, F as DocumentItemSummary, G as DocumentMetadataSummary, H as DocumentStatistics, J as EngineVersion, K as FileDocumentSource, L as FormatCapabilitySummary, N as FormatDirectionCapability, O as InferThemeResult, Q as InferredLayoutSummary, R as InspectPptxLayoutsResult, S as LinkSummary, T as ListFormatsResult, U as ListRootsResult, W as ListTemplatesResult, X as ListThemesResult, Y as ListTransformStylesResult, Z as MarkdownDocumentSource, _ as McpErrorDetail, $ as McpSuccessResult, a0 as OutlineEntry, a1 as PptxLayoutSummary, a2 as PptxSlideSize, a3 as PreviewItem, a4 as PreviewItemKind, a5 as RecommendTemplatesResult, a6 as RootGrantSummary, a7 as SaveArtifactResult, a8 as SavedArtifactDestination, a9 as SourceRange, aa as TableSummary, ab as TemplateContentProfile, ac as TemplateInputSummary, ad as TemplateRecommendation, ae as TemplateSummary, af as ThemeCatalogEntry, ag as ThemeDescription, ah as ThemeDescriptionColors, ai as ThemeSummary, aj as TransformStyleSummary, ak as ValidationSummary } from '../types-CX893hgH.js';
1
+ 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, V as ValidationResult } from '../types-DkvEkg0I.js';
2
+ 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, W as InspectPptxLayoutsResult, X as LinkSummary, Y as ListFormatsResult, Z as ListRootsResult, _ as ListTemplatesResult, $ as ListThemesResult, a0 as ListTransformStylesResult, a1 as MarkdownDocumentSource, a2 as McpErrorDetail, a3 as McpSuccessResult, a4 as OutlineEntry, a5 as PptxLayoutSummary, a6 as PptxSlideSize, a7 as PreviewItem, a8 as PreviewItemKind, a9 as RecommendTemplatesResult, aa as RootGrantSummary, ab as SaveArtifactResult, ac as SavedArtifactDestination, ad as SourceRange, ae as TableSummary, af as TemplateAuthoringRole, ag as TemplateBodyPolicy, ah as TemplateContentProfile, ai as TemplateInputSummary, aj as TemplateRecommendation, ak as TemplateSummary, al as ThemeCatalogEntry, am as ThemeDescription, an as ThemeDescriptionColors, ao as ThemeSummary, ap as TransformStyleSummary, aq as ValidationSummary } from '../types-DkvEkg0I.js';
3
3
  import '../workspace-path-CWVrcuPL.js';
4
4
 
5
5
  /** Quantitative limits for untrusted MCP payloads. */
package/dist/mcp/index.js CHANGED
@@ -12,7 +12,7 @@ import {
12
12
  parseMcpErrorResult,
13
13
  parsePreviewResult,
14
14
  parseValidationResult
15
- } from "../chunk-HI7QEWL6.js";
15
+ } from "../chunk-DBJW7BZI.js";
16
16
  import "../chunk-AYWKIZLD.js";
17
17
  export {
18
18
  DOCBLOCKS_MCP_TOOL_NAMES,
package/dist/mcp/zod.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { z as z$1 } from 'zod/v4';
3
- import { z as DocBlocksMcpToolName } from '../types-CX893hgH.js';
3
+ import { H as DocBlocksMcpToolName } from '../types-DkvEkg0I.js';
4
4
  import '../workspace-path-CWVrcuPL.js';
5
5
 
6
6
  /** Canonical Zod projection of the exact MCP wire contract for protocol SDKs. */
@@ -4373,6 +4373,73 @@ declare const describeTemplateResultSchema: z.ZodObject<{
4373
4373
  };
4374
4374
  annotationExample: string;
4375
4375
  }>;
4376
+ declare const authoringTemplateSummarySchema: z.ZodObject<{
4377
+ id: z.ZodString;
4378
+ label: z.ZodString;
4379
+ description: z.ZodString;
4380
+ } & {
4381
+ inputs: z.ZodArray<z.ZodObject<{
4382
+ key: z.ZodString;
4383
+ description: z.ZodString;
4384
+ type: z.ZodString;
4385
+ required: z.ZodBoolean;
4386
+ values: z.ZodArray<z.ZodString, "many">;
4387
+ valueHint: z.ZodNullable<z.ZodString>;
4388
+ }, "strict", z.ZodTypeAny, {
4389
+ values: string[];
4390
+ description: string;
4391
+ type: string;
4392
+ key: string;
4393
+ required: boolean;
4394
+ valueHint: string | null;
4395
+ }, {
4396
+ values: string[];
4397
+ description: string;
4398
+ type: string;
4399
+ key: string;
4400
+ required: boolean;
4401
+ valueHint: string | null;
4402
+ }>, "many">;
4403
+ role: z.ZodEnum<["opener", "divider", "content", "highlight", "quote", "comparison", "event", "media", "data", "spatial"]>;
4404
+ bodyPolicy: z.ZodEnum<["complete", "derived", "ignored", "structured"]>;
4405
+ safeForContentFirst: z.ZodBoolean;
4406
+ placement: z.ZodLiteral<"heading">;
4407
+ annotationExample: z.ZodString;
4408
+ }, "strict", z.ZodTypeAny, {
4409
+ id: string;
4410
+ description: string;
4411
+ label: string;
4412
+ inputs: {
4413
+ values: string[];
4414
+ description: string;
4415
+ type: string;
4416
+ key: string;
4417
+ required: boolean;
4418
+ valueHint: string | null;
4419
+ }[];
4420
+ annotationExample: string;
4421
+ role: "media" | "comparison" | "opener" | "divider" | "content" | "highlight" | "quote" | "event" | "data" | "spatial";
4422
+ bodyPolicy: "complete" | "derived" | "ignored" | "structured";
4423
+ safeForContentFirst: boolean;
4424
+ placement: "heading";
4425
+ }, {
4426
+ id: string;
4427
+ description: string;
4428
+ label: string;
4429
+ inputs: {
4430
+ values: string[];
4431
+ description: string;
4432
+ type: string;
4433
+ key: string;
4434
+ required: boolean;
4435
+ valueHint: string | null;
4436
+ }[];
4437
+ annotationExample: string;
4438
+ role: "media" | "comparison" | "opener" | "divider" | "content" | "highlight" | "quote" | "event" | "data" | "spatial";
4439
+ bodyPolicy: "complete" | "derived" | "ignored" | "structured";
4440
+ safeForContentFirst: boolean;
4441
+ placement: "heading";
4442
+ }>;
4376
4443
  declare const templateContentProfileSchema: z.ZodObject<{
4377
4444
  hasImage: z.ZodBoolean;
4378
4445
  imageCount: z.ZodNumber;
@@ -4623,6 +4690,444 @@ declare const recommendTemplatesResultSchema: z.ZodObject<{
4623
4690
  }[];
4624
4691
  totalBlocks: number;
4625
4692
  }>;
4693
+ declare const authoringContextResultSchema: z.ZodObject<{
4694
+ goal: z.ZodEnum<["content-first", "visual-polish"]>;
4695
+ targetFormat: z.ZodNullable<z.ZodString>;
4696
+ defaultTemplateId: z.ZodString;
4697
+ defaultFidelity: z.ZodNullable<z.ZodEnum<["semantic", "editable-native", "rendered-fidelity", "hybrid"]>>;
4698
+ workflow: z.ZodArray<z.ZodString, "many">;
4699
+ syntax: z.ZodObject<{
4700
+ headingAnnotation: z.ZodString;
4701
+ standaloneAnnotation: z.ZodString;
4702
+ standaloneWarning: z.ZodString;
4703
+ }, "strict", z.ZodTypeAny, {
4704
+ headingAnnotation: string;
4705
+ standaloneAnnotation: string;
4706
+ standaloneWarning: string;
4707
+ }, {
4708
+ headingAnnotation: string;
4709
+ standaloneAnnotation: string;
4710
+ standaloneWarning: string;
4711
+ }>;
4712
+ formats: z.ZodArray<z.ZodObject<{
4713
+ id: z.ZodString;
4714
+ label: z.ZodString;
4715
+ mimeType: z.ZodString;
4716
+ extensions: z.ZodArray<z.ZodString, "many">;
4717
+ import: z.ZodDiscriminatedUnion<"supported", [z.ZodObject<{
4718
+ supported: z.ZodLiteral<true>;
4719
+ tool: z.ZodEnum<["inspect_document", "convert_document"]>;
4720
+ }, "strict", z.ZodTypeAny, {
4721
+ supported: true;
4722
+ tool: "convert_document" | "inspect_document";
4723
+ }, {
4724
+ supported: true;
4725
+ tool: "convert_document" | "inspect_document";
4726
+ }>, z.ZodObject<{
4727
+ supported: z.ZodLiteral<false>;
4728
+ excludedReason: z.ZodString;
4729
+ }, "strict", z.ZodTypeAny, {
4730
+ supported: false;
4731
+ excludedReason: string;
4732
+ }, {
4733
+ supported: false;
4734
+ excludedReason: string;
4735
+ }>]>;
4736
+ export: z.ZodDiscriminatedUnion<"supported", [z.ZodObject<{
4737
+ supported: z.ZodLiteral<true>;
4738
+ tool: z.ZodEnum<["inspect_document", "convert_document"]>;
4739
+ }, "strict", z.ZodTypeAny, {
4740
+ supported: true;
4741
+ tool: "convert_document" | "inspect_document";
4742
+ }, {
4743
+ supported: true;
4744
+ tool: "convert_document" | "inspect_document";
4745
+ }>, z.ZodObject<{
4746
+ supported: z.ZodLiteral<false>;
4747
+ excludedReason: z.ZodString;
4748
+ }, "strict", z.ZodTypeAny, {
4749
+ supported: false;
4750
+ excludedReason: string;
4751
+ }, {
4752
+ supported: false;
4753
+ excludedReason: string;
4754
+ }>]>;
4755
+ }, "strict", z.ZodTypeAny, {
4756
+ import: {
4757
+ supported: true;
4758
+ tool: "convert_document" | "inspect_document";
4759
+ } | {
4760
+ supported: false;
4761
+ excludedReason: string;
4762
+ };
4763
+ export: {
4764
+ supported: true;
4765
+ tool: "convert_document" | "inspect_document";
4766
+ } | {
4767
+ supported: false;
4768
+ excludedReason: string;
4769
+ };
4770
+ id: string;
4771
+ mimeType: string;
4772
+ label: string;
4773
+ extensions: string[];
4774
+ }, {
4775
+ import: {
4776
+ supported: true;
4777
+ tool: "convert_document" | "inspect_document";
4778
+ } | {
4779
+ supported: false;
4780
+ excludedReason: string;
4781
+ };
4782
+ export: {
4783
+ supported: true;
4784
+ tool: "convert_document" | "inspect_document";
4785
+ } | {
4786
+ supported: false;
4787
+ excludedReason: string;
4788
+ };
4789
+ id: string;
4790
+ mimeType: string;
4791
+ label: string;
4792
+ extensions: string[];
4793
+ }>, "many">;
4794
+ templates: z.ZodArray<z.ZodObject<{
4795
+ id: z.ZodString;
4796
+ label: z.ZodString;
4797
+ description: z.ZodString;
4798
+ } & {
4799
+ inputs: z.ZodArray<z.ZodObject<{
4800
+ key: z.ZodString;
4801
+ description: z.ZodString;
4802
+ type: z.ZodString;
4803
+ required: z.ZodBoolean;
4804
+ values: z.ZodArray<z.ZodString, "many">;
4805
+ valueHint: z.ZodNullable<z.ZodString>;
4806
+ }, "strict", z.ZodTypeAny, {
4807
+ values: string[];
4808
+ description: string;
4809
+ type: string;
4810
+ key: string;
4811
+ required: boolean;
4812
+ valueHint: string | null;
4813
+ }, {
4814
+ values: string[];
4815
+ description: string;
4816
+ type: string;
4817
+ key: string;
4818
+ required: boolean;
4819
+ valueHint: string | null;
4820
+ }>, "many">;
4821
+ role: z.ZodEnum<["opener", "divider", "content", "highlight", "quote", "comparison", "event", "media", "data", "spatial"]>;
4822
+ bodyPolicy: z.ZodEnum<["complete", "derived", "ignored", "structured"]>;
4823
+ safeForContentFirst: z.ZodBoolean;
4824
+ placement: z.ZodLiteral<"heading">;
4825
+ annotationExample: z.ZodString;
4826
+ }, "strict", z.ZodTypeAny, {
4827
+ id: string;
4828
+ description: string;
4829
+ label: string;
4830
+ inputs: {
4831
+ values: string[];
4832
+ description: string;
4833
+ type: string;
4834
+ key: string;
4835
+ required: boolean;
4836
+ valueHint: string | null;
4837
+ }[];
4838
+ annotationExample: string;
4839
+ role: "media" | "comparison" | "opener" | "divider" | "content" | "highlight" | "quote" | "event" | "data" | "spatial";
4840
+ bodyPolicy: "complete" | "derived" | "ignored" | "structured";
4841
+ safeForContentFirst: boolean;
4842
+ placement: "heading";
4843
+ }, {
4844
+ id: string;
4845
+ description: string;
4846
+ label: string;
4847
+ inputs: {
4848
+ values: string[];
4849
+ description: string;
4850
+ type: string;
4851
+ key: string;
4852
+ required: boolean;
4853
+ valueHint: string | null;
4854
+ }[];
4855
+ annotationExample: string;
4856
+ role: "media" | "comparison" | "opener" | "divider" | "content" | "highlight" | "quote" | "event" | "data" | "spatial";
4857
+ bodyPolicy: "complete" | "derived" | "ignored" | "structured";
4858
+ safeForContentFirst: boolean;
4859
+ placement: "heading";
4860
+ }>, "many">;
4861
+ themes: z.ZodArray<z.ZodObject<{
4862
+ id: z.ZodString;
4863
+ name: z.ZodString;
4864
+ description: z.ZodOptional<z.ZodString>;
4865
+ }, "strict", z.ZodTypeAny, {
4866
+ name: string;
4867
+ id: string;
4868
+ description?: string | undefined;
4869
+ }, {
4870
+ name: string;
4871
+ id: string;
4872
+ description?: string | undefined;
4873
+ }>, "many">;
4874
+ transformStyles: z.ZodArray<z.ZodObject<{
4875
+ id: z.ZodString;
4876
+ name: z.ZodString;
4877
+ description: z.ZodString;
4878
+ }, "strict", z.ZodTypeAny, {
4879
+ name: string;
4880
+ id: string;
4881
+ description: string;
4882
+ }, {
4883
+ name: string;
4884
+ id: string;
4885
+ description: string;
4886
+ }>, "many">;
4887
+ recommendations: z.ZodArray<z.ZodObject<{
4888
+ blockId: z.ZodString;
4889
+ title: z.ZodNullable<z.ZodString>;
4890
+ profile: z.ZodObject<{
4891
+ hasImage: z.ZodBoolean;
4892
+ imageCount: z.ZodNumber;
4893
+ hasVideo: z.ZodBoolean;
4894
+ hasBlockquote: z.ZodBoolean;
4895
+ hasList: z.ZodBoolean;
4896
+ hasTable: z.ZodBoolean;
4897
+ hasDate: z.ZodBoolean;
4898
+ hasNumberHighlight: z.ZodBoolean;
4899
+ wordCount: z.ZodNumber;
4900
+ hasAsciiDiagram: z.ZodBoolean;
4901
+ hasTimeline: z.ZodBoolean;
4902
+ hasTree: z.ZodBoolean;
4903
+ }, "strict", z.ZodTypeAny, {
4904
+ wordCount: number;
4905
+ hasImage: boolean;
4906
+ imageCount: number;
4907
+ hasVideo: boolean;
4908
+ hasBlockquote: boolean;
4909
+ hasList: boolean;
4910
+ hasTable: boolean;
4911
+ hasDate: boolean;
4912
+ hasNumberHighlight: boolean;
4913
+ hasAsciiDiagram: boolean;
4914
+ hasTimeline: boolean;
4915
+ hasTree: boolean;
4916
+ }, {
4917
+ wordCount: number;
4918
+ hasImage: boolean;
4919
+ imageCount: number;
4920
+ hasVideo: boolean;
4921
+ hasBlockquote: boolean;
4922
+ hasList: boolean;
4923
+ hasTable: boolean;
4924
+ hasDate: boolean;
4925
+ hasNumberHighlight: boolean;
4926
+ hasAsciiDiagram: boolean;
4927
+ hasTimeline: boolean;
4928
+ hasTree: boolean;
4929
+ }>;
4930
+ recommendedTemplateIds: z.ZodArray<z.ZodString, "many">;
4931
+ }, "strict", z.ZodTypeAny, {
4932
+ blockId: string;
4933
+ title: string | null;
4934
+ profile: {
4935
+ wordCount: number;
4936
+ hasImage: boolean;
4937
+ imageCount: number;
4938
+ hasVideo: boolean;
4939
+ hasBlockquote: boolean;
4940
+ hasList: boolean;
4941
+ hasTable: boolean;
4942
+ hasDate: boolean;
4943
+ hasNumberHighlight: boolean;
4944
+ hasAsciiDiagram: boolean;
4945
+ hasTimeline: boolean;
4946
+ hasTree: boolean;
4947
+ };
4948
+ recommendedTemplateIds: string[];
4949
+ }, {
4950
+ blockId: string;
4951
+ title: string | null;
4952
+ profile: {
4953
+ wordCount: number;
4954
+ hasImage: boolean;
4955
+ imageCount: number;
4956
+ hasVideo: boolean;
4957
+ hasBlockquote: boolean;
4958
+ hasList: boolean;
4959
+ hasTable: boolean;
4960
+ hasDate: boolean;
4961
+ hasNumberHighlight: boolean;
4962
+ hasAsciiDiagram: boolean;
4963
+ hasTimeline: boolean;
4964
+ hasTree: boolean;
4965
+ };
4966
+ recommendedTemplateIds: string[];
4967
+ }>, "many">;
4968
+ totalBlocks: z.ZodNullable<z.ZodNumber>;
4969
+ truncated: z.ZodBoolean;
4970
+ }, "strict", z.ZodTypeAny, {
4971
+ targetFormat: string | null;
4972
+ truncated: boolean;
4973
+ formats: {
4974
+ import: {
4975
+ supported: true;
4976
+ tool: "convert_document" | "inspect_document";
4977
+ } | {
4978
+ supported: false;
4979
+ excludedReason: string;
4980
+ };
4981
+ export: {
4982
+ supported: true;
4983
+ tool: "convert_document" | "inspect_document";
4984
+ } | {
4985
+ supported: false;
4986
+ excludedReason: string;
4987
+ };
4988
+ id: string;
4989
+ mimeType: string;
4990
+ label: string;
4991
+ extensions: string[];
4992
+ }[];
4993
+ themes: {
4994
+ name: string;
4995
+ id: string;
4996
+ description?: string | undefined;
4997
+ }[];
4998
+ templates: {
4999
+ id: string;
5000
+ description: string;
5001
+ label: string;
5002
+ inputs: {
5003
+ values: string[];
5004
+ description: string;
5005
+ type: string;
5006
+ key: string;
5007
+ required: boolean;
5008
+ valueHint: string | null;
5009
+ }[];
5010
+ annotationExample: string;
5011
+ role: "media" | "comparison" | "opener" | "divider" | "content" | "highlight" | "quote" | "event" | "data" | "spatial";
5012
+ bodyPolicy: "complete" | "derived" | "ignored" | "structured";
5013
+ safeForContentFirst: boolean;
5014
+ placement: "heading";
5015
+ }[];
5016
+ recommendations: {
5017
+ blockId: string;
5018
+ title: string | null;
5019
+ profile: {
5020
+ wordCount: number;
5021
+ hasImage: boolean;
5022
+ imageCount: number;
5023
+ hasVideo: boolean;
5024
+ hasBlockquote: boolean;
5025
+ hasList: boolean;
5026
+ hasTable: boolean;
5027
+ hasDate: boolean;
5028
+ hasNumberHighlight: boolean;
5029
+ hasAsciiDiagram: boolean;
5030
+ hasTimeline: boolean;
5031
+ hasTree: boolean;
5032
+ };
5033
+ recommendedTemplateIds: string[];
5034
+ }[];
5035
+ totalBlocks: number | null;
5036
+ goal: "content-first" | "visual-polish";
5037
+ defaultTemplateId: string;
5038
+ defaultFidelity: "semantic" | "editable-native" | "rendered-fidelity" | "hybrid" | null;
5039
+ workflow: string[];
5040
+ syntax: {
5041
+ headingAnnotation: string;
5042
+ standaloneAnnotation: string;
5043
+ standaloneWarning: string;
5044
+ };
5045
+ transformStyles: {
5046
+ name: string;
5047
+ id: string;
5048
+ description: string;
5049
+ }[];
5050
+ }, {
5051
+ targetFormat: string | null;
5052
+ truncated: boolean;
5053
+ formats: {
5054
+ import: {
5055
+ supported: true;
5056
+ tool: "convert_document" | "inspect_document";
5057
+ } | {
5058
+ supported: false;
5059
+ excludedReason: string;
5060
+ };
5061
+ export: {
5062
+ supported: true;
5063
+ tool: "convert_document" | "inspect_document";
5064
+ } | {
5065
+ supported: false;
5066
+ excludedReason: string;
5067
+ };
5068
+ id: string;
5069
+ mimeType: string;
5070
+ label: string;
5071
+ extensions: string[];
5072
+ }[];
5073
+ themes: {
5074
+ name: string;
5075
+ id: string;
5076
+ description?: string | undefined;
5077
+ }[];
5078
+ templates: {
5079
+ id: string;
5080
+ description: string;
5081
+ label: string;
5082
+ inputs: {
5083
+ values: string[];
5084
+ description: string;
5085
+ type: string;
5086
+ key: string;
5087
+ required: boolean;
5088
+ valueHint: string | null;
5089
+ }[];
5090
+ annotationExample: string;
5091
+ role: "media" | "comparison" | "opener" | "divider" | "content" | "highlight" | "quote" | "event" | "data" | "spatial";
5092
+ bodyPolicy: "complete" | "derived" | "ignored" | "structured";
5093
+ safeForContentFirst: boolean;
5094
+ placement: "heading";
5095
+ }[];
5096
+ recommendations: {
5097
+ blockId: string;
5098
+ title: string | null;
5099
+ profile: {
5100
+ wordCount: number;
5101
+ hasImage: boolean;
5102
+ imageCount: number;
5103
+ hasVideo: boolean;
5104
+ hasBlockquote: boolean;
5105
+ hasList: boolean;
5106
+ hasTable: boolean;
5107
+ hasDate: boolean;
5108
+ hasNumberHighlight: boolean;
5109
+ hasAsciiDiagram: boolean;
5110
+ hasTimeline: boolean;
5111
+ hasTree: boolean;
5112
+ };
5113
+ recommendedTemplateIds: string[];
5114
+ }[];
5115
+ totalBlocks: number | null;
5116
+ goal: "content-first" | "visual-polish";
5117
+ defaultTemplateId: string;
5118
+ defaultFidelity: "semantic" | "editable-native" | "rendered-fidelity" | "hybrid" | null;
5119
+ workflow: string[];
5120
+ syntax: {
5121
+ headingAnnotation: string;
5122
+ standaloneAnnotation: string;
5123
+ standaloneWarning: string;
5124
+ };
5125
+ transformStyles: {
5126
+ name: string;
5127
+ id: string;
5128
+ description: string;
5129
+ }[];
5130
+ }>;
4626
5131
  declare const themeDescriptionSchema: z.ZodObject<{
4627
5132
  id: z.ZodString;
4628
5133
  name: z.ZodString;
@@ -4635,16 +5140,16 @@ declare const themeDescriptionSchema: z.ZodObject<{
4635
5140
  highlight: z.ZodString;
4636
5141
  }, "strict", z.ZodTypeAny, {
4637
5142
  text: string;
5143
+ highlight: string;
4638
5144
  primary: string;
4639
5145
  secondary: string;
4640
5146
  background: string;
4641
- highlight: string;
4642
5147
  }, {
4643
5148
  text: string;
5149
+ highlight: string;
4644
5150
  primary: string;
4645
5151
  secondary: string;
4646
5152
  background: string;
4647
- highlight: string;
4648
5153
  }>;
4649
5154
  bodyFont: z.ZodString;
4650
5155
  titleFont: z.ZodString;
@@ -4654,10 +5159,10 @@ declare const themeDescriptionSchema: z.ZodObject<{
4654
5159
  description: string;
4655
5160
  colors: {
4656
5161
  text: string;
5162
+ highlight: string;
4657
5163
  primary: string;
4658
5164
  secondary: string;
4659
5165
  background: string;
4660
- highlight: string;
4661
5166
  };
4662
5167
  bodyFont: string;
4663
5168
  titleFont: string;
@@ -4667,10 +5172,10 @@ declare const themeDescriptionSchema: z.ZodObject<{
4667
5172
  description: string;
4668
5173
  colors: {
4669
5174
  text: string;
5175
+ highlight: string;
4670
5176
  primary: string;
4671
5177
  secondary: string;
4672
5178
  background: string;
4673
- highlight: string;
4674
5179
  };
4675
5180
  bodyFont: string;
4676
5181
  titleFont: string;
@@ -4688,16 +5193,16 @@ declare const describeThemeResultSchema: z.ZodObject<{
4688
5193
  highlight: z.ZodString;
4689
5194
  }, "strict", z.ZodTypeAny, {
4690
5195
  text: string;
5196
+ highlight: string;
4691
5197
  primary: string;
4692
5198
  secondary: string;
4693
5199
  background: string;
4694
- highlight: string;
4695
5200
  }, {
4696
5201
  text: string;
5202
+ highlight: string;
4697
5203
  primary: string;
4698
5204
  secondary: string;
4699
5205
  background: string;
4700
- highlight: string;
4701
5206
  }>;
4702
5207
  bodyFont: z.ZodString;
4703
5208
  titleFont: z.ZodString;
@@ -4707,10 +5212,10 @@ declare const describeThemeResultSchema: z.ZodObject<{
4707
5212
  description: string;
4708
5213
  colors: {
4709
5214
  text: string;
5215
+ highlight: string;
4710
5216
  primary: string;
4711
5217
  secondary: string;
4712
5218
  background: string;
4713
- highlight: string;
4714
5219
  };
4715
5220
  bodyFont: string;
4716
5221
  titleFont: string;
@@ -4720,10 +5225,10 @@ declare const describeThemeResultSchema: z.ZodObject<{
4720
5225
  description: string;
4721
5226
  colors: {
4722
5227
  text: string;
5228
+ highlight: string;
4723
5229
  primary: string;
4724
5230
  secondary: string;
4725
5231
  background: string;
4726
- highlight: string;
4727
5232
  };
4728
5233
  bodyFont: string;
4729
5234
  titleFont: string;
@@ -4737,10 +5242,10 @@ declare const describeThemeResultSchema: z.ZodObject<{
4737
5242
  description: string;
4738
5243
  colors: {
4739
5244
  text: string;
5245
+ highlight: string;
4740
5246
  primary: string;
4741
5247
  secondary: string;
4742
5248
  background: string;
4743
- highlight: string;
4744
5249
  };
4745
5250
  bodyFont: string;
4746
5251
  titleFont: string;
@@ -4753,10 +5258,10 @@ declare const describeThemeResultSchema: z.ZodObject<{
4753
5258
  description: string;
4754
5259
  colors: {
4755
5260
  text: string;
5261
+ highlight: string;
4756
5262
  primary: string;
4757
5263
  secondary: string;
4758
5264
  background: string;
4759
- highlight: string;
4760
5265
  };
4761
5266
  bodyFont: string;
4762
5267
  titleFont: string;
@@ -4790,16 +5295,16 @@ declare const inferThemeResultSchema: z.ZodObject<{
4790
5295
  highlight: z.ZodString;
4791
5296
  }, "strict", z.ZodTypeAny, {
4792
5297
  text: string;
5298
+ highlight: string;
4793
5299
  primary: string;
4794
5300
  secondary: string;
4795
5301
  background: string;
4796
- highlight: string;
4797
5302
  }, {
4798
5303
  text: string;
5304
+ highlight: string;
4799
5305
  primary: string;
4800
5306
  secondary: string;
4801
5307
  background: string;
4802
- highlight: string;
4803
5308
  }>;
4804
5309
  bodyFont: z.ZodString;
4805
5310
  titleFont: z.ZodString;
@@ -4809,10 +5314,10 @@ declare const inferThemeResultSchema: z.ZodObject<{
4809
5314
  description: string;
4810
5315
  colors: {
4811
5316
  text: string;
5317
+ highlight: string;
4812
5318
  primary: string;
4813
5319
  secondary: string;
4814
5320
  background: string;
4815
- highlight: string;
4816
5321
  };
4817
5322
  bodyFont: string;
4818
5323
  titleFont: string;
@@ -4822,10 +5327,10 @@ declare const inferThemeResultSchema: z.ZodObject<{
4822
5327
  description: string;
4823
5328
  colors: {
4824
5329
  text: string;
5330
+ highlight: string;
4825
5331
  primary: string;
4826
5332
  secondary: string;
4827
5333
  background: string;
4828
- highlight: string;
4829
5334
  };
4830
5335
  bodyFont: string;
4831
5336
  titleFont: string;
@@ -4851,10 +5356,10 @@ declare const inferThemeResultSchema: z.ZodObject<{
4851
5356
  description: string;
4852
5357
  colors: {
4853
5358
  text: string;
5359
+ highlight: string;
4854
5360
  primary: string;
4855
5361
  secondary: string;
4856
5362
  background: string;
4857
- highlight: string;
4858
5363
  };
4859
5364
  bodyFont: string;
4860
5365
  titleFont: string;
@@ -4874,10 +5379,10 @@ declare const inferThemeResultSchema: z.ZodObject<{
4874
5379
  description: string;
4875
5380
  colors: {
4876
5381
  text: string;
5382
+ highlight: string;
4877
5383
  primary: string;
4878
5384
  secondary: string;
4879
5385
  background: string;
4880
- highlight: string;
4881
5386
  };
4882
5387
  bodyFont: string;
4883
5388
  titleFont: string;
@@ -5516,16 +6021,16 @@ declare const applyInferredThemeResultSchema: z.ZodObject<{
5516
6021
  highlight: z.ZodString;
5517
6022
  }, "strict", z.ZodTypeAny, {
5518
6023
  text: string;
6024
+ highlight: string;
5519
6025
  primary: string;
5520
6026
  secondary: string;
5521
6027
  background: string;
5522
- highlight: string;
5523
6028
  }, {
5524
6029
  text: string;
6030
+ highlight: string;
5525
6031
  primary: string;
5526
6032
  secondary: string;
5527
6033
  background: string;
5528
- highlight: string;
5529
6034
  }>;
5530
6035
  bodyFont: z.ZodString;
5531
6036
  titleFont: z.ZodString;
@@ -5535,10 +6040,10 @@ declare const applyInferredThemeResultSchema: z.ZodObject<{
5535
6040
  description: string;
5536
6041
  colors: {
5537
6042
  text: string;
6043
+ highlight: string;
5538
6044
  primary: string;
5539
6045
  secondary: string;
5540
6046
  background: string;
5541
- highlight: string;
5542
6047
  };
5543
6048
  bodyFont: string;
5544
6049
  titleFont: string;
@@ -5548,10 +6053,10 @@ declare const applyInferredThemeResultSchema: z.ZodObject<{
5548
6053
  description: string;
5549
6054
  colors: {
5550
6055
  text: string;
6056
+ highlight: string;
5551
6057
  primary: string;
5552
6058
  secondary: string;
5553
6059
  background: string;
5554
- highlight: string;
5555
6060
  };
5556
6061
  bodyFont: string;
5557
6062
  titleFont: string;
@@ -5565,10 +6070,10 @@ declare const applyInferredThemeResultSchema: z.ZodObject<{
5565
6070
  description: string;
5566
6071
  colors: {
5567
6072
  text: string;
6073
+ highlight: string;
5568
6074
  primary: string;
5569
6075
  secondary: string;
5570
6076
  background: string;
5571
- highlight: string;
5572
6077
  };
5573
6078
  bodyFont: string;
5574
6079
  titleFont: string;
@@ -5648,10 +6153,10 @@ declare const applyInferredThemeResultSchema: z.ZodObject<{
5648
6153
  description: string;
5649
6154
  colors: {
5650
6155
  text: string;
6156
+ highlight: string;
5651
6157
  primary: string;
5652
6158
  secondary: string;
5653
6159
  background: string;
5654
- highlight: string;
5655
6160
  };
5656
6161
  bodyFont: string;
5657
6162
  titleFont: string;
@@ -5762,4 +6267,4 @@ declare const materializationOptionsSchema: z.ZodDiscriminatedUnion<"ifExists",
5762
6267
  expectedSha256: string;
5763
6268
  }>]>;
5764
6269
 
5765
- export { DOCBLOCKS_MCP_TOOL_OUTPUT_SCHEMAS, DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS, MAX_MARKDOWN_CHARACTERS, MAX_PATH_CHARACTERS, applyInferredThemeResultSchema, artifactRefSchema, artifactUriSchema, bundleAssetSchema, bundleDocumentSourceSchema, comparisonResultSchema, conversionResultSchema, convertDocumentResultSchema, describeTemplateResultSchema, describeThemeResultSchema, diagnosticSchema, documentSourceSchema, formatCapabilitySummarySchema, formatDirectionCapabilitySchema, formatInputSchema, formatSchema, inferThemeResultSchema, inferredLayoutSummarySchema, inspectPptxLayoutsResultSchema, inspectionResultSchema, listFormatsResultSchema, listRootsResultSchema, listTemplatesResultSchema, listThemesResultSchema, listTransformStylesResultSchema, materializationOptionsSchema, mcpErrorDetailSchema, mcpErrorResultSchema, pptxLayoutSummarySchema, previewResultSchema, recommendTemplatesResultSchema, rootGrantSummarySchema, saveArtifactResultSchema, templateContentProfileSchema, templateInputSummarySchema, templateRecommendationSchema, templateSummarySchema, themeCatalogEntrySchema, themeDescriptionSchema, toolOutputSchema, transformStyleSummarySchema, validationResultSchema };
6270
+ export { DOCBLOCKS_MCP_TOOL_OUTPUT_SCHEMAS, DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS, MAX_MARKDOWN_CHARACTERS, MAX_PATH_CHARACTERS, applyInferredThemeResultSchema, artifactRefSchema, artifactUriSchema, authoringContextResultSchema, authoringTemplateSummarySchema, bundleAssetSchema, bundleDocumentSourceSchema, comparisonResultSchema, conversionResultSchema, convertDocumentResultSchema, describeTemplateResultSchema, describeThemeResultSchema, diagnosticSchema, documentSourceSchema, formatCapabilitySummarySchema, formatDirectionCapabilitySchema, formatInputSchema, formatSchema, inferThemeResultSchema, inferredLayoutSummarySchema, inspectPptxLayoutsResultSchema, inspectionResultSchema, listFormatsResultSchema, listRootsResultSchema, listTemplatesResultSchema, listThemesResultSchema, listTransformStylesResultSchema, materializationOptionsSchema, mcpErrorDetailSchema, mcpErrorResultSchema, pptxLayoutSummarySchema, previewResultSchema, recommendTemplatesResultSchema, rootGrantSummarySchema, saveArtifactResultSchema, templateContentProfileSchema, templateInputSummarySchema, templateRecommendationSchema, templateSummarySchema, themeCatalogEntrySchema, themeDescriptionSchema, toolOutputSchema, transformStyleSummarySchema, validationResultSchema };
package/dist/mcp/zod.js CHANGED
@@ -6,7 +6,7 @@ import {
6
6
  parseInspectionResult,
7
7
  parsePreviewResult,
8
8
  parseValidationResult
9
- } from "../chunk-HI7QEWL6.js";
9
+ } from "../chunk-DBJW7BZI.js";
10
10
  import "../chunk-AYWKIZLD.js";
11
11
 
12
12
  // src/mcp/zod.ts
@@ -441,6 +441,25 @@ var describeTemplateResultSchema = z.object({
441
441
  template: templateSummarySchema.extend({ inputs: z.array(templateInputSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries) }).strict(),
442
442
  annotationExample: boundedString
443
443
  }).strict();
444
+ var authoringTemplateSummarySchema = templateSummarySchema.extend({
445
+ inputs: z.array(templateInputSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries),
446
+ role: z.enum([
447
+ "opener",
448
+ "divider",
449
+ "content",
450
+ "highlight",
451
+ "quote",
452
+ "comparison",
453
+ "event",
454
+ "media",
455
+ "data",
456
+ "spatial"
457
+ ]),
458
+ bodyPolicy: z.enum(["complete", "derived", "ignored", "structured"]),
459
+ safeForContentFirst: z.boolean(),
460
+ placement: z.literal("heading"),
461
+ annotationExample: boundedString
462
+ }).strict();
444
463
  var templateContentProfileSchema = z.object({
445
464
  hasImage: z.boolean(),
446
465
  imageCount: nonNegativeSafeIntegerSchema,
@@ -466,6 +485,25 @@ var recommendTemplatesResultSchema = z.object({
466
485
  totalBlocks: nonNegativeSafeIntegerSchema,
467
486
  truncated: z.boolean()
468
487
  }).strict();
488
+ var authoringContextResultSchema = z.object({
489
+ goal: z.enum(["content-first", "visual-polish"]),
490
+ targetFormat: formatSchema.nullable(),
491
+ defaultTemplateId: idSchema,
492
+ defaultFidelity: z.enum(["semantic", "editable-native", "rendered-fidelity", "hybrid"]).nullable(),
493
+ workflow: z.array(boundedString).max(32),
494
+ syntax: z.object({
495
+ headingAnnotation: boundedString,
496
+ standaloneAnnotation: boundedString,
497
+ standaloneWarning: boundedString
498
+ }).strict(),
499
+ formats: z.array(formatCapabilitySummarySchema).max(64),
500
+ templates: z.array(authoringTemplateSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries),
501
+ themes: z.array(themeCatalogEntrySchema).max(MCP_WIRE_LIMITS.arrayEntries),
502
+ transformStyles: z.array(transformStyleSummarySchema).max(MCP_WIRE_LIMITS.arrayEntries),
503
+ recommendations: z.array(templateRecommendationSchema).max(100),
504
+ totalBlocks: nonNegativeSafeIntegerSchema.nullable(),
505
+ truncated: z.boolean()
506
+ }).strict();
469
507
  var themeDescriptionSchema = z.object({
470
508
  id: idSchema,
471
509
  name: nonEmptyLabelSchema,
@@ -519,6 +557,7 @@ var DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS = Object.freeze({
519
557
  validate_document: validationResultSchema,
520
558
  preview_document: previewResultSchema,
521
559
  compare_documents: comparisonResultSchema,
560
+ get_authoring_context: authoringContextResultSchema,
522
561
  list_templates: listTemplatesResultSchema,
523
562
  describe_template: describeTemplateResultSchema,
524
563
  recommend_templates: recommendTemplatesResultSchema,
@@ -542,6 +581,7 @@ var DOCBLOCKS_MCP_TOOL_OUTPUT_SCHEMAS = Object.freeze({
542
581
  validate_document: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.validate_document),
543
582
  preview_document: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.preview_document),
544
583
  compare_documents: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.compare_documents),
584
+ get_authoring_context: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.get_authoring_context),
545
585
  list_templates: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.list_templates),
546
586
  describe_template: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.describe_template),
547
587
  recommend_templates: toolOutputSchema(DOCBLOCKS_MCP_TOOL_RESULT_SCHEMAS.recommend_templates),
@@ -681,6 +721,8 @@ export {
681
721
  applyInferredThemeResultSchema,
682
722
  artifactRefSchema,
683
723
  artifactUriSchema,
724
+ authoringContextResultSchema,
725
+ authoringTemplateSummarySchema,
684
726
  bundleAssetSchema,
685
727
  bundleDocumentSourceSchema,
686
728
  comparisonResultSchema,
@@ -326,7 +326,7 @@ interface DocBlocksHostExportAPI {
326
326
  }
327
327
  /** System ffmpeg detection. */
328
328
  interface DocBlocksHostFfmpegAPI {
329
- /** True if `ffmpeg` is available on PATH (or bundled). */
329
+ /** True if `ffmpeg` is available on PATH. */
330
330
  available(): Promise<boolean>;
331
331
  /** Version string from `ffmpeg -version`, or null if unavailable. */
332
332
  version(): Promise<string | null>;
@@ -4,7 +4,7 @@ import { a as WorkspacePath } from './workspace-path-CWVrcuPL.js';
4
4
  declare const DOCBLOCKS_MCP_WIRE_VERSION: 1;
5
5
  type DocBlocksMcpWireVersion = typeof DOCBLOCKS_MCP_WIRE_VERSION;
6
6
  /** Canonical artifact-first tools exposed by the local DocBlocks MCP server. */
7
- declare const DOCBLOCKS_MCP_TOOL_NAMES: readonly ["list_roots", "get_conversion_report", "convert_document", "create_document_bundle", "save_artifact", "inspect_document", "validate_document", "preview_document", "compare_documents", "list_templates", "describe_template", "recommend_templates", "describe_theme", "infer_theme_from_file", "inspect_pptx_layouts", "apply_inferred_theme", "list_formats", "list_themes", "list_transform_styles"];
7
+ declare const DOCBLOCKS_MCP_TOOL_NAMES: readonly ["list_roots", "get_conversion_report", "convert_document", "create_document_bundle", "save_artifact", "inspect_document", "validate_document", "preview_document", "compare_documents", "get_authoring_context", "list_templates", "describe_template", "recommend_templates", "describe_theme", "infer_theme_from_file", "inspect_pptx_layouts", "apply_inferred_theme", "list_formats", "list_themes", "list_transform_styles"];
8
8
  type DocBlocksMcpToolName = (typeof DOCBLOCKS_MCP_TOOL_NAMES)[number];
9
9
  type AppliedOptionValue = string | number | boolean | null;
10
10
  interface AppliedOption {
@@ -368,6 +368,37 @@ interface DescribeTemplateResult {
368
368
  readonly template: DescribedTemplate;
369
369
  readonly annotationExample: string;
370
370
  }
371
+ type AuthoringGoal = 'content-first' | 'visual-polish';
372
+ type TemplateAuthoringRole = 'opener' | 'divider' | 'content' | 'highlight' | 'quote' | 'comparison' | 'event' | 'media' | 'data' | 'spatial';
373
+ type TemplateBodyPolicy = 'complete' | 'derived' | 'ignored' | 'structured';
374
+ interface AuthoringTemplateSummary extends DescribedTemplate {
375
+ readonly role: TemplateAuthoringRole;
376
+ readonly bodyPolicy: TemplateBodyPolicy;
377
+ readonly safeForContentFirst: boolean;
378
+ readonly placement: 'heading';
379
+ readonly annotationExample: string;
380
+ }
381
+ interface AuthoringSyntaxSummary {
382
+ readonly headingAnnotation: string;
383
+ readonly standaloneAnnotation: string;
384
+ readonly standaloneWarning: string;
385
+ }
386
+ /** One-call, linked-registry-backed context for agent authoring. */
387
+ interface AuthoringContextResult {
388
+ readonly goal: AuthoringGoal;
389
+ readonly targetFormat: string | null;
390
+ readonly defaultTemplateId: string;
391
+ readonly defaultFidelity: ConversionFidelity | null;
392
+ readonly workflow: readonly string[];
393
+ readonly syntax: AuthoringSyntaxSummary;
394
+ readonly formats: readonly FormatCapabilitySummary[];
395
+ readonly templates: readonly AuthoringTemplateSummary[];
396
+ readonly themes: readonly ThemeCatalogEntry[];
397
+ readonly transformStyles: readonly TransformStyleSummary[];
398
+ readonly recommendations: readonly TemplateRecommendation[];
399
+ readonly totalBlocks: number | null;
400
+ readonly truncated: boolean;
401
+ }
371
402
  interface TemplateContentProfile {
372
403
  readonly hasImage: boolean;
373
404
  readonly imageCount: number;
@@ -465,4 +496,4 @@ type MaterializationOptions = {
465
496
  readonly expectedSha256: string;
466
497
  };
467
498
 
468
- export { type McpSuccessResult as $, type ArtifactRef as A, type BlockSummary as B, type ComparisonResult as C, type DocumentSource as D, type DocBlocksMcpWireVersion as E, type DocumentItemSummary as F, type DocumentMetadataSummary as G, type DocumentStatistics as H, type InspectionResult as I, type EngineVersion as J, type FileDocumentSource as K, type FormatCapabilitySummary as L, type MaterializationOptions as M, type FormatDirectionCapability as N, type InferThemeResult as O, type PreviewResult as P, type InferredLayoutSummary as Q, type InspectPptxLayoutsResult as R, type LinkSummary as S, type ListFormatsResult as T, type ListRootsResult as U, type ValidationResult as V, type ListTemplatesResult as W, type ListThemesResult as X, type ListTransformStylesResult as Y, type MarkdownDocumentSource as Z, type McpErrorDetail as _, type ConversionResult as a, type OutlineEntry as a0, type PptxLayoutSummary as a1, type PptxSlideSize as a2, type PreviewItem as a3, type PreviewItemKind as a4, type RecommendTemplatesResult as a5, type RootGrantSummary as a6, type SaveArtifactResult as a7, type SavedArtifactDestination as a8, type SourceRange as a9, type TableSummary as aa, type TemplateContentProfile as ab, type TemplateInputSummary as ac, type TemplateRecommendation as ad, type TemplateSummary as ae, type ThemeCatalogEntry as af, type ThemeDescription as ag, type ThemeDescriptionColors as ah, type ThemeSummary as ai, type TransformStyleSummary as aj, type ValidationSummary as ak, type McpDiagnostic as b, type McpErrorResult as c, type AppliedOption as d, type AppliedOptionValue as e, type ApplyInferredThemeResult as f, type ArtifactDocumentSource as g, type AssetSummary as h, type BundleAssetContentSource as i, type BundleAssetRef as j, type BundleDocumentSource as k, type ComparisonCategory as l, type ComparisonChange as m, type ComparisonMetric as n, type ComparisonStatus as o, type ConversionFidelity as p, type ConvertDocumentResult as q, DOCBLOCKS_MCP_TOOL_NAMES as r, DOCBLOCKS_MCP_WIRE_VERSION as s, type DescribeTemplateResult as t, type DescribeThemeResult as u, type DescribedTemplate as v, type DiagnosticLocation as w, type DiagnosticSeverity as x, type DiagnosticStage as y, type DocBlocksMcpToolName as z };
499
+ export { type ListThemesResult as $, type ArtifactRef as A, type BlockSummary as B, type ComparisonResult as C, type DocumentSource as D, type DiagnosticLocation as E, type DiagnosticSeverity as F, type DiagnosticStage as G, type DocBlocksMcpToolName as H, type InspectionResult as I, type DocBlocksMcpWireVersion as J, type DocumentItemSummary as K, type DocumentMetadataSummary as L, type MaterializationOptions as M, type DocumentStatistics as N, type EngineVersion as O, type PreviewResult as P, type FileDocumentSource as Q, type FormatCapabilitySummary as R, type FormatDirectionCapability as S, type InferThemeResult as T, type InferredLayoutSummary as U, type ValidationResult as V, type InspectPptxLayoutsResult as W, type LinkSummary as X, type ListFormatsResult as Y, type ListRootsResult as Z, type ListTemplatesResult as _, type ConversionResult as a, type ListTransformStylesResult as a0, type MarkdownDocumentSource as a1, type McpErrorDetail as a2, type McpSuccessResult as a3, type OutlineEntry as a4, type PptxLayoutSummary as a5, type PptxSlideSize as a6, type PreviewItem as a7, type PreviewItemKind as a8, type RecommendTemplatesResult as a9, type RootGrantSummary as aa, type SaveArtifactResult as ab, type SavedArtifactDestination as ac, type SourceRange as ad, type TableSummary as ae, type TemplateAuthoringRole as af, type TemplateBodyPolicy as ag, type TemplateContentProfile as ah, type TemplateInputSummary as ai, type TemplateRecommendation as aj, type TemplateSummary as ak, type ThemeCatalogEntry as al, type ThemeDescription as am, type ThemeDescriptionColors as an, type ThemeSummary as ao, type TransformStyleSummary as ap, type ValidationSummary as aq, type McpDiagnostic as b, type McpErrorResult as c, type AppliedOption as d, type AppliedOptionValue as e, type ApplyInferredThemeResult as f, type ArtifactDocumentSource as g, type AssetSummary as h, type AuthoringContextResult as i, type AuthoringGoal as j, type AuthoringSyntaxSummary as k, type AuthoringTemplateSummary as l, type BundleAssetContentSource as m, type BundleAssetRef as n, type BundleDocumentSource as o, type ComparisonCategory as p, type ComparisonChange as q, type ComparisonMetric as r, type ComparisonStatus as s, type ConversionFidelity as t, type ConvertDocumentResult as u, DOCBLOCKS_MCP_TOOL_NAMES as v, DOCBLOCKS_MCP_WIRE_VERSION as w, type DescribeTemplateResult as x, type DescribeThemeResult as y, type DescribedTemplate as z };
@@ -1,5 +1,5 @@
1
1
  import { q as FileSystemProvider } from '../types-BEg5SQ1_.js';
2
- import { k as ElectronWorkspaceInfo, B as HostEnvironment } from '../types-CueK0tvU.js';
2
+ import { k as ElectronWorkspaceInfo, B as HostEnvironment } from '../types-Cv4uiosG.js';
3
3
  import '../workspace-path-CWVrcuPL.js';
4
4
 
5
5
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bendyline/docblocks",
3
- "version": "2.1.1",
3
+ "version": "2.2.0",
4
4
  "description": "Core data structures and filesystem abstractions for DocBlocks",
5
5
  "license": "MIT",
6
6
  "author": "Bendyline",
@@ -99,7 +99,7 @@
99
99
  "typecheck": "tsc --noEmit"
100
100
  },
101
101
  "dependencies": {
102
- "@bendyline/squisq": "2.3.1",
102
+ "@bendyline/squisq": "2.3.2",
103
103
  "zod": "3.25.76"
104
104
  }
105
105
  }