@kenkaiiii/ggcoder 5.25.0 → 5.26.1

package/dist/core/agent-notifications.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Bounded push queue for out-of-band events the agent should learn about
+ * without spending a turn asking — a spawned child finishing, a background
+ * build making progress or exiting.
+ *
+ * The queue is deliberately lossy. Only the LATEST entry per `(kind, id)`
+ * survives, because a stale "build is 40% through" line is worthless next to
+ * "build exited 1", and a parent that spawned five children needs five facts,
+ * not fifty. Terminal entries supersede pending non-terminal ones for the same
+ * id and cannot themselves be superseded by a later non-terminal update, so a
+ * completion can never be overwritten by a straggling progress tick.
+ *
+ * Every bound here protects the same thing: injected bytes per drain. These
+ * notifications ride the steering path into live context, so an unbounded
+ * queue would silently eat the context window it is meant to save.
+ */
+/** Notification source. Extended as new push producers are added. */
+export type NotificationKind = "subagent" | "process";
+export interface AgentNotification {
+    kind: NotificationKind;
+    /** Producer-scoped identity (agent id, process id). Dedupe key with `kind`. */
+    id: string;
+    /** Bounded, human-readable one-liner. Never raw output. */
+    text: string;
+    /** True once the producer reached a final state (child done, process exited). */
+    terminal: boolean;
+    /** Unix epoch ms of the most recent update for this `(kind, id)`. */
+    updatedAt: number;
+}
+/** Max characters retained for a single notification's text. */
+export declare const NOTIFICATION_MAX_CHARS = 512;
+/** Max characters returned by one `drain()`, across all notifications. */
+export declare const NOTIFICATION_DRAIN_MAX_CHARS = 1024;
+/**
+ * FIFO with latest-only dedupe by `(kind, id)`. Insertion order is preserved
+ * across updates: an entry that is updated keeps its original queue position,
+ * so a chatty producer cannot starve an older, quieter one out of a drain.
+ */
+export declare class AgentNotificationQueue {
+    private entries;
+    private static key;
+    /**
+     * Record the latest state for one producer. Returns false when the update
+     * was dropped because a terminal entry for the same id already exists.
+     */
+    enqueue(kind: NotificationKind, id: string, text: string, options?: {
+        terminal?: boolean;
+    }): boolean;
+    /** Number of notifications currently waiting. */
+    get size(): number;
+    /** Discard any pending notification for one producer (e.g. on reap). */
+    clear(kind: NotificationKind, id: string): void;
+    /** Discard everything (e.g. between runs). */
+    clearAll(): void;
+    /**
+     * Take pending notifications, oldest first, up to the per-drain char budget.
+     * Taken entries are removed; entries that did not fit stay queued for the
+     * next drain rather than being dropped.
+     */
+    drain(): AgentNotification[];
+}
+//# sourceMappingURL=agent-notifications.d.ts.map

package/dist/core/agent-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-notifications.d.ts","sourceRoot":"","sources":["../../src/core/agent-notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAOjD;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAwC;IAEvD,OAAO,CAAC,MAAM,CAAC,GAAG;IAIlB;;;OAGG;IACH,OAAO,CACL,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO,GACnC,OAAO;IAgBV,iDAAiD;IACjD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,wEAAwE;IACxE,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAI/C,8CAA8C;IAC9C,QAAQ,IAAI,IAAI;IAIhB;;;;OAIG;IACH,KAAK,IAAI,iBAAiB,EAAE;CAmB7B"}

package/dist/core/agent-notifications.js

