Serveur MCP

foundry

com.oods-foundry/foundry
Design et création Outils développeur Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Provides an object-oriented design system for building application screens through MCP.

artifact_certify
Certify a chart through the same route. Supply its viz_render input in chart; the route draws it and certifies the resulting normalized spec in the same scope. Repeating the same chart uses the shared cache. For arbitrary normalized specs, use local stdio.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$defs': {'hierarchyNode': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'number'}, 'children': {'type': 'array', 'items': {'$ref': '#/$defs/hierarchyNode'}}}, 'description': 'A nested-hierarchy node: a name, an optional numeric value, and optional children (recursive). Extra fields are preserved for tooltips.', 'additionalProperties': True}, 'encodingBinding': {'oneOf': [{'type': 'string', 'minLength': 1}, {'type': 'object', 'required': ['field'], 'properties': {'sort': {'oneOf': [{'enum': ['none', 'ascending', 'descending'], 'type': 'string'}, {'type': 'object', 'required': ['field', 'order'], 'properties': {'field': {'type': 'string'}, 'order': {'enum': ['ascending', 'descending'], 'type': 'string'}}, 'additionalProperties': False}]}, 'type': {'enum': ['quantitative', 'temporal', 'ordinal', 'nominal'], 'type': 'string', 'description': "Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type."}, 'field': {'type': 'string', 'minLength': 1}, 'scale': {'enum': ['linear', 'temporal', 'log', 'sqrt', 'band', 'point', 'diverging'], 'type': 'string'}, 'title': {'type': 'string'}, 'format': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Label format of this channel\'s axis (x, y) or legend: a d3-format specifier such as "$,f" or ",.0f" (d3-time-format for a temporal field). "$" prints the currency symbol: the currency\'s, else $. Without a precision, labels take the precision of the tick step, so neighbouring ticks never print the same text. Carried in the normalized spec, so artifact.certify replays it.'}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'ISO 4217 code of the amounts this channel encodes, for example EUR. The labels print its en-US symbol where the format has "$" (EUR €, GBP £); without a format they read "$,f" ($12,000). One currency per chart.'}, 'timeUnit': {'enum': ['year', 'quarter', 'month', 'week', 'day', 'hour', 'minute', 'second'], 'type': 'string'}, 'aggregate': {'enum': ['sum', 'count', 'average', 'median', 'min', 'max', 'distinct'], 'type': 'string'}}, 'additionalProperties': False}], 'description': 'An encoding binding: either a bare field-name string, or an object with the field plus optional aggregate/scale/timeUnit/sort/title.'}, 'nonPatternInput': {'allOf': [{'if': {'required': ['chartType'], 'properties': {'chartType': {'enum': ['bar', 'line', 'area', 'scatter', 'heatmap']}}}, 'then': {'required': ['encodings'], 'properties': {'encodings': {'required': ['x', 'y']}}}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'enum': ['treemap', 'sunburst']}}}, 'then': {'required': ['hierarchy']}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'sankey'}}}, 'then': {'required': ['sankey']}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'force_graph'}}}, 'then': {'required': ['network']}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'choropleth'}}}, 'then': {'required': ['geo'], 'properties': {'geo': {'anyOf': [{'required': ['geojson']}, {'required': ['topojson']}], 'required': ['valueField']}}}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'bubble_map'}}}, 'then': {'required': ['geo'], 'properties': {'geo': {'required': ['longitudeField', 'latitudeField', 'rows']}}}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'flow_map'}}}, 'then': {'required': ['geo'], 'properties': {'geo': {'anyOf': [{'required': ['geojson']}, {'required': ['topojson']}], 'required': ['originLongitudeField', 'originLatitudeField', 'destinationLongitudeField', 'destinationLatitudeField', 'rows']}}}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'chord'}}}, 'then': {'required': ['chord']}}], 'oneOf': [{'required': ['rows']}, {'required': ['datasetRef']}, {'required': ['hierarchy']}, {'required': ['sankey']}, {'required': ['chord']}, {'required': ['network']}, {'required': ['geo']}]}, 'colorEncodingBinding': {'oneOf': [{'type': 'string', 'minLength': 1}, {'type': 'object', 'required': ['field'], 'properties': {'sort': {'oneOf': [{'enum': ['none', 'ascending', 'descending'], 'type': 'string'}, {'type': 'object', 'required': ['field', 'order'], 'properties': {'field': {'type': 'string'}, 'order': {'enum': ['ascending', 'descending'], 'type': 'string'}}, 'additionalProperties': False}]}, 'type': {'enum': ['quantitative', 'temporal', 'ordinal', 'nominal'], 'type': 'string', 'description': "Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type."}, 'field': {'type': 'string', 'minLength': 1}, 'range': {'type': 'array', 'items': {'type': 'string', 'pattern': '^#(?:[0-9a-fA-F]{3}){1,2}$'}, 'minItems': 2, 'description': 'Explicit hex colors for a nominal/ordinal color scale. Overrides the baked OODS categorical palette so an agent can supply its own scale (e.g. a 2-color presence scale). Applied in array order to the distinct series; a shorter range recycles (Vega domain[i]->range[i] mod len). Cartesian color only.'}, 'scale': {'enum': ['linear', 'temporal', 'log', 'sqrt', 'band', 'point', 'diverging'], 'type': 'string'}, 'title': {'type': 'string'}, 'timeUnit': {'enum': ['year', 'quarter', 'month', 'week', 'day', 'hour', 'minute', 'second'], 'type': 'string'}, 'aggregate': {'enum': ['sum', 'count', 'average', 'median', 'min', 'max', 'distinct'], 'type': 'string'}}, 'additionalProperties': False}], 'description': 'A color-channel encoding binding: like encodingBinding, plus an optional explicit `range` (hex colors) that overrides the baked OODS categorical palette on a nominal/ordinal color scale. `range` is only valid on the color channel.'}}, 'required': ['chart'], 'properties': {'chart': {'$id': 'https://designlab.local/schemas/viz.render.input.json', 'type': 'object', 'allOf': [{'if': {'not': {'required': ['pattern']}}, 'then': {'$ref': '#/$defs/nonPatternInput'}}], 'title': 'Viz render input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'id': {'type': 'string', 'description': 'Optional stable identifier for the produced spec.'}, 'geo': {'type': 'object', 'properties': {'join': {'type': 'object', 'required': ['dataKey', 'featureProperty'], 'properties': {'dataKey': {'type': 'string', 'minLength': 1, 'description': 'Key in each tabular row.'}, 'featureProperty': {'type': 'string', 'minLength': 1, 'description': "Matching property name in each feature's properties."}}, 'description': "Choropleth join: merge each row into the feature whose 'featureProperty' equals the row's 'dataKey' value.", 'additionalProperties': False}, 'rows': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 5000, 'description': "Tabular records: for choropleth, the values joined into features (paired with 'join'); for bubble_map, the points to plot."}, 'geojson': {'type': 'object', 'description': "Inline GeoJSON FeatureCollection (type:'FeatureCollection', features:[...]). Required for choropleth (the regions); optional base map for bubble_map.", 'additionalProperties': True}, 'topojson': {'type': 'object', 'description': "Inline TopoJSON Topology (type:'Topology'); converted to a GeoJSON FeatureCollection. Set 'topoObjectName' when the topology holds more than one object.", 'additionalProperties': True}, 'curvature': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Flow map: optional arc curveness (0 = straight, ~0.3 default). Bends each origin→destination line into an arc.'}, 'sizeField': {'type': 'string', 'minLength': 1, 'description': 'Bubble map: optional row field driving bubble size.'}, 'colorField': {'type': 'string', 'minLength': 1, 'description': 'Bubble map: optional row field driving bubble colour.'}, 'colorScale': {'enum': ['linear', 'quantize', 'quantile', 'threshold', 'ordinal', 'diverging'], 'type': 'string', 'description': "Optional colour scale (defaults to a continuous linear ramp). 'ordinal' paints discrete per-category colours; 'diverging' ramps two hues about a neutral midpoint (zero)."}, 'valueField': {'type': 'string', 'minLength': 1, 'description': "Choropleth: the numeric field — in feature properties, or merged in via 'join' — whose value colours each region. Required for choropleth."}, 'latitudeField': {'type': 'string', 'minLength': 1, 'description': 'Bubble map: the row field holding latitude. Required for bubble_map.'}, 'strengthField': {'type': 'string', 'minLength': 1, 'description': "Flow map: optional numeric row field whose magnitude drives each arc's line width (via a continuous visualMap)."}, 'longitudeField': {'type': 'string', 'minLength': 1, 'description': 'Bubble map: the row field holding longitude. Required for bubble_map.'}, 'topoObjectName': {'type': 'string', 'minLength': 1, 'description': 'Which TopoJSON object to extract (defaults to the sole object when there is exactly one).'}, 'originLatitudeField': {'type': 'string', 'minLength': 1, 'description': 'Flow map: the row field holding the ORIGIN latitude. Required for flow_map.'}, 'originLongitudeField': {'type': 'string', 'minLength': 1, 'description': 'Flow map: the row field holding the ORIGIN longitude. Required for flow_map.'}, 'destinationLatitudeField': {'type': 'string', 'minLength': 1, 'description': 'Flow map: the row field holding the DESTINATION latitude. Required for flow_map.'}, 'destinationLongitudeField': {'type': 'string', 'minLength': 1, 'description': 'Flow map: the row field holding the DESTINATION longitude. Required for flow_map.'}}, 'description': "Geo data for chartType 'choropleth', 'bubble_map', or 'flow_map' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. Carries INLINE geometry (a GeoJSON FeatureCollection in 'geojson', or a TopoJSON Topology in 'topojson' + 'topoObjectName'), an optional 'join' that merges tabular 'rows' into features by key, and the per-type encoding: 'valueField' colours regions for choropleth; 'longitudeField'/'latitudeField' (+ optional 'sizeField'/'colorField') place points for bubble_map; 'originLongitudeField'/'originLatitudeField'/'destinationLongitudeField'/'destinationLatitudeField' (+ optional 'strengthField'/'curvature') draw origin→destination ARCS for flow_map. Geometry is supplied INLINE — it is never fetched over the network. NOTE: geo specs are NOT self-contained (unlike treemap/sankey): the resolved FeatureCollection rides back on echartsSpec.__registration and the client re-registers the map by name before rendering. Geometry payloads can be large (a world atlas is ~100KB) — prefer a pre-simplified TopoJSON.", 'additionalProperties': False}, 'name': {'type': 'string', 'description': 'Optional human-friendly chart title.'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 5000, 'minItems': 1, 'description': 'Inline data rows — the primary data path. Bounded: a few hundred rows is the sweet spot. Each row is a flat object mapping field name to value.'}, 'brand': {'enum': ['A', 'B'], 'type': 'string', 'default': 'A'}, 'chord': {'type': 'object', 'required': ['nodes', 'links'], 'properties': {'links': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'target', 'value'], 'properties': {'value': {'type': 'number'}, 'source': {'type': 'string', 'minLength': 1}, 'target': {'type': 'string', 'minLength': 1}}, 'additionalProperties': True}, 'minItems': 1, 'description': 'Directed, value-weighted ribbons between ring arcs (matched to arcs by name). Directed: source→target and target→source are distinct ribbons (a reciprocal pair is valid data). Each (source, target) pair should be unique — a duplicate directed link double-counts the ribbon and is flagged with a warning (OODS-V148).'}, 'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'value': {'type': 'number'}}, 'additionalProperties': True}, 'minItems': 1, 'description': "Ring arcs. Each carries a unique 'name'."}}, 'description': "Chord data for chartType 'chord' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. A native ECharts ribbon diagram: a ring of category arcs connected by weighted ribbons. Sankey-shaped — nodes plus value-weighted links; every link MUST carry a numeric 'value' (the ribbon width IS the flow magnitude) and reference existing node names — a link naming a node absent from 'nodes' fails loud (OODS-V147).", 'additionalProperties': False}, 'theme': {'enum': ['light', 'dark', 'hc'], 'type': 'string', 'default': 'light'}, 'intent': {'type': 'object', 'required': ['goal', 'measures', 'dimensions'], 'properties': {'goal': {'enum': ['comparison', 'trend', 'composition', 'part-to-whole', 'relationship', 'intensity', 'distribution'], 'type': 'string', 'description': 'The analytical goal that steers the recommender (the live 7-value goal vocabulary).'}, 'measures': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'type': {'enum': ['quantitative', 'temporal', 'nominal', 'ordinal'], 'type': 'string'}}, 'additionalProperties': False}, 'minItems': 1, 'description': "Named measure fields (the metrics to plot). Each name MUST exist among the data rows' fields. `type` is RESERVED in v0.1 (field types infer from the data)."}, 'dimensions': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'type': {'enum': ['quantitative', 'temporal', 'nominal', 'ordinal'], 'type': 'string'}}, 'additionalProperties': False}, 'description': "Named dimension fields (the breakdowns/axes); may be empty (e.g. a two-measure scatter). Each name MUST exist among the data rows' fields. `type` is RESERVED in v0.1 (field types infer from the data)."}, 'chartFamily': {'enum': ['bar', 'line', 'area', 'scatter', 'heatmap'], 'type': 'string', 'description': "Optional preferred chart family. Post-filters the recommender ranking (NOT a scorer term) to this family, flagged lowConfidence when it was not the recommender's top pick. Constrained to the 5 TABULAR marks — the 8 explicit-only types are not recommender-rankable."}}, 'description': "STRUCTURED (typed, NOT free-text) visualization intent — the deterministic half of the NL→viz hand-off. Supply it INSTEAD of chartType/encodings (mutually exclusive with chartType): the named measures/dimensions drive ENCODING, `goal` + the data drive the recommender's chartType pick, an optional `chartFamily` post-filters that pick, and an optional governed `measureRef` lights the governed-measure narrative overlay (only when output.includeA11y=true). Requires `rows` (or a `datasetRef`).", 'additionalProperties': False}, 'output': {'type': 'object', 'required': [], 'properties': {'svg': {'const': True}, 'width': {'type': 'integer', 'maximum': 2000, 'minimum': 100}, 'height': {'type': 'integer', 'maximum': 2000, 'minimum': 100}, 'includeA11y': {'const': True}, 'includeNormalizedSpec': {'const': True}}, 'additionalProperties': False}, 'sankey': {'type': 'object', 'required': ['nodes', 'links'], 'properties': {'links': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'target', 'value'], 'properties': {'value': {'type': 'number'}, 'source': {'type': 'string', 'minLength': 1}, 'target': {'type': 'string', 'minLength': 1}}, 'additionalProperties': True}, 'minItems': 1, 'description': 'Directed, value-weighted flows between nodes. Each (source, target) pair should be unique — a duplicate directed flow double-counts the link width. (Uniqueness is advisory for sankey; it is not warning-enforced.)'}, 'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'value': {'type': 'number'}}, 'additionalProperties': True}, 'minItems': 1, 'description': "Flow nodes. Each carries a unique 'name'; an optional numeric 'value' overrides the computed throughput."}}, 'description': "Flow data for chartType 'sankey' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. Nodes plus value-weighted links; every link MUST carry a numeric 'value' (the link width IS the flow magnitude) and reference existing node names.", 'additionalProperties': False}, 'network': {'type': 'object', 'required': ['nodes', 'links'], 'properties': {'links': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'target'], 'properties': {'value': {'type': 'number'}, 'source': {'type': 'string', 'minLength': 1}, 'target': {'type': 'string', 'minLength': 1}}, 'additionalProperties': True}, 'description': "Directed edges between nodes (an empty array is allowed for an all-isolated-nodes graph). Each 'source'/'target' MUST match a node 'id' (a dangling ref fails loud, OODS-V147). Directed: source→target and target→source are distinct edges. Each (source, target) pair should be unique — a duplicate directed edge double-counts and is flagged with a warning (OODS-V148)."}, 'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'group': {'type': 'string'}, 'value': {'type': 'number'}}, 'additionalProperties': True}, 'minItems': 1, 'description': "Graph nodes. Each carries a unique 'id'; optional 'group' (category) and 'value' (sizing)."}}, 'description': "Network data for chartType 'force_graph' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. Nodes (each with a unique 'id'; an optional 'group' drives category colour) and directed links (optional numeric 'value'). Every link MUST reference existing node ids — a link naming a node absent from 'nodes' fails loud (OODS-V147).", 'additionalProperties': False}, 'opacity': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional constant mark opacity for the five Cartesian chart families. Preserved in normalized mark options and applied to both Vega-Lite and ECharts pixels. Omission preserves renderer defaults. Unsupported for hierarchy, network and geographic chart families.'}, 'pattern': {'enum': ['pattern:viz:bubble-distribution', 'pattern:viz:correlation-matrix', 'pattern:viz:correlation-scatter', 'pattern:viz:detail-overview-bar', 'pattern:viz:diverging-bar', 'pattern:viz:drilldown-stacked-bar', 'pattern:viz:facet-small-multiples-line', 'pattern:viz:facet-target-band', 'pattern:viz:focus-context-line', 'pattern:viz:grouped-bar', 'pattern:viz:histogram', 'pattern:viz:layered-line-area', 'pattern:viz:multi-series-line', 'pattern:viz:running-total-area', 'pattern:viz:simple-bar', 'pattern:viz:sparkline-grid', 'pattern:viz:stacked-100-bar', 'pattern:viz:stacked-area-projection', 'pattern:viz:stacked-bar', 'pattern:viz:target-band-line', 'pattern:viz:time-grid-heatmap', 'pattern:viz:waterfall'], 'type': 'string', 'description': 'Exact versioned pattern source identity. Renderable patterns preserve source rows, identity, presentation and accessibility metadata. Retired identities are not offered (their reasons are in the viz taxonomy). Structurally unsupported scenes return OODS-V167. Static SVG shows the default selection state (OODS-V175). Cannot be combined with chartType, encodings, rows, datasetRef, intent, hierarchy, sankey, chord, network, geo, id, name, description or opacity (OODS-V166).'}, 'chartType': {'enum': ['bar', 'line', 'area', 'scatter', 'heatmap', 'treemap', 'sunburst', 'sankey', 'force_graph', 'choropleth', 'bubble_map', 'flow_map', 'chord'], 'type': 'string', 'description': "Chart type. The tabular marks (bar->MarkBar, line->MarkLine, area->MarkArea, scatter->MarkPoint, heatmap->MarkRect) bind inline rows/datasetRef with x/y encodings. The hierarchy/flow/network/geo charts are explicit-only and return an ECharts option as the primary spec (no Vega-Lite equivalent): 'treemap' and 'sunburst' take the 'hierarchy' data branch; 'sankey' takes the 'sankey' data branch (nodes + value-weighted links); 'force_graph' takes the 'network' data branch (nodes + links); 'choropleth', 'bubble_map', and 'flow_map' take the 'geo' data branch (inline geometry + per-type encoding — flow_map draws origin→destination arcs); 'chord' takes the 'chord' data branch (sankey-shaped nodes + value-weighted links — a ring of category arcs joined by ribbons whose width is the value). Omit chartType to enter suggest mode (the recommender chooses a tabular type from the inferred field profiles)."}, 'encodings': {'type': 'object', 'properties': {'x': {'$ref': '#/$defs/encodingBinding'}, 'y': {'$ref': '#/$defs/encodingBinding'}, 'size': {'$ref': '#/$defs/encodingBinding'}, 'color': {'$ref': '#/$defs/colorEncodingBinding'}, 'shape': {'$ref': '#/$defs/encodingBinding'}, 'detail': {'$ref': '#/$defs/encodingBinding'}}, 'description': 'Channel -> field bindings. Required, with at least x and y, when chartType is supplied (explicit mode).', 'additionalProperties': False}, 'hierarchy': {'oneOf': [{'type': 'object', 'required': ['type', 'data'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'parentId', 'value'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'value': {'type': 'number'}, 'parentId': {'type': ['string', 'null']}}, 'additionalProperties': True}, 'minItems': 1, 'description': 'Flat node list. Each node carries id, parentId (null for roots), and a numeric value.'}, 'type': {'const': 'adjacency_list'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'data'], 'properties': {'data': {'$ref': '#/$defs/hierarchyNode'}, 'type': {'const': 'nested'}}, 'additionalProperties': False}], 'description': "Hierarchy data for chartType 'treemap' or 'sunburst' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. A discriminated union on 'type': 'adjacency_list' (flat nodes linked by parentId; a node whose parent is missing becomes its own root) or 'nested' (a single root node with children)."}, 'description': {'type': 'string', 'description': 'Optional override for the synthesized accessibility description. When omitted, a non-empty description is generated from the encodings.'}, 'strictFields': {'type': 'boolean', 'default': False, 'description': "Field/key-presence STRICT switch. When true, a referenced data key that does not resolve is surfaced in `warnings` instead of a silent confident-wrong result: (m05) an explicit tabular chart whose encoding references a field ABSENT from every (non-empty) row → OODS-V131; (m06) a choropleth corridor whose join key has NO matching map feature → OODS-V134 (per unmatched corridor). DEFAULT false keeps today's behavior byte-identical (the geo silent-drop preserved). The dashboard.render strict check (its own `strictFields`) escalates V131 to an error panel via `onPanelError`."}, 'a11yEquivalence': {'type': 'boolean', 'default': True, 'description': "A11y equivalence CERTIFY-AT-EMISSION switch. DEFAULT ON. The cartesian (Vega-Lite) emission is checked against the accessible-equivalence engine (validateVizEquivalenceRules): error-severity rules BLOCK (status:'error' with per-rule OODS-<rule.id> codes in `errors`), warn-severity failures surface in `warnings` as OODS-<rule.id>. Default builder output is conformant-BY-CONSTRUCTION , so generated specs pass; set false to opt out for agent-supplied non-conformant specs. Scoped to the cartesian path (the ECharts-primary scaffold has empty data and would spuriously fail data-equivalence rules)."}}, 'description': 'Render a real, data-bound visualization. Supply a registered pattern identity to preserve its source data and presentation, chartType + encodings for explicit mode, or rows/datasetRef for suggest or structured-intent mode. Retired patterns are not offered; structurally unsupported patterns return OODS-V167; pattern conflicts with explicit data, intent, or source identity/presentation overrides return OODS-V166. Brand, theme and output controls remain available.', 'additionalProperties': False}}, 'additionalProperties': False}
catalog_list
Read the component catalog with the package’s filters and pagination.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 10000, 'minimum': 1, 'description': '1-based page index for pagination.'}, 'trait': {'type': 'string', 'description': "Filter components by trait (e.g., 'Editable', 'Searchable')"}, 'detail': {'enum': ['brief', 'summary', 'full'], 'type': 'string', 'description': "Response detail level. Defaults to brief for unfiltered calls (each component's name, categories and one readiness label) and to full when filters are provided. summary adds tags, contexts, regions, traits and status; the evidence behind the readiness label is only in full."}, 'status': {'enum': ['stable', 'beta', 'planned'], 'type': 'string', 'description': "Filter by legacy static-HTML status only: 'stable' = mapped HTML renderer; 'planned' = HTML fallback. Consult productReality.surfaces for React/Vue, generated-consumer and maturity evidence."}, 'context': {'type': 'string', 'description': "Filter components by context (e.g., 'detail', 'list')"}, 'category': {'type': 'string', 'description': "Filter components by category (e.g., 'core', 'data')"}, 'pageSize': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Number of components per page.'}, 'includeInternal': {'type': 'boolean', 'default': False, 'description': "Also list OODS Foundry's internal (non-business) objects in registry.objects, after the business objects. Without it they are left out and registry.hiddenInternal counts them."}}, 'additionalProperties': False}
design_preview
Look up a pre-built object screen in React or Vue. Returns its hosted URL, recorded content hash and exact local reproduction calls.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['object'], 'properties': {'object': {'enum': ['Article', 'Invoice', 'Media', 'Organization', 'Plan', 'Product', 'Relationship', 'Subscription', 'Transaction', 'Usage', 'User'], 'type': 'string'}, 'context': {'enum': ['detail', 'list', 'form', 'timeline', 'card', 'inline', 'workflow'], 'type': 'string', 'default': 'detail'}, 'framework': {'enum': ['react', 'vue'], 'type': 'string', 'default': 'react'}}, 'additionalProperties': False}
health
Read the pinned OODS Foundry process health. Host folder paths are omitted.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'sinceVersion': {'type': 'string', 'description': 'When provided with includeChangelog, only return changelog entries since this version.'}, 'includeChangelog': {'type': 'boolean', 'default': False, 'description': 'When true, include DSL version changelog in the response.'}}, 'additionalProperties': False}
object
List or show object definitions. The hosted surface accepts these read actions only.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'allOf': [{'if': {'required': ['action'], 'properties': {'action': {'const': 'list'}}}, 'then': {'type': 'object', 'properties': {'trait': {'type': 'string', 'description': "Filter to objects composing a given trait (e.g. 'Priceable', 'lifecycle/Stateful')"}, 'action': {'const': 'list'}, 'domain': {'type': 'string', 'description': "Filter to objects in a specific domain (e.g. 'core.identity', 'saas.billing')"}, 'maturity': {'enum': ['draft', 'alpha', 'beta', 'stable'], 'type': 'string', 'description': 'Filter by metadata maturity level'}, 'includeInternal': {'type': 'boolean', 'default': False, 'description': "Also list OODS Foundry's internal (non-business) objects, after the business objects. Without it they are left out and hiddenInternal counts them."}}, 'additionalProperties': False}}, {'if': {'required': ['action'], 'properties': {'action': {'const': 'show'}}}, 'then': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'pattern': '^[A-Za-z][A-Za-z0-9_-]*$', 'description': "Object name to look up (e.g. 'User', 'Product', 'Invoice')"}, 'action': {'const': 'show'}, 'context': {'type': 'string', 'description': "Optional: filter view_extensions to a single context (e.g. 'detail', 'list', 'form', 'timeline', 'card', 'inline')"}}, 'additionalProperties': False}}], 'title': 'object input', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action'], 'properties': {'action': {'enum': ['list', 'show'], 'description': 'List objects or show one composed definition.'}}, 'description': 'Read object definitions from the pinned registry.'}
registry_snapshot
Read the pinned registry snapshot.
Lecture seule Idempotent
Schéma d’entrée
{'$id': 'https://designlab.local/schemas/registry.snapshot.input.json', 'type': 'object', 'title': 'registry.snapshot input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'includeInternal': {'type': 'boolean', 'default': False, 'description': "Also list OODS Foundry's internal (non-business) objects, after the business objects. Without it they are left out and registry.hiddenInternal counts them."}}, 'description': 'Bulk-read recorded mappings plus live shipped and registered team traits and objects. Reports definition loader issues, including shadowed names. Draft preferred_terms, disambiguation_decisions and capabilities are not snapshot outputs.', 'additionalProperties': False}
structuredData_fetch
Read components, tokens or manifest registry datasets, including their available versions.
Lecture seule Idempotent
Schéma d’entrée
{'$id': 'structuredData.fetch.input.json', 'type': 'object', 'title': 'structuredData.fetch input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['dataset'], 'properties': {'dataset': {'enum': ['components', 'tokens', 'manifest'], 'type': 'string', 'description': 'Registry dataset to return.'}, 'version': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': "Request a specific date-stamped version (e.g., '2026-02-24'). Omit for latest. Applies to dataset mode only."}, 'ifNoneMatch': {'type': 'string', 'minLength': 8, 'description': 'Return matched=true without payload when the ETag matches.'}, 'listVersions': {'type': 'boolean', 'default': False, 'description': 'When true, return available version dates instead of payload.'}, 'includePayload': {'type': 'boolean', 'default': True, 'description': 'When false, omit payload even if no ETag match occurs.'}, 'includeInternal': {'type': 'boolean', 'default': False, 'description': "Live components dataset only: also list OODS Foundry's internal (non-business) objects, after the business objects. Without it they are left out and registry.hiddenInternal counts them; a dated export is served unchanged."}}, 'description': 'Read a pinned registry dataset or list its available versions.', 'additionalProperties': False}
tool_schema
Read a tool’s shipped input or output schema, with its source URL and file hash. Local schemas describe the full package; tools/list describes this narrower hosted surface.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['name'], 'properties': {'kind': {'enum': ['input', 'output'], 'type': 'string', 'default': 'input'}, 'name': {'enum': ['tokens_build', 'structuredData_fetch', 'brand_apply', 'brand_intake', 'catalog_list', 'code_generate', 'design_compose', 'design_preview', 'pipeline', 'health', 'registry_snapshot', 'viz_render', 'dashboard_render', 'artifact_certify', 'fidelity_preview', 'map', 'schema', 'object', 'repl', 'a11y_scan'], 'type': 'string'}}, 'additionalProperties': False}
viz_render
Draw a chart through this site’s chart route. Returns the real SVG, hashes, accessible output, normalized spec and certification. Inline data only; brands A/B and light/dark/hc.
Lecture seule Idempotent
Schéma d’entrée
{'$id': 'https://designlab.local/schemas/viz.render.input.json', 'type': 'object', '$defs': {'hierarchyNode': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'number'}, 'children': {'type': 'array', 'items': {'$ref': '#/$defs/hierarchyNode'}}}, 'description': 'A nested-hierarchy node: a name, an optional numeric value, and optional children (recursive). Extra fields are preserved for tooltips.', 'additionalProperties': True}, 'encodingBinding': {'oneOf': [{'type': 'string', 'minLength': 1}, {'type': 'object', 'required': ['field'], 'properties': {'sort': {'oneOf': [{'enum': ['none', 'ascending', 'descending'], 'type': 'string'}, {'type': 'object', 'required': ['field', 'order'], 'properties': {'field': {'type': 'string'}, 'order': {'enum': ['ascending', 'descending'], 'type': 'string'}}, 'additionalProperties': False}]}, 'type': {'enum': ['quantitative', 'temporal', 'ordinal', 'nominal'], 'type': 'string', 'description': "Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type."}, 'field': {'type': 'string', 'minLength': 1}, 'scale': {'enum': ['linear', 'temporal', 'log', 'sqrt', 'band', 'point', 'diverging'], 'type': 'string'}, 'title': {'type': 'string'}, 'format': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Label format of this channel\'s axis (x, y) or legend: a d3-format specifier such as "$,f" or ",.0f" (d3-time-format for a temporal field). "$" prints the currency symbol: the currency\'s, else $. Without a precision, labels take the precision of the tick step, so neighbouring ticks never print the same text. Carried in the normalized spec, so artifact.certify replays it.'}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'ISO 4217 code of the amounts this channel encodes, for example EUR. The labels print its en-US symbol where the format has "$" (EUR €, GBP £); without a format they read "$,f" ($12,000). One currency per chart.'}, 'timeUnit': {'enum': ['year', 'quarter', 'month', 'week', 'day', 'hour', 'minute', 'second'], 'type': 'string'}, 'aggregate': {'enum': ['sum', 'count', 'average', 'median', 'min', 'max', 'distinct'], 'type': 'string'}}, 'additionalProperties': False}], 'description': 'An encoding binding: either a bare field-name string, or an object with the field plus optional aggregate/scale/timeUnit/sort/title.'}, 'nonPatternInput': {'allOf': [{'if': {'required': ['chartType'], 'properties': {'chartType': {'enum': ['bar', 'line', 'area', 'scatter', 'heatmap']}}}, 'then': {'required': ['encodings'], 'properties': {'encodings': {'required': ['x', 'y']}}}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'enum': ['treemap', 'sunburst']}}}, 'then': {'required': ['hierarchy']}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'sankey'}}}, 'then': {'required': ['sankey']}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'force_graph'}}}, 'then': {'required': ['network']}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'choropleth'}}}, 'then': {'required': ['geo'], 'properties': {'geo': {'anyOf': [{'required': ['geojson']}, {'required': ['topojson']}], 'required': ['valueField']}}}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'bubble_map'}}}, 'then': {'required': ['geo'], 'properties': {'geo': {'required': ['longitudeField', 'latitudeField', 'rows']}}}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'flow_map'}}}, 'then': {'required': ['geo'], 'properties': {'geo': {'anyOf': [{'required': ['geojson']}, {'required': ['topojson']}], 'required': ['originLongitudeField', 'originLatitudeField', 'destinationLongitudeField', 'destinationLatitudeField', 'rows']}}}}, {'if': {'required': ['chartType'], 'properties': {'chartType': {'const': 'chord'}}}, 'then': {'required': ['chord']}}], 'oneOf': [{'required': ['rows']}, {'required': ['datasetRef']}, {'required': ['hierarchy']}, {'required': ['sankey']}, {'required': ['chord']}, {'required': ['network']}, {'required': ['geo']}]}, 'colorEncodingBinding': {'oneOf': [{'type': 'string', 'minLength': 1}, {'type': 'object', 'required': ['field'], 'properties': {'sort': {'oneOf': [{'enum': ['none', 'ascending', 'descending'], 'type': 'string'}, {'type': 'object', 'required': ['field', 'order'], 'properties': {'field': {'type': 'string'}, 'order': {'enum': ['ascending', 'descending'], 'type': 'string'}}, 'additionalProperties': False}]}, 'type': {'enum': ['quantitative', 'temporal', 'ordinal', 'nominal'], 'type': 'string', 'description': "Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type."}, 'field': {'type': 'string', 'minLength': 1}, 'range': {'type': 'array', 'items': {'type': 'string', 'pattern': '^#(?:[0-9a-fA-F]{3}){1,2}$'}, 'minItems': 2, 'description': 'Explicit hex colors for a nominal/ordinal color scale. Overrides the baked OODS categorical palette so an agent can supply its own scale (e.g. a 2-color presence scale). Applied in array order to the distinct series; a shorter range recycles (Vega domain[i]->range[i] mod len). Cartesian color only.'}, 'scale': {'enum': ['linear', 'temporal', 'log', 'sqrt', 'band', 'point', 'diverging'], 'type': 'string'}, 'title': {'type': 'string'}, 'timeUnit': {'enum': ['year', 'quarter', 'month', 'week', 'day', 'hour', 'minute', 'second'], 'type': 'string'}, 'aggregate': {'enum': ['sum', 'count', 'average', 'median', 'min', 'max', 'distinct'], 'type': 'string'}}, 'additionalProperties': False}], 'description': 'A color-channel encoding binding: like encodingBinding, plus an optional explicit `range` (hex colors) that overrides the baked OODS categorical palette on a nominal/ordinal color scale. `range` is only valid on the color channel.'}}, 'allOf': [{'if': {'not': {'required': ['pattern']}}, 'then': {'$ref': '#/$defs/nonPatternInput'}}], 'title': 'Viz render input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'id': {'type': 'string', 'description': 'Optional stable identifier for the produced spec.'}, 'geo': {'type': 'object', 'properties': {'join': {'type': 'object', 'required': ['dataKey', 'featureProperty'], 'properties': {'dataKey': {'type': 'string', 'minLength': 1, 'description': 'Key in each tabular row.'}, 'featureProperty': {'type': 'string', 'minLength': 1, 'description': "Matching property name in each feature's properties."}}, 'description': "Choropleth join: merge each row into the feature whose 'featureProperty' equals the row's 'dataKey' value.", 'additionalProperties': False}, 'rows': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 5000, 'description': "Tabular records: for choropleth, the values joined into features (paired with 'join'); for bubble_map, the points to plot."}, 'geojson': {'type': 'object', 'description': "Inline GeoJSON FeatureCollection (type:'FeatureCollection', features:[...]). Required for choropleth (the regions); optional base map for bubble_map.", 'additionalProperties': True}, 'topojson': {'type': 'object', 'description': "Inline TopoJSON Topology (type:'Topology'); converted to a GeoJSON FeatureCollection. Set 'topoObjectName' when the topology holds more than one object.", 'additionalProperties': True}, 'curvature': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Flow map: optional arc curveness (0 = straight, ~0.3 default). Bends each origin→destination line into an arc.'}, 'sizeField': {'type': 'string', 'minLength': 1, 'description': 'Bubble map: optional row field driving bubble size.'}, 'colorField': {'type': 'string', 'minLength': 1, 'description': 'Bubble map: optional row field driving bubble colour.'}, 'colorScale': {'enum': ['linear', 'quantize', 'quantile', 'threshold', 'ordinal', 'diverging'], 'type': 'string', 'description': "Optional colour scale (defaults to a continuous linear ramp). 'ordinal' paints discrete per-category colours; 'diverging' ramps two hues about a neutral midpoint (zero)."}, 'valueField': {'type': 'string', 'minLength': 1, 'description': "Choropleth: the numeric field — in feature properties, or merged in via 'join' — whose value colours each region. Required for choropleth."}, 'latitudeField': {'type': 'string', 'minLength': 1, 'description': 'Bubble map: the row field holding latitude. Required for bubble_map.'}, 'strengthField': {'type': 'string', 'minLength': 1, 'description': "Flow map: optional numeric row field whose magnitude drives each arc's line width (via a continuous visualMap)."}, 'longitudeField': {'type': 'string', 'minLength': 1, 'description': 'Bubble map: the row field holding longitude. Required for bubble_map.'}, 'topoObjectName': {'type': 'string', 'minLength': 1, 'description': 'Which TopoJSON object to extract (defaults to the sole object when there is exactly one).'}, 'originLatitudeField': {'type': 'string', 'minLength': 1, 'description': 'Flow map: the row field holding the ORIGIN latitude. Required for flow_map.'}, 'originLongitudeField': {'type': 'string', 'minLength': 1, 'description': 'Flow map: the row field holding the ORIGIN longitude. Required for flow_map.'}, 'destinationLatitudeField': {'type': 'string', 'minLength': 1, 'description': 'Flow map: the row field holding the DESTINATION latitude. Required for flow_map.'}, 'destinationLongitudeField': {'type': 'string', 'minLength': 1, 'description': 'Flow map: the row field holding the DESTINATION longitude. Required for flow_map.'}}, 'description': "Geo data for chartType 'choropleth', 'bubble_map', or 'flow_map' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. Carries INLINE geometry (a GeoJSON FeatureCollection in 'geojson', or a TopoJSON Topology in 'topojson' + 'topoObjectName'), an optional 'join' that merges tabular 'rows' into features by key, and the per-type encoding: 'valueField' colours regions for choropleth; 'longitudeField'/'latitudeField' (+ optional 'sizeField'/'colorField') place points for bubble_map; 'originLongitudeField'/'originLatitudeField'/'destinationLongitudeField'/'destinationLatitudeField' (+ optional 'strengthField'/'curvature') draw origin→destination ARCS for flow_map. Geometry is supplied INLINE — it is never fetched over the network. NOTE: geo specs are NOT self-contained (unlike treemap/sankey): the resolved FeatureCollection rides back on echartsSpec.__registration and the client re-registers the map by name before rendering. Geometry payloads can be large (a world atlas is ~100KB) — prefer a pre-simplified TopoJSON.", 'additionalProperties': False}, 'name': {'type': 'string', 'description': 'Optional human-friendly chart title.'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 5000, 'minItems': 1, 'description': 'Inline data rows — the primary data path. Bounded: a few hundred rows is the sweet spot. Each row is a flat object mapping field name to value.'}, 'brand': {'enum': ['A', 'B'], 'type': 'string', 'default': 'A'}, 'chord': {'type': 'object', 'required': ['nodes', 'links'], 'properties': {'links': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'target', 'value'], 'properties': {'value': {'type': 'number'}, 'source': {'type': 'string', 'minLength': 1}, 'target': {'type': 'string', 'minLength': 1}}, 'additionalProperties': True}, 'minItems': 1, 'description': 'Directed, value-weighted ribbons between ring arcs (matched to arcs by name). Directed: source→target and target→source are distinct ribbons (a reciprocal pair is valid data). Each (source, target) pair should be unique — a duplicate directed link double-counts the ribbon and is flagged with a warning (OODS-V148).'}, 'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'value': {'type': 'number'}}, 'additionalProperties': True}, 'minItems': 1, 'description': "Ring arcs. Each carries a unique 'name'."}}, 'description': "Chord data for chartType 'chord' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. A native ECharts ribbon diagram: a ring of category arcs connected by weighted ribbons. Sankey-shaped — nodes plus value-weighted links; every link MUST carry a numeric 'value' (the ribbon width IS the flow magnitude) and reference existing node names — a link naming a node absent from 'nodes' fails loud (OODS-V147).", 'additionalProperties': False}, 'theme': {'enum': ['light', 'dark', 'hc'], 'type': 'string', 'default': 'light'}, 'intent': {'type': 'object', 'required': ['goal', 'measures', 'dimensions'], 'properties': {'goal': {'enum': ['comparison', 'trend', 'composition', 'part-to-whole', 'relationship', 'intensity', 'distribution'], 'type': 'string', 'description': 'The analytical goal that steers the recommender (the live 7-value goal vocabulary).'}, 'measures': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'type': {'enum': ['quantitative', 'temporal', 'nominal', 'ordinal'], 'type': 'string'}}, 'additionalProperties': False}, 'minItems': 1, 'description': "Named measure fields (the metrics to plot). Each name MUST exist among the data rows' fields. `type` is RESERVED in v0.1 (field types infer from the data)."}, 'dimensions': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'type': {'enum': ['quantitative', 'temporal', 'nominal', 'ordinal'], 'type': 'string'}}, 'additionalProperties': False}, 'description': "Named dimension fields (the breakdowns/axes); may be empty (e.g. a two-measure scatter). Each name MUST exist among the data rows' fields. `type` is RESERVED in v0.1 (field types infer from the data)."}, 'chartFamily': {'enum': ['bar', 'line', 'area', 'scatter', 'heatmap'], 'type': 'string', 'description': "Optional preferred chart family. Post-filters the recommender ranking (NOT a scorer term) to this family, flagged lowConfidence when it was not the recommender's top pick. Constrained to the 5 TABULAR marks — the 8 explicit-only types are not recommender-rankable."}}, 'description': "STRUCTURED (typed, NOT free-text) visualization intent — the deterministic half of the NL→viz hand-off. Supply it INSTEAD of chartType/encodings (mutually exclusive with chartType): the named measures/dimensions drive ENCODING, `goal` + the data drive the recommender's chartType pick, an optional `chartFamily` post-filters that pick, and an optional governed `measureRef` lights the governed-measure narrative overlay (only when output.includeA11y=true). Requires `rows` (or a `datasetRef`).", 'additionalProperties': False}, 'output': {'type': 'object', 'required': [], 'properties': {'svg': {'const': True}, 'width': {'type': 'integer', 'maximum': 2000, 'minimum': 100}, 'height': {'type': 'integer', 'maximum': 2000, 'minimum': 100}, 'includeA11y': {'const': True}, 'includeNormalizedSpec': {'const': True}}, 'additionalProperties': False}, 'sankey': {'type': 'object', 'required': ['nodes', 'links'], 'properties': {'links': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'target', 'value'], 'properties': {'value': {'type': 'number'}, 'source': {'type': 'string', 'minLength': 1}, 'target': {'type': 'string', 'minLength': 1}}, 'additionalProperties': True}, 'minItems': 1, 'description': 'Directed, value-weighted flows between nodes. Each (source, target) pair should be unique — a duplicate directed flow double-counts the link width. (Uniqueness is advisory for sankey; it is not warning-enforced.)'}, 'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'value': {'type': 'number'}}, 'additionalProperties': True}, 'minItems': 1, 'description': "Flow nodes. Each carries a unique 'name'; an optional numeric 'value' overrides the computed throughput."}}, 'description': "Flow data for chartType 'sankey' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. Nodes plus value-weighted links; every link MUST carry a numeric 'value' (the link width IS the flow magnitude) and reference existing node names.", 'additionalProperties': False}, 'network': {'type': 'object', 'required': ['nodes', 'links'], 'properties': {'links': {'type': 'array', 'items': {'type': 'object', 'required': ['source', 'target'], 'properties': {'value': {'type': 'number'}, 'source': {'type': 'string', 'minLength': 1}, 'target': {'type': 'string', 'minLength': 1}}, 'additionalProperties': True}, 'description': "Directed edges between nodes (an empty array is allowed for an all-isolated-nodes graph). Each 'source'/'target' MUST match a node 'id' (a dangling ref fails loud, OODS-V147). Directed: source→target and target→source are distinct edges. Each (source, target) pair should be unique — a duplicate directed edge double-counts and is flagged with a warning (OODS-V148)."}, 'nodes': {'type': 'array', 'items': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'group': {'type': 'string'}, 'value': {'type': 'number'}}, 'additionalProperties': True}, 'minItems': 1, 'description': "Graph nodes. Each carries a unique 'id'; optional 'group' (category) and 'value' (sizing)."}}, 'description': "Network data for chartType 'force_graph' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. Nodes (each with a unique 'id'; an optional 'group' drives category colour) and directed links (optional numeric 'value'). Every link MUST reference existing node ids — a link naming a node absent from 'nodes' fails loud (OODS-V147).", 'additionalProperties': False}, 'opacity': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Optional constant mark opacity for the five Cartesian chart families. Preserved in normalized mark options and applied to both Vega-Lite and ECharts pixels. Omission preserves renderer defaults. Unsupported for hierarchy, network and geographic chart families.'}, 'pattern': {'enum': ['pattern:viz:bubble-distribution', 'pattern:viz:correlation-matrix', 'pattern:viz:correlation-scatter', 'pattern:viz:detail-overview-bar', 'pattern:viz:diverging-bar', 'pattern:viz:drilldown-stacked-bar', 'pattern:viz:facet-small-multiples-line', 'pattern:viz:facet-target-band', 'pattern:viz:focus-context-line', 'pattern:viz:grouped-bar', 'pattern:viz:histogram', 'pattern:viz:layered-line-area', 'pattern:viz:multi-series-line', 'pattern:viz:running-total-area', 'pattern:viz:simple-bar', 'pattern:viz:sparkline-grid', 'pattern:viz:stacked-100-bar', 'pattern:viz:stacked-area-projection', 'pattern:viz:stacked-bar', 'pattern:viz:target-band-line', 'pattern:viz:time-grid-heatmap', 'pattern:viz:waterfall'], 'type': 'string', 'description': 'Exact versioned pattern source identity. Renderable patterns preserve source rows, identity, presentation and accessibility metadata. Retired identities are not offered (their reasons are in the viz taxonomy). Structurally unsupported scenes return OODS-V167. Static SVG shows the default selection state (OODS-V175). Cannot be combined with chartType, encodings, rows, datasetRef, intent, hierarchy, sankey, chord, network, geo, id, name, description or opacity (OODS-V166).'}, 'chartType': {'enum': ['bar', 'line', 'area', 'scatter', 'heatmap', 'treemap', 'sunburst', 'sankey', 'force_graph', 'choropleth', 'bubble_map', 'flow_map', 'chord'], 'type': 'string', 'description': "Chart type. The tabular marks (bar->MarkBar, line->MarkLine, area->MarkArea, scatter->MarkPoint, heatmap->MarkRect) bind inline rows/datasetRef with x/y encodings. The hierarchy/flow/network/geo charts are explicit-only and return an ECharts option as the primary spec (no Vega-Lite equivalent): 'treemap' and 'sunburst' take the 'hierarchy' data branch; 'sankey' takes the 'sankey' data branch (nodes + value-weighted links); 'force_graph' takes the 'network' data branch (nodes + links); 'choropleth', 'bubble_map', and 'flow_map' take the 'geo' data branch (inline geometry + per-type encoding — flow_map draws origin→destination arcs); 'chord' takes the 'chord' data branch (sankey-shaped nodes + value-weighted links — a ring of category arcs joined by ribbons whose width is the value). Omit chartType to enter suggest mode (the recommender chooses a tabular type from the inferred field profiles)."}, 'encodings': {'type': 'object', 'properties': {'x': {'$ref': '#/$defs/encodingBinding'}, 'y': {'$ref': '#/$defs/encodingBinding'}, 'size': {'$ref': '#/$defs/encodingBinding'}, 'color': {'$ref': '#/$defs/colorEncodingBinding'}, 'shape': {'$ref': '#/$defs/encodingBinding'}, 'detail': {'$ref': '#/$defs/encodingBinding'}}, 'description': 'Channel -> field bindings. Required, with at least x and y, when chartType is supplied (explicit mode).', 'additionalProperties': False}, 'hierarchy': {'oneOf': [{'type': 'object', 'required': ['type', 'data'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'parentId', 'value'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'value': {'type': 'number'}, 'parentId': {'type': ['string', 'null']}}, 'additionalProperties': True}, 'minItems': 1, 'description': 'Flat node list. Each node carries id, parentId (null for roots), and a numeric value.'}, 'type': {'const': 'adjacency_list'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'data'], 'properties': {'data': {'$ref': '#/$defs/hierarchyNode'}, 'type': {'const': 'nested'}}, 'additionalProperties': False}], 'description': "Hierarchy data for chartType 'treemap' or 'sunburst' (explicit-only) — used INSTEAD of rows/datasetRef + x/y encodings. A discriminated union on 'type': 'adjacency_list' (flat nodes linked by parentId; a node whose parent is missing becomes its own root) or 'nested' (a single root node with children)."}, 'description': {'type': 'string', 'description': 'Optional override for the synthesized accessibility description. When omitted, a non-empty description is generated from the encodings.'}, 'strictFields': {'type': 'boolean', 'default': False, 'description': "Field/key-presence STRICT switch. When true, a referenced data key that does not resolve is surfaced in `warnings` instead of a silent confident-wrong result: (m05) an explicit tabular chart whose encoding references a field ABSENT from every (non-empty) row → OODS-V131; (m06) a choropleth corridor whose join key has NO matching map feature → OODS-V134 (per unmatched corridor). DEFAULT false keeps today's behavior byte-identical (the geo silent-drop preserved). The dashboard.render strict check (its own `strictFields`) escalates V131 to an error panel via `onPanelError`."}, 'a11yEquivalence': {'type': 'boolean', 'default': True, 'description': "A11y equivalence CERTIFY-AT-EMISSION switch. DEFAULT ON. The cartesian (Vega-Lite) emission is checked against the accessible-equivalence engine (validateVizEquivalenceRules): error-severity rules BLOCK (status:'error' with per-rule OODS-<rule.id> codes in `errors`), warn-severity failures surface in `warnings` as OODS-<rule.id>. Default builder output is conformant-BY-CONSTRUCTION , so generated specs pass; set false to opt out for agent-supplied non-conformant specs. Scoped to the cartesian path (the ECharts-primary scaffold has empty data and would spuriously fail data-equivalence rules)."}}, 'description': 'Render a real, data-bound visualization. Supply a registered pattern identity to preserve its source data and presentation, chartType + encodings for explicit mode, or rows/datasetRef for suggest or structured-intent mode. Retired patterns are not offered; structurally unsupported patterns return OODS-V167; pattern conflicts with explicit data, intent, or source identity/presentation overrides return OODS-V166. Brand, theme and output controls remain available.', 'additionalProperties': False}
Ajouté
tool_schema
5 October 2026 02:40
Ajouté
design_preview
5 October 2026 02:40
Ajouté
artifact_certify
5 October 2026 02:40
Ajouté
viz_render
5 October 2026 02:40
Ajouté
structuredData_fetch
5 October 2026 02:40
Ajouté
registry_snapshot
5 October 2026 02:40
Ajouté
object
5 October 2026 02:40
Ajouté
catalog_list
5 October 2026 02:40
Ajouté
health
5 October 2026 02:40