stillmade-sdk 0.1.41 → 0.1.43

package/examples/custom-interface.stillmade.json

@@ -7,6 +7,10 @@
     },
     "sdkVersion": "0.1.0",
     "id": "example.clean-text-interface",
+    "action": {
+      "label": "Clean text",
+      "running": "Cleaning text…"
+    },
     "version": "1.1.0",
     "name": "Clean text studio",
     "description": "Edit text, run the cleanup, and compare the result in a responsive self-contained workspace.",

package/examples/describe-image.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.describe-image",
+    "action": {
+      "label": "Describe image",
+      "running": "Describing image…"
+    },
     "version": "1.0.0",
     "name": "Describe an image",
     "description": "Turn one owned image into concise production-ready visual notes.",

package/examples/foley-cue.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.foley-cue",
+    "action": {
+      "label": "Generate sound",
+      "running": "Generating sound…"
+    },
     "version": "1.0.0",
     "name": "Foley cue",
     "description": "Generate a short sound effect from a written description.",

package/examples/generate-image.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.generate-image",
+    "action": {
+      "label": "Generate image",
+      "running": "Generating image…"
+    },
     "version": "1.0.0",
     "name": "Generate an image",
     "description": "Generate a square PNG from a short visual prompt using an approved host request.",

package/examples/generate-video.stillmade.json

@@ -2,6 +2,10 @@
   "manifest": {
     "schemaVersion": 1,
     "id": "example.generate-video",
+    "action": {
+      "label": "Generate video",
+      "running": "Generating video…"
+    },
     "name": "Generate video",
     "version": "1.0.0",
     "sdkVersion": "0.1.0",
@@ -17,13 +21,17 @@
       "prompt": {
         "type": "text",
         "primary": true,
-        "required": true
+        "required": true,
+        "semantic": "video_prompt",
+        "description": "What the clip shows: subject, action, setting and camera, in a sentence or two."
       }
     },
     "outputs": {
       "video": {
         "type": "video",
-        "primary": true
+        "primary": true,
+        "semantic": "generated_video",
+        "description": "The generated clip."
       }
     },
     "permissions": {

package/examples/module-word-stats/stillmade.block.json

@@ -2,6 +2,10 @@
   "schemaVersion": 1,
   "sdkVersion": "0.1.0",
   "id": "example.word-stats",
+  "action": {
+    "label": "Count words",
+    "running": "Counting words…"
+  },
   "version": "1.0.0",
   "name": "Word stats",
   "description": "Counts words and finds the longest one, as a modern JavaScript module.",

package/examples/narrate-script.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.narrate-script",
+    "action": {
+      "label": "Generate voiceover",
+      "running": "Generating voiceover…"
+    },
     "version": "1.0.0",
     "name": "Narrate a script",
     "description": "Turn a short script into a reviewed speech recording using a host-selected voice.",

package/examples/numbered-takes.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.numbered-takes",
+    "action": {
+      "label": "Number takes",
+      "running": "Numbering takes…"
+    },
     "version": "1.0.0",
     "name": "Numbered takes",
     "description": "Label successive creative takes with an independent counter for each production placement.",

package/examples/research-topic.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.research-topic",
+    "action": {
+      "label": "Research topic",
+      "running": "Researching topic…"
+    },
     "version": "1.0.0",
     "name": "Research a topic",
     "description": "Search the web for a topic and return a cited summary.",
@@ -27,7 +31,11 @@
         "type": "json",
         "primary": true,
         "semantic": "research_findings",
-        "description": "Summary and the sources it came from."
+        "description": "Summary and the sources it came from.",
+        "schema": {
+          "summary": "text",
+          "sources": "json[]"
+        }
       }
     },
     "permissions": {

package/examples/score-a-scene.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.score-a-scene",
+    "action": {
+      "label": "Generate music",
+      "running": "Generating music…"
+    },
     "version": "1.0.0",
     "name": "Score a scene",
     "description": "Generate a short music bed for a scene from a written mood brief.",

package/examples/script-draft.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.script-draft",
+    "action": {
+      "label": "Write script",
+      "running": "Writing script…"
+    },
     "version": "1.0.0",
     "name": "Draft a short script",
     "description": "Turn a production brief into a short narration draft using an approved text-generation call.",

package/examples/summarize-page.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.summarize-page",
+    "action": {
+      "label": "Summarize page",
+      "running": "Summarizing page…"
+    },
     "version": "1.0.0",
     "name": "Summarize a page",
     "description": "Read a public web page and summarize it in a few production-ready bullet points.",

package/examples/text-workflow.stillmade.json

@@ -3,13 +3,7 @@
   "id": "example.text-workflow",
   "version": "1.0.0",
   "name": "Text workflow",
-  "description": "Clean text through two connected blocks, then use the shared editor to assemble media.",
-  "summary": {
-    "origin": "llm",
-    "generation": "build-time",
-    "generator": "Codex",
-    "status": "ready"
-  },
+  "description": "Clean the text, then assemble and export the video in the Editor.",
   "packages": [
     {
       "manifest": {
@@ -20,6 +14,10 @@
         },
         "sdkVersion": "0.1.0",
         "id": "example.clean-text",
+        "action": {
+          "label": "Clean text",
+          "running": "Cleaning text…"
+        },
         "version": "1.0.0",
         "name": "Clean text",
         "description": "Trims extra space from text and returns a clean copy for the next step.",
@@ -92,35 +90,12 @@
       "version": "1.0.0",
       "label": "Prepare text"
     },
-    {
-      "id": "second",
-      "blockId": "example.clean-text",
-      "version": "1.0.0",
-      "label": "Review clean text"
-    },
     {
       "id": "edit",
       "blockId": "sm.editor",
       "version": "1.0.0",
-      "label": "Edit media"
-    },
-    {
-      "id": "export",
-      "blockId": "sm.export-video",
-      "version": "1.0.0",
-      "label": "Export video"
+      "label": "Edit and export"
     }
   ],
-  "connections": [
-    {
-      "from": {
-        "stage": "first",
-        "port": "text"
-      },
-      "to": {
-        "stage": "second",
-        "port": "text"
-      }
-    }
-  ]
+  "connections": []
 }

