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

package/packages/agent/src/api/bug-report-routes.d.ts

@@ -1,5 +1,8 @@
-import type { RouteRequestContext } from "./route-helpers";
-export declare const BUG_REPORT_REPO = "elizaos/eliza";
+import type { RouteRequestContext } from "@elizaos/core";
+export declare const DEFAULT_BUG_REPORT_REPO = "eliza-ai/eliza";
+export declare const BUG_REPORT_REPO_ENV_KEY = "ELIZA_BUG_REPORT_REPO";
+export declare function resolveBugReportRepo(env?: NodeJS.ProcessEnv): string;
+export declare const BUG_REPORT_REPO: string;
 export declare function rateLimitBugReport(ip: string | null): boolean;
 export declare function resetBugReportRateLimit(): void;
 export declare function sanitize(input: string, maxLen?: number): string;

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

@@ -1 +1 @@
-{"version":3,"file":"bug-report-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/bug-report-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAmB/C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAe7D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAaD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,GAAG,MAAM,CAE/D;AA6BD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,OAAO,CAAC,CAyElB"}
+{"version":3,"file":"bug-report-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/bug-report-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,eAAO,MAAM,uBAAuB,mBAAmB,CAAC;AACxD,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAU/D,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAMR;AAED,eAAO,MAAM,eAAe,QAAyB,CAAC;AAyBtD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAe7D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAwBD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,GAAG,MAAM,CAS/D;AAkKD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,OAAO,CAAC,CA2FlB"}

package/packages/agent/src/api/bug-report-routes.js

@@ -1,7 +1,27 @@
 import os from "node:os";
-export const BUG_REPORT_REPO = "elizaos/eliza";
-const GITHUB_ISSUES_URL = `https://api.github.com/repos/${BUG_REPORT_REPO}/issues`;
-const GITHUB_NEW_ISSUE_URL = `https://github.com/${BUG_REPORT_REPO}/issues/new?template=bug_report.yml`;
+export const DEFAULT_BUG_REPORT_REPO = "eliza-ai/eliza";
+export const BUG_REPORT_REPO_ENV_KEY = "ELIZA_BUG_REPORT_REPO";
+const BUG_REPORT_REPO_FALLBACK_ENV_KEY = "BUG_REPORT_REPO";
+function sanitizeRepoName(value) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return null;
+    if (!/^[\w.-]+\/[\w.-]+$/.test(trimmed))
+        return null;
+    return trimmed;
+}
+export function resolveBugReportRepo(env = process.env) {
+    return (sanitizeRepoName(env[BUG_REPORT_REPO_ENV_KEY]) ??
+        sanitizeRepoName(env[BUG_REPORT_REPO_FALLBACK_ENV_KEY]) ??
+        DEFAULT_BUG_REPORT_REPO);
+}
+export const BUG_REPORT_REPO = resolveBugReportRepo();
+function getGithubIssuesUrl(repo) {
+    return `https://api.github.com/repos/${repo}/issues`;
+}
+function getGithubNewIssueUrl(repo) {
+    return `https://github.com/${repo}/issues/new?template=bug_report.yml`;
+}
 const BUG_REPORT_WINDOW_MS = 10 * 60 * 1000;
 const BUG_REPORT_MAX_SUBMISSIONS = 5;
 const bugReportAttempts = new Map();
