@elizaos/autonomous 2.0.0-alpha.68 → 2.0.0-alpha.69

package/.turbo/turbo-build.log

@@ -2,4 +2,3 @@ $ bun run build:dist
 $ rimraf dist && tsc -p tsconfig.build.json && node ../../scripts/prepare-package-dist.mjs packages/autonomous --compiled-prefix=packages/autonomous/src
 /usr/bin/bash: line 1: rimraf: command not found
 error: script "build:dist" exited with code 127
-error: script "build" exited with code 127

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/autonomous",
-  "version": "2.0.0-alpha.68",
+  "version": "2.0.0-alpha.69",
   "description": "Standalone Milady agent runtime and backend server package.",
   "type": "module",
   "license": "MIT",
@@ -220,28 +220,28 @@
     "@clack/prompts": "^1.0.0",
     "@elizaos/core": "2.0.0-alpha.64",
     "@elizaos/plugin-agent-orchestrator": "0.3.15",
-    "@elizaos/plugin-agent-skills": "2.0.0-alpha.11",
-    "@elizaos/plugin-anthropic": "2.0.0-alpha.6",
+    "@elizaos/plugin-agent-skills": "alpha",
+    "@elizaos/plugin-anthropic": "alpha",
     "@elizaos/plugin-coding-agent": "0.1.0-next.1",
-    "@elizaos/plugin-cron": "2.0.0-alpha.7",
-    "@elizaos/plugin-elizacloud": "2.0.0-alpha.7",
-    "@elizaos/plugin-experience": "2.0.0-alpha.9",
-    "@elizaos/plugin-form": "2.0.0-alpha.10",
-    "@elizaos/plugin-knowledge": "2.0.0-alpha.6",
-    "@elizaos/plugin-local-embedding": "2.0.0-alpha.11",
-    "@elizaos/plugin-ollama": "2.0.0-alpha.6",
-    "@elizaos/plugin-openai": "2.0.0-alpha.8",
-    "@elizaos/plugin-pdf": "2.0.0-alpha.7",
-    "@elizaos/plugin-personality": "2.0.0-alpha.7",
-    "@elizaos/plugin-pi-ai": "1.7.3-alpha.3",
-    "@elizaos/plugin-plugin-manager": "2.0.0-alpha.7",
-    "@elizaos/plugin-rolodex": "2.0.0-alpha.9",
-    "@elizaos/plugin-secrets-manager": "2.0.0-alpha.9",
-    "@elizaos/plugin-shell": "2.0.0-alpha.9",
-    "@elizaos/plugin-sql": "2.0.0-alpha.12",
-    "@elizaos/plugin-todo": "2.0.0-alpha.7",
-    "@elizaos/plugin-trajectory-logger": "2.0.0-alpha.11",
-    "@elizaos/plugin-trust": "2.0.0-alpha.1",
+    "@elizaos/plugin-cron": "alpha",
+    "@elizaos/plugin-elizacloud": "alpha",
+    "@elizaos/plugin-experience": "alpha",
+    "@elizaos/plugin-form": "alpha",
+    "@elizaos/plugin-knowledge": "alpha",
+    "@elizaos/plugin-local-embedding": "alpha",
+    "@elizaos/plugin-ollama": "alpha",
+    "@elizaos/plugin-openai": "alpha",
+    "@elizaos/plugin-pdf": "alpha",
+    "@elizaos/plugin-personality": "alpha",
+    "@elizaos/plugin-pi-ai": "alpha",
+    "@elizaos/plugin-plugin-manager": "alpha",
+    "@elizaos/plugin-rolodex": "alpha",
+    "@elizaos/plugin-secrets-manager": "alpha",
+    "@elizaos/plugin-shell": "alpha",
+    "@elizaos/plugin-sql": "alpha",
+    "@elizaos/plugin-todo": "alpha",
+    "@elizaos/plugin-trajectory-logger": "alpha",
+    "@elizaos/plugin-trust": "alpha",
     "@elizaos/skills": "2.0.0-alpha.15",
     "@hapi/boom": "^10.0.1",
     "@lunchtable/plugin-ltcg": "^0.1.0",
