arcane-os 0.43.0 → 0.45.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.43.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.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;
         }