@dotcraft/sdk 0.5.9

package/dist/transport.js

@@ -0,0 +1,214 @@
+/**
+ * Transport layer: StdioTransport and WebSocketTransport.
+ */
+import { createInterface } from "node:readline";
+import WebSocket from "ws";
+export class TransportError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TransportError";
+    }
+}
+export class TransportClosed extends TransportError {
+    constructor(message = "Transport closed") {
+        super(message);
+        this.name = "TransportClosed";
+    }
+}
+/**
+ * Newline-delimited JSON (JSONL) on stdin/stdout.
+ * Used when DotCraft spawns the adapter as a subprocess.
+ */
+export class StdioTransport {
+    closed = false;
+    rl;
+    lineIter = null;
+    constructor() {
+        this.rl = createInterface({ input: process.stdin, crlfDelay: Infinity });
+    }
+    async readMessage() {
+        if (this.closed)
+            throw new TransportClosed();
+        if (!this.lineIter) {
+            this.lineIter = this.rl[Symbol.asyncIterator]();
+        }
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const { value, done } = await this.lineIter.next();
+            if (done)
+                throw new TransportClosed("stdin closed");
+            const text = String(value).trim();
+            if (!text)
+                continue;
+            return JSON.parse(text);
+        }
+    }
+    async writeMessage(msg) {
+        if (this.closed)
+            throw new TransportClosed();
+        const line = `${JSON.stringify(msg)}\n`;
+        await new Promise((resolve, reject) => {
+            process.stdout.write(line, (err) => (err ? reject(err) : resolve()));
+        });
+    }
+    async close() {
+        this.closed = true;
+        this.rl.close();
+    }
+}
+/**
+ * One JSON-RPC message per WebSocket text frame.
+ */
+export class WebSocketTransport {
+    baseUrl;
+    token;
+    ws = null;
+    closed = false;
+    receivedFrames = [];
+    waitingReaders = [];
+    terminalError = null;
+    constructor(opts) {
+        this.baseUrl = opts.url;
+        this.token = opts.token;
+    }
+    get urlWithToken() {
+        if (!this.token?.trim())
+            return this.baseUrl;
+        try {
+            const parsed = new URL(this.baseUrl);
+            if (!parsed.searchParams.has("token")) {
+                parsed.searchParams.set("token", this.token.trim());
+            }
+            return parsed.toString();
+        }
+        catch {
+            const sep = this.baseUrl.includes("?") ? "&" : "?";
+            return `${this.baseUrl}${sep}token=${encodeURIComponent(this.token.trim())}`;
+        }
+    }
+    async connect() {
+        if (this.closed)
+            throw new TransportClosed();
+        if (this.ws !== null)
+            return;
+        this.terminalError = null;
+        this.receivedFrames = [];
+        this.ws = new WebSocket(this.urlWithToken);
+        await new Promise((resolve, reject) => {
+            const w = this.ws;
+            const onOpen = () => {
+                cleanup();
+                this.attachSocketHandlers(w);
+                resolve();
+            };
+            const onError = (e) => {
+                cleanup();
+                this.terminalError = e;
+                reject(e);
+            };
+            const onClose = () => {
+                cleanup();
+                const err = new TransportClosed("WebSocket closed");
+                this.terminalError = err;
+                reject(err);
+            };
+            const cleanup = () => {
+                w.off("open", onOpen);
+                w.off("error", onError);
+                w.off("close", onClose);
+            };
+            w.once("open", onOpen);
+            w.once("error", onError);
+            w.once("close", onClose);
+        });
+    }
+    async readMessage() {
+        if (this.closed)
+            throw new TransportClosed();
+        if (this.ws === null)
+            await this.connect();
+        if (this.receivedFrames.length > 0) {
+            const frame = this.receivedFrames.shift();
+            return JSON.parse(frame);
+        }
+        if (this.terminalError) {
+            throw this.terminalError;
+        }
+        return await new Promise((resolve, reject) => {
+            this.waitingReaders.push({ resolve, reject });
+        });
+    }
+    async writeMessage(msg) {
+        if (this.closed)
+            throw new TransportClosed();
+        if (this.ws === null)
+            throw new TransportError("WebSocket not connected; call connect() first");
+        const text = JSON.stringify(msg);
+        await new Promise((resolve, reject) => {
+            this.ws.send(text, (err) => (err ? reject(err) : resolve()));
+        });
+    }
+    async close() {
+        this.closed = true;
+        const closeError = new TransportClosed("Transport closed");
+        this.terminalError = closeError;
+        this.receivedFrames = [];
+        this.rejectWaitingReaders(closeError);
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    attachSocketHandlers(ws) {
+        ws.on("message", (data) => {
+            const text = this.rawDataToUtf8(data);
+            if (this.waitingReaders.length > 0) {
+                const waiter = this.waitingReaders.shift();
+                try {
+                    waiter.resolve(JSON.parse(text));
+                }
+                catch (error) {
+                    waiter.reject(error);
+                }
+                return;
+            }
+            this.receivedFrames.push(text);
+        });
+        ws.on("close", () => {
+            if (this.closed)
+                return;
+            this.ws = null;
+            const err = new TransportClosed("WebSocket closed");
+            this.terminalError = err;
+            this.receivedFrames = [];
+            this.rejectWaitingReaders(err);
+        });
+        ws.on("error", (error) => {
+            this.terminalError = error;
+            this.rejectWaitingReaders(error);
+        });
+    }
+    rejectWaitingReaders(error) {
+        if (this.waitingReaders.length === 0)
+            return;
+        const readers = this.waitingReaders;
+        this.waitingReaders = [];
+        for (const reader of readers) {
+            reader.reject(error);
+        }
+    }
+    rawDataToUtf8(data) {
+        if (typeof data === "string")
+            return data;
+        if (data instanceof Buffer)
+            return data.toString("utf-8");
+        if (Array.isArray(data))
+            return Buffer.concat(data).toString("utf-8");
+        if (data instanceof ArrayBuffer)
+            return Buffer.from(new Uint8Array(data)).toString("utf-8");
+        if (ArrayBuffer.isView(data))
+            return Buffer.from(data.buffer, data.byteOffset, data.byteLength).toString("utf-8");
+        throw new TransportError("Unsupported WebSocket raw data format");
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.test.d.ts.map

package/dist/transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.test.d.ts","sourceRoot":"","sources":["../src/transport.test.ts"],"names":[],"mappings":""}

package/dist/transport.test.js

@@ -0,0 +1,105 @@
+import assert from "node:assert/strict";
+import { setTimeout as sleep } from "node:timers/promises";
+import test from "node:test";
+import { WebSocketServer } from "ws";
+import { TransportClosed, WebSocketTransport } from "./transport.js";
+async function withServer(onConnection, run) {
+    const server = new WebSocketServer({ port: 0 });
+    server.on("connection", (socket, request) => {
+        void onConnection(socket, request);
+    });
+    await new Promise((resolve) => server.once("listening", () => resolve()));
+    const address = server.address();
+    if (!address || typeof address === "string") {
+        throw new Error("WebSocket server did not expose a TCP port");
+    }
+    try {
+        await run(`ws://127.0.0.1:${address.port}`);
+    }
+    finally {
+        await new Promise((resolve, reject) => {
+            server.close((error) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            });
+        });
+    }
+}
+async function withTimeout(promise, timeoutMs = 400) {
+    return await Promise.race([
+        promise,
+        (async () => {
+            await sleep(timeoutMs);
+            throw new Error(`Timed out after ${timeoutMs}ms`);
+        })(),
+    ]);
+}
+test("WebSocketTransport keeps ordered frames across burst and consumer gap", async () => {
+    await withServer(async (socket) => {
+        socket.send(JSON.stringify({ seq: 1 }));
+        socket.send(JSON.stringify({ seq: 2 }));
+        await sleep(10);
+        socket.send(JSON.stringify({ seq: 3 }));
+    }, async (url) => {
+        const transport = new WebSocketTransport({ url });
+        await transport.connect();
+        const first = await withTimeout(transport.readMessage());
+        await sleep(25);
+        const second = await withTimeout(transport.readMessage());
+        const third = await withTimeout(transport.readMessage());
+        assert.deepEqual(first, { seq: 1 });
+        assert.deepEqual(second, { seq: 2 });
+        assert.deepEqual(third, { seq: 3 });
+        await transport.close();
+    });
+});
+test("WebSocketTransport rejects pending read on close", async () => {
+    await withServer(async (socket) => {
+        await sleep(20);
+        socket.close();
+    }, async (url) => {
+        const transport = new WebSocketTransport({ url });
+        await transport.connect();
+        await assert.rejects(withTimeout(transport.readMessage()), (error) => {
+            return error instanceof TransportClosed;
+        });
+        await transport.close();
+    });
+});
+test("WebSocketTransport decodes binary UTF-8 frames", async () => {
+    await withServer(async (socket) => {
+        socket.send(Buffer.from(JSON.stringify({ mode: "binary" }), "utf-8"));
+    }, async (url) => {
+        const transport = new WebSocketTransport({ url });
+        await transport.connect();
+        const message = await withTimeout(transport.readMessage());
+        assert.deepEqual(message, { mode: "binary" });
+        await transport.close();
+    });
+});
+test("WebSocketTransport appends token once", async () => {
+    const seen = [];
+    await withServer((socket, request) => {
+        seen.push(request.url ?? "");
+        socket.close();
+    }, async (url) => {
+        const transport = new WebSocketTransport({ url, token: "secret" });
+        await transport.connect();
+        await transport.close();
+    });
+    await withServer((socket, request) => {
+        seen.push(request.url ?? "");
+        socket.close();
+    }, async (url) => {
+        const transport = new WebSocketTransport({ url: `${url}?token=existing`, token: "secret" });
+        await transport.connect();
+        await transport.close();
+    });
+    const first = new URL(`ws://127.0.0.1${seen[0]}`);
+    const second = new URL(`ws://127.0.0.1${seen[1]}`);
+    assert.deepEqual(first.searchParams.getAll("token"), ["secret"]);
+    assert.deepEqual(second.searchParams.getAll("token"), ["existing"]);
+});
+//# sourceMappingURL=transport.test.js.map

package/dist/transport.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.test.js","sourceRoot":"","sources":["../src/transport.test.ts"],"names":[],"mappings":"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"}

package/dist/turnReply.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Helpers to build the final assistant reply from turn/completed snapshots and streamed deltas.
+ * turn/completed includes full turn items; delta aggregation can miss early chunks if handlers
+ * attach after turn/start returns (race). Prefer the snapshot when it is at least as long as deltas.
+ */
+/**
+ * Concatenates text from all agentMessage items in turn/completed params (wire order).
+ */
+export declare function extractAgentReplyTextFromTurnCompletedParams(params: Record<string, unknown> | null | undefined): string;
+/**
+ * Extracts text from each agentMessage item in turn/completed params (wire order).
+ */
+export declare function extractAgentReplyTextsFromTurnCompletedParams(params: Record<string, unknown> | null | undefined): string[];
+/**
+ * Configure whether `mergeReplyTextFromDeltaAndSnapshot` emits stderr traces.
+ * Pass `true` to enable; `false` or `undefined` to disable.
+ */
+export declare function configureTextMergeDebug(enabled: boolean | undefined): void;
+/**
+ * Merge streamed deltas with the authoritative snapshot from the server.
+ * When neither string contains the other but they share a common prefix, append the non-overlapping
+ * tail from the other side so unique text is not dropped (pick-longer-only loses one branch).
+ */
+export declare function mergeReplyTextFromDeltaAndSnapshot(deltaText: string, snapshotText: string): string;
+//# sourceMappingURL=turnReply.d.ts.map

package/dist/turnReply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnReply.d.ts","sourceRoot":"","sources":["../src/turnReply.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,4CAA4C,CAC1D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,EAAE,CAiBV;AAiCD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAE1E;AAWD;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CA+ClG"}

package/dist/turnReply.js

@@ -0,0 +1,143 @@
+/**
+ * Helpers to build the final assistant reply from turn/completed snapshots and streamed deltas.
+ * turn/completed includes full turn items; delta aggregation can miss early chunks if handlers
+ * attach after turn/start returns (race). Prefer the snapshot when it is at least as long as deltas.
+ */
+/**
+ * Concatenates text from all agentMessage items in turn/completed params (wire order).
+ */
+export function extractAgentReplyTextFromTurnCompletedParams(params) {
+    return extractAgentReplyTextsFromTurnCompletedParams(params).join("");
+}
+/**
+ * Extracts text from each agentMessage item in turn/completed params (wire order).
+ */
+export function extractAgentReplyTextsFromTurnCompletedParams(params) {
+    if (!params)
+        return [];
+    const turn = params.turn;
+    if (!turn)
+        return [];
+    const items = turn.items;
+    if (!Array.isArray(items))
+        return [];
+    const parts = [];
+    for (const raw of items) {
+        if (!raw || typeof raw !== "object")
+            continue;
+        const item = raw;
+        if (item.type !== "agentMessage")
+            continue;
+        const payload = item.payload;
+        if (!payload)
+            continue;
+        const text = payload.text;
+        if (typeof text === "string" && text.length > 0)
+            parts.push(text);
+    }
+    return parts;
+}
+function commonPrefixLength(left, right) {
+    const max = Math.min(left.length, right.length);
+    let idx = 0;
+    while (idx < max && left[idx] === right[idx])
+        idx += 1;
+    return idx;
+}
+/**
+ * Like {@link commonPrefixLength}, but when the first word after the last space differs between
+ * strings (e.g. "Hello streamed" vs "Hello snapshot"), roll back to that space so we do not treat a
+ * shared first letter ("s") as part of a safe prefix — otherwise snapshot tails become truncated
+ * (e.g. "napshot" instead of "snapshot").
+ */
+function commonPrefixLengthForMerge(left, right) {
+    const raw = commonPrefixLength(left, right);
+    if (raw === 0)
+        return 0;
+    const lastSpace = left.lastIndexOf(" ", raw - 1);
+    if (lastSpace < 0)
+        return raw;
+    const afterSpace = lastSpace + 1;
+    const w1 = (left.slice(afterSpace).split(/\s/)[0] ?? "");
+    const w2 = (right.slice(afterSpace).split(/\s/)[0] ?? "");
+    if (w1 === w2)
+        return raw;
+    const wordLcp = commonPrefixLength(w1, w2);
+    if (wordLcp === 0)
+        return afterSpace;
+    if (wordLcp === 1 && w1.length > 1 && w2.length > 1)
+        return afterSpace;
+    return afterSpace + wordLcp;
+}
+/** Set by {@link configureTextMergeDebug}; only `true` enables merge stderr traces. */
+let textMergeDebugOverride;
+/**
+ * Configure whether `mergeReplyTextFromDeltaAndSnapshot` emits stderr traces.
+ * Pass `true` to enable; `false` or `undefined` to disable.
+ */
+export function configureTextMergeDebug(enabled) {
+    textMergeDebugOverride = enabled;
+}
+function isDebugTextMergeEnabled() {
+    return textMergeDebugOverride === true;
+}
+function debugTextMerge(message, data) {
+    if (!isDebugTextMergeEnabled())
+        return;
+    console.error(`[dotcraft-sdk:text-merge] ${message}`, data);
+}
+/**
+ * Merge streamed deltas with the authoritative snapshot from the server.
+ * When neither string contains the other but they share a common prefix, append the non-overlapping
+ * tail from the other side so unique text is not dropped (pick-longer-only loses one branch).
+ */
+export function mergeReplyTextFromDeltaAndSnapshot(deltaText, snapshotText) {
+    if (!deltaText) {
+        debugTextMerge("empty_delta", { snapshotChars: snapshotText.length });
+        return snapshotText;
+    }
+    if (!snapshotText) {
+        debugTextMerge("empty_snapshot", { deltaChars: deltaText.length });
+        return deltaText;
+    }
+    if (deltaText === snapshotText)
+        return snapshotText;
+    if (snapshotText.includes(deltaText))
+        return snapshotText;
+    if (deltaText.includes(snapshotText))
+        return deltaText;
+    const cp = commonPrefixLengthForMerge(deltaText, snapshotText);
+    if (cp > 0) {
+        const snapTail = snapshotText.slice(cp).trim();
+        const deltaTail = deltaText.slice(cp).trim();
+        if (snapTail && !deltaText.includes(snapTail)) {
+            const merged = `${deltaText.trimEnd()}\n\n${snapTail}`;
+            debugTextMerge("appended_snapshot_tail", {
+                commonPrefixLen: cp,
+                deltaChars: deltaText.length,
+                snapshotChars: snapshotText.length,
+                mergedChars: merged.length,
+            });
+            return merged;
+        }
+        if (deltaTail && !snapshotText.includes(deltaTail)) {
+            const merged = `${snapshotText.trimEnd()}\n\n${deltaTail}`;
+            debugTextMerge("appended_delta_tail", {
+                commonPrefixLen: cp,
+                deltaChars: deltaText.length,
+                snapshotChars: snapshotText.length,
+                mergedChars: merged.length,
+            });
+            return merged;
+        }
+    }
+    const picked = snapshotText.length >= deltaText.length ? snapshotText : deltaText;
+    debugTextMerge("fallback_longer", {
+        commonPrefixLen: cp,
+        deltaChars: deltaText.length,
+        snapshotChars: snapshotText.length,
+        pickedChars: picked.length,
+    });
+    return picked;
+}
+//# sourceMappingURL=turnReply.js.map

package/dist/turnReply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnReply.js","sourceRoot":"","sources":["../src/turnReply.ts"],"names":[],"mappings":"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"}

package/dist/turnReply.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=turnReply.test.d.ts.map

package/dist/turnReply.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnReply.test.d.ts","sourceRoot":"","sources":["../src/turnReply.test.ts"],"names":[],"mappings":""}

package/dist/turnReply.test.js

@@ -0,0 +1,41 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { extractAgentReplyTextFromTurnCompletedParams, extractAgentReplyTextsFromTurnCompletedParams, mergeReplyTextFromDeltaAndSnapshot, } from "./turnReply.js";
+test("extractAgentReplyTextsFromTurnCompletedParams keeps wire order", () => {
+    const texts = extractAgentReplyTextsFromTurnCompletedParams({
+        turn: {
+            items: [
+                { id: "tool-1", type: "toolCall", payload: {} },
+                { id: "a1", type: "agentMessage", payload: { text: "first " } },
+                { id: "a2", type: "agentMessage", payload: { text: "second" } },
+            ],
+        },
+    });
+    assert.deepEqual(texts, ["first ", "second"]);
+    assert.equal(extractAgentReplyTextFromTurnCompletedParams({ turn: { items: [{ type: "agentMessage", payload: { text: "ok" } }] } }), "ok");
+});
+test("mergeReplyTextFromDeltaAndSnapshot prefers containing variant", () => {
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("存在。", "文件存在。"), "文件存在。");
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("文件存在。", "存在。"), "文件存在。");
+});
+test("mergeReplyTextFromDeltaAndSnapshot handles empty values", () => {
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("", "snapshot"), "snapshot");
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("delta", ""), "delta");
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("", ""), "");
+});
+test("mergeReplyTextFromDeltaAndSnapshot falls back to longer text", () => {
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("abc", "ab"), "abc");
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("ab", "abc"), "abc");
+});
+test("mergeReplyTextFromDeltaAndSnapshot appends divergent tail after common prefix", () => {
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("hello world", "hello there"), "hello world\n\nthere");
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("hello there", "hello world"), "hello there\n\nworld");
+});
+test("mergeReplyTextFromDeltaAndSnapshot does not split on a shared first letter of different words", () => {
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("Hello streamed", "Hello snapshot"), "Hello streamed\n\nsnapshot");
+});
+test("mergeReplyTextFromDeltaAndSnapshot falls back when no shared prefix", () => {
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("aaa", "bbb"), "bbb");
+    assert.equal(mergeReplyTextFromDeltaAndSnapshot("bbb", "aaa"), "aaa");
+});
+//# sourceMappingURL=turnReply.test.js.map

