@ai-devkit/agent-manager 0.32.0 → 0.33.1

package/dist/__tests__/runtime/HerdrAgentDiscovery.test.js

@@ -0,0 +1,164 @@
+import { extractHerdrAgentPanes, fetchHerdrAgentPanes, findMatchingHerdrPane } from "../../runtime/herdr/HerdrAgentDiscovery.js";
+function jsonResponse(value) {
+    return {
+        stdout: JSON.stringify(value),
+        stderr: ""
+    };
+}
+describe("HerdrAgentDiscovery", ()=>{
+    it("extracts agent panes from pane list responses", ()=>{
+        const panes = extractHerdrAgentPanes({
+            result: {
+                panes: [
+                    {
+                        agent: "codex",
+                        agent_session: {
+                            value: "session-1"
+                        },
+                        cwd: "/repo",
+                        pane_id: "w32:p1",
+                        workspace_id: "w32",
+                        tab_id: "w32:t1"
+                    }
+                ]
+            }
+        });
+        expect(panes).toEqual([
+            {
+                agent: "codex",
+                agentSessionId: "session-1",
+                cwd: "/repo",
+                paneId: "w32:p1",
+                workspaceId: "w32",
+                tabId: "w32:t1"
+            }
+        ]);
+    });
+    it("matches by foreground PID before falling back to ambiguous cwd and type", ()=>{
+        const pane = findMatchingHerdrPane({
+            type: "codex",
+            projectPath: "/repo",
+            sessionId: "pid-64904",
+            pid: 64904
+        }, [
+            {
+                agent: "codex",
+                cwd: "/repo",
+                paneId: "w31:p1",
+                foregroundPids: [
+                    44290
+                ]
+            },
+            {
+                agent: "codex",
+                cwd: "/repo",
+                paneId: "w32:p1",
+                foregroundPids: [
+                    64904
+                ]
+            }
+        ]);
+        expect(pane?.paneId).toBe("w32:p1");
+    });
+    it("prefers a foreground PID match over a shell PID match", ()=>{
+        const pane = findMatchingHerdrPane({
+            type: "codex",
+            projectPath: "/repo",
+            sessionId: "pid-64904",
+            pid: 64904
+        }, [
+            {
+                agent: "codex",
+                cwd: "/repo",
+                paneId: "w31:p1",
+                shellPid: 64904
+            },
+            {
+                agent: "codex",
+                cwd: "/repo",
+                paneId: "w32:p1",
+                foregroundPids: [
+                    64904
+                ]
+            }
+        ]);
+        expect(pane?.paneId).toBe("w32:p1");
+    });
+    it("enriches pane list output with foreground process IDs", async ()=>{
+        const runner = vi.fn().mockResolvedValueOnce(jsonResponse({
+            result: {
+                panes: [
+                    {
+                        agent: "codex",
+                        cwd: "/repo",
+                        pane_id: "w31:p1"
+                    },
+                    {
+                        agent: "codex",
+                        cwd: "/repo",
+                        pane_id: "w32:p1"
+                    }
+                ]
+            }
+        })).mockResolvedValueOnce(jsonResponse({
+            result: {
+                process_info: {
+                    pane_id: "w31:p1",
+                    shell_pid: 111,
+                    foreground_processes: [
+                        {
+                            pid: 44290
+                        }
+                    ]
+                }
+            }
+        })).mockResolvedValueOnce(jsonResponse({
+            result: {
+                process_info: {
+                    pane_id: "w32:p1",
+                    shell_pid: 222,
+                    foreground_processes: [
+                        {
+                            pid: 64904
+                        }
+                    ]
+                }
+            }
+        }));
+        const panes = await fetchHerdrAgentPanes(runner);
+        expect(runner).toHaveBeenNthCalledWith(1, "herdr", [
+            "pane",
+            "list"
+        ]);
+        expect(runner).toHaveBeenNthCalledWith(2, "herdr", [
+            "pane",
+            "process-info",
+            "--pane",
+            "w31:p1"
+        ]);
+        expect(runner).toHaveBeenNthCalledWith(3, "herdr", [
+            "pane",
+            "process-info",
+            "--pane",
+            "w32:p1"
+        ]);
+        expect(panes).toMatchObject([
+            {
+                paneId: "w31:p1",
+                foregroundPids: [
+                    44290
+                ],
+                shellPid: 111
+            },
+            {
+                paneId: "w32:p1",
+                foregroundPids: [
+                    64904
+                ],
+                shellPid: 222
+            }
+        ]);
+    });
+});
+
+//# sourceMappingURL=HerdrAgentDiscovery.test.js.map

