arcane-os 0.44.0 → 0.45.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.45.0
+
+- Add public MarkdownMedia save, read, reference parsing and hydration helpers.
+  Store complete image records in application-owned DBOPFS tables outside raw
+  Markdown, with stable references and application-selected filenames. Preserve
+  JSONL/NDJSON singleton records across cold reads and backup restoration.
+- Hydrate local images independently in shared Markdown views while preserving
+  raw Markdown, external URLs, source maps and saving. Observe cancellation and
+  individual failures without removing successful sibling images. Retain print
+  resources through afterprint; explicit PrintView preparation awaits local
+  media while native beforeprint remains synchronous.
+- Apply no-retention semantics to entity-wide persistence choices as well as
+  request persist:false: complete input and response remain available to the
+  active operation, then stay outside retained transcript, recurring model
+  context, DBOPFS and memory extraction. Capture the accepted choice before
+  rendering waits and preserve original pending calls after temporary tool
+  continuations. Existing retained turns and saved history remain untouched;
+  structural sanitization applies to new durable writes only, without migration.
+- Keep image model selection, credentials, storage selection and app orchestration
+  application-owned. No model/provider/default changes are introduced.
+
 ## 0.44.0
 
 - Add stateless `generateImages` through `arcane-os/ai/twin-cloud` with

package/README.md

@@ -19,7 +19,7 @@ version-locked SDK runtime, while an integrated Arcane checkout uses its live
 `arcane/` runtime. Both profiles share the theme, packaging, event, cancellation,
 and browser run contracts while retaining their selected application layout.
 
-This checkout defines the `0.44.0` SDK contract. Applications pin one exact npm
+This checkout defines the `0.45.0` SDK contract. Applications pin one exact npm
 version and lockfile; registry state is deliberately not baked into application
 artifacts.
 

package/docs/reference/runtime-components.md

@@ -426,7 +426,8 @@ history stores each tool's required user-facing message as an ordinary
 call envelope or ID and therefore does not recreate a pending executable call
 after reload. `submitToolResult()` and `submitToolResults()` accept `status` as
 the public result term; `disposition` remains an accepted input spelling.
-When a submitted turn uses `persist:false`, Chat may show its cards while that
+When a submitted turn uses `persist:false`, or its session's Chat entity has
+`persist=false`, Chat may show its cards while that
 one operation is active, then removes them when the operation settles; neither
 the input nor response remains in the retained transcript or model context.
 This cleanup also applies to failed, cancelled, detached, or replaced-session
@@ -437,6 +438,15 @@ operation's nodes so a completion listener can start another turn safely.
 Submission code passes those card references directly when it creates them;
 reusing an operation identifier never selects earlier conversation cards for
 cleanup or timestamp updates.
+The session's terminal `retained` boolean reports its actual commit decision;
+Chat uses that decision instead of retroactively interpreting a flag changed
+for a later request. A completion listener cannot erase an earlier settled
+turn by changing the next operation's retention setting.
+Chat carries a submission's no-retention choice into its copied session request
+before any rendering wait, so re-enabling the entity before dispatch cannot
+retain that temporary input. Existing falsy entity settings retain their
+no-retention meaning; a compatible custom session without a Chat entity keeps
+its existing default behavior.
 Persistent-turn recovery and existing saved history remain unchanged.
 
 For streaming sessions, every provisional structural card and the terminal
@@ -926,6 +936,16 @@ Native PDF and inaccessible embedded viewers require their own print command.
 was produced. Closed, destroyed, or unavailable previews return `false`;
 preparation failures reject and the visible control reports a concise failure.
 
