stillmade-sdk 0.1.42 → 0.1.44

package/examples/research-topic.stillmade.json

@@ -31,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/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": {
@@ -96,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/timeline-polish.stillmade.json

@@ -21,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

@@ -20,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stillmade-sdk",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "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