@grackle-ai/runtime-sdk 0.82.2

package/dist/async-queue.d.ts

@@ -0,0 +1,13 @@
+/** A simple async queue that implements `AsyncIterable`, allowing consumers to `for await` over pushed items. */
+export declare class AsyncQueue<T> {
+    private queue;
+    private waiters;
+    private closed;
+    push(item: T): void;
+    shift(): Promise<T | undefined>;
+    /** Remove and return all items currently buffered in the queue. */
+    drain(): T[];
+    close(): void;
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+}
+//# sourceMappingURL=async-queue.d.ts.map

package/dist/async-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-queue.d.ts","sourceRoot":"","sources":["../src/async-queue.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,MAAM,CAAkB;IAEzB,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAUb,KAAK,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAU5C,mEAAmE;IAC5D,KAAK,IAAI,CAAC,EAAE;IAIZ,KAAK,IAAI,IAAI;IAQN,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC;CAQjE"}

package/dist/async-queue.js

@@ -0,0 +1,48 @@
+/** A simple async queue that implements `AsyncIterable`, allowing consumers to `for await` over pushed items. */
+export class AsyncQueue {
+    queue = [];
+    waiters = [];
+    closed = false;
+    push(item) {
+        if (this.closed)
+            return;
+        if (this.waiters.length > 0) {
+            const waiter = this.waiters.shift();
+            waiter(item);
+        }
+        else {
+            this.queue.push(item);
+        }
+    }
+    async shift() {
+        if (this.queue.length > 0) {
+            return this.queue.shift();
+        }
+        if (this.closed)
+            return undefined;
+        return new Promise((resolve) => {
+            this.waiters.push(resolve);
+        });
+    }
+    /** Remove and return all items currently buffered in the queue. */
+    drain() {
+        return this.queue.splice(0);
+    }
+    close() {
+        this.closed = true;
+        for (const waiter of this.waiters) {
+            waiter(undefined);
+        }
+        this.waiters.length = 0;
+    }
+    async *[Symbol.asyncIterator]() {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- closed changes asynchronously via close()
+        while (true) {
+            const item = await this.shift();
+            if (item === undefined)
+                return;
+            yield item;
+        }
+    }
+}
+//# sourceMappingURL=async-queue.js.map

package/dist/async-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-queue.js","sourceRoot":"","sources":["../src/async-queue.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,MAAM,OAAO,UAAU;IACb,KAAK,GAAQ,EAAE,CAAC;IAChB,OAAO,GAA0C,EAAE,CAAC;IACpD,MAAM,GAAY,KAAK,CAAC;IAEzB,IAAI,CAAC,IAAO;QACjB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAG,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAClC,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;YAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IAC5D,KAAK;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,SAAS,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAClC,oHAAoH;QACpH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO;YAC/B,MAAM,IAAI,CAAC;QACb,CAAC;IACH,CAAC;CACF"}

package/dist/base-runtime.d.ts

@@ -0,0 +1,30 @@
+import type { AgentRuntime, AgentSession, SpawnOptions, ResumeOptions } from "./runtime.js";
+/**
+ * Abstract base class for agent runtimes that share the spawn/resume pattern.
+ *
+ * Subclasses implement `createSession()` to construct the runtime-specific session.
+ * The `spawn()` and `resume()` methods delegate to `createSession()` with the
+ * appropriate parameters.
+ */
+export declare abstract class BaseAgentRuntime implements AgentRuntime {
+    abstract name: string;
+    /**
+     * Prompt text used when resuming a session. Defaults to `""`.
+     * CopilotRuntime overrides to `"(resumed)"` since the Copilot SDK requires a non-empty prompt.
+     */
+    protected resumePrompt: string;
+    /**
+     * Create a runtime-specific agent session.
+     *
+     * Called by both `spawn()` and `resume()` with the appropriate parameters.
+     */
+    protected abstract createSession(id: string, prompt: string, model: string, maxTurns: number, resumeSessionId?: string, branch?: string, workingDirectory?: string, systemContext?: string, mcpServers?: Record<string, unknown>, hooks?: Record<string, unknown>, mcpBroker?: {
+        url: string;
+        token: string;
+    }, useWorktrees?: boolean): AgentSession;
+    /** Create and start a new agent session. */
+    spawn(opts: SpawnOptions): AgentSession;
+    /** Resume a previously suspended session. */
+    resume(opts: ResumeOptions): AgentSession;
+}
+//# sourceMappingURL=base-runtime.d.ts.map

