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

package/packages/agent/src/providers/user-name.d.ts

@@ -0,0 +1,11 @@
+/**
+ * User name provider — injects the user's display name into the system prompt
+ * when chatting via the app (client_chat). Tells the agent the user's name if
+ * known, or hints that it can ask.
+ *
+ * Only active for `source === "client_chat"` so it never leaks into Telegram,
+ * Discord, or other connectors.
+ */
+import type { Provider } from "@elizaos/core";
+export declare function createUserNameProvider(): Provider;
+//# sourceMappingURL=user-name.d.ts.map

package/packages/agent/src/providers/user-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-name.d.ts","sourceRoot":"","sources":["../../../../../src/providers/user-name.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAGV,QAAQ,EAGT,MAAM,eAAe,CAAC;AAIvB,wBAAgB,sBAAsB,IAAI,QAAQ,CA8CjD"}

package/packages/agent/src/providers/user-name.js

@@ -0,0 +1,46 @@
+/**
+ * User name provider — injects the user's display name into the system prompt
+ * when chatting via the app (client_chat). Tells the agent the user's name if
+ * known, or hints that it can ask.
+ *
+ * Only active for `source === "client_chat"` so it never leaks into Telegram,
+ * Discord, or other connectors.
+ */
+import { hasOwnerAccess } from "../security/access.js";
+import { fetchConfiguredOwnerName } from "../services/owner-name.js";
+export function createUserNameProvider() {
+    return {
+        name: "userName",
+        description: "Injects the app user's display name into context (app chat only).",
+        descriptionCompressed: "inject app user display name context (app chat)",
+        position: 10,
+        dynamic: true,
+        contexts: ["general"],
+        contextGate: { anyOf: ["general"] },
+        cacheStable: false,
+        cacheScope: "turn",
+        roleGate: { minRole: "USER" },
+        async get(runtime, message, _state) {
+            const content = message.content;
+            if (content?.source !== "client_chat") {
+                return { text: "" };
+            }
+            if (!(await hasOwnerAccess(runtime, message))) {
+                return { text: "" };
+            }
+            const name = await fetchConfiguredOwnerName();
+            if (name) {
+                return {
+                    text: `The user's name is ${name}.`,
+                    values: { userName: name },
+                };
+            }
+            return {
+                text: "No preferred user name is stored yet. The current fallback label is admin. " +
+                    "If it comes up naturally in conversation, you can ask what " +
+                    "they'd like to be called and use the SETTINGS action with op=set_owner_name to remember it.",
+                values: { userName: "admin", userNameFallback: true },
+            };
+        },
+    };
+}

package/packages/agent/src/providers/workspace-provider.d.ts

@@ -1,20 +1,12 @@
 /**
  * Reads workspace init files and injects them into agent context.
  *
- * Also provides coding agent context enrichment: when coding-agent metadata
+ * Also provides task-agent context enrichment: when task-agent metadata
  * is present on the inbound message, the provider appends a summary of the
- * current coding session state (active iteration, recent errors, pending
- * feedback) so the LLM has full awareness during the autonomous coding loop.
+ * current task-agent session state (active iteration, recent errors, pending
+ * feedback) so the LLM has full awareness during autonomous background work.
  */
 import { type Provider } from "@elizaos/core";
