@grackle-ai/plugin-core 0.96.3

package/dist/signals/sigchld.js

@@ -0,0 +1,177 @@
+import { SESSION_STATUS } from "@grackle-ai/common";
+import { taskStore, sessionStore } from "@grackle-ai/database";
+import { readLastTextEntry } from "@grackle-ai/core";
+import { deliverSignalToTask } from "@grackle-ai/core";
+import { logger } from "@grackle-ai/core";
+/** Maximum length for the child's last text message in the notification. */
+const MAX_LAST_MESSAGE_LENGTH = 2000;
+/** Maximum number of delivery attempts (1 initial + retries). */
+const MAX_DELIVERY_ATTEMPTS = 3;
+/** Delay (ms) between delivery retries. */
+const DELIVERY_RETRY_DELAY_MS = 1_000;
+/**
+ * Session statuses that trigger SIGCHLD. LLM agents don't reliably exit() —
+ * they go IDLE when they stop working. STOPPED fires when the session's event
+ * stream ends (agent-initiated, not user-initiated — the user marking a task
+ * "Complete" emits task.completed which this subscriber does not listen to).
+ * Dedup prevents double notification if both IDLE and STOPPED fire for the
+ * same session.
+ */
+const SIGCHLD_STATUSES = new Set([
+    SESSION_STATUS.IDLE,
+    SESSION_STATUS.STOPPED,
+]);
+/** How long (ms) to remember a delivered notification before allowing re-delivery. */
+const DEDUP_TTL_MS = 3_600_000; // 1 hour
+/** Human-readable status labels for the notification text (non-STOPPED statuses only). */
+const STATUS_LABELS = {
+    [SESSION_STATUS.IDLE]: "finished working (awaiting review)",
+};
+/**
+ * Create the SIGCHLD event-bus subscriber.
+ *
+ * Watches for child tasks whose latest session reaches a SIGCHLD-triggering
+ * status (idle or stopped) and delivers a notification to the parent task.
+ *
+ * @param ctx - Plugin context providing event-bus access.
+ * @returns A Disposable that unsubscribes and clears dedup state.
+ */
+export function createSigchldSubscriber(ctx) {
+    /** Track delivered notifications to prevent duplicates: key → delivery timestamp. */
+    const delivered = new Map();
+    const unsubscribe = ctx.subscribe((event) => {
+        if (event.type !== "task.updated") {
+            return;
+        }
+        const childTaskId = event.payload.taskId;
+        if (!childTaskId) {
+            return;
+        }
+        // Fire-and-forget async handler — errors are logged, never thrown
+        (async () => {
+            try {
+                await handleTaskUpdated(delivered, childTaskId);
+            }
+            catch (err) {
+                logger.error({ err, childTaskId }, "SIGCHLD handler error");
+            }
+        })().catch(() => { });
+    });
+    logger.info("SIGCHLD subscriber initialized");
+    return {
+        dispose() {
+            unsubscribe();
+            delivered.clear();
+        },
+    };
+}
+/**
+ * Handle a task.updated event: check if the task is a child whose latest
+ * session has reached a SIGCHLD-triggering status (idle or terminal),
+ * and if so, deliver a SIGCHLD notification to the parent.
+ */
+async function handleTaskUpdated(delivered, childTaskId) {
+    const childTask = taskStore.getTask(childTaskId);
+    if (!childTask) {
+        return;
+    }
+    // Only child tasks (with a parent) trigger SIGCHLD
+    if (!childTask.parentTaskId) {
+        return;
+    }
+    // Check if the child session is in a SIGCHLD-triggering status (idle or terminal)
+    const latestSession = sessionStore.getLatestSessionForTask(childTaskId);
+    if (!latestSession) {
+        return;
+    }
+    if (!SIGCHLD_STATUSES.has(latestSession.status)) {
+        return;
+    }
+    // Idempotency: don't re-deliver for the same child+session pair.
+    // Set the key optimistically to prevent concurrent async handlers from
+    // both passing the check (e.g. completed + interrupted firing together).
+    const dedupeKey = `${childTaskId}:${latestSession.id}`;
+    const now = Date.now();
+    const previousDelivery = delivered.get(dedupeKey);
+    if (previousDelivery !== undefined && now - previousDelivery < DEDUP_TTL_MS) {
+        return;
+    }
+    delivered.set(dedupeKey, now);
+    // Prune expired entries to prevent unbounded growth
+    pruneMap(delivered, now);
+    // Extract the last text message from the child's session log
+    const lastTextMessage = extractLastTextMessage(latestSession.logPath || undefined);
+    // Format the notification with actionable instructions for the parent
+    let statusLabel;
+    if (latestSession.status === SESSION_STATUS.STOPPED) {
+        statusLabel = latestSession.endReason === "completed"
+            ? "completed successfully"
+            : latestSession.endReason === "killed"
+                ? "was killed"
+                : "crashed unexpectedly";
+    }
+    else {
+        statusLabel = STATUS_LABELS[latestSession.status] || latestSession.status;
+    }
+    let message = `[SIGCHLD] Child task "${childTask.title}" (${childTaskId}) ${statusLabel}.`;
+    if (lastTextMessage) {
+        const truncated = lastTextMessage.length > MAX_LAST_MESSAGE_LENGTH
+            ? lastTextMessage.slice(0, MAX_LAST_MESSAGE_LENGTH) + "..."
+            : lastTextMessage;
+        message += `\n\nLast message from child:\n> ${truncated}`;
+    }
+    if (latestSession.status === SESSION_STATUS.IDLE) {
+        message += "\n\nReview the child's work. If satisfactory, mark it complete with "
+            + `task_complete({ taskId: "${childTaskId}" }). `
+            + "If more work is needed, send additional input to the child's session.";
+    }
+    else if (latestSession.status === SESSION_STATUS.STOPPED && latestSession.endReason === "interrupted") {
+        message += "\n\nThe child task crashed unexpectedly. Review the error and decide whether to retry or reassign the work.";
+    }
+    logger.info({ childTaskId, parentTaskId: childTask.parentTaskId, status: latestSession.status }, "Delivering SIGCHLD to parent task");
+    // Retry inline on failure to prevent signal loss from the dedup race condition:
+    // without retry, a concurrent handler that was deduped cannot re-attempt delivery,
+    // and deleting the key only helps if another task.updated event arrives (not guaranteed).
+    let success = false;
+    for (let attempt = 0; attempt < MAX_DELIVERY_ATTEMPTS; attempt++) {
+        if (attempt > 0) {
+            logger.warn({ childTaskId, parentTaskId: childTask.parentTaskId, attempt }, "SIGCHLD delivery failed — retrying");
+            await new Promise((resolve) => setTimeout(resolve, DELIVERY_RETRY_DELAY_MS));
+        }
+        success = await deliverSignalToTask(childTask.parentTaskId, "sigchld", message);
+        if (success) {
+            break;
+        }
+    }
+    if (!success) {
+        // All retries exhausted — delete the dedup key so future events can try again
+        delivered.delete(dedupeKey);
+        logger.error({ childTaskId, parentTaskId: childTask.parentTaskId, attempts: MAX_DELIVERY_ATTEMPTS }, "SIGCHLD delivery failed after all retries");
+    }
+}
+/** Remove dedup entries older than DEDUP_TTL_MS. */
+function pruneMap(map, now) {
+    for (const [key, timestamp] of map) {
+        if (now - timestamp >= DEDUP_TTL_MS) {
+            map.delete(key);
+        }
+    }
+}
+/**
+ * Read the session log and extract the content of the last "text" entry.
+ * Uses readLastTextEntry which only reads the tail of the file (up to 64 KB)
+ * instead of parsing the entire log into memory.
+ * Returns an empty string if no text entries exist or the log cannot be read.
+ */
+function extractLastTextMessage(logPath) {
+    if (!logPath) {
+        return "";
+    }
+    try {
+        return readLastTextEntry(logPath)?.content ?? "";
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=sigchld.js.map

package/dist/signals/sigchld.js.map

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

package/dist/task-handlers.d.ts

@@ -0,0 +1,22 @@
+import { grackle } from "@grackle-ai/common";
+/** List tasks, optionally filtered by workspace, search query, or status. */
+export declare function listTasks(req: grackle.ListTasksRequest): Promise<grackle.TaskList>;
+/** Create a new task. */
+export declare function createTask(req: grackle.CreateTaskRequest): Promise<grackle.Task>;
+/** Get a task by ID with computed status. */
+export declare function getTask(req: grackle.TaskId): Promise<grackle.Task>;
+/** Update task fields or late-bind a session to a task. */
+export declare function updateTask(req: grackle.UpdateTaskRequest): Promise<grackle.Task>;
+/** Start a task by spawning a new agent session. */
+export declare function startTask(req: grackle.StartTaskRequest): Promise<grackle.Session>;
+/** Mark a task as complete and clean up active sessions. */
+export declare function completeTask(req: grackle.TaskId): Promise<grackle.Task>;
+/** Set the workpad JSON for a task. */
+export declare function setWorkpad(req: grackle.SetWorkpadRequest): Promise<grackle.Task>;
+/** Resume the latest session for a task. */
+export declare function resumeTask(req: grackle.TaskId): Promise<grackle.Session>;
+/** Stop a task by terminating all its active sessions. */
+export declare function stopTask(req: grackle.TaskId): Promise<grackle.Task>;
+/** Delete a task and all its sessions. */
+export declare function deleteTask(req: grackle.TaskId): Promise<grackle.Empty>;
+//# sourceMappingURL=task-handlers.d.ts.map

package/dist/task-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-handlers.d.ts","sourceRoot":"","sources":["../src/task-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAa,MAAM,oBAAoB,CAAC;AAwCxD,6EAA6E;AAC7E,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAwBxF;AAED,yBAAyB;AACzB,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAyDtF;AAED,6CAA6C;AAC7C,wBAAsB,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAQxE;AAED,2DAA2D;AAC3D,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CA0EtF;AAED,oDAAoD;AACpD,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAoOvF;AAED,4DAA4D;AAC5D,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAsD7E;AAED,uCAAuC;AACvC,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CA2BtF;AAED,4CAA4C;AAC5C,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CA6D9E;AAED,0DAA0D;AAC1D,wBAAsB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CA2CzE;AAED,0CAA0C;AAC1C,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAqC5E"}