stillmade-sdk 0.1.38 → 0.1.40

package/packages/block-sdk/module-hosted.js

@@ -4,7 +4,7 @@
 // executed and checked exactly like one. The module Block must list the
 // operation in `permissions.capabilities`.
 import {assert,plain,stableStringify} from './contracts.js';
-import {defaultCapabilityExpectations} from './capabilities.js';
+import {defaultCapabilityExpectations,MEDIA_ANALYZE_LIMITS} from './capabilities.js';
 import {GENERATION_LIMITS,IMAGE_GENERATION_MODELS} from './generation-catalog.js';
 
 const text=(value,max)=>typeof value==='string'&&value.trim().length>0&&value.length<=max;
@@ -47,8 +47,11 @@ const SHAPES={
   return {inputs:{prompt:port('text','Sound effect prompt')},outputs:{result:port('audio','Generated sound effect')},capability:{prompt:{$input:'prompt'},output:'result',...(request.durationSec?{settings:{durationSec:request.durationSec}}:{})},input:{prompt:request.prompt}};
  },
  'audio.transcribe':request=>{
-  if(!media(request.audio,'audio'))fail('audio.transcribe needs a saved audio reference');
-  return {inputs:{audio:port('audio','Audio to transcribe'),language:{type:'text',description:'Language code or auto',required:false,default:'auto'}},outputs:{result:port('transcript','Timed transcript')},capability:{audio:{$input:'audio'},language:{$input:'language'},output:'result'},input:{audio:request.audio,language:typeof request.language==='string'?request.language:'auto'}};
+  // A video's sound is transcribed as a capability Block's is (November 1, 2026: a sermon clip Block had to extract the
+  // audio first because only audio was accepted here).
+  const kind=request.audio?.kind==='video'?'video':'audio';
+  if(!media(request.audio,kind))fail('audio.transcribe needs a saved audio or video reference');
+  return {inputs:{audio:port(kind,kind==='video'?'Video whose sound to transcribe':'Audio to transcribe'),language:{type:'text',description:'Language code or auto',required:false,default:'auto'}},outputs:{result:port('transcript','Timed transcript')},capability:{audio:{$input:'audio'},language:{$input:'language'},output:'result'},input:{audio:request.audio,language:typeof request.language==='string'?request.language:'auto'}};
  },
  'image.describe':request=>{
   const images=Array.isArray(request.images)?request.images:[request.image];
@@ -63,8 +66,12 @@ const SHAPES={
   if(!text(request.question,2000))fail('media.analyze needs a question');
   // October 30, 2026: detail:'check' is the short photo check, priced per call of up to four photos.
   if(request.detail!==undefined&&(request.detail!=='check'||kind!=='image'))fail('media.analyze detail:"check" checks one to four saved images, never a video');
+  // range: one part of a video looked at closely, as a capability Block binds it (November 1, 2026: a sermon clip Block
+  // could only look at the whole sermon at once).
+  const range=request.range;
+  if(range!==undefined&&!(kind==='video'&&plain(range)&&Object.keys(range).sort().join(',')==='end,start'&&Number.isFinite(range.start)&&Number.isFinite(range.end)&&range.start>=0&&range.end>range.start&&range.end-range.start<=MEDIA_ANALYZE_LIMITS.range+1e-6))fail(`media.analyze range is {start, end} in seconds of one video, at most ${MEDIA_ANALYZE_LIMITS.range} seconds apart`);
   const many=Array.isArray(request.media);
-  return {inputs:{media:port(kind==='video'?'video':many?'image[]':'image','Media to analyze')},outputs:{result:port('json','Visual evidence')},capability:{media:{$input:'media'},question:request.question,...(request.detail?{detail:request.detail}:{}),output:'result'},input:{media:many?list:list[0]}};
+  return {inputs:{media:port(kind==='video'?'video':many?'image[]':'image','Media to analyze'),...(range?{start:port('number','Start of the range, in seconds'),end:port('number','End of the range, in seconds')}:{})},outputs:{result:port('json','Visual evidence')},capability:{media:{$input:'media'},question:request.question,...(range?{range:{start:{$input:'start'},end:{$input:'end'}}}:{}),...(request.detail?{detail:request.detail}:{}),output:'result'},input:{media:many?list:list[0],...(range?{start:range.start,end:range.end}:{})}};
  },
  'web.fetch':request=>{
   if(!text(request.url,2048)||!text(request.instruction,4000))fail('web.fetch needs a url and an instruction');
@@ -105,6 +112,7 @@ export function isModuleHostedPackage(content){
   const input=content.tests?.[0]?.input||{},request={};
   // The request: the capability's own fields, each input reference replaced by the call's value.
   for(const [key,value] of Object.entries(content.capability))if(!['schemaVersion','operation','output'].includes(key))request[key]=plain(value)&&typeof value.$input==='string'?input[value.$input]:value;
+  if(plain(request.range))request.range={start:input[request.range.start?.$input],end:input[request.range.end?.$input]};
   if(Number.isFinite(request.settings?.durationSec))request.durationSec=request.settings.durationSec;
   if(Array.isArray(request.image)){request.images=request.image;delete request.image;}
   const source={id:manifest.id.slice(0,-'.hosted'.length),version:manifest.version,name:manifest.name.slice(0,-suffix.length),license:manifest.license,...(manifest.provenance?{provenance:manifest.provenance}:{}),permissions:{capabilities:[operation]}};

package/packages/block-sdk/platform-checks.js

@@ -88,7 +88,7 @@ export function assessPlatformCapture(capture) {
   if(!capture.frames?.length || !capture.frames.some(frame=>frame.controls>0) || capture.frames.some(frame=>frame.interface==='guest') && !capture.frames.some(frame=>frame.interface==='guest' && frame.controls>0))return {passed:false,message:'The preview did not expose usable controls.'};
   if(capture.interactionPassed!==true)return {passed:null,message:'Configure an input, perform the main action, and inspect the output with touch-compatible controls.'};
   if(capture.embedded!==true)return {passed:false,message:'The UI was not checked inside the real Block or Project Type host.'};
-  if(capture.continuityPassed===false)return {passed:false,message:'Editing state or completed output changed after resizing, rotating, or toggling a panel.'};
+  if(capture.continuityPassed===false)return {passed:false,message:`Editing state or completed output changed after resizing, rotating, or toggling a panel.${capture.continuityChanges?.length?` Changed: ${capture.continuityChanges.join(', ')}.`:''}`};
   if(capture.continuityPassed!==true)return {passed:null,message:'Resize and panel continuity still needs an interaction check.'};
   const states=capture.states||{};
   for(const state of ['empty','populated','loading','error','success','long-labels','enlarged-text'])if(states[state]!==true)return {passed:null,message:`The ${state} UI state still needs deterministic mobile coverage.`};

package/packages/block-sdk/semantic-relationships.js

@@ -15,6 +15,12 @@ export const STANDARD_SEMANTIC_RELATIONSHIPS=Object.freeze([
   Object.freeze({name:'legacy.timeline.updatededitor',parents:Object.freeze(['timeline'])}),
   // A narration is audio that can be transcribed.
   Object.freeze({name:'narration_audio',parents:Object.freeze(['source_audio'])}),
+  // Generated, edited and rendered videos are videos to work from, as generated and processed images are images
+  // (November 1, 2026: a new Block taking any video a Step hands on had no meaning that accepts them all).
+  Object.freeze({name:'generated_video',parents:Object.freeze(['source_video'])}),
+  Object.freeze({name:'edited_video',parents:Object.freeze(['source_video'])}),
+  Object.freeze({name:'rendered_video',parents:Object.freeze(['source_video'])}),
+  Object.freeze({name:'rendered_audio',parents:Object.freeze(['source_audio'])}),
 ]);
 
 const parents=new Map(STANDARD_SEMANTIC_RELATIONSHIPS.map(entry=>[entry.name,entry.parents]));

package/packages/block-sdk/testing.js

@@ -36,9 +36,11 @@ function fixtureExpectedMessage(outputs,fixture,error){
 // (assetId local-written-file-N, versionId, url, bytes) that no model can predict. A module fixture compares it by
 // shape: an expected {kind, mimeType, name}, with those fields left out or given, matches when kind, mimeType and name
 // match. Every other value is compared exactly.
-const WRITTEN_KINDS=['file','image','video','audio'],HOST_MADE=['assetId','versionId','url','bytes'];
+// A written file a Block passes on in an asset output carries kind 'asset' and matches the same way (November 1, 2026:
+// a sermon clips Block's JSON in its asset[] output failed every test on the stand-in assetId).
+const WRITTEN_KINDS=['file','image','video','audio'],SHAPE_KINDS=[...WRITTEN_KINDS,'asset'],HOST_MADE=['assetId','versionId','url','bytes'];
 const standInWritten=value=>plain(value)&&/^local-written-(?:file|image|video|audio)-\d+$/.test(String(value.assetId));
-const writtenShape=value=>plain(value)&&WRITTEN_KINDS.includes(value.kind)&&typeof value.mimeType==='string'&&Object.keys(value).every(key=>['kind','mimeType','name',...HOST_MADE].includes(key));
+const writtenShape=value=>plain(value)&&SHAPE_KINDS.includes(value.kind)&&typeof value.mimeType==='string'&&Object.keys(value).every(key=>['kind','mimeType','name',...HOST_MADE].includes(key));
 // expected, with each reference that matches a stand-in-written output by shape replaced by that output.
 function matchWritten(actual,expected){
  if(standInWritten(actual))return writtenShape(expected)&&['kind','mimeType','name'].every(key=>expected[key]===actual[key])?actual:expected;
@@ -50,7 +52,7 @@ function matchWritten(actual,expected){
 // for the host-made fields it leaves out.
 function withStandInHostFields(outputs,expected){
  if(!plain(outputs)||!plain(expected))return expected;
- const fill=(value,type)=>type.endsWith('[]')?(Array.isArray(value)?value.map(item=>fill(item,type.slice(0,-2))):value):WRITTEN_KINDS.includes(type)&&value?.kind===type&&writtenShape(value)?{assetId:`local-written-${type}-1`,versionId:'v1',...value}:value;
+ const fill=(value,type)=>type.endsWith('[]')?(Array.isArray(value)?value.map(item=>fill(item,type.slice(0,-2))):value):writtenShape(value)&&(WRITTEN_KINDS.includes(type)&&value.kind===type||type==='asset'&&value.kind==='asset')?{assetId:`local-written-${WRITTEN_KINDS.includes(type)?type:'file'}-1`,versionId:'v1',...value}:value;
  return Object.fromEntries(Object.entries(expected).map(([name,value])=>[name,Object.hasOwn(outputs,name)?fill(value,String(outputs[name]?.type)):value]));
 }
 export function validatePackage(pkg) {

package/packages/block-sdk/view-design.js

@@ -27,7 +27,7 @@ export const BLOCK_KIT_CLASSES=Object.freeze({
 // The design principles for every Block interface, in priority order.
 export const BLOCK_INTERFACE_PRINCIPLES=Object.freeze([
  'Function first: unless the person asks for a design direction, build from the Block kit (`sm-block`, `sm-stage`, `sm-choices`, `sm-actions`, `sm-more`) and ship little or no CSS of your own. A direction the person names wins over the kit.',
- 'Show the thing being made: the preview, media or result gets the largest area (`sm-stage`). Never a JSON dump, source editor, manifest or diagnostic panel unless the task is about source.',
+ 'Show the thing being made: the preview, media or result gets the largest area (`sm-stage`). A picture or clip the Block makes fills it in its own shape, as large as fits; several fill it as a grid, each big enough to watch. Small tiles are for the files a person gives the Block, never for what it makes. Never a JSON dump, source editor, manifest or diagnostic panel unless the task is about source.',
  'One obvious next action (`sm-primary`); peers are quiet buttons or named icons. Seven or fewer choices in view.',
  'The action button names what it does ("Write", "Generate image", "Make video"), never "Run", "Run step", "Submit" or "Review cost". Show no credit numbers: StillMade puts the price beside the verb on its own run button ("Write · 1 credit"), with a chip for the model, quality or count when they can change. Pressing it runs at that price; a confirmation appears only when the server price is higher.',
  'Pictures over words: choices people see or hear are thumbnails, swatches, samples or glyphs (`sm-choices`), not word lists. Icons carry an accessible name and tooltip; never emoji.',