stillmade-sdk 0.1.42 → 0.1.43

package/packages/block-sdk/first-party-packages.js

@@ -1,22 +1,5 @@
-import shortFormFinishV100 from '../../blocks/short-form-finish/versions/1.0.0/package.js';
-import shortFormFinishV101 from '../../blocks/short-form-finish/versions/1.0.1/package.js';
-import shortFormFinishV102 from '../../blocks/short-form-finish/versions/1.0.2/package.js';
-import shortFormFinish from '../../blocks/short-form-finish/package.js';
-import screenRecorderV100 from '../../blocks/screen-recorder/versions/1.0.0/package.js';
-import screenRecorder from '../../blocks/screen-recorder/package.js';
-import narrationV100 from '../../blocks/narration/versions/1.0.0/package.js';
-import narration from '../../blocks/narration/package.js';
-import occasionStoryV100 from '../../blocks/occasion-story/versions/1.0.0/package.js';
-import releaseVisualsV100 from '../../blocks/release-visuals/versions/1.0.0/package.js';
-import occasionStoryV101 from '../../blocks/occasion-story/versions/1.0.1/package.js';
-import releaseVisualsV101 from '../../blocks/release-visuals/versions/1.0.1/package.js';
-import occasionStory from '../../blocks/occasion-story/package.js';
-import releaseVisuals from '../../blocks/release-visuals/package.js';
+import generate from '../../blocks/generate/package.js';
 import importMedia from '../../blocks/native/sm.import-media/versions/2.0.0/package.js';
-import photoReelComposerV100 from '../../blocks/photo-reel-composer/versions/1.0.0/package.js';
-import photoReelComposerV101 from '../../blocks/photo-reel-composer/versions/1.0.1/package.js';
-import photoReelComposer from '../../blocks/photo-reel-composer/versions/1.0.2/package.js';
-import productAdVariants from '../../blocks/product-ad-variants/versions/1.0.0/package.js';
 import importMediaV201 from '../../blocks/native/sm.import-media/versions/2.0.1/package.js';
 import importMediaV202 from '../../blocks/native/sm.import-media/versions/2.0.2/package.js';
 import editorV229 from '../../blocks/native/sm.editor/versions/2.2.9/package.js';
@@ -34,9 +17,6 @@ import gradeV202 from '../../blocks/native/sm.grade/versions/2.0.2/package.js';
 import compare from '../../blocks/native/sm.compare/versions/2.0.0/package.js';
 import compareV201 from '../../blocks/native/sm.compare/versions/2.0.1/package.js';
 import compareV202 from '../../blocks/native/sm.compare/versions/2.0.2/package.js';
-import qualityAuditV102 from '../../blocks/native/sm.quality-audit/versions/1.0.2/package.js';
-import stockSearch from '../../blocks/native/sm.stock-search/versions/2.0.0/package.js';
-import youtubePublication from '../../blocks/native/sm.youtube/versions/2.0.0/package.js';
 import exportVideo from '../../blocks/native/sm.export-video/versions/2.0.0/package.js';
 import exportVideoV210 from '../../blocks/native/sm.export-video/versions/2.1.0/package.js';
 import exportAudio from '../../blocks/native/sm.export-audio/versions/2.0.0/package.js';
@@ -44,14 +24,10 @@ import motionGraphics from '../../blocks/native/sm.motion-graphics/versions/2.0.
 import audioScore from '../../blocks/native/sm.score/versions/2.0.0/package.js';
 import generateImage from '../../blocks/native/sm.generate-image/versions/2.0.0/package.js';
 import generateImageV210 from '../../blocks/native/sm.generate-image/versions/2.1.0/package.js';
-import thumbnail from '../../blocks/native/sm.thumbnail/versions/2.0.0/package.js';
-import thumbnailV201 from '../../blocks/native/sm.thumbnail/versions/2.0.1/package.js';
 import writeSummary from '../../blocks/native/sm.write-summary/versions/1.0.0/package.js';
 import automationWhen from '../../blocks/native/sm.when/versions/1.0.0/package.js';
 import automationV110 from '../../blocks/native/sm.when/versions/1.1.0/package.js';
-import automationNewItems from '../../blocks/native/sm.new-items/versions/1.0.0/package.js';
 import automationAiDecide from '../../blocks/native/sm.ai-decide/versions/1.0.0/package.js';
-import automationContinueIf from '../../blocks/native/sm.continue-if/versions/1.0.0/package.js';
 import connectApp from '../../blocks/native/sm.connect-app/versions/1.0.0/package.js';
 import automationAiWrite from '../../blocks/native/sm.ai-write/versions/1.0.0/package.js';
 import automationMetaCreative from '../../blocks/native/sm.meta-creative/versions/1.0.0/package.js';
@@ -64,35 +40,16 @@ import voiceoverV213 from '../../blocks/native/sm.voiceover/versions/2.1.3/packa
 import voiceoverV214 from '../../blocks/native/sm.voiceover/versions/2.1.4/package.js';
 import voiceoverV215 from '../../blocks/native/sm.voiceover/versions/2.1.5/package.js';
 import voiceoverV216 from '../../blocks/native/sm.voiceover/versions/2.1.6/package.js';
-import script from '../../blocks/native/sm.script/versions/2.0.0/package.js';
-import scriptV210 from '../../blocks/native/sm.script/versions/2.1.0/package.js';
-import scriptV211 from '../../blocks/native/sm.script/versions/2.1.1/package.js';
-import scriptV212 from '../../blocks/native/sm.script/versions/2.1.2/package.js';
-import scriptV213 from '../../blocks/native/sm.script/versions/2.1.3/package.js';
-import scriptV214 from '../../blocks/native/sm.script/versions/2.1.4/package.js';
-import scriptV215 from '../../blocks/native/sm.script/versions/2.1.5/package.js';
 import generateVideo from '../../blocks/native/sm.generate-video/versions/2.0.0/package.js';
 import generateVideoV201 from '../../blocks/native/sm.generate-video/versions/2.0.1/package.js';
-import chat from '../../blocks/native/sm.chat/versions/2.0.0/package.js';
-import chatV201 from '../../blocks/native/sm.chat/versions/2.0.1/package.js';
-import chatV202 from '../../blocks/native/sm.chat/versions/2.0.2/package.js';
-import chatV203 from '../../blocks/native/sm.chat/versions/2.0.3/package.js';
 import character from '../../blocks/native/sm.character/versions/2.0.0/package.js';
 import characterV201 from '../../blocks/native/sm.character/versions/2.0.1/package.js';
 import location from '../../blocks/native/sm.location/versions/2.0.0/package.js';
 import locationV201 from '../../blocks/native/sm.location/versions/2.0.1/package.js';
 import style from '../../blocks/native/sm.style/versions/2.0.0/package.js';
 import styleV201 from '../../blocks/native/sm.style/versions/2.0.1/package.js';
-import research from '../../blocks/native/sm.research/versions/2.0.0/package.js';
-import researchV201 from '../../blocks/native/sm.research/versions/2.0.1/package.js';
-import researchV202 from '../../blocks/native/sm.research/versions/2.0.2/package.js';
-import imageEditor from '../../blocks/native/sm.image-editor/versions/2.0.0/package.js';
-import imageEditorV201 from '../../blocks/native/sm.image-editor/versions/2.0.1/package.js';
-import describeMedia from '../../blocks/native/sm.describe-media/versions/2.0.0/package.js';
-import describeMediaV201 from '../../blocks/native/sm.describe-media/versions/2.0.1/package.js';
 // October 29, 2026: StillMade credits stopped paying for image.describe on September 13, so Describe media 2.1.0
 // and Photo notes 1.1.0 run on media.analyze (credits, per image); the image.describe releases stay for exact pins.
