crewly 1.4.31 → 1.4.32

package/dist/backend/backend/src/services/agent/crewly-agent/agent-worker.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Agent Worker Process
+ *
+ * Standalone Node.js child process that wraps AgentRunnerService for
+ * isolated agent execution. Communicates with the parent process via
+ * IPC messages (Node.js child_process.fork() protocol).
+ *
+ * This enables hot-reload of agent code without restarting the main
+ * backend process, and crash isolation so a worker failure doesn't
+ * bring down the server.
+ *
+ * @module services/agent/crewly-agent/agent-worker
+ */
+import type { CrewlyAgentConfig, AgentRunResult } from './types.js';
+/**
+ * Messages sent from the parent process to this worker.
+ */
+export type ParentMessage = {
+    type: 'init';
+    config: CrewlyAgentConfig;
+} | {
+    type: 'run';
+    message: string;
+    conversationId?: string;
+    metadata?: Record<string, string>;
+} | {
+    type: 'abort';
+} | {
+    type: 'get-state';
+} | {
+    type: 'shutdown';
+};
+/**
+ * Messages sent from this worker to the parent process.
+ */
+export type WorkerMessage = {
+    type: 'ready';
+} | {
+    type: 'result';
+    data: AgentRunResult;
+} | {
+    type: 'error';
+    error: string;
+    code?: string;
+} | {
+    type: 'log';
+    level: 'debug' | 'info' | 'warn' | 'error';
+    message: string;
+} | {
+    type: 'stream';
+    event: 'text';
+    data: {
+        chunk: string;
+    };
+} | {
+    type: 'stream';
+    event: 'toolStart';
+    data: {
+        toolName: string;
+        args: Record<string, unknown>;
+    };
+} | {
+    type: 'stream';
+    event: 'toolFinish';
+    data: {
+        toolName: string;
+        args: Record<string, unknown>;
+        result: unknown;
+        durationMs: number;
+    };
+} | {
+    type: 'stream';
+    event: 'stepFinish';
+    data: {
+        stepIndex: number;
+        hasToolCalls: boolean;
+    };
+} | {
+    type: 'state';
+    data: {
+        historyLength: number;
+        isProcessing: boolean;
+        isInitialized: boolean;
+    };
+};
+//# sourceMappingURL=agent-worker.d.ts.map

package/dist/backend/backend/src/services/agent/crewly-agent/agent-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-worker.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/agent-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EAEf,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC5F;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CAAE,GACjG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACvI;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,CAAC"}

package/dist/backend/backend/src/services/agent/crewly-agent/agent-worker.js

