agentic-mermaid 0.3.2 → 0.4.0

package/dist/{chunk-GX7UT56Q.js → chunk-M3VTTD3Q.js}

@@ -93,7 +93,7 @@ import {
   visualWidth,
   wcagCssContrastRatio,
   wrapperPrefix
-} from "./chunk-3D4EHVQ4.js";
+} from "./chunk-PG4PTPJL.js";
 
 // src/agent/trace-log.ts
 var appendFn;
@@ -4712,4 +4712,4 @@ export {
   layoutMermaidWithReceipt,
   layoutMermaid
 };
-//# sourceMappingURL=chunk-GX7UT56Q.js.map
+//# sourceMappingURL=chunk-M3VTTD3Q.js.map

package/dist/{chunk-3D4EHVQ4.js → chunk-PG4PTPJL.js}

@@ -174,7 +174,7 @@ function negotiateRenderCapabilityTuple(output, tuple) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.3.2";
+var PACKAGE_VERSION = "0.4.0";
 
 // src/shared/extension-identity.ts
 function sameExtensionIdentity(left, right2) {
@@ -524,7 +524,7 @@ var SCENE_ROLE_DESCRIPTORS = Object.freeze(
       id: `role:${role}`,
       kind: "role",
       version: "1.0.0",
-      compatibility: { core: "^0.3.0", scene: "^2.0.0" },
+      compatibility: { core: "^0.4.0", scene: "^2.0.0" },
       provenance: { owner: "agentic-mermaid", source: "built-in", reference: "src/scene/roles.ts" }
     }),
     role,
