allyhub 0.2.0 → 0.4.0

package/node_modules/@allyhub-next/model/dist/build.js

@@ -1,2 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{fork as g}from"node:child_process";import{copyFile as b,mkdir as V,mkdtemp as I,rename as p,rm as M}from"node:fs/promises";import{createRequire as R}from"node:module";import{dirname as w,join as x,resolve as f}from"node:path";import{fileURLToPath as S}from"node:url";import{ModelError as l}from"./data.js";import{answerOf as _}from"./build-job.js";import{buildInputs as y,cacheKey as L,readModelCache as P,runtimeDigest as k,sweepModelCache as v,writeModelCache as C}from"./build-cache.js";export{buildInputs,cacheKey,readModelCache,runtimeDigest,sweepModelCache,writeModelCache}from"./build-cache.js";export{programLocation}from"./program-location.js";export{capabilities}from"./capabilities.js";export{ModelError}from"./data.js";export{modelReport}from"./report.js";export const BUILD_DEFAULTS={seed:0,maxPatternVertices:1e6,maxSurfaceVertices:1e6,maxInstances:1e5,timeout:60};const O=new URL(`./build-worker.${import.meta.url.endsWith(".ts")?"ts":"js"}`,import.meta.url),T=import.meta.url.endsWith(".ts")?["--import","tsx"]:[];let D;export function modelRuntimeDigest(){return D??=(()=>{const n=R(import.meta.url);return k([S(new URL(".",import.meta.url))],[n.resolve("manifold-3d/manifold.js"),n.resolve("manifold-3d/manifold.wasm")])})()}export async function buildModule(n,r){const c=f(n),t={file:c,parameters:r.parameters??{},seed:r.seed??BUILD_DEFAULTS.seed,maxPatternVertices:r.maxPatternVertices??BUILD_DEFAULTS.maxPatternVertices,maxSurfaceVertices:r.maxSurfaceVertices??BUILD_DEFAULTS.maxSurfaceVertices,maxInstances:r.maxInstances??BUILD_DEFAULTS.maxInstances,root:f(r.root)},s=r.timeout??BUILD_DEFAULTS.timeout;if(!Number.isFinite(s)||s<=0)throw new l("bad_timeout","The timeout must be positive seconds.");const e=r.out===void 0?void 0:f(r.out),i=r.log??(o=>{process.stderr.write(o)});let m;e&&(await V(w(e),{recursive:!0}),m=await I(x(w(e),".allyhub-model-")),t.out=x(m,"model.glb"));const a=r.cache?{root:t.root,dir:r.cache}:void 0;try{const o=L({file:c,parameters:t.parameters,seed:t.seed,maxPatternVertices:t.maxPatternVertices,maxSurfaceVertices:t.maxSurfaceVertices,maxInstances:t.maxInstances,runtime:await modelRuntimeDigest()});if(a&&await v(a.dir),a&&r.fresh!==!0){const d=await P(a,o,e!==void 0);if(d)return e&&t.out&&d.glb&&(await b(d.glb,t.out),await p(t.out,e)),{report:d.result,...e?{glb:e}:{},cache:"hit"}}const u=await E(t,s,i),h=a&&await C(a,o,await y(t.root,c,u.inputs),u.report,t.out);return e&&t.out&&await p(t.out,e),{report:u.report,...e?{glb:e}:{},cache:h?"stored":a?"unstored":"off"}}finally{m&&await M(m,{recursive:!0,force:!0})}}function E(n,r,c){return new Promise((t,s)=>{const e=g(O,[JSON.stringify(n)],{stdio:["ignore","pipe","pipe","ipc"],execArgv:T});e.stdout?.on("data",c),e.stderr?.on("data",c);let i,m=!1;const a=setTimeout(()=>{m=!0,e.kill("SIGKILL")},r*1e3);e.on("message",o=>{i=_(o)}),e.on("error",o=>{clearTimeout(a),s(o)}),e.on("exit",(o,u)=>{clearTimeout(a),m?s(new l("model_timeout",`Model exceeded ${String(r)} seconds.`)):i&&"error"in i?s(new l(i.error.code,i.error.message)):o!==0||!i?s(new l("model_failed",`Model worker exited with ${String(o??u)}.`)):t(i)})})}
+import{spawn as V}from"node:child_process";import{copyFile as M,mkdir as R,mkdtemp as y,rename as p,rm as I}from"node:fs/promises";import{createRequire as S}from"node:module";import{dirname as w,join as h,resolve as f}from"node:path";import{fileURLToPath as x,pathToFileURL as _}from"node:url";import{createPackages as j}from"@allyhub-next/runtimes";import{nodeCommand as L}from"@allyhub-next/runtimes/node";import{ModelError as u}from"./data.js";import{answerOf as P}from"./build-job.js";import{buildInputs as k,cacheKey as v,readModelCache as C,runtimeDigest as O,sweepModelCache as T,writeModelCache as D}from"./build-cache.js";export{buildInputs,cacheKey,readModelCache,runtimeDigest,sweepModelCache,writeModelCache}from"./build-cache.js";export{programLocation}from"./program-location.js";export{capabilities}from"./capabilities.js";export{ModelError}from"./data.js";export{modelReport}from"./report.js";export const BUILD_DEFAULTS={seed:0,maxPatternVertices:1e6,maxSurfaceVertices:1e6,maxInstances:1e5,timeout:60};const E=new URL(`./build-worker.${import.meta.url.endsWith(".ts")?"ts":"js"}`,import.meta.url),F=import.meta.url.endsWith(".ts")?["--import","tsx"]:[];let g;export function manifoldFiles(){return g??=(async()=>{try{const t=S(import.meta.url);return{js:t.resolve("manifold-3d/manifold.js"),wasm:t.resolve("manifold-3d/manifold.wasm")}}catch{}const o=j();await o.ensure("manifold-3d",{onFetch:()=>{process.stderr.write(`Getting Manifold, once, to build 3D models…
+`)}});const e=o.resolve("manifold-3d","manifold-3d/manifold.js"),n=o.resolve("manifold-3d","manifold-3d/manifold.wasm");if(!e||!n)throw new Error("manifold-3d holds no manifold.js");return{js:e,wasm:n}})().catch(o=>{throw g=void 0,o})}let U;export function modelRuntimeDigest(){return U??=manifoldFiles().then(({js:o,wasm:e})=>O([x(new URL(".",import.meta.url))],[o,e]))}export async function buildModule(o,e){const n=f(o),t={file:n,parameters:e.parameters??{},seed:e.seed??BUILD_DEFAULTS.seed,maxPatternVertices:e.maxPatternVertices??BUILD_DEFAULTS.maxPatternVertices,maxSurfaceVertices:e.maxSurfaceVertices??BUILD_DEFAULTS.maxSurfaceVertices,maxInstances:e.maxInstances??BUILD_DEFAULTS.maxInstances,root:f(e.root),manifold:_((await manifoldFiles()).js).href},m=e.timeout??BUILD_DEFAULTS.timeout;if(!Number.isFinite(m)||m<=0)throw new u("bad_timeout","The timeout must be positive seconds.");const r=e.out===void 0?void 0:f(e.out),s=e.log??(a=>{process.stderr.write(a)});let c;r&&(await R(w(r),{recursive:!0}),c=await y(h(w(r),".allyhub-model-")),t.out=h(c,"model.glb"));const i=e.cache?{root:t.root,dir:e.cache}:void 0;try{const a=v({file:n,parameters:t.parameters,seed:t.seed,maxPatternVertices:t.maxPatternVertices,maxSurfaceVertices:t.maxSurfaceVertices,maxInstances:t.maxInstances,runtime:await modelRuntimeDigest()});if(i&&await T(i.dir),i&&e.fresh!==!0){const l=await C(i,a,r!==void 0);if(l)return r&&t.out&&l.glb&&(await M(l.glb,t.out),await p(t.out,r)),{report:l.result,...r?{glb:r}:{},cache:"hit"}}const d=await K(t,m,s),b=i&&await D(i,a,await k(t.root,n,d.inputs),d.report,t.out);return r&&t.out&&await p(t.out,r),{report:d.report,...r?{glb:r}:{},cache:b?"stored":i?"unstored":"off"}}finally{c&&await I(c,{recursive:!0,force:!0})}}function K(o,e,n){return new Promise((t,m)=>{const r=V(L(),[...F,x(E),JSON.stringify(o)],{stdio:["ignore","pipe","pipe","ipc"]});r.stdout?.on("data",n),r.stderr?.on("data",n);let s,c=!1;const i=setTimeout(()=>{c=!0,r.kill("SIGKILL")},e*1e3);r.on("message",a=>{s=P(a)}),r.on("error",a=>{clearTimeout(i),m(a)}),r.on("exit",(a,d)=>{clearTimeout(i),c?m(new u("model_timeout",`Model exceeded ${String(e)} seconds.`)):s&&"error"in s?m(new u(s.error.code,s.error.message)):a!==0||!s?m(new u("model_failed",`Model worker exited with ${String(a??d)}.`)):t(s)})})}

