@grackle-ai/plugin-core 0.96.3

package/dist/settings-handlers.d.ts

@@ -0,0 +1,10 @@
+import { grackle } from "@grackle-ai/common";
+/** Get the value of a setting by key. */
+export declare function getSetting(req: grackle.GetSettingRequest): Promise<grackle.SettingResponse>;
+/** Set the value of a setting. */
+export declare function setSetting(req: grackle.SetSettingRequest): Promise<grackle.SettingResponse>;
+/** Generate a new pairing code for web UI access. */
+export declare function generatePairingCode(): Promise<grackle.PairingCodeResponse>;
+/** Get the current version status (update available, current/latest versions). */
+export declare function getVersionStatus(): Promise<grackle.VersionStatus>;
+//# sourceMappingURL=settings-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-handlers.d.ts","sourceRoot":"","sources":["../src/settings-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAQ7C,yCAAyC;AACzC,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CASjG;AAED,kCAAkC;AAClC,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAqCjG;AAED,qDAAqD;AACrD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAiBhF;AAED,kFAAkF;AAClF,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAQvE"}

package/dist/settings-handlers.js

@@ -0,0 +1,80 @@
+import { ConnectError, Code } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import { grackle } from "@grackle-ai/common";
+import { DEFAULT_WEB_PORT } from "@grackle-ai/common";
+import { settingsStore, personaStore, envRegistry, isAllowedSettingKey } from "@grackle-ai/database";
+import { generatePairingCode as authGeneratePairingCode } from "@grackle-ai/auth";
+import { checkVersionStatus } from "@grackle-ai/core";
+import { detectLanIp } from "@grackle-ai/core";
+import { emit } from "@grackle-ai/core";
+/** Get the value of a setting by key. */
+export async function getSetting(req) {
+    if (!isAllowedSettingKey(req.key)) {
+        throw new ConnectError(`Setting key not allowed: ${req.key}`, Code.InvalidArgument);
+    }
+    const value = settingsStore.getSetting(req.key);
+    return create(grackle.SettingResponseSchema, {
+        key: req.key,
+        value: value ?? "",
+    });
+}
+/** Set the value of a setting. */
+export async function setSetting(req) {
+    if (!isAllowedSettingKey(req.key)) {
+        throw new ConnectError(`Setting key not allowed: ${req.key}`, Code.InvalidArgument);
+    }
+    // Validate persona exists and has required fields when setting default_persona_id
+    if (req.key === "default_persona_id" && req.value) {
+        const persona = personaStore.getPersona(req.value);
+        if (!persona) {
+            throw new ConnectError(`Persona not found: ${req.value}`, Code.NotFound);
+        }
+        if (!persona.runtime || !persona.model) {
+            throw new ConnectError(`Persona "${persona.name}" must have runtime and model configured`, Code.FailedPrecondition);
+        }
+    }
+    settingsStore.setSetting(req.key, req.value);
+    emit("setting.changed", { key: req.key, value: req.value });
+    // Sync the local environment's defaultRuntime when the default persona changes,
+    // so bootstrap pre-installs the correct runtime packages (fixes #1031).
+    if (req.key === "default_persona_id" && req.value) {
+        const newDefault = personaStore.getPersona(req.value);
+        if (newDefault?.runtime) {
+            const localEnv = envRegistry.getEnvironment("local");
+            if (localEnv && localEnv.defaultRuntime !== newDefault.runtime) {
+                envRegistry.updateDefaultRuntime("local", newDefault.runtime);
+                emit("environment.changed", {});
+            }
+        }
+    }
+    return create(grackle.SettingResponseSchema, {
+        key: req.key,
+        value: req.value,
+    });
+}
+/** Generate a new pairing code for web UI access. */
+export async function generatePairingCode() {
+    const code = authGeneratePairingCode();
+    if (!code) {
+        throw new ConnectError("Maximum active pairing codes reached. Wait for existing codes to expire.", Code.ResourceExhausted);
+    }
+    const webPort = parseInt(process.env.GRACKLE_WEB_PORT || String(DEFAULT_WEB_PORT), 10);
+    const bindHost = process.env.GRACKLE_HOST || "127.0.0.1";
+    const WILDCARD_ADDRESSES = new Set(["0.0.0.0", "::", "0:0:0:0:0:0:0:0"]);
+    const pairingHost = WILDCARD_ADDRESSES.has(bindHost)
+        ? (detectLanIp() || "localhost")
+        : (bindHost === "127.0.0.1" || bindHost === "::1" ? "localhost" : bindHost);
+    const url = `http://${pairingHost}:${webPort}/pair?code=${code}`;
+    return create(grackle.PairingCodeResponseSchema, { code, url });
+}
+/** Get the current version status (update available, current/latest versions). */
+export async function getVersionStatus() {
+    const status = await checkVersionStatus();
+    return create(grackle.VersionStatusSchema, {
+        currentVersion: status.currentVersion,
+        latestVersion: status.latestVersion,
+        updateAvailable: status.updateAvailable,
+        isDocker: status.isDocker,
+    });
+}
+//# sourceMappingURL=settings-handlers.js.map