-import describeMediaV210 from '../../blocks/native/sm.describe-media/versions/2.1.0/package.js';
 import videoAssets from '../../blocks/native/sm.video-assets/versions/2.0.0/package.js';
 import videoAssetsV210 from '../../blocks/native/sm.video-assets/versions/2.1.0/package.js';
 import videoAssetsV211 from '../../blocks/native/sm.video-assets/versions/2.1.1/package.js';
@@ -108,31 +65,9 @@ import finalEditV202 from '../../blocks/native/sm.final-edit/versions/2.0.2/pack
 import editAssistant from '../../blocks/native/sm.edit-assistant/versions/2.0.0/package.js';
 import editAssistantV201 from '../../blocks/native/sm.edit-assistant/versions/2.0.1/package.js';
 import editAssistantV202 from '../../blocks/native/sm.edit-assistant/versions/2.0.2/package.js';
-import transcribe from '../../blocks/native/sm.transcribe/versions/2.0.0/package.js';
-import transcribeV201 from '../../blocks/native/sm.transcribe/versions/2.0.1/package.js';
-import blueprint from '../../blocks/native/sm.blueprint/versions/2.0.0/package.js';
-import blueprintV210 from '../../blocks/native/sm.blueprint/versions/2.1.0/package.js';
-import blueprintV211 from '../../blocks/native/sm.blueprint/versions/2.1.1/package.js';
-import blueprintV212 from '../../blocks/native/sm.blueprint/versions/2.1.2/package.js';
-import blueprintV213 from '../../blocks/native/sm.blueprint/versions/2.1.3/package.js';
-import blueprintV214 from '../../blocks/native/sm.blueprint/versions/2.1.4/package.js';
-import blueprintV215 from '../../blocks/native/sm.blueprint/versions/2.1.5/package.js';
-import blueprintV216 from '../../blocks/native/sm.blueprint/versions/2.1.6/package.js';
-import blueprintV218 from '../../blocks/native/sm.blueprint/versions/2.1.8/package.js';
-import blueprintV219 from '../../blocks/native/sm.blueprint/versions/2.1.9/package.js';
-import blueprintV217 from '../../blocks/native/sm.blueprint/versions/2.1.7/package.js';
-import shotPlan from '../../blocks/native/sm.shot-plan/versions/2.0.0/package.js';
-import shotPlanV210 from '../../blocks/native/sm.shot-plan/versions/2.1.0/package.js';
-import shotPlanV211 from '../../blocks/native/sm.shot-plan/versions/2.1.1/package.js';
-import shotPlanV212 from '../../blocks/native/sm.shot-plan/versions/2.1.2/package.js';
-import shotPlanV213 from '../../blocks/native/sm.shot-plan/versions/2.1.3/package.js';
-import shotPlanV220 from '../../blocks/native/sm.shot-plan/versions/2.2.0/package.js';
-import shotPlanV221 from '../../blocks/native/sm.shot-plan/versions/2.2.1/package.js';
 import boardEditor from '../../blocks/native/sm.board-editor/versions/2.0.0/package.js';
 import panelStripV200 from '../../blocks/native/sm.panel-strip/versions/2.0.0/package.js';
 import panelStrip from '../../blocks/native/sm.panel-strip/versions/2.1.0/package.js';
-import animatedSceneV200 from '../../blocks/native/sm.animated-scene/versions/2.0.0/package.js';
-import animatedScene from '../../blocks/native/sm.animated-scene/versions/2.1.0/package.js';
 import editor from '../../blocks/native/sm.editor/versions/2.0.0/package.js';
 import pipelineV200 from '../../blocks/native/sm.pipeline/versions/2.0.0/package.js';
 import pipeline from '../../blocks/native/sm.pipeline/versions/2.1.0/package.js';
@@ -143,11 +78,6 @@ import pipelineV225 from '../../blocks/native/sm.pipeline/versions/2.2.5/package
 import pipelineV226 from '../../blocks/native/sm.pipeline/versions/2.2.6/package.js';
 import pipelineV224 from '../../blocks/native/sm.pipeline/versions/2.2.4/package.js';
 import pipelineV222 from '../../blocks/native/sm.pipeline/versions/2.2.2/package.js';
-import shotPlanAssistant from '../../blocks/native/sm.shot-plan-assistant/versions/1.0.0/package.js';
-import animatedSceneAssistant from '../../blocks/native/sm.animated-scene-assistant/versions/1.0.0/package.js';
-import whiteboardAssistant from '../../blocks/native/sm.whiteboard-assistant/versions/1.0.0/package.js';
-import qualityAudit from '../../blocks/native/sm.quality-audit/versions/1.0.0/package.js';
-import qualityAuditV101 from '../../blocks/native/sm.quality-audit/versions/1.0.1/package.js';
 import editorV210 from '../../blocks/native/sm.editor/versions/2.1.0/package.js';
 import editorV220 from '../../blocks/native/sm.editor/versions/2.2.0/package.js';
 import editorV221 from '../../blocks/native/sm.editor/versions/2.2.1/package.js';
@@ -183,24 +113,12 @@ import boardEditorV228 from '../../blocks/native/sm.board-editor/versions/2.2.8/
 import boardEditorV229 from '../../blocks/native/sm.board-editor/versions/2.2.9/package.js';
 import boardEditorV2210 from '../../blocks/native/sm.board-editor/versions/2.2.10/package.js';
 import boardEditorV2211 from '../../blocks/native/sm.board-editor/versions/2.2.11/package.js';
-import animatedSceneV220 from '../../blocks/native/sm.animated-scene/versions/2.2.0/package.js';
-import animatedSceneV230 from '../../blocks/native/sm.animated-scene/versions/2.3.0/package.js';
-import animatedSceneV231 from '../../blocks/native/sm.animated-scene/versions/2.3.1/package.js';
-import animatedSceneV232 from '../../blocks/native/sm.animated-scene/versions/2.3.2/package.js';
-import animatedSceneV233 from '../../blocks/native/sm.animated-scene/versions/2.3.3/package.js';
-import animatedSceneV234 from '../../blocks/native/sm.animated-scene/versions/2.3.4/package.js';
-import animatedSceneV235 from '../../blocks/native/sm.animated-scene/versions/2.3.5/package.js';
-import animatedSceneV236 from '../../blocks/native/sm.animated-scene/versions/2.3.6/package.js';
-import animatedSceneV237 from '../../blocks/native/sm.animated-scene/versions/2.3.7/package.js';
-import animatedSceneV238 from '../../blocks/native/sm.animated-scene/versions/2.3.8/package.js';
-import animatedSceneV239 from '../../blocks/native/sm.animated-scene/versions/2.3.9/package.js';
-import blueprintAssistant from '../../blocks/native/sm.blueprint-assistant/versions/1.0.0/package.js';
+
 import photoNotes from '../../blocks/native/sm.photo-notes/versions/1.0.0/package.js';
 import photoNotesV110 from '../../blocks/native/sm.photo-notes/versions/1.1.0/package.js';
-import pickPhotos from '../../blocks/native/sm.pick-photos/versions/1.0.0/package.js';
 
 // Exact, independently executable first-party releases. Host workspaces do not
 // belong here. Changing implementation requires a new immutable version.
 const freeze=value=>{if(value&&typeof value==='object'&&!Object.isFrozen(value)){Object.values(value).forEach(freeze);Object.freeze(value);}return value;};
