@agent-relay/dashboard-server 2.0.82 → 2.0.84

package/dist/lib/process-metrics.js

@@ -0,0 +1,252 @@
+import fs from 'fs';
+import { execSync } from 'child_process';
+/**
+ * Build process-tree metrics helpers with internal sampling caches.
+ */
+export function createProcessMetrics() {
+    const isCloudMetricsEnabled = process.env.RELAY_CLOUD_ENABLED === 'true';
+    const isLinux = process.platform === 'linux';
+    const clockTicksPerSecond = (() => {
+        try {
+            const output = execSync('getconf CLK_TCK', { encoding: 'utf8' });
+            const ticks = parseInt(output.trim(), 10);
+            return Number.isFinite(ticks) && ticks > 0 ? ticks : 100;
+        }
+        catch {
+            return 100;
+        }
+    })();
+    const procTreeCpuSamples = new Map();
+    const psTreeSnapshotCache = {
+        timestampMs: 0,
+        processByPid: new Map(),
+        childrenByPid: new Map(),
+    };
+    const psTreeCacheTtlMs = 1000;
+    const getProcStatusRssBytes = (pid) => {
+        try {
+            const status = fs.readFileSync(`/proc/${pid}/status`, 'utf8');
+            const rssMatch = status.match(/VmRSS:\s+(\d+)\s+kB/);
+            if (rssMatch) {
+                return parseInt(rssMatch[1], 10) * 1024;
+            }
+        }
+        catch {
+            return 0;
+        }
+        return 0;
+    };
+    const getProcStatJiffies = (pid) => {
+        try {
+            const statText = fs.readFileSync(`/proc/${pid}/stat`, 'utf8');
+            const closeParen = statText.lastIndexOf(')');
+            if (closeParen < 0)
+                return 0;
+            const parts = statText.slice(closeParen + 1).trim().split(/\s+/);
+            const utime = parseInt(parts[11] ?? '0', 10);
+            const stime = parseInt(parts[12] ?? '0', 10);
+            const utimeValue = Number.isFinite(utime) ? utime : 0;
+            const stimeValue = Number.isFinite(stime) ? stime : 0;
+            return utimeValue + stimeValue;
+        }
+        catch {
+            return 0;
+        }
+    };
+    const getProcTreePids = (rootPid) => {
+        const toProcess = [rootPid];
+        const seen = new Set();
+        const result = [];
+        while (toProcess.length > 0) {
+            const pid = toProcess.shift();
+            if (pid === undefined || seen.has(pid))
+                continue;
+            const procPath = `/proc/${pid}`;
+            if (!fs.existsSync(procPath))
+                continue;
+            seen.add(pid);
+            result.push(pid);
+            const childrenPath = `/proc/${pid}/task/${pid}/children`;
+            if (fs.existsSync(childrenPath)) {
+                const childrenText = fs.readFileSync(childrenPath, 'utf8').trim();
+                if (childrenText) {
+                    for (const child of childrenText.split(/\s+/)) {
+                        const childPid = parseInt(child, 10);
+                        if (Number.isFinite(childPid) && childPid > 0) {
+                            toProcess.push(childPid);
+                        }
+                    }
+                }
+            }
+        }
+        return result;
+    };
+    const getPsTreeSnapshot = () => {
+        const nowMs = Date.now();
+        if (nowMs - psTreeSnapshotCache.timestampMs <= psTreeCacheTtlMs) {
+            return {
+                processByPid: psTreeSnapshotCache.processByPid,
+                childrenByPid: psTreeSnapshotCache.childrenByPid,
+            };
+        }
+        try {
+            const output = execSync('ps -axo pid=,ppid=,rss=,pcpu=', {
+                encoding: 'utf8',
+                timeout: 3000,
+            }).trim();
+            if (!output) {
+                return {
+                    processByPid: new Map(),
+                    childrenByPid: new Map(),
+                };
+            }
+            const processByPid = new Map();
+            const childrenByPid = new Map();
+            for (const line of output.split('\n')) {
+                const parts = line.trim().split(/\s+/);
+                if (parts.length < 4)
+                    continue;
+                const pid = parseInt(parts[0], 10);
+                const ppid = parseInt(parts[1], 10);
+                const rssBytes = parseInt(parts[2], 10) * 1024;
+                const cpuPercent = parseFloat(parts[3]);
+                if (!Number.isFinite(pid) || pid <= 0)
+                    continue;
+                processByPid.set(pid, {
+                    ppid: Number.isFinite(ppid) ? ppid : 0,
+                    rssBytes: Number.isFinite(rssBytes) ? rssBytes : 0,
+                    cpuPercent: Number.isFinite(cpuPercent) ? cpuPercent : 0,
+                });
+                const parentPid = Number.isFinite(ppid) ? ppid : 0;
+                const children = childrenByPid.get(parentPid) || [];
+                children.push(pid);
+                childrenByPid.set(parentPid, children);
+            }
+            psTreeSnapshotCache.timestampMs = nowMs;
+            psTreeSnapshotCache.processByPid = processByPid;
+            psTreeSnapshotCache.childrenByPid = childrenByPid;
+            return { processByPid, childrenByPid };
+        }
+        catch {
+            return {
+                processByPid: new Map(),
+                childrenByPid: new Map(),
+            };
+        }
+    };
+    const getPsTreeUsage = (rootPid) => {
+        try {
+            const { processByPid, childrenByPid } = getPsTreeSnapshot();
+            if (processByPid.size === 0) {
+                return { rssBytes: 0, cpuPercent: 0 };
+            }
+            const queue = [rootPid];
+            const seen = new Set();
+            let totalRssBytes = 0;
+            let totalCpuPercent = 0;
+            while (queue.length > 0) {
+                const pid = queue.shift();
+                if (pid === undefined || seen.has(pid))
+                    continue;
+                const node = processByPid.get(pid);
+                if (!node)
+                    continue;
+                seen.add(pid);
+                totalRssBytes += node.rssBytes;
+                totalCpuPercent += node.cpuPercent;
+                const children = childrenByPid.get(pid);
+                if (children) {
+                    queue.push(...children);
+                }
+            }
+            return { rssBytes: totalRssBytes, cpuPercent: totalCpuPercent };
+        }
+        catch {
+            return { rssBytes: 0, cpuPercent: 0 };
+        }
+    };
+    const getLegacyProcUsage = (rootPid) => {
+        let rssBytes = 0;
+        let cpuPercent = 0;
+        try {
+            const statusPath = `/proc/${rootPid}/status`;
+            if (fs.existsSync(statusPath)) {
+                const status = fs.readFileSync(statusPath, 'utf8');
+                const rssMatch = status.match(/VmRSS:\s+(\d+)\s+kB/);
+                if (rssMatch) {
+                    rssBytes = parseInt(rssMatch[1], 10) * 1024;
+                }
+            }
+            else if (process.platform === 'darwin') {
+                const psOutput = execSync(`ps -o rss=,pcpu= -p ${rootPid}`, { encoding: 'utf8', timeout: 3000 }).trim();
+                if (psOutput) {
+                    const [rssStr, cpuStr] = psOutput.split(/\s+/);
+                    if (rssStr)
+                        rssBytes = parseInt(rssStr, 10) * 1024;
+                    if (cpuStr)
+                        cpuPercent = parseFloat(cpuStr);
+                }
+            }
+        }
+        catch {
+            // Process may have exited or command failed.
+        }
+        return {
+            rssBytes,
+            cpuPercent,
+        };
+    };
+    const getCloudProcTreeUsage = (rootPid) => {
+        if (!Number.isFinite(rootPid) || rootPid <= 0) {
+            return { rssBytes: 0, cpuPercent: 0 };
+        }
+        try {
+            const statusPath = `/proc/${rootPid}/status`;
+            if (!fs.existsSync(statusPath)) {
+                procTreeCpuSamples.delete(rootPid);
+                return getPsTreeUsage(rootPid);
+            }
+            const pids = getProcTreePids(rootPid);
+            if (pids.length === 0) {
+                procTreeCpuSamples.delete(rootPid);
+                return { rssBytes: 0, cpuPercent: 0 };
+            }
+            let totalRssBytes = 0;
+            let totalJiffies = 0;
+            for (const pid of pids) {
+                totalRssBytes += getProcStatusRssBytes(pid);
+                totalJiffies += getProcStatJiffies(pid);
+            }
+            const nowMs = Date.now();
+            const previous = procTreeCpuSamples.get(rootPid);
+            procTreeCpuSamples.set(rootPid, { timestampMs: nowMs, totalJiffies });
+            if (!previous || nowMs <= previous.timestampMs) {
+                return { rssBytes: totalRssBytes, cpuPercent: 0 };
+            }
+            const elapsedMs = nowMs - previous.timestampMs;
+            const elapsedJiffies = totalJiffies - previous.totalJiffies;
+            if (elapsedJiffies <= 0 || elapsedMs <= 0) {
+                return { rssBytes: totalRssBytes, cpuPercent: 0 };
+            }
+            const cpuPercent = Math.max(0, (elapsedJiffies / clockTicksPerSecond / (elapsedMs / 1000)) * 100);
+            return {
+                rssBytes: totalRssBytes,
+                cpuPercent,
+            };
+        }
+        catch {
+            return { rssBytes: 0, cpuPercent: 0 };
+        }
+    };
+    const getProcTreeUsage = (rootPid) => {
+        if (!isCloudMetricsEnabled) {
+            return getLegacyProcUsage(rootPid);
+        }
+        if (!isLinux) {
+            return getPsTreeUsage(rootPid);
+        }
+        return getCloudProcTreeUsage(rootPid);
+    };
+    return { getProcTreeUsage };
+}
+//# sourceMappingURL=process-metrics.js.map