package/dist/base-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-runtime.d.ts","sourceRoot":"","sources":["../src/base-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE5F;;;;;;GAMG;AACH,8BAAsB,gBAAiB,YAAW,YAAY;IAC5D,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,CAAM;IAEpC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAC9B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,MAAM,EACzB,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAC1C,YAAY,CAAC,EAAE,OAAO,GACrB,YAAY;IAEf,4CAA4C;IACrC,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY;IAiB9C,6CAA6C;IACtC,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY;CASjD"}

package/dist/base-runtime.js

@@ -0,0 +1,23 @@
+/**
+ * Abstract base class for agent runtimes that share the spawn/resume pattern.
+ *
+ * Subclasses implement `createSession()` to construct the runtime-specific session.
+ * The `spawn()` and `resume()` methods delegate to `createSession()` with the
+ * appropriate parameters.
+ */
+export class BaseAgentRuntime {
+    /**
+     * Prompt text used when resuming a session. Defaults to `""`.
+     * CopilotRuntime overrides to `"(resumed)"` since the Copilot SDK requires a non-empty prompt.
+     */
+    resumePrompt = "";
+    /** Create and start a new agent session. */
+    spawn(opts) {
+        return this.createSession(opts.sessionId, opts.prompt, opts.model, opts.maxTurns, undefined, opts.branch, opts.workingDirectory, opts.systemContext, opts.mcpServers, opts.hooks, opts.mcpBroker, opts.useWorktrees);
+    }
+    /** Resume a previously suspended session. */
+    resume(opts) {
+        return this.createSession(opts.sessionId, this.resumePrompt, "", 0, opts.runtimeSessionId);
+    }
+}
+//# sourceMappingURL=base-runtime.js.map

package/dist/base-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-runtime.js","sourceRoot":"","sources":["../src/base-runtime.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAgB,gBAAgB;IAGpC;;;OAGG;IACO,YAAY,GAAW,EAAE,CAAC;IAsBpC,4CAA4C;IACrC,KAAK,CAAC,IAAkB;QAC7B,OAAO,IAAI,CAAC,aAAa,CACvB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,QAAQ,EACb,SAAS,EACT,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,YAAY,CAClB,CAAC;IACJ,CAAC;IAED,6CAA6C;IACtC,MAAM,CAAC,IAAmB;QAC/B,OAAO,IAAI,CAAC,aAAa,CACvB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,YAAY,EACjB,EAAE,EACF,CAAC,EACD,IAAI,CAAC,gBAAgB,CACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/base-session.d.ts

