Plan visualization artifact
plan_visualization_artifactYou need to discover, read, validate, create, or attach Prism visual artifacts.
When to use it
You need to discover, read, validate, create, or attach Prism visual artifacts.
Plan, generate externally, validate, then create or attach.
Artifact metadata, specs, validation results, save guidance, or embeds.
Avoid using it when
You are trying to preview live output through MCP; render externally first.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Create an inspectable Prism artifact creation plan from a prompt, dataset, or thesis table before generating code or saving anything. Returns a recommended artifact type/runtime, implementation brief, validation payload guidance, preview inspection checklist, and exact create_artifact save guidance. Pass projectId to include that Project's design kit so the artifact matches the Project's colors, type, and chart rules.
View JSON Schema
{
"type": "object",
"properties": {
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"projectId": {
"type": "string",
"format": "uuid",
"description": "The Project the artifact is for. When set, the plan includes that Project's design kit."
},
"source": {
"type": "object",
"properties": {
"columns": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 80
},
"rows": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 1000
},
"text": {
"type": "string",
"maxLength": 50000
}
},
"additionalProperties": false
},
"target": {
"type": "string",
"enum": [
"library",
"article_draft"
],
"default": "library"
},
"preferredRuntime": {
"type": "string",
"enum": [
"auto",
"chart",
"table",
"metric_card",
"markdown",
"react",
"html",
"python"
],
"default": "auto"
}
},
"required": [
"prompt"
],
"additionalProperties": false
}