Recipe Blocks
Compose bounded operations with declarative input and output bindings.
{
"schemaVersion":1,
"steps":[{"id":"clean","op":"text.trim","args":{"text":{"$input":"text"}}}],
"outputs":{"text":{"$step":"clean"}}
}Steps run in listed order. References may only read supplied inputs or a completed prior step using own-property paths. There is no eval, module import, loop or shell. Maximum 64 steps; unknown operations, unresolved references, bad outputs, and undeclared fields fail. Cancellation is checked between operations. The web runner executes in a disposable worker with a 15-second timeout; the trust boundary is the data interpreter, not a claim that arbitrary code is safe in a Web Worker.
runPackage(package,input,{signal,onProgress}) returns {outputs}. It does not mutate the input or commit changes to a project. BlockError includes code and message; display the failure, never install a build that fails required tests.
Complete example
{
"manifest": {
"schemaVersion": 1,
"license": "MIT",
"provenance": {
"notice": "MIT License\n\nCopyright (c) 2026 StillMade SDK contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and \nassociated documentation files (the \"Software\"), to deal in the Software without restriction, including \nwithout limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell \ncopies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the \nfollowing conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial \nportions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT \nLIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO \nEVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER \nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE \nUSE OR OTHER DEALINGS IN THE SOFTWARE.\n"
},
"sdkVersion": "0.1.0",
"id": "example.clean-text",
"version": "1.0.0",
"name": "Clean text",
"description": "Trims extra space from text and returns a clean copy for the next step.",
"kind": "task",
"runtime": "recipe",
"inputs": {
"text": {
"type": "text",
"semantic": "plain_text",
"required": true,
"description": "Text whose surrounding whitespace should be removed."
}
},
"outputs": {
"text": {
"type": "text",
"semantic": "plain_text",
"description": "The same text with surrounding whitespace removed."
}
},
"permissions": {
"project": [],
"network": [],
"filesystem": [],
"secrets": []
},
"ui": [
{
"control": "text",
"port": "text"
}
]
},
"recipe": {
"schemaVersion": 1,
"steps": [
{
"id": "clean",
"op": "text.trim",
"args": {
"text": {
"$input": "text"
}
}
}
],
"outputs": {
"text": {
"$step": "clean"
}
}
},
"tests": [
{
"name": "Trims surrounding whitespace",
"input": {
"text": " StillMade\n"
},
"expected": {
"text": "StillMade"
}
}
]
}See the operation reference for the complete allowlist.