@@ -0,0 +1,104 @@
+import type { AgentSession, AgentEvent } from "./runtime.js";
+import type { SessionStatus } from "@grackle-ai/common";
+import { AsyncQueue } from "./async-queue.js";
+/**
+ * Abstract base class for agent sessions that use the eventQueue + waiting_input lifecycle.
+ *
+ * Provides the shared session lifecycle:
+ * - `stream()` yields an initial system message, drives `runSession()` in the background,
+ *   and yields events from the queue.
+ * - `runSession()` calls `setupSdk()`, handles resume vs initial query, transitions to waiting_input,
+ *   then starts the input processing loop.
+ * - `sendInput()` enqueues input for sequential processing by the input loop.
+ * - `processInputLoop()` dequeues inputs and calls `executeFollowUp()` one at a time,
+ *   preventing concurrent follow-ups across all runtimes.
+ * - `kill()` aborts active work, closes the input queue, releases resources, and closes the event queue.
+ *
+ * Subclasses implement the SDK-specific abstract methods.
+ */
+export declare abstract class BaseAgentSession implements AgentSession {
+    id: string;
+    abstract runtimeName: string;
+    runtimeSessionId: string;
+    status: SessionStatus;
+    protected readonly eventQueue: AsyncQueue<AgentEvent>;
+    private readonly inputQueue;
+    protected killed: boolean;
+    protected readonly prompt: string;
+    protected readonly model: string;
+    protected readonly maxTurns: number;
+    protected readonly resumeSessionId?: string;
+    protected readonly branch?: string;
+    protected readonly workingDirectory?: string;
+    protected readonly useWorktrees: boolean;
+    protected readonly systemContext?: string;
+    protected readonly mcpServers?: Record<string, unknown>;
+    protected readonly hooks?: Record<string, unknown>;
+    protected readonly mcpBroker?: {
+        url: string;
+        token: string;
+    };
+    /** Human-readable display name for system messages (e.g. "Claude Code", "Codex"). */
+    protected abstract readonly runtimeDisplayName: string;
+    /** Error message displayed when the initial query returns zero messages. */
+    protected abstract readonly noMessagesError: string;
+    constructor(id: string, prompt: string, model: string, maxTurns: number, resumeSessionId?: string, branch?: string, workingDirectory?: string, systemContext?: string, mcpServers?: Record<string, unknown>, hooks?: Record<string, unknown>, mcpBroker?: {
+        url: string;
+        token: string;
+    }, useWorktrees?: boolean);
+    /**
+     * Initialize the SDK (import libraries, create instances, resolve worktree).
+     * Called once at the start of `runSession()`, before resume checks or initial query.
+     */
+    protected abstract setupSdk(): Promise<void>;
+    /**
+     * Perform resume-specific setup (e.g. resume thread, emit system message).
+     * Called only when `resumeSessionId` is set.
+     */
+    protected abstract setupForResume(): Promise<void>;
+    /**
+     * Run the initial query with the given prompt.
+     * Should consume the SDK stream/query and push events to `eventQueue`.
+     * Returns the number of meaningful messages processed.
+     */
+    protected abstract runInitialQuery(prompt: string): Promise<number>;
+    /**
+     * Execute a follow-up input on the existing session.
+     * Should consume the SDK stream/query and push events to `eventQueue`.
+     * Resolves when the follow-up is complete.
+     */
+    protected abstract executeFollowUp(text: string): Promise<void>;
+    /** Check whether the session is ready to accept follow-up input via `sendInput()`. */
+    protected abstract canAcceptInput(): boolean;
+    /** Abort the currently active stream or query. */
+    protected abstract abortActive(): void;
+    /**
+     * Release SDK resources for garbage collection.
+     * Called on kill and on fatal error. Default is a no-op.
+     */
+    protected releaseResources(): void;
+    /**
+     * Build the initial prompt by combining system context with the user prompt.
+     * Subclasses that inject system context via SDK-native mechanisms should
+     * override this to return just `this.prompt`.
+     */
+    protected buildInitialPrompt(): string;
+    stream(): AsyncIterable<AgentEvent>;
+    /** Core session logic: setup SDK, handle resume or initial query, transition to waiting_input. */
+    private runSession;
+    /** Queue follow-up input for sequential processing by the input loop. */
+    sendInput(text: string): void;
+    /**
+     * Background loop that dequeues input and calls `executeFollowUp()` sequentially.
+     * Started after the initial query (or resume setup) completes. Owns the eventQueue
+     * lifecycle — closes it when the loop exits.
+     */
+    private processInputLoop;
+    /** Fire-and-forget launch of the input processing loop. */
+    private startInputLoop;
+    /** Forcefully terminate the session. Emits a final status event with the given reason. */
+    kill(reason?: string): void;
+    /** Drain any buffered events that were not yet consumed by the stream. */
+    drainBufferedEvents(): AgentEvent[];
+}
+//# sourceMappingURL=base-session.d.ts.map

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

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

package/dist/base-session.js

