MCP changelog
Contents
Server version#
These guides were built with this MCP server version:
0.2.0+9ccaa86d41d7.9680f948ff0f
Your assistant receives a server version when it connects: serverInfo.version on the connection, and _meta["patchwork/serverVersion"] on every tool result. The part after the last dot changes when a release changes the tools, their inputs, the resources or the prompts.
Bitebox does not tell an open connection that its tools changed. If the part after the last dot is not the same as above, your assistant still has an old tool list. A feature turned on for your account does not change the version, but it can change your tools too. In both cases, reconnect your assistant.
Your assistant can read this list too, from the patchwork://changelog resource.
2026-11-13#
- Added
credits_history(toolsetadvice,analytics: read, All-projects grants, flagmcp-usage-profile): the creator's credit spend, newest first, as charges, returns and reservations with credits, status, time, model and project label. Purchases, grants and refunds are not listed (NEU-3993). - The
edit-not-bakedwarning, itsedit-not-bakedrefusal fix and the guide now namenode_run(andnode_run_statusfor a clip) as the way to store an edit's file (NEU-3298). Before, they said no tool bakes an edit and sent the agent to the creator's Canvas. package_definetakes a node that extends Target Overlay:baseType: "trigger"withbaseKind: "hotspot", whosedefaultsmay setdescriptionandonClick. A placed one takes the Target Overlay wires and commands,set-hotspot-overlay-regionsincluded (sendexpectedDefinitionId: "hotspot"there;patch-node-contenttakes the package node id), and gets the same File checks as a first-party Target Overlay, which refuse anonClickother thaninstantorat-end. Choice stays the other base; no other trigger kind is admitted, and a trigger with nobaseKindis refused. The tool description names both bases (NEU-4696).- Added workflow template sharing (NEU-3983), as Home's Share as template and the template landing page do, while the
workflow-template-sharingflag is on for the creator:workflow_template_sharemakes a template link for a project (a project that already has a live link answers that link withexisting: true),workflow_template_lookupanswers a project's live link orlink: null,workflow_template_getreads what a link offers,workflow_template_savecopies the linked project into a new project in this token's scope, andworkflow_template_removeremoves a link. With the flag off, every one answers not found. project_trashnow refuses a project with a series in the Bitebox app withagent-forbidden, asproject_archivedoes, and refuses after the creator stops the agent (NEU-3993).document_checkpoint_setnow only fills an empty name or note. A name or note already there, including a label given to a write, is refused withcheckpoint-already-named, because it may be the creator's and history keeps no earlier one.data.previousis gone, since nothing is replaced (NEU-3993).
2026-11-11#
playthrough_simulatetakes an optionalmoveslist, behind thesimulate-movesflag (internal for now, NEU-4564). Each move is{ kind: "end" },{ kind: "choose", routeId }or{ kind: "claim", triggerId, optionId? }. With moves, the File plays from the start on the play engine, each Set and Conditional runs as it does in the player, and the answer addsdata.playthrough:scenes,status(showing,endedorstopped),lastSceneIdandstate(each field the story declares, and any key play wrote). A move the scene on screen does not offer refuses withmove-not-offered;data.playthrough.refusednames the scene and the moves it offers. Where the flag is off, a call with moves refuses withfeature-disabled. A call without moves answers as before.
2026-11-10#
generate_quoteandgenerate_runbynodeIdrefuse a Generate Text node whose/props/modelis not a Generate Text model (for exampleopenai/gpt-5) withunknown-model, before any quote, hold or spend. Before, the node was quoted and run as Gemini 2.5 Flash without saying so. The refusal names the saved value and lists the model idsgenerate_modelsoffers. A node with no saved model still runs the default. The Canvas still shows, prices and runs the default for such a node, as its inspector shows (REL-33).generate_quote,generate_runandgenerate_finishrefuse a tile thatgenerate_modelsdoes not offer the account, withfeature-disabled, before any price, approval card or budget hold. Before,generate_quotestill priced a hidden tile such as Kling 4 when it was named. Tilesgenerate_modelslists, and runs already started, do not change (NEU-4554).- A
media_reviewclip audit now costs 400 credits, up from 200, because a full audit cost about $0.28 and up to $0.39 in measured runs (NEU-2708). The tool description states the price, and that price is what the audit reserves and charges. A free size and format check still costs nothing. generate.completedandgenerate.failedare sent once per agent run, withprojectId,runIdandstatus.generate.completedcomes once the file is on its node (withnodeIdandrevisionId) or in the project's media (withmediaIds), also when the server finishes the run and nobody callsgenerate_status. A canceled run sendsgenerate.failed. A node run that fails while nobody polls sendsgenerate.failedonly aftergenerate_statusclears its running mark (NEU-3277).generate_statusstays the recovery read (NEU-4489).
2026-11-09#
- Event subscriptions by signed webhook, behind the
mcp-eventsflag (internal for now, NEU-4488). Where it is on for the grant's owner,initializeadvertisesevents, the server answersevents/list,events/subscribe(also the refresh) andevents/unsubscribefrom the draft MCP Events extension, andworkspace_contextanswersevents. The events aregenerate.completed,generate.failed,watch_through.completedandpublish.status.changed;generate_status,watch_through_getandpublish_statusdo not change. watch_through.completedis sent: once per watch-through, when it ends, withprojectId,jobIdandresult(passonly when the job succeeded and its report passed). A job that times out in the queue sendsfail; a waiting or playing job sends nothing. The report stays behindwatch_through_get(NEU-4490).publish.status.changedis sent when a publish request is published, canceled or expires, usually within two minutes, withprojectId,pendingIdandstatus; a published one also carriesurl(the page linkpublish_statusshows) andpublicationId. A request that is still waiting, or being published, sends nothing; one canceled after it expired sends onlyexpired.publish_statusstays the recovery read (NEU-4491).
2026-11-05#
generate_statusremoves a failed or canceled run's running mark from its node before it answers that the run ended, so the File does not change after that answer. When the mark cannot be removed yet, it answersstatus: "finishing": poll again. A background check no longer changes the File for a run that ended, sodocument_getcan show an ended run's mark until the run is polled or the File is next saved (NEU-3277).
2026-11-04#
- Added
whats_new_pendingandwhats_new_attachfor NEUKO operator accounts only: the Saturday task lists the notes that need a visual or a sample and attaches them. A visual waits for a person's approval in admin.
2026-11-03#
- Tools name the flags that change them, in their descriptions and in the
flagsfield of the tool reference (NEU-4256). Behavior does not change.preview_urlopens the reference player (/player?exp=) wherepreview-play-pageis off on the deployment.playthrough_simulate,publish_check,watch_through_startandpanel_watchcount the tap targets an Add Branch owns on a clip that plays on only whereadd-branch-overlaysis on.publish_copy_generaterefuses wherepublish-describeis off on the deployment.project_forkandpublish_fork_settingsnamepublished-story-fork.schema_nodes,schema_nodeandworkspace_contextnamepackage-developer-mode, which decides whether granted package nodes appear, andworkspace_contextnamespublish-describe.profile_get,usage_report,media_compare,node_run,generate_run,generate_finish,package_defineandpackage_listname the flag they already used. generate_modelsmarks a setting that applies only on one route, such as Flux 3'sclip_modewhen a Video is wired (NEU-3924).node_run_statusreports a clip bake (queued, baking, done or failed), and the poll that claims a queued run executes it. Poll until done or failed; a failed run names itscode(NEU-3890).project_archive,project_unarchiveandproject_restore: hide a project from the defaultproject_list, bring it back, or move it out of Trash to where it was. A project with a series in the Bitebox app is refused; the creator does that in the Canvas (NEU-3993).package_defineandpackage_list(NEU-4009): store a test-tier community package version from its exact manifest text, and list this account's versions. Both are listed only where thepackage-developer-modeflag is on for the account. A person turns on developer mode and grants a version before its nodes can be placed.publish_fork_settingsanswersforkEnabled: falsefor a story with no recorded choice, which includes every story published before this change;project_forkrefuses those stories until the owner turns forking on. A story published from the Canvas Publish dialog records the dialog's fork switch, which starts on. A publish the creator confirms from an agent's request records nothing, so that story starts off (NEU-3981).profile_getandusage_reportstay listed, but a call refuses withfeature-disabledunless the flagmcp-usage-profileis on for the grant's owner (internal for now). Home profile and the Creator console do not change (NEU-3993).- Draft takes and Finish are behind the
generate-draft-takesflag (NEU-3923). Where it is off for the account,generate_runwith Draft on andgenerate_finishrefuse withdraft-takes-offand afeature-disabledguidance entry, before any quote or spend. Both tools stay listed, runs with Draft off are unchanged, and draft takes already made still play. - Color correction Match is behind the
color-matchflag (NEU-3893). Where it is off for the account,node_runon a Color correction node with a wired Reference refuses withcolor-match-offand afeature-disabledguidance entry, before any fetch or bake.document_connectanddocument_patch_node_contentstill write the Reference wire and the Match settings, and media already baked still plays. media_comparestays listed, but a call refuses withfeature-disabledunless the flagmedia-compareis on for the grant's owner (internal for now).media_measuredoes not change (NEU-3880).
2026-11-02#
node_configureon a Video takesremove-branchwithitemId(an exit id): it disconnects that exit's wires and removes it, keeping every other exit's id, order and wires. It refuses the Video's only Storyline (autoplay) exit.document_replace_endpoint_configurationtakesremoveItemIds, the itemsafterdrops; each must hold no wire. An item dropped without being named is still refused.replace-endpoint-configurationindocument_applytakes the sameremoveItemIds(NEU-4151).document_validateanswers diagnostics first. By default it lists the diagnostics (errors first, at most 50) and counts wires and references (wireCount,referenceCount), but does not list them: a 99-node File answered about 97,000 characters, past what an MCP client reads. Passinclude: ["wires", "references"]for the lists as before, ornodeIdfor only the diagnostics, wires and references that touch one node, with themappingId+paththatdocument_disconnectanddocument_repair_referencetake. An unknownnodeIdanswersunknown-node. The referencepathfields indocument_applyanddocument_set_unresolved_referencesay so (NEU-4152).publish_checkno longer fails a story whose loops make more than 200 paths. It checks each route out of each reachable node once: every route must lead to a node or end the story, and every loop must pass through a clip. A broken route still fails, wherever it is. The path count is information only (detail.paths,detail.truncated).playthrough_simulateanswers the same check ascoverage(reachable nodes, routes, endings, every dead end and loop groups), andunreachableNodeIdsstays complete whentruncatedis true (NEU-4150).preview_urlanswers a link to the story's play page,/play/<projectId>?previewToken=<token>, as viewers see a release, playing the unpublished revision. It no longer opens the reference player with its JSON tools. The token, its 15 minutes and its access rules are unchanged, anddocumentPathstill serves the revision. A project with a release keeps that page's copy in the preview; the preview records nothing for the release (NEU-4153).- A
generate_runon a node stays in the agent's run: its running mark, result and clear are saves of that run, so the Canvas count keeps rising through the generate and Revert changes undoes the task with its result. A running generate holds the task open past the 5-minute gap. A result still on its way when the creator reverts does not land:generate_statusandgenerate_runanswernode.reverted: truewith the file'ssrcand add it to the project's media, and a text run answersreverted: true. Credits stay charged. A generate the creator started still ends the run (NEU-4065). panel_watchrecovers from a client timeout asmedia_reviewdoes. Call it again with the same arguments: the call answers the watch withreplayed: trueand charges nothing, or answersreview-runningwhile the watch is still going. Before, a retry during the watch paid for a second one. A watch that stops with no answer runs again on the credits it holds, up to 3 tries. A watch that failed is not kept: its credits were spent, and a retry reserves again. A newrunIdpays for a new watch (NEU-4066).
2026-11-01#
document_arrangeleaves room for the card each clip really makes: a 9:16 clip's card is about 640 px tall, and a Choice Overlay and the editing cards show their clip. Before, two 9:16 clips in one column overlapped.choice_addplaces the new overlay one column right of its clip, below anything already there, instead of on top of the clip (NEU-4049).media_listandmedia_describeanswername: the file's upload name, its import URL's file name, the generate runId that made it, or null when it has none.media_completeandmedia_import_urltakename. Callmedia_completeagain with a key frommedia_listto name or rename a stored file.media_listnow sorts by when a file was stored, so a rename does not move it (NEU-4050).- A
media_reviewaudit answer lost to a client timeout can be read again without a second charge. For 24 hours, the same call (same clip, expectations andledgerRunId) answers the kept audit withreview-replayedguidance, orreview-runningwhile it is still going. An incomplete verdict is not kept, so reviewing again is a new paid audit, as before.fresh: truepays for a new audit (NEU-4051). - ElevenLabs Music no longer offers
output_format: pcm_44100(the tile's WAV format). Those runs were charged and never saved, stuck at GEN-210.generate_quoteandgenerate_runrefuse the value before any spend, withunknown-input-optionon a node that saved it. The Canvas runs such a node as MP3 and shows MP3 (NEU-3968). - An agent's writes group into one run with no run id. A write that names no run continues the run on the File's head when this grant wrote that head under 5 minutes ago, so a stock client's task shows as one run and Revert changes undoes it. A creator edit, a generate's save, a restore or another agent starts a new run. The first revision of a File stays a run of its own, because a run that created the File cannot be undone.
agentRunand the run headers work as before. This coversdocument_apply,scene_addandtake_pick.file_createkeeps its own run id: reusing it on the batches that build the File takes the one-step undo away (NEU-4048). - Added
project_fork(NEU-3977): start a new project from someone's published story, as viewers see it, from its story page link orpublicationId. It is the Fork control on the story page. It answersnot-foundwhen the story is not published, its creator turned forking off, or story forking is not on for the deployment (flagpublished-story-fork, internal). - Added
publish_fork_settings(NEU-3978): read or set whether others may fork a project's published story, as the Canvas Fork settings does. Forking is on by default. - Added
document_revision_getanddocument_diff(toolsethistory,history: read, plusdocuments: read): one past version of a File, and what changed between two (NEU-3186). - Added
document_checkpoint_set(toolsethistory,documents: write): name a past version, or clear its name. No version is added or removed;data.previousholds the name and note it replaced (NEU-3186). - Added
document_replace(toolsetbuild,documents: write): replace a whole File on its head, as a new revision. A stale head is a conflict, never a merge.document_restorebrings the old head back (NEU-3193, NEU-3194). - Added
document_paste_nodes(toolsetbuild,documents: write): copy nodes from the same File, or another File or project the grant covers, as one revision. New refusal:nodes-not-placeable(NEU-3195). - Added
usage_report(toolsetadvice,analytics: read, All-projects grants): the Creator console's generation usage, estimated USD per model, project and publication counts, and playback totals for a date range.playbackcarries counts only; choice and drop-off keys stay inanalytics_paths, which checks them against the published graph (NEU-3993). - Added
profile_get(toolsetcontext,documents: read): the creator's public username and avatar URL, or null. Read only (NEU-3993).
2026-10-22#
- A story wire may loop, including two clips that wire to each other (Remy Brommer).
document_connectanddocument_applykeep it; a prompt, position, pulse or signal loop is still refused, including one that runs through a Router.document_validatereports those asdata-cycleand no longer reportsstory-cycle. - A story loop must pass through a clip. A Storyline loop made only of Set, If, Router or editing nodes is refused by
document_connectanddocument_apply, reported bydocument_validateassilent-story-cycle, and a dead end inplaythrough_simulateandpublish_check: the player passes those nodes without stopping, so it would stop there. - A File needs no End and no path that reaches an ending (Austin).
publish_checkpasses a path that loops back; it fails only a route the player cannot follow (a choice option or route with no target, a missing node, two autoplay exits, a silent hop with no Storyline out, a loop with no clip in it), a File with no start, or a walk past its path limit. document_validateno longer warns "leaves the spine without a path to a storyline End" on a choice, Target Overlay or Chat Overlay route that loops back to an earlier scene (Austin). It still warns when every path from the route stops on a route that is not wired.watch_through_startandpanel_watchwatch a path that loops back once around, to the scene that routes back, instead of failing or refusing it (Austin). A watch-through run passes when the player turns back there; each run and each panel report names that scene inloopsBackTo.scene_addtakessrcinstead ofprompt: a Patchwork-hosted video frommedia_import_urlormedia_listbecomes a Video scene with its measured size and length, wired fromfromand the start withstart: true. It is the node the Canvas Import becomes after an upload; animportnode never plays andset-startrefuses it. Asrcoff the media CDN, a file the server cannot read there, a file that is not a video, orsrcwithprompt,definitionId,aspectRatioorreferencesanswersintent-invalidand writes nothing.promptis now optional; a call with neither answersintent-invalid(NEU-3555).
2026-10-21#
media_reviewfails the cast check for a cast member named incastNodeIdswho never appears in the clip; before, it was a note and the clip passed aspass-minor(NEU-3361). Anincompleteverdict answersverdict.retry: review the clip again with the same expectations, and retake it only if the second review fails or is incomplete again. Other verdicts answerretry: null.
2026-10-15#
- Added
series_bible_request_approvalandseries_bible_sync_approval(Content Factory checkpoint 1; NEU-3260, NEU-3295). The owner approves a series bible and its rights note in Linear, not in the Canvas. Both tools are for NEUKO operator grants only. series_bible_request_approvaltakes the draft'ssha256and the bible page asreviewUrl. It creates or updates the project's one approval ticket in the Content Factory Linear project. The ticket shows the bible version and hash, the rights note hash, each premium model with its reason, the budget, and the whole bible and rights note as the server holds them. The page link is only the agent's comment page; the owner approves the ticket.- The owner adds the label Bible approved.
series_bible_sync_approval(projectId,issue) then has the server read the ticket. It approves only a label added by a human approver after the ticket last changed, on a ticket that is the server's summary of the current draft. The agent never sends a verdict, and comments are never read. - New refusals:
bible-approval-not-given,bible-approval-changedandlinear-unavailable. Until agents stop writing to Linear as a person, sync answersbible-approval-disabled: it reports the checks and approves nothing. series_bible_savetakesrightsNoteand refuses a note thatrights_note_checkwould not answercompletefor (rights-note-not-complete); request and sync check it again, so a refused, incomplete or stale note is never approved.series_bible_getanswers each entry'srightsNoteStatus. A draft may listpremiumModelswith the owner's reason; they count only after the owner approves that draft.series_bible_getanswers each entry'srightsNoteSha256, and on the approved entrydraftSha256andapprovalRef.- The approval records the owner's checkpoint 1 verdict in the run ledger;
ledger_recordrefuses keys that start withcheckpoint-1:.project_duplicatekeeps only a draft bible in the copy. - Added per-run spend approval, off by default. The creator turns it on with Ask before each run under Generation (
generate: { budget, confirmEachRun: true }). - With it on,
generate_quoteanswersapprovalRequired: trueandapprovedfor thatrunId, andworkspace_contextanswersconfirm-each-runguidance. - With it on,
generate_runrefuses an unapproved run withagent-spend-approval-required(428), its quote,approvalIdandapprovalUrl. Nothing is held or spent. - The agent tells the creator the estimated and maximum credits and gives them
approvalUrl. The creator approves that run, at that price, on its confirm card in the Canvas. The agent then sends the run again with the samerunId. An agent token cannot approve its own run. - A declined run answers
agent-spend-declined(409). The daily budget still applies to an approved run.media_reviewandpanel_watchdo not ask. - Added
rights_note_checkandseries_bible_validate(Content Factory F2, F3; NEU-3263). They run the repository's own checks (rights-note.mjs,bible.mjs), cost nothing and touch no project. rights_note_checkdates the check by the server. It answersstatus(complete, incomplete or refused), the reasons,render(Markdown for a review page) andhash.series_bible_validatechecks a bible against the modelsgenerate_modelsoffers the token. It answersvalid,errorsandwarnings, and withrender: truethe review page ashtml.- Added resources
patchwork://guide/factory-formats(the bible and rights note formats, the example bible and the blank rights note) andpatchwork://guide/house-audience(the approved house audience, NEUKO operator grants only). A hosted factory now needs no repository checkout. generate_quoteandgenerate_runrefuse a select setting whose value the tile does not offer (a voice, aspect or duration not ingenerate_modelssettings[].options) withunknown-input-option, before any quote, hold or spend. Before, the value was dropped and the run used the tile's default without saying so. The message names the setting and lists its values. A nodeId run refuses the same way when the node's saved/props/generate/inputholds such a value; the Canvas still opens that File and runs the default, as its inspector shows. Writes that leave a generate node with such a value, anddocument_validate, answerunknown-input-optionguidance naming the node (NEU-3211).- Added
performance_series(toolsetadvice,analytics: read, plus a Biteboxperformance:readrow for the grant on the project): per episode File of a series project, in page order, measured starts, completion and next-episode rate (viewers who finished episode N and started N+1 within 24 hours; a viewer is one browser-tab visit). A rate needs 20 in its denominator, otherwise it is Inconclusive with no value; an unmeasured project or window answerscoverage: unavailablewith null counts, never zero. Measured first-party data only, never the synthetic panel (Content Factory P6, NEU-3171). analytics_pathsreads more for a grant owned by a NEUKO operator: 5,000 trails per publication across 5 publications (creators keep 500 across 3) (NEU-3171).
2026-10-14#
- Added the producer journal for NEUKO operator accounts only:
journal_addrecords a short entry (1 to 300 characters, in the agent's own words) when the person states a preference, corrects the agent's work or says what they learned, linked toprojectId,filePath,revisionIdandnodeIds;journal_listreads back the caller's own entries, newest first. Both are in thecontexttoolset, so?toolsets=never hides them. Other accounts do not see either tool, and the server instructions gain one paragraph on operator connections only. A call the connection cannot make answersjournal-unavailable(NEU-3235). - Added resource
patchwork://guide/content-factoryand promptfactory-round(Content Factory F1, NEU-3181): the content-factory skill as served text: the steps of a Bitebox Originals round (pitch, checkpoint 1, cast, build, clip and path checks, panel, checkpoint 2, run ledger), the budget gate and the hard rules. The factory still runs from a repository checkout, because its format checks and house audience page are repository files (NEU-3263).media_reviewnow states the audit's price in credits. - Added
publish_check(Content Factory P3, CP-08): the server's pre-publish report on File revisions (public document size and the authoring-only fields it leaves out, every path reaching an ending, timed choices inside their clips, generation while playing, loudness not measured yet), recorded per revision.publish_requesttakesfiles, a drop: the episode Files one release adds to the series page, in page order. One creator click publishes all of them together with the series manifest, all or nothing; episodes already published stay as they are. The card keeps Publish off while any revision of a publish request (a drop or one File) has no passing check (guidancepublish-check-missing), and the confirm refuses it; a rollback from the card to a revision that was published before is not gated. An operator's direct publish, rollbacks included, without one is refused withpublish-check-required(CP-09) (NEU-3168). - Added
series_bible_getandseries_bible_save(Content Factory F4, NEU-3243).series_bible_savesaves the factory's bible as a draft on its series project. An agent token never approves a bible (bible-approval-human-only). It never adds or changespremiumModels(premium-models-human-only). Only the owner's checkpoint 1 approval card writes the approved bible. The generate route enforces the approved bible, else the draft.generate_quote,generate_runand the Canvas Run model refuse any other model withmodel-not-in-biblebefore any quote or spend. A video model outside the H3 family and Kling Omni Reference counts only in the approved bible'spremiumModels. No File write can remove the bible, change it in place or write the approved bible (series-bible-locked). scene_addwithoutdefinitionIdnow places H3 Max (minimax-h3-max) when the workspace offers it, it has the 9:16 publish target and the token can quote it. Otherwise it falls back to the first such video tile, as before, and its note says why. PassdefinitionIdto choose another tile.- Added
agent_grants_listandagent_grants_revoke(toolsetcontext, any grant). The list shows the creator's agent grants inside this token's own project scope, withself: trueon this token's row, and never a bearer. Revoke takes this token's owngrantIdand drops its access at once; any other grant is refused withagent-forbidden. Minting and editing grants stay the creator's clicks in the Canvas (NEU-3215). - Added saved-template writes behind
documents: write(NEU-3172):templates_savesaves nodes of a File (and the wires between them) as one of the creator's saved templates, as the Canvas Save as template does;templates_updatewrites a new version (name, description, or contents from nodes of a File);templates_deleteremoves one from the Saved panel andtemplates_restorebrings it back;templates_insertplaces a copy in any File with new node ids, as dropping it on the canvas does, in one revision, and answersnodeIdMap; a placement that would drop authored content is refused withtemplate-not-placeable.templates_update,templates_deleteandtemplates_restorealso need an All-projects token.templates_updateandtemplates_insertread the template first, which needsanalytics: readastemplates_getdoes; a write answers the template's contents only to a token withanalytics: read. - Added the shared cast library (Content Factory P5):
cast_list,cast_get,cast_saveandcast_place. A cast library is a project; each cast entry is a story object in its entry File with append-only versions (reference stills by view, voice, model presets, a LoRA slot).cast_saveneedshistory: read(it numbers versions from the File's past documents), takesexpectedVersionand refuses a stale or raced save withconflict, and accepts only stills from that project's own images (invalid-cast).cast_getanswers a pinned version, read from the oldest past document that holds it, which is its save (each save is also labelledcast <castId> v<N>for people), withrefand adigest; guidancecast-head-editedorcast-pin-unverifiedsays when the File's copy differs or could not be checked.cast_placeadds a version's stills to a File in another project as Image nodes and answerscastNodeIdsfor reference ports andmedia_review. The cast project must be in the token's scope (NEU-3170). - Added
take_pick: pick which take of a generate node plays, the way the Canvas take pager does. Passtake(1 is the oldest) orsrc(a take's URL). It movesprops.src, the take the preview and the published player play, andprops.generate.resultIndexin one patch, so the Canvas shows the same take selected. A wrong take answersintent-invalidwith the node's take list (Content Factory P9, NEU-3174).
2026-10-13#
generate_runwithnodeIdruns what is wired on the canvas, the same request the Canvas Run model sends: the node's tile, its wired Prompt, every wired media port in port order, its LoRA and its/props/generate/inputsettings.generate_quotetakesnodeId(andpath) to price that request. On a nodeId run,prompt,imageUrl,endImageUrl,imageUrls,referenceMedia,videoUrl,loraandinputare refused withinputs-not-on-canvasunlessoverride: { reason }is passed; the reason is recorded on the node (/props/generate/agentOverride, shown on its card) and on the revision before the run starts. An empty required port refuses withports-neededand the card's own copy; a wiredsrcoff the media CDN refuses withwired-media-not-hosted.definitionIdandpromptare optional on a nodeId run. Runs withoutnodeIdare unchanged.schema_nodegenerate sections addpromptSourcePath(/props/promptSource, where the wired Prompt node is recorded).promptPathis deprecated: a run never reads it. It will be removed on or after 2026-10-27.
2026-10-08#
generate_modelslists only the tiles an agent token can quote: a tile with no paid price on the rate card is left out.schema_nodesandschema_nodemark such a tilerunnable: falsewithnotRunnableReason(andschema_nodeaddsmodel-not-quotableguidance),workspace_contextnames it innodeFlags.notRunnable,patchwork://nodes/{definitionId}andpatchwork://models/{definitionId}/promptingsay so at the top, andscene_addno longer picks it as the default video tile (naming it explicitly places it with a note). It can still be placed;generate_quoteandgenerate_runrefuse it withmodel-not-quotableas before (NEU-2630).- Write results name their agent run:
document_apply, thedocument_*command tools,document_arrange,scene_add,choice_addandnode_configureanswerdata.agentRunIdwhen the revision records a run: the run it was grouped under (theagentRunargument, theX-Patchwork-Agent-RunorMcp-Session-Idheader, or an id the server assigned). Pass it asagentRunon the task's laterdocument_applybatches. A dry run, an unchanged write or a write that recorded no run names none (NEU-2835).
2026-09-29#
- Added
publish_logo_generate: asks the Publish page's own route to draw the series logo, the title mark on the public page. Passseriesto store the series note while the project has none; set genres withpublish_copy_setfirst. It answersstatusdrawnwith the logo URL orpendingwithwaitingOn;logo-unavailable,logo-failed,logo-store-failedandlogo-cap-reachedare errors. A project gets three draws a day and its owner twelve across projects (NEU-2709). publish_requestandpublish_rollbacktakelogline,interactivityFocusandfileFocus: the sentence on the card under the title and the focal points of the two stills. They are frozen on the request, answered asrequest.text, and released with it where the creator's own Publish page sends none; the creator's sentence wins on their click. They last for that one request, so pass them again on the next publish or rollback. Both tools addpage-logo-missingandpage-logline-missingguidance when the request has no saved logo or carries no logline (NEU-2704).
2026-09-26#
generate_modelsnow returnspromptingSection(the prompting rules for every tile) and each tile'spromptingRules, so clients without resource support see them.patchwork://guide/authoringgains the "Prompting generate tiles" section (NEU-2601).document_validateand write results warnedit-not-bakedon a Trim, Crop, Resize, Rotate and Flip, Invert or Color correction whose edit has no baked file: these bake only in the open Canvas.playthrough_simulateadds anoteto that step and anedit-not-bakedguidance entry.schema_nodebehavior for the six says so, and that the player never plays an edit node's file (NEU-2639).media_reviewaudits clips (NEU-2599): passaudit: trueor any oflines([{text, speaker}]),onScreenTextorcastNodeIdsand it answerstranscript,speech(per-line count and speaker, settled by the frames),voices,keyframes(with a contact-sheet URL),text,castConsistency,overlayBandand averdict(pass, pass-minor, fail or incomplete). The audit is metered against the token's daily generate budget, so the tool is no longer annotated read-only. Without those arguments it answers as before.
2026-09-25#
- Added advice tools behind the new
analytics: readgrant row (off unless the creator turns it on):analytics_paths(per-node reach and drop-off from viewer trails),benchmarks_get(norms across the creator's own projects; other workspaces wait on a consent decision),templates_listandtemplates_get(the creator's saved templates). Addedmedia_describe, which reports shots, keyframes, transcript and cast clusters as unavailable (NEU-2577). - Added
document_set_rules,document_set_objectsanddocument_set_tags(commandsset-rules,set-objects,set-tags): replace the File's IF rules, its objects, or one node's tags, with the Canvas checks (NEU-2575). document_validateand write results: a scene reached from the start with no route out is an ending. Stories with several endings no longer getdisconnected-story-destinationon a scene's own route or "leaves the spine without a path to a storyline End" on choices that reach one (NEU-2578).
2026-09-24#
- Added
schema_nodesandschema_node: enabled definitions and generated node pages (ports, patchable paths, defaults, enums, configuration commands, endpoint-owned fields, an example batch). - Added intent helpers
scene_add,choice_addandnode_configure; each expands to aDocumentCommandbatch applied throughdocument_apply. - Added
publish-target-aspectguidance todocument_validateand write results. - Added resources
patchwork://guide/authoring,patchwork://nodes/{definitionId},patchwork://workspace/rules,patchwork://project/{projectId}/summary,patchwork://models/{definitionId}/promptingand this changelog; promptsbuild-from-idea,build-from-assets,review-pacing,prepare-publish.