@elizaos/agent 0.25.8 → 2.0.0-alpha.83

package/packages/agent/src/api/http-helpers.js

@@ -0,0 +1,145 @@
+/**
+ * Common request body size guard used across API/benchmark endpoints.
+ */
+export const DEFAULT_MAX_BODY_BYTES = 1_048_576;
+function defaultTooLargeMessage(maxBytes, explicit) {
+    return explicit ?? `Request body exceeds maximum size (${maxBytes} bytes)`;
+}
+export async function readRequestBodyBuffer(req, { maxBytes = DEFAULT_MAX_BODY_BYTES, returnNullOnError = false, returnNullOnTooLarge = false, destroyOnTooLarge = false, tooLargeMessage, } = {}) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let totalBytes = 0;
+        let tooLarge = false;
+        let settled = false;
+        const message = defaultTooLargeMessage(maxBytes, tooLargeMessage);
+        const cleanup = () => {
+            req.off("data", onData);
+            req.off("end", onEnd);
+            req.off("error", onError);
+        };
+        const settle = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            resolve(value);
+        };
+        const fail = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            reject(err);
+        };
+        const onData = (chunk) => {
+            if (settled)
+                return;
+            totalBytes += chunk.length;
+            if (totalBytes > maxBytes) {
+                tooLarge = true;
+                if (returnNullOnTooLarge) {
+                    if (destroyOnTooLarge) {
+                        req.destroy();
+                    }
+                    settle(null);
+                    return;
+                }
+                if (destroyOnTooLarge) {
+                    req.destroy();
+                    fail(new Error(message));
+                    return;
+                }
+                return;
+            }
+            chunks.push(chunk);
+        };
+        const onEnd = () => {
+            if (settled)
+                return;
+            if (tooLarge) {
+                if (returnNullOnTooLarge) {
+                    settle(null);
+                    return;
+                }
+                fail(new Error(message));
+                return;
+            }
+            settle(Buffer.concat(chunks));
+        };
+        const onError = (err) => {
+            if (returnNullOnError) {
+                settle(null);
+                return;
+            }
+            fail(err);
+        };
+        req.on("data", onData);
+        req.on("end", onEnd);
+        req.on("error", onError);
+    });
+}
+export async function readRequestBody(req, options = {}) {
+    const { encoding = "utf-8", ...rawOptions } = options;
+    const body = await readRequestBodyBuffer(req, rawOptions);
+    if (body === null)
+        return null;
+    return body.toString(encoding);
+}
+export function isJsonObjectBody(value) {
+    return value != null && typeof value === "object" && !Array.isArray(value);
+}
+export async function writeJsonResponse(res, body, status = 200) {
+    res.statusCode = status;
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(body));
+}
+export async function writeJsonError(res, message, status = 400) {
+    await writeJsonResponse(res, { error: message }, status);
+}
+export function writeJsonResponseSafe(res, body, status = 200) {
+    void writeJsonResponse(res, body, status).catch(() => {
+        /* ignore response write errors */
+    });
+}
+/** Shorthand responder for successful JSON payloads with safe fire-and-forget write. */
+export function sendJson(res, body, status = 200) {
+    writeJsonResponseSafe(res, body, status);
+}
+/** Shorthand responder for JSON error payloads with safe fire-and-forget write. */
+export function sendJsonError(res, message, status = 400) {
+    writeJsonErrorSafe(res, message, status);
+}
+export function writeJsonErrorSafe(res, message, status = 400) {
+    void writeJsonError(res, message, status).catch(() => {
+        /* ignore response write errors */
+    });
+}
+export async function readJsonBody(req, res, { readErrorStatus = 413, nonObjectStatus = 400, parseErrorStatus = 400, readErrorMessage = "Failed to read request body", nonObjectMessage = "Request body must be a JSON object", parseErrorMessage = "Invalid JSON in request body", requireObject = true, ...readOptions } = {}) {
+    let raw;
+    try {
+        const body = await readRequestBody(req, readOptions);
+        if (body == null) {
+            await writeJsonError(res, readErrorMessage, readErrorStatus);
+            return null;
+        }
+        raw = body;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : "Failed to read request body";
+        await writeJsonError(res, msg, readErrorStatus);
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (requireObject &&
+            (parsed === null || typeof parsed !== "object" || Array.isArray(parsed))) {
+            await writeJsonError(res, nonObjectMessage, nonObjectStatus);
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        await writeJsonError(res, parseErrorMessage, parseErrorStatus);
+        return null;
+    }
+}

package/packages/agent/src/api/index.d.ts

@@ -0,0 +1,61 @@
+export * from "./agent-admin-routes";
+export * from "./agent-lifecycle-routes";
+export * from "./agent-model";
+export * from "./agent-transfer-routes";
+export * from "./apps-routes";
+export * from "./auth-routes";
+export * from "./bug-report-routes";
+export * from "./character-routes";
+export * from "./cloud-billing-routes";
+export * from "./cloud-compat-routes";
+export { type CloudRouteState, handleCloudRoute, } from "./cloud-routes";
+export { type CloudStatusRouteContext, handleCloudStatusRoutes, } from "./cloud-status-routes";
+export * from "./compat-utils";
+export * from "./connector-health";
+export * from "./coordinator-wiring";
+export * from "./credit-detection";
+export * from "./database";
+export * from "./diagnostics-routes";
+export * from "./drop-service";
+export * from "./early-logs";
+export * from "./http-helpers";
+export * from "./knowledge-routes";
+export * from "./knowledge-service-loader";
+export * from "./memory-bounds";
+export * from "./memory-routes";
+export * from "./merkle-tree";
+export * from "./models-routes";
+export * from "./nfa-routes";
+export * from "./og-tracker";
+export * from "./parse-action-block";
+export * from "./permissions-routes";
+export * from "./plugin-validation";
+export * from "./provider-switch-config";
+export * from "./registry-routes";
+export * from "./registry-service";
+export * from "./route-helpers";
+export * from "./sandbox-routes";
+export { applySignalQrOverride, handleSignalRoute, type SignalPairingEventLike, type SignalPairingSessionLike, type SignalRouteDeps, type SignalRouteState, } from "./signal-routes";
+export * from "./stream-route-state";
+export * from "./stream-routes";
+export type { StreamVoiceRouteContext } from "./stream-voice-routes";
+export { handleStreamVoiceRoute } from "./stream-voice-routes";
+export * from "./streaming-text";
+export * from "./subscription-routes";
+export * from "./terminal-run-limits";
+export * from "./training-backend-check";
+export * from "./training-routes";
+export * from "./training-service-like";
+export * from "./trajectory-routes";
+export * from "./trigger-routes";
+export * from "./twitter-verify";
+export * from "./tx-service";
+export * from "./wallet";
+export * from "./wallet-dex-prices";
+export * from "./wallet-evm-balance";
+export * from "./wallet-routes";
+export * from "./wallet-rpc";
+export * from "./wallet-trading-profile";
+export { applyWhatsAppQrOverride, handleWhatsAppRoute, type WhatsAppPairingEventLike, type WhatsAppPairingSessionLike, type WhatsAppRouteDeps, type WhatsAppRouteState, } from "./whatsapp-routes";
+export * from "./zip-utils";
+//# sourceMappingURL=index.d.ts.map

package/packages/agent/src/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,KAAK,eAAe,EACpB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,uBAAuB,EAC5B,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/packages/agent/src/api/index.js

@@ -0,0 +1,59 @@
+export * from "./agent-admin-routes";
+export * from "./agent-lifecycle-routes";
+export * from "./agent-model";
+export * from "./agent-transfer-routes";
+export * from "./apps-routes";
+export * from "./auth-routes";
+export * from "./bug-report-routes";
+export * from "./character-routes";
+export * from "./cloud-billing-routes";
+export * from "./cloud-compat-routes";
+export { handleCloudRoute, } from "./cloud-routes";
+export { handleCloudStatusRoutes, } from "./cloud-status-routes";
+export * from "./compat-utils";
+export * from "./connector-health";
+export * from "./coordinator-wiring";
+export * from "./credit-detection";
+export * from "./database";
+export * from "./diagnostics-routes";
+export * from "./drop-service";
+export * from "./early-logs";
+export * from "./http-helpers";
+export * from "./knowledge-routes";
+export * from "./knowledge-service-loader";
+export * from "./memory-bounds";
+export * from "./memory-routes";
+export * from "./merkle-tree";
+export * from "./models-routes";
+export * from "./nfa-routes";
+export * from "./og-tracker";
+export * from "./parse-action-block";
+export * from "./permissions-routes";
+export * from "./plugin-validation";
+export * from "./provider-switch-config";
+export * from "./registry-routes";
+export * from "./registry-service";
+export * from "./route-helpers";
+export * from "./sandbox-routes";
+export { applySignalQrOverride, handleSignalRoute, } from "./signal-routes";
+export * from "./stream-route-state";
+export * from "./stream-routes";
+export { handleStreamVoiceRoute } from "./stream-voice-routes";
+export * from "./streaming-text";
+export * from "./subscription-routes";
+export * from "./terminal-run-limits";
+export * from "./training-backend-check";
+export * from "./training-routes";
+export * from "./training-service-like";
+export * from "./trajectory-routes";
+export * from "./trigger-routes";
+export * from "./twitter-verify";
+export * from "./tx-service";
+export * from "./wallet";
+export * from "./wallet-dex-prices";
+export * from "./wallet-evm-balance";
+export * from "./wallet-routes";
+export * from "./wallet-rpc";
+export * from "./wallet-trading-profile";
+export { applyWhatsAppQrOverride, handleWhatsAppRoute, } from "./whatsapp-routes";
+export * from "./zip-utils";

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

@@ -0,0 +1,23 @@
+import type { AgentRuntime } from "@elizaos/core";
+import type { RouteHelpers, RouteRequestContext } from "./route-helpers";
+export type KnowledgeRouteHelpers = RouteHelpers;
+export interface KnowledgeRouteContext extends RouteRequestContext {
+    url: URL;
+    runtime: AgentRuntime | null;
+}
+type ResolvedUrlTarget = {
+    parsed: URL;
+    hostname: string;
+    pinnedAddress: string;
+};
+type PinnedFetchInput = {
+    url: URL;
+    init: RequestInit;
+    target: ResolvedUrlTarget;
+    timeoutMs: number;
+};
+type PinnedFetchImpl = (input: PinnedFetchInput) => Promise<Response>;
+export declare function __setPinnedFetchImplForTests(impl: PinnedFetchImpl | null): void;
+export declare function handleKnowledgeRoutes(ctx: KnowledgeRouteContext): Promise<boolean>;
+export {};
+//# sourceMappingURL=knowledge-routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/knowledge-routes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,eAAe,CAAC;AAahE,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAEjD,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B;AA0JD,KAAK,iBAAiB,GAAG;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AA0GtE,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,eAAe,GAAG,IAAI,GAC3B,IAAI,CAEN;AAsWD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,OAAO,CAAC,CA2jBlB"}