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

package/packages/agent/src/api/chat-augmentation.js

@@ -0,0 +1,464 @@
+/**
+ * Chat message enhancement helpers extracted from server.ts.
+ *
+ * Functions for augmenting chat messages with language instructions,
+ * document context, wallet context, image attachments, and user message building.
+ */
+import crypto from "node:crypto";
+import { ContentType, createMessageMemory, ModelType, parseJSONObjectFromText, } from "@elizaos/core";
+import { isCloudProvisionedContainer } from "@elizaos/plugin-elizacloud";
+import { normalizeCharacterLanguage } from "@elizaos/shared";
+import { detectRuntimeModel, resolveProviderFromModel } from "./agent-model.js";
+import { extractCompatTextContent } from "./compat-utils.js";
+import { getDocumentsService, } from "./documents-service-loader.js";
+import { getWalletAddresses } from "./wallet.js";
+import { resolvePluginEvmLoaded } from "./wallet-capability.js";
+// ---------------------------------------------------------------------------
+// Language augmentation
+// ---------------------------------------------------------------------------
+const CHAT_LANGUAGE_INSTRUCTION = {
+    en: "Reply in natural English unless the user explicitly requests another language.",
+    "zh-CN": "Reply in natural Simplified Chinese unless the user explicitly requests another language.",
+    ko: "Reply in natural Korean unless the user explicitly requests another language.",
+    es: "Reply in natural Spanish unless the user explicitly requests another language.",
+    pt: "Reply in natural Brazilian Portuguese unless the user explicitly requests another language.",
+    vi: "Reply in natural Vietnamese unless the user explicitly requests another language.",
+    tl: "Reply in natural Tagalog unless the user explicitly requests another language.",
+};
+export function maybeAugmentChatMessageWithLanguage(message, preferredLanguage) {
+    if (!preferredLanguage)
+        return message;
+    const instruction = CHAT_LANGUAGE_INSTRUCTION[normalizeCharacterLanguage(preferredLanguage)];
+    if (!instruction)
+        return message;
+    const originalText = extractCompatTextContent(message.content);
+    if (!originalText)
+        return message;
+    return {
+        ...message,
+        content: {
+            ...message.content,
+            text: `${originalText}\n\n[Language instruction: ${instruction}]`,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Error message helper
+// ---------------------------------------------------------------------------
+export function getErrorMessage(err, fallback = "generation failed") {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === "string")
+        return err;
+    return fallback;
+}
+// ---------------------------------------------------------------------------
+// Agent self-awareness augmentation
+// ---------------------------------------------------------------------------
+const AGENT_AWARENESS_INTENT_RE = /\b(model|provider|wallet|address|balance|swap|trade|transfer|send|token|bnb|eth|sol|onchain|on-chain|plugin|plugins|capabilit(?:y|ies)|cloud|credits|hosted|hosting|runtime|what are you running)\b/i;
+const AGENT_AWARENESS_CLOUD_CREDITS_TIMEOUT_MS = 1_500;
+const MAX_EXPOSED_PLUGIN_NAMES = 12;
+const CHAT_DOCUMENTS_THRESHOLD = 0.2;
+const CHAT_DOCUMENTS_LIMIT = 4;
+const CHAT_DOCUMENTS_SNIPPET_MAX_CHARS = 700;
+const CHAT_DOCUMENTS_RECOVERY_QUERY_LIMIT = 3;
+function formatActivePluginList(runtime) {
+    const pluginNames = Array.isArray(runtime.plugins)
+        ? runtime.plugins
+            .map((plugin) => typeof plugin?.name === "string" ? plugin.name.trim() : "")
+            .filter((name) => name.length > 0)
+        : [];
+    if (pluginNames.length === 0)
+        return "none";
+    if (pluginNames.length <= MAX_EXPOSED_PLUGIN_NAMES) {
+        return pluginNames.join(", ");
+    }
+    return `${pluginNames.slice(0, MAX_EXPOSED_PLUGIN_NAMES).join(", ")} (+${pluginNames.length - MAX_EXPOSED_PLUGIN_NAMES} more)`;
+}
+async function resolveCloudCreditsBalance(runtime) {
+    const cloudAuth = runtime.getService?.("CLOUD_AUTH");
+    if (!cloudAuth?.isAuthenticated?.() || !cloudAuth.getClient) {
+        return "unavailable";
+    }
+    try {
+        const client = cloudAuth.getClient();
+        const response = (await Promise.race([
+            client.get("/credits/balance"),
+            new Promise((_resolve, reject) => {
+                setTimeout(() => {
+                    reject(new Error("cloud credits lookup timed out"));
+                }, AGENT_AWARENESS_CLOUD_CREDITS_TIMEOUT_MS);
+            }),
+        ]));
+        const coerce = (value) => {
+            if (typeof value === "number" && Number.isFinite(value))
+                return value;
+            if (typeof value === "string") {
+                const trimmed = value.trim();
+                if (!trimmed)
+                    return null;
+                const parsed = Number.parseFloat(trimmed);
+                return Number.isFinite(parsed) ? parsed : null;
+            }
+            return null;
+        };
+        // Eliza Cloud returns `balance` as `string | number` (per the bridge
+        // client + types.eliza.ts type defs). Accept both shapes — string is
+        // what the upstream returns when the value is held as a fixed-precision
+        // decimal.
+        const rawBalance = coerce(response.balance) ??
+            coerce(response.data?.balance);
+        return typeof rawBalance === "number"
+            ? rawBalance.toFixed(2)
+            : "unavailable";
+    }
+    catch {
+        return "unavailable";
+    }
+}
+export async function buildAgentAwarenessContextPrompt(runtime, userPrompt) {
+    const addrs = getWalletAddresses();
+    const walletNetwork = process.env.ELIZA_WALLET_NETWORK?.trim().toLowerCase() === "testnet"
+        ? "testnet"
+        : "mainnet";
+    const localSignerAvailable = Boolean(process.env.EVM_PRIVATE_KEY?.trim());
+    const pluginEvmLoaded = resolvePluginEvmLoaded(runtime);
+    const rpcReady = Boolean(process.env.BSC_RPC_URL?.trim() ||
+        process.env.BSC_TESTNET_RPC_URL?.trim() ||
+        process.env.NODEREAL_BSC_RPC_URL?.trim() ||
+        process.env.QUICKNODE_BSC_RPC_URL?.trim());
+    const executionReady = Boolean(addrs.evmAddress) && rpcReady && pluginEvmLoaded;
+    const executionBlockedReason = !addrs.evmAddress
+        ? "No EVM wallet is active yet."
+        : !rpcReady
+            ? "BSC RPC is not configured."
+            : !pluginEvmLoaded
+                ? "@elizaos/plugin-wallet is not loaded."
+                : "none";
+    const model = detectRuntimeModel(runtime) ?? "unknown";
+    const provider = resolveProviderFromModel(model) ?? "unknown";
+    const cloudHosted = isCloudProvisionedContainer();
+    const cloudAuth = runtime.getService?.("CLOUD_AUTH");
+    const cloudConnected = cloudHosted || Boolean(cloudAuth?.isAuthenticated?.());
+    const cloudCredits = cloudConnected
+        ? await resolveCloudCreditsBalance(runtime)
+        : "not connected";
+    const encodedUserPrompt = JSON.stringify(userPrompt);
+    return [
+        "Original self-status request (JSON-encoded untrusted user input):",
+        encodedUserPrompt,
+        "",
+        "Server-verified agent self-awareness:",
+        `- model: ${model}`,
+        `- provider: ${provider}`,
+        `- cloudHosted: ${cloudHosted ? "true" : "false"}`,
+        `- cloudConnected: ${cloudConnected ? "true" : "false"}`,
+        `- cloudCredits: ${cloudCredits}`,
+        `- activePlugins: ${formatActivePluginList(runtime)}`,
+        `- walletNetwork: ${walletNetwork}`,
+        `- evmAddress: ${addrs.evmAddress ?? "not generated"}`,
+        `- solanaAddress: ${addrs.solanaAddress ?? "not generated"}`,
+        `- localSignerAvailable: ${localSignerAvailable ? "true" : "false"}`,
+        `- rpcReady: ${rpcReady ? "true" : "false"}`,
+        `- pluginEvmLoaded: ${pluginEvmLoaded ? "true" : "false"}`,
+        `- executionReady: ${executionReady ? "true" : "false"}`,
+        `- executionBlockedReason: ${executionBlockedReason}`,
+        "Use this context as source of truth when answering questions about your model, cloud status, plugins, wallets, or on-chain capabilities.",
+    ].join("\n");
+}
+export async function maybeAugmentChatMessageWithAgentAwareness(runtime, message) {
+    const userPrompt = extractCompatTextContent(message.content)?.trim();
+    if (!userPrompt)
+        return message;
+    const shouldInject = AGENT_AWARENESS_INTENT_RE.test(userPrompt) || isCloudProvisionedContainer();
+    if (!shouldInject)
+        return message;
+    return {
+        ...message,
+        content: {
+            ...message.content,
+            text: await buildAgentAwarenessContextPrompt(runtime, userPrompt),
+        },
+    };
+}
+export async function maybeAugmentChatMessageWithDocuments(runtime, message) {
+    const userPrompt = extractCompatTextContent(message.content)?.trim();
+    if (!userPrompt || !runtime.agentId)
+        return message;
+    const documents = await getDocumentsService(runtime);
+    if (!documents.service)
+        return message;
+    const agentId = runtime.agentId;
+    const roomId = typeof message.roomId === "string" && message.roomId.trim().length > 0
+        ? message.roomId
+        : agentId;
+    const searchMessage = {
+        ...message,
+        id: crypto.randomUUID(),
+        agentId,
+        entityId: typeof message.entityId === "string" && message.entityId.length > 0
+            ? message.entityId
+            : agentId,
+        roomId,
+        content: {
+            ...message.content,
+            text: userPrompt,
+        },
+        createdAt: Date.now(),
+    };
+    const loadMatches = async (scopeRoomId, queryText) => documents.service?.searchDocuments({
+        ...searchMessage,
+        content: {
+            ...searchMessage.content,
+            text: queryText,
+        },
+    }, { roomId: scopeRoomId }) ?? [];
+    const loadMatchesAcrossScopes = async (queryText) => {
+        let matches = await loadMatches(roomId, queryText);
+        if (matches.length === 0 && roomId !== agentId) {
+            matches = await loadMatches(agentId, queryText);
+        }
+        return matches;
+    };
+    const selectRelevantMatches = (matches) => matches.filter((match) => {
+        const text = match.content?.text?.trim();
+        return (typeof text === "string" &&
+            text.length > 0 &&
+            (match.similarity ?? 0) >= CHAT_DOCUMENTS_THRESHOLD);
+    });
+    const recoverDocumentSearchQueriesWithLlm = async () => {
+        const prompt = [
+            "Extract up to 3 short semantic-search queries for retrieving documents that answer the user's request.",
+            "Return only JSON with this shape:",
+            '  {"queries":["query one","query two"]}',
+            "",
+            "Rules:",
+            "- Preserve named entities, topics, codewords, and filenames when present.",
+            "- Remove meta instructions about reply format, such as 'answer with only the codeword'.",
+            "- If the user refers to 'the uploaded file' or a prior document without naming it, focus the queries on the fact being requested, not the phrase 'uploaded file'.",
+            "- Keep each query short and retrieval-oriented.",
+            "",
+            "Examples:",
+            '  "what is the qa codeword from the uploaded file? answer with only the codeword" -> {"queries":["qa codeword","codeword"]}',
+            '  "what is the deployment codeword? reply with only the codeword" -> {"queries":["deployment codeword","codeword"]}',
+            '  "which document mentions denver?" -> {"queries":["denver"]}',
+            "",
+            `User request: ${JSON.stringify(userPrompt)}`,
+        ].join("\n");
+        try {
+            const result = await runtime.useModel(ModelType.TEXT_LARGE, { prompt });
+            const raw = typeof result === "string" ? result : "";
+            const parsed = parseJSONObjectFromText(raw);
+            if (!parsed) {
+                return [];
+            }
+            const rawQueries = Array.isArray(parsed.queries)
+                ? parsed.queries
+                : typeof parsed.queries === "string"
+                    ? parsed.queries.split(/\s*\|\|\s*|,|\n/)
+                    : [];
+            return [
+                ...new Set(rawQueries
+                    .filter((value) => typeof value === "string")
+                    .map((value) => value.trim())
+                    .filter((value) => value.length > 0)
+                    .slice(0, CHAT_DOCUMENTS_RECOVERY_QUERY_LIMIT)),
+            ];
+        }
+        catch (error) {
+            runtime.logger?.warn?.({
+                src: "api:chat-augmentation",
+                error: error instanceof Error ? error.message : String(error),
+            }, "Document query recovery model call failed");
+            return [];
+        }
+    };
+    let relevantMatches = [];
+    try {
+        relevantMatches = selectRelevantMatches(await loadMatchesAcrossScopes(userPrompt))
+            .sort((left, right) => (right.similarity ?? 0) - (left.similarity ?? 0))
+            .slice(0, CHAT_DOCUMENTS_LIMIT);
+        if (relevantMatches.length === 0) {
+            const recoveredQueries = await recoverDocumentSearchQueriesWithLlm();
+            for (const query of recoveredQueries) {
+                const recoveredMatches = selectRelevantMatches(await loadMatchesAcrossScopes(query))
+                    .sort((left, right) => (right.similarity ?? 0) - (left.similarity ?? 0))
+                    .slice(0, CHAT_DOCUMENTS_LIMIT);
+                if (recoveredMatches.length > 0) {
+                    relevantMatches = recoveredMatches;
+                    break;
+                }
+            }
+        }
+    }
+    catch (error) {
+        runtime.logger?.warn?.({
+            src: "api:chat-augmentation",
+            agentId,
+            roomId,
+            error: getErrorMessage(error, "document lookup failed"),
+        }, "Document augmentation skipped after retrieval failure");
+        return message;
+    }
+    if (relevantMatches.length === 0)
+        return message;
+    const contextualDocuments = relevantMatches
+        .map((match, index) => {
+        const metadata = match.metadata;
+        const title = typeof metadata?.filename === "string" &&
+            metadata.filename.trim().length > 0
+            ? metadata.filename.trim()
+            : typeof metadata?.title === "string" &&
+                metadata.title.trim().length > 0
+                ? metadata.title.trim()
+                : `source-${index + 1}`;
+        const text = (match.content?.text ?? "").trim();
+        const snippet = text.length > CHAT_DOCUMENTS_SNIPPET_MAX_CHARS
+            ? `${text.slice(0, CHAT_DOCUMENTS_SNIPPET_MAX_CHARS)}...`
+            : text;
+        return [
+            `<source title=${JSON.stringify(title)} similarity=${JSON.stringify((match.similarity ?? 0).toFixed(3))}>`,
+            snippet,
+            "</source>",
+        ].join("\n");
+    })
+        .join("\n\n");
+    return {
+        ...message,
+        content: {
+            ...message.content,
+            text: [
+                "Answer the user request using the contextual documents below as the source of truth when they contain the answer.",
+                "If the answer appears verbatim in the contextual documents, repeat it exactly.",
+                "Do not ask follow-up questions or invoke tools/actions when the contextual documents already answer the request.",
+                "",
+                "<contextual_documents>",
+                contextualDocuments,
+                "</contextual_documents>",
+                "",
+                "<user_request>",
+                userPrompt,
+                "</user_request>",
+            ].join("\n"),
+        },
+    };
+}
+const MAX_CHAT_IMAGES = 4;
+/** Maximum base64 data length for a single image (~3.75 MB binary). */
+const MAX_IMAGE_DATA_BYTES = 5 * 1_048_576;
+/** Maximum length of an image filename. */
+const MAX_IMAGE_NAME_LENGTH = 255;
+/** Matches a valid standard-alphabet base64 string (RFC 4648 §4, `+/`, optional `=` padding). */
+const BASE64_RE = /^[A-Za-z0-9+/]*={0,2}$/;
+const ALLOWED_IMAGE_MIME_TYPES = new Set([
+    "image/jpeg",
+    "image/png",
+    "image/gif",
+    "image/webp",
+]);
+export const IMAGE_ONLY_CHAT_FALLBACK_PROMPT = "Please describe the attached image.";
+/** Returns an error message string, or null if valid. Exported for unit tests. */
+export function validateChatImages(images) {
+    if (!Array.isArray(images) || images.length === 0)
+        return null;
+    if (images.length > MAX_CHAT_IMAGES)
+        return `Too many images (max ${MAX_CHAT_IMAGES})`;
+    for (const img of images) {
+        if (!img || typeof img !== "object")
+            return "Each image must be an object";
+        const { data, mimeType, name } = img;
+        if (typeof data !== "string" || !data)
+            return "Each image must have a non-empty data string";
+        if (data.startsWith("data:"))
+            return "Image data must be raw base64, not a data URL";
+        if (data.length > MAX_IMAGE_DATA_BYTES)
+            return `Image too large (max ${MAX_IMAGE_DATA_BYTES / 1_048_576} MB per image)`;
+        if (!BASE64_RE.test(data))
+            return "Image data contains invalid base64 characters";
+        if (typeof mimeType !== "string" || !mimeType)
+            return "Each image must have a mimeType string";
+        if (!ALLOWED_IMAGE_MIME_TYPES.has(mimeType.toLowerCase()))
+            return `Unsupported image type: ${mimeType}`;
+        if (typeof name !== "string" || !name)
+            return "Each image must have a name string";
+        if (name.length > MAX_IMAGE_NAME_LENGTH)
+            return `Image name too long (max ${MAX_IMAGE_NAME_LENGTH} characters)`;
+    }
+    return null;
+}
+/**
+ * Builds in-memory and compact (DB-persisted) attachment arrays from
+ * validated images. Exported so it can be unit-tested independently.
+ */
+export function buildChatAttachments(images) {
+    if (!images?.length)
+        return { attachments: undefined, compactAttachments: undefined };
+    // Compact placeholder URL (no base64) keeps the LLM context lean. The raw
+    // image bytes are stashed in `_data`/`_mimeType` for action handlers (e.g.
+    // POST) that need to upload them.
+    const attachments = images.map((img, i) => ({
+        id: `img-${i}`,
+        url: `attachment:img-${i}`,
+        title: img.name,
+        source: "client_chat",
+        contentType: ContentType.IMAGE,
+        _data: img.data,
+        _mimeType: img.mimeType,
+    }));
+    // DB-persisted version omits _data/_mimeType so raw bytes aren't stored.
+    const compactAttachments = attachments.map(({ _data: _d, _mimeType: _m, ...rest }) => rest);
+    return { attachments, compactAttachments };
+}
+export function normalizeIncomingChatPrompt(text, images) {
+    const normalizedText = typeof text === "string" ? text.trim() : "";
+    if (normalizedText.length > 0) {
+        return normalizedText;
+    }
+    return Array.isArray(images) && images.length > 0
+        ? IMAGE_ONLY_CHAT_FALLBACK_PROMPT
+        : null;
+}
+/**
+ * Constructs the in-memory user message (with image data for action handlers)
+ * and the persistence-safe counterpart (image data stripped). Extracted to
+ * avoid duplicating this logic across the stream and non-stream chat endpoints.
+ */
+export function buildUserMessages(params) {
+    const { images, prompt, userId, agentId, roomId, channelType, conversationMode, messageSource, metadata, } = params;
+    const source = messageSource?.trim() || "client_chat";
+    const { attachments, compactAttachments } = buildChatAttachments(images);
+    const id = crypto.randomUUID();
+    // In-memory message carries _data/_mimeType so action handlers can upload.
+    const userMessage = createMessageMemory({
+        id,
+        entityId: userId,
+        agentId,
+        roomId,
+        content: {
+            text: prompt,
+            source,
+            channelType,
+            ...(conversationMode ? { conversationMode } : {}),
+            ...(attachments?.length ? { attachments } : {}),
+            ...(metadata ? { metadata } : {}),
+        },
+    });
+    // Persisted message: compact placeholder URL, no raw bytes in DB.
+    const messageToStore = compactAttachments?.length
+        ? createMessageMemory({
+            id,
+            entityId: userId,
+            agentId,
+            roomId,
+            content: {
+                text: prompt,
+                source,
+                channelType,
+                ...(conversationMode ? { conversationMode } : {}),
+                attachments: compactAttachments,
+                ...(metadata ? { metadata } : {}),
+            },
+        })
+        : userMessage;
+    return { userMessage, messageToStore };
+}

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

@@ -0,0 +1,124 @@
+/**
+ * Chat route handlers extracted from server.ts.
+ *
+ * Handles:
+ *   POST /v1/chat/completions   – OpenAI-compatible
+ *   POST /v1/messages           – Anthropic-compatible
+ *   GET  /v1/models             – OpenAI model listing
+ *   GET  /v1/models/:id         – OpenAI single model
+ *
+ * Also exports generateChatResponse() and supporting helpers so that
+ * conversation-routes.ts (and server.ts itself) can reuse them.
+ */
+import type http from "node:http";
+import { type AgentRuntime, ChannelType, type Content, createMessageMemory, type RouteRequestContext, type UUID } from "@elizaos/core";
+import { type LocalInferenceChatMetadata, type LocalInferenceCommandIntent } from "@elizaos/plugin-local-inference";
+import type { ReadJsonBodyOptions } from "@elizaos/shared";
+import type { ElizaConfig } from "../config/config.ts";
+export interface ChatGenerationResult {
+    text: string;
+    agentName: string;
+    noResponseReason?: "ignored";
+    failureKind?: ChatFailureKind;
+    localInference?: LocalInferenceChatMetadata;
+    usedActionCallbacks?: boolean;
+    actionCallbackHistory?: string[];
+    responseContent?: Content | null;
+    responseMessages?: Array<{
+        id?: string;
+        content?: Content;
+    }>;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        model?: string;
+        provider?: string;
+        isEstimated: boolean;
+        llmCalls: number;
+    };
+}
+export interface ChatGenerateOptions {
+    onChunk?: (chunk: string) => void;
+    onSnapshot?: (text: string) => void;
+    isAborted?: () => boolean;
+    resolveNoResponseText?: () => string;
+    preferredLanguage?: string;
+    timeoutDuration?: number;
+}
+export interface LogEntry {
+    timestamp: number;
+    level: string;
+    message: string;
+    source: string;
+    tags: string[];
+}
+export interface ChatImageAttachment {
+    /** Base64-encoded image data (no data URL prefix). */
+    data: string;
+    mimeType: string;
+    name: string;
+}
+export declare function resolveNoResponseFallback(logBuffer: LogEntry[], _runtime?: AgentRuntime | null, _lang?: string): string;
+export declare function getChatFailureReply(err: unknown, logBuffer: LogEntry[]): string;
+/**
+ * Discriminator the conversation route includes in its 200 response so the
+ * renderer can distinguish "provider configured but throwing" from "no
+ * provider configured at all" — the latter is a UX gate ("Connect a
+ * provider"), not a chat reply.
+ */
+export type ChatFailureKind = "insufficient_credits" | "no_provider" | "provider_issue" | "local_inference";
+export declare function classifyChatFailure(err: unknown, logBuffer: LogEntry[]): ChatFailureKind;
+export declare function detectLocalInferenceCommandIntent(text: string, options?: {
+    localInferenceContext?: boolean;
+}): LocalInferenceCommandIntent | null;
+export declare function isLocalInferenceError(err: unknown): boolean;
+export declare function normalizeChatResponseText(text: string, logBuffer: LogEntry[], runtime?: AgentRuntime | null): string;
+export declare function initSse(res: http.ServerResponse): void;
+export declare function writeSse(res: http.ServerResponse, payload: Record<string, unknown>): void;
+export declare function writeChatTokenSse(res: http.ServerResponse, text: string, fullText: string): void;
+export declare function writeSseData(res: http.ServerResponse, data: string, event?: string): void;
+export declare function writeSseJson(res: http.ServerResponse, payload: unknown, event?: string): void;
+export declare function persistConversationMemory(runtime: AgentRuntime, memory: ReturnType<typeof createMessageMemory>): Promise<void>;
+export declare function hasRecentVisibleAssistantMemorySince(runtime: AgentRuntime, roomId: UUID, sinceMs: number): Promise<boolean>;
+export declare function persistAssistantConversationMemory(runtime: AgentRuntime, roomId: UUID, content: string | Content, channelType: ChannelType, dedupeSinceMs?: number): Promise<void>;
+export declare function readChatRequestPayload(req: http.IncomingMessage, res: http.ServerResponse, helpers: {
+    readJsonBody: <T extends object>(req: http.IncomingMessage, res: http.ServerResponse, options?: ReadJsonBodyOptions) => Promise<T | null>;
+    error: (res: http.ServerResponse, message: string, status?: number) => void;
+}, 
+/** Body size limit. Image-capable endpoints pass CHAT_MAX_BODY_BYTES (20 MB);
+ *  legacy/cloud-proxy endpoints that don't process images pass MAX_BODY_BYTES (1 MB). */
+maxBytes?: number): Promise<{
+    prompt: string;
+    channelType: ChannelType;
+    images?: ChatImageAttachment[];
+    conversationMode?: "simple" | "power";
+    preferredLanguage?: string;
+    source?: string;
+    metadata?: Record<string, unknown>;
+} | null>;
+export declare function generateChatResponse(runtime: AgentRuntime, message: ReturnType<typeof createMessageMemory>, agentName: string, opts?: ChatGenerateOptions): Promise<ChatGenerationResult>;
+export declare function generateConversationTitle(runtime: AgentRuntime, userMessage: string, agentName: string): Promise<string | null>;
+export interface ChatRouteState {
+    runtime: AgentRuntime | null;
+    config: ElizaConfig;
+    agentName: string;
+    logBuffer: LogEntry[];
+    chatRoomId: UUID | null;
+    chatUserId: UUID | null;
+    chatConnectionReady: {
+        userId: UUID;
+        roomId: UUID;
+        worldId: UUID;
+    } | null;
+    chatConnectionPromise: Promise<void> | null;
+    adminEntityId: UUID | null;
+    /** Wallet trade permission mode for wallet-mode guidance replies. */
+    tradePermissionMode?: string;
+}
+export interface ChatRouteContext extends RouteRequestContext {
+    state: ChatRouteState;
+}
+export declare function resolveChatAdminEntityId(state: ChatRouteState): UUID;
+export declare function handleChatRoutes(ctx: ChatRouteContext): Promise<boolean>;
+//# sourceMappingURL=chat-routes.d.ts.map

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

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