Endpoints: 28,729MCP servers: 18,413Payout addresses: 2,070Paid calls: 1,528Letters: 13Defects: 1,322counted 3 min ago
teppi

Server definition

Hash
sha256:b9381f3906d49739a78b16828f5f904f533d203e83e44976fd2aa5b27b765106
What it is
What a remote MCP server returned when asked what it offers: 9 tools

The blob, as servednamed by its sha256

{ "instructions": "Read-only tools from @oods/[email protected]. Local stdio (npx -y @oods/[email protected]) is authoritative. Tool replies include exact local reproduction calls. design_preview looks up recorded screens; artifact_certify takes chart input and certifies the route's own normalized spec.", "tools": [ { "description": "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.", "inputSchema": { "$defs": { "colorEncodingBinding": { "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.", "oneOf": [ { "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "aggregate": { "enum": [ "sum", "count", "average", "median", "min", "max", "distinct" ], "type": "string" }, "field": { "minLength": 1, "type": "string" }, "range": { "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.", "items": { "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "type": "string" }, "minItems": 2, "type": "array" }, "scale": { "enum": [ "linear", "temporal", "log", "sqrt", "band", "point", "diverging" ], "type": "string" }, "sort": { "oneOf": [ { "enum": [ "none", "ascending", "descending" ], "type": "string" }, { "additionalProperties": false, "properties": { "field": { "type": "string" }, "order": { "enum": [ "ascending", "descending" ], "type": "string" } }, "required": [ "field", "order" ], "type": "object" } ] }, "timeUnit": { "enum": [ "year", "quarter", "month", "week", "day", "hour", "minute", "second" ], "type": "string" }, "title": { "type": "string" }, "type": { "description": "Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.", "enum": [ "quantitative", "temporal", "ordinal", "nominal" ], "type": "string" } }, "required": [ "field" ], "type": "object" } ] }, "encodingBinding": { "description": "An encoding binding: either a bare field-name string, or an object with the field plus optional aggregate/scale/timeUnit/sort/title.", "oneOf": [ { "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "aggregate": { "enum": [ "sum", "count", "average", "median", "min", "max", "distinct" ], "type": "string" }, "currency": { "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.", "pattern": "^[A-Za-z]{3}$", "type": "string" }, "field": { "minLength": 1, "type": "string" }, "format": { "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.", "maxLength": 64, "minLength": 1, "type": "string" }, "scale": { "enum": [ "linear", "temporal", "log", "sqrt", "band", "point", "diverging" ], "type": "string" }, "sort": { "oneOf": [ { "enum": [ "none", "ascending", "descending" ], "type": "string" }, { "additionalProperties": false, "properties": { "field": { "type": "string" }, "order": { "enum": [ "ascending", "descending" ], "type": "string" } }, "required": [ "field", "order" ], "type": "object" } ] }, "timeUnit": { "enum": [ "year", "quarter", "month", "week", "day", "hour", "minute", "second" ], "type": "string" }, "title": { "type": "string" }, "type": { "description": "Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.", "enum": [ "quantitative", "temporal", "ordinal", "nominal" ], "type": "string" } }, "required": [ "field" ], "type": "object" } ] }, "hierarchyNode": { "additionalProperties": true, "description": "A nested-hierarchy node: a name, an optional numeric value, and optional children (recursive). Extra fields are preserved for tooltips.", "properties": { "children": { "items": { "$ref": "#/$defs/hierarchyNode" }, "type": "array" }, "name": { "type": "string" }, "value": { "type": "number" } }, "required": [ "name" ], "type": "object" }, "nonPatternInput": { "allOf": [ { "if": { "properties": { "chartType": { "enum": [ "bar", "line", "area", "scatter", "heatmap" ] } }, "required": [ "chartType" ] }, "then": { "properties": { "encodings": { "required": [ "x", "y" ] } }, "required": [ "encodings" ] } }, { "if": { "properties": { "chartType": { "enum": [ "treemap", "sunburst" ] } }, "required": [ "chartType" ] }, "then": { "required": [ "hierarchy" ] } }, { "if": { "properties": { "chartType": { "const": "sankey" } }, "required": [ "chartType" ] }, "then": { "required": [ "sankey" ] } }, { "if": { "properties": { "chartType": { "const": "force_graph" } }, "required": [ "chartType" ] }, "then": { "required": [ "network" ] } }, { "if": { "properties": { "chartType": { "const": "choropleth" } }, "required": [ "chartType" ] }, "then": { "properties": { "geo": { "anyOf": [ { "required": [ "geojson" ] }, { "required": [ "topojson" ] } ], "required": [ "valueField" ] } }, "required": [ "geo" ] } }, { "if": { "properties": { "chartType": { "const": "bubble_map" } }, "required": [ "chartType" ] }, "then": { "properties": { "geo": { "required": [ "longitudeField", "latitudeField", "rows" ] } }, "required": [ "geo" ] } }, { "if": { "properties": { "chartType": { "const": "flow_map" } }, "required": [ "chartType" ] }, "then": { "properties": { "geo": { "anyOf": [ { "required": [ "geojson" ] }, { "required": [ "topojson" ] } ], "required": [ "originLongitudeField", "originLatitudeField", "destinationLongitudeField", "destinationLatitudeField", "rows" ] } }, "required": [ "geo" ] } }, { "if": { "properties": { "chartType": { "const": "chord" } }, "required": [ "chartType" ] }, "then": { "required": [ "chord" ] } } ], "oneOf": [ { "required": [ "rows" ] }, { "required": [ "datasetRef" ] }, { "required": [ "hierarchy" ] }, { "required": [ "sankey" ] }, { "required": [ "chord" ] }, { "required": [ "network" ] }, { "required": [ "geo" ] } ] } }, "additionalProperties": false, "properties": { "chart": { "$id": "https://designlab.local/schemas/viz.render.input.json", "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "allOf": [ { "if": { "not": { "required": [ "pattern" ] } }, "then": { "$ref": "#/$defs/nonPatternInput" } } ], "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.", "properties": { "a11yEquivalence": { "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).", "type": "boolean" }, "brand": { "default": "A", "enum": [ "A", "B" ], "type": "string" }, "chartType": { "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).", "enum": [ "bar", "line", "area", "scatter", "heatmap", "treemap", "sunburst", "sankey", "force_graph", "choropleth", "bubble_map", "flow_map", "chord" ], "type": "string" }, "chord": { "additionalProperties": false, "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).", "properties": { "links": { "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).", "items": { "additionalProperties": true, "properties": { "source": { "minLength": 1, "type": "string" }, "target": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "source", "target", "value" ], "type": "object" }, "minItems": 1, "type": "array" }, "nodes": { "description": "Ring arcs. Each carries a unique 'name'.", "items": { "additionalProperties": true, "properties": { "name": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "name" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "nodes", "links" ], "type": "object" }, "description": { "description": "Optional override for the synthesized accessibility description. When omitted, a non-empty description is generated from the encodings.", "type": "string" }, "encodings": { "additionalProperties": false, "description": "Channel -> field bindings. Required, with at least x and y, when chartType is supplied (explicit mode).", "properties": { "color": { "$ref": "#/$defs/colorEncodingBinding" }, "detail": { "$ref": "#/$defs/encodingBinding" }, "shape": { "$ref": "#/$defs/encodingBinding" }, "size": { "$ref": "#/$defs/encodingBinding" }, "x": { "$ref": "#/$defs/encodingBinding" }, "y": { "$ref": "#/$defs/encodingBinding" } }, "type": "object" }, "geo": { "additionalProperties": false, "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.", "properties": { "colorField": { "description": "Bubble map: optional row field driving bubble colour.", "minLength": 1, "type": "string" }, "colorScale": { "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).", "enum": [ "linear", "quantize", "quantile", "threshold", "ordinal", "diverging" ], "type": "string" }, "curvature": { "description": "Flow map: optional arc curveness (0 = straight, ~0.3 default). Bends each origin→destination line into an arc.", "maximum": 1, "minimum": 0, "type": "number" }, "destinationLatitudeField": { "description": "Flow map: the row field holding the DESTINATION latitude. Required for flow_map.", "minLength": 1, "type": "string" }, "destinationLongitudeField": { "description": "Flow map: the row field holding the DESTINATION longitude. Required for flow_map.", "minLength": 1, "type": "string" }, "geojson": { "additionalProperties": true, "description": "Inline GeoJSON FeatureCollection (type:'FeatureCollection', features:[...]). Required for choropleth (the regions); optional base map for bubble_map.", "type": "object" }, "join": { "additionalProperties": false, "description": "Choropleth join: merge each row into the feature whose 'featureProperty' equals the row's 'dataKey' value.", "properties": { "dataKey": { "description": "Key in each tabular row.", "minLength": 1, "type": "string" }, "featureProperty": { "description": "Matching property name in each feature's properties.", "minLength": 1, "type": "string" } }, "required": [ "dataKey", "featureProperty" ], "type": "object" }, "latitudeField": { "description": "Bubble map: the row field holding latitude. Required for bubble_map.", "minLength": 1, "type": "string" }, "longitudeField": { "description": "Bubble map: the row field holding longitude. Required for bubble_map.", "minLength": 1, "type": "string" }, "originLatitudeField": { "description": "Flow map: the row field holding the ORIGIN latitude. Required for flow_map.", "minLength": 1, "type": "string" }, "originLongitudeField": { "description": "Flow map: the row field holding the ORIGIN longitude. Required for flow_map.", "minLength": 1, "type": "string" }, "rows": { "description": "Tabular records: for choropleth, the values joined into features (paired with 'join'); for bubble_map, the points to plot.", "items": { "additionalProperties": true, "type": "object" }, "maxItems": 5000, "type": "array" }, "sizeField": { "description": "Bubble map: optional row field driving bubble size.", "minLength": 1, "type": "string" }, "strengthField": { "description": "Flow map: optional numeric row field whose magnitude drives each arc's line width (via a continuous visualMap).", "minLength": 1, "type": "string" }, "topoObjectName": { "description": "Which TopoJSON object to extract (defaults to the sole object when there is exactly one).", "minLength": 1, "type": "string" }, "topojson": { "additionalProperties": true, "description": "Inline TopoJSON Topology (type:'Topology'); converted to a GeoJSON FeatureCollection. Set 'topoObjectName' when the topology holds more than one object.", "type": "object" }, "valueField": { "description": "Choropleth: the numeric field — in feature properties, or merged in via 'join' — whose value colours each region. Required for choropleth.", "minLength": 1, "type": "string" } }, "type": "object" }, "hierarchy": { "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).", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "description": "Flat node list. Each node carries id, parentId (null for roots), and a numeric value.", "items": { "additionalProperties": true, "properties": { "id": { "minLength": 1, "type": "string" }, "name": { "type": "string" }, "parentId": { "type": [ "string", "null" ] }, "value": { "type": "number" } }, "required": [ "id", "parentId", "value" ], "type": "object" }, "minItems": 1, "type": "array" }, "type": { "const": "adjacency_list" } }, "required": [ "type", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "data": { "$ref": "#/$defs/hierarchyNode" }, "type": { "const": "nested" } }, "required": [ "type", "data" ], "type": "object" } ] }, "id": { "description": "Optional stable identifier for the produced spec.", "type": "string" }, "intent": { "additionalProperties": false, "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`).", "properties": { "chartFamily": { "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.", "enum": [ "bar", "line", "area", "scatter", "heatmap" ], "type": "string" }, "dimensions": { "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).", "items": { "additionalProperties": false, "properties": { "name": { "minLength": 1, "type": "string" }, "type": { "enum": [ "quantitative", "temporal", "nominal", "ordinal" ], "type": "string" } }, "required": [ "name" ], "type": "object" }, "type": "array" }, "goal": { "description": "The analytical goal that steers the recommender (the live 7-value goal vocabulary).", "enum": [ "comparison", "trend", "composition", "part-to-whole", "relationship", "intensity", "distribution" ], "type": "string" }, "measures": { "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).", "items": { "additionalProperties": false, "properties": { "name": { "minLength": 1, "type": "string" }, "type": { "enum": [ "quantitative", "temporal", "nominal", "ordinal" ], "type": "string" } }, "required": [ "name" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "goal", "measures", "dimensions" ], "type": "object" }, "name": { "description": "Optional human-friendly chart title.", "type": "string" }, "network": { "additionalProperties": false, "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).", "properties": { "links": { "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).", "items": { "additionalProperties": true, "properties": { "source": { "minLength": 1, "type": "string" }, "target": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "source", "target" ], "type": "object" }, "type": "array" }, "nodes": { "description": "Graph nodes. Each carries a unique 'id'; optional 'group' (category) and 'value' (sizing).", "items": { "additionalProperties": true, "properties": { "group": { "type": "string" }, "id": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "id" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "nodes", "links" ], "type": "object" }, "opacity": { "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.", "maximum": 1, "minimum": 0, "type": "number" }, "output": { "additionalProperties": false, "properties": { "height": { "maximum": 2000, "minimum": 100, "type": "integer" }, "includeA11y": { "const": true }, "includeNormalizedSpec": { "const": true }, "svg": { "const": true }, "width": { "maximum": 2000, "minimum": 100, "type": "integer" } }, "required": [], "type": "object" }, "pattern": { "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).", "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" }, "rows": { "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.", "items": { "additionalProperties": true, "type": "object" }, "maxItems": 5000, "minItems": 1, "type": "array" }, "sankey": { "additionalProperties": false, "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.", "properties": { "links": { "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.)", "items": { "additionalProperties": true, "properties": { "source": { "minLength": 1, "type": "string" }, "target": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "source", "target", "value" ], "type": "object" }, "minItems": 1, "type": "array" }, "nodes": { "description": "Flow nodes. Each carries a unique 'name'; an optional numeric 'value' overrides the computed throughput.", "items": { "additionalProperties": true, "properties": { "name": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "name" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "nodes", "links" ], "type": "object" }, "strictFields": { "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`.", "type": "boolean" }, "theme": { "default": "light", "enum": [ "light", "dark", "hc" ], "type": "string" } }, "title": "Viz render input", "type": "object" } }, "required": [ "chart" ], "type": "object" }, "name": "artifact_certify", "outputSchema": null }, { "description": "Read the component catalog with the package’s filters and pagination.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "category": { "description": "Filter components by category (e.g., 'core', 'data')", "type": "string" }, "context": { "description": "Filter components by context (e.g., 'detail', 'list')", "type": "string" }, "detail": { "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.", "enum": [ "brief", "summary", "full" ], "type": "string" }, "includeInternal": { "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.", "type": "boolean" }, "page": { "description": "1-based page index for pagination.", "maximum": 10000, "minimum": 1, "type": "integer" }, "pageSize": { "description": "Number of components per page.", "maximum": 200, "minimum": 1, "type": "integer" }, "status": { "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.", "enum": [ "stable", "beta", "planned" ], "type": "string" }, "trait": { "description": "Filter components by trait (e.g., 'Editable', 'Searchable')", "type": "string" } }, "type": "object" }, "name": "catalog_list", "outputSchema": null }, { "description": "Look up a pre-built object screen in React or Vue. Returns its hosted URL, recorded content hash and exact local reproduction calls.", "inputSchema": { "additionalProperties": false, "properties": { "context": { "default": "detail", "enum": [ "detail", "list", "form", "timeline", "card", "inline", "workflow" ], "type": "string" }, "framework": { "default": "react", "enum": [ "react", "vue" ], "type": "string" }, "object": { "enum": [ "Article", "Invoice", "Media", "Organization", "Plan", "Product", "Relationship", "Subscription", "Transaction", "Usage", "User" ], "type": "string" } }, "required": [ "object" ], "type": "object" }, "name": "design_preview", "outputSchema": null }, { "description": "Read the pinned OODS Foundry process health. Host folder paths are omitted.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "includeChangelog": { "default": false, "description": "When true, include DSL version changelog in the response.", "type": "boolean" }, "sinceVersion": { "description": "When provided with includeChangelog, only return changelog entries since this version.", "type": "string" } }, "type": "object" }, "name": "health", "outputSchema": null }, { "description": "List or show object definitions. The hosted surface accepts these read actions only.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "allOf": [ { "if": { "properties": { "action": { "const": "list" } }, "required": [ "action" ] }, "then": { "additionalProperties": false, "properties": { "action": { "const": "list" }, "domain": { "description": "Filter to objects in a specific domain (e.g. 'core.identity', 'saas.billing')", "type": "string" }, "includeInternal": { "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.", "type": "boolean" }, "maturity": { "description": "Filter by metadata maturity level", "enum": [ "draft", "alpha", "beta", "stable" ], "type": "string" }, "trait": { "description": "Filter to objects composing a given trait (e.g. 'Priceable', 'lifecycle/Stateful')", "type": "string" } }, "type": "object" } }, { "if": { "properties": { "action": { "const": "show" } }, "required": [ "action" ] }, "then": { "additionalProperties": false, "properties": { "action": { "const": "show" }, "context": { "description": "Optional: filter view_extensions to a single context (e.g. 'detail', 'list', 'form', 'timeline', 'card', 'inline')", "type": "string" }, "name": { "description": "Object name to look up (e.g. 'User', 'Product', 'Invoice')", "pattern": "^[A-Za-z][A-Za-z0-9_-]*$", "type": "string" } }, "required": [ "name" ], "type": "object" } } ], "description": "Read object definitions from the pinned registry.", "properties": { "action": { "description": "List objects or show one composed definition.", "enum": [ "list", "show" ] } }, "required": [ "action" ], "title": "object input", "type": "object" }, "name": "object", "outputSchema": null }, { "description": "Read the pinned registry snapshot.", "inputSchema": { "$id": "https://designlab.local/schemas/registry.snapshot.input.json", "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "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.", "properties": { "includeInternal": { "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.", "type": "boolean" } }, "title": "registry.snapshot input", "type": "object" }, "name": "registry_snapshot", "outputSchema": null }, { "description": "Read components, tokens or manifest registry datasets, including their available versions.", "inputSchema": { "$id": "structuredData.fetch.input.json", "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Read a pinned registry dataset or list its available versions.", "properties": { "dataset": { "description": "Registry dataset to return.", "enum": [ "components", "tokens", "manifest" ], "type": "string" }, "ifNoneMatch": { "description": "Return matched=true without payload when the ETag matches.", "minLength": 8, "type": "string" }, "includeInternal": { "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.", "type": "boolean" }, "includePayload": { "default": true, "description": "When false, omit payload even if no ETag match occurs.", "type": "boolean" }, "listVersions": { "default": false, "description": "When true, return available version dates instead of payload.", "type": "boolean" }, "version": { "description": "Request a specific date-stamped version (e.g., '2026-02-24'). Omit for latest. Applies to dataset mode only.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "dataset" ], "title": "structuredData.fetch input", "type": "object" }, "name": "structuredData_fetch", "outputSchema": null }, { "description": "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.", "inputSchema": { "additionalProperties": false, "properties": { "kind": { "default": "input", "enum": [ "input", "output" ], "type": "string" }, "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" } }, "required": [ "name" ], "type": "object" }, "name": "tool_schema", "outputSchema": null }, { "description": "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.", "inputSchema": { "$defs": { "colorEncodingBinding": { "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.", "oneOf": [ { "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "aggregate": { "enum": [ "sum", "count", "average", "median", "min", "max", "distinct" ], "type": "string" }, "field": { "minLength": 1, "type": "string" }, "range": { "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.", "items": { "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "type": "string" }, "minItems": 2, "type": "array" }, "scale": { "enum": [ "linear", "temporal", "log", "sqrt", "band", "point", "diverging" ], "type": "string" }, "sort": { "oneOf": [ { "enum": [ "none", "ascending", "descending" ], "type": "string" }, { "additionalProperties": false, "properties": { "field": { "type": "string" }, "order": { "enum": [ "ascending", "descending" ], "type": "string" } }, "required": [ "field", "order" ], "type": "object" } ] }, "timeUnit": { "enum": [ "year", "quarter", "month", "week", "day", "hour", "minute", "second" ], "type": "string" }, "title": { "type": "string" }, "type": { "description": "Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.", "enum": [ "quantitative", "temporal", "ordinal", "nominal" ], "type": "string" } }, "required": [ "field" ], "type": "object" } ] }, "encodingBinding": { "description": "An encoding binding: either a bare field-name string, or an object with the field plus optional aggregate/scale/timeUnit/sort/title.", "oneOf": [ { "minLength": 1, "type": "string" }, { "additionalProperties": false, "properties": { "aggregate": { "enum": [ "sum", "count", "average", "median", "min", "max", "distinct" ], "type": "string" }, "currency": { "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.", "pattern": "^[A-Za-z]{3}$", "type": "string" }, "field": { "minLength": 1, "type": "string" }, "format": { "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.", "maxLength": 64, "minLength": 1, "type": "string" }, "scale": { "enum": [ "linear", "temporal", "log", "sqrt", "band", "point", "diverging" ], "type": "string" }, "sort": { "oneOf": [ { "enum": [ "none", "ascending", "descending" ], "type": "string" }, { "additionalProperties": false, "properties": { "field": { "type": "string" }, "order": { "enum": [ "ascending", "descending" ], "type": "string" } }, "required": [ "field", "order" ], "type": "object" } ] }, "timeUnit": { "enum": [ "year", "quarter", "month", "week", "day", "hour", "minute", "second" ], "type": "string" }, "title": { "type": "string" }, "type": { "description": "Force the Vega-Lite/ECharts field type, overriding the engine's data-aware inference. Overrides the inferred field type.", "enum": [ "quantitative", "temporal", "ordinal", "nominal" ], "type": "string" } }, "required": [ "field" ], "type": "object" } ] }, "hierarchyNode": { "additionalProperties": true, "description": "A nested-hierarchy node: a name, an optional numeric value, and optional children (recursive). Extra fields are preserved for tooltips.", "properties": { "children": { "items": { "$ref": "#/$defs/hierarchyNode" }, "type": "array" }, "name": { "type": "string" }, "value": { "type": "number" } }, "required": [ "name" ], "type": "object" }, "nonPatternInput": { "allOf": [ { "if": { "properties": { "chartType": { "enum": [ "bar", "line", "area", "scatter", "heatmap" ] } }, "required": [ "chartType" ] }, "then": { "properties": { "encodings": { "required": [ "x", "y" ] } }, "required": [ "encodings" ] } }, { "if": { "properties": { "chartType": { "enum": [ "treemap", "sunburst" ] } }, "required": [ "chartType" ] }, "then": { "required": [ "hierarchy" ] } }, { "if": { "properties": { "chartType": { "const": "sankey" } }, "required": [ "chartType" ] }, "then": { "required": [ "sankey" ] } }, { "if": { "properties": { "chartType": { "const": "force_graph" } }, "required": [ "chartType" ] }, "then": { "required": [ "network" ] } }, { "if": { "properties": { "chartType": { "const": "choropleth" } }, "required": [ "chartType" ] }, "then": { "properties": { "geo": { "anyOf": [ { "required": [ "geojson" ] }, { "required": [ "topojson" ] } ], "required": [ "valueField" ] } }, "required": [ "geo" ] } }, { "if": { "properties": { "chartType": { "const": "bubble_map" } }, "required": [ "chartType" ] }, "then": { "properties": { "geo": { "required": [ "longitudeField", "latitudeField", "rows" ] } }, "required": [ "geo" ] } }, { "if": { "properties": { "chartType": { "const": "flow_map" } }, "required": [ "chartType" ] }, "then": { "properties": { "geo": { "anyOf": [ { "required": [ "geojson" ] }, { "required": [ "topojson" ] } ], "required": [ "originLongitudeField", "originLatitudeField", "destinationLongitudeField", "destinationLatitudeField", "rows" ] } }, "required": [ "geo" ] } }, { "if": { "properties": { "chartType": { "const": "chord" } }, "required": [ "chartType" ] }, "then": { "required": [ "chord" ] } } ], "oneOf": [ { "required": [ "rows" ] }, { "required": [ "datasetRef" ] }, { "required": [ "hierarchy" ] }, { "required": [ "sankey" ] }, { "required": [ "chord" ] }, { "required": [ "network" ] }, { "required": [ "geo" ] } ] } }, "$id": "https://designlab.local/schemas/viz.render.input.json", "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "allOf": [ { "if": { "not": { "required": [ "pattern" ] } }, "then": { "$ref": "#/$defs/nonPatternInput" } } ], "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.", "properties": { "a11yEquivalence": { "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).", "type": "boolean" }, "brand": { "default": "A", "enum": [ "A", "B" ], "type": "string" }, "chartType": { "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).", "enum": [ "bar", "line", "area", "scatter", "heatmap", "treemap", "sunburst", "sankey", "force_graph", "choropleth", "bubble_map", "flow_map", "chord" ], "type": "string" }, "chord": { "additionalProperties": false, "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).", "properties": { "links": { "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).", "items": { "additionalProperties": true, "properties": { "source": { "minLength": 1, "type": "string" }, "target": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "source", "target", "value" ], "type": "object" }, "minItems": 1, "type": "array" }, "nodes": { "description": "Ring arcs. Each carries a unique 'name'.", "items": { "additionalProperties": true, "properties": { "name": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "name" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "nodes", "links" ], "type": "object" }, "description": { "description": "Optional override for the synthesized accessibility description. When omitted, a non-empty description is generated from the encodings.", "type": "string" }, "encodings": { "additionalProperties": false, "description": "Channel -> field bindings. Required, with at least x and y, when chartType is supplied (explicit mode).", "properties": { "color": { "$ref": "#/$defs/colorEncodingBinding" }, "detail": { "$ref": "#/$defs/encodingBinding" }, "shape": { "$ref": "#/$defs/encodingBinding" }, "size": { "$ref": "#/$defs/encodingBinding" }, "x": { "$ref": "#/$defs/encodingBinding" }, "y": { "$ref": "#/$defs/encodingBinding" } }, "type": "object" }, "geo": { "additionalProperties": false, "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.", "properties": { "colorField": { "description": "Bubble map: optional row field driving bubble colour.", "minLength": 1, "type": "string" }, "colorScale": { "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).", "enum": [ "linear", "quantize", "quantile", "threshold", "ordinal", "diverging" ], "type": "string" }, "curvature": { "description": "Flow map: optional arc curveness (0 = straight, ~0.3 default). Bends each origin→destination line into an arc.", "maximum": 1, "minimum": 0, "type": "number" }, "destinationLatitudeField": { "description": "Flow map: the row field holding the DESTINATION latitude. Required for flow_map.", "minLength": 1, "type": "string" }, "destinationLongitudeField": { "description": "Flow map: the row field holding the DESTINATION longitude. Required for flow_map.", "minLength": 1, "type": "string" }, "geojson": { "additionalProperties": true, "description": "Inline GeoJSON FeatureCollection (type:'FeatureCollection', features:[...]). Required for choropleth (the regions); optional base map for bubble_map.", "type": "object" }, "join": { "additionalProperties": false, "description": "Choropleth join: merge each row into the feature whose 'featureProperty' equals the row's 'dataKey' value.", "properties": { "dataKey": { "description": "Key in each tabular row.", "minLength": 1, "type": "string" }, "featureProperty": { "description": "Matching property name in each feature's properties.", "minLength": 1, "type": "string" } }, "required": [ "dataKey", "featureProperty" ], "type": "object" }, "latitudeField": { "description": "Bubble map: the row field holding latitude. Required for bubble_map.", "minLength": 1, "type": "string" }, "longitudeField": { "description": "Bubble map: the row field holding longitude. Required for bubble_map.", "minLength": 1, "type": "string" }, "originLatitudeField": { "description": "Flow map: the row field holding the ORIGIN latitude. Required for flow_map.", "minLength": 1, "type": "string" }, "originLongitudeField": { "description": "Flow map: the row field holding the ORIGIN longitude. Required for flow_map.", "minLength": 1, "type": "string" }, "rows": { "description": "Tabular records: for choropleth, the values joined into features (paired with 'join'); for bubble_map, the points to plot.", "items": { "additionalProperties": true, "type": "object" }, "maxItems": 5000, "type": "array" }, "sizeField": { "description": "Bubble map: optional row field driving bubble size.", "minLength": 1, "type": "string" }, "strengthField": { "description": "Flow map: optional numeric row field whose magnitude drives each arc's line width (via a continuous visualMap).", "minLength": 1, "type": "string" }, "topoObjectName": { "description": "Which TopoJSON object to extract (defaults to the sole object when there is exactly one).", "minLength": 1, "type": "string" }, "topojson": { "additionalProperties": true, "description": "Inline TopoJSON Topology (type:'Topology'); converted to a GeoJSON FeatureCollection. Set 'topoObjectName' when the topology holds more than one object.", "type": "object" }, "valueField": { "description": "Choropleth: the numeric field — in feature properties, or merged in via 'join' — whose value colours each region. Required for choropleth.", "minLength": 1, "type": "string" } }, "type": "object" }, "hierarchy": { "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).", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "description": "Flat node list. Each node carries id, parentId (null for roots), and a numeric value.", "items": { "additionalProperties": true, "properties": { "id": { "minLength": 1, "type": "string" }, "name": { "type": "string" }, "parentId": { "type": [ "string", "null" ] }, "value": { "type": "number" } }, "required": [ "id", "parentId", "value" ], "type": "object" }, "minItems": 1, "type": "array" }, "type": { "const": "adjacency_list" } }, "required": [ "type", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "data": { "$ref": "#/$defs/hierarchyNode" }, "type": { "const": "nested" } }, "required": [ "type", "data" ], "type": "object" } ] }, "id": { "description": "Optional stable identifier for the produced spec.", "type": "string" }, "intent": { "additionalProperties": false, "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`).", "properties": { "chartFamily": { "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.", "enum": [ "bar", "line", "area", "scatter", "heatmap" ], "type": "string" }, "dimensions": { "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).", "items": { "additionalProperties": false, "properties": { "name": { "minLength": 1, "type": "string" }, "type": { "enum": [ "quantitative", "temporal", "nominal", "ordinal" ], "type": "string" } }, "required": [ "name" ], "type": "object" }, "type": "array" }, "goal": { "description": "The analytical goal that steers the recommender (the live 7-value goal vocabulary).", "enum": [ "comparison", "trend", "composition", "part-to-whole", "relationship", "intensity", "distribution" ], "type": "string" }, "measures": { "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).", "items": { "additionalProperties": false, "properties": { "name": { "minLength": 1, "type": "string" }, "type": { "enum": [ "quantitative", "temporal", "nominal", "ordinal" ], "type": "string" } }, "required": [ "name" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "goal", "measures", "dimensions" ], "type": "object" }, "name": { "description": "Optional human-friendly chart title.", "type": "string" }, "network": { "additionalProperties": false, "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).", "properties": { "links": { "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).", "items": { "additionalProperties": true, "properties": { "source": { "minLength": 1, "type": "string" }, "target": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "source", "target" ], "type": "object" }, "type": "array" }, "nodes": { "description": "Graph nodes. Each carries a unique 'id'; optional 'group' (category) and 'value' (sizing).", "items": { "additionalProperties": true, "properties": { "group": { "type": "string" }, "id": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "id" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "nodes", "links" ], "type": "object" }, "opacity": { "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.", "maximum": 1, "minimum": 0, "type": "number" }, "output": { "additionalProperties": false, "properties": { "height": { "maximum": 2000, "minimum": 100, "type": "integer" }, "includeA11y": { "const": true }, "includeNormalizedSpec": { "const": true }, "svg": { "const": true }, "width": { "maximum": 2000, "minimum": 100, "type": "integer" } }, "required": [], "type": "object" }, "pattern": { "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).", "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" }, "rows": { "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.", "items": { "additionalProperties": true, "type": "object" }, "maxItems": 5000, "minItems": 1, "type": "array" }, "sankey": { "additionalProperties": false, "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.", "properties": { "links": { "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.)", "items": { "additionalProperties": true, "properties": { "source": { "minLength": 1, "type": "string" }, "target": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "source", "target", "value" ], "type": "object" }, "minItems": 1, "type": "array" }, "nodes": { "description": "Flow nodes. Each carries a unique 'name'; an optional numeric 'value' overrides the computed throughput.", "items": { "additionalProperties": true, "properties": { "name": { "minLength": 1, "type": "string" }, "value": { "type": "number" } }, "required": [ "name" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "nodes", "links" ], "type": "object" }, "strictFields": { "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`.", "type": "boolean" }, "theme": { "default": "light", "enum": [ "light", "dark", "hc" ], "type": "string" } }, "title": "Viz render input", "type": "object" }, "name": "viz_render", "outputSchema": null } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:b9381f3906d49739a78b16828f5f904f533d203e83e44976fd2aa5b27b765106 | sha256sum