@@ -0,0 +1,147 @@
+/**
+ * Agent Worker Process
+ *
+ * Standalone Node.js child process that wraps AgentRunnerService for
+ * isolated agent execution. Communicates with the parent process via
+ * IPC messages (Node.js child_process.fork() protocol).
+ *
+ * This enables hot-reload of agent code without restarting the main
+ * backend process, and crash isolation so a worker failure doesn't
+ * bring down the server.
+ *
+ * @module services/agent/crewly-agent/agent-worker
+ */
+import { AgentRunnerService } from './agent-runner.service.js';
+// ===== Worker State =====
+let runner = null;
+/**
+ * Send a typed message to the parent process.
+ *
+ * @param msg - Worker message to send
+ */
+function send(msg) {
+    if (process.send) {
+        process.send(msg);
+    }
+}
+/**
+ * Build streaming callbacks that forward events to the parent via IPC.
+ *
+ * @returns StreamingEventCallbacks that emit IPC messages
+ */
+function buildStreamingCallbacks() {
+    return {
+        onTextChunk: (chunk) => {
+            send({ type: 'stream', event: 'text', data: { chunk } });
+        },
+        onToolCallStart: (toolName, args) => {
+            send({ type: 'stream', event: 'toolStart', data: { toolName, args } });
+        },
+        onToolCallFinish: (toolName, args, result, durationMs) => {
+            send({ type: 'stream', event: 'toolFinish', data: { toolName, args, result, durationMs } });
+        },
+        onStepFinish: (stepIndex, hasToolCalls) => {
+            send({ type: 'stream', event: 'stepFinish', data: { stepIndex, hasToolCalls } });
+        },
+    };
+}
+/** AbortController for the currently executing run */
+let currentAbort = null;
+/**
+ * Handle incoming messages from the parent process.
+ *
+ * @param msg - Parent message received via IPC
+ */
+async function handleMessage(msg) {
+    switch (msg.type) {
+        case 'init': {
+            try {
+                runner = new AgentRunnerService(msg.config);
+                await runner.initialize();
+                send({ type: 'ready' });
+                send({ type: 'log', level: 'info', message: `Worker initialized (${msg.config.model.provider}/${msg.config.model.modelId})` });
+            }
+            catch (err) {
+                const errMsg = err instanceof Error ? err.message : String(err);
+                send({ type: 'error', error: `Init failed: ${errMsg}`, code: 'INIT_FAILED' });
+                runner = null;
+            }
+            break;
+        }
+        case 'run': {
+            if (!runner || !runner.isInitialized()) {
+                send({ type: 'error', error: 'Worker not initialized', code: 'NOT_INITIALIZED' });
+                return;
+            }
+            currentAbort = new AbortController();
+            const streamingCallbacks = buildStreamingCallbacks();
+            try {
+                const result = await runner.run(msg.message, msg.conversationId, msg.metadata, {
+                    abortSignal: currentAbort.signal,
+                    streaming: streamingCallbacks,
+                });
+                currentAbort = null;
+                send({ type: 'result', data: result });
+            }
+            catch (err) {
+                currentAbort = null;
+                const errMsg = err instanceof Error ? err.message : String(err);
+                send({ type: 'error', error: errMsg, code: 'RUN_FAILED' });
+            }
+            break;
+        }
+        case 'abort': {
+            if (currentAbort) {
+                currentAbort.abort();
+                currentAbort = null;
+                send({ type: 'log', level: 'warn', message: 'Run aborted by parent' });
+            }
+            if (runner) {
+                runner.abortCurrentRun();
+            }
+            break;
+        }
+        case 'get-state': {
+            send({
+                type: 'state',
+                data: {
+                    historyLength: runner ? runner.getHistoryLength() : 0,
+                    isProcessing: runner ? runner.isProcessing() : false,
+                    isInitialized: runner ? runner.isInitialized() : false,
+                },
+            });
+            break;
+        }
+        case 'shutdown': {
+            send({ type: 'log', level: 'info', message: 'Worker shutting down' });
+            if (runner) {
+                await runner.shutdown();
+                runner = null;
+            }
+            // Give IPC a moment to flush, then exit
+            setTimeout(() => process.exit(0), 100);
+            break;
+        }
+    }
+}
+// ===== Process Setup =====
+// Listen for IPC messages from parent
+process.on('message', (msg) => {
+    handleMessage(msg).catch((err) => {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        send({ type: 'error', error: `Unhandled worker error: ${errMsg}`, code: 'UNHANDLED' });
+    });
+});
+// Handle uncaught exceptions — report to parent before crashing
+process.on('uncaughtException', (err) => {
+    send({ type: 'error', error: `Worker crash (uncaughtException): ${err.message}`, code: 'CRASH' });
+    setTimeout(() => process.exit(1), 100);
+});
+process.on('unhandledRejection', (reason) => {
+    const msg = reason instanceof Error ? reason.message : String(reason);
+    send({ type: 'error', error: `Worker crash (unhandledRejection): ${msg}`, code: 'CRASH' });
+    setTimeout(() => process.exit(1), 100);
+});
+// Signal ready to receive init
+send({ type: 'log', level: 'info', message: 'Agent worker process started, awaiting init' });
+//# sourceMappingURL=agent-worker.js.map

package/dist/backend/backend/src/services/agent/crewly-agent/agent-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-worker.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/agent-worker.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/agent/crewly-agent/crewly-agent-runtime.service.d.ts

@@ -1,12 +1,11 @@
 /**
  * Crewly Agent Runtime Service
  *
- * Concrete RuntimeAgentService subclass for the in-process Crewly Agent.
- * Unlike PTY-based runtimes (Claude Code, Gemini CLI), this runtime runs
- * entirely inside the Node.js process using the Vercel AI SDK.
- *
- * No tmux session, no shell commands — messages are routed directly to
- * the AgentRunnerService.handleMessage() method.
+ * Concrete RuntimeAgentService subclass for the Crewly Agent.
+ * Supports two execution modes:
+ * - **In-process** (default): AgentRunner runs in the main Node.js process
+ * - **Worker process**: AgentRunner runs in a child process via fork(),
+ *   enabling hot-reload and crash isolation
  *
  * @module services/agent/crewly-agent/crewly-agent-runtime.service
  */
