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

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

@@ -0,0 +1,59 @@
+import type http from "node:http";
+import type { ReadJsonBodyOptions, RouteHelpers, RouteRequestMeta } from "@elizaos/core";
+interface LogEntryLike {
+    timestamp: number;
+    level: string;
+    message?: string;
+    source: string;
+    tags: string[];
+}
+interface StreamEventEnvelopeLike {
+    type: string;
+    eventId: string;
+    runId?: string;
+    seq?: number;
+}
+interface AuditEntryLike {
+    timestamp: string;
+    type: string;
+    summary: string;
+    severity: string;
+    metadata?: Record<string, string | number | boolean | null>;
+}
+type DiagnosticsSseInit = (res: http.ServerResponse) => 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[];
+    auditSeverities: readonly string[];
+    getAuditFeedSize: () => number;
+    queryAuditFeed: (query: {
+        type?: string;
+        severity?: string;
+        sinceMs?: number;
+        limit?: number;
+    }) => AuditEntryLike[];
+    subscribeAuditFeed: (subscriber: (entry: AuditEntryLike) => void) => () => void;
+}
+export declare function handleDiagnosticsRoutes(ctx: DiagnosticsRouteContext): Promise<boolean>;
+export {};
+//# sourceMappingURL=diagnostics-routes.d.ts.map

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

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

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

