#1 Persistent memory for AI coding agents based on real-world benchmarks
TypeScript agentmemoryagentsaiclaudeclaudecodecodexcopilotcursorgenaiharnesshermesmemoryompopenclawopencodepi
fix(cli): accurately display bound viewer port on splash screen (#560)
Tanmay Shirbhayyeedd1ceb916c5
diff --git a/src/cli.ts b/src/cli.tsindex 3893e361..e1ea9757 100644--- a/src/cli.ts+++ b/src/cli.ts@@ -195,9 +195,36 @@ function getBaseUrl(): string {return `http://localhost:${getRestPort()}`;}+let discoveredViewerPort: number | null = null;++export async function discoverViewerPort(): Promise<void> {+ if (discoveredViewerPort !== null) return;+ try {+ const res = await fetch(`${getBaseUrl()}/agentmemory/livez`, {+ signal: AbortSignal.timeout(1000),+ });+ if (res.ok) {+ const data = await res.json() as { viewerPort?: number | null };+ if (typeof data.viewerPort === "number") {+ discoveredViewerPort = data.viewerPort;+ }+ }+ } catch {}+}+function getViewerUrl(): string {const envUrl = process.env["AGENTMEMORY_VIEWER_URL"];if (envUrl) return envUrl.replace(/\/+$/, "");++ if (discoveredViewerPort !== null) {+ try {+ const u = new URL(getBaseUrl());+ return `${u.protocol}//${u.hostname}:${discoveredViewerPort}`;+ } catch {+ return `http://localhost:${discoveredViewerPort}`;+ }+ }+try {const u = new URL(getBaseUrl());const vPort =@@ -257,7 +284,18 @@ async function isAgentmemoryReady(): Promise<boolean> {const res = await fetch(`${getBaseUrl()}/agentmemory/livez`, {signal: AbortSignal.timeout(2000),});- return res.ok;+ if (!res.ok) return false;+ try {+ const data = await res.json() as { viewerPort?: number | null; viewerSkipped?: boolean };+ if (typeof data.viewerPort === "number") {+ discoveredViewerPort = data.viewerPort;+ return true;+ }+ if (data.viewerSkipped) return true;+ return false;+ } catch {+ return false;+ }} catch {return false;}@@ -1092,6 +1130,9 @@ async function runStatus() {apiFetch<any>(base, "config/flags"),]);+ if (typeof healthRes?.viewerPort === "number") {+ discoveredViewerPort = healthRes.viewerPort;+ }const h = healthRes?.health;const status = healthRes?.status || "unknown";const version = healthRes?.version || "?";@@ -1251,6 +1292,7 @@ function buildDoctorEffects(): DoctorEffects {iiiBinaryVersion: (binPath: string) => iiiBinVersion(binPath),viewerReachable: async (timeoutMs = 2000) => {try {+ await discoverViewerPort();const res = await fetch(getViewerUrl(), {signal: AbortSignal.timeout(timeoutMs),});diff --git a/src/triggers/api.ts b/src/triggers/api.tsindex 083c2159..66eaadc2 100644--- a/src/triggers/api.ts+++ b/src/triggers/api.ts@@ -9,6 +9,7 @@ import type { ResilientProvider } from "../providers/resilient.js";import { VERSION } from "../version.js";import { timingSafeCompare } from "../auth.js";import { renderViewerDocument } from "../viewer/document.js";+import { getBoundViewerPort, getViewerSkipped } from "../viewer/server.js";import { MAX_FILES_UPPER_BOUND } from "../functions/replay.js";import {isGraphExtractionEnabled,@@ -143,7 +144,7 @@ export function registerApiTriggers(sdk.registerFunction("api::liveness",async (): Promise<Response> => ({status_code: 200,- body: { status: "ok", service: "agentmemory" },+ body: { status: "ok", service: "agentmemory", viewerPort: getBoundViewerPort(), viewerSkipped: getViewerSkipped() },}),);sdk.registerTrigger({@@ -244,6 +245,8 @@ export function registerApiTriggers(health: health || null,functionMetrics,circuitBreaker,+ viewerPort: getBoundViewerPort(),+ viewerSkipped: getViewerSkipped(),},};},diff --git a/src/viewer/server.ts b/src/viewer/server.tsindex bd8e3c63..71598690 100644--- a/src/viewer/server.ts+++ b/src/viewer/server.ts@@ -131,6 +131,16 @@ function readBody(req: IncomingMessage): Promise<string> {const MAX_VIEWER_PORT_RETRIES = 10;+let boundViewerPort: number | null = null;+let viewerSkipped = false;++export function getBoundViewerPort(): number | null {+ return boundViewerPort;+}+export function getViewerSkipped(): boolean {+ return viewerSkipped;+}+export function startViewerServer(port: number,_kv: unknown,@@ -138,6 +148,10 @@ export function startViewerServer(secret?: string,restPort?: number,): Server {+ // Reset exported runtime state for each start attempt.+ boundViewerPort = null;+ viewerSkipped = false;+const resolvedRestPort = restPort ?? port - 2;const requestedPort = port;// Computed lazily on first request — `port` may be 0 here (OS-assigned)@@ -227,6 +241,12 @@ export function startViewerServer(};server.on("listening", () => {+ const addr = server.address();+ boundViewerPort =+ addr && typeof addr === "object" && "port" in addr+ ? addr.port+ : currentPort;+ viewerSkipped = false;if (currentPort === requestedPort) {console.log(`[agentmemory] Viewer: http://localhost:${currentPort}`);} else {@@ -244,10 +264,14 @@ export function startViewerServer(return;}if (err.code === "EADDRINUSE") {+ boundViewerPort = null;+ viewerSkipped = true;console.warn(`[agentmemory] Viewer ports ${requestedPort}-${requestedPort + MAX_VIEWER_PORT_RETRIES} all in use, skipping viewer.`,);} else {+ boundViewerPort = null;+ viewerSkipped = true;console.error(`[agentmemory] Viewer error:`, err.message);}});