@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/tool-runtime/worker-tools.js

@@ -0,0 +1,63 @@
+/**
+ * Worker tool ceiling. Private MCP binding stays with the host catalog
+ * view; this reads registered entries, recipes, and behavior tools.
+ */
+import { AGENT_ASK, AGENT_MESSAGE, AGENT_NOTIFY, AGENT_RESPOND, AGENT_SEND, AGENT_VOID, AskAgentSpec, isSideChannelToolName, SCHEME_REPL_TOOL_NAME, SCHEME_WATCH_TOOL_NAME, } from "@inhuman.tools/harness-model";
+import { behaviorEntriesOf, catalogTriggersReactLoop } from "../tool-catalog/index.js";
+function isAgentComms(wire) {
+    return (wire === AGENT_RESPOND ||
+        wire === AGENT_VOID ||
+        wire === AGENT_NOTIFY ||
+        wire === AGENT_MESSAGE ||
+        wire === AGENT_SEND ||
+        wire === AGENT_ASK);
+}
+function askWorkerToolAllowed(wire) {
+    if (wire === AGENT_VOID)
+        return false;
+    return (wire === SCHEME_REPL_TOOL_NAME ||
+        wire === SCHEME_WATCH_TOOL_NAME ||
+        isSideChannelToolName(wire) ||
+        isAgentComms(wire));
+}
+export function workerToolAllowed(catalog, recipeName, wire, sessionRoot) {
+    const spec = sessionRoot?.agent.spec;
+    if (spec instanceof AskAgentSpec) {
+        if (wire === AGENT_VOID)
+            return spec.voidLegal === true;
+        if (behaviorEntriesOf(sessionRoot).some((entry) => entry.wireName === wire))
+            return true;
+        if (spec.inheritCallerTools)
+            return true;
+        if (askWorkerToolAllowed(wire))
+            return true;
+        if (spec.tools?.includes(wire) === true)
+            return true;
+        if (spec.name === "" || spec.toolsOnly)
+            return false;
+        const named = catalog.recipe(spec.name);
+        return named?.spec.tools.includes(wire) === true;
+    }
+    if (wire === AGENT_VOID && spec?.voidLegal === false)
+        return false;
+    if (recipeName === "")
+        return true;
+    if (behaviorEntriesOf(sessionRoot).some((entry) => entry.wireName === wire))
+        return true;
+    const recipe = catalog.recipe(recipeName);
+    if (recipe == null)
+        return false;
+    if (catalog.privateWorkerEntries.some((row) => row.wireName === wire))
+        return true;
+    const entry = catalog.catalogEntry(wire);
+    if (entry == null)
+        return false;
+    if (wire === SCHEME_REPL_TOOL_NAME ||
+        wire === SCHEME_WATCH_TOOL_NAME ||
+        !catalogTriggersReactLoop(catalog, wire) ||
+        isAgentComms(wire)) {
+        return true;
+    }
+    return recipe.spec.tools.includes(wire) === true;
+}
+//# sourceMappingURL=worker-tools.js.map

package/dist/tool-runtime/worker-tools.js.map

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

package/dist/tool-runtime/write-admit.d.ts

@@ -0,0 +1,16 @@
+export declare function overwriteExistingDoor(pathText: string): string;
+/** True only for boolean true or the string "true". Missing / false → door on exist. */
+export declare function overwriteExistingOf(args: unknown): boolean;
+/** Tape line annotation. Line 1 is omitted. */
+export declare function lineStartOfSpan(file: string | null | undefined, span: string): number | null;
+/** NUL-free UTF-8 under the read budget. Empty file is "". */
+export declare function priorTextSync(target: string): string | null;
+type WriteAdmitSnap = {
+    /** `null` means we could not tell — not a definite miss. */
+    readonly existed: boolean | null;
+    readonly priorContent: string | null;
+    readonly refuse: string | null;
+};
+export declare function writeFileAdmitSnap(root: string, argsJson: string): WriteAdmitSnap;
+export {};
+//# sourceMappingURL=write-admit.d.ts.map

package/dist/tool-runtime/write-admit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-admit.d.ts","sourceRoot":"","sources":["../../src/tool-runtime/write-admit.ts"],"names":[],"mappings":"AAcA,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAK1D;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY5F;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU3D;AAED,KAAK,cAAc,GAAG;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAcjF"}

package/dist/tool-runtime/write-admit.js

