@tickernelz/wardmote-adapter-omp-local 0.0.0 → 2026.1108.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (200) hide show
  1. package/LICENSE +22 -0
  2. package/dist/cli/format-event.d.ts +2 -0
  3. package/dist/cli/format-event.d.ts.map +1 -0
  4. package/dist/cli/format-event.js +56 -0
  5. package/dist/cli/format-event.js.map +1 -0
  6. package/dist/cli/index.d.ts +2 -0
  7. package/dist/cli/index.d.ts.map +1 -0
  8. package/dist/cli/index.js +2 -0
  9. package/dist/cli/index.js.map +1 -0
  10. package/dist/index.d.ts +2 -0
  11. package/dist/index.d.ts.map +1 -0
  12. package/dist/index.js +2 -0
  13. package/dist/index.js.map +1 -0
  14. package/dist/metadata.d.ts +9 -0
  15. package/dist/metadata.d.ts.map +1 -0
  16. package/dist/metadata.js +47 -0
  17. package/dist/metadata.js.map +1 -0
  18. package/dist/server/config.d.ts +25 -0
  19. package/dist/server/config.d.ts.map +1 -0
  20. package/dist/server/config.js +720 -0
  21. package/dist/server/config.js.map +1 -0
  22. package/dist/server/config.test.d.ts +2 -0
  23. package/dist/server/config.test.d.ts.map +1 -0
  24. package/dist/server/config.test.js +65 -0
  25. package/dist/server/config.test.js.map +1 -0
  26. package/dist/server/execute.choices.test.d.ts +2 -0
  27. package/dist/server/execute.choices.test.d.ts.map +1 -0
  28. package/dist/server/execute.choices.test.js +113 -0
  29. package/dist/server/execute.choices.test.js.map +1 -0
  30. package/dist/server/execute.cwd.test.d.ts +2 -0
  31. package/dist/server/execute.cwd.test.d.ts.map +1 -0
  32. package/dist/server/execute.cwd.test.js +88 -0
  33. package/dist/server/execute.cwd.test.js.map +1 -0
  34. package/dist/server/execute.d.ts +27 -0
  35. package/dist/server/execute.d.ts.map +1 -0
  36. package/dist/server/execute.js +1155 -0
  37. package/dist/server/execute.js.map +1 -0
  38. package/dist/server/execute.mcp.test.d.ts +2 -0
  39. package/dist/server/execute.mcp.test.d.ts.map +1 -0
  40. package/dist/server/execute.mcp.test.js +512 -0
  41. package/dist/server/execute.mcp.test.js.map +1 -0
  42. package/dist/server/execute.model-override.test.d.ts +2 -0
  43. package/dist/server/execute.model-override.test.d.ts.map +1 -0
  44. package/dist/server/execute.model-override.test.js +115 -0
  45. package/dist/server/execute.model-override.test.js.map +1 -0
  46. package/dist/server/execute.provider-stop.test.d.ts +2 -0
  47. package/dist/server/execute.provider-stop.test.d.ts.map +1 -0
  48. package/dist/server/execute.provider-stop.test.js +96 -0
  49. package/dist/server/execute.provider-stop.test.js.map +1 -0
  50. package/dist/server/execute.python-env.remote.test.d.ts +2 -0
  51. package/dist/server/execute.python-env.remote.test.d.ts.map +1 -0
  52. package/dist/server/execute.python-env.remote.test.js +102 -0
  53. package/dist/server/execute.python-env.remote.test.js.map +1 -0
  54. package/dist/server/execute.thinking.test.d.ts +2 -0
  55. package/dist/server/execute.thinking.test.d.ts.map +1 -0
  56. package/dist/server/execute.thinking.test.js +23 -0
  57. package/dist/server/execute.thinking.test.js.map +1 -0
  58. package/dist/server/execute.toggles.test.d.ts +2 -0
  59. package/dist/server/execute.toggles.test.d.ts.map +1 -0
  60. package/dist/server/execute.toggles.test.js +193 -0
  61. package/dist/server/execute.toggles.test.js.map +1 -0
  62. package/dist/server/execute.transport.test.d.ts +2 -0
  63. package/dist/server/execute.transport.test.d.ts.map +1 -0
  64. package/dist/server/execute.transport.test.js +159 -0
  65. package/dist/server/execute.transport.test.js.map +1 -0
  66. package/dist/server/execute.usage-checkpoint.test.d.ts +2 -0
  67. package/dist/server/execute.usage-checkpoint.test.d.ts.map +1 -0
  68. package/dist/server/execute.usage-checkpoint.test.js +92 -0
  69. package/dist/server/execute.usage-checkpoint.test.js.map +1 -0
  70. package/dist/server/failure.d.ts +22 -0
  71. package/dist/server/failure.d.ts.map +1 -0
  72. package/dist/server/failure.js +99 -0
  73. package/dist/server/failure.js.map +1 -0
  74. package/dist/server/failure.test.d.ts +2 -0
  75. package/dist/server/failure.test.d.ts.map +1 -0
  76. package/dist/server/failure.test.js +37 -0
  77. package/dist/server/failure.test.js.map +1 -0
  78. package/dist/server/index.d.ts +7 -0
  79. package/dist/server/index.d.ts.map +1 -0
  80. package/dist/server/index.js +101 -0
  81. package/dist/server/index.js.map +1 -0
  82. package/dist/server/model-fallback.d.ts +34 -0
  83. package/dist/server/model-fallback.d.ts.map +1 -0
  84. package/dist/server/model-fallback.js +115 -0
  85. package/dist/server/model-fallback.js.map +1 -0
  86. package/dist/server/model-fallback.test.d.ts +2 -0
  87. package/dist/server/model-fallback.test.d.ts.map +1 -0
  88. package/dist/server/model-fallback.test.js +44 -0
  89. package/dist/server/model-fallback.test.js.map +1 -0
  90. package/dist/server/models.d.ts +19 -0
  91. package/dist/server/models.d.ts.map +1 -0
  92. package/dist/server/models.js +225 -0
  93. package/dist/server/models.js.map +1 -0
  94. package/dist/server/paperclip-mcp.d.ts +53 -0
  95. package/dist/server/paperclip-mcp.d.ts.map +1 -0
  96. package/dist/server/paperclip-mcp.js +245 -0
  97. package/dist/server/paperclip-mcp.js.map +1 -0
  98. package/dist/server/parse.d.ts +45 -0
  99. package/dist/server/parse.d.ts.map +1 -0
  100. package/dist/server/parse.js +510 -0
  101. package/dist/server/parse.js.map +1 -0
  102. package/dist/server/parse.test.d.ts +2 -0
  103. package/dist/server/parse.test.d.ts.map +1 -0
  104. package/dist/server/parse.test.js +108 -0
  105. package/dist/server/parse.test.js.map +1 -0
  106. package/dist/server/profile.d.ts +7 -0
  107. package/dist/server/profile.d.ts.map +1 -0
  108. package/dist/server/profile.js +40 -0
  109. package/dist/server/profile.js.map +1 -0
  110. package/dist/server/progress.d.ts +16 -0
  111. package/dist/server/progress.d.ts.map +1 -0
  112. package/dist/server/progress.js +235 -0
  113. package/dist/server/progress.js.map +1 -0
  114. package/dist/server/progress.todo.test.d.ts +2 -0
  115. package/dist/server/progress.todo.test.d.ts.map +1 -0
  116. package/dist/server/progress.todo.test.js +112 -0
  117. package/dist/server/progress.todo.test.js.map +1 -0
  118. package/dist/server/python-env.d.ts +28 -0
  119. package/dist/server/python-env.d.ts.map +1 -0
  120. package/dist/server/python-env.js +153 -0
  121. package/dist/server/python-env.js.map +1 -0
  122. package/dist/server/python-env.test.d.ts +2 -0
  123. package/dist/server/python-env.test.d.ts.map +1 -0
  124. package/dist/server/python-env.test.js +202 -0
  125. package/dist/server/python-env.test.js.map +1 -0
  126. package/dist/server/quota.d.ts +4 -0
  127. package/dist/server/quota.d.ts.map +1 -0
  128. package/dist/server/quota.js +129 -0
  129. package/dist/server/quota.js.map +1 -0
  130. package/dist/server/readiness.d.ts +35 -0
  131. package/dist/server/readiness.d.ts.map +1 -0
  132. package/dist/server/readiness.js +196 -0
  133. package/dist/server/readiness.js.map +1 -0
  134. package/dist/server/readiness.test.d.ts +2 -0
  135. package/dist/server/readiness.test.d.ts.map +1 -0
  136. package/dist/server/readiness.test.js +105 -0
  137. package/dist/server/readiness.test.js.map +1 -0
  138. package/dist/server/redaction-repair.d.ts +5 -0
  139. package/dist/server/redaction-repair.d.ts.map +1 -0
  140. package/dist/server/redaction-repair.js +122 -0
  141. package/dist/server/redaction-repair.js.map +1 -0
  142. package/dist/server/rpc-session.d.ts +64 -0
  143. package/dist/server/rpc-session.d.ts.map +1 -0
  144. package/dist/server/rpc-session.js +609 -0
  145. package/dist/server/rpc-session.js.map +1 -0
  146. package/dist/server/rpc-session.test.d.ts +2 -0
  147. package/dist/server/rpc-session.test.d.ts.map +1 -0
  148. package/dist/server/rpc-session.test.js +803 -0
  149. package/dist/server/rpc-session.test.js.map +1 -0
  150. package/dist/server/settings-catalog.d.ts +16 -0
  151. package/dist/server/settings-catalog.d.ts.map +1 -0
  152. package/dist/server/settings-catalog.js +86 -0
  153. package/dist/server/settings-catalog.js.map +1 -0
  154. package/dist/server/settings-catalog.test.d.ts +2 -0
  155. package/dist/server/settings-catalog.test.d.ts.map +1 -0
  156. package/dist/server/settings-catalog.test.js +41 -0
  157. package/dist/server/settings-catalog.test.js.map +1 -0
  158. package/dist/server/settings-overlay.d.ts +22 -0
  159. package/dist/server/settings-overlay.d.ts.map +1 -0
  160. package/dist/server/settings-overlay.js +131 -0
  161. package/dist/server/settings-overlay.js.map +1 -0
  162. package/dist/server/settings-overlay.test.d.ts +2 -0
  163. package/dist/server/settings-overlay.test.d.ts.map +1 -0
  164. package/dist/server/settings-overlay.test.js +134 -0
  165. package/dist/server/settings-overlay.test.js.map +1 -0
  166. package/dist/server/skills.d.ts +5 -0
  167. package/dist/server/skills.d.ts.map +1 -0
  168. package/dist/server/skills.js +111 -0
  169. package/dist/server/skills.js.map +1 -0
  170. package/dist/server/skills.test.d.ts +2 -0
  171. package/dist/server/skills.test.d.ts.map +1 -0
  172. package/dist/server/skills.test.js +65 -0
  173. package/dist/server/skills.test.js.map +1 -0
  174. package/dist/server/test.d.ts +3 -0
  175. package/dist/server/test.d.ts.map +1 -0
  176. package/dist/server/test.js +446 -0
  177. package/dist/server/test.js.map +1 -0
  178. package/dist/server/tool-guard.d.ts +22 -0
  179. package/dist/server/tool-guard.d.ts.map +1 -0
  180. package/dist/server/tool-guard.js +101 -0
  181. package/dist/server/tool-guard.js.map +1 -0
  182. package/dist/server/tool-guard.test.d.ts +2 -0
  183. package/dist/server/tool-guard.test.d.ts.map +1 -0
  184. package/dist/server/tool-guard.test.js +152 -0
  185. package/dist/server/tool-guard.test.js.map +1 -0
  186. package/dist/ui/index.d.ts +2 -0
  187. package/dist/ui/index.d.ts.map +1 -0
  188. package/dist/ui/index.js +2 -0
  189. package/dist/ui/index.js.map +1 -0
  190. package/dist/ui/parse-stdout.d.ts +4 -0
  191. package/dist/ui/parse-stdout.d.ts.map +1 -0
  192. package/dist/ui/parse-stdout.js +493 -0
  193. package/dist/ui/parse-stdout.js.map +1 -0
  194. package/dist/ui/parse-stdout.test.d.ts +2 -0
  195. package/dist/ui/parse-stdout.test.d.ts.map +1 -0
  196. package/dist/ui/parse-stdout.test.js +107 -0
  197. package/dist/ui/parse-stdout.test.js.map +1 -0
  198. package/package.json +56 -10
  199. package/README.md +0 -8
  200. package/index.js +0 -1
