@opencode-ai/sdk 0.1.0-alpha.2 → 0.1.0-alpha.20

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 (300) hide show
  1. package/CHANGELOG.md +173 -0
  2. package/LICENSE +198 -4
  3. package/README.md +27 -9
  4. package/client.d.mts +25 -53
  5. package/client.d.mts.map +1 -1
  6. package/client.d.ts +25 -53
  7. package/client.d.ts.map +1 -1
  8. package/client.js +25 -55
  9. package/client.js.map +1 -1
  10. package/client.mjs +25 -55
  11. package/client.mjs.map +1 -1
  12. package/core/streaming.d.mts +33 -0
  13. package/core/streaming.d.mts.map +1 -0
  14. package/core/streaming.d.ts +33 -0
  15. package/core/streaming.d.ts.map +1 -0
  16. package/core/streaming.js +263 -0
  17. package/core/streaming.js.map +1 -0
  18. package/core/streaming.mjs +258 -0
  19. package/core/streaming.mjs.map +1 -0
  20. package/internal/decoders/line.d.mts +17 -0
  21. package/internal/decoders/line.d.mts.map +1 -0
  22. package/internal/decoders/line.d.ts +17 -0
  23. package/internal/decoders/line.d.ts.map +1 -0
  24. package/internal/decoders/line.js +113 -0
  25. package/internal/decoders/line.js.map +1 -0
  26. package/internal/decoders/line.mjs +108 -0
  27. package/internal/decoders/line.mjs.map +1 -0
  28. package/internal/parse.d.mts.map +1 -1
  29. package/internal/parse.d.ts.map +1 -1
  30. package/internal/parse.js +10 -0
  31. package/internal/parse.js.map +1 -1
  32. package/internal/parse.mjs +10 -0
  33. package/internal/parse.mjs.map +1 -1
  34. package/internal/request-options.d.mts +44 -0
  35. package/internal/request-options.d.mts.map +1 -1
  36. package/internal/request-options.d.ts +44 -0
  37. package/internal/request-options.d.ts.map +1 -1
  38. package/internal/request-options.js.map +1 -1
  39. package/internal/request-options.mjs.map +1 -1
  40. package/internal/tslib.js +6 -6
  41. package/internal/types.d.mts +8 -6
  42. package/internal/types.d.mts.map +1 -1
  43. package/internal/types.d.ts +8 -6
  44. package/internal/types.d.ts.map +1 -1
  45. package/internal/uploads.js +1 -1
  46. package/internal/uploads.js.map +1 -1
  47. package/internal/uploads.mjs +1 -1
  48. package/internal/uploads.mjs.map +1 -1
  49. package/internal/utils/log.js +1 -1
  50. package/internal/utils/log.js.map +1 -1
  51. package/internal/utils/log.mjs +1 -1
  52. package/internal/utils/log.mjs.map +1 -1
  53. package/internal/utils/path.d.mts.map +1 -1
  54. package/internal/utils/path.d.ts.map +1 -1
  55. package/internal/utils/path.js +26 -5
  56. package/internal/utils/path.js.map +1 -1
  57. package/internal/utils/path.mjs +26 -5
  58. package/internal/utils/path.mjs.map +1 -1
  59. package/package.json +13 -3
  60. package/resources/app.d.mts +130 -0
  61. package/resources/app.d.mts.map +1 -0
  62. package/resources/app.d.ts +130 -0
  63. package/resources/app.d.ts.map +1 -0
  64. package/resources/app.js +39 -0
  65. package/resources/app.js.map +1 -0
  66. package/resources/app.mjs +35 -0
  67. package/resources/app.mjs.map +1 -0
  68. package/resources/config.d.mts +344 -0
  69. package/resources/config.d.mts.map +1 -0
  70. package/resources/config.d.ts +344 -0
  71. package/resources/config.d.ts.map +1 -0
  72. package/resources/{config-get.js → config.js} +6 -6
  73. package/resources/config.js.map +1 -0
  74. package/resources/{config-get.mjs → config.mjs} +4 -4
  75. package/resources/config.mjs.map +1 -0
  76. package/resources/event.d.mts +82 -29
  77. package/resources/event.d.mts.map +1 -1
  78. package/resources/event.d.ts +82 -29
  79. package/resources/event.d.ts.map +1 -1
  80. package/resources/event.js +1 -1
  81. package/resources/event.js.map +1 -1
  82. package/resources/event.mjs +1 -1
  83. package/resources/event.mjs.map +1 -1
  84. package/resources/file.d.mts +31 -0
  85. package/resources/file.d.mts.map +1 -0
  86. package/resources/file.d.ts +31 -0
  87. package/resources/file.d.ts.map +1 -0
  88. package/resources/file.js +21 -0
  89. package/resources/file.js.map +1 -0
  90. package/resources/file.mjs +17 -0
  91. package/resources/file.mjs.map +1 -0
  92. package/resources/find.d.mts +85 -0
  93. package/resources/find.d.mts.map +1 -0
  94. package/resources/find.d.ts +85 -0
  95. package/resources/find.d.ts.map +1 -0
  96. package/resources/find.js +27 -0
  97. package/resources/find.js.map +1 -0
  98. package/resources/find.mjs +23 -0
  99. package/resources/find.mjs.map +1 -0
  100. package/resources/index.d.mts +6 -16
  101. package/resources/index.d.mts.map +1 -1
  102. package/resources/index.d.ts +6 -16
  103. package/resources/index.d.ts.map +1 -1
  104. package/resources/index.js +13 -33
  105. package/resources/index.js.map +1 -1
  106. package/resources/index.mjs +6 -16
  107. package/resources/index.mjs.map +1 -1
  108. package/resources/session.d.mts +272 -0
  109. package/resources/session.d.mts.map +1 -0
  110. package/resources/session.d.ts +272 -0
  111. package/resources/session.d.ts.map +1 -0
  112. package/resources/session.js +70 -0
  113. package/resources/session.js.map +1 -0
  114. package/resources/session.mjs +66 -0
  115. package/resources/session.mjs.map +1 -0
  116. package/resources/shared.d.mts +24 -0
  117. package/resources/shared.d.mts.map +1 -0
  118. package/resources/shared.d.ts +24 -0
  119. package/resources/shared.d.ts.map +1 -0
  120. package/resources/shared.js +4 -0
  121. package/resources/shared.js.map +1 -0
  122. package/resources/shared.mjs +3 -0
  123. package/resources/shared.mjs.map +1 -0
  124. package/src/client.ts +145 -128
  125. package/src/core/streaming.ts +315 -0
  126. package/src/internal/decoders/line.ts +135 -0
  127. package/src/internal/parse.ts +14 -0
  128. package/src/internal/request-options.ts +55 -0
  129. package/src/internal/types.ts +9 -6
  130. package/src/internal/uploads.ts +1 -1
  131. package/src/internal/utils/log.ts +1 -1
  132. package/src/internal/utils/path.ts +32 -7
  133. package/src/resources/app.ts +196 -0
  134. package/src/resources/config.ts +431 -0
  135. package/src/resources/event.ts +119 -39
  136. package/src/resources/file.ts +52 -0
  137. package/src/resources/find.ts +133 -0
  138. package/src/resources/index.ts +65 -32
  139. package/src/resources/session.ts +457 -0
  140. package/src/resources/shared.ts +33 -0
  141. package/src/streaming.ts +2 -0
  142. package/src/version.ts +1 -1
  143. package/streaming.d.mts +2 -0
  144. package/streaming.d.mts.map +1 -0
  145. package/streaming.d.ts +2 -0
  146. package/streaming.d.ts.map +1 -0
  147. package/streaming.js +6 -0
  148. package/streaming.js.map +1 -0
  149. package/streaming.mjs +2 -0
  150. package/streaming.mjs.map +1 -0
  151. package/version.d.mts +1 -1
  152. package/version.d.mts.map +1 -1
  153. package/version.d.ts +1 -1
  154. package/version.d.ts.map +1 -1
  155. package/version.js +1 -1
  156. package/version.js.map +1 -1
  157. package/version.mjs +1 -1
  158. package/version.mjs.map +1 -1
  159. package/resources/app-info.d.mts +0 -31
  160. package/resources/app-info.d.mts.map +0 -1
  161. package/resources/app-info.d.ts +0 -31
  162. package/resources/app-info.d.ts.map +0 -1
  163. package/resources/app-info.js +0 -15
  164. package/resources/app-info.js.map +0 -1
  165. package/resources/app-info.mjs +0 -11
  166. package/resources/app-info.mjs.map +0 -1
  167. package/resources/app-initialize.d.mts +0 -14
  168. package/resources/app-initialize.d.mts.map +0 -1
  169. package/resources/app-initialize.d.ts +0 -14
  170. package/resources/app-initialize.d.ts.map +0 -1
  171. package/resources/app-initialize.js +0 -15
  172. package/resources/app-initialize.js.map +0 -1
  173. package/resources/app-initialize.mjs +0 -11
  174. package/resources/app-initialize.mjs.map +0 -1
  175. package/resources/config-get.d.mts +0 -236
  176. package/resources/config-get.d.mts.map +0 -1
  177. package/resources/config-get.d.ts +0 -236
  178. package/resources/config-get.d.ts.map +0 -1
  179. package/resources/config-get.js.map +0 -1
  180. package/resources/config-get.mjs.map +0 -1
  181. package/resources/file-search.d.mts +0 -17
  182. package/resources/file-search.d.mts.map +0 -1
  183. package/resources/file-search.d.ts +0 -17
  184. package/resources/file-search.d.ts.map +0 -1
  185. package/resources/file-search.js +0 -15
  186. package/resources/file-search.js.map +0 -1
  187. package/resources/file-search.mjs +0 -11
  188. package/resources/file-search.mjs.map +0 -1
  189. package/resources/installation-info.d.mts +0 -17
  190. package/resources/installation-info.d.mts.map +0 -1
  191. package/resources/installation-info.d.ts +0 -17
  192. package/resources/installation-info.d.ts.map +0 -1
  193. package/resources/installation-info.js +0 -15
  194. package/resources/installation-info.js.map +0 -1
  195. package/resources/installation-info.mjs +0 -11
  196. package/resources/installation-info.mjs.map +0 -1
  197. package/resources/path-get.d.mts +0 -19
  198. package/resources/path-get.d.mts.map +0 -1
  199. package/resources/path-get.d.ts +0 -19
  200. package/resources/path-get.d.ts.map +0 -1
  201. package/resources/path-get.js +0 -15
  202. package/resources/path-get.js.map +0 -1
  203. package/resources/path-get.mjs +0 -11
  204. package/resources/path-get.mjs.map +0 -1
  205. package/resources/provider-list.d.mts +0 -58
  206. package/resources/provider-list.d.mts.map +0 -1
  207. package/resources/provider-list.d.ts +0 -58
  208. package/resources/provider-list.d.ts.map +0 -1
  209. package/resources/provider-list.js +0 -15
  210. package/resources/provider-list.js.map +0 -1
  211. package/resources/provider-list.mjs +0 -11
  212. package/resources/provider-list.mjs.map +0 -1
  213. package/resources/session-abort.d.mts +0 -17
  214. package/resources/session-abort.d.mts.map +0 -1
  215. package/resources/session-abort.d.ts +0 -17
  216. package/resources/session-abort.d.ts.map +0 -1
  217. package/resources/session-abort.js +0 -15
  218. package/resources/session-abort.js.map +0 -1
  219. package/resources/session-abort.mjs +0 -11
  220. package/resources/session-abort.mjs.map +0 -1
  221. package/resources/session-chat.d.mts +0 -160
  222. package/resources/session-chat.d.mts.map +0 -1
  223. package/resources/session-chat.d.ts +0 -160
  224. package/resources/session-chat.d.ts.map +0 -1
  225. package/resources/session-chat.js +0 -15
  226. package/resources/session-chat.js.map +0 -1
  227. package/resources/session-chat.mjs +0 -11
  228. package/resources/session-chat.mjs.map +0 -1
  229. package/resources/session-create.d.mts +0 -30
  230. package/resources/session-create.d.mts.map +0 -1
  231. package/resources/session-create.d.ts +0 -30
  232. package/resources/session-create.d.ts.map +0 -1
  233. package/resources/session-create.js +0 -15
  234. package/resources/session-create.js.map +0 -1
  235. package/resources/session-create.mjs +0 -11
  236. package/resources/session-create.mjs.map +0 -1
  237. package/resources/session-initialize.d.mts +0 -19
  238. package/resources/session-initialize.d.mts.map +0 -1
  239. package/resources/session-initialize.d.ts +0 -19
  240. package/resources/session-initialize.d.ts.map +0 -1
  241. package/resources/session-initialize.js +0 -15
  242. package/resources/session-initialize.js.map +0 -1
  243. package/resources/session-initialize.mjs +0 -11
  244. package/resources/session-initialize.mjs.map +0 -1
  245. package/resources/session-list.d.mts +0 -15
  246. package/resources/session-list.d.mts.map +0 -1
  247. package/resources/session-list.d.ts +0 -15
  248. package/resources/session-list.d.ts.map +0 -1
  249. package/resources/session-list.js +0 -15
  250. package/resources/session-list.js.map +0 -1
  251. package/resources/session-list.mjs +0 -11
  252. package/resources/session-list.mjs.map +0 -1
  253. package/resources/session-messages.d.mts +0 -18
  254. package/resources/session-messages.d.mts.map +0 -1
  255. package/resources/session-messages.d.ts +0 -18
  256. package/resources/session-messages.d.ts.map +0 -1
  257. package/resources/session-messages.js +0 -15
  258. package/resources/session-messages.js.map +0 -1
  259. package/resources/session-messages.mjs +0 -11
  260. package/resources/session-messages.mjs.map +0 -1
  261. package/resources/session-share.d.mts +0 -17
  262. package/resources/session-share.d.mts.map +0 -1
  263. package/resources/session-share.d.ts +0 -17
  264. package/resources/session-share.d.ts.map +0 -1
  265. package/resources/session-share.js +0 -15
  266. package/resources/session-share.js.map +0 -1
  267. package/resources/session-share.mjs +0 -11
  268. package/resources/session-share.mjs.map +0 -1
  269. package/resources/session-summarize.d.mts +0 -19
  270. package/resources/session-summarize.d.mts.map +0 -1
  271. package/resources/session-summarize.d.ts +0 -19
  272. package/resources/session-summarize.d.ts.map +0 -1
  273. package/resources/session-summarize.js +0 -15
  274. package/resources/session-summarize.js.map +0 -1
  275. package/resources/session-summarize.mjs +0 -11
  276. package/resources/session-summarize.mjs.map +0 -1
  277. package/resources/session-unshare.d.mts +0 -17
  278. package/resources/session-unshare.d.mts.map +0 -1
  279. package/resources/session-unshare.d.ts +0 -17
  280. package/resources/session-unshare.d.ts.map +0 -1
  281. package/resources/session-unshare.js +0 -15
  282. package/resources/session-unshare.js.map +0 -1
  283. package/resources/session-unshare.mjs +0 -11
  284. package/resources/session-unshare.mjs.map +0 -1
  285. package/src/resources/app-info.ts +0 -46
  286. package/src/resources/app-initialize.ts +0 -20
  287. package/src/resources/config-get.ts +0 -294
  288. package/src/resources/file-search.ts +0 -27
  289. package/src/resources/installation-info.ts +0 -24
  290. package/src/resources/path-get.ts +0 -28
  291. package/src/resources/provider-list.ts +0 -80
  292. package/src/resources/session-abort.ts +0 -27
  293. package/src/resources/session-chat.ts +0 -250
  294. package/src/resources/session-create.ts +0 -44
  295. package/src/resources/session-initialize.ts +0 -34
  296. package/src/resources/session-list.ts +0 -21
  297. package/src/resources/session-messages.ts +0 -31
  298. package/src/resources/session-share.ts +0 -23
  299. package/src/resources/session-summarize.ts +0 -34
  300. package/src/resources/session-unshare.ts +0 -26
