allyhub 0.2.0-next.4 → 0.2.0

package/dist/commands/cloud-tools.js

@@ -1,12 +1,11 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readFile as H}from"node:fs/promises";import{join as U,resolve as R}from"node:path";import{z as a}from"zod";import{callTool as B,findTool as C,loadCatalog as h,priceCalls as F,priceText as j,resumeJob as K,uploadFiles as _}from"@allyhub-next/cloud";import{WORK_DIR as G}from"@allyhub-next/formats";import{EXIT as $}from"@allyhub-next/protocol";import{CommandError as b,defineCommand as w}from"../command.js";import{optionName as P}from"../args.js";import{chargeOf as z}from"../charge.js";import{commandHelp as X}from"../help.js";import{requiredMissing as Q,toolInput as V,toolOptions as Y}from"../tool-options.js";import{cloudOf as p,cloudWork as f,placeFrom as Z,plural as y}from"./cloud.js";const ee=8e3,d={input:a.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"),quote:a.boolean().default(!1).describe("Say what a call with this input would cost, calling nothing and charging nothing"),file:a.string().optional().describe("The path of the file it makes (without an extension it takes the result's); 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:a.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:a.boolean().default(!0).describe("Wait for a long tool (an audit, a video model); --no-wait returns its call at once"),resume:a.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,t)=>new b("usage",e,{exit:$.usage,...t===void 0?{}:{hint:t}}),I=e=>{const t=e.reduce((n,r)=>r.map((s,i)=>Math.max(n[i]??0,s.length)),[]);return e.map(n=>`  ${n.map((r,s)=>s===n.length-1?r:r.padEnd(t[s]??0)).join("  ")}`.trimEnd())};function W(e){return w({name:e.id,summary:`${e.title}: ${e.description} Lists the tools, each a command`,input:a.strictObject({fresh:a.boolean().default(!1).describe("Read the catalog from AllyHub again, not the copy kept an hour")}),output:a.looseObject({work:a.string(),tools:a.array(a.looseObject({name:a.string()}))}),examples:[`allyhub ${e.id}`,`allyhub ${e.id} --json`]},(t,n)=>f(async()=>{const s=(await h(p(n),{refresh:t.fresh})).tools.filter(i=>i.work===e.id).sort((i,o)=>i.name.localeCompare(o.name));return{value:{work:e.id,title:e.title,tools:s.map(i=>({name:i.name,title:i.title,description:i.description,price:j(i.price),long:i.long}))},text:[`${e.title} (${y(s.length,"tool")}):`,...I(s.map(i=>[i.name,i.title,j(i.price)])),"",`Each costs credits when it worked; a failed call is free. allyhub help ${e.id} <tool> shows a tool's options; --quote prices a call first.`].join(`
-`)}}))}const g=e=>new Intl.NumberFormat("en-US",{maximumFractionDigits:4}).format(e),D=e=>`${e.estimated?`about ${new Intl.NumberFormat("en-US",{maximumFractionDigits:2}).format(e.credits)}`:g(e.credits)} credits`,O=e=>e.map(t=>`\`${t}\``).join(", ");function te(e){if(!e.unknown)return D(e);const t=e.dependsOn.length?`on ${O(e.dependsOn)}`:"on what the call counts";return e.credits>0?`${D(e)}, and more that depends ${t}`:`the total depends ${t} (not known before the call)`}function ne(e){return e.lines.map(t=>{if(t.what==="per call")return`  per call: ${g(t.credits)}`;const n=t.rate===void 0?"a rate by its settings":`${g(t.rate)} credits per ${t.per}${t.label?` ${t.label}`:""}`,r=[...t.assumed.length?[`${O(t.assumed)} not given: the provider's default`]:[],...t.typical&&t.field!==void 0?[`\`${t.field}\` not given: counted as ${g(t.units)}`]:[]],s=r.length?` (${r.join("; ")})`:"";if(!t.unknown)return`  ${t.what} × ${n}${s} = ${g(t.credits)}${t.estimated?", estimated":""}`;const i=t.dependsOn.length?`it depends on ${O(t.dependsOn)}`:"counted by the call";return`  ${t.what} × ${n}${s}: not in the total, ${i}`})}function ie(e,t=5,n=160){const r=i=>{const o=i===void 0?"undefined":JSON.stringify(i);return o.length>n?`${o.slice(0,n-1)}…`:o},s=(i,o)=>[`${i?`${i}: `:""}${y(o.length,"item")}${o.length>t?`, the first ${String(t)}:`:":"}`,...o.slice(0,t).map((l,u)=>`  [${String(u)}] ${r(l)}`)];return Array.isArray(e)?s("",e):typeof e!="object"||e===null?[r(e)]:Object.entries(e).flatMap(([i,o])=>Array.isArray(o)?s(i,o):[`${i}: ${r(o)}`])}function J(e,t){if("jobId"in e)return[`${e.tool} is still working (call ${e.jobId}).`,`Wait for it: allyhub ${t} --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 n=JSON.stringify(e.output,null,2);return[n.length<=ee?n:[`Output: ${String(Math.round(Buffer.byteLength(n)/1024))} KB of JSON, in short (--json prints it whole):`,...ie(e.output)].join(`
-`),...e.file?[`File: ${e.file}${e.replaced?" (replaced: it was made from another input)":""}`]:[],...e.words?[`Words: ${e.words} (when each word is said: a part can say a stretch of the file)`]:[],...e.gen?[`Record: ${e.gen} (move it with the file)`]:[],`Credits used: ${e.credits===void 0?"not reported":String(e.credits)}`].join(`
-`)}const oe=e=>{const t=Math.max(0,Math.round(e));return`${String(Math.floor(t/60))}:${String(t%60).padStart(2,"0")}`},ae=e=>e!==null&&typeof e=="object"&&!Array.isArray(e);async function se(e,t){const n=e.trim().startsWith("{"),r=n?e:await H(R(t.cwd,e),"utf8").catch(i=>{throw new b("not-found",`--input: cannot read ${e}: ${i.message}`,{exit:$.notFound,hint:"Give a JSON object, or a file of one."})});let s;try{s=JSON.parse(r)}catch{s=void 0}if(!ae(s))throw k(`--input: ${n?"the text":e} is not a JSON object.`,`Give '{"field": …}', or a file of it.`);return s}export function toolCommand(e){const t=`${e.work} ${e.name}`,n=Y(e.input,Object.keys(d)),r=a.strictObject({...n.shape,...d,input:d.input.describe(n.inputOnly.length?`${d.input.description??""}. Fields only it gives: ${n.inputOnly.join(", ")}`:d.input.description??"")}),s=j(e.price),i=[...n.fields].filter(([,o])=>n.required.includes(o)).map(([o,l])=>`--${P(o)} <${l}>`);return{spec:{name:t,summary:e.description,input:r,output:a.looseObject({tool:a.string(),output:a.record(a.string(),a.unknown()).optional(),credits:a.number().optional(),file:a.string().optional(),gen:a.string().optional(),words:a.string().optional(),jobId:a.string().optional(),quote:a.looseObject({credits:a.number()}).nullable().optional()}),examples:[`allyhub ${[t,...i,"--quote"].join(" ")}`,`allyhub ${[t,...i].join(" ")}`]},about:{lines:[e.title,"",`Costs ${s}. A call is charged once, when it worked; a failed call is free. --quote prices an input first, charging nothing.`,...e.long?["A long tool: the command waits for it (--no-wait returns its call, --resume waits again)."]:[]],value:{work:e.work,title:e.title,price:s,priceRule:e.price,long:e.long,inputSchema:e.input,outputSchema:e.output}},run:(o,l)=>f(async()=>{const u=o,E=o,v=p(l),S=await Z(l),m=V(n,E,u.input===void 0?{}:await se(u.input,l));let A=0;const q={base:S,signal:l.signal,onRunning:c=>{Date.now()-A<3e4||(A=Date.now(),l.progress(`${e.name}: working · ${oe((Date.now()-Date.parse(c.createdAt))/1e3)} (call ${c.id})`))},onRetry:(c,L,M)=>{l.progress(`${e.name}: ${L.message}; reading call ${c} again in ${String(M)} s`)}};if(u.resume!==void 0){if(Object.keys(m).length>0||u.quote||u.file!==void 0)throw k("--resume waits for a call as it was made: give it no input, --quote or --file.");const c=await K(v,u.resume,{...q,tool:e.name});return{value:{...c},text:J(c,t)}}if(u.quote){const c=F(e.price,e.input,[m]).calls[0];if(!c)throw new Error("No quote.");return{value:{tool:e.name,quote:c},text:[`A call${Object.keys(m).length===0?" with the defaults":""}: ${te(c)}`,...ne(c),...e.price.quote?[`The price: ${s}.`]:c.estimated?["Estimated parts are charged by what the call returns."]:[],"A call is charged once, when it worked; a failed call is free."].join(`
-`)}}const N=Q(n,m);if(N.length>0)throw k(`${e.name} needs ${N.join(", ")}.`,`allyhub help ${t} shows its options.`);const x=l.approve,T=await B(v,e.name,m,{...q,...x===void 0?{}:{approve:()=>{const c=F(e.price,e.input,[m]).calls[0];return c===void 0?Promise.resolve(!0):x(z(t,e.title,c))}},outDir:U(S,G,e.work,e.name),...u.file===void 0?{}:{file:R(l.cwd,u.file)},force:u.force,wait:u.wait});return{value:{...T},text:J(T,t)}})}}const re=e=>h(p(e)).catch(()=>{});export const CLOUD_SOURCE={entries:[{name:"<work>",summary:"List a work's cloud tools (AllyHub's catalog), a line each with its price; allyhub help lists the works"},{name:"<work> <tool>",summary:"Run a cloud tool with the account's credits, its input as options (allyhub help <work> <tool>); --quote prices it first"}],async nouns(e){return(await h(p(e))).works.map(n=>({name:n.id,summary:`${n.title}: ${n.description}`}))},resolve:(e,t)=>f(async()=>{const[n,r]=e;if(n===void 0||n.startsWith("-"))return;let s=await re(t),i=s?.works.find(l=>l.id===n);if(i||(s=await h(p(t),{refresh:!0}).catch(()=>s),i=s?.works.find(l=>l.id===n)),!s||!i)return;if(r===void 0||r.startsWith("-"))return{command:W(i),rest:e.slice(1),list:!0};const o=s.tools.find(l=>l.name===r);if(o?.work!==i.id)throw new b("unknown-tool",o?`${r} is not a ${i.id} tool: it is in allyhub ${o.work}.`:`No ${i.id} tool ${r}.`,{exit:$.notFound,hint:o?`allyhub ${o.work} ${r}`:`allyhub ${i.id} lists its tools.`});return{command:toolCommand(o),rest:e.slice(2),list:!1}})},upload=w({name:"upload",summary:"Upload files from this computer for a cloud tool whose input takes a URL (a presenter photo, speech audio, a reference clip), and print a signed URL for each, which works for a few hours",input:a.strictObject({files:a.array(a.string()).min(1).describe("The files: images (.jpg, .png, .webp, .gif), sound (.mp3, .wav, .m4a, .aac, .ogg, .flac) or video (.mp4, .mov, .webm), 50 MB at most")}),positional:["files"],output:a.looseObject({files:a.array(a.looseObject({file:a.string(),ok:a.boolean(),url:a.string().optional()}))}),examples:["allyhub upload assets/media/presenter.jpg"]},(e,t)=>f(async()=>{const n=await _(p(t),e.files,{base:t.cwd}),r=n.filter(o=>!o.ok),s=n.map(o=>o.ok?`${o.file}
+import{readFile as I}from"node:fs/promises";import{join as D,resolve as x}from"node:path";import{z as n}from"zod";import{callTool as F,findTool as N,loadCatalog as p,resumeJob as L,uploadFiles as M}from"@allyhub-next/cloud";import{WORK_DIR as E}from"@allyhub-next/formats";import{EXIT as h}from"@allyhub-next/protocol";import{CommandError as w,defineCommand as m}from"../command.js";import{optionName as H}from"../args.js";import{commandHelp as U}from"../help.js";import{requiredMissing as B,toolInput as K,toolOptions as _}from"../tool-options.js";import{cloudOf as u,cloudWork as f,placeFrom as q,plural as g}from"./cloud.js";const G=8e3,c={input:n.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:n.string().optional().describe("The path of the file it makes (without an extension it takes the result's); 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:n.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:n.boolean().default(!0).describe("Wait for a long tool (an audit, a video model); --no-wait returns its call at once"),resume:n.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")},$=(t,a)=>new w("usage",t,{exit:h.usage,...a===void 0?{}:{hint:a}}),R=t=>{const a=t.reduce((e,r)=>r.map((s,i)=>Math.max(e[i]??0,s.length)),[]);return t.map(e=>`  ${e.map((r,s)=>s===e.length-1?r:r.padEnd(a[s]??0)).join("  ")}`.trimEnd())};function T(t){return m({name:t.id,summary:`${t.title}: ${t.description} Lists the tools, each a command`,input:n.strictObject({fresh:n.boolean().default(!1).describe("Read the catalog from AllyHub again, not the copy kept an hour")}),output:n.looseObject({work:n.string(),tools:n.array(n.looseObject({name:n.string()}))}),examples:[`allyhub ${t.id}`,`allyhub ${t.id} --json`]},(a,e)=>f(async()=>{const s=(await p(u(e),{refresh:a.fresh})).tools.filter(i=>i.work===t.id).sort((i,o)=>i.name.localeCompare(o.name));return{value:{work:t.id,title:t.title,tools:s.map(i=>({name:i.name,title:i.title,description:i.description,long:i.long}))},text:[`${t.title} (${g(s.length,"tool")}):`,...R(s.map(i=>[i.name,i.title])),"",`Each costs credits when it worked; a failed call is free. allyhub help ${t.id} <tool> shows a tool's options and how its credits are counted.`].join(`
+`)}}))}function z(t,a=5,e=160){const r=i=>{const o=i===void 0?"undefined":JSON.stringify(i);return o.length>e?`${o.slice(0,e-1)}…`:o},s=(i,o)=>[`${i?`${i}: `:""}${g(o.length,"item")}${o.length>a?`, the first ${String(a)}:`:":"}`,...o.slice(0,a).map((l,b)=>`  [${String(b)}] ${r(l)}`)];return Array.isArray(t)?s("",t):typeof t!="object"||t===null?[r(t)]:Object.entries(t).flatMap(([i,o])=>Array.isArray(o)?s(i,o):[`${i}: ${r(o)}`])}function W(t,a){if("jobId"in t)return[`${t.tool} is still working (call ${t.jobId}).`,`Wait for it: allyhub ${a} --resume ${t.jobId}${t.file===void 0?"":" (or the same command again: it waits for this call)"}`].join(`
+`);if(t.kept)return[`Kept ${t.file??""}: ${t.tool} made it from this same input on ${t.kept.at} (${t.gen??""}).`,"Nothing was called or charged. --force makes it again."].join(`
+`);const e=JSON.stringify(t.output,null,2);return[e.length<=G?e:[`Output: ${String(Math.round(Buffer.byteLength(e)/1024))} KB of JSON, in short (--json prints it whole):`,...z(t.output)].join(`
+`),...t.file?[`File: ${t.file}${t.replaced?" (replaced: it was made from another input)":""}`]:[],...t.words?[`Words: ${t.words} (when each word is said: a part can say a stretch of the file)`]:[],...t.gen?[`Record: ${t.gen} (move it with the file)`]:[],`Credits used: ${t.credits===void 0?"not reported":String(t.credits)}`].join(`
+`)}const P=t=>{const a=Math.max(0,Math.round(t));return`${String(Math.floor(a/60))}:${String(a%60).padStart(2,"0")}`},X=t=>t!==null&&typeof t=="object"&&!Array.isArray(t);async function Q(t,a){const e=t.trim().startsWith("{"),r=e?t:await I(x(a.cwd,t),"utf8").catch(i=>{throw new w("not-found",`--input: cannot read ${t}: ${i.message}`,{exit:h.notFound,hint:"Give a JSON object, or a file of one."})});let s;try{s=JSON.parse(r)}catch{s=void 0}if(!X(s))throw $(`--input: ${e?"the text":t} is not a JSON object.`,`Give '{"field": …}', or a file of it.`);return s}export function toolCommand(t){const a=`${t.work} ${t.name}`,e=_(t.input,Object.keys(c)),r=n.strictObject({...e.shape,...c,input:c.input.describe(e.inputOnly.length?`${c.input.description??""}. Fields only it gives: ${e.inputOnly.join(", ")}`:c.input.description??"")}),s=[...e.fields].filter(([,i])=>e.required.includes(i)).map(([i,o])=>`--${H(i)} <${o}>`);return{spec:{name:a,summary:t.description,input:r,output:n.looseObject({tool:n.string(),output:n.record(n.string(),n.unknown()).optional(),credits:n.number().optional(),file:n.string().optional(),gen:n.string().optional(),words:n.string().optional(),jobId:n.string().optional()}),examples:[`allyhub ${[a,...s].join(" ")}`]},about:{lines:[t.title,"","A call is charged once, when it worked, as the description says; a failed call is free.",...t.long?["A long tool: the command waits for it (--no-wait returns its call, --resume waits again)."]:[]],value:{work:t.work,title:t.title,long:t.long,inputSchema:t.input,outputSchema:t.output}},run:(i,o)=>f(async()=>{const l=i,b=i,k=u(o),j=await q(o),y=K(e,b,l.input===void 0?{}:await Q(l.input,o));let O=0;const S={base:j,signal:o.signal,onRunning:d=>{Date.now()-O<3e4||(O=Date.now(),o.progress(`${t.name}: working · ${P((Date.now()-Date.parse(d.createdAt))/1e3)} (call ${d.id})`))},onRetry:(d,C,J)=>{o.progress(`${t.name}: ${C.message}; reading call ${d} again in ${String(J)} s`)}};if(l.resume!==void 0){if(Object.keys(y).length>0||l.file!==void 0)throw $("--resume waits for a call as it was made: give it no input or --file.");const d=await L(k,l.resume,{...S,tool:t.name});return{value:{...d},text:W(d,a)}}const v=B(e,y);if(v.length>0)throw $(`${t.name} needs ${v.join(", ")}.`,`allyhub help ${a} shows its options.`);const A=await F(k,t.name,y,{...S,outDir:D(j,E,t.work,t.name),...l.file===void 0?{}:{file:x(o.cwd,l.file)},force:l.force,wait:l.wait});return{value:{...A},text:W(A,a)}})}}const V=t=>p(u(t)).catch(()=>{});export const CLOUD_SOURCE={entries:[{name:"<work>",summary:"List a work's cloud tools (AllyHub's catalog), a line each; allyhub help lists the works"},{name:"<work> <tool>",summary:"Run a cloud tool with the account's credits, its input as options (allyhub help <work> <tool>, which says how its credits are counted)"}],async nouns(t){return(await p(u(t))).works.map(e=>({name:e.id,summary:`${e.title}: ${e.description}`}))},resolve:(t,a)=>f(async()=>{const[e,r]=t;if(e===void 0||e.startsWith("-"))return;let s=await V(a),i=s?.works.find(l=>l.id===e);if(i||(s=await p(u(a),{refresh:!0}).catch(()=>s),i=s?.works.find(l=>l.id===e)),!s||!i)return;if(r===void 0||r.startsWith("-"))return{command:T(i),rest:t.slice(1),list:!0};const o=s.tools.find(l=>l.name===r);if(o?.work!==i.id)throw new w("unknown-tool",o?`${r} is not a ${i.id} tool: it is in allyhub ${o.work}.`:`No ${i.id} tool ${r}.`,{exit:h.notFound,hint:o?`allyhub ${o.work} ${r}`:`allyhub ${i.id} lists its tools.`});return{command:toolCommand(o),rest:t.slice(2),list:!1}})},upload=m({name:"upload",summary:"Upload files from this computer for a cloud tool whose input takes a URL (a presenter photo, speech audio, a reference clip), and print a signed URL for each, which works for a few hours",input:n.strictObject({files:n.array(n.string()).min(1).describe("The files: images (.jpg, .png, .webp, .gif), sound (.mp3, .wav, .m4a, .aac, .ogg, .flac) or video (.mp4, .mov, .webm), 50 MB at most")}),positional:["files"],output:n.looseObject({files:n.array(n.looseObject({file:n.string(),ok:n.boolean(),url:n.string().optional()}))}),examples:["allyhub upload assets/media/presenter.jpg"]},(t,a)=>f(async()=>{const e=await M(u(a),t.files,{base:a.cwd}),r=e.filter(o=>!o.ok),s=e.map(o=>o.ok?`${o.file}
   ${o.url}${o.expiresAt===void 0?"":` (works until ${o.expiresAt})`}`:`${o.file}
-  failed: ${o.error.message}${o.error.hint?` ${o.error.hint}`:""}`);n.length>1&&s.push(r.length===0?`${y(n.length,"file")} uploaded.`:`${String(n.length-r.length)} of ${y(n.length,"file")} uploaded; ${String(r.length)} failed.`);const i=r[0];return{value:{files:n.map(o=>o.ok?{...o}:{file:o.file,ok:!1,error:{code:o.error.code,message:o.error.message,...o.error.hint?{hint:o.error.hint}:{}}})},text:s.join(`
-`),...i?{exit:i.error.exit}:{}}})),cloudList=w({name:"cloud list",summary:"List AllyHub's cloud works, or one work's tools, a line each with its price",input:a.strictObject({work:a.string().optional().describe("The work whose tools to list; none lists the works")}),output:a.looseObject({})},(e,t)=>f(async()=>{const n=await h(p(t));if(e.work===void 0)return{value:{works:n.works},text:["AllyHub's cloud works:",...I(n.works.map(i=>[i.id,i.description]))].join(`
-`)};const r=n.works.find(i=>i.id===e.work);if(!r)throw new b("unknown-work",`No work ${e.work}.`,{exit:$.notFound,hint:`The works are ${n.works.map(i=>i.id).join(", ")}.`});const s=await W(r).run({fresh:!1},t);return{value:s.value,text:s.text}})),cloudTool=w({name:"cloud tool",summary:"Show a cloud tool: what it does, its input (as cloud call's input takes it) and its price",input:a.strictObject({tool:a.string().describe("The tool's name, as cloud list lists it")}),output:a.looseObject({name:a.string()})},(e,t)=>f(async()=>{const n=toolCommand(await C(p(t),e.tool));return{value:{name:e.tool,summary:n.spec.summary,about:n.about?.lines??[],...n.about?.value},text:X(n.spec,n.about?.lines)}})),cloudCall=w({name:"cloud call",summary:"Run a cloud tool with the account's credits: its output, the credits used, and the file it makes with its record; waits for a long one",input:a.strictObject({tool:a.string().describe("The tool's name, as cloud list lists it"),input:a.record(a.string(),a.unknown()).default({}).describe("Its input, by its input schema (cloud tool)"),quote:d.quote,file:d.file,force:d.force,wait:d.wait,resume:d.resume}),output:a.looseObject({tool:a.string()})},(e,t)=>f(async()=>{const{tool:n,input:r,...s}=e,i=toolCommand(await C(p(t),n)),o=i.spec.input.safeParse({...s,...Object.keys(r).length?{input:JSON.stringify(r)}:{}});if(!o.success)throw k(o.error.message);const l=await i.run(o.data,t);return{...l,value:{tool:n,...l.value}}}));
+  failed: ${o.error.message}${o.error.hint?` ${o.error.hint}`:""}`);e.length>1&&s.push(r.length===0?`${g(e.length,"file")} uploaded.`:`${String(e.length-r.length)} of ${g(e.length,"file")} uploaded; ${String(r.length)} failed.`);const i=r[0];return{value:{files:e.map(o=>o.ok?{...o}:{file:o.file,ok:!1,error:{code:o.error.code,message:o.error.message,...o.error.hint?{hint:o.error.hint}:{}}})},text:s.join(`
+`),...i?{exit:i.error.exit}:{}}})),cloudList=m({name:"cloud list",summary:"List AllyHub's cloud works, or one work's tools, a line each",input:n.strictObject({work:n.string().optional().describe("The work whose tools to list; none lists the works")}),output:n.looseObject({})},(t,a)=>f(async()=>{const e=await p(u(a));if(t.work===void 0)return{value:{works:e.works},text:["AllyHub's cloud works:",...R(e.works.map(i=>[i.id,i.description]))].join(`
+`)};const r=e.works.find(i=>i.id===t.work);if(!r)throw new w("unknown-work",`No work ${t.work}.`,{exit:h.notFound,hint:`The works are ${e.works.map(i=>i.id).join(", ")}.`});const s=await T(r).run({fresh:!1},a);return{value:s.value,text:s.text}})),cloudTool=m({name:"cloud tool",summary:"Show a cloud tool: what it does and how its credits are counted, and its input (as cloud call's input takes it)",input:n.strictObject({tool:n.string().describe("The tool's name, as cloud list lists it")}),output:n.looseObject({name:n.string()})},(t,a)=>f(async()=>{const e=toolCommand(await N(u(a),t.tool));return{value:{name:t.tool,summary:e.spec.summary,about:e.about?.lines??[],...e.about?.value},text:U(e.spec,e.about?.lines)}})),cloudCall=m({name:"cloud call",summary:"Run a cloud tool with the account's credits: its output, the credits used, and the file it makes with its record; waits for a long one",input:n.strictObject({tool:n.string().describe("The tool's name, as cloud list lists it"),input:n.record(n.string(),n.unknown()).default({}).describe("Its input, by its input schema (cloud tool)"),file:c.file,force:c.force,wait:c.wait,resume:c.resume}),output:n.looseObject({tool:n.string()})},(t,a)=>f(async()=>{const{tool:e,input:r,...s}=t,i=toolCommand(await N(u(a),e)),o=i.spec.input.safeParse({...s,...Object.keys(r).length?{input:JSON.stringify(r)}:{}});if(!o.success)throw $(o.error.message);const l=await i.run(o.data,a);return{...l,value:{tool:e,...l.value}}}));

package/dist/commands/mcp.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{McpServer as k}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as v}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as g,ListResourcesRequestSchema as S,ListToolsRequestSchema as R,ReadResourceRequestSchema as A}from"@modelcontextprotocol/sdk/types.js";import{z as u}from"zod";import{describeCommand as C,toolName as h}from"@allyhub-next/protocol";import{ASK_ABOVE as M,askingAbove as O,chargeQuestion as j}from"../charge.js";import{CommandError as d,defineCommand as T}from"../command.js";import{CardApp as E}from"./mcp-app.js";import{docResources as I,readDoc as N}from"./mcp-docs.js";const _="0.0.0";export const MCP_INSTRUCTIONS=["AllyHub makes videos, decks, docs, sheets and 3D sceneries as code in a project folder, checks, previews and renders them on this computer, and runs AI models and research tools in its cloud, which cost the person's credits.","Each tool here is one of its commands: `allyhub help` on the command line (`npx -y allyhub help`) is their reference and says where the SDK's docs are.",`\`allyhub skills\` (${h("skills")}) lists AllyHub's work skills, each how to make one kind of work; \`allyhub skills show <name>\` (${h("skills show")}) prints one, and \`allyhub add <name>\` puts it in the project.`].join(" ");const $=2147483647;async function q(r,a,p){const l=(e,o=!1)=>({content:[{type:"text",text:JSON.stringify(e,null,2)}],...o?{isError:o}:{}}),c=r.spec.input.safeParse(a??{});if(!c.success){const e=c.error.issues[0];return l({error:{code:"usage",message:`${e?.path.join(".")??r.spec.name}: ${e?.message??"not valid"}.`}},!0)}try{const e=await r.run(c.data,p);return l(e.value)}catch(e){const o=e instanceof d?e:new d("failed",e instanceof Error?e.message:String(e));return l({error:{code:o.code,message:o.message,...o.hint===void 0?{}:{hint:o.hint}}},!0)}}export const mcp=T({name:"mcp",summary:"The commands as MCP tools, over stdio",input:u.strictObject({ask:u.boolean().default(!0).describe("Ask the person before a cloud call that costs more than --ask-above credits, or one priced only by what it makes, where the client can ask (MCP's elicitation); --no-ask never asks"),askAbove:u.number().nonnegative().default(M).describe("The credits a call may cost without asking the person; 0 asks before every call that costs credits")}),output:u.looseObject({}),examples:["claude mcp add allyhub -- allyhub mcp","allyhub mcp --ask-above 50"],mcp:!1},async(r,a)=>{const{COMMANDS:p,MCP_COMMANDS:l}=await import("./index.js"),c=new Map([...p,...l].filter(s=>s.spec.mcp!==!1).map(s=>[h(s.spec.name),s]));console.log=console.error,console.info=console.error;const e=new k({name:"allyhub",version:_},{capabilities:{tools:{},resources:{}},instructions:MCP_INSTRUCTIONS}),o=new E(a),i=e.server;i.setRequestHandler(R,()=>({tools:[...o.tools(),...[...c].map(([s,t])=>{const n=Object.fromEntries(Object.entries(C(t.spec).input).filter(([m])=>m!=="$schema"));return{name:s,description:t.spec.summary,inputSchema:{type:"object",...n}}})]})),i.setRequestHandler(S,async()=>({resources:[...o.resources(),...await I(a.cwd)]})),i.setRequestHandler(A,async s=>{const{uri:t}=s.params;if(t===o.resources()[0]?.uri)return{contents:[await o.resource()]};const n=await N(a.cwd,t);if(n===void 0)throw new d("not-found",`allyhub has no resource ${t}.`);return{contents:[n]}}),i.setRequestHandler(g,(s,t)=>{if(o.has(s.params.name))return o.call(s.params.arguments);const n=c.get(s.params.name);if(!n)throw new d("unknown-tool",`allyhub has no tool ${s.params.name}.`);const m=AbortSignal.any([a.signal,t.signal]),w=r.ask&&i.getClientCapabilities()?.elicitation?.form;return q(n,s.params.arguments,{...a,signal:m,...w?{approve:O(r.askAbove,async y=>(await i.elicitInput(j(y),{signal:m,timeout:$,relatedRequestId:t.requestId})).action==="accept")}:{}})});const f=new v,b=new Promise(s=>{f.onclose=s});return await e.connect(f),process.stdin.once("end",()=>{e.close()}),a.signal.addEventListener("abort",()=>{e.close()}),await b,await o.close(),{value:{},text:""}});
+import{McpServer as y}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as b}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as S,ListResourcesRequestSchema as g,ListToolsRequestSchema as k,ReadResourceRequestSchema as v}from"@modelcontextprotocol/sdk/types.js";import{z as f}from"zod";import{describeCommand as R,toolName as d}from"@allyhub-next/protocol";import{CommandError as m,defineCommand as C}from"../command.js";import{CardApp as j}from"./mcp-app.js";import{docResources as M,readDoc as O}from"./mcp-docs.js";const A="0.0.0";export const MCP_INSTRUCTIONS=["AllyHub makes videos, decks, docs, sheets and 3D sceneries as code in a project folder, checks, previews and renders them on this computer, and runs AI models and research tools in its cloud, which cost the person's credits.","Each tool here is one of its commands: `allyhub help` on the command line (`npx -y allyhub help`) is their reference and says where the SDK's docs are.",`\`allyhub skills\` (${d("skills")}) lists AllyHub's work skills, each how to make one kind of work; \`allyhub skills show <name>\` (${d("skills show")}) prints one, and \`allyhub add <name>\` puts it in the project.`].join(" ");async function N(i,t,u){const c=(e,o=!1)=>({content:[{type:"text",text:JSON.stringify(e,null,2)}],...o?{isError:o}:{}}),a=i.spec.input.safeParse(t??{});if(!a.success){const e=a.error.issues[0];return c({error:{code:"usage",message:`${e?.path.join(".")??i.spec.name}: ${e?.message??"not valid"}.`}},!0)}try{const e=await i.run(a.data,u);return c(e.value)}catch(e){const o=e instanceof m?e:new m("failed",e instanceof Error?e.message:String(e));return c({error:{code:o.code,message:o.message,...o.hint===void 0?{}:{hint:o.hint}}},!0)}}export const mcp=C({name:"mcp",summary:"The commands as MCP tools, over stdio",input:f.strictObject({}),output:f.looseObject({}),examples:["claude mcp add allyhub -- allyhub mcp"],mcp:!1},async(i,t)=>{const{COMMANDS:u,MCP_COMMANDS:c}=await import("./index.js"),a=new Map([...u,...c].filter(s=>s.spec.mcp!==!1).map(s=>[d(s.spec.name),s]));console.log=console.error,console.info=console.error;const e=new y({name:"allyhub",version:A},{capabilities:{tools:{},resources:{}},instructions:MCP_INSTRUCTIONS}),o=new j(t),l=e.server;l.setRequestHandler(k,()=>({tools:[...o.tools(),...[...a].map(([s,n])=>{const r=Object.fromEntries(Object.entries(R(n.spec).input).filter(([p])=>p!=="$schema"));return{name:s,description:n.spec.summary,inputSchema:{type:"object",...r}}})]})),l.setRequestHandler(g,async()=>({resources:[...o.resources(),...await M(t.cwd)]})),l.setRequestHandler(v,async s=>{const{uri:n}=s.params;if(n===o.resources()[0]?.uri)return{contents:[await o.resource()]};const r=await O(t.cwd,n);if(r===void 0)throw new m("not-found",`allyhub has no resource ${n}.`);return{contents:[r]}}),l.setRequestHandler(S,(s,n)=>{if(o.has(s.params.name))return o.call(s.params.arguments);const r=a.get(s.params.name);if(!r)throw new m("unknown-tool",`allyhub has no tool ${s.params.name}.`);const p=AbortSignal.any([t.signal,n.signal]);return N(r,s.params.arguments,{...t,signal:p})});const h=new b,w=new Promise(s=>{h.onclose=s});return await e.connect(h),process.stdin.once("end",()=>{e.close()}),t.signal.addEventListener("abort",()=>{e.close()}),await w,await o.close(),{value:{},text:""}});