package/node_modules/@allyhub-next/model/dist/report.d.ts

@@ -1,5 +1,5 @@
 /**
- * A built model as plain data: what `allyhub model inspect` and `model build`
+ * A built model as plain data: what `allyhub 3d-model inspect` and `model build`
  * print. Bounds are world-space surface bounds in Blender Z-up metres; a
  * transform-only object's are null. Textures name their image and where it
  * comes from, never its pixels.

package/node_modules/@allyhub-next/model/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allyhub-next/model",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "exports": {
     ".": {

package/node_modules/@allyhub-next/project/dist/digest.d.ts

@@ -5,7 +5,5 @@ export declare function baseDigest(prepared: Pick<Prepared, "bundle" | "root" |
 /** sha256 of the runtime bundle the stage loads. */
 runtime: string): Promise<string>;
 /** The digest of one version, given its piece's base and what it read. */
-export declare function outputDigest(prepared: Pick<Prepared, "messages" | "media" | "data">, base: string, piece: PieceInfo, combo: Combo, reads: Reads, 
-/** Its parts' keys: a deck's speaker notes key counts too. */
-parts: readonly string[]): string;
+export declare function outputDigest(prepared: Pick<Prepared, "messages" | "media" | "data">, base: string, piece: PieceInfo, combo: Combo, reads: Reads): string;
 //# sourceMappingURL=digest.d.ts.map

package/node_modules/@allyhub-next/project/dist/digest.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{createHash as l}from"node:crypto";import{readFile as A}from"node:fs/promises";import{join as B}from"node:path";import{fontsDigest as H}from"@allyhub-next/build";import{comboKey as J,mediaByStem as N,messagePrefix as _}from"@allyhub-next/video-core";const w="allyhub-digest-v4",g=s=>s.digest("hex");async function C(s,e){const n=s.bundle,u=n?.chunks.entries[e.id.replaceAll("/","__")];if(!n||!u)return null;const i=new Set,f=a=>{if(i.has(a))return;i.add(a);const c=n.chunks.chunks[a];if(c){for(const d of c.css)i.add(d);for(const d of c.imports)f(d)}};f(u.file);const r=l("sha256");for(const a of[...i].sort())r.update(`${a}\0`),r.update(await A(B(n.dir,a)).catch(()=>Buffer.alloc(0))),r.update("\0");return g(r)}export async function baseDigest(s,e,n){const u=await H(s.root,s.files,s.fonts),i=l("sha256");return i.update(`${w}\0piece\0`),i.update(JSON.stringify([n,e.id,e.file,e.dims,e.matrix?{space:e.matrix.space,rules:e.matrix.rules}:null,e.format,await C(s,e),...u===void 0?[]:[u]])),`sha256:${g(i)}`}function b(s,e){return s?Object.keys(s).filter(n=>n.startsWith(`${e}.`)).sort().map(n=>[n,s[n]]):[]}export function outputDigest(s,e,n,u,i,f){const r=s.messages.locales,a=r[0],c=u.lang,d=c===void 0?void 0:s.messages.messages[c],h=a===void 0?void 0:s.messages.messages[a],x=(t,o)=>t&&Object.hasOwn(t,o)?t[o]:null,y=(t,o)=>(t===void 0?void 0:s.messages.anchors[t]?.[o])??[],k=t=>{const o=x(d,t);return o!==null?[o,...y(c,t)]:[null,x(h,t),...y(a,t)]},S=t=>{const o=b(d,t);return o.length>0?[o]:[[],b(h,t)]},p=[...i.messages].sort((t,o)=>t.key===o.key?t.kind<o.kind?-1:1:t.key<o.key?-1:1).map(t=>t.kind==="list"?[t.key,"list",...S(t.key)]:[t.key,"text",...k(t.key)]),O=typeof n.options.prefix=="string"?n.options.prefix:_(n.id),D=n.kind==="slides"&&n.options.notes===!0?f.map(t=>`${O}.${t}.notes`).map(t=>[t,...k(t)]):[],j=[...new Set(i.media.map(t=>t.path))].sort().map(t=>{const o=s.media[t]??N(s.media,t);if(!o)return[t,null];const $={...o};return delete $.url,[t,$]}),v=[...new Set(i.data.map(t=>t.path))].sort().map(t=>[t,s.data[t]?.sha256??null]),m=l("sha256");return m.update(`${w}\0output\0${e}\0`),m.update(JSON.stringify([n.kind,n.options,J(u),r,p,D,j,v])),`sha256:${g(m)}`}
+import{createHash as m}from"node:crypto";import{readFile as A}from"node:fs/promises";import{join as B}from"node:path";import{fontsDigest as H}from"@allyhub-next/build";import{comboKey as J,mediaByStem as N,messagePrefix as W}from"@allyhub-next/video-core";const b="allyhub-digest-v4",h=s=>s.digest("hex");async function _(s,o){const n=s.bundle,u=n?.chunks.entries[o.id.replaceAll("/","__")];if(!n||!u)return null;const i=new Set,d=a=>{if(i.has(a))return;i.add(a);const r=n.chunks.chunks[a];if(r){for(const l of r.css)i.add(l);for(const l of r.imports)d(l)}};d(u.file);const c=m("sha256");for(const a of[...i].sort())c.update(`${a}\0`),c.update(await A(B(n.dir,a)).catch(()=>Buffer.alloc(0))),c.update("\0");return h(c)}export async function baseDigest(s,o,n){const u=await H(s.root,s.files,s.fonts),i=m("sha256");return i.update(`${b}\0piece\0`),i.update(JSON.stringify([n,o.id,o.file,o.dims,o.matrix?{space:o.matrix.space,rules:o.matrix.rules}:null,o.format,await _(s,o),...u===void 0?[]:[u]])),`sha256:${h(i)}`}function w(s,o){return s?Object.keys(s).filter(n=>n.startsWith(`${o}.`)).sort().map(n=>[n,s[n]]):[]}export function outputDigest(s,o,n,u,i){const d=s.messages.locales,c=d[0],a=u.lang,r=a===void 0?void 0:s.messages.messages[a],l=c===void 0?void 0:s.messages.messages[c],g=(t,e)=>t&&Object.hasOwn(t,e)?t[e]:null,k=(t,e)=>(t===void 0?void 0:s.messages.anchors[t]?.[e])??[],y=t=>{const e=g(r,t);return e!==null?[e,...k(a,t)]:[null,g(l,t),...k(c,t)]},S=t=>{const e=w(r,t);return e.length>0?[e]:[[],w(l,t)]},$=[...i.messages].sort((t,e)=>t.key===e.key?t.kind<e.kind?-1:1:t.key<e.key?-1:1).map(t=>t.kind==="list"?[t.key,"list",...S(t.key)]:[t.key,"text",...y(t.key)]),O=`${W(n.id)}.`,j=n.kind==="slides"?[n.deck?.file??null,...[...new Set([...Object.keys(r??{}),...Object.keys(l??{})])].filter(t=>t.startsWith(O)).sort().map(t=>[t,...y(t)])]:[],D=[...new Set(i.media.map(t=>t.path))].sort().map(t=>{const e=s.media[t]??N(s.media,t);if(!e)return[t,null];const x={...e};return delete x.url,[t,x]}),v=[...new Set(i.data.map(t=>t.path))].sort().map(t=>[t,s.data[t]?.sha256??null]),f=m("sha256");return f.update(`${b}\0output\0${o}\0`),f.update(JSON.stringify([n.kind,n.options,J(u),d,$,j,D,v])),`sha256:${h(f)}`}

