stillmade-sdk 0.1.37 → 0.1.39

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/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.',
@@ -42,6 +42,7 @@ export const BLOCK_INTERFACE_PRINCIPLES=Object.freeze([
  'Status sits beside the action it describes (`sm-status`), in a few words.',
  'Keep the page in normal scroll flow; no sticky media or control strips unless the editing task needs them.',
  'Use the width: from 860px wide the kit puts the controls on the left at a reading width (300–380px) and the result (`sm-stage`) fills the right, in its real shape; under that everything stacks with the result first and the action within reach. Extra width goes to the result, never to wider text fields. Before there is a result, the stage previews what will be made from the inputs. `data-layout="stack"` opts out.',
+ 'Size with the kit, never fixed sizes: no fixed pixel widths or heights for the workspace or stage, no 100vh, no position:fixed panels. StillMade zooms a Block\'s screen to fill the space it has (up to 150%, never down to a phone layout on a computer), so a Block laid out with the kit\'s spacing fills its Step without empty space.',
  'Settings sit side by side (`sm-settings`), next to what they change. Three or four short options are one segmented row (`data-segmented`), not a row of big tiles.',
  'Lists fill the width at a small size: input files are small tiles (`sm-gallery data-size="small"`), many items are one line each (`sm-list`): a thumbnail, one line of text, a short fact. Tapping an item opens all of its fields in place. Extra width means more items per row, never bigger cards.',
  'On a phone chip and segment rows scroll sideways instead of wrapping; long lists show their first three with "N more" (`data-peek`) and long text five lines until tapped (`sm-clamp`).',
@@ -135,6 +136,58 @@ function topLevelRows(html){
  return rows;
 }
 
+// November 1, 2026 (owner, zoom plan): a screen held to a narrow width leaves most of a wide Step empty, and StillMade's
+// zoom cannot fill it (it stops before the kit's two-column layout from 860px would change). The narrowest fixed or
+// maximum width on what holds the whole screen (html, body, the outermost element, a lone wrapper inside it), from its
+// inline style or a stylesheet rule outside a small-screen @media block; null when nothing holds it.
+const KIT_TWO_COLUMNS=860;
+function narrowScreen(view){
+ const html=String(view?.html||''),lower=html.toLowerCase(),holders=[{tag:'html',classes:[],id:''},{tag:'body',classes:[],id:''}];
+ const width=declarations=>{let narrowest=null;for(const match of String(declarations).matchAll(/(?:^|[;{\s])(?:max-width|width)\s*:\s*(\d{1,5}(?:\.\d+)?)(px|rem|em)\b/gi)){const px=Number(match[1])*(match[2].toLowerCase()==='px'?1:16);if(px>=200&&px<KIT_TWO_COLUMNS)narrowest=Math.min(narrowest??Infinity,px);}return narrowest;};
+ // The outermost elements, and the children of a lone outermost one; a lone child is a wrapper too.
+ // The last '>' found is reused while it is still ahead, and attributes are read from a bounded slice, so broken tags
+ // ("<a<a<a…>") stay linear.
+ const top=[],inner=[];let depth=0,end=-1;
+ for(let at=lower.indexOf('<');at!==-1;at=lower.indexOf('<',at+1)){
+  if(end<at)end=lower.indexOf('>',at);if(end===-1)break;
+  const tag=/^<(\/?)([a-z][a-z0-9-]*)/.exec(lower.slice(at,Math.min(end+1,at+40)));
+  if(!tag)continue;
+  const [,closing,name]=tag;
+  if(closing){depth=Math.max(0,depth-1);if(depth===0&&top.length>1)break;continue;}
+  if(['script','style','template'].includes(name)){const close=lower.indexOf(`</${name}`,end);if(close===-1)break;at=close;continue;}
+  const attributes=html.slice(at,Math.min(end,at+2000)),element={tag:name,classes:(/\sclass\s*=\s*["']([^"']*)["']/i.exec(attributes)?.[1]||'').split(/\s+/).filter(Boolean),id:/\sid\s*=\s*["']([^"']*)["']/i.exec(attributes)?.[1]||'',style:/\sstyle\s*=\s*["']([^"']*)["']/i.exec(attributes)?.[1]||''};
+  if(depth===0)top.push(element);else if(depth===1&&top.length===1)inner.push(element);
+  if(!VOID_TAGS.has(name)&&lower[end-1]!=='/')depth++;
+ }
+ holders.push(...top.filter(()=>top.length===1),...(inner.length===1?inner:[]));
+ for(const element of holders.slice(2)){const px=width(element.style);if(px)return {px,where:`the style on <${element.tag}>`};}
+ const holds=selector=>{
+  const last=selector.trim().split(/[\s>+~]+/).pop().replace(/^:root$/i,'html'),parts=/^([a-z][a-z0-9-]*|\*)?((?:[.#][\w-]+)*)$/i.exec(last);
+  if(!parts||!parts[1]&&!parts[2])return false;
+  const classes=[...parts[2].matchAll(/\.([\w-]+)/g)].map(match=>match[1]),id=/#([\w-]+)/.exec(parts[2])?.[1]||'';
+  return holders.some(element=>(!parts[1]||parts[1]==='*'||parts[1].toLowerCase()===element.tag)&&classes.every(name=>element.classes.includes(name))&&(!id||id===element.id));
+ };
+ // One pass over the stylesheet, comments skipped: each rule with the @media blocks around it.
+ const css=String(view?.css||''),around=[];let prelude='',narrowest=null;
+ for(let index=0;index<css.length;index++){
+  const char=css[index];
+  if(char==='/'&&css[index+1]==='*'){const close=css.indexOf('*/',index+2);if(close===-1)break;index=close+1;continue;}
+  if(char==='{'){
+   const head=prelude.trim();prelude='';
+   if(head.startsWith('@')){around.push(head);continue;}
+   const close=css.indexOf('}',index);if(close===-1)break;
+   const smallOnly=around.some(rule=>/^@media\b/i.test(rule)&&/max-width/i.test(rule));
+   const px=!smallOnly&&head.split(',').some(holds)?width(css.slice(index+1,close)):null;
+   if(px&&(!narrowest||px<narrowest.px))narrowest={px,where:head.slice(0,60)};
+   index=close;continue;
+  }
+  if(char==='}'){around.pop();prelude='';continue;}
+  if(char===';'&&!around.length){prelude='';continue;}
+  prelude+=char;
+ }
+ return narrowest;
+}
+
 export function reviewViewDesign(view){
   if(!view)return {passed:true,issues:[],warnings:[],principles:BLOCK_INTERFACE_PRINCIPLES};
   const html=view.html||'',javascript=view.javascript||'',primary=html.replace(/<details\b[\s\S]*?<\/details>/gi,'');
@@ -157,6 +210,8 @@ export function reviewViewDesign(view){
   if(rareTool)warnings.push(`"${rareTool.slice(0,40)}" is its own section. Rare tools (update, schedule, history, reload) are named icon buttons beside the action (.sm-icon in .sm-actions), never sections under the work.`);
   const rows=topLevelRows(primary);
   if(rows>COMPACT_ROW_LIMIT)warnings.push(`The workspace has ${rows} visible rows besides the stage and may not fit one laptop screen (an estimate: this check counts rows and cannot measure height). Put short settings side by side in .sm-settings and secondary ones in a closed .sm-more.`);
+  const narrow=narrowScreen(view);
+  if(narrow)warnings.push(`The screen is held to ${Math.round(narrow.px)}px wide (${narrow.where}), so a wide Step shows mostly empty space, and StillMade's zoom cannot fill it. Drop the fixed or maximum width: the Block kit lays out the controls and the result across the width.`);
   warnings.push(...blockKitProblems(view).map(problem=>problem.message));
   return {passed:issues.length===0,issues,warnings,principles:BLOCK_INTERFACE_PRINCIPLES};
 }