stillmade-sdk 0.1.41 → 0.1.43

package/packages/block-sdk/builder-contract.js

@@ -9,7 +9,7 @@
 import {HOSTED_OPERATION_NAMES} from './contracts.js';
 
 export const BUILDER_CONTRACT_ID='stillmade.block-builder';
-export const BUILDER_CONTRACT_VERSION='1.16.0';
+export const BUILDER_CONTRACT_VERSION='1.17.0';
 export const BUILDER_CONTRACT_STAMP=`${BUILDER_CONTRACT_ID}@${BUILDER_CONTRACT_VERSION}`;
 export const BUILDER_CONTRACT_DOCS_PATH='/docs/build/block-builder-contract';
 // Block names appear in step bars, cards and pickers; new releases keep them short.
@@ -47,9 +47,11 @@ const SECTIONS=Object.freeze([
  // on module Blocks and refused a job that needs one).
  rule('runtime-choice','block',null,
   'Pick the runtime from the job. No hosted AI: a recipe or isolated `javascript`, both able to run unattended. One text, script or brief prompt returning text, script or JSON: a `capability` Block. Hosted operations on other values (a transcript, media, structured data), several hosted operations in a row, or a result shaped in code: one `module` Block, `module/main.js` calling `stillmade.hosted.run(operation, request)` for each operation in `permissions.capabilities` (MODULES.md), never one Block per operation; it runs in the person\'s browser while StillMade is open. Build a new Block in a folder with `stillmade-block create`, `test`, `ready` and `pack`, and import the file `pack` writes (a module Block writes `<id>-<version>.stillmade-module.json`) through Create, then Import Block. A `.stillmade-block` archive is only for adapting a GitHub repository.'),
+ // November 3, 2026 (owner, "Yes, one page"): a guided job is one Block on one page, its cheap check before the
+ // expensive run on that page too; a workspace (CAD, the Editor) stays its own Step, and using what it made is the next.
  rule('block-scope','both',
-  'One Step per job: start one only where a person works with the result, where finding new items turns into handling each, or where the result leaves StillMade; all else is a part.',
-  'A Step is one job: the work between two moments where a person or the outside world must see the result. Start a new Step only at one of three points; everything else is a part of the neighboring Step.\n\n1. **A person works with the result**: reads, edits, picks or approves it (a workspace Block such as a script, a Canvas or an Editor, or an approval). So Bible, Canvas and Editor are separate Steps after Chat.\n2. **Finding new things turns into handling each one**: the trigger (a schedule or an app event), the app read, its filter and "only new" are the first job; what is done with each item is the next job. A trigger is a setting of the first job, never a Step of its own.\n3. **The result leaves StillMade**: it is sent, posted, published, paid or written into another app. Consecutive writes to the same app, with the glue that shapes data for them, are one job.\n\nIn a production the Steps are the workspaces a person opens: work feeding the next workspace is its part, else it joins the one before. A Block with its own interface (a workspace, editor or picker) is always its own Step; two such Steps are never one. A video ends in the Editor (1.0), which has captions and export built in, so Export video is never a Step beside it.\n\nA part that only runs in the desktop app cannot share a Step with cloud parts. Before adding a Step, name which of the three reasons makes it separate; if none applies, make it a part of a neighbor. A Step nobody would ever open must not exist on its own. Prefer an app task\'s own filter (a Gmail query such as `has:attachment filename:png`) to an AI check, and use AI decide only for judgement.\n\nBuild one Block for a job one Block can do: a module Block calls every hosted operation the job needs (it transcribes a sermon, then finds the verses said in it), a JavaScript Block does several local transforms, a workspace owns its whole document. A Block being built never takes an ingredient\'s result only so the ingredient can be its own part or Step (Transcribe in front of a verse finder): it calls that operation itself. Parts in one Step (`groups` in the Project Type) are for jobs made of Blocks that already exist and app tasks, each keeping its own permission, approval and credit rules. Never invent a combined runtime.\n\nExamples: "every new email with an image becomes a generated image" is two Steps, "Gmail · New emails with images" (When, fetch with an image filter, only new) and "Image from email" (AI write, Generate image); listing When, Fetch, Only new, AI decide, Continue only if, AI write and Generate image as seven Steps splits one job into its parts. "A new Meta lead goes to HubSpot" is three Steps: "Meta Ads · New leads", "Qualify lead" and "HubSpot · Add contact".'),
+  'One Step per job: a guided job is one Block whose page holds the inputs, a cheap check and the result. New Steps only for a workspace (CAD, Editor; using its work is the next Step), a one-time setup, a later render, a hand-off, handling each new item, or leaving StillMade.',
+  'A Step is one job: the work between two moments where a person or the outside world must see the result. A guided job, one the person fills in and then gets a result from, is one Step with one Block whose own screen holds everything: the inputs and settings, then a cheap check before the expensive run (the script and a voice sample before the video), then the result. On a wide screen the inputs sit on the left and the result\'s place on the right; on a phone they stack, the result\'s place under the button. A cheap check or a review the person does on that screen never starts a new Step. Start a new Step only at one of these points; everything else is a part of the neighboring Step.\n\n1. **A person works with the result**: in a workspace they spend a while in (the Editor, a storyboard, a Canvas, a CAD or drawing tool), or someone else approves or takes it over (a hand-off). Turning what a workspace made into something else is the next Step: a CAD tool is its own Step, and the Block that takes pictures of its model and makes a video is the next one. So Bible, Canvas and Editor are separate Steps after Chat.\n2. **Finding new things turns into handling each one**: the trigger (a schedule or an app event), the app read, its filter and "only new" are the first job; what is done with each item is the next job. A trigger is a setting of the first job, never a Step of its own.\n3. **The result leaves StillMade**: it is sent, posted, published, paid or written into another app. Consecutive writes to the same app, with the glue that shapes data for them, are one job.\n4. **Setup or a wait**: a one-time setup that is not part of each job (a brand kit, capturing a voice or a likeness), or a render that takes minutes and is delivered later.\n\nIn a production the Steps are the workspaces a person opens: work feeding the next workspace is its part, else it joins the one before. A Block with its own interface (a workspace, editor or picker) is always its own Step; two such Steps are never one. A Type whose own Block renders the finished video (`timeline.render`) needs no Editor Step; the Editor (1.0, captions and export built in) is a Step only when the person edits the cut by hand, and Export video is never a Step beside it.\n\nA part that only runs in the desktop app cannot share a Step with cloud parts. Before adding a Step, name which of these reasons makes it separate; if none applies, make it a part of a neighbor. A Step nobody would ever open must not exist on its own. Prefer an app task\'s own filter (a Gmail query such as `has:attachment filename:png`) to an AI check, and use AI decide only for judgement.\n\nBuild one Block for a job one Block can do: a module Block calls every hosted operation the job needs (it transcribes a sermon, then finds the verses said in it), a JavaScript Block does several local transforms, a workspace owns its whole document. A Block being built never takes an ingredient\'s result only so the ingredient can be its own part or Step (Transcribe in front of a verse finder): it calls that operation itself. Parts in one Step (`groups` in the Project Type) are for jobs made of Blocks that already exist and app tasks, each keeping its own permission, approval and credit rules. Never invent a combined runtime.\n\nExamples: "a listing video from my photos and the home\'s facts" is one Step: one Block whose page takes the photos and facts, shows the script and a voice sample to check, then makes the video. "every new email with an image becomes a generated image" is two Steps, "Gmail · New emails with images" (When, fetch with an image filter, only new) and "Image from email" (AI write, Generate image); listing When, Fetch, Only new, AI decide, Continue only if, AI write and Generate image as seven Steps splits one job into its parts. "A new Meta lead goes to HubSpot" is three Steps: "Meta Ads · New leads", "Qualify lead" and "HubSpot · Add contact".'),
  rule('capability-contract','block',
   'Define the contract first: typed inputs (optional with safe defaults where possible), outputs, state, permissions, UI, failures and cancellation. Keep the interface small; keep the job whole.',
   'Translate the request into an explicit capability contract before implementation: what the Block does; each input with its type, meaning and whether it is required (prefer optional settings with safe defaults over extra required questions); each output with its type and meaning; persistent state; project context it reads; permissions; UI; long-running behavior; expected failures; cancellation; determinism; and whether it needs hosted models, media, desktop tools or shared editing. Keep the public interface as small and general as possible (few required inputs, one primary output) and keep implementation details out of it; small means a small interface, never a fragment of a job. A Block that generates images, video or speech declares only its prompt and output: every Step that runs it gets the host’s generation settings (model, quality, length and resolution, voice, speed, how many), saved with the Step, changed on its page or by Chat, and shown with their cost before each run.'),
@@ -71,30 +73,30 @@ const SECTIONS=Object.freeze([
  // November 2, 2026 (owner): a sermon Block's video input read "Video"; it should read "Drop your sermon video here".
  rule('input-words','block',
   'Name each input in the job\'s words (`sermonVideo`, not `video`): StillMade words its drop area from the name.',
-  'Name each input for what the person brings, in the job\'s words: `sermonVideo` for a sermon clip Block, `listingPhotos` for a listing, `lessonSlides` for a lesson podcast. StillMade titles the input from that name ("Sermon video") and words its drop area from it ("Drop your sermon video here", the formats, "Choose a video"), in StillMade and the SDK preview, so never draw your own upload box for an input. Keep a bare type name (`video`, `file`) only when any file of that kind does the job. The `description` says what makes a good one.'),
+  'Name each input for what the person brings, in the job\'s words: `sermonVideo` for a sermon clip Block, `listingPhotos` for a listing, `lessonSlides` for a lesson podcast. StillMade titles the input from that name ("Sermon video") and words its drop area from it ("Drop your sermon video here", the formats, "Choose a video"), in StillMade and the SDK preview, so never draw your own upload box or `<input type="file">`: a Block\'s screen shows the files as tiles and adds more with `<button class="sm-add" data-stillmade-add="listingPhotos" aria-label="Add photos">`, which opens StillMade\'s picker and upload, and a list\'s tiles drop or reorder a file with `data-stillmade-remove="listingPhotos" data-index="2"` and `data-stillmade-move="listingPhotos" data-index="2" data-to="1"` buttons; the files arrive through `onInput`. Keep a bare type name (`video`, `file`) only when any file of that kind does the job. The `description` says what makes a good one.'),
  // November 2, 2026 (owner): every screen speaks the job, as a product made only for it would, and stays quiet. The same
  // day (owner, of four tiles each saying "Only on the device it was added from"): "if it's a notification make it a
  // notification": state is one StillMade notification or nothing, never a sentence on the page or one per item.
  rule('job-words','block',
-  'Speak the job unless the person or creator asks otherwise: `manifest.action` names the button ("Plan the tour"; AI pictures, video or sound start with Generate, never "Make it"), one solid `sm-primary`, progress in the job\'s units, one line per problem, no notes on how the Block works or its state (one StillMade notification at most, never one per item), `date` inputs for days and times, plain input names so "Use a reference" fills them, posting as its own connector Step. Clear every Wording note `gate` lists.',
-  'These are StillMade\'s defaults: unless the person or the creator asked for something else, every screen speaks the job in its own words and adds nothing else. `manifest.action` names the Step\'s button, {label:"Plan the tour", running:"Planning the tour…"}, and StillMade adds the price ("Plan the tour · 1 credit"). When the Block makes a picture, video or sound with AI the label starts with Generate and says what ("Generate tour", "Generate voiceover"); one that cuts or renders the person\'s own media says Make ("Make 6 clips"); never "Make it", "Run", "Submit", "Process" or a bare "Generate". The main button stands out: one solid `sm-primary` in the kit\'s ink, never restyled to the background; everything else is `sm-quiet` or an `sm-icon`, and close is an X icon. Report progress in the job\'s units with `stillmade.progress(fraction, label)` ("Moving through the kitchen, 4 of 9 rooms"), never "Processing". Head the result in the job\'s words ("9 rooms", "Your tour · 44 s"), never "Output". Say a problem in one line with its fix beside it ("No bathroom photo. Guests look for one." and Add photo). Stay quiet: no welcome text, tips under fields, tours or banners, and at most one line of guidance on a screen, only where the next move is not obvious; anything more goes in the input\'s `description`, which StillMade shows behind an (i). Say nothing about how the Block works (where it runs, saving, syncing, recovery, accounts, credits) or where a file is kept: StillMade tells the person what they need as one short notification, or nothing; never a sentence on the page, and never the same line under each item. Every drop area offers "Use a reference", which fills the Step from the person\'s saved photos, videos and notes: media inputs fill by kind, so take `video` or `asset` where a clip works as well as a photo, and text inputs fill by plain names and labels (`productName`, `website`, `brandColors`, `fonts`, `voice`, and `details` or `notes` for the reference\'s note); never build your own reference picker. Days and times are picked, never typed: use the `date` type, which StillMade shows as a calendar, with a list of times when the input is about a time (`postAt`, `startsAt`); a custom view uses `<input type="date">` or `type="datetime-local"`. Posting is a connector Step of its own, and StillMade words its button from the app and action ("Post to Instagram"). Before handing the Block back, clear every Wording note that `gate` and readiness list, unless the person asked for those words.'),
+  'Speak the job unless the person or creator asks otherwise: `manifest.action` names the button, required whenever StillMade draws it ("Plan the tour"; AI pictures, video or sound start with Generate, never "Make it"), one solid `sm-primary`, progress in the job\'s units, one line per problem, no notes on how the Block works or its state (one StillMade notification at most, never one per item), `date` inputs for days and times, plain input names so "Use a reference" fills them, posting as its own connector Step. Clear every Wording note `gate` lists.',
+  'These are StillMade\'s defaults: unless the person or the creator asked for something else, every screen speaks the job in its own words and adds nothing else. `manifest.action` names the Step\'s button, {label:"Plan the tour", running:"Planning the tour…"}, and StillMade adds the price ("Plan the tour · 1 credit"). Every Block whose Step shows StillMade\'s button declares it: any Block without its own screen, and any that calls operations. Without it StillMade can only guess from the Block\'s name or output ("Make clips"), and the readiness gate and StillMade\'s own builder send the Block back until it names the job. When the Block makes a picture, video or sound with AI the label starts with Generate and says what ("Generate tour", "Generate voiceover"); one that cuts or renders the person\'s own media says Make ("Make 6 clips"); never "Make it", "Run", "Submit", "Process" or a bare "Generate". The main button stands out: one solid `sm-primary` in the kit\'s ink, never restyled to the background; everything else is `sm-quiet` or an `sm-icon`, and close is an X icon. Report progress in the job\'s units with `stillmade.progress(fraction, label)` ("Moving through the kitchen, 4 of 9 rooms"), never "Processing". Head the result in the job\'s words ("9 rooms", "Your tour · 44 s"), never "Output". Say a problem in one line with its fix beside it ("No bathroom photo. Guests look for one." and Add photo). Stay quiet: no welcome text, tips under fields, tours or banners, and at most one line of guidance on a screen, only where the next move is not obvious; anything more goes in the input\'s `description`, which StillMade shows behind an (i). Say nothing about how the Block works (where it runs, saving, syncing, recovery, accounts, credits) or where a file is kept: StillMade tells the person what they need as one short notification, or nothing; never a sentence on the page, and never the same line under each item. Every drop area offers "Use a reference", which fills the Step from the person\'s saved photos, videos and notes: media inputs fill by kind, so take `video` or `asset` where a clip works as well as a photo, and text inputs fill by plain names and labels (`productName`, `website`, `brandColors`, `fonts`, `voice`, and `details` or `notes` for the reference\'s note); never build your own reference picker. Days and times are picked, never typed: use the `date` type, which StillMade shows as a calendar, with a list of times when the input is about a time (`postAt`, `startsAt`); a custom view uses `<input type="date">` or `type="datetime-local"`. Posting is a connector Step of its own, and StillMade words its button from the app and action ("Post to Instagram"). Before handing the Block back, clear every Wording note that `gate` and readiness list, unless the person asked for those words.'),
  // November 2, 2026 (owner): StillMade centers and zooms a screen; an app that lays itself out (a CAD tool) opts out with
  // data-stillmade-layout="own" and keeps its own layout and Ctrl/Cmd +/- keys. The same day (owner: "implement A absolutely
  // universally, like in app, platform, sdk, just everywhere"): every <video controls> gets StillMade's player and result
  // pictures its full-screen button; a video without controls stays the Block's own. Also that day (owner: "there is no
  // separation and I cannot tell what is going on"): a pick is the kit's ink fill, and media that cannot show is a quiet tile.
  rule('ui','block',
-  'Prefer `manifest.ui`; custom views use the Block kit (`sm-*`) unless a look is named. Pictures over words: preview each option before choosing; few words, fold the rest; buttons carry `data-stillmade-action`; the start button names the action (never "Run" or "Make it") and shows no price (StillMade adds it). A job fits one screen unscrolled and a 320px phone; an app (editor, configurator, CAD tool) works like that app: full canvas, panels, tools, undo, never a form. An app puts `data-stillmade-layout="own"` on its root: StillMade never centers or zooms it. `<video controls>` gets StillMade\'s player; leave out `controls` when the Block drives playback. A pick keeps the kit\'s ink fill; media that cannot show is a wordless `sm-media-off` tile.',
-  'If the capability needs UI, use the Block UI SDK: generated `manifest.ui` controls first; a sandboxed custom view (`view.html`/`view.css`/`view.js`) only when the core interaction needs one. Build custom views from the Block kit the host injects (`block-kit.css`): the result in `sm-stage`, picks as pictures in `sm-choices`, the picked one in the kit\'s ink fill (never restyled to an outline, a tint or the page\'s background) so it reads at a glance, one solid `sm-primary` naming the action in the job\'s words ("Plan the tour", "Generate voiceover"; never "Run" or "Make it") and no price (StillMade\'s run button adds it), extras in a closed `sm-more`; a look the person names wins. Fit one laptop screen without scrolling: label beside control, status in a few words, files as tiles, rare tools as icons, (i) on unclear controls. These compact rules are for a job or an ingredient. Size the view to the Block\'s tier (block-tier.js): an app, a workspace a person works in for a while (video editor, 3D configurator, CAD or drawing tool), looks and works like that kind of app instead of a compact page: its canvas or stage fills the view, with the panels, toolbars, inspector or timeline such an app has, direct manipulation (select, drag, zoom), keyboard shortcuts and undo; it keeps the host appearance and Block kit controls, its panels may scroll, and on a phone its tools fold into sheets while the canvas stays usable. Never shrink an app into a form of fields and one button. StillMade centers a standard view narrower than its Step and zooms a view to fill its space; an app that lays itself out (full-size canvas or WebGL, its own scroll, pan or zoom, its own Ctrl/Cmd +/- keys) puts `data-stillmade-layout="own"` on its outermost element, and StillMade then never centers, zooms or takes those keys. StillMade draws one player for every `<video controls>` (play, timeline, time, sound and full screen, shown while the pointer is on the video, with keys and touch) and a full-screen button on result pictures in `sm-stage` or `sm-gallery` and on any element marked `data-stillmade-expand` (the same value makes one set of pictures, `off` removes it); `data-stillmade-player="native"` keeps the browser\'s controls, and a `<video>` without `controls` is the Block\'s own and is never touched. A picture or clip that cannot show here (kept on another device, or it did not open) keeps its place as a quiet `sm-media-off` tile in its own shape with the `image-off` glyph and the reason in its label, never words in its place. Drop words nobody needs; put helpful ones in a closed `sm-hint`. Mark each button `data-stillmade-action="what it does"` and label each field: Chat presses and fills them. Expose the capability, not the implementation: sensible defaults, previews, progress, clear errors, visible outputs. Show no raw JSON, internal IDs, filesystem details, provider terms or developer settings unless the Block is a developer tool. When a person chooses among options they need to hear or see (voices, music, fonts, looks, templates, images), let them preview each option before choosing: a sample or thumbnail from the Block\'s own files or the host\'s free samples, never a paid generation. Skip previews only when there is nothing to preview. Choices StillMade owns (voices, models in the run review) already show samples. Follow the host appearance (Light, Dark and White) and one elastic layout: stacked on a 320px phone with no sideways scroll (result first, action pinned), and from 860px the controls left (≤380px), the result filling the right. Short settings sit side by side, each label beside its control (`sm-field`, `sm-settings`; three or four short options as one `data-segmented` row); many items are one line each (`sm-list`) that open in place; input files are small tiles (`sm-gallery data-size="small"`); on a phone chip rows scroll sideways and long lists show three. Compacting moves controls, never deletes them.'),
+  'Prefer `manifest.ui`; custom views use the Block kit (`sm-*`) unless a look is named. Pictures over words: preview each option before choosing; few words, fold the rest; buttons carry `data-stillmade-action`; the start button names the action (never "Run" or "Make it") and shows no price (StillMade adds it). A job fits one screen unscrolled and a 320px phone; an app (editor, configurator, CAD tool) works like that app: full canvas, panels, tools, undo, never a form. An app puts `data-stillmade-layout="own"` on its root: StillMade never centers or zooms it. `<video controls>` gets StillMade\'s player; leave out `controls` when the Block drives playback. A pick keeps the kit\'s ink fill; media that cannot show is a wordless `sm-media-off` tile. Every part shows at once: the result\'s place is drawn before the first run in its own shape and size, so nothing pops in; on wide screens inputs sit left and the result right; on phones they stack, the result under the button.',
+  'If the capability needs UI, use the Block UI SDK: generated `manifest.ui` controls first; a sandboxed custom view (`view.html`/`view.css`/`view.js`) only when the core interaction needs one. Build custom views from the Block kit the host injects (`block-kit.css`): the result in `sm-stage`, drawn before the first run in the shape and size of what is coming (`data-ratio="9:16"` for a vertical clip, lines for text, a player bar for sound) so every part of the screen is in place at once and the result fills a place the person already sees instead of popping in somewhere unexpected; StillMade draws it the same way on the Steps it draws; on a wide screen what goes in sits on the left and the result on the right, side by side, and they stack only on narrow screens and phones, the result\'s place under the button, picks as pictures in `sm-choices`, the picked one in the kit\'s ink fill (never restyled to an outline, a tint or the page\'s background) so it reads at a glance, one solid `sm-primary` naming the action in the job\'s words ("Plan the tour", "Generate voiceover"; never "Run" or "Make it") and no price (StillMade\'s run button adds it), extras in a closed `sm-more`; a look the person names wins. Fit one laptop screen without scrolling: label beside control, status in a few words, files as tiles, rare tools as icons, (i) on unclear controls. These compact rules are for a job or an ingredient. Size the view to the Block\'s tier (block-tier.js): an app, a workspace a person works in for a while (video editor, 3D configurator, CAD or drawing tool), looks and works like that kind of app instead of a compact page: its canvas or stage fills the view, with the panels, toolbars, inspector or timeline such an app has, direct manipulation (select, drag, zoom), keyboard shortcuts and undo; it keeps the host appearance and Block kit controls, its panels may scroll, and on a phone its tools fold into sheets while the canvas stays usable. Never shrink an app into a form of fields and one button. StillMade centers a standard view narrower than its Step and zooms a view to fill its space; an app that lays itself out (full-size canvas or WebGL, its own scroll, pan or zoom, its own Ctrl/Cmd +/- keys) puts `data-stillmade-layout="own"` on its outermost element, and StillMade then never centers, zooms or takes those keys. StillMade draws one player for every `<video controls>` (play, timeline, time, sound and full screen, shown while the pointer is on the video, with keys and touch) and a full-screen button on result pictures in `sm-stage` or `sm-gallery` and on any element marked `data-stillmade-expand` (the same value makes one set of pictures, `off` removes it); `data-stillmade-player="native"` keeps the browser\'s controls, and a `<video>` without `controls` is the Block\'s own and is never touched. A picture or clip that cannot show here (kept on another device, or it did not open) keeps its place as a quiet `sm-media-off` tile in its own shape with the `image-off` glyph and the reason in its label, never words in its place. Drop words nobody needs; put helpful ones in a closed `sm-hint`. Mark each button `data-stillmade-action` (`run` on the one that runs the Block, which the device checks press once; a page that checks first keeps `run` on that button for both presses; what it does on the others, `"play sample"`) and label each field: Chat presses and fills them. Expose the capability, not the implementation: sensible defaults, previews, progress, clear errors, visible outputs. Show no raw JSON, internal IDs, filesystem details, provider terms or developer settings unless the Block is a developer tool. When a person chooses among options they need to hear or see (voices, music, fonts, looks, templates, images), let them preview each option before choosing: a sample or thumbnail from the Block\'s own files or the host\'s free samples, never a paid generation. Skip previews only when there is nothing to preview. Choices StillMade owns (voices, models in the run review) already show samples. Follow the host appearance (Light, Dark and White) and one elastic layout: stacked on a 320px phone with no sideways scroll (the inputs, the button in normal flow, never pinned, then the result\'s place under it), and from 860px the controls left (≤380px), the result filling the right. Short settings sit side by side, each label beside its control (`sm-field`, `sm-settings`; three or four short options as one `data-segmented` row); many items are one line each (`sm-list`) that open in place; input files are small tiles (`sm-gallery data-size="small"`); on a phone chip rows scroll sideways and long lists show three. Compacting moves controls, never deletes them.'),
  rule('multiplayer','block',
   'Custom views share edits: `StillMade.onShared`, publish every editable field (`data-stillmade-share`, `bindShared`, `updateShared`), respect `canEdit`, never re-run on remote updates.',
   'Projects are multiplayer. A custom view subscribes through `StillMade.onShared(callback)` and publishes every editable field: give static controls a unique `id` and `data-stillmade-share="field"` (the host owns their synchronization), use `StillMade.bindShared(field, elementId)` for controls created dynamically, and `StillMade.updateShared(values, before, options)` for structured values; private variables and DOM values are not shared. Mark a truly device-only control (playback, hover, device selection) with `data-stillmade-local`. Observe shared outputs as well as state, honor `canEdit` in every mutating callback (read-only participants cannot write), never run, click or call a paid integration in response to a remote update, and preserve conflicting drafts. Shared background work uses `sharedWork` with the `work.shared` permission.'),
  rule('external-services','block',
   'External services only via hosted operations or `connection.execute`; the host owns providers, keys, BYOK, credits and consent.',
-  'Reach external services only through StillMade\'s hosted operations, the connections service (`connection.execute`), or, in a module Block, `stillmade.net.fetch` to origins declared in `permissions.network` (with the key each needs), `stillmade.net.connect` for a live WebSocket to one of them, and `stillmade.connections.call` to adapters or catalog apps in `permissions.connections`; never put keys in code, inputs or headers: StillMade adds each person\'s own key on its servers. The host owns the model and provider choice, BYOK keys, StillMade credits, spending consent, authorization, token refresh, rate limits, retries and provider errors; a Block never receives a secret and never names a provider unless it must. Treat provider unavailability, timeout, cancellation and partial failure as typed outcomes the Block reports, not crashes. Generated images, video, voices, music and sound effects come from hosted operations or the `media.generate` action, paid with the user\'s StillMade credits at StillMade\'s prices; for structured model output declare a `json` output with `capability.schema` instead of parsing prose. When a Block needs npm libraries, WebAssembly (threaded: `"threads": true` in module.json) or heavy compute, use `runtime: "module"` and reach hosted operations through `stillmade.hosted.run` with the operations listed in `permissions.capabilities`. Decode, cut, join, re-encode, extract or normalise audio and video with `stillmade.media.transform` on the device; never ask for a server render. For a rich interactive interface (React or another framework, SVG, canvas, drag), use a frame view: `src/view.config.json` with `{"runtime":"frame"}` and `src/view.js` bundled as one IIFE, colored with StillMade\'s theme variables. For files and structured data use the `file`, `document`, `table`, `url`, `date` and `color` types and their generated controls and presentations, not JSON text.'),
+  'Reach external services only through StillMade\'s hosted operations, the connections service (`connection.execute`), or, in a module Block, `stillmade.net.fetch` to origins declared in `permissions.network` (with the key each needs), `stillmade.net.connect` for a live WebSocket to one of them, and `stillmade.connections.call` to adapters or catalog apps in `permissions.connections`; never put keys in code, inputs or headers: StillMade adds each person\'s own key on its servers. The host owns the model and provider choice, BYOK keys, StillMade credits, spending consent, authorization, token refresh, rate limits, retries and provider errors; a Block never receives a secret and never names a provider unless it must. Treat provider unavailability, timeout, cancellation and partial failure as outcomes the Block reports, not crashes: a call the result needs throws and fails the run (see Useful failures); an optional part\'s failure is caught, given its fallback and named in an optional `notes` text output. Generated images, video, voices, music and sound effects come from hosted operations or the `media.generate` action, paid with the user\'s StillMade credits at StillMade\'s prices; for structured model output declare a `json` output with `capability.schema` instead of parsing prose. When a Block needs npm libraries, WebAssembly (threaded: `"threads": true` in module.json) or heavy compute, use `runtime: "module"` and reach hosted operations through `stillmade.hosted.run` with the operations listed in `permissions.capabilities`. Decode, cut, join, re-encode, extract or normalise audio and video with `stillmade.media.transform` on the device; never ask for a server render. For a rich interactive interface (React or another framework, SVG, canvas, drag), use a frame view: `src/view.config.json` with `{"runtime":"frame"}` and `src/view.js` bundled as one IIFE, colored with StillMade\'s theme variables. For files and structured data use the `file`, `document`, `table`, `url`, `date` and `color` types and their generated controls and presentations, not JSON text.'),
  rule('dependencies','block',
-  'No npm or system dependencies; inline small licensed code and record its license and notice in the manifest.',
-  'A Block must declare everything it requires and must not assume anything is installed. Portable packages carry no package dependencies (`portable.dependencies` is empty): inline small, license-compatible code and record its license and notice in `manifest.license` and `manifest.provenance`. Desktop-only tools are reached solely through declared desktop permissions and the host desktop bridge. If a dependency cannot be delivered through the Block runtime, report the incompatibility instead of assuming the user\'s machine has it.'),
+  'No npm or system dependencies; inline small licensed code and record its license and notice in the manifest; the person is the copyright holder.',
+  'A Block must declare everything it requires and must not assume anything is installed. Portable packages carry no package dependencies (`portable.dependencies` is empty): inline small, license-compatible code and record its license and notice in `manifest.license` and `manifest.provenance`. The copyright holder in the Block\'s own `provenance.notice` is the person it is made for: replace the placeholder `create` writes with their name, never StillMade, the SDK or yourself. Desktop-only tools are reached solely through declared desktop permissions and the host desktop bridge. If a dependency cannot be delivered through the Block runtime, report the incompatibility instead of assuming the user\'s machine has it.'),
  rule('security','both',
   'Treat inputs, files and responses as untrusted; request minimum permissions; never leak secrets in outputs, state, errors or UI.',
   'Treat Block code, external data, files, repositories, model output and network responses as untrusted. Request the minimum permissions and capabilities; `stillmade-block permissions --fix` declares exactly what the source uses. Do not weaken the sandbox (QuickJS has no fetch, DOM, timers, modules or Node APIs). Validate and bound every value crossing a boundary. Never expose secrets through logs, outputs, project context, UI, error messages or serialized state.'),

