@grackle-ai/core 0.75.4

package/dist/lifecycle.js.map

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

package/dist/log-writer.d.ts

@@ -0,0 +1,32 @@
+import { type grackle } from "@grackle-ai/common";
+/** Initialize a JSONL log stream for a session at the given directory path. */
+export declare function initLog(logPath: string): void;
+/**
+ * Ensure the JSONL log stream for the given path is open.
+ * If `initLog` has already been called for this path this is a no-op;
+ * otherwise it opens a new append stream.  Use this before `writeEvent`
+ * when the caller cannot guarantee that `initLog` has already been called
+ * (e.g. signal delivery to a PENDING session).
+ */
+export declare function ensureLogInitialized(logPath: string): void;
+/** Append a session event as a JSON line to the session's log file. */
+export declare function writeEvent(logPath: string, event: grackle.SessionEvent): void;
+/** Close the write stream for a session log. */
+export declare function endSession(logPath: string): void;
+/** Deserialized shape of a single line in a session's `stream.jsonl` log. */
+export interface LogEntry {
+    session_id: string;
+    type: string;
+    timestamp: string;
+    content: string;
+    raw?: string;
+}
+/**
+ * Read the last "text" entry from a session's JSONL log file without parsing the whole file.
+ * Reads only the tail of the file (up to LOG_TAIL_BYTES) to limit the amount of synchronous
+ * work and reduce event-loop blocking time for large sessions.
+ */
+export declare function readLastTextEntry(logPath: string): LogEntry | undefined;
+/** Read and parse all log entries from a session's JSONL log file. */
+export declare function readLog(logPath: string): LogEntry[];
+//# sourceMappingURL=log-writer.d.ts.map

package/dist/log-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-writer.d.ts","sourceRoot":"","sources":["../src/log-writer.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,OAAO,EAAqB,MAAM,oBAAoB,CAAC;AAIrE,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAK7C;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI1D;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,GAAG,IAAI,CAa7E;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMhD;AAED,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAKD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAyCvE;AAED,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CASnD"}

package/dist/log-writer.js

@@ -0,0 +1,104 @@
+import { createWriteStream, mkdirSync, readFileSync, existsSync, statSync, openSync, readSync, closeSync, } from "node:fs";
+import { join } from "node:path";
+import { eventTypeToString } from "@grackle-ai/common";
+const openStreams = new Map();
+/** Initialize a JSONL log stream for a session at the given directory path. */
+export function initLog(logPath) {
+    mkdirSync(logPath, { recursive: true });
+    const streamPath = join(logPath, "stream.jsonl");
+    const ws = createWriteStream(streamPath, { flags: "a" });
+    openStreams.set(logPath, ws);
+}
+/**
+ * Ensure the JSONL log stream for the given path is open.
+ * If `initLog` has already been called for this path this is a no-op;
+ * otherwise it opens a new append stream.  Use this before `writeEvent`
+ * when the caller cannot guarantee that `initLog` has already been called
+ * (e.g. signal delivery to a PENDING session).
+ */
+export function ensureLogInitialized(logPath) {
+    if (!openStreams.has(logPath)) {
+        initLog(logPath);
+    }
+}
+/** Append a session event as a JSON line to the session's log file. */
+export function writeEvent(logPath, event) {
+    const ws = openStreams.get(logPath);
+    if (!ws)
+        return;
+    const line = JSON.stringify({
+        session_id: event.sessionId,
+        type: eventTypeToString(event.type),
+        timestamp: event.timestamp,
+        content: event.content,
+        raw: event.raw || undefined,
+    });
+    ws.write(line + "\n");
+}
+/** Close the write stream for a session log. */
+export function endSession(logPath) {
+    const ws = openStreams.get(logPath);
+    if (ws) {
+        ws.end();
+        openStreams.delete(logPath);
+    }
+}
+/** Number of bytes to read from the tail of a log file when searching for the last text entry. */
+const LOG_TAIL_BYTES = 65536; // 64 KB
+/**
+ * Read the last "text" entry from a session's JSONL log file without parsing the whole file.
+ * Reads only the tail of the file (up to LOG_TAIL_BYTES) to limit the amount of synchronous
+ * work and reduce event-loop blocking time for large sessions.
+ */
+export function readLastTextEntry(logPath) {
+    const streamPath = join(logPath, "stream.jsonl");
+    if (!existsSync(streamPath)) {
+        return undefined;
+    }
+    const stats = statSync(streamPath);
+    if (stats.size === 0) {
+        return undefined;
+    }
+    const readSize = Math.min(stats.size, LOG_TAIL_BYTES);
+    const buffer = Buffer.alloc(readSize);
+    const fd = openSync(streamPath, "r");
+    let bytesRead = 0;
+    try {
+        bytesRead = readSync(fd, buffer, 0, readSize, stats.size - readSize);
+    }
+    finally {
+        closeSync(fd);
+    }
+    if (bytesRead <= 0) {
+        return undefined;
+    }
+    const lines = buffer.subarray(0, bytesRead).toString("utf-8").split("\n");
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i].trim();
+        if (!line) {
+            continue;
+        }
+        try {
+            const entry = JSON.parse(line);
+            if (entry.type === "text") {
+                return entry;
+            }
+        }
+        catch {
+            // Skip malformed lines (the first line may be partial when reading from a byte offset)
+        }
+    }
+    return undefined;
+}
+/** Read and parse all log entries from a session's JSONL log file. */
+export function readLog(logPath) {
+    const streamPath = join(logPath, "stream.jsonl");
+    if (!existsSync(streamPath))
+        return [];
+    const content = readFileSync(streamPath, "utf-8");
+    return content
+        .split("\n")
+        .filter((line) => line.trim())
+        .map((line) => JSON.parse(line));
+}
+//# sourceMappingURL=log-writer.js.map

