@elizaos/agent 0.25.9 → 2.0.0-alpha.151

package/packages/agent/src/api/early-logs.js

@@ -0,0 +1,96 @@
+/**
+ * Early log capture — split out from server.ts to avoid pulling in the entire
+ * API server dependency graph when only the log-buffer init is needed
+ * (e.g. during headless `startEliza()`).
+ *
+ * @module api/early-logs
+ */
+import { logger } from "@elizaos/core";
+// ---------------------------------------------------------------------------
+// Module-level state (shared via the exported accessors)
+// ---------------------------------------------------------------------------
+let earlyLogBuffer = null;
+let earlyPatchCleanup = null;
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Start capturing logs from the global @elizaos/core logger before the API
+ * server is up.  Call this once, early in the startup flow (e.g. before
+ * `startEliza`).  When `startApiServer` runs it will flush and take over.
+ */
+export function captureEarlyLogs() {
+    if (earlyLogBuffer)
+        return; // already capturing
+    // If the global logger is already fully patched (e.g. dev-server started
+    // the API server before calling startEliza), skip early capture entirely.
+    if (logger.__elizaLogPatched)
+        return;
+    earlyLogBuffer = [];
+    const EARLY_PATCHED = "__elizaEarlyPatched";
+    if (logger[EARLY_PATCHED])
+        return;
+    const LEVELS = ["debug", "info", "warn", "error"];
+    const originals = new Map();
+    for (const lvl of LEVELS) {
+        const original = logger[lvl].bind(logger);
+        originals.set(lvl, original);
+        const earlyPatched = (...args) => {
+            let msg = "";
+            let source = "agent";
+            const tags = ["agent"];
+            if (typeof args[0] === "string") {
+                msg = args[0];
+            }
+            else if (args[0] && typeof args[0] === "object") {
+                const obj = args[0];
+                if (typeof obj.src === "string")
+                    source = obj.src;
+                msg = typeof args[1] === "string" ? args[1] : JSON.stringify(obj);
+            }
+            const bracketMatch = /^\[([^\]]+)\]\s*/.exec(msg);
+            if (bracketMatch && source === "agent")
+                source = bracketMatch[1];
+            if (source !== "agent" && !tags.includes(source))
+                tags.push(source);
+            earlyLogBuffer?.push({
+                timestamp: Date.now(),
+                level: lvl,
+                message: msg,
+                source,
+                tags,
+            });
+            return original(...args);
+        };
+        logger[lvl] = earlyPatched;
+    }
+    logger[EARLY_PATCHED] = true;
+    earlyPatchCleanup = () => {
+        // Restore originals so `patchLogger` inside `startApiServer` can re-patch
+        for (const lvl of LEVELS) {
+            const orig = originals.get(lvl);
+            if (orig)
+                logger[lvl] = orig;
+        }
+        delete logger[EARLY_PATCHED];
+        // Don't set the main PATCHED_MARKER — `patchLogger` will do that
+        delete logger
+            .__elizaLogPatched;
+    };
+}
+/**
+ * Drain the early log buffer and clean up the early logger patch.
+ * Called by `startApiServer` to flush buffered entries into the main log
+ * buffer, then hand control to the server's own logger patch.
+ *
+ * Returns the buffered entries (empty array if none).
+ */
+export function flushEarlyLogs() {
+    const entries = earlyLogBuffer ? [...earlyLogBuffer] : [];
+    if (earlyPatchCleanup) {
+        earlyPatchCleanup();
+        earlyPatchCleanup = null;
+    }
+    earlyLogBuffer = null;
+    return entries;
+}

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

@@ -0,0 +1,44 @@
+import type http from "node:http";
+import type { AgentRuntime } from "@elizaos/core";
+import type { ElizaConfig } from "../config/config.js";
+import type { ConnectorHealthMonitor } from "./connector-health.js";
+interface PluginEntryLike {
+    enabled: boolean;
+    configured: boolean;
+}
+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;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAOpE,UAAU,eAAe;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;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,CAqOlB"}

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