@@ -0,0 +1,365 @@
+import { parseClampedInteger } from "../utils/number-parsing.js";
+async function defaultCheckRelayReachable(relayPort) {
+    try {
+        const response = await fetch(`http://127.0.0.1:${relayPort}/`, {
+            method: "HEAD",
+            signal: AbortSignal.timeout(2000),
+        });
+        return response.ok || response.status < 500;
+    }
+    catch {
+        return false;
+    }
+}
+function defaultResolveExtensionPath() {
+    return null;
+}
+function defaultResolveExtensionArtifacts() {
+    return {};
+}
+function isAutonomyEvent(event) {
+    return event.type === "agent_event" || event.type === "heartbeat_event";
+}
+function defaultInitSse(res) {
+    res.writeHead(200, {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache",
+        Connection: "keep-alive",
+        "X-Accel-Buffering": "no",
+    });
+}
+function defaultWriteSseData(res, data, event) {
+    if (event) {
+        res.write(`event: ${event}\n`);
+    }
+    const safe = data.replace(/\r?\n/g, "\ndata: ");
+    res.write(`data: ${safe}\n\n`);
+}
+function defaultWriteSseJson(res, payload, event) {
+    defaultWriteSseData(res, JSON.stringify(payload), event);
+}
+function parseAuditSince(raw) {
+    if (raw == null)
+        return {};
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        return {
+            error: 'Invalid "since" filter: expected epoch ms or ISO timestamp.',
+        };
+    }
+    const numeric = Number(trimmed);
+    if (Number.isFinite(numeric)) {
+        return { value: Math.trunc(numeric) };
+    }
+    const parsed = Date.parse(trimmed);
+    if (!Number.isFinite(parsed)) {
+        return {
+            error: 'Invalid "since" filter: expected epoch ms or ISO timestamp.',
+        };
+    }
+    return { value: parsed };
+}
+function isTruthyQueryParam(value) {
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return (normalized === "1" ||
+        normalized === "true" ||
+        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;
+    if (filters.severity && entry.severity !== filters.severity)
+        return false;
+    if (filters.sinceMs !== undefined &&
+        Date.parse(entry.timestamp) < filters.sinceMs) {
+        return false;
+    }
+    return true;
+}
+export async function handleDiagnosticsRoutes(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") {
+        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,
+            max: 1000,
+            fallback: 200,
+        });
+        const runIdFilter = url.searchParams.get("runId");
+        const fromSeqRaw = url.searchParams.get("fromSeq");
+        const fromSeq = parseClampedInteger(fromSeqRaw, {
+            min: 0,
+        });
+        if (fromSeqRaw !== null && fromSeq === undefined) {
+            json(res, { error: 'Invalid "fromSeq" filter.' }, 400);
+            return true;
+        }
+        const afterEventId = url.searchParams.get("after");
+        let autonomyEvents = eventBuffer.filter(isAutonomyEvent);
+        if (runIdFilter) {
+            autonomyEvents = autonomyEvents.filter((event) => event.runId === runIdFilter);
+        }
+        if (fromSeq !== undefined) {
+            autonomyEvents = autonomyEvents.filter((event) => typeof event.seq === "number" && event.seq >= fromSeq);
+        }
+        let startIndex = 0;
+        if (afterEventId) {
+            const index = autonomyEvents.findIndex((event) => event.eventId === afterEventId);
+            if (index >= 0) {
+                startIndex = index + 1;
+            }
+        }
+        const events = autonomyEvents.slice(startIndex, startIndex + limit);
+        const latestEventId = events.length > 0 ? events[events.length - 1].eventId : null;
+        json(res, {
+            events,
+            latestEventId,
+            totalBuffered: autonomyEvents.length,
+            replayed: true,
+        });
+        return true;
+    }
+    if (method === "GET" && pathname === "/api/security/audit") {
+        const typeFilterRaw = url.searchParams.get("type");
+        const severityFilterRaw = url.searchParams.get("severity");
+        const limitFilter = parseClampedInteger(url.searchParams.get("limit"), {
+            min: 1,
+            max: 1000,
+            fallback: 200,
+        });
+        const sinceFilter = parseAuditSince(url.searchParams.get("since"));
+        if (sinceFilter.error) {
+            json(res, { error: sinceFilter.error }, 400);
+            return true;
+        }
+        let typeFilter;
+        if (typeFilterRaw) {
+            const candidate = typeFilterRaw.trim();
+            if (!auditEventTypes.includes(candidate)) {
+                json(res, {
+                    error: `Invalid "type" filter. Expected one of: ${auditEventTypes.join(", ")}`,
+                }, 400);
+                return true;
+            }
+            typeFilter = candidate;
+        }
+        let severityFilter;
+        if (severityFilterRaw) {
+            const candidate = severityFilterRaw.trim();
+            if (!auditSeverities.includes(candidate)) {
+                json(res, {
+                    error: `Invalid "severity" filter. Expected one of: ${auditSeverities.join(", ")}`,
+                }, 400);
+                return true;
+            }
+            severityFilter = candidate;
+        }
+        const streamRequested = isTruthyQueryParam(url.searchParams.get("stream")) ||
+            (req.headers.accept ?? "").includes("text/event-stream");
+        const filter = {
+            type: typeFilter,
+            severity: severityFilter,
+            sinceMs: sinceFilter.value,
+        };
+        if (!streamRequested) {
+            const entries = queryAuditFeed({
+                ...filter,
+                limit: limitFilter,
+            });
+            json(res, {
+                entries,
+                totalBuffered: getAuditFeedSize(),
+                replayed: true,
+            });
+            return true;
+        }
+        const startSse = initSse ?? defaultInitSse;
+        const sendSseJson = writeSseJson ?? defaultWriteSseJson;
+        startSse(res);
+        sendSseJson(res, {
+            type: "snapshot",
+            entries: queryAuditFeed({ ...filter, limit: limitFilter }),
+            totalBuffered: getAuditFeedSize(),
+        });
+        const unsubscribe = subscribeAuditFeed((entry) => {
+            if (!matchesAuditFilter(entry, filter))
+                return;
+            sendSseJson(res, { type: "entry", entry });
+        });
+        let closed = false;
+        const close = () => {
+            if (closed)
+                return;
+            closed = true;
+            unsubscribe();
+            if (!res.writableEnded) {
+                res.end();
+            }
+        };
+        req.on("close", close);
+        req.on("aborted", close);
+        res.on("close", close);
+        return true;
+    }
+    if (method === "GET" && pathname === "/api/extension/status") {
+        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;
+    }
+    return false;
+}

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/packages/agent/src/api/documents-service-loader.js

@@ -0,0 +1,36 @@
+const DEFAULT_TIMEOUT_MS = 10_000;
+const MAX_TIMEOUT_MS = 60_000;
+export function getDocumentsServiceTimeoutMs() {
+    const envVal = process.env.DOCUMENTS_SERVICE_TIMEOUT_MS;
+    if (!envVal)
+        return DEFAULT_TIMEOUT_MS;
+    const parsed = Number.parseInt(envVal, 10);
+    if (Number.isNaN(parsed) || parsed <= 0)
+        return DEFAULT_TIMEOUT_MS;
+    return Math.min(parsed, MAX_TIMEOUT_MS);
+}
+/** 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("documents");
+    if (service)
+        return { service };
+    try {
+        const servicePromise = runtime.getServiceLoadPromise("documents");
+        const timeoutMs = getDocumentsServiceTimeoutMs();
+        const timeout = new Promise((_resolve, reject) => {
+            setTimeout(() => reject(new Error("documents service timeout")), timeoutMs);
+        });
+        await Promise.race([servicePromise, timeout]);
+        service = runtime.getService("documents");
+        if (service)
+            return { service };
+        return { service: null, reason: "not_registered" };
+    }
+    catch {
+        return { service: null, reason: "timeout" };
+    }
+}

package/dist/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/dist/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"}