@miao-ai/node 0.1.0

package/dist/process-transport.d.ts

@@ -0,0 +1,36 @@
+import { type MiaoTransport } from "@miao-ai/client";
+import { type RuntimeDescriptor, type RuntimeFrame, type RuntimeProfile } from "@miao-ai/protocol";
+import { type RuntimeBinaryResolverOptions } from "./binary.js";
+export interface ProcessTransportOptions extends RuntimeBinaryResolverOptions {
+    profile?: RuntimeProfile;
+    /** Runtime state directory passed as --miao-dir. */
+    dataDir?: string;
+    /** Passed by environment for Runtime builds that support workspace selection. */
+    workspaceRoot?: string;
+    env?: NodeJS.ProcessEnv;
+    /** Secrets are injected only through the child environment and are always redacted from stderr. */
+    secrets?: Readonly<Record<string, string | undefined>>;
+    onStderr?: (line: string) => void;
+    startupTimeoutMs?: number;
+    shutdownTimeoutMs?: number;
+    maxLineBytes?: number;
+    maxStderrLineBytes?: number;
+    frameBufferSize?: number;
+    expectedPlatformVersion?: string | ((platformVersion: string) => boolean);
+    skipDescriptorCheck?: boolean;
+    /** Non-secret arguments inserted before miao-runtime arguments (useful for executable wrappers). */
+    binaryArguments?: readonly string[];
+}
+/** A strict NDJSON transport backed by a managed miao-runtime child process. */
+export declare class ProcessTransport implements MiaoTransport {
+    #private;
+    constructor(options?: ProcessTransportOptions);
+    get descriptor(): RuntimeDescriptor | undefined;
+    get pid(): number | undefined;
+    connect(): Promise<void>;
+    send(frame: RuntimeFrame): Promise<void>;
+    frames(): AsyncIterable<RuntimeFrame>;
+    close(): Promise<void>;
+    kill(): Promise<void>;
+}
+//# sourceMappingURL=process-transport.d.ts.map

package/dist/process-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-transport.d.ts","sourceRoot":"","sources":["../src/process-transport.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAwB,KAAK,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAOtF,MAAM,WAAW,uBAAwB,SAAQ,4BAA4B;IAC3E,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,mGAAmG;IACnG,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC1E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oGAAoG;IACpG,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAgJD,gFAAgF;AAChF,qBAAa,gBAAiB,YAAW,aAAa;;gBAYxC,OAAO,GAAE,uBAA4B;IAOjD,IAAI,UAAU,IAAI,iBAAiB,GAAG,SAAS,CAE9C;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyCxB,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C,MAAM,IAAI,aAAa,CAAC,YAAY,CAAC;IAI/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA+D5B"}

package/dist/process-transport.js