-import type { CodingAgentContext } from "../services/coding-agent-context";
-import { type WorkspaceInitFile } from "./workspace";
-/** @internal Exported for testing. */
-export declare function truncate(content: string, max: number): string;
-/** @internal Exported for testing. */
-export declare function buildContext(files: WorkspaceInitFile[], maxChars: number): string;
-/** @internal Exported for testing. Builds a summary of the coding agent session. */
-export declare function buildCodingAgentSummary(ctx: CodingAgentContext): string;
 export declare function createWorkspaceProvider(options?: {
     workspaceDir?: string;
     maxCharsPerFile?: number;

package/packages/agent/src/providers/workspace-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-provider.d.ts","sourceRoot":"","sources":["../../../../../src/providers/workspace-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAKL,KAAK,QAAQ,EAGd,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAgCrB,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EAAE,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CAyBR;AAED,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CA2DvE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,QAAQ,CAsDX"}
+{"version":3,"file":"workspace-provider.d.ts","sourceRoot":"","sources":["../../../../../src/providers/workspace-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAKL,KAAK,QAAQ,EAGd,MAAM,eAAe,CAAC;AA8IvB,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,QAAQ,CAqEX"}

package/packages/agent/src/providers/workspace-provider.js

@@ -1,13 +1,14 @@
 /**
  * Reads workspace init files and injects them into agent context.
  *
- * Also provides coding agent context enrichment: when coding-agent metadata
+ * Also provides task-agent context enrichment: when task-agent metadata
  * is present on the inbound message, the provider appends a summary of the
- * current coding session state (active iteration, recent errors, pending
- * feedback) so the LLM has full awareness during the autonomous coding loop.
+ * current task-agent session state (active iteration, recent errors, pending
+ * feedback) so the LLM has full awareness during autonomous background work.
  */
 import { ChannelType, logger, } from "@elizaos/core";
-import { DEFAULT_AGENT_WORKSPACE_DIR, filterInitFilesForSession, isDefaultBoilerplate, loadWorkspaceInitFiles, } from "./workspace";
+import { hasAdminAccess } from "../security/access.js";
+import { filterInitFilesForSession, isDefaultBoilerplate, loadWorkspaceInitFiles, resolveDefaultAgentWorkspaceDir, } from "./workspace.js";
 const DEFAULT_MAX_CHARS = 20_000;
 /** Hard cap on total workspace context to prevent prompt explosion. */
 const MAX_TOTAL_WORKSPACE_CHARS = 100_000;
@@ -70,10 +71,10 @@ export function buildContext(files, maxChars) {
         return "";
     return `## Project Context (Workspace)\n\n${sections.join("\n\n---\n\n")}`;
 }
-/** @internal Exported for testing. Builds a summary of the coding agent session. */
+/** @internal Exported for testing. Builds a summary of the task-agent session. */
 export function buildCodingAgentSummary(ctx) {
     const lines = [];
-    lines.push("## Coding Agent Session");
+    lines.push("## Task Agent Session");
     lines.push("");
     lines.push(`**Task:** ${ctx.taskDescription}`);
     lines.push(`**Working Directory:** ${ctx.workingDirectory}`);
@@ -98,7 +99,8 @@ export function buildCodingAgentSummary(ctx) {
         }
     }
     // Human feedback
-    const pendingFeedback = ctx.allFeedback.filter((fb) => !fb.iterationRef || fb.iterationRef >= ctx.iterations.length - 1);
+    const pendingFeedback = ctx.allFeedback.filter((fb) => fb.iterationRef !== undefined &&
+        fb.iterationRef >= ctx.iterations.length - 1);
     if (pendingFeedback.length > 0) {
         lines.push("");
         lines.push("### Human Feedback");
@@ -124,12 +126,17 @@ export function buildCodingAgentSummary(ctx) {
     return lines.join("\n");
 }
 export function createWorkspaceProvider(options) {
-    const dir = options?.workspaceDir ?? DEFAULT_AGENT_WORKSPACE_DIR;
+    const dir = options?.workspaceDir ?? resolveDefaultAgentWorkspaceDir();
     const maxChars = options?.maxCharsPerFile ?? DEFAULT_MAX_CHARS;
     return {
         name: "workspaceContext",
-        description: "Workspace init files (AGENTS.md, TOOLS.md, IDENTITY.md, etc.) and coding agent context",
+        description: "Workspace init files (AGENTS.md, TOOLS.md, IDENTITY.md, etc.) and task-agent context",
         position: 10,
+        contexts: ["general"],
+        contextGate: { anyOf: ["general"] },
+        cacheStable: false,
+        cacheScope: "turn",
+        roleGate: { minRole: "USER" },
         async get(_runtime, message, _state) {
             const channelType = message.content?.channelType;
             if (channelType === ChannelType.VOICE_DM ||
@@ -142,6 +149,15 @@ export function createWorkspaceProvider(options) {
                     },
                 };
             }
+            if (!(await hasAdminAccess(_runtime, message))) {
+                return {
+                    text: "",
+                    data: {
+                        workspaceDir: dir,
+                        skipped: "role_gate",
+                    },
+                };
+            }
             try {
                 const allFiles = await getFiles(dir);
                 const meta = message.metadata;
@@ -156,9 +172,9 @@ export function createWorkspaceProvider(options) {
                 };
             }
             catch (err) {
-                logger.warn(`[workspace-provider] Failed to load workspace context: ${err instanceof Error ? err.message : err}`);
+                logger.warn(`[workspace-provider] Failed to load workspace context: ${String(err)}`);
                 return {
-                    text: `[Workspace context unavailable: ${err instanceof Error ? err.message : err}]`,
+                    text: `[Workspace context unavailable: ${String(err)}]`,
                     data: {},
                 };
             }

package/packages/agent/src/providers/workspace.d.ts

@@ -1,3 +1,5 @@
+import { DEFAULT_AGENT_WORKSPACE_DIR, resolveDefaultAgentWorkspaceDir, shouldBootstrapWorkspaceInitFiles, shouldUseRuntimeCwdWorkspace } from "../shared/workspace-resolution.ts";
+export { DEFAULT_AGENT_WORKSPACE_DIR, resolveDefaultAgentWorkspaceDir, shouldBootstrapWorkspaceInitFiles, shouldUseRuntimeCwdWorkspace, };
 export interface RunCommandResult {
     code: number;
     stdout: string;
@@ -14,8 +16,6 @@ export interface RunCommandOptions {
  * Rejects if the process cannot be spawned or the timeout fires.
  */
 export declare function runCommandWithTimeout(argv: string[], opts?: RunCommandOptions): Promise<RunCommandResult>;
-export declare function resolveDefaultAgentWorkspaceDir(env?: NodeJS.ProcessEnv, homedir?: () => string): string;
-export declare const DEFAULT_AGENT_WORKSPACE_DIR: string;
 declare const DEFAULT_AGENTS_FILENAME = "AGENTS.md";
 declare const DEFAULT_TOOLS_FILENAME = "TOOLS.md";
 declare const DEFAULT_IDENTITY_FILENAME = "IDENTITY.md";
@@ -50,5 +50,4 @@ export declare function ensureAgentWorkspace(params?: {
 }>;
 export declare function loadWorkspaceInitFiles(dir: string): Promise<WorkspaceInitFile[]>;
 export declare function filterInitFilesForSession(files: WorkspaceInitFile[], sessionKey?: string): WorkspaceInitFile[];
-export {};
 //# sourceMappingURL=workspace.d.ts.map

package/packages/agent/src/providers/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../../../src/providers/workspace.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAqD3B;AAED,wBAAgB,+BAA+B,CAC7C,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,GAAE,MAAM,MAAmB,GACjC,MAAM,CAMR;AAED,eAAO,MAAM,2BAA2B,QAAoC,CAAC;AAC7E,QAAA,MAAM,uBAAuB,cAAc,CAAC;AAC5C,QAAA,MAAM,sBAAsB,aAAa,CAAC;AAC1C,QAAA,MAAM,yBAAyB,gBAAgB,CAAC;AAChD,QAAA,MAAM,qBAAqB,YAAY,CAAC;AACxC,QAAA,MAAM,0BAA0B,iBAAiB,CAAC;AAClD,QAAA,MAAM,qBAAqB,YAAY,CAAC;AACxC,QAAA,MAAM,uBAAuB,cAAc,CAAC;AAC5C,QAAA,MAAM,2BAA2B,cAAc,CAAC;AA2FhD,MAAM,MAAM,qBAAqB,GAC7B,OAAO,uBAAuB,GAC9B,OAAO,sBAAsB,GAC7B,OAAO,yBAAyB,GAChC,OAAO,qBAAqB,GAC5B,OAAO,0BAA0B,GACjC,OAAO,qBAAqB,GAC5B,OAAO,uBAAuB,GAC9B,OAAO,2BAA2B,CAAC;AAEvC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAI3E;AAyFD,wBAAsB,oBAAoB,CAAC,MAAM,CAAC,EAAE;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAuED;AA6CD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsD9B;AAOD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,iBAAiB,EAAE,EAC1B,UAAU,CAAC,EAAE,MAAM,GAClB,iBAAiB,EAAE,CAKrB"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../../../src/providers/workspace.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,iCAAiC,EACjC,4BAA4B,EAC7B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,iCAAiC,EACjC,4BAA4B,GAC7B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAqD3B;AAED,QAAA,MAAM,uBAAuB,cAAc,CAAC;AAC5C,QAAA,MAAM,sBAAsB,aAAa,CAAC;AAC1C,QAAA,MAAM,yBAAyB,gBAAgB,CAAC;AAChD,QAAA,MAAM,qBAAqB,YAAY,CAAC;AACxC,QAAA,MAAM,0BAA0B,iBAAiB,CAAC;AAClD,QAAA,MAAM,qBAAqB,YAAY,CAAC;AACxC,QAAA,MAAM,uBAAuB,cAAc,CAAC;AAC5C,QAAA,MAAM,2BAA2B,cAAc,CAAC;AAoGhD,MAAM,MAAM,qBAAqB,GAC7B,OAAO,uBAAuB,GAC9B,OAAO,sBAAsB,GAC7B,OAAO,yBAAyB,GAChC,OAAO,qBAAqB,GAC5B,OAAO,0BAA0B,GACjC,OAAO,qBAAqB,GAC5B,OAAO,uBAAuB,GAC9B,OAAO,2BAA2B,CAAC;AAEvC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAWF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAU3E;AAuFD,wBAAsB,oBAAoB,CAAC,MAAM,CAAC,EAAE;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAuED;AA6CD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsD9B;AAOD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,iBAAiB,EAAE,EAC1B,UAAU,CAAC,EAAE,MAAM,GAClB,iBAAiB,EAAE,CAKrB"}

package/packages/agent/src/providers/workspace.js

@@ -1,9 +1,10 @@
 import { spawn } from "node:child_process";
 import fs from "node:fs/promises";
-import os from "node:os";
 import path from "node:path";
 import * as elizaCore from "@elizaos/core";
-import { resolveUserPath } from "../config/paths";
+import { resolveUserPath } from "../config/paths.js";
+import { DEFAULT_AGENT_WORKSPACE_DIR, resolveDefaultAgentWorkspaceDir, shouldBootstrapWorkspaceInitFiles, shouldUseRuntimeCwdWorkspace, } from "../shared/workspace-resolution.js";
+export { DEFAULT_AGENT_WORKSPACE_DIR, resolveDefaultAgentWorkspaceDir, shouldBootstrapWorkspaceInitFiles, shouldUseRuntimeCwdWorkspace, };
 /**
  * Runs a command with an optional timeout.
  * Returns { code, stdout, stderr }.
@@ -52,14 +53,6 @@ export function runCommandWithTimeout(argv, opts = {}) {
         });
     });
 }
-export function resolveDefaultAgentWorkspaceDir(env = process.env, homedir = os.homedir) {
-    const profile = env.ELIZA_PROFILE?.trim();
-    if (profile && profile.toLowerCase() !== "default") {
-        return path.join(homedir(), ".eliza", `workspace-${profile}`);
-    }
-    return path.join(homedir(), ".eliza", "workspace");
-}
-export const DEFAULT_AGENT_WORKSPACE_DIR = resolveDefaultAgentWorkspaceDir();
 const DEFAULT_AGENTS_FILENAME = "AGENTS.md";
 const DEFAULT_TOOLS_FILENAME = "TOOLS.md";
 const DEFAULT_IDENTITY_FILENAME = "IDENTITY.md";
@@ -72,7 +65,63 @@ const DEFAULT_MEMORY_ALT_FILENAME = "memory.md";
 const WORKSPACE_TEMPLATES = {
     [DEFAULT_AGENTS_FILENAME]: `# Agents
 
-You are an autonomous AI agent powered by ElizaOS.
+## Memory
+- Write important things to USER.md (facts about your person)
+- Write your own reflections to MEMORY.md (what you've learned, patterns you notice)
+- These files persist across conversations. Use them.
+- If you learn something new about your person, write it down immediately.
+
+## Personality
+Your personality, voice, and identity are defined in your character file
+(the system prompt). Edit that from the dashboard or settings, not here.
+`,
+    [DEFAULT_TOOLS_FILENAME]: `# Tools
+
+Tools are provided by your enabled plugins and invoked automatically.
+Check the connectors page in your dashboard to enable Discord, Telegram,
+and other integrations.
+`,
+    [DEFAULT_IDENTITY_FILENAME]: `# Identity
+
+Your personality and voice are defined in your character file (system prompt).
+Edit your character from the dashboard to change who you are.
+
+This file is for any additional context you want to maintain about yourself
+that goes beyond the character definition — things you've decided, preferences
+you've developed, or aspects of your identity that emerged over time.
+`,
+    [DEFAULT_USER_FILENAME]: `# User
+
+Your person. Learn about them over time and update this file.
+
+Nothing here yet — you just met. Pay attention and fill this in naturally.
+`,
+    [DEFAULT_HEARTBEAT_FILENAME]: `# Heartbeat
+
+Periodic check-in. Use this space for reminders, recurring checks,
+or things you want to follow up on during your next heartbeat cycle.
+`,
+    [DEFAULT_INIT_FILENAME]: `# Init
+
+Your workspace. These files are your runtime context:
+
+- **USER.md** — What you know about your person (fill this in over time)
+- **MEMORY.md** — Long-term memory (lessons, patterns, insights)
+- **AGENTS.md** — Operational notes and memory guidelines
+- **IDENTITY.md** — Emergent identity notes (your character file is the source of truth)
+- **TOOLS.md** — Available tools and plugins
+- **HEARTBEAT.md** — Reminders and periodic checks
+
+Your personality is defined in your character file (system prompt), editable
+from the dashboard. These workspace files are for runtime context that you
+build up over time through conversations.
+`,
+};
+const LEGACY_WORKSPACE_TEMPLATES = {
+    [DEFAULT_AGENTS_FILENAME]: [
+        `# Agents
+
+You are an autonomous AI agent powered by elizaOS.
 
 ## Capabilities
 
@@ -88,7 +137,9 @@ You are an autonomous AI agent powered by ElizaOS.
 - Use tools when they would help accomplish the user's goal
 - Respect the user's preferences and communication style
 `,
-    [DEFAULT_TOOLS_FILENAME]: `# Tools
+    ],
+    [DEFAULT_TOOLS_FILENAME]: [
+        `# Tools
 
 Available tools and capabilities for the agent.
 
@@ -104,67 +155,29 @@ Tools are invoked automatically when the agent determines
 they would help accomplish the user's goal. No manual
 configuration is required.
 `,
-    [DEFAULT_IDENTITY_FILENAME]: `# Identity
-
-Your character and personality settings.
-
-Customize this file to define your agent's personality,
-tone, and behavior style.
-`,
-    [DEFAULT_USER_FILENAME]: `# User
-
-User context and preferences.
-
-This file stores information about the user to help
-personalize interactions.
-`,
-    [DEFAULT_HEARTBEAT_FILENAME]: `# Heartbeat
-
-The heartbeat system enables autonomous agent behavior.
-
-## Scheduling
-
-When autonomy is enabled, the agent periodically evaluates
-whether to take proactive actions based on its goals,
-pending tasks, and environmental changes.
-
-## Triggers
-
-- Scheduled intervals (configurable)
-- External events from connected channels
-- System notifications and alerts
-`,
-    [DEFAULT_INIT_FILENAME]: `# Init
-
-Initial workspace setup for a new agent.
-
-## Getting Started
-
-This workspace was automatically created for your agent.
-You can customize it by editing the markdown files in this
-directory:
-
-- **AGENTS.md** — Agent behavior and capabilities
-- **TOOLS.md** — Available tools and plugins
-- **IDENTITY.md** — Character and personality
-- **USER.md** — User context and preferences
-- **HEARTBEAT.md** — Autonomous behavior settings
-
-## Configuration
-
-Agent configuration is managed through \`~/.eliza/eliza.json\`
-or the Eliza Control UI.
-`,
+    ],
 };
+function normalizeBoilerplateText(value) {
+    return value
+        .replace(/\r\n?/g, "\n")
+        .trim()
+        .replace(/[ \t]+\n/g, "\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .toLowerCase();
+}
 /**
  * Returns true if the file content matches the built-in boilerplate template.
  * Used to skip injecting generic placeholder docs into the prompt.
  */
 export function isDefaultBoilerplate(name, content) {
-    const template = WORKSPACE_TEMPLATES[name];
-    if (!template)
+    const templates = [
+        WORKSPACE_TEMPLATES[name],
+        ...(LEGACY_WORKSPACE_TEMPLATES[name] ?? []),
+    ].filter((template) => typeof template === "string");
+    if (templates.length === 0)
         return false;
-    return content.trim() === template.trim();
+    const normalizedContent = normalizeBoilerplateText(content);
+    return templates.some((template) => normalizeBoilerplateText(template) === normalizedContent);
 }
 const coreWorkspaceHelpers = elizaCore;
 function isSubagentSessionKey(sessionKey) {
@@ -236,13 +249,13 @@ async function ensureGitRepo(dir, isBrandNewWorkspace) {
         });
     }
     catch (err) {
-        logWarn(`[workspace] git init failed: ${err instanceof Error ? err.message : err}`);
+        logWarn(`[workspace] git init failed: ${String(err)}`);
     }
 }
 export async function ensureAgentWorkspace(params) {
     const rawDir = params?.dir?.trim()
         ? params.dir.trim()
-        : DEFAULT_AGENT_WORKSPACE_DIR;
+        : resolveDefaultAgentWorkspaceDir();
     const dir = resolveUserPath(rawDir);
     await fs.mkdir(dir, { recursive: true });
     if (!params?.ensureInitFiles) {

package/packages/agent/src/runtime/advanced-capabilities-config.d.ts

@@ -0,0 +1,8 @@
+import type { ElizaConfig } from "../config/config.ts";
+export declare const ADVANCED_CAPABILITY_PLUGIN_IDS: readonly ["experience", "todos", "personality"];
+export type AdvancedCapabilityPluginId = (typeof ADVANCED_CAPABILITY_PLUGIN_IDS)[number];
+export declare function isAdvancedCapabilityPluginId(pluginId: string): pluginId is AdvancedCapabilityPluginId;
+export declare function resolveAdvancedCapabilitiesEnabled(config: Pick<ElizaConfig, "plugins"> | null | undefined): boolean;
+export declare function applyAdvancedCapabilitiesConfig(config: ElizaConfig, enabled: boolean): void;
+export declare function applyAdvancedCapabilitySettings(settings: Record<string, string>, enabled: boolean): Record<string, string>;
+//# sourceMappingURL=advanced-capabilities-config.d.ts.map

package/packages/agent/src/runtime/advanced-capabilities-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-capabilities-config.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/advanced-capabilities-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,8BAA8B,iDAIjC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAUlD,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,GACf,QAAQ,IAAI,0BAA0B,CAIxC;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GACtD,OAAO,CAST;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,OAAO,GACf,IAAI,CAkBN;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxB"}

package/packages/agent/src/runtime/advanced-capabilities-config.js

@@ -0,0 +1,41 @@
+export const ADVANCED_CAPABILITY_PLUGIN_IDS = [
+    "experience",
+    "todos",
+    "personality",
+];
+function readCapabilityEntryEnabled(config, pluginId) {
+    const value = config?.plugins?.entries?.[pluginId]?.enabled;
+    return typeof value === "boolean" ? value : null;
+}
+export function isAdvancedCapabilityPluginId(pluginId) {
+    return ADVANCED_CAPABILITY_PLUGIN_IDS.includes(pluginId);
+}
+export function resolveAdvancedCapabilitiesEnabled(config) {
+    for (const pluginId of ADVANCED_CAPABILITY_PLUGIN_IDS) {
+        const enabled = readCapabilityEntryEnabled(config, pluginId);
+        if (enabled !== null) {
+            return enabled;
+        }
+    }
+    return true;
+}
+export function applyAdvancedCapabilitiesConfig(config, enabled) {
+    config.plugins = config.plugins ?? {};
+    const pluginsRoot = config.plugins;
+    const previousEntries = pluginsRoot.entries ?? {};
+    const nextEntries = { ...previousEntries };
+    for (const pluginId of ADVANCED_CAPABILITY_PLUGIN_IDS) {
+        nextEntries[pluginId] = {
+            ...previousEntries[pluginId],
+            enabled,
+        };
+    }
+    pluginsRoot.entries = nextEntries;
+}
+export function applyAdvancedCapabilitySettings(settings, enabled) {
+    return {
+        ...settings,
+        ADVANCED_CAPABILITIES: enabled ? "true" : "false",
+        ENABLE_EXTENDED_CAPABILITIES: enabled ? "true" : "false",
+    };
+}

package/packages/agent/src/runtime/agent-wallets.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Per-agent wallet keys, stored in the Eliza vault.
+ *
+ * This module is the bridge between agent identity and the vault. Each
+ * agent gets its own EVM and Solana keypair, stored under
+ * `agent.<agentId>.wallet.<chain>` as a JSON record. Private keys are
+ * sensitive and AES-GCM encrypted at rest by the vault; the vault's
+ * master key lives in the OS keychain.
+ *
+ * The runtime-wide single wallet (process.env.EVM_PRIVATE_KEY etc.) is
+ * the *user* wallet, hydrated from the OS secure store via
+ * `hydrateWalletKeysFromNodePlatformSecureStore`. Per-agent wallets are
+ * stored *inside* the vault (encrypted file), enumerable and easy to
+ * surface in the UI alongside saved logins.
+ *
+ * This module does not generate or store keys on its own; callers
+ * supply a `Vault` instance. Agent-creation lifecycle code wires this
+ * up — see `runtime/eliza.ts`.
+ */
+import type { WalletChain } from "@elizaos/shared";
+import { type Vault } from "@elizaos/vault";
+/** Public, non-sensitive description of an agent wallet. */
+export interface AgentWalletDescriptor {
+    readonly agentId: string;
+    readonly chain: WalletChain;
+    readonly address: string;
+    readonly lastModified: number;
+}
+declare function walletKey(agentId: string, chain: WalletChain): string;
+declare function agentPrefix(agentId: string): string;
+declare function parseAgentWalletKey(key: string): {
+    agentId: string;
+    chain: WalletChain;
+} | null;
+/**
+ * Derive the public address from a stored private key. EVM uses the
+ * existing helper; Solana stores the public key alongside the secret in
+ * `generateWalletForChain`, so the stored `address` is authoritative
+ * and we trust it for the read path.
+ */
+declare function deriveAddressFor(chain: WalletChain, privateKey: string): string;
+/**
+ * Read the public descriptor for an agent's wallet. Returns null when
+ * the agent has no wallet for that chain. Does NOT reveal the private
+ * key.
+ */
+export declare function getAgentWalletDescriptor(vault: Vault, agentId: string, chain: WalletChain): Promise<AgentWalletDescriptor | null>;
+/**
+ * Reveal the private key. Audit-logged via the vault. Use only for
+ * signing flows.
+ */
+export declare function revealAgentWalletPrivateKey(vault: Vault, agentId: string, chain: WalletChain, caller?: string): Promise<string>;
+/**
+ * Existence check. Does not reveal the key.
+ */
+export declare function hasAgentWallet(vault: Vault, agentId: string, chain: WalletChain): Promise<boolean>;
+/**
+ * List every wallet descriptor for an agent (typically [evm, solana]).
+ */
+export declare function listAgentWallets(vault: Vault, agentId: string): Promise<readonly AgentWalletDescriptor[]>;
+/**
+ * List every agent that has at least one wallet stored. Returns the
+ * agent IDs (decoded). Use for UI surfaces enumerating agent wallets.
+ */
+export declare function listAgentsWithWallets(vault: Vault): Promise<readonly string[]>;
+/**
+ * Persist a wallet for an agent. Replaces any existing entry for that
+ * (agentId, chain). Stamps `lastModified`.
+ *
+ * Caller is responsible for supplying the matching address — for EVM
+ * this can be derived from the private key, for Solana the keypair
+ * generator returns it directly.
+ */
+export declare function setAgentWallet(vault: Vault, agentId: string, chain: WalletChain, privateKey: string, address: string, caller?: string): Promise<AgentWalletDescriptor>;
+/**
+ * Generate a fresh wallet for an agent and persist it. Returns the
+ * public descriptor. Idempotent: callers should check `hasAgentWallet`
+ * first if they want to avoid replacing an existing wallet.
+ */
+export declare function generateAgentWallet(vault: Vault, agentId: string, chain: WalletChain, caller?: string): Promise<AgentWalletDescriptor>;
+/**
+ * Generate any missing wallets (EVM + Solana) for an agent. Existing
+ * wallets are left alone. Returns descriptors for every chain that now
+ * has a wallet (whether it was generated this call or was already
+ * present).
+ */
+export declare function ensureAgentWallets(vault: Vault, agentId: string, caller?: string): Promise<readonly AgentWalletDescriptor[]>;
+/**
+ * Make the per-agent wallet visible as the user wallet for THIS process.
+ *
+ * The wallet UI tab + every consumer plugin (`@elizaos/plugin-evm`,
+ * `@elizaos/plugin-solana`) reads from `process.env.EVM_PRIVATE_KEY` /
+ * `SOLANA_PRIVATE_KEY`. Per-agent wallets live in the vault, so without
+ * a bridge the UI shows "No EVM/Solana address" even though the agent
+ * has a perfectly good wallet sitting in the vault.
+ *
+ * ## Security trade-off — this is OPT-IN by default
+ *
+ * Writing a private key to `process.env` exposes it via:
+ *   - `/proc/self/environ` (readable by the same UID; some sandboxes leak more)
+ *   - crash dumps + core files
+ *   - any `JSON.stringify(process.env)` in error reports or telemetry
+ *   - inheritance into every spawned child process (default `env` for spawn)
+ *
+ * For most users on a single-user machine that's an acceptable trade —
+ * the agent IS the wallet, the box is the user's, and the convenience
+ * (wallet UI just works) outweighs the leak surface. But for shared
+ * machines, server deployments, or anyone with strict secrets hygiene,
+ * the leak surface is real.
+ *
+ * Default behavior: bridge is OFF. The wallet UI shows "No address"
+ * for the chain unless the user explicitly opts in. Opt-in flag:
+ * `ELIZA_AGENT_WALLET_AS_USER=1`. The proper fix is for consumer
+ * plugins to read from the vault directly via `getAgentWallet(agentId,
+ * chain)` instead of `process.env.*_PRIVATE_KEY` — when that
+ * migration lands, this whole bridge can be deleted.
+ *
+ * Legacy env: `ELIZA_DISABLE_AGENT_WALLET_AS_USER=1` (the previous
+ * opt-out) is still respected — if set, the bridge is forced off
+ * regardless of `ELIZA_AGENT_WALLET_AS_USER`.
+ */
+export declare function bridgeAgentWalletsToProcessEnv(vault: Vault, agentId: string, descriptors: readonly AgentWalletDescriptor[], caller?: string): Promise<void>;
+/**
+ * Remove an agent's wallet for one chain. Idempotent.
+ */
+export declare function removeAgentWallet(vault: Vault, agentId: string, chain: WalletChain): Promise<void>;
+/**
+ * Remove every wallet for an agent. Use during agent deletion.
+ */
+export declare function removeAllAgentWallets(vault: Vault, agentId: string): Promise<void>;
+export declare const __test__: {
+    walletKey: typeof walletKey;
+    agentPrefix: typeof agentPrefix;
+    parseAgentWalletKey: typeof parseAgentWalletKey;
+    deriveAddressFor: typeof deriveAddressFor;
+};
+export {};
+//# sourceMappingURL=agent-wallets.d.ts.map

package/packages/agent/src/runtime/agent-wallets.d.ts.map

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