import { beforeEach, describe, expect, it, vi } from "vitest"; import { onAgentEvent } from "../../infra/agent-events.js"; import { requestHeartbeatNow } from "../../infra/heartbeat-wake.js"; import { getSessionBindingService } from "../../infra/outbound/session-binding-service.js"; import { onSessionTranscriptUpdate } from "../../sessions/transcript-events.js"; const runCommandWithTimeoutMock = vi.hoisted(() => vi.fn()); vi.mock("../../process/exec.js", () => ({ runCommandWithTimeout: (...args: unknown[]) => runCommandWithTimeoutMock(...args), })); import { createPluginRuntime } from "./index.js"; describe("plugin runtime command execution", () => { beforeEach(() => { runCommandWithTimeoutMock.mockClear(); }); it("exposes runtime.system.runCommandWithTimeout by default", async () => { const commandResult = { stdout: "hello\n", stderr: "", code: 0, signal: null, killed: false, termination: "exit" as const, }; runCommandWithTimeoutMock.mockResolvedValue(commandResult); const runtime = createPluginRuntime(); await expect( runtime.system.runCommandWithTimeout(["echo", "hello"], { timeoutMs: 1000 }), ).resolves.toEqual(commandResult); expect(runCommandWithTimeoutMock).toHaveBeenCalledWith(["echo", "hello"], { timeoutMs: 1000 }); }); it("forwards runtime.system.runCommandWithTimeout errors", async () => { runCommandWithTimeoutMock.mockRejectedValue(new Error("boom")); const runtime = createPluginRuntime(); await expect( runtime.system.runCommandWithTimeout(["echo", "hello"], { timeoutMs: 1000 }), ).rejects.toThrow("boom"); expect(runCommandWithTimeoutMock).toHaveBeenCalledWith(["echo", "hello"], { timeoutMs: 1000 }); }); it("exposes runtime.events listener registration helpers", () => { const runtime = createPluginRuntime(); expect(runtime.events.onAgentEvent).toBe(onAgentEvent); expect(runtime.events.onSessionTranscriptUpdate).toBe(onSessionTranscriptUpdate); }); it("exposes runtime.channel.bindings", () => { const runtime = createPluginRuntime(); expect(runtime.channel.bindings).toBe(getSessionBindingService()); }); it("exposes runtime.system.requestHeartbeatNow", () => { const runtime = createPluginRuntime(); expect(runtime.system.requestHeartbeatNow).toBe(requestHeartbeatNow); }); it("exposes runtime.modelAuth with getApiKeyForModel and resolveApiKeyForProvider", () => { const runtime = createPluginRuntime(); expect(runtime.modelAuth).toBeDefined(); expect(typeof runtime.modelAuth.getApiKeyForModel).toBe("function"); expect(typeof runtime.modelAuth.resolveApiKeyForProvider).toBe("function"); }); it("modelAuth wrappers strip agentDir and store to prevent credential steering", async () => { // The wrappers should not forward agentDir or store from plugin callers. // We verify this by checking the wrapper functions exist and are not the // raw implementations (they are wrapped, not direct references). const { getApiKeyForModel: rawGetApiKey } = await import("../../agents/model-auth.js"); const runtime = createPluginRuntime(); // Wrappers should NOT be the same reference as the raw functions expect(runtime.modelAuth.getApiKeyForModel).not.toBe(rawGetApiKey); }); });