@@ -276,5 +276,5 @@
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },
-  "gitHead": "9357c48a9f26c21aaf0bd689e533882ec14bd338"
+  "gitHead": "774937c9cbefd3d95fc181ca40295bb4fd5a7d3b"
 }

package/src/actions/emote.test.ts

@@ -0,0 +1,41 @@
+/**
+ * Tests for emote action — verifies enum is populated from catalog.
+ */
+
+import { describe, expect, it } from "vitest";
+import { AGENT_EMOTE_CATALOG } from "../emotes/catalog";
+import { emoteAction } from "./emote";
+
+describe("emoteAction", () => {
+  it("has a parameter with enum populated from the emote catalog", () => {
+    const emoteParam = emoteAction.parameters?.find((p) => p.name === "emote");
+    expect(emoteParam).toBeDefined();
+    expect(emoteParam?.schema).toBeDefined();
+
+    const schema = emoteParam?.schema as { type: string; enum?: string[] };
+    expect(schema.enum).toBeDefined();
+    expect(schema.enum).toHaveLength(AGENT_EMOTE_CATALOG.length);
+  });
+
+  it("enum contains expected emote IDs", () => {
+    const emoteParam = emoteAction.parameters?.find((p) => p.name === "emote");
+    const schema = emoteParam?.schema as { type: string; enum?: string[] };
+    const ids = schema.enum ?? [];
+
+    // Spot-check some known emotes
+    expect(ids).toContain("dance-happy");
+    expect(ids).toContain("wave");
+
+    // Excluded emotes should not appear
+    expect(ids).not.toContain("idle");
+    expect(ids).not.toContain("run");
+    expect(ids).not.toContain("walk");
+  });
+
+  it("includes common mappings in description", () => {
+    const emoteParam = emoteAction.parameters?.find((p) => p.name === "emote");
+    expect(emoteParam?.description).toContain("dance-happy");
+    expect(emoteParam?.description).toContain("wave");
+    expect(emoteParam?.description).toContain("fishing");
+  });
+});

package/src/actions/emote.ts

@@ -11,7 +11,7 @@
  */
 
 import type { Action, HandlerOptions } from "@elizaos/core";
-import { AGENT_EMOTE_BY_ID } from "../emotes/catalog";
+import { AGENT_EMOTE_BY_ID, AGENT_EMOTE_CATALOG } from "../emotes/catalog";
 
 /** API port for posting emote requests. */
 const API_PORT = process.env.API_PORT || process.env.SERVER_PORT || "2138";
@@ -31,7 +31,8 @@ export const emoteAction: Action = {
   ],
 
   description:
-    "Play a one-shot emote animation on the avatar, then return to idle. " +
+    "Play a one-shot emote animation on your 3D VRM avatar, then return to idle. " +
+    "Use whenever a visible gesture, reaction, or trick helps convey emotion. " +
     "This is a silent non-blocking visual side action that does not create " +
     "chat text on its own. Only call it when you set the required emote " +
     "parameter to a valid emote ID. If you also want speech, chain it " +
@@ -96,9 +97,14 @@ export const emoteAction: Action = {
     {
       name: "emote",
       description:
-        "Required emote ID to play once silently before returning to idle",
+        "Required emote ID to play once silently before returning to idle. " +
+        "Common mappings: dance/vibe → dance-happy, wave/greet → wave, " +
+        "flip/backflip → flip, cry/sad → crying, fight/punch → punching, fish → fishing",
       required: true,
-      schema: { type: "string" as const },
+      schema: {
+        type: "string" as const,
+        enum: AGENT_EMOTE_CATALOG.map((e) => e.id),
+      },
     },
   ],
 };

package/src/api/character-routes.ts

