@jxsuite/studio 5.3.0 → 5.4.0

package/dist/studio.js

@@ -22,6 +22,19 @@ import {
   hasElementSelection,
   emptyContext,
   keyScopeStack,
+  toolSuccess,
+  toolError,
+  createToolDefinition,
+  createSessionFacts,
+  createToolContext,
+  linkCallSignal,
+  createToolRegistry,
+  openTurnLedger,
+  fileTurn,
+  writesForTurn,
+  summarizeWrites,
+  resetAiWrites,
+  turnAnchor,
   PROJECT_CONFIG_PATH,
   editorKindOf,
   editorKindsOf,
@@ -46,6 +59,8 @@ import {
   mutateUpdateProperty,
   mutateUpdateStyle,
   mutateUpdateAttribute,
+  mutateAddDef,
+  mutateRemoveDef,
   mutateUpdateProp,
   mutateUpdateFrontmatter,
   collabState,
@@ -97,7 +112,7 @@ import {
   activateTab2,
   moveTabToPane2,
   registerTabCommands2
-} from "./chunks/studio-gk2twyh4.js";
+} from "./chunks/studio-dgdm6vvt.js";
 import {
   LEVELS,
   CATEGORIES,
@@ -108,7 +123,7 @@ import {
   isPanelVisible,
   railGroups,
   railPanelSet
-} from "./chunks/studio-27q131j3.js";
+} from "./chunks/studio-fqpkpq1t.js";
 import {
   LIVE_PREVIEW,
   getNodeAtPath2,
@@ -141,17 +156,19 @@ import {
   clearSettings,
   hydrateSettings,
   watchRemoteSettings
-} from "./chunks/studio-z2smx5ce.js";
+} from "./chunks/studio-yxmmjy2a.js";
 import {
   registerPlatform2,
+  launcherSignal2,
   getPlatform2,
   hasPlatform2
-} from "./chunks/studio-6nzaktvy.js";
+} from "./chunks/studio-6pwn9j8c.js";
 import {
   effectScope,
   effect,
   reactive,
   toRaw,
+  shallowRef,
   announce,
   now,
   problems2,
@@ -178,7 +195,7 @@ import {
   bufferMovedOn2,
   commitTabBuffers2,
   tabBufferUnsaved2
-} from "./chunks/studio-wnsyffg1.js";
+} from "./chunks/studio-6vg0x5fz.js";
 import {
   loadMonaco,
   loadedMonaco,
@@ -192,7 +209,7 @@ import {
   formatByName2,
   formatForPath2,
   formatSerialize2
-} from "./chunks/studio-6gryj0sg.js";
+} from "./chunks/studio-9vsvz7w7.js";
 import {
   parseJsonDocument,
   serializeJson,
@@ -234,14 +251,14 @@ import {
   toggleActivityTab,
   resetProjectShell,
   registerShellViewCommands
-} from "./chunks/studio-fzjx96t2.js";
+} from "./chunks/studio-mfkh1q8d.js";
 import {
   componentMetaFrom,
   componentRegistry2,
   loadComponentRegistry2,
   noteComponentSaved2,
   buildComponentInstance2
-} from "./chunks/studio-zjjde71a.js";
+} from "./chunks/studio-gjj4bbfx.js";
 import {
   tabOfPane,
   derivationOfPane,
@@ -352,7 +369,7 @@ import {
   postApplyFormat2,
   postOpenSlash2,
   commitActiveEditSession2
-} from "./chunks/studio-drg8qj9k.js";
+} from "./chunks/studio-mrh0a92f.js";
 import {
   PUBLIC_DIR,
   setSkipServerFunctions,
@@ -373,7 +390,7 @@ import {
   KIT_BASE,
   setActiveRegistry,
   activeRegistry
-} from "./chunks/studio-d1n2bykn.js";
+} from "./chunks/studio-3nprwbd9.js";
 import {
   DERIVE_PRESETS,
   PRESET_LABELS,
@@ -403,7 +420,7 @@ import {
   defBadgeLabel,
   mountSignalsPanel,
   registerSignalsCommands
-} from "./chunks/studio-ye9drbk8.js";
+} from "./chunks/studio-rav5bpmp.js";
 import {
   mountsUsing,
   mountsOf,
@@ -429,7 +446,7 @@ import {
   showConfirmDialog2,
   showSaveDiscardDialog2,
   showPromptDialog2
-} from "./chunks/studio-0j7r7s9g.js";
+} from "./chunks/studio-ag3z6shb.js";
 import {
   html3,
   nothing2,
@@ -445,11 +462,11 @@ import {
   uploadAssets,
   mediaSiteUrl,
   previewFileSrc
-} from "./chunks/studio-b7xacrwe.js";
-import"./chunks/studio-gtfq1dkz.js";
+} from "./chunks/studio-sceg8ws0.js";
+import"./chunks/studio-dwdcr2e8.js";
 import {
   invalidateUsages2
-} from "./chunks/studio-nq5yf5mp.js";
+} from "./chunks/studio-557bmn0x.js";
 import {
   hydrateProjectList,
   getProjectList,
@@ -471,11 +488,7 @@ import {
   registerSourceControlCommands2,
   cleanupGitPanel2,
   registerGitPanel2
-} from "./chunks/studio-xajk70w0.js";
-import"./chunks/studio-a65w20ex.js";
-import {
-  openMenu2
-} from "./chunks/studio-jt27ta6x.js";
+} from "./chunks/studio-apv9x70c.js";
 import {
   parseGridTabId,
   gridTabLabel,
@@ -501,22 +514,26 @@ import {
   exportFile2,
   confirmFileDelete2,
   renamePromptMessage2
-} from "./chunks/studio-ke09tn9k.js";
+} from "./chunks/studio-y49b6mjv.js";
+import"./chunks/studio-vd67b66d.js";
+import {
+  openMenu2
+} from "./chunks/studio-mt79tn56.js";
 import {
   platformSupportsPublish,
   latestDeployment,
   currentDeploy,
   noteDeployment
-} from "./chunks/studio-nsgw7dbk.js";
+} from "./chunks/studio-xrbfdxgk.js";
 import {
   resetIgnoreCache,
   startFsSync2
-} from "./chunks/studio-4c041r8y.js";
+} from "./chunks/studio-40z39dme.js";
 import {
   beginActivity,
   registerActivityPanel,
   showProgressModal
-} from "./chunks/studio-cgprcdxn.js";
+} from "./chunks/studio-4998spet.js";
 import {
   _defineProperty,
   combine,
@@ -545,12 +562,12 @@ import {
   createLibrarySource,
   openLibraryTab,
   registerGridCommands
-} from "./chunks/studio-50wfwy44.js";
+} from "./chunks/studio-9wm0xzpf.js";
 import {
   DRAFT_FIELD,
   isDraftEntry
-} from "./chunks/studio-j0w60gft.js";
-import"./chunks/studio-msc1ee1m.js";
+} from "./chunks/studio-ygvr9e4q.js";
+import"./chunks/studio-sjas5b3a.js";
 import {
   computeWindow
 } from "./chunks/studio-a5h5j33a.js";