@@ -0,0 +1,92 @@
+/**
+ * Bounded push queue for out-of-band events the agent should learn about
+ * without spending a turn asking — a spawned child finishing, a background
+ * build making progress or exiting.
+ *
+ * The queue is deliberately lossy. Only the LATEST entry per `(kind, id)`
+ * survives, because a stale "build is 40% through" line is worthless next to
+ * "build exited 1", and a parent that spawned five children needs five facts,
+ * not fifty. Terminal entries supersede pending non-terminal ones for the same
+ * id and cannot themselves be superseded by a later non-terminal update, so a
+ * completion can never be overwritten by a straggling progress tick.
+ *
+ * Every bound here protects the same thing: injected bytes per drain. These
+ * notifications ride the steering path into live context, so an unbounded
+ * queue would silently eat the context window it is meant to save.
+ */
+/** Max characters retained for a single notification's text. */
+export const NOTIFICATION_MAX_CHARS = 512;
+/** Max characters returned by one `drain()`, across all notifications. */
+export const NOTIFICATION_DRAIN_MAX_CHARS = 1024;
+function truncate(text, maxChars) {
+    const collapsed = text.replace(/\s+/g, " ").trim();
+    return collapsed.length <= maxChars ? collapsed : `${collapsed.slice(0, maxChars - 1)}\u2026`;
+}
+/**
+ * FIFO with latest-only dedupe by `(kind, id)`. Insertion order is preserved
+ * across updates: an entry that is updated keeps its original queue position,
+ * so a chatty producer cannot starve an older, quieter one out of a drain.
+ */
+export class AgentNotificationQueue {
+    entries = new Map();
+    static key(kind, id) {
+        return `${kind}:${id}`;
+    }
+    /**
+     * Record the latest state for one producer. Returns false when the update
+     * was dropped because a terminal entry for the same id already exists.
+     */
+    enqueue(kind, id, text, options = {}) {
+        const terminal = options.terminal === true;
+        const key = AgentNotificationQueue.key(kind, id);
+        const existing = this.entries.get(key);
+        // A completion is the last word — a late progress tick must not erase it.
+        if (existing?.terminal && !terminal)
+            return false;
+        this.entries.set(key, {
+            kind,
+            id,
+            text: truncate(text, NOTIFICATION_MAX_CHARS),
+            terminal,
+            updatedAt: Date.now(),
+        });
+        return true;
+    }
+    /** Number of notifications currently waiting. */
+    get size() {
+        return this.entries.size;
+    }
+    /** Discard any pending notification for one producer (e.g. on reap). */
+    clear(kind, id) {
+        this.entries.delete(AgentNotificationQueue.key(kind, id));
+    }
+    /** Discard everything (e.g. between runs). */
+    clearAll() {
+        this.entries.clear();
+    }
+    /**
+     * Take pending notifications, oldest first, up to the per-drain char budget.
+     * Taken entries are removed; entries that did not fit stay queued for the
+     * next drain rather than being dropped.
+     */
+    drain() {
+        const taken = [];
+        let budget = NOTIFICATION_DRAIN_MAX_CHARS;
+        for (const [key, entry] of this.entries) {
+            if (entry.text.length > budget) {
+                // Nothing taken yet and even one entry overflows: take it truncated
+                // rather than deadlocking the queue on an oversized head.
+                if (taken.length === 0) {
+                    taken.push({ ...entry, text: truncate(entry.text, budget) });
+                    this.entries.delete(key);
+                }
+                break;
+            }
+            budget -= entry.text.length;
+            taken.push(entry);
+            this.entries.delete(key);
+        }
+        return taken;
+    }
+}
+//# sourceMappingURL=agent-notifications.js.map

package/dist/core/agent-notifications.js.map

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

package/dist/core/agent-notifications.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-notifications.test.d.ts.map

package/dist/core/agent-notifications.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-notifications.test.d.ts","sourceRoot":"","sources":["../../src/core/agent-notifications.test.ts"],"names":[],"mappings":""}

package/dist/core/agent-notifications.test.js

