@atomic-chat/core 0.5.1

package/dist/server/public/wire.js

@@ -0,0 +1,174 @@
+/**
+ * Talking to upstreams and writing answers back: the plumbing every public route shares.
+ *
+ * Upstream requests go through `node:http` rather than `fetch`. The proxy forwards the client's own
+ * headers, and `fetch` refuses or rewrites several of them; it also cannot report a transport error
+ * apart from a timeout without guessing. A plain request keeps the forwarded header set, the body
+ * and the error under this module's control.
+ *
+ * Ported from: src-tauri/src/core/server/proxy.rs (`build_streaming_response`, `next_stream_chunk`,
+ * the header loops in `inner_proxy_request`), utils/src/http.rs (`is_cors_header`).
+ */
+import { request as httpRequest } from 'node:http';
+import { request as httpsRequest } from 'node:https';
+/** A stream that delivers nothing for this long is abandoned (the proxy's `STREAM_IDLE_TIMEOUT`). */
+export const STREAM_IDLE_TIMEOUT_MS = 600_000;
+/** Connection-scoped headers: they describe one hop and are never copied to the next. */
+const HOP_BY_HOP = new Set([
+    'connection',
+    'keep-alive',
+    'proxy-connection',
+    'transfer-encoding',
+    'te',
+    'trailer',
+    'upgrade',
+]);
+export function isCorsHeader(name) {
+    return name.toLowerCase().startsWith('access-control-');
+}
+/** The client's headers as sent, names and duplicates preserved. */
+export function rawHeaderPairs(req) {
+    const pairs = [];
+    for (let i = 0; i + 1 < req.rawHeaders.length; i += 2) {
+        pairs.push([req.rawHeaders[i], req.rawHeaders[i + 1]]);
+    }
+    return pairs;
+}
+/** The client's headers minus the named ones (case-insensitive) and the hop-by-hop set. */
+export function forwardableHeaders(req, exclude) {
+    const skip = new Set(exclude.map((n) => n.toLowerCase()));
+    return rawHeaderPairs(req).filter(([name]) => {
+        const lower = name.toLowerCase();
+        return !skip.has(lower) && !HOP_BY_HOP.has(lower);
+    });
+}
+export async function readBody(stream) {
+    const chunks = [];
+    for await (const chunk of stream)
+        chunks.push(chunk);
+    return Buffer.concat(chunks);
+}
+/** A transport failure, worded like the proxy's so logs and error bodies stay recognisable. */
+export class UpstreamUnreachable extends Error {
+}
+export function sendUpstream(url, init) {
+    return new Promise((resolve, reject) => {
+        let target;
+        try {
+            target = new URL(url);
+        }
+        catch (e) {
+            reject(new UpstreamUnreachable(`builder error for url (${url}): ${e.message}`));
+            return;
+        }
+        const body = init.body === undefined ? undefined : Buffer.from(init.body);
+        // Headers given as a list are sent exactly as listed, so `Host` has to be supplied here.
+        const headers = [
+            ['Host', target.host],
+            ...init.headers.filter(([n]) => !['host', 'content-length'].includes(n.toLowerCase())),
+        ];
+        if (body !== undefined)
+            headers.push(['Content-Length', String(body.length)]);
+        const send = target.protocol === 'https:' ? httpsRequest : httpRequest;
+        const req = send(target, { method: init.method, headers: headers.flat(), signal: init.signal });
+        const fail = (e) => reject(new UpstreamUnreachable(`error sending request for url (${url}): ${e.message}`));
+        const connectTimer = setTimeout(() => {
+            req.destroy(new Error('operation timed out'));
+        }, init.connectTimeoutMs);
+        req.once('socket', (socket) => {
+            if (!socket.connecting)
+                clearTimeout(connectTimer);
+            else
+                socket.once('connect', () => clearTimeout(connectTimer));
+        });
+        req.once('error', (e) => {
+            clearTimeout(connectTimer);
+            fail(e);
+        });
+        req.once('response', (res) => {
+            clearTimeout(connectTimer);
+            const pairs = [];
+            for (let i = 0; i + 1 < res.rawHeaders.length; i += 2) {
+                pairs.push([res.rawHeaders[i], res.rawHeaders[i + 1]]);
+            }
+            const contentType = res.headers['content-type'];
+            resolve({ status: res.statusCode ?? 502, headers: pairs, contentType, body: res });
+        });
+        req.end(body);
+    });
+}
+export async function readUpstreamText(response) {
+    try {
+        return (await readBody(response.body)).toString('utf8');
+    }
+    catch (e) {
+        return `Failed to read error body: ${e.message}`;
+    }
+}
+/** Write a complete answer. */
+export function sendWhole(res, status, headers, body) {
+    const bytes = Buffer.from(body);
+    res.writeHead(status, [...headers, ['Content-Length', String(bytes.length)]].flat());
+    res.end(bytes);
+}
+/** The upstream's headers as the proxy relays them: its own CORS and length dropped, ours added. */
+export function relayedHeaders(upstream, cors) {
+    const kept = upstream.headers.filter(([name]) => {
+        const lower = name.toLowerCase();
+        return !isCorsHeader(lower) && lower !== 'content-length' && !HOP_BY_HOP.has(lower);
+    });
+    return [...kept, ...cors];
+}
+/**
+ * Stream an upstream body to the client as it arrives. A stall longer than the idle timeout ends
+ * the response; a client that disconnects tears the upstream down.
+ */
+export async function pipeBody(res, source, onClose) {
+    let closed = false;
+    const onClientClose = () => {
+        if (!res.writableFinished) {
+            closed = true;
+            onClose?.();
+        }
+    };
+    res.once('close', onClientClose);
+    try {
+        for await (const chunk of withIdleTimeout(source, STREAM_IDLE_TIMEOUT_MS)) {
+            if (closed)
+                break;
+            if (!res.write(chunk))
+                await new Promise((resolve) => res.once('drain', resolve));
+        }
+    }
+    catch {
+        // The upstream failed or stalled mid-stream; the client gets what arrived before it.
+    }
+    finally {
+        res.off('close', onClientClose);
+        if (!closed)
+            res.end();
+    }
+}
+/** Relay an upstream answer unchanged (`build_streaming_response`). */
+export async function relay(res, upstream, cors) {
+    res.writeHead(upstream.status, relayedHeaders(upstream, cors).flat());
+    await pipeBody(res, upstream.body, () => upstream.body.destroy());
+}
+export async function* withIdleTimeout(source, idleMs) {
+    const iterator = source[Symbol.asyncIterator]();
+    for (;;) {
+        let timer;
+        const idle = new Promise((resolve) => {
+            timer = setTimeout(() => resolve('idle'), idleMs);
+        });
+        const step = await Promise.race([iterator.next(), idle]).finally(() => clearTimeout(timer));
+        if (step === 'idle') {
+            await iterator.return?.();
+            return;
+        }
+        if (step.done)
+            return;
+        yield step.value;
+    }
+}
+//# sourceMappingURL=wire.js.map