@@ -577,11 +594,11 @@ import {
   reloadCleanTab2,
   reloadFileInTab2,
   registerFilesPanel2
-} from "./chunks/studio-7rrb1esn.js";
+} from "./chunks/studio-m58xn8at.js";
 import {
   REDIRECT_STATUSES,
   referenceTarget
-} from "./chunks/studio-4f3psrk1.js";
+} from "./chunks/studio-w7gpcvfj.js";
 import"./chunks/studio-tjjk7jvk.js";
 import {
   FIELD_TYPES,
@@ -597,7 +614,7 @@ import {
   renderEntryMode,
   createEntry2,
   registerContentCommands2
-} from "./chunks/studio-151w0xnh.js";
+} from "./chunks/studio-482eeazk.js";
 import {
   notifySettingsDocument2,
   onSettingsDocumentChanged2,
@@ -627,11 +644,11 @@ import {
   renderStylebookMode,
   selectStylebookTag,
   defaultCommands
-} from "./chunks/studio-nfx354t1.js";
+} from "./chunks/studio-bh47w0cy.js";
 import {
   openPopoverSurface,
   invalidateMediaCache2
-} from "./chunks/studio-6kvgrkrp.js";
+} from "./chunks/studio-rwmmbrth.js";
 import {
   findEnclosingRepeater,
   convertToComponent,
@@ -674,11 +691,11 @@ import {
   liveElementCommands,
   dismissContextMenu,
   showContextMenu
-} from "./chunks/studio-b66rsh78.js";
+} from "./chunks/studio-ne593z1j.js";
 import {
   initQuickSearch2,
   openQuickSearch2
-} from "./chunks/studio-g33v4fe9.js";
+} from "./chunks/studio-jfhxy8h3.js";
 import {
   initCssData,
   registerStyleCommands,
@@ -686,7 +703,7 @@ import {
   render2,
   inspectorTab2,
   setInspectorTab2
-} from "./chunks/studio-c0qgc3tn.js";
+} from "./chunks/studio-fy320dfc.js";
 import {
   validateDoc2,
   validateProjectConfig2
@@ -694,11 +711,12 @@ import {
 import {
   getOpenAiKey,
   setOpenAiKey,
-  hasOpenAiKey,
   getBaseUrl,
   storedModel,
   setModel,
   saveAiProvider,
+  aiProviderDiffers,
+  storedEquals,
   aiConnection,
   resetModelCache,
   cachedModels,
@@ -712,8 +730,8 @@ import {
   proxyModelsErrorMessage,
   preferredModel,
   fetchAvailableModels
-} from "./chunks/studio-vn5hske5.js";
-import"./chunks/studio-c04nzbby.js";
+} from "./chunks/studio-7d3c1m59.js";
+import"./chunks/studio-b9q3znz8.js";
 import {
   platformBrokersCf,
   refreshCfConnection,
@@ -723,13 +741,13 @@ import {
   revokeAccount,
   onCredentialsChanged,
   notifyCredentialsChanged
-} from "./chunks/studio-dd1qqkry.js";
+} from "./chunks/studio-qxye31h7.js";
 import {
   seedPublishConnected2
-} from "./chunks/studio-7144epdr.js";
+} from "./chunks/studio-w475cbf9.js";
 import {
   selectContributedEntry
-} from "./chunks/studio-ze46gzjh.js";
+} from "./chunks/studio-01269reb.js";
 import {
   deepEqual2,
   matchChildren
@@ -751,7 +769,7 @@ import {
 import {
   entryCollections,
   collectionOfPath
-} from "./chunks/studio-rtskkm43.js";
+} from "./chunks/studio-5w26wza5.js";
 import"./chunks/studio-q0a3yk4n.js";
 import {
   resolveAssetRef,
@@ -759,7 +777,7 @@ import {
   assetContextFor,
   previewAssetSrc,
   hostAssetDeclarations
-} from "./chunks/studio-ab87phj1.js";
+} from "./chunks/studio-kwewmhhq.js";
 import {
   rectOf,
   elementAtPoint
@@ -774,7 +792,7 @@ import {
   __preload,
   __chunks
 } from "./chunks/studio-5te5tqng.js";
-__chunks(import.meta.url,["gvb32txh","3y6y0nrm","z1zd2da1","reg9eevt","h69xp9zz","42gk8ha1","np10mayv","pykwbm92","ts9cg1a4","jnvdbqva","m244w9nh","sw6en4dw","5y78e05d","nwnwdm6p","ny4zc51r","adg74qsk","5pq32t0q","knfqshrm","scpw01h8","a7b87n2c","f66nav16","epp2z3s3","1k4qrcqd","y6fr4he9","2mrptyek","3ntvq6cg","yxa81f45","gk2twyh4","27q131j3","m1p9b6c3","z2smx5ce","6nzaktvy","d8z5bajd","wnsyffg1","6gryj0sg","fzjx96t2","zjjde71a","drg8qj9k","d1n2bykn","ye9drbk8","0j7r7s9g","1k325pwf","b7xacrwe","gtfq1dkz","nq5yf5mp","xajk70w0","a65w20ex","jt27ta6x","ke09tn9k","nsgw7dbk","4c041r8y","cgprcdxn","esrxgwh6","t171hxhe","50wfwy44","j0w60gft","msc1ee1m","a5h5j33a","7rrb1esn","4f3psrk1","tjjk7jvk","151w0xnh","0hqbpbd0","vhv5tgxm","nfx354t1","6kvgrkrp","b66rsh78","g33v4fe9","c0qgc3tn","fgmfksz8","vn5hske5","c04nzbby","dd1qqkry","7144epdr","ze46gzjh","wqpngpsk","98b3z07n","1tbjfqv4","rtskkm43","q0a3yk4n","ab87phj1","rs76k67r","r6xmmtfh","5te5tqng","rnyf3f8e","h4nvnjvz","n4j7qxyr","727xh0e3","3qhbg51x","km6abc6q","zdv7h8ht","nj7tnjfn","889vbnm5","2rkrsjva","1dfhry4s","1wnsqn5d","4rzvmp0m","jxsv62v7","73gfkcga","g79n01v9","mdmyx6s2","ks2zzth2","e1f24eff","tyx2kj6p","xvrfrpkb","4wbb9ct0","7e11jpa9","nqgawfks","jy4m86rv"],[["./studio.js",25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83],["./chunks/fs-events-3y6y0nrm.js",50,44,29,31,26,25],["./chunks/publish-panel-z1zd2da1.js",73,70,71,49,35,30,27,33,29,34,31,40,41,38,26,25,32],["./chunks/parse-reg9eevt.js",26,25],["./chunks/references-h69xp9zz.js",44,31,26,25],["./chunks/notify-42gk8ha1.js",32],["./chunks/workspace-np10mayv.js",27,33,29,34,31,25,32],["./chunks/monaco-buffer-pykwbm92.js",33,32],["./chunks/platform-ts9cg1a4.js",31],["./chunks/layers-jnvdbqva.js",40,41,38,26,25,32],["./chunks/lit-html-m244w9nh.js",41],["./chunks/monaco-binding-sw6en4dw.js",84,85],["./chunks/components-5y78e05d.js",36,29,31,25],["./chunks/cf-account-picker-nwnwdm6p.js",31,25,26,32,41,40,38,56,30,71,70,72],["./chunks/ws-client-ny4zc51r.js",85],["./chunks/cf-settings-adg74qsk.js",71,30,31,32],["./chunks/section-registry-5pq32t0q.js",62],["./chunks/file-ops-knfqshrm.js",48,50,79,46,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,47,40,41,38,26,25,32],["./chunks/iframe-host-scpw01h8.js",37,35,36,30,80,27,33,29,52,34,31,38,26,25,32],["./chunks/grid-view-a7b87n2c.js",31,34,25,29,27,41,40,38,32,26,65,33,42,43,55,50,44,49,35,30,51,28,48,46,47,37,36,52,53,77,79,80,81],["./chunks/media-picker-f66nav16.js",65,43,42,80,27,33,29,34,31,40,41,38,26,25,32],["./chunks/jx-validate-epp2z3s3.js",69],["./chunks/format-host-1k4qrcqd.js",34,31],["./chunks/files-y6fr4he9.js",58,57,45,56,53,43,78,54,55,48,50,79,46,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,47,40,41,38,26,25,32],["./chunks/extension-sections-2mrptyek.js",31,34,62,25,26,32,33,29,27,38,40,59,41,47,60,69,74,54,50,44,49,35,30,51,28,48,55,42,46,37,36,52,79,80],["./chunks/studio-3ntvq6cg.js"],["./chunks/studio-yxa81f45.js"],["./chunks/studio-gk2twyh4.js",32,33,31,34,25,29,87,83],["./chunks/studio-27q131j3.js",27,29,35],["./chunks/studio-m1p9b6c3.js",25],["./chunks/studio-z2smx5ce.js",31,32],["./chunks/studio-6nzaktvy.js"],["./chunks/studio-d8z5bajd.js"],["./chunks/studio-wnsyffg1.js",32],["./chunks/studio-6gryj0sg.js",31,83],["./chunks/studio-fzjx96t2.js",32,31,34,29,27,30,26,83],["./chunks/studio-zjjde71a.js",31,29],["./chunks/studio-drg8qj9k.js",31,25,29,32,33,34,27,35,36,38,52,80,81,82],["./chunks/studio-d1n2bykn.js",25,32,83],["./chunks/studio-ye9drbk8.js",31,25,29,36,37,32,33,34,27,38,35,41,40,28,46,59,52,47,65,44,87,81,83],["./chunks/studio-0j7r7s9g.js",41,38,32,26],["./chunks/studio-1k325pwf.js"],["./chunks/studio-b7xacrwe.js",26,31,32,29,27,38,80],["./chunks/studio-gtfq1dkz.js",31,38,42],["./chunks/studio-nq5yf5mp.js",31,26],["./chunks/studio-xajk70w0.js",41,26,31,34,29,27,32,42,40,38,43,35,28,56,51,37,53,81,83],["./chunks/studio-a65w20ex.js",31,25,29,34],["./chunks/studio-jt27ta6x.js",38,40,32,81],["./chunks/studio-ke09tn9k.js",31,25,26,44,32,34,29,27,42,38,40,47,35,49,37,50,51,79],["./chunks/studio-nsgw7dbk.js",31,29,32,35,38,40],["./chunks/studio-4c041r8y.js",31,44,29],["./chunks/studio-cgprcdxn.js",41,38,49,32,35,40,28,44],["./chunks/studio-esrxgwh6.js",83],["./chunks/studio-t171hxhe.js"],["./chunks/studio-50wfwy44.js",32,31,34,29,27,40,26,50,48,55,42],["./chunks/studio-j0w60gft.js",31,29,32,34,27,50,48,83],["./chunks/studio-msc1ee1m.js",26,32,40,38],["./chunks/studio-a5h5j33a.js",81],["./chunks/studio-7rrb1esn.js",41,26,27,40,38,32,29,31,34,50,44,35,30,51,28,48,36,52,45,42,54,47,57,78,83],["./chunks/studio-4f3psrk1.js",38,27,25,32,40,47,87],["./chunks/studio-tjjk7jvk.js"],["./chunks/studio-151w0xnh.js",34,32,29,27,26,38,40,59,55,35,48,78,87,83],["./chunks/studio-0hqbpbd0.js"],["./chunks/studio-vhv5tgxm.js"],["./chunks/studio-nfx354t1.js",29,38,40,32,27,35,36,37,83],["./chunks/studio-6kvgrkrp.js",31,29,40,32,42,43,80,81],["./chunks/studio-b66rsh78.js",41,25,29,32,33,31,27,35,28,36,38,40,64,26,37,52,39,47,44,57,79,81,83],["./chunks/studio-g33v4fe9.js",31,29,34,27,40,38,32,58],["./chunks/studio-c0qgc3tn.js",25,29,32,27,38,39,40,59,37,47,35,44,64,87],["./chunks/studio-fgmfksz8.js",101,83],["./chunks/studio-vn5hske5.js",31,30],["./chunks/studio-c04nzbby.js",30],["./chunks/studio-dd1qqkry.js",56,31,71,70,83],["./chunks/studio-7144epdr.js",38,49,31,29,32,40,71,70,83],["./chunks/studio-ze46gzjh.js",26,31,32,29,40,59,69,54,37,35],["./chunks/studio-wqpngpsk.js"],["./chunks/studio-98b3z07n.js"],["./chunks/studio-1tbjfqv4.js"],["./chunks/studio-rtskkm43.js",29,27,55],["./chunks/studio-q0a3yk4n.js"],["./chunks/studio-ab87phj1.js",31,27,38,29],["./chunks/studio-rs76k67r.js"],["./chunks/studio-r6xmmtfh.js"],["./chunks/studio-5te5tqng.js"],["./chunks/studio-rnyf3f8e.js",85],["./chunks/studio-h4nvnjvz.js"],["./chunks/index-n4j7qxyr.js",84,85,75,87],["./chunks/studio-727xh0e3.js"],["./chunks/editor-3qhbg51x.js",102],["./chunks/monaco-setup-km6abc6q.js",102,105,60,63,101,82,83],["./chunks/quick-search-zdv7h8ht.js",67,58,57,45,56,53,43,78,54,55,48,50,79,46,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,47,40,41,38,26,25,32],["./chunks/adapter-nj7tnjfn.js",52],["./chunks/right-panel-889vbnm5.js",68,64,39,65,43,59,46,28,44,37,35,36,30,42,80,27,33,29,52,34,31,47,40,41,38,26,25,32,60],["./chunks/git-panel-2rkrsjva.js",45,56,53,43,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,40,41,38,26,25,32],["./chunks/menu-1dfhry4s.js",47,40,41,38,26,25,32],["./chunks/entry-commands-1wnsqn5d.js",61,78,59,55,48,50,79,46,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,47,40,41,38,26,25,32,60],["./chunks/content-source-4rzvmp0m.js",55,48,50,79,46,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,47,40,41,38,26,25,32],["./chunks/convert-to-repeater-jxsv62v7.js",25,29,32,33,31,34,27,41,40,38,26,37,39,59,60,28,30,35,36,52,46,47,65,42,43,44,80],["./chunks/layers-panel-73gfkcga.js",66,64,39,65,57,43,59,79,46,28,44,37,35,36,30,42,80,27,33,29,52,34,31,47,40,41,38,26,25,32,60],["./chunks/2020-g79n01v9.js",106,83],["./chunks/index-mdmyx6s2.js",106,83],["./chunks/studio-ks2zzth2.js"],["./chunks/studio-e1f24eff.js"],["./chunks/jsonMode-tyx2kj6p.js",102,107,105],["./chunks/javascript-xvrfrpkb.js",102],["./chunks/studio-4wbb9ct0.js",102,83],["./chunks/studio-7e11jpa9.js",83],["./chunks/studio-nqgawfks.js",102,105],["./chunks/tsMode-jy4m86rv.js",102,107,105]],0);
+__chunks(import.meta.url,["eq7zkzt2","z2gg8qjt","ak6hxfma","reg9eevt","f7bdv3z5","42gk8ha1","b9k2frks","jaq1t9zj","fnchmhy7","s6mc01ry","m244w9nh","e8d9wzyk","xm826zjw","3f08rry6","erze4czt","m79r7p5y","5pq32t0q","3xan8mnj","psetcv20","qaqer9kr","nhn6rv4w","epp2z3s3","mym8qnd0","egsb0ry8","r73an5s6","3ntvq6cg","yxa81f45","dgdm6vvt","fqpkpq1t","m1p9b6c3","yxmmjy2a","6pwn9j8c","d8z5bajd","6vg0x5fz","9vsvz7w7","mfkh1q8d","gjj4bbfx","mrh0a92f","3nprwbd9","rav5bpmp","ag3z6shb","1k325pwf","sceg8ws0","dwdcr2e8","557bmn0x","apv9x70c","y49b6mjv","vd67b66d","mt79tn56","xrbfdxgk","40z39dme","4998spet","esrxgwh6","t171hxhe","9wm0xzpf","ygvr9e4q","sjas5b3a","a5h5j33a","m58xn8at","w7gpcvfj","tjjk7jvk","482eeazk","0hqbpbd0","vhv5tgxm","bh47w0cy","rwmmbrth","ne593z1j","jfhxy8h3","fy320dfc","fgmfksz8","7d3c1m59","b9q3znz8","qxye31h7","w475cbf9","01269reb","wqpngpsk","98b3z07n","1tbjfqv4","5w26wza5","q0a3yk4n","kwewmhhq","rs76k67r","r6xmmtfh","5te5tqng","0a4gncx0","ptfcxkz5","9yjae3hz","aj9drheq","ddy019sn","gsjdysze","c63mkt3b","nj7tnjfn","t5n8wttg","a05atk6q","8j4qxjrp","64nb2a9a","jt7rbcbc","vg38bq99","83a16ytx","g79n01v9","mdmyx6s2","ks2zzth2","0d4p4wxj","zs88v0wr","hr5sg57n","1tejxvba","7e11jpa9","fbcyz234","ay4c78ne"],[["./studio.js",25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83],["./chunks/fs-events-z2gg8qjt.js",50,44,29,31,26,25],["./chunks/publish-panel-ak6hxfma.js",73,70,71,49,35,30,27,33,29,34,31,40,41,38,26,25,32],["./chunks/parse-reg9eevt.js",26,25],["./chunks/references-f7bdv3z5.js",44,31,26,25],["./chunks/notify-42gk8ha1.js",32],["./chunks/workspace-b9k2frks.js",27,33,29,34,31,25,32],["./chunks/monaco-buffer-jaq1t9zj.js",33,32],["./chunks/platform-fnchmhy7.js",31],["./chunks/layers-s6mc01ry.js",40,41,38,26,25,32],["./chunks/lit-html-m244w9nh.js",41],["./chunks/monaco-binding-e8d9wzyk.js",84,85],["./chunks/components-xm826zjw.js",36,29,31,25],["./chunks/cf-account-picker-3f08rry6.js",31,25,26,32,41,40,38,56,30,71,70,72],["./chunks/ws-client-erze4czt.js",85],["./chunks/cf-settings-m79r7p5y.js",71,30,31,32],["./chunks/section-registry-5pq32t0q.js",62],["./chunks/file-ops-3xan8mnj.js",46,50,79,47,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,48,40,41,38,26,25,32],["./chunks/iframe-host-psetcv20.js",37,35,36,30,80,27,33,29,52,34,31,38,26,25,32],["./chunks/grid-view-qaqer9kr.js",31,34,25,29,27,41,40,38,32,26,65,33,42,43,55,50,44,49,35,30,51,28,46,47,48,37,36,52,53,77,79,80,81],["./chunks/media-picker-nhn6rv4w.js",65,43,42,80,27,33,29,34,31,40,41,38,26,25,32],["./chunks/jx-validate-epp2z3s3.js",69],["./chunks/format-host-mym8qnd0.js",34,31],["./chunks/files-egsb0ry8.js",58,57,45,56,53,43,78,54,55,46,50,79,47,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,48,40,41,38,26,25,32],["./chunks/extension-sections-r73an5s6.js",31,34,62,25,26,32,33,27,29,38,40,59,41,48,60,69,74,54,50,44,49,35,30,51,28,46,55,42,47,37,36,52,79,80],["./chunks/studio-3ntvq6cg.js"],["./chunks/studio-yxa81f45.js"],["./chunks/studio-dgdm6vvt.js",32,33,31,34,25,29,87,83],["./chunks/studio-fqpkpq1t.js",27,29,35],["./chunks/studio-m1p9b6c3.js",25],["./chunks/studio-yxmmjy2a.js",31,32],["./chunks/studio-6pwn9j8c.js"],["./chunks/studio-d8z5bajd.js"],["./chunks/studio-6vg0x5fz.js",32],["./chunks/studio-9vsvz7w7.js",31,83],["./chunks/studio-mfkh1q8d.js",32,27,31,34,29,30,26,83],["./chunks/studio-gjj4bbfx.js",31,29],["./chunks/studio-mrh0a92f.js",31,25,29,32,33,27,34,35,36,38,52,80,81,82],["./chunks/studio-3nprwbd9.js",25,32,83],["./chunks/studio-rav5bpmp.js",31,25,29,36,37,32,33,27,34,38,35,41,40,28,47,59,52,48,65,44,87,81,83],["./chunks/studio-ag3z6shb.js",41,38,32,26],["./chunks/studio-1k325pwf.js"],["./chunks/studio-sceg8ws0.js",26,31,32,27,29,38,80],["./chunks/studio-dwdcr2e8.js",31,38,42],["./chunks/studio-557bmn0x.js",31,26],["./chunks/studio-apv9x70c.js",41,26,31,34,29,27,32,42,40,38,43,35,28,56,51,37,53,81,83],["./chunks/studio-y49b6mjv.js",31,25,26,44,32,27,34,29,42,38,40,48,35,49,37,50,51,79],["./chunks/studio-vd67b66d.js",31,25,29,34],["./chunks/studio-mt79tn56.js",38,40,32,81],["./chunks/studio-xrbfdxgk.js",31,29,32,35,38,40],["./chunks/studio-40z39dme.js",31,44,29],["./chunks/studio-4998spet.js",41,38,49,32,35,40,28,44],["./chunks/studio-esrxgwh6.js",83],["./chunks/studio-t171hxhe.js"],["./chunks/studio-9wm0xzpf.js",32,27,31,34,29,40,26,50,46,55,42],["./chunks/studio-ygvr9e4q.js",31,29,32,27,34,50,46,83],["./chunks/studio-sjas5b3a.js",26,32,40,38],["./chunks/studio-a5h5j33a.js",81],["./chunks/studio-m58xn8at.js",41,26,27,40,38,32,29,31,34,50,44,35,30,51,28,46,36,52,45,42,54,48,57,78,83],["./chunks/studio-w7gpcvfj.js",38,27,25,32,40,48,87],["./chunks/studio-tjjk7jvk.js"],["./chunks/studio-482eeazk.js",34,32,27,29,26,38,40,59,55,35,46,78,87,83],["./chunks/studio-0hqbpbd0.js"],["./chunks/studio-vhv5tgxm.js"],["./chunks/studio-bh47w0cy.js",29,38,40,32,27,35,36,37,83],["./chunks/studio-rwmmbrth.js",31,29,40,32,42,43,80,81],["./chunks/studio-ne593z1j.js",41,25,29,32,33,27,31,35,28,36,38,40,64,26,37,52,39,48,44,57,79,81,83],["./chunks/studio-jfhxy8h3.js",31,29,34,27,40,38,32,58],["./chunks/studio-fy320dfc.js",25,29,32,27,38,39,40,59,37,48,35,44,64,87],["./chunks/studio-fgmfksz8.js",101,83],["./chunks/studio-7d3c1m59.js",31,30],["./chunks/studio-b9q3znz8.js",30],["./chunks/studio-qxye31h7.js",56,31,71,70,83],["./chunks/studio-w475cbf9.js",38,49,31,29,32,40,71,70,83],["./chunks/studio-01269reb.js",26,31,32,29,40,59,69,54,37,35],["./chunks/studio-wqpngpsk.js"],["./chunks/studio-98b3z07n.js"],["./chunks/studio-1tbjfqv4.js"],["./chunks/studio-5w26wza5.js",29,27,55],["./chunks/studio-q0a3yk4n.js"],["./chunks/studio-kwewmhhq.js",31,27,38,29],["./chunks/studio-rs76k67r.js"],["./chunks/studio-r6xmmtfh.js"],["./chunks/studio-5te5tqng.js"],["./chunks/studio-0a4gncx0.js",85],["./chunks/studio-ptfcxkz5.js"],["./chunks/index-9yjae3hz.js",84,85,75,87],["./chunks/studio-aj9drheq.js"],["./chunks/editor-ddy019sn.js",102],["./chunks/monaco-setup-gsjdysze.js",102,105,60,63,101,82,83],["./chunks/quick-search-c63mkt3b.js",67,58,57,45,56,53,43,78,54,55,46,50,79,47,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,48,40,41,38,26,25,32],["./chunks/adapter-nj7tnjfn.js",52],["./chunks/right-panel-t5n8wttg.js",68,64,39,65,43,59,47,28,44,37,35,36,30,42,80,27,33,29,52,34,31,48,40,41,38,26,25,32,60],["./chunks/git-panel-a05atk6q.js",45,56,53,43,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,40,41,38,26,25,32],["./chunks/menu-8j4qxjrp.js",48,40,41,38,26,25,32],["./chunks/entry-commands-64nb2a9a.js",61,78,59,55,46,50,79,47,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,48,40,41,38,26,25,32,60],["./chunks/content-source-jt7rbcbc.js",55,46,50,79,47,51,49,28,44,37,35,36,30,42,80,27,33,29,52,34,31,48,40,41,38,26,25,32],["./chunks/convert-to-repeater-vg38bq99.js",25,29,32,33,27,31,34,41,40,38,26,37,39,59,60,28,30,35,36,52,47,48,65,42,43,44,80],["./chunks/layers-panel-83a16ytx.js",66,64,39,65,57,43,59,79,47,28,44,37,35,36,30,42,80,27,33,29,52,34,31,48,40,41,38,26,25,32,60],["./chunks/2020-g79n01v9.js",106,83],["./chunks/index-mdmyx6s2.js",106,83],["./chunks/studio-ks2zzth2.js"],["./chunks/studio-0d4p4wxj.js"],["./chunks/jsonMode-zs88v0wr.js",102,107,105],["./chunks/javascript-hr5sg57n.js",102],["./chunks/studio-1tejxvba.js",102,83],["./chunks/studio-7e11jpa9.js",83],["./chunks/studio-fbcyz234.js",102,105],["./chunks/tsMode-ay4c78ne.js",102,107,105]],0);
 
 // ../../node_modules/ms/index.js
 var require_ms = __commonJS(function(exports, module) {
@@ -1385,6 +1403,9 @@ function stepDiff(paneId, delta) {
 function diffViewOf(paneId) {
   return _records.get(paneId)?.view ?? "visual";
 }
+function diffShowsCode(paneId, renderable) {
+  return !renderable || diffViewOf(paneId) === "code";
+}
 function setDiffView(paneId, view) {
   recordFor(paneId).view = view;
 }
@@ -1729,9 +1750,14 @@ var _repaint = () => {};
 function setDiffRepaint(repaint) {
   _repaint = repaint;
 }
+var _chromeRepaint = null;
+function setDiffChromeRepaint(repaint) {
+  _chromeRepaint = repaint;
+}
 function repaintDiffStage(paneId) {
   surfaceForPane(paneId).prevCanvasMode = null;
   _repaint(paneId);
+  _chromeRepaint?.();
 }
 function renderDiffToolbar(paneId) {
   const bar = _bars.get(paneId);
@@ -1779,7 +1805,7 @@ async function stepDiffAndReveal(paneId, delta) {
   if (!step) {
     return;
   }
-  const { hostForCanvas, measureInCanvas, revealCanvasPathIn } = await (__preload("scpw01h8"), import("./chunks/iframe-host-scpw01h8.js"));
+  const { hostForCanvas, measureInCanvas, revealCanvasPathIn } = await (__preload("psetcv20"), import("./chunks/iframe-host-psetcv20.js"));
   const measured = await Promise.all([
     step.originalPath && original ? measureInCanvas(original, step.originalPath) : null,
     step.currentPath && current ? measureInCanvas(current, step.currentPath) : null
@@ -1997,6 +2023,37 @@ function buildChangeMap(a, b, opts = {}) {
   };
 }
 
+// src/canvas/stage-scrollbar.ts
+var STAGE_SCROLLBAR_VAR = "--stage-scrollbar-w";
+function scrollbarWidthOf(scroller) {
+  return Math.max(0, scroller.offsetWidth - scroller.clientWidth);
+}
+function cellOf(surface) {
+  return surface.wrap?.closest(PANE_SELECTOR) ?? document.documentElement;
+}
+function trackStageScrollbar(surface, scroller) {
+  if (surface.stageScrollbar?.scroller === scroller) {
+    return;
+  }
+  releaseStageScrollbar(surface);
+  if (!scroller) {
+    return;
+  }
+  const cell = cellOf(surface);
+  const write = () => {
+    cell.style.setProperty(STAGE_SCROLLBAR_VAR, `${scrollbarWidthOf(scroller)}px`);
+  };
+  const observer = new ResizeObserver(write);
+  observer.observe(scroller);
+  surface.stageScrollbar = { observer, scroller };
+  write();
+}
+function releaseStageScrollbar(surface) {
+  surface.stageScrollbar?.observer.disconnect();
+  surface.stageScrollbar = null;
+  cellOf(surface).style.setProperty(STAGE_SCROLLBAR_VAR, "0px");
+}
+
 // src/collab/monaco-cursors.ts
 function cssString(value) {
   return `"${value.replaceAll("\\", String.raw`\\`).replaceAll('"', String.raw`\"`)}"`;
@@ -2047,7 +2104,7 @@ function loadGridEngine() {
   if (_engine) {
     return Promise.resolve(_engine);
   }
-  _loading ??= (__preload("a7b87n2c"), import("./chunks/grid-view-a7b87n2c.js")).then((engine) => {
+  _loading ??= (__preload("qaqer9kr"), import("./chunks/grid-view-qaqer9kr.js")).then((engine) => {
     _engine = engine;
     return engine;
   });
@@ -2066,7 +2123,7 @@ var grid_panel_default = {
     part: "grid"
   },
   style: {
-    $description: "The frame's own layout and the engine's theme, and nothing that was a class. The toolbar is a single row that never wraps: the chrome budget (§12.2) caps what may stand in it, and the count is the only thing pinned to the far end.",
+    $description: "The frame's own layout and the engine's theme, and nothing that was a class. The toolbar is a single row that never wraps: the chrome budget (studio-ui-guidelines.md §12.2) caps what may stand in it, and the count is the only thing pinned to the far end.",
     display: "flex",
     flexDirection: "column",
     height: "100%",
@@ -2518,7 +2575,7 @@ var grid_panel_default = {
                       textContent: "${state.viewLabel}"
                     }
                   ],
-                  $description: "One control for the four facets a saved view is made of, because they are only ever adjusted together (§12.2). Its label is the applied view's name, so the toolbar says what is on screen before the panel is opened."
+                  $description: "One control for the four facets a saved view is made of, because they are only ever adjusted together (studio-ui-guidelines.md §12.2). Its label is the applied view's name, so the toolbar says what is on screen before the panel is opened."
                 },
                 {
                   tagName: "jx-textfield",
@@ -2854,7 +2911,7 @@ function mountGridPanelSurface(host, view, actions) {
 var grid_views_default = {
   $schema: "https://jxsuite.com/schema/v1",
   $id: "StudioGridViews",
-  $description: "The grid's View panel: the saved views, and the four facets one of them is made of — columns, sort, grouping, and the filter the toolbar box holds. ONE control rather than four, because the chrome budget caps what may stand in a toolbar (§12.2) and these four are only ever adjusted together. There is no Apply button: every edit writes the working layout and applies immediately, so the panel is never showing something the grid is not already doing.",
+  $description: "The grid's View panel: the saved views, and the four facets one of them is made of — columns, sort, grouping, and the filter the toolbar box holds. ONE control rather than four, because the chrome budget caps what may stand in a toolbar (studio-ui-guidelines.md §12.2) and these four are only ever adjusted together. There is no Apply button: every edit writes the working layout and applies immediately, so the panel is never showing something the grid is not already doing.",
   tagName: "jx-popover",
   attributes: {
     part: "views-panel"
@@ -7021,10 +7078,10 @@ var add_repo_default = {
       color: "var(--danger)"
     },
     '& [part="access"]': {
-      $description: "The listing is bounded by what the Jx Suite GitHub App was granted, so the dialog always offers a way out of that boundary rather than only saying the list is short.",
+      $description: "The listing is bounded by what the Jx Suite GitHub App was granted, so the dialog always offers a way out of that boundary rather than only saying the list is short. `center`, not `baseline`: the `Refresh` beside the note is a small kit button, and a small kit control is layout-contained so its outset hit area adds nothing to a scrolling ancestor's overflow, which leaves it with no baseline to export; a baseline row would synthesise one from its bottom edge and drop the note and the links onto it. surface-baseline-rows.test.ts holds the rule for every surface.",
       display: "flex",
       flexWrap: "wrap",
-      alignItems: "baseline",
+      alignItems: "center",
       gap: "var(--jx-space-2)",
       paddingTop: "var(--jx-space-3)",
       borderTop: "1px solid var(--border)",
@@ -7678,10 +7735,15 @@ var welcome_default = {
       letterSpacing: "0.3px"
     },
     '& [part="section-header"]': {
+      $description: "`center`, not `baseline`: `Clear all` is a small kit button, and a small kit control is layout-contained so its outset hit area adds nothing to a scrolling ancestor's overflow, which leaves it with no baseline to export. A baseline row synthesised one from the button's bottom edge, which stood the header 33px tall with the title 10px under the button's label. The gap under the header is the HEADER's, because centring aligns MARGIN boxes: while the h2 kept its own 8px block-end margin its margin box was 26px, exactly the header's height, so `center` had nothing to move and left the h2 flush at the top with the button centred 3.6px below its baseline — a fix that measured right and still looked wrong. With the margin moved out, the two boxes are the only things in the line and they centre on each other.",
       display: "flex",
-      alignItems: "baseline",
+      alignItems: "center",
       justifyContent: "space-between",
-      gap: "var(--jx-space-4)"
+      gap: "var(--jx-space-4)",
+      marginBottom: "var(--jx-space-3)"
+    },
+    '& [part="section-header"] [part="section-title"]': {
+      marginBlockEnd: "0"
     },
     '& [part="actions"]': {
       display: "flex",
@@ -8860,7 +8922,7 @@ var tab_strip_default = {
       lineHeight: "1"
     },
     '& [part="pill"]': {
-      $description: '`.entry-pill` — the draft pill (§7.6), in `jx-tab`\'s status slot. It is ON THE CHIP and not only inside the entry editor because the mistake it prevents, publishing something you believed was private, is made while glancing at a row of tabs. "Published" is deliberately as visible as "Draft": a state you can only see one half of is a state you cannot check. The two Spectrum colours it used to name are `--jx-signal` against `--jx-bg`, which flips with the theme where a fixed yellow and a fixed black did not.',
+      $description: '`.entry-pill` — the draft pill (site-architecture.md §7.6), in `jx-tab`\'s status slot. It is ON THE CHIP and not only inside the entry editor because the mistake it prevents, publishing something you believed was private, is made while glancing at a row of tabs. "Published" is deliberately as visible as "Draft": a state you can only see one half of is a state you cannot check. The two Spectrum colours it used to name are `--jx-signal` against `--jx-bg`, which flips with the theme where a fixed yellow and a fixed black did not.',
       padding: "0 5px",
       borderRadius: "var(--radius)",
       background: "var(--bg)",
@@ -9093,7 +9155,7 @@ var tab_strip_default = {
                     textContent: "${$map.item.pill}"
                   },
                   {
-                    $description: "The pin, in the actions slot. `title` is the whole accessible name (§10): the glyph is hidden, so a matching `aria-label` would announce it twice. `tabindex` follows the tab's own selectedness, exactly as the close button's does — the strip is ONE stop in the tab order, and a control inside every chip that took the platform's default would make fifteen.",
+                    $description: "The pin, in the actions slot. `title` is the whole accessible name (studio-ui-guidelines.md §10): the glyph is hidden, so a matching `aria-label` would announce it twice. `tabindex` follows the tab's own selectedness, exactly as the close button's does — the strip is ONE stop in the tab order, and a control inside every chip that took the platform's default would make fifteen.",
                     tagName: "button",
                     attributes: {
                       slot: "actions",
@@ -10253,7 +10315,7 @@ var panel_page_default = {
       padding: "0 var(--jx-space-2)"
     },
     '& [part="row"]': {
-      $description: "§4.1's standard form row, stacked: the label sits above a control that takes the whole width. `min-width: 0` is what keeps it honest in a 240px dock (§4.6) — a field refuses to shrink below its own min-content without it.",
+      $description: "studio-ui-guidelines.md §4.1's standard form row, stacked: the label sits above a control that takes the whole width. `min-width: 0` is what keeps it honest in a 240px dock (studio-ui-guidelines.md §4.6) — a field refuses to shrink below its own min-content without it.",
       display: "flex",
       flexDirection: "column",
       alignItems: "stretch",
@@ -10269,7 +10331,7 @@ var panel_page_default = {
       color: "var(--fg-dim)"
     },
     '& [part="chip"]': {
-      $description: "§4.2's set dot: a 6px accent dot, drawn only where the value is set on this document, that clears it when pressed. A real `button` — it is pressable, and it is the row's only keyboard route to clearing — stripped of the chrome a button brings so the row still reads as a label with a dot beside it.",
+      $description: "studio-ui-guidelines.md §4.2's set dot: a 6px accent dot, drawn only where the value is set on this document, that clears it when pressed. A real `button` — it is pressable, and it is the row's only keyboard route to clearing — stripped of the chrome a button brings so the row still reads as a label with a dot beside it.",
       width: "6px",
       height: "6px",
       padding: "0",
@@ -11937,7 +11999,7 @@ function removeEntry(key) {
 }
 var _mediaPicker = null;
 function mediaPicker() {
-  _mediaPicker ??= (__preload("f66nav16"), import("./chunks/media-picker-f66nav16.js"));
+  _mediaPicker ??= (__preload("nhn6rv4w"), import("./chunks/media-picker-nhn6rv4w.js"));
   return _mediaPicker;
 }
 var ACTIONS = {
@@ -12040,28 +12102,21 @@ function registerPagePanel() {
 var doc_header_default = {
   $schema: "https://jxsuite.com/schema/v1",
   $id: "StudioDocHeader",
-  $description: "The Document Header card (§3.2 ⑧) — the artefact's own header, drawn IN the stage, once per pane. A bar naming the collection and the page's route, a column of rows, the door to Search appearance and a disclosure listing the raw head tags. ONE row vocabulary: Title, the Layout picker and every schema-driven frontmatter field are the same `row`, discriminated by `kind`, because they differ in what they COMMIT rather than in what they look like — and what they commit is `panels/frontmatter-panel.ts`'s decision, reached by the row's `key`. Nothing here knows what a content collection is, which document it is drawing, or that a page has a route: the flow hands over rows whose every field is already a string and this draws them.",
+  $description: "The Document Header card (`docs/studio/editing/frontmatter.md`) — the artefact's own header, drawn IN the stage, docked above Edit's page, once per pane. A bar naming the collection and the page's route, a column of rows, the door to Search appearance and a disclosure listing the raw head tags. ONE row vocabulary: Title, the Layout picker and every schema-driven frontmatter field are the same `row`, discriminated by `kind`, because they differ in what they COMMIT rather than in what they look like — and what they commit is `panels/frontmatter-panel.ts`'s decision, reached by the row's `key`. Nothing here knows what a content collection is, which document it is drawing, or that a page has a route: the flow hands over rows whose every field is already a string and this draws them.",
   tagName: "section",
   attributes: {
     part: "card",
     "aria-label": "Document header",
-    "data-jx-region": "${state.region}",
-    "data-placement": "${state.placement}"
+    "data-jx-region": "${state.region}"
   },
   style: {
-    $description: "The twelve `.doc-header*` rules from `styles/canvas.css` plus the row vocabulary the card used to borrow from `styles/inspector.css` (`.style-row`, `.style-row-label`, `.set-dot`) and `styles/overlays.css` (`.media-picker`, `.media-picker-thumb`). The borrowed ones are TRANSCRIBED rather than shared: the card is a document now and a class it does not emit cannot style it, and the three lit panels that still draw a `.style-row` go on owning those rules until they convert. Every `--spectrum-font-size-*` reference is re-pointed at the kit's scale — a document mounted in a pane's stage is outside `<sp-theme>`, so each of them would silently have taken its hard-coded fallback and stopped following the theme. And the PLACEMENT is an attribute rather than an ancestor class: `.doc-header-host.pinned .doc-header` reached in from the stage's own host, which a scoped style block cannot answer, so the stage's two placements arrive as `data-placement` and the card keys on itself.",
+    $description: "The twelve `.doc-header*` rules from `styles/canvas.css` plus the row vocabulary the card used to borrow from `styles/inspector.css` (`.style-row`, `.style-row-label`, `.set-dot`) and `styles/overlays.css` (`.media-picker`, `.media-picker-thumb`). The borrowed ones are TRANSCRIBED rather than shared: the card is a document now and a class it does not emit cannot style it, and the three lit panels that still draw a `.style-row` go on owning those rules until they convert. Every `--spectrum-font-size-*` reference is re-pointed at the kit's scale — a document mounted in a pane's stage is outside `<sp-theme>`, so each of them would silently have taken its hard-coded fallback and stopped following the theme. And the card has ONE shape, because it has one place: Edit docks it above the page's scroller as a band across the pane, so it is a band rather than a box. It keeps only the bottom edge that separates it from the page, because a box's border and radius would draw a card edge across a full-width strip. It used to have two placements, arriving as a `data-placement` the card keyed on, and the band look was the Design one; the attribute was read before the runtime had written it, so the band never drew.",
     display: "flex",
     flexDirection: "column",
     padding: "8px 12px 10px",
     background: "var(--bg-panel)",
-    border: "1px solid var(--border)",
-    borderRadius: "var(--radius)",
+    borderBottom: "1px solid var(--border)",
     fontFamily: "var(--jx-font-sans)",
-    '&[data-placement="pinned"]': {
-      $description: "Design draws the artboards under a pan/zoom transform, so the card is pinned above the surface at 1:1 rather than sitting in the document's own column. Pinned it is a band, not a box: it spans the stage, so the box's border and radius would draw a card edge across a full-width strip.",
-      borderWidth: "0 0 1px",
-      borderRadius: "0"
-    },
     '& [part="bar"]': {
       display: "flex",
       alignItems: "baseline",
@@ -12087,7 +12142,7 @@ var doc_header_default = {
       gap: "2px"
     },
     '& [part="row"]': {
-      $description: "§4.1's standard form row, stacked: the label sits above a control that takes the whole width. `min-width: 0` is what keeps it honest at a narrow stage (§4.6) — a field refuses to shrink below its own min-content without it, and the card is drawn inside a pane that can be half a window wide.",
+      $description: "studio-ui-guidelines.md §4.1's standard form row, stacked: the label sits above a control that takes the whole width. `min-width: 0` is what keeps it honest at a narrow stage (studio-ui-guidelines.md §4.6) — a field refuses to shrink below its own min-content without it, and the card is drawn inside a pane that can be half a window wide.",
       display: "flex",
       flexDirection: "column",
       alignItems: "stretch",
@@ -12103,7 +12158,7 @@ var doc_header_default = {
       color: "var(--fg-dim)"
     },
     '& [part="chip"]': {
-      $description: "§4.2's set dot: a 6px accent dot, drawn only where the value is set here, that clears the value when it is pressed. It is a real `button` — it is pressable, and it is the row's only keyboard route to clearing — stripped of the chrome a button brings with it so the row still reads as a label with a dot beside it.",
+      $description: "studio-ui-guidelines.md §4.2's set dot: a 6px accent dot, drawn only where the value is set here, that clears the value when it is pressed. It is a real `button` — it is pressable, and it is the row's only keyboard route to clearing — stripped of the chrome a button brings with it so the row still reads as a label with a dot beside it.",
       width: "6px",
       height: "6px",
       padding: "0",
@@ -12781,7 +12836,6 @@ var doc_header_default = {
 registerSurface("doc-header", doc_header_default);
 function project9(scope, view) {
   scope.region = view.region;
-  scope.placement = view.placement;
   scope.collection = view.collection;
   scope.route = view.route;
   scope.hasRoute = view.hasRoute;
@@ -12795,7 +12849,6 @@ function mountDocHeaderSurface(host, view, actions) {
     ...actions,
     collection: "Document",
     hasRoute: false,
-    placement: "in-column",
     rawEntries: [],
     rawOpen: false,
     rawState: "empty",
@@ -12950,7 +13003,6 @@ function viewFor(tab, paneId, card) {
   return {
     collection: collection ? collection.name : "Document",
     hasRoute: route !== null,
-    placement: card.el.dataset["placement"] === "pinned" ? "pinned" : "in-column",
     rawEntries: raw,
     rawOpen: _rawOpen.has(tab.id),
     rawState: raw.length === 0 ? "empty" : "list",
@@ -13126,7 +13178,7 @@ function makeActions(card) {
 }
 var _mediaPicker2 = null;
 function mediaPicker2() {
-  _mediaPicker2 ??= (__preload("f66nav16"), import("./chunks/media-picker-f66nav16.js"));
+  _mediaPicker2 ??= (__preload("nhn6rv4w"), import("./chunks/media-picker-nhn6rv4w.js"));
   return _mediaPicker2;
 }
 // src/surfaces/canvas-stage.json
@@ -13139,7 +13191,7 @@ var canvas_stage_default = {
     part: "stage"
   },
   style: {
-    $description: "`styles/canvas.css`'s `.panzoom-wrap`, `.canvas-panel*`, `.source-*`, `.doc-header-host`, `.content-edit-*`, `.edit-width-handle`, `.preview-stage` and `.diff-code-*` rules, keyed on `part`. Two selectors reach FOREIGN DOM and say so where they stand: `.doc-header` is the card's own root inside its host, and `.is-resizing` is written by `canvas/edit-width-drag.ts` onto the column this document draws — the same shape `grid-panel.json` uses for Tabulator's theme. The width handles are `jx-split` elements, which paint their own hover, drag and focus states; this sheet says only where they stand and how wide they are.",
+    $description: "`styles/canvas.css`'s `.panzoom-wrap`, `.canvas-panel*`, `.source-*`, `.content-edit-*`, `.edit-width-handle`, `.preview-stage` and `.diff-code-*` rules, keyed on `part`, plus the Document Header card's host. One selector reaches FOREIGN DOM and says so where it stands: `.is-resizing` is written by `canvas/edit-width-drag.ts` onto the column this document draws — the same shape `grid-panel.json` uses for Tabulator's theme. The width handles are `jx-split` elements, which paint their own hover, drag and focus states; this sheet says only where they stand and how wide they are.",
     display: "contents",
     '& [part="panzoom"]': {
       $description: "The transformed surface. `applyTransform` writes `transform` on it imperatively, so only the origin is declared here. `--boards-inset` is the Project Styles bar's clearance: that bar floats over the stage, so the boards start below it.",
@@ -13229,21 +13281,12 @@ var canvas_stage_default = {
       left: "50%",
       transform: "translateX(-50%)"
     },
-    '& [part="doc-header"][data-placement="in-column"]': {
-      $description: "Edit: the card is a block of the artefact's own column and scrolls with it, so it is part of the document rather than a strip above it.",
-      display: "block",
-      paddingBottom: "16px"
-    },
-    '& [part="doc-header"][data-placement="pinned"]': {
-      $description: "Design: the artboards are drawn under a pan/zoom transform, and a form drawn at 40% is a picture of a form — so the card sits above the surface at 1:1 and keeps its own scroll. This is the one placement that still needs a cap.",
+    '& [part="doc-header"]': {
+      $description: "Edit only: the card is docked above the page's scroller as a band across the pane at 1:1, so its width is the pane's rather than the breakpoint's, and the page scrolls under it rather than taking it along. It used to be a block of Edit's column, which made it exactly as wide as the column's breakpoint or dragged width and scrolled it off with the first screen of the page. `canvas-render.ts` stacks the stage cell when it draws one — and closes its gap, so the band's own bottom border is where the scroller clips; `flex-shrink: 0` keeps the band whole while the scroller below takes the squeeze. THE CAP IS TWO CAPS, because the band has two ways to eat the page: `40vh` is the tall-pane answer, and `50%` is the short-pane one — a percentage `max-height` resolves against this flex container, the stage cell, whose height is definite (row 2 of the pane's `auto minmax(0, 1fr)` grid), so the page always keeps half the pane however little of it the dock and the bars have left. `40vh` alone is a share of the WINDOW: with the bottom dock open in a 650px window it is most of a 280px stage, and the page was a sliver. No `z-index`: the one it had was for Design, where the band's sibling was a pan/zoom surface whose boards could paint over it. Edit's sibling is the scroller, which clips its own content, and Design draws no card at all. The shadow is the same one-edge idiom as `panel-outline.json`'s verb cluster — it reaches over the scroller's top padding, so the page reads as passing under a docked band rather than ending at a rule. No `display`, so `hidden` on the host still hides it.",
       flexShrink: "0",
-      maxHeight: "40vh",
-      overflowY: "auto"
-    },
-    '& [part="doc-header"][data-placement="pinned"] .doc-header': {
-      $description: "FOREIGN DOM: `.doc-header` is the frontmatter card's own root, mounted into this host by `panels/frontmatter-panel.ts`. Pinned, the card is a band across the stage rather than a card on it, so it loses its own rounding and keeps only the edge that separates it from the boards.",
-      borderWidth: "0 0 1px",
-      borderRadius: "0"
+      maxHeight: "min(40vh, 50%)",
+      overflowY: "auto",
+      boxShadow: "0 8px 8px -8px rgb(0 0 0 / 0.35)"
     },
     '& [part="edit-canvas"]': {
       $description: "The side gutter is LOAD-BEARING, not breathing room: the resize handles hang outside the column's own box — flex siblings with a negative margin, so they take no width from it — and this container clips horizontally, so without it the handles would be unreachable at exactly the width where dragging inward matters most. It must stay at least as wide as `EDIT_CANVAS_GUTTER` in `canvas/edit-width.ts`, which is what the drag's own ceiling subtracts. This box is also the TRACK the two `jx-split`s measure: the first ancestor of a handle that generates a box, which is why the handles are drawn here beside the column rather than inside it — inside, the column would have been the track, and the track cannot be the thing being resized.",
@@ -13330,7 +13373,7 @@ var canvas_stage_default = {
   },
   children: [
     {
-      $description: "What stands over the frame, and only ever one of the three: the Document Header card above a pan/zoom surface, the Compare bar over a comparison, or the Project Styles bar over the catalogue. Each is an empty host — the surface that fills it is mounted by the module that owns it.",
+      $description: "What stands over the frame, and only ever one of the three: the Document Header card docked above Edit's scrolling column, the Compare bar over a comparison, or the Project Styles bar over the catalogue. Each is an empty host — the surface that fills it is mounted by the module that owns it.",
       tagName: "div",
       attributes: {
         part: "lead-slot"
@@ -13343,10 +13386,10 @@ var canvas_stage_default = {
       },
       cases: {
         header: {
+          $description: "The card has ONE place, so the host says nothing about where it is. It used to carry `data-placement`, one of two, and the card read it back as the host was announced — which is before the runtime writes a node's attributes, so the card read no attribute at all and drew `in-column` even where the host said `pinned`.",
           tagName: "div",
           attributes: {
-            part: "doc-header",
-            "data-placement": "pinned"
+            part: "doc-header"
           }
         },
         toolbar: {
@@ -13427,28 +13470,6 @@ var canvas_stage_default = {
                 }
               },
               children: [
-                {
-                  $description: "Edit draws the Document Header card INSIDE the document's column, as its first block — the column's first child by contract. The width handles are not in the column at all (they stand beside it, see the frame), so nothing here can get in front of it.",
-                  tagName: "div",
-                  attributes: {
-                    part: "column-header-slot"
-                  },
-                  style: {
-                    display: "contents"
-                  },
-                  $switch: {
-                    $ref: "#/state/columnHeader"
-                  },
-                  cases: {
-                    shown: {
-                      tagName: "div",
-                      attributes: {
-                        part: "doc-header",
-                        "data-placement": "in-column"
-                      }
-                    }
-                  }
-                },
                 {
                   $prototype: "Array",
                   items: { $ref: "#/state/panels" },
@@ -13602,7 +13623,6 @@ function project10(scope, view) {
   scope.frameVars = view.frameVars;
   scope.hug = view.hug;
   scope.lead = view.lead;
-  scope.columnHeader = view.columnHeader;
   scope.handles = view.handles;
   scope.panels = view.panels;
 }
@@ -13610,7 +13630,6 @@ function mountCanvasStage(host, view, actions) {
   host.replaceChildren();
   const boards = new Map;
   const scope = reactive({
-    columnHeader: "hidden",
     frame: "boards",
     framePart: "panzoom",
     frameVars: "",
@@ -13632,7 +13651,7 @@ function mountCanvasStage(host, view, actions) {
       } else if (part && element instanceof HTMLElement) {
         const slot = attrOf(def, "data-slot");
         const named = slot === "frame" ? scope.framePart : slot === "inner" ? scope.innerPart : part;
-        actions.host(named, element, attrOf(def, "data-side") || attrOf(def, "data-placement"));
+        actions.host(named, element, attrOf(def, "data-side"));
       }
     }
   }).then((surface) => {
@@ -13976,7 +13995,6 @@ function drawStage(surface, view, entries) {
 }
 function editorStageView(frame) {
   return {
-    columnHeader: "hidden",
     frame,
     framePart: "panzoom",
     frameVars: "",
@@ -14003,7 +14021,7 @@ function disposeSourceCollab(surface) {
   surface.sourceCollabCleanup = null;
 }
 async function createSourceCollabBinding(model, editor, ctx) {
-  const { bindMonacoToYText } = await (__preload("sw6en4dw"), import("./chunks/monaco-binding-sw6en4dw.js"));
+  const { bindMonacoToYText } = await (__preload("e8d9wzyk"), import("./chunks/monaco-binding-e8d9wzyk.js"));
   const unbind = bindMonacoToYText({
     awareness: ctx.awareness,
     editors: [editor],
@@ -14046,9 +14064,6 @@ function sideMarks(marks, modified) {
     path: mark.path
   })) ?? null;
 }
-function diffShowsCode(paneId, filePath) {
-  return !canRenderComparison(filePath) || diffViewOf(paneId) === "code";
-}
 async function mountDiffEditor(surface, container, state) {
   const { paneId } = surface;
   const key = state.filePath;
@@ -14056,7 +14071,7 @@ async function mountDiffEditor(surface, container, state) {
     disposeDiffEditor(surface);
   }
   const monaco = await loadMonaco();
-  if (!mountStillWanted(container, surface.monacoDiffEditor, () => canvasModeOfPane(paneId) === "git-diff" && diffShowsCode(paneId, key))) {
+  if (!mountStillWanted(container, surface.monacoDiffEditor, () => canvasModeOfPane(paneId) === "git-diff" && diffShowsCode(paneId, canRenderComparison(key)))) {
     return;
   }
   const uris = diffModelUrisFor(paneId, key || "document.json");
@@ -14093,6 +14108,7 @@ function resetCanvasView(surface) {
     surface.centerObserver.disconnect();
     surface.centerObserver = null;
   }
+  releaseStageScrollbar(surface);
   for (const p of surface.panels) {
     p.renderScope?.stop();
     p.renderScope = null;
@@ -14103,6 +14119,7 @@ function resetCanvasView(surface) {
   canvasWrap.style.padding = "";
   canvasWrap.style.alignItems = "";
   canvasWrap.style.flexDirection = "";
+  canvasWrap.style.gap = "";
   canvasWrap.style.display = "";
   canvasWrap.style.overflow = "";
   dismissBlockActionBar();
@@ -14274,7 +14291,7 @@ function renderCanvasImpl(surface) {
     ui: tab.session.ui
   };
   const canvasMode = canvasModeOfPane(surface.paneId);
-  const wantsDocHeader = (canvasMode === "edit" || canvasMode === "design") && derivationOfPane(surface.paneId)?.kind !== "lens" && hasDocumentHeader(tab);
+  const wantsDocHeader = canvasMode === "edit" && derivationOfPane(surface.paneId)?.kind !== "lens" && hasDocumentHeader(tab);
   if (!wantsDocHeader) {
     attachDocumentHeaderHost(surface.paneId, null);
   }
@@ -14347,6 +14364,7 @@ function renderCanvasImpl(surface) {
       surface.centerObserver.disconnect();
       surface.centerObserver = null;
     }
+    releaseStageScrollbar(surface);
     detachGridPanel(surface.paneId);
     detachLibraryPane(surface.paneId);
     detachEntryPane(surface.paneId);
@@ -14361,9 +14379,9 @@ function renderCanvasImpl(surface) {
     canvasWrap.style.padding = "";
     canvasWrap.style.alignItems = "";
     canvasWrap.style.flexDirection = "";
+    canvasWrap.style.gap = "";
     canvasWrap.style.display = "";
     canvasWrap.style.overflow = "";
-    canvasWrap.style.overflow = "";
     dismissBlockActionBar();
     dismissLinkPopover();
     dismissContextMenu();
@@ -14399,7 +14417,6 @@ function renderCanvasImpl(surface) {
     canvasPanels.push(entry.panel);
     const { featureToggles: previewToggles } = S.ui;
     drawStage(surface, {
-      columnHeader: "hidden",
       frame: "boards",
       framePart: "preview-stage",
       frameVars: `--preview-w:${previewWidth}px`,
@@ -14480,7 +14497,7 @@ function renderCanvasImpl(surface) {
       canvasWrap.style.overflow = "hidden";
     }
     const renderable = canRenderComparison(gitDiffState.filePath ?? "");
-    if (diffShowsCode(surface.paneId, gitDiffState.filePath ?? "")) {
+    if (diffShowsCode(surface.paneId, renderable)) {
       if (!renderable) {
         setDiffChangeMap(surface.paneId, null);
       }
@@ -14502,7 +14519,6 @@ function renderCanvasImpl(surface) {
     const origEntry = canvasPanelEntry("git-diff-original", "Original", false, panelWidth);
     const currEntry = canvasPanelEntry("git-diff-current", "Current", false, panelWidth);
     const diffStage = drawStage(surface, {
-      columnHeader: "hidden",
       frame: "boards",
       framePart: "panzoom",
       frameVars: "",
@@ -14572,22 +14588,26 @@ function renderCanvasImpl(surface) {
     const rootTag = S.document.tagName;
     const isComponentDoc = typeof rootTag === "string" && rootTag.includes("-");
     const { featureToggles: editToggles } = S.ui;
+    canvasWrap.style.flexDirection = wantsDocHeader ? "column" : "";
+    canvasWrap.style.alignItems = wantsDocHeader ? "stretch" : "";
+    canvasWrap.style.gap = wantsDocHeader ? "0px" : "";
     drawStage(surface, {
-      columnHeader: wantsDocHeader ? "shown" : "hidden",
       frame: "boards",
       framePart: "edit-canvas",
       frameVars: "",
       handles: "shown",
       hug: isComponentDoc,
       innerPart: "edit-column",
-      lead: "none",
+      lead: wantsDocHeader ? "header" : "none",
       panels: [entry.item]
     }, [entry]).then((stage) => {
       if (!stage) {
         return;
       }
       const editColumn = stageHost(surface, "edit-column");
-      entry.panel.scrollContainer = stageHost(surface, "edit-canvas");
+      const scroller = stageHost(surface, "edit-canvas");
+      entry.panel.scrollContainer = scroller;
+      trackStageScrollbar(surface, scroller);
       if (editColumn) {
         editColumn.style.maxWidth = `${Math.round(columnWidth)}px`;
         mountEditWidthHandle(surface, stageHost(surface, "edit-handle:start") ?? undefined, editColumn, -1);
@@ -14603,9 +14623,6 @@ function renderCanvasImpl(surface) {
     canvasWrap.style.padding = "0";
     canvasWrap.style.overflow = "hidden";
   }
-  canvasWrap.style.flexDirection = wantsDocHeader ? "column" : "";
-  canvasWrap.style.alignItems = wantsDocHeader ? "stretch" : "";
-  const designLead = wantsDocHeader ? "header" : "none";
   const {
     sizeBreakpoints,
     featureQueries: _featureQueries,
@@ -14619,14 +14636,13 @@ function renderCanvasImpl(surface) {
     const label = hasBaseWidth ? `${mediaDisplayName("--")} (${baseWidth}px)` : null;
     const entry = canvasPanelEntry(hasBaseWidth ? "base" : null, label, !hasBaseWidth, hasBaseWidth ? baseWidth : undefined);
     drawStage(surface, {
-      columnHeader: "hidden",
       frame: "boards",
       framePart: "panzoom",
       frameVars: "",
       handles: "hidden",
       hug: false,
       innerPart: "boards",
-      lead: designLead,
+      lead: "none",
       panels: [entry.item]
     }, [entry]).then((stage) => {
       if (!stage) {
@@ -14662,14 +14678,13 @@ function renderCanvasImpl(surface) {
   const panelDefs = chosen.length > 0 ? chosen : allPanelDefs;
   const panelEntries = panelDefs.map((def) => canvasPanelEntry(def.name, `${def.displayName} (${def.width}px)`, false, def.width));
   const stageDrawn = drawStage(surface, {
-    columnHeader: "hidden",
     frame: "boards",
     framePart: "panzoom",
     frameVars: "",
     handles: "hidden",
     hug: false,
     innerPart: "boards",
-    lead: designLead,
+    lead: "none",
     panels: panelEntries.map((e) => e.item)
   }, panelEntries);
   const passGen = surface.renderGeneration;
@@ -14733,6 +14748,7 @@ setSurfaceTeardown((surface) => {
   disposeSourceEditor(surface);
   surface.centerObserver?.disconnect();
   surface.centerObserver = null;
+  releaseStageScrollbar(surface);
   surface.panzoomWrap = null;
   detachCanvasStage(surface);
 });
@@ -17520,7 +17536,7 @@ async function onAddPackage() {
   sync2();
   try {
     await getPlatform2().addPackage(name);
-    const { loadComponentRegistry } = await (__preload("5y78e05d"), import("./chunks/components-5y78e05d.js"));
+    const { loadComponentRegistry } = await (__preload("xm826zjw"), import("./chunks/components-xm826zjw.js"));
     await loadComponentRegistry();
     context()?.renderLeftPanel();
   } catch (error) {
@@ -17538,7 +17554,7 @@ async function onRemovePackage(pkg) {
   try {
     await getPlatform2().removePackage(pkg);
     const updated = removePackageElements(siteElements(), pkg);
-    const { loadComponentRegistry } = await (__preload("5y78e05d"), import("./chunks/components-5y78e05d.js"));
+    const { loadComponentRegistry } = await (__preload("xm826zjw"), import("./chunks/components-xm826zjw.js"));
     await loadComponentRegistry();
     await updateSiteConfig({ $elements: updated });
     context()?.renderLeftPanel();
@@ -17778,7 +17794,7 @@ var panel_problems_default = {
       overflowWrap: "anywhere"
     },
     '& [part="file-path"]': {
-      $description: 'The path is a control, not a label: it opens the file the problem is about, which is the click-through §7.1 asks for. Underlined on hover only — a permanently underlined path in a dense list reads as a paragraph of links. A plain button rather than a `jx-button`, for the reason the status bar\'s items are: what it has to look like is a line of text, and every fill, border and control height the kit draws would have to be taken back off again. Named `file-path` and not `path` because `jx-icon` puts `part="path"` on the `<path>` of every glyph it draws, so `[part="path"]` inside a row selects this button and both SVG paths beside it — a styling rule that reaches into the kit\'s own drawing, and a test or a devtools query that cannot tell them apart.',
+      $description: 'The path is a control, not a label: it opens the file the problem is about, which is the click-through §16.1 asks for. Underlined on hover only — a permanently underlined path in a dense list reads as a paragraph of links. A plain button rather than a `jx-button`, for the reason the status bar\'s items are: what it has to look like is a line of text, and every fill, border and control height the kit draws would have to be taken back off again. Named `file-path` and not `path` because `jx-icon` puts `part="path"` on the `<path>` of every glyph it draws, so `[part="path"]` inside a row selects this button and both SVG paths beside it — a styling rule that reaches into the kit\'s own drawing, and a test or a devtools query that cannot tell them apart.',
       alignSelf: "flex-start",
       maxWidth: "100%",
       overflow: "hidden",
@@ -17804,7 +17820,8 @@ var panel_problems_default = {
       }
     },
     '& [part="detail"]': {
-      $description: "The captured log the progress modal used to own. It scrolls inside the row rather than growing it, so one 400-line `bun install` failure does not become the whole panel.",
+      $description: "The captured log the progress modal used to own. It scrolls inside the row rather than growing it, so one 400-line `bun install` failure does not become the whole panel. It is the one part of a problem row that is selectable against the root's `user-select: none`: the log is what a reader pastes into a bug report, and the row offers no copy action.",
+      userSelect: "text",
       maxHeight: "180px",
       margin: "var(--jx-space-1) 0 0",
       padding: "6px",
@@ -17836,7 +17853,7 @@ var panel_problems_default = {
       flex: "none"
     },
     '& [part="empty"]': {
-      $description: "The teaching empty state, drawn here rather than borrowed from `panels/empty-state.ts`: that helper is a lit template, and a document cannot call one. What is kept is the pattern's rules (§11) — one sentence saying what the region is FOR, then where its content comes from. It offers no action, because the action that fills this region is a failure and nothing here should invite one.",
+      $description: "The teaching empty state, drawn here rather than borrowed from `panels/empty-state.ts`: that helper is a lit template, and a document cannot call one. What is kept is the pattern's rules (studio-ui-guidelines.md §11) — one sentence saying what the region is FOR, then where its content comes from. It offers no action, because the action that fills this region is a failure and nothing here should invite one.",
       display: "flex",
       flexDirection: "column",
       alignItems: "center",
@@ -18223,7 +18240,7 @@ function groupProblems(records = problems2) {
   return groups;
 }
 function openProblemPath(path) {
-  (__preload("y6fr4he9"), import("./chunks/files-y6fr4he9.js")).then((m) => m.openFileInTab(path));
+  (__preload("egsb0ry8"), import("./chunks/files-egsb0ry8.js")).then((m) => m.openFileInTab(path));
 }
 function projectRow2(record) {
   const id = record.action;
@@ -18327,7 +18344,7 @@ function registerProblemsPanel() {
 var bottom_dock_default = {
   $schema: "https://jxsuite.com/schema/v1",
   $id: "StudioBottomDock",
-  $description: "⑪ The Bottom dock's chrome as a Jx document over the kit: a real `tablist` of the dock's tabs, the button that shuts it, and ONE `tabpanel` for whichever tab is showing. Every tab names that one panel — the dock draws the selected tab's body and no other, so there is exactly one panel element and its `aria-labelledby` follows the selection, which is the same shape `surfaces/git-panel.json` uses for its two sub-tabs. It draws no tab BODY: `panels/bottom-dock.ts` keeps the panel registry, the `when` filter, the badge in each tab's label, the Logic reveal and every tab's `afterRender`, and renders the active record into the one empty `[part=\"dock-body\"]` island this document leaves for it (studio-ui-guidelines.md §9.4).",
+  $description: "The Bottom dock's chrome (studio.md §16.3) as a Jx document over the kit: a real `tablist` of the dock's tabs, the button that shuts it, and ONE `tabpanel` for whichever tab is showing. Every tab names that one panel — the dock draws the selected tab's body and no other, so there is exactly one panel element and its `aria-labelledby` follows the selection, which is the same shape `surfaces/git-panel.json` uses for its two sub-tabs. It draws no tab BODY: `panels/bottom-dock.ts` keeps the panel registry, the `when` filter, the badge in each tab's label, the Logic reveal and every tab's `afterRender`, and renders the active record into the one empty `[part=\"dock-body\"]` island this document leaves for it (studio-ui-guidelines.md §9.4).",
   tagName: "div",
   attributes: {
     part: "bottom-dock"
@@ -19182,6 +19199,28 @@ var SELF_SCROLLING_MODES = new Set([
   "preview",
   "settings"
 ]);
+function wheelBelongsInside(e, stage, pageScroller) {
+  const { target } = e;
+  let el = target instanceof Element ? target : target?.parentElement ?? null;
+  while (el && el !== stage) {
+    if (el instanceof HTMLElement && el !== pageScroller && canScrollBy(el, e.deltaX, e.deltaY)) {
+      return true;
+    }
+    el = el.parentElement;
+  }
+  return false;
+}
+function canScrollBy(el, dx, dy) {
+  const downRoom = dy > 0 && el.scrollTop < el.scrollHeight - el.clientHeight - 1;
+  const upRoom = dy < 0 && el.scrollTop > 0;
+  const acrossRoom = dx > 0 && el.scrollLeft < el.scrollWidth - el.clientWidth - 1 || dx < 0 && el.scrollLeft > 0;
+  if (!downRoom && !upRoom && !acrossRoom) {
+    return false;
+  }
+  const style = getComputedStyle(el);
+  const scrolls = (overflow) => overflow === "auto" || overflow === "scroll" || overflow === "overlay";
+  return (downRoom || upRoom ? scrolls(style.overflowY) : false) || (acrossRoom ? scrolls(style.overflowX) : false);
+}
 var _stageContext = null;
 function installStageGestures(surface) {
   const canvasWrap = surface.wrap;
@@ -19199,7 +19238,7 @@ function installStageGestures(surface) {
         return;
       }
       const sc = canvasWrap.querySelector('[part="edit-canvas"]');
-      if (sc) {
+      if (sc && !wheelBelongsInside(e, canvasWrap, sc)) {
         e.preventDefault();
         sc.scrollTop += e.deltaY;
         sc.scrollLeft += e.deltaX;
@@ -19285,7 +19324,7 @@ function stageless() {
 var pane_context_default = {
   $schema: "https://jxsuite.com/schema/v1",
   $id: "StudioPaneContext",
-  $description: "The pane's own chrome — region ⑦ (the context bar) and region ⑩ (the floating zoom pod), one mount per pane. It replaces `#tab-bar`, a 28px band styled identically to the tab strip above it that held five unrelated axes with no labels on any of them; the three axes here each say what they are, and the label is what stops the band re-accreting into an anonymous strip of chips. `panels/pane-context.ts` keeps every decision — which editor kinds a document declares, which canvas views it has, whether preview is a flag over them, what a lens may not write, which pane's stage a zoom verb lands on, and what a route param's candidate values are — and hands this document one projection of words, booleans and keyed rows. The bar and the banner share `[part=\"band\"]` so the adapter can MEASURE what the stage must clear: a banner's height is its wrapped text, and only layout knows how many lines that is.",
+  $description: "The pane's own chrome — the pane context bar and the floating zoom pod, one mount per pane. It replaces `#tab-bar`, a 28px band styled identically to the tab strip above it that held five unrelated axes with no labels on any of them; the three axes here each say what they are, and the label is what stops the band re-accreting into an anonymous strip of chips. `panels/pane-context.ts` keeps every decision — which editor kinds a document declares, which canvas views it has, whether preview is a flag over them, what a lens may not write, which pane's stage a zoom verb lands on, and what a route param's candidate values are — and hands this document one projection of words, booleans and keyed rows. The bar and the banner share `[part=\"band\"]` so the adapter can MEASURE what the stage must clear: a banner's height is its wrapped text, and only layout knows how many lines that is.",
   tagName: "div",
   attributes: {
     part: "chrome"
@@ -19343,10 +19382,14 @@ var pane_context_default = {
       flexShrink: "0"
     },
     '& [part="preview-toggle"]': {
-      $description: "Not a third radio, and it must not read as one: it says the canvas is inert. The margin separates the two axes the eye is being asked to read as separate; the accent fill is the kit's `emphasized`, which is what deleted the four Spectrum custom properties this rule used to carry.",
+      $description: "Not a third radio, and it must not read as one: it says the canvas is inert. The margin separates the two axes the eye is being asked to read as separate; the accent fill is the kit's `emphasized`, which is what deleted the four Spectrum custom properties this rule used to carry. The toggle is `quiet: false`, so it rests as a framed button of its own beside the framed View switch, as the Spectrum button did; quiet, it read as a fourth loose word once the switch beside it drew its frame.",
       flexShrink: "0",
       marginInlineStart: "6px"
     },
+    '& jx-action-button[part="preview-toggle"] > [part="control"]': {
+      $description: "The text padding the View switch's segments get from their group, which this toggle stands outside: the small size's 2px is for a glyph, and 6px is what the group gives a text segment. (0,3,1) outranks the kit's small padding at (0,3,0).",
+      paddingInline: "6px"
+    },
     '& [part="context-trigger"]': {
       fontVariantNumeric: "tabular-nums"
     },
@@ -19372,29 +19415,47 @@ var pane_context_default = {
       fontSize: "var(--jx-text-md)"
     },
     '& [part="pod"]': {
-      $description: "Bottom-right of the pane, over the stage — a viewport control, which is not a document axis and so never belonged in a band beside one.",
+      $description: "Bottom-right of the pane, over the stage — a viewport control, which is not a document axis and so never belonged in a band beside one. It is a ROW of two controls and draws no box of its own: a 1px border and a 6px radius round 2px/4px of padding framed the zoom group's own frame and the Fit select's own frame, a frame inside a frame and busier than any other group in the chrome. Each control draws itself and takes `--pod-lift` to stand off the document under it, which is what the pod's fill and border used to do for both at once, and the gap between them says they are two controls rather than one strip with a seam. The right inset ADDS `--stage-scrollbar-w` because the chrome layer spans the whole cell, scrollbar gutter included: a fixed 12px put the pod 3px into Edit's 15px track, painting over it and swallowing its clicks. CSS cannot measure a scrollbar and this document cannot see the scroller, so `canvas/stage-scrollbar.ts` measures the stage's own and writes the width on the cell, where this reads it by cascade. It is 0 wherever the stage does not scroll or the scrollbar is an overlay. Physical right on purpose: Studio's chrome is never mirrored.",
+      "--pod-lift": "0 2px 8px rgb(0 0 0 / 25%)",
       alignSelf: "flex-end",
+      display: "flex",
+      alignItems: "center",
+      gap: "var(--jx-space-2)",
       pointerEvents: "auto",
-      margin: "0 var(--jx-space-4) var(--jx-space-4) 0",
-      padding: "var(--jx-space-1) var(--jx-space-2)",
-      border: "1px solid var(--border)",
-      borderRadius: "var(--jx-radius-md)",
-      background: "var(--bg)",
-      boxShadow: "0 2px 8px rgb(0 0 0 / 25%)"
+      margin: "0 calc(var(--jx-space-4) + var(--stage-scrollbar-w, 0px)) var(--jx-space-4) 0"
+    },
+    '& [part="zoom-group"]': {
+      $description: "The segmented frame floats on its own now that the pod draws no box around it. The radius is the one the first and last segments already draw, so the shadow follows the shape of the strip instead of a rectangle around it — the host's box IS that strip, since the group has no padding and each member's -1px pulls its own host in by a pixel.",
+      borderRadius: "var(--jx-radius-sm)",
+      boxShadow: "var(--pod-lift)"
+    },
+    '& [part="pod"] > [part="zoom-group"][data-compact] > jx-action-button > [part="control"]': {
+      $description: "One resting ink across the pod. A compact group rests its unselected members on `--jx-fg-dim` and brightens the chosen one, which is how a segmented control says which segment is on — and nothing in this pod is ever chosen: the three are a viewport verb, a readout and a verb. So the dim ink said nothing here and made `100%` read as disabled beside the Fit select's value, which is the same kind of readout at `--jx-fg`. (0,5,1) over the group's own resting rule at (0,4,1); the group's hover is (0,6,1) and still wins, which now leaves it only the wash.",
+      color: "var(--fg)"
     },
     '& [part="zoom-label"]': {
-      minWidth: "48px",
-      fontFamily: "var(--font-mono)"
+      $description: "A floor under the percentage, so the pod does not shift as the value changes length. The width is the host's and the face is the control's, below: the control sets its own font and sits inside the host at its content width, so this rule used to carry a mono face nothing inherited and to open a 6px hole in the segmented frame before the `+` segment (measured: a 48px host round a 41.8px control, drawn in Inter).",
+      minWidth: "48px"
+    },
+    '& [part="zoom-label"] > [part="control"]': {
+      $description: "The control fills its 48px host, closing the frame, and draws the percentage in the mono face with tabular digits so a changing value does not jitter. (0,3,0) outranks the kit control's own face at (0,2,0).",
+      flex: "1",
+      fontFamily: "var(--font-mono)",
+      fontVariantNumeric: "tabular-nums"
     },
     '& [part="fit"]': {
       maxWidth: "120px"
     },
+    '& [part="fit"] > [part="control"]': {
+      $description: "The pod's second control lifts off the document the way the first does, on the frame the kit's select already draws. On the control rather than the host, because the host is a column whose error region and help slot are the select's neighbours: the shadow has to follow the box that is painted.",
+      boxShadow: "var(--pod-lift)"
+    },
     '& [part="popover"]': {
       $description: "Both panels take the pointer that `.pane-chrome` withholds. A popover is in the top layer while it shows, which changes where it PAINTS and not where it is in the tree, so it inherits `pointer-events: none` from the chrome layer exactly as the band does.",
       pointerEvents: "auto"
     },
     '& [part="ctx"]': {
-      $description: "One column of labelled groups over a footer that leaves for the definition site. This control only SELECTS (§2 principle 5) — nothing in it defines a breakpoint, a scheme or a feature query.",
+      $description: "One column of labelled groups over a footer that leaves for the definition site. This control only SELECTS; the definitions live in Project Settings › Contexts (§6.2), and nothing in it defines a breakpoint, a scheme or a feature query.",
       display: "flex",
       flexDirection: "column",
       gap: "10px",
@@ -19413,11 +19474,15 @@ var pane_context_default = {
       letterSpacing: "0.04em",
       color: "var(--fg-dim)"
     },
-    '& [part="sizes"]': {
-      flexWrap: "wrap"
+    '& [part="sizes"], & [part="features"]': {
+      $description: "The two groups that WRAP, and the reason neither is a segmented control. A breakpoint or feature list is as long as the project makes it and this popover is a 240–340px column, so both fold onto a second line in any project with more than a few; a compact group cannot draw that — its seam is written in tree order, no selector can find the ends of a flex line, and it therefore refuses to wrap and would overflow the column instead (ui.md §5.4). Chips instead: each member draws its own rounded frame (`quiet: false`, since the group no longer frames it) and the chosen one takes the accent edge below. The gap is --jx-space-2 rather than the group's own 2px, which puts every small chip's hit area at the 24px floor on both axes instead of the 22px two overlapping extensions leave (§4.3).",
+      flexWrap: "wrap",
+      gap: "var(--jx-space-2)"
     },
-    '& [part="features"]': {
-      flexWrap: "wrap"
+    '& [part="sizes-item"][data-selected] > [part="control"], & [part="features-item"][data-selected] > [part="control"]': {
+      $description: "A chosen chip reads the way a chosen segment does: the accent tint with an accent EDGE. A member's own selected state is a 15% tint over its neutral border, which among framed neighbours reads as a faint wash rather than as the one that is on — the measurement that gave the compact group its selected rule, restated here at the one place the group does not draw it. (0,4,0) over the member's own (0,3,0).",
+      borderColor: "var(--jx-accent)",
+      background: "var(--jx-accent-20)"
     },
     '& [part="fields"]': {
       $description: "The fields, stacked. They were a row on the bar capped at 140px; in the popover each takes the full column so a route value or a JSON test prop is readable while you type it.",
@@ -19745,6 +19810,7 @@ var pane_context_default = {
                                   },
                                   $props: {
                                     size: "sm",
+                                    quiet: false,
                                     toggles: true,
                                     emphasized: true,
                                     selected: {
@@ -20083,55 +20149,55 @@ var pane_context_default = {
                       }
                     ]
                   }
-                },
-                {
-                  tagName: "div",
+                }
+              ]
+            },
+            {
+              tagName: "div",
+              attributes: {
+                part: "fit-slot",
+                role: "none"
+              },
+              style: {
+                display: "contents"
+              },
+              $switch: {
+                $ref: "#/state/fitState"
+              },
+              cases: {
+                shown: {
+                  tagName: "jx-select",
                   attributes: {
-                    part: "fit-slot",
-                    role: "none"
-                  },
-                  style: {
-                    display: "contents"
+                    part: "fit"
                   },
-                  $switch: {
-                    $ref: "#/state/fitState"
+                  $props: {
+                    label: "Fit",
+                    size: "sm",
+                    options: {
+                      $ref: "#/state/fitOptions"
+                    },
+                    value: {
+                      $ref: "#/state/fitValue"
+                    }
                   },
-                  cases: {
-                    shown: {
-                      tagName: "jx-select",
-                      attributes: {
-                        part: "fit"
-                      },
-                      $props: {
-                        label: "Fit",
-                        size: "sm",
-                        options: {
-                          $ref: "#/state/fitOptions"
+                  onchange: {
+                    $prototype: "Function",
+                    body: [
+                      {
+                        operator: "call",
+                        target: {
+                          $ref: "#/state/chooseFit"
                         },
-                        value: {
-                          $ref: "#/state/fitValue"
-                        }
-                      },
-                      onchange: {
-                        $prototype: "Function",
-                        body: [
+                        value: [
                           {
-                            operator: "call",
-                            target: {
-                              $ref: "#/state/chooseFit"
-                            },
-                            value: [
-                              {
-                                $ref: "event#/target/value"
-                              }
-                            ]
+                            $ref: "event#/target/value"
                           }
                         ]
                       }
-                    }
+                    ]
                   }
                 }
-              ]
+              }
             }
           ]
         }
@@ -20182,7 +20248,7 @@ var pane_context_default = {
                   },
                   $props: {
                     selects: "single",
-                    compact: true,
+                    compact: false,
                     label: "Size"
                   },
                   children: [
@@ -20202,6 +20268,7 @@ var pane_context_default = {
                         },
                         $props: {
                           size: "sm",
+                          quiet: false,
                           checked: {
                             $ref: "$map/item/checked"
                           },
@@ -20454,7 +20521,7 @@ var pane_context_default = {
                       },
                       $props: {
                         selects: "multiple",
-                        compact: true,
+                        compact: false,
                         label: "Features"
                       },
                       children: [
@@ -20474,6 +20541,7 @@ var pane_context_default = {
                             },
                             $props: {
                               size: "sm",
+                              quiet: false,
                               toggles: true,
                               selected: {
                                 $ref: "$map/item/selected"
@@ -21406,6 +21474,11 @@ function fitChoiceValue(fit) {
   return fit;
 }
 var STAGE_ZOOM_MODES = new Set(["design", "stylebook", "git-diff"]);
+function comparisonPathOf(paneId) {
+  const derived = derivationOfPane(paneId);
+  const state = derived?.kind === "lens" && derived.preset === "diff" ? derived.diff : shell.git.diffState;
+  return state?.filePath ?? "";
+}
 function podFor(tab, paneId) {
   const mode = canvasModeOfPane(paneId);
   const surface = surfaceForPane(paneId);
@@ -21416,6 +21489,9 @@ function podFor(tab, paneId) {
   if (!STAGE_ZOOM_MODES.has(mode)) {
     return { podState: "hidden" };
   }
+  if (mode === "git-diff" && diffShowsCode(paneId, canRenderComparison(comparisonPathOf(paneId)))) {
+    return { podState: "hidden" };
+  }
   const zoom = stageZoom(surface);
   return {
     fitOptions: FIT_CHOICES.map(({ label, value }) => ({ label, value })),
@@ -22012,130 +22088,15 @@ async function applyFileDrop(tab, files, hit, preview) {
     }
   }
 }
-
-// ../ai/src/tools.ts
-function toolSuccess(data, summary) {
-  return { success: true, data, summary };
-}
-function toolError(error) {
-  return { success: false, error };
-}
-function createToolDefinition({
-  name,
-  description,
-  parameters,
-  strict = true,
-  llmStrict = false,
-  execute
-}) {
-  return { name, description, parameters, strict, llmStrict, execute };
-}
-function createToolRegistry() {
-  const _tools = new Map;
-  return {
-    register(tool) {
-      if (_tools.has(tool.name)) {
-        console.warn(`Tool "${tool.name}" is being re-registered.`);
-      }
-      _tools.set(tool.name, tool);
-    },
-    list() {
-      return [..._tools.values()];
-    },
-    listForLLM() {
-      return [..._tools.values()].map((t) => ({
-        type: "function",
-        function: {
-          name: t.name,
-          description: t.description,
-          parameters: t.parameters,
-          ...t.llmStrict === true ? { strict: true } : {}
-        }
-      }));
-    },
-    getDefinition(toolName) {
-      return _tools.get(toolName);
-    },
-    validate(toolName, args) {
-      const tool = _tools.get(toolName);
-      if (!tool) {
-        return { valid: false, errors: [`Unknown tool: "${toolName}"`] };
-      }
-      if (!tool.strict) {
-        return { valid: true };
-      }
-      const schema = tool.parameters;
-      if (!schema || !schema.properties) {
-        return { valid: true };
-      }
-      const errors = [];
-      const props = schema.properties;
-      const required = schema.required || [];
-      const argRecord = args;
-      for (const key of required) {
-        if (!(key in args) || argRecord[key] === undefined || argRecord[key] === null) {
-          errors.push(`Missing required argument: "${key}"`);
-        }
-      }
-      for (const [key, value] of Object.entries(argRecord)) {
-        const propSchema = props[key];
-        if (!propSchema) {
-          continue;
-        }
-        const expectedType = propSchema.type;
-        if (!expectedType) {
-          continue;
-        }
-        const actualType = Array.isArray(value) ? "array" : typeof value;
-        if (expectedType === "number" || expectedType === "integer") {
-          if (actualType === "number") {
-            continue;
-          }
-          if (actualType === "string") {
-            if (!Number.isNaN(Number(value))) {
-              continue;
-            }
-            errors.push(`Argument "${key}" should be a number, got non-numeric string "${value}"`);
-            continue;
-          }
-          errors.push(`Argument "${key}" should be a number, got ${actualType}`);
-          continue;
-        }
-        if (expectedType === "string" && actualType !== "string") {
-          errors.push(`Argument "${key}" should be a string, got ${actualType}`);
-        } else if (expectedType === "boolean" && actualType !== "boolean") {
-          errors.push(`Argument "${key}" should be a boolean, got ${actualType}`);
-        } else if (expectedType === "array" && actualType !== "array") {
-          errors.push(`Argument "${key}" should be an array, got ${actualType}`);
-        } else if (expectedType === "object" && actualType !== "object") {
-          errors.push(`Argument "${key}" should be an object, got ${actualType}`);
-        }
-      }
-      return errors.length > 0 ? { valid: false, errors } : { valid: true };
-    },
-    async execute(toolName, args) {
-      const tool = _tools.get(toolName);
-      if (!tool) {
-        return toolError(`Unknown tool: "${toolName}"`);
-      }
-      const validation = this.validate(toolName, args);
-      if (!validation.valid) {
-        return toolError(`Validation failed: ${(validation.errors || []).join("; ")}`);
-      }
-      try {
-        return await tool.execute(args);
-      } catch (error) {
-        return toolError(`Tool "${toolName}" execution error: ${error.message}`);
-      }
-    }
-  };
-}
 // ../ai/src/chat-state.ts
 var _idCounter = 0;
 function uid() {
   _idCounter += 1;
   return `msg_${Date.now()}_${_idCounter}`;
 }
+function isCount(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
 function createChatState(opts = {}) {
   const model = opts.model || "gpt-4o";
   const store = reactive({
@@ -22146,7 +22107,8 @@ function createChatState(opts = {}) {
     error: null,
     model,
     tokenCount: 0,
-    contextWarning: false
+    contextWarning: false,
+    usage: null
   });
   let _streamingMessage = null;
   function sendMessage(text) {
@@ -22227,15 +22189,14 @@ function createChatState(opts = {}) {
   }
   function appendToolCallEnd(_id) {}
   function appendToolResult(id, result) {
-    const tc = store.pendingToolCalls.find((t) => t.id === id);
-    if (tc) {
-      tc.result = result;
+    let index = store.messages.length - 1;
+    while (index >= 0 && store.messages[index].role === "tool") {
+      index -= 1;
     }
-    if (_streamingMessage?.toolCalls) {
-      const mtc = _streamingMessage.toolCalls.find((t) => t.id === id);
-      if (mtc) {
-        mtc.result = result;
-      }
+    const request = store.messages[index];
+    const record = request?.role === "assistant" ? request.toolCalls?.find((t) => t.id === id) : null;
+    if (record) {
+      record.result = result;
     }
   }
   function finishStream(_stopReason) {
@@ -22248,6 +22209,7 @@ function createChatState(opts = {}) {
     store.status = "error";
     store.error = message;
     store.streamingContent = "";
+    store.pendingToolCalls = [];
     if (_streamingMessage) {
       const idx = store.messages.lastIndexOf(_streamingMessage);
       if (idx !== -1) {
@@ -22276,6 +22238,7 @@ function createChatState(opts = {}) {
     store.pendingToolCalls = [];
     store.error = null;
     store.contextWarning = false;
+    store.usage = null;
     _streamingMessage = null;
   }
   function retryLast() {
@@ -22294,6 +22257,27 @@ function createChatState(opts = {}) {
   function setTokenCount(count) {
     store.tokenCount = count;
   }
+  function recordUsage(usage, extra = {}) {
+    if (!isCount(usage.inputTokens) || !isCount(usage.outputTokens)) {
+      return;
+    }
+    const { type: _type, ...counts } = usage;
+    const counted = _streamingMessage ?? store.messages.at(-1);
+    const replayed = Boolean(counted?.reasoningContent && (counted.content || (counted.toolCalls?.length ?? 0) > 0));
+    const unreplayed = replayed || !isCount(usage.reasoningTokens) ? 0 : usage.reasoningTokens;
+    const contextTokens = Math.max(0, usage.inputTokens + usage.outputTokens - unreplayed);
+    store.usage = {
+      ...counts,
+      contextTokens,
+      lastMessageId: store.messages.at(-1)?.id ?? "",
+      messageCount: store.messages.length,
+      ...extra.systemTokens === undefined ? {} : { systemTokens: extra.systemTokens }
+    };
+    store.tokenCount = contextTokens;
+  }
+  function clearUsage() {
+    store.usage = null;
+  }
   function setContextWarning(warning) {
     store.contextWarning = warning;
   }
@@ -22355,6 +22339,8 @@ function createChatState(opts = {}) {
     retryLast,
     setModel,
     setTokenCount,
+    recordUsage,
+    clearUsage,
     setContextWarning,
     toMessagesArray
   });
@@ -22391,6 +22377,7 @@ function createProxyStreamingClient({
   apiKey,
   baseUrl
 }) {
+  let resolvedUrl = null;
   async function* streamChat(messages, tools, systemPrompt, signal) {
     const headers = { "Content-Type": "application/json" };
     if (apiKey) {
@@ -22399,9 +22386,24 @@ function createProxyStreamingClient({
     if (baseUrl) {
       headers["X-Api-Base-URL"] = baseUrl;
     }
+    resolvedUrl ??= Promise.resolve(typeof chatUrl === "function" ? chatUrl() : chatUrl);
+    let url;
+    try {
+      url = await resolvedUrl;
+    } catch (error) {
+      if (signal?.aborted) {
+        yield { type: "done", stopReason: "cancelled" };
+        return;
+      }
+      throw error;
+    }
+    if (signal?.aborted) {
+      yield { type: "done", stopReason: "cancelled" };
+      return;
+    }
     let response;
     try {
-      response = await fetch(chatUrl, {
+      response = await fetch(url, {
         method: "POST",
         headers,
         body: JSON.stringify({ messages, tools, systemPrompt, model }),
@@ -22487,54 +22489,28 @@ function createProxyStreamingClient({
   }
   return { streamChat };
 }
-// src/services/ai-writes.ts
-var turns = [];
-var MAX_TURNS = 50;
-var open = null;
-function beginTurn(id) {
-  if (open?.id === id) {
-    return;
+// src/services/project-path.ts
+function normalizeRelPath(path) {
+  if (typeof path !== "string" || !path.trim()) {
+    return null;
   }
-  open = { id, writes: [] };
-}
-function recordWrite(write) {
-  open?.writes.push(write);
-}
-function endTurn(id) {
-  if (!open) {
-    return [];
+  let p = path.trim().replaceAll("\\", "/");
+  while (p.startsWith("./")) {
+    p = p.slice(2);
   }
-  const turn = { id, writes: open.writes };
-  open = null;
-  if (turn.writes.length === 0) {
-    return [];
+  if (p.startsWith("/") || p.startsWith("~") || /^[A-Za-z]:/.test(p)) {
+    return null;
   }
-  turns.push(turn);
-  while (turns.length > MAX_TURNS) {
-    turns.shift();
+  if (p.split("/").includes("..")) {
+    return null;
   }
-  return turn.writes;
-}
-function writesForTurn(id) {
-  return turns.find((turn) => turn.id === id)?.writes ?? [];
+  return p;
 }
-function summarizeWrites(writes) {
-  const applied = writes.filter((w) => w.ok);
-  const paths = new Set(applied.map((w) => w.path));
-  const failed = writes.length - applied.length;
-  if (paths.size === 0) {
-    return failed > 0 ? `${failed} change${failed === 1 ? "" : "s"} failed` : "";
-  }
-  const files = `Changed ${paths.size} file${paths.size === 1 ? "" : "s"}`;
-  const diskPaths = new Set(applied.filter((w) => w.disk).map((w) => w.path));
-  const parts = [files];
-  if (diskPaths.size > 0) {
-    parts.push(`${diskPaths.size} written to disk — undo cannot reach ${diskPaths.size === 1 ? "it" : "them"}`);
-  }
-  if (failed > 0) {
-    parts.push(`${failed} failed`);
-  }
-  return parts.join(" · ");
+function invalidPathResult(path) {
+  return {
+    success: false,
+    error: `Invalid path ${JSON.stringify(path)} — use a path relative to the project root (no leading "/", no "..").`
+  };
 }
 
 // src/services/token-lint.ts
@@ -22704,7 +22680,7 @@ function noDocError() {
     error: "No document is open — use open_document(path) to open one on the canvas, or " + "read_file/write_file to work with project files directly."
   };
 }
-async function applyAndValidate(tab, mutationFn, summary, validate, renderCheck, projectStyle) {
+async function applyAndValidate(ledger, tab, mutationFn, summary, validate, renderCheck, projectStyle) {
   const deps = { getProjectStyle: () => projectStyle, renderCheck, validate };
   const before = await snapshotBeforeWrite(tab, deps);
   if (!transactDoc(tab, mutationFn)) {
@@ -22713,7 +22689,7 @@ async function applyAndValidate(tab, mutationFn, summary, validate, renderCheck,
       error: "The document is frozen: a collaborator is editing its source, so structural edits are " + "paused. Nothing was changed. Try again once source editing ends."
     };
   }
-  recordWrite({ disk: false, ok: true, path: tab.documentPath ?? "(untitled)", tool: summary });
+  ledger.record({ disk: false, ok: true, path: tab.documentPath ?? "(untitled)", tool: summary });
   return reportDocumentWrite(tab, before, summary, deps);
 }
 function registerAiTools(registry, {
@@ -22792,7 +22768,7 @@ function registerAiTools(registry, {
       },
       required: ["path", "key"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       const tab = getTab();
       if (!tab) {
         return noDocError();
@@ -22802,7 +22778,7 @@ function registerAiTools(registry, {
       if (node === undefined) {
         return { success: false, error: `No node exists at path ${JSON.stringify(path)}.` };
       }
-      return applyAndValidate(tab, (t) => mutateUpdateProperty(t, path, key, value ?? undefined), `Set "${key}" at ${JSON.stringify(path)}.`, validate, renderCheck, styleOf());
+      return applyAndValidate(ctx.ledger, tab, (t) => mutateUpdateProperty(t, path, key, value ?? undefined), `Set "${key}" at ${JSON.stringify(path)}.`, validate, renderCheck, styleOf());
     }
   }));
   registry.register(createToolDefinition({
@@ -22824,7 +22800,7 @@ function registerAiTools(registry, {
       },
       required: ["parentPath", "index", "node"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       const tab = getTab();
       if (!tab) {
         return noDocError();
@@ -22850,7 +22826,7 @@ function registerAiTools(registry, {
           error: "Cannot insert into mapped-array children; edit the map template instead."
         };
       }
-      return applyAndValidate(tab, (t) => mutateInsertNode(t, parentPath, index, childNode), `Inserted node at ${JSON.stringify([...parentPath, "children", index])}.`, validate, renderCheck, styleOf());
+      return applyAndValidate(ctx.ledger, tab, (t) => mutateInsertNode(t, parentPath, index, childNode), `Inserted node at ${JSON.stringify([...parentPath, "children", index])}.`, validate, renderCheck, styleOf());
     }
   }));
   registry.register(createToolDefinition({
@@ -22874,7 +22850,7 @@ function registerAiTools(registry, {
       },
       required: ["path", "property"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       const tab = getTab();
       if (!tab) {
         return noDocError();
@@ -22885,7 +22861,7 @@ function registerAiTools(registry, {
       }
       const prop = property;
       const val = value == null ? undefined : String(value);
-      return applyAndValidate(tab, (t) => mutateUpdateStyle(t, path, prop, val), `Set style "${prop}" at ${JSON.stringify(path)}.`, validate, renderCheck, styleOf());
+      return applyAndValidate(ctx.ledger, tab, (t) => mutateUpdateStyle(t, path, prop, val), `Set style "${prop}" at ${JSON.stringify(path)}.`, validate, renderCheck, styleOf());
     }
   }));
   registry.register(createToolDefinition({
@@ -22903,7 +22879,7 @@ function registerAiTools(registry, {
       },
       required: ["path", "value"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       const tab = getTab();
       if (!tab) {
         return noDocError();
@@ -22912,10 +22888,9 @@ function registerAiTools(registry, {
       if (getNodeAtPath2(tab.doc.document, path) === undefined) {
         return { success: false, error: `No node exists at path ${JSON.stringify(path)}.` };
       }
-      return applyAndValidate(tab, (t) => {
-        const node = getNodeAtPath2(t.doc.document, path);
-        delete node.textContent;
-        node.children = [value];
+      return applyAndValidate(ctx.ledger, tab, (t) => {
+        mutateUpdateProperty(t, path, "textContent");
+        mutateUpdateProperty(t, path, "children", [value]);
       }, `Set text at ${JSON.stringify(path)}.`, validate, renderCheck, styleOf());
     }
   }));
@@ -22932,7 +22907,7 @@ function registerAiTools(registry, {
       },
       required: ["key", "value"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       const tab = getTab();
       if (!tab) {
         return noDocError();
@@ -22944,12 +22919,7 @@ function registerAiTools(registry, {
           error: `State key "${key}" already exists. Use update_state to change it, or remove it first.`
         };
       }
-      return applyAndValidate(tab, (t) => {
-        if (!t.doc.document.state) {
-          t.doc.document.state = {};
-        }
-        t.doc.document.state[key] = value;
-      }, `Added state "${key}".`, validate, renderCheck, styleOf());
+      return applyAndValidate(ctx.ledger, tab, (t) => mutateAddDef(t, key, value), `Added state "${key}".`, validate, renderCheck, styleOf());
     }
   }));
   registry.register(createToolDefinition({
@@ -22965,7 +22935,7 @@ function registerAiTools(registry, {
       },
       required: ["key"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       const tab = getTab();
       if (!tab) {
         return noDocError();
@@ -22977,15 +22947,11 @@ function registerAiTools(registry, {
           error: `State key "${key}" does not exist. Use add_state to create it, or check the name. Current state keys: ${Object.keys(tab.doc.document.state || {}).join(", ") || "(none)"}`
         };
       }
-      return applyAndValidate(tab, (t) => {
-        const { state } = t.doc.document;
-        if (!state) {
-          return;
-        }
+      return applyAndValidate(ctx.ledger, tab, (t) => {
         if (value == null) {
-          delete state[key];
+          mutateRemoveDef(t, key);
         } else {
-          state[key] = value;
+          mutateAddDef(t, key, value);
         }
       }, value == null ? `Removed state "${key}".` : `Updated state "${key}".`, validate, renderCheck, styleOf());
     }
@@ -23013,7 +22979,7 @@ function registerAiTools(registry, {
       },
       required: ["fromPath", "toParentPath", "toIndex"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       const tab = getTab();
       if (!tab) {
         return noDocError();
@@ -23034,7 +23000,7 @@ function registerAiTools(registry, {
           error: `No node exists at toParentPath ${JSON.stringify(toParentPath)}.`
         };
       }
-      return applyAndValidate(tab, (t) => mutateMoveNode(t, fromPath, toParentPath, toIndex), `Moved node from ${JSON.stringify(fromPath)} to ${JSON.stringify([...toParentPath, "children", toIndex])}.`, validate, renderCheck, styleOf());
+      return applyAndValidate(ctx.ledger, tab, (t) => mutateMoveNode(t, fromPath, toParentPath, toIndex), `Moved node from ${JSON.stringify(fromPath)} to ${JSON.stringify([...toParentPath, "children", toIndex])}.`, validate, renderCheck, styleOf());
     }
   }));
   registry.register(createToolDefinition({
@@ -23054,14 +23020,18 @@ function registerAiTools(registry, {
       },
       required: ["path", "content"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       if (!saveFile) {
         return {
           success: false,
           error: "File operations are not available in this environment."
         };
       }
-      const { path: relPath, content } = args;
+      const { path, content } = args;
+      const relPath = normalizeRelPath(path);
+      if (relPath === null) {
+        return invalidPathResult(path);
+      }
       const dirtyError = dirtyTabError(relPath);
       if (dirtyError) {
         return dirtyError;
@@ -23088,14 +23058,14 @@ ${formatted}`
       }
       try {
         await saveFile(relPath, serializeJson(content, null));
-        recordWrite({ disk: true, ok: true, path: relPath, tool: "create_component" });
+        ctx.ledger.record({ disk: true, ok: true, path: relPath, tool: "create_component" });
         return {
           success: true,
           summary: await reconcileAfterWrite(relPath, `Created component at "${relPath}".`)
         };
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        recordWrite({
+        ctx.ledger.record({
           disk: true,
           error: message,
           ok: false,
@@ -23126,14 +23096,18 @@ ${formatted}`
       },
       required: ["path", "content"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       if (!saveFile) {
         return {
           success: false,
           error: "File operations are not available in this environment."
         };
       }
-      const { path: relPath, content } = args;
+      const { path, content } = args;
+      const relPath = normalizeRelPath(path);
+      if (relPath === null) {
+        return invalidPathResult(path);
+      }
       const dirtyError = dirtyTabError(relPath);
       if (dirtyError) {
         return dirtyError;
@@ -23160,14 +23134,14 @@ ${formatted}`
       }
       try {
         await saveFile(relPath, serializeJson(content, null));
-        recordWrite({ disk: true, ok: true, path: relPath, tool: "create_page" });
+        ctx.ledger.record({ disk: true, ok: true, path: relPath, tool: "create_page" });
         return {
           success: true,
           summary: await reconcileAfterWrite(relPath, `Created page at "${relPath}".`)
         };
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        recordWrite({
+        ctx.ledger.record({
           disk: true,
           error: message,
           ok: false,
@@ -23183,26 +23157,6 @@ ${formatted}`
   }));
 }
 
-// src/services/ai-turn-signal.ts
-var _signal;
-function beginTurnSignal(signal) {
-  _signal = signal;
-}
-function turnSignal() {
-  return _signal;
-}
-function endTurnSignal() {
-  _signal = undefined;
-  _toolCallId = "";
-}
-var _toolCallId = "";
-function beginToolCall(id) {
-  _toolCallId = id;
-}
-function currentToolCallId() {
-  return _toolCallId;
-}
-
 // src/services/ai-ask.ts
 var MAX_OPTIONS = 6;
 var state2 = reactive({ pending: null });
@@ -23220,11 +23174,10 @@ function pendingAsk() {
 function isAwaitingAnswer() {
   return state2.pending !== null;
 }
-function askUser(ask) {
+function askUser(ask, signal) {
   return new Promise((resolve) => {
     state2.pending = ask;
     settle2 = resolve;
-    const signal = turnSignal();
     if (signal?.aborted) {
       clear();
       resolve({ answer: null, skipped: false });
@@ -23269,9 +23222,10 @@ function resetAsk() {
   cancelAsk();
   clear();
 }
-function registerAskTool(registry) {
+function registerAskTool(registry, { onPending } = {}) {
   registry.register(createToolDefinition({
     name: "ask_user",
+    interactive: true,
     description: "Pause and put a question to the user; the turn waits for their reply and resumes with " + "it. Use it ONLY for a judgement that is genuinely theirs — which pages matter, whether to " + "keep the original design, whether a low-fidelity page is acceptable. Never ask something " + "you can decide yourself or discover with another tool, and never ask about an option you " + "cannot act on. One question at a time; offer options when the sensible answers are a " + "short list, and the user may always reply in their own words instead.",
     parameters: {
       type: "object",
@@ -23292,7 +23246,7 @@ function registerAskTool(registry) {
       },
       required: ["question"]
     },
-    execute: async (args) => {
+    execute: async (args, ctx) => {
       const { question, options, context } = args;
       if (typeof question !== "string" || !question.trim()) {
         return toolError('Pass "question" — the question to put to the user.');
@@ -23301,12 +23255,16 @@ function registerAskTool(registry) {
         return toolError("A question is already waiting for the user.");
       }
       const choices = Array.isArray(options) ? options.filter((o) => typeof o === "string" && o.trim().length > 0).slice(0, MAX_OPTIONS) : [];
-      const { answer, skipped } = await askUser({
+      const answering = askUser({
         context: typeof context === "string" ? context.trim() : "",
-        id: currentToolCallId(),
+        id: ctx.callId,
         options: choices,
         question: question.trim()
-      });
+      }, ctx.signal);
+      if (isAwaitingAnswer()) {
+        onPending?.();
+      }
+      const { answer, skipped } = await answering;
       if (skipped) {
         return toolSuccess({ answer: null, skipped: true }, "The user declined to answer; proceed with your best judgment.");
       }
@@ -23373,7 +23331,7 @@ function definitionOf(registry, command, execute) {
     parameters,
     strict: false,
     llmStrict: false,
-    execute: (args) => execute(tool.name, args)
+    execute: (args, ctx) => execute(tool.name, args, ctx)
   };
 }
 function advertisedCommandTools(registry, execute = async (name) => toolError(`Tool "${name}" was listed without an executor.`)) {
@@ -23416,20 +23374,20 @@ function defaultPaths(command, tab) {
   }
   return ["(unknown file)"];
 }
-function fileLedger(command, tab, wrote) {
+function fileLedger(ledger, command, tab, wrote) {
   if (command.undo === undefined) {
     return;
   }
   const disk = command.undo === "none";
   for (const path of wrote ?? defaultPaths(command, tab)) {
-    recordWrite({ disk, ok: true, path, tool: command.title });
+    ledger.record({ disk, ok: true, path, tool: command.title });
   }
 }
 function createCommandToolRegistry(deps) {
   function commandFor(name) {
     return activeRegistry()?.list().find((command) => command.aiTool?.name === name);
   }
-  async function execute(name, received) {
+  async function execute(name, received, ctx = createToolContext()) {
     const registry = activeRegistry();
     const command = commandFor(name);
     if (!registry || !command) {
@@ -23471,7 +23429,7 @@ function createCommandToolRegistry(deps) {
     try {
       report = normaliseReport(tool.report({ after, args, before }));
     } catch (error) {
-      fileLedger(command, tab, projectUnchanged ? [] : undefined);
+      fileLedger(ctx.ledger, command, tab, projectUnchanged ? [] : undefined);
       const message = error instanceof Error ? error.message : String(error);
       return { error: `${command.title} ran, but its report failed: ${message}`, success: false };
     }
@@ -23482,7 +23440,7 @@ function createCommandToolRegistry(deps) {
         summary = `${command.title} changed nothing: project.json is exactly as it was.`;
       }
     }
-    fileLedger(command, tab, wrote);
+    fileLedger(ctx.ledger, command, tab, wrote);
     if (tab && snapshot) {
       const verdict = await reportDocumentWrite(tab, snapshot, summary, deps);
       if (!verdict.success) {
@@ -23549,9 +23507,9 @@ function composeToolRegistries(hand, commands) {
       const side = sideOf(name);
       return side ? side.validate(name, args) : { valid: false, errors: [`Unknown tool: "${name}"`] };
     },
-    async execute(name, args) {
+    async execute(name, args, ctx) {
       const side = sideOf(name);
-      return side ? side.execute(name, args) : toolError(`Unknown tool: "${name}"`);
+      return side ? side.execute(name, args, ctx) : toolError(`Unknown tool: "${name}"`);
     }
   };
 }
@@ -23569,6 +23527,14 @@ async function adoptProject(root) {
 }
 async function adoptCreatedProject(root, { getTab, adopt = adoptProject, initRepo = initProjectRepo2 }) {
   await initRepo(root);
+  const platform = hasPlatform2() ? getPlatform2() : null;
+  const shownRoot = workspace2.projectRoot;
+  const openedElsewhere = Boolean(platform && shownRoot && shownRoot !== root && platform.openProjectInNewWindow);
+  if (openedElsewhere && shownRoot && platform?.setWindowProject) {
+    try {
+      await platform.setWindowProject(shownRoot);
+    } catch {}
+  }
   const wasBatching = isBatching();
   if (wasBatching) {
     endBatch();
@@ -23582,7 +23548,7 @@ async function adoptCreatedProject(root, { getTab, adopt = adoptProject, initRep
   if (wasBatching) {
     beginBatch(getTab());
   }
-  return { adopted: workspace2.projectRoot === root, error: adoptionError };
+  return { adopted: workspace2.projectRoot === root, error: adoptionError, openedElsewhere };
 }
 
 // src/services/ai-project-tools.ts
@@ -23592,28 +23558,6 @@ var SEARCH_CAP = 100;
 var READ_CAP_BYTES = 48 * 1024;
 var WRITE_CAP_BYTES = 256 * 1024;
 var NOT_UNDOABLE = "(saved to disk; not undoable with Cmd+Z)";
-function normalizeRelPath(path) {
-  if (typeof path !== "string" || !path.trim()) {
-    return null;
-  }
-  let p = path.trim().replaceAll("\\", "/");
-  while (p.startsWith("./")) {
-    p = p.slice(2);
-  }
-  if (p.startsWith("/") || p.startsWith("~") || /^[A-Za-z]:/.test(p)) {
-    return null;
-  }
-  if (p.split("/").includes("..")) {
-    return null;
-  }
-  return p;
-}
-function pathError(path) {
-  return {
-    success: false,
-    error: `Invalid path ${JSON.stringify(path)} — use a path relative to the project root (no leading "/", no "..").`
-  };
-}
 function isJxDocPath(path) {
   return /^(pages|layouts|components|elements)\//.test(path) && path.endsWith(".json");
 }
@@ -23649,7 +23593,7 @@ function registerProjectTools(registry, {
       const { dir } = args;
       const start = dir === undefined || dir === "" ? "." : normalizeRelPath(dir);
       if (start === null) {
-        return pathError(dir);
+        return invalidPathResult(dir);
       }
       const platform = getPlatform2();
       const entries = [];
@@ -23706,7 +23650,7 @@ function registerProjectTools(registry, {
     async execute(args) {
       const relPath = normalizeRelPath(args.path);
       if (relPath === null) {
-        return pathError(args.path);
+        return invalidPathResult(args.path);
       }
       try {
         const content = await getPlatform2().readFile(relPath);
@@ -23746,11 +23690,11 @@ function registerProjectTools(registry, {
       },
       required: ["path", "content"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       const { path, content } = args;
       const relPath = normalizeRelPath(path);
       if (relPath === null) {
-        return pathError(path);
+        return invalidPathResult(path);
       }
       if (content.length > WRITE_CAP_BYTES) {
         return {
@@ -23831,10 +23775,16 @@ ${formatted}`
       }
       try {
         await getPlatform2().writeFile(relPath, content);
-        recordWrite({ disk: true, ok: true, path: relPath, tool: "write_file" });
+        ctx.ledger.record({ disk: true, ok: true, path: relPath, tool: "write_file" });
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        recordWrite({ disk: true, error: message, ok: false, path: relPath, tool: "write_file" });
+        ctx.ledger.record({
+          disk: true,
+          error: message,
+          ok: false,
+          path: relPath,
+          tool: "write_file"
+        });
         return {
           success: false,
           error: `Failed to write "${relPath}": ${message}`
@@ -23921,7 +23871,7 @@ ${tokenHints}` : summary };
       },
       required: ["name"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       const {
         name,
         description,
@@ -23985,6 +23935,7 @@ ${tokenHints}` : summary };
           error: `Failed to create project: ${error instanceof Error ? error.message : String(error)}`
         };
       }
+      ctx.ledger.record({ disk: true, ok: true, path: result.root, tool: "create_project" });
       const { adopted, error: adoptionError } = await adoptCreatedProject(result.root, {
         adopt: adoptProject,
         getTab
@@ -24147,10 +24098,7 @@ function destinationProblem(destination) {
   }
   return null;
 }
-var imported = false;
-function resetImportGuard() {
-  imported = false;
-}
+var IMPORT_DONE = "import.done";
 function describeRun(id, root, summary) {
   const record = importRun(id);
   const warnings = [...record?.warnings ?? [], ...summary?.warnings ?? []];
@@ -24180,7 +24128,12 @@ function describeRun(id, root, summary) {
   lines.push("The file and document tools are available now. Read the emitted pages, layouts and " + "components before proposing changes — then ask the user about anything the import had to " + "guess at (pages it skipped, components it may have split wrongly, a layout it did not find, " + "a page that did not render faithfully).");
   return lines.join(" ");
 }
-function registerImportTools(registry, { getTab, adoptProject, onProjectAdopted }) {
+function registerImportTools(registry, {
+  getTab,
+  adoptProject,
+  onProjectAdopted,
+  brief: briefStore = { clear: clearPendingImportBrief, read: pendingImportBrief }
+}) {
   registry.register(createToolDefinition({
     name: "import_site",
     description: "Clone a live website into a new Jx project and open it in the studio: pages, styles, " + "assets, a shared layout and recurring components. Only available while no project is " + "open. Progress streams into the conversation as it runs. When the user reached you " + "through the New Project Import form, the URL, crawl options and destination are already " + "settled — call this with the url alone and the rest is filled in. After it succeeds the " + "file and document tools become available in the next round.",
@@ -24226,7 +24179,7 @@ function registerImportTools(registry, { getTab, adoptProject, onProjectAdopted
       },
       required: ["url"]
     },
-    async execute(args) {
+    async execute(args, ctx) {
       const {
         url,
         directory,
@@ -24242,7 +24195,7 @@ function registerImportTools(registry, { getTab, adoptProject, onProjectAdopted
       if (workspace2.projectRoot) {
         return toolError("A project is already open in this window — import_site is only for bootstrapping.");
       }
-      if (imported) {
+      if (ctx.session.get(IMPORT_DONE) === true) {
         return toolError("A site has already been imported in this conversation. Start a new chat to import " + "another, or use the file tools on the project that was created.");
       }
       const platform = getPlatform2();
@@ -24258,7 +24211,7 @@ function registerImportTools(registry, { getTab, adoptProject, onProjectAdopted
       if (target.protocol !== "http:" && target.protocol !== "https:") {
         return toolError("The url must start with http:// or https://.");
       }
-      const brief = pendingImportBrief();
+      const brief = briefStore.read();
       const requested = typeof directory === "string" ? directory.trim() : "";
       if (requested && brief && requested !== brief.directory) {
         return toolError(`The destination is already set to ${brief.directory} — call import_site without ` + '"directory", or ask the user before changing it.');
@@ -24271,12 +24224,14 @@ function registerImportTools(registry, { getTab, adoptProject, onProjectAdopted
       if (problem) {
         return toolError(problem);
       }
-      const id = currentToolCallId();
+      const id = ctx.callId;
       const signal = beginImportRun(id, { directory: destination, url: target.href });
-      turnSignal()?.addEventListener("abort", () => {
+      const callSignal = ctx.signal;
+      const stopRun = () => {
         abortImportRun();
         finishImportRun(id, { status: "stopped" });
-      });
+      };
+      callSignal.addEventListener("abort", stopRun, { once: true });
       const apiKey = getOpenAiKey();
       const baseUrl = getBaseUrl();
       const model = brief?.model || preferredModel();
@@ -24303,8 +24258,11 @@ function registerImportTools(registry, { getTab, adoptProject, onProjectAdopted
           ...apiKey ? { apiKey } : {},
           ...baseUrl ? { baseUrl } : {},
           ...model ? { model } : {}
-        }, (evt) => recordImportProgress(id, evt), signal, onReady);
+        }, (evt) => {
+          ctx.progress(evt);
+        }, signal, onReady);
       } catch (error) {
+        callSignal.removeEventListener("abort", stopRun);
         const message = error instanceof Error ? error.message : String(error);
         if (signal.aborted) {
           finishImportRun(id, { error: message, status: "stopped" });
@@ -24318,9 +24276,11 @@ function registerImportTools(registry, { getTab, adoptProject, onProjectAdopted
 Last steps:
 ${tail}` : ""}`);
       }
+      callSignal.removeEventListener("abort", stopRun);
       finishImportRun(id, { status: "done" });
-      imported = true;
-      clearPendingImportBrief();
+      ctx.ledger.record({ disk: true, ok: true, path: result.root, tool: "import_site" });
+      ctx.session.set(IMPORT_DONE, true);
+      briefStore.clear();
       const { adopted, error: adoptionError } = await (adoption ?? adoptCreatedProject(result.root, {
         getTab,
         ...adoptProject ? { adopt: adoptProject } : {}
@@ -24357,7 +24317,7 @@ function createGatedToolRegistry(inner, availability) {
     validate(toolName, args) {
       return inner.validate(toolName, args);
     },
-    async execute(toolName, args) {
+    async execute(toolName, args, ctx) {
       if (inner.getDefinition(toolName) && !isAvailable(toolName)) {
         const gate = availability.get(toolName);
         return {
@@ -24365,28 +24325,207 @@ function createGatedToolRegistry(inner, availability) {
           error: `Tool "${toolName}" is not available right now — it requires ${gate?.requires ?? "a different studio state"}.`
         };
       }
-      return inner.execute(toolName, args);
+      return inner.execute(toolName, args, ctx);
     }
   };
 }
 
+// src/services/context-manager.ts
+var CHARS_PER_TOKEN = 4;
+var MODEL_CONTEXT_WINDOWS = [
+  ["gpt-4o", 128000],
+  ["gpt-4.1", 1e6],
+  ["gpt-4-turbo", 128000],
+  ["gpt-4", 8192],
+  ["gpt-3.5", 16385],
+  ["o1", 200000],
+  ["o3", 200000],
+  ["claude", 200000]
+];
+var DEFAULT_CONTEXT_WINDOW = 32000;
+var BUDGET_FRACTION = 0.8;
+var WARN_FRACTION = 0.5;
+function contextWindowFor(model) {
+  if (!model) {
+    return DEFAULT_CONTEXT_WINDOW;
+  }
+  const reported = modelContextWindow(model);
+  if (reported !== undefined && reported > 0) {
+    return reported;
+  }
+  const id = model.toLowerCase();
+  let best = 0;
+  let window2 = DEFAULT_CONTEXT_WINDOW;
+  for (const [prefix, size] of MODEL_CONTEXT_WINDOWS) {
+    if (id.startsWith(prefix) && prefix.length > best) {
+      best = prefix.length;
+      window2 = size;
+    }
+  }
+  return window2;
+}
+var KEEP_RECENT = 20;
+var MIN_USER_TURNS = 3;
+function estimateTokens(input) {
+  if (typeof input === "string") {
+    return Math.ceil(input.length / CHARS_PER_TOKEN);
+  }
+  let total = 0;
+  for (const msg of input) {
+    total += estimateTokens(msg.content || "");
+    if (msg.tool_calls) {
+      for (const tc of msg.tool_calls) {
+        total += estimateTokens(tc.function?.name || "") + estimateTokens(tc.function?.arguments || "") + 4;
+      }
+    }
+    total += 4;
+  }
+  return total;
+}
+function wireEntry(msg) {
+  const entry = { content: msg.content, role: msg.role };
+  if (msg.toolCalls) {
+    entry.tool_calls = msg.toolCalls.map((tc) => ({
+      function: { arguments: tc.arguments, name: tc.name }
+    }));
+  }
+  return entry;
+}
+function contextTokens(chatState, systemTokens) {
+  const { usage, messages } = chatState;
+  const boundary = usage ? messages[usage.messageCount - 1] : undefined;
+  if (usage && boundary && boundary.id === usage.lastMessageId) {
+    const since = messages.slice(usage.messageCount).filter((msg) => msg.role !== "assistant" || msg.content || (msg.toolCalls?.length ?? 0) > 0).map((msg) => wireEntry(msg));
+    const promptDrift = usage.systemTokens === undefined ? 0 : systemTokens - usage.systemTokens;
+    const reused = Math.max(0, usage.contextTokens + promptDrift) + estimateTokens(since);
+    if (Number.isFinite(reused)) {
+      return reused;
+    }
+  }
+  return systemTokens + estimateTokens(chatState.toMessagesArray());
+}
+function estimatePromptTokens(systemPrompt) {
+  return estimateTokens(systemPrompt);
+}
+function trimContext(chatState, systemPrompt) {
+  const window2 = contextWindowFor(chatState.model);
+  const maxTokens = Math.floor(window2 * BUDGET_FRACTION);
+  const warnTokens = Math.floor(window2 * WARN_FRACTION);
+  const systemTokens = estimateTokens(systemPrompt);
+  const allMessages = chatState.messages;
+  const total = contextTokens(chatState, systemTokens);
+  if (total <= maxTokens) {
+    chatState.setTokenCount(total);
+    chatState.setContextWarning(total >= warnTokens);
+    return { estimatedTokens: total, droppedCount: 0 };
+  }
+  let keepFrom = Math.max(0, allMessages.length - KEEP_RECENT);
+  let preservedTurns = 0;
+  for (let i = allMessages.length - 1;i >= keepFrom; i--) {
+    const { role } = allMessages[i];
+    if (role === "user" || role === "tool") {
+      preservedTurns += 1;
+    }
+  }
+  if (preservedTurns < MIN_USER_TURNS) {
+    for (let i = keepFrom - 1;i >= 0 && preservedTurns < MIN_USER_TURNS; i--) {
+      keepFrom = i;
+      const { role } = allMessages[i];
+      if (role === "user" || role === "tool") {
+        preservedTurns += 1;
+      }
+    }
+  }
+  if (keepFrom <= 0) {
+    chatState.setTokenCount(total);
+    chatState.setContextWarning(true);
+    return { estimatedTokens: total, droppedCount: 0 };
+  }
+  const droppedCount = keepFrom;
+  allMessages.splice(0, keepFrom);
+  chatState.clearUsage();
+  allMessages.unshift({
+    id: `ctx_summary_${Date.now()}`,
+    role: "user",
+    content: `[Earlier conversation truncated. ${droppedCount} messages dropped to stay within token budget. The most recent ${allMessages.length - 1} messages are preserved.]`,
+    timestamp: Date.now()
+  });
+  const newTotal = systemTokens + estimateTokens(chatState.toMessagesArray());
+  chatState.setTokenCount(newTotal);
+  chatState.setContextWarning(true);
+  return { estimatedTokens: newTotal, droppedCount };
+}
+var UNANSWERED_TOOL_RESULT = JSON.stringify({
+  success: false,
+  error: "This tool call was never completed — the session was reloaded or the history was trimmed."
+});
+function pruneOrphanToolMessages(chatState) {
+  const { messages } = chatState;
+  const requested = new Set;
+  const answered = new Set;
+  for (const msg of messages) {
+    if (msg.role === "assistant" && msg.toolCalls) {
+      for (const call of msg.toolCalls) {
+        requested.add(call.id);
+      }
+    } else if (msg.role === "tool" && msg.toolCallId) {
+      answered.add(msg.toolCallId);
+    }
+  }
+  let dropped = 0;
+  for (let i = messages.length - 1;i >= 0; i--) {
+    const msg = messages[i];
+    if (msg.role === "tool" && (!msg.toolCallId || !requested.has(msg.toolCallId))) {
+      messages.splice(i, 1);
+      dropped += 1;
+    }
+  }
+  let sealed = 0;
+  for (let i = messages.length - 1;i >= 0; i--) {
+    const msg = messages[i];
+    if (msg.role !== "assistant" || !msg.toolCalls) {
+      continue;
+    }
+    const missing = msg.toolCalls.filter((call) => !answered.has(call.id));
+    if (missing.length === 0) {
+      continue;
+    }
+    messages.splice(i + 1, 0, ...missing.map((call, n) => ({
+      content: UNANSWERED_TOOL_RESULT,
+      id: `sealed_${call.id}_${n}`,
+      role: "tool",
+      timestamp: msg.timestamp,
+      toolCallId: call.id
+    })));
+    sealed += missing.length;
+  }
+  return { dropped, sealed };
+}
+
 // src/services/tool-executor.ts
 var MAX_ROUNDS = 5;
+var EMPTY_TURN_TEXT = "The model sent back an empty reply.";
 var MAX_TOTAL_ROUNDS = 25;
-var INTERACTIVE_TOOLS = new Set(["ask_user"]);
 async function runAgentLoop({
   chatState,
   streamingClient,
   toolRegistry,
   systemPrompt,
   signal,
-  getTab
+  getTab,
+  session = createSessionFacts()
 }) {
   const allErrors = [];
   const appliedSummaries = [];
-  const turnId = () => chatState.messages.at(-1)?.id ?? "";
-  beginTurn(`turn:${chatState.messages.length}`);
-  beginTurnSignal(signal);
+  const turnUserId = chatState.messages.findLast((m) => m.role === "user")?.id;
+  const ledger = openTurnLedger(`turn:${chatState.messages.length}`);
+  const actor = {
+    id: `assistant:${session.sessionId ?? "local"}:${ledger.turnId}`,
+    kind: "assistant",
+    model: chatState.model,
+    sessionId: session.sessionId,
+    turnId: ledger.turnId
+  };
   if (getTab) {
     beginBatch(getTab());
   }
@@ -24436,6 +24575,10 @@ async function runAgentLoop({
             chatState.appendToolCallEnd(event.id);
             break;
           }
+          case "usage": {
+            chatState.recordUsage(event, { systemTokens: estimatePromptTokens(systemPrompt) });
+            break;
+          }
           case "done": {
             ({ stopReason } = event);
             break;
@@ -24450,7 +24593,6 @@ async function runAgentLoop({
           }
         }
       }
-      chatState.finishStream(stopReason);
       if (streamError) {
         if (streamErrorCode === "cf_reconnect_required") {
           resetModelCache();
@@ -24459,30 +24601,55 @@ async function runAgentLoop({
         chatState.setError(streamError);
         return;
       }
-      if (stopReason !== "tool_calls" || toolCalls.size === 0) {
+      const stopped = stopReason === "cancelled" || signal?.aborted === true;
+      if (toolCalls.size === 0 && !stopped && turnAnchor(chatState.messages, turnUserId) === null) {
+        chatState.setError(EMPTY_TURN_TEXT);
+        return;
+      }
+      chatState.finishStream(stopReason);
+      if (toolCalls.size === 0 || stopReason === "cancelled" || signal?.aborted) {
         return;
       }
       let didWork = false;
       for (const [id, call] of toolCalls) {
+        if (signal?.aborted) {
+          return;
+        }
         let result;
-        beginToolCall(id);
+        const writesBefore = ledger.writes.length;
+        const link = signal ? linkCallSignal(signal) : null;
+        const ctx = createToolContext({
+          actor,
+          callId: id,
+          ledger,
+          progress: (event) => {
+            recordImportProgress(id, event);
+          },
+          session,
+          ...link ? { signal: link.signal } : {}
+        });
         try {
-          const args = call.arguments ? JSON.parse(call.arguments) : {};
-          result = await toolRegistry.execute(call.name, args);
+          result = await toolRegistry.execute(call.name, parseToolArguments(call.arguments), ctx);
         } catch (error) {
           result = {
             success: false,
             error: `Failed to parse arguments: ${error.message}`
           };
+        } finally {
+          link?.release();
         }
-        if (!INTERACTIVE_TOOLS.has(call.name)) {
+        if (turnUserId !== undefined && !chatState.messages.some((m) => m.id === turnUserId)) {
+          return;
+        }
+        if (toolRegistry.getDefinition(call.name)?.interactive !== true) {
           didWork = true;
         }
         reanchorBatch();
         if (!result.success && result.error) {
           allErrors.push(result.error);
         }
-        if (result.success && result.summary) {
+        const wrote = ledger.writes.slice(writesBefore).some((write) => write.ok);
+        if (result.success && result.summary && wrote) {
           appliedSummaries.push(result.summary);
         }
         chatState.appendToolResult(id, result);
@@ -24491,6 +24658,9 @@ async function runAgentLoop({
       if (didWork) {
         workRounds += 1;
       }
+      if (signal?.aborted) {
+        return;
+      }
       if (workRounds < MAX_ROUNDS && round < MAX_TOTAL_ROUNDS) {
         chatState.beginAssistantTurn();
       }
@@ -24517,10 +24687,20 @@ You can continue by sending another message, or try a more specific request.`;
     }
     chatState.setError(tail);
   } finally {
-    endTurnSignal();
     endBatch();
-    endTurn(turnId());
+    fileTurn(turnAnchor(chatState.messages, turnUserId) ?? "", ledger.writes);
+  }
+}
+function parseToolArguments(text) {
+  if (!text) {
+    return {};
+  }
+  const parsed = JSON.parse(text);
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    const type = parsed === null ? "null" : Array.isArray(parsed) ? "array" : typeof parsed;
+    throw new TypeError(`arguments must be a JSON object, got ${type}`);
   }
+  return parsed;
 }
 
 // src/services/ai-system-prompt.ts
@@ -25232,153 +25412,6 @@ function buildProjectSummary({
 `);
 }
 
-// src/services/context-manager.ts
-var CHARS_PER_TOKEN = 4;
-var MODEL_CONTEXT_WINDOWS = [
-  ["gpt-4o", 128000],
-  ["gpt-4.1", 1e6],
-  ["gpt-4-turbo", 128000],
-  ["gpt-4", 8192],
-  ["gpt-3.5", 16385],
-  ["o1", 200000],
-  ["o3", 200000],
-  ["claude", 200000]
-];
-var DEFAULT_CONTEXT_WINDOW = 32000;
-var BUDGET_FRACTION = 0.8;
-var WARN_FRACTION = 0.5;
-function contextWindowFor(model) {
-  if (!model) {
-    return DEFAULT_CONTEXT_WINDOW;
-  }
-  const reported = modelContextWindow(model);
-  if (reported !== undefined && reported > 0) {
-    return reported;
-  }
-  const id = model.toLowerCase();
-  let best = 0;
-  let window2 = DEFAULT_CONTEXT_WINDOW;
-  for (const [prefix, size] of MODEL_CONTEXT_WINDOWS) {
-    if (id.startsWith(prefix) && prefix.length > best) {
-      best = prefix.length;
-      window2 = size;
-    }
-  }
-  return window2;
-}
-var KEEP_RECENT = 20;
-var MIN_USER_TURNS = 3;
-function estimateTokens(input) {
-  if (typeof input === "string") {
-    return Math.ceil(input.length / CHARS_PER_TOKEN);
-  }
-  let total = 0;
-  for (const msg of input) {
-    total += estimateTokens(msg.content || "");
-    if (msg.tool_calls) {
-      for (const tc of msg.tool_calls) {
-        total += estimateTokens(tc.function?.name || "") + estimateTokens(tc.function?.arguments || "") + 4;
-      }
-    }
-    total += 4;
-  }
-  return total;
-}
-function trimContext(chatState, systemPrompt) {
-  const window2 = contextWindowFor(chatState.model);
-  const maxTokens = Math.floor(window2 * BUDGET_FRACTION);
-  const warnTokens = Math.floor(window2 * WARN_FRACTION);
-  const systemTokens = estimateTokens(systemPrompt);
-  const allMessages = chatState.messages;
-  const messageTokens = estimateTokens(chatState.toMessagesArray());
-  const total = systemTokens + messageTokens;
-  if (total <= maxTokens) {
-    chatState.setTokenCount(total);
-    chatState.setContextWarning(total >= warnTokens);
-    return { estimatedTokens: total, droppedCount: 0 };
-  }
-  let keepFrom = Math.max(0, allMessages.length - KEEP_RECENT);
-  let preservedTurns = 0;
-  for (let i = allMessages.length - 1;i >= keepFrom; i--) {
-    const { role } = allMessages[i];
-    if (role === "user" || role === "tool") {
-      preservedTurns += 1;
-    }
-  }
-  if (preservedTurns < MIN_USER_TURNS) {
-    for (let i = keepFrom - 1;i >= 0 && preservedTurns < MIN_USER_TURNS; i--) {
-      keepFrom = i;
-      const { role } = allMessages[i];
-      if (role === "user" || role === "tool") {
-        preservedTurns += 1;
-      }
-    }
-  }
-  if (keepFrom <= 0) {
-    chatState.setTokenCount(total);
-    chatState.setContextWarning(true);
-    return { estimatedTokens: total, droppedCount: 0 };
-  }
-  const droppedCount = keepFrom;
-  allMessages.splice(0, keepFrom);
-  allMessages.unshift({
-    id: `ctx_summary_${Date.now()}`,
-    role: "user",
-    content: `[Earlier conversation truncated. ${droppedCount} messages dropped to stay within token budget. The most recent ${allMessages.length - 1} messages are preserved.]`,
-    timestamp: Date.now()
-  });
-  const newTotal = systemTokens + estimateTokens(chatState.toMessagesArray());
-  chatState.setTokenCount(newTotal);
-  chatState.setContextWarning(true);
-  return { estimatedTokens: newTotal, droppedCount };
-}
-var UNANSWERED_TOOL_RESULT = JSON.stringify({
-  success: false,
-  error: "This tool call was never completed — the session was reloaded or the history was trimmed."
-});
-function pruneOrphanToolMessages(chatState) {
-  const { messages } = chatState;
-  const requested = new Set;
-  const answered = new Set;
-  for (const msg of messages) {
-    if (msg.role === "assistant" && msg.toolCalls) {
-      for (const call of msg.toolCalls) {
-        requested.add(call.id);
-      }
-    } else if (msg.role === "tool" && msg.toolCallId) {
-      answered.add(msg.toolCallId);
-    }
-  }
-  let dropped = 0;
-  for (let i = messages.length - 1;i >= 0; i--) {
-    const msg = messages[i];
-    if (msg.role === "tool" && (!msg.toolCallId || !requested.has(msg.toolCallId))) {
-      messages.splice(i, 1);
-      dropped += 1;
-    }
-  }
-  let sealed = 0;
-  for (let i = messages.length - 1;i >= 0; i--) {
-    const msg = messages[i];
-    if (msg.role !== "assistant" || !msg.toolCalls) {
-      continue;
-    }
-    const missing = msg.toolCalls.filter((call) => !answered.has(call.id));
-    if (missing.length === 0) {
-      continue;
-    }
-    messages.splice(i + 1, 0, ...missing.map((call, n) => ({
-      content: UNANSWERED_TOOL_RESULT,
-      id: `sealed_${call.id}_${n}`,
-      role: "tool",
-      timestamp: msg.timestamp,
-      toolCallId: call.id
-    })));
-    sealed += missing.length;
-  }
-  return { dropped, sealed };
-}
-
 // src/services/render-critic.ts
 function translateRenderError(err) {
   const msg = err.message || String(err);
@@ -25581,6 +25614,76 @@ function moveSession(fromRoot, toRoot, id) {
   writeIndex(toRoot, toIndex);
 }
 
+// src/services/tool-outcomes.ts
+var ASK_TOOL = "ask_user";
+var NEVER_COMPLETED = JSON.parse(UNANSWERED_TOOL_RESULT);
+function stripToolResults(messages) {
+  return messages.map((message) => {
+    if (!Array.isArray(message.toolCalls)) {
+      return message;
+    }
+    return {
+      ...message,
+      toolCalls: message.toolCalls.map((call) => {
+        if (!call || typeof call !== "object") {
+          return call;
+        }
+        const { result: _result, ...rest } = call;
+        return rest;
+      })
+    };
+  });
+}
+function parseToolResult(content) {
+  if (typeof content !== "string") {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(content);
+    return parsed && typeof parsed === "object" && typeof parsed.success === "boolean" ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function backfillToolResults(messages) {
+  return messages.map((message, index) => {
+    if (message.role !== "assistant" || !Array.isArray(message.toolCalls)) {
+      return message;
+    }
+    const replies = new Map;
+    const sealed = new Set;
+    for (let next = index + 1;next < messages.length; next++) {
+      const reply = messages[next];
+      if (reply.role !== "tool") {
+        break;
+      }
+      const result = parseToolResult(reply.content);
+      if (typeof reply.toolCallId === "string" && result && !replies.has(reply.toolCallId)) {
+        replies.set(reply.toolCallId, result);
+        if (reply.content === UNANSWERED_TOOL_RESULT) {
+          sealed.add(reply.toolCallId);
+        }
+      }
+    }
+    return {
+      ...message,
+      toolCalls: message.toolCalls.map((call) => {
+        if (!call || typeof call !== "object") {
+          return call;
+        }
+        const record = call;
+        const id = typeof record.id === "string" ? record.id : undefined;
+        const answered = id === undefined ? undefined : replies.get(id);
+        if (record.name === ASK_TOOL) {
+          const reply = answered && id !== undefined && !sealed.has(id) ? answered : undefined;
+          return { ...record, result: reply ?? record.result ?? null };
+        }
+        return { ...record, result: answered ?? record.result ?? NEVER_COMPLETED };
+      })
+    };
+  });
+}
+
 // src/services/document-assistant.ts
 function projectRoot() {
   return workspace2.projectRoot || "";
@@ -25588,6 +25691,7 @@ function projectRoot() {
 function createDocumentAssistant() {
   const chatState = createChatState({ model: preferredModel() });
   let sessionId = null;
+  let sessionFacts = createSessionFacts();
   const getProjectStyle = () => workspace2.projectConfig?.style;
   const findOpenTab = (path) => {
     for (const tab of workspace2.tabs.values()) {
@@ -25598,7 +25702,7 @@ function createDocumentAssistant() {
     return null;
   };
   const innerRegistry = createToolRegistry();
-  registerAskTool(innerRegistry);
+  registerAskTool(innerRegistry, { onPending: () => persistChat() });
   registerAiTools(innerRegistry, {
     getTab: () => activeTab2.value,
     saveFile: async (relPath, content) => {
@@ -25667,6 +25771,8 @@ function createDocumentAssistant() {
   });
   const toolRegistry = composeToolRegistries(createGatedToolRegistry(innerRegistry, availability), commandTools);
   let controller = null;
+  const turnActive = shallowRef(false);
+  let turnEnded = Promise.resolve();
   function buildPrompt() {
     const tab = activeTab2.value;
     const inventory = projectState ? [...projectState.dirs.values()].flat().filter((e) => e.type === "file").map((e) => e.path) : undefined;
@@ -25693,7 +25799,7 @@ function createDocumentAssistant() {
     });
   }
   async function sendMessage(text) {
-    if (!text.trim() || chatState.status === "streaming") {
+    if (!text.trim() || turnActive.value || chatState.status === "streaming") {
       return;
     }
     if (!sessionId) {
@@ -25706,32 +25812,49 @@ function createDocumentAssistant() {
     }
     pruneOrphanToolMessages(chatState);
     persistChat();
+    controller = new AbortController;
+    const { signal } = controller;
+    turnActive.value = true;
+    let settleTurnEnded;
+    turnEnded = new Promise((settle) => {
+      settleTurnEnded = settle;
+    });
     try {
       const plat = getPlatform2();
-      const chatUrl = await Promise.resolve(plat.aiChatUrl());
       chatState.setModel(preferredModel());
       const streamingClient = createProxyStreamingClient({
-        chatUrl,
+        chatUrl: () => plat.aiChatUrl(),
         model: chatState.model,
         apiKey: getOpenAiKey() || undefined,
         baseUrl: getBaseUrl() || undefined
       });
-      controller = new AbortController;
+      if (sessionFacts.sessionId !== sessionId) {
+        sessionFacts = createSessionFacts(sessionId, sessionFacts.toJSON());
+      }
       await runAgentLoop({
         chatState,
         streamingClient,
         toolRegistry,
         systemPrompt: buildPrompt(),
-        signal: controller.signal,
+        signal,
+        session: sessionFacts,
         getTab: () => activeTab2.value
       });
     } catch (error) {
       chatState.setError(error instanceof Error ? error.message : String(error));
     } finally {
       controller = null;
+      turnActive.value = false;
       persistChat();
+      settleTurnEnded();
     }
   }
+  function isTurnActive() {
+    return turnActive.value;
+  }
+  function whenTurnEnds() {
+    return turnEnded;
+  }
   function stop() {
     controller?.abort();
     cancelAsk();
@@ -25742,7 +25865,8 @@ function createDocumentAssistant() {
     stop();
     resetAsk();
     resetImportRuns();
-    resetImportGuard();
+    resetAiWrites();
+    sessionFacts = createSessionFacts();
     chatState.clearChat();
     sessionId = null;
     setActiveSession(projectRoot(), null);
@@ -25779,10 +25903,10 @@ function createDocumentAssistant() {
       return;
     }
     const msgs = chatState.messages.filter((m) => m.role !== "assistant" || m.content || (m.toolCalls?.length ?? 0) > 0);
-    saveSession(projectRoot(), sessionId, msgs);
+    saveSession(projectRoot(), sessionId, stripToolResults(msgs));
   }
   function pushRestoredMessages(msgs) {
-    for (const m of msgs) {
+    for (const m of backfillToolResults(msgs)) {
       chatState.messages.push({
         ...m,
         id: m.id || `restored_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`
@@ -25805,7 +25929,9 @@ function createDocumentAssistant() {
   restoreChat();
   return {
     chatState,
+    isTurnActive,
     sendMessage,
+    whenTurnEnds,
     stop,
     newChat,
     listSessions: listSessions2,
@@ -25818,7 +25944,7 @@ function createDocumentAssistant() {
 var ai_credentials_form_default = {
   $schema: "https://jxsuite.com/schema/v1",
   $id: "StudioAiCredentialsForm",
-  $description: "The AI provider credentials form every gate embeds below the keyless offer: a key, a model, an endpoint, and the two buttons that keep or abandon them. Everything here is a projection — `ui/ai-credentials-form.ts` keeps the drafts, decides what a fetch is sent with, what Save actually persists and whether Cancel is on offer at all. This document never reads a setting and never calls the proxy.",
+  $description: "The AI provider credentials form every gate embeds below the keyless offer: a key, a model, an endpoint, and the two buttons that keep or abandon them. Everything here is a projection — `ui/ai-credentials-form.ts` keeps the drafts, decides what a fetch is sent with, what Save actually persists and whether there is anything to Save or Cancel at all. This document never reads a setting and never calls the proxy.",
   tagName: "div",
   attributes: {
     part: "ai-creds-form",
@@ -25834,8 +25960,7 @@ var ai_credentials_form_default = {
     maxWidth: "320px",
     textAlign: "left",
     '& [part="title"]': {
-      $description: "Centred over a left-aligned column: the form is a titled block, not a list of labelled rows.",
-      alignSelf: "center",
+      $description: "Weight alone, and no `align-self`. It was centred over the column on the grounds that the form is a titled block rather than a list of labelled rows, and in Preferences it is neither: the sheet's own heading, the blurb, this note, the `Model` label and all three fields start at the column's inline edge, so a centred line 102px wide in a 320px column read as a stray, not as a title. A heading belongs over the first character of the thing it names.",
       fontWeight: "600"
     },
     '& [part="note"]': {
@@ -25855,17 +25980,22 @@ var ai_credentials_form_default = {
       width: "100%"
     },
     '& [part="models"]': {
+      $description: "A wrapping row that holds the button and, when there is one, the reason the listing did not finish — and the reason always takes a line of its own, which is what `flex-basis: 100%` on it (below) is for. Beside the button it began 96px into a 320px column, so a six-line upstream body read as a paragraph indented past the control it answers for, while the button floated at that block's vertical middle with about 40px of dead space around it. Under the button, at the column's own inline edge, the reason starts where every other line in the form starts. `flex-start` rather than `center` so that a line which does hold two boxes lines up their first lines and not their middles.",
       display: "flex",
-      alignItems: "center",
+      flexWrap: "wrap",
+      alignItems: "flex-start",
       gap: "var(--jx-space-3)"
     },
     '& [part="models-error"]': {
-      $description: 'Why the listing did not finish, beside the button that would try it again. Named `models-error` rather than `error` because the kit\'s own fields render a permanent `[part="error"]` region of their own, and a surface that reused the name would be addressing three empty paragraphs before it reached its own.',
+      $description: 'Why the listing did not finish, said under the button that would try it again. Named `models-error` rather than `error` because the kit\'s own fields render a permanent `[part="error"]` region of their own, and a surface that reused the name would be addressing three empty paragraphs before it reached its own. `flexBasis: 100%` is what puts it under the button rather than beside it: the row wraps, and a basis of the whole line cannot share one, so however short the reason is it always reads as a line of the form (`[part="models"]`). `minWidth: 0` and `overflowWrap: anywhere` because the reason is often an upstream body passed through whole — a 401\'s JSON is one unbroken word — and a flex item\'s automatic minimum is its min-content width: one measured 853px inside the 320px column, and scrolled the whole Preferences section sideways over the buttons below it.',
       color: "var(--danger)",
-      fontSize: "var(--jx-text-sm)"
+      fontSize: "var(--jx-text-sm)",
+      flexBasis: "100%",
+      minWidth: "0",
+      overflowWrap: "anywhere"
     },
     '& [part="actions"]': {
-      $description: "Buttons at the end of the column, in the order a dismissal precedes a commitment.",
+      $description: 'Buttons at the end of the column, in the order a dismissal precedes a commitment. Still a flex item of the column although it is drawn inside `[part="actions-slot"]`, because that slot is `display: contents` — which is what keeps `alignSelf` meaning the column\'s end.',
       display: "flex",
       alignSelf: "flex-end",
       gap: "var(--jx-space-3)"
@@ -26067,26 +26197,26 @@ var ai_credentials_form_default = {
       }
     },
     {
+      $description: "The commit pair exists only while there is something to commit: `dirty` is the flow's answer to whether Save would change what is stored, compared after the store's own normalisation, so a pasted key's whitespace is not an edit. At rest neither button is drawn. The rule this replaced offered Cancel whenever a key was stored and Save always, so Preferences › Assistant showed a Save that would re-store what was there and a Cancel that abandoned nothing, beside the dialog's own Close. Absent rather than disabled, against the house rule for a control that cannot act, because the pair IS the pending edit's affordance: a disabled pair at rest would still be the two buttons the reader reported seeing with nothing to save, each needing a reason to give for being there. Answering either takes away the button that was pressed, so `surfaces/ai-credentials-form.ts` lands focus on the key field rather than letting it fall out of the sheet.",
       tagName: "div",
       attributes: {
-        part: "actions"
+        part: "actions-slot",
+        role: "none"
       },
-      children: [
-        {
+      style: {
+        display: "contents"
+      },
+      $switch: {
+        $ref: "#/state/dirty"
+      },
+      cases: {
+        true: {
           tagName: "div",
           attributes: {
-            part: "cancel-slot",
-            role: "none"
-          },
-          style: {
-            display: "contents"
-          },
-          $switch: {
-            $ref: "#/state/haveKey"
+            part: "actions"
           },
-          cases: {
-            true: {
-              $description: "Only offered once a key exists: with nothing stored there is nothing to go back to, and a Cancel that abandons an empty form to an empty form is a button that does nothing.",
+          children: [
+            {
               tagName: "jx-button",
               attributes: {
                 part: "cancel"
@@ -26112,38 +26242,38 @@ var ai_credentials_form_default = {
                   textContent: "Cancel"
                 }
               ]
-            }
-          }
-        },
-        {
-          tagName: "jx-button",
-          attributes: {
-            part: "save"
-          },
-          $props: {
-            size: "sm",
-            variant: "accent"
-          },
-          onclick: {
-            $prototype: "Function",
-            body: [
-              {
-                operator: "call",
-                target: {
-                  $ref: "#/state/save"
-                },
-                value: []
-              }
-            ]
-          },
-          children: [
+            },
             {
-              tagName: "span",
-              textContent: "Save"
+              tagName: "jx-button",
+              attributes: {
+                part: "save"
+              },
+              $props: {
+                size: "sm",
+                variant: "accent"
+              },
+              onclick: {
+                $prototype: "Function",
+                body: [
+                  {
+                    operator: "call",
+                    target: {
+                      $ref: "#/state/save"
+                    },
+                    value: []
+                  }
+                ]
+              },
+              children: [
+                {
+                  tagName: "span",
+                  textContent: "Save"
+                }
+              ]
             }
           ]
         }
-      ]
+      }
     }
   ]
 };
@@ -26174,7 +26304,11 @@ function createAiCredentialsSurface(view, actions) {
   return {
     host,
     update(next) {
+      const answering = !next.dirty && host.querySelector('[part="actions"]')?.contains(document.activeElement);
       Object.assign(scope, derive3(next));
+      if (answering && !host.contains(document.activeElement)) {
+        host.querySelector('[part="key"] [part="input"]')?.focus();
+      }
       if (mounting || handle !== null && host.contains(handle.root)) {
         return;
       }
@@ -26195,11 +26329,23 @@ function createAiCredentialsForm(opts) {
   let availableModels = [];
   let modelsLoading = false;
   let modelsError = "";
+  let basis = { apiKey: "", baseUrl: "", model: "" };
   let surface = null;
+  function stored() {
+    return { apiKey: getOpenAiKey(), baseUrl: getBaseUrl(), model: storedModel() };
+  }
   function loadDrafts() {
-    keyDraft = getOpenAiKey();
-    baseUrlDraft = getBaseUrl();
-    modelDraft = storedModel();
+    basis = stored();
+    keyDraft = basis.apiKey;
+    baseUrlDraft = basis.baseUrl;
+    modelDraft = basis.model;
+  }
+  function followStore() {
+    const now = stored();
+    keyDraft = storedEquals(SETTINGS.aiOpenAiKey, keyDraft, basis.apiKey) ? now.apiKey : keyDraft;
+    baseUrlDraft = storedEquals(SETTINGS.aiBaseUrl, baseUrlDraft, basis.baseUrl) ? now.baseUrl : baseUrlDraft;
+    modelDraft = storedEquals(SETTINGS.aiModel, modelDraft, basis.model) ? now.model : modelDraft;
+    basis = now;
   }
   function startEdit() {
     loadDrafts();
@@ -26250,8 +26396,8 @@ function createAiCredentialsForm(opts) {
   function view() {
     return {
       baseUrlDraft,
+      dirty: aiProviderDiffers({ apiKey: keyDraft, baseUrl: baseUrlDraft, model: modelDraft }),
       fetchLabel: modelsLoading ? "Fetching…" : availableModels.length > 0 ? "Refresh models" : "Fetch models",
-      haveKey: hasOpenAiKey(),
       intro: opts.intro ?? DEFAULT_INTRO,
       keyDraft,
       modelDraft,
@@ -26273,6 +26419,7 @@ function createAiCredentialsForm(opts) {
     surface?.update(view());
   }
   function render() {
+    followStore();
     if (surface) {
       surface.update(view());
     } else {
@@ -26316,8 +26463,8 @@ var ai_managed_connect_default = {
       maxWidth: "280px",
       textAlign: "center"
     },
-    '& [part="error"]': {
-      $description: "Why the last attempt did not finish, said under the button that would try it again. Narrower than the lede: a refusal is a sentence to read once, not the thing the surface is about.",
+    '& [part="connect-failure"]': {
+      $description: 'Why the last attempt did not finish, said under the button that would try it again. Narrower than the lede: a refusal is a sentence to read once, not the thing the surface is about. The name is qualified, and BOTH halves of it are load-bearing. Not `error`, because every kit field draws a permanent, empty `[part="error"]` of its own and the kit is light DOM, so a rule on that name would reach any field this surface ever holds. Not the bare `failure` every panel banner uses either, because this document is MOUNTED inside another one: `new-project.json` puts it in `[part="managed-island"]` and styles its own backend refusal with a descendant `[part="failure"]`, which would draw this sentence with that dialog\'s footer border and padding. A guest surface picks a name its host does not write, and `tests/surface-part-names.test.ts` holds the two island hosts to it.',
       margin: "0",
       color: "var(--danger)",
       fontSize: "var(--jx-text-sm)",
@@ -26372,7 +26519,7 @@ var ai_managed_connect_default = {
     {
       tagName: "div",
       attributes: {
-        part: "error-slot",
+        part: "connect-failure-slot",
         role: "none"
       },
       style: {
@@ -26385,7 +26532,7 @@ var ai_managed_connect_default = {
         true: {
           tagName: "p",
           attributes: {
-            part: "error"
+            part: "connect-failure"
           },
           textContent: "${state.error}"
         }
@@ -26438,6 +26585,7 @@ function createManagedConnectSurface(view, actions) {
 // src/ui/ai-managed-connect.ts
 var LEDE_FRESH = "Recommended — run the assistant on Workers AI in your own Cloudflare account. No API key to create, copy or rotate.";
 var LEDE_LAPSED = "Your Cloudflare connection has expired. Reconnect to keep using the assistant.";
+var LEDE_ACCOUNT = "Cloudflare is connected, but no account is chosen yet. Pick the account the assistant should run on.";
 function createManagedConnect(opts) {
   let busy = false;
   let connectError = "";
@@ -26448,6 +26596,26 @@ function createManagedConnect(opts) {
     }
     return !isProxyConfigured() || proxyStateCode() === "cf_reconnect_required";
   }
+  const needsAccount = () => proxyStateCode() === "cf_account_required";
+  async function verifyConnection() {
+    resetModelCache();
+    await fetchAvailableModels({ force: true });
+    if (proxyStateCode() === "cf_account_required") {
+      connectError = "Cloudflare still reports no account chosen for the assistant. Pick one again, or use your own API key below.";
+    } else if (!isProxyConfigured() || proxyStateCode() === "cf_reconnect_required") {
+      connectError = "Cloudflare connected, but the assistant backend still reports the connection as unusable. " + "Try reconnecting, or use your own API key below.";
+    }
+  }
+  async function chooseAccount() {
+    const { openCfAccountPicker } = await (__preload("3f08rry6"), import("./chunks/cf-account-picker-3f08rry6.js"));
+    if (!await openCfAccountPicker()) {
+      resetModelCache();
+      await fetchAvailableModels({ force: true });
+      connectError = "Cloudflare is connected, but no account is chosen yet — pick one to finish setting up the assistant.";
+      return;
+    }
+    await verifyConnection();
+  }
   function ensureProbe() {
     ensureProxyProbe(opts.requestRender);
   }
@@ -26460,17 +26628,10 @@ function createManagedConnect(opts) {
       return;
     }
     if (!outcome.connection.accountId) {
-      const { openCfAccountPicker } = await (__preload("nwnwdm6p"), import("./chunks/cf-account-picker-nwnwdm6p.js"));
-      if (!await openCfAccountPicker()) {
-        connectError = "Cloudflare is connected, but no account is chosen yet — pick one to finish setting up the assistant.";
-        return;
-      }
-    }
-    resetModelCache();
-    await fetchAvailableModels({ force: true });
-    if (!isProxyConfigured() || proxyStateCode() === "cf_reconnect_required") {
-      connectError = "Cloudflare connected, but the assistant backend still reports the connection as unusable. Try reconnecting, or use your own API key below.";
+      await chooseAccount();
+      return;
     }
+    await verifyConnection();
   }
   async function connect() {
     if (busy) {
@@ -26480,7 +26641,7 @@ function createManagedConnect(opts) {
     connectError = "";
     opts.requestRender();
     try {
-      await settle(await getPlatform2().cfConnect?.() ?? null);
+      await (needsAccount() ? chooseAccount() : settle(await getPlatform2().cfConnect?.() ?? null));
     } catch (error) {
       connectError = error instanceof Error ? error.message : String(error);
     }
@@ -26488,6 +26649,14 @@ function createManagedConnect(opts) {
     opts.requestRender();
   }
   function view() {
+    if (needsAccount()) {
+      return {
+        buttonLabel: busy ? "Choosing…" : "Choose Cloudflare account",
+        busy,
+        error: connectError,
+        intro: LEDE_ACCOUNT
+      };
+    }
     const lapsed = proxyStateCode() === "cf_reconnect_required";
     const idleLabel = lapsed ? "Reconnect Cloudflare" : "Connect Cloudflare";
     return {
@@ -26781,7 +26950,8 @@ var preferences_default = {
       maxHeight: "60vh",
       overflowY: "auto"
     },
-    '& [part="title"]': {
+    '& [part="section"] > [part="title"]': {
+      $description: 'The sheet\'s own heading, and a CHILD selector because the Assistant section mounts other documents into this one\'s light DOM: the credentials form draws a `[part="title"]` of its own ("AI provider key"), and as a bare descendant this rule set the section heading\'s size on it. A host styles the boxes it draws, never a name its guest also uses — `tests/surface-part-names.test.ts` holds the island hosts to that.',
       margin: "0",
       fontSize: "var(--jx-text-lg)",
       color: "var(--fg)"
@@ -26817,8 +26987,10 @@ var preferences_default = {
       gap: "var(--jx-space-2)"
     },
     '& [part="account"]': {
+      $description: "A wrapping row (studio-ui-guidelines.md §4.6): the sentence and the actions share one line while the sentence keeps its basis, and the actions drop under it when they would not. A brokered Cloudflare row carries two actions (Reconnect or Choose account, beside Disconnect), and on one line they squeezed the sentence into a column about 114px wide at the default width. Every single-action row measures exactly what it did before the wrap existed. `align-items: flex-start`, not `center`, because the sentence's height is not the row's: the AI row's endpoint wraps to five lines, and centred that put Disconnect level with the fourth line of a URL while the heading it acts on sat at the top, so the card read as two unrelated things. Pinned to the start, the button is always beside its label.",
       display: "flex",
-      alignItems: "center",
+      flexWrap: "wrap",
+      alignItems: "flex-start",
       justifyContent: "space-between",
       gap: "var(--jx-space-4)",
       padding: "var(--jx-space-3)",
@@ -26826,8 +26998,9 @@ var preferences_default = {
       borderRadius: "var(--radius)"
     },
     '& [part="account-text"]': {
-      $description: "`min-width: 0` so a long detail sentence ellipses inside the row rather than pushing the row's own buttons off the end of it.",
+      $description: "The wrap threshold is this basis, not a width: 120px of sentence is the least a row keeps before its actions take a line of their own. Keep it well under 200px, or a single-action row at the default sheet width wraps at rest. `min-width: 0` lets the column shrink below its content, and what then fits the detail into it is the detail's own `overflow-wrap`. Nothing here ellipsizes: the detail is the only place the row names its endpoint or account, so a truncated one would hide exactly the part that tells two of them apart.",
       display: "flex",
+      flex: "1 1 120px",
       flexDirection: "column",
       gap: "var(--jx-space-1)",
       minWidth: "0"
@@ -26836,19 +27009,25 @@ var preferences_default = {
       color: "var(--fg)"
     },
     '& [part="account-detail"]': {
+      $description: "`overflow-wrap: anywhere` because the detail carries author-supplied strings with no break opportunity in them: the AI row's endpoint URL (a Cloudflare AI Gateway URL is a 32-hex account id between slashes) and the local Cloudflare row's account id. Without it one of them measured 419px in a 223px column, ran under Disconnect, past the card's border, and scrolled the whole section sideways. `anywhere` rather than `break-word`, because only `anywhere` lowers the min-content the row is sized from; not `word-break: break-all`, which would split every ordinary word in the sentences around it. It sits here rather than on the column because the label is a fixed service name and only the detail is unbounded.",
       fontSize: "var(--jx-text-sm)",
-      color: "var(--fg-dim)"
+      color: "var(--fg-dim)",
+      overflowWrap: "anywhere"
     },
     '& [part="account-actions"]': {
+      $description: "`margin-inline-start: auto` keeps the actions at the row's end when the wrap puts them on a line of their own; on a shared line `space-between` already puts them there, so the margin changes nothing.",
       display: "flex",
       alignItems: "center",
       gap: "var(--jx-space-3)",
-      flexShrink: "0"
+      flexShrink: "0",
+      marginInlineStart: "auto"
     },
     '& [part="keys"]': {
+      $description: "The inline-end padding is for the scrollbar, not for rhythm. A row whose title wraps pushes its `Change` button to the very end of the line, and the sheet always scrolls (64 bindings), so that button's right edge landed exactly on the scroller's content edge and read as touching the scrollbar track.",
       display: "flex",
       flexDirection: "column",
-      gap: "var(--jx-space-1)"
+      gap: "var(--jx-space-1)",
+      paddingInlineEnd: "var(--jx-space-2)"
     },
     '& [part="refusal"]': {
       display: "flex",
@@ -26873,9 +27052,10 @@ var preferences_default = {
       textTransform: "uppercase",
       color: "var(--fg-dim)"
     },
-    '& [part="key"]': {
+    '& [part="key"][data-command]': {
+      $description: "Qualified by `data-command`, the attribute a binding row carries, because `key` is also the credentials form's API-key FIELD and that form is mounted into this sheet's own light DOM: as a bare descendant this rule laid a 16px flex row over a `jx-textfield`, which drew it 24px tall beside the 20px endpoint field under it. `center`, not `baseline`: the `Change` and `Reset` buttons are small kit action buttons, and a small kit control is layout-contained so its outset hit area adds nothing to this sheet's scrollable overflow, which leaves it with no baseline to export. A baseline row synthesises one from the button's bottom edge instead, and every row grew from 24px to 29px with the chord and title dropped onto it. Centred, every single-line row measures exactly what the baseline layout did (24px, with the chord, the title and the button label on one baseline); a row whose title wraps centres its chord and buttons between the title's lines. surface-baseline-rows.test.ts holds the rule for every surface.",
       display: "flex",
-      alignItems: "baseline",
+      alignItems: "center",
       gap: "var(--jx-space-4)",
       padding: "var(--jx-space-1) 0"
     },
@@ -26887,6 +27067,8 @@ var preferences_default = {
       color: "var(--fg)"
     },
     '& [part="key-title"]': {
+      $description: "`flex: 1` for the same reason the chord beside it is a fixed 96px column: down 64 rows, an action that starts where the last title ended is not scannable. The title took its content's width, so `Change` landed at fourteen different offsets in the first twenty rows, and at the line's very end on a row whose title wrapped. Growing the title instead pins the actions to that end, where a reader finds them by scanning one edge. `minWidth: 0` is what still lets a long title wrap rather than widen the sheet.",
+      flex: "1",
       color: "var(--fg-dim)",
       minWidth: "0"
     }
@@ -27631,6 +27813,7 @@ function openPreferencesSurface(options) {
     const box = element.querySelector('dialog[part="dialog"]') ?? element;
     box.setAttribute(REGION_ATTR, overlayRegion("dialog", "preferences"));
     showModal(element);
+    element.querySelector('[part="nav-item"][aria-current="true"]')?.focus();
     return element;
   });
   return {
@@ -38918,6 +39101,9 @@ function formatErrorAdvice(error) {
   if (lower.includes("500") || lower.includes("internal")) {
     return "The upstream API returned a server error. Try again in a moment.";
   }
+  if (lower.includes("empty reply")) {
+    return "Try again, or pick another model: some send back nothing for a request they cannot handle.";
+  }
   return "";
 }
 function projectCommand(id, opts = {}, registry = activeRegistry()) {
@@ -38947,7 +39133,7 @@ function tokenLabel2(tokens) {
 function tokenHint(tokens, overBudget) {
   return overBudget ? `About ${tokens.toLocaleString()} tokens — past half the model's context. ` + "The oldest turns are dropped as this grows; start a new chat to keep them." : `About ${tokens.toLocaleString()} tokens of the model's context in use`;
 }
-var ASK_TOOL = "ask_user";
+var ASK_TOOL2 = "ask_user";
 var IMPORT_TOOL = "import_site";
 function parseAsk(tc) {
   let parsed;
@@ -38967,7 +39153,7 @@ function parseAsk(tc) {
 }
 function toolOutcome(tc, live = true) {
   if (!tc.result) {
-    return tc.name === ASK_TOOL && !live ? "unanswered" : "pending";
+    return tc.name === ASK_TOOL2 && !live ? "unanswered" : "pending";
   }
   return tc.result.success ? "ok" : "failed";
 }
@@ -38976,7 +39162,12 @@ function toolOutcomeText(tc) {
   if (!result) {
     return "";
   }
-  return (result.success ? result.summary : result.error) ?? "";
+  const text = (result.success ? result.summary : result.error) ?? "";
+  if (tc.name === IMPORT_TOOL && result.success) {
+    const end = /\.(?:\s|$)/.exec(text);
+    return end ? text.slice(0, end.index + 1) : text;
+  }
+  return text;
 }
 function noImport() {
   return {
@@ -39015,7 +39206,7 @@ function projectChip(tc, handlers = {}) {
   const outcome = toolOutcome(tc, tc.id === handlers.pendingId || Boolean(tc.result));
   const text = toolOutcomeText(tc);
   const run = tc.name === IMPORT_TOOL ? handlers.importRun?.(tc.id) ?? null : null;
-  const ask = tc.name === ASK_TOOL ? parseAsk(tc) : null;
+  const ask = tc.name === ASK_TOOL2 ? parseAsk(tc) : null;
   const answered = tc.result?.success ? tc.result.data ?? null : null;
   const base = {
     answer: answered ? answered.skipped ? "You decide" : answered.answer ?? "" : "",
@@ -39464,7 +39655,7 @@ function createComposer(opts) {
     }
   }
   function send() {
-    if (!draft.trim() || opts.isStreaming()) {
+    if (!draft.trim() || opts.isStreaming() && !(opts.isAwaiting?.() ?? false)) {
       return;
     }
     const text = buildMessageWithContext(draft, chips);
@@ -39497,7 +39688,7 @@ function createComposer(opts) {
       placeholder: awaiting ? "Answer the assistant… (Enter to reply)" : "Ask the assistant… (Enter to send)",
       sendDisabled: draft.trim().length === 0,
       sendLabel: awaiting ? "Answer" : "Send",
-      sendState: streaming ? "stop" : "send"
+      sendState: !awaiting && streaming ? "stop" : "send"
     };
   }
   return {
@@ -39658,12 +39849,15 @@ var ai_chat_default = {
       color: "var(--fg-dim)"
     },
     '& [part="user-body"]': {
+      $description: "The transcript is content, not interface, and the panel offers no copy action, so each message body opts back in to selection against the root's `user-select: none`: this bubble, the model's `md`, the `streaming` text and the `import-log`. The header, the chips and the composer's buttons around them stay unselectable.",
       whiteSpace: "pre-wrap",
-      overflowWrap: "anywhere"
+      overflowWrap: "anywhere",
+      userSelect: "text"
     },
     '& [part="md"]': {
-      $description: "The island `panels/ai-chat/chat-markdown.ts` fills — the app's ONE injection sink, and the markup reaching it has been through `markdownToHtml` and the Trusted Types policy that asserts it did. The document renders the host node and nothing inside it (specs/studio-ui-guidelines.md §9.4).",
-      overflowWrap: "anywhere"
+      $description: "The island `panels/ai-chat/chat-markdown.ts` fills — the app's ONE injection sink, and the markup reaching it has been through `markdownToHtml` and the Trusted Types policy that asserts it did. The document renders the host node and nothing inside it (specs/studio-ui-guidelines.md §9.4). A reply is the text a reader most often copies out of this panel, code blocks included, so it is selectable.",
+      overflowWrap: "anywhere",
+      userSelect: "text"
     },
     '& [part="md"] > *:first-child': {
       marginTop: "0"
@@ -39698,8 +39892,10 @@ var ai_chat_default = {
       padding: "var(--jx-space-1) 6px"
     },
     '& [part="streaming"]': {
+      $description: 'The reply while it arrives, selectable for the reason `[part="md"]` is. The cursor is generated content, which no selection ever includes.',
       whiteSpace: "pre-wrap",
       overflowWrap: "anywhere",
+      userSelect: "text",
       "::after": {
         content: '"▋"',
         color: "var(--accent)",
@@ -39875,6 +40071,8 @@ var ai_chat_default = {
       marginRight: "var(--jx-space-2)"
     },
     '& [part="import-log"]': {
+      $description: "A captured log, kept selectable against the root's `user-select: none`: its lines are what a reader pastes into a bug report, and nothing here offers to copy them.",
+      userSelect: "text",
       marginTop: "var(--jx-space-2)",
       maxHeight: "40vh",
       overflowY: "auto",
@@ -39930,7 +40128,8 @@ var ai_chat_default = {
       color: "var(--warning)",
       fontStyle: "normal"
     },
-    '& [part="error"]': {
+    '& [part="error-card"]': {
+      $description: "The failed turn's card. It is `error-card` rather than `error` because the model picker mounted into the composer is a `jx-select`, and every kit field draws a permanent, empty `[part=\"error\"]` of its own in this same light-DOM tree: under that name this rule, padding and wash drew an 18×12 red bar over the picker's top-left corner that took the click. Its children keep the `error-` prefix, which the kit does not use.",
       borderLeft: "2px solid var(--danger)",
       borderRadius: "var(--jx-radius-sm)",
       background: "var(--hover-bg)",
@@ -40113,7 +40312,7 @@ var ai_chat_default = {
       '& [part="tool-chip"][data-outcome="failed"]': {
         borderLeftColor: "LinkText"
       },
-      '& [part="error"]': {
+      '& [part="error-card"]': {
         borderLeftColor: "LinkText"
       }
     },
@@ -41072,7 +41271,7 @@ var ai_chat_default = {
                     shown: {
                       tagName: "div",
                       attributes: {
-                        part: "error",
+                        part: "error-card",
                         role: "alert"
                       },
                       children: [
@@ -42018,8 +42217,13 @@ function watchAssistant() {
       const last = cs.messages.at(-1);
       last?.content;
       last?.toolCalls?.length;
+      for (const tc of latestRequest(cs.messages)?.toolCalls ?? []) {
+        tc.result;
+      }
       cs.status;
       cs.error;
+      assistant.isTurnActive();
+      cs.tokenCount;
       activeRegistry();
       pendingAsk();
       const run = activeImportRun();
@@ -42030,6 +42234,14 @@ function watchAssistant() {
     });
   });
 }
+function latestRequest(messages) {
+  for (let index = messages.length - 1;index >= 0; index--) {
+    if (messages[index].role !== "tool") {
+      return messages[index];
+    }
+  }
+  return;
+}
 function mountAiPanel() {
   if (mounted) {
     return;
@@ -42038,7 +42250,7 @@ function mountAiPanel() {
   onCredentialsChanged(renderAiPanel);
 }
 async function handleAssistantSend(text) {
-  if (!text.trim() || assistant.chatState.status === "streaming") {
+  if (!text.trim()) {
     return;
   }
   if (answerAsk(text.trim())) {
@@ -42046,12 +42258,17 @@ async function handleAssistantSend(text) {
     renderAiPanel();
     return;
   }
+  if (isAssistantStreaming()) {
+    return;
+  }
   view5 = "chat";
   surface?.pin();
   renderAiPanel();
   try {
     await assistant.sendMessage(text);
-  } catch {}
+  } catch {} finally {
+    renderAiPanel();
+  }
 }
 async function handleRetry() {
   const cs = assistant.chatState;
@@ -42085,6 +42302,9 @@ function handleRestore(messageId) {
   renderAiPanel();
 }
 async function seedAssistantPrompt(text) {
+  if (assistant.isTurnActive()) {
+    await assistant.whenTurnEnds();
+  }
   await handleAssistantSend(text);
 }
 async function revealImportHandoff(brief) {
@@ -42143,7 +42363,7 @@ function isAssistantWaiting() {
   return isAwaitingAnswer();
 }
 function isAssistantStreaming() {
-  return assistant.chatState.status === "streaming";
+  return assistant.isTurnActive();
 }
 function stop() {
   assistant.stop();
@@ -42316,6 +42536,9 @@ function assistantCommands() {
   ];
 }
 
+// src/hosting/document.ts
+var BOOT_META = { name: "jx-boot", content: "launcher" };
+
 // src/services/import-client.ts
 var IMPORT_WARNING_PHASE = "warning";
 async function streamImport(endpoint, opts, onProgress, signal, onReady) {
@@ -42489,7 +42712,7 @@ var STUDIO_ROUTES = {
   resolveSite: route("GET", "/__studio/resolve-site", "Resolve the owning site of a file path {sitePath, projectConfig?, fileRelPath?}"),
   sites: route("GET", "/__studio/sites", "Enumerate site projects [{config, path}] (backs listProjects)", "The welcome screen's Projects catalogue stays hidden."),
   findProject: route("GET", "/__studio/find-project", "Locate a project directory by name outside the root", "openProject falls back to config-matching only."),
-  locateDirectory: route("GET", "/__studio/locate-directory", `Resolve the absolute path of a showDirectoryPicker() folder by the id in its ${LOCATION_ID_FILE}`, "The New Project Location field loses its Browse… button and is typed by hand."),
+  locateDirectory: route("GET", "/__studio/locate-directory", `Resolve the absolute path of a showDirectoryPicker() folder by the id in its ${LOCATION_ID_FILE}`, "Browse… reports that the folder could not be placed; the Location is typed by hand."),
   createProject: route("POST", "/__studio/create-project", "Scaffold a project at a caller-chosen destination → {root, config}"),
   starters: route("GET", "/__studio/starters", "Starter templates (StarterInfo[])", "The New Project picker offers only blank/templates."),
   importSite: route("POST", "/__studio/import-site", "Clone a live website into a project; streams NDJSON progress", "The New Project Import tab is unavailable."),
@@ -42498,6 +42721,7 @@ var STUDIO_ROUTES = {
   fileWrite: route("PUT", "/__studio/file", "Write a file's text content"),
   fileDelete: route("DELETE", "/__studio/file", "Delete a file"),
   fileUpload: route("POST", "/__studio/file/upload", "Upload binary content to a path → UploadResult {path, size?}. `path` is the answer, not an " + "echo: a store that de-duplicates, suffixes, or normalizes names reports what it really wrote"),
+  fileBytes: route("GET", "/__studio/file/bytes", "A project file's raw bytes, undecoded — the read side of `fileUpload`, for a caller that must " + "not go through UTF-8", "Studio can only read a project file as text, so any surface that must decode one stays hidden."),
   documentRaw: route("GET", "/__studio/raw/", "A project file as its own bytes, at its own URL — the mount a canvas renders against when " + "the editor origin does not serve the site's URL space. The project-relative path is " + "appended to this prefix", "The canvas cannot address project files by URL, so a host whose origin does not serve the " + "site URL space renders no component $refs and no images."),
   fileRename: route("POST", "/__studio/file/rename", "Rename/move (+ refactor report). `from`/`to` are server-root-relative; every path in the " + "report is relative to the active project (specs/server.md §4.1)"),
   references: route("GET", "/__studio/references", "Where a file or a component tag is used (?path=&tag=, at least one) → ReferencesResult " + "{files, filesReferencing, refsTotal} — the read side of the rename refactor's own walker, " + "cached until the backend's watcher sees the tree move (backs findReferences). `?path=` is " + "server-root-relative and every path in the answer is relative to the active project; a " + "target outside that project is a 400, never a zero-result 200 (specs/server.md §4.1)", 'Usage counts are hidden: no "Used on N pages" in the inspector, no Selection: Find Usages, ' + "and delete/rename confirmations state no reference count."),
@@ -42798,6 +43022,13 @@ function createCloudPlatform(project) {
       const data = await okJson(await api(`/file?path=${encodeURIComponent(path)}`), `Failed to read file: ${path}`);
       return data.content;
     },
+    async readFileBytes(path) {
+      const res = await api(`/file/bytes?path=${encodeURIComponent(path)}`);
+      if (!res.ok) {
+        throw new Error(await errorMessage(res, `Failed to read file bytes: ${path}`));
+      }
+      return res.arrayBuffer();
+    },
     async writeFile(path, content) {
       const res = await api("/file", {
         method: "PUT",
@@ -42848,7 +43079,7 @@ function createCloudPlatform(project) {
       }
       const { offer } = negotiated;
       collabConnection ??= (async () => {
-        const { createWsCollabConnection } = await (__preload("ny4zc51r"), import("./chunks/ws-client-ny4zc51r.js"));
+        const { createWsCollabConnection } = await (__preload("erze4czt"), import("./chunks/ws-client-erze4czt.js"));
         const scheme = location.protocol === "https:" ? "wss" : "ws";
         return createWsCollabConnection({
           hydratePath: async (path) => {
@@ -43348,32 +43579,50 @@ function newLocationId() {
   globalThis.crypto.getRandomValues(bytes);
   return [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("");
 }
+function nameOf(error) {
+  return typeof error === "object" && error !== null && "name" in error && typeof error.name === "string" ? error.name : "";
+}
 async function pickDirectoryPath(locate) {
   const show = globalThis.showDirectoryPicker;
   if (typeof show !== "function") {
-    return null;
+    throw new TypeError("This browser has no folder chooser. Type the folder's path into Location instead.");
   }
   let handle;
   try {
     handle = await show({ id: "jx-new-project-location", mode: "readwrite", startIn: "documents" });
-  } catch {
-    return null;
+  } catch (error) {
+    if (nameOf(error) === "AbortError") {
+      return null;
+    }
+    throw new Error(`The folder chooser could not open (${errorMessage2(error)}). Type the folder's path into Location instead.`, { cause: error });
   }
+  const { name } = handle;
   const id = newLocationId();
+  let tagged = false;
   try {
-    const file = await handle.getFileHandle(LOCATION_ID_FILE, { create: true });
-    const writable = await file.createWritable();
-    await writable.write(id);
-    await writable.close();
-  } catch {
-    return null;
-  }
-  try {
-    return await locate({ id, name: handle.name });
-  } catch {
-    return null;
+    try {
+      const file = await handle.getFileHandle(LOCATION_ID_FILE, { create: true });
+      tagged = true;
+      const writable = await file.createWritable();
+      await writable.write(id);
+      await writable.close();
+    } catch (error) {
+      throw new Error(`Jx Studio can't write to "${name}" (${errorMessage2(error)}), so it can't create a project there. Choose a folder you can write to.`, { cause: error });
+    }
+    let path;
+    try {
+      path = await locate({ id, name });
+    } catch (error) {
+      throw new Error(`Jx Studio could not look up where "${name}" is: ${errorMessage2(error)}. Type the folder's path into Location instead.`, { cause: error });
+    }
+    if (!path) {
+      throw new Error(`Jx Studio could not find where "${name}" is. From a browser it can only find folders inside your home folder. Type its full path into Location instead.`);
+    }
+    return path;
   } finally {
-    await handle.removeEntry(LOCATION_ID_FILE).catch(() => {});
+    if (tagged) {
+      await handle.removeEntry(LOCATION_ID_FILE).catch(() => {});
+    }
   }
 }
 
@@ -43509,7 +43758,8 @@ function createDevServerPlatform() {
         return pickDirectoryPath(async ({ id, name }) => {
           const res = await fetch(`/__studio/locate-directory?name=${encodeURIComponent(name)}&id=${encodeURIComponent(id)}`);
           if (!res.ok) {
-            return null;
+            const body = await res.json().catch(() => null);
+            throw new Error(problemMessage(body, res.status));
           }
           const found = await readJson2(res);
           return found.path ?? null;
@@ -43545,6 +43795,13 @@ function createDevServerPlatform() {
       const data = await readJson2(res);
       return data.content;
     },
+    async readFileBytes(path) {
+      const res = await fetch(`/__studio/file/bytes?path=${encodeURIComponent(serverPath(path))}`);
+      if (!res.ok) {
+        throw new Error(`Failed to read file bytes: ${path}`);
+      }
+      return res.arrayBuffer();
+    },
     async writeFile(path, content) {
       const res = await fetch(`/__studio/file?path=${encodeURIComponent(serverPath(path))}`, {
         body: content,
@@ -43644,7 +43901,7 @@ function createDevServerPlatform() {
       }
       const { offer } = negotiation;
       _collabConnection ??= (async () => {
-        const { createWsCollabConnection } = await (__preload("ny4zc51r"), import("./chunks/ws-client-ny4zc51r.js"));
+        const { createWsCollabConnection } = await (__preload("erze4czt"), import("./chunks/ws-client-erze4czt.js"));
         const scheme = location.protocol === "https:" ? "wss" : "ws";
         return createWsCollabConnection({
           protocols: offer,
@@ -44166,7 +44423,7 @@ function createDevServerPlatform() {
       }
     },
     async cfApi(apiPath, init) {
-      const { getCfToken } = await (__preload("adg74qsk"), import("./chunks/cf-settings-adg74qsk.js"));
+      const { getCfToken } = await (__preload("m79r7p5y"), import("./chunks/cf-settings-m79r7p5y.js"));
       const token = getCfToken();
       if (!token) {
         throw new Error("No Cloudflare API token configured");
@@ -44184,7 +44441,7 @@ function createDevServerPlatform() {
       return envelope.result ?? envelope;
     },
     async cfConnection() {
-      const { getCfAccountId, getCfToken, setCfAccountId } = await (__preload("adg74qsk"), import("./chunks/cf-settings-adg74qsk.js"));
+      const { getCfAccountId, getCfToken, setCfAccountId } = await (__preload("m79r7p5y"), import("./chunks/cf-settings-m79r7p5y.js"));
       if (!getCfToken()) {
         return null;
       }
@@ -44222,7 +44479,59 @@ function createDevServerPlatform() {
 }
 
 // src/platforms/default-platform.ts
+var BACKENDLESS_SCHEMES = new Set(["views:", "file:"]);
+function bootEnvironment() {
+  const doc = globalThis.document;
+  const meta = `meta[name="${BOOT_META.name}"][content="${BOOT_META.content}"]`;
+  return {
+    cloud: globalThis.__jxCloud != null,
+    declared: doc?.querySelector(meta) != null,
+    launcher: launcherSignal2(),
+    protocol: globalThis.location?.protocol ?? ""
+  };
+}
+function bootRefusal(env = bootEnvironment()) {
+  if (env.launcher) {
+    return { kind: "launcher", launcher: env.launcher.launcher };
+  }
+  if (env.cloud) {
+    return null;
+  }
+  if (env.declared) {
+    return { kind: "declared" };
+  }
+  if (BACKENDLESS_SCHEMES.has(env.protocol)) {
+    return { kind: "scheme", protocol: env.protocol };
+  }
+  return null;
+}
+function refusalMessage(refusal) {
+  switch (refusal.kind) {
+    case "launcher": {
+      return `Jx Studio's launcher (${refusal.launcher ?? "unnamed"}) announced itself but registered no platform adapter.`;
+    }
+    case "declared": {
+      return "Jx Studio's page declares a boot module, but nothing registered a platform adapter.";
+    }
+    default: {
+      return `Jx Studio was opened from a ${refusal.protocol} URL, which has no backend for the dev-server adapter.`;
+    }
+  }
+}
+
+class PlatformUnavailableError extends Error {
+  refusal;
+  constructor(refusal) {
+    super(refusalMessage(refusal));
+    this.name = "PlatformUnavailableError";
+    this.refusal = refusal;
+  }
+}
 function resolveDefaultPlatform() {
+  const refusal = bootRefusal();
+  if (refusal) {
+    throw new PlatformUnavailableError(refusal);
+  }
   const cloud = globalThis.__jxCloud;
   return cloud ? createCloudPlatform(cloud.project) : createDevServerPlatform();
 }
@@ -45934,6 +46243,7 @@ function capabilities(platform) {
     gitClone: has("gitClone"),
     importSite: has("importSite"),
     openProjectInNewWindow: has("openProjectInNewWindow"),
+    readFileBytes: has("readFileBytes"),
     windowControls: has("newWindow")
   };
 }
@@ -46103,7 +46413,7 @@ function openSettingsMenu(anchor, opts = {}) {
 var rail_default = {
   $schema: "https://jxsuite.com/schema/v1",
   $id: "StudioRail",
-  $description: "The Navigator rail: a rendering of the panel registry. The adapter hands in `groups`, every rail-able panel grouped by level with its selected state and badge, and `settingsVisible`/`settingsOpen` for the foot's gear. Nothing here is a list of panels.",
+  $description: "The Navigator rail: a rendering of the panel registry. The adapter hands in `groups`, every rail-able panel grouped by level with its selected state and badge, and `settingsVisible`/`settingsOpen` for the foot's gear. Nothing here is a list of panels. Each button prints its record's short `railLabel` under the glyph, falling back to `title`, and carries the full `title` as its accessible name and tooltip: the visible words lead the name a reader hears (WCAG 2.5.3), and the tooltip restores what a short label leaves out.",
   tagName: "div",
   attributes: {
     part: "rail"
@@ -46247,7 +46557,7 @@ var rail_default = {
                       children: [
                         {
                           tagName: "span",
-                          textContent: "${$map.item.title}"
+                          textContent: "${$map.item.railLabel}"
                         }
                       ]
                     }
@@ -46378,6 +46688,7 @@ function project17() {
       badge: String(panel.badge?.(ctx) ?? ""),
       icon: panel.icon,
       id: panel.id,
+      railLabel: panel.railLabel ?? panel.title,
       selected: isRailPanelShowing(panel),
       title: panel.title
     }))
@@ -48599,7 +48910,7 @@ function installUrlOf(error) {
 var new_project_default = {
   $schema: "https://jxsuite.com/schema/v1",
   $id: "StudioNewProject",
-  $description: "The New Project wizard: two steps in one dialog. Step 1 asks where the site comes from — a starter gallery that ends with one Start from scratch card, an Import of a site that already exists, or an Agent brief — and step 2 asks what it is called and where it is written. A `jx-dialog`, so the platform owns modality, Escape, focus restoration and the backdrop, which is what retired the fixed `.new-project-modal` card, the `<sp-underlay>` beside it, the `z-index: 1000` that card needed to climb back out from under its own scrim, and the hand-drawn header with its own close button. The footer is the dialog's too: Cancel, Back and the primary are `cancelLabel`, `secondaryLabel` and `confirmLabel`, so the wizard says which answers exist by naming them rather than by drawing three buttons per step. Nothing here knows what a starter is, which platform writes to a repository rather than a folder, what makes an AI gate open, or how a breakpoint policy is spelled — `new-project/new-project-modal.ts` keeps the flow, `new-project/import-tab.ts` the brief and `new-project/location-fields.ts` the destination, and all three hand over strings, flags and one discriminant per branch. The three AI controllers are islands: their own mounted documents, placed by the adapter into boxes this document renders empty (§9.4).",
+  $description: "The New Project wizard: two steps in one dialog. Step 1 asks where the site comes from — a starter gallery that ends with one Start from scratch card, an Import of a site that already exists, or an Agent brief — and step 2 asks what it is called and where it is written. A `jx-dialog`, so the platform owns modality, Escape, focus restoration and the backdrop, which is what retired the fixed `.new-project-modal` card, the `<sp-underlay>` beside it, the `z-index: 1000` that card needed to climb back out from under its own scrim, and the hand-drawn header with its own close button. The footer is the dialog's too: Cancel, Back and the primary are `cancelLabel`, `secondaryLabel` and `confirmLabel`, so the wizard says which answers exist by naming them rather than by drawing three buttons per step. Nothing here knows what a starter is, which platform writes to a repository rather than a folder, what makes an AI gate open, or how a breakpoint policy is spelled — `new-project/new-project-modal.ts` keeps the flow, `new-project/import-tab.ts` the brief and `new-project/location-fields.ts` the destination, and all three hand over strings, flags and one discriminant per branch. The three AI controllers are islands: their own mounted documents, placed by the adapter into boxes this document renders empty (studio-ui-guidelines.md §9.4).",
   tagName: "jx-dialog",
   $props: {
     headline: {
@@ -50504,6 +50815,8 @@ async function browseLocation(rerender) {
       _parent = picked;
       _error2 = "";
     }
+  } catch (error) {
+    _error2 = errorMessage2(error) || "The folder could not be chosen. Type its path into Location instead.";
   } finally {
     _browsing = false;
     rerender();
@@ -50884,7 +51197,15 @@ function finish(result) {
   settle3(result);
 }
 async function finishCreated(result) {
-  await initProjectRepo2(result.root);
+  const { adopted, error, openedElsewhere } = await adoptCreatedProject(result.root, {
+    getTab: () => null
+  });
+  if (!adopted && !openedElsewhere) {
+    notify2.warn("Created the project, but could not open it here.", {
+      ...error === null ? {} : { detail: error },
+      source: "New Project"
+    });
+  }
   finish(result);
 }
 function deriveSlug(name) {
@@ -51354,7 +51675,7 @@ var seo_default = {
       }
     },
     '& [part="chip"]': {
-      $description: "The provenance vocabulary of `panels/provenance.ts` §6.2, drawn by this document rather than borrowed as a class: `set` keeps the accent dot it has always been, `inherited` is an amber pill naming its donor, and a field nothing supplies gets no chip at all — because a ghost dot on every unset row says less than silence. The two chips that can go somewhere are `<button>`s; the ones with nowhere to go are not, which is §6.2's rule that a control which looks pressable and does nothing is a defect.",
+      $description: "The provenance vocabulary of `panels/provenance.ts` (§6.7), drawn by this document rather than borrowed as a class: `set` keeps the accent dot it has always been, `inherited` is an amber pill naming its donor, and a field nothing supplies gets no chip at all — because a ghost dot on every unset row says less than silence. The two chips that can go somewhere are `<button>`s; the ones with nowhere to go are not, which is §6.7's rule that a control which looks pressable and does nothing is a defect.",
       flexShrink: "0"
     },
     '& jx-dot[part="chip"][data-state="set"]': {
@@ -54287,8 +54608,8 @@ var settings_css_vars_default = {
       fontWeight: "600",
       color: "var(--fg)"
     },
-    '& [part="error"]': {
-      $description: "A write that failed, said under the section title rather than pinned to a control. This section saves on change and the predecessor dropped every rejection on the floor, so a read-only file made each edit look as though it had been taken and then quietly forgotten.",
+    '& [part="section-error"]': {
+      $description: 'A write that failed, said under the section title rather than pinned to a control. This section saves on change and the predecessor dropped every rejection on the floor, so a read-only file made each edit look as though it had been taken and then quietly forgotten. It is `section-error` rather than `error` because every text field and select in the section draws a permanent `[part="error"]` of its own in this same light-DOM tree, and a rule on that name would give their refusal sentences this margin and size too.',
       margin: "0 0 12px",
       fontSize: "var(--jx-text-md)",
       color: "var(--danger)"
@@ -54444,7 +54765,7 @@ var settings_css_vars_default = {
     {
       tagName: "div",
       attributes: {
-        part: "error-slot",
+        part: "section-error-slot",
         role: "none"
       },
       $switch: {
@@ -54454,7 +54775,7 @@ var settings_css_vars_default = {
         true: {
           tagName: "p",
           attributes: {
-            part: "error",
+            part: "section-error",
             role: "alert"
           },
           textContent: "${state.error}"
@@ -57934,8 +58255,8 @@ var settings_extensions_default = {
       fontSize: "var(--jx-text-md)",
       color: "var(--fg-dim)"
     },
-    '& [part="error"]': {
-      $description: 'The last operation that failed, said under the section title. Not a second announcement: `updateSiteConfig` already files a Problem for a rejected write and `activity.fail` files one for a rejected install. §13.1 makes INLINE the tier for "the value is on screen, and nothing else is the right place" — the Problem is about the file, and this line is about the switch the reader is looking at.',
+    '& [part="section-error"]': {
+      $description: 'The last operation that failed, said under the section title. Not a second announcement: `updateSiteConfig` already files a Problem for a rejected write and `activity.fail` files one for a rejected install. studio-ui-guidelines.md §13.1 makes INLINE the tier for "the value is on screen, and nothing else is the right place" — the Problem is about the file, and this line is about the switch the reader is looking at. It is `section-error` rather than `error`, the name every settings section uses, because every kit field draws a permanent `[part="error"]` of its own and the kit is light DOM: a rule on that name here would reach any field the section ever holds.',
       margin: "6px 0 0",
       fontSize: "var(--jx-text-md)",
       color: "var(--danger)"
@@ -57952,7 +58273,7 @@ var settings_extensions_default = {
       color: "var(--fg)"
     },
     '& [part="row"]': {
-      $description: "A wrapping row, never an overflowing one (guidelines §4.6): the package name is author-supplied and unbounded, and Project Settings renders at two very different widths.",
+      $description: "A wrapping row, never an overflowing one (studio-ui-guidelines.md §4.6): the package name is author-supplied and unbounded, and Project Settings renders at two very different widths.",
       display: "flex",
       flexWrap: "wrap",
       alignItems: "flex-start",
@@ -58028,7 +58349,7 @@ var settings_extensions_default = {
       flexShrink: "0"
     },
     '& [part="empty"]': {
-      $description: 'The teaching empty state, drawn here rather than borrowed from `panels/empty-state.ts`: that helper is a lit template, and a document cannot call one. What is kept is the pattern\'s rules (§11) — one sentence saying what the region is FOR, never "no extensions", then where its content comes from — in the compact shape, which reads as a note inside an otherwise populated pane rather than as a whole empty region. It offers no action because there is nothing here to act on: a backend that lists no catalogue is not a project waiting to be filled in.',
+      $description: 'The teaching empty state, drawn here rather than borrowed from `panels/empty-state.ts`: that helper is a lit template, and a document cannot call one. What is kept is the pattern\'s rules (studio-ui-guidelines.md §11) — one sentence saying what the region is FOR, never "no extensions", then where its content comes from — in the compact shape, which reads as a note inside an otherwise populated pane rather than as a whole empty region. It offers no action because there is nothing here to act on: a backend that lists no catalogue is not a project waiting to be filled in.',
       display: "flex",
       flexDirection: "column",
       alignItems: "flex-start",
@@ -58065,7 +58386,7 @@ var settings_extensions_default = {
     {
       tagName: "div",
       attributes: {
-        part: "error-slot",
+        part: "section-error-slot",
         role: "none"
       },
       style: {
@@ -58078,7 +58399,7 @@ var settings_extensions_default = {
         true: {
           tagName: "p",
           attributes: {
-            part: "error",
+            part: "section-error",
             role: "alert"
           },
           textContent: "${state.error}"
@@ -58620,8 +58941,8 @@ var settings_deploy_default = {
       fontWeight: "600",
       color: "var(--fg)"
     },
-    '& [part="error"]': {
-      $description: "A write that failed, said under the section title rather than pinned to the picker: settings save on change, so a silent rejection would read as \"my edit just vanished\", and what failed was the whole file rather than the value. Its size read `--spectrum-font-size-75` with a 12px fallback, which resolved only inside `<sp-theme>` — a document is mounted in the settings pane, where that name is not in scope and the fallback is all it would ever have taken — so the size is the kit's scale and the colour is the studio layer's.",
+    '& [part="section-error"]': {
+      $description: 'A write that failed, said under the section title rather than pinned to the picker: settings save on change, so a silent rejection would read as "my edit just vanished", and what failed was the whole file rather than the value. Its size read `--spectrum-font-size-75` with a 12px fallback, which resolved only inside `<sp-theme>` — a document is mounted in the settings pane, where that name is not in scope and the fallback is all it would ever have taken — so the size is the kit\'s scale and the colour is the studio layer\'s. It is `section-error` rather than `error` because the adapter picker is a `jx-select`, which draws a permanent `[part="error"]` of its own in this same light-DOM tree: a rule on that name would give the picker\'s own refusal sentence this 16px margin too.',
       margin: "0 0 16px",
       fontSize: "var(--jx-text-md)",
       color: "var(--danger)"
@@ -58642,7 +58963,7 @@ var settings_deploy_default = {
     {
       tagName: "div",
       attributes: {
-        part: "error-slot",
+        part: "section-error-slot",
         role: "none"
       },
       style: {
@@ -58655,7 +58976,7 @@ var settings_deploy_default = {
         true: {
           tagName: "p",
           attributes: {
-            part: "error",
+            part: "section-error",
             role: "alert"
           },
           textContent: "${state.error}"
@@ -60616,8 +60937,8 @@ var settings_locales_default = {
       fontSize: "var(--jx-text-md)",
       color: "var(--fg-dim)"
     },
-    '& [part="error"]': {
-      $description: 'A write that failed, said under the section title rather than pinned to a control: settings save on change, so a silent rejection would read as "my edit just vanished", and the whole file failed rather than one field.',
+    '& [part="section-error"]': {
+      $description: "A write that failed, said under the section title rather than pinned to a control: settings save on change, so a silent rejection would read as \"my edit just vanished\", and the whole file failed rather than one field. It is `section-error` rather than `error` because the tag field's refusal IS the kit's own `[part=\"error\"]` sentence, in this same light-DOM tree: a rule on that name gave the tag field's refusal this margin and size, and reached the two pickers' empty regions as well.",
       margin: "6px 0 0",
       fontSize: "var(--jx-text-md)",
       color: "var(--danger)"
@@ -60691,7 +61012,7 @@ var settings_locales_default = {
     {
       tagName: "div",
       attributes: {
-        part: "error-slot",
+        part: "section-error-slot",
         role: "none"
       },
       $switch: {
@@ -60701,7 +61022,7 @@ var settings_locales_default = {
         true: {
           tagName: "p",
           attributes: {
-            part: "error",
+            part: "section-error",
             role: "alert"
           },
           textContent: "${state.error}"
@@ -61297,7 +61618,7 @@ async function openProjectSettings(section) {
   showSettingsDocument();
   notifySettingsDocument2();
   try {
-    const { syncExtensionSettingsSections } = await (__preload("2mrptyek"), import("./chunks/extension-sections-2mrptyek.js"));
+    const { syncExtensionSettingsSections } = await (__preload("r73an5s6"), import("./chunks/extension-sections-r73an5s6.js"));
     await syncExtensionSettingsSections();
   } catch (error) {
     notify2.warn(`Could not load extension settings sections — ${errorMessage2(error)}`, {
@@ -61434,9 +61755,11 @@ var about_default = {
       color: "var(--fg-dim)"
     },
     '& [part="meta-value"]': {
+      $description: "One of the two places in the chrome that opt back in to selection (`STYLING.md` §Text selection). The root sets `user-select: none` and `styles/tokens.json` restates it on every modal `dialog`, but this dialog's body IS its message: the version, the build date, the commit and the channel exist to be pasted into a bug report, and Studio offers no copy action for them.",
       margin: "0",
       color: "var(--fg)",
-      wordBreak: "break-word"
+      wordBreak: "break-word",
+      userSelect: "text"
     },
     '& [part="links"]': {
       display: "flex",
@@ -61474,10 +61797,12 @@ var about_default = {
       gap: "4px"
     },
     '& [part="package-row"]': {
+      $description: "Selectable for the same reason `meta-value` is, and on the ROW rather than on the version alone: what a reader pastes is the pair, `@jxsuite/ai 0.37.0`, so a drag has to be able to cross from the name to the number and on down the list.",
       display: "flex",
       justifyContent: "space-between",
       gap: "12px",
-      fontSize: "var(--jx-text-md)"
+      fontSize: "var(--jx-text-md)",
+      userSelect: "text"
     },
     '& [part="package-name"]': {
       color: "var(--fg-dim)"
@@ -61707,9 +62032,9 @@ function openAboutSurface(options) {
 
 // src/version.ts
 var APP_NAME = "Jx Studio";
-var VERSION = "5.3.0";
-var BUILD_DATE = "2026-09-22T01:30:39.991Z";
-var GIT_COMMIT = "2928bf2";
+var VERSION = "5.4.0";
+var BUILD_DATE = "2026-09-29T19:41:26.105Z";
+var GIT_COMMIT = "fd18dbe";
 var LINKS = {
   github: "https://github.com/jxsuite/jx",
   docs: "https://github.com/jxsuite/jx#readme",
@@ -62117,9 +62442,9 @@ function withExtension(path, ext) {
   return current === "" ? `${path}${ext}` : `${path.slice(0, path.length - current.length)}${ext}`;
 }
 async function readDocument(path, source) {
-  const { formatForPath } = await (__preload("1k4qrcqd"), import("./chunks/format-host-1k4qrcqd.js"));
+  const { formatForPath } = await (__preload("mym8qnd0"), import("./chunks/format-host-mym8qnd0.js"));
   if (formatForPath(path)) {
-    const { parseSourceForPath } = await (__preload("knfqshrm"), import("./chunks/file-ops-knfqshrm.js"));
+    const { parseSourceForPath } = await (__preload("3xan8mnj"), import("./chunks/file-ops-3xan8mnj.js"));
     const parsed = await parseSourceForPath(path, source);
     return { document: parsed.document, frontmatter: parsed.frontmatter };
   }
@@ -62130,7 +62455,7 @@ async function writeDocument(targetExt, document2, frontmatter) {
   if (targetExt === ".json") {
     return serializeJson(merged, null);
   }
-  const { formatByExtension, formatSerialize } = await (__preload("1k4qrcqd"), import("./chunks/format-host-1k4qrcqd.js"));
+  const { formatByExtension, formatSerialize } = await (__preload("mym8qnd0"), import("./chunks/format-host-mym8qnd0.js"));
   const format = formatByExtension(targetExt, "serialize");
   if (!format) {
     throw new Error(`No installed format writes ${targetExt} files.`);
@@ -62185,7 +62510,7 @@ async function buildPlan(path, source, targetExt) {
   if (!await readsBackIdentically(targetPath, text)) {
     lines.push("This file will not read back identically after conversion.");
   }
-  const { loadUsages, usageWarning } = await (__preload("h69xp9zz"), import("./chunks/references-h69xp9zz.js"));
+  const { loadUsages, usageWarning } = await (__preload("f7bdv3z5"), import("./chunks/references-f7bdv3z5.js"));
   const sentence = usageWarning(await loadUsages({ path }), "convert");
   if (sentence !== null) {
     lines.push(sentence);
@@ -62200,14 +62525,14 @@ async function convertFile(path, targetExt) {
     notify.error(message, { detail, path, source: "Convert" });
     return null;
   };
-  const { loadFormats } = await (__preload("1k4qrcqd"), import("./chunks/format-host-1k4qrcqd.js"));
+  const { loadFormats } = await (__preload("mym8qnd0"), import("./chunks/format-host-mym8qnd0.js"));
   await loadFormats();
   const targets = convertTargets(path);
   if (targets.length === 0) {
     return fail(`${path} cannot be converted to another format.`, CANNOT_CONVERT);
   }
-  const { workspace } = await (__preload("np10mayv"), import("./chunks/workspace-np10mayv.js"));
-  const { commitTabBuffers } = await (__preload("pykwbm92"), import("./chunks/monaco-buffer-pykwbm92.js"));
+  const { workspace } = await (__preload("b9k2frks"), import("./chunks/workspace-b9k2frks.js"));
+  const { commitTabBuffers } = await (__preload("jaq1t9zj"), import("./chunks/monaco-buffer-jaq1t9zj.js"));
   const openTabEntry = [...workspace.tabs.values()].find((tab) => tab.documentPath === path);
   if (openTabEntry) {
     await commitTabBuffers(openTabEntry);
@@ -62222,7 +62547,7 @@ async function convertFile(path, targetExt) {
   if (!targets.some((target) => target.ext === chosen)) {
     return fail(`${path} cannot be converted to ${chosen}.`, CANNOT_CONVERT);
   }
-  const { getPlatform } = await (__preload("ts9cg1a4"), import("./chunks/platform-ts9cg1a4.js"));
+  const { getPlatform } = await (__preload("fnchmhy7"), import("./chunks/platform-fnchmhy7.js"));
   const platform = getPlatform();
   const targetPath = withExtension(path, chosen);
   try {
@@ -62244,7 +62569,7 @@ async function convertFile(path, targetExt) {
   if (plan.blocker !== null) {
     return fail(`${path} cannot be converted to ${chosen}.`, plan.blocker);
   }
-  const { showConfirmDialog } = await (__preload("jnvdbqva"), import("./chunks/layers-jnvdbqva.js"));
+  const { showConfirmDialog } = await (__preload("s6mc01ry"), import("./chunks/layers-s6mc01ry.js"));
   const { html } = await (__preload("m244w9nh"), import("./chunks/lit-html-m244w9nh.js"));
   const confirmed = await showConfirmDialog("Convert Format", html`<span
         >Convert <strong>${path.split("/").pop()}</strong> to
@@ -62253,8 +62578,8 @@ async function convertFile(path, targetExt) {
   if (!confirmed) {
     return null;
   }
-  const { markLocalMutation } = await (__preload("3y6y0nrm"), import("./chunks/fs-events-3y6y0nrm.js"));
-  const { notifyMoveOutcome, settleRename } = await (__preload("y6fr4he9"), import("./chunks/files-y6fr4he9.js"));
+  const { markLocalMutation } = await (__preload("z2gg8qjt"), import("./chunks/fs-events-z2gg8qjt.js"));
+  const { notifyMoveOutcome, settleRename } = await (__preload("egsb0ry8"), import("./chunks/files-egsb0ry8.js"));
   markLocalMutation(path, plan.targetPath);
   try {
     await platform.writeFile(path, plan.text);
@@ -62279,8 +62604,8 @@ async function convertFile(path, targetExt) {
   return plan.targetPath;
 }
 async function rebuildTab(from, to, text) {
-  const { openTab, renameTab } = await (__preload("np10mayv"), import("./chunks/workspace-np10mayv.js"));
-  const { formatForPath } = await (__preload("1k4qrcqd"), import("./chunks/format-host-1k4qrcqd.js"));
+  const { openTab, renameTab } = await (__preload("b9k2frks"), import("./chunks/workspace-b9k2frks.js"));
+  const { formatForPath } = await (__preload("mym8qnd0"), import("./chunks/format-host-mym8qnd0.js"));
   renameTab(from, to, to);
   const format = formatForPath(to);
   let document2;
@@ -62288,7 +62613,7 @@ async function rebuildTab(from, to, text) {
   let layout = null;
   try {
     if (format) {
-      const { parseSourceForPath } = await (__preload("knfqshrm"), import("./chunks/file-ops-knfqshrm.js"));
+      const { parseSourceForPath } = await (__preload("3xan8mnj"), import("./chunks/file-ops-3xan8mnj.js"));
       ({ document: document2, frontmatter } = await parseSourceForPath(to, text));
     } else {
       ({ document: document2, layout } = parseJsonDocument(text));
@@ -62317,7 +62642,7 @@ async function pickTarget(path, targets) {
   if (targets.length === 1) {
     return targets[0].ext;
   }
-  const { showPromptDialog } = await (__preload("jnvdbqva"), import("./chunks/layers-jnvdbqva.js"));
+  const { showPromptDialog } = await (__preload("s6mc01ry"), import("./chunks/layers-s6mc01ry.js"));
   let picked = targets[0].ext;
   const answer = await showPromptDialog("Convert Format", {
     choice: {
@@ -62442,7 +62767,7 @@ function publishCommands() {
       when: (ctx) => ctx.project.open,
       enablement: () => platformSupportsPublish(),
       run: async () => {
-        const { openPublishPanel } = await (__preload("z1zd2da1"), import("./chunks/publish-panel-z1zd2da1.js"));
+        const { openPublishPanel } = await (__preload("ak6hxfma"), import("./chunks/publish-panel-ak6hxfma.js"));
         openPublishPanel();
       },
       title: "Set Up Publishing"
@@ -63143,7 +63468,7 @@ function i18nCommands() {
           });
           return;
         }
-        const { openFileInTab } = await (__preload("y6fr4he9"), import("./chunks/files-y6fr4he9.js"));
+        const { openFileInTab } = await (__preload("egsb0ry8"), import("./chunks/files-egsb0ry8.js"));
         await openFileInTab(path);
       },
       title: "Open Translation"
@@ -63188,7 +63513,7 @@ function i18nCommands() {
           return;
         }
         const cut = path.lastIndexOf("/");
-        const { createFileIn, openFileInTab } = await (__preload("y6fr4he9"), import("./chunks/files-y6fr4he9.js"));
+        const { createFileIn, openFileInTab } = await (__preload("egsb0ry8"), import("./chunks/files-egsb0ry8.js"));
         const created = await createFileIn({
           content,
           dir: cut === -1 ? "." : path.slice(0, cut),
@@ -63359,6 +63684,293 @@ registerSurface("shell", shell_default);
 function mountShellSurface(host) {
   return mountSurface("shell", {}, host);
 }
+// src/surfaces/boot-failure.json
+var boot_failure_default = {
+  $schema: "https://jxsuite.com/schema/v1",
+  $id: "StudioBootFailure",
+  $description: 'What Studio draws INSTEAD of the application frame when a launcher was supposed to register a platform adapter and did not (`platforms/default-platform.ts`\'s `bootRefusal`). It replaces a failure that drew everything: desktop 5.0.0 to 5.1.3 fell back to the dev-server adapter inside a `views://` window, so every panel rendered and the first click said "Failed to fetch". This says so up front instead: what failed, the error the launcher recorded, and the facts a support thread needs, with a Reload for a transient failure and a Copy for everything else. The adapter decides every sentence; the document only draws them. It is the whole page, so it carries a window drag strip of its own — the desktop window hides its title bar, and with no Command Bar mounted there is otherwise nothing to move the window by.',
+  tagName: "div",
+  attributes: {
+    part: "screen",
+    role: "alert"
+  },
+  style: {
+    $description: "Tokens throughout: the screen is mounted before anything but the kit's theme has run, so it can lean on nothing the frame's stylesheets declare. The top padding clears the macOS traffic lights, which sit over the page because the window's title bar is hidden.",
+    position: "fixed",
+    inset: "0",
+    display: "flex",
+    alignItems: "flex-start",
+    justifyContent: "center",
+    paddingTop: "max(10vh, calc(var(--jx-control-h) * 2))",
+    overflowY: "auto",
+    boxSizing: "border-box",
+    background: "var(--jx-bg)",
+    fontFamily: "var(--jx-font-sans)",
+    color: "var(--jx-fg)",
+    '& > [part="drag-strip"]': {
+      $description: "The window's handle. Electrobun's preload recognises the class and supplies the drag behaviour itself, so the rule here only sizes the strip: as tall as the hidden title bar would have been.",
+      position: "absolute",
+      top: "0",
+      left: "0",
+      right: "0",
+      height: "calc(var(--jx-control-h) + var(--jx-space-3))"
+    },
+    '& > [part="content"]': {
+      position: "relative",
+      maxWidth: "40rem",
+      width: "100%",
+      padding: "0 var(--jx-space-6) var(--jx-space-7)",
+      boxSizing: "border-box",
+      display: "flex",
+      flexDirection: "column",
+      gap: "var(--jx-space-4)"
+    },
+    '& > [part="content"] > [part="icon"]': {
+      $description: 'The child, not any descendant: `jx-button` renders its own `<span part="icon">` into light DOM unconditionally, so a bare `[part="icon"]` reached the Reload and Copy buttons too. `--jx-icon-size` is a custom property and `color` inherits, so both passed through that span\'s `display: contents` and drew the Copy button\'s clipboard glyph at 32px in warning amber, stretching the actions row with it. This is the collision `[part="error"]` taught: a part name is shared with the kit unless a selector says otherwise.',
+      "--jx-icon-size": "2rem",
+      color: "var(--jx-warning)"
+    },
+    '& [part="title"]': {
+      margin: "0",
+      fontSize: "1.5rem",
+      fontWeight: "400",
+      color: "var(--jx-fg)"
+    },
+    '& [part="lead"]': {
+      margin: "0",
+      fontSize: "var(--jx-text-lg)",
+      lineHeight: "1.5",
+      color: "var(--jx-fg)"
+    },
+    '& [part="detail"]': {
+      $description: "The launcher's own error, verbatim. Selectable, because the point of printing it is that someone pastes it into an issue, and wrapped, because a stack line is wider than any window it is likely to be read in.",
+      margin: "0",
+      padding: "var(--jx-space-3) var(--jx-space-4)",
+      maxHeight: "40vh",
+      overflow: "auto",
+      background: "var(--jx-bg-panel)",
+      border: "1px solid var(--jx-border)",
+      borderRadius: "var(--jx-radius-sm)",
+      fontFamily: "var(--jx-font-mono)",
+      fontSize: "var(--jx-text-sm)",
+      whiteSpace: "pre-wrap",
+      wordBreak: "break-word",
+      userSelect: "text"
+    },
+    '& [part="facts"]': {
+      margin: "0",
+      fontSize: "var(--jx-text-sm)",
+      color: "var(--jx-fg-dim)",
+      wordBreak: "break-all",
+      userSelect: "text"
+    },
+    '& [part="actions"]': {
+      display: "flex",
+      flexWrap: "wrap",
+      gap: "var(--jx-space-3)"
+    }
+  },
+  children: [
+    {
+      tagName: "div",
+      attributes: {
+        part: "drag-strip",
+        class: "electrobun-webkit-app-region-drag",
+        "aria-hidden": "true"
+      }
+    },
+    {
+      tagName: "div",
+      attributes: {
+        part: "content"
+      },
+      children: [
+        {
+          tagName: "jx-icon",
+          attributes: {
+            part: "icon"
+          },
+          $props: {
+            name: "warning",
+            weight: "fill"
+          }
+        },
+        {
+          tagName: "h1",
+          attributes: {
+            part: "title"
+          },
+          textContent: "${state.title}"
+        },
+        {
+          tagName: "p",
+          attributes: {
+            part: "lead"
+          },
+          textContent: "${state.lead}"
+        },
+        {
+          tagName: "div",
+          attributes: {
+            part: "detail-slot",
+            role: "none"
+          },
+          style: {
+            display: "contents"
+          },
+          $switch: {
+            $ref: "#/state/hasDetail"
+          },
+          cases: {
+            true: {
+              tagName: "pre",
+              attributes: {
+                part: "detail"
+              },
+              textContent: "${state.detail}"
+            }
+          }
+        },
+        {
+          tagName: "p",
+          attributes: {
+            part: "facts"
+          },
+          textContent: "${state.facts}"
+        },
+        {
+          tagName: "div",
+          attributes: {
+            part: "actions"
+          },
+          children: [
+            {
+              tagName: "jx-button",
+              attributes: {
+                part: "reload"
+              },
+              $props: {
+                variant: "accent"
+              },
+              onclick: {
+                $prototype: "Function",
+                body: [
+                  {
+                    operator: "call",
+                    target: {
+                      $ref: "#/state/reload"
+                    },
+                    value: []
+                  }
+                ]
+              },
+              children: [
+                {
+                  tagName: "span",
+                  textContent: "Reload"
+                }
+              ]
+            },
+            {
+              tagName: "jx-button",
+              attributes: {
+                part: "copy"
+              },
+              $props: {
+                quiet: true
+              },
+              onclick: {
+                $prototype: "Function",
+                body: [
+                  {
+                    operator: "call",
+                    target: {
+                      $ref: "#/state/copy"
+                    },
+                    value: []
+                  }
+                ]
+              },
+              children: [
+                {
+                  tagName: "jx-icon",
+                  attributes: {
+                    slot: "icon"
+                  },
+                  $props: {
+                    name: "copy"
+                  }
+                },
+                {
+                  tagName: "span",
+                  textContent: "${state.copied ? 'Copied' : 'Copy details'}"
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ]
+};
+
+// src/surfaces/boot-failure.ts
+registerSurface("boot-failure", boot_failure_default);
+function leadFor(refusal) {
+  if (refusal.kind === "launcher") {
+    return "The desktop app's bridge to its backend failed to start, so nothing can be opened, saved or created; reinstalling the latest release from the download page fixes this.";
+  }
+  if (refusal.kind === "declared") {
+    return "This page's startup script never ran, so Studio has no backend to open, save or create projects with.";
+  }
+  return `This page was opened from a ${refusal.protocol} URL, which has no Studio backend behind it; open Studio through the desktop app or a Jx dev server instead.`;
+}
+function detailFor() {
+  const error = launcherSignal2()?.error;
+  if (!error) {
+    return "";
+  }
+  const { message, stack } = error;
+  if (!stack) {
+    return message;
+  }
+  return stack.includes(message) ? stack : `${message}
+${stack}`;
+}
+function bootFailureView(refusal, page = location) {
+  const detail = detailFor();
+  const launcher = (refusal.kind === "launcher" ? refusal.launcher : undefined) ?? launcherSignal2()?.launcher ?? "none";
+  const [where] = page.href.split(/[?#]/u);
+  return {
+    detail,
+    facts: `${APP_NAME} bundle ${VERSION} (${GIT_COMMIT}) · launcher ${launcher} · ${where}`,
+    hasDetail: detail !== "",
+    lead: leadFor(refusal),
+    title: "Jx Studio couldn't connect to its backend"
+  };
+}
+function bootFailureReport(view) {
+  return [view.title, view.lead, view.detail, view.facts].filter(Boolean).join(`
+
+`);
+}
+function mountBootFailureSurface(host, refusal, page = location) {
+  const view = bootFailureView(refusal, page);
+  const scope = reactive({
+    ...view,
+    copied: false,
+    async copy() {
+      try {
+        await navigator.clipboard.writeText(bootFailureReport(view));
+        scope.copied = true;
+      } catch {}
+    },
+    reload() {
+      location.reload();
+    }
+  });
+  return mountSurface("boot-failure", scope, host);
+}
 
 // src/shell/tree.ts
 function overlayLayers() {
@@ -63393,6 +64005,12 @@ async function mountShellTree(host = document.body) {
   await mountShellSurface(root);
   render4(overlayLayers(), root);
 }
+async function mountBootFailureTree(refusal, host = document.body) {
+  const root = shellRoot(host);
+  root.textContent = "";
+  delete root["_$litPart$"];
+  await mountBootFailureSurface(root, refusal);
+}
 function shellRoot(host) {
   const existing = host.querySelector?.("#shell-root");
   if (existing) {
@@ -63444,7 +64062,14 @@ async function navigateToComponent(componentPath) {
 }
 initCssData(webdata_default);
 if (!hasPlatform2()) {
-  registerPlatform2(resolveDefaultPlatform());
+  try {
+    registerPlatform2(resolveDefaultPlatform());
+  } catch (error) {
+    if (error instanceof PlatformUnavailableError) {
+      await mountBootFailureTree(error.refusal);
+    }
+    throw error;
+  }
 }
 mountResizeEdges();
 registerKit();
@@ -63471,6 +64096,7 @@ mount5(primaryCell?.chrome ?? document.createElement("div"), {
   parseMediaEntries,
   setCanvasMode
 });
+setDiffChromeRepaint(render7);
 mount4({
   isEditing,
   renderBlockActionBar
@@ -63552,11 +64178,8 @@ initWelcome({
     }
   },
   cloneRepository: () => cloneRepository2({ openRecentProject }),
-  openNewProject: async (options) => {
-    const result = await openNewProjectModal(options);
-    if (result) {
-      openRecentProject(result.root);
-    }
+  openNewProject: (options) => {
+    openNewProjectModal(options);
   },
   openProject: () => openProject(),
   openRecentProject: (root) => openRecentProject(root)
@@ -64084,5 +64707,5 @@ export {
   hasUnsavedTabs
 };
 
-//# debugId=596158A5181569F864756E2164756E21
+//# debugId=17BBB037A446E70F64756E2164756E21
 //# sourceMappingURL=studio.js.map