package/dist/lib/process-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-metrics.js","sourceRoot":"","sources":["../../src/lib/process-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAazC;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM,CAAC;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC7C,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAyD,CAAC;IAC5F,MAAM,mBAAmB,GAAG;QAC1B,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,IAAI,GAAG,EAAuB;QAC5C,aAAa,EAAE,IAAI,GAAG,EAAoB;KAC3C,CAAC;IACF,MAAM,gBAAgB,GAAG,IAAI,CAAC;IAE9B,MAAM,qBAAqB,GAAG,CAAC,GAAW,EAAU,EAAE;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACrD,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;YAC1C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IAEF,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAU,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9D,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC7C,IAAI,UAAU,GAAG,CAAC;gBAAE,OAAO,CAAC,CAAC;YAE7B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;YAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAEtD,OAAO,UAAU,GAAG,UAAU,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,OAAe,EAAY,EAAE;QACpD,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAEjD,MAAM,QAAQ,GAAG,SAAS,GAAG,EAAE,CAAC;YAChC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAEvC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEjB,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;YACzD,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChC,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;gBAClE,IAAI,YAAY,EAAE,CAAC;oBACjB,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBACrC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;4BAC9C,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;wBAC3B,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,iBAAiB,GAAG,GAAG,EAAE;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,KAAK,GAAG,mBAAmB,CAAC,WAAW,IAAI,gBAAgB,EAAE,CAAC;YAChE,OAAO;gBACL,YAAY,EAAE,mBAAmB,CAAC,YAAY;gBAC9C,aAAa,EAAE,mBAAmB,CAAC,aAAa;aACjD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,+BAA+B,EAAE;gBACvD,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,YAAY,EAAE,IAAI,GAAG,EAAuB;oBAC5C,aAAa,EAAE,IAAI,GAAG,EAAoB;iBAC3C,CAAC;YACJ,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAC;YACpD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAoB,CAAC;YAElD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACvC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,SAAS;gBAE/B,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;gBAC/C,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAExC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;oBAAE,SAAS;gBAEhD,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE;oBACpB,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBACtC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;oBAClD,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;iBACzD,CAAC,CAAC;gBAEH,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBACpD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnB,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACzC,CAAC;YAED,mBAAmB,CAAC,WAAW,GAAG,KAAK,CAAC;YACxC,mBAAmB,CAAC,YAAY,GAAG,YAAY,CAAC;YAChD,mBAAmB,CAAC,aAAa,GAAG,aAAa,CAAC;YAElD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,YAAY,EAAE,IAAI,GAAG,EAAuB;gBAC5C,aAAa,EAAE,IAAI,GAAG,EAAoB;aAC3C,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,CAAC,OAAe,EAAgB,EAAE;QACvD,IAAI,CAAC;YACH,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,iBAAiB,EAAE,CAAC;YAC5D,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;YACxC,CAAC;YAED,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAC/B,IAAI,aAAa,GAAG,CAAC,CAAC;YACtB,IAAI,eAAe,GAAG,CAAC,CAAC;YAExB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC1B,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAEjD,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACnC,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAEd,aAAa,IAAI,IAAI,CAAC,QAAQ,CAAC;gBAC/B,eAAe,IAAI,IAAI,CAAC,UAAU,CAAC;gBAEnC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACxC,IAAI,QAAQ,EAAE,CAAC;oBACb,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACxC,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,kBAAkB,GAAG,CAAC,OAAe,EAAgB,EAAE;QAC3D,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,SAAS,OAAO,SAAS,CAAC;YAC7C,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBACrD,IAAI,QAAQ,EAAE,CAAC;oBACb,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;gBAC9C,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,uBAAuB,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACxG,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAC/C,IAAI,MAAM;wBAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;oBACnD,IAAI,MAAM;wBAAE,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;QAED,OAAO;YACL,QAAQ;YACR,UAAU;SACX,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,qBAAqB,GAAG,CAAC,OAAe,EAAgB,EAAE;QAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YAC9C,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACxC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,SAAS,OAAO,SAAS,CAAC;YAC7C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACnC,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;YAED,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACnC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;YACxC,CAAC;YAED,IAAI,aAAa,GAAG,CAAC,CAAC;YACtB,IAAI,YAAY,GAAG,CAAC,CAAC;YAErB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,aAAa,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAC;gBAC5C,YAAY,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAC1C,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACjD,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YAEtE,IAAI,CAAC,QAAQ,IAAI,KAAK,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC/C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;YACpD,CAAC;YAED,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC;YAC/C,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;YAC5D,IAAI,cAAc,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBAC1C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;YACpD,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,cAAc,GAAG,mBAAmB,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YAElG,OAAO;gBACL,QAAQ,EAAE,aAAa;gBACvB,UAAU;aACX,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACxC,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAgB,EAAE;QACzD,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC3B,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC;IAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC9B,CAAC"}