package/dist/log-writer.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,4 @@
+import { type Logger } from "pino";
+/** Application logger for the Grackle server. */
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAa,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAEzC,iDAAiD;AACjD,eAAO,MAAM,MAAM,EAAE,MAMnB,CAAC"}

package/dist/logger.js

@@ -0,0 +1,10 @@
+import pino from "pino";
+/** Application logger for the Grackle server. */
+export const logger = pino({
+    name: "grackle-server",
+    level: process.env.LOG_LEVEL || "info",
+    transport: process.env.NODE_ENV !== "production"
+        ? { target: "pino/file", options: { destination: 1 } }
+        : undefined,
+});
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAqB,MAAM,MAAM,CAAC;AAEzC,iDAAiD;AACjD,MAAM,CAAC,MAAM,MAAM,GAAW,IAAI,CAAC;IACjC,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;IACtC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QAC9C,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE;QACtD,CAAC,CAAC,SAAS;CACd,CAAC,CAAC"}

package/dist/pipe-delivery.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pipe delivery — wires IPC streams to session sendInput for parent↔child communication.
+ *
+ * - `setupAsyncPipeDelivery()`: registers an async listener that calls sendInput on the
+ *   parent session when a child publishes a message to the pipe stream.
+ * - `publishChildCompletion()`: called from the event processor when a child session with
+ *   a pipe reaches terminal status, publishing the result to the IPC stream.
+ *   For async pipes, cleans up after publish. For sync pipes, cleanup is handled
+ *   by the WaitForPipe consumer after it reads the message.
+ */
+/**
+ * Register an async delivery listener for a session. When messages arrive on any
+ * async subscription for this session, the listener calls sendInput to inject them.
+ *
+ * Idempotent — safe to call multiple times for the same session.
+ *
+ * The listener throws if pre-dispatch checks fail (session not found, environment
+ * disconnected), which causes the stream-registry to leave the message as undelivered.
+ * Note: once sendInput is dispatched, the message is marked delivered even if the
+ * gRPC call later fails — delivery tracking covers pre-dispatch failures only.
+ */
+export declare function ensureAsyncDeliveryListener(sessionId: string): void;
+/** @deprecated Use ensureAsyncDeliveryListener instead. */
+export declare function setupAsyncPipeDelivery(parentSessionId: string): void;
+/**
+ * Publish a completion message to the IPC stream when a child session with a pipe
+ * reaches terminal status. Called from the event processor.
+ *
+ * For async pipes: cleans up the stream and listener immediately after publish.
+ * For sync pipes: does NOT clean up — the WaitForPipe consumer handles cleanup
+ * after it reads the message (avoids race where cleanup runs before consumer reads).
+ */
+export declare function publishChildCompletion(childSessionId: string, status: string): void;
+/**
+ * Remove the async listener for a session if it has no remaining async subscriptions.
+ * Called from closeFd when closing a pipe fd.
+ */
+export declare function cleanupAsyncListenerIfEmpty(sessionId: string): void;
+/** Clear all state. For testing only. */
+export declare function _resetForTesting(): void;
+//# sourceMappingURL=pipe-delivery.d.ts.map

