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

package/dist/lifecycle/task-heartbeat.d.ts

@@ -0,0 +1,41 @@
+import type { TaskRepository } from '../repository/task.repository.js';
+export declare const TASK_HEARTBEAT_INTERVAL_MS = 10000;
+export declare const TASK_HEARTBEAT_STALE_MS = 30000;
+export declare const TASK_HEARTBEAT_HARD_STALE_MS: number;
+export declare const TASK_STOP_POLL_INTERVAL_MS = 1000;
+export declare function resolveTaskHeartbeatIntervalMs(): number;
+export declare function resolveTaskHeartbeatStaleMs(): number;
+export declare function resolveTaskHeartbeatHardStaleMs(): number;
+export interface TaskHeartbeatRow {
+    id?: string;
+    status: string;
+    run_epoch: number | null;
+    stop_requested_at: string | null;
+    stop_requested_epoch: number | null;
+    pid?: number | null;
+    metadata?: string | null;
+    started_at?: string;
+    duration_ms?: number | null;
+}
+export interface HeartbeatTickResult {
+    accepted: boolean;
+    row: TaskHeartbeatRow | null;
+}
+export interface TaskHeartbeatOptions {
+    taskId: string;
+    runEpoch: number;
+    onStopRequested?: (row: TaskHeartbeatRow) => void | Promise<void>;
+}
+export interface TaskHeartbeatHandle {
+    timer: ReturnType<typeof setInterval>;
+    runEpoch: number;
+    stopRequested: boolean;
+    lastHeartbeatAt: number;
+    heartbeatElapsedMs: number;
+}
+export declare const taskHeartbeatRegistry: Map<string, TaskHeartbeatHandle>;
+export declare function runHeartbeatTick(repo: Pick<TaskRepository, 'heartbeatTask' | 'getTask'>, options: TaskHeartbeatOptions & {
+    writeHeartbeat?: boolean;
+}): HeartbeatTickResult;
+export declare function stopTaskHeartbeat(taskId: string, runEpoch?: number | null): boolean;
+export declare function startTaskHeartbeat(repo: Pick<TaskRepository, 'heartbeatTask' | 'getTask'>, options: TaskHeartbeatOptions): boolean;

package/dist/lifecycle/task-stop.d.ts

@@ -0,0 +1,30 @@
+import type { TaskRepository } from '../repository/task.repository.js';
+import { checkProcessOwnershipAsync as defaultCheckProcessOwnershipAsync, terminateProcessTree as defaultTerminateProcessTree, type ProcessControlOptions } from '../process/process-control.js';
+export declare const TASK_STOP_DEFAULT_GRACE_MS = 5000;
+export declare const TASK_STOP_DEFAULT_POLL_MS = 250;
+export declare function resolveTaskStopMethod(requestedAt: string | null | undefined, completedAt?: string | number, graceMs?: number): 'cooperative' | 'forced';
+export declare const TASK_STOP_OWNED_PROCESS_MARKERS: readonly ["crewx", "claude", "codex", "opencode", "grok", "node"];
+export type StopTaskStatus = 'stopped' | 'not_running' | 'already_requested' | 'ownership_unverified' | 'failed';
+export interface StopTaskResult {
+    status: StopTaskStatus;
+    method?: 'cooperative' | 'forced';
+    finalStatus: string | null;
+    pid?: number;
+    error?: string;
+}
+export interface StopTaskProcessControl {
+    checkProcessOwnershipAsync?: typeof defaultCheckProcessOwnershipAsync;
+    terminateProcessTree?: typeof defaultTerminateProcessTree;
+}
+export interface StopTaskOptions {
+    graceMs?: number;
+    pollMs?: number;
+    platform?: NodeJS.Platform;
+    ownershipMarkers?: readonly string[];
+    processControl?: StopTaskProcessControl;
+    processControlOptions?: ProcessControlOptions;
+}
+type StopTaskRepository = Pick<TaskRepository, 'requestTaskStop' | 'getTask' | 'finalizeTaskStop'>;
+export declare function stopTask(taskId: string, options?: StopTaskOptions): Promise<StopTaskResult>;
+export declare function stopTask(repo: StopTaskRepository, taskId: string, options?: StopTaskOptions): Promise<StopTaskResult>;
+export {};

package/dist/migrations/0025_task_heartbeat.sql

@@ -0,0 +1,8 @@
+ALTER TABLE `tasks` ADD `heartbeat_at` text;
+--> statement-breakpoint
+ALTER TABLE `tasks` ADD `stop_requested_at` text;
+--> statement-breakpoint
+ALTER TABLE `tasks` ADD `stop_requested_epoch` integer;
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `idx_tasks_status_heartbeat`
+	ON `tasks` (`status`, `heartbeat_at`);

package/dist/migrations/meta/_journal.json

@@ -176,6 +176,13 @@
       "when": 1788604428845,
       "tag": "0024_storage_metadata",
       "breakpoints": true
+    },
+    {
+      "idx": 25,
+      "version": "6",
+      "when": 1789128000000,
+      "tag": "0025_task_heartbeat",
+      "breakpoints": true
     }
   ]
 }

package/dist/plugins/index.d.ts

@@ -1,6 +1,6 @@
 export { FileLoggerPlugin } from './file-logger';
 export type { FileLoggerPluginOptions } from './file-logger';
 export { SqliteTracingPlugin } from './sqlite-tracing';
-export type { SqliteTracingPluginOptions } from './sqlite-tracing';
+export type { SqliteTracingPluginOptions, SqliteTracingRunnerIdentity } from './sqlite-tracing';
 export { ConversationPlugin } from './conversation';
 export type { ConversationPluginOptions } from './conversation';