allyhub 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -0,0 +1,138 @@
+# Changelog
+
+Feature highlights from each AllyHub release.
+
+## 0.8.0
+
+- **Docs read like reports.** Charts drawn from numbers or a sheet, equations, diagrams, columns, footnotes, page breaks and page numbers, a cover and a page style, all kept in PDF and Word.
+- **A figure drawn by code goes in a doc.** `<Component of="…" />` places a project's component, and it follows its code.
+- **`allyhub frames` draws a doc's pages.** See how a doc prints, and how many pages it has, without rendering it.
+- **No `content/` folder.** A piece is named by its folder's path from the project's root; pieces kept under `content/` still work, their names starting with `content/`.
+- **Mark up does more.** Ticks and crosses, colours and thicknesses, a highlighter and written words.
+- **Studio shows its work.** Downloads, installs and a cloud Studio waking show their progress in one list, and the agent, its model and its approval are chosen under the message box.
+
+## 0.7.1
+
+- **Downloads that stall start again.** The tools AllyHub fetches on first use, and a project's packages, are tried again instead of hanging.
+- **A project is worked on in one place at a time.** Moving it between your computer and the cloud checks first.
+
+## 0.7.0
+
+- **Publish a website.** `allyhub site deploy`, or Publish in Studio, puts a website online at its own address, private until you make it public.
+- **Any web project is a website.** A folder with a `website.json` opens in Studio's preview, and five new skills make company sites, online stores, blogs, docs sites and pages made for search.
+- **Decks work like PowerPoint.** Editing, drawing and PowerPoint files read in are rewritten to match it.
+- **Sheets work like Excel.** Its selection and table styles, with large workbooks calculated without slowing the editor.
+- **Circle to edit in every editor.** It is the editors' main button, and Add to chat sends what you selected to the conversation.
+- **Plans, credits and paying, redesigned**, and a cloud project can be opened and shared read only without starting its computer.
+- **Change tracking is gone from the editors.**
+
+## 0.6.0
+
+- **`pptx=editable` is gone.** It wrote a picture with text boxes over it. `native`, the default, is the deck PowerPoint can edit; use it instead.
+- **Decks and sheets keep more in Office.** Gradients, shadows, more shapes, links, scatter charts, and in Excel page layout, notes, pictures, outlines and protection.
+- **Mark up for AI, everywhere.** Start it from any editor's bar or a right click, and draw on what you want changed.
+- **Studio asks in forms.** An agent's questions, and a skill's prompt, are fields to fill in rather than text to edit.
+- **Two new skills.** `explainer-videos` teaches one thing in a video, and `launch-videos` is a short film cut to music for a launch.
+
+## 0.5.0
+
+- **Sheets are workbooks.** A sheet is now Excel's model as text, with live formulas, an editor like Excel's, and `allyhub sheet calc`, `trace`, `diff` and `capabilities`.
+- **Sheets made before this version must be imported.** A folder with a `sheet.csv` is no longer a sheet, and nothing warns of it: run `allyhub sheet import <folder>/sheet.csv --to <new folder>`.
+- **A clearer `allyhub` skill.** It says what AllyHub does and links a file for each kind of work. Run `npx skills update -g` to get it.
+- **Fixes.** Videos with a 3D scenery pass `allyhub check` in an installed project, `npm install -g allyhub` works on a Mac, and a first run says what it downloads.
+- **`allyhub words` hears in the cloud.** Without the speech pack it uses a cloud model, at about half a credit a minute. `allyhub doctor --install speech` hears on this computer.
+- **`phoneCamera` grades the picture.** A part filmed with it takes a phone's contrast, colour and warmth: `sensor: { grade: null }` leaves that out.
+- **`allyhub voice --dry-run` and `allyhub reference served` are gone.** `allyhub voice` makes what is missing and bills it to your account.
+- **Work skills come from `allyhub add`.** They are no longer in the public repository: use `allyhub add skill/<name>` in place of `npx skills add`.
+
+## 0.4.0
+
+- **AllyHub comes as one skill.** Install it with `npx skills add allyhub-ai/allyhub --skill allyhub -g -y`. The plugin and `allyhub mcp` are gone: remove the plugin if you have it.
+- **A smaller install.** What only some work needs is downloaded when first used.
+- **Slides.** Write decks in code, edit them in an editor like PowerPoint's, and import and export `.pptx`.
+- **Export in every editor.** Export is in each editor's bar, and docs export to Word.
+- **Fewer commands.** `allyhub auth logout`, `auth token` and `orgs switch` are gone.
+
+## 0.3.0
+
+- **`allyhub add` takes `<type>/<name>`.** Name what you add with its type: `3d-model/monitor`, `scenery/home-desk-day`, `skill/product-demos`, `component/caption-line`, `lib/<name>`, and Poly Haven's assets as `@polyhaven/<id>`. A bare name (`allyhub add caption-line`) is refused, so update scripts and notes that used one. `allyhub add` alone lists everything AllyHub has, by type, and `allyhub add search --type <type>` lists or finds one type's.
+- **3D models are pieces.** A folder with a `model.ts` (`export default defineModel(…)`) is a 3D model of its own: made once and put in any scenery that imports it, each with its own parameters. It opens alone in `allyhub dev` and Studio, `allyhub check` builds it (one that does not build is AK-B010), and `allyhub render` writes its GLB. A scenery's own helper module must be named something other than `model.ts`.
+- **`allyhub model` is now `allyhub 3d-model`.** `allyhub 3d-model <file>` builds or measures a model, `allyhub 3d-model capabilities` lists the modelling API; `allyhub model` is gone.
+- **Ready-made 3D models.** A monitor, laptop, keyboard, tablet, desk, chair, mouse, trackpad, phone, microphone and speaker at real products' sizes: `allyhub add 3d-model/monitor`, a preset by name (`{"preset":"ultrawide34"}`) and any size or finish as parameters.
+- **`allyhub dev` runs once per project.** Run again while it runs, it opens the page that is running (on the item you name) and ends, instead of starting a second server.
+- **The MCP server says its version.** It reported `0.0.0`; it now reports the CLI's.
+
+## 0.2.0
+
+- **The CLI reads AllyHub's current cloud catalog.** `0.2.0-next.4` and earlier cannot list or call the cloud tools any more, so update to use them.
+- **Cloud tools state their price in their description.** `allyhub help <work> <tool>` and the MCP tools show each tool's price, in credits, as its supplier prices it. A call is charged once, when it works, and a failed call is free. `--quote` is gone.
+- **Every organization is a team.** `allyhub orgs list` lists your teams, the first of them made when you signed up. `allyhub orgs switch` takes a team's slug or id; `personal` is gone.
+
+## 0.1.0-alpha.10
+
+- **Studio Host for cloud sandboxes.** The Linux Host package runs Studio's page and agent inside an isolated sandbox; this release provides the package used by AllyHub's cloud Studio template.
+- **3D worlds as project items.** Write a world in TypeScript, look around it in Studio, and import it by name into a video.
+- **Screens and cameras in code.** Rebuild screens in a world, light the scene with them, and control the camera's focus, exposure and capture effects.
+- **Measured sound and pictures.** Voice recording presets, room acoustics, cut and text measurements, and repeatable GPU rendering give the agent more evidence while making a piece.
+- **Faster checks in CI.** Pull requests run tiered checks, with the full render and integration tests reserved for the release and nightly runs.
+
+## 0.1.0-alpha.9
+
+- **Research as it comes in.** While the agent researches with AllyHub's data tools, Studio's work card shows what they find as a wall of cards (posts, products, pages) that grows as results arrive and stays after the turn until you move on; a card opens its page in your browser. Research no longer saves files into the project.
+- **Notes at their marks.** Write a note's words right at its mark, as in Codex's annotations; the composer shows one Notes chip, notes work across several videos, and a video opens at 0:00.
+- **Clearer stops for AllyHub's agent.** A failed model request no longer reads as a sign-out, the out-of-credits card survives a restart, and a model your plan does not include asks for a plan instead of showing an error.
+- **Commands in a subfolder.** `allyhub check` and the other project commands run inside an item's folder now use the project around it.
+- **Footage keeps its shape.** A footage layer whose box changes shape over time crops its picture instead of stretching it.
+- **Steadier UI demos.** `uiDemo` holds a still camera between moves, lifts nothing, keeps zooms inside its box and finds each place when its step runs.
+
+## 0.1.0-alpha.8
+
+- **Projects with skills.** A project is one folder; each kind of work (Product demos, Explainers, Launch shorts, Candidate users) is a standard Agent Skill added to it with `allyhub new --skill` or `allyhub skill add`, and `allyhub find` names the one a task needs.
+- **The skill gallery.** [allyhub.com/skills](https://allyhub.com/skills/) lists AllyHub's skills, and `npx skills add https://allyhub.com` installs them from its Agent Skills index.
+- **Plans and credits in Studio.** Choose a plan or add credits in a sheet, see each day's usage, and get credits in place when a tool runs out.
+- **Studio's layout.** The conversation sits to the right of the work, and each project keeps browser tabs of its own.
+- **AllyHub's own agent.** It hands tasks to subagents and uses the ffmpeg, Chrome and npm Studio brings.
+
+## 0.1.0-alpha.7
+
+- **Comments in Codex.** Comment on the preview with Codex's own Annotate; each comment carries the moment in the video, the sheet cell or the doc's words.
+- **Codex setup in one sentence.** Ask Codex to "Read github.com/allyhub-ai/skills to install AllyHub for Codex".
+- **Lighter install.** The first `npx allyhub` downloads 120 MB instead of 262 MB; Excel support installs when first used.
+- **Queue and steer.** In Studio, Enter queues a message while the agent works, and Steer sends a queued message now.
+
+## 0.1.0-alpha.6
+
+- **Simple installation.** Run the CLI with `npx allyhub` and install its skill with `npx skills add allyhub-ai/skills -g`.
+- **Short release notes.** Each release lists a few feature highlights.
+
+## 0.1.0-alpha.5
+
+- **15 languages.** Studio and the video, doc and sheet editors are available in 15 languages.
+- **Faster startup.** Studio opens without waiting for the macOS keychain.
+- **Clearer exports.** Export messages identify what was saved, and newly created files are marked accurately.
+
+## 0.1.0-alpha.4
+
+- **Parallel projects.** Work on several projects at once, each with its own agent.
+- **Built-in browser.** Browse, sign in and watch the agent research inside Studio.
+- **New Home and composer.** Start from templates, steer work in progress and queue messages.
+- **Better docs and sheets.** Easier editing, attachment cells and review of agent changes.
+
+## 0.1.0-alpha.3
+
+- **Sign in when needed.** Studio handles agent sign-in within the conversation and keeps unsent messages.
+- **Simpler cloud tools.** Calls return their results and download generated files directly into the project.
+- **File uploads.** Use your own media with cloud generation and research tools.
+
+## 0.1.0-alpha.2
+
+- **Docs and sheets.** Create and edit MDX documents and CSV spreadsheets alongside videos and decks.
+- **Speech-led editing.** Cut recordings by their words and time captions and graphics to speech.
+- **Ad variants.** Combine hooks, demos and calls to action across languages and platform formats.
+- **Rendering and inspection.** More export formats, richer measurements and tools to examine frames and sound.
+
+## 0.1.0-alpha.1
+
+- **Videos and decks as code.** Create and render locally with your coding agent.
+- **Live preview and feedback.** Circle changes in the preview and send them to the agent.
+- **Cloud media tools.** Generate voiceover, images and video through AllyHub's tool catalog.

package/NOTICE

@@ -116,11 +116,11 @@ Subdivision uses OpenSubdiv 3.6.0, Copyright Pixar,
 https://github.com/PixarAnimationStudios/OpenSubdiv, commit
 7d0ab5530feef693ac0a920585b5c663b80773b3, under its Modified Apache 2.0
 license. The small native integration is informed by its Far tutorial 5.1.
-The compiled WASM is distributed in @allyhub-next/model's generated runtime.
+The compiled WASM is distributed in @allyhub/model's generated runtime.
 The upstream LICENSE.opensubdiv and NOTICE.opensubdiv are retained beside it,
 along with the Emscripten, LLVM libc++/libc++abi/compiler-rt and musl runtime
 license texts. The generated runtime and these notices are copied into
-@allyhub-next/model/dist/generated when building the package.
+@allyhub/model/dist/generated when building the package.
 
 ---
 

package/client.d.ts

@@ -6,6 +6,18 @@
 // (apps/create-allyhub/scripts/npm-packages.ts, which refuses to pack a
 // lent entry this file does not declare).
 
+declare module "@allyhub/scenery-host/layer" {
+  export * from "allyhub/lent/scenery-host/layer";
+}
+declare module "@allyhub/model" {
+  export * from "allyhub/lent/model";
+}
+declare module "@allyhub/model/three" {
+  export * from "allyhub/lent/model/three";
+}
+
+// The same, by the names allyhub 0.7 lent them under: a project and the
+// registry's items written then import them so.
 declare module "@allyhub-next/scenery-host/layer" {
   export * from "allyhub/lent/scenery-host/layer";
 }

package/dist/args.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{parseArgs as T}from"node:util";import{z as x}from"zod";import{EXIT as z}from"@allyhub-next/protocol";import{CommandError as E}from"./command.js";const k=s=>s._zod.def;export function shapeOf(s){let r=s,a;for(;;){const n=k(r);if((n.type==="default"||n.type==="prefault")&&(a=typeof n.defaultValue=="function"?n.defaultValue():n.defaultValue),(n.type==="optional"||n.type==="default"||n.type==="prefault"||n.type==="nullable")&&n.innerType){r=n.innerType;continue}const l=f=>{const o=k(f).type;if(o==="boolean")return"boolean";if(o==="number"||o==="int")return"number";if(o==="union"){const m=new Set((k(f).options??[]).map(l));return m.size===1?[...m][0]??"string":"string"}return"string"};return n.type==="array"&&n.element?{kind:l(n.element),list:!0,...a===void 0?{}:{fallback:a}}:{kind:l(r),list:!1,...a===void 0?{}:{fallback:a}}}}export function paramsOf(s){let r=s;for(;r;){const a=k(r);if(a.type==="object")return r.shape;r=a.innerType}}export const optionName=s=>s.replaceAll(/[A-Z]/gu,r=>`-${r.toLowerCase()}`);export function splitList(s){const r=[];let a=0,n=!1,l=0;for(let f=0;f<s.length;f++){const o=s[f];n?o==="\\"?f++:o==='"'&&(n=!1):o==='"'&&a>0?n=!0:o==="["||o==="{"?a++:(o==="]"||o==="}")&&a>0?a--:o===","&&a===0&&(r.push(s.slice(l,f)),l=f+1)}return r.push(s.slice(l)),r}const g=(s,r)=>new E("usage",s,{exit:z.usage,...r===void 0?{}:{hint:r}});function M(s,r){const a=[];for(let n=0;n<s.length;n++){const l=s[n]??"",f=s[n+1],o=l.startsWith("--")&&!l.includes("=")?l.slice(2):"";o!==""&&r(o)&&f!==void 0&&/^-\.?\d/u.test(f)?(a.push(`${l}=${f}`),n++):a.push(l)}return a}export function readArgs(s,r){const a=s.input.shape,n=Object.entries(a),l=[...s.positional??[]],f=new Map(n.map(([t,e])=>[t,shapeOf(e)])),o={},m=new Map,h=paramsOf(a.params);h&&(o.param={type:"string",multiple:!0});for(const[t]of n){if(l.includes(t)||h&&t==="params")continue;const e=f.get(t);if(!e)continue;const i=optionName(t);m.set(i,t),o[i]={type:e.kind==="boolean"&&!e.list?"boolean":"string",...e.list?{multiple:!0}:{}},e.kind==="boolean"&&!e.list&&(o[`no-${i}`]={type:"boolean"})}let $;try{$=T({args:M(r,t=>o[t]?.type==="string"),options:o,allowPositionals:!0,strict:!0})}catch(t){const e=[...m.keys()].map(i=>`--${i}`).join(", ");throw g(t.message,e?`${s.name} takes ${e}.`:`${s.name} takes no options.`)}const d={},y=(t,e)=>{if(f.get(t)?.kind!=="number")return e;const p=Number(e);if(e.trim()===""||!Number.isFinite(p))throw g(`--${optionName(t)} is a number, not "${e}".`);return p};if(h){const t={};for(const e of $.values.param??[]){const i=e.indexOf("="),p=i<0?e:e.slice(0,i),u=Object.keys(h).find(c=>optionName(c)===p||c===p);if(u===void 0||i<0)throw g(i<0?`--param ${e}: write it as name=value.`:`--param: ${s.name} has no parameter "${p}".`,`Its parameters: ${Object.keys(h).map(optionName).join(", ")}.`);const w=e.slice(i+1),{kind:O,list:A}=shapeOf(h[u]??x.string()),v=c=>{if(O==="number"){const N=Number(c);if(c.trim()===""||!Number.isFinite(N))throw g(`--param ${p} is a number, not "${c}".`);return N}return O==="boolean"?c==="true"||c==="1"||c==="yes":c};t[u]=A?splitList(w).filter(c=>c!=="").map(v):v(w)}d.params=t}for(const[t,e]of Object.entries($.values)){if(t==="param"&&h)continue;if(t.startsWith("no-")&&m.has(t.slice(3))){const u=m.get(t.slice(3))??"";e===!0&&(d[u]=!1);continue}const i=m.get(t);if(i===void 0)continue;const p=f.get(i);Array.isArray(e)?d[i]=e.flatMap(u=>splitList(String(u))).filter(u=>u!=="").map(u=>y(i,u)):typeof e=="boolean"?d[i]=e:typeof e=="string"&&(d[i]=p?.list?splitList(e).map(u=>y(i,u)):y(i,e))}const b=[...$.positionals];if(l.forEach((t,e)=>{const i=f.get(t),p=e===l.length-1;if(i?.list&&p){b.length>0&&(d[t]=b.splice(0).map(w=>y(t,w)));return}const u=b.shift();u!==void 0&&(d[t]=y(t,u))}),b.length>0)throw g(`${s.name} does not take "${b.join(" ")}".`);const j=s.input.safeParse(d);if(!j.success){const t=j.error.issues[0],e=String(t?.path[0]??""),i=l.includes(e)?`<${e}>`:e?`--${optionName(e)}`:s.name;throw g(`${i}: ${t?.message??"not valid"}.`)}return j.data}
+import{parseArgs as T}from"node:util";import{z as x}from"zod";import{EXIT as z}from"@allyhub/protocol";import{CommandError as E}from"./command.js";const k=s=>s._zod.def;export function shapeOf(s){let r=s,a;for(;;){const n=k(r);if((n.type==="default"||n.type==="prefault")&&(a=typeof n.defaultValue=="function"?n.defaultValue():n.defaultValue),(n.type==="optional"||n.type==="default"||n.type==="prefault"||n.type==="nullable")&&n.innerType){r=n.innerType;continue}const l=f=>{const o=k(f).type;if(o==="boolean")return"boolean";if(o==="number"||o==="int")return"number";if(o==="union"){const m=new Set((k(f).options??[]).map(l));return m.size===1?[...m][0]??"string":"string"}return"string"};return n.type==="array"&&n.element?{kind:l(n.element),list:!0,...a===void 0?{}:{fallback:a}}:{kind:l(r),list:!1,...a===void 0?{}:{fallback:a}}}}export function paramsOf(s){let r=s;for(;r;){const a=k(r);if(a.type==="object")return r.shape;r=a.innerType}}export const optionName=s=>s.replaceAll(/[A-Z]/gu,r=>`-${r.toLowerCase()}`);export function splitList(s){const r=[];let a=0,n=!1,l=0;for(let f=0;f<s.length;f++){const o=s[f];n?o==="\\"?f++:o==='"'&&(n=!1):o==='"'&&a>0?n=!0:o==="["||o==="{"?a++:(o==="]"||o==="}")&&a>0?a--:o===","&&a===0&&(r.push(s.slice(l,f)),l=f+1)}return r.push(s.slice(l)),r}const g=(s,r)=>new E("usage",s,{exit:z.usage,...r===void 0?{}:{hint:r}});function M(s,r){const a=[];for(let n=0;n<s.length;n++){const l=s[n]??"",f=s[n+1],o=l.startsWith("--")&&!l.includes("=")?l.slice(2):"";o!==""&&r(o)&&f!==void 0&&/^-\.?\d/u.test(f)?(a.push(`${l}=${f}`),n++):a.push(l)}return a}export function readArgs(s,r){const a=s.input.shape,n=Object.entries(a),l=[...s.positional??[]],f=new Map(n.map(([t,e])=>[t,shapeOf(e)])),o={},m=new Map,h=paramsOf(a.params);h&&(o.param={type:"string",multiple:!0});for(const[t]of n){if(l.includes(t)||h&&t==="params")continue;const e=f.get(t);if(!e)continue;const i=optionName(t);m.set(i,t),o[i]={type:e.kind==="boolean"&&!e.list?"boolean":"string",...e.list?{multiple:!0}:{}},e.kind==="boolean"&&!e.list&&(o[`no-${i}`]={type:"boolean"})}let $;try{$=T({args:M(r,t=>o[t]?.type==="string"),options:o,allowPositionals:!0,strict:!0})}catch(t){const e=[...m.keys()].map(i=>`--${i}`).join(", ");throw g(t.message,e?`${s.name} takes ${e}.`:`${s.name} takes no options.`)}const d={},y=(t,e)=>{if(f.get(t)?.kind!=="number")return e;const p=Number(e);if(e.trim()===""||!Number.isFinite(p))throw g(`--${optionName(t)} is a number, not "${e}".`);return p};if(h){const t={};for(const e of $.values.param??[]){const i=e.indexOf("="),p=i<0?e:e.slice(0,i),u=Object.keys(h).find(c=>optionName(c)===p||c===p);if(u===void 0||i<0)throw g(i<0?`--param ${e}: write it as name=value.`:`--param: ${s.name} has no parameter "${p}".`,`Its parameters: ${Object.keys(h).map(optionName).join(", ")}.`);const w=e.slice(i+1),{kind:O,list:A}=shapeOf(h[u]??x.string()),v=c=>{if(O==="number"){const N=Number(c);if(c.trim()===""||!Number.isFinite(N))throw g(`--param ${p} is a number, not "${c}".`);return N}return O==="boolean"?c==="true"||c==="1"||c==="yes":c};t[u]=A?splitList(w).filter(c=>c!=="").map(v):v(w)}d.params=t}for(const[t,e]of Object.entries($.values)){if(t==="param"&&h)continue;if(t.startsWith("no-")&&m.has(t.slice(3))){const u=m.get(t.slice(3))??"";e===!0&&(d[u]=!1);continue}const i=m.get(t);if(i===void 0)continue;const p=f.get(i);Array.isArray(e)?d[i]=e.flatMap(u=>splitList(String(u))).filter(u=>u!=="").map(u=>y(i,u)):typeof e=="boolean"?d[i]=e:typeof e=="string"&&(d[i]=p?.list?splitList(e).map(u=>y(i,u)):y(i,e))}const b=[...$.positionals];if(l.forEach((t,e)=>{const i=f.get(t),p=e===l.length-1;if(i?.list&&p){b.length>0&&(d[t]=b.splice(0).map(w=>y(t,w)));return}const u=b.shift();u!==void 0&&(d[t]=y(t,u))}),b.length>0)throw g(`${s.name} does not take "${b.join(" ")}".`);const j=s.input.safeParse(d);if(!j.success){const t=j.error.issues[0],e=String(t?.path[0]??""),i=l.includes(e)?`<${e}>`:e?`--${optionName(e)}`:s.name;throw g(`${i}: ${t?.message??"not valid"}.`)}return j.data}

package/dist/audio-text.js

@@ -1,5 +1,5 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{isAbsolute as U,relative as T}from"node:path";import{VOICE_FIT_DEFAULTS as E}from"@allyhub-next/audio";import{comboKey as S}from"@allyhub-next/video-core";const c=(e,t=1)=>e==null?"–":e.toFixed(t),p=(e,t=1)=>`${e>=0?"+":"−"}${Math.abs(e).toFixed(t)}`,b=(e,t)=>`${String(e)} ${t}${e===1?"":"s"}`;function x(e,t){const o=T(t,e);return o&&!o.startsWith("..")&&!U(o)?o:e}const P=e=>[...e].sort((t,o)=>o.strength-t.strength).slice(0,12).sort((t,o)=>t.t-o.t),g=e=>`${e.p10.toFixed(1)} / ${e.median.toFixed(1)} / ${e.p90.toFixed(1)}`,w=e=>e?`${e.bpm.toFixed(1)} BPM (confidence ${e.confidence.toFixed(2)})`:"no steady tempo";function v(e){const t=e.loudness,o=P(e.onsets);return[`Loudness  ${c(t.integrated)} LUFS integrated · range ${c(t.range)} LU · true peak ${c(t.truePeak)} dBTP · sample peak ${c(t.samplePeak)} dBFS${e.clipped>0?` · ${b(e.clipped,"sample")} at full scale`:""}`,`Silence   under ${String(e.options.silence.noise)} dBFS for ${String(e.options.silence.min)} s or longer: ${e.silences.length===0?"none":e.silences.map(i=>`${i.start.toFixed(2)}–${i.end.toFixed(2)} s (${i.duration.toFixed(2)} s${i.part?`, ${i.part}`:""})`).join(" · ")}`,`Onsets    ${String(e.onsets.length)}${o.length>0?`; strongest at ${o.map(i=>i.t.toFixed(2)).join(" ")} s (all in --json)`:""}`]}export function fileAudioText(e,t){return[`${x(e.source.file,t)} · ${e.duration.toFixed(2)} s · measured alone, on its own clock`,...v(e),`Pace      ${w(e.pace.tempo)} · ${e.pace.onsetsPerMinute.toFixed(1)} onsets a minute`,`Levels    dBFS every 10 ms, 10th / median / 90th: whole ${g(e.sound.whole)} · floor ${e.sound.floor.toFixed(1)}`].join(`
+import{isAbsolute as U,relative as T}from"node:path";import{VOICE_FIT_DEFAULTS as E}from"@allyhub/audio";import{comboKey as S}from"@allyhub/video-core";const c=(e,t=1)=>e==null?"–":e.toFixed(t),p=(e,t=1)=>`${e>=0?"+":"−"}${Math.abs(e).toFixed(t)}`,b=(e,t)=>`${String(e)} ${t}${e===1?"":"s"}`;function x(e,t){const o=T(t,e);return o&&!o.startsWith("..")&&!U(o)?o:e}const P=e=>[...e].sort((t,o)=>o.strength-t.strength).slice(0,12).sort((t,o)=>t.t-o.t),g=e=>`${e.p10.toFixed(1)} / ${e.median.toFixed(1)} / ${e.p90.toFixed(1)}`,w=e=>e?`${e.bpm.toFixed(1)} BPM (confidence ${e.confidence.toFixed(2)})`:"no steady tempo";function v(e){const t=e.loudness,o=P(e.onsets);return[`Loudness  ${c(t.integrated)} LUFS integrated · range ${c(t.range)} LU · true peak ${c(t.truePeak)} dBTP · sample peak ${c(t.samplePeak)} dBFS${e.clipped>0?` · ${b(e.clipped,"sample")} at full scale`:""}`,`Silence   under ${String(e.options.silence.noise)} dBFS for ${String(e.options.silence.min)} s or longer: ${e.silences.length===0?"none":e.silences.map(i=>`${i.start.toFixed(2)}–${i.end.toFixed(2)} s (${i.duration.toFixed(2)} s${i.part?`, ${i.part}`:""})`).join(" · ")}`,`Onsets    ${String(e.onsets.length)}${o.length>0?`; strongest at ${o.map(i=>i.t.toFixed(2)).join(" ")} s (all in --json)`:""}`]}export function fileAudioText(e,t){return[`${x(e.source.file,t)} · ${e.duration.toFixed(2)} s · measured alone, on its own clock`,...v(e),`Pace      ${w(e.pace.tempo)} · ${e.pace.onsetsPerMinute.toFixed(1)} onsets a minute`,`Levels    dBFS every 10 ms, 10th / median / 90th: whole ${g(e.sound.whole)} · floor ${e.sound.floor.toFixed(1)}`].join(`
 `)}function O(e){return e===null?"":"█".repeat(Math.round(Math.min(-6,Math.max(-36,e))+36))}const y=e=>e?[e.pitch===void 0?void 0:`${p(e.pitch)} st`,e.pace===void 0?void 0:`${p(e.pace*100,0)} %`,e.bright===void 0?void 0:`${p(e.bright)} dB`].filter(t=>t!==void 0).join("  "):"",k=e=>e.pitch?`${e.pitch.median.toFixed(0).padStart(4)} Hz (${e.pitch.low.toFixed(0)}–${e.pitch.high.toFixed(0)})`:"   – Hz";export function versionAudioText(e,t,o){const i=t.master,s=[`${[e.piece,S(e.combo),e.format].join(" · ")} · ${t.duration.toFixed(2)} s · ${t.source.kind==="file"?`measured ${x(t.source.file,o)}`:"mixed now from its sources (no render)"}`,...v(t)];i&&s.splice(2,0,`Master    ${i.target.lufs===!1?"the mix's own level":`${String(i.target.lufs)} LUFS`}, ceiling ${String(i.target.truePeak)} dBTP: ${i.gainDb===void 0?"silent":`gain ${p(i.gainDb,2)} dB`}${i.before?` on ${i.before.integrated.toFixed(1)} LUFS, range ${c(i.before.range)} LU, true peak ${c(i.before.truePeak)} dBTP`:""}${i.limited===void 0?"":` · the limiter took ${i.limited.toFixed(1)} dB off the loudest peak${i.limitedAt===void 0?"":`, at ${i.limitedAt.toFixed(2)} s`}`}`);const a=t.pace;s.push(`Pace      ${w(a.tempo)} · ${a.onsetsPerMinute.toFixed(1)} onsets a minute · ${a.wordsPerMinute.toFixed(1)} words a minute (${a.speakingRate.toFixed(1)} from the first word to the last) · speech ${(a.speechShare*100).toFixed(0)} % of the film${a.timeToFirstWord===null?"":` · first word at ${a.timeToFirstWord.toFixed(2)} s`}`);const r=t.sound;s.push(`Levels    dBFS every 10 ms, 10th / median / 90th: whole ${g(r.whole)}${r.words?` · under words ${g(r.words)}`:""}${r.between?` · between them ${g(r.between)} (${r.between.seconds.toFixed(1)} s, ${(r.between.voicedShare*100).toFixed(0)} % voiced, ${r.between.onsetsPerMinute.toFixed(1)} onsets a minute)`:""} · floor ${r.floor.toFixed(1)}${t.bedUnderVoice===null?"":` · words over between ${t.bedUnderVoice.toFixed(1)} dB`}`),t.stems.length>0&&s.push(`Stems     ${t.stems.map(n=>`${n.as} ${n.file} ${c(n.lufs)} LUFS${n.by==="level"?" (level over its length)":""}`).join(" · ")}`);const $=t.summary,f=n=>n.onset===void 0||n.offsetMs===void 0?"no onset":`onset ${n.onset.toFixed(2)} (${n.offsetMs>=0?"+":""}${String(n.offsetMs)} ms)${n.near?"  ✓":""}`,l=Math.max(4,...t.cuts.map(n=>n.part.length),...t.cues.map(n=>n.sound.length));s.push(`Cuts      ${String($.cutsOnOnset)} of ${String($.cuts)} within ±${String($.toleranceMs)} ms of an onset`);for(const n of t.cuts)s.push(`  ${n.t.toFixed(2).padStart(6)} ${n.part.padEnd(l)}  ${f(n)}`);if($.cues>0){s.push(`Cues      ${String($.cuesOnOnset)} of ${String($.cues)} within ±${String($.toleranceMs)} ms of an onset`);for(const n of t.cues)s.push(`  ${n.t.toFixed(2).padStart(6)} ${n.sound.padEnd(l)}  ${f(n)}  (${n.part})`)}const m=Math.max(4,...t.parts.map(n=>n.key.length));s.push("Parts     momentary loudness, mean / max LUFS");for(const n of t.parts)s.push(`  ${n.key.padEnd(m)} ${n.start.toFixed(2).padStart(6)}–${n.end.toFixed(2).padEnd(6)} ${c(n.loudness).padStart(5)} / ${c(n.peak).padStart(5)}  ${O(n.loudness)}`);if(t.speech.length>0){const n=Math.max(4,...t.speech.map(d=>d.part.length));s.push(`Speech    where each part speaks, mean LUFS; integrated LUFS before the recording and ${t.source.kind==="file"?"in the file":"in the mix"}; silences inside`);for(const d of t.speech){const u=d.levels.gainDb===void 0?"":` (speechGainDb ${p(d.levels.gainDb)})`;s.push(`  ${d.part.padEnd(n)} ${d.start.toFixed(2).padStart(6)}–${d.end.toFixed(2).padEnd(6)} ${c(d.loudness).padStart(5)}  ${c(d.levels.before).padStart(5)} → ${c(d.levels.after).padStart(5)}${u}  ${d.gaps.length===0?"continuous":b(d.gaps.length,"gap")}  ${d.file} @ ${d.from.toFixed(2)} s`)}t.speechSpread.before!==null&&t.speechSpread.after!==null&&s.push(`  the parts' spread: ${t.speechSpread.before.toFixed(1)} LU before the recording, ${t.speechSpread.after.toFixed(1)} LU ${t.source.kind==="file"?"in the file":"in the mix"}`),s.push(`Voice     each part's from its own file: median pitch (10–90 %), words a second, energy above ${String(t.options.voice.bright)} Hz; the step from the part before`);for(const d of t.speech){const u=d.voice;if(!u){s.push(`  ${d.part.padEnd(n)} –  (its file could not be read)`);continue}const h=y(d.step);s.push(`  ${d.part.padEnd(n)} ${k(u).padEnd(22)} ${c(u.pace,2).padStart(5)} /s  ${c(u.bright).padStart(6)} dB${h?`    ${h}`:""}`)}if(t.speech.some(d=>d.fileVoice!==void 0)){s.push(`File      the file's sound where each part speaks (what is under the voice counts too): median pitch (10–90 %), energy above ${String(t.options.voice.bright)} Hz; the file's less the video's`);for(const d of t.speech){const u=d.fileVoice;if(!u){s.push(`  ${d.part.padEnd(n)} –`);continue}const h=y(d.fileStep);s.push(`  ${d.part.padEnd(n)} ${k(u).padEnd(22)} ${c(u.bright).padStart(6)} dB${h?`    ${h}`:""}`)}}}for(const n of t.notes)s.push(`! ${n}`);return s.join(`
 `)}const L=[63,125,250,500,1e3,2e3,4e3,8e3,16e3],j=e=>e>=1e3?`${String(e/1e3)}k`:String(e);function B(e){const t=e.decay,o=e.tone;return[`speech ${e.speech.toFixed(1)} s, pauses ${e.pauses.toFixed(1)} s`,"t60"in t?`decay ${t.t60.toFixed(2)} s (${t.low.toFixed(2)}–${t.high.toFixed(2)}, ${String(t.ends)} ends)`:`decay – (${t.missing})`,"below"in o?`room tone ${o.below.toFixed(1)} LU under, tilt ${p(o.tilt)} dB/oct`:`room tone – (${o.missing})`,`spread ${e.dynamics.spread.toFixed(1)} LU, crest ${e.dynamics.crest.toFixed(1)} dB`].join(" · ")}const F=e=>L.map(t=>{const o=e.find(i=>i.hz===t);return(o?p(o.db):"–").padStart(6)}).join("");export function versionRecordingText(e,t){return[[e.piece,S(e.combo),e.format].join(" · "),...M(t)].join(`
 `)}export function fileRecordingText(e,t,o){return[`${x(e,o)} · measured alone, whole`,...M({file:t})].join(`

package/dist/cloud-hearing.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{callTool as s,uploadFiles as u}from"@allyhub-next/cloud";import{cloudOf as c}from"./commands/cloud.js";const t="transcribe-elevenlabs-scribe-v2";export const cloudHearing=(e,i)=>async(l,o)=>{const a=c(e),[n]=await u(a,[l],{base:i});if(!n?.ok)throw n?.error??new Error(`${l} did not upload.`);const d=await s(a,t,{audioUrl:n.url,diarize:!1,...o.lang===void 0?{}:{language:o.lang.split("-")[0]}},{outDir:i,base:i,...o.signal?{signal:o.signal}:{}});if(!("output"in d))throw new Error(`${t} did not finish.`);const r=d.output;return{model:typeof r.model=="string"?r.model:t,words:Array.isArray(r.words)?r.words:[]}};
+import{callTool as s,uploadFiles as u}from"@allyhub/cloud";import{cloudOf as c}from"./commands/cloud.js";const t="transcribe-elevenlabs-scribe-v2";export const cloudHearing=(e,i)=>async(l,o)=>{const a=c(e),[n]=await u(a,[l],{base:i});if(!n?.ok)throw n?.error??new Error(`${l} did not upload.`);const d=await s(a,t,{audioUrl:n.url,diarize:!1,...o.lang===void 0?{}:{language:o.lang.split("-")[0]}},{outDir:i,base:i,...o.signal?{signal:o.signal}:{}});if(!("output"in d))throw new Error(`${t} did not finish.`);const r=d.output;return{model:typeof r.model=="string"?r.model:t,words:Array.isArray(r.words)?r.words:[]}};

package/dist/command.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{EXIT as d,command as i}from"@allyhub-next/protocol";export function defineCommand(n,r){return{spec:i(n),run:r}}export class CommandError extends Error{code;hint;exit;constructor(r,t,e={}){super(t,e.cause===void 0?void 0:{cause:e.cause}),this.name="CommandError",this.code=r,this.hint=e.hint,this.exit=e.exit??d.failed}}
+import{EXIT as d,command as i}from"@allyhub/protocol";export function defineCommand(n,r){return{spec:i(n),run:r}}export class CommandError extends Error{code;hint;exit;constructor(r,t,e={}){super(t,e.cause===void 0?void 0:{cause:e.cause}),this.name="CommandError",this.code=r,this.hint=e.hint,this.exit=e.exit??d.failed}}

package/dist/commands/add.js

@@ -1,6 +1,6 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readFile as Y}from"node:fs/promises";import{join as A,posix as B,relative as V}from"node:path";import{fileURLToPath as W}from"node:url";import{z as p}from"zod";import{modelInfo as q}from"@allyhub-next/build";import{COMPONENTS_DIR as I}from"@allyhub-next/formats";import{EXIT as f}from"@allyhub-next/protocol";import{ASSET_DEFAULTS as G,ASSET_TYPES as K,PolyHaven as X,PolyHavenError as Z,RegistryError as J,applyAdd as T,fetchBakes as Q,folderRegistry as D,planAdd as L,searchIndex as O}from"@allyhub-next/registry";import{cacheHome as ee}from"@allyhub-next/runtimes";import{CLI_VERSION as te}from"../cli-version.js";import{CommandError as S,defineCommand as C}from"../command.js";import{projectRoot as ne}from"../project.js";import{dir as oe}from"../fields.js";import{resourcesIndex as R}from"../resources.js";const _=W(new URL(".",import.meta.resolve("@allyhub-next/components/registry.json"))),se=Object.keys(K),x=["component","3d-model","scenery","skill","template","lib","@polyhaven"],ae={"allyhub:component":"component","allyhub:model":"3d-model","allyhub:scenery":"scenery","allyhub:skill":"skill","allyhub:template":"template","allyhub:lib":"lib"},H=e=>ae[e]??e.replace(/^allyhub:/u,""),E=e=>`${H(e.type)}/${e.name}`;function ie(e){const n=/^(@?[a-z0-9-]+)\/(.+)$/u.exec(e),i=x.find(d=>d===n?.[1]);if(i===void 0||n?.[2]===void 0)throw new S("usage",n===null?`Name what to add as <type>/<name>: ${e} has no type.`:`${n[1]??""} is not a type: name what to add as <type>/<name>.`,{exit:f.usage,hint:`Types: ${x.join(", ")} (3d-model/monitor, scenery/home-desk-demo-day, skill/web-product-demos, component/caption-line, @polyhaven/<id>). allyhub add lists every one.`});return{type:i,name:n[2]}}const le={"allyhub:model":"3D models","allyhub:scenery":"3D sceneries","allyhub:skill":"Skills","allyhub:template":"Templates","allyhub:component":"Components","allyhub:lib":"Libs (added with what uses them)"};function F(e,n){if(e.from==="none")return["AllyHub's resources (models, sceneries) could not be read: check the connection."];const i=n??e.index?.items??[],d=Math.max(0,...i.map(s=>E(s).length)),r=[`AllyHub's resources (allyhub add <type>/<name> copies one with what it needs, its Poly Haven assets and its baked light)${e.from==="stale"?", as last read (the registry cannot be read now)":""}:`];for(const[s,h]of Object.entries(le)){const c=i.filter(u=>u.type===s);c.length!==0&&r.push(`  ${h}:`,...c.map(u=>`    ${E(u).padEnd(d)}  ${u.description}`))}return r}const N=20,z=e=>e.replace(/\.(?:ts|js)$/u,"").replaceAll(/[A-Z]/gu,n=>`-${n.toLowerCase()}`).replace(/^-/u,"");function M(e){return e instanceof J?new S(e.code,e.message,{exit:e.code==="conflict"?f.conflict:e.code==="no-item"?f.notFound:f.failed,...e.hint===void 0?{}:{hint:e.hint}}):e instanceof Z?new S(e.code,e.message,{exit:e.code==="network"?f.platform:e.code==="not-found"?f.notFound:e.code==="bad-choice"?f.usage:f.failed,...e.hint===void 0?{}:{hint:e.hint}}):e}const P=e=>new X({userAgent:`AllyHub/${te} (+https://allyhub.com)`,cacheDir:A(ee(e.env),"polyhaven"),...e.env.ALLYHUB_POLYHAVEN_API?{api:e.env.ALLYHUB_POLYHAVEN_API}:{}}),k=e=>`${e.toFixed(3)} m`;function de(e){const n=[e.type,e.category,e.size?`${k(e.size.width)} wide, ${k(e.size.depth)} deep, ${k(e.size.height)} tall`:void 0,e.covers?`one tile covers ${e.covers.map(k).join(" × ")}`:void 0,e.polycount!==void 0?`${e.polycount.toLocaleString("en")} polygons`:void 0,e.maxResolution?`up to ${String(e.maxResolution[0])} px`:void 0,e.authors.length>0?`by ${e.authors.join(", ")}`:void 0].filter(i=>i!==void 0);return`  @polyhaven/${e.id}: ${e.name} (${n.join("; ")})
-    found in ${e.matchedIn.join(", ")||"everything"}; tags ${e.tags.join(", ")}`}async function U(e,n){const i=[`${n.name} from Poly Haven (CC0, by ${n.source.authors.join(", ")||"its authors"}): ${String(n.files.length)} files in ${n.dir}/, ${n.fetched>0?`${String(n.fetched)} fetched`:"all already there"}. Records: ${n.records.join(", ")}.`];if(n.type==="model"){const r=n.main[0]??"",s=await q(e,r,await Y(A(e,r))),h=s.bounds;return i.push(h?`Measured: ${h.size.map(c=>c.toFixed(3)).join(" × ")} m along x, y (up), z; from ${h.min.map(c=>c.toFixed(3)).join(", ")} to ${h.max.map(c=>c.toFixed(3)).join(", ")}.`:`Not measured: ${s.contentsMissing??"no contents"}.`,...s.missing.length>0?[`Missing: ${s.missing.join(", ")}.`]:[],`In a scenery: const m = await w.load("${r}");`),{lines:i,model:s}}if(n.type==="hdri")return i.push(`In a scenery: await w.environment("${n.main[0]??""}", { background: true });`),{lines:i};const d=n.covers;return i.push(d&&d.length>=2?`One tile covers ${k(d[0]??0)} × ${k(d[1]??0)} (Poly Haven's dimensions): a surface's repeat is its size over that.`:"Poly Haven gives no size for one tile.",...n.main.map((r,s)=>{const h=n.maps?.[s]??"";return`  ${h}: await w.texture("${r}"${h==="diffuse"?"":', { colorSpace: "linear" }'})`})),{lines:i}}export const add=C({name:"add",summary:"Adds to the project what AllyHub and Poly Haven have, each named <type>/<name>: a starter component, a 3D model, a 3D scenery, a skill or a template from AllyHub's registry, or a CC0 model, HDRI or texture from Poly Haven; alone it lists everything AllyHub has, by type",input:p.strictObject({name:p.array(p.string()).optional().describe("What to add, each <type>/<name>: component/caption-line, 3d-model/monitor, scenery/home-desk-demo-day, skill/web-product-demos (a skill goes in .agents/skills, linked from .claude/skills), template/<name>, lib/<name>, or @polyhaven/<id> (as allyhub add search prints it)"),to:p.string().optional().describe(`The folder the files go in, from the project (default ${I} for a component; for an asset, its kind's folder under assets/media/ and its id)`),force:p.boolean().default(!1).describe("Replace a component's copy the project changed (its changes are lost)"),res:p.string().optional().describe(`An asset's resolution, of its textures or of the HDRI (default ${G.resolution})`),dir:oe}),positional:["name"],output:p.looseObject({}),examples:["allyhub add","allyhub add component/caption-line","allyhub add 3d-model/monitor scenery/home-desk-demo-day","allyhub add @polyhaven/metal_office_desk --res 2k"]},async(e,n)=>{const i=D(_);try{const d=await i.index();if(!e.name||e.name.length===0){const t=Math.max(...d.items.map(y=>`component/${y.name}`.length)),l=await R(n);return{value:{components:d.items,resources:l.index?.items??[]},text:["Starter components (allyhub add component/<name> copies one into components/; allyhub add search <words> finds among everything, Poly Haven's models, HDRIs and textures too):",...d.items.map(y=>`  ${`component/${y.name}`.padEnd(t)}  ${y.description}`),"",...F(l,void 0)].join(`
-`)}}const r=e.name.map(ie),s=await ne(n.cwd,e.dir),h=new Set(d.items.map(t=>t.name)),c=t=>t.type==="component"&&h.has(z(t.name)),u=r.filter(c).map(t=>z(t.name)),v=r.filter(t=>t.type==="@polyhaven").map(t=>t.name),g=r.filter(t=>t.type!=="@polyhaven"&&!c(t)),b=g.length>0?await R(n):void 0;for(const t of g){const l=b?.index?.items.find(y=>y.name===t.name);if(!l)throw new S("no-item",`There is no ${t.type}/${t.name}.`,{exit:f.notFound,hint:b?.from==="none"?"AllyHub's registry could not be read: check the connection.":`allyhub add search --type ${t.type} lists them.`});if(H(l.type)!==t.type)throw new S("usage",`${t.name} is a ${H(l.type)}, not a ${t.type}.`,{exit:f.usage,hint:`allyhub add ${E(l)}`})}const w=g.map(t=>t.name),a=[],j={};if(u.length>0){const t=e.to??I,l=await L(i,u,{root:s,dir:t,force:e.force});await T(s,l);const y=m=>m==="up to date"?"Up to date":m==="added"?"Added":"Replaced";a.push(...l.files.map(m=>`${y(m.status)} ${m.path}`));const $=l.items.find(m=>m.name===u[0]),o=$?.files[0]?.target.replaceAll("{dir}",t);if($&&o){const m=V(A(s,"name"),A(s,o)).split("\\").join("/").replace(/\.ts$/u,".js");a.push(`Import it from an item's entry file (<name>/video.ts): import { ${$.title} } from "${m.startsWith(".")?m:`./${m}`}"; one "../" more for each folder the item is deeper.`,"The file is the project's: change it as you like. allyhub add component/<name> --force puts the registry's back.")}l.missing.length>0&&a.push(`It needs packages the project does not declare: ${l.missing.join(", ")}.`),j.components=l.files.map(m=>({item:m.item,path:m.path,status:m.status})),j.missing=l.missing}if(b&&w.length>0){const t=await L(b.source,w,{root:s,dir:".",force:e.force});await T(s,t),a.length>0&&a.push(""),a.push(...t.files.map(o=>`${o.status==="up to date"?"Up to date":o.status==="added"?"Added":"Replaced"} ${o.path}`));const l=P(n);for(const o of t.assets){const m=await l.add(o.id,{root:s,...o.resolution===void 0?{}:{resolution:o.resolution},...o.maps===void 0?{}:{maps:o.maps}});a.push(...(await U(s,m)).lines)}const y=await Q(s,t.bakes);a.push(...y.map(o=>`${o.status==="added"?"Downloaded":"Up to date"} the baked light for ${o.bake.scenery}: ${o.path}`),"The files are the project's: change them as you like (a changed scenery is drawn unbaked until allyhub scenery bake bakes it again). allyhub add <type>/<name> --force puts the registry's back.");const $=t.files.filter(o=>o.path.endsWith("/README.md"));$.length>0&&a.push(`Read first, for its screens and cameras: ${$.map(o=>o.path).join(", ")}`),j.resources={files:t.files.map(o=>({item:o.item,path:o.path,status:o.status})),assets:t.assets,bakes:y.map(o=>({path:o.path,status:o.status}))}}if(v.length>0){const t=P(n),l=[];for(const y of v){const $=await t.add(y,{root:s,...e.to===void 0||u.length>0?{}:{to:B.normalize(e.to)},...e.res===void 0?{}:{resolution:e.res}}),o=await U(s,$);a.length>0&&a.push(""),a.push(...o.lines),l.push({...$,...o.model===void 0?{}:{model:o.model}})}j.assets=l}return{value:j,text:a.join(`
-`)}}catch(d){throw M(d)}}),addSearch=C({name:"add search",summary:"Finds the starter components, AllyHub's resources (models, sceneries) and Poly Haven's CC0 models, HDRIs and textures whose names, tags, categories or descriptions hold every word, each with where its words were found; with no words, lists every one",input:p.strictObject({words:p.array(p.string()).default([]).describe("The words to find (a word may start one of theirs); none lists every one"),type:p.array(p.enum(x)).optional().describe(`Only these types (default all): ${x.join(", ")} (@polyhaven: Poly Haven's models, HDRIs and textures)`),all:p.boolean().default(!1).describe(`Every match, not only the first ${String(N)} Poly Haven assets`)}),positional:["words"],output:p.looseObject({}),examples:["allyhub add search --type 3d-model",'allyhub add search "office desk" --type @polyhaven',"allyhub add search caption --type component"]},async(e,n)=>{const i=e.words.join(" ").trim(),d=i===""?"":` hold "${i}"`;try{const r=e.type??x,s=r.includes("component")?O(await D(_).index(),i):[],h=r.filter(a=>a!=="@polyhaven"),c=h.length>0?await R(n):void 0,u=c?.index?O(c.index,i).filter(a=>h.includes(H(a.type))):[],v=r.includes("@polyhaven")?se:[],{found:g,total:b}=v.length>0?await P(n).search(i,v):{found:[],total:0},w=e.all?g:g.slice(0,N);return{value:{query:i,components:s,resources:u,assets:{total:b,matches:g.length,found:w}},text:[...r.includes("component")?[`Starter components: ${String(s.length)}${d}.`,...s.map(a=>`  component/${a.name} (${a.title}): ${a.description}`)]:[],...c?c.from==="none"?F(c,[]):[`AllyHub's resources: ${String(u.length)}${d}${c.from==="stale"?" (as last read)":""}.`,...u.map(a=>`  ${E(a)} (${a.title}): ${a.description}`)]:[],...v.length>0?[`From Poly Haven (CC0): ${String(g.length)} of ${String(b)} assets${d}${w.length<g.length?`; the first ${String(w.length)} (--all for every one)`:""}.`,...w.map(de)]:[],"","Add one: allyhub add <type>/<name>"].join(`
+import{readFile as Y}from"node:fs/promises";import{join as x,posix as B,relative as V}from"node:path";import{fileURLToPath as W}from"node:url";import{z as p}from"zod";import{modelInfo as q}from"@allyhub/build";import{COMPONENTS_DIR as I}from"@allyhub/formats";import{EXIT as f}from"@allyhub/protocol";import{ASSET_DEFAULTS as G,ASSET_TYPES as K,PolyHaven as X,PolyHavenError as Z,RegistryError as J,applyAdd as T,fetchBakes as Q,folderRegistry as D,planAdd as L,searchIndex as O}from"@allyhub/registry";import{cacheHome as ee}from"@allyhub/runtimes";import{CLI_VERSION as te}from"../cli-version.js";import{CommandError as S,defineCommand as C}from"../command.js";import{projectRoot as ne}from"../project.js";import{dir as oe}from"../fields.js";import{resourcesIndex as R}from"../resources.js";const _=W(new URL(".",import.meta.resolve("@allyhub/components/registry.json"))),se=Object.keys(K),A=["component","3d-model","scenery","skill","template","lib","@polyhaven"],ae={"allyhub:component":"component","allyhub:model":"3d-model","allyhub:scenery":"scenery","allyhub:skill":"skill","allyhub:template":"template","allyhub:lib":"lib"},H=e=>ae[e]??e.replace(/^allyhub:/u,""),E=e=>`${H(e.type)}/${e.name}`;function ie(e){const n=/^(@?[a-z0-9-]+)\/(.+)$/u.exec(e),i=A.find(d=>d===n?.[1]);if(i===void 0||n?.[2]===void 0)throw new S("usage",n===null?`Name what to add as <type>/<name>: ${e} has no type.`:`${n[1]??""} is not a type: name what to add as <type>/<name>.`,{exit:f.usage,hint:`Types: ${A.join(", ")} (3d-model/monitor, scenery/home-desk-demo-day, skill/web-product-demos, component/caption-line, @polyhaven/<id>). allyhub add lists every one.`});return{type:i,name:n[2]}}const le={"allyhub:model":"3D models","allyhub:scenery":"3D sceneries","allyhub:skill":"Skills","allyhub:template":"Templates","allyhub:component":"Components","allyhub:lib":"Libs (added with what uses them)"};function F(e,n){if(e.from==="none")return["AllyHub's resources (models, sceneries) could not be read: check the connection."];const i=n??e.index?.items??[],d=Math.max(0,...i.map(s=>E(s).length)),r=[`AllyHub's resources (allyhub add <type>/<name> copies one with what it needs, its Poly Haven assets and its baked light)${e.from==="stale"?", as last read (the registry cannot be read now)":""}:`];for(const[s,h]of Object.entries(le)){const c=i.filter(u=>u.type===s);c.length!==0&&r.push(`  ${h}:`,...c.map(u=>`    ${E(u).padEnd(d)}  ${u.description}`))}return r}const N=20,z=e=>e.replace(/\.(?:ts|js)$/u,"").replaceAll(/[A-Z]/gu,n=>`-${n.toLowerCase()}`).replace(/^-/u,"");function M(e){return e instanceof J?new S(e.code,e.message,{exit:e.code==="conflict"?f.conflict:e.code==="no-item"?f.notFound:f.failed,...e.hint===void 0?{}:{hint:e.hint}}):e instanceof Z?new S(e.code,e.message,{exit:e.code==="network"?f.platform:e.code==="not-found"?f.notFound:e.code==="bad-choice"?f.usage:f.failed,...e.hint===void 0?{}:{hint:e.hint}}):e}const P=e=>new X({userAgent:`AllyHub/${te} (+https://allyhub.com)`,cacheDir:x(ee(e.env),"polyhaven"),...e.env.ALLYHUB_POLYHAVEN_API?{api:e.env.ALLYHUB_POLYHAVEN_API}:{}}),k=e=>`${e.toFixed(3)} m`;function de(e){const n=[e.type,e.category,e.size?`${k(e.size.width)} wide, ${k(e.size.depth)} deep, ${k(e.size.height)} tall`:void 0,e.covers?`one tile covers ${e.covers.map(k).join(" × ")}`:void 0,e.polycount!==void 0?`${e.polycount.toLocaleString("en")} polygons`:void 0,e.maxResolution?`up to ${String(e.maxResolution[0])} px`:void 0,e.authors.length>0?`by ${e.authors.join(", ")}`:void 0].filter(i=>i!==void 0);return`  @polyhaven/${e.id}: ${e.name} (${n.join("; ")})
+    found in ${e.matchedIn.join(", ")||"everything"}; tags ${e.tags.join(", ")}`}async function U(e,n){const i=[`${n.name} from Poly Haven (CC0, by ${n.source.authors.join(", ")||"its authors"}): ${String(n.files.length)} files in ${n.dir}/, ${n.fetched>0?`${String(n.fetched)} fetched`:"all already there"}. Records: ${n.records.join(", ")}.`];if(n.type==="model"){const r=n.main[0]??"",s=await q(e,r,await Y(x(e,r))),h=s.bounds;return i.push(h?`Measured: ${h.size.map(c=>c.toFixed(3)).join(" × ")} m along x, y (up), z; from ${h.min.map(c=>c.toFixed(3)).join(", ")} to ${h.max.map(c=>c.toFixed(3)).join(", ")}.`:`Not measured: ${s.contentsMissing??"no contents"}.`,...s.missing.length>0?[`Missing: ${s.missing.join(", ")}.`]:[],`In a scenery: const m = await w.load("${r}");`),{lines:i,model:s}}if(n.type==="hdri")return i.push(`In a scenery: await w.environment("${n.main[0]??""}", { background: true });`),{lines:i};const d=n.covers;return i.push(d&&d.length>=2?`One tile covers ${k(d[0]??0)} × ${k(d[1]??0)} (Poly Haven's dimensions): a surface's repeat is its size over that.`:"Poly Haven gives no size for one tile.",...n.main.map((r,s)=>{const h=n.maps?.[s]??"";return`  ${h}: await w.texture("${r}"${h==="diffuse"?"":', { colorSpace: "linear" }'})`})),{lines:i}}export const add=C({name:"add",summary:"Adds to the project what AllyHub and Poly Haven have, each named <type>/<name>: a starter component, a 3D model, a 3D scenery, a skill or a template from AllyHub's registry, or a CC0 model, HDRI or texture from Poly Haven; alone it lists everything AllyHub has, by type",input:p.strictObject({name:p.array(p.string()).optional().describe("What to add, each <type>/<name>: component/caption-line, 3d-model/monitor, scenery/home-desk-demo-day, skill/web-product-demos (a skill goes in .agents/skills, linked from .claude/skills), template/<name>, lib/<name>, or @polyhaven/<id> (as allyhub add search prints it)"),to:p.string().optional().describe(`The folder the files go in, from the project (default ${I} for a component; for an asset, its kind's folder under assets/media/ and its id)`),force:p.boolean().default(!1).describe("Replace a component's copy the project changed (its changes are lost)"),res:p.string().optional().describe(`An asset's resolution, of its textures or of the HDRI (default ${G.resolution})`),dir:oe}),positional:["name"],output:p.looseObject({}),examples:["allyhub add","allyhub add component/caption-line","allyhub add 3d-model/monitor scenery/home-desk-demo-day","allyhub add @polyhaven/metal_office_desk --res 2k"]},async(e,n)=>{const i=D(_);try{const d=await i.index();if(!e.name||e.name.length===0){const t=Math.max(...d.items.map(y=>`component/${y.name}`.length)),l=await R(n);return{value:{components:d.items,resources:l.index?.items??[]},text:["Starter components (allyhub add component/<name> copies one into components/; allyhub add search <words> finds among everything, Poly Haven's models, HDRIs and textures too):",...d.items.map(y=>`  ${`component/${y.name}`.padEnd(t)}  ${y.description}`),"",...F(l,void 0)].join(`
+`)}}const r=e.name.map(ie),s=await ne(n.cwd,e.dir),h=new Set(d.items.map(t=>t.name)),c=t=>t.type==="component"&&h.has(z(t.name)),u=r.filter(c).map(t=>z(t.name)),v=r.filter(t=>t.type==="@polyhaven").map(t=>t.name),g=r.filter(t=>t.type!=="@polyhaven"&&!c(t)),b=g.length>0?await R(n):void 0;for(const t of g){const l=b?.index?.items.find(y=>y.name===t.name);if(!l)throw new S("no-item",`There is no ${t.type}/${t.name}.`,{exit:f.notFound,hint:b?.from==="none"?"AllyHub's registry could not be read: check the connection.":`allyhub add search --type ${t.type} lists them.`});if(H(l.type)!==t.type)throw new S("usage",`${t.name} is a ${H(l.type)}, not a ${t.type}.`,{exit:f.usage,hint:`allyhub add ${E(l)}`})}const w=g.map(t=>t.name),a=[],j={};if(u.length>0){const t=e.to??I,l=await L(i,u,{root:s,dir:t,force:e.force});await T(s,l);const y=m=>m==="up to date"?"Up to date":m==="added"?"Added":"Replaced";a.push(...l.files.map(m=>`${y(m.status)} ${m.path}`));const $=l.items.find(m=>m.name===u[0]),o=$?.files[0]?.target.replaceAll("{dir}",t);if($&&o){const m=V(x(s,"name"),x(s,o)).split("\\").join("/").replace(/\.ts$/u,".js");a.push(`Import it from an item's entry file (<name>/video.ts): import { ${$.title} } from "${m.startsWith(".")?m:`./${m}`}"; one "../" more for each folder the item is deeper.`,"The file is the project's: change it as you like. allyhub add component/<name> --force puts the registry's back.")}l.missing.length>0&&a.push(`It needs packages the project does not declare: ${l.missing.join(", ")}.`),j.components=l.files.map(m=>({item:m.item,path:m.path,status:m.status})),j.missing=l.missing}if(b&&w.length>0){const t=await L(b.source,w,{root:s,dir:".",force:e.force});await T(s,t),a.length>0&&a.push(""),a.push(...t.files.map(o=>`${o.status==="up to date"?"Up to date":o.status==="added"?"Added":"Replaced"} ${o.path}`));const l=P(n);for(const o of t.assets){const m=await l.add(o.id,{root:s,...o.resolution===void 0?{}:{resolution:o.resolution},...o.maps===void 0?{}:{maps:o.maps}});a.push(...(await U(s,m)).lines)}const y=await Q(s,t.bakes);a.push(...y.map(o=>`${o.status==="added"?"Downloaded":"Up to date"} the baked light for ${o.bake.scenery}: ${o.path}`),"The files are the project's: change them as you like (a changed scenery is drawn unbaked until allyhub scenery bake bakes it again). allyhub add <type>/<name> --force puts the registry's back.");const $=t.files.filter(o=>o.path.endsWith("/README.md"));$.length>0&&a.push(`Read first, for its screens and cameras: ${$.map(o=>o.path).join(", ")}`),j.resources={files:t.files.map(o=>({item:o.item,path:o.path,status:o.status})),assets:t.assets,bakes:y.map(o=>({path:o.path,status:o.status}))}}if(v.length>0){const t=P(n),l=[];for(const y of v){const $=await t.add(y,{root:s,...e.to===void 0||u.length>0?{}:{to:B.normalize(e.to)},...e.res===void 0?{}:{resolution:e.res}}),o=await U(s,$);a.length>0&&a.push(""),a.push(...o.lines),l.push({...$,...o.model===void 0?{}:{model:o.model}})}j.assets=l}return{value:j,text:a.join(`
+`)}}catch(d){throw M(d)}}),addSearch=C({name:"add search",summary:"Finds the starter components, AllyHub's resources (models, sceneries) and Poly Haven's CC0 models, HDRIs and textures whose names, tags, categories or descriptions hold every word, each with where its words were found; with no words, lists every one",input:p.strictObject({words:p.array(p.string()).default([]).describe("The words to find (a word may start one of theirs); none lists every one"),type:p.array(p.enum(A)).optional().describe(`Only these types (default all): ${A.join(", ")} (@polyhaven: Poly Haven's models, HDRIs and textures)`),all:p.boolean().default(!1).describe(`Every match, not only the first ${String(N)} Poly Haven assets`)}),positional:["words"],output:p.looseObject({}),examples:["allyhub add search --type 3d-model",'allyhub add search "office desk" --type @polyhaven',"allyhub add search caption --type component"]},async(e,n)=>{const i=e.words.join(" ").trim(),d=i===""?"":` hold "${i}"`;try{const r=e.type??A,s=r.includes("component")?O(await D(_).index(),i):[],h=r.filter(a=>a!=="@polyhaven"),c=h.length>0?await R(n):void 0,u=c?.index?O(c.index,i).filter(a=>h.includes(H(a.type))):[],v=r.includes("@polyhaven")?se:[],{found:g,total:b}=v.length>0?await P(n).search(i,v):{found:[],total:0},w=e.all?g:g.slice(0,N);return{value:{query:i,components:s,resources:u,assets:{total:b,matches:g.length,found:w}},text:[...r.includes("component")?[`Starter components: ${String(s.length)}${d}.`,...s.map(a=>`  component/${a.name} (${a.title}): ${a.description}`)]:[],...c?c.from==="none"?F(c,[]):[`AllyHub's resources: ${String(u.length)}${d}${c.from==="stale"?" (as last read)":""}.`,...u.map(a=>`  ${E(a)} (${a.title}): ${a.description}`)]:[],...v.length>0?[`From Poly Haven (CC0): ${String(g.length)} of ${String(b)} assets${d}${w.length<g.length?`; the first ${String(w.length)} (--all for every one)`:""}.`,...w.map(de)]:[],"","Add one: allyhub add <type>/<name>"].join(`
 `)}}catch(r){throw M(r)}});

package/dist/commands/align.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{relative as h}from"node:path";import{z as s}from"zod";import{parameters as p}from"../parameters.js";import{SECOND_PEAK_GUARD as u,syncOffset as $}from"@allyhub-next/media";import{defineCommand as g}from"../command.js";import{existingFile as c,media as w,progressLines as b}from"../media.js";import{projectOfFile as x}from"../project.js";const d=(e,t)=>`${e<0?"−":"+"}${Math.abs(e).toFixed(t)}`,l=e=>e<0?`−${(-e).toFixed(1)}`:e.toFixed(1);function F(e){const t=Object.fromEntries(Object.entries(e).filter(([r])=>r!=="reference"&&r!=="rate"&&r!=="other")),o=e.other;return{...o,...t,offset:e.offset,pictureOffset:e.offset===null||o.soundStart===null?null:Math.round((e.offset+o.soundStart)*1e6)/1e6}}function S(e,t){const o=t(e.reference.file),r=t(e.other.file),f=`  Sound: ${o} ${l(e.level.reference.rms)} dBFS RMS, ${e.reference.duration.toFixed(2)} s; ${r} ${l(e.level.other.rms)} dBFS RMS, ${e.other.duration.toFixed(2)} s${e.other.soundStart?`; its sound starts ${String(e.other.soundStart)} s into its own clock`:""}.`;if(e.offset===null)return[`${r} against ${o}: not measured: ${e.why??"no offset found"}.`,f];const n=[`${r} against ${o}: offset ${d(e.offset,6)} s: a moment at t s of ${o} is at t ${e.offset<0?"−":"+"} ${Math.abs(e.offset).toFixed(6)} s of ${r}.`];return e.peak&&n.push(`  Peak ${e.peak.confidence.toFixed(1)} × the correlation's RMS; ${e.second?`the next peak more than ${String(u)} s away ${e.second.ratio.toFixed(2)} × lower, at ${d(e.second.offset,3)} s`:"no other peak"}; polarity ${e.peak.inverted?"inverted":"the same"}; ${String(e.common??0)} s of common sound.`),e.windows.length&&n.push(`  Windows (${String(e.windows[0]?.dur??0)} s each): where, offset, peak, width, correlation:`,...e.windows.map(a=>a.offset===null?`    at ${a.at.toFixed(2).padStart(8)} s  not measured: no sound on a side`:`    at ${a.at.toFixed(2).padStart(8)} s  ${d(a.offset,6)} s  ${(a.confidence??0).toFixed(1)} ×  ${((a.width??0)*1e3).toFixed(3)} ms  ${(a.correlation??0).toFixed(3)}`)),n.push(e.drift?`  Drift ${d(e.drift.ppm,2)} ppm over ${String(e.drift.span)} s: offset(t) = ${e.drift.at0.toFixed(6)} ${e.drift.slope<0?"−":"+"} ${Math.abs(e.drift.slope).toExponential(4)} × t; speed ${(1+e.drift.slope).toFixed(8)} keeps step.`:`  Drift not measured: ${e.driftWhy??"no line"}.`,f),n}const y={max:s.number().positive().optional().describe("The largest offset looked for either way, seconds (default any that leaves common sound)")};export const align=g({name:"align",summary:"The offset between recordings of the same moment, from their sound, with how sharply they match and how it drifts",input:s.strictObject({reference:s.string().describe("The recording the others are measured against"),others:s.array(s.string()).min(1).describe("The recordings to measure: other = reference + offset"),dir:s.string().optional().describe("The project whose media index keeps the result (default the nearest above the reference)"),params:p(y)}),positional:["reference","others"],output:s.looseObject({reference:s.unknown(),files:s.array(s.looseObject({offset:s.number().nullable()}))}),examples:["allyhub align assets/media/mic.wav assets/media/cam.mp4","allyhub align mic.wav cam.mp4 --param max=10"]},async(e,t)=>{const o=await c(t.cwd,e.reference),r=await Promise.all(e.others.map(i=>c(t.cwd,i))),f=await x(e.reference,t.cwd,e.dir);f.warning!==void 0&&t.progress(f.warning);const n=[];for(const i of r)n.push(await w(()=>$(o,i,{root:f.root,...e.params.max===void 0?{}:{max:e.params.max},onProgress:b(t),signal:t.signal})));const a=i=>{const m=h(t.cwd,i);return m===""||m.startsWith("..")?i:m};return{value:{project:f.root,reference:n[0]?.reference??{file:o},rate:n[0]?.rate??null,files:n.map(F)},text:n.flatMap(i=>S(i,a)).join(`
+import{relative as h}from"node:path";import{z as s}from"zod";import{parameters as p}from"../parameters.js";import{SECOND_PEAK_GUARD as u,syncOffset as $}from"@allyhub/media";import{defineCommand as g}from"../command.js";import{existingFile as c,media as w,progressLines as b}from"../media.js";import{projectOfFile as x}from"../project.js";const d=(e,t)=>`${e<0?"−":"+"}${Math.abs(e).toFixed(t)}`,l=e=>e<0?`−${(-e).toFixed(1)}`:e.toFixed(1);function F(e){const t=Object.fromEntries(Object.entries(e).filter(([r])=>r!=="reference"&&r!=="rate"&&r!=="other")),o=e.other;return{...o,...t,offset:e.offset,pictureOffset:e.offset===null||o.soundStart===null?null:Math.round((e.offset+o.soundStart)*1e6)/1e6}}function S(e,t){const o=t(e.reference.file),r=t(e.other.file),f=`  Sound: ${o} ${l(e.level.reference.rms)} dBFS RMS, ${e.reference.duration.toFixed(2)} s; ${r} ${l(e.level.other.rms)} dBFS RMS, ${e.other.duration.toFixed(2)} s${e.other.soundStart?`; its sound starts ${String(e.other.soundStart)} s into its own clock`:""}.`;if(e.offset===null)return[`${r} against ${o}: not measured: ${e.why??"no offset found"}.`,f];const n=[`${r} against ${o}: offset ${d(e.offset,6)} s: a moment at t s of ${o} is at t ${e.offset<0?"−":"+"} ${Math.abs(e.offset).toFixed(6)} s of ${r}.`];return e.peak&&n.push(`  Peak ${e.peak.confidence.toFixed(1)} × the correlation's RMS; ${e.second?`the next peak more than ${String(u)} s away ${e.second.ratio.toFixed(2)} × lower, at ${d(e.second.offset,3)} s`:"no other peak"}; polarity ${e.peak.inverted?"inverted":"the same"}; ${String(e.common??0)} s of common sound.`),e.windows.length&&n.push(`  Windows (${String(e.windows[0]?.dur??0)} s each): where, offset, peak, width, correlation:`,...e.windows.map(a=>a.offset===null?`    at ${a.at.toFixed(2).padStart(8)} s  not measured: no sound on a side`:`    at ${a.at.toFixed(2).padStart(8)} s  ${d(a.offset,6)} s  ${(a.confidence??0).toFixed(1)} ×  ${((a.width??0)*1e3).toFixed(3)} ms  ${(a.correlation??0).toFixed(3)}`)),n.push(e.drift?`  Drift ${d(e.drift.ppm,2)} ppm over ${String(e.drift.span)} s: offset(t) = ${e.drift.at0.toFixed(6)} ${e.drift.slope<0?"−":"+"} ${Math.abs(e.drift.slope).toExponential(4)} × t; speed ${(1+e.drift.slope).toFixed(8)} keeps step.`:`  Drift not measured: ${e.driftWhy??"no line"}.`,f),n}const y={max:s.number().positive().optional().describe("The largest offset looked for either way, seconds (default any that leaves common sound)")};export const align=g({name:"align",summary:"The offset between recordings of the same moment, from their sound, with how sharply they match and how it drifts",input:s.strictObject({reference:s.string().describe("The recording the others are measured against"),others:s.array(s.string()).min(1).describe("The recordings to measure: other = reference + offset"),dir:s.string().optional().describe("The project whose media index keeps the result (default the nearest above the reference)"),params:p(y)}),positional:["reference","others"],output:s.looseObject({reference:s.unknown(),files:s.array(s.looseObject({offset:s.number().nullable()}))}),examples:["allyhub align assets/media/mic.wav assets/media/cam.mp4","allyhub align mic.wav cam.mp4 --param max=10"]},async(e,t)=>{const o=await c(t.cwd,e.reference),r=await Promise.all(e.others.map(i=>c(t.cwd,i))),f=await x(e.reference,t.cwd,e.dir);f.warning!==void 0&&t.progress(f.warning);const n=[];for(const i of r)n.push(await w(()=>$(o,i,{root:f.root,...e.params.max===void 0?{}:{max:e.params.max},onProgress:b(t),signal:t.signal})));const a=i=>{const m=h(t.cwd,i);return m===""||m.startsWith("..")?i:m};return{value:{project:f.root,reference:n[0]?.reference??{file:o},rate:n[0]?.rate??null,files:n.map(F)},text:n.flatMap(i=>S(i,a)).join(`
 `)}});

package/dist/commands/audio.js

@@ -1,4 +1,4 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{stat as j}from"node:fs/promises";import{resolve as T}from"node:path";import{z as t}from"zod";import{RECORDING_MEASURE_DEFAULTS as M}from"@allyhub-next/audio";import{AudioError as O}from"@allyhub-next/audio/node";import{formatProblem as g,formatConsole as v}from"../text/index.js";import{fileRecording as A,fileSoundReport as F,soundReport as $,versionRecording as I}from"@allyhub-next/measure";import{consoleJson as h}from"@allyhub-next/project";import{mediaKindOf as S}from"@allyhub-next/media";import{EXIT as w}from"@allyhub-next/protocol";import{fileAudioText as C,fileRecordingText as D,versionAudioText as V,versionRecordingText as _}from"../audio-text.js";import{CommandError as p,defineCommand as b}from"../command.js";import{VERSION_FIELDS as x,withVersion as y}from"../version.js";const f=(e,i)=>new p(e,i,{exit:w.usage});function m(e){return e instanceof O?new p(e.code,e.message,{exit:w.failed,...e.code==="no-sound"?{hint:"Give a sound or video file that has a sound stream."}:{}}):e}async function c(e,i){const n=T(e,i);if(!(await j(n).catch(()=>{}))?.isFile())throw new p("no-file",`There is no file ${i}.`,{exit:w.notFound});return n}function R(e){const i=S(e);return i==="audio"||i==="video"}const E=t.string().optional().describe("The video: its id, or a path into it (default the project's only one); or a sound or video file, measured alone");function k(e,i){return{piece:e.piece,combo:e.combo,format:e.format,...e.id===void 0?{}:{id:e.id},problems:i.problems,...h(i.console)}}export const audio=b({name:"audio",summary:"How a video sounds: its mix's loudness, what the master did, silences, onsets against cuts and cues, pace, levels under and between the words, each part's speech and voice; or a file on its clock, or a file alone",input:t.strictObject({...x,item:E,file:t.string().optional().describe("Measure this sound or video file on the video's clock instead of its mix (another render, a reference's sound); the video's own voice still comes from its takes")}),positional:["item"],output:t.looseObject({source:t.object({kind:t.enum(["mix","file"])}),duration:t.number(),loudness:t.object({integrated:t.number().nullable(),truePeak:t.number().nullable()})}),examples:["allyhub audio launch/film","allyhub audio launch/film --file export.mp4","allyhub audio reference.m4a"]},async(e,i)=>{if(e.item!==void 0&&R(e.item)){if(e.file!==void 0)throw f("no-piece","--file needs a video to measure on: name the video, and give the file with --file.");const o=await c(i.cwd,e.item);i.progress(`Measuring ${e.item}`);const s=await F(o).catch(l=>{throw m(l)});return{value:{...s},text:C(s,i.cwd)}}const n=e.file===void 0?void 0:await c(i.cwd,e.file),r=await y(e,i,"check",async o=>{i.progress(`Mixing and measuring ${o.target.piece}`);try{return{target:o.target,report:await $(o,n===void 0?{}:{file:n})}}catch(s){throw m(s)}}),{target:a,report:d}=r.result;return{value:{...k(a,r),...d},text:[V(a,d,i.cwd),...r.problems.filter(o=>o.level==="error").map(g),...v(h(r.console))].join(`
+import{stat as j}from"node:fs/promises";import{resolve as T}from"node:path";import{z as t}from"zod";import{RECORDING_MEASURE_DEFAULTS as M}from"@allyhub/audio";import{AudioError as O}from"@allyhub/audio/node";import{formatProblem as g,formatConsole as v}from"../text/index.js";import{fileRecording as A,fileSoundReport as F,soundReport as $,versionRecording as I}from"@allyhub/measure";import{consoleJson as h}from"@allyhub/project";import{mediaKindOf as S}from"@allyhub/media";import{EXIT as w}from"@allyhub/protocol";import{fileAudioText as C,fileRecordingText as D,versionAudioText as V,versionRecordingText as _}from"../audio-text.js";import{CommandError as p,defineCommand as b}from"../command.js";import{VERSION_FIELDS as x,withVersion as y}from"../version.js";const f=(e,i)=>new p(e,i,{exit:w.usage});function m(e){return e instanceof O?new p(e.code,e.message,{exit:w.failed,...e.code==="no-sound"?{hint:"Give a sound or video file that has a sound stream."}:{}}):e}async function c(e,i){const n=T(e,i);if(!(await j(n).catch(()=>{}))?.isFile())throw new p("no-file",`There is no file ${i}.`,{exit:w.notFound});return n}function R(e){const i=S(e);return i==="audio"||i==="video"}const E=t.string().optional().describe("The video: its id, or a path into it (default the project's only one); or a sound or video file, measured alone");function k(e,i){return{piece:e.piece,combo:e.combo,format:e.format,...e.id===void 0?{}:{id:e.id},problems:i.problems,...h(i.console)}}export const audio=b({name:"audio",summary:"How a video sounds: its mix's loudness, what the master did, silences, onsets against cuts and cues, pace, levels under and between the words, each part's speech and voice; or a file on its clock, or a file alone",input:t.strictObject({...x,item:E,file:t.string().optional().describe("Measure this sound or video file on the video's clock instead of its mix (another render, a reference's sound); the video's own voice still comes from its takes")}),positional:["item"],output:t.looseObject({source:t.object({kind:t.enum(["mix","file"])}),duration:t.number(),loudness:t.object({integrated:t.number().nullable(),truePeak:t.number().nullable()})}),examples:["allyhub audio launch/film","allyhub audio launch/film --file export.mp4","allyhub audio reference.m4a"]},async(e,i)=>{if(e.item!==void 0&&R(e.item)){if(e.file!==void 0)throw f("no-piece","--file needs a video to measure on: name the video, and give the file with --file.");const o=await c(i.cwd,e.item);i.progress(`Measuring ${e.item}`);const s=await F(o).catch(l=>{throw m(l)});return{value:{...s},text:C(s,i.cwd)}}const n=e.file===void 0?void 0:await c(i.cwd,e.file),r=await y(e,i,"check",async o=>{i.progress(`Mixing and measuring ${o.target.piece}`);try{return{target:o.target,report:await $(o,n===void 0?{}:{file:n})}}catch(s){throw m(s)}}),{target:a,report:d}=r.result;return{value:{...k(a,r),...d},text:[V(a,d,i.cwd),...r.problems.filter(o=>o.level==="error").map(g),...v(h(r.console))].join(`
 `)}}),audioRecording=b({name:"audio recording",summary:"How a video's voice is recorded: its speech as its mic settings record it (the room, the room tone, the spectrum, the dynamics), a file's beside it with the differences, and the video's setting fitted to the file; or a file alone",input:t.strictObject({...x,item:E,file:t.string().optional().describe("A sound or video file measured whole beside the video's voice, with the differences"),mix:t.boolean().default(!1).describe("Measure the video's whole mix, as mastered, as a file is measured, not its speech alone"),fit:t.boolean().default(!1).describe("Fit the video's mic setting to --file's recording (keeping its setup), and print it for video({ mic })")}),positional:["item"],output:t.looseObject({measured:t.enum(["speech","mix","file"])}),examples:["allyhub audio recording launch/film","allyhub audio recording launch/film --file reference.m4a --fit","allyhub audio recording reference.m4a"]},async(e,i)=>{if(e.fit&&e.file===void 0)throw f("bad-option","--fit fits the video's voice to a file's: give it with --file.");if(e.fit&&e.mix)throw f("bad-option","--fit records the video's speech, and --mix measures its whole mix: they do not go together.");if(e.item!==void 0&&R(e.item)){const o=u=>f("no-piece",`${u} needs a video: name the video, and give the file with --file.`);if(e.file!==void 0)throw o("--file");if(e.fit)throw o("--fit");if(e.mix)throw o("--mix");const s=await c(i.cwd,e.item);i.progress(`Measuring ${e.item}`);const l=await A(s).catch(u=>{throw m(u)});return{value:{measured:"file",file:l,options:{measure:M}},text:D(s,l,i.cwd)}}const n=e.file===void 0?void 0:await c(i.cwd,e.file),r=await y(e,i,"check",async o=>{i.progress(`Recording and measuring ${o.target.piece}`);try{return{target:o.target,report:await I(o,{ask:{...e.fit?{fit:{}}:{},...e.mix?{mix:!0}:{}},...n===void 0?{}:{file:n}})}}catch(s){throw m(s)}}),{target:a,report:d}=r.result;return{value:{...k(a,r),...d},text:[_(a,d),...r.problems.filter(o=>o.level==="error").map(g),...v(h(r.console))].join(`
 `)}});

package/dist/commands/auth.js

@@ -1,6 +1,6 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as e}from"zod";import{billingSummary as w,hostsText as p,openBrowser as b,readCredentials as f,signIn as y,signInDevice as $,signInInBackground as v,signedInAs as S,SIGN_IN_WAIT_MS as d}from"@allyhub-next/cloud";import{API_KEY_ENV as I,EXIT as _}from"@allyhub-next/protocol";import{defineCommand as h}from"../command.js";import{cloudOf as g,cloudWork as m}from"./cloud.js";const x=e.looseObject({url:e.string()});export const authLogin=h({name:"auth login",summary:"Sign this computer in to AllyHub, for the cloud tools; once per computer, shared with AllyHub Studio",input:e.strictObject({wait:e.boolean().optional().describe(`Wait here for the browser (default in a terminal); --no-wait waits ${String(d/6e4)} minutes in the background and returns at once (default for an agent), then allyhub auth status says when it is done`),browser:e.boolean().default(!0).describe("Open the browser; --no-browser only prints the address"),device:e.boolean().default(!1).describe("Sign in with a code entered in a browser elsewhere (RFC 8628's device flow), for a computer with no browser of its own")}),output:e.looseObject({status:e.enum(["signed-in","waiting"]),email:e.string().optional(),url:e.string().optional(),hosts:x}),examples:["allyhub auth login","allyhub auth login --no-wait --no-browser","allyhub auth login --device"]},(u,s)=>m(async()=>{const t=g(s),i={url:t.url,from:t.config.from},r=`Signing in to AllyHub: ${p(t.config)}.`,o=await S(t);if(o)return{value:{status:"signed-in",email:o.email,hosts:i},text:`This computer is signed in to AllyHub as ${o.email}.`};if(u.device){const n=await $(t,c=>{s.progress(`${r}
-On any computer, open ${c.verification_uri} and enter ${c.user_code}${c.verification_uri_complete===void 0?"":` (or open ${c.verification_uri_complete})`}.`)});return{value:{status:"signed-in",email:n.email,hosts:i},text:`Signed in as ${n.email}.`}}const a=n=>{u.browser&&b(n,s.env)};if(u.wait===!1||u.wait===void 0&&!process.stdout.isTTY){const n=await v(t,s.env);return a(n),{value:{status:"waiting",url:n,hosts:i},text:[r,"Sign in in the browser (opened, or open this address):",`  ${n}`,`It waits ${String(d/6e4)} minutes in the background; allyhub auth status says when it is done.`].join(`
-`)}}const l=await y(t,n=>{s.progress(`${r}
+import{z as e}from"zod";import{billingSummary as f,hostsText as w,openBrowser as p,readCredentials as b,signIn as y,signInDevice as $,signInInBackground as v,signedInAs as I,SIGN_IN_WAIT_MS as d}from"@allyhub/cloud";import{API_KEY_ENV as S,EXIT as _}from"@allyhub/protocol";import{defineCommand as h}from"../command.js";import{cloudOf as g,cloudWork as m}from"./cloud.js";const k=e.looseObject({url:e.string()});export const authLogin=h({name:"auth login",summary:"Sign this computer in to AllyHub, for the cloud tools; once per computer, shared with AllyHub Studio",input:e.strictObject({wait:e.boolean().optional().describe(`Wait here for the browser (default in a terminal); --no-wait waits ${String(d/6e4)} minutes in the background and returns at once (default for an agent), then allyhub auth status says when it is done`),browser:e.boolean().default(!0).describe("Open the browser; --no-browser only prints the address"),device:e.boolean().default(!1).describe("Sign in with a code entered in a browser elsewhere (RFC 8628's device flow), for a computer with no browser of its own")}),output:e.looseObject({status:e.enum(["signed-in","waiting"]),email:e.string().optional(),url:e.string().optional(),hosts:k}),examples:["allyhub auth login","allyhub auth login --no-wait --no-browser","allyhub auth login --device"]},(u,s)=>m(async()=>{const n=g(s),o={url:n.url,from:n.config.from},r=`Signing in to AllyHub: ${w(n.config)}.`,i=await I(n);if(i)return{value:{status:"signed-in",email:i.email,hosts:o},text:`This computer is signed in to AllyHub as ${i.email}.`};if(u.device){const t=await $(n,c=>{s.progress(`${r}
+On any computer, open ${c.verification_uri} and enter ${c.user_code}${c.verification_uri_complete===void 0?"":` (or open ${c.verification_uri_complete})`}.`)});return{value:{status:"signed-in",email:t.email,hosts:o},text:`Signed in as ${t.email}.`}}const a=t=>{u.browser&&p(t,s.env)};if(u.wait===!1||u.wait===void 0&&!process.stdout.isTTY){const t=await v(n,s.env);return a(t),{value:{status:"waiting",url:t,hosts:o},text:[r,"Sign in in the browser (opened, or open this address):",`  ${t}`,`It waits ${String(d/6e4)} minutes in the background; allyhub auth status says when it is done.`].join(`
+`)}}const l=await y(n,t=>{s.progress(`${r}
 Sign in in your browser. If it did not open:
-  ${n}`),a(n)});return{value:{status:"signed-in",email:l.email,hosts:i},text:`Signed in as ${l.email}. AllyHub Studio on this computer is signed in too.`}})),authStatus=h({name:"auth status",summary:"Whether this computer is signed in to AllyHub, as whom, and the account's credits; exits 4 when it is not",input:e.strictObject({}),output:e.looseObject({signedIn:e.boolean(),source:e.enum(["env","oauth"]).optional(),organization:e.string().optional(),email:e.string().optional(),url:e.string(),credits:e.number().optional()})},(u,s)=>m(async()=>{const t=g(s),i=await t.key();if(!i)return{value:{signedIn:!1,url:t.url},text:"Not signed in. Run allyhub auth login.",exit:_.auth};const r=await w(t),o=i.source==="oauth"?await f(t.config):void 0,a=o?.account.organization,l=i.source==="env"?`with the key in ${I}`:`as ${o?.account.email??"this computer's account"}${a===void 0?"":` in ${a.name||"their own organization"}`}`;return{value:{signedIn:!0,source:i.source,...o?{email:o.account.email}:{},...a===void 0?{}:{organization:a.id},url:t.url,credits:r.credits},text:`Signed in ${l} at ${t.url}. Credits: ${String(r.credits)}.`}}));
+  ${t}`),a(t)});return{value:{status:"signed-in",email:l.email,hosts:o},text:`Signed in as ${l.email}. AllyHub Studio on this computer is signed in too.`}})),authStatus=h({name:"auth status",summary:"Whether this computer is signed in to AllyHub, as whom, and the account's credits; exits 4 when it is not",input:e.strictObject({}),output:e.looseObject({signedIn:e.boolean(),source:e.enum(["env","oauth"]).optional(),organization:e.string().optional(),email:e.string().optional(),url:e.string(),credits:e.number().optional()})},(u,s)=>m(async()=>{const n=g(s),o=await n.key();if(!o)return{value:{signedIn:!1,url:n.url},text:"Not signed in. Run allyhub auth login.",exit:_.auth};const r=await f(n),i=o.source==="oauth"?await b(n.config):void 0,a=i?.account.organization,l=o.source==="env"?`with the key in ${S}`:`as ${i?.account.email??"this computer's account"}${a===void 0?"":` in ${a.name||"their own organization"}`}`,t=i===void 0?void 0:i.keychain!==void 0&&n.config.keychain?n.config.keychain.name:n.config.credentialsFile;return{value:{signedIn:!0,source:o.source,...i?{email:i.account.email}:{},...a===void 0?{}:{organization:a.id},url:n.url,credits:r.credits,...t===void 0?{}:{tokensIn:t}},text:`Signed in ${l} at ${n.url}. Credits: ${String(r.credits)}.${t===void 0?"":` Tokens kept in ${t}.`}`}}));

package/dist/commands/check.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";import{EXIT as s}from"@allyhub-next/protocol";import{formatCheck as c}from"../text/index.js";import{defineCommand as m}from"../command.js";import{projectRoot as a}from"../project.js";import{dir as l}from"../fields.js";import{checkIndexed as n}from"../version.js";export const check=m({name:"check",summary:"Problems: objective errors in the project's items, by rule; exits 1 when one must be fixed",input:o.strictObject({item:o.string().optional().describe("Only this item: its id, a path into it, or a folder of items"),dir:l,fresh:o.boolean().default(!1).describe("Load every version again, not the last check's results")}),positional:["item"],output:o.looseObject({}),examples:["allyhub check","allyhub check launch/film","allyhub check --json"]},async(t,r)=>{const i=await a(r.cwd,t.dir),e=await n({dir:i,fresh:t.fresh,...t.item===void 0?{}:{piece:t.item}},r);return{value:{check:e.check,problems:e.problems,stats:e.stats,facts:e.facts.length,console:e.console},text:c(e),exit:e.check.errors>0?s.failed:s.ok}});
+import{z as o}from"zod";import{EXIT as s}from"@allyhub/protocol";import{formatCheck as c}from"../text/index.js";import{defineCommand as m}from"../command.js";import{projectRoot as a}from"../project.js";import{dir as l}from"../fields.js";import{checkIndexed as n}from"../version.js";export const check=m({name:"check",summary:"Problems: objective errors in the project's items, by rule; exits 1 when one must be fixed",input:o.strictObject({item:o.string().optional().describe("Only this item: its id, a path into it, or a folder of items"),dir:l,fresh:o.boolean().default(!1).describe("Load every version again, not the last check's results")}),positional:["item"],output:o.looseObject({}),examples:["allyhub check","allyhub check launch/film","allyhub check --json"]},async(t,r)=>{const i=await a(r.cwd,t.dir),e=await n({dir:i,fresh:t.fresh,...t.item===void 0?{}:{piece:t.item}},r);return{value:{check:e.check,problems:e.problems,stats:e.stats,facts:e.facts.length,console:e.console},text:c(e),exit:e.check.errors>0?s.failed:s.ok}});

package/dist/commands/cloud-tools.js

@@ -1,5 +1,5 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readFile as x}from"node:fs/promises";import{join as J,resolve as v}from"node:path";import{z as o}from"zod";import{callTool as C,loadCatalog as m,resumeJob as D,uploadFiles as E}from"@allyhub-next/cloud";import{WORK_DIR as I}from"@allyhub-next/formats";import{EXIT as g}from"@allyhub-next/protocol";import{CommandError as w,defineCommand as N}from"../command.js";import{optionName as M}from"../args.js";import{requiredMissing as T,toolInput as L,toolOptions as U}from"../tool-options.js";import{cloudOf as f,cloudWork as $,placeFrom as H,plural as b}from"./cloud.js";const B=8e3,p={input:o.string().optional().describe("The input as JSON, or a file of it: the whole of it, or the fields no option gives; an option given beside it wins"),file:o.string().optional().describe("The path of the file it makes, or for a tool that returns data, of its output as JSON (without an extension it takes the result's, or .json); the same call with the same input then keeps it, calling nothing, and while its call works waits for that call; default a folder under .allyhub/work/"),force:o.boolean().default(!1).describe("With --file: call even when the file was made from this input, and replace a file that has no record"),wait:o.boolean().default(!0).describe("Wait for a long tool (an audit, a video model); --no-wait returns its call at once"),resume:o.string().optional().describe("Wait for a call of this tool this computer made (from --no-wait, or a call that stopped waiting), and download its file")},k=(e,a)=>new w("usage",e,{exit:g.usage,...a===void 0?{}:{hint:a}}),K=e=>{const a=e.reduce((i,r)=>r.map((s,n)=>Math.max(i[n]??0,s.length)),[]);return e.map(i=>`  ${i.map((r,s)=>s===i.length-1?r:r.padEnd(a[s]??0)).join("  ")}`.trimEnd())};function _(e){return N({name:e.id,summary:`${e.title}: ${e.description} Lists the tools, each a command`,input:o.strictObject({fresh:o.boolean().default(!1).describe("Read the catalog from AllyHub again, not the copy kept an hour")}),output:o.looseObject({work:o.string(),tools:o.array(o.looseObject({name:o.string()}))}),examples:[`allyhub ${e.id}`,`allyhub ${e.id} --json`]},(a,i)=>$(async()=>{const s=(await m(f(i),{refresh:a.fresh})).tools.filter(n=>n.work===e.id).sort((n,t)=>n.name.localeCompare(t.name));return{value:{work:e.id,title:e.title,tools:s.map(n=>({name:n.name,title:n.title,description:n.description,long:n.long}))},text:[`${e.title} (${b(s.length,"tool")}):`,...K(s.map(n=>[n.name,n.title])),"",`Each costs credits when it worked; a failed call is free. allyhub help ${e.id} <tool> shows a tool's options and how its credits are counted.`].join(`
+import{readFile as x}from"node:fs/promises";import{join as J,resolve as v}from"node:path";import{z as o}from"zod";import{callTool as C,loadCatalog as m,resumeJob as D,uploadFiles as E}from"@allyhub/cloud";import{WORK_DIR as I}from"@allyhub/formats";import{EXIT as g}from"@allyhub/protocol";import{CommandError as w,defineCommand as N}from"../command.js";import{optionName as M}from"../args.js";import{requiredMissing as T,toolInput as L,toolOptions as U}from"../tool-options.js";import{cloudOf as f,cloudWork as $,placeFrom as H,plural as b}from"./cloud.js";const B=8e3,p={input:o.string().optional().describe("The input as JSON, or a file of it: the whole of it, or the fields no option gives; an option given beside it wins"),file:o.string().optional().describe("The path of the file it makes, or for a tool that returns data, of its output as JSON (without an extension it takes the result's, or .json); the same call with the same input then keeps it, calling nothing, and while its call works waits for that call; default a folder under .allyhub/work/"),force:o.boolean().default(!1).describe("With --file: call even when the file was made from this input, and replace a file that has no record"),wait:o.boolean().default(!0).describe("Wait for a long tool (an audit, a video model); --no-wait returns its call at once"),resume:o.string().optional().describe("Wait for a call of this tool this computer made (from --no-wait, or a call that stopped waiting), and download its file")},k=(e,a)=>new w("usage",e,{exit:g.usage,...a===void 0?{}:{hint:a}}),K=e=>{const a=e.reduce((i,r)=>r.map((s,n)=>Math.max(i[n]??0,s.length)),[]);return e.map(i=>`  ${i.map((r,s)=>s===i.length-1?r:r.padEnd(a[s]??0)).join("  ")}`.trimEnd())};function _(e){return N({name:e.id,summary:`${e.title}: ${e.description} Lists the tools, each a command`,input:o.strictObject({fresh:o.boolean().default(!1).describe("Read the catalog from AllyHub again, not the copy kept an hour")}),output:o.looseObject({work:o.string(),tools:o.array(o.looseObject({name:o.string()}))}),examples:[`allyhub ${e.id}`,`allyhub ${e.id} --json`]},(a,i)=>$(async()=>{const s=(await m(f(i),{refresh:a.fresh})).tools.filter(n=>n.work===e.id).sort((n,t)=>n.name.localeCompare(t.name));return{value:{work:e.id,title:e.title,tools:s.map(n=>({name:n.name,title:n.title,description:n.description,long:n.long}))},text:[`${e.title} (${b(s.length,"tool")}):`,...K(s.map(n=>[n.name,n.title])),"",`Each costs credits when it worked; a failed call is free. allyhub help ${e.id} <tool> shows a tool's options and how its credits are counted.`].join(`
 `)}}))}function q(e,a=5,i=160){const r=n=>{const t=n===void 0?"undefined":JSON.stringify(n);return t.length>i?`${t.slice(0,i-1)}…`:t},s=(n,t)=>[`${n?`${n}: `:""}${b(t.length,"item")}${t.length>a?`, the first ${String(a)}:`:":"}`,...t.slice(0,a).map((l,d)=>`  [${String(d)}] ${r(l)}`)];return Array.isArray(e)?s("",e):typeof e!="object"||e===null?[r(e)]:Object.entries(e).flatMap(([n,t])=>Array.isArray(t)?s(n,t):[`${n}: ${r(t)}`])}function W(e,a){if("jobId"in e)return[`${e.tool} is still working (call ${e.jobId}).`,`Wait for it: allyhub ${a} --resume ${e.jobId}${e.file===void 0?"":" (or the same command again: it waits for this call)"}`].join(`
 `);if(e.kept)return[`Kept ${e.file??""}: ${e.tool} made it from this same input on ${e.kept.at} (${e.gen??""}).`,"Nothing was called or charged. --force makes it again."].join(`
 `);const i=JSON.stringify(e.output,null,2);return[i.length<=B?i:[`Output: ${String(Math.round(Buffer.byteLength(i)/1024))} KB of JSON, in short:`,...q(e.output)].join(`

package/dist/commands/cloud.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{Cloud as c,CloudError as e,cloudConfig as n}from"@allyhub-next/cloud";import{CommandError as i}from"../command.js";import{projectRoot as a}from"../project.js";export const cloudOf=r=>new c(n(r.env));export async function cloudWork(r){try{return await r()}catch(o){throw o instanceof e?new i(o.code,o.message,{exit:o.exit,...o.hint===void 0?{}:{hint:o.hint},cause:o}):o}}export const placeFrom=r=>a(r.cwd).catch(()=>r.cwd),plural=(r,o,t=`${o}s`)=>`${String(r)} ${r===1?o:t}`;
+import{Cloud as c,CloudError as e,cloudConfig as n}from"@allyhub/cloud";import{CommandError as i}from"../command.js";import{projectRoot as a}from"../project.js";export const cloudOf=r=>new c(n(r.env));export async function cloudWork(r){try{return await r()}catch(o){throw o instanceof e?new i(o.code,o.message,{exit:o.exit,...o.hint===void 0?{}:{hint:o.hint},cause:o}):o}}export const placeFrom=r=>a(r.cwd).catch(()=>r.cwd),plural=(r,o,t=`${o}s`)=>`${String(r)} ${r===1?o:t}`;

package/dist/commands/dev.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{mkdir as y,readFile as f,rm as b,writeFile as S}from"node:fs/promises";import{dirname as m,join as p}from"node:path";import{fileURLToPath as E}from"node:url";import{z as a}from"zod";import{listFiles as R}from"@allyhub-next/build";import{openBrowser as h}from"@allyhub-next/cloud";import{startDevServer as u}from"@allyhub-next/dev-server";import{DEV_FILE as w,scanItems as T}from"@allyhub-next/formats";import{EXIT as I}from"@allyhub-next/protocol";import{CommandError as g,defineCommand as $}from"../command.js";import{dir as O,indexing as D}from"../fields.js";import{projectRoot as P}from"../project.js";export const PAGE=p(m(E(import.meta.url)),"../../editor-web");const l=4340,j=20;export async function start(r,e,n){const s={root:r,ui:PAGE,index:n};if(e!==void 0)return u({...s,port:e}).catch(t=>{throw t.code==="EADDRINUSE"?new g("port-in-use",`Port ${String(e)} is in use.`,{hint:"Choose another with --port, or leave it out."}):t});for(let t=l;t<l+j;t++)try{return await u({...s,port:t})}catch(o){if(o.code!=="EADDRINUSE")throw o}return u(s)}async function F(r){try{const e=JSON.parse(await f(p(r,w),"utf8"));return typeof e.url!="string"||typeof e.pid!="number"?void 0:(process.kill(e.pid,0),(await fetch(e.url,{signal:AbortSignal.timeout(2e3)})).ok?e.url:void 0)}catch{return}}async function v(r,e,n){if(n===void 0)return e;const{items:s}=T(await R(r)),t=n.replace(/^\.\//u,"").replace(/\/+$/u,""),o=s.find(i=>i.dir===t||i.entry===t);if(!o)throw new g("not-found",`There is no item ${n} in the project.`,{exit:I.notFound,hint:`Its items: ${s.map(i=>i.dir).join(", ")||"none"}.`});return`${e}?${new URLSearchParams({item:o.dir}).toString()}`}export const dev=$({name:"dev",summary:"The project's items in the browser, each in its editor (docs, sheets, videos, 3D sceneries; websites listed), as their files change; runs until stopped, and run again while it runs, opens its page and ends",input:a.strictObject({item:a.string().optional().describe("Open the page on this item: its folder or its entry file"),dir:O,port:a.number().int().min(1).max(65535).optional().describe(`The port; default the first free one from ${String(l)}`),open:a.boolean().default(!0).describe("Open the page in the browser; --no-open only prints it")}),positional:["item"],output:a.strictObject({url:a.string()}),examples:["allyhub dev","allyhub dev launch/plan","allyhub dev --port 4400 --no-open"]},async(r,e)=>{const n=await P(e.cwd,r.dir),s=r.port===void 0?await F(n):void 0;if(s!==void 0){const i=await v(n,s,r.item);return e.progress(`allyhub dev is already running at ${i}`),r.open&&h(i,e.env),{value:{url:i},text:""}}const t=await start(n,r.port,D(e.env)),o=p(n,w);try{const i=await v(n,t.url,r.item);return await y(m(o),{recursive:!0}),await S(o,JSON.stringify({url:t.url,pid:process.pid})),e.progress(`allyhub dev is at ${i}
+import{mkdir as y,readFile as f,rm as b,writeFile as S}from"node:fs/promises";import{dirname as m,join as p}from"node:path";import{fileURLToPath as E}from"node:url";import{z as a}from"zod";import{listFiles as R}from"@allyhub/build";import{openBrowser as h}from"@allyhub/cloud";import{startDevServer as u}from"@allyhub/dev-server";import{DEV_FILE as w,scanItems as T}from"@allyhub/formats";import{EXIT as I}from"@allyhub/protocol";import{CommandError as g,defineCommand as $}from"../command.js";import{dir as O,indexing as D}from"../fields.js";import{projectRoot as P}from"../project.js";export const PAGE=p(m(E(import.meta.url)),"../../editor-web");const l=4340,j=20;export async function start(r,e,n){const s={root:r,ui:PAGE,index:n};if(e!==void 0)return u({...s,port:e}).catch(t=>{throw t.code==="EADDRINUSE"?new g("port-in-use",`Port ${String(e)} is in use.`,{hint:"Choose another with --port, or leave it out."}):t});for(let t=l;t<l+j;t++)try{return await u({...s,port:t})}catch(o){if(o.code!=="EADDRINUSE")throw o}return u(s)}async function F(r){try{const e=JSON.parse(await f(p(r,w),"utf8"));return typeof e.url!="string"||typeof e.pid!="number"?void 0:(process.kill(e.pid,0),(await fetch(e.url,{signal:AbortSignal.timeout(2e3)})).ok?e.url:void 0)}catch{return}}async function v(r,e,n){if(n===void 0)return e;const{items:s}=T(await R(r)),t=n.replace(/^\.\//u,"").replace(/\/+$/u,""),o=s.find(i=>i.dir===t||i.entry===t);if(!o)throw new g("not-found",`There is no item ${n} in the project.`,{exit:I.notFound,hint:`Its items: ${s.map(i=>i.dir).join(", ")||"none"}.`});return`${e}?${new URLSearchParams({item:o.dir}).toString()}`}export const dev=$({name:"dev",summary:"The project's items in the browser, each in its editor (docs, sheets, videos, 3D sceneries; websites listed), as their files change; runs until stopped, and run again while it runs, opens its page and ends",input:a.strictObject({item:a.string().optional().describe("Open the page on this item: its folder or its entry file"),dir:O,port:a.number().int().min(1).max(65535).optional().describe(`The port; default the first free one from ${String(l)}`),open:a.boolean().default(!0).describe("Open the page in the browser; --no-open only prints it")}),positional:["item"],output:a.strictObject({url:a.string()}),examples:["allyhub dev","allyhub dev launch/plan","allyhub dev --port 4400 --no-open"]},async(r,e)=>{const n=await P(e.cwd,r.dir),s=r.port===void 0?await F(n):void 0;if(s!==void 0){const i=await v(n,s,r.item);return e.progress(`allyhub dev is already running at ${i}`),r.open&&h(i,e.env),{value:{url:i},text:""}}const t=await start(n,r.port,D(e.env)),o=p(n,w);try{const i=await v(n,t.url,r.item);return await y(m(o),{recursive:!0}),await S(o,JSON.stringify({url:t.url,pid:process.pid})),e.progress(`allyhub dev is at ${i}
 Press Ctrl+C to stop.`),r.open&&h(i,e.env),await new Promise(c=>{const d=()=>{process.off("SIGTERM",d),e.signal.removeEventListener("abort",d),c()};e.signal.aborted&&c(),e.signal.addEventListener("abort",d),process.once("SIGTERM",d)}),{value:{url:i},text:""}}finally{(await f(o,"utf8").catch(()=>"")).includes(`"pid":${String(process.pid)}`)&&await b(o,{force:!0}),await t.close()}});

package/dist/commands/doctor.js

@@ -1,5 +1,5 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as l}from"zod";import{startBrowser as A}from"@allyhub-next/browser";import{LOCAL_PACKS as j,formatBytes as c,installPack as C,localPacks as N,removePack as P}from"@allyhub-next/media";import{EXIT as g}from"@allyhub-next/protocol";import{ENCODERS as E,FFMPEG_MINIMUM as L,FFMPEG_PINNED as w,ffmpegEncoders as F,ffmpegHint as u,findFfmpeg as H}from"@allyhub-next/render";import{createPackages as $,createRuntimes as m}from"@allyhub-next/runtimes";import{defineCommand as I}from"../command.js";import{media as p,progressLines as M}from"../media.js";const f=[22,19],k=[...j,"word","3d","ffmpeg","chrome"],b={word:["docx"],"3d":["manifold-3d","gltf-tools"]};function O(){const[e=0,o=0]=process.versions.node.split(".").map(Number),t=e>f[0]||e===f[0]&&o>=f[1];return{name:"node",ok:t,detail:`Node.js ${process.versions.node}`,...t?{}:{hint:`AllyHub needs Node.js ${f.join(".")} or newer: install it from nodejs.org or with a version manager.`}}}const y=(e,o)=>({name:o,ok:e?.available??!1,detail:e?.available?`not downloaded yet (${c(e.size)} the first time a command needs it, into ${e.dir})`:`AllyHub has no ${o} build for this computer`,...e?.available?{}:{hint:`Set ALLYHUB_${o.toUpperCase()} to one installed here.`}});async function R(e){const o=await m().locate("ffmpeg"),t=o?.bins.ffmpeg;if(t===void 0)return y(e,"ffmpeg");const s=await H(t);if(!s)return{name:"ffmpeg",ok:!1,detail:`${t} does not run`,hint:u(!0)};const a=`AllyHub needs ${L} or newer and is made with ${w}`;if(s.old)return{name:"ffmpeg",ok:!1,detail:`ffmpeg ${s.version} (${t}) is too old: ${a}`,hint:u(!0)};const r=await F(t),i=Object.entries(E).filter(([,n])=>!r.has(n)),d=[...s.pinned?[]:[`Not ${w}: its frames may differ from another computer's. ${u(!1)}`],...i.length>0?[`It cannot render ${i.map(([n,h])=>`${n} (no ${h})`).join(", ")}.`]:[]];return{name:"ffmpeg",ok:r.has("libx264"),detail:`ffmpeg ${s.version} (${t}${o?.from==="env"?", named by ALLYHUB_FFMPEG":""})`,...d.length>0?{hint:d.join(" ")}:{}}}async function _(e){if(!await m().locate("chrome"))return y(e,"chrome");try{const o=await A({gpu:!1}),t=o.product;return await o.close(),{name:"chrome",ok:!0,detail:t}}catch(o){return{name:"chrome",ok:!1,detail:`headless Chrome does not start: ${o.message.split(`
-`)[0]??""}`,hint:"Run allyhub outside the agent's sandbox, or set ALLYHUB_CHROME to another Chrome."}}}function G(e){const o=$(),t=b[e],s=t.reduce((a,r)=>a+o.size(r),0);return t.every(a=>o.locate(a)!==void 0)?`${e}: installed (${c(s)})`:`${e}: not installed (${c(s)} to download, on first use or with --install ${e})`}const B=e=>e.id==="speech"?`with --install ${e.id}; words are heard in the cloud without it`:`on first use or with --install ${e.id}`,S=e=>`${e.id}: ${e.unsupported??(e.installed?`installed (${c(e.bytes)})`:`not installed (${c(e.download)} to download, ${B(e)})`)}`;async function v(e,o,t){const s=[];for(const a of e){if(a==="ffmpeg"||a==="chrome"){const r=m();o?await r.remove(a):(t.progress(`Getting ${a}…`),await r.ensure(a,{signal:t.signal}))}else if(a==="word"||a==="3d"){const r=$();for(const i of b[a])o?await r.remove(i):(t.progress(`Getting ${i}…`),await r.ensure(i,{signal:t.signal}))}else o?await p(()=>P(a)):await p(()=>C(a,{signal:t.signal,onProgress:M(t)}));s.push(`${o?"Removed":"Installed"} ${a}.`)}return s}export const doctor=I({name:"doctor",summary:"What this computer has for AllyHub: Node.js, ffmpeg, headless Chrome, the local models; --install and --remove",input:l.strictObject({install:l.array(l.enum(k)).default([]).describe("Download ahead what a command would on first use: a local pack (speech: speech recognition; people: face tracks and person mattes; reference: OCR and yt-dlp), a package (excel: workbooks; word: Word documents; 3d: building and reading models), ffmpeg or chrome"),remove:l.array(l.enum(k)).default([]).describe("Take them off this computer; a command downloads them again when it needs them")}),output:l.looseObject({ok:l.boolean(),checks:l.array(l.unknown())}),examples:["allyhub doctor","allyhub doctor --install speech"]},async(e,o)=>{const t=[...await v(e.remove,!0,o),...await v(e.install,!1,o)],s=await m().status(),a=n=>s.find(h=>h.name===n),r=[O(),await R(a("ffmpeg")),await _(a("chrome"))],i=await p(()=>N()),d=r.every(n=>n.ok);return{value:{ok:d,checks:r,packs:i,runtimes:s,changed:t},text:[...t,...r.map(n=>`${n.ok?"ok  ":"FAIL"} ${n.name}: ${n.detail}${n.hint===void 0?"":`
-     ${n.hint}`}`),...i.map(n=>`     ${S(n)}`),...["word","3d"].map(n=>`     ${G(n)}`)].join(`
+import{z as l}from"zod";import{startBrowser as A}from"@allyhub/browser";import{LOCAL_PACKS as j,formatBytes as c,installPack as C,localPacks as N,removePack as P}from"@allyhub/media";import{EXIT as g}from"@allyhub/protocol";import{ENCODERS as E,FFMPEG_MINIMUM as L,FFMPEG_PINNED as w,ffmpegEncoders as F,ffmpegHint as p,findFfmpeg as H}from"@allyhub/render";import{createPackages as $,createRuntimes as m}from"@allyhub/runtimes";import{defineCommand as I}from"../command.js";import{media as u,progressLines as M}from"../media.js";const f=[22,19],k=[...j,"word","pages","3d","ffmpeg","chrome"],b={word:["docx"],pages:["pdfjs-dist"],"3d":["manifold-3d","gltf-tools"]};function O(){const[e=0,o=0]=process.versions.node.split(".").map(Number),t=e>f[0]||e===f[0]&&o>=f[1];return{name:"node",ok:t,detail:`Node.js ${process.versions.node}`,...t?{}:{hint:`AllyHub needs Node.js ${f.join(".")} or newer: install it from nodejs.org or with a version manager.`}}}const y=(e,o)=>({name:o,ok:e?.available??!1,detail:e?.available?`not downloaded yet (${c(e.size)} the first time a command needs it, into ${e.dir})`:`AllyHub has no ${o} build for this computer`,...e?.available?{}:{hint:`Set ALLYHUB_${o.toUpperCase()} to one installed here.`}});async function R(e){const o=await m().locate("ffmpeg"),t=o?.bins.ffmpeg;if(t===void 0)return y(e,"ffmpeg");const s=await H(t);if(!s)return{name:"ffmpeg",ok:!1,detail:`${t} does not run`,hint:p(!0)};const a=`AllyHub needs ${L} or newer and is made with ${w}`;if(s.old)return{name:"ffmpeg",ok:!1,detail:`ffmpeg ${s.version} (${t}) is too old: ${a}`,hint:p(!0)};const r=await F(t),i=Object.entries(E).filter(([,n])=>!r.has(n)),d=[...s.pinned?[]:[`Not ${w}: its frames may differ from another computer's. ${p(!1)}`],...i.length>0?[`It cannot render ${i.map(([n,h])=>`${n} (no ${h})`).join(", ")}.`]:[]];return{name:"ffmpeg",ok:r.has("libx264"),detail:`ffmpeg ${s.version} (${t}${o?.from==="env"?", named by ALLYHUB_FFMPEG":""})`,...d.length>0?{hint:d.join(" ")}:{}}}async function _(e){if(!await m().locate("chrome"))return y(e,"chrome");try{const o=await A({gpu:!1}),t=o.product;return await o.close(),{name:"chrome",ok:!0,detail:t}}catch(o){return{name:"chrome",ok:!1,detail:`headless Chrome does not start: ${o.message.split(`
+`)[0]??""}`,hint:"Run allyhub outside the agent's sandbox, or set ALLYHUB_CHROME to another Chrome."}}}function G(e){const o=$(),t=b[e],s=t.reduce((a,r)=>a+o.size(r),0);return t.every(a=>o.locate(a)!==void 0)?`${e}: installed (${c(s)})`:`${e}: not installed (${c(s)} to download, on first use or with --install ${e})`}const B=e=>e.id==="speech"?`with --install ${e.id}; words are heard in the cloud without it`:`on first use or with --install ${e.id}`,S=e=>`${e.id}: ${e.unsupported??(e.installed?`installed (${c(e.bytes)})`:`not installed (${c(e.download)} to download, ${B(e)})`)}`;async function v(e,o,t){const s=[];for(const a of e){if(a==="ffmpeg"||a==="chrome"){const r=m();o?await r.remove(a):(t.progress(`Getting ${a}…`),await r.ensure(a,{signal:t.signal}))}else if(a==="word"||a==="pages"||a==="3d"){const r=$();for(const i of b[a])o?await r.remove(i):(t.progress(`Getting ${i}…`),await r.ensure(i,{signal:t.signal}))}else o?await u(()=>P(a)):await u(()=>C(a,{signal:t.signal,onProgress:M(t)}));s.push(`${o?"Removed":"Installed"} ${a}.`)}return s}export const doctor=I({name:"doctor",summary:"What this computer has for AllyHub: Node.js, ffmpeg, headless Chrome, the local models; --install and --remove",input:l.strictObject({install:l.array(l.enum(k)).default([]).describe("Download ahead what a command would on first use: a local pack (speech: speech recognition; people: face tracks and person mattes; reference: OCR and yt-dlp), a package (excel: workbooks; word: Word documents; pages: a doc's pages in frames; 3d: building and reading models), ffmpeg or chrome"),remove:l.array(l.enum(k)).default([]).describe("Take them off this computer; a command downloads them again when it needs them")}),output:l.looseObject({ok:l.boolean(),checks:l.array(l.unknown())}),examples:["allyhub doctor","allyhub doctor --install speech"]},async(e,o)=>{const t=[...await v(e.remove,!0,o),...await v(e.install,!1,o)],s=await m().status(),a=n=>s.find(h=>h.name===n),r=[O(),await R(a("ffmpeg")),await _(a("chrome"))],i=await u(()=>N()),d=r.every(n=>n.ok);return{value:{ok:d,checks:r,packs:i,runtimes:s,changed:t},text:[...t,...r.map(n=>`${n.ok?"ok  ":"FAIL"} ${n.name}: ${n.detail}${n.hint===void 0?"":`
+     ${n.hint}`}`),...i.map(n=>`     ${S(n)}`),...["word","pages","3d"].map(n=>`     ${G(n)}`)].join(`
 `),exit:d?g.ok:g.failed}});

package/dist/commands/frames/common.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{mkdir as c,readFile as u,stat as p,writeFile as d}from"node:fs/promises";import{dirname as f,extname as a,join as w,resolve as g}from"node:path";import{drawHtml as h}from"@allyhub-next/browser";import{WORK_DIR as x}from"@allyhub-next/formats";import{GridError as l}from"@allyhub-next/media";import{EXIT as o}from"@allyhub-next/protocol";import{lookFormat as b,readPng as $,videoFrame as y,webpPath as v}from"@allyhub-next/render";import{comboKey as F}from"@allyhub-next/video-core";import{CommandError as n}from"../../command.js";export function momentOf(e){const t=e.trim();if(/^@\/?[^@\s]+$/u.test(t))return t;const r=t===""?NaN:Number(t.replace(/s$/u,""));if(!Number.isFinite(r))throw new n("bad-time",`Cannot read the moment "${e}".`,{exit:o.usage,hint:"Write seconds or anchors joined with commas: --at 0.5,3,7.25 or --at @press,@/map (allyhub inspect timeline lists each part's anchors)."});return r}export function secondsOf(e){return e.map(t=>{const r=momentOf(t);if(typeof r=="string")throw new n("bad-time",`${r} is an anchor: a video file's moments are seconds.`,{exit:o.usage});return r})}export const usage=(e,t,r)=>new n(e,t,{exit:o.usage,...r===void 0?{}:{hint:r}});export function gridError(e){return e instanceof l?new n(`grid-${e.code}`,e.message,{exit:o.usage,...e.hint===void 0?{}:{hint:e.hint}}):e}export const comboName=e=>{if(e.id!==void 0)return e.id;const t=F(e.combo);return t==="default"?"":t},withCombo=(e,t)=>{const r=comboName(t);return r===""?e:`${e}.${r}`},secondsName=e=>`${e.toFixed(2)}s`;export function picturePath(e,t,r){return v(t===void 0?r:g(e,t))}export async function save(e,t){return await c(f(e),{recursive:!0}),await d(e,t),e}export const looks=()=>b();export async function drawPage(e,t){const r=(t.pictures??[]).map((s,m)=>({at:pictureUrl(m),body:s,type:P(s)})),i=looks();return h(e,{html:t.html,width:t.width,...t.height===void 0?{}:{height:t.height},format:i,...i==="webp"?{quality:90}:{},mounts:r})}export const pictureUrl=e=>`/pictures/${String(e)}`;const P=e=>e[0]===137&&e[1]===80?"image/png":e.toString("ascii",8,12)==="WEBP"?"image/webp":"image/jpeg";export const isFile=async e=>(await p(e).catch(()=>{}))?.isFile()===!0;export async function readPicture(e){let t;try{t=await u(e)}catch{throw new n("not-found",`Cannot read ${e}.`,{exit:o.notFound})}try{return $(t.toString("ascii",1,4)==="PNG"?t:await y(e,0,1))}catch(r){throw new n("bad-picture",`${e} is not a picture ffmpeg reads: ${r.message}`,{exit:o.usage})}}export const isPicture=e=>[".png",".jpg",".jpeg",".webp",".bmp",".tif",".tiff"].includes(a(e).toLowerCase());const N=new Set(["mp4","mov","webm","m4v","qt","mkv","avi"]);export const isVideo=e=>N.has(a(e).slice(1).toLowerCase()),workPath=(e,...t)=>w(e,x,...t);
+import{mkdir as c,readFile as u,stat as p,writeFile as d}from"node:fs/promises";import{dirname as f,extname as a,join as w,resolve as g}from"node:path";import{drawHtml as h}from"@allyhub/browser";import{WORK_DIR as x}from"@allyhub/formats";import{GridError as l}from"@allyhub/media";import{EXIT as o}from"@allyhub/protocol";import{lookFormat as b,readPng as $,videoFrame as y,webpPath as v}from"@allyhub/render";import{comboKey as F}from"@allyhub/video-core";import{CommandError as n}from"../../command.js";export function momentOf(e){const t=e.trim();if(/^@\/?[^@\s]+$/u.test(t))return t;const r=t===""?NaN:Number(t.replace(/s$/u,""));if(!Number.isFinite(r))throw new n("bad-time",`Cannot read the moment "${e}".`,{exit:o.usage,hint:"Write seconds or anchors joined with commas: --at 0.5,3,7.25 or --at @press,@/map (allyhub inspect timeline lists each part's anchors)."});return r}export function secondsOf(e){return e.map(t=>{const r=momentOf(t);if(typeof r=="string")throw new n("bad-time",`${r} is an anchor: a video file's moments are seconds.`,{exit:o.usage});return r})}export const usage=(e,t,r)=>new n(e,t,{exit:o.usage,...r===void 0?{}:{hint:r}});export function gridError(e){return e instanceof l?new n(`grid-${e.code}`,e.message,{exit:o.usage,...e.hint===void 0?{}:{hint:e.hint}}):e}export const comboName=e=>{if(e.id!==void 0)return e.id;const t=F(e.combo);return t==="default"?"":t},withCombo=(e,t)=>{const r=comboName(t);return r===""?e:`${e}.${r}`},secondsName=e=>`${e.toFixed(2)}s`;export function picturePath(e,t,r){return v(t===void 0?r:g(e,t))}export async function save(e,t){return await c(f(e),{recursive:!0}),await d(e,t),e}export const looks=()=>b();export async function drawPage(e,t){const r=(t.pictures??[]).map((s,m)=>({at:pictureUrl(m),body:s,type:P(s)})),i=looks();return h(e,{html:t.html,width:t.width,...t.height===void 0?{}:{height:t.height},format:i,...i==="webp"?{quality:90}:{},mounts:r})}export const pictureUrl=e=>`/pictures/${String(e)}`;const P=e=>e[0]===137&&e[1]===80?"image/png":e.toString("ascii",8,12)==="WEBP"?"image/webp":"image/jpeg";export const isFile=async e=>(await p(e).catch(()=>{}))?.isFile()===!0;export async function readPicture(e){let t;try{t=await u(e)}catch{throw new n("not-found",`Cannot read ${e}.`,{exit:o.notFound})}try{return $(t.toString("ascii",1,4)==="PNG"?t:await y(e,0,1))}catch(r){throw new n("bad-picture",`${e} is not a picture ffmpeg reads: ${r.message}`,{exit:o.usage})}}export const isPicture=e=>[".png",".jpg",".jpeg",".webp",".bmp",".tif",".tiff"].includes(a(e).toLowerCase());const N=new Set(["mp4","mov","webm","m4v","qt","mkv","avi"]);export const isVideo=e=>N.has(a(e).slice(1).toLowerCase()),workPath=(e,...t)=>w(e,x,...t);

package/dist/commands/frames/compare.js

@@ -1,4 +1,4 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readFile as B}from"node:fs/promises";import{basename as P,dirname as J,extname as j,join as V,resolve as k}from"node:path";import{compareImages as W}from"@allyhub-next/measure";import{filmTimes as _,partOf as q}from"@allyhub-next/project";import{probeVideo as X}from"@allyhub-next/media";import{EXIT as T}from"@allyhub-next/protocol";import{DELIVERY_LEAD as w,cropImage as Y,parseEncode as H,readPng as z,throughEncode as C,videoFrame as K,webp as v,webpPath as y,writePng as x}from"@allyhub-next/render";import{CommandError as D}from"../../command.js";import{isPicture as Q,momentOf as U,readPicture as I,save as b,secondsOf as Z,usage as p,workPath as ee}from"./common.js";function F(e){const n=e.split(",").map(t=>Number(t.trim()));return n.length===4&&n.every(t=>Number.isFinite(t))&&(n[2]??0)>0&&(n[3]??0)>0?n:void 0}async function ne(e,n){const i=[`${e.slice(0,e.length-j(e).length)}.elements.json`,V(J(e),"elements.json")];for(const a of i){let o;try{o=await B(a,"utf8")}catch{continue}const s=JSON.parse(o),d=s[n];if(!d)throw new D("no-element",`${a} has no element ${n}.`,{exit:T.notFound,hint:`Elements: ${Object.keys(s).join(", ")||"none"}.`});return d}throw new D("no-element",`${n} is not a box (x,y,w,h), and there is no elements file beside ${e}.`,{exit:T.notFound,hint:`An element's name is read from ${i.join(" or ")}.`})}const L=(e,n,t)=>{const i=Y(e,n);if(!i)throw p("bad-crop",`The box ${n.join(",")} is outside ${t} (${String(e.width)}×${String(e.height)}).`);return i},M=10,G=e=>Math.round(e*1e3)/1e3;async function te(e,n,t){if((e.at?.length??0)>1)throw p("bad-time","A comparison takes one moment.");if(t){const r=t.timeline,m=e.part===void 0?void 0:q(r,e.part),g=e.at?.[0];if(g===void 0&&!m)throw p("missing-moment","Which moment of the piece? Give --at or --part.");const c=g===void 0?m?.still??0:_([U(g)],r.parts,m)[0]??0;if(c<0||c>r.duration)throw p("bad-time",`${c.toFixed(2)} s is outside ${t.target.piece}, which is ${r.duration.toFixed(2)} s long.`);let f=await t.still(c),$;if(n){const h=Math.round(c*r.fps),l=Math.max(0,h-Math.round(w*r.fps)),S=[];for(let E=l;E<h;E++)S.push(await t.still(E/r.fps));S.push(f),f=await C(S,r.fps,n),$={...n,lead:w,frames:S.length}}return{img:z(f),label:`${t.target.piece}-${c.toFixed(2)}s`,what:{piece:t.target.piece,combo:t.target.combo,format:t.target.format,t:G(c)},...$?{encoded:$}:{}}}const i=k(e.cwd,e.file??"");let a,o=30,s;if(Q(i)){if(e.at!==void 0)throw p("bad-option",`${e.file??""} is a picture: it has no moments.`);a=x(await I(i))}else{const r=await X(i);o=r.fps,s=Z(e.at??["0"])[0]??0;const m=Math.min(Math.round(s*o),Math.max(0,Math.round(r.duration*o)-1));a=await K(i,m,o)}let d;if(n){const r=Array.from({length:Math.round(w*o)+1},()=>a);a=await C(r,o,n),d={...n,lead:w,frames:r.length}}const u=P(i,j(i));return{img:z(a),label:s===void 0?u:`${u}-${s.toFixed(2)}s`,what:{file:i,...s===void 0?{}:{t:G(s)}},...d?{encoded:d}:{}}}export async function comparePictures(e,n){const t=k(e.cwd,e.reference);let i=await I(t);const a={};e.refCrop!==void 0&&(a.reference=F(e.refCrop)??await ne(t,e.refCrop),i=L(i,a.reference,e.reference));const o=e.encode===void 0?void 0:H(e.encode);if(e.encode!==void 0&&!o)throw p("bad-encode",`--encode takes a codec and a bitrate in kbps, h264:<kbps> or hevc:<kbps>, not ${e.encode}.`,"For example --encode hevc:618.");const s=await te(e,o,n);let d=s.img;if(e.crop!==void 0){const l=F(e.crop);if(!l)throw p("bad-crop",`Cannot read --crop ${e.crop}.`,"Write it as x,y,width,height in the candidate's pixels.");a.candidate=l,d=L(d,l,"the candidate")}const{result:u,heatmap:r,side:m,aligned:g}=W(i,d,e.options),c=l=>P(l,j(l)),f=e.out!==void 0?k(e.cwd,e.out):ee(e.root,"compare",`${c(t)}${a.reference&&F(e.refCrop??"")===void 0?`-${e.refCrop??""}`:""}-vs-${s.label}`),$={heatmap:await b(y(`${f}.heatmap.png`),await v(x(r))),side:await b(y(`${f}.side.png`),await v(x(m))),candidate:await b(y(`${f}.candidate.png`),await v(x(g))),json:`${f}.json`},h={reference:t,candidate:s.what,crops:a,...s.encoded?{encode:s.encoded}:{},result:u,files:$};return await b($.json,`${JSON.stringify(h,null,2)}
+import{readFile as B}from"node:fs/promises";import{basename as P,dirname as J,extname as j,join as V,resolve as k}from"node:path";import{compareImages as W}from"@allyhub/measure";import{filmTimes as _,partOf as q}from"@allyhub/project";import{probeVideo as X}from"@allyhub/media";import{EXIT as T}from"@allyhub/protocol";import{DELIVERY_LEAD as w,cropImage as Y,parseEncode as H,readPng as z,throughEncode as C,videoFrame as K,webp as v,webpPath as y,writePng as x}from"@allyhub/render";import{CommandError as D}from"../../command.js";import{isPicture as Q,momentOf as U,readPicture as I,save as b,secondsOf as Z,usage as p,workPath as ee}from"./common.js";function F(e){const n=e.split(",").map(t=>Number(t.trim()));return n.length===4&&n.every(t=>Number.isFinite(t))&&(n[2]??0)>0&&(n[3]??0)>0?n:void 0}async function ne(e,n){const i=[`${e.slice(0,e.length-j(e).length)}.elements.json`,V(J(e),"elements.json")];for(const a of i){let o;try{o=await B(a,"utf8")}catch{continue}const s=JSON.parse(o),d=s[n];if(!d)throw new D("no-element",`${a} has no element ${n}.`,{exit:T.notFound,hint:`Elements: ${Object.keys(s).join(", ")||"none"}.`});return d}throw new D("no-element",`${n} is not a box (x,y,w,h), and there is no elements file beside ${e}.`,{exit:T.notFound,hint:`An element's name is read from ${i.join(" or ")}.`})}const L=(e,n,t)=>{const i=Y(e,n);if(!i)throw p("bad-crop",`The box ${n.join(",")} is outside ${t} (${String(e.width)}×${String(e.height)}).`);return i},M=10,G=e=>Math.round(e*1e3)/1e3;async function te(e,n,t){if((e.at?.length??0)>1)throw p("bad-time","A comparison takes one moment.");if(t){const r=t.timeline,m=e.part===void 0?void 0:q(r,e.part),g=e.at?.[0];if(g===void 0&&!m)throw p("missing-moment","Which moment of the piece? Give --at or --part.");const c=g===void 0?m?.still??0:_([U(g)],r.parts,m)[0]??0;if(c<0||c>r.duration)throw p("bad-time",`${c.toFixed(2)} s is outside ${t.target.piece}, which is ${r.duration.toFixed(2)} s long.`);let f=await t.still(c),$;if(n){const h=Math.round(c*r.fps),l=Math.max(0,h-Math.round(w*r.fps)),S=[];for(let E=l;E<h;E++)S.push(await t.still(E/r.fps));S.push(f),f=await C(S,r.fps,n),$={...n,lead:w,frames:S.length}}return{img:z(f),label:`${t.target.piece}-${c.toFixed(2)}s`,what:{piece:t.target.piece,combo:t.target.combo,format:t.target.format,t:G(c)},...$?{encoded:$}:{}}}const i=k(e.cwd,e.file??"");let a,o=30,s;if(Q(i)){if(e.at!==void 0)throw p("bad-option",`${e.file??""} is a picture: it has no moments.`);a=x(await I(i))}else{const r=await X(i);o=r.fps,s=Z(e.at??["0"])[0]??0;const m=Math.min(Math.round(s*o),Math.max(0,Math.round(r.duration*o)-1));a=await K(i,m,o)}let d;if(n){const r=Array.from({length:Math.round(w*o)+1},()=>a);a=await C(r,o,n),d={...n,lead:w,frames:r.length}}const u=P(i,j(i));return{img:z(a),label:s===void 0?u:`${u}-${s.toFixed(2)}s`,what:{file:i,...s===void 0?{}:{t:G(s)}},...d?{encoded:d}:{}}}export async function comparePictures(e,n){const t=k(e.cwd,e.reference);let i=await I(t);const a={};e.refCrop!==void 0&&(a.reference=F(e.refCrop)??await ne(t,e.refCrop),i=L(i,a.reference,e.reference));const o=e.encode===void 0?void 0:H(e.encode);if(e.encode!==void 0&&!o)throw p("bad-encode",`--encode takes a codec and a bitrate in kbps, h264:<kbps> or hevc:<kbps>, not ${e.encode}.`,"For example --encode hevc:618.");const s=await te(e,o,n);let d=s.img;if(e.crop!==void 0){const l=F(e.crop);if(!l)throw p("bad-crop",`Cannot read --crop ${e.crop}.`,"Write it as x,y,width,height in the candidate's pixels.");a.candidate=l,d=L(d,l,"the candidate")}const{result:u,heatmap:r,side:m,aligned:g}=W(i,d,e.options),c=l=>P(l,j(l)),f=e.out!==void 0?k(e.cwd,e.out):ee(e.root,"compare",`${c(t)}${a.reference&&F(e.refCrop??"")===void 0?`-${e.refCrop??""}`:""}-vs-${s.label}`),$={heatmap:await b(y(`${f}.heatmap.png`),await v(x(r))),side:await b(y(`${f}.side.png`),await v(x(m))),candidate:await b(y(`${f}.candidate.png`),await v(x(g))),json:`${f}.json`},h={reference:t,candidate:s.what,crops:a,...s.encoded?{encode:s.encoded}:{},result:u,files:$};return await b($.json,`${JSON.stringify(h,null,2)}
 `),h}const N=e=>Math.round(e*10)/10,O=(e,n=!1)=>{const t=i=>n&&i>0?`+${String(N(i))}`:String(N(i));return`luma ${t(e.luma.mean)} (p5 ${t(e.luma.p5)}, p50 ${t(e.luma.p50)}, p95 ${t(e.luma.p95)}), RGB ${e.rgb.map(t).join("/")}, L*a*b* ${e.lab.map(t).join("/")}`},R=e=>e===void 0?"no flat block":`sd ${String(e.sd)} levels (amount ${String(e.amount)}), neighbours ${String(e.correlation)} alike (size ${String(e.size)}), ${String(e.blocks)} of ${String(e.of)} blocks`,A=e=>e.p25===void 0?"no edges":`p25 ${String(e.p25)} px, median ${String(e.median)} px (${String(e.edges)} edges)`;export function compareText(e){const n=e.result,t=e.candidate,i=`${t.piece??t.file??""}${t.t===void 0?"":` at ${t.t.toFixed(2)} s`}`;return[`${e.reference}${e.crops.reference?` [${e.crops.reference.join(",")}]`:""} vs ${i}${e.crops.candidate?` [${e.crops.candidate.join(",")}]`:""}${e.encode?`, through ${e.encode.codec} at ${String(e.encode.kbps)} kbps (${String(e.encode.frames)} frames)`:""}`,`Reference ${String(n.reference.width)}×${String(n.reference.height)}, candidate ${String(n.candidate.width)}×${String(n.candidate.height)}${n.resized?`, resized (${n.resized.mode}) to ${n.resized.to.join("×")}, scale ${n.resized.scale.join(" × ")}`:""}; compared ${String(n.compared[2])}×${String(n.compared[3])} at offset ${String(n.offset.x)},${String(n.offset.y)}.`,...n.search?[`Offset search ±${String(n.search.range)} px: mean ΔE ${String(n.search.unshifted)} unshifted, ${String(n.search.best.meanDeltaE)} at ${String(n.search.best.x)},${String(n.search.best.y)}.`]:[],`Differing (ΔE > ${String(n.tolerance)}): ${String(n.differing)} of ${String(n.pixels)} pixels, ${n.pixels?(n.differing/n.pixels*100).toPrecision(3):"0"} %.`,`ΔE*ab mean ${String(n.deltaE.mean)}, p95 ${String(n.deltaE.p95)}, max ${String(n.deltaE.max)}; channels mean/max R ${String(n.channels.r.mean)}/${String(n.channels.r.max)} G ${String(n.channels.g.mean)}/${String(n.channels.g.max)} B ${String(n.channels.b.mean)}/${String(n.channels.b.max)} alpha ${String(n.channels.alpha.mean)}/${String(n.channels.alpha.max)}; SSIM ${String(n.ssim)}.`,`Levels (0–255 as encoded; L*a*b*): reference ${O(n.levels.reference)}; candidate ${O(n.levels.candidate)}; candidate less reference ${O(n.levels.difference,!0)}.`,`Grain where flat (${String(n.grain.share*100)} % of ${String(n.grain.block)} px blocks): reference ${R(n.grain.reference)}; candidate ${R(n.grain.candidate)}${n.grain.amount!==void 0?`; capture.grain.amount ${String(n.grain.amount)} added to the candidate's gives the reference's`:""}.`,`Edges (10–90 % rise of steps over ${String(n.edges.step)} levels within ${String(n.edges.span)} px): reference ${A(n.edges.reference)}, candidate ${A(n.edges.candidate)}${n.edges.soften!==void 0?`; capture.soften ${String(n.edges.soften)} (at 1080 lines) widens the candidate's sharper quarter to the reference's`:""}.`,`${String(n.regions.length)} region${n.regions.length===1?"":"s"}${n.regions.length>M?` (the ${String(M)} largest; --json has every one)`:""}:`,...n.regions.slice(0,M).map(a=>`  ${a.box.join(",")}  ${String(a.pixels)} px, ΔE mean ${String(a.meanDeltaE)}, max ${String(a.maxDeltaE)}`),e.files.side,e.files.heatmap].join(`
 `)}

package/dist/commands/frames/cuts.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{mkdtemp as _,readdir as b,rm as y,rmdir as v}from"node:fs/promises";import{tmpdir as H}from"node:os";import{join as c,resolve as U}from"node:path";import{decodeMono as $}from"@allyhub-next/audio/node";import{CUT_REVIEW_DEFAULTS as E,CUT_SHEET_WIDTH as M,cutSheetHtml as k,filmWords as D,listCuts as I,partFolder as P,reviewCuts as W,sceneryCuts as A}from"@allyhub-next/measure";import{partOf as R}from"@allyhub-next/project";import{mixSound as j,webpPath as B}from"@allyhub-next/render";import{drawPage as L,pictureUrl as O,save as V,usage as q,withCombo as z,workPath as G}from"./common.js";const d=48e3,J=/^cut-\d+-.*\.(?:png|webp)$/u;async function T(r,t){let a;try{a=await b(r,{withFileTypes:!0})}catch{return}for(const i of a){const o=c(r,i.name);i.isFile()&&J.test(i.name)?await y(o):t&&i.isDirectory()&&(await T(o,!1),(await b(o)).length===0&&await v(o))}}export async function cutSheets(r,t){if(r.target.output!=="video")throw q("not-video",`${r.target.piece} is not a video: it has no cuts.`);const a=r.timeline;t.part!==void 0&&R(a,t.part);const i=I(a,r.prepared.media,await A(r.version)),o=i.filter(e=>t.part===void 0||e.part===t.part||e.previous===t.part),l=D(await r.version.stage.lines()),w=await _(c(H(),"allyhub-cuts-"));let f;try{const e=c(w,"mix.wav");await j({timeline:a,sound:await r.sound(),out:e}),f=await $(e,d)}finally{await y(w,{recursive:!0,force:!0})}const x=Math.round(a.duration*a.fps),u=W({all:i,cuts:o,fps:a.fps,frames:x,samples:f,rate:d,words:l,cues:a.cues,options:t.review}),h=G(t.root,"cuts",r.target.piece,z(r.target.output,r.target)),m=t.out!==void 0?U(t.cwd,t.out):t.part===void 0?h:c(h,P(t.part));await T(m,t.out===void 0&&t.part===void 0);const g=new Map;for(const e of new Set(u.flatMap(n=>n.frames.map(p=>p.n))))g.set(e,await r.still(Math.min(e/a.fps,a.duration)));const C=Math.max(1,...u.map(e=>e.frames.length)),S=[];for(const e of u){const n=e.frames.map(s=>g.get(s.n)??Buffer.alloc(0)),p=k({review:e,total:i.length,others:i.filter(s=>s.t!==e.t&&Math.abs(s.t-e.t)<(t.review.span??E.span)).map(s=>s.t),samples:f,rate:d,words:l,aspect:a.width/a.height,width:M,perStrip:C,picture:s=>O(e.frames.findIndex(F=>F.n===s)),options:t.review});S.push(await V(B(c(m,`cut-${String(e.index).padStart(2,"0")}-${e.t.toFixed(2)}s.png`)),await L(r.session.browser,{html:p,width:M,pictures:n})))}return{piece:r.target.piece,combo:r.target.combo,format:r.target.format,out:m,...t.part===void 0?{}:{part:t.part},total:i.length,threshold:t.review.threshold??E.threshold,cuts:u.map((e,n)=>({...e,frames:e.frames.map(p=>Math.round(p.t*1e3)/1e3),sheet:S[n]??""}))}}
+import{mkdtemp as _,readdir as b,rm as y,rmdir as v}from"node:fs/promises";import{tmpdir as H}from"node:os";import{join as c,resolve as U}from"node:path";import{decodeMono as $}from"@allyhub/audio/node";import{CUT_REVIEW_DEFAULTS as E,CUT_SHEET_WIDTH as M,cutSheetHtml as k,filmWords as D,listCuts as I,partFolder as P,reviewCuts as W,sceneryCuts as A}from"@allyhub/measure";import{partOf as R}from"@allyhub/project";import{mixSound as j,webpPath as B}from"@allyhub/render";import{drawPage as L,pictureUrl as O,save as V,usage as q,withCombo as z,workPath as G}from"./common.js";const d=48e3,J=/^cut-\d+-.*\.(?:png|webp)$/u;async function T(r,t){let a;try{a=await b(r,{withFileTypes:!0})}catch{return}for(const i of a){const o=c(r,i.name);i.isFile()&&J.test(i.name)?await y(o):t&&i.isDirectory()&&(await T(o,!1),(await b(o)).length===0&&await v(o))}}export async function cutSheets(r,t){if(r.target.output!=="video")throw q("not-video",`${r.target.piece} is not a video: it has no cuts.`);const a=r.timeline;t.part!==void 0&&R(a,t.part);const i=I(a,r.prepared.media,await A(r.version)),o=i.filter(e=>t.part===void 0||e.part===t.part||e.previous===t.part),l=D(await r.version.stage.lines()),w=await _(c(H(),"allyhub-cuts-"));let f;try{const e=c(w,"mix.wav");await j({timeline:a,sound:await r.sound(),out:e}),f=await $(e,d)}finally{await y(w,{recursive:!0,force:!0})}const x=Math.round(a.duration*a.fps),u=W({all:i,cuts:o,fps:a.fps,frames:x,samples:f,rate:d,words:l,cues:a.cues,options:t.review}),h=G(t.root,"cuts",r.target.piece,z(r.target.output,r.target)),m=t.out!==void 0?U(t.cwd,t.out):t.part===void 0?h:c(h,P(t.part));await T(m,t.out===void 0&&t.part===void 0);const g=new Map;for(const e of new Set(u.flatMap(n=>n.frames.map(p=>p.n))))g.set(e,await r.still(Math.min(e/a.fps,a.duration)));const C=Math.max(1,...u.map(e=>e.frames.length)),S=[];for(const e of u){const n=e.frames.map(s=>g.get(s.n)??Buffer.alloc(0)),p=k({review:e,total:i.length,others:i.filter(s=>s.t!==e.t&&Math.abs(s.t-e.t)<(t.review.span??E.span)).map(s=>s.t),samples:f,rate:d,words:l,aspect:a.width/a.height,width:M,perStrip:C,picture:s=>O(e.frames.findIndex(F=>F.n===s)),options:t.review});S.push(await V(B(c(m,`cut-${String(e.index).padStart(2,"0")}-${e.t.toFixed(2)}s.png`)),await L(r.session.browser,{html:p,width:M,pictures:n})))}return{piece:r.target.piece,combo:r.target.combo,format:r.target.format,out:m,...t.part===void 0?{}:{part:t.part},total:i.length,threshold:t.review.threshold??E.threshold,cuts:u.map((e,n)=>({...e,frames:e.frames.map(p=>Math.round(p.t*1e3)/1e3),sheet:S[n]??""}))}}

package/dist/commands/frames/doc.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as u,stat as m}from"node:fs/promises";import{basename as l,dirname as g,join as c,relative as f,resolve as w}from"node:path";import{everyBlock as h,parseDoc as y}from"@allyhub/doc";import{CheckSession as k,docStills as x}from"@allyhub/project";import{EXIT as P}from"@allyhub/protocol";import{DocPageError as $,docPages as b}from"@allyhub/render/doc";import{CommandError as v}from"../../command.js";import{looks as E,picturePath as F,save as S,usage as j,workPath as C}from"./common.js";const d="doc.mdx";export async function findDoc(e,r,s){const n=w(r,s);for(const a of[l(n)===d?n:c(n,d),c(e,s,d)])if((await m(a).catch(()=>{}))?.isFile())return a}export function pagesOf(e){const r=[];for(const s of e.split(",")){const n=/^\s*(\d+)\s*(?:-\s*(\d+)\s*)?$/u.exec(s),a=Number(n?.[1]),t=n?.[2]===void 0?a:Number(n[2]);if(!n||a<1||t<a)throw j("bad-page",`Cannot read the pages "${e}".`,"Write pages from 1, joined with commas: --page 2, --page 2-4, --page 1,5.");for(let o=a;o<=t;o++)r.push(o)}return r}async function D(e,r,s){const n=await u(r,"utf8"),a=o=>o.type==="component"||o.type==="chart"&&o.data!==void 0;if(![...h(y(n).blocks)].some(a))return{};const t=await k.open({root:e});try{const o=t.prepared.docs.find(i=>i.place===s);return o?{stills:o.components.length===0?void 0:await x(o,{prepared:t.prepared,gpu:t.gpu,withSession:i=>i(t)}),data:o.data}:{}}finally{await t.close()}}export async function docPicture(e){const r=f(e.root,g(e.file)),s=e.page===void 0?void 0:pagesOf(e.page),{stills:n,data:a}=await D(e.root,e.file,r);let t;try{t=await b({root:e.root,doc:{file:f(e.root,e.file),dir:r,path:r,...a===void 0?{}:{data:a}},pages:s,stills:n,format:E(),onFetch:()=>{e.progress?.("Getting pdf.js, once, to draw a doc's pages…")}})}catch(i){throw i instanceof $?new v("not-found",i.message,{exit:P.notFound,hint:`Pages are 1 to ${String(i.count)}.`}):i}const o=s===void 0?"pages":`page-${e.page?.replace(/[^\d]+/gu,"-")??""}`,p=await S(F(e.cwd,e.out,c(C(e.root,"frames",r),`${o}.png`)),t.picture);return{mode:"frame",source:"doc",doc:r,out:p,pages:t.count,paper:t.paper,drawn:t.drawn}}