@@ -0,0 +1,97 @@
+import { describe, it, expect } from "vitest";
+import { AgentNotificationQueue, NOTIFICATION_DRAIN_MAX_CHARS, NOTIFICATION_MAX_CHARS, } from "./agent-notifications.js";
+describe("AgentNotificationQueue", () => {
+    it("drains in insertion order and clears itself", () => {
+        const q = new AgentNotificationQueue();
+        q.enqueue("subagent", "a", "first");
+        q.enqueue("subagent", "b", "second");
+        expect(q.drain().map((n) => n.text)).toEqual(["first", "second"]);
+        expect(q.size).toBe(0);
+        expect(q.drain()).toEqual([]);
+    });
+    it("keeps only the latest entry per (kind, id)", () => {
+        const q = new AgentNotificationQueue();
+        q.enqueue("process", "p1", "10% done");
+        q.enqueue("process", "p1", "90% done");
+        const drained = q.drain();
+        expect(drained).toHaveLength(1);
+        expect(drained[0].text).toBe("90% done");
+    });
+    it("keys dedupe by kind as well as id", () => {
+        const q = new AgentNotificationQueue();
+        q.enqueue("process", "1", "process one");
+        q.enqueue("subagent", "1", "child one");
+        expect(q.drain()).toHaveLength(2);
+    });
+    it("preserves queue position when an entry is updated", () => {
+        const q = new AgentNotificationQueue();
+        q.enqueue("process", "p1", "old");
+        q.enqueue("process", "p2", "other");
+        q.enqueue("process", "p1", "new");
+        expect(q.drain().map((n) => n.text)).toEqual(["new", "other"]);
+    });
+    it("lets a terminal entry supersede a pending progress entry", () => {
+        const q = new AgentNotificationQueue();
+        q.enqueue("process", "p1", "still building");
+        expect(q.enqueue("process", "p1", "exited 0", { terminal: true })).toBe(true);
+        const drained = q.drain();
+        expect(drained).toHaveLength(1);
+        expect(drained[0]).toMatchObject({ text: "exited 0", terminal: true });
+    });
+    it("refuses to overwrite a terminal entry with a late progress tick", () => {
+        const q = new AgentNotificationQueue();
+        q.enqueue("process", "p1", "exited 1", { terminal: true });
+        expect(q.enqueue("process", "p1", "50% done")).toBe(false);
+        expect(q.drain()[0]).toMatchObject({ text: "exited 1", terminal: true });
+    });
+    it("allows a terminal entry to replace an earlier terminal entry", () => {
+        const q = new AgentNotificationQueue();
+        q.enqueue("subagent", "a", "failed", { terminal: true });
+        q.enqueue("subagent", "a", "done", { terminal: true });
+        expect(q.drain()[0].text).toBe("done");
+    });
+    it("caps a single notification at NOTIFICATION_MAX_CHARS", () => {
+        const q = new AgentNotificationQueue();
+        q.enqueue("subagent", "a", "x".repeat(NOTIFICATION_MAX_CHARS * 3));
+        const [entry] = q.drain();
+        expect(entry.text.length).toBe(NOTIFICATION_MAX_CHARS);
+        expect(entry.text.endsWith("\u2026")).toBe(true);
+    });
+    it("collapses whitespace so multi-line output cannot inflate a notification", () => {
+        const q = new AgentNotificationQueue();
+        q.enqueue("process", "p1", "  build\n\n  failed \t badly  ");
+        expect(q.drain()[0].text).toBe("build failed badly");
+    });
+    it("caps one drain at NOTIFICATION_DRAIN_MAX_CHARS and requeues the rest", () => {
+        const q = new AgentNotificationQueue();
+        for (let i = 0; i < 6; i++)
+            q.enqueue("subagent", `a${i}`, "y".repeat(NOTIFICATION_MAX_CHARS));
+        const first = q.drain();
+        const firstChars = first.reduce((sum, n) => sum + n.text.length, 0);
+        expect(firstChars).toBeLessThanOrEqual(NOTIFICATION_DRAIN_MAX_CHARS);
+        expect(first).toHaveLength(2);
+        // Nothing is lost — the remainder waits for the next drain.
+        expect(q.size).toBe(4);
+    });
+    it("never deadlocks on an oversized head entry", () => {
+        const q = new AgentNotificationQueue();
+        // Two max-size entries fill the drain budget exactly; add a third.
+        q.enqueue("subagent", "a", "y".repeat(NOTIFICATION_MAX_CHARS));
+        q.enqueue("subagent", "b", "y".repeat(NOTIFICATION_MAX_CHARS));
+        q.enqueue("subagent", "c", "z".repeat(NOTIFICATION_MAX_CHARS));
+        expect(q.drain()).toHaveLength(2);
+        const rest = q.drain();
+        expect(rest).toHaveLength(1);
+        expect(q.size).toBe(0);
+    });
+    it("clears a single producer and everything", () => {
+        const q = new AgentNotificationQueue();
+        q.enqueue("process", "p1", "a");
+        q.enqueue("process", "p2", "b");
+        q.clear("process", "p1");
+        expect(q.size).toBe(1);
+        q.clearAll();
+        expect(q.size).toBe(0);
+    });
+});
+//# sourceMappingURL=agent-notifications.test.js.map