-export const FIRST_PARTY_SDK_PACKAGES = Object.freeze([freeze(productAdVariants),freeze(pickPhotos),freeze(photoNotesV110),freeze(photoNotes),freeze(youtubePublication),freeze(stockSearch),freeze(exportVideoV210),freeze(exportVideo),freeze(exportAudio),freeze(motionGraphics),freeze(audioScore),freeze(shortFormFinish),freeze(screenRecorder),freeze(screenRecorderV100),freeze(narration),freeze(narrationV100),freeze(shortFormFinishV102),freeze(shortFormFinishV101),freeze(shortFormFinishV100),freeze(occasionStory),freeze(occasionStoryV101),freeze(occasionStoryV100),freeze(releaseVisuals),freeze(releaseVisualsV101),freeze(releaseVisualsV100),freeze(photoReelComposer),freeze(photoReelComposerV101),freeze(photoReelComposerV100),freeze(importMediaV202),freeze(importMediaV201),freeze(editorV2212),freeze(editorV2211),freeze(editorV2210),freeze(editorV229),freeze(editorV228),freeze(panelStripV242),freeze(panelStripV241),freeze(panelStripV240),freeze(panelStripV237),freeze(panelStripV236),freeze(boardEditorV2211),freeze(boardEditorV2210),freeze(boardEditorV229),freeze(animatedSceneV239),freeze(animatedSceneV238),freeze(animatedSceneV237),freeze(pipelineV226),freeze(pipelineV225),freeze(pipelineV224),freeze(blueprintV219),freeze(blueprintV218),freeze(videoAssetsV214),freeze(videoAssetsV213),freeze(chatV203),freeze(chatV202),freeze(chatV201),freeze(shotPlanV221),freeze(shotPlanV220),freeze(shotPlanV213),freeze(shotPlanV212),freeze(voiceoverV216),freeze(voiceoverV215),freeze(voiceoverV214),freeze(voiceoverV213),freeze(scriptV215),freeze(scriptV214),freeze(scriptV213),freeze(roughCutV202),freeze(roughCutV201),freeze(finalEditV202),freeze(finalEditV201),freeze(editAssistantV202),freeze(editAssistantV201),freeze(gradeV202),freeze(gradeV201),freeze(transitionV202),freeze(transitionV201),freeze(qualityAuditV102),freeze(qualityAuditV101),freeze(compareV202),freeze(compareV201),freeze(compare),freeze(grade),freeze(transition),freeze(exportTimeline),freeze(captions),freeze(importMedia),freeze(generateImageV210),freeze(generateImage),freeze(thumbnailV201),freeze(thumbnail),freeze(writeSummary),freeze(automationV110),freeze(automationWhen),freeze(automationNewItems),freeze(automationAiDecide),freeze(automationContinueIf),freeze(connectApp),freeze(automationContactFields),freeze(automationAiWrite),freeze(automationMetaCreative),freeze(voiceover),freeze(voiceoverV210),freeze(voiceoverV211),freeze(voiceoverV212),freeze(script),freeze(scriptV210),freeze(scriptV211),freeze(scriptV212),freeze(generateVideoV201),freeze(generateVideo),freeze(chat),freeze(characterV201),freeze(character),freeze(locationV201),freeze(location),freeze(styleV201),freeze(style),freeze(researchV202),freeze(researchV201),freeze(research),freeze(imageEditorV201),freeze(imageEditor),freeze(describeMediaV210),freeze(describeMediaV201),freeze(describeMedia),freeze(videoAssets),freeze(videoAssetsV210),freeze(videoAssetsV211),freeze(videoAssetsV212),freeze(roughCut),freeze(finalEdit),freeze(editAssistant),freeze(transcribeV201),freeze(transcribe),freeze(blueprint),freeze(blueprintV210),freeze(blueprintV211),freeze(blueprintV212),freeze(blueprintV213),freeze(blueprintV214),freeze(blueprintV215),freeze(blueprintV216),freeze(blueprintV217),freeze(shotPlan),freeze(shotPlanV210),freeze(shotPlanV211),freeze(boardEditor),freeze(boardEditorV210),freeze(boardEditorV220),freeze(boardEditorV221),freeze(boardEditorV222),freeze(boardEditorV223),freeze(boardEditorV224),freeze(boardEditorV225),freeze(boardEditorV226),freeze(boardEditorV227),freeze(boardEditorV228),freeze(panelStripV200),freeze(panelStrip),freeze(panelStripV220),freeze(panelStripV230),freeze(panelStripV231),freeze(panelStripV232),freeze(panelStripV233),freeze(panelStripV234),freeze(panelStripV235),freeze(animatedSceneV200),freeze(animatedScene),freeze(animatedSceneV220),freeze(animatedSceneV230),freeze(animatedSceneV231),freeze(animatedSceneV232),freeze(animatedSceneV233),freeze(animatedSceneV234),freeze(animatedSceneV235),freeze(animatedSceneV236),freeze(editor),freeze(editorV210),freeze(editorV220),freeze(editorV221),freeze(editorV222),freeze(editorV223),freeze(editorV224),freeze(editorV225),freeze(editorV226),freeze(editorV227),freeze(pipelineV200),freeze(pipeline),freeze(pipelineV220),freeze(pipelineV221),freeze(pipelineV223),freeze(pipelineV222),freeze(shotPlanAssistant),freeze(animatedSceneAssistant),freeze(blueprintAssistant),freeze(whiteboardAssistant),freeze(qualityAudit)]);
+export const FIRST_PARTY_SDK_PACKAGES = Object.freeze([freeze(generate),freeze(photoNotesV110),freeze(photoNotes),freeze(exportVideoV210),freeze(exportVideo),freeze(exportAudio),freeze(motionGraphics),freeze(audioScore),freeze(importMediaV202),freeze(importMediaV201),freeze(editorV2212),freeze(editorV2211),freeze(editorV2210),freeze(editorV229),freeze(editorV228),freeze(panelStripV242),freeze(panelStripV241),freeze(panelStripV240),freeze(panelStripV237),freeze(panelStripV236),freeze(boardEditorV2211),freeze(boardEditorV2210),freeze(boardEditorV229),freeze(pipelineV226),freeze(pipelineV225),freeze(pipelineV224),freeze(videoAssetsV214),freeze(videoAssetsV213),freeze(voiceoverV216),freeze(voiceoverV215),freeze(voiceoverV214),freeze(voiceoverV213),freeze(roughCutV202),freeze(roughCutV201),freeze(finalEditV202),freeze(finalEditV201),freeze(editAssistantV202),freeze(editAssistantV201),freeze(gradeV202),freeze(gradeV201),freeze(transitionV202),freeze(transitionV201),freeze(compareV202),freeze(compareV201),freeze(compare),freeze(grade),freeze(transition),freeze(exportTimeline),freeze(captions),freeze(importMedia),freeze(generateImageV210),freeze(generateImage),freeze(writeSummary),freeze(automationV110),freeze(automationWhen),freeze(automationAiDecide),freeze(connectApp),freeze(automationContactFields),freeze(automationAiWrite),freeze(automationMetaCreative),freeze(voiceover),freeze(voiceoverV210),freeze(voiceoverV211),freeze(voiceoverV212),freeze(generateVideoV201),freeze(generateVideo),freeze(characterV201),freeze(character),freeze(locationV201),freeze(location),freeze(styleV201),freeze(style),freeze(videoAssets),freeze(videoAssetsV210),freeze(videoAssetsV211),freeze(videoAssetsV212),freeze(roughCut),freeze(finalEdit),freeze(editAssistant),freeze(boardEditor),freeze(boardEditorV210),freeze(boardEditorV220),freeze(boardEditorV221),freeze(boardEditorV222),freeze(boardEditorV223),freeze(boardEditorV224),freeze(boardEditorV225),freeze(boardEditorV226),freeze(boardEditorV227),freeze(boardEditorV228),freeze(panelStripV200),freeze(panelStrip),freeze(panelStripV220),freeze(panelStripV230),freeze(panelStripV231),freeze(panelStripV232),freeze(panelStripV233),freeze(panelStripV234),freeze(panelStripV235),freeze(editor),freeze(editorV210),freeze(editorV220),freeze(editorV221),freeze(editorV222),freeze(editorV223),freeze(editorV224),freeze(editorV225),freeze(editorV226),freeze(editorV227),freeze(pipelineV200),freeze(pipeline),freeze(pipelineV220),freeze(pipelineV221),freeze(pipelineV223),freeze(pipelineV222) ]);
 export const firstPartySdkPackage = manifest => FIRST_PARTY_SDK_PACKAGES.find(pkg => pkg.manifest.id === manifest?.id && pkg.manifest.version === manifest?.version);

