@elizaos/agent 2.0.0-alpha.98 → 2.0.0-beta.2

package/packages/agent/src/api/diagnostics-routes.d.ts

@@ -1,8 +1,9 @@
 import type http from "node:http";
-import type { RouteHelpers, RouteRequestMeta } from "./route-helpers";
+import type { ReadJsonBodyOptions, RouteHelpers, RouteRequestMeta } from "@elizaos/core";
 interface LogEntryLike {
     timestamp: number;
     level: string;
+    message?: string;
     source: string;
     tags: string[];
 }
@@ -20,14 +21,26 @@ interface AuditEntryLike {
     metadata?: Record<string, string | number | boolean | null>;
 }
 type DiagnosticsSseInit = (res: http.ServerResponse) => void;
-type DiagnosticsSseWriteJson = (res: http.ServerResponse, payload: object, event?: string) => void;
+type DiagnosticsSseWriteJson = (res: http.ServerResponse, payload: unknown, event?: string) => void;
 export interface DiagnosticsRouteContext extends RouteRequestMeta, Pick<RouteHelpers, "json"> {
     url: URL;
     logBuffer: LogEntryLike[];
+    /** Drop all entries from the in-memory log buffer. Returns count cleared. */
+    clearLogBuffer?: () => number;
+    /** Read JSON body for the export endpoint. */
+    readJsonBody?: <T extends object>(req: http.IncomingMessage, res: http.ServerResponse, options?: ReadJsonBodyOptions) => Promise<T | null>;
+    error?: (res: http.ServerResponse, message: string, status?: number) => void;
     eventBuffer: StreamEventEnvelopeLike[];
     relayPort?: number;
     checkRelayReachable?: (relayPort: number) => Promise<boolean>;
     resolveExtensionPath?: () => string | null;
+    resolveExtensionArtifacts?: () => {
+        chromeBuildPath?: string | null;
+        chromePackagePath?: string | null;
+        safariWebExtensionPath?: string | null;
+        safariAppPath?: string | null;
+        safariPackagePath?: string | null;
+    };
     initSse?: DiagnosticsSseInit;
     writeSseJson?: DiagnosticsSseWriteJson;
     auditEventTypes: readonly string[];

package/packages/agent/src/api/diagnostics-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/diagnostics-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,cAAc;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CAC7D;AAED,KAAK,kBAAkB,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,CAAC;AAC7D,KAAK,uBAAuB,GAAG,CAC7B,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,KACX,IAAI,CAAC;AAEV,MAAM,WAAW,uBACf,SAAQ,gBAAgB,EACtB,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IAC5B,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC3C,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,gBAAgB,EAAE,MAAM,MAAM,CAAC;IAC/B,cAAc,EAAE,CAAC,KAAK,EAAE;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,KAAK,cAAc,EAAE,CAAC;IACvB,kBAAkB,EAAE,CAClB,UAAU,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,KACxC,MAAM,IAAI,CAAC;CACjB;AA2GD,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,OAAO,CAAC,CA+NlB"}
+{"version":3,"file":"diagnostics-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/diagnostics-routes.ts"],"names":[],"mappings":"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"}

package/packages/agent/src/api/diagnostics-routes.js