@@ -34,7 +54,21 @@ export function resetBugReportRateLimit() {
     bugReportAttempts.clear();
 }
 export function sanitize(input, maxLen = 10_000) {
-    return input.replace(/<[^>]*>/g, "").slice(0, maxLen);
+    const clipped = input.length > maxLen ? input.slice(0, maxLen) : input;
+    let prev = clipped;
+    let next = prev.replace(/<[^<>]{0,1024}>/g, "");
+    while (next !== prev) {
+        prev = next;
+        next = prev.replace(/<[^<>]{0,1024}>/g, "");
+    }
+    return next.replace(/[<>]/g, "").slice(0, maxLen);
+}
+function redactSecrets(input, maxLen = 10_000) {
+    const sanitized = sanitize(input, maxLen);
+    return sanitized
+        .replace(/\b(0x[a-fA-F0-9]{64}|[A-Za-z0-9+/]{80,}={0,2})\b/g, "[redacted-secret]")
+        .replace(/\b(sk-[A-Za-z0-9_-]{10,}|ghp_[A-Za-z0-9]{20,}|xox[baprs]-[A-Za-z0-9-]{10,})\b/g, "[redacted-token]")
+        .replace(/\b(mnemonic|private[_ -]?key|seed phrase)\b\s*[:=]\s*.+/gi, "$1: [redacted]");
 }
 function formatIssueBody(body) {
     const sections = [];
@@ -56,16 +90,115 @@ function formatIssueBody(body) {
         sections.push(`### Model Provider\n\n${sanitize(body.modelProvider, 200)}`);
     }
     if (body.logs) {
-        sections.push(`### Logs\n\n\`\`\`\n${sanitize(body.logs, 50_000)}\n\`\`\``);
+        sections.push(`### Logs\n\n\`\`\`\n${redactSecrets(body.logs, 50_000)}\n\`\`\``);
+    }
+    if (body.startup) {
+        sections.push(`### Startup Context\n\n\`\`\`json\n${JSON.stringify({
+            reason: body.startup.reason,
+            phase: body.startup.phase,
+            status: body.startup.status,
+            path: body.startup.path,
+        }, null, 2)}\n\`\`\``);
     }
     return sections.join("\n\n");
 }