package/examples/thicken-lines.stillmade.json

@@ -7,6 +7,10 @@
     },
     "sdkVersion": "0.1.0",
     "id": "example.thicken-lines",
+    "action": {
+      "label": "Thicken lines",
+      "running": "Thickening lines…"
+    },
     "version": "1.0.1",
     "name": "Thicken line art",
     "description": "Expands dark outlines in an image while preserving surrounding colors, creating a new image for the next production step.",

package/examples/timeline-polish.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.timeline-polish",
+    "action": {
+      "label": "Suggest edit",
+      "running": "Suggesting edit…"
+    },
     "version": "1.0.0",
     "name": "Timeline polish",
     "description": "Turn a timeline and editing direction into a bounded proposal that remains reviewable before Apply.",
@@ -17,17 +21,25 @@
       "timeline": {
         "type": "timeline",
         "context": "timeline",
-        "primary": true
+        "primary": true,
+        "required": true,
+        "semantic": "edit_timeline",
+        "description": "The cut to improve."
       },
       "direction": {
         "type": "text",
-        "default": "Polish this cut conservatively."
+        "default": "Polish this cut conservatively.",
+        "required": false,
+        "semantic": "edit_direction",
+        "description": "How to change the cut, in a sentence."
       }
     },
     "outputs": {
       "edit": {
         "type": "timeline-edit",
-        "primary": true
+        "primary": true,
+        "semantic": "timeline_edit",
+        "description": "The proposed changes to review before they apply."
       }
     },
     "permissions": {

package/examples/transcribe-audio.stillmade.json

@@ -3,6 +3,10 @@
     "schemaVersion": 1,
     "sdkVersion": "0.1.0",
     "id": "example.transcribe-audio",
+    "action": {
+      "label": "Transcribe audio",
+      "running": "Transcribing…"
+    },
     "version": "1.0.0",
     "name": "Transcribe audio",
     "description": "Turn one persistent audio file into reviewed text with word timings.",
@@ -16,17 +20,25 @@
     "inputs": {
       "audio": {
         "type": "audio",
-        "primary": true
+        "primary": true,
+        "required": true,
+        "semantic": "source_audio",
+        "description": "The recording to turn into text."
       },
       "language": {
         "type": "text",
-        "default": "auto"
+        "default": "auto",
+        "required": false,
+        "semantic": "language_code",
+        "description": "auto, or a two-letter language code such as en."
       }
     },
     "outputs": {
       "transcript": {
         "type": "transcript",
-        "primary": true
+        "primary": true,
+        "semantic": "timed_transcript",
+        "description": "The spoken words with their timings."
       }
     },
     "permissions": {

package/examples/word-count.stillmade.json

@@ -7,6 +7,10 @@
     },
     "sdkVersion": "0.1.0",
     "id": "example.word-count",
+    "action": {
+      "label": "Count words",
+      "running": "Counting words…"
+    },
     "version": "1.0.0",
     "name": "Word count",
     "description": "Counts words and returns trimmed text using isolated JavaScript.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stillmade-sdk",
-  "version": "0.1.41",
+  "version": "0.1.43",
   "description": "StillMade Block SDK, CLI and examples",
   "license": "PolyForm-Shield-1.0.0",
   "type": "module",

package/packages/block-cli/cli.js

@@ -45,7 +45,8 @@ import {previewProjectType} from '../block-platform/type-preview.js';
 import {assessBlockReadiness} from '../block-platform/block-readiness.js';
 import {defineBrowserApplicationSource} from '../block-sdk/browser-application-execution.js';
 import { BUILTIN_BLOCKS } from '../block-platform/catalog.js';
-import { RECIPE_TYPE_EXAMPLE, typeWorkspaceSupport } from '../block-platform/type-workspace.js';
+import { typeWorkspaceSupport } from '../block-platform/type-workspace.js';
+import {embedTypePackages,checkTypeModuleSources,typeModuleRunner,TYPE_SCAFFOLD} from './type-packages.js';
 import {PLATFORM_CHECK_POLICY,PLATFORM_CHECK_TARGETS,PLATFORM_CHECK_THEMES} from '../block-sdk/platform-checks.js';
 import {MODULE_LIMITS} from '../block-sdk/module-runtime.js';
 import {createModuleBundle,readModuleBundle,hasDigestFiles,MODULE_BUNDLE_SUFFIX} from '../block-sdk/module-bundle.js';
@@ -202,7 +203,7 @@ export async function main(rawArgs) {
   if(args[0]==='templates'||args[0]==='create'&&args.includes('--list'))return {templates:Object.entries(TEMPLATES).map(([name,template])=>({name,runtime:template.runtime,description:template.description}))};
   const [command, target = '.', extra] = args, path = resolve(target);
   if (command === 'create-type') {
-    await writeFile(path, JSON.stringify(RECIPE_TYPE_EXAMPLE, null, 2), { flag: 'wx' });
+    await writeFile(path, JSON.stringify(TYPE_SCAFFOLD, null, 2), { flag: 'wx' });
     return { created: path, kind: 'type' };
   }
   if (command === 'create') {
@@ -223,7 +224,7 @@ export async function main(rawArgs) {
     for(const name of names){await mkdir(dirname(join(path,name)),{recursive:true});await writeFile(join(path,name),files[name],{flag:'wx'});}
     // Coding agents read command output: restate the readiness rule where they will see it, with the folder as it
     // was typed (October 27, 2026: `gate .` in the folder holding an extracted SDK judged the SDK's examples too).
-    return { created: path, sdkVersion: '0.1.0', template:template.name, runtime:template.runtime, files:names, next: `Build the Block and write its feature map (\`manifest.features\`: one entry per thing it can do), then run \`stillmade-block gate ${/\s/.test(target)?`"${target}"`:target}\`. Do not call the Block ready until the gate passes; report the status it prints.` };
+    return { created: path, sdkVersion: '0.1.0', template:template.name, runtime:template.runtime, files:names, next: `Build the Block, replace its placeholder \`description\` and the copyright holder in \`provenance.notice\` (the person it is made for), and write its feature map (\`manifest.features\`: one entry per thing it can do), then run \`stillmade-block gate ${/\s/.test(target)?`"${target}"`:target}\`. Do not call the Block ready until the gate passes; report the status it prints.` };
   }
   if (command === 'gate') {
     // Every new or edited Block in a folder must pass readiness before anyone calls it ready.
@@ -245,6 +246,8 @@ export async function main(rawArgs) {
   }
   if (!['validate', 'test', 'preview', 'pack', 'inspect', 'remix', 'ready', 'permissions'].includes(command)) throw Object.assign(new Error(`Unknown command ${command}. Run stillmade-block --help for the commands.`),{code:'USAGE'});
   let pkg = await readPackage(path);
+  // A Type's packages may name a packed Block or a Block folder, or embed a packed module bundle (type-packages.js).
+  if(pkg?.stages)pkg=await embedTypePackages(pkg,{folder:dirname(path),resolvePath:resolve,read:async file=>{const block=await readPackage(file);return {pkg:block,files:moduleFiles.get(block)};}});
   if(args.includes('--original')){
     if(command!=='pack'||!extra||extra.startsWith('--'))throw new Error('Use pack <source> <output.stillmade-block> --original only for your own original implementation.');
     pkg=withOriginalSource(pkg);
@@ -286,6 +289,7 @@ export async function main(rawArgs) {
   // StillMade cannot store text with a NUL character; say where it is before the author imports the package.
   if(['validate','test','pack','ready'].includes(command))assertStorableText(pkg);
   if (pkg.stages) {
+    await checkTypeModuleSources(pkg);
     const valid = validateProjectType(pkg, BUILTIN_BLOCKS);
     if (!valid.valid) throw new Error(valid.errors.map(e => e.message).join('. '));
     if(command !== 'preview')for(const block of pkg.packages || [])appearanceAdvice(block.view);
@@ -294,7 +298,10 @@ export async function main(rawArgs) {
     if (command === 'validate') return { valid: true, id: pkg.id,...(args.includes('--mobile')?{mobileProfile:mobileProfile()}:{}),...(hosted ? {tests:0,...review} : {}) };
     if (command === 'inspect') return { id: pkg.id, version: pkg.version, stages: pkg.stages, workspace: typeWorkspaceSupport(pkg) };
     if(command==='permissions')return {id:pkg.id,blocks:(pkg.packages||[]).map(block=>({id:block.manifest.id,summary:summarizePermissions(block.manifest)}))};
-    if (command === 'preview') return previewProjectType(pkg,{inputs:extra ? JSON.parse(await readFile(resolve(extra),'utf8')) : {}});
+    // Module Steps run in the SDK's local module runner, as `test` and `preview` run a module Block (type-packages.js).
+    const runner=typeModuleRunner({mock:mockRequested,readLocalFile:localFileReader(dirname(path))});
+    const standIns=()=>{const calls=runner.calls();return calls.length?{standIns:calls,liveVerified:false}:{};};
+    if (command === 'preview') {const preview=await previewProjectType(pkg,{inputs:extra ? JSON.parse(await readFile(resolve(extra),'utf8')) : {},run:runner.run});return {...preview,...standIns()};}
     // Export source without executing local or hosted code. This is not an
     // admission report; every embedded package still needs host review later.
     if(command==='pack' && hosted){
@@ -306,12 +313,12 @@ export async function main(rawArgs) {
       await writeFile(output,JSON.stringify(pkg,null,2),{flag:packFlag(extra)});
       return {file:output,digest:await digest(pkg),tests:0,...review,message:'Project Type source packaged without execution. In StillMade, review every embedded hosted Block in StillMade (including ComfyUI backend fixtures and samples), then confirm the import after local admission checks. The connected workflow has not run.'};
     }
-    const report = await testProjectType(pkg);
+    const report = {...await testProjectType(pkg,runner.test,{run:runner.run}),...standIns()};
     if (!report.passed) throw Object.assign(new Error('Project Type validation or execution checks need attention'), { report:{...report,...(hosted ? {reviewRequired:true,liveVerified:false} : {})} });
     if (command === 'test') return report;
     const output = jsonOutput(extra,`${pkg.id}-${pkg.version}.stillmade.json`);
     await writeFile(output, JSON.stringify(pkg, null, 2), { flag: packFlag(extra) });
-    return { file: output, digest: report.digest, tests: (pkg.packages || []).reduce((count,dependency)=>count+dependency.tests.length,0), workflowComplete:report.workflowComplete, workflowStatus:report.workflowStatus };
+    return { file: output, digest: report.digest, tests: (pkg.packages || []).reduce((count,dependency)=>count+dependency.tests.length,0), workflowComplete:report.workflowComplete, workflowStatus:report.workflowStatus,...standIns() };
   }
   // permissions: what the Block can do in plain words, and what its source uses that
   // the manifest does not declare (or declares and never uses). --fix corrects the