@crewx/sdk 0.9.0-rc.2 → 0.9.0-rc.200

package/dist/app/context.d.ts

@@ -0,0 +1,2 @@
+import type { AppContext } from './app.js';
+export declare function readAppContext(env?: NodeJS.ProcessEnv): AppContext | undefined;

package/dist/app/entry.d.ts

@@ -0,0 +1,9 @@
+import type { JsonObject } from './app.js';
+import type { RunSkillAppOptions } from './runtime.js';
+export interface AppEntryOptions {
+    readonly sanitize?: (value: unknown) => unknown;
+    readonly emptyState?: JsonObject;
+    readonly inputFd?: number;
+    readonly jobBridge?: RunSkillAppOptions['jobBridge'];
+}
+export declare function runAppEntry(importApp: () => Promise<unknown>, options?: AppEntryOptions): Promise<void>;

package/dist/app/frame.d.ts

@@ -0,0 +1,55 @@
+import type { ContentRange, ContentRangeRequest, JsonObject } from './app.js';
+import type { UiContentMediaType } from './protocol.js';
+export declare const MAX_REQUEST_BYTES: number;
+export type RequestFrame = {
+    readonly kind: 'v1';
+    readonly value: unknown;
+} | {
+    readonly kind: 'v2';
+    readonly header: JsonObject;
+    readonly body: Uint8Array;
+} | {
+    readonly kind: 'invalid';
+};
+export declare function readStdinBytes(fd: number, maxBytes: number): Uint8Array | undefined;
+export declare function readRequestFrame(fd: number): RequestFrame;
+export declare function parseRequestFrame(bytes: Uint8Array | undefined): RequestFrame;
+export interface ContentRequest {
+    readonly in?: {
+        readonly mediaType: UiContentMediaType;
+        readonly text: string;
+    };
+    readonly out?: {
+        readonly mediaType: UiContentMediaType;
+        readonly range?: ContentRangeRequest;
+    };
+}
+export interface VerifiedFrame {
+    readonly actionId: string;
+    readonly input: JsonObject;
+    readonly state: JsonObject;
+    readonly content: ContentRequest;
+}
+export interface FrameFailure {
+    readonly code: string;
+    readonly outcome: 'failed' | 'rejected';
+}
+export declare function verifyRequestFrame(header: JsonObject, body: Uint8Array): VerifiedFrame | FrameFailure;
+export declare function isFrameFailure(value: VerifiedFrame | FrameFailure): value is FrameFailure;
+export interface DeclaredContent {
+    readonly in?: {
+        readonly mediaType: UiContentMediaType;
+        readonly required?: boolean;
+    };
+    readonly out?: {
+        readonly mediaType: UiContentMediaType;
+        readonly range?: boolean;
+    };
+}
+export declare function checkAgainstDeclaration(declared: DeclaredContent | undefined, request: ContentRequest): FrameFailure | undefined;
+export interface AnswerContent {
+    readonly body: Uint8Array;
+    readonly range?: ContentRange;
+}
+export declare function encodeResponseFrame(header: JsonObject, answer?: AnswerContent): Uint8Array;
+export declare function answerLimitFailure(answer: AnswerContent): FrameFailure | undefined;

package/dist/app/index.d.ts

@@ -0,0 +1,20 @@
+export { AppError, CrewXApp, Tool, generateManifest, generateToolDeclarations, getToolDeclarations, } from './app.js';
+export type { AppContext, AppDefinition, AppErrorContext, AppErrorMapping, AppErrorOptions, AppFailureOutcome, AppRuntimeOptions, ContentRange, ContentRangeRequest, CrewXAppConstructor, DeepReadonly, JsonObject, JsonSchema, ToolContent, ToolContentDeclaration, ToolContentInput, ToolContentOutput, ToolDeclaration, ToolOptions, ToolResult, } from './app.js';
+export { readAppContext } from './context.js';
+export { APP_SCHEDULE_ACTOR_KIND, APP_SCHEDULE_INERT_COMMAND, APP_SCHEDULE_INSTANCE_PREFIX, APP_SCHEDULE_INTERVALS_MINUTES, APP_SCHEDULE_MAX_PER_APP, APP_SCHEDULE_PERIODIC_REASONS, APP_SCHEDULE_TIMEOUT_MS, SCHEDULE_TRIGGERS, isAppSchedulePeriodicReason, isAppScheduleCode, isAppScheduleIntervalMinutes, isAppScheduleTimeoutMs, } from './schedule-contract.js';
+export type { AppScheduleDirective, AppScheduleIntervalMinutes, AppSchedulePeriodic, AppSchedulePeriodicReason, AppScheduleRunVerdict, AppScheduleSnapshot, AppScheduleStatus, ScheduleTrigger, ToolScheduleDeclaration, } from './schedule-contract.js';
+export { APP_TOOLS_FILE, APP_TOOLS_SCHEMA_VERSION, APP_TOOL_ENTRY } from './tool-mode.js';
+export { SKILL_BACKEND_ENV_NAMES, isSkillBackendEnv } from './backend-env.js';
+export { APP_FILES_ERROR_CODES, APP_FILES_LIMITS, APP_FILES_LOCK_SUBPATH, APP_FILES_ROOT_ENV, AppFilesError, acquireFileLock, appFiles, appFilesLockKeyOf, appFilesRootSegmentsOf, normalizeAppFilesRef, releaseFileLock, } from './app-files/index.js';
+export type { AppFiles, AppFilesErrorCode, AppFilesHost, AppFilesInstallOrigin, AppFilesListItem, AppFilesListInput, AppFilesOptions, AppFilesPage, AppFilesRead, AppFilesSource, AppFilesWritten, HeldFileLock, } from './app-files/index.js';
+export type { SkillBackendEnvName } from './backend-env.js';
+export { executeAppRequest, runSkillApp } from './runtime.js';
+export type { AppFailureInfo, RunSkillAppOptions } from './runtime.js';
+export { runAppEntry } from './entry.js';
+export type { AppEntryOptions } from './entry.js';
+export { APP_JOB_CAPABILITY, APP_JOB_CAPABILITY_VERSION, APP_JOB_DEADLINE_MS, APP_JOB_MAX_PER_APP, APP_JOB_OPERATIONS, APP_JOB_OUTCOMES, APP_JOB_RUN_REQUIRED, APP_JOB_REFUSAL_CODES, APP_JOB_STATES, APP_JOB_STOP_GRACE_MS, APP_JOB_STOP_REASONS, APP_JOB_TRIGGERS, hasAppJobCapability, isAppJobCode, isAppJobDeadlineMs, isAppJobOperation, isAppJobPhase, } from './job-contract.js';
+export type { AppJobCapabilityDeclaration, AppJobOperation, AppJobOutcome, AppJobRefusalCode, AppJobState, AppJobStopReason, AppJobTrigger, ToolJobDeclaration, } from './job-contract.js';
+export { APP_JOB_BRIDGE_CHANNEL_MAX_BYTES, APP_JOB_BRIDGE_DRAIN_TIMEOUT_MS, APP_JOB_BRIDGE_ENV, APP_JOB_BRIDGE_ERROR_CODES, APP_JOB_BRIDGE_FD, APP_JOB_BRIDGE_MAX_LINE_BYTES, APP_JOB_BRIDGE_REPLY_TIMEOUT_MS, APP_JOB_BRIDGE_VERSION, AppJobLineReader, appJobTriggerForActor, buildAppJobChannelEnvironment, encodeAppJobLine, parseAppJobChannel, parseAppJobControlReply, parseAppJobControlRequest, parseAppJobRunPush, parseAppJobRunReport, parseAppJobView, readAppJobChannel, } from './job-wire.js';
+export type { AppJobBridgeErrorCode, AppJobChannel, AppJobControlReply, AppJobControlRequest, AppJobLineEvent, AppJobRunPush, AppJobRunReport, AppJobView, AppJobWireHandle, } from './job-wire.js';
+export { AppJobBridge, openInheritedAppJobTransport } from './job-bridge.js';
+export type { AppJobBridgeOptions, AppJobLineTransport, AppJobProgress, AppJobRun, AppJobStartOutcome, AppJobStatusOutcome, AppJobStopOutcome, AppJobs, AppJobTransportOpener, } from './job-bridge.js';

package/dist/app/index.js

