@crewx/sdk 0.9.0-rc.17 → 0.9.0-rc.170

package/dist/app/index.js

@@ -0,0 +1,12 @@
+'use strict';var util=require('util'),fs=require('fs'),crypto=require('crypto'),net=require('net'),console$1=require('console'),stream=require('stream');var N=["text/plain","application/json"];var q=[5,15,30,60],x=Object.freeze({min:15e3,max:6e5,default:3e5}),hn=1,Ae="schedule:",En="schedule",On="exit 78",Fe=["standby","disabled","draining","degraded"],gn=["cron","cron_manual","app_enable"],Sn=/^[A-Z][A-Z0-9_]{0,63}$/u;function qe(n){return typeof n=="string"&&Sn.test(n)}var Me=["status","everyMinutes","lastStartedAt","lastFinishedAt","lastOutcome","lastErrorCode","nextRunAt","periodic","periodicReason"],Tn=["unset","on","off"],Rn=["available","unavailable"],ye=64,In=128;function He(n){return q.includes(n)}function be(n){return Number.isSafeInteger(n)&&n>=x.min&&n<=x.max}function Xe(n){return Fe.includes(n)}function Ge(n){if(!Pn(n)||Object.keys(n).length!==Me.length||!Me.every(o=>Object.hasOwn(n,o))||typeof n.status!="string"||!Tn.includes(n.status)||!He(n.everyMinutes)||!Y(n.lastStartedAt,ye)||!Y(n.lastFinishedAt,ye)||!Y(n.lastOutcome,In)||!Y(n.nextRunAt,ye)||n.lastErrorCode!==null&&!qe(n.lastErrorCode)||typeof n.periodic!="string"||!Rn.includes(n.periodic))return;let t=n.periodic;if(!(t==="available"?n.periodicReason!==null:!Xe(n.periodicReason))&&!(n.nextRunAt!==null&&(n.status!=="on"||t!=="available")))return Object.freeze({status:n.status,everyMinutes:n.everyMinutes,lastStartedAt:n.lastStartedAt,lastFinishedAt:n.lastFinishedAt,lastOutcome:n.lastOutcome,lastErrorCode:n.lastErrorCode,nextRunAt:n.nextRunAt,periodic:t,periodicReason:n.periodicReason})}function Y(n,e){return n===null||typeof n=="string"&&n.length>0&&n.length<=e}function Pn(n){if(n===null||typeof n!="object"||Array.isArray(n))return  false;let e=Object.getPrototypeOf(n);return e===Object.prototype||e===null}var k=Object.freeze({min:6e4,max:18e5,default:6e5}),wn=Object.freeze({min:1e3,max:12e4,default:3e4}),Cn=1,Ve="crewx/appJobs",$e=1,me=["starting","running","stopping","finished"],_e=["succeeded","failed","timed_out","cancelled","shutdown","interrupted"],Q=["cancelled","timed_out","shutdown"],he=["manual","schedule"],Jn=/^[a-z][a-z0-9_]{0,63}$/u,Dn=/^[A-Z][A-Z0-9_]{0,63}$/u,Z=["start","status","cancel"],Ee=["APP_JOB_NOT_DECLARED","APP_JOB_NOT_AUTHORIZED","APP_JOB_SELF_START","APP_JOB_OWNER_INVALID","APP_JOB_DEFINITION_INVALID","APP_JOB_DEFINITION_CHANGED","APP_JOB_DEADLINE_INVALID","APP_JOB_SHUTTING_DOWN","APP_JOB_OWNER_MISMATCH","APP_JOB_STALE_HANDLE","APP_JOB_NOT_ACTIVE","APP_JOB_NOT_GRANTED"],Oe="APP_JOB_RUN_REQUIRED";function ge(n){return Number.isSafeInteger(n)&&n>=k.min&&n<=k.max}function j(n){return typeof n=="string"&&Dn.test(n)}function L(n){return typeof n=="string"&&Jn.test(n)}function H(n){return Z.includes(n)}function Nn(n){return n?.some(({name:e,version:t})=>e===Ve&&t===$e)===true}var ze=Symbol;ze.metadata===void 0&&Object.defineProperty(Symbol,"metadata",{configurable:false,value:Symbol.for("Symbol.metadata")});var xn=ze.metadata,X=Symbol.for("crewx.app.tool-metadata"),l=class extends Error{code;detail;outcome;constructor(e,t=null,o){super(e),this.name="AppError",this.code=e,this.detail=t,this.outcome=Te(o?.outcome);}};function Te(n){return n==="rejected"?"rejected":"failed"}var Se=class{static devtools=process.env.CREWX_APP_DEV==="1"?Object.freeze({log:true}):void 0;currentState;stateWasSet=false;answerBody;answerRange;callContext;callSchedule;callJobs;callJobRun;scheduleDirective;workspaceRoot;constructor(e={workspaceRoot:process.cwd()}){this.currentState=e.state??{},this.workspaceRoot=e.workspaceRoot,this.callContext=e.context===void 0?void 0:Mn(e.context),this.callSchedule=e.schedule===void 0?void 0:Object.freeze({...e.schedule}),this.callJobs=e.jobs,this.callJobRun=e.jobRun;}get jobs(){return this.callJobs}get jobRun(){return this.callJobRun}get schedule(){return this.callSchedule}requestSchedule(e){if(typeof e!="boolean")throw new TypeError("requestSchedule needs true or false");if(this.callSchedule===void 0)throw new l("SCHEDULE_UNSUPPORTED","this App has no schedule on this Host");let t=this.callContext?.actor;if(t==="schedule")throw new l("SCHEDULE_UNSUPPORTED","a scheduled run cannot change its own schedule",{outcome:"rejected"});if(e&&t!=="user")throw new l("SCHEDULE_ENABLE_DENIED","only the person at the screen can turn a schedule on",{outcome:"rejected"});this.scheduleDirective=Object.freeze({enabled:e});}get didRequestSchedule(){return this.scheduleDirective}get context(){if(this.callContext===void 0)throw new TypeError("this.context is only set when the Host runs the action; pass options.context when you construct the App in a test");return this.callContext}get state(){return this.currentState}get didSetState(){return this.stateWasSet}setState(e){this.currentState=e,this.stateWasSet=true;}get didSetContent(){return this.answerBody!==void 0}get producedContent(){return this.answerBody===void 0?void 0:{body:this.answerBody,...this.answerRange===void 0?{}:{range:this.answerRange}}}setContent(e,t){if(typeof e!="string"&&!(e instanceof Uint8Array))throw new TypeError("setContent needs a string or a Uint8Array");if(t!==void 0&&!qn(t))throw new TypeError("setContent range must be { startLine, lineCount, totalLines }, three integers of at least 1");this.answerBody=typeof e=="string"?new TextEncoder().encode(e):new Uint8Array(e),this.answerRange=t===void 0?void 0:{startLine:t.startLine,lineCount:t.lineCount,totalLines:t.totalLines};}emptyState(){return {}}validate(e,t,o){}mapError(e){return {code:"EXECUTION_FAILED",detail:null}}errorState(e,t,o){return {...h(o.state)?o.state:{},error:{code:e,detail:t}}}};function kn(n){return function(e,t){if(t.static||t.private||t.kind!=="method")throw new TypeError("@Tool can decorate public instance methods only");let o=t.metadata;if(!o)throw new TypeError("standard decorator metadata is unavailable");let r=Object.hasOwn(o,X)?o[X]:[];if(r.some(u=>u.methodName===String(t.name)))throw new TypeError(`@Tool is declared more than once for ${String(t.name)}`);let s=n.content===void 0?void 0:Ln(n.name,n.content),i=n.schedule===void 0?void 0:Bn(n);if(i!==void 0&&r.some(u=>u.options.schedule!==void 0))throw new TypeError(`@Tool ${n.name}: an App declares at most one scheduled action`);let a=n.job===void 0?void 0:Un(n);if(a!==void 0&&r.some(u=>u.options.job!==void 0))throw new TypeError(`@Tool ${n.name}: an App declares at most one job action`);let p=n.jobAccess===void 0?void 0:vn(n);o[X]=[...r,{methodName:String(t.name),options:Object.freeze({...n,...s===void 0?{}:{content:s},...i===void 0?{}:{schedule:i},...a===void 0?{}:{job:a},...p===void 0?{}:{jobAccess:p}})}];}}function G(n){let e=n[xn],t=e&&Object.hasOwn(e,X)?e[X]:[],o=new Map(t.map(s=>[s.methodName,s])),r=Object.getOwnPropertyNames(n.prototype).map(s=>o.get(s)).filter(s=>s!==void 0);if(r.length!==t.length)throw new TypeError("a @Tool method is missing from the App prototype");return r}function We(n){return G(n).some(({options:e})=>e.schedule!==void 0)}function Ke(n){let e=n.definition,t=G(n),o=new Set;return t.map(({options:r})=>{if(o.has(r.name))throw new TypeError(`duplicate @Tool name: ${r.name}`);return o.add(r.name),{actionId:r.name,...r.dataInputs===void 0?{}:{dataInputs:[...r.dataInputs]},confirmation:r.confirmation??"none",capability:r.capability??"app.read",mutation:r.mutation??true,inputSchema:r.inputSchema,...r.content===void 0?{}:{content:Fn(r.content)},...r.schedule===void 0?{}:{schedule:{...r.schedule}},...r.job===void 0?{}:{job:{...r.job}},...r.jobAccess===void 0?{}:{jobAccess:[...r.jobAccess]},resultProjection:r.resultProjection??{allow:[...e.stateProjection.allow]},_meta:{description:r.description}}})}function jn(n,e){if(e.length===0)throw new TypeError("backendCommand must name the skill command");let t=Ke(n).map(({_meta:o,...r})=>({...r,backend:{type:"skill",command:[...e]},_meta:o}));return {...n.definition,actions:t}}function Ln(n,e){let t=s=>{throw new TypeError(`@Tool ${n}: content ${s}`)},o=(s,i,a)=>{if(!h(a))return t(`${s} must be an object`);for(let p of Object.keys(a))if(p==="mediaType"){if(!N.includes(a[p]))return t(`${s}.mediaType must be one of ${N.join(", ")}`)}else if(p===i){if(typeof a[p]!="boolean")return t(`${s}.${p} must be true or false`)}else return t(`${s} has the unknown key "${p}"`);return Object.hasOwn(a,"mediaType")?Object.freeze({...a}):t(`${s}.mediaType is required`)};if(!h(e))return t("must be an object");let r={};for(let s of Object.keys(e))if(s==="in")r[s]=o("in","required",e[s]);else if(s==="out")r[s]=o("out","range",e[s]);else return t(`has the unknown key "${s}"; use "in" and/or "out"`);return Object.keys(r).length===0?t('needs "in" and/or "out"'):Object.freeze(r)}function Bn(n){let e=o=>{throw new TypeError(`@Tool ${n.name}: schedule ${o}`)},t=n.schedule;if(!h(t))return e("must be an object");for(let o of Object.keys(t))if(o!=="everyMinutes"&&o!=="timeoutMs")return e(`has the unknown key "${o}"`);return q.includes(t.everyMinutes)?t.timeoutMs!==void 0&&!be(t.timeoutMs)?e(`timeoutMs must be an integer from ${x.min} to ${x.max}`):n.content!==void 0?e("cannot be combined with content"):n.dataInputs!==void 0?e("cannot be combined with dataInputs"):n.confirmation!==void 0&&n.confirmation!=="none"?e("cannot require a native confirmation"):Object.freeze({everyMinutes:t.everyMinutes,...t.timeoutMs===void 0?{}:{timeoutMs:t.timeoutMs}}):e(`everyMinutes must be one of ${q.join(", ")}`)}function Un(n){let e=o=>{throw new TypeError(`@Tool ${n.name}: job ${o}`)},t=n.job;if(!h(t))return e("must be an object");for(let o of Object.keys(t))if(o!=="deadlineMs")return e(`has the unknown key "${o}"`);return t.deadlineMs!==void 0&&!ge(t.deadlineMs)?e(`deadlineMs must be an integer from ${k.min} to ${k.max}`):n.content!==void 0?e("cannot be combined with content"):n.dataInputs!==void 0?e("cannot be combined with dataInputs"):n.confirmation!==void 0&&n.confirmation!=="none"?e("cannot require a native confirmation"):n.schedule!==void 0?e("cannot be the scheduled action too"):n.jobAccess!==void 0?e("cannot also be a control action: a run does not control itself"):Object.freeze({...t.deadlineMs===void 0?{}:{deadlineMs:t.deadlineMs}})}function vn(n){let e=o=>{throw new TypeError(`@Tool ${n.name}: jobAccess ${o}`)},t=n.jobAccess;return !Array.isArray(t)||t.length===0?e("must list at least one operation"):new Set(t).size!==t.length?e("must not repeat an operation"):t.every(H)?n.job!==void 0?e("cannot be set on the job action, which runs the job and cannot control it"):n.content!==void 0?e("cannot be combined with content"):Object.freeze([...t]):e("names an unknown operation")}function Mn(n){return Object.freeze({instanceId:n.instanceId,threadId:n.threadId,actor:n.actor,requestId:n.requestId,nowMs:n.nowMs})}function Fn(n){let e={};for(let[t,o]of Object.entries(n))e[t]={...o};return e}function qn(n){return h(n)&&["startLine","lineCount","totalLines"].every(e=>Number.isSafeInteger(n[e])&&n[e]>=1)}function h(n){if(n===null||typeof n!="object"||Array.isArray(n))return  false;let e=Object.getPrototypeOf(n);return e===Object.prototype||e===null}var Hn=/^[A-Za-z0-9._:-]{1,128}$/u,Xn=/[\u0000-\u001f\u007f\u2028\u2029]/u,Gn=512;function Re(n=process.env){let e=Ye(n.CREWX_APP_INSTANCE_ID),t=n.CREWX_APP_REQUEST_ID,o=n.CREWX_APP_ACTOR_KIND,r=n.CREWX_APP_NOW_MS;if(e===void 0||typeof t!="string"||!Hn.test(t)||o!=="user"&&o!=="agent"&&o!=="schedule"||typeof r!="string"||!/^\d{1,16}$/u.test(r))return;let s=Number(r);if(!Number.isSafeInteger(s))return;let i=n.CREWX_THREAD_ID===void 0?null:Ye(n.CREWX_THREAD_ID);if(i!==void 0&&!(o==="schedule"&&(i!==null||!e.startsWith(Ae))))return Object.freeze({instanceId:e,threadId:i,actor:o,requestId:t,nowMs:s})}function Ye(n){if(!(typeof n!="string"||n.length===0||Xn.test(n)))return new TextEncoder().encode(n).byteLength<=Gn?n:void 0}var Vn="dist/tools.json",$n=1,zn="dist/main.mjs";var Qe=["CREWX_APP_INSTANCE_ID","CREWX_THREAD_ID"];function Wn(n){if(!Array.isArray(n)||n.length===0)return  false;let e=new Set;for(let t of n){if(!Qe.some(o=>o===t)||e.has(t))return  false;e.add(t);}return  true}var ee=2,ne=2097152;var B=2*1024*1024,te=2e4;function Ie(n){return crypto.createHash("sha256").update(n).digest("hex")}function oe(n){if(n.byteLength===0)return 0;let e=0;for(let t of n)t===10&&(e+=1);return n[n.byteLength-1]!==10&&(e+=1),e}var Qn=ne+1+B,Zn=64*1024,et=10,re={kind:"invalid"};function nt(n,e){try{let t=[],o=0;for(;;){let i=new Uint8Array(Zn),a=fs.readSync(n,i,0,i.length,null);if(a===0)break;if(o+=a,o>e)return;t.push(i.subarray(0,a));}let r=new Uint8Array(o),s=0;for(let i of t)r.set(i,s),s+=i.byteLength;return r}catch{return}}function ie(n){return tt(nt(n,Qn))}function tt(n){if(n===void 0)return re;let e=n.indexOf(et);if(n.byteLength<=ne){let o=dt(Buffer.from(n.buffer,n.byteOffset,n.byteLength).toString("utf8"));if(o.ok&&!(e>=0&&J(o.value)&&o.value.schemaVersion===ee))return {kind:"v1",value:o.value}}if(e<=0||e>ne)return re;let t;try{t=JSON.parse(new TextDecoder("utf-8",{fatal:!0}).decode(n.subarray(0,e)));}catch{return re}return !J(t)||t.schemaVersion!==ee?re:{kind:"v2",header:t,body:n.subarray(e+1)}}var ot="actionId,content,input,schemaVersion,state",rt="bytes,lines,mediaType,sha256",it="mediaType,range",st=/^[a-f0-9]{64}$/u,at=new TextDecoder("utf-8",{fatal:true,ignoreBOM:true});function nn(n,e){let t=p=>({code:p,outcome:"rejected"});if(V(n)!==ot||n.schemaVersion!==ee||typeof n.actionId!="string"||!J(n.input)||!J(n.state)||!J(n.content)||V(n.content)!=="in,out")return {code:"INPUT_INVALID",outcome:"failed"};let o=n.content,r,s=o.in;if(s===null){if(e.byteLength!==0)return t(e.byteLength>B?"CONTENT_TOO_LARGE":"CONTENT_DIGEST_MISMATCH")}else {if(!J(s)||V(s)!==rt||!Ze(s.mediaType)||!en(s.bytes,B)||!en(s.lines,te)||typeof s.sha256!="string"||!st.test(s.sha256)||e.byteLength!==s.bytes)return t(e.byteLength>B?"CONTENT_TOO_LARGE":"CONTENT_DIGEST_MISMATCH");if(Ie(e)!==s.sha256||oe(e)!==s.lines)return t("CONTENT_DIGEST_MISMATCH");let p;try{p=at.decode(e);}catch{return t("CONTENT_ENCODING_INVALID")}r={mediaType:s.mediaType,text:p};}let i,a=o.out;if(a!==null){if(!J(a)||V(a)!==it||!Ze(a.mediaType))return t("CONTENT_SOURCE_UNSUPPORTED");let p=a.range;if(p!==null&&!ut(p))return t("CONTENT_SOURCE_UNSUPPORTED");i={mediaType:a.mediaType,...p===null?{}:{range:{startLine:p.startLine,lineCount:p.lineCount}}};}return {actionId:n.actionId,input:n.input,state:n.state,content:{...r===void 0?{}:{in:r},...i===void 0?{}:{out:i}}}}function tn(n){return Object.hasOwn(n,"code")}function on(n,e){let t=o=>({code:o,outcome:"rejected"});if(n?.in===void 0){if(e.in!==void 0)return t("CONTENT_SOURCE_UNSUPPORTED")}else if(e.in===void 0){if(n.in.required===true)return t("CONTENT_REQUIRED")}else if(e.in.mediaType!==n.in.mediaType)return t("CONTENT_SOURCE_UNSUPPORTED");if(n?.out===void 0){if(e.out!==void 0)return t("CONTENT_SOURCE_UNSUPPORTED")}else {if(e.out===void 0)return t("CONTENT_REQUIRED");if(e.out.mediaType!==n.out.mediaType||e.out.range!==void 0&&n.out.range!==true)return t("CONTENT_SOURCE_UNSUPPORTED")}}function se(n,e){let{content:t,...o}=n,r=e===void 0?o:{...o,content:{bytes:e.body.byteLength,lines:oe(e.body),sha256:Ie(e.body),...e.range===void 0?{}:{range:e.range}}},s=new TextEncoder().encode(`${JSON.stringify(r)}
+`);if(e===void 0)return s;let i=new Uint8Array(s.byteLength+e.body.byteLength);return i.set(s,0),i.set(e.body,s.byteLength),i}function rn(n){if(n.body.byteLength>B||oe(n.body)>te)return {code:"CONTENT_TOO_LARGE",outcome:"failed"}}function dt(n){try{return {ok:!0,value:JSON.parse(n)}}catch{return {ok:false}}}function V(n){return Object.keys(n).sort().join(",")}function J(n){if(n===null||typeof n!="object"||Array.isArray(n))return  false;let e=Object.getPrototypeOf(n);return e===Object.prototype||e===null}function Ze(n){return typeof n=="string"&&N.includes(n)}function en(n,e){return Number.isSafeInteger(n)&&n>=0&&n<=e}function ut(n){return J(n)&&V(n)==="lineCount,startLine"&&Number.isSafeInteger(n.startLine)&&n.startLine>=1&&Number.isSafeInteger(n.lineCount)&&n.lineCount>=1&&n.lineCount<=te}var an="CREWX_APP_JOB_CHANNEL",S=1,$=4096,Ce=1e4,Je=5e3,De=512,Pe=Object.freeze({min:3,max:16}),pt=["APP_JOB_BRIDGE_UNAVAILABLE","APP_JOB_BRIDGE_INVALID","APP_JOB_BRIDGE_TIMEOUT","APP_JOB_BRIDGE_CLOSED"],W=/^[A-Za-z0-9._:-]{1,128}$/u,lt=64,dn=2147483647,z=class{#e="";#n=false;push(e){let t=[],o=e;for(;;){let r=o.indexOf(`
+`);if(r===-1)return this.#n||(this.#e+=o,U(this.#e)>$&&(t.push({kind:"oversized"}),this.#e="",this.#n=true)),t;let s=o.slice(0,r);if(o=o.slice(r+1),this.#n){this.#n=false;continue}let i=this.#e+s;this.#e="",t.push(U(i)>$?{kind:"oversized"}:{kind:"line",line:i});}}};function ue(n){let e=JSON.stringify(n);if(U(e)>$)throw new TypeError("App job bridge message is over the line bound");return e}function ct(n){let e=pe(n);if(e===void 0||e.v!==S||!un(e.requestId)||!pn(e.seq))return;let t={v:S,requestId:e.requestId,seq:e.seq};switch(e.op){case "start":return _(e,["v","op","requestId","seq"],[])?{...t,op:"start"}:void 0;case "status":{if(!_(e,["v","op","requestId","seq"],["handle"]))return;if(e.handle===void 0)return {...t,op:"status"};let o=we(e.handle);return o===void 0?void 0:{...t,op:"status",handle:o}}case "cancel":{if(!_(e,["v","op","requestId","seq","handle"],[]))return;let o=we(e.handle);return o===void 0?void 0:{...t,op:"cancel",handle:o}}default:return}}function Ne(n){let e=pe(n);if(e===void 0||e.v!==S||!un(e.requestId)||!pn(e.seq))return;let t={v:S,requestId:e.requestId,seq:e.seq};if(e.ok===false)return _(e,["v","requestId","seq","ok","code"],[])&&Ee.includes(e.code)?{...t,ok:false,code:e.code}:void 0;if(e.ok===true)switch(e.op){case "start":{if(!_(e,["v","requestId","seq","ok","op","outcome","job"],[]))return;let o=ae(e.job),r=e.outcome;return o===void 0||r!=="started"&&r!=="attached"?void 0:{...t,ok:true,op:"start",outcome:r,job:o}}case "status":{if(!_(e,["v","requestId","seq","ok","op","job"],[]))return;if(e.job===null)return {...t,ok:true,op:"status",job:null};let o=ae(e.job);return o===void 0?void 0:{...t,ok:true,op:"status",job:o}}case "cancel":{if(!_(e,["v","requestId","seq","ok","op","outcome","job"],[]))return;let o=ae(e.job);return o===void 0||e.outcome!=="stopping"?void 0:{...t,ok:true,op:"cancel",outcome:"stopping",job:o}}default:return}}function ft(n){let e=pe(n);if(e===void 0||e.v!==S||typeof e.runId!="string"||!W.test(e.runId)||!ce(e.generation))return;let t={v:S,runId:e.runId,generation:e.generation};switch(e.kind){case "heartbeat":return _(e,["v","kind","runId","generation"],[])?{...t,kind:"heartbeat"}:void 0;case "completed":return _(e,["v","kind","runId","generation"],[])?{...t,kind:"completed"}:void 0;case "progress":{if(!_(e,["v","kind","runId","generation","phase"],["completed","total","resumable"]))return;let{completed:o,total:r,resumable:s}=e;return !L(e.phase)||o!==void 0&&!de(o)||r!==void 0&&!de(r)||o!==void 0&&r!==void 0&&o>r||s!==void 0&&typeof s!="boolean"?void 0:{...t,kind:"progress",phase:e.phase,...o===void 0?{}:{completed:o},...r===void 0?{}:{total:r},...s===void 0?{}:{resumable:s}}}case "failed":return _(e,["v","kind","runId","generation","code","recoverable"],[])&&j(e.code)&&typeof e.recoverable=="boolean"?{...t,kind:"failed",code:e.code,recoverable:e.recoverable}:void 0;default:return}}function xe(n){let e=pe(n);if(!(e===void 0||!_(e,["v","kind","runId","generation","reason"],[])||e.v!==S||e.kind!=="stop"||typeof e.runId!="string"||!W.test(e.runId)||!ce(e.generation)||!Q.includes(e.reason)))return {v:S,kind:"stop",runId:e.runId,generation:e.generation,reason:e.reason}}function ke(n){let e=le(n)?n:void 0;if(!(e===void 0||e.v!==S||!mt(e.fd))){if(e.role==="control"){let t=e.operations;return !_(e,["v","role","fd","operations"],[])||!Array.isArray(t)||t.length===0||new Set(t).size!==t.length||!t.every(H)?void 0:{v:1,role:"control",fd:e.fd,operations:[...t]}}if(e.role==="run")return !_(e,["v","role","fd","runId","generation"],[])||typeof e.runId!="string"||!W.test(e.runId)||!ce(e.generation)?void 0:{v:1,role:"run",fd:e.fd,runId:e.runId,generation:e.generation}}}function je(n){let e=n[an];if(typeof e!="string"||U(e)>De)return;let t;try{t=JSON.parse(e);}catch{return}return ke(t)}function yt(n){let e=ke(JSON.parse(JSON.stringify(n)));if(e===void 0)throw new TypeError("App job channel descriptor is invalid");let t=JSON.stringify(e);if(U(t)>De)throw new TypeError("App job channel descriptor is over its bound");return Object.freeze({CREWX_APP_JOB_CHANNEL:t})}function At(n){return n==="schedule"?"schedule":"manual"}function bt(n){return ae(n)}function ae(n){let e=le(n)?n:void 0;if(e===void 0||!_(e,["handle","state","stopReason","trigger","outcome","phase","completed","total","resumable","lastHeartbeatAt","startedAt","finishedAt","errorCode","recoverable"],[]))return;let t=we(e.handle),o=e.stopReason,r=e.outcome,s=e.phase,i=e.errorCode,a=e.recoverable;if(!(t===void 0||!me.includes(e.state)||!(o===null||Q.includes(o))||o!==null&&e.state!=="stopping"||!he.includes(e.trigger)||!(r===null||_e.includes(r))||!(s===null||L(s))||!(e.completed===null||de(e.completed))||!(e.total===null||de(e.total))||typeof e.resumable!="boolean"||!sn(e.lastHeartbeatAt)||!ln(e.startedAt)||!sn(e.finishedAt)||!(i===null||j(i))||!(a===null||typeof a=="boolean")))return {handle:t,state:e.state,stopReason:o,trigger:e.trigger,outcome:r,phase:s,completed:e.completed,total:e.total,resumable:e.resumable,lastHeartbeatAt:e.lastHeartbeatAt,startedAt:e.startedAt,finishedAt:e.finishedAt,errorCode:i,recoverable:a}}function we(n){if(!(!le(n)||!_(n,["runId","generation"],[]))&&!(typeof n.runId!="string"||!W.test(n.runId)||!ce(n.generation)))return {runId:n.runId,generation:n.generation}}function pe(n){if(U(n)>$)return;let e;try{e=JSON.parse(n);}catch{return}return le(e)?e:void 0}function _(n,e,t){let o=new Set([...e,...t]);return Object.keys(n).every(r=>o.has(r))&&e.every(r=>Object.hasOwn(n,r))}function le(n){if(n===null||typeof n!="object"||Array.isArray(n))return  false;let e=Object.getPrototypeOf(n);return e===Object.prototype||e===null}function un(n){return typeof n=="string"&&W.test(n)}function pn(n){return Number.isSafeInteger(n)&&n>=1&&n<=dn}function ce(n){return Number.isSafeInteger(n)&&n>=1&&n<=dn}function mt(n){return Number.isSafeInteger(n)&&n>=Pe.min&&n<=Pe.max}function de(n){return Number.isSafeInteger(n)&&n>=0}function ln(n){return typeof n=="string"&&n.length>0&&n.length<=lt}function sn(n){return n===null||ln(n)}function U(n){return new TextEncoder().encode(n).byteLength}var Et=2147483647,v=class{#e;#n;#p;#y=crypto.randomUUID();#A=new z;#r=new Map;#s=new Set;#t;#l=0;#o=false;#c=false;#a=false;#d=null;constructor(e){this.#e=e.channel,this.#n=e.open??fn,this.#p=e.replyTimeoutMs??Ce;}jobsFor(e){let t=this.#e;if(t.role!=="control"||e===void 0)return;let o=t.operations,r=Z.filter(i=>e.includes(i)&&o.includes(i));if(r.length===0)return;let s=i=>{if(!r.includes(i))throw new l("APP_JOB_NOT_GRANTED",null,{outcome:"rejected"})};return Object.freeze({granted:Object.freeze(r),start:async()=>{s("start");let i=await this.#u("start",{});if(i.ok===false)return {kind:"refused",code:i.code};if(i.op!=="start")throw new l("APP_JOB_BRIDGE_INVALID",null,{outcome:"failed"});return {kind:i.outcome,job:i.job}},status:async i=>{s("status");let a=await this.#u("status",i===void 0?{}:{handle:i});if(a.ok===false)return {kind:"refused",code:a.code};if(a.op!=="status")throw new l("APP_JOB_BRIDGE_INVALID",null,{outcome:"failed"});return {kind:"status",job:a.job}},cancel:async i=>{s("cancel");let a=await this.#u("cancel",{handle:i});if(a.ok===false)return {kind:"refused",code:a.code};if(a.op!=="cancel")throw new l("APP_JOB_BRIDGE_INVALID",null,{outcome:"failed"});return {kind:"stopping",job:a.job}}})}runFor(e){let t=this.#e;if(t.role!=="run"||!e)return;try{this.#f();}catch{return}let o={v:S,runId:t.runId,generation:t.generation},r=()=>this.#d,s=i=>{this.#o||this.#c||this.#t===void 0||this.#t.write(ue({...o,...i}));};return Object.freeze({handle:Object.freeze({runId:t.runId,generation:t.generation}),get stopRequested(){return r()!==null},get stopReason(){return r()},progress:i=>{if(!L(i.phase))throw new TypeError("progress phase must be a lower snake case name");if(i.completed!==void 0&&!cn(i.completed))throw new TypeError("progress completed must be a count");if(i.total!==void 0&&!cn(i.total))throw new TypeError("progress total must be a count");if(i.completed!==void 0&&i.total!==void 0&&i.completed>i.total)throw new TypeError("progress completed cannot exceed total");if(i.resumable!==void 0&&typeof i.resumable!="boolean")throw new TypeError("progress resumable must be boolean");this.#a||s({kind:"progress",phase:i.phase,...i.completed===void 0?{}:{completed:i.completed},...i.total===void 0?{}:{total:i.total},...i.resumable===void 0?{}:{resumable:i.resumable}});},heartbeat:()=>{this.#a||s({kind:"heartbeat"});},complete:()=>{s({kind:"completed"}),this.#a=true;},fail:(i,a)=>{if(!j(i))throw new TypeError("fail code must be an upper snake case code");if(typeof a!="boolean")throw new TypeError("fail recoverable must be boolean");s({kind:"failed",code:i,recoverable:a}),this.#a=true;},onStop:i=>{let a=r();return a!==null?(i(a),()=>{}):(this.#s.add(i),()=>{this.#s.delete(i);})}})}close(){this.#i("APP_JOB_BRIDGE_CLOSED");}async drain(e=Je){if(this.#o)return;this.#c=true;let t=this.#t,o;try{if(t!==void 0){let r;try{r=t.drain();}catch{r=Promise.resolve();}await Promise.race([r.catch(()=>{}),new Promise(s=>{o=setTimeout(s,e);})]);}}finally{clearTimeout(o),this.close();}}#u(e,t){let o=this.#f(),r=this.#l+1;if(r>Et)throw new l("APP_JOB_BRIDGE_CLOSED",null,{outcome:"failed"});this.#l=r;let s=`${this.#y}.${r}`,i=ue({v:S,op:e,requestId:s,seq:r,...t});return new Promise((a,p)=>{let u=setTimeout(()=>this.#i("APP_JOB_BRIDGE_TIMEOUT"),this.#p);this.#r.set(r,{op:e,requestId:s,resolve:a,reject:p,timer:u}),o.write(i);})}#f(){if(this.#o)throw new l("APP_JOB_BRIDGE_CLOSED",null,{outcome:"failed"});if(this.#t!==void 0)return this.#t;let e;try{e=this.#n(this.#e.fd);}catch{throw new l("APP_JOB_BRIDGE_UNAVAILABLE",null,{outcome:"failed"})}return e.onData(t=>this.#b(t)),e.onEnd(()=>this.#i("APP_JOB_BRIDGE_CLOSED")),this.#t=e,e}#b(e){for(let t of this.#A.push(e)){if(this.#o)return;if(this.#e.role==="run")t.kind==="line"&&this.#_(t.line);else if(t.kind==="oversized"){this.#i("APP_JOB_BRIDGE_INVALID");return}else this.#m(t.line);}}#m(e){let t=Ne(e),o=t===void 0?void 0:this.#r.get(t.seq);if(t===void 0||o===void 0||o.requestId!==t.requestId||t.ok&&t.op!==o.op){this.#i("APP_JOB_BRIDGE_INVALID");return}clearTimeout(o.timer),this.#r.delete(t.seq),o.resolve(t);}#_(e){let t=this.#e;if(t.role!=="run")return;let o=xe(e);if(!(o===void 0||o.runId!==t.runId||o.generation!==t.generation)&&this.#d===null){this.#d=o.reason;for(let r of [...this.#s])try{r(o.reason);}catch{}}}#i(e){if(this.#o)return;this.#o=true;let t=[...this.#r.values()];this.#r.clear();for(let r of t)clearTimeout(r.timer),r.reject(new l(e,null,{outcome:"failed"}));this.#s.clear();let o=this.#t;this.#t=void 0,o?.close();}};function fn(n){let e=new net.Socket({fd:n,readable:true,writable:true});return e.setEncoding("utf8"),e.on("error",()=>{}),{write:t=>{e.write(`${t}
+`);},drain:()=>new Promise(t=>{if(e.destroyed){t();return}e.write("",()=>t());}),onData:t=>{e.on("data",t);},onEnd:t=>{e.on("close",t);},close:()=>{e.destroy();}}}function cn(n){return Number.isSafeInteger(n)&&n>=0}var gt=1;async function St(n,e,t=process.env.CREWX_WORKSPACE_ROOT??process.cwd(),o){return (await bn(n,e,t,void 0,true,void 0,o)).response}async function bn(n,e,t,o,r=true,s,i,a){let p=s!==void 0,u=h(e)?e:void 0,b=u?.input,m=u?.state,d=new n({state:h(m)?m:{},workspaceRoot:t,...i===void 0?{}:{context:i}}),E=h(b)?b:{},c=h(m)?m:d.emptyState(),f={},T=u!==void 0&&Object.hasOwn(u,"schedule"),R;try{let A;if(p){if(u===void 0||T)throw new l("INPUT_INVALID");let O=nn(u,s);if(tn(O))throw new l(O.code,null,{outcome:O.outcome});(({actionId:A,input:E,state:c}=O)),f=O.content;}else {let O=T&&u!==void 0?Ge(u.schedule):void 0;if(!u||Object.keys(u).length!==(T?5:4)||!["schemaVersion","actionId","input","state"].every(_n=>Object.hasOwn(u,_n))||u.schemaVersion!==gt||typeof u.actionId!="string"||!h(b)||!h(m)||T&&O===void 0)throw new l("INPUT_INVALID");A=u.actionId,E=b,c=m,R=O;}let y=G(n).find(({options:O})=>O.name===A),C=y===void 0?void 0:a?.jobsFor(y.options.jobAccess),I=y===void 0?void 0:a?.runFor(y.options.job!==void 0);if(d=new n({state:c,workspaceRoot:t,...i===void 0?{}:{context:i},...R===void 0?{}:{schedule:R},...C===void 0?{}:{jobs:C},...I===void 0?{}:{jobRun:I}}),await d.validate(A,E,c),!y)throw new l("INPUT_INVALID");if(R!==void 0&&(y.options.content!==void 0||!We(n)))throw new l("INPUT_INVALID");let M=d[y.methodName];if(typeof M!="function")throw new l("EXECUTION_FAILED");let D=on(y.options.content,f);if(D)throw new l(D.code,null,{outcome:D.outcome});if(y.options.job!==void 0&&I===void 0)throw new l(Oe,null,{outcome:"rejected"});let K=Object.freeze({...f.in===void 0?{}:{in:Object.freeze({text:f.in.text})},...f.out===void 0?{}:{out:Object.freeze(f.out.range===void 0?{}:{range:Object.freeze({...f.out.range})})}}),F=()=>M.call(d,E,K),P=r?await Pt(F):await F();if(P!==void 0&&!h(P))throw new l("EXECUTION_FAILED");let w;if(f.out!==void 0){if(w=d.producedContent,w===void 0)throw new l("EXECUTION_FAILED","content.out was requested but setContent was never called");let O=rn(w);if(O)throw new l(O.code,null,{outcome:O.outcome})}else if(d.didSetContent)throw new l("EXECUTION_FAILED","setContent was called but the request asked for no content.out");let ve=d.didRequestSchedule;return {response:{...d.didSetState?{state:d.state}:{},...P===void 0?{}:{result:P},...ve===void 0?{}:{schedule:{enabled:ve.enabled}}},...w===void 0?{}:{answer:w}}}catch(A){let y,C=A,I=A instanceof l?A:void 0;if(I)y={code:I.code,detail:I.detail,outcome:I.outcome};else try{y=d.mapError(A);}catch(w){y={code:"EXECUTION_FAILED",detail:null},C=w;}let M=Ct(y?.code),D=M?y.code:"EXECUTION_FAILED",K=typeof y?.detail=="string"?y.detail:null,F=M?Te(y.outcome):"failed",P;try{P=d.errorState(D,K,{input:E,state:c});}catch(w){C=new AggregateError([C,w],"App error handling failed"),P=d.emptyState();}return o?.(D,C,{outcome:F,detail:K,expected:I!==void 0&&C===I}),{response:{outcome:F,errorCode:D,state:h(P)?P:d.emptyState()}}}}async function Tt(n,e={}){let t=Rt(e.jobBridge);try{await It(n,e,t);}finally{await t?.drain();}}function Rt(n){if(n===null)return;if(n!==void 0)return new v(n);let e=je(process.env);return e===void 0?void 0:new v({channel:e})}async function It(n,e,t){let o=e.output??process.stdout,r,s;if(e.preloadedInput!==void 0)r=e.preloadedInput.value,s=e.preloadedInput.body;else {let d=ie(e.inputFd??0);d.kind==="v1"?r=d.value:d.kind==="v2"&&(r=d.header,s=d.body);}let i=s!==void 0,a=e.context??Re(),p=false,u=(d,E,c)=>{p=true,e.onFailure?.(d,E,c);},b;try{b=await bn(n,r,process.env.CREWX_WORKSPACE_ROOT??process.cwd(),u,e.consoleManaged!==!0,s,a,t);}catch(d){u("EXECUTION_FAILED",d),b={response:yn(e.emptyState)};}wt(b.response)&&!p&&u(b.response.errorCode,void 0,{outcome:b.response.outcome,detail:null,expected:false});let m;try{let d=(e.sanitize??An)(b.response);m=i?se(d,b.answer):`${JSON.stringify(d)}
+`;}catch(d){u("EXECUTION_FAILED",d);let E=yn(e.emptyState);try{let c=(e.sanitize??An)(E);m=i?se(c):`${JSON.stringify(c)}
+`;}catch(c){u("EXECUTION_FAILED",c),m=i?se(E):`${JSON.stringify(E)}
+`;}}o.write(m);}async function Pt(n){let e=["log","info","debug"],t=new Map;for(let o of e)t.set(o,console[o]),console[o]=(...r)=>process.stderr.write(`${util.format(...r)}
+`);try{return await n()}finally{for(let o of e)console[o]=t.get(o);}}function yn(n={}){return {outcome:"failed",errorCode:"EXECUTION_FAILED",state:{...n,error:{code:"EXECUTION_FAILED",detail:null}}}}function wt(n){return (n.outcome==="failed"||n.outcome==="rejected")&&typeof n.errorCode=="string"}function Ct(n){return typeof n=="string"&&/^[A-Z][A-Z0-9_]{0,127}$/u.test(n)}function An(n){return n}var Le={depth:null,maxArrayLength:null,maxStringLength:null},Ue=class extends stream.Writable{#e="buffer";#n=[];_write(e,t,o){if(this.#e==="buffer"){this.#n.push(typeof e=="string"?e:Uint8Array.from(e)),o();return}if(this.#e==="discard"){o();return}process.stderr.write(e,o);}flushToStderr(){this.#e="stderr";for(let e of this.#n)process.stderr.write(e);this.#n=[];}discard(){this.#e="discard",this.#n=[];}};async function Nt(n,e={}){let t=process.stdout,o=t.write.bind(t),r=new Ue,s=new console$1.Console({stdout:r,stderr:r,inspectOptions:{...Le}});globalThis.console=s;let i=false,a="-",p="-",u,b=false,m,d;try{let f=kt(e.inputFd??0);a=jt(f.value),p=fe(process.env.CREWX_APP_REQUEST_ID),u=new Date().toISOString();try{m=await n();}catch(A){b=!0,d=A;}let T=m?.default;if(!b&&T?.devtools?.log===!0?(Object.assign(util.inspect.defaultOptions,Le),E(u),r.flushToStderr()):r.discard(),b){c("EXECUTION_FAILED",d),Be(o,e,c);return}try{if(typeof m?.runSkillApp!="function")throw new TypeError("App module does not export runSkillApp");let A={sanitize:e.sanitize,emptyState:e.emptyState??xt(T),preloadedInput:f.body===void 0?{value:f.value}:{value:f.value,body:f.body},onFailure:c,consoleManaged:!0,output:{write:o},jobBridge:e.jobBridge};await m.runSkillApp(T,A);}catch(A){c("EXECUTION_FAILED",A),Be(o,e,c);}}catch(f){c("EXECUTION_FAILED",f),Be(o,e,c);}finally{process.exitCode=0;}function E(f){i||(process.stderr.write(`[crewx-app] ${f??new Date().toISOString()} ${fe(a)} req=${p}
+`),i=true);}function c(f,T,R){E();let A=R?.expected===true&&R.detail?` ${fe(R.detail)}`:"";process.stderr.write(`[crewx-app] ${R?.outcome??"failed"} ${fe(f)}${A}
+`),T!==void 0&&R?.expected!==true&&process.stderr.write(`${util.inspect(T,Le)}
+`);}}function xt(n){if(typeof n=="function")try{let t=new n({workspaceRoot:process.cwd()}).emptyState();return t!==null&&typeof t=="object"&&!Array.isArray(t)?t:void 0}catch{return}}function kt(n){let e=ie(n);return e.kind==="v1"?{value:e.value}:e.kind==="v2"?{value:e.header,body:e.body}:{value:void 0}}function jt(n){return n!==null&&typeof n=="object"&&!Array.isArray(n)&&typeof n.actionId=="string"?n.actionId:"-"}function fe(n){return typeof n!="string"||n.length===0?"-":n.replace(/[\u0000-\u001f\u007f\u2028\u2029]/gu,"_")}function Be(n,e,t){let o={code:"EXECUTION_FAILED",detail:null},s={outcome:"failed",errorCode:"EXECUTION_FAILED",state:e.emptyState!==null&&typeof e.emptyState=="object"&&!Array.isArray(e.emptyState)?{...e.emptyState,error:o}:{error:o}},i=s;try{i=(e.sanitize??Lt)(s);}catch(a){t("EXECUTION_FAILED",a);}n(`${JSON.stringify(i)}
+`);}function Lt(n){return n}exports.APP_JOB_BRIDGE_CHANNEL_MAX_BYTES=De;exports.APP_JOB_BRIDGE_DRAIN_TIMEOUT_MS=Je;exports.APP_JOB_BRIDGE_ENV=an;exports.APP_JOB_BRIDGE_ERROR_CODES=pt;exports.APP_JOB_BRIDGE_FD=Pe;exports.APP_JOB_BRIDGE_MAX_LINE_BYTES=$;exports.APP_JOB_BRIDGE_REPLY_TIMEOUT_MS=Ce;exports.APP_JOB_BRIDGE_VERSION=S;exports.APP_JOB_CAPABILITY=Ve;exports.APP_JOB_CAPABILITY_VERSION=$e;exports.APP_JOB_DEADLINE_MS=k;exports.APP_JOB_MAX_PER_APP=Cn;exports.APP_JOB_OPERATIONS=Z;exports.APP_JOB_OUTCOMES=_e;exports.APP_JOB_REFUSAL_CODES=Ee;exports.APP_JOB_RUN_REQUIRED=Oe;exports.APP_JOB_STATES=me;exports.APP_JOB_STOP_GRACE_MS=wn;exports.APP_JOB_STOP_REASONS=Q;exports.APP_JOB_TRIGGERS=he;exports.APP_SCHEDULE_ACTOR_KIND=En;exports.APP_SCHEDULE_INERT_COMMAND=On;exports.APP_SCHEDULE_INSTANCE_PREFIX=Ae;exports.APP_SCHEDULE_INTERVALS_MINUTES=q;exports.APP_SCHEDULE_MAX_PER_APP=hn;exports.APP_SCHEDULE_PERIODIC_REASONS=Fe;exports.APP_SCHEDULE_TIMEOUT_MS=x;exports.APP_TOOLS_FILE=Vn;exports.APP_TOOLS_SCHEMA_VERSION=$n;exports.APP_TOOL_ENTRY=zn;exports.AppError=l;exports.AppJobBridge=v;exports.AppJobLineReader=z;exports.CrewXApp=Se;exports.SCHEDULE_TRIGGERS=gn;exports.SKILL_BACKEND_ENV_NAMES=Qe;exports.Tool=kn;exports.appJobTriggerForActor=At;exports.buildAppJobChannelEnvironment=yt;exports.encodeAppJobLine=ue;exports.executeAppRequest=St;exports.generateManifest=jn;exports.generateToolDeclarations=Ke;exports.getToolDeclarations=G;exports.hasAppJobCapability=Nn;exports.isAppJobCode=j;exports.isAppJobDeadlineMs=ge;exports.isAppJobOperation=H;exports.isAppJobPhase=L;exports.isAppScheduleCode=qe;exports.isAppScheduleIntervalMinutes=He;exports.isAppSchedulePeriodicReason=Xe;exports.isAppScheduleTimeoutMs=be;exports.isSkillBackendEnv=Wn;exports.openInheritedAppJobTransport=fn;exports.parseAppJobChannel=ke;exports.parseAppJobControlReply=Ne;exports.parseAppJobControlRequest=ct;exports.parseAppJobRunPush=xe;exports.parseAppJobRunReport=ft;exports.parseAppJobView=bt;exports.readAppContext=Re;exports.readAppJobChannel=je;exports.runAppEntry=Nt;exports.runSkillApp=Tt;

package/dist/app/job-bridge.child.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/app/job-bridge.d.ts

@@ -0,0 +1,67 @@
+import { type AppJobOperation, type AppJobRefusalCode, type AppJobStopReason } from './job-contract.js';
+import { type AppJobChannel, type AppJobView, type AppJobWireHandle } from './job-wire.js';
+export interface AppJobLineTransport {
+    write(line: string): void;
+    drain(): Promise<void>;
+    onData(listener: (chunk: string) => void): void;
+    onEnd(listener: () => void): void;
+    close(): void;
+}
+export type AppJobTransportOpener = (fd: number) => AppJobLineTransport;
+export interface AppJobBridgeOptions {
+    readonly channel: AppJobChannel;
+    readonly open?: AppJobTransportOpener;
+    readonly replyTimeoutMs?: number;
+}
+export type AppJobStartOutcome = {
+    readonly kind: 'started' | 'attached';
+    readonly job: AppJobView;
+} | {
+    readonly kind: 'refused';
+    readonly code: AppJobRefusalCode;
+};
+export type AppJobStatusOutcome = {
+    readonly kind: 'status';
+    readonly job: AppJobView | null;
+} | {
+    readonly kind: 'refused';
+    readonly code: AppJobRefusalCode;
+};
+export type AppJobStopOutcome = {
+    readonly kind: 'stopping';
+    readonly job: AppJobView;
+} | {
+    readonly kind: 'refused';
+    readonly code: AppJobRefusalCode;
+};
+export interface AppJobs {
+    readonly granted: readonly AppJobOperation[];
+    start(): Promise<AppJobStartOutcome>;
+    status(handle?: AppJobWireHandle): Promise<AppJobStatusOutcome>;
+    cancel(handle: AppJobWireHandle): Promise<AppJobStopOutcome>;
+}
+export interface AppJobProgress {
+    readonly phase: string;
+    readonly completed?: number;
+    readonly total?: number;
+    readonly resumable?: boolean;
+}
+export interface AppJobRun {
+    readonly handle: AppJobWireHandle;
+    readonly stopRequested: boolean;
+    readonly stopReason: AppJobStopReason | null;
+    progress(report: AppJobProgress): void;
+    heartbeat(): void;
+    complete(): void;
+    fail(code: string, recoverable: boolean): void;
+    onStop(listener: (reason: AppJobStopReason) => void): () => void;
+}
+export declare class AppJobBridge {
+    #private;
+    constructor(options: AppJobBridgeOptions);
+    jobsFor(declared: readonly AppJobOperation[] | undefined): AppJobs | undefined;
+    runFor(isDeclaredJob: boolean): AppJobRun | undefined;
+    close(): void;
+    drain(timeoutMs?: number): Promise<void>;
+}
+export declare function openInheritedAppJobTransport(fd: number): AppJobLineTransport;

package/dist/app/job-bridge.drain.child.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/app/job-bridge.example.d.ts

@@ -0,0 +1,11 @@
+import { CrewXApp, type AppDefinition, type JsonObject } from './index.js';
+export declare const CODE_MAP_EXAMPLE_DEFINITION: AppDefinition;
+export declare class CodeMapJobExample extends CrewXApp {
+    static definition: AppDefinition;
+    emptyState(): JsonObject;
+    analyze(): Promise<JsonObject>;
+    status(): Promise<JsonObject>;
+    cancel(): Promise<JsonObject>;
+    autoAnalyze(): Promise<JsonObject>;
+    analyzeRun(): Promise<JsonObject>;
+}

package/dist/app/job-contract.d.ts

@@ -0,0 +1,40 @@
+export declare const APP_JOB_DEADLINE_MS: Readonly<{
+    min: 60000;
+    max: 1800000;
+    default: 600000;
+}>;
+export declare const APP_JOB_STOP_GRACE_MS: Readonly<{
+    min: 1000;
+    max: 120000;
+    default: 30000;
+}>;
+export declare const APP_JOB_MAX_PER_APP = 1;
+export declare const APP_JOB_CAPABILITY = "crewx/appJobs";
+export declare const APP_JOB_CAPABILITY_VERSION = 1;
+export declare const APP_JOB_STATES: readonly ["starting", "running", "stopping", "finished"];
+export type AppJobState = (typeof APP_JOB_STATES)[number];
+export declare const APP_JOB_OUTCOMES: readonly ["succeeded", "failed", "timed_out", "cancelled", "shutdown", "interrupted"];
+export type AppJobOutcome = (typeof APP_JOB_OUTCOMES)[number];
+export declare const APP_JOB_STOP_REASONS: readonly ["cancelled", "timed_out", "shutdown"];
+export type AppJobStopReason = (typeof APP_JOB_STOP_REASONS)[number];
+export declare const APP_JOB_TRIGGERS: readonly ["manual", "schedule"];
+export type AppJobTrigger = (typeof APP_JOB_TRIGGERS)[number];
+export declare const APP_JOB_PHASE_PATTERN: RegExp;
+export declare const APP_JOB_CODE_PATTERN: RegExp;
+export declare const APP_JOB_OPERATIONS: readonly ["start", "status", "cancel"];
+export type AppJobOperation = (typeof APP_JOB_OPERATIONS)[number];
+export declare const APP_JOB_REFUSAL_CODES: readonly ["APP_JOB_NOT_DECLARED", "APP_JOB_NOT_AUTHORIZED", "APP_JOB_SELF_START", "APP_JOB_OWNER_INVALID", "APP_JOB_DEFINITION_INVALID", "APP_JOB_DEFINITION_CHANGED", "APP_JOB_DEADLINE_INVALID", "APP_JOB_SHUTTING_DOWN", "APP_JOB_OWNER_MISMATCH", "APP_JOB_STALE_HANDLE", "APP_JOB_NOT_ACTIVE", "APP_JOB_NOT_GRANTED"];
+export type AppJobRefusalCode = (typeof APP_JOB_REFUSAL_CODES)[number];
+export declare const APP_JOB_RUN_REQUIRED: "APP_JOB_RUN_REQUIRED";
+export interface ToolJobDeclaration {
+    readonly deadlineMs?: number;
+}
+export declare function isAppJobDeadlineMs(value: unknown): value is number;
+export declare function isAppJobCode(value: unknown): value is string;
+export declare function isAppJobPhase(value: unknown): value is string;
+export declare function isAppJobOperation(value: unknown): value is AppJobOperation;
+export interface AppJobCapabilityDeclaration {
+    readonly name: string;
+    readonly version: number;
+}
+export declare function hasAppJobCapability(advertised: readonly AppJobCapabilityDeclaration[] | undefined): boolean;

package/dist/app/job-wire.d.ts

@@ -0,0 +1,149 @@
+import { type AppJobOperation, type AppJobOutcome, type AppJobRefusalCode, type AppJobState, type AppJobStopReason, type AppJobTrigger } from './job-contract.js';
+export declare const APP_JOB_BRIDGE_ENV = "CREWX_APP_JOB_CHANNEL";
+export declare const APP_JOB_BRIDGE_VERSION = 1;
+export declare const APP_JOB_BRIDGE_MAX_LINE_BYTES = 4096;
+export declare const APP_JOB_BRIDGE_REPLY_TIMEOUT_MS = 10000;
+export declare const APP_JOB_BRIDGE_DRAIN_TIMEOUT_MS = 5000;
+export declare const APP_JOB_BRIDGE_CHANNEL_MAX_BYTES = 512;
+export declare const APP_JOB_BRIDGE_FD: Readonly<{
+    min: 3;
+    max: 16;
+}>;
+export declare const APP_JOB_BRIDGE_ERROR_CODES: readonly ["APP_JOB_BRIDGE_UNAVAILABLE", "APP_JOB_BRIDGE_INVALID", "APP_JOB_BRIDGE_TIMEOUT", "APP_JOB_BRIDGE_CLOSED"];
+export type AppJobBridgeErrorCode = (typeof APP_JOB_BRIDGE_ERROR_CODES)[number];
+export interface AppJobWireHandle {
+    readonly runId: string;
+    readonly generation: number;
+}
+export interface AppJobView {
+    readonly handle: AppJobWireHandle;
+    readonly state: AppJobState;
+    readonly stopReason: AppJobStopReason | null;
+    readonly trigger: AppJobTrigger;
+    readonly outcome: AppJobOutcome | null;
+    readonly phase: string | null;
+    readonly completed: number | null;
+    readonly total: number | null;
+    readonly resumable: boolean;
+    readonly lastHeartbeatAt: string | null;
+    readonly startedAt: string;
+    readonly finishedAt: string | null;
+    readonly errorCode: string | null;
+    readonly recoverable: boolean | null;
+}
+export type AppJobChannel = {
+    readonly v: 1;
+    readonly role: 'control';
+    readonly fd: number;
+    readonly operations: readonly AppJobOperation[];
+} | {
+    readonly v: 1;
+    readonly role: 'run';
+    readonly fd: number;
+    readonly runId: string;
+    readonly generation: number;
+};
+export type AppJobControlRequest = {
+    readonly v: 1;
+    readonly op: 'start';
+    readonly requestId: string;
+    readonly seq: number;
+} | {
+    readonly v: 1;
+    readonly op: 'status';
+    readonly requestId: string;
+    readonly seq: number;
+    readonly handle?: AppJobWireHandle;
+} | {
+    readonly v: 1;
+    readonly op: 'cancel';
+    readonly requestId: string;
+    readonly seq: number;
+    readonly handle: AppJobWireHandle;
+};
+export type AppJobControlReply = {
+    readonly v: 1;
+    readonly requestId: string;
+    readonly seq: number;
+    readonly ok: true;
+    readonly op: 'start';
+    readonly outcome: 'started' | 'attached';
+    readonly job: AppJobView;
+} | {
+    readonly v: 1;
+    readonly requestId: string;
+    readonly seq: number;
+    readonly ok: true;
+    readonly op: 'status';
+    readonly job: AppJobView | null;
+} | {
+    readonly v: 1;
+    readonly requestId: string;
+    readonly seq: number;
+    readonly ok: true;
+    readonly op: 'cancel';
+    readonly outcome: 'stopping';
+    readonly job: AppJobView;
+} | {
+    readonly v: 1;
+    readonly requestId: string;
+    readonly seq: number;
+    readonly ok: false;
+    readonly code: AppJobRefusalCode;
+};
+export type AppJobRunReport = {
+    readonly v: 1;
+    readonly kind: 'heartbeat';
+    readonly runId: string;
+    readonly generation: number;
+} | {
+    readonly v: 1;
+    readonly kind: 'progress';
+    readonly runId: string;
+    readonly generation: number;
+    readonly phase: string;
+    readonly completed?: number;
+    readonly total?: number;
+    readonly resumable?: boolean;
+} | {
+    readonly v: 1;
+    readonly kind: 'completed';
+    readonly runId: string;
+    readonly generation: number;
+} | {
+    readonly v: 1;
+    readonly kind: 'failed';
+    readonly runId: string;
+    readonly generation: number;
+    readonly code: string;
+    readonly recoverable: boolean;
+};
+export interface AppJobRunPush {
+    readonly v: 1;
+    readonly kind: 'stop';
+    readonly runId: string;
+    readonly generation: number;
+    readonly reason: AppJobStopReason;
+}
+export type AppJobLineEvent = {
+    readonly kind: 'line';
+    readonly line: string;
+} | {
+    readonly kind: 'oversized';
+};
+export declare class AppJobLineReader {
+    #private;
+    push(chunk: string): AppJobLineEvent[];
+}
+export declare function encodeAppJobLine(message: object): string;
+export declare function parseAppJobControlRequest(line: string): AppJobControlRequest | undefined;
+export declare function parseAppJobControlReply(line: string): AppJobControlReply | undefined;
+export declare function parseAppJobRunReport(line: string): AppJobRunReport | undefined;
+export declare function parseAppJobRunPush(line: string): AppJobRunPush | undefined;
+export declare function parseAppJobChannel(value: unknown): AppJobChannel | undefined;
+export declare function readAppJobChannel(env: Readonly<Record<string, string | undefined>>): AppJobChannel | undefined;
+export declare function buildAppJobChannelEnvironment(channel: AppJobChannel): {
+    readonly CREWX_APP_JOB_CHANNEL: string;
+};
+export declare function appJobTriggerForActor(actorKind: 'user' | 'agent' | 'schedule'): AppJobTrigger;
+export declare function parseAppJobView(value: unknown): AppJobView | undefined;

package/dist/app/protocol.d.ts

@@ -0,0 +1,9 @@
+export { UI_CONTENT_MEDIA_TYPES } from './content-media-types.js';
+export type { UiContentMediaType } from './content-media-types.js';
+export declare const SKILL_BACKEND_CONTENT_SCHEMA_VERSION: 2;
+export declare const SKILL_BACKEND_MAX_INPUT_BYTES = 2097152;
+export declare const SKILL_BACKEND_MAX_OUTPUT_BYTES = 2097152;
+export declare const UI_CONTENT_MAX_BYTES: number;
+export declare const UI_CONTENT_MAX_LINES = 20000;
+export declare function sha256Content(bytes: Uint8Array): string;
+export declare function countContentLines(bytes: Uint8Array): number;

package/dist/app/runtime.d.ts

@@ -0,0 +1,23 @@
+import { type AppContext, type AppFailureOutcome, type CrewXAppConstructor, type JsonObject } from './app.js';
+import { type AppJobBridgeOptions } from './job-bridge.js';
+export interface AppFailureInfo {
+    readonly outcome: AppFailureOutcome;
+    readonly detail: string | null;
+    readonly expected: boolean;
+}
+export interface RunSkillAppOptions {
+    readonly sanitize?: (value: unknown) => unknown;
+    readonly inputFd?: number;
+    readonly output?: Pick<NodeJS.WriteStream, 'write'>;
+    readonly emptyState?: JsonObject;
+    readonly preloadedInput?: {
+        readonly value: unknown;
+        readonly body?: Uint8Array;
+    };
+    readonly onFailure?: (errorCode: string, error?: unknown, info?: AppFailureInfo) => void;
+    readonly consoleManaged?: boolean;
+    readonly context?: AppContext;
+    readonly jobBridge?: AppJobBridgeOptions | null;
+}
+export declare function executeAppRequest(appClass: CrewXAppConstructor, rawRequest: unknown, workspaceRoot?: string, context?: AppContext): Promise<JsonObject>;
+export declare function runSkillApp(appClass: CrewXAppConstructor, options?: RunSkillAppOptions): Promise<void>;

package/dist/app/schedule-contract.d.ts

@@ -0,0 +1,59 @@
+export declare const APP_SCHEDULE_INTERVALS_MINUTES: readonly [5, 15, 30, 60];
+export type AppScheduleIntervalMinutes = (typeof APP_SCHEDULE_INTERVALS_MINUTES)[number];
+export declare const APP_SCHEDULE_TIMEOUT_MS: Readonly<{
+    min: 15000;
+    max: 600000;
+    default: 300000;
+}>;
+export declare const APP_SCHEDULE_MAX_PER_APP = 1;
+export declare const APP_SCHEDULE_INSTANCE_PREFIX = "schedule:";
+export declare const APP_SCHEDULE_ACTOR_KIND = "schedule";
+export declare const APP_SCHEDULE_INERT_COMMAND = "exit 78";
+export declare const APP_SCHEDULE_PERIODIC_REASONS: readonly ["standby", "disabled", "draining", "degraded"];
+export type AppSchedulePeriodicReason = (typeof APP_SCHEDULE_PERIODIC_REASONS)[number];
+export declare const SCHEDULE_TRIGGERS: readonly ["cron", "cron_manual", "app_enable"];
+export type ScheduleTrigger = (typeof SCHEDULE_TRIGGERS)[number];
+export interface ToolScheduleDeclaration {
+    readonly everyMinutes: AppScheduleIntervalMinutes;
+    readonly timeoutMs?: number;
+}
+export type AppScheduleStatus = 'unset' | 'on' | 'off';
+export type AppSchedulePeriodic = 'available' | 'unavailable';
+export type AppScheduleRunVerdict = {
+    readonly outcome: 'success';
+} | {
+    readonly outcome: 'failure';
+    readonly code: string;
+};
+export declare const APP_SCHEDULE_CODE_PATTERN: RegExp;
+export declare function isAppScheduleCode(value: unknown): value is string;
+export interface AppScheduleSnapshot {
+    readonly status: AppScheduleStatus;
+    readonly everyMinutes: AppScheduleIntervalMinutes;
+    readonly lastStartedAt: string | null;
+    readonly lastFinishedAt: string | null;
+    readonly lastOutcome: string | null;
+    readonly lastErrorCode: string | null;
+    readonly nextRunAt: string | null;
+    readonly periodic: AppSchedulePeriodic;
+    readonly periodicReason: AppSchedulePeriodicReason | null;
+}
+export interface AppScheduleDirective {
+    readonly enabled: boolean;
+}
+export type AppScheduleActorKind = 'user' | 'agent' | 'schedule';
+export type ScheduleDirectiveDecision = {
+    readonly allow: true;
+} | {
+    readonly allow: false;
+    readonly code: 'SCHEDULE_ENABLE_DENIED' | 'SCHEDULE_DIRECTIVE_UNSUPPORTED';
+};
+export declare function decideScheduleDirective(input: {
+    readonly actorKind: AppScheduleActorKind;
+    readonly directive: AppScheduleDirective;
+}): ScheduleDirectiveDecision;
+export declare function isAppScheduleIntervalMinutes(value: unknown): value is AppScheduleIntervalMinutes;
+export declare function isAppScheduleTimeoutMs(value: unknown): value is number;
+export declare function isAppSchedulePeriodicReason(value: unknown): value is AppSchedulePeriodicReason;
+export declare function parseAppScheduleSnapshot(value: unknown): AppScheduleSnapshot | undefined;
+export declare function parseAppScheduleDirective(value: unknown): AppScheduleDirective | undefined;

package/dist/app/tool-mode.d.ts

@@ -0,0 +1,3 @@
+export declare const APP_TOOLS_FILE = "dist/tools.json";
+export declare const APP_TOOLS_SCHEMA_VERSION: 1;
+export declare const APP_TOOL_ENTRY = "dist/main.mjs";

package/dist/app-artifact-policy/check.d.ts

@@ -0,0 +1,2 @@
+import { type AppRuntimeReferenceInput, type AppRuntimeReferenceResult } from './contract.js';
+export declare function checkAppRuntimeReferences(input: AppRuntimeReferenceInput): AppRuntimeReferenceResult;

package/dist/app-artifact-policy/contract.d.ts

@@ -0,0 +1,54 @@
+export declare const APP_RUNTIME_POLICY_VERSION = "app-runtime-references/1";
+export declare const APP_RUNTIME_REFUSAL_CODES: readonly ["INPUT_INVALID", "LIMIT_EXCEEDED", "PARSE_FAILED", "UNSUPPORTED_LOADER", "BINDING_AMBIGUOUS", "TARGET_OUTSIDE_CLOSURE", "BARE_SPECIFIER", "BUILTIN_NOT_SELECTED", "WORKER_UNSUPPORTED"];
+export type AppRuntimeRefusalCode = (typeof APP_RUNTIME_REFUSAL_CODES)[number];
+export declare const APP_RUNTIME_LIMITS: {
+    readonly maxSourceBytesPerArtifact: number;
+    readonly maxSourceBytesTotal: number;
+    readonly maxExecutableArtifacts: 512;
+    readonly maxAstNodesPerArtifact: 1500000;
+    readonly maxAstNodesTotal: 2000000;
+    readonly maxNestingDepth: 512;
+    readonly maxClosurePaths: 4096;
+    readonly maxBuiltinSelections: 256;
+    readonly maxMetadataBytes: number;
+    readonly maxPathLength: 1024;
+    readonly maxBuiltinNameLength: 256;
+};
+export type AppArtifactKind = 'esm' | 'commonjs';
+export interface AppRuntimeArtifact {
+    readonly path: string;
+    readonly kind: AppArtifactKind;
+    readonly source: string;
+}
+export interface AppRuntimeReferenceInput {
+    readonly artifacts: readonly AppRuntimeArtifact[];
+    readonly closurePaths: readonly string[];
+    readonly builtins: readonly string[];
+}
+export interface AppRuntimeLocation {
+    readonly offset: number;
+    readonly line: number;
+    readonly column: number;
+}
+export type AppRuntimeReferenceKind = 'import' | 'reexport' | 'dynamic-import' | 'url-import' | 'require' | 'worker';
+export type AppRuntimeTarget = {
+    readonly path: string;
+} | {
+    readonly builtin: string;
+};
+export interface AppRuntimeReference {
+    readonly from: string;
+    readonly kind: AppRuntimeReferenceKind;
+    readonly target: AppRuntimeTarget;
+    readonly loc: AppRuntimeLocation;
+}
+export type AppRuntimeReferenceResult = {
+    readonly ok: true;
+    readonly references: readonly AppRuntimeReference[];
+} | {
+    readonly ok: false;
+    readonly code: AppRuntimeRefusalCode;
+    readonly path: string;
+    readonly loc?: AppRuntimeLocation;
+    readonly detail: string;
+};

package/dist/app-artifact-policy/helper.d.ts

@@ -0,0 +1,15 @@
+import { type Ast } from './scan.js';
+export interface BannerMatch {
+    readonly importDeclaration: Ast;
+    readonly importLocal: Ast;
+    readonly calleeNode: Ast;
+    readonly requireId: Ast;
+}
+export interface HelperMatch {
+    readonly bindingId: Ast;
+    readonly start: number;
+    readonly end: number;
+}
+export declare function matchBanner(body: readonly unknown[]): BannerMatch | undefined;
+export declare function matchHelper(body: readonly unknown[]): HelperMatch | undefined;
+export declare function isImportMetaUrl(value: unknown): value is Ast;

package/dist/app-artifact-policy/index.d.ts

@@ -0,0 +1,3 @@
+export { checkAppRuntimeReferences } from './check.js';
+export { APP_RUNTIME_LIMITS, APP_RUNTIME_POLICY_VERSION, APP_RUNTIME_REFUSAL_CODES } from './contract.js';
+export type { AppArtifactKind, AppRuntimeArtifact, AppRuntimeLocation, AppRuntimeReference, AppRuntimeReferenceInput, AppRuntimeReferenceKind, AppRuntimeReferenceResult, AppRuntimeRefusalCode, AppRuntimeTarget, } from './contract.js';