package/dist/settings-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-handlers.js","sourceRoot":"","sources":["../src/settings-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAA8B;IAC7D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,YAAY,CAAC,4BAA4B,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE;QAC3C,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,KAAK,EAAE,KAAK,IAAI,EAAE;KACnB,CAAC,CAAC;AACL,CAAC;AAED,kCAAkC;AAClC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAA8B;IAC7D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,YAAY,CAAC,4BAA4B,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACtF,CAAC;IACD,kFAAkF;IAClF,IAAI,GAAG,CAAC,GAAG,KAAK,oBAAoB,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,YAAY,CAAC,sBAAsB,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACvC,MAAM,IAAI,YAAY,CACpB,YAAY,OAAO,CAAC,IAAI,0CAA0C,EAClE,IAAI,CAAC,kBAAkB,CACxB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,iBAAiB,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAE5D,gFAAgF;IAChF,wEAAwE;IACxE,IAAI,GAAG,CAAC,GAAG,KAAK,oBAAoB,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAClD,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,UAAU,EAAE,OAAO,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,QAAQ,IAAI,QAAQ,CAAC,cAAc,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;gBAC/D,WAAW,CAAC,oBAAoB,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;gBAC9D,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE;QAC3C,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,KAAK,EAAE,GAAG,CAAC,KAAK;KACjB,CAAC,CAAC;AACL,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,IAAI,GAAG,uBAAuB,EAAE,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,YAAY,CACpB,0EAA0E,EAC1E,IAAI,CAAC,iBAAiB,CACvB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC;IACvF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,WAAW,CAAC;IACzD,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC9F,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClD,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,WAAW,CAAC;QAChC,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9E,MAAM,GAAG,GAAG,UAAU,WAAW,IAAI,OAAO,cAAc,IAAI,EAAE,CAAC;IACjE,OAAO,MAAM,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC1C,OAAO,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE;QACzC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/signals/escalation-auto.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Auto-detection subscriber for human escalation.
+ *
+ * Watches for standalone (parentless, non-system-root) tasks that go IDLE
+ * and automatically creates an escalation on the agent's behalf.
+ * This is the safety net for simple topologies where there is no orchestrator
+ * to explicitly call `escalate_to_human`.
+ */
+import type { Disposable, PluginContext } from "@grackle-ai/core";
+/**
+ * Create the auto-escalation event-bus subscriber.
+ *
+ * Watches for standalone (parentless, non-ROOT) tasks whose latest session
+ * goes IDLE and automatically creates an escalation.
+ *
+ * @param ctx - Plugin context providing event-bus access.
+ * @returns A Disposable that unsubscribes and clears dedup state.
+ */
+export declare function createEscalationAutoSubscriber(ctx: PluginContext): Disposable;
+//# sourceMappingURL=escalation-auto.d.ts.map

