@fideliosai/server 0.0.11 → 0.0.13

package/dist/services/heartbeat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/services/heartbeat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/services/heartbeat.ts"],"names":[],"mappings":"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"}

package/dist/services/heartbeat.js

@@ -727,13 +727,20 @@ export function heartbeatService(db) {
             readNonEmptyString(latestSummary?.result) ??
             readNonEmptyString(latestSummary?.message) ??
             readNonEmptyString(latestRun.error);
+        const agentHome = resolveDefaultAgentWorkspaceDir(agent.id);
+        const today = new Date().toISOString().slice(0, 10);
         const handoffMarkdown = [
             "FideliOS session handoff:",
             `- Previous session: ${sessionId}`,
             issueId ? `- Issue: ${issueId}` : "",
             `- Rotation reason: ${reason}`,
             latestTextSummary ? `- Last run summary: ${latestTextSummary}` : "",
-            "Continue from the current task state. Rebuild only the minimum context you need.",
+            "",
+            "Your persistent memory (if you have written any) survives session rotation:",
+            `- Daily notes: ${agentHome}/memory/ (check for ${today}.md or recent dates)`,
+            `- Knowledge graph: ${agentHome}/life/ (PARA structure)`,
+            `- Lessons learned: ${agentHome}/MEMORY.md (may not exist yet)`,
+            "Use glob or ls to check which memory files exist before reading. Do NOT assume files exist — create them if missing.",
         ]
             .filter(Boolean)
             .join("\n");
@@ -979,6 +986,7 @@ export function heartbeatService(db) {
                 sessionDisplayId: input.sessionDisplayId,
                 lastRunId: input.lastRunId,
                 lastError: input.lastError,
+                ...(input.lastSeenCommentId !== undefined ? { lastSeenCommentId: input.lastSeenCommentId } : {}),
                 updatedAt: new Date(),
             })
                 .where(eq(agentTaskSessions.id, existing.id))
@@ -996,6 +1004,7 @@ export function heartbeatService(db) {
             sessionDisplayId: input.sessionDisplayId,
             lastRunId: input.lastRunId,
             lastError: input.lastError,
+            ...(input.lastSeenCommentId !== undefined ? { lastSeenCommentId: input.lastSeenCommentId } : {}),
         })
             .returning()
             .then((rows) => rows[0] ?? null);
@@ -1364,25 +1373,21 @@ export function heartbeatService(db) {
             }
             const tracksLocalChild = isTrackedLocalChildProcessAdapter(adapterType);
             if (tracksLocalChild && run.processPid && isProcessAlive(run.processPid)) {
-                if (run.errorCode !== DETACHED_PROCESS_ERROR_CODE) {
-                    const detachedMessage = `Lost in-memory process handle, but child pid ${run.processPid} is still alive`;
-                    const detachedRun = await setRunStatus(run.id, "running", {
-                        error: detachedMessage,
-                        errorCode: DETACHED_PROCESS_ERROR_CODE,
-                    });
-                    if (detachedRun) {
-                        await appendRunEvent(detachedRun, await nextRunEventSeq(detachedRun.id), {
-                            eventType: "lifecycle",
-                            stream: "system",
-                            level: "warn",
-                            message: detachedMessage,
-                            payload: {
-                                processPid: run.processPid,
-                            },
-                        });
-                    }
+                // Kill the orphaned process instead of letting it hang forever
+                const detachedMessage = `Lost in-memory process handle, but child pid ${run.processPid} is still alive — killing and marking failed`;
+                logger.info({ runId: run.id, pid: run.processPid }, detachedMessage);
+                try {
+                    process.kill(run.processPid, "SIGTERM");
                 }
-                continue;
+                catch { }
+                setTimeout(() => {
+                    try {
+                        if (isProcessAlive(run.processPid))
+                            process.kill(run.processPid, "SIGKILL");
+                    }
+                    catch { }
+                }, 5000);
+                // Fall through to the same fail+retry logic below (don't continue)
             }
             const shouldRetry = tracksLocalChild && !!run.processPid && (run.processLossRetryCount ?? 0) < 1;
             const baseMessage = run.processPid
@@ -2046,6 +2051,23 @@ export function heartbeatService(db) {
                         payload: meta,
                     });
                 };
+                // --- Pre-compiled heartbeat context bundle (Level 2 CAG) ---
+                if (issueId) {
+                    try {
+                        const lastSeenCommentId = taskSessionForRun?.lastSeenCommentId ?? null;
+                        const bundle = await issuesSvc.buildHeartbeatContextBundle(issueId, {
+                            lastSeenCommentId,
+                            maxComments: 30,
+                        });
+                        if (bundle) {
+                            context.fideliosHeartbeatContext = bundle.markdown;
+                            context.fideliosHeartbeatContextCommentCursor = bundle.commentCursor;
+                        }
+                    }
+                    catch (err) {
+                        logger.warn({ err, runId: run.id, issueId }, "failed to build heartbeat context bundle; agent will fall back to API calls");
+                    }
+                }
                 const adapter = getServerAdapter(agent.adapterType);
                 const authToken = adapter.supportsLocalAgentJwt
                     ? createLocalAgentJwt(agent.id, agent.companyId, agent.adapterType, run.id)
@@ -2230,6 +2252,9 @@ export function heartbeatService(db) {
                             });
                         }
                         else {
+                            // Persist comment cursor from pre-compiled context bundle
+                            const bundleCursor = parseObject(context.fideliosHeartbeatContextCommentCursor);
+                            const lastSeenCommentId = readNonEmptyString(bundleCursor.latestCommentId) ?? undefined;
                             await upsertTaskSession({
                                 companyId: agent.companyId,
                                 agentId: agent.id,
@@ -2239,11 +2264,50 @@ export function heartbeatService(db) {
                                 sessionDisplayId: nextSessionState.displayId,
                                 lastRunId: finalizedRun.id,
                                 lastError: outcome === "succeeded" ? null : (adapterResult.errorMessage ?? "run_failed"),
+                                lastSeenCommentId,
                             });
                         }
                     }
                 }
                 await finalizeAgentStatus(agent.id, outcome);