@@ -0,0 +1,198 @@
+import { SESSION_STATUS } from "@grackle-ai/common";
+import { AsyncQueue } from "./async-queue.js";
+import { logger } from "./logger.js";
+/**
+ * Abstract base class for agent sessions that use the eventQueue + waiting_input lifecycle.
+ *
+ * Provides the shared session lifecycle:
+ * - `stream()` yields an initial system message, drives `runSession()` in the background,
+ *   and yields events from the queue.
+ * - `runSession()` calls `setupSdk()`, handles resume vs initial query, transitions to waiting_input,
+ *   then starts the input processing loop.
+ * - `sendInput()` enqueues input for sequential processing by the input loop.
+ * - `processInputLoop()` dequeues inputs and calls `executeFollowUp()` one at a time,
+ *   preventing concurrent follow-ups across all runtimes.
+ * - `kill()` aborts active work, closes the input queue, releases resources, and closes the event queue.
+ *
+ * Subclasses implement the SDK-specific abstract methods.
+ */
+export class BaseAgentSession {
+    id;
+    runtimeSessionId;
+    status = SESSION_STATUS.RUNNING;
+    eventQueue = new AsyncQueue();
+    inputQueue = new AsyncQueue();
+    killed = false;
+    prompt;
+    model;
+    maxTurns;
+    resumeSessionId;
+    branch;
+    workingDirectory;
+    useWorktrees;
+    systemContext;
+    mcpServers;
+    hooks;
+    mcpBroker;
+    constructor(id, prompt, model, maxTurns, resumeSessionId, branch, workingDirectory, systemContext, mcpServers, hooks, mcpBroker, useWorktrees) {
+        this.id = id;
+        this.prompt = prompt;
+        this.model = model;
+        this.maxTurns = maxTurns;
+        this.resumeSessionId = resumeSessionId;
+        this.branch = branch;
+        this.workingDirectory = workingDirectory;
+        this.useWorktrees = useWorktrees ?? true;
+        this.systemContext = systemContext;
+        this.mcpServers = mcpServers;
+        this.hooks = hooks;
+        this.mcpBroker = mcpBroker;
+        this.runtimeSessionId = resumeSessionId || "";
+    }
+    /**
+     * Release SDK resources for garbage collection.
+     * Called on kill and on fatal error. Default is a no-op.
+     */
+    releaseResources() {
+        // Default: no-op. Override in subclasses that hold SDK references.
+    }
+    /**
+     * Build the initial prompt by combining system context with the user prompt.
+     * Subclasses that inject system context via SDK-native mechanisms should
+     * override this to return just `this.prompt`.
+     */
+    buildInitialPrompt() {
+        return this.systemContext
+            ? `${this.systemContext}\n\n---\n\n${this.prompt}`
+            : this.prompt;
+    }
+    // ─── Shared lifecycle implementation ──────────────────────
+    async *stream() {
+        const ts = () => new Date().toISOString();
+        yield { type: "system", timestamp: ts(), content: `Starting ${this.runtimeDisplayName} runtime...` };
+        // Drive the session in the background; events are pushed to the queue
+        // and yielded from this generator.
+        this.runSession().catch((err) => {
+            this.eventQueue.push({ type: "error", timestamp: ts(), content: String(err) });
+            this.eventQueue.push({ type: "status", timestamp: ts(), content: "failed" });
+            this.status = SESSION_STATUS.STOPPED;
+            this.eventQueue.close();
+        });
+        for await (const event of this.eventQueue) {
+            yield event;
+        }
+    }
+    /** Core session logic: setup SDK, handle resume or initial query, transition to waiting_input. */
+    async runSession() {
+        const ts = () => new Date().toISOString();
+        try {
+            await this.setupSdk();
+            // For resumed sessions, perform resume-specific setup and wait for input.
+            if (this.resumeSessionId) {
+                await this.setupForResume();
+                this.status = SESSION_STATUS.IDLE;
+                this.eventQueue.push({ type: "status", timestamp: ts(), content: "waiting_input" });
+                this.startInputLoop();
+                return;
+            }
+            // Build final prompt with system context
+            const finalPrompt = this.buildInitialPrompt();
+            const messageCount = await this.runInitialQuery(finalPrompt);
+            if (this.killed) {
+                this.releaseResources();
+                this.eventQueue.close();
+                return;
+            }
+            if (messageCount === 0) {
+                this.eventQueue.push({ type: "error", timestamp: ts(), content: this.noMessagesError });
+            }
+            // Session is idle — ready for follow-up input via sendInput().
+            // The input loop owns the eventQueue lifecycle from this point.
+            this.status = SESSION_STATUS.IDLE;
+            this.eventQueue.push({ type: "status", timestamp: ts(), content: "waiting_input" });
+            this.startInputLoop();
+        }
+        catch (err) {
+            this.status = SESSION_STATUS.STOPPED;
+            this.eventQueue.push({ type: "error", timestamp: ts(), content: String(err) });
+            this.eventQueue.push({ type: "status", timestamp: ts(), content: "failed" });
+            this.releaseResources();
+            this.eventQueue.close();
+        }
+    }
+    /** Queue follow-up input for sequential processing by the input loop. */
+    sendInput(text) {
+        if (this.killed || !this.canAcceptInput()) {
+            return;
+        }
+        this.inputQueue.push(text);
+    }
+    /**
+     * Background loop that dequeues input and calls `executeFollowUp()` sequentially.
+     * Started after the initial query (or resume setup) completes. Owns the eventQueue
+     * lifecycle — closes it when the loop exits.
+     */
+    async processInputLoop() {
+        const ts = () => new Date().toISOString();
+        for await (const text of this.inputQueue) {
+            if (this.killed) {
+                break;
+            }
+            this.status = SESSION_STATUS.RUNNING;
+            this.eventQueue.push({ type: "status", timestamp: ts(), content: "running" });
+            try {
+                await this.executeFollowUp(text);
+            }
+            catch (err) {
+                logger.warn({ err }, `Failed to process follow-up input in ${this.runtimeDisplayName} session`);
+                this.eventQueue.push({ type: "error", timestamp: ts(), content: String(err) });
+            }
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- killed changes asynchronously via kill()
+            if (this.killed) {
+                break;
+            }
+            this.status = SESSION_STATUS.IDLE;
+            this.eventQueue.push({ type: "status", timestamp: ts(), content: "waiting_input" });
+        }
+        // Loop exited — queue closed (kill) or drained.
+        this.releaseResources();
+        this.eventQueue.close();
+    }
+    /** Fire-and-forget launch of the input processing loop. */
+    startInputLoop() {
+        this.processInputLoop().catch((err) => {
+            const ts = new Date().toISOString();
+            logger.error({ err }, `Input loop crashed in ${this.runtimeDisplayName} session`);
+            this.status = SESSION_STATUS.STOPPED;
+            this.eventQueue.push({ type: "error", timestamp: ts, content: String(err) });
+            this.eventQueue.push({ type: "status", timestamp: ts, content: "failed" });
+            this.inputQueue.close();
+            this.releaseResources();
+            this.eventQueue.close();
+        });
+    }
+    /** Forcefully terminate the session. Emits a final status event with the given reason. */
+    kill(reason = "killed") {
+        this.killed = true;
+        this.status = SESSION_STATUS.STOPPED;
+        this.abortActive();
+        this.inputQueue.close();
+        // Emit a final status event BEFORE closing the queue so the server receives it.
+        this.eventQueue.push({
+            type: "status",
+            timestamp: new Date().toISOString(),
+            content: reason,
+        });
+        // releaseResources() and eventQueue.close() are also called by processInputLoop()
+        // when it exits, but we call them here too for the case where kill() is called
+        // before the input loop starts (e.g. during the initial query).
+        // Both are idempotent — safe to call multiple times.
+        this.releaseResources();
+        this.eventQueue.close();
+    }
+    /** Drain any buffered events that were not yet consumed by the stream. */
+    drainBufferedEvents() {
+        return this.eventQueue.drain();
+    }
+}
+//# sourceMappingURL=base-session.js.map