package/packages/block-sdk/capabilities.js

@@ -187,7 +187,7 @@ export function validateCapability(capability,manifest){
   assert(frames.length<2||capability.firstFrame.$input!==capability.lastFrame.$input,'CAPABILITY_BINDING','Use different image inputs for the first and last frame');
   assert(!own(capability,'lastFrame')||own(capability,'firstFrame'),'CAPABILITY_BINDING','A last frame needs a first frame');
   assert(Object.values(manifest.inputs).filter(port=>port.type==='image').length===frames.length,'CAPABILITY_BINDING','Bind every image input as the first or last frame');
-  if(own(capability,'settings')){const settings=videoSettings(capability.settings,{strict:true,firstFrame:own(capability,'firstFrame')});const entry=VIDEO_GENERATION_MODELS[settings.model];assert(!own(capability,'lastFrame')||entry.lastFrame,'CAPABILITY_SETTINGS',`${entry.label} does not accept a last frame`);}
+  if(own(capability,'settings')){const settings=videoSettings(capability.settings,{strict:true,firstFrame:own(capability,'firstFrame'),lastFrame:own(capability,'lastFrame')});const entry=VIDEO_GENERATION_MODELS[settings.model];assert(!own(capability,'lastFrame')||entry.lastFrame,'CAPABILITY_SETTINGS',`${entry.label} does not accept a last frame`);}
   generationText(capability);
   assert(typeof capability.output==='string'&&own(manifest.outputs,capability.output),'CAPABILITY_BINDING','Use the declared video output port');return true;
  }

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