package/dist/core/agent-notifications.test.js.map

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

package/dist/core/agent-session-model-switch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-session-model-switch.test.d.ts.map

package/dist/core/agent-session-model-switch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-model-switch.test.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-model-switch.test.ts"],"names":[],"mappings":""}

package/dist/core/agent-session-model-switch.test.js

@@ -0,0 +1,161 @@
+/**
+ * A mid-session model switch must be replayable state, not a silent mutation:
+ * recorded as a durable marker, injected as its own trailing message, and — the
+ * expensive part — kept OFF the cached system prefix so the next turn still
+ * reads from cache.
+ */
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { useFakeHome } from "../test-support/fake-home.js";
+const agentLoopMock = vi.hoisted(() => vi.fn());
+vi.mock("@kenkaiiii/gg-agent", async () => {
+    const actual = await vi.importActual("@kenkaiiii/gg-agent");
+    return { ...actual, agentLoop: agentLoopMock };
+});
+vi.mock("./mcp/index.js", async () => {
+    const actual = await vi.importActual("./mcp/index.js");
+    return {
+        ...actual,
+        MCPClientManager: vi.fn(function MCPClientManagerMock() {
+            return { connectAll: vi.fn(async () => []), dispose: vi.fn(async () => { }) };
+        }),
+    };
+});
+let restoreHome;
+let tempHome;
+let tempProject;
+const CACHE_MARKER = "<!-- uncached -->";
+beforeEach(async () => {
+    tempHome = await fs.mkdtemp(path.join(os.tmpdir(), "agent-switch-home-"));
+    tempProject = await fs.mkdtemp(path.join(os.tmpdir(), "agent-switch-project-"));
+    restoreHome = useFakeHome(tempHome);
+    agentLoopMock.mockReset();
+    await fs.mkdir(path.join(tempHome, ".gg"), { recursive: true });
+    await fs.writeFile(path.join(tempHome, ".gg", "auth.json"), JSON.stringify({
+        anthropic: { accessToken: "t", refreshToken: "t", expiresAt: Date.now() + 3_600_000 },
+        openai: { accessToken: "t", refreshToken: "t", expiresAt: Date.now() + 3_600_000 },
+    }));
+});
+afterEach(async () => {
+    restoreHome?.();
+    await Promise.all([
+        fs.rm(tempHome, { recursive: true, force: true }),
+        fs.rm(tempProject, { recursive: true, force: true }),
+    ]);
+    vi.clearAllMocks();
+});
+async function createSession() {
+    const { AgentSession } = await import("./agent-session.js");
+    const session = new AgentSession({
+        provider: "openai",
+        model: "gpt-5.6-sol",
+        // Repo cwd so the bundled agent definitions register spawn_agent — the
+        // Sol/Ultra orchestration block only renders when that tool exists, and it
+        // is the model-dependent prompt content this test is about.
+        cwd: process.cwd(),
+        systemPrompt: "stable role prompt",
+        thinkingLevel: "ultra",
+        transient: true,
+        selfCorrectionHooks: false,
+    });
+    await session.initialize();
+    // A conversation must already exist for the switch note to have a job.
+    session
+        .getMessages()
+        .push({ role: "user", content: "start the work" }, { role: "assistant", content: "on it" });
+    return session;
+}
+/**
+ * System-prompt bytes that carry cache_control. Mirrors the provider split in
+ * gg-ai `transform.ts`: everything before the marker, trimmed at the end.
+ */
+function cachedPrefix(content) {
+    const index = content.indexOf(CACHE_MARKER);
+    return (index === -1 ? content : content.slice(0, index)).trimEnd();
+}
+describe("AgentSession model switch", () => {
+    it("keeps the cached system prefix byte-identical across a switch", async () => {
+        const session = await createSession();
+        try {
+            const before = String(session.getMessages()[0].content);
+            // Sol/Ultra guidance is live, so the switch really does change the prompt.
+            expect(before).toContain(CACHE_MARKER);
+            expect(before).toContain("Proactively use spawn_agent");
+            await session.switchModel("openai", "gpt-5.5-codex");
+            const after = String(session.getMessages()[0].content);
+            expect(cachedPrefix(after)).toBe(cachedPrefix(before));
+            // Model-dependent guidance followed the model, out of the cached region.
+            expect(after).not.toContain("Proactively use spawn_agent");
+        }
+        finally {
+            await session.dispose();
+        }
+    }, 30_000);
+    it("appends the switch as its own trailing message", async () => {
+        const session = await createSession();
+        try {
+            await session.switchModel("openai", "gpt-5.5-codex");
+            const messages = session.getMessages();
+            const last = messages[messages.length - 1];
+            expect(last.role).toBe("user");
+            expect(String(last.content)).toContain("gpt-5.6-sol");
+            expect(String(last.content)).toContain("gpt-5.5-codex");
+            // Cross-provider switches name the provider on both sides.
+            await session.switchModel("anthropic", "claude-test");
+            expect(String(session.getMessages().at(-1).content)).toContain("anthropic/claude-test");
+        }
+        finally {
+            await session.dispose();
+        }
+    }, 30_000);
+    it("records a replayable model_switch marker", async () => {
+        const session = await createSession();
+        try {
+            await session.switchModel("openai", "gpt-5.5-codex");
+            const markers = session.getAppMarkers().filter((m) => m.kind === "model_switch");
+            expect(markers).toHaveLength(1);
+            expect(markers[0].data).toMatchObject({
+                from: "gpt-5.6-sol",
+                to: "gpt-5.5-codex",
+                provider: "openai",
+                fromProvider: "openai",
+            });
+        }
+        finally {
+            await session.dispose();
+        }
+    }, 30_000);
+    it("does nothing when the model did not actually change", async () => {
+        const session = await createSession();
+        try {
+            const before = [...session.getMessages()];
+            await session.switchModel("openai", "gpt-5.6-sol");
+            expect(session.getMessages()).toHaveLength(before.length);
+            expect(session.getAppMarkers().filter((m) => m.kind === "model_switch")).toHaveLength(0);
+        }
+        finally {
+            await session.dispose();
+        }
+    }, 30_000);
+    it("does not break tool pairing when a switch lands mid tool call", async () => {
+        const session = await createSession();
+        try {
+            session.getMessages().push({
+                role: "assistant",
+                content: [{ type: "tool_call", id: "t1", name: "read", args: {} }],
+            });
+            const count = session.getMessages().length;
+            await session.switchModel("openai", "gpt-5.5-codex");
+            // No user message may sit between tool_use and its tool_result.
+            expect(session.getMessages()).toHaveLength(count);
+            // The switch is still recorded durably.
+            expect(session.getAppMarkers().filter((m) => m.kind === "model_switch")).toHaveLength(1);
+        }
+        finally {
+            await session.dispose();
+        }
+    }, 30_000);
+});
+//# sourceMappingURL=agent-session-model-switch.test.js.map