package/dist/lib/proxy-route-table.d.ts

@@ -0,0 +1,16 @@
+export type DashboardProxyUpstream = 'broker' | 'cloud';
+export interface DashboardProxyRoute {
+    key: 'brokerHealth' | 'cloudMetrics' | 'cloudNeedsAttention' | 'brokerSpawned';
+    method: 'GET';
+    routePath: string;
+    upstream: DashboardProxyUpstream;
+    upstreamPath: string;
+}
+export declare const DASHBOARD_PROXY_ROUTE_TABLE: readonly DashboardProxyRoute[];
+export declare function getDashboardProxyRoute(key: DashboardProxyRoute['key']): DashboardProxyRoute;
+export declare function resolveUpstreamBaseUrl(upstream: DashboardProxyUpstream, env?: NodeJS.ProcessEnv): string;
+export declare function buildDashboardProxyUrl(route: DashboardProxyRoute, opts?: {
+    env?: NodeJS.ProcessEnv;
+    query?: URLSearchParams | Record<string, string | number | boolean | undefined>;
+}): string;
+//# sourceMappingURL=proxy-route-table.d.ts.map

package/dist/lib/proxy-route-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-route-table.d.ts","sourceRoot":"","sources":["../../src/lib/proxy-route-table.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,cAAc,GAAG,cAAc,GAAG,qBAAqB,GAAG,eAAe,CAAC;IAC/E,MAAM,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,2BAA2B,EAAE,SAAS,mBAAmB,EA6BpE,CAAC;AAQH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG,mBAAmB,CAM3F;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,sBAAsB,EAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAgBR;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,EAC1B,IAAI,GAAE;IACJ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;CAC5E,GACL,MAAM,CAmBR"}

