@crow-agent/server 0.0.0-stage → 0.1.0

package/dist/transports/unix/unix-listener.js

@@ -0,0 +1,511 @@
+import { createHash, randomUUID, } from "node:crypto";
+import { chmod, link, lstat, mkdir, rename, unlink, } from "node:fs/promises";
+import { createConnection, createServer, } from "node:net";
+import { dirname, join, } from "node:path";
+import { DEFAULT_MAX_FRAME_LENGTH } from "@crow-agent/protocol";
+const DEFAULT_SOCKET_MODE = 0o600;
+const DEFAULT_GRACEFUL_CLOSE_TIMEOUT_MS = 5000;
+const MAX_UINT32 = 0xffffffff;
+const MAX_TIMER_DELAY_MS = 2147483647;
+const SOCKET_PROBE_TIMEOUT_MS = 1000;
+class UnixSocketListener {
+    #resolved;
+    #socketPath;
+    #socketMode;
+    #live = new Set();
+    #netServer;
+    #boundIdentity;
+    #stagingPath;
+    #stopping = false;
+    #stopTask;
+    #acceptor;
+    constructor(options) {
+        const resolved = resolveListenerOptions(options);
+        this.#resolved = resolved;
+        this.#socketPath = resolved.path;
+        this.#socketMode = resolved.mode;
+    }
+    async start(accept) {
+        if (this.#netServer !== undefined)
+            throw new Error("Unix listener is already started");
+        if (this.#stopping)
+            throw new Error("Unix listener is closing or closed");
+        this.#acceptor = accept;
+        const stagingPath = await this.prepareStagingPath();
+        const netServer = createServer((socket) => this.handleSocket(socket));
+        netServer.on("error", (error) => this.noteError(error));
+        this.#netServer = netServer;
+        try {
+            await this.bindServer(netServer, stagingPath);
+            await this.publishSocket(stagingPath);
+        }
+        catch (error) {
+            await this.shutdownNetServer(netServer);
+            this.#netServer = undefined;
+            throw error;
+        }
+    }
+    async close() {
+        const stopping = this.#stopTask;
+        if (stopping !== undefined)
+            return stopping;
+        this.#stopping = true;
+        const task = this.closeInternal();
+        this.#stopTask = task;
+        return task;
+    }
+    async prepareStagingPath() {
+        const stagingPath = ownedBindPath(this.#socketPath);
+        const dir = dirname(this.#socketPath);
+        await mkdir(dir, { recursive: true, mode: 0o700 });
+        await clearStaleSocket(this.#socketPath);
+        await clearStaleSocket(stagingPath);
+        this.#stagingPath = stagingPath;
+        return stagingPath;
+    }
+    bindServer(netServer, stagingPath) {
+        return new Promise((resolve, reject) => {
+            function onError(error) {
+                netServer.off("listening", onListening);
+                reject(error);
+            }
+            function onListening() {
+                netServer.off("error", onError);
+                resolve();
+            }
+            netServer.once("error", onError);
+            netServer.once("listening", onListening);
+            netServer.listen(stagingPath);
+        });
+    }
+    async publishSocket(stagingPath) {
+        const stats = await lstat(stagingPath);
+        if (!stats.isSocket()) {
+            throw new Error(`Unix listener path is not a socket after binding: ${stagingPath}`);
+        }
+        this.#boundIdentity = { dev: stats.dev, ino: stats.ino };
+        await link(stagingPath, this.#socketPath);
+        await applySocketMode(this.#socketPath, this.#socketMode);
+        await deletePath(stagingPath);
+        this.#stagingPath = undefined;
+    }
+    handleSocket(socket) {
+        if (this.#stopping) {
+            socket.destroy();
+            return;
+        }
+        const timeoutMs = this.#resolved.gracefulCloseTimeoutMs;
+        const maxBytes = this.#resolved.maxPendingBytes;
+        const connection = new UnixByteConnection(socket, timeoutMs, maxBytes);
+        this.#live.add(connection);
+        const acceptor = this.#acceptor;
+        if (acceptor === undefined) {
+            socket.destroy();
+            return;
+        }
+        const handler = acceptor(connection);
+        const onData = (chunk) => {
+            const bytes = new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength);
+            handler.onData(bytes);
+        };
+        const onSocketError = (error) => {
+            handler.onError(error);
+            socket.destroy();
+        };
+        const onClose = () => {
+            connection.markClosed();
+            this.#live.delete(connection);
+            handler.onClose();
+        };
+        socket.on("data", onData);
+        socket.on("error", onSocketError);
+        socket.once("close", onClose);
+    }
+    async closeInternal() {
+        const netServer = this.#netServer;
+        const serverClosed = netServer === undefined ? this.removeOwnedSocket() : this.shutdownNetServer(netServer);
+        const connections = [...this.#live];
+        await Promise.all(connections.map((connection) => connection.close()));
+        await serverClosed;
+        const staging = this.#stagingPath;
+        if (staging !== undefined)
+            await deletePath(staging);
+        this.#stagingPath = undefined;
+        this.#live.clear();
+        this.#netServer = undefined;
+    }
+    async shutdownNetServer(netServer) {
+        try {
+            await closeNetServer(netServer, (error) => this.noteError(error));
+        }
+        finally {
+            // An unpublished staging bind path goes before the public socket path.
+            const staging = this.#stagingPath;
+            if (staging !== undefined)
+                await deletePath(staging);
+            this.#stagingPath = undefined;
+            await this.removeOwnedSocket();
+        }
+    }
+    async removeOwnedSocket() {
+        const identity = this.#boundIdentity;
+        this.#boundIdentity = undefined;
+        if (identity === undefined)
+            return;
+        const current = await this.lstatOwnedPath();
+        if (current === undefined)
+            return;
+        if (!current.isSocket() || current.dev !== identity.dev || current.ino !== identity.ino)
+            return;
+        await this.quarantineOwnedSocket(identity);
+    }
+    async lstatOwnedPath() {
+        try {
+            return await lstat(this.#socketPath);
+        }
+        catch (error) {
+            if (hasErrorCode(error, "ENOENT"))
+                return undefined;
+            throw error;
+        }
+    }
+    async quarantineOwnedSocket(identity) {
+        const dir = dirname(this.#socketPath);
+        const preserved = join(dir, `cleanup-${randomUUID().slice(0, 6)}`);
+        try {
+            await rename(this.#socketPath, preserved);
+        }
+        catch (error) {
+            if (hasErrorCode(error, "ENOENT"))
+                return;
+            throw error;
+        }
+        const moved = await lstat(preserved);
+        const intact = moved.isSocket() && moved.dev === identity.dev && moved.ino === identity.ino;
+        if (intact) {
+            await deletePath(preserved);
+            return;
+        }
+        await this.restoreQuarantinedSocket(preserved);
+    }
+    async restoreQuarantinedSocket(preserved) {
+        let exists = true;
+        try {
+            await lstat(this.#socketPath);
+        }
+        catch (error) {
+            if (hasErrorCode(error, "ENOENT"))
+                exists = false;
+            else
+                throw error;
+        }
+        if (!exists)
+            await rename(preserved, this.#socketPath);
+        throw new Error(`Unix listener path changed during cleanup; preserved replacement at ${preserved}`);
+    }
+    noteError(error) {
+        const normalized = error instanceof Error ? error : new Error(String(error));
+        try {
+            this.#resolved.onError?.(normalized);
+        }
+        catch {
+            // Listener state is unaffected by observer failures.
+        }
+    }
+}
+/** Exported for transport-level verification; not part of the public API surface. */
+export class UnixByteConnection {
+    #socket;
+    #gracefulCloseTimeoutMs;
+    #maxPendingBytes;
+    #pendingBytes = 0;
+    #closed = false;
+    #closing = false;
+    #writeTail = Promise.resolve();
+    #closeTask;
+    #finishClose;
+    constructor(socket, gracefulCloseTimeoutMs, maxPendingBytes) {
+        this.#socket = socket;
+        this.#gracefulCloseTimeoutMs = gracefulCloseTimeoutMs;
+        this.#maxPendingBytes = maxPendingBytes;
+    }
+    get closed() {
+        return this.#closed;
+    }
+    send(chunk) {
+        if (!(chunk instanceof Uint8Array)) {
+            return Promise.reject(new TypeError("Unix connection chunks must be Uint8Array"));
+        }
+        if (this.#closed || this.#closing) {
+            return Promise.reject(new Error("Unix connection is closed"));
+        }
+        const pending = this.#pendingBytes + chunk.byteLength;
+        if (pending > this.#maxPendingBytes) {
+            return Promise.reject(new Error("Unix connection exceeded its pending byte limit"));
+        }
+        this.#pendingBytes = pending;
+        const bytes = chunk.slice();
+        const write = this.#writeTail.then(() => this.flush(bytes));
+        const tracked = write.finally(() => {
+            this.#pendingBytes = this.#pendingBytes - bytes.byteLength;
+        });
+        this.#writeTail = tracked.catch(noop);
+        return tracked;
+    }
+    close(finalChunk) {
+        if (this.#closed || this.#socket.destroyed) {
+            this.markClosed();
+            return Promise.resolve();
+        }
+        const pending = this.#closeTask;
+        if (pending !== undefined)
+            return pending;
+        this.#closing = true;
+        const finalBytes = finalChunk === undefined ? undefined : finalChunk.slice();
+        const task = new Promise((resolve) => {
+            this.#finishClose = resolve;
+            const timer = setTimeout(() => this.forceClose(), this.#gracefulCloseTimeoutMs);
+            timer.unref();
+            this.#socket.once("close", () => clearTimeout(timer));
+            void this.#writeTail.then(() => this.endSocket(finalBytes));
+        });
+        this.#closeTask = task;
+        return task;
+    }
+    markClosed() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#closing = true;
+        const finish = this.#finishClose;
+        this.#finishClose = undefined;
+        finish?.();
+    }
+    forceClose() {
+        if (!this.#socket.destroyed)
+            this.#socket.destroy();
+        this.markClosed();
+    }
+    endSocket(finalBytes) {
+        if (this.#socket.destroyed) {
+            this.markClosed();
+            return;
+        }
+        try {
+            if (finalBytes !== undefined)
+                this.#socket.end(finalBytes);
+            else
+                this.#socket.end();
+        }
+        catch {
+            this.#socket.destroy();
+        }
+    }
+    flush(chunk) {
+        const writable = !this.#closed && !this.#closing && this.#socket.writable;
+        if (!writable)
+            return Promise.reject(new Error("Unix connection is closed"));
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const done = (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                this.#socket.off("close", onClose);
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            };
+            const onClose = () => {
+                done(new Error("Unix connection closed during write"));
+            };
+            this.#socket.once("close", onClose);
+            try {
+                this.#socket.write(chunk, done);
+            }
+            catch (error) {
+                const failure = error instanceof Error ? error : new Error(String(error));
+                done(failure);
+            }
+        });
+    }
+}
+function noop() { }
+function ownedBindPath(path) {
+    const digest = createHash("sha256").update(path).digest("hex");
+    const suffix = digest.slice(0, 8);
+    return join(dirname(path), `bind-${suffix}`);
+}
+async function clearStaleSocket(path) {
+    const original = await lstatSocketPath(path);
+    if (original === undefined)
+        return;
+    if (!original.isSocket()) {
+        throw new Error(`Refusing to remove non-socket Unix listener path: ${path}`);
+    }
+    const live = await probeSocket(path);
+    if (live)
+        throw new Error(`Unix listener is already running: ${path}`);
+    await quarantineStaleSocket(path, original);
+}
+async function lstatSocketPath(path) {
+    try {
+        return await lstat(path);
+    }
+    catch (error) {
+        if (hasErrorCode(error, "ENOENT"))
+            return undefined;
+        throw error;
+    }
+}
+async function quarantineStaleSocket(path, original) {
+    const preserved = join(dirname(path), `stale-${randomUUID().slice(0, 6)}`);
+    try {
+        await rename(path, preserved);
+    }
+    catch (error) {
+        if (hasErrorCode(error, "ENOENT"))
+            return;
+        throw error;
+    }
+    const current = await lstat(preserved);
+    const sameFile = current.isSocket() && current.dev === original.dev && current.ino === original.ino;
+    if (!sameFile) {
+        await restoreStaleSocket(path, preserved);
+    }
+    await deletePath(preserved);
+}
+async function restoreStaleSocket(path, preserved) {
+    let exists = true;
+    try {
+        await lstat(path);
+    }
+    catch (error) {
+        if (hasErrorCode(error, "ENOENT"))
+            exists = false;
+        else
+            throw error;
+    }
+    if (!exists)
+        await rename(preserved, path);
+    throw new Error(`Unix listener path changed while checking for a stale socket: ${path}`);
+}
+async function deletePath(path) {
+    try {
+        await unlink(path);
+    }
+    catch (error) {
+        if (!hasErrorCode(error, "ENOENT"))
+            throw error;
+    }
+}
+function probeSocket(path) {
+    return new Promise((resolve, reject) => {
+        const socket = createConnection(path);
+        let settled = false;
+        const timer = setTimeout(() => finish(true), SOCKET_PROBE_TIMEOUT_MS);
+        timer.unref();
+        const finish = (result, error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            socket.removeAllListeners();
+            socket.destroy();
+            if (error !== undefined)
+                reject(error);
+            else
+                resolve(result);
+        };
+        const onConnect = () => finish(true);
+        const onError = (error) => {
+            const dead = ["ECONNREFUSED", "ENOENT", "EPIPE", "ECONNRESET"].includes(error.code ?? "");
+            if (dead)
+                finish(false);
+            else
+                finish(false, error);
+        };
+        socket.once("connect", onConnect);
+        socket.once("error", onError);
+    });
+}
+async function applySocketMode(path, mode) {
+    if (process.platform === "win32")
+        return;
+    try {
+        await chmod(path, mode);
+    }
+    catch (error) {
+        const unsupported = hasErrorCode(error, "ENOSYS") || hasErrorCode(error, "ENOTSUP");
+        if (!unsupported)
+            throw error;
+    }
+}
+function closeNetServer(server, noteError) {
+    if (!server.listening)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        server.close((error) => {
+            if (error !== undefined)
+                noteError(error);
+            resolve();
+        });
+    });
+}
+function hasErrorCode(error, code) {
+    if (!(error instanceof Error))
+        return false;
+    return "code" in error && error.code === code;
+}
+export function createUnixListener(options) {
+    return new UnixSocketListener(options);
+}
+function resolveListenerOptions(options) {
+    const path = requireSocketPath(options.path);
+    const mode = requireSocketMode(options.mode);
+    const maxFrameLength = requireMaxFrameLength(options.maxFrameLength);
+    const maxPendingBytes = requireMaxPendingBytes(options.maxPendingBytes, maxFrameLength);
+    const gracefulCloseTimeoutMs = requireGracefulCloseTimeoutMs(options.gracefulCloseTimeoutMs);
+    return {
+        path,
+        mode,
+        maxPendingBytes,
+        gracefulCloseTimeoutMs,
+        onError: options.onError,
+    };
+}
+function requireSocketPath(path) {
+    if (!path)
+        throw new TypeError("Unix listener requires a non-empty socket path");
+    return path;
+}
+function requireSocketMode(mode) {
+    const value = mode ?? DEFAULT_SOCKET_MODE;
+    const valid = Number.isInteger(value) && value >= 0 && value <= 0o777;
+    if (!valid)
+        throw new TypeError("Unix socket mode must be an integer from 0 to 0o777");
+    return value;
+}
+function requireMaxFrameLength(maxFrameLength) {
+    const value = maxFrameLength ?? DEFAULT_MAX_FRAME_LENGTH;
+    const valid = Number.isSafeInteger(value) && value > 0 && value <= MAX_UINT32;
+    if (!valid)
+        throw new TypeError(`maxFrameLength must be a positive integer up to ${MAX_UINT32}`);
+    return value;
+}
+function requireMaxPendingBytes(maxPendingBytes, maxFrameLength) {
+    const value = maxPendingBytes ?? maxFrameLength * 4;
+    const valid = Number.isSafeInteger(value) && value >= maxFrameLength + 4;
+    if (!valid)
+        throw new TypeError("maxPendingBytes must be a safe integer of at least maxFrameLength + 4");
+    return value;
+}
+function requireGracefulCloseTimeoutMs(gracefulCloseTimeoutMs) {
+    const value = gracefulCloseTimeoutMs ?? DEFAULT_GRACEFUL_CLOSE_TIMEOUT_MS;
+    const valid = Number.isSafeInteger(value) && value > 0 && value <= MAX_TIMER_DELAY_MS;
+    if (!valid)
+        throw new TypeError(`gracefulCloseTimeoutMs must be an integer from 1 to ${MAX_TIMER_DELAY_MS}`);
+    return value;
+}
+//# sourceMappingURL=unix-listener.js.map

package/dist/transports/unix/unix-listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-listener.js","sourceRoot":"","sources":["../../../src/transports/unix/unix-listener.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tcreateHash,\n\trandomUUID,\n} from \"node:crypto\";\nimport type {\n\tStats,\n} from \"node:fs\";\nimport {\n\tchmod,\n\tlink,\n\tlstat,\n\tmkdir,\n\trename,\n\tunlink,\n} from \"node:fs/promises\";\nimport {\n\tcreateConnection,\n\tcreateServer,\n\ttype Server,\n\ttype Socket,\n} from \"node:net\";\nimport {\n\tdirname,\n\tjoin,\n} from \"node:path\";\nimport { DEFAULT_MAX_FRAME_LENGTH } from \"@crow-agent/protocol\";\nimport type {\n\tByteConnection,\n\tByteConnectionAcceptor,\n} from \"../../server-connection.ts\";\nimport type {\n\tServerListener,\n} from \"../../server-listener.ts\";\nimport type {\n\tUnixListenerOptions,\n} from \"./unix-types.ts\";\n\nconst DEFAULT_SOCKET_MODE = 0o600;\nconst DEFAULT_GRACEFUL_CLOSE_TIMEOUT_MS = 5000;\nconst MAX_UINT32 = 0xffffffff;\nconst MAX_TIMER_DELAY_MS = 2147483647;\nconst SOCKET_PROBE_TIMEOUT_MS = 1000;\n\ntype ResolvedListenerOptions = {\n\tpath: string;\n\tmode: number;\n\tmaxPendingBytes: number;\n\tgracefulCloseTimeoutMs: number;\n\tonError?: (error: Error) => void;\n};\n\ntype SocketIdentity = {\n\tino: number;\n\tdev: number;\n};\n\nclass UnixSocketListener implements ServerListener {\n\t#resolved: ResolvedListenerOptions;\n\t#socketPath: string;\n\t#socketMode: number;\n\t#live = new Set<UnixByteConnection>();\n\t#netServer: Server | undefined;\n\t#boundIdentity: SocketIdentity | undefined;\n\t#stagingPath: string | undefined;\n\t#stopping = false;\n\t#stopTask: Promise<void> | undefined;\n\t#acceptor: ByteConnectionAcceptor | undefined;\n\n\tconstructor(\n\t\toptions: UnixListenerOptions,\n\t) {\n\t\tconst resolved = resolveListenerOptions(options);\n\t\tthis.#resolved = resolved;\n\t\tthis.#socketPath = resolved.path;\n\t\tthis.#socketMode = resolved.mode;\n\t}\n\n\tasync start(\n\t\taccept: ByteConnectionAcceptor,\n\t): Promise<void> {\n\t\tif (this.#netServer !== undefined) throw new Error(\"Unix listener is already started\");\n\t\tif (this.#stopping) throw new Error(\"Unix listener is closing or closed\");\n\t\tthis.#acceptor = accept;\n\n\t\tconst stagingPath = await this.prepareStagingPath();\n\t\tconst netServer = createServer((socket) => this.handleSocket(socket));\n\t\tnetServer.on(\"error\", (error) => this.noteError(error));\n\t\tthis.#netServer = netServer;\n\t\ttry {\n\t\t\tawait this.bindServer(netServer, stagingPath);\n\t\t\tawait this.publishSocket(stagingPath);\n\t\t} catch (error) {\n\t\t\tawait this.shutdownNetServer(netServer);\n\t\t\tthis.#netServer = undefined;\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tasync close():\n\t\tPromise<void> {\n\t\tconst stopping = this.#stopTask;\n\t\tif (stopping !== undefined) return stopping;\n\t\tthis.#stopping = true;\n\t\tconst task = this.closeInternal();\n\t\tthis.#stopTask = task;\n\t\treturn task;\n\t}\n\n\tprivate async prepareStagingPath(): Promise<string> {\n\t\tconst stagingPath = ownedBindPath(this.#socketPath);\n\t\tconst dir = dirname(this.#socketPath);\n\t\tawait mkdir(dir, { recursive: true, mode: 0o700 });\n\t\tawait clearStaleSocket(this.#socketPath);\n\t\tawait clearStaleSocket(stagingPath);\n\t\tthis.#stagingPath = stagingPath;\n\t\treturn stagingPath;\n\t}\n\n\tprivate bindServer(netServer: Server, stagingPath: string): Promise<void> {\n\t\treturn new Promise<void>((resolve, reject) => {\n\t\t\tfunction onError(error: Error): void {\n\t\t\t\tnetServer.off(\"listening\", onListening);\n\t\t\t\treject(error);\n\t\t\t}\n\t\t\tfunction onListening(): void {\n\t\t\t\tnetServer.off(\"error\", onError);\n\t\t\t\tresolve();\n\t\t\t}\n\t\t\tnetServer.once(\"error\", onError);\n\t\t\tnetServer.once(\"listening\", onListening);\n\t\t\tnetServer.listen(stagingPath);\n\t\t});\n\t}\n\n\tprivate async publishSocket(stagingPath: string): Promise<void> {\n\t\tconst stats = await lstat(stagingPath);\n\t\tif (!stats.isSocket()) {\n\t\t\tthrow new Error(`Unix listener path is not a socket after binding: ${stagingPath}`);\n\t\t}\n\t\tthis.#boundIdentity = { dev: stats.dev, ino: stats.ino };\n\t\tawait link(stagingPath, this.#socketPath);\n\t\tawait applySocketMode(this.#socketPath, this.#socketMode);\n\t\tawait deletePath(stagingPath);\n\t\tthis.#stagingPath = undefined;\n\t}\n\n\tprivate handleSocket(socket: Socket): void {\n\t\tif (this.#stopping) {\n\t\t\tsocket.destroy();\n\t\t\treturn;\n\t\t}\n\t\tconst timeoutMs = this.#resolved.gracefulCloseTimeoutMs;\n\t\tconst maxBytes = this.#resolved.maxPendingBytes;\n\t\tconst connection = new UnixByteConnection(socket, timeoutMs, maxBytes);\n\t\tthis.#live.add(connection);\n\t\tconst acceptor = this.#acceptor;\n\t\tif (acceptor === undefined) {\n\t\t\tsocket.destroy();\n\t\t\treturn;\n\t\t}\n\t\tconst handler = acceptor(connection);\n\t\tconst onData = (chunk: Buffer): void => {\n\t\t\tconst bytes = new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength);\n\t\t\thandler.onData(bytes);\n\t\t};\n\t\tconst onSocketError = (error: Error): void => {\n\t\t\thandler.onError(error);\n\t\t\tsocket.destroy();\n\t\t};\n\t\tconst onClose = (): void => {\n\t\t\tconnection.markClosed();\n\t\t\tthis.#live.delete(connection);\n\t\t\thandler.onClose();\n\t\t};\n\t\tsocket.on(\"data\", onData);\n\t\tsocket.on(\"error\", onSocketError);\n\t\tsocket.once(\"close\", onClose);\n\t}\n\n\tprivate async closeInternal():\n\t\tPromise<void> {\n\t\tconst netServer = this.#netServer;\n\t\tconst serverClosed =\n\t\t\tnetServer === undefined ? this.removeOwnedSocket() : this.shutdownNetServer(netServer);\n\t\tconst connections = [...this.#live];\n\t\tawait Promise.all(connections.map((connection) => connection.close()));\n\t\tawait serverClosed;\n\t\tconst staging = this.#stagingPath;\n\t\tif (staging !== undefined) await deletePath(staging);\n\t\tthis.#stagingPath = undefined;\n\t\tthis.#live.clear();\n\t\tthis.#netServer = undefined;\n\t}\n\n\tprivate async shutdownNetServer(netServer: Server): Promise<void> {\n\t\ttry {\n\t\t\tawait closeNetServer(netServer, (error) => this.noteError(error));\n\t\t} finally {\n\t\t\t// An unpublished staging bind path goes before the public socket path.\n\t\t\tconst staging = this.#stagingPath;\n\t\t\tif (staging !== undefined) await deletePath(staging);\n\t\t\tthis.#stagingPath = undefined;\n\t\t\tawait this.removeOwnedSocket();\n\t\t}\n\t}\n\n\tprivate async removeOwnedSocket(): Promise<void> {\n\t\tconst identity = this.#boundIdentity;\n\t\tthis.#boundIdentity = undefined;\n\t\tif (identity === undefined) return;\n\t\tconst current = await this.lstatOwnedPath();\n\t\tif (current === undefined) return;\n\t\tif (!current.isSocket() || current.dev !== identity.dev || current.ino !== identity.ino) return;\n\t\tawait this.quarantineOwnedSocket(identity);\n\t}\n\n\tprivate async lstatOwnedPath(): Promise<Stats | undefined> {\n\t\ttry {\n\t\t\treturn await lstat(this.#socketPath);\n\t\t} catch (error) {\n\t\t\tif (hasErrorCode(error, \"ENOENT\")) return undefined;\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tprivate async quarantineOwnedSocket(identity: SocketIdentity): Promise<void> {\n\t\tconst dir = dirname(this.#socketPath);\n\t\tconst preserved = join(dir, `cleanup-${randomUUID().slice(0, 6)}`);\n\t\ttry {\n\t\t\tawait rename(this.#socketPath, preserved);\n\t\t} catch (error) {\n\t\t\tif (hasErrorCode(error, \"ENOENT\")) return;\n\t\t\tthrow error;\n\t\t}\n\t\tconst moved = await lstat(preserved);\n\t\tconst intact = moved.isSocket() && moved.dev === identity.dev && moved.ino === identity.ino;\n\t\tif (intact) {\n\t\t\tawait deletePath(preserved);\n\t\t\treturn;\n\t\t}\n\t\tawait this.restoreQuarantinedSocket(preserved);\n\t}\n\n\tprivate async restoreQuarantinedSocket(preserved: string): Promise<void> {\n\t\tlet exists = true;\n\t\ttry {\n\t\t\tawait lstat(this.#socketPath);\n\t\t} catch (error) {\n\t\t\tif (hasErrorCode(error, \"ENOENT\")) exists = false;\n\t\t\telse throw error;\n\t\t}\n\t\tif (!exists) await rename(preserved, this.#socketPath);\n\t\tthrow new Error(`Unix listener path changed during cleanup; preserved replacement at ${preserved}`);\n\t}\n\n\tprivate noteError(error: unknown): void {\n\t\tconst normalized = error instanceof Error ? error : new Error(String(error));\n\t\ttry {\n\t\t\tthis.#resolved.onError?.(normalized);\n\t\t} catch {\n\t\t\t// Listener state is unaffected by observer failures.\n\t\t}\n\t}\n}\n\n/** Exported for transport-level verification; not part of the public API surface. */\nexport class UnixByteConnection implements ByteConnection {\n\t#socket: Socket;\n\t#gracefulCloseTimeoutMs: number;\n\t#maxPendingBytes: number;\n\t#pendingBytes = 0;\n\t#closed = false;\n\t#closing = false;\n\t#writeTail: Promise<void> = Promise.resolve();\n\t#closeTask: Promise<void> | undefined;\n\t#finishClose: (() => void) | undefined;\n\n\tconstructor(socket: Socket, gracefulCloseTimeoutMs: number, maxPendingBytes: number) {\n\t\tthis.#socket = socket;\n\t\tthis.#gracefulCloseTimeoutMs = gracefulCloseTimeoutMs;\n\t\tthis.#maxPendingBytes = maxPendingBytes;\n\t}\n\n\tget closed(): boolean {\n\t\treturn this.#closed;\n\t}\n\n\tsend(chunk: Uint8Array): Promise<void> {\n\t\tif (!(chunk instanceof Uint8Array)) {\n\t\t\treturn Promise.reject(new TypeError(\"Unix connection chunks must be Uint8Array\"));\n\t\t}\n\t\tif (this.#closed || this.#closing) {\n\t\t\treturn Promise.reject(new Error(\"Unix connection is closed\"));\n\t\t}\n\t\tconst pending = this.#pendingBytes + chunk.byteLength;\n\t\tif (pending > this.#maxPendingBytes) {\n\t\t\treturn Promise.reject(new Error(\"Unix connection exceeded its pending byte limit\"));\n\t\t}\n\t\tthis.#pendingBytes = pending;\n\t\tconst bytes = chunk.slice();\n\t\tconst write = this.#writeTail.then(() => this.flush(bytes));\n\t\tconst tracked = write.finally(() => {\n\t\t\tthis.#pendingBytes = this.#pendingBytes - bytes.byteLength;\n\t\t});\n\t\tthis.#writeTail = tracked.catch(noop);\n\t\treturn tracked;\n\t}\n\n\tclose(finalChunk?: Uint8Array): Promise<void> {\n\t\tif (this.#closed || this.#socket.destroyed) {\n\t\t\tthis.markClosed();\n\t\t\treturn Promise.resolve();\n\t\t}\n\t\tconst pending = this.#closeTask;\n\t\tif (pending !== undefined) return pending;\n\t\tthis.#closing = true;\n\t\tconst finalBytes = finalChunk === undefined ? undefined : finalChunk.slice();\n\t\tconst task = new Promise<void>((resolve) => {\n\t\t\tthis.#finishClose = resolve;\n\t\t\tconst timer = setTimeout(() => this.forceClose(), this.#gracefulCloseTimeoutMs);\n\t\t\ttimer.unref();\n\t\t\tthis.#socket.once(\"close\", () => clearTimeout(timer));\n\t\t\tvoid this.#writeTail.then(() => this.endSocket(finalBytes));\n\t\t});\n\t\tthis.#closeTask = task;\n\t\treturn task;\n\t}\n\n\tmarkClosed(): void {\n\t\tif (this.#closed) return;\n\t\tthis.#closed = true;\n\t\tthis.#closing = true;\n\t\tconst finish = this.#finishClose;\n\t\tthis.#finishClose = undefined;\n\t\tfinish?.();\n\t}\n\n\tprivate forceClose(): void {\n\t\tif (!this.#socket.destroyed) this.#socket.destroy();\n\t\tthis.markClosed();\n\t}\n\n\tprivate endSocket(finalBytes: Uint8Array | undefined): void {\n\t\tif (this.#socket.destroyed) {\n\t\t\tthis.markClosed();\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tif (finalBytes !== undefined) this.#socket.end(finalBytes);\n\t\t\telse this.#socket.end();\n\t\t} catch {\n\t\t\tthis.#socket.destroy();\n\t\t}\n\t}\n\n\tprivate flush(chunk: Uint8Array): Promise<void> {\n\t\tconst writable = !this.#closed && !this.#closing && this.#socket.writable;\n\t\tif (!writable) return Promise.reject(new Error(\"Unix connection is closed\"));\n\t\treturn new Promise<void>((resolve, reject) => {\n\t\t\tlet settled = false;\n\t\t\tconst done = (error?: Error | null): void => {\n\t\t\t\tif (settled) return;\n\t\t\t\tsettled = true;\n\t\t\t\tthis.#socket.off(\"close\", onClose);\n\t\t\t\tif (error) reject(error);\n\t\t\t\telse resolve();\n\t\t\t};\n\t\t\tconst onClose = (): void => {\n\t\t\t\tdone(new Error(\"Unix connection closed during write\"));\n\t\t\t};\n\t\t\tthis.#socket.once(\"close\", onClose);\n\t\t\ttry {\n\t\t\t\tthis.#socket.write(chunk, done);\n\t\t\t} catch (error) {\n\t\t\t\tconst failure = error instanceof Error ? error : new Error(String(error));\n\t\t\t\tdone(failure);\n\t\t\t}\n\t\t});\n\t}\n}\n\nfunction noop(): void {}\n\nfunction ownedBindPath(path: string): string {\n\tconst digest = createHash(\"sha256\").update(path).digest(\"hex\");\n\tconst suffix = digest.slice(0, 8);\n\treturn join(dirname(path), `bind-${suffix}`);\n}\n\nasync function clearStaleSocket(path: string): Promise<void> {\n\tconst original = await lstatSocketPath(path);\n\tif (original === undefined) return;\n\tif (!original.isSocket()) {\n\t\tthrow new Error(`Refusing to remove non-socket Unix listener path: ${path}`);\n\t}\n\tconst live = await probeSocket(path);\n\tif (live) throw new Error(`Unix listener is already running: ${path}`);\n\tawait quarantineStaleSocket(path, original);\n}\n\nasync function lstatSocketPath(path: string): Promise<Stats | undefined> {\n\ttry {\n\t\treturn await lstat(path);\n\t} catch (error) {\n\t\tif (hasErrorCode(error, \"ENOENT\")) return undefined;\n\t\tthrow error;\n\t}\n}\n\nasync function quarantineStaleSocket(path: string, original: Stats): Promise<void> {\n\tconst preserved = join(dirname(path), `stale-${randomUUID().slice(0, 6)}`);\n\ttry {\n\t\tawait rename(path, preserved);\n\t} catch (error) {\n\t\tif (hasErrorCode(error, \"ENOENT\")) return;\n\t\tthrow error;\n\t}\n\tconst current = await lstat(preserved);\n\tconst sameFile = current.isSocket() && current.dev === original.dev && current.ino === original.ino;\n\tif (!sameFile) {\n\t\tawait restoreStaleSocket(path, preserved);\n\t}\n\tawait deletePath(preserved);\n}\n\nasync function restoreStaleSocket(path: string, preserved: string): Promise<never> {\n\tlet exists = true;\n\ttry {\n\t\tawait lstat(path);\n\t} catch (error) {\n\t\tif (hasErrorCode(error, \"ENOENT\")) exists = false;\n\t\telse throw error;\n\t}\n\tif (!exists) await rename(preserved, path);\n\tthrow new Error(`Unix listener path changed while checking for a stale socket: ${path}`);\n}\n\nasync function deletePath(path: string): Promise<void> {\n\ttry {\n\t\tawait unlink(path);\n\t} catch (error) {\n\t\tif (!hasErrorCode(error, \"ENOENT\")) throw error;\n\t}\n}\n\nfunction probeSocket(path: string): Promise<boolean> {\n\treturn new Promise<boolean>((resolve, reject) => {\n\t\tconst socket = createConnection(path);\n\t\tlet settled = false;\n\t\tconst timer = setTimeout(() => finish(true), SOCKET_PROBE_TIMEOUT_MS);\n\t\ttimer.unref();\n\t\tconst finish = (result: boolean, error?: Error): void => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tclearTimeout(timer);\n\t\t\tsocket.removeAllListeners();\n\t\t\tsocket.destroy();\n\t\t\tif (error !== undefined) reject(error);\n\t\t\telse resolve(result);\n\t\t};\n\t\tconst onConnect = (): void => finish(true);\n\t\tconst onError = (error: NodeJS.ErrnoException): void => {\n\t\t\tconst dead = [\"ECONNREFUSED\", \"ENOENT\", \"EPIPE\", \"ECONNRESET\"].includes(error.code ?? \"\");\n\t\t\tif (dead) finish(false);\n\t\t\telse finish(false, error);\n\t\t};\n\t\tsocket.once(\"connect\", onConnect);\n\t\tsocket.once(\"error\", onError);\n\t});\n}\n\nasync function applySocketMode(path: string, mode: number): Promise<void> {\n\tif (process.platform === \"win32\") return;\n\ttry {\n\t\tawait chmod(path, mode);\n\t} catch (error) {\n\t\tconst unsupported = hasErrorCode(error, \"ENOSYS\") || hasErrorCode(error, \"ENOTSUP\");\n\t\tif (!unsupported) throw error;\n\t}\n}\n\nfunction closeNetServer(server: Server, noteError: (error: Error) => void): Promise<void> {\n\tif (!server.listening) return Promise.resolve();\n\treturn new Promise<void>((resolve) => {\n\t\tserver.close((error) => {\n\t\t\tif (error !== undefined) noteError(error);\n\t\t\tresolve();\n\t\t});\n\t});\n}\n\nfunction hasErrorCode(error: unknown, code: string): boolean {\n\tif (!(error instanceof Error)) return false;\n\treturn \"code\" in error && error.code === code;\n}\n\nexport function createUnixListener(\n\toptions: UnixListenerOptions,\n): ServerListener {\n\treturn new UnixSocketListener(options);\n}\n\nfunction resolveListenerOptions(options: UnixListenerOptions): ResolvedListenerOptions {\n\tconst path = requireSocketPath(options.path);\n\tconst mode = requireSocketMode(options.mode);\n\tconst maxFrameLength = requireMaxFrameLength(options.maxFrameLength);\n\tconst maxPendingBytes = requireMaxPendingBytes(options.maxPendingBytes, maxFrameLength);\n\tconst gracefulCloseTimeoutMs = requireGracefulCloseTimeoutMs(options.gracefulCloseTimeoutMs);\n\treturn {\n\t\tpath,\n\t\tmode,\n\t\tmaxPendingBytes,\n\t\tgracefulCloseTimeoutMs,\n\t\tonError: options.onError,\n\t};\n}\n\nfunction requireSocketPath(path: string): string {\n\tif (!path) throw new TypeError(\"Unix listener requires a non-empty socket path\");\n\treturn path;\n}\n\nfunction requireSocketMode(mode: number | undefined): number {\n\tconst value = mode ?? DEFAULT_SOCKET_MODE;\n\tconst valid = Number.isInteger(value) && value >= 0 && value <= 0o777;\n\tif (!valid) throw new TypeError(\"Unix socket mode must be an integer from 0 to 0o777\");\n\treturn value;\n}\n\nfunction requireMaxFrameLength(maxFrameLength: number | undefined): number {\n\tconst value = maxFrameLength ?? DEFAULT_MAX_FRAME_LENGTH;\n\tconst valid = Number.isSafeInteger(value) && value > 0 && value <= MAX_UINT32;\n\tif (!valid) throw new TypeError(`maxFrameLength must be a positive integer up to ${MAX_UINT32}`);\n\treturn value;\n}\n\nfunction requireMaxPendingBytes(maxPendingBytes: number | undefined, maxFrameLength: number): number {\n\tconst value = maxPendingBytes ?? maxFrameLength * 4;\n\tconst valid = Number.isSafeInteger(value) && value >= maxFrameLength + 4;\n\tif (!valid) throw new TypeError(\"maxPendingBytes must be a safe integer of at least maxFrameLength + 4\");\n\treturn value;\n}\n\nfunction requireGracefulCloseTimeoutMs(gracefulCloseTimeoutMs: number | undefined): number {\n\tconst value = gracefulCloseTimeoutMs ?? DEFAULT_GRACEFUL_CLOSE_TIMEOUT_MS;\n\tconst valid = Number.isSafeInteger(value) && value > 0 && value <= MAX_TIMER_DELAY_MS;\n\tif (!valid) throw new TypeError(`gracefulCloseTimeoutMs must be an integer from 1 to ${MAX_TIMER_DELAY_MS}`);\n\treturn value;\n}\n"]}

package/dist/transports/unix/unix-preset.d.ts

@@ -0,0 +1,7 @@
+import type { SessionMetadata } from "@crow-agent/agent-core";
+import { Server } from "../../session-server.ts";
+import type { ServerHost } from "../../server-types.ts";
+import type { UnixServerOptions } from "./unix-types.ts";
+/** Builds a Server fronted by one Unix-domain socket listener. */
+export declare function createUnixServer<TMetadata extends SessionMetadata>(host: ServerHost<TMetadata>, options: UnixServerOptions): Server<TMetadata>;
+//# sourceMappingURL=unix-preset.d.ts.map

package/dist/transports/unix/unix-preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-preset.d.ts","sourceRoot":"","sources":["../../../src/transports/unix/unix-preset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACN,MAAM,EACN,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACX,UAAU,EACV,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EACX,iBAAiB,EACjB,MAAM,iBAAiB,CAAC;AAEzB,kEAAkE;AAClE,wBAAgB,gBAAgB,CAC/B,SAAS,SAAS,eAAe,EAChC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,SAAS,CAAC,CA8B5E"}

package/dist/transports/unix/unix-preset.js

@@ -0,0 +1,25 @@
+import { Server, } from "../../session-server.js";
+import { createUnixListener, } from "./unix-listener.js";
+/** Builds a Server fronted by one Unix-domain socket listener. */
+export function createUnixServer(host, options) {
+    const { path, mode, maxFrameLength, maxPendingBytes, gracefulCloseTimeoutMs, handshakeTimeoutMs, onConnectionCountChanged, serverId, onError, } = options;
+    const listenerOptions = {
+        path,
+        mode,
+        maxFrameLength,
+        maxPendingBytes,
+        gracefulCloseTimeoutMs,
+        onError,
+    };
+    const listener = createUnixListener(listenerOptions);
+    const serverOptions = {
+        listeners: [listener],
+        maxFrameLength,
+        handshakeTimeoutMs,
+        onConnectionCountChanged,
+        serverId,
+        onError,
+    };
+    return new Server(host, serverOptions);
+}
+//# sourceMappingURL=unix-preset.js.map

package/dist/transports/unix/unix-preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-preset.js","sourceRoot":"","sources":["../../../src/transports/unix/unix-preset.ts"],"names":[],"mappings":"AACA,OAAO,EACN,MAAM,GACN,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EACN,kBAAkB,GAClB,MAAM,oBAAoB,CAAC;AAK5B,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAE9B,IAA2B,EAAE,OAA0B;IACxD,MAAM,EACL,IAAI,EACJ,IAAI,EACJ,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,QAAQ,EACR,OAAO,GACP,GAAG,OAAO,CAAC;IACZ,MAAM,eAAe,GAAG;QACvB,IAAI;QACJ,IAAI;QACJ,cAAc;QACd,eAAe;QACf,sBAAsB;QACtB,OAAO;KACP,CAAC;IACF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,aAAa,GAAG;QACrB,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,cAAc;QACd,kBAAkB;QAClB,wBAAwB;QACxB,QAAQ;QACR,OAAO;KACP,CAAC;IACF,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AACxC,CAAC","sourcesContent":["import type { SessionMetadata } from \"@crow-agent/agent-core\";\nimport {\n\tServer,\n} from \"../../session-server.ts\";\nimport type {\n\tServerHost,\n} from \"../../server-types.ts\";\nimport {\n\tcreateUnixListener,\n} from \"./unix-listener.ts\";\nimport type {\n\tUnixServerOptions,\n} from \"./unix-types.ts\";\n\n/** Builds a Server fronted by one Unix-domain socket listener. */\nexport function createUnixServer<\n\tTMetadata extends SessionMetadata,\n>(host: ServerHost<TMetadata>, options: UnixServerOptions): Server<TMetadata> {\n\tconst {\n\t\tpath,\n\t\tmode,\n\t\tmaxFrameLength,\n\t\tmaxPendingBytes,\n\t\tgracefulCloseTimeoutMs,\n\t\thandshakeTimeoutMs,\n\t\tonConnectionCountChanged,\n\t\tserverId,\n\t\tonError,\n\t} = options;\n\tconst listenerOptions = {\n\t\tpath,\n\t\tmode,\n\t\tmaxFrameLength,\n\t\tmaxPendingBytes,\n\t\tgracefulCloseTimeoutMs,\n\t\tonError,\n\t};\n\tconst listener = createUnixListener(listenerOptions);\n\tconst serverOptions = {\n\t\tlisteners: [listener],\n\t\tmaxFrameLength,\n\t\thandshakeTimeoutMs,\n\t\tonConnectionCountChanged,\n\t\tserverId,\n\t\tonError,\n\t};\n\treturn new Server(host, serverOptions);\n}\n"]}

package/dist/transports/unix/unix-types.d.ts

@@ -0,0 +1,14 @@
+import type { ServerOptions } from "../../server-types.ts";
+export type UnixListenerOptions = {
+    path: string;
+    /** Socket filesystem permissions. Owner read/write only (0o600) by default. */
+    mode?: number;
+    /** Framed bytes queued per connection before a slow peer is dropped. */
+    maxPendingBytes?: number;
+    gracefulCloseTimeoutMs?: number;
+    /** Derives and validates maxPendingBytes. Must match the server when customized. */
+    maxFrameLength?: number;
+    onError?: (error: Error) => void;
+};
+export type UnixServerOptions = Omit<ServerOptions, "listeners"> & UnixListenerOptions;
+//# sourceMappingURL=unix-types.d.ts.map

package/dist/transports/unix/unix-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-types.d.ts","sourceRoot":"","sources":["../../../src/transports/unix/unix-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EACb,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,eAAe,CAAC,EACf,MAAM,CAAC;IACR,sBAAsB,CAAC,EACtB,MAAM,CAAC;IACR,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,CACT,KAAK,EAAE,KAAK,KACR,IAAI,CAAC;CACV,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,mBAAmB,CAAC"}

package/dist/transports/unix/unix-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=unix-types.js.map

package/dist/transports/unix/unix-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-types.js","sourceRoot":"","sources":["../../../src/transports/unix/unix-types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tServerOptions,\n} from \"../../server-types.ts\";\n\nexport type UnixListenerOptions = {\n\tpath: string;\n\t/** Socket filesystem permissions. Owner read/write only (0o600) by default. */\n\tmode?: number;\n\t/** Framed bytes queued per connection before a slow peer is dropped. */\n\tmaxPendingBytes?:\n\t\tnumber;\n\tgracefulCloseTimeoutMs?:\n\t\tnumber;\n\t/** Derives and validates maxPendingBytes. Must match the server when customized. */\n\tmaxFrameLength?: number;\n\tonError?: (\n\t\terror: Error,\n\t) => void;\n};\n\nexport type UnixServerOptions = Omit<ServerOptions, \"listeners\"> & UnixListenerOptions;\n"]}