@@ -0,0 +1,803 @@
1
+ import { beforeEach, describe, expect, it, vi } from "vitest";
2
+ import { Writable } from "node:stream";
3
+ vi.mock("@tickernelz/wardmote-adapter-utils/execution-target", async (importOriginal) => {
4
+ const actual = (await importOriginal());
5
+ return { ...actual, runAdapterExecutionTargetProcess: vi.fn() };
6
+ });
7
+ import { runAdapterExecutionTargetProcess } from "@tickernelz/wardmote-adapter-utils/execution-target";
8
+ import { createOmpRpcSteerSession, runOmpRpcSession } from "./rpc-session.js";
9
+ const runProcessMock = vi.mocked(runAdapterExecutionTargetProcess);
10
+ function harness() {
11
+ const stdinFrames = [];
12
+ const logged = [];
13
+ const errors = [];
14
+ let stdinText = "";
15
+ let endCount = 0;
16
+ let answeredIdleChecks = 0;
17
+ let logSink = null;
18
+ let channel = null;
19
+ let markBound = () => { };
20
+ let releaseProcess = () => { };
21
+ const bound = new Promise((resolve) => {
22
+ markBound = resolve;
23
+ });
24
+ const released = new Promise((resolve) => {
25
+ releaseProcess = resolve;
26
+ });
27
+ const stream = new Writable({
28
+ write(chunk, _encoding, callback) {
29
+ stdinText += String(chunk);
30
+ let newline = stdinText.indexOf("\n");
31
+ while (newline >= 0) {
32
+ const line = stdinText.slice(0, newline).trim();
33
+ stdinText = stdinText.slice(newline + 1);
34
+ if (line)
35
+ stdinFrames.push(JSON.parse(line));
36
+ newline = stdinText.indexOf("\n");
37
+ }
38
+ callback();
39
+ },
40
+ final(callback) {
41
+ endCount += 1;
42
+ callback();
43
+ },
44
+ });
45
+ runProcessMock.mockReset();
46
+ runProcessMock.mockImplementation((async (_runId, _target, _command, _args, options) => {
47
+ channel = options.liveStdin ?? null;
48
+ channel?.bind(stream);
49
+ logSink = options.onLog;
50
+ markBound();
51
+ await released;
52
+ return {
53
+ exitCode: 0,
54
+ signal: null,
55
+ timedOut: false,
56
+ stdout: "",
57
+ stderr: "",
58
+ pid: 4321,
59
+ startedAt: new Date().toISOString(),
60
+ };
61
+ }));
62
+ return {
63
+ stdinFrames,
64
+ logged,
65
+ errors,
66
+ async feed(frame) {
67
+ await bound;
68
+ const line = typeof frame === "string" ? frame : `${JSON.stringify(frame)}\n`;
69
+ await logSink?.("stdout", line);
70
+ },
71
+ async answerIdleCheck(data) {
72
+ const idleChecks = () => stdinFrames.filter((frame) => frame.type === "get_state" && String(frame.id).startsWith("idle-"));
73
+ for (;;) {
74
+ await vi.waitFor(() => expect(idleChecks().length).toBeGreaterThan(answeredIdleChecks));
75
+ const sent = idleChecks();
76
+ answeredIdleChecks = sent.length;
77
+ await this.feed({ id: sent.at(-1).id, type: "response", command: "get_state", success: true, data });
78
+ await Promise.resolve();
79
+ if (idleChecks().length === answeredIdleChecks)
80
+ return;
81
+ }
82
+ },
83
+ async endTurn() {
84
+ await this.feed({ type: "agent_end", isTerminal: true, messages: [] });
85
+ await this.answerIdleCheck({ queuedMessageCount: 0, isStreaming: false });
86
+ },
87
+ finish() {
88
+ releaseProcess();
89
+ },
90
+ close() {
91
+ channel?.close();
92
+ },
93
+ ends: () => endCount,
94
+ };
95
+ }
96
+ function run(session = createOmpRpcSteerSession(), prompt = "Do the work", continuationIdleMs) {
97
+ return runOmpRpcSession({
98
+ runId: "run-rpc",
99
+ command: "omp",
100
+ args: ["--mode", "rpc"],
101
+ cwd: "/tmp",
102
+ env: {},
103
+ timeoutSec: 30,
104
+ graceSec: 5,
105
+ prompt,
106
+ runtimeTarget: null,
107
+ onLog: async (stream, chunk) => {
108
+ if (stream === "stdout")
109
+ state.logged.push(chunk);
110
+ else
111
+ state.errors.push(chunk);
112
+ },
113
+ session,
114
+ continuationIdleMs,
115
+ });
116
+ }
117
+ let state;
118
+ beforeEach(() => {
119
+ state = harness();
120
+ });
121
+ describe("OMP RPC session protocol", () => {
122
+ it("negotiates protocol v2 before requesting state or sending the prompt", async () => {
123
+ const running = run();
124
+ await state.feed({
125
+ type: "ready",
126
+ protocolVersion: 1,
127
+ supportedProtocolVersions: [1, 2],
128
+ maxFrameBytes: 1048576,
129
+ maxReassembledFrameBytes: 67108864,
130
+ });
131
+ expect(state.stdinFrames[0]).toEqual({
132
+ id: "negotiate-1",
133
+ type: "negotiate_protocol",
134
+ protocolVersion: 2,
135
+ });
136
+ expect(state.stdinFrames).toHaveLength(1);
137
+ await state.feed({ id: "negotiate-1", type: "response", command: "negotiate_protocol", success: true, data: { protocolVersion: 2 } });
138
+ expect(state.stdinFrames[1]).toEqual({ id: "state-1", type: "get_state" });
139
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-42" } });
140
+ expect(state.stdinFrames[2]).toEqual({ id: "prompt-1", type: "prompt", message: "Do the work" });
141
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
142
+ await state.endTurn();
143
+ state.finish();
144
+ const result = await running;
145
+ expect(result.sessionId).toBe("session-42");
146
+ expect(result.promptAcknowledged).toBe(true);
147
+ expect(result.promptError).toBeNull();
148
+ expect(result.protocolVersion).toBe(2);
149
+ });
150
+ it("skips negotiation and prompts when the child advertises protocol v1 only", async () => {
151
+ const running = run();
152
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
153
+ expect(state.stdinFrames[0]).toEqual({ id: "state-1", type: "get_state" });
154
+ expect(state.stdinFrames.some((frame) => frame.type === "negotiate_protocol")).toBe(false);
155
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-v1" } });
156
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
157
+ await state.endTurn();
158
+ state.finish();
159
+ const result = await running;
160
+ expect(result.protocolVersion).toBe(1);
161
+ expect(result.sessionId).toBe("session-v1");
162
+ expect(state.stdinFrames[1]).toEqual({ id: "prompt-1", type: "prompt", message: "Do the work" });
163
+ });
164
+ it("fails the run when protocol negotiation is rejected", async () => {
165
+ const running = run();
166
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1, 2] });
167
+ await state.feed({
168
+ id: "negotiate-1",
169
+ type: "response",
170
+ command: "negotiate_protocol",
171
+ success: false,
172
+ error: "Unsupported RPC protocol version: 2",
173
+ });
174
+ state.finish();
175
+ const result = await running;
176
+ expect(result.promptError).toBe("Unsupported RPC protocol version: 2");
177
+ expect(result.protocolVersion).toBeNull();
178
+ expect(state.stdinFrames.some((frame) => frame.type === "prompt")).toBe(false);
179
+ });
180
+ it("fails the run when the prompt is rejected instead of reporting success", async () => {
181
+ const running = run();
182
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1, 2] });
183
+ await state.feed({ id: "negotiate-1", type: "response", command: "negotiate_protocol", success: true });
184
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-7" } });
185
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: false, error: "Agent is already processing." });
186
+ state.finish();
187
+ const result = await running;
188
+ expect(result.promptError).toBe("Agent is already processing.");
189
+ expect(result.promptAcknowledged).toBe(false);
190
+ expect(result.sessionId).toBe("session-7");
191
+ });
192
+ it("fails the run when the prompt was never dispatched", async () => {
193
+ const session = createOmpRpcSteerSession();
194
+ const running = run(session);
195
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1, 2] });
196
+ state.close();
197
+ state.finish();
198
+ const result = await running;
199
+ expect(result.promptAcknowledged).toBe(false);
200
+ expect(result.promptError).toBe("OMP RPC mode ended before the run's prompt was dispatched.");
201
+ });
202
+ it("fails the run when prompt_result reports an error", async () => {
203
+ const running = run();
204
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
205
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-failed" } });
206
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
207
+ await state.feed({
208
+ type: "prompt_result",
209
+ id: "prompt-1",
210
+ agentInvoked: true,
211
+ status: "error",
212
+ error: { message: "provider rejected the request", retryable: false },
213
+ sessionSettled: true,
214
+ });
215
+ state.finish();
216
+ const result = await running;
217
+ expect(result.promptError).toBe("provider rejected the request");
218
+ expect(state.ends()).toBe(1);
219
+ });
220
+ it("settles the run when prompt_result reports the agent was never invoked", async () => {
221
+ const running = run();
222
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
223
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-local" } });
224
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
225
+ await state.feed({
226
+ type: "prompt_result",
227
+ id: "prompt-1",
228
+ agentInvoked: false,
229
+ status: "completed",
230
+ sessionSettled: true,
231
+ });
232
+ state.finish();
233
+ const result = await running;
234
+ expect(result.promptError).toBeNull();
235
+ expect(state.ends()).toBe(1);
236
+ });
237
+ it("reassembles chunked frames and logs the logical frame rather than the base64 chunk", async () => {
238
+ const running = run();
239
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1, 2] });
240
+ await state.feed({ id: "negotiate-1", type: "response", command: "negotiate_protocol", success: true });
241
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-chunk" } });
242
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
243
+ const logical = JSON.stringify({
244
+ type: "message_end",
245
+ message: { role: "assistant", content: [{ type: "text", text: `${"x".repeat(1024 * 1024)}chunked reply` }] },
246
+ });
247
+ const bytes = Buffer.from(logical, "utf8");
248
+ const payloadBytes = 256 * 1024;
249
+ const count = Math.ceil(bytes.byteLength / payloadBytes);
250
+ for (let index = 0; index < count - 1; index += 1) {
251
+ await state.feed({
252
+ type: "rpc_chunk",
253
+ chunkId: "rpc-1",
254
+ index,
255
+ count,
256
+ byteLength: bytes.byteLength,
257
+ data: bytes.subarray(index * payloadBytes, (index + 1) * payloadBytes).toString("base64"),
258
+ });
259
+ }
260
+ expect(state.logged.some((chunk) => chunk.includes("rpc_chunk"))).toBe(false);
261
+ const lastIndex = count - 1;
262
+ await state.feed({
263
+ type: "rpc_chunk",
264
+ chunkId: "rpc-1",
265
+ index: lastIndex,
266
+ count,
267
+ byteLength: bytes.byteLength,
268
+ data: bytes.subarray(lastIndex * payloadBytes).toString("base64"),
269
+ });
270
+ expect(state.logged.some((chunk) => chunk.includes("chunked reply"))).toBe(true);
271
+ expect(state.logged.some((chunk) => chunk.includes("rpc_chunk"))).toBe(false);
272
+ await state.endTurn();
273
+ state.finish();
274
+ await running;
275
+ });
276
+ it("keeps transport control frames out of the adapter transcript", async () => {
277
+ const running = run();
278
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1, 2] });
279
+ await state.feed({ type: "available_commands_update", commands: [{ name: "compact" }] });
280
+ await state.feed({ id: "negotiate-1", type: "response", command: "negotiate_protocol", success: true });
281
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-quiet" } });
282
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
283
+ await state.feed({ type: "agent_start" });
284
+ await state.endTurn();
285
+ state.finish();
286
+ await running;
287
+ const transcript = state.logged.join("");
288
+ expect(transcript).not.toContain("available_commands_update");
289
+ expect(transcript).not.toContain("negotiate_protocol");
290
+ expect(transcript).not.toContain("get_state");
291
+ expect(transcript).toContain("agent_start");
292
+ });
293
+ it("passes notice frames through to the transcript sink", async () => {
294
+ const running = run();
295
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
296
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-notice" } });
297
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
298
+ await state.feed({
299
+ type: "notice",
300
+ level: "warning",
301
+ message: 'Warning: MCP server "paperclip" failed to connect: spawn ENOENT; its tools are unavailable for this run.',
302
+ });
303
+ await state.endTurn();
304
+ state.finish();
305
+ await running;
306
+ expect(state.logged.join("")).toContain("failed to connect: spawn ENOENT");
307
+ });
308
+ it("surfaces a transport-dropped frame on stderr instead of silently losing it", async () => {
309
+ const running = run();
310
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
311
+ await state.feed({ type: "rpc_frame_error", originalType: "agent_end", error: "RPC frame exceeded the transport limit" });
312
+ state.close();
313
+ state.finish();
314
+ await running;
315
+ expect(state.errors.join("")).toContain("RPC frame exceeded the transport limit");
316
+ });
317
+ it("shapes message_update frames so the transcript does not grow quadratically", async () => {
318
+ const running = run();
319
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
320
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-shape" } });
321
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
322
+ await state.feed({
323
+ type: "message_update",
324
+ message: { role: "assistant", content: [{ type: "text", text: "the whole in-progress message" }], providerPayload: { big: "x".repeat(50) } },
325
+ assistantMessageEvent: {
326
+ type: "text_delta",
327
+ delta: "hello",
328
+ partial: { role: "assistant", content: [{ type: "text", text: "the whole in-progress message" }] },
329
+ },
330
+ });
331
+ await state.endTurn();
332
+ state.finish();
333
+ await running;
334
+ const emitted = state.logged.join("");
335
+ expect(emitted).toContain("hello");
336
+ expect(emitted).not.toContain("the whole in-progress message");
337
+ expect(emitted).not.toContain("providerPayload");
338
+ });
339
+ it("keeps the final assistant text while dropping providerPayload from message frames", async () => {
340
+ const running = run();
341
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
342
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-final" } });
343
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
344
+ await state.feed({
345
+ type: "message_end",
346
+ message: {
347
+ role: "assistant",
348
+ content: [{ type: "text", text: "final answer" }],
349
+ providerPayload: { opaque: "replay state" },
350
+ },
351
+ });
352
+ await state.endTurn();
353
+ state.finish();
354
+ await running;
355
+ const emitted = state.logged.join("");
356
+ expect(emitted).toContain("final answer");
357
+ expect(emitted).not.toContain("providerPayload");
358
+ expect(emitted).not.toContain("replay state");
359
+ });
360
+ it("strips providerPayload from turn_end toolResults as print mode does", async () => {
361
+ const running = run();
362
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
363
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-tools" } });
364
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
365
+ await state.feed({
366
+ type: "turn_end",
367
+ message: { role: "assistant", content: [], providerPayload: { a: 1 } },
368
+ toolResults: [
369
+ { toolCallId: "t1", content: "tool output stays", providerPayload: { b: 2 } },
370
+ ],
371
+ });
372
+ await state.endTurn();
373
+ state.finish();
374
+ await running;
375
+ const emitted = state.logged.join("");
376
+ expect(emitted).toContain("tool output stays");
377
+ expect(emitted).not.toContain("providerPayload");
378
+ });
379
+ it("closes the run's stdin once the terminal agent_end arrives", async () => {
380
+ const running = run();
381
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
382
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-end" } });
383
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
384
+ await state.endTurn();
385
+ state.finish();
386
+ await running;
387
+ expect(state.ends()).toBe(1);
388
+ });
389
+ it("keeps stdin open after the turn ends while OMP still holds a queued steer", async () => {
390
+ const running = run();
391
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
392
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-late" } });
393
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
394
+ await state.feed({ type: "agent_end", isTerminal: true, messages: [] });
395
+ await state.answerIdleCheck({ queuedMessageCount: 1, isStreaming: false });
396
+ expect(state.ends()).toBe(0);
397
+ await state.feed({ type: "agent_start" });
398
+ await state.feed({ type: "agent_end", isTerminal: true, messages: [] });
399
+ await state.answerIdleCheck({ queuedMessageCount: 0, isStreaming: false });
400
+ expect(state.ends()).toBe(1);
401
+ state.finish();
402
+ expect((await running).promptError).toBeNull();
403
+ });
404
+ it("waits for an in-flight steer acknowledgement before checking whether OMP is idle", async () => {
405
+ const session = createOmpRpcSteerSession();
406
+ const running = run(session);
407
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
408
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-race" } });
409
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
410
+ await state.feed({ type: "agent_start" });
411
+ const { activeTurnId } = await session.snapshot();
412
+ const steering = session.steer({
413
+ turnId: activeTurnId,
414
+ message: { role: "user", text: "One more thing" },
415
+ correlationId: "comment-late",
416
+ });
417
+ await vi.waitFor(() => expect(state.stdinFrames.some((frame) => frame.type === "steer")).toBe(true));
418
+ await state.feed({ type: "agent_end", isTerminal: true, messages: [] });
419
+ expect(state.stdinFrames.some((frame) => String(frame.id).startsWith("idle-"))).toBe(false);
420
+ expect(state.ends()).toBe(0);
421
+ await state.feed({ id: "comment-late", type: "response", command: "steer", success: true });
422
+ await steering;
423
+ await state.answerIdleCheck({ queuedMessageCount: 1, isStreaming: false });
424
+ expect(state.ends()).toBe(0);
425
+ await state.feed({ type: "agent_start" });
426
+ await state.endTurn();
427
+ expect(state.ends()).toBe(1);
428
+ state.finish();
429
+ await running;
430
+ });
431
+ it("closes the run's stdin on session_settled once OMP confirms it is idle", async () => {
432
+ const running = run();
433
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
434
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-settled" } });
435
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
436
+ await state.feed({ type: "agent_end", isTerminal: false, messages: [] });
437
+ expect(state.ends()).toBe(0);
438
+ await state.feed({ type: "session_settled" });
439
+ await state.answerIdleCheck({ queuedMessageCount: 0, isStreaming: false });
440
+ state.finish();
441
+ await running;
442
+ expect(state.ends()).toBe(1);
443
+ });
444
+ it("keeps stdin open when prompt_result says settled but a steer was accepted in the same instant", async () => {
445
+ const session = createOmpRpcSteerSession();
446
+ const running = run(session);
447
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
448
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-race-settled" } });
449
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
450
+ await state.feed({ type: "agent_start" });
451
+ const { activeTurnId } = await session.snapshot();
452
+ const steering = session.steer({
453
+ turnId: activeTurnId,
454
+ message: { role: "user", text: "Now reply BRAVO" },
455
+ correlationId: "comment-race",
456
+ });
457
+ await vi.waitFor(() => expect(state.stdinFrames.some((frame) => frame.type === "steer")).toBe(true));
458
+ await state.feed({ type: "agent_end", isTerminal: true, messages: [] });
459
+ await state.feed({ type: "prompt_result", id: "prompt-1", agentInvoked: true, status: "completed", sessionSettled: true });
460
+ expect(state.ends()).toBe(0);
461
+ await state.feed({ id: "comment-race", type: "response", command: "steer", success: true });
462
+ await steering;
463
+ await state.answerIdleCheck({ queuedMessageCount: 0, isStreaming: true });
464
+ expect(state.ends()).toBe(0);
465
+ await state.feed({ type: "agent_start" });
466
+ await state.feed({ type: "agent_end", isTerminal: true, messages: [] });
467
+ await state.feed({ type: "session_settled" });
468
+ await state.answerIdleCheck({ queuedMessageCount: 0, isStreaming: false });
469
+ expect(state.ends()).toBe(1);
470
+ state.finish();
471
+ expect((await running).promptError).toBeNull();
472
+ });
473
+ it("keeps a steered turn open however long it streams after the settle signal", async () => {
474
+ vi.useFakeTimers();
475
+ try {
476
+ const running = runOmpRpcSession({
477
+ runId: "run-long-steer",
478
+ command: "omp",
479
+ args: ["--mode", "rpc"],
480
+ cwd: "/tmp",
481
+ env: {},
482
+ timeoutSec: 30,
483
+ graceSec: 5,
484
+ prompt: "Do the work",
485
+ runtimeTarget: null,
486
+ onLog: async () => { },
487
+ session: createOmpRpcSteerSession(),
488
+ idleRecheckMs: 250,
489
+ });
490
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
491
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-long" } });
492
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
493
+ await state.feed({ type: "agent_end", isTerminal: true, messages: [] });
494
+ await state.feed({ type: "prompt_result", id: "prompt-1", agentInvoked: true, status: "completed", sessionSettled: true });
495
+ for (let check = 0; check < 40; check += 1) {
496
+ await state.answerIdleCheck({ queuedMessageCount: 1, isStreaming: true });
497
+ await vi.advanceTimersByTimeAsync(250);
498
+ await state.feed({ type: "session_settled" });
499
+ }
500
+ expect(state.ends()).toBe(0);
501
+ await state.answerIdleCheck({ queuedMessageCount: 0, isStreaming: true });
502
+ await state.feed({ type: "agent_start" });
503
+ await vi.advanceTimersByTimeAsync(60_000);
504
+ await state.feed({ type: "agent_end", isTerminal: true, messages: [] });
505
+ await state.answerIdleCheck({ queuedMessageCount: 0, isStreaming: false });
506
+ expect(state.ends()).toBe(1);
507
+ state.finish();
508
+ expect((await running).promptError).toBeNull();
509
+ }
510
+ finally {
511
+ vi.useRealTimers();
512
+ }
513
+ });
514
+ it("observes a frame before handing it to the transcript sink", async () => {
515
+ const session = createOmpRpcSteerSession();
516
+ const observedAtEmit = [];
517
+ const running = runOmpRpcSession({
518
+ runId: "run-rpc-order",
519
+ command: "omp",
520
+ args: ["--mode", "rpc"],
521
+ cwd: "/tmp",
522
+ env: {},
523
+ timeoutSec: 30,
524
+ graceSec: 5,
525
+ prompt: "Do the work",
526
+ runtimeTarget: null,
527
+ onLog: async (stream, chunk) => {
528
+ if (stream !== "stdout" || !chunk.includes("agent_start"))
529
+ return;
530
+ observedAtEmit.push((await session.snapshot()).activeTurnId);
531
+ },
532
+ session,
533
+ });
534
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
535
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-order" } });
536
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
537
+ await state.feed({ type: "agent_start" });
538
+ await state.endTurn();
539
+ state.finish();
540
+ await running;
541
+ expect(observedAtEmit).toHaveLength(1);
542
+ expect(observedAtEmit[0]).toMatch(/^omp-rpc-turn:/);
543
+ });
544
+ it("keeps the run open while a continuation agent_end is not terminal", async () => {
545
+ const running = run();
546
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
547
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-cont" } });
548
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
549
+ await state.feed({ type: "agent_end", isTerminal: false, messages: [] });
550
+ expect(state.ends()).toBe(0);
551
+ await state.endTurn();
552
+ state.finish();
553
+ await running;
554
+ expect(state.ends()).toBe(1);
555
+ });
556
+ it("ends a run whose non-terminal pause starts no new turn, as print mode reaps leftover jobs", async () => {
557
+ vi.useFakeTimers();
558
+ try {
559
+ const running = run(undefined, undefined, 60_000);
560
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
561
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-idle" } });
562
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
563
+ await state.feed({ type: "agent_end", isTerminal: false, messages: [] });
564
+ await state.feed({ type: "extension_ui_request", id: "ui-1", method: "setStatus" });
565
+ await state.feed({ type: "prompt_result", status: "completed" });
566
+ await vi.advanceTimersByTimeAsync(2_500);
567
+ await state.feed({ type: "advisor_yielded" });
568
+ await vi.advanceTimersByTimeAsync(57_499);
569
+ expect(state.ends()).toBe(0);
570
+ await vi.advanceTimersByTimeAsync(1);
571
+ expect(state.ends()).toBe(1);
572
+ expect(state.errors.join("")).toContain("did no turn work for 60s");
573
+ state.finish();
574
+ expect((await running).promptError).toBeNull();
575
+ }
576
+ finally {
577
+ vi.useRealTimers();
578
+ }
579
+ });
580
+ it("keeps a paused run open when the background work resumes a turn before the idle bound", async () => {
581
+ vi.useFakeTimers();
582
+ try {
583
+ const running = run(undefined, undefined, 60_000);
584
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
585
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-resume" } });
586
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
587
+ await state.feed({ type: "agent_end", isTerminal: false, messages: [] });
588
+ await vi.advanceTimersByTimeAsync(30_000);
589
+ await state.feed({ type: "agent_start" });
590
+ await vi.advanceTimersByTimeAsync(120_000);
591
+ expect(state.ends()).toBe(0);
592
+ await state.endTurn();
593
+ expect(state.ends()).toBe(1);
594
+ state.finish();
595
+ await running;
596
+ }
597
+ finally {
598
+ vi.useRealTimers();
599
+ }
600
+ });
601
+ it("keeps a paused run open through a deferred handoff compaction that outlasts the idle bound", async () => {
602
+ vi.useFakeTimers();
603
+ try {
604
+ const running = run(undefined, undefined, 60_000);
605
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
606
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-compact" } });
607
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
608
+ await state.feed({ type: "agent_end", isTerminal: false, messages: [] });
609
+ await state.feed({ type: "auto_compaction_start", reason: "threshold" });
610
+ await vi.advanceTimersByTimeAsync(180_000);
611
+ expect(state.ends()).toBe(0);
612
+ await state.feed({ type: "auto_compaction_end" });
613
+ await state.feed({ type: "agent_start" });
614
+ await state.endTurn();
615
+ expect(state.ends()).toBe(1);
616
+ state.finish();
617
+ await running;
618
+ }
619
+ finally {
620
+ vi.useRealTimers();
621
+ }
622
+ });
623
+ it("keeps a retried turn open when its agent_start arrived before the paused agent_end", async () => {
624
+ vi.useFakeTimers();
625
+ try {
626
+ const running = run(undefined, undefined, 60_000);
627
+ await state.feed({ type: "ready", protocolVersion: 1, supportedProtocolVersions: [1] });
628
+ await state.feed({ id: "state-1", type: "response", command: "get_state", success: true, data: { sessionId: "session-ttsr" } });
629
+ await state.feed({ id: "prompt-1", type: "response", command: "prompt", success: true });
630
+ await state.feed({ type: "agent_start" });
631
+ await state.feed({ type: "turn_start" });
632
+ await state.feed({ type: "agent_end", isTerminal: false, messages: [] });
633
+ await vi.advanceTimersByTimeAsync(180_000);
634
+ expect(state.ends()).toBe(0);
635
+ await state.feed({ type: "turn_end" });
636
+ await state.endTurn();
637
+ expect(state.ends()).toBe(1);
638
+ state.finish();
639
+ await running;
640
+ }
641
+ finally {
642
+ vi.useRealTimers();
643
+ }
644
+ });
645
+ });
646
+ describe("OMP RPC steering session", () => {
647
+ it("reports steering only while a writer is bound and the session is open", async () => {
648
+ const session = createOmpRpcSteerSession();
649
+ expect(await session.capabilities()).toEqual({ steering: true });
650
+ expect(await session.snapshot()).toEqual({ activeTurnId: null });
651
+ session.close();
652
+ expect(await session.capabilities()).toEqual({ steering: false });
653
+ });
654
+ it("exposes the active turn while streaming and clears it at the terminal end", () => {
655
+ const session = createOmpRpcSteerSession();
656
+ session.observeFrame({ type: "agent_start" });
657
+ const turn = session.snapshot();
658
+ void turn.then((value) => expect(value.activeTurnId).toMatch(/^omp-rpc-turn:/));
659
+ session.observeFrame({ type: "agent_end", isTerminal: true });
660
+ void session.snapshot().then((value) => expect(value.activeTurnId).toBeNull());
661
+ });
662
+ it("signals a turn-active waiter once, immediately when a turn is already active, and never after close", async () => {
663
+ const session = createOmpRpcSteerSession();
664
+ const beforeTurn = vi.fn();
665
+ const cancelled = vi.fn();
666
+ session.onceTurnActive(beforeTurn);
667
+ session.onceTurnActive(cancelled)();
668
+ session.observeFrame({ type: "agent_start" });
669
+ session.observeFrame({ type: "turn_start" });
670
+ expect(beforeTurn).toHaveBeenCalledTimes(1);
671
+ const duringTurn = vi.fn();
672
+ session.onceTurnActive(duringTurn);
673
+ expect(duringTurn).not.toHaveBeenCalled();
674
+ await Promise.resolve();
675
+ expect(duringTurn).toHaveBeenCalledTimes(1);
676
+ session.observeFrame({ type: "agent_end", isTerminal: true });
677
+ const afterClose = vi.fn();
678
+ session.onceTurnActive(afterClose);
679
+ session.close();
680
+ session.observeFrame({ type: "turn_start" });
681
+ expect(afterClose).not.toHaveBeenCalled();
682
+ expect(cancelled).not.toHaveBeenCalled();
683
+ expect(beforeTurn).toHaveBeenCalledTimes(1);
684
+ });
685
+ it("rejects a steer for a turn other than the active one", async () => {
686
+ const session = createOmpRpcSteerSession();
687
+ session.setWriter(async () => { });
688
+ session.observeFrame({ type: "agent_start" });
689
+ const snapshot = await session.snapshot();
690
+ await expect(session.steer({
691
+ turnId: "some-other-turn",
692
+ message: { role: "user", text: "stale" },
693
+ correlationId: "c1",
694
+ })).rejects.toThrow("stale active turn");
695
+ expect(snapshot.activeTurnId).not.toBeNull();
696
+ });
697
+ it("reports a steer that arrives after the turn ended as stale so it stays queued", async () => {
698
+ const session = createOmpRpcSteerSession();
699
+ const written = [];
700
+ session.setWriter(async (data) => {
701
+ written.push(data);
702
+ });
703
+ session.observeFrame({ type: "agent_start" });
704
+ const { activeTurnId } = await session.snapshot();
705
+ session.observeFrame({ type: "agent_end", isTerminal: true });
706
+ await expect(session.steer({
707
+ turnId: activeTurnId,
708
+ message: { role: "user", text: "too late" },
709
+ correlationId: "c-late",
710
+ })).rejects.toThrow("stale active turn");
711
+ expect(written).toHaveLength(0);
712
+ });
713
+ it("gives up on an unanswered steer at the caller's acknowledgement deadline", async () => {
714
+ vi.useFakeTimers();
715
+ try {
716
+ const session = createOmpRpcSteerSession();
717
+ session.setWriter(async () => { });
718
+ session.observeFrame({ type: "agent_start" });
719
+ const { activeTurnId } = await session.snapshot();
720
+ const steering = session.steer({
721
+ turnId: activeTurnId,
722
+ message: { role: "user", text: "unanswered" },
723
+ correlationId: "c-deadline",
724
+ ackTimeoutMs: 3_000,
725
+ });
726
+ let settledWith = null;
727
+ void steering.then(() => { settledWith = "acknowledged"; }, (error) => { settledWith = error.message; });
728
+ await vi.advanceTimersByTimeAsync(2_999);
729
+ expect(settledWith).toBeNull();
730
+ await vi.advanceTimersByTimeAsync(1);
731
+ expect(settledWith).toBe("omp_rpc_steer_timeout");
732
+ await expect(steering).rejects.toThrow("omp_rpc_steer_timeout");
733
+ await session.whenSteersSettled();
734
+ }
735
+ finally {
736
+ vi.useRealTimers();
737
+ }
738
+ });
739
+ it("resolves a steer only after the provider acknowledges it", async () => {
740
+ const session = createOmpRpcSteerSession();
741
+ const written = [];
742
+ session.setWriter(async (data) => {
743
+ written.push(JSON.parse(data.trim()));
744
+ });
745
+ session.observeFrame({ type: "agent_start" });
746
+ const { activeTurnId } = await session.snapshot();
747
+ const steering = session.steer({
748
+ turnId: activeTurnId,
749
+ message: { role: "user", text: "Check mobile overflow first." },
750
+ correlationId: "comment-1",
751
+ });
752
+ await vi.waitFor(() => expect(written).toHaveLength(1));
753
+ expect(written[0]).toEqual({
754
+ id: "comment-1",
755
+ type: "steer",
756
+ message: "Check mobile overflow first.",
757
+ });
758
+ session.observeFrame({ id: "comment-1", type: "response", command: "steer", success: true });
759
+ await expect(steering).resolves.toBeUndefined();
760
+ });
761
+ it("rejects the steer when the provider refuses it", async () => {
762
+ const session = createOmpRpcSteerSession();
763
+ session.setWriter(async () => { });
764
+ session.observeFrame({ type: "agent_start" });
765
+ const { activeTurnId } = await session.snapshot();
766
+ const steering = session.steer({
767
+ turnId: activeTurnId,
768
+ message: { role: "user", text: "nope" },
769
+ correlationId: "comment-refused",
770
+ });
771
+ session.observeFrame({
772
+ id: "comment-refused",
773
+ type: "response",
774
+ command: "steer",
775
+ success: false,
776
+ error: "request rejected",
777
+ });
778
+ await expect(steering).rejects.toThrow("request rejected");
779
+ });
780
+ it("rejects a steer once the session closed", async () => {
781
+ const session = createOmpRpcSteerSession();
782
+ session.setWriter(async () => { });
783
+ session.observeFrame({ type: "agent_start" });
784
+ const { activeTurnId } = await session.snapshot();
785
+ session.close();
786
+ await expect(session.steer({
787
+ turnId: activeTurnId,
788
+ message: { role: "user", text: "after close" },
789
+ correlationId: "comment-closed",
790
+ })).rejects.toThrow("omp_rpc_session_unavailable");
791
+ });
792
+ it("rejects a steer with no writer bound", async () => {
793
+ const session = createOmpRpcSteerSession();
794
+ session.observeFrame({ type: "agent_start" });
795
+ const { activeTurnId } = await session.snapshot();
796
+ await expect(session.steer({
797
+ turnId: activeTurnId,
798
+ message: { role: "user", text: "no writer" },
799
+ correlationId: "comment-no-writer",
800
+ })).rejects.toThrow("omp_rpc_session_unavailable");
801
+ });
802
+ });
803
+ //# sourceMappingURL=rpc-session.test.js.map