@herdctl/core 0.0.1 → 0.0.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 (275) hide show
  1. package/dist/config/__tests__/agent.test.js +31 -13
  2. package/dist/config/__tests__/agent.test.js.map +1 -1
  3. package/dist/config/__tests__/merge.test.js +9 -2
  4. package/dist/config/__tests__/merge.test.js.map +1 -1
  5. package/dist/config/__tests__/schema.test.js +350 -1
  6. package/dist/config/__tests__/schema.test.js.map +1 -1
  7. package/dist/config/index.d.ts +1 -1
  8. package/dist/config/index.d.ts.map +1 -1
  9. package/dist/config/index.js +3 -1
  10. package/dist/config/index.js.map +1 -1
  11. package/dist/config/schema.d.ts +828 -24
  12. package/dist/config/schema.d.ts.map +1 -1
  13. package/dist/config/schema.js +118 -6
  14. package/dist/config/schema.js.map +1 -1
  15. package/dist/fleet-manager/__tests__/coverage.test.js +11 -332
  16. package/dist/fleet-manager/__tests__/coverage.test.js.map +1 -1
  17. package/dist/fleet-manager/__tests__/errors.test.js +1 -49
  18. package/dist/fleet-manager/__tests__/errors.test.js.map +1 -1
  19. package/dist/fleet-manager/__tests__/integration.test.js +109 -0
  20. package/dist/fleet-manager/__tests__/integration.test.js.map +1 -1
  21. package/dist/fleet-manager/__tests__/reload.test.js +1 -1
  22. package/dist/fleet-manager/__tests__/reload.test.js.map +1 -1
  23. package/dist/fleet-manager/config-reload.d.ts +164 -0
  24. package/dist/fleet-manager/config-reload.d.ts.map +1 -0
  25. package/dist/fleet-manager/config-reload.js +445 -0
  26. package/dist/fleet-manager/config-reload.js.map +1 -0
  27. package/dist/fleet-manager/context.d.ts +76 -0
  28. package/dist/fleet-manager/context.d.ts.map +1 -0
  29. package/dist/fleet-manager/context.js +11 -0
  30. package/dist/fleet-manager/context.js.map +1 -0
  31. package/dist/fleet-manager/errors.d.ts +0 -25
  32. package/dist/fleet-manager/errors.d.ts.map +1 -1
  33. package/dist/fleet-manager/errors.js +0 -38
  34. package/dist/fleet-manager/errors.js.map +1 -1
  35. package/dist/fleet-manager/event-emitters.d.ts +123 -0
  36. package/dist/fleet-manager/event-emitters.d.ts.map +1 -0
  37. package/dist/fleet-manager/event-emitters.js +136 -0
  38. package/dist/fleet-manager/event-emitters.js.map +1 -0
  39. package/dist/fleet-manager/event-types.d.ts +0 -15
  40. package/dist/fleet-manager/event-types.d.ts.map +1 -1
  41. package/dist/fleet-manager/fleet-manager.d.ts +40 -653
  42. package/dist/fleet-manager/fleet-manager.d.ts.map +1 -1
  43. package/dist/fleet-manager/fleet-manager.js +95 -1720
  44. package/dist/fleet-manager/fleet-manager.js.map +1 -1
  45. package/dist/fleet-manager/index.d.ts +13 -2
  46. package/dist/fleet-manager/index.d.ts.map +1 -1
  47. package/dist/fleet-manager/index.js +19 -6
  48. package/dist/fleet-manager/index.js.map +1 -1
  49. package/dist/fleet-manager/job-control.d.ts +64 -0
  50. package/dist/fleet-manager/job-control.d.ts.map +1 -0
  51. package/dist/fleet-manager/job-control.js +296 -0
  52. package/dist/fleet-manager/job-control.js.map +1 -0
  53. package/dist/fleet-manager/log-streaming.d.ts +171 -0
  54. package/dist/fleet-manager/log-streaming.d.ts.map +1 -0
  55. package/dist/fleet-manager/log-streaming.js +503 -0
  56. package/dist/fleet-manager/log-streaming.js.map +1 -0
  57. package/dist/fleet-manager/schedule-executor.d.ts +63 -0
  58. package/dist/fleet-manager/schedule-executor.d.ts.map +1 -0
  59. package/dist/fleet-manager/schedule-executor.js +209 -0
  60. package/dist/fleet-manager/schedule-executor.js.map +1 -0
  61. package/dist/fleet-manager/schedule-management.d.ts +71 -0
  62. package/dist/fleet-manager/schedule-management.d.ts.map +1 -0
  63. package/dist/fleet-manager/schedule-management.js +171 -0
  64. package/dist/fleet-manager/schedule-management.js.map +1 -0
  65. package/dist/fleet-manager/status-queries.d.ts +105 -0
  66. package/dist/fleet-manager/status-queries.d.ts.map +1 -0
  67. package/dist/fleet-manager/status-queries.js +247 -0
  68. package/dist/fleet-manager/status-queries.js.map +1 -0
  69. package/dist/fleet-manager/types.d.ts +0 -39
  70. package/dist/fleet-manager/types.d.ts.map +1 -1
  71. package/dist/runner/__tests__/job-executor.test.js +206 -1
  72. package/dist/runner/__tests__/job-executor.test.js.map +1 -1
  73. package/dist/runner/job-executor.d.ts +9 -0
  74. package/dist/runner/job-executor.d.ts.map +1 -1
  75. package/dist/runner/job-executor.js +78 -4
  76. package/dist/runner/job-executor.js.map +1 -1
  77. package/dist/runner/types.d.ts +2 -0
  78. package/dist/runner/types.d.ts.map +1 -1
  79. package/dist/scheduler/__tests__/cron.test.d.ts +2 -0
  80. package/dist/scheduler/__tests__/cron.test.d.ts.map +1 -0
  81. package/dist/scheduler/__tests__/cron.test.js +867 -0
  82. package/dist/scheduler/__tests__/cron.test.js.map +1 -0
  83. package/dist/scheduler/__tests__/scheduler.test.js +164 -5
  84. package/dist/scheduler/__tests__/scheduler.test.js.map +1 -1
  85. package/dist/scheduler/cron.d.ts +126 -0
  86. package/dist/scheduler/cron.d.ts.map +1 -0
  87. package/dist/scheduler/cron.js +390 -0
  88. package/dist/scheduler/cron.js.map +1 -0
  89. package/dist/scheduler/errors.d.ts +81 -1
  90. package/dist/scheduler/errors.d.ts.map +1 -1
  91. package/dist/scheduler/errors.js +81 -6
  92. package/dist/scheduler/errors.js.map +1 -1
  93. package/dist/scheduler/index.d.ts +1 -0
  94. package/dist/scheduler/index.d.ts.map +1 -1
  95. package/dist/scheduler/index.js +2 -0
  96. package/dist/scheduler/index.js.map +1 -1
  97. package/dist/scheduler/schedule-runner.d.ts +2 -2
  98. package/dist/scheduler/schedule-runner.d.ts.map +1 -1
  99. package/dist/scheduler/schedule-runner.js +20 -8
  100. package/dist/scheduler/schedule-runner.js.map +1 -1
  101. package/dist/scheduler/scheduler.d.ts +4 -4
  102. package/dist/scheduler/scheduler.d.ts.map +1 -1
  103. package/dist/scheduler/scheduler.js +86 -20
  104. package/dist/scheduler/scheduler.js.map +1 -1
  105. package/dist/scheduler/types.d.ts +1 -1
  106. package/dist/scheduler/types.d.ts.map +1 -1
  107. package/dist/state/schemas/job-metadata.d.ts +2 -2
  108. package/package.json +33 -8
  109. package/.turbo/turbo-build.log +0 -4
  110. package/.turbo/turbo-test.log +0 -219
  111. package/.turbo/turbo-typecheck.log +0 -4
  112. package/coverage/base.css +0 -224
  113. package/coverage/block-navigation.js +0 -87
  114. package/coverage/coverage-final.json +0 -51
  115. package/coverage/favicon.png +0 -0
  116. package/coverage/index.html +0 -251
  117. package/coverage/prettify.css +0 -1
  118. package/coverage/prettify.js +0 -2
  119. package/coverage/sort-arrow-sprite.png +0 -0
  120. package/coverage/sorter.js +0 -210
  121. package/coverage/src/config/index.html +0 -191
  122. package/coverage/src/config/index.ts.html +0 -442
  123. package/coverage/src/config/interpolate.ts.html +0 -652
  124. package/coverage/src/config/loader.ts.html +0 -1501
  125. package/coverage/src/config/merge.ts.html +0 -823
  126. package/coverage/src/config/parser.ts.html +0 -1213
  127. package/coverage/src/config/schema.ts.html +0 -1123
  128. package/coverage/src/fleet-manager/errors.ts.html +0 -2326
  129. package/coverage/src/fleet-manager/event-types.ts.html +0 -1219
  130. package/coverage/src/fleet-manager/fleet-manager.ts.html +0 -7030
  131. package/coverage/src/fleet-manager/index.html +0 -206
  132. package/coverage/src/fleet-manager/index.ts.html +0 -469
  133. package/coverage/src/fleet-manager/job-manager.ts.html +0 -2074
  134. package/coverage/src/fleet-manager/job-queue.ts.html +0 -2479
  135. package/coverage/src/fleet-manager/types.ts.html +0 -2602
  136. package/coverage/src/index.html +0 -116
  137. package/coverage/src/index.ts.html +0 -181
  138. package/coverage/src/runner/errors.ts.html +0 -1006
  139. package/coverage/src/runner/index.html +0 -191
  140. package/coverage/src/runner/index.ts.html +0 -256
  141. package/coverage/src/runner/job-executor.ts.html +0 -1429
  142. package/coverage/src/runner/message-processor.ts.html +0 -1150
  143. package/coverage/src/runner/sdk-adapter.ts.html +0 -658
  144. package/coverage/src/runner/types.ts.html +0 -559
  145. package/coverage/src/scheduler/errors.ts.html +0 -388
  146. package/coverage/src/scheduler/index.html +0 -206
  147. package/coverage/src/scheduler/index.ts.html +0 -244
  148. package/coverage/src/scheduler/interval.ts.html +0 -652
  149. package/coverage/src/scheduler/schedule-runner.ts.html +0 -1411
  150. package/coverage/src/scheduler/schedule-state.ts.html +0 -718
  151. package/coverage/src/scheduler/scheduler.ts.html +0 -1795
  152. package/coverage/src/scheduler/types.ts.html +0 -733
  153. package/coverage/src/state/directory.ts.html +0 -736
  154. package/coverage/src/state/errors.ts.html +0 -376
  155. package/coverage/src/state/fleet-state.ts.html +0 -937
  156. package/coverage/src/state/index.html +0 -221
  157. package/coverage/src/state/index.ts.html +0 -322
  158. package/coverage/src/state/job-metadata.ts.html +0 -1420
  159. package/coverage/src/state/job-output.ts.html +0 -1033
  160. package/coverage/src/state/schemas/fleet-state.ts.html +0 -445
  161. package/coverage/src/state/schemas/index.html +0 -176
  162. package/coverage/src/state/schemas/index.ts.html +0 -286
  163. package/coverage/src/state/schemas/job-metadata.ts.html +0 -628
  164. package/coverage/src/state/schemas/job-output.ts.html +0 -616
  165. package/coverage/src/state/schemas/session-info.ts.html +0 -361
  166. package/coverage/src/state/session.ts.html +0 -844
  167. package/coverage/src/state/types.ts.html +0 -262
  168. package/coverage/src/state/utils/atomic.ts.html +0 -748
  169. package/coverage/src/state/utils/index.html +0 -146
  170. package/coverage/src/state/utils/index.ts.html +0 -103
  171. package/coverage/src/state/utils/reads.ts.html +0 -1621
  172. package/coverage/src/work-sources/adapters/github.ts.html +0 -3583
  173. package/coverage/src/work-sources/adapters/index.html +0 -131
  174. package/coverage/src/work-sources/adapters/index.ts.html +0 -277
  175. package/coverage/src/work-sources/errors.ts.html +0 -298
  176. package/coverage/src/work-sources/index.html +0 -176
  177. package/coverage/src/work-sources/index.ts.html +0 -529
  178. package/coverage/src/work-sources/manager.ts.html +0 -1324
  179. package/coverage/src/work-sources/registry.ts.html +0 -619
  180. package/coverage/src/work-sources/types.ts.html +0 -568
  181. package/dist/fleet-manager/__tests__/event-helpers.test.d.ts +0 -7
  182. package/dist/fleet-manager/__tests__/event-helpers.test.d.ts.map +0 -1
  183. package/dist/fleet-manager/__tests__/event-helpers.test.js +0 -368
  184. package/dist/fleet-manager/__tests__/event-helpers.test.js.map +0 -1
  185. package/src/config/__tests__/agent.test.ts +0 -864
  186. package/src/config/__tests__/interpolate.test.ts +0 -644
  187. package/src/config/__tests__/loader.test.ts +0 -784
  188. package/src/config/__tests__/merge.test.ts +0 -751
  189. package/src/config/__tests__/parser.test.ts +0 -533
  190. package/src/config/__tests__/schema.test.ts +0 -873
  191. package/src/config/index.ts +0 -119
  192. package/src/config/interpolate.ts +0 -189
  193. package/src/config/loader.ts +0 -472
  194. package/src/config/merge.ts +0 -246
  195. package/src/config/parser.ts +0 -376
  196. package/src/config/schema.ts +0 -346
  197. package/src/fleet-manager/__tests__/coverage.test.ts +0 -2869
  198. package/src/fleet-manager/__tests__/errors.test.ts +0 -660
  199. package/src/fleet-manager/__tests__/event-helpers.test.ts +0 -448
  200. package/src/fleet-manager/__tests__/integration.test.ts +0 -1209
  201. package/src/fleet-manager/__tests__/job-control.test.ts +0 -283
  202. package/src/fleet-manager/__tests__/job-manager.test.ts +0 -869
  203. package/src/fleet-manager/__tests__/job-queue.test.ts +0 -401
  204. package/src/fleet-manager/__tests__/reload.test.ts +0 -751
  205. package/src/fleet-manager/__tests__/status-queries.test.ts +0 -595
  206. package/src/fleet-manager/__tests__/trigger.test.ts +0 -601
  207. package/src/fleet-manager/errors.ts +0 -747
  208. package/src/fleet-manager/event-types.ts +0 -378
  209. package/src/fleet-manager/fleet-manager.ts +0 -2315
  210. package/src/fleet-manager/index.ts +0 -128
  211. package/src/fleet-manager/job-manager.ts +0 -663
  212. package/src/fleet-manager/job-queue.ts +0 -798
  213. package/src/fleet-manager/types.ts +0 -839
  214. package/src/index.ts +0 -32
  215. package/src/runner/__tests__/errors.test.ts +0 -382
  216. package/src/runner/__tests__/job-executor.test.ts +0 -1708
  217. package/src/runner/__tests__/message-processor.test.ts +0 -960
  218. package/src/runner/__tests__/sdk-adapter.test.ts +0 -626
  219. package/src/runner/errors.ts +0 -307
  220. package/src/runner/index.ts +0 -57
  221. package/src/runner/job-executor.ts +0 -448
  222. package/src/runner/message-processor.ts +0 -355
  223. package/src/runner/sdk-adapter.ts +0 -191
  224. package/src/runner/types.ts +0 -158
  225. package/src/scheduler/__tests__/errors.test.ts +0 -159
  226. package/src/scheduler/__tests__/interval.test.ts +0 -515
  227. package/src/scheduler/__tests__/schedule-runner.test.ts +0 -798
  228. package/src/scheduler/__tests__/schedule-state.test.ts +0 -671
  229. package/src/scheduler/__tests__/scheduler.test.ts +0 -1280
  230. package/src/scheduler/errors.ts +0 -101
  231. package/src/scheduler/index.ts +0 -53
  232. package/src/scheduler/interval.ts +0 -189
  233. package/src/scheduler/schedule-runner.ts +0 -442
  234. package/src/scheduler/schedule-state.ts +0 -211
  235. package/src/scheduler/scheduler.ts +0 -570
  236. package/src/scheduler/types.ts +0 -216
  237. package/src/state/__tests__/directory.test.ts +0 -595
  238. package/src/state/__tests__/fleet-state.test.ts +0 -868
  239. package/src/state/__tests__/job-metadata-schema.test.ts +0 -414
  240. package/src/state/__tests__/job-metadata.test.ts +0 -831
  241. package/src/state/__tests__/job-output.test.ts +0 -856
  242. package/src/state/__tests__/session-schema.test.ts +0 -378
  243. package/src/state/__tests__/session.test.ts +0 -604
  244. package/src/state/directory.ts +0 -217
  245. package/src/state/errors.ts +0 -97
  246. package/src/state/fleet-state.ts +0 -284
  247. package/src/state/index.ts +0 -79
  248. package/src/state/job-metadata.ts +0 -445
  249. package/src/state/job-output.ts +0 -316
  250. package/src/state/schemas/__tests__/job-output.test.ts +0 -338
  251. package/src/state/schemas/fleet-state.ts +0 -120
  252. package/src/state/schemas/index.ts +0 -67
  253. package/src/state/schemas/job-metadata.ts +0 -181
  254. package/src/state/schemas/job-output.ts +0 -177
  255. package/src/state/schemas/session-info.ts +0 -92
  256. package/src/state/session.ts +0 -253
  257. package/src/state/types.ts +0 -59
  258. package/src/state/utils/__tests__/atomic.test.ts +0 -723
  259. package/src/state/utils/__tests__/reads.test.ts +0 -1071
  260. package/src/state/utils/atomic.ts +0 -221
  261. package/src/state/utils/index.ts +0 -6
  262. package/src/state/utils/reads.ts +0 -512
  263. package/src/work-sources/__tests__/github.test.ts +0 -1800
  264. package/src/work-sources/__tests__/manager.test.ts +0 -529
  265. package/src/work-sources/__tests__/registry.test.ts +0 -477
  266. package/src/work-sources/__tests__/types.test.ts +0 -479
  267. package/src/work-sources/adapters/github.ts +0 -1166
  268. package/src/work-sources/adapters/index.ts +0 -64
  269. package/src/work-sources/errors.ts +0 -71
  270. package/src/work-sources/index.ts +0 -148
  271. package/src/work-sources/manager.ts +0 -413
  272. package/src/work-sources/registry.ts +0 -178
  273. package/src/work-sources/types.ts +0 -161
  274. package/tsconfig.json +0 -9
  275. package/vitest.config.ts +0 -19