package/dist/commands/orgs.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as n}from"zod";import{chooseOrganization as m,organizations as l,readCredentials as p}from"@allyhub-next/cloud";import{API_KEY_ENV as f,EXIT as u}from"@allyhub-next/protocol";import{defineCommand as d}from"../command.js";import{cloudOf as c,cloudWork as g}from"./cloud.js";const h=n.looseObject({id:n.string(),name:n.string(),slug:n.string(),kind:n.string(),role:n.string(),current:n.boolean()});export const orgsList=d({name:"orgs list",summary:"The organizations you are in, your own and your teams, with your role; the one this computer acts in and pays from is marked",input:n.strictObject({}),output:n.looseObject({organizations:n.array(h)})},(e,s)=>g(async()=>{const t=c(s),a=await l(t),i=(await p(t.config))?.account.organization?.id,r=a.filter(o=>o.dissolvedAt===null).map(o=>({id:o.id,name:o.name,slug:o.slug,kind:o.kind,role:o.role,current:i===void 0?o.kind==="personal":o.id===i}));return{value:{organizations:r},text:r.map(o=>`${o.current?"*":" "} ${o.kind==="personal"?"(your own)":o.slug}  ${o.name}  ${o.role}`).join(`
-`)}})),orgsSwitch=d({name:"orgs switch",summary:"Act in and pay from another organization on this computer (Studio too): a team's slug or id, or `personal` for your own",input:n.strictObject({org:n.string().min(1).describe("The organization: a team's slug or id, or personal")}),positional:["org"],output:n.looseObject({id:n.string(),name:n.string()}),examples:["allyhub orgs switch apollo","allyhub orgs switch personal"]},(e,s)=>g(async()=>{const t=c(s);if(t.config.apiKey!==void 0)return{value:{id:"",name:""},text:`A key in ${f} acts in the organization it was made for; unset it to choose one here.`,exit:u.usage};const a=(await l(t)).filter(r=>r.dissolvedAt===null),i=e.org==="personal"?a.find(r=>r.kind==="personal"):a.find(r=>r.slug===e.org||r.id===e.org);return i===void 0?{value:{id:"",name:""},text:`You are in no organization ${e.org}. allyhub orgs list says which you are in.`,exit:u.usage}:(await m(t.config,{id:i.id,name:i.name}),{value:{id:i.id,name:i.name},text:`This computer acts in ${i.kind==="personal"?"your own organization":i.name} now.`})}));
+import{z as o}from"zod";import{chooseOrganization as f,organizations as l,readCredentials as p}from"@allyhub-next/cloud";import{API_KEY_ENV as h,EXIT as u}from"@allyhub-next/protocol";import{defineCommand as c}from"../command.js";import{cloudOf as g,cloudWork as d}from"./cloud.js";const y=o.looseObject({id:o.string(),name:o.string(),slug:o.string(),role:o.string(),current:o.boolean()});export const orgsList=c({name:"orgs list",summary:"The organizations you are in, with your role; the one this computer acts in and pays from is marked",input:o.strictObject({}),output:o.looseObject({organizations:o.array(y)})},(r,a)=>d(async()=>{const e=g(a),s=await l(e),i=(await p(e.config))?.account.organization?.id,n=s.filter(t=>t.dissolvedAt===null).map((t,m)=>({id:t.id,name:t.name,slug:t.slug,role:t.role,current:i===void 0?m===0:t.id===i}));return{value:{organizations:n},text:n.map(t=>`${t.current?"*":" "} ${t.slug}  ${t.name}  ${t.role}`).join(`
+`)}})),orgsSwitch=c({name:"orgs switch",summary:"Act in and pay from another organization on this computer (Studio too), by its slug or id",input:o.strictObject({org:o.string().min(1).describe("The organization: its slug or id")}),positional:["org"],output:o.looseObject({id:o.string(),name:o.string()}),examples:["allyhub orgs switch apollo"]},(r,a)=>d(async()=>{const e=g(a);if(e.config.apiKey!==void 0)return{value:{id:"",name:""},text:`A key in ${h} acts in the organization it was made for; unset it to choose one here.`,exit:u.usage};const i=(await l(e)).filter(n=>n.dissolvedAt===null).find(n=>n.slug===r.org||n.id===r.org);return i===void 0?{value:{id:"",name:""},text:`You are in no organization ${r.org}. allyhub orgs list says which you are in.`,exit:u.usage}:(await f(e.config,{id:i.id,name:i.name}),{value:{id:i.id,name:i.name},text:`This computer acts in ${i.name} now.`})}));