package/dist/pipe-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe-delivery.d.ts","sourceRoot":"","sources":["../src/pipe-delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuBH;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAyBnE;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAuCnF;AAmED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAUnE;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}

package/dist/pipe-delivery.js

@@ -0,0 +1,186 @@
+/**
+ * Pipe delivery — wires IPC streams to session sendInput for parent↔child communication.
+ *
+ * - `setupAsyncPipeDelivery()`: registers an async listener that calls sendInput on the
+ *   parent session when a child publishes a message to the pipe stream.
+ * - `publishChildCompletion()`: called from the event processor when a child session with
+ *   a pipe reaches terminal status, publishing the result to the IPC stream.
+ *   For async pipes, cleans up after publish. For sync pipes, cleanup is handled
+ *   by the WaitForPipe consumer after it reads the message.
+ */
+import { create } from "@bufbuild/protobuf";
+import { powerline } from "@grackle-ai/common";
+import { sessionStore } from "@grackle-ai/database";
+import * as adapterManager from "./adapter-manager.js";
+import * as streamRegistry from "./stream-registry.js";
+import { readLastTextEntry } from "./log-writer.js";
+import { logger } from "./logger.js";
+/** Maximum length for the child's last text message in pipe delivery. */
+const MAX_LAST_MESSAGE_LENGTH = 4000;
+/** Human-readable status labels keyed by runtime event content strings. */
+const STATUS_LABELS = {
+    completed: "completed",
+    killed: "was killed",
+    failed: "failed",
+};
+/** Stored unsubscribe functions for async listeners, keyed by parent session ID. */
+const asyncListenerCleanups = new Map();
+/**
+ * Register an async delivery listener for a session. When messages arrive on any
+ * async subscription for this session, the listener calls sendInput to inject them.
+ *
+ * Idempotent — safe to call multiple times for the same session.
+ *
+ * The listener throws if pre-dispatch checks fail (session not found, environment
+ * disconnected), which causes the stream-registry to leave the message as undelivered.
+ * Note: once sendInput is dispatched, the message is marked delivered even if the
+ * gRPC call later fails — delivery tracking covers pre-dispatch failures only.
+ */
+export function ensureAsyncDeliveryListener(sessionId) {
+    if (asyncListenerCleanups.has(sessionId)) {
+        return;
+    }
+    const unsubscribe = streamRegistry.registerAsyncListener(sessionId, (sub, msg) => {
+        const session = sessionStore.getSession(sessionId);
+        if (!session) {
+            throw new Error(`Async pipe delivery: session ${sessionId} not found`);
+        }
+        const conn = adapterManager.getConnection(session.environmentId);
+        if (!conn) {
+            throw new Error(`Async pipe delivery: environment ${session.environmentId} not connected`);
+        }
+        const text = `[fd:${sub.fd}] ${msg.content}`;
+        conn.client.sendInput(create(powerline.InputMessageSchema, { sessionId, text })).catch((err) => {
+            logger.warn({ err, sessionId }, "Async pipe delivery: sendInput failed after dispatch");
+        });
+    });
+    asyncListenerCleanups.set(sessionId, unsubscribe);
+}
+/** @deprecated Use ensureAsyncDeliveryListener instead. */
+export function setupAsyncPipeDelivery(parentSessionId) {
+    ensureAsyncDeliveryListener(parentSessionId);
+}
+/**
+ * Publish a completion message to the IPC stream when a child session with a pipe
+ * reaches terminal status. Called from the event processor.
+ *
+ * For async pipes: cleans up the stream and listener immediately after publish.
+ * For sync pipes: does NOT clean up — the WaitForPipe consumer handles cleanup
+ * after it reads the message (avoids race where cleanup runs before consumer reads).
+ */
+export function publishChildCompletion(childSessionId, status) {
+    const session = sessionStore.getSession(childSessionId);
+    if (!session) {
+        return;
+    }
+    // Only publish for sessions that have a parent and a non-detach pipe
+    if (!session.parentSessionId || !session.pipeMode || session.pipeMode === "detach") {
+        return;
+    }
+    // Find the pipe stream by name convention
+    const pipeStream = streamRegistry.getStreamByName(`pipe:${childSessionId}`);
+    if (!pipeStream) {
+        return;
+    }
+    // Build rich completion message with child's actual output
+    const message = buildCompletionMessage(session, status);
+    try {
+        streamRegistry.publish(pipeStream.id, childSessionId, message);
+    }
+    catch (err) {
+        logger.warn({ err, childSessionId }, "Failed to publish child completion to IPC stream");
+    }
+    // For async pipes, only clean up if all messages were successfully delivered.
+    // If delivery failed (listener threw), keep the stream so hasUndeliveredMessages
+    // stays accurate for close() buffer drain checks.
+    // For sync pipes, the WaitForPipe handler cleans up after consumeSync returns.
+    if (session.pipeMode === "async") {
+        // Check all parent subscriptions — if any have undelivered messages, keep the stream
+        const parentSubs = streamRegistry.getSubscriptionsForSession(session.parentSessionId)
+            .filter((s) => s.streamId === pipeStream.id);
+        const allDelivered = parentSubs.every((s) => !streamRegistry.hasUndeliveredMessages(s.id));
+        if (allDelivered) {
+            cleanupAsyncPipe(pipeStream.id, session.parentSessionId);
+        }
+    }
+}
+/** Clean up an async pipe stream and its listener (only if no remaining async subs for parent). */
+function cleanupAsyncPipe(streamId, parentSessionId) {
+    // Collect all session IDs on this stream before deleting (for listener cleanup)
+    const stream = streamRegistry.getStream(streamId);
+    const sessionIds = [];
+    if (stream) {
+        for (const sub of stream.subscriptions.values()) {
+            sessionIds.push(sub.sessionId);
+        }
+    }
+    // Delete the stream (which unsubscribes everyone)
+    streamRegistry.deleteStream(streamId);
+    // Clean up async listeners for all sessions that were on this stream
+    // (both parent and child). Only removes if no remaining async subscriptions.
+    for (const sid of sessionIds) {
+        cleanupAsyncListenerIfEmpty(sid);
+    }
+}
+/**
+ * Build a rich completion message from the child session's log,
+ * including the status and the child's last text output.
+ */
+// eslint-disable-next-line @rushstack/no-new-null -- matches DB schema types
+function buildCompletionMessage(session, status) {
+    const statusLabel = STATUS_LABELS[status] || status;
+    let message = `Child session ${statusLabel}.`;
+    // Extract the last text message from the child's session log
+    const lastText = extractLastTextMessage(session.logPath || undefined);
+    if (lastText) {
+        const truncated = lastText.length > MAX_LAST_MESSAGE_LENGTH
+            ? lastText.slice(0, MAX_LAST_MESSAGE_LENGTH) + "..."
+            : lastText;
+        message += `\n\nChild's last message:\n${truncated}`;
+    }
+    if (session.error) {
+        message += `\n\nError: ${session.error}`;
+    }
+    return message;
+}
+/**
+ * Read the session log and extract the content of the last "text" entry.
+ * Uses tail-reading to reduce worst-case work on large logs (reads from
+ * the end of the file rather than parsing the entire JSONL). Still uses
+ * synchronous filesystem calls.
+ * 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 "";
+    }
+}
+/**
+ * Remove the async listener for a session if it has no remaining async subscriptions.
+ * Called from closeFd when closing a pipe fd.
+ */
+export function cleanupAsyncListenerIfEmpty(sessionId) {
+    const remainingAsyncSubs = streamRegistry.getSubscriptionsForSession(sessionId)
+        .filter((s) => s.deliveryMode === "async");
+    if (remainingAsyncSubs.length === 0) {
+        const cleanup = asyncListenerCleanups.get(sessionId);
+        if (cleanup) {
+            cleanup();
+            asyncListenerCleanups.delete(sessionId);
+        }
+    }
+}
+/** Clear all state. For testing only. */
+export function _resetForTesting() {
+    for (const cleanup of asyncListenerCleanups.values()) {
+        cleanup();
+    }
+    asyncListenerCleanups.clear();
+}
+//# sourceMappingURL=pipe-delivery.js.map