package/dist/turnReply.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnReply.test.js","sourceRoot":"","sources":["../src/turnReply.test.ts"],"names":[],"mappings":"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"}

package/dist/wire.d.ts

@@ -0,0 +1,8 @@
+/** Low-level AppServer JSON-RPC transport. Contracts live in `@dotcraft/sdk/contracts`. */
+export { DotCraftWireClient } from "./client.js";
+export type { DotCraftWireClientOptions, NotificationHandler, ServerRequestHandler, Unsubscribe, WireConnectionState, } from "./client.js";
+export { JsonRpcError, ReconnectQueueFullError, RequestTimeoutError, } from "./errors.js";
+export { ERR_ALREADY_INITIALIZED, ERR_APPROVAL_TIMEOUT, ERR_CHANNEL_REJECTED, ERR_CRON_NOT_FOUND, ERR_NOT_INITIALIZED, ERR_THREAD_NOT_ACTIVE, ERR_THREAD_NOT_FOUND, ERR_TURN_IN_PROGRESS, ERR_TURN_NOT_FOUND, ERR_TURN_NOT_RUNNING, JsonRpcMessage, } from "./models.js";
+export { StdioTransport, TransportClosed, TransportError, WebSocketTransport, } from "./transport.js";
+export type { Transport, WebSocketTransportOptions } from "./transport.js";
+//# sourceMappingURL=wire.d.ts.map

package/dist/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,SAAS,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/wire.js

@@ -0,0 +1,6 @@
+/** Low-level AppServer JSON-RPC transport. Contracts live in `@dotcraft/sdk/contracts`. */
+export { DotCraftWireClient } from "./client.js";
+export { JsonRpcError, ReconnectQueueFullError, RequestTimeoutError, } from "./errors.js";
+export { ERR_ALREADY_INITIALIZED, ERR_APPROVAL_TIMEOUT, ERR_CHANNEL_REJECTED, ERR_CRON_NOT_FOUND, ERR_NOT_INITIALIZED, ERR_THREAD_NOT_ACTIVE, ERR_THREAD_NOT_FOUND, ERR_TURN_IN_PROGRESS, ERR_TURN_NOT_FOUND, ERR_TURN_NOT_RUNNING, JsonRpcMessage, } from "./models.js";
+export { StdioTransport, TransportClosed, TransportError, WebSocketTransport, } from "./transport.js";
+//# sourceMappingURL=wire.js.map

package/dist/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAQjD,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}