package/dist/base-session.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export type { AgentEvent, SpawnOptions, ResumeOptions, AgentSession, AgentRuntime } from "./runtime.js";
+export { BaseAgentRuntime } from "./base-runtime.js";
+export { BaseAgentSession } from "./base-session.js";
+export { resolveWorkingDirectory, findGitRepoPath, convertMcpServers, resolveMcpServers, NODE_GIT_REPOSITORY, NODE_WORKSPACE_LOCATOR, } from "./runtime-utils.js";
+export type { GitRepository, WorkspaceLocator, ResolveWorkingDirectoryOptions, ResolvedMcpConfig, BrokerConfig, } from "./runtime-utils.js";
+export { AsyncQueue } from "./async-queue.js";
+export { ensureWorktree, removeWorktree, worktreeDir, sanitizeBranch, } from "./worktree.js";
+export type { GitExecutor, WorktreeFileSystem, WorktreeResult } from "./worktree.js";
+export { ensureRuntimeInstalled, importFromRuntime, getRuntimeBinDirectory, isDevMode, } from "./runtime-installer.js";
+export type { RuntimeInstallOptions } from "./runtime-installer.js";
+export { logger } from "./logger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACxG,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,8BAA8B,EAC9B,iBAAiB,EACjB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,cAAc,EACd,cAAc,EACd,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,SAAS,GACV,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { BaseAgentRuntime } from "./base-runtime.js";
+export { BaseAgentSession } from "./base-session.js";
+export { resolveWorkingDirectory, findGitRepoPath, convertMcpServers, resolveMcpServers, NODE_GIT_REPOSITORY, NODE_WORKSPACE_LOCATOR, } from "./runtime-utils.js";
+export { AsyncQueue } from "./async-queue.js";
+export { ensureWorktree, removeWorktree, worktreeDir, sanitizeBranch, } from "./worktree.js";
+export { ensureRuntimeInstalled, importFromRuntime, getRuntimeBinDirectory, isDevMode, } from "./runtime-installer.js";
+export { logger } from "./logger.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,cAAc,EACd,cAAc,EACd,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,SAAS,GACV,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,4 @@
+import { type Logger } from "pino";
+/** Application logger for Grackle runtime packages. */
+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,uDAAuD;AACvD,eAAO,MAAM,MAAM,EAAE,MAMnB,CAAC"}