package/dist/pipe-delivery.js.map

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

package/dist/processor-registry.d.ts

@@ -0,0 +1,25 @@
+/** Mutable task context for a running event processor. */
+export interface ProcessorContext {
+    sessionId: string;
+    logPath: string;
+    workspaceId?: string;
+    taskId: string;
+}
+/** Register a processor context for a running event stream. */
+export declare function register(ctx: ProcessorContext): void;
+/** Unregister a processor context when the event stream ends. */
+export declare function unregister(sessionId: string): void;
+/** Retrieve the context for a running event processor, if any. */
+export declare function get(sessionId: string): ProcessorContext | undefined;
+/**
+ * Late-bind a task to a running processor. Updates workspaceId, taskId, and onComplete,
+ * then fires all registered bind listeners.
+ *
+ * Idempotent: binding to the same task is a no-op.
+ * Throws if the session is already bound to a different task (FR-6).
+ * Throws if the session is not registered (not actively processing).
+ */
+export declare function lateBind(sessionId: string, taskId: string, workspaceId?: string): void;
+/** Register a callback to be invoked when lateBind is called for this session. */
+export declare function onBind(sessionId: string, listener: () => void): void;
+//# sourceMappingURL=processor-registry.d.ts.map

package/dist/processor-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor-registry.d.ts","sourceRoot":"","sources":["../src/processor-registry.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAEpD;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED,kEAAkE;AAClE,wBAAgB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEnE;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CA4BN;AAED,kFAAkF;AAClF,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAOpE"}