@@ -0,0 +1,449 @@
+import { isCloudProvisionedContainer } from "./cloud-provisioning.js";
+import { resolveCloudApiKey } from "./wallet-rpc.js";
+// ---------------------------------------------------------------------------
+// Runtime debug utilities (only used by GET /api/runtime)
+// ---------------------------------------------------------------------------
+const RUNTIME_DEBUG_DEFAULT_MAX_DEPTH = 10;
+const RUNTIME_DEBUG_MAX_DEPTH_CAP = 24;
+const RUNTIME_DEBUG_DEFAULT_MAX_ARRAY_LENGTH = 1000;
+const RUNTIME_DEBUG_DEFAULT_MAX_OBJECT_ENTRIES = 1000;
+const RUNTIME_DEBUG_DEFAULT_MAX_STRING_LENGTH = 8000;
+function parseDebugPositiveInt(raw, fallback, min, max) {
+    if (!raw)
+        return fallback;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed))
+        return fallback;
+    const intValue = Math.floor(parsed);
+    if (intValue < min)
+        return min;
+    if (intValue > max)
+        return max;
+    return intValue;
+}
+function classNameFor(value) {
+    const ctor = value.constructor;
+    const maybeName = typeof ctor?.name === "string" ? ctor.name.trim() : "";
+    return maybeName || "Object";
+}
+function stringDataProperty(value, key) {
+    if (!value || typeof value !== "object")
+        return null;
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    if (!descriptor || !("value" in descriptor))
+        return null;
+    const maybeString = descriptor.value;
+    if (typeof maybeString !== "string")
+        return null;
+    const trimmed = maybeString.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function describeRuntimeOrder(values, fallbackLabel) {
+    return values.map((value, index) => {
+        const className = value && typeof value === "object" ? classNameFor(value) : typeof value;
+        const name = stringDataProperty(value, "name") ??
+            stringDataProperty(value, "id") ??
+            stringDataProperty(value, "key") ??
+            stringDataProperty(value, "serviceType") ??
+            `${fallbackLabel} ${index + 1}`;
+        const id = stringDataProperty(value, "id") ?? stringDataProperty(value, "name");
+        return { index, name, className, id };
+    });
+}
+function describeRuntimeServiceOrder(servicesMap) {
+    return Array.from(servicesMap.entries()).map(([serviceType, instances], i) => {
+        const values = Array.isArray(instances) ? instances : [];
+        return {
+            index: i,
+            serviceType,
+            count: values.length,
+            instances: describeRuntimeOrder(values, serviceType),
+        };
+    });
+}
+function serializeForRuntimeDebug(value, options) {
+    const seen = new WeakMap();
+    const visit = (current, path, depth) => {
+        if (current === null)
+            return null;
+        const kind = typeof current;
+        if (kind === "string") {
+            if (current.length <= options.maxStringLength)
+                return current;
+            return {
+                __type: "string",
+                length: current.length,
+                preview: `${current.slice(0, options.maxStringLength)}...`,
+                truncated: true,
+            };
+        }
+        if (kind === "number") {
+            const n = current;
+            if (Number.isFinite(n))
+                return n;
+            return { __type: "number", value: String(n) };
+        }
+        if (kind === "boolean")
+            return current;
+        if (kind === "bigint")
+            return { __type: "bigint", value: String(current) };
+        if (kind === "undefined")
+            return { __type: "undefined" };
+        if (kind === "symbol")
+            return { __type: "symbol", value: String(current) };
+        if (kind === "function") {
+            const fn = current;
+            return {
+                __type: "function",
+                name: fn.name || "(anonymous)",
+                length: fn.length,
+            };
+        }
+        const obj = current;
+        if (obj instanceof Date) {
+            return { __type: "date", value: obj.toISOString() };
+        }
+        if (obj instanceof RegExp) {
+            return { __type: "regexp", value: String(obj) };
+        }
+        if (obj instanceof Error) {
+            const err = obj;
+            const out = {
+                __type: "error",
+                name: err.name,
+                message: err.message,
+            };
+            if (err.stack) {
+                out.stack =
+                    err.stack.length > options.maxStringLength
+                        ? `${err.stack.slice(0, options.maxStringLength)}...`
+                        : err.stack;
+            }
+            if (err.cause !== undefined) {
+                out.cause = visit(err.cause, `${path}.cause`, depth + 1);
+            }
+            return out;
+        }
+        if (Buffer.isBuffer(obj)) {
+            const previewLength = Math.min(obj.length, 64);
+            return {
+                __type: "buffer",
+                length: obj.length,
+                previewHex: obj.subarray(0, previewLength).toString("hex"),
+                truncated: obj.length > previewLength,
+            };
+        }
+        if (ArrayBuffer.isView(obj)) {
+            const view = obj;
+            const previewLength = Math.min(view.byteLength, 64);
+            const bytes = new Uint8Array(view.buffer, view.byteOffset, previewLength);
+            return {
+                __type: classNameFor(obj),
+                byteLength: view.byteLength,
+                previewHex: Buffer.from(bytes).toString("hex"),
+                truncated: view.byteLength > previewLength,
+            };
+        }
+        if (obj instanceof ArrayBuffer) {
+            const previewLength = Math.min(obj.byteLength, 64);
+            const bytes = new Uint8Array(obj, 0, previewLength);
+            return {
+                __type: "array-buffer",
+                byteLength: obj.byteLength,
+                previewHex: Buffer.from(bytes).toString("hex"),
+                truncated: obj.byteLength > previewLength,
+            };
+        }
+        const seenPath = seen.get(obj);
+        if (seenPath)
+            return { __type: "circular", ref: seenPath };
+        if (depth >= options.maxDepth) {
+            return {
+                __type: "max-depth",
+                className: classNameFor(obj),
+                path,
+            };
+        }
+        seen.set(obj, path);
+        if (Array.isArray(obj)) {
+            const arr = obj;
+            const limit = Math.min(arr.length, options.maxArrayLength);
+            const items = new Array(limit);
+            for (let i = 0; i < limit; i++) {
+                items[i] = visit(arr[i], `${path}[${i}]`, depth + 1);
+            }
+            const out = {
+                __type: "array",
+                length: arr.length,
+                items,
+            };
+            if (arr.length > limit)
+                out.truncatedItems = arr.length - limit;
+            return out;
+        }
+        if (obj instanceof Map) {
+            const entries = [];
+            let i = 0;
+            for (const [entryKey, entryValue] of obj.entries()) {
+                if (i >= options.maxObjectEntries)
+                    break;
+                entries.push({
+                    key: visit(entryKey, `${path}.<key:${i}>`, depth + 1),
+                    value: visit(entryValue, `${path}.<value:${i}>`, depth + 1),
+                });
+                i += 1;
+            }
+            const out = {
+                __type: "map",
+                size: obj.size,
+                entries,
+            };
+            if (obj.size > entries.length) {
+                out.truncatedEntries = obj.size - entries.length;
+            }
+            return out;
+        }
+        if (obj instanceof Set) {
+            const values = [];
+            let i = 0;
+            for (const entry of obj.values()) {
+                if (i >= options.maxArrayLength)
+                    break;
+                values.push(visit(entry, `${path}.<set:${i}>`, depth + 1));
+                i += 1;
+            }
+            const out = {
+                __type: "set",
+                size: obj.size,
+                values,
+            };
+            if (obj.size > values.length)
+                out.truncatedEntries = obj.size - values.length;
+            return out;
+        }
+        if (obj instanceof WeakMap) {
+            return { __type: "weak-map" };
+        }
+        if (obj instanceof WeakSet) {
+            return { __type: "weak-set" };
+        }
+        if (obj instanceof Promise) {
+            return { __type: "promise" };
+        }
+        const ownNames = Object.getOwnPropertyNames(obj);
+        const ownSymbols = Object.getOwnPropertySymbols(obj);
+        const allKeys = [...ownNames, ...ownSymbols];
+        const limit = Math.min(allKeys.length, options.maxObjectEntries);
+        const properties = {};
+        for (let i = 0; i < limit; i++) {
+            const propertyKey = allKeys[i];
+            const keyLabel = typeof propertyKey === "string"
+                ? propertyKey
+                : `[${String(propertyKey)}]`;
+            const descriptor = Object.getOwnPropertyDescriptor(obj, propertyKey);
+            if (!descriptor)
+                continue;
+            if ("value" in descriptor) {
+                properties[keyLabel] = visit(descriptor.value, `${path}.${keyLabel}`, depth + 1);
+            }
+            else {
+                properties[keyLabel] = {
+                    __type: "accessor",
+                    hasGetter: typeof descriptor.get === "function",
+                    hasSetter: typeof descriptor.set === "function",
+                    enumerable: descriptor.enumerable,
+                };
+            }
+        }
+        if (allKeys.length > limit) {
+            properties.__truncatedKeys = allKeys.length - limit;
+        }
+        const prototype = Object.getPrototypeOf(obj);
+        const isPlainObject = prototype === Object.prototype || prototype === null;
+        if (isPlainObject)
+            return properties;
+        return {
+            __type: "object",
+            className: classNameFor(obj),
+            properties,
+        };
+    };
+    return visit(value, "$", 0);
+}
+// ---------------------------------------------------------------------------
+// Route handler
+// ---------------------------------------------------------------------------
+/**
+ * Handle health / status / runtime introspection routes.
+ * Returns `true` if the request was handled.
+ */
+export async function handleHealthRoutes(ctx) {
+    const { res, method, pathname, url, state, json, error } = ctx;
+    // ── GET /api/status ─────────────────────────────────────────────────────
+    if (method === "GET" && pathname === "/api/status") {
+        const uptime = state.startedAt ? Date.now() - state.startedAt : undefined;
+        const cloudProvisioned = isCloudProvisionedContainer();
+        const hasCloudApiKey = Boolean(resolveCloudApiKey(state.config, state.runtime));
+        const cloudStatus = {
+            connectionStatus: cloudProvisioned || hasCloudApiKey ? "connected" : "disconnected",
+            activeAgentId: cloudProvisioned ? state.agentName : null,
+            cloudProvisioned,
+            hasApiKey: hasCloudApiKey,
+        };
+        json(res, {
+            state: state.agentState,
+            agentName: state.agentName,
+            model: state.model,
+            startedAt: state.startedAt,
+            uptime,
+            startup: state.startup,
+            cloud: cloudStatus,
+            pendingRestart: state.pendingRestartReasons.length > 0,
+            pendingRestartReasons: state.pendingRestartReasons,
+        });
+        return true;
+    }
+    // ── GET /api/health ──────────────────────────────────────────────────────
+    // Structured health check endpoint returning subsystem status.
+    if (method === "GET" && pathname === "/api/health") {
+        const runtime = state.runtime;
+        const uptime = state.startedAt
+            ? Math.floor((Date.now() - state.startedAt) / 1000)
+            : 0;
+        const loadedPlugins = state.plugins.filter((p) => p.enabled);
+        const failedPlugins = state.plugins.filter((p) => !p.enabled && !p.configured);
+        let coordinatorStatus = "not_wired";
+        try {
+            if (runtime?.getService("SWARM_COORDINATOR")) {
+                coordinatorStatus = "ok";
+            }
+        }
+        catch {
+            // not available
+        }
+        const connectors = state.connectorHealthMonitor
+            ? state.connectorHealthMonitor.getConnectorStatuses()
+            : {};
+        if (Object.keys(connectors).length === 0 && state.config.connectors) {
+            for (const [name, cfg] of Object.entries(state.config.connectors)) {
+                if (cfg &&
+                    typeof cfg === "object" &&
+                    cfg.enabled !== false) {
+                    connectors[name] = "configured";
+                }
+            }
+        }
+        const ready = state.agentState !== "starting" && state.agentState !== "restarting";
+        json(res, {
+            ready,
+            runtime: runtime ? "ok" : "not_initialized",
+            database: runtime ? "ok" : "unknown",
+            plugins: {
+                loaded: loadedPlugins.length,
+                failed: failedPlugins.length,
+            },
+            coordinator: coordinatorStatus,
+            connectors,
+            uptime,
+            agentState: state.agentState,
+            startup: state.startup,
+        });
+        return true;
+    }
+    // ── GET /api/runtime ───────────────────────────────────────────────────
+    // Deep runtime introspection endpoint for advanced debugging UI.
+    if (method === "GET" && pathname === "/api/runtime") {
+        const maxDepth = parseDebugPositiveInt(url.searchParams.get("depth"), RUNTIME_DEBUG_DEFAULT_MAX_DEPTH, 1, RUNTIME_DEBUG_MAX_DEPTH_CAP);
+        const maxArrayLength = parseDebugPositiveInt(url.searchParams.get("maxArrayLength"), RUNTIME_DEBUG_DEFAULT_MAX_ARRAY_LENGTH, 1, 5000);
+        const maxObjectEntries = parseDebugPositiveInt(url.searchParams.get("maxObjectEntries"), RUNTIME_DEBUG_DEFAULT_MAX_OBJECT_ENTRIES, 1, 5000);
+        const maxStringLength = parseDebugPositiveInt(url.searchParams.get("maxStringLength"), RUNTIME_DEBUG_DEFAULT_MAX_STRING_LENGTH, 64, 100_000);
+        const serializeOptions = {
+            maxDepth,
+            maxArrayLength,
+            maxObjectEntries,
+            maxStringLength,
+        };
+        const runtime = state.runtime;
+        const generatedAt = Date.now();
+        if (!runtime) {
+            json(res, {
+                runtimeAvailable: false,
+                generatedAt,
+                settings: serializeOptions,
+                meta: {
+                    agentState: state.agentState,
+                    agentName: state.agentName,
+                    model: state.model ?? null,
+                    pluginCount: 0,
+                    actionCount: 0,
+                    providerCount: 0,
+                    evaluatorCount: 0,
+                    serviceTypeCount: 0,
+                    serviceCount: 0,
+                },
+                order: {
+                    plugins: [],
+                    actions: [],
+                    providers: [],
+                    evaluators: [],
+                    services: [],
+                },
+                sections: {
+                    runtime: null,
+                    plugins: [],
+                    actions: [],
+                    providers: [],
+                    evaluators: [],
+                    services: {},
+                },
+            });
+            return true;
+        }
+        try {
+            const servicesMap = runtime.services;
+            const serviceCount = Array.from(servicesMap.values()).reduce((sum, entries) => sum + (Array.isArray(entries) ? entries.length : 0), 0);
+            const orderServices = describeRuntimeServiceOrder(servicesMap);
+            const orderPlugins = describeRuntimeOrder(runtime.plugins, "plugin");
+            const orderActions = describeRuntimeOrder(runtime.actions, "action");
+            const orderProviders = describeRuntimeOrder(runtime.providers, "provider");
+            const orderEvaluators = describeRuntimeOrder(runtime.evaluators, "evaluator");
+            json(res, {
+                runtimeAvailable: true,
+                generatedAt,
+                settings: serializeOptions,
+                meta: {
+                    agentId: runtime.agentId,
+                    agentState: state.agentState,
+                    agentName: runtime.character.name ?? state.agentName,
+                    model: state.model ?? null,
+                    pluginCount: runtime.plugins.length,
+                    actionCount: runtime.actions.length,
+                    providerCount: runtime.providers.length,
+                    evaluatorCount: runtime.evaluators.length,
+                    serviceTypeCount: servicesMap.size,
+                    serviceCount,
+                },
+                order: {
+                    plugins: orderPlugins,
+                    actions: orderActions,
+                    providers: orderProviders,
+                    evaluators: orderEvaluators,
+                    services: orderServices,
+                },
+                sections: {
+                    runtime: serializeForRuntimeDebug(runtime, serializeOptions),
+                    plugins: serializeForRuntimeDebug(runtime.plugins, serializeOptions),
+                    actions: serializeForRuntimeDebug(runtime.actions, serializeOptions),
+                    providers: serializeForRuntimeDebug(runtime.providers, serializeOptions),
+                    evaluators: serializeForRuntimeDebug(runtime.evaluators, serializeOptions),
+                    services: serializeForRuntimeDebug(servicesMap, serializeOptions),
+                },
+            });
+        }
+        catch (err) {
+            error(res, `Failed to build runtime debug snapshot: ${err instanceof Error ? err.message : String(err)}`, 500);
+        }
+        return true;
+    }
+    return false;
+}

package/packages/agent/src/api/http-helpers.d.ts

@@ -0,0 +1,50 @@
+import type http from "node:http";
+/**
+ * Common request body size guard used across API/benchmark endpoints.
+ */
+export declare const DEFAULT_MAX_BODY_BYTES = 1048576;
+export interface RequestBodyOptions {
+    /** Maximum accepted body size in bytes. */
+    maxBytes?: number;
+    /** String conversion encoding for body text helpers. */
+    encoding?: BufferEncoding;
+    /** Error message returned when the request body exceeds `maxBytes`. */
+    tooLargeMessage?: string;
+    /** When true, resolves to `null` instead of rejecting on body read failure. */
+    returnNullOnError?: boolean;
+    /** When true, resolves to `null` instead of rejecting on size limit exceed. */
+    returnNullOnTooLarge?: boolean;
+    /** Whether to destroy the request stream as soon as the body limit is exceeded. */
+    destroyOnTooLarge?: boolean;
+}
+export declare function readRequestBodyBuffer(req: http.IncomingMessage, { maxBytes, returnNullOnError, returnNullOnTooLarge, destroyOnTooLarge, tooLargeMessage, }?: RequestBodyOptions): Promise<Buffer | null>;
+export interface ReadTextBodyOptions extends RequestBodyOptions {
+}
+export declare function readRequestBody(req: http.IncomingMessage, options?: ReadTextBodyOptions): Promise<string | null>;
+export interface ReadJsonBodyOptions extends ReadTextBodyOptions {
+    /** Whether to require JSON object shape (not arrays/null). */
+    requireObject?: boolean;
+    /** Response status used for parse/read failures. */
+    readErrorStatus?: number;
+    /** Response status used for non-object body when `requireObject` is true. */
+    nonObjectStatus?: number;
+    /** Response status used for invalid JSON syntax. */
+    parseErrorStatus?: number;
+    /** Override for read errors (including size / stream errors). */
+    readErrorMessage?: string;
+    /** Override when JSON is valid but not an object. */
+    nonObjectMessage?: string;
+    /** Override for malformed JSON parse errors. */
+    parseErrorMessage?: string;
+}
+export declare function isJsonObjectBody(value: unknown): value is Record<string, unknown>;
+export declare function writeJsonResponse(res: http.ServerResponse, body: unknown, status?: number): Promise<void>;
+export declare function writeJsonError(res: http.ServerResponse, message: string, status?: number): Promise<void>;
+export declare function writeJsonResponseSafe(res: http.ServerResponse, body: unknown, status?: number): void;
+/** Shorthand responder for successful JSON payloads with safe fire-and-forget write. */
+export declare function sendJson(res: http.ServerResponse, body: unknown, status?: number): void;
+/** Shorthand responder for JSON error payloads with safe fire-and-forget write. */
+export declare function sendJsonError(res: http.ServerResponse, message: string, status?: number): void;
+export declare function writeJsonErrorSafe(res: http.ServerResponse, message: string, status?: number): void;
+export declare function readJsonBody<T = Record<string, unknown>>(req: http.IncomingMessage, res: http.ServerResponse, { readErrorStatus, nonObjectStatus, parseErrorStatus, readErrorMessage, nonObjectMessage, parseErrorMessage, requireObject, ...readOptions }?: ReadJsonBodyOptions): Promise<T | null>;
+//# sourceMappingURL=http-helpers.d.ts.map

package/packages/agent/src/api/http-helpers.d.ts.map

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