package/dist/__tests__/runtime/HerdrAgentDiscovery.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/__tests__/runtime/HerdrAgentDiscovery.test.ts"],"sourcesContent":["import {\n  extractHerdrAgentPanes,\n  fetchHerdrAgentPanes,\n  findMatchingHerdrPane,\n} from \"../../runtime/herdr/HerdrAgentDiscovery.js\";\nimport type { HerdrCommandRunner } from \"../../runtime/herdr/HerdrCliClient.js\";\n\nfunction jsonResponse(value: unknown): { stdout: string; stderr: string } {\n  return { stdout: JSON.stringify(value), stderr: \"\" };\n}\n\ndescribe(\"HerdrAgentDiscovery\", () => {\n  it(\"extracts agent panes from pane list responses\", () => {\n    const panes = extractHerdrAgentPanes({\n      result: {\n        panes: [\n          {\n            agent: \"codex\",\n            agent_session: { value: \"session-1\" },\n            cwd: \"/repo\",\n            pane_id: \"w32:p1\",\n            workspace_id: \"w32\",\n            tab_id: \"w32:t1\",\n          },\n        ],\n      },\n    });\n\n    expect(panes).toEqual([\n      {\n        agent: \"codex\",\n        agentSessionId: \"session-1\",\n        cwd: \"/repo\",\n        paneId: \"w32:p1\",\n        workspaceId: \"w32\",\n        tabId: \"w32:t1\",\n      },\n    ]);\n  });\n\n  it(\"matches by foreground PID before falling back to ambiguous cwd and type\", () => {\n    const pane = findMatchingHerdrPane(\n      {\n        type: \"codex\",\n        projectPath: \"/repo\",\n        sessionId: \"pid-64904\",\n        pid: 64904,\n      },\n      [\n        { agent: \"codex\", cwd: \"/repo\", paneId: \"w31:p1\", foregroundPids: [44290] },\n        { agent: \"codex\", cwd: \"/repo\", paneId: \"w32:p1\", foregroundPids: [64904] },\n      ],\n    );\n\n    expect(pane?.paneId).toBe(\"w32:p1\");\n  });\n\n  it(\"prefers a foreground PID match over a shell PID match\", () => {\n    const pane = findMatchingHerdrPane(\n      {\n        type: \"codex\",\n        projectPath: \"/repo\",\n        sessionId: \"pid-64904\",\n        pid: 64904,\n      },\n      [\n        { agent: \"codex\", cwd: \"/repo\", paneId: \"w31:p1\", shellPid: 64904 },\n        { agent: \"codex\", cwd: \"/repo\", paneId: \"w32:p1\", foregroundPids: [64904] },\n      ],\n    );\n\n    expect(pane?.paneId).toBe(\"w32:p1\");\n  });\n\n  it(\"enriches pane list output with foreground process IDs\", async () => {\n    const runner = vi\n      .fn<HerdrCommandRunner>()\n      .mockResolvedValueOnce(\n        jsonResponse({\n          result: {\n            panes: [\n              { agent: \"codex\", cwd: \"/repo\", pane_id: \"w31:p1\" },\n              { agent: \"codex\", cwd: \"/repo\", pane_id: \"w32:p1\" },\n            ],\n          },\n        }),\n      )\n      .mockResolvedValueOnce(\n        jsonResponse({\n          result: {\n            process_info: {\n              pane_id: \"w31:p1\",\n              shell_pid: 111,\n              foreground_processes: [{ pid: 44290 }],\n            },\n          },\n        }),\n      )\n      .mockResolvedValueOnce(\n        jsonResponse({\n          result: {\n            process_info: {\n              pane_id: \"w32:p1\",\n              shell_pid: 222,\n              foreground_processes: [{ pid: 64904 }],\n            },\n          },\n        }),\n      );\n\n    const panes = await fetchHerdrAgentPanes(runner);\n\n    expect(runner).toHaveBeenNthCalledWith(1, \"herdr\", [\"pane\", \"list\"]);\n    expect(runner).toHaveBeenNthCalledWith(2, \"herdr\", [\n      \"pane\",\n      \"process-info\",\n      \"--pane\",\n      \"w31:p1\",\n    ]);\n    expect(runner).toHaveBeenNthCalledWith(3, \"herdr\", [\n      \"pane\",\n      \"process-info\",\n      \"--pane\",\n      \"w32:p1\",\n    ]);\n    expect(panes).toMatchObject([\n      { paneId: \"w31:p1\", foregroundPids: [44290], shellPid: 111 },\n      { paneId: \"w32:p1\", foregroundPids: [64904], shellPid: 222 },\n    ]);\n  });\n});\n"],"names":["extractHerdrAgentPanes","fetchHerdrAgentPanes","findMatchingHerdrPane","jsonResponse","value","stdout","JSON","stringify","stderr","describe","it","panes","result","agent","agent_session","cwd","pane_id","workspace_id","tab_id","expect","toEqual","agentSessionId","paneId","workspaceId","tabId","pane","type","projectPath","sessionId","pid","foregroundPids","toBe","shellPid","runner","vi","fn","mockResolvedValueOnce","process_info","shell_pid","foreground_processes","toHaveBeenNthCalledWith","toMatchObject"],"mappings":"AAAA,SACEA,sBAAsB,EACtBC,oBAAoB,EACpBC,qBAAqB,QAChB,6CAA6C;AAGpD,SAASC,aAAaC,KAAc;IAClC,OAAO;QAAEC,QAAQC,KAAKC,SAAS,CAACH;QAAQI,QAAQ;IAAG;AACrD;AAEAC,SAAS,uBAAuB;IAC9BC,GAAG,iDAAiD;QAClD,MAAMC,QAAQX,uBAAuB;YACnCY,QAAQ;gBACND,OAAO;oBACL;wBACEE,OAAO;wBACPC,eAAe;4BAAEV,OAAO;wBAAY;wBACpCW,KAAK;wBACLC,SAAS;wBACTC,cAAc;wBACdC,QAAQ;oBACV;iBACD;YACH;QACF;QAEAC,OAAOR,OAAOS,OAAO,CAAC;YACpB;gBACEP,OAAO;gBACPQ,gBAAgB;gBAChBN,KAAK;gBACLO,QAAQ;gBACRC,aAAa;gBACbC,OAAO;YACT;SACD;IACH;IAEAd,GAAG,2EAA2E;QAC5E,MAAMe,OAAOvB,sBACX;YACEwB,MAAM;YACNC,aAAa;YACbC,WAAW;YACXC,KAAK;QACP,GACA;YACE;gBAAEhB,OAAO;gBAASE,KAAK;gBAASO,QAAQ;gBAAUQ,gBAAgB;oBAAC;iBAAM;YAAC;YAC1E;gBAAEjB,OAAO;gBAASE,KAAK;gBAASO,QAAQ;gBAAUQ,gBAAgB;oBAAC;iBAAM;YAAC;SAC3E;QAGHX,OAAOM,MAAMH,QAAQS,IAAI,CAAC;IAC5B;IAEArB,GAAG,yDAAyD;QAC1D,MAAMe,OAAOvB,sBACX;YACEwB,MAAM;YACNC,aAAa;YACbC,WAAW;YACXC,KAAK;QACP,GACA;YACE;gBAAEhB,OAAO;gBAASE,KAAK;gBAASO,QAAQ;gBAAUU,UAAU;YAAM;YAClE;gBAAEnB,OAAO;gBAASE,KAAK;gBAASO,QAAQ;gBAAUQ,gBAAgB;oBAAC;iBAAM;YAAC;SAC3E;QAGHX,OAAOM,MAAMH,QAAQS,IAAI,CAAC;IAC5B;IAEArB,GAAG,yDAAyD;QAC1D,MAAMuB,SAASC,GACZC,EAAE,GACFC,qBAAqB,CACpBjC,aAAa;YACXS,QAAQ;gBACND,OAAO;oBACL;wBAAEE,OAAO;wBAASE,KAAK;wBAASC,SAAS;oBAAS;oBAClD;wBAAEH,OAAO;wBAASE,KAAK;wBAASC,SAAS;oBAAS;iBACnD;YACH;QACF,IAEDoB,qBAAqB,CACpBjC,aAAa;YACXS,QAAQ;gBACNyB,cAAc;oBACZrB,SAAS;oBACTsB,WAAW;oBACXC,sBAAsB;wBAAC;4BAAEV,KAAK;wBAAM;qBAAE;gBACxC;YACF;QACF,IAEDO,qBAAqB,CACpBjC,aAAa;YACXS,QAAQ;gBACNyB,cAAc;oBACZrB,SAAS;oBACTsB,WAAW;oBACXC,sBAAsB;wBAAC;4BAAEV,KAAK;wBAAM;qBAAE;gBACxC;YACF;QACF;QAGJ,MAAMlB,QAAQ,MAAMV,qBAAqBgC;QAEzCd,OAAOc,QAAQO,uBAAuB,CAAC,GAAG,SAAS;YAAC;YAAQ;SAAO;QACnErB,OAAOc,QAAQO,uBAAuB,CAAC,GAAG,SAAS;YACjD;YACA;YACA;YACA;SACD;QACDrB,OAAOc,QAAQO,uBAAuB,CAAC,GAAG,SAAS;YACjD;YACA;YACA;YACA;SACD;QACDrB,OAAOR,OAAO8B,aAAa,CAAC;YAC1B;gBAAEnB,QAAQ;gBAAUQ,gBAAgB;oBAAC;iBAAM;gBAAEE,UAAU;YAAI;YAC3D;gBAAEV,QAAQ;gBAAUQ,gBAAgB;oBAAC;iBAAM;gBAAEE,UAAU;YAAI;SAC5D;IACH;AACF"}