package/packages/block-sdk/generation-catalog.js

@@ -64,10 +64,22 @@ export function imageSettings(value,{strict=false}={}){
  return {model,aspectRatio:axis('aspectRatio',entry.aspectRatios,entry.aspectRatios.includes('1:1')?'1:1':undefined),resolution:axis('resolution',entry.resolutions),quality:axis('quality',entry.qualities,entry.qualities.includes('medium')?'medium':undefined)};
 }
 
-/** Fill and check video settings, including Veo's 1080p-is-8-seconds rule. */
-export function videoSettings(value,{strict=false,firstFrame=false}={}){
+// November 3, 2026: a listing Block asked for a 9:16 clip and named no model, and the default (Vidu Q3 Turbo) takes no
+// aspect ratio. With no model named, a shape the default cannot make picks the cheapest model here that makes it and
+// takes the frames and the duration asked (prices in server/services/tiers.js); a named model is always kept.
+export const VIDEO_SHAPE_MODELS=Object.freeze(['wan-2.6-flash','veo-3.1-lite','seedance-2.0-mini','kling-v3-turbo','seedance-2.0-fast','seedance-2.0']);
+function defaultVideoModel(raw,{firstFrame,lastFrame}){
+ const shape=raw.aspectRatio;
+ if(shape===undefined||shape===DEFAULT_SETTING||shape==='auto'||VIDEO_GENERATION_MODELS[DEFAULT_VIDEO_MODEL].aspectRatios.includes(shape))return DEFAULT_VIDEO_MODEL;
+ const fits=entry=>entry.aspectRatios.includes(shape)&&(firstFrame||!entry.requiresFirstFrame)&&(!lastFrame||entry.lastFrame)&&(raw.duration===undefined||entry.durations.includes(raw.duration));
+ return VIDEO_SHAPE_MODELS.find(model=>fits(VIDEO_GENERATION_MODELS[model]))??DEFAULT_VIDEO_MODEL;
+}
+
+/** Fill and check video settings, including Veo's 1080p-is-8-seconds rule. With no model named, the default model is
+ * the one that makes the asked aspect ratio (VIDEO_SHAPE_MODELS). */
+export function videoSettings(value,{strict=false,firstFrame=false,lastFrame=false}={}){
  const raw=settingsObject(value,VIDEO_SETTING_KEYS,'Video');
- const model=raw.model??DEFAULT_VIDEO_MODEL,entry=VIDEO_GENERATION_MODELS[model];
+ const model=raw.model??defaultVideoModel(raw,{firstFrame,lastFrame}),entry=VIDEO_GENERATION_MODELS[model];
  assert(entry,'CAPABILITY_SETTINGS',`Choose a video model from: ${Object.keys(VIDEO_GENERATION_MODELS).join(', ')}`);
  const axis=(name,allowed,fallback)=>{
   const chosen=pick(allowed,raw[name],fallback);

package/packages/block-sdk/index.d.ts

@@ -278,7 +278,8 @@ export const GENERATION_LIMITS: Readonly<{references:8;negativePrompt:2000;seed:
 /** Fill and check image settings; `strict` rejects values the model does not accept. */
 export function imageSettings(value?:Partial<ImageSettings>,options?:{strict?:boolean}):ImageSettings;
 /** Fill and check video settings, including Veo's 1080p-is-8-seconds rule. */
-export function videoSettings(value?:Partial<VideoSettings>,options?:{strict?:boolean;firstFrame?:boolean}):VideoSettings;
+/** With no model named, the default is the cheapest model that makes the asked aspect ratio and takes the frames given. */
+export function videoSettings(value?:Partial<VideoSettings>,options?:{strict?:boolean;firstFrame?:boolean;lastFrame?:boolean}):VideoSettings;
 export function validateSeed(seed:number):number;
 export const MEDIA_GENERATE_LIMITS: Readonly<{items:50;prompt:4000}>;
 export const MEDIA_GENERATE_OPERATIONS: readonly ['image','video','speech','music','sfx'];

package/packages/block-sdk/media-analysis-example.js

@@ -4,7 +4,7 @@ import {EXAMPLE_PROVENANCE} from './example-license.js';
 export const mediaAnalysis={
  manifest:{schemaVersion:1,sdkVersion:'0.1.0',id:'example.check-clip',action:{label:'Check clip',running:'Checking clip…'},version:'1.0.0',name:'Check a clip',description:'Answer a production question about a saved video clip, with timestamps.',kind:'task',runtime:'capability',entry:'src/capability.json',license:'MIT',provenance:EXAMPLE_PROVENANCE,
   inputs:{clip:{type:'video',primary:true,semantic:'source_video',required:true,description:'Saved video to check.'},start:{type:'number',required:false,min:0,semantic:'range_start',description:'Optional start of the range to look at closely, in seconds.'},end:{type:'number',required:false,min:0,semantic:'range_end',description:'Optional end of the range, in seconds (at most 12 seconds after the start).'}},
-  outputs:{report:{type:'json',primary:true,semantic:'media_findings',description:'Summary, timeline, on-screen text and issues found.'}},
+  outputs:{report:{type:'json',primary:true,semantic:'media_findings',description:'Summary, timeline, on-screen text and issues found.',schema:{items:'json[]'}}},
   permissions:{project:[],capabilities:['media.analyze'],network:[],filesystem:[],secrets:[]},ui:[{control:'asset',port:'clip'},{control:'number',port:'start'},{control:'number',port:'end'}]},
  capability:{schemaVersion:1,operation:'media.analyze',media:{$input:'clip'},question:'Is the product logo clearly visible, and when? List any on-screen text and visible defects.',range:{start:{$input:'start'},end:{$input:'end'}},output:'report'},
  tests:[{name:'A saved clip',input:{clip:{kind:'video',assetId:'clip-1',versionId:'v1',url:'/api/media/owner/clip.mp4'}},expectations:{report:{kind:'json',includes:['summary']}}}],

package/packages/block-sdk/mock-host.js

@@ -13,6 +13,7 @@ import {createMemoryStorage,storageKey} from './cloud-storage.js';
 import {mediaTransformRequest,decodeWav} from './media-transform.js';
 import {FILE_FORMATS} from './data-values.js';
 import {mockPng,mockWav,mockMp4,MOCK_IMAGE_SIZE,MOCK_VIDEO_SIZE} from './mock-media.js';
+import {videoSettings,audioSettings} from './generation-catalog.js';
 // The words of a simple PDF whose pages are uncompressed text, such as the example lesson.pdf, page by page; null for
 // anything else. StillMade reads real PDFs on the person's device; a local test of another PDF mocks document.text
 // (November 1, 2026: the stand-in read a PDF's own code as its words).
@@ -201,7 +202,12 @@ export function createMockHost({mocks:given={},readLocalFile,manifest,pickedMedi
    const operation=action?.operation;
    if(recorded('actions',operation)){note('actions.run',operation,'mocks');return pick(mocks.actions[operation],count(`action:${operation}`));}
    note('actions.run',operation,'recorded');
-   if(operation==='media.generate')return {value:action.request.items.map(item=>{const made=reference[item.operation==='image'||item.operation==='video'?item.operation:'audio']();return {key:item.key,kind:made.kind,assetId:made.assetId,versionId:made.versionId,url:made.url};}),failures:[]};
+   // As in StillMade: a video, music or sound effect carries the length it asked for; speech carries none (decode it).
+   if(operation==='media.generate')return {value:action.request.items.map(item=>{
+    const seconds=item.operation==='video'?videoSettings(item.settings,{firstFrame:item.firstFrame!==undefined,lastFrame:item.lastFrame!==undefined}).duration:['music','sfx'].includes(item.operation)?audioSettings(item.operation,item.settings).durationSec:undefined;
+    const made=item.operation==='image'||item.operation==='video'?reference[item.operation]():reference.audio(seconds?{seconds,sampleRate:8000}:undefined);
+    return {key:item.key,kind:made.kind,assetId:made.assetId,versionId:made.versionId,url:made.url,...(Number.isFinite(seconds)?{duration:seconds}:{})};
+   }),failures:[]};
    if(operation==='stock.search')return {results:[]};
    fail(`There is no recorded stand-in for the ${operation} action. Add one under actions["${operation}"] in ${MOCKS_FILE}.`);
   },

package/packages/block-sdk/module-host-calls.js

@@ -4,20 +4,45 @@
 import {networkDeclarations,networkRequest,connectionDeclarations,connectionCall} from './network.js';
 import {storageHostHandlers} from './cloud-storage.js';
 import {projectReadSnapshot} from './context.js';
+import {mediaReferences,moduleMediaAccess,MEDIA_RESULT_OPERATIONS} from './module-media-access.js';
 
-/** {api: args => Promise} for one run of `pkg` against `host` (see createNodeModuleExecutor). */
-export function moduleHostCalls(pkg,host,storage){
+/**
+ * {api: args => Promise} for one run of `pkg` against `host` (see createNodeModuleExecutor). `input` is the run's input:
+ * files, transforms, actions, hosted calls and asset changes use only files the run received or the host made in it,
+ * the rule StillMade's own host applies (module-media-access.js).
+ */
+export function moduleHostCalls(pkg,host,storage,input){
+ const access=moduleMediaAccess(input);
+ const made=async pending=>access.remember(await pending);
  return {
-  'files.read':args=>host.readFile?host.readFile(args.ref):Promise.reject(Object.assign(new Error('files.read needs a host file reader in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'})),
-  'files.write':args=>host.writeFile?host.writeFile(args.buffer,args.options):Promise.reject(Object.assign(new Error('files.write saves to the StillMade library; pass a host writer in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'})),
-  'media.transform':args=>host.transformMedia?host.transformMedia(args.request):Promise.reject(Object.assign(new Error('Media transforms run in StillMade; pass a host transformMedia in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'})),
-  'actions.run':args=>host.runAction?host.runAction(args.action):Promise.reject(Object.assign(new Error('Actions run in StillMade.'),{code:'MODULE_HOST_UNAVAILABLE'})),
-  'hosted.run':args=>host.runHosted?host.runHosted(args.operation,args.request):Promise.reject(Object.assign(new Error('Hosted operations run in StillMade.'),{code:'MODULE_HOST_UNAVAILABLE'})),
+  'files.read':async args=>{access.checkFile(args.ref,'files.read reads');return host.readFile?host.readFile(args.ref):Promise.reject(Object.assign(new Error('files.read needs a host file reader in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'}));},
+  'files.write':args=>host.writeFile?made(host.writeFile(args.buffer,args.options)):Promise.reject(Object.assign(new Error('files.write saves to the StillMade library; pass a host writer in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'})),
+  'media.transform':async args=>{access.check(args.request,'Media transforms');return host.transformMedia?made(host.transformMedia(args.request)):Promise.reject(Object.assign(new Error('Media transforms run in StillMade; pass a host transformMedia in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'}));},
+  'actions.run':async args=>{
+   access.check(args.action,'Actions');
+   if(!host.runAction)throw Object.assign(new Error('Actions run in StillMade.'),{code:'MODULE_HOST_UNAVAILABLE'});
+   const result=await host.runAction(args.action);
+   if(args.action?.operation==='media.generate')for(const ref of mediaReferences(result?.value))access.remember(ref);
+   return result;
+  },
+  'hosted.run':async args=>{
+   access.check(args.request,'Hosted operations');
+   if(!host.runHosted)throw Object.assign(new Error('Hosted operations run in StillMade.'),{code:'MODULE_HOST_UNAVAILABLE'});
+   const result=await host.runHosted(args.operation,args.request);
+   return MEDIA_RESULT_OPERATIONS.includes(args.operation)?access.remember(result):result;
+  },
   'connections.call':async args=>{const request=connectionCall(args.request,connectionDeclarations(pkg.manifest.permissions?.connections));return host.callConnection?host.callConnection(request):Promise.reject(Object.assign(new Error('Connections run through StillMade, which adds your account; pass a host callConnection in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'}));},
   ...storageHostHandlers(storage),
-  'project.read':async args=>{if(!host.project)throw Object.assign(new Error('project.read needs a project snapshot; pass host.project in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'});return projectReadSnapshot(pkg.manifest,host.project,args.fields);},
-  'assets.create':async args=>{if(!(pkg.manifest.permissions?.project||[]).includes('asset.create'))throw Object.assign(new Error('Declare asset.create to add project assets.'),{code:'MODULE_PERMISSION'});return host.createAsset?host.createAsset(args.file,args.options||{}):Promise.reject(Object.assign(new Error('Project assets are saved in StillMade; pass a host createAsset in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'}));},
-  'assets.appendVersion':async args=>{if(!(pkg.manifest.permissions?.project||[]).includes('asset.version.append'))throw Object.assign(new Error('Declare asset.version.append to add asset versions.'),{code:'MODULE_PERMISSION'});return host.appendAssetVersion?host.appendAssetVersion(args.asset,args.file):Promise.reject(Object.assign(new Error('Project assets are saved in StillMade; pass a host appendAssetVersion in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'}));},
+  // Only the host-built media indexes make media usable, as in StillMade: free-form documents can hold media-shaped values.
+  'project.read':async args=>{
+   if(!host.project)throw Object.assign(new Error('project.read needs a project snapshot; pass host.project in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'});
+   const snapshot=projectReadSnapshot(pkg.manifest,host.project,args.fields);
+   for(const field of ['assets','files'])for(const ref of mediaReferences(snapshot[field]))access.add(ref);
+   for(const shot of Array.isArray(snapshot.shots)?snapshot.shots:[])if(shot?.selectedImage)access.remember(shot.selectedImage);
+   return snapshot;
+  },
+  'assets.create':async args=>{if(!(pkg.manifest.permissions?.project||[]).includes('asset.create'))throw Object.assign(new Error('Declare asset.create to add project assets.'),{code:'MODULE_PERMISSION'});access.checkFile(args.file,'assets.create adds');return host.createAsset?made(host.createAsset(args.file,args.options||{})):Promise.reject(Object.assign(new Error('Project assets are saved in StillMade; pass a host createAsset in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'}));},
+  'assets.appendVersion':async args=>{if(!(pkg.manifest.permissions?.project||[]).includes('asset.version.append'))throw Object.assign(new Error('Declare asset.version.append to add asset versions.'),{code:'MODULE_PERMISSION'});access.checkFile(args.file,'assets.appendVersion adds');return host.appendAssetVersion?made(host.appendAssetVersion(args.asset,args.file)):Promise.reject(Object.assign(new Error('Project assets are saved in StillMade; pass a host appendAssetVersion in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'}));},
   'net.fetch':async args=>{const request=networkRequest(args.request,networkDeclarations(pkg.manifest.permissions?.network));return host.netFetch?host.netFetch(request):Promise.reject(Object.assign(new Error('Network calls run through StillMade, which adds your key; pass a host netFetch in local runs.'),{code:'MODULE_HOST_UNAVAILABLE'}));},
  };
 }

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

@@ -5,7 +5,7 @@
 // operation in `permissions.capabilities`.
 import {assert,plain,stableStringify} from './contracts.js';
 import {defaultCapabilityExpectations,MEDIA_ANALYZE_LIMITS} from './capabilities.js';
-import {GENERATION_LIMITS,IMAGE_GENERATION_MODELS} from './generation-catalog.js';
+import {GENERATION_LIMITS,IMAGE_GENERATION_MODELS,VIDEO_GENERATION_MODELS} from './generation-catalog.js';
 
 const text=(value,max)=>typeof value==='string'&&value.trim().length>0&&value.length<=max;
 const media=(value,kind)=>plain(value)&&value.kind===kind&&['assetId','versionId','url'].every(key=>typeof value[key]==='string'&&value[key].trim());
@@ -32,7 +32,20 @@ const SHAPES={
  },
  'video.generate':request=>{
   if(!text(request.prompt,32000))fail('video.generate needs a prompt');
-  return {inputs:{prompt:port('text','Video prompt')},outputs:{result:port('video','Generated video')},capability:{prompt:{$input:'prompt'},output:'result',...(request.settings?{settings:request.settings}:{})},input:{prompt:request.prompt}};
+  // firstFrame and lastFrame: saved images the video starts and ends on, bound as a capability Block binds them; and the
+  // negativePrompt (November 3, 2026: they were dropped, so a listing video's camera move over each photo was made from
+  // the words alone, and the stand-in host passed it).
+  const {firstFrame,lastFrame,negativePrompt}=request;
+  for(const [name,frame] of [['firstFrame',firstFrame],['lastFrame',lastFrame]])if(frame!==undefined&&!media(frame,'image'))fail(`video.generate ${name} is one saved image`);
+  if(lastFrame!==undefined&&firstFrame===undefined)fail('video.generate lastFrame needs a firstFrame');
+  if(negativePrompt!==undefined&&!(typeof negativePrompt==='string'&&negativePrompt.length<=GENERATION_LIMITS.negativePrompt))fail(`video.generate negativePrompt is text of at most ${GENERATION_LIMITS.negativePrompt.toLocaleString('en-US')} characters`);
+  // A model named in settings must take those frames (every model takes a first frame; Kling 3.0 Turbo and Wan 2.6 Flash
+  // take no last frame; Wan 2.6 Flash and Wan 2.7 need a first frame).
+  const model=VIDEO_GENERATION_MODELS[request.settings?.model];
+  if(model&&firstFrame&&!model.firstFrame)fail(`${model.label} takes no first frame: choose a model that does, or leave the model to the person`);
+  if(model&&lastFrame&&!model.lastFrame)fail(`${model.label} takes no last frame: choose a model that does, or leave the model to the person`);
+  if(model?.requiresFirstFrame&&!firstFrame)fail(`${model.label} needs a firstFrame`);
+  return {inputs:{prompt:port('text','Video prompt'),...(firstFrame?{firstFrame:port('image','First frame')}:{}),...(lastFrame?{lastFrame:port('image','Last frame')}:{})},outputs:{result:port('video','Generated video')},capability:{prompt:{$input:'prompt'},output:'result',...(firstFrame?{firstFrame:{$input:'firstFrame'}}:{}),...(lastFrame?{lastFrame:{$input:'lastFrame'}}:{}),...(request.settings?{settings:request.settings}:{}),...(negativePrompt?{negativePrompt}:{})},input:{prompt:request.prompt,...(firstFrame?{firstFrame}:{}),...(lastFrame?{lastFrame}:{})}};
  },
  'audio.speech':request=>{
   if(!text(request.text,3800))fail('audio.speech needs text of up to 3,800 characters');

package/packages/block-sdk/module-media-access.js

@@ -0,0 +1,71 @@
+// Which saved files a module Block may use in one run: the references it
+// received as input, and those the host made during the run (files it wrote,
+// transform results, generated media, project media it read). files.read,
+// transforms, actions, hosted calls and project asset changes use only these.
+// StillMade's browser host (client/src/blocks/moduleRuntimeHost.js) and the
+// SDK's local runners (module-host-calls.js: `test --mock`, `ready`, `gate`,
+// and the QuickJS runner for Blocks built in StillMade) apply this one rule, so
+// a Block gets the same verdict on a creator's machine and in the import review.
+import {stableStringify} from './contracts.js';
+
+const fail=(message,code)=>Object.assign(new Error(message),{code});
+export const MODULE_MEDIA_KINDS=Object.freeze(['image','video','audio','asset','file']);
+// Hosted operations whose result is media the host generated and checked.
+export const MEDIA_RESULT_OPERATIONS=Object.freeze(['image.generate','video.generate','audio.speech','audio.music','audio.sfx']);
+// A reference names its file by these fields. Its other fields describe the
+// file (a media.generate item's key, a duration, a name) and may be dropped or
+// added (November 3, 2026: a listing video Block rebuilt each generated clip as
+// {kind, assetId, versionId, url}, without the result item's `key`, and every
+// render was refused although the clips were generated in that run).
+export const MEDIA_REFERENCE_FIELDS=Object.freeze(['kind','assetId','versionId','url']);
+const isReference=value=>MODULE_MEDIA_KINDS.includes(value.kind)&&(typeof value.url==='string'||typeof value.assetId==='string');
+
+/**
+ * Saved references in a value: anything shaped like media (a media kind with a
+ * url or assetId), at any depth. With `strict`, a value too large to inspect is
+ * refused. With `within`, the other fields of a reference are searched too, so
+ * a reference cannot carry another file past the check.
+ */
+export function mediaReferences(input,{strict=false,within=false}={}){
+ const found=[];let visited=0;
+ const visit=(value,depth)=>{
+  if(!value||typeof value!=='object'||value instanceof ArrayBuffer||ArrayBuffer.isView(value))return;
+  if(++visited>20000||depth>16){if(strict)throw fail('This request is too large or too deeply nested to check.','MODULE_HOST');return;}
+  if(Array.isArray(value)){for(const item of value)visit(item,depth+1);return;}
+  if(isReference(value)){
+   found.push(value);
+   if(within)for(const [key,item] of Object.entries(value))if(!MEDIA_REFERENCE_FIELDS.includes(key))visit(item,depth+1);
+   return;
+  }
+  for(const item of Object.values(value))visit(item,depth+1);
+ };
+ visit(input,0);return found;
+}
+
+/** The file a reference names, as a comparable string. */
+export function mediaReferenceKey(ref){
+ return stableStringify(MEDIA_REFERENCE_FIELDS.map(key=>typeof ref?.[key]==='string'?ref[key]:null));
+}
+
+const RULE='this Block received, wrote or generated in this run';
+const FIX='Pass the reference the Block received as input, or the one StillMade returned in this run (files.write, a transform, hosted.run or actions.run media.generate), keeping its kind, assetId, versionId and url.';
+
+/**
+ * The run's usable files, starting from its input. `remember` adds a value the
+ * host made when the value is itself a reference (a text, JSON or web result
+ * can contain media-shaped values chosen by a model or a web page, so only
+ * references the host returned count); `add` adds a reference the host
+ * vouches for (project media it read). The checks throw MODULE_FILE_READ.
+ */
+export function moduleMediaAccess(input){
+ const usable=new Set(mediaReferences(input).map(mediaReferenceKey));
+ const allowed=ref=>!!ref&&typeof ref==='object'&&usable.has(mediaReferenceKey(ref));
+ return {
+  allowed,
+  add(ref){usable.add(mediaReferenceKey(ref));},
+  remember(value){if(value&&typeof value==='object'&&mediaReferences(value)[0]===value)usable.add(mediaReferenceKey(value));return value;},
+  // Every reference in a request, and inside its references, must be usable.
+  check(value,what){if(!mediaReferences(value,{strict:true,within:true}).every(allowed))throw fail(`${what} use only files ${RULE}. ${FIX}`,'MODULE_FILE_READ');},
+  checkFile(ref,call){if(!allowed(ref))throw fail(`${call} only files ${RULE}. ${FIX}`,'MODULE_FILE_READ');},
+ };
+}

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

@@ -43,7 +43,7 @@ export function createNodeModuleExecutor({files,host={},onProgress,onLog,now=()=
   try{declared=networkDeclarations(pkg.manifest.permissions?.network);}catch{/* no valid origins */}
   const sockets=createModuleSockets({declarations:declared,open:host.netConnect,post:(message,transfer)=>worker.postMessage(message,transfer)});
   // The shared host calls (files, media, hosted operations, connections, storage, project, assets, net.fetch) plus live connections.
-  const handlers={...sockets.handlers,...moduleHostCalls(pkg,host,storage)};
+  const handlers={...sockets.handlers,...moduleHostCalls(pkg,host,storage,input)};
   try{
    return await new Promise((resolve,reject)=>{
     const stop=error=>{clearInterval(timer);reject(error);};

package/packages/block-sdk/portable-media-actions.js

@@ -37,7 +37,7 @@ export function mediaGenerateRequest(request){
    if(item.references!==undefined)assert(Array.isArray(item.references)&&item.references.length>0&&item.references.length<=Math.min(GENERATION_LIMITS.references,IMAGE_GENERATION_MODELS[settings.model].references)&&item.references.every(asset),'PORTABLE_ACTION',`${IMAGE_GENERATION_MODELS[settings.model].label} accepts up to ${IMAGE_GENERATION_MODELS[settings.model].references} saved reference images.`);
   }else{
    assert(item.references===undefined,'PORTABLE_ACTION','References apply to image items; use firstFrame and lastFrame for video.');
-   const settings=videoSettings(item.settings,{strict:true,firstFrame:item.firstFrame!==undefined}),entry=VIDEO_GENERATION_MODELS[settings.model];
+   const settings=videoSettings(item.settings,{strict:true,firstFrame:item.firstFrame!==undefined,lastFrame:item.lastFrame!==undefined}),entry=VIDEO_GENERATION_MODELS[settings.model];
    if(item.firstFrame!==undefined)assert(entry.firstFrame&&asset(item.firstFrame),'PORTABLE_ACTION',`${entry.label} needs a saved image as its first frame.`);
    if(item.lastFrame!==undefined)assert(entry.lastFrame&&item.firstFrame!==undefined&&asset(item.lastFrame),'PORTABLE_ACTION',`${entry.label} cannot use this last frame.`);
   }

package/packages/block-sdk/runtime.js

@@ -58,7 +58,7 @@ export async function runPackageAsync(pkg, values, options = {}) {
     // A module runs only through an injected executor: StillMade's sandboxed
     // browser Worker, or the CLI's local Node worker for the creator's own tests.
     const pinned=structuredClone(pkg),input=validateValues(pinned.manifest.inputs,values);
-    assert(typeof options.module==='function','RUNTIME_UNAVAILABLE','Module Blocks run in StillMade in the browser, or locally with the SDK CLI. They cannot run unattended: StillMade has no server sandbox for module Blocks.');
+    assert(typeof options.module==='function','RUNTIME_UNAVAILABLE','Module Blocks run in StillMade in the browser, or on your own machine with the SDK CLI (test, preview and pack for a Block or a Project Type, and ready for a Block), which passes them a local module executor; code calling the SDK directly passes options.module (createNodeModuleExecutor in module-node.js). They cannot run unattended: StillMade has no server sandbox for module Blocks.');
     const result=await executeHostCall(structuredClone(pinned),input,{signal:options.signal,execute:options.module});
     assert(!options.signal?.aborted,'CANCELLED','Run cancelled');
     assert(result&&typeof result==='object'&&Object.keys(result).every(key=>['outputs','logs'].includes(key)),'MODULE_RESULT','The module host returned an unexpected result');

package/packages/block-sdk/timeline-proposal-example.js

@@ -1,7 +1,7 @@
 import {EXAMPLE_PROVENANCE} from './example-license.js';
 
 export const timelinePolish={
- manifest:{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.',kind:'task',runtime:'capability',entry:'src/capability.json',license:'MIT',provenance:EXAMPLE_PROVENANCE,inputs:{timeline:{type:'timeline',context:'timeline',primary:true},direction:{type:'text',default:'Polish this cut conservatively.'}},outputs:{edit:{type:'timeline-edit',primary:true}},permissions:{project:['context.timeline.read','timeline.propose'],capabilities:['timeline.propose'],network:[],filesystem:[],secrets:[]},ui:[{control:'text',port:'direction'}]},
+ manifest:{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.',kind:'task',runtime:'capability',entry:'src/capability.json',license:'MIT',provenance:EXAMPLE_PROVENANCE,inputs:{timeline:{type:'timeline',context:'timeline',primary:true,required:true,semantic:'edit_timeline',description:'The cut to improve.'},direction:{type:'text',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,semantic:'timeline_edit',description:'The proposed changes to review before they apply.'}},permissions:{project:['context.timeline.read','timeline.propose'],capabilities:['timeline.propose'],network:[],filesystem:[],secrets:[]},ui:[{control:'text',port:'direction'}]},
  capability:{schemaVersion:1,operation:'timeline.propose',context:{timeline:{$input:'timeline'},direction:{$input:'direction'}},instruction:'Use only supported timeline-edit commands, exact before snapshots, and the current activeTimelineId. Preserve media and locked items. Return strict JSON only.',maxTokens:2000,output:'edit'},
  tests:[{name:'one restrained edit',input:{timeline:{schemaVersion:1,activeTimelineId:'timeline-1',tracks:[{id:'video'}],clips:[{id:'clip-1',trackId:'video',start:0,duration:4}],audioItems:[],captions:[]},direction:'Add a soft transition.'},expectations:{edit:{kind:'timeline-edit',minCommands:1,maxCommands:10}}}],
 };

package/packages/block-sdk/transcription-example.js

@@ -1,7 +1,7 @@
 import {EXAMPLE_PROVENANCE} from './example-license.js';
 
 export const audioTranscription={
- manifest:{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.',kind:'task',runtime:'capability',entry:'src/capability.json',license:'MIT',provenance:EXAMPLE_PROVENANCE,inputs:{audio:{type:'audio',primary:true},language:{type:'text',default:'auto'}},outputs:{transcript:{type:'transcript',primary:true}},permissions:{project:[],capabilities:['audio.transcribe'],network:[],filesystem:[],secrets:[]},ui:[{control:'asset',port:'audio'},{control:'select',port:'language',options:['auto','en','es','fr','de','it','pt','ja','ko','zh']}]},
+ manifest:{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.',kind:'task',runtime:'capability',entry:'src/capability.json',license:'MIT',provenance:EXAMPLE_PROVENANCE,inputs:{audio:{type:'audio',primary:true,required:true,semantic:'source_audio',description:'The recording to turn into text.'},language:{type:'text',default:'auto',required:false,semantic:'language_code',description:'auto, or a two-letter language code such as en.'}},outputs:{transcript:{type:'transcript',primary:true,semantic:'timed_transcript',description:'The spoken words with their timings.'}},permissions:{project:[],capabilities:['audio.transcribe'],network:[],filesystem:[],secrets:[]},ui:[{control:'asset',port:'audio'},{control:'select',port:'language',options:['auto','en','es','fr','de','it','pt','ja','ko','zh']}]},
  capability:{schemaVersion:1,operation:'audio.transcribe',audio:{$input:'audio'},language:{$input:'language'},output:'transcript'},
  tests:[{name:'timed speech',input:{audio:{kind:'audio',assetId:'audio-1',versionId:'version-1',url:'/api/media/example/audio.mp3',mimeType:'audio/mpeg'},language:'en'},expectations:{transcript:{kind:'transcript',minWords:1,maxWords:1000}}}]
 };

package/packages/block-sdk/video-generation-example.js

@@ -2,7 +2,7 @@ import {EXAMPLE_PROVENANCE} from './example-license.js';
 // Declarative request; the host chooses provider, model, duration, payment and
 // storage. This fixture is executed only after explicit host approval.
 export const videoGenerate={
- 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',description:'Turn a production prompt into a short video using an approved host provider.',kind:'task',runtime:'capability',entry:'src/capability.json',license:'MIT',provenance:EXAMPLE_PROVENANCE,inputs:{prompt:{type:'text',primary:true,required:true}},outputs:{video:{type:'video',primary:true}},permissions:{project:[],capabilities:['video.generate'],network:[],filesystem:[],secrets:[]},ui:[{port:'prompt',control:'text'}]},
+ 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',description:'Turn a production prompt into a short video using an approved host provider.',kind:'task',runtime:'capability',entry:'src/capability.json',license:'MIT',provenance:EXAMPLE_PROVENANCE,inputs:{prompt:{type:'text',primary: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,semantic:'generated_video',description:'The generated clip.'}},permissions:{project:[],capabilities:['video.generate'],network:[],filesystem:[],secrets:[]},ui:[{port:'prompt',control:'text'}]},
  capability:{schemaVersion:1,operation:'video.generate',prompt:{$input:'prompt'},output:'video'},
  tests:[{name:'Produces a bounded MP4 sample',input:{prompt:'A paper boat floating across a calm blue pond. Gentle camera movement.'},expectations:{video:{kind:'video',format:'mp4',minDuration:1,maxDuration:60,minBytes:32,maxBytes:67108864,minWidth:1,maxWidth:3840,minHeight:1,maxHeight:3840}}}],
 };

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

@@ -11,7 +11,10 @@ export const VIEW_BRIDGE=Object.freeze([
  // Inputs and runs
  {name:'input',group:'Inputs and runs',signature:'readonly input: Partial<In>',summary:'A copy of the current input values. Read it after `onInput` first fires.',where:all},
  {name:'onInput',group:'Inputs and runs',signature:'onInput(callback: (input: Partial<In>) => void): () => void',summary:'Receives the input when the view starts and each time the host changes it. Returns a function that stops listening. Initialize controls here.',where:all},
- {name:'run',group:'Inputs and runs',signature:'run(values: In): Promise<Out>',summary:'Checks the named input values, runs the Block (its recipe, JavaScript, module or hosted operation, after any approval the host asks for) and resolves to the checked outputs. One run at a time, 30 a minute.',where:all},
+ {name:'addFiles',group:'Inputs and runs',signature:'addFiles(port: string): Promise<{added: number}>',summary:'Opens StillMade\'s own file picker for a declared `image`, `video`, `audio`, `asset` or `file` input (or a list of them) and saves what the person chooses through StillMade\'s upload, as the Step\'s own tiles do. Call it from a click or key press in the view; a list gets the files added, a single input the first. The saved values arrive through `onInput`; the view never receives a File. A `<button class="sm-add" data-stillmade-add="port">` does this with no code. Refused for an undeclared or non-file input, an input an earlier Step fills, a viewer, and without a gesture.',where:`${saved} and the SDK preview`},
+ {name:'removeFile',group:'Inputs and runs',signature:'removeFile(port: string, index: number): Promise<{files: number}>',summary:'Removes the file at `index` (from 0) of a declared list input (`image[]`, `video[]`, `audio[]`, `asset[]` or `file[]`), as the remove button on the Step\'s own tile does, and resolves to how many files the list now holds. Call it from a click or key press in the view; the new list arrives through `onInput`. A `<button data-stillmade-remove="port" data-index="2">` does this with no code. Refused for an undeclared, non-file or single input, an input an earlier Step fills, a viewer, Chat, a file that changed since the view was given it, and without a gesture.',where:`${saved} and the SDK preview`},
+ {name:'moveFile',group:'Inputs and runs',signature:'moveFile(port: string, from: number, to: number): Promise<{files: number}>',summary:'Moves the file at `from` to the place `to` (both from 0) in a declared list input, as the Step\'s own move earlier and move later buttons do, so the person sets the order (a tour, a slideshow) on the Block\'s own screen. Same gesture and refusals as `removeFile`. A `<button data-stillmade-move="port" data-index="2" data-to="1">` does this with no code; a `data-to` past either end does nothing.',where:`${saved} and the SDK preview`},
+ {name:'run',group:'Inputs and runs',signature:'run(values: In): Promise<Out>',summary:'Checks the named input values, runs the Block (its recipe, JavaScript, module or hosted operation, after any approval the host asks for) and resolves to the checked outputs. On a project Step and in the SDK preview, inputs it leaves out run with the Step\'s current values (its photos, an earlier Step\'s result), so a view passes only what it sets; what it passes is kept as the Step\'s input. One run at a time, 30 a minute.',where:all},
  {name:'useOutput',group:'Inputs and runs',signature:'useOutput(outputs: Partial<Out>): Promise<Record<string, unknown>>',summary:'Chooses media the view already holds (input media or a desktop recording) as the Block outputs without running. Only complete references the host issued are accepted.',where:saved},
  {name:'schemaFields',group:'Inputs and runs',signature:'readonly schemaFields: Readonly<Record<string, unknown>>',summary:'Helpers that build form fields from the input ports and their schemas, honoring inputs the host locked.',where:all},
  // Shared state