+                // Auto-retry for transient errors (MCP timeout, rate limit, network errors)
+                if (outcome === "failed" && finalizedRun && issueId) {
+                    const errorMsg = adapterResult.errorMessage ?? "";
+                    const errorCode = adapterResult.errorCode ?? "";
+                    const exitCode = adapterResult.exitCode ?? -1;
+                    const isTransient = errorMsg.includes("timed out") ||
+                        errorMsg.includes("Request timed out") ||
+                        errorMsg.includes("MCP error") ||
+                        errorMsg.includes("rate limit") ||
+                        errorMsg.includes("429") ||
+                        errorMsg.includes("503") ||
+                        errorMsg.includes("ECONNRESET") ||
+                        errorMsg.includes("ETIMEDOUT") ||
+                        errorCode === "claude_auth_required" ||
+                        exitCode === 143;
+                    if (isTransient) {
+                        const retryDelaySec = 30;
+                        logger.info({ runId: run.id, agentId: agent.id, error: errorMsg.slice(0, 100), retryDelaySec }, "transient error detected; scheduling auto-retry");
+                        setTimeout(() => {
+                            void enqueueWakeup(agent.id, {
+                                source: "automation",
+                                triggerDetail: "system",
+                                reason: "retry_transient_error",
+                                requestedByActorType: "system",
+                                requestedByActorId: "transient-retry",
+                                contextSnapshot: {
+                                    issueId,
+                                    taskId: issueId,
+                                    taskKey: readNonEmptyString(context.taskKey) ?? issueId,
+                                    wakeReason: "retry_transient_error",
+                                    retriedFromRunId: run.id,
+                                },
+                            }).catch((retryErr) => {
+                                logger.warn({ err: retryErr, runId: run.id }, "failed to enqueue transient retry");
+                            });
+                        }, retryDelaySec * 1000);
+                    }
+                }
             }
             catch (err) {
                 const message = redactCurrentUserText(err instanceof Error ? err.message : "Unknown adapter failure", await getCurrentUserRedactionOptions());
@@ -2937,6 +3001,21 @@ export function heartbeatService(db) {
                 }
             }, graceMs);
         }
+        else if (run.processPid && isProcessAlive(run.processPid)) {
+            // Fallback: kill by PID when in-memory handle is lost (e.g. after server restart)
+            logger.info({ runId, pid: run.processPid }, "Killing detached process by PID (no in-memory handle)");
+            try {
+                process.kill(run.processPid, "SIGTERM");
+            }
+            catch { }
+            setTimeout(() => {
+                try {
+                    if (isProcessAlive(run.processPid))
+                        process.kill(run.processPid, "SIGKILL");
+                }
+                catch { }
+            }, 5000);
+        }
         const cancelled = await setRunStatus(run.id, "cancelled", {
             finishedAt: new Date(),
             error: reason,
@@ -3159,6 +3238,60 @@ export function heartbeatService(db) {
                 .limit(1);
             return run ?? null;
         },
+        /**
+         * On server startup, kill any orphaned processes from a previous server lifetime
+         * and mark their runs as failed. This prevents "process_detached" hangs.
+         */
+        reconcileOrphanedRunsOnStartup: async () => {
+            const staleRuns = await db
+                .select({
+                id: heartbeatRuns.id,
+                agentId: heartbeatRuns.agentId,
+                processPid: heartbeatRuns.processPid,
+                wakeupRequestId: heartbeatRuns.wakeupRequestId,
+                processLossRetryCount: heartbeatRuns.processLossRetryCount,
+            })
+                .from(heartbeatRuns)
+                .innerJoin(agents, eq(heartbeatRuns.agentId, agents.id))
+                .where(eq(heartbeatRuns.status, "running"));
+            if (staleRuns.length === 0)
+                return;
+            const now = new Date();
+            logger.info({ count: staleRuns.length }, "Reconciling stale running heartbeat runs from previous server lifetime");
+            for (const run of staleRuns) {
+                // Kill orphaned process if still alive
+                if (run.processPid && isProcessAlive(run.processPid)) {
+                    logger.info({ runId: run.id, pid: run.processPid }, "Killing orphaned process from previous server lifetime");
+                    try {
+                        process.kill(run.processPid, "SIGTERM");
+                    }
+                    catch { }
+                    // SIGKILL will follow from reapOrphanedRuns if needed
+                }
+                const message = run.processPid
+                    ? `Orphaned run from previous server lifetime — pid ${run.processPid} killed`
+                    : "Stale running run from previous server lifetime";
+                await setRunStatus(run.id, "failed", {
+                    error: message,
+                    errorCode: "process_lost",
+                    finishedAt: now,
+                });
+                await setWakeupStatus(run.wakeupRequestId, "failed", {
+                    finishedAt: now,
+                    error: message,
+                });
+                // Queue retry if under limit
+                if ((run.processLossRetryCount ?? 0) < 1) {
+                    const agent = await getAgent(run.agentId);
+                    const fullRun = await getRun(run.id);
+                    if (agent && fullRun) {
+                        await enqueueProcessLossRetry(fullRun, agent, now);
+                    }
+                }
+                await finalizeAgentStatus(run.agentId, "failed");
+            }
+            logger.info({ reconciled: staleRuns.length }, "Startup reconciliation complete");
+        },
     };
 }
 //# sourceMappingURL=heartbeat.js.map