package/node_modules/@allyhub-next/project/dist/page.d.ts

@@ -101,11 +101,6 @@ export declare class LoadedVersion implements VersionPage {
         x: number;
         y: number;
     }>;
-    /**
-     * As a constructed style sheet adopted by the document, not a <style>
-     * element: the page's watcher of changes outside the stage (AK-R003)
-     * sees no change to the DOM.
-     */
     hideText(on: boolean, outlines?: boolean): Promise<void>;
     measure(times?: readonly number[]): Promise<LayoutReport>;
     tracks(from: number, to: number): Promise<Track[]>;

package/node_modules/@allyhub-next/project/dist/page.js

@@ -1,4 +1,4 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{LoadError as c}from"@allyhub-next/stage";import{HIDE_OUTLINE_CSS as p,HIDE_TEXT_CSS as g,comboKey as l,problem as o,RULES as f}from"@allyhub-next/video-core";import{dedupe as w}from"./ledger.js";export class StuckError extends Error{code="AK-P003";kept;constructor(e,t){super(e),this.name="StuckError",this.kept=t}}const y="ak-hide-text";export class LoadedVersion{target;stage;summary;failed;hung=!1;constructor(e,t,s,a){this.target=e,this.stage=t,this.summary=s,this.failed=a}static async load(e,t,s,a,i){try{return new LoadedVersion(t,e,await s(),[])}catch(r){const h=r instanceof c?r.detail:r instanceof Error?r.message:String(r),n=await i?.(h).catch(()=>{}),u={piece:t.piece,output:t.output,combo:t.combo,format:t.format,where:n?{file:n.file,line:n.line}:{file:a}},m=r instanceof c&&r.code in f?r.code:"AK-R001",d=r instanceof Error?r.message.split(`
+import{LoadError as h}from"@allyhub-next/stage";import{comboKey as g,problem as o,RULES as p}from"@allyhub-next/video-core";import{dedupe as l}from"./ledger.js";export class StuckError extends Error{code="AK-P003";kept;constructor(e,t){super(e),this.name="StuckError",this.kept=t}}export class LoadedVersion{target;stage;summary;failed;hung=!1;constructor(e,t,s,a){this.target=e,this.stage=t,this.summary=s,this.failed=a}static async load(e,t,s,a,i){try{return new LoadedVersion(t,e,await s(),[])}catch(r){const c=r instanceof h?r.detail:r instanceof Error?r.message:String(r),n=await i?.(c).catch(()=>{}),m={piece:t.piece,output:t.output,combo:t.combo,format:t.format,where:n?{file:n.file,line:n.line}:{file:a}},u=r instanceof h&&r.code in p?r.code:"AK-R001",d=r instanceof Error?r.message.split(`
 `)[0]??"":String(r).split(`
-`)[0];return new LoadedVersion(t,e,void 0,[o(m,`Failed to load ${t.output} of ${t.piece} (${l(t.combo)}, ${t.format}): ${d??""}`,u)])}}get timeline(){if(!this.summary)throw new Error("The version did not load.");return this.summary.timeline}get backstop(){return((this.summary?.seekLimit??10)*2+30)*1e3}async answered(e,t){let s;try{return await Promise.race([e,new Promise((a,i)=>{s=setTimeout(()=>{this.hung=!0,i(new StuckError(`The page drawing ${this.target.piece} did not answer for the moment ${t.toFixed(2)} s in ${String(this.backstop/1e3)} s: piece code may run forever there (a loop that never ends, in a layer's render).`,!1))},this.backstop)})])}finally{clearTimeout(s)}}async seek(e,t){await this.answered(this.stage.seek(e,t===void 0?{}:{part:t}),e);const s=await this.stage.stuck();if(s!==void 0)throw new StuckError(s,!0)}sign(e){return this.answered(this.stage.signatureAt(e),e)}async shot(e){return await this.seek(e),this.stage.capture({format:"png"})}async thumb(e,t){return await this.seek(e),this.stage.drawing.frame({format:"png",scale:Math.min(1,t/this.stage.page.width)})}async region(e,t,s,a){return await this.seek(e,t),{png:await this.stage.drawing.frame({format:"png",clip:{x:s[0],y:s[1],width:s[2],height:s[3]},scale:a}),x:s[0],y:s[1],scale:1/a}}async grab(e){return{png:await this.stage.drawing.frame({format:"png",clip:{x:e[0],y:e[1],width:e[2],height:e[3]}}),x:e[0],y:e[1]}}async hideText(e,t=!1){const s=t?p:g,a=JSON.stringify(y);await this.stage.page.evaluate(`(() => { const w = window; const kept = w[${a}]; document.adoptedStyleSheets = document.adoptedStyleSheets.filter((x) => x !== kept); if (!${String(e)}) return; const s = new CSSStyleSheet(); s.replaceSync(${JSON.stringify(s)}); w[${a}] = s; document.adoptedStyleSheets = [...document.adoptedStyleSheets, s]; })()`)}measure(e){return this.stage.measure(e)}tracks(e,t){return this.stage.tracks(e,t)}inks(e){return this.stage.inks(e)}ask(e,t){return this.stage.ask(e,t)}async problems(){const e={piece:this.target.piece,output:this.target.output,combo:this.target.combo,format:this.target.format};let t=[];if(this.summary&&!this.hung)try{t=await this.stage.problems()}catch{t=this.summary.problems}return w([...this.failed,...this.stage.refused().map(s=>o("AK-N003",`The sandbox blocked a request: ${s}. Piece code has no network.`,e)),...this.stage.page.errors().map(s=>o("AK-R001",`The runtime threw an unhandled exception: ${s.text}`,e)),...t])}async console(){if(this.hung)return{messages:[],dropped:0};try{return await this.stage.console()}catch{return{messages:[],dropped:0}}}close(){return this.stage.close()}}
+`)[0];return new LoadedVersion(t,e,void 0,[o(u,`Failed to load ${t.output} of ${t.piece} (${g(t.combo)}, ${t.format}): ${d??""}`,m)])}}get timeline(){if(!this.summary)throw new Error("The version did not load.");return this.summary.timeline}get backstop(){return((this.summary?.seekLimit??10)*2+30)*1e3}async answered(e,t){let s;try{return await Promise.race([e,new Promise((a,i)=>{s=setTimeout(()=>{this.hung=!0,i(new StuckError(`The page drawing ${this.target.piece} did not answer for the moment ${t.toFixed(2)} s in ${String(this.backstop/1e3)} s: piece code may run forever there (a loop that never ends, in a layer's render).`,!1))},this.backstop)})])}finally{clearTimeout(s)}}async seek(e,t){await this.answered(this.stage.seek(e,t===void 0?{}:{part:t}),e);const s=await this.stage.stuck();if(s!==void 0)throw new StuckError(s,!0)}sign(e){return this.answered(this.stage.signatureAt(e),e)}async shot(e){return await this.seek(e),this.stage.capture({format:"png"})}async thumb(e,t){return await this.seek(e),this.stage.drawing.frame({format:"png",scale:Math.min(1,t/this.stage.page.width)})}async region(e,t,s,a){return await this.seek(e,t),{png:await this.stage.drawing.frame({format:"png",clip:{x:s[0],y:s[1],width:s[2],height:s[3]},scale:a}),x:s[0],y:s[1],scale:1/a}}async grab(e){return{png:await this.stage.drawing.frame({format:"png",clip:{x:e[0],y:e[1],width:e[2],height:e[3]}}),x:e[0],y:e[1]}}hideText(e,t=!1){return this.stage.hideText(e,t)}measure(e){return this.stage.measure(e)}tracks(e,t){return this.stage.tracks(e,t)}inks(e){return this.stage.inks(e)}ask(e,t){return this.stage.ask(e,t)}async problems(){const e={piece:this.target.piece,output:this.target.output,combo:this.target.combo,format:this.target.format};let t=[];if(this.summary&&!this.hung)try{t=await this.stage.problems()}catch{t=this.summary.problems}return l([...this.failed,...this.stage.refused().map(s=>o("AK-N003",`The sandbox blocked a request: ${s}. Piece code has no network.`,e)),...this.stage.page.errors().map(s=>o("AK-R001",`The runtime threw an unhandled exception: ${s.text}`,e)),...t])}async console(){if(this.hung)return{messages:[],dropped:0};try{return await this.stage.console()}catch{return{messages:[],dropped:0}}}close(){return this.stage.close()}}

package/node_modules/@allyhub-next/project/dist/session.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{createHash as l}from"node:crypto";import{readFile as h,rm as w}from"node:fs/promises";import{join as a}from"node:path";import{startBrowser as b}from"@allyhub-next/browser";import{placeFinder as f,prepare as g,sourceOf as D}from"@allyhub-next/build";import{CACHE_DIR as v}from"@allyhub-next/formats";import{stageFiles as L}from"@allyhub-next/runtime/host";import{BUILD_BASE as d,StagePage as O,mediaUrl as c,sceneryHost as y,serveDecoders as S,serveStage as F}from"@allyhub-next/stage";import{CONSOLE_LIMIT as I}from"@allyhub-next/video-core";import{LoadedVersion as j}from"./page.js";let m;export function runtimeDigest(){return m??=h(L().runtime).then(p=>l("sha256").update(p).digest("hex")),m}export class CheckSession{prepared;browser;consoleLimit;server;owned;places;constructor(e,o,t,r,s,i){this.prepared=e,this.browser=o,this.server=t,this.consoleLimit=r,this.places=i,this.owned=s}static async open(e){const o=e.buildDir===void 0,t=e.buildDir??a(e.root,v,"build",`check-${String(process.pid)}`),r=await g(e.root,{buildDir:t,mediaUrl:c,host:y(e.root)});r.bundle&&await S(r.bundle.dir);const s=r.bundle?.dir??t,i=await F({buildDir:s,root:r.root,media:Object.keys(r.media)});let n=e.browser;try{n??=await b(e.gpu===void 0?{}:{gpu:e.gpu})}catch(u){throw await i.close(),u}return new CheckSession(r,n,i,e.consoleLimit??I,{browser:e.browser===void 0,...o?{buildDir:t}:{}},f({served:new URL(d,i.origin).href,dir:s,root:r.root}))}get gpu(){return this.browser.gpu}mediaPath(e){return Object.hasOwn(this.prepared.media,e)?a(this.prepared.root,e):void 0}async open(e,o,t="check"){const r=await O.open({format:e.format},{browser:this.browser,server:this.server,beginFrame:this.browser.beginFrame}),s=D(this.prepared,e,d,c);return j.load(r,o,()=>r.load(s,{combo:o.combo,purpose:t,consoleLimit:this.consoleLimit}),e.file,i=>this.places.placeOf(i))}async close(){await this.server.close(),this.owned.browser&&await this.browser.close(),this.owned.buildDir!==void 0&&await w(this.owned.buildDir,{recursive:!0,force:!0})}}
+import{createHash as l}from"node:crypto";import{readFile as h,rm as w}from"node:fs/promises";import{join as a}from"node:path";import{startBrowser as b}from"@allyhub-next/browser";import{placeFinder as f,prepare as g,sourceOf as D}from"@allyhub-next/build";import{CACHE_DIR as v}from"@allyhub-next/formats";import{stageFiles as L}from"@allyhub-next/stage-page";import{BUILD_BASE as d,StagePage as O,mediaUrl as c,sceneryHost as y,serveDecoders as S,serveStage as F}from"@allyhub-next/stage";import{CONSOLE_LIMIT as I}from"@allyhub-next/video-core";import{LoadedVersion as j}from"./page.js";let m;export function runtimeDigest(){return m??=h(L().runtime).then(p=>l("sha256").update(p).digest("hex")),m}export class CheckSession{prepared;browser;consoleLimit;server;owned;places;constructor(e,o,t,r,s,i){this.prepared=e,this.browser=o,this.server=t,this.consoleLimit=r,this.places=i,this.owned=s}static async open(e){const o=e.buildDir===void 0,t=e.buildDir??a(e.root,v,"build",`check-${String(process.pid)}`),r=await g(e.root,{buildDir:t,mediaUrl:c,host:y(e.root)});r.bundle&&await S(r.bundle.dir);const s=r.bundle?.dir??t,i=await F({buildDir:s,root:r.root,media:Object.keys(r.media)});let n=e.browser;try{n??=await b(e.gpu===void 0?{}:{gpu:e.gpu})}catch(u){throw await i.close(),u}return new CheckSession(r,n,i,e.consoleLimit??I,{browser:e.browser===void 0,...o?{buildDir:t}:{}},f({served:new URL(d,i.origin).href,dir:s,root:r.root}))}get gpu(){return this.browser.gpu}mediaPath(e){return Object.hasOwn(this.prepared.media,e)?a(this.prepared.root,e):void 0}async open(e,o,t="check"){const r=await O.open({format:e.format},{browser:this.browser,server:this.server,beginFrame:this.browser.beginFrame}),s=D(this.prepared,e,d,c);return j.load(r,o,()=>r.load(s,{combo:o.combo,purpose:t,consoleLimit:this.consoleLimit}),e.file,i=>this.places.placeOf(i))}async close(){await this.server.close(),this.owned.browser&&await this.browser.close(),this.owned.buildDir!==void 0&&await w(this.owned.buildDir,{recursive:!0,force:!0})}}

package/node_modules/@allyhub-next/project/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allyhub-next/project",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "exports": {
     ".": {

package/node_modules/@allyhub-next/protocol/dist/app.d.ts

@@ -1,14 +1,4 @@
 import { z } from "zod";
-/** The tool the model calls to show an item. */
-export declare const OPEN_TOOL = "allyhub_open";
-/** The card's resource. */
-export declare const CARD_RESOURCE = "ui://allyhub/card";
-/** Where the tool result's `_meta` holds the card whole. */
-export declare const CARD_META = "allyhub/card";
-/** `allyhub_open`'s input. */
-export declare const OpenInputSchema: z.ZodObject<{
-    path: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
 /** What the card shows of an item, made from its files when it is opened. */
 export declare const PreviewSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"picture">;
@@ -36,6 +26,7 @@ export declare const CardItemSchema: z.ZodObject<{
         doc: "doc";
         sheet: "sheet";
         scenery: "scenery";
+        model: "model";
         website: "website";
     }>;
     dir: z.ZodString;
@@ -43,56 +34,4 @@ export declare const CardItemSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type CardItem = z.infer<typeof CardItemSchema>;
-/** `allyhub_open`'s structured result: what the card shows. */
-export declare const CardSchema: z.ZodObject<{
-    project: z.ZodObject<{
-        name: z.ZodString;
-    }, z.core.$strict>;
-    url: z.ZodString;
-    item: z.ZodOptional<z.ZodObject<{
-        kind: z.ZodEnum<{
-            video: "video";
-            slides: "slides";
-            doc: "doc";
-            sheet: "sheet";
-            scenery: "scenery";
-            website: "website";
-        }>;
-        dir: z.ZodString;
-        entry: z.ZodString;
-        title: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-    preview: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        type: z.ZodLiteral<"picture">;
-        image: z.ZodObject<{
-            mime: z.ZodString;
-            data: z.ZodBase64;
-        }, z.core.$strict>;
-        width: z.ZodInt;
-        height: z.ZodInt;
-        duration: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strict>, z.ZodObject<{
-        type: z.ZodLiteral<"text">;
-        lines: z.ZodArray<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        type: z.ZodLiteral<"table">;
-        columns: z.ZodArray<z.ZodString>;
-        rows: z.ZodArray<z.ZodArray<z.ZodString>>;
-        count: z.ZodInt;
-    }, z.core.$strict>], "type">>;
-    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        kind: z.ZodEnum<{
-            video: "video";
-            slides: "slides";
-            doc: "doc";
-            sheet: "sheet";
-            scenery: "scenery";
-            website: "website";
-        }>;
-        dir: z.ZodString;
-        entry: z.ZodString;
-        title: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>>;
-}, z.core.$strict>;
-export type Card = z.infer<typeof CardSchema>;
 //# sourceMappingURL=app.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/app.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as t}from"zod";import{KINDS as r}from"@allyhub-next/formats";import{PathSchema as e}from"./files.js";import{ImageSchema as i}from"./tools.js";export const OPEN_TOOL="allyhub_open",CARD_RESOURCE="ui://allyhub/card",CARD_META="allyhub/card",OpenInputSchema=t.strictObject({path:t.string().min(1).optional().describe("The item to open: its folder or entry file, absolute or from the folder allyhub mcp runs in (launch/plan, launch/plan/doc.mdx); leave it out for the project's items")}),PreviewSchema=t.discriminatedUnion("type",[t.strictObject({type:t.literal("picture"),image:i,width:t.int().positive(),height:t.int().positive(),duration:t.number().nonnegative().optional()}),t.strictObject({type:t.literal("text"),lines:t.array(t.string())}),t.strictObject({type:t.literal("table"),columns:t.array(t.string()),rows:t.array(t.array(t.string())),count:t.int().nonnegative()})]),CardItemSchema=t.strictObject({kind:t.enum(r),dir:e,entry:e,title:t.string().optional()}),CardSchema=t.strictObject({project:t.strictObject({name:t.string().min(1)}),url:t.string().min(1),item:CardItemSchema.optional(),preview:PreviewSchema.optional(),items:t.array(CardItemSchema).optional()});
+import{z as t}from"zod";import{KINDS as e}from"@allyhub-next/formats";import{PathSchema as i}from"./files.js";import{ImageSchema as r}from"./tools.js";export const PreviewSchema=t.discriminatedUnion("type",[t.strictObject({type:t.literal("picture"),image:r,width:t.int().positive(),height:t.int().positive(),duration:t.number().nonnegative().optional()}),t.strictObject({type:t.literal("text"),lines:t.array(t.string())}),t.strictObject({type:t.literal("table"),columns:t.array(t.string()),rows:t.array(t.array(t.string())),count:t.int().nonnegative()})]),CardItemSchema=t.strictObject({kind:t.enum(e),dir:i,entry:i,title:t.string().optional()});

package/node_modules/@allyhub-next/protocol/dist/auth.d.ts

@@ -25,6 +25,10 @@ export declare const ORGANIZATION_HEADER = "x-allyhub-organization";
 export declare const DEVICES_PAGE_PATH = "/devices";
 /** `GET`: the computers signed in as the person (a session's alone); `DELETE <path>/<id>` signs one out. */
 export declare const DEVICES_PATH = "/api/account/devices";
+/** `GET`, from the account site: everything kept about the person, as a file. */
+export declare const ACCOUNT_EXPORT_PATH = "/api/account/export";
+/** `POST`, from the account site: mails the link that deletes the account, unless something stands in the way. */
+export declare const ACCOUNT_DELETE_PATH = "/api/account/delete";
 export declare const DevicesSchema: z.ZodObject<{
     devices: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -34,6 +38,19 @@ export declare const DevicesSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Devices = z.infer<typeof DevicesSchema>;
+/**
+ * `POST { to }` with a computer's sign-in (the CLI's client): a link,
+ * `{ url }`, that signs a browser in as the person once, within three
+ * minutes, then opens `to`, a page of the account site (`/plan?view=…`).
+ */
+export declare const BROWSER_LINK_PATH = "/api/account/browser-link";
+export declare const BrowserLinkRequestSchema: z.ZodObject<{
+    to: z.ZodString;
+}, z.core.$strict>;
+export declare const BrowserLinkSchema: z.ZodObject<{
+    url: z.ZodURL;
+}, z.core.$strip>;
+export type BrowserLink = z.infer<typeof BrowserLinkSchema>;
 /** The credentials file, relative to the home folder (ALLYHUB_HOME moves it). */
 export declare const CREDENTIALS_FILE = ".allyhub/credentials.json";
 /** A token endpoint's answer (RFC 6749 5.1). */
@@ -96,21 +113,4 @@ export declare const CredentialsFileSchema: z.ZodObject<{
     since: z.ZodISODateTime;
 }, z.core.$strict>;
 export type CredentialsFile = z.infer<typeof CredentialsFileSchema>;
-/** What `allyhub auth token --json` prints: an access token for the API, renewed as needed. */
-export declare const TokenOutputSchema: z.ZodObject<{
-    accessToken: z.ZodString;
-    expiresAt: z.ZodISODateTime;
-    account: z.ZodObject<{
-        id: z.ZodString;
-        email: z.ZodEmail;
-        name: z.ZodOptional<z.ZodString>;
-        organization: z.ZodOptional<z.ZodObject<{
-            id: z.ZodString;
-            name: z.ZodString;
-        }, z.core.$strict>>;
-    }, z.core.$strict>;
-}, z.core.$strict>;
-export type TokenOutput = z.infer<typeof TokenOutputSchema>;
-/** What a client sends with it: `Authorization: Bearer <accessToken>`. */
-export declare const bearer: (token: TokenOutput) => string;
 //# sourceMappingURL=auth.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/auth.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as e}from"zod";export const AuthServerSchema=e.object({issuer:e.url(),authorization_endpoint:e.url(),token_endpoint:e.url(),device_authorization_endpoint:e.url(),revocation_endpoint:e.url(),code_challenge_methods_supported:e.array(e.string()).refine(t=>t.includes("S256"),{message:"The server must take S256 PKCE challenges."})}),CLIENT_ID="allyhub-cli",ISSUER_PATH="/api/auth",METADATA_PATH=`/.well-known/oauth-authorization-server${ISSUER_PATH}`,SCOPES="openid profile email offline_access",ACCOUNT_PATH="/api/account",ORGANIZATION_HEADER="x-allyhub-organization",DEVICES_PAGE_PATH="/devices",DEVICES_PATH="/api/account/devices",DevicesSchema=e.object({devices:e.array(e.object({id:e.string(),client:e.string(),signedInAt:e.iso.datetime(),lastActiveAt:e.iso.datetime()}))}),CREDENTIALS_FILE=".allyhub/credentials.json",TokenResponseSchema=e.object({access_token:e.string().min(1),token_type:e.string(),expires_in:e.number().positive(),refresh_token:e.string().min(1).optional(),scope:e.string().optional()}),OAuthErrorSchema=e.object({error:e.string(),error_description:e.string().optional()}),DeviceAuthorizationSchema=e.object({device_code:e.string().min(1),user_code:e.string().min(1),verification_uri:e.url(),verification_uri_complete:e.url().optional(),expires_in:e.number().positive(),interval:e.number().positive().optional()}),AccountSchema=e.strictObject({id:e.string().min(1),email:e.email(),name:e.string().optional(),organization:e.strictObject({id:e.string().min(1),name:e.string()}).optional()}),CredentialsFileSchema=e.strictObject({version:e.literal(1),url:e.url(),issuer:e.url(),account:AccountSchema,refreshToken:e.string().min(1),access:e.strictObject({token:e.string().min(1),expiresAt:e.iso.datetime({offset:!0})}).optional(),since:e.iso.datetime({offset:!0})}),TokenOutputSchema=e.strictObject({accessToken:e.string().min(1),expiresAt:e.iso.datetime({offset:!0}),account:AccountSchema}),bearer=t=>`Bearer ${t.accessToken}`;
+import{z as e}from"zod";export const AuthServerSchema=e.object({issuer:e.url(),authorization_endpoint:e.url(),token_endpoint:e.url(),device_authorization_endpoint:e.url(),revocation_endpoint:e.url(),code_challenge_methods_supported:e.array(e.string()).refine(t=>t.includes("S256"),{message:"The server must take S256 PKCE challenges."})}),CLIENT_ID="allyhub-cli",ISSUER_PATH="/api/auth",METADATA_PATH=`/.well-known/oauth-authorization-server${ISSUER_PATH}`,SCOPES="openid profile email offline_access",ACCOUNT_PATH="/api/account",ORGANIZATION_HEADER="x-allyhub-organization",DEVICES_PAGE_PATH="/devices",DEVICES_PATH="/api/account/devices",ACCOUNT_EXPORT_PATH="/api/account/export",ACCOUNT_DELETE_PATH="/api/account/delete",DevicesSchema=e.object({devices:e.array(e.object({id:e.string(),client:e.string(),signedInAt:e.iso.datetime(),lastActiveAt:e.iso.datetime()}))}),BROWSER_LINK_PATH="/api/account/browser-link",BrowserLinkRequestSchema=e.strictObject({to:e.string().startsWith("/")}),BrowserLinkSchema=e.object({url:e.url()}),CREDENTIALS_FILE=".allyhub/credentials.json",TokenResponseSchema=e.object({access_token:e.string().min(1),token_type:e.string(),expires_in:e.number().positive(),refresh_token:e.string().min(1).optional(),scope:e.string().optional()}),OAuthErrorSchema=e.object({error:e.string(),error_description:e.string().optional()}),DeviceAuthorizationSchema=e.object({device_code:e.string().min(1),user_code:e.string().min(1),verification_uri:e.url(),verification_uri_complete:e.url().optional(),expires_in:e.number().positive(),interval:e.number().positive().optional()}),AccountSchema=e.strictObject({id:e.string().min(1),email:e.email(),name:e.string().optional(),organization:e.strictObject({id:e.string().min(1),name:e.string()}).optional()}),CredentialsFileSchema=e.strictObject({version:e.literal(1),url:e.url(),issuer:e.url(),account:AccountSchema,refreshToken:e.string().min(1),access:e.strictObject({token:e.string().min(1),expiresAt:e.iso.datetime({offset:!0})}).optional(),since:e.iso.datetime({offset:!0})});

package/node_modules/@allyhub-next/protocol/dist/cli.d.ts

@@ -26,7 +26,7 @@ export declare const CliErrorSchema: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strict>;
 export type CliError = z.infer<typeof CliErrorSchema>;
-/** A command's name: words in lowercase, `scenery view`. */
+/** A command's name: words in lowercase, `scenery view`; a word may start with a digit, `3d-model`. */
 export declare const COMMAND_NAME: RegExp;
 export interface CommandSpec<I extends z.ZodObject = z.ZodObject, O extends z.ZodType = z.ZodType> {
     name: string;
@@ -40,8 +40,6 @@ export interface CommandSpec<I extends z.ZodObject = z.ZodObject, O extends z.Zo
     output: O;
     /** Lines of `allyhub help <command>` that show it at work. */
     examples?: readonly string[];
-    /** Exposed as an MCP tool by `allyhub mcp` (most are; one that talks to a terminal is not). */
-    mcp?: boolean;
 }
 /** A command's spec, checked: its name's form, and that each positional is a field. */
 export declare function command<I extends z.ZodObject, O extends z.ZodType>(spec: CommandSpec<I, O>): CommandSpec<I, O>;
@@ -54,6 +52,4 @@ export declare function describeCommand(spec: CommandSpec): {
     output: Record<string, unknown>;
     examples: string[];
 };
-/** The MCP tool name of a command: `scenery view` is `allyhub_scenery_view`. */
-export declare const toolName: (name: string) => string;
 //# sourceMappingURL=cli.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/cli.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as o}from"zod";export const EXIT={ok:0,failed:1,usage:2,conflict:3,auth:4,platform:5,notFound:6,interrupted:130},CliErrorSchema=o.strictObject({error:o.strictObject({code:o.string().regex(/^[a-z][a-z0-9-]*$/u),message:o.string().min(1),hint:o.string().optional()})}),COMMAND_NAME=/^[a-z][a-z0-9-]*(?: [a-z][a-z0-9-]*)*$/u;export function command(t){if(!COMMAND_NAME.test(t.name))throw new Error(`"${t.name}" is not a command name.`);const e=Object.keys(t.input.shape);for(const n of t.positional??[])if(!e.includes(n))throw new Error(`${t.name}: positional "${n}" is not a field of its input.`);for(const[n,r]of Object.entries(t.input.shape))if(!r.description)throw new Error(`${t.name}: "${n}" has no description.`);return t}export function describeCommand(t){return{name:t.name,summary:t.summary,positional:[...t.positional??[]],input:o.toJSONSchema(t.input,{io:"input",unrepresentable:"any"}),output:o.toJSONSchema(t.output,{io:"output",unrepresentable:"any"}),examples:[...t.examples??[]]}}export const toolName=t=>`allyhub_${t.replaceAll(/[ -]/gu,"_")}`;
+import{z as o}from"zod";export const EXIT={ok:0,failed:1,usage:2,conflict:3,auth:4,platform:5,notFound:6,interrupted:130},CliErrorSchema=o.strictObject({error:o.strictObject({code:o.string().regex(/^[a-z][a-z0-9-]*$/u),message:o.string().min(1),hint:o.string().optional()})}),COMMAND_NAME=/^[a-z0-9][a-z0-9-]*(?: [a-z0-9][a-z0-9-]*)*$/u;export function command(t){if(!COMMAND_NAME.test(t.name))throw new Error(`"${t.name}" is not a command name.`);const e=Object.keys(t.input.shape);for(const n of t.positional??[])if(!e.includes(n))throw new Error(`${t.name}: positional "${n}" is not a field of its input.`);for(const[n,r]of Object.entries(t.input.shape))if(!r.description)throw new Error(`${t.name}: "${n}" has no description.`);return t}export function describeCommand(t){return{name:t.name,summary:t.summary,positional:[...t.positional??[]],input:o.toJSONSchema(t.input,{io:"input",unrepresentable:"any"}),output:o.toJSONSchema(t.output,{io:"output",unrepresentable:"any"}),examples:[...t.examples??[]]}}

package/node_modules/@allyhub-next/protocol/dist/editor.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { type ClientOf } from "./jsonrpc.js";
+import type { NoteSurface } from "./notes.js";
 export declare const ThemeSchema: z.ZodEnum<{
     light: "light";
     dark: "dark";
@@ -23,6 +24,7 @@ export declare const HostContextSchema: z.ZodObject<{
             doc: "doc";
             sheet: "sheet";
             scenery: "scenery";
+            model: "model";
             website: "website";
         }>;
         dir: z.ZodString;
@@ -70,6 +72,7 @@ export declare const HOST_METHODS: {
                 doc: "doc";
                 sheet: "sheet";
                 scenery: "scenery";
+                model: "model";
                 website: "website";
             }>;
             dir: z.ZodString;
@@ -113,19 +116,6 @@ export declare const HOST_METHODS: {
         }>;
         message: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
-    readonly "editor/context": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
-        text: z.ZodString;
-        at: z.ZodOptional<z.ZodObject<{
-            t: z.ZodNumber;
-            version: z.ZodString;
-        }, z.core.$strict>>;
-        picture: z.ZodOptional<z.ZodObject<{
-            x: z.ZodNumber;
-            y: z.ZodNumber;
-            width: z.ZodNumber;
-            height: z.ZodNumber;
-        }, z.core.$strict>>;
-    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
     readonly "tools/call": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
         name: z.ZodString;
         arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -174,6 +164,7 @@ export declare const HOST_NOTIFICATIONS: {
             item: z.ZodString;
             versions: z.ZodArray<z.ZodString>;
             types: z.ZodArray<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
             state: z.ZodEnum<{
                 running: "running";
                 done: "done";
@@ -232,6 +223,7 @@ export declare const HOST_NOTIFICATIONS: {
                 doc: "doc";
                 sheet: "sheet";
                 scenery: "scenery";
+                model: "model";
                 website: "website";
             }>;
             dir: z.ZodString;
@@ -246,6 +238,11 @@ export declare const HOST_NOTIFICATIONS: {
             website: "website";
         }>;
     }, z.core.$strict>>;
+    readonly "editor/command": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        command: z.ZodEnum<{
+            export: "export";
+        }>;
+    }, z.core.$strict>>;
 };
 /** Every method an editor may call on its host. */
 export declare const EDITOR_HOST_METHODS: {
@@ -268,6 +265,7 @@ export declare const EDITOR_HOST_METHODS: {
                 doc: "doc";
                 sheet: "sheet";
                 scenery: "scenery";
+                model: "model";
                 website: "website";
             }>;
             dir: z.ZodString;
@@ -311,19 +309,6 @@ export declare const EDITOR_HOST_METHODS: {
         }>;
         message: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
-    readonly "editor/context": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
-        text: z.ZodString;
-        at: z.ZodOptional<z.ZodObject<{
-            t: z.ZodNumber;
-            version: z.ZodString;
-        }, z.core.$strict>>;
-        picture: z.ZodOptional<z.ZodObject<{
-            x: z.ZodNumber;
-            y: z.ZodNumber;
-            width: z.ZodNumber;
-            height: z.ZodNumber;
-        }, z.core.$strict>>;
-    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
     readonly "tools/call": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
         name: z.ZodString;
         arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -401,5 +386,7 @@ export declare const EDITOR_HOST_METHODS: {
 export type EditorHost = ClientOf<typeof EDITOR_HOST_METHODS> & {
     /** Tells `files/changed`, `host/context-changed` and the tools' notifications; answers how to stop. */
     on<N extends keyof typeof HOST_NOTIFICATIONS>(name: N, listener: (params: z.output<(typeof HOST_NOTIFICATIONS)[N]["params"]>) => void): () => void;
+    /** Gives the host what it asks of the editor for a person's notes; answers how to stop. Absent where nobody takes notes. */
+    notes?(surface: NoteSurface): () => void;
 };
 //# sourceMappingURL=editor.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/editor.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as t}from"zod";import{EDITORS as r,KINDS as s}from"@allyhub-next/formats";import{FILE_METHODS as n,FILE_NOTIFICATIONS as i,PathSchema as o}from"./files.js";import{method as e,notification as a}from"./jsonrpc.js";import{TOOL_NOTIFICATIONS as c}from"./tools.js";export const ThemeSchema=t.enum(["light","dark"]),HostContextSchema=t.strictObject({locale:t.string().min(2),theme:ThemeSchema,agent:t.strictObject({name:t.string().min(1)}).optional(),project:t.strictObject({name:t.string().min(1)}),item:t.strictObject({kind:t.enum(s),dir:o,entry:o}),editor:t.enum(r)}),OpenTargetSchema=t.discriminatedUnion("type",[t.strictObject({type:t.literal("file"),path:o,line:t.int().positive().optional()}),t.strictObject({type:t.literal("browser"),url:t.url({protocol:/^https?$/u}).optional(),tabId:t.string().min(1).optional()})]),EDITOR_STATES=["saved","saving","unsaved","error"],HOST_METHODS={"host/context":e(t.strictObject({}),HostContextSchema,"Where the editor runs."),"items/open":e(t.strictObject({target:OpenTargetSchema}),t.strictObject({}),"Shows another item, a file or a page, where the host shows things."),"storage/get":e(t.strictObject({key:t.string().min(1)}),t.strictObject({value:t.unknown()}),"What the editor kept for this person on this computer (a hand sort, what was last seen), or null."),"storage/set":e(t.strictObject({key:t.string().min(1),value:t.unknown()}),t.strictObject({}),"Keeps a value for this person on this computer; null removes it."),"editor/state":e(t.strictObject({state:t.enum(EDITOR_STATES),message:t.string().optional()}),t.strictObject({}),"Says whether what the person typed is saved."),"editor/context":e(t.strictObject({text:t.string(),at:t.strictObject({t:t.number().nonnegative(),version:t.string()}).optional(),picture:t.strictObject({x:t.number(),y:t.number(),width:t.number().positive(),height:t.number().positive()}).optional()}),t.strictObject({}),"Tells the host what the editor shows, as MCP Apps' ui/update-model-context does: what a note the person makes on it is about."),"tools/call":e(t.strictObject({name:t.string().min(1),arguments:t.record(t.string(),t.unknown()).default({})}),t.strictObject({result:t.unknown()}),"Runs one of the project server's tools (tools.ts's PROJECT_TOOLS), for an editor that needs more than files (a video's preview, a still).")},HOST_NOTIFICATIONS={"host/context-changed":a(HostContextSchema,"The language, theme or agent changed."),...i,...c},EDITOR_HOST_METHODS={...n,...HOST_METHODS};
+import{z as t}from"zod";import{EDITORS as s,KINDS as n}from"@allyhub-next/formats";import{FILE_METHODS as i,FILE_NOTIFICATIONS as a,PathSchema as o}from"./files.js";import{method as e,notification as r}from"./jsonrpc.js";import{TOOL_NOTIFICATIONS as c}from"./tools.js";export const ThemeSchema=t.enum(["light","dark"]),HostContextSchema=t.strictObject({locale:t.string().min(2),theme:ThemeSchema,agent:t.strictObject({name:t.string().min(1)}).optional(),project:t.strictObject({name:t.string().min(1)}),item:t.strictObject({kind:t.enum(n),dir:o,entry:o}),editor:t.enum(s)}),OpenTargetSchema=t.discriminatedUnion("type",[t.strictObject({type:t.literal("file"),path:o,line:t.int().positive().optional()}),t.strictObject({type:t.literal("browser"),url:t.url({protocol:/^https?$/u}).optional(),tabId:t.string().min(1).optional()})]),EDITOR_STATES=["saved","saving","unsaved","error"],HOST_METHODS={"host/context":e(t.strictObject({}),HostContextSchema,"Where the editor runs."),"items/open":e(t.strictObject({target:OpenTargetSchema}),t.strictObject({}),"Shows another item, a file or a page, where the host shows things."),"storage/get":e(t.strictObject({key:t.string().min(1)}),t.strictObject({value:t.unknown()}),"What the editor kept for this person on this computer (a hand sort, what was last seen), or null."),"storage/set":e(t.strictObject({key:t.string().min(1),value:t.unknown()}),t.strictObject({}),"Keeps a value for this person on this computer; null removes it."),"editor/state":e(t.strictObject({state:t.enum(EDITOR_STATES),message:t.string().optional()}),t.strictObject({}),"Says whether what the person typed is saved."),"tools/call":e(t.strictObject({name:t.string().min(1),arguments:t.record(t.string(),t.unknown()).default({})}),t.strictObject({result:t.unknown()}),"Runs one of the project server's tools (tools.ts's PROJECT_TOOLS), for an editor that needs more than files (a video's preview, a still).")},HOST_NOTIFICATIONS={"host/context-changed":r(HostContextSchema,"The language, theme or agent changed."),"editor/command":r(t.strictObject({command:t.enum(["export"])}),"The host around the editor asked it to do what its own shortcut does."),...a,...c},EDITOR_HOST_METHODS={...i,...HOST_METHODS};

package/node_modules/@allyhub-next/protocol/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./jsonrpc.js";
 export * from "./files.js";
 export * from "./editor.js";
+export * from "./notes.js";
 export * from "./tools.js";
 export * from "./cli.js";
 export * from "./auth.js";

package/node_modules/@allyhub-next/protocol/dist/index.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-export*from"./jsonrpc.js";export*from"./files.js";export*from"./editor.js";export*from"./tools.js";export*from"./cli.js";export*from"./auth.js";export*from"./registry.js";export*from"./runtimes.js";export*from"./cloud.js";export*from"./teams.js";export*from"./app.js";export*from"./routes.js";
+export*from"./jsonrpc.js";export*from"./files.js";export*from"./editor.js";export*from"./notes.js";export*from"./tools.js";export*from"./cli.js";export*from"./auth.js";export*from"./registry.js";export*from"./runtimes.js";export*from"./cloud.js";export*from"./teams.js";export*from"./app.js";export*from"./routes.js";

package/node_modules/@allyhub-next/protocol/dist/notes.d.ts

@@ -0,0 +1,163 @@
+import { z } from "zod";
+import { pointsOf, mapShape, touches, type NoteShape } from "@allyhub-next/formats";
+export declare const NoteRectSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strict>;
+export type NoteRect = z.infer<typeof NoteRectSchema>;
+/** A mark as the host tells it, px of the surface: its shape, and nothing of what is under it. */
+export declare const NoteShapeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"box">;
+    rect: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"round">;
+    rect: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"arrow">;
+    from: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>;
+    to: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"line">;
+    points: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "kind">;
+export { mapShape, pointsOf, touches };
+export type { NoteShape };
+/** Where to change something: a project's file, and its line. */
+export declare const NoteSourceSchema: z.ZodObject<{
+    path: z.ZodString;
+    line: z.ZodOptional<z.ZodInt>;
+}, z.core.$strict>;
+export type NoteSource = z.infer<typeof NoteSourceSchema>;
+export declare const FrozenSchema: z.ZodObject<{
+    key: z.ZodString;
+    what: z.ZodString;
+    source: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        line: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type Frozen = z.infer<typeof FrozenSchema>;
+export declare const NotePictureSchema: z.ZodObject<{
+    rect: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>>;
+    mime: z.ZodString;
+    data: z.ZodString;
+}, z.core.$strict>;
+export type NotePicture = z.infer<typeof NotePictureSchema>;
+export declare const NoteElementSchema: z.ZodObject<{
+    name: z.ZodString;
+    source: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        line: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    text: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type NoteElement = z.infer<typeof NoteElementSchema>;
+/**
+ * What a framed page tells the window that holds it: it answers `NOTE_METHODS`
+ * from now on, or no longer. The window asks only a page that has said so.
+ */
+export declare const NOTE_READY = "note/ready";
+export declare const NOTE_GONE = "note/gone";
+export declare const NOTE_METHODS: {
+    readonly "note/freeze": import("./jsonrpc.js").MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        key: z.ZodString;
+        what: z.ZodString;
+        source: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            line: z.ZodOptional<z.ZodInt>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "note/pictures": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        page: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        pictures: z.ZodArray<z.ZodObject<{
+            rect: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
+            mime: z.ZodString;
+            data: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "note/locate": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        mark: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"box">;
+            rect: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"round">;
+            rect: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"arrow">;
+            from: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>;
+            to: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"line">;
+            points: z.ZodArray<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>, z.ZodObject<{
+        elements: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            source: z.ZodOptional<z.ZodObject<{
+                path: z.ZodString;
+                line: z.ZodOptional<z.ZodInt>;
+            }, z.core.$strict>>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "note/thaw": import("./jsonrpc.js").MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+};
+/** What an editor gives its host for notes on it, for as long as it is on show. */
+export interface NoteSurface {
+    freeze(): Promise<Frozen>;
+    pictures?(): Promise<NotePicture[]>;
+    locate?(mark: NoteShape): Promise<NoteElement[]>;
+    thaw?(): void;
+}
+//# sourceMappingURL=notes.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/notes.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{z as t}from"zod";import{pointsOf as r,mapShape as n,touches as i}from"@allyhub-next/formats";import{PathSchema as s}from"./files.js";import{method as e}from"./jsonrpc.js";export const NoteRectSchema=t.strictObject({x:t.number(),y:t.number(),width:t.number().nonnegative(),height:t.number().nonnegative()});const o=t.strictObject({x:t.number(),y:t.number()});export const NoteShapeSchema=t.discriminatedUnion("kind",[t.strictObject({kind:t.literal("box"),rect:NoteRectSchema}),t.strictObject({kind:t.literal("round"),rect:NoteRectSchema}),t.strictObject({kind:t.literal("arrow"),from:o,to:o}),t.strictObject({kind:t.literal("line"),points:t.array(o).min(1)})]);export{n as mapShape,r as pointsOf,i as touches};export const NoteSourceSchema=t.strictObject({path:s,line:t.int().positive().optional()}),FrozenSchema=t.strictObject({key:t.string().min(1),what:t.string(),source:NoteSourceSchema.optional()}),NotePictureSchema=t.strictObject({rect:NoteRectSchema.optional(),mime:t.string().min(1),data:t.string().min(1)}),NoteElementSchema=t.strictObject({name:t.string().min(1),source:NoteSourceSchema.optional(),text:t.string().optional()}),NOTE_READY="note/ready",NOTE_GONE="note/gone",NOTE_METHODS={"note/freeze":e(t.strictObject({}),FrozenSchema,"Stops what moves and says what is on show. Answered once it is drawn, so a page still loading is not captured empty."),"note/pictures":e(t.strictObject({page:t.boolean()}),t.strictObject({pictures:t.array(NotePictureSchema)}),"What is on show drawn better than a screenshot can, or what a screenshot cannot reach: a render's frame, a frame of its own. Laid in order over the host's screenshot."),"note/locate":e(t.strictObject({mark:NoteShapeSchema}),t.strictObject({elements:t.array(NoteElementSchema)}),"What a mark is on, while frozen: the surface alone knows what it shows, and says it in its own terms, with its file and line where it knows them. Empty is an answer: the mark's place still goes."),"note/thaw":e(t.strictObject({}),t.strictObject({}),"The person is done. Nothing starts by itself: a video that was paused stays paused.")};