package/dist/core/agent-session-model-switch.test.js.map

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

package/dist/core/agent-session-notifications.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-session-notifications.test.d.ts.map

package/dist/core/agent-session-notifications.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-notifications.test.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-notifications.test.ts"],"names":[],"mappings":""}

package/dist/core/agent-session-notifications.test.js

@@ -0,0 +1,114 @@
+/**
+ * Pushed notifications must reach the model on the steering path — a finished
+ * child or an exited background build should arrive on its own, without the
+ * agent spending a turn on wait_agent/task_output, and without displacing
+ * anything the user queued.
+ */
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { useFakeHome } from "../test-support/fake-home.js";
+import { NOTIFICATION_DRAIN_MAX_CHARS } from "./agent-notifications.js";
+import { NOTIFICATION_PREFIX, STEERING_PREFIX } from "./steering.js";
+const agentLoopMock = vi.hoisted(() => vi.fn());
+vi.mock("@kenkaiiii/gg-agent", async () => {
+    const actual = await vi.importActual("@kenkaiiii/gg-agent");
+    return { ...actual, agentLoop: agentLoopMock };
+});
+vi.mock("./mcp/index.js", async () => {
+    const actual = await vi.importActual("./mcp/index.js");
+    return {
+        ...actual,
+        MCPClientManager: vi.fn(function MCPClientManagerMock() {
+            return { connectAll: vi.fn(async () => []), dispose: vi.fn(async () => { }) };
+        }),
+    };
+});
+let restoreHome;
+let tmpHome;
+let tmpProject;
+beforeEach(async () => {
+    tmpHome = await fs.mkdtemp(path.join(os.tmpdir(), "agent-session-notify-home-"));
+    tmpProject = await fs.mkdtemp(path.join(os.tmpdir(), "agent-session-notify-project-"));
+    restoreHome = useFakeHome(tmpHome);
+    agentLoopMock.mockReset();
+    await fs.mkdir(path.join(tmpHome, ".gg"), { recursive: true });
+    await fs.writeFile(path.join(tmpHome, ".gg", "auth.json"), JSON.stringify({
+        anthropic: {
+            accessToken: "test",
+            refreshToken: "test",
+            expiresAt: Date.now() + 3_600_000,
+        },
+    }), "utf-8");
+});
+afterEach(async () => {
+    restoreHome?.();
+    await fs.rm(tmpHome, { recursive: true, force: true });
+    await fs.rm(tmpProject, { recursive: true, force: true });
+    vi.clearAllMocks();
+});
+async function makeSession() {
+    const { AgentSession } = await import("./agent-session.js");
+    const session = new AgentSession({
+        provider: "anthropic",
+        model: "claude-test",
+        cwd: tmpProject,
+        systemPrompt: "test system prompt",
+        transient: true,
+    });
+    await session.initialize();
+    const internals = session;
+    return { session, internals };
+}
+describe("AgentSession pushed notifications", () => {
+    it("injects queued notifications as one framed steering message", async () => {
+        const { session, internals } = await makeSession();
+        try {
+            internals.notifications.enqueue("subagent", "a1", 'Child agent "one" is completed.', {
+                terminal: true,
+            });
+            internals.notifications.enqueue("process", "p1", "Build exited 0.", { terminal: true });
+            const messages = internals.getHookSteeringMessages();
+            expect(messages).toHaveLength(1);
+            const content = messages[0].content;
+            expect(content.startsWith(NOTIFICATION_PREFIX)).toBe(true);
+            expect(content).toContain('Child agent "one" is completed.');
+            expect(content).toContain("Build exited 0.");
+            expect(content.length).toBeLessThanOrEqual(NOTIFICATION_PREFIX.length + NOTIFICATION_DRAIN_MAX_CHARS + 8);
+            // Consumed exactly once — a second poll must not re-inject them.
+            expect(internals.getHookSteeringMessages()).toBeNull();
+        }
+        finally {
+            await session.dispose();
+        }
+    }, 15_000);
+    it("never displaces user steering — both ride out in the same batch", async () => {
+        const { session, internals } = await makeSession();
+        try {
+            session.queueMessage("also check the tests");
+            internals.notifications.enqueue("subagent", "a1", 'Child agent "one" is completed.', {
+                terminal: true,
+            });
+            const messages = internals.getHookSteeringMessages();
+            expect(messages).toHaveLength(2);
+            // User steering first: it is an instruction, the notification is a fact.
+            expect(messages[0].content).toBe(`${STEERING_PREFIX}also check the tests`);
+            expect(messages[1].content).toContain(NOTIFICATION_PREFIX);
+            expect(session.getQueuedCount()).toBe(0);
+        }
+        finally {
+            await session.dispose();
+        }
+    }, 15_000);
+    it("returns null when nothing is pending", async () => {
+        const { session, internals } = await makeSession();
+        try {
+            expect(internals.getHookSteeringMessages()).toBeNull();
+        }
+        finally {
+            await session.dispose();
+        }
+    }, 15_000);
+});
+//# sourceMappingURL=agent-session-notifications.test.js.map

package/dist/core/agent-session-notifications.test.js.map

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