@@ -0,0 +1,315 @@
1
+ import { OpencodeError } from './error';
2
+ import { type ReadableStream } from '../internal/shim-types';
3
+ import { makeReadableStream } from '../internal/shims';
4
+ import { findDoubleNewlineIndex, LineDecoder } from '../internal/decoders/line';
5
+ import { ReadableStreamToAsyncIterable } from '../internal/shims';
6
+ import { isAbortError } from '../internal/errors';
7
+ import { encodeUTF8 } from '../internal/utils/bytes';
8
+ import { loggerFor } from '../internal/utils/log';
9
+ import type { Opencode } from '../client';
10
+
11
+ type Bytes = string | ArrayBuffer | Uint8Array | null | undefined;
12
+
13
+ export type ServerSentEvent = {
14
+ event: string | null;
15
+ data: string;
16
+ raw: string[];
17
+ };
18
+
19
+ export class Stream<Item> implements AsyncIterable<Item> {
20
+ controller: AbortController;
21
+ #client: Opencode | undefined;
22
+
23
+ constructor(
24
+ private iterator: () => AsyncIterator<Item>,
25
+ controller: AbortController,
26
+ client?: Opencode,
27
+ ) {
28
+ this.controller = controller;
29
+ this.#client = client;
30
+ }
31
+
32
+ static fromSSEResponse<Item>(
33
+ response: Response,
34
+ controller: AbortController,
35
+ client?: Opencode,
36
+ ): Stream<Item> {
37
+ let consumed = false;
38
+ const logger = client ? loggerFor(client) : console;
39
+
40
+ async function* iterator(): AsyncIterator<Item, any, undefined> {
41
+ if (consumed) {
42
+ throw new OpencodeError('Cannot iterate over a consumed stream, use `.tee()` to split the stream.');
43
+ }
44
+ consumed = true;
45
+ let done = false;
46
+ try {
47
+ for await (const sse of _iterSSEMessages(response, controller)) {
48
+ try {
49
+ yield JSON.parse(sse.data);
50
+ } catch (e) {
51
+ logger.error(`Could not parse message into JSON:`, sse.data);
52
+ logger.error(`From chunk:`, sse.raw);
53
+ throw e;
54
+ }
55
+ }
56
+ done = true;
57
+ } catch (e) {
58
+ // If the user calls `stream.controller.abort()`, we should exit without throwing.
59
+ if (isAbortError(e)) return;
60
+ throw e;
61
+ } finally {
62
+ // If the user `break`s, abort the ongoing request.
63
+ if (!done) controller.abort();
64
+ }
65
+ }
66
+
67
+ return new Stream(iterator, controller, client);
68
+ }
69
+
70
+ /**
71
+ * Generates a Stream from a newline-separated ReadableStream
72
+ * where each item is a JSON value.
73
+ */
74
+ static fromReadableStream<Item>(
75
+ readableStream: ReadableStream,
76
+ controller: AbortController,
77
+ client?: Opencode,
78
+ ): Stream<Item> {
79
+ let consumed = false;
80
+
81
+ async function* iterLines(): AsyncGenerator<string, void, unknown> {
82
+ const lineDecoder = new LineDecoder();
83
+
84
+ const iter = ReadableStreamToAsyncIterable<Bytes>(readableStream);
85
+ for await (const chunk of iter) {
86
+ for (const line of lineDecoder.decode(chunk)) {
87
+ yield line;
88
+ }
89
+ }
90
+
91
+ for (const line of lineDecoder.flush()) {
92
+ yield line;
93
+ }
94
+ }
95
+
96
+ async function* iterator(): AsyncIterator<Item, any, undefined> {
97
+ if (consumed) {
98
+ throw new OpencodeError('Cannot iterate over a consumed stream, use `.tee()` to split the stream.');
99
+ }
100
+ consumed = true;
101
+ let done = false;
102
+ try {
103
+ for await (const line of iterLines()) {
104
+ if (done) continue;
105
+ if (line) yield JSON.parse(line);
106
+ }
107
+ done = true;
108
+ } catch (e) {
109
+ // If the user calls `stream.controller.abort()`, we should exit without throwing.
110
+ if (isAbortError(e)) return;
111
+ throw e;
112
+ } finally {
113
+ // If the user `break`s, abort the ongoing request.
114
+ if (!done) controller.abort();
115
+ }
116
+ }
117
+
118
+ return new Stream(iterator, controller, client);
119
+ }
120
+
121
+ [Symbol.asyncIterator](): AsyncIterator<Item> {
122
+ return this.iterator();
123
+ }
124
+
125
+ /**
126
+ * Splits the stream into two streams which can be
127
+ * independently read from at different speeds.
128
+ */
129
+ tee(): [Stream<Item>, Stream<Item>] {
130
+ const left: Array<Promise<IteratorResult<Item>>> = [];
131
+ const right: Array<Promise<IteratorResult<Item>>> = [];
132
+ const iterator = this.iterator();
133
+
134
+ const teeIterator = (queue: Array<Promise<IteratorResult<Item>>>): AsyncIterator<Item> => {
135
+ return {
136
+ next: () => {
137
+ if (queue.length === 0) {
138
+ const result = iterator.next();
139
+ left.push(result);
140
+ right.push(result);
141
+ }
142
+ return queue.shift()!;
143
+ },
144
+ };
145
+ };
146
+
147
+ return [
148
+ new Stream(() => teeIterator(left), this.controller, this.#client),
149
+ new Stream(() => teeIterator(right), this.controller, this.#client),
150
+ ];
151
+ }
152
+
153
+ /**
154
+ * Converts this stream to a newline-separated ReadableStream of
155
+ * JSON stringified values in the stream
156
+ * which can be turned back into a Stream with `Stream.fromReadableStream()`.
157
+ */
158
+ toReadableStream(): ReadableStream {
159
+ const self = this;
160
+ let iter: AsyncIterator<Item>;
161
+
162
+ return makeReadableStream({
163
+ async start() {
164
+ iter = self[Symbol.asyncIterator]();
165
+ },
166
+ async pull(ctrl: any) {
167
+ try {
168
+ const { value, done } = await iter.next();
169
+ if (done) return ctrl.close();
170
+
171
+ const bytes = encodeUTF8(JSON.stringify(value) + '\n');
172
+
173
+ ctrl.enqueue(bytes);
174
+ } catch (err) {
175
+ ctrl.error(err);
176
+ }
177
+ },
178
+ async cancel() {
179
+ await iter.return?.();
180
+ },
181
+ });
182
+ }
183
+ }
184
+
185
+ export async function* _iterSSEMessages(
186
+ response: Response,
187
+ controller: AbortController,
188
+ ): AsyncGenerator<ServerSentEvent, void, unknown> {
189
+ if (!response.body) {
190
+ controller.abort();
191
+ if (
192
+ typeof (globalThis as any).navigator !== 'undefined' &&
193
+ (globalThis as any).navigator.product === 'ReactNative'
194
+ ) {
195
+ throw new OpencodeError(
196
+ `The default react-native fetch implementation does not support streaming. Please use expo/fetch: https://docs.expo.dev/versions/latest/sdk/expo/#expofetch-api`,
197
+ );
198
+ }
199
+ throw new OpencodeError(`Attempted to iterate over a response with no body`);
200
+ }
201
+
202
+ const sseDecoder = new SSEDecoder();
203
+ const lineDecoder = new LineDecoder();
204
+
205
+ const iter = ReadableStreamToAsyncIterable<Bytes>(response.body);
206
+ for await (const sseChunk of iterSSEChunks(iter)) {
207
+ for (const line of lineDecoder.decode(sseChunk)) {
208
+ const sse = sseDecoder.decode(line);
209
+ if (sse) yield sse;
210
+ }
211
+ }
212
+
213
+ for (const line of lineDecoder.flush()) {
214
+ const sse = sseDecoder.decode(line);
215
+ if (sse) yield sse;
216
+ }
217
+ }
218
+
219
+ /**
220
+ * Given an async iterable iterator, iterates over it and yields full
221
+ * SSE chunks, i.e. yields when a double new-line is encountered.
222
+ */
223
+ async function* iterSSEChunks(iterator: AsyncIterableIterator<Bytes>): AsyncGenerator<Uint8Array> {
224
+ let data = new Uint8Array();
225
+
226
+ for await (const chunk of iterator) {
227
+ if (chunk == null) {
228
+ continue;
229
+ }
230
+
231
+ const binaryChunk =
232
+ chunk instanceof ArrayBuffer ? new Uint8Array(chunk)
233
+ : typeof chunk === 'string' ? encodeUTF8(chunk)
234
+ : chunk;
235
+
236
+ let newData = new Uint8Array(data.length + binaryChunk.length);
237
+ newData.set(data);
238
+ newData.set(binaryChunk, data.length);
239
+ data = newData;
240
+
241
+ let patternIndex;
242
+ while ((patternIndex = findDoubleNewlineIndex(data)) !== -1) {
243
+ yield data.slice(0, patternIndex);
244
+ data = data.slice(patternIndex);
245
+ }
246
+ }
247
+
248
+ if (data.length > 0) {
249
+ yield data;
250
+ }
251
+ }
252
+
253
+ class SSEDecoder {
254
+ private data: string[];
255
+ private event: string | null;
256
+ private chunks: string[];
257
+
258
+ constructor() {
259
+ this.event = null;
260
+ this.data = [];
261
+ this.chunks = [];
262
+ }
263
+
264
+ decode(line: string) {
265
+ if (line.endsWith('\r')) {
266
+ line = line.substring(0, line.length - 1);
267
+ }
268
+
269
+ if (!line) {
270
+ // empty line and we didn't previously encounter any messages
271
+ if (!this.event && !this.data.length) return null;
272
+
273
+ const sse: ServerSentEvent = {
274
+ event: this.event,
275
+ data: this.data.join('\n'),
276
+ raw: this.chunks,
277
+ };
278
+
279
+ this.event = null;
280
+ this.data = [];
281
+ this.chunks = [];
282
+
283
+ return sse;
284
+ }
285
+
286
+ this.chunks.push(line);
287
+
288
+ if (line.startsWith(':')) {
289
+ return null;
290
+ }
291
+
292
+ let [fieldname, _, value] = partition(line, ':');
293
+
294
+ if (value.startsWith(' ')) {
295
+ value = value.substring(1);
296
+ }
297
+
298
+ if (fieldname === 'event') {
299
+ this.event = value;
300
+ } else if (fieldname === 'data') {
301
+ this.data.push(value);
302
+ }
303
+
304
+ return null;
305
+ }
306
+ }
307
+
308
+ function partition(str: string, delimiter: string): [string, string, string] {
309
+ const index = str.indexOf(delimiter);
310
+ if (index !== -1) {
311
+ return [str.substring(0, index), delimiter, str.substring(index + delimiter.length)];
312
+ }
313
+
314
+ return [str, '', ''];
315
+ }
@@ -0,0 +1,135 @@
1
+ import { concatBytes, decodeUTF8, encodeUTF8 } from '../utils/bytes';
2
+
3
+ export type Bytes = string | ArrayBuffer | Uint8Array | null | undefined;
4
+
5
+ /**
6
+ * A re-implementation of httpx's `LineDecoder` in Python that handles incrementally
7
+ * reading lines from text.
8
+ *
9
+ * https://github.com/encode/httpx/blob/920333ea98118e9cf617f246905d7b202510941c/httpx/_decoders.py#L258
10
+ */
11
+ export class LineDecoder {
12
+ // prettier-ignore
13
+ static NEWLINE_CHARS = new Set(['\n', '\r']);
14
+ static NEWLINE_REGEXP = /\r\n|[\n\r]/g;
15
+
16
+ #buffer: Uint8Array;
17
+ #carriageReturnIndex: number | null;
18
+
19
+ constructor() {
20
+ this.#buffer = new Uint8Array();
21
+ this.#carriageReturnIndex = null;
22
+ }
23
+
24
+ decode(chunk: Bytes): string[] {
25
+ if (chunk == null) {
26
+ return [];
27
+ }
28
+
29
+ const binaryChunk =
30
+ chunk instanceof ArrayBuffer ? new Uint8Array(chunk)
31
+ : typeof chunk === 'string' ? encodeUTF8(chunk)
32
+ : chunk;
33
+
34
+ this.#buffer = concatBytes([this.#buffer, binaryChunk]);
35
+
36
+ const lines: string[] = [];
37
+ let patternIndex;
38
+ while ((patternIndex = findNewlineIndex(this.#buffer, this.#carriageReturnIndex)) != null) {
39
+ if (patternIndex.carriage && this.#carriageReturnIndex == null) {
40
+ // skip until we either get a corresponding `\n`, a new `\r` or nothing
41
+ this.#carriageReturnIndex = patternIndex.index;
42
+ continue;
43
+ }
44
+
45
+ // we got double \r or \rtext\n
46
+ if (
47
+ this.#carriageReturnIndex != null &&
48
+ (patternIndex.index !== this.#carriageReturnIndex + 1 || patternIndex.carriage)
49
+ ) {
50
+ lines.push(decodeUTF8(this.#buffer.subarray(0, this.#carriageReturnIndex - 1)));
51
+ this.#buffer = this.#buffer.subarray(this.#carriageReturnIndex);
52
+ this.#carriageReturnIndex = null;
53
+ continue;
54
+ }
55
+
56
+ const endIndex =
57
+ this.#carriageReturnIndex !== null ? patternIndex.preceding - 1 : patternIndex.preceding;
58
+
59
+ const line = decodeUTF8(this.#buffer.subarray(0, endIndex));
60
+ lines.push(line);
61
+
62
+ this.#buffer = this.#buffer.subarray(patternIndex.index);
63
+ this.#carriageReturnIndex = null;
64
+ }
65
+
66
+ return lines;
67
+ }
68
+
69
+ flush(): string[] {
70
+ if (!this.#buffer.length) {
71
+ return [];
72
+ }
73
+ return this.decode('\n');
74
+ }
75
+ }
76
+
77
+ /**
78
+ * This function searches the buffer for the end patterns, (\r or \n)
79
+ * and returns an object with the index preceding the matched newline and the
80
+ * index after the newline char. `null` is returned if no new line is found.
81
+ *
82
+ * ```ts
83
+ * findNewLineIndex('abc\ndef') -> { preceding: 2, index: 3 }
84
+ * ```
85
+ */
86
+ function findNewlineIndex(
87
+ buffer: Uint8Array,
88
+ startIndex: number | null,
89
+ ): { preceding: number; index: number; carriage: boolean } | null {
90
+ const newline = 0x0a; // \n
91
+ const carriage = 0x0d; // \r
92
+
93
+ for (let i = startIndex ?? 0; i < buffer.length; i++) {
94
+ if (buffer[i] === newline) {
95
+ return { preceding: i, index: i + 1, carriage: false };
96
+ }
97
+
98
+ if (buffer[i] === carriage) {
99
+ return { preceding: i, index: i + 1, carriage: true };
100
+ }
101
+ }
102
+
103
+ return null;
104
+ }
105
+
106
+ export function findDoubleNewlineIndex(buffer: Uint8Array): number {
107
+ // This function searches the buffer for the end patterns (\r\r, \n\n, \r\n\r\n)
108
+ // and returns the index right after the first occurrence of any pattern,
109
+ // or -1 if none of the patterns are found.
110
+ const newline = 0x0a; // \n
111
+ const carriage = 0x0d; // \r
112
+
113
+ for (let i = 0; i < buffer.length - 1; i++) {
114
+ if (buffer[i] === newline && buffer[i + 1] === newline) {
115
+ // \n\n
116
+ return i + 2;
117
+ }
118
+ if (buffer[i] === carriage && buffer[i + 1] === carriage) {
119
+ // \r\r
120
+ return i + 2;
121
+ }
122
+ if (
123
+ buffer[i] === carriage &&
124
+ buffer[i + 1] === newline &&
125
+ i + 3 < buffer.length &&
126
+ buffer[i + 2] === carriage &&
127
+ buffer[i + 3] === newline
128
+ ) {
129
+ // \r\n\r\n
130
+ return i + 4;
131
+ }
132
+ }
133
+
134
+ return -1;
135
+ }
@@ -1,6 +1,7 @@
1
1
  // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
2
 
3
3
  import type { FinalRequestOptions } from './request-options';
4
+ import { Stream } from '../core/streaming';
4
5
  import { type Opencode } from '../client';
5
6
  import { formatRequestDetails, loggerFor } from './utils/log';
6
7
 
@@ -16,6 +17,19 @@ export type APIResponseProps = {
16
17
  export async function defaultParseResponse<T>(client: Opencode, props: APIResponseProps): Promise<T> {
17
18
  const { response, requestLogID, retryOfRequestLogID, startTime } = props;
18
19
  const body = await (async () => {
20
+ if (props.options.stream) {
21
+ loggerFor(client).debug('response', response.status, response.url, response.headers, response.body);
22
+
23
+ // Note: there is an invariant here that isn't represented in the type system
24
+ // that if you set `stream: true` the response type must also be `Stream<T>`
25
+
26
+ if (props.options.__streamClass) {
27
+ return props.options.__streamClass.fromSSEResponse(response, props.controller, client) as any;
28
+ }
29
+
30
+ return Stream.fromSSEResponse(response, props.controller, client) as any;
31
+ }
32
+
19
33
  // fetch refuses to read the body when the status code is 204.
20
34
  if (response.status === 204) {
21
35
  return null as T;
@@ -3,26 +3,81 @@
3
3
  import { NullableHeaders } from './headers';
4
4
 
5
5
  import type { BodyInit } from './builtin-types';
6
+ import { Stream } from '../core/streaming';
6
7
  import type { HTTPMethod, MergedRequestInit } from './types';
7
8
  import { type HeadersLike } from './headers';
8
9
 
9
10
  export type FinalRequestOptions = RequestOptions & { method: HTTPMethod; path: string };
10
11
 
11
12
  export type RequestOptions = {
13
+ /**
14
+ * The HTTP method for the request (e.g., 'get', 'post', 'put', 'delete').
15
+ */
12
16
  method?: HTTPMethod;
17
+
18
+ /**
19
+ * The URL path for the request.
20
+ *
21
+ * @example "/v1/foo"
22
+ */
13
23
  path?: string;
24
+
25
+ /**
26
+ * Query parameters to include in the request URL.
27
+ */
14
28
  query?: object | undefined | null;
29
+
30
+ /**
31
+ * The request body. Can be a string, JSON object, FormData, or other supported types.
32
+ */
15
33
  body?: unknown;
34
+
35
+ /**
36
+ * HTTP headers to include with the request. Can be a Headers object, plain object, or array of tuples.
37
+ */
16
38
  headers?: HeadersLike;
39
+
40
+ /**
41
+ * The maximum number of times that the client will retry a request in case of a
42
+ * temporary failure, like a network error or a 5XX error from the server.
43
+ *
44
+ * @default 2
45
+ */
17
46
  maxRetries?: number;
47
+
18
48
  stream?: boolean | undefined;
49
+
50
+ /**
51
+ * The maximum amount of time (in milliseconds) that the client should wait for a response
52
+ * from the server before timing out a single request.
53
+ *
54
+ * @unit milliseconds
55
+ */
19
56
  timeout?: number;
57
+
58
+ /**
59
+ * Additional `RequestInit` options to be passed to the underlying `fetch` call.
60
+ * These options will be merged with the client's default fetch options.
61
+ */
20
62
  fetchOptions?: MergedRequestInit;
63
+
64
+ /**
65
+ * An AbortSignal that can be used to cancel the request.
66
+ */
21
67
  signal?: AbortSignal | undefined | null;
68
+
69
+ /**
70
+ * A unique key for this request to enable idempotency.
71
+ */
22
72
  idempotencyKey?: string;
73
+
74
+ /**
75
+ * Override the default base URL for this specific request.
76
+ */
23
77
  defaultBaseURL?: string | undefined;
24
78
 
25
79
  __binaryResponse?: boolean | undefined;
80
+ __streamClass?: typeof Stream;
26
81
  };
27
82
 
28
83
  export type EncodedContent = { bodyHeaders: HeadersLike; body: BodyInit };
@@ -7,7 +7,7 @@ export type KeysEnum<T> = { [P in keyof Required<T>]: true };
7
7
 
8
8
  export type FinalizedRequestInit = RequestInit & { headers: Headers };
9
9
 
10
- type NotAny<T> = [unknown] extends [T] ? never : T;
10
+ type NotAny<T> = [0] extends [1 & T] ? never : T;
11
11
 
12
12
  /**
13
13
  * Some environments overload the global fetch function, and Parameters<T> only gets the last signature.
@@ -64,13 +64,15 @@ type OverloadedParameters<T> =
64
64
  * [1]: https://www.typescriptlang.org/tsconfig/#typeAcquisition
65
65
  */
66
66
  /** @ts-ignore For users with \@types/node */
67
- type UndiciTypesRequestInit = NotAny<import('../node_modules/undici-types').RequestInit> | NotAny<import('../../node_modules/undici-types').RequestInit> | NotAny<import('../../../node_modules/undici-types').RequestInit> | NotAny<import('../../../../node_modules/undici-types').RequestInit> | NotAny<import('../../../../../node_modules/undici-types').RequestInit> | NotAny<import('../../../../../../node_modules/undici-types').RequestInit> | NotAny<import('../../../../../../../node_modules/undici-types').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici-types').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici-types').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici-types').RequestInit>;
67
+ type UndiciTypesRequestInit = NotAny<import('../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit>;
68
68
  /** @ts-ignore For users with undici */
69
- type UndiciRequestInit = NotAny<import('../node_modules/undici').RequestInit> | NotAny<import('../../node_modules/undici').RequestInit> | NotAny<import('../../../node_modules/undici').RequestInit> | NotAny<import('../../../../node_modules/undici').RequestInit> | NotAny<import('../../../../../node_modules/undici').RequestInit> | NotAny<import('../../../../../../node_modules/undici').RequestInit> | NotAny<import('../../../../../../../node_modules/undici').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici').RequestInit>;
69
+ type UndiciRequestInit = NotAny<import('../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici/index.d.ts').RequestInit>;
70
70
  /** @ts-ignore For users with \@types/bun */
71
71
  type BunRequestInit = globalThis.FetchRequestInit;
72
- /** @ts-ignore For users with node-fetch */
73
- type NodeFetchRequestInit = NotAny<import('../node_modules/node-fetch').RequestInit> | NotAny<import('../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/node-fetch').RequestInit>;
72
+ /** @ts-ignore For users with node-fetch@2 */
73
+ type NodeFetch2RequestInit = NotAny<import('../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit>;
74
+ /** @ts-ignore For users with node-fetch@3, doesn't need file extension because types are at ./@types/index.d.ts */
75
+ type NodeFetch3RequestInit = NotAny<import('../node_modules/node-fetch').RequestInit> | NotAny<import('../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/node-fetch').RequestInit>;
74
76
  /** @ts-ignore For users who use Deno */
75
77
  type FetchRequestInit = NonNullable<OverloadedParameters<typeof fetch>[1]>;
76
78
  /* eslint-enable */
@@ -79,7 +81,8 @@ type RequestInits =
79
81
  | NotAny<UndiciTypesRequestInit>
80
82
  | NotAny<UndiciRequestInit>
81
83
  | NotAny<BunRequestInit>
82
- | NotAny<NodeFetchRequestInit>
84
+ | NotAny<NodeFetch2RequestInit>
85
+ | NotAny<NodeFetch3RequestInit>
83
86
  | NotAny<RequestInit>
84
87
  | NotAny<FetchRequestInit>;
85
88
 
@@ -90,7 +90,7 @@ export const multipartFormRequestOptions = async (
90
90
  return { ...opts, body: await createForm(opts.body, fetch) };
91
91
  };
92
92
 
93
- const supportsFormDataMap = /** @__PURE__ */ new WeakMap<Fetch, Promise<boolean>>();
93
+ const supportsFormDataMap = /* @__PURE__ */ new WeakMap<Fetch, Promise<boolean>>();
94
94
 
95
95
  /**
96
96
  * node-fetch doesn't support the global FormData object in recent node versions. Instead of sending
@@ -58,7 +58,7 @@ const noopLogger = {
58
58
  debug: noop,
59
59
  };
60
60
 
61
- let cachedLoggers = /** @__PURE__ */ new WeakMap<Logger, [LogLevel, Logger]>();
61
+ let cachedLoggers = /* @__PURE__ */ new WeakMap<Logger, [LogLevel, Logger]>();
62
62
 
63
63
  export function loggerFor(client: Opencode): Logger {
64
64
  const logger = client.logger;