@vhyxvoid/agent 1.0.0

package/dist/cache/ResponseCache.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+"use strict";
+// packages/agent/src/cli.ts
+// CLI entry point: npx @vhyxvoid/agent
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const AgentClient_1 = require("./AgentClient");
+const crypto_1 = __importDefault(require("crypto"));
+const package_json_1 = require("../package.json");
+const program = new commander_1.Command();
+program
+    .name("vhyxvoid")
+    .description("Platform tunnel agent.\n" +
+    "Connects your local server to the platform so the frontend SDK can reach it.")
+    .version(package_json_1.version)
+    .option("-k, --key <keyId>", "API key ID (e.g. vhyxvoid_dev_abc123). Env: VHYXVOID_API_KEY", process.env.VHYXVOID_API_KEY)
+    .option("-s, --secret <secret>", "API key secret (shown once at creation). Env: VHYXVOID_SECRET", process.env.VHYXVOID_SECRET)
+    .option("-p, --port <port>", "Local backend port to tunnel (e.g. 3000). Env: VHYXVOID_PORT", process.env.VHYXVOID_PORT ?? "3000")
+    .option("-l, --label <label>", "Tunnel label — identifies this agent if you run multiple. Env: VHYXVOID_LABEL", process.env.VHYXVOID_LABEL ?? "default")
+    .option("--hub <url>", "Hub WebSocket URL. Env: VHYXVOID_HUB_URL", process.env.VHYXVOID_HUB_URL ?? "wss://hub.yourplatform.com/agent")
+    .option("--pepper <pepper>", "Server HMAC pepper (from platform settings). Env: SERVER_HMAC_PEPPER", process.env.SERVER_HMAC_PEPPER ?? "")
+    .option("--queue-path <path>", "SQLite queue file path. Default: ~/.vhyxvoid/queue.db", process.env.VHYXVOID_QUEUE_PATH)
+    .option("--no-local-discovery", "Disable local discovery server on port 4242")
+    .parse(process.argv);
+const opts = program.opts();
+// ── Validate required options ─────────────────────────────────────────────────
+if (!opts.key) {
+    console.error("❌  --key is required. Get your API key from the platform dashboard.");
+    console.error("    Usage: vhyxvoid --key vhyxvoid_dev_xxx --secret xxx --port 3000");
+    process.exit(1);
+}
+if (!opts.secret) {
+    console.error("❌  --secret is required. It was shown once when you created the API key.");
+    console.error("    If you lost it, rotate the key from the dashboard to get a new secret.");
+    process.exit(1);
+}
+// ── Hash the secret ───────────────────────────────────────────────────────────
+// The agent hashes the raw secret on startup using the server pepper.
+// After this point, the raw secret is never kept in memory.
+// secretHash = HMAC-SHA256(rawSecret, pepper)
+// This matches how the Hub and API key module hash secrets in the database.
+const pepper = opts.pepper;
+const secretHash = pepper
+    ? crypto_1.default.createHmac("sha256", pepper).update(opts.secret).digest("hex")
+    : crypto_1.default.createHmac("sha256", "dev-pepper").update(opts.secret).digest("hex");
+if (!pepper) {
+    console.warn("⚠  --pepper not set. Using dev-pepper — this will not work in production.\n" +
+        "   Set SERVER_HMAC_PEPPER to match the value in your hub environment.");
+}
+// ── Start agent ───────────────────────────────────────────────────────────────
+const port = parseInt(opts.port, 10);
+if (isNaN(port) || port < 1 || port > 65535) {
+    console.error(`❌  Invalid port: "${opts.port}"`);
+    process.exit(1);
+}
+console.log(`\nvhyxvoid-agent v${package_json_1.version}`);
+console.log(`  Key:    ${opts.key}`);
+console.log(`  Label:  ${opts.label}`);
+console.log(`  Port:   ${port}`);
+console.log(`  Hub:    ${opts.hub}`);
+console.log(`  Queue:  ${opts.queuePath ?? "~/.vhyxvoid/queue.db"}`);
+console.log(`  Local discovery: ${opts.localDiscovery ? "enabled" : "disabled"}`);
+console.log("");
+const agent = new AgentClient_1.AgentClient({
+    hubUrl: opts.hub,
+    keyId: opts.key,
+    secretHash,
+    label: opts.label,
+    port,
+    agentVersion: package_json_1.version,
+    queuePath: opts.queuePath,
+    localDiscovery: opts.localDiscovery,
+    onStateChange: (state) => {
+        if (state === "CONNECTED") {
+            console.log(`✅  Tunnel active — label "${opts.label}" → localhost:${port}`);
+            console.log(`    SDK requests with label "${opts.label}" will reach your backend.\n`);
+        }
+        if (state === "RECONNECTING") {
+            console.log("⚠   Disconnected from hub — reconnecting automatically...");
+        }
+        if (state === "STOPPED") {
+            console.log("🛑  Agent stopped.");
+        }
+    },
+});
+agent.start();
+// ── Graceful shutdown ─────────────────────────────────────────────────────────
+process.on("SIGTERM", () => {
+    console.log("\nReceived SIGTERM — shutting down gracefully...");
+    agent.stop();
+    process.exit(0);
+});
+process.on("SIGINT", () => {
+    console.log("\nReceived SIGINT — shutting down gracefully...");
+    agent.stop();
+    process.exit(0);
+});
+process.on("uncaughtException", (err) => {
+    console.error("Uncaught exception:", err);
+    agent.stop();
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/discovery/LocalDiscoveryServer.d.ts

@@ -0,0 +1,24 @@
+export interface DiscoveryPayload {
+    /** npm package version */
+    agentVersion: string;
+    /** Tunnel label */
+    label: string;
+    /** Local backend port the agent is proxying to */
+    port: number;
+    /**
+     * SHA-256 of accountId — lets SDK verify it's talking to an agent for the same account
+     * without exposing the actual accountId over the local network.
+     * Populated after hub:registered is received.
+     */
+    accountIdHash: string;
+}
+export declare class LocalDiscoveryServer {
+    private server;
+    private payload;
+    constructor(payload: DiscoveryPayload);
+    /** Update the accountIdHash after hub registration completes */
+    setAccountIdHash(hash: string): void;
+    start(): void;
+    stop(): void;
+}
+//# sourceMappingURL=LocalDiscoveryServer.d.ts.map

package/dist/discovery/LocalDiscoveryServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalDiscoveryServer.d.ts","sourceRoot":"","sources":["../../src/discovery/LocalDiscoveryServer.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAAmB;gBAEtB,OAAO,EAAE,gBAAgB;IAIrC,gEAAgE;IAChE,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC,KAAK,IAAI,IAAI;IAqCb,IAAI,IAAI,IAAI;CAIb"}

package/dist/discovery/LocalDiscoveryServer.js

@@ -0,0 +1,58 @@
+"use strict";
+// packages/agent/src/discovery/LocalDiscoveryServer.ts
+// Broadcasts agent presence on localhost:4242.
+// SDK discovers this and bypasses Hub for local-to-local calls (<1ms overhead).
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalDiscoveryServer = void 0;
+const http_1 = __importDefault(require("http"));
+const protocol_1 = require("@vhyxvoid/protocol");
+class LocalDiscoveryServer {
+    server = null;
+    payload;
+    constructor(payload) {
+        this.payload = payload;
+    }
+    /** Update the accountIdHash after hub registration completes */
+    setAccountIdHash(hash) {
+        this.payload = { ...this.payload, accountIdHash: hash };
+    }
+    start() {
+        this.server = http_1.default.createServer((req, res) => {
+            // Only respond to the discovery endpoint
+            if (req.url !== "/vhyxvoid" || req.method !== "GET") {
+                res.writeHead(404).end();
+                return;
+            }
+            const body = JSON.stringify(this.payload);
+            res.writeHead(200, {
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(body).toString(),
+                "Cache-Control": "no-cache",
+            });
+            res.end(body);
+        });
+        this.server.listen(protocol_1.LIMITS.LOCAL_AGENT_DISCOVERY_PORT, "127.0.0.1", () => {
+            console.info(`[discovery] local discovery server ready on port ${protocol_1.LIMITS.LOCAL_AGENT_DISCOVERY_PORT}`);
+        });
+        this.server.on("error", (err) => {
+            if (err.code === "EADDRINUSE") {
+                // Non-fatal — another agent instance may be running
+                console.warn(`[discovery] port ${protocol_1.LIMITS.LOCAL_AGENT_DISCOVERY_PORT} in use — ` +
+                    `local discovery disabled. Another agent may already be running.`);
+            }
+            else {
+                console.warn(`[discovery] server error: ${err.message}`);
+            }
+            // Local discovery is an optimization, not required — never crash here
+        });
+    }
+    stop() {
+        this.server?.close();
+        this.server = null;
+    }
+}
+exports.LocalDiscoveryServer = LocalDiscoveryServer;
+//# sourceMappingURL=LocalDiscoveryServer.js.map

package/dist/discovery/LocalDiscoveryServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalDiscoveryServer.js","sourceRoot":"","sources":["../../src/discovery/LocalDiscoveryServer.ts"],"names":[],"mappings":";AAAA,uDAAuD;AACvD,+CAA+C;AAC/C,gFAAgF;;;;;;AAEhF,gDAAwB;AACxB,iDAA4C;AAiB5C,MAAa,oBAAoB;IACvB,MAAM,GAAuB,IAAI,CAAC;IAClC,OAAO,CAAmB;IAElC,YAAY,OAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,gEAAgE;IAChE,gBAAgB,CAAC,IAAY;QAC3B,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,cAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YAC3C,yCAAyC;YACzC,IAAI,GAAG,CAAC,GAAG,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBACpD,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;gBACzB,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;gBACjB,cAAc,EAAE,kBAAkB;gBAClC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;gBACpD,eAAe,EAAE,UAAU;aAC5B,CAAC,CAAC;YACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAM,CAAC,0BAA0B,EAAE,WAAW,EAAE,GAAG,EAAE;YACtE,OAAO,CAAC,IAAI,CACV,oDAAoD,iBAAM,CAAC,0BAA0B,EAAE,CACxF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;YACrD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC9B,oDAAoD;gBACpD,OAAO,CAAC,IAAI,CACV,oBAAoB,iBAAM,CAAC,0BAA0B,YAAY;oBAC/D,iEAAiE,CACpE,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,6BAA6B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,sEAAsE;QACxE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;CACF;AAtDD,oDAsDC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { AgentClient } from "./AgentClient";
+export type { AgentConfig, AgentState } from "./AgentClient";
+export { DurableQueue } from "./queue/DurableQueue";
+export type { QueueItem, QueueDirection } from "./queue/DurableQueue";
+export { BackendProxy } from "./proxy/BackendProxy";
+export { ResponseCache } from "./cache/ResponseCache";
+export type { CachedResponse } from "./cache/ResponseCache";
+export { MessageBatcher } from "./batcher/MessageBatcher";
+export { replayQueue } from "./replay/replayQueue";
+export type { ReplayResult } from "./replay/replayQueue";
+export { LocalDiscoveryServer } from "./discovery/LocalDiscoveryServer";
+export type { DiscoveryPayload } from "./discovery/LocalDiscoveryServer";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+// packages/agent/src/index.ts
+// Public API of the agent package when imported as a library (not CLI).
+// Consumers who want to embed the agent in their own process import from here.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalDiscoveryServer = exports.replayQueue = exports.MessageBatcher = exports.ResponseCache = exports.BackendProxy = exports.DurableQueue = exports.AgentClient = void 0;
+var AgentClient_1 = require("./AgentClient");
+Object.defineProperty(exports, "AgentClient", { enumerable: true, get: function () { return AgentClient_1.AgentClient; } });
+var DurableQueue_1 = require("./queue/DurableQueue");
+Object.defineProperty(exports, "DurableQueue", { enumerable: true, get: function () { return DurableQueue_1.DurableQueue; } });
+var BackendProxy_1 = require("./proxy/BackendProxy");
+Object.defineProperty(exports, "BackendProxy", { enumerable: true, get: function () { return BackendProxy_1.BackendProxy; } });
+var ResponseCache_1 = require("./cache/ResponseCache");
+Object.defineProperty(exports, "ResponseCache", { enumerable: true, get: function () { return ResponseCache_1.ResponseCache; } });
+var MessageBatcher_1 = require("./batcher/MessageBatcher");
+Object.defineProperty(exports, "MessageBatcher", { enumerable: true, get: function () { return MessageBatcher_1.MessageBatcher; } });
+var replayQueue_1 = require("./replay/replayQueue");
+Object.defineProperty(exports, "replayQueue", { enumerable: true, get: function () { return replayQueue_1.replayQueue; } });
+var LocalDiscoveryServer_1 = require("./discovery/LocalDiscoveryServer");
+Object.defineProperty(exports, "LocalDiscoveryServer", { enumerable: true, get: function () { return LocalDiscoveryServer_1.LocalDiscoveryServer; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,8BAA8B;AAC9B,wEAAwE;AACxE,+EAA+E;;;AAE/E,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AAEpB,qDAAoD;AAA3C,4GAAA,YAAY,OAAA;AAErB,qDAAoD;AAA3C,4GAAA,YAAY,OAAA;AACrB,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AAEtB,2DAA0D;AAAjD,gHAAA,cAAc,OAAA;AACvB,oDAAmD;AAA1C,0GAAA,WAAW,OAAA;AAEpB,yEAAwE;AAA/D,4HAAA,oBAAoB,OAAA"}

package/dist/proxy/BackendProxy.d.ts

@@ -0,0 +1,19 @@
+import { TunnelForwardMsg, TunnelResponseMsg } from "@vhyxvoid/protocol";
+export declare class BackendProxy {
+    private readonly port;
+    private readonly client;
+    private readonly cache;
+    private evictTimer;
+    constructor(port: number);
+    forward(msg: TunnelForwardMsg): Promise<Omit<TunnelResponseMsg, "v" | "type" | "requestId">>;
+    /** Invalidate cached GETs related to a mutating request path */
+    invalidateCacheFor(method: string, path: string): void;
+    getCacheStats(): {
+        size: number;
+        totalHits: number;
+    };
+    stop(): void;
+    private sanitizeInboundHeaders;
+    private sanitizeOutboundHeaders;
+}
+//# sourceMappingURL=BackendProxy.d.ts.map

package/dist/proxy/BackendProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackendProxy.d.ts","sourceRoot":"","sources":["../../src/proxy/BackendProxy.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,oBAAoB,CAAC;AAiB5B,qBAAa,YAAY;IAKX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,UAAU,CAA+B;gBAEpB,IAAI,EAAE,MAAM;IAoBnC,OAAO,CACX,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,GAAG,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC;IA8C/D,gEAAgE;IAChE,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQtD,aAAa;;;;IAIb,IAAI,IAAI,IAAI;IAQZ,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,uBAAuB;CAUhC"}

package/dist/proxy/BackendProxy.js

@@ -0,0 +1,122 @@
+"use strict";
+// packages/agent/src/proxy/BackendProxy.ts
+// HTTP client to localhost. Never throws — always returns a response.
+// Uses axios with validateStatus: () => true so 4xx/5xx pass through.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendProxy = void 0;
+const axios_1 = __importDefault(require("axios"));
+const protocol_1 = require("@vhyxvoid/protocol");
+const ResponseCache_1 = require("../cache/ResponseCache");
+const HOP_BY_HOP = new Set([
+    "connection",
+    "keep-alive",
+    "proxy-authenticate",
+    "proxy-authorization",
+    "te",
+    "trailers",
+    "transfer-encoding",
+    "upgrade",
+]);
+// Evict expired cache entries every 60 seconds
+const CACHE_EVICT_INTERVAL_MS = 60_000;
+class BackendProxy {
+    port;
+    client;
+    cache = new ResponseCache_1.ResponseCache();
+    evictTimer = null;
+    constructor(port) {
+        this.port = port;
+        this.client = axios_1.default.create({
+            baseURL: `http://127.0.0.1:${port}`,
+            timeout: 28_000,
+            maxContentLength: protocol_1.LIMITS.MAX_PAYLOAD_BYTES,
+            maxBodyLength: protocol_1.LIMITS.MAX_PAYLOAD_BYTES,
+            validateStatus: () => true,
+            decompress: true,
+            responseType: "arraybuffer",
+        });
+        // Periodic cache eviction
+        this.evictTimer = setInterval(() => this.cache.evictExpired(), CACHE_EVICT_INTERVAL_MS);
+        // Don't prevent process exit
+        this.evictTimer.unref?.();
+    }
+    async forward(msg) {
+        // ── Cache check (GET only) ────────────────────────────────────────────────
+        const cached = this.cache.get(msg.method, msg.path, msg.query);
+        if (cached) {
+            return {
+                status: cached.status,
+                headers: { ...cached.headers, "x-vhyxvoid-cache": "HIT" },
+                body: cached.body,
+                durationMs: 0, // served from memory
+            };
+        }
+        // ── Real HTTP request ─────────────────────────────────────────────────────
+        const start = Date.now();
+        const url = msg.path + (msg.query ? `?${msg.query}` : "");
+        const response = await this.client.request({
+            method: msg.method,
+            url,
+            headers: this.sanitizeInboundHeaders(msg.headers),
+            data: msg.body ?? undefined,
+        });
+        const bodyBuffer = response.data;
+        const bodyStr = bodyBuffer.length > 0 ? bodyBuffer.toString("utf8") : null;
+        const headers = this.sanitizeOutboundHeaders(response.headers);
+        const durationMs = Date.now() - start;
+        // ── Store in cache if cacheable ───────────────────────────────────────────
+        this.cache.set(msg.method, msg.path, msg.query, {
+            status: response.status,
+            headers,
+            body: bodyStr,
+            durationMs,
+        });
+        return {
+            status: response.status,
+            headers: { ...headers, "x-vhyxvoid-cache": "MISS" },
+            body: bodyStr,
+            durationMs,
+        };
+    }
+    /** Invalidate cached GETs related to a mutating request path */
+    invalidateCacheFor(method, path) {
+        if (["POST", "PUT", "PATCH", "DELETE"].includes(method.toUpperCase())) {
+            // Invalidate the base path and common related paths
+            const basePath = path.split("/").slice(0, -1).join("/");
+            this.cache.invalidatePrefix(basePath || path);
+        }
+    }
+    getCacheStats() {
+        return this.cache.stats();
+    }
+    stop() {
+        if (this.evictTimer) {
+            clearInterval(this.evictTimer);
+            this.evictTimer = null;
+        }
+        this.cache.clear();
+    }
+    sanitizeInboundHeaders(headers) {
+        const clean = {};
+        for (const [k, v] of Object.entries(headers)) {
+            if (!HOP_BY_HOP.has(k.toLowerCase()))
+                clean[k] = v;
+        }
+        clean["x-forwarded-by"] = "vhyxvoid";
+        clean["x-forwarded-host"] = `127.0.0.1:${this.port}`;
+        return clean;
+    }
+    sanitizeOutboundHeaders(headers) {
+        const clean = {};
+        for (const [k, v] of Object.entries(headers)) {
+            if (!HOP_BY_HOP.has(k.toLowerCase()) && typeof v === "string")
+                clean[k] = v;
+        }
+        return clean;
+    }
+}
+exports.BackendProxy = BackendProxy;
+//# sourceMappingURL=BackendProxy.js.map

package/dist/proxy/BackendProxy.js.map

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

package/dist/queue/DurableQueue.d.ts

@@ -0,0 +1,37 @@
+import { TunnelForwardMsg, TunnelResponseMsg, TunnelAgentErrorMsg } from "@vhyxvoid/protocol";
+export type QueueDirection = "inbound" | "outbound";
+export interface QueueItem {
+    id: string;
+    direction: QueueDirection;
+    payload: string;
+    ts: number;
+    attempts: number;
+    maxAttempts: number;
+    nextRetryAt: number;
+}
+export type InboundPayload = TunnelForwardMsg;
+export type OutboundPayload = TunnelResponseMsg | TunnelAgentErrorMsg;
+export declare class DurableQueue {
+    private readonly db;
+    constructor(dbPath: string);
+    private migrate;
+    enqueueInbound(payload: InboundPayload): void;
+    enqueueOutbound(payload: OutboundPayload): void;
+    /**
+     * Returns all items ready for replay, ordered:
+     * 1. OUTBOUND first (send cached responses before processing new requests)
+     * 2. Within same direction: oldest first (preserve request ordering)
+     */
+    drainForReplay(): QueueItem[];
+    markSuccess(id: string): void;
+    markFailed(id: string): void;
+    count(): {
+        ready: number;
+        pending: number;
+        deadLetter: number;
+    };
+    /** Drain dead letter for inspection. Returns last N items. */
+    deadLetterItems(limit?: number): QueueItem[];
+    close(): void;
+}
+//# sourceMappingURL=DurableQueue.d.ts.map

package/dist/queue/DurableQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DurableQueue.d.ts","sourceRoot":"","sources":["../../src/queue/DurableQueue.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,cAAc,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAC9C,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;AAEtE,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;gBAE3B,MAAM,EAAE,MAAM;IAS1B,OAAO,CAAC,OAAO;IA8Bf,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAgB7C,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAgB/C;;;;OAIG;IACH,cAAc,IAAI,SAAS,EAAE;IAe7B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI7B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IA0C5B,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAkB/D,8DAA8D;IAC9D,eAAe,CAAC,KAAK,SAAK,GAAG,SAAS,EAAE;IAWxC,KAAK,IAAI,IAAI;CAGd"}

package/dist/queue/DurableQueue.js

@@ -0,0 +1,142 @@
+"use strict";
+// packages/agent/src/queue/DurableQueue.ts
+// SQLite-backed durable queue. Single source of truth for all pending messages.
+// WAL mode: survives process crashes without corruption.
+// Never shares storage with batching — batcher is in-memory only.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DurableQueue = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const crypto_1 = require("crypto");
+const protocol_1 = require("@vhyxvoid/protocol");
+class DurableQueue {
+    db;
+    constructor(dbPath) {
+        this.db = new better_sqlite3_1.default(dbPath);
+        this.db.pragma("journal_mode = WAL"); // crash-safe: writes go to WAL file first
+        this.db.pragma("synchronous = NORMAL"); // balanced: fsync on WAL checkpoint only
+        this.db.pragma("foreign_keys = ON");
+        this.db.pragma("busy_timeout = 5000"); // wait up to 5s on lock contention
+        this.migrate();
+    }
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS queue (
+        id           TEXT    PRIMARY KEY,
+        direction    TEXT    NOT NULL CHECK(direction IN ('inbound', 'outbound')),
+        payload      TEXT    NOT NULL,
+        ts           INTEGER NOT NULL,
+        attempts     INTEGER NOT NULL DEFAULT 0,
+        max_attempts INTEGER NOT NULL DEFAULT 5,
+        next_retry_at INTEGER NOT NULL DEFAULT 0
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_queue_direction_retry
+        ON queue(direction, next_retry_at);
+
+      CREATE INDEX IF NOT EXISTS idx_queue_ts
+        ON queue(ts);
+
+      -- Dead letter: items that exceeded max_attempts
+      CREATE TABLE IF NOT EXISTS dead_letter (
+        id           TEXT    PRIMARY KEY,
+        direction    TEXT    NOT NULL,
+        payload      TEXT    NOT NULL,
+        ts           INTEGER NOT NULL,
+        attempts     INTEGER NOT NULL,
+        failed_at    INTEGER NOT NULL
+      );
+    `);
+    }
+    enqueueInbound(payload) {
+        this.db
+            .prepare(`
+      INSERT INTO queue (id, direction, payload, ts, attempts, max_attempts, next_retry_at)
+      VALUES (?, 'inbound', ?, ?, 0, ?, 0)
+    `)
+            .run((0, crypto_1.randomUUID)(), JSON.stringify(payload), Date.now(), protocol_1.LIMITS.QUEUE_MAX_ATTEMPTS_INBOUND);
+    }
+    enqueueOutbound(payload) {
+        this.db
+            .prepare(`
+      INSERT INTO queue (id, direction, payload, ts, attempts, max_attempts, next_retry_at)
+      VALUES (?, 'outbound', ?, ?, 0, ?, 0)
+    `)
+            .run((0, crypto_1.randomUUID)(), JSON.stringify(payload), Date.now(), protocol_1.LIMITS.QUEUE_MAX_ATTEMPTS_OUTBOUND);
+    }
+    /**
+     * Returns all items ready for replay, ordered:
+     * 1. OUTBOUND first (send cached responses before processing new requests)
+     * 2. Within same direction: oldest first (preserve request ordering)
+     */
+    drainForReplay() {
+        return this.db
+            .prepare(`
+      SELECT id, direction, payload, ts, attempts, max_attempts, next_retry_at
+      FROM queue
+      WHERE next_retry_at <= ?
+      ORDER BY
+        CASE direction WHEN 'outbound' THEN 0 ELSE 1 END ASC,
+        ts ASC
+    `)
+            .all(Date.now());
+    }
+    markSuccess(id) {
+        this.db.prepare("DELETE FROM queue WHERE id = ?").run(id);
+    }
+    markFailed(id) {
+        const item = this.db
+            .prepare("SELECT * FROM queue WHERE id = ?")
+            .get(id);
+        if (!item)
+            return;
+        const newAttempts = item.attempts + 1;
+        if (newAttempts >= item.maxAttempts) {
+            // Move to dead letter table
+            this.db.transaction(() => {
+                this.db
+                    .prepare(`
+          INSERT INTO dead_letter (id, direction, payload, ts, attempts, failed_at)
+          VALUES (?, ?, ?, ?, ?, ?)
+        `)
+                    .run(item.id, item.direction, item.payload, item.ts, newAttempts, Date.now());
+                this.db.prepare("DELETE FROM queue WHERE id = ?").run(id);
+            })();
+            return;
+        }
+        // Exponential backoff: 1s, 2s, 4s, 8s, 16s … capped at 5 min
+        const backoffMs = Math.min(1000 * Math.pow(2, newAttempts - 1), 300_000);
+        this.db
+            .prepare(`
+      UPDATE queue SET attempts = ?, next_retry_at = ? WHERE id = ?
+    `)
+            .run(newAttempts, Date.now() + backoffMs, id);
+    }
+    count() {
+        const now = Date.now();
+        const ready = this.db
+            .prepare("SELECT COUNT(*) as n FROM queue WHERE next_retry_at <= ?")
+            .get(now).n;
+        const pending = this.db
+            .prepare("SELECT COUNT(*) as n FROM queue WHERE next_retry_at > ?")
+            .get(now).n;
+        const deadLetter = this.db.prepare("SELECT COUNT(*) as n FROM dead_letter").get().n;
+        return { ready, pending, deadLetter };
+    }
+    /** Drain dead letter for inspection. Returns last N items. */
+    deadLetterItems(limit = 50) {
+        return this.db
+            .prepare(`
+      SELECT id, direction, payload, ts, attempts, 0 as max_attempts, failed_at as next_retry_at
+      FROM dead_letter ORDER BY failed_at DESC LIMIT ?
+    `)
+            .all(limit);
+    }
+    close() {
+        this.db.close();
+    }
+}
+exports.DurableQueue = DurableQueue;
+//# sourceMappingURL=DurableQueue.js.map

package/dist/queue/DurableQueue.js.map

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

package/dist/replay/replayQueue.d.ts

@@ -0,0 +1,11 @@
+import { DurableQueue } from "../queue/DurableQueue";
+import { BackendProxy } from "../proxy/BackendProxy";
+type SendFn = (data: string) => void;
+export interface ReplayResult {
+    succeeded: number;
+    failed: number;
+    skipped: number;
+}
+export declare function replayQueue(queue: DurableQueue, send: SendFn, proxy: BackendProxy): Promise<ReplayResult>;
+export {};
+//# sourceMappingURL=replayQueue.d.ts.map

package/dist/replay/replayQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replayQueue.d.ts","sourceRoot":"","sources":["../../src/replay/replayQueue.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAa,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAQrD,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAErC,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,YAAY,CAAC,CAsCvB"}