@fps-games/editor-deployment 0.2.3-beta.11 → 0.2.3-beta.13

package/bin/fps-editor-agent.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import{createHash as Se,randomUUID as k}from"node:crypto";import{constants as Re,createReadStream as K}from"node:fs";import{access as Te,readFile as J,realpath as H,stat as M}from"node:fs/promises";import T from"node:path";import{Readable as Ee}from"node:stream";var F="/__fps_editor_agent/v1/asset-source-grants";var Ye=32*1024;var Xe=8*1024*1024,ee=128,te=256*1024;var d=Object.freeze({ok:0,usage:2,discovery:3,unavailable:4,conflict:5,execution:6,running:7,interrupted:130}),W=1024*1024,Q=3e4,ne=T.join(".fps-editor","state","agent-runtime.json"),C=Object.freeze({kind:"fps-editor-agent-deadline"}),q=!1,U=Number.POSITIVE_INFINITY,ce=Q,E=new AbortController;process.once("SIGINT",()=>{q=!0,E.abort(),process.exitCode=d.interrupted,setTimeout(()=>process.exit(d.interrupted),25).unref?.()});Oe().catch(e=>{let t=q?L():we(e);S(t.result??{ok:!1,error:{code:t.code,message:t.message}}),t.log!==!1&&process.stderr.write(`[fps-editor-agent] ${t.message}
-`),process.exitCode=t.exitCode});async function Oe(){let e=He(process.argv.slice(2)),t=e.argv,n=e.projectRoot??process.cwd(),i=e.projectRoot!==void 0;if(ce=e.deadlineMs,U=Date.now()+e.deadlineMs,t.length===0||t.includes("--help")||t[0]==="help"){S({ok:!0,usage:ze()});return}if(t.includes("--version")){let s=JSON.parse(await J(new URL("../package.json",import.meta.url),"utf8"));S({ok:!0,package:s.name,version:s.version,protocolVersion:2});return}let o=t.shift();if(o==="doctor"){let s=await le(n,{validateService:!1,exactProjectRoot:i}),l=await fe(s),r=await(await se(n,{exactProjectRoot:i})).request({kind:"status"});S({ok:!0,descriptorPath:s.descriptorPath,projectRoot:s.projectRoot,checks:l,status:r.status});return}let a=await se(n,{exactProjectRoot:i});if(o==="status"){S(await a.request({kind:"status"}));return}if(o==="commands"){await be(a,t);return}if(o==="command"){await _e(a,t);return}if(o==="transaction"){await Ae(a,t);return}if(o==="apply"){await Ne(a,t);return}if(o==="operation"){await Ce(a,t);return}if(o==="trace"){await De(a,t);return}throw c(`Unknown command: ${String(o)}`)}async function be(e,t){let n=t.shift();if(n==="describe"){let s=j(t,"command id");Ie(t),S(await e.request({kind:"commands.describe",commandId:s}));return}let i=A(t,new Set(["--cursor","--limit"])),o=g(i.options,"--cursor"),a=O(i.options,"--limit",{minimum:1});if(n==="list"){if(i.positionals.length)throw c("commands list does not accept positional arguments.");S(await e.request({kind:"commands.list",...o?{cursor:o}:{},...a?{limit:a}:{}}));return}if(n==="search"){let s=j(i.positionals,"search query");if(i.positionals.length)throw c("commands search accepts one query.");S(await e.request({kind:"commands.search",query:s,...o?{cursor:o}:{},...a?{limit:a}:{}}));return}throw c("commands requires list, search, or describe.")}async function _e(e,t){let n=A(t,new Set(["--stdin","--input-file","--input-json","--expected-revision","--idempotency-key","--request-id","--timeout","--trace-id","--client-id","--source-file"]),new Set(["--stdin"])),i=j(n.positionals,"command id");if(n.positionals.length)throw c("command accepts one command id.");let o=await Ue(n.options),a=await e.request({kind:"commands.describe",commandId:i}),s=a.ok&&a.kind==="command"?a.command:null;if(!s)throw I(d.unavailable,"command.unknown",`Editor command is not registered: ${i}`);if(!s.availability.available)throw I(d.unavailable,"command.unavailable",s.availability.reasons.map(p=>p.message).join("; ")||`Editor command is unavailable: ${i}`);let l=g(n.options,"--source-file"),u=null;if(l){if(i!=="asset.import")throw c("--source-file is only valid for asset.import.");if(!o||typeof o!="object"||Array.isArray(o))throw c("asset.import input must be a JSON object.");if(Object.prototype.hasOwnProperty.call(o,"sourceGrantId"))throw c("Do not combine --source-file with input.sourceGrantId.");let p=await e.uploadAssetSource(T.resolve(l));u=p.sourceGrantId,o={...o,sourceGrantId:p.sourceGrantId}}let r=!1,m=!1,w=null;try{let p=O(n.options,"--expected-revision",{minimum:0}),h=e.serviceInstanceId;if(s.manifest.access==="write"&&p===void 0){let R=await e.request({kind:"status"});p=R.status.documentRevision,h=R.status.serviceInstanceId}let f=g(n.options,"--request-id")??k(),v=g(n.options,"--idempotency-key")??(s.manifest.access==="write"?k():void 0),y=O(n.options,"--timeout",{minimum:0});r=!0;let N=await e.request({kind:"command.invoke",invocation:{commandId:i,input:o,requestId:f,...v?{idempotencyKey:v}:{},...p!==void 0?{expectedRevision:{serviceInstanceId:h,document:p}}:{},principal:{type:"agent",id:"fps-editor-agent"},source:"agent-cli",...g(n.options,"--trace-id")?{traceId:g(n.options,"--trace-id")}:{},...g(n.options,"--client-id")?{clientId:g(n.options,"--client-id")}:{}},...y!==void 0?{timeoutMs:y}:{}});m=!0,S(N),B(N.operation)}catch(p){throw w=p,p}finally{let p=r&&!m&&["cli.deadlineExceeded","cli.interrupted","service.unreachable"].includes(w?.code);u&&!p&&await e.revokeAssetSource(u).catch(()=>{})}}async function Ae(e,t){let n=t.shift();if(n==="begin"){let s=A(t,new Set(["--expected-revision","--label","--transaction-id","--trace-id","--service-instance-id"]));if(s.positionals.length)throw c("transaction begin does not accept positional arguments.");let l=await de(e),u=g(s.options,"--transaction-id")??k(),r=await e.request({kind:"transaction.begin",serviceInstanceId:g(s.options,"--service-instance-id")??l.serviceInstanceId,expectedDocumentRevision:O(s.options,"--expected-revision",{minimum:0})??l.documentRevision,...g(s.options,"--label")?{label:g(s.options,"--label")}:{},transactionId:u,...g(s.options,"--trace-id")?{traceId:g(s.options,"--trace-id")}:{}});S(r),P(r.transaction);return}let i=A(t,new Set(["--service-instance-id","--sequence","--stdin","--input-file","--cursor","--limit"]),new Set(["--stdin"])),o=j(i.positionals,"transaction id");if(i.positionals.length)throw c(`transaction ${String(n)} accepts one transaction id.`);let a=g(i.options,"--service-instance-id")??e.serviceInstanceId;if(n==="append"){z(i.options,new Set(["--service-instance-id","--sequence","--stdin","--input-file"]));let s=O(i.options,"--sequence",{minimum:0});s===void 0&&(s=(await e.request({kind:"transaction.get",transactionId:o,serviceInstanceId:a,limit:1})).transaction.acceptedOperations);let l,u=ue(i.options);await pe({client:e,source:u,transactionId:o,serviceInstanceId:a,sequence:s,maxOperations:e.status.transactions.maxOperationsPerAppend,maxBytes:e.status.transactions.maxBytesPerAppend,onAppend(r){l=r,S(r)}}),P(l?.transaction);return}if(n==="preflight"||n==="commit"||n==="abort"){z(i.options,new Set(["--service-instance-id"]));let s=await e.request({kind:`transaction.${n}`,transactionId:o,serviceInstanceId:a});S(s),P(s.transaction,{abortedIsSuccess:n==="abort"});return}if(n==="get"){z(i.options,new Set(["--service-instance-id","--cursor","--limit"]));let s=await e.request({kind:"transaction.get",transactionId:o,serviceInstanceId:a,...g(i.options,"--cursor")?{cursor:g(i.options,"--cursor")}:{},...O(i.options,"--limit",{minimum:1})?{limit:O(i.options,"--limit",{minimum:1})}:{}});S(s),P(s.transaction);return}throw c("transaction requires begin, append, preflight, commit, get, or abort.")}async function Ne(e,t){let n=A(t,new Set(["--stdin","--input-file","--save","--expected-revision","--label","--transaction-id","--trace-id","--service-instance-id","--timeout"]),new Set(["--stdin","--save"]));if(n.positionals.length)throw c("apply does not accept positional arguments.");let i=await de(e),o=g(n.options,"--service-instance-id")??i.serviceInstanceId,a=O(n.options,"--expected-revision",{minimum:0})??i.documentRevision,s=O(n.options,"--timeout",{minimum:0}),l=g(n.options,"--transaction-id")??k(),u=g(n.options,"--trace-id"),r,m="begin";try{r=(await e.request({kind:"transaction.begin",serviceInstanceId:o,expectedDocumentRevision:a,transactionId:l,...g(n.options,"--label")?{label:g(n.options,"--label")}:{},...u?{traceId:u}:{}})).transaction,$("begin",r),m="append";let p=ue(n.options);if(await pe({client:e,source:p,transactionId:r.transactionId,serviceInstanceId:r.serviceInstanceId,sequence:r.acceptedOperations,maxOperations:i.transactions.maxOperationsPerAppend,maxBytes:i.transactions.maxBytesPerAppend,onAppend(ve){r=ve.transaction,$("append",r)}}),m="commit",r=(await e.request({kind:"transaction.commit",transactionId:r.transactionId,serviceInstanceId:r.serviceInstanceId})).transaction,$("commit",r),r.state!=="working_committed"){b(!1,"commit_failed",r),P(r);return}if(!n.options.has("--save")){b(!0,"working_committed",r);return}m="document.export";let f=await ie(e,{commandId:"document.export",input:{},expectedDocumentRevision:r.workingDocumentRevision,serviceInstanceId:r.serviceInstanceId,transactionId:r.transactionId,traceId:u,timeoutMs:s});if(oe("document.export",r,f.operation),f.operation?.status==="accepted"||f.operation?.status==="running"){b(!1,"awaiting_export_operation",r,{operation:_(f.operation),allowedActions:["operation.get","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),process.exitCode=d.running;return}if(f.operation?.status!=="completed"){b(!1,"save_failed",r,{operation:_(f.operation),allowedActions:["command document.export","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),B(f.operation);return}let v=f.operation.output;if(!v||typeof v!="object"||Array.isArray(v))throw I(d.execution,"document.exportReceiptInvalid","document.export returned an invalid receipt.");if(v.persistedByEditor===!1){b(!1,"awaiting_persistence_confirmation",r,{operation:_(f.operation),allowedActions:["operation.get","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),process.exitCode=d.running;return}let y=typeof v.transactionId=="string"&&v.transactionId.trim()?v.transactionId:null;if(!y)throw I(d.execution,"document.exportReceiptInvalid","document.export receipt is missing transactionId.");m="document.commit";let N=Number.isSafeInteger(v.documentRevision)?v.documentRevision:r.workingDocumentRevision,R=await ie(e,{commandId:"document.commit",input:{transactionId:y},expectedDocumentRevision:N,serviceInstanceId:r.serviceInstanceId,transactionId:r.transactionId,traceId:u,timeoutMs:s});if(oe("document.commit",r,R.operation),R.operation?.status==="accepted"||R.operation?.status==="running"){b(!1,"awaiting_commit_operation",r,{saveTransactionId:y,operation:_(R.operation),allowedActions:["operation.get","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),process.exitCode=d.running;return}if(R.operation?.status!=="completed"){b(!1,"save_commit_failed",r,{saveTransactionId:y,operation:_(R.operation),allowedActions:["command document.commit","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),B(R.operation);return}b(!0,"saved",r,{saveTransactionId:y,operation:_(R.operation),receipt:ke(R.operation.output)})}catch(w){let p=we(w);if(p.result?.kind==="cli.deadline"){S({...p.result,kind:"apply.result",phase:m,...r?{transaction:x(r)}:{}}),process.exitCode=p.exitCode;return}let h;if(r&&(r.state==="open"||r.state==="preflighted"))try{r=(await e.request({kind:"transaction.abort",transactionId:r.transactionId,serviceInstanceId:r.serviceInstanceId})).transaction,h=x(r),$("abort",r)}catch{}S({ok:!1,kind:"apply.result",state:r?.state==="working_committed"?"save_failed":"failed",phase:m,...r?{transaction:x(r)}:{},...h?{aborted:h}:{},error:{code:p.code,message:p.message},allowedActions:r?.state==="working_committed"?["command document.export","transaction.get"]:["status"],retry:{retryable:r?.state==="working_committed",requiresRebase:/revision|serviceInstance/i.test(p.code)}}),process.exitCode=p.exitCode}}async function de(e){let t=await e.request({kind:"status"});if(t.kind!=="status"||!t.status)throw I(d.discovery,"protocol.statusInvalid","Editor Service returned an invalid status response.");return t.status}function ue(e){if(["--stdin","--input-file"].filter(i=>e.has(i)).length>1)throw c("Use only one of --stdin or --input-file.");let n=g(e,"--input-file");return!n||n==="-"?process.stdin:K(T.resolve(n),{encoding:"utf8"})}async function pe(e){let t=re(e.maxOperations,ee),n=re(e.maxBytes,te),i=[],o=2,a=e.sequence,s=0,l=0,u=async()=>{if(i.length===0)return;let r=i.length,m=await e.client.request({kind:"transaction.append",transactionId:e.transactionId,serviceInstanceId:e.serviceInstanceId,sequence:a,operations:i});if(m.kind!=="transaction"||m.transaction.acceptedOperations<a+r)throw I(d.execution,"transaction.appendReceiptInvalid","Editor Service returned an invalid append receipt.");a=m.transaction.acceptedOperations,s+=r,e.onAppend(m),i=[],o=2};for await(let r of Fe(e.source,E.signal,n)){l+=1;let m=r.endsWith("\r")?r.slice(0,-1):r;if(!m.trim())continue;let w;try{w=JSON.parse(m)}catch(v){throw c(`NDJSON line ${l} is not valid JSON: ${v instanceof Error?v.message:String(v)}`)}xe(w,l);let p=JSON.stringify(w),h=Buffer.byteLength(p);if(h+2>n)throw c(`NDJSON line ${l} exceeds the ${n}-byte transaction append limit.`);let f=o+h+(i.length?1:0);i.length&&(i.length>=t||f>n)&&await u(),i.push(w),o+=h+(i.length>1?1:0),(i.length>=t||o>=n)&&await u()}if(await u(),s===0)throw c("Transaction input must contain at least one NDJSON operation.");return{acceptedOperations:s,nextSequence:a}}function xe(e,t){if(!e||typeof e!="object"||Array.isArray(e))throw c(`NDJSON line ${t} must be a transaction operation object.`);if(typeof e.opId!="string"||!e.opId.trim())throw c(`NDJSON line ${t} requires a non-empty opId.`);if(typeof e.commandId!="string"||!e.commandId.trim())throw c(`NDJSON line ${t} requires a non-empty commandId.`);if(e.as!==void 0&&(typeof e.as!="string"||!e.as.trim()))throw c(`NDJSON line ${t} as must be a non-empty string.`)}async function ie(e,t){let n=await e.request({kind:"commands.describe",commandId:t.commandId}),i=n.kind==="command"?n.command:null;if(!i)throw I(d.unavailable,"command.unknown",`Editor command is not registered: ${t.commandId}`);if(!i.availability.available)throw I(d.unavailable,"command.unavailable",i.availability.reasons.map(s=>s.message).join("; ")||`Editor command is unavailable: ${t.commandId}`);let o=await e.request({kind:"command.invoke",invocation:{commandId:t.commandId,input:t.input,requestId:k(),idempotencyKey:k(),expectedRevision:{serviceInstanceId:t.serviceInstanceId,...t.expectedDocumentRevision===void 0?{}:{document:t.expectedDocumentRevision}},principal:{type:"agent",id:"fps-editor-agent"},source:"agent-cli",transactionId:t.transactionId,...t.traceId?{traceId:t.traceId}:{}},...t.timeoutMs===void 0?{}:{timeoutMs:t.timeoutMs}}),a=o.operation;return a&&!ge(a.status)&&(a=(await e.request({kind:"operation.get",operationId:a.operationId})).operation??a),{response:o,operation:a}}function $(e,t){S({ok:t.state!=="failed",kind:"apply.event",phase:e,state:t.state,transaction:x(t)})}function oe(e,t,n){S({ok:n?.status!=="failed"&&n?.status!=="cancelled",kind:"apply.event",phase:e,state:n?.status??"unavailable",transaction:x(t),operation:_(n)})}function b(e,t,n,i={}){S({ok:e,kind:"apply.result",state:t,phase:t==="saved"?"complete":n.phase,transaction:x(n),...i.allowedActions?{}:{allowedActions:n.allowedActions},...i.retry?{}:{retry:n.retry},...i})}function x(e){return{transactionId:e.transactionId,serviceInstanceId:e.serviceInstanceId,state:e.state,phase:e.phase,baseDocumentRevision:e.baseDocumentRevision,...e.workingDocumentRevision===void 0?{}:{workingDocumentRevision:e.workingDocumentRevision},dirty:e.dirty,acceptedOperations:e.acceptedOperations,acceptedBytes:e.acceptedBytes,processedOperations:e.processedOperations,allowedActions:e.allowedActions,retry:e.retry,diagnostics:e.diagnostics,results:{offset:e.results.offset,returned:e.results.returned,total:e.results.total,...e.results.nextCursor?{nextCursor:e.results.nextCursor}:{}}}}function _(e){return e?{operationId:e.operationId,requestId:e.requestId,commandId:e.commandId,status:e.status,...e.transactionId?{transactionId:e.transactionId}:{},...e.traceId?{traceId:e.traceId}:{},...e.output===void 0?{}:{output:e.output},...e.diagnostics?{diagnostics:e.diagnostics}:{}}:null}function ke(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:{}}function re(e,t){return Number.isSafeInteger(e)&&e>0?e:t}async function Ce(e,t){let n=t.shift();if(n==="get"){let i=A(t,new Set(["--request-id","--service-instance-id"])),o=i.positionals.shift();if(i.positionals.length)throw c("operation get accepts at most one operation id.");let a=g(i.options,"--request-id");if(!o&&!a||o&&a)throw c("operation get requires exactly one operation id or --request-id.");let s=g(i.options,"--service-instance-id");if(s&&s!==e.serviceInstanceId)throw I(d.conflict,"operation.serviceInstanceChanged",`Expected Editor Service ${s}, received ${e.serviceInstanceId}.`);let l=await e.request(o?{kind:"operation.get",operationId:o}:{kind:"operation.get",requestId:a});S(l),l.operation?B(l.operation):process.exitCode=d.unavailable;return}if(n==="cancel"){let i=j(t,"operation id");Ie(t);let o=await e.request({kind:"operation.cancel",operationId:i});S(o),o.operation?!o.cancelled&&!ge(o.operation.status)&&(process.exitCode=d.running):process.exitCode=d.unavailable;return}throw c("operation requires get or cancel.")}async function De(e,t){if(t.shift()!=="get")throw c("trace requires get.");let i=A(t,new Set(["--cursor","--limit"])),o=i.positionals.shift();if(i.positionals.length)throw c("trace get accepts at most one trace id.");S(await e.request({kind:"trace.get",...o?{traceId:o}:{},...g(i.options,"--cursor")?{cursor:g(i.options,"--cursor")}:{},...O(i.options,"--limit",{minimum:1})?{limit:O(i.options,"--limit",{minimum:1})}:{}}))}async function se(e,t={}){let n=await le(e,{validateService:!0,...t}),i=me(process.env.FPS_EDITOR_AGENT_ENDPOINT?.trim()||n.descriptor.endpoint),o=process.env.FPS_EDITOR_AGENT_TOKEN?.trim()||n.descriptor.token,a=async r=>{if(q)throw I(d.interrupted,"cli.interrupted","Interrupted.");let m=U-Date.now();if(m<=0)throw D(n,r);let w=new AbortController,p=()=>w.abort(E.signal.reason);E.signal.addEventListener("abort",p,{once:!0});let h=setTimeout(()=>w.abort(C),m);h.unref?.();try{let f=await fetch(i,{method:"POST",headers:{authorization:`Bearer ${o}`,"content-type":"application/json"},body:JSON.stringify(r),signal:w.signal}),v=await X(f),y;try{y=JSON.parse(v)}catch{throw I(d.discovery,"protocol.invalidJson","Editor Service returned invalid JSON.")}if(f.status===401||f.status===403)throw I(d.discovery,"auth.invalidToken",he(y)||"Editor Service authentication failed.");if(!y?.ok)throw Y(y);return y}catch(f){throw q||E.signal.aborted?L():w.signal.reason===C?D(n,r):f&&Number.isInteger(f.exitCode)?f:I(d.discovery,"service.unreachable",`Editor Service is unreachable: ${f instanceof Error?f.message:String(f)}`)}finally{clearTimeout(h),E.signal.removeEventListener("abort",p)}},s=await a({kind:"status"});Me(n,s);let l=async r=>{let m=await Pe(r),w=new URL(F,i),p=new AbortController,h=U-Date.now();if(h<=0)throw D(n,{kind:"asset.sourceGrant"});let f=()=>p.abort(E.signal.reason);E.signal.addEventListener("abort",f,{once:!0});let v=setTimeout(()=>p.abort(C),h);v.unref?.();try{let y=await fetch(w,{method:"POST",headers:{authorization:`Bearer ${o}`,"content-type":"application/vnd.fps-editor.asset-source-bundle-v1"},body:Ee.from(je(m)),duplex:"half",signal:p.signal}),N=await X(y),R;try{R=JSON.parse(N)}catch{throw I(d.discovery,"protocol.invalidJson","Editor Service returned invalid JSON for asset source upload.")}if(!y.ok||!R?.ok||R.kind!=="asset.sourceGrant"||!R.grant?.sourceGrantId)throw Y(R);return R.grant}catch(y){throw q||E.signal.aborted?L():p.signal.reason===C?D(n,{kind:"asset.sourceGrant"}):y&&Number.isInteger(y.exitCode)?y:I(d.discovery,"asset.sourceUploadFailed",`Asset source upload failed: ${y instanceof Error?y.message:String(y)}`)}finally{clearTimeout(v),E.signal.removeEventListener("abort",f)}},u=async r=>{let m=U-Date.now();if(m<=0)throw D(n,{kind:"asset.sourceGrant.revoke"});let w=new AbortController,p=setTimeout(()=>w.abort(C),m);p.unref?.();try{let h=new URL(F,i);h.searchParams.set("sourceGrantId",r);let f=await fetch(h,{method:"DELETE",headers:{authorization:`Bearer ${o}`},signal:w.signal}),v=await X(f),y;try{y=JSON.parse(v)}catch{throw I(d.discovery,"protocol.invalidJson","Editor Service returned invalid JSON for asset source revocation.")}if(!f.ok||!y?.ok)throw Y(y);return y}finally{clearTimeout(p)}};return Object.freeze({discovery:n,serviceInstanceId:n.descriptor.serviceInstanceId,status:s.status,request:a,uploadAssetSource:l,revokeAssetSource:u})}async function Pe(e){let t;try{t=await H(e)}catch(u){throw I(d.usage,"asset.sourceNotFound",`Asset source is unavailable: ${u instanceof Error?u.message:String(u)}`)}let n=await M(t);if(!n.isFile())throw c("Asset source must be a regular file.");let i=T.extname(t).toLowerCase();if(![".glb",".gltf",".png",".jpg",".jpeg",".env"].includes(i))throw c("Asset source must be GLB, glTF, PNG, JPG, JPEG, or Babylon ENV.");let o=T.dirname(t),a=new Map([[T.basename(t),t]]);if(i===".gltf"){if(n.size>16*1024*1024)throw c("glTF JSON source exceeds the 16 MiB manifest limit.");let u;try{u=JSON.parse(await J(t,"utf8"))}catch(m){throw c(`glTF source is not valid JSON: ${m instanceof Error?m.message:String(m)}`)}let r=[...Array.isArray(u?.buffers)?u.buffers:[],...Array.isArray(u?.images)?u.images:[]];for(let m of r){let w=typeof m?.uri=="string"?m.uri:null;if(!w||w.startsWith("data:"))continue;if(/^[a-z][a-z0-9+.-]*:/i.test(w)||w.startsWith("//"))throw c("glTF dependencies must use local relative URIs.");let p;try{p=decodeURIComponent(w.split(/[?#]/,1)[0])}catch{throw c(`glTF dependency URI is malformed: ${w}`)}let h=T.posix.normalize(p.replaceAll("\\","/"));if(!h||h==="."||h===".."||h.startsWith("../")||T.posix.isAbsolute(h))throw c(`glTF dependency escapes the source directory: ${w}`);let f;try{f=await H(T.resolve(o,...h.split("/")))}catch{throw c(`glTF dependency is missing: ${h}`)}if(Le(o,f,h),!(await M(f)).isFile())throw c(`glTF dependency is not a regular file: ${h}`);a.set(h,f)}}let s=[];for(let[u,r]of a){let m=await M(r);if(m.size<1||m.size>256*1024*1024)throw c(`Asset source file size is outside the supported range: ${u}`);s.push({path:u,filePath:r,byteSize:m.size,contentHash:await qe(r)})}let l=s.reduce((u,r)=>u+r.byteSize,0);if(s.length>128||l>512*1024*1024)throw c("Asset source bundle exceeds the supported file-count or total-size limit.");return{primaryPath:T.basename(t),files:s}}async function qe(e){let t=Se("sha256");for await(let n of K(e))t.update(n);return`sha256:${t.digest("hex")}`}async function*je(e){let t=Buffer.from(JSON.stringify({schemaVersion:1,primaryPath:e.primaryPath,files:e.files.map(({path:i,byteSize:o,contentHash:a})=>({path:i,byteSize:o,contentHash:a}))}),"utf8"),n=Buffer.allocUnsafe(4);n.writeUInt32BE(t.length,0),yield n,yield t;for(let i of e.files)for await(let o of K(i.filePath))yield o}function Le(e,t,n){let i=T.relative(e,t);if(!i||i===".."||i.startsWith(`..${T.sep}`)||T.isAbsolute(i))throw c(`glTF dependency escapes the source directory: ${n}`)}async function le(e,t={}){let n;try{n=await H(T.resolve(e))}catch(i){throw I(d.discovery,"projectRoot.invalid",`Project root is unavailable: ${i instanceof Error?i.message:String(i)}`)}for(;;){let i=T.join(n,ne);if(await Ge(i)){let a=await $e(i),s=await H(n);if(a.canonicalProjectRoot!==s)throw I(d.discovery,"descriptor.projectMismatch",`Runtime descriptor does not own ${s}.`);let l={descriptorPath:i,projectRoot:s,descriptor:a};return t.validateService!==!1&&await fe(l),l}if(t.exactProjectRoot===!0)break;let o=T.dirname(n);if(o===n)break;n=o}throw I(d.discovery,"descriptor.notFound",`No ${ne} was found from ${e}.`)}async function $e(e){let t;try{t=JSON.parse(await J(e,"utf8"))}catch(n){throw I(d.discovery,"descriptor.invalid",`Runtime descriptor is unreadable: ${n instanceof Error?n.message:String(n)}`)}if(t?.schemaVersion!==1||t?.protocolVersion!==2||t?.packageName!=="@fps-games/editor"||typeof t?.serviceInstanceId!="string"||typeof t?.canonicalProjectRoot!="string"||typeof t?.endpoint!="string"||typeof t?.token!="string"||!Number.isSafeInteger(t?.pid))throw I(d.discovery,"descriptor.incompatible","Runtime descriptor schema or protocol is incompatible.");if(me(t.endpoint),process.platform!=="win32"){let n=(await M(e)).mode&511;if(n&63)throw I(d.discovery,"descriptor.permissions",`Runtime descriptor permissions must be 0600; received ${n.toString(8)}.`)}return t}function me(e){let t;try{t=new URL(e)}catch{throw I(d.discovery,"descriptor.endpoint","Runtime descriptor endpoint is invalid.")}if(t.protocol!=="http:"||!["127.0.0.1","localhost","[::1]"].includes(t.hostname))throw I(d.discovery,"descriptor.endpoint","Runtime descriptor endpoint must be project-local loopback HTTP.");return t.toString()}async function fe(e){let t=[];t.push({id:"descriptor.schema",ok:e.descriptor.schemaVersion===1}),t.push({id:"descriptor.protocol",ok:e.descriptor.protocolVersion===2}),t.push({id:"descriptor.project",ok:e.descriptor.canonicalProjectRoot===e.projectRoot});let n=Be(e.descriptor.pid);if(t.push({id:"descriptor.process",ok:n,pid:e.descriptor.pid}),!n)throw I(d.discovery,"descriptor.stale",`Editor Service process is not alive: ${e.descriptor.pid}.`);return t}function Me(e,t){let n=t?.kind==="status"?t.status:null;if(!n||n.protocolVersion!==2)throw I(d.discovery,"protocol.incompatible","Editor Service status protocol is incompatible.");if(n.serviceInstanceId!==e.descriptor.serviceInstanceId||n.canonicalProjectRoot!==e.projectRoot||n.packageVersion!==e.descriptor.packageVersion||n.buildKey!==e.descriptor.buildKey)throw I(d.discovery,"service.identityMismatch","Editor Service identity does not match the project runtime descriptor.")}async function Ue(e){if(["--stdin","--input-file","--input-json"].filter(o=>e.has(o)).length>1)throw c("Use only one of --stdin, --input-file, or --input-json.");if(e.has("--stdin"))return V(await Je(process.stdin,E.signal),"--stdin");let n=g(e,"--input-file");if(n)return V(await J(T.resolve(n),"utf8"),"--input-file");let i=g(e,"--input-json");return i===void 0?{}:V(i,"--input-json")}function V(e,t){try{return JSON.parse(e)}catch(n){throw c(`${t} is not valid JSON: ${n instanceof Error?n.message:String(n)}`)}}function A(e,t,n=new Set){let i=new Map,o=[];for(;e.length;){let a=e.shift();if(!a.startsWith("--")){o.push(a);continue}let[s,l]=a.split("=",2);if(!t.has(s))throw c(`Unknown option: ${s}`);if(i.has(s))throw c(`Option may only be provided once: ${s}`);if(n.has(s)){if(l!==void 0)throw c(`${s} does not accept a value.`);i.set(s,!0);continue}let u=l??e.shift();if(u===void 0||u.startsWith("--"))throw c(`${s} requires a value.`);i.set(s,u)}return{options:i,positionals:o}}function g(e,t){let n=e.get(t);if(n!==void 0){if(typeof n!="string"||!n.trim())throw c(`${t} requires a non-empty value.`);return n.trim()}}function He(e){let t=[],n=Q,i=!1,o;for(let a=0;a<e.length;a+=1){let s=e[a];if(s==="--project-root"||s.startsWith("--project-root=")){if(o!==void 0)throw c("--project-root may only be provided once.");let r=s==="--project-root"?e[++a]:s.slice(15);if(r===void 0||!r.trim()||r.startsWith("--"))throw c("--project-root requires a non-empty path.");o=T.resolve(process.cwd(),r);continue}if(s!=="--deadline"&&!s.startsWith("--deadline=")){t.push(s);continue}if(i)throw c("--deadline may only be provided once.");i=!0;let l=s==="--deadline"?e[++a]:s.slice(11);if(l===void 0||l.startsWith("--"))throw c("--deadline requires a value.");let u=Number(l);if(!Number.isSafeInteger(u)||u<1)throw c("--deadline must be an integer >= 1.");n=u}return{argv:t,deadlineMs:n,projectRoot:o}}function O(e,t,{minimum:n}){let i=g(e,t);if(i===void 0)return;let o=Number(i);if(!Number.isSafeInteger(o)||o<n)throw c(`${t} must be an integer >= ${n}.`);return o}function j(e,t){let n=e.shift();if(!n)throw c(`Missing ${t}.`);return n}function Ie(e){if(e.length)throw c(`Unexpected argument: ${e[0]}`)}function z(e,t){for(let n of e.keys())if(!t.has(n))throw c(`Option is not valid for this action: ${n}`)}function B(e){if(!e){process.exitCode=d.unavailable;return}if(e.status==="accepted"||e.status==="running"){process.exitCode=d.running;return}(e.status==="failed"||e.status==="cancelled")&&(process.exitCode=Z(e.diagnostics))}function P(e,t={}){if(!e){process.exitCode=d.unavailable;return}if(e.state==="preflighting"||e.state==="committing"){process.exitCode=d.running;return}if(e.state==="failed"){process.exitCode=Z(e.diagnostics);return}e.state==="aborted"&&t.abortedIsSuccess!==!0&&(process.exitCode=d.execution)}function Z(e=[]){let t=e.map(n=>n?.code??"");return t.some(n=>/revision|idempotency|conflict|serviceInstance/i.test(n))?d.conflict:t.some(n=>/unknown|unavailable|notFound|sessionUnavailable/i.test(n))?d.unavailable:d.execution}function Y(e){let t=Array.isArray(e?.diagnostics)?e.diagnostics:[];return I(Z(t),t[0]?.code??"service.requestFailed",he(e)||"Editor Service request failed.")}function he(e){return Array.isArray(e?.diagnostics)?e.diagnostics.map(t=>t?.message).filter(Boolean).join("; "):""}function Be(e){try{return process.kill(e,0),!0}catch(t){return t?.code==="EPERM"}}function ge(e){return e==="completed"||e==="failed"||e==="cancelled"}async function X(e){let t=Number(e.headers.get("content-length"));if(Number.isFinite(t)&&t>W)throw I(d.execution,"response.tooLarge","Editor Service response exceeds 1 MiB.");let n=await e.text();if(Buffer.byteLength(n)>W)throw I(d.execution,"response.tooLarge","Editor Service response exceeds 1 MiB.");return n}async function Ge(e){try{return await Te(e,Re.R_OK),!0}catch{return!1}}async function Je(e,t){let n=[];for await(let i of ye(e,t))n.push(Buffer.isBuffer(i)?i:Buffer.from(i));return Buffer.concat(n).toString("utf8")}async function*Fe(e,t,n=Number.POSITIVE_INFINITY){let i="";for await(let o of ye(e,t)){i+=o.toString();let a;for(;(a=i.indexOf(`
-`))>=0;){let s=i.slice(0,a);if(Buffer.byteLength(s)>n)throw c(`NDJSON line exceeds the ${n}-byte transaction append limit.`);yield s,i=i.slice(a+1)}if(Buffer.byteLength(i)>n)throw c(`NDJSON line exceeds the ${n}-byte transaction append limit.`)}i&&(yield i)}async function*ye(e,t){let n=e[Symbol.asyncIterator]();for(;;){let i=await Ve(n,t);if(i.done)return;yield i.value}}function Ve(e,t){return t.aborted?Promise.reject(L()):new Promise((n,i)=>{let o=()=>i(L());t.addEventListener("abort",o,{once:!0}),e.next().then(n,i).finally(()=>t.removeEventListener("abort",o))})}function S(e){let t=JSON.stringify(e);if(Buffer.byteLength(t)>W)throw I(d.execution,"output.tooLarge","CLI output exceeds 1 MiB.");process.stdout.write(`${t}
-`)}function ze(){return{globalOptions:{deadline:`End-to-end CLI deadline in milliseconds (default ${Q}).`,projectRoot:"Exact target project root. Required for deployment-owned usage from outside the project."},commands:["status","commands list [--cursor CURSOR] [--limit N]","commands search QUERY [--cursor CURSOR] [--limit N]","commands describe COMMAND_ID","command COMMAND_ID [--stdin|--input-file FILE|--input-json JSON] [--source-file FILE for asset.import] [--expected-revision N] [--idempotency-key KEY] [--request-id ID] [--trace-id ID] [--client-id ID] [--timeout MS]","apply [--stdin|--input-file FILE] [--save] [--expected-revision N] [--transaction-id ID] [--label TEXT] [--trace-id ID] [--timeout MS]","transaction begin [--expected-revision N] [--transaction-id ID] [--label TEXT] [--trace-id ID]","transaction append TRANSACTION_ID [--stdin|--input-file FILE] [--sequence N] [--service-instance-id ID]","transaction preflight TRANSACTION_ID [--service-instance-id ID]","transaction commit TRANSACTION_ID [--service-instance-id ID]","transaction get TRANSACTION_ID [--service-instance-id ID] [--cursor CURSOR] [--limit N]","transaction abort TRANSACTION_ID [--service-instance-id ID]","operation get OPERATION_ID [--service-instance-id ID]","operation get --request-id REQUEST_ID [--service-instance-id ID]","operation cancel OPERATION_ID","trace get [TRACE_ID] [--cursor CURSOR] [--limit N]","doctor"],exitCodes:d}}function c(e){return I(d.usage,"cli.usage",e)}function I(e,t,n,i=!0,o){return Object.assign(new Error(n),{exitCode:e,code:t,log:i,...o?{result:o}:{}})}function D(e,t){let n=t?.kind==="command.invoke"?t.invocation:null,i=t?.kind?.startsWith("transaction.")?t.transactionId:n?.transactionId,o=!!n||typeof t?.kind=="string"&&/^transaction\.(begin|append|preflight|commit|abort)$/.test(t.kind),a=n?.requestId,s=a?`operation get --request-id ${a} --service-instance-id ${e.descriptor.serviceInstanceId}`:null,l=i?`transaction get ${i} --service-instance-id ${e.descriptor.serviceInstanceId}`:null,u=[s,l].filter(Boolean);u.length||u.push("status");let r=`Agent CLI exceeded its ${ce}ms end-to-end deadline.`;return I(d.running,"cli.deadlineExceeded",r,!0,{ok:!1,kind:"cli.deadline",state:o?"outcome_unknown":"timed_out",serviceInstanceId:e.descriptor.serviceInstanceId,...n?.commandId?{commandId:n.commandId}:{},...a?{requestId:a}:{},...i?{transactionId:i}:{},error:{code:"cli.deadlineExceeded",message:r},allowedActions:u,retry:{retryable:!o,requiresOperationQuery:o}})}function L(){return I(d.interrupted,"cli.interrupted","Interrupted.")}function we(e){return e&&Number.isInteger(e.exitCode)&&typeof e.code=="string"?e:I(d.execution,"cli.failure",e instanceof Error?e.message:String(e))}
+import{createHash as Oe,randomUUID as H}from"node:crypto";import{constants as _e,createReadStream as Q}from"node:fs";import{access as Ae,readFile as F,realpath as B,stat as U}from"node:fs/promises";import S from"node:path";import{Readable as be}from"node:stream";var V="/__fps_editor_agent/v1/asset-source-grants";var Ze=32*1024;var et=8*1024*1024,ne=128,oe=256*1024;function ie(e){let{transport:t,createRequestId:n,createIdempotencyKey:o,createUnavailableError:i}=e,c=a=>t.describeCommand(a),s=async a=>{let d=await c(a),u=d?.ok===!1&&Array.isArray(d.diagnostics)?d.diagnostics[0]:null;if(u&&typeof u.code=="string")throw i(u.code,typeof u.message=="string"&&u.message?u.message:`Editor command admission failed: ${a}`);let r=d?.ok&&d.kind==="command"?d.command:null;if(!r)throw i("command.unknown",`Editor command is not registered: ${a}`);if(!r.availability.available)throw i("command.unavailable",r.availability.reasons.map(f=>f.message).join("; ")||`Editor command is unavailable: ${a}`);return Object.freeze({commandId:a,access:r.manifest.access})};return Object.freeze({describeCommand:c,listCommands:a=>t.listCommands(a),searchCommands:a=>t.searchCommands(a),prepareCommand:s,async invokeCommand(a){let d=a.preparedCommand??await s(a.commandId),u=a.requestId??n(),r=a.idempotencyKey??(d.access==="write"?o():void 0);return t.invokeCommand({commandId:d.commandId,access:d.access,input:a.input,requestId:u,...r?{idempotencyKey:r}:{},...a.expectedDocumentRevision===void 0?{}:{expectedDocumentRevision:a.expectedDocumentRevision},...a.timeoutMs===void 0?{}:{timeoutMs:a.timeoutMs},...a.traceId?{traceId:a.traceId}:{},...a.clientId?{clientId:a.clientId}:{},...a.transactionId?{transactionId:a.transactionId}:{},...a.settlement?{settlement:a.settlement}:{}})}})}function re(e){return Object.freeze({describeCommand(t){return e.request({kind:"commands.describe",commandId:t})},listCommands(t={}){return e.request({kind:"commands.list",...t})},searchCommands(t){return e.request({kind:"commands.search",...t})},async invokeCommand(t){let n=t.expectedDocumentRevision,o=e.serviceInstanceId;if(t.access==="write"&&n===void 0){let c=await e.request({kind:"status"});n=c.status.authority?.documentRevision,o=c.status.serviceInstanceId}let i=await e.request({kind:"command.invoke",invocation:{commandId:t.commandId,input:t.input,requestId:t.requestId,...t.idempotencyKey?{idempotencyKey:t.idempotencyKey}:{},...n===void 0?{}:{expectedRevision:{serviceInstanceId:o,document:n}},principal:{type:"agent",id:"fps-editor-agent"},source:"agent-cli",...t.transactionId?{transactionId:t.transactionId}:{},...t.traceId?{traceId:t.traceId}:{},...t.clientId?{clientId:t.clientId}:{}},...t.timeoutMs===void 0?{}:{timeoutMs:t.timeoutMs}});if(t.settlement==="query-once"&&i.operation&&!Ee(i.operation.status)){let c=await e.request({kind:"operation.get",operationId:i.operation.operationId});return{...i,operation:c.operation??i.operation}}return i}})}function Ee(e){return e==="completed"||e==="failed"||e==="cancelled"}var l=Object.freeze({ok:0,usage:2,discovery:3,unavailable:4,conflict:5,execution:6,running:7,interrupted:130}),W=1024*1024,Z=3e4,se=S.join(".fps-editor","state","agent-runtime.json"),k=Object.freeze({kind:"fps-editor-agent-deadline"}),q=!1,$=Number.POSITIVE_INFINITY,pe=Z,O=new AbortController;process.once("SIGINT",()=>{q=!0,O.abort(),process.exitCode=l.interrupted,setTimeout(()=>process.exit(l.interrupted),25).unref?.()});Ne().catch(e=>{let t=q?L():Se(e);v(t.result??{ok:!1,error:{code:t.code,message:t.message}}),t.log!==!1&&process.stderr.write(`[fps-editor-agent] ${t.message}
+`),process.exitCode=t.exitCode});async function Ne(){let e=Fe(process.argv.slice(2)),t=e.argv,n=e.projectRoot??process.cwd(),o=e.projectRoot!==void 0;if(pe=e.deadlineMs,$=Date.now()+e.deadlineMs,t.length===0||t.includes("--help")||t[0]==="help"){v({ok:!0,usage:Qe()});return}if(t.includes("--version")){let a=JSON.parse(await F(new URL("../package.json",import.meta.url),"utf8"));v({ok:!0,package:a.name,version:a.version,protocolVersion:4});return}let i=t.shift();if(i==="doctor"){let a=await Ie(n,{validateService:!1,exactProjectRoot:o}),d=await ge(a),r=await(await de(n,{exactProjectRoot:o})).request({kind:"status"});v({ok:!0,descriptorPath:a.descriptorPath,projectRoot:a.projectRoot,checks:d,status:r.status});return}let c=await de(n,{exactProjectRoot:o}),s=ie({transport:re(c),createRequestId:H,createIdempotencyKey:H,createUnavailableError:(a,d)=>I(l.unavailable,a,d)});if(i==="status"){v(await c.request({kind:"status"}));return}if(i==="commands"){await xe(s,t);return}if(i==="command"){await Ce(s,c,t);return}if(i==="transaction"){await ke(c,t);return}if(i==="apply"){await De(c,s,t);return}if(i==="operation"){await je(c,t);return}if(i==="trace"){await Le(c,t);return}throw p(`Unknown command: ${String(i)}`)}async function xe(e,t){let n=t.shift();if(n==="describe"){let s=j(t,"command id");ye(t),v(await e.describeCommand(s));return}let o=x(t,new Set(["--cursor","--limit"])),i=h(o.options,"--cursor"),c=_(o.options,"--limit",{minimum:1});if(n==="list"){if(o.positionals.length)throw p("commands list does not accept positional arguments.");v(await e.listCommands({...i?{cursor:i}:{},...c?{limit:c}:{}}));return}if(n==="search"){let s=j(o.positionals,"search query");if(o.positionals.length)throw p("commands search accepts one query.");v(await e.searchCommands({query:s,...i?{cursor:i}:{},...c?{limit:c}:{}}));return}throw p("commands requires list, search, or describe.")}async function Ce(e,t,n){let o=x(n,new Set(["--stdin","--input-file","--input-json","--expected-revision","--idempotency-key","--request-id","--timeout","--trace-id","--client-id","--source-file"]),new Set(["--stdin"])),i=j(o.positionals,"command id");if(o.positionals.length)throw p("command accepts one command id.");let c=await Je(o.options),s=await e.prepareCommand(i),a=h(o.options,"--source-file"),d=null;if(a){if(i!=="asset.import")throw p("--source-file is only valid for asset.import.");if(!c||typeof c!="object"||Array.isArray(c))throw p("asset.import input must be a JSON object.");if(Object.prototype.hasOwnProperty.call(c,"sourceGrantId"))throw p("Do not combine --source-file with input.sourceGrantId.");let w=await t.uploadAssetSource(S.resolve(a));d=w.sourceGrantId,c={...c,sourceGrantId:w.sourceGrantId}}let u=!1,r=!1,f=null;try{let w=_(o.options,"--expected-revision",{minimum:0}),m=_(o.options,"--timeout",{minimum:0});u=!0;let g=await e.invokeCommand({preparedCommand:s,input:c,...w===void 0?{}:{expectedDocumentRevision:w},...h(o.options,"--request-id")?{requestId:h(o.options,"--request-id")}:{},...h(o.options,"--idempotency-key")?{idempotencyKey:h(o.options,"--idempotency-key")}:{},...m===void 0?{}:{timeoutMs:m},...h(o.options,"--trace-id")?{traceId:h(o.options,"--trace-id")}:{},...h(o.options,"--client-id")?{clientId:h(o.options,"--client-id")}:{}});r=!0,v(g),G(g.operation)}catch(w){throw f=w,w}finally{let w=u&&!r&&["cli.deadlineExceeded","cli.interrupted","service.unreachable"].includes(f?.code);d&&!w&&await t.revokeAssetSource(d).catch(()=>{})}}async function ke(e,t){let n=t.shift();if(n==="begin"){let s=x(t,new Set(["--expected-revision","--label","--transaction-id","--trace-id","--service-instance-id"]));if(s.positionals.length)throw p("transaction begin does not accept positional arguments.");let a=await le(e),d=h(s.options,"--transaction-id")??H(),u=await e.request({kind:"transaction.begin",serviceInstanceId:h(s.options,"--service-instance-id")??a.serviceInstanceId,expectedDocumentRevision:_(s.options,"--expected-revision",{minimum:0})??a.documentRevision,...h(s.options,"--label")?{label:h(s.options,"--label")}:{},transactionId:d,...h(s.options,"--trace-id")?{traceId:h(s.options,"--trace-id")}:{}});v(u),P(u.transaction);return}let o=x(t,new Set(["--service-instance-id","--sequence","--stdin","--input-file","--cursor","--limit"]),new Set(["--stdin"])),i=j(o.positionals,"transaction id");if(o.positionals.length)throw p(`transaction ${String(n)} accepts one transaction id.`);let c=h(o.options,"--service-instance-id")??e.serviceInstanceId;if(n==="append"){Y(o.options,new Set(["--service-instance-id","--sequence","--stdin","--input-file"]));let s=_(o.options,"--sequence",{minimum:0});s===void 0&&(s=(await e.request({kind:"transaction.get",transactionId:i,serviceInstanceId:c,limit:1})).transaction.acceptedOperations);let a,d=me(o.options);await fe({client:e,source:d,transactionId:i,serviceInstanceId:c,sequence:s,maxOperations:e.status.transactions.maxOperationsPerAppend,maxBytes:e.status.transactions.maxBytesPerAppend,onAppend(u){a=u,v(u)}}),P(a?.transaction);return}if(n==="preflight"||n==="commit"||n==="abort"){Y(o.options,new Set(["--service-instance-id"]));let s=await e.request({kind:`transaction.${n}`,transactionId:i,serviceInstanceId:c});v(s),P(s.transaction,{abortedIsSuccess:n==="abort"});return}if(n==="get"){Y(o.options,new Set(["--service-instance-id","--cursor","--limit"]));let s=await e.request({kind:"transaction.get",transactionId:i,serviceInstanceId:c,...h(o.options,"--cursor")?{cursor:h(o.options,"--cursor")}:{},..._(o.options,"--limit",{minimum:1})?{limit:_(o.options,"--limit",{minimum:1})}:{}});v(s),P(s.transaction);return}throw p("transaction requires begin, append, preflight, commit, get, or abort.")}async function De(e,t,n){let o=x(n,new Set(["--stdin","--input-file","--save","--expected-revision","--label","--transaction-id","--trace-id","--service-instance-id","--timeout"]),new Set(["--stdin","--save"]));if(o.positionals.length)throw p("apply does not accept positional arguments.");let i=await le(e),c=h(o.options,"--service-instance-id")??i.serviceInstanceId,s=_(o.options,"--expected-revision",{minimum:0})??i.documentRevision,a=_(o.options,"--timeout",{minimum:0}),d=h(o.options,"--transaction-id")??H(),u=h(o.options,"--trace-id"),r,f="begin";try{r=(await e.request({kind:"transaction.begin",serviceInstanceId:c,expectedDocumentRevision:s,transactionId:d,...h(o.options,"--label")?{label:h(o.options,"--label")}:{},...u?{traceId:u}:{}})).transaction,M("begin",r),f="append";let m=me(o.options);if(await fe({client:e,source:m,transactionId:r.transactionId,serviceInstanceId:r.serviceInstanceId,sequence:r.acceptedOperations,maxOperations:i.transactions.maxOperationsPerAppend,maxBytes:i.transactions.maxBytesPerAppend,onAppend(Te){r=Te.transaction,M("append",r)}}),f="commit",r=(await e.request({kind:"transaction.commit",transactionId:r.transactionId,serviceInstanceId:r.serviceInstanceId})).transaction,M("commit",r),r.state!=="working_committed"){b(!1,"commit_failed",r),P(r);return}if(!o.options.has("--save")){b(!0,"working_committed",r);return}f="document.export";let R=await t.invokeCommand({commandId:"document.export",input:{},expectedDocumentRevision:r.workingDocumentRevision,transactionId:r.transactionId,traceId:u,timeoutMs:a,settlement:"query-once"}),y={response:R,operation:R.operation};if(ae("document.export",r,y.operation),y.operation?.status==="accepted"||y.operation?.status==="running"){b(!1,"awaiting_export_operation",r,{operation:N(y.operation),allowedActions:["operation.get","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),process.exitCode=l.running;return}if(y.operation?.status!=="completed"){b(!1,"save_failed",r,{operation:N(y.operation),allowedActions:["command document.export","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),G(y.operation);return}let E=y.operation.output;if(!E||typeof E!="object"||Array.isArray(E))throw I(l.execution,"document.exportReceiptInvalid","document.export returned an invalid receipt.");if(E.persistedByEditor===!1){b(!1,"awaiting_persistence_confirmation",r,{operation:N(y.operation),allowedActions:["operation.get","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),process.exitCode=l.running;return}let T=typeof E.transactionId=="string"&&E.transactionId.trim()?E.transactionId:null;if(!T)throw I(l.execution,"document.exportReceiptInvalid","document.export receipt is missing transactionId.");f="document.commit";let Re=Number.isSafeInteger(E.documentRevision)?E.documentRevision:r.workingDocumentRevision,te=await t.invokeCommand({commandId:"document.commit",input:{transactionId:T},expectedDocumentRevision:Re,transactionId:r.transactionId,traceId:u,timeoutMs:a,settlement:"query-once"}),A={response:te,operation:te.operation};if(ae("document.commit",r,A.operation),A.operation?.status==="accepted"||A.operation?.status==="running"){b(!1,"awaiting_commit_operation",r,{saveTransactionId:T,operation:N(A.operation),allowedActions:["operation.get","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),process.exitCode=l.running;return}if(A.operation?.status!=="completed"){b(!1,"save_commit_failed",r,{saveTransactionId:T,operation:N(A.operation),allowedActions:["command document.commit","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),G(A.operation);return}b(!0,"saved",r,{saveTransactionId:T,operation:N(A.operation),receipt:qe(A.operation.output)})}catch(w){let m=Se(w);if(m.result?.kind==="cli.deadline"){v({...m.result,kind:"apply.result",phase:f,...r?{transaction:C(r)}:{}}),process.exitCode=m.exitCode;return}let g;if(r&&(r.state==="open"||r.state==="preflighted"))try{r=(await e.request({kind:"transaction.abort",transactionId:r.transactionId,serviceInstanceId:r.serviceInstanceId})).transaction,g=C(r),M("abort",r)}catch{}v({ok:!1,kind:"apply.result",state:r?.state==="working_committed"?"save_failed":"failed",phase:f,...r?{transaction:C(r)}:{},...g?{aborted:g}:{},error:{code:m.code,message:m.message},allowedActions:r?.state==="working_committed"?["command document.export","transaction.get"]:["status"],retry:{retryable:r?.state==="working_committed",requiresRebase:/revision|serviceInstance/i.test(m.code)}}),process.exitCode=m.exitCode}}async function le(e){let t=await e.request({kind:"status"});if(t.kind!=="status"||!t.status)throw I(l.discovery,"protocol.statusInvalid","Editor Service returned an invalid status response.");return t.status}function me(e){if(["--stdin","--input-file"].filter(o=>e.has(o)).length>1)throw p("Use only one of --stdin or --input-file.");let n=h(e,"--input-file");return!n||n==="-"?process.stdin:Q(S.resolve(n),{encoding:"utf8"})}async function fe(e){let t=ce(e.maxOperations,ne),n=ce(e.maxBytes,oe),o=[],i=2,c=e.sequence,s=0,a=0,d=async()=>{if(o.length===0)return;let u=o.length,r=await e.client.request({kind:"transaction.append",transactionId:e.transactionId,serviceInstanceId:e.serviceInstanceId,sequence:c,operations:o});if(r.kind!=="transaction"||r.transaction.acceptedOperations<c+u)throw I(l.execution,"transaction.appendReceiptInvalid","Editor Service returned an invalid append receipt.");c=r.transaction.acceptedOperations,s+=u,e.onAppend(r),o=[],i=2};for await(let u of Ke(e.source,O.signal,n)){a+=1;let r=u.endsWith("\r")?u.slice(0,-1):u;if(!r.trim())continue;let f;try{f=JSON.parse(r)}catch(R){throw p(`NDJSON line ${a} is not valid JSON: ${R instanceof Error?R.message:String(R)}`)}Pe(f,a);let w=JSON.stringify(f),m=Buffer.byteLength(w);if(m+2>n)throw p(`NDJSON line ${a} exceeds the ${n}-byte transaction append limit.`);let g=i+m+(o.length?1:0);o.length&&(o.length>=t||g>n)&&await d(),o.push(f),i+=m+(o.length>1?1:0),(o.length>=t||i>=n)&&await d()}if(await d(),s===0)throw p("Transaction input must contain at least one NDJSON operation.");return{acceptedOperations:s,nextSequence:c}}function Pe(e,t){if(!e||typeof e!="object"||Array.isArray(e))throw p(`NDJSON line ${t} must be a transaction operation object.`);if(typeof e.opId!="string"||!e.opId.trim())throw p(`NDJSON line ${t} requires a non-empty opId.`);if(typeof e.commandId!="string"||!e.commandId.trim())throw p(`NDJSON line ${t} requires a non-empty commandId.`);if(e.as!==void 0&&(typeof e.as!="string"||!e.as.trim()))throw p(`NDJSON line ${t} as must be a non-empty string.`)}function M(e,t){v({ok:t.state!=="failed",kind:"apply.event",phase:e,state:t.state,transaction:C(t)})}function ae(e,t,n){v({ok:n?.status!=="failed"&&n?.status!=="cancelled",kind:"apply.event",phase:e,state:n?.status??"unavailable",transaction:C(t),operation:N(n)})}function b(e,t,n,o={}){v({ok:e,kind:"apply.result",state:t,phase:t==="saved"?"complete":n.phase,transaction:C(n),...o.allowedActions?{}:{allowedActions:n.allowedActions},...o.retry?{}:{retry:n.retry},...o})}function C(e){return{transactionId:e.transactionId,serviceInstanceId:e.serviceInstanceId,state:e.state,phase:e.phase,baseDocumentRevision:e.baseDocumentRevision,...e.workingDocumentRevision===void 0?{}:{workingDocumentRevision:e.workingDocumentRevision},dirty:e.dirty,acceptedOperations:e.acceptedOperations,acceptedBytes:e.acceptedBytes,processedOperations:e.processedOperations,allowedActions:e.allowedActions,retry:e.retry,diagnostics:e.diagnostics,results:{offset:e.results.offset,returned:e.results.returned,total:e.results.total,...e.results.nextCursor?{nextCursor:e.results.nextCursor}:{}}}}function N(e){return e?{operationId:e.operationId,requestId:e.requestId,commandId:e.commandId,status:e.status,...e.transactionId?{transactionId:e.transactionId}:{},...e.traceId?{traceId:e.traceId}:{},...e.output===void 0?{}:{output:e.output},...e.diagnostics?{diagnostics:e.diagnostics}:{}}:null}function qe(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:{}}function ce(e,t){return Number.isSafeInteger(e)&&e>0?e:t}async function je(e,t){let n=t.shift();if(n==="get"){let o=x(t,new Set(["--request-id","--service-instance-id"])),i=o.positionals.shift();if(o.positionals.length)throw p("operation get accepts at most one operation id.");let c=h(o.options,"--request-id");if(!i&&!c||i&&c)throw p("operation get requires exactly one operation id or --request-id.");let s=h(o.options,"--service-instance-id");if(s&&s!==e.serviceInstanceId)throw I(l.conflict,"operation.serviceInstanceChanged",`Expected Editor Service ${s}, received ${e.serviceInstanceId}.`);let a=await e.request(i?{kind:"operation.get",operationId:i}:{kind:"operation.get",requestId:c});v(a),a.operation?G(a.operation):process.exitCode=l.unavailable;return}if(n==="cancel"){let o=j(t,"operation id");ye(t);let i=await e.request({kind:"operation.cancel",operationId:o});v(i),i.operation?!i.cancelled&&!ze(i.operation.status)&&(process.exitCode=l.running):process.exitCode=l.unavailable;return}throw p("operation requires get or cancel.")}async function Le(e,t){if(t.shift()!=="get")throw p("trace requires get.");let o=x(t,new Set(["--cursor","--limit"])),i=o.positionals.shift();if(o.positionals.length)throw p("trace get accepts at most one trace id.");v(await e.request({kind:"trace.get",...i?{traceId:i}:{},...h(o.options,"--cursor")?{cursor:h(o.options,"--cursor")}:{},..._(o.options,"--limit",{minimum:1})?{limit:_(o.options,"--limit",{minimum:1})}:{}}))}async function de(e,t={}){let n=await Ie(e,{validateService:!0,...t}),o=he(process.env.FPS_EDITOR_AGENT_ENDPOINT?.trim()||n.descriptor.endpoint),i=process.env.FPS_EDITOR_AGENT_TOKEN?.trim()||n.descriptor.token,c=async u=>{if(q)throw I(l.interrupted,"cli.interrupted","Interrupted.");let r=$-Date.now();if(r<=0)throw D(n,u);let f=new AbortController,w=()=>f.abort(O.signal.reason);O.signal.addEventListener("abort",w,{once:!0});let m=setTimeout(()=>f.abort(k),r);m.unref?.();try{let g=await fetch(o,{method:"POST",headers:{authorization:`Bearer ${i}`,"content-type":"application/json"},body:JSON.stringify(u),signal:f.signal}),R=await K(g),y;try{y=JSON.parse(R)}catch{throw I(l.discovery,"protocol.invalidJson","Editor Service returned invalid JSON.")}if(g.status===401||g.status===403)throw I(l.discovery,"auth.invalidToken",we(y)||"Editor Service authentication failed.");if(!y?.ok)throw X(y);return y}catch(g){throw q||O.signal.aborted?L():f.signal.reason===k?D(n,u):g&&Number.isInteger(g.exitCode)?g:I(l.discovery,"service.unreachable",`Editor Service is unreachable: ${g instanceof Error?g.message:String(g)}`)}finally{clearTimeout(m),O.signal.removeEventListener("abort",w)}},s=await c({kind:"status"});Ge(n,s);let a=async u=>{let r=await Me(u),f=new URL(V,o),w=new AbortController,m=$-Date.now();if(m<=0)throw D(n,{kind:"asset.sourceGrant"});let g=()=>w.abort(O.signal.reason);O.signal.addEventListener("abort",g,{once:!0});let R=setTimeout(()=>w.abort(k),m);R.unref?.();try{let y=await fetch(f,{method:"POST",headers:{authorization:`Bearer ${i}`,"content-type":"application/vnd.fps-editor.asset-source-bundle-v1"},body:be.from($e(r)),duplex:"half",signal:w.signal}),E=await K(y),T;try{T=JSON.parse(E)}catch{throw I(l.discovery,"protocol.invalidJson","Editor Service returned invalid JSON for asset source upload.")}if(!y.ok||!T?.ok||T.kind!=="asset.sourceGrant"||!T.grant?.sourceGrantId)throw X(T);return T.grant}catch(y){throw q||O.signal.aborted?L():w.signal.reason===k?D(n,{kind:"asset.sourceGrant"}):y&&Number.isInteger(y.exitCode)?y:I(l.discovery,"asset.sourceUploadFailed",`Asset source upload failed: ${y instanceof Error?y.message:String(y)}`)}finally{clearTimeout(R),O.signal.removeEventListener("abort",g)}},d=async u=>{let r=$-Date.now();if(r<=0)throw D(n,{kind:"asset.sourceGrant.revoke"});let f=new AbortController,w=setTimeout(()=>f.abort(k),r);w.unref?.();try{let m=new URL(V,o);m.searchParams.set("sourceGrantId",u);let g=await fetch(m,{method:"DELETE",headers:{authorization:`Bearer ${i}`},signal:f.signal}),R=await K(g),y;try{y=JSON.parse(R)}catch{throw I(l.discovery,"protocol.invalidJson","Editor Service returned invalid JSON for asset source revocation.")}if(!g.ok||!y?.ok)throw X(y);return y}finally{clearTimeout(w)}};return Object.freeze({discovery:n,serviceInstanceId:n.descriptor.serviceInstanceId,status:s.status,request:c,uploadAssetSource:a,revokeAssetSource:d})}async function Me(e){let t;try{t=await B(e)}catch(d){throw I(l.usage,"asset.sourceNotFound",`Asset source is unavailable: ${d instanceof Error?d.message:String(d)}`)}let n=await U(t);if(!n.isFile())throw p("Asset source must be a regular file.");let o=S.extname(t).toLowerCase();if(![".glb",".gltf",".png",".jpg",".jpeg",".env"].includes(o))throw p("Asset source must be GLB, glTF, PNG, JPG, JPEG, or Babylon ENV.");let i=S.dirname(t),c=new Map([[S.basename(t),t]]);if(o===".gltf"){if(n.size>16*1024*1024)throw p("glTF JSON source exceeds the 16 MiB manifest limit.");let d;try{d=JSON.parse(await F(t,"utf8"))}catch(r){throw p(`glTF source is not valid JSON: ${r instanceof Error?r.message:String(r)}`)}let u=[...Array.isArray(d?.buffers)?d.buffers:[],...Array.isArray(d?.images)?d.images:[]];for(let r of u){let f=typeof r?.uri=="string"?r.uri:null;if(!f||f.startsWith("data:"))continue;if(/^[a-z][a-z0-9+.-]*:/i.test(f)||f.startsWith("//"))throw p("glTF dependencies must use local relative URIs.");let w;try{w=decodeURIComponent(f.split(/[?#]/,1)[0])}catch{throw p(`glTF dependency URI is malformed: ${f}`)}let m=S.posix.normalize(w.replaceAll("\\","/"));if(!m||m==="."||m===".."||m.startsWith("../")||S.posix.isAbsolute(m))throw p(`glTF dependency escapes the source directory: ${f}`);let g;try{g=await B(S.resolve(i,...m.split("/")))}catch{throw p(`glTF dependency is missing: ${m}`)}if(He(i,g,m),!(await U(g)).isFile())throw p(`glTF dependency is not a regular file: ${m}`);c.set(m,g)}}let s=[];for(let[d,u]of c){let r=await U(u);if(r.size<1||r.size>256*1024*1024)throw p(`Asset source file size is outside the supported range: ${d}`);s.push({path:d,filePath:u,byteSize:r.size,contentHash:await Ue(u)})}let a=s.reduce((d,u)=>d+u.byteSize,0);if(s.length>128||a>512*1024*1024)throw p("Asset source bundle exceeds the supported file-count or total-size limit.");return{primaryPath:S.basename(t),files:s}}async function Ue(e){let t=Oe("sha256");for await(let n of Q(e))t.update(n);return`sha256:${t.digest("hex")}`}async function*$e(e){let t=Buffer.from(JSON.stringify({schemaVersion:1,primaryPath:e.primaryPath,files:e.files.map(({path:o,byteSize:i,contentHash:c})=>({path:o,byteSize:i,contentHash:c}))}),"utf8"),n=Buffer.allocUnsafe(4);n.writeUInt32BE(t.length,0),yield n,yield t;for(let o of e.files)for await(let i of Q(o.filePath))yield i}function He(e,t,n){let o=S.relative(e,t);if(!o||o===".."||o.startsWith(`..${S.sep}`)||S.isAbsolute(o))throw p(`glTF dependency escapes the source directory: ${n}`)}async function Ie(e,t={}){let n;try{n=await B(S.resolve(e))}catch(o){throw I(l.discovery,"projectRoot.invalid",`Project root is unavailable: ${o instanceof Error?o.message:String(o)}`)}for(;;){let o=S.join(n,se);if(await Ye(o)){let c=await Be(o),s=await B(n);if(c.canonicalProjectRoot!==s)throw I(l.discovery,"descriptor.projectMismatch",`Runtime descriptor does not own ${s}.`);let a={descriptorPath:o,projectRoot:s,descriptor:c};return t.validateService!==!1&&await ge(a),a}if(t.exactProjectRoot===!0)break;let i=S.dirname(n);if(i===n)break;n=i}throw I(l.discovery,"descriptor.notFound",`No ${se} was found from ${e}.`)}async function Be(e){let t;try{t=JSON.parse(await F(e,"utf8"))}catch(n){throw I(l.discovery,"descriptor.invalid",`Runtime descriptor is unreadable: ${n instanceof Error?n.message:String(n)}`)}if(t?.schemaVersion!==1||t?.protocolVersion!==4||t?.packageName!=="@fps-games/editor"||typeof t?.serviceInstanceId!="string"||typeof t?.canonicalProjectRoot!="string"||typeof t?.endpoint!="string"||typeof t?.token!="string"||!Number.isSafeInteger(t?.pid))throw I(l.discovery,"descriptor.incompatible","Runtime descriptor schema or protocol is incompatible.");if(he(t.endpoint),process.platform!=="win32"){let n=(await U(e)).mode&511;if(n&63)throw I(l.discovery,"descriptor.permissions",`Runtime descriptor permissions must be 0600; received ${n.toString(8)}.`)}return t}function he(e){let t;try{t=new URL(e)}catch{throw I(l.discovery,"descriptor.endpoint","Runtime descriptor endpoint is invalid.")}if(t.protocol!=="http:"||!["127.0.0.1","localhost","[::1]"].includes(t.hostname))throw I(l.discovery,"descriptor.endpoint","Runtime descriptor endpoint must be project-local loopback HTTP.");return t.toString()}async function ge(e){let t=[];t.push({id:"descriptor.schema",ok:e.descriptor.schemaVersion===1}),t.push({id:"descriptor.protocol",ok:e.descriptor.protocolVersion===4}),t.push({id:"descriptor.project",ok:e.descriptor.canonicalProjectRoot===e.projectRoot});let n=Ve(e.descriptor.pid);if(t.push({id:"descriptor.process",ok:n,pid:e.descriptor.pid}),!n)throw I(l.discovery,"descriptor.stale",`Editor Service process is not alive: ${e.descriptor.pid}.`);return t}function Ge(e,t){let n=t?.kind==="status"?t.status:null;if(!n||n.protocolVersion!==4)throw I(l.discovery,"protocol.incompatible","Editor Service status protocol is incompatible.");if(n.serviceInstanceId!==e.descriptor.serviceInstanceId||n.canonicalProjectRoot!==e.projectRoot||n.packageVersion!==e.descriptor.packageVersion||n.buildKey!==e.descriptor.buildKey)throw I(l.discovery,"service.identityMismatch","Editor Service identity does not match the project runtime descriptor.")}async function Je(e){if(["--stdin","--input-file","--input-json"].filter(i=>e.has(i)).length>1)throw p("Use only one of --stdin, --input-file, or --input-json.");if(e.has("--stdin"))return z(await Xe(process.stdin,O.signal),"--stdin");let n=h(e,"--input-file");if(n)return z(await F(S.resolve(n),"utf8"),"--input-file");let o=h(e,"--input-json");return o===void 0?{}:z(o,"--input-json")}function z(e,t){try{return JSON.parse(e)}catch(n){throw p(`${t} is not valid JSON: ${n instanceof Error?n.message:String(n)}`)}}function x(e,t,n=new Set){let o=new Map,i=[];for(;e.length;){let c=e.shift();if(!c.startsWith("--")){i.push(c);continue}let[s,a]=c.split("=",2);if(!t.has(s))throw p(`Unknown option: ${s}`);if(o.has(s))throw p(`Option may only be provided once: ${s}`);if(n.has(s)){if(a!==void 0)throw p(`${s} does not accept a value.`);o.set(s,!0);continue}let d=a??e.shift();if(d===void 0||d.startsWith("--"))throw p(`${s} requires a value.`);o.set(s,d)}return{options:o,positionals:i}}function h(e,t){let n=e.get(t);if(n!==void 0){if(typeof n!="string"||!n.trim())throw p(`${t} requires a non-empty value.`);return n.trim()}}function Fe(e){let t=[],n=Z,o=!1,i;for(let c=0;c<e.length;c+=1){let s=e[c];if(s==="--project-root"||s.startsWith("--project-root=")){if(i!==void 0)throw p("--project-root may only be provided once.");let u=s==="--project-root"?e[++c]:s.slice(15);if(u===void 0||!u.trim()||u.startsWith("--"))throw p("--project-root requires a non-empty path.");i=S.resolve(process.cwd(),u);continue}if(s!=="--deadline"&&!s.startsWith("--deadline=")){t.push(s);continue}if(o)throw p("--deadline may only be provided once.");o=!0;let a=s==="--deadline"?e[++c]:s.slice(11);if(a===void 0||a.startsWith("--"))throw p("--deadline requires a value.");let d=Number(a);if(!Number.isSafeInteger(d)||d<1)throw p("--deadline must be an integer >= 1.");n=d}return{argv:t,deadlineMs:n,projectRoot:i}}function _(e,t,{minimum:n}){let o=h(e,t);if(o===void 0)return;let i=Number(o);if(!Number.isSafeInteger(i)||i<n)throw p(`${t} must be an integer >= ${n}.`);return i}function j(e,t){let n=e.shift();if(!n)throw p(`Missing ${t}.`);return n}function ye(e){if(e.length)throw p(`Unexpected argument: ${e[0]}`)}function Y(e,t){for(let n of e.keys())if(!t.has(n))throw p(`Option is not valid for this action: ${n}`)}function G(e){if(!e){process.exitCode=l.unavailable;return}if(e.status==="accepted"||e.status==="running"){process.exitCode=l.running;return}(e.status==="failed"||e.status==="cancelled")&&(process.exitCode=ee(e.diagnostics))}function P(e,t={}){if(!e){process.exitCode=l.unavailable;return}if(e.state==="preflighting"||e.state==="committing"){process.exitCode=l.running;return}if(e.state==="failed"){process.exitCode=ee(e.diagnostics);return}e.state==="aborted"&&t.abortedIsSuccess!==!0&&(process.exitCode=l.execution)}function ee(e=[]){let t=e.map(n=>n?.code??"");return t.some(n=>/revision|idempotency|conflict|serviceInstance/i.test(n))?l.conflict:t.some(n=>/unknown|unavailable|notFound|sessionUnavailable/i.test(n))?l.unavailable:l.execution}function X(e){let t=Array.isArray(e?.diagnostics)?e.diagnostics:[];return I(ee(t),t[0]?.code??"service.requestFailed",we(e)||"Editor Service request failed.")}function we(e){return Array.isArray(e?.diagnostics)?e.diagnostics.map(t=>t?.message).filter(Boolean).join("; "):""}function Ve(e){try{return process.kill(e,0),!0}catch(t){return t?.code==="EPERM"}}function ze(e){return e==="completed"||e==="failed"||e==="cancelled"}async function K(e){let t=Number(e.headers.get("content-length"));if(Number.isFinite(t)&&t>W)throw I(l.execution,"response.tooLarge","Editor Service response exceeds 1 MiB.");let n=await e.text();if(Buffer.byteLength(n)>W)throw I(l.execution,"response.tooLarge","Editor Service response exceeds 1 MiB.");return n}async function Ye(e){try{return await Ae(e,_e.R_OK),!0}catch{return!1}}async function Xe(e,t){let n=[];for await(let o of ve(e,t))n.push(Buffer.isBuffer(o)?o:Buffer.from(o));return Buffer.concat(n).toString("utf8")}async function*Ke(e,t,n=Number.POSITIVE_INFINITY){let o="";for await(let i of ve(e,t)){o+=i.toString();let c;for(;(c=o.indexOf(`
+`))>=0;){let s=o.slice(0,c);if(Buffer.byteLength(s)>n)throw p(`NDJSON line exceeds the ${n}-byte transaction append limit.`);yield s,o=o.slice(c+1)}if(Buffer.byteLength(o)>n)throw p(`NDJSON line exceeds the ${n}-byte transaction append limit.`)}o&&(yield o)}async function*ve(e,t){let n=e[Symbol.asyncIterator]();for(;;){let o=await We(n,t);if(o.done)return;yield o.value}}function We(e,t){return t.aborted?Promise.reject(L()):new Promise((n,o)=>{let i=()=>o(L());t.addEventListener("abort",i,{once:!0}),e.next().then(n,o).finally(()=>t.removeEventListener("abort",i))})}function v(e){let t=JSON.stringify(e);if(Buffer.byteLength(t)>W)throw I(l.execution,"output.tooLarge","CLI output exceeds 1 MiB.");process.stdout.write(`${t}
+`)}function Qe(){return{globalOptions:{deadline:`End-to-end CLI deadline in milliseconds (default ${Z}).`,projectRoot:"Exact target project root. Required for deployment-owned usage from outside the project."},commands:["status","commands list [--cursor CURSOR] [--limit N]","commands search QUERY [--cursor CURSOR] [--limit N]","commands describe COMMAND_ID","command COMMAND_ID [--stdin|--input-file FILE|--input-json JSON] [--source-file FILE for asset.import] [--expected-revision N] [--idempotency-key KEY] [--request-id ID] [--trace-id ID] [--client-id ID] [--timeout MS]","apply [--stdin|--input-file FILE] [--save] [--expected-revision N] [--transaction-id ID] [--label TEXT] [--trace-id ID] [--timeout MS]","transaction begin [--expected-revision N] [--transaction-id ID] [--label TEXT] [--trace-id ID]","transaction append TRANSACTION_ID [--stdin|--input-file FILE] [--sequence N] [--service-instance-id ID]","transaction preflight TRANSACTION_ID [--service-instance-id ID]","transaction commit TRANSACTION_ID [--service-instance-id ID]","transaction get TRANSACTION_ID [--service-instance-id ID] [--cursor CURSOR] [--limit N]","transaction abort TRANSACTION_ID [--service-instance-id ID]","operation get OPERATION_ID [--service-instance-id ID]","operation get --request-id REQUEST_ID [--service-instance-id ID]","operation cancel OPERATION_ID","trace get [TRACE_ID] [--cursor CURSOR] [--limit N]","doctor"],exitCodes:l}}function p(e){return I(l.usage,"cli.usage",e)}function I(e,t,n,o=!0,i){return Object.assign(new Error(n),{exitCode:e,code:t,log:o,...i?{result:i}:{}})}function D(e,t){let n=t?.kind==="command.invoke"?t.invocation:null,o=t?.kind?.startsWith("transaction.")?t.transactionId:n?.transactionId,i=!!n||typeof t?.kind=="string"&&/^transaction\.(begin|append|preflight|commit|abort)$/.test(t.kind),c=n?.requestId,s=c?`operation get --request-id ${c} --service-instance-id ${e.descriptor.serviceInstanceId}`:null,a=o?`transaction get ${o} --service-instance-id ${e.descriptor.serviceInstanceId}`:null,d=[s,a].filter(Boolean);d.length||d.push("status");let u=`Agent CLI exceeded its ${pe}ms end-to-end deadline.`;return I(l.running,"cli.deadlineExceeded",u,!0,{ok:!1,kind:"cli.deadline",state:i?"outcome_unknown":"timed_out",serviceInstanceId:e.descriptor.serviceInstanceId,...n?.commandId?{commandId:n.commandId}:{},...c?{requestId:c}:{},...o?{transactionId:o}:{},error:{code:"cli.deadlineExceeded",message:u},allowedActions:d,retry:{retryable:!i,requiresOperationQuery:i}})}function L(){return I(l.interrupted,"cli.interrupted","Interrupted.")}function Se(e){return e&&Number.isInteger(e.exitCode)&&typeof e.code=="string"?e:I(l.execution,"cli.failure",e instanceof Error?e.message:String(e))}