+Markdown previews resolve saved `arcane-media:` images through
+[`MarkdownMedia.js`](runtime-modules.md#markdownmediajs) before connecting IMG
+nodes. Text appears while independent image reads finish; failures leave the
+complete text and successful images visible with a concise recovery status.
+Explicit printing waits for local reads and decoding. Native Print reports
+pending media because it cannot await them. Closing or replacing a preview
+cancels display readiness without waiting for storage; URLs already retained
+by a requested print remain until `afterprint`. Original Markdown and ordinary
+external image URLs remain unchanged.
+
 `await close()` cancels pending presentation work and closes delete, file, and
 directory dialogs in that order. A settled preview keeps its rendered content,
 media, and printing available until the file dialog actually closes; refusing
@@ -1054,7 +1074,16 @@ Events: `markdown-document-ready`, `markdown-document-state`,
 `markdown-document-empty`, `markdown-document-error`, and
 `markdown-document-navigate`.
 
-Shared dependencies: [`MD.js`](runtime-modules.md#mdjs).
+Saved local image references use
+[`MarkdownMedia.js`](runtime-modules.md#markdownmediajs). Text rendering and
+the existing rendered event do not wait for image reads. The optional
+`labels.mediaError` supplies concise visible failure text while complete
+diagnostics remain in the developer console; successful images and document
+text remain visible. Replacing, clearing, failing, or destroying the document
+releases its display resources without deleting stored media. Markdown source
+and ordinary external image URLs remain unchanged.
+
+Shared dependencies: [`MD.js`](runtime-modules.md#mdjs), [`MarkdownMedia.js`](runtime-modules.md#markdownmediajs).
 
 ### Availability and normalization
 
@@ -1104,6 +1133,16 @@ when the browser dialog was requested. Completion of physical printing or PDF
 saving is not observable through this method. See
 [`PrintView.js`](runtime-modules.md#printviewjs).
 
+Saved `arcane-media:` image references are hydrated through
+[`MarkdownMedia.js`](runtime-modules.md#markdownmediajs) in detached rendered
+nodes. Source text, edit selection, source-map comments, ordinary image URLs,
+and the existing save flow remain unchanged. Image status has its own
+idle-hidden `media-status` part, separate from save status. Explicit printing
+waits for the current image reads/decoding, follows a replacement preview, and
+rechecks readiness before capture. Native Print reports still-pending media
+synchronously; it cannot wait or cancel the native dialog. Print-owned URLs
+outlive a changed or destroyed editor until `afterprint`.
+
 `configure({fit:true,followPreview:true})` opts into the two independent
 behaviors. Both options default to `false`; omitted options retain their
 previous values during reconfiguration, and explicit `false` disables either.
@@ -1140,7 +1179,7 @@ lists, quotes, and tables follow their block, while invisible source positions
 use a nearby available rendered block rather than exact glyph geometry.
 
 Public CSS parts are `editor`, `title`, `toolbar`, `input`, `preview`,
-`actions`, `status`, `print-action`, and `save-action`. Applications can make the title
+`actions`, `status`, `media-status`, `print-action`, and `save-action`. Applications can make the title
 borderless and compact through `::part(title)` while retaining its native
 editing behavior and visible keyboard focus. These parts are styling hooks,
 not slots or replacement controls.

package/docs/reference/runtime-modules.md

@@ -96,6 +96,7 @@ own asynchronous work, cancellation, and backpressure.
 | [`Mail.js`](#mailjs) | esm | Builds complete reports and prefers the native mail capability with an explicit HTTP transport fallback. | Browser/native hybrid + cloud | Mail inputs/results normalized; transport failures mixed. |
 | [`MailOutbox.mjs`](#mailoutboxmjs) | esm | Persists complete mail reports before delivery and normalizes idempotent enqueue, retry, reconciliation, and invalid-record maintenance. | Browser/native WebView or compatible injected host | Complete records, full work, cancellation, and lifecycle states normalized; storage, lock, and delivery failures coded. |
 | [`MailTransport.mjs`](#mailtransportmjs) | esm | Sends one complete mail report to a normalized HTTP(S) endpoint. | Browser/server with fetch + cloud | Normalized endpoint and transport errors; remote detail preserved. |
+| [`MarkdownMedia.js`](#markdownmediajs) | esm | Saves local Markdown images separately and resolves their stable references in rendered views. | Browser / supported native WebView | Complete image records, concurrent display reads, cancellation, and print-owned URL lifetime. |
 | [`MarkdownSpeech.js`](#markdownspeechjs) | esm | Removes repeated Markdown formatting marks from streamed narration. | Cross-host | Speech-only filtering; single marks and ordinary punctuation remain literal. |
 | [`Marked.min.js`](#markedminjs) | esm | Vendored Marked 18.0.5 Markdown lexer, parser, renderer, extension, and walk-token API. | Cross-host vendor module | Vendor-native Marked contract. |
 | [`MD.js`](#mdjs) | esm | Renders complete Markdown with Marked and optionally maps source blocks to rendered comment anchors. | Browser / native WebView | Complete raw and rendered Marked values; opt-in original-source offsets; parse errors vendor-native. |
@@ -2794,6 +2795,73 @@ import * as module from '/arcane/modules/Marked.min.js';
 console.log(Object.keys(module));
 ```
 
+## MarkdownMedia.js
+
+### Overview
+
+Stores complete images in the application's existing DBOPFS database while
+Markdown contains only a short, stable `arcane-media:` reference. Rendering
+resolves those local references into temporary display URLs. Importing the
+module starts no storage, network, provider, or rendering operation.
+
+### Public surface
+
+Public package import: `arcane-os/modules/MarkdownMedia.js`.
+
+- `await saveMarkdownMedia({blob,tableName='markdown-media',fileName})` writes
+  `{mediaType,dataUrl}` as a JSON-compatible record and returns
+  `{reference,tableName,fileName,mediaType}` only after the write completes.
+  The default filename is a new UUID followed by `.json`. There is no abort
+  option: accepted storage writes settle through the storage owner.
+- `parseMarkdownMediaReference(reference)` returns `{tableName,fileName}` for
+  a local reference, or `null` for an ordinary URL. Malformed local addresses
+  report their actual parsing error.
+- `await readMarkdownMedia(reference)` returns the complete `Blob`, using
+  only local storage and data-URL decoding; stored strings are never fetched
+  as network addresses.
+- `hydrateMarkdownMedia(root,{signal}={})` returns `{ready,destroy,retain}`
+  immediately. It includes an IMG root and descendant IMG elements, removes
+  local-reference `src` values synchronously, starts independent reads
+  together, and assigns owned object URLs. `ready` includes image decoding.
+  Use a detached fragment before connecting those images to the document.
+
+Hydration preserves Markdown source, image descriptions, ordinary URLs, and
+surrounding content. Failed reads or decodes reject `ready` with an
+`AggregateError` whose complete `failures` array contains
+`{image,reference,reason}`; successful sibling images remain visible.
+
+`destroy()` or abort settles display readiness promptly, prevents late display,
+and releases owned URLs. An already-started storage read remains observed and
+settles independently. `retain()` returns an idempotent release callback for
+printing; retained URLs survive destruction of the original view until every
+print owner releases them. Destruction never deletes stored images.
+
+Applications own record names, entry association, cleanup policy, and which
+records their existing JSON backup/export includes. Reusing the same filename
+supports an application-selected save-only retry without another generation
+request. The helper performs no existing-data migration.
+
+### Availability and normalization
+
+Browser or native WebView with the existing app-scoped DBOPFS owner, Blob,
+FileReader, object URLs, and IMG decoding. Encoding, storage, missing-record,
+parsing, and decoding errors remain observable. No Core capability is selected.
+
+### Example
+
+```javascript
+import {saveMarkdownMedia} from 'arcane-os/modules/MarkdownMedia.js';
+
+const mural = new Blob([
+    '<svg xmlns="http://www.w3.org/2000/svg" width="240" height="80"><text x="10" y="45">Octopus parking only</text></svg>'
+], {type:'image/svg+xml'});
+const {reference} = await saveMarkdownMedia({blob:mural});
+editor.insertMarkdown(`![Octopus parking only](${reference})`);
+```
+
+Here `editor` is the ready shared Markdown Editor. Its normal change/save flow
+still owns saving the Markdown; this operation saves the image record.
+
 ## MD.js
 
 ### Overview
@@ -3071,6 +3139,9 @@ assistant content in configured model context and ChatEntity/DBOPFS history.
 That assistant-only opening survives reload and empty-chat maintenance without
 a fabricated user turn. A second opening rejects as `AI_CHAT_OPENING_EXISTS`;
 an unavailable durable ChatEntity rejects as `AI_CHAT_PERSISTENCE_UNAVAILABLE`.
+If retention is disabled while the opening is being prepared, that same error
+rolls back the opening before its append; it does not leave hidden model context.
+An opening write already accepted by DBOPFS still completes normally.
 
 `send()` accepts either
 `{message:{content,role:'user'|'tool',tool_call_id?,message?,name?,status?,persist},...}`
@@ -3086,6 +3157,20 @@ the retained transcript, memory extraction, or DBOPFS. A nonpersistent response
 therefore does not open a retained structural-tool continuation. A retained
 structural tool result must use the persistence choice captured by its matching
 assistant tool call.
+An explicitly nonretained tool-result continuation uses its matching pending
+call only for that operation, then rolls back without settling or changing the
+retained call. A later retained continuation can still settle it normally.
+
+The entity-wide `session.chatEntity.persist=false` applies the same no-retention
+rule to new turns and direct entity additions; it is not a disk-only switch.
+The session captures that setting when it accepts a request and observes it
+again before accepting a durable append. Changing it later cannot bring back
+discarded inputs or responses. A write already accepted by DBOPFS finishes
+normally; toggling the setting does not undo that write or rewrite saved data.
+Completed `send()` and `stream()` responses include a session-owned `retained`
+boolean outside `message` and the provider payload, identifying whether the
+turn entered recurring history. Existing retained and stored records remain
+untouched: this boundary applies to new additions and performs no migration.
 
 `history()` returns provider-safe configured model context, including the
 system prompt and every complete ordinary visible committed turn. Only a
@@ -3263,11 +3348,16 @@ print-only surface expands scrollable content without editing the live screen.
 
 ### Public surface
 
-Named `createPrintView({host,content,title,active,priority=0,signal,onError,retain})`
+Named `createPrintView({host,content,title,active,priority=0,signal,onError,retain,prepare})`
 returns `{print,destroy}`. `host` is a connected element; synchronous callbacks
 return the rendered content node, string title, and whether the view is active.
 Optional `retain()` returns a resource-release callback. It keeps owned media
 available until preparation is cancelled or the browser emits `afterprint`.
+Optional `prepare(signal)` may await view-owned readiness during an explicit
+print request. After it settles, current content and title are read again
+synchronously immediately before capture. A view whose content changes during
+preparation must keep its owned media retained and reject a still-pending
+snapshot through its synchronous `content()` callback.
 
 `await print()` selects that view, waits for accessible HTML frame, image, and
 font readiness, and requests the browser print dialog. It returns `false` when
@@ -3281,6 +3371,8 @@ on ties. File preview uses priority `1`; editor uses `0`. Native `beforeprint`
 is synchronous: it snapshots currently rendered content, cannot await a newly
 loading resource, and cannot cancel the browser's dialog. `onError(error)` or
 the developer console receives complete preparation failures.
+Native printing never invokes the asynchronous `prepare` callback; prepared
+views still receive the synchronous content/title read at capture.
 
 `destroy()` unregisters the view and cancels pending preparation. Once the
 dialog has been requested, its snapshot and retained media remain until

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -86,7 +86,7 @@
     "test": "npm run test:unit && npm run test:functional && npm run test:integration && npm run test:regression",
     "test:release": "node ./bin/arcane-test.mjs test/npm-release.test.mjs",
     "test:unit": "node ./bin/arcane-test.mjs test/app-descriptor.test.mjs test/app-schema.test.mjs test/app-selection.test.mjs test/contracts.test.mjs test/conversation-closing-report.test.mjs test/doctor.test.mjs test/mail-credentials.test.mjs test/mail-outbox.test.mjs test/mail-public-api.test.mjs test/mail-send.test.mjs test/mail-transport.test.mjs test/targets.test.mjs test/workspace-operation-lock.test.mjs",
-    "test:functional": "node ./bin/arcane-test.mjs test/ai-request-model.test.mjs test/ai-request-retry.test.mjs test/ai-stream-cancellation.test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/chat-input.test.mjs test/chat-stream-speech.test.mjs test/chat-transcript-scroll.test.mjs test/chat-transient-retention.test.mjs test/cli.test.mjs test/continuous-voice-capture.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs-png.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/file-preview.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/markdown-editor.test.mjs test/markdown-source-map.test.mjs test/modal.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/twin-cloud-images.test.mjs test/twin-cloud.test.mjs test/update-check.test.mjs test/user-explicit-updates.test.mjs",
+    "test:functional": "node ./bin/arcane-test.mjs test/ai-request-model.test.mjs test/ai-request-retry.test.mjs test/ai-stream-cancellation.test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/chat-input.test.mjs test/chat-stream-speech.test.mjs test/chat-transcript-scroll.test.mjs test/chat-transient-retention.test.mjs test/cli.test.mjs test/continuous-voice-capture.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs-png.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/file-preview.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/markdown-editor.test.mjs test/markdown-media.test.mjs test/markdown-source-map.test.mjs test/modal.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/rendered-print.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/twin-cloud-images.test.mjs test/twin-cloud.test.mjs test/update-check.test.mjs test/user-explicit-updates.test.mjs",
     "test:integration": "node ./bin/arcane-test.mjs test/installed-package-runtime.test.mjs test/root-app-layout.test.mjs test/integrated-shared.test.mjs test/integrated-workspace.test.mjs test/mail-browser.test.mjs test/native-plan.test.mjs test/native-provider-loader.test.mjs test/npm-release.test.mjs test/release-bundle.test.mjs test/release-capability-smoke.test.mjs test/shared-payload-batch.test.mjs test/tarball.test.mjs test/browser-wasm-cpu.test.mjs test/wllama-webgpu-runtime.test.mjs",
     "test:regression": "node ./bin/arcane-test.mjs test/channel-workflows.test.mjs test/html-import-registration.test.mjs test/logging-regression.test.mjs test/markdown-speech.test.mjs test/prepared-speech.test.mjs test/native-provider-generation.test.mjs test/speech-queue-regression.test.mjs test/testing.test.mjs test/test-sets.test.mjs",
     "check": "node tools/check-source.mjs && npm test",

package/runtime/arcane/components/chat.html

@@ -3255,13 +3255,22 @@
             );
         }
 
-        const sessionRequestMessages=is.array(sessionRequest)
+        const submittedMessages=is.array(sessionRequest)
             ?sessionRequest
             :[sessionRequest];
-        if(!sessionRequestMessages.length){
+        if(!submittedMessages.length){
             throw new TypeError('A chat session request must contain at least one message.');
         }
-        const retainTurn=sessionRequestMessages.every(message=>message.persist!==false);
+        function entityRetainsMessages(){
+            return !session.chatEntity||Boolean(session.chatEntity.persist);
+        }
+        let retainTurn=submittedMessages.every(message=>message.persist!==false)
+            &&entityRetainsMessages();
+        // Preserve this submission's choice across the rendering await before
+        // dispatch; a later entity setting belongs to a later submission.
+        const sessionRequestMessages=retainTurn
+            ?submittedMessages
+            :submittedMessages.map(message=>({...message,persist:false}));
         const request={
             ...(sessionRequestMessages.length===1
                 ?{message:sessionRequestMessages[0]}
@@ -3276,9 +3285,18 @@
             ?session.aiName
             :host.aiName;
         const sessionMessageToken=Symbol(messageId);
-        const transientCards=retainTurn?[]:[...requestMessages];
+        const transientCards=[...requestMessages];
+        let retentionSettled=false;
+        function settleTurnRetention(result){
+            if(retentionSettled) return;
+            // The session reports the decision made at its actual commit boundary.
+            retainTurn=retainTurn&&(is.boolean(result?.retained)
+                ?result.retained
+                :entityRetainsMessages());
+            retentionSettled=true;
+        }
         function removeTransientSessionCards(){
-            if(!transientCards.length) return;
+            if(retainTurn||!transientCards.length) return;
             // The submitter supplies only nodes created for this submission.
             for(const card of transientCards) card.remove();
             transientCards.length=0;
@@ -3290,7 +3308,7 @@
         setSessionStatus('sending','AI is responding…');
         try{
             const responseCard=receivedMessage(responseName, '', messageId);
-            if(!retainTurn) transientCards.push(responseCard);
+            transientCards.push(responseCard);
             await streamMessage('',messageId,true);
             setMessageProgress(
                 messageId,
@@ -3344,6 +3362,7 @@
                     }
                 )
                 :await session.send(request);
+            settleTurnRetention(result);
             if(
                 destroyed
                 ||bindingGeneration!==sessionBindingGeneration
@@ -3441,6 +3460,7 @@
             );
             return result;
         }catch(error){
+            settleTurnRetention();
             if(!destroyed&&bindingGeneration===sessionBindingGeneration){
                 setPendingStructuralToolCalls(previousPendingToolCalls);
             }
@@ -3501,6 +3521,7 @@
             }
             throw error;
         }finally{
+            settleTurnRetention();
             removeTransientSessionCards();
             if(activeSessionMessageToken===sessionMessageToken){
                 activeSessionMessageToken=null;

package/runtime/arcane/components/file-manager.html

@@ -1555,6 +1555,8 @@
             generation,
             urls:new Set(),
             media:new Set(),
+            markdownMedia:new Set(),
+            markdownStatus:false,
             title:`${directory}/${fileName}`,
             rendered:null,
             printPreparation:null,
@@ -1660,6 +1662,7 @@
             status.remove();
             content.append(rendered);
             preview.rendered=rendered;
+            updateMarkdownPreviewStatus(preview);
             void preparePreviewPrint(preview).catch(function reportPrintPreparation(error){
                 reportPreviewPrintFailure(error,preview);
             });
@@ -1683,11 +1686,12 @@
                 }
                 const view=createPrintView({
                     host,
-                    content:()=>preview.rendered,
+                    content:()=>previewPrintContent(preview),
                     title:()=>preview.title,
                     active:()=>isCurrentPreview(preview)&&fileModal.opened===true,
                     priority:1,
                     signal:preview.controller.signal,
+                    prepare:function preparePreviewMedia(signal){return waitForPreviewMarkdown(preview,signal);},
                     retain:()=>retainPreviewPrintResources(preview),
                     onError:error=>reportPreviewPrintFailure(error,preview)
                 });
@@ -1703,20 +1707,93 @@
         if(!preview?.rendered||!isCurrentPreview(preview)||fileModal.opened!==true){
             return false;
         }
+        if(!await waitForPreviewMarkdown(preview)){
+            return false;
+        }
         const view=await preparePreviewPrint(preview);
         return view&&isCurrentPreview(preview)?view.print():false;
     }
 
+    async function waitForPreviewMarkdown(preview,signal){
+        signal?.throwIfAborted();
+        const results=await Promise.allSettled(
+            [...preview.markdownMedia].map(function markdownReadiness(media){
+                return media.owner.ready;
+            })
+        );
+        signal?.throwIfAborted();
+        if(!isCurrentPreview(preview)||fileModal.opened!==true){
+            return false;
+        }
+        const failures=results.filter(function failedMarkdown(result){
+            return result.status==='rejected';
+        }).map(function markdownFailure(result){
+            return result.reason;
+        });
+        if(failures.length){
+            throw new AggregateError(failures,'Local images could not be prepared for printing.');
+        }
+        return true;
+    }
+
+    function previewPrintContent(preview){
+        const failures=[];
+        for(const media of preview.markdownMedia){
+            if(!media.settled){
+                throw new Error('Local images are still loading. Use Print after they finish.');
+            }
+            if(media.error){
+                failures.push(media.error);
+            }
+        }
+        if(failures.length){
+            throw new AggregateError(failures,'Local images could not be prepared for printing.');
+        }
+        return preview.rendered;
+    }
+
+    function updateMarkdownPreviewStatus(preview){
+        if(!isCurrentPreview(preview)||!preview.rendered){
+            return;
+        }
+        if([...preview.markdownMedia].some(function failedMarkdown(media){return media.error;})){
+            preview.markdownStatus=true;
+            preview.printStatus.textContent='Some images could not be loaded. Reopen this file to try again.';
+            preview.printStatus.setAttribute('role','alert');
+            preview.container.append(preview.printStatus);
+        }else if(preview.markdownStatus&&[...preview.markdownMedia].every(function settledMarkdown(media){return media.settled;})){
+            preview.markdownStatus=false;
+            preview.printStatus.remove();
+        }
+    }
+
     function reportPreviewPrintFailure(error,preview){
         arcaneLogging.error('Unable to print file preview:',error);
         if(isCurrentPreview(preview)){
-            preview.printStatus.textContent='Unable to open print preview. Please try again.';
+            const media=[...preview.markdownMedia];
+            preview.markdownStatus=media.some(function unavailableImage(item){return !item.settled||item.error;});
+            preview.printStatus.textContent=media.some(function pendingImage(item){return !item.settled;})
+                ?'Images are still loading. Close this print dialog and use Print after they finish.'
+                :media.some(function failedImage(item){return item.error;})
+                    ?'Some images could not be loaded. Close any print dialog and reopen this file to try again.'
+                    :'Unable to open print preview. Please try again.';
             preview.printStatus.setAttribute('role','alert');
             preview.container.append(preview.printStatus);
         }
     }
 
     function retainPreviewPrintResources(preview){
+        const markdownReleases=[];
+        try{
+            for(const media of preview.markdownMedia){
+                markdownReleases.push(media.owner.retain());
+            }
+        }catch(error){
+            for(const release of markdownReleases){
+                release();
+            }
+            throw error;
+        }
         preview.printRetains+=1;
         let retained=true;
         return function releasePrintedPreviewResources(){
@@ -1724,6 +1801,9 @@
                 return;
             }
             retained=false;
+            for(const release of markdownReleases){
+                release();
+            }
             preview.printRetains-=1;
             if(preview.released&&preview.printRetains===0){
                 releasePreviewURLs(preview);
@@ -1760,6 +1840,10 @@
         }
         preview.released=true;
         preview.controller.abort(reason);
+        for(const media of preview.markdownMedia){
+            media.owner.destroy();
+        }
+        preview.markdownMedia.clear();
         for(const element of preview.media){
             if(element.localName==='audio'){
                 element.pause();
@@ -1817,10 +1901,32 @@
                 }
                 const body=document.createElement(descriptor.kind==='html'?'iframe':'div');
                 if(descriptor.kind==='markdown'){
-                    markdownModulePromise=markdownModulePromise||import('../modules/MD.js');
-                    const {default:MD}=await markdownModulePromise;
+                    markdownModulePromise=markdownModulePromise||Promise.all([
+                        import('../modules/MD.js'),
+                        import('../modules/MarkdownMedia.js')
+                    ]);
+                    const [{default:MD},{hydrateMarkdownMedia}]=await markdownModulePromise;
                     preview.controller.signal.throwIfAborted();
-                    body.innerHTML=new MD(descriptor.content).safeRendered;
+                    const template=document.createElement('template');
+                    template.innerHTML=new MD(descriptor.content).safeRendered;
+                    const owner=hydrateMarkdownMedia(template.content,{signal:preview.controller.signal});
+                    const media={owner,settled:false,error:null};
+                    preview.markdownMedia.add(media);
+                    void owner.ready.then(
+                        function markdownImagesReady(){
+                            media.settled=true;
+                            updateMarkdownPreviewStatus(preview);
+                        },
+                        function markdownImagesFailed(error){
+                            media.settled=true;
+                            media.error=error;
+                            if(isCurrentPreview(preview)){
+                                arcaneLogging.error('Unable to load local Markdown images:',error);
+                                updateMarkdownPreviewStatus(preview);
+                            }
+                        }
+                    );
+                    body.append(template.content);
                 }else{
                     body.title=descriptor.title||'HTML preview';
                     body.srcdoc=descriptor.content;

package/runtime/arcane/components/markdown-document.html

@@ -219,7 +219,10 @@
     const host=this;
     host.ready=false;
 
-    const {default:MD}=await import('../modules/MD.js');
+    const [{default:MD},{hydrateMarkdownMedia}]=await Promise.all([
+        import('../modules/MD.js'),
+        import('../modules/MarkdownMedia.js')
+    ]);
     const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
     const events=createArcaneEventSource(host,{source:'arcane.component.markdown-document',eventTypes:['markdown-document-state','markdown-document-empty','markdown-document-error','markdown-document-loading','markdown-document-rendered','markdown-document-navigate','markdown-document-ready']});
     const lifecycleController=new AbortController();
@@ -331,6 +334,7 @@
             content:'Document content',
             empty:'No document content is available.',
             error:'Unable to display this document.',
+            mediaError:'Some images could not be displayed.',
             loading:'Loading document…',
             tableOfContents:'On this page'
         },
@@ -348,6 +352,8 @@
     let operationSequence=0;
     let loadController=null;
     let destroyed=false;
+    let renderedMedia=null;
+    let mediaError=false;
 
     host.clear=clear;
     host.configure=configure;
@@ -393,7 +399,7 @@
         }
 
         const labels={...previous.labels};
-        for(const name of ['content','empty','error','loading','tableOfContents']){
+        for(const name of ['content','empty','error','mediaError','loading','tableOfContents']){
             if(labelInput[name]!==undefined){
                 if(!is.string(labelInput[name])||!labelInput[name].trim()){
                     throw new TypeError(`Markdown document labels.${name} must be a nonempty string.`);
@@ -607,6 +613,7 @@
 
         currentMarkdown=markdown;
         currentSourceURL=sourceURL;
+        releaseRenderedMedia();
         contentElement.replaceChildren();
         tableOfContents=[];
         tableOfContentsList.replaceChildren();
@@ -631,6 +638,16 @@
 
         tableOfContents=decorateHeadings(fragment);
         decorateTables(fragment);
+        // Resolve local references before connecting their IMG elements. The
+        // complete Markdown and ordinary external URLs remain unchanged.
+        const media=hydrateMarkdownMedia(fragment,{signal:lifecycleController.signal});
+        renderedMedia=media;
+        media.ready.catch(function reportMarkdownMediaFailure(error){
+            if(destroyed||renderedMedia!==media) return;
+            mediaError=true;
+            arcaneLogging.error('Markdown document image display failed.',error);
+            updateStateDOM();
+        });
         contentElement.replaceChildren(fragment);
         buildTableOfContents(tableOfContents);
         transition(
@@ -644,6 +661,13 @@
         return true;
     }
 
+    function releaseRenderedMedia(){
+        const previous=renderedMedia;
+        renderedMedia=null;
+        mediaError=false;
+        previous?.destroy();
+    }
+
     function renderedMarkdownFragment(html='',sourceURL=options.sourceURL){
         const template=document.createElement('template');
         template.innerHTML=html;
@@ -764,6 +788,7 @@
         const operationId=`${events.descriptor.instanceId}:clear:${++operationSequence}`;
         currentMarkdown='';
         currentSourceURL=options.sourceURL;
+        releaseRenderedMedia();
         contentElement.replaceChildren();
         tableOfContents=[];
         tableOfContentsList.replaceChildren();
@@ -781,6 +806,7 @@
 
     function showError(error,operationId=null){
         currentMarkdown='';
+        releaseRenderedMedia();
         contentElement.replaceChildren();
         tableOfContents=[];
         tableOfContentsList.replaceChildren();
@@ -839,7 +865,7 @@
         host.setAttribute('aria-busy',String(loadingState));
         host.dataset.state=state;
         statusElement.dataset.state=state;
-        statusElement.hidden=readyState;
+        statusElement.hidden=readyState&&!mediaError;
         contentElement.hidden=!readyState;
         tableOfContentsElement.hidden=(
             !readyState
@@ -851,7 +877,7 @@
             empty:options.labels.empty,
             error:options.labels.error,
             loading:options.labels.loading,
-            ready:''
+            ready:mediaError?options.labels.mediaError:''
         }[state]||'';
     }
 
@@ -948,6 +974,7 @@
         lifecycleController.abort('markdown-document-destroyed');
         currentMarkdown='';
         tableOfContents=[];
+        releaseRenderedMedia();
         contentElement.replaceChildren();
         tableOfContentsList.replaceChildren();
         events.dispose();

package/runtime/arcane/components/markdown-editor.html

@@ -63,6 +63,10 @@
         margin-right:auto;
     }
 
+    .media-status:empty{
+        display:none;
+    }
+
     .markdown-editor.fit{
         height:100%;
         min-height:0;
@@ -118,6 +122,7 @@
     <textarea id="entryMarkdown" class="entry-markdown" part="input"></textarea>
     <section class="actions" part="actions">
         <span id="status" class="status" part="status" aria-live="polite"></span>
+        <span id="mediaStatus" class="media-status" part="media-status" aria-live="polite"></span>
         <button id="print" part="print-action" type="button">Print</button>
         <button id="save" part="save-action" type="button" disabled></button>
     </section>
@@ -130,7 +135,10 @@
     const {arcaneLogging}=await import('arcane-os/logging');
 
     const host=this;
-    const {default:MD}=await import('../modules/MD.js');
+    const [{default:MD},{hydrateMarkdownMedia}]=await Promise.all([
+        import('../modules/MD.js'),
+        import('../modules/MarkdownMedia.js')
+    ]);
     const {
         applyMarkdownFormat,
         normalizeMarkdownOptions
@@ -146,9 +154,12 @@
     const saveButton=host.shadowRoot.querySelector('#save');
     const printButton=host.shadowRoot.querySelector('#print');
     const status=host.shadowRoot.querySelector('#status');
+    const mediaStatus=host.shadowRoot.querySelector('#mediaStatus');
 
     let previewFrame=0;
     let previewFollowPending=false;
+    let previewMedia=null;
+    let printMediaRetains=null;
     let operationSequence=0;
     let saveGeneration=0;
     let saveController=null;
@@ -166,6 +177,8 @@
                 title:()=>titleInput.value,
                 active:()=>!destroyed&&host.isConnected&&host.getClientRects().length>0,
                 signal:lifecycleController.signal,
+                retain:retainPrintMedia,
+                prepare:preparePrintMedia,
                 onError:reportPrintFailure
             });
         }
@@ -401,7 +414,41 @@
         const scrollTop=preview.scrollTop;
         const scrollLeft=preview.scrollLeft;
         const markdown=new MD(textarea.value,{sourceMap:options.followPreview});
-        preview.innerHTML=markdown.safeRendered;
+        const template=document.createElement('template');
+        template.innerHTML=markdown.safeRendered;
+        const pending=[...template.content.querySelectorAll('img')].some(
+            image=>image.getAttribute('src')?.startsWith('arcane-media:')
+        );
+        // Hydration removes custom src values before these nodes join the live DOM.
+        const handle=hydrateMarkdownMedia(template.content,{signal:lifecycleController.signal});
+        const media={handle,pending,error:null};
+        const previous=previewMedia;
+        previewMedia=media;
+        if(printMediaRetains){
+            // The print owner may still be awaiting its final current snapshot.
+            printMediaRetains.add(handle.retain());
+        }
+        previous?.handle.destroy();
+        mediaStatus.innerText=pending?'Loading saved images…':'';
+        media.ready=handle.ready.then(function mediaReady(){
+            media.pending=false;
+            if(!destroyed&&previewMedia===media){
+                mediaStatus.innerText='';
+            }
+        },function mediaFailed(error){
+            media.pending=false;
+            media.error=error;
+            const cancelled=error?.name==='AbortError'||error?.failures?.every(
+                failure=>failure.reason?.name==='AbortError'
+            );
+            if(!cancelled){
+                arcaneLogging.error('Unable to display saved Markdown images:',error);
+            }
+            if(!destroyed&&previewMedia===media&&!cancelled){
+                mediaStatus.innerText='Some saved images could not be displayed.';
+            }
+        });
+        preview.replaceChildren(template.content);
         preview.querySelectorAll('a').forEach(
             link=>{
                 link.target='_blank';
@@ -589,9 +636,38 @@
     }
 
     function renderedPrintContent(){
+        if(previewFrame){
+            updatePreview(false);
+        }
+        if(previewMedia?.pending){
+            const error=new Error('Images are still loading. Print again when they finish.');
+            error.code='ARCANE_MARKDOWN_MEDIA_PENDING';
+            throw error;
+        }
+        if(previewMedia?.error){
+            throw previewMedia.error;
+        }
         return preview;
     }
 
+    function retainPrintMedia(){
+        renderedPrintContent();
+        const releases=new Set();
+        if(previewMedia){
+            releases.add(previewMedia.handle.retain());
+        }
+        printMediaRetains=releases;
+        return function releasePrintMedia(){
+            if(printMediaRetains===releases){
+                printMediaRetains=null;
+            }
+            for(const release of releases){
+                release();
+            }
+            releases.clear();
+        };
+    }
+
     async function print(){
         if(destroyed){
             return false;
@@ -600,12 +676,40 @@
         if(destroyed||!printView){
             return false;
         }
-        if(previewFrame){
-            updatePreview(false);
+        if(!await preparePrintMedia()){
+            return false;
         }
         return printView.print();
     }
 
+    async function preparePrintMedia(signal){
+        let cancel;
+        const cancelled=new Promise(function waitForCancellation(resolve){cancel=resolve;});
+        signal?.addEventListener('abort',cancel,{once:true});
+        try{
+            while(!destroyed&&!signal?.aborted){
+                if(previewFrame){
+                    updatePreview(false);
+                }
+                const media=previewMedia;
+                await Promise.race([media.ready,cancelled]);
+                if(destroyed||signal?.aborted){
+                    return false;
+                }
+                if(previewFrame||previewMedia!==media){
+                    continue;
+                }
+                if(media.error){
+                    throw media.error;
+                }
+                return true;
+            }
+            return false;
+        }finally{
+            signal?.removeEventListener('abort',cancel);
+        }
+    }
+
     function printFromControl(){
         void print().catch(reportPrintFailure);
     }
@@ -615,6 +719,10 @@
             return;
         }
         arcaneLogging.error('Unable to print rendered Markdown:',error);
+        if(error?.code==='ARCANE_MARKDOWN_MEDIA_PENDING'){
+            mediaStatus.innerText=error.message;
+            return;
+        }
         status.innerText='Unable to open print preview. Please try again.';
     }
 
@@ -686,6 +794,7 @@
         }
         destroyed=true;
         supersedeSave('markdown-editor-destroyed');
+        previewMedia?.handle.destroy();
         lifecycleController.abort('markdown-editor-destroyed');
         previewFollowPending=false;
         if(previewFrame){

package/runtime/arcane/entities/Chat.js

@@ -391,10 +391,12 @@ class ChatEntity{
     fileName='';
 
     /**
-     * Controls automatic persistence.
+     * Controls retention of new message additions.
      *
      * When true, any message addition automatically writes
-     * the updated message list to OPFS.
+     * the updated message list to OPFS. When false, new additions are excluded
+     * from the transcript, recurring context, storage, and memory extraction.
+     * Existing retained and saved messages remain unchanged.
      *
      * @type {boolean}
      */
@@ -1080,7 +1082,7 @@ ${JSON.stringify(transcript)}`
         if(!records.length){
             return false;
         }
-        if(!persist) return false;
+        if(!persist||!this.persist) return false;
 
         this.#messages.push(...records);
         const durableRecords=storedChatRecords(records);
@@ -1088,7 +1090,7 @@ ${JSON.stringify(transcript)}`
             this.#saved=false;
         }
 
-        if(!this.persist||!durableRecords.length){
+        if(!durableRecords.length){
             return;
         }
 

package/runtime/arcane/modules/MarkdownMedia.js

@@ -0,0 +1,211 @@
+import Is from 'strong-type';
+
+const is = new Is(false);
+const referencePrefix = 'arcane-media:';
+
+/** Return the local record address, or null for an ordinary image URL. */
+export function parseMarkdownMediaReference(reference) {
+    if (!is.string(reference) || !reference.startsWith(referencePrefix)) {
+        return null;
+    }
+    const address = reference.substring(referencePrefix.length);
+    const separator = address.indexOf('/');
+    if (separator < 0) {
+        throw new TypeError('A Markdown media reference needs a table and filename.');
+    }
+    return {
+        tableName: decodeURIComponent(address.substring(0, separator)),
+        fileName: decodeURIComponent(address.substring(separator + 1))
+    };
+}
+
+/**
+ * Save a complete image in the app's existing DBOPFS database. The returned
+ * reference belongs in Markdown; the JSON-compatible record belongs in its
+ * separate table so the existing database backup can include it unchanged.
+ * Applications own filename reuse, entry association, and export selection.
+ * The promise settles the durable write; this operation has no abort option.
+ */
+export async function saveMarkdownMedia({
+    blob,
+    tableName = 'markdown-media',
+    fileName = `${crypto.randomUUID()}.json`
+}) {
+    const reference = `${referencePrefix}${encodeURIComponent(tableName)}/${encodeURIComponent(fileName)}`;
+    const encoding = new Promise(function encodeImage(resolve, reject) {
+        const reader = new FileReader();
+        reader.onload = function imageEncoded() {
+            resolve(reader.result);
+        };
+        reader.onerror = function imageEncodingFailed() {
+            reject(reader.error || new Error('Image encoding failed.'));
+        };
+        reader.onabort = function imageEncodingAborted() {
+            reject(new DOMException('Image encoding was aborted.', 'AbortError'));
+        };
+        reader.readAsDataURL(blob);
+    });
+    const [dataUrl, {default: DBOPFS}] = await Promise.all([
+        encoding,
+        import('./DBOPFS.js')
+    ]);
+    const mediaType = blob.type || 'application/octet-stream';
+    await new DBOPFS().set(tableName, fileName, {mediaType, dataUrl});
+    return {
+        reference,
+        tableName,
+        fileName,
+        mediaType
+    };
+}
+
+/** Read the complete local image for display or application-owned export. */
+export async function readMarkdownMedia(reference) {
+    const address = parseMarkdownMediaReference(reference);
+    if (!address) {
+        throw new TypeError('Expected an arcane-media: reference.');
+    }
+    const {default: DBOPFS} = await import('./DBOPFS.js');
+    const stored = await new DBOPFS().get(address.tableName, address.fileName);
+    if (stored === null || stored === undefined) {
+        throw new DOMException(`Markdown image was not found: ${reference}`, 'NotFoundError');
+    }
+    // DBOPFS parses JSONL/NDJSON as record arrays; restoring a parsed backup can
+    // wrap its one record again. Never choose one image from multiple records.
+    let record = is.string(stored) ? JSON.parse(stored) : stored;
+    while (is.array(record) && record.length === 1) record = record[0];
+    const encoded = /^data:[^,]*;base64,([\s\S]*)$/u.exec(record?.dataUrl);
+    if (!encoded) {
+        throw new TypeError(`Markdown image has an unreadable data URL: ${reference}`);
+    }
+    // Decode locally; a stored string is never passed to Fetch or a network API.
+    const decoded = atob(encoded[1]);
+    const content = Uint8Array.from(decoded, function imageCharacter(character) {
+        return character.charCodeAt(0);
+    });
+    return new Blob([content], {type: record.mediaType});
+}
+
+/**
+ * Resolve only local Markdown IMG references beneath a rendered root (including
+ * an IMG root). Markdown source and ordinary URLs are never changed. Independent
+ * reads start together; ready waits for decoding or display cancellation.
+ * Failures reject with AggregateError.failures [{image, reference, reason}];
+ * successful siblings remain visible until their owner is destroyed.
+ *
+ * destroy() prevents late assignments and releases owned object URLs. A print
+ * owner calls retain() before copying the rendered DOM and releases its returned
+ * idempotent callback after printing, allowing URLs to outlive the source view.
+ * Abort promptly rejects display readiness. An already-started DBOPFS read
+ * remains observed and settles independently; its late result is not displayed.
+ */
+export function hydrateMarkdownMedia(root, {signal} = {}) {
+    const images = [...root.querySelectorAll('img')];
+    if (root.localName === 'img') images.unshift(root);
+    const owned = [];
+    const displayCancellations = new Set();
+    let destroyed = false;
+    let retainers = 0;
+    let destructionReason;
+
+    function releaseURLs() {
+        if (!destroyed || retainers > 0) return;
+        for (const {image, url} of owned) {
+            if (image.getAttribute('src') === url) image.removeAttribute('src');
+            URL.revokeObjectURL(url);
+        }
+        owned.length = 0;
+    }
+
+    function destroy() {
+        if (destroyed) return;
+        destroyed = true;
+        destructionReason = signal?.aborted
+            ? signal.reason
+            : new DOMException('Markdown media display was destroyed.', 'AbortError');
+        signal?.removeEventListener('abort', destroy);
+        for (const cancel of displayCancellations) cancel();
+        displayCancellations.clear();
+        releaseURLs();
+    }
+
+    function retain() {
+        if (destroyed) throw destructionReason;
+        retainers += 1;
+        let released = false;
+        return function releaseMarkdownMedia() {
+            if (released) return;
+            released = true;
+            retainers -= 1;
+            releaseURLs();
+        };
+    }
+
+    function waitForDisplay(operation) {
+        return new Promise(function observeDisplayOperation(resolve, reject) {
+            let settled = false;
+            function settle(callback, value) {
+                if (settled) return;
+                settled = true;
+                displayCancellations.delete(cancelDisplay);
+                callback(value);
+            }
+            function cancelDisplay() {
+                settle(reject, destructionReason);
+            }
+            displayCancellations.add(cancelDisplay);
+            // Both outcomes remain observed after display cancellation; this
+            // wait does not claim to cancel the underlying storage or decode.
+            Promise.resolve(operation).then(
+                function displayOperationFinished(value) {settle(resolve, value);},
+                function displayOperationFailed(error) {settle(reject, error);}
+            );
+            if (destroyed) cancelDisplay();
+        });
+    }
+
+    async function loadImage(image, reference) {
+        if (destroyed) throw destructionReason;
+        const blob = await waitForDisplay(readMarkdownMedia(reference));
+        if (destroyed) throw destructionReason;
+        const url = URL.createObjectURL(blob);
+        owned.push({image, url});
+        image.setAttribute('src', url);
+        await waitForDisplay(image.decode());
+        if (destroyed) throw destructionReason;
+    }
+
+    signal?.addEventListener('abort', destroy, {once: true});
+    if (signal?.aborted) destroy();
+    const pending = [];
+    for (const image of images) {
+        const reference = image.getAttribute('src');
+        if (!is.string(reference) || !reference.startsWith(referencePrefix)) continue;
+        // Remove the custom scheme before the first asynchronous storage wait.
+        if (!destroyed) image.removeAttribute('src');
+        pending.push({image, reference, operation: loadImage(image, reference)});
+    }
+    const ready = Promise.allSettled(pending.map(function imageOperation(item) {
+        return item.operation;
+    })).then(function imagesSettled(results) {
+        const failures = [];
+        for (const [index, result] of results.entries()) {
+            if (result.status === 'rejected') {
+                failures.push({
+                    image: pending[index].image,
+                    reference: pending[index].reference,
+                    reason: result.reason
+                });
+            }
+        }
+        if (failures.length > 0) {
+            const error = new AggregateError(failures.map(function imageFailure(failure) {
+                return failure.reason;
+            }), 'Some local Markdown images could not be displayed.');
+            error.failures = failures;
+            throw error;
+        }
+        if (destroyed) throw destructionReason;
+    });
+    return {ready, destroy, retain};
+}

package/runtime/arcane/modules/PersistentAIChatSession.js

@@ -556,6 +556,7 @@ class PersistentAIChatSession{
     /** Persists one model-authored opening while retaining none of its bootstrap request. */
     async open(input){
         const settings=normalizeOpening(input);
+        const retainOpening=this.#entity.persist===true;
         const name=this.aiName;
         if(this.#pending){
             throw coded(new Error('A chat request is already active for this session.'),'AI_CHAT_BUSY');
@@ -565,7 +566,7 @@ class PersistentAIChatSession{
         try{
             await this.ready();
             if(this.#historyError)throw this.#historyError;
-            if(this.#entity.persist!==true){
+            if(!retainOpening||this.#entity.persist!==true){
                 throw coded(
                     new Error('The model-authored chat opening requires durable chat persistence.'),
                     'AI_CHAT_PERSISTENCE_UNAVAILABLE',
@@ -576,6 +577,15 @@ class PersistentAIChatSession{
                 settings.message,
                 {request:settings.request,signal:settings.signal},
             );
+            if(this.#entity.persist!==true){
+                throw coded(
+                    new Error(
+                        'The model-authored chat opening requires durable chat persistence.',
+                        {cause:prepared.response},
+                    ),
+                    'AI_CHAT_PERSISTENCE_UNAVAILABLE',
+                );
+            }
             await this.#entity.addAIMessage(
                 prepared.response.message.content,
                 {extractMemory:false,persist:true,name},
@@ -597,6 +607,7 @@ class PersistentAIChatSession{
 
     async #requestTurn(input,streamHandlers=null){
         const settings=normalizeSend(input);
+        const retainTurn=settings.messagePersist&&Boolean(this.#entity.persist);
         const name=this.aiName;
         if(this.#pending){
             throw coded(new Error('A chat request is already active for this session.'),'AI_CHAT_BUSY');
@@ -621,7 +632,7 @@ class PersistentAIChatSession{
                     if(persistence===undefined||submittedIds.has(message.tool_call_id)){
                         throw coded(new TypeError('A tool message has no unique pending structural tool call.'),'AI_CHAT_INVALID_TOOL_MESSAGE');
                     }
-                    if(persistence!==settings.messagePersist){
+                    if(retainTurn&&persistence!==settings.messagePersist){
                         throw coded(
                             new TypeError('A tool result must use the persistence of its assistant tool call.'),
                             'AI_CHAT_INCOHERENT_PERSISTENCE',
@@ -674,10 +685,10 @@ class PersistentAIChatSession{
                     );
                 }
             }
-            if(!settings.messagePersist){
+            if(!retainTurn||!this.#entity.persist){
                 prepared.rollback();
                 prepared=null;
-                return assistantDisplayResponse(result,name);
+                return {...assistantDisplayResponse(result,name),retained:false};
             }
             await this.#entity.addTurn({
                 assistantMessage:result.message,
@@ -706,10 +717,13 @@ class PersistentAIChatSession{
             }
             const transcript=this.#entity.transcript;
             const assistantRecord=transcript.at(-1);
-            return assistantDisplayResponse(
-                committed,name,
-                assistantRecord?.role==='assistant'?assistantRecord.timestamp:undefined,
-            );
+            return {
+                ...assistantDisplayResponse(
+                    committed,name,
+                    assistantRecord?.role==='assistant'?assistantRecord.timestamp:undefined,
+                ),
+                retained:true,
+            };
         }catch(error){
             prepared?.rollback();
             throw error;

package/runtime/arcane/modules/PrintView.js

@@ -5,8 +5,9 @@ const registries=new WeakMap();
 let fontSequence=0;
 
 /**
- * Print current rendered DOM. Callbacks are synchronous; retain() may return a
- * resource release function. print() reports a browser request, never an output.
+ * Print current rendered DOM. prepare(signal) may await explicit-print readiness;
+ * other callbacks are synchronous. retain() may return a resource release function.
+ * print() reports a browser request, never an output.
  * Native beforeprint cannot await readiness or cancel the browser's dialog.
  */
 export function createPrintView({
@@ -17,7 +18,8 @@ export function createPrintView({
     priority=0,
     signal,
     onError,
-    retain
+    retain,
+    prepare
 }){
     if(!host?.ownerDocument||!is.function(content)||!is.function(title)
         ||!is.function(active)||!is.finite(priority)){
@@ -27,8 +29,11 @@ export function createPrintView({
         ||(retain!==undefined&&!is.function(retain))){
         throw new TypeError('Print error and resource-retention callbacks must be functions.');
     }
+    if(prepare!==undefined&&!is.function(prepare)){
+        throw new TypeError('A print preparation callback must be a function.');
+    }
     const registry=documentRegistry(host.ownerDocument);
-    const view={host,content,title,active,priority,onError,retain,destroyed:false,pending:null};
+    const view={host,content,title,active,priority,onError,retain,prepare,destroyed:false,pending:null};
     registry.views.add(view);
     signal?.addEventListener('abort',destroy,{once:true});
     if(signal?.aborted){
@@ -98,6 +103,10 @@ function documentRegistry(document){
             }
             const session=registry.session||startSession(registry,view);
             if(!session.stage){
+                if(view.prepare){
+                    session.content=readContent(view);
+                    session.title=readTitle(view);
+                }
                 capture(registry,session);
             }
             session.requested=true;
@@ -153,14 +162,8 @@ function startSession(registry,view){
         if(session.release&&!is.function(session.release)){
             throw new TypeError('A print resource-retention callback must return a release function.');
         }
-        session.content=view.content();
-        if(!session.content||!is.function(session.content.cloneNode)){
-            throw new TypeError('Print content must be a rendered DOM Node.');
-        }
-        session.title=view.title();
-        if(!is.string(session.title)){
-            throw new TypeError('A print title must be a string.');
-        }
+        session.content=readContent(view);
+        session.title=readTitle(view);
         return session;
     }catch(error){
         finishSession(registry,session);
@@ -168,6 +171,22 @@ function startSession(registry,view){
     }
 }
 
+function readContent(view){
+    const content=view.content();
+    if(!content||!is.function(content.cloneNode)){
+        throw new TypeError('Print content must be a rendered DOM Node.');
+    }
+    return content;
+}
+
+function readTitle(view){
+    const title=view.title();
+    if(!is.string(title)){
+        throw new TypeError('A print title must be a string.');
+    }
+    return title;
+}
+
 async function printRendered(registry,view){
     if(registry.session){
         throw new Error('A rendered print request is already being prepared or displayed.');
@@ -186,6 +205,23 @@ async function printRendered(registry,view){
             finishSession(registry,session);
             return false;
         }
+        if(view.prepare){
+            await abortable(view.prepare(signal),signal);
+            if(session.error){
+                throw session.error;
+            }
+            if(session.requested){
+                return true;
+            }
+            if(signal.aborted||!available(view)){
+                finishSession(registry,session);
+                return false;
+            }
+            // Read and capture together: a changing view can reject pending
+            // content synchronously without an unobserved readiness gap.
+            session.content=readContent(view);
+            session.title=readTitle(view);
+        }
         capture(registry,session);
         const images=Array.from(session.stage.shadowRoot.querySelectorAll('img'));
         await Promise.all(images.map(function readyImage(image){
@@ -224,6 +260,9 @@ async function printRendered(registry,view){
         if(cancelled){
             return false;
         }
+        if(view.prepare&&session.error){
+            throw session.error;
+        }
         throw error;
     }
 }