@@ -16,19 +15,25 @@ import { type RuntimeType } from '../../../constants.js';
 import type { CrewlyAgentConfig, AgentRunResult } from './types.js';
 import { SessionCommandHelper } from '../../session/index.js';
 /**
- * In-process Crewly Agent runtime powered by AI SDK generateText.
+ * Crewly Agent runtime with optional worker process isolation.
  *
- * Key differences from PTY-based runtimes:
- * - No tmux session needed — runs in-process
- * - Messages routed via handleMessage() instead of PTY write
- * - System prompt loaded from config/roles/orchestrator/prompt.md
- * - Ready immediately after initialization (no CLI startup wait)
+ * Supports two modes:
+ * - **In-process** (default): AgentRunner runs directly in the main process
+ * - **Worker process** (`useWorkerProcess: true`): AgentRunner runs in a
+ *   forked child process, enabling hot-reload and crash isolation
  *
  * @example
  * ```typescript
+ * // In-process mode (default)
  * const runtime = new CrewlyAgentRuntimeService(sessionHelper, projectRoot);
  * await runtime.initializeInProcess('crewly-orc');
- * const result = await runtime.handleMessage('Check all team statuses');
+ *
+ * // Worker process mode
+ * const runtime = new CrewlyAgentRuntimeService(sessionHelper, projectRoot);
+ * await runtime.initializeInProcess('crewly-orc', { useWorkerProcess: true });
+ *
+ * // Hot-reload: restart worker with fresh code, preserving session
+ * await runtime.hotReload();
  * ```
  */
 export declare class CrewlyAgentRuntimeService extends RuntimeAgentService {
@@ -40,6 +45,20 @@ export declare class CrewlyAgentRuntimeService extends RuntimeAgentService {
     private logBuffer;
     private rateLimiter;
     private heartbeatTimer;
+    /** AbortController for the currently executing message — enables external abort */
+    private messageAbortController;
+    /** Whether this instance uses a worker process instead of in-process execution */
+    private useWorkerProcess;
+    /** The forked worker child process */
+    private workerProcess;
+    /** Stored config for hot-reload — needed to re-init the worker */
+    private storedConfig;
+    /** Pending promise resolver for the current worker run */
+    private workerRunResolve;
+    /** Pending promise rejector for the current worker run */
+    private workerRunReject;
+    /** Whether the worker is currently processing a message */
+    private workerProcessing;
     constructor(sessionHelper: SessionCommandHelper, projectRoot: string);
     /**
      * Get the runtime type identifier.
@@ -75,16 +94,18 @@ export declare class CrewlyAgentRuntimeService extends RuntimeAgentService {
      */
     protected getRuntimeExitPatterns(): RegExp[];
     /**
-     * Initialize the in-process agent runtime.
+     * Initialize the agent runtime.
      *
      * Loads the system prompt from config/roles/orchestrator/prompt.md,
-     * creates the AgentRunnerService, and initializes the model.
+     * creates the AgentRunnerService (in-process or worker), and initializes the model.
      *
      * @param sessionName - Session name for this agent instance
-     * @param config - Optional partial config overrides
+     * @param config - Optional partial config overrides. Set `useWorkerProcess: true` to run in a child process.
      * @param roleName - Role name for system prompt lookup (default: 'orchestrator')
      */
-    initializeInProcess(sessionName: string, config?: Partial<CrewlyAgentConfig>, roleName?: string): Promise<void>;
+    initializeInProcess(sessionName: string, config?: Partial<CrewlyAgentConfig> & {
+        useWorkerProcess?: boolean;
+    }, roleName?: string): Promise<void>;
     /**
      * Handle an incoming message by routing it to the AgentRunner.
      *
@@ -123,6 +144,16 @@ export declare class CrewlyAgentRuntimeService extends RuntimeAgentService {
      * @returns True if initializeInProcess() has been called successfully
      */
     isReady(): boolean;
+    /**
+     * Abort the currently executing message processing.
+     *
+     * Cancels the active model call, terminates running tool processes,
+     * and returns partial results where possible. Safe to call at any time —
+     * returns false if no run is in progress.
+     *
+     * @returns True if an active run was aborted, false if nothing was running
+     */
+    abortCurrentRun(): boolean;
     /**
      * Get the current agent runner instance (for inspection/testing).
      *
@@ -140,6 +171,80 @@ export declare class CrewlyAgentRuntimeService extends RuntimeAgentService {
      * Clears the agent runner and resets state.
      */
     shutdown(): void;
+    /**
+     * Hot-reload the worker process.
+     *
+     * Kills the existing worker and spawns a fresh one with the stored config.
+     * This allows updating agent code without restarting the main backend.
+     * Conversation state is reset — use this when deploying new agent logic.
+     *
+     * @throws Error if not in worker mode or config is missing
+     */
+    hotReload(): Promise<void>;
+    /**
+     * Check if the runtime is using a worker process.
+     *
+     * @returns True if running in worker process mode
+     */
+    isWorkerMode(): boolean;
+    /**
+     * Get the worker process PID (for monitoring/debugging).
+     *
+     * @returns Worker PID, or null if not in worker mode or worker is not running
+     */
+    getWorkerPid(): number | null;
+    /**
+     * Initialize a worker child process via fork().
+     *
+     * Forks the agent-worker.ts entry point and sends the init message
+     * with the agent config. Waits for the 'ready' response before resolving.
+     *
+     * @param config - Full agent config to send to the worker
+     * @throws Error if worker fails to initialize within timeout
+     */
+    private initializeWorker;
+    /**
+     * Execute a message via the worker process using IPC.
+     *
+     * Sends a 'run' message to the worker and waits for the 'result' or 'error'
+     * response. Streaming events are forwarded to the InProcessLogBuffer in real-time.
+     *
+     * @param session - Session name
+     * @param cleanMessage - Message content (prefix already stripped)
+     * @param conversationId - Optional conversation ID
+     * @param _metadata - Optional metadata (passed to worker)
+     * @returns Agent run result from the worker
+     */
+    private executeMessageViaWorker;
+    /**
+     * Handle messages received from the worker process.
+     *
+     * Routes streaming events to the InProcessLogBuffer and resolves/rejects
+     * pending run promises on result/error messages.
+     *
+     * @param msg - Worker message received via IPC
+     */
+    private handleWorkerMessage;
+    /**
+     * Send a typed message to the worker process.
+     *
+     * @param msg - Parent message to send
+     */
+    private sendToWorker;
+    /**
+     * Terminate the worker process gracefully, with a forced kill fallback.
+     */
+    private terminateWorker;
+    /**
+     * Get the path to the compiled worker entry file.
+     *
+     * @returns Absolute path to the agent-worker.js compiled file
+     */
+    /**
+     * @internal Visible for testing — override to provide a custom worker path.
+     */
+    _workerEntryPath: string | null;
+    private getWorkerEntryPath;
     /**
      * Start periodic heartbeat to keep the in-process agent marked as active.
      *

package/dist/backend/backend/src/services/agent/crewly-agent/crewly-agent-runtime.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crewly-agent-runtime.service.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/crewly-agent-runtime.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAoD,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE3G,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAS9D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,yBAA0B,SAAQ,mBAAmB;IAChE,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,cAAc,CAA+C;gBAEzD,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM;IAQpE;;;;OAIG;IACH,SAAS,CAAC,cAAc,IAAI,WAAW;IAIvC;;;;;;OAMG;cACa,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7E;;;;;OAKG;IACH,SAAS,CAAC,uBAAuB,IAAI,MAAM,EAAE;IAI7C;;;;OAIG;IACH,SAAS,CAAC,uBAAuB,IAAI,MAAM,EAAE;IAI7C;;;;OAIG;IACH,SAAS,CAAC,sBAAsB,IAAI,MAAM,EAAE;IAM5C;;;;;;;;;OASG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACnC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IA6ChB;;;;;;;;;;OAUG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IA4ChG;;;;;;;;;;;OAWG;YACW,cAAc;IAuD5B;;;;;OAKG;YACW,yBAAyB;IAavC;;;;OAIG;IACH,OAAO,IAAI,OAAO;IAIlB;;;;OAIG;IACH,cAAc,IAAI,kBAAkB,GAAG,IAAI;IAI3C;;;;OAIG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B;;;OAGG;IACH,QAAQ,IAAI,IAAI;IAsBhB;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;IAoCtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;OAKG;YACW,gBAAgB;IAkB9B;;;;;;;;;;;;;OAaG;IACG,yBAAyB,CAAC,QAAQ,GAAE,MAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BnF;;;;;;;OAOG;YACW,wBAAwB;IAsBtC;;;;;;;;OAQG;YACW,mBAAmB;CAqClC"}
+{"version":3,"file":"crewly-agent-runtime.service.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/agent/crewly-agent/crewly-agent-runtime.service.ts"],"names":[],"mappings":"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"}