@@ -1,4 +1,4 @@
-import { parseClampedInteger } from "../utils/number-parsing";
+import { parseClampedInteger } from "../utils/number-parsing.js";
 async function defaultCheckRelayReachable(relayPort) {
     try {
         const response = await fetch(`http://127.0.0.1:${relayPort}/`, {
@@ -14,6 +14,9 @@ async function defaultCheckRelayReachable(relayPort) {
 function defaultResolveExtensionPath() {
     return null;
 }
+function defaultResolveExtensionArtifacts() {
+    return {};
+}
 function isAutonomyEvent(event) {
     return event.type === "agent_event" || event.type === "heartbeat_event";
 }
@@ -65,6 +68,45 @@ function isTruthyQueryParam(value) {
         normalized === "yes" ||
         normalized === "on");
 }
+function applyLogFilter(buffer, filter) {
+    let entries = buffer;
+    const { source, level, tag, sinceMs } = filter;
+    if (source) {
+        entries = entries.filter((entry) => entry.source === source);
+    }
+    if (level) {
+        entries = entries.filter((entry) => entry.level === level);
+    }
+    if (tag) {
+        entries = entries.filter((entry) => entry.tags.includes(tag));
+    }
+    if (sinceMs !== undefined) {
+        entries = entries.filter((entry) => entry.timestamp >= sinceMs);
+    }
+    return entries.slice();
+}
+function csvEscape(value) {
+    if (/[",\n\r]/.test(value)) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+function logsToCsv(entries) {
+    const header = "timestamp,level,source,tags,message";
+    const lines = entries.map((entry) => {
+        const message = typeof entry.message === "string" ? entry.message : "";
+        return [
+            new Date(entry.timestamp).toISOString(),
+            entry.level,
+            entry.source,
+            entry.tags.join("|"),
+            message,
+        ]
+            .map((field) => csvEscape(String(field)))
+            .join(",");
+    });
+    return [header, ...lines].join("\n");
+}
 function matchesAuditFilter(entry, filters) {
     if (filters.type && entry.type !== filters.type)
         return false;
@@ -77,33 +119,109 @@ function matchesAuditFilter(entry, filters) {
     return true;
 }
 export async function handleDiagnosticsRoutes(ctx) {
-    const { req, res, method, pathname, url, logBuffer, eventBuffer, relayPort: relayPortOverride, checkRelayReachable, resolveExtensionPath, initSse, writeSseJson, auditEventTypes, auditSeverities, getAuditFeedSize, queryAuditFeed, subscribeAuditFeed, json, } = ctx;
+    const { req, res, method, pathname, url, logBuffer, eventBuffer, relayPort: relayPortOverride, checkRelayReachable, resolveExtensionPath, resolveExtensionArtifacts, initSse, writeSseJson, auditEventTypes, auditSeverities, getAuditFeedSize, queryAuditFeed, subscribeAuditFeed, json, } = ctx;
     if (method === "GET" && pathname === "/api/logs") {
-        let entries = logBuffer;
-        const sourceFilter = url.searchParams.get("source");
-        if (sourceFilter) {
-            entries = entries.filter((entry) => entry.source === sourceFilter);
-        }
-        const levelFilter = url.searchParams.get("level");
-        if (levelFilter) {
-            entries = entries.filter((entry) => entry.level === levelFilter);
-        }
-        const tagFilter = url.searchParams.get("tag");
-        if (tagFilter) {
-            entries = entries.filter((entry) => entry.tags.includes(tagFilter));
-        }
-        const sinceFilter = url.searchParams.get("since");
-        if (sinceFilter) {
-            const sinceTimestamp = Number(sinceFilter);
-            if (!Number.isNaN(sinceTimestamp)) {
-                entries = entries.filter((entry) => entry.timestamp >= sinceTimestamp);
-            }
+        const sinceRaw = url.searchParams.get("since");
+        let sinceMs;
+        if (sinceRaw) {
+            const numeric = Number(sinceRaw);
+            if (!Number.isNaN(numeric))
+                sinceMs = numeric;
         }
+        const entries = applyLogFilter(logBuffer, {
+            source: url.searchParams.get("source") ?? undefined,
+            level: url.searchParams.get("level") ?? undefined,
+            tag: url.searchParams.get("tag") ?? undefined,
+            sinceMs,
+        });
         const sources = [...new Set(logBuffer.map((entry) => entry.source))].sort();
         const tags = [...new Set(logBuffer.flatMap((entry) => entry.tags))].sort();
         json(res, { entries: entries.slice(-200), sources, tags });
         return true;
     }
+    if (method === "DELETE" && pathname === "/api/logs") {
+        const cleared = ctx.clearLogBuffer
+            ? ctx.clearLogBuffer()
+            : (() => {
+                const previous = logBuffer.length;
+                logBuffer.length = 0;
+                return previous;
+            })();
+        json(res, { cleared });
+        return true;
+    }
+    if (method === "POST" && pathname === "/api/logs/export") {
+        const errorFn = ctx.error;
+        if (!ctx.readJsonBody || !errorFn) {
+            json(res, { error: "Log export requires JSON body support" }, 500);
+            return true;
+        }
+        const body = await ctx.readJsonBody(req, res);
+        if (!body)
+            return true;
+        const formatRaw = typeof body.format === "string" ? body.format.trim().toLowerCase() : "";
+        if (formatRaw !== "json" && formatRaw !== "csv") {
+            errorFn(res, 'format must be "json" or "csv"', 400);
+            return true;
+        }
+        let sinceMs;
+        if (typeof body.since === "string" && body.since.trim()) {
+            const numeric = Number(body.since);
+            if (Number.isFinite(numeric)) {
+                sinceMs = numeric;
+            }
+            else {
+                const parsed = Date.parse(body.since);
+                if (Number.isFinite(parsed))
+                    sinceMs = parsed;
+            }
+        }
+        else if (typeof body.since === "number" && Number.isFinite(body.since)) {
+            sinceMs = body.since;
+        }
+        let tag;
+        if (Array.isArray(body.tags)) {
+            const first = body.tags.find((entry) => typeof entry === "string" && entry.trim().length > 0);
+            if (first)
+                tag = first.trim();
+        }
+        else if (typeof body.tags === "string" && body.tags.trim()) {
+            tag = body.tags.trim();
+        }
+        let entries = applyLogFilter(logBuffer, {
+            source: typeof body.source === "string" && body.source.trim()
+                ? body.source.trim()
+                : undefined,
+            level: typeof body.level === "string" && body.level.trim()
+                ? body.level.trim()
+                : undefined,
+            tag,
+            sinceMs,
+        });
+        if (typeof body.limit === "number" && Number.isFinite(body.limit)) {
+            const cap = Math.max(1, Math.min(10_000, Math.floor(body.limit)));
+            entries = entries.slice(-cap);
+        }
+        const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+        if (formatRaw === "json") {
+            const payload = JSON.stringify({ entries }, null, 2);
+            res.writeHead(200, {
+                "Content-Type": "application/json; charset=utf-8",
+                "Content-Disposition": `attachment; filename="logs-${stamp}.json"`,
+                "Content-Length": Buffer.byteLength(payload, "utf-8"),
+            });
+            res.end(payload);
+            return true;
+        }
+        const csv = logsToCsv(entries);
+        res.writeHead(200, {
+            "Content-Type": "text/csv; charset=utf-8",
+            "Content-Disposition": `attachment; filename="logs-${stamp}.csv"`,
+            "Content-Length": Buffer.byteLength(csv, "utf-8"),
+        });
+        res.end(csv);
+        return true;
+    }
     if (method === "GET" && pathname === "/api/agent/events") {
         const limit = parseClampedInteger(url.searchParams.get("limit"), {
             min: 1,
@@ -230,10 +348,16 @@ export async function handleDiagnosticsRoutes(ctx) {
         const relayPort = relayPortOverride ?? 18792;
         const relayReachable = await (checkRelayReachable ?? defaultCheckRelayReachable)(relayPort);
         const extensionPath = (resolveExtensionPath ?? defaultResolveExtensionPath)();
+        const extensionArtifacts = (resolveExtensionArtifacts ?? defaultResolveExtensionArtifacts)();
         json(res, {
             relayReachable,
             relayPort,
             extensionPath,
+            chromeBuildPath: extensionArtifacts.chromeBuildPath ?? null,
+            chromePackagePath: extensionArtifacts.chromePackagePath ?? null,
+            safariWebExtensionPath: extensionArtifacts.safariWebExtensionPath ?? null,
+            safariAppPath: extensionArtifacts.safariAppPath ?? null,
+            safariPackagePath: extensionArtifacts.safariPackagePath ?? null,
         });
         return true;
     }

package/packages/agent/src/api/documents-routes.d.ts

@@ -0,0 +1,9 @@
+import type { AgentRuntime, RouteRequestContext } from "@elizaos/core";
+import type { RouteHelpers } from "@elizaos/shared";
+export type DocumentRouteHelpers = RouteHelpers;
+export interface DocumentRouteContext extends RouteRequestContext {
+    url: URL;
+    runtime: AgentRuntime | null;
+}
+export declare function handleDocumentsRoutes(ctx: DocumentRouteContext): Promise<boolean>;
+//# sourceMappingURL=documents-routes.d.ts.map

package/packages/agent/src/api/documents-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/documents-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAEhD,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B;AAQD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,OAAO,CAAC,CAgBlB"}

package/packages/agent/src/api/documents-routes.js

@@ -0,0 +1,26 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+const DOCUMENTS_ROUTES_MODULE = "@elizaos/app-documents";
+export async function handleDocumentsRoutes(ctx) {
+    if (!ctx.pathname.startsWith("/api/documents"))
+        return false;
+    try {
+        const loaded = (await import(__rewriteRelativeImportExtension(
+        /* @vite-ignore */ DOCUMENTS_ROUTES_MODULE)));
+        if (typeof loaded.handleDocumentsRoutes !== "function") {
+            ctx.error(ctx.res, "Documents app routes are not available", 503);
+            return true;
+        }
+        return await loaded.handleDocumentsRoutes(ctx);
+    }
+    catch {
+        ctx.error(ctx.res, "Documents app routes are not available", 503);
+        return true;
+    }
+}

package/packages/agent/src/api/documents-service-loader.d.ts

@@ -0,0 +1,76 @@
+import type { AgentRuntime, Memory, UUID } from "@elizaos/core";
+export type DocumentVisibilityScope = "global" | "owner-private" | "user-private" | "agent-private";
+export type DocumentAddedByRole = "OWNER" | "ADMIN" | "USER" | "AGENT" | "RUNTIME";
+export type DocumentAddedFrom = "chat" | "upload" | "url" | "file" | "agent-autonomous" | "runtime-internal" | "lifeops" | "default-seed" | "character";
+export type DocumentSearchMode = "hybrid" | "vector" | "keyword";
+export interface DocumentsServiceLike {
+    addDocument(options: {
+        agentId?: UUID;
+        worldId: UUID;
+        roomId: UUID;
+        entityId: UUID;
+        clientDocumentId: UUID;
+        contentType: string;
+        originalFilename: string;
+        content: string;
+        metadata?: Record<string, unknown>;
+        scope?: DocumentVisibilityScope;
+        scopedToEntityId?: UUID;
+        addedBy?: UUID;
+        addedByRole?: DocumentAddedByRole;
+        addedFrom?: DocumentAddedFrom;
+    }): Promise<{
+        clientDocumentId: string;
+        storedDocumentMemoryId: UUID;
+        fragmentCount: number;
+    }>;
+    searchDocuments(message: Memory, scope?: {
+        roomId?: UUID;
+        worldId?: UUID;
+        entityId?: UUID;
+    }, searchMode?: DocumentSearchMode): Promise<Array<{
+        id: UUID;
+        content: {
+            text?: string;
+        };
+        similarity?: number;
+        metadata?: Record<string, unknown>;
+        worldId?: UUID;
+    }>>;
+    listDocuments?(message?: Memory, options?: Record<string, unknown>): Promise<Memory[]>;
+    getDocumentById?(documentId: UUID, message?: Memory): Promise<Memory | null>;
+    getMemories(params: {
+        tableName: string;
+        roomId?: UUID;
+        count?: number;
+        offset?: number;
+        end?: number;
+    }): Promise<Memory[]>;
+    countMemories(params: {
+        tableName: string;
+        roomId?: UUID;
+        unique?: boolean;
+    }): Promise<number>;
+    updateDocument(options: {
+        documentId: UUID;
+        content: string;
+        message?: Memory;
+    }): Promise<{
+        documentId: UUID;
+        fragmentCount: number;
+    }>;
+    deleteDocument?(documentId: UUID, message?: Memory): Promise<void>;
+    deleteMemory(memoryId: UUID): Promise<void>;
+}
+/** Alias kept for backwards-compatible plugin imports. */
+export type DocumentServiceLike = DocumentsServiceLike;
+export type DocumentsLoadFailReason = "timeout" | "runtime_unavailable" | "not_registered";
+export interface DocumentsServiceResult {
+    service: DocumentsServiceLike | null;
+    reason?: DocumentsLoadFailReason;
+}
+export declare function getDocumentsServiceTimeoutMs(): number;
+/** Alias kept for backwards-compatible plugin imports. */
+export declare const getDocumentsTimeoutMs: typeof getDocumentsServiceTimeoutMs;
+export declare function getDocumentsService(runtime: AgentRuntime | null): Promise<DocumentsServiceResult>;
+//# sourceMappingURL=documents-service-loader.d.ts.map

package/packages/agent/src/api/documents-service-loader.d.ts.map

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

package/packages/agent/src/api/{knowledge-service-loader.js → documents-service-loader.js}

@@ -1,7 +1,7 @@
 const DEFAULT_TIMEOUT_MS = 10_000;
 const MAX_TIMEOUT_MS = 60_000;
-export function getKnowledgeTimeoutMs() {
-    const envVal = process.env.KNOWLEDGE_SERVICE_TIMEOUT_MS;
+export function getDocumentsServiceTimeoutMs() {
+    const envVal = process.env.DOCUMENTS_SERVICE_TIMEOUT_MS;
     if (!envVal)
         return DEFAULT_TIMEOUT_MS;
     const parsed = Number.parseInt(envVal, 10);
@@ -9,21 +9,23 @@ export function getKnowledgeTimeoutMs() {
         return DEFAULT_TIMEOUT_MS;
     return Math.min(parsed, MAX_TIMEOUT_MS);
 }
-export async function getKnowledgeService(runtime) {
+/** Alias kept for backwards-compatible plugin imports. */
+export const getDocumentsTimeoutMs = getDocumentsServiceTimeoutMs;
+export async function getDocumentsService(runtime) {
     if (!runtime) {
         return { service: null, reason: "runtime_unavailable" };
     }
-    let service = runtime.getService("knowledge");
+    let service = runtime.getService("documents");
     if (service)
         return { service };
     try {
-        const servicePromise = runtime.getServiceLoadPromise("knowledge");
-        const timeoutMs = getKnowledgeTimeoutMs();
+        const servicePromise = runtime.getServiceLoadPromise("documents");
+        const timeoutMs = getDocumentsServiceTimeoutMs();
         const timeout = new Promise((_resolve, reject) => {
-            setTimeout(() => reject(new Error("knowledge service timeout")), timeoutMs);
+            setTimeout(() => reject(new Error("documents service timeout")), timeoutMs);
         });
         await Promise.race([servicePromise, timeout]);
-        service = runtime.getService("knowledge");
+        service = runtime.getService("documents");
         if (service)
             return { service };
         return { service: null, reason: "not_registered" };

package/packages/agent/src/api/health-routes.d.ts

@@ -0,0 +1,46 @@
+import type http from "node:http";
+import type { AgentRuntime } from "@elizaos/core";
+import type { ElizaConfig } from "../config/config.ts";
+import type { ConnectorHealthMonitor } from "./connector-health.ts";
+interface PluginEntryLike {
+    enabled: boolean;
+    configured: boolean;
+    isActive?: boolean;
+    loadError?: string | null;
+}
+interface AgentStartupDiagnostics {
+    phase: string;
+    attempt: number;
+    lastError?: string;
+    lastErrorAt?: number;
+    nextRetryAt?: number;
+}
+export interface HealthRouteState {
+    runtime: AgentRuntime | null;
+    config: ElizaConfig;
+    agentState: string;
+    agentName: string;
+    model: string | undefined;
+    startedAt: number | undefined;
+    startup: AgentStartupDiagnostics;
+    plugins: PluginEntryLike[];
+    pendingRestartReasons: string[];
+    connectorHealthMonitor: ConnectorHealthMonitor | null;
+}
+export interface HealthRouteContext {
+    req: http.IncomingMessage;
+    res: http.ServerResponse;
+    method: string;
+    pathname: string;
+    url: URL;
+    state: HealthRouteState;
+    json: (res: http.ServerResponse, data: unknown, status?: number) => void;
+    error: (res: http.ServerResponse, message: string, status?: number) => void;
+}
+/**
+ * Handle health / status / runtime introspection routes.
+ * Returns `true` if the request was handled.
+ */
+export declare function handleHealthRoutes(ctx: HealthRouteContext): Promise<boolean>;
+export {};
+//# sourceMappingURL=health-routes.d.ts.map

package/packages/agent/src/api/health-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/health-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAMlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAMpE,UAAU,eAAe;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,UAAU,uBAAuB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,uBAAuB,CAAC;IACjC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,sBAAsB,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC;IAC1B,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7E;AAmUD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,OAAO,CAAC,CAiOlB"}