@@ -2,7 +2,7 @@ import {EXAMPLE_PROVENANCE} from './example-license.js';
 // Portable request; provider/model/payment and real execution approval are
 // selected in StillMade. These fixtures are expectations, not recorded results.
 export const textGenerate={
- manifest:{schemaVersion:1,sdkVersion:'0.1.0',id:'example.script-draft',version:'1.0.0',name:'Draft a short script',description:'Turn a production brief into a short narration draft using an approved text-generation call.',kind:'task',runtime:'capability',entry:'src/capability.json',license:'MIT',provenance:EXAMPLE_PROVENANCE,inputs:{prompt:{type:'text',primary:true,semantic:'production_brief',required:true,description:'Production brief that guides the narration draft.'}},outputs:{script:{type:'script',primary:true,semantic:'narration_script',description:'A concise narration script based on the supplied brief.'}},permissions:{project:[],capabilities:['text.generate'],network:[],filesystem:[],secrets:[]},ui:[{control:'text',port:'prompt'}]},
+ manifest:{schemaVersion:1,sdkVersion:'0.1.0',id:'example.script-draft',action:{label:'Write script',running:'Writing script…'},version:'1.0.0',name:'Draft a short script',description:'Turn a production brief into a short narration draft using an approved text-generation call.',kind:'task',runtime:'capability',entry:'src/capability.json',license:'MIT',provenance:EXAMPLE_PROVENANCE,inputs:{prompt:{type:'text',primary:true,semantic:'production_brief',required:true,description:'Production brief that guides the narration draft.'}},outputs:{script:{type:'script',primary:true,semantic:'narration_script',description:'A concise narration script based on the supplied brief.'}},permissions:{project:[],capabilities:['text.generate'],network:[],filesystem:[],secrets:[]},ui:[{control:'text',port:'prompt'}]},
  capability:{schemaVersion:1,operation:'text.generate',prompt:{$input:'prompt'},system:'Write a concise narration script. Return only the script text.',maxTokens:1200,output:'script'},
  tests:[{name:'A short opening narration',input:{prompt:'Write two narration sentences about a quiet forest at sunrise.'},expectations:{script:{kind:'script',minLength:20,maxLength:6000}}}],
 };

