@allin-ai/agent-client 0.1.0 → 0.2.0

package/dist/hub/agent-hub.js

@@ -0,0 +1,352 @@
+import { WebSocket, WebSocketServer } from "ws";
+import { parseClientCommand, parseClientEventBatch, parseClientHello, parseHubDownlink, parseHubEventAcknowledgement, parseInventoryReport, parsePluginSyncAcknowledgement, } from "../protocol/index.js";
+import { bridgeLog } from "../logger.js";
+/** Protocol orchestration only: durable state and ownership belong to the host Store. */
+export function createAgentHub(options) {
+    const pathPrefix = options.pathPrefix ?? "/api/agent-hub/v2";
+    if (!pathPrefix.startsWith("/") ||
+        pathPrefix.endsWith("/") ||
+        /[?#\\\s]/.test(pathPrefix) ||
+        new URL(pathPrefix, "http://hub.invalid").pathname !== pathPrefix) {
+        throw new TypeError("pathPrefix must be an absolute path with no trailing slash, query or fragment");
+    }
+    const wsPath = `${pathPrefix}/ws`;
+    const store = options.store;
+    // Keys are issued by the host; Principal stays opaque even for routing.
+    const sockets = new Map();
+    // Transport resources only; these sockets are not yet owned by WebSocketServer.
+    const pendingUpgrades = new Set();
+    const wss = new WebSocketServer({
+        noServer: true,
+        maxPayload: options.maxPayloadBytes ?? 1_048_576,
+    });
+    let attached;
+    let attachOptions = {};
+    let closed = false;
+    let closePromise;
+    function url(request) {
+        try {
+            return new URL(request.url ?? "/", "http://hub.invalid");
+        }
+        catch {
+            return null;
+        }
+    }
+    async function authorize(request, requestUrl) {
+        const token = request.headers.authorization?.replace(/^Bearer\s+/i, "") ??
+            requestUrl.searchParams.get("token") ??
+            "";
+        try {
+            return await options.authorize(token, request);
+        }
+        catch {
+            return null;
+        }
+    }
+    async function httpRequest(request, response, requestUrl) {
+        const principal = await authorize(request, requestUrl);
+        response.writeHead(principal === null ? 401 : 426, {
+            "Content-Type": "application/json",
+            ...(principal === null ? {} : { Upgrade: "websocket" }),
+        });
+        response.end(JSON.stringify({
+            error: principal === null ? "unauthorized" : "websocket_required",
+        }));
+    }
+    function onRequest(request, response) {
+        const requestUrl = url(request);
+        if (!requestUrl) {
+            response.writeHead(400);
+            response.end();
+            return;
+        }
+        if (requestUrl.pathname !== wsPath) {
+            if (attachOptions.fallback)
+                attachOptions.fallback(request, response);
+            else {
+                response.writeHead(404);
+                response.end();
+            }
+            return;
+        }
+        void httpRequest(request, response, requestUrl);
+    }
+    function active(connection) {
+        return (!closed &&
+            connection.socket.readyState === WebSocket.OPEN &&
+            sockets.get(connection.connectionKey) === connection);
+    }
+    async function deliver(connection) {
+        const offers = await store.listPendingOffers({
+            principal: connection.principal,
+            clientId: connection.clientId,
+        });
+        for (const offer of offers) {
+            if (!active(connection))
+                return;
+            if (offer.connectionKey !== connection.connectionKey ||
+                offer.targetClientId !== connection.clientId) {
+                throw new Error("Store returned an offer for another connection");
+            }
+            const command = parseClientCommand(offer.command);
+            if (!command)
+                throw new Error("Store returned an invalid command");
+            connection.socket.send(JSON.stringify({ type: "task.offer", command }));
+        }
+    }
+    function connect(socket, principal) {
+        let connection;
+        // Only in-flight work is queued here; no event/offer history is retained.
+        let tail = Promise.resolve();
+        function queue(work) {
+            tail = tail
+                .then(async () => {
+                if (closed || socket.readyState !== WebSocket.OPEN)
+                    return;
+                if (connection && !active(connection))
+                    return;
+                await work();
+            })
+                .catch(() => {
+                socket.close(1011, "Hub store failure");
+            });
+        }
+        socket.on("message", (raw) => queue(async () => {
+            let message;
+            try {
+                message = JSON.parse((Array.isArray(raw)
+                    ? Buffer.concat(raw)
+                    : Buffer.from(raw)).toString("utf8"));
+            }
+            catch {
+                socket.close(1008, "invalid message");
+                return;
+            }
+            if (!connection) {
+                const hello = parseClientHello(message);
+                if (!hello) {
+                    socket.close(1008, "client.hello required");
+                    return;
+                }
+                let record;
+                try {
+                    record = await store.registerClient({
+                        principal,
+                        clientId: hello.clientId,
+                        protocolVersion: hello.protocolVersion,
+                    });
+                }
+                catch {
+                    socket.close(1008, "client registration rejected");
+                    return;
+                }
+                if (record.clientId !== hello.clientId ||
+                    typeof record.connectionKey !== "string" ||
+                    !record.connectionKey.trim()) {
+                    socket.close(1008, "client ownership conflict");
+                    return;
+                }
+                if (closed || socket.readyState !== WebSocket.OPEN)
+                    return;
+                const prior = sockets.get(record.connectionKey);
+                if (prior && prior.clientId !== record.clientId) {
+                    socket.close(1008, "client ownership conflict");
+                    return;
+                }
+                connection = {
+                    clientId: record.clientId,
+                    connectionKey: record.connectionKey,
+                    principal,
+                    socket,
+                };
+                sockets.set(record.connectionKey, connection);
+                prior?.socket.close(1000, "superseded connection");
+                await deliver(connection);
+                return;
+            }
+            const acknowledgement = parsePluginSyncAcknowledgement(message);
+            if (acknowledgement) {
+                await store.acknowledgePluginSync({
+                    principal,
+                    clientId: connection.clientId,
+                    acknowledgement,
+                });
+                return;
+            }
+            const inventory = parseInventoryReport(message);
+            if (inventory) {
+                await store.recordInventory({
+                    principal,
+                    clientId: connection.clientId,
+                    report: inventory,
+                });
+                return;
+            }
+            const events = parseClientEventBatch(message);
+            if (!events) {
+                // Forward compatibility: a newer client may send message types this
+                // Hub does not know. Dropping the socket would break mixed-version
+                // fleets, so unknown frames are logged and ignored.
+                bridgeLog.warn("agent-hub", "Ignoring unknown client message", {
+                    type: message.type,
+                });
+                return;
+            }
+            const watermarks = await store.ingestEvents({
+                principal,
+                clientId: connection.clientId,
+                events,
+            });
+            const ack = parseHubEventAcknowledgement({
+                type: "event.ack",
+                watermarks,
+            });
+            if (!ack)
+                throw new Error("Store returned invalid event watermarks");
+            if (active(connection))
+                socket.send(JSON.stringify(ack));
+        }));
+        // v2 has no JSON heartbeat frame. WS control frames preserve its wire contract.
+        function heartbeat() {
+            queue(async () => {
+                if (!connection) {
+                    socket.close(1008, "client.hello required");
+                    return;
+                }
+                await store.heartbeat({ principal, clientId: connection.clientId });
+            });
+        }
+        socket.on("ping", heartbeat);
+        socket.on("pong", heartbeat);
+        socket.on("error", () => socket.terminate());
+        socket.on("close", () => {
+            if (connection && sockets.get(connection.connectionKey) === connection)
+                sockets.delete(connection.connectionKey);
+        });
+    }
+    async function upgrade(request, socket, head, requestUrl) {
+        const principal = await authorize(request, requestUrl);
+        if (closed || socket.destroyed) {
+            socket.destroy();
+            return;
+        }
+        if (principal === null) {
+            socket.end("HTTP/1.1 401 Unauthorized\r\nConnection: close\r\nContent-Length: 0\r\n\r\n");
+            return;
+        }
+        wss.handleUpgrade(request, socket, head, (ws) => connect(ws, principal));
+    }
+    function onUpgrade(request, socket, head) {
+        const requestUrl = url(request);
+        if (!requestUrl) {
+            socket.destroy();
+            return;
+        }
+        if (requestUrl.pathname !== wsPath) {
+            if (attachOptions.onUnknownUpgrade) {
+                attachOptions.onUnknownUpgrade(request, socket, head);
+            }
+            else {
+                socket.destroy();
+            }
+            return;
+        }
+        pendingUpgrades.add(socket);
+        const forget = () => {
+            pendingUpgrades.delete(socket);
+        };
+        const failed = () => {
+            socket.destroy();
+        };
+        socket.once("close", forget);
+        socket.once("error", failed);
+        void upgrade(request, socket, head, requestUrl)
+            .catch(() => socket.destroy())
+            .finally(() => {
+            pendingUpgrades.delete(socket);
+            socket.off("close", forget);
+            socket.off("error", failed);
+        });
+    }
+    return {
+        attach(server, opts = {}) {
+            if (closed || attached)
+                throw new Error("AgentHub can only attach once before close");
+            attached = server;
+            attachOptions = opts;
+            server.on("request", onRequest);
+            server.on("upgrade", onUpgrade);
+        },
+        async offer(input) {
+            if (closed)
+                throw new Error("AgentHub is closed");
+            const command = parseClientCommand(input.command);
+            if (!command || !input.targetClientId.trim())
+                throw new TypeError("Invalid offer");
+            const stored = await store.enqueueOffer({
+                principal: input.principal,
+                targetClientId: input.targetClientId,
+                command,
+            });
+            const connection = sockets.get(stored.connectionKey);
+            if (connection && active(connection)) {
+                try {
+                    await deliver(connection);
+                }
+                catch {
+                    connection.socket.close(1011, "Hub store failure");
+                }
+            }
+            return stored;
+        },
+        syncPlugins(input) {
+            if (closed)
+                throw new Error("AgentHub is closed");
+            if (!input.targetClientId.trim() || !input.revision.trim()) {
+                throw new TypeError("Invalid plugin sync");
+            }
+            // Protocol round-trip keeps the desired state wire-shaped.
+            const downlink = parseHubDownlink({
+                type: "plugin.sync",
+                revision: input.revision,
+                plugins: input.plugins,
+                ...(input.inventoryQuery ? { inventoryQuery: true } : {}),
+            });
+            if (!downlink || downlink.type !== "plugin.sync") {
+                throw new TypeError("Invalid plugin sync");
+            }
+            let connected = null;
+            for (const connection of sockets.values()) {
+                if (connection.clientId === input.targetClientId &&
+                    Object.is(connection.principal, input.principal)) {
+                    connected = connection;
+                    break;
+                }
+            }
+            if (!connected || !active(connected))
+                return Promise.resolve({ delivered: false });
+            connected.socket.send(JSON.stringify(downlink));
+            return Promise.resolve({ delivered: true });
+        },
+        getInventory(input) {
+            // Ownership validation lives in the store, consistent with recordInventory.
+            return store.getInventory(input);
+        },
+        close() {
+            if (closePromise)
+                return closePromise;
+            closed = true;
+            attached?.off("request", onRequest);
+            attached?.off("upgrade", onUpgrade);
+            for (const socket of pendingUpgrades)
+                socket.destroy();
+            pendingUpgrades.clear();
+            for (const socket of wss.clients)
+                socket.terminate();
+            sockets.clear();
+            closePromise = new Promise((resolve) => wss.close(() => resolve()));
+            return closePromise;
+        },
+    };
+}
+//# sourceMappingURL=agent-hub.js.map

package/dist/hub/agent-hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-hub.js","sourceRoot":"","sources":["../../src/hub/agent-hub.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAgB,MAAM,IAAI,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,oBAAoB,EACpB,8BAA8B,GAG/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAezC,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAC5B,OAAmC;IAEnC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC7D,IACE,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;QAC3B,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;QACxB,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;QAC3B,IAAI,GAAG,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC,QAAQ,KAAK,UAAU,EACjE,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,+EAA+E,CAChF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,UAAU,KAAK,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,wEAAwE;IACxE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsC,CAAC;IAC9D,gFAAgF;IAChF,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC;QAC9B,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,OAAO,CAAC,eAAe,IAAI,SAAS;KACjD,CAAC,CAAC;IACH,IAAI,QAA4B,CAAC;IACjC,IAAI,aAAa,GAAqB,EAAE,CAAC;IACzC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,YAAuC,CAAC;IAE5C,SAAS,GAAG,CAAC,OAAwB;QACnC,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,oBAAoB,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,UAAU,SAAS,CACtB,OAAwB,EACxB,UAAe;QAEf,MAAM,KAAK,GACT,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;YACzD,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC;YACpC,EAAE,CAAC;QACL,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,UAAU,WAAW,CACxB,OAAwB,EACxB,QAAwB,EACxB,UAAe;QAEf,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACvD,QAAQ,CAAC,SAAS,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE;YACjD,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;SACxD,CAAC,CAAC;QACH,QAAQ,CAAC,GAAG,CACV,IAAI,CAAC,SAAS,CAAC;YACb,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,oBAAoB;SAClE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,SAAS,SAAS,CAAC,OAAwB,EAAE,QAAwB;QACnE,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACxB,QAAQ,CAAC,GAAG,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YACnC,IAAI,aAAa,CAAC,QAAQ;gBAAE,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;iBACjE,CAAC;gBACJ,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACxB,QAAQ,CAAC,GAAG,EAAE,CAAC;YACjB,CAAC;YACD,OAAO;QACT,CAAC;QACD,KAAK,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;IAED,SAAS,MAAM,CAAC,UAAsC;QACpD,OAAO,CACL,CAAC,MAAM;YACP,UAAU,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;YAC/C,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,UAAU,CACrD,CAAC;IACJ,CAAC;IAED,KAAK,UAAU,OAAO,CACpB,UAAsC;QAEtC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC;YAC3C,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;gBAAE,OAAO;YAChC,IACE,KAAK,CAAC,aAAa,KAAK,UAAU,CAAC,aAAa;gBAChD,KAAK,CAAC,cAAc,KAAK,UAAU,CAAC,QAAQ,EAC5C,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACnE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,SAAS,OAAO,CAAC,MAAiB,EAAE,SAAoB;QACtD,IAAI,UAAkD,CAAC;QACvD,0EAA0E;QAC1E,IAAI,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAC7B,SAAS,KAAK,CAAC,IAAyB;YACtC,IAAI,GAAG,IAAI;iBACR,IAAI,CAAC,KAAK,IAAI,EAAE;gBACf,IAAI,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;oBAAE,OAAO;gBAC3D,IAAI,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;oBAAE,OAAO;gBAC9C,MAAM,IAAI,EAAE,CAAC;YACf,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE;gBACV,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;QACP,CAAC;QACD,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAY,EAAE,EAAE,CACpC,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,OAAgB,CAAC;YACrB,IAAI,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAClB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;oBACjB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;oBACpB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAkB,CAAC,CAClC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACnB,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;gBACtC,OAAO;YACT,CAAC;YACD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;gBACxC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;oBAC5C,OAAO;gBACT,CAAC;gBACD,IAAI,MAAuB,CAAC;gBAC5B,IAAI,CAAC;oBACH,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC;wBAClC,SAAS;wBACT,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,eAAe,EAAE,KAAK,CAAC,eAAe;qBACvC,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAC;oBACnD,OAAO;gBACT,CAAC;gBACD,IACE,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;oBAClC,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ;oBACxC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,EAC5B,CAAC;oBACD,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;oBAChD,OAAO;gBACT,CAAC;gBACD,IAAI,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;oBAAE,OAAO;gBAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;gBAChD,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAChD,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;oBAChD,OAAO;gBACT,CAAC;gBACD,UAAU,GAAG;oBACX,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,SAAS;oBACT,MAAM;iBACP,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;gBAC9C,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;gBACnD,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,MAAM,eAAe,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;YAChE,IAAI,eAAe,EAAE,CAAC;gBACpB,MAAM,KAAK,CAAC,qBAAqB,CAAC;oBAChC,SAAS;oBACT,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,eAAe;iBAChB,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,KAAK,CAAC,eAAe,CAAC;oBAC1B,SAAS;oBACT,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,MAAM,EAAE,SAAS;iBAClB,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,oEAAoE;gBACpE,mEAAmE;gBACnE,oDAAoD;gBACpD,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,iCAAiC,EAAE;oBAC7D,IAAI,EAAG,OAAmC,CAAC,IAAI;iBAChD,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC;gBAC1C,SAAS;gBACT,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,MAAM;aACP,CAAC,CAAC;YACH,MAAM,GAAG,GAAG,4BAA4B,CAAC;gBACvC,IAAI,EAAE,WAAW;gBACjB,UAAU;aACX,CAAC,CAAC;YACH,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACrE,IAAI,MAAM,CAAC,UAAU,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC,CACH,CAAC;QACF,gFAAgF;QAChF,SAAS,SAAS;YAChB,KAAK,CAAC,KAAK,IAAI,EAAE;gBACf,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;oBAC5C,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,UAAU;gBACpE,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,UAAU,OAAO,CACpB,OAAwB,EACxB,MAAc,EACd,IAAY,EACZ,UAAe;QAEf,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACvD,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAC/B,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CACR,6EAA6E,CAC9E,CAAC;YACF,OAAO;QACT,CAAC;QACD,GAAG,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,SAAS,SAAS,CAChB,OAAwB,EACxB,MAAc,EACd,IAAY;QAEZ,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YACnC,IAAI,aAAa,CAAC,gBAAgB,EAAE,CAAC;gBACnC,aAAa,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;YACD,OAAO;QACT,CAAC;QACD,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,KAAK,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC;aAC5C,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;aAC7B,OAAO,CAAC,GAAG,EAAE;YACZ,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO;QACL,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE;YACtB,IAAI,MAAM,IAAI,QAAQ;gBACpB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,QAAQ,GAAG,MAAM,CAAC;YAClB,aAAa,GAAG,IAAI,CAAC;YACrB,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAChC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,KAA+B;YACzC,IAAI,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE;gBAC1C,MAAM,IAAI,SAAS,CAAC,eAAe,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC;gBACtC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,OAAO;aACR,CAAC,CAAC;YACH,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACrD,IAAI,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;gBAC5B,CAAC;gBAAC,MAAM,CAAC;oBACP,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,WAAW,CAAC,KAMX;YACC,IAAI,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAClD,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC3D,MAAM,IAAI,SAAS,CAAC,qBAAqB,CAAC,CAAC;YAC7C,CAAC;YACD,2DAA2D;YAC3D,MAAM,QAAQ,GAAG,gBAAgB,CAAC;gBAChC,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1D,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACjD,MAAM,IAAI,SAAS,CAAC,qBAAqB,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,SAAS,GAAsC,IAAI,CAAC;YACxD,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1C,IACE,UAAU,CAAC,QAAQ,KAAK,KAAK,CAAC,cAAc;oBAC5C,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EAChD,CAAC;oBACD,SAAS,GAAG,UAAU,CAAC;oBACvB,MAAM;gBACR,CAAC;YACH,CAAC;YACD,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACnF,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;YAChD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,YAAY,CAAC,KAGZ;YACC,4EAA4E;YAC5E,OAAO,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,KAAK;YACH,IAAI,YAAY;gBAAE,OAAO,YAAY,CAAC;YACtC,MAAM,GAAG,IAAI,CAAC;YACd,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACpC,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACpC,KAAK,MAAM,MAAM,IAAI,eAAe;gBAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACvD,eAAe,CAAC,KAAK,EAAE,CAAC;YACxB,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO;gBAAE,MAAM,CAAC,SAAS,EAAE,CAAC;YACrD,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,YAAY,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC1E,OAAO,YAAY,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/hub/index.d.ts

@@ -0,0 +1,3 @@
+export { createAgentHub } from "./agent-hub.js";
+export type { AgentHub, AgentHubOptions, HubAttachOptions, HubAuthorizer, HubClientRecord, HubClientRegistration, HubEventBatch, HubEventIngestResult, HubHeartbeat, HubInventoryReport, HubOfferDelivery, HubOfferInput, HubPluginAcknowledgement, HubStore, StoredOffer, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hub/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hub/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EACV,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACxB,QAAQ,EACR,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/hub/index.js

@@ -0,0 +1,2 @@
+export { createAgentHub } from "./agent-hub.js";
+//# sourceMappingURL=index.js.map

package/dist/hub/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hub/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/hub/testkit/index.d.ts

@@ -0,0 +1,4 @@
+/** @internal Test-only volatile Hub helpers. Never use these in a deployed host. */
+export { createMemoryHub, type CreateMemoryHubOptions, type MemoryHub, } from "./memory-hub.js";
+export { MemoryHubStore, type MemoryHubClient, type MemoryHubSnapshot, } from "./memory-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hub/testkit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hub/testkit/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC"}

package/dist/hub/testkit/index.js

@@ -0,0 +1,4 @@
+/** @internal Test-only volatile Hub helpers. Never use these in a deployed host. */
+export { createMemoryHub, } from "./memory-hub.js";
+export { MemoryHubStore, } from "./memory-store.js";
+//# sourceMappingURL=index.js.map

package/dist/hub/testkit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hub/testkit/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EACL,eAAe,GAGhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,GAGf,MAAM,mBAAmB,CAAC"}

package/dist/hub/testkit/memory-hub.d.ts

@@ -0,0 +1,23 @@
+import type { IncomingMessage } from "node:http";
+import type { AgentHub, AgentHubOptions, HubAuthorizer } from "../types.js";
+import { MemoryHubStore, type MemoryHubSnapshot } from "./memory-store.js";
+export type CreateMemoryHubOptions<Principal = string> = Omit<Partial<AgentHubOptions<Principal>>, "store" | "authorize"> & {
+    /** Test-only default credential; generated when omitted. */
+    token?: string;
+    /** Test-only shorthand that maps an accepted token to that string principal. */
+    authorizeToken?: (candidate: string, request: IncomingMessage) => boolean | Promise<boolean>;
+    authorize?: HubAuthorizer<Principal>;
+    onPluginSyncAcknowledgement?: (clientId: string, acknowledgement: import("../../protocol/index.js").PluginSyncAcknowledgement) => void;
+};
+export type MemoryHub<Principal> = AgentHub<Principal> & {
+    /** Test-only, volatile adapter; process restart loses every stored value. */
+    readonly store: MemoryHubStore<Principal>;
+    readonly token: string;
+    listClients: () => ReturnType<MemoryHubStore<Principal>["listClients"]>;
+    listEvents: (executionId?: string) => ReturnType<MemoryHubStore<Principal>["listEvents"]>;
+    snapshot: () => MemoryHubSnapshot<Principal>;
+    restore: (snapshot: MemoryHubSnapshot<Principal>) => void;
+};
+/** @internal Test-only Hub composition. It never owns or starts an HTTP listener. */
+export declare function createMemoryHub<Principal = string>(options?: CreateMemoryHubOptions<Principal>): MemoryHub<Principal>;
+//# sourceMappingURL=memory-hub.d.ts.map

package/dist/hub/testkit/memory-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-hub.d.ts","sourceRoot":"","sources":["../../../src/hub/testkit/memory-hub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,MAAM,MAAM,sBAAsB,CAAC,SAAS,GAAG,MAAM,IAAI,IAAI,CAC3D,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,EACnC,OAAO,GAAG,WAAW,CACtB,GAAG;IACF,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,cAAc,CAAC,EAAE,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,KACrB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACrC,2BAA2B,CAAC,EAAE,CAC5B,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,OAAO,yBAAyB,EAAE,yBAAyB,KACzE,IAAI,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,GAAG;IACvD,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,UAAU,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IACxE,UAAU,EAAE,CACV,WAAW,CAAC,EAAE,MAAM,KACjB,UAAU,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IACzD,QAAQ,EAAE,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,EAAE,CAAC,QAAQ,EAAE,iBAAiB,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;CAC3D,CAAC;AAEF,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,SAAS,GAAG,MAAM,EAChD,OAAO,GAAE,sBAAsB,CAAC,SAAS,CAAM,GAC9C,SAAS,CAAC,SAAS,CAAC,CA8BtB"}

package/dist/hub/testkit/memory-hub.js

@@ -0,0 +1,33 @@
+import { randomUUID } from "node:crypto";
+import { createAgentHub } from "../agent-hub.js";
+import { MemoryHubStore } from "./memory-store.js";
+/** @internal Test-only Hub composition. It never owns or starts an HTTP listener. */
+export function createMemoryHub(options = {}) {
+    const token = options.token ?? `memory-hub-${randomUUID()}`;
+    const store = new MemoryHubStore(options.onPluginSyncAcknowledgement);
+    const authorize = options.authorize ??
+        (async (candidate, request) => {
+            if (options.authorizeToken) {
+                return (await options.authorizeToken(candidate, request))
+                    ? candidate
+                    : null;
+            }
+            return candidate === token ? candidate : null;
+        });
+    const hub = createAgentHub({
+        authorize,
+        store,
+        pathPrefix: options.pathPrefix,
+        maxPayloadBytes: options.maxPayloadBytes,
+    });
+    return {
+        ...hub,
+        token,
+        store,
+        listClients: () => store.listClients(),
+        listEvents: (executionId) => store.listEvents(executionId),
+        snapshot: () => store.snapshot(),
+        restore: (snapshot) => store.restore(snapshot),
+    };
+}
+//# sourceMappingURL=memory-hub.js.map

package/dist/hub/testkit/memory-hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-hub.js","sourceRoot":"","sources":["../../../src/hub/testkit/memory-hub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAA0B,MAAM,mBAAmB,CAAC;AAgC3E,qFAAqF;AACrF,MAAM,UAAU,eAAe,CAC7B,UAA6C,EAAE;IAE/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,UAAU,EAAE,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,cAAc,CAC9B,OAAO,CAAC,2BAA2B,CACpC,CAAC;IACF,MAAM,SAAS,GACb,OAAO,CAAC,SAAS;QACjB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;YAC5B,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC3B,OAAO,CAAC,MAAM,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;oBACvD,CAAC,CAAE,SAAuB;oBAC1B,CAAC,CAAC,IAAI,CAAC;YACX,CAAC;YACD,OAAO,SAAS,KAAK,KAAK,CAAC,CAAC,CAAE,SAAuB,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,MAAM,GAAG,GAAG,cAAc,CAAC;QACzB,SAAS;QACT,KAAK;QACL,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,eAAe,EAAE,OAAO,CAAC,eAAe;KACzC,CAAC,CAAC;IACH,OAAO;QACL,GAAG,GAAG;QACN,KAAK;QACL,KAAK;QACL,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE;QACtC,UAAU,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;QAC1D,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE;QAChC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/hub/testkit/memory-store.d.ts

@@ -0,0 +1,62 @@
+import type { ClientEvent, InventoryReport, PluginSyncAcknowledgement } from "../../protocol/index.js";
+import type { HubClientRecord, HubClientRegistration, HubEventBatch, HubEventIngestResult, HubHeartbeat, HubInventoryReport, HubOfferDelivery, HubOfferInput, HubPluginAcknowledgement, HubStore, StoredOffer } from "../types.js";
+type MemoryClient<Principal> = HubClientRecord & {
+    principal: Principal;
+    protocolVersion: number;
+    lastSeen: number;
+};
+type MemoryOffer<Principal> = StoredOffer & {
+    principal: Principal;
+};
+export type MemoryHubSnapshot<Principal> = {
+    /** Test-only process memory. It is intentionally lost on process restart. */
+    clients: Array<MemoryClient<Principal>>;
+    offers: Array<MemoryOffer<Principal>>;
+    events: ClientEvent[];
+    seenEventSequences: Array<[string, number[]]>;
+    watermarks: Record<string, number>;
+    inventory: Array<[string, InventoryReport]>;
+    nextConnectionKey: number;
+};
+export type MemoryHubClient = Omit<MemoryClient<unknown>, "principal"> & {
+    pendingOutboxCount: number;
+};
+/**
+ * A deliberately volatile HubStore adapter for protocol tests only.
+ *
+ * Registrations, offers, events, and acknowledgement state are held in Maps
+ * and arrays, so a process restart loses all of them. Production hosts must
+ * implement HubStore with their own durable storage.
+ */
+export declare class MemoryHubStore<Principal> implements HubStore<Principal> {
+    private readonly onPluginSyncAcknowledgement?;
+    private readonly clients;
+    private offers;
+    private readonly events;
+    private readonly seenEventSequences;
+    private readonly watermarks;
+    private readonly inventory;
+    private nextConnectionKey;
+    constructor(onPluginSyncAcknowledgement?: ((clientId: string, acknowledgement: PluginSyncAcknowledgement) => void) | undefined);
+    registerClient(input: HubClientRegistration<Principal>): Promise<HubClientRecord>;
+    heartbeat(input: HubHeartbeat<Principal>): Promise<void>;
+    listPendingOffers(input: HubOfferDelivery<Principal>): Promise<StoredOffer[]>;
+    enqueueOffer(input: HubOfferInput<Principal>): Promise<StoredOffer>;
+    ingestEvents(input: HubEventBatch<Principal>): Promise<HubEventIngestResult>;
+    acknowledgePluginSync(input: HubPluginAcknowledgement<Principal>): Promise<void>;
+    recordInventory(input: HubInventoryReport<Principal>): Promise<void>;
+    getInventory(input: {
+        principal: Principal;
+        clientId: string;
+    }): Promise<InventoryReport | null>;
+    listClients(): MemoryHubClient[];
+    listEvents(executionId?: string): ClientEvent[];
+    snapshot(): MemoryHubSnapshot<Principal>;
+    restore(snapshot: MemoryHubSnapshot<Principal>): void;
+    private ensureClient;
+    private assertClient;
+    private clientKey;
+    private publicOffer;
+}
+export {};
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/hub/testkit/memory-store.d.ts.map

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