localdeck 1.7.0 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -1,4 +1,4 @@
1
- import{M as $0,N as d,O as H1,Q as J1,S as Q1,T as a0,V as I0,W as A0,X as x0,Y as y0,Z as b0,ba as n0,ca as k0,da as C0,ea as _0,fa as M0,ga as O0,ha as D0,ia as G0,ja as s0,ka as L0,la as R0,ma as r0,na as e0,oa as q0,pa as $1,qa as Y1,ra as V0,sa as U1,ta as Y0,ua as z1,va as u,wa as K0}from"./index-2da1tyad.js";import{spawn as x1}from"node:child_process";import y1 from"node:crypto";import{parseArgs as v0}from"node:util";import{spawn as V1}from"node:child_process";import W1 from"node:fs";var q1=process.stdout.isTTY&&!process.env.NO_COLOR,v=($)=>(Y)=>q1?`\x1B[${$}m${Y}\x1B[0m`:Y,U={bold:v(1),dim:v(2),red:v(31),green:v(32),yellow:v(33),cyan:v(36),magenta:v(35),blue:v(34)};function M($){console.error(`${U.red("error")} ${$}`),process.exit(1)}function i($,Y){let K=[Y,...$],X=Y.map((q,z)=>Math.max(...K.map((W)=>c0(W[z]??"")))),Q=(q)=>q.map((z,W)=>z+" ".repeat(X[W]-c0(z))).join(" ");return[U.dim(Q(Y)),...$.map(Q)].join(`
1
+ import{M as $0,N as d,O as H1,Q as J1,S as Q1,T as a0,V as I0,W as A0,X as x0,Y as y0,Z as b0,ba as n0,ca as k0,da as C0,ea as _0,fa as M0,ga as O0,ha as D0,ia as G0,ja as s0,ka as L0,la as R0,ma as r0,na as e0,oa as q0,pa as $1,qa as Y1,ra as V0,sa as U1,ta as Y0,ua as z1,va as u,wa as K0}from"./index-hdw8ggnb.js";import{spawn as x1}from"node:child_process";import y1 from"node:crypto";import{parseArgs as v0}from"node:util";import{spawn as V1}from"node:child_process";import W1 from"node:fs";var q1=process.stdout.isTTY&&!process.env.NO_COLOR,v=($)=>(Y)=>q1?`\x1B[${$}m${Y}\x1B[0m`:Y,U={bold:v(1),dim:v(2),red:v(31),green:v(32),yellow:v(33),cyan:v(36),magenta:v(35),blue:v(34)};function M($){console.error(`${U.red("error")} ${$}`),process.exit(1)}function i($,Y){let K=[Y,...$],X=Y.map((q,z)=>Math.max(...K.map((W)=>c0(W[z]??"")))),Q=(q)=>q.map((z,W)=>z+" ".repeat(X[W]-c0(z))).join(" ");return[U.dim(Q(Y)),...$.map(Q)].join(`
2
2
  `)}var c0=($)=>$.replace(/\x1b\[[0-9;]*m/g,"").length;function F0($){let Y=Math.max(0,Math.round((Date.now()-$)/1000));if(Y<60)return`${Y}s`;if(Y<3600)return`${Math.round(Y/60)}m`;if(Y<86400)return`${Math.round(Y/3600)}h`;return`${Math.round(Y/86400)}d`}async function o0($,Y,K=fetch,X=console.log){if(Y)X("LocalDeck: preparing app links. macOS may ask once to allow localhost port 80; cancelling keeps port-number links.");try{let Q=await K(`http://127.0.0.1:${$}/api/forwarder`,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({install:Y,automatic:!0}),signal:AbortSignal.timeout(135000)}),q=await Q.json();if(Q.ok&&q?.ready===!0)return!0;if(Y)X(`LocalDeck: using port-number links. ${q?.error??"Forwarding is unavailable."}`)}catch{if(Y)X("LocalDeck: using port-number links; forwarding setup was unavailable.")}return!1}var t0=8000,S1=500,_1=1000;async function M1($,Y={}){let K={ensureDaemon:u,getFreePort:a0,createWebSocket:(_,D)=>new d(_,D),spawn:V1,fetch:globalThis.fetch,...Y};if(!$.command.length)throw Error(`nothing to run for "${$.name}"`);let X=$.cwd??process.cwd();try{if(!W1.statSync(X).isDirectory())throw Error("not a directory")}catch{throw Error(`working directory does not exist or is not a directory: ${X}`)}let Q=await K.ensureDaemon(),q=$.project??{id:"standalone",name:"standalone",slug:"standalone"},z={},W=K.resolveProjectSecrets??n0;if($.secrets?.length&&q.id!=="standalone")z=W(q.id,$.secrets);let G=$.upstreamPort??await K.getFreePort(),B=$.color??U.cyan,Z=$.prefix?B(`[${$.name}] `):"",V=await L1($.env,$.after??[],q.id,Q.apiPort,K.fetch);V={...V,...z};let S=K.createWebSocket(`ws://127.0.0.1:${Q.apiPort}/api/attach`,{headers:{authorization:`Bearer ${Q.controlToken}`}}),H=(_)=>S.readyState===d.OPEN&&S.send(JSON.stringify(_)),J=await new Promise((_,D)=>{S.once("open",()=>{H({type:"register",key:C0(q.id,$.name.toLowerCase()),projectId:q.id,projectName:q.name,projectSlug:q.slug,name:$.name,managedBy:"terminal",stablePort:$.stablePort,upstreamPort:G,upstreamSource:$.upstreamPort===void 0?"assigned":"manual",cwd:X,command:$.displayCommand??$.command.join(" "),...$.project?{profiles:$.profiles??[]}:{}})}),S.on("message",(C)=>{let I=JSON.parse(C.toString());if(I.type==="registered")_(I.service);else if(I.type==="error")D(Error(I.message))}),S.once("error",D)}),O=$.command.map((_)=>_.replaceAll("{port}",String(G))),L=J.serviceType!==void 0&&J.serviceType!=="http",N=L?{}:e0($.displayCommand??$.command,X,G);V={...N,...V};for(let _ of Object.keys(N))if(V[_]===N[_]){let D=`LocalDeck: supplying assigned port ${G} through ${_}`;console.log(`${Z}${U.dim(D)}`),H({type:"log",stream:"stdout",line:D})}let R={...process.env,...V,...z,PORT:String(G),LOCALDECK_PORT:String(J.stablePort),LOCALDECK_SERVICE:J.name,...L?{}:{LOCALDECK_URL:`http://localhost:${J.stablePort}`}},b=new Set(Object.values(z));if(L)console.log(`${Z}${U.bold("LocalDeck")} ${U.dim("›")} ${B(J.name)} ${U.dim("→")} ${U.green(`database localhost:${J.upstreamPort}`)} ${U.dim("(published port · no HTTP proxy)")}`);else{let _=$.cleanUrls?J.urls[0].replace(/^(http:\/\/[a-z0-9-]+(?:\.[a-z0-9-]+)?\.localhost):\d+(?=\/|$)/i,"$1"):J.urls[0];console.log(`${Z}${U.bold("LocalDeck")} ${U.dim("›")} ${B(J.name)} ${U.dim("→")} ${U.green(_)} ${U.dim(`(also ${J.urls[1]} · dashboard http://localhost:${Q.apiPort})`)}`)}let B0=process.platform!=="win32",F,h=(_,D,C)=>{let I=b.size?_.pipe(Y1(b)):_;I.on("data",(g)=>{let y=R0(g.toString());if(w=(w+y).slice(-16000),$.prefix)C.write(y.replace(/^(?=.)/gm,Z));else C.write(g)}),s0(I,(g)=>{for(let y of N1(R0(g)))H({type:"log",stream:D,line:y})})},x=!1,w="",o=(_)=>{if(x)return;let D=_.toString();if(/EADDRINUSE|address already in use|already in use/i.test(D)&&D.includes(String(J.stablePort)))x=!0,console.error(`${Z}${U.yellow(`LocalDeck: your process tried to use port ${J.stablePort}, which LocalDeck is holding as the stable port for "${J.name}".`)}`),console.error(`${Z}${U.yellow(` Fix: run without --port (LocalDeck finds the tool's own port automatically), or pick a different stable port, e.g. --port ${J.stablePort+1000}.`)}`)},H0,t,u0,p,a=0,n=!1,j=!1,W0,k,f=!1,J0,G1=new Promise((_)=>{J0=_}),m0=(_)=>W0??=O1(F,_),l0=async(_)=>{if(f||n||!k)return;if(n=!0,!await m0(_)){W0=void 0,n=!1,j=!1,console.error(`${Z}${U.red("LocalDeck: process descendants survived cleanup; retry Stop")}`);return}if(f)return;if(H0)clearTimeout(H0);H({type:"log",stream:"stderr",line:`process exited (${k.signal??`code ${k.code}`})`});let D=["SIGINT","SIGTERM","SIGHUP"].includes(k.signal??"")||[130,143,129].includes(k.code??-1);if(!j&&!D&&a<3&&S.readyState===d.OPEN){let C=`LocalDeck: restarting in ${(K.retryDelayMs??3000)/1000} seconds (attempt ${++a}/3)`;console.log(`${Z}${U.yellow(C)}`),H({type:"log",stream:"stderr",line:C}),H({type:"readiness",status:"checking",message:C}),p=setTimeout(()=>{if(p=void 0,j||f)return;try{p0()}catch(I){f=!0,console.error(`${Z}${U.red(`LocalDeck: restart failed: ${I instanceof Error?I.message:I}`)}`),S.close(),J0(1)}},K.retryDelayMs??3000),n=!1;return}if(!j&&!D&&a===3)console.error(`${Z}${U.red("LocalDeck: automatic restart limit reached (3/3). Start the service manually to try again.")}`),H({type:"log",stream:"stderr",line:"LocalDeck: automatic restart limit reached (3/3). Start the service manually to try again."});f=!0,setTimeout(()=>{S.close(),J0(k.code??(k.signal?1:0))},50)},U0=(_="SIGTERM")=>{if(f||j)return;if(j=!0,p)clearTimeout(p),p=void 0;m0(_).then(()=>l0(_))};S.on("message",(_)=>{let D=JSON.parse(_.toString());if(D.type==="error")console.error(`${Z}${U.yellow(`LocalDeck: ${D.message}`)}`),t=void 0;else if(D.type==="stop")console.log(`${Z}${U.dim("LocalDeck: stop requested from dashboard/CLI")}`),U0()}),S.on("close",()=>{if(p){U0();return}if(!j&&!f)console.error(`${Z}${U.yellow("LocalDeck: lost connection to daemon; the stable port is no longer proxied. Process keeps running.")}`)});function p0(){if(a>0&&$.secrets?.length&&q.id!=="standalone"){z=W(q.id,$.secrets);for(let _ of Object.values(z))b.add(_);V={...V,...z},R={...process.env,...V,PORT:String(G),LOCALDECK_PORT:String(J.stablePort),LOCALDECK_SERVICE:J.name,...L?{}:{LOCALDECK_URL:`http://localhost:${J.stablePort}`}}}if(k=void 0,W0=void 0,n=!1,t=void 0,w="",x=!1,F=K.spawn(O[0],O.slice(1),{cwd:X,env:R,stdio:[$.prefix?"ignore":"inherit","pipe","pipe"],shell:!B0,detached:B0}),F.pid)H({type:"pid",pid:F.pid});if(h(F.stdout,"stdout",process.stdout),h(F.stderr,"stderr",process.stderr),F.stdout.on("data",o),F.stderr.on("data",o),!$.upstreamPort&&F.pid){let _=F,D=F.pid,C=0,I=async()=>{if(F!==_||F.exitCode!==null||F.signalCode)return;try{let g=await M0(await _0(D)),y=O0(g,G),s=y?void 0:D0(g);if(s&&s!==u0)console.error(`${Z}${U.yellow(`LocalDeck: ${s}`)}`),H({type:"log",stream:"stderr",line:`LocalDeck: ${s}`});if(u0=s,y){let S0=`${G0(y)}:${y.port}`;if(S0!==t){if(t=S0,H({type:"upstream",port:y.port,host:G0(y)}),y.port!==G)console.log(`${Z}${U.dim(`LocalDeck: process is listening on ${S0} (ignored $PORT) — ${J.urls[0]} now points there`)}`)}C++}}catch{}if(F!==_||F.exitCode!==null||j||k)return;H0=setTimeout(I,t?Math.min(2000+C*500,1e4):400)};H0=setTimeout(I,300)}if(F.on("exit",(_,D)=>{if(_!==0&&!x){let C=r0(w);if(C)console.error(`${Z}${U.yellow(["LocalDeck: "+C.title,...C.steps].join(`
3
3
  `))}`)}k={code:_,signal:D},l0("SIGTERM")}),F.on("error",(_)=>{j=!0,f=!0,console.error(`${Z}${U.red(`LocalDeck: failed to start "${O[0]}": ${_.message}`)}`),S.close(),J0(1)}),a>0)i0().catch(()=>U0())}p0();let z0=$.ready,i0=()=>z0?(async()=>{H({type:"readiness",status:"checking",message:z0.type==="tcp"?"Waiting for the service to listen":"Running configured readiness check"});try{let _=await $1({name:J.name,run:$.displayCommand??$.command.join(" "),tags:[],after:$.after??[],ready:z0},async()=>{let D=await K.fetch(`http://127.0.0.1:${Q.apiPort}/api/services/${encodeURIComponent(J.key)}`);if(D.status===404)return;if(!D.ok)throw Error(`readiness status request failed (${D.status})`);return D.json()},{cwd:X,env:V});return H({type:"readiness",status:"ready",message:z0.type==="tcp"?"Listening on its upstream port":"Configured readiness check passed"}),_}catch(_){throw H({type:"readiness",status:"failed",message:_ instanceof Error?_.message.slice(0,500):"Readiness check failed"}),_}})():Promise.resolve(J),d0=i0();return d0.catch(()=>{}),{name:$.name,service:J,get child(){return F},stop:U0,done:G1,ready:d0}}async function O1($,Y){if(await L0($,Y),process.platform==="win32")return!0;let K=$.pid;if(!K||!T0(K))return!0;if(await F1($,K,S1))return!0;return await L0($,"SIGKILL"),D1(K,_1)}function T0($){try{return process.kill(-$,0),!0}catch(Y){return Y.code==="EPERM"}}async function D1($,Y){let K=Date.now()+Y;while(T0($)){if(Date.now()>=K)return!1;await new Promise((X)=>setTimeout(X,Math.min(20,Y)))}return!0}async function F1($,Y,K){let X=Date.now()+K;while(T0(Y)){if($.exitCode!==null||$.signalCode!==null||Date.now()>=X)return!1;await new Promise((Q)=>setTimeout(Q,Math.min(20,K)))}return!0}function N1($){if(Buffer.byteLength($)<=t0)return[$];let Y=[],K=[],X=0;for(let Q of $){let q=Buffer.byteLength(Q);if(K.length&&X+q>t0)Y.push(K.join("")),K=[],X=0;K.push(Q),X+=q}if(K.length)Y.push(K.join(""));return Y}async function L1($,Y,K,X,Q){if(!$)return{};let q=new Set(Y),z=new Map,W=async(Z)=>{let V=Z.toLowerCase();if(!q.has(V))throw Error(`environment references undeclared prerequisite "${Z}"`);let S=z.get(V);if(S)return S;let H=await Q(`http://127.0.0.1:${X}/api/services/${encodeURIComponent(C0(K,V))}`);if(H.status===404)throw Error(`environment references unresolved prerequisite "${Z}"`);if(!H.ok)throw Error(`could not resolve prerequisite "${Z}" (${H.status})`);let J=await H.json();return z.set(V,J),J},G=/\{service:([^}:]+):(port|url)\}/g,B={};for(let[Z,V]of Object.entries($)){let S=0,H="";for(let J of V.matchAll(G)){H+=V.slice(S,J.index);let O=await W(J[1]);if(J[2]==="port")H+=String(O.serviceType&&O.serviceType!=="http"?O.upstreamPort:O.stablePort);else{if(O.serviceType&&O.serviceType!=="http")throw Error(`environment variable ${Z} cannot use a URL for database prerequisite "${J[1]}"`);H+=`http://localhost:${O.stablePort}`}S=J.index+J[0].length}if(B[Z]=H+V.slice(S),B[Z].includes("{service:"))throw Error(`environment variable ${Z} has an invalid service reference`)}return B}async function K1($){let Y=await u(),K=await o0(Y.apiPort,Boolean(process.stdin.isTTY&&process.stdout.isTTY&&!process.env.CI)),X=[],Q=new AbortController,q=(G)=>{Q.abort(),X.forEach((B)=>B.stop(G))};for(let G of["SIGINT","SIGTERM","SIGHUP"])process.on(G,()=>q(G));let z=await R1($,async(G)=>{let B=await M1({...G,cleanUrls:K});return X.push(B),B},{signal:Q.signal});for(let G of z.failed)console.error(`${U.red("error")} starting "${G.name}": ${G.error.message}`);let W=await Promise.all(X.map((G)=>G.done));process.exit(W.find((G)=>G!==0)??(z.failed.length?1:0))}async function R1($,Y,K={}){let X=new Map($.map((W)=>[W.name.toLowerCase(),W])),Q=new Map,q=(W,G=new Set)=>{let B=W.name.toLowerCase();if(G.has(B))return Promise.resolve({error:Error("project dependency graph contains a cycle")});let Z=Q.get(B);if(Z)return Z;let V,S=new Promise((H)=>{V=H});return Q.set(B,S),(async()=>{let H=W.after??[],J=new Set(G).add(B),L=(await Promise.all(H.map((R)=>{let b=X.get(R.toLowerCase());if(!b)return Promise.resolve({error:Error(`${W.name} starts after unknown service ${R}`)});return q(b,J)}))).find((R)=>R.error);if(L)return V({error:Error(`${W.name} was not started because a prerequisite failed: ${L.error.message}`)});if(K.signal?.aborted)return V({error:Error(`${W.name} was not started because startup was cancelled`)});let N;try{N=await Y(W)}catch(R){return V({error:N0(R)})}if(K.signal?.aborted)return N.stop("SIGTERM"),V({error:Error(`${W.name} was stopped because startup was cancelled`)});if($.some((R)=>(R.after??[]).some((b)=>b.toLowerCase()===B)))console.log(`${U.dim(`LocalDeck: waiting for ${N.name} before starting its dependents`)}`);try{await N.ready}catch(R){return N.stop("SIGTERM"),V({error:N0(R)})}if(K.signal?.aborted)return N.stop("SIGTERM"),V({error:Error(`${W.name} was stopped because startup was cancelled`)});console.log(`${U.green("✓")} ${N.name} ${W.ready?.type==="tcp"?"is listening":"passed readiness"}`),V({service:N})})().catch((H)=>V({error:N0(H)})),S},z=await Promise.all($.map((W)=>q(W)));return{running:z.flatMap((W)=>W.service?[W.service]:[]),failed:$.flatMap((W,G)=>z[G].error?[{name:W.name,error:z[G].error}]:[])}}function N0($){return $ instanceof Error?$:Error(String($))}import m from"node:fs";import E from"node:path";function r($,Y){return $.commands.find((K)=>K.name===Y.toLowerCase())}function E0($=process.cwd()){let Y=e($);if(!Y)return[];let K=P0(Y),Q=C1(Y).flatMap(({file:Z,cwd:V})=>{let H=w0(Z)?.scripts;return H&&typeof H==="object"?Object.entries(H).filter(([,J])=>typeof J==="string").map(([J,O])=>({name:J,run:O,cwd:V})):[]}),q=Q.some((Z)=>Z.cwd),z=Q.filter((Z)=>!(q&&!Z.cwd&&/\b(?:turbo|nx|lerna)\b|\b(?:pnpm|npm|yarn|bun)\s+(?:-r|--recursive|workspaces?)/i.test(Z.run))),W=z.filter((Z)=>z.some((V)=>V.cwd===Z.cwd&&/^dev([:_-]|$)/.test(V.name))?/^dev([:_-]|$)/.test(Z.name):/^(start|serve|preview)([:_-]|$)/.test(Z.name)),G=[],B=new Set;for(let Z of W){let V=Z.name,[S,...H]=V.split(/[:_-]/),J=(Z.cwd&&!H.length?E.basename(Z.cwd):H.join("-")||S).replace(/[^a-z0-9_-]/gi,"-").toLowerCase().replace(/^[^a-z0-9]+/,"");if(!J)J="service";if(B.has(J))J=V.replace(/[^a-z0-9_-]/gi,"-").toLowerCase().replace(/^[^a-z0-9]+/,"");if(J=J.slice(0,41),B.has(J)){let O=2,L=J.replace(/-+$/,"").slice(0,37);while(B.has(J))J=`${L}-${O++}`.slice(0,41)}B.add(J),G.push({name:J,run:`${K} run ${V}`,tags:[],after:[],...Z.cwd?{cwd:Z.cwd}:{},ready:{type:"tcp",timeoutMs:60000,intervalMs:400}})}return G}function e($=process.cwd()){let Y=E.resolve($);for(;;){if(m.existsSync(E.join(Y,"package.json")))return Y;let K=E.dirname(Y);if(K===Y)return;Y=K}}function P0($){let Y=w0(E.join($,"package.json"));if(typeof Y?.packageManager==="string"){let X=Y.packageManager.split("@")[0];if(["npm","bun","pnpm","yarn"].includes(X))return X}return[["bun.lock","bun"],["bun.lockb","bun"],["pnpm-lock.yaml","pnpm"],["yarn.lock","yarn"],["package-lock.json","npm"]].find(([X])=>m.existsSync(E.join($,X)))?.[1]??"npm"}function w0($){try{let Y=JSON.parse(m.readFileSync($,"utf8"));if(!Y||typeof Y!=="object"||Array.isArray(Y))throw Error("manifest must contain an object");return Y}catch(Y){if(m.existsSync($))throw Error(`${$} is not valid JSON: ${Y.message}`);return}}function C1($){let Y=E.join($,"package.json"),K=w0(Y),X=[{file:Y}],z=(Array.isArray(K?.workspaces)?K.workspaces:Array.isArray(K?.packages)?K.packages:Array.isArray(K?.workspaces?.packages)?K.workspaces.packages:[]).filter((G)=>typeof G==="string"&&!G.includes("..")&&!E.isAbsolute(G)).map((G)=>{let B=G.replace(/\\/g,"/").replace(/^\.\//,"").replace(/\/$/,""),Z=B.split("/"),V=Z.map((S,H)=>S==="**"?H===Z.length-1?".*":"(?:[^/]+/)*":S.split("*").map((J)=>J.replace(/[.+?^${}()|[\]\\]/g,"\\$&")).join("[^/]*")+(H<Z.length-1?"/":"")).join("");return{regex:new RegExp(`^${V}$`),prefix:B.split("*")[0],depth:Z.includes("**")?1/0:Z.length}}),W=(G,B)=>{if(!z.some((Z)=>Z.depth>=B))return;for(let Z of m.readdirSync(G,{withFileTypes:!0}).sort((V,S)=>V.name.localeCompare(S.name))){if(!Z.isDirectory()||Z.isSymbolicLink()||["node_modules",".git",".superpowers","dist"].includes(Z.name))continue;let V=E.join(G,Z.name),S=E.relative($,V).replace(/\\/g,"/");if(!z.some((H)=>H.prefix.startsWith(`${S}/`)||S.startsWith(H.prefix)||H.prefix===S))continue;if(z.some((H)=>H.regex.test(S))){let H=E.join(V,"package.json");if(m.existsSync(H)&&m.lstatSync(H).isFile())X.push({file:H,cwd:S})}W(V,B+1)}};return W($,1),X}import j0 from"node:fs";import P from"node:path";import T from"node:fs";import A from"node:path";import{spawnSync as T1}from"node:child_process";async function X1($=process.cwd(),Y={}){let K=Y.executable??((B,Z,V)=>T1(B,Z,{encoding:"utf8",timeout:V})),X=[],Q=K("node",["--version"],2000),q=String(Q.stdout??"").trim().replace(/^v/,""),z=Number(q.split(".")[0]);X.push({name:"node",ok:Q.status===0&&z>=20,message:Q.status===0?`Node.js ${q}`:"Node.js executable is unavailable",fix:Q.status===0&&z>=20?void 0:"Install Node.js 20 or newer and put it on PATH."});let W=e($);if(!W)X.push({name:"package-manager",ok:!0,message:"No package.json; using explicitly configured commands."});else{let B="npm";try{B=P0(W)}catch(H){X.push({name:"package.json",ok:!1,message:H.message,fix:"Fix package.json syntax."})}let Z=K(B,["--version"],2000).status===0;X.push({name:"package-manager",ok:Z,message:`${B} ${Z?"is available":"is not available"}`,fix:Z?void 0:`Install ${B} or put it on PATH.`});let V;try{if(V=JSON.parse(T.readFileSync(A.join(W,"package.json"),"utf8")),!V||typeof V!=="object"||Array.isArray(V))throw Error("manifest must contain an object")}catch(H){X.push({name:"package.json",ok:!1,message:`${A.join(W,"package.json")} is not valid JSON: ${H.message}`,fix:"Fix package.json syntax."}),V={}}let S={...V.dependencies??{},...V.devDependencies??{},...V.optionalDependencies??{}};if(Object.keys(S).length){let H=T.existsSync(A.join(W,"node_modules"))||T.existsSync(A.join(W,".pnp.cjs"));X.push({name:"dependencies",ok:H,message:H?"node_modules exists":"dependencies are not installed",fix:H?void 0:`Run ${B} install.`})}}let G=I0($);if(!G)X.push({name:"config",ok:!1,message:"No LocalDeck config found",fix:"Run localdeck init."});else try{let B=x0(G);X.push({name:"config",ok:!0,message:`${A.basename(G)}: ${B.commands.length} service(s)`});let Z=[...new Set(B.commands.map((J)=>A.resolve(B.dir,J.cwd??".")))];for(let J of Z){let O=T.existsSync(J)&&T.statSync(J).isDirectory();X.push({name:`working-directory:${A.relative(B.dir,J)||"."}`,ok:O,message:O?"directory exists":"directory does not exist",fix:O?void 0:"Fix the command cwd in your LocalDeck config."})}for(let J of new Set([B.dir,...Z])){if(!T.existsSync(J)||!T.statSync(J).isDirectory())continue;let O=A.relative(B.dir,J)||".",L=A.join(J,"package.json");if(J!==W&&T.existsSync(L))try{let x=JSON.parse(T.readFileSync(L,"utf8"));if(Object.keys({...x.dependencies,...x.devDependencies}).length){let w=[J,W??B.dir].some((o)=>T.existsSync(A.join(o,"node_modules"))||T.existsSync(A.join(o,".pnp.cjs")));X.push({name:`dependencies:${O}`,ok:w,message:w?"Dependency installation found":"Dependencies are not installed",fix:w?void 0:"Run the project's package manager install command."})}}catch{X.push({name:`package.json:${O}`,ok:!1,message:"Invalid package.json",fix:"Fix this workspace's package.json syntax."})}let N=A.join(J,".env.example");if(!T.existsSync(N))continue;let R=I1(T.readFileSync(N,"utf8")),b=A.join(J,".env"),B0=A1(T.existsSync(b)?T.readFileSync(b,"utf8"):""),F=B.commands.filter((x)=>A.resolve(B.dir,x.cwd??".")===J),h=[...R].filter((x)=>!process.env[x]&&!B0.get(x)&&(!F.length||!F.every((w)=>Boolean(w.env?.[x]))));X.push({name:O==="."?"environment":`environment:${O}`,ok:!h.length,message:h.length?`missing variable names: ${h.join(", ")}`:"required variable names are present",fix:h.length?"Set the variables in this folder's .env or the environment.":void 0})}for(let J of B.commands)if(J.run.includes("docker")||J.serviceType==="compose"){let O=K("docker",["--version"],2000).status===0,L=O&&K("docker",["info"],3000).status===0;X.push({name:"docker",ok:L,message:L?"Docker executable and daemon are available":O?"Docker executable found but daemon is unavailable":"Docker executable is unavailable",fix:L?void 0:"Start Docker Desktop or the Docker daemon."});break}let V=B.commands.map((J)=>J.port).filter((J)=>Number.isInteger(J)),S=[...new Set(V.filter((J,O)=>V.indexOf(J)!==O))];X.push({name:"stable-ports",ok:!S.length,message:S.length?`conflicting configured ports: ${S.join(", ")}`:"configured stable ports are unique",fix:S.length?"Assign each service a different stable port.":void 0});let H=Y.portFree??Q1;for(let J of[...new Set(V)])if(!await H(J))X.push({name:`stable-port:${J}`,ok:!1,message:`port ${J} is already in use`,fix:"Choose another stable port or stop the process using it."});for(let J of B.commands){let O=J.serviceType,L=J.ready.type==="command"&&/^(pg_isready|redis-cli)\b/.exec(J.ready.run)?.[1];if(L){let N=L,R=K(N,["--version"],2000).status===0;X.push({name:N,ok:R,message:R?`${N} is available`:`${N} is unavailable for configured ${O} checks`,fix:R?void 0:`Install ${N} or use a configured container check.`})}}}catch(B){X.push({name:"config",ok:!1,message:B.message,fix:"Fix the config JSON and run doctor again."})}return{ok:X.every((B)=>B.ok),checks:X}}function I1($){return new Set($.split(/\r?\n/).map((Y)=>Y.match(/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=/)?.[1]).filter((Y)=>Boolean(Y)))}function A1($){return new Map($.split(/\r?\n/).map((Y)=>Y.match(/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/)).filter((Y)=>Boolean(Y)).map((Y)=>[Y[1],Y[2].trim().replace(/^(['"])(.*)\1$/,"$2")]))}var Z1=`${U.bold("localdeck")} ${U.dim(`v${V0}`)} — stable ports, shareable links and logs for local dev servers
4
4
 
@@ -45,7 +45,7 @@ ${U.bold(".localdeck")} (JSON, at the project root)
45
45
  "after" is the beginner-friendly startup order. LocalDeck verifies each
46
46
  prerequisite is ready before starting its dependents. Omit "ready" to use
47
47
  automatic port readiness; HTTP paths and advanced checks are optional.
48
- `,b1={loadProject:A0,ensureDaemon:u,createApi:($)=>new K0($),findDaemon:Y0,createWebSocket:($)=>new d($),runForeground:K1,log:($)=>console.log($),warn:($)=>console.warn($)};async function E1($,Y={}){let K={...b1,...Y},[X,...Q]=$;switch(X){case void 0:console.log(Z1),await f0(!1,K);return;case"help":case"-h":case"--h":case"--help":console.log(Z1);return;case"--update":if(Q.length)throw Error("Usage: localdeck --update");return(await import("./update-zhsjwnrw.js")).updateLocalDeck();case"up":return P1(Q,K);case"profile":case"profiles":return w1(Q,K);case"init":return k1(Q,K);case"mcp":return(await import("./mcp-59a41rj3.js")).runMcp(Q);case"quarry":return(await import("./quarry-23qjnaj9.js")).runQuarry(Q);case"doctor":return j1(Q);case"forward":return f1(Q);case"commands":case"cmds":return f0(!0,K);case"-v":case"--v":case"--version":console.log(V0);return;case"run":return h1(Q,K);case"ps":case"ls":case"ports":return u1(K);case"port":return m1(Q[0]);case"logs":return l1(Q,K);case"requests":return p1(Q);case"share":return i1(Q);case"unshare":return d1(Q[0]);case"stop":return c1(Q[0]);case"open":return o1(Q[0]);case"daemon":return t1(Q[0]);default:{let q=Q0(K),z=q&&r(q,X);if(z){let G=await X0(q,K),B=await g0(q,G,K),Z=q0(q.commands,[z.name]).flat();return K.runForeground(Z.map((V,S)=>h0(B.effective(V),q,G,{prefix:Z.length>1,color:c[S%c.length],...B.options})))}let W=q?` Commands in ${P.basename(q.file)}: ${q.commands.map((G)=>G.name).join(", ")||"(none)"}`:"";M(`unknown command "${X}". Run localdeck --help.${W}`)}}}function Q0($){try{return $.loadProject()}catch(Y){M(Y.message)}}function h0($,Y,K,X={}){return{name:$.name,...K?{project:K}:{},stablePort:$.port,upstreamPort:$.upstream,command:b0($.run),displayCommand:$.run,cwd:$.cwd?P.resolve(Y.dir,$.cwd):Y.dir,after:$.after,ready:$.ready,...$.env?{env:$.env}:{},...$.secrets?{secrets:$.secrets}:{},...$.serviceType?{serviceType:$.serviceType}:{},...X}}async function X0($,Y){try{let K=await Y.ensureDaemon();return await Y.createApi(K.apiPort).rememberProject($.file,K.controlToken)}catch(K){let X=K instanceof Error?K.message:String(K);Y.warn(`LocalDeck: could not remember this project: ${X}`);return}}async function g0($,Y,K){let X=[];if($.profiles?.length&&Y)try{let z=await K.ensureDaemon();X=(await K.createApi(z.apiPort).profiles(Y.id)).active}catch(z){K.warn(`LocalDeck: could not read active profiles, running without them: ${z instanceof Error?z.message:String(z)}`)}let Q;try{Q=y0($,X)}catch(z){M(z instanceof Error?z.message:String(z))}if(Q.active.length)K.log(U.dim(`Profiles: ${Q.active.join(" + ")}`));for(let z of Q.clashes)K.warn(`LocalDeck: ${z.profiles.join(" and ")} both set ${z.service} ${z.field}; ${z.winner} wins because it is listed later.`);let q=new Map(Q.commands.map((z)=>[z.name,z]));return{effective:(z)=>q.get(z.name)??z,options:Y?{profiles:Q.active}:{}}}async function f0($,Y){let K=Q0(Y);if(!K){if($)M("no .localdeck file found here or in a parent folder. Create one with: localdeck init");return}await X0(K,Y),console.log(`${U.bold("Project commands")} ${U.dim(`(${P.relative(process.cwd(),K.file)||P.basename(K.file)})`)}`);let X=K.commands.map((Q)=>[U.cyan(Q.name),Q.port?String(Q.port):U.dim("auto"),Q.after.join(",")||"",Q.tags.join(",")||"",U.dim(Q.run)]);if(console.log(i(X,["NAME","PORT","AFTER","TAGS","RUN"])),K.profiles?.length)console.log(`
48
+ `,b1={loadProject:A0,ensureDaemon:u,createApi:($)=>new K0($),findDaemon:Y0,createWebSocket:($)=>new d($),runForeground:K1,log:($)=>console.log($),warn:($)=>console.warn($)};async function E1($,Y={}){let K={...b1,...Y},[X,...Q]=$;switch(X){case void 0:console.log(Z1),await f0(!1,K);return;case"help":case"-h":case"--h":case"--help":console.log(Z1);return;case"--update":if(Q.length)throw Error("Usage: localdeck --update");return(await import("./update-c2m151t6.js")).updateLocalDeck();case"up":return P1(Q,K);case"profile":case"profiles":return w1(Q,K);case"init":return k1(Q,K);case"mcp":return(await import("./mcp-yqgy25c4.js")).runMcp(Q);case"quarry":return(await import("./quarry-31n76q0s.js")).runQuarry(Q);case"doctor":return j1(Q);case"forward":return f1(Q);case"commands":case"cmds":return f0(!0,K);case"-v":case"--v":case"--version":console.log(V0);return;case"run":return h1(Q,K);case"ps":case"ls":case"ports":return u1(K);case"port":return m1(Q[0]);case"logs":return l1(Q,K);case"requests":return p1(Q);case"share":return i1(Q);case"unshare":return d1(Q[0]);case"stop":return c1(Q[0]);case"open":return o1(Q[0]);case"daemon":return t1(Q[0]);default:{let q=Q0(K),z=q&&r(q,X);if(z){let G=await X0(q,K),B=await g0(q,G,K),Z=q0(q.commands,[z.name]).flat();return K.runForeground(Z.map((V,S)=>h0(B.effective(V),q,G,{prefix:Z.length>1,color:c[S%c.length],...B.options})))}let W=q?` Commands in ${P.basename(q.file)}: ${q.commands.map((G)=>G.name).join(", ")||"(none)"}`:"";M(`unknown command "${X}". Run localdeck --help.${W}`)}}}function Q0($){try{return $.loadProject()}catch(Y){M(Y.message)}}function h0($,Y,K,X={}){return{name:$.name,...K?{project:K}:{},stablePort:$.port,upstreamPort:$.upstream,command:b0($.run),displayCommand:$.run,cwd:$.cwd?P.resolve(Y.dir,$.cwd):Y.dir,after:$.after,ready:$.ready,...$.env?{env:$.env}:{},...$.secrets?{secrets:$.secrets}:{},...$.serviceType?{serviceType:$.serviceType}:{},...X}}async function X0($,Y){try{let K=await Y.ensureDaemon();return await Y.createApi(K.apiPort).rememberProject($.file,K.controlToken)}catch(K){let X=K instanceof Error?K.message:String(K);Y.warn(`LocalDeck: could not remember this project: ${X}`);return}}async function g0($,Y,K){let X=[];if($.profiles?.length&&Y)try{let z=await K.ensureDaemon();X=(await K.createApi(z.apiPort).profiles(Y.id)).active}catch(z){K.warn(`LocalDeck: could not read active profiles, running without them: ${z instanceof Error?z.message:String(z)}`)}let Q;try{Q=y0($,X)}catch(z){M(z instanceof Error?z.message:String(z))}if(Q.active.length)K.log(U.dim(`Profiles: ${Q.active.join(" + ")}`));for(let z of Q.clashes)K.warn(`LocalDeck: ${z.profiles.join(" and ")} both set ${z.service} ${z.field}; ${z.winner} wins because it is listed later.`);let q=new Map(Q.commands.map((z)=>[z.name,z]));return{effective:(z)=>q.get(z.name)??z,options:Y?{profiles:Q.active}:{}}}async function f0($,Y){let K=Q0(Y);if(!K){if($)M("no .localdeck file found here or in a parent folder. Create one with: localdeck init");return}await X0(K,Y),console.log(`${U.bold("Project commands")} ${U.dim(`(${P.relative(process.cwd(),K.file)||P.basename(K.file)})`)}`);let X=K.commands.map((Q)=>[U.cyan(Q.name),Q.port?String(Q.port):U.dim("auto"),Q.after.join(",")||"",Q.tags.join(",")||"",U.dim(Q.run)]);if(console.log(i(X,["NAME","PORT","AFTER","TAGS","RUN"])),K.profiles?.length)console.log(`
49
49
  ${U.bold("Profiles")} ${K.profiles.map((Q)=>Q.name).join(", ")} ${U.dim("· localdeck profile")}`);console.log(U.dim(`
50
50
  run one: localdeck <name> · run all: localdeck up · by tag: localdeck up <tag>`))}var c=[U.cyan,U.magenta,U.green,U.yellow,U.blue];async function P1($,Y){let K=Q0(Y);if(!K)M("no .localdeck file found here or in a parent folder. Create one with: localdeck init");let X=$.indexOf("--profile"),Q;if(X!==-1){if(Q=$[X+1],!Q)M("--profile needs a profile name");$=$.filter((B,Z)=>Z!==X&&Z!==X+1)}let q=K.legacyProfiles;if(Q&&K.profiles?.some((B)=>B.name===Q))M(`"${Q}" is a profile you turn on, not a group to start: localdeck profile on ${Q}`);if(Q&&(!q||!Object.prototype.hasOwnProperty.call(q,Q)))M(`unknown profile "${Q}". Group services with tags and run: localdeck up <tag>`);if(Q)Y.warn(`LocalDeck: --profile is deprecated. "${Q}" is now a tag; run: localdeck up ${Q}`);let z=K.commands;if(Q){let B=new Set(q[Q]);if(z=K.commands.filter((Z)=>B.has(Z.name)),!z.length)M(`profile "${Q}" selects no configured services`)}if($.length){let B=new Set(z),Z=K.commands.filter((H)=>$.some((J)=>r(K,J)===H||H.tags.includes(J))),V=Z.filter((H)=>!B.has(H));if(Q&&V.length)M(`service outside profile "${Q}": ${V.map((H)=>H.name).join(", ")}`);z=Z.filter((H)=>B.has(H));let S=$.filter((H)=>!r(K,H)&&!K.commands.some((J)=>J.tags.includes(H)));if(S.length)M(`no command or tag named ${S.map((H)=>`"${H}"`).join(", ")} in ${P.basename(K.file)}`)}if(!z.length)M("nothing to run");z=q0(K.commands,z.map((B)=>B.name)).flat();let W=await X0(K,Y),G=await g0(K,W,Y);await Y.runForeground(z.map((B,Z)=>h0(G.effective(B),K,W,{prefix:z.length>1,color:c[Z%c.length],...G.options})))}async function w1($,Y){let K=Q0(Y);if(!K)M("no .localdeck file found here or in a parent folder. Create one with: localdeck init");let[X="list",...Q]=$;if(!["list","ls","on","off","clear"].includes(X))M(`unknown profile action "${X}". Usage: localdeck profile [on|off <name...>|clear]`);if((X==="on"||X==="off")&&!Q.length)M(`localdeck profile ${X} needs at least one profile name`);if(!K.profiles?.length){if(X==="list"||X==="ls"){Y.log(`No profiles in ${P.basename(K.file)}. Add a "profiles" object to run services differently, for example against staging.`);return}M(`${P.basename(K.file)} defines no profiles`)}let q=await X0(K,Y);if(!q)M("the LocalDeck daemon is needed to switch profiles");let z=await Y.ensureDaemon(),W=Y.createApi(z.apiPort),G=await W.profiles(q.id);if(X==="on"||X==="off"||X==="clear"){let B=Q.map((S)=>S.toLowerCase()),Z=B.filter((S)=>!G.profiles.some((H)=>H.name===S));if(Z.length)M(`unknown profile ${Z.map((S)=>`"${S}"`).join(", ")}. Available profiles: ${G.profiles.map((S)=>S.name).join(", ")}`);let V=X==="clear"?[]:X==="on"?[...new Set([...G.active,...B])]:G.active.filter((S)=>!B.includes(S));G=await W.setActiveProfiles(q.id,V),Y.log(G.active.length?`Profiles on: ${U.cyan(G.active.join(" + "))}`:"No profiles on · running base services"),Y.log(U.dim("Running services keep their settings until restarted."))}else{let B=G.profiles.map((Z)=>[Z.active?U.green("on"):U.dim("off"),U.cyan(Z.name),Z.services.join(","),Z.description??""]);Y.log(i(B,["","PROFILE","CHANGES","DESCRIPTION"])),Y.log(U.dim(`
51
51
  turn on: localdeck profile on <name> · off: localdeck profile off <name> · all off: localdeck profile clear`))}for(let B of G.clashes)Y.warn(`LocalDeck: ${B.profiles.join(" and ")} both set ${B.service} ${B.field}; ${B.winner} wins because it is listed later.`);if(G.error)Y.warn(`LocalDeck: ${G.error}`)}async function k1($,Y){let K=e()??process.cwd(),X=[".localdeck",".localdeck.json","localdeck.json"].map((H)=>P.join(K,H)).find((H)=>j0.existsSync(H)),Q=$.find((H)=>H===".localdeck.json"||H==="localdeck.json")??(X?P.basename(X):".localdeck"),q=P.join(K,Q);if((X&&X!==q||j0.existsSync(q))&&!$.includes("--force")&&!$.includes("--dry-run"))M(`${P.basename(X??q)} already exists here (use --force to overwrite)`);let z=$.indexOf("--command"),W=$.indexOf("--name"),G=z>=0?$[z+1]:void 0,B=W>=0?$[W+1]:void 0;if(z>=0&&(!G||G.startsWith("--")))M("--command requires a command value");if(W>=0&&(!B||B.startsWith("--")))M("--name requires a service name");if(G!==void 0&&!G.trim())M("--command must not be empty");if(G&&!B)M("--command requires --name <service>");if(B&&!/^[a-z0-9][a-z0-9_-]{0,40}$/i.test(B))M("--name must start with a letter or number and be at most 41 characters");let Z=G?[{name:B.toLowerCase(),run:G,tags:[],cwd:void 0}]:E0();if(!Z.length)M("could not infer any runnable scripts. Add --command '<command>' --name <service>, then run localdeck init again");let S=Z.map((H)=>({name:H.name,run:H.run,...H.cwd?{cwd:H.cwd}:{},...H.tags.length?{tag:H.tags.length===1?H.tags[0]:H.tags}:{}}));if($.includes("--dry-run")){console.log(JSON.stringify({file:q,commands:S},null,2));return}console.log(i(S.map((H)=>[H.name,H.run,H.cwd??"."]),["SERVICE","COMMAND","FOLDER"])),j0.writeFileSync(q,JSON.stringify({commands:S},null,2)+`
@@ -1,4 +1,4 @@
1
- import{I as N,e as Y}from"./index-fmgnn6mt.js";import{va as C,wa as J}from"./index-2da1tyad.js";import{parseArgs as Z}from"node:util";import y from"node:process";var P=10485760;class Q{constructor(b){this._maxBufferSize=b?.maxBufferSize??P}append(b){if((this._buffer?.length??0)+b.length>this._maxBufferSize)throw this.clear(),Error(`ReadBuffer exceeded maximum size of ${this._maxBufferSize} bytes`);this._buffer=this._buffer?Buffer.concat([this._buffer,b]):b}readMessage(){if(!this._buffer)return null;let b=this._buffer.indexOf(`
1
+ import{I as N,e as Y}from"./index-xhf909hw.js";import{va as C,wa as J}from"./index-hdw8ggnb.js";import{parseArgs as Z}from"node:util";import y from"node:process";var P=10485760;class Q{constructor(b){this._maxBufferSize=b?.maxBufferSize??P}append(b){if((this._buffer?.length??0)+b.length>this._maxBufferSize)throw this.clear(),Error(`ReadBuffer exceeded maximum size of ${this._maxBufferSize} bytes`);this._buffer=this._buffer?Buffer.concat([this._buffer,b]):b}readMessage(){if(!this._buffer)return null;let b=this._buffer.indexOf(`
2
2
  `);if(b===-1)return null;let q=this._buffer.toString("utf8",0,b).replace(/\r$/,"");return this._buffer=this._buffer.subarray(b+1),X(q)}clear(){this._buffer=void 0}}function X(b){return Y.parse(JSON.parse(b))}function $(b){return JSON.stringify(b)+`
3
3
  `}class V{constructor(b=y.stdin,q=y.stdout,w){this._stdin=b,this._stdout=q,this._started=!1,this._ondata=(K)=>{try{this._readBuffer.append(K),this.processReadBuffer()}catch(H){this.onerror?.(H),this.close().catch(()=>{})}},this._onerror=(K)=>{this.onerror?.(K)},this._readBuffer=new Q({maxBufferSize:w?.maxBufferSize})}async start(){if(this._started)throw Error("StdioServerTransport already started! If using Server class, note that connect() calls start() automatically.");this._started=!0,this._stdin.on("data",this._ondata),this._stdin.on("error",this._onerror)}processReadBuffer(){while(!0)try{let b=this._readBuffer.readMessage();if(b===null)break;this.onmessage?.(b)}catch(b){this.onerror?.(b)}}async close(){if(this._stdin.off("data",this._ondata),this._stdin.off("error",this._onerror),this._stdin.listenerCount("data")===0)this._stdin.pause();this._readBuffer.clear(),this.onclose?.()}send(b){return new Promise((q)=>{let w=$(b);if(this._stdout.write(w))q();else this._stdout.once("drain",q)})}}async function T(b){let{values:q}=Z({args:b,strict:!0,allowPositionals:!1,options:{project:{type:"string"},help:{type:"boolean",short:"h"}}});if(q.help){console.log(`Usage: localdeck mcp [--project <id>]
4
4
  Runs an MCP server over stdio for inspection, service control, recorded GET/HEAD replay and quick sharing.
@@ -0,0 +1,5 @@
1
+ import{A as b,B as gZ,C as bZ,D as kZ,E as hZ,F as uZ,G as lZ,H as dZ,I as K0,a as P,b as PZ,c as CZ,d as M,f as u,g as jZ,h as FZ,i as LZ,j as zZ,k as AZ,l as _Z,m as qZ,n as xZ,o as MZ,p as TZ,q as r,r as IZ,s as yZ,t as EZ,u as SZ,v as fZ,w as wZ,x as RZ,y as vZ,z as A}from"./index-xhf909hw.js";import{N as sZ,U as rZ,X as eZ,ra as GZ,ta as Z0,va as $0,wa as J0}from"./index-hdw8ggnb.js";import mZ from"node:crypto";import c from"node:fs";import p from"node:path";class QZ{constructor(Z){this._client=Z}async*callToolStream(Z,H=r,Q){let B=this._client,G={...Q,task:Q?.task??(B.isToolTask(Z.name)?{}:void 0)},W=B.requestStream({method:"tools/call",params:Z},H,G),O=B.getToolOutputValidator(Z.name);for await(let N of W){if(N.type==="result"&&O){let C=N.result;if(!C.structuredContent&&!C.isError){yield{type:"error",error:new A(M.InvalidRequest,`Tool ${Z.name} has an output schema but did not return structured content`)};return}if(C.structuredContent)try{let V=O(C.structuredContent);if(!V.valid){yield{type:"error",error:new A(M.InvalidParams,`Structured content does not match the tool's output schema: ${V.errorMessage}`)};return}}catch(V){if(V instanceof A){yield{type:"error",error:V};return}yield{type:"error",error:new A(M.InvalidParams,`Failed to validate structured content: ${V instanceof Error?V.message:String(V)}`)};return}}yield N}}async getTask(Z,H){return this._client.getTask({taskId:Z},H)}async getTaskResult(Z,H,Q){return this._client.getTaskResult({taskId:Z},H,Q)}async listTasks(Z,H){return this._client.listTasks(Z?{cursor:Z}:void 0,H)}async cancelTask(Z,H){return this._client.cancelTask({taskId:Z},H)}requestStream(Z,H,Q){return this._client.requestStream(Z,H,Q)}}function e(Z,H){if(!Z||H===null||typeof H!=="object")return;if(Z.type==="object"&&Z.properties&&typeof Z.properties==="object"){let Q=H,B=Z.properties;for(let G of Object.keys(B)){let W=B[G];if(Q[G]===void 0&&Object.prototype.hasOwnProperty.call(W,"default"))Q[G]=W.default;if(Q[G]!==void 0)e(W,Q[G])}}if(Array.isArray(Z.anyOf)){for(let Q of Z.anyOf)if(typeof Q!=="boolean")e(Q,H)}if(Array.isArray(Z.oneOf)){for(let Q of Z.oneOf)if(typeof Q!=="boolean")e(Q,H)}}function L0(Z){if(!Z)return{supportsFormMode:!1,supportsUrlMode:!1};let H=Z.form!==void 0,Q=Z.url!==void 0;return{supportsFormMode:H||!H&&!Q,supportsUrlMode:Q}}class WZ extends kZ{constructor(Z,H){super(H);if(this._clientInfo=Z,this._cachedToolOutputValidators=new Map,this._cachedKnownTaskTools=new Set,this._cachedRequiredTaskTools=new Set,this._listChangedDebounceTimers=new Map,this._capabilities=H?.capabilities??{},this._jsonSchemaValidator=H?.jsonSchemaValidator??new uZ,H?.listChanged)this._pendingListChangedConfig=H.listChanged}_setupListChangedHandlers(Z){if(Z.tools&&this._serverCapabilities?.tools?.listChanged)this._setupListChangedHandler("tools",IZ,Z.tools,async()=>{return(await this.listTools()).tools});if(Z.prompts&&this._serverCapabilities?.prompts?.listChanged)this._setupListChangedHandler("prompts",MZ,Z.prompts,async()=>{return(await this.listPrompts()).prompts});if(Z.resources&&this._serverCapabilities?.resources?.listChanged)this._setupListChangedHandler("resources",_Z,Z.resources,async()=>{return(await this.listResources()).resources})}get experimental(){if(!this._experimental)this._experimental={tasks:new QZ(this)};return this._experimental}registerCapabilities(Z){if(this.transport)throw Error("Cannot register capabilities after connecting to transport");this._capabilities=hZ(this._capabilities,Z)}setRequestHandler(Z,H){let B=gZ(Z)?.method;if(!B)throw Error("Schema is missing a method literal");let G=bZ(B);if(typeof G!=="string")throw Error("Schema method literal must be a string");let W=G;if(W==="elicitation/create"){let O=async(N,C)=>{let V=b(wZ,N);if(!V.success){let x=V.error instanceof Error?V.error.message:String(V.error);throw new A(M.InvalidParams,`Invalid elicitation request: ${x}`)}let{params:U}=V.data;U.mode=U.mode??"form";let{supportsFormMode:j,supportsUrlMode:y}=L0(this._capabilities.elicitation);if(U.mode==="form"&&!j)throw new A(M.InvalidParams,"Client does not support form-mode elicitation requests");if(U.mode==="url"&&!y)throw new A(M.InvalidParams,"Client does not support URL-mode elicitation requests");let f=await Promise.resolve(H(N,C));if(U.task){let x=b(FZ,f);if(!x.success){let n=x.error instanceof Error?x.error.message:String(x.error);throw new A(M.InvalidParams,`Invalid task creation result: ${n}`)}return x.data}let T=b(RZ,f);if(!T.success){let x=T.error instanceof Error?T.error.message:String(T.error);throw new A(M.InvalidParams,`Invalid elicitation result: ${x}`)}let z=T.data,R=U.mode==="form"?U.requestedSchema:void 0;if(U.mode==="form"&&z.action==="accept"&&z.content&&R){if(this._capabilities.elicitation?.form?.applyDefaults)try{e(R,z.content)}catch{}}return z};return super.setRequestHandler(Z,O)}if(W==="sampling/createMessage"){let O=async(N,C)=>{let V=b(EZ,N);if(!V.success){let z=V.error instanceof Error?V.error.message:String(V.error);throw new A(M.InvalidParams,`Invalid sampling request: ${z}`)}let{params:U}=V.data,j=await Promise.resolve(H(N,C));if(U.task){let z=b(FZ,j);if(!z.success){let R=z.error instanceof Error?z.error.message:String(z.error);throw new A(M.InvalidParams,`Invalid task creation result: ${R}`)}return z.data}let f=U.tools||U.toolChoice?fZ:SZ,T=b(f,j);if(!T.success){let z=T.error instanceof Error?T.error.message:String(T.error);throw new A(M.InvalidParams,`Invalid sampling result: ${z}`)}return T.data};return super.setRequestHandler(Z,O)}return super.setRequestHandler(Z,H)}assertCapability(Z,H){if(!this._serverCapabilities?.[Z])throw Error(`Server does not support ${Z} (required for ${H})`)}async connect(Z,H){if(await super.connect(Z),Z.sessionId!==void 0)return;try{let Q=await this.request({method:"initialize",params:{protocolVersion:PZ,capabilities:this._capabilities,clientInfo:this._clientInfo}},jZ,H);if(Q===void 0)throw Error(`Server sent invalid initialize result: ${Q}`);if(!CZ.includes(Q.protocolVersion))throw Error(`Server's protocol version is not supported: ${Q.protocolVersion}`);if(this._serverCapabilities=Q.capabilities,this._serverVersion=Q.serverInfo,Z.setProtocolVersion)Z.setProtocolVersion(Q.protocolVersion);if(this._instructions=Q.instructions,await this.notification({method:"notifications/initialized"}),this._pendingListChangedConfig)this._setupListChangedHandlers(this._pendingListChangedConfig),this._pendingListChangedConfig=void 0}catch(Q){throw this.close(),Q}}getServerCapabilities(){return this._serverCapabilities}getServerVersion(){return this._serverVersion}getInstructions(){return this._instructions}assertCapabilityForMethod(Z){switch(Z){case"logging/setLevel":if(!this._serverCapabilities?.logging)throw Error(`Server does not support logging (required for ${Z})`);break;case"prompts/get":case"prompts/list":if(!this._serverCapabilities?.prompts)throw Error(`Server does not support prompts (required for ${Z})`);break;case"resources/list":case"resources/templates/list":case"resources/read":case"resources/subscribe":case"resources/unsubscribe":if(!this._serverCapabilities?.resources)throw Error(`Server does not support resources (required for ${Z})`);if(Z==="resources/subscribe"&&!this._serverCapabilities.resources.subscribe)throw Error(`Server does not support resource subscriptions (required for ${Z})`);break;case"tools/call":case"tools/list":if(!this._serverCapabilities?.tools)throw Error(`Server does not support tools (required for ${Z})`);break;case"completion/complete":if(!this._serverCapabilities?.completions)throw Error(`Server does not support completions (required for ${Z})`);break;case"initialize":break;case"ping":break}}assertNotificationCapability(Z){switch(Z){case"notifications/roots/list_changed":if(!this._capabilities.roots?.listChanged)throw Error(`Client does not support roots list changed notifications (required for ${Z})`);break;case"notifications/initialized":break;case"notifications/cancelled":break;case"notifications/progress":break}}assertRequestHandlerCapability(Z){if(!this._capabilities)return;switch(Z){case"sampling/createMessage":if(!this._capabilities.sampling)throw Error(`Client does not support sampling capability (required for ${Z})`);break;case"elicitation/create":if(!this._capabilities.elicitation)throw Error(`Client does not support elicitation capability (required for ${Z})`);break;case"roots/list":if(!this._capabilities.roots)throw Error(`Client does not support roots capability (required for ${Z})`);break;case"tasks/get":case"tasks/list":case"tasks/result":case"tasks/cancel":if(!this._capabilities.tasks)throw Error(`Client does not support tasks capability (required for ${Z})`);break;case"ping":break}}assertTaskCapability(Z){lZ(this._serverCapabilities?.tasks?.requests,Z,"Server")}assertTaskHandlerCapability(Z){if(!this._capabilities)return;dZ(this._capabilities.tasks?.requests,Z,"Client")}async ping(Z){return this.request({method:"ping"},u,Z)}async complete(Z,H){return this.request({method:"completion/complete",params:Z},vZ,H)}async setLoggingLevel(Z,H){return this.request({method:"logging/setLevel",params:{level:Z}},u,H)}async getPrompt(Z,H){return this.request({method:"prompts/get",params:Z},xZ,H)}async listPrompts(Z,H){return this.request({method:"prompts/list",params:Z},qZ,H)}async listResources(Z,H){return this.request({method:"resources/list",params:Z},LZ,H)}async listResourceTemplates(Z,H){return this.request({method:"resources/templates/list",params:Z},zZ,H)}async readResource(Z,H){return this.request({method:"resources/read",params:Z},AZ,H)}async subscribeResource(Z,H){return this.request({method:"resources/subscribe",params:Z},u,H)}async unsubscribeResource(Z,H){return this.request({method:"resources/unsubscribe",params:Z},u,H)}async callTool(Z,H=r,Q){if(this.isToolTaskRequired(Z.name))throw new A(M.InvalidRequest,`Tool "${Z.name}" requires task-based execution. Use client.experimental.tasks.callToolStream() instead.`);let B=await this.request({method:"tools/call",params:Z},H,Q),G=this.getToolOutputValidator(Z.name);if(G){if(!B.structuredContent&&!B.isError)throw new A(M.InvalidRequest,`Tool ${Z.name} has an output schema but did not return structured content`);if(B.structuredContent)try{let W=G(B.structuredContent);if(!W.valid)throw new A(M.InvalidParams,`Structured content does not match the tool's output schema: ${W.errorMessage}`)}catch(W){if(W instanceof A)throw W;throw new A(M.InvalidParams,`Failed to validate structured content: ${W instanceof Error?W.message:String(W)}`)}}return B}isToolTask(Z){if(!this._serverCapabilities?.tasks?.requests?.tools?.call)return!1;return this._cachedKnownTaskTools.has(Z)}isToolTaskRequired(Z){return this._cachedRequiredTaskTools.has(Z)}cacheToolMetadata(Z){this._cachedToolOutputValidators.clear(),this._cachedKnownTaskTools.clear(),this._cachedRequiredTaskTools.clear();for(let H of Z){if(H.outputSchema){let B=this._jsonSchemaValidator.getValidator(H.outputSchema);this._cachedToolOutputValidators.set(H.name,B)}let Q=H.execution?.taskSupport;if(Q==="required"||Q==="optional")this._cachedKnownTaskTools.add(H.name);if(Q==="required")this._cachedRequiredTaskTools.add(H.name)}}getToolOutputValidator(Z){return this._cachedToolOutputValidators.get(Z)}async listTools(Z,H){let Q=await this.request({method:"tools/list",params:Z},TZ,H);return this.cacheToolMetadata(Q.tools),Q}_setupListChangedHandler(Z,H,Q,B){let G=yZ.safeParse(Q);if(!G.success)throw Error(`Invalid ${Z} listChanged options: ${G.error.message}`);if(typeof Q.onChanged!=="function")throw Error(`Invalid ${Z} listChanged options: onChanged must be a function`);let{autoRefresh:W,debounceMs:O}=G.data,{onChanged:N}=Q,C=async()=>{if(!W){N(null,null);return}try{let U=await B();N(null,U)}catch(U){let j=U instanceof Error?U:Error(String(U));N(j,null)}},V=()=>{if(O){let U=this._listChangedDebounceTimers.get(Z);if(U)clearTimeout(U);let j=setTimeout(C,O);this._listChangedDebounceTimers.set(Z,j)}else C()};this.setNotificationHandler(H,V)}async sendRootsListChanged(){return this.notification({method:"notifications/roots/list_changed"})}}class l{constructor(){this._messageQueue=[]}static createLinkedPair(){let Z=new l,H=new l;return Z._otherTransport=H,H._otherTransport=Z,[Z,H]}async start(){while(this._messageQueue.length>0){let Z=this._messageQueue.shift();this.onmessage?.(Z.message,Z.extra)}}async close(){let Z=this._otherTransport;this._otherTransport=void 0,await Z?.close(),this.onclose?.()}async send(Z,H){if(!this._otherTransport)throw Error("Not connected");if(this._otherTransport.onmessage)this._otherTransport.onmessage(Z,{authInfo:H?.authInfo});else this._otherTransport._messageQueue.push({message:Z,extra:{authInfo:H?.authInfo}})}}var z0=1,ZZ=1048576,cZ=["list_services","get_service","get_logs","start_service","stop_service","restart_service"],A0="Restart it in the terminal that started it",_0="LocalDeck isn't responding; retrying",pZ=16384,q0=200,nZ=64,m=5000,H0=ZZ-65536,x0=[1000,2000,5000,1e4],M0=/^[a-zA-Z0-9_-]+:[a-zA-Z0-9_-]+$/;class I extends Error{code;constructor(Z,H){super(H);this.code=Z}}var v=P.string().min(1).max(200),iZ=P.string().regex(M0,"Use the exact projectId:service id from services/list"),E={initialize:P.object({protocolVersion:P.number(),quarryVersion:P.string().max(100).optional()}),open:P.object({workspaceId:v,path:P.string().min(1).max(4096).refine((Z)=>p.isAbsolute(Z),"path must be absolute")}),workspace:P.object({workspaceId:v}),action:P.object({workspaceId:v,serviceId:iZ,action:P.enum(["start","stop","restart","share","unshare","open"])}),subscribe:P.object({workspaceId:v,serviceId:iZ,from:P.string().max(200).optional(),limit:P.number().int().min(1).max(m).default(1000)}),unsubscribe:P.object({subscription:P.string().min(1).max(200)}),page:P.object({workspaceId:v,pageId:P.string().min(1).max(100)}),call:P.object({workspaceId:v,name:P.string().min(1).max(100),arguments:P.record(P.string(),P.unknown()).optional()}),profiles:P.object({workspaceId:v,profiles:P.array(P.string().min(1).max(100)).max(50)}),actionAll:P.object({workspaceId:v,action:P.enum(["start","stop"])})};function oZ(Z){return{profiles:Z.profiles,active:Z.active,clashes:Z.clashes,...Z.error?{error:Z.error}:{}}}function S(Z,H){let Q=Z.safeParse(H??{});if(!Q.success)throw new I(-32602,Q.error.issues.map((B)=>`${B.path.join(".")||"params"}: ${B.message}`).join("; "));return Q.data}function d(Z){return Z instanceof TypeError||Z instanceof Error&&(Z.name==="TimeoutError"||Z.name==="AbortError"||/ECONNREFUSED|ECONNRESET|did not start/.test(Z.message))}function T0(Z){if(Buffer.byteLength(Z)<=pZ)return Z;return new TextDecoder().decode(Buffer.from(Z).subarray(0,pZ-3)).replace(/�+$/,"")+"…"}function Q0(Z){return{cursor:Z.id,ts:Z.ts,stream:Z.stream,text:T0(Z.line)}}function aZ(Z,H,Q){let B=0,G=!1;if(H!==void 0){let U=Z.findIndex((j)=>j.id===H);if(U===-1)G=Z.length>0;else B=U+1}let W=Z.slice(B),O=W.slice(-Q).map(Q0),N=0,C=O.length;while(C>0){if(N+=Buffer.byteLength(JSON.stringify(O[C-1]))+1,N>H0)break;C--}let V=O.slice(C);return{lines:V,truncated:G||V.length<W.length}}function I0(Z){for(let H of Z){let Q=H.replace(/^(http:\/\/[a-z0-9-]+(?:\.[a-z0-9-]+)?\.localhost):\d+(?=\/|$)/i,"$1");if(Q!==H)return Q}return}function y0(Z,H,Q,B={}){let G=Q?.status==="running"||Q?.status==="starting",W;if(!Q||Q.status==="stopped")W=Q&&(Q.readinessStatus==="failed"||Q.lastError)?"failed":"stopped";else if(Q.status==="stopping")W="stopping";else if(Q.readinessStatus==="failed")W="failed";else if(Q.status==="starting"||!Q.upstreamReady||Q.readinessStatus==="checking")W="starting";else W="running";let O=Q?.stablePort??B.command?.port,N=!(Q?.serviceType??B.command?.serviceType)||(Q?.serviceType??B.command?.serviceType)==="http",C=N&&O?(B.cleanUrls&&Q?I0(Q.urls):void 0)??`http://localhost:${O}`:void 0,V=Boolean(Q?.share||Q?.shareStartup?.status==="starting"),U=Boolean(G&&Q?.configFingerprint&&B.fingerprint&&Q.configFingerprint!==B.fingerprint),j=[];if(!G&&W!=="stopping")j.push("start");if(G)j.push("stop","restart");if(W==="running"&&N&&B.cloudflared&&!V)j.push("share");if(V)j.push("unshare");if(C)j.push("open");return{id:`${Z}:${H}`,name:H,status:W,...O?{detail:`:${O}`}:{},...C?{url:C}:{},...U?{restartNeeded:U}:{},actions:j}}function E0(Z){return`${Z.filter((H)=>H.status==="running").length} of ${Z.length} services running`}function S0(Z,H=process.env){let Q=(G)=>{try{return c.accessSync(G,c.constants.X_OK),c.statSync(G).isFile()}catch{return!1}};if(Z.includes("/")||Z.includes("\\"))return Q(Z);let B=process.platform==="win32"?["",...(H.PATHEXT??".EXE;.CMD;.BAT").split(";")]:[""];return(H.PATH??"").split(p.delimiter).filter(Boolean).some((G)=>B.some((W)=>Q(p.join(G,Z+W))))}function f0(Z){let H=Z.coalesceMs??150,Q=Z.flushMs??50,B=Z.retryMs??x0,G=Z.warn??(()=>{}),W=new Map,O=new Map,N,C,V=!1,U,j=0,y=!1,f,T;function z(K){if(y)return;let $=JSON.stringify({jsonrpc:"2.0",...K});if(Buffer.byteLength($)>ZZ){if(!("id"in K)){G(`dropped an oversized ${String(K.method)} notification`);return}$=JSON.stringify({jsonrpc:"2.0",id:K.id,error:{code:-32603,message:"Result exceeds 1 MiB"}})}Z.write($+`
2
+ `)}let R=(K,$)=>z({method:K,params:$}),x=(K,$,J)=>z({id:K,error:{code:$,message:J}});function n(K,$){let J={workspaceId:K.id,...$},F=JSON.stringify(J);if(F===K.lastStatus)return;K.lastStatus=F,R("status",J)}function i(){let K=N;N=void 0,C=void 0;try{K?.close()}catch{}}function $Z(K){if(y||!W.size||N&&C===K)return;i();let $=Z.createWebSocket(`ws://127.0.0.1:${K}/api/events`);N=$,C=K,$.on("open",()=>{if(N!==$)return;if(j=0,V){V=!1;for(let J of O.values())V0(J)}}),$.on("message",(J)=>{if(N===$)F0(J)}),$.on("error",(J)=>{if(N===$)G(`event stream error: ${J.message}`)}),$.on("close",()=>{if(N!==$)return;N=void 0,C=void 0,k()})}function k(){if(y)return;V=!0;for(let K of W.values())n(K,{state:"degraded",message:_0});i(),DZ()}function DZ(){if(y||U||!W.size)return;let K=B[Math.min(j++,B.length-1)];U=setTimeout(async()=>{if(U=void 0,y||!W.size||N)return;let $=await Z.discover().catch(()=>{return});if(y||!W.size||N)return;if($)$Z($.apiPort);else DZ()},K)}function F0(K){let $;try{$=JSON.parse(String(K))}catch{return}if($.type==="snapshot")for(let J of W.values())o(J);else if($.type==="service"){for(let J of W.values())if($.service.projectId===J.projectId)o(J)}else if($.type==="service:removed"){for(let J of W.values())if($.name.startsWith(`${J.projectId}:`))o(J)}else if($.type==="log"){for(let J of O.values())if(J.serviceId===$.log.service)a(J,Q0($.log))}else if($.type==="profiles"){for(let J of W.values())if(J.projectId===$.projectId)z({jsonrpc:"2.0",method:"profiles/changed",params:{workspaceId:J.id}})}else if($.type==="history:cleared"&&$.kind==="logs"){for(let J of O.values())if(J.serviceId===$.service)a(J,{cursor:$.beforeId,ts:Date.now(),stream:"system",text:"Logs cleared in LocalDeck"})}}function o(K){if(K.timer||y)return;K.timer=setTimeout(()=>{K.timer=void 0,W0(K)},H)}async function W0(K){if(W.get(K.id)!==K)return;try{let $=await Z.discover();if(!$)return k();let J=await JZ($.api,K.projectId);if(W.get(K.id)!==K)return;BZ(K,J)}catch($){if(d($))k();else G(`could not refresh services: ${$ instanceof Error?$.message:String($)}`)}}function BZ(K,$){let J=JSON.stringify($);if(J!==K.lastItems)K.lastItems=J,R("services/changed",{workspaceId:K.id,items:$});n(K,{state:"ready",summary:E0($)})}async function G0(K,$){try{let J=await K.project($);return{details:J,runtime:J.services}}catch(J){if(d(J))throw J;return{runtime:(await K.services()).filter((F)=>F.projectId===$)}}}async function D0(K){if(!f||Date.now()-f.at>15000)f={ready:await K.forwarder().then(($)=>$.ready===!0,()=>!1),at:Date.now()};return f.ready}function B0(){if(!T||Date.now()-T.at>60000)T={available:Z.cloudflared?Z.cloudflared():S0(process.env.LOCALDECK_CLOUDFLARED??"cloudflared"),at:Date.now()};return T.available}async function JZ(K,$,J){let[{details:F,runtime:Y},X]=await Promise.all([G0(K,$),D0(K)]),_=B0(),L=new Map(Y.map((q)=>[q.name,q]));for(let q of Y)J?.set(q.key,q);let D=F?.commands??[];return[...D.map((q)=>q.name),...Y.map((q)=>q.name).filter((q)=>!D.some((s)=>s.name===q)).sort()].slice(0,q0).map((q)=>y0($,q,L.get(q),{command:D.find((s)=>s.name===q),fingerprint:F?.fingerprints?.[q],cleanUrls:X,cloudflared:_}))}async function KZ(){let K;try{K=await Z.connect()}catch($){throw k(),new I(-32000,`LocalDeck isn't responding: ${$ instanceof Error?$.message:String($)}`)}return $Z(K.apiPort),K}async function g(K){let $=await KZ();try{return await K($)}catch(J){if(J instanceof I)throw J;if(d(J))throw k(),new I(-32000,"LocalDeck isn't responding");throw new I(-32000,J instanceof Error?J.message:String(J))}}function w(K){let $=W.get(K);if(!$)throw new I(-32602,"Unknown workspace; call workspace/open first");return $}function YZ(K,$){if(!$.startsWith(`${K.projectId}:`))throw new I(-32602,"That service belongs to another project")}async function HZ(K){let $=W.get(K);if(!$)return;W.delete(K),clearTimeout($.timer);for(let F of O.values())if(F.workspaceId===K)UZ(F.id);if(!W.size)i(),clearTimeout(U),U=void 0,V=!1,j=0;let J=$.tools;if($.tools=void 0,J)await J.then((F)=>F.close(),()=>{})}async function Y0(K,$){await HZ(K);let J;try{J=c.realpathSync($)}catch{return{active:!1,reason:"The folder couldn't be found"}}let F=rZ.map((D)=>p.join(J,D)).find((D)=>{try{return c.statSync(D).isFile()}catch{return!1}});if(!F)return{active:!1,reason:"No .localdeck file in this folder"};let Y=p.basename(F);try{eZ(F)}catch(D){let h=(D instanceof Error?D.message:String(D)).replace(new RegExp(`^${Y.replace(/\./g,"\\.")}:\\s*`),"");return{active:!1,reason:`${Y} couldn't be read: ${h}`}}let{projectId:X,apiPort:_}=await g(async({api:D,apiPort:h,controlToken:q})=>{return{projectId:(await D.projects()).find((j0)=>j0.directory===J)?.id??(await D.rememberProject(F,q)).id,apiPort:h}}),L={id:K,path:J,projectId:X};return W.set(K,L),$Z(_),o(L),{active:!0}}async function O0(K,$,J){return YZ(K,$),g(async({api:F})=>{let Y=new Map,X=(await JZ(F,K.projectId,Y)).find((D)=>D.id===$);if(!X)throw new I(-32602,"Unknown service; use services/list");let _=Y.get($),L=X.name;try{if(J==="start"||J==="restart"){if(J==="restart"&&_?.managedBy==="terminal"&&_.status!=="stopped")return{ok:!1,message:A0};let D=await F.serviceAction(K.projectId,L,J);return{ok:D.ok,...D.error?{message:D.error}:{}}}if(J==="stop"){if(!_)return{ok:!1,message:"It isn't running"};let D=await F.stop($);return{ok:D.ok,...D.ok?{}:{message:"It isn't running"}}}if(J==="share"){if(!X.actions.includes("share"))return{ok:!1,message:X.actions.includes("unshare")?"It's already shared":X.status!=="running"?"Start it before sharing":"Sharing needs cloudflared"};let D=mZ.randomBytes(12).toString("base64url");return{ok:!0,url:(await F.share($,D,!0,!1)).url,secret:D}}if(J==="unshare"){let D=await F.unshare($);return{ok:D.ok,...D.ok?{}:{message:"It isn't shared"}}}return X.url?{ok:!0,url:X.url}:{ok:!1,message:"It has no address"}}catch(D){if(d(D))throw D;return{ok:!1,message:D instanceof Error?D.message:String(D)}}})}function a(K,$){if(K.pending){if(K.pending.push($),K.pending.length>m)K.pending.shift();return}if(K.queue.push($),K.lastCursor=$.cursor,K.queue.length>m)K.queue.shift(),K.dropped++;K.timer??=setTimeout(()=>U0(K),Q)}function U0(K){if(K.timer=void 0,O.get(K.id)!==K)return;let $=K.queue.splice(0),J=K.dropped;K.dropped=0;let F=[],Y=0,X=(_)=>{if(!F.length&&!(_&&J))return;R("logs/append",{subscription:K.id,lines:F,..._&&J?{dropped:J}:{}}),F=[],Y=0};for(let _ of $){let L=Buffer.byteLength(JSON.stringify(_))+1;if(Y+L>H0)X(!1);F.push(_),Y+=L}X(!0)}async function OZ(K,$){try{return await K.logs($,m)}catch(J){if(!d(J)&&/unknown service|not found/i.test(J instanceof Error?J.message:""))return[];throw J}}async function X0(K){let $=w(K.workspaceId);if(YZ($,K.serviceId),O.size>=nZ)throw new I(-32000,`At most ${nZ} log subscriptions`);let J={id:mZ.randomUUID(),workspaceId:$.id,serviceId:K.serviceId,pending:[],queue:[],dropped:0};O.set(J.id,J);try{let F=await g(({api:D})=>OZ(D,K.serviceId)),{lines:Y,truncated:X}=aZ(F,K.from,K.limit),_=new Set(F.map((D)=>D.id)),L=J.pending.filter((D)=>!_.has(D.cursor));J.pending=void 0,J.lastCursor=F.at(-1)?.id??K.from;for(let D of L)a(J,D);return{subscription:J.id,lines:Y,truncated:X}}catch(F){throw O.delete(J.id),F}}async function V0(K){try{let $=await Z.discover();if(!$||O.get(K.id)!==K)return;let J=await OZ($.api,K.serviceId);if(O.get(K.id)!==K)return;let{lines:F}=aZ(J,K.lastCursor,m);for(let Y of F)a(K,Y)}catch($){G(`could not catch up logs: ${$ instanceof Error?$.message:String($)}`)}}function UZ(K){let $=O.get(K);if(!$)return;clearTimeout($.timer),O.delete(K)}async function XZ(K){return K.tools??=(async()=>{let $=K0({projectId:K.projectId,projectSecrets:Z.projectSecrets,connect:async()=>{let X=await KZ();return{api:X.api,secrets:[X.controlToken]}}}),[J,F]=l.createLinkedPair(),Y=new WZ({name:"quarry",version:GZ});return await $.connect(F),await Y.connect(J),{client:Y,close:async()=>{await Y.close(),await $.close()}}})(),(await K.tools).client}async function N0(K,$){switch(K){case"initialize":return S(E.initialize,$),{protocolVersion:z0,name:"LocalDeck",version:GZ,capabilities:{profiles:!0,bulkActions:!0}};case"workspace/open":{let J=S(E.open,$);return Y0(J.workspaceId,J.path)}case"workspace/close":return await HZ(S(E.workspace,$).workspaceId),{};case"services/list":{let J=w(S(E.workspace,$).workspaceId),F=await g(({api:Y})=>JZ(Y,J.projectId));if(W.get(J.id)===J)BZ(J,F);return{items:F}}case"services/action":{let J=S(E.action,$);return O0(w(J.workspaceId),J.serviceId,J.action)}case"services/actionAll":{let J=S(E.actionAll,$),F=w(J.workspaceId),Y=await g(({api:X})=>X.projectAction(F.projectId,J.action));return{ok:Y.ok,results:Y.results.map((X)=>({serviceId:`${F.projectId}:${X.name}`,ok:X.ok,...X.error?{message:X.error}:{}}))}}case"profiles/list":{let J=w(S(E.workspace,$).workspaceId);return oZ(await g(({api:F})=>F.profiles(J.projectId)))}case"profiles/set":{let J=S(E.profiles,$),F=w(J.workspaceId);return oZ(await g(({api:Y})=>Y.setActiveProfiles(F.projectId,J.profiles)))}case"logs/subscribe":return X0(S(E.subscribe,$));case"logs/unsubscribe":return UZ(S(E.unsubscribe,$).subscription),{};case"pages/open":{let J=S(E.page,$),F=w(J.workspaceId);if(J.pageId!=="dashboard")throw new I(-32602,`Unknown page "${J.pageId}"`);let{apiPort:Y}=await KZ();return{url:`http://127.0.0.1:${Y}/projects/${encodeURIComponent(F.projectId)}`}}case"tools/list":{let J=w(S(E.workspace,$).workspaceId),F=(await(await XZ(J)).listTools()).tools;return{tools:cZ.flatMap((Y)=>F.filter((X)=>X.name===Y))}}case"tools/call":{let J=S(E.call,$),F=w(J.workspaceId);if(!cZ.includes(J.name))throw new I(-32602,`Unknown tool "${J.name}"`);let Y=await XZ(F);try{return await Y.callTool({name:J.name,arguments:J.arguments??{}})}catch(X){return{content:[{type:"text",text:X instanceof Error?X.message:String(X)}],isError:!0}}}case"shutdown":return{};default:throw new I(-32601,`Method not found: ${K}`)}}function P0(K){let $;try{$=JSON.parse(K)}catch{return x(null,-32700,"Parse error")}if(!$||typeof $!=="object"||Array.isArray($))return x(null,-32600,"Invalid request");let{id:J,method:F,params:Y,jsonrpc:X}=$,_=J===void 0||J===null||typeof J==="string"||typeof J==="number";if(F===void 0&&(("result"in $)||("error"in $)))return;if(X!=="2.0"||typeof F!=="string"||!_)return x(_&&J!==void 0?J:null,-32600,"Invalid request");if(J===void 0)return;N0(F,Y).then((L)=>{if(z({id:J,result:L}),F==="shutdown")NZ().finally(()=>Z.onShutdown?.())},(L)=>{if(L instanceof I)x(J,L.code,L.message);else G(L instanceof Error?L.message:String(L)),x(J,-32603,"Internal error")})}let VZ=Buffer.alloc(0),t=!1;function C0(K){if(y)return;let $=Buffer.concat([VZ,typeof K==="string"?Buffer.from(K):K]);for(let J=$.indexOf(10);J!==-1;J=$.indexOf(10)){let F=$.subarray(0,J);if($=$.subarray(J+1),t){t=!1;continue}if(F.length>ZZ){x(null,-32600,"Message exceeds 1 MiB");continue}let Y=F.toString("utf8").trim();if(Y)P0(Y)}if($.length>ZZ){if(!t)x(null,-32600,"Message exceeds 1 MiB");t=!0,$=Buffer.alloc(0)}VZ=Buffer.from($)}async function NZ(){if(y)return;let K=[...W.keys()];for(let $ of K)await HZ($);y=!0,i(),clearTimeout(U);for(let $ of O.values())clearTimeout($.timer);O.clear()}return{receive:C0,close:NZ}}var tZ=`Usage: localdeck quarry
3
+ Speaks the Quarry Extension Protocol (version 1) over stdio so Quarry can show and control this project's services.
4
+ Started by Quarry; stdout is reserved for protocol messages. Connecting starts no services.`;async function e0(Z){if(Z.includes("--help")||Z.includes("-h")){console.log(tZ);return}if(Z.length)throw Error(tZ);console.log=console.info=(...G)=>console.error(...G);let H=(G)=>({api:new J0(G.apiPort,globalThis.fetch,60000),apiPort:G.apiPort,controlToken:G.controlToken}),Q=()=>{},B=f0({connect:async()=>H(await $0()),discover:async()=>{let G=await Z0();return G?H(G):void 0},createWebSocket:(G)=>new sZ(G),write:(G)=>{process.stdout.write(G)},warn:(G)=>{process.stderr.write(`LocalDeck: ${G}
5
+ `)},onShutdown:()=>Q()});await new Promise((G)=>{let W=(O)=>B.receive(O);if(Q=()=>{Q=()=>{},process.stdin.removeListener("data",W),process.removeListener("SIGINT",Q),process.removeListener("SIGTERM",Q),B.close().then(()=>new Promise((O)=>process.stdout.write("",()=>O()))).finally(G)},process.stdin.on("data",W),process.stdin.once("end",()=>Q()),process.once("SIGINT",Q),process.once("SIGTERM",Q),process.stdin.readableEnded)Q()}),process.stdin.pause(),process.stdin.destroy()}export{Q0 as toLogLine,E0 as summary,aZ as selectLines,e0 as runQuarry,y0 as quarryService,S0 as findExecutable,f0 as createQuarryServer,T0 as clipText,A0 as TERMINAL_RESTART,cZ as QUARRY_TOOLS,z0 as PROTOCOL_VERSION,ZZ as MAX_MESSAGE_BYTES,_0 as DEGRADED};
@@ -1 +1 @@
1
- import{P as F,R as H,ta as C,wa as I}from"./index-2da1tyad.js";import{spawn as q}from"node:child_process";import X from"node:fs";import N from"node:path";import{fileURLToPath as w}from"node:url";function A(z,J,G=process.platform){let B=G==="win32"?N.win32:N.posix,Q=B.normalize(z),M=B.dirname(Q),O=(K,Y)=>G==="win32"?K.toLowerCase()===Y.toLowerCase():K===Y;if(B.basename(Q)!=="localdeck"||!O(B.basename(M),"node_modules"))throw Error("--update requires a global npm installation. Source checkouts and linked development builds must be updated manually.");if(O(M,B.normalize(J)))return G==="win32"?B.dirname(M):B.dirname(B.dirname(M));if(G!=="win32"&&B.basename(B.dirname(M))==="lib")return B.dirname(B.dirname(M));throw Error("This is not the active global npm installation. Update it with the package manager and prefix used to install it.")}function D(){let z=[N.resolve(N.dirname(process.execPath),"node_modules/npm/bin/npm-cli.js"),N.resolve(N.dirname(process.execPath),"../lib/node_modules/npm/bin/npm-cli.js")];for(let G of(process.env.PATH??"").split(N.delimiter)){if(!G)continue;z.push(N.join(G,"node_modules/npm/bin/npm-cli.js"));try{let B=X.realpathSync(N.join(G,"npm"));if(N.basename(B)==="npm-cli.js")z.push(B)}catch{}}let J=z.find((G)=>X.existsSync(G));if(!J)throw Error("npm was not found. Install Node.js with npm, then run localdeck --update again.");return[process.execPath,J]}async function $(z,J=!1){return new Promise((G,B)=>{let Q=q(z[0],z.slice(1),{stdio:J?["ignore","pipe","inherit"]:"inherit",shell:!1}),M="";Q.stdout?.on("data",(O)=>{M+=O.toString()}),Q.once("error",B),Q.once("close",(O,K)=>O===0?G(M.trim()):B(Error(`Command failed (${K??`exit ${O}`}).`)))})}function E(z,J,G=process.platform){let B=G==="win32"?N.win32:N.posix;for(let Q of[z,B.dirname(z),G==="win32"?J:B.join(J,"bin")])try{X.accessSync(Q,X.constants.W_OK|X.constants.X_OK)}catch(M){let O=M.code;if(O==="EACCES"||O==="EPERM")return!1;throw M}return!0}async function L(z){let J=z.platform??process.platform,G=z.execute??$,B=[...z.npm,"install","--global","--prefix",z.prefix,"localdeck@latest","--registry=https://registry.npmjs.org/","--ignore-scripts"];if((z.writable??E)(z.packageRoot,z.prefix,J)){await G(B);return}if(J!=="darwin"&&J!=="linux")throw Error("The installation requires administrator access. Install localdeck@latest with npm in an administrator terminal, then restart LocalDeck as your normal user.");if(!(z.interactive??Boolean(process.stdin.isTTY&&process.stdout.isTTY)))throw Error("The installation requires administrator access. Run localdeck --update in an interactive terminal so npm can request permission. Do not run LocalDeck with sudo.");(z.log??console.log)(`Administrator access is required to update ${z.prefix}. Only npm will run with sudo; LocalDeck will continue as your normal user.`),await G(["/usr/bin/sudo","-H","--",...B])}async function S(z){await z.install();let J=await z.validate();return await z.stop(),await z.start(),J}async function T(){H();let z=X.realpathSync(N.resolve(N.dirname(w(import.meta.url)),"..")),J=D(),G=await $([...J,"root","--global"],!0),B=A(z,G),Q=N.join(z,"bin/localdeck.js");console.log(`Updating LocalDeck from npm in ${B}…`),console.log("After installation, the daemon will restart. Managed services and public shares will stop; start them again when ready.");let M="",O=await S({install:async()=>{try{await L({npm:J,packageRoot:z,prefix:B})}catch(K){throw Error(`npm update failed. The daemon was not restarted. ${K instanceof Error?K.message:K}`)}},validate:async()=>{let K=await $([process.execPath,Q,"--version"],!0);if(!/^\d+\.\d+\.\d+(?:[-+][\w.-]+)?$/.test(K))throw Error("The updated CLI could not be verified. The daemon was not restarted.");return M=K,K},stop:async()=>{let K=await C();if(!K)return;await new I(K.apiPort,globalThis.fetch,30000).shutdown();let Y=Date.now()+30000,W=()=>{try{return JSON.parse(X.readFileSync(F,"utf8")).pid===K.pid}catch(Z){if(Z.code==="ENOENT")return!1;throw Z}};while(W()){if(Date.now()>=Y)throw Error("Package updated, but the daemon did not stop within 30 seconds. Restart it manually.");await new Promise((Z)=>setTimeout(Z,150))}},start:async()=>{try{if(await $([process.execPath,Q,"daemon","start"]),(await C())?.version!==M)throw Error("Unexpected daemon version")}catch{throw Error("Package updated, but the daemon could not restart. Run localdeck daemon start to retry.")}}});console.log(`LocalDeck ${O} installed. The daemon has restarted.`)}export{T as updateLocalDeck,E as installationWritable,A as installationPrefix,L as installUpdate,S as applyUpdate};
1
+ import{P as F,R as H,ta as C,wa as I}from"./index-hdw8ggnb.js";import{spawn as q}from"node:child_process";import X from"node:fs";import N from"node:path";import{fileURLToPath as w}from"node:url";function A(z,J,G=process.platform){let B=G==="win32"?N.win32:N.posix,Q=B.normalize(z),M=B.dirname(Q),O=(K,Y)=>G==="win32"?K.toLowerCase()===Y.toLowerCase():K===Y;if(B.basename(Q)!=="localdeck"||!O(B.basename(M),"node_modules"))throw Error("--update requires a global npm installation. Source checkouts and linked development builds must be updated manually.");if(O(M,B.normalize(J)))return G==="win32"?B.dirname(M):B.dirname(B.dirname(M));if(G!=="win32"&&B.basename(B.dirname(M))==="lib")return B.dirname(B.dirname(M));throw Error("This is not the active global npm installation. Update it with the package manager and prefix used to install it.")}function D(){let z=[N.resolve(N.dirname(process.execPath),"node_modules/npm/bin/npm-cli.js"),N.resolve(N.dirname(process.execPath),"../lib/node_modules/npm/bin/npm-cli.js")];for(let G of(process.env.PATH??"").split(N.delimiter)){if(!G)continue;z.push(N.join(G,"node_modules/npm/bin/npm-cli.js"));try{let B=X.realpathSync(N.join(G,"npm"));if(N.basename(B)==="npm-cli.js")z.push(B)}catch{}}let J=z.find((G)=>X.existsSync(G));if(!J)throw Error("npm was not found. Install Node.js with npm, then run localdeck --update again.");return[process.execPath,J]}async function $(z,J=!1){return new Promise((G,B)=>{let Q=q(z[0],z.slice(1),{stdio:J?["ignore","pipe","inherit"]:"inherit",shell:!1}),M="";Q.stdout?.on("data",(O)=>{M+=O.toString()}),Q.once("error",B),Q.once("close",(O,K)=>O===0?G(M.trim()):B(Error(`Command failed (${K??`exit ${O}`}).`)))})}function E(z,J,G=process.platform){let B=G==="win32"?N.win32:N.posix;for(let Q of[z,B.dirname(z),G==="win32"?J:B.join(J,"bin")])try{X.accessSync(Q,X.constants.W_OK|X.constants.X_OK)}catch(M){let O=M.code;if(O==="EACCES"||O==="EPERM")return!1;throw M}return!0}async function L(z){let J=z.platform??process.platform,G=z.execute??$,B=[...z.npm,"install","--global","--prefix",z.prefix,"localdeck@latest","--registry=https://registry.npmjs.org/","--ignore-scripts"];if((z.writable??E)(z.packageRoot,z.prefix,J)){await G(B);return}if(J!=="darwin"&&J!=="linux")throw Error("The installation requires administrator access. Install localdeck@latest with npm in an administrator terminal, then restart LocalDeck as your normal user.");if(!(z.interactive??Boolean(process.stdin.isTTY&&process.stdout.isTTY)))throw Error("The installation requires administrator access. Run localdeck --update in an interactive terminal so npm can request permission. Do not run LocalDeck with sudo.");(z.log??console.log)(`Administrator access is required to update ${z.prefix}. Only npm will run with sudo; LocalDeck will continue as your normal user.`),await G(["/usr/bin/sudo","-H","--",...B])}async function S(z){await z.install();let J=await z.validate();return await z.stop(),await z.start(),J}async function T(){H();let z=X.realpathSync(N.resolve(N.dirname(w(import.meta.url)),"..")),J=D(),G=await $([...J,"root","--global"],!0),B=A(z,G),Q=N.join(z,"bin/localdeck.js");console.log(`Updating LocalDeck from npm in ${B}…`),console.log("After installation, the daemon will restart. Managed services and public shares will stop; start them again when ready.");let M="",O=await S({install:async()=>{try{await L({npm:J,packageRoot:z,prefix:B})}catch(K){throw Error(`npm update failed. The daemon was not restarted. ${K instanceof Error?K.message:K}`)}},validate:async()=>{let K=await $([process.execPath,Q,"--version"],!0);if(!/^\d+\.\d+\.\d+(?:[-+][\w.-]+)?$/.test(K))throw Error("The updated CLI could not be verified. The daemon was not restarted.");return M=K,K},stop:async()=>{let K=await C();if(!K)return;await new I(K.apiPort,globalThis.fetch,30000).shutdown();let Y=Date.now()+30000,W=()=>{try{return JSON.parse(X.readFileSync(F,"utf8")).pid===K.pid}catch(Z){if(Z.code==="ENOENT")return!1;throw Z}};while(W()){if(Date.now()>=Y)throw Error("Package updated, but the daemon did not stop within 30 seconds. Restart it manually.");await new Promise((Z)=>setTimeout(Z,150))}},start:async()=>{try{if(await $([process.execPath,Q,"daemon","start"]),(await C())?.version!==M)throw Error("Unexpected daemon version")}catch{throw Error("Package updated, but the daemon could not restart. Run localdeck daemon start to retry.")}}});console.log(`LocalDeck ${O} installed. The daemon has restarted.`)}export{T as updateLocalDeck,E as installationWritable,A as installationPrefix,L as installUpdate,S as applyUpdate};
@@ -45,7 +45,7 @@ Readiness defaults to a 60-second timeout and a 400ms retry interval. A command
45
45
 
46
46
  For Docker Compose databases, set `upstream` to the host-published database port as shown above. Container listeners are not descendants of the `docker compose` client process, so LocalDeck cannot safely infer their ownership from the local process tree.
47
47
 
48
- Native database presets are `ready: "postgres"` (requires `pg_isready`) and `ready: "redis"` (requires `redis-cli`). The matching `serviceType` selects this check by default. Compose checks use tools inside the named container: `{ "type": "compose", "service": "redis", "engine": "redis" }`. Compose service names and engines are validated; the host still needs Docker. **Listening** means TCP connections are accepted; **ready** means the configured readiness contract passed. Custom HTTP/command checks also run for services with no dependents.
48
+ Native database presets are `ready: "postgres"` (requires `pg_isready`) and `ready: "redis"` (requires `redis-cli`). The matching `serviceType` selects this check by default. Compose checks use tools inside the named container: `{ "type": "compose", "service": "redis", "engine": "redis" }`. Compose service names and engines are validated; the host still needs Docker. **Listening** means TCP connections are accepted; **ready** means the configured readiness contract passed. A command check does not wait for a listener, so a background worker that never opens its port can use one (even `{ "type": "command", "run": "true" }`) to report ready. Custom HTTP/command checks also run for services with no dependents.
49
49
 
50
50
  ### Environment wiring
51
51
 
package/docs/quarry.md CHANGED
@@ -9,7 +9,7 @@
9
9
  Quarry installs the `quarry-extension.json` manifest (shipped at the root of this repository and in the npm package) and runs `localdeck quarry` when a workspace folder contains `.localdeck`. It needs LocalDeck 1.7.0 or newer on `PATH`.
10
10
 
11
11
  - Opening a workspace finds the remembered project for that folder. A project that isn't remembered yet is remembered the way `localdeck commands` does, without starting services.
12
- - Quarry lists the services, starts, stops and restarts them, shows their logs, opens the project's dashboard page (`http://127.0.0.1:7777/projects/<id>`) and offers six MCP tools to agents: `list_services`, `get_service`, `get_logs`, `start_service`, `stop_service` and `restart_service`, restricted to that project as with `localdeck mcp --project <id>`.
12
+ - Quarry lists the services, starts, stops and restarts them (one at a time, or the whole project with Start all and Stop all), switches the project's profiles on this computer, shows their logs, opens the project's dashboard page (`http://127.0.0.1:7777/projects/<id>`) and offers six MCP tools to agents: `list_services`, `get_service`, `get_logs`, `start_service`, `stop_service` and `restart_service`, restricted to that project as with `localdeck mcp --project <id>`.
13
13
  - Shares created from Quarry are always password-protected. The password is returned once.
14
14
  - Services started with `localdeck up` in a terminal must be restarted in that terminal.
15
15
 
@@ -21,11 +21,14 @@ The Quarry Extension Protocol, version 1: newline-delimited JSON-RPC 2.0 over st
21
21
 
22
22
  | Request | Params | Result |
23
23
  | --- | --- | --- |
24
- | `initialize` | `{protocolVersion: 1, quarryVersion}` | `{protocolVersion: 1, name: "LocalDeck", version}` |
24
+ | `initialize` | `{protocolVersion: 1, quarryVersion}` | `{protocolVersion: 1, name: "LocalDeck", version, capabilities: {profiles: true, bulkActions: true}}` |
25
25
  | `workspace/open` | `{workspaceId, path}` | `{active, reason?}` |
26
26
  | `workspace/close` | `{workspaceId}` | `{}` |
27
27
  | `services/list` | `{workspaceId}` | `{items: Service[]}` |
28
28
  | `services/action` | `{workspaceId, serviceId, action}` | `{ok, message?, url?, secret?}` |
29
+ | `services/actionAll` | `{workspaceId, action: "start" \| "stop"}` | `{ok, results: [{serviceId, ok, message?}]}` |
30
+ | `profiles/list` | `{workspaceId}` | `{profiles: [{name, description?, services, active}], active, clashes, error?}` |
31
+ | `profiles/set` | `{workspaceId, profiles: string[]}` (at most 50 names) | Same as `profiles/list` |
29
32
  | `logs/subscribe` | `{workspaceId, serviceId, from?, limit?}` (limit 1–5000, default 1000) | `{subscription, lines, truncated}` |
30
33
  | `logs/unsubscribe` | `{subscription}` | `{}` |
31
34
  | `pages/open` | `{workspaceId, pageId: "dashboard"}` | `{url}` |
@@ -37,6 +40,7 @@ The Quarry Extension Protocol, version 1: newline-delimited JSON-RPC 2.0 over st
37
40
  | --- | --- | --- |
38
41
  | `services/changed` | `{workspaceId, items}` | The full list, at most once per 150 ms, after the project's services change. |
39
42
  | `logs/append` | `{subscription, lines, dropped?}` | New output for a subscribed service. Clearing its logs in LocalDeck sends the system line "Logs cleared in LocalDeck". |
43
+ | `profiles/changed` | `{workspaceId}` | The project's active profiles changed, from Quarry, the dashboard, the CLI or an agent. Call `profiles/list` again. |
40
44
  | `status` | `{workspaceId, state, summary?, message?}` | `ready` with "<n> of <m> services running" after changes; `degraded` while the daemon is unreachable. |
41
45
 
42
46
  A `Service` is `{id, name, status, detail?, url?, restartNeeded?, actions}`:
@@ -47,3 +51,8 @@ A `Service` is `{id, name, status, detail?, url?, restartNeeded?, actions}`:
47
51
  - `actions`: `start` when stopped or failed, `stop` and `restart` while running or starting, `share` when running and `cloudflared` is available, `unshare` when shared, and `open` when there is a URL.
48
52
 
49
53
  A log line is `{cursor, ts, stream, text}`. The cursor is LocalDeck's log ID; pass the last one as `from` to resubscribe without repeats. `truncated` means older lines were left out, because of `limit`, the message size, or a cursor that is no longer retained. Text is limited to 16 KiB per line.
54
+
55
+ Since 1.8.0, `initialize` announces two optional features, and Quarry uses each only when it is announced:
56
+
57
+ - `bulkActions`: `services/actionAll` runs the dashboard's Start all or Stop all. Stopped services start in dependency order and running ones stop in reverse order. Terminal-owned services behave as they do in the dashboard.
58
+ - `profiles`: `profiles/list` and `profiles/set` read and replace the active profiles, as `localdeck profile` does. Switching never starts, stops or restarts services; running services affected by the change report `restartNeeded`. Unknown names are an error and change nothing.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "localdeck",
3
- "version": "1.7.0",
3
+ "version": "1.8.0",
4
4
  "type": "module",
5
5
  "description": "Stable ports, shareable HTTPS links and request logs for your local dev servers",
6
6
  "bin": {