@@ -28659,7 +28659,7 @@ ${pageRect}` : sceneNodeSerialization(part)).join("\n");
   }
 };
 var CORE_BACKEND_VERSION = "1.0.0";
-var CORE_BACKEND_COMPATIBILITY = Object.freeze({ core: "^0.3.0", scene: "^2.0.0" });
+var CORE_BACKEND_COMPATIBILITY = Object.freeze({ core: "^0.4.0", scene: "^2.0.0" });
 var CORE_BACKEND_PROVENANCE = Object.freeze({
   owner: "agentic-mermaid",
   source: "built-in",
@@ -30628,7 +30628,7 @@ var INTERNAL_STYLE_FACE_PROJECTION = Object.freeze({
   group: Object.freeze({ sourceRole: "group", fields: Object.freeze([...INTERNAL_TEXT_FACE_FIELDS, ...INTERNAL_BOX_FACE_FIELDS, "fontFamily", "headerFillColor"]) })
 });
 var CORE_STYLE_VERSION = "1.0.0";
-var CORE_STYLE_COMPATIBILITY = Object.freeze({ core: "^0.3.0" });
+var CORE_STYLE_COMPATIBILITY = Object.freeze({ core: "^0.4.0" });
 var CORE_STYLE_PROVENANCE = Object.freeze({
   owner: "agentic-mermaid",
   source: "built-in",
@@ -56179,7 +56179,7 @@ function completeBuiltinDescriptor(seed) {
       id: `family:${seed.id}`,
       kind: "family",
       version: "1.0.0",
-      compatibility: { core: "^0.3.0" },
+      compatibility: { core: "^0.4.0" },
       provenance: { owner: "agentic-mermaid", source: "built-in" }
     }),
     collisionPriority: 100,
@@ -60928,7 +60928,7 @@ var HOSTED_FONT_RESOURCES = Object.freeze(
       id: `resource:${fontResourceLocalId(face)}`,
       kind: "resource",
       version: "1.0.0",
-      compatibility: { core: "^0.3.0" },
+      compatibility: { core: "^0.4.0" },
       provenance: { owner: "agentic-mermaid", source: "bundled", reference: `assets/fonts/${face.file}` }
     })
   }))
@@ -62033,4 +62033,4 @@ export {
   renderMermaidSVGWithReceipt,
   renderMermaidSVGAsync
 };
-//# sourceMappingURL=chunk-3D4EHVQ4.js.map
+//# sourceMappingURL=chunk-PG4PTPJL.js.map

package/dist/{chunk-R5U67OIW.js → chunk-QWCD67AZ.js}

@@ -1,12 +1,12 @@
 import {
   renderMermaidPNG
-} from "./chunk-YWKCUBQN.js";
+} from "./chunk-UKLKEZBJ.js";
 import {
   collectActionRecords,
   layoutMermaid,
   renderMermaidASCIIWithMeta,
   renderMermaidSVG
-} from "./chunk-GX7UT56Q.js";
+} from "./chunk-M3VTTD3Q.js";
 import {
   SHARED_RENDER_OPTION_FIELDS,
   decodedSvgAttributeValue,
@@ -15,7 +15,7 @@ import {
   prepareRenderInput,
   scanSvgStartTags,
   toFinite
-} from "./chunk-3D4EHVQ4.js";
+} from "./chunk-PG4PTPJL.js";
 
 // src/agent/index.ts
 function sharedRenderOptions(options) {
@@ -146,4 +146,4 @@ function renderMermaidWithActions(input, request) {
 export {
   renderMermaidWithActions
 };
-//# sourceMappingURL=chunk-R5U67OIW.js.map
+//# sourceMappingURL=chunk-QWCD67AZ.js.map

package/dist/{chunk-IVN6KP3W.js → chunk-SDJYD4OP.js}

@@ -1,7 +1,7 @@
 import {
   AsciiWidthError,
   MermaidFamilyDetectionError
-} from "./chunk-3D4EHVQ4.js";
+} from "./chunk-PG4PTPJL.js";
 
 // src/render-error-diagnostic.ts
 function projectKnownRenderErrorDiagnostic(error) {
@@ -34,4 +34,4 @@ export {
   projectKnownRenderErrorDiagnostic,
   projectRenderErrorDiagnostic
 };
-//# sourceMappingURL=chunk-IVN6KP3W.js.map
+//# sourceMappingURL=chunk-SDJYD4OP.js.map

package/dist/{chunk-YWKCUBQN.js → chunk-UKLKEZBJ.js}

@@ -13,7 +13,7 @@ import {
   renderPngGraphicalProjection,
   snapshotHostBackendPolicy,
   snapshotResourceManifest
-} from "./chunk-3D4EHVQ4.js";
+} from "./chunk-PG4PTPJL.js";
 
 // src/agent/png.ts
 import { fileURLToPath } from "url";
@@ -612,4 +612,4 @@ export {
   renderMermaidPNGWithReceipt,
   createMermaidPNGRenderer
 };
-//# sourceMappingURL=chunk-YWKCUBQN.js.map
+//# sourceMappingURL=chunk-UKLKEZBJ.js.map

package/dist/{chunk-NE6JBHSE.js → chunk-WMFFVZ4Q.js}

@@ -1,11 +1,11 @@
 import {
   projectKnownRenderErrorDiagnostic,
   projectRenderErrorDiagnostic
-} from "./chunk-IVN6KP3W.js";
+} from "./chunk-SDJYD4OP.js";
 import {
   renderMermaidPNG,
   renderMermaidPNGWithReceipt
-} from "./chunk-YWKCUBQN.js";
+} from "./chunk-UKLKEZBJ.js";
 import {
   analyzeMermaid,
   analyzeMermaidSource,
@@ -31,7 +31,7 @@ import {
   renderMermaidSVGWithReceipt,
   verifyMermaid,
   verifySummary
-} from "./chunk-GX7UT56Q.js";
+} from "./chunk-M3VTTD3Q.js";
 import {
   BUILTIN_FAMILY_METADATA,
   PACKAGE_VERSION,
@@ -71,7 +71,7 @@ import {
   styleSpecTypeScriptDeclaration,
   validateJsonConfigAdmission,
   validateSerializableRenderOptions
-} from "./chunk-3D4EHVQ4.js";
+} from "./chunk-PG4PTPJL.js";
 
 // src/mcp/server.ts
 import { randomUUID as randomUUID2 } from "crypto";
@@ -1407,19 +1407,6 @@ function modernRequestMetaProblems(req) {
 
 // src/mcp/admission.ts
 var admittedMcpMessage = /* @__PURE__ */ Symbol("AdmittedMcpMessage");
-function admitMcpHeaderVersion(headerVersion, supportedVersions) {
-  if (headerVersion === null || supportedVersions.includes(headerVersion)) return null;
-  return {
-    ok: false,
-    kind: "unsupported-version",
-    response: rpcError(
-      null,
-      UNSUPPORTED_PROTOCOL_VERSION,
-      `Unsupported protocol version: ${headerVersion}`,
-      { supported: [...supportedVersions], requested: headerVersion }
-    )
-  };
-}
 function responseId(raw, validId) {
   const value = raw.id;
   return validId && value !== void 0 ? value : null;
@@ -1455,10 +1442,6 @@ function admitMcpMessage(rawMessage, options) {
   const supportedVersions = options.protocolEra === "legacy" ? options.supportedVersions.filter(isLegacyProtocolVersion) : options.protocolEra === "modern" ? options.supportedVersions.filter(isModernProtocolVersion) : [...options.supportedVersions];
   const effectiveTransportVersion = options.negotiatedVersion ?? options.headerVersion ?? void 0;
   const provisionalProtocol = isModernProtocolVersion(declaredVersion) ? { era: "modern", version: declaredVersion, supportedVersions } : { era: "legacy", version: declaredVersion ?? effectiveTransportVersion, supportedVersions };
-  const headerAdmission = admitMcpHeaderVersion(options.headerVersion ?? null, supportedVersions);
-  if (headerAdmission) {
-    return { ...headerAdmission, protocol: provisionalProtocol, requestedEra };
-  }
   if (versionClaim.present && typeof versionClaim.value !== "string") {
     return rejection(
       "invalid-modern-metadata",
@@ -1468,6 +1451,20 @@ function admitMcpMessage(rawMessage, options) {
       "modern"
     );
   }
+  if (options.headerVersion != null && !supportedVersions.includes(options.headerVersion)) {
+    return rejection(
+      "unsupported-version",
+      notification,
+      rpcError(
+        id,
+        UNSUPPORTED_PROTOCOL_VERSION,
+        `Unsupported protocol version: ${options.headerVersion}`,
+        { supported: [...supportedVersions], requested: options.headerVersion }
+      ),
+      provisionalProtocol,
+      requestedEra
+    );
+  }
   if (options.negotiatedVersion != null && !supportedVersions.includes(options.negotiatedVersion)) {
     return rejection(
       "unsupported-version",
@@ -1544,14 +1541,24 @@ function admitMcpMessage(rawMessage, options) {
     if (!isModernProtocolVersion(declaredVersion)) {
       const problem = `params._meta.${META_PROTOCOL_VERSION} is required and must match the MCP-Protocol-Version header (${options.headerVersion})`;
       return rejection(
-        "header-mismatch",
+        "invalid-modern-metadata",
         notification,
-        rpcError(id, HEADER_MISMATCH, `Header mismatch: ${problem}`),
+        rpcError(id, -32602, `Invalid params: ${problem}`),
         provisionalProtocol,
         requestedEra
       );
     }
     const protocol2 = { era: "modern", version: declaredVersion, supportedVersions };
+    const metaProblems = modernRequestMetaProblems(request);
+    if (metaProblems.length > 0) {
+      return rejection(
+        "invalid-modern-metadata",
+        notification,
+        rpcError(id, -32602, `Invalid params: ${metaProblems.join("; ")}`),
+        protocol2,
+        requestedEra
+      );
+    }
     if (options.requireModernVersionHeader && options.headerVersion == null) {
       return rejection(
         "header-mismatch",
@@ -1575,16 +1582,6 @@ function admitMcpMessage(rawMessage, options) {
         requestedEra
       );
     }
-    const metaProblems = modernRequestMetaProblems(request);
-    if (metaProblems.length > 0) {
-      return rejection(
-        "invalid-modern-metadata",
-        notification,
-        rpcError(id, -32602, `Invalid params: ${metaProblems.join("; ")}`),
-        protocol2,
-        requestedEra
-      );
-    }
     return acceptance(request, id, notification, protocol2);
   }
   const protocol = {
@@ -1601,7 +1598,7 @@ function withClosedMcpInputSchema(tool) {
 }
 var MCP_SERVER_NAME = "agentic-mermaid-mcp";
 var MCP_SERVER_VERSION = PACKAGE_VERSION;
-var SERVER_CAPABILITIES = { tools: {}, prompts: {}, resources: {} };
+var SERVER_CAPABILITIES = { tools: {} };
 var PURE_COMPUTE_ANNOTATIONS = {
   readOnlyHint: true,
   destructiveHint: false,
@@ -1816,7 +1813,7 @@ function surfaceSupportedVersions(surface, options = {}) {
 }
 function discoverResult(surface, supportedVersions) {
   return {
-    supportedVersions: supportedVersions.filter(isModernProtocolVersion),
+    supportedVersions: [...supportedVersions],
     capabilities: SERVER_CAPABILITIES,
     instructions: surface.instructions
   };
@@ -1898,19 +1895,13 @@ async function dispatchAdmittedMcpRequest(message, context, surface) {
       response = await surface.handleToolCall(id, { ...req.params, arguments: args }, context);
       break;
     }
-    case "prompts/list":
-      response = reply(id, { prompts: [] });
-      break;
-    case "resources/list":
-      response = reply(id, { resources: [] });
-      break;
     default:
       response = unknownMethod(id, req.method);
   }
   return notification ? null : decorateMcpResult(response, req.method, era, surface.serverName ?? MCP_SERVER_NAME);
 }
 var LIST_RESULT_TTL_MS = 3e5;
-var CACHEABLE_METHODS = /* @__PURE__ */ new Set(["server/discover", "tools/list", "prompts/list", "resources/list"]);
+var CACHEABLE_METHODS = /* @__PURE__ */ new Set(["server/discover", "tools/list"]);
 function decorateMcpResult(response, method, era, serverName) {
   if (era !== "modern" || !response || !plainJsonObject(response.result)) return response;
   const existingMeta = plainJsonObject(response.result._meta) ? response.result._meta : {};
@@ -3488,7 +3479,7 @@ function safePath(root, name) {
 
 // src/mcp/server.ts
 var PROTOCOL_VERSION = "2024-11-05";
-var STDIO_PROTOCOL_VERSIONS = ["2024-11-05", "2025-03-26", "2025-06-18", "2025-11-25", "2026-07-28"];
+var STDIO_PROTOCOL_VERSIONS = ["2024-11-05", "2025-06-18", "2025-11-25", "2026-07-28"];
 var HTTP_SSE_PROTOCOL_VERSIONS = ["2024-11-05"];
 var HTTP_SSE_DISPATCH = { supportedVersions: HTTP_SSE_PROTOCOL_VERSIONS };
 var MAX_RPC_BODY_BYTES = 1024 * 1024;
@@ -4120,4 +4111,4 @@ export {
   parseMcpCliOptions,
   runMcpCli
 };
-//# sourceMappingURL=chunk-NE6JBHSE.js.map
+//# sourceMappingURL=chunk-WMFFVZ4Q.js.map

package/dist/{index-BFg_LoZS.d.ts → index-BoqfBufn.d.ts}

@@ -31,7 +31,7 @@ interface ExtensionIdentity<Kind extends string = string> {
 /** Host contract versions understood by this runtime. Requirements for other
  * namespaced contracts are retained but deliberately deferred to their owner. */
 declare const KNOWN_EXTENSION_CONTRACT_VERSIONS: Readonly<{
-    readonly core: "0.3.2";
+    readonly core: "0.4.0";
     readonly scene: "2.0.0";
 }>;
 interface ExtensionCompatibilityResolution {

package/dist/index.d.ts

@@ -1 +1 @@
-export { g0 as ARCHITECTURE_ICON_LIMITS, g as AnyPort, r as ArchitectureVisualOverrides, s as AsciiRenderColorMode, A as AsciiRenderOptions, t as AsciiWidthError, u as AsciiWidthErrorReason, B as BACKEND_CONFORMANCE_CHECK_IDS, v as BACKEND_CONFORMANCE_FIXTURE_ID, w as BACKEND_CONFORMANCE_VERSION, x as BINDABLE_ROLE_STYLE_PROPERTIES, y as BINDABLE_SCENE_ROLES, z as BRAND_CONSTRAINT_DESCRIPTORS, C as BRAND_CONSTRAINT_KINDS, g1 as BROWSER_CANVAS_RUNTIME, G as BUILTIN_SCENE_ROLE_TRAITS, I as BackendCapabilityConformanceResult, J as BackendCapabilityConformanceStatus, K as BackendConformanceCheck, L as BackendConformanceCheckId, M as BackendConformanceReport, N as BackendDescriptor, O as BackendRegistrationOptions, Q as BindableSceneRole, S as BrandConstraint, T as BrandConstraintAction, U as BrandConstraintKind, g2 as BrowserPngDiagnostic, g3 as BrowserPngFontSource, g4 as BrowserPngRasterContext, g5 as BrowserPngRasterResult, g6 as BrowserPngRasterizer, g7 as BrowserPngRuntimeProvenance, g8 as BuiltinSceneRole, X as CAPABILITY_NEGOTIATION_VERSION, Y as CORE_CAPABILITY_OFFERS, Z as CORE_SCENE_FEATURES, _ as CORE_SCENE_OPERATIONS, $ as CORE_SCENE_PRIMITIVES, a0 as CapabilityDecision, a1 as CapabilityId, a2 as CapabilityOffer, a3 as CapabilityRequirement, a4 as CapabilityRequirementLevel, a5 as CapabilityResolution, g9 as CapabilityValidationResult, ad as CliRenderTransport, ae as CodeModeRenderTransport, ga as ConfigDiagnostic, af as ConnectorContourSemantics, gb as ConnectorDash, gc as ConnectorDirection, gd as ConnectorEndpointAnchor, ag as ConnectorEndpoints, ah as ConnectorGeometry, ai as ConnectorHitGeometry, aj as ConnectorLabelDescriptor, ak as ConnectorMark, al as ConnectorRelationship, am as ConnectorRoute, an as ConnectorStroke, ao as ConnectorSubpath, ap as ConnectorTerminalLabelProjection, aq as ConnectorTerminalMarkerPlacement, ar as ConnectorTerminalMarkerProjection, as as ConnectorTerminalProjection, at as ConnectorTerminalStrokeLoss, ge as CoreSceneFeature, gf as CoreSceneOperation, gg as CoreScenePrimitive, gh as CoreSceneRole, gi as DEFAULTS, av as DefaultBackend, gj as DiagramColors, aB as DiamondFacet, gk as DocumentMark, gl as ESSENTIAL_SCENE_PRIMITIVE_CAPABILITIES, gm as ESSENTIAL_SCENE_PRIMITIVE_OPERATIONS, aC as EXACT_ROLE_STYLE_CONTRACT, aD as EXACT_STYLE_SCENE_ROLES, aE as EXTERNAL_SCENE_API_VERSION, aG as EdgeRouteCertificate, gn as EssentialScenePrimitiveCapability, go as EssentialScenePrimitiveOperation, aO as ExactStyleSceneRole, gp as ExtensionCollisionError, gq as ExtensionCompatibility, gr as ExtensionCompatibilityDecision, gs as ExtensionCompatibilityResolution, aP as ExtensionDiagramBody, aQ as ExtensionIdentity, gt as ExtensionProvenance, gu as ExtensionRegistration, aR as ExtensionValidDiagram, aT as ExternalSceneConnector, aU as ExternalSceneConnectorGeometry, aV as ExternalSceneConnectorLabel, aW as ExternalSceneContainer, aX as ExternalSceneDataMark, aY as ExternalSceneDocument, aZ as ExternalSceneGeometry, a_ as ExternalSceneInput, a$ as ExternalSceneMarker, b0 as ExternalSceneNode, b1 as ExternalSceneNodeBase, b2 as ExternalSceneShape, b3 as ExternalSceneText, bg as FamilyDetectionDiagnostic, bh as FamilyEdgeRouteCertificate, bo as FamilyRouteCertificate, gv as Geometry, gw as GitGraphBranch, gx as GitGraphCommit, gy as GitGraphCommitType, gz as GitGraphDiagram, gA as GitGraphDuplicateCommitError, gB as GitGraphParseError, gC as GitGraphRuntimeConfig, gD as GroupMark, bJ as HOSTED_FONT_RESOURCES, H as HostBackendPolicy, gE as HostBackendSelection, gF as HostedFontFace, gG as HostedFontResource, gH as JourneyRuntimeConfig, gI as KNOWN_EXTENSION_CONTRACT_VERSIONS, bQ as LayoutRouteCertificate, bR as LayoutRouteClass, bT as LibraryRenderTransport, bU as MAX_HOSTED_PNG_BYTES, bV as MAX_HOSTED_PNG_PIXELS, bW as MAX_PNG_FONT_DIRECTORIES, bX as MAX_PNG_FONT_DIRECTORY_LENGTH, bY as MAX_PNG_PIXELS, bZ as MAX_PNG_RASTER_DIMENSION, gJ as MarkPaint, b_ as MarkerDescriptor, gK as MarkerSerializationOptions, gL as MarkerShape, gM as MermaidBrowserPNGRenderer, gN as MermaidBrowserPNGRendererHostOptions, b$ as MermaidFamilyClassification, c0 as MermaidFamilyDetectionError, gO as MermaidGraph, gP as MermaidRenderer, gQ as MermaidRendererHostOptions, gR as MermaidRuntimeConfig, gS as MermaidThemeVariables, gT as MindmapDiagram, gU as MindmapDuplicateIdError, gV as MindmapNode, gW as MindmapParseError, gX as MindmapRuntimeConfig, gY as MindmapShape, c6 as NATIVE_PNG_HOST_ONLY_OPTION_FIELDS, c7 as NATIVE_PNG_OUTPUT_POLICY_FIELDS, gZ as NamespacedSceneRole, c8 as NativePngHostOnlyOptionField, c9 as NativePngOutputPolicyField, g_ as OUTPUT_COLOR_PROFILE, g$ as OUTPUT_SECURITY_POLICY_VERSION, h0 as OutputSecurityDiagnostic, h1 as OutputSecurityMode, h2 as OutputSecurityResult, cb as PNG_DEFAULT_FONT_FAMILY, cc as PNG_DEFAULT_SCALE, cd as PNG_FONT_SOURCES, ce as PNG_NAPI_RUNTIME, cf as PNG_OUTPUT_OPTION_FIELDS, cg as PNG_OUTPUT_OPTION_FIELD_DESCRIPTORS, ch as PNG_OUTPUT_POLICY_VERSION, ci as PNG_WASM_RUNTIME, cj as PORTABLE_PNG_OUTPUT_OPTION_FIELDS, ck as PRIMITIVE_REALIZATIONS, P as ParsedDiagram, h3 as ParsedDiagramFamilyMismatchError, h4 as PieRuntimeConfig, h5 as PngColorProfileReceipt, h6 as PngDimensions, cr as PngFitTo, cs as PngFontSource, ct as PngOutputOptionField, cu as PngOutputOptionFieldDescriptor, cv as PngOutputOptionInputKind, cw as PngOutputOptionPolicyState, cx as PngOutputOptionReceiptState, cy as PngOutputOptionScope, a as PngOutputPolicyInput, cz as PngRasterDimensions, c as PngRuntimeProvenance, cA as PortSemanticRole, cB as PortSide, cC as PortablePngOutputOptionField, cD as PortablePngOutputOptions, fX as PositionedDiagram, h7 as PositionedGitGraphDiagram, h8 as PositionedGraph, h9 as PositionedMindmapDiagram, cE as PreservedDiagramBody, cF as PreservedSourceSpans, cG as PreservedValidDiagram, ha as PrimitiveCapabilityClaim, hb as PrimitiveRealization, hc as QuadrantRuntimeConfig, cM as RENDER_CONTRACT_VERSION, cN as RENDER_OUTPUTS, cO as RENDER_OUTPUT_DESCRIPTORS, cP as RESOURCE_MANIFEST, cQ as RESOURCE_MANIFEST_VERSION, cR as ROLE_STYLE_PROPERTY_DESCRIPTORS, hd as RadarRuntimeConfig, cX as RegionContainmentCertificate, cY as RenderCapabilityError, he as RenderContext, R as RenderOptions, hf as RenderOutput, cZ as RenderOutputDescriptor, c_ as RenderOutputTransports, b as RenderRequestReceipt, hg as RenderableMarkerDescriptor, c$ as RenderedAscii, hh as RenderedBrowserPng, f$ as RenderedSvg, hi as ResolvedArchitectureIcon, hj as ResolvedColors, d5 as ResolvedPngOutputPolicy, hk as ResolvedSceneRoleTraits, d6 as ResolvedTerminalOutputPolicy, hl as ResolvedTerminalStyle, hm as ResourceLicense, hn as ResourceManifest, ho as ResourceManifestEntry, d8 as RoleStyleFor, d9 as RoleStyleSpec, da as RoleStyles, db as RouteBlocker, dc as RouteCertificate, dd as RouteClass, de as RoutePortAssignment, df as SCENE_CONTRACT_VERSION, dg as SCENE_ROLE_DESCRIPTORS, dh as SCENE_VALIDATION_LIMITS, di as SCENE_VALIDATION_VERSION, dj as SEMANTIC_BINDING_CHANNELS, dk as SHARED_RENDER_OPTION_FIELDS, dl as STYLE_COLOR_TOKEN_DESCRIPTORS, dm as STYLE_SPEC_FIELD_DESCRIPTORS, dn as STYLE_SPEC_FORMAT_VERSION, hp as SceneBox, hq as SceneConnectorHit, dp as SceneDoc, hr as SceneFeature, hs as SceneMarkKind, dq as SceneNode, ht as SceneNodeBase, hu as SceneOperation, hv as ScenePoint, hw as ScenePrimitive, dr as SceneRole, hx as SceneRoleDescriptor, hy as SceneRoleTraits, hz as SceneSketchPolicy, ds as SceneValidationDiagnostic, dt as SceneValidationDiagnosticCode, du as SceneValidationError, dv as SceneValidationOptions, dw as SceneValidationResult, dx as SemanticBinding, dy as SemanticBindingChannel, dz as SemanticChannels, dA as SemanticSlots, hA as ShapeMark, dM as SourceSpan, dN as SourceSpanPoint, hB as StateRuntimeConfig, dT as StyleBackend, dU as StyleBackendContext, dV as StyleColors, dW as StyleDescriptor, dX as StyleInput, dY as StyleReferenceResolution, dZ as StyleRegistrationOptions, hC as StyleRegistryKind, d_ as StyleSpec, hD as SvgRelationSemantics, hE as SvgSemanticAccessibility, hF as SvgSemanticIdentity, d$ as TERMINAL_BOUNDED_PADDING_X, e0 as TERMINAL_DEFAULT_BOX_BORDER_PADDING, e1 as TERMINAL_DEFAULT_PADDING_X, e2 as TERMINAL_DEFAULT_PADDING_Y, e3 as TERMINAL_OUTPUT_POLICY_VERSION, hG as TERMINAL_STYLE_VERSION, e4 as TEXT_MEASUREMENT_CONTRACT, hH as TerminalConnectorProjection, hI as TerminalConnectorProjectionReceipt, e5 as TerminalOutputPolicyError, e6 as TerminalOutputPolicyInput, hJ as TerminalProjectionDiagnostic, fY as TerminalProjectionDiagnosticCode, hK as TerminalProjectionSecurityContext, hL as TextMark, e7 as TextMeasurementContract, e8 as TextMeasurementInput, e9 as TextMeasurementResult, hM as TimelineRuntimeConfig, hN as XyChartRuntimeConfig, hO as applyOutputSecurityPolicy, hP as applyPngColorProfile, hQ as architectureIconManifest, hR as architectureToMermaidGraph, eV as assertHostedPngRasterBudget, eW as assertPngRasterBudget, hS as assertRenderableMarker, eX as assertValidSceneDoc, eY as buildExternalScene, hT as canonicalExtensionId, e_ as classifyMermaidFamilyFromFirstLine, hU as connectorHitDistance, e$ as createExtensionIdentity, hV as createMermaidBrowserPNGRenderer, hW as createMermaidRenderer, hX as essentialScenePrimitiveOperation, hY as evaluateExtensionCompatibility, hZ as fromShikiTheme, f5 as getBackend, f8 as getStyle, h_ as hitTestConnector, h$ as hitTestSceneConnectors, f9 as hostedFontResource, fa as inferBackend, i0 as inlineResolvedColors, i1 as inspectPngColorProfile, i2 as inspectPngDimensions, fd as knownBackendDescriptors, fg as knownStyleDescriptors, fh as knownStyles, fi as measureText, fj as measureTextWidth, fk as negotiateCapabilities, fl as negotiateRenderCapabilities, fm as normalizePortablePngBackground, fo as omitPngOutputOptions, i3 as parseArchitectureDiagram, i4 as parseExtensionId, i5 as parseGitGraph, i6 as parseMindmap, fp as parseRegisteredMermaid, fq as parseSemVer, fr as pngNapiRuntimeProvenance, fs as pngOutputOptionsJsonSchema, ft as pngRasterDimensions, fu as prepareSvgForPngRasterization, fv as projectNativePngOutputPolicyInput, fw as projectPortablePngOutputOptions, fx as registerBackend, i7 as registerExtension, fy as registerStyle, i8 as renderContractDigest, fZ as renderMermaidASCII, i9 as renderMermaidASCIIWithReceipt, ia as renderMermaidPNGInBrowserWithReceipt, f_ as renderMermaidSVG, ib as renderMermaidSVGAsync, ic as renderMermaidSVGWithReceipt, id as resolveArchitectureIcon, ie as resolveColors, ig as resolveDiagramColors, fz as resolvePngOutputPolicy, fA as resolvePortablePngOutputPolicy, fB as resolveSceneRoleTraits, fC as resolveStyleReference, fD as resolveStyleStack, fE as resolveTerminalOutputPolicy, fF as runBackendConformance, fG as sceneRoleTraits, fH as semVerSatisfies, ih as serializeGitGraph, ii as serializeMarkerResource, ij as serializeMarkerResources, ik as serializeMindmap, fI as sharedRenderOptionsJsonSchema, il as snapshotResourceManifest, fJ as styleInputJsonSchema, fK as styleSpecJsonSchema, fL as svgIntrinsicDimensions, fM as terminalConnectorCapabilityClaims, fO as validatePrimitiveCapabilities, fP as validateResourceManifest, fQ as validateSceneDoc, fR as validateSerializableRenderOptions, fS as validateStyleSpec, fT as verifyNoExternalRefs, fU as verifyResourceBytes, im as verifySvgDocumentEnvelope } from './index-BFg_LoZS.js';
+export { g0 as ARCHITECTURE_ICON_LIMITS, g as AnyPort, r as ArchitectureVisualOverrides, s as AsciiRenderColorMode, A as AsciiRenderOptions, t as AsciiWidthError, u as AsciiWidthErrorReason, B as BACKEND_CONFORMANCE_CHECK_IDS, v as BACKEND_CONFORMANCE_FIXTURE_ID, w as BACKEND_CONFORMANCE_VERSION, x as BINDABLE_ROLE_STYLE_PROPERTIES, y as BINDABLE_SCENE_ROLES, z as BRAND_CONSTRAINT_DESCRIPTORS, C as BRAND_CONSTRAINT_KINDS, g1 as BROWSER_CANVAS_RUNTIME, G as BUILTIN_SCENE_ROLE_TRAITS, I as BackendCapabilityConformanceResult, J as BackendCapabilityConformanceStatus, K as BackendConformanceCheck, L as BackendConformanceCheckId, M as BackendConformanceReport, N as BackendDescriptor, O as BackendRegistrationOptions, Q as BindableSceneRole, S as BrandConstraint, T as BrandConstraintAction, U as BrandConstraintKind, g2 as BrowserPngDiagnostic, g3 as BrowserPngFontSource, g4 as BrowserPngRasterContext, g5 as BrowserPngRasterResult, g6 as BrowserPngRasterizer, g7 as BrowserPngRuntimeProvenance, g8 as BuiltinSceneRole, X as CAPABILITY_NEGOTIATION_VERSION, Y as CORE_CAPABILITY_OFFERS, Z as CORE_SCENE_FEATURES, _ as CORE_SCENE_OPERATIONS, $ as CORE_SCENE_PRIMITIVES, a0 as CapabilityDecision, a1 as CapabilityId, a2 as CapabilityOffer, a3 as CapabilityRequirement, a4 as CapabilityRequirementLevel, a5 as CapabilityResolution, g9 as CapabilityValidationResult, ad as CliRenderTransport, ae as CodeModeRenderTransport, ga as ConfigDiagnostic, af as ConnectorContourSemantics, gb as ConnectorDash, gc as ConnectorDirection, gd as ConnectorEndpointAnchor, ag as ConnectorEndpoints, ah as ConnectorGeometry, ai as ConnectorHitGeometry, aj as ConnectorLabelDescriptor, ak as ConnectorMark, al as ConnectorRelationship, am as ConnectorRoute, an as ConnectorStroke, ao as ConnectorSubpath, ap as ConnectorTerminalLabelProjection, aq as ConnectorTerminalMarkerPlacement, ar as ConnectorTerminalMarkerProjection, as as ConnectorTerminalProjection, at as ConnectorTerminalStrokeLoss, ge as CoreSceneFeature, gf as CoreSceneOperation, gg as CoreScenePrimitive, gh as CoreSceneRole, gi as DEFAULTS, av as DefaultBackend, gj as DiagramColors, aB as DiamondFacet, gk as DocumentMark, gl as ESSENTIAL_SCENE_PRIMITIVE_CAPABILITIES, gm as ESSENTIAL_SCENE_PRIMITIVE_OPERATIONS, aC as EXACT_ROLE_STYLE_CONTRACT, aD as EXACT_STYLE_SCENE_ROLES, aE as EXTERNAL_SCENE_API_VERSION, aG as EdgeRouteCertificate, gn as EssentialScenePrimitiveCapability, go as EssentialScenePrimitiveOperation, aO as ExactStyleSceneRole, gp as ExtensionCollisionError, gq as ExtensionCompatibility, gr as ExtensionCompatibilityDecision, gs as ExtensionCompatibilityResolution, aP as ExtensionDiagramBody, aQ as ExtensionIdentity, gt as ExtensionProvenance, gu as ExtensionRegistration, aR as ExtensionValidDiagram, aT as ExternalSceneConnector, aU as ExternalSceneConnectorGeometry, aV as ExternalSceneConnectorLabel, aW as ExternalSceneContainer, aX as ExternalSceneDataMark, aY as ExternalSceneDocument, aZ as ExternalSceneGeometry, a_ as ExternalSceneInput, a$ as ExternalSceneMarker, b0 as ExternalSceneNode, b1 as ExternalSceneNodeBase, b2 as ExternalSceneShape, b3 as ExternalSceneText, bg as FamilyDetectionDiagnostic, bh as FamilyEdgeRouteCertificate, bo as FamilyRouteCertificate, gv as Geometry, gw as GitGraphBranch, gx as GitGraphCommit, gy as GitGraphCommitType, gz as GitGraphDiagram, gA as GitGraphDuplicateCommitError, gB as GitGraphParseError, gC as GitGraphRuntimeConfig, gD as GroupMark, bJ as HOSTED_FONT_RESOURCES, H as HostBackendPolicy, gE as HostBackendSelection, gF as HostedFontFace, gG as HostedFontResource, gH as JourneyRuntimeConfig, gI as KNOWN_EXTENSION_CONTRACT_VERSIONS, bQ as LayoutRouteCertificate, bR as LayoutRouteClass, bT as LibraryRenderTransport, bU as MAX_HOSTED_PNG_BYTES, bV as MAX_HOSTED_PNG_PIXELS, bW as MAX_PNG_FONT_DIRECTORIES, bX as MAX_PNG_FONT_DIRECTORY_LENGTH, bY as MAX_PNG_PIXELS, bZ as MAX_PNG_RASTER_DIMENSION, gJ as MarkPaint, b_ as MarkerDescriptor, gK as MarkerSerializationOptions, gL as MarkerShape, gM as MermaidBrowserPNGRenderer, gN as MermaidBrowserPNGRendererHostOptions, b$ as MermaidFamilyClassification, c0 as MermaidFamilyDetectionError, gO as MermaidGraph, gP as MermaidRenderer, gQ as MermaidRendererHostOptions, gR as MermaidRuntimeConfig, gS as MermaidThemeVariables, gT as MindmapDiagram, gU as MindmapDuplicateIdError, gV as MindmapNode, gW as MindmapParseError, gX as MindmapRuntimeConfig, gY as MindmapShape, c6 as NATIVE_PNG_HOST_ONLY_OPTION_FIELDS, c7 as NATIVE_PNG_OUTPUT_POLICY_FIELDS, gZ as NamespacedSceneRole, c8 as NativePngHostOnlyOptionField, c9 as NativePngOutputPolicyField, g_ as OUTPUT_COLOR_PROFILE, g$ as OUTPUT_SECURITY_POLICY_VERSION, h0 as OutputSecurityDiagnostic, h1 as OutputSecurityMode, h2 as OutputSecurityResult, cb as PNG_DEFAULT_FONT_FAMILY, cc as PNG_DEFAULT_SCALE, cd as PNG_FONT_SOURCES, ce as PNG_NAPI_RUNTIME, cf as PNG_OUTPUT_OPTION_FIELDS, cg as PNG_OUTPUT_OPTION_FIELD_DESCRIPTORS, ch as PNG_OUTPUT_POLICY_VERSION, ci as PNG_WASM_RUNTIME, cj as PORTABLE_PNG_OUTPUT_OPTION_FIELDS, ck as PRIMITIVE_REALIZATIONS, P as ParsedDiagram, h3 as ParsedDiagramFamilyMismatchError, h4 as PieRuntimeConfig, h5 as PngColorProfileReceipt, h6 as PngDimensions, cr as PngFitTo, cs as PngFontSource, ct as PngOutputOptionField, cu as PngOutputOptionFieldDescriptor, cv as PngOutputOptionInputKind, cw as PngOutputOptionPolicyState, cx as PngOutputOptionReceiptState, cy as PngOutputOptionScope, a as PngOutputPolicyInput, cz as PngRasterDimensions, c as PngRuntimeProvenance, cA as PortSemanticRole, cB as PortSide, cC as PortablePngOutputOptionField, cD as PortablePngOutputOptions, fX as PositionedDiagram, h7 as PositionedGitGraphDiagram, h8 as PositionedGraph, h9 as PositionedMindmapDiagram, cE as PreservedDiagramBody, cF as PreservedSourceSpans, cG as PreservedValidDiagram, ha as PrimitiveCapabilityClaim, hb as PrimitiveRealization, hc as QuadrantRuntimeConfig, cM as RENDER_CONTRACT_VERSION, cN as RENDER_OUTPUTS, cO as RENDER_OUTPUT_DESCRIPTORS, cP as RESOURCE_MANIFEST, cQ as RESOURCE_MANIFEST_VERSION, cR as ROLE_STYLE_PROPERTY_DESCRIPTORS, hd as RadarRuntimeConfig, cX as RegionContainmentCertificate, cY as RenderCapabilityError, he as RenderContext, R as RenderOptions, hf as RenderOutput, cZ as RenderOutputDescriptor, c_ as RenderOutputTransports, b as RenderRequestReceipt, hg as RenderableMarkerDescriptor, c$ as RenderedAscii, hh as RenderedBrowserPng, f$ as RenderedSvg, hi as ResolvedArchitectureIcon, hj as ResolvedColors, d5 as ResolvedPngOutputPolicy, hk as ResolvedSceneRoleTraits, d6 as ResolvedTerminalOutputPolicy, hl as ResolvedTerminalStyle, hm as ResourceLicense, hn as ResourceManifest, ho as ResourceManifestEntry, d8 as RoleStyleFor, d9 as RoleStyleSpec, da as RoleStyles, db as RouteBlocker, dc as RouteCertificate, dd as RouteClass, de as RoutePortAssignment, df as SCENE_CONTRACT_VERSION, dg as SCENE_ROLE_DESCRIPTORS, dh as SCENE_VALIDATION_LIMITS, di as SCENE_VALIDATION_VERSION, dj as SEMANTIC_BINDING_CHANNELS, dk as SHARED_RENDER_OPTION_FIELDS, dl as STYLE_COLOR_TOKEN_DESCRIPTORS, dm as STYLE_SPEC_FIELD_DESCRIPTORS, dn as STYLE_SPEC_FORMAT_VERSION, hp as SceneBox, hq as SceneConnectorHit, dp as SceneDoc, hr as SceneFeature, hs as SceneMarkKind, dq as SceneNode, ht as SceneNodeBase, hu as SceneOperation, hv as ScenePoint, hw as ScenePrimitive, dr as SceneRole, hx as SceneRoleDescriptor, hy as SceneRoleTraits, hz as SceneSketchPolicy, ds as SceneValidationDiagnostic, dt as SceneValidationDiagnosticCode, du as SceneValidationError, dv as SceneValidationOptions, dw as SceneValidationResult, dx as SemanticBinding, dy as SemanticBindingChannel, dz as SemanticChannels, dA as SemanticSlots, hA as ShapeMark, dM as SourceSpan, dN as SourceSpanPoint, hB as StateRuntimeConfig, dT as StyleBackend, dU as StyleBackendContext, dV as StyleColors, dW as StyleDescriptor, dX as StyleInput, dY as StyleReferenceResolution, dZ as StyleRegistrationOptions, hC as StyleRegistryKind, d_ as StyleSpec, hD as SvgRelationSemantics, hE as SvgSemanticAccessibility, hF as SvgSemanticIdentity, d$ as TERMINAL_BOUNDED_PADDING_X, e0 as TERMINAL_DEFAULT_BOX_BORDER_PADDING, e1 as TERMINAL_DEFAULT_PADDING_X, e2 as TERMINAL_DEFAULT_PADDING_Y, e3 as TERMINAL_OUTPUT_POLICY_VERSION, hG as TERMINAL_STYLE_VERSION, e4 as TEXT_MEASUREMENT_CONTRACT, hH as TerminalConnectorProjection, hI as TerminalConnectorProjectionReceipt, e5 as TerminalOutputPolicyError, e6 as TerminalOutputPolicyInput, hJ as TerminalProjectionDiagnostic, fY as TerminalProjectionDiagnosticCode, hK as TerminalProjectionSecurityContext, hL as TextMark, e7 as TextMeasurementContract, e8 as TextMeasurementInput, e9 as TextMeasurementResult, hM as TimelineRuntimeConfig, hN as XyChartRuntimeConfig, hO as applyOutputSecurityPolicy, hP as applyPngColorProfile, hQ as architectureIconManifest, hR as architectureToMermaidGraph, eV as assertHostedPngRasterBudget, eW as assertPngRasterBudget, hS as assertRenderableMarker, eX as assertValidSceneDoc, eY as buildExternalScene, hT as canonicalExtensionId, e_ as classifyMermaidFamilyFromFirstLine, hU as connectorHitDistance, e$ as createExtensionIdentity, hV as createMermaidBrowserPNGRenderer, hW as createMermaidRenderer, hX as essentialScenePrimitiveOperation, hY as evaluateExtensionCompatibility, hZ as fromShikiTheme, f5 as getBackend, f8 as getStyle, h_ as hitTestConnector, h$ as hitTestSceneConnectors, f9 as hostedFontResource, fa as inferBackend, i0 as inlineResolvedColors, i1 as inspectPngColorProfile, i2 as inspectPngDimensions, fd as knownBackendDescriptors, fg as knownStyleDescriptors, fh as knownStyles, fi as measureText, fj as measureTextWidth, fk as negotiateCapabilities, fl as negotiateRenderCapabilities, fm as normalizePortablePngBackground, fo as omitPngOutputOptions, i3 as parseArchitectureDiagram, i4 as parseExtensionId, i5 as parseGitGraph, i6 as parseMindmap, fp as parseRegisteredMermaid, fq as parseSemVer, fr as pngNapiRuntimeProvenance, fs as pngOutputOptionsJsonSchema, ft as pngRasterDimensions, fu as prepareSvgForPngRasterization, fv as projectNativePngOutputPolicyInput, fw as projectPortablePngOutputOptions, fx as registerBackend, i7 as registerExtension, fy as registerStyle, i8 as renderContractDigest, fZ as renderMermaidASCII, i9 as renderMermaidASCIIWithReceipt, ia as renderMermaidPNGInBrowserWithReceipt, f_ as renderMermaidSVG, ib as renderMermaidSVGAsync, ic as renderMermaidSVGWithReceipt, id as resolveArchitectureIcon, ie as resolveColors, ig as resolveDiagramColors, fz as resolvePngOutputPolicy, fA as resolvePortablePngOutputPolicy, fB as resolveSceneRoleTraits, fC as resolveStyleReference, fD as resolveStyleStack, fE as resolveTerminalOutputPolicy, fF as runBackendConformance, fG as sceneRoleTraits, fH as semVerSatisfies, ih as serializeGitGraph, ii as serializeMarkerResource, ij as serializeMarkerResources, ik as serializeMindmap, fI as sharedRenderOptionsJsonSchema, il as snapshotResourceManifest, fJ as styleInputJsonSchema, fK as styleSpecJsonSchema, fL as svgIntrinsicDimensions, fM as terminalConnectorCapabilityClaims, fO as validatePrimitiveCapabilities, fP as validateResourceManifest, fQ as validateSceneDoc, fR as validateSerializableRenderOptions, fS as validateStyleSpec, fT as verifyNoExternalRefs, fU as verifyResourceBytes, im as verifySvgDocumentEnvelope } from './index-BoqfBufn.js';

package/dist/index.js

@@ -164,7 +164,7 @@ import {
   verifyNoExternalRefs,
   verifyResourceBytes,
   verifySvgDocumentEnvelope
-} from "./chunk-3D4EHVQ4.js";
+} from "./chunk-PG4PTPJL.js";
 export {
   ARCHITECTURE_ICON_LIMITS,
   AsciiWidthError,

package/dist/mcp-cli-YOAFIAVD.js

@@ -0,0 +1,17 @@
+import {
+  MCP_CLI_HELP,
+  MCP_FLAG_SPECS,
+  parseMcpCliOptions,
+  runMcpCli
+} from "./chunk-WMFFVZ4Q.js";
+import "./chunk-SDJYD4OP.js";
+import "./chunk-UKLKEZBJ.js";
+import "./chunk-M3VTTD3Q.js";
+import "./chunk-PG4PTPJL.js";
+export {
+  MCP_CLI_HELP,
+  MCP_FLAG_SPECS,
+  parseMcpCliOptions,
+  runMcpCli
+};
+//# sourceMappingURL=mcp-cli-YOAFIAVD.js.map

package/docs/style-authoring.md

@@ -260,7 +260,7 @@ contract explicitly; no built-in compatibility default is borrowed by
 ```ts
 registerBackend(backend, {
   version: '1.0.0',
-  compatibility: { core: '^0.3.0', scene: '^2.0.0' },
+  compatibility: { core: '^0.4.0', scene: '^2.0.0' },
   provenance: { owner: 'acme-diagrams', source: 'application-startup' },
 })
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentic-mermaid",
   "mcpName": "io.github.adewale/agentic-mermaid",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "license": "MIT",
   "description": "Agentic Mermaid: render, verify, and safely edit Mermaid diagrams as ASCII, PNG, SVG, or structured agent workflows — with composable styles (hand-drawn, excalidraw, watercolor, or your own as JSON).",
   "type": "module",
