@crewx/sdk 0.9.0-rc.137 → 0.9.0-rc.139

package/dist/activity-log/builder.d.ts

@@ -32,6 +32,7 @@ export interface ActivityLogTaskResult {
     omissions: ActivityLogOmission[];
     entries: ActivityLogRenderedEntry[];
     activityLog: string;
+    readable?: false;
 }
 export interface ActivityLogByTaskResult {
     threadId: string;
@@ -50,6 +51,7 @@ export interface BuildActivityLogByTaskBudgetOptions {
     activityLogTokenBudget: number;
     countTokens: CountTokens;
     repositoryEntryLimit?: number;
+    currentTaskId?: string;
 }
 export interface BuildActivityLogByTaskOptions {
     threadId: string;
@@ -60,6 +62,7 @@ export interface BuildActivityLogByTaskOptions {
     activityLogTokenBudget?: number;
     countTokens?: CountTokens;
     repositoryEntryLimit?: number;
+    currentTaskId?: string;
 }
 export interface ActivityLogResult {
     threadId: string;

package/dist/app/app.d.ts

@@ -42,9 +42,14 @@ export interface AppRuntimeOptions<State extends JsonObject = JsonObject> {
     readonly state?: State;
     readonly workspaceRoot: string;
 }
+export type AppFailureOutcome = 'failed' | 'rejected';
 export interface AppErrorMapping {
     readonly code: string;
     readonly detail: string | null;
+    readonly outcome?: AppFailureOutcome;
+}
+export interface AppErrorOptions {
+    readonly outcome?: AppFailureOutcome;
 }
 export interface AppErrorContext {
     readonly input: unknown;
@@ -56,8 +61,10 @@ export type DeepReadonly<T> = T extends (...args: never[]) => unknown ? T : T ex
 export declare class AppError extends Error {
     readonly code: string;
     readonly detail: string | null;
-    constructor(code: string, detail?: string | null);
+    readonly outcome: AppFailureOutcome;
+    constructor(code: string, detail?: string | null, options?: AppErrorOptions);
 }
+export declare function normalizeFailureOutcome(value: unknown): AppFailureOutcome;
 export declare class CrewXApp<State extends JsonObject = JsonObject> {
     static readonly devtools: {
         readonly log: boolean;

package/dist/app/backend-env.d.ts

@@ -0,0 +1,3 @@
+export declare const SKILL_BACKEND_ENV_NAMES: readonly ["CREWX_APP_INSTANCE_ID", "CREWX_THREAD_ID"];
+export type SkillBackendEnvName = (typeof SKILL_BACKEND_ENV_NAMES)[number];
+export declare function isSkillBackendEnv(value: unknown): value is readonly SkillBackendEnvName[];

package/dist/app/index.d.ts

@@ -1,6 +1,8 @@
 export { AppError, CrewXApp, Tool, generateManifest, getToolDeclarations, } from './app.js';
-export type { AppDefinition, AppErrorContext, AppErrorMapping, AppRuntimeOptions, CrewXAppConstructor, DeepReadonly, JsonObject, JsonSchema, ToolDeclaration, ToolOptions, ToolResult, } from './app.js';
+export type { AppDefinition, AppErrorContext, AppErrorMapping, AppErrorOptions, AppFailureOutcome, AppRuntimeOptions, CrewXAppConstructor, DeepReadonly, JsonObject, JsonSchema, ToolDeclaration, ToolOptions, ToolResult, } from './app.js';
+export { SKILL_BACKEND_ENV_NAMES, isSkillBackendEnv } from './backend-env.js';
+export type { SkillBackendEnvName } from './backend-env.js';
 export { executeAppRequest, runSkillApp } from './runtime.js';
-export type { RunSkillAppOptions } from './runtime.js';
+export type { AppFailureInfo, RunSkillAppOptions } from './runtime.js';
 export { runAppEntry } from './entry.js';
 export type { AppEntryOptions } from './entry.js';

package/dist/app/index.js

@@ -1,9 +1,9 @@
-'use strict';var fs=require('fs'),util=require('util'),console$1=require('console'),stream=require('stream');var j=Symbol;j.metadata===void 0&&Object.defineProperty(Symbol,"metadata",{configurable:false,value:Symbol.for("Symbol.metadata")});var N=j.metadata,O=Symbol.for("crewx.app.tool-metadata"),w=class extends Error{code;detail;constructor(e,r=null){super(e),this.name="AppError",this.code=e,this.detail=r;}},b=class{static devtools=process.env.CREWX_APP_DEV==="1"?Object.freeze({log:true}):void 0;currentState;stateWasSet=false;workspaceRoot;constructor(e={workspaceRoot:process.cwd()}){this.currentState=e.state??{},this.workspaceRoot=e.workspaceRoot;}get state(){return this.currentState}get didSetState(){return this.stateWasSet}setState(e){this.currentState=e,this.stateWasSet=true;}emptyState(){return {}}validate(e,r,n){}mapError(e){return {code:"EXECUTION_FAILED",detail:null}}errorState(e,r,n){return {...g(n.state)?n.state:{},error:{code:e,detail:r}}}};function P(t){return function(e,r){if(r.static||r.private||r.kind!=="method")throw new TypeError("@Tool can decorate public instance methods only");let n=r.metadata;if(!n)throw new TypeError("standard decorator metadata is unavailable");let i=Object.hasOwn(n,O)?n[O]:[];if(i.some(a=>a.methodName===String(r.name)))throw new TypeError(`@Tool is declared more than once for ${String(r.name)}`);n[O]=[...i,{methodName:String(r.name),options:Object.freeze({...t})}];}}function S(t){let e=t[N],r=e&&Object.hasOwn(e,O)?e[O]:[],n=new Map(r.map(a=>[a.methodName,a])),i=Object.getOwnPropertyNames(t.prototype).map(a=>n.get(a)).filter(a=>a!==void 0);if(i.length!==r.length)throw new TypeError("a @Tool method is missing from the App prototype");return i}function J(t,e){if(e.length===0)throw new TypeError("backendCommand must name the skill command");let r=t.definition,n=S(t),i=new Set,a=n.map(({options:o})=>{if(i.has(o.name))throw new TypeError(`duplicate @Tool name: ${o.name}`);return i.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,resultProjection:o.resultProjection??{allow:[...r.stateProjection.allow]},backend:{type:"skill",command:[...e]},_meta:{description:o.description}}});return {...r,actions:a}}function g(t){if(t===null||typeof t!="object"||Array.isArray(t))return  false;let e=Object.getPrototypeOf(t);return e===Object.prototype||e===null}var L=1,U=64*1024;function M(t,e,r=process.env.CREWX_WORKSPACE_ROOT??process.cwd()){return _(t,e,r)}async function _(t,e,r,n,i=true){let a=g(e)?e:void 0,o=a?.input,d=a?.state,s=new t({state:g(d)?d:{},workspaceRoot:r}),y=g(o)?o:{},h=g(d)?d:s.emptyState();try{if(!a||Object.keys(a).length!==4||!["schemaVersion","actionId","input","state"].every(p=>Object.hasOwn(a,p))||a.schemaVersion!==L||typeof a.actionId!="string"||!g(o)||!g(d))throw new w("INPUT_INVALID");y=o,h=d,s=new t({state:h,workspaceRoot:r}),await s.validate(a.actionId,y,h);let c=S(t).find(({options:p})=>p.name===a.actionId);if(!c)throw new w("INPUT_INVALID");let u=s[c.methodName];if(typeof u!="function")throw new w("EXECUTION_FAILED");let f=()=>u.call(s,y),l=i?await $(f):await f();if(l!==void 0&&!g(l))throw new w("EXECUTION_FAILED");return {...s.didSetState?{state:s.state}:{},...l===void 0?{}:{result:l}}}catch(c){let u,f=c;if(c instanceof w)u={code:c.code,detail:c.detail};else try{u=s.mapError(c);}catch(E){u={code:"EXECUTION_FAILED",detail:null},f=E;}let l=K(u?.code)?u.code:"EXECUTION_FAILED",p=typeof u?.detail=="string"?u.detail:null,m;try{m=s.errorState(l,p,{input:y,state:h});}catch(E){f=new AggregateError([f,E],"App error handling failed"),m=s.emptyState();}return n?.(l,f),{outcome:"failed",errorCode:l,state:g(m)?m:s.emptyState()}}}async function z(t,e={}){let r=e.output??process.stdout,n;if(e.preloadedInput!==void 0)n=e.preloadedInput.value;else try{n=JSON.parse(W(e.inputFd??0,U));}catch{n=void 0;}let i=false,a=(s,y)=>{i=true,e.onFailure?.(s,y);},o;try{o=await _(t,n,process.env.CREWX_WORKSPACE_ROOT??process.cwd(),a,e.consoleManaged!==!0);}catch(s){a("EXECUTION_FAILED",s),o=D(e.emptyState);}q(o)&&!i&&a(o.errorCode);let d;try{o=(e.sanitize??x)(o),d=`${JSON.stringify(o)}
-`;}catch(s){a("EXECUTION_FAILED",s),o=D(e.emptyState);try{d=`${JSON.stringify((e.sanitize??x)(o))}
-`;}catch(y){a("EXECUTION_FAILED",y),d=`${JSON.stringify(o)}
-`;}}r.write(d);}function W(t,e){let r=new TextDecoder,n="",i=0;for(;;){let a=new Uint8Array(8192),o=fs.readSync(t,a,0,a.length,null);if(o===0)break;if(i+=o,i>e)throw new w("INPUT_INVALID");n+=r.decode(a.subarray(0,o),{stream:true});}return n+r.decode()}async function $(t){let e=["log","info","debug"],r=new Map;for(let n of e)r.set(n,console[n]),console[n]=(...i)=>process.stderr.write(`${util.format(...i)}
-`);try{return await t()}finally{for(let n of e)console[n]=r.get(n);}}function D(t={}){return {outcome:"failed",errorCode:"EXECUTION_FAILED",state:{...t,error:{code:"EXECUTION_FAILED",detail:null}}}}function q(t){return (t.outcome==="failed"||t.outcome==="rejected")&&typeof t.errorCode=="string"}function K(t){return typeof t=="string"&&/^[A-Z][A-Z0-9_]{0,127}$/u.test(t)}function x(t){return t}var H=64*1024,I={depth:null,maxArrayLength:null,maxStringLength:null},C=class extends stream.Writable{#e="buffer";#t=[];_write(e,r,n){if(this.#e==="buffer"){this.#t.push(typeof e=="string"?e:Uint8Array.from(e)),n();return}if(this.#e==="discard"){n();return}process.stderr.write(e,n);}flushToStderr(){this.#e="stderr";for(let e of this.#t)process.stderr.write(e);this.#t=[];}discard(){this.#e="discard",this.#t=[];}};async function Z(t,e={}){let r=process.stdout,n=r.write.bind(r),i=new C,a=new console$1.Console({stdout:i,stderr:i,inspectOptions:{...I}});globalThis.console=a;let o=false,d="-",s="-",y,h=false,c,u;try{let p=Q(e.inputFd??0);d=G(p.value),s=k(process.env.CREWX_APP_REQUEST_ID),y=new Date().toISOString();try{c=await t();}catch(A){h=!0,u=A;}let m=c?.default;if(!h&&m?.devtools?.log===!0?(Object.assign(util.inspect.defaultOptions,I),f(y),i.flushToStderr()):i.discard(),h){l("EXECUTION_FAILED",u),R(n,e,l);return}try{if(typeof c?.runSkillApp!="function")throw new TypeError("App module does not export runSkillApp");let A={sanitize:e.sanitize,emptyState:e.emptyState,preloadedInput:{value:p.value},onFailure:l,consoleManaged:!0,output:{write:n}};await c.runSkillApp(m,A);}catch(A){l("EXECUTION_FAILED",A),R(n,e,l);}}catch(p){l("EXECUTION_FAILED",p),R(n,e,l);}finally{process.exitCode=0;}function f(p){o||(process.stderr.write(`[crewx-app] ${p??new Date().toISOString()} ${k(d)} req=${s}
-`),o=true);}function l(p,m){f(),process.stderr.write(`[crewx-app] failed ${k(p)}
-`),m!==void 0&&process.stderr.write(`${util.inspect(m,I)}
-`);}}function Q(t){try{let e=[],r=0;for(;;){let n=new Uint8Array(8192),i=fs.readSync(t,n,0,n.length,null);if(i===0)break;if(r+=i,r>H)return {value:void 0};e.push(n.subarray(0,i));}return {value:JSON.parse(Buffer.concat(e,r).toString("utf8"))}}catch{return {value:void 0}}}function G(t){return t!==null&&typeof t=="object"&&!Array.isArray(t)&&typeof t.actionId=="string"?t.actionId:"-"}function k(t){return typeof t!="string"||t.length===0?"-":t.replace(/[\u0000-\u001f\u007f\u2028\u2029]/gu,"_")}function R(t,e,r){let n={code:"EXECUTION_FAILED",detail:null},a={outcome:"failed",errorCode:"EXECUTION_FAILED",state:e.emptyState!==null&&typeof e.emptyState=="object"&&!Array.isArray(e.emptyState)?{...e.emptyState,error:n}:{error:n}},o=a;try{o=(e.sanitize??ee)(a);}catch(d){r("EXECUTION_FAILED",d);}t(`${JSON.stringify(o)}
-`);}function ee(t){return t}exports.AppError=w;exports.CrewXApp=b;exports.Tool=P;exports.executeAppRequest=M;exports.generateManifest=J;exports.getToolDeclarations=S;exports.runAppEntry=Z;exports.runSkillApp=z;
+'use strict';var fs=require('fs'),util=require('util'),console$1=require('console'),stream=require('stream');var D=Symbol;D.metadata===void 0&&Object.defineProperty(Symbol,"metadata",{configurable:false,value:Symbol.for("Symbol.metadata")});var L=D.metadata,S=Symbol.for("crewx.app.tool-metadata"),g=class extends Error{code;detail;outcome;constructor(e,r=null,n){super(e),this.name="AppError",this.code=e,this.detail=r,this.outcome=C(n?.outcome);}};function C(t){return t==="rejected"?"rejected":"failed"}var R=class{static devtools=process.env.CREWX_APP_DEV==="1"?Object.freeze({log:true}):void 0;currentState;stateWasSet=false;workspaceRoot;constructor(e={workspaceRoot:process.cwd()}){this.currentState=e.state??{},this.workspaceRoot=e.workspaceRoot;}get state(){return this.currentState}get didSetState(){return this.stateWasSet}setState(e){this.currentState=e,this.stateWasSet=true;}emptyState(){return {}}validate(e,r,n){}mapError(e){return {code:"EXECUTION_FAILED",detail:null}}errorState(e,r,n){return {...A(n.state)?n.state:{},error:{code:e,detail:r}}}};function X(t){return function(e,r){if(r.static||r.private||r.kind!=="method")throw new TypeError("@Tool can decorate public instance methods only");let n=r.metadata;if(!n)throw new TypeError("standard decorator metadata is unavailable");let i=Object.hasOwn(n,S)?n[S]:[];if(i.some(a=>a.methodName===String(r.name)))throw new TypeError(`@Tool is declared more than once for ${String(r.name)}`);n[S]=[...i,{methodName:String(r.name),options:Object.freeze({...t})}];}}function I(t){let e=t[L],r=e&&Object.hasOwn(e,S)?e[S]:[],n=new Map(r.map(a=>[a.methodName,a])),i=Object.getOwnPropertyNames(t.prototype).map(a=>n.get(a)).filter(a=>a!==void 0);if(i.length!==r.length)throw new TypeError("a @Tool method is missing from the App prototype");return i}function U(t,e){if(e.length===0)throw new TypeError("backendCommand must name the skill command");let r=t.definition,n=I(t),i=new Set,a=n.map(({options:o})=>{if(i.has(o.name))throw new TypeError(`duplicate @Tool name: ${o.name}`);return i.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,resultProjection:o.resultProjection??{allow:[...r.stateProjection.allow]},backend:{type:"skill",command:[...e]},_meta:{description:o.description}}});return {...r,actions:a}}function A(t){if(t===null||typeof t!="object"||Array.isArray(t))return  false;let e=Object.getPrototypeOf(t);return e===Object.prototype||e===null}var N=["CREWX_APP_INSTANCE_ID","CREWX_THREAD_ID"];function M(t){if(!Array.isArray(t)||t.length===0)return  false;let e=new Set;for(let r of t){if(!N.some(n=>n===r)||e.has(r))return  false;e.add(r);}return  true}var $=1,K=64*1024;function B(t,e,r=process.env.CREWX_WORKSPACE_ROOT??process.cwd()){return P(t,e,r)}async function P(t,e,r,n,i=true){let a=A(e)?e:void 0,o=a?.input,l=a?.state,s=new t({state:A(l)?l:{},workspaceRoot:r}),y=A(o)?o:{},m=A(l)?l:s.emptyState();try{if(!a||Object.keys(a).length!==4||!["schemaVersion","actionId","input","state"].every(p=>Object.hasOwn(a,p))||a.schemaVersion!==$||typeof a.actionId!="string"||!A(o)||!A(l))throw new g("INPUT_INVALID");y=o,m=l,s=new t({state:m,workspaceRoot:r}),await s.validate(a.actionId,y,m);let c=I(t).find(({options:p})=>p.name===a.actionId);if(!c)throw new g("INPUT_INVALID");let u=s[c.methodName];if(typeof u!="function")throw new g("EXECUTION_FAILED");let f=()=>u.call(s,y),d=i?await H(f):await f();if(d!==void 0&&!A(d))throw new g("EXECUTION_FAILED");return {...s.didSetState?{state:s.state}:{},...d===void 0?{}:{result:d}}}catch(c){let u,f=c,d=c instanceof g?c:void 0;if(d)u={code:d.code,detail:d.detail,outcome:d.outcome};else try{u=s.mapError(c);}catch(k){u={code:"EXECUTION_FAILED",detail:null},f=k;}let p=Z(u?.code),E=p?u.code:"EXECUTION_FAILED",O=typeof u?.detail=="string"?u.detail:null,w=p?C(u.outcome):"failed",h;try{h=s.errorState(E,O,{input:y,state:m});}catch(k){f=new AggregateError([f,k],"App error handling failed"),h=s.emptyState();}return n?.(E,f,{outcome:w,detail:O,expected:d!==void 0&&f===d}),{outcome:w,errorCode:E,state:A(h)?h:s.emptyState()}}}async function V(t,e={}){let r=e.output??process.stdout,n;if(e.preloadedInput!==void 0)n=e.preloadedInput.value;else try{n=JSON.parse(q(e.inputFd??0,K));}catch{n=void 0;}let i=false,a=(s,y,m)=>{i=true,e.onFailure?.(s,y,m);},o;try{o=await P(t,n,process.env.CREWX_WORKSPACE_ROOT??process.cwd(),a,e.consoleManaged!==!0);}catch(s){a("EXECUTION_FAILED",s),o=F(e.emptyState);}Y(o)&&!i&&a(o.errorCode,void 0,{outcome:o.outcome,detail:null,expected:false});let l;try{o=(e.sanitize??v)(o),l=`${JSON.stringify(o)}
+`;}catch(s){a("EXECUTION_FAILED",s),o=F(e.emptyState);try{l=`${JSON.stringify((e.sanitize??v)(o))}
+`;}catch(y){a("EXECUTION_FAILED",y),l=`${JSON.stringify(o)}
+`;}}r.write(l);}function q(t,e){let r=new TextDecoder,n="",i=0;for(;;){let a=new Uint8Array(8192),o=fs.readSync(t,a,0,a.length,null);if(o===0)break;if(i+=o,i>e)throw new g("INPUT_INVALID");n+=r.decode(a.subarray(0,o),{stream:true});}return n+r.decode()}async function H(t){let e=["log","info","debug"],r=new Map;for(let n of e)r.set(n,console[n]),console[n]=(...i)=>process.stderr.write(`${util.format(...i)}
+`);try{return await t()}finally{for(let n of e)console[n]=r.get(n);}}function F(t={}){return {outcome:"failed",errorCode:"EXECUTION_FAILED",state:{...t,error:{code:"EXECUTION_FAILED",detail:null}}}}function Y(t){return (t.outcome==="failed"||t.outcome==="rejected")&&typeof t.errorCode=="string"}function Z(t){return typeof t=="string"&&/^[A-Z][A-Z0-9_]{0,127}$/u.test(t)}function v(t){return t}var te=64*1024,j={depth:null,maxArrayLength:null,maxStringLength:null},_=class extends stream.Writable{#e="buffer";#t=[];_write(e,r,n){if(this.#e==="buffer"){this.#t.push(typeof e=="string"?e:Uint8Array.from(e)),n();return}if(this.#e==="discard"){n();return}process.stderr.write(e,n);}flushToStderr(){this.#e="stderr";for(let e of this.#t)process.stderr.write(e);this.#t=[];}discard(){this.#e="discard",this.#t=[];}};async function ne(t,e={}){let r=process.stdout,n=r.write.bind(r),i=new _,a=new console$1.Console({stdout:i,stderr:i,inspectOptions:{...j}});globalThis.console=a;let o=false,l="-",s="-",y,m=false,c,u;try{let p=re(e.inputFd??0);l=oe(p.value),s=T(process.env.CREWX_APP_REQUEST_ID),y=new Date().toISOString();try{c=await t();}catch(w){m=!0,u=w;}let E=c?.default;if(!m&&E?.devtools?.log===!0?(Object.assign(util.inspect.defaultOptions,j),f(y),i.flushToStderr()):i.discard(),m){d("EXECUTION_FAILED",u),x(n,e,d);return}try{if(typeof c?.runSkillApp!="function")throw new TypeError("App module does not export runSkillApp");let w={sanitize:e.sanitize,emptyState:e.emptyState,preloadedInput:{value:p.value},onFailure:d,consoleManaged:!0,output:{write:n}};await c.runSkillApp(E,w);}catch(w){d("EXECUTION_FAILED",w),x(n,e,d);}}catch(p){d("EXECUTION_FAILED",p),x(n,e,d);}finally{process.exitCode=0;}function f(p){o||(process.stderr.write(`[crewx-app] ${p??new Date().toISOString()} ${T(l)} req=${s}
+`),o=true);}function d(p,E,O){f();let w=O?.expected===true&&O.detail?` ${T(O.detail)}`:"";process.stderr.write(`[crewx-app] ${O?.outcome??"failed"} ${T(p)}${w}
+`),E!==void 0&&O?.expected!==true&&process.stderr.write(`${util.inspect(E,j)}
+`);}}function re(t){try{let e=[],r=0;for(;;){let n=new Uint8Array(8192),i=fs.readSync(t,n,0,n.length,null);if(i===0)break;if(r+=i,r>te)return {value:void 0};e.push(n.subarray(0,i));}return {value:JSON.parse(Buffer.concat(e,r).toString("utf8"))}}catch{return {value:void 0}}}function oe(t){return t!==null&&typeof t=="object"&&!Array.isArray(t)&&typeof t.actionId=="string"?t.actionId:"-"}function T(t){return typeof t!="string"||t.length===0?"-":t.replace(/[\u0000-\u001f\u007f\u2028\u2029]/gu,"_")}function x(t,e,r){let n={code:"EXECUTION_FAILED",detail:null},a={outcome:"failed",errorCode:"EXECUTION_FAILED",state:e.emptyState!==null&&typeof e.emptyState=="object"&&!Array.isArray(e.emptyState)?{...e.emptyState,error:n}:{error:n}},o=a;try{o=(e.sanitize??ae)(a);}catch(l){r("EXECUTION_FAILED",l);}t(`${JSON.stringify(o)}
+`);}function ae(t){return t}exports.AppError=g;exports.CrewXApp=R;exports.SKILL_BACKEND_ENV_NAMES=N;exports.Tool=X;exports.executeAppRequest=B;exports.generateManifest=U;exports.getToolDeclarations=I;exports.isSkillBackendEnv=M;exports.runAppEntry=ne;exports.runSkillApp=V;

package/dist/app/runtime.d.ts

@@ -1,4 +1,9 @@
-import { type CrewXAppConstructor, type JsonObject } from './app.js';
+import { type AppFailureOutcome, type CrewXAppConstructor, type JsonObject } from './app.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;
@@ -7,7 +12,7 @@ export interface RunSkillAppOptions {
     readonly preloadedInput?: {
         readonly value: unknown;
     };
-    readonly onFailure?: (errorCode: string, error?: unknown) => void;
+    readonly onFailure?: (errorCode: string, error?: unknown, info?: AppFailureInfo) => void;
     readonly consoleManaged?: boolean;
 }
 export declare function executeAppRequest(appClass: CrewXAppConstructor, rawRequest: unknown, workspaceRoot?: string): Promise<JsonObject>;

package/dist/conversation/sqlite-provider.d.ts

@@ -21,7 +21,6 @@ export declare class SqliteConversationProvider implements IConversationHistoryP
         id: string;
     }>;
     close(): void;
-    private normalizeStatus;
     private readActiveHighlights;
     private rowsToMessages;
 }

package/dist/conversation/types.d.ts

@@ -78,6 +78,7 @@ export interface FetchHistoryOptions {
     maxContextLength?: number;
     includeHighlights?: boolean;
     currentTraceId?: string;
+    agentId?: string;
 }
 export interface IConversationHistoryProvider {
     ensureThread(threadId: string, platform: Platform, workspaceId?: string, creator?: ThreadCreationOptions): Promise<{

package/dist/esm/app/index.js

@@ -1,9 +1,9 @@
-import {readSync}from'fs';import {format,inspect}from'util';import {Console}from'console';import {Writable}from'stream';var D=Symbol;D.metadata===void 0&&Object.defineProperty(Symbol,"metadata",{configurable:false,value:Symbol.for("Symbol.metadata")});var P=D.metadata,O=Symbol.for("crewx.app.tool-metadata"),w=class extends Error{code;detail;constructor(e,r=null){super(e),this.name="AppError",this.code=e,this.detail=r;}},b=class{static devtools=process.env.CREWX_APP_DEV==="1"?Object.freeze({log:true}):void 0;currentState;stateWasSet=false;workspaceRoot;constructor(e={workspaceRoot:process.cwd()}){this.currentState=e.state??{},this.workspaceRoot=e.workspaceRoot;}get state(){return this.currentState}get didSetState(){return this.stateWasSet}setState(e){this.currentState=e,this.stateWasSet=true;}emptyState(){return {}}validate(e,r,n){}mapError(e){return {code:"EXECUTION_FAILED",detail:null}}errorState(e,r,n){return {...g(n.state)?n.state:{},error:{code:e,detail:r}}}};function J(t){return function(e,r){if(r.static||r.private||r.kind!=="method")throw new TypeError("@Tool can decorate public instance methods only");let n=r.metadata;if(!n)throw new TypeError("standard decorator metadata is unavailable");let i=Object.hasOwn(n,O)?n[O]:[];if(i.some(a=>a.methodName===String(r.name)))throw new TypeError(`@Tool is declared more than once for ${String(r.name)}`);n[O]=[...i,{methodName:String(r.name),options:Object.freeze({...t})}];}}function S(t){let e=t[P],r=e&&Object.hasOwn(e,O)?e[O]:[],n=new Map(r.map(a=>[a.methodName,a])),i=Object.getOwnPropertyNames(t.prototype).map(a=>n.get(a)).filter(a=>a!==void 0);if(i.length!==r.length)throw new TypeError("a @Tool method is missing from the App prototype");return i}function X(t,e){if(e.length===0)throw new TypeError("backendCommand must name the skill command");let r=t.definition,n=S(t),i=new Set,a=n.map(({options:o})=>{if(i.has(o.name))throw new TypeError(`duplicate @Tool name: ${o.name}`);return i.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,resultProjection:o.resultProjection??{allow:[...r.stateProjection.allow]},backend:{type:"skill",command:[...e]},_meta:{description:o.description}}});return {...r,actions:a}}function g(t){if(t===null||typeof t!="object"||Array.isArray(t))return  false;let e=Object.getPrototypeOf(t);return e===Object.prototype||e===null}var U=1,M=64*1024;function z(t,e,r=process.env.CREWX_WORKSPACE_ROOT??process.cwd()){return v(t,e,r)}async function v(t,e,r,n,i=true){let a=g(e)?e:void 0,o=a?.input,d=a?.state,s=new t({state:g(d)?d:{},workspaceRoot:r}),y=g(o)?o:{},h=g(d)?d:s.emptyState();try{if(!a||Object.keys(a).length!==4||!["schemaVersion","actionId","input","state"].every(p=>Object.hasOwn(a,p))||a.schemaVersion!==U||typeof a.actionId!="string"||!g(o)||!g(d))throw new w("INPUT_INVALID");y=o,h=d,s=new t({state:h,workspaceRoot:r}),await s.validate(a.actionId,y,h);let c=S(t).find(({options:p})=>p.name===a.actionId);if(!c)throw new w("INPUT_INVALID");let u=s[c.methodName];if(typeof u!="function")throw new w("EXECUTION_FAILED");let f=()=>u.call(s,y),l=i?await q(f):await f();if(l!==void 0&&!g(l))throw new w("EXECUTION_FAILED");return {...s.didSetState?{state:s.state}:{},...l===void 0?{}:{result:l}}}catch(c){let u,f=c;if(c instanceof w)u={code:c.code,detail:c.detail};else try{u=s.mapError(c);}catch(E){u={code:"EXECUTION_FAILED",detail:null},f=E;}let l=V(u?.code)?u.code:"EXECUTION_FAILED",p=typeof u?.detail=="string"?u.detail:null,m;try{m=s.errorState(l,p,{input:y,state:h});}catch(E){f=new AggregateError([f,E],"App error handling failed"),m=s.emptyState();}return n?.(l,f),{outcome:"failed",errorCode:l,state:g(m)?m:s.emptyState()}}}async function W(t,e={}){let r=e.output??process.stdout,n;if(e.preloadedInput!==void 0)n=e.preloadedInput.value;else try{n=JSON.parse($(e.inputFd??0,M));}catch{n=void 0;}let i=false,a=(s,y)=>{i=true,e.onFailure?.(s,y);},o;try{o=await v(t,n,process.env.CREWX_WORKSPACE_ROOT??process.cwd(),a,e.consoleManaged!==!0);}catch(s){a("EXECUTION_FAILED",s),o=x(e.emptyState);}K(o)&&!i&&a(o.errorCode);let d;try{o=(e.sanitize??_)(o),d=`${JSON.stringify(o)}
-`;}catch(s){a("EXECUTION_FAILED",s),o=x(e.emptyState);try{d=`${JSON.stringify((e.sanitize??_)(o))}
-`;}catch(y){a("EXECUTION_FAILED",y),d=`${JSON.stringify(o)}
-`;}}r.write(d);}function $(t,e){let r=new TextDecoder,n="",i=0;for(;;){let a=new Uint8Array(8192),o=readSync(t,a,0,a.length,null);if(o===0)break;if(i+=o,i>e)throw new w("INPUT_INVALID");n+=r.decode(a.subarray(0,o),{stream:true});}return n+r.decode()}async function q(t){let e=["log","info","debug"],r=new Map;for(let n of e)r.set(n,console[n]),console[n]=(...i)=>process.stderr.write(`${format(...i)}
-`);try{return await t()}finally{for(let n of e)console[n]=r.get(n);}}function x(t={}){return {outcome:"failed",errorCode:"EXECUTION_FAILED",state:{...t,error:{code:"EXECUTION_FAILED",detail:null}}}}function K(t){return (t.outcome==="failed"||t.outcome==="rejected")&&typeof t.errorCode=="string"}function V(t){return typeof t=="string"&&/^[A-Z][A-Z0-9_]{0,127}$/u.test(t)}function _(t){return t}var Z=64*1024,k={depth:null,maxArrayLength:null,maxStringLength:null},j=class extends Writable{#e="buffer";#t=[];_write(e,r,n){if(this.#e==="buffer"){this.#t.push(typeof e=="string"?e:Uint8Array.from(e)),n();return}if(this.#e==="discard"){n();return}process.stderr.write(e,n);}flushToStderr(){this.#e="stderr";for(let e of this.#t)process.stderr.write(e);this.#t=[];}discard(){this.#e="discard",this.#t=[];}};async function Q(t,e={}){let r=process.stdout,n=r.write.bind(r),i=new j,a=new Console({stdout:i,stderr:i,inspectOptions:{...k}});globalThis.console=a;let o=false,d="-",s="-",y,h=false,c,u;try{let p=G(e.inputFd??0);d=ee(p.value),s=R(process.env.CREWX_APP_REQUEST_ID),y=new Date().toISOString();try{c=await t();}catch(A){h=!0,u=A;}let m=c?.default;if(!h&&m?.devtools?.log===!0?(Object.assign(inspect.defaultOptions,k),f(y),i.flushToStderr()):i.discard(),h){l("EXECUTION_FAILED",u),C(n,e,l);return}try{if(typeof c?.runSkillApp!="function")throw new TypeError("App module does not export runSkillApp");let A={sanitize:e.sanitize,emptyState:e.emptyState,preloadedInput:{value:p.value},onFailure:l,consoleManaged:!0,output:{write:n}};await c.runSkillApp(m,A);}catch(A){l("EXECUTION_FAILED",A),C(n,e,l);}}catch(p){l("EXECUTION_FAILED",p),C(n,e,l);}finally{process.exitCode=0;}function f(p){o||(process.stderr.write(`[crewx-app] ${p??new Date().toISOString()} ${R(d)} req=${s}
-`),o=true);}function l(p,m){f(),process.stderr.write(`[crewx-app] failed ${R(p)}
-`),m!==void 0&&process.stderr.write(`${inspect(m,k)}
-`);}}function G(t){try{let e=[],r=0;for(;;){let n=new Uint8Array(8192),i=readSync(t,n,0,n.length,null);if(i===0)break;if(r+=i,r>Z)return {value:void 0};e.push(n.subarray(0,i));}return {value:JSON.parse(Buffer.concat(e,r).toString("utf8"))}}catch{return {value:void 0}}}function ee(t){return t!==null&&typeof t=="object"&&!Array.isArray(t)&&typeof t.actionId=="string"?t.actionId:"-"}function R(t){return typeof t!="string"||t.length===0?"-":t.replace(/[\u0000-\u001f\u007f\u2028\u2029]/gu,"_")}function C(t,e,r){let n={code:"EXECUTION_FAILED",detail:null},a={outcome:"failed",errorCode:"EXECUTION_FAILED",state:e.emptyState!==null&&typeof e.emptyState=="object"&&!Array.isArray(e.emptyState)?{...e.emptyState,error:n}:{error:n}},o=a;try{o=(e.sanitize??te)(a);}catch(d){r("EXECUTION_FAILED",d);}t(`${JSON.stringify(o)}
-`);}function te(t){return t}export{w as AppError,b as CrewXApp,J as Tool,z as executeAppRequest,X as generateManifest,S as getToolDeclarations,Q as runAppEntry,W as runSkillApp};
+import {readSync}from'fs';import {format,inspect}from'util';import {Console}from'console';import {Writable}from'stream';var N=Symbol;N.metadata===void 0&&Object.defineProperty(Symbol,"metadata",{configurable:false,value:Symbol.for("Symbol.metadata")});var X=N.metadata,S=Symbol.for("crewx.app.tool-metadata"),g=class extends Error{code;detail;outcome;constructor(e,r=null,n){super(e),this.name="AppError",this.code=e,this.detail=r,this.outcome=j(n?.outcome);}};function j(t){return t==="rejected"?"rejected":"failed"}var C=class{static devtools=process.env.CREWX_APP_DEV==="1"?Object.freeze({log:true}):void 0;currentState;stateWasSet=false;workspaceRoot;constructor(e={workspaceRoot:process.cwd()}){this.currentState=e.state??{},this.workspaceRoot=e.workspaceRoot;}get state(){return this.currentState}get didSetState(){return this.stateWasSet}setState(e){this.currentState=e,this.stateWasSet=true;}emptyState(){return {}}validate(e,r,n){}mapError(e){return {code:"EXECUTION_FAILED",detail:null}}errorState(e,r,n){return {...A(n.state)?n.state:{},error:{code:e,detail:r}}}};function U(t){return function(e,r){if(r.static||r.private||r.kind!=="method")throw new TypeError("@Tool can decorate public instance methods only");let n=r.metadata;if(!n)throw new TypeError("standard decorator metadata is unavailable");let i=Object.hasOwn(n,S)?n[S]:[];if(i.some(a=>a.methodName===String(r.name)))throw new TypeError(`@Tool is declared more than once for ${String(r.name)}`);n[S]=[...i,{methodName:String(r.name),options:Object.freeze({...t})}];}}function T(t){let e=t[X],r=e&&Object.hasOwn(e,S)?e[S]:[],n=new Map(r.map(a=>[a.methodName,a])),i=Object.getOwnPropertyNames(t.prototype).map(a=>n.get(a)).filter(a=>a!==void 0);if(i.length!==r.length)throw new TypeError("a @Tool method is missing from the App prototype");return i}function M(t,e){if(e.length===0)throw new TypeError("backendCommand must name the skill command");let r=t.definition,n=T(t),i=new Set,a=n.map(({options:o})=>{if(i.has(o.name))throw new TypeError(`duplicate @Tool name: ${o.name}`);return i.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,resultProjection:o.resultProjection??{allow:[...r.stateProjection.allow]},backend:{type:"skill",command:[...e]},_meta:{description:o.description}}});return {...r,actions:a}}function A(t){if(t===null||typeof t!="object"||Array.isArray(t))return  false;let e=Object.getPrototypeOf(t);return e===Object.prototype||e===null}var F=["CREWX_APP_INSTANCE_ID","CREWX_THREAD_ID"];function z(t){if(!Array.isArray(t)||t.length===0)return  false;let e=new Set;for(let r of t){if(!F.some(n=>n===r)||e.has(r))return  false;e.add(r);}return  true}var K=1,B=64*1024;function V(t,e,r=process.env.CREWX_WORKSPACE_ROOT??process.cwd()){return J(t,e,r)}async function J(t,e,r,n,i=true){let a=A(e)?e:void 0,o=a?.input,l=a?.state,s=new t({state:A(l)?l:{},workspaceRoot:r}),y=A(o)?o:{},m=A(l)?l:s.emptyState();try{if(!a||Object.keys(a).length!==4||!["schemaVersion","actionId","input","state"].every(p=>Object.hasOwn(a,p))||a.schemaVersion!==K||typeof a.actionId!="string"||!A(o)||!A(l))throw new g("INPUT_INVALID");y=o,m=l,s=new t({state:m,workspaceRoot:r}),await s.validate(a.actionId,y,m);let c=T(t).find(({options:p})=>p.name===a.actionId);if(!c)throw new g("INPUT_INVALID");let u=s[c.methodName];if(typeof u!="function")throw new g("EXECUTION_FAILED");let f=()=>u.call(s,y),d=i?await Y(f):await f();if(d!==void 0&&!A(d))throw new g("EXECUTION_FAILED");return {...s.didSetState?{state:s.state}:{},...d===void 0?{}:{result:d}}}catch(c){let u,f=c,d=c instanceof g?c:void 0;if(d)u={code:d.code,detail:d.detail,outcome:d.outcome};else try{u=s.mapError(c);}catch(R){u={code:"EXECUTION_FAILED",detail:null},f=R;}let p=Q(u?.code),E=p?u.code:"EXECUTION_FAILED",O=typeof u?.detail=="string"?u.detail:null,w=p?j(u.outcome):"failed",h;try{h=s.errorState(E,O,{input:y,state:m});}catch(R){f=new AggregateError([f,R],"App error handling failed"),h=s.emptyState();}return n?.(E,f,{outcome:w,detail:O,expected:d!==void 0&&f===d}),{outcome:w,errorCode:E,state:A(h)?h:s.emptyState()}}}async function q(t,e={}){let r=e.output??process.stdout,n;if(e.preloadedInput!==void 0)n=e.preloadedInput.value;else try{n=JSON.parse(H(e.inputFd??0,B));}catch{n=void 0;}let i=false,a=(s,y,m)=>{i=true,e.onFailure?.(s,y,m);},o;try{o=await J(t,n,process.env.CREWX_WORKSPACE_ROOT??process.cwd(),a,e.consoleManaged!==!0);}catch(s){a("EXECUTION_FAILED",s),o=v(e.emptyState);}Z(o)&&!i&&a(o.errorCode,void 0,{outcome:o.outcome,detail:null,expected:false});let l;try{o=(e.sanitize??P)(o),l=`${JSON.stringify(o)}
+`;}catch(s){a("EXECUTION_FAILED",s),o=v(e.emptyState);try{l=`${JSON.stringify((e.sanitize??P)(o))}
+`;}catch(y){a("EXECUTION_FAILED",y),l=`${JSON.stringify(o)}
+`;}}r.write(l);}function H(t,e){let r=new TextDecoder,n="",i=0;for(;;){let a=new Uint8Array(8192),o=readSync(t,a,0,a.length,null);if(o===0)break;if(i+=o,i>e)throw new g("INPUT_INVALID");n+=r.decode(a.subarray(0,o),{stream:true});}return n+r.decode()}async function Y(t){let e=["log","info","debug"],r=new Map;for(let n of e)r.set(n,console[n]),console[n]=(...i)=>process.stderr.write(`${format(...i)}
+`);try{return await t()}finally{for(let n of e)console[n]=r.get(n);}}function v(t={}){return {outcome:"failed",errorCode:"EXECUTION_FAILED",state:{...t,error:{code:"EXECUTION_FAILED",detail:null}}}}function Z(t){return (t.outcome==="failed"||t.outcome==="rejected")&&typeof t.errorCode=="string"}function Q(t){return typeof t=="string"&&/^[A-Z][A-Z0-9_]{0,127}$/u.test(t)}function P(t){return t}var ne=64*1024,x={depth:null,maxArrayLength:null,maxStringLength:null},D=class extends Writable{#e="buffer";#t=[];_write(e,r,n){if(this.#e==="buffer"){this.#t.push(typeof e=="string"?e:Uint8Array.from(e)),n();return}if(this.#e==="discard"){n();return}process.stderr.write(e,n);}flushToStderr(){this.#e="stderr";for(let e of this.#t)process.stderr.write(e);this.#t=[];}discard(){this.#e="discard",this.#t=[];}};async function re(t,e={}){let r=process.stdout,n=r.write.bind(r),i=new D,a=new Console({stdout:i,stderr:i,inspectOptions:{...x}});globalThis.console=a;let o=false,l="-",s="-",y,m=false,c,u;try{let p=oe(e.inputFd??0);l=ae(p.value),s=k(process.env.CREWX_APP_REQUEST_ID),y=new Date().toISOString();try{c=await t();}catch(w){m=!0,u=w;}let E=c?.default;if(!m&&E?.devtools?.log===!0?(Object.assign(inspect.defaultOptions,x),f(y),i.flushToStderr()):i.discard(),m){d("EXECUTION_FAILED",u),_(n,e,d);return}try{if(typeof c?.runSkillApp!="function")throw new TypeError("App module does not export runSkillApp");let w={sanitize:e.sanitize,emptyState:e.emptyState,preloadedInput:{value:p.value},onFailure:d,consoleManaged:!0,output:{write:n}};await c.runSkillApp(E,w);}catch(w){d("EXECUTION_FAILED",w),_(n,e,d);}}catch(p){d("EXECUTION_FAILED",p),_(n,e,d);}finally{process.exitCode=0;}function f(p){o||(process.stderr.write(`[crewx-app] ${p??new Date().toISOString()} ${k(l)} req=${s}
+`),o=true);}function d(p,E,O){f();let w=O?.expected===true&&O.detail?` ${k(O.detail)}`:"";process.stderr.write(`[crewx-app] ${O?.outcome??"failed"} ${k(p)}${w}
+`),E!==void 0&&O?.expected!==true&&process.stderr.write(`${inspect(E,x)}
+`);}}function oe(t){try{let e=[],r=0;for(;;){let n=new Uint8Array(8192),i=readSync(t,n,0,n.length,null);if(i===0)break;if(r+=i,r>ne)return {value:void 0};e.push(n.subarray(0,i));}return {value:JSON.parse(Buffer.concat(e,r).toString("utf8"))}}catch{return {value:void 0}}}function ae(t){return t!==null&&typeof t=="object"&&!Array.isArray(t)&&typeof t.actionId=="string"?t.actionId:"-"}function k(t){return typeof t!="string"||t.length===0?"-":t.replace(/[\u0000-\u001f\u007f\u2028\u2029]/gu,"_")}function _(t,e,r){let n={code:"EXECUTION_FAILED",detail:null},a={outcome:"failed",errorCode:"EXECUTION_FAILED",state:e.emptyState!==null&&typeof e.emptyState=="object"&&!Array.isArray(e.emptyState)?{...e.emptyState,error:n}:{error:n}},o=a;try{o=(e.sanitize??ie)(a);}catch(l){r("EXECUTION_FAILED",l);}t(`${JSON.stringify(o)}
+`);}function ie(t){return t}export{g as AppError,C as CrewXApp,F as SKILL_BACKEND_ENV_NAMES,U as Tool,V as executeAppRequest,M as generateManifest,T as getToolDeclarations,z as isSkillBackendEnv,re as runAppEntry,q as runSkillApp};