package/dist/lib/proxy-route-table.js

@@ -0,0 +1,73 @@
+export const DASHBOARD_PROXY_ROUTE_TABLE = Object.freeze([
+    {
+        key: 'brokerHealth',
+        method: 'GET',
+        routePath: '/health',
+        upstream: 'broker',
+        upstreamPath: '/health',
+    },
+    {
+        key: 'cloudMetrics',
+        method: 'GET',
+        routePath: '/api/metrics',
+        upstream: 'cloud',
+        upstreamPath: '/api/metrics',
+    },
+    {
+        key: 'cloudNeedsAttention',
+        method: 'GET',
+        routePath: '/api/agents/needs-attention',
+        upstream: 'cloud',
+        upstreamPath: '/api/agents/needs-attention',
+    },
+    {
+        key: 'brokerSpawned',
+        method: 'GET',
+        routePath: '/api/spawned',
+        upstream: 'broker',
+        upstreamPath: '/api/spawned',
+    },
+]);
+const ROUTE_BY_KEY = new Map(DASHBOARD_PROXY_ROUTE_TABLE.map((route) => [route.key, route]));
+function normalizeBaseUrl(raw) {
+    return raw.endsWith('/') ? raw : `${raw}/`;
+}
+export function getDashboardProxyRoute(key) {
+    const route = ROUTE_BY_KEY.get(key);
+    if (!route) {
+        throw new Error(`Unknown dashboard proxy route key: ${key}`);
+    }
+    return route;
+}
+export function resolveUpstreamBaseUrl(upstream, env = process.env) {
+    if (upstream === 'cloud') {
+        const baseUrl = env.DASHBOARD_CLOUD_URL ?? env.CLOUD_API_URL;
+        if (!baseUrl) {
+            throw new Error('Cloud upstream URL is not configured (set DASHBOARD_CLOUD_URL or CLOUD_API_URL)');
+        }
+        return baseUrl;
+    }
+    const brokerBaseUrl = env.DASHBOARD_BROKER_URL ??
+        env.BROKER_API_URL ??
+        env.RELAY_URL ??
+        env.RELAY_API_URL ??
+        'http://127.0.0.1:3889';
+    return brokerBaseUrl;
+}
+export function buildDashboardProxyUrl(route, opts = {}) {
+    const env = opts.env ?? process.env;
+    const baseUrl = resolveUpstreamBaseUrl(route.upstream, env);
+    const target = new URL(route.upstreamPath.replace(/^\//, ''), normalizeBaseUrl(baseUrl));
+    if (opts.query) {
+        const query = opts.query instanceof URLSearchParams
+            ? opts.query
+            : new URLSearchParams(Object.entries(opts.query)
+                .filter(([, value]) => value !== undefined)
+                .map(([key, value]) => [key, String(value)]));
+        for (const [key, value] of query.entries()) {
+            target.searchParams.set(key, value);
+        }
+    }
+    return target.toString();
+}
+//# sourceMappingURL=proxy-route-table.js.map

package/dist/lib/proxy-route-table.js.map

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

package/dist/lib/send-strategy.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Send strategy pattern for Relaycast message delivery.
+ *
+ * Extracts the dual send paths from proxy-server.ts into a clean
+ * strategy pattern:
+ *
+ * - BrokerSendStrategy: HTTP POST to broker `/api/send`
+ * - DirectSendStrategy: Calls sendMessage() from relaycast-provider.ts
+ */
+import type { RelaycastConfig } from '../relaycast-provider-types.js';
+export interface SendRequest {
+    to: string;
+    message: string;
+    from: string;
+}
+export interface SendResult {
+    success: true;
+    messageId: string;
+}
+export interface SendError {
+    success: false;
+    status: number;
+    error: string;
+}
+export type SendOutcome = SendResult | SendError;
+export interface SendStrategy {
+    send(request: SendRequest): Promise<SendOutcome>;
+}
+/**
+ * Sends messages via the broker HTTP API (`POST /api/send`).
+ * Used when running in proxy mode with a broker URL configured.
+ */
+export declare class BrokerSendStrategy implements SendStrategy {
+    private brokerUrl;
+    constructor(brokerUrl: string);
+    send(request: SendRequest): Promise<SendOutcome>;
+}
+/**
+ * Sends messages directly via the Relaycast SDK.
+ * Used in standalone mode when no broker is configured.
+ */
+export declare class DirectSendStrategy implements SendStrategy {
+    private config;
+    private dataDir;
+    constructor(config: RelaycastConfig, dataDir: string);
+    send(request: SendRequest): Promise<SendOutcome>;
+}
+export interface CreateSendStrategyOptions {
+    brokerProxyEnabled: boolean;
+    brokerUrl?: string;
+    relaycastConfig?: RelaycastConfig | null;
+    dataDir: string;
+}
+/**
+ * Create the appropriate send strategy based on server configuration.
+ *
+ * Returns `null` when neither a broker URL nor valid Relaycast config is
+ * available (the caller should handle this as a 503).
+ */
+export declare function createSendStrategy(opts: CreateSendStrategyOptions): SendStrategy | null;
+//# sourceMappingURL=send-strategy.d.ts.map

package/dist/lib/send-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-strategy.d.ts","sourceRoot":"","sources":["../../src/lib/send-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAkBtE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClD;AAMD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACzC,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAE/B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;CAiDvD;AAMD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IAEnD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;gBADP,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM;IAGnB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;CAoBvD;AAMD,MAAM,WAAW,yBAAyB;IACxC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,YAAY,GAAG,IAAI,CAUvF"}

package/dist/lib/send-strategy.js

@@ -0,0 +1,134 @@
+/**
+ * Send strategy pattern for Relaycast message delivery.
+ *
+ * Extracts the dual send paths from proxy-server.ts into a clean
+ * strategy pattern:
+ *
+ * - BrokerSendStrategy: HTTP POST to broker `/api/send`
+ * - DirectSendStrategy: Calls sendMessage() from relaycast-provider.ts
+ */
+import { extractMessageId } from './message-id.js';
+import { sendMessage } from '../relaycast-provider.js';
+function parseJsonRecord(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // Ignore parse errors and let callers fallback to plain text handling.
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// BrokerSendStrategy
+// ---------------------------------------------------------------------------
+/**
+ * Sends messages via the broker HTTP API (`POST /api/send`).
+ * Used when running in proxy mode with a broker URL configured.
+ */
+export class BrokerSendStrategy {
+    brokerUrl;
+    constructor(brokerUrl) {
+        this.brokerUrl = brokerUrl;
+    }
+    async send(request) {
+        try {
+            const upstream = await fetch(`${this.brokerUrl}/api/send`, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify({
+                    to: request.to,
+                    message: request.message,
+                    from: request.from,
+                }),
+            });
+            const bodyText = await upstream.text();
+            const payload = bodyText ? parseJsonRecord(bodyText) : null;
+            if (!upstream.ok) {
+                const upstreamError = payload?.error;
+                return {
+                    success: false,
+                    status: upstream.status,
+                    error: typeof upstreamError === 'string' && upstreamError.trim()
+                        ? upstreamError
+                        : (bodyText.trim() || `Broker send failed with status ${upstream.status}`),
+                };
+            }
+            const brokerMessageId = payload ? extractMessageId(payload) : null;
+            if (!brokerMessageId) {
+                return {
+                    success: false,
+                    status: 502,
+                    error: 'Broker send succeeded but did not return event_id',
+                };
+            }
+            return {
+                success: true,
+                messageId: brokerMessageId,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                status: 502,
+                error: err.message || 'Failed to send message through broker',
+            };
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// DirectSendStrategy
+// ---------------------------------------------------------------------------
+/**
+ * Sends messages directly via the Relaycast SDK.
+ * Used in standalone mode when no broker is configured.
+ */
+export class DirectSendStrategy {
+    config;
+    dataDir;
+    constructor(config, dataDir) {
+        this.config = config;
+        this.dataDir = dataDir;
+    }
+    async send(request) {
+        try {
+            const result = await sendMessage(this.config, {
+                to: request.to,
+                message: request.message,
+                from: request.from,
+                dataDir: this.dataDir,
+            });
+            return {
+                success: true,
+                messageId: result.messageId,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                status: 502,
+                error: err.message || 'Failed to send message',
+            };
+        }
+    }
+}
+/**
+ * Create the appropriate send strategy based on server configuration.
+ *
+ * Returns `null` when neither a broker URL nor valid Relaycast config is
+ * available (the caller should handle this as a 503).
+ */
+export function createSendStrategy(opts) {
+    if (opts.brokerProxyEnabled && opts.brokerUrl) {
+        return new BrokerSendStrategy(opts.brokerUrl);
+    }
+    if (opts.relaycastConfig) {
+        return new DirectSendStrategy(opts.relaycastConfig, opts.dataDir);
+    }
+    return null;
+}
+//# sourceMappingURL=send-strategy.js.map

package/dist/lib/send-strategy.js.map

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