package/dist/processor-registry.js

@@ -0,0 +1,58 @@
+import { logger } from "./logger.js";
+/** Registry of active event processor contexts, keyed by sessionId. */
+const registry = new Map();
+/** Callbacks invoked when a processor's task context is late-bound. */
+const bindListeners = new Map();
+/** Register a processor context for a running event stream. */
+export function register(ctx) {
+    registry.set(ctx.sessionId, ctx);
+}
+/** Unregister a processor context when the event stream ends. */
+export function unregister(sessionId) {
+    registry.delete(sessionId);
+    bindListeners.delete(sessionId);
+}
+/** Retrieve the context for a running event processor, if any. */
+export function get(sessionId) {
+    return registry.get(sessionId);
+}
+/**
+ * Late-bind a task to a running processor. Updates workspaceId, taskId, and onComplete,
+ * then fires all registered bind listeners.
+ *
+ * Idempotent: binding to the same task is a no-op.
+ * Throws if the session is already bound to a different task (FR-6).
+ * Throws if the session is not registered (not actively processing).
+ */
+export function lateBind(sessionId, taskId, workspaceId) {
+    const ctx = registry.get(sessionId);
+    if (!ctx) {
+        throw new Error(`No active event processor for session ${sessionId}`);
+    }
+    if (ctx.taskId !== "" && ctx.taskId !== taskId) {
+        throw new Error(`Session ${sessionId} is already bound to task ${ctx.taskId}, cannot rebind to ${taskId}`);
+    }
+    if (ctx.taskId === taskId) {
+        logger.info({ sessionId, taskId }, "Late-bind no-op: session already bound to this task");
+        return;
+    }
+    ctx.workspaceId = workspaceId;
+    ctx.taskId = taskId;
+    logger.info({ sessionId, taskId, workspaceId }, "Late-bound session to task");
+    const listeners = bindListeners.get(sessionId);
+    if (listeners) {
+        for (const listener of listeners) {
+            listener();
+        }
+    }
+}
+/** Register a callback to be invoked when lateBind is called for this session. */
+export function onBind(sessionId, listener) {
+    let listeners = bindListeners.get(sessionId);
+    if (!listeners) {
+        listeners = [];
+        bindListeners.set(sessionId, listeners);
+    }
+    listeners.push(listener);
+}
+//# sourceMappingURL=processor-registry.js.map