@@ -168,6 +168,17 @@
     "lint:contracts": "bun test src/__tests__/agent-substrate-lint.test.ts src/__tests__/test-quality-lint.test.ts",
     "eval:agent-live": "bun run eval/agent-usage/live.ts",
     "eval:agent-subagent": "bun run eval/agent-usage/capture-subagent-prompt-eval.ts",
+    "eval:mcp-conformance": "bun run scripts/ci/mcp-conformance.ts",
+    "eval:skill:hydrate": "bun run scripts/eval/hydrate-private-skill-evals.ts",
+    "eval:skill:runner-manifest": "bun run scripts/eval/materialize-skill-runner-manifest.ts",
+    "eval:skill:prepare-evidence": "bun run scripts/eval/prepare-skill-evidence.ts",
+    "eval:skill:run-codex-evidence": "bun run scripts/eval/run-codex-evidence.ts",
+    "eval:skill:bundle-evidence": "bun run scripts/eval/bundle-skill-evidence.ts",
+    "eval:skill:materialize-codex-output": "bun run scripts/eval/materialize-codex-output.ts",
+    "eval:skill:summarize-evidence": "bun run scripts/eval/summarize-skill-evidence.ts",
+    "eval:skill:sabotage": "bun run scripts/ci/skill-eval-sabotage.ts",
+    "eval:family-portfolio": "bun run eval/mermaid-family-portfolio/build.ts",
+    "eval:family-portfolio:check": "bun run eval/mermaid-family-portfolio/build.ts --check",
     "eval:degenerate-routes": "bun run eval/degenerate-etn/enumerate.ts",
     "rubric:visual": "bun run eval/visual-rubric/run.ts",
     "contact:sheet": "bun run eval/visual-rubric/contact-sheet.ts",