package/dist/signals/escalation-auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-auto.d.ts","sourceRoot":"","sources":["../../src/signals/escalation-auto.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKlE;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAgC7E"}

package/dist/signals/escalation-auto.js

@@ -0,0 +1,126 @@
+/**
+ * Auto-detection subscriber for human escalation.
+ *
+ * Watches for standalone (parentless, non-system-root) tasks that go IDLE
+ * and automatically creates an escalation on the agent's behalf.
+ * This is the safety net for simple topologies where there is no orchestrator
+ * to explicitly call `escalate_to_human`.
+ */
+import { SESSION_STATUS, ROOT_TASK_ID } from "@grackle-ai/common";
+import { taskStore, sessionStore, escalationStore } from "@grackle-ai/database";
+import { readLastTextEntry } from "@grackle-ai/core";
+import { routeEscalation } from "@grackle-ai/core";
+import { logger } from "@grackle-ai/core";
+import { ulid } from "ulid";
+/** How long (ms) to remember a delivered notification before allowing re-delivery. */
+const DEDUP_TTL_MS = 3_600_000; // 1 hour
+/**
+ * Create the auto-escalation event-bus subscriber.
+ *
+ * Watches for standalone (parentless, non-ROOT) tasks whose latest session
+ * goes IDLE and automatically creates an escalation.
+ *
+ * @param ctx - Plugin context providing event-bus access.
+ * @returns A Disposable that unsubscribes and clears dedup state.
+ */
+export function createEscalationAutoSubscriber(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 taskId = event.payload.taskId;
+        if (!taskId) {
+            return;
+        }
+        // Fire-and-forget async handler — errors are logged, never thrown
+        (async () => {
+            try {
+                await handleTaskUpdated(delivered, taskId);
+            }
+            catch (err) {
+                logger.error({ err, taskId }, "Escalation auto-detect handler error");
+            }
+        })().catch(() => { });
+    });
+    logger.info("Escalation auto-detect subscriber initialized");
+    return {
+        dispose() {
+            unsubscribe();
+            delivered.clear();
+        },
+    };
+}
+/**
+ * Handle a task.updated event: check if the task is a standalone root task
+ * whose latest session has gone IDLE, and if so, auto-escalate.
+ */
+async function handleTaskUpdated(delivered, taskId) {
+    const task = taskStore.getTask(taskId);
+    if (!task) {
+        return;
+    }
+    // Only parentless tasks trigger auto-escalation (child tasks use SIGCHLD)
+    if (task.parentTaskId) {
+        return;
+    }
+    // Exclude the system root task — it is always idle when nobody is chatting
+    if (taskId === ROOT_TASK_ID) {
+        return;
+    }
+    // Check if the latest session is IDLE
+    const latestSession = sessionStore.getLatestSessionForTask(taskId);
+    if (!latestSession) {
+        return;
+    }
+    if (latestSession.status !== SESSION_STATUS.IDLE) {
+        return;
+    }
+    // Idempotency: don't re-deliver for the same task+session pair
+    const dedupeKey = `${taskId}:${latestSession.id}`;
+    const now = Date.now();
+    const previousDelivery = delivered.get(dedupeKey);
+    if (previousDelivery !== undefined && now - previousDelivery < DEDUP_TTL_MS) {
+        return;
+    }
+    // Prune expired entries to prevent unbounded growth
+    pruneDelivered(delivered, now);
+    // Extract the last text message from the session log
+    const logPath = latestSession.logPath || undefined;
+    const lastEntry = logPath ? readLastTextEntry(logPath) : undefined;
+    const message = lastEntry?.content ?? "";
+    // Build task URL
+    const taskUrl = `/tasks/${taskId}`;
+    // Create and route the escalation
+    const escalationId = ulid();
+    const workspaceId = task.workspaceId ?? "";
+    escalationStore.createEscalation(escalationId, workspaceId, taskId, task.title, message, "auto", "normal", taskUrl);
+    // Mark dedupe AFTER successful persistence so failures can retry
+    delivered.set(dedupeKey, now);
+    // Route immediately — build the row inline to avoid a round-trip read
+    await routeEscalation({
+        id: escalationId,
+        workspaceId,
+        taskId,
+        title: task.title,
+        message,
+        source: "auto",
+        urgency: "normal",
+        status: "pending",
+        createdAt: new Date().toISOString(),
+        deliveredAt: null,
+        acknowledgedAt: null,
+        taskUrl,
+    });
+    logger.info({ taskId, escalationId, title: task.title }, "Auto-escalation created for idle standalone task");
+}
+/** Remove dedup entries older than DEDUP_TTL_MS. */
+function pruneDelivered(delivered, now) {
+    for (const [key, timestamp] of delivered) {
+        if (now - timestamp >= DEDUP_TTL_MS) {
+            delivered.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=escalation-auto.js.map

package/dist/signals/escalation-auto.js.map

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

package/dist/signals/orphan-reparent.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Orphan reparenting — automatically reparent non-terminal children when
+ * a parent task reaches terminal state (complete/failed).
+ *
+ * Follows the SIGCHLD subscriber pattern: subscribes to domain events,
+ * detects orphan conditions, and reparents children to the grandparent.
+ * The root task (PID 1) is the ultimate adopter.
+ */
+import type { Disposable, PluginContext } from "@grackle-ai/core";
+/**
+ * Create the orphan reparenting event-bus subscriber.
+ *
+ * Watches for parent tasks reaching terminal state and reparents their
+ * non-terminal children to the grandparent (or root task as ultimate adopter).
+ *
+ * @param ctx - Plugin context providing event-bus access.
+ * @returns A Disposable that unsubscribes and clears dedup state.
+ */
+export declare function createOrphanReparentSubscriber(ctx: PluginContext): Disposable;
+/**
+ * Transfer ALL pipe subscriptions from a dead parent's sessions to the
+ * grandparent's active session. Called once per parent death (not per child).
+ *
+ * When a parent dies, all its pipe connections should move to the grandparent —
+ * like fd inheritance when a Unix process dies and init takes over.
+ *
+ * Exported so it can be called synchronously from completeTask() /
+ * killSessionAndCleanup() before sessions are cleaned up.
+ */
+export declare function transferAllPipeSubscriptions(deadParentTaskId: string, grandparentTaskId: string): void;
+//# sourceMappingURL=orphan-reparent.d.ts.map

package/dist/signals/orphan-reparent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-reparent.d.ts","sourceRoot":"","sources":["../../src/signals/orphan-reparent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAWlE;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAmC7E;AA+FD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,MAAM,GACxB,IAAI,CAsDN"}

package/dist/signals/orphan-reparent.js

@@ -0,0 +1,175 @@
+/**
+ * Orphan reparenting — automatically reparent non-terminal children when
+ * a parent task reaches terminal state (complete/failed).
+ *
+ * Follows the SIGCHLD subscriber pattern: subscribes to domain events,
+ * detects orphan conditions, and reparents children to the grandparent.
+ * The root task (PID 1) is the ultimate adopter.
+ */
+import { ROOT_TASK_ID, TASK_STATUS } from "@grackle-ai/common";
+import { taskStore, sessionStore } from "@grackle-ai/database";
+import { streamRegistry } from "@grackle-ai/core";
+import { ensureAsyncDeliveryListener } from "@grackle-ai/core";
+import { deliverSignalToTask } from "@grackle-ai/core";
+import { logger } from "@grackle-ai/core";
+/** Terminal task statuses that trigger orphan reparenting. */
+const TERMINAL_TASK_STATUSES = new Set([
+    TASK_STATUS.COMPLETE,
+    TASK_STATUS.FAILED,
+]);
+/** How long (ms) to remember a processed parent before allowing re-processing. */
+const DEDUP_TTL_MS = 3_600_000; // 1 hour
+/**
+ * Create the orphan reparenting event-bus subscriber.
+ *
+ * Watches for parent tasks reaching terminal state and reparents their
+ * non-terminal children to the grandparent (or root task as ultimate adopter).
+ *
+ * @param ctx - Plugin context providing event-bus access.
+ * @returns A Disposable that unsubscribes and clears dedup state.
+ */
+export function createOrphanReparentSubscriber(ctx) {
+    /** Track processed parents to prevent duplicate reparenting: parentTaskId → timestamp. */
+    const processed = new Map();
+    const unsubscribe = ctx.subscribe((event) => {
+        if (event.type !== "task.completed" && event.type !== "task.updated") {
+            return;
+        }
+        const parentTaskId = event.payload.taskId;
+        if (!parentTaskId) {
+            return;
+        }
+        // Root task never completes — guard defensively
+        if (parentTaskId === ROOT_TASK_ID) {
+            return;
+        }
+        // Fire-and-forget async handler — errors are logged, never thrown
+        (async () => {
+            try {
+                await handleParentTerminal(ctx, processed, parentTaskId);
+            }
+            catch (err) {
+                logger.error({ err, parentTaskId }, "Orphan reparenting failed for parent task");
+            }
+        })().catch(() => { });
+    });
+    return {
+        dispose() {
+            unsubscribe();
+            processed.clear();
+        },
+    };
+}
+/**
+ * Check if a parent task is terminal and reparent its non-terminal children.
+ */
+async function handleParentTerminal(ctx, processed, parentTaskId) {
+    const parentTask = taskStore.getTask(parentTaskId);
+    if (!parentTask) {
+        return;
+    }
+    // Only trigger for terminal statuses
+    if (!TERMINAL_TASK_STATUSES.has(parentTask.status)) {
+        return;
+    }
+    // Deduplication: skip if we already processed this parent recently
+    const now = Date.now();
+    const lastProcessed = processed.get(parentTaskId);
+    if (lastProcessed && now - lastProcessed < DEDUP_TTL_MS) {
+        return;
+    }
+    // Mark as processed before doing work (prevents concurrent re-entry)
+    processed.set(parentTaskId, now);
+    // Determine the grandparent (or root task as ultimate adopter)
+    const grandparentId = parentTask.parentTaskId || ROOT_TASK_ID;
+    // Always transfer pipe fds from dead parent to grandparent, even when there
+    // are no orphaned tasks. ipc_spawn creates child sessions (not tasks), so
+    // pipe subscriptions can exist without corresponding child tasks.
+    transferAllPipeSubscriptions(parentTaskId, grandparentId);
+    // Get non-terminal children for reparenting
+    const orphans = taskStore.getOrphanedTasks(parentTaskId);
+    if (orphans.length === 0) {
+        // Evict stale dedup entries even when no reparenting needed
+        for (const [key, ts] of processed) {
+            if (now - ts > DEDUP_TTL_MS) {
+                processed.delete(key);
+            }
+        }
+        return;
+    }
+    logger.info({ parentTaskId, grandparentId, orphanCount: orphans.length, reason: parentTask.status }, "Reparenting orphaned children to grandparent");
+    // Reparent each orphan
+    for (const orphan of orphans) {
+        try {
+            taskStore.reparentTask(orphan.id, grandparentId);
+            ctx.emit("task.reparented", {
+                taskId: orphan.id,
+                oldParentTaskId: parentTaskId,
+                newParentTaskId: grandparentId,
+                workspaceId: orphan.workspaceId || "",
+            });
+            ctx.emit("task.updated", {
+                taskId: orphan.id,
+                workspaceId: orphan.workspaceId || "",
+            });
+            // Deliver [ADOPTED] signal to grandparent
+            const message = `[ADOPTED] Task "${orphan.title}" (${orphan.id}) was adopted from ` +
+                `terminated parent "${parentTask.title}" (${parentTask.id}). ` +
+                `The task is now your direct child. Use ipc_list_fds to see transferred pipe fds.`;
+            await deliverSignalToTask(grandparentId, "adopted", message);
+        }
+        catch (err) {
+            logger.error({ err, orphanId: orphan.id, parentTaskId, grandparentId }, "Failed to reparent orphan — continuing with remaining children");
+        }
+    }
+    // Evict stale dedup entries
+    for (const [key, ts] of processed) {
+        if (now - ts > DEDUP_TTL_MS) {
+            processed.delete(key);
+        }
+    }
+}
+/**
+ * Transfer ALL pipe subscriptions from a dead parent's sessions to the
+ * grandparent's active session. Called once per parent death (not per child).
+ *
+ * When a parent dies, all its pipe connections should move to the grandparent —
+ * like fd inheritance when a Unix process dies and init takes over.
+ *
+ * Exported so it can be called synchronously from completeTask() /
+ * killSessionAndCleanup() before sessions are cleaned up.
+ */
+export function transferAllPipeSubscriptions(deadParentTaskId, grandparentTaskId) {
+    const grandparentSessions = sessionStore.getActiveSessionsForTask(grandparentTaskId);
+    if (grandparentSessions.length === 0) {
+        logger.debug({ deadParentTaskId, grandparentTaskId }, "No active grandparent session — skipping pipe fd transfer");
+        return;
+    }
+    const grandparentSessionId = grandparentSessions[0].id;
+    const parentSessions = sessionStore.listSessionsForTask(deadParentTaskId);
+    let transferred = 0;
+    for (const parentSession of parentSessions) {
+        const subs = streamRegistry.getSubscriptionsForSession(parentSession.id);
+        for (const sub of subs) {
+            const stream = streamRegistry.getStream(sub.streamId);
+            if (!stream?.name.startsWith("pipe:")) {
+                continue;
+            }
+            try {
+                streamRegistry.subscribe(sub.streamId, grandparentSessionId, sub.permission, sub.deliveryMode, sub.createdBySpawn);
+                streamRegistry.unsubscribe(sub.id);
+                if (sub.deliveryMode === "async") {
+                    ensureAsyncDeliveryListener(grandparentSessionId);
+                }
+                transferred++;
+            }
+            catch (err) {
+                logger.warn({ err, stream: stream.name, deadParentTaskId }, "Failed to transfer pipe fd");
+            }
+        }
+    }
+    if (transferred > 0) {
+        logger.info({ deadParentTaskId, grandparentTaskId, grandparentSessionId, transferred }, "Transferred %d pipe fd(s) to grandparent session", transferred);
+    }
+}
+//# sourceMappingURL=orphan-reparent.js.map

package/dist/signals/orphan-reparent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-reparent.js","sourceRoot":"","sources":["../../src/signals/orphan-reparent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,8DAA8D;AAC9D,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC;IAC1D,WAAW,CAAC,QAAQ;IACpB,WAAW,CAAC,MAAM;CACnB,CAAC,CAAC;AAEH,kFAAkF;AAClF,MAAM,YAAY,GAAW,SAAS,CAAC,CAAC,SAAS;AAEjD;;;;;;;;GAQG;AACH,MAAM,UAAU,8BAA8B,CAAC,GAAkB;IAC/D,0FAA0F;IAC1F,MAAM,SAAS,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEjD,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,KAAmB,EAAE,EAAE;QACxD,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACrE,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,MAA4B,CAAC;QAChE,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,gDAAgD;QAChD,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,kEAAkE;QAClE,CAAC,KAAK,IAAI,EAAE;YACV,IAAI,CAAC;gBACH,MAAM,oBAAoB,CAAC,GAAG,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;YAC3D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,2CAA2C,CAAC,CAAC;YACnF,CAAC;QACH,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAkC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO;YACL,WAAW,EAAE,CAAC;YACd,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CACjC,GAAkB,EAClB,SAA8B,EAC9B,YAAoB;IAEpB,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;IACT,CAAC;IAED,qCAAqC;IACrC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,OAAO;IACT,CAAC;IAED,mEAAmE;IACnE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,aAAa,IAAI,GAAG,GAAG,aAAa,GAAG,YAAY,EAAE,CAAC;QACxD,OAAO;IACT,CAAC;IAED,qEAAqE;IACrE,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAEjC,+DAA+D;IAC/D,MAAM,aAAa,GAAG,UAAU,CAAC,YAAY,IAAI,YAAY,CAAC;IAE9D,4EAA4E;IAC5E,0EAA0E;IAC1E,kEAAkE;IAClE,4BAA4B,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAE1D,4CAA4C;IAC5C,MAAM,OAAO,GAAG,SAAS,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,4DAA4D;QAC5D,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;YAClC,IAAI,GAAG,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;gBAC5B,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CACT,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,EACvF,8CAA8C,CAC/C,CAAC;IAEF,uBAAuB;IACvB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;YAEjD,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE;gBAC1B,MAAM,EAAE,MAAM,CAAC,EAAE;gBACjB,eAAe,EAAE,YAAY;gBAC7B,eAAe,EAAE,aAAa;gBAC9B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;aACtC,CAAC,CAAC;YAEH,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE;gBACvB,MAAM,EAAE,MAAM,CAAC,EAAE;gBACjB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;aACtC,CAAC,CAAC;YAEH,0CAA0C;YAC1C,MAAM,OAAO,GACX,mBAAmB,MAAM,CAAC,KAAK,MAAM,MAAM,CAAC,EAAE,qBAAqB;gBACnE,sBAAsB,UAAU,CAAC,KAAK,MAAM,UAAU,CAAC,EAAE,KAAK;gBAC9D,kFAAkF,CAAC;YAErF,MAAM,mBAAmB,CAAC,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CACV,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,EACzD,gEAAgE,CACjE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QAClC,IAAI,GAAG,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;YAC5B,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAC1C,gBAAwB,EACxB,iBAAyB;IAEzB,MAAM,mBAAmB,GAAG,YAAY,CAAC,wBAAwB,CAAC,iBAAiB,CAAC,CAAC;IACrF,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,KAAK,CACV,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,EACvC,2DAA2D,CAC5D,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvD,MAAM,cAAc,GAAG,YAAY,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAC1E,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,cAAc,CAAC,0BAA0B,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAEzE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtD,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtC,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,cAAc,CAAC,SAAS,CACtB,GAAG,CAAC,QAAQ,EACZ,oBAAoB,EACpB,GAAG,CAAC,UAAU,EACd,GAAG,CAAC,YAAY,EAChB,GAAG,CAAC,cAAc,CACnB,CAAC;gBACF,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAEnC,IAAI,GAAG,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;oBACjC,2BAA2B,CAAC,oBAAoB,CAAC,CAAC;gBACpD,CAAC;gBAED,WAAW,EAAE,CAAC;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAC9C,4BAA4B,CAC7B,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CACT,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,WAAW,EAAE,EAC1E,kDAAkD,EAClD,WAAW,CACZ,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/signals/sigchld.d.ts

@@ -0,0 +1,12 @@
+import type { Disposable, PluginContext } from "@grackle-ai/core";
+/**
+ * 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 declare function createSigchldSubscriber(ctx: PluginContext): Disposable;
+//# sourceMappingURL=sigchld.d.ts.map

package/dist/signals/sigchld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sigchld.d.ts","sourceRoot":"","sources":["../../src/signals/sigchld.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAgClE;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAgCtE"}