@opendatalabs/personal-server-ts-server 0.0.1-canary.0078f25

package/dist/tunnel/manager.js

@@ -0,0 +1,279 @@
+/**
+ * TunnelManager handles the frpc process lifecycle.
+ *
+ * Responsibilities:
+ * - Generate signed claim and frpc.toml config
+ * - Spawn frpc process with a caller-provided binary path
+ * - Monitor process lifecycle
+ * - Periodically refresh the auth claim before it expires
+ * - Provide status for health endpoint
+ */
+import { spawn } from "node:child_process";
+import { writeFile, mkdir, chmod, access, constants } from "node:fs/promises";
+import { join } from "node:path";
+import { generateSignedClaim, CLAIM_TTL_SECONDS } from "./auth.js";
+import { generateFrpcConfig } from "./config.js";
+import { buildTunnelUrl } from "./verify.js";
+/** Refresh at 80% of TTL to leave buffer before expiry. */
+const REFRESH_INTERVAL_MS = CLAIM_TTL_SECONDS * 0.8 * 1000;
+/** Retry interval when a refresh attempt fails. */
+const REFRESH_RETRY_MS = 30_000;
+export class TunnelManager {
+    storageRoot;
+    process = null;
+    status = "stopped";
+    publicUrl = null;
+    connectedSince = null;
+    lastError = null;
+    config = null;
+    binaryPath = null;
+    refreshTimer = null;
+    refreshing = false;
+    constructor(storageRoot) {
+        this.storageRoot = storageRoot;
+    }
+    /**
+     * Start the frpc process with the given configuration.
+     * Returns the public URL once the tunnel is established.
+     * Automatically schedules periodic claim refresh.
+     */
+    async start(config, binaryPath) {
+        if (this.process) {
+            throw new Error("Tunnel already running");
+        }
+        this.config = config;
+        this.binaryPath = binaryPath;
+        this.status = "starting";
+        this.lastError = null;
+        // Verify binary exists and is executable
+        try {
+            await access(binaryPath, constants.X_OK);
+        }
+        catch {
+            try {
+                await chmod(binaryPath, 0o755);
+            }
+            catch {
+                throw new Error(`frpc binary not found or not executable: ${binaryPath}`);
+            }
+        }
+        const subdomain = config.walletAddress.toLowerCase();
+        this.publicUrl = buildTunnelUrl(subdomain);
+        const configPath = await this.writeFreshConfig(subdomain);
+        await this.spawnProcess(configPath);
+        this.scheduleRefresh();
+        return this.publicUrl;
+    }
+    /**
+     * Stop the frpc process gracefully.
+     */
+    async stop() {
+        this.clearRefreshTimer();
+        if (!this.process) {
+            return;
+        }
+        return new Promise((resolve) => {
+            const proc = this.process;
+            const timeout = setTimeout(() => {
+                // Force kill if graceful shutdown takes too long
+                proc.kill("SIGKILL");
+                resolve();
+            }, 5000);
+            proc.on("exit", () => {
+                clearTimeout(timeout);
+                this.process = null;
+                this.status = "stopped";
+                this.publicUrl = null;
+                this.connectedSince = null;
+                resolve();
+            });
+            // Send SIGTERM for graceful shutdown
+            proc.kill("SIGTERM");
+        });
+    }
+    /**
+     * Check if the tunnel is currently running.
+     */
+    isRunning() {
+        return this.process !== null && this.status === "connected";
+    }
+    /**
+     * Update status based on external verification of the tunnel URL.
+     */
+    setVerified(reachable, error) {
+        if (reachable) {
+            this.status = "connected";
+            this.lastError = null;
+        }
+        else {
+            this.status = "error";
+            this.lastError = error ?? "Tunnel URL not reachable";
+        }
+    }
+    /**
+     * Get the current tunnel status.
+     */
+    getStatus() {
+        return {
+            enabled: true,
+            status: this.status,
+            publicUrl: this.publicUrl,
+            connectedSince: this.connectedSince?.toISOString() ?? null,
+            error: this.lastError ?? undefined,
+        };
+    }
+    /**
+     * Get the public URL if connected.
+     */
+    getPublicUrl() {
+        return this.publicUrl;
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Generate a fresh signed claim, write frpc.toml, and return the config path.
+     */
+    async writeFreshConfig(subdomain) {
+        const config = this.config;
+        const { claim, sig } = await generateSignedClaim({
+            ownerAddress: config.ownerAddress,
+            walletAddress: config.walletAddress,
+            runId: config.runId,
+            serverKeypair: config.serverKeypair,
+        });
+        const frpcConfig = generateFrpcConfig({
+            serverAddr: config.serverAddr,
+            serverPort: config.serverPort,
+            localPort: config.localPort,
+            subdomain,
+            walletAddress: config.walletAddress,
+            ownerAddress: config.ownerAddress,
+            runId: config.runId,
+            authClaim: claim,
+            authSig: sig,
+        });
+        const tunnelDir = join(this.storageRoot, "tunnel");
+        await mkdir(tunnelDir, { recursive: true });
+        const configPath = join(tunnelDir, "frpc.toml");
+        await writeFile(configPath, frpcConfig, "utf-8");
+        return configPath;
+    }
+    /**
+     * Spawn the frpc process and wait for it to report a successful connection
+     * (or resolve optimistically after a timeout).
+     */
+    async spawnProcess(configPath) {
+        return new Promise((resolve, reject) => {
+            const proc = spawn(this.binaryPath, ["-c", configPath], {
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            this.process = proc;
+            let startupOutput = "";
+            let resolved = false;
+            const onData = (data) => {
+                const text = data.toString();
+                startupOutput += text;
+                if (text.includes("start proxy success") ||
+                    text.includes("login to server success")) {
+                    if (!resolved) {
+                        resolved = true;
+                        this.status = "connected";
+                        this.connectedSince = new Date();
+                        resolve();
+                    }
+                }
+            };
+            proc.stdout?.on("data", onData);
+            proc.stderr?.on("data", onData);
+            proc.on("error", (err) => {
+                this.status = "error";
+                this.lastError = err.message;
+                if (!resolved) {
+                    resolved = true;
+                    reject(new Error(`Failed to start frpc: ${err.message}`));
+                }
+            });
+            proc.on("exit", (code) => {
+                this.process = null;
+                // During a planned refresh cycle, don't update status
+                if (this.refreshing)
+                    return;
+                if (code !== 0 && !resolved) {
+                    this.status = "error";
+                    this.lastError = `frpc exited with code ${code}: ${startupOutput}`;
+                    resolved = true;
+                    reject(new Error(this.lastError));
+                }
+                else if (this.status === "connected") {
+                    this.status = "disconnected";
+                }
+            });
+            // Timeout for startup — resolve optimistically
+            setTimeout(() => {
+                if (!resolved) {
+                    resolved = true;
+                    this.status = "connected";
+                    this.connectedSince = new Date();
+                    resolve();
+                }
+            }, 10_000);
+        });
+    }
+    /**
+     * Kill the running frpc process and wait for it to exit.
+     */
+    async killProcess() {
+        if (!this.process)
+            return;
+        return new Promise((resolve) => {
+            const proc = this.process;
+            const timeout = setTimeout(() => {
+                proc.kill("SIGKILL");
+                this.process = null;
+                resolve();
+            }, 3000);
+            proc.once("exit", () => {
+                clearTimeout(timeout);
+                this.process = null;
+                resolve();
+            });
+            proc.kill("SIGTERM");
+        });
+    }
+    scheduleRefresh() {
+        this.clearRefreshTimer();
+        this.refreshTimer = setTimeout(() => void this.refreshClaim(), REFRESH_INTERVAL_MS);
+    }
+    clearRefreshTimer() {
+        if (this.refreshTimer) {
+            clearTimeout(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+    }
+    /**
+     * Refresh the auth claim by rewriting frpc.toml and restarting the process.
+     * On failure, retries after a shorter interval.
+     */
+    async refreshClaim() {
+        if (!this.config || !this.binaryPath)
+            return;
+        const subdomain = this.config.walletAddress.toLowerCase();
+        try {
+            const configPath = await this.writeFreshConfig(subdomain);
+            // Stop old process (suppress status change during restart)
+            this.refreshing = true;
+            await this.killProcess();
+            this.refreshing = false;
+            this.status = "starting";
+            await this.spawnProcess(configPath);
+            this.scheduleRefresh();
+        }
+        catch {
+            this.refreshing = false;
+            // Retry sooner on failure
+            this.refreshTimer = setTimeout(() => void this.refreshClaim(), REFRESH_RETRY_MS);
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/tunnel/manager.js.map

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

package/dist/tunnel/verify.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tunnel URL helpers: build the canonical tunnel URL and verify reachability.
+ */
+export interface VerifyTunnelOptions {
+    /** Maximum number of attempts (default: 5) */
+    maxAttempts?: number;
+    /** Delay between retries in ms (default: 2000) */
+    retryDelayMs?: number;
+    /** Timeout per request in ms (default: 5000) */
+    timeoutMs?: number;
+    /** Custom fetch implementation (for testing) */
+    fetchFn?: typeof fetch;
+}
+export interface VerifyTunnelResult {
+    reachable: boolean;
+    attempts: number;
+    error?: string;
+}
+/**
+ * Build the canonical tunnel URL for a wallet address.
+ */
+export declare function buildTunnelUrl(walletAddress: string): string;
+/**
+ * Verify that a tunnel URL is reachable by hitting its /health endpoint.
+ * Retries on failure with configurable attempts, delay, and timeout.
+ */
+export declare function verifyTunnelUrl(publicUrl: string, options?: VerifyTunnelOptions): Promise<VerifyTunnelResult>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/tunnel/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/tunnel/verify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CA4B7B"}

package/dist/tunnel/verify.js

@@ -0,0 +1,40 @@
+/**
+ * Tunnel URL helpers: build the canonical tunnel URL and verify reachability.
+ */
+/**
+ * Build the canonical tunnel URL for a wallet address.
+ */
+export function buildTunnelUrl(walletAddress) {
+    return `https://${walletAddress.toLowerCase()}.server.vana.org`;
+}
+/**
+ * Verify that a tunnel URL is reachable by hitting its /health endpoint.
+ * Retries on failure with configurable attempts, delay, and timeout.
+ */
+export async function verifyTunnelUrl(publicUrl, options) {
+    const maxAttempts = options?.maxAttempts ?? 5;
+    const retryDelayMs = options?.retryDelayMs ?? 2000;
+    const timeoutMs = options?.timeoutMs ?? 5000;
+    const fetchFn = options?.fetchFn ?? fetch;
+    const healthUrl = `${publicUrl}/health`;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            const response = await fetchFn(healthUrl, {
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+            if (response.ok) {
+                return { reachable: true, attempts: attempt };
+            }
+            lastError = `HTTP ${response.status}`;
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err.message : "Unknown error";
+        }
+        if (attempt < maxAttempts) {
+            await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
+        }
+    }
+    return { reachable: false, attempts: maxAttempts, error: lastError };
+}
+//# sourceMappingURL=verify.js.map

package/dist/tunnel/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/tunnel/verify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,aAAqB;IAClD,OAAO,WAAW,aAAa,CAAC,WAAW,EAAE,kBAAkB,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAiB,EACjB,OAA6B;IAE7B,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC;IACnD,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC;IAE1C,MAAM,SAAS,GAAG,GAAG,SAAS,SAAS,CAAC;IACxC,IAAI,SAA6B,CAAC;IAElC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE;gBACxC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;aACvC,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YAChD,CAAC;YACD,SAAS,GAAG,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACnE,CAAC;QAED,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YAC1B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACvE,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@opendatalabs/personal-server-ts-server",
+  "version": "0.0.1-canary.0078f25",
+  "description": "Hono HTTP server for the Vana Personal Server — routes, middleware, composition root",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vana-com/personal-server-ts.git",
+    "directory": "packages/server"
+  },
+  "homepage": "https://github.com/vana-com/personal-server-ts#readme",
+  "bugs": {
+    "url": "https://github.com/vana-com/personal-server-ts/issues"
+  },
+  "type": "module",
+  "main": "./dist/api.js",
+  "types": "./dist/api.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/api.d.ts",
+      "import": "./dist/api.js"
+    },
+    "./runtime": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "copy-ui": "mkdir -p dist/ui && cp src/ui/index.html dist/ui/index.html",
+    "build": "tsc --build && npm run copy-ui",
+    "start": "node dist/index.js",
+    "dev": "node --watch dist/index.js"
+  },
+  "dependencies": {
+    "@opendatalabs/personal-server-ts-core": "0.0.1-canary.0078f25",
+    "@opendatalabs/personal-server-ts-mcp": "*",
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "hono": "^4.7.0",
+    "@hono/node-server": "^1.14.0"
+  }
+}