@@ -0,0 +1,303 @@
+import { spawn } from "node:child_process";
+import { once } from "node:events";
+import { resolve } from "node:path";
+import { RuntimeExitedError, RuntimeSpawnError } from "@miao-ai/client";
+import { RUNTIME_PROTOCOL_VERSION, } from "@miao-ai/protocol";
+import { AsyncQueue } from "./async-queue.js";
+import { resolveRuntimeBinary } from "./binary.js";
+import { NodeTransportError, RuntimeDescriptorMismatchError, } from "./errors.js";
+import { encodeFrameLine, StrictFrameDecoder } from "./ndjson.js";
+function waitForChildExit(child, timeoutMs) {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return Promise.resolve(true);
+    return new Promise((resolveWait) => {
+        const onExit = () => {
+            clearTimeout(timer);
+            resolveWait(true);
+        };
+        const timer = setTimeout(() => {
+            child.removeListener("exit", onExit);
+            resolveWait(false);
+        }, timeoutMs);
+        child.once("exit", onExit);
+    });
+}
+function environment(options) {
+    const env = { ...process.env };
+    for (const [name, value] of Object.entries(options.env ?? {})) {
+        if (value === undefined)
+            delete env[name];
+        else
+            env[name] = value;
+    }
+    for (const [name, value] of Object.entries(options.secrets ?? {})) {
+        if (value === undefined)
+            delete env[name];
+        else
+            env[name] = value;
+    }
+    env.MIAO_RUNTIME_PROFILE = options.profile ?? "stable";
+    if (options.workspaceRoot)
+        env.MIAO_WORKSPACE_ROOT = resolve(options.workspaceRoot);
+    return env;
+}
+function redactor(options) {
+    const values = new Set();
+    for (const [name, value] of [
+        ...Object.entries(options.secrets ?? {}),
+        ...Object.entries(options.env ?? {}),
+    ]) {
+        if (value && /(secret|token|password|api.?key|credential)/i.test(name))
+            values.add(value);
+    }
+    const ordered = [...values].sort((left, right) => right.length - left.length);
+    return (value) => ordered.reduce((text, secret) => text.split(secret).join("[REDACTED]"), value);
+}
+function binaryArguments(options) {
+    const args = [...(options.binaryArguments ?? [])];
+    const secrets = Object.values(options.secrets ?? {}).filter((value) => Boolean(value));
+    if (args.some((argument) => secrets.some((secret) => argument.includes(secret)))) {
+        throw new RuntimeSpawnError("refusing to place a configured secret in Runtime process arguments");
+    }
+    return args;
+}
+function assertDescriptor(value, options) {
+    if (!value || typeof value !== "object") {
+        throw new RuntimeDescriptorMismatchError("Miao Runtime describe output is not an object");
+    }
+    const descriptor = value;
+    if (descriptor.protocolVersion !== RUNTIME_PROTOCOL_VERSION) {
+        throw new RuntimeDescriptorMismatchError(`Miao Runtime protocol ${String(descriptor.protocolVersion)} is incompatible with ${RUNTIME_PROTOCOL_VERSION}`);
+    }
+    const profile = options.profile ?? "stable";
+    if (descriptor.profile !== profile) {
+        throw new RuntimeDescriptorMismatchError(`Miao Runtime profile ${String(descriptor.profile)} does not match requested profile ${profile}`);
+    }
+    if (typeof descriptor.platformVersion !== "string" || descriptor.platformVersion.length === 0) {
+        throw new RuntimeDescriptorMismatchError("Miao Runtime descriptor has no platform version");
+    }
+    const expectation = options.expectedPlatformVersion;
+    const compatible = expectation === undefined ||
+        (typeof expectation === "string"
+            ? descriptor.platformVersion === expectation
+            : expectation(descriptor.platformVersion));
+    if (!compatible) {
+        throw new RuntimeDescriptorMismatchError(`Miao Runtime platform version ${descriptor.platformVersion} is not accepted by this host`);
+    }
+}
+async function inspectRuntime(binaryPath, options) {
+    const dataDir = resolve(options.dataDir ?? ".miao");
+    const child = spawn(binaryPath, [...binaryArguments(options), "--miao-dir", dataDir, "describe", "--json"], {
+        cwd: options.cwd,
+        env: environment(options),
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+        shell: false,
+    });
+    const redact = redactor(options);
+    let stdout = "";
+    let stderr = "";
+    child.stdout.setEncoding("utf8");
+    child.stderr.setEncoding("utf8");
+    child.stdout.on("data", (chunk) => {
+        stdout += chunk;
+        if (stdout.length > 1024 * 1024)
+            child.kill("SIGKILL");
+    });
+    child.stderr.on("data", (chunk) => {
+        stderr += redact(chunk);
+        if (stderr.length > 64 * 1024)
+            stderr = stderr.slice(-64 * 1024);
+    });
+    const timeout = setTimeout(() => child.kill("SIGKILL"), options.startupTimeoutMs ?? 10_000);
+    let result;
+    try {
+        result = (await once(child, "exit"));
+    }
+    catch (error) {
+        throw new RuntimeSpawnError("failed to inspect the Miao Runtime binary", { cause: error });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    if (result[0] !== 0) {
+        throw new RuntimeSpawnError(`Miao Runtime describe failed (code=${result[0] ?? "none"}, signal=${result[1] ?? "none"})${stderr.trim() ? `: ${stderr.trim()}` : ""}`);
+    }
+    let descriptor;
+    try {
+        descriptor = JSON.parse(stdout.trim());
+    }
+    catch (error) {
+        throw new RuntimeDescriptorMismatchError("Miao Runtime describe returned invalid JSON", { cause: error });
+    }
+    assertDescriptor(descriptor, options);
+    return { descriptor, stderr };
+}
+/** A strict NDJSON transport backed by a managed miao-runtime child process. */
+export class ProcessTransport {
+    #options;
+    #frames;
+    #maxStderrLineBytes;
+    #child;
+    #decoder;
+    #connected = false;
+    #closing = false;
+    #exitListener;
+    #descriptor;
+    #stderrRemainder = "";
+    constructor(options = {}) {
+        this.#options = options;
+        this.#frames = new AsyncQueue(options.frameBufferSize ?? 256);
+        this.#decoder = new StrictFrameDecoder(options.maxLineBytes);
+        this.#maxStderrLineBytes = positive(options.maxStderrLineBytes ?? 64 * 1024, "maxStderrLineBytes");
+    }
+    get descriptor() {
+        return this.#descriptor;
+    }
+    get pid() {
+        return this.#child?.pid;
+    }
+    async connect() {
+        if (this.#connected)
+            return;
+        if (this.#closing)
+            throw new NodeTransportError("cannot reconnect a closed ProcessTransport");
+        const binaryPath = await resolveRuntimeBinary(this.#options);
+        if (!this.#options.skipDescriptorCheck) {
+            this.#descriptor = (await inspectRuntime(binaryPath, this.#options)).descriptor;
+        }
+        const dataDir = resolve(this.#options.dataDir ?? ".miao");
+        const child = spawn(binaryPath, [...binaryArguments(this.#options), "--miao-dir", dataDir, "serve"], {
+            cwd: this.#options.cwd,
+            env: environment(this.#options),
+            stdio: ["pipe", "pipe", "pipe"],
+            windowsHide: true,
+            shell: false,
+        });
+        this.#child = child;
+        child.stdout.on("data", (chunk) => this.#receiveStdout(chunk));
+        child.stderr.setEncoding("utf8");
+        child.stderr.on("data", (chunk) => this.#receiveStderr(chunk));
+        child.once("exit", (code, signal) => this.#onExit(code, signal));
+        const spawned = new Promise((resolveSpawn, rejectSpawn) => {
+            child.once("spawn", resolveSpawn);
+            child.once("error", rejectSpawn);
+        });
+        const timeout = setTimeout(() => child.kill("SIGKILL"), this.#options.startupTimeoutMs ?? 10_000);
+        try {
+            await spawned;
+        }
+        catch (error) {
+            this.#child = undefined;
+            throw new RuntimeSpawnError("failed to start the Miao Runtime process", { cause: error });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        this.#connected = true;
+        this.#exitListener = () => child.kill("SIGTERM");
+        process.once("exit", this.#exitListener);
+    }
+    async send(frame) {
+        const child = this.#child;
+        if (!this.#connected || !child || !child.stdin.writable) {
+            throw new NodeTransportError("Miao Runtime process is not connected");
+        }
+        const line = encodeFrameLine(frame);
+        if (!child.stdin.write(line, "utf8"))
+            await once(child.stdin, "drain");
+    }
+    frames() {
+        return this.#frames;
+    }
+    async close() {
+        if (this.#closing)
+            return;
+        this.#closing = true;
+        const child = this.#child;
+        if (!child) {
+            this.#frames.close();
+            return;
+        }
+        child.stdin.end();
+        const graceful = await waitForChildExit(child, this.#options.shutdownTimeoutMs ?? 5_000);
+        if (!graceful && child.exitCode === null) {
+            child.kill("SIGTERM");
+            const terminated = await waitForChildExit(child, 1_000);
+            if (!terminated && child.exitCode === null)
+                child.kill("SIGKILL");
+        }
+        this.#frames.close();
+    }
+    async kill() {
+        if (this.#closing)
+            return;
+        this.#closing = true;
+        const child = this.#child;
+        if (child && child.exitCode === null) {
+            child.kill("SIGKILL");
+            await once(child, "exit").catch(() => undefined);
+        }
+        this.#frames.close();
+    }
+    #receiveStdout(chunk) {
+        try {
+            for (const frame of this.#decoder.push(chunk))
+                this.#frames.push(frame);
+        }
+        catch (error) {
+            this.#frames.fail(new NodeTransportError("invalid data on Runtime protocol stdout", { cause: error }));
+            this.#child?.kill("SIGKILL");
+        }
+    }
+    #receiveStderr(chunk) {
+        const redact = redactor(this.#options);
+        const text = this.#stderrRemainder + chunk;
+        const lines = text.split(/\r?\n/);
+        this.#stderrRemainder = lines.pop() ?? "";
+        for (const line of lines)
+            this.#emitStderr(redact(line));
+        if (Buffer.byteLength(this.#stderrRemainder, "utf8") > this.#maxStderrLineBytes) {
+            this.#stderrRemainder = "";
+            this.#emitStderr(`[stderr line exceeded ${this.#maxStderrLineBytes} bytes and was discarded]`);
+        }
+    }
+    #emitStderr(line) {
+        if (this.#options.onStderr)
+            this.#options.onStderr(line);
+        else
+            process.stderr.write(`[miao-runtime] ${line}\n`);
+    }
+    #onExit(code, signal) {
+        const wasClosing = this.#closing;
+        this.#connected = false;
+        this.#child = undefined;
+        if (this.#exitListener)
+            process.removeListener("exit", this.#exitListener);
+        this.#exitListener = undefined;
+        if (this.#stderrRemainder) {
+            this.#emitStderr(redactor(this.#options)(this.#stderrRemainder));
+            this.#stderrRemainder = "";
+        }
+        try {
+            for (const frame of this.#decoder.finish())
+                this.#frames.push(frame);
+        }
+        catch (error) {
+            if (!wasClosing)
+                this.#frames.fail(new NodeTransportError("truncated Runtime protocol stdout", { cause: error }));
+            return;
+        }
+        if (wasClosing)
+            this.#frames.close();
+        else {
+            this.#frames.fail(new RuntimeExitedError(`Miao Runtime exited unexpectedly (code=${code ?? "none"}, signal=${signal ?? "none"})`, { code: "runtime_exited", retryable: true, details: { exitCode: code, signal } }));
+        }
+    }
+}
+function positive(value, name) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new RangeError(`${name} must be a positive safe integer`);
+    return value;
+}
+//# sourceMappingURL=process-transport.js.map

package/dist/process-transport.js.map

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

package/dist/socket-transport.d.ts

@@ -0,0 +1,31 @@
+import type { MiaoTransport } from "@miao-ai/client";
+import type { RuntimeFrame } from "@miao-ai/protocol";
+export type SocketEndpoint = {
+    path: string;
+    host?: never;
+    port?: never;
+} | {
+    path?: never;
+    host?: string;
+    port: number;
+};
+export interface SocketTransportOptions {
+    endpoint?: SocketEndpoint;
+    socketPath?: string;
+    host?: string;
+    port?: number;
+    connectTimeoutMs?: number;
+    closeTimeoutMs?: number;
+    maxLineBytes?: number;
+    frameBufferSize?: number;
+}
+/** Runtime Protocol NDJSON over a Unix socket, Windows named pipe, or TCP socket. */
+export declare class SocketTransport implements MiaoTransport {
+    #private;
+    constructor(options: SocketTransportOptions);
+    connect(): Promise<void>;
+    send(frame: RuntimeFrame): Promise<void>;
+    frames(): AsyncIterable<RuntimeFrame>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=socket-transport.d.ts.map

package/dist/socket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-transport.d.ts","sourceRoot":"","sources":["../src/socket-transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,GAC5C;IAAE,IAAI,CAAC,EAAE,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA0BD,qFAAqF;AACrF,qBAAa,eAAgB,YAAW,aAAa;;gBAQvC,OAAO,EAAE,sBAAsB;IAMrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BxB,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C,MAAM,IAAI,aAAa,CAAC,YAAY,CAAC;IAI/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA2C7B"}

package/dist/socket-transport.js

@@ -0,0 +1,130 @@
+import { createConnection } from "node:net";
+import { once } from "node:events";
+import { AsyncQueue } from "./async-queue.js";
+import { NodeTransportError } from "./errors.js";
+import { encodeFrameLine, StrictFrameDecoder } from "./ndjson.js";
+function endpoint(options) {
+    if (options.endpoint)
+        return options.endpoint;
+    if (options.socketPath)
+        return { path: options.socketPath };
+    if (options.port !== undefined) {
+        return { ...(options.host === undefined ? {} : { host: options.host }), port: options.port };
+    }
+    throw new TypeError("SocketTransport requires socketPath, endpoint, or port");
+}
+function waitForSocketClose(socket, timeoutMs) {
+    if (socket.closed || socket.destroyed)
+        return Promise.resolve(true);
+    return new Promise((resolveWait) => {
+        const onClose = () => {
+            clearTimeout(timer);
+            resolveWait(true);
+        };
+        const timer = setTimeout(() => {
+            socket.removeListener("close", onClose);
+            resolveWait(false);
+        }, timeoutMs);
+        socket.once("close", onClose);
+    });
+}
+/** Runtime Protocol NDJSON over a Unix socket, Windows named pipe, or TCP socket. */
+export class SocketTransport {
+    #options;
+    #frames;
+    #decoder;
+    #socket;
+    #connected = false;
+    #closing = false;
+    constructor(options) {
+        this.#options = options;
+        this.#frames = new AsyncQueue(options.frameBufferSize ?? 256);
+        this.#decoder = new StrictFrameDecoder(options.maxLineBytes);
+    }
+    async connect() {
+        if (this.#connected)
+            return;
+        if (this.#closing)
+            throw new NodeTransportError("cannot reconnect a closed SocketTransport");
+        const target = endpoint(this.#options);
+        const socket = "path" in target && target.path
+            ? createConnection(target.path)
+            : createConnection({ host: target.host, port: target.port });
+        this.#socket = socket;
+        socket.on("data", (chunk) => this.#receive(chunk));
+        socket.once("end", () => this.#finishInput());
+        socket.once("close", (hadError) => this.#onClose(hadError));
+        const connected = new Promise((resolveConnect, rejectConnect) => {
+            socket.once("connect", resolveConnect);
+            socket.once("error", rejectConnect);
+        });
+        const timeout = setTimeout(() => socket.destroy(new NodeTransportError("timed out connecting to Miao Runtime socket")), this.#options.connectTimeoutMs ?? 10_000);
+        try {
+            await connected;
+            this.#connected = true;
+        }
+        catch (error) {
+            socket.destroy();
+            throw new NodeTransportError("failed to connect to Miao Runtime socket", { cause: error });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async send(frame) {
+        const socket = this.#socket;
+        if (!this.#connected || !socket?.writable) {
+            throw new NodeTransportError("Miao Runtime socket is not connected");
+        }
+        if (!socket.write(encodeFrameLine(frame), "utf8"))
+            await once(socket, "drain");
+    }
+    frames() {
+        return this.#frames;
+    }
+    async close() {
+        if (this.#closing)
+            return;
+        this.#closing = true;
+        const socket = this.#socket;
+        if (!socket) {
+            this.#frames.close();
+            return;
+        }
+        socket.end();
+        const graceful = await waitForSocketClose(socket, this.#options.closeTimeoutMs ?? 2_000);
+        if (!graceful && !socket.destroyed)
+            socket.destroy();
+        this.#frames.close();
+    }
+    #receive(chunk) {
+        try {
+            for (const frame of this.#decoder.push(chunk))
+                this.#frames.push(frame);
+        }
+        catch (error) {
+            this.#frames.fail(new NodeTransportError("invalid data on Runtime socket", { cause: error }));
+            this.#socket?.destroy();
+        }
+    }
+    #finishInput() {
+        try {
+            for (const frame of this.#decoder.finish())
+                this.#frames.push(frame);
+        }
+        catch (error) {
+            if (!this.#closing)
+                this.#frames.fail(new NodeTransportError("truncated Runtime socket frame", { cause: error }));
+        }
+    }
+    #onClose(hadError) {
+        this.#connected = false;
+        this.#socket = undefined;
+        if (this.#closing)
+            this.#frames.close();
+        else {
+            this.#frames.fail(new NodeTransportError(hadError ? "Miao Runtime socket disconnected after an error" : "Miao Runtime socket disconnected"));
+        }
+    }
+}
+//# sourceMappingURL=socket-transport.js.map

package/dist/socket-transport.js.map

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

package/dist/websocket-transport.d.ts

@@ -0,0 +1,49 @@
+import type { MiaoTransport } from "@miao-ai/client";
+import { type RuntimeFrame } from "@miao-ai/protocol";
+import { type AuthenticationOptions, type ReconnectOptions } from "./auth.js";
+export interface WebSocketEventLike {
+    data?: unknown;
+    code?: number;
+    reason?: string;
+    error?: unknown;
+}
+export interface WebSocketLike {
+    readonly readyState: number;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: "open" | "message" | "error" | "close", listener: (event: WebSocketEventLike) => void): void;
+    removeEventListener?(type: "open" | "message" | "error" | "close", listener: (event: WebSocketEventLike) => void): void;
+}
+export interface WebSocketFactoryOptions {
+    headers: Readonly<Record<string, string>>;
+    protocols?: string | readonly string[];
+}
+export type WebSocketFactory = (url: string, options: WebSocketFactoryOptions) => WebSocketLike | Promise<WebSocketLike>;
+export interface RemoteResumeContext {
+    attempt: number;
+    /** Highest delivered sequence for every Runtime subscription. */
+    subscriptions: ReadonlyMap<string, number>;
+}
+export interface WebSocketTransportOptions {
+    url: string;
+    authentication?: AuthenticationOptions;
+    protocols?: string | readonly string[];
+    webSocketFactory?: WebSocketFactory;
+    reconnect?: ReconnectOptions;
+    /** Frames returned here are sent after a reconnect, enabling explicit event resume. */
+    resumeFrames?: (context: RemoteResumeContext) => readonly RuntimeFrame[] | Promise<readonly RuntimeFrame[]>;
+    onReconnect?: (context: RemoteResumeContext) => void | Promise<void>;
+    frameBufferSize?: number;
+    connectTimeoutMs?: number;
+    maxFrameBytes?: number;
+}
+/** Runtime Protocol over WebSocket with bounded reconnect and explicit resume hooks. */
+export declare class WebSocketTransport implements MiaoTransport {
+    #private;
+    constructor(options: WebSocketTransportOptions);
+    connect(): Promise<void>;
+    send(frame: RuntimeFrame): Promise<void>;
+    frames(): AsyncIterable<RuntimeFrame>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=websocket-transport.d.ts.map

package/dist/websocket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.d.ts","sourceRoot":"","sources":["../src/websocket-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAA0C,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE9F,OAAO,EAKL,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AAGnB,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;IACpH,mBAAmB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;CACzH;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,uBAAuB,KAC7B,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACvC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,uFAAuF;IACvF,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IAC5G,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA2CD,wFAAwF;AACxF,qBAAa,kBAAmB,YAAW,aAAa;;gBAc1C,OAAO,EAAE,yBAAyB;IASxC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBxB,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C,MAAM,IAAI,aAAa,CAAC,YAAY,CAAC;IAI/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA0G7B"}