package/packages/block-sdk/contracts.js

@@ -235,9 +235,11 @@ export function validateManifest(manifest, { builtIn = false } = {}) {
   check(plain(permissions), 'permissions', 'Declare permissions explicitly');
   for (const [key, scopes] of Object.entries(plain(permissions) ? permissions : {})) {
     check(['project', 'network', 'connections', 'filesystem', 'secrets', 'capabilities', 'actions', 'desktop'].includes(key), `permissions.${key}`, 'Unknown permission family');
-    // Network entries may be {origin, auth} objects; every other family is a string list.
+    // Network entries may be {origin, auth} objects; every other family is a string list. A module Block's empty
+    // capabilities list is the same as none (November 3, 2026: a module that only calls actions.run was refused for
+    // `capabilities: []` with a message about capability and ComfyUI Blocks).
     check(Array.isArray(scopes) && scopes.every(s => typeof s === 'string' || key === 'network' && plain(s)), `permissions.${key}`, 'Expected string array');
-    if (Array.isArray(scopes)) check(key === 'desktop' ? scopes.length<=DESKTOP_PERMISSIONS.length && new Set(scopes).size===scopes.length && scopes.every(s=>DESKTOP_PERMISSIONS.includes(s)) : key === 'project' ? scopes.every(s => SCOPES.includes(s)) : key === 'actions' ? ['javascript','module'].includes(manifest.runtime)&&scopes.length<=PORTABLE_ACTIONS.length&&new Set(scopes).size===scopes.length&&scopes.every(s=>PORTABLE_ACTIONS.includes(s)) : key === 'capabilities' ? (manifest.runtime === 'module' ? scopes.length >= 1 && scopes.length <= CAPABILITY_RUN_OPERATIONS.length && new Set(scopes).size === scopes.length && scopes.every(s => CAPABILITY_RUN_OPERATIONS.includes(s)) : scopes.length === 1 && (manifest.runtime === 'comfyui' && scopes[0] === 'comfyui.execute' || manifest.runtime === 'capability' && HOSTED_OPERATION_NAMES.includes(scopes[0]))) : key === 'network' && manifest.runtime === 'module' ? networkValid(scopes) : key === 'connections' ? manifest.runtime === 'module' && connectionsValid(scopes) : scopes.length === 0, `permissions.${key}`, key === 'connections' ? 'Unsupported permission: only module Blocks declare connections, up to 8 published adapters by app ID such as app:openapi:notion' : key === 'network' ? (manifest.runtime === 'module' ? `Declare network origins as https origins, optionally with {origin, auth}: ${networkProblem(scopes)}` : 'Unsupported permission: only module Blocks declare network origins; other runtimes reach services through hosted operations and connections') : key === 'capabilities' ? (['module','capability','comfyui'].includes(manifest.runtime) ? 'Declare each hosted operation once, from the supported list (a capability or ComfyUI Block declares exactly one)' : 'Unsupported permission: only capability, ComfyUI and module Blocks declare hosted operations. A javascript or recipe Block declares none: remove permissions.capabilities, or make the AI work its own capability Block') : 'Unsupported permission; Blocks have no ambient filesystem or secrets');
+    if (Array.isArray(scopes)) check(key === 'desktop' ? scopes.length<=DESKTOP_PERMISSIONS.length && new Set(scopes).size===scopes.length && scopes.every(s=>DESKTOP_PERMISSIONS.includes(s)) : key === 'project' ? scopes.every(s => SCOPES.includes(s)) : key === 'actions' ? ['javascript','module'].includes(manifest.runtime)&&scopes.length<=PORTABLE_ACTIONS.length&&new Set(scopes).size===scopes.length&&scopes.every(s=>PORTABLE_ACTIONS.includes(s)) : key === 'capabilities' ? (manifest.runtime === 'module' ? scopes.length <= CAPABILITY_RUN_OPERATIONS.length && new Set(scopes).size === scopes.length && scopes.every(s => CAPABILITY_RUN_OPERATIONS.includes(s)) : scopes.length === 1 && (manifest.runtime === 'comfyui' && scopes[0] === 'comfyui.execute' || manifest.runtime === 'capability' && HOSTED_OPERATION_NAMES.includes(scopes[0]))) : key === 'network' && manifest.runtime === 'module' ? networkValid(scopes) : key === 'connections' ? manifest.runtime === 'module' && connectionsValid(scopes) : scopes.length === 0, `permissions.${key}`, key === 'connections' ? 'Unsupported permission: only module Blocks declare connections, up to 8 published adapters by app ID such as app:openapi:notion' : key === 'network' ? (manifest.runtime === 'module' ? `Declare network origins as https origins, optionally with {origin, auth}: ${networkProblem(scopes)}` : 'Unsupported permission: only module Blocks declare network origins; other runtimes reach services through hosted operations and connections') : key === 'capabilities' ? (['module','capability','comfyui'].includes(manifest.runtime) ? 'Declare each hosted operation once, from the supported list (a capability or ComfyUI Block declares exactly one)' : 'Unsupported permission: only capability, ComfyUI and module Blocks declare hosted operations. A javascript or recipe Block declares none: remove permissions.capabilities, or make the AI work its own capability Block') : 'Unsupported permission; Blocks have no ambient filesystem or secrets');
   }
   if(Object.values(plain(manifest.outputs)?manifest.outputs:{}).some(port=>['workspace-edit','workspace-edit[]'].includes(port?.type))) {
     check(WORKSPACE_EDIT_FIELDS.some(field=>canProposeWorkspace(manifest,field)), 'permissions.project', 'Workspace edits require matching context.FIELD.read and workspace.FIELD.propose permissions');
@@ -257,6 +259,8 @@ export function validateManifest(manifest, { builtIn = false } = {}) {
         continue;
       }
       check(plain(c) && UI_INPUT_CONTROLS.includes(c.control) && Object.hasOwn(manifest.inputs || {}, c.port), 'ui', 'Control must bind to a declared input');
+      // A text input of several lines (one fact per line, a list) declares it, so every host draws a box that keeps its line breaks.
+      if (plain(c) && c.multiline !== undefined) check(c.multiline === true && c.control === 'text' && manifest.inputs?.[c.port]?.type === 'text', 'ui', 'multiline: true goes on a text control bound to a text input');
       if (plain(c) && Object.hasOwn(UI_CONTROL_TYPES, c.control)) check(UI_CONTROL_TYPES[c.control].includes(manifest.inputs?.[c.port]?.type), 'ui', `The ${c.control} control binds a ${UI_CONTROL_TYPES[c.control].join(', ')} input`);
       if (plain(c) && ['select','multiselect'].includes(c.control)) {
         check(manifest.inputs?.[c.port]?.type === (c.control === 'select' ? 'text' : 'text[]'), 'ui', 'Select binds text; multiselect binds text[]');

package/packages/block-sdk/examples.js

@@ -1,19 +1,19 @@
 import {EXAMPLE_PROVENANCE} from './example-license.js';
 export const textCleanup = {
-  manifest: { schemaVersion: 1, license: 'MIT', provenance: EXAMPLE_PROVENANCE, sdkVersion: '0.1.0', id: 'example.clean-text', version: '1.0.0', name: 'Clean text', description: 'Trims extra space from text and returns a clean copy for the next step.', kind: 'task', runtime: 'recipe', inputs: { text: { type: 'text', semantic: 'plain_text', required: true, description: 'Text whose surrounding whitespace should be removed.' } }, outputs: { text: { type: 'text', semantic: 'plain_text', description: 'The same text with surrounding whitespace removed.' } }, permissions: { project: [], network: [], filesystem: [], secrets: [] }, ui: [{ control: 'text', port: 'text' }] },
+  manifest: { schemaVersion: 1, license: 'MIT', provenance: EXAMPLE_PROVENANCE, sdkVersion: '0.1.0', id: 'example.clean-text',action:{label:'Clean text',running:'Cleaning text…'}, version: '1.0.0', name: 'Clean text', description: 'Trims extra space from text and returns a clean copy for the next step.', kind: 'task', runtime: 'recipe', inputs: { text: { type: 'text', semantic: 'plain_text', required: true, description: 'Text whose surrounding whitespace should be removed.' } }, outputs: { text: { type: 'text', semantic: 'plain_text', description: 'The same text with surrounding whitespace removed.' } }, permissions: { project: [], network: [], filesystem: [], secrets: [] }, ui: [{ control: 'text', port: 'text' }] },
   recipe: { schemaVersion: 1, steps: [{ id: 'clean', op: 'text.trim', args: { text: { $input: 'text' } } }], outputs: { text: { $step: 'clean' } } },
   tests: [{ name: 'Trims surrounding whitespace', input: { text: '  StillMade\n' }, expected: { text: 'StillMade' } }],
 };
 const pixels = Array.from({ length: 5 * 5 * 4 }, (_, i) => i >= 48 && i <= 50 ? 0 : 255);
 const expanded = pixels.map((v, i) => { const p = Math.floor(i / 4), x = p % 5, y = Math.floor(p / 5); return x >= 1 && x <= 3 && y >= 1 && y <= 3 && i % 4 !== 3 ? 0 : v; });
 export const lineArt = {
-  manifest: { schemaVersion: 1, license: 'MIT', provenance: EXAMPLE_PROVENANCE, sdkVersion: '0.1.0', id: 'example.thicken-lines', version: '1.0.1', name: 'Thicken line art', description: 'Expands dark outlines in an image while preserving surrounding colors, creating a new image for the next production step.', kind: 'task', runtime: 'recipe', inputs: { image: { type: 'image', primary: true, semantic: 'source_image', required: true, description: 'Line-art image whose dark outlines should be expanded.' }, thickness: { type: 'integer', default: 2, min: 1, max: 8, semantic: 'line_thickness', required: false, description: 'Number of pixels by which to expand dark outlines.' }, threshold: { type: 'number', default: 100, min: 0, max: 255, semantic: 'darkness_threshold', required: false, description: 'Brightness threshold used to identify dark outline pixels.' } }, outputs: { image: { type: 'image', primary: true, semantic: 'processed_image', description: 'A new image with expanded dark outlines.' } }, permissions: { project: [], network: [], filesystem: [], secrets: [] }, ui: [{ control: 'asset', port: 'image' }, { control: 'slider', port: 'thickness' }, { control: 'slider', port: 'threshold' }] },
+  manifest: { schemaVersion: 1, license: 'MIT', provenance: EXAMPLE_PROVENANCE, sdkVersion: '0.1.0', id: 'example.thicken-lines',action:{label:'Thicken lines',running:'Thickening lines…'}, version: '1.0.1', name: 'Thicken line art', description: 'Expands dark outlines in an image while preserving surrounding colors, creating a new image for the next production step.', kind: 'task', runtime: 'recipe', inputs: { image: { type: 'image', primary: true, semantic: 'source_image', required: true, description: 'Line-art image whose dark outlines should be expanded.' }, thickness: { type: 'integer', default: 2, min: 1, max: 8, semantic: 'line_thickness', required: false, description: 'Number of pixels by which to expand dark outlines.' }, threshold: { type: 'number', default: 100, min: 0, max: 255, semantic: 'darkness_threshold', required: false, description: 'Brightness threshold used to identify dark outline pixels.' } }, outputs: { image: { type: 'image', primary: true, semantic: 'processed_image', description: 'A new image with expanded dark outlines.' } }, permissions: { project: [], network: [], filesystem: [], secrets: [] }, ui: [{ control: 'asset', port: 'image' }, { control: 'slider', port: 'thickness' }, { control: 'slider', port: 'threshold' }] },
   recipe: { schemaVersion: 1, steps: [{ id: 'outlines', op: 'image.thicken-lines', args: { image: { $input: 'image' }, thickness: { $input: 'thickness' }, threshold: { $input: 'threshold' } } }], outputs: { image: { $step: 'outlines' } } },
   tests: [{ name: 'One dark point expands to a 3×3 square', input: { image: { width: 5, height: 5, data: pixels }, thickness: 1 }, expected: { image: { width: 5, height: 5, data: expanded } } }],
 };
 
 export const javascriptText = {
-  manifest: { ...textCleanup.manifest, id: 'example.word-count', name: 'Word count', description: 'Counts words and returns trimmed text using isolated JavaScript.', runtime: 'javascript', outputs: { text: { type: 'text', semantic: 'plain_text', description: 'The trimmed source text.' }, words: { type: 'integer', semantic: 'word_count', description: 'The number of whitespace-separated words.' } } },
+  manifest: { ...textCleanup.manifest, id: 'example.word-count',action:{label:'Count words',running:'Counting words…'}, name: 'Word count', description: 'Counts words and returns trimmed text using isolated JavaScript.', runtime: 'javascript', outputs: { text: { type: 'text', semantic: 'plain_text', description: 'The trimmed source text.' }, words: { type: 'integer', semantic: 'word_count', description: 'The number of whitespace-separated words.' } } },
   code: 'const text = input.text.trim();\nreturn { text, words: text ? text.split(/\\s+/).length : 0 };',
   tests: [{ name: 'Counts words', input: { text: '  Hello StillMade  ' }, expected: { text: 'Hello StillMade', words: 2 } }, { name: 'Empty text', input: { text: '  ' }, expected: { text: '', words: 0 } }],
 };

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

@@ -4,32 +4,6 @@
 export const FIRST_PARTY_SDK_IDENTITIES=Object.freeze(new Set([
  "sm.ai-decide@1.0.0",
  "sm.ai-write@1.0.0",
- "sm.animated-scene-assistant@1.0.0",
- "sm.animated-scene@2.0.0",
- "sm.animated-scene@2.1.0",
- "sm.animated-scene@2.2.0",
- "sm.animated-scene@2.3.0",
- "sm.animated-scene@2.3.1",
- "sm.animated-scene@2.3.2",
- "sm.animated-scene@2.3.3",
- "sm.animated-scene@2.3.4",
- "sm.animated-scene@2.3.5",
- "sm.animated-scene@2.3.6",
- "sm.animated-scene@2.3.7",
- "sm.animated-scene@2.3.8",
- "sm.animated-scene@2.3.9",
- "sm.blueprint-assistant@1.0.0",
- "sm.blueprint@2.0.0",
- "sm.blueprint@2.1.0",
- "sm.blueprint@2.1.1",
- "sm.blueprint@2.1.2",
- "sm.blueprint@2.1.3",
- "sm.blueprint@2.1.4",
- "sm.blueprint@2.1.5",
- "sm.blueprint@2.1.6",
- "sm.blueprint@2.1.7",
- "sm.blueprint@2.1.8",
- "sm.blueprint@2.1.9",
  "sm.board-editor@2.0.0",
  "sm.board-editor@2.1.0",
  "sm.board-editor@2.2.0",
@@ -47,19 +21,11 @@ export const FIRST_PARTY_SDK_IDENTITIES=Object.freeze(new Set([
  "sm.captions@2.0.0",
  "sm.character@2.0.0",
  "sm.character@2.0.1",
- "sm.chat@2.0.0",
- "sm.chat@2.0.1",
- "sm.chat@2.0.2",
- "sm.chat@2.0.3",
  "sm.compare@2.0.0",
  "sm.compare@2.0.1",
  "sm.compare@2.0.2",
  "sm.connect-app@1.0.0",
  "sm.contact-fields@1.0.0",
- "sm.continue-if@1.0.0",
- "sm.describe-media@2.0.0",
- "sm.describe-media@2.0.1",
- "sm.describe-media@2.1.0",
  "sm.edit-assistant@2.0.0",
  "sm.edit-assistant@2.0.1",
  "sm.edit-assistant@2.0.2",
@@ -92,8 +58,6 @@ export const FIRST_PARTY_SDK_IDENTITIES=Object.freeze(new Set([
  "sm.grade@2.0.0",
  "sm.grade@2.0.1",
  "sm.grade@2.0.2",
- "sm.image-editor@2.0.0",
- "sm.image-editor@2.0.1",
  "sm.import-media@2.0.0",
  "sm.import-media@2.0.1",
  "sm.import-media@2.0.2",
@@ -101,7 +65,6 @@ export const FIRST_PARTY_SDK_IDENTITIES=Object.freeze(new Set([
  "sm.location@2.0.1",
  "sm.meta-creative@1.0.0",
  "sm.motion-graphics@2.0.0",
- "sm.new-items@1.0.0",
  "sm.panel-strip@2.0.0",
  "sm.panel-strip@2.1.0",
  "sm.panel-strip@2.2.0",
@@ -118,7 +81,6 @@ export const FIRST_PARTY_SDK_IDENTITIES=Object.freeze(new Set([
  "sm.panel-strip@2.4.2",
  "sm.photo-notes@1.0.0",
  "sm.photo-notes@1.1.0",
- "sm.pick-photos@1.0.0",
  "sm.pipeline@2.0.0",
  "sm.pipeline@2.1.0",
  "sm.pipeline@2.2.0",
@@ -128,38 +90,12 @@ export const FIRST_PARTY_SDK_IDENTITIES=Object.freeze(new Set([
  "sm.pipeline@2.2.4",
  "sm.pipeline@2.2.5",
  "sm.pipeline@2.2.6",
- "sm.quality-audit@1.0.0",
- "sm.quality-audit@1.0.1",
- "sm.quality-audit@1.0.2",
- "sm.research@2.0.0",
- "sm.research@2.0.1",
- "sm.research@2.0.2",
  "sm.rough-cut@2.0.0",
  "sm.rough-cut@2.0.1",
  "sm.rough-cut@2.0.2",
  "sm.score@2.0.0",
- "sm.script@2.0.0",
- "sm.script@2.1.0",
- "sm.script@2.1.1",
- "sm.script@2.1.2",
- "sm.script@2.1.3",
- "sm.script@2.1.4",
- "sm.script@2.1.5",
- "sm.shot-plan-assistant@1.0.0",
- "sm.shot-plan@2.0.0",
- "sm.shot-plan@2.1.0",
- "sm.shot-plan@2.1.1",
- "sm.shot-plan@2.1.2",
- "sm.shot-plan@2.1.3",
- "sm.shot-plan@2.2.0",
- "sm.shot-plan@2.2.1",
- "sm.stock-search@2.0.0",
  "sm.style@2.0.0",
  "sm.style@2.0.1",
- "sm.thumbnail@2.0.0",
- "sm.thumbnail@2.0.1",
- "sm.transcribe@2.0.0",
- "sm.transcribe@2.0.1",
  "sm.transition@2.0.0",
  "sm.transition@2.0.1",
  "sm.transition@2.0.2",
@@ -179,26 +115,7 @@ export const FIRST_PARTY_SDK_IDENTITIES=Object.freeze(new Set([
  "sm.voiceover@2.1.6",
  "sm.when@1.0.0",
  "sm.when@1.1.0",
- "sm.whiteboard-assistant@1.0.0",
  "sm.write-summary@1.0.0",
- "sm.youtube@2.0.0",
- "stillmade.narration@1.0.0",
- "stillmade.narration@1.0.1",
- "stillmade.occasion-story@1.0.0",
- "stillmade.occasion-story@1.0.1",
- "stillmade.occasion-story@1.0.2",
- "stillmade.photo-reel-composer@1.0.0",
- "stillmade.photo-reel-composer@1.0.1",
- "stillmade.photo-reel-composer@1.0.2",
- "stillmade.product-ad-variants@1.0.0",
- "stillmade.release-visuals@1.0.0",
- "stillmade.release-visuals@1.0.1",
- "stillmade.release-visuals@1.0.2",
- "stillmade.screen-recorder@1.0.0",
- "stillmade.screen-recorder@1.0.1",
- "stillmade.short-form-finish@1.0.0",
- "stillmade.short-form-finish@1.0.1",
- "stillmade.short-form-finish@1.0.2",
- "stillmade.short-form-finish@1.0.3"
+ "stillmade.generate@1.0.0"
 ]));
 export const isFirstPartySdkIdentity=manifest=>FIRST_PARTY_SDK_IDENTITIES.has(`${manifest?.id}@${manifest?.version}`);

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/image-description-example.js

@@ -3,7 +3,7 @@ import {EXAMPLE_PROVENANCE} from './example-license.js';
 // Provider, model, payment and image loading belong to the trusted host. The
 // package owns only the typed contract, bounded analysis instructions and tests.
 export const imageDescription={
- manifest:{schemaVersion:1,sdkVersion:'0.1.0',id:'example.describe-image',version:'1.0.0',name:'Describe an image',description:'Turn one owned image into concise production-ready visual notes.',kind:'task',runtime:'capability',entry:'src/capability.json',license:'MIT',provenance:EXAMPLE_PROVENANCE,inputs:{image:{type:'image',primary:true,semantic:'source_image',required:true,description:'Owned image to inspect for visible production details.'}},outputs:{description:{type:'text',primary:true,role:'visual_description',semantic:'visual_description',description:'Concise production notes based only on visible image details.'}},permissions:{project:[],capabilities:['image.describe'],network:[],filesystem:[],secrets:[]},ui:[{control:'asset',port:'image'}]},
+ manifest:{schemaVersion:1,sdkVersion:'0.1.0',id:'example.describe-image',action:{label:'Describe image',running:'Describing image…'},version:'1.0.0',name:'Describe an image',description:'Turn one owned image into concise production-ready visual notes.',kind:'task',runtime:'capability',entry:'src/capability.json',license:'MIT',provenance:EXAMPLE_PROVENANCE,inputs:{image:{type:'image',primary:true,semantic:'source_image',required:true,description:'Owned image to inspect for visible production details.'}},outputs:{description:{type:'text',primary:true,role:'visual_description',semantic:'visual_description',description:'Concise production notes based only on visible image details.'}},permissions:{project:[],capabilities:['image.describe'],network:[],filesystem:[],secrets:[]},ui:[{control:'asset',port:'image'}]},
  capability:{schemaVersion:1,operation:'image.describe',image:{$input:'image'},instruction:'Describe only visibly supported subject matter, composition, lighting, color, texture, camera feel and visual style. Return concise production-ready plain text.',maxTokens:700,output:'description'},
  tests:[{name:'Blue image',input:{image:{width:1,height:1,data:[20,80,200,255]}},expectations:{description:{kind:'text',minLength:20,maxLength:32768,includes:['blue']}}}],
 };