@@ -165,7 +165,7 @@ function buildGeneratePrompt(
   }
 
   if (field === "chatExamples") {
-    return `Given this character:\n${charSummary}\n\nGenerate 3 example chat conversations showing how this character responds. Output a JSON array where each element is an array of message objects like [{"user":"{{user1}}","content":{"text":"..."}},{"user":"{{agentName}}","content":{"text":"..."}}]. Just output the JSON array, nothing else.`;
+    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.`;
   }
 
   const existing =

package/src/providers/workspace-provider.test.ts

@@ -0,0 +1,111 @@
+/**
+ * Tests for workspace-provider buildContext — verifies boilerplate filtering.
+ */
+
+import { describe, expect, it } from "vitest";
+import type { WorkspaceBootstrapFile } from "./workspace";
+import { buildContext } from "./workspace-provider";
+
+const DEFAULT_AGENTS_CONTENT = `# Agents
+
+You are an autonomous AI agent powered by ElizaOS.
+
+## Capabilities
+
+- Respond to user messages conversationally
+- Execute actions and use available tools
+- Access and manage knowledge from your workspace
+- Maintain context across conversations
+
+## Guidelines
+
+- Be helpful, concise, and accurate
+- Ask for clarification when instructions are ambiguous
+- Use tools when they would help accomplish the user's goal
+- Respect the user's preferences and communication style
+`;
+
+const CUSTOM_AGENTS_CONTENT = `# Agents
+
+You are Mima, a cozy companion agent powered by ElizaOS.
+
+## Capabilities
+
+- Provide emotional support and companionship
+- Play emotes and animations
+`;
+
+describe("buildContext", () => {
+  it("skips default boilerplate files", () => {
+    const files: WorkspaceBootstrapFile[] = [
+      {
+        name: "AGENTS.md",
+        path: "/workspace/AGENTS.md",
+        content: DEFAULT_AGENTS_CONTENT,
+        missing: false,
+      },
+    ];
+    const result = buildContext(files, 20_000);
+    expect(result).toBe("");
+  });
+
+  it("includes customized files", () => {
+    const files: WorkspaceBootstrapFile[] = [
+      {
+        name: "AGENTS.md",
+        path: "/workspace/AGENTS.md",
+        content: CUSTOM_AGENTS_CONTENT,
+        missing: false,
+      },
+    ];
+    const result = buildContext(files, 20_000);
+    expect(result).toContain("AGENTS.md");
+    expect(result).toContain("Mima");
+  });
+
+  it("skips missing files", () => {
+    const files: WorkspaceBootstrapFile[] = [
+      {
+        name: "AGENTS.md",
+        path: "/workspace/AGENTS.md",
+        missing: true,
+      },
+    ];
+    const result = buildContext(files, 20_000);
+    expect(result).toBe("");
+  });
+
+  it("skips empty files", () => {
+    const files: WorkspaceBootstrapFile[] = [
+      {
+        name: "AGENTS.md",
+        path: "/workspace/AGENTS.md",
+        content: "   \n  ",
+        missing: false,
+      },
+    ];
+    const result = buildContext(files, 20_000);
+    expect(result).toBe("");
+  });
+
+  it("includes mix of custom and default files, only custom appears", () => {
+    const files: WorkspaceBootstrapFile[] = [
+      {
+        name: "AGENTS.md",
+        path: "/workspace/AGENTS.md",
+        content: DEFAULT_AGENTS_CONTENT,
+        missing: false,
+      },
+      {
+        name: "IDENTITY.md",
+        path: "/workspace/IDENTITY.md",
+        content: "# Identity\n\nI am Mima, a warm companion.",
+        missing: false,
+      },
+    ];
+    const result = buildContext(files, 20_000);
+    expect(result).not.toContain("AGENTS.md");
+    expect(result).toContain("IDENTITY.md");
+    expect(result).toContain("Mima");
+  });
+});

package/src/providers/workspace-provider.ts

@@ -20,6 +20,7 @@ import type { CodingAgentContext } from "../services/coding-agent-context";
 import {
   DEFAULT_AGENT_WORKSPACE_DIR,
   filterInitFilesForSession,
+  isDefaultBoilerplate,
   loadWorkspaceInitFiles,
   type WorkspaceInitFile,
 } from "./workspace";
@@ -72,6 +73,9 @@ export function buildContext(
   let totalChars = 0;
   for (const f of files) {
     if (f.missing || !f.content?.trim()) continue;
+    // Skip files that are still the default boilerplate — they add ~3k of
+    // generic placeholder text with zero useful context for the model.
+    if (isDefaultBoilerplate(f.name, f.content)) continue;
     const trimmed = f.content.trim();
     // Per-file truncation
     const text = truncate(trimmed, maxChars);

package/src/providers/workspace.test.ts

@@ -0,0 +1,94 @@
+/**
+ * Tests for workspace boilerplate detection.
+ */
+
+import { describe, expect, it } from "vitest";
+import { isDefaultBoilerplate } from "./workspace";
+
+describe("isDefaultBoilerplate", () => {
+  it("returns true for exact default AGENTS.md content", () => {
+    const content = `# Agents
+
+You are an autonomous AI agent powered by ElizaOS.
+
+## Capabilities
+
+- Respond to user messages conversationally
+- Execute actions and use available tools
+- Access and manage knowledge from your workspace
+- Maintain context across conversations
+
+## Guidelines
+
+- Be helpful, concise, and accurate
+- Ask for clarification when instructions are ambiguous
+- Use tools when they would help accomplish the user's goal
+- Respect the user's preferences and communication style
+`;
+    expect(isDefaultBoilerplate("AGENTS.md", content)).toBe(true);
+  });
+
+  it("returns true when content has extra whitespace around it", () => {
+    const content = `
+  # Agents
+
+You are an autonomous AI agent powered by ElizaOS.
+
+## Capabilities
+
+- Respond to user messages conversationally
+- Execute actions and use available tools
+- Access and manage knowledge from your workspace
+- Maintain context across conversations
+
+## Guidelines
+
+- Be helpful, concise, and accurate
+- Ask for clarification when instructions are ambiguous
+- Use tools when they would help accomplish the user's goal
+- Respect the user's preferences and communication style
+  `;
+    expect(isDefaultBoilerplate("AGENTS.md", content)).toBe(true);
+  });
+
+  it("returns false for customized content", () => {
+    const content = `# Agents
+
+You are Mima, a cozy companion agent.
+
+## Guidelines
+
+- Be warm and supportive
+`;
+    expect(isDefaultBoilerplate("AGENTS.md", content)).toBe(false);
+  });
+
+  it("returns false for unknown file names", () => {
+    expect(
+      isDefaultBoilerplate(
+        "CUSTOM.md" as Parameters<typeof isDefaultBoilerplate>[0],
+        "anything",
+      ),
+    ).toBe(false);
+  });
+
+  it("returns true for default TOOLS.md content", () => {
+    const content = `# Tools
+
+Available tools and capabilities for the agent.
+
+## Built-in Tools
+
+The agent has access to tools provided by enabled plugins.
+Each plugin may register actions, providers, and evaluators
+that extend the agent's capabilities.
+
+## Usage
+
+Tools are invoked automatically when the agent determines
+they would help accomplish the user's goal. No manual
+configuration is required.
+`;
+    expect(isDefaultBoilerplate("TOOLS.md", content)).toBe(true);
+  });
+});

package/src/providers/workspace.ts

@@ -105,7 +105,7 @@ const DEFAULT_MEMORY_ALT_FILENAME = "memory.md";
 const WORKSPACE_TEMPLATES: Record<string, string> = {
   [DEFAULT_AGENTS_FILENAME]: `# Agents
 
-You are an autonomous AI agent powered by elizaOS.
+You are an autonomous AI agent powered by ElizaOS.
 
 ## Capabilities
 
@@ -207,6 +207,19 @@ export type WorkspaceInitFile = {
   missing: boolean;
 };
 
+/**
+ * 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: WorkspaceBootstrapFileName,
+  content: string,
+): boolean {
+  const template = WORKSPACE_TEMPLATES[name];
+  if (!template) return false;
+  return content.trim() === template.trim();
+}
+
 type ElizaCoreWorkspaceHelpers = {
   isSubagentSessionKey?: (key: string) => boolean;
   logger?: {

package/src/runtime/eliza-plugin.ts

@@ -8,12 +8,10 @@
 
 import type {
   IAgentRuntime,
-  Memory,
   Plugin,
   Provider,
   ProviderResult,
   ServiceClass,
-  State,
 } from "@elizaos/core";
 import { AgentEventService } from "@elizaos/core";
 import { emoteAction } from "../actions/emote";
@@ -28,7 +26,6 @@ import {
 } from "../actions/stream-control";
 import { switchStreamSourceAction } from "../actions/switch-stream-source";
 import { terminalAction } from "../actions/terminal";
-import { AGENT_EMOTE_CATALOG } from "../emotes/catalog";
 import { adminTrustProvider } from "../providers/admin-trust";
 
 import { createSessionKeyProvider } from "../providers/session-bridge";
@@ -69,44 +66,13 @@ export function createElizaPlugin(config?: ElizaPluginConfig): Plugin {
     ...getSessionProviders({ storePath: sessionStorePath }),
   ];
 
-  // Emote provider — injects available emotes into agent context so the LLM
-  // knows it can trigger animations via the PLAY_EMOTE action.
-  // Gated on character.settings — disable for agents without 3D avatars.
-  const emoteProvider: Provider = {
-    name: "emotes",
-    description: "Available avatar emote animations",
-
-    async get(
-      _runtime: IAgentRuntime,
-      _message: Memory,
-      _state: State,
-    ): Promise<ProviderResult> {
-      // Skip emote injection for agents without avatars.
-      // Set character.settings.DISABLE_EMOTES = true to save ~300 tokens.
-      const settings = _runtime.character?.settings;
-      if (settings?.DISABLE_EMOTES) {
-        return { text: "" };
-      }
-      const ids = AGENT_EMOTE_CATALOG.map((e) => e.id).join(", ");
-      return {
-        text: [
-          "## Available Emotes",
-          "",
-          "You have a 3D VRM avatar that can perform emote animations via the PLAY_EMOTE action.",
-          "Use PLAY_EMOTE whenever a visible gesture, reaction, or trick helps.",
-          "PLAY_EMOTE is a silent one-shot visual side action. It does not speak or post chat text by itself, and it returns to idle automatically.",
-          'If you also want text, chain PLAY_EMOTE with REPLY in the same turn — for example actions: ["PLAY_EMOTE", "REPLY"] or ["REPLY", "PLAY_EMOTE"].',
-          "Only call PLAY_EMOTE when you set the required emote parameter to a valid emote ID. If you cannot choose one, do not call it.",
-          "Set the emote parameter to the emote ID you want.",
-          "",
-          `Available emote IDs: ${ids}`,
-          "",
-          "Do not use idle, run, or walk with PLAY_EMOTE.",
-          "Common mappings: dance/vibe → dance-happy, wave/greet → wave, flip/backflip → flip, cry/sad → crying, fight/punch → punching, fish → fishing",
-        ].join("\n"),
-      };
-    },
-  };
+  // Emote IDs are now declared as an enum on the PLAY_EMOTE action parameter,
+  // so they appear in the `# Available Actions` section automatically via
+  // core's formatActions. No separate provider injection needed.
+  //
+  // Backwards-compat: character.settings.DISABLE_EMOTES still works — when set,
+  // the PLAY_EMOTE action is excluded at init time so it never appears in the
+  // prompt. Previously this was checked per-request in the emote provider.
 
   // Custom actions provider — tells the LLM about available custom actions.
   const customActionsProvider: Provider = {
@@ -139,22 +105,29 @@ export function createElizaPlugin(config?: ElizaPluginConfig): Plugin {
     },
   };
 
-  return {
+  const plugin: Plugin = {
     name: "eliza",
     description: "Eliza workspace context, session keys, and lifecycle actions",
 
     services: [AgentEventService as ServiceClass],
 
-    init: async (_pluginConfig, runtime) => {
+    init: async (_pluginConfig, runtime: IAgentRuntime) => {
       registerTriggerTaskWorker(runtime);
       setCustomActionsRuntime(runtime);
+
+      // Honour DISABLE_EMOTES: remove PLAY_EMOTE so it never appears in prompts.
+      if (runtime.character?.settings?.DISABLE_EMOTES) {
+        const idx = plugin.actions?.findIndex((a) => a.name === "PLAY_EMOTE");
+        if (idx != null && idx >= 0) {
+          plugin.actions?.splice(idx, 1);
+        }
+      }
     },
 
     providers: [
       ...baseProviders,
 
       uiCatalogProvider,
-      emoteProvider,
       customActionsProvider,
     ],
 
@@ -173,4 +146,6 @@ export function createElizaPlugin(config?: ElizaPluginConfig): Plugin {
       ...loadCustomActions(),
     ],
   };
+
+  return plugin;
 }