pixie-mcp 0.5.0 → 0.5.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.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/pixie-mcp.mjs +17 -5
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pixie-mcp",
3
- "version": "0.5.0",
3
+ "version": "0.5.1",
4
4
  "description": "MCP server for Pixie — draw pixel art from the AI client you already pay for. Holds no API key and bills nobody.",
5
5
  "type": "module",
6
6
  "bin": {
package/pixie-mcp.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
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 E(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,D,R,Z,O=j(()=>{"use strict";ht=new TextEncoder,ut=new TextDecoder,dt=1;D=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 Ae(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]=Te,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]!==Te)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,Te,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"};Te=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"}-${E().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 A=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 Ee}from"node:crypto";var st=300*1e3,it=()=>Ee(32).toString("base64url"),at=()=>Ee(16).toString("base64url");function ke(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?ke("Nothing was granted.","You can close this window."):ke("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 xe(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 xt}from"node:child_process";Oe();O();var ft=5e3,L=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=Ae({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=E();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 x=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 T=([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)=>T(x(r))-T(x(e)),hue:(r,e)=>{let[t,n]=U(x(r)),[o,s]=U(x(e));return n<.08||s<.08?n<.08&&s<.08?T(x(r))-T(x(e)):n<.08?-1:1:Math.round(t/20)!==Math.round(o/20)?t-o:T(x(r))-T(x(e))},saturation:(r,e)=>U(x(r))[1]-U(x(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 De(r,{publicServer:e=A}={}){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)}]}),Le=(r,e)=>({content:[{type:"image",data:Buffer.from(r).toString("base64"),mimeType:"image/png"},{type:"text",text:e}]}),k={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 kt(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 Et=[{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:k.w,description:`Width in pixels. The default canvas is ${k.w}\xD7${k.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:k.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.'},challenge:{type:"string",enum:["daily","weekly"],description:'"daily" when the user asks for the sprite of the day / today\'s theme / the Pixel Dailies; "weekly" for the sprite of the week / this week\'s word / Weekly Pixels. The name comes from the theme itself (pass `name` only to override), and finish_job will say how to post it as an entry. Call `challenges` first if you want to see the theme before drawing.'}},required:["intent"]},run:async(r,e)=>{let t=r.name?kt(r.name):null,n=r.w??null,o=r.h??null;if(r.challenge){let s=await e.challenge(r.challenge);if(t??=s.theme,n===null&&o===null&&s.sizes?.length){let i=s.sizes[Math.floor((s.sizes.length-1)/2)],[a,c]=i.split(/[x×]/).map(Number);a&&c&&([n,o]=[a,c])}}if(!t)throw new Error("new_sprite needs a name, or a challenge to take one from");return e.newSprite({name:t,w:n??k.w,h:o??k.h,intent:r.intent,palette:r.palette,folder:r.folder??null,challenge:r.challenge??null})}},{name:"challenges",description:`The sprite of the day and the sprite of the week: Pixel Dailies sets a theme every day ("Today's theme is #Gateway") and Weekly Pixels a word every week, with sizes. When the user says "the sprite of the day", "today's theme", "the daily", "the weekly", "this week's word" or names either community, this is what they mean \u2014 read it here rather than asking them. The server reads the accounts and keeps the answer; nothing is fetched from Bluesky by you.`,inputSchema:{type:"object",properties:{}},run:(r,e)=>e.challenges()},{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 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: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 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:(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 Et.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 L(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?De(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=E();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=k.w,h:n=k.h,intent:o,palette:s,folder:i=null,challenge:a=null}){let c=await this.createDocument?.({name:e,w:t,h:n})??Ie(e),l=await this.begin(c,o,{open:{w:t,h:n,name:e}});return a&&(this.jobs.get(l).challenge=a),s?.length&&await this.submit(l,"set_palette",[{t:"setPalette",colors:X(s,"hue")}]),i&&await this.moveDocuments({documents:[c],folder:i,make:!0}),this.#n(c,o),{job:l,...this.#t(c)}}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),i=[t.challenge?`This is ${t.challenge==="weekly"?"this week's Weekly Pixels":"today's Pixel Dailies"} entry: tell the user to post it from the share button with the ${t.challenge==="weekly"?"Weekly Pixels":"Pixel Dailies"} switch on, which puts the theme and the tags on the post.`:null,o].filter(Boolean).join(" ");return{finished:t.intent,document:t.room,...i?{next:i}:{}}}async challenges(){if(!this.newsUrl)throw new Error("no server to ask: the themes come from the Pixie server, and this session has none");if(!(this.newsAt&&Date.now()-this.newsAt<300*1e3)){let n=await fetch(this.newsUrl);if(!n.ok)throw new Error(`the server said ${n.status} for the themes`);this.news=await n.json(),this.newsAt=Date.now()}let t=(n,o)=>n?{theme:n.theme,tags:n.tags,detail:n.detail??null,sizes:n.sizes??[],postedAt:new Date(n.at).toISOString(),post:n.url}:{theme:null,note:`no ${o} theme is known right now`};return{daily:t(this.news?.dailies,"daily"),weekly:t(this.news?.weekly,"weekly"),how:'new_sprite({ challenge: "daily" | "weekly", intent }) names the sprite after the theme; finish_job says how to post it as an entry.'}}async challenge(e){let t=await this.challenges(),n=e==="weekly"?t.weekly:t.daily;if(!n?.theme)throw new Error(`no ${e} theme is known right now \u2014 ask the user what to draw`);return n}#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:E(),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:E(),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=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 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","challenges","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=>xt(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 Tt}from"node:child_process";var At=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=At){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=k.w,h:n=k.h,intent:o,palette:s}){return this.call("newSprite",[{w:t,h:n,name:e,palette:s,intent:o,replace:!1}])}async challenges(){let e=await fetch(`${this.base}/news.json`).catch(()=>null);if(!e?.ok)throw new Error("this editor does not serve the themes \u2014 ask the user what to draw");let t=await e.json(),n=(o,s)=>o?{theme:o.theme,tags:o.tags,detail:o.detail??null,sizes:o.sizes??[],postedAt:new Date(o.at).toISOString(),post:o.url}:{theme:null,note:`no ${s} theme is known right now`};return{daily:n(t?.dailies,"daily"),weekly:n(t?.weekly,"weekly")}}async challenge(e){let t=await this.challenges(),n=e==="weekly"?t.weekly:t.daily;if(!n?.theme)throw new Error(`no ${e} theme is known right now \u2014 ask the user what to draw`);return n}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:We(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:We(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","challenges","open_editor","select_document","close_document","set_frame","set_layer","undo","redo"]);function We(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=>Tt(e,[r],()=>t()))}import{readFileSync as Nt}from"node:fs";var Ct="0.5.0";function Dt(){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 qe=Ct??Dt();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
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,Z=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();Z();pn=120*1e3});function E(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,D,A,K,O=j(()=>{"use strict";ht=new TextEncoder,ut=new TextDecoder,dt=1;D=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 A(this,o)}openRoom(e,{seq:t=0}={}){let{h:n}=this.call("room.new",{doc:e,...t>0?{seq:t}:{}});return new K(this,n)}},A=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")}},K=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 Ae(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]=Re,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]!==Re)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,Re,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"};Re=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"}-${E().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 Ze,chmod as Ke}from"node:fs/promises";import{readFileSync as Xe}from"node:fs";import{homedir as Ye,hostname as Qe}from"node:os";import{join as J}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 H=new Map;function se(r,{fetchImpl:e=fetch,timeoutMs:t=3e3}={}){let n=p(r);return H.has(n)||H.set(n,Je(r,{fetchImpl:e,timeoutMs:t})),H.get(n)}async function Je(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=J(process.env.XDG_CONFIG_HOME||J(Ye(),".config"),"sprite"),V=J(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 Ze(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 Ke(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();Z();import{createServer as ot}from"node:http";import{randomBytes as Ee}from"node:crypto";var st=300*1e3,it=()=>Ee(32).toString("base64url"),at=()=>Ee(16).toString("base64url");function ke(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?ke("Nothing was granted.","You can close this window."):ke("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 xe(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 xt}from"node:child_process";Oe();O();var ft=5e3,L=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 A(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=E();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 A(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(Ae(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 x=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 R=([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)=>R(x(r))-R(x(e)),hue:(r,e)=>{let[t,n]=U(x(r)),[o,s]=U(x(e));return n<.08||s<.08?n<.08&&s<.08?R(x(r))-R(x(e)):n<.08?-1:1:Math.round(t/20)!==Math.round(o/20)?t-o:R(x(r))-R(x(e))},saturation:(r,e)=>U(x(r))[1]-U(x(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 De(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)}]}),Le=(r,e)=>({content:[{type:"image",data:Buffer.from(r).toString("base64"),mimeType:"image/png"},{type:"text",text:e}]}),k={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 kt(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 Et=[{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:k.w,description:`Width in pixels. WHAT THE USER ASKED FOR WINS: a stated size or shape is used as stated, and a named artist, piece or style is matched in scale and detail. The rest is defaults for when nothing was said: ${k.w}\xD7${k.h} \u2014 1.91:1, the ratio link cards crop to, so a piece drawn on it posts edge to edge \u2014 at any size (${gt}, 480\xD7252, 600\xD7315: examples, not limits). 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:k.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.'},challenge:{type:"string",enum:["daily","weekly"],description:'"daily" when the user asks for the sprite of the day / today\'s theme / the Pixel Dailies; "weekly" for the sprite of the week / this week\'s word / Weekly Pixels. The name comes from the theme itself (pass `name` only to override), and finish_job will say how to post it as an entry. Call `challenges` first if you want to see the theme before drawing.'}},required:["intent"]},run:async(r,e)=>{let t=r.name?kt(r.name):null,n=r.w??null,o=r.h??null;if(r.challenge){let s=await e.challenge(r.challenge);if(t??=s.theme,n===null&&o===null&&s.sizes?.length){let i=s.sizes[Math.floor((s.sizes.length-1)/2)],[a,c]=i.split(/[x×]/).map(Number);a&&c&&([n,o]=[a,c])}}if(!t)throw new Error("new_sprite needs a name, or a challenge to take one from");return e.newSprite({name:t,w:n??k.w,h:o??k.h,intent:r.intent,palette:r.palette,folder:r.folder??null,challenge:r.challenge??null})}},{name:"challenges",description:`The sprite of the day and the sprite of the week: Pixel Dailies sets a theme every day ("Today's theme is #Gateway") and Weekly Pixels a word every week, with sizes. When the user says "the sprite of the day", "today's theme", "the daily", "the weekly", "this week's word" or names either community, this is what they mean \u2014 read it here rather than asking them. The server reads the accounts and keeps the answer; nothing is fetched from Bluesky by you.`,inputSchema:{type:"object",properties:{}},run:(r,e)=>e.challenges()},{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. With no style reference, keep the palette small \u2014 four to eight colors, reused for shading \u2014 because that is what makes a small sprite read as pixel art rather than as a downscaled photograph. When matching an artist or a piece, use as many colors as their work does. A canvas past ~300 wide goes in bands: several calls with `y`, a few dozen rows each.',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 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: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 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:(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 Et.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 L(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?De(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=E();if(s.lease("acquire",{job:i,intent:t,...n?{layers:[n]}:{}}),await At(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=k.w,h:n=k.h,intent:o,palette:s,folder:i=null,challenge:a=null}){let c=await this.createDocument?.({name:e,w:t,h:n})??Ie(e),l=await this.begin(c,o,{open:{w:t,h:n,name:e}});return a&&(this.jobs.get(l).challenge=a),s?.length&&await this.submit(l,"set_palette",[{t:"setPalette",colors:X(s,"hue")}]),i&&await this.moveDocuments({documents:[c],folder:i,make:!0}),this.#n(c,o),{job:l,...this.#t(c)}}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),i=[t.challenge?`This is ${t.challenge==="weekly"?"this week's Weekly Pixels":"today's Pixel Dailies"} entry: tell the user to post it from the share button with the ${t.challenge==="weekly"?"Weekly Pixels":"Pixel Dailies"} switch on, which puts the theme and the tags on the post.`:null,o].filter(Boolean).join(" ");return{finished:t.intent,document:t.room,...i?{next:i}:{}}}async challenges(){if(!this.newsUrl)throw new Error("no server to ask: the themes come from the Pixie server, and this session has none");if(!(this.newsAt&&Date.now()-this.newsAt<300*1e3)){let n=await fetch(this.newsUrl);if(!n.ok)throw new Error(`the server said ${n.status} for the themes`);this.news=await n.json(),this.newsAt=Date.now()}let t=(n,o)=>n?{theme:n.theme,tags:n.tags,detail:n.detail??null,sizes:n.sizes??[],postedAt:new Date(n.at).toISOString(),post:n.url}:{theme:null,note:`no ${o} theme is known right now`};return{daily:t(this.news?.dailies,"daily"),weekly:t(this.news?.weekly,"weekly"),how:'new_sprite({ challenge: "daily" | "weekly", intent }) names the sprite after the theme; finish_job says how to post it as an entry.'}}async challenge(e){let t=await this.challenges(),n=e==="weekly"?t.weekly:t.daily;if(!n?.theme)throw new Error(`no ${e} theme is known right now \u2014 ask the user what to draw`);return n}#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:E(),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:E(),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=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 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","challenges","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=>xt(e,[r],()=>t()))}function Y(r){return!r||r<=0?83:Math.max(10,Math.round(1e3/r))}function At(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 Rt}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=k.w,h:n=k.h,intent:o,palette:s}){return this.call("newSprite",[{w:t,h:n,name:e,palette:s,intent:o,replace:!1}])}async challenges(){let e=await fetch(`${this.base}/news.json`).catch(()=>null);if(!e?.ok)throw new Error("this editor does not serve the themes \u2014 ask the user what to draw");let t=await e.json(),n=(o,s)=>o?{theme:o.theme,tags:o.tags,detail:o.detail??null,sizes:o.sizes??[],postedAt:new Date(o.at).toISOString(),post:o.url}:{theme:null,note:`no ${s} theme is known right now`};return{daily:n(t?.dailies,"daily"),weekly:n(t?.weekly,"weekly")}}async challenge(e){let t=await this.challenges(),n=e==="weekly"?t.weekly:t.daily;if(!n?.theme)throw new Error(`no ${e} theme is known right now \u2014 ask the user what to draw`);return n}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:We(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:We(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","challenges","open_editor","select_document","close_document","set_frame","set_layer","undo","redo"]);function We(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=>Rt(e,[r],()=>t()))}import{readFileSync as Nt}from"node:fs";var Ct="0.5.1";function Dt(){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 qe=Ct??Dt();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.`}
@@ -16,6 +16,14 @@ 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
+ WHAT THE USER SAYS BEATS EVERY DEFAULT BELOW \u2014 the ratio included. A size,
20
+ a shape, a reference, a palette: if the prompt names it, that is the answer,
21
+ and nothing here is enforced against it. "Make it 64\xD764" is 64\xD764; "like
22
+ this artist" is that artist's scale, detail and palette \u2014 a painter who
23
+ works at 600 pixels wide with thirty colors is not matched by a 120\xD763
24
+ thumbnail with eight. Everything below \u2014 the card ratio, the size ladder,
25
+ the palette advice \u2014 is for when nobody has said what it should look like.
26
+
19
27
  THE SPRITE OF THE DAY. Two communities run a standing prompt: Pixel
20
28
  Dailies sets a theme every day and Weekly Pixels a word every week. "Make
21
29
  the sprite of the day", "today's theme", "the daily", "the weekly", "this
@@ -29,7 +37,11 @@ button with that challenge's switch on.
29
37
  SIZE. The default canvas is 80\xD742 \u2014 1.91:1, the ratio link cards crop to \u2014
30
38
  so what you make posts edge to edge on Bluesky, Facebook, LinkedIn and X.
31
39
  Compose for it: a subject and its surroundings, not a lone figure on empty
32
- paper. Keep the ratio at any size (40\xD721, 80\xD742, 120\xD763, 160\xD784, 240\xD7126).
40
+ paper. Keep the ratio at any size: 40\xD721, 80\xD742, 120\xD763, 240\xD7126, 480\xD7252,
41
+ 600\xD7315 \u2014 examples, not limits, and any multiple of 40\xD721 fills the card.
42
+ A reference sets the size; without one, pick the smallest at which the
43
+ composition reads. A canvas past ~300 wide is drawn in bands: several
44
+ draw_art calls with \`y\`, each a few dozen rows, rather than one call.
33
45
  A PROFILE PICTURE is square (40\xD740, 50\xD750, 80\xD780, 100\xD7100) and is cropped to
34
46
  a circle wherever it goes, so keep the subject inside one. A BANNER is 3:1
35
47
  (60\xD720, 75\xD725, 150\xD750, 300\xD7100). When either is finished, tell the user the
@@ -67,7 +79,7 @@ Do not ask the user abstract clarifying questions. A human round trip costs
67
79
  minutes; a tool round trip costs seconds. Commit to a good default and show
68
80
  something.`,Ut=Q("room"),F=class{constructor({name:e="pixie",version:t=qe,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(`
69
81
  `))!==-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)+`
70
- `)}}),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",q=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 Wt(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 qt(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=q,allowHost:t=!0,publicServer:n=A}={}){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 qt(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=q,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 D.load(f);let w=await m;a=new B(c,{author:E(),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 Wt(`${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(W(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(W(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)?W(i.url):"no library here: this Sprite has no accounts, so there are no folders")},a.editorUrl=p(i.url),a.newsUrl=`${p(i.url)}/news.json`,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 W(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",A||q);try{let t=await xe(e,{onUrl:n=>process.stderr.write(`
82
+ `)}}),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",q=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 Wt(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 qt(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 Ht({editor:r=ee,server:e=q,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 qt(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 Jt({kind:r=null,editor:e=ee,server:t=q,wasm:n=Bt,name:o="agent",allowHost:s=!0}={}){let i=r?{kind:r,url:r==="local"?e:t,why:"you said so"}:await Ht({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 D.load(f);let w=await m;a=new B(c,{author:E(),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 Wt(`${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(W(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(W(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)?W(i.url):"no library here: this Sprite has no accounts, so there are no folders")},a.editorUrl=p(i.url),a.newsUrl=`${p(i.url)}/news.json`,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 He=null;function z(r){return He??=ue(r).catch(()=>!1),He}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 W(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||q);try{let t=await xe(e,{onUrl:n=>process.stderr.write(`
71
83
  ${n}
72
84
  `),label:"the Pixie MCP server"});process.stderr.write(`
73
85
  This machine can now draw as ${t.email??t.name??"you"}.
@@ -75,6 +87,6 @@ something.`,Ut=Q("room"),F=class{constructor({name:e="pixie",version:t=qe,tools:
75
87
  `)}catch(t){process.stderr.write(`
76
88
  ${t.message}
77
89
 
78
- `),process.exit(1)}}else{let{mcp:e,chosen:t}=await Ht({kind:r,editor:C("editor",ee),server:C("server",q),allowHost:!process.argv.includes("--no-host")});process.stderr.write(`sprite-mcp \u2192 ${t.kind} (${t.why})
90
+ `),process.exit(1)}}else{let{mcp:e,chosen:t}=await Jt({kind:r,editor:C("editor",ee),server:C("server",q),allowHost:!process.argv.includes("--no-host")});process.stderr.write(`sprite-mcp \u2192 ${t.kind} (${t.why})
79
91
  `),e.serve(),t.kind==="room"&&(async()=>(await P(t.url))?.token||await z(t.url)&&process.stderr.write(`sprite-mcp \u2192 ${W(t.url)}
80
- `))()}}export{ee as DEFAULT_EDITOR,q as DEFAULT_SERVER,Vt as commandName,Ht as createServer,Jt as detect,Ft as presentable,qt as probeRooms,W as signInFirst,Wt as websocketTransport};
92
+ `))()}}export{ee as DEFAULT_EDITOR,q as DEFAULT_SERVER,Vt as commandName,Jt as createServer,Ht as detect,Ft as presentable,qt as probeRooms,W as signInFirst,Wt as websocketTransport};