package/dist/commands/voice.js

@@ -1,4 +1,4 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as i}from"zod";import{projectSays as y}from"@allyhub-next/project";import{declined as w,makeSay as $,quoteSays as g}from"@allyhub-next/cloud";import{EXIT as v}from"@allyhub-next/protocol";import{CommandError as b,defineCommand as j}from"../command.js";import{projectRoot as k}from"../project.js";import{cloudOf as S,cloudWork as q,plural as m}from"./cloud.js";import{dir as O}from"../fields.js";const h=a=>Math.round(a*1e6)/1e6;export const voice=j({name:"voice",summary:"Make the voice files a project's say(text) parts need, with their cloud voice tool, one per say that has none (assets/media/gen/say/<hash>, its words and its record); --quote prices them first",input:i.strictObject({item:i.string().optional().describe("Only this item's says: its id, a path into it, or a folder of items"),dir:O,quote:i.boolean().default(!1).describe("Say what making the missing files would cost, making nothing and charging nothing")}),positional:["item"],output:i.looseObject({says:i.number(),missing:i.array(i.looseObject({part:i.string(),stem:i.string()})).optional(),made:i.array(i.looseObject({part:i.string(),file:i.string()})).optional(),credits:i.number()}),examples:["allyhub voice --quote","allyhub voice launch/film"]},async(a,n)=>{const p=await k(n.cwd,a.dir),c=await y(p,a.item===void 0?{}:{piece:a.item});if(a.item!==void 0&&c.pieces.length===0)throw new b("no-item",`No video ${a.item} in the project.`,{exit:v.notFound});const o=c.says.filter(l=>l.file===void 0),u=`Every say has its file (${m(c.says.length,"say")}). Nothing to make.`;return await q(async()=>{const l=S(n);if(a.quote){const e=await g(l,o),s=t=>{const r=e.says[t]?.credits;return r===void 0?{}:{credits:r}};return{value:{says:c.says.length,missing:o.map((t,r)=>({piece:t.piece,part:t.part,tool:t.tool,...t.voice===void 0?{}:{voice:t.voice},...t.params===void 0?{}:{params:t.params},characters:t.text.length,stem:t.stem,...s(r)})),credits:e.credits,estimated:e.estimated},text:o.length===0?u:[`${m(o.length,"say")} without a file:`,...o.map((t,r)=>`  ${t.piece} · ${t.part}: ${m(t.text.length,"character")}${s(r).credits===void 0?"":`, ${String(h(s(r).credits??0))} credits`}`),`${e.estimated?"About ":""}${String(e.credits)} credits in all. Nothing was charged; allyhub voice makes them.`].join(`
-`)}}const d=[];if(n.approve!==void 0&&o.length>0){const e=await g(l,o);if(!await n.approve({tool:"voice",title:`${m(o.length,"voice file")} with ${e.titles.join(", ")}`,credits:e.credits,estimated:e.estimated,unknown:e.unknown}))throw w("voice")}for(const e of o){n.progress(`${e.piece} · ${e.part}: ${e.tool}…`);const s=await $(l,p,e,{base:p,signal:n.signal});d.push({piece:e.piece,part:e.part,...s})}const f=h(d.reduce((e,s)=>e+s.credits,0));return{value:{says:c.says.length,made:d,kept:c.says.length-o.length,credits:f},text:d.length===0?u:[`Made ${m(d.length,"file")}:`,...d.map(e=>`  ${e.file} (${e.piece} · ${e.part}, ${String(h(e.seconds))} s)`),`Credits used: ${String(f)}.`].join(`
+import{z as t}from"zod";import{projectSays as f}from"@allyhub-next/project";import{makeSay as u}from"@allyhub-next/cloud";import{EXIT as y}from"@allyhub-next/protocol";import{CommandError as g,defineCommand as $}from"../command.js";import{projectRoot as v}from"../project.js";import{cloudOf as w,cloudWork as b,plural as n}from"./cloud.js";import{dir as j}from"../fields.js";const h=i=>Math.round(i*1e6)/1e6;export const voice=$({name:"voice",summary:"Make the voice files a project's say(text) parts need, with their cloud voice tool, one per say that has none (assets/media/gen/say/<hash>, its words and its record); --dry-run lists them first, with their tool and characters",input:t.strictObject({item:t.string().optional().describe("Only this item's says: its id, a path into it, or a folder of items"),dir:j,dryRun:t.boolean().default(!1).describe("List the says without a file, each with its tool and characters, making nothing")}),positional:["item"],output:t.looseObject({says:t.number(),missing:t.array(t.looseObject({part:t.string(),stem:t.string()})).optional(),made:t.array(t.looseObject({part:t.string(),file:t.string()})).optional(),credits:t.number().optional()}),examples:["allyhub voice --dry-run","allyhub voice launch/film"]},async(i,s)=>{const c=await v(s.cwd,i.dir),o=await f(c,i.item===void 0?{}:{piece:i.item});if(i.item!==void 0&&o.pieces.length===0)throw new g("no-item",`No video ${i.item} in the project.`,{exit:y.notFound});const a=o.says.filter(l=>l.file===void 0),d=`Every say has its file (${n(o.says.length,"say")}). Nothing to make.`;return await b(async()=>{const l=w(s);if(i.dryRun)return{value:{says:o.says.length,missing:a.map(e=>({piece:e.piece,part:e.part,tool:e.tool,...e.voice===void 0?{}:{voice:e.voice},...e.params===void 0?{}:{params:e.params},characters:e.text.length,stem:e.stem}))},text:a.length===0?d:[`${n(a.length,"say")} without a file:`,...a.map(e=>`  ${e.piece} · ${e.part}: ${e.tool}, ${n(e.text.length,"character")}`),"Nothing was made; allyhub voice makes them, priced as each tool's description says."].join(`
+`)};const r=[];for(const e of a){s.progress(`${e.piece} · ${e.part}: ${e.tool}…`);const m=await u(l,c,e,{base:c,signal:s.signal});r.push({piece:e.piece,part:e.part,...m})}const p=h(r.reduce((e,m)=>e+m.credits,0));return{value:{says:o.says.length,made:r,kept:o.says.length-a.length,credits:p},text:r.length===0?d:[`Made ${n(r.length,"file")}:`,...r.map(e=>`  ${e.file} (${e.piece} · ${e.part}, ${String(h(e.seconds))} s)`),`Credits used: ${String(p)}.`].join(`
 `)}})});

package/dist/main.js

@@ -1,8 +1,8 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readFileSync as R}from"node:fs";import{EXIT as m,describeCommand as M}from"@allyhub-next/protocol";import{readArgs as T}from"./args.js";import{studioApprove as H}from"./charge.js";import{CommandError as h}from"./command.js";import{COMMAND_SOURCES as j,COMMANDS as x}from"./commands/index.js";import{commandHelp as A,listHelp as J,workHelp as G}from"./help.js";import{sdkDocs as U}from"./sdk-docs.js";import{WORKS as W,cloudNouns as F,workNamed as K,workTitle as E}from"./works.js";const N=JSON.parse(R(new URL("../package.json",import.meta.url),"utf8")).version,L={stdout:t=>process.stdout.write(t),stderr:t=>process.stderr.write(t),cwd:process.cwd(),env:process.env};export function findCommand(t,o=x){let i;for(const c of o){const u=c.spec.name.split(" ");u.every((r,a)=>t[a]===r)&&u.length>(i?.length??0)&&(i={command:c,length:u.length})}return i?{command:i.command,rest:t.slice(i.length)}:{rest:[...t]}}export async function resolveCommand(t,o,i=x,c=j){const u=findCommand(t,i);if(u.command)return u;for(const r of c){const a=await r.resolve(t,o);if(a)return a}return u}const D=t=>({...M(t.spec),...t.about?.value});export async function main(t,o=L,i=x,c=j){const u=t.includes("--json"),r=t.filter(n=>n!=="--json"),a=(n,e)=>{o.stdout(u?`${JSON.stringify(n,null,2)}
+import{readFileSync as D}from"node:fs";import{EXIT as m,describeCommand as I}from"@allyhub-next/protocol";import{readArgs as R}from"./args.js";import{CommandError as h}from"./command.js";import{COMMAND_SOURCES as M,COMMANDS as x}from"./commands/index.js";import{commandHelp as j,listHelp as T,workHelp as H}from"./help.js";import{sdkDocs as J}from"./sdk-docs.js";import{WORKS as G,cloudNouns as U,workNamed as W,workTitle as E}from"./works.js";const N=JSON.parse(D(new URL("../package.json",import.meta.url),"utf8")).version,F={stdout:t=>process.stdout.write(t),stderr:t=>process.stderr.write(t),cwd:process.cwd(),env:process.env};export function findCommand(t,s=x){let i;for(const c of s){const l=c.spec.name.split(" ");l.every((o,a)=>t[a]===o)&&l.length>(i?.length??0)&&(i={command:c,length:l.length})}return i?{command:i.command,rest:t.slice(i.length)}:{rest:[...t]}}export async function resolveCommand(t,s,i=x,c=M){const l=findCommand(t,i);if(l.command)return l;for(const o of c){const a=await o.resolve(t,s);if(a)return a}return l}const A=t=>({...I(t.spec),...t.about?.value});export async function main(t,s=F,i=x,c=M){const l=t.includes("--json"),o=t.filter(n=>n!=="--json"),a=(n,e)=>{s.stdout(l?`${JSON.stringify(n,null,2)}
 `:`${e}
-`)},S=i.map(n=>n.spec),v=new AbortController,$=H(o.env,o.cwd,v.signal),y={cwd:o.cwd,env:o.env,progress:n=>{o.stderr(`${n}
-`)},signal:v.signal,...$===void 0?{}:{approve:$}};if(r[0]==="--version"||r[0]==="-v")return a({version:N},N),m.ok;if(r.length===0||r[0]==="help"||r[0]==="--help"||r[0]==="-h"){const n=r.slice(1),e=await U(o.cwd).catch(()=>{}),k=async()=>{const s=await Promise.all(c.map(l=>l.nouns(y).catch(()=>{})));return s.some(l=>l===void 0)?void 0:s.flatMap(l=>l??[])};if(n.length===0){const s=await k();return a({version:N,docs:e?.dir,works:W.map(l=>({...l,title:E(l,s)})),commands:S.map(M),made:[...c.flatMap(l=>l.entries),...s??[]]},J(S,c,s,e?.dir)),m.ok}const d=n.length===1?K(n[0]??""):void 0;if(d){const s=d.cloud===void 0?[]:await k();return a({...d,title:E(d,s),...d.cloud===void 0?{}:{cloudWorks:s&&F(d,s)},docsDir:e?.dir},G(d,S,c,e?.dir,s)),m.ok}let p;try{p=await resolveCommand(n,y,i,c)}catch(s){return g(s)}const{command:f,rest:I}=p;return f&&p.list===!0?await O(f,I):!f||I.length>0?g(new h("unknown-command",`allyhub has no command "${n.join(" ")}".`,{exit:m.usage,hint:"allyhub help lists them and the works."})):(a(D(f),A(f.spec,f.about?.lines)),m.ok)}let C;try{C=await resolveCommand(r,y,i,c)}catch(n){return g(n)}const{command:w,rest:b}=C;if(!w)return g(new h("unknown-command",`allyhub has no command "${r[0]??""}".`,{exit:m.usage,hint:"allyhub help lists them."}));if(b.includes("--help")||b.includes("-h"))return a(D(w),A(w.spec,w.about?.lines)),m.ok;return await O(w,b);async function O(n,e){const k=()=>{v.abort(new h("interrupted","Stopped.",{exit:m.interrupted}))};process.once("SIGINT",k);try{const d=T(n.spec,e),p=await n.run(d,y);return a(p.value,p.text),p.exit??m.ok}catch(d){return g(d)}finally{process.off("SIGINT",k)}}function g(n){const e=n instanceof h?n:v.signal.aborted?new h("interrupted","Stopped.",{exit:m.interrupted}):new h("failed",n instanceof Error?n.message:String(n));return u?o.stdout(`${JSON.stringify({error:{code:e.code,message:e.message,...e.hint?{hint:e.hint}:{}}},null,2)}
-`):o.stderr(`${e.message}${e.hint?`
+`)},S=i.map(n=>n.spec),b=new AbortController,y={cwd:s.cwd,env:s.env,progress:n=>{s.stderr(`${n}
+`)},signal:b.signal};if(o[0]==="--version"||o[0]==="-v")return a({version:N},N),m.ok;if(o.length===0||o[0]==="help"||o[0]==="--help"||o[0]==="-h"){const n=o.slice(1),e=await J(s.cwd).catch(()=>{}),k=async()=>{const r=await Promise.all(c.map(u=>u.nouns(y).catch(()=>{})));return r.some(u=>u===void 0)?void 0:r.flatMap(u=>u??[])};if(n.length===0){const r=await k();return a({version:N,docs:e?.dir,works:G.map(u=>({...u,title:E(u,r)})),commands:S.map(I),made:[...c.flatMap(u=>u.entries),...r??[]]},T(S,c,r,e?.dir)),m.ok}const d=n.length===1?W(n[0]??""):void 0;if(d){const r=d.cloud===void 0?[]:await k();return a({...d,title:E(d,r),...d.cloud===void 0?{}:{cloudWorks:r&&U(d,r)},docsDir:e?.dir},H(d,S,c,e?.dir,r)),m.ok}let p;try{p=await resolveCommand(n,y,i,c)}catch(r){return g(r)}const{command:f,rest:O}=p;return f&&p.list===!0?await C(f,O):!f||O.length>0?g(new h("unknown-command",`allyhub has no command "${n.join(" ")}".`,{exit:m.usage,hint:"allyhub help lists them and the works."})):(a(A(f),j(f.spec,f.about?.lines)),m.ok)}let $;try{$=await resolveCommand(o,y,i,c)}catch(n){return g(n)}const{command:w,rest:v}=$;if(!w)return g(new h("unknown-command",`allyhub has no command "${o[0]??""}".`,{exit:m.usage,hint:"allyhub help lists them."}));if(v.includes("--help")||v.includes("-h"))return a(A(w),j(w.spec,w.about?.lines)),m.ok;return await C(w,v);async function C(n,e){const k=()=>{b.abort(new h("interrupted","Stopped.",{exit:m.interrupted}))};process.once("SIGINT",k);try{const d=R(n.spec,e),p=await n.run(d,y);return a(p.value,p.text),p.exit??m.ok}catch(d){return g(d)}finally{process.off("SIGINT",k)}}function g(n){const e=n instanceof h?n:b.signal.aborted?new h("interrupted","Stopped.",{exit:m.interrupted}):new h("failed",n instanceof Error?n.message:String(n));return l?s.stdout(`${JSON.stringify({error:{code:e.code,message:e.message,...e.hint?{hint:e.hint}:{}}},null,2)}
+`):s.stderr(`${e.message}${e.hint?`
 ${e.hint}`:""}
 `),e.exit}}