pmx-canvas 0.7.3 → 0.8.2

package/dist/json-render/index.js

@@ -920,4 +920,4 @@ html[data-jr-devtools-picking="true"] * {
   <path d="M16 21h1a2 2 0 0 0 2-2v-5a2 2 0 0 1 2-2 2 2 0 0 1-2-2V5a2 2 0 0 0-2-2h-1"/>
 </svg>`;function wte(){return{id:$2e,label:"Spec",badge(e){let t=e.getSpec();if(!t)return;return Object.keys(t.elements).length||void 0},mount(e,t){return q2e(e,t)}}}function q2e(e,t){let r=new Set,n=te("div",{className:"jr-split-left",role:"tree",tabindex:"0"}),a=te("div",{className:"jr-generations","aria-label":"Spec generation"}),o=null,i=null,s=te("nav",{className:"jr-breadcrumbs","aria-label":"Selected element ancestors"}),l=te("div",{className:"jr-breadcrumbs-trail"}),u=te("div",{className:"jr-breadcrumbs-tools",role:"group","aria-label":"Spec view"}),c=te("button",{className:"jr-view-btn",type:"button",title:"Tree view","aria-label":"Tree view","data-active":"true",onClick:()=>m("tree")});c.innerHTML=U2e;let f=te("button",{className:"jr-view-btn",type:"button",title:"Raw JSON view","aria-label":"Raw JSON view","data-active":"false",onClick:()=>m("raw")});f.innerHTML=V2e,u.append(c,f),s.append(l,u);let d=te("div",{className:"jr-tree-rows"});n.append(a,s,d);let p=te("div",{className:"jr-split-right"});e.appendChild(te("div",{className:"jr-split"},n,p));let g="tree";function m(z){if(g===z)return;g=z,c.dataset.active=String(g==="tree"),f.dataset.active=String(g==="raw"),j()}let y=t.selection.subscribe(()=>{let z=t.selection.get();if(z){let{spec:_,generations:O}=T();if(_&&!_.elements[z]&&O.length>1){let k=O.find((E)=>E.spec.elements[z]);if(k)o=k.id}}j()}),h=()=>oo(null);n.addEventListener("mouseleave",h);let v=[];function x(z){if(r.has(z))r.delete(z);else r.add(z);j()}function S(){n.querySelector('.jr-tree-row[data-selected="true"]')?.scrollIntoView({block:"nearest"})}function C(z){if(!z)return;t.selection.set(z),oo(z),S()}function P(z){if(g==="raw")return;if(z.metaKey||z.ctrlKey||z.altKey)return;let _=z.key;if(_!=="ArrowUp"&&_!=="ArrowDown"&&_!=="ArrowLeft"&&_!=="ArrowRight"&&_!=="Enter"&&_!==" "&&_!=="Home"&&_!=="End")return;let{spec:O}=T();if(!O||v.length===0)return;let k=t.selection.get(),E=k?v.indexOf(k):-1;if(z.preventDefault(),_==="ArrowDown"){if(E<0)C(v[0]);else C(v[Math.min(E+1,v.length-1)]);return}if(_==="ArrowUp"){if(E<0)C(v[0]);else C(v[Math.max(E-1,0)]);return}if(_==="Home"){C(v[0]);return}if(_==="End"){C(v[v.length-1]);return}if(_==="ArrowRight"){if(!k){C(v[0]);return}let D=O.elements[k],W=Ql(D);if(!(W.length>0))return;if(!r.has(k))r.add(k),j(),S();else C(W[0]);return}if(_==="ArrowLeft"){if(!k)return;let D=O.elements[k];if(Ql(D).length>0&&r.has(k))r.delete(k),j(),S();else{let K=K2e(O,k);if(K)C(K)}return}if(!k){C(v[0]);return}let L=O.elements[k];if(Ql(L).length>0)x(k),S()}let A=()=>{let z=t.selection.get();if(z)oo(z)},I=(z)=>{let _=z.relatedTarget;if(!_||!n.contains(_))oo(null)},R=()=>{try{n.focus({preventScroll:!0})}catch{}};n.addEventListener("mousedown",R),n.addEventListener("keydown",P),n.addEventListener("focusin",A),n.addEventListener("focusout",I);function T(){let z=t.getSpecs?.()??[];if(z.length===0)return{spec:t.getSpec(),generations:z};let _=z[z.length-1];if(o==null||!z.some((k)=>k.id===o))o=_.id;else if(i!=null&&o===i&&i!==_.id)o=_.id;return i=_.id,{spec:z.find((k)=>k.id===o).spec,generations:z}}function N(z){if(z.length<2){zt(a,null);return}let _=z[z.length-1].id,O=te("select",{className:"jr-generation-select","aria-label":"Inspect generation",onChange:(E)=>{o=E.target.value,j()}},...z.map((E,L)=>te("option",{value:E.id,selected:E.id===o?"true":void 0},E.id===_?`Gen ${L+1} (latest)`:`Gen ${L+1}`))),k=te("span",{className:"jr-generations-count"},`${z.length} generation${z.length===1?"":"s"}`);zt(a,O,k)}function j(){let{spec:z,generations:_}=T();if(N(_),!z||!z.root||Object.keys(z.elements).length===0){v=[],Z(null,null),zt(d,te("div",{className:"jr-empty"},"No spec attached.")),zt(p,null);return}let O=G2e(z),k=t.selection.get(),E=k?Z2e(z,k):[];for(let L of E)r.add(L);if(v=H2e(z,r),Z(z,E),g==="raw")q(z);else zt(d,Cte(z,z.root,0,r,k,O,t,x,null));if(k&&z.elements[k])Y2e(p,z,k,O);else zt(p,te("div",{className:"jr-empty"},"Select an element to inspect."))}function q(z){let _;try{_=JSON.stringify(z,null,2)}catch{_=String(z)}zt(d,te("pre",{className:"jr-raw"},_))}function Z(z,_){if(!z||!_||_.length===0){zt(l,te("span",{className:"jr-breadcrumbs-empty"},"No element selected"));return}let O=[..._].reverse(),k=[];O.forEach((E,L)=>{let W=z.elements[E]?.type??"<missing>",K=L===O.length-1,Y=te("button",{className:"jr-breadcrumb",type:"button","data-current":String(K),title:`#${E}`,onClick:(ae)=>{ae.stopPropagation(),t.selection.set(E),oo(E)},onMouseEnter:()=>oo(E),onMouseLeave:()=>oo(null)},W);if(k.push(Y),!K)k.push(te("span",{className:"jr-breadcrumb-sep"},"▸"))}),zt(l,k)}return j(),{update:j,destroy(){y(),n.removeEventListener("mouseleave",h),n.removeEventListener("mousedown",R),n.removeEventListener("keydown",P),n.removeEventListener("focusin",A),n.removeEventListener("focusout",I),oo(null)}}}function H2e(e,t){let r=[];function n(a){r.push(a);let o=e.elements[a],i=Ql(o);if(i.length===0)return;if(!t.has(a))return;for(let s of i)n(s)}return n(e.root),r}function K2e(e,t){for(let[r,n]of Object.entries(e.elements))if(Ql(n).includes(t))return r;return null}function Ql(e){if(!e)return[];return[...e.children??[],...Object.values(e.slots??{}).flat()]}function G2e(e){let t=$j(e,{checkOrphans:!0}),r=new Map;for(let n of t.issues){let a=n.elementKey??"__spec__",o=r.get(a)??[];o.push(n),r.set(a,o)}return{all:t.issues,byKey:r}}function Z2e(e,t){let r=[];function n(a){if(a===t)return r.push(a),!0;let o=e.elements[a];for(let i of Ql(o))if(n(i))return r.push(a),!0;return!1}return n(e.root),r}function Cte(e,t,r,n,a,o,i,s,l){let u=e.elements[t];if(!u)return te("div",{className:"jr-tree-row",style:{paddingLeft:`${12+r*14}px`}},te("span",{className:"jr-tree-toggle"}," "),te("span",{className:"jr-tree-type"},"<missing>"),te("span",{className:"jr-tree-key"},t));let c=Ql(u),f=c.length>0,d=f&&n.has(t),p=a===t,g=o.byKey.get(t)??[],m=g.some((S)=>S.severity==="error"),y=W2e(u),h=u.visible!==void 0?null:l,v=te("div",{className:`jr-tree-row${h===!0?" jr-tree-hidden":""}`,"data-selected":String(p),style:{paddingLeft:`${8+r*14}px`},onClick:(S)=>{S.stopPropagation(),i.selection.set(t)},onMouseEnter:()=>{oo(t)},onMouseLeave:()=>{oo(null)}},te("span",{className:"jr-tree-toggle",onClick:(S)=>{if(S.stopPropagation(),f)s(t)}},f?d?"▾":"▸":" "),te("span",{className:"jr-tree-type"},u.type),te("span",{className:"jr-tree-key"},`#${t}`),y?te("span",{className:"jr-tree-summary"},y):null,u.visible!==void 0?te("span",{className:"jr-badge","data-tone":"amber"},"visible"):null,u.repeat?te("span",{className:"jr-badge","data-tone":"accent"},"repeat"):null,m?te("span",{className:"jr-badge","data-tone":"red",title:g.map((S)=>S.message).join(`
 `)},`${g.length}`):null),x=te("div",null,v);if(d&&f)for(let S of c){let C=Cte(e,S,r+1,n,a,o,i,s,h);if(C)x.appendChild(C)}return x}function W2e(e){let t=e.props;if(!t)return null;let r=["title","label","text","name","value","status"];for(let n of r){let a=t[n];if(typeof a==="string"&&a.length>0)return ste(a,60);if(typeof a==="number"||typeof a==="boolean")return String(a)}for(let[,n]of Object.entries(t)){if(typeof n==="string"&&n.length>0)return ste(n,60);if(typeof n==="number"||typeof n==="boolean")return String(n)}return null}function ste(e,t){if(e.length<=t)return e;return e.slice(0,t-1)+"…"}function Y2e(e,t,r,n){let a=t.elements[r];if(!a){zt(e,te("div",{className:"jr-empty"},`Element '${r}' not found.`));return}let o=n.byKey.get(r)??[],i=Ql(a).length;zt(e,te("div",{className:"jr-detail"},te("h4",null,"Element"),te("div",{style:{marginBottom:"10px"}},te("span",{className:"jr-tree-type"},a.type)," ",te("span",{className:"jr-tree-key"},`#${r}`),"  ",te("span",{className:"jr-tree-summary"},`${i} child${i===1?"":"ren"}`)),o.length>0?[te("h4",null,"Issues"),...o.map((s)=>te("div",{className:"jr-badge","data-tone":s.severity==="error"?"red":"amber",style:{marginBottom:"6px",display:"block",padding:"4px 8px"}},`${s.severity.toUpperCase()}: ${s.message}`))]:null,a.visible!==void 0?[te("h4",null,"Visibility"),te("pre",null,tf(a.visible,2000))]:null,a.on&&Object.keys(a.on).length>0?[te("h4",null,"Events"),te("pre",null,tf(a.on,2000))]:null,a.watch&&Object.keys(a.watch).length>0?[te("h4",null,"Watchers"),te("pre",null,tf(a.watch,2000))]:null,a.repeat?[te("h4",null,"Repeat"),te("pre",null,tf(a.repeat,2000))]:null,te("h4",null,"Props"),te("pre",null,JSON.stringify(a.props,null,2))))}var X2e="state";function Ate(){return{id:X2e,label:"State",badge(e){let t=e.getStateStore();if(!t)return;try{let r=Ns(t.getSnapshot());return Object.keys(r).length||void 0}catch{return}},mount(e,t){return J2e(e,t)}}}function J2e(e,t){let r=te("div",{style:{height:"100%",display:"flex",flexDirection:"column"}}),n=te("div",{className:"jr-toolbar"}),a=te("div",{style:{overflow:"auto",flex:"1",minHeight:"0"}});r.appendChild(n),r.appendChild(a),e.appendChild(r);let o="",i=new Set,s=te("input",{className:"jr-search",type:"text",placeholder:"Filter paths…",onInput:(c)=>{o=(c.target.value||"").toLowerCase(),u()}});function l(){zt(n,s,te("button",{className:"jr-icon-btn",title:"Refresh state listing",onClick:()=>u()},"refresh"))}function u(){let c=t.getStateStore();if(!c){zt(a,te("div",{className:"jr-empty"},"No StateStore attached. Devtools sees state once a provider mounts."));return}let f={};try{f=Ns(c.getSnapshot())}catch(p){zt(a,te("div",{className:"jr-empty"},`State read failed: ${String(p)}`));return}let d=Object.entries(f).filter(([p])=>!o||p.toLowerCase().includes(o)).sort(([p],[g])=>p.localeCompare(g));if(d.length===0){zt(a,te("div",{className:"jr-empty"},o?"No paths match the filter.":"State is empty."));return}zt(a,d.map(([p,g])=>Q2e(p,g,c.set,i)))}return l(),u(),{update(){if(i.size===0)u()}}}function Q2e(e,t,r,n){let a=te("input",{className:"jr-state-value",type:"text",value:lte(t),spellcheck:"false",onFocus:()=>{n.add(e)},onBlur:(o)=>{n.delete(e);let i=o.target.value;try{let s=i===""?"":JSON.parse(i);r(e,s),a.dataset.dirty="false"}catch{r(e,i),a.dataset.dirty="false"}},onInput:()=>{a.dataset.dirty="true"},onKeyDown:(o)=>{if(o.key==="Enter")o.preventDefault(),o.target.blur();if(o.key==="Escape")a.value=lte(t),a.dataset.dirty="false",o.target.blur()}});return te("div",{className:"jr-state-row",title:`${e}
-${tf(t,1000)}`},te("span",{className:"jr-state-path"},e),a)}function lte(e){if(typeof e==="string")return JSON.stringify(e);if(e===null)return"null";if(e===void 0)return"";if(typeof e==="number"||typeof e==="boolean")return String(e);try{return JSON.stringify(e)}catch{return String(e)}}var eze="actions";function Pte(){return{id:eze,label:"Actions",badge(e){return Ite(e.events.snapshot()).length||void 0},mount(e,t){return tze(e,t)}}}function tze(e,t){let r=te("div",{style:{height:"100%",display:"flex",flexDirection:"column"}}),n=te("div",{className:"jr-toolbar"}),a=te("div",{style:{overflow:"auto",flex:"1",minHeight:"0"}});r.appendChild(n),r.appendChild(a),e.appendChild(r);let o="",i=new Set,s=te("input",{className:"jr-search",type:"text",placeholder:"Filter by action name…",onInput:(f)=>{o=(f.target.value||"").toLowerCase(),c()}}),l=te("span",{className:"jr-badge"},"0 actions"),u=te("button",{className:"jr-icon-btn",title:"Clear action log",onClick:()=>{let f=t.events.snapshot().filter((d)=>d.kind!=="action-dispatched"&&d.kind!=="action-settled");t.events.clear();for(let d of f)t.events.push(d)}},"clear");n.append(s,l,u);function c(){let f=Ite(t.events.snapshot()).filter((d)=>!o||d.name.toLowerCase().includes(o)).reverse();if(l.textContent=`${f.length} action${f.length===1?"":"s"}`,f.length===0){zt(a,te("div",{className:"jr-empty"},o?"No actions match the filter.":"No actions dispatched yet."));return}zt(a,f.map((d)=>rze(d,i,c)))}return c(),{update:c}}function Ite(e){let t=new Map,r=[];for(let n of e)if(n.kind==="action-dispatched"){if(t.has(n.id))continue;t.set(n.id,{id:n.id,name:n.name,params:n.params,dispatchedAt:n.at}),r.push(n.id)}else if(n.kind==="action-settled"){let a=t.get(n.id);if(!a)continue;a.settledAt=n.at,a.durationMs=n.durationMs,a.ok=n.ok,a.result=n.result,a.error=n.error}return r.map((n)=>t.get(n)).filter(Boolean)}function rze(e,t,r){let n=t.has(e.id),a=e.settledAt===void 0,o=a?"amber":e.ok?"green":"red",i=a?"pending":e.ok?"ok":"error",s=e.durationMs!==void 0?`${e.durationMs.toFixed(0)}ms`:"",l=te("div",{className:"jr-row",onClick:()=>{if(n)t.delete(e.id);else t.add(e.id);r()}},te("span",{className:"jr-row-time"},mv(e.dispatchedAt)),te("span",{className:"jr-row-main"},te("strong",null,e.name),e.params!==void 0?te("span",{className:"jr-tree-summary",style:{marginLeft:"8px"}},tf(e.params,80)):null),te("span",{className:"jr-row-meta"},te("span",{className:"jr-badge","data-tone":o},i),s?te("span",{style:{marginLeft:"6px"}},s):null));if(!n)return l;let u=te("div",null,l);return u.appendChild(te("div",{className:"jr-row-expanded"},te("h4",null,"Params"),te("pre",null,JSON.stringify(e.params??null,null,2)),e.ok===!1?[te("h4",null,"Error"),te("pre",null,e.error??"(unknown error)")]:null,e.result!==void 0&&e.ok!==!1?[te("h4",null,"Result"),te("pre",null,JSON.stringify(e.result,null,2))]:null)),u}var nze="stream";function _te(){return{id:nze,label:"Stream",badge(e){return Ete(e.events.snapshot()).length||void 0},mount(e,t){return aze(e,t)}}}function aze(e,t){let r=te("div",{style:{height:"100%",display:"flex",flexDirection:"column"}}),n=te("div",{className:"jr-toolbar"}),a=te("div",{style:{overflow:"auto",flex:"1",minHeight:"0"}});r.appendChild(n),r.appendChild(a),e.appendChild(r);function o(){let i=t.events.snapshot(),s=Ete(i),l=oze(i);if(zt(n,te("span",{className:"jr-badge"},`${s.length} generation${s.length===1?"":"s"}`)),s.length===0&&l.length===0){zt(a,te("div",{className:"jr-empty"},"No stream events yet. Tap a stream or pass messages to capture patches."));return}let u=[];if(l.length>0)u.push(ute({startedAt:l[0]?.at??Date.now(),events:l},"live",!0));for(let c=s.length-1;c>=0;c--){let f=s[c];u.push(ute(f,`gen-${c}`,c===s.length-1))}zt(a,u)}return o(),{update:o}}function Ete(e){let t=[],r=null;for(let n of e){if(n.kind==="stream-lifecycle"){if(n.phase==="start"){if(r)t.push(r);r={startedAt:n.at,events:[]}}else{if(!r)r={startedAt:n.at,events:[]};r.endedAt=n.at,r.ok=n.ok,t.push(r),r=null}continue}if(n.kind==="stream-patch"||n.kind==="stream-text"||n.kind==="stream-usage"){if(!r)r={startedAt:n.at,events:[]};if(r.events.push(n),n.kind==="stream-usage")r.usage=n.usage}}if(r)t.push(r);return t}function oze(e){if(e.some((r)=>r.kind==="stream-lifecycle"))return[];return e.filter((r)=>r.kind==="stream-patch"||r.kind==="stream-text"||r.kind==="stream-usage")}function ute(e,t,r){let n=e.events.filter((c)=>c.kind==="stream-patch").length,a=e.events.filter((c)=>c.kind==="stream-text").length,o=e.endedAt!==void 0?e.endedAt-e.startedAt:void 0,i=e.endedAt===void 0?"amber":e.ok===!1?"red":"green",s=e.endedAt===void 0?"live":e.ok===!1?"error":"done",l=te("div",{style:{borderTop:"1px solid var(--jr-border)",background:"var(--jr-bg-soft)",display:r?"block":"none"}},...e.events.map(ize)),u=te("div",{className:"jr-row",style:{cursor:"pointer"},onClick:()=>{l.style.display=l.style.display==="none"?"block":"none"}},te("span",{className:"jr-row-time"},mv(e.startedAt)),te("span",{className:"jr-row-main"},te("strong",null,`generation #${t}`),te("span",{className:"jr-tree-summary",style:{marginLeft:"8px"}},`${n} patch${n===1?"":"es"}`,a>0?`, ${a} text chunk${a===1?"":"s"}`:"")),te("span",{className:"jr-row-meta"},te("span",{className:"jr-badge","data-tone":i},s),o!==void 0?te("span",{style:{marginLeft:"6px"}},`${o}ms`):null,e.usage?te("span",{style:{marginLeft:"6px"}},`${TC(e.usage.totalTokens)} tok`):null));return te("div",null,u,l)}function ize(e){if(e.kind==="stream-patch")return te("div",{className:"jr-row"},te("span",{className:"jr-row-time"},mv(e.at)),te("span",{className:"jr-row-main"},te("span",{className:"jr-badge","data-tone":"accent"},e.patch.op),te("span",{className:"jr-tree-summary",style:{marginLeft:"8px"}},e.patch.path,e.patch.value!==void 0?` = ${tf(e.patch.value,80)}`:"")),te("span",{className:"jr-row-meta"},e.source));if(e.kind==="stream-text")return te("div",{className:"jr-row"},te("span",{className:"jr-row-time"},mv(e.at)),te("span",{className:"jr-row-main",style:{whiteSpace:"pre-wrap"}},e.text),te("span",{className:"jr-row-meta"},te("span",{className:"jr-badge"},"text")));if(e.kind==="stream-usage")return te("div",{className:"jr-row"},te("span",{className:"jr-row-time"},mv(e.at)),te("span",{className:"jr-row-main"},`prompt ${TC(e.usage.promptTokens)} / completion ${TC(e.usage.completionTokens)} / total ${TC(e.usage.totalTokens)}`),te("span",{className:"jr-row-meta"},te("span",{className:"jr-badge","data-tone":"accent"},"usage")));return te("div")}function TC(e){if(e>=1000)return`${(e/1000).toFixed(1).replace(/\.0$/,"")}k`;return String(e)}var sze="catalog";function Ote(){return{id:sze,label:"Catalog",badge(e){let t=e.getCatalog();if(!t)return;return t.componentNames.length+t.actionNames.length||void 0},mount(e,t){return lze(e,t)}}}function lze(e,t){let r=te("div",{style:{height:"100%",display:"flex",flexDirection:"column"}}),n=te("div",{className:"jr-toolbar"}),a=te("div",{style:{overflow:"auto",flex:"1",minHeight:"0"}});r.appendChild(n),r.appendChild(a),e.appendChild(r);let o="components",i="",s=te("button",{className:"jr-icon-btn","data-active":"true",onClick:()=>{if(o==="components")return;o="components",c(),f()}},"components"),l=te("button",{className:"jr-icon-btn","data-active":"false",onClick:()=>{if(o==="actions")return;o="actions",c(),f()}},"actions"),u=te("input",{className:"jr-search",type:"text",placeholder:"Filter by name…",onInput:(p)=>{i=(p.target.value||"").toLowerCase(),f()}});n.append(s,l,u);function c(){let p=t.getCatalog(),g=p?cte(p.data):null,m=g?.components.length??0,y=g?.actions.length??0;s.textContent=`components (${m})`,l.textContent=`actions (${y})`,s.dataset.active=String(o==="components"),l.dataset.active=String(o==="actions")}function f(){let p=t.getCatalog();if(!p){zt(a,te("div",{className:"jr-empty"},"No catalog attached. Pass `catalog` to `<JsonRenderDevtools>` to browse it here."));return}let g=cte(p.data);if(o==="components"){let m=g.components.filter((y)=>!i||y.name.toLowerCase().includes(i));if(m.length===0){zt(a,te("div",{className:"jr-empty"},"No components match."));return}zt(a,m.map(uze))}else{let m=g.actions.filter((y)=>!i||y.name.toLowerCase().includes(i));if(m.length===0){zt(a,te("div",{className:"jr-empty"},"No actions match."));return}zt(a,m.map(cze))}}function d(){c(),f()}return d(),{update:d}}function uze(e){return te("div",{className:"jr-catalog-item"},te("div",{className:"jr-catalog-name"},e.name),e.description?te("div",{className:"jr-catalog-desc"},e.description):null,e.props.length>0||e.events.length>0?te("div",{className:"jr-chips"},...e.props.map((t)=>te("span",{className:"jr-chip","data-tone":"prop"},`${t.name}: ${t.type}`)),...e.events.map((t)=>te("span",{className:"jr-chip","data-tone":"event"},`on.${t}`))):null)}function cze(e){return te("div",{className:"jr-catalog-item"},te("div",{className:"jr-catalog-name"},e.name),e.description?te("div",{className:"jr-catalog-desc"},e.description):null,e.params.length>0?te("div",{className:"jr-chips"},...e.params.map((t)=>te("span",{className:"jr-chip","data-tone":"param"},`${t.name}: ${t.type}`))):null)}function cte(e){let t=e??{},r=t.components??{},n=t.actions??{},a=Object.entries(r).map(([i,s])=>{let l=s??{};return{name:i,description:l.description??"",props:fte(l.props),slots:Array.isArray(l.slots)?l.slots:[],events:Array.isArray(l.events)?l.events:[]}}).sort((i,s)=>i.name.localeCompare(s.name)),o=Object.entries(n).map(([i,s])=>{let l=s??{};return{name:i,description:l.description??"",params:fte(l.params)}}).sort((i,s)=>i.name.localeCompare(s.name));return{components:a,actions:o}}function fte(e){if(!e)return[];try{let t=e,r=typeof t.shape==="object"&&t.shape!==null?t.shape:typeof t._def?.shape==="function"?t._def.shape():typeof t._def?.shape==="object"?t._def.shape:null;if(!r)return[];return Object.entries(r).map(([n,a])=>{let o="unknown";try{let i=a,s=i?._zod?.def?.type??i?._def?.typeName??"";if(s.includes("string"))o="string";else if(s.includes("number"))o="number";else if(s.includes("boolean"))o="boolean";else if(s.includes("array"))o="array";else if(s.includes("enum")){let l=i?._zod?.def?.values??i?._def?.values;o=Array.isArray(l)?l.join(" | "):"enum"}else if(s.includes("union"))o="union";else if(s.includes("nullable")){let l=i?._zod?.def?.innerType??i?._def?.innerType,u=l?._zod?.def?.type??l?._def?.typeName??"";if(u.includes("string"))o="string?";else if(u.includes("number"))o="number?";else if(u.includes("boolean"))o="boolean?";else if(u.includes("array"))o="array?";else if(u.includes("enum")){let c=l?._zod?.def?.values??l?._def?.values;o=Array.isArray(c)?`(${c.join(" | ")})?`:"enum?"}else o="optional"}}catch{}return{name:n,type:o}})}catch{return[]}}function Rte(e,t,r){if(!e)return;for(let n of e){if(!n||typeof n!=="object")continue;if(r.has(n))continue;if(r.add(n),n.type===Hp){let a=n.data;if(!a)continue;if(a.type==="patch")t.push({kind:"stream-patch",at:Date.now(),patch:a.patch,source:"json"})}}}function Lte(e){if(!e)return null;let t={root:"",elements:{}},r=!1;for(let n of e){if(!n||typeof n!=="object")continue;if(n.type!==Hp)continue;let a=n.data;if(!a)continue;if(a.type==="patch")r=!0,Kv(t,a.patch);else if(a.type==="flat")r=!0,Object.assign(t,a.spec);else if(a.type==="nested")r=!0,Object.assign(t,Gv(a.spec))}return r?t:null}function fze(e,t){let r=[];if(e){let n=0;for(let a of e){let o=Lte(a?.parts);if(!o||Object.keys(o.elements).length===0)continue;n+=1,r.push({id:a?.id??`gen-${n}`,label:`Generation ${n}`,spec:o})}}if(r.length===0&&t)r.push({id:"spec",label:"Current spec",spec:t});return r}var kte=null;function Tte(e){if(pte())return null;let t=M(e.spec??null);t.current=e.spec??null;let r=M(e.catalog??null);r.current=e.catalog??null;let n=M(e.messages);n.current=e.messages;let a=Gi(),o=M(null);o.current={get:a.get,set:a.set,update:a.update,getSnapshot:a.getSnapshot,subscribe:()=>()=>{}};let i=he(()=>dte({bufferSize:e.bufferSize}),[e.bufferSize]);G(()=>{if(!e.onEvent)return;return i.subscribe(()=>{let u=i.snapshot(),c=u[u.length-1];if(c)e.onEvent?.(c)})},[i,e.onEvent]),G(()=>Tj({onDispatch(u){i.push({kind:"action-dispatched",at:u.at,id:u.id,name:u.name,params:u.params})},onSettle(u){i.push({kind:"action-settled",at:u.at,id:u.id,ok:u.ok,durationMs:u.durationMs,result:u.result,error:u.error!==void 0?String(u.error):void 0})}}),[i]),G(()=>{l.current?.refresh()});let s=M(new WeakSet);G(()=>{if(!e.messages)return;for(let u of e.messages)if(u?.parts)Rte(u.parts,i,s.current)},[e.messages,i]);let l=M(null);return G(()=>{if(l.current)return;let u=Ste(),f=bte({context:{events:i,getSpec:()=>t.current,getSpecs:()=>fze(n.current,t.current),getCatalog:()=>r.current,getStateStore:()=>o.current,startPicker:(g)=>gte(g),selection:u,activateTab:()=>{}},tabs:[wte(),Ate(),Pte(),_te(),Ote()],initialOpen:e.initialOpen,position:e.position,hotkey:e.hotkey,reserveSpace:e.reserveSpace,allowDockToggle:e.allowDockToggle});l.current=f;let d=u.subscribe((g)=>{if(g)vte(g)});kte={open:()=>f.open(),close:()=>f.close(),toggle:()=>f.toggle(),recordEvent:(g)=>i.push(g),clear:()=>i.clear()};let p=jj();return()=>{d(),p(),f.destroy(),l.current=null,kte=null}},[i,e.initialOpen,e.position,e.hotkey,e.reserveSpace,e.allowDockToggle]),null}function dze({props:e}){let r=e.variant??"default";return b("span",{"data-slot":"badge","data-variant":r,className:`pmx-badge pmx-badge--${r}`,children:e.text})}function pze({props:e,emit:t}){let r=e.variant??"primary";return b("button",{type:"button","data-slot":"button","data-variant":r,className:`pmx-button pmx-button--${r}`,disabled:e.disabled??!1,onClick:()=>t("press"),children:e.label})}function mze({props:e,children:t,slots:r,...n}){let a=r?.header,o=r?.footer;return le(PO.Card,{...n,props:a?{...e,title:null,description:null}:e,children:[a&&b("header",{"data-pmx-card-slot":"header",children:a}),t,o&&b("footer",{"data-pmx-card-slot":"footer",className:"flex flex-wrap items-center gap-3",children:o})]})}var{registry:Dte}=nU(d5,{components:{...PO,Card:mze,Badge:dze,Button:pze,...Qee,...ete,...tte}}),hze=["ax.event.record","ax.steer","ax.work.create","ax.work.update","ax.evidence.add","ax.approval.request","ax.review.add","ax.focus.set","ax.elicitation.request","ax.mode.request","ax.command.invoke"];function gze(){let{__PMX_CANVAS_JSON_RENDER_NODE_ID__:e,__PMX_CANVAS_AX_TOKEN__:t}=window,r={};if(!e||!t)return r;for(let n of hze)r[n]=(a)=>{window.parent.postMessage({source:qj,token:t,nodeId:e,interaction:{type:n,payload:a&&typeof a==="object"?a:{}}},"*")};return r}function vze(){let e=window.__PMX_CANVAS_JSON_RENDER_THEME__;if(e){Mte(e);return}let t=window.matchMedia?.("(prefers-color-scheme: dark)").matches??!1;Mte(t?"dark":"light")}function Mte(e){if(e!=="dark"&&e!=="light"&&e!=="high-contrast")return;document.documentElement.setAttribute("data-theme",e),document.documentElement.classList.toggle("dark",e==="dark"||e==="high-contrast"),document.documentElement.style.colorScheme=e==="light"?"light":"dark"}function yze({store:e}){let t=window.__PMX_CANVAS_JSON_RENDER_SPEC__;if(!t)return b("div",{style:{height:"100vh",display:"flex",alignItems:"center",justifyContent:"center",color:"var(--muted-foreground, #666)",fontFamily:"system-ui"},children:"Waiting for UI spec..."});let r=window.__PMX_CANVAS_JSON_RENDER_DISPLAY__==="site";return b("div",{style:r?{display:"flex",flexDirection:"column",height:"100dvh",minHeight:"100dvh",padding:0,boxSizing:"border-box"}:{minHeight:"100vh",padding:16,boxSizing:"border-box"},children:le(rU,{registry:Dte,store:e,directives:IO,handlers:gze(),children:[b("div",{style:r?{flex:1,minHeight:0}:void 0,children:b(tU,{spec:t,registry:Dte,loading:!1})}),window.__PMX_CANVAS_JSON_RENDER_DEVTOOLS__?b(Tte,{position:"right"}):null]})})}var Nte=document.getElementById("root");if(Nte){vze();let e=window.__PMX_CANVAS_UI_STATE_TOKEN__,t,r=(n)=>{if(t)return;let a=n??window.__PMX_CANVAS_JSON_RENDER_SPEC__?.state??{},o=window.__PMX_CANVAS_AX_STATE__;if(t=af(o!=null?{...a,ax:o}:a),e)t.subscribe(()=>{let{ax:i,...s}=t.getSnapshot();window.parent.postMessage({source:kA,type:"snapshot",token:e,nodeId:window.__PMX_CANVAS_JSON_RENDER_NODE_ID__,state:s},"*")});S_(Nte).render(b(yze,{store:t}))};if(window.addEventListener("message",(n)=>{if(n.source!==window.parent)return;let a=n.data;if(!a)return;if(a.source===kA&&a.type==="restore"&&e&&a.token===e){if(a.state===null||typeof a.state==="object"&&!Array.isArray(a.state))r(a.state)}if(a.source===Hj&&a.type==="ax-update"&&window.__PMX_CANVAS_AX_TOKEN__&&a.token===window.__PMX_CANVAS_AX_TOKEN__)window.__PMX_CANVAS_AX_STATE__=a.state,t?.set("/ax",a.state)}),!e)r(null)}
+${tf(t,1000)}`},te("span",{className:"jr-state-path"},e),a)}function lte(e){if(typeof e==="string")return JSON.stringify(e);if(e===null)return"null";if(e===void 0)return"";if(typeof e==="number"||typeof e==="boolean")return String(e);try{return JSON.stringify(e)}catch{return String(e)}}var eze="actions";function Pte(){return{id:eze,label:"Actions",badge(e){return Ite(e.events.snapshot()).length||void 0},mount(e,t){return tze(e,t)}}}function tze(e,t){let r=te("div",{style:{height:"100%",display:"flex",flexDirection:"column"}}),n=te("div",{className:"jr-toolbar"}),a=te("div",{style:{overflow:"auto",flex:"1",minHeight:"0"}});r.appendChild(n),r.appendChild(a),e.appendChild(r);let o="",i=new Set,s=te("input",{className:"jr-search",type:"text",placeholder:"Filter by action name…",onInput:(f)=>{o=(f.target.value||"").toLowerCase(),c()}}),l=te("span",{className:"jr-badge"},"0 actions"),u=te("button",{className:"jr-icon-btn",title:"Clear action log",onClick:()=>{let f=t.events.snapshot().filter((d)=>d.kind!=="action-dispatched"&&d.kind!=="action-settled");t.events.clear();for(let d of f)t.events.push(d)}},"clear");n.append(s,l,u);function c(){let f=Ite(t.events.snapshot()).filter((d)=>!o||d.name.toLowerCase().includes(o)).reverse();if(l.textContent=`${f.length} action${f.length===1?"":"s"}`,f.length===0){zt(a,te("div",{className:"jr-empty"},o?"No actions match the filter.":"No actions dispatched yet."));return}zt(a,f.map((d)=>rze(d,i,c)))}return c(),{update:c}}function Ite(e){let t=new Map,r=[];for(let n of e)if(n.kind==="action-dispatched"){if(t.has(n.id))continue;t.set(n.id,{id:n.id,name:n.name,params:n.params,dispatchedAt:n.at}),r.push(n.id)}else if(n.kind==="action-settled"){let a=t.get(n.id);if(!a)continue;a.settledAt=n.at,a.durationMs=n.durationMs,a.ok=n.ok,a.result=n.result,a.error=n.error}return r.map((n)=>t.get(n)).filter(Boolean)}function rze(e,t,r){let n=t.has(e.id),a=e.settledAt===void 0,o=a?"amber":e.ok?"green":"red",i=a?"pending":e.ok?"ok":"error",s=e.durationMs!==void 0?`${e.durationMs.toFixed(0)}ms`:"",l=te("div",{className:"jr-row",onClick:()=>{if(n)t.delete(e.id);else t.add(e.id);r()}},te("span",{className:"jr-row-time"},mv(e.dispatchedAt)),te("span",{className:"jr-row-main"},te("strong",null,e.name),e.params!==void 0?te("span",{className:"jr-tree-summary",style:{marginLeft:"8px"}},tf(e.params,80)):null),te("span",{className:"jr-row-meta"},te("span",{className:"jr-badge","data-tone":o},i),s?te("span",{style:{marginLeft:"6px"}},s):null));if(!n)return l;let u=te("div",null,l);return u.appendChild(te("div",{className:"jr-row-expanded"},te("h4",null,"Params"),te("pre",null,JSON.stringify(e.params??null,null,2)),e.ok===!1?[te("h4",null,"Error"),te("pre",null,e.error??"(unknown error)")]:null,e.result!==void 0&&e.ok!==!1?[te("h4",null,"Result"),te("pre",null,JSON.stringify(e.result,null,2))]:null)),u}var nze="stream";function _te(){return{id:nze,label:"Stream",badge(e){return Ete(e.events.snapshot()).length||void 0},mount(e,t){return aze(e,t)}}}function aze(e,t){let r=te("div",{style:{height:"100%",display:"flex",flexDirection:"column"}}),n=te("div",{className:"jr-toolbar"}),a=te("div",{style:{overflow:"auto",flex:"1",minHeight:"0"}});r.appendChild(n),r.appendChild(a),e.appendChild(r);function o(){let i=t.events.snapshot(),s=Ete(i),l=oze(i);if(zt(n,te("span",{className:"jr-badge"},`${s.length} generation${s.length===1?"":"s"}`)),s.length===0&&l.length===0){zt(a,te("div",{className:"jr-empty"},"No stream events yet. Tap a stream or pass messages to capture patches."));return}let u=[];if(l.length>0)u.push(ute({startedAt:l[0]?.at??Date.now(),events:l},"live",!0));for(let c=s.length-1;c>=0;c--){let f=s[c];u.push(ute(f,`gen-${c}`,c===s.length-1))}zt(a,u)}return o(),{update:o}}function Ete(e){let t=[],r=null;for(let n of e){if(n.kind==="stream-lifecycle"){if(n.phase==="start"){if(r)t.push(r);r={startedAt:n.at,events:[]}}else{if(!r)r={startedAt:n.at,events:[]};r.endedAt=n.at,r.ok=n.ok,t.push(r),r=null}continue}if(n.kind==="stream-patch"||n.kind==="stream-text"||n.kind==="stream-usage"){if(!r)r={startedAt:n.at,events:[]};if(r.events.push(n),n.kind==="stream-usage")r.usage=n.usage}}if(r)t.push(r);return t}function oze(e){if(e.some((r)=>r.kind==="stream-lifecycle"))return[];return e.filter((r)=>r.kind==="stream-patch"||r.kind==="stream-text"||r.kind==="stream-usage")}function ute(e,t,r){let n=e.events.filter((c)=>c.kind==="stream-patch").length,a=e.events.filter((c)=>c.kind==="stream-text").length,o=e.endedAt!==void 0?e.endedAt-e.startedAt:void 0,i=e.endedAt===void 0?"amber":e.ok===!1?"red":"green",s=e.endedAt===void 0?"live":e.ok===!1?"error":"done",l=te("div",{style:{borderTop:"1px solid var(--jr-border)",background:"var(--jr-bg-soft)",display:r?"block":"none"}},...e.events.map(ize)),u=te("div",{className:"jr-row",style:{cursor:"pointer"},onClick:()=>{l.style.display=l.style.display==="none"?"block":"none"}},te("span",{className:"jr-row-time"},mv(e.startedAt)),te("span",{className:"jr-row-main"},te("strong",null,`generation #${t}`),te("span",{className:"jr-tree-summary",style:{marginLeft:"8px"}},`${n} patch${n===1?"":"es"}`,a>0?`, ${a} text chunk${a===1?"":"s"}`:"")),te("span",{className:"jr-row-meta"},te("span",{className:"jr-badge","data-tone":i},s),o!==void 0?te("span",{style:{marginLeft:"6px"}},`${o}ms`):null,e.usage?te("span",{style:{marginLeft:"6px"}},`${TC(e.usage.totalTokens)} tok`):null));return te("div",null,u,l)}function ize(e){if(e.kind==="stream-patch")return te("div",{className:"jr-row"},te("span",{className:"jr-row-time"},mv(e.at)),te("span",{className:"jr-row-main"},te("span",{className:"jr-badge","data-tone":"accent"},e.patch.op),te("span",{className:"jr-tree-summary",style:{marginLeft:"8px"}},e.patch.path,e.patch.value!==void 0?` = ${tf(e.patch.value,80)}`:"")),te("span",{className:"jr-row-meta"},e.source));if(e.kind==="stream-text")return te("div",{className:"jr-row"},te("span",{className:"jr-row-time"},mv(e.at)),te("span",{className:"jr-row-main",style:{whiteSpace:"pre-wrap"}},e.text),te("span",{className:"jr-row-meta"},te("span",{className:"jr-badge"},"text")));if(e.kind==="stream-usage")return te("div",{className:"jr-row"},te("span",{className:"jr-row-time"},mv(e.at)),te("span",{className:"jr-row-main"},`prompt ${TC(e.usage.promptTokens)} / completion ${TC(e.usage.completionTokens)} / total ${TC(e.usage.totalTokens)}`),te("span",{className:"jr-row-meta"},te("span",{className:"jr-badge","data-tone":"accent"},"usage")));return te("div")}function TC(e){if(e>=1000)return`${(e/1000).toFixed(1).replace(/\.0$/,"")}k`;return String(e)}var sze="catalog";function Ote(){return{id:sze,label:"Catalog",badge(e){let t=e.getCatalog();if(!t)return;return t.componentNames.length+t.actionNames.length||void 0},mount(e,t){return lze(e,t)}}}function lze(e,t){let r=te("div",{style:{height:"100%",display:"flex",flexDirection:"column"}}),n=te("div",{className:"jr-toolbar"}),a=te("div",{style:{overflow:"auto",flex:"1",minHeight:"0"}});r.appendChild(n),r.appendChild(a),e.appendChild(r);let o="components",i="",s=te("button",{className:"jr-icon-btn","data-active":"true",onClick:()=>{if(o==="components")return;o="components",c(),f()}},"components"),l=te("button",{className:"jr-icon-btn","data-active":"false",onClick:()=>{if(o==="actions")return;o="actions",c(),f()}},"actions"),u=te("input",{className:"jr-search",type:"text",placeholder:"Filter by name…",onInput:(p)=>{i=(p.target.value||"").toLowerCase(),f()}});n.append(s,l,u);function c(){let p=t.getCatalog(),g=p?cte(p.data):null,m=g?.components.length??0,y=g?.actions.length??0;s.textContent=`components (${m})`,l.textContent=`actions (${y})`,s.dataset.active=String(o==="components"),l.dataset.active=String(o==="actions")}function f(){let p=t.getCatalog();if(!p){zt(a,te("div",{className:"jr-empty"},"No catalog attached. Pass `catalog` to `<JsonRenderDevtools>` to browse it here."));return}let g=cte(p.data);if(o==="components"){let m=g.components.filter((y)=>!i||y.name.toLowerCase().includes(i));if(m.length===0){zt(a,te("div",{className:"jr-empty"},"No components match."));return}zt(a,m.map(uze))}else{let m=g.actions.filter((y)=>!i||y.name.toLowerCase().includes(i));if(m.length===0){zt(a,te("div",{className:"jr-empty"},"No actions match."));return}zt(a,m.map(cze))}}function d(){c(),f()}return d(),{update:d}}function uze(e){return te("div",{className:"jr-catalog-item"},te("div",{className:"jr-catalog-name"},e.name),e.description?te("div",{className:"jr-catalog-desc"},e.description):null,e.props.length>0||e.events.length>0?te("div",{className:"jr-chips"},...e.props.map((t)=>te("span",{className:"jr-chip","data-tone":"prop"},`${t.name}: ${t.type}`)),...e.events.map((t)=>te("span",{className:"jr-chip","data-tone":"event"},`on.${t}`))):null)}function cze(e){return te("div",{className:"jr-catalog-item"},te("div",{className:"jr-catalog-name"},e.name),e.description?te("div",{className:"jr-catalog-desc"},e.description):null,e.params.length>0?te("div",{className:"jr-chips"},...e.params.map((t)=>te("span",{className:"jr-chip","data-tone":"param"},`${t.name}: ${t.type}`))):null)}function cte(e){let t=e??{},r=t.components??{},n=t.actions??{},a=Object.entries(r).map(([i,s])=>{let l=s??{};return{name:i,description:l.description??"",props:fte(l.props),slots:Array.isArray(l.slots)?l.slots:[],events:Array.isArray(l.events)?l.events:[]}}).sort((i,s)=>i.name.localeCompare(s.name)),o=Object.entries(n).map(([i,s])=>{let l=s??{};return{name:i,description:l.description??"",params:fte(l.params)}}).sort((i,s)=>i.name.localeCompare(s.name));return{components:a,actions:o}}function fte(e){if(!e)return[];try{let t=e,r=typeof t.shape==="object"&&t.shape!==null?t.shape:typeof t._def?.shape==="function"?t._def.shape():typeof t._def?.shape==="object"?t._def.shape:null;if(!r)return[];return Object.entries(r).map(([n,a])=>{let o="unknown";try{let i=a,s=i?._zod?.def?.type??i?._def?.typeName??"";if(s.includes("string"))o="string";else if(s.includes("number"))o="number";else if(s.includes("boolean"))o="boolean";else if(s.includes("array"))o="array";else if(s.includes("enum")){let l=i?._zod?.def?.values??i?._def?.values;o=Array.isArray(l)?l.join(" | "):"enum"}else if(s.includes("union"))o="union";else if(s.includes("nullable")){let l=i?._zod?.def?.innerType??i?._def?.innerType,u=l?._zod?.def?.type??l?._def?.typeName??"";if(u.includes("string"))o="string?";else if(u.includes("number"))o="number?";else if(u.includes("boolean"))o="boolean?";else if(u.includes("array"))o="array?";else if(u.includes("enum")){let c=l?._zod?.def?.values??l?._def?.values;o=Array.isArray(c)?`(${c.join(" | ")})?`:"enum?"}else o="optional"}}catch{}return{name:n,type:o}})}catch{return[]}}function Rte(e,t,r){if(!e)return;for(let n of e){if(!n||typeof n!=="object")continue;if(r.has(n))continue;if(r.add(n),n.type===Hp){let a=n.data;if(!a)continue;if(a.type==="patch")t.push({kind:"stream-patch",at:Date.now(),patch:a.patch,source:"json"})}}}function Lte(e){if(!e)return null;let t={root:"",elements:{}},r=!1;for(let n of e){if(!n||typeof n!=="object")continue;if(n.type!==Hp)continue;let a=n.data;if(!a)continue;if(a.type==="patch")r=!0,Kv(t,a.patch);else if(a.type==="flat")r=!0,Object.assign(t,a.spec);else if(a.type==="nested")r=!0,Object.assign(t,Gv(a.spec))}return r?t:null}function fze(e,t){let r=[];if(e){let n=0;for(let a of e){let o=Lte(a?.parts);if(!o||Object.keys(o.elements).length===0)continue;n+=1,r.push({id:a?.id??`gen-${n}`,label:`Generation ${n}`,spec:o})}}if(r.length===0&&t)r.push({id:"spec",label:"Current spec",spec:t});return r}var kte=null;function Tte(e){if(pte())return null;let t=M(e.spec??null);t.current=e.spec??null;let r=M(e.catalog??null);r.current=e.catalog??null;let n=M(e.messages);n.current=e.messages;let a=Gi(),o=M(null);o.current={get:a.get,set:a.set,update:a.update,getSnapshot:a.getSnapshot,subscribe:()=>()=>{}};let i=he(()=>dte({bufferSize:e.bufferSize}),[e.bufferSize]);G(()=>{if(!e.onEvent)return;return i.subscribe(()=>{let u=i.snapshot(),c=u[u.length-1];if(c)e.onEvent?.(c)})},[i,e.onEvent]),G(()=>Tj({onDispatch(u){i.push({kind:"action-dispatched",at:u.at,id:u.id,name:u.name,params:u.params})},onSettle(u){i.push({kind:"action-settled",at:u.at,id:u.id,ok:u.ok,durationMs:u.durationMs,result:u.result,error:u.error!==void 0?String(u.error):void 0})}}),[i]),G(()=>{l.current?.refresh()});let s=M(new WeakSet);G(()=>{if(!e.messages)return;for(let u of e.messages)if(u?.parts)Rte(u.parts,i,s.current)},[e.messages,i]);let l=M(null);return G(()=>{if(l.current)return;let u=Ste(),f=bte({context:{events:i,getSpec:()=>t.current,getSpecs:()=>fze(n.current,t.current),getCatalog:()=>r.current,getStateStore:()=>o.current,startPicker:(g)=>gte(g),selection:u,activateTab:()=>{}},tabs:[wte(),Ate(),Pte(),_te(),Ote()],initialOpen:e.initialOpen,position:e.position,hotkey:e.hotkey,reserveSpace:e.reserveSpace,allowDockToggle:e.allowDockToggle});l.current=f;let d=u.subscribe((g)=>{if(g)vte(g)});kte={open:()=>f.open(),close:()=>f.close(),toggle:()=>f.toggle(),recordEvent:(g)=>i.push(g),clear:()=>i.clear()};let p=jj();return()=>{d(),p(),f.destroy(),l.current=null,kte=null}},[i,e.initialOpen,e.position,e.hotkey,e.reserveSpace,e.allowDockToggle]),null}function dze({props:e}){let r=e.variant??"default";return b("span",{"data-slot":"badge","data-variant":r,className:`pmx-badge pmx-badge--${r}`,children:e.text})}function pze({props:e,emit:t}){let r=e.variant??"primary";return b("button",{type:"button","data-slot":"button","data-variant":r,className:`pmx-button pmx-button--${r}`,disabled:e.disabled??!1,onClick:()=>t("press"),children:e.label})}function mze({props:e,children:t,slots:r,...n}){let a=r?.header,o=r?.footer;return le(PO.Card,{...n,props:a?{...e,title:null,description:null}:e,children:[a&&b("header",{"data-pmx-card-slot":"header",children:a}),t,o&&b("footer",{"data-pmx-card-slot":"footer",className:"flex flex-wrap items-center gap-3",children:o})]})}var{registry:Dte}=nU(d5,{components:{...PO,Card:mze,Badge:dze,Button:pze,...Qee,...ete,...tte}}),hze=["ax.event.record","ax.steer","ax.work.create","ax.work.update","ax.evidence.add","ax.approval.request","ax.review.add","ax.focus.set","ax.elicitation.request","ax.mode.request","ax.command.invoke"];function gze(){let{__PMX_CANVAS_JSON_RENDER_NODE_ID__:e,__PMX_CANVAS_AX_TOKEN__:t}=window,r={};if(!e||!t)return r;for(let n of hze)r[n]=(a)=>{window.parent.postMessage({source:qj,token:t,nodeId:e,interaction:{type:n,payload:a&&typeof a==="object"?a:{}}},"*")};return r}function vze(){let e=window.__PMX_CANVAS_JSON_RENDER_THEME__;if(e){Mte(e);return}let t=window.matchMedia?.("(prefers-color-scheme: dark)").matches??!1;Mte(t?"dark":"light")}function Mte(e){if(e!=="dark"&&e!=="light"&&e!=="high-contrast")return;document.documentElement.setAttribute("data-theme",e),document.documentElement.classList.toggle("dark",e==="dark"||e==="high-contrast"),document.documentElement.style.colorScheme=e==="light"?"light":"dark"}function yze({store:e}){let t=window.__PMX_CANVAS_JSON_RENDER_SPEC__;if(!t)return b("div",{style:{height:"100vh",display:"flex",alignItems:"center",justifyContent:"center",color:"var(--muted-foreground, #666)"},children:"Waiting for UI spec..."});let r=window.__PMX_CANVAS_JSON_RENDER_DISPLAY__==="site";return b("div",{style:r?{display:"flex",flexDirection:"column",height:"100dvh",minHeight:"100dvh",padding:0,boxSizing:"border-box"}:{minHeight:"100vh",padding:16,boxSizing:"border-box"},children:le(rU,{registry:Dte,store:e,directives:IO,handlers:gze(),children:[b("div",{style:r?{flex:1,minHeight:0}:void 0,children:b(tU,{spec:t,registry:Dte,loading:!1})}),window.__PMX_CANVAS_JSON_RENDER_DEVTOOLS__?b(Tte,{position:"right"}):null]})})}var Nte=document.getElementById("root");if(Nte){vze();let e=window.__PMX_CANVAS_UI_STATE_TOKEN__,t,r=(n)=>{if(t)return;let a=n??window.__PMX_CANVAS_JSON_RENDER_SPEC__?.state??{},o=window.__PMX_CANVAS_AX_STATE__;if(t=af(o!=null?{...a,ax:o}:a),e)t.subscribe(()=>{let{ax:i,...s}=t.getSnapshot();window.parent.postMessage({source:kA,type:"snapshot",token:e,nodeId:window.__PMX_CANVAS_JSON_RENDER_NODE_ID__,state:s},"*")});S_(Nte).render(b(yze,{store:t}))};if(window.addEventListener("message",(n)=>{if(n.source!==window.parent)return;let a=n.data;if(!a)return;if(a.source===kA&&a.type==="restore"&&e&&a.token===e){if(a.state===null||typeof a.state==="object"&&!Array.isArray(a.state))r(a.state)}if(a.source===Hj&&a.type==="ax-update"&&window.__PMX_CANVAS_AX_TOKEN__&&a.token===window.__PMX_CANVAS_AX_TOKEN__)window.__PMX_CANVAS_AX_STATE__=a.state,t?.set("/ax",a.state)}),!e)r(null)}

package/dist/types/cli/commands/record.d.ts

@@ -1,5 +1,5 @@
 export declare function parseRecordOptions(flags: Record<string, string | boolean>): {
-    theme: "dark" | "light" | "high-contrast" | "midnight" | "sepia" | "arctic" | "ember" | "forest" | "volt" | undefined;
+    theme: "harbor" | "daylight" | "high-contrast" | "midnight" | "sepia" | "arctic" | "ember" | "forest" | "volt" | undefined;
     present: boolean;
     tourFile: string | undefined;
     chromePath: string | undefined;

package/dist/types/client/canvas/NodeContextMark.d.ts

@@ -0,0 +1,24 @@
+import type { CanvasNodeState } from '../types';
+export declare const GLYPHS: {
+    readonly eye: "M2 12s3.5-6 10-6 10 6 10 6-3.5 6-10 6S2 12 2 12zM12 9.5a2.5 2.5 0 1 0 0 5a2.5 2.5 0 1 0 0-5";
+    readonly eyeOff: "M3 3l18 18M10.6 6.1A10 10 0 0 1 12 6c6.5 0 10 6 10 6a17 17 0 0 1-3 3.6M6.6 6.6C3.8 8.3 2 12 2 12s3.5 6 10 6a9.6 9.6 0 0 0 4.4-1";
+    readonly spark: "M12 3l1.8 5.2L19 10l-5.2 1.8L12 17l-1.8-5.2L5 10l5.2-1.8z";
+    readonly pen: "M4 20l4.2-1L19 8.2 15.8 5 5 15.8z";
+    readonly warn: "M12 4l9 16H3zM12 10v4M12 17v.5";
+};
+/** The header chip saying what agents did with this node (one per node; glyph + word). */
+export declare function NodeContextMark({ node, pinned }: {
+    node: CanvasNodeState;
+    pinned: boolean;
+}): import("preact/src").JSX.Element | null;
+/** Pinned by an agent: the violet dot on the pin badge. */
+export declare function isAgentPin(nodeId: string): boolean;
+/**
+ * Near a pin (docs/design/NearPin.dc.html): a dotted pin-blue chip on an
+ * unpinned node the brief carries as title + short summary. Weaker than "in
+ * context" on purpose: the agent never gets this node's full content.
+ */
+export declare function NearPinMark({ node, pinned }: {
+    node: CanvasNodeState;
+    pinned: boolean;
+}): import("preact/src").JSX.Element | null;

package/dist/types/client/canvas/SessionReceipt.d.ts

@@ -3,7 +3,9 @@
  * at the canvas region's top-right after a session ends — what the session did
  * (items / done / vetoed), the pre-session snapshot (taken at attach, so View
  * diff shows the session's changes and a restore undoes them), and History
- * (the snapshots panel). Client-side state, cleared on dismiss.
+ * (the snapshots panel). Client-side state, cleared on dismiss (see
+ * applySessionReceipt for which endings show at all and how a burst merges
+ * into one card).
  */
 export interface DiffSummary {
     added: number;

package/dist/types/client/icons.d.ts

@@ -13,7 +13,6 @@ export declare function IconExpand(p: IconProps): JSX.Element;
 export declare function IconArrowLeft(p: IconProps): JSX.Element;
 export declare function IconRefresh(p: IconProps): JSX.Element;
 export declare function IconUndo(p: IconProps): JSX.Element;
-export declare function IconSparkle(p: IconProps): JSX.Element;
 /** Upload into a tray — attach a document. */
 export declare function IconUpload(p: IconProps): JSX.Element;
 /** Dropdown disclosure, sized like the other toolbar icons. */
@@ -50,7 +49,7 @@ export declare function IconSearch(p: IconProps): JSX.Element;
 export declare function IconShortcuts(p: IconProps): JSX.Element;
 /** Speech bubble — steer the agent (command bar composer). */
 export declare function IconSteer(p: IconProps): JSX.Element;
-/** Framed pin — context pinning. */
+/** Push pin — context pinning (docs/design/Chrome.dc.html). */
 export declare function IconPin(p: IconProps): JSX.Element;
 /** Focus Field — PMX Canvas brand mark (concentric rounded squares → lit core). */
 export declare function IconLogo({ size, class: className }: IconProps): JSX.Element;

package/dist/types/client/mcp-app/index.d.ts

@@ -0,0 +1 @@
+import '../uuid-polyfill';

package/dist/types/client/nodes/HtmlNode.d.ts

@@ -1,5 +1,6 @@
 import type { CanvasNodeState } from '../types';
 export declare function shouldShowPresentationControls(node: CanvasNodeState): boolean;
+export declare function htmlAxCapabilitySignature(value: unknown): string;
 export declare function HtmlNode({ node, expanded, presentation, presentationExitToken, autoFocus, }: {
     node: CanvasNodeState;
     expanded?: boolean;

package/dist/types/client/nodes/ax-node-actions.d.ts

@@ -9,8 +9,8 @@ export declare function runNodeAxInteraction(node: CanvasNodeState, type: string
 export declare const axNodeActionButtonStyle: {
     readonly padding: "3px 8px";
     readonly fontSize: "10px";
-    readonly background: "var(--c-accent-12)";
-    readonly border: "1px solid var(--c-accent-25)";
+    readonly background: "color-mix(in srgb, var(--c-accent) 12%, transparent)";
+    readonly border: "1px solid color-mix(in srgb, var(--c-accent) 25%, transparent)";
     readonly borderRadius: "4px";
     readonly color: "var(--c-text-soft)";
     readonly cursor: "pointer";

package/dist/types/client/nodes/markdown-sanitize.d.ts

@@ -0,0 +1,2 @@
+/** Sanitize rendered Markdown before it enters the privileged workbench DOM. */
+export declare function sanitizeMarkdownHtml(html: string): string;

package/dist/types/client/nodes/use-workbench-asset.d.ts

@@ -0,0 +1,2 @@
+/** Asset bytes travel through the host, not a localhost URL in the user's browser. */
+export declare function useWorkbenchAsset(path: string): string | undefined;

package/dist/types/client/state/attention-store.d.ts

@@ -1,4 +1,3 @@
-import type { SemanticAttentionRegion } from '../../shared/semantic-attention.js';
 export type AttentionTone = 'context' | 'relationship' | 'group' | 'cluster' | 'neighborhood' | 'remove';
 export interface AttentionEntry {
     id: string;
@@ -10,16 +9,12 @@ export interface AttentionEntry {
 }
 export declare const attentionToast: import("@preact/signals-core").Signal<AttentionEntry | null>;
 export declare const attentionHistory: import("@preact/signals-core").Signal<AttentionEntry[]>;
-export declare const attentionPrimaryNodeIds: import("@preact/signals-core").Signal<Set<string>>;
-export declare const attentionSecondaryNodeIds: import("@preact/signals-core").Signal<Set<string>>;
-export declare const attentionRegions: import("@preact/signals-core").Signal<SemanticAttentionRegion[]>;
 export declare const attentionPulseNodeIds: import("@preact/signals-core").Signal<Set<string>>;
 export declare const attentionHistoryOpen: import("@preact/signals-core").Signal<boolean>;
 export declare const attentionHistoryUnread: import("@preact/signals-core").Signal<number>;
 export declare function resetAttentionState(): void;
 export declare function openAttentionHistory(): void;
 export declare function closeAttentionHistory(): void;
-export declare function setAttentionFocus(primaryNodeIds: string[], secondaryNodeIds: string[], regions: SemanticAttentionRegion[]): void;
 export declare function setAttentionToast(entry: AttentionEntry | null): void;
 export declare function pushAttentionHistory(entry: AttentionEntry, limit?: number): void;
 export declare function setAttentionPulse(nodeIds: string[]): void;

package/dist/types/client/state/context-status-store.d.ts

@@ -0,0 +1,53 @@
+/**
+ * What agents did with the board's context (docs/design/AgentContext.dc.html):
+ * per node, the latest agent read of its content and the revision it read;
+ * per pin, who pinned it, when and why. Server truth from
+ * `GET /api/canvas/ax/context-status`, refetched when a read lands
+ * (`context-status-changed`), when pins change, and on (re)connect.
+ */
+export interface NodeReadStatus {
+    nodeId: string;
+    lastReadAt: string;
+    lastReadBy: string;
+    readRevision: number;
+    readCount: number;
+}
+export interface ContextPinMeta {
+    pinnedBy: {
+        actor: 'human' | 'agent' | 'system' | 'unknown';
+        source: string;
+        agentId?: string;
+    };
+    pinnedAt: string;
+    reason?: string;
+}
+interface ContextStatusResponse {
+    ok?: boolean;
+    boardId?: string | null;
+    nodes?: NodeReadStatus[];
+    pins?: Record<string, ContextPinMeta>;
+}
+export declare const nodeReadStatus: import("@preact/signals-core").Signal<Map<string, NodeReadStatus>>;
+export declare const contextPinMeta: import("@preact/signals-core").Signal<Record<string, ContextPinMeta>>;
+export declare function applyContextStatus(response: ContextStatusResponse): void;
+export declare function refreshContextStatus(): Promise<void>;
+/** How an agent's context relates to one pinned node — the mark its header shows. */
+export type PinnedReadState = {
+    kind: 'not-read';
+} | {
+    kind: 'read';
+    by: string;
+    at: string;
+    count: number;
+} | {
+    kind: 'changed';
+    by: string;
+    at: string;
+};
+export declare function pinnedReadState(nodeId: string, currentRevision: number): PinnedReadState;
+/** Display name for an attributed writer: its agent id, else its transport label. */
+export declare function writerName(actor: {
+    source: string;
+    agentId?: string;
+}): string;
+export {};

package/dist/types/client/state/intent-bridge.d.ts

@@ -120,9 +120,12 @@ export declare function updateNodeFromClient(id: string, patch: {
     data?: Record<string, unknown>;
     /** Groups: replace the membership list (positions preserved). */
     children?: string[];
+    expectedContentRevision?: number;
+    expectedBoardId?: string | null;
 }): Promise<{
     ok: boolean;
     id?: string;
+    contentRevision?: number;
 }>;
 /** Refresh a webpage node from its persisted URL on the server. */
 export declare function refreshWebpageNodeFromClient(id: string, url?: string): Promise<{

package/dist/types/client/state/near-pin-store.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Near a pin (docs/design/NearPin.dc.html): each pinned node pulls up to five
+ * unpinned nodes within 600 px into the agent's brief as title + short
+ * summary. Same rule as the server's brief (`findNeighborhoods`), so the mark
+ * claims exactly what the agent receives.
+ */
+export interface NearPin {
+    pinNodeId: string;
+    pinTitle: string;
+}
+/**
+ * Unpinned node id → the pins it is near, nearest first. Every drag frame
+ * moves a node, so the result keeps its identity while no node's set of pins
+ * changes: the chips subscribed to it re-render only when a neighbourhood does.
+ */
+export declare const nearPins: import("@preact/signals-core").ReadonlySignal<Map<string, NearPin[]>>;

package/dist/types/client/state/presence-store.d.ts

@@ -17,6 +17,11 @@ export declare const activityFeedOpen: import("@preact/signals-core").Signal<boo
 export declare const writersSheetOpen: import("@preact/signals-core").Signal<boolean>;
 /** Feed filter: a writer's sessionId, or null for all. */
 export declare const activityFilter: import("@preact/signals-core").Signal<string | null>;
+/**
+ * A writer's colour says what it is, not who: agents take the agent violet,
+ * subagents (fleet workers) the subagent fuchsia. Writers are told apart by
+ * name and initial (docs/design.md, "Kinds carry no colour").
+ */
 export declare function writerColor(sessionId: string): string;
 /** Avatar initial: first letter of the label, upper-cased. */
 export declare function writerInitial(label: string): string;

package/dist/types/client/state/session-store.d.ts

@@ -155,12 +155,13 @@ export declare function endSession(session: {
     agentId: string | null;
 }): Promise<boolean>;
 export interface SessionReceipt {
-    label: string;
+    /** Distinct labels of the sessions on this card (one unless merged). */
+    labels: string[];
+    /** Endings folded into this card (see applySessionReceipt). */
+    sessions: number;
     endedAt: string;
     /** Why it ended — the receipt should answer this, not leave the human asking. */
     endedBy?: 'human' | 'agent' | 'idle-timeout';
-    /** The session changed nothing on the board (its pre-session snapshot was dropped). */
-    unchanged?: boolean;
     /** Cancelled (withdrawn items), rejected (human's explicit no on a gate), and
      * held (TTL expired unanswered) are three different outcomes — never one
      * "vetoed" pile. */
@@ -171,13 +172,42 @@ export interface SessionReceipt {
         rejected: number;
         held: number;
     };
+    /** The pre-session snapshot; null when the board was empty at attach, or on a
+     * merged receipt (each session's snapshot is in History). */
     snapshot: {
         id: string;
         name: string;
     } | null;
+    /** What the session did with context (docs/design/AgentContext.dc.html receipt). */
+    context: SessionContextActivity;
+}
+export interface ReceiptNode {
+    id: string;
+    title: string;
+    reason?: string;
+}
+export interface SessionContextActivity {
+    read: ReceiptNode[];
+    pinned: ReceiptNode[];
+    created: ReceiptNode[];
+    edited: ReceiptNode[];
+    changedSinceRead: ReceiptNode[];
 }
+/**
+ * The agent-activity lens: while on, nodes the last session did not touch
+ * (read, pin, create, edit) are dimmed. Null when off.
+ */
+export declare const activityLensNodeIds: import("@preact/signals-core").Signal<Set<string> | null>;
+export declare function setActivityLens(on: boolean): void;
 /** The last ended session's receipt (design item 2); client-side, cleared on dismiss. */
 export declare const sessionReceipt: import("@preact/signals-core").Signal<SessionReceipt | null>;
+/**
+ * The receipt rule: a pop-up only for a top-level session that changed the
+ * board or read/pinned context. `unchanged` endings and worker endings
+ * (`parentAgentId` set — their orchestrator's receipt covers the board since
+ * it attached) stay in the timeline and History only, and never replace or
+ * extend an open receipt. Qualifying endings while one is up merge into it.
+ */
 export declare function applySessionReceipt(data: Record<string, unknown>): void;
 export declare function dismissSessionReceipt(): void;
 export declare function resetSessionStore(): void;

package/dist/types/client/state/workbench-transport.d.ts

@@ -0,0 +1,16 @@
+/** The normal workbench uses HTTP; an MCP App installs its host transport before mounting. */
+type WorkbenchFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export declare function installWorkbenchTransport(transport: WorkbenchFetch | undefined): void;
+export declare function isHostedWorkbench(): boolean;
+export declare const workbenchFetch: WorkbenchFetch;
+type WorkbenchDownload = (file: {
+    name: string;
+    mimeType: string;
+    text: string;
+}) => Promise<{
+    isError?: boolean;
+}>;
+export declare function installWorkbenchDownload(download: WorkbenchDownload | undefined): void;
+/** Export files live on PMX, not on the embedded frame's sandbox origin. */
+export declare function downloadWorkbenchExport(path: string): Promise<void>;
+export {};

package/dist/types/client/theme/tokens.d.ts

@@ -11,10 +11,8 @@ export interface CanvasTokens {
     accent: string;
     ok: string;
     warn: string;
-    warnAlt: string;
     danger: string;
-    purple: string;
-    thinking: string;
+    agent: string;
     subagent: string;
     font: string;
     mono: string;

package/dist/types/client/types.d.ts

@@ -18,8 +18,17 @@ export interface CanvasNodeState {
     zIndex: number;
     collapsed: boolean;
     pinned: boolean;
+    contentRevision?: number;
+    /** Who created / last edited the node's content (server attribution). */
+    createdBy?: NodeActor;
+    lastEditedBy?: NodeActor;
     data: Record<string, unknown>;
 }
+export interface NodeActor {
+    actor: 'human' | 'agent' | 'system' | 'unknown';
+    source: string;
+    agentId?: string;
+}
 export interface CanvasEdge {
     id: string;
     from: string;

package/dist/types/json-render/server.d.ts

@@ -66,7 +66,7 @@ export type GraphChartType = 'LineChart' | 'BarChart' | 'PieChart' | 'AreaChart'
 export declare function escapeInlineScriptSource(source: string): string;
 export declare function inferJsonRenderNodeTitle(spec: JsonRenderSpec, fallback?: string): string;
 export declare function normalizeAndValidateJsonRenderSpec(spec: unknown): JsonRenderSpec;
-/** shadcn 0.21 ignores these props unless the renderer supplies a two-way binding. */
+/** Binding-only form props that normalization could not bind (see bindLiteralFormValues). */
 export declare function jsonRenderFormWarnings(spec: JsonRenderSpec): string[];
 export declare function normalizeGraphType(value: string): GraphChartType;
 export declare function buildGraphSpec(input: GraphNodeInput): JsonRenderSpec;

package/dist/types/mcp/app-server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/** Private, single-workspace profile. No public HTTP listener or tenant routing. */
+export declare function createCanvasAppServer(): McpServer;

package/dist/types/mcp/canvas-access.d.ts

@@ -88,5 +88,5 @@ export declare function shouldAttachToExistingDaemon(occupant: {
  * FS-safe (defaults to false on any error).
  */
 export declare function looksLikeIncidentalCwd(cwd: string): boolean;
-export declare function createCanvasAccess(): Promise<CanvasAccess>;
+export declare function createCanvasAccess(allowExternalMcp?: boolean): Promise<CanvasAccess>;
 export {};

package/dist/types/mcp/canvas-app.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CanvasAccess } from './canvas-access.js';
+/** Focused app profile; deliberately does not register the general-purpose composites. */
+export declare function registerCanvasApp(server: McpServer, ensureCanvas: () => Promise<CanvasAccess>): void;

package/dist/types/mcp/workbench-app.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CanvasAccess } from './canvas-access.js';
+/** HTTP-shaped replies let the real workbench retain its existing API contracts. */
+export declare function registerWorkbenchApp(server: McpServer, ensureCanvas: () => Promise<CanvasAccess>): void;

package/dist/types/server/agent-presence.d.ts

@@ -99,7 +99,7 @@ export declare function estimateContextBudget(): ContextBudget;
 /** Returns the id of the pre-session snapshot the server took, if any. */
 type SessionStartListener = (presence: AgentPresence) => string | null;
 export type SessionEndReason = 'human' | 'agent' | 'idle-timeout';
-type SessionEndListener = (presence: AgentPresence, startSnapshotId: string | null, endedBy: SessionEndReason) => void;
+type SessionEndListener = (presence: AgentPresence, startSnapshotId: string | null, endedBy: SessionEndReason, startedAt: string | null) => void;
 export declare class AgentPresenceRegistry {
     private readonly presences;
     /** Newest first; bounded. Survives a writer fading — the feed is history, the writer list is presence. */

package/dist/types/server/ax-state.d.ts

@@ -1,6 +1,6 @@
 import type { CanvasLayout, CanvasNodeState } from './canvas-state.js';
 import type { AxApprovalStatus, AxEventKind, AxWorkItemStatus } from '../shared/ax-kinds.js';
-import type { AgentContextNode } from './agent-context.js';
+import type { AgentContextNode } from '../shared/agent-context.js';
 import type { ActorAttribution } from './attribution.js';
 export type PmxAxSource = 'agent' | 'amp' | 'api' | 'browser' | 'cli' | 'codex' | 'copilot' | 'mcp' | 'sdk' | 'system';
 export interface PmxAxFocusState {

package/dist/types/server/canvas-db.d.ts

@@ -5,6 +5,7 @@
  * WAL-mode persistence. Replaces the previous JSON file-based approach.
  */
 import { Database } from 'bun:sqlite';
+import type { ActorAttribution } from './attribution.js';
 import { type Tour } from '../shared/tour.js';
 import { type CanvasThemeName } from '../shared/themes.js';
 import type { CanvasAnnotation, CanvasEdge, CanvasNodeState, CanvasSnapshot, CanvasSnapshotListOptions, ViewportState } from './canvas-state.js';
@@ -20,9 +21,16 @@ export interface PersistedCanvasState {
     edges: CanvasEdge[];
     annotations?: CanvasAnnotation[];
     contextPins: string[];
+    /** Who pinned each context pin, when and why; pins without an entry have an unknown pinner. */
+    contextPinMeta?: Record<string, ContextPinMeta>;
     ax?: PmxAxState;
     revisionState?: PersistedRevisionState;
 }
+export interface ContextPinMeta {
+    pinnedBy: ActorAttribution;
+    pinnedAt: string;
+    reason?: string;
+}
 export interface PersistedRevisionState {
     revision: number;
     floor: number;

package/dist/types/server/canvas-geometry.d.ts

@@ -0,0 +1,25 @@
+import type { CanvasNodeState, CanvasNodeUpdate } from './canvas-state.js';
+/** Flat fields take precedence over nested aliases; absent axes remain absent. */
+export declare function resolveCreateGeometry(body: Record<string, unknown>): {
+    x: number | undefined;
+    y: number | undefined;
+    width: number | undefined;
+    height: number | undefined;
+};
+/** Guards and PATCH execution must resolve aliases and single-axis moves identically. */
+export declare function resolvePatchGeometry(body: Record<string, unknown>, existing: CanvasNodeState): {
+    size?: {
+        width: number;
+        height: number;
+    } | undefined;
+    position?: {
+        x: number;
+        y: number;
+    } | undefined;
+};
+export declare function validateCanvasNodePatch(patch: {
+    position?: unknown;
+    size?: unknown;
+}): string | null;
+/** Invalid patches cannot count as explicit child-position overrides. */
+export declare function validCanvasNodeUpdates(input: unknown): CanvasNodeUpdate[];

package/dist/types/server/canvas-operations.d.ts

@@ -130,16 +130,6 @@ export declare function syncCanvasRuntimeBackends(options?: {
     rehydrated: number;
     failed: number;
 }>;
-export declare function validateCanvasNodePatch(patch: {
-    position?: {
-        x: number;
-        y: number;
-    };
-    size?: {
-        width: number;
-        height: number;
-    };
-}): string | null;
 export declare function mergeTraceNodeDataFields(base: Record<string, unknown>, input: Record<string, unknown>): Record<string, unknown>;
 export declare function hasTraceNodeDataFields(input: Record<string, unknown>): boolean;
 export declare function scheduleCodeGraphRecompute(onComplete?: () => void): void;
@@ -189,7 +179,7 @@ export declare function applyCanvasNodeUpdates(updates: CanvasNodeUpdate[]): {
     applied: number;
     skipped: number;
 };
-export declare function setCanvasContextPins(nodeIds: string[], mode?: CanvasPinMode): {
+export declare function setCanvasContextPins(nodeIds: string[], mode?: CanvasPinMode, reason?: string): {
     count: number;
     nodeIds: string[];
 };