package/dist/__tests__/runtime/HerdrAgentRuntime.test.js

@@ -0,0 +1,488 @@
+import { HerdrAgentRuntime } from "../../runtime/herdr/HerdrAgentRuntime.js";
+import { HerdrRuntimeError } from "../../runtime/herdr/HerdrErrors.js";
+function createRunner(responses = []) {
+    const runner = vi.fn(async ()=>{
+        const response = responses.shift();
+        if (!response) return {
+            stdout: "{}",
+            stderr: ""
+        };
+        if (response.reject) throw response.reject;
+        return {
+            stdout: response.stdout ?? "",
+            stderr: response.stderr ?? ""
+        };
+    });
+    return runner;
+}
+function herdrCliError(response) {
+    return Object.assign(new Error("herdr command failed"), {
+        stdout: JSON.stringify(response),
+        stderr: "",
+        code: 1
+    });
+}
+function jsonResponse(value) {
+    return {
+        stdout: JSON.stringify(value)
+    };
+}
+function workspaceResponse(workspaceId = "w1", paneId = "w1:p1") {
+    return jsonResponse({
+        result: {
+            type: "workspace_info",
+            workspace: {
+                workspace_id: workspaceId
+            },
+            root_pane: {
+                pane_id: paneId
+            }
+        }
+    });
+}
+function agentResponse({ name = "reviewer", paneId = "w1:p1", workspaceId, tabId } = {}) {
+    return jsonResponse({
+        result: {
+            type: "agent_info",
+            agent: {
+                name,
+                agent: "codex",
+                pane_id: paneId,
+                ...workspaceId ? {
+                    workspace_id: workspaceId
+                } : {},
+                ...tabId ? {
+                    tab_id: tabId
+                } : {}
+            }
+        }
+    });
+}
+function processInfoResponse({ paneId = "w1:p1", pid, shellPid, processName } = {}) {
+    return jsonResponse({
+        result: {
+            type: "pane_process_info",
+            process_info: {
+                pane_id: paneId,
+                ...shellPid ? {
+                    shell_pid: shellPid
+                } : {},
+                foreground_processes: pid ? [
+                    {
+                        pid,
+                        ...processName ? {
+                            name: processName
+                        } : {}
+                    }
+                ] : []
+            }
+        }
+    });
+}
+const startInput = {
+    name: "reviewer",
+    cwd: "/repo",
+    kind: "codex",
+    args: [],
+    timeoutMs: 15000
+};
+describe("HerdrAgentRuntime", ()=>{
+    it("reports unavailable when the herdr binary is missing", async ()=>{
+        const runner = createRunner([
+            {
+                reject: Object.assign(new Error("not found"), {
+                    code: "ENOENT"
+                })
+            }
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {}
+        });
+        await expect(runtime.isAvailable()).resolves.toEqual({
+            ok: false,
+            reason: "binary-missing",
+            detail: "herdr command was not found in PATH."
+        });
+    });
+    it("reports available outside Herdr when binary and snapshot work", async ()=>{
+        const runner = createRunner([
+            {
+                stdout: "herdr 0.8.2\n"
+            },
+            jsonResponse({
+                id: "cli:api:snapshot",
+                result: {
+                    type: "session_snapshot"
+                }
+            })
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {}
+        });
+        await expect(runtime.isAvailable()).resolves.toEqual({
+            ok: true,
+            insideRuntime: false
+        });
+        expect(runner).toHaveBeenNthCalledWith(1, "herdr", [
+            "--version"
+        ]);
+        expect(runner).toHaveBeenNthCalledWith(2, "herdr", [
+            "api",
+            "snapshot"
+        ]);
+    });
+    it("includes Herdr environment context when present", async ()=>{
+        const runner = createRunner([
+            {
+                stdout: "herdr 0.8.2\n"
+            },
+            jsonResponse({
+                id: "cli:api:snapshot",
+                result: {
+                    type: "session_snapshot"
+                }
+            })
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {
+                HERDR_ENV: "1",
+                HERDR_PANE_ID: "w1:p1"
+            }
+        });
+        await expect(runtime.isAvailable()).resolves.toEqual({
+            ok: true,
+            insideRuntime: true,
+            currentPaneId: "w1:p1"
+        });
+    });
+    it("creates a workspace, starts the named agent, and returns an opaque Herdr ref", async ()=>{
+        const runner = createRunner([
+            workspaceResponse(),
+            agentResponse({
+                workspaceId: "w1",
+                tabId: "w1:t1"
+            }),
+            processInfoResponse({
+                shellPid: 12000,
+                pid: 12345,
+                processName: "codex"
+            })
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {}
+        });
+        const result = await runtime.startAgent(startInput);
+        expect(runner).toHaveBeenNthCalledWith(1, "herdr", [
+            "workspace",
+            "create",
+            "--cwd",
+            "/repo",
+            "--label",
+            "reviewer"
+        ]);
+        expect(runner).toHaveBeenNthCalledWith(2, "herdr", [
+            "agent",
+            "start",
+            "reviewer",
+            "--kind",
+            "codex",
+            "--pane",
+            "w1:p1",
+            "--timeout",
+            "15000"
+        ]);
+        expect(runner).toHaveBeenNthCalledWith(3, "herdr", [
+            "pane",
+            "process-info",
+            "--pane",
+            "w1:p1"
+        ]);
+        expect(result).toEqual({
+            pid: 12345,
+            runtimeRef: {
+                session: "default",
+                workspaceId: "w1",
+                tabId: "w1:t1",
+                paneId: "w1:p1",
+                agentName: "reviewer"
+            }
+        });
+    });
+    it("falls back to the pane shell pid when no foreground process pid is reported", async ()=>{
+        const runner = createRunner([
+            workspaceResponse(),
+            agentResponse(),
+            processInfoResponse({
+                shellPid: 12000
+            })
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {},
+            processInfoPollMs: 0
+        });
+        await expect(runtime.startAgent(startInput)).resolves.toMatchObject({
+            pid: 12000
+        });
+    });
+    it("waits for a foreground process pid before falling back to the pane shell pid", async ()=>{
+        const runner = createRunner([
+            workspaceResponse(),
+            agentResponse(),
+            processInfoResponse({
+                shellPid: 12000
+            }),
+            processInfoResponse({
+                shellPid: 12000,
+                pid: 12345,
+                processName: "node"
+            })
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {},
+            processInfoPollMs: 100,
+            processInfoPollIntervalMs: 0
+        });
+        await expect(runtime.startAgent(startInput)).resolves.toMatchObject({
+            pid: 12345
+        });
+        expect(runner).toHaveBeenNthCalledWith(3, "herdr", [
+            "pane",
+            "process-info",
+            "--pane",
+            "w1:p1"
+        ]);
+        expect(runner).toHaveBeenNthCalledWith(4, "herdr", [
+            "pane",
+            "process-info",
+            "--pane",
+            "w1:p1"
+        ]);
+    });
+    it("passes only explicit extra agent args after the Herdr start separator", async ()=>{
+        const runner = createRunner([
+            workspaceResponse(),
+            agentResponse(),
+            processInfoResponse({
+                pid: 12345
+            })
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {}
+        });
+        await runtime.startAgent({
+            ...startInput,
+            args: [
+                "--model",
+                "gpt-5-codex"
+            ]
+        });
+        expect(runner).toHaveBeenNthCalledWith(2, "herdr", [
+            "agent",
+            "start",
+            "reviewer",
+            "--kind",
+            "codex",
+            "--pane",
+            "w1:p1",
+            "--timeout",
+            "15000",
+            "--",
+            "--model",
+            "gpt-5-codex"
+        ]);
+    });
+    it("retries agent start when a freshly-created Herdr pane is temporarily busy", async ()=>{
+        const runner = createRunner([
+            workspaceResponse("w15", "w15:p1"),
+            {
+                reject: herdrCliError({
+                    error: {
+                        code: "agent_pane_busy",
+                        message: "agent target pane w15:p1 is not an available shell"
+                    },
+                    id: "cli:agent:start"
+                })
+            },
+            agentResponse({
+                paneId: "w15:p1",
+                workspaceId: "w15",
+                tabId: "w15:t1"
+            }),
+            processInfoResponse({
+                paneId: "w15:p1",
+                pid: 12345
+            })
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {},
+            agentStartBusyRetryMs: 100,
+            agentStartBusyRetryIntervalMs: 0
+        });
+        await expect(runtime.startAgent(startInput)).resolves.toMatchObject({
+            runtimeRef: {
+                workspaceId: "w15",
+                paneId: "w15:p1"
+            }
+        });
+        expect(runner).toHaveBeenNthCalledWith(2, "herdr", [
+            "agent",
+            "start",
+            "reviewer",
+            "--kind",
+            "codex",
+            "--pane",
+            "w15:p1",
+            "--timeout",
+            "15000"
+        ]);
+        expect(runner).toHaveBeenNthCalledWith(3, "herdr", [
+            "agent",
+            "start",
+            "reviewer",
+            "--kind",
+            "codex",
+            "--pane",
+            "w15:p1",
+            "--timeout",
+            "15000"
+        ]);
+    });
+    it("surfaces non-retryable Herdr agent start errors without retrying", async ()=>{
+        const runner = createRunner([
+            workspaceResponse(),
+            {
+                reject: herdrCliError({
+                    error: {
+                        code: "duplicate_agent_name",
+                        message: "agent name reviewer already exists"
+                    },
+                    id: "cli:agent:start"
+                })
+            }
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {}
+        });
+        await expect(runtime.startAgent(startInput)).rejects.toMatchObject({
+            code: "duplicate_agent_name",
+            message: "agent name reviewer already exists"
+        });
+        expect(runner).toHaveBeenCalledTimes(2);
+    });
+    it("rejects start responses when Herdr process info does not include a pid", async ()=>{
+        const runner = createRunner([
+            workspaceResponse(),
+            agentResponse(),
+            processInfoResponse()
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {}
+        });
+        await expect(runtime.startAgent(startInput)).rejects.toThrow(new HerdrRuntimeError("Herdr pane process-info response did not include process pid."));
+    });
+    it("rejects start responses that do not include a pane id", async ()=>{
+        const runner = createRunner([
+            {
+                stdout: '{"result":{"workspace":{"workspace_id":"w1"}}}'
+            }
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {}
+        });
+        await expect(runtime.startAgent(startInput)).rejects.toThrow(new HerdrRuntimeError("Herdr workspace create response did not include root pane id."));
+    });
+    it("sends, waits, reads, focuses, and stops by Herdr pane ref", async ()=>{
+        const runner = createRunner([
+            {
+                stdout: "{}"
+            },
+            {
+                stdout: '{"result":{"agent":{"agent_status":"done"}}}'
+            },
+            {
+                stdout: "done\n"
+            },
+            {
+                stdout: "{}"
+            },
+            {
+                stdout: "{}"
+            }
+        ]);
+        const runtime = new HerdrAgentRuntime({
+            runner,
+            env: {}
+        });
+        const runtimeRef = {
+            paneId: "w1:p2",
+            agentName: "reviewer"
+        };
+        await runtime.send({
+            runtimeRef,
+            prompt: "continue"
+        });
+        await runtime.wait({
+            runtimeRef,
+            timeoutMs: 2000
+        });
+        await expect(runtime.readOutput({
+            runtimeRef,
+            lines: 80
+        })).resolves.toBe("done\n");
+        await expect(runtime.focus({
+            runtimeRef
+        })).resolves.toBe(true);
+        await runtime.stop({
+            runtimeRef
+        });
+        expect(runner).toHaveBeenNthCalledWith(1, "herdr", [
+            "agent",
+            "prompt",
+            "w1:p2",
+            "continue"
+        ]);
+        expect(runner).toHaveBeenNthCalledWith(2, "herdr", [
+            "agent",
+            "wait",
+            "w1:p2",
+            "--until",
+            "done",
+            "--until",
+            "blocked",
+            "--timeout",
+            "2000"
+        ]);
+        expect(runner).toHaveBeenNthCalledWith(3, "herdr", [
+            "agent",
+            "read",
+            "w1:p2",
+            "--source",
+            "recent-unwrapped",
+            "--lines",
+            "80"
+        ]);
+        expect(runner).toHaveBeenNthCalledWith(4, "herdr", [
+            "agent",
+            "focus",
+            "w1:p2"
+        ]);
+        expect(runner).toHaveBeenNthCalledWith(5, "herdr", [
+            "pane",
+            "close",
+            "w1:p2"
+        ]);
+    });
+});
+
+//# sourceMappingURL=HerdrAgentRuntime.test.js.map