package/dist/processor-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor-registry.js","sourceRoot":"","sources":["../src/processor-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAUrC,uEAAuE;AACvE,MAAM,QAAQ,GAAkC,IAAI,GAAG,EAA4B,CAAC;AAEpF,uEAAuE;AACvE,MAAM,aAAa,GAAmC,IAAI,GAAG,EAA6B,CAAC;AAE3F,+DAA+D;AAC/D,MAAM,UAAU,QAAQ,CAAC,GAAqB;IAC5C,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3B,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,GAAG,CAAC,SAAiB;IACnC,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,SAAiB,EACjB,MAAc,EACd,WAAoB;IAEpB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,yCAAyC,SAAS,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,WAAW,SAAS,6BAA6B,GAAG,CAAC,MAAM,sBAAsB,MAAM,EAAE,CAC1F,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,qDAAqD,CAAC,CAAC;QAC1F,OAAO;IACT,CAAC;IAED,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;IAC9B,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IAEpB,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,4BAA4B,CAAC,CAAC;IAE9E,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,MAAM,CAAC,SAAiB,EAAE,QAAoB;IAC5D,IAAI,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,EAAE,CAAC;QACf,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC"}

package/dist/reanimate-agent.d.ts

@@ -0,0 +1,12 @@
+import type { SessionRow } from "@grackle-ai/database";
+/**
+ * Reanimate a terminal session: validate state, reset the DB record, and fire a
+ * PowerLine resume stream. Returns the updated session row (status=running).
+ *
+ * Throws ConnectError on any validation failure:
+ *   - NOT_FOUND if the session does not exist
+ *   - FAILED_PRECONDITION if the session is still active, has no runtimeSessionId,
+ *     the environment already has an active session, or the environment is offline
+ */
+export declare function reanimateAgent(sessionId: string): SessionRow;
+//# sourceMappingURL=reanimate-agent.d.ts.map

package/dist/reanimate-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reanimate-agent.d.ts","sourceRoot":"","sources":["../src/reanimate-agent.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAIvD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAqF5D"}

package/dist/reanimate-agent.js

