Changelog
Release notes for aparté 1.2.0: what changed in each @aparte package, and what to update.
On this page
Version 1.2.0
Every @aparte/* package ships at this version (they are released in lockstep).
Minor Changes
-
fd00133: New
<aparte-artifact-panel>: a conversation’s document beside the chat, with its versions. Import it from@aparte/plugin-artifacts/panel.html<aparte-split position="40" single> <aparte-chat id="chat">…</aparte-chat> <aparte-artifact-panel for="chat"></aparte-artifact-panel> </aparte-split>tsimport { setupArtifacts } from "@aparte/plugin-artifacts"; import { connectArtifactPanel } from "@aparte/plugin-artifacts/panel"; setupArtifacts(); connectArtifactPanel({ chat, panel, split });connectArtifactPanelturns on the card’s Open button for that chat: a press shows that version in the panel, opens the split’s pane and moves the focus to the title; Close, or Escape, folds the pane and gives the focus back.autoOpen: trueopens the pane when a turn writes a document. The split is optional (onOpen,onClosefor a dialog or a drawer).The panel reads the conversation and keeps nothing of its own. One header row holds the title, the version arrows, your own buttons (a child with
slot="actions"), the card’s Code and Preview tabs, Copy, Download and Close. A Markdown document is shown rendered, for reading; a page or a component is shown as source and runs only on a press, as on the card. It also takes your own documents (documents), an agent’s own tool (read) and your own rendering of one kind (render). It is a separate entry, so an app that only wants the card does not ship it.Four locale keys come with it, translated in the nine languages of
@aparte/locales:closeArtifact,artifactVersion,previousVersion,nextVersion.@aparte/core,@aparte/plugin-artifacts,@aparte/locales -
fd00133: A segment of a type core does not know can now say what surrounds its content in the history sent back to the model:
wire: { before, after }.For a block grammar (
registerStreamBlock): the model wrote<note id="n1">…</note>and used to read back the body alone, so it could not name the block again to change it. SetwireintoSegmentand the model reads the tag it wrote:tstoSegment: ({ attrs, id }) => ({ id, type: 'note', content: '', wire: { before: `<note id="${id}">`, after: '</note>' }, }),Without
wirenothing changes: the content alone, as before. It is not read fortextandcode, which core serialises itself.@aparte/core -
fd00133:
<aparte-split>now moves between one pane and two whensinglechanges, instead of jumping.Nothing to change in your code. The pane that arrives is uncovered at the size it will have, the one that leaves is covered, in the theme’s
--aparte-duration-slower. There is no move underprefers-reduced-motion, nor when the split is stacked by its breakpoint. To keep the change immediate:cssaparte-split[data-moving] { transition: none; }While it moves, the element carries
data-movingand lays both panes out. Before this, a pane beside the chat appeared at once while the sidebar animated its fold.@aparte/core -
fd00133: A document now has an id and versions: the model changes one by passing its id back, and
artifactDocuments(messages)reads them from the conversation.Nothing to change in your code.
create_artifactgives each new document a short id (doc_4f2a91c0), returns it in its result and tells the model how to use it: call the tool again withidand the complete new content. A document written with the<artifact>tag gets one too, and now reads back to the model as the tag with that id (<artifact id="…" type="…" title="…">), so a model with no tools can rewrite it the same way. A call or a tag that names an existing id is a new version of that document; nothing is overwritten, the earlier versions stay in the conversation.artifactDocuments(messages, { tools?, read? })is a pure function, exported for Node too. It returnsArtifactDocument[]with theirArtifactVersions, oldest first. A call that was refused, stopped or failed is not a version.readtranslates a segment the plugin does not know (an agent’s own document tool). A conversation saved before this release reads as one document per card.aparte-artifact-opennow also carriesdocumentIdandsegmentId. A card in a reply dispatchesaparte-artifact-changewhen it is drawn or changed.The default system prompt gains one sentence, on changing a document; a prompt of your own is untouched.
@aparte/plugin-artifacts
Patch Changes
-
4696b2a: A tool’s
systemPromptis no longer sent when the tool is not: for a model withoutfunction_calling, or a request sent withtoolChoice: 'none'.Core already left the tools out of those requests, but kept their instructions in the system message, so a model with no
create_artifact(or any other tool) was still told to use it, and could describe a call it cannot make.config.resolveToolSystemPrompts()takes the tools a request carries and returns only theirs; called without an argument it still returns every registered tool’s. The context gauge counts the same way. Nothing to change in your code.@aparte/core
Version-only bumps (no changes of their own): @aparte/engine, @aparte/runner-ag-ui, @aparte/runner-n8n, @aparte/provider-ai-sdk, @aparte/provider-openai-compat, @aparte/provider-scenario, @aparte/provider-transformers, @aparte/plugin-approval, @aparte/plugin-ask-user, @aparte/plugin-cards, @aparte/plugin-chartjs, @aparte/plugin-compaction, @aparte/plugin-echarts, @aparte/plugin-katex, @aparte/plugin-marked, @aparte/plugin-mermaid, @aparte/plugin-model-selector, @aparte/plugin-shiki, @aparte/plugin-storage-idb, @aparte/plugin-streaming-markdown, @aparte/plugin-titler, @aparte/plugin-triggers, @aparte/angular, @aparte/react, @aparte/svelte, @aparte/vue, @aparte/docs-mcp.