@@ -0,0 +1,172 @@
1+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
2+import { mkdtempSync, rmSync } from "node:fs";
3+import { tmpdir } from "node:os";
4+import { join } from "node:path";
5+import type { FauxProviderRegistration } from "@mariozechner/pi-ai";
6+import {
7+ fauxAssistantMessage,
8+ fauxText,
9+ fauxThinking,
10+ fauxToolCall,
11+ registerFauxProvider,
12+} from "@mariozechner/pi-ai";
13+import { runHeadlessPrompt } from "./headless.ts";
14+import type { AppState } from "./index.ts";
15+import { listPromptHistory, loadMessages, openDatabase } from "./session.ts";
16+import { DEFAULT_THEME } from "./theme.ts";
17+
18+let tmp: string;
19+let faux: FauxProviderRegistration;
20+const states: AppState[] = [];
21+
22+beforeEach(() => {
23+ tmp = mkdtempSync(join(tmpdir(), "mc-headless-"));
24+ faux = registerFauxProvider();
25+});
26+
27+afterEach(() => {
28+ faux.unregister();
29+ for (const state of states.splice(0)) {
30+ state.db.close();
31+ }
32+ rmSync(tmp, { recursive: true, force: true });
33+});
34+
35+function createTestState(): AppState {
36+ const state: AppState = {
37+ db: openDatabase(":memory:"),
38+ session: null,
39+ model: faux.getModel(),
40+ effort: "medium",
41+ messages: [],
42+ stats: { totalInput: 0, totalOutput: 0, totalCost: 0 },
43+ agentsMd: [],
44+ skills: [],
45+ plugins: [],
46+ theme: DEFAULT_THEME,
47+ git: null,
48+ providers: new Map(),
49+ oauthCredentials: {},
50+ settings: {},
51+ settingsPath: join(tmp, "settings.json"),
52+ cwd: tmp,
53+ canonicalCwd: tmp,
54+ running: false,
55+ abortController: null,
56+ activeTurnPromise: null,
57+ showReasoning: true,
58+ verbose: false,
59+ };
60+ states.push(state);
61+ return state;
62+}
63+
64+function parseEventLines(lines: string[]): Array<Record<string, unknown>> {
65+ return lines.map((line) => JSON.parse(line) as Record<string, unknown>);
66+}
67+
68+describe("headless", () => {
69+ test("runHeadlessPrompt streams NDJSON events and persists the completed turn", async () => {
70+ faux.setResponses([
71+ fauxAssistantMessage([
72+ fauxThinking("Need to inspect the failing test."),
73+ fauxText("Done."),
74+ ]),
75+ ]);
76+ const state = createTestState();
77+ const lines: string[] = [];
78+
79+ const stopReason = await runHeadlessPrompt(state, "fix the tests", {
80+ writeLine: (line) => {
81+ lines.push(line);
82+ },
83+ });
84+
85+ const events = parseEventLines(lines);
86+ expect(stopReason).toBe("stop");
87+ expect(events.some((event) => event.type === "thinking_delta")).toBe(true);
88+ expect(events.some((event) => event.type === "assistant_message")).toBe(
89+ true,
90+ );
91+ expect(events.at(-1)?.type).toBe("done");
92+
93+ const sessionId = state.session?.id;
94+ if (!sessionId) {
95+ throw new Error("Expected a session to be created");
96+ }
97+
98+ expect(
99+ loadMessages(state.db, sessionId).map((message) => message.role),
100+ ).toEqual(["user", "assistant"]);
101+ expect(listPromptHistory(state.db, 1)[0]?.text).toBe("fix the tests");
102+ });
103+
104+ test("runHeadlessPrompt rejects slash commands before creating a session", async () => {
105+ const state = createTestState();
106+ const lines: string[] = [];
107+
108+ await expect(
109+ runHeadlessPrompt(state, "/help", {
110+ writeLine: (line) => {
111+ lines.push(line);
112+ },
113+ }),
114+ ).rejects.toThrow("Headless mode does not support slash commands: /help");
115+
116+ expect(lines).toEqual([]);
117+ expect(state.session).toBeNull();
118+ expect(listPromptHistory(state.db, 1)).toEqual([]);
119+ });
120+
121+ test("runHeadlessPrompt streams tool execution events for tool-use turns", async () => {
122+ faux.setResponses([
123+ fauxAssistantMessage(
124+ [fauxToolCall("shell", { command: "printf tool-output" })],
125+ { stopReason: "toolUse" },
126+ ),
127+ fauxAssistantMessage("Done."),
128+ ]);
129+ const state = createTestState();
130+ const lines: string[] = [];
131+
132+ const stopReason = await runHeadlessPrompt(state, "run the shell command", {
133+ writeLine: (line) => {
134+ lines.push(line);
135+ },
136+ });
137+
138+ const events = parseEventLines(lines);
139+ expect(stopReason).toBe("stop");
140+ expect(events.some((event) => event.type === "tool_start")).toBe(true);
141+ expect(events.some((event) => event.type === "tool_delta")).toBe(true);
142+ expect(events.some((event) => event.type === "tool_end")).toBe(true);
143+ expect(events.some((event) => event.type === "tool_result")).toBe(true);
144+
145+ const sessionId = state.session?.id;
146+ if (!sessionId) {
147+ throw new Error("Expected a session to be created");
148+ }
149+
150+ expect(
151+ loadMessages(state.db, sessionId).map((message) => message.role),
152+ ).toEqual(["user", "assistant", "toolResult", "assistant"]);
153+ });
154+
155+ test("runHeadlessPrompt treats broken stdout pipes as a quiet shutdown", async () => {
156+ faux.setResponses([fauxAssistantMessage("Done.")]);
157+ const state = createTestState();
158+ const brokenPipe = Object.assign(new Error("broken pipe"), {
159+ code: "EPIPE",
160+ });
161+
162+ const stopReason = await runHeadlessPrompt(state, "reply once", {
163+ writeLine: () => {
164+ throw brokenPipe;
165+ },
166+ });
167+
168+ expect(stopReason).toBe("stop");
169+ expect(state.running).toBe(false);
170+ expect(state.abortController).toBeNull();
171+ });
172+});