@crewx/sdk 0.9.0-rc.93 → 0.9.0-rc.95

package/dist/plugins/sqlite-tracing.d.ts

@@ -13,24 +13,34 @@ export interface SqliteTracingMetrics {
     pendingQueueEntries: number;
     pendingQueueBytes: number;
 }
+export interface SqliteTracingRunnerIdentity {
+    detachedRunner: boolean;
+    assignedTaskId?: string;
+}
 export interface SqliteTracingPluginOptions {
     dbRoot?: string;
     version?: string;
+    runnerIdentity?: SqliteTracingRunnerIdentity;
 }
 export declare class SqliteTracingPlugin extends CrewxPlugin {
     readonly name = "sqlite-tracing";
     private unsubs;
     private readonly dbPath;
     private readonly version;
+    private readonly runnerIdentity;
     private taskRepo?;
+    private readonly heartbeatTaskIds;
+    private readonly ignoredDetachedTaskIds;
     private readonly queues;
     private metrics;
     constructor(opts?: SqliteTracingPluginOptions);
     attach(crewx: Crewx): void;
     detach(_crewx: Crewx): void;
     getMetrics(): SqliteTracingMetrics;
+    private resolveTaskId;
     private enqueueLog;
     private recoverPartialResult;
+    private handleStopRequested;
     private flushTaskLogs;
     private flushAllTaskLogs;
     private clearAllTimers;

package/dist/process/index.d.ts

@@ -0,0 +1,2 @@
+export { checkProcessOwnership, checkProcessOwnershipAsync, probeProcessLiveness, terminateProcessTree, UNIX_PROCESS_POLL_INTERVAL_MS, UNIX_SIGKILL_CONFIRM_MS, UNIX_SIGTERM_GRACE_MS, } from './process-control.js';
+export type { ProcessCommandLineResult, ProcessCommandResult, ProcessCommandRunner, ProcessCommandRunnerAsync, ProcessControlOptions, ProcessLiveness, ProcessOwnership, ProcessTerminationResult, ProcessTerminationStatus, } from './process-control.js';

package/dist/process/index.js

@@ -0,0 +1 @@
+'use strict';var child_process=require('child_process');var P=3e3,_=2e3,R=25,L=100;function p(e){return e instanceof Error?e:e===void 0?void 0:new Error(String(e))}function g(e){return typeof e=="object"&&e!==null&&"code"in e?String(e.code):void 0}function w(e){return Number.isSafeInteger(e)&&e>0}function E(e,t){try{let r=child_process.spawnSync(e,t,{encoding:"utf8",timeout:P,windowsHide:!0});return {status:r.status,stdout:typeof r.stdout=="string"?r.stdout:"",stderr:typeof r.stderr=="string"?r.stderr:"",error:r.error}}catch(r){return {status:null,stdout:"",stderr:"",error:p(r)}}}function b(e,t){return new Promise(r=>{let n;try{n=child_process.spawn(e,t,{windowsHide:!0});}catch(a){r({status:null,stdout:"",stderr:"",error:p(a)});return}let o="",i="",u=false,s,m=setTimeout(()=>{try{n.kill();}catch{}s({status:null,stdout:o,stderr:i,error:new Error(`Command timed out after ${P}ms`)});},P);s=a=>{u||(u=true,clearTimeout(m),r(a));},n.stdout?.setEncoding("utf8"),n.stderr?.setEncoding("utf8"),n.stdout?.on("data",a=>{o+=String(a);}),n.stderr?.on("data",a=>{i+=String(a);}),n.once("error",a=>{s({status:null,stdout:o,stderr:i,error:a});}),n.once("close",a=>{s({status:a,stdout:o,stderr:i});});})}async function h(e,t,r){return r.runCommandAsync?r.runCommandAsync(e,t):r.runCommand?r.runCommand(e,t):b(e,t)}function O(e){return new Promise(t=>{setTimeout(t,Math.max(0,e));})}function x(){return new Promise(e=>{setImmediate(e);})}function f(e,t=process.kill){try{return t(e,0),"alive"}catch(r){return g(r)==="ESRCH"?"not_found":g(r)==="EPERM"?"alive":"unknown"}}function M(e,t){if(!w(e))return {status:"unknown"};let r=t.platform??process.platform,n=t.runCommand??E,o=r==="win32"?"powershell.exe":"ps",i=r==="win32"?["-NoLogo","-NoProfile","-NonInteractive","-ExecutionPolicy","Bypass","-Command",`$p = Get-CimInstance -ClassName Win32_Process -Filter 'ProcessId = ${e}' -ErrorAction Stop; if ($null -ne $p) { [Console]::Write([string]$p.CommandLine) }`]:["-p",String(e),"-o","command="],u;try{u=n(o,i);}catch{return {status:"unknown"}}if(u.error||u.status!==0)return {status:"unknown"};let s=u.stdout.trim();return s?{status:"found",commandLine:s}:{status:"not_found"}}function N(e,t){let r=f(-e,t),n=f(e,t);return r==="alive"||n==="alive"?"alive":r==="unknown"||n==="unknown"?"unknown":"not_found"}async function k(e,t,r,n){let o=Math.max(0,r),i=Math.max(1,n.pollIntervalMs??R),u=Date.now()+o,s,m=o===0,a=n.sleep?Promise.resolve().then(()=>n.sleep(o)).then(()=>{},()=>{}):new Promise(c=>{s=setTimeout(c,o);});a.then(()=>{m=true;});try{for(await x();;){let c=N(e,t);if(c==="not_found")return c;let l=u-Date.now();if(m||l<=0)return c;await Promise.race([a,O(Math.min(i,l))]);}}finally{s!==void 0&&clearTimeout(s);}}async function y(e,t,r,n,o){let i=await k(e,t,o.hardConfirmMs??L,{...o,sleep:void 0});return i==="not_found"?r?{status:"not_found",pid:e,method:n}:{status:"terminated",pid:e,method:n}:i==="alive"?{status:"failed",pid:e,method:n,error:"Process is still running after termination attempt"}:{status:"failed",pid:e,method:n,error:"Unable to verify process termination"}}function A(e,t,r={}){let n=M(e,r);if(n.status!=="found")return n.status;let o=r.platform??process.platform,i=o==="win32"?n.commandLine.toLowerCase():n.commandLine;return t.filter(s=>s.trim().length>0).some(s=>{let m=o==="win32"?s.toLowerCase():s;return i.includes(m)})?"owned":"not_owned"}async function G(e,t,r={}){if(!w(e))return "unknown";let n=r.platform??process.platform,o=n==="win32"?"powershell.exe":"ps",i=n==="win32"?["-NoLogo","-NoProfile","-NonInteractive","-ExecutionPolicy","Bypass","-Command",`$p = Get-CimInstance -ClassName Win32_Process -Filter 'ProcessId = ${e}' -ErrorAction Stop; if ($null -ne $p) { [Console]::Write([string]$p.CommandLine) }`]:["-p",String(e),"-o","command="],u;try{u=await h(o,i,r);}catch{return "unknown"}if(u.error||u.status!==0)return "unknown";let s=u.stdout.trim();if(!s)return "not_found";let m=n==="win32"?s.toLowerCase():s;return t.filter(c=>c.trim().length>0).some(c=>{let l=n==="win32"?c.toLowerCase():c;return m.includes(l)})?"owned":"not_owned"}async function $(e,t={}){let r=t.platform??process.platform,n=r==="win32"?"taskkill":"process-group",o=d=>({status:"failed",pid:e,method:n,error:d});if(!w(e))return o("Invalid process ID");let i=t.kill??process.kill,u=f(e,i);if(u==="not_found")return {status:"not_found",pid:e,method:n};if(u!=="alive")return o("Unable to determine whether the process is alive");if(r==="win32"){let d;try{d=await h("taskkill",["/PID",String(e),"/T","/F"],t);}catch(S){d={status:null,stdout:"",stderr:"",error:p(S)};}let C=f(e,i);return C==="not_found"?d.status===0&&!d.error?{status:"terminated",pid:e,method:n}:{status:"not_found",pid:e,method:n}:o(C==="alive"?"Process is still running after termination attempt":"Unable to verify process termination")}let s,m=t.signal??"SIGKILL";try{i(-e,m);}catch(d){s=d;}if(m==="SIGKILL")return y(e,i,s,n,t);if(await k(e,i,t.graceMs??_,t)==="not_found")return s?{status:"not_found",pid:e,method:n}:{status:"terminated",pid:e,method:n};let c;try{i(-e,"SIGKILL");}catch(d){c=d;}let l=await y(e,i,c,n,t);return l.status==="terminated"?l:l.status==="not_found"?s?l:{status:"terminated",pid:e,method:n}:o(l.error??"Process termination failed")}exports.UNIX_PROCESS_POLL_INTERVAL_MS=R;exports.UNIX_SIGKILL_CONFIRM_MS=L;exports.UNIX_SIGTERM_GRACE_MS=_;exports.checkProcessOwnership=A;exports.checkProcessOwnershipAsync=G;exports.probeProcessLiveness=f;exports.terminateProcessTree=$;

package/dist/process/process-control.d.ts

@@ -0,0 +1,40 @@
+export type ProcessLiveness = 'alive' | 'not_found' | 'unknown';
+export type ProcessOwnership = 'owned' | 'not_owned' | 'not_found' | 'unknown';
+export type ProcessTerminationStatus = 'terminated' | 'not_found' | 'failed';
+export interface ProcessCommandResult {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+    error?: Error;
+}
+export type ProcessCommandRunner = (command: string, args: string[]) => ProcessCommandResult;
+export type ProcessCommandRunnerAsync = (command: string, args: string[]) => Promise<ProcessCommandResult>;
+export interface ProcessControlOptions {
+    platform?: NodeJS.Platform;
+    kill?: typeof process.kill;
+    runCommand?: ProcessCommandRunner;
+    runCommandAsync?: ProcessCommandRunnerAsync;
+    sleep?: (ms: number) => void | PromiseLike<void>;
+    graceMs?: number;
+    pollIntervalMs?: number;
+    hardConfirmMs?: number;
+}
+export interface ProcessCommandLineResult {
+    status: 'found' | 'not_found' | 'unknown';
+    commandLine?: string;
+}
+export interface ProcessTerminationResult {
+    status: ProcessTerminationStatus;
+    pid: number;
+    method: 'taskkill' | 'process-group';
+    error?: string;
+}
+export declare const UNIX_SIGTERM_GRACE_MS = 2000;
+export declare const UNIX_PROCESS_POLL_INTERVAL_MS = 25;
+export declare const UNIX_SIGKILL_CONFIRM_MS = 100;
+export declare function probeProcessLiveness(pid: number, kill?: typeof process.kill): ProcessLiveness;
+export declare function checkProcessOwnership(pid: number, markers: readonly string[], options?: ProcessControlOptions): ProcessOwnership;
+export declare function checkProcessOwnershipAsync(pid: number, markers: readonly string[], options?: ProcessControlOptions): Promise<ProcessOwnership>;
+export declare function terminateProcessTree(pid: number, options?: ProcessControlOptions & {
+    signal?: NodeJS.Signals;
+}): Promise<ProcessTerminationResult>;

package/dist/prompt/tag-names.d.ts

@@ -0,0 +1,18 @@
+export declare const PROMPT_TAGS: {
+    readonly crewxSystemPrompt: "crewx_system_prompt";
+    readonly systemPrompt: "system_prompt";
+    readonly threadContext: "crewx_thread_context";
+    readonly threadState: "thread_state";
+    readonly highlights: "highlights";
+    readonly highlight: "highlight";
+    readonly omittedTurns: "omitted_turns";
+    readonly messages: "messages";
+    readonly message: "message";
+    readonly userQuery: "user_query";
+    readonly execOutput: "exec_output";
+};
+export declare const LEGACY_PROMPT_TAGS: {
+    readonly conversationHistory: "conversation_history";
+    readonly semanticContinuity: "semantic_continuity";
+    readonly execOutput: "exec-output";
+};

package/dist/provider/task-error.types.d.ts

@@ -1,4 +1,4 @@
-export type TaskErrorCode = 'USAGE_LIMITED' | 'CONTEXT_WINDOW_EXCEEDED' | 'INPUT_TOO_LARGE' | 'MODEL_NOT_SUPPORTED' | 'MODEL_AT_CAPACITY' | 'AUTH_REQUIRED' | 'CLI_NOT_AVAILABLE' | 'CLI_UPDATE_REQUIRED' | 'AGENT_NOT_FOUND' | 'PERMISSION_OR_TRUST' | 'TIMEOUT_OR_STUCK' | 'NETWORK_OR_PROVIDER_TRANSIENT' | 'PROVIDER_CONFIGURATION' | 'PROCESS_FAILED';
+export type TaskErrorCode = 'USAGE_LIMITED' | 'CONTEXT_WINDOW_EXCEEDED' | 'INPUT_TOO_LARGE' | 'MODEL_NOT_SUPPORTED' | 'MODEL_AT_CAPACITY' | 'AUTH_REQUIRED' | 'CLI_NOT_AVAILABLE' | 'CLI_UPDATE_REQUIRED' | 'AGENT_NOT_FOUND' | 'PERMISSION_OR_TRUST' | 'TIMEOUT_OR_STUCK' | 'NETWORK_OR_PROVIDER_TRANSIENT' | 'PROVIDER_CONFIGURATION' | 'AGENT_MODE_RESTRICTED' | 'PROCESS_FAILED';
 export interface TaskErrorMeta {
     resetAt?: string | number;
     model?: string;
@@ -6,6 +6,7 @@ export interface TaskErrorMeta {
     envKey?: string;
     upstreamType?: string;
     upstreamCode?: string | number;
+    mode?: string;
     referenceId?: string;
     technicalMessage?: string;
 }

package/dist/repository/index.d.ts

@@ -15,8 +15,19 @@ export { pushSchema } from './push.js';
 export type { PushResult } from './push.js';
 export type { Workspace, NewWorkspace } from '../schema/index.js';
 export { tasks } from '../schema/index.js';
-export { TaskRepository } from './task.repository.js';
-export type { TaskRow, TaskActivityLogRow, FindTasksByThreadOptions, TaskListRow, NewTask, AgentUsageRow, TrendRow, ProviderUsageRow, ModelUsageRow, ReportTaskRow, DelegationEdge, DelegationMatrixResult, WorkflowCardRow, WorkflowParentTaskKind, WorkflowParentTaskLookup, WorkflowParentTaskRow, } from './task.repository.js';
+export { DEFAULT_TASK_REAPER_TICK_INTERVAL_MS, mergeTerminalReason, TaskRepository, TASK_HEARTBEAT_HARD_STALE_MS, TASK_HEARTBEAT_INTERVAL_MS, TASK_HEARTBEAT_STALE_MS, resolveTaskHeartbeatHardStaleMs, resolveTaskHeartbeatIntervalMs, resolveTaskHeartbeatStaleMs, } from './task.repository.js';
+export type { ReapOrphanedTasksOptions } from './task.repository.js';
+export type { FinalizeTaskStopOptions, TaskStopMethod, TaskStopRequestResult, } from './task.repository.js';
+export { stopTask, resolveTaskStopMethod, TASK_STOP_DEFAULT_GRACE_MS, TASK_STOP_DEFAULT_POLL_MS, TASK_STOP_OWNED_PROCESS_MARKERS, } from '../lifecycle/task-stop.js';
+export type { StopTaskOptions, StopTaskProcessControl, StopTaskResult, StopTaskStatus, } from '../lifecycle/task-stop.js';
+export { runHeartbeatTick, startTaskHeartbeat, stopTaskHeartbeat, TASK_STOP_POLL_INTERVAL_MS, taskHeartbeatRegistry, } from '../lifecycle/task-heartbeat.js';
+export type { HeartbeatTickResult, TaskHeartbeatHandle, TaskHeartbeatOptions, TaskHeartbeatRow, } from '../lifecycle/task-heartbeat.js';
+export { LEGACY_TASK_TERMINAL_ERROR_PATTERNS, normalizeTaskStatus, TASK_TERMINAL_STATUSES, } from './task-status.js';
+export type { TaskStatus, TaskStatusInput, TaskTerminalReason, TaskTerminalStatus, } from './task-status.js';
+export { hasRecordedUsage } from './task.repository.js';
+export type { TaskRow, TaskKillResult, TaskKillStatus, TaskActivityLogRow, FindTasksByThreadOptions, TaskListRow, NewTask, AgentUsageRow, TrendRow, ProviderUsageRow, ModelUsageRow, ReportTaskRow, DelegationEdge, DelegationMatrixResult, WorkflowCardRow, WorkflowParentTaskKind, WorkflowParentTaskLookup, WorkflowParentTaskRow, } from './task.repository.js';
+export { classifyUsageAccountingReason, runUsageBackfill, USAGE_BACKFILL_MAX_LATE_USAGE_AGE_MS, USAGE_BACKFILL_TERMINAL_STATUSES, } from './usage-backfill.js';
+export type { UsageAccountingReason, UsageBackfillFailure, UsageBackfillMode, UsageBackfillOptions, UsageBackfillProviderStats, UsageBackfillReport, } from './usage-backfill.js';
 export { TaskLogRepository } from './task-log.repository.js';
 export type { TaskLogEntry, RawTaskLogEntry, TaskLogRawEntry, TaskLogStorage, TaskLogState, TaskLogReadResult, TaskLogRepositoryContract, } from './task-log.repository.js';
 export { runTaskLogMigration, resolveTaskLogMigrationDbPath, taskLogBackupName, tryCheckpointTaskLogWal, hasSufficientTaskLogMigrationFreeSpace, } from './task-log-migration.js';