@@ -1,960 +0,0 @@
1
- import { describe, it, expect } from "vitest";
2
- import {
3
- processSDKMessage,
4
- isTerminalMessage,
5
- extractSummary,
6
- } from "../message-processor.js";
7
- import type { SDKMessage } from "../types.js";
8
-
9
- // =============================================================================
10
- // processSDKMessage tests
11
- // =============================================================================
12
-
13
- describe("processSDKMessage", () => {
14
- describe("system messages", () => {
15
- it("processes basic system message", () => {
16
- const message: SDKMessage = {
17
- type: "system",
18
- content: "Session initialized",
19
- };
20
-
21
- const result = processSDKMessage(message);
22
-
23
- expect(result.output.type).toBe("system");
24
- if (result.output.type === "system") {
25
- expect(result.output.content).toBe("Session initialized");
26
- }
27
- });
28
-
29
- it("processes system message with subtype", () => {
30
- const message: SDKMessage = {
31
- type: "system",
32
- content: "Session started",
33
- subtype: "session_start",
34
- };
35
-
36
- const result = processSDKMessage(message);
37
-
38
- expect(result.output.type).toBe("system");
39
- if (result.output.type === "system") {
40
- expect(result.output.content).toBe("Session started");
41
- expect(result.output.subtype).toBe("session_start");
42
- }
43
- });
44
-
45
- it("extracts session_id from system message with init subtype", () => {
46
- const message: SDKMessage = {
47
- type: "system",
48
- content: "Initialized",
49
- subtype: "init",
50
- session_id: "session-abc123",
51
- };
52
-
53
- const result = processSDKMessage(message);
54
-
55
- expect(result.sessionId).toBe("session-abc123");
56
- });
57
-
58
- it("does not extract session_id from non-init system messages", () => {
59
- const message: SDKMessage = {
60
- type: "system",
61
- content: "Progress update",
62
- subtype: "progress",
63
- session_id: "session-should-be-ignored",
64
- };
65
-
66
- const result = processSDKMessage(message);
67
-
68
- expect(result.sessionId).toBeUndefined();
69
- });
70
-
71
- it("does not extract session_id from system message without subtype", () => {
72
- const message: SDKMessage = {
73
- type: "system",
74
- content: "Some message",
75
- session_id: "session-should-be-ignored",
76
- };
77
-
78
- const result = processSDKMessage(message);
79
-
80
- expect(result.sessionId).toBeUndefined();
81
- });
82
-
83
- it("handles system message without content", () => {
84
- const message: SDKMessage = {
85
- type: "system",
86
- };
87
-
88
- const result = processSDKMessage(message);
89
-
90
- expect(result.output.type).toBe("system");
91
- if (result.output.type === "system") {
92
- expect(result.output.content).toBeUndefined();
93
- }
94
- });
95
- });
96
-
97
- describe("assistant messages", () => {
98
- it("processes basic assistant message", () => {
99
- const message: SDKMessage = {
100
- type: "assistant",
101
- content: "Hello, world!",
102
- };
103
-
104
- const result = processSDKMessage(message);
105
-
106
- expect(result.output.type).toBe("assistant");
107
- if (result.output.type === "assistant") {
108
- expect(result.output.content).toBe("Hello, world!");
109
- }
110
- });
111
-
112
- it("processes partial assistant message", () => {
113
- const message: SDKMessage = {
114
- type: "assistant",
115
- content: "Partial...",
116
- partial: true,
117
- };
118
-
119
- const result = processSDKMessage(message);
120
-
121
- if (result.output.type === "assistant") {
122
- expect(result.output.content).toBe("Partial...");
123
- expect(result.output.partial).toBe(true);
124
- }
125
- });
126
-
127
- it("processes assistant message with usage info", () => {
128
- const message: SDKMessage = {
129
- type: "assistant",
130
- content: "Response",
131
- usage: {
132
- input_tokens: 100,
133
- output_tokens: 50,
134
- },
135
- };
136
-
137
- const result = processSDKMessage(message);
138
-
139
- if (result.output.type === "assistant") {
140
- expect(result.output.usage?.input_tokens).toBe(100);
141
- expect(result.output.usage?.output_tokens).toBe(50);
142
- }
143
- });
144
-
145
- it("handles assistant message without content", () => {
146
- const message: SDKMessage = {
147
- type: "assistant",
148
- };
149
-
150
- const result = processSDKMessage(message);
151
-
152
- expect(result.output.type).toBe("assistant");
153
- if (result.output.type === "assistant") {
154
- expect(result.output.content).toBeUndefined();
155
- }
156
- });
157
-
158
- it("handles partial usage info", () => {
159
- const message: SDKMessage = {
160
- type: "assistant",
161
- content: "Response",
162
- usage: {
163
- input_tokens: 100,
164
- },
165
- };
166
-
167
- const result = processSDKMessage(message);
168
-
169
- if (result.output.type === "assistant") {
170
- expect(result.output.usage?.input_tokens).toBe(100);
171
- expect(result.output.usage?.output_tokens).toBeUndefined();
172
- }
173
- });
174
- });
175
-
176
- describe("tool_use messages", () => {
177
- it("processes basic tool_use message", () => {
178
- const message: SDKMessage = {
179
- type: "tool_use",
180
- tool_name: "read_file",
181
- tool_use_id: "tool-123",
182
- input: { path: "/etc/hosts" },
183
- };
184
-
185
- const result = processSDKMessage(message);
186
-
187
- expect(result.output.type).toBe("tool_use");
188
- if (result.output.type === "tool_use") {
189
- expect(result.output.tool_name).toBe("read_file");
190
- expect(result.output.tool_use_id).toBe("tool-123");
191
- expect(result.output.input).toEqual({ path: "/etc/hosts" });
192
- }
193
- });
194
-
195
- it("handles tool_use with name field instead of tool_name", () => {
196
- const message: SDKMessage = {
197
- type: "tool_use",
198
- name: "bash",
199
- tool_use_id: "tool-456",
200
- input: { command: "ls -la" },
201
- };
202
-
203
- const result = processSDKMessage(message);
204
-
205
- if (result.output.type === "tool_use") {
206
- expect(result.output.tool_name).toBe("bash");
207
- }
208
- });
209
-
210
- it("handles tool_use without tool_name (uses unknown)", () => {
211
- const message: SDKMessage = {
212
- type: "tool_use",
213
- tool_use_id: "tool-789",
214
- input: {},
215
- };
216
-
217
- const result = processSDKMessage(message);
218
-
219
- if (result.output.type === "tool_use") {
220
- expect(result.output.tool_name).toBe("unknown");
221
- }
222
- });
223
-
224
- it("handles tool_use without tool_use_id", () => {
225
- const message: SDKMessage = {
226
- type: "tool_use",
227
- tool_name: "read_file",
228
- input: { path: "/tmp/test" },
229
- };
230
-
231
- const result = processSDKMessage(message);
232
-
233
- if (result.output.type === "tool_use") {
234
- expect(result.output.tool_use_id).toBeUndefined();
235
- }
236
- });
237
-
238
- it("handles tool_use with complex input", () => {
239
- const message: SDKMessage = {
240
- type: "tool_use",
241
- tool_name: "edit_file",
242
- tool_use_id: "tool-edit",
243
- input: {
244
- path: "/src/index.ts",
245
- changes: [
246
- { line: 10, action: "replace", content: "new content" },
247
- { line: 20, action: "delete" },
248
- ],
249
- },
250
- };
251
-
252
- const result = processSDKMessage(message);
253
-
254
- if (result.output.type === "tool_use") {
255
- expect(result.output.input).toEqual({
256
- path: "/src/index.ts",
257
- changes: [
258
- { line: 10, action: "replace", content: "new content" },
259
- { line: 20, action: "delete" },
260
- ],
261
- });
262
- }
263
- });
264
- });
265
-
266
- describe("tool_result messages", () => {
267
- it("processes successful tool_result message", () => {
268
- const message: SDKMessage = {
269
- type: "tool_result",
270
- tool_use_id: "tool-123",
271
- result: "127.0.0.1 localhost",
272
- success: true,
273
- };
274
-
275
- const result = processSDKMessage(message);
276
-
277
- expect(result.output.type).toBe("tool_result");
278
- if (result.output.type === "tool_result") {
279
- expect(result.output.tool_use_id).toBe("tool-123");
280
- expect(result.output.result).toBe("127.0.0.1 localhost");
281
- expect(result.output.success).toBe(true);
282
- }
283
- });
284
-
285
- it("processes failed tool_result message", () => {
286
- const message: SDKMessage = {
287
- type: "tool_result",
288
- tool_use_id: "tool-456",
289
- success: false,
290
- error: "File not found: /nonexistent",
291
- };
292
-
293
- const result = processSDKMessage(message);
294
-
295
- if (result.output.type === "tool_result") {
296
- expect(result.output.success).toBe(false);
297
- expect(result.output.error).toBe("File not found: /nonexistent");
298
- }
299
- });
300
-
301
- it("handles tool_result with complex result", () => {
302
- const message: SDKMessage = {
303
- type: "tool_result",
304
- tool_use_id: "tool-789",
305
- result: { files: ["a.txt", "b.txt"], count: 2 },
306
- success: true,
307
- };
308
-
309
- const result = processSDKMessage(message);
310
-
311
- if (result.output.type === "tool_result") {
312
- expect(result.output.result).toEqual({ files: ["a.txt", "b.txt"], count: 2 });
313
- }
314
- });
315
-
316
- it("handles tool_result without optional fields", () => {
317
- const message: SDKMessage = {
318
- type: "tool_result",
319
- };
320
-
321
- const result = processSDKMessage(message);
322
-
323
- expect(result.output.type).toBe("tool_result");
324
- if (result.output.type === "tool_result") {
325
- expect(result.output.tool_use_id).toBeUndefined();
326
- expect(result.output.result).toBeUndefined();
327
- expect(result.output.success).toBeUndefined();
328
- }
329
- });
330
- });
331
-
332
- describe("error messages", () => {
333
- it("processes basic error message", () => {
334
- const message: SDKMessage = {
335
- type: "error",
336
- message: "Something went wrong",
337
- };
338
-
339
- const result = processSDKMessage(message);
340
-
341
- expect(result.output.type).toBe("error");
342
- if (result.output.type === "error") {
343
- expect(result.output.message).toBe("Something went wrong");
344
- }
345
- expect(result.isFinal).toBe(true);
346
- });
347
-
348
- it("processes error message with code", () => {
349
- const message: SDKMessage = {
350
- type: "error",
351
- message: "Connection timeout",
352
- code: "ETIMEDOUT",
353
- };
354
-
355
- const result = processSDKMessage(message);
356
-
357
- if (result.output.type === "error") {
358
- expect(result.output.message).toBe("Connection timeout");
359
- expect(result.output.code).toBe("ETIMEDOUT");
360
- }
361
- });
362
-
363
- it("processes error message with stack trace", () => {
364
- const message: SDKMessage = {
365
- type: "error",
366
- message: "Unexpected error",
367
- code: "ERR_UNKNOWN",
368
- stack: "Error: Unexpected error\n at foo.ts:10\n at bar.ts:20",
369
- };
370
-
371
- const result = processSDKMessage(message);
372
-
373
- if (result.output.type === "error") {
374
- expect(result.output.stack).toContain("at foo.ts:10");
375
- }
376
- });
377
-
378
- it("handles error message without message field", () => {
379
- const message: SDKMessage = {
380
- type: "error",
381
- };
382
-
383
- const result = processSDKMessage(message);
384
-
385
- if (result.output.type === "error") {
386
- expect(result.output.message).toBe("Unknown error");
387
- }
388
- });
389
- });
390
-
391
- describe("unknown message types", () => {
392
- it("handles unknown message type gracefully", () => {
393
- const message = {
394
- type: "unknown_type",
395
- data: "some data",
396
- } as unknown as SDKMessage;
397
-
398
- const result = processSDKMessage(message);
399
-
400
- expect(result.output.type).toBe("system");
401
- if (result.output.type === "system") {
402
- expect(result.output.content).toContain("Unknown message type");
403
- expect(result.output.subtype).toBe("unknown_type");
404
- }
405
- });
406
- });
407
- });
408
-
409
- // =============================================================================
410
- // isTerminalMessage tests
411
- // =============================================================================
412
-
413
- describe("isTerminalMessage", () => {
414
- it("returns true for error messages", () => {
415
- const message: SDKMessage = {
416
- type: "error",
417
- message: "Failed",
418
- };
419
-
420
- expect(isTerminalMessage(message)).toBe(true);
421
- });
422
-
423
- it("returns true for system message with end subtype", () => {
424
- const message: SDKMessage = {
425
- type: "system",
426
- subtype: "end",
427
- };
428
-
429
- expect(isTerminalMessage(message)).toBe(true);
430
- });
431
-
432
- it("returns true for system message with complete subtype", () => {
433
- const message: SDKMessage = {
434
- type: "system",
435
- subtype: "complete",
436
- };
437
-
438
- expect(isTerminalMessage(message)).toBe(true);
439
- });
440
-
441
- it("returns true for system message with session_end subtype", () => {
442
- const message: SDKMessage = {
443
- type: "system",
444
- subtype: "session_end",
445
- };
446
-
447
- expect(isTerminalMessage(message)).toBe(true);
448
- });
449
-
450
- it("returns false for regular system message", () => {
451
- const message: SDKMessage = {
452
- type: "system",
453
- content: "Progress update",
454
- };
455
-
456
- expect(isTerminalMessage(message)).toBe(false);
457
- });
458
-
459
- it("returns false for assistant message", () => {
460
- const message: SDKMessage = {
461
- type: "assistant",
462
- content: "Hello",
463
- };
464
-
465
- expect(isTerminalMessage(message)).toBe(false);
466
- });
467
-
468
- it("returns false for tool_use message", () => {
469
- const message: SDKMessage = {
470
- type: "tool_use",
471
- tool_name: "read_file",
472
- };
473
-
474
- expect(isTerminalMessage(message)).toBe(false);
475
- });
476
-
477
- it("returns false for tool_result message", () => {
478
- const message: SDKMessage = {
479
- type: "tool_result",
480
- success: true,
481
- };
482
-
483
- expect(isTerminalMessage(message)).toBe(false);
484
- });
485
- });
486
-
487
- // =============================================================================
488
- // extractSummary tests
489
- // =============================================================================
490
-
491
- describe("extractSummary", () => {
492
- it("extracts explicit summary field", () => {
493
- const message: SDKMessage = {
494
- type: "assistant",
495
- content: "Long content here...",
496
- summary: "Brief summary",
497
- };
498
-
499
- expect(extractSummary(message)).toBe("Brief summary");
500
- });
501
-
502
- it("uses short assistant content as summary", () => {
503
- const message: SDKMessage = {
504
- type: "assistant",
505
- content: "Task completed successfully.",
506
- partial: false,
507
- };
508
-
509
- expect(extractSummary(message)).toBe("Task completed successfully.");
510
- });
511
-
512
- it("does not use long assistant content as summary", () => {
513
- const longContent = "x".repeat(501);
514
- const message: SDKMessage = {
515
- type: "assistant",
516
- content: longContent,
517
- partial: false,
518
- };
519
-
520
- expect(extractSummary(message)).toBeUndefined();
521
- });
522
-
523
- it("does not use partial assistant content as summary", () => {
524
- const message: SDKMessage = {
525
- type: "assistant",
526
- content: "Partial content...",
527
- partial: true,
528
- };
529
-
530
- expect(extractSummary(message)).toBeUndefined();
531
- });
532
-
533
- it("returns undefined for non-assistant messages", () => {
534
- const message: SDKMessage = {
535
- type: "system",
536
- content: "System message",
537
- };
538
-
539
- expect(extractSummary(message)).toBeUndefined();
540
- });
541
-
542
- it("returns undefined for assistant message without content", () => {
543
- const message: SDKMessage = {
544
- type: "assistant",
545
- };
546
-
547
- expect(extractSummary(message)).toBeUndefined();
548
- });
549
-
550
- it("prefers explicit summary over content", () => {
551
- const message: SDKMessage = {
552
- type: "assistant",
553
- content: "Short content",
554
- summary: "Explicit summary",
555
- };
556
-
557
- expect(extractSummary(message)).toBe("Explicit summary");
558
- });
559
-
560
- it("handles content at exactly 500 characters", () => {
561
- const content = "x".repeat(500);
562
- const message: SDKMessage = {
563
- type: "assistant",
564
- content,
565
- partial: false,
566
- };
567
-
568
- expect(extractSummary(message)).toBe(content);
569
- });
570
-
571
- it("handles empty summary field", () => {
572
- const message: SDKMessage = {
573
- type: "assistant",
574
- content: "Some content",
575
- summary: "",
576
- };
577
-
578
- // Empty string is falsy, so should fall back to content
579
- expect(extractSummary(message)).toBe("Some content");
580
- });
581
-
582
- it("truncates explicit summary longer than 500 characters", () => {
583
- const longSummary = "x".repeat(600);
584
- const message: SDKMessage = {
585
- type: "assistant",
586
- content: "Some content",
587
- summary: longSummary,
588
- };
589
-
590
- const result = extractSummary(message);
591
- expect(result).toBeDefined();
592
- expect(result!.length).toBe(500);
593
- expect(result!.endsWith("...")).toBe(true);
594
- });
595
-
596
- it("does not truncate explicit summary at exactly 500 characters", () => {
597
- const summary = "x".repeat(500);
598
- const message: SDKMessage = {
599
- type: "assistant",
600
- content: "Some content",
601
- summary,
602
- };
603
-
604
- const result = extractSummary(message);
605
- expect(result).toBe(summary);
606
- expect(result!.length).toBe(500);
607
- expect(result!.endsWith("...")).toBe(false);
608
- });
609
-
610
- it("truncates explicit summary at 501 characters", () => {
611
- const summary = "x".repeat(501);
612
- const message: SDKMessage = {
613
- type: "assistant",
614
- content: "Some content",
615
- summary,
616
- };
617
-
618
- const result = extractSummary(message);
619
- expect(result!.length).toBe(500);
620
- expect(result!.endsWith("...")).toBe(true);
621
- // Should be 497 x's + "..."
622
- expect(result).toBe("x".repeat(497) + "...");
623
- });
624
-
625
- it("converts non-string summary to string", () => {
626
- const message: SDKMessage = {
627
- type: "assistant",
628
- content: "Some content",
629
- summary: 12345 as unknown as string,
630
- };
631
-
632
- const result = extractSummary(message);
633
- expect(result).toBe("12345");
634
- });
635
-
636
- it("returns undefined for tool_use messages", () => {
637
- const message: SDKMessage = {
638
- type: "tool_use",
639
- tool_name: "bash",
640
- input: { command: "ls" },
641
- };
642
-
643
- expect(extractSummary(message)).toBeUndefined();
644
- });
645
-
646
- it("returns undefined for tool_result messages", () => {
647
- const message: SDKMessage = {
648
- type: "tool_result",
649
- tool_use_id: "tool-123",
650
- result: "file1\nfile2",
651
- success: true,
652
- };
653
-
654
- expect(extractSummary(message)).toBeUndefined();
655
- });
656
-
657
- it("returns undefined for error messages", () => {
658
- const message: SDKMessage = {
659
- type: "error",
660
- message: "Something went wrong",
661
- };
662
-
663
- expect(extractSummary(message)).toBeUndefined();
664
- });
665
-
666
- it("handles null message", () => {
667
- expect(extractSummary(null as unknown as SDKMessage)).toBeUndefined();
668
- });
669
-
670
- it("handles undefined message", () => {
671
- expect(extractSummary(undefined as unknown as SDKMessage)).toBeUndefined();
672
- });
673
-
674
- it("handles non-object message", () => {
675
- expect(extractSummary("string" as unknown as SDKMessage)).toBeUndefined();
676
- expect(extractSummary(123 as unknown as SDKMessage)).toBeUndefined();
677
- });
678
- });
679
-
680
- // =============================================================================
681
- // Edge cases and special scenarios
682
- // =============================================================================
683
-
684
- describe("edge cases", () => {
685
- it("handles message with special characters in content", () => {
686
- const message: SDKMessage = {
687
- type: "assistant",
688
- content: 'Content with "quotes", \\backslashes\\, and\nnewlines',
689
- };
690
-
691
- const result = processSDKMessage(message);
692
-
693
- if (result.output.type === "assistant") {
694
- expect(result.output.content).toBe(
695
- 'Content with "quotes", \\backslashes\\, and\nnewlines'
696
- );
697
- }
698
- });
699
-
700
- it("handles message with unicode content", () => {
701
- const message: SDKMessage = {
702
- type: "assistant",
703
- content: "Hello 世界! 🌍 Γεια σου κόσμε",
704
- };
705
-
706
- const result = processSDKMessage(message);
707
-
708
- if (result.output.type === "assistant") {
709
- expect(result.output.content).toBe("Hello 世界! 🌍 Γεια σου κόσμε");
710
- }
711
- });
712
-
713
- it("handles message with empty string content", () => {
714
- const message: SDKMessage = {
715
- type: "assistant",
716
- content: "",
717
- };
718
-
719
- const result = processSDKMessage(message);
720
-
721
- if (result.output.type === "assistant") {
722
- expect(result.output.content).toBe("");
723
- }
724
- });
725
-
726
- it("handles tool_use with null input", () => {
727
- const message: SDKMessage = {
728
- type: "tool_use",
729
- tool_name: "test",
730
- input: null,
731
- };
732
-
733
- const result = processSDKMessage(message);
734
-
735
- if (result.output.type === "tool_use") {
736
- expect(result.output.input).toBeNull();
737
- }
738
- });
739
-
740
- it("handles tool_result with null result", () => {
741
- const message: SDKMessage = {
742
- type: "tool_result",
743
- tool_use_id: "tool-1",
744
- result: null,
745
- success: true,
746
- };
747
-
748
- const result = processSDKMessage(message);
749
-
750
- if (result.output.type === "tool_result") {
751
- expect(result.output.result).toBeNull();
752
- }
753
- });
754
-
755
- it("preserves extra fields in input", () => {
756
- const message: SDKMessage = {
757
- type: "tool_use",
758
- tool_name: "custom",
759
- input: {
760
- standard: "field",
761
- nested: { deeply: { nested: "value" } },
762
- array: [1, 2, 3],
763
- },
764
- };
765
-
766
- const result = processSDKMessage(message);
767
-
768
- if (result.output.type === "tool_use") {
769
- expect(result.output.input).toEqual({
770
- standard: "field",
771
- nested: { deeply: { nested: "value" } },
772
- array: [1, 2, 3],
773
- });
774
- }
775
- });
776
- });
777
-
778
- // =============================================================================
779
- // Malformed response handling tests (US-7)
780
- // =============================================================================
781
-
782
- describe("malformed response handling (US-7)", () => {
783
- describe("null and undefined messages", () => {
784
- it("handles null message gracefully", () => {
785
- const result = processSDKMessage(null as unknown as SDKMessage);
786
-
787
- // Malformed messages are logged as system warnings, not errors,
788
- // to avoid terminating execution
789
- expect(result.output.type).toBe("system");
790
- if (result.output.type === "system") {
791
- expect(result.output.content).toContain("null");
792
- expect(result.output.subtype).toBe("malformed_message");
793
- }
794
- });
795
-
796
- it("handles undefined message gracefully", () => {
797
- const result = processSDKMessage(undefined as unknown as SDKMessage);
798
-
799
- expect(result.output.type).toBe("system");
800
- if (result.output.type === "system") {
801
- expect(result.output.content).toContain("undefined");
802
- expect(result.output.subtype).toBe("malformed_message");
803
- }
804
- });
805
- });
806
-
807
- describe("non-object messages", () => {
808
- it("handles string message", () => {
809
- const result = processSDKMessage("string message" as unknown as SDKMessage);
810
-
811
- expect(result.output.type).toBe("system");
812
- if (result.output.type === "system") {
813
- expect(result.output.content).toContain("string");
814
- expect(result.output.subtype).toBe("malformed_message");
815
- }
816
- });
817
-
818
- it("handles number message", () => {
819
- const result = processSDKMessage(42 as unknown as SDKMessage);
820
-
821
- expect(result.output.type).toBe("system");
822
- if (result.output.type === "system") {
823
- expect(result.output.content).toContain("number");
824
- expect(result.output.subtype).toBe("malformed_message");
825
- }
826
- });
827
-
828
- it("handles array message", () => {
829
- const result = processSDKMessage(["array"] as unknown as SDKMessage);
830
-
831
- // Arrays are objects, so this should be handled differently
832
- expect(result.output.type).toBe("system");
833
- if (result.output.type === "system") {
834
- expect(result.output.subtype).toBe("unknown_type");
835
- }
836
- });
837
- });
838
-
839
- describe("missing type field", () => {
840
- it("handles message without type field", () => {
841
- const message = { content: "No type field" } as unknown as SDKMessage;
842
-
843
- const result = processSDKMessage(message);
844
-
845
- expect(result.output.type).toBe("system");
846
- if (result.output.type === "system") {
847
- expect(result.output.content).toContain("Unknown message type");
848
- expect(result.output.subtype).toBe("unknown_type");
849
- }
850
- });
851
-
852
- it("handles message with null type", () => {
853
- const message = { type: null, content: "Null type" } as unknown as SDKMessage;
854
-
855
- const result = processSDKMessage(message);
856
-
857
- expect(result.output.type).toBe("system");
858
- if (result.output.type === "system") {
859
- expect(result.output.subtype).toBe("unknown_type");
860
- }
861
- });
862
- });
863
-
864
- describe("unexpected type values", () => {
865
- it("handles numeric type value", () => {
866
- const message = { type: 123, content: "Numeric type" } as unknown as SDKMessage;
867
-
868
- const result = processSDKMessage(message);
869
-
870
- expect(result.output.type).toBe("system");
871
- if (result.output.type === "system") {
872
- expect(result.output.content).toContain("123");
873
- expect(result.output.subtype).toBe("unknown_type");
874
- }
875
- });
876
-
877
- it("handles object type value", () => {
878
- const message = { type: { nested: "object" }, content: "Object type" } as unknown as SDKMessage;
879
-
880
- const result = processSDKMessage(message);
881
-
882
- expect(result.output.type).toBe("system");
883
- if (result.output.type === "system") {
884
- expect(result.output.subtype).toBe("unknown_type");
885
- }
886
- });
887
-
888
- it("handles unknown string type value", () => {
889
- const message = { type: "custom_unknown_type", content: "Unknown" } as unknown as SDKMessage;
890
-
891
- const result = processSDKMessage(message);
892
-
893
- expect(result.output.type).toBe("system");
894
- if (result.output.type === "system") {
895
- expect(result.output.content).toContain("custom_unknown_type");
896
- expect(result.output.subtype).toBe("unknown_type");
897
- }
898
- });
899
- });
900
-
901
- describe("empty object messages", () => {
902
- it("handles empty object message", () => {
903
- const message = {} as unknown as SDKMessage;
904
-
905
- const result = processSDKMessage(message);
906
-
907
- expect(result.output.type).toBe("system");
908
- if (result.output.type === "system") {
909
- expect(result.output.subtype).toBe("unknown_type");
910
- }
911
- });
912
- });
913
-
914
- describe("valid messages still work", () => {
915
- it("processes valid system message after malformed handling", () => {
916
- const message: SDKMessage = {
917
- type: "system",
918
- content: "Valid system message",
919
- subtype: "init",
920
- session_id: "session-123",
921
- };
922
-
923
- const result = processSDKMessage(message);
924
-
925
- expect(result.output.type).toBe("system");
926
- expect(result.sessionId).toBe("session-123");
927
- });
928
-
929
- it("processes valid assistant message after malformed handling", () => {
930
- const message: SDKMessage = {
931
- type: "assistant",
932
- content: "Valid assistant response",
933
- };
934
-
935
- const result = processSDKMessage(message);
936
-
937
- expect(result.output.type).toBe("assistant");
938
- if (result.output.type === "assistant") {
939
- expect(result.output.content).toBe("Valid assistant response");
940
- }
941
- });
942
-
943
- it("processes valid error message after malformed handling", () => {
944
- const message: SDKMessage = {
945
- type: "error",
946
- message: "Valid error message",
947
- code: "VALID_ERROR",
948
- };
949
-
950
- const result = processSDKMessage(message);
951
-
952
- expect(result.output.type).toBe("error");
953
- if (result.output.type === "error") {
954
- expect(result.output.message).toBe("Valid error message");
955
- expect(result.output.code).toBe("VALID_ERROR");
956
- }
957
- expect(result.isFinal).toBe(true);
958
- });
959
- });
960
- });