pixie-mcp 0.3.0 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/pixie-mcp.mjs +30 -12
- package/sprite_core.wasm +0 -0
package/package.json
CHANGED
package/pixie-mcp.mjs
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
var v=(n,e)=>()=>(n&&(e=n(n=0)),e);function he(n){let e="";for(let t=0;t<n.length;t+=32768)e+=String.fromCharCode.apply(null,n.subarray(t,t+32768));return btoa(e).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}var de=v(()=>{"use strict"});var _,Xe,Ye,Vt,pe=v(()=>{"use strict";_="[A-Za-z0-9_-]{1,64}",Xe="token|members|link|slow|project",Ye=[{owner:"accounts",re:new RegExp("^/auth/")},{owner:"accounts",re:new RegExp("^/a/[A-Za-z0-9_-]{1,64}\\.png$")},{owner:"accounts",re:new RegExp("^/projects(/|$)")},{owner:"accounts",re:new RegExp(`^/documents/${_}/(${Xe})$`)},{owner:"library",re:new RegExp("^/documents$")},{owner:"library",re:new RegExp("^/documents/(new|register|move|order|folders|folders/delete)$")},{owner:"library",re:new RegExp(`^/documents/${_}(/(thumbnail\\.png|duplicate|rename))?$`)},{owner:"library",re:new RegExp(`^/documents/${_}/history/at/\\d+/thumbnail\\.png$`)},{owner:"document",re:new RegExp(`^/documents/${_}/history(/at/\\d+|/\\d+)?$`)},{owner:"document",re:new RegExp(`^/documents/${_}/comments(/[A-Za-z0-9]{1,40})?$`)},{owner:"document",re:new RegExp(`^/documents/${_}/snapshots(/enabled|/[A-Za-z0-9_-]{1,128})?$`)},{owner:"document",re:new RegExp(`^/favourites(/order|/(document|project)/${_})?$`)}],Vt=Ye.map(({owner:n,re:e})=>({owner:n,source:e.source}))});var W,H=v(()=>{"use strict";pe();W=["read","draw","create","organise"]});async function me(n){let e=new TextEncoder().encode(String(n));return he(new Uint8Array(await crypto.subtle.digest("SHA-256",e)))}var tn,fe=v(()=>{"use strict";de();H();tn=120*1e3});function E(n=Date.now()){let e="0123456789ABCDEFGHJKMNPQRSTVWXYZ",t=(BigInt(n)&0xffffffffffffn)<<80n,r=crypto.getRandomValues(new Uint8Array(10)),o=0n;for(let i of r)o=o<<8n|BigInt(i);t|=o;let s="";for(let i=0;i<26;i++)s=e[Number(t&31n)]+s,t>>=5n;return s}function x(n){return n==null?{at:0}:typeof n=="number"?{at:n}:{frame:n}}var ot,st,it,I,j,z,T=v(()=>{"use strict";ot=new TextEncoder,st=new TextDecoder,it=1;I=class n{#e;#t;constructor(e){this.#e=e,this.#t=e.exports}static async load(e){let t;if(e instanceof WebAssembly.Module)t=await WebAssembly.instantiate(e,{});else if(e instanceof ArrayBuffer||ArrayBuffer.isView(e))({instance:t}=await WebAssembly.instantiate(e,{}));else{let r=e instanceof Response||typeof e?.then=="function"?e:fetch(e);({instance:t}=await WebAssembly.instantiateStreaming(r,{}))}return new n(t)}get#n(){return new Uint8Array(this.#t.memory.buffer)}call(e,t={}){let r=ot.encode(JSON.stringify({m:e,a:t})),o=this.#t.sprite_alloc(r.length);if(!o)throw new Error("sprite-core: allocation failed");let s=0;try{if(this.#n.set(r,o),s=this.#t.sprite_dispatch(o,r.length),!s)throw new Error("sprite-core: dispatch returned nothing");let i=this.#n,a=i[s]|i[s+1]<<8|i[s+2]<<16|i[s+3]<<24,c=i[s+4],l=i.slice(s+5,s+5+a);if(c===it)return l;let u=JSON.parse(st.decode(l));if(u&&u.error)throw new Error(u.error);return u}finally{s?this.#t.sprite_free_result(s):this.#t.sprite_dealloc(o,r.length)}}reset(){this.#t.sprite_reset()}newDocument(e={}){return this.call("doc.new",{w:32,h:32,name:"untitled",...e})}openSession(e,t,r=1){let{h:o}=this.call("session.new",{doc:e,author:t,seed:r});return new j(this,o)}openRoom(e,{seq:t=0}={}){let{h:r}=this.call("room.new",{doc:e,...t>0?{seq:t}:{}});return new z(this,r)}},j=class{constructor(e,t){this.core=e,this.h=t}#e(e,t={}){return this.core.call(e,{h:this.h,...t})}state(){return this.#e("session.state")}apply(e,{now:t=Date.now(),label:r="Edit",job:o=null}={}){let s={now:t,label:r,bodies:Array.isArray(e)?e:[e]};return o&&(s.job=o),this.#e("session.apply",s).ops}remote(e){return this.#e("session.remote",{sop:e})}reject(e){return this.#e("session.reject",{op:e})}undo(e=Date.now()){return this.#e("session.undo",{now:e}).ops}redo(e=Date.now()){return this.#e("session.redo",{now:e}).ops}pending(){return this.#e("session.pending")}checkpoint({doc:e=!0}={}){return this.#e("session.checkpoint",{doc:e})}save(){return this.#e("session.save")}drawArt(e,t,r={}){return this.#e("session.drawArt",{rows:e,colors:t,...r}).bodies}drawAnimation(e,t,r={}){return this.#e("session.drawAnimation",{frames:e,colors:t,...r}).bodies}readArt(e,t,r={}){return this.#e("session.readArt",{layer:e,...x(t),...r})}cel(e,t){return this.#e("session.cel",{layer:e,...x(t)})}layerImage(e,t){return this.#e("session.layerImage",{layer:e,...x(t)})}tileCel(e,t){return this.#e("session.tileCel",{layer:e,...x(t)})}tile(e,t){return this.#e("session.tile",{tileset:e,index:t})}composite(e,{include:t="export"}={}){return this.#e("session.composite",{...x(e),include:t})}png(e){return this.#e("session.png",x(e))}contactSheet({columns:e=4,scale:t=2}={}){return this.#e("session.sheet",{columns:e,scale:t})}thumbnail(e=48){return this.#e("session.thumbnail",{size:e})}card({frame:e=null,width:t=1200,height:r=630,framing:o=null,bleed:s=0}={}){return this.#e("session.card",{width:t,height:r,...o??{},...x(e),...s?{bleed:s}:{}})}cardLayout({frame:e=null,width:t=1200,height:r=630,framing:o=null}={}){return this.#e("session.cardLayout",{width:t,height:r,...o??{},...x(e)})}fit({width:e,height:t,margin:r=0,inscribed:o=!1,dx:s=0,dy:i=0,frame:a=null}){return this.#e("session.fit",{width:e,height:t,margin:r,inscribed:o,dx:s,dy:i,...x(a)})}close(){this.#e("session.free")}},z=class{constructor(e,t){this.core=e,this.h=t}#e(e,t={}){return this.core.call(e,{h:this.h,...t})}state(){return this.#e("room.state")}submit(e,t=Date.now()){return this.#e("room.submit",{op:e,now:t})}since(e){return this.#e("room.since",{seq:e})}compact(){return this.#e("room.compact")}save(){return this.#e("room.save")}lease(e,t){return this.#e("room.lease",{action:e,...t})}close(){this.#e("room.free")}}});function ke(n){return JSON.stringify(n)}function _e(n){let e=n.rle instanceof Uint8Array?n.rle:null,t=new TextEncoder().encode(JSON.stringify({...n,rle:void 0}));if(t.length>at)return null;let r=new Uint8Array(3+t.length+(e?.length??0));return r[0]=ve,r[1]=t.length&255,r[2]=t.length>>8&255,r.set(t,3),e&&r.set(e,3+t.length),r}function ct(n){return n instanceof Uint8Array?n:n instanceof ArrayBuffer?new Uint8Array(n):ArrayBuffer.isView(n)?new Uint8Array(n.buffer,n.byteOffset,n.byteLength):null}function je(n){if(typeof n!="string"){let e=ct(n);if(!e||e.length<3||e[0]!==ve)return null;let t=e[1]|e[2]<<8;if(e.length<3+t)return null;try{let r=JSON.parse(new TextDecoder().decode(e.subarray(3,3+t)));if(!r||typeof r.t!="string")return null;let o=e.subarray(3+t);return r.rle=o.length?Uint8Array.from(o):null,r}catch{return null}}try{let e=JSON.parse(n);return e&&typeof e.t=="string"?e:null}catch{return null}}var g,Ee,S,xe,ve,at,$e=v(()=>{"use strict";g={HELLO:"hello",SUBMIT:"submit",PRESENCE:"presence",STROKE:"stroke",LEASE:"lease",PING:"ping",PROMPT:"prompt",ANSWER:"answer",STOP:"stop"},Ee={DOCUMENT:"document",LIBRARY:"library"},S={WELCOME:"welcome",REHELLO:"rehello",OPS:"ops",REJECT:"reject",PRESENCE:"presence",STROKE:"stroke",LEASE:"lease",ERROR:"error",PONG:"pong",PROMPT:"prompt",ANSWER:"answer",STOP:"stop"},xe={OPS:"ops",SNAPSHOT:"snapshot"};ve=157,at=65535});function ut(n){return String(n??"").trim().toLowerCase().replace(/[^a-z0-9_-]+/g,"-").replace(/^-+|-+$/g,"").replace(/-{2,}/g,"-").slice(0,64).replace(/-+$/,"")||null}function Re(n){return`${(ut(n)??"").slice(0,48).replace(/-+$/,"")||"sprite"}-${E().toLowerCase().slice(0,12)}`}var Te=v(()=>{"use strict";T()});import{readFile as Rt}from"node:fs/promises";import{readFile as Me,writeFile as qe,mkdir as Je,chmod as We}from"node:fs/promises";import{readFileSync as He}from"node:fs";import{homedir as ze,hostname as Ve}from"node:os";import{join as q}from"node:path";import{execFile as Ge}from"node:child_process";var p=n=>String(n??"").replace(/\/+$/,"").replace(/^ws/,"http"),Y=n=>String(n??"").replace(/\/+$/,"").replace(/^http/,"ws");async function Z(n,e){if(!n?.ok||!(n.headers.get("content-type")??"").includes("json"))return null;let t=await n.json().catch(()=>null);return!t||typeof t!="object"?null:e.some(r=>r in t)?t:null}async function Q(n,{timeoutMs:e=3e3,fetchImpl:t=fetch}={}){try{let r=await t(`${p(n)}/setup`,{signal:AbortSignal.timeout(e)});return await Z(r,["accounts","expectedPort","install"])}catch{return null}}var M=new Map;function ee(n,{fetchImpl:e=fetch,timeoutMs:t=3e3}={}){let r=p(n);return M.has(r)||M.set(r,Fe(n,{fetchImpl:e,timeoutMs:t})),M.get(r)}async function Fe(n,{fetchImpl:e,timeoutMs:t}){try{let r=await e(`${p(n)}/config.json`,{signal:AbortSignal.timeout(t)}),s=(await Z(r,["rooms","accounts"]))?.rooms;if(typeof s=="string"&&/^(wss?|https?):\/\/./.test(s))return Y(s)}catch{}return Y(n)}var $=process.env.SPRITE_PUBLIC_SERVER||Ke()||null;function Ke(){return"wss://drawpixie.com"}var te=q(process.env.XDG_CONFIG_HOME||q(ze(),".config"),"sprite"),J=q(te,"agent.json"),ne=n=>String(n??"").replace(/\/+$/,"");function re(){return`${Ve().replace(/\.local$/,"")}`.slice(0,60)||"a computer"}async function oe(){try{let n=JSON.parse(await Me(J,"utf8"));return n&&typeof n=="object"&&n.servers?n:{servers:{}}}catch{return{servers:{}}}}async function R(n){return process.env.SPRITE_TOKEN?{token:process.env.SPRITE_TOKEN,from:"the environment"}:(await oe()).servers[ne(n)]??null}async function se(n,e){await Je(te,{recursive:!0,mode:448});let t=await oe();t.servers[ne(n)]={...e,at:Date.now()};let r=`${J}.tmp`;await qe(r,JSON.stringify(t,null,2),{mode:384}),await We(r,384);let{rename:o}=await import("node:fs/promises");await o(r,J)}async function ie(n,{timeoutMs:e=3e3}={}){try{let t=await fetch(`${p(n)}/setup`,{signal:AbortSignal.timeout(e)});return t.ok?!!(await t.json()).accounts:!1}catch{return!1}}async function ae(n,e,{session:t=null}={}){let r=t??await R(n);if(!r?.token)return;let o=await fetch(`${p(n)}/documents/${encodeURIComponent(e)}/token`,{headers:{Authorization:`Bearer ${r.token}`}});if(o.status===401)throw new Error("this machine is signed out \u2014 pair it again");if(o.status===403)throw new Error(`no access to ${e}`);if(!o.ok)throw new Error(`could not get access to ${e}`);return(await o.json()).token}async function ce(n,{name:e,w:t,h:r},{session:o=null}={}){let s=o??await R(n);if(!s?.token)return;let i=await fetch(`${p(n)}/documents/new`,{method:"POST",headers:{Authorization:`Bearer ${s.token}`,"Content-Type":"application/json"},body:JSON.stringify({name:e,w:t,h:r})});if(i.status===401)throw new Error("this machine is signed out \u2014 pair it again");if(!i.ok)throw new Error(`could not make a document: the server said ${i.status}`);let{id:a}=await i.json();if(typeof a!="string"||!a)throw new Error("could not make a document: the server named none");return a}async function le(n,e,{method:t="GET",body:r=null,session:o=null}={}){let s=o??await R(n);if(!s?.token)return;let i=await fetch(`${p(n)}${e}`,{method:t,headers:{Authorization:`Bearer ${s.token}`,...r!==null?{"Content-Type":"application/json"}:{}},body:r!==null?JSON.stringify(r):void 0});if(i.status===401)throw new Error("this machine is signed out \u2014 pair it again");let a=await i.json().catch(()=>({}));if(!i.ok)throw new Error(a?.error?String(a.error):`the server said ${i.status}`);return a}function ue(n){let e=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";return new Promise(t=>Ge(e,[n],()=>t()))}fe();H();import{createServer as Ze}from"node:http";import{randomBytes as ye}from"node:crypto";var Qe=300*1e3,et=()=>ye(32).toString("base64url"),tt=()=>ye(16).toString("base64url");function we(n,e){return`<!doctype html><meta charset="utf-8"><title>Pixie</title><body style="background:#101014;color:#d8d8e0;font:14px/1.6 system-ui,sans-serif;display:grid;place-items:center;height:100vh;margin:0;text-align:center"><div><p style="font-size:16px">${n}</p><p style="color:#8a8a99;font-size:12px">${e}</p></div>`}async function nt({state:n,timeoutMs:e}){let t,r,o=new Promise((c,l)=>{t=c,r=l}),s=Ze((c,l)=>{let u=new URL(c.url,"http://127.0.0.1");if(u.pathname!=="/callback"){l.writeHead(404).end();return}if(u.searchParams.get("state")!==n){l.writeHead(404).end();return}let h=u.searchParams.get("error");l.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}).end(h?we("Nothing was granted.","You can close this window."):we("This computer can now draw in your sprites.","You can close this window and go back to what you were doing.")),t(u.searchParams)});await new Promise((c,l)=>{s.once("error",l),s.listen(0,"127.0.0.1",c)});let i=setTimeout(()=>r(new Error("nobody answered the browser in time")),e);i.unref?.();let{port:a}=s.address();return{redirect:`http://127.0.0.1:${a}/callback`,wait:o,close:()=>{clearTimeout(i),s.close(),s.closeAllConnections?.()}}}async function ge(n,{onUrl:e=()=>{},open:t=ue,label:r="the Pixie agent",scope:o=W,timeoutMs:s=Qe}={}){let i=et(),a=await me(i),c=tt(),l=await nt({state:c,timeoutMs:s});try{let u=new URL(`${p(n)}/authorize`);u.searchParams.set("challenge",a),u.searchParams.set("state",c),u.searchParams.set("redirect",l.redirect),u.searchParams.set("scope",o.join(",")),u.searchParams.set("name",r),e(u.toString()),await t(u.toString());let h=await l.wait,m=h.get("error");if(m)throw new Error(m==="access_denied"?"you said no on that screen, so nothing was granted":`that request was refused: ${m}`);let f=h.get("code");if(!f)throw new Error("the browser came back without an authorisation");let y=await fetch(`${p(n)}/auth/authorize/exchange`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({code:f,verifier:i,name:re()})}),d=await y.json().catch(()=>({}));if(!y.ok||!d.token)throw new Error(d.error||"that authorisation could not be exchanged");return await se(n,{token:d.token,name:d.name,email:d.email,scope:d.scope??null}),d}finally{l.close()}}import{realpathSync as be}from"node:fs";import{fileURLToPath as rt}from"node:url";function Se(n){let e=process.argv[1];if(!e)return!1;try{return be(rt(n))===be(e)}catch{return!1}}T();import{execFile as dt}from"node:child_process";$e();T();var lt=5e3,N=class{#e=null;constructor(e,t,r){if(!r||!r.author)throw new Error("DocumentClient needs an author");if(this.core=e,this.author=r.author,this.name=r.name||"anonymous",this.agent=r.agent===!0,this.answers=r.answers===!0,this.seed=r.seed??1,this.epoch=0,this.resumed=null,r.resume){let{h:o,dropped:s}=e.call("session.resume",{doc:t,author:this.author,seed:this.seed,seq:r.resume.seq??0,pending:r.resume.pending??[]});this.session=new j(e,o),this.resumed={seq:r.resume.seq??0,dropped:s??[]}}else this.session=e.openSession(t,this.author,this.seed);this.getToken=r.getToken??null,this.transport=null,this.connected=!1,this.welcomed=!1,this.ready=new Promise(o=>{this.#e=o}),this.participants=[],this.leases=[],this.presence=null,this.you=null,this.onChange=()=>{},this.onPresence=()=>{},this.onStroke=()=>{},this.strokePreview=!0,this.onLeases=()=>{},this.onLost=()=>{},this.onPrompt=()=>{},this.onAnswer=()=>{},this.onStop=()=>{},this.onStatus=()=>{}}apply(e,t={}){let r=this.session.apply(e,t);return this.#s(r),this.onChange(),r}undo(e=Date.now()){let t=this.session.undo(e);return this.#s(t),this.onChange(),t}redo(e=Date.now()){let t=this.session.redo(e);return this.#s(t),this.onChange(),t}setPresence(e){this.presence=e,this.connected&&this.#r({t:g.PRESENCE,...e})}sendStroke({layer:e,frame:t,rect:r,rle:o,done:s=!1}){if(!this.connected||!this.welcomed||!this.strokePreview)return;this._strokeSentAt=Date.now();let i=_e({t:g.STROKE,layer:e,frame:t,rect:r,rle:o,done:s});i&&this.#a(i)}lease(e,t={}){this.#r({t:g.LEASE,action:e,...t})}prompt(e,{where:t=Ee.DOCUMENT}={}){if(!this.connected)return null;let r=String(e??"").trim().slice(0,2e3);if(!r)return null;let o=E();return this.#r({t:g.PROMPT,id:o,text:r,where:t}),o}answer(e,t="",{reply:r=null,made:o=null,model:s=null}={}){return this.connected?(this.#r({t:g.ANSWER,state:e,text:String(t??"").slice(0,2e3),reply:r,made:o,model:s}),!0):!1}stopAnswer(e){return!this.connected||!e?!1:(this.#r({t:g.STOP,id:e}),!0)}get state(){return this.session.state()}checkpoint({doc:e=!0}={}){return{epoch:this.epoch,author:this.author,...this.session.checkpoint({doc:e})}}composite(e){return this.session.composite(e)}connect(e){return this.transport=e,this.pendingToken=this.getToken?this.getToken():void 0,this.pendingToken?.catch?.(()=>{}),e.onopen=async()=>{this.connected=!0,this.welcomed=!1,clearInterval(this.heartbeat),this.heartbeat=setInterval(()=>{this.connected&&this.#r({t:g.PING})},lt),await this.#t()},e.onmessage=t=>this.#n(t),e.onclose=()=>{this.connected=!1,this.welcomed=!1,clearInterval(this.heartbeat),this.onStatus({connected:!1})},e.readyState===1&&e.onopen(),this}disconnect(){if(this.transport){this.connected=!1,this.welcomed=!1,clearInterval(this.heartbeat);try{this.transport.close()}catch{}this.transport=null,this.onStatus({connected:!1})}}async#t(){let e;if(this.pendingToken!==void 0){let r=this.pendingToken;this.pendingToken=void 0,e=await r}else e=this.getToken?await this.getToken():void 0;let t=this.session.state();this.#r({t:g.HELLO,author:this.author,name:this.name,token:e,since:t.seq,...this.agent?{agent:!0}:{},...this.answers?{answers:!0}:{},docId:t.doc.id})}#n(e){let t=je(e);if(t)switch(t.t){case S.WELCOME:return this.#o(t);case S.REHELLO:return this.welcomed=!1,void this.#t();case S.OPS:return this.#c(t);case S.REJECT:return this.#l(t);case S.PRESENCE:return this.participants=t.participants||[],this.onPresence(this.participants);case S.STROKE:return this.onStroke(t);case S.LEASE:return this.leases=t.leases||[],this.onLeases(this.leases);case S.PROMPT:return this.onPrompt(t);case S.ANSWER:return this.onAnswer(t);case S.STOP:return this.onStop(t);case S.ERROR:if(this.#u(t.message)){this.strokePreview=!1;return}return this.onLost({kind:"protocol",message:t.message});default:return}}#o(e){this.you=e.you,this.welcomed=!0;let t=this.session.pending();if(e.catchup.kind===xe.SNAPSHOT){let{h:r,dropped:o}=this.core.call("session.resume",{doc:e.catchup.doc,author:this.author,seed:this.seed,seq:e.catchup.seq,pending:t});this.session.close(),this.session=new j(this.core,r),this.epoch++,o&&o.length&&this.onLost({kind:"rebased",ops:o,message:`${o.length} edit${o.length>1?"s":""} could not be replayed onto the current document`})}else for(let r of e.catchup.ops||[])this.#i(r);this.participants=e.participants||[],this.leases=e.leases||[],t.length&&this.#r({t:g.SUBMIT,ops:t}),this.presence&&this.#r({t:g.PRESENCE,...this.presence}),this.onStatus({connected:!0,resent:t.length}),this.onPresence(this.participants),this.onLeases(this.leases),this.onChange(),this.#e?.(),this.#e=null}#c(e){let t=!1;for(let r of e.ops||[])this.#i(r),t=!0;t&&this.onChange()}#i(e){let t=this.session.remote(e);t.dropped&&t.dropped.length&&this.onLost({kind:"obsolete",ops:t.dropped,message:`${t.dropped.length} of your edits no longer apply and were dropped`})}#l(e){e.opId&&this.session.reject(e.opId),this.onLost({kind:e.kind,ops:e.opId?[e.opId]:[],message:e.message}),this.onChange()}#s(e){!e.length||!this.connected||!this.welcomed||this.#r({t:g.SUBMIT,ops:e})}#r(e){this.#a(ke(e))}#u(e){return typeof e!="string"?!1:e===`unknown message: ${g.STROKE}`?!0:e==="unreadable message"&&Date.now()-(this._strokeSentAt??0)<2e3}#a(e){if(this.transport)try{this.transport.send(e)}catch{this.connected=!1}}close(){this.disconnect(),this.session.close()}};T();Te();function ht(n){try{return/^(localhost|127\.0\.0\.1|\[::1\]|::1)$/.test(new URL(p(n)).hostname)}catch{return!1}}function Ae(n,{publicServer:e=$}={}){let t=p(n);return e&&n===e?`nothing is answering at ${t} \u2014 this machine is offline, or the site is down`:ht(n)?`nothing is answering at ${t} \u2014 start the editor with \`npm start\` in the Pixie repository, then try again`:`nothing is answering at ${t} \u2014 check the address and that whatever serves it is up`}var pt=6e3,L=class{constructor(e,t){this.core=e,this.author=t.author,this.name=t.name||"agent",this.connectTransport=t.connect,this.getToken=t.getToken??null,this.createDocument=t.createDocument??null,this.control=t.control??null,this.rooms=new Map,this.asked=[],this.onAsked=null,this.jobs=new Map,this.log=[]}async open(e,{w:t=32,h:r=32,name:o=e}={}){let s=this.rooms.get(e);if(s)return s.client;let i=this.core.newDocument({w:t,h:r,name:o,seed:Ie(),now:Date.now()}),a=new N(this.core,i,{author:this.author,name:this.name,seed:Ie(),agent:!0,getToken:this.getToken?()=>this.getToken(e):null});a.onLost=h=>{this.lastRefusal=h},a.onPrompt=h=>{if(h.author===this.author)return;let m=h.where==="library";this.asked.push({text:h.text,from:h.name,at:h.at,wants:m?"a new sprite":"a change to this one",room:m?null:e,askedIn:e}),this.asked.length>32&&this.asked.shift(),this.onAsked?.()};let c=this.connectTransport(e,{w:t,h:r,name:o}),l=!1;return await new Promise((h,m)=>{let f=setTimeout(()=>m(new Error(`timed out joining ${e}`)),1e4);a.onStatus=d=>{d.connected&&(l=!0,clearTimeout(f),h())},a.connect(c);let y=c.onclose;c.onclose=()=>{y?.(),!l&&(clearTimeout(f),m(new Error(this.serverUrl?Ae(this.serverUrl):"nothing is answering at the room server")))}}),this.rooms.set(e,{client:a}),a}client(e){let t=this.rooms.get(e);if(!t)throw new Error(`not in room ${e}`);return t.client}async peek(e){return this.rooms.has(e)?this.client(e):this.open(e)}async begin(e,t,{layer:r=null,open:o={}}={}){let s=await this.open(e,o),i=E();if(s.lease("acquire",{job:i,intent:t,...r?{layers:[r]}:{}}),await Oe(s),!s.leases.find(l=>l.job===i)){let l=s.leases[0];throw new Error(l?`"${e}" is already held by another job: ${l.intent}`:`could not claim "${e}"`)}let c={room:e,layer:r,intent:t,cancelled:!1,timer:setInterval(()=>{this.jobs.has(i)&&s.lease("renew",{job:i})},pt)};return c.timer.unref&&c.timer.unref(),this.jobs.set(i,c),this.note("begin_job",e,t),i}resolve(e){if(e){let o=this.jobs.get(e);if(!o)throw new Error(`unknown job ${e} \u2014 it may have finished`);if(o.cancelled)throw new Error("the user stopped you \u2014 do not retry; say what you were about to do and ask");return{job:e,...o}}if(this.jobs.size===0)throw new Error("no job is open \u2014 call new_sprite or begin_job first");if(this.jobs.size>1)throw new Error(`${this.jobs.size} jobs are open \u2014 pass the job argument`);let[t,r]=[...this.jobs.entries()][0];return{job:t,...r}}finish(e){let t=this.jobs.get(e);t&&(clearInterval(t.timer),this.jobs.delete(e),this.client(t.room).lease("release",{job:e}),this.note("finish_job",t.room,t.intent))}async submit(e,t,r){let o=this.resolve(e),s=this.client(o.room);if(!r.length)return{ops:0};if(this.lastRefusal=null,s.apply(r,{label:t,job:o.job,now:Date.now()}),await Oe(s),this.lastRefusal){let i=this.lastRefusal.message;throw this.lastRefusal.kind==="revoked"&&(o.cancelled=!0),this.lastRefusal=null,new Error(i)}return this.note(t,o.room,`${r.length} op${r.length>1?"s":""}`),{ops:r.length,seq:s.state.seq}}cancel(e){let t=this.jobs.get(e);t&&(t.cancelled=!0)}note(e,t,r){this.log.unshift({at:Date.now(),tool:e,room:t,detail:r}),this.log.length>200&&this.log.pop()}announce(){if(!this.serverUrl)return;let e=`${this.serverUrl.replace(/^ws/,"http").replace(/\/$/,"")}/agent`,t=()=>{fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({name:this.name})}).catch(()=>{})};t(),clearInterval(this.heartbeat),this.heartbeat=setInterval(t,15e3),this.heartbeat.unref?.()}close(){clearInterval(this.heartbeat);for(let[e]of this.jobs)this.finish(e);for(let{client:e}of this.rooms.values())e.close();this.rooms.clear()}get kind(){return"room"}get where(){return this.serverUrl??"a room server"}supports(e){return e==="open_editor"?!!this.editorUrl:mt.has(e)}async openEditor({document:e,job:t}={}){if(!this.editorUrl)return{ok:!1,message:"there is no editor to open from here"};let r=this.editorUrl;try{r=`${this.editorUrl}/d/${this.#t(e,t)}`}catch{r=`${this.editorUrl}/library`}return await wt(r),{ok:!0,message:`Opened ${r}`}}async newSprite({name:e,w:t=32,h:r=32,intent:o,palette:s,folder:i=null}){let a=await this.createDocument?.({name:e,w:t,h:r})??Re(e),c=await this.begin(a,o,{open:{w:t,h:r,name:e}});return s?.length&&await this.submit(c,"set_palette",[{t:"setPalette",colors:s}]),i&&await this.moveDocuments({documents:[a],folder:i,make:!0}),this.#e(a,o),{job:c,...this.#n(a)}}async#e(e,t){let r=process.env.SPRITE_ASKED_IN,o=process.env.SPRITE_REPLY_TO??null;if(r)try{(await this.open(r)).answer("thinking",t?String(t).slice(0,200):"making a new sprite",{reply:o,made:e})}catch{}}async beginJob({document:e,intent:t,layer:r=null}){return{job:await this.begin(e,t,{layer:r}),...this.#n(String(e))}}finishJob({job:e}){let t=this.resolve(e);return this.finish(t.job),{finished:t.intent,document:t.room}}#t(e,t){return e?String(e):this.resolve(t).room}async info({document:e,job:t}={}){let r=this.#t(e,t);return await this.peek(r),this.#n(r)}#n(e){let t=this.client(e),r=t.state;return{document:e,name:r.doc.name,w:r.doc.w,h:r.doc.h,layers:r.doc.layers.map(o=>o.name),frames:r.doc.frames.length,palette:r.doc.palette,tags:r.doc.tags.map(o=>o.name),seq:r.seq,participants:t.participants.map(o=>o.name)}}async readArt({document:e,job:t,layer:r,frame:o=0,trim:s=!1}){let i=this.#t(e,t),a=await this.peek(i);return{document:i,...a.session.readArt(this.#o(i,r),o,{trim:s})}}async preview({document:e,job:t,frame:r=0}){let o=await this.peek(this.#t(e,t)),s=this.#t(e,t);return{png:o.session.png(r),caption:`${s}, frame ${r+1}`}}async sheet({document:e,job:t,columns:r=4,scale:o=2}){let s=this.#t(e,t),i=await this.peek(s);return{png:i.session.contactSheet({columns:r,scale:o}),caption:`${s}, ${i.state.doc.frames.length} frames, numbered left to right`}}async documents(){let e=[...this.jobs.entries()].map(([c,l])=>({job:c,document:l.room,intent:l.intent})),t=[...this.rooms.keys()],r=null,o=null,s=null,i=this.control?await this.control("/documents",{}).catch(()=>null):null;if(i)r=i.documents?.map(c=>c.id)??null,o=Array.isArray(i.folders)?i.folders.map(c=>typeof c=="string"?c:c?.path??c?.name).filter(Boolean):null,s=i.documents?Object.fromEntries(i.documents.filter(c=>c.folder).map(c=>[c.id,c.folder])):null;else if(this.serverUrl){let c=this.serverUrl.replace(/^ws/,"http").replace(/\/$/,"");r=await fetch(`${c}/documents`).then(l=>l.ok?l.json():null).then(l=>l?.documents?.map(u=>u.id)).catch(()=>null)}return{documents:r?[...new Set([...t,...r])]:t,jobs:e,open:t,...o?{folders:o}:{},...s?{filed:s}:{}}}async createFolder({name:e}){if(!this.control)throw new Error("no library here: this Sprite has no accounts, so there are no folders");let t=String(e??"").trim();if(!t)throw new Error("a folder needs a name");let r=await this.folders();if(r.includes(t))return{folder:t,created:!1,folders:r};let o=t.split("/");for(let s=1;s<=o.length;s++){let i=o.slice(0,s).join("/");r.includes(i)||(await this.control("/documents/folders",{method:"POST",body:{name:i}}),r.push(i))}return{folder:t,created:!0,folders:await this.folders()}}async moveDocuments({documents:e,folder:t=null,make:r=!1}){if(!this.control)throw new Error("no library here: this Sprite has no accounts, so there are no folders");let o=(Array.isArray(e)?e:[e]).map(String).filter(Boolean);if(!o.length)throw new Error("say which documents");let s=t===null||t===""?null:String(t).trim();s&&r&&await this.createFolder({name:s});let i=await this.control("/documents/move",{method:"POST",body:{ids:o,folder:s}});return{moved:o,folder:s,ok:i?.ok!==!1}}async folders(){let e=await this.control("/documents",{});return Array.isArray(e?.folders)?e.folders.map(t=>typeof t=="string"?t:t?.path??t?.name).filter(Boolean):[]}takeRequests(){let e=this.asked.splice(0,this.asked.length);return{requests:e,note:e.length?"Each says what it wants. Where `room` is set, answer in that document. Where it is null the request came from the library and wants a new sprite \u2014 call new_sprite and work there, and do not touch `askedIn`, which is only the room the words travelled through. The person is watching.":"Nobody has asked for anything."}}#o(e,t){let r=this.client(e).state;if(t!=null&&t!==""){let o=typeof t=="number"?r.doc.layers[t]:r.doc.layers.find(s=>s.name===t||s.id===t);if(!o)throw new Error(`no layer ${JSON.stringify(t)} in ${e}`);return o.id}return r.doc.layers[r.doc.layers.length-1].id}async drawArt({job:e,rows:t,colors:r,x:o=0,y:s=0,center:i=!1,clear:a=!1,layer:c,frame:l=0,label:u}){let h=this.resolve(e),f=this.client(h.room).session.drawArt(t,r,{layer:c!=null?this.#o(h.room,c):h.layer??this.#o(h.room,null),at:l,x:o,y:s,center:i,clear:a});return await this.submit(h.job,u||"draw_art",f),{...this.#n(h.room),drew:`${t[0]?.length??0}\xD7${t.length}`}}async drawAnimation({job:e,frames:t,colors:r,fps:o,layer:s,label:i}){let a=this.resolve(e),c=this.client(a.room),l=s!=null?this.#o(a.room,s):a.layer??this.#o(a.room,null),u=c.state.doc.frames.length,h=t.length-u;if(h>0){let f=[],y=c.state.doc.frames[u-1]?.index??"V";for(let d=0;d<h;d++)y=y+"V",f.push({t:"addFrame",id:E(),index:y,durMs:V(o)});await this.submit(a.job,"add frames",f)}if(o){let f=V(o);await this.submit(a.job,"set fps",c.state.doc.frames.map(y=>({t:"setFrameDur",id:y.id,durMs:f})))}let m=c.session.drawAnimation(t,r,{layer:l});return await this.submit(a.job,i||"draw_animation",m),{...this.#n(a.room),wrote:`${t.length} frames`}}async addLayer({job:e,name:t}){let r=this.resolve(e),o=this.client(r.room).state,s=o.doc.layers[o.doc.layers.length-1];return await this.submit(r.job,"add_layer",[{t:"addLayer",id:E(),index:(s?.index??"V")+"V",name:t||`Layer ${o.doc.layers.length+1}`,visible:!0,locked:!1,opacity:1}]),this.#n(r.room)}async addFrame({job:e,copy:t=!1}){let r=this.resolve(e),o=this.client(r.room),s=o.state,i=s.doc.frames[s.doc.frames.length-1],a=E(),c=[{t:"addFrame",id:a,index:(i?.index??"V")+"V",durMs:i?.durMs??83}];if(t&&i)for(let l of s.doc.layers){let u=o.session.cel(l.id,i.id);u.every(h=>h===0)||c.push(Pe(l.id,a,s.doc,u))}return await this.submit(r.job,"add_frame",c),this.#n(r.room)}async setPalette({job:e,colors:t}){let r=this.resolve(e);return await this.submit(r.job,"set_palette",[{t:"setPalette",colors:t}]),{...this.#n(r.room),palette:t.length}}async setFps({job:e,fps:t}){let r=this.resolve(e),o=this.client(r.room).state,s=V(t);return await this.submit(r.job,"set_fps",o.doc.frames.map(i=>({t:"setFrameDur",id:i.id,durMs:s}))),{...this.#n(r.room),fps:t}}async clearCel({job:e,layer:t,frame:r=0}){let o=this.resolve(e),i=this.client(o.room).state,a=this.#o(o.room,t??o.layer),c=i.doc.frames[r];if(!c)throw new Error(`no frame ${r} in ${o.room}`);let l=new Uint8Array(i.doc.w*i.doc.h*4);return await this.submit(o.job,"clear",[Pe(a,c.id,i.doc,l)]),this.#n(o.room)}async trim({job:e,margin:t=0}){let r=this.resolve(e),o=this.client(r.room),s=o.state,i=this.#o(r.room,r.layer),a=o.session.readArt(i,0,{trim:!0}),c=a.rect.w+t*2,l=a.rect.h+t*2;return c>=s.doc.w&&l>=s.doc.h?{...this.#n(r.room),trimmed:"already tight"}:(await this.submit(r.job,"trim_canvas",[{t:"resize",w:c,h:l,dx:-a.rect.x+t,dy:-a.rect.y+t}]),{...this.#n(r.room),trimmed:`${c}\xD7${l}`})}},mt=new Set(["new_sprite","begin_job","finish_job","draw_art","draw_animation","read_art","render_preview","render_animation","add_layer","add_frame","set_palette","set_fps","clear","trim_canvas","get_info","list_documents","take_requests","create_folder","move_documents"]);function Pe(n,e,t,r){return{t:"paintRegion",layer:n,frame:e,rect:{x:0,y:0,w:t.w,h:t.h},rle:ft(r)}}function ft(n){let e=[];if(n.length){let t=[n[0],n[1],n[2],n[3]],r=0,o=()=>{let s=r;do{let i=s&127;s>>=7,e.push(s?i|128:i)}while(s);e.push(...t)};for(let s=0;s<n.length;s+=4)n[s]===t[0]&&n[s+1]===t[1]&&n[s+2]===t[2]&&n[s+3]===t[3]?r++:(o(),t=[n[s],n[s+1],n[s+2],n[s+3]],r=1);o()}return Buffer.from(Uint8Array.from(e)).toString("base64")}function wt(n){let e=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";return new Promise(t=>dt(e,[n],()=>t()))}function V(n){return!n||n<=0?83:Math.max(10,Math.round(1e3/n))}function Oe(n,e=400){return new Promise(t=>{let r=Date.now(),o=()=>{if(n.state.pending===0&&Date.now()-r>40||Date.now()-r>e)return t();setTimeout(o,10)};o()})}function Ie(){return(Date.now()^Math.floor(Math.random()*4294967295))>>>0}import{execFile as yt}from"node:child_process";var gt=2e4,bt=5e3,A=class n{constructor({base:e,name:t="agent"}={}){this.base=String(e).replace(/\/$/,""),this.name=t,this.log=[],this.beat=setInterval(()=>void this.announce(),bt),this.beat.unref&&this.beat.unref()}get kind(){return"local"}get where(){return this.base}supports(e){return St.has(e)}static async probe(e,{timeoutMs:t=700}={}){try{let r=await fetch(`${e.replace(/\/$/,"")}/bridge/status`,{signal:AbortSignal.timeout(t)});if(!r.ok)return null;let o=await r.json();return o?.server==="sprite"?o:null}catch{return null}}async announce(){try{await fetch(`${this.base}/bridge/agent`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({name:this.name,version:null}),signal:AbortSignal.timeout(2e3)})}catch{}}async call(e,t=[],r=gt){let o;try{o=await(await fetch(`${this.base}/bridge/call`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({method:e,args:t,timeoutMs:r}),signal:AbortSignal.timeout(r+2e3)})).json()}catch(s){throw new Error(`lost contact with the Pixie editor at ${this.base}: ${s.message}`)}if(!o.ok)throw new Error(o.error);return this.note(e),o.result}note(e,t=""){this.log.unshift({at:Date.now(),tool:e,room:"local",detail:t}),this.log.length>200&&this.log.pop()}newSprite({name:e,w:t=32,h:r=32,intent:o,palette:s}){return this.call("newSprite",[{w:t,h:r,name:e,palette:s,intent:o,replace:!1}])}beginJob({document:e,intent:t}){return this.call("beginJob",[{document:e,intent:t}])}finishJob({job:e}){return this.call("finishJob",[{job:e}])}async info({document:e}={}){let t=await this.call("info",[]);return{editor:this.base,...e?{asked:e}:{},...t}}readArt({document:e,layer:t,frame:r}){return this.call("readArt",[{document:e,layer:t,frame:r}])}async preview({document:e,frame:t,scale:r=8}){let o=await this.call("toDataURL",[t??null,r,e??null]);return{png:Ne(o.url),caption:o.caption}}async sheet({document:e,columns:t=0,scale:r=0}){let o=await this.call("toStripDataURL",[{document:e??null,columns:t,scale:r}]);return{png:Ne(o.url),caption:o.caption}}documents(){return this.call("listDocuments",[])}drawArt({job:e,rows:t,colors:r,x:o,y:s,center:i,clear:a,layer:c,frame:l,label:u}){return this.call("drawArt",[t,r,{job:e,x:o,y:s,center:i,clear:a,layer:c,frame:l,label:u}])}drawAnimation({job:e,frames:t,colors:r,fps:o,layer:s,label:i}){return this.call("drawAnimation",[{frames:t,colors:r,fps:o,job:e,layer:s,label:i}])}addLayer({name:e}){return this.call("addLayer",[e])}addFrame({copy:e=!1}){return this.call("addFrame",[{copy:!!e}])}setPalette({colors:e}){return this.call("setPalette",[e])}setFps({fps:e}){return this.call("setFps",[e])}clearCel({job:e,layer:t,frame:r}){return this.call("clear",[{job:e,layer:t,frame:r}])}trim({job:e,margin:t=0}){return this.call("trimCanvas",[{job:e,margin:t}])}setFrame({index:e}){return this.call("setFrame",[e])}setLayer({index:e}){return this.call("setLayer",[e])}select({document:e}){return this.call("selectDocument",[e])}closeDocument({document:e}){return this.call("closeDocument",[e??null])}undo(){return this.call("undo",[])}redo(){return this.call("redo",[])}async openEditor(){if((await n.probe(this.base))?.connected)return{ok:!0,message:`Editor already connected at ${this.base}`};await Et(this.base);let t=Date.now()+1e4;for(;Date.now()<t;){if((await n.probe(this.base))?.connected)return{ok:!0,message:`Editor connected at ${this.base}`};await new Promise(o=>setTimeout(o,200))}return{ok:!1,message:`Opened ${this.base} but nothing connected \u2014 check the browser window.`}}close(){clearInterval(this.beat)}},St=new Set(["new_sprite","begin_job","finish_job","draw_art","draw_animation","read_art","render_preview","render_animation","add_layer","add_frame","set_palette","set_fps","clear","trim_canvas","get_info","list_documents","open_editor","select_document","close_document","set_frame","set_layer","undo","redo"]);function Ne(n){let e=String(n??"").split(",")[1];if(!e)throw new Error("the editor returned something that was not an image");return Buffer.from(e,"base64")}function Et(n){let e=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";return new Promise(t=>yt(e,[n],()=>t()))}var C={type:"string",description:"#rrggbb"},b={type:"string",description:"The job this call belongs to. May be omitted when exactly one job is open."},P={type:"string",description:"Which document to read. Omit to use the one your job owns. In a local editor a 0-based tab index or a name both work; in a room it is the room name."};var Ce=n=>({content:[{type:"text",text:typeof n=="string"?n:JSON.stringify(n)}]}),Le=(n,e)=>({content:[{type:"image",data:Buffer.from(n).toString("base64"),mimeType:"image/png"},{type:"text",text:e}]}),xt=[{name:"new_sprite",description:"Create a sprite and claim it. Call this FIRST \u2014 before writing a script, computing a grid, or thinking about pixels. It costs milliseconds and puts a labelled document in front of the user immediately, so they can see what you are making and where. The tab opens in the background and never steals their focus.",inputSchema:{type:"object",properties:{name:{type:"string",description:"Document name. Shown on the tab and used for exports."},w:{type:"integer",default:32},h:{type:"integer",default:32},palette:{type:"array",items:C,description:"Optional starting palette."},intent:{type:"string",description:"One line on what you are making. Shown while you work."},folder:{type:"string",description:'Optional folder to file it in, by path (`food/sushi`). Made if it does not exist. Use this when the user asks for sprites "in a folder" rather than moving them afterwards.'}},required:["name","intent"]},run:(n,e)=>e.newSprite({name:n.name,w:n.w??32,h:n.h??32,intent:n.intent,palette:n.palette,folder:n.folder??null})},{name:"begin_job",description:"Claim an existing document for one piece of work \u2014 the other way to start, where new_sprite is the one for new art. Refused by name if another job holds it, which is what keeps parallel requests from colliding.",inputSchema:{type:"object",properties:{document:P,intent:{type:"string"},layer:{type:"string",description:"Restrict the claim to one layer, leaving the rest free. Rooms only."}},required:["document","intent"]},run:(n,e)=>e.beginJob({document:n.document,intent:n.intent,layer:n.layer??null})},{name:"finish_job",description:"Release the document. Call this when the sprite is done, so the user knows to look.",inputSchema:{type:"object",properties:{job:b}},run:(n,e)=>e.finishJob({job:n.job})},{name:"draw_art",description:'Draw a character grid. Each string in `rows` is one row of pixels and each character maps to a colour via `colors`. "." and " " leave existing pixels alone; a colour mapped to null erases. Every character is resolved before a pixel moves, so a typo fails rather than half-drawing. Keep the palette small \u2014 four to eight colours, reused for shading \u2014 because that is what makes art read as pixel art rather than as a downscaled photograph.',inputSchema:{type:"object",properties:{rows:{type:"array",items:{type:"string"}},colors:{type:"object",additionalProperties:{oneOf:[C,{type:"null"}]}},x:{type:"integer"},y:{type:"integer"},center:{type:"boolean"},clear:{type:"boolean",description:"Erase the cel first."},layer:{type:"string",description:"Layer name or index. Defaults to the top one."},frame:{type:"integer",description:"Frame index. Defaults to the first."},label:{type:"string",description:"What this shows as in the undo history."},job:b},required:["rows","colors"]},run:(n,e)=>e.drawArt({job:n.job,rows:n.rows,colors:n.colors,x:n.x??0,y:n.y??0,center:n.center??!1,clear:n.clear??!1,layer:n.layer,frame:n.frame??0,label:n.label})},{name:"draw_animation",description:"Write every frame in ONE call, as a single undo step. Use copyPrevious so a frame carries the last one forward and sends only the pixels that moved \u2014 that is what takes a six-frame loop from four thousand tokens of restated grid to under a thousand. Never loop draw_art.",inputSchema:{type:"object",properties:{frames:{type:"array",minItems:1,items:{type:"object",properties:{rows:{type:"array",items:{type:"string"}},copyPrevious:{type:"boolean"},x:{type:"integer"},y:{type:"integer"},center:{type:"boolean"}},required:["rows"]}},colors:{type:"object",additionalProperties:{oneOf:[C,{type:"null"}]}},fps:{type:"number"},layer:{type:"string"},label:{type:"string"},job:b},required:["frames","colors"]},run:(n,e)=>e.drawAnimation({job:n.job,frames:n.frames,colors:n.colors,fps:n.fps,layer:n.layer,label:n.label})},{name:"read_art",description:"Read a cel back as a grid \u2014 the exact inverse of draw_art, so you can extend art a human drew rather than only replacing it. Reads never need a job and never wait.",inputSchema:{type:"object",properties:{document:P,layer:{type:"string"},frame:{type:"integer"},trim:{type:"boolean",description:"Return only the drawn area. Rooms only."},job:b}},run:(n,e)=>e.readArt({document:n.document,job:n.job,layer:n.layer,frame:n.frame??0,trim:n.trim??!1})},{name:"render_preview",description:"See one frame as an image, so you can check your own work rather than working blind.",inputSchema:{type:"object",properties:{document:P,frame:{type:"integer"},scale:{type:"integer"},job:b}},async run(n,e){let t=await e.preview({document:n.document,job:n.job,frame:n.frame??0,scale:n.scale??8});return Le(t.png,t.caption)}},{name:"render_animation",description:"Every frame as one numbered contact sheet. Stills inspected one call at a time, minutes apart, cannot tell you whether motion reads; a contact sheet can, in one call. Check any animation with this before calling it done.",inputSchema:{type:"object",properties:{document:P,columns:{type:"integer",default:4},scale:{type:"integer",default:2},job:b}},async run(n,e){let t=await e.sheet({document:n.document,job:n.job,columns:n.columns??4,scale:n.scale??2});return Le(t.png,t.caption)}},{name:"add_layer",description:"Add a layer above the others. Separate layers keep pieces independently editable.",inputSchema:{type:"object",properties:{name:{type:"string"},job:b}},run:(n,e)=>e.addLayer({job:n.job,name:n.name})},{name:"add_frame",description:"Add an animation frame after the last one.",inputSchema:{type:"object",properties:{copy:{type:"boolean",description:"Start from the previous frame."},job:b}},run:(n,e)=>e.addFrame({job:n.job,copy:n.copy??!1})},{name:"set_palette",description:"Replace the palette. Constraining yourself to a small fixed palette is the single biggest quality lever in pixel art.",inputSchema:{type:"object",properties:{colors:{type:"array",items:C,minItems:1},job:b},required:["colors"]},run:(n,e)=>e.setPalette({job:n.job,colors:n.colors})},{name:"set_fps",description:"Set playback speed for every frame. Eight to twelve suits character animation.",inputSchema:{type:"object",properties:{fps:{type:"integer",minimum:1,maximum:60},job:b},required:["fps"]},run:(n,e)=>e.setFps({job:n.job,fps:n.fps})},{name:"clear",description:"Erase a cel. Destructive, so it goes through a job like every other write.",inputSchema:{type:"object",properties:{layer:{type:"string"},frame:{type:"integer"},job:b}},run:(n,e)=>e.clearCel({job:n.job,layer:n.layer,frame:n.frame??0})},{name:"trim_canvas",description:"Crop the canvas to the drawn pixels. CALL THIS BEFORE finish_job ON EVERY SPRITE. You cannot know a sprite's extent before you have drawn it, so overshoot at new_sprite and trim afterwards \u2014 empty space is inherited by every export, thumbnail and sprite sheet.",inputSchema:{type:"object",properties:{margin:{type:"integer",default:0},job:b}},run:(n,e)=>e.trim({job:n.job,margin:n.margin??0})},{name:"get_info",description:"What is in a document \u2014 size, layers, frames, palette \u2014 and who else is looking at it.",inputSchema:{type:"object",properties:{document:P,job:b}},run:(n,e)=>e.info({document:n.document,job:n.job})},{name:"list_documents",description:'Every document you can reach, and every job currently open. Call this when the user names a sprite ("add a frame to the hamster") so you can pass it to begin_job. Never guess a name.',inputSchema:{type:"object",properties:{}},run:(n,e)=>e.documents()},{name:"create_folder",description:"Make a folder in the library, by path \u2014 `food/sushi` nests. Already existing is fine. Prefer passing `folder` to new_sprite when the sprites are new; use this for an empty folder or before move_documents.",inputSchema:{type:"object",properties:{name:{type:"string",description:"The folder path."}},required:["name"]},run:(n,e)=>e.createFolder({name:n.name})},{name:"move_documents",description:"File documents into a folder, or back to the top level with folder null. Takes document ids from list_documents. The folder is made if it does not exist.",inputSchema:{type:"object",properties:{documents:{type:"array",items:{type:"string"},description:"Document ids."},folder:{type:["string","null"],description:"Folder path, or null for the top level."}},required:["documents"]},run:(n,e)=>e.moveDocuments({documents:n.documents,folder:n.folder??null,make:!0})},{name:"take_requests",description:"Requests people have typed into the editor and not yet been answered. Call this when the user asks you to check, or after joining a room they are in. Each one is somebody asking for a sprite in words \u2014 treat it exactly as if they had said it to you directly. Each carries what it wants: a `room` to answer in, or `room: null` for a request typed at the library, which wants a brand new sprite rather than a change to any existing one.",inputSchema:{type:"object",properties:{}},run:(n,e)=>e.takeRequests()},{name:"open_editor",description:"Open the Pixie editor in the default browser and wait for it to connect. Run this first if nothing is connected.",inputSchema:{type:"object",properties:{}},async run(n,e){let t=await e.openEditor();return Ce(t.message)}},{name:"select_document",description:"Bring a document to the front for the USER to look at. This does not give you the right to draw in it \u2014 begin_job does that.",inputSchema:{type:"object",properties:{document:{type:["string","integer"]}},required:["document"]},run:(n,e)=>e.select({document:n.document})},{name:"close_document",description:"Close a document tab. The document stays in the library, so this tidies the workspace rather than deleting anything.",inputSchema:{type:"object",properties:{document:{type:["string","integer"]}}},run:(n,e)=>e.closeDocument({document:n.document??null})},{name:"set_frame",description:"Move the user to a frame, by 0-based index.",inputSchema:{type:"object",properties:{index:{type:"integer"}},required:["index"]},run:(n,e)=>e.setFrame({index:n.index})},{name:"set_layer",description:"Move the user to a layer, by 0-based index counting from the bottom.",inputSchema:{type:"object",properties:{index:{type:"integer"}},required:["index"]},run:(n,e)=>e.setLayer({index:n.index})},{name:"undo",description:"Undo the last change, so the user can always reject generated art.",inputSchema:{type:"object",properties:{}},run:(n,e)=>e.undo()},{name:"redo",description:"Redo the last undone change.",inputSchema:{type:"object",properties:{}},run:(n,e)=>e.redo()}];function De(n){return xt.filter(e=>n.supports(e.name)).map(e=>({name:e.name,description:e.description,inputSchema:e.inputSchema,run:async t=>{let r=await e.run(t??{},n);return r&&typeof r=="object"&&Array.isArray(r.content)?r:Ce(r)}}))}import{readFileSync as kt}from"node:fs";var vt="0.3.0";function _t(){let n=new URL("./version.json",import.meta.url);try{let e=JSON.parse(kt(n,"utf8"))?.version;if(typeof e=="string"&&e)return e;throw new Error("it names no version")}catch(e){throw new Error(`${n.pathname} could not be read as a version: ${e.message}`)}}var Ue=vt??_t();function G(n="room"){return`Pixel art editor with live collaboration. ${n==="local"?`Documents are tabs in a browser window on this machine. The user is
|
|
2
|
+
var j=(r,e)=>()=>(r&&(e=r(r=0)),e);function we(r){let e="";for(let t=0;t<r.length;t+=32768)e+=String.fromCharCode.apply(null,r.subarray(t,t+32768));return btoa(e).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}var ye=j(()=>{"use strict"});var $,nt,rt,on,ge=j(()=>{"use strict";$="[A-Za-z0-9_-]{1,64}",nt="token|members|link|slow|project",rt=[{owner:"accounts",re:new RegExp("^/auth/")},{owner:"accounts",re:new RegExp("^/a/[A-Za-z0-9_-]{1,64}\\.png$")},{owner:"accounts",re:new RegExp("^/projects(/|$)")},{owner:"accounts",re:new RegExp(`^/documents/${$}/(${nt})$`)},{owner:"library",re:new RegExp("^/documents$")},{owner:"library",re:new RegExp("^/documents/(new|register|move|order|folders|folders/delete|trash|trash/empty)$")},{owner:"library",re:new RegExp(`^/documents/${$}(/(thumbnail\\.png|duplicate|rename|restore))?$`)},{owner:"library",re:new RegExp(`^/documents/${$}/history/at/\\d+/thumbnail\\.png$`)},{owner:"document",re:new RegExp(`^/documents/${$}/history(/at/\\d+|/\\d+)?$`)},{owner:"document",re:new RegExp(`^/documents/${$}/comments(/[A-Za-z0-9]{1,40})?$`)},{owner:"document",re:new RegExp(`^/documents/${$}/snapshots(/enabled|/[A-Za-z0-9_-]{1,128})?$`)},{owner:"document",re:new RegExp(`^/favourites(/order|/(document|project)/${$})?$`)}],on=rt.map(({owner:r,re:e})=>({owner:r,source:e.source}))});var G,K=j(()=>{"use strict";ge();G=["read","draw","create","organize"]});async function be(r){let e=new TextEncoder().encode(String(r));return we(new Uint8Array(await crypto.subtle.digest("SHA-256",e)))}var pn,Se=j(()=>{"use strict";ye();K();pn=120*1e3});function x(r=Date.now()){let e="0123456789ABCDEFGHJKMNPQRSTVWXYZ",t=(BigInt(r)&0xffffffffffffn)<<80n,n=crypto.getRandomValues(new Uint8Array(10)),o=0n;for(let i of n)o=o<<8n|BigInt(i);t|=o;let s="";for(let i=0;i<26;i++)s=e[Number(t&31n)]+s,t>>=5n;return s}function v(r){return r==null?{at:0}:typeof r=="number"?{at:r}:{frame:r}}var ht,ut,dt,L,R,Z,O=j(()=>{"use strict";ht=new TextEncoder,ut=new TextDecoder,dt=1;L=class r{#e;#n;constructor(e){this.#e=e,this.#n=e.exports}static async load(e){let t;if(e instanceof WebAssembly.Module)t=await WebAssembly.instantiate(e,{});else if(e instanceof ArrayBuffer||ArrayBuffer.isView(e))({instance:t}=await WebAssembly.instantiate(e,{}));else{let n=e instanceof Response||typeof e?.then=="function"?e:fetch(e);({instance:t}=await WebAssembly.instantiateStreaming(n,{}))}return new r(t)}get#r(){return new Uint8Array(this.#n.memory.buffer)}call(e,t={}){let n=ht.encode(JSON.stringify({m:e,a:t})),o=this.#n.sprite_alloc(n.length);if(!o)throw new Error("sprite-core: allocation failed");let s=0;try{if(this.#r.set(n,o),s=this.#n.sprite_dispatch(o,n.length),!s)throw new Error("sprite-core: dispatch returned nothing");let i=this.#r,a=i[s]|i[s+1]<<8|i[s+2]<<16|i[s+3]<<24,c=i[s+4],l=i.slice(s+5,s+5+a);if(c===dt)return l;let h=JSON.parse(ut.decode(l));if(h&&h.error)throw new Error(h.error);return h}finally{s?this.#n.sprite_free_result(s):this.#n.sprite_dealloc(o,n.length)}}reset(){this.#n.sprite_reset()}newDocument(e={}){return this.call("doc.new",{w:32,h:32,name:"untitled",...e})}openSession(e,t,n=1){let{h:o}=this.call("session.new",{doc:e,author:t,seed:n});return new R(this,o)}openRoom(e,{seq:t=0}={}){let{h:n}=this.call("room.new",{doc:e,...t>0?{seq:t}:{}});return new Z(this,n)}},R=class{constructor(e,t){this.core=e,this.h=t}#e(e,t={}){return this.core.call(e,{h:this.h,...t})}state(){return this.#e("session.state")}apply(e,{now:t=Date.now(),label:n="Edit",job:o=null}={}){let s={now:t,label:n,bodies:Array.isArray(e)?e:[e]};return o&&(s.job=o),this.#e("session.apply",s).ops}remote(e){return this.#e("session.remote",{sop:e})}reject(e){return this.#e("session.reject",{op:e})}undo(e=Date.now()){return this.#e("session.undo",{now:e}).ops}redo(e=Date.now()){return this.#e("session.redo",{now:e}).ops}pending(){return this.#e("session.pending")}checkpoint({doc:e=!0}={}){return this.#e("session.checkpoint",{doc:e})}save(){return this.#e("session.save")}drawArt(e,t,n={}){return this.#e("session.drawArt",{rows:e,colors:t,...n}).bodies}drawAnimation(e,t,n={}){return this.#e("session.drawAnimation",{frames:e,colors:t,...n}).bodies}readArt(e,t,n={}){return this.#e("session.readArt",{layer:e,...v(t),...n})}cel(e,t){return this.#e("session.cel",{layer:e,...v(t)})}layerImage(e,t){return this.#e("session.layerImage",{layer:e,...v(t)})}tileCel(e,t){return this.#e("session.tileCel",{layer:e,...v(t)})}tile(e,t){return this.#e("session.tile",{tileset:e,index:t})}composite(e,{include:t="export"}={}){return this.#e("session.composite",{...v(e),include:t})}png(e,{scale:t=1}={}){return this.#e("session.png",{...v(e),scale:Math.max(1,Math.round(t)||1)})}contactSheet({columns:e=4,scale:t=2}={}){return this.#e("session.sheet",{columns:e,scale:t})}thumbnail(e=48){return this.#e("session.thumbnail",{size:e})}card({frame:e=null,width:t=1200,height:n=630,framing:o=null,bleed:s=0,raw:i=!1}={}){return this.#e("session.card",{width:t,height:n,...o??{},...v(e),...s?{bleed:s}:{},...i?{raw:i}:{}})}cardLayout({frame:e=null,width:t=1200,height:n=630,framing:o=null}={}){return this.#e("session.cardLayout",{width:t,height:n,...o??{},...v(e)})}fit({width:e,height:t,margin:n=0,inscribed:o=!1,dx:s=0,dy:i=0,frame:a=null}){return this.#e("session.fit",{width:e,height:t,margin:n,inscribed:o,dx:s,dy:i,...v(a)})}close(){this.#e("session.free")}},Z=class{constructor(e,t){this.core=e,this.h=t}#e(e,t={}){return this.core.call(e,{h:this.h,...t})}state(){return this.#e("room.state")}submit(e,t=Date.now()){return this.#e("room.submit",{op:e,now:t})}since(e){return this.#e("room.since",{seq:e})}compact(){return this.#e("room.compact")}save(){return this.#e("room.save")}lease(e,t){return this.#e("room.lease",{action:e,...t})}close(){this.#e("room.free")}}});function Re(r){return JSON.stringify(r)}function Te(r){let e=r.rle instanceof Uint8Array?r.rle:null,t=new TextEncoder().encode(JSON.stringify({...r,rle:void 0}));if(t.length>pt)return null;let n=new Uint8Array(3+t.length+(e?.length??0));return n[0]=Ae,n[1]=t.length&255,n[2]=t.length>>8&255,n.set(t,3),e&&n.set(e,3+t.length),n}function mt(r){return r instanceof Uint8Array?r:r instanceof ArrayBuffer?new Uint8Array(r):ArrayBuffer.isView(r)?new Uint8Array(r.buffer,r.byteOffset,r.byteLength):null}function Pe(r){if(typeof r!="string"){let e=mt(r);if(!e||e.length<3||e[0]!==Ae)return null;let t=e[1]|e[2]<<8;if(e.length<3+t)return null;try{let n=JSON.parse(new TextDecoder().decode(e.subarray(3,3+t)));if(!n||typeof n.t!="string")return null;let o=e.subarray(3+t);return n.rle=o.length?Uint8Array.from(o):null,n}catch{return null}}try{let e=JSON.parse(r);return e&&typeof e.t=="string"?e:null}catch{return null}}var g,je,S,$e,Ae,pt,Oe=j(()=>{"use strict";g={HELLO:"hello",SUBMIT:"submit",PRESENCE:"presence",STROKE:"stroke",LEASE:"lease",PING:"ping",PROMPT:"prompt",ANSWER:"answer",STOP:"stop"},je={DOCUMENT:"document",LIBRARY:"library"},S={WELCOME:"welcome",REHELLO:"rehello",OPS:"ops",REJECT:"reject",PRESENCE:"presence",STROKE:"stroke",LEASE:"lease",ERROR:"error",PONG:"pong",PROMPT:"prompt",ANSWER:"answer",STOP:"stop"},$e={OPS:"ops",SNAPSHOT:"snapshot"};Ae=157,pt=65535});function wt(r){return String(r??"").trim().toLowerCase().replace(/[^a-z0-9_-]+/g,"-").replace(/^-+|-+$/g,"").replace(/-{2,}/g,"-").slice(0,64).replace(/-+$/,"")||null}function Ie(r){return`${(wt(r)??"").slice(0,48).replace(/-+$/,"")||"sprite"}-${x().toLowerCase().slice(0,12)}`}var Ne=j(()=>{"use strict";O()});import{readFile as Mt}from"node:fs/promises";import{readFile as Ve,writeFile as Ge,mkdir as Ke,chmod as Ze}from"node:fs/promises";import{readFileSync as Xe}from"node:fs";import{homedir as Ye,hostname as Qe}from"node:os";import{join as H}from"node:path";import{execFile as et}from"node:child_process";var p=r=>String(r??"").replace(/\/+$/,"").replace(/^ws/,"http"),ne=r=>String(r??"").replace(/\/+$/,"").replace(/^http/,"ws");async function re(r,e){if(!r?.ok||!(r.headers.get("content-type")??"").includes("json"))return null;let t=await r.json().catch(()=>null);return!t||typeof t!="object"?null:e.some(n=>n in t)?t:null}async function oe(r,{timeoutMs:e=3e3,fetchImpl:t=fetch}={}){try{let n=await t(`${p(r)}/setup`,{signal:AbortSignal.timeout(e)});return await re(n,["accounts","expectedPort","install"])}catch{return null}}var J=new Map;function se(r,{fetchImpl:e=fetch,timeoutMs:t=3e3}={}){let n=p(r);return J.has(n)||J.set(n,He(r,{fetchImpl:e,timeoutMs:t})),J.get(n)}async function He(r,{fetchImpl:e,timeoutMs:t}){try{let n=await e(`${p(r)}/config.json`,{signal:AbortSignal.timeout(t)}),s=(await re(n,["rooms","accounts"]))?.rooms;if(typeof s=="string"&&/^(wss?|https?):\/\/./.test(s))return ne(s)}catch{}return ne(r)}var T=process.env.SPRITE_PUBLIC_SERVER||tt()||null;function tt(){return"wss://drawpixie.com"}var ie=H(process.env.XDG_CONFIG_HOME||H(Ye(),".config"),"sprite"),V=H(ie,"agent.json"),ae=r=>String(r??"").replace(/\/+$/,"");function ce(){return`${Qe().replace(/\.local$/,"")}`.slice(0,60)||"a computer"}async function le(){try{let r=JSON.parse(await Ve(V,"utf8"));return r&&typeof r=="object"&&r.servers?r:{servers:{}}}catch{return{servers:{}}}}async function P(r){return process.env.SPRITE_TOKEN?{token:process.env.SPRITE_TOKEN,from:"the environment"}:(await le()).servers[ae(r)]??null}async function he(r,e){await Ke(ie,{recursive:!0,mode:448});let t=await le();t.servers[ae(r)]={...e,at:Date.now()};let n=`${V}.tmp`;await Ge(n,JSON.stringify(t,null,2),{mode:384}),await Ze(n,384);let{rename:o}=await import("node:fs/promises");await o(n,V)}async function ue(r,{timeoutMs:e=3e3}={}){try{let t=await fetch(`${p(r)}/setup`,{signal:AbortSignal.timeout(e)});return t.ok?!!(await t.json()).accounts:!1}catch{return!1}}async function de(r,e,{session:t=null}={}){let n=t??await P(r);if(!n?.token)return;let o=await fetch(`${p(r)}/documents/${encodeURIComponent(e)}/token`,{headers:{Authorization:`Bearer ${n.token}`}});if(o.status===401)throw new Error("this machine is signed out \u2014 pair it again");if(o.status===403)throw new Error(`no access to ${e}`);if(!o.ok)throw new Error(`could not get access to ${e}`);return(await o.json()).token}async function pe(r,{name:e,w:t,h:n},{session:o=null}={}){let s=o??await P(r);if(!s?.token)return;let i=await fetch(`${p(r)}/documents/new`,{method:"POST",headers:{Authorization:`Bearer ${s.token}`,"Content-Type":"application/json"},body:JSON.stringify({name:e,w:t,h:n})});if(i.status===401)throw new Error("this machine is signed out \u2014 pair it again");if(!i.ok)throw new Error(`could not make a document: the server said ${i.status}`);let{id:a}=await i.json();if(typeof a!="string"||!a)throw new Error("could not make a document: the server named none");return a}async function me(r,e,{method:t="GET",body:n=null,session:o=null}={}){let s=o??await P(r);if(!s?.token)return;let i=await fetch(`${p(r)}${e}`,{method:t,headers:{Authorization:`Bearer ${s.token}`,...n!==null?{"Content-Type":"application/json"}:{}},body:n!==null?JSON.stringify(n):void 0});if(i.status===401)throw new Error("this machine is signed out \u2014 pair it again");let a=await i.json().catch(()=>({}));if(!i.ok)throw new Error(a?.error?String(a.error):`the server said ${i.status}`);return a}function fe(r){let e=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";return new Promise(t=>et(e,[r],()=>t()))}Se();K();import{createServer as ot}from"node:http";import{randomBytes as xe}from"node:crypto";var st=300*1e3,it=()=>xe(32).toString("base64url"),at=()=>xe(16).toString("base64url");function Ee(r,e){return`<!doctype html><meta charset="utf-8"><title>Pixie</title><body style="background:#101014;color:#d8d8e0;font:14px/1.6 system-ui,sans-serif;display:grid;place-items:center;height:100vh;margin:0;text-align:center"><div><p style="font-size:16px">${r}</p><p style="color:#8a8a99;font-size:12px">${e}</p></div>`}async function ct({state:r,timeoutMs:e}){let t,n,o=new Promise((c,l)=>{t=c,n=l}),s=ot((c,l)=>{let h=new URL(c.url,"http://127.0.0.1");if(h.pathname!=="/callback"){l.writeHead(404).end();return}if(h.searchParams.get("state")!==r){l.writeHead(404).end();return}let u=h.searchParams.get("error");l.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}).end(u?Ee("Nothing was granted.","You can close this window."):Ee("This computer can now draw in your sprites.","You can close this window and go back to what you were doing.")),t(h.searchParams)});await new Promise((c,l)=>{s.once("error",l),s.listen(0,"127.0.0.1",c)});let i=setTimeout(()=>n(new Error("nobody answered the browser in time")),e);i.unref?.();let{port:a}=s.address();return{redirect:`http://127.0.0.1:${a}/callback`,wait:o,close:()=>{clearTimeout(i),s.close(),s.closeAllConnections?.()}}}async function ke(r,{onUrl:e=()=>{},open:t=fe,label:n="the Pixie agent",scope:o=G,timeoutMs:s=st}={}){let i=it(),a=await be(i),c=at(),l=await ct({state:c,timeoutMs:s});try{let h=new URL(`${p(r)}/authorize`);h.searchParams.set("challenge",a),h.searchParams.set("state",c),h.searchParams.set("redirect",l.redirect),h.searchParams.set("scope",o.join(",")),h.searchParams.set("name",n),e(h.toString()),await t(h.toString());let u=await l.wait,m=u.get("error");if(m)throw new Error(m==="access_denied"?"you said no on that screen, so nothing was granted":`that request was refused: ${m}`);let f=u.get("code");if(!f)throw new Error("the browser came back without an authorization");let w=await fetch(`${p(r)}/auth/authorize/exchange`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({code:f,verifier:i,name:ce()})}),d=await w.json().catch(()=>({}));if(!w.ok||!d.token)throw new Error(d.error||"that authorization could not be exchanged");return await he(r,{token:d.token,name:d.name,email:d.email,scope:d.scope??null}),d}finally{l.close()}}import{realpathSync as ve}from"node:fs";import{fileURLToPath as lt}from"node:url";function _e(r){let e=process.argv[1];if(!e)return!1;try{return ve(lt(r))===ve(e)}catch{return!1}}O();import{execFile as kt}from"node:child_process";Oe();O();var ft=5e3,D=class{#e=null;constructor(e,t,n){if(!n||!n.author)throw new Error("DocumentClient needs an author");if(this.core=e,this.author=n.author,this.name=n.name||"anonymous",this.agent=n.agent===!0,this.answers=n.answers===!0,this.seed=n.seed??1,this.epoch=0,this.resumed=null,n.resume){let{h:o,dropped:s}=e.call("session.resume",{doc:t,author:this.author,seed:this.seed,seq:n.resume.seq??0,pending:n.resume.pending??[]});this.session=new R(e,o),this.resumed={seq:n.resume.seq??0,dropped:s??[]}}else this.session=e.openSession(t,this.author,this.seed);this.getToken=n.getToken??null,this.transport=null,this.connected=!1,this.welcomed=!1,this.ready=new Promise(o=>{this.#e=o}),this.participants=[],this.leases=[],this.presence=null,this.you=null,this.onChange=()=>{},this.onPresence=()=>{},this.onStroke=()=>{},this.strokePreview=!0,this.onLeases=()=>{},this.onLost=()=>{},this.waiters=new Set,this.onPrompt=()=>{},this.onAnswer=()=>{},this.onStop=()=>{},this.onStatus=()=>{}}apply(e,t={}){let n=this.session.apply(e,t);return this.#a(n),this.onChange(),n}acked(e,{timeoutMs:t=3e4}={}){let n=new Set((Array.isArray(e)?e:[e]).map(o=>o?.opId??o).filter(Boolean));return new Promise((o,s)=>{let i={ids:n,resolve:o,reject:s,timer:null};i.timer=setTimeout(()=>{this.waiters.delete(i);let a=[...n].filter(c=>this.session.pending().some(l=>l.opId===c)).length;s(new Error(`${a} operation${a===1?"":"s"} not confirmed by the room after ${Math.round(t/1e3)}s \u2014 `+(this.connected?"it is answering slowly":`the connection dropped; nothing since sequence ${this.session.state().seq} has been saved`)))},t),this.waiters.add(i),this.#n()})}#n(){if(!this.waiters.size)return;let e=new Set(this.session.pending().map(t=>t.opId));for(let t of this.waiters)[...t.ids].some(n=>e.has(n))||(this.waiters.delete(t),clearTimeout(t.timer),t.resolve())}#r(e,t){for(let n of this.waiters)n.ids.has(e)&&(this.waiters.delete(n),clearTimeout(n.timer),n.reject(new Error(t)))}undo(e=Date.now()){let t=this.session.undo(e);return this.#a(t),this.onChange(),t}redo(e=Date.now()){let t=this.session.redo(e);return this.#a(t),this.onChange(),t}setPresence(e){this.presence=e,this.connected&&this.#o({t:g.PRESENCE,...e})}sendStroke({layer:e,frame:t,rect:n,rle:o,done:s=!1}){if(!this.connected||!this.welcomed||!this.strokePreview)return;this._strokeSentAt=Date.now();let i=Te({t:g.STROKE,layer:e,frame:t,rect:n,rle:o,done:s});i&&this.#l(i)}lease(e,t={}){this.#o({t:g.LEASE,action:e,...t})}prompt(e,{where:t=je.DOCUMENT}={}){if(!this.connected)return null;let n=String(e??"").trim().slice(0,2e3);if(!n)return null;let o=x();return this.#o({t:g.PROMPT,id:o,text:n,where:t}),o}answer(e,t="",{reply:n=null,made:o=null,model:s=null}={}){return this.connected?(this.#o({t:g.ANSWER,state:e,text:String(t??"").slice(0,2e3),reply:n,made:o,model:s}),!0):!1}stopAnswer(e){return!this.connected||!e?!1:(this.#o({t:g.STOP,id:e}),!0)}get state(){return this.session.state()}checkpoint({doc:e=!0}={}){return{epoch:this.epoch,author:this.author,...this.session.checkpoint({doc:e})}}composite(e){return this.session.composite(e)}connect(e){return this.transport=e,this.pendingToken=this.getToken?this.getToken():void 0,this.pendingToken?.catch?.(()=>{}),e.onopen=async()=>{this.connected=!0,this.welcomed=!1,clearInterval(this.heartbeat),this.heartbeat=setInterval(()=>{this.connected&&this.#o({t:g.PING})},ft),await this.#t()},e.onmessage=t=>this.#i(t),e.onclose=()=>{this.connected=!1,this.welcomed=!1,clearInterval(this.heartbeat),this.onStatus({connected:!1})},e.readyState===1&&e.onopen(),this}disconnect(){if(this.transport){this.connected=!1,this.welcomed=!1,clearInterval(this.heartbeat);try{this.transport.close()}catch{}this.transport=null,this.onStatus({connected:!1})}}async#t(){let e;if(this.pendingToken!==void 0){let n=this.pendingToken;this.pendingToken=void 0,e=await n}else e=this.getToken?await this.getToken():void 0;let t=this.session.state();this.#o({t:g.HELLO,author:this.author,name:this.name,token:e,since:t.seq,...this.agent?{agent:!0}:{},...this.answers?{answers:!0}:{},docId:t.doc.id})}#i(e){let t=Pe(e);if(t)switch(t.t){case S.WELCOME:return this.#s(t);case S.REHELLO:return this.welcomed=!1,void this.#t();case S.OPS:return this.#h(t);case S.REJECT:return this.#u(t);case S.PRESENCE:return this.participants=t.participants||[],this.onPresence(this.participants);case S.STROKE:return this.onStroke(t);case S.LEASE:return this.leases=t.leases||[],this.onLeases(this.leases);case S.PROMPT:return this.onPrompt(t);case S.ANSWER:return this.onAnswer(t);case S.STOP:return this.onStop(t);case S.ERROR:if(this.#d(t.message)){this.strokePreview=!1;return}return this.onLost({kind:"protocol",message:t.message});default:return}}#s(e){this.you=e.you,this.welcomed=!0;let t=this.session.pending();if(e.catchup.kind===$e.SNAPSHOT){let{h:n,dropped:o}=this.core.call("session.resume",{doc:e.catchup.doc,author:this.author,seed:this.seed,seq:e.catchup.seq,pending:t});if(this.session.close(),this.session=new R(this.core,n),this.epoch++,o&&o.length){for(let s of o)this.#r(s,"could not be replayed onto the current document");this.onLost({kind:"rebased",ops:o,message:`${o.length} edit${o.length>1?"s":""} could not be replayed onto the current document`})}}else for(let n of e.catchup.ops||[])this.#c(n);this.#n(),this.participants=e.participants||[],this.leases=e.leases||[],t.length&&this.#o({t:g.SUBMIT,ops:t}),this.presence&&this.#o({t:g.PRESENCE,...this.presence}),this.onStatus({connected:!0,resent:t.length}),this.onPresence(this.participants),this.onLeases(this.leases),this.onChange(),this.#e?.(),this.#e=null}#h(e){let t=!1;for(let n of e.ops||[])this.#c(n),t=!0;t&&(this.#n(),this.onChange())}#c(e){let t=this.session.remote(e);t.dropped&&t.dropped.length&&this.onLost({kind:"obsolete",ops:t.dropped,message:`${t.dropped.length} of your edits no longer apply and were dropped`})}#u(e){e.opId&&this.session.reject(e.opId),e.opId&&this.#r(e.opId,e.message),this.onLost({kind:e.kind,ops:e.opId?[e.opId]:[],message:e.message}),this.onChange()}#a(e){!e.length||!this.connected||!this.welcomed||this.#o({t:g.SUBMIT,ops:e})}#o(e){this.#l(Re(e))}#d(e){return typeof e!="string"?!1:e===`unknown message: ${g.STROKE}`?!0:e==="unreadable message"&&Date.now()-(this._strokeSentAt??0)<2e3}#l(e){if(this.transport)try{this.transport.send(e)}catch{this.connected=!1}}close(){this.disconnect(),this.session.close()}};O();Ne();var k=r=>{let e=String(r).replace("#","");return[parseInt(e.slice(0,2),16),parseInt(e.slice(2,4),16),parseInt(e.slice(4,6),16)]};var A=([r,e,t])=>.3*r+.59*e+.11*t;function U([r,e,t]){let n=Math.max(r,e,t),o=Math.min(r,e,t),s=n-o,i=0;return s&&(n===r?i=(e-t)/s%6:n===e?i=(t-r)/s+2:i=(r-e)/s+4,i*=60,i<0&&(i+=360)),[i,n?s/n:0,n/255]}var Ce={luminance:(r,e)=>A(k(r))-A(k(e)),hue:(r,e)=>{let[t,n]=U(k(r)),[o,s]=U(k(e));return n<.08||s<.08?n<.08&&s<.08?A(k(r))-A(k(e)):n<.08?-1:1:Math.round(t/20)!==Math.round(o/20)?t-o:A(k(r))-A(k(e))},saturation:(r,e)=>U(k(r))[1]-U(k(e))[1]};function X(r,e="hue"){let t=Ce[e]??Ce.hue;return[...r].sort(t)}function yt(r){try{return/^(localhost|127\.0\.0\.1|\[::1\]|::1)$/.test(new URL(p(r)).hostname)}catch{return!1}}function Le(r,{publicServer:e=T}={}){let t=p(r);return e&&r===e?`nothing is answering at ${t} \u2014 this machine is offline, or the site is down`:yt(r)?`nothing is answering at ${t} \u2014 start the editor with \`npm start\` in the Pixie repository, then try again`:`nothing is answering at ${t} \u2014 check the address and that whatever serves it is up`}var M={type:"string",description:"#rrggbb"},b={type:"string",description:"The job this call belongs to. May be omitted when exactly one job is open."},I={type:"string",description:"Which document to read. Omit to use the one your job owns. In a local editor a 0-based tab index or a name both work; in a room it is the room name."};var Ue=r=>({content:[{type:"text",text:typeof r=="string"?r:JSON.stringify(r)}]}),De=(r,e)=>({content:[{type:"image",data:Buffer.from(r).toString("base64"),mimeType:"image/png"},{type:"text",text:e}]}),E={w:80,h:42},gt="40\xD721, 80\xD742, 120\xD763, 160\xD784, 240\xD7126",bt="40\xD740, 50\xD750, 80\xD780, 100\xD7100",St="60\xD720, 75\xD725, 150\xD750, 300\xD7100";function Me(r,e){return!r||!e?null:r===e?"This is square, the shape of a profile picture: in the editor, file \u25B8 Save as profile picture (400\xD7400) fits it inside the circle it will be cropped to. Tell the user.":r===3*e?"This is 3:1, the shape of a profile banner: in the editor, file \u25B8 Save as profile banner (1500\xD7500) exports it at the size X wants. Tell the user.":Math.abs(r/e-1200/630)<.02?"This is the link-card shape: the share button posts it edge to edge.":null}function Et(r){let e=String(r??"").trim();if(!/^[A-Za-z0-9]+([-_][A-Za-z0-9]+)+$/.test(e))return e;let t=e.split(/[-_]+/).join(" ");return t[0].toUpperCase()+t.slice(1)}var xt=[{name:"new_sprite",description:"Create a sprite and claim it. Call this FIRST \u2014 before writing a script, computing a grid, or thinking about pixels. It costs milliseconds and puts a labeled document in front of the user immediately, so they can see what you are making and where. The tab opens in the background and never steals their focus.",inputSchema:{type:"object",properties:{name:{type:"string",description:'The title, the way a person would write it: "Blue cake", not "blue-cake". Shown on the tab and in the library; the URL is minted from it. A hyphenated lowercase name is turned into words.'},w:{type:"integer",default:E.w,description:`Width in pixels. The default canvas is ${E.w}\xD7${E.h} \u2014 1.91:1, the ratio link cards crop to, so a piece drawn on it posts edge to edge. Keep that ratio for anything made to be shared: ${gt}. A PROFILE PICTURE is square and cropped to a circle \u2014 keep the subject inside it: ${bt}. A BANNER is 3:1: ${St}. Use a game asset's own size (8\xD78, 16\xD716, 32\xD732) only when the user asks for a tile, icon, or sprite for a game.`},h:{type:"integer",default:E.h,description:"Height in pixels. See w."},palette:{type:"array",items:M,description:"Optional starting palette."},intent:{type:"string",description:"One line on what you are making. Shown while you work."},folder:{type:"string",description:'Optional folder to file it in, by path (`food/sushi`). Made if it does not exist. Use this when the user asks for sprites "in a folder" rather than moving them afterwards.'}},required:["name","intent"]},run:(r,e)=>e.newSprite({name:Et(r.name),w:r.w??E.w,h:r.h??E.h,intent:r.intent,palette:r.palette,folder:r.folder??null})},{name:"begin_job",description:"Claim an existing document for one piece of work \u2014 the other way to start, where new_sprite is the one for new art. Refused by name if another job holds it, which is what keeps parallel requests from colliding.",inputSchema:{type:"object",properties:{document:I,intent:{type:"string"},layer:{type:"string",description:"Restrict the claim to one layer, leaving the rest free. Rooms only."}},required:["document","intent"]},run:(r,e)=>e.beginJob({document:r.document,intent:r.intent,layer:r.layer??null})},{name:"finish_job",description:"Release the document. Call this when the sprite is done, so the user knows to look. The result says what to do next for a profile picture, a banner or a card \u2014 pass that on to the user.",inputSchema:{type:"object",properties:{job:b}},run:(r,e)=>e.finishJob({job:r.job})},{name:"draw_art",description:'Returns when the room has confirmed the drawing \u2014 `seq` is the room\'s number for it and `committed` is true \u2014 or fails saying why; if it says the connection dropped, wait a moment and check get_info before drawing more. Draw a character grid. Each string in `rows` is one row of pixels and each character maps to a color via `colors`. "." and " " leave existing pixels alone; a color mapped to null erases. Every character is resolved before a pixel moves, so a typo fails rather than half-drawing. Keep the palette small \u2014 four to eight colors, reused for shading \u2014 because that is what makes art read as pixel art rather than as a downscaled photograph.',inputSchema:{type:"object",properties:{rows:{type:"array",items:{type:"string"}},colors:{type:"object",additionalProperties:{oneOf:[M,{type:"null"}]}},x:{type:"integer"},y:{type:"integer"},center:{type:"boolean"},clear:{type:"boolean",description:"Erase the cel first."},layer:{type:"string",description:"Layer name or index. Defaults to the top one."},frame:{type:"integer",description:"Frame index. Defaults to the first."},label:{type:"string",description:"What this shows as in the undo history."},job:b},required:["rows","colors"]},run:(r,e)=>e.drawArt({job:r.job,rows:r.rows,colors:r.colors,x:r.x??0,y:r.y??0,center:r.center??!1,clear:r.clear??!1,layer:r.layer,frame:r.frame??0,label:r.label})},{name:"draw_animation",description:"Write every frame in ONE call, as a single undo step. Use copyPrevious so a frame carries the last one forward and sends only the pixels that moved \u2014 that is what takes a six-frame loop from four thousand tokens of restated grid to under a thousand. Never loop draw_art.",inputSchema:{type:"object",properties:{frames:{type:"array",minItems:1,items:{type:"object",properties:{rows:{type:"array",items:{type:"string"}},copyPrevious:{type:"boolean"},x:{type:"integer"},y:{type:"integer"},center:{type:"boolean"}},required:["rows"]}},colors:{type:"object",additionalProperties:{oneOf:[M,{type:"null"}]}},fps:{type:"number"},layer:{type:"string"},label:{type:"string"},job:b},required:["frames","colors"]},run:(r,e)=>e.drawAnimation({job:r.job,frames:r.frames,colors:r.colors,fps:r.fps,layer:r.layer,label:r.label})},{name:"read_art",description:"Read a cel back as a grid \u2014 the exact inverse of draw_art, so you can extend art a human drew rather than only replacing it. Reads never need a job and never wait.",inputSchema:{type:"object",properties:{document:I,layer:{type:"string"},frame:{type:"integer"},trim:{type:"boolean",description:"Return only the drawn area. Rooms only."},job:b}},run:(r,e)=>e.readArt({document:r.document,job:r.job,layer:r.layer,frame:r.frame??0,trim:r.trim??!1})},{name:"render_preview",description:"See one frame as an image, so you can check your own work rather than working blind.",inputSchema:{type:"object",properties:{document:I,frame:{type:"integer"},scale:{type:"integer"},job:b}},async run(r,e){let t=await e.preview({document:r.document,job:r.job,frame:r.frame??0,scale:r.scale??8});return De(t.png,t.caption)}},{name:"render_animation",description:"Every frame as one numbered contact sheet. Stills inspected one call at a time, minutes apart, cannot tell you whether motion reads; a contact sheet can, in one call. Check any animation with this before calling it done.",inputSchema:{type:"object",properties:{document:I,columns:{type:"integer",default:4},scale:{type:"integer",default:2},job:b}},async run(r,e){let t=await e.sheet({document:r.document,job:r.job,columns:r.columns??4,scale:r.scale??2});return De(t.png,t.caption)}},{name:"add_layer",description:"Add a layer above the others. Separate layers keep pieces independently editable.",inputSchema:{type:"object",properties:{name:{type:"string"},job:b}},run:(r,e)=>e.addLayer({job:r.job,name:r.name})},{name:"add_frame",description:"Add an animation frame after the last one.",inputSchema:{type:"object",properties:{copy:{type:"boolean",description:"Start from the previous frame."},job:b}},run:(r,e)=>e.addFrame({job:r.job,copy:r.copy??!1})},{name:"set_palette",description:"Replace the palette. Constraining yourself to a small fixed palette is the single biggest quality lever in pixel art.",inputSchema:{type:"object",properties:{colors:{type:"array",items:M,minItems:1},job:b},required:["colors"]},run:(r,e)=>e.setPalette({job:r.job,colors:r.colors})},{name:"set_fps",description:"Set playback speed for every frame. Eight to twelve suits character animation.",inputSchema:{type:"object",properties:{fps:{type:"integer",minimum:1,maximum:60},job:b},required:["fps"]},run:(r,e)=>e.setFps({job:r.job,fps:r.fps})},{name:"clear",description:"Erase a cel. Destructive, so it goes through a job like every other write.",inputSchema:{type:"object",properties:{layer:{type:"string"},frame:{type:"integer"},job:b}},run:(r,e)=>e.clearCel({job:r.job,layer:r.layer,frame:r.frame??0})},{name:"trim_canvas",description:"Crop the canvas to the drawn pixels. Call this before finish_job on every GAME ASSET \u2014 a tile, an icon, a sprite for a sheet: you cannot know its extent before you have drawn it, so overshoot at new_sprite and trim afterwards, or empty space is inherited by every export and sheet. Do NOT trim a piece made to be posted: its canvas is the card, and the space around the subject is the composition.",inputSchema:{type:"object",properties:{margin:{type:"integer",default:0},job:b}},run:(r,e)=>e.trim({job:r.job,margin:r.margin??0})},{name:"get_info",description:"What is in a document \u2014 size, layers, frames, palette \u2014 and who else is looking at it; `connected` says whether the room is on the other end and `pending` how many operations it has not confirmed. Both should be true and zero before you trust a read.",inputSchema:{type:"object",properties:{document:I,job:b}},run:(r,e)=>e.info({document:r.document,job:r.job})},{name:"list_documents",description:'Every document you can reach, and every job currently open. Call this when the user names a sprite ("add a frame to the hamster") so you can pass it to begin_job. Never guess a name.',inputSchema:{type:"object",properties:{}},run:(r,e)=>e.documents()},{name:"create_folder",description:"Make a folder in the library, by path \u2014 `food/sushi` nests. Already existing is fine. Prefer passing `folder` to new_sprite when the sprites are new; use this for an empty folder or before move_documents.",inputSchema:{type:"object",properties:{name:{type:"string",description:"The folder path."}},required:["name"]},run:(r,e)=>e.createFolder({name:r.name})},{name:"move_documents",description:"File documents into a folder, or back to the top level with folder null. Takes document ids from list_documents. The folder is made if it does not exist.",inputSchema:{type:"object",properties:{documents:{type:"array",items:{type:"string"},description:"Document ids."},folder:{type:["string","null"],description:"Folder path, or null for the top level."}},required:["documents"]},run:(r,e)=>e.moveDocuments({documents:r.documents,folder:r.folder??null,make:!0})},{name:"take_requests",description:"Requests people have typed into the editor and not yet been answered. Call this when the user asks you to check, or after joining a room they are in. Each one is somebody asking for a sprite in words \u2014 treat it exactly as if they had said it to you directly. Each carries what it wants: a `room` to answer in, or `room: null` for a request typed at the library, which wants a brand new sprite rather than a change to any existing one.",inputSchema:{type:"object",properties:{}},run:(r,e)=>e.takeRequests()},{name:"open_editor",description:"Open the Pixie editor in the default browser and wait for it to connect. Run this first if nothing is connected.",inputSchema:{type:"object",properties:{}},async run(r,e){let t=await e.openEditor();return Ue(t.message)}},{name:"select_document",description:"Bring a document to the front for the USER to look at. This does not give you the right to draw in it \u2014 begin_job does that.",inputSchema:{type:"object",properties:{document:{type:["string","integer"]}},required:["document"]},run:(r,e)=>e.select({document:r.document})},{name:"close_document",description:"Close a document tab. The document stays in the library, so this tidies the workspace rather than deleting anything.",inputSchema:{type:"object",properties:{document:{type:["string","integer"]}}},run:(r,e)=>e.closeDocument({document:r.document??null})},{name:"set_frame",description:"Move the user to a frame, by 0-based index.",inputSchema:{type:"object",properties:{index:{type:"integer"}},required:["index"]},run:(r,e)=>e.setFrame({index:r.index})},{name:"set_layer",description:"Move the user to a layer, by 0-based index counting from the bottom.",inputSchema:{type:"object",properties:{index:{type:"integer"}},required:["index"]},run:(r,e)=>e.setLayer({index:r.index})},{name:"undo",description:"Undo the last change, so the user can always reject generated art.",inputSchema:{type:"object",properties:{}},run:(r,e)=>e.undo()},{name:"redo",description:"Redo the last undone change.",inputSchema:{type:"object",properties:{}},run:(r,e)=>e.redo()}];function Be(r){return xt.filter(e=>r.supports(e.name)).map(e=>({name:e.name,description:e.description,inputSchema:e.inputSchema,run:async t=>{let n=await e.run(t??{},r);return n&&typeof n=="object"&&Array.isArray(n.content)?n:Ue(n)}}))}var vt=6e3,B=class{constructor(e,t){this.core=e,this.author=t.author,this.name=t.name||"agent",this.connectTransport=t.connect,this.getToken=t.getToken??null,this.createDocument=t.createDocument??null,this.control=t.control??null,this.rooms=new Map,this.asked=[],this.onAsked=null,this.jobs=new Map,this.log=[]}async open(e,{w:t=32,h:n=32,name:o=e}={}){let s=this.rooms.get(e);if(s)return s.client;let i=this.core.newDocument({w:t,h:n,name:o,seed:ze(),now:Date.now()}),a=new D(this.core,i,{author:this.author,name:this.name,seed:ze(),agent:!0,getToken:this.getToken?()=>this.getToken(e):null});a.onLost=u=>{this.lastRefusal=u},a.onPrompt=u=>{if(u.author===this.author)return;let m=u.where==="library";this.asked.push({text:u.text,from:u.name,at:u.at,wants:m?"a new sprite":"a change to this one",room:m?null:e,askedIn:e}),this.asked.length>32&&this.asked.shift(),this.onAsked?.()};let c=this.connectTransport(e,{w:t,h:n,name:o}),l=!1;return await new Promise((u,m)=>{let f=setTimeout(()=>m(new Error(`timed out joining ${e}`)),1e4);a.onStatus=d=>{d.connected&&(l=!0,clearTimeout(f),u())},a.connect(c);let w=c.onclose;c.onclose=()=>{if(w?.(),l)return this.#e(e,{w:t,h:n,name:o});clearTimeout(f),m(new Error(this.serverUrl?Le(this.serverUrl):"nothing is answering at the room server"))}}),this.rooms.set(e,{client:a,attempts:0}),a}#e(e,t){let n=this.rooms.get(e);if(!n||n.closing)return;let o=Math.min(15e3,1e3*2**Math.min(n.attempts,4));n.attempts+=1,n.retry=setTimeout(()=>{if(!this.rooms.get(e)||n.closing)return;let s=this.connectTransport(e,t),i=!1,a=s.onclose;n.client.onStatus=l=>{l.connected&&(i=!0,n.attempts=0)},n.client.connect(s);let c=s.onclose;s.onclose=()=>{c?.(),a?.(),this.#e(e,t)}},o),n.retry.unref?.()}client(e){let t=this.rooms.get(e);if(!t)throw new Error(`not in room ${e}`);return t.client}async peek(e){return this.rooms.has(e)?this.client(e):this.open(e)}async begin(e,t,{layer:n=null,open:o={}}={}){let s=await this.open(e,o),i=x();if(s.lease("acquire",{job:i,intent:t,...n?{layers:[n]}:{}}),await Rt(s),!s.leases.find(l=>l.job===i)){let l=s.leases[0];throw new Error(l?`"${e}" is already held by another job: ${l.intent}`:`could not claim "${e}"`)}let c={room:e,layer:n,intent:t,cancelled:!1,timer:setInterval(()=>{this.jobs.has(i)&&s.lease("renew",{job:i})},vt)};return c.timer.unref&&c.timer.unref(),this.jobs.set(i,c),this.note("begin_job",e,t),i}resolve(e){if(e){let o=this.jobs.get(e);if(!o)throw new Error(`unknown job ${e} \u2014 it may have finished`);if(o.cancelled)throw new Error("the user stopped you \u2014 do not retry; say what you were about to do and ask");return{job:e,...o}}if(this.jobs.size===0)throw new Error("no job is open \u2014 call new_sprite or begin_job first");if(this.jobs.size>1)throw new Error(`${this.jobs.size} jobs are open \u2014 pass the job argument`);let[t,n]=[...this.jobs.entries()][0];return{job:t,...n}}finish(e){let t=this.jobs.get(e);t&&(clearInterval(t.timer),this.jobs.delete(e),this.client(t.room).lease("release",{job:e}),this.note("finish_job",t.room,t.intent))}async submit(e,t,n){let o=this.resolve(e),s=this.client(o.room);if(!n.length)return{ops:0};if(!s.connected||!s.welcomed)throw new Error(`the room connection dropped \u2014 nothing since sequence ${s.state.seq} has been saved. Reconnecting; try again in a moment, and check get_info before drawing more.`);this.lastRefusal=null;let i=s.state.seq,a=s.apply(n,{label:t,job:o.job,now:Date.now()});try{await s.acked(a,{timeoutMs:3e4})}catch(l){throw this.lastRefusal?.kind==="revoked"&&(o.cancelled=!0),this.lastRefusal=null,l}if(this.lastRefusal){let l=this.lastRefusal.message;throw this.lastRefusal.kind==="revoked"&&(o.cancelled=!0),this.lastRefusal=null,new Error(l)}this.note(t,o.room,`${n.length} op${n.length>1?"s":""}`);let c=s.state.seq;return{ops:n.length,seq:c,committed:c>i}}cancel(e){let t=this.jobs.get(e);t&&(t.cancelled=!0)}note(e,t,n){this.log.unshift({at:Date.now(),tool:e,room:t,detail:n}),this.log.length>200&&this.log.pop()}announce(){if(!this.serverUrl)return;let e=`${this.serverUrl.replace(/^ws/,"http").replace(/\/$/,"")}/agent`,t=()=>{fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({name:this.name})}).catch(()=>{})};t(),clearInterval(this.heartbeat),this.heartbeat=setInterval(t,15e3),this.heartbeat.unref?.()}close(){for(let e of this.rooms.values())e.closing=!0,clearTimeout(e.retry);clearInterval(this.heartbeat);for(let[e]of this.jobs)this.finish(e);for(let{client:e}of this.rooms.values())e.close();this.rooms.clear()}get kind(){return"room"}get where(){return this.serverUrl??"a room server"}supports(e){return e==="open_editor"?!!this.editorUrl:_t.has(e)}async openEditor({document:e,job:t}={}){if(!this.editorUrl)return{ok:!1,message:"there is no editor to open from here"};let n=this.editorUrl;try{n=`${this.editorUrl}/d/${this.#r(e,t)}`}catch{n=`${this.editorUrl}/library`}return await $t(n),{ok:!0,message:`Opened ${n}`}}async newSprite({name:e,w:t=E.w,h:n=E.h,intent:o,palette:s,folder:i=null}){let a=await this.createDocument?.({name:e,w:t,h:n})??Ie(e),c=await this.begin(a,o,{open:{w:t,h:n,name:e}});return s?.length&&await this.submit(c,"set_palette",[{t:"setPalette",colors:X(s,"hue")}]),i&&await this.moveDocuments({documents:[a],folder:i,make:!0}),this.#n(a,o),{job:c,...this.#t(a)}}async#n(e,t){let n=process.env.SPRITE_ASKED_IN,o=process.env.SPRITE_REPLY_TO??null;if(n)try{(await this.open(n)).answer("thinking",t?String(t).slice(0,200):"making a new sprite",{reply:o,made:e})}catch{}}async beginJob({document:e,intent:t,layer:n=null}){return{job:await this.begin(e,t,{layer:n}),...this.#t(String(e))}}finishJob({job:e}){let t=this.resolve(e);this.finish(t.job);let n=this.client(t.room).state,o=Me(n.doc.w,n.doc.h);return{finished:t.intent,document:t.room,...o?{next:o}:{}}}#r(e,t){return e?String(e):this.resolve(t).room}async info({document:e,job:t}={}){let n=this.#r(e,t);return await this.peek(n),this.#t(n)}#t(e){let t=this.client(e),n=t.state;return{document:e,name:n.doc.name,w:n.doc.w,h:n.doc.h,layers:n.doc.layers.map(o=>o.name),frames:n.doc.frames.length,palette:n.doc.palette,tags:n.doc.tags.map(o=>o.name),seq:n.seq,connected:!!(t.connected&&t.welcomed),pending:n.pending,participants:t.participants.map(o=>o.name)}}#i(e){let t=this.client(e),n=t.state;return n.pending===0&&t.connected?{}:{warning:n.pending?`includes ${n.pending} operation${n.pending===1?"":"s"} the room has not confirmed${t.connected?"":" \u2014 the connection dropped, reconnecting"}`:"the room connection dropped, reconnecting"}}async readArt({document:e,job:t,layer:n,frame:o=0,trim:s=!1}){let i=this.#r(e,t),a=await this.peek(i);return{document:i,...a.session.readArt(this.#s(i,n),o,{trim:s}),...this.#i(i)}}async preview({document:e,job:t,frame:n=0}){let o=await this.peek(this.#r(e,t)),s=this.#r(e,t),{warning:i}=this.#i(s);return{png:o.session.png(n),caption:`${s}, frame ${n+1}${i?` \u2014 ${i}`:""}`}}async sheet({document:e,job:t,columns:n=4,scale:o=2}){let s=this.#r(e,t),i=await this.peek(s);return{png:i.session.contactSheet({columns:n,scale:o}),caption:`${s}, ${i.state.doc.frames.length} frames, numbered left to right`}}async documents(){let e=[...this.jobs.entries()].map(([c,l])=>({job:c,document:l.room,intent:l.intent})),t=[...this.rooms.keys()],n=null,o=null,s=null,i=this.control?await this.control("/documents",{}).catch(()=>null):null;if(i)n=i.documents?.map(c=>c.id)??null,o=Array.isArray(i.folders)?i.folders.map(c=>typeof c=="string"?c:c?.path??c?.name).filter(Boolean):null,s=i.documents?Object.fromEntries(i.documents.filter(c=>c.folder).map(c=>[c.id,c.folder])):null;else if(this.serverUrl){let c=this.serverUrl.replace(/^ws/,"http").replace(/\/$/,"");n=await fetch(`${c}/documents`).then(l=>l.ok?l.json():null).then(l=>l?.documents?.map(h=>h.id)).catch(()=>null)}return{documents:n?[...new Set([...t,...n])]:t,jobs:e,open:t,...o?{folders:o}:{},...s?{filed:s}:{}}}async createFolder({name:e}){if(!this.control)throw new Error("no library here: this Sprite has no accounts, so there are no folders");let t=String(e??"").trim();if(!t)throw new Error("a folder needs a name");let n=await this.folders();if(n.includes(t))return{folder:t,created:!1,folders:n};let o=t.split("/");for(let s=1;s<=o.length;s++){let i=o.slice(0,s).join("/");n.includes(i)||(await this.control("/documents/folders",{method:"POST",body:{name:i}}),n.push(i))}return{folder:t,created:!0,folders:await this.folders()}}async moveDocuments({documents:e,folder:t=null,make:n=!1}){if(!this.control)throw new Error("no library here: this Sprite has no accounts, so there are no folders");let o=(Array.isArray(e)?e:[e]).map(String).filter(Boolean);if(!o.length)throw new Error("say which documents");let s=t===null||t===""?null:String(t).trim();s&&n&&await this.createFolder({name:s});let i=await this.control("/documents/move",{method:"POST",body:{ids:o,folder:s}});return{moved:o,folder:s,ok:i?.ok!==!1}}async folders(){let e=await this.control("/documents",{});return Array.isArray(e?.folders)?e.folders.map(t=>typeof t=="string"?t:t?.path??t?.name).filter(Boolean):[]}takeRequests(){let e=this.asked.splice(0,this.asked.length);return{requests:e,note:e.length?"Each says what it wants. Where `room` is set, answer in that document. Where it is null the request came from the library and wants a new sprite \u2014 call new_sprite and work there, and do not touch `askedIn`, which is only the room the words travelled through. The person is watching.":"Nobody has asked for anything."}}#s(e,t){let n=this.client(e).state;if(t!=null&&t!==""){let o=typeof t=="number"?n.doc.layers[t]:n.doc.layers.find(s=>s.name===t||s.id===t);if(!o)throw new Error(`no layer ${JSON.stringify(t)} in ${e}`);return o.id}return n.doc.layers[n.doc.layers.length-1].id}async drawArt({job:e,rows:t,colors:n,x:o=0,y:s=0,center:i=!1,clear:a=!1,layer:c,frame:l=0,label:h}){let u=this.resolve(e),f=this.client(u.room).session.drawArt(t,n,{layer:c!=null?this.#s(u.room,c):u.layer??this.#s(u.room,null),at:l,x:o,y:s,center:i,clear:a}),{committed:w}=await this.submit(u.job,h||"draw_art",f);return{...this.#t(u.room),drew:`${t[0]?.length??0}\xD7${t.length}`,committed:w}}async drawAnimation({job:e,frames:t,colors:n,fps:o,layer:s,label:i}){let a=this.resolve(e),c=this.client(a.room),l=s!=null?this.#s(a.room,s):a.layer??this.#s(a.room,null),h=c.state.doc.frames.length,u=t.length-h;if(u>0){let f=[],w=c.state.doc.frames[h-1]?.index??"V";for(let d=0;d<u;d++)w=w+"V",f.push({t:"addFrame",id:x(),index:w,durMs:Y(o)});await this.submit(a.job,"add frames",f)}if(o){let f=Y(o);await this.submit(a.job,"set fps",c.state.doc.frames.map(w=>({t:"setFrameDur",id:w.id,durMs:f})))}let m=c.session.drawAnimation(t,n,{layer:l});return await this.submit(a.job,i||"draw_animation",m),{...this.#t(a.room),wrote:`${t.length} frames`}}async addLayer({job:e,name:t}){let n=this.resolve(e),o=this.client(n.room).state,s=o.doc.layers[o.doc.layers.length-1];return await this.submit(n.job,"add_layer",[{t:"addLayer",id:x(),index:(s?.index??"V")+"V",name:t||`Layer ${o.doc.layers.length+1}`,visible:!0,locked:!1,opacity:1}]),this.#t(n.room)}async addFrame({job:e,copy:t=!1}){let n=this.resolve(e),o=this.client(n.room),s=o.state,i=s.doc.frames[s.doc.frames.length-1],a=x(),c=[{t:"addFrame",id:a,index:(i?.index??"V")+"V",durMs:i?.durMs??83}];if(t&&i)for(let l of s.doc.layers){let h=o.session.cel(l.id,i.id);h.every(u=>u===0)||c.push(Fe(l.id,a,s.doc,h))}return await this.submit(n.job,"add_frame",c),this.#t(n.room)}async setPalette({job:e,colors:t}){let n=X(t,"hue"),o=this.resolve(e);return await this.submit(o.job,"set_palette",[{t:"setPalette",colors:n}]),{...this.#t(o.room),palette:n.length}}async setFps({job:e,fps:t}){let n=this.resolve(e),o=this.client(n.room).state,s=Y(t);return await this.submit(n.job,"set_fps",o.doc.frames.map(i=>({t:"setFrameDur",id:i.id,durMs:s}))),{...this.#t(n.room),fps:t}}async clearCel({job:e,layer:t,frame:n=0}){let o=this.resolve(e),i=this.client(o.room).state,a=this.#s(o.room,t??o.layer),c=i.doc.frames[n];if(!c)throw new Error(`no frame ${n} in ${o.room}`);let l=new Uint8Array(i.doc.w*i.doc.h*4);return await this.submit(o.job,"clear",[Fe(a,c.id,i.doc,l)]),this.#t(o.room)}async trim({job:e,margin:t=0}){let n=this.resolve(e),o=this.client(n.room),s=o.state,i=this.#s(n.room,n.layer),a=o.session.readArt(i,0,{trim:!0}),c=a.rect.w+t*2,l=a.rect.h+t*2;return c>=s.doc.w&&l>=s.doc.h?{...this.#t(n.room),trimmed:"already tight"}:(await this.submit(n.job,"trim_canvas",[{t:"resize",w:c,h:l,dx:-a.rect.x+t,dy:-a.rect.y+t}]),{...this.#t(n.room),trimmed:`${c}\xD7${l}`})}},_t=new Set(["new_sprite","begin_job","finish_job","draw_art","draw_animation","read_art","render_preview","render_animation","add_layer","add_frame","set_palette","set_fps","clear","trim_canvas","get_info","list_documents","take_requests","create_folder","move_documents"]);function Fe(r,e,t,n){return{t:"paintRegion",layer:r,frame:e,rect:{x:0,y:0,w:t.w,h:t.h},rle:jt(n)}}function jt(r){let e=[];if(r.length){let t=[r[0],r[1],r[2],r[3]],n=0,o=()=>{let s=n;do{let i=s&127;s>>=7,e.push(s?i|128:i)}while(s);e.push(...t)};for(let s=0;s<r.length;s+=4)r[s]===t[0]&&r[s+1]===t[1]&&r[s+2]===t[2]&&r[s+3]===t[3]?n++:(o(),t=[r[s],r[s+1],r[s+2],r[s+3]],n=1);o()}return Buffer.from(Uint8Array.from(e)).toString("base64")}function $t(r){let e=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";return new Promise(t=>kt(e,[r],()=>t()))}function Y(r){return!r||r<=0?83:Math.max(10,Math.round(1e3/r))}function Rt(r,e=400){return new Promise(t=>{let n=Date.now(),o=()=>{if(r.state.pending===0&&Date.now()-n>40||Date.now()-n>e)return t();setTimeout(o,10)};o()})}function ze(){return(Date.now()^Math.floor(Math.random()*4294967295))>>>0}import{execFile as At}from"node:child_process";var Tt=2e4,Pt=5e3,N=class r{constructor({base:e,name:t="agent"}={}){this.base=String(e).replace(/\/$/,""),this.name=t,this.log=[],this.beat=setInterval(()=>void this.announce(),Pt),this.beat.unref&&this.beat.unref()}get kind(){return"local"}get where(){return this.base}supports(e){return Ot.has(e)}static async probe(e,{timeoutMs:t=700}={}){try{let n=await fetch(`${e.replace(/\/$/,"")}/bridge/status`,{signal:AbortSignal.timeout(t)});if(!n.ok)return null;let o=await n.json();return o?.server==="sprite"?o:null}catch{return null}}async announce(){try{await fetch(`${this.base}/bridge/agent`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({name:this.name,version:null}),signal:AbortSignal.timeout(2e3)})}catch{}}async call(e,t=[],n=Tt){let o;try{o=await(await fetch(`${this.base}/bridge/call`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({method:e,args:t,timeoutMs:n}),signal:AbortSignal.timeout(n+2e3)})).json()}catch(s){throw new Error(`lost contact with the Pixie editor at ${this.base}: ${s.message}`)}if(!o.ok)throw new Error(o.error);return this.note(e),o.result}note(e,t=""){this.log.unshift({at:Date.now(),tool:e,room:"local",detail:t}),this.log.length>200&&this.log.pop()}newSprite({name:e,w:t=E.w,h:n=E.h,intent:o,palette:s}){return this.call("newSprite",[{w:t,h:n,name:e,palette:s,intent:o,replace:!1}])}beginJob({document:e,intent:t}){return this.call("beginJob",[{document:e,intent:t}])}finishJob({job:e}){return this.call("finishJob",[{job:e}])}async info({document:e}={}){let t=await this.call("info",[]);return{editor:this.base,...e?{asked:e}:{},...t}}readArt({document:e,layer:t,frame:n}){return this.call("readArt",[{document:e,layer:t,frame:n}])}async preview({document:e,frame:t,scale:n=8}){let o=await this.call("toDataURL",[t??null,n,e??null]);return{png:qe(o.url),caption:o.caption}}async sheet({document:e,columns:t=0,scale:n=0}){let o=await this.call("toStripDataURL",[{document:e??null,columns:t,scale:n}]);return{png:qe(o.url),caption:o.caption}}documents(){return this.call("listDocuments",[])}drawArt({job:e,rows:t,colors:n,x:o,y:s,center:i,clear:a,layer:c,frame:l,label:h}){return this.call("drawArt",[t,n,{job:e,x:o,y:s,center:i,clear:a,layer:c,frame:l,label:h}])}drawAnimation({job:e,frames:t,colors:n,fps:o,layer:s,label:i}){return this.call("drawAnimation",[{frames:t,colors:n,fps:o,job:e,layer:s,label:i}])}addLayer({name:e}){return this.call("addLayer",[e])}addFrame({copy:e=!1}){return this.call("addFrame",[{copy:!!e}])}setPalette({colors:e}){return this.call("setPalette",[e])}setFps({fps:e}){return this.call("setFps",[e])}clearCel({job:e,layer:t,frame:n}){return this.call("clear",[{job:e,layer:t,frame:n}])}trim({job:e,margin:t=0}){return this.call("trimCanvas",[{job:e,margin:t}])}setFrame({index:e}){return this.call("setFrame",[e])}setLayer({index:e}){return this.call("setLayer",[e])}select({document:e}){return this.call("selectDocument",[e])}closeDocument({document:e}){return this.call("closeDocument",[e??null])}undo(){return this.call("undo",[])}redo(){return this.call("redo",[])}async openEditor(){if((await r.probe(this.base))?.connected)return{ok:!0,message:`Editor already connected at ${this.base}`};await It(this.base);let t=Date.now()+1e4;for(;Date.now()<t;){if((await r.probe(this.base))?.connected)return{ok:!0,message:`Editor connected at ${this.base}`};await new Promise(o=>setTimeout(o,200))}return{ok:!1,message:`Opened ${this.base} but nothing connected \u2014 check the browser window.`}}close(){clearInterval(this.beat)}},Ot=new Set(["new_sprite","begin_job","finish_job","draw_art","draw_animation","read_art","render_preview","render_animation","add_layer","add_frame","set_palette","set_fps","clear","trim_canvas","get_info","list_documents","open_editor","select_document","close_document","set_frame","set_layer","undo","redo"]);function qe(r){let e=String(r??"").split(",")[1];if(!e)throw new Error("the editor returned something that was not an image");return Buffer.from(e,"base64")}function It(r){let e=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";return new Promise(t=>At(e,[r],()=>t()))}import{readFileSync as Nt}from"node:fs";var Ct="0.4.1";function Lt(){let r=new URL("./version.json",import.meta.url);try{let e=JSON.parse(Nt(r,"utf8"))?.version;if(typeof e=="string"&&e)return e;throw new Error("it names no version")}catch(e){throw new Error(`${r.pathname} could not be read as a version: ${e.message}`)}}var We=Ct??Lt();function Q(r="room"){return`Pixel art editor with live collaboration. ${r==="local"?`Documents are tabs in a browser window on this machine. The user is
|
|
3
3
|
looking at it while you work, and can take the canvas back from you at any
|
|
4
4
|
moment.`:`Documents are rooms; other people and other agents may be in one with
|
|
5
5
|
you, and they see what you do as you do it.`}
|
|
6
6
|
|
|
7
7
|
*** CALL new_sprite FIRST. *** Before you write a script, compute a grid, or
|
|
8
8
|
think about pixels. It needs only a size, a name and one line of intent \u2014 all of
|
|
9
|
-
which you know the moment you are asked \u2014 and it puts a
|
|
9
|
+
which you know the moment you are asked \u2014 and it puts a labeled document in
|
|
10
10
|
front of the user immediately. Everything you do afterwards is preparation; none
|
|
11
11
|
of it should happen while they are looking at a canvas that has not changed.
|
|
12
12
|
|
|
@@ -16,14 +16,31 @@ one job open you may omit the job argument; with several you must pass it. The
|
|
|
16
16
|
user can see your job and revoke it \u2014 if a call fails saying the user stopped
|
|
17
17
|
you, do NOT retry. Say what you were about to do and ask.
|
|
18
18
|
|
|
19
|
+
SIZE. The default canvas is 80\xD742 \u2014 1.91:1, the ratio link cards crop to \u2014
|
|
20
|
+
so what you make posts edge to edge on Bluesky, Facebook, LinkedIn and X.
|
|
21
|
+
Compose for it: a subject and its surroundings, not a lone figure on empty
|
|
22
|
+
paper. Keep the ratio at any size (40\xD721, 80\xD742, 120\xD763, 160\xD784, 240\xD7126).
|
|
23
|
+
A PROFILE PICTURE is square (40\xD740, 50\xD750, 80\xD780, 100\xD7100) and is cropped to
|
|
24
|
+
a circle wherever it goes, so keep the subject inside one. A BANNER is 3:1
|
|
25
|
+
(60\xD720, 75\xD725, 150\xD750, 300\xD7100). When either is finished, tell the user the
|
|
26
|
+
editor has the export for it: file \u25B8 Save as profile picture (400\xD7400), or
|
|
27
|
+
file \u25B8 Save as profile banner (1500\xD7500) \u2014 both scale by a whole number and
|
|
28
|
+
centre on white, with a preview and a nudge. finish_job says so too.
|
|
29
|
+
A game asset \u2014 a tile, an icon, a character for a sheet \u2014 is the size the
|
|
30
|
+
game needs instead, and is the one kind of sprite you trim.
|
|
31
|
+
|
|
32
|
+
NAMES. Name a sprite the way a person would write it on a label \u2014 "Blue cake",
|
|
33
|
+
"Salmon nigiri" \u2014 not blue-cake or salmon_nigiri. The URL is minted from the
|
|
34
|
+
name; the name itself is what people read.
|
|
35
|
+
|
|
19
36
|
THE LIBRARY. Sprites live in folders. "Make five sushi sprites in a folder" is
|
|
20
37
|
five new_sprite calls with the same \`folder\` \u2014 the folder is made on the way.
|
|
21
38
|
Existing sprites are edited by beginning a job on them (list_documents names
|
|
22
39
|
them) and filed with move_documents. If a call is refused as "may not
|
|
23
|
-
|
|
40
|
+
organize", this machine was paired before folders were part of the default:
|
|
24
41
|
tell the user to run \`pixie-mcp login\` again.
|
|
25
42
|
|
|
26
|
-
${
|
|
43
|
+
${Dt}`}var Dt=`SPEED. Wall clock is round trips times payload, so:
|
|
27
44
|
- Silhouette before detail. At 32px a front-on animal is indistinguishable from
|
|
28
45
|
any other animal; profile is what reads. When the subject could go several
|
|
29
46
|
ways, draw 2-3 rough silhouettes as frames, look at them with
|
|
@@ -32,21 +49,22 @@ ${jt}`}var jt=`SPEED. Wall clock is round trips times payload, so:
|
|
|
32
49
|
- One call per animation. Never loop draw_art plus add_frame.
|
|
33
50
|
- Send changes, not sprites: copyPrevious plus the pixels that moved.
|
|
34
51
|
- Look once, properly. render_animation, not N previews.
|
|
35
|
-
- trim_canvas before you finish. Overshoot at new_sprite, then
|
|
52
|
+
- trim_canvas before you finish a game asset. Overshoot at new_sprite, then
|
|
53
|
+
trim. A piece made to be posted keeps its canvas: the space is the picture.
|
|
36
54
|
- finish_job when the sprite is done, so everyone knows you are gone.
|
|
37
55
|
|
|
38
56
|
Do not ask the user abstract clarifying questions. A human round trip costs
|
|
39
57
|
minutes; a tool round trip costs seconds. Commit to a good default and show
|
|
40
|
-
something
|
|
41
|
-
`))!==-1;){let i=
|
|
42
|
-
`)}}),this}};var
|
|
43
|
-
${
|
|
58
|
+
something.`,Ut=Q("room"),F=class{constructor({name:e="pixie",version:t=We,tools:n=[],instructions:o=Ut}={}){this.name=e,this.version=t,this.tools=n,this.instructions=o,this.client=null,this.onCall=null}async handle(e){if(!e||e.jsonrpc!=="2.0")return null;let t=e.id===void 0||e.id===null;try{let n=await this.#e(e);return t?null:{jsonrpc:"2.0",id:e.id,result:n}}catch(n){return t?null:{jsonrpc:"2.0",id:e.id,error:{code:-32603,message:n?.message??String(n)}}}}async#e(e){switch(e.method){case"initialize":return this.client=e.params?.clientInfo??null,{protocolVersion:e.params?.protocolVersion??"2024-11-05",capabilities:{tools:{}},serverInfo:{name:this.name,version:this.version},instructions:this.instructions};case"notifications/initialized":case"notifications/cancelled":return{};case"ping":return{};case"tools/list":return{tools:this.tools.map(t=>({name:t.name,description:t.description,inputSchema:t.inputSchema}))};case"tools/call":{let t=this.tools.find(n=>n.name===e.params?.name);if(!t)throw new Error(`unknown tool: ${e.params?.name}`);this.onCall?.(t.name,e.params?.arguments??{});try{return await t.run(e.params?.arguments??{})}catch(n){return{isError:!0,content:[{type:"text",text:n?.message??String(n)}]}}}case"resources/list":return{resources:[]};case"prompts/list":return{prompts:[]};default:throw new Error(`unknown method: ${e.method}`)}}serve(e=process.stdin,t=process.stdout){let n="";return e.setEncoding("utf8"),e.on("data",async o=>{n+=o;let s;for(;(s=n.indexOf(`
|
|
59
|
+
`))!==-1;){let i=n.slice(0,s).trim();if(n=n.slice(s+1),!i)continue;let a;try{a=JSON.parse(i)}catch{continue}let c=await this.handle(a);c&&t.write(JSON.stringify(c)+`
|
|
60
|
+
`)}}),this}};var C=(r,e)=>{let t=process.argv.indexOf(`--${r}`);return t>-1?process.argv[t+1]:e},ee=process.env.SPRITE_EDITOR||"http://127.0.0.1:4242",W=process.env.SPRITE_SERVER||"ws://127.0.0.1:4243",Bt=new URL("./sprite_core.wasm",import.meta.url);function Ft(r){let e=String(r??"").trim();return!e||!/^[a-z0-9]+([-_][a-z0-9]+)*$/.test(e)?e||"an agent":e.split(/[-_]/).map(t=>zt.has(t)?t.toUpperCase():t[0].toUpperCase()+t.slice(1)).join(" ")}var zt=new Set(["cli","ai","api","ide","mcp","sdk","gpt","llm"]);function qt(r){let e=new WebSocket(r),t={readyState:0,onopen:null,onmessage:null,onclose:null,send:n=>e.send(n),close:()=>e.close()};return e.addEventListener("open",()=>{t.readyState=1,t.onopen?.()}),e.addEventListener("message",n=>t.onmessage?.(n.data)),e.addEventListener("close",()=>{t.readyState=3,t.onclose?.()}),e.addEventListener("error",()=>{}),t}async function Wt(r,{timeoutMs:e=700}={}){if(await oe(r,{timeoutMs:e}))return!0;try{let t=await fetch(`${p(r)}/health`,{signal:AbortSignal.timeout(e)});return!t.ok||!(t.headers.get("content-type")??"").includes("json")?!1:(await t.json().catch(()=>null))?.ok===!0}catch{return!1}}async function Jt({editor:r=ee,server:e=W,allowHost:t=!0,publicServer:n=T}={}){if(n)return{kind:"room",url:n,why:`the Pixie this agent belongs to, at ${p(n)}`};let o=await N.probe(r);return o?{kind:"local",url:r,why:o.connected?`a Pixie editor is open at ${r}`:`a Pixie server is running at ${r}, with no editor open yet`}:await Wt(e)?{kind:"room",url:e,why:`a room server is running at ${e}`}:t?{kind:"room",url:e,start:!0,why:"nothing was running, so this process is the server"}:{kind:"room",url:e,why:`nothing is running yet; waiting for one at ${e}`}}async function Ht({kind:r=null,editor:e=ee,server:t=W,wasm:n=Bt,name:o="agent",allowHost:s=!0}={}){let i=r?{kind:r,url:r==="local"?e:t,why:"you said so"}:await Jt({editor:e,server:t,allowHost:s}),a,c=null,l=null;if(i.kind==="local")a=new N({base:i.url,name:o}),a.announce();else{i.start;let m=se(i.url),f=n instanceof Uint8Array?n:await Mt(n);c=await L.load(f);let w=await m;a=new B(c,{author:x(),name:o,connect:(d,y={})=>{let _=new URLSearchParams;y.w&&_.set("w",String(y.w)),y.h&&_.set("h",String(y.h)),y.name&&_.set("name",y.name);let te=_.toString();return qt(`${w}/rooms/${d}${te?`?${te}`:""}`)}}),a.serverUrl=w,a.getToken=async d=>{let y=await de(i.url,d);if(y!==void 0)return y;if(await z(i.url))throw new Error(q(i.url))},a.createDocument=async d=>{let y=await pe(i.url,d);if(y!==void 0)return y;if(await z(i.url))throw new Error(q(i.url))},a.control=async(d,y)=>{let _=await me(i.url,d,y);if(_!==void 0)return _;throw new Error(await z(i.url)?q(i.url):"no library here: this Sprite has no accounts, so there are no folders")},a.editorUrl=p(i.url),a.hosted=l}let h=new F({tools:Be(a),instructions:Q(a.kind)}),u=h.handle.bind(h);return h.handle=async m=>{let f=await u(m);return m?.method==="initialize"&&h.client?.name&&(a.name=Ft(h.client.name),a.announce()),f},{core:c,backend:a,mcp:h,chosen:i}}var Je=null;function z(r){return Je??=ue(r).catch(()=>!1),Je}function Vt(r=process.argv){let e=r[1]??"";return/[\\/]pixie-mcp$/.test(e)?"pixie-mcp":/[\\/]sprite-mcp$/.test(e)?"sprite-mcp":"npx pixie-mcp"}function q(r,e=Vt()){return`this machine has not been given a credential for ${p(r)} yet. Run \`${e} login\` once, in a terminal \u2014 it opens a browser, and one button in it is the whole of it.`}if(_e(import.meta.url)){let r=C("server",null)?"room":C("editor",null)?"local":null;if(process.argv.includes("login")){let e=C("server",T||W);try{let t=await ke(e,{onUrl:n=>process.stderr.write(`
|
|
61
|
+
${n}
|
|
44
62
|
`),label:"the Pixie MCP server"});process.stderr.write(`
|
|
45
63
|
This machine can now draw as ${t.email??t.name??"you"}.
|
|
46
64
|
|
|
47
65
|
`)}catch(t){process.stderr.write(`
|
|
48
66
|
${t.message}
|
|
49
67
|
|
|
50
|
-
`),process.exit(1)}}else{let{mcp:e,chosen:t}=await
|
|
51
|
-
`),e.serve(),t.kind==="room"&&(async()=>(await
|
|
52
|
-
`))()}}export{
|
|
68
|
+
`),process.exit(1)}}else{let{mcp:e,chosen:t}=await Ht({kind:r,editor:C("editor",ee),server:C("server",W),allowHost:!process.argv.includes("--no-host")});process.stderr.write(`sprite-mcp \u2192 ${t.kind} (${t.why})
|
|
69
|
+
`),e.serve(),t.kind==="room"&&(async()=>(await P(t.url))?.token||await z(t.url)&&process.stderr.write(`sprite-mcp \u2192 ${q(t.url)}
|
|
70
|
+
`))()}}export{ee as DEFAULT_EDITOR,W as DEFAULT_SERVER,Vt as commandName,Ht as createServer,Jt as detect,Ft as presentable,Wt as probeRooms,q as signInFirst,qt as websocketTransport};
|
package/sprite_core.wasm
CHANGED
|
Binary file
|