@@ -0,0 +1,76 @@
+import { ConnectError, Code } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import { powerline, SESSION_STATUS, LOGS_DIR } from "@grackle-ai/common";
+import { join } from "node:path";
+import { sessionStore, taskStore, grackleHome } from "@grackle-ai/database";
+import * as adapterManager from "./adapter-manager.js";
+import { processEventStream } from "./event-processor.js";
+/**
+ * Reanimate a terminal session: validate state, reset the DB record, and fire a
+ * PowerLine resume stream. Returns the updated session row (status=running).
+ *
+ * Throws ConnectError on any validation failure:
+ *   - NOT_FOUND if the session does not exist
+ *   - FAILED_PRECONDITION if the session is still active, has no runtimeSessionId,
+ *     the environment already has an active session, or the environment is offline
+ */
+export function reanimateAgent(sessionId) {
+    const session = sessionStore.getSession(sessionId);
+    if (!session) {
+        throw new ConnectError(`Session not found: ${sessionId}`, Code.NotFound);
+    }
+    if (session.status === SESSION_STATUS.IDLE ||
+        session.status === SESSION_STATUS.RUNNING ||
+        session.status === SESSION_STATUS.PENDING) {
+        throw new ConnectError(`Session ${sessionId} is already active (status: ${session.status})`, Code.FailedPrecondition);
+    }
+    if (!session.runtimeSessionId) {
+        throw new ConnectError(`Session ${sessionId} has no runtime session ID — cannot reanimate`, Code.FailedPrecondition);
+    }
+    const existingActive = sessionStore.getActiveForEnv(session.environmentId);
+    if (existingActive) {
+        throw new ConnectError(`Environment already has active session ${existingActive.id}`, Code.FailedPrecondition);
+    }
+    // Note: the check above and reanimateSession() below are not wrapped in a DB
+    // transaction, but Node.js's single-threaded event loop provides sufficient
+    // serialization: this function is fully synchronous (no awaits, all SQLite
+    // calls use the synchronous better-sqlite3 API), so it runs to completion
+    // before any other handler can interleave.
+    const conn = adapterManager.getConnection(session.environmentId);
+    if (!conn) {
+        throw new ConnectError(`Environment ${session.environmentId} not connected`, Code.FailedPrecondition);
+    }
+    const powerlineReq = create(powerline.ResumeRequestSchema, {
+        sessionId: session.id,
+        runtimeSessionId: session.runtimeSessionId,
+        runtime: session.runtime,
+    });
+    const logPath = session.logPath || join(grackleHome, LOGS_DIR, session.id);
+    let workspaceId;
+    let taskId;
+    if (session.taskId) {
+        const task = taskStore.getTask(session.taskId);
+        if (task) {
+            workspaceId = task.workspaceId || undefined;
+            taskId = task.id;
+        }
+    }
+    // Initiate the stream before mutating the DB. If resume() throws synchronously
+    // the DB is never touched, so no rollback is needed.
+    let resumeStream;
+    try {
+        resumeStream = conn.client.resume(powerlineReq);
+    }
+    catch (err) {
+        throw new ConnectError(`Failed to initiate resume stream: ${String(err)}`, Code.Internal);
+    }
+    sessionStore.reanimateSession(session.id);
+    processEventStream(resumeStream, {
+        sessionId: session.id,
+        logPath,
+        workspaceId,
+        taskId,
+    });
+    return sessionStore.getSession(session.id);
+}
+//# sourceMappingURL=reanimate-agent.js.map

package/dist/reanimate-agent.js.map

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

package/dist/session-recovery.d.ts

@@ -0,0 +1,16 @@
+import type { PowerLineConnection } from "@grackle-ai/adapter-sdk";
+/**
+ * Recover disconnected sessions for a newly reconnected environment.
+ *
+ * Finds sessions in SUSPENDED, RUNNING, or IDLE state (RUNNING/IDLE handles
+ * the "server died" scenario where sessions never got suspended). Drains
+ * buffered events from PowerLine, writes them to the session JSONL, then
+ * reanimates the first recoverable session. Remaining sessions are left
+ * SUSPENDED for later recovery (only one active session per environment).
+ *
+ * Fire-and-forget: logs errors but does not throw.
+ */
+export declare function recoverSuspendedSessions(environmentId: string, connection: PowerLineConnection): Promise<void>;
+/** @internal Reset the recovery lock for testing. */
+export declare function _resetForTesting(): void;
+//# sourceMappingURL=session-recovery.d.ts.map

package/dist/session-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-recovery.d.ts","sourceRoot":"","sources":["../src/session-recovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAWnE;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAkHf;AAWD,qDAAqD;AACrD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}