package/dist/logger.js

@@ -0,0 +1,10 @@
+import pino from "pino";
+/** Application logger for Grackle runtime packages. */
+export const logger = pino({
+    name: "grackle-runtime",
+    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,uDAAuD;AACvD,MAAM,CAAC,MAAM,MAAM,GAAW,IAAI,CAAC;IACjC,IAAI,EAAE,iBAAiB;IACvB,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/runtime-installer.d.ts

@@ -0,0 +1,43 @@
+/** Optional callbacks for install progress. */
+export interface RuntimeInstallOptions {
+    /** Callback for system-level events (e.g. "Installing claude-code runtime..."). */
+    eventCallback?: (message: string) => void;
+}
+/**
+ * Check if PowerLine is running from a monorepo source checkout.
+ * Looks for `rush.json` relative to PowerLine's compiled location
+ * (packages/powerline/dist → 3 levels up).
+ */
+export declare function isDevMode(): boolean;
+/**
+ * Ensure that the npm packages for a runtime are installed in an isolated
+ * directory under `~/.grackle/runtimes/<name>/`.
+ *
+ * **Fast path**: if the persisted manifest matches the current PowerLine
+ * version and package specs, returns immediately (one `readFileSync`).
+ *
+ * **Dev mode**: returns empty string immediately — Rush already resolves
+ * all packages via the monorepo's node_modules.
+ *
+ * @returns The absolute path to the runtime's install directory.
+ */
+export declare function ensureRuntimeInstalled(runtimeName: string, options?: RuntimeInstallOptions): Promise<string>;
+/**
+ * Dynamically import a module from an isolated runtime directory.
+ *
+ * In dev mode, falls back to standard `import()` since Rush handles resolution.
+ *
+ * @param runtimeName - Runtime identifier (e.g. "claude-code")
+ * @param packageName - npm package name to import (e.g. `\@anthropic-ai/claude-agent-sdk`)
+ * @returns The imported module
+ */
+export declare function importFromRuntime<T>(runtimeName: string, packageName: string): Promise<T>;
+/**
+ * Get the path to the `.bin` directory inside a runtime's node_modules.
+ * Used to add runtime-specific CLI binaries to PATH when spawning agent subprocesses.
+ *
+ * @param runtimeName - Runtime identifier (e.g. "codex-acp")
+ * @returns Absolute path to `~/.grackle/runtimes/<name>/node_modules/.bin`
+ */
+export declare function getRuntimeBinDirectory(runtimeName: string): string;
+//# sourceMappingURL=runtime-installer.d.ts.map

package/dist/runtime-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-installer.d.ts","sourceRoot":"","sources":["../src/runtime-installer.ts"],"names":[],"mappings":"AA4BA,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,mFAAmF;IACnF,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAID;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAGnC;AAmDD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CA8D/F;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CASlE"}