@@ -0,0 +1,74 @@
+/**
+ * write_file overwrite gate and admit snapshot. Effect bodies stay
+ * outside this package; this is the door the guard still sees.
+ */
+import { existsSync, readFileSync, statSync } from "node:fs";
+import path from "node:path";
+import { parseJsonRecord } from "@inhuman.tools/harness-model/json-record";
+const MAX_FILE_READ_BYTES = 4 * 1024 * 1024;
+const OVERWRITE_EXISTING_DOOR = "tried to overwrite the existing file, use write_file with the overwriteExisting flag if you need that to happen";
+export function overwriteExistingDoor(pathText) {
+    return `write_file: ${pathText} exists — ${OVERWRITE_EXISTING_DOOR}`;
+}
+/** True only for boolean true or the string "true". Missing / false → door on exist. */
+export function overwriteExistingOf(args) {
+    if (args == null || typeof args !== "object")
+        return false;
+    const rec = args;
+    const value = rec.overwriteExisting ?? rec.overwrite_existing ?? rec.overwrite;
+    return value === true || value === "true";
+}
+/** Tape line annotation. Line 1 is omitted. */
+export function lineStartOfSpan(file, span) {
+    if (file == null || span === "")
+        return null;
+    let idx = file.indexOf(span);
+    if (idx === -1) {
+        const firstLine = span.split("\n")[0] ?? "";
+        if (firstLine === "" || firstLine === span)
+            return null;
+        idx = file.indexOf(firstLine);
+    }
+    if (idx === -1)
+        return null;
+    let line = 1;
+    for (let i = 0; i < idx; i++)
+        if (file[i] === "\n")
+            line++;
+    return line <= 1 ? null : line;
+}
+/** NUL-free UTF-8 under the read budget. Empty file is "". */
+export function priorTextSync(target) {
+    try {
+        const info = statSync(target);
+        if (!info.isFile() || info.size > MAX_FILE_READ_BYTES)
+            return null;
+        const buf = readFileSync(target);
+        if (buf.includes(0))
+            return null;
+        return buf.toString("utf8");
+    }
+    catch {
+        return null;
+    }
+}
+export function writeFileAdmitSnap(root, argsJson) {
+    const args = parseJsonRecord(argsJson === "" ? "{}" : argsJson);
+    const raw = args !== null && typeof args.path === "string" ? args.path : "";
+    if (raw.trim() === "")
+        return { existed: null, priorContent: null, refuse: null };
+    const target = path.resolve(root, raw);
+    try {
+        if (!existsSync(target))
+            return { existed: false, priorContent: null, refuse: null };
+        if (!statSync(target).isFile())
+            return { existed: null, priorContent: null, refuse: null };
+    }
+    catch {
+        return { existed: null, priorContent: null, refuse: null };
+    }
+    const priorContent = priorTextSync(target);
+    const refuse = overwriteExistingOf(args ?? {}) ? null : overwriteExistingDoor(raw);
+    return { existed: true, priorContent, refuse };
+}
+//# sourceMappingURL=write-admit.js.map

package/dist/tool-runtime/write-admit.js.map

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

package/dist/transport/frames.d.ts

@@ -0,0 +1,12 @@
+import * as Y from "yjs";
+export declare const MESSAGE_SYNC = 0;
+export declare const MESSAGE_AWARENESS = 1;
+/** y-websocket `messageQueryAwareness`. Inbound counts as traffic for its 30s watchdog. */
+export declare const MESSAGE_QUERY_AWARENESS = 3;
+export declare function encodeDocUpdate(update: Uint8Array): Uint8Array;
+export declare function replyLensSyncFrame(frame: Uint8Array, live: Y.Doc): Uint8Array | null;
+export declare function peekMessageType(frame: Uint8Array): number;
+export declare function encodeQueryAwareness(): Uint8Array;
+export declare function encodeAwarenessFrame(payload: Uint8Array): Uint8Array;
+export declare function decodeAwarenessPayload(frame: Uint8Array): Uint8Array | null;
+//# sourceMappingURL=frames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../src/transport/frames.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,2FAA2F;AAC3F,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAK9D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,GAAG,UAAU,GAAG,IAAI,CAQpF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED,wBAAgB,oBAAoB,IAAI,UAAU,CAIjD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAKpE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAQ3E"}

package/dist/transport/frames.js