@@ -0,0 +1,13 @@
+'use strict';var fs=require('fs'),path=require('path'),util=require('util'),child_process=require('child_process'),crypto=require('crypto'),os=require('os'),net=require('net'),console$1=require('console'),stream=require('stream');var L=["text/plain","application/json"];var W=[5,15,30,60],v=Object.freeze({min:15e3,max:6e5,default:3e5}),It=1,Be="schedule:",Pt="schedule",Tt="exit 78",Sn=["standby","disabled","draining","degraded"],Ct=["cron","cron_manual","app_enable"],kt=/^[A-Z][A-Z0-9_]{0,63}$/u;function Rn(n){return typeof n=="string"&&kt.test(n)}var On=["status","everyMinutes","lastStartedAt","lastFinishedAt","lastOutcome","lastErrorCode","nextRunAt","periodic","periodicReason"],Nt=["unset","on","off"],Jt=["available","unavailable"],Me=64,Dt=128;function In(n){return W.includes(n)}function Ue(n){return Number.isSafeInteger(n)&&n>=v.min&&n<=v.max}function Pn(n){return Sn.includes(n)}function Tn(n){if(!xt(n)||Object.keys(n).length!==On.length||!On.every(r=>Object.hasOwn(n,r))||typeof n.status!="string"||!Nt.includes(n.status)||!In(n.everyMinutes)||!ue(n.lastStartedAt,Me)||!ue(n.lastFinishedAt,Me)||!ue(n.lastOutcome,Dt)||!ue(n.nextRunAt,Me)||n.lastErrorCode!==null&&!Rn(n.lastErrorCode)||typeof n.periodic!="string"||!Jt.includes(n.periodic))return;let t=n.periodic;if(!(t==="available"?n.periodicReason!==null:!Pn(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 ue(n,e){return n===null||typeof n=="string"&&n.length>0&&n.length<=e}function xt(n){if(n===null||typeof n!="object"||Array.isArray(n))return  false;let e=Object.getPrototypeOf(n);return e===Object.prototype||e===null}var j=Object.freeze({min:6e4,max:18e5,default:6e5}),Ft=Object.freeze({min:1e3,max:12e4,default:3e4}),Lt=1,Cn="crewx/appJobs",kn=1,He=["starting","running","stopping","finished"],qe=["succeeded","failed","timed_out","cancelled","shutdown","interrupted"],le=["cancelled","timed_out","shutdown"],Ve=["manual","schedule"],vt=/^[a-z][a-z0-9_]{0,63}$/u,jt=/^[A-Z][A-Z0-9_]{0,63}$/u,pe=["start","status","cancel"],Xe=["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"],Ge="APP_JOB_RUN_REQUIRED";function We(n){return Number.isSafeInteger(n)&&n>=j.min&&n<=j.max}function M(n){return typeof n=="string"&&jt.test(n)}function B(n){return typeof n=="string"&&vt.test(n)}function z(n){return pe.includes(n)}function Mt(n){return n?.some(({name:e,version:t})=>e===Cn&&t===kn)===true}var Nn=Symbol;Nn.metadata===void 0&&Object.defineProperty(Symbol,"metadata",{configurable:false,value:Symbol.for("Symbol.metadata")});var Bt=Nn.metadata,$=Symbol.for("crewx.app.tool-metadata"),c=class extends Error{code;detail;outcome;constructor(e,t=null,r){super(e),this.name="AppError",this.code=e,this.detail=t,this.outcome=$e(r?.outcome);}};function $e(n){return n==="rejected"?"rejected":"failed"}var ze=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:Wt(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 c("SCHEDULE_UNSUPPORTED","this App has no schedule on this Host");let t=this.callContext?.actor;if(t==="schedule")throw new c("SCHEDULE_UNSUPPORTED","a scheduled run cannot change its own schedule",{outcome:"rejected"});if(e&&t!=="user")throw new c("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&&!$t(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,r){}mapError(e){return {code:"EXECUTION_FAILED",detail:null}}errorState(e,t,r){return {...w(r.state)?r.state:{},error:{code:e,detail:t}}}};function Ut(n){return function(e,t){if(t.static||t.private||t.kind!=="method")throw new TypeError("@Tool can decorate public instance methods only");let r=t.metadata;if(!r)throw new TypeError("standard decorator metadata is unavailable");let o=Object.hasOwn(r,$)?r[$]:[];if(o.some(p=>p.methodName===String(t.name)))throw new TypeError(`@Tool is declared more than once for ${String(t.name)}`);let i=n.content===void 0?void 0:qt(n.name,n.content);if(n.viewCall!==void 0&&(n.viewCall!==true||n.mutation!==false||n.confirmation!==void 0&&n.confirmation!=="none"||n.resultProjection===void 0||i!==void 0||n.schedule!==void 0||n.job!==void 0||n.jobAccess!==void 0))throw new TypeError(`@Tool ${n.name}: viewCall requires mutation false, confirmation none, resultProjection, and no content, job, or schedule`);let s=n.schedule===void 0?void 0:Vt(n);if(s!==void 0&&o.some(p=>p.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:Xt(n);if(a!==void 0&&o.some(p=>p.options.job!==void 0))throw new TypeError(`@Tool ${n.name}: an App declares at most one job action`);let d=n.jobAccess===void 0?void 0:Gt(n);r[$]=[...o,{methodName:String(t.name),options:Object.freeze({...n,...i===void 0?{}:{content:i},...s===void 0?{}:{schedule:s},...a===void 0?{}:{job:a},...d===void 0?{}:{jobAccess:d}})}];}}function K(n){let e=n[Bt],t=e&&Object.hasOwn(e,$)?e[$]:[],r=new Map(t.map(i=>[i.methodName,i])),o=Object.getOwnPropertyNames(n.prototype).map(i=>r.get(i)).filter(i=>i!==void 0);if(o.length!==t.length)throw new TypeError("a @Tool method is missing from the App prototype");return o}function Jn(n){return K(n).some(({options:e})=>e.schedule!==void 0)}function Dn(n){let e=n.definition,t=K(n),r=new Set;return t.map(({options:o})=>{if(r.has(o.name))throw new TypeError(`duplicate @Tool name: ${o.name}`);return r.add(o.name),{actionId:o.name,...o.dataInputs===void 0?{}:{dataInputs:[...o.dataInputs]},confirmation:o.confirmation??"none",capability:o.capability??"app.read",mutation:o.mutation??true,inputSchema:o.inputSchema,...o.viewCall===true?{viewCall:true}:{},...o.content===void 0?{}:{content:zt(o.content)},...o.schedule===void 0?{}:{schedule:{...o.schedule}},...o.job===void 0?{}:{job:{...o.job}},...o.jobAccess===void 0?{}:{jobAccess:[...o.jobAccess]},resultProjection:o.resultProjection??{allow:[...e.stateProjection.allow]},_meta:{description:o.description}}})}function Ht(n,e){if(e.length===0)throw new TypeError("backendCommand must name the skill command");let t=Dn(n);if(t.some(o=>o.viewCall===true))throw new TypeError("viewCall is available only to a server.ts screen App");let r=t.map(({_meta:o,...i})=>({...i,backend:{type:"skill",command:[...e]},_meta:o}));return {...n.definition,actions:r}}function qt(n,e){let t=i=>{throw new TypeError(`@Tool ${n}: content ${i}`)},r=(i,s,a)=>{if(!w(a))return t(`${i} must be an object`);for(let d of Object.keys(a))if(d==="mediaType"){if(!L.includes(a[d]))return t(`${i}.mediaType must be one of ${L.join(", ")}`)}else if(d===s){if(typeof a[d]!="boolean")return t(`${i}.${d} must be true or false`)}else return t(`${i} has the unknown key "${d}"`);return Object.hasOwn(a,"mediaType")?Object.freeze({...a}):t(`${i}.mediaType is required`)};if(!w(e))return t("must be an object");let o={};for(let i of Object.keys(e))if(i==="in")o[i]=r("in","required",e[i]);else if(i==="out")o[i]=r("out","range",e[i]);else return t(`has the unknown key "${i}"; use "in" and/or "out"`);return Object.keys(o).length===0?t('needs "in" and/or "out"'):Object.freeze(o)}function Vt(n){let e=r=>{throw new TypeError(`@Tool ${n.name}: schedule ${r}`)},t=n.schedule;if(!w(t))return e("must be an object");for(let r of Object.keys(t))if(r!=="everyMinutes"&&r!=="timeoutMs")return e(`has the unknown key "${r}"`);return W.includes(t.everyMinutes)?t.timeoutMs!==void 0&&!Ue(t.timeoutMs)?e(`timeoutMs must be an integer from ${v.min} to ${v.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 ${W.join(", ")}`)}function Xt(n){let e=r=>{throw new TypeError(`@Tool ${n.name}: job ${r}`)},t=n.job;if(!w(t))return e("must be an object");for(let r of Object.keys(t))if(r!=="deadlineMs")return e(`has the unknown key "${r}"`);return t.deadlineMs!==void 0&&!We(t.deadlineMs)?e(`deadlineMs must be an integer from ${j.min} to ${j.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 Gt(n){let e=r=>{throw new TypeError(`@Tool ${n.name}: jobAccess ${r}`)},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(z)?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 Wt(n){return Object.freeze({instanceId:n.instanceId,threadId:n.threadId,actor:n.actor,requestId:n.requestId,nowMs:n.nowMs})}function zt(n){let e={};for(let[t,r]of Object.entries(n))e[t]={...r};return e}function $t(n){return w(n)&&["startLine","lineCount","totalLines"].every(e=>Number.isSafeInteger(n[e])&&n[e]>=1)}function w(n){if(n===null||typeof n!="object"||Array.isArray(n))return  false;let e=Object.getPrototypeOf(n);return e===Object.prototype||e===null}var Kt=/^[A-Za-z0-9._:-]{1,128}$/u,Yt=/[\u0000-\u001f\u007f\u2028\u2029]/u,Zt=512;function Ke(n=process.env){let e=xn(n.CREWX_APP_INSTANCE_ID),t=n.CREWX_APP_REQUEST_ID,r=n.CREWX_APP_ACTOR_KIND,o=n.CREWX_APP_NOW_MS;if(e===void 0||typeof t!="string"||!Kt.test(t)||r!=="user"&&r!=="agent"&&r!=="schedule"||typeof o!="string"||!/^\d{1,16}$/u.test(o))return;let i=Number(o);if(!Number.isSafeInteger(i))return;let s=n.CREWX_THREAD_ID===void 0?null:xn(n.CREWX_THREAD_ID);if(s!==void 0&&!(r==="schedule"&&(s!==null||!e.startsWith(Be))))return Object.freeze({instanceId:e,threadId:s,actor:r,requestId:t,nowMs:i})}function xn(n){if(!(typeof n!="string"||n.length===0||Yt.test(n)))return new TextEncoder().encode(n).byteLength<=Zt?n:void 0}var Qt="dist/tools.json",er=1,nr="dist/main.mjs";var Fn=["CREWX_APP_INSTANCE_ID","CREWX_THREAD_ID"];function tr(n){if(!Array.isArray(n)||n.length===0)return  false;let e=new Set;for(let t of n){if(!Fn.some(r=>r===t)||e.has(t))return  false;e.add(t);}return  true}var Ln=["INVALID_REF","FILE_NOT_FOUND","DOCUMENT_CHANGED","TOO_LARGE","IO_ERROR","FILE_BUSY"],u=class extends Error{code;constructor(e){super(e),this.name="AppFilesError",this.code=e;}};var S={textBytes:256*1024,refCodePoints:200,refSegments:3,pageSize:200},U=/^[\p{L}\p{N}][\p{L}\p{N}\p{M}_-]{0,99}$/u,D=()=>{throw new u("INVALID_REF")};function Y(n){let e=n.normalize("NFC");if([...e].length>S.refCodePoints)return;let t=e.split("/");if(t.length>S.refSegments)return;let r=t[t.length-1];return r.endsWith(".md")&&[...t.slice(0,-1),r.slice(0,-3)].every(i=>U.test(i))?e:void 0}function Z(n){return typeof n!="string"?D():Y(n)??D()}function vn(n){if(n==null||n==="")return "";if(typeof n!="string")return D();let e=n.normalize("NFC");if([...e].length>S.refCodePoints)return D();let t=(e.endsWith("/")?e.slice(0,-1):e).split("/");return t.length>S.refSegments-1||!t.every(r=>U.test(r))?D():`${t.join("/")}/`}function jn(n){if(typeof n!="string")return D();if(Buffer.byteLength(n,"utf8")>S.textBytes)throw new u("TOO_LARGE");return n}function Mn(n){return n===null?null:typeof n=="string"&&n.length<=S.refCodePoints?n:D()}var ye=path.join("locks","files"),ne=12e3,{link:ur,mkdir:lr,open:pr,readFile:Qe,unlink:ee}=fs.promises,cr=5,fr=50,yr=1e3,Ar=2e3,mr="/bin/ps",br={LC_ALL:"C",TZ:"UTC"},hr=100,gr=19,_r=/^[A-Za-z]{3} ([A-Za-z]{3}) +(\d{1,2}) (\d{2}):(\d{2}):(\d{2}) (\d{4})$/,Er=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],wr=util.promisify(child_process.execFile),Bn,ce;function en(n=process.env){if(n.CREWX_HOME){let e=path.resolve(n.CREWX_HOME);try{return fs.realpathSync(e)}catch(t){if(t.code==="ENOENT")return e;throw t}}return process.platform!=="win32"&&n.XDG_CONFIG_HOME?path.join(n.XDG_CONFIG_HOME,"crewx"):path.join(os.homedir(),".crewx")}async function Ae(n){let{lockDir:e,key:t}=n,r=path.join(e,Or(t)),o=Date.now()+n.waitMs,i=await qn(e,{token:crypto.randomUUID(),pid:process.pid,startedAtMs:await Xn()}),s=new Ye;try{let a=cr;for(;;){if(await Vn(i.staged,r))return {path:r,token:i.record.token};let d=await fe(r);if(d!=="vanished"&&!(d!=="unreadable"&&await s.isDead(d)&&await Pr(e,r,d,s))){if(Date.now()>=o)throw new u("FILE_BUSY");await Jr(a),a=Math.min(a*2,fr);}}}finally{await ee(i.staged).catch(()=>{});}}async function me(n){await Ze(n.path,n.token);}function Or(n){return crypto.createHash("sha256").update(n,"utf8").digest("hex")}async function qn(n,e){let t=path.join(n,`.${e.token}.tmp`);try{await lr(n,{recursive:!0}),await Sr(t,JSON.stringify(e));}catch{throw await ee(t).catch(()=>{}),new u("IO_ERROR")}return {record:e,staged:t}}async function Sr(n,e){let t=await pr(n,"wx");try{await t.writeFile(e),await t.sync();}finally{await t.close();}}async function Vn(n,e){try{return await ur(n,e),!0}catch(t){if(t.code==="EEXIST")return  false;throw new u("IO_ERROR")}}async function fe(n){let e;try{e=await Qe(n,"utf8");}catch(t){return t.code==="ENOENT"?"vanished":"unreadable"}try{let t=JSON.parse(e);return Rr(t)?t:"unreadable"}catch{return "unreadable"}}function Rr(n){if(typeof n!="object"||n===null||Array.isArray(n))return  false;let e=n;return typeof e.token=="string"&&e.token.length>0&&typeof e.pid=="number"&&Number.isSafeInteger(e.pid)&&e.pid>0&&(e.startedAtMs===null||Number.isSafeInteger(e.startedAtMs))}async function Ir(n){try{process.kill(n.pid,0);}catch(t){return t.code==="ESRCH"}if(n.startedAtMs===null)return  false;let e=await Gn(n.pid);return e!==null&&e!==n.startedAtMs}var Ye=class{constructor(e=Ir,t=Date.now){this.check=e;this.now=t;}check;now;answers=new Map;async isDead(e){let t=this.now(),r=this.answers.get(e.token);if(r!==void 0&&t-r.at<yr)return r.dead;let o=await this.check(e);return this.answers.set(e.token,{at:t,dead:o}),o}};async function Pr(n,e,t,r){let o=`${e}.reclaim`,i=await qn(n,{token:crypto.randomUUID(),pid:process.pid,startedAtMs:await Xn()});try{if(!await Vn(i.staged,o)){let s=await fe(o);return s!=="vanished"&&s!=="unreadable"&&await r.isDead(s)&&await Ze(o,s.token),!1}try{let s=await fe(e);return typeof s!="object"||s.token!==t.token?!1:(await ee(e).catch(()=>{}),!0)}finally{await Ze(o,i.record.token);}}finally{await ee(i.staged).catch(()=>{});}}async function Ze(n,e){let t=await fe(n);typeof t=="object"&&t.token===e&&await ee(n).catch(()=>{});}function Xn(){return (ce===void 0||ce.pid!==process.pid)&&(ce={pid:process.pid,startedAtMs:Gn(process.pid)}),ce.startedAtMs}async function Gn(n){return process.platform==="linux"&&(Bn??=await fs.promises.access("/proc/self/stat").then(()=>true,()=>false),Bn)?Tr(n):kr(n)}async function Tr(n){try{let e=await Qe(`/proc/${n}/stat`,"utf8"),t=e.slice(e.lastIndexOf(")")+2).split(" "),r=Number(t[gr]),o=await Cr();return !Number.isSafeInteger(r)||o===void 0?null:o*1e3+r*1e3/hr}catch{return null}}async function Cr(){let n=(await Qe("/proc/stat","utf8")).split(`
+`).find(t=>t.startsWith("btime ")),e=Number(n?.slice(6));return Number.isSafeInteger(e)?e:void 0}async function kr(n){try{let{stdout:e}=await wr(mr,["-o","lstart=","-p",String(n)],{env:br,encoding:"utf8",timeout:Ar});return Nr(e.trim())}catch{return null}}function Nr(n){let e=_r.exec(n);if(e===null)return null;let t=Er.indexOf(e[1]);return t<0?null:Date.UTC(Number(e[6]),t,Number(e[2]),Number(e[3]),Number(e[4]),Number(e[5]))}function Jr(n){return new Promise(e=>setTimeout(e,n))}var Fr=[".git",".crewx","node_modules","apps","skills"],{lstat:Lr,readFile:vr}=fs.promises,jr=4,Mr=200,Br=1024*1024,Wn=/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;function Ur(n){return ["docs","apps",n]}function zn(n){let e={segments:Ur(n.appId),declared:false};if(n.origin!=="not_installed"||n.source!=="workspace"&&n.source!=="bundled"||n.declared===void 0||n.declared===null)return e;let t=Hr(n.declared);return t.ok?n.packageRelativePath!==void 0&&qr(t.segments,Vr(n.packageRelativePath))?{...e,warning:"FILES_ROOT_FORBIDDEN"}:{segments:t.segments,declared:true}:{...e,warning:t.warning}}async function $n(n){let e={appId:void 0,declared:void 0};try{let t=path.join(n,"manifest.json"),r=await Lr(t);if(!r.isFile()||r.size>Br)return e;let o=JSON.parse(await vr(t,"utf8"));if(!be(o))return e;let i=o.name,s=typeof i=="string"&&Wn.test(i)?i:void 0,a=o._meta,d=be(a)?a["dev.crewx"]:void 0,p=be(d)?d.files:void 0;return {appId:s,declared:p}}catch{return e}}function Hr(n){return !be(n)||Object.keys(n).some(e=>e!=="root")||typeof n.root!="string"?{ok:false,warning:"FILES_ROOT_INVALID"}:Yn(n.root.normalize("NFC"),Kn)}function he(n){if(n.normalize("NFC")!==n)return;let e=Yn(n,t=>Kn(t)||Wn.test(t));return e.ok?e.segments:void 0}function Kn(n){return U.test(n)}function Yn(n,e){let t={ok:false,warning:"FILES_ROOT_INVALID"},r={ok:false,warning:"FILES_ROOT_FORBIDDEN"};if([...n].length>Mr)return t;let o=n.split("/");return o.length>jr||!o.every(e)?t:o.length===1||Fr.includes(o[0].toLowerCase())?r:{ok:true,segments:o}}function qr(n,e){let t=Math.min(n.length,e.length);for(let r=0;r<t;r+=1)if(n[r].toLowerCase()!==e[r].toLowerCase())return  false;return t>0}function Vr(n){return n.normalize("NFC").split("/").filter(e=>e.length>0)}function be(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}var{lstat:Kr,mkdir:Yr,open:Zr,readdir:Qr,rename:eo,stat:no,unlink:nt}=fs.promises;function te(n){return `sha256:${crypto.createHash("sha256").update(n).digest("hex")}`}function tn(n,e){return e===n||e.startsWith(n.endsWith(path.sep)?n:n+path.sep)}var Ee=class{constructor(e={},t){this.hooks=e;this.lockDir=t.lockDir,this.lockWaitMs=t.lockWaitMs??ne;}hooks;lockDir;lockWaitMs;async list(e,t,r){let o=t===""?[]:t.slice(0,-1).split("/"),i=await ge(e.workspaceReal,[...e.segments,...o]);if(i.status!=="complete")return {items:[],next:null};let s=await nn(e),a=await uo(s,i.dir,t);a.sort((y,l)=>Qn(y.ref,l.ref));let d=r===void 0?a:a.filter(y=>Qn(y.ref,r)>0),p=d.slice(0,S.pageSize),f=[];for(let y of p){let l=await this.readVerified(s,y.abs);f.push({ref:y.ref,version:te(l.bytes),bytes:l.bytes.length,modifiedAt:l.stat.mtime.toISOString()});}return {items:f,next:d.length>p.length?p[p.length-1].ref:null}}async read(e,t){let r=t.split("/"),o=await ge(e.workspaceReal,[...e.segments,...r.slice(0,-1)]);if(o.status!=="complete")throw new u("FILE_NOT_FOUND");let i=await _e(o.dir,r[r.length-1]);if(!i)throw new u("FILE_NOT_FOUND");if(!i.stat.isFile())throw new u("IO_ERROR");let{bytes:s}=await this.readVerified(await nn(e),i.abs,S.textBytes);return {ref:t,text:yo(s),version:te(s)}}async stat(e,t){let r=t.split("/"),o=await ge(e.workspaceReal,[...e.segments,...r.slice(0,-1)]);if(o.status!=="complete")throw new u("FILE_NOT_FOUND");let i=await _e(o.dir,r[r.length-1]);if(!i)throw new u("FILE_NOT_FOUND");if(!i.stat.isFile())throw new u("IO_ERROR");let s=await this.readVerified(await nn(e),i.abs,S.textBytes);return {ref:t,version:te(s.bytes),bytes:s.bytes.length,modifiedAt:s.stat.mtime.toISOString()}}async write(e,t,r,o){let i=t.split("/"),s=i[i.length-1],a=new Uint8Array(Buffer.from(r,"utf8"));return this.withFileLock(await oo(e,t),async()=>{let d=await ge(e.workspaceReal,[...e.segments,...i.slice(0,-1)]);if(d.status==="blocked")throw new u("IO_ERROR");let p=await we(d.dir),f=d.status==="complete"?await _e(d.dir,s):void 0;if(f&&!f.stat.isFile())throw new u("IO_ERROR");if((f?te((await this.readVerified(p.real,f.abs)).bytes):null)!==o)throw new u("DOCUMENT_CHANGED");let l=await this.createFolders(p,d.status==="missing"?d.missing:[]);await ro(l,s);let b=f?.abs??path.join(l.path,s);return await this.writeAtomically(l,b,s,a,f?.stat),{ref:t,version:te(a)}})}async readVerified(e,t,r){return await this.hooks.beforeOpen?.(t),so(e,t,r)}async createFolders(e,t){let r=e;for(let o of t){let i=path.join(r.path,o);await this.hooks.beforeMkdir?.(i);try{await Yr(i);}catch(s){if(s.code!=="EEXIST")throw new u("IO_ERROR")}r=await ao(r,i);}return r}async writeAtomically(e,t,r,o,i){let s=path.join(e.path,to(r)),a;try{await this.hooks.beforeOpen?.(s),a=await tt(s,fs.constants.O_CREAT|fs.constants.O_EXCL|fs.constants.O_WRONLY),await a.writeFile(o),i!==void 0&&await a.chmod(i.mode&4095),await a.sync(),await a.close(),a=void 0,await on(e),await eo(s,t);}catch(d){throw await a?.close().catch(()=>{}),await nt(s).catch(()=>{}),d instanceof u?d:new u("IO_ERROR")}}async withFileLock(e,t){let r=await Ae({lockDir:this.lockDir,key:e,waitMs:this.lockWaitMs});try{return await t()}finally{await me(r);}}};function to(n){return `.${n}.crewx-${crypto.randomUUID()}.tmp`}async function ro(n,e){let t=`.${e}.crewx-`;for(let r of await an(n.path))r.normalize("NFC").startsWith(t)&&r.endsWith(".tmp")&&await nt(path.join(n.path,r)).catch(()=>{});}async function rn(n){return (await io(n)).normalize("NFC").toLowerCase()}async function oo(n,e){return rn(path.join(n.workspaceReal,...n.segments,...e.split("/")))}async function io(n){let e=[],t=n;for(;;)try{return path.join(await rt(t),...e.reverse())}catch{let r=path.dirname(t);if(r===t)throw new u("IO_ERROR");e.push(path.basename(t)),t=r;}}async function so(n,e,t){let r=await tt(e,fs.constants.O_RDONLY);try{let o=await r.stat();if(!o.isFile())throw new u("IO_ERROR");if(t!==void 0&&o.size>t)throw new u("TOO_LARGE");let i=fo(await r.readFile());return await po(n,e,o),{bytes:i,stat:o}}finally{await r.close();}}async function nn(n){let e=await sn(path.join(n.workspaceReal,...n.segments));if(!tn(n.workspaceReal,e))throw new u("INVALID_REF");return e}async function _e(n,e){let t=(await an(n)).filter(i=>i.normalize("NFC")===e);if(t.length>1)throw new u("IO_ERROR");let r=path.join(n,t[0]??e),o=await dn(r);if(o){if(o.isSymbolicLink())throw new u("INVALID_REF");return {abs:r,stat:o}}}async function ge(n,e){let t=n;for(let r=0;r<e.length;r+=1){let o=await _e(t,e[r]);if(!o)return {status:"missing",dir:t,missing:e.slice(r)};if(!o.stat.isDirectory())return {status:"blocked"};t=o.abs;}return {status:"complete",dir:t}}async function ao(n,e){await on(n);let t=await we(e);if(path.dirname(t.real)!==n.real)throw new u("INVALID_REF");return t}async function uo(n,e,t){let r=[],o=s=>s===""?0:s.split("/").length-1,i=async(s,a)=>{let d=await lo(n,s),p=await an(s);await on(d);let f=new Set;for(let y of p){let l=y.normalize("NFC");if(f.has(l))throw new u("IO_ERROR");f.add(l);let b=path.join(s,y),A=await dn(b);if(!(!A||A.isSymbolicLink())){if(A.isDirectory())o(a)<S.refSegments-1&&U.test(l)&&await i(b,`${a}${l}/`);else if(A.isFile()){let m=Y(`${a}${l}`);m!==void 0&&r.push({ref:m,abs:b});}}}};return await i(e,t),r}function Qn(n,e){return n<e?-1:n>e?1:0}async function we(n){let e=await dn(n);if(e?.isSymbolicLink())throw new u("INVALID_REF");if(!e?.isDirectory())throw new u("IO_ERROR");return {path:n,real:await sn(n),dev:e.dev,ino:e.ino}}async function lo(n,e){let t=await we(e);if(!tn(n,t.real))throw new u("INVALID_REF");return t}async function on(n){let e=await we(n.path);if(e.real!==n.real||e.dev!==n.dev||e.ino!==n.ino)throw new u("INVALID_REF")}async function po(n,e,t){let r=await sn(e);if(!tn(n,r))throw new u("INVALID_REF");let o=await co(r);if(o.dev!==t.dev||o.ino!==t.ino)throw new u("INVALID_REF")}async function tt(n,e){try{return await Zr(n,e|fs.constants.O_NOFOLLOW)}catch(t){throw t.code==="ELOOP"?new u("INVALID_REF"):new u("IO_ERROR")}}async function sn(n){try{return await rt(n)}catch{throw new u("IO_ERROR")}}function rt(n){return new Promise((e,t)=>{fs.realpath.native(n,(r,o)=>r?t(r):e(o));})}async function an(n){try{return await Qr(n)}catch(e){let t=e.code;if(t==="ENOENT"||t==="ENOTDIR")return [];throw new u("IO_ERROR")}}async function dn(n){try{return await Kr(n)}catch(e){let t=e.code;if(t==="ENOENT"||t==="ENOTDIR")return;throw new u("IO_ERROR")}}async function co(n){try{return await no(n)}catch{throw new u("IO_ERROR")}}function fo(n){return new Uint8Array(n.buffer,n.byteOffset,n.byteLength)}function yo(n){try{return new TextDecoder("utf-8",{fatal:!0,ignoreBOM:!0}).decode(n)}catch{throw new u("IO_ERROR")}}var it=util.promisify(fs.realpath.native),st="CREWX_APP_FILES_ROOT";function _o(n,e={}){return {async list(t={}){let r=vn(t.prefix),o=t.after===void 0||t.after===null?void 0:Z(t.after),i=await Oe(n,e);return Se(n,e).list(i,r,o)},async read(t){let r=Z(t),o=await Oe(n,e);return Se(n,e).read(o,r)},async stat(t){let r=Z(t),o=await Oe(n,e);return Se(n,e).stat(o,r)},async write(t,r,o){let i=Z(t),s=jn(r),a=Mn(o),d=await Oe(n,e);return Se(n,e).write(d,i,s,a)}}}async function Oe(n,e){let t=await So(n.workspaceRoot),r=(e.env??process.env)[st]??e.filesRoot;if(r!==void 0)return {workspaceReal:t,segments:Eo(r)};let o=e.packageDir??process.cwd(),i=await $n(o);if(i.appId===void 0)throw new u("IO_ERROR");let s=zn({appId:i.appId,origin:e.origin??"not_installed",source:e.source??"workspace",packageRelativePath:await Oo(t,o),declared:i.declared});return {workspaceReal:t,segments:s.segments}}function Eo(n){let e=he(n);if(e===void 0)throw new u("IO_ERROR");return e}function Se(n,e){let t=path.join(e.crewxHome??en(),ye);return new Ee({},{lockDir:t,lockWaitMs:wo(n)})}function wo(n){let e;try{e=n.context?.nowMs;}catch{e=void 0;}return typeof e!="number"||!Number.isSafeInteger(e)?ne:Math.max(0,e+ne-Date.now())}async function Oo(n,e){let t;try{t=await it(e);}catch{return}let r=path.relative(n,t);if(!(r===""||r===".."||r.startsWith(`..${path.sep}`)||path.isAbsolute(r)))return r.split(path.sep).join("/")}async function So(n){try{return await it(n)}catch{throw new u("IO_ERROR")}}var Re=2,Ie=2097152;var H=2*1024*1024,Pe=2e4;function un(n){return crypto.createHash("sha256").update(n).digest("hex")}function Te(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 Po=Ie+1+H,To=64*1024,Co=10,Ce={kind:"invalid"};function ko(n,e){try{let t=[],r=0;for(;;){let s=new Uint8Array(To),a=fs.readSync(n,s,0,s.length,null);if(a===0)break;if(r+=a,r>e)return;t.push(s.subarray(0,a));}let o=new Uint8Array(r),i=0;for(let s of t)o.set(s,i),i+=s.byteLength;return o}catch{return}}function ke(n){return No(ko(n,Po))}function No(n){if(n===void 0)return Ce;let e=n.indexOf(Co);if(n.byteLength<=Ie){let r=vo(Buffer.from(n.buffer,n.byteOffset,n.byteLength).toString("utf8"));if(r.ok&&!(e>=0&&x(r.value)&&r.value.schemaVersion===Re))return {kind:"v1",value:r.value}}if(e<=0||e>Ie)return Ce;let t;try{t=JSON.parse(new TextDecoder("utf-8",{fatal:!0}).decode(n.subarray(0,e)));}catch{return Ce}return !x(t)||t.schemaVersion!==Re?Ce:{kind:"v2",header:t,body:n.subarray(e+1)}}var Jo="actionId,content,input,schemaVersion,state",Do="bytes,lines,mediaType,sha256",xo="mediaType,range",Fo=/^[a-f0-9]{64}$/u,Lo=new TextDecoder("utf-8",{fatal:true,ignoreBOM:true});function ut(n,e){let t=d=>({code:d,outcome:"rejected"});if(oe(n)!==Jo||n.schemaVersion!==Re||typeof n.actionId!="string"||!x(n.input)||!x(n.state)||!x(n.content)||oe(n.content)!=="in,out")return {code:"INPUT_INVALID",outcome:"failed"};let r=n.content,o,i=r.in;if(i===null){if(e.byteLength!==0)return t(e.byteLength>H?"CONTENT_TOO_LARGE":"CONTENT_DIGEST_MISMATCH")}else {if(!x(i)||oe(i)!==Do||!at(i.mediaType)||!dt(i.bytes,H)||!dt(i.lines,Pe)||typeof i.sha256!="string"||!Fo.test(i.sha256)||e.byteLength!==i.bytes)return t(e.byteLength>H?"CONTENT_TOO_LARGE":"CONTENT_DIGEST_MISMATCH");if(un(e)!==i.sha256||Te(e)!==i.lines)return t("CONTENT_DIGEST_MISMATCH");let d;try{d=Lo.decode(e);}catch{return t("CONTENT_ENCODING_INVALID")}o={mediaType:i.mediaType,text:d};}let s,a=r.out;if(a!==null){if(!x(a)||oe(a)!==xo||!at(a.mediaType))return t("CONTENT_SOURCE_UNSUPPORTED");let d=a.range;if(d!==null&&!jo(d))return t("CONTENT_SOURCE_UNSUPPORTED");s={mediaType:a.mediaType,...d===null?{}:{range:{startLine:d.startLine,lineCount:d.lineCount}}};}return {actionId:n.actionId,input:n.input,state:n.state,content:{...o===void 0?{}:{in:o},...s===void 0?{}:{out:s}}}}function lt(n){return Object.hasOwn(n,"code")}function pt(n,e){let t=r=>({code:r,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 Ne(n,e){let{content:t,...r}=n,o=e===void 0?r:{...r,content:{bytes:e.body.byteLength,lines:Te(e.body),sha256:un(e.body),...e.range===void 0?{}:{range:e.range}}},i=new TextEncoder().encode(`${JSON.stringify(o)}
+`);if(e===void 0)return i;let s=new Uint8Array(i.byteLength+e.body.byteLength);return s.set(i,0),s.set(e.body,i.byteLength),s}function ct(n){if(n.body.byteLength>H||Te(n.body)>Pe)return {code:"CONTENT_TOO_LARGE",outcome:"failed"}}function vo(n){try{return {ok:!0,value:JSON.parse(n)}}catch{return {ok:false}}}function oe(n){return Object.keys(n).sort().join(",")}function x(n){if(n===null||typeof n!="object"||Array.isArray(n))return  false;let e=Object.getPrototypeOf(n);return e===Object.prototype||e===null}function at(n){return typeof n=="string"&&L.includes(n)}function dt(n,e){return Number.isSafeInteger(n)&&n>=0&&n<=e}function jo(n){return x(n)&&oe(n)==="lineCount,startLine"&&Number.isSafeInteger(n.startLine)&&n.startLine>=1&&Number.isSafeInteger(n.lineCount)&&n.lineCount>=1&&n.lineCount<=Pe}var yt="CREWX_APP_JOB_CHANNEL",R=1,ie=4096,cn=1e4,fn=5e3,yn=512,ln=Object.freeze({min:3,max:16}),Mo=["APP_JOB_BRIDGE_UNAVAILABLE","APP_JOB_BRIDGE_INVALID","APP_JOB_BRIDGE_TIMEOUT","APP_JOB_BRIDGE_CLOSED"],ae=/^[A-Za-z0-9._:-]{1,128}$/u,Bo=64,At=2147483647,se=class{#e="";#n=false;push(e){let t=[],r=e;for(;;){let o=r.indexOf(`
+`);if(o===-1)return this.#n||(this.#e+=r,q(this.#e)>ie&&(t.push({kind:"oversized"}),this.#e="",this.#n=true)),t;let i=r.slice(0,o);if(r=r.slice(o+1),this.#n){this.#n=false;continue}let s=this.#e+i;this.#e="",t.push(q(s)>ie?{kind:"oversized"}:{kind:"line",line:s});}}};function xe(n){let e=JSON.stringify(n);if(q(e)>ie)throw new TypeError("App job bridge message is over the line bound");return e}function Uo(n){let e=Fe(n);if(e===void 0||e.v!==R||!mt(e.requestId)||!bt(e.seq))return;let t={v:R,requestId:e.requestId,seq:e.seq};switch(e.op){case "start":return E(e,["v","op","requestId","seq"],[])?{...t,op:"start"}:void 0;case "status":{if(!E(e,["v","op","requestId","seq"],["handle"]))return;if(e.handle===void 0)return {...t,op:"status"};let r=pn(e.handle);return r===void 0?void 0:{...t,op:"status",handle:r}}case "cancel":{if(!E(e,["v","op","requestId","seq","handle"],[]))return;let r=pn(e.handle);return r===void 0?void 0:{...t,op:"cancel",handle:r}}default:return}}function An(n){let e=Fe(n);if(e===void 0||e.v!==R||!mt(e.requestId)||!bt(e.seq))return;let t={v:R,requestId:e.requestId,seq:e.seq};if(e.ok===false)return E(e,["v","requestId","seq","ok","code"],[])&&Xe.includes(e.code)?{...t,ok:false,code:e.code}:void 0;if(e.ok===true)switch(e.op){case "start":{if(!E(e,["v","requestId","seq","ok","op","outcome","job"],[]))return;let r=Je(e.job),o=e.outcome;return r===void 0||o!=="started"&&o!=="attached"?void 0:{...t,ok:true,op:"start",outcome:o,job:r}}case "status":{if(!E(e,["v","requestId","seq","ok","op","job"],[]))return;if(e.job===null)return {...t,ok:true,op:"status",job:null};let r=Je(e.job);return r===void 0?void 0:{...t,ok:true,op:"status",job:r}}case "cancel":{if(!E(e,["v","requestId","seq","ok","op","outcome","job"],[]))return;let r=Je(e.job);return r===void 0||e.outcome!=="stopping"?void 0:{...t,ok:true,op:"cancel",outcome:"stopping",job:r}}default:return}}function Ho(n){let e=Fe(n);if(e===void 0||e.v!==R||typeof e.runId!="string"||!ae.test(e.runId)||!ve(e.generation))return;let t={v:R,runId:e.runId,generation:e.generation};switch(e.kind){case "heartbeat":return E(e,["v","kind","runId","generation"],[])?{...t,kind:"heartbeat"}:void 0;case "completed":return E(e,["v","kind","runId","generation"],[])?{...t,kind:"completed"}:void 0;case "progress":{if(!E(e,["v","kind","runId","generation","phase"],["completed","total","resumable"]))return;let{completed:r,total:o,resumable:i}=e;return !B(e.phase)||r!==void 0&&!De(r)||o!==void 0&&!De(o)||r!==void 0&&o!==void 0&&r>o||i!==void 0&&typeof i!="boolean"?void 0:{...t,kind:"progress",phase:e.phase,...r===void 0?{}:{completed:r},...o===void 0?{}:{total:o},...i===void 0?{}:{resumable:i}}}case "failed":return E(e,["v","kind","runId","generation","code","recoverable"],[])&&M(e.code)&&typeof e.recoverable=="boolean"?{...t,kind:"failed",code:e.code,recoverable:e.recoverable}:void 0;default:return}}function mn(n){let e=Fe(n);if(!(e===void 0||!E(e,["v","kind","runId","generation","reason"],[])||e.v!==R||e.kind!=="stop"||typeof e.runId!="string"||!ae.test(e.runId)||!ve(e.generation)||!le.includes(e.reason)))return {v:R,kind:"stop",runId:e.runId,generation:e.generation,reason:e.reason}}function bn(n){let e=Le(n)?n:void 0;if(!(e===void 0||e.v!==R||!Go(e.fd))){if(e.role==="control"){let t=e.operations;return !E(e,["v","role","fd","operations"],[])||!Array.isArray(t)||t.length===0||new Set(t).size!==t.length||!t.every(z)?void 0:{v:1,role:"control",fd:e.fd,operations:[...t]}}if(e.role==="run")return !E(e,["v","role","fd","runId","generation"],[])||typeof e.runId!="string"||!ae.test(e.runId)||!ve(e.generation)?void 0:{v:1,role:"run",fd:e.fd,runId:e.runId,generation:e.generation}}}function hn(n){let e=n[yt];if(typeof e!="string"||q(e)>yn)return;let t;try{t=JSON.parse(e);}catch{return}return bn(t)}function qo(n){let e=bn(JSON.parse(JSON.stringify(n)));if(e===void 0)throw new TypeError("App job channel descriptor is invalid");let t=JSON.stringify(e);if(q(t)>yn)throw new TypeError("App job channel descriptor is over its bound");return Object.freeze({CREWX_APP_JOB_CHANNEL:t})}function Vo(n){return n==="schedule"?"schedule":"manual"}function Xo(n){return Je(n)}function Je(n){let e=Le(n)?n:void 0;if(e===void 0||!E(e,["handle","state","stopReason","trigger","outcome","phase","completed","total","resumable","lastHeartbeatAt","startedAt","finishedAt","errorCode","recoverable"],[]))return;let t=pn(e.handle),r=e.stopReason,o=e.outcome,i=e.phase,s=e.errorCode,a=e.recoverable;if(!(t===void 0||!He.includes(e.state)||!(r===null||le.includes(r))||r!==null&&e.state!=="stopping"||!Ve.includes(e.trigger)||!(o===null||qe.includes(o))||!(i===null||B(i))||!(e.completed===null||De(e.completed))||!(e.total===null||De(e.total))||typeof e.resumable!="boolean"||!ft(e.lastHeartbeatAt)||!ht(e.startedAt)||!ft(e.finishedAt)||!(s===null||M(s))||!(a===null||typeof a=="boolean")))return {handle:t,state:e.state,stopReason:r,trigger:e.trigger,outcome:o,phase:i,completed:e.completed,total:e.total,resumable:e.resumable,lastHeartbeatAt:e.lastHeartbeatAt,startedAt:e.startedAt,finishedAt:e.finishedAt,errorCode:s,recoverable:a}}function pn(n){if(!(!Le(n)||!E(n,["runId","generation"],[]))&&!(typeof n.runId!="string"||!ae.test(n.runId)||!ve(n.generation)))return {runId:n.runId,generation:n.generation}}function Fe(n){if(q(n)>ie)return;let e;try{e=JSON.parse(n);}catch{return}return Le(e)?e:void 0}function E(n,e,t){let r=new Set([...e,...t]);return Object.keys(n).every(o=>r.has(o))&&e.every(o=>Object.hasOwn(n,o))}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 mt(n){return typeof n=="string"&&ae.test(n)}function bt(n){return Number.isSafeInteger(n)&&n>=1&&n<=At}function ve(n){return Number.isSafeInteger(n)&&n>=1&&n<=At}function Go(n){return Number.isSafeInteger(n)&&n>=ln.min&&n<=ln.max}function De(n){return Number.isSafeInteger(n)&&n>=0}function ht(n){return typeof n=="string"&&n.length>0&&n.length<=Bo}function ft(n){return n===null||ht(n)}function q(n){return new TextEncoder().encode(n).byteLength}var $o=2147483647,V=class{#e;#n;#l;#y=crypto.randomUUID();#A=new se;#o=new Map;#s=new Set;#t;#p=0;#r=false;#c=false;#a=false;#d=null;constructor(e){this.#e=e.channel,this.#n=e.open??_t,this.#l=e.replyTimeoutMs??cn;}jobsFor(e){let t=this.#e;if(t.role!=="control"||e===void 0)return;let r=t.operations,o=pe.filter(s=>e.includes(s)&&r.includes(s));if(o.length===0)return;let i=s=>{if(!o.includes(s))throw new c("APP_JOB_NOT_GRANTED",null,{outcome:"rejected"})};return Object.freeze({granted:Object.freeze(o),start:async()=>{i("start");let s=await this.#u("start",{});if(s.ok===false)return {kind:"refused",code:s.code};if(s.op!=="start")throw new c("APP_JOB_BRIDGE_INVALID",null,{outcome:"failed"});return {kind:s.outcome,job:s.job}},status:async s=>{i("status");let a=await this.#u("status",s===void 0?{}:{handle:s});if(a.ok===false)return {kind:"refused",code:a.code};if(a.op!=="status")throw new c("APP_JOB_BRIDGE_INVALID",null,{outcome:"failed"});return {kind:"status",job:a.job}},cancel:async s=>{i("cancel");let a=await this.#u("cancel",{handle:s});if(a.ok===false)return {kind:"refused",code:a.code};if(a.op!=="cancel")throw new c("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 r={v:R,runId:t.runId,generation:t.generation},o=()=>this.#d,i=s=>{this.#r||this.#c||this.#t===void 0||this.#t.write(xe({...r,...s}));};return Object.freeze({handle:Object.freeze({runId:t.runId,generation:t.generation}),get stopRequested(){return o()!==null},get stopReason(){return o()},progress:s=>{if(!B(s.phase))throw new TypeError("progress phase must be a lower snake case name");if(s.completed!==void 0&&!gt(s.completed))throw new TypeError("progress completed must be a count");if(s.total!==void 0&&!gt(s.total))throw new TypeError("progress total must be a count");if(s.completed!==void 0&&s.total!==void 0&&s.completed>s.total)throw new TypeError("progress completed cannot exceed total");if(s.resumable!==void 0&&typeof s.resumable!="boolean")throw new TypeError("progress resumable must be boolean");this.#a||i({kind:"progress",phase:s.phase,...s.completed===void 0?{}:{completed:s.completed},...s.total===void 0?{}:{total:s.total},...s.resumable===void 0?{}:{resumable:s.resumable}});},heartbeat:()=>{this.#a||i({kind:"heartbeat"});},complete:()=>{i({kind:"completed"}),this.#a=true;},fail:(s,a)=>{if(!M(s))throw new TypeError("fail code must be an upper snake case code");if(typeof a!="boolean")throw new TypeError("fail recoverable must be boolean");i({kind:"failed",code:s,recoverable:a}),this.#a=true;},onStop:s=>{let a=o();return a!==null?(s(a),()=>{}):(this.#s.add(s),()=>{this.#s.delete(s);})}})}close(){this.#i("APP_JOB_BRIDGE_CLOSED");}async drain(e=fn){if(this.#r)return;this.#c=true;let t=this.#t,r;try{if(t!==void 0){let o;try{o=t.drain();}catch{o=Promise.resolve();}await Promise.race([o.catch(()=>{}),new Promise(i=>{r=setTimeout(i,e);})]);}}finally{clearTimeout(r),this.close();}}#u(e,t){let r=this.#f(),o=this.#p+1;if(o>$o)throw new c("APP_JOB_BRIDGE_CLOSED",null,{outcome:"failed"});this.#p=o;let i=`${this.#y}.${o}`,s=xe({v:R,op:e,requestId:i,seq:o,...t});return new Promise((a,d)=>{let p=setTimeout(()=>this.#i("APP_JOB_BRIDGE_TIMEOUT"),this.#l);this.#o.set(o,{op:e,requestId:i,resolve:a,reject:d,timer:p}),r.write(s);})}#f(){if(this.#r)throw new c("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 c("APP_JOB_BRIDGE_UNAVAILABLE",null,{outcome:"failed"})}return e.onData(t=>this.#m(t)),e.onEnd(()=>this.#i("APP_JOB_BRIDGE_CLOSED")),this.#t=e,e}#m(e){for(let t of this.#A.push(e)){if(this.#r)return;if(this.#e.role==="run")t.kind==="line"&&this.#h(t.line);else if(t.kind==="oversized"){this.#i("APP_JOB_BRIDGE_INVALID");return}else this.#b(t.line);}}#b(e){let t=An(e),r=t===void 0?void 0:this.#o.get(t.seq);if(t===void 0||r===void 0||r.requestId!==t.requestId||t.ok&&t.op!==r.op){this.#i("APP_JOB_BRIDGE_INVALID");return}clearTimeout(r.timer),this.#o.delete(t.seq),r.resolve(t);}#h(e){let t=this.#e;if(t.role!=="run")return;let r=mn(e);if(!(r===void 0||r.runId!==t.runId||r.generation!==t.generation)&&this.#d===null){this.#d=r.reason;for(let o of [...this.#s])try{o(r.reason);}catch{}}}#i(e){if(this.#r)return;this.#r=true;let t=[...this.#o.values()];this.#o.clear();for(let o of t)clearTimeout(o.timer),o.reject(new c(e,null,{outcome:"failed"}));this.#s.clear();let r=this.#t;this.#t=void 0,r?.close();}};function _t(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 gt(n){return Number.isSafeInteger(n)&&n>=0}var Yo=1;async function Zo(n,e,t=process.env.CREWX_WORKSPACE_ROOT??process.cwd(),r){return (await Ot(n,e,t,void 0,true,void 0,r)).response}async function Ot(n,e,t,r,o=true,i,s,a){let d=i!==void 0,p=w(e)?e:void 0,f=p?.input,y=p?.state,l=new n({state:w(y)?y:{},workspaceRoot:t,...s===void 0?{}:{context:s}}),b=w(f)?f:{},A=w(y)?y:l.emptyState(),m={},I=p!==void 0&&Object.hasOwn(p,"schedule"),P;try{let _;if(d){if(p===void 0||I)throw new c("INPUT_INVALID");let O=ut(p,i);if(lt(O))throw new c(O.code,null,{outcome:O.outcome});(({actionId:_,input:b,state:A}=O)),m=O.content;}else {let O=I&&p!==void 0?Tn(p.schedule):void 0;if(!p||Object.keys(p).length!==(I?5:4)||!["schemaVersion","actionId","input","state"].every(Rt=>Object.hasOwn(p,Rt))||p.schemaVersion!==Yo||typeof p.actionId!="string"||!w(f)||!w(y)||I&&O===void 0)throw new c("INPUT_INVALID");_=p.actionId,b=f,A=y,P=O;}let h=K(n).find(({options:O})=>O.name===_);if(h?.options.viewCall===!0)throw new c("VIEW_CALL_SCREEN_ONLY","This action can only be called through the visible App screen.");let J=h===void 0?void 0:a?.jobsFor(h.options.jobAccess),T=h===void 0?void 0:a?.runFor(h.options.job!==void 0);if(l=new n({state:A,workspaceRoot:t,...s===void 0?{}:{context:s},...P===void 0?{}:{schedule:P},...J===void 0?{}:{jobs:J},...T===void 0?{}:{jobRun:T}}),await l.validate(_,b,A),!h)throw new c("INPUT_INVALID");if(P!==void 0&&(h.options.content!==void 0||!Jn(n)))throw new c("INPUT_INVALID");let X=l[h.methodName];if(typeof X!="function")throw new c("EXECUTION_FAILED");let F=pt(h.options.content,m);if(F)throw new c(F.code,null,{outcome:F.outcome});if(h.options.job!==void 0&&T===void 0)throw new c(Ge,null,{outcome:"rejected"});let de=Object.freeze({...m.in===void 0?{}:{in:Object.freeze({text:m.in.text})},...m.out===void 0?{}:{out:Object.freeze(m.out.range===void 0?{}:{range:Object.freeze({...m.out.range})})}}),G=()=>X.call(l,b,de),C=o?await ti(G):await G();if(C!==void 0&&!w(C))throw new c("EXECUTION_FAILED");let k;if(m.out!==void 0){if(k=l.producedContent,k===void 0)throw new c("EXECUTION_FAILED","content.out was requested but setContent was never called");let O=ct(k);if(O)throw new c(O.code,null,{outcome:O.outcome})}else if(l.didSetContent)throw new c("EXECUTION_FAILED","setContent was called but the request asked for no content.out");let wn=l.didRequestSchedule;return {response:{...l.didSetState?{state:l.state}:{},...C===void 0?{}:{result:C},...wn===void 0?{}:{schedule:{enabled:wn.enabled}}},...k===void 0?{}:{answer:k}}}catch(_){let h,J=_,T=_ instanceof c?_:void 0;if(T)h={code:T.code,detail:T.detail,outcome:T.outcome};else try{h=l.mapError(_);}catch(k){h={code:"EXECUTION_FAILED",detail:null},J=k;}let X=oi(h?.code),F=X?h.code:"EXECUTION_FAILED",de=typeof h?.detail=="string"?h.detail:null,G=X?$e(h.outcome):"failed",C;try{C=l.errorState(F,de,{input:b,state:A});}catch(k){J=new AggregateError([J,k],"App error handling failed"),C=l.emptyState();}return r?.(F,J,{outcome:G,detail:de,expected:T!==void 0&&J===T}),{response:{outcome:G,errorCode:F,state:w(C)?C:l.emptyState()}}}}async function Qo(n,e={}){let t=ei(e.jobBridge);try{await ni(n,e,t);}finally{await t?.drain();}}function ei(n){if(n===null)return;if(n!==void 0)return new V(n);let e=hn(process.env);return e===void 0?void 0:new V({channel:e})}async function ni(n,e,t){let r=e.output??process.stdout,o,i;if(e.preloadedInput!==void 0)o=e.preloadedInput.value,i=e.preloadedInput.body;else {let l=ke(e.inputFd??0);l.kind==="v1"?o=l.value:l.kind==="v2"&&(o=l.header,i=l.body);}let s=i!==void 0,a=e.context??Ke(),d=false,p=(l,b,A)=>{d=true,e.onFailure?.(l,b,A);},f;try{f=await Ot(n,o,process.env.CREWX_WORKSPACE_ROOT??process.cwd(),p,e.consoleManaged!==!0,i,a,t);}catch(l){p("EXECUTION_FAILED",l),f={response:Et(e.emptyState)};}ri(f.response)&&!d&&p(f.response.errorCode,void 0,{outcome:f.response.outcome,detail:null,expected:false});let y;try{let l=(e.sanitize??wt)(f.response);y=s?Ne(l,f.answer):`${JSON.stringify(l)}
+`;}catch(l){p("EXECUTION_FAILED",l);let b=Et(e.emptyState);try{let A=(e.sanitize??wt)(b);y=s?Ne(A):`${JSON.stringify(A)}
+`;}catch(A){p("EXECUTION_FAILED",A),y=s?Ne(b):`${JSON.stringify(b)}
+`;}}r.write(y);}async function ti(n){let e=["log","info","debug"],t=new Map;for(let r of e)t.set(r,console[r]),console[r]=(...o)=>process.stderr.write(`${util.format(...o)}
+`);try{return await n()}finally{for(let r of e)console[r]=t.get(r);}}function Et(n={}){return {outcome:"failed",errorCode:"EXECUTION_FAILED",state:{...n,error:{code:"EXECUTION_FAILED",detail:null}}}}function ri(n){return (n.outcome==="failed"||n.outcome==="rejected")&&typeof n.errorCode=="string"}function oi(n){return typeof n=="string"&&/^[A-Z][A-Z0-9_]{0,127}$/u.test(n)}function wt(n){return n}var gn={depth:null,maxArrayLength:null,maxStringLength:null},En=class extends stream.Writable{#e="buffer";#n=[];_write(e,t,r){if(this.#e==="buffer"){this.#n.push(typeof e=="string"?e:Uint8Array.from(e)),r();return}if(this.#e==="discard"){r();return}process.stderr.write(e,r);}flushToStderr(){this.#e="stderr";for(let e of this.#n)process.stderr.write(e);this.#n=[];}discard(){this.#e="discard",this.#n=[];}};async function ai(n,e={}){let t=process.stdout,r=t.write.bind(t),o=new En,i=new console$1.Console({stdout:o,stderr:o,inspectOptions:{...gn}});globalThis.console=i;let s=false,a="-",d="-",p,f=false,y,l;try{let m=ui(e.inputFd??0);a=li(m.value),d=je(process.env.CREWX_APP_REQUEST_ID),p=new Date().toISOString();try{y=await n();}catch(_){f=!0,l=_;}let I=y?.default;if(!f&&I?.devtools?.log===!0?(Object.assign(util.inspect.defaultOptions,gn),b(p),o.flushToStderr()):o.discard(),f){A("EXECUTION_FAILED",l),_n(r,e,A);return}try{if(typeof y?.runSkillApp!="function")throw new TypeError("App module does not export runSkillApp");let _={sanitize:e.sanitize,emptyState:e.emptyState??di(I),preloadedInput:m.body===void 0?{value:m.value}:{value:m.value,body:m.body},onFailure:A,consoleManaged:!0,output:{write:r},jobBridge:e.jobBridge};await y.runSkillApp(I,_);}catch(_){A("EXECUTION_FAILED",_),_n(r,e,A);}}catch(m){A("EXECUTION_FAILED",m),_n(r,e,A);}finally{process.exitCode=0;}function b(m){s||(process.stderr.write(`[crewx-app] ${m??new Date().toISOString()} ${je(a)} req=${d}
+`),s=true);}function A(m,I,P){b();let _=P?.expected===true&&P.detail?` ${je(P.detail)}`:"";process.stderr.write(`[crewx-app] ${P?.outcome??"failed"} ${je(m)}${_}
+`),I!==void 0&&P?.expected!==true&&process.stderr.write(`${util.inspect(I,gn)}
+`);}}function di(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 ui(n){let e=ke(n);return e.kind==="v1"?{value:e.value}:e.kind==="v2"?{value:e.header,body:e.body}:{value:void 0}}function li(n){return n!==null&&typeof n=="object"&&!Array.isArray(n)&&typeof n.actionId=="string"?n.actionId:"-"}function je(n){return typeof n!="string"||n.length===0?"-":n.replace(/[\u0000-\u001f\u007f\u2028\u2029]/gu,"_")}function _n(n,e,t){let r={code:"EXECUTION_FAILED",detail:null},i={outcome:"failed",errorCode:"EXECUTION_FAILED",state:e.emptyState!==null&&typeof e.emptyState=="object"&&!Array.isArray(e.emptyState)?{...e.emptyState,error:r}:{error:r}},s=i;try{s=(e.sanitize??pi)(i);}catch(a){t("EXECUTION_FAILED",a);}n(`${JSON.stringify(s)}
+`);}function pi(n){return n}exports.APP_FILES_ERROR_CODES=Ln;exports.APP_FILES_LIMITS=S;exports.APP_FILES_LOCK_SUBPATH=ye;exports.APP_FILES_ROOT_ENV=st;exports.APP_JOB_BRIDGE_CHANNEL_MAX_BYTES=yn;exports.APP_JOB_BRIDGE_DRAIN_TIMEOUT_MS=fn;exports.APP_JOB_BRIDGE_ENV=yt;exports.APP_JOB_BRIDGE_ERROR_CODES=Mo;exports.APP_JOB_BRIDGE_FD=ln;exports.APP_JOB_BRIDGE_MAX_LINE_BYTES=ie;exports.APP_JOB_BRIDGE_REPLY_TIMEOUT_MS=cn;exports.APP_JOB_BRIDGE_VERSION=R;exports.APP_JOB_CAPABILITY=Cn;exports.APP_JOB_CAPABILITY_VERSION=kn;exports.APP_JOB_DEADLINE_MS=j;exports.APP_JOB_MAX_PER_APP=Lt;exports.APP_JOB_OPERATIONS=pe;exports.APP_JOB_OUTCOMES=qe;exports.APP_JOB_REFUSAL_CODES=Xe;exports.APP_JOB_RUN_REQUIRED=Ge;exports.APP_JOB_STATES=He;exports.APP_JOB_STOP_GRACE_MS=Ft;exports.APP_JOB_STOP_REASONS=le;exports.APP_JOB_TRIGGERS=Ve;exports.APP_SCHEDULE_ACTOR_KIND=Pt;exports.APP_SCHEDULE_INERT_COMMAND=Tt;exports.APP_SCHEDULE_INSTANCE_PREFIX=Be;exports.APP_SCHEDULE_INTERVALS_MINUTES=W;exports.APP_SCHEDULE_MAX_PER_APP=It;exports.APP_SCHEDULE_PERIODIC_REASONS=Sn;exports.APP_SCHEDULE_TIMEOUT_MS=v;exports.APP_TOOLS_FILE=Qt;exports.APP_TOOLS_SCHEMA_VERSION=er;exports.APP_TOOL_ENTRY=nr;exports.AppError=c;exports.AppFilesError=u;exports.AppJobBridge=V;exports.AppJobLineReader=se;exports.CrewXApp=ze;exports.SCHEDULE_TRIGGERS=Ct;exports.SKILL_BACKEND_ENV_NAMES=Fn;exports.Tool=Ut;exports.acquireFileLock=Ae;exports.appFiles=_o;exports.appFilesLockKeyOf=rn;exports.appFilesRootSegmentsOf=he;exports.appJobTriggerForActor=Vo;exports.buildAppJobChannelEnvironment=qo;exports.encodeAppJobLine=xe;exports.executeAppRequest=Zo;exports.generateManifest=Ht;exports.generateToolDeclarations=Dn;exports.getToolDeclarations=K;exports.hasAppJobCapability=Mt;exports.isAppJobCode=M;exports.isAppJobDeadlineMs=We;exports.isAppJobOperation=z;exports.isAppJobPhase=B;exports.isAppScheduleCode=Rn;exports.isAppScheduleIntervalMinutes=In;exports.isAppSchedulePeriodicReason=Pn;exports.isAppScheduleTimeoutMs=Ue;exports.isSkillBackendEnv=tr;exports.normalizeAppFilesRef=Y;exports.openInheritedAppJobTransport=_t;exports.parseAppJobChannel=bn;exports.parseAppJobControlReply=An;exports.parseAppJobControlRequest=Uo;exports.parseAppJobRunPush=mn;exports.parseAppJobRunReport=Ho;exports.parseAppJobView=Xo;exports.readAppContext=Ke;exports.readAppJobChannel=hn;exports.releaseFileLock=me;exports.runAppEntry=ai;exports.runSkillApp=Qo;

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;