package/dist/server/public/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../../src/server/public/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAA;AAElD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,YAAY,CAAA;AAEpD,qGAAqG;AACrG,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAA;AAI7C,yFAAyF;AACzF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,YAAY;IACZ,YAAY;IACZ,kBAAkB;IAClB,mBAAmB;IACnB,IAAI;IACJ,SAAS;IACT,SAAS;CACV,CAAC,CAAA;AAEF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAA;AACzD,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,GAAoB;IACjD,MAAM,KAAK,GAAgB,EAAE,CAAA;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAW,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAW,CAAC,CAAC,CAAA;IAC5E,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB,CAAC,GAAoB,EAAE,OAA0B;IACjF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IACzD,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAChC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAuB;IACpD,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAA;IAC9D,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC;AAmBD,+FAA+F;AAC/F,MAAM,OAAO,mBAAoB,SAAQ,KAAK;CAAG;AAEjD,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,IAAkB;IAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAW,CAAA;QACf,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QACvB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,mBAAmB,CAAC,0BAA0B,GAAG,MAAO,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;YAC1F,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACzE,yFAAyF;QACzF,MAAM,OAAO,GAAgB;YAC3B,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC;YACrB,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;SACvF,CAAA;QACD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAE7E,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAA;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAC/F,MAAM,IAAI,GAAG,CAAC,CAAQ,EAAE,EAAE,CACxB,MAAM,CAAC,IAAI,mBAAmB,CAAC,kCAAkC,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QAEzF,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YACnC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAA;QAC/C,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAA;QACzB,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YAC5B,IAAI,CAAC,MAAM,CAAC,UAAU;gBAAE,YAAY,CAAC,YAAY,CAAC,CAAA;;gBAC7C,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAA;QAC/D,CAAC,CAAC,CAAA;QACF,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACtB,YAAY,CAAC,YAAY,CAAC,CAAA;YAC1B,IAAI,CAAC,CAAC,CAAC,CAAA;QACT,CAAC,CAAC,CAAA;QACF,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE;YAC3B,YAAY,CAAC,YAAY,CAAC,CAAA;YAC1B,MAAM,KAAK,GAAgB,EAAE,CAAA;YAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAW,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAW,CAAC,CAAC,CAAA;YAC5E,CAAC;YACD,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;YAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,IAAI,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAA;QACpF,CAAC,CAAC,CAAA;QACF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACf,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAA0B;IAC/D,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACzD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,8BAA+B,CAAW,CAAC,OAAO,EAAE,CAAA;IAC7D,CAAC;AACH,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,SAAS,CACvB,GAAmB,EACnB,MAAc,EACd,OAAoB,EACpB,IAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/B,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,gBAAgB,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACpF,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAChB,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,cAAc,CAAC,QAA0B,EAAE,IAAiB;IAC1E,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAChC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,gBAAgB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACrF,CAAC,CAAC,CAAA;IACF,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAmB,EACnB,MAAsC,EACtC,OAAoB;IAEpB,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;YAC1B,MAAM,GAAG,IAAI,CAAA;YACb,OAAO,EAAE,EAAE,CAAA;QACb,CAAC;IACH,CAAC,CAAA;IACD,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;IAChC,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,eAAe,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAAE,CAAC;YAC1E,IAAI,MAAM;gBAAE,MAAK;YACjB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;QACnF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qFAAqF;IACvF,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;QAC/B,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,GAAG,EAAE,CAAA;IACxB,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,GAAmB,EACnB,QAA0B,EAC1B,IAAiB;IAEjB,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACrE,MAAM,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,eAAe,CAAI,MAAwB,EAAE,MAAc;IAChF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAA;IAC/C,SAAS,CAAC;QACR,IAAI,KAAiC,CAAA;QACrC,MAAM,IAAI,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YAC3C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;QACnD,CAAC,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA;QAC3F,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAA;YACzB,OAAM;QACR,CAAC;QACD,IAAI,IAAI,CAAC,IAAI;YAAE,OAAM;QACrB,MAAM,IAAI,CAAC,KAAK,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/server/shims/anthropic.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Anthropic `/messages` ↔ OpenAI Chat Completions, for clients such as Claude Code that speak the
+ * Anthropic API to a local engine that only speaks Chat Completions.
+ *
+ * Ported from: src-tauri/src/core/server/proxy.rs (`transform_anthropic_to_openai`,
+ * `transform_openai_response_to_anthropic`, `transform_and_forward_stream`).
+ * Contract: test/fixtures/app/anthropic-shim.
+ *
+ * serde_json's `Value::get` only answers for objects and distinguishes a missing key (`None`) from
+ * an explicit `null` (`Some(Null)`); every `unwrap_or` below falls back on a *missing* key only, so
+ * an explicit `null` is carried through as `null`. `get` and `orElse` keep that distinction.
+ */
+import type { JsonValue } from './json.js';
+/** `transform_anthropic_to_openai`; `null` where the Rust returns `None`. */
+export declare function anthropicRequestToChat(body: JsonValue): JsonValue | null;
+/** `transform_openai_response_to_anthropic` */
+export declare function chatResponseToAnthropic(chat: JsonValue): JsonValue;
+/**
+ * `transform_and_forward_stream`: raw Chat Completions SSE bytes in (as network reads arrive),
+ * Anthropic stream events out. `onNetworkChunk` returns the event payloads produced by that read;
+ * the wire name of each is its `type`. `done` turns true once the stream has been closed with
+ * `message_stop`, after which further reads produce nothing.
+ *
+ * One deliberate divergence from the Rust: it split every network read into lines on its own, so a
+ * `data:` line cut across two reads was parsed as two invalid halves and dropped. Here an
+ * unterminated trailing line is held until the read that completes it, and `finish()` — called when
+ * the upstream body ends — processes whatever is still held. Without it, a final `data: [DONE]` that
+ * arrives with no newline would never close the message, and the client would wait for a
+ * `message_stop` that never comes; the Rust handled that case because it did not buffer.
+ */
+export declare class AnthropicStreamConverter {
+    private pending;
+    private finished;
+    private isFirst;
+    private accumulated;
+    private textBlockIndex;
+    /** Chat tool-call index → Anthropic content block index. */
+    private readonly toolBlocks;
+    private nextBlockIndex;
+    get done(): boolean;
+    onNetworkChunk(text: string): JsonValue[];
+    /**
+     * The upstream body ended. Process a final line that arrived without a newline; emit nothing else.
+     * A stream that ends without `[DONE]` or a finish reason still gets no closing events here, exactly
+     * as in the Rust — a truncated response is not reported as a finished one.
+     */
+    finish(): JsonValue[];
+    private onLine;
+    private closeTextBlock;
+    private closeOpenBlocks;
+    private closeMessage;
+}