@@ -0,0 +1,50 @@
+import * as decoding from "lib0/decoding";
+import * as encoding from "lib0/encoding";
+import * as syncProtocol from "y-protocols/sync";
+export const MESSAGE_SYNC = 0;
+export const MESSAGE_AWARENESS = 1;
+/** y-websocket `messageQueryAwareness`. Inbound counts as traffic for its 30s watchdog. */
+export const MESSAGE_QUERY_AWARENESS = 3;
+export function encodeDocUpdate(update) {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, MESSAGE_SYNC);
+    syncProtocol.writeUpdate(encoder, update);
+    return encoding.toUint8Array(encoder);
+}
+export function replyLensSyncFrame(frame, live) {
+    const decoder = decoding.createDecoder(frame);
+    if (decoding.readVarUint(decoder) !== MESSAGE_SYNC)
+        return null;
+    if (decoding.readVarUint(decoder) !== syncProtocol.messageYjsSyncStep1)
+        return null;
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, MESSAGE_SYNC);
+    syncProtocol.readSyncStep1(decoder, encoder, live);
+    return encoding.length(encoder) > 1 ? encoding.toUint8Array(encoder) : null;
+}
+export function peekMessageType(frame) {
+    return decoding.readVarUint(decoding.createDecoder(frame));
+}
+export function encodeQueryAwareness() {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, MESSAGE_QUERY_AWARENESS);
+    return encoding.toUint8Array(encoder);
+}
+export function encodeAwarenessFrame(payload) {
+    const encoder = encoding.createEncoder();
+    encoding.writeVarUint(encoder, MESSAGE_AWARENESS);
+    encoding.writeVarUint8Array(encoder, payload);
+    return encoding.toUint8Array(encoder);
+}
+export function decodeAwarenessPayload(frame) {
+    try {
+        const decoder = decoding.createDecoder(frame);
+        if (decoding.readVarUint(decoder) !== MESSAGE_AWARENESS)
+            return null;
+        return decoding.readVarUint8Array(decoder);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=frames.js.map

package/dist/transport/frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.js","sourceRoot":"","sources":["../../src/transport/frames.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AAGjD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9B,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC7C,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAiB,EAAE,IAAW;IAC/D,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAChE,IAAI,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,YAAY,CAAC,mBAAmB;QAAE,OAAO,IAAI,CAAC;IACpF,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC7C,YAAY,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnD,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,OAAO,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IACxD,OAAO,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAmB;IACtD,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IAClD,QAAQ,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAiB;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,iBAAiB;YAAE,OAAO,IAAI,CAAC;QACrE,OAAO,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/transport/jsonrpc.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import type { RequestHost } from "../contract.js";
+import type { PlaneSocket } from "./relay.js";
+export declare const jsonRpcId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>;
+export declare const jsonRpcError: z.ZodObject<{
+    code: z.ZodNumber;
+    message: z.ZodString;
+    data: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const jsonRpcRequest: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodUnknown>;
+    id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>;
+}, z.core.$strip>;
+export declare const jsonRpcResponse: z.ZodUnion<readonly [z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>;
+    error: z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>;
+    result: z.ZodUnknown;
+}, z.core.$strip>]>;
+export declare function serveJsonRpc(socket: PlaneSocket, host: RequestHost, text: string): Promise<void>;
+//# sourceMappingURL=jsonrpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../../src/transport/jsonrpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,SAAS,4DAA8C,CAAC;AAErE,eAAO,MAAM,YAAY;;;;iBAIvB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;iBAKzB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;mBAW1B,CAAC;AAMH,wBAAsB,YAAY,CAChC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/transport/jsonrpc.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+export const jsonRpcId = z.union([z.string(), z.number(), z.null()]);
+export const jsonRpcError = z.object({
+    code: z.number().int(),
+    message: z.string(),
+    data: z.unknown().optional(),
+});
+export const jsonRpcRequest = z.object({
+    jsonrpc: z.literal("2.0"),
+    method: z.string().min(1),
+    params: z.unknown().optional(),
+    id: jsonRpcId.optional(),
+});
+export const jsonRpcResponse = z.union([
+    z.object({
+        jsonrpc: z.literal("2.0"),
+        id: jsonRpcId,
+        error: jsonRpcError,
+    }),
+    z.object({
+        jsonrpc: z.literal("2.0"),
+        id: jsonRpcId,
+        result: z.unknown(),
+    }),
+]);
+function encodeError(id, code, message) {
+    return JSON.stringify({ jsonrpc: "2.0", id, error: { code, message } });
+}
+export async function serveJsonRpc(socket, host, text) {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch {
+        socket.sendText(encodeError(null, -32700, "Parse error"));
+        return;
+    }
+    const parsed = jsonRpcRequest.safeParse(raw);
+    if (!parsed.success) {
+        socket.sendText(encodeError(null, -32600, "Invalid Request"));
+        return;
+    }
+    const { method, params, id } = parsed.data;
+    try {
+        const result = await host.handleRequest(method, params);
+        if (id === undefined)
+            return;
+        socket.sendText(JSON.stringify({ jsonrpc: "2.0", id, result }));
+    }
+    catch (error) {
+        if (id === undefined)
+            return;
+        const code = typeof error === "object" && error !== null && "code" in error
+            ? Number(error.code)
+            : -32603;
+        const message = error instanceof Error ? error.message : "Internal error";
+        socket.sendText(encodeError(id, Number.isInteger(code) ? code : -32603, message));
+    }
+}
+//# sourceMappingURL=jsonrpc.js.map

package/dist/transport/jsonrpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.js","sourceRoot":"","sources":["../../src/transport/jsonrpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACtB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,EAAE,EAAE,SAAS,CAAC,QAAQ,EAAE;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC;IACrC,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACzB,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,YAAY;KACpB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACzB,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB,CAAC;CACH,CAAC,CAAC;AAEH,SAAS,WAAW,CAAC,EAA6B,EAAE,IAAY,EAAE,OAAe;IAC/E,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAmB,EACnB,IAAiB,EACjB,IAAY;IAEZ,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC;QAC1D,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO;QAC7B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO;QAC7B,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK;YACzE,CAAC,CAAC,MAAM,CAAE,KAA2B,CAAC,IAAI,CAAC;YAC3C,CAAC,CAAC,CAAC,KAAK,CAAC;QACX,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAC1E,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACpF,CAAC;AACH,CAAC"}

package/dist/transport/keepalive.d.ts

@@ -0,0 +1,11 @@
+export declare const PLANE_PING_MS = 10000;
+export type Pingable = {
+    readyState: number;
+    ping(): void;
+    send(data: Uint8Array, options?: {
+        binary?: boolean;
+    }): void;
+    on(event: "close", listener: () => void): unknown;
+};
+export declare function keepPlaneAlive(socket: Pingable, intervalMs?: number): void;
+//# sourceMappingURL=keepalive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keepalive.d.ts","sourceRoot":"","sources":["../../src/transport/keepalive.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa,QAAS,CAAC;AAGpC,MAAM,MAAM,QAAQ,GAAG;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7D,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CACnD,CAAC;AAEF,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,SAAgB,GAAG,IAAI,CAcjF"}

package/dist/transport/keepalive.js

@@ -0,0 +1,27 @@
+/**
+ * Plane keepalive: WebSocket ping/pong (NAT / load-balancer idle) plus a
+ * y-websocket queryAwareness frame so stock clients refresh their 30s
+ * inbound-message watchdog. Same bytes remote clients already speak.
+ */
+import { encodeQueryAwareness } from "./frames.js";
+export const PLANE_PING_MS = 10_000;
+const OPEN = 1;
+export function keepPlaneAlive(socket, intervalMs = PLANE_PING_MS) {
+    const tick = () => {
+        if (socket.readyState !== OPEN)
+            return;
+        try {
+            socket.ping();
+        }
+        catch {
+            /* closing */
+        }
+        if (socket.readyState !== OPEN)
+            return;
+        socket.send(encodeQueryAwareness(), { binary: true });
+    };
+    const timer = setInterval(tick, intervalMs);
+    timer.unref?.();
+    socket.on("close", () => clearInterval(timer));
+}
+//# sourceMappingURL=keepalive.js.map

package/dist/transport/keepalive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keepalive.js","sourceRoot":"","sources":["../../src/transport/keepalive.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,MAAM,IAAI,GAAG,CAAC,CAAC;AASf,MAAM,UAAU,cAAc,CAAC,MAAgB,EAAE,UAAU,GAAG,aAAa;IACzE,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;YAAE,OAAO;QACvC,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;YAAE,OAAO;QACvC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/transport/relay.d.ts

@@ -0,0 +1,28 @@
+import { PlexusAwareness } from "@here.build/plexus";
+import * as Y from "yjs";
+/** Send local Plexus awareness updates over the plane socket. */
+export declare function forwardPlexusAwareness(hub: PlexusAwareness, send: (frame: Uint8Array) => void): () => void;
+export interface PlaneSocket {
+    send(frame: Uint8Array): void;
+    sendText(text: string): void;
+    close(code: number, reason: string): void;
+    onBinary(handler: (frame: Uint8Array) => void): void;
+    onText(handler: (text: string) => void): void;
+    onClose(handler: () => void): void;
+}
+export declare class AwarenessReplay {
+    #private;
+    apply(frame: Uint8Array): void;
+    snapshot(): Uint8Array | null;
+    destroy(): void;
+}
+export declare class AwarenessRoom {
+    #private;
+    join(socket: PlaneSocket): void;
+    receive(from: PlaneSocket, frame: Uint8Array): void;
+    close(code: number, reason: string): void;
+    snapshot(): Uint8Array | null;
+}
+/** Server-authoritative y-websocket: reply STEP1 with our STEP2; drop inbound STEP2/UPDATE. */
+export declare function attachLens(doc: Y.Doc, socket: PlaneSocket, room?: AwarenessRoom, hub?: PlexusAwareness): void;
+//# sourceMappingURL=relay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/transport/relay.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAczB,iEAAiE;AACjE,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAChC,MAAM,IAAI,CAYZ;AAcD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IACrD,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACpC;AAID,qBAAa,eAAe;;IAI1B,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAM7B;IAED,QAAQ,IAAI,UAAU,GAAG,IAAI,CAI5B;IAED,OAAO,IAAI,IAAI,CAGd;CACF;AAED,qBAAa,aAAa;;IAIxB,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAO9B;IAED,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAGlD;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAKxC;IAED,QAAQ,IAAI,UAAU,GAAG,IAAI,CAE5B;CACF;AAED,+FAA+F;AAC/F,wBAAgB,UAAU,CACxB,GAAG,EAAE,CAAC,CAAC,GAAG,EACV,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,aAAa,EACpB,GAAG,CAAC,EAAE,eAAe,GACpB,IAAI,CA2BN"}

package/dist/transport/relay.js

@@ -0,0 +1,119 @@
+import { applyAwarenessUpdate, encodeAwarenessUpdate, PlexusAwareness } from "@here.build/plexus";
+import * as Y from "yjs";
+import { MESSAGE_AWARENESS, MESSAGE_QUERY_AWARENESS, MESSAGE_SYNC, decodeAwarenessPayload, encodeAwarenessFrame, encodeDocUpdate, encodeQueryAwareness, peekMessageType, replyLensSyncFrame, } from "./frames.js";
+/** Send local Plexus awareness updates over the plane socket. */
+export function forwardPlexusAwareness(hub, send) {
+    const onUpdate = (changed) => {
+        const clients = [...changed.added, ...changed.updated, ...changed.removed];
+        if (clients.length === 0)
+            return;
+        try {
+            send(encodeAwarenessFrame(encodeAwarenessUpdate(hub, clients)));
+        }
+        catch {
+            /* hub not ready */
+        }
+    };
+    hub.on("update", onUpdate);
+    return () => hub.off("update", onUpdate);
+}
+/** Ingest a peer awareness frame onto the plane's Plexus hub. */
+function applyAwarenessToHub(hub, frame) {
+    if (hub === undefined)
+        return;
+    const payload = decodeAwarenessPayload(frame);
+    if (payload === null)
+        return;
+    try {
+        applyAwarenessUpdate(hub, payload, "remote");
+    }
+    catch {
+        /* malformed peer frame */
+    }
+}
+export class AwarenessReplay {
+    #doc = new Y.Doc();
+    #hub = new PlexusAwareness(this.#doc);
+    apply(frame) {
+        const payload = decodeAwarenessPayload(frame);
+        if (payload === null)
+            return;
+        try {
+            applyAwarenessUpdate(this.#hub, payload, "remote");
+        }
+        catch { }
+    }
+    snapshot() {
+        const clients = [...this.#hub.meta.keys()];
+        if (clients.length === 0)
+            return null;
+        return encodeAwarenessFrame(encodeAwarenessUpdate(this.#hub, clients));
+    }
+    destroy() {
+        this.#hub.destroy();
+        this.#doc.destroy();
+    }
+}
+export class AwarenessRoom {
+    #replay = new AwarenessReplay();
+    #sockets = new Set();
+    join(socket) {
+        this.#sockets.add(socket);
+        socket.onClose(() => {
+            this.#sockets.delete(socket);
+        });
+        const dump = this.#replay.snapshot();
+        if (dump !== null)
+            socket.send(dump);
+    }
+    receive(from, frame) {
+        this.#replay.apply(frame);
+        for (const peer of this.#sockets)
+            if (peer !== from)
+                peer.send(frame);
+    }
+    close(code, reason) {
+        const sockets = [...this.#sockets];
+        this.#sockets.clear();
+        for (const socket of sockets)
+            socket.close(code, reason);
+        this.#replay.destroy();
+    }
+    snapshot() {
+        return this.#replay.snapshot();
+    }
+}
+/** Server-authoritative y-websocket: reply STEP1 with our STEP2; drop inbound STEP2/UPDATE. */
+export function attachLens(doc, socket, room, hub) {
+    const onDocUpdate = (update, origin) => {
+        if (origin === socket)
+            return;
+        socket.send(encodeDocUpdate(update));
+    };
+    socket.onBinary((frame) => {
+        try {
+            const messageType = peekMessageType(frame);
+            if (messageType === MESSAGE_QUERY_AWARENESS) {
+                socket.send(room?.snapshot() ?? encodeQueryAwareness());
+                return;
+            }
+            if (messageType === MESSAGE_AWARENESS) {
+                applyAwarenessToHub(hub, frame);
+                room?.receive(socket, frame);
+                return;
+            }
+            if (messageType !== MESSAGE_SYNC)
+                return;
+            const reply = replyLensSyncFrame(frame, doc);
+            if (reply !== null)
+                socket.send(reply);
+        }
+        catch { }
+    });
+    socket.onClose(() => {
+        doc.off("update", onDocUpdate);
+    });
+    doc.on("update", onDocUpdate);
+    room?.join(socket);
+}
+//# sourceMappingURL=relay.js.map

package/dist/transport/relay.js.map

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

package/dist/transport/websocket.d.ts

@@ -0,0 +1,4 @@
+import { WebSocket } from "ws";
+import type { PlaneSocket } from "./relay.js";
+export declare function wrapWebSocket(ws: WebSocket): PlaneSocket;
+//# sourceMappingURL=websocket.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/transport/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAG/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,aAAa,CAAC,EAAE,EAAE,SAAS,GAAG,WAAW,CAiCxD"}

package/dist/transport/websocket.js

@@ -0,0 +1,39 @@
+import { WebSocket } from "ws";
+import { keepPlaneAlive } from "./keepalive.js";
+export function wrapWebSocket(ws) {
+    keepPlaneAlive({
+        get readyState() {
+            return ws.readyState;
+        },
+        ping: () => {
+            ws.ping();
+        },
+        send: (data, options) => {
+            ws.send(data, { binary: options?.binary ?? true });
+        },
+        on: (event, listener) => {
+            ws.on(event, listener);
+        },
+    });
+    return {
+        send: (frame) => {
+            if (ws.readyState === WebSocket.OPEN)
+                ws.send(frame, { binary: true });
+        },
+        sendText: (text) => {
+            if (ws.readyState === WebSocket.OPEN)
+                ws.send(text);
+        },
+        close: (code, reason) => ws.close(code, reason),
+        onBinary: (handler) => ws.on("message", (data, isBinary) => {
+            if (isBinary)
+                handler(new Uint8Array(Buffer.isBuffer(data) ? data : Buffer.concat(data)));
+        }),
+        onText: (handler) => ws.on("message", (data, isBinary) => {
+            if (!isBinary)
+                handler(data.toString());
+        }),
+        onClose: (handler) => ws.on("close", handler),
+    };
+}
+//# sourceMappingURL=websocket.js.map

package/dist/transport/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/transport/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,UAAU,aAAa,CAAC,EAAa;IACzC,cAAc,CAAC;QACb,IAAI,UAAU;YACZ,OAAO,EAAE,CAAC,UAAU,CAAC;QACvB,CAAC;QACD,IAAI,EAAE,GAAG,EAAE;YACT,EAAE,CAAC,IAAI,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACtB,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YACtB,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzB,CAAC;KACF,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YACd,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;gBAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;YACjB,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;gBAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;QAC/C,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CACpB,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;YAClC,IAAI,QAAQ;gBAAE,OAAO,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAgB,CAAC,CAAC,CAAC,CAAC;QACxG,CAAC,CAAC;QACJ,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAClB,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;YAClC,IAAI,CAAC,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1C,CAAC,CAAC;QACJ,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;KAC9C,CAAC;AACJ,CAAC"}