package/server.json

@@ -7,13 +7,13 @@
     "url": "https://github.com/adewale/agentic-mermaid",
     "source": "github"
   },
-  "version": "0.3.2",
+  "version": "0.4.0",
   "websiteUrl": "https://agentic-mermaid.dev/",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "agentic-mermaid",
-      "version": "0.3.2",
+      "version": "0.4.0",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {

package/skills/agentic-mermaid-diagram-workflow/SKILL.md

@@ -12,7 +12,40 @@ An agent-agnostic typed editing surface for Mermaid. New diagrams can be authore
 - `agentic-mermaid-mcp` connected → **Code Mode** (`references/code-mode.md`). Multi-step edits in one round-trip.
 - Can run JS/TS with imports → **library** (`agentic-mermaid/agent`). Same SDK.
 - Shell only → **CLI** (`references/cli.md`).
-- No local install, network only → **hosted MCP** at `https://agentic-mermaid.dev/mcp` (stateless streamable HTTP JSON-RPC; `execute` Code Mode, `describe_sdk` for one family's mutation schema on demand, `render_svg`/`render_ascii`/`render_png`/`verify`/`describe`, and the declarative `mutate` (edit a `source`) / `build` (author from a `family`) tools — prefer `mutate`/`build` for structured edits; 64KB input caps).
+- No local install, network only → **hosted MCP** at `https://agentic-mermaid.dev/mcp` (stateless Streamable HTTP JSON-RPC; `execute`, `describe_sdk`, `render_svg`, `render_ascii`, `render_png`, `verify`, `describe`, `mutate`, and `build` tools — 64 KB input cap). Read `references/hosted-mcp.md` before composing a hosted request. Use the named direct tool and its exact argument object; do not substitute library APIs or local Code Mode for a hosted direct-tool task.
+
+For hosted MCP, choose the least-powerful tool that completes the task:
+
+| Need | Tool | Required arguments |
+|---|---|---|
+| Structural validity, family, warnings, layout counts | `verify` | `{ source }` |
+| Prose, AX tree, or semantic fact inventory | `describe` | `{ source, format?: 'text' \| 'json' \| 'facts' }` |
+| Edit an existing diagram with known ops | `mutate` | `{ source, ops: [{ kind, ...fields }] }` |
+| Author a new modeled diagram with known ops | `build` | `{ family, ops: [{ kind, ...fields }] }` |
+| Discover one family's exact op fields | `describe_sdk` | `{ family, detail: 'fields' }` |
+| Custom synchronous control flow | `execute` | `{ code, timeoutMs? }` |
+
+Use `render_svg`, `render_ascii`, or `render_png` for a requested output; do not route a one-shot render, verify, describe, mutate, or build through `execute`.
+Mutation vocabularies are family-specific and are never interchangeable. In
+particular, a state diagram uses `add_state` and `add_transition`; never reuse
+the flowchart-only `add_node` or `add_edge` kinds for a state diagram. If the
+exact family op is not already known, call `describe_sdk` instead of borrowing
+an op name from another family. State `add_state` accepts `id`, optional
+`label`, `parent`, and `region`; it has no `terminal` field. Model an
+unsuccessful terminal state as an ordinary state reached by the requested
+labeled transition rather than inventing a convenience flag. For a class
+association, use `{ kind: 'add_relation', from, to, relKind: 'association' }`;
+there is no `add_relationship` op or `relation` field.
+The request envelope's `tool` is always one of the bare hosted names above.
+Never invent a provider-qualified name such as `hosted_agentic_mermaid_mcp.*`
+or a diagram-specific tool such as `update_state_diagram`.
+For a hosted task that asks for one final fenced JSON request, use this exact
+response order: (1) finish all explanation as prose or inline code, (2) emit
+the request in the answer's only fenced block, and (3) stop immediately after
+the closing fence. Never print a fenced request before the explanation, even as
+an example or draft, and never repeat it. Before emitting, count exactly one
+fenced block and recheck every op `kind` and field against this skill or
+`describe_sdk`; do not substitute a plausible synonym.
 
 ## Capability discovery
 
@@ -23,6 +56,10 @@ source example; the generated Section A matrix supplies explicit native,
 source-preserved, diagnosed, and absent states. This skill intentionally does
 not maintain a second family or operation table.
 
+On hosted MCP, inspect the connected server's `tools/list` for its tool surface
+and call `describe_sdk({ family, detail: 'fields' })` for mutation fields. There
+is no hosted tool named `capabilities`.
+
 Any diagram with constructs we don't model falls back to an **opaque** body: it still parses, renders, verifies, and round-trips losslessly — it just isn't offered for structured mutation (the narrower returns null). The parser never silently drops anything.
 
 State diagrams own a dedicated body: `asState` models states/transitions, `[*]`, composites, stereotypes/history, concurrency regions, notes, bare declarations, and class/inline paint. `asFlowchart` returns null on a state diagram.
@@ -45,6 +82,32 @@ For new diagrams, author Mermaid source directly, then `parseRegisteredMermaid`
 
 Do not regenerate or concatenate source to edit an existing structured diagram when a typed op exists. Direct source authoring is fine for new diagrams. Mutation ops use the discriminator field `kind` (not `type`). Edge removal uses ids such as `{ kind: 'remove_edge', id: 'API->DB' }`; verify before serializing.
 
+For `mutate` or `build`, treat the returned envelope as the commit boundary:
+accept `source` only when both top-level `ok` and `verify.ok` are true, and
+inspect `verify.warnings`. If an op fails, use its `opIndex` and `error`, call
+`describe_sdk` with `detail: 'fields'`, then retry with only the returned
+`kind` and fields. Never guess a hosted op name or fall back to source
+concatenation.
+
+When the user asks which embedded verification fields must pass, name the
+response paths exactly: require top-level `ok`, confirm top-level `family`,
+require `verify.ok`, and inspect `verify.warnings`. Do not replace those field
+paths with a paraphrase.
+
+In a hosted `mutate` request, `source` is the exact pre-edit input; do not apply
+the requested change to that string yourself. Express every change only in
+`ops`, and include no convenience fields that `describe_sdk` did not advertise.
+For file-backed input, inspect the bytes rather than relying on terminal display:
+preserve line endings and whether the file has a final newline. If the file ends
+in LF, the JSON `source` string must end in `\n` after its last visible line.
+Never trim or normalize the source; compare the JSON-decoded `source` bytes to
+the attachment before emitting the request.
+
+If a request such as “make this better” has no concrete quality goal, ask for
+the audience, output medium, and intended improvement before mutating. A
+read-only `verify`, `describe`, or render inspection is safe to offer, but do
+not invent an edit objective.
+
 Minimal existing-flowchart pattern:
 
 ```ts