+function getBugReportMode() {
+    if (getRemoteBugReportUrl())
+        return "remote";
+    if (process.env.GITHUB_TOKEN)
+        return "github";
+    return "fallback";
+}
+function getRemoteBugReportUrl() {
+    return (process.env.ELIZA_BUG_REPORT_API_URL ??
+        process.env.ELIZA_CLOUD_BUG_REPORT_URL);
+}
+function getRemoteBugReportToken() {
+    return (process.env.ELIZA_BUG_REPORT_API_TOKEN ??
+        process.env.ELIZA_CLOUD_BUG_REPORT_TOKEN);
+}
+async function submitToRemoteBugIntake(body) {
+    const remoteBugReportUrl = getRemoteBugReportUrl();
+    if (!remoteBugReportUrl)
+        return null;
+    const payload = {
+        source: "eliza-desktop",
+        submittedAt: new Date().toISOString(),
+        category: body.category ?? "general",
+        description: sanitize(body.description, 500),
+        stepsToReproduce: sanitize(body.stepsToReproduce, 10_000),
+        expectedBehavior: body.expectedBehavior
+            ? sanitize(body.expectedBehavior, 10_000)
+            : undefined,
+        actualBehavior: body.actualBehavior
+            ? sanitize(body.actualBehavior, 10_000)
+            : undefined,
+        environment: body.environment ? sanitize(body.environment, 200) : undefined,
+        nodeVersion: body.nodeVersion ? sanitize(body.nodeVersion, 200) : undefined,
+        modelProvider: body.modelProvider
+            ? sanitize(body.modelProvider, 200)
+            : undefined,
+        appVersion: body.appVersion ? sanitize(body.appVersion, 200) : undefined,
+        releaseChannel: body.releaseChannel
+            ? sanitize(body.releaseChannel, 200)
+            : undefined,
+        logs: body.logs ? redactSecrets(body.logs, 50_000) : undefined,
+        startup: body.startup
+            ? {
+                reason: body.startup.reason
+                    ? sanitize(body.startup.reason, 120)
+                    : undefined,
+                phase: body.startup.phase
+                    ? sanitize(body.startup.phase, 120)
+                    : undefined,
+                message: body.startup.message
+                    ? redactSecrets(body.startup.message, 1_000)
+                    : undefined,
+                detail: body.startup.detail
+                    ? redactSecrets(body.startup.detail, 10_000)
+                    : undefined,
+                status: body.startup.status,
+                path: body.startup.path
+                    ? sanitize(body.startup.path, 500)
+                    : undefined,
+            }
+            : undefined,
+    };
+    const response = await fetch(remoteBugReportUrl, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            ...(getRemoteBugReportToken()
+                ? { Authorization: `Bearer ${getRemoteBugReportToken()}` }
+                : {}),
+        },
+        body: JSON.stringify(payload),
+    });
+    if (!response.ok) {
+        throw new Error(`Remote intake error (${response.status})`);
+    }
+    const contentType = response.headers.get("content-type") ?? "";
+    if (contentType.includes("application/json")) {
+        const data = (await response.json());
+        return {
+            accepted: data.accepted ?? true,
+            id: data.id,
+            url: data.url,
+            destination: "remote",
+        };
+    }
+    return { accepted: true, destination: "remote" };
+}
 export async function handleBugReportRoutes(ctx) {
     const { req, res, method, pathname, json, error, readJsonBody } = ctx;
+    const bugReportRepo = resolveBugReportRepo();
+    const githubIssuesUrl = getGithubIssuesUrl(bugReportRepo);
+    const githubNewIssueUrl = getGithubNewIssueUrl(bugReportRepo);
     if (method === "GET" && pathname === "/api/bug-report/info") {
         json(res, {
             nodeVersion: process.version,
             platform: os.platform(),
+            submissionMode: getBugReportMode(),
         });
         return true;
     }
@@ -81,15 +214,29 @@ export async function handleBugReportRoutes(ctx) {
             error(res, "description and stepsToReproduce are required", 400);
             return true;
         }
+        if (getRemoteBugReportUrl()) {
+            try {
+                const result = await submitToRemoteBugIntake(body);
+                if (!result) {
+                    error(res, "Failed to submit bug report", 502);
+                    return true;
+                }
+                json(res, result);
+            }
+            catch {
+                error(res, "Failed to submit bug report", 502);
+            }
+            return true;
+        }
         const githubToken = process.env.GITHUB_TOKEN;
         if (!githubToken) {
-            json(res, { fallback: GITHUB_NEW_ISSUE_URL });
+            json(res, { fallback: githubNewIssueUrl });
             return true;
         }
         try {
             const sanitizedTitle = sanitize(body.description, 80).replace(/[\r\n]+/g, " ");
             const issueBody = formatIssueBody(body);
-            const issueRes = await fetch(GITHUB_ISSUES_URL, {
+            const issueRes = await fetch(githubIssuesUrl, {
                 method: "POST",
                 headers: {
                     Authorization: `Bearer ${githubToken}`,
@@ -109,7 +256,7 @@ export async function handleBugReportRoutes(ctx) {
             const issueData = (await issueRes.json());
             const url = issueData.html_url;
             if (typeof url !== "string" ||
-                !url.startsWith(`https://github.com/${BUG_REPORT_REPO}/issues/`)) {
+                !url.startsWith(`https://github.com/${bugReportRepo}/issues/`)) {
                 error(res, "Unexpected response from GitHub API", 502);
                 return true;
             }

package/packages/agent/src/api/build-variant-routes.d.ts

@@ -0,0 +1,27 @@
+/**
+ * GET /api/build/variant
+ *
+ * Tiny endpoint that exposes the desktop build variant + platform so the
+ * renderer can drive variant-conditional UI (e.g. greying out "Local" in
+ * sandboxed store builds).
+ *
+ * Reads MILADY_BUILD_VARIANT directly here rather than going through the
+ * dynamic @elizaos/app-core import — the API server boots before the agent
+ * runtime, so the canonical accessor module isn't loaded yet, but the env
+ * var is set by the desktop-build orchestrator.
+ */
+import type http from "node:http";
+export type BuildVariant = "store" | "direct";
+export interface BuildVariantResponse {
+    variant: BuildVariant;
+    platform: NodeJS.Platform;
+}
+export interface BuildVariantRouteContext {
+    req: http.IncomingMessage;
+    res: http.ServerResponse;
+    method: string;
+    pathname: string;
+    json: (res: http.ServerResponse, data: unknown, status?: number) => void;
+}
+export declare function handleBuildVariantRoutes(ctx: BuildVariantRouteContext): boolean;
+//# sourceMappingURL=build-variant-routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-variant-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/build-variant-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC3B;AAMD,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC;IAC1B,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1E;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,wBAAwB,GAC5B,OAAO,CAaT"}

package/packages/agent/src/api/build-variant-routes.js

@@ -0,0 +1,27 @@
+/**
+ * GET /api/build/variant
+ *
+ * Tiny endpoint that exposes the desktop build variant + platform so the
+ * renderer can drive variant-conditional UI (e.g. greying out "Local" in
+ * sandboxed store builds).
+ *
+ * Reads MILADY_BUILD_VARIANT directly here rather than going through the
+ * dynamic @elizaos/app-core import — the API server boots before the agent
+ * runtime, so the canonical accessor module isn't loaded yet, but the env
+ * var is set by the desktop-build orchestrator.
+ */
+function resolveBuildVariant() {
+    return process.env.MILADY_BUILD_VARIANT === "store" ? "store" : "direct";
+}
+export function handleBuildVariantRoutes(ctx) {
+    const { res, method, pathname, json } = ctx;
+    if (method === "GET" && pathname === "/api/build/variant") {
+        const payload = {
+            variant: resolveBuildVariant(),
+            platform: process.platform,
+        };
+        json(res, payload);
+        return true;
+    }
+    return false;
+}

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

@@ -1,5 +1,5 @@
 import type { AgentRuntime } from "@elizaos/core";
-import type { RouteRequestContext } from "./route-helpers";
+import type { RouteRequestContext } from "@elizaos/shared";
 interface AgentConfigLike {
     id?: string;
     default?: boolean;
@@ -16,13 +16,14 @@ interface AgentConfigLike {
     messageExamples?: unknown;
     postExamples?: string[];
 }
-export interface AutonomousConfigLike {
+import type { AutonomousConfigLike } from "../types/config-like.ts";
+export interface CharacterAutonomousConfigLike extends AutonomousConfigLike {
     agents?: {
         list?: AgentConfigLike[];
     };
 }
 interface CharacterParseIssueLike {
-    path: Array<string | number>;
+    path: PropertyKey[];
     message: string;
 }
 interface CharacterParseErrorLike {
@@ -30,6 +31,7 @@ interface CharacterParseErrorLike {
 }
 type CharacterValidationResult = {
     success: true;
+    data?: unknown;
 } | {
     success: false;
     error: CharacterParseErrorLike;
@@ -37,12 +39,12 @@ type CharacterValidationResult = {
 export interface CharacterRouteState {
     runtime: AgentRuntime | null;
     agentName: string;
-    config?: AutonomousConfigLike;
+    config?: CharacterAutonomousConfigLike;
 }
 export interface CharacterRouteContext extends RouteRequestContext {
     state: CharacterRouteState;
     pickRandomNames: (count: number) => string[];
-    saveConfig?: (config: AutonomousConfigLike) => void;
+    saveConfig?: (config: CharacterAutonomousConfigLike) => void;
     validateCharacter: (body: Record<string, unknown>) => CharacterValidationResult;
 }
 export declare function handleCharacterRoutes(ctx: CharacterRouteContext): Promise<boolean>;

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

@@ -1 +1 @@
-{"version":3,"file":"character-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/character-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAmB3D,UAAU,eAAe;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE;QACN,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;KAC1B,CAAC;CACH;AAED,UAAU,uBAAuB;IAC/B,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,uBAAuB;IAC/B,MAAM,EAAE,uBAAuB,EAAE,CAAC;CACnC;AAED,KAAK,yBAAyB,GAC1B;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,uBAAuB,CAAA;CAAE,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,KAAK,EAAE,mBAAmB,CAAC;IAC3B,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAC7C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACpD,iBAAiB,EAAE,CACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,yBAAyB,CAAC;CAChC;AA2LD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,OAAO,CAAC,CA6LlB"}
+{"version":3,"file":"character-routes.d.ts","sourceRoot":"","sources":["../../../../../src/api/character-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAyB3D,UAAU,eAAe;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE;QACN,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,WAAW,6BAA8B,SAAQ,oBAAoB;IACzE,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;KAC1B,CAAC;CACH;AAED,UAAU,uBAAuB;IAC/B,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,uBAAuB;IAC/B,MAAM,EAAE,uBAAuB,EAAE,CAAC;CACnC;AAED,KAAK,yBAAyB,GAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,uBAAuB,CAAA;CAAE,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,6BAA6B,CAAC;CACxC;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,KAAK,EAAE,mBAAmB,CAAC;IAC3B,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAC7C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,6BAA6B,KAAK,IAAI,CAAC;IAC7D,iBAAiB,EAAE,CACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,yBAAyB,CAAC;CAChC;AAqQD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,OAAO,CAAC,CA+MlB"}

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

@@ -1,4 +1,49 @@
-import { logger, ModelType } from "@elizaos/core";
+import { ModelType } from "@elizaos/core";
+import { buildCharacterHistorySnapshot, listCharacterHistory, recordCharacterHistory, } from "../services/character-history.js";
+function replaceCharacterNameTokens(value, nextName) {
+    return value
+        .replaceAll("{{agentName}}", nextName)
+        .replaceAll("{{name}}", nextName);
+}
+function shouldRewriteExampleSpeakerName(speakerName, previousName) {
+    const normalized = speakerName.trim().toLowerCase();
+    if (!normalized)
+        return false;
+    if (normalized === "{{agentname}}" ||
+        normalized === "{{name}}" ||
+        normalized === "assistant" ||
+        normalized === "agent" ||
+        normalized === "ai" ||
+        normalized === "model") {
+        return true;
+    }
+    if (previousName?.trim()) {
+        return normalized === previousName.trim().toLowerCase();
+    }
+    return false;
+}
+function normalizeCharacterMessageExamplesForName(messageExamples, nextName, previousName) {
+    if (!Array.isArray(messageExamples)) {
+        return undefined;
+    }
+    return messageExamples.map((group) => {
+        const examples = Array.isArray(group?.examples)
+            ? group.examples
+            : [];
+        return {
+            examples: examples.map((example) => ({
+                ...example,
+                name: shouldRewriteExampleSpeakerName(example.name, previousName)
+                    ? nextName
+                    : replaceCharacterNameTokens(example.name, nextName),
+                content: {
+                    ...example.content,
+                    text: replaceCharacterNameTokens(example.content.text, nextName),
+                },
+            })),
+        };
+    });
+}
 function syncRuntimeCharacterToConfig(state, saveConfig) {
     const runtime = state.runtime;
     const config = state.config;
@@ -78,7 +123,7 @@ function buildGeneratePrompt(field, context, mode) {
         return `Given this character:\n${charSummary}${existing}\n\nGenerate 4-6 communication style rules for this character. Output a JSON object with keys "all", "chat", "post", each containing an array of short rule strings. Just output the JSON, nothing else.`;
     }
     if (field === "chatExamples") {
-        return `Given this character:\n${charSummary}\n\nGenerate 3 example chat conversations showing how this character responds. Output strict JSON only, with no markdown fences and no explanation. The JSON must be an array of conversation groups using this exact schema:\n[\n  {\n    "examples": [\n      { "name": "{{user1}}", "content": { "text": "..." } },\n      { "name": "${context.name?.trim() || "{{agentName}}"}", "content": { "text": "..." } }\n    ]\n  }\n]\n\nEach conversation should contain 2-4 turns. Use the "name" field, not "user" or "role". Use content.text strings only.`;
+        return `Given this character:\n${charSummary}\n\nGenerate 3 example chat conversations showing how this character responds. Output strict JSON only, with no markdown fences and no explanation. The JSON must be an array of conversation groups using this exact schema:\n[\n  {\n    "examples": [\n      { "name": "{{user1}}", "content": { "text": "..." } },\n      { "name": "{{agentName}}", "content": { "text": "..." } }\n    ]\n  }\n]\n\nEach conversation should contain 2-4 turns. Use the "name" field, not "user" or "role". Use content.text strings only.`;
     }
     const existing = mode === "append" && context.postExamples?.length
         ? `\nExisting posts (add new ones, don't repeat):\n${context.postExamples.join("\n")}`
@@ -166,6 +211,19 @@ const CHARACTER_SCHEMA_FIELDS = [
 ];
 export async function handleCharacterRoutes(ctx) {
     const { req, res, method, pathname, state, saveConfig, readJsonBody, json, error, pickRandomNames, validateCharacter, } = ctx;
+    if (method === "GET" && pathname === "/api/character/history") {
+        if (!state.runtime) {
+            json(res, { history: [], agentName: state.agentName });
+            return true;
+        }
+        const url = new URL(req.url ?? pathname, "http://localhost");
+        const rawLimit = url.searchParams.get("limit");
+        const parsedLimit = rawLimit ? Number.parseInt(rawLimit, 10) : 20;
+        const limit = Number.isFinite(parsedLimit) ? parsedLimit : 20;
+        const history = await listCharacterHistory(state.runtime, limit);
+        json(res, { history, agentName: state.agentName });
+        return true;
+    }
     if (method === "GET" && pathname === "/api/character") {
         const runtime = state.runtime;
         const merged = {};
@@ -211,6 +269,13 @@ export async function handleCharacterRoutes(ctx) {
         }
         if (state.runtime) {
             const character = state.runtime.character;
+            const previousCharacter = buildCharacterHistorySnapshot(character);
+            const previousCharacterName = typeof character.name === "string" ? character.name : undefined;
+            const nextCharacterName = typeof body.name === "string" && body.name.trim()
+                ? body.name.trim()
+                : typeof character.name === "string" && character.name.trim()
+                    ? character.name.trim()
+                    : state.agentName;
             if (body.name != null)
                 character.name = String(body.name);
             if (body.username != null)
@@ -232,48 +297,41 @@ export async function handleCharacterRoutes(ctx) {
                 character.style = body.style;
             }
             if (body.messageExamples != null) {
-                character.messageExamples = body.messageExamples;
+                character.messageExamples = normalizeCharacterMessageExamplesForName(body.messageExamples, nextCharacterName, previousCharacterName);
+            }
+            else if (body.name != null) {
+                const normalizedExamples = normalizeCharacterMessageExamplesForName(character.messageExamples, nextCharacterName, previousCharacterName);
+                if (normalizedExamples) {
+                    character.messageExamples = normalizedExamples;
+                }
             }
             if (body.postExamples != null) {
                 character.postExamples = body.postExamples;
             }
             // Persist character fields to DB so edits survive restarts
-            try {
-                const charData = {
-                    name: character.name,
-                    bio: character.bio,
-                    system: character.system,
-                    adjectives: character.adjectives,
-                    topics: character.topics,
-                    style: character.style,
-                    messageExamples: character.messageExamples,
-                    postExamples: character.postExamples,
-                };
-                await state.runtime.updateAgent(state.runtime.agentId, {
-                    name: character.name,
-                    metadata: {
-                        ...state.runtime.character.metadata,
-                        character: charData,
-                    },
-                });
-            }
-            catch (dbErr) {
-                // Non-fatal: config sync below is the legacy fallback
-                logger.warn(`[character-routes] Failed to persist character to DB: ${dbErr instanceof Error ? dbErr.message : dbErr}`);
-            }
-        }
-        try {
-            syncRuntimeCharacterToConfig(state, saveConfig);
-        }
-        catch (err) {
-            error(res, err instanceof Error
-                ? `Failed to persist character: ${err.message}`
-                : "Failed to persist character", 500);
-            return true;
+            const charData = buildCharacterHistorySnapshot(character);
+            await state.runtime.updateAgent(state.runtime.agentId, {
+                name: character.name,
+                metadata: {
+                    ...state.runtime.character
+                        .metadata,
+                    character: charData,
+                },
+            });
+            await recordCharacterHistory(state.runtime, {
+                previousCharacter,
+                nextCharacter: character,
+                source: "manual",
+            });
         }
+        syncRuntimeCharacterToConfig(state, saveConfig);
         if (body.name)
             state.agentName = String(body.name);
-        json(res, { ok: true, character: body, agentName: state.agentName });
+        json(res, {
+            ok: true,
+            character: state.runtime?.character ?? body,
+            agentName: state.agentName,
+        });
         return true;
     }
     if (method === "GET" && pathname === "/api/character/random-name") {
@@ -303,19 +361,12 @@ export async function handleCharacterRoutes(ctx) {
             return true;
         }
         const prompt = buildGeneratePrompt(body.field, body.context, body.mode);
-        try {
-            const result = await runtime.useModel(ModelType.TEXT_SMALL, {
-                prompt,
-                temperature: 0.8,
-                maxTokens: 1500,
-            });
-            json(res, { generated: String(result) });
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : "generation failed";
-            logger.error(`[character-generate] ${message}`);
-            error(res, message, 500);
-        }
+        const result = await runtime.useModel(ModelType.TEXT_SMALL, {
+            prompt,
+            temperature: 0.8,
+            maxTokens: 1500,
+        });
+        json(res, { generated: String(result) });
         return true;
     }
     if (method === "GET" && pathname === "/api/character/schema") {

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

@@ -0,0 +1,70 @@
+/**
+ * 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 { type AgentRuntime, type ChannelType, createMessageMemory, type Media, type UUID } from "@elizaos/core";
+export declare function maybeAugmentChatMessageWithLanguage(message: ReturnType<typeof createMessageMemory>, preferredLanguage?: string): ReturnType<typeof createMessageMemory>;
+export declare function getErrorMessage(err: unknown, fallback?: string): string;
+export declare function buildAgentAwarenessContextPrompt(runtime: AgentRuntime, userPrompt: string): Promise<string>;
+export declare function maybeAugmentChatMessageWithAgentAwareness(runtime: AgentRuntime, message: ReturnType<typeof createMessageMemory>): Promise<ReturnType<typeof createMessageMemory>>;
+export declare function maybeAugmentChatMessageWithDocuments(runtime: AgentRuntime, message: ReturnType<typeof createMessageMemory>): Promise<ReturnType<typeof createMessageMemory>>;
+export interface ChatImageAttachment {
+    /** Base64-encoded image data (no data URL prefix). */
+    data: string;
+    mimeType: string;
+    name: string;
+}
+export declare 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 declare function validateChatImages(images: unknown): string | null;
+/**
+ * Extension of the core Media attachment shape that carries raw image bytes for
+ * action handlers (e.g. POST) while the message is in-memory. The
+ * extra fields are intentionally stripped before the message is persisted.
+ *
+ * Note: `_data`/`_mimeType` survive only because elizaOS passes the
+ * `userMessage` object reference directly to action handlers without
+ * deep-cloning or serializing it. If that ever changes, action handlers
+ * that read these fields will silently receive `undefined`.
+ */
+export interface ChatAttachmentWithData extends Media {
+    /** Raw base64 image data — never written to the database. */
+    _data: string;
+    /** MIME type corresponding to `_data`. */
+    _mimeType: string;
+}
+/**
+ * Builds in-memory and compact (DB-persisted) attachment arrays from
+ * validated images. Exported so it can be unit-tested independently.
+ */
+export declare function buildChatAttachments(images: ChatImageAttachment[] | undefined): {
+    /** In-memory attachments that include `_data`/`_mimeType` for action handlers. */
+    attachments: ChatAttachmentWithData[] | undefined;
+    /** Persistence-safe attachments with `_data`/`_mimeType` stripped. */
+    compactAttachments: Media[] | undefined;
+};
+export declare function normalizeIncomingChatPrompt(text: string | null | undefined, images: ChatImageAttachment[] | null | undefined): string | null;
+type MessageMemory = ReturnType<typeof createMessageMemory>;
+/**
+ * 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 declare function buildUserMessages(params: {
+    images: ChatImageAttachment[] | undefined;
+    prompt: string;
+    userId: UUID;
+    agentId: UUID;
+    roomId: UUID;
+    channelType: ChannelType;
+    conversationMode?: "simple" | "power";
+    messageSource?: string;
+    metadata?: Record<string, unknown>;
+}): {
+    userMessage: MessageMemory;
+    messageToStore: MessageMemory;
+};
+export {};
+//# sourceMappingURL=chat-augmentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-augmentation.d.ts","sourceRoot":"","sources":["../../../../../src/api/chat-augmentation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAGhB,mBAAmB,EACnB,KAAK,KAAK,EAGV,KAAK,IAAI,EACV,MAAM,eAAe,CAAC;AAgCvB,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAC/C,iBAAiB,CAAC,EAAE,MAAM,GACzB,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAexC;AAMD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,EACZ,QAAQ,SAAsB,GAC7B,MAAM,CAIR;AAuFD,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAwDjB;AAED,wBAAsB,yCAAyC,CAC7D,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAC9C,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAejD;AAED,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,GAC9C,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAwMjD;AAMD,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAoBD,eAAO,MAAM,+BAA+B,wCACL,CAAC;AAExC,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAyBjE;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAuB,SAAQ,KAAK;IACnD,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,mBAAmB,EAAE,GAAG,SAAS,GACxC;IACD,kFAAkF;IAClF,WAAW,EAAE,sBAAsB,EAAE,GAAG,SAAS,CAAC;IAClD,sEAAsE;IACtE,kBAAkB,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;CACzC,CAoBA;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,MAAM,EAAE,mBAAmB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,GAAG,IAAI,CAQf;AAED,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,MAAM,EAAE,mBAAmB,EAAE,GAAG,SAAS,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG;IAAE,WAAW,EAAE,aAAa,CAAC;IAAC,cAAc,EAAE,aAAa,CAAA;CAAE,CAgDhE"}