@bendyline/docblocks 1.1.2 → 2.0.0

package/dist/chunk-75UUF6C4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp/types.ts","../src/mcp/wire.ts"],"sourcesContent":["import type { WorkspacePath } from '../filesystem/workspace-path.js';\n\n/** Version of the exact DocBlocks MCP wire envelopes in this module. */\nexport const DOCBLOCKS_MCP_WIRE_VERSION = 1 as const;\n\nexport type DocBlocksMcpWireVersion = typeof DOCBLOCKS_MCP_WIRE_VERSION;\n\n/** Canonical artifact-first tools exposed by the local DocBlocks MCP server. */\nexport const DOCBLOCKS_MCP_TOOL_NAMES = [\n  'list_roots',\n  'get_conversion_report',\n  'convert_document',\n  'create_document_bundle',\n  'save_artifact',\n  'inspect_document',\n  'validate_document',\n  'preview_document',\n  'compare_documents',\n  'list_templates',\n  'describe_template',\n  'recommend_templates',\n  'describe_theme',\n  'infer_theme_from_file',\n  'inspect_pptx_layouts',\n  'apply_inferred_theme',\n  'list_formats',\n  'list_themes',\n  'list_transform_styles',\n] as const;\n\nexport type DocBlocksMcpToolName = (typeof DOCBLOCKS_MCP_TOOL_NAMES)[number];\n\nexport type AppliedOptionValue = string | number | boolean | null;\n\nexport interface AppliedOption {\n  readonly name: string;\n  readonly value: AppliedOptionValue;\n}\n\nexport interface EngineVersion {\n  readonly name: string;\n  readonly version: string;\n}\n\n/** Immutable, session-scoped output which can be read through an MCP resource. */\nexport interface ArtifactRef {\n  readonly id: string;\n  readonly uri: string;\n  readonly format: string;\n  readonly mimeType: string;\n  readonly size: number;\n  readonly sha256: string;\n  readonly sourceFormat: string | null;\n  readonly sourceSha256: string | null;\n  readonly suggestedFilename: string;\n  readonly appliedOptions: readonly AppliedOption[];\n  readonly engineVersions: readonly EngineVersion[];\n  readonly createdAt: string;\n  readonly expiresAt: string | null;\n}\n\n/** Exactly one bounded, authority-scoped content source for a bundle asset. */\nexport type BundleAssetContentSource =\n  | {\n      readonly kind: 'file';\n      readonly rootId: string;\n      readonly path: WorkspacePath;\n    }\n  | {\n      readonly kind: 'artifact';\n      readonly uri: string;\n    };\n\n/** An asset retained beside Markdown at one canonical path in a document bundle. */\nexport interface BundleAssetRef {\n  readonly path: WorkspacePath;\n  readonly source: BundleAssetContentSource;\n  readonly mimeType: string | null;\n  readonly altText: string | null;\n  readonly credit: string | null;\n  readonly license: string | null;\n}\n\n/** Inline Markdown. Use artifact or file sources for large or binary documents. */\nexport interface MarkdownDocumentSource {\n  readonly kind: 'markdown';\n  readonly markdown: string;\n  readonly name: string | null;\n}\n\n/** A file selected from a server-configured, authority-scoped root. */\nexport interface FileDocumentSource {\n  readonly kind: 'file';\n  readonly rootId: string;\n  readonly path: WorkspacePath;\n  readonly format: string | null;\n}\n\n/** A previously produced immutable artifact. */\nexport interface ArtifactDocumentSource {\n  readonly kind: 'artifact';\n  readonly uri: string;\n}\n\n/** Markdown plus artifact-backed media, preserving a complete document tree. */\nexport interface BundleDocumentSource {\n  readonly kind: 'bundle';\n  readonly markdown: string;\n  readonly assets: readonly BundleAssetRef[];\n  readonly name: string | null;\n}\n\nexport type DocumentSource =\n  | MarkdownDocumentSource\n  | FileDocumentSource\n  | ArtifactDocumentSource\n  | BundleDocumentSource;\n\nexport type DiagnosticSeverity = 'info' | 'warning' | 'error';\n\nexport type DiagnosticStage =\n  | 'resolve'\n  | 'import'\n  | 'parse'\n  | 'inspect'\n  | 'validate'\n  | 'transform'\n  | 'convert'\n  | 'render'\n  | 'export'\n  | 'materialize'\n  | 'compare';\n\nexport type DiagnosticLocation =\n  | {\n      readonly kind: 'source';\n      readonly line: number;\n      readonly column: number;\n    }\n  | {\n      readonly kind: 'block';\n      readonly blockId: string;\n      readonly nodeType: string;\n    }\n  | {\n      readonly kind: 'asset';\n      readonly path: WorkspacePath;\n    }\n  | {\n      readonly kind: 'item';\n      readonly itemKind: 'page' | 'slide' | 'sheet' | 'frame';\n      readonly index: number;\n    };\n\n/** Stable, machine-actionable diagnostic shared by every MCP operation. */\nexport interface McpDiagnostic {\n  readonly code: string;\n  readonly severity: DiagnosticSeverity;\n  readonly stage: DiagnosticStage;\n  readonly format: string | null;\n  readonly count: number;\n  readonly message: string;\n  readonly remediation: string | null;\n  readonly retryable: boolean;\n  readonly location: DiagnosticLocation | null;\n}\n\nexport interface McpErrorDetail {\n  readonly code: string;\n  readonly message: string;\n  readonly stage: DiagnosticStage | null;\n  readonly format: string | null;\n  readonly hint: string | null;\n  readonly retryable: boolean;\n  readonly operationLoad: {\n    readonly active: number;\n    readonly capacity: number;\n  } | null;\n}\n\n/** Exact failure envelope returned as structured content by MCP tools. */\nexport interface McpErrorResult {\n  readonly version: DocBlocksMcpWireVersion;\n  readonly kind: 'error';\n  readonly result: null;\n  readonly error: McpErrorDetail;\n}\n\n/** Exact success envelope used by MCP tool structured content. */\nexport interface McpSuccessResult<T> {\n  readonly version: DocBlocksMcpWireVersion;\n  readonly kind: 'success';\n  readonly result: T;\n  readonly error: null;\n}\n\nexport type ConversionFidelity = 'semantic' | 'editable-native' | 'rendered-fidelity' | 'hybrid';\n\nexport interface ConversionResult {\n  readonly version: DocBlocksMcpWireVersion;\n  readonly kind: 'conversion';\n  readonly sourceFormat: string;\n  readonly targetFormat: string;\n  readonly artifact: ArtifactRef;\n  readonly fidelity: ConversionFidelity;\n  readonly appliedThemeId: string | null;\n  readonly appliedTransformId: string | null;\n  /** Source-side assets available to the conversion, including durable attribution metadata. */\n  readonly sourceAssets: readonly AssetSummary[];\n  readonly sourceAssetCount: number;\n  readonly diagnostics: readonly McpDiagnostic[];\n}\n\n/** Successful payload returned by the canonical multi-target conversion tool. */\nexport interface ConvertDocumentResult {\n  readonly results: readonly ConversionResult[];\n}\n\nexport interface DocumentMetadataSummary {\n  readonly title: string | null;\n  readonly author: string | null;\n  readonly description: string | null;\n}\n\nexport interface DocumentStatistics {\n  readonly blockCount: number;\n  readonly wordCount: number;\n  readonly characterCount: number;\n  readonly tableCount: number;\n  readonly linkCount: number;\n  readonly assetCount: number;\n  readonly pageCount: number | null;\n  readonly slideCount: number | null;\n  readonly sheetCount: number | null;\n}\n\nexport interface OutlineEntry {\n  readonly id: string;\n  readonly title: string;\n  readonly level: number;\n  readonly blockIndex: number;\n}\n\nexport interface SourceRange {\n  readonly start: number;\n  readonly end: number;\n}\n\nexport interface BlockSummary {\n  readonly id: string;\n  readonly type: string;\n  readonly text: string;\n  readonly wordCount: number;\n  readonly templateId: string | null;\n  readonly sourceRange: SourceRange | null;\n}\n\nexport interface TableSummary {\n  readonly index: number;\n  readonly rowCount: number;\n  readonly columnCount: number;\n  readonly headers: readonly string[];\n}\n\nexport interface LinkSummary {\n  readonly index: number;\n  readonly text: string;\n  readonly target: string;\n}\n\nexport interface DocumentItemSummary {\n  readonly kind: PreviewItemKind;\n  readonly index: number;\n  readonly label: string | null;\n  readonly blockIds: readonly string[];\n}\n\nexport interface AssetSummary {\n  readonly path: WorkspacePath;\n  readonly mimeType: string;\n  readonly size: number;\n  readonly sha256: string | null;\n  readonly altText: string | null;\n  readonly credit: string | null;\n  readonly license: string | null;\n}\n\nexport interface ThemeSummary {\n  readonly id: string;\n  readonly name: string;\n  readonly source: 'built-in' | 'document' | 'inferred';\n  readonly layouts: readonly string[];\n}\n\nexport interface InspectionResult {\n  readonly version: DocBlocksMcpWireVersion;\n  readonly kind: 'inspection';\n  readonly sourceFormat: string;\n  readonly metadata: DocumentMetadataSummary;\n  readonly statistics: DocumentStatistics;\n  readonly outline: readonly OutlineEntry[];\n  readonly blocks: readonly BlockSummary[];\n  readonly blockOffset: number;\n  readonly nextCursor: string | null;\n  readonly tables: readonly TableSummary[];\n  readonly links: readonly LinkSummary[];\n  readonly items: readonly DocumentItemSummary[];\n  readonly assets: readonly AssetSummary[];\n  readonly theme: ThemeSummary | null;\n  readonly truncated: boolean;\n  readonly detailsTruncated: boolean;\n  readonly diagnostics: readonly McpDiagnostic[];\n}\n\nexport interface ValidationSummary {\n  readonly errorCount: number;\n  readonly warningCount: number;\n  readonly infoCount: number;\n}\n\nexport interface ValidationResult {\n  readonly version: DocBlocksMcpWireVersion;\n  readonly kind: 'validation';\n  readonly sourceFormat: string;\n  readonly targetFormat: string | null;\n  readonly valid: boolean;\n  readonly summary: ValidationSummary;\n  readonly diagnostics: readonly McpDiagnostic[];\n}\n\nexport type PreviewItemKind = 'page' | 'slide' | 'sheet' | 'frame';\n\nexport interface PreviewItem {\n  readonly kind: PreviewItemKind;\n  readonly index: number;\n  readonly label: string | null;\n  readonly artifact: ArtifactRef;\n  readonly width: number;\n  readonly height: number;\n}\n\nexport interface PreviewResult {\n  readonly version: DocBlocksMcpWireVersion;\n  readonly kind: 'preview';\n  readonly sourceFormat: string;\n  readonly previewBasis: 'source-render' | 'reconstructed-import' | 'native-extracted';\n  readonly totalItems: number;\n  readonly items: readonly PreviewItem[];\n  readonly truncated: boolean;\n  readonly diagnostics: readonly McpDiagnostic[];\n}\n\nexport type ComparisonCategory =\n  | 'text'\n  | 'structure'\n  | 'table'\n  | 'media'\n  | 'theme'\n  | 'layout'\n  | 'metadata'\n  | 'timing'\n  | 'accessibility';\n\nexport type ComparisonStatus = 'retained' | 'changed' | 'degraded' | 'omitted' | 'added';\n\nexport interface ComparisonChange {\n  readonly category: ComparisonCategory;\n  readonly status: ComparisonStatus;\n  readonly path: string | null;\n  readonly message: string;\n}\n\nexport interface ComparisonMetric {\n  readonly name: string;\n  readonly leftValue: number;\n  readonly rightValue: number;\n  readonly similarity: number;\n}\n\nexport interface ComparisonResult {\n  readonly version: DocBlocksMcpWireVersion;\n  readonly kind: 'comparison';\n  readonly leftFormat: string;\n  readonly rightFormat: string;\n  readonly equivalent: boolean;\n  readonly score: number;\n  readonly changes: readonly ComparisonChange[];\n  readonly metrics: readonly ComparisonMetric[];\n  readonly diagnostics: readonly McpDiagnostic[];\n}\n\nexport interface RootGrantSummary {\n  readonly id: string;\n  readonly label: string;\n  readonly read: boolean;\n  readonly write: boolean;\n}\n\nexport interface ListRootsResult {\n  readonly roots: readonly RootGrantSummary[];\n}\n\nexport interface SavedArtifactDestination {\n  readonly rootId: string;\n  readonly path: WorkspacePath;\n}\n\nexport interface SaveArtifactResult {\n  readonly artifact: ArtifactRef;\n  readonly destination: SavedArtifactDestination;\n  readonly sha256: string;\n}\n\nexport type FormatDirectionCapability =\n  | {\n      readonly supported: true;\n      readonly tool: 'inspect_document' | 'convert_document';\n    }\n  | {\n      readonly supported: false;\n      readonly excludedReason: string;\n    };\n\nexport interface FormatCapabilitySummary {\n  readonly id: string;\n  readonly label: string;\n  readonly mimeType: string;\n  readonly extensions: readonly string[];\n  readonly import: FormatDirectionCapability;\n  readonly export: FormatDirectionCapability;\n}\n\nexport interface ListFormatsResult {\n  readonly formats: readonly FormatCapabilitySummary[];\n}\n\nexport interface ThemeCatalogEntry {\n  readonly id: string;\n  readonly name: string;\n  readonly description?: string;\n}\n\nexport interface ListThemesResult {\n  readonly themes: readonly ThemeCatalogEntry[];\n}\n\nexport interface TransformStyleSummary {\n  readonly id: string;\n  readonly name: string;\n  readonly description: string;\n}\n\nexport interface ListTransformStylesResult {\n  readonly styles: readonly TransformStyleSummary[];\n}\n\nexport interface TemplateSummary {\n  readonly id: string;\n  readonly label: string;\n  readonly description: string;\n}\n\nexport interface ListTemplatesResult {\n  readonly templates: readonly TemplateSummary[];\n}\n\nexport interface TemplateInputSummary {\n  readonly key: string;\n  readonly description: string;\n  readonly type: string;\n  readonly required: boolean;\n  readonly values: readonly string[];\n  readonly valueHint: string | null;\n}\n\nexport interface DescribedTemplate extends TemplateSummary {\n  readonly inputs: readonly TemplateInputSummary[];\n}\n\nexport interface DescribeTemplateResult {\n  readonly template: DescribedTemplate;\n  readonly annotationExample: string;\n}\n\nexport interface TemplateContentProfile {\n  readonly hasImage: boolean;\n  readonly imageCount: number;\n  readonly hasVideo: boolean;\n  readonly hasBlockquote: boolean;\n  readonly hasList: boolean;\n  readonly hasTable: boolean;\n  readonly hasDate: boolean;\n  readonly hasNumberHighlight: boolean;\n  readonly wordCount: number;\n  readonly hasAsciiDiagram: boolean;\n  readonly hasTimeline: boolean;\n  readonly hasTree: boolean;\n}\n\nexport interface TemplateRecommendation {\n  readonly blockId: string;\n  readonly title: string | null;\n  readonly profile: TemplateContentProfile;\n  readonly recommendedTemplateIds: readonly string[];\n}\n\nexport interface RecommendTemplatesResult {\n  readonly recommendations: readonly TemplateRecommendation[];\n  readonly totalBlocks: number;\n  readonly truncated: boolean;\n}\n\nexport interface ThemeDescriptionColors {\n  readonly primary: string;\n  readonly secondary: string;\n  readonly background: string;\n  readonly text: string;\n  readonly highlight: string;\n}\n\nexport interface ThemeDescription {\n  readonly id: string;\n  readonly name: string;\n  readonly description: string;\n  readonly colors: ThemeDescriptionColors;\n  readonly bodyFont: string;\n  readonly titleFont: string;\n}\n\nexport interface DescribeThemeResult {\n  readonly theme: ThemeDescription;\n  readonly source: 'built-in' | 'document';\n}\n\nexport interface InferredLayoutSummary {\n  readonly id: string;\n  readonly name: string;\n  readonly description: string;\n}\n\nexport interface InferThemeResult {\n  readonly sourceFormat: string;\n  readonly sourceSha256: string;\n  readonly theme: ThemeDescription;\n  readonly layouts: readonly InferredLayoutSummary[];\n  readonly warnings: readonly string[];\n}\n\nexport interface PptxSlideSize {\n  readonly cx: number;\n  readonly cy: number;\n}\n\nexport interface PptxLayoutSummary {\n  readonly layoutPath: string;\n  readonly name: string;\n  readonly masterName: string | null;\n  readonly type: string | null;\n  readonly slideCount: number;\n  readonly verdict: 'builtin' | 'custom' | 'plain' | 'skip';\n  readonly templateId: string | null;\n  readonly notes: readonly string[];\n}\n\nexport interface InspectPptxLayoutsResult {\n  readonly slideSize: PptxSlideSize;\n  readonly layouts: readonly PptxLayoutSummary[];\n}\n\nexport interface ApplyInferredThemeResult {\n  readonly result: ConversionResult;\n  readonly theme: ThemeDescription;\n  readonly layoutIds: readonly string[];\n  readonly warnings: readonly string[];\n}\n\n/**\n * Safe materialization never overwrites by default. Replacement is available\n * only as a process-serialized, hash-conditional update which revalidates the\n * observed target bytes immediately before atomic publication.\n */\nexport type MaterializationOptions =\n  | {\n      readonly rootId: string;\n      readonly path: WorkspacePath;\n      readonly ifExists: 'error';\n      readonly expectedSha256: null;\n    }\n  | {\n      readonly rootId: string;\n      readonly path: WorkspacePath;\n      readonly ifExists: 'replace';\n      readonly expectedSha256: string;\n    };\n","import { tryParseWorkspacePath, type WorkspacePath } from '../filesystem/workspace-path.js';\nimport {\n  DOCBLOCKS_MCP_WIRE_VERSION,\n  type AppliedOption,\n  type ArtifactRef,\n  type AssetSummary,\n  type BlockSummary,\n  type BundleAssetRef,\n  type BundleAssetContentSource,\n  type ComparisonChange,\n  type ComparisonMetric,\n  type ComparisonResult,\n  type ConversionFidelity,\n  type ConversionResult,\n  type DiagnosticLocation,\n  type DiagnosticSeverity,\n  type DiagnosticStage,\n  type DocumentMetadataSummary,\n  type DocumentItemSummary,\n  type DocumentSource,\n  type DocumentStatistics,\n  type EngineVersion,\n  type InspectionResult,\n  type LinkSummary,\n  type MaterializationOptions,\n  type McpDiagnostic,\n  type McpErrorResult,\n  type OutlineEntry,\n  type PreviewItem,\n  type PreviewResult,\n  type SourceRange,\n  type ThemeSummary,\n  type TableSummary,\n  type ValidationResult,\n  type ValidationSummary,\n} from './types.js';\n\n/** Quantitative limits for untrusted MCP payloads. */\nexport const MCP_WIRE_LIMITS = Object.freeze({\n  identifierCharacters: 256,\n  formatCharacters: 64,\n  mimeTypeCharacters: 256,\n  labelCharacters: 1_024,\n  pathCharacters: 4_096,\n  uriCharacters: 8_192,\n  messageCharacters: 4_000,\n  excerptCharacters: 4_096,\n  documentCharacters: 20 * 1024 * 1024,\n  artifactBytes: 500 * 1024 * 1024,\n  bundleAssets: 256,\n  arrayEntries: 10_000,\n  previewItems: 1_000,\n  imageDimension: 32_768,\n});\n\nconst IDENTIFIER_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/u;\nconst ENGINE_NAME_PATTERN =\n  /^(?:[A-Za-z0-9][A-Za-z0-9._:-]*|@[A-Za-z0-9][A-Za-z0-9._-]*\\/[A-Za-z0-9][A-Za-z0-9._-]*)$/u;\nconst FORMAT_PATTERN = /^[a-z0-9][a-z0-9.+_-]*$/u;\nconst MIME_TYPE_PATTERN = /^[a-z0-9!#$&^_.+-]+\\/[a-z0-9!#$&^_.+-]+$/iu;\nconst SHA256_PATTERN = /^[a-f0-9]{64}$/u;\nconst ISO_TIMESTAMP_PATTERN = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/u;\n\nexport function parseArtifactRef(value: unknown): ArtifactRef | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, [\n      'id',\n      'uri',\n      'format',\n      'mimeType',\n      'size',\n      'sha256',\n      'sourceFormat',\n      'sourceSha256',\n      'suggestedFilename',\n      'appliedOptions',\n      'engineVersions',\n      'createdAt',\n      'expiresAt',\n    ])\n  ) {\n    return null;\n  }\n\n  const {\n    id,\n    uri,\n    format,\n    mimeType,\n    size,\n    sha256,\n    sourceFormat,\n    sourceSha256,\n    suggestedFilename,\n    createdAt,\n    expiresAt,\n  } = value;\n  const appliedOptions = parseArray(value.appliedOptions, parseAppliedOption);\n  const engineVersions = parseArray(value.engineVersions, parseEngineVersion);\n  if (\n    !isIdentifier(id) ||\n    !isArtifactUri(uri, id) ||\n    !isFormat(format) ||\n    !isMimeType(mimeType) ||\n    !isBoundedInteger(size, 0, MCP_WIRE_LIMITS.artifactBytes) ||\n    !isSha256(sha256) ||\n    !(sourceFormat === null || isFormat(sourceFormat)) ||\n    !(sourceSha256 === null || isSha256(sourceSha256)) ||\n    !isSafeFilename(suggestedFilename) ||\n    appliedOptions === null ||\n    engineVersions === null ||\n    hasDuplicateNames(appliedOptions) ||\n    hasDuplicateNames(engineVersions) ||\n    !isIsoTimestamp(createdAt) ||\n    !(expiresAt === null || isIsoTimestamp(expiresAt)) ||\n    (expiresAt !== null && Date.parse(expiresAt) <= Date.parse(createdAt))\n  ) {\n    return null;\n  }\n\n  return {\n    id,\n    uri,\n    format,\n    mimeType,\n    size,\n    sha256,\n    sourceFormat,\n    sourceSha256,\n    suggestedFilename,\n    appliedOptions,\n    engineVersions,\n    createdAt,\n    expiresAt,\n  };\n}\n\nexport function parseDocumentSource(value: unknown): DocumentSource | null {\n  if (!isRecord(value) || typeof value.kind !== 'string') return null;\n\n  switch (value.kind) {\n    case 'markdown': {\n      if (!hasExactKeys(value, ['kind', 'markdown', 'name'])) return null;\n      const { markdown, name } = value;\n      if (\n        !isBoundedString(markdown, MCP_WIRE_LIMITS.documentCharacters) ||\n        !isNullableBoundedString(name, MCP_WIRE_LIMITS.labelCharacters)\n      ) {\n        return null;\n      }\n      return { kind: 'markdown', markdown, name };\n    }\n    case 'file': {\n      if (!hasExactKeys(value, ['kind', 'rootId', 'path', 'format'])) return null;\n      const { rootId, path, format } = value;\n      const parsedPath = parseNonRootWorkspacePath(path);\n      if (!isIdentifier(rootId) || parsedPath === null || !(format === null || isFormat(format))) {\n        return null;\n      }\n      return { kind: 'file', rootId, path: parsedPath, format };\n    }\n    case 'artifact': {\n      if (!hasExactKeys(value, ['kind', 'uri']) || !isArtifactUri(value.uri)) return null;\n      return { kind: 'artifact', uri: value.uri };\n    }\n    case 'bundle': {\n      if (!hasExactKeys(value, ['kind', 'markdown', 'assets', 'name'])) return null;\n      const { markdown, name } = value;\n      if (\n        !isBoundedString(markdown, MCP_WIRE_LIMITS.documentCharacters) ||\n        !isNullableBoundedString(name, MCP_WIRE_LIMITS.labelCharacters)\n      ) {\n        return null;\n      }\n      const assets = parseArray(value.assets, parseBundleAssetRef, MCP_WIRE_LIMITS.bundleAssets);\n      if (assets === null || hasDuplicatePaths(assets)) return null;\n      return { kind: 'bundle', markdown, assets, name };\n    }\n    default:\n      return null;\n  }\n}\n\nexport function parseMcpDiagnostic(value: unknown): McpDiagnostic | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, [\n      'code',\n      'severity',\n      'stage',\n      'format',\n      'count',\n      'message',\n      'remediation',\n      'retryable',\n      'location',\n    ])\n  ) {\n    return null;\n  }\n\n  const { code, severity, stage, format, count, message, remediation, retryable } = value;\n  const location = parseNullable(value.location, parseDiagnosticLocation);\n  if (\n    !isIdentifier(code) ||\n    !isDiagnosticSeverity(severity) ||\n    !isDiagnosticStage(stage) ||\n    !(format === null || isFormat(format)) ||\n    !isBoundedInteger(count, 1, Number.MAX_SAFE_INTEGER) ||\n    !isBoundedString(message, MCP_WIRE_LIMITS.messageCharacters, 1) ||\n    !isNullableBoundedString(remediation, MCP_WIRE_LIMITS.messageCharacters) ||\n    typeof retryable !== 'boolean' ||\n    location === undefined\n  ) {\n    return null;\n  }\n\n  return {\n    code,\n    severity,\n    stage,\n    format,\n    count,\n    message,\n    remediation,\n    retryable,\n    location,\n  };\n}\n\nexport function parseMcpErrorResult(value: unknown): McpErrorResult | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['version', 'kind', 'result', 'error']) ||\n    value.version !== DOCBLOCKS_MCP_WIRE_VERSION ||\n    value.kind !== 'error' ||\n    value.result !== null ||\n    !isRecord(value.error) ||\n    !hasExactKeys(value.error, [\n      'code',\n      'message',\n      'stage',\n      'format',\n      'hint',\n      'retryable',\n      'operationLoad',\n    ])\n  ) {\n    return null;\n  }\n  const { code, message, stage, format, hint, retryable, operationLoad } = value.error;\n  if (\n    !isIdentifier(code) ||\n    !isBoundedString(message, MCP_WIRE_LIMITS.messageCharacters, 1) ||\n    !(stage === null || isDiagnosticStage(stage)) ||\n    !(format === null || isFormat(format)) ||\n    !isNullableBoundedString(hint, MCP_WIRE_LIMITS.messageCharacters) ||\n    typeof retryable !== 'boolean' ||\n    !(\n      operationLoad === null ||\n      (isRecord(operationLoad) &&\n        hasExactKeys(operationLoad, ['active', 'capacity']) &&\n        isBoundedInteger(operationLoad.active, 0, 32) &&\n        isBoundedInteger(operationLoad.capacity, 1, 32) &&\n        operationLoad.active <= operationLoad.capacity)\n    )\n  ) {\n    return null;\n  }\n  return {\n    version: DOCBLOCKS_MCP_WIRE_VERSION,\n    kind: 'error',\n    result: null,\n    error: {\n      code,\n      message,\n      stage,\n      format,\n      hint,\n      retryable,\n      operationLoad:\n        operationLoad === null\n          ? null\n          : {\n              active: operationLoad.active as number,\n              capacity: operationLoad.capacity as number,\n            },\n    },\n  };\n}\n\nexport function parseConversionResult(value: unknown): ConversionResult | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, [\n      'version',\n      'kind',\n      'sourceFormat',\n      'targetFormat',\n      'artifact',\n      'fidelity',\n      'appliedThemeId',\n      'appliedTransformId',\n      'sourceAssets',\n      'sourceAssetCount',\n      'diagnostics',\n    ]) ||\n    value.version !== DOCBLOCKS_MCP_WIRE_VERSION ||\n    value.kind !== 'conversion' ||\n    !isFormat(value.sourceFormat) ||\n    !isFormat(value.targetFormat) ||\n    !isConversionFidelity(value.fidelity) ||\n    !isNullableIdentifier(value.appliedThemeId) ||\n    !isNullableIdentifier(value.appliedTransformId) ||\n    !isBoundedInteger(value.sourceAssetCount, 0, MCP_WIRE_LIMITS.arrayEntries)\n  ) {\n    return null;\n  }\n\n  const artifact = parseArtifactRef(value.artifact);\n  const sourceAssets = parseArray(value.sourceAssets, parseAssetSummary);\n  const diagnostics = parseArray(value.diagnostics, parseMcpDiagnostic);\n  if (\n    artifact === null ||\n    sourceAssets === null ||\n    diagnostics === null ||\n    sourceAssets.length !== value.sourceAssetCount ||\n    hasDuplicatePaths(sourceAssets) ||\n    artifact.format !== value.targetFormat ||\n    (artifact.sourceFormat !== null && artifact.sourceFormat !== value.sourceFormat)\n  ) {\n    return null;\n  }\n\n  return {\n    version: DOCBLOCKS_MCP_WIRE_VERSION,\n    kind: 'conversion',\n    sourceFormat: value.sourceFormat,\n    targetFormat: value.targetFormat,\n    artifact,\n    fidelity: value.fidelity,\n    appliedThemeId: value.appliedThemeId,\n    appliedTransformId: value.appliedTransformId,\n    sourceAssets,\n    sourceAssetCount: value.sourceAssetCount,\n    diagnostics,\n  };\n}\n\nexport function parseInspectionResult(value: unknown): InspectionResult | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, [\n      'version',\n      'kind',\n      'sourceFormat',\n      'metadata',\n      'statistics',\n      'outline',\n      'blocks',\n      'blockOffset',\n      'nextCursor',\n      'tables',\n      'links',\n      'items',\n      'assets',\n      'theme',\n      'truncated',\n      'detailsTruncated',\n      'diagnostics',\n    ]) ||\n    value.version !== DOCBLOCKS_MCP_WIRE_VERSION ||\n    value.kind !== 'inspection' ||\n    !isFormat(value.sourceFormat) ||\n    !isBoundedInteger(value.blockOffset, 0, MCP_WIRE_LIMITS.arrayEntries) ||\n    !isNullableBoundedString(value.nextCursor, MCP_WIRE_LIMITS.identifierCharacters) ||\n    typeof value.truncated !== 'boolean' ||\n    typeof value.detailsTruncated !== 'boolean'\n  ) {\n    return null;\n  }\n\n  const metadata = parseDocumentMetadata(value.metadata);\n  const statistics = parseDocumentStatistics(value.statistics);\n  const outline = parseArray(value.outline, parseOutlineEntry);\n  const blocks = parseArray(value.blocks, parseBlockSummary);\n  const tables = parseArray(value.tables, parseTableSummary);\n  const links = parseArray(value.links, parseLinkSummary);\n  const items = parseArray(value.items, parseDocumentItemSummary);\n  const assets = parseArray(value.assets, parseAssetSummary);\n  const theme = parseNullable(value.theme, parseThemeSummary);\n  const diagnostics = parseArray(value.diagnostics, parseMcpDiagnostic);\n  if (\n    metadata === null ||\n    statistics === null ||\n    outline === null ||\n    blocks === null ||\n    tables === null ||\n    links === null ||\n    items === null ||\n    assets === null ||\n    theme === undefined ||\n    diagnostics === null ||\n    statistics.blockCount < value.blockOffset + blocks.length ||\n    statistics.assetCount < assets.length ||\n    (!value.truncated && statistics.blockCount !== value.blockOffset + blocks.length) ||\n    value.truncated !== (value.nextCursor !== null) ||\n    statistics.tableCount < tables.length ||\n    statistics.linkCount < links.length ||\n    hasDuplicateIds(outline) ||\n    hasDuplicateIds(blocks) ||\n    hasDuplicateIndexes(tables) ||\n    hasDuplicateIndexes(links) ||\n    hasDuplicateItemIndexes(items) ||\n    hasDuplicatePaths(assets) ||\n    outline.some((entry) => entry.blockIndex >= statistics.blockCount) ||\n    blocks.some(\n      (block) => block.sourceRange !== null && block.sourceRange.end > statistics.characterCount,\n    )\n  ) {\n    return null;\n  }\n\n  return {\n    version: DOCBLOCKS_MCP_WIRE_VERSION,\n    kind: 'inspection',\n    sourceFormat: value.sourceFormat,\n    metadata,\n    statistics,\n    outline,\n    blocks,\n    blockOffset: value.blockOffset,\n    nextCursor: value.nextCursor,\n    tables,\n    links,\n    items,\n    assets,\n    theme,\n    truncated: value.truncated,\n    detailsTruncated: value.detailsTruncated,\n    diagnostics,\n  };\n}\n\nexport function parseValidationResult(value: unknown): ValidationResult | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, [\n      'version',\n      'kind',\n      'sourceFormat',\n      'targetFormat',\n      'valid',\n      'summary',\n      'diagnostics',\n    ]) ||\n    value.version !== DOCBLOCKS_MCP_WIRE_VERSION ||\n    value.kind !== 'validation' ||\n    !isFormat(value.sourceFormat) ||\n    !(value.targetFormat === null || isFormat(value.targetFormat)) ||\n    typeof value.valid !== 'boolean'\n  ) {\n    return null;\n  }\n\n  const summary = parseValidationSummary(value.summary);\n  const diagnostics = parseArray(value.diagnostics, parseMcpDiagnostic);\n  if (summary === null || diagnostics === null) return null;\n  const actualSummary = summarizeDiagnostics(diagnostics);\n  if (\n    summary.errorCount !== actualSummary.errorCount ||\n    summary.warningCount !== actualSummary.warningCount ||\n    summary.infoCount !== actualSummary.infoCount ||\n    value.valid !== (summary.errorCount === 0)\n  ) {\n    return null;\n  }\n\n  return {\n    version: DOCBLOCKS_MCP_WIRE_VERSION,\n    kind: 'validation',\n    sourceFormat: value.sourceFormat,\n    targetFormat: value.targetFormat,\n    valid: value.valid,\n    summary,\n    diagnostics,\n  };\n}\n\nexport function parsePreviewResult(value: unknown): PreviewResult | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, [\n      'version',\n      'kind',\n      'sourceFormat',\n      'previewBasis',\n      'totalItems',\n      'items',\n      'truncated',\n      'diagnostics',\n    ]) ||\n    value.version !== DOCBLOCKS_MCP_WIRE_VERSION ||\n    value.kind !== 'preview' ||\n    !isFormat(value.sourceFormat) ||\n    !(\n      value.previewBasis === 'source-render' ||\n      value.previewBasis === 'reconstructed-import' ||\n      value.previewBasis === 'native-extracted'\n    ) ||\n    !isBoundedInteger(value.totalItems, 0, Number.MAX_SAFE_INTEGER) ||\n    typeof value.truncated !== 'boolean'\n  ) {\n    return null;\n  }\n\n  const items = parseArray(value.items, parsePreviewItem, MCP_WIRE_LIMITS.previewItems);\n  const diagnostics = parseArray(value.diagnostics, parseMcpDiagnostic);\n  if (\n    items === null ||\n    diagnostics === null ||\n    value.totalItems < items.length ||\n    (!value.truncated && value.totalItems !== items.length) ||\n    hasDuplicatePreviewIndexes(items) ||\n    items.some(\n      (item) =>\n        item.artifact.sourceFormat !== null && item.artifact.sourceFormat !== value.sourceFormat,\n    )\n  ) {\n    return null;\n  }\n\n  return {\n    version: DOCBLOCKS_MCP_WIRE_VERSION,\n    kind: 'preview',\n    sourceFormat: value.sourceFormat,\n    previewBasis: value.previewBasis,\n    totalItems: value.totalItems,\n    items,\n    truncated: value.truncated,\n    diagnostics,\n  };\n}\n\nexport function parseComparisonResult(value: unknown): ComparisonResult | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, [\n      'version',\n      'kind',\n      'leftFormat',\n      'rightFormat',\n      'equivalent',\n      'score',\n      'changes',\n      'metrics',\n      'diagnostics',\n    ]) ||\n    value.version !== DOCBLOCKS_MCP_WIRE_VERSION ||\n    value.kind !== 'comparison' ||\n    !isFormat(value.leftFormat) ||\n    !isFormat(value.rightFormat) ||\n    typeof value.equivalent !== 'boolean' ||\n    !isBoundedNumber(value.score, 0, 1)\n  ) {\n    return null;\n  }\n\n  const changes = parseArray(value.changes, parseComparisonChange);\n  const metrics = parseArray(value.metrics, parseComparisonMetric);\n  const diagnostics = parseArray(value.diagnostics, parseMcpDiagnostic);\n  if (\n    changes === null ||\n    metrics === null ||\n    diagnostics === null ||\n    hasDuplicateNames(metrics) ||\n    (value.equivalent &&\n      (value.score !== 1 || changes.some((change) => change.status !== 'retained')))\n  ) {\n    return null;\n  }\n\n  return {\n    version: DOCBLOCKS_MCP_WIRE_VERSION,\n    kind: 'comparison',\n    leftFormat: value.leftFormat,\n    rightFormat: value.rightFormat,\n    equivalent: value.equivalent,\n    score: value.score,\n    changes,\n    metrics,\n    diagnostics,\n  };\n}\n\nexport function parseMaterializationOptions(value: unknown): MaterializationOptions | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['rootId', 'path', 'ifExists', 'expectedSha256']) ||\n    !isIdentifier(value.rootId)\n  ) {\n    return null;\n  }\n  const path = parseNonRootWorkspacePath(value.path);\n  if (path === null) return null;\n\n  if (value.ifExists === 'error' && value.expectedSha256 === null) {\n    return { rootId: value.rootId, path, ifExists: 'error', expectedSha256: null };\n  }\n  if (value.ifExists === 'replace' && isSha256(value.expectedSha256)) {\n    return {\n      rootId: value.rootId,\n      path,\n      ifExists: 'replace',\n      expectedSha256: value.expectedSha256,\n    };\n  }\n  return null;\n}\n\nfunction parseBundleAssetRef(value: unknown): BundleAssetRef | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['path', 'source', 'mimeType', 'altText', 'credit', 'license'])\n  ) {\n    return null;\n  }\n  const path = parseNonRootWorkspacePath(value.path);\n  const source = parseBundleAssetContentSource(value.source);\n  if (\n    path === null ||\n    source === null ||\n    !(value.mimeType === null || isMimeType(value.mimeType)) ||\n    !isNullableBoundedString(value.altText, MCP_WIRE_LIMITS.labelCharacters) ||\n    !isNullableBoundedString(value.credit, MCP_WIRE_LIMITS.labelCharacters) ||\n    !isNullableBoundedString(value.license, MCP_WIRE_LIMITS.labelCharacters)\n  ) {\n    return null;\n  }\n  return {\n    path,\n    source,\n    mimeType: value.mimeType,\n    altText: value.altText,\n    credit: value.credit,\n    license: value.license,\n  };\n}\n\nfunction parseBundleAssetContentSource(value: unknown): BundleAssetContentSource | null {\n  if (!isRecord(value) || typeof value.kind !== 'string') return null;\n  if (value.kind === 'file') {\n    if (!hasExactKeys(value, ['kind', 'rootId', 'path']) || !isIdentifier(value.rootId)) {\n      return null;\n    }\n    const path = parseNonRootWorkspacePath(value.path);\n    return path === null ? null : { kind: 'file', rootId: value.rootId, path };\n  }\n  if (value.kind === 'artifact') {\n    return hasExactKeys(value, ['kind', 'uri']) && isArtifactUri(value.uri)\n      ? { kind: 'artifact', uri: value.uri }\n      : null;\n  }\n  return null;\n}\n\nfunction parseDiagnosticLocation(value: unknown): DiagnosticLocation | null {\n  if (!isRecord(value) || typeof value.kind !== 'string') return null;\n  switch (value.kind) {\n    case 'source':\n      return hasExactKeys(value, ['kind', 'line', 'column']) &&\n        isBoundedInteger(value.line, 1, Number.MAX_SAFE_INTEGER) &&\n        isBoundedInteger(value.column, 1, Number.MAX_SAFE_INTEGER)\n        ? { kind: 'source', line: value.line, column: value.column }\n        : null;\n    case 'block':\n      return hasExactKeys(value, ['kind', 'blockId', 'nodeType']) &&\n        isIdentifier(value.blockId) &&\n        isIdentifier(value.nodeType)\n        ? { kind: 'block', blockId: value.blockId, nodeType: value.nodeType }\n        : null;\n    case 'asset': {\n      if (!hasExactKeys(value, ['kind', 'path'])) return null;\n      const path = parseNonRootWorkspacePath(value.path);\n      return path === null ? null : { kind: 'asset', path };\n    }\n    case 'item':\n      return hasExactKeys(value, ['kind', 'itemKind', 'index']) &&\n        isPreviewItemKind(value.itemKind) &&\n        isBoundedInteger(value.index, 0, Number.MAX_SAFE_INTEGER)\n        ? { kind: 'item', itemKind: value.itemKind, index: value.index }\n        : null;\n    default:\n      return null;\n  }\n}\n\nfunction parseAppliedOption(value: unknown): AppliedOption | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['name', 'value']) ||\n    !isIdentifier(value.name) ||\n    !isAppliedOptionValue(value.value)\n  ) {\n    return null;\n  }\n  return { name: value.name, value: value.value };\n}\n\nfunction parseEngineVersion(value: unknown): EngineVersion | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['name', 'version']) ||\n    !isEngineName(value.name) ||\n    !isBoundedString(value.version, MCP_WIRE_LIMITS.identifierCharacters, 1)\n  ) {\n    return null;\n  }\n  return { name: value.name, version: value.version };\n}\n\nfunction parseDocumentMetadata(value: unknown): DocumentMetadataSummary | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['title', 'author', 'description']) ||\n    !isNullableBoundedString(value.title, MCP_WIRE_LIMITS.labelCharacters) ||\n    !isNullableBoundedString(value.author, MCP_WIRE_LIMITS.labelCharacters) ||\n    !isNullableBoundedString(value.description, MCP_WIRE_LIMITS.messageCharacters)\n  ) {\n    return null;\n  }\n  return { title: value.title, author: value.author, description: value.description };\n}\n\nfunction parseDocumentStatistics(value: unknown): DocumentStatistics | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, [\n      'blockCount',\n      'wordCount',\n      'characterCount',\n      'tableCount',\n      'linkCount',\n      'assetCount',\n      'pageCount',\n      'slideCount',\n      'sheetCount',\n    ]) ||\n    !isNonNegativeInteger(value.blockCount) ||\n    !isNonNegativeInteger(value.wordCount) ||\n    !isNonNegativeInteger(value.characterCount) ||\n    !isNonNegativeInteger(value.tableCount) ||\n    !isNonNegativeInteger(value.linkCount) ||\n    !isNonNegativeInteger(value.assetCount) ||\n    !isNullableNonNegativeInteger(value.pageCount) ||\n    !isNullableNonNegativeInteger(value.slideCount) ||\n    !isNullableNonNegativeInteger(value.sheetCount)\n  ) {\n    return null;\n  }\n  return {\n    blockCount: value.blockCount,\n    wordCount: value.wordCount,\n    characterCount: value.characterCount,\n    tableCount: value.tableCount,\n    linkCount: value.linkCount,\n    assetCount: value.assetCount,\n    pageCount: value.pageCount,\n    slideCount: value.slideCount,\n    sheetCount: value.sheetCount,\n  };\n}\n\nfunction parseOutlineEntry(value: unknown): OutlineEntry | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['id', 'title', 'level', 'blockIndex']) ||\n    !isIdentifier(value.id) ||\n    !isBoundedString(value.title, MCP_WIRE_LIMITS.labelCharacters, 1) ||\n    !isBoundedInteger(value.level, 1, 6) ||\n    !isNonNegativeInteger(value.blockIndex)\n  ) {\n    return null;\n  }\n  return { id: value.id, title: value.title, level: value.level, blockIndex: value.blockIndex };\n}\n\nfunction parseBlockSummary(value: unknown): BlockSummary | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['id', 'type', 'text', 'wordCount', 'templateId', 'sourceRange']) ||\n    !isIdentifier(value.id) ||\n    !isIdentifier(value.type) ||\n    !isBoundedString(value.text, MCP_WIRE_LIMITS.excerptCharacters) ||\n    !isNonNegativeInteger(value.wordCount) ||\n    !isNullableIdentifier(value.templateId)\n  ) {\n    return null;\n  }\n  const sourceRange = parseNullable(value.sourceRange, parseSourceRange);\n  if (sourceRange === undefined) return null;\n  return {\n    id: value.id,\n    type: value.type,\n    text: value.text,\n    wordCount: value.wordCount,\n    templateId: value.templateId,\n    sourceRange,\n  };\n}\n\nfunction parseSourceRange(value: unknown): SourceRange | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['start', 'end']) ||\n    !isNonNegativeInteger(value.start) ||\n    !isNonNegativeInteger(value.end) ||\n    value.end < value.start\n  ) {\n    return null;\n  }\n  return { start: value.start, end: value.end };\n}\n\nfunction parseTableSummary(value: unknown): TableSummary | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['index', 'rowCount', 'columnCount', 'headers']) ||\n    !isNonNegativeInteger(value.index) ||\n    !isNonNegativeInteger(value.rowCount) ||\n    !isNonNegativeInteger(value.columnCount)\n  ) {\n    return null;\n  }\n  const headers = parseArray(value.headers, (entry) =>\n    isBoundedString(entry, MCP_WIRE_LIMITS.labelCharacters) ? entry : null,\n  );\n  if (headers === null || headers.length > value.columnCount) return null;\n  return {\n    index: value.index,\n    rowCount: value.rowCount,\n    columnCount: value.columnCount,\n    headers,\n  };\n}\n\nfunction parseLinkSummary(value: unknown): LinkSummary | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['index', 'text', 'target']) ||\n    !isNonNegativeInteger(value.index) ||\n    !isBoundedString(value.text, MCP_WIRE_LIMITS.labelCharacters) ||\n    !isBoundedString(value.target, MCP_WIRE_LIMITS.uriCharacters, 1)\n  ) {\n    return null;\n  }\n  return { index: value.index, text: value.text, target: value.target };\n}\n\nfunction parseDocumentItemSummary(value: unknown): DocumentItemSummary | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['kind', 'index', 'label', 'blockIds']) ||\n    !isPreviewItemKind(value.kind) ||\n    !isNonNegativeInteger(value.index) ||\n    !isNullableBoundedString(value.label, MCP_WIRE_LIMITS.labelCharacters)\n  ) {\n    return null;\n  }\n  const blockIds = parseArray(value.blockIds, (entry) => (isIdentifier(entry) ? entry : null));\n  if (blockIds === null || new Set(blockIds).size !== blockIds.length) return null;\n  return { kind: value.kind, index: value.index, label: value.label, blockIds };\n}\n\nfunction parseAssetSummary(value: unknown): AssetSummary | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['path', 'mimeType', 'size', 'sha256', 'altText', 'credit', 'license'])\n  ) {\n    return null;\n  }\n  const path = parseNonRootWorkspacePath(value.path);\n  if (\n    path === null ||\n    !isMimeType(value.mimeType) ||\n    !isBoundedInteger(value.size, 0, MCP_WIRE_LIMITS.artifactBytes) ||\n    !(value.sha256 === null || isSha256(value.sha256)) ||\n    !isNullableBoundedString(value.altText, MCP_WIRE_LIMITS.labelCharacters) ||\n    !isNullableBoundedString(value.credit, MCP_WIRE_LIMITS.labelCharacters) ||\n    !isNullableBoundedString(value.license, MCP_WIRE_LIMITS.labelCharacters)\n  ) {\n    return null;\n  }\n  return {\n    path,\n    mimeType: value.mimeType,\n    size: value.size,\n    sha256: value.sha256,\n    altText: value.altText,\n    credit: value.credit,\n    license: value.license,\n  };\n}\n\nfunction parseThemeSummary(value: unknown): ThemeSummary | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['id', 'name', 'source', 'layouts']) ||\n    !isIdentifier(value.id) ||\n    !isBoundedString(value.name, MCP_WIRE_LIMITS.labelCharacters, 1) ||\n    !(value.source === 'built-in' || value.source === 'document' || value.source === 'inferred')\n  ) {\n    return null;\n  }\n  const layouts = parseStringArray(value.layouts, MCP_WIRE_LIMITS.labelCharacters);\n  if (layouts === null || new Set(layouts).size !== layouts.length) return null;\n  return { id: value.id, name: value.name, source: value.source, layouts };\n}\n\nfunction parseValidationSummary(value: unknown): ValidationSummary | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['errorCount', 'warningCount', 'infoCount']) ||\n    !isNonNegativeInteger(value.errorCount) ||\n    !isNonNegativeInteger(value.warningCount) ||\n    !isNonNegativeInteger(value.infoCount)\n  ) {\n    return null;\n  }\n  return {\n    errorCount: value.errorCount,\n    warningCount: value.warningCount,\n    infoCount: value.infoCount,\n  };\n}\n\nfunction parsePreviewItem(value: unknown): PreviewItem | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['kind', 'index', 'label', 'artifact', 'width', 'height']) ||\n    !isPreviewItemKind(value.kind) ||\n    !isNonNegativeInteger(value.index) ||\n    !isNullableBoundedString(value.label, MCP_WIRE_LIMITS.labelCharacters) ||\n    !isBoundedInteger(value.width, 1, MCP_WIRE_LIMITS.imageDimension) ||\n    !isBoundedInteger(value.height, 1, MCP_WIRE_LIMITS.imageDimension)\n  ) {\n    return null;\n  }\n  const artifact = parseArtifactRef(value.artifact);\n  if (artifact === null || !artifact.mimeType.startsWith('image/')) return null;\n  return {\n    kind: value.kind,\n    index: value.index,\n    label: value.label,\n    artifact,\n    width: value.width,\n    height: value.height,\n  };\n}\n\nfunction parseComparisonChange(value: unknown): ComparisonChange | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['category', 'status', 'path', 'message']) ||\n    !isComparisonCategory(value.category) ||\n    !isComparisonStatus(value.status) ||\n    !isNullableBoundedString(value.path, MCP_WIRE_LIMITS.pathCharacters) ||\n    !isBoundedString(value.message, MCP_WIRE_LIMITS.messageCharacters, 1)\n  ) {\n    return null;\n  }\n  return {\n    category: value.category,\n    status: value.status,\n    path: value.path,\n    message: value.message,\n  };\n}\n\nfunction parseComparisonMetric(value: unknown): ComparisonMetric | null {\n  if (\n    !isRecord(value) ||\n    !hasExactKeys(value, ['name', 'leftValue', 'rightValue', 'similarity']) ||\n    !isIdentifier(value.name) ||\n    !isFiniteNumber(value.leftValue) ||\n    !isFiniteNumber(value.rightValue) ||\n    !isBoundedNumber(value.similarity, 0, 1)\n  ) {\n    return null;\n  }\n  return {\n    name: value.name,\n    leftValue: value.leftValue,\n    rightValue: value.rightValue,\n    similarity: value.similarity,\n  };\n}\n\nfunction summarizeDiagnostics(diagnostics: readonly McpDiagnostic[]): ValidationSummary {\n  let errorCount = 0;\n  let warningCount = 0;\n  let infoCount = 0;\n  for (const diagnostic of diagnostics) {\n    if (diagnostic.severity === 'error') errorCount += diagnostic.count;\n    else if (diagnostic.severity === 'warning') warningCount += diagnostic.count;\n    else infoCount += diagnostic.count;\n  }\n  return { errorCount, warningCount, infoCount };\n}\n\nfunction parseArray<T>(\n  value: unknown,\n  parser: (entry: unknown) => T | null,\n  maximumEntries: number = MCP_WIRE_LIMITS.arrayEntries,\n): T[] | null {\n  if (!Array.isArray(value) || value.length > maximumEntries) return null;\n  const parsed: T[] = [];\n  for (const entry of value) {\n    const result = parser(entry);\n    if (result === null) return null;\n    parsed.push(result);\n  }\n  return parsed;\n}\n\nfunction parseStringArray(value: unknown, maximumCharacters: number): string[] | null {\n  if (!Array.isArray(value) || value.length > MCP_WIRE_LIMITS.arrayEntries) return null;\n  const parsed: string[] = [];\n  for (const entry of value) {\n    if (!isBoundedString(entry, maximumCharacters, 1)) return null;\n    parsed.push(entry);\n  }\n  return parsed;\n}\n\nfunction parseNullable<T>(\n  value: unknown,\n  parser: (entry: unknown) => T | null,\n): T | null | undefined {\n  if (value === null) return null;\n  return parser(value) ?? undefined;\n}\n\nfunction parseNonRootWorkspacePath(value: unknown): WorkspacePath | null {\n  if (\n    !isBoundedString(value, MCP_WIRE_LIMITS.pathCharacters, 1) ||\n    value.includes('\\\\') ||\n    value.startsWith('/') ||\n    value.endsWith('/') ||\n    value.includes('//')\n  ) {\n    return null;\n  }\n  const parsed = tryParseWorkspacePath(value);\n  return parsed !== null && parsed !== '' && parsed === value ? parsed : null;\n}\n\nfunction isArtifactUri(value: unknown, expectedId?: string): value is string {\n  if (!isBoundedString(value, MCP_WIRE_LIMITS.uriCharacters, 1)) return false;\n  try {\n    const url = new URL(value);\n    if (\n      url.protocol !== 'docblocks:' ||\n      url.hostname !== 'artifacts' ||\n      url.username !== '' ||\n      url.password !== '' ||\n      url.port !== '' ||\n      url.search !== '' ||\n      url.hash !== ''\n    ) {\n      return false;\n    }\n    const id = url.pathname.slice(1);\n    return (\n      !id.includes('/') &&\n      isIdentifier(id) &&\n      value === `docblocks://artifacts/${id}` &&\n      (expectedId === undefined || id === expectedId)\n    );\n  } catch {\n    return false;\n  }\n}\n\nfunction isSafeFilename(value: unknown): value is string {\n  return (\n    isBoundedString(value, MCP_WIRE_LIMITS.labelCharacters, 1) &&\n    value !== '.' &&\n    value !== '..' &&\n    !value.includes('/') &&\n    !value.includes('\\\\')\n  );\n}\n\nfunction isIsoTimestamp(value: unknown): value is string {\n  if (typeof value !== 'string' || !ISO_TIMESTAMP_PATTERN.test(value)) return false;\n  const timestamp = Date.parse(value);\n  return Number.isFinite(timestamp) && new Date(timestamp).toISOString() === value;\n}\n\nfunction isIdentifier(value: unknown): value is string {\n  return (\n    isBoundedString(value, MCP_WIRE_LIMITS.identifierCharacters, 1) &&\n    IDENTIFIER_PATTERN.test(value)\n  );\n}\n\nfunction isEngineName(value: unknown): value is string {\n  return (\n    isBoundedString(value, MCP_WIRE_LIMITS.identifierCharacters, 1) &&\n    ENGINE_NAME_PATTERN.test(value)\n  );\n}\n\nfunction isNullableIdentifier(value: unknown): value is string | null {\n  return value === null || isIdentifier(value);\n}\n\nfunction isFormat(value: unknown): value is string {\n  return isBoundedString(value, MCP_WIRE_LIMITS.formatCharacters, 1) && FORMAT_PATTERN.test(value);\n}\n\nfunction isMimeType(value: unknown): value is string {\n  return (\n    isBoundedString(value, MCP_WIRE_LIMITS.mimeTypeCharacters, 3) && MIME_TYPE_PATTERN.test(value)\n  );\n}\n\nfunction isSha256(value: unknown): value is string {\n  return typeof value === 'string' && SHA256_PATTERN.test(value);\n}\n\nfunction isAppliedOptionValue(value: unknown): value is string | number | boolean | null {\n  return (\n    value === null ||\n    typeof value === 'boolean' ||\n    isBoundedString(value, MCP_WIRE_LIMITS.messageCharacters) ||\n    isFiniteNumber(value)\n  );\n}\n\nfunction isDiagnosticSeverity(value: unknown): value is DiagnosticSeverity {\n  return value === 'info' || value === 'warning' || value === 'error';\n}\n\nfunction isDiagnosticStage(value: unknown): value is DiagnosticStage {\n  return (\n    value === 'resolve' ||\n    value === 'import' ||\n    value === 'parse' ||\n    value === 'inspect' ||\n    value === 'validate' ||\n    value === 'transform' ||\n    value === 'convert' ||\n    value === 'render' ||\n    value === 'export' ||\n    value === 'materialize' ||\n    value === 'compare'\n  );\n}\n\nfunction isConversionFidelity(value: unknown): value is ConversionFidelity {\n  return (\n    value === 'semantic' ||\n    value === 'editable-native' ||\n    value === 'rendered-fidelity' ||\n    value === 'hybrid'\n  );\n}\n\nfunction isPreviewItemKind(value: unknown): value is PreviewItem['kind'] {\n  return value === 'page' || value === 'slide' || value === 'sheet' || value === 'frame';\n}\n\nfunction isComparisonCategory(value: unknown): value is ComparisonChange['category'] {\n  return (\n    value === 'text' ||\n    value === 'structure' ||\n    value === 'table' ||\n    value === 'media' ||\n    value === 'theme' ||\n    value === 'layout' ||\n    value === 'metadata' ||\n    value === 'timing' ||\n    value === 'accessibility'\n  );\n}\n\nfunction isComparisonStatus(value: unknown): value is ComparisonChange['status'] {\n  return (\n    value === 'retained' ||\n    value === 'changed' ||\n    value === 'degraded' ||\n    value === 'omitted' ||\n    value === 'added'\n  );\n}\n\nfunction hasDuplicateNames(values: readonly { readonly name: string }[]): boolean {\n  return new Set(values.map((value) => value.name)).size !== values.length;\n}\n\nfunction hasDuplicateIds(values: readonly { readonly id: string }[]): boolean {\n  return new Set(values.map((value) => value.id)).size !== values.length;\n}\n\nfunction hasDuplicatePaths(values: readonly { readonly path: WorkspacePath }[]): boolean {\n  return new Set(values.map((value) => value.path)).size !== values.length;\n}\n\nfunction hasDuplicateIndexes(values: readonly { readonly index: number }[]): boolean {\n  return new Set(values.map((value) => value.index)).size !== values.length;\n}\n\nfunction hasDuplicateItemIndexes(values: readonly DocumentItemSummary[]): boolean {\n  return new Set(values.map((value) => `${value.kind}:${value.index}`)).size !== values.length;\n}\n\nfunction hasDuplicatePreviewIndexes(values: readonly PreviewItem[]): boolean {\n  const keys = values.map((value) => `${value.kind}:${value.index}`);\n  return new Set(keys).size !== keys.length;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction hasExactKeys(value: Record<string, unknown>, keys: readonly string[]): boolean {\n  const actual = Object.keys(value);\n  return (\n    actual.length === keys.length &&\n    keys.every((key) => Object.prototype.hasOwnProperty.call(value, key))\n  );\n}\n\nfunction isBoundedString(\n  value: unknown,\n  maximumCharacters: number,\n  minimumCharacters = 0,\n): value is string {\n  return (\n    typeof value === 'string' &&\n    value.length >= minimumCharacters &&\n    value.length <= maximumCharacters &&\n    ![...value].some((character) => {\n      const codePoint = character.codePointAt(0) ?? 0;\n      return codePoint === 0 || codePoint === 0x7f;\n    })\n  );\n}\n\nfunction isNullableBoundedString(\n  value: unknown,\n  maximumCharacters: number,\n): value is string | null {\n  return value === null || isBoundedString(value, maximumCharacters);\n}\n\nfunction isFiniteNumber(value: unknown): value is number {\n  return typeof value === 'number' && Number.isFinite(value);\n}\n\nfunction isBoundedNumber(value: unknown, minimum: number, maximum: number): value is number {\n  return isFiniteNumber(value) && value >= minimum && value <= maximum;\n}\n\nfunction isBoundedInteger(value: unknown, minimum: number, maximum: number): value is number {\n  return (\n    Number.isSafeInteger(value) && typeof value === 'number' && value >= minimum && value <= maximum\n  );\n}\n\nfunction isNonNegativeInteger(value: unknown): value is number {\n  return isBoundedInteger(value, 0, Number.MAX_SAFE_INTEGER);\n}\n\nfunction isNullableNonNegativeInteger(value: unknown): value is number | null {\n  return value === null || isNonNegativeInteger(value);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-AEHCVWU5.js

@@ -0,0 +1,25 @@
+// src/filesystem/commit-lock.ts
+var localTails = /* @__PURE__ */ new Map();
+async function withFileCommitLock(key, operation) {
+  const lockManager = typeof navigator === "undefined" ? void 0 : navigator.locks;
+  if (lockManager) {
+    return lockManager.request(`docblocks:${key}`, operation);
+  }
+  const previous = localTails.get(key) ?? Promise.resolve();
+  const run = previous.then(operation, operation);
+  const tail = run.then(
+    () => void 0,
+    () => void 0
+  );
+  localTails.set(key, tail);
+  try {
+    return await run;
+  } finally {
+    if (localTails.get(key) === tail) localTails.delete(key);
+  }
+}
+
+export {
+  withFileCommitLock
+};
+//# sourceMappingURL=chunk-AEHCVWU5.js.map

package/dist/chunk-AEHCVWU5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filesystem/commit-lock.ts"],"sourcesContent":["type LockNavigator = Navigator & {\n  locks?: {\n    request<T>(name: string, callback: () => Promise<T>): Promise<T>;\n  };\n};\n\nconst localTails = new Map<string, Promise<void>>();\n\n/** Serialize conditional commits across providers and, when available, tabs. */\nexport async function withFileCommitLock<T>(key: string, operation: () => Promise<T>): Promise<T> {\n  const lockManager =\n    typeof navigator === 'undefined' ? undefined : (navigator as LockNavigator).locks;\n  if (lockManager) {\n    return lockManager.request(`docblocks:${key}`, operation);\n  }\n\n  const previous = localTails.get(key) ?? Promise.resolve();\n  const run = previous.then(operation, operation);\n  const tail = run.then(\n    () => undefined,\n    () => undefined,\n  );\n  localTails.set(key, tail);\n  try {\n    return await run;\n  } finally {\n    if (localTails.get(key) === tail) localTails.delete(key);\n  }\n}\n"],"mappings":";AAMA,IAAM,aAAa,oBAAI,IAA2B;AAGlD,eAAsB,mBAAsB,KAAa,WAAyC;AAChG,QAAM,cACJ,OAAO,cAAc,cAAc,SAAa,UAA4B;AAC9E,MAAI,aAAa;AACf,WAAO,YAAY,QAAQ,aAAa,GAAG,IAAI,SAAS;AAAA,EAC1D;AAEA,QAAM,WAAW,WAAW,IAAI,GAAG,KAAK,QAAQ,QAAQ;AACxD,QAAM,MAAM,SAAS,KAAK,WAAW,SAAS;AAC9C,QAAM,OAAO,IAAI;AAAA,IACf,MAAM;AAAA,IACN,MAAM;AAAA,EACR;AACA,aAAW,IAAI,KAAK,IAAI;AACxB,MAAI;AACF,WAAO,MAAM;AAAA,EACf,UAAE;AACA,QAAI,WAAW,IAAI,GAAG,MAAM,KAAM,YAAW,OAAO,GAAG;AAAA,EACzD;AACF;","names":[]}

package/dist/chunk-AYZ4HN5M.js

@@ -0,0 +1,20 @@
+// src/filesystem/v2.ts
+function parseFileSystemVersion(value) {
+  if (typeof value !== "string" || !value || value.length > 1024 || value.includes("\0")) {
+    throw new TypeError("Filesystem version tokens must be non-empty bounded strings.");
+  }
+  return value;
+}
+function tryParseFileSystemVersion(value) {
+  try {
+    return parseFileSystemVersion(value);
+  } catch {
+    return null;
+  }
+}
+
+export {
+  parseFileSystemVersion,
+  tryParseFileSystemVersion
+};
+//# sourceMappingURL=chunk-AYZ4HN5M.js.map

package/dist/chunk-AYZ4HN5M.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filesystem/v2.ts"],"sourcesContent":["import type { FsError } from './fs-error.js';\nimport type { WorkspacePath } from './workspace-path.js';\n\n/**\n * Opaque provider-issued token representing one observed entry/tree state.\n * Tokens support equality only within the issuing provider; callers must not\n * parse them or assume a move or byte-identical rewrite changes the token.\n * A token need not be a content hash, but it must change whenever the issuing\n * provider observes a potentially different kind, payload, or descendant\n * state. Detection of non-cooperating external changes is bounded by the\n * backend's declared capabilities and metadata precision.\n */\ndeclare const fileSystemVersionBrand: unique symbol;\nexport type FileSystemVersion = string & {\n  readonly [fileSystemVersionBrand]: 'FileSystemVersion';\n};\n\n/** Validate/rebrand a version received from a provider transport. */\nexport function parseFileSystemVersion(value: unknown): FileSystemVersion {\n  if (typeof value !== 'string' || !value || value.length > 1024 || value.includes('\\0')) {\n    throw new TypeError('Filesystem version tokens must be non-empty bounded strings.');\n  }\n  return value as FileSystemVersion;\n}\n\nexport function tryParseFileSystemVersion(value: unknown): FileSystemVersion | null {\n  try {\n    return parseFileSystemVersion(value);\n  } catch {\n    return null;\n  }\n}\n\n/** `process` excludes this provider's local peers; `cross-context` also excludes cooperating tabs/processes. */\nexport type FileSystemAtomicity = 'none' | 'process' | 'cross-context';\nexport type FileSystemCaseSensitivity = 'sensitive' | 'insensitive' | 'platform';\nexport type FileSystemDurability = 'volatile' | 'best-effort' | 'durable';\nexport type FileSystemConditionalWriteStrength =\n  | 'none'\n  | 'process'\n  | 'cross-context'\n  | 'storage-atomic';\nexport type FileSystemSymlinkPolicy = 'unsupported' | 'reject' | 'follow-contained' | 'preserve';\n\n/** Serializable feature declaration; consumers never need provider instanceof checks. */\nexport interface FileSystemProviderCapabilities {\n  /** Isolation of one successful file replacement from cooperating writers. */\n  readonly writeAtomicity: FileSystemAtomicity;\n  /** Isolation of one successful source-to-destination move. */\n  readonly moveAtomicity: FileSystemAtomicity;\n  /** Writers excluded while one complete snapshot is captured. */\n  readonly snapshotAtomicity: FileSystemAtomicity;\n  /** Strongest boundary at which expectedVersion is checked with mutation. */\n  readonly conditionalWrite: FileSystemConditionalWriteStrength;\n  readonly recursiveRemove: boolean;\n  /** True only when watch has a real ready barrier and sequenced events. */\n  readonly watch: boolean;\n  readonly caseSensitivity: FileSystemCaseSensitivity;\n  readonly symlinkPolicy: FileSystemSymlinkPolicy;\n  readonly durability: FileSystemDurability;\n}\n\ninterface FileSystemEntrySnapshotBase {\n  readonly path: WorkspacePath;\n  readonly name: string;\n  readonly version: FileSystemVersion;\n  /** ISO-8601 timestamp supplied by the backend; versions remain authoritative. */\n  readonly lastModified: string;\n}\n\nexport interface FileSystemFileSnapshot extends FileSystemEntrySnapshotBase {\n  readonly kind: 'file';\n  readonly size: number;\n}\n\nexport interface FileSystemDirectorySnapshot extends FileSystemEntrySnapshotBase {\n  readonly kind: 'directory';\n  readonly size: null;\n}\n\nexport type FileSystemEntrySnapshot = FileSystemFileSnapshot | FileSystemDirectorySnapshot;\n\n/** A read always couples owned bytes to the exact metadata version they represent. */\nexport interface FileSystemFileRead {\n  readonly entry: FileSystemFileSnapshot;\n  readonly data: ArrayBuffer;\n}\n\nexport interface FileSystemSnapshotFile extends FileSystemFileSnapshot {\n  readonly data: ArrayBuffer;\n}\n\nexport type FileSystemSnapshotEntry = FileSystemSnapshotFile | FileSystemDirectorySnapshot;\n\n/**\n * Complete best-available tree traversal. `snapshotAtomicity` declares\n * whether concurrent local/cross-context mutations are excluded while it is\n * captured. Implementations must never expose aliased buffers.\n */\nexport interface FileSystemSnapshot {\n  readonly version: FileSystemVersion;\n  readonly entries: readonly FileSystemSnapshotEntry[];\n}\n\nexport type FileSystemWriteMode = 'upsert' | 'create' | 'replace';\n\nexport interface FileSystemWriteOptions {\n  /** Defaults to upsert. */\n  readonly mode?: FileSystemWriteMode;\n  /** Defaults to false so structure creation is never implicit. */\n  readonly createParents?: boolean;\n  /** null means the entry must not exist; a token requires an exact match. */\n  readonly expectedVersion?: FileSystemVersion | null;\n}\n\nexport type FileSystemCreateDirectoryMode = 'ensure' | 'create';\n\nexport interface FileSystemCreateDirectoryOptions {\n  /** Defaults to ensure (idempotently return an existing directory). */\n  readonly mode?: FileSystemCreateDirectoryMode;\n  /** Defaults to false. */\n  readonly createParents?: boolean;\n}\n\nexport interface FileSystemRemoveOptions {\n  /** Defaults to false; non-empty directories otherwise fail with not-empty. */\n  readonly recursive?: boolean;\n  /** Defaults to error. */\n  readonly missing?: 'ignore' | 'error';\n  readonly expectedVersion?: FileSystemVersion;\n}\n\nexport interface FileSystemRemoveResult {\n  readonly removed: boolean;\n  /** Version of the complete tree after the removal attempt. */\n  readonly version: FileSystemVersion;\n}\n\nexport interface FileSystemMoveOptions {\n  /** Defaults to false. Destinations are never overwritten. */\n  readonly createParents?: boolean;\n  readonly expectedVersion?: FileSystemVersion;\n}\n\nexport type FileSystemWatchEventType = 'created' | 'modified' | 'removed' | 'moved' | 'overflow';\nexport type FileSystemWatchEventOrigin = 'local' | 'external' | 'unknown';\n\ninterface FileSystemWatchEventBase {\n  readonly sequence: number;\n  readonly origin: FileSystemWatchEventOrigin;\n  readonly path: WorkspacePath;\n}\n\nexport interface FileSystemEntryWatchEvent extends FileSystemWatchEventBase {\n  readonly type: Exclude<FileSystemWatchEventType, 'overflow'>;\n  readonly kind: 'file' | 'directory';\n  readonly destinationPath: WorkspacePath | null;\n  readonly version: FileSystemVersion | null;\n  readonly previousVersion: FileSystemVersion | null;\n}\n\nexport interface FileSystemOverflowWatchEvent extends FileSystemWatchEventBase {\n  readonly type: 'overflow';\n  readonly kind: null;\n  readonly destinationPath: null;\n  readonly version: null;\n  readonly previousVersion: null;\n}\n\nexport type FileSystemWatchEvent = FileSystemEntryWatchEvent | FileSystemOverflowWatchEvent;\n\nexport type FileSystemWatchListener = (event: FileSystemWatchEvent) => void;\nexport type FileSystemWatchErrorListener = (error: FsError) => void;\n\nexport interface FileSystemWatchOptions {\n  readonly onError?: FileSystemWatchErrorListener;\n}\n\nexport interface FileSystemWatchSubscription {\n  readonly closed: boolean;\n  /** Resolves after the backend watch is installed and no initial event can be missed. */\n  readonly ready: Promise<void>;\n  /** Idempotent and awaitable so resource release can join provider shutdown. */\n  dispose(): Promise<void>;\n}\n\n/**\n * Correctness-first filesystem contract. Every logical path has exactly one\n * kind and one byte payload; conditional writes and lifecycle disposal are\n * mandatory rather than optional provider extensions.\n */\nexport interface FileSystemProviderV2 {\n  readonly id: string;\n  readonly label: string;\n  readonly capabilities: FileSystemProviderCapabilities;\n\n  /** Absence is represented only by null; permission/I/O/wrong-kind errors throw FsError. */\n  stat(path: WorkspacePath): Promise<FileSystemEntrySnapshot | null>;\n  /** Absence is represented only by null; a directory at path is type-mismatch. */\n  readFile(path: WorkspacePath): Promise<FileSystemFileRead | null>;\n  /** Missing paths and file paths throw; results are canonical and deterministic. */\n  readDirectory(path: WorkspacePath): Promise<readonly FileSystemEntrySnapshot[]>;\n\n  writeFile(\n    path: WorkspacePath,\n    data: ArrayBuffer | Uint8Array,\n    options?: FileSystemWriteOptions,\n  ): Promise<FileSystemFileSnapshot>;\n  createDirectory(\n    path: WorkspacePath,\n    options?: FileSystemCreateDirectoryOptions,\n  ): Promise<FileSystemDirectorySnapshot>;\n  remove(path: WorkspacePath, options?: FileSystemRemoveOptions): Promise<FileSystemRemoveResult>;\n  move(\n    oldPath: WorkspacePath,\n    newPath: WorkspacePath,\n    options?: FileSystemMoveOptions,\n  ): Promise<FileSystemEntrySnapshot>;\n\n  snapshot(): Promise<FileSystemSnapshot>;\n  /**\n   * Always returns a disposable subscription. When `capabilities.watch` is\n   * false, `ready` rejects with `FsError('not-supported')` and `onError`\n   * observes the same failure; callers can therefore use one cleanup path.\n   */\n  watch(\n    listener: FileSystemWatchListener,\n    options?: FileSystemWatchOptions,\n  ): FileSystemWatchSubscription;\n  dispose(): Promise<void>;\n}\n"],"mappings":";AAkBO,SAAS,uBAAuB,OAAmC;AACxE,MAAI,OAAO,UAAU,YAAY,CAAC,SAAS,MAAM,SAAS,QAAQ,MAAM,SAAS,IAAI,GAAG;AACtF,UAAM,IAAI,UAAU,8DAA8D;AAAA,EACpF;AACA,SAAO;AACT;AAEO,SAAS,0BAA0B,OAA0C;AAClF,MAAI;AACF,WAAO,uBAAuB,KAAK;AAAA,EACrC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/chunk-EGNDADXB.js

@@ -0,0 +1,111 @@
+import {
+  parseWorkspacePath
+} from "./chunk-SI2LU2RP.js";
+import {
+  getFileSystemProviderV2
+} from "./chunk-EZKJZUNJ.js";
+
+// src/filesystem/move-error.ts
+function locationFromPresence(source, destination) {
+  if (source === "unknown" || destination === "unknown") return "unknown";
+  if (source === "present" && destination === "present") return "both";
+  if (source === "present") return "source";
+  if (destination === "present") return "destination";
+  return "neither";
+}
+var FileSystemMoveRecoveryError = class extends Error {
+  constructor(sourcePath, destinationPath, state, moveError) {
+    super(
+      `The move did not restore one authoritative path. Entry location: ${locationFromPresence(
+        state.source,
+        state.destination
+      )}.`
+    );
+    this.sourcePath = sourcePath;
+    this.destinationPath = destinationPath;
+    this.state = state;
+    this.moveError = moveError;
+    this.code = "partial-move";
+    this.name = "FileSystemMoveRecoveryError";
+  }
+  get location() {
+    return locationFromPresence(this.state.source, this.state.destination);
+  }
+  /** Alias used by DocumentSession's document-retarget recovery protocol. */
+  get documentLocation() {
+    return this.location;
+  }
+};
+var FileSystemPartialMoveError = class extends Error {
+  constructor(sourcePath, destinationPath, companionSourcePath, companionDestinationPath, state, moveError, rollbackError) {
+    super(
+      `The document move could not be rolled back. Document location: ${locationFromPresence(
+        state.source,
+        state.destination
+      )}; companion location: ${locationFromPresence(
+        state.companionSource,
+        state.companionDestination
+      )}.`
+    );
+    this.sourcePath = sourcePath;
+    this.destinationPath = destinationPath;
+    this.companionSourcePath = companionSourcePath;
+    this.companionDestinationPath = companionDestinationPath;
+    this.state = state;
+    this.moveError = moveError;
+    this.rollbackError = rollbackError;
+    this.code = "partial-move";
+    this.name = "FileSystemPartialMoveError";
+  }
+  get documentLocation() {
+    return locationFromPresence(this.state.source, this.state.destination);
+  }
+  get companionLocation() {
+    return locationFromPresence(this.state.companionSource, this.state.companionDestination);
+  }
+};
+function isFileSystemPartialMoveError(error) {
+  return error instanceof FileSystemPartialMoveError;
+}
+function isFileSystemMoveRecoveryError(error) {
+  return error instanceof FileSystemMoveRecoveryError;
+}
+function isFileSystemMoveStateError(error) {
+  return isFileSystemMoveRecoveryError(error) || isFileSystemPartialMoveError(error);
+}
+async function probePath(provider, path) {
+  try {
+    const providerV2 = getFileSystemProviderV2(provider);
+    const present = providerV2 ? await providerV2.stat(parseWorkspacePath(path)) !== null : await provider.exists(path);
+    return present ? "present" : "missing";
+  } catch {
+    return "unknown";
+  }
+}
+async function describePartialMove(provider, sourcePath, destinationPath, companionSourcePath, companionDestinationPath) {
+  const [source, destination, companionSource, companionDestination] = await Promise.all([
+    probePath(provider, sourcePath),
+    probePath(provider, destinationPath),
+    probePath(provider, companionSourcePath),
+    probePath(provider, companionDestinationPath)
+  ]);
+  return { source, destination, companionSource, companionDestination };
+}
+async function describeEntryMove(provider, sourcePath, destinationPath) {
+  const [source, destination] = await Promise.all([
+    probePath(provider, sourcePath),
+    probePath(provider, destinationPath)
+  ]);
+  return { source, destination };
+}
+
+export {
+  FileSystemMoveRecoveryError,
+  FileSystemPartialMoveError,
+  isFileSystemPartialMoveError,
+  isFileSystemMoveRecoveryError,
+  isFileSystemMoveStateError,
+  describePartialMove,
+  describeEntryMove
+};
+//# sourceMappingURL=chunk-EGNDADXB.js.map

package/dist/chunk-EGNDADXB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filesystem/move-error.ts"],"sourcesContent":["import { getFileSystemProviderV2, type FileSystemProvider } from './types.js';\nimport { parseWorkspacePath } from './workspace-path.js';\n\nexport type FileSystemPathPresence = 'present' | 'missing' | 'unknown';\n\nexport interface FileSystemPartialMoveState {\n  readonly source: FileSystemPathPresence;\n  readonly destination: FileSystemPathPresence;\n  readonly companionSource: FileSystemPathPresence;\n  readonly companionDestination: FileSystemPathPresence;\n}\n\nexport type FileSystemMoveLocation = 'source' | 'destination' | 'both' | 'neither' | 'unknown';\n\nexport interface FileSystemEntryMoveState {\n  readonly source: FileSystemPathPresence;\n  readonly destination: FileSystemPathPresence;\n}\n\nfunction locationFromPresence(\n  source: FileSystemPathPresence,\n  destination: FileSystemPathPresence,\n): FileSystemMoveLocation {\n  if (source === 'unknown' || destination === 'unknown') return 'unknown';\n  if (source === 'present' && destination === 'present') return 'both';\n  if (source === 'present') return 'source';\n  if (destination === 'present') return 'destination';\n  return 'neither';\n}\n\n/**\n * One provider move failed without restoring a provable source-only state.\n * This is backend-neutral: callers must use `location`, never infer from the\n * original exception or a provider's advertised move atomicity.\n */\nexport class FileSystemMoveRecoveryError extends Error {\n  public readonly code = 'partial-move' as const;\n\n  public constructor(\n    public readonly sourcePath: string,\n    public readonly destinationPath: string,\n    public readonly state: FileSystemEntryMoveState,\n    public readonly moveError: unknown,\n  ) {\n    super(\n      `The move did not restore one authoritative path. Entry location: ${locationFromPresence(\n        state.source,\n        state.destination,\n      )}.`,\n    );\n    this.name = 'FileSystemMoveRecoveryError';\n  }\n\n  public get location(): FileSystemMoveLocation {\n    return locationFromPresence(this.state.source, this.state.destination);\n  }\n\n  /** Alias used by DocumentSession's document-retarget recovery protocol. */\n  public get documentLocation(): FileSystemMoveLocation {\n    return this.location;\n  }\n}\n\n/**\n * A compound document/companion move failed and the document rollback also\n * failed. Callers must use the recorded post-state instead of assuming the\n * original path is still authoritative.\n */\nexport class FileSystemPartialMoveError extends Error {\n  readonly code = 'partial-move' as const;\n\n  constructor(\n    readonly sourcePath: string,\n    readonly destinationPath: string,\n    readonly companionSourcePath: string,\n    readonly companionDestinationPath: string,\n    readonly state: FileSystemPartialMoveState,\n    readonly moveError: unknown,\n    readonly rollbackError: unknown,\n  ) {\n    super(\n      `The document move could not be rolled back. Document location: ${locationFromPresence(\n        state.source,\n        state.destination,\n      )}; companion location: ${locationFromPresence(\n        state.companionSource,\n        state.companionDestination,\n      )}.`,\n    );\n    this.name = 'FileSystemPartialMoveError';\n  }\n\n  get documentLocation(): FileSystemMoveLocation {\n    return locationFromPresence(this.state.source, this.state.destination);\n  }\n\n  get companionLocation(): FileSystemMoveLocation {\n    return locationFromPresence(this.state.companionSource, this.state.companionDestination);\n  }\n}\n\nexport function isFileSystemPartialMoveError(error: unknown): error is FileSystemPartialMoveError {\n  return error instanceof FileSystemPartialMoveError;\n}\n\nexport function isFileSystemMoveRecoveryError(\n  error: unknown,\n): error is FileSystemMoveRecoveryError {\n  return error instanceof FileSystemMoveRecoveryError;\n}\n\nexport function isFileSystemMoveStateError(\n  error: unknown,\n): error is FileSystemMoveRecoveryError | FileSystemPartialMoveError {\n  return isFileSystemMoveRecoveryError(error) || isFileSystemPartialMoveError(error);\n}\n\nasync function probePath(\n  provider: FileSystemProvider,\n  path: string,\n): Promise<FileSystemPathPresence> {\n  try {\n    const providerV2 = getFileSystemProviderV2(provider);\n    const present = providerV2\n      ? (await providerV2.stat(parseWorkspacePath(path))) !== null\n      : await provider.exists(path);\n    return present ? 'present' : 'missing';\n  } catch {\n    return 'unknown';\n  }\n}\n\nexport async function describePartialMove(\n  provider: FileSystemProvider,\n  sourcePath: string,\n  destinationPath: string,\n  companionSourcePath: string,\n  companionDestinationPath: string,\n): Promise<FileSystemPartialMoveState> {\n  const [source, destination, companionSource, companionDestination] = await Promise.all([\n    probePath(provider, sourcePath),\n    probePath(provider, destinationPath),\n    probePath(provider, companionSourcePath),\n    probePath(provider, companionDestinationPath),\n  ]);\n  return { source, destination, companionSource, companionDestination };\n}\n\nexport async function describeEntryMove(\n  provider: FileSystemProvider,\n  sourcePath: string,\n  destinationPath: string,\n): Promise<FileSystemEntryMoveState> {\n  const [source, destination] = await Promise.all([\n    probePath(provider, sourcePath),\n    probePath(provider, destinationPath),\n  ]);\n  return { source, destination };\n}\n"],"mappings":";;;;;;;;AAmBA,SAAS,qBACP,QACA,aACwB;AACxB,MAAI,WAAW,aAAa,gBAAgB,UAAW,QAAO;AAC9D,MAAI,WAAW,aAAa,gBAAgB,UAAW,QAAO;AAC9D,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,gBAAgB,UAAW,QAAO;AACtC,SAAO;AACT;AAOO,IAAM,8BAAN,cAA0C,MAAM;AAAA,EAG9C,YACW,YACA,iBACA,OACA,WAChB;AACA;AAAA,MACE,oEAAoE;AAAA,QAClE,MAAM;AAAA,QACN,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAVgB;AACA;AACA;AACA;AANlB,SAAgB,OAAO;AAcrB,SAAK,OAAO;AAAA,EACd;AAAA,EAEA,IAAW,WAAmC;AAC5C,WAAO,qBAAqB,KAAK,MAAM,QAAQ,KAAK,MAAM,WAAW;AAAA,EACvE;AAAA;AAAA,EAGA,IAAW,mBAA2C;AACpD,WAAO,KAAK;AAAA,EACd;AACF;AAOO,IAAM,6BAAN,cAAyC,MAAM;AAAA,EAGpD,YACW,YACA,iBACA,qBACA,0BACA,OACA,WACA,eACT;AACA;AAAA,MACE,kEAAkE;AAAA,QAChE,MAAM;AAAA,QACN,MAAM;AAAA,MACR,CAAC,yBAAyB;AAAA,QACxB,MAAM;AAAA,QACN,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAhBS;AACA;AACA;AACA;AACA;AACA;AACA;AATX,SAAS,OAAO;AAoBd,SAAK,OAAO;AAAA,EACd;AAAA,EAEA,IAAI,mBAA2C;AAC7C,WAAO,qBAAqB,KAAK,MAAM,QAAQ,KAAK,MAAM,WAAW;AAAA,EACvE;AAAA,EAEA,IAAI,oBAA4C;AAC9C,WAAO,qBAAqB,KAAK,MAAM,iBAAiB,KAAK,MAAM,oBAAoB;AAAA,EACzF;AACF;AAEO,SAAS,6BAA6B,OAAqD;AAChG,SAAO,iBAAiB;AAC1B;AAEO,SAAS,8BACd,OACsC;AACtC,SAAO,iBAAiB;AAC1B;AAEO,SAAS,2BACd,OACmE;AACnE,SAAO,8BAA8B,KAAK,KAAK,6BAA6B,KAAK;AACnF;AAEA,eAAe,UACb,UACA,MACiC;AACjC,MAAI;AACF,UAAM,aAAa,wBAAwB,QAAQ;AACnD,UAAM,UAAU,aACX,MAAM,WAAW,KAAK,mBAAmB,IAAI,CAAC,MAAO,OACtD,MAAM,SAAS,OAAO,IAAI;AAC9B,WAAO,UAAU,YAAY;AAAA,EAC/B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAsB,oBACpB,UACA,YACA,iBACA,qBACA,0BACqC;AACrC,QAAM,CAAC,QAAQ,aAAa,iBAAiB,oBAAoB,IAAI,MAAM,QAAQ,IAAI;AAAA,IACrF,UAAU,UAAU,UAAU;AAAA,IAC9B,UAAU,UAAU,eAAe;AAAA,IACnC,UAAU,UAAU,mBAAmB;AAAA,IACvC,UAAU,UAAU,wBAAwB;AAAA,EAC9C,CAAC;AACD,SAAO,EAAE,QAAQ,aAAa,iBAAiB,qBAAqB;AACtE;AAEA,eAAsB,kBACpB,UACA,YACA,iBACmC;AACnC,QAAM,CAAC,QAAQ,WAAW,IAAI,MAAM,QAAQ,IAAI;AAAA,IAC9C,UAAU,UAAU,UAAU;AAAA,IAC9B,UAAU,UAAU,eAAe;AAAA,EACrC,CAAC;AACD,SAAO,EAAE,QAAQ,YAAY;AAC/B;","names":[]}

package/dist/chunk-EZKJZUNJ.js

@@ -0,0 +1,13 @@
+// src/filesystem/types.ts
+function hasFileSystemProviderV2(provider) {
+  return provider.v2 !== void 0 && provider.v2 !== null;
+}
+function getFileSystemProviderV2(provider) {
+  return provider.v2 ?? null;
+}
+
+export {
+  hasFileSystemProviderV2,
+  getFileSystemProviderV2
+};
+//# sourceMappingURL=chunk-EZKJZUNJ.js.map

package/dist/chunk-EZKJZUNJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filesystem/types.ts"],"sourcesContent":["/**\n * FileSystemProvider — abstract interface for a virtual filesystem.\n *\n * Legacy text-oriented facade retained while consumers migrate to\n * FileSystemProviderV2. New persistence code must use the provider's `v2`\n * contract so paths, errors, operation modes, and capabilities are explicit.\n */\n\n// ── Entry types ────────────────────────────────────────────────────\n\nimport type { FileSystemProviderV2 } from './v2.js';\n\nexport interface FileEntry {\n  kind: 'file';\n  name: string;\n  path: string;\n}\n\nexport interface FolderEntry {\n  kind: 'directory';\n  name: string;\n  path: string;\n}\n\nexport type FileSystemEntry = FileEntry | FolderEntry;\n\nexport interface FileMeta {\n  name: string;\n  path: string;\n  size: number;\n  lastModified: string;\n}\n\nexport type FileCommitResult =\n  | { status: 'committed'; version: string | null }\n  | { status: 'conflict'; content: string | null; version: string | null };\n\n// ── Provider interface ─────────────────────────────────────────────\n\n/**\n * @deprecated Compatibility facade for external providers and older callers.\n * Implement new backends with `FileSystemProviderV2`; built-in facades expose\n * their authoritative implementation through `v2`.\n */\nexport interface FileSystemProvider {\n  /** Unique identifier for this provider instance. */\n  readonly id: string;\n\n  /** Human-readable label (e.g., folder name or \"Browser Storage\"). */\n  readonly label: string;\n\n  /** Optional correctness-first implementation exposed during the v1-to-v2 migration. */\n  readonly v2?: FileSystemProviderV2;\n\n  /** Read the text content of a file. Returns null if the file doesn't exist. */\n  readFile(path: string): Promise<string | null>;\n\n  /** Write text content to a file, creating it (and parent dirs) if needed. */\n  writeFile(path: string, content: string): Promise<void>;\n\n  /**\n   * Conditionally replace a text file when it still matches the caller's\n   * persisted baseline. Production providers implement this at their\n   * strongest available serialization boundary.\n   */\n  commitFile?(\n    path: string,\n    content: string,\n    expectedContent: string | null,\n  ): Promise<FileCommitResult>;\n\n  /**\n   * Legacy recursive removal of a file or directory subtree. Workspace root\n   * deletion is forbidden. Prefer v2 `remove({ recursive })`.\n   */\n  delete(path: string): Promise<void>;\n\n  /** Rename or move an entry. Rejects missing sources and existing destinations. */\n  rename(oldPath: string, newPath: string): Promise<void>;\n\n  /** List immediate children of a directory. */\n  readDirectory(path: string): Promise<FileSystemEntry[]>;\n\n  /** Check whether a path exists. */\n  exists(path: string): Promise<boolean>;\n\n  /** Create a directory (and parents if needed). */\n  createDirectory(path: string): Promise<void>;\n\n  /** Get metadata for a file. Returns null if not found. */\n  stat(path: string): Promise<FileMeta | null>;\n\n  /** Read raw binary content. Returns null if not found. */\n  readBinary(path: string): Promise<ArrayBuffer | null>;\n\n  /** Write raw binary content. */\n  writeBinary(path: string, data: ArrayBuffer | Uint8Array): Promise<void>;\n}\n\nexport type FileSystemProviderWithV2 = FileSystemProvider & {\n  readonly v2: FileSystemProviderV2;\n};\n\n/** Discover a provider-owned v2 implementation without coupling consumers to a concrete class. */\nexport function hasFileSystemProviderV2(\n  provider: FileSystemProvider,\n): provider is FileSystemProviderWithV2 {\n  return provider.v2 !== undefined && provider.v2 !== null;\n}\n\n/** Return the provider-owned v2 implementation when migration support is available. */\nexport function getFileSystemProviderV2(provider: FileSystemProvider): FileSystemProviderV2 | null {\n  return provider.v2 ?? null;\n}\n"],"mappings":";AAwGO,SAAS,wBACd,UACsC;AACtC,SAAO,SAAS,OAAO,UAAa,SAAS,OAAO;AACtD;AAGO,SAAS,wBAAwB,UAA2D;AACjG,SAAO,SAAS,MAAM;AACxB;","names":[]}

package/dist/chunk-FNW556FN.js

@@ -0,0 +1,75 @@
+// src/host/wire-policy.ts
+var HOST_WIRE_LIMITS = Object.freeze({
+  identifierCharacters: 256,
+  labelCharacters: 1024,
+  pathCharacters: 4096,
+  urlCharacters: 8192,
+  messageCharacters: 2e3,
+  documentCharacters: 20 * 1024 * 1024,
+  binaryBytes: 100 * 1024 * 1024,
+  base64Characters: 140 * 1024 * 1024,
+  arrayEntries: 1e4
+});
+function hasExactKeys(value, keys) {
+  const actual = Object.keys(value);
+  return actual.length === keys.length && keys.every((key) => Object.prototype.hasOwnProperty.call(value, key));
+}
+function isBoundedString(value, maximumCharacters, minimumCharacters = 0) {
+  return typeof value === "string" && value.length >= minimumCharacters && value.length <= maximumCharacters && !value.includes("\0");
+}
+function isBoundedBytePayload(value, maximumBytes = HOST_WIRE_LIMITS.binaryBytes) {
+  return (value instanceof ArrayBuffer || value instanceof Uint8Array) && value.byteLength <= maximumBytes;
+}
+function parseOpenRequest(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return null;
+  const record = value;
+  if (record.kind === "workspace-file") {
+    if (!hasExactKeys(record, ["kind", "workspaceId", "path"])) return null;
+    if (!isBoundedString(record.workspaceId, HOST_WIRE_LIMITS.identifierCharacters, 1)) return null;
+    if (!isBoundedString(record.path, HOST_WIRE_LIMITS.pathCharacters, 1)) return null;
+    return { kind: "workspace-file", workspaceId: record.workspaceId, path: record.path };
+  }
+  if (record.kind === "external-file" || record.kind === "external-bundle") {
+    if (!hasExactKeys(record, ["kind", "resourceId", "name"])) return null;
+    if (!isBoundedString(record.resourceId, HOST_WIRE_LIMITS.identifierCharacters, 1)) return null;
+    if (!isBoundedString(record.name, HOST_WIRE_LIMITS.labelCharacters, 1)) return null;
+    return { kind: record.kind, resourceId: record.resourceId, name: record.name };
+  }
+  return null;
+}
+function parseExternalHttpUrl(value) {
+  if (!isBoundedString(value, HOST_WIRE_LIMITS.urlCharacters, 1)) return null;
+  try {
+    const url = new URL(value);
+    if (url.protocol !== "http:" && url.protocol !== "https:") return null;
+    if (url.username || url.password) return null;
+    const canonical = url.href;
+    return canonical.length <= HOST_WIRE_LIMITS.urlCharacters ? canonical : null;
+  } catch {
+    return null;
+  }
+}
+function isTrustedRendererUrl(value, developmentOrigin) {
+  if (!isBoundedString(value, HOST_WIRE_LIMITS.urlCharacters, 1)) return false;
+  try {
+    const url = new URL(value);
+    if (url.protocol === "app:" && url.hostname === "docblocks" && url.port === "" && url.username === "" && url.password === "") {
+      return true;
+    }
+    if (!developmentOrigin) return false;
+    const trustedDevelopmentOrigin = new URL(developmentOrigin);
+    return url.origin === trustedDevelopmentOrigin.origin;
+  } catch {
+    return false;
+  }
+}
+
+export {
+  HOST_WIRE_LIMITS,
+  isBoundedString,
+  isBoundedBytePayload,
+  parseOpenRequest,
+  parseExternalHttpUrl,
+  isTrustedRendererUrl
+};
+//# sourceMappingURL=chunk-FNW556FN.js.map

package/dist/chunk-FNW556FN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/host/wire-policy.ts"],"sourcesContent":["import type { OpenRequest } from './types.js';\n\n/** Quantitative limits shared by privileged host boundaries. */\nexport const HOST_WIRE_LIMITS = Object.freeze({\n  identifierCharacters: 256,\n  labelCharacters: 1_024,\n  pathCharacters: 4_096,\n  urlCharacters: 8_192,\n  messageCharacters: 2_000,\n  documentCharacters: 20 * 1024 * 1024,\n  binaryBytes: 100 * 1024 * 1024,\n  base64Characters: 140 * 1024 * 1024,\n  arrayEntries: 10_000,\n});\n\nfunction hasExactKeys(value: Record<string, unknown>, keys: readonly string[]): boolean {\n  const actual = Object.keys(value);\n  return (\n    actual.length === keys.length &&\n    keys.every((key) => Object.prototype.hasOwnProperty.call(value, key))\n  );\n}\n\nexport function isBoundedString(\n  value: unknown,\n  maximumCharacters: number,\n  minimumCharacters = 0,\n): value is string {\n  return (\n    typeof value === 'string' &&\n    value.length >= minimumCharacters &&\n    value.length <= maximumCharacters &&\n    !value.includes('\\0')\n  );\n}\n\nexport function isBoundedBytePayload(\n  value: unknown,\n  maximumBytes = HOST_WIRE_LIMITS.binaryBytes,\n): value is ArrayBuffer | Uint8Array {\n  return (\n    (value instanceof ArrayBuffer || value instanceof Uint8Array) &&\n    value.byteLength <= maximumBytes\n  );\n}\n\n/** Parse one exact, bounded main-to-renderer open request. */\nexport function parseOpenRequest(value: unknown): OpenRequest | null {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) return null;\n  const record = value as Record<string, unknown>;\n\n  if (record.kind === 'workspace-file') {\n    if (!hasExactKeys(record, ['kind', 'workspaceId', 'path'])) return null;\n    if (!isBoundedString(record.workspaceId, HOST_WIRE_LIMITS.identifierCharacters, 1)) return null;\n    if (!isBoundedString(record.path, HOST_WIRE_LIMITS.pathCharacters, 1)) return null;\n    return { kind: 'workspace-file', workspaceId: record.workspaceId, path: record.path };\n  }\n\n  if (record.kind === 'external-file' || record.kind === 'external-bundle') {\n    if (!hasExactKeys(record, ['kind', 'resourceId', 'name'])) return null;\n    if (!isBoundedString(record.resourceId, HOST_WIRE_LIMITS.identifierCharacters, 1)) return null;\n    if (!isBoundedString(record.name, HOST_WIRE_LIMITS.labelCharacters, 1)) return null;\n    return { kind: record.kind, resourceId: record.resourceId, name: record.name };\n  }\n\n  return null;\n}\n\n/** Return one canonical HTTP(S) URL, or null when external navigation is unsafe. */\nexport function parseExternalHttpUrl(value: unknown): string | null {\n  if (!isBoundedString(value, HOST_WIRE_LIMITS.urlCharacters, 1)) return null;\n  try {\n    const url = new URL(value);\n    if (url.protocol !== 'http:' && url.protocol !== 'https:') return null;\n    if (url.username || url.password) return null;\n    const canonical = url.href;\n    return canonical.length <= HOST_WIRE_LIMITS.urlCharacters ? canonical : null;\n  } catch {\n    return null;\n  }\n}\n\n/** True only for the packaged renderer origin or the exact configured dev origin. */\nexport function isTrustedRendererUrl(value: unknown, developmentOrigin?: string): boolean {\n  if (!isBoundedString(value, HOST_WIRE_LIMITS.urlCharacters, 1)) return false;\n  try {\n    const url = new URL(value);\n    if (\n      url.protocol === 'app:' &&\n      url.hostname === 'docblocks' &&\n      url.port === '' &&\n      url.username === '' &&\n      url.password === ''\n    ) {\n      return true;\n    }\n    if (!developmentOrigin) return false;\n    const trustedDevelopmentOrigin = new URL(developmentOrigin);\n    return url.origin === trustedDevelopmentOrigin.origin;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";AAGO,IAAM,mBAAmB,OAAO,OAAO;AAAA,EAC5C,sBAAsB;AAAA,EACtB,iBAAiB;AAAA,EACjB,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,mBAAmB;AAAA,EACnB,oBAAoB,KAAK,OAAO;AAAA,EAChC,aAAa,MAAM,OAAO;AAAA,EAC1B,kBAAkB,MAAM,OAAO;AAAA,EAC/B,cAAc;AAChB,CAAC;AAED,SAAS,aAAa,OAAgC,MAAkC;AACtF,QAAM,SAAS,OAAO,KAAK,KAAK;AAChC,SACE,OAAO,WAAW,KAAK,UACvB,KAAK,MAAM,CAAC,QAAQ,OAAO,UAAU,eAAe,KAAK,OAAO,GAAG,CAAC;AAExE;AAEO,SAAS,gBACd,OACA,mBACA,oBAAoB,GACH;AACjB,SACE,OAAO,UAAU,YACjB,MAAM,UAAU,qBAChB,MAAM,UAAU,qBAChB,CAAC,MAAM,SAAS,IAAI;AAExB;AAEO,SAAS,qBACd,OACA,eAAe,iBAAiB,aACG;AACnC,UACG,iBAAiB,eAAe,iBAAiB,eAClD,MAAM,cAAc;AAExB;AAGO,SAAS,iBAAiB,OAAoC;AACnE,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,QAAM,SAAS;AAEf,MAAI,OAAO,SAAS,kBAAkB;AACpC,QAAI,CAAC,aAAa,QAAQ,CAAC,QAAQ,eAAe,MAAM,CAAC,EAAG,QAAO;AACnE,QAAI,CAAC,gBAAgB,OAAO,aAAa,iBAAiB,sBAAsB,CAAC,EAAG,QAAO;AAC3F,QAAI,CAAC,gBAAgB,OAAO,MAAM,iBAAiB,gBAAgB,CAAC,EAAG,QAAO;AAC9E,WAAO,EAAE,MAAM,kBAAkB,aAAa,OAAO,aAAa,MAAM,OAAO,KAAK;AAAA,EACtF;AAEA,MAAI,OAAO,SAAS,mBAAmB,OAAO,SAAS,mBAAmB;AACxE,QAAI,CAAC,aAAa,QAAQ,CAAC,QAAQ,cAAc,MAAM,CAAC,EAAG,QAAO;AAClE,QAAI,CAAC,gBAAgB,OAAO,YAAY,iBAAiB,sBAAsB,CAAC,EAAG,QAAO;AAC1F,QAAI,CAAC,gBAAgB,OAAO,MAAM,iBAAiB,iBAAiB,CAAC,EAAG,QAAO;AAC/E,WAAO,EAAE,MAAM,OAAO,MAAM,YAAY,OAAO,YAAY,MAAM,OAAO,KAAK;AAAA,EAC/E;AAEA,SAAO;AACT;AAGO,SAAS,qBAAqB,OAA+B;AAClE,MAAI,CAAC,gBAAgB,OAAO,iBAAiB,eAAe,CAAC,EAAG,QAAO;AACvE,MAAI;AACF,UAAM,MAAM,IAAI,IAAI,KAAK;AACzB,QAAI,IAAI,aAAa,WAAW,IAAI,aAAa,SAAU,QAAO;AAClE,QAAI,IAAI,YAAY,IAAI,SAAU,QAAO;AACzC,UAAM,YAAY,IAAI;AACtB,WAAO,UAAU,UAAU,iBAAiB,gBAAgB,YAAY;AAAA,EAC1E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,SAAS,qBAAqB,OAAgB,mBAAqC;AACxF,MAAI,CAAC,gBAAgB,OAAO,iBAAiB,eAAe,CAAC,EAAG,QAAO;AACvE,MAAI;AACF,UAAM,MAAM,IAAI,IAAI,KAAK;AACzB,QACE,IAAI,aAAa,UACjB,IAAI,aAAa,eACjB,IAAI,SAAS,MACb,IAAI,aAAa,MACjB,IAAI,aAAa,IACjB;AACA,aAAO;AAAA,IACT;AACA,QAAI,CAAC,kBAAmB,QAAO;AAC/B,UAAM,2BAA2B,IAAI,IAAI,iBAAiB;AAC1D,WAAO,IAAI,WAAW,yBAAyB;AAAA,EACjD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}