semiotic 3.13.1 → 3.13.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +48 -48
- package/ai/artifact-surface-inventory.json +1 -1
- package/ai/dist/mcp-server.js +4 -4
- package/ai/reference.md +23 -12
- package/ai/schema.json +258 -96
- package/ai/surface-manifest.json +1 -1
- package/ai/task-packets/compare-category-totals.json +5 -5
- package/ai/task-packets/compare-category-totals.md +2 -2
- package/ai/task-packets/correct-published-chart.json +5 -5
- package/ai/task-packets/correct-published-chart.md +2 -2
- package/ai/task-packets/index.json +6 -6
- package/ai/task-packets/update-live-chart.json +5 -5
- package/ai/task-packets/update-live-chart.md +2 -2
- package/dist/c-2YFVDRU4.min.js +1 -0
- package/dist/c-4OVDIXAR.min.js +1 -0
- package/dist/c-57IIWW46.min.js +1 -0
- package/dist/c-5HTUQRJT.min.js +1 -0
- package/dist/c-5NAU4JAY.min.js +1 -0
- package/dist/c-62UTMRQE.min.js +1 -0
- package/dist/c-6QV6F3U7.min.js +1 -0
- package/dist/c-73ORHEHO.min.js +1 -0
- package/dist/c-7S46KBYD.min.js +2 -0
- package/dist/c-AJSS332Z.min.js +2 -0
- package/dist/{c-ZWJDTDEV.min.js → c-AMQAAW7G.min.js} +1 -1
- package/dist/c-B3X2IJRQ.min.js +1 -0
- package/dist/c-BLLDBVFK.min.js +38 -0
- package/dist/c-BQWX6NBX.min.js +1 -0
- package/dist/c-C7TT4J7K.min.js +1 -0
- package/dist/c-CJ5GA7DM.min.js +1 -0
- package/dist/c-D7YDFHLY.min.js +1 -0
- package/dist/c-DHNROAXY.min.js +1 -0
- package/dist/c-DMDFJQU4.min.js +1 -0
- package/dist/{c-RAIBDXDV.min.js → c-FRVHZIGR.min.js} +1 -1
- package/dist/{c-I54V24WG.min.js → c-HAZCVHI7.min.js} +1 -1
- package/dist/c-HN5U72U7.min.js +1 -0
- package/dist/c-JA5F7ITS.min.js +1 -0
- package/dist/{c-VZNIIKL6.min.js → c-JDI7HKEM.min.js} +1 -1
- package/dist/{c-ISHYKYII.min.js → c-JVZRD4GL.min.js} +1 -1
- package/dist/{c-HGWITEJI.min.js → c-KJGJEOSV.min.js} +1 -1
- package/dist/c-LDGV6TDQ.min.js +1 -0
- package/dist/c-LW3GP7RY.min.js +1 -0
- package/dist/c-M2TPZE7P.min.js +1 -0
- package/dist/{c-XOGN3524.min.js → c-NBBYSAQY.min.js} +2 -2
- package/dist/c-OA6RJZ7S.min.js +1 -0
- package/dist/c-OBBSIOYU.min.js +1 -0
- package/dist/c-OMTJIC3P.min.js +1 -0
- package/dist/{c-SQQZPFVY.min.js → c-QPHM7AWW.min.js} +1 -1
- package/dist/{c-XZJWL7UL.min.js → c-QSEAAHEU.min.js} +1 -1
- package/dist/c-RQWI623R.min.js +1 -0
- package/dist/{c-62JIVHK5.min.js → c-RWFADOKS.min.js} +1 -1
- package/dist/c-TFESQSWE.min.js +1 -0
- package/dist/{c-SDGGMIYI.min.js → c-TJGC5JEM.min.js} +1 -1
- package/dist/{c-4P2EM44G.min.js → c-TOXWQRXS.min.js} +3 -3
- package/dist/c-TX53234M.min.js +1 -0
- package/dist/c-TZBEQ5UY.min.js +1 -0
- package/dist/c-UALVQIIJ.min.js +1 -0
- package/dist/c-VBDWHTC7.min.js +1 -0
- package/dist/c-VBIPDCE7.min.js +1 -0
- package/dist/c-WTNRBWZZ.min.js +51 -0
- package/dist/{c-3GIPT46Z.min.js → c-XG4LL2VI.min.js} +1 -1
- package/dist/c-XPNBS3W2.min.js +1 -0
- package/dist/c-XT3G3YWU.min.js +1 -0
- package/dist/c-YCBCZFOC.min.js +1 -0
- package/dist/c-ZBSL4Y32.min.js +1 -0
- package/dist/c-ZP6O6UHV.min.js +1 -0
- package/dist/c-ZVL7ULNH.min.js +1 -0
- package/dist/components/ChartErrorBoundary.d.ts +5 -1
- package/dist/components/ai/intentWeights.d.ts +22 -0
- package/dist/components/ai/streamSchema.d.ts +98 -0
- package/dist/components/ai/streamingTypes.d.ts +27 -4
- package/dist/components/ai/suggestCharts.d.ts +10 -2
- package/dist/components/ai/suggestStreamCharts.d.ts +60 -13
- package/dist/components/ai/suggestStreamDashboard.d.ts +9 -1
- package/dist/components/charts/network/processSankey/frameMargins.d.ts +1 -1
- package/dist/components/charts/network/processSankey/labelPlacement.d.ts +1 -1
- package/dist/components/charts/physics/physicsHocUtils.d.ts +1 -1
- package/dist/components/charts/realtime/RealtimeAccumulator.d.ts +7 -0
- package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +9 -2
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +13 -1
- package/dist/components/charts/realtime/RealtimeLineChart.types.d.ts +5 -1
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +5 -1
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +7 -1
- package/dist/components/charts/realtime/TemporalHistogram.capability.d.ts +5 -3
- package/dist/components/charts/realtime/aggregate.d.ts +11 -12
- package/dist/components/charts/realtime/defaultRealtimeTooltip.d.ts +9 -0
- package/dist/components/charts/realtime/eventTime.d.ts +7 -1
- package/dist/components/charts/realtime/useRealtimeLineIngestion.d.ts +13 -0
- package/dist/components/charts/shared/ChartError.d.ts +4 -6
- package/dist/components/charts/shared/GaugeReadout.d.ts +39 -4
- package/dist/components/charts/shared/axisExtent.d.ts +2 -1
- package/dist/components/charts/shared/chartMode.d.ts +2 -2
- package/dist/components/charts/shared/gaugeLayout.d.ts +69 -0
- package/dist/components/charts/shared/types.d.ts +4 -1
- package/dist/components/charts/shared/useNetworkChartSetup.d.ts +3 -0
- package/dist/components/charts/shared/useStreamStatus.d.ts +2 -2
- package/dist/components/charts/shared/withChartErrorBoundary.d.ts +14 -0
- package/dist/components/charts/xy/Scatterplot.streamCapability.d.ts +2 -0
- package/dist/components/charts/xy/WaterfallChart.d.ts +2 -0
- package/dist/components/charts/xy/WaterfallIndex.d.ts +12 -0
- package/dist/components/charts/xy/lineGapStrategy.d.ts +15 -3
- package/dist/components/legendGeometry.d.ts +148 -0
- package/dist/components/legendLayout.d.ts +20 -38
- package/dist/components/realtime/ReorderBuffer.d.ts +14 -0
- package/dist/components/realtime/SlidingExtent.d.ts +18 -0
- package/dist/components/realtime/WindowAccumulator.d.ts +5 -1
- package/dist/components/realtime/renderers/types.d.ts +1 -0
- package/dist/components/realtime/renderers/waterfallRenderer.d.ts +1 -1
- package/dist/components/recipes/atlas/resolution/appearance.d.ts +1 -1
- package/dist/components/recipes/atlas/resolution/scene.d.ts +1 -1
- package/dist/components/recipes/compositional/edgeRouting.d.ts +9 -0
- package/dist/components/recipes/compositional/metrics.d.ts +2 -2
- package/dist/components/recipes/compositional/projection.d.ts +3 -1
- package/dist/components/recipes/compositional/routing.d.ts +3 -1
- package/dist/components/recipes/compositional/testFixtures.d.ts +4 -0
- package/dist/components/recipes/compositional/topology.d.ts +2 -0
- package/dist/components/recipes/compositional/types.d.ts +10 -1
- package/dist/components/recipes/compositional/useCompositionalInterfaces.d.ts +20 -0
- package/dist/components/semiotic-ai-core.d.ts +3 -2
- package/dist/components/semiotic-ai-stream.d.ts +3 -2
- package/dist/components/semiotic-network-zoom.d.ts +1 -1
- package/dist/components/semiotic-recipes-react.d.ts +2 -0
- package/dist/components/semiotic-utils-core.d.ts +2 -0
- package/dist/components/server/serverChartConfigHeatmap.d.ts +13 -0
- package/dist/components/server/staticLegend.d.ts +5 -0
- package/dist/components/server/staticLegendText.d.ts +13 -0
- package/dist/components/server/staticSVGChrome.d.ts +2 -2
- package/dist/components/store/ThemeStore.d.ts +4 -1
- package/dist/components/store/themeCore.d.ts +2 -0
- package/dist/components/stream/DataSourceAdapter.d.ts +15 -62
- package/dist/components/stream/FrameRuntime.d.ts +3 -0
- package/dist/components/stream/GeoPipelineStore.d.ts +2 -0
- package/dist/components/stream/IngestActivity.d.ts +9 -0
- package/dist/components/stream/NetworkPipelineStore.d.ts +3 -1
- package/dist/components/stream/OrdinalPipelineStore.d.ts +5 -2
- package/dist/components/stream/OrdinalSVGOverlay.d.ts +1 -1
- package/dist/components/stream/PipelineStore.d.ts +8 -3
- package/dist/components/stream/accessibleDataRows.d.ts +1 -0
- package/dist/components/stream/axisTickUtils.d.ts +25 -5
- package/dist/components/stream/frameDefaultMargins.d.ts +26 -4
- package/dist/components/stream/frameKeyboardNavigation.d.ts +8 -1
- package/dist/components/stream/geoTypes.d.ts +2 -0
- package/dist/components/stream/graphKeyboardNavigation.d.ts +4 -2
- package/dist/components/stream/hitTestUtils.d.ts +7 -0
- package/dist/components/stream/keyboardNav.d.ts +3 -1
- package/dist/components/stream/mediaQuery.d.ts +2 -0
- package/dist/components/stream/navigationGraph.d.ts +10 -3
- package/dist/components/stream/networkEdgeHitIndex.d.ts +6 -2
- package/dist/components/stream/networkFrameKeyboardNavigation.d.ts +2 -0
- package/dist/components/stream/networkNavGroups.d.ts +3 -0
- package/dist/components/stream/networkPipelineConfig.d.ts +1 -0
- package/dist/components/stream/networkSceneTypes.d.ts +10 -0
- package/dist/components/stream/networkSpatialNavigation.d.ts +3 -0
- package/dist/components/stream/networkTypes.d.ts +2 -0
- package/dist/components/stream/networkZoom/ZoomableNetworkCustomChart.d.ts +6 -4
- package/dist/components/stream/networkZoom/gestures.d.ts +5 -0
- package/dist/components/stream/networkZoom/types.d.ts +10 -0
- package/dist/components/stream/ordinalAxisTicks.d.ts +27 -0
- package/dist/components/stream/ordinalSceneBuilders/pieScene.d.ts +10 -0
- package/dist/components/stream/ordinalSceneBuilders/types.d.ts +2 -0
- package/dist/components/stream/ordinalTypes.d.ts +11 -2
- package/dist/components/stream/pipelineBufferUtils.d.ts +9 -0
- package/dist/components/stream/pipelineConfig.d.ts +7 -0
- package/dist/components/stream/pipelineDomainResolution.d.ts +3 -2
- package/dist/components/stream/pipelineTransitionTypes.d.ts +3 -5
- package/dist/components/stream/pipelineTransitionUtils.d.ts +4 -0
- package/dist/components/stream/pipelineTransitions.d.ts +1 -13
- package/dist/components/stream/renderers/networkArcRenderer.d.ts +1 -3
- package/dist/components/stream/renderers/networkCircleRenderer.d.ts +1 -3
- package/dist/components/stream/renderers/networkPrimitiveRenderer.d.ts +5 -0
- package/dist/components/stream/renderers/networkRectRenderer.d.ts +1 -3
- package/dist/components/stream/renderers/renderPulse.d.ts +8 -14
- package/dist/components/stream/roundScaleDomain.d.ts +9 -0
- package/dist/components/stream/sceneToSVGShared.d.ts +9 -0
- package/dist/components/stream/shallowEqual.d.ts +2 -0
- package/dist/components/stream/stalenessBands.d.ts +1 -1
- package/dist/components/stream/svgOverlayUtils.d.ts +12 -0
- package/dist/components/stream/types.d.ts +10 -2
- package/dist/components/stream/useFrame.d.ts +7 -4
- package/dist/components/stream/useMediaPreferences.d.ts +1 -4
- package/dist/components/stream/useOrdinalFrameHandle.d.ts +4 -14
- package/dist/components/stream/useStalenessCheck.d.ts +5 -3
- package/dist/components/stream/useStreamingDataHandle.d.ts +24 -0
- package/dist/components/stream/useXYFrameHandle.d.ts +4 -14
- package/dist/components/stream/xyDateTicks.d.ts +33 -4
- package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
- package/dist/components/stream/xyPlugins/registry.d.ts +7 -0
- package/dist/components/stream/xySceneBuilders/heatmapScene.d.ts +11 -2
- package/dist/components/stream/xySceneBuilders/types.d.ts +4 -0
- package/dist/components/types/legendTypes.d.ts +12 -1
- package/dist/geo.min.js +155 -152
- package/dist/geo.module.min.js +1 -1
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics.module.min.js +1 -1
- package/dist/processSankeyLayoutWorker.js +1 -1
- package/dist/semiotic-ai-core.d.ts +3 -2
- package/dist/semiotic-ai-core.min.js +5 -5
- package/dist/semiotic-ai-core.module.min.js +4 -4
- package/dist/semiotic-ai.module.min.js +2 -2
- package/dist/semiotic-artifact.min.js +6 -6
- package/dist/semiotic-artifact.module.min.js +5 -5
- package/dist/semiotic-atlas-selection.module.min.js +1 -1
- package/dist/semiotic-atlas.module.min.js +1 -1
- package/dist/semiotic-client-cjs-shared.min.js +1021 -1024
- package/dist/semiotic-client-compositional.module.min.js +1 -1
- package/dist/semiotic-client-shared.module.min.js +1 -1
- package/dist/semiotic-experimental-auxiliary.module.min.js +2 -2
- package/dist/semiotic-experimental-network-resolution-react.module.min.js +1 -1
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +3 -3
- package/dist/semiotic-line.module.min.js +1 -1
- package/dist/semiotic-network-zoom.d.ts +1 -1
- package/dist/semiotic-network-zoom.min.js +7 -7
- package/dist/semiotic-network-zoom.module.min.js +1 -1
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-realtime-react.module.min.js +1 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +101 -101
- package/dist/semiotic-recipes-core.module.min.js +1 -1
- package/dist/semiotic-recipes-react.d.ts +2 -0
- package/dist/semiotic-recipes-react.min.js +8 -8
- package/dist/semiotic-server-edge-node.module.min.js +3 -3
- package/dist/semiotic-server-edge.min.js +399 -397
- package/dist/semiotic-server-edge.module.min.js +3 -3
- package/dist/semiotic-server-node.min.js +399 -397
- package/dist/semiotic-themes-core.min.js +2 -2
- package/dist/semiotic-themes-core.module.min.js +1 -1
- package/dist/semiotic-themes.min.js +2 -2
- package/dist/semiotic-themes.module.min.js +1 -1
- package/dist/semiotic-utils-core.d.ts +2 -0
- package/dist/semiotic-utils-core.min.js +11 -11
- package/dist/semiotic-utils-core.module.min.js +3 -3
- package/dist/semiotic-value.module.min.js +1 -1
- package/dist/semiotic.module.min.js +1 -1
- package/dist/server.min.js +399 -397
- package/dist/server.module.min.js +3 -3
- package/dist/xy.module.min.js +1 -1
- package/package.json +11 -11
- package/dist/c-2M2OPWVA.min.js +0 -37
- package/dist/c-2N7IU2NY.min.js +0 -1
- package/dist/c-3UXQGCQT.min.js +0 -1
- package/dist/c-4RVDKSMQ.min.js +0 -1
- package/dist/c-4YPPVFZH.min.js +0 -1
- package/dist/c-6WJKNYIG.min.js +0 -1
- package/dist/c-7UN2WUMI.min.js +0 -1
- package/dist/c-AQUX6L2O.min.js +0 -1
- package/dist/c-BR5QDUCR.min.js +0 -1
- package/dist/c-C3YQVUB6.min.js +0 -1
- package/dist/c-COP4OISO.min.js +0 -1
- package/dist/c-ENRZPF5E.min.js +0 -1
- package/dist/c-FAOZZE77.min.js +0 -1
- package/dist/c-HBLICBM6.min.js +0 -1
- package/dist/c-I4BEWAKT.min.js +0 -1
- package/dist/c-IDCFMBA4.min.js +0 -2
- package/dist/c-KLJDKRD5.min.js +0 -1
- package/dist/c-LEICSI5V.min.js +0 -1
- package/dist/c-MOK4RWNO.min.js +0 -1
- package/dist/c-N2TVSOYL.min.js +0 -2
- package/dist/c-NHZ2E3CI.min.js +0 -1
- package/dist/c-OIJL2WZH.min.js +0 -1
- package/dist/c-OSLNYZ3Q.min.js +0 -51
- package/dist/c-OWRVBUSL.min.js +0 -1
- package/dist/c-QIVKWHDL.min.js +0 -1
- package/dist/c-QUAEYF34.min.js +0 -1
- package/dist/c-RDFFLRKC.min.js +0 -1
- package/dist/c-RTU5425Z.min.js +0 -1
- package/dist/c-SIQVOV6A.min.js +0 -1
- package/dist/c-SU6Z75M2.min.js +0 -1
- package/dist/c-SWVXFUDL.min.js +0 -1
- package/dist/c-TC47SNSI.min.js +0 -1
- package/dist/c-VLWWXOM5.min.js +0 -1
- package/dist/c-VNFIRKU5.min.js +0 -1
- package/dist/c-W5ATXREF.min.js +0 -1
- package/dist/c-WFX456JK.min.js +0 -5
- package/dist/c-WSWMQDFZ.min.js +0 -1
- package/dist/c-XORVM6C5.min.js +0 -1
- package/dist/c-YGTMWEEF.min.js +0 -1
- package/dist/c-ZDCTFRA6.min.js +0 -1
package/README.md
CHANGED
|
@@ -26,16 +26,16 @@ evidence scope; source availability does not establish installed or deployed par
|
|
|
26
26
|
<img src="./docs/public/assets/img/semiotic-release-dashboard.svg" alt="Semiotic release dashboard showing chart count, bundle sizes, capability coverage, chart families, and documentation growth" width="100%">
|
|
27
27
|
<!-- semiotic-readme-dashboard:end -->
|
|
28
28
|
|
|
29
|
-
## What's New in 3.13.
|
|
29
|
+
## What's New in 3.13.3
|
|
30
30
|
|
|
31
|
-
3.13.
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
31
|
+
3.13.3 improves streaming chart suggestions with field cardinality, additivity,
|
|
32
|
+
and schema warnings, and adds count aggregation for realtime histograms.
|
|
33
|
+
Streaming charts preserve extents, hover detail, and keyboard focus as data
|
|
34
|
+
changes. Pie, donut, and network charts use more of their available space,
|
|
35
|
+
with matching server rendering. This release also improves chart error
|
|
36
|
+
recovery, legend fitting, heatmap colors, and compositional routing.
|
|
37
37
|
|
|
38
|
-
See [the changelog](CHANGELOG.md#
|
|
38
|
+
See [the changelog](CHANGELOG.md#3133---2026-10-29) for the complete fixes and additions.
|
|
39
39
|
|
|
40
40
|
## Why Semiotic
|
|
41
41
|
|
|
@@ -399,47 +399,47 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
|
|
|
399
399
|
|
|
400
400
|
| Entry Point | gzip | What's inside |
|
|
401
401
|
|---|---|---|
|
|
402
|
-
| `semiotic/atlas` | **
|
|
402
|
+
| `semiotic/atlas` | **324 KB** | Motif Braid, Dependency Forest, and Flow Circuit readers |
|
|
403
403
|
| `semiotic/atlas/core` | **15 KB** | Network Atlas preparation, projections, and evidence queries |
|
|
404
404
|
| `semiotic/access` | **31 KB** | Chart Access Contract factory and first-wave baseline contracts |
|
|
405
405
|
| `semiotic/evidence` | **47 KB** | Chart Evidence Envelope, deterministic hashing, and publication gate |
|
|
406
|
-
| `semiotic/artifact` | **
|
|
406
|
+
| `semiotic/artifact` | **126 KB** | Renderer-independent contracts, claims, time, policy, grounding, and transfer audits |
|
|
407
407
|
| `semiotic/artifact/react` | **4 KB** | Accessible progressive disclosure for artifact contracts and policy evaluations |
|
|
408
|
-
| `semiotic/line` | **
|
|
409
|
-
| `semiotic/xy` | **
|
|
410
|
-
| `semiotic/ordinal` | **
|
|
411
|
-
| `semiotic/network` | **
|
|
412
|
-
| `semiotic/network/zoom` | **
|
|
408
|
+
| `semiotic/line` | **150 KB** | LineChart only — one-chart micro boundary |
|
|
409
|
+
| `semiotic/xy` | **187 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
|
|
410
|
+
| `semiotic/ordinal` | **139 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
|
|
411
|
+
| `semiotic/network` | **183 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
|
|
412
|
+
| `semiotic/network/zoom` | **192 KB** | Optional virtual network viewport, camera controls and consumer-owned LOD |
|
|
413
413
|
| `semiotic/network/perspective` | **2 KB** | Isometric pictograms and an accessible perspective toggle (the prop ships in ./network) |
|
|
414
414
|
| `semiotic/network/perspective/core` | **3 KB** | Projection sizing, resolution, and SVG placement helpers |
|
|
415
415
|
| `semiotic/vite` | **1 KB** | Build plugin for unused Semiotic worker assets |
|
|
416
|
-
| `semiotic/geo` | **
|
|
417
|
-
| `semiotic/realtime` | **
|
|
418
|
-
| `semiotic/realtime/core` | **
|
|
416
|
+
| `semiotic/geo` | **114 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
|
|
417
|
+
| `semiotic/realtime` | **222 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
|
|
418
|
+
| `semiotic/realtime/core` | **220 KB** | Streaming chart types, HOCs, and buffer helpers |
|
|
419
419
|
| `semiotic/realtime/react` | **2 KB** | Stream status and synced push hooks |
|
|
420
|
-
| `semiotic/server` | **
|
|
421
|
-
| `semiotic/server/node` | **
|
|
422
|
-
| `semiotic/server/edge` | **
|
|
423
|
-
| `semiotic/utils` | **
|
|
420
|
+
| `semiotic/server` | **284 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
421
|
+
| `semiotic/server/node` | **284 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
422
|
+
| `semiotic/server/edge` | **289 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
|
|
423
|
+
| `semiotic/utils` | **113 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
|
|
424
424
|
| `semiotic/utils/core` | **102 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
|
|
425
425
|
| `semiotic/utils/react` | **10 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
|
|
426
|
-
| `semiotic/recipes` | **
|
|
427
|
-
| `semiotic/recipes/core` | **
|
|
426
|
+
| `semiotic/recipes` | **118 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
427
|
+
| `semiotic/recipes/core` | **115 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
428
428
|
| `semiotic/recipes/react` | **3 KB** | Glyph and React layout-selection helpers |
|
|
429
429
|
| `semiotic/themes` | **13 KB** | Theme presets only (tufte, carbon, etc.) |
|
|
430
430
|
| `semiotic/themes/core` | **13 KB** | Theme presets and token helpers |
|
|
431
431
|
| `semiotic/themes/react` | **9 KB** | ThemeProvider/useTheme and hooks |
|
|
432
432
|
| `semiotic/data` | **5 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
|
|
433
433
|
| `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
|
|
434
|
-
| `semiotic/physics` | **
|
|
434
|
+
| `semiotic/physics` | **190 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
|
|
435
435
|
| `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
|
|
436
436
|
| `semiotic/physics/rapier` | **1 KB** | Rapier peer guard + adapter decision metadata (no chart components) |
|
|
437
|
-
| `semiotic/ai` | **
|
|
438
|
-
| `semiotic/ai/core` | **
|
|
437
|
+
| `semiotic/ai` | **680 KB** | All schema-backed charts + validation — optimized for LLM code generation |
|
|
438
|
+
| `semiotic/ai/core` | **148 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
|
|
439
439
|
| `semiotic/controls` | **19 KB** | DirectManipulationControl, CircularBrush, LinearBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
|
|
440
440
|
| `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
|
|
441
441
|
| `semiotic/text` | **2 KB** | Optional Pretext annotation hook — peer package excluded |
|
|
442
|
-
| `semiotic` | **
|
|
442
|
+
| `semiotic` | **437 KB** | Full chart API and shared utilities |
|
|
443
443
|
|
|
444
444
|
<!-- semiotic-bundle-sizes:end -->
|
|
445
445
|
|
|
@@ -464,47 +464,47 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
|
|
|
464
464
|
|---|---:|---:|---:|
|
|
465
465
|
| `import { semioticVite } from "semiotic/vite"` | node | **0.6 KiB** | — |
|
|
466
466
|
| `import { getNetworkPerspectiveSize } from "semiotic/network/perspective/core"` | browser | **1.1 KiB** | — |
|
|
467
|
-
| `import { MotifBraidChart } from "semiotic/atlas"` | browser | **
|
|
467
|
+
| `import { MotifBraidChart } from "semiotic/atlas"` | browser | **111.9 KiB** | 29.4 KiB |
|
|
468
468
|
| `import { prepareNetworkAtlas } from "semiotic/atlas/core"` | browser | **7.1 KiB** | — |
|
|
469
|
-
| `import { LineChart } from "semiotic"` | browser | **
|
|
470
|
-
| `import { LineChart } from "semiotic/xy"` | browser | **
|
|
471
|
-
| `import { LineChart } from "semiotic/line"` | browser | **
|
|
472
|
-
| `import { BarChart } from "semiotic/ordinal"` | browser | **
|
|
473
|
-
| `import { SankeyDiagram } from "semiotic/network"` | browser | **
|
|
474
|
-
| `import { ZoomableNetworkCustomChart } from "semiotic/network/zoom"` | browser | **
|
|
469
|
+
| `import { LineChart } from "semiotic"` | browser | **126.2 KiB** | 44.4 KiB |
|
|
470
|
+
| `import { LineChart } from "semiotic/xy"` | browser | **125.8 KiB** | 32.4 KiB |
|
|
471
|
+
| `import { LineChart } from "semiotic/line"` | browser | **126.0 KiB** | 32.4 KiB |
|
|
472
|
+
| `import { BarChart } from "semiotic/ordinal"` | browser | **107.1 KiB** | 14.7 KiB |
|
|
473
|
+
| `import { SankeyDiagram } from "semiotic/network"` | browser | **135.8 KiB** | 6.6 KiB |
|
|
474
|
+
| `import { ZoomableNetworkCustomChart } from "semiotic/network/zoom"` | browser | **115.2 KiB** | 29.4 KiB |
|
|
475
475
|
| `import { isometricGlyphs } from "semiotic/network/perspective"` | browser | **1.4 KiB** | — |
|
|
476
|
-
| `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **
|
|
476
|
+
| `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **127.0 KiB** | 42.1 KiB |
|
|
477
477
|
| `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** | 13.6 KiB |
|
|
478
|
-
| `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.
|
|
479
|
-
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **
|
|
478
|
+
| `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.8 KiB** | — |
|
|
479
|
+
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **96.1 KiB** | 2.7 KiB |
|
|
480
480
|
| `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.1 KiB** | — |
|
|
481
481
|
| `import { RAPIER_PHYSICS_CAPABILITIES } from "semiotic/physics/rapier"` | browser | **0.2 KiB** | — |
|
|
482
|
-
| `import { renderChart } from "semiotic/server"` | node | **
|
|
483
|
-
| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **
|
|
484
|
-
| `import { renderToImage } from "semiotic/server/node"` | node | **
|
|
485
|
-
| `import { suggestCharts } from "semiotic/ai"` | browser | **
|
|
486
|
-
| `import { suggestCharts } from "semiotic/ai/core"` | browser | **32.
|
|
482
|
+
| `import { renderChart } from "semiotic/server"` | node | **303.8 KiB** | — |
|
|
483
|
+
| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **128.9 KiB** | — |
|
|
484
|
+
| `import { renderToImage } from "semiotic/server/node"` | node | **304.2 KiB** | 0.6 KiB |
|
|
485
|
+
| `import { suggestCharts } from "semiotic/ai"` | browser | **38.1 KiB** | 13.6 KiB |
|
|
486
|
+
| `import { suggestCharts } from "semiotic/ai/core"` | browser | **32.2 KiB** | — |
|
|
487
487
|
| `import { buildArtifactContract } from "semiotic/artifact"` | browser | **4.5 KiB** | — |
|
|
488
488
|
| `import { ArtifactInspector } from "semiotic/artifact/react"` | browser | **3.7 KiB** | — |
|
|
489
489
|
| `import { createChartAccessContract } from "semiotic/access"` | browser | **27.9 KiB** | — |
|
|
490
490
|
| `import { toEvidenceEnvelope } from "semiotic/evidence"` | browser | **43.5 KiB** | — |
|
|
491
491
|
| `import { bin } from "semiotic/data"` | browser | **0.9 KiB** | — |
|
|
492
|
-
| `import { ChoroplethMap } from "semiotic/geo"` | browser | **
|
|
492
|
+
| `import { ChoroplethMap } from "semiotic/geo"` | browser | **109.1 KiB** | 1.7 KiB |
|
|
493
493
|
| `import { usePretextAnnotations } from "semiotic/text"` | browser | **1.5 KiB** | — |
|
|
494
494
|
| `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.2 KiB** | — |
|
|
495
495
|
| `import { resolveThemePreset } from "semiotic/themes"` | browser | **2.6 KiB** | — |
|
|
496
496
|
| `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **2.6 KiB** | — |
|
|
497
|
-
| `import { ThemeProvider } from "semiotic/themes/react"` | browser | **6.
|
|
497
|
+
| `import { ThemeProvider } from "semiotic/themes/react"` | browser | **6.2 KiB** | — |
|
|
498
498
|
| `import { validateProps } from "semiotic/utils"` | browser | **10.0 KiB** | — |
|
|
499
499
|
| `import { smartTickFormat } from "semiotic/utils/core"` | browser | **1.1 KiB** | — |
|
|
500
500
|
| `import { useReducedMotion } from "semiotic/utils/react"` | browser | **0.3 KiB** | — |
|
|
501
501
|
| `import { waffleLayout } from "semiotic/recipes"` | browser | **1.6 KiB** | — |
|
|
502
502
|
| `import { waffleLayout } from "semiotic/recipes/core"` | browser | **1.6 KiB** | — |
|
|
503
503
|
| `import { Glyph } from "semiotic/recipes/react"` | browser | **0.8 KiB** | — |
|
|
504
|
-
| `import { BigNumber } from "semiotic/value"` | browser | **5.
|
|
504
|
+
| `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** | — |
|
|
505
505
|
| `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.5 KiB** | — |
|
|
506
506
|
|
|
507
|
-
**Line-boundary interpretation:** the retained named import from `semiotic/line` emits
|
|
507
|
+
**Line-boundary interpretation:** the retained named import from `semiotic/line` emits 373.3 KiB raw versus 373.4 KiB from `semiotic/xy`; gzip differs by 0.2 KiB (0.1%). Tree-shaking converges both paths on the same LineChart implementation graph. Treat `semiotic/line` as a narrower API/direct-ESM artifact boundary, not an application-bundle saving. Do not add another per-chart entry until its packed named import beats the family path by both 10 KiB gzip and 7%.
|
|
508
508
|
|
|
509
509
|
<!-- semiotic-cold-consumer:end -->
|
|
510
510
|
|
|
@@ -640,7 +640,7 @@ profiles and transports cap complete tool responses at 2 MiB by default through
|
|
|
640
640
|
| **`getSchema`** | Return the prop schema for a specific component. Pass `{ component: "LineChart" }` to get its props, or omit `component` to list the complete schema-backed catalog. Components marked `[renderable]` are available through `renderChart`; realtime charts require a browser/live environment. |
|
|
641
641
|
| **`suggestChart`** | Sample-row recommender. Pass `{ data: [{...}, ...] }` with 1–5 sample objects plus optional broad intent/capability filters. |
|
|
642
642
|
| **`suggestCharts`** | Capability-based recommender for bounded row data. Returns ranked chart suggestions with scores, reasons, caveats, import paths, and ready-to-use props. |
|
|
643
|
-
| **`suggestStreamCharts`** | Recommend streaming charts from a schema (shape,
|
|
643
|
+
| **`suggestStreamCharts`** | Recommend streaming charts from a schema (shape, keys, throughput, field cardinality/additivity). Returns `{ suggestions, excluded, stretchSuggestions, rankingIntents, warnings }`. |
|
|
644
644
|
| **`suggestStreamDashboard`** | Compose a multi-panel dashboard from stream schemas and an audience layout policy. |
|
|
645
645
|
| **`suggestDashboard`** | Build a multi-panel dashboard suggestion that covers distinct analytical intents. |
|
|
646
646
|
| **`suggestStretchCharts`** | Recommend audience-literacy stretch picks from an `AudienceProfile`. |
|
package/ai/dist/mcp-server.js
CHANGED
|
@@ -438,9 +438,9 @@ ${n.warnings.map(a=>`- [${a.code}] ${a.message}`).join(`
|
|
|
438
438
|
Encoding:
|
|
439
439
|
${JSON.stringify(n.tokenEncoding,null,2)}`:"";return{content:[{type:"text",text:[`Recommended token encoding: ${n.recommendedEncoding}`,`Rationale: ${n.rationale}`,`Capability intents: ${i.join(", ")}`,o.trim(),r.trim(),`Alternatives: ${n.alternatives.join(", ")}`].filter(Boolean).join(`
|
|
440
440
|
|
|
441
|
-
`)}],structuredContent:{suggestion:n,capabilityIntents:i}}}async function DV(e){let{schema:t,intent:n,maxResults:i,audience:r}=e,o=Array.isArray(n)?n:n?[n]:void 0,{suggestions:a,excluded:s,stretchSuggestions:c}=(0,F.suggestStreamCharts)(t,{intent:o,maxResults:i??8,audience:r}),
|
|
442
|
-
caveats: ${
|
|
443
|
-
`)}],structuredContent:{suggestions:a,excluded:s,stretchSuggestions:c,schema:t}}}async function MV(e){let t=(0,F.suggestStreamDashboard)(e.schemas,{intent:e.intent,budget:e.budget,audience:e.audience});return{content:[{type:"text",text:[`${t.panels.length} stream dashboard panel${t.panels.length===1?"":"s"}`,`covered: ${t.intentsCovered.join(", ")||"(none)"}`,...t.intentsMissing.length?[`missing: ${t.intentsMissing.join(", ")}`]:[],"",...t.panels.map((i,r)=>`${r+1}. ${i.intent} \u2192 ${i.suggestion.component} (${i.suggestion.score.toFixed(1)}/5)`)].join(`
|
|
441
|
+
`)}],structuredContent:{suggestion:n,capabilityIntents:i}}}async function DV(e){let{schema:t,intent:n,maxResults:i,audience:r}=e,o=Array.isArray(n)?n:n?[n]:void 0,{suggestions:a,excluded:s,stretchSuggestions:c,rankingIntents:u,warnings:l}=(0,F.suggestStreamCharts)(t,{intent:o,maxResults:i??8,audience:r}),d=[`${a.length} stream chart suggestion${a.length===1?"":"s"} (${o?"intent":"inferred intents"}: ${u.join(", ")||"none"})`,...l.map(p=>`warning: ${p}`),...t.throughput!=null?[`throughput: ${t.throughput}`]:[],...t.retention?[`retention: ${t.retention}`]:[],...t.shape?[`shape: ${t.shape}`]:[],"",...a.map((p,m)=>{let h=p.reasons.length?` \u2014 ${p.reasons.join("; ")}`:"",g=p.caveats.length?`
|
|
442
|
+
caveats: ${p.caveats.join("; ")}`:"";return`${m+1}. ${p.component} (score ${p.score.toFixed(1)}/5)${h}${g}`})];if(s.length>0){d.push("","Excluded:");for(let p of s.slice(0,8))d.push(`- ${p.component}: ${p.reason}`)}return{content:[{type:"text",text:d.join(`
|
|
443
|
+
`)}],structuredContent:{suggestions:a,excluded:s,stretchSuggestions:c,rankingIntents:u,warnings:l,schema:t}}}async function MV(e){let t=(0,F.suggestStreamDashboard)(e.schemas,{intent:e.intent,budget:e.budget,audience:e.audience});return{content:[{type:"text",text:[`${t.panels.length} stream dashboard panel${t.panels.length===1?"":"s"}`,`covered: ${t.intentsCovered.join(", ")||"(none)"}`,...t.intentsMissing.length?[`missing: ${t.intentsMissing.join(", ")}`]:[],...t.warnings.map(i=>`warning: ${i}`),"",...t.panels.map((i,r)=>`${r+1}. ${i.intent} \u2192 ${i.suggestion.component} (${i.suggestion.score.toFixed(1)}/5)`)].join(`
|
|
444
444
|
`)}],structuredContent:t}}async function UV(e){let{data:t,intents:n,maxPanels:i,diversifyByFamily:r,audience:o,identifiers:a,fieldRoles:s}=e,c=(0,F.suggestDashboard)(t,{intents:n,maxPanels:i??6,diversifyByFamily:r!==!1,audience:o,identifiers:a,fieldRoles:s}),u=[];u.push(`Dashboard: ${c.panels.length} panels covering ${c.intentsCovered.join(", ")||"\u2014"}`),c.intentsMissing.length&&u.push(`Intents this data couldn't fill: ${c.intentsMissing.join(", ")}`),u.push("");for(let l=0;l<c.panels.length;l++){let{intent:d,suggestion:p}=c.panels[l],m=p.variant?` / ${p.variant.label}`:"";u.push(`${l+1}. [${d}] ${p.component}${m} (score ${p.score.toFixed(1)}/5)`),p.reasons.length&&u.push(` ${p.reasons.join("; ")}`)}if(c.stretchPanels.length>0){u.push(""),u.push("Stretch picks (audience-unfamiliar but fitting):");for(let l of c.stretchPanels){let d=l.suggestion.variant?` / ${l.suggestion.variant.label}`:"";u.push(` ${l.suggestion.component}${d} (familiarity ${l.familiarity}) \u2014 ${l.rationale}`)}}return{content:[{type:"text",text:u.join(`
|
|
445
445
|
`)}],structuredContent:c}}async function LV(e){let{data:t,audience:n,intent:i,maxResults:r,identifiers:o,fieldRoles:a}=e,s=Array.isArray(i)?i:i?[i]:void 0,c=(0,F.suggestStretchCharts)(t,{audience:n,intent:s,maxResults:r??5,identifiers:o,fieldRoles:a});return{content:[{type:"text",text:[`${c.length} stretch pick${c.length===1?"":"s"} for "${n.name??"audience"}":`,"",...c.map((l,d)=>{let p=l.suggestion.variant?` / ${l.suggestion.variant.label}`:"",m=l.replacing?` (could replace ${l.replacing})`:"";return`${d+1}. ${l.suggestion.component}${p} (familiarity ${l.familiarity}/5)${m}
|
|
446
446
|
${l.rationale}`})].join(`
|
|
@@ -455,7 +455,7 @@ Contextual instructions:
|
|
|
455
455
|
4. Use the accessor names from the provided props (e.g. xAccessor, yAccessor).`}),{content:a,structuredContent:{summary:o,component:t,props:n}}}async function iz(e){let t=e.component,n=e.props??{};if(!t)return{content:[{type:"text",text:"Missing 'component' field. Provide { component: 'LineChart', props: { ... } }."}],isError:!0};let i=(0,F.getCapability)(t),r=(0,F.buildReaderGrounding)(t,n,{capability:i}),o=r.structure?(0,F.countNodes)(r.structure):0;return{content:[{type:"text",text:[`Reader grounding for ${t} \u2014 the payload an agent reads to interpret this chart without seeing it:`,"",`L1\u2013L3 (description): ${r.description.text}`,r.intent?`L4 (intent \xB7 ${r.intent.act}): ${r.intent.sentence}`:"L4 (intent): not resolved (no capability for this component).","",`Structure: ${o} navigable node(s) (chart \u2192 axes/series \u2192 datum) in structuredContent.structure.`,"","Combined text:",r.text].join(`
|
|
456
456
|
`)}],structuredContent:r}}function oz(e){let t={...e};return delete t.data,delete t.nodes,delete t.edges,t}function UC(e){return{...e,props:oz(e.props)}}async function FV(e,t={}){let n=Array.isArray(e.intent)?e.intent:e.intent?[e.intent]:void 0,i=(0,F.suggestCharts)(e.data,{intent:n,audience:e.audience,maxResults:40,identifiers:e.identifiers,fieldRoles:e.fieldRoles}).filter($=>oi($.component).renderable).slice(0,8),r=e.component?i.find($=>$.component===e.component):i[0];if(!r)return{content:[{type:"text",text:"No renderable Semiotic chart was suggested for this data. Use getChartSchema for code-level guidance."}],isError:!0,structuredContent:rt({status:"no-suggestion",suggestions:i.map(UC),dataRowCount:e.data.length})};let o={data:e.data,...r.props,...e.props},a=oz(o),s=UC(r),c=(0,F.diagnoseConfig)(r.component,o);if(c.diagnoses.filter($=>$.severity==="error").length)return{content:[{type:"text",text:`Selected ${r.component}, but blocking diagnostics require repair before rendering.`}],isError:!0,structuredContent:rt({status:"blocked",component:r.component,props:a,dataRowCount:e.data.length,suggestion:s,diagnostics:c.diagnoses})};o.description===void 0&&Rc(Sr[r.component]).directProps.description&&(o.description=(0,F.buildReaderGrounding)(r.component,o,{capability:(0,F.getCapability)(r.component)}).description.levels.l1,a.description=o.description);let l=await n$({component:r.component,props:o,format:"svg",theme:e.theme},t);if(l.isError)return{...l,structuredContent:rt({status:"blocked",component:r.component,props:a,dataRowCount:e.data.length,suggestion:s,diagnostics:c.diagnoses,render:l.structuredContent??null})};let{result:d,evidence:p}=await QC({component:r.component,props:o,theme:e.theme},t,l);if(d.isError)return{...d,structuredContent:rt({status:"blocked",component:r.component,props:a,dataRowCount:e.data.length,suggestion:s,diagnostics:c.diagnoses,render:d.structuredContent??null})};let m=d.structuredContent??{},h=o.chartId,g=(0,xn.toEvidenceEnvelope)(r.component,o,{chartId:typeof h=="string"?h:void 0,sourceId:"mcp-create-chart",ssrEvidence:p??void 0,privacyScope:{mcpResponse:["public chart config without source rows","render evidence and mark counts"]}}),y=(0,xn.evaluateEvidenceGate)(g,{requireRenderEvidence:!0,allowAccessibilityWarnings:!0});return y.ok?{...d,structuredContent:rt({status:"render-proven",component:r.component,props:a,dataRowCount:e.data.length,suggestion:s,diagnostics:c.diagnoses,render:m,evidenceEnvelope:g,evidenceGate:y})}:{content:[{type:"text",text:`Selected ${r.component}, rendered, but the evidence publication gate blocked it: ${y.findings.map($=>$.id).join(", ")}.`}],isError:!0,structuredContent:rt({status:"blocked",component:r.component,props:a,dataRowCount:e.data.length,suggestion:s,diagnostics:c.diagnoses,render:m,evidenceEnvelope:g,evidenceGate:y})}}async function qV(e){let{data:t,rawInput:n}=tz(e),i=Array.isArray(e.intent)?e.intent:e.intent?[e.intent]:void 0,r=(0,F.diagnoseConfig)(e.component,e.props),o=(0,F.repairChartConfig)(e.component,t,{intent:i,identifiers:e.identifiers,fieldRoles:e.fieldRoles}),a=(0,F.profileData)(t,{rawInput:n,identifiers:e.identifiers,fieldRoles:e.fieldRoles}),{proposals:s}=rz(e.component,a,{intent:i}),c=kV(e.component,e.props,t),u=Array.isArray(e.data)?{...e.props,data:t}:e.props,l=(0,xn.toEvidenceEnvelope)(e.component,u,{surfaceVersion:"mcp-improve-chart",knownGaps:["Static analysis only; no render evidence was requested."]});return{content:[{type:"text",text:`Improvement analysis for ${e.component}: ${r.diagnoses.length} diagnosis item(s), repair status ${o.status}, ${s.length} variant proposal(s).`}],structuredContent:rt({status:o.status==="ok"?"reviewed":"repair-needed",component:e.component,diagnostics:r.diagnoses,repair:o,variants:s,...c?{accessibilityRecommendation:c}:{},evidenceFragment:l})}}async function BV(e){let t=await iz(e),n=(0,xn.toEvidenceEnvelope)(e.component,e.props,{surfaceVersion:"mcp-explain-chart",knownGaps:["No render or audit evidence requested by explain-only call."]});return{...t,structuredContent:t.structuredContent?rt({status:"grounded",grounding:t.structuredContent,evidenceFragment:n}):void 0}}async function HV(e){let t=(0,F.diagnoseConfig)(e.component,e.props),n=(0,F.auditAccessibility)(e.component,e.props),i=(0,F.auditMobileVisualization)(e.component,e.props,{viewportWidth:e.viewportWidth}),r=(0,xn.toEvidenceEnvelope)(e.component,e.props,{surfaceVersion:"mcp-audit-chart",audits:{design:i},knownGaps:["Audit-only call does not prove non-empty rendered marks."]}),o=(0,xn.evaluateEvidenceGate)(r,{requireRenderEvidence:!1,requireAccessTable:e.component!=="BigNumber"}),a=t.diagnoses.some(s=>s.severity==="error")||!n.ok||!i.ok||!o.ok;return{content:[{type:"text",text:`Audit for ${e.component}: ${a?"blocking findings need attention":"no blocking findings"}.`}],isError:a,structuredContent:rt({status:a?"findings":"passed",component:e.component,diagnostics:t.diagnoses,accessibility:n,mobile:i,evidenceEnvelope:r,evidenceGate:o})}}function JV(e){let t=n=>e.filter(i=>i?.status===n).length;return{pass:t("pass"),fail:t("fail"),warn:t("warn"),manual:t("manual"),unknown:t("unknown"),notApplicable:t("not-applicable")}}function az(e){return{id:re(String(e?.id??"unknown"),240),...e?.category==="identity"||e?.category==="configuration"||e?.category==="contract"?{category:e.category}:{},...typeof e?.path=="string"?{path:re(e.path,240)}:{},action:re(String(e?.action??""),600),reason:re(String(e?.reason??""),600),changesClaim:e?.changesClaim===!0}}var i$=(e,t)=>{Pb("render work",Nc().maxRenderWorkMs);try{return(0,ZC.renderChartWithEvidence)(e,t)}finally{Eb()}};async function GV(e){let t=(0,Je.validateArtifactContract)(e.contract);if(!t.valid)return qm(t,e.policyId);let n=(0,Je.evaluateArtifact)(e.component,e.props??{},e.contract,{...e.data?{data:e.data}:{},policy:e.policyId,...e.exceptions?{exceptions:e.exceptions}:{},...e.now?{now:e.now}:{},render:i$}),i=Array.isArray(n.obligations)?n.obligations:[],r=Array.isArray(n.alternatives)?n.alternatives:[],o=Array.isArray(n.repairs)?n.repairs:[],a=Array.isArray(n.manualChecks)?n.manualChecks:[],s=rt({status:n.status,policy:Fm(n.policy),contractValidation:jc(t),obligationSummary:JV(i),claimSummary:n.claims.summary,temporalSummary:n.temporal.summary,obligations:i.slice(0,50).map(WC),...n.recommendation?.selected?{selectedRepresentation:zc(n.recommendation.selected)}:{},alternatives:r.slice(0,8).map(zc),repairs:o.slice(0,50).map(az),manualChecks:$n(a,25),truncated:{obligations:i.length>50,alternatives:r.length>8,repairs:o.length>50,manualChecks:a.length>25}});return{content:[{type:"text",text:`Artifact audit: ${n.status} under ${s.policy.id}@${s.policy.version}. Missing source, review, and time facts were not inferred.`}],structuredContent:s}}async function WV(e){let t=(0,Je.validateArtifactContract)(e.contract);if(!t.valid)return qm(t,e.policyId);let n=(0,Je.recommendRepresentation)(e.data,e.contract,{policy:e.policyId,...e.exceptions?{exceptions:e.exceptions}:{},...e.intent?{intent:e.intent}:{},...e.preferredComponent?{preferredComponent:e.preferredComponent}:{},maxChartCandidates:Math.min(8,e.maxChartCandidates??5),...e.identifiers?{identifiers:e.identifiers}:{},...e.now?{now:e.now}:{}}),i=Array.isArray(n.alternatives)?n.alternatives:[],r=Array.isArray(n.rejected)?n.rejected:[],o=rt({status:n.status,policy:Fm(n.policy),contractValidation:jc(t),selected:zc(n.selected),alternatives:i.slice(0,8).map(zc),rejected:r.slice(0,8).map(a=>({...zc(a),rejectedBecause:re(String(a?.rejectedBecause??""),600)})),reasons:$n(n.reasons,12),truncated:{alternatives:i.length>8,rejected:r.length>8,reasons:(n.reasons?.length??0)>12}});return{content:[{type:"text",text:`Representation outcome: ${n.status}; ${n.selected.label}. Policy: ${o.policy.id}@${o.policy.version}.`}],structuredContent:o}}async function KV(e){let t=(0,Je.validateArtifactContract)(e.contract);if(!t.valid)return qm(t,e.policyId);let n=(0,Je.repairArtifact)(e.component,e.props??{},e.contract,{...e.data?{data:e.data}:{},policy:e.policyId,...e.exceptions?{exceptions:e.exceptions}:{},applySafeIdentityRepairs:e.applySafeIdentityRepairs===!0,...e.now?{now:e.now}:{},render:i$}),i=Array.isArray(n.ledger)?n.ledger:[],r,o;try{r=(0,Je.createArtifactPacket)(n.contract,{format:"mcp",includeEvidenceSamples:!1,maxEvidenceRecords:50,maxClaims:50})}catch(d){o=re(d instanceof Error?d.message:String(d),600)}let a=r?JSON.stringify(r.contract):"",s=!!r&&Buffer.byteLength(a,"utf8")<=vV,c=r?xV(r.transfer):{format:"mcp",preservation:"unknown",preservedPaths:[],omittedPaths:["$"],warnings:[re(`The repair draft was withheld because it could not form a semantically valid transfer packet${o?`: ${o}`:"."}`,600)]},u=r?r.transfer.preservedPaths.length>25||r.transfer.omittedPaths.length>25||r.transfer.warnings.length>25:!1,l=rt({status:n.status,policy:Fm(n.after.policy),contractValidation:jc(t),...s&&r?{contract:r.contract}:{},contractTransfer:c,beforeStatus:n.before.status,afterStatus:n.after.status,ledger:i.slice(0,50).map(d=>({id:re(String(d?.id??"unknown"),240),...d?.category==="identity"||d?.category==="configuration"||d?.category==="contract"?{category:d.category}:{},path:re(String(d?.path??"$"),240),action:re(String(d?.action??""),600),reason:re(String(d?.reason??""),600),applied:d?.applied===!0,changesClaim:d?.changesClaim===!0,...typeof d?.suggestedComponent=="string"?{suggestedComponent:re(d.suggestedComponent,240)}:{},...typeof d?.suggestedVariant=="string"?{suggestedVariant:re(d.suggestedVariant,240)}:{}})),truncated:{ledger:i.length>50,contract:!s,transfer:u}});return{content:[{type:"text",text:`Artifact repair outcome: ${n.status} under ${l.policy.id}@${l.policy.version}. Only missing identity fields were eligible for automatic application; existing mismatches require an explicit revision and claim reassessment. Configuration alternatives remain proposals, and source, review, and time facts were not created.${r?"":" The repair ledger is available, but the draft contract was withheld because semantic integrity checks blocked packet creation."}`}],structuredContent:l}}async function XV(e){let t=(0,Je.validateArtifactContract)(e.contract);if(!t.valid)return qm(t,e.policyId);let n=(0,Je.evaluateArtifact)(e.component,e.props??{},e.contract,{...e.data?{data:e.data}:{},policy:e.policyId,...e.exceptions?{exceptions:e.exceptions}:{},...e.now?{now:e.now}:{},render:i$}),i=(0,Je.explainArtifactRefusal)(n),r=(n.obligations??[]).filter(s=>s?.status==="fail"),o=Array.isArray(n.repairs)?n.repairs:[],a=rt({status:n.status==="refuse"?"refuse":"not-refused",evaluationStatus:n.status,policy:Fm(n.policy),contractValidation:jc(t),explanation:re(i,6e3),failures:r.slice(0,20).map(WC),repairs:o.slice(0,20).map(az),truncated:{failures:r.length>20,repairs:o.length>20,explanation:Buffer.byteLength(i,"utf8")>6e3}});return{content:[{type:"text",text:a.explanation}],structuredContent:a}}var Ae={readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0,openWorldHint:!1};function t$(e="developer",t={}){let n=YC(e),i={signal:t.signal,limits:t.limits??Nc()},r=new hm({...FE(n),description:"Deterministic Semiotic chart selection, validation, rendering, and non-visual chart grounding. Use suggestCharts, getSchema, diagnoseConfig, and renderChart in that order for static chart generation."}),o=xm();function a(u,l){return async(d,p)=>{let m=$c(d,o);if(!m.ok)return{content:[{type:"text",text:xc(m)}],isError:!0,structuredContent:{code:"MCP_INPUT_LIMIT"}};if(wc())return l(d);try{return await nV.run({name:u,arguments:d,profile:e},[p.signal,t.signal])}catch(h){return{content:[{type:"text",text:h instanceof Dt?h.message:"Tool execution failed."}],isError:!0,structuredContent:{code:h instanceof Dt?h.code:"MCP_OPERATION_FAILED"}}}}}let s=WE({directory:GC("task-packets"),packageVersion:r$});if(r.registerResource("semiotic-build-info","semiotic://build-info",{title:"Semiotic Build Information",description:"Read-only deployment identity for this Semiotic MCP server.",mimeType:"application/json"},u=>Gt(u,"application/json",JSON.stringify(n,null,2))),r.registerResource("semiotic-task-index","semiotic://tasks",{title:"Semiotic Task Guides",description:"Bounded implementation paths for category totals, live record updates, and source corrections. Includes fit, limits, installed version, and source identity.",mimeType:"application/json"},u=>Gt(u,"application/json",JSON.stringify(s.index(),null,2))),r.registerResource("semiotic-task-packet",new vc("semiotic://tasks/{taskId}",{list:void 0,complete:{taskId:u=>s.complete(u)}}),{title:"Semiotic Task Packet",description:"One source-identified task with a compact schema, complete example, expected checks, repair guidance, and evidence limits. Refuses incompatible installed versions.",mimeType:"application/json"},(u,l)=>{if(typeof l.taskId!="string"||u.href!==`semiotic://tasks/${l.taskId}`)throw new Error("Invalid Semiotic task resource URI");return Gt(u,"application/json",JSON.stringify(s.read(l.taskId),null,2))}),r.registerResource("semiotic-schema","semiotic://schema",{title:"Semiotic Component Schema",description:"Machine-readable JSON schema for all Semiotic AI chart components.",mimeType:"application/json"},u=>Gt(u,"application/json",JSON.stringify(ai,null,2))),r.registerResource("semiotic-artifact-contract-schema","semiotic://artifact-contract-schema",{title:"Semiotic Artifact Contract Schema",description:"Read-only Draft 2020-12 schema for explicit artifact purpose, claims, evidence, time, reception, review, and transfer requirements.",mimeType:"application/schema+json"},u=>Gt(u,"application/schema+json",K2)),r.registerResource("semiotic-schema-index","semiotic://schema-index",{title:"Semiotic Schema Discovery Index",description:"Compact component catalog with one-resource-per-component schema URIs.",mimeType:"application/json"},u=>Gt(u,"application/json",uV())),r.registerResource("semiotic-component-schema",new vc("semiotic://schema/{component}",{list:void 0,complete:{component:u=>Vm.filter(l=>l.toLowerCase().startsWith(u.toLowerCase()))}}),{title:"Semiotic Component Schema",description:"One component's prop schema, metadata, accessibility guidance, and behavior contracts.",mimeType:"application/json"},(u,l)=>{let d=Array.isArray(l.component)?l.component[0]:l.component,p=lV(String(d??""));if(!p)throw new Error(`Unknown Semiotic component schema: ${String(d??"")}`);return Gt(u,"application/json",JSON.stringify(dV(p),null,2))}),r.registerResource("semiotic-components","semiotic://components",{title:"Semiotic Component Index",description:"Renderable/browser-only component index with MCP categories.",mimeType:"application/json"},u=>Gt(u,"application/json",cV())),r.registerResource("semiotic-surface-manifest","semiotic://surface-manifest",{title:"Semiotic AI Surface Manifest",description:"Generated inventory of schema components, AI exports, MCP renderability, tools, resources, and prompts.",mimeType:"application/json"},u=>Gt(u,"application/json",Kb("surface-manifest.json"))),r.registerResource("semiotic-behavior-contracts","semiotic://behavior-contracts",{title:"Semiotic AI Behavior Contracts",description:"Agent-visible semantic rules for color precedence, required prop combinations, streaming refs, and renderability.",mimeType:"application/json"},u=>Gt(u,"application/json",JSON.stringify({version:ai.version,contracts:J2},null,2))),r.registerResource("semiotic-system-prompt","semiotic://system-prompt",{title:"Semiotic AI System Prompt",description:"Compact implementation guidance for AI assistants building with Semiotic.",mimeType:"text/markdown"},u=>Gt(u,"text/markdown",Kb("system-prompt.md"))),r.registerResource("semiotic-examples","semiotic://examples",{title:"Semiotic AI Examples",description:"On-demand copy-paste examples for common Semiotic chart data shapes.",mimeType:"text/markdown"},u=>Gt(u,"text/markdown",Kb("examples.md"))),r.registerResource("semiotic-chatgpt-chart-widget",Ic,{title:"Semiotic ChatGPT Chart Widget",description:"MCP Apps widget template for interactive Semiotic chart previews inside ChatGPT.",mimeType:HC,_meta:{ui:{prefersBorder:!0,csp:{connectDomains:[],resourceDomains:[]}},"openai/widgetDescription":"Interactive Semiotic chart preview rendered by the semiotic-mcp server.","openai/widgetPrefersBorder":!0}},u=>pV(u,gV())),r.registerPrompt("build-semiotic-chart",{title:"Build a Semiotic chart",description:"Workflow for choosing a chart, validating props, and rendering a preview.",argsSchema:{intent:f.string().optional().describe("Visualization intent, e.g. trend, comparison, distribution, relationship, composition, network, hierarchy."),dataDescription:f.string().optional().describe("Brief description of the data fields and sample rows."),component:f.string().optional().describe("Optional preferred Semiotic component name.")}},u=>RC(["Build a production-ready Semiotic visualization.","",`Intent: ${u.intent||"not specified"}`,`Data: ${u.dataDescription||"not specified"}`,`Preferred component: ${u.component||"not specified"}`,"","Use this MCP workflow:","1. Read semiotic://system-prompt for compact API rules and pitfalls.","2. Read semiotic://behavior-contracts for semantic rules that schema shape alone cannot express.","3. If no component is specified, call suggestCharts with representative rows and the intent.","4. Call getSchema for the selected component before writing JSX or renderChart props.",'5. Call diagnoseConfig with usageMode="static" for renderChart/static data, or usageMode="push" for ref-based React code that intentionally omits data.',"6. Fix all diagnoseConfig errors before presenting code.","7. If the component is renderable and has static data, call renderChart and verify its render evidence is non-empty and accessible.","8. Use the chart family's sub-path in production code (for example semiotic/xy); import generation helpers from semiotic/ai or semiotic/ai/core.","","Return the final JSX or renderChart call plus any assumptions about fields, accessors, or aggregation."].join(`
|
|
457
457
|
`))),r.registerPrompt("debug-semiotic-chart",{title:"Debug a Semiotic chart",description:"Workflow for diagnosing bad props, rendering failures, and chart-quality issues.",argsSchema:{component:f.string().optional().describe("Semiotic component name, e.g. BarChart."),problem:f.string().optional().describe("Observed failure, warning, or visual issue."),props:f.string().optional().describe("Relevant chart props as JSON or a short summary.")}},u=>RC(["Debug this Semiotic chart with the MCP server.","",`Component: ${u.component||"not specified"}`,`Problem: ${u.problem||"not specified"}`,`Props: ${u.props||"not provided"}`,"","Use this MCP workflow:","1. Call getSchema for the component and compare the provided props against required props and accessor names.","2. Read semiotic://behavior-contracts for semantic rules around colors, required combinations, streaming refs, and renderability.",'3. Call diagnoseConfig with usageMode="push" if the code intentionally omits data for a ref-push HOC; otherwise use usageMode="static".',"4. Treat diagnoseConfig errors as blockers and warnings as review items.","5. If renderable and static data is available, call renderChart with a minimal reproduction to separate configuration issues from rendering bugs.","6. If schema and diagnostics are insufficient, check the relevant section of semiotic://examples for a nearby working pattern before inventing props.","7. If the result looks like a Semiotic bug, call reportIssue with the component, props summary, diagnoseConfig output, and renderChart result.","","Return the smallest safe fix first, then mention any follow-up cleanup or issue-reporting step."].join(`
|
|
458
|
-
`))),e==="public")return r.registerTool("createChart",{title:"Create and prove a chart",description:"Select, validate, diagnose, render, and prove a static-data Semiotic chart. This is the default public workflow.",inputSchema:{data:f.array(H).min(1),intent:f.union([f.string(),f.array(f.string())]).optional(),audience:f.object({name:f.string().optional(),receptionModality:f.enum(["visual","screen-reader","sonified","agent"]).optional()}).passthrough().optional(),...ii,component:f.string().optional().describe("Optional chart preference; the fit-ranked result remains authoritative."),props:H.optional().describe("Optional props to merge over the selected chart recipe."),theme:f.record(f.string(),f.string()).optional()},outputSchema:{status:f.enum(["render-proven","blocked","no-suggestion"]),component:f.string().optional(),evidenceEnvelope:H.optional(),evidenceGate:H.optional(),surfaceVersion:f.string()},annotations:Ae,_meta:{ui:{resourceUri:Ic},"openai/outputTemplate":Ic}},a("createChart",u=>FV(u,i))),r.registerTool("improveChart",{title:"Improve an existing chart",description:"Diagnose a chart configuration, assess data fit, and propose repairs or variants.",inputSchema:{component:f.string(),props:H,data:f.array(H).optional(),intent:f.union([f.string(),f.array(f.string())]).optional(),...ii},outputSchema:{status:f.enum(["reviewed","repair-needed"]),component:f.string(),diagnostics:f.array(f.unknown()),repair:H,variants:f.array(f.unknown()),accessibilityRecommendation:f.object({location:f.literal("direct-component-props"),props:f.record(f.string(),f.string()),chartContainer:H}).optional(),evidenceFragment:H.optional(),surfaceVersion:f.string()},annotations:Ae},a("improveChart",qV)),r.registerTool("explainChart",{title:"Explain a chart without pixels",description:"Return reader grounding: chart description, communicative intent, and navigable data structure.",inputSchema:{component:f.string(),props:H},outputSchema:{status:f.literal("grounded"),grounding:H,evidenceFragment:H.optional(),surfaceVersion:f.string()},annotations:Ae},a("explainChart",BV)),r.registerTool("auditChart",{title:"Audit chart quality and accessibility",description:"Run design diagnostics plus accessibility and mobile audits, returning prioritized structured findings.",inputSchema:{component:f.string(),props:H,viewportWidth:f.number().int().min(240).max(1600).optional()},outputSchema:{status:f.enum(["passed","findings"]),component:f.string(),evidenceEnvelope:H.optional(),evidenceGate:H.optional(),surfaceVersion:f.string()},annotations:Ae},a("auditChart",HV)),r.registerTool("getChartSchema",{title:"Get a chart schema",description:"Return canonical Semiotic prop-schema guidance for code editing and advanced configuration.",inputSchema:{component:f.string().optional()},outputSchema:{status:f.enum(["component-list","component-schema","unknown-component"]),component:f.string().optional(),renderable:f.boolean().optional(),availableComponents:f.array(f.object({name:f.string(),renderable:f.boolean()})).optional(),schema:H.optional(),accessibility:f.object({directProps:H,chartContainer:H}).optional(),behaviorContracts:f.array(f.unknown()).optional(),surfaceVersion:f.string()},annotations:Ae},a("getChartSchema",DC)),r;r.registerTool("auditArtifact",{title:"Audit an explicit artifact contract",description:"Evaluate a chart and its explicit artifact contract under a named policy. The tool audits only supplied claims, evidence, source identity, review state, and time state; missing facts remain missing or unknown. Results are capped and report truncation explicitly.",inputSchema:{component:f.string().describe("Semiotic component name."),props:H.optional().describe("Chart props/config. Data may be supplied here or separately."),data:f.array(H).max(1e4).optional().describe("Optional explicit row data overriding props.data."),contract:Tc,policyId:Nm,exceptions:f.array(Qo).max(20).optional(),now:Yo.optional()},outputSchema:{status:f.enum(["acceptable","conditional","refuse","invalid-contract"]),policy:jm,contractValidation:Dm,obligationSummary:Xb.optional(),claimSummary:Xb.optional(),temporalSummary:Xb.optional(),obligations:f.array(OC).max(50).optional(),selectedRepresentation:Pc.optional(),alternatives:f.array(Pc).max(8).optional(),repairs:f.array(NC).max(50).optional(),manualChecks:f.array(f.string()).max(25).optional(),truncated:f.object({obligations:f.boolean(),alternatives:f.boolean(),repairs:f.boolean(),manualChecks:f.boolean()}).optional(),surfaceVersion:f.string()},annotations:Ae},a("auditArtifact",GV)),r.registerTool("recommendRepresentation",{title:"Recommend a defensible representation",description:"Recommend chart and non-chart outcomes from explicit data and an explicit artifact contract. Evidence, source, review, and time facts are never synthesized. The named policy can recommend waiting, collecting data, or making no claim instead of forcing a chart.",inputSchema:{data:f.array(H).max(1e4).optional().describe("Explicit row data; omit only when contract evidence is sufficient."),contract:Tc,policyId:Nm,exceptions:f.array(Qo).max(20).optional(),now:Yo.optional(),intent:f.union([f.string(),f.array(f.string()).max(12)]).optional(),preferredComponent:f.string().max(120).optional().describe("Optional Semiotic component preference."),maxChartCandidates:f.number().int().min(1).max(8).optional(),identifiers:f.array(f.string()).max(64).optional()},outputSchema:{status:f.enum(["recommended","conditional","refuse","invalid-contract"]),policy:jm,contractValidation:Dm,selected:Pc.optional(),alternatives:f.array(Pc).max(8).optional(),rejected:f.array(Pc.extend({rejectedBecause:f.string()})).max(8).optional(),reasons:f.array(f.string()).max(12).optional(),truncated:f.object({alternatives:f.boolean(),rejected:f.boolean(),reasons:f.boolean()}).optional(),surfaceVersion:f.string()},annotations:Ae},a("recommendRepresentation",WV)),r.registerTool("repairArtifact",{title:"Repair an explicit artifact contract",description:"Propose repairs for a chart and explicit artifact contract. By default this is proposal-only. If enabled, safe application fills missing component and configuration/data identity fields only; existing bindings are never overwritten. Mismatches require an explicit revision and claim reassessment. Source, evidence, review, approval, and time facts are never invented. Returned contracts omit evidence samples, report transfer losses, and are withheld above a 64 KiB UTF-8 cap.",inputSchema:{component:f.string().describe("Semiotic component name."),props:H.optional(),data:f.array(H).max(1e4).optional(),contract:Tc,policyId:Nm,exceptions:f.array(Qo).max(20).optional(),now:Yo.optional(),applySafeIdentityRepairs:f.boolean().optional().describe("Fill missing identity fields only; existing mismatches require an explicit revision and claim reassessment. Defaults to false.")},outputSchema:{status:f.enum(["unchanged","repaired","requires-input","invalid-contract"]),policy:jm,contractValidation:Dm,contract:Tc.optional(),contractTransfer:bV.optional(),beforeStatus:f.enum(["acceptable","conditional","refuse"]).optional(),afterStatus:f.enum(["acceptable","conditional","refuse"]).optional(),ledger:f.array(_V).max(50).optional(),truncated:f.object({ledger:f.boolean(),contract:f.boolean(),transfer:f.boolean()}).optional(),surfaceVersion:f.string()},annotations:Ae},a("repairArtifact",KV)),r.registerTool("explainRefusal",{title:"Explain an artifact policy refusal",description:"Evaluate an explicit artifact contract under a named policy and explain why publication or action is refused. Missing evidence, source, review, and time facts stay explicit rather than being guessed.",inputSchema:{component:f.string().describe("Semiotic component name."),props:H.optional(),data:f.array(H).max(1e4).optional(),contract:Tc,policyId:Nm,exceptions:f.array(Qo).max(20).optional(),now:Yo.optional()},outputSchema:{status:f.enum(["refuse","not-refused","invalid-contract"]),evaluationStatus:f.enum(["acceptable","conditional","refuse"]).optional(),policy:jm,contractValidation:Dm,explanation:f.string().optional(),failures:f.array(OC).max(20).optional(),repairs:f.array(NC).max(20).optional(),truncated:f.object({failures:f.boolean(),repairs:f.boolean(),explanation:f.boolean()}).optional(),surfaceVersion:f.string()},annotations:Ae},a("explainRefusal",XV)),r.tool("getSchema","Return the prop schema for a Semiotic chart component. Pass { component: '<name>' } to get its props, or omit component to list all available components. Components marked [renderable] can be passed to renderChart for static SVG output.",{component:f.string().optional().describe("Component name, e.g. 'LineChart'. Omit to list all.")},Ae,a("getSchema",DC)),r.tool("suggestChart","Lightweight heuristic chart recommender for a small data sample (1-5 rows) with capability filtering (push API, linked hover, SSR, selection, legend). Returns ranked recommendations with example props. For richer capability-descriptor ranking (scores, reasons, caveats) and the full 13-intent taxonomy, prefer `suggestCharts` (plural).",{data:f.array(H).min(1).max(5).describe("1-5 sample data objects"),intent:f.string().optional().describe("Visualization intent. Accepts this engine's intents (comparison, trend, distribution, relationship, composition, geographic, network, hierarchy) AND the richer suggestCharts taxonomy (compare-categories, part-to-whole, correlation, flow, geo, rank, \u2026), which is translated automatically; an unrecognized intent is ignored rather than rejected."),capabilities:f.object({push:f.boolean().optional().describe("Require ref-based push API (live streaming via ref.current.push())"),linkedHover:f.boolean().optional().describe("Require cross-chart linked hover support"),ssr:f.boolean().optional().describe("Require server-side rendering via renderChart()"),selection:f.boolean().optional().describe("Require named selection / cross-filter support"),legend:f.boolean().optional().describe("Require a top-level legend")}).strict().optional().describe("Capability constraints \u2014 set a key to true to require, false to forbid. Unset keys are ignored.")},Ae,a("suggestChart",SV)),r.tool("renderChart",`Render a Semiotic chart to static SVG or PNG. This is a static snapshot path: props must include data immediately, and ref/push-mode charts cannot be rendered through this tool. Returns SVG text by default or an image/png artifact when format='png', plus a "Render evidence" JSON block (mark counts by type, resolved axis domains, empty flag, annotation count, accessible name) \u2014 read the evidence instead of parsing the SVG to verify the chart actually rendered data marks. An optional explicit contract is preserved in render evidence together with its transfer status; missing contract facts are not inferred. Optionally pass theme CSS custom properties (--semiotic-bg, --semiotic-text, etc.) to style the output. PNG requires the 'sharp' package to be installed. Available components: ${Ec.join(", ")}.`,{component:f.string().describe("Chart component name, e.g. 'LineChart', 'BarChart'"),props:H.optional().describe("Chart props object, e.g. { data: [...], xAccessor: 'x' }."),contract:H.optional().describe("Optional explicit artifact contract. The render evidence reports whether it was preserved, invalid, or an unsupported version."),theme:f.record(f.string(),f.string()).optional().describe("CSS custom properties for theming, e.g. { '--semiotic-bg': '#1a1a2e', '--semiotic-text': '#ededed' }. Only --semiotic-* variables are applied."),format:f.enum(["svg","png"]).optional().describe("Output format: 'svg' (default) returns SVG markup, 'png' returns image/png artifact data. PNG requires the 'sharp' package.")},Ae,a("renderChart",u=>n$(u,i))),r.registerTool("renderInteractiveChart",{title:"Render interactive Semiotic chart",description:`Render a static-data Semiotic chart as a ChatGPT Apps widget. Use this after suggestCharts/getSchema/diagnoseConfig when the user wants to see an interactive chart inside ChatGPT. The server renders Semiotic to SVG and the widget adds fit, zoom, data, hover, and render-evidence controls. Available components: ${Ec.join(", ")}.`,inputSchema:{component:f.string().describe("Renderable chart component name, e.g. 'LineChart', 'BarChart', 'GaugeChart'."),props:H.optional().describe("Static Semiotic chart props, including data/accessors where required."),theme:f.record(f.string(),f.string()).optional().describe("CSS custom properties such as { '--semiotic-bg': '#fff', '--semiotic-text': '#111' }. Only --semiotic-* variables are applied.")},outputSchema:{component:f.string(),title:f.string(),summary:f.string(),datumCount:f.number().nullable(),evidence:H.nullable()},annotations:{readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0,openWorldHint:!1},_meta:{ui:{resourceUri:Ic},"openai/outputTemplate":Ic,"openai/toolInvocation/invoking":"Rendering Semiotic chart...","openai/toolInvocation/invoked":"Rendered Semiotic chart."}},a("renderInteractiveChart",async u=>(await QC(u,i)).result)),r.tool("diagnoseConfig","Diagnose a Semiotic chart configuration for common problems (empty data, bad dimensions, missing accessors, wrong data shape, color contrast issues, etc). Pass usageMode='push' for ref-based React HOCs that intentionally omit data; omit usageMode or pass 'static' for renderChart/MCP/server configs where data is required. Checks WCAG color contrast ratios and suggests COLOR_BLIND_SAFE_CATEGORICAL for accessibility. Returns a human-readable diagnostic report with actionable fixes.",{component:f.string().describe("Chart component name, e.g. 'LineChart'"),props:H.optional().describe("Chart props object, e.g. { data: [...], xAccessor: 'x' }."),usageMode:f.enum(["static","push","renderChart","server"]).optional().describe("Validation mode. Use 'push' for ref-based React HOCs that omit data; use 'static' or omit for renderChart/MCP/static data configs.")},Ae,a("diagnoseConfig",IV)),r.tool("auditAccessibility","Audit a Semiotic chart configuration against the Chartability (POUR-CAF) accessibility framework \u2014 Perceivable, Operable, Understandable, Robust, Compromising, Assistive, Flexible. Statically grades the config (no DOM/AT): credits the built-ins every HOC ships (keyboard nav, focus ring, skip link, screen-reader data table, reduced-motion + forced-colors, shareable state), flags author-actionable gaps (missing title/description/summary, low contrast, small text, color-only encoding, undescribed trends, data density), and routes everything that needs real assistive-technology testing to a 'manual' item. Returns a per-principle report with the 14 critical heuristics marked. Pass inChartContainer=true to credit data-download/share affordances. Pair with manual NVDA/JAWS/VoiceOver testing \u2014 Chartability is not a pass/fail certification.",{component:f.string().describe("Chart component name, e.g. 'LineChart'"),props:H.optional().describe("Chart props object, e.g. { data: [...], xAccessor: 'x', title: '...' }."),inChartContainer:f.boolean().optional().describe("True if the chart is (or will be) wrapped in a ChartContainer exposing data-download/copy-config actions."),describe:f.boolean().optional().describe("True if ChartContainer's describe option (auto-generated L1\u2013L3 description via describeChart) is enabled \u2014 passes the 'features described' heuristic."),navigable:f.boolean().optional().describe("True if ChartContainer's navigable option (structured navigation tree via buildNavigationTree) is enabled \u2014 passes the 'navigable structure' heuristic.")},Ae,a("auditAccessibility",TV)),r.tool("evaluateChart","Evaluate a Semiotic chart through one deterministic quality pass: numeric data contracts, configuration and representation/deception checks, and static Chartability accessibility heuristics. Returns the independent audit reports plus a severity-ranked findings list and notification feed. Pass data separately when it should override props.data; use inChartContainer, describe, or navigable to describe the intended accessibility wrapper. This is static analysis and does not replace manual assistive-technology testing or render evidence.",{component:f.string().describe("Chart component name, e.g. 'LineChart'."),props:H.optional().describe("Chart props/config, including accessors and optional data."),data:f.array(H).optional().describe("Optional explicit dataset. When supplied, this is used as the effective props.data for evaluation."),inChartContainer:f.boolean().optional().describe("Whether the chart will be wrapped in ChartContainer or an equivalent control surface."),describe:f.boolean().optional().describe("Whether ChartContainer's generated description is enabled."),navigable:f.boolean().optional().describe("Whether ChartContainer's structured navigation tree is enabled.")},Ae,a("evaluateChart",PV)),r.tool("auditMobileVisualization","Audit a Semiotic chart configuration for mobile visualization risks. Use before generating phone-sized charts or when adapting a desktop chart to mobile. Flags fixed desktop widths, rough mark-density overload, hover-only detail, small touch targets, complex gestures without controls, legend dependence, annotation overload, and missing mobile transformation hints. Static analysis only: still verify rendered charts at phone widths.",{component:f.string().describe("Chart component name, e.g. 'LineChart', 'Scatterplot', or 'BarChart'."),props:H.optional().describe("Chart props/config to audit."),viewportWidth:f.number().int().min(240).max(1600).optional().describe("Mobile viewport width in CSS pixels. Defaults to 390."),targetSize:f.number().int().min(24).max(80).optional().describe("Desired comfortable touch target size in CSS pixels. Defaults to 44."),inChartContainer:f.boolean().optional().describe("Whether the chart is wrapped in ChartContainer or an equivalent summary/control surface.")},Ae,a("auditMobileVisualization",EV)),r.tool("reportIssue","Generate a GitHub issue URL for Semiotic bug reports or feature requests. Returns a URL the user can open to submit. For rendering bugs, include the component name, props summary, and any diagnoseConfig output in the body.",{title:f.string().describe("Issue title, e.g. 'Bug: BarChart tooltip shows undefined'"),body:f.string().optional().describe("Issue body with details, reproduction steps, diagnoseConfig output"),labels:f.union([f.array(f.string()),f.string()]).optional().describe("GitHub labels, e.g. ['bug'] or 'bug'")},Ae,a("reportIssue",CV)),r.tool("applyTheme",`Get usage instructions for a named Semiotic theme preset. Returns ThemeProvider examples, CSS custom properties, and design token export patterns. Available themes: ${Xo.join(", ")}.`,{name:f.string().optional().describe("Theme preset name, e.g. 'tufte', 'pastels-dark', 'bi-tool'. Omit to list all available themes.")},Ae,a("applyTheme",zV)),r.tool("interrogateChart","Conversational interrogation of a Semiotic chart. Extract a statistical summary and answer natural language questions about the data, trends, and outliers. Returns a summary and guidance for an AI to generate a textual answer and visual annotations.",{component:f.string().describe("Chart component name, e.g. 'LineChart'"),props:H.describe("The full chart props including data"),query:f.string().optional().describe("A natural language question about the chart data")},Ae,a("interrogateChart",VV)),r.registerTool("groundChart",{title:"Ground a Semiotic chart for a non-visual reader",description:"Build the agent-reader grounding payload for a Semiotic chart: the layered L1\u2013L3 natural-language description, the L4 communicative-act sentence (what the chart is asking the reader to do), and a structured navigation tree (chart \u2192 axes/series \u2192 datum). Use this to interpret a chart faithfully without pixels.",inputSchema:{component:f.string().describe("Chart component name, e.g. 'LineChart'"),props:H.describe("The full chart props including data")},outputSchema:{component:f.string(),description:H,intent:H.optional(),structure:H.optional(),physics:H.optional(),text:f.string()},annotations:Ae},a("groundChart",iz));let c=f.object({fields:f.array(f.object({name:f.string(),kind:f.enum(["numeric","categorical","date","boolean"]),role:f.enum(["x","y","value","category","series","size","key"]).optional()})),throughput:f.union([f.enum(["low","medium","high"]),f.number()]).optional(),retention:f.enum(["windowed","cumulative"]).optional(),shape:f.enum(["append","keyed","aggregate"]).optional(),keyFields:f.array(f.string()).optional()});return r.tool("suggestStreamCharts","Recommend streaming Semiotic charts for a schema (not row data). Pass fields plus optional throughput (band or rows/sec), retention, shape ('append'|'keyed'|'aggregate'), and keyFields. Ranks realtime XY charts plus push-capable ordinal/value charts (BarChart, PieChart, BigNumber, GaugeChart, \u2026). Returns suggestions, excluded fits-reasons, and optional stretch picks when audience is set.",{schema:c.describe("Stream schema \u2014 fields plus throughput/retention/shape hints. No row data."),intent:f.union([f.string(),f.array(f.string())]).optional().describe("Ranking intent."),maxResults:f.number().int().min(1).max(20).optional(),audience:H.optional()},Ae,a("suggestStreamCharts",DV)),r.tool("suggestStreamDashboard","Compose a multi-panel dashboard from one or more stream schemas. Honors AudienceProfile.dashboard layout policy (cellBudget, leadFamilies, windowPreference).",{schemas:f.union([c,f.array(c).min(1)]),intent:f.union([f.string(),f.array(f.string())]).optional(),budget:f.number().int().min(1).max(12).optional(),audience:H.optional()},Ae,a("suggestStreamDashboard",MV)),r.tool("suggestDashboard","Generate a dashboard of complementary chart panels for a dataset \u2014 each panel answers a distinct analytical intent (trend, rank, distribution, correlation, etc.) and the engine diversifies by chart family by default. Heuristic only; no LLM call. Use when the user asks 'show me this data' or 'build me a dashboard' rather than picking one chart.",{data:f.array(H).describe("Row data \u2014 array of objects."),intents:f.array(f.string()).optional().describe("Intents to cover. Omit to let the engine pick based on the data shape."),maxPanels:f.number().int().min(1).max(12).optional().describe("Maximum panels (default 6)."),diversifyByFamily:f.boolean().optional().describe("Prefer not to repeat chart families across panels (default true)."),...ii,audience:f.object({name:f.string().optional(),familiarity:f.record(f.string(),f.number()).optional(),targets:f.record(f.string(),f.object({direction:f.enum(["increase","decrease"]),weight:f.number().int().min(1).max(3).optional(),reason:f.string().optional()})).optional(),exposureLevel:f.union([f.literal(0),f.literal(1),f.literal(2)]).optional(),receptionModality:f.enum(["visual","screen-reader","sonified","agent"]).optional()}).optional().describe("Audience profile \u2014 familiarity, adoption targets, exposure level, and reception modality.")},Ae,a("suggestDashboard",UV)),r.tool("suggestTokenEncoding","Recommend a semantic token / ISOTYPE encoding for a reader task. Use before drawing repeated dots, icons, glyphs, natural-frequency grids, quantile dotplots, or hybrid bar-token views. Returns the recommended tokenEncoding, warnings, alternatives, and matching suggestCharts capability intents. Accepts canonical token intents (precise-comparison, probability-estimation, risk-communication, memory, support-decision, etc.) and friendly aliases (measure, estimate probability, understand risk, remember, decide).",{taskIntent:f.string().describe("Reader task intent, e.g. 'estimate probability', 'understand risk', 'remember', 'measure', 'decide', or canonical token intents like 'probability-estimation'."),dataType:f.enum(["count","measure","distribution","probability","risk","category"]).optional().describe("Data shape or meaning behind the tokenized view."),audience:f.enum(["expert","general-public","internal"]).optional().describe("Audience for the recommendation."),precisionNeed:f.enum(["low","medium","high"]).optional().describe("How much exact magnitude reading matters."),availableSpace:f.enum(["small","medium","large"]).optional().describe("Space budget for visible tokens."),concreteEntity:f.string().optional().describe("Concrete icon/glyph concept, e.g. person, bus, server. Becomes tokenEncoding.icon when useful.")},Ae,a("suggestTokenEncoding",jV)),r.tool("suggestStretchCharts","Recommend literacy-growth chart picks for a dataset given an AudienceProfile. Returns charts the data supports but the audience is unfamiliar with (familiarity \u2264 3, or \u2264 4 at exposureLevel 2), each paired with the familiar chart it could substitute for and a rationale. Use when the consumer wants to gently expose users to less familiar but more analytically appropriate visualizations.",{data:f.array(H).describe("Row data."),audience:f.object({name:f.string().optional(),familiarity:f.record(f.string(),f.number()).optional(),targets:f.record(f.string(),f.object({direction:f.enum(["increase","decrease"]),weight:f.number().int().min(1).max(3).optional(),reason:f.string().optional()})).optional(),exposureLevel:f.union([f.literal(0),f.literal(1),f.literal(2)]).optional(),receptionModality:f.enum(["visual","screen-reader","sonified","agent"]).optional().describe("Reception channel \u2014 see suggestCharts.")}).describe("Audience profile \u2014 familiarity, targets, exposure level, reception modality."),intent:f.union([f.string(),f.array(f.string())]).optional(),maxResults:f.number().int().min(1).max(20).optional(),...ii},Ae,a("suggestStretchCharts",LV)),r.registerTool("repairChartConfig",{title:"Repair an unsuitable chart choice",description:"Validate that a chart component is a sensible choice for a dataset, and if not, propose ranked alternatives that fit. Returns a structured status of ok, alternative, or unknown.",inputSchema:{component:f.string().describe("Chart component name to validate, e.g. 'PieChart'"),data:f.array(H).describe("Row data \u2014 array of objects."),intent:f.union([f.string(),f.array(f.string())]).optional().describe("User intent \u2014 informs ranking of alternatives when the chart doesn't fit."),maxAlternatives:f.number().int().min(1).max(10).optional().describe("Cap on alternatives returned (default 3)."),...ii},outputSchema:{status:f.enum(["ok","alternative","unknown"]),component:f.string(),reason:f.string().optional(),alternatives:f.array(f.unknown()).optional(),profile:H,repairs:f.array(f.string()).optional()},annotations:Ae},a("repairChartConfig",ZV)),r.tool("proposeChartVariants","Propose and score chart variants for a selected Semiotic component. Uses the capability registry plus heuristic variant discovery: registered variants, conservative transforms, and same-intent cross-family alternatives. Returns ranked proposals with fit/novelty/risk scores, rationale, and ready-to-use props. Use after suggestCharts when an agent wants to actively explore variants rather than stop at the first chart recommendation.",{component:f.string().describe("Base chart component to vary, e.g. 'LineChart', 'BarChart', or 'BoxPlot'."),props:H.optional().describe("Existing chart props. If props.data is present it is profiled; network/hierarchy/geo object data can be passed here as raw input."),data:f.array(H).optional().describe("Row data to profile. Overrides props.data when present."),intent:f.union([f.string(),f.array(f.string())]).optional().describe("Ranking intent(s), e.g. trend, distribution, rank, compare-categories, composition-over-time."),maxResults:f.number().int().min(1).max(20).optional().describe("Cap on proposals returned (default 8)."),audience:f.object({name:f.string().optional(),familiarity:f.record(f.string(),f.number()).optional(),targets:f.record(f.string(),f.object({direction:f.enum(["increase","decrease"]),weight:f.number().int().min(1).max(3).optional(),reason:f.string().optional()})).optional(),exposureLevel:f.union([f.literal(0),f.literal(1),f.literal(2)]).optional(),receptionModality:f.enum(["visual","screen-reader","sonified","agent"]).optional().describe("Reception channel \u2014 see suggestCharts.")}).optional().describe("Audience profile \u2014 familiarity, adoption targets, exposure level, and reception modality."),...ii},Ae,a("proposeChartVariants",AV)),r.registerTool("suggestCharts",{title:"Recommend Semiotic charts",description:"Recommend Semiotic charts for a dataset using heuristic capability descriptors. Returns ranked, structured suggestions with scores, reasons, caveats, and ready-to-use props; no LLM call is made.",inputSchema:{data:f.array(H).describe("Row data \u2014 array of objects."),intent:f.union([f.string(),f.array(f.string())]).optional().describe("Ranking intent. One of: trend, compare-series, compare-categories, rank, part-to-whole, distribution, correlation, flow, hierarchy, geo, outlier-detection, composition-over-time, change-detection. Custom intents accepted."),maxResults:f.number().int().min(1).max(40).optional().describe("Cap on suggestions returned (default 8)."),allow:f.array(f.string()).optional().describe("Restrict to these component names."),deny:f.array(f.string()).optional().describe("Exclude these component names."),...ii,audience:f.object({name:f.string().optional(),familiarity:f.record(f.string(),f.number()).optional(),targets:f.record(f.string(),f.object({direction:f.enum(["increase","decrease"]),weight:f.number().int().min(1).max(3).optional(),reason:f.string().optional()})).optional(),exposureLevel:f.union([f.literal(0),f.literal(1),f.literal(2)]).optional(),receptionModality:f.enum(["visual","screen-reader","sonified","agent"]).optional().describe("Reception channel. A non-visual value down-ranks charts the audience can't receive in that channel and adds receivability caveats.")}).optional().describe("Audience profile \u2014 familiarity, adoption targets, exposure level, and reception modality.")},outputSchema:{suggestions:f.array(f.unknown())},annotations:Ae},a("suggestCharts",OV)),r}function YV(e,t){let n=Array.isArray(e)?e:[e];for(let i of n){if(!i||typeof i!="object"||Array.isArray(i))continue;let r=i;if(r.method!=="tools/call"||!r.params||typeof r.params!="object"||Array.isArray(r.params))continue;let o=r.params;if(!("arguments"in o))continue;let a=$c(o.arguments,t);if(!a.ok)return a}return null}async function QV(){let{httpMode:e,profile:t,port:n,host:i}=sE(process.argv.slice(2));if(e){let r=mE(i),o=parseInt(process.env.MCP_MAX_BODY_BYTES||"",10),a=Number.isFinite(o)&&o>0?o:4194304,s=xm(),c=(process.env.OPENAI_APPS_CHALLENGE_TOKEN||"").trim(),u=Nc(),l=KE(),d=XE(l),p=yE(process.env.MCP_TRUSTED_PROXY_HOPS),m=$E(bE()),h=(process.env.MCP_SUPPORTED_PROTOCOL_VERSIONS||"").split(",").map(q=>q.trim()).filter(Boolean),g=h[0]||Q2,y=(process.env.MCP_AUTH_TOKEN||"").trim(),$=(process.env.MCP_AUTH_SCHEME||"Bearer").trim()||"Bearer",v=Number(process.env.MCP_BODY_TIMEOUT_MS),w=Number.isInteger(v)&&v>0&&v<=2147483647?v:1e4,E=YC(t),T=()=>JSON.stringify({status:"ok",name:"semiotic-mcp",version:E.packageVersion,transport:"streamable-http",mode:"stateless",channel:E.channel,packageVersion:E.packageVersion,surfaceVersion:E.surfaceVersion,...E.commitSha?{commitSha:E.commitSha}:{},...E.buildId?{buildId:E.buildId}:{},...E.builtAt?{builtAt:E.builtAt}:{}}),R=q=>{q.writeHead(200,{"Content-Type":"application/json"}),q.end(T())};LC.createServer({headersTimeout:1e4,requestTimeout:Math.max(w,1e4),connectionsCheckingInterval:1e3},async(q,J)=>{let Ce=Date.now(),le=(()=>{try{return new URL(q.url||"/","http://localhost").pathname}catch{return"/"}})();J.setHeader("Vary","Origin");let lr=q.headers.origin,Zr=!r.allowsHost(q.headers.host);if(Zr||!r.allowsOrigin(lr)){_n(q,J),ur.warn("request_rejected",{reason:Zr?"forbidden_host":"forbidden_origin",method:q.method,route:le,status:403}),J.writeHead(403,{"Content-Type":"application/json"}),J.end(JSON.stringify({jsonrpc:"2.0",error:{code:-32e3,message:Zr?"Forbidden host":"Forbidden origin"},id:null}));return}if(lr!==void 0&&(J.setHeader("Access-Control-Allow-Origin",lr),J.setHeader("Access-Control-Allow-Methods","GET, POST, OPTIONS"),J.setHeader("Access-Control-Allow-Headers","Content-Type, Accept, Authorization, mcp-session-id, MCP-Protocol-Version, Last-Event-ID"),J.setHeader("Access-Control-Expose-Headers","MCP-Protocol-Version")),q.method==="OPTIONS"){J.writeHead(204),J.end();return}if(J.setHeader("MCP-Protocol-Version",g),q.method==="GET"&&le==="/health"){R(J);return}if(q.method==="GET"&&le==="/.well-known/openai-apps-challenge"&&c){J.writeHead(200,{"Content-Type":"text/plain; charset=utf-8","Cache-Control":"no-store"}),J.end(c);return}if(le!=="/"&&le!=="/mcp"){_n(q,J),J.writeHead(404,{"Content-Type":"application/json"}),J.end(JSON.stringify({error:"Not found"}));return}if(q.method==="GET"){if(le==="/mcp"){J.writeHead(405,{"Content-Type":"application/json",Allow:"POST, OPTIONS"}),J.end(JSON.stringify({jsonrpc:"2.0",error:{code:-32e3,message:"Method not allowed (stateless server offers no SSE stream)"},id:null}));return}R(J);return}if(q.method!=="POST"){_n(q,J),J.writeHead(405,{"Content-Type":"application/json",Allow:"POST, OPTIONS"}),J.end(JSON.stringify({jsonrpc:"2.0",error:{code:-32e3,message:"Method not allowed"},id:null}));return}let ea=ZE(q,J);if(!iV(String(q.headers.accept||""))){_n(q,J),ur.warn("request_rejected",{reason:"unsupported_accept",method:q.method,route:le,status:406}),Ko(J,406,-32e3,"Not Acceptable: this endpoint supports JSON transport only");return}if(!oV(String(q.headers["mcp-protocol-version"]||""),h)){_n(q,J),ur.warn("request_rejected",{reason:"unsupported_protocol_version",method:q.method,route:le,status:400,protocolVersionPresent:!!q.headers["mcp-protocol-version"]}),Ko(J,400,-32e3,"Unsupported MCP protocol version");return}if(y&&!hE(q.headers.authorization,y,$)){_n(q,J),ur.warn("request_rejected",{reason:"unauthorized",method:q.method,route:le,status:401}),J.setHeader("WWW-Authenticate",`${$} realm="semiotic-mcp"`),Ko(J,401,-32e3,"Unauthorized");return}let Wt=await m.readBody(q,a,w);if(ea.aborted)return;if(!Wt.ok){ur.warn("request_rejected",{reason:Wt.reason,method:q.method,route:le,status:Wt.status}),_n(q,J),Wt.status===429&&J.setHeader("Retry-After","1"),Ko(J,Wt.status,Wt.code,Wt.message);return}let Bm=YV(Wt.body,s);if(Bm&&!Bm.ok){ur.warn("request_rejected",{reason:"operation_limit",method:q.method,route:le,status:413}),Ko(J,413,-32602,xc(Bm));return}let ta=d.tryAcquire(Date.now(),vE(q.socket.remoteAddress,q.headers["x-forwarded-for"],p));if(!ta.ok){J.setHeader("Retry-After",String(Math.max(1,Math.ceil(ta.retryAfterMs/1e3)))),ur.warn("request_rejected",{reason:ta.code==="MCP_REQUEST_CONCURRENCY"?"request_concurrency":"request_rate",method:q.method,route:le,status:429}),Ko(J,429,-32e3,ta.message);return}try{let o$=t$(t,{signal:ea,limits:u}),Hm=new vm({sessionIdGenerator:void 0,enableJsonResponse:!0}),a$=!1,s$=()=>{a$||(a$=!0,Promise.resolve(Hm.close()).catch(()=>{}),Promise.resolve(o$.close()).catch(()=>{}))};J.on("close",s$);try{await o$.connect(Ib(kb(Hm,s))),await lE(Hm,q,J,Wt.body,ea),ur.info("request_completed",{method:q.method,route:le,status:J.statusCode,durationMs:Date.now()-Ce,bodyBytes:Wt.bodyBytes})}catch{ur.error("request_failed",{reason:"request_handler_error",method:q.method,route:le,status:500,durationMs:Date.now()-Ce,bodyBytes:Wt.bodyBytes}),J.headersSent||(J.writeHead(500,{"Content-Type":"application/json"}),J.end(JSON.stringify({jsonrpc:"2.0",error:{code:-32603,message:"Internal server error"},id:null})))}finally{s$()}}finally{ta.release()}}).listen(n,i,()=>{ur.info("service_started",{profile:t,retentionDays:JC.retentionDays})})}else{let r=t$(t),o=new ym(nE(process.stdin,process.stdout,Cc(process.env.MCP_MAX_BODY_BYTES,4*1024*1024)));await r.connect(Ib(kb(o,xm())))}}async function eF(e){let t=t$(e.profile),[n,i]=_m.createLinkedPair();n.onmessage=r=>{!("id"in r)||r.id!==1||("result"in r?process.send?.({type:"result",result:$m(r.result)}):process.send?.({type:"failure"}))},await t.connect(i),await n.start(),await n.send({jsonrpc:"2.0",id:1,method:"tools/call",params:{name:e.name,arguments:e.arguments}})}wc()?(process.once("message",e=>{eF(e).catch(()=>process.send?.({type:"failure"}))}),process.once("disconnect",()=>process.exit(0))):QV().catch(e=>{ur.error("service_fatal",{reason:e instanceof wr?e.code:"service_startup_failure"}),process.exit(1)});
|
|
458
|
+
`))),e==="public")return r.registerTool("createChart",{title:"Create and prove a chart",description:"Select, validate, diagnose, render, and prove a static-data Semiotic chart. This is the default public workflow.",inputSchema:{data:f.array(H).min(1),intent:f.union([f.string(),f.array(f.string())]).optional(),audience:f.object({name:f.string().optional(),receptionModality:f.enum(["visual","screen-reader","sonified","agent"]).optional()}).passthrough().optional(),...ii,component:f.string().optional().describe("Optional chart preference; the fit-ranked result remains authoritative."),props:H.optional().describe("Optional props to merge over the selected chart recipe."),theme:f.record(f.string(),f.string()).optional()},outputSchema:{status:f.enum(["render-proven","blocked","no-suggestion"]),component:f.string().optional(),evidenceEnvelope:H.optional(),evidenceGate:H.optional(),surfaceVersion:f.string()},annotations:Ae,_meta:{ui:{resourceUri:Ic},"openai/outputTemplate":Ic}},a("createChart",u=>FV(u,i))),r.registerTool("improveChart",{title:"Improve an existing chart",description:"Diagnose a chart configuration, assess data fit, and propose repairs or variants.",inputSchema:{component:f.string(),props:H,data:f.array(H).optional(),intent:f.union([f.string(),f.array(f.string())]).optional(),...ii},outputSchema:{status:f.enum(["reviewed","repair-needed"]),component:f.string(),diagnostics:f.array(f.unknown()),repair:H,variants:f.array(f.unknown()),accessibilityRecommendation:f.object({location:f.literal("direct-component-props"),props:f.record(f.string(),f.string()),chartContainer:H}).optional(),evidenceFragment:H.optional(),surfaceVersion:f.string()},annotations:Ae},a("improveChart",qV)),r.registerTool("explainChart",{title:"Explain a chart without pixels",description:"Return reader grounding: chart description, communicative intent, and navigable data structure.",inputSchema:{component:f.string(),props:H},outputSchema:{status:f.literal("grounded"),grounding:H,evidenceFragment:H.optional(),surfaceVersion:f.string()},annotations:Ae},a("explainChart",BV)),r.registerTool("auditChart",{title:"Audit chart quality and accessibility",description:"Run design diagnostics plus accessibility and mobile audits, returning prioritized structured findings.",inputSchema:{component:f.string(),props:H,viewportWidth:f.number().int().min(240).max(1600).optional()},outputSchema:{status:f.enum(["passed","findings"]),component:f.string(),evidenceEnvelope:H.optional(),evidenceGate:H.optional(),surfaceVersion:f.string()},annotations:Ae},a("auditChart",HV)),r.registerTool("getChartSchema",{title:"Get a chart schema",description:"Return canonical Semiotic prop-schema guidance for code editing and advanced configuration.",inputSchema:{component:f.string().optional()},outputSchema:{status:f.enum(["component-list","component-schema","unknown-component"]),component:f.string().optional(),renderable:f.boolean().optional(),availableComponents:f.array(f.object({name:f.string(),renderable:f.boolean()})).optional(),schema:H.optional(),accessibility:f.object({directProps:H,chartContainer:H}).optional(),behaviorContracts:f.array(f.unknown()).optional(),surfaceVersion:f.string()},annotations:Ae},a("getChartSchema",DC)),r;r.registerTool("auditArtifact",{title:"Audit an explicit artifact contract",description:"Evaluate a chart and its explicit artifact contract under a named policy. The tool audits only supplied claims, evidence, source identity, review state, and time state; missing facts remain missing or unknown. Results are capped and report truncation explicitly.",inputSchema:{component:f.string().describe("Semiotic component name."),props:H.optional().describe("Chart props/config. Data may be supplied here or separately."),data:f.array(H).max(1e4).optional().describe("Optional explicit row data overriding props.data."),contract:Tc,policyId:Nm,exceptions:f.array(Qo).max(20).optional(),now:Yo.optional()},outputSchema:{status:f.enum(["acceptable","conditional","refuse","invalid-contract"]),policy:jm,contractValidation:Dm,obligationSummary:Xb.optional(),claimSummary:Xb.optional(),temporalSummary:Xb.optional(),obligations:f.array(OC).max(50).optional(),selectedRepresentation:Pc.optional(),alternatives:f.array(Pc).max(8).optional(),repairs:f.array(NC).max(50).optional(),manualChecks:f.array(f.string()).max(25).optional(),truncated:f.object({obligations:f.boolean(),alternatives:f.boolean(),repairs:f.boolean(),manualChecks:f.boolean()}).optional(),surfaceVersion:f.string()},annotations:Ae},a("auditArtifact",GV)),r.registerTool("recommendRepresentation",{title:"Recommend a defensible representation",description:"Recommend chart and non-chart outcomes from explicit data and an explicit artifact contract. Evidence, source, review, and time facts are never synthesized. The named policy can recommend waiting, collecting data, or making no claim instead of forcing a chart.",inputSchema:{data:f.array(H).max(1e4).optional().describe("Explicit row data; omit only when contract evidence is sufficient."),contract:Tc,policyId:Nm,exceptions:f.array(Qo).max(20).optional(),now:Yo.optional(),intent:f.union([f.string(),f.array(f.string()).max(12)]).optional(),preferredComponent:f.string().max(120).optional().describe("Optional Semiotic component preference."),maxChartCandidates:f.number().int().min(1).max(8).optional(),identifiers:f.array(f.string()).max(64).optional()},outputSchema:{status:f.enum(["recommended","conditional","refuse","invalid-contract"]),policy:jm,contractValidation:Dm,selected:Pc.optional(),alternatives:f.array(Pc).max(8).optional(),rejected:f.array(Pc.extend({rejectedBecause:f.string()})).max(8).optional(),reasons:f.array(f.string()).max(12).optional(),truncated:f.object({alternatives:f.boolean(),rejected:f.boolean(),reasons:f.boolean()}).optional(),surfaceVersion:f.string()},annotations:Ae},a("recommendRepresentation",WV)),r.registerTool("repairArtifact",{title:"Repair an explicit artifact contract",description:"Propose repairs for a chart and explicit artifact contract. By default this is proposal-only. If enabled, safe application fills missing component and configuration/data identity fields only; existing bindings are never overwritten. Mismatches require an explicit revision and claim reassessment. Source, evidence, review, approval, and time facts are never invented. Returned contracts omit evidence samples, report transfer losses, and are withheld above a 64 KiB UTF-8 cap.",inputSchema:{component:f.string().describe("Semiotic component name."),props:H.optional(),data:f.array(H).max(1e4).optional(),contract:Tc,policyId:Nm,exceptions:f.array(Qo).max(20).optional(),now:Yo.optional(),applySafeIdentityRepairs:f.boolean().optional().describe("Fill missing identity fields only; existing mismatches require an explicit revision and claim reassessment. Defaults to false.")},outputSchema:{status:f.enum(["unchanged","repaired","requires-input","invalid-contract"]),policy:jm,contractValidation:Dm,contract:Tc.optional(),contractTransfer:bV.optional(),beforeStatus:f.enum(["acceptable","conditional","refuse"]).optional(),afterStatus:f.enum(["acceptable","conditional","refuse"]).optional(),ledger:f.array(_V).max(50).optional(),truncated:f.object({ledger:f.boolean(),contract:f.boolean(),transfer:f.boolean()}).optional(),surfaceVersion:f.string()},annotations:Ae},a("repairArtifact",KV)),r.registerTool("explainRefusal",{title:"Explain an artifact policy refusal",description:"Evaluate an explicit artifact contract under a named policy and explain why publication or action is refused. Missing evidence, source, review, and time facts stay explicit rather than being guessed.",inputSchema:{component:f.string().describe("Semiotic component name."),props:H.optional(),data:f.array(H).max(1e4).optional(),contract:Tc,policyId:Nm,exceptions:f.array(Qo).max(20).optional(),now:Yo.optional()},outputSchema:{status:f.enum(["refuse","not-refused","invalid-contract"]),evaluationStatus:f.enum(["acceptable","conditional","refuse"]).optional(),policy:jm,contractValidation:Dm,explanation:f.string().optional(),failures:f.array(OC).max(20).optional(),repairs:f.array(NC).max(20).optional(),truncated:f.object({failures:f.boolean(),repairs:f.boolean(),explanation:f.boolean()}).optional(),surfaceVersion:f.string()},annotations:Ae},a("explainRefusal",XV)),r.tool("getSchema","Return the prop schema for a Semiotic chart component. Pass { component: '<name>' } to get its props, or omit component to list all available components. Components marked [renderable] can be passed to renderChart for static SVG output.",{component:f.string().optional().describe("Component name, e.g. 'LineChart'. Omit to list all.")},Ae,a("getSchema",DC)),r.tool("suggestChart","Lightweight heuristic chart recommender for a small data sample (1-5 rows) with capability filtering (push API, linked hover, SSR, selection, legend). Returns ranked recommendations with example props. For richer capability-descriptor ranking (scores, reasons, caveats) and the full 13-intent taxonomy, prefer `suggestCharts` (plural).",{data:f.array(H).min(1).max(5).describe("1-5 sample data objects"),intent:f.string().optional().describe("Visualization intent. Accepts this engine's intents (comparison, trend, distribution, relationship, composition, geographic, network, hierarchy) AND the richer suggestCharts taxonomy (compare-categories, part-to-whole, correlation, flow, geo, rank, \u2026), which is translated automatically; an unrecognized intent is ignored rather than rejected."),capabilities:f.object({push:f.boolean().optional().describe("Require ref-based push API (live streaming via ref.current.push())"),linkedHover:f.boolean().optional().describe("Require cross-chart linked hover support"),ssr:f.boolean().optional().describe("Require server-side rendering via renderChart()"),selection:f.boolean().optional().describe("Require named selection / cross-filter support"),legend:f.boolean().optional().describe("Require a top-level legend")}).strict().optional().describe("Capability constraints \u2014 set a key to true to require, false to forbid. Unset keys are ignored.")},Ae,a("suggestChart",SV)),r.tool("renderChart",`Render a Semiotic chart to static SVG or PNG. This is a static snapshot path: props must include data immediately, and ref/push-mode charts cannot be rendered through this tool. Returns SVG text by default or an image/png artifact when format='png', plus a "Render evidence" JSON block (mark counts by type, resolved axis domains, empty flag, annotation count, accessible name) \u2014 read the evidence instead of parsing the SVG to verify the chart actually rendered data marks. An optional explicit contract is preserved in render evidence together with its transfer status; missing contract facts are not inferred. Optionally pass theme CSS custom properties (--semiotic-bg, --semiotic-text, etc.) to style the output. PNG requires the 'sharp' package to be installed. Available components: ${Ec.join(", ")}.`,{component:f.string().describe("Chart component name, e.g. 'LineChart', 'BarChart'"),props:H.optional().describe("Chart props object, e.g. { data: [...], xAccessor: 'x' }."),contract:H.optional().describe("Optional explicit artifact contract. The render evidence reports whether it was preserved, invalid, or an unsupported version."),theme:f.record(f.string(),f.string()).optional().describe("CSS custom properties for theming, e.g. { '--semiotic-bg': '#1a1a2e', '--semiotic-text': '#ededed' }. Only --semiotic-* variables are applied."),format:f.enum(["svg","png"]).optional().describe("Output format: 'svg' (default) returns SVG markup, 'png' returns image/png artifact data. PNG requires the 'sharp' package.")},Ae,a("renderChart",u=>n$(u,i))),r.registerTool("renderInteractiveChart",{title:"Render interactive Semiotic chart",description:`Render a static-data Semiotic chart as a ChatGPT Apps widget. Use this after suggestCharts/getSchema/diagnoseConfig when the user wants to see an interactive chart inside ChatGPT. The server renders Semiotic to SVG and the widget adds fit, zoom, data, hover, and render-evidence controls. Available components: ${Ec.join(", ")}.`,inputSchema:{component:f.string().describe("Renderable chart component name, e.g. 'LineChart', 'BarChart', 'GaugeChart'."),props:H.optional().describe("Static Semiotic chart props, including data/accessors where required."),theme:f.record(f.string(),f.string()).optional().describe("CSS custom properties such as { '--semiotic-bg': '#fff', '--semiotic-text': '#111' }. Only --semiotic-* variables are applied.")},outputSchema:{component:f.string(),title:f.string(),summary:f.string(),datumCount:f.number().nullable(),evidence:H.nullable()},annotations:{readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0,openWorldHint:!1},_meta:{ui:{resourceUri:Ic},"openai/outputTemplate":Ic,"openai/toolInvocation/invoking":"Rendering Semiotic chart...","openai/toolInvocation/invoked":"Rendered Semiotic chart."}},a("renderInteractiveChart",async u=>(await QC(u,i)).result)),r.tool("diagnoseConfig","Diagnose a Semiotic chart configuration for common problems (empty data, bad dimensions, missing accessors, wrong data shape, color contrast issues, etc). Pass usageMode='push' for ref-based React HOCs that intentionally omit data; omit usageMode or pass 'static' for renderChart/MCP/server configs where data is required. Checks WCAG color contrast ratios and suggests COLOR_BLIND_SAFE_CATEGORICAL for accessibility. Returns a human-readable diagnostic report with actionable fixes.",{component:f.string().describe("Chart component name, e.g. 'LineChart'"),props:H.optional().describe("Chart props object, e.g. { data: [...], xAccessor: 'x' }."),usageMode:f.enum(["static","push","renderChart","server"]).optional().describe("Validation mode. Use 'push' for ref-based React HOCs that omit data; use 'static' or omit for renderChart/MCP/static data configs.")},Ae,a("diagnoseConfig",IV)),r.tool("auditAccessibility","Audit a Semiotic chart configuration against the Chartability (POUR-CAF) accessibility framework \u2014 Perceivable, Operable, Understandable, Robust, Compromising, Assistive, Flexible. Statically grades the config (no DOM/AT): credits the built-ins every HOC ships (keyboard nav, focus ring, skip link, screen-reader data table, reduced-motion + forced-colors, shareable state), flags author-actionable gaps (missing title/description/summary, low contrast, small text, color-only encoding, undescribed trends, data density), and routes everything that needs real assistive-technology testing to a 'manual' item. Returns a per-principle report with the 14 critical heuristics marked. Pass inChartContainer=true to credit data-download/share affordances. Pair with manual NVDA/JAWS/VoiceOver testing \u2014 Chartability is not a pass/fail certification.",{component:f.string().describe("Chart component name, e.g. 'LineChart'"),props:H.optional().describe("Chart props object, e.g. { data: [...], xAccessor: 'x', title: '...' }."),inChartContainer:f.boolean().optional().describe("True if the chart is (or will be) wrapped in a ChartContainer exposing data-download/copy-config actions."),describe:f.boolean().optional().describe("True if ChartContainer's describe option (auto-generated L1\u2013L3 description via describeChart) is enabled \u2014 passes the 'features described' heuristic."),navigable:f.boolean().optional().describe("True if ChartContainer's navigable option (structured navigation tree via buildNavigationTree) is enabled \u2014 passes the 'navigable structure' heuristic.")},Ae,a("auditAccessibility",TV)),r.tool("evaluateChart","Evaluate a Semiotic chart through one deterministic quality pass: numeric data contracts, configuration and representation/deception checks, and static Chartability accessibility heuristics. Returns the independent audit reports plus a severity-ranked findings list and notification feed. Pass data separately when it should override props.data; use inChartContainer, describe, or navigable to describe the intended accessibility wrapper. This is static analysis and does not replace manual assistive-technology testing or render evidence.",{component:f.string().describe("Chart component name, e.g. 'LineChart'."),props:H.optional().describe("Chart props/config, including accessors and optional data."),data:f.array(H).optional().describe("Optional explicit dataset. When supplied, this is used as the effective props.data for evaluation."),inChartContainer:f.boolean().optional().describe("Whether the chart will be wrapped in ChartContainer or an equivalent control surface."),describe:f.boolean().optional().describe("Whether ChartContainer's generated description is enabled."),navigable:f.boolean().optional().describe("Whether ChartContainer's structured navigation tree is enabled.")},Ae,a("evaluateChart",PV)),r.tool("auditMobileVisualization","Audit a Semiotic chart configuration for mobile visualization risks. Use before generating phone-sized charts or when adapting a desktop chart to mobile. Flags fixed desktop widths, rough mark-density overload, hover-only detail, small touch targets, complex gestures without controls, legend dependence, annotation overload, and missing mobile transformation hints. Static analysis only: still verify rendered charts at phone widths.",{component:f.string().describe("Chart component name, e.g. 'LineChart', 'Scatterplot', or 'BarChart'."),props:H.optional().describe("Chart props/config to audit."),viewportWidth:f.number().int().min(240).max(1600).optional().describe("Mobile viewport width in CSS pixels. Defaults to 390."),targetSize:f.number().int().min(24).max(80).optional().describe("Desired comfortable touch target size in CSS pixels. Defaults to 44."),inChartContainer:f.boolean().optional().describe("Whether the chart is wrapped in ChartContainer or an equivalent summary/control surface.")},Ae,a("auditMobileVisualization",EV)),r.tool("reportIssue","Generate a GitHub issue URL for Semiotic bug reports or feature requests. Returns a URL the user can open to submit. For rendering bugs, include the component name, props summary, and any diagnoseConfig output in the body.",{title:f.string().describe("Issue title, e.g. 'Bug: BarChart tooltip shows undefined'"),body:f.string().optional().describe("Issue body with details, reproduction steps, diagnoseConfig output"),labels:f.union([f.array(f.string()),f.string()]).optional().describe("GitHub labels, e.g. ['bug'] or 'bug'")},Ae,a("reportIssue",CV)),r.tool("applyTheme",`Get usage instructions for a named Semiotic theme preset. Returns ThemeProvider examples, CSS custom properties, and design token export patterns. Available themes: ${Xo.join(", ")}.`,{name:f.string().optional().describe("Theme preset name, e.g. 'tufte', 'pastels-dark', 'bi-tool'. Omit to list all available themes.")},Ae,a("applyTheme",zV)),r.tool("interrogateChart","Conversational interrogation of a Semiotic chart. Extract a statistical summary and answer natural language questions about the data, trends, and outliers. Returns a summary and guidance for an AI to generate a textual answer and visual annotations.",{component:f.string().describe("Chart component name, e.g. 'LineChart'"),props:H.describe("The full chart props including data"),query:f.string().optional().describe("A natural language question about the chart data")},Ae,a("interrogateChart",VV)),r.registerTool("groundChart",{title:"Ground a Semiotic chart for a non-visual reader",description:"Build the agent-reader grounding payload for a Semiotic chart: the layered L1\u2013L3 natural-language description, the L4 communicative-act sentence (what the chart is asking the reader to do), and a structured navigation tree (chart \u2192 axes/series \u2192 datum). Use this to interpret a chart faithfully without pixels.",inputSchema:{component:f.string().describe("Chart component name, e.g. 'LineChart'"),props:H.describe("The full chart props including data")},outputSchema:{component:f.string(),description:H,intent:H.optional(),structure:H.optional(),physics:H.optional(),text:f.string()},annotations:Ae},a("groundChart",iz));let c=f.object({fields:f.array(f.object({name:f.string(),kind:f.enum(["numeric","categorical","date","boolean"]),role:f.enum(["x","y","value","category","series","size","key"]).optional(),cardinality:f.number().min(0).optional().describe("Expected distinct values for a categorical, boolean, or key field."),additive:f.boolean().optional().describe("Whether summing the measure across events is meaningful (counts, amounts, changes) or not (prices, latencies, percentages).")}).passthrough()),throughput:f.union([f.enum(["low","medium","high"]),f.number()]).optional(),retention:f.enum(["windowed","cumulative"]).optional(),shape:f.enum(["append","keyed","aggregate"]).optional(),keyFields:f.array(f.string()).optional()}).passthrough();return r.tool("suggestStreamCharts","Recommend streaming Semiotic charts for a schema (not row data). Pass fields (with optional cardinality and additive hints) plus optional throughput (band or rows/sec), retention, shape ('append'|'keyed'|'aggregate'), and keyFields. Ranks realtime XY charts plus push-capable ordinal/value/xy charts (BarChart, PieChart, Scatterplot, BigNumber, GaugeChart, \u2026). Returns suggestions, excluded fits-reasons, the ranking intents (inferred when none is given), schema warnings, and optional stretch picks when audience is set.",{schema:c.describe("Stream schema \u2014 fields plus throughput/retention/shape hints. No row data."),intent:f.union([f.string(),f.array(f.string())]).optional().describe("Ranking intent."),maxResults:f.number().int().min(1).max(20).optional(),audience:H.optional()},Ae,a("suggestStreamCharts",DV)),r.tool("suggestStreamDashboard","Compose a multi-panel dashboard from one or more stream schemas. Honors AudienceProfile.dashboard layout policy (cellBudget, leadFamilies, windowPreference).",{schemas:f.union([c,f.array(c).min(1)]),intent:f.union([f.string(),f.array(f.string())]).optional(),budget:f.number().int().min(1).max(12).optional(),audience:H.optional()},Ae,a("suggestStreamDashboard",MV)),r.tool("suggestDashboard","Generate a dashboard of complementary chart panels for a dataset \u2014 each panel answers a distinct analytical intent (trend, rank, distribution, correlation, etc.) and the engine diversifies by chart family by default. Heuristic only; no LLM call. Use when the user asks 'show me this data' or 'build me a dashboard' rather than picking one chart.",{data:f.array(H).describe("Row data \u2014 array of objects."),intents:f.array(f.string()).optional().describe("Intents to cover. Omit to let the engine pick based on the data shape."),maxPanels:f.number().int().min(1).max(12).optional().describe("Maximum panels (default 6)."),diversifyByFamily:f.boolean().optional().describe("Prefer not to repeat chart families across panels (default true)."),...ii,audience:f.object({name:f.string().optional(),familiarity:f.record(f.string(),f.number()).optional(),targets:f.record(f.string(),f.object({direction:f.enum(["increase","decrease"]),weight:f.number().int().min(1).max(3).optional(),reason:f.string().optional()})).optional(),exposureLevel:f.union([f.literal(0),f.literal(1),f.literal(2)]).optional(),receptionModality:f.enum(["visual","screen-reader","sonified","agent"]).optional()}).optional().describe("Audience profile \u2014 familiarity, adoption targets, exposure level, and reception modality.")},Ae,a("suggestDashboard",UV)),r.tool("suggestTokenEncoding","Recommend a semantic token / ISOTYPE encoding for a reader task. Use before drawing repeated dots, icons, glyphs, natural-frequency grids, quantile dotplots, or hybrid bar-token views. Returns the recommended tokenEncoding, warnings, alternatives, and matching suggestCharts capability intents. Accepts canonical token intents (precise-comparison, probability-estimation, risk-communication, memory, support-decision, etc.) and friendly aliases (measure, estimate probability, understand risk, remember, decide).",{taskIntent:f.string().describe("Reader task intent, e.g. 'estimate probability', 'understand risk', 'remember', 'measure', 'decide', or canonical token intents like 'probability-estimation'."),dataType:f.enum(["count","measure","distribution","probability","risk","category"]).optional().describe("Data shape or meaning behind the tokenized view."),audience:f.enum(["expert","general-public","internal"]).optional().describe("Audience for the recommendation."),precisionNeed:f.enum(["low","medium","high"]).optional().describe("How much exact magnitude reading matters."),availableSpace:f.enum(["small","medium","large"]).optional().describe("Space budget for visible tokens."),concreteEntity:f.string().optional().describe("Concrete icon/glyph concept, e.g. person, bus, server. Becomes tokenEncoding.icon when useful.")},Ae,a("suggestTokenEncoding",jV)),r.tool("suggestStretchCharts","Recommend literacy-growth chart picks for a dataset given an AudienceProfile. Returns charts the data supports but the audience is unfamiliar with (familiarity \u2264 3, or \u2264 4 at exposureLevel 2), each paired with the familiar chart it could substitute for and a rationale. Use when the consumer wants to gently expose users to less familiar but more analytically appropriate visualizations.",{data:f.array(H).describe("Row data."),audience:f.object({name:f.string().optional(),familiarity:f.record(f.string(),f.number()).optional(),targets:f.record(f.string(),f.object({direction:f.enum(["increase","decrease"]),weight:f.number().int().min(1).max(3).optional(),reason:f.string().optional()})).optional(),exposureLevel:f.union([f.literal(0),f.literal(1),f.literal(2)]).optional(),receptionModality:f.enum(["visual","screen-reader","sonified","agent"]).optional().describe("Reception channel \u2014 see suggestCharts.")}).describe("Audience profile \u2014 familiarity, targets, exposure level, reception modality."),intent:f.union([f.string(),f.array(f.string())]).optional(),maxResults:f.number().int().min(1).max(20).optional(),...ii},Ae,a("suggestStretchCharts",LV)),r.registerTool("repairChartConfig",{title:"Repair an unsuitable chart choice",description:"Validate that a chart component is a sensible choice for a dataset, and if not, propose ranked alternatives that fit. Returns a structured status of ok, alternative, or unknown.",inputSchema:{component:f.string().describe("Chart component name to validate, e.g. 'PieChart'"),data:f.array(H).describe("Row data \u2014 array of objects."),intent:f.union([f.string(),f.array(f.string())]).optional().describe("User intent \u2014 informs ranking of alternatives when the chart doesn't fit."),maxAlternatives:f.number().int().min(1).max(10).optional().describe("Cap on alternatives returned (default 3)."),...ii},outputSchema:{status:f.enum(["ok","alternative","unknown"]),component:f.string(),reason:f.string().optional(),alternatives:f.array(f.unknown()).optional(),profile:H,repairs:f.array(f.string()).optional()},annotations:Ae},a("repairChartConfig",ZV)),r.tool("proposeChartVariants","Propose and score chart variants for a selected Semiotic component. Uses the capability registry plus heuristic variant discovery: registered variants, conservative transforms, and same-intent cross-family alternatives. Returns ranked proposals with fit/novelty/risk scores, rationale, and ready-to-use props. Use after suggestCharts when an agent wants to actively explore variants rather than stop at the first chart recommendation.",{component:f.string().describe("Base chart component to vary, e.g. 'LineChart', 'BarChart', or 'BoxPlot'."),props:H.optional().describe("Existing chart props. If props.data is present it is profiled; network/hierarchy/geo object data can be passed here as raw input."),data:f.array(H).optional().describe("Row data to profile. Overrides props.data when present."),intent:f.union([f.string(),f.array(f.string())]).optional().describe("Ranking intent(s), e.g. trend, distribution, rank, compare-categories, composition-over-time."),maxResults:f.number().int().min(1).max(20).optional().describe("Cap on proposals returned (default 8)."),audience:f.object({name:f.string().optional(),familiarity:f.record(f.string(),f.number()).optional(),targets:f.record(f.string(),f.object({direction:f.enum(["increase","decrease"]),weight:f.number().int().min(1).max(3).optional(),reason:f.string().optional()})).optional(),exposureLevel:f.union([f.literal(0),f.literal(1),f.literal(2)]).optional(),receptionModality:f.enum(["visual","screen-reader","sonified","agent"]).optional().describe("Reception channel \u2014 see suggestCharts.")}).optional().describe("Audience profile \u2014 familiarity, adoption targets, exposure level, and reception modality."),...ii},Ae,a("proposeChartVariants",AV)),r.registerTool("suggestCharts",{title:"Recommend Semiotic charts",description:"Recommend Semiotic charts for a dataset using heuristic capability descriptors. Returns ranked, structured suggestions with scores, reasons, caveats, and ready-to-use props; no LLM call is made.",inputSchema:{data:f.array(H).describe("Row data \u2014 array of objects."),intent:f.union([f.string(),f.array(f.string())]).optional().describe("Ranking intent. One of: trend, compare-series, compare-categories, rank, part-to-whole, distribution, correlation, flow, hierarchy, geo, outlier-detection, composition-over-time, change-detection. Custom intents accepted."),maxResults:f.number().int().min(1).max(40).optional().describe("Cap on suggestions returned (default 8)."),allow:f.array(f.string()).optional().describe("Restrict to these component names."),deny:f.array(f.string()).optional().describe("Exclude these component names."),...ii,audience:f.object({name:f.string().optional(),familiarity:f.record(f.string(),f.number()).optional(),targets:f.record(f.string(),f.object({direction:f.enum(["increase","decrease"]),weight:f.number().int().min(1).max(3).optional(),reason:f.string().optional()})).optional(),exposureLevel:f.union([f.literal(0),f.literal(1),f.literal(2)]).optional(),receptionModality:f.enum(["visual","screen-reader","sonified","agent"]).optional().describe("Reception channel. A non-visual value down-ranks charts the audience can't receive in that channel and adds receivability caveats.")}).optional().describe("Audience profile \u2014 familiarity, adoption targets, exposure level, and reception modality.")},outputSchema:{suggestions:f.array(f.unknown())},annotations:Ae},a("suggestCharts",OV)),r}function YV(e,t){let n=Array.isArray(e)?e:[e];for(let i of n){if(!i||typeof i!="object"||Array.isArray(i))continue;let r=i;if(r.method!=="tools/call"||!r.params||typeof r.params!="object"||Array.isArray(r.params))continue;let o=r.params;if(!("arguments"in o))continue;let a=$c(o.arguments,t);if(!a.ok)return a}return null}async function QV(){let{httpMode:e,profile:t,port:n,host:i}=sE(process.argv.slice(2));if(e){let r=mE(i),o=parseInt(process.env.MCP_MAX_BODY_BYTES||"",10),a=Number.isFinite(o)&&o>0?o:4194304,s=xm(),c=(process.env.OPENAI_APPS_CHALLENGE_TOKEN||"").trim(),u=Nc(),l=KE(),d=XE(l),p=yE(process.env.MCP_TRUSTED_PROXY_HOPS),m=$E(bE()),h=(process.env.MCP_SUPPORTED_PROTOCOL_VERSIONS||"").split(",").map(q=>q.trim()).filter(Boolean),g=h[0]||Q2,y=(process.env.MCP_AUTH_TOKEN||"").trim(),$=(process.env.MCP_AUTH_SCHEME||"Bearer").trim()||"Bearer",v=Number(process.env.MCP_BODY_TIMEOUT_MS),w=Number.isInteger(v)&&v>0&&v<=2147483647?v:1e4,E=YC(t),T=()=>JSON.stringify({status:"ok",name:"semiotic-mcp",version:E.packageVersion,transport:"streamable-http",mode:"stateless",channel:E.channel,packageVersion:E.packageVersion,surfaceVersion:E.surfaceVersion,...E.commitSha?{commitSha:E.commitSha}:{},...E.buildId?{buildId:E.buildId}:{},...E.builtAt?{builtAt:E.builtAt}:{}}),R=q=>{q.writeHead(200,{"Content-Type":"application/json"}),q.end(T())};LC.createServer({headersTimeout:1e4,requestTimeout:Math.max(w,1e4),connectionsCheckingInterval:1e3},async(q,J)=>{let Ce=Date.now(),le=(()=>{try{return new URL(q.url||"/","http://localhost").pathname}catch{return"/"}})();J.setHeader("Vary","Origin");let lr=q.headers.origin,Zr=!r.allowsHost(q.headers.host);if(Zr||!r.allowsOrigin(lr)){_n(q,J),ur.warn("request_rejected",{reason:Zr?"forbidden_host":"forbidden_origin",method:q.method,route:le,status:403}),J.writeHead(403,{"Content-Type":"application/json"}),J.end(JSON.stringify({jsonrpc:"2.0",error:{code:-32e3,message:Zr?"Forbidden host":"Forbidden origin"},id:null}));return}if(lr!==void 0&&(J.setHeader("Access-Control-Allow-Origin",lr),J.setHeader("Access-Control-Allow-Methods","GET, POST, OPTIONS"),J.setHeader("Access-Control-Allow-Headers","Content-Type, Accept, Authorization, mcp-session-id, MCP-Protocol-Version, Last-Event-ID"),J.setHeader("Access-Control-Expose-Headers","MCP-Protocol-Version")),q.method==="OPTIONS"){J.writeHead(204),J.end();return}if(J.setHeader("MCP-Protocol-Version",g),q.method==="GET"&&le==="/health"){R(J);return}if(q.method==="GET"&&le==="/.well-known/openai-apps-challenge"&&c){J.writeHead(200,{"Content-Type":"text/plain; charset=utf-8","Cache-Control":"no-store"}),J.end(c);return}if(le!=="/"&&le!=="/mcp"){_n(q,J),J.writeHead(404,{"Content-Type":"application/json"}),J.end(JSON.stringify({error:"Not found"}));return}if(q.method==="GET"){if(le==="/mcp"){J.writeHead(405,{"Content-Type":"application/json",Allow:"POST, OPTIONS"}),J.end(JSON.stringify({jsonrpc:"2.0",error:{code:-32e3,message:"Method not allowed (stateless server offers no SSE stream)"},id:null}));return}R(J);return}if(q.method!=="POST"){_n(q,J),J.writeHead(405,{"Content-Type":"application/json",Allow:"POST, OPTIONS"}),J.end(JSON.stringify({jsonrpc:"2.0",error:{code:-32e3,message:"Method not allowed"},id:null}));return}let ea=ZE(q,J);if(!iV(String(q.headers.accept||""))){_n(q,J),ur.warn("request_rejected",{reason:"unsupported_accept",method:q.method,route:le,status:406}),Ko(J,406,-32e3,"Not Acceptable: this endpoint supports JSON transport only");return}if(!oV(String(q.headers["mcp-protocol-version"]||""),h)){_n(q,J),ur.warn("request_rejected",{reason:"unsupported_protocol_version",method:q.method,route:le,status:400,protocolVersionPresent:!!q.headers["mcp-protocol-version"]}),Ko(J,400,-32e3,"Unsupported MCP protocol version");return}if(y&&!hE(q.headers.authorization,y,$)){_n(q,J),ur.warn("request_rejected",{reason:"unauthorized",method:q.method,route:le,status:401}),J.setHeader("WWW-Authenticate",`${$} realm="semiotic-mcp"`),Ko(J,401,-32e3,"Unauthorized");return}let Wt=await m.readBody(q,a,w);if(ea.aborted)return;if(!Wt.ok){ur.warn("request_rejected",{reason:Wt.reason,method:q.method,route:le,status:Wt.status}),_n(q,J),Wt.status===429&&J.setHeader("Retry-After","1"),Ko(J,Wt.status,Wt.code,Wt.message);return}let Bm=YV(Wt.body,s);if(Bm&&!Bm.ok){ur.warn("request_rejected",{reason:"operation_limit",method:q.method,route:le,status:413}),Ko(J,413,-32602,xc(Bm));return}let ta=d.tryAcquire(Date.now(),vE(q.socket.remoteAddress,q.headers["x-forwarded-for"],p));if(!ta.ok){J.setHeader("Retry-After",String(Math.max(1,Math.ceil(ta.retryAfterMs/1e3)))),ur.warn("request_rejected",{reason:ta.code==="MCP_REQUEST_CONCURRENCY"?"request_concurrency":"request_rate",method:q.method,route:le,status:429}),Ko(J,429,-32e3,ta.message);return}try{let o$=t$(t,{signal:ea,limits:u}),Hm=new vm({sessionIdGenerator:void 0,enableJsonResponse:!0}),a$=!1,s$=()=>{a$||(a$=!0,Promise.resolve(Hm.close()).catch(()=>{}),Promise.resolve(o$.close()).catch(()=>{}))};J.on("close",s$);try{await o$.connect(Ib(kb(Hm,s))),await lE(Hm,q,J,Wt.body,ea),ur.info("request_completed",{method:q.method,route:le,status:J.statusCode,durationMs:Date.now()-Ce,bodyBytes:Wt.bodyBytes})}catch{ur.error("request_failed",{reason:"request_handler_error",method:q.method,route:le,status:500,durationMs:Date.now()-Ce,bodyBytes:Wt.bodyBytes}),J.headersSent||(J.writeHead(500,{"Content-Type":"application/json"}),J.end(JSON.stringify({jsonrpc:"2.0",error:{code:-32603,message:"Internal server error"},id:null})))}finally{s$()}}finally{ta.release()}}).listen(n,i,()=>{ur.info("service_started",{profile:t,retentionDays:JC.retentionDays})})}else{let r=t$(t),o=new ym(nE(process.stdin,process.stdout,Cc(process.env.MCP_MAX_BODY_BYTES,4*1024*1024)));await r.connect(Ib(kb(o,xm())))}}async function eF(e){let t=t$(e.profile),[n,i]=_m.createLinkedPair();n.onmessage=r=>{!("id"in r)||r.id!==1||("result"in r?process.send?.({type:"result",result:$m(r.result)}):process.send?.({type:"failure"}))},await t.connect(i),await n.start(),await n.send({jsonrpc:"2.0",id:1,method:"tools/call",params:{name:e.name,arguments:e.arguments}})}wc()?(process.once("message",e=>{eF(e).catch(()=>process.send?.({type:"failure"}))}),process.once("disconnect",()=>process.exit(0))):QV().catch(e=>{ur.error("service_fatal",{reason:e instanceof wr?e.code:"service_startup_failure"}),process.exit(1)});
|
|
459
459
|
/*! Bundled license information:
|
|
460
460
|
|
|
461
461
|
content-type/index.js:
|