[{"data":1,"prerenderedAt":1421},["ShallowReactive",2],{"navigation_docs_en":3,"dtpr-schemas-index":287,"-en-mcp-envelope":295,"-en-mcp-envelope-surround":1416},[4,22,26,30,102,152,174,196,226,278,283],{"title":5,"path":6,"stem":7,"children":8},"Getting started","/en/getting-started","en/1.getting-started/0.index",[9,10,14,18],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13},"MCP quickstart","/en/getting-started/mcp-quickstart","en/1.getting-started/1.mcp-quickstart",{"title":15,"path":16,"stem":17},"REST quickstart","/en/getting-started/rest-quickstart","en/1.getting-started/2.rest-quickstart",{"title":19,"path":20,"stem":21},"UI quickstart","/en/getting-started/ui-quickstart","en/1.getting-started/3.ui-quickstart",{"title":23,"path":24,"stem":25},"Attribution","/en/attribution","en/10.attribution",{"title":27,"path":28,"stem":29},"Cite DTPR for AI","/en/cite","en/11.cite",{"title":31,"path":32,"stem":33,"children":34},"MCP server","/en/mcp","en/2.mcp/0.index",[35,36,40,44,48,98],{"title":31,"path":32,"stem":33},{"title":37,"path":38,"stem":39},"Connecting","/en/mcp/connection","en/2.mcp/1.connection",{"title":41,"path":42,"stem":43},"Envelope","/en/mcp/envelope","en/2.mcp/2.envelope",{"title":45,"path":46,"stem":47},"Resources","/en/mcp/resources","en/2.mcp/3.resources",{"title":49,"path":50,"stem":51,"children":52},"Tools","/en/mcp/tools","en/2.mcp/4.tools/0.index",[53,54,58,62,66,70,74,78,82,86,90,94],{"title":49,"path":50,"stem":51},{"title":55,"path":56,"stem":57},"list_schema_versions","/en/mcp/tools/list-schema-versions","en/2.mcp/4.tools/1.list-schema-versions",{"title":59,"path":60,"stem":61},"MCP tool: resolve_datachain","/en/mcp/tools/resolve-datachain","en/2.mcp/4.tools/10.resolve-datachain",{"title":63,"path":64,"stem":65},"MCP tool: validate_resolved","/en/mcp/tools/validate-resolved","en/2.mcp/4.tools/11.validate-resolved",{"title":67,"path":68,"stem":69},"get_schema","/en/mcp/tools/get-schema","en/2.mcp/4.tools/2.get-schema",{"title":71,"path":72,"stem":73},"list_categories","/en/mcp/tools/list-categories","en/2.mcp/4.tools/3.list-categories",{"title":75,"path":76,"stem":77},"list_elements","/en/mcp/tools/list-elements","en/2.mcp/4.tools/4.list-elements",{"title":79,"path":80,"stem":81},"get_element","/en/mcp/tools/get-element","en/2.mcp/4.tools/5.get-element",{"title":83,"path":84,"stem":85},"get_elements","/en/mcp/tools/get-elements","en/2.mcp/4.tools/6.get-elements",{"title":87,"path":88,"stem":89},"validate_datachain","/en/mcp/tools/validate-datachain","en/2.mcp/4.tools/7.validate-datachain",{"title":91,"path":92,"stem":93},"render_datachain","/en/mcp/tools/render-datachain","en/2.mcp/4.tools/8.render-datachain",{"title":95,"path":96,"stem":97},"get_icon_url","/en/mcp/tools/get-icon-url","en/2.mcp/4.tools/9.get-icon-url",{"title":99,"path":100,"stem":101},"Prompts","/en/mcp/prompts","en/2.mcp/5.prompts",{"title":103,"path":104,"stem":105,"children":106},"REST API (v2)","/en/rest","en/3.rest/0.index",[107,108,112,116,120,124,128,132,136,140,144,148],{"title":103,"path":104,"stem":105},{"title":109,"path":110,"stem":111},"GET /schemas","/en/rest/schemas","en/3.rest/1.schemas",{"title":113,"path":114,"stem":115},"POST /schemas/:version/resolve","/en/rest/resolve","en/3.rest/10.resolve",{"title":117,"path":118,"stem":119},"POST /schemas/:version/validate_resolved","/en/rest/validate-resolved","en/3.rest/11.validate-resolved",{"title":121,"path":122,"stem":123},"GET /schemas/:version/manifest","/en/rest/manifest","en/3.rest/2.manifest",{"title":125,"path":126,"stem":127},"GET /schemas/:version/categories","/en/rest/categories","en/3.rest/3.categories",{"title":129,"path":130,"stem":131},"GET /schemas/:version/elements","/en/rest/elements-list","en/3.rest/4.elements-list",{"title":133,"path":134,"stem":135},"GET /schemas/:version/elements/:element_id","/en/rest/element-detail","en/3.rest/5.element-detail",{"title":137,"path":138,"stem":139},"POST /schemas/:version/validate","/en/rest/validate","en/3.rest/6.validate",{"title":141,"path":142,"stem":143},"Icon routes","/en/rest/icons","en/3.rest/7.icons",{"title":145,"path":146,"stem":147},"Pagination & fields","/en/rest/pagination-and-fields","en/3.rest/8.pagination-and-fields",{"title":149,"path":150,"stem":151},"Errors","/en/rest/errors","en/3.rest/9.errors",{"title":153,"path":154,"stem":155,"children":156},"Icon composition","/en/icons","en/4.icons/0.index",[157,158,162,166,170],{"title":153,"path":154,"stem":155},{"title":159,"path":160,"stem":161},"Shapes","/en/icons/shapes","en/4.icons/1.shapes",{"title":163,"path":164,"stem":165},"Symbols","/en/icons/symbols","en/4.icons/2.symbols",{"title":167,"path":168,"stem":169},"Composed variants","/en/icons/composed-variants","en/4.icons/3.composed-variants",{"title":171,"path":172,"stem":173},"URLs","/en/icons/urls","en/4.icons/4.urls",{"title":175,"path":176,"stem":177,"children":178},"@dtpr/ui","/en/ui","en/5.ui/0.index",[179,180,184,188,192],{"title":175,"path":176,"stem":177},{"title":181,"path":182,"stem":183},"@dtpr/ui/core","/en/ui/core","en/5.ui/1.core",{"title":185,"path":186,"stem":187},"@dtpr/ui/vue","/en/ui/vue","en/5.ui/2.vue",{"title":189,"path":190,"stem":191},"@dtpr/ui/html","/en/ui/html","en/5.ui/3.html",{"title":193,"path":194,"stem":195},"Theming","/en/ui/theming","en/5.ui/4.theming",{"title":197,"path":198,"stem":199,"children":200},"Concepts","/en/concepts","en/6.concepts/0.index",[201,202,206,210,214,218,222],{"title":197,"path":198,"stem":199},{"title":203,"path":204,"stem":205},"Datachains","/en/concepts/datachains","en/6.concepts/1.datachains",{"title":207,"path":208,"stem":209},"Elements & categories","/en/concepts/elements-categories","en/6.concepts/2.elements-categories",{"title":211,"path":212,"stem":213},"Versions & releases","/en/concepts/versions-and-releases","en/6.concepts/3.versions-and-releases",{"title":215,"path":216,"stem":217},"Content hash","/en/concepts/content-hash","en/6.concepts/4.content-hash",{"title":219,"path":220,"stem":221},"Shape contract","/en/concepts/shape-contract","en/6.concepts/5.shape-contract",{"title":223,"path":224,"stem":225},"Subchains","/en/concepts/subchains","en/6.concepts/6.subchains",{"title":227,"path":228,"stem":229,"children":230},"Claude plugin","/en/plugin","en/7.plugin/0.index",[231,232,236,270,274],{"title":227,"path":228,"stem":229},{"title":233,"path":234,"stem":235},"Install","/en/plugin/install","en/7.plugin/1.install",{"title":237,"path":238,"stem":239,"children":240},"Skills","/en/plugin/skills","en/7.plugin/2.skills/0.index",[241,242,246,250,254,258,262,266],{"title":237,"path":238,"stem":239},{"title":243,"path":244,"stem":245},"dtpr-describe-system","/en/plugin/skills/describe-system","en/7.plugin/2.skills/1.describe-system",{"title":247,"path":248,"stem":249},"dtpr-datachain-structure","/en/plugin/skills/datachain-structure","en/7.plugin/2.skills/2.datachain-structure",{"title":251,"path":252,"stem":253},"dtpr-category-audit","/en/plugin/skills/category-audit","en/7.plugin/2.skills/3.category-audit",{"title":255,"path":256,"stem":257},"dtpr-element-design","/en/plugin/skills/element-design","en/7.plugin/2.skills/4.element-design",{"title":259,"path":260,"stem":261},"dtpr-symbol-design","/en/plugin/skills/symbol-design","en/7.plugin/2.skills/5.symbol-design",{"title":263,"path":264,"stem":265},"dtpr-translate","/en/plugin/skills/translate","en/7.plugin/2.skills/6.translate",{"title":267,"path":268,"stem":269},"dtpr-comprehension-audit","/en/plugin/skills/comprehension-audit","en/7.plugin/2.skills/7.comprehension-audit",{"title":271,"path":272,"stem":273},"Research corpus","/en/plugin/research-corpus","en/7.plugin/3.research-corpus",{"title":275,"path":276,"stem":277},"Comprehension rubric","/en/plugin/comprehension-rubric","en/7.plugin/4.comprehension-rubric",{"title":49,"path":279,"stem":280,"children":281},"/en/tools","en/8.tools/0.index",[282],{"title":49,"path":279,"stem":280},{"title":284,"path":285,"stem":286},"Changelog","/en/changelog","en/9.changelog",{"ok":288,"versions":289},true,[290],{"id":291,"status":292,"created_at":293,"content_hash":294},"ai@2026-05-06-beta","beta","2026-05-06T20:23:42.963Z","sha256-2d208111b0c597ff2b38cb1c24168799b0a5ff9290203ebf46c4f7c16a0fcb24",{"id":296,"title":41,"body":297,"description":1410,"extension":1411,"links":1412,"meta":1413,"navigation":288,"path":42,"seo":1414,"stem":43,"__hash__":1415},"docs_en/en/2.mcp/2.envelope.md",{"type":298,"value":299,"toc":1399},"minimark",[300,310,315,474,573,577,743,799,803,815,996,999,1006,1013,1032,1035,1088,1096,1359,1365,1369,1395],[301,302,304,305,309],"callout",{"type":303},"info","Every DTPR MCP tool returns the same ",[306,307,308],"code",{},"{ ok, data | errors, meta }"," envelope, embedded in the MCP tool-result shape. REST consumers see the identical body shape without the MCP wrapper.",[311,312,314],"h2",{"id":313},"success-envelope","Success envelope",[316,317,322],"pre",{"className":318,"code":319,"language":320,"meta":321,"style":321},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"ok\": true,\n  \"data\": { \"...\": \"...\" },\n  \"meta\": {\n    \"content_hash\": \"sha256-…\",\n    \"version\": \"ai@2026-04-16-beta\",\n    \"next_cursor\": null\n  }\n}\n","json","",[306,323,324,333,352,388,403,426,447,462,468],{"__ignoreMap":321},[325,326,329],"span",{"class":327,"line":328},"line",1,[325,330,332],{"class":331},"sMK4o","{\n",[325,334,336,339,343,346,349],{"class":327,"line":335},2,[325,337,338],{"class":331},"  \"",[325,340,342],{"class":341},"spNyl","ok",[325,344,345],{"class":331},"\"",[325,347,348],{"class":331},":",[325,350,351],{"class":331}," true,\n",[325,353,355,357,360,362,364,367,370,374,376,378,380,383,385],{"class":327,"line":354},3,[325,356,338],{"class":331},[325,358,359],{"class":341},"data",[325,361,345],{"class":331},[325,363,348],{"class":331},[325,365,366],{"class":331}," {",[325,368,369],{"class":331}," \"",[325,371,373],{"class":372},"sBMFI","...",[325,375,345],{"class":331},[325,377,348],{"class":331},[325,379,369],{"class":331},[325,381,373],{"class":382},"sfazB",[325,384,345],{"class":331},[325,386,387],{"class":331}," },\n",[325,389,391,393,396,398,400],{"class":327,"line":390},4,[325,392,338],{"class":331},[325,394,395],{"class":341},"meta",[325,397,345],{"class":331},[325,399,348],{"class":331},[325,401,402],{"class":331}," {\n",[325,404,406,409,412,414,416,418,421,423],{"class":327,"line":405},5,[325,407,408],{"class":331},"    \"",[325,410,411],{"class":372},"content_hash",[325,413,345],{"class":331},[325,415,348],{"class":331},[325,417,369],{"class":331},[325,419,420],{"class":382},"sha256-…",[325,422,345],{"class":331},[325,424,425],{"class":331},",\n",[325,427,429,431,434,436,438,440,443,445],{"class":327,"line":428},6,[325,430,408],{"class":331},[325,432,433],{"class":372},"version",[325,435,345],{"class":331},[325,437,348],{"class":331},[325,439,369],{"class":331},[325,441,442],{"class":382},"ai@2026-04-16-beta",[325,444,345],{"class":331},[325,446,425],{"class":331},[325,448,450,452,455,457,459],{"class":327,"line":449},7,[325,451,408],{"class":331},[325,453,454],{"class":372},"next_cursor",[325,456,345],{"class":331},[325,458,348],{"class":331},[325,460,461],{"class":331}," null\n",[325,463,465],{"class":327,"line":464},8,[325,466,467],{"class":331},"  }\n",[325,469,471],{"class":327,"line":470},9,[325,472,473],{"class":331},"}\n",[475,476,477,490],"table",{},[478,479,480],"thead",{},[481,482,483,487],"tr",{},[484,485,486],"th",{},"Field",[484,488,489],{},"Meaning",[491,492,493,506,515,525,538,558],"tbody",{},[481,494,495,500],{},[496,497,498],"td",{},[306,499,342],{},[496,501,502,505],{},[306,503,504],{},"true"," for success.",[481,507,508,512],{},[496,509,510],{},[306,511,359],{},[496,513,514],{},"Tool-specific payload (see each tool page).",[481,516,517,522],{},[496,518,519],{},[306,520,521],{},"meta.content_hash",[496,523,524],{},"Hex content hash of the schema version being read. Stable across reads of the same version.",[481,526,527,532],{},[496,528,529],{},[306,530,531],{},"meta.version",[496,533,534,535,537],{},"Canonical schema version, e.g. ",[306,536,442],{},".",[481,539,540,545],{},[496,541,542],{},[306,543,544],{},"meta.next_cursor",[496,546,547,548,550,551,553,554,557],{},"Opaque pagination cursor for ",[306,549,75],{}," / ",[306,552,71],{},". ",[306,555,556],{},"null"," on the final page.",[481,559,560,565],{},[496,561,562],{},[306,563,564],{},"meta.warnings",[496,566,567,568,550,570,572],{},"Optional array of short strings. Emitted by ",[306,569,87],{},[306,571,91],{}," when a non-blocking issue was found.",[311,574,576],{"id":575},"error-envelope","Error envelope",[316,578,580],{"className":318,"code":579,"language":320,"meta":321,"style":321},"{\n  \"ok\": false,\n  \"errors\": [\n    {\n      \"code\": \"element_not_found\",\n      \"message\": \"Element 'missing_element' not found in ai@2026-04-16-beta.\",\n      \"path\": \"elements[0].element_id\",\n      \"fix_hint\": \"Use list_elements to enumerate available elements.\"\n    }\n  ],\n  \"meta\": { \"version\": \"ai@2026-04-16-beta\" }\n}\n",[306,581,582,586,599,613,618,638,658,678,697,702,708,738],{"__ignoreMap":321},[325,583,584],{"class":327,"line":328},[325,585,332],{"class":331},[325,587,588,590,592,594,596],{"class":327,"line":335},[325,589,338],{"class":331},[325,591,342],{"class":341},[325,593,345],{"class":331},[325,595,348],{"class":331},[325,597,598],{"class":331}," false,\n",[325,600,601,603,606,608,610],{"class":327,"line":354},[325,602,338],{"class":331},[325,604,605],{"class":341},"errors",[325,607,345],{"class":331},[325,609,348],{"class":331},[325,611,612],{"class":331}," [\n",[325,614,615],{"class":327,"line":390},[325,616,617],{"class":331},"    {\n",[325,619,620,623,625,627,629,631,634,636],{"class":327,"line":405},[325,621,622],{"class":331},"      \"",[325,624,306],{"class":372},[325,626,345],{"class":331},[325,628,348],{"class":331},[325,630,369],{"class":331},[325,632,633],{"class":382},"element_not_found",[325,635,345],{"class":331},[325,637,425],{"class":331},[325,639,640,642,645,647,649,651,654,656],{"class":327,"line":428},[325,641,622],{"class":331},[325,643,644],{"class":372},"message",[325,646,345],{"class":331},[325,648,348],{"class":331},[325,650,369],{"class":331},[325,652,653],{"class":382},"Element 'missing_element' not found in ai@2026-04-16-beta.",[325,655,345],{"class":331},[325,657,425],{"class":331},[325,659,660,662,665,667,669,671,674,676],{"class":327,"line":449},[325,661,622],{"class":331},[325,663,664],{"class":372},"path",[325,666,345],{"class":331},[325,668,348],{"class":331},[325,670,369],{"class":331},[325,672,673],{"class":382},"elements[0].element_id",[325,675,345],{"class":331},[325,677,425],{"class":331},[325,679,680,682,685,687,689,691,694],{"class":327,"line":464},[325,681,622],{"class":331},[325,683,684],{"class":372},"fix_hint",[325,686,345],{"class":331},[325,688,348],{"class":331},[325,690,369],{"class":331},[325,692,693],{"class":382},"Use list_elements to enumerate available elements.",[325,695,696],{"class":331},"\"\n",[325,698,699],{"class":327,"line":470},[325,700,701],{"class":331},"    }\n",[325,703,705],{"class":327,"line":704},10,[325,706,707],{"class":331},"  ],\n",[325,709,711,713,715,717,719,721,723,725,727,729,731,733,735],{"class":327,"line":710},11,[325,712,338],{"class":331},[325,714,395],{"class":341},[325,716,345],{"class":331},[325,718,348],{"class":331},[325,720,366],{"class":331},[325,722,369],{"class":331},[325,724,433],{"class":372},[325,726,345],{"class":331},[325,728,348],{"class":331},[325,730,369],{"class":331},[325,732,442],{"class":382},[325,734,345],{"class":331},[325,736,737],{"class":331}," }\n",[325,739,741],{"class":327,"line":740},12,[325,742,473],{"class":331},[475,744,745,753],{},[478,746,747],{},[481,748,749,751],{},[484,750,486],{},[484,752,489],{},[491,754,755,769,779,789],{},[481,756,757,762],{},[496,758,759],{},[306,760,761],{},"errors[].code",[496,763,764,765,537],{},"Stable machine-readable code. See ",[766,767,149],"a",{"href":768},"/rest/errors",[481,770,771,776],{},[496,772,773],{},[306,774,775],{},"errors[].message",[496,777,778],{},"Human-readable diagnostic.",[481,780,781,786],{},[496,782,783],{},[306,784,785],{},"errors[].path",[496,787,788],{},"Optional JSON path pointing into the caller's payload.",[481,790,791,796],{},[496,792,793],{},[306,794,795],{},"errors[].fix_hint",[496,797,798],{},"Optional short instruction for a human or agent.",[311,800,802],{"id":801},"mcp-wrapping","MCP wrapping",[804,805,806,807,810,811,814],"p",{},"Tools return the envelope twice — as typed ",[306,808,809],{},"structuredContent"," for 2025-06-18-capable clients, and as a JSON string inside ",[306,812,813],{},"content[0].text"," for older clients:",[316,816,818],{"className":318,"code":817,"language":320,"meta":321,"style":321},"{\n  \"structuredContent\": { \"ok\": true, \"data\": { \"...\": \"...\" }, \"meta\": { \"...\": \"...\" } },\n  \"content\": [\n    { \"type\": \"text\", \"text\": \"{\\\"ok\\\":true,\\\"data\\\":{...},\\\"meta\\\":{...}}\" }\n  ]\n}\n",[306,819,820,824,904,917,987,992],{"__ignoreMap":321},[325,821,822],{"class":327,"line":328},[325,823,332],{"class":331},[325,825,826,828,830,832,834,836,838,840,842,844,847,849,851,853,855,857,859,862,864,866,868,870,872,875,877,879,881,883,885,887,889,891,893,895,897,899,902],{"class":327,"line":335},[325,827,338],{"class":331},[325,829,809],{"class":341},[325,831,345],{"class":331},[325,833,348],{"class":331},[325,835,366],{"class":331},[325,837,369],{"class":331},[325,839,342],{"class":372},[325,841,345],{"class":331},[325,843,348],{"class":331},[325,845,846],{"class":331}," true,",[325,848,369],{"class":331},[325,850,359],{"class":372},[325,852,345],{"class":331},[325,854,348],{"class":331},[325,856,366],{"class":331},[325,858,369],{"class":331},[325,860,373],{"class":861},"sbssI",[325,863,345],{"class":331},[325,865,348],{"class":331},[325,867,369],{"class":331},[325,869,373],{"class":382},[325,871,345],{"class":331},[325,873,874],{"class":331}," },",[325,876,369],{"class":331},[325,878,395],{"class":372},[325,880,345],{"class":331},[325,882,348],{"class":331},[325,884,366],{"class":331},[325,886,369],{"class":331},[325,888,373],{"class":861},[325,890,345],{"class":331},[325,892,348],{"class":331},[325,894,369],{"class":331},[325,896,373],{"class":382},[325,898,345],{"class":331},[325,900,901],{"class":331}," }",[325,903,387],{"class":331},[325,905,906,908,911,913,915],{"class":327,"line":354},[325,907,338],{"class":331},[325,909,910],{"class":341},"content",[325,912,345],{"class":331},[325,914,348],{"class":331},[325,916,612],{"class":331},[325,918,919,922,924,927,929,931,933,936,938,941,943,945,947,949,951,954,958,960,962,965,967,969,971,974,976,978,980,983,985],{"class":327,"line":390},[325,920,921],{"class":331},"    {",[325,923,369],{"class":331},[325,925,926],{"class":372},"type",[325,928,345],{"class":331},[325,930,348],{"class":331},[325,932,369],{"class":331},[325,934,935],{"class":382},"text",[325,937,345],{"class":331},[325,939,940],{"class":331},",",[325,942,369],{"class":331},[325,944,935],{"class":372},[325,946,345],{"class":331},[325,948,348],{"class":331},[325,950,369],{"class":331},[325,952,953],{"class":382},"{",[325,955,957],{"class":956},"sTEyZ","\\\"",[325,959,342],{"class":382},[325,961,957],{"class":956},[325,963,964],{"class":382},":true,",[325,966,957],{"class":956},[325,968,359],{"class":382},[325,970,957],{"class":956},[325,972,973],{"class":382},":{...},",[325,975,957],{"class":956},[325,977,395],{"class":382},[325,979,957],{"class":956},[325,981,982],{"class":382},":{...}}",[325,984,345],{"class":331},[325,986,737],{"class":331},[325,988,989],{"class":327,"line":405},[325,990,991],{"class":331},"  ]\n",[325,993,994],{"class":327,"line":428},[325,995,473],{"class":331},[804,997,998],{},"Both carry the same payload; read whichever your client supports.",[311,1000,1002,1005],{"id":1001},"iserror-and-soft-failure",[306,1003,1004],{},"isError"," and soft-failure",[804,1007,1008,1009,1012],{},"Hard failures (transport, arguments, unknown version, internal error) surface with ",[306,1010,1011],{},"isError: true"," in the tool result. The MCP client should treat them like exceptions.",[804,1014,1015,1019,1020,1024,1025,1028,1029,1031],{},[1016,1017,1018],"strong",{},"Soft failures"," — where the call ran successfully but the ",[1021,1022,1023],"em",{},"answer"," is \"no\" or \"invalid\" — set ",[306,1026,1027],{},"ok: false"," without setting ",[306,1030,1004],{},". The client should read the envelope and display the semantic result.",[804,1033,1034],{},"The soft-failure pattern is used by three tools:",[475,1036,1037,1047],{},[478,1038,1039],{},[481,1040,1041,1044],{},[484,1042,1043],{},"Tool",[484,1045,1046],{},"Soft-failure case",[491,1048,1049,1061,1073],{},[481,1050,1051,1058],{},[496,1052,1053],{},[766,1054,1056],{"href":1055},"/mcp/tools/validate-datachain",[306,1057,87],{},[496,1059,1060],{},"Instance is well-formed but semantically invalid (missing required categories, wrong element placement, etc.).",[481,1062,1063,1070],{},[496,1064,1065],{},[766,1066,1068],{"href":1067},"/mcp/tools/render-datachain",[306,1069,91],{},[496,1071,1072],{},"Same semantic validation as above; rendering aborts rather than returning a broken document.",[481,1074,1075,1082],{},[496,1076,1077],{},[766,1078,1080],{"href":1079},"/mcp/tools/get-elements",[306,1081,83],{},[496,1083,1084,1085,1087],{},"One or more requested element ids were not found. The response includes successful hits plus ",[306,1086,556],{}," entries for misses.",[1089,1090,1092,1093,1095],"h3",{"id":1091},"soft-failure-example-validate_datachain","Soft-failure example (",[306,1094,87],{},")",[316,1097,1099],{"className":318,"code":1098,"language":320,"meta":321,"style":321},"{\n  \"structuredContent\": {\n    \"ok\": false,\n    \"errors\": [\n      {\n        \"code\": \"element_required\",\n        \"message\": \"Category 'purpose' requires at least one element.\",\n        \"path\": \"elements\",\n        \"fix_hint\": \"Add an element with category_id='purpose'.\"\n      }\n    ],\n    \"meta\": {\n      \"content_hash\": \"sha256-…\",\n      \"version\": \"ai@2026-04-16-beta\",\n      \"warnings\": []\n    }\n  },\n  \"content\": [{ \"type\": \"text\", \"text\": \"...\" }]\n}\n",[306,1100,1101,1105,1117,1129,1141,1146,1166,1185,1204,1221,1226,1231,1243,1262,1281,1296,1301,1307,1354],{"__ignoreMap":321},[325,1102,1103],{"class":327,"line":328},[325,1104,332],{"class":331},[325,1106,1107,1109,1111,1113,1115],{"class":327,"line":335},[325,1108,338],{"class":331},[325,1110,809],{"class":341},[325,1112,345],{"class":331},[325,1114,348],{"class":331},[325,1116,402],{"class":331},[325,1118,1119,1121,1123,1125,1127],{"class":327,"line":354},[325,1120,408],{"class":331},[325,1122,342],{"class":372},[325,1124,345],{"class":331},[325,1126,348],{"class":331},[325,1128,598],{"class":331},[325,1130,1131,1133,1135,1137,1139],{"class":327,"line":390},[325,1132,408],{"class":331},[325,1134,605],{"class":372},[325,1136,345],{"class":331},[325,1138,348],{"class":331},[325,1140,612],{"class":331},[325,1142,1143],{"class":327,"line":405},[325,1144,1145],{"class":331},"      {\n",[325,1147,1148,1151,1153,1155,1157,1159,1162,1164],{"class":327,"line":428},[325,1149,1150],{"class":331},"        \"",[325,1152,306],{"class":861},[325,1154,345],{"class":331},[325,1156,348],{"class":331},[325,1158,369],{"class":331},[325,1160,1161],{"class":382},"element_required",[325,1163,345],{"class":331},[325,1165,425],{"class":331},[325,1167,1168,1170,1172,1174,1176,1178,1181,1183],{"class":327,"line":449},[325,1169,1150],{"class":331},[325,1171,644],{"class":861},[325,1173,345],{"class":331},[325,1175,348],{"class":331},[325,1177,369],{"class":331},[325,1179,1180],{"class":382},"Category 'purpose' requires at least one element.",[325,1182,345],{"class":331},[325,1184,425],{"class":331},[325,1186,1187,1189,1191,1193,1195,1197,1200,1202],{"class":327,"line":464},[325,1188,1150],{"class":331},[325,1190,664],{"class":861},[325,1192,345],{"class":331},[325,1194,348],{"class":331},[325,1196,369],{"class":331},[325,1198,1199],{"class":382},"elements",[325,1201,345],{"class":331},[325,1203,425],{"class":331},[325,1205,1206,1208,1210,1212,1214,1216,1219],{"class":327,"line":470},[325,1207,1150],{"class":331},[325,1209,684],{"class":861},[325,1211,345],{"class":331},[325,1213,348],{"class":331},[325,1215,369],{"class":331},[325,1217,1218],{"class":382},"Add an element with category_id='purpose'.",[325,1220,696],{"class":331},[325,1222,1223],{"class":327,"line":704},[325,1224,1225],{"class":331},"      }\n",[325,1227,1228],{"class":327,"line":710},[325,1229,1230],{"class":331},"    ],\n",[325,1232,1233,1235,1237,1239,1241],{"class":327,"line":740},[325,1234,408],{"class":331},[325,1236,395],{"class":372},[325,1238,345],{"class":331},[325,1240,348],{"class":331},[325,1242,402],{"class":331},[325,1244,1246,1248,1250,1252,1254,1256,1258,1260],{"class":327,"line":1245},13,[325,1247,622],{"class":331},[325,1249,411],{"class":861},[325,1251,345],{"class":331},[325,1253,348],{"class":331},[325,1255,369],{"class":331},[325,1257,420],{"class":382},[325,1259,345],{"class":331},[325,1261,425],{"class":331},[325,1263,1265,1267,1269,1271,1273,1275,1277,1279],{"class":327,"line":1264},14,[325,1266,622],{"class":331},[325,1268,433],{"class":861},[325,1270,345],{"class":331},[325,1272,348],{"class":331},[325,1274,369],{"class":331},[325,1276,442],{"class":382},[325,1278,345],{"class":331},[325,1280,425],{"class":331},[325,1282,1284,1286,1289,1291,1293],{"class":327,"line":1283},15,[325,1285,622],{"class":331},[325,1287,1288],{"class":861},"warnings",[325,1290,345],{"class":331},[325,1292,348],{"class":331},[325,1294,1295],{"class":331}," []\n",[325,1297,1299],{"class":327,"line":1298},16,[325,1300,701],{"class":331},[325,1302,1304],{"class":327,"line":1303},17,[325,1305,1306],{"class":331},"  },\n",[325,1308,1310,1312,1314,1316,1318,1321,1323,1325,1327,1329,1331,1333,1335,1337,1339,1341,1343,1345,1347,1349,1351],{"class":327,"line":1309},18,[325,1311,338],{"class":331},[325,1313,910],{"class":341},[325,1315,345],{"class":331},[325,1317,348],{"class":331},[325,1319,1320],{"class":331}," [{",[325,1322,369],{"class":331},[325,1324,926],{"class":372},[325,1326,345],{"class":331},[325,1328,348],{"class":331},[325,1330,369],{"class":331},[325,1332,935],{"class":382},[325,1334,345],{"class":331},[325,1336,940],{"class":331},[325,1338,369],{"class":331},[325,1340,935],{"class":372},[325,1342,345],{"class":331},[325,1344,348],{"class":331},[325,1346,369],{"class":331},[325,1348,373],{"class":382},[325,1350,345],{"class":331},[325,1352,1353],{"class":331}," }]\n",[325,1355,1357],{"class":327,"line":1356},19,[325,1358,473],{"class":331},[804,1360,1361,1362,1364],{},"Note the absence of ",[306,1363,1004],{},". The client learned the datachain is invalid; the call itself succeeded.",[311,1366,1368],{"id":1367},"see-also","See also",[1370,1371,1372,1381,1388],"ul",{},[1373,1374,1375,1377,1378,1380],"li",{},[766,1376,149],{"href":768}," — canonical list of ",[306,1379,306],{}," values.",[1373,1382,1383,1387],{},[766,1384,1385],{"href":1055},[306,1386,87],{}," — the flagship soft-failure tool.",[1373,1389,1390,1394],{},[766,1391,1392],{"href":1079},[306,1393,83],{}," — partial-success pattern.",[1396,1397,1398],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}",{"title":321,"searchDepth":335,"depth":335,"links":1400},[1401,1402,1403,1404,1409],{"id":313,"depth":335,"text":314},{"id":575,"depth":335,"text":576},{"id":801,"depth":335,"text":802},{"id":1001,"depth":335,"text":1405,"children":1406},"isError and soft-failure",[1407],{"id":1091,"depth":354,"text":1408},"Soft-failure example (validate_datachain)",{"id":1367,"depth":335,"text":1368},"ok / err payload shape, _meta fields, and soft-failure semantics shared across every tool.","md",null,{},{"title":41,"description":1410},"46V2iFSFz62YpSCMJUNiwebuPKSSbZv5yOJHDgtJ1kY",[1417,1419],{"title":37,"path":38,"stem":39,"description":1418,"children":-1},"Endpoint, headers, wire format, and batch behavior for the DTPR MCP server.",{"title":45,"path":46,"stem":47,"description":1420,"children":-1},"The ui://dtpr/datachain/view.html MCP App resource and session-scoped rendering.",1779049691443]