@elizaos/agent 0.25.9 → 2.0.0-alpha.151

package/packages/agent/src/runtime/prompt-compaction.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Intent detection and context-aware action compaction.
+ *
+ * Extracted from prompt-optimization.ts to keep files under ~500 LOC.
+ * These helpers detect user intent from prompt content and strip
+ * irrelevant action params to reduce context window usage.
+ */
+export declare function compactInitialCodeMarker(prompt: string): string;
+export declare function compactRegistryCatalog(prompt: string): string;
+export declare function compactCodingActionExamples(prompt: string): string;
+export declare function compactUiCatalog(prompt: string): string;
+export declare function compactLoadedPluginLists(prompt: string): string;
+export declare function compactEmoteCatalog(prompt: string): string;
+export declare function compactWorkspaceContextForNonCoding(prompt: string): string;
+export declare function compactUiComponentCatalog(prompt: string): string;
+export declare function compactInstalledSkills(prompt: string): string;
+/** Actions that are always included at full detail. */
+export declare const UNIVERSAL_ACTIONS: Set<string>;
+/**
+ * Map intent categories → action names that get full params when detected.
+ *
+ * These names must match the registered action names in the runtime. If an
+ * action is renamed or removed upstream, the compaction gracefully degrades
+ * — the action simply won't appear in the prompt at all, so the stale name
+ * in this map is harmless (it just won't match anything).
+ */
+export declare const INTENT_ACTION_MAP: Record<string, Set<string>>;
+export declare function hasIntent(prompt: string, keywords: RegExp): boolean;
+/**
+ * Validate INTENT_ACTION_MAP against the runtime's registered actions.
+ * Logs warnings for any mapped action names that don't exist in the runtime.
+ * Call once at startup after plugins are loaded.
+ */
+export declare function validateIntentActionMap(registeredActions: string[], logger?: {
+    warn: (msg: string) => void;
+}): void;
+/**
+ * Detect which intent categories are present in the prompt.
+ * Returns array of category names (e.g. ["coding", "terminal"]).
+ * Multiple categories can match simultaneously.
+ */
+export declare function detectIntentCategories(prompt: string): string[];
+/**
+ * Build the set of action names that should get full param detail.
+ * Universal actions are always included. Intent-matched actions are
+ * added based on detected categories. Everything else gets stub-only.
+ */
+export declare function buildFullParamActionSet(intentCategories: string[]): Set<string>;
+/**
+ * Strip internal thoughts, action lists, and entity UUIDs from conversation
+ * history when no coding/swarm intent is detected. For general chat, the
+ * agent's previous reasoning and action selections are noise — only the
+ * actual messages matter. Coding tasks keep the full context so the swarm
+ * coordinator can see its previous reasoning chain.
+ *
+ * Targets lines like:
+ *   (Eliza's internal thought: User wants me to spawn...)
+ *   (Eliza's actions: REPLY, CREATE_TASK)
+ *   12:53 (17 minutes ago) [b850bc30-45f8-0041-a00a-83df46d8555d]
+ *                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ UUID
+ */
+export declare function compactConversationHistory(prompt: string): string;
+/**
+ * Strip the task-agent examples provider section when no task/coding intent
+ * is detected. These examples teach the LLM how to use CREATE_TASK /
+ * SPAWN_AGENT / FINALIZE_WORKSPACE and related aliases, which are unnecessary
+ * for general chat, emote, or plugin-config messages.
+ */
+export declare function compactCodingExamplesForIntent(prompt: string): string;
+/**
+ * Context-aware action formatting. Replaces the <actions>...</actions>
+ * block in the prompt with a version where only intent-relevant actions
+ * have full <params> — the rest are stubs with just name + description.
+ *
+ * If no intents are detected (general chat), only universal actions
+ * (REPLY, NONE, IGNORE) keep full params — all others are stubbed.
+ */
+export declare function compactActionsForIntent(prompt: string): string;
+export declare function compactModelPrompt(prompt: string): string;
+//# sourceMappingURL=prompt-compaction.d.ts.map

package/packages/agent/src/runtime/prompt-compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-compaction.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/prompt-compaction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK/D;AAKD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAY/D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM7D;AA0BD,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,aAAuC,CAAC;AAEtE;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAezD,CAAC;AAEF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAsBnE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,MAAM,EAAE,EAC3B,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACvC,IAAI,CAWN;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,MAAM,EAAE,GACzB,GAAG,CAAC,MAAM,CAAC,CAcb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA6BjE;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAarE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0D9D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0BzD"}

package/packages/agent/src/runtime/prompt-compaction.js

@@ -0,0 +1,307 @@
+/**
+ * Intent detection and context-aware action compaction.
+ *
+ * Extracted from prompt-optimization.ts to keep files under ~500 LOC.
+ * These helpers detect user intent from prompt content and strip
+ * irrelevant action params to reduce context window usage.
+ */
+// ---------------------------------------------------------------------------
+// Prompt compaction helpers
+// ---------------------------------------------------------------------------
+export function compactInitialCodeMarker(prompt) {
+    return prompt.replace(/initial code:\s*([0-9a-f]{8})[0-9a-f-]*/gi, "<initial_code>$1</initial_code>");
+}
+// compactActionDocs removed — replaced by compactActionsForIntent which
+// provides context-aware action formatting instead of blanket compaction.
+export function compactRegistryCatalog(prompt) {
+    return prompt.replace(/\*\*Available Plugins from Registry \((\d+) total\):[\s\S]*?(?=\n## Project Context \(Workspace\)|\n### AGENTS\.md|$)/g, (_match, total) => `**Available Plugins from Registry (${total} total):** [omitted in compact mode; query on demand]\n`);
+}
+export function compactCodingActionExamples(prompt) {
+    const next = prompt.replace(/\n# (?:Coding|Task) Agent Action Call Examples[\s\S]*?(?=\nPossible response actions:|\n# Available Actions|\n## Project Context \(Workspace\)|$)/g, "\n");
+    return next.replace(/\nPossible response actions:[^\n]*\n?/g, "\n");
+}
+export function compactUiCatalog(prompt) {
+    return prompt.replace(/\n## Rich UI Output — you can render interactive components in your replies[\s\S]*?(?=\n## Project Context \(Workspace\)|\n### AGENTS\.md|$)/g, "\n");
+}
+export function compactLoadedPluginLists(prompt) {
+    const loadedCountMatch = prompt.match(/\*\*Loaded Plugins:\*\*[\s\S]*?(?=\n\*\*System Plugins:\*\*)/);
+    const loadedCount = loadedCountMatch
+        ? (loadedCountMatch[0].match(/\n- /g)?.length ?? 0)
+        : 0;
+    return prompt.replace(/\n\*\*Loaded Plugins:\*\*[\s\S]*?(?=\n\*\*Available Plugins from Registry|\nNo access to role information|\nSECURITY ALERT:|$)/g, `\n**Loaded Plugins:** ${loadedCount} loaded [list omitted in compact mode]`);
+}
+export function compactEmoteCatalog(prompt) {
+    return prompt.replace(/\n## Available Emotes[\s\S]*?(?=\n# Active Workspaces & Agents|\n## Project Context \(Workspace\)|$)/g, "\n## Available Emotes\n[emote catalog omitted in compact mode]\n");
+}
+export function compactWorkspaceContextForNonCoding(prompt) {
+    return prompt.replace(/\n## Project Context \(Workspace\)[\s\S]*?(?=\nAdmin trust:|\nThe current date and time is|\n# Conversation Messages|$)/g, "\n## Project Context (Workspace)\n[workspace file contents omitted in compact mode for non-coding intent]\n");
+}
+export function compactUiComponentCatalog(prompt) {
+    return prompt.replace(/\n### Available components \((\d+) total\)[\s\S]*?(?=\n## Available Emotes|\n## Project Context \(Workspace\)|$)/g, (_match, total) => `\n### Available components (${total} total)\n[component catalog omitted in compact mode]\n`);
+}
+export function compactInstalledSkills(prompt) {
+    return prompt.replace(/\n## Installed Skills \((\d+)\)[\s\S]*?\*Use TOGGLE_SKILL to enable\/disable skills\.[\s\S]*?(?=\nMima is|\n\*\*Loaded Plugins:\*\*|\n## Project Context \(Workspace\)|$)/g, (_match, total) => `\n## Installed Skills (${total})\n[skill list omitted in compact mode; query on demand]\n`);
+}
+// ---------------------------------------------------------------------------
+// Intent detection
+// ---------------------------------------------------------------------------
+// Coding intent uses specific terms. Generic words like "fix", "build", "run"
+// are excluded to avoid false positives ("fix the typo", "build me a haiku").
+// Includes translations for supported locales: ko, zh-CN, es, pt, vi, tl.
+const CODING_INTENT_RE = /\b(code|coding|codebase|repo|repository|pull request|pr\b|branch|merge|commit|deploy|refactor|research|investigate|analy[sz]e|analysis|draft|document|orchestrate|delegate|subtask|parallel|background task|task agent|start_coding_task|spawn_coding_agent|send_to_coding_agent|create_task|spawn_agent|send_to_agent|list_agents|stop_agent)\b|https?:\/\/(?:github\.com|gitlab\.com|bitbucket\.org)\/|코드|코딩|레포|저장소|브랜치|커밋|배포|리팩토링|풀\s?리퀘스트|代码|仓库|分支|提交|部署|合并|拉取请求|\b(código|repositorio|repositório|confirmación|implementar|investigar|analizar|documentar)\b|mã|kho|nhánh|triển khai/i;
+const PLUGIN_UI_INTENT_RE = /\b(plugin|plugins|configure|configuration|setup|install|enable|disable|api key|credential|secret|dashboard|form|ui|interface|\[config:)\b|플러그인|설정|설치|插件|配置|安装|\b(complemento|configurar|instalar|configuração)\b/i;
+// Terminal intent requires specific CLI/tool terms, not generic verbs.
+const TERMINAL_INTENT_RE = /\b(shell|command line|execute command|npm|bun|yarn|git\b|bash|terminal|script|pip|apt-get|brew)\b|터미널|명령어|스크립트|终端|命令行|脚本|\b(terminal|línea de comandos|linha de comando)\b/i;
+const EMOTE_INTENT_RE = /\b(emote|wave|dance|bow|clap|laugh|angry|sad|think|sit|play_emote)\b|이모트|춤|인사|笑|跳舞|鞠躬|\b(bailar)\b/i;
+// "close" and "label" removed — too generic ("close the file", "label this").
+const ISSUE_INTENT_RE = /\b(issue|bug report|ticket|close issue|reopen issue|github issue|create issue|file a bug)\b|이슈|버그|티켓|问题|错误|工单|\b(problema|error|billete)\b/i;
+// Wallet / on-chain intent should keep full action schemas to avoid "I will send"
+// style larping when trade/transfer actions require detailed params.
+const WALLET_INTENT_RE = /\b(wallet|onchain|on-chain|transaction|tx\b|transfer|swap|trade|send\b|gas|token|bnb|eth|sol|basechain|erc20|balance)\b|钱包|交易|转账|代币|余额|지갑|거래|전송|잔액|\b(cartera|transacci[oó]n|intercambio|saldo)\b/i;
+/** Actions that are always included at full detail. */
+export const UNIVERSAL_ACTIONS = new Set(["REPLY", "NONE", "IGNORE"]);
+/**
+ * Map intent categories → action names that get full params when detected.
+ *
+ * These names must match the registered action names in the runtime. If an
+ * action is renamed or removed upstream, the compaction gracefully degrades
+ * — the action simply won't appear in the prompt at all, so the stale name
+ * in this map is harmless (it just won't match anything).
+ */
+export const INTENT_ACTION_MAP = {
+    coding: new Set([
+        "CREATE_TASK",
+        "SPAWN_AGENT",
+        "PROVISION_WORKSPACE",
+        "FINALIZE_WORKSPACE",
+        "LIST_AGENTS",
+        "SEND_TO_AGENT",
+        "STOP_AGENT",
+    ]),
+    terminal: new Set(["SHELL_COMMAND", "RESTART_AGENT"]),
+    issues: new Set(["MANAGE_ISSUES"]),
+    emote: new Set(["PLAY_EMOTE"]),
+    plugin_ui: new Set(["RESTART_AGENT"]),
+    wallet: new Set(),
+};
+export function hasIntent(prompt, keywords) {
+    const taskMatch = prompt.match(/<task>([\s\S]*?)<\/task>/i);
+    const taskText = (taskMatch?.[1] ?? "").slice(0, 2000);
+    if (keywords.test(taskText))
+        return true;
+    // Extract just the user's message line(s) from "# Received Message".
+    // The section also contains instructions with generic words like "execute",
+    // "run", "command" — only match against the actual user text.
+    const msgSection = prompt.indexOf("# Received Message");
+    if (msgSection !== -1) {
+        const afterHeader = prompt.slice(msgSection + "# Received Message".length);
+        // User message is between the header and the next section marker (# or <)
+        const nextSection = afterHeader.search(/\n#|\n<|\n\n\n/);
+        const userMsg = (nextSection !== -1
+            ? afterHeader.slice(0, nextSection)
+            : afterHeader.slice(0, 500)).trim();
+        if (keywords.test(userMsg))
+            return true;
+    }
+    return false;
+}
+/**
+ * Validate INTENT_ACTION_MAP against the runtime's registered actions.
+ * Logs warnings for any mapped action names that don't exist in the runtime.
+ * Call once at startup after plugins are loaded.
+ */
+export function validateIntentActionMap(registeredActions, logger) {
+    const registered = new Set(registeredActions.map((a) => a.toUpperCase()));
+    for (const [category, actions] of Object.entries(INTENT_ACTION_MAP)) {
+        for (const action of actions) {
+            if (!registered.has(action)) {
+                logger?.warn(`[eliza] INTENT_ACTION_MAP["${category}"] references "${action}" which is not a registered action — may be renamed or removed upstream`);
+            }
+        }
+    }
+}
+/**
+ * Detect which intent categories are present in the prompt.
+ * Returns array of category names (e.g. ["coding", "terminal"]).
+ * Multiple categories can match simultaneously.
+ */
+export function detectIntentCategories(prompt) {
+    const categories = [];
+    if (hasIntent(prompt, CODING_INTENT_RE))
+        categories.push("coding");
+    if (hasIntent(prompt, TERMINAL_INTENT_RE))
+        categories.push("terminal");
+    if (hasIntent(prompt, ISSUE_INTENT_RE))
+        categories.push("issues");
+    if (hasIntent(prompt, EMOTE_INTENT_RE))
+        categories.push("emote");
+    if (hasIntent(prompt, PLUGIN_UI_INTENT_RE))
+        categories.push("plugin_ui");
+    if (hasIntent(prompt, WALLET_INTENT_RE))
+        categories.push("wallet");
+    return categories;
+}
+/**
+ * Build the set of action names that should get full param detail.
+ * Universal actions are always included. Intent-matched actions are
+ * added based on detected categories. Everything else gets stub-only.
+ */
+export function buildFullParamActionSet(intentCategories) {
+    const fullActions = new Set(UNIVERSAL_ACTIONS);
+    for (const cat of intentCategories) {
+        const actions = INTENT_ACTION_MAP[cat];
+        if (actions) {
+            for (const a of actions)
+                fullActions.add(a);
+        }
+    }
+    // Coding intent also implies terminal + issues
+    if (intentCategories.includes("coding")) {
+        for (const a of INTENT_ACTION_MAP.terminal)
+            fullActions.add(a);
+        for (const a of INTENT_ACTION_MAP.issues)
+            fullActions.add(a);
+    }
+    return fullActions;
+}
+/**
+ * Strip internal thoughts, action lists, and entity UUIDs from conversation
+ * history when no coding/swarm intent is detected. For general chat, the
+ * agent's previous reasoning and action selections are noise — only the
+ * actual messages matter. Coding tasks keep the full context so the swarm
+ * coordinator can see its previous reasoning chain.
+ *
+ * Targets lines like:
+ *   (Eliza's internal thought: User wants me to spawn...)
+ *   (Eliza's actions: REPLY, CREATE_TASK)
+ *   12:53 (17 minutes ago) [b850bc30-45f8-0041-a00a-83df46d8555d]
+ *                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ UUID
+ */
+export function compactConversationHistory(prompt) {
+    if (hasIntent(prompt, CODING_INTENT_RE))
+        return prompt;
+    // Wallet/on-chain turns need full history for transaction context
+    if (hasIntent(prompt, WALLET_INTENT_RE))
+        return prompt;
+    const msgStart = prompt.indexOf("# Conversation Messages");
+    if (msgStart === -1)
+        return prompt;
+    const msgEnd = prompt.indexOf("\n# Received Message", msgStart);
+    if (msgEnd === -1)
+        return prompt;
+    const before = prompt.slice(0, msgStart);
+    const history = prompt.slice(msgStart, msgEnd);
+    const after = prompt.slice(msgEnd);
+    const compacted = history
+        // Strip internal thought lines (single-line only — [^\n]* prevents
+        // eating across lines if the thought contains unbalanced parens)
+        .replace(/\n\([^\n]*'s internal thought:[^\n]*\)/g, "")
+        // Strip action list lines
+        .replace(/\n\s*\([^)]*'s actions:.*?\)/g, "")
+        // Strip entity UUIDs from timestamps: [b850bc30-45f8-...] → ""
+        .replace(/\s*\[[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\]/g, "")
+        // Collapse multiple blank lines
+        .replace(/\n{3,}/g, "\n\n");
+    return before + compacted + after;
+}
+/**
+ * Strip the task-agent examples provider section when no task/coding intent
+ * is detected. These examples teach the LLM how to use CREATE_TASK /
+ * SPAWN_AGENT / FINALIZE_WORKSPACE and related aliases, which are unnecessary
+ * for general chat, emote, or plugin-config messages.
+ */
+export function compactCodingExamplesForIntent(prompt) {
+    if (hasIntent(prompt, CODING_INTENT_RE))
+        return prompt;
+    // Guard: if the boundary header is missing, don't strip — the regex would
+    // match to end-of-string and remove everything after the examples header.
+    if (!prompt.includes("# Available Actions"))
+        return prompt;
+    // Strip everything from the examples header up to (but not including)
+    // the "# Available Actions" header. The examples section contains its own
+    // <actions> tags as part of the examples, so we can't use <actions> as a
+    // boundary — we must match the markdown header specifically.
+    return prompt.replace(/# (?:Coding|Task) Agent Action Call Examples[\s\S]*?(?=\n# Available Actions)/, "");
+}
+/**
+ * Context-aware action formatting. Replaces the <actions>...</actions>
+ * block in the prompt with a version where only intent-relevant actions
+ * have full <params> — the rest are stubs with just name + description.
+ *
+ * If no intents are detected (general chat), only universal actions
+ * (REPLY, NONE, IGNORE) keep full params — all others are stubbed.
+ */
+export function compactActionsForIntent(prompt) {
+    // Wallet / on-chain tasks need full action param schemas for reliable tool
+    // invocation across providers and languages. Skip action compaction here.
+    if (hasIntent(prompt, WALLET_INTENT_RE)) {
+        return prompt;
+    }
+    // NOTE: Intent detection is English-keyword-based. Non-English messages may
+    // not trigger any intent, causing all non-universal action params to be
+    // stripped. This is a graceful degradation — action names and descriptions
+    // are always preserved, so the LLM can still select the right action; it
+    // just won't see detailed param schemas until the user triggers a known intent.
+    // Find the first <actions>...</actions> block (the Available Actions section)
+    const actionsStart = prompt.indexOf("<actions>");
+    if (actionsStart === -1)
+        return prompt;
+    const actionsEnd = prompt.indexOf("</actions>", actionsStart);
+    if (actionsEnd === -1)
+        return prompt;
+    const actionsBlock = prompt.slice(actionsStart + "<actions>".length, actionsEnd);
+    const intentCategories = detectIntentCategories(prompt);
+    // When no specific intent is detected, it's general chat — only universal
+    // actions (REPLY, NONE, IGNORE) need full detail. All other actions get
+    // stubs so the LLM knows they exist but doesn't waste context on params.
+    const fullParamActions = buildFullParamActionSet(intentCategories);
+    // Parse individual <action>...</action> blocks
+    const actionRegex = /<action>([\s\S]*?)<\/action>/g;
+    const compactedActions = [];
+    for (const match of actionsBlock.matchAll(actionRegex)) {
+        const actionInner = match[1];
+        const nameMatch = actionInner.match(/<name>([\s\S]*?)<\/name>/);
+        if (!nameMatch)
+            continue;
+        const actionName = nameMatch[1].trim();
+        if (fullParamActions.has(actionName)) {
+            // Keep full action with params
+            compactedActions.push(`  <action>${actionInner}</action>`);
+        }
+        else {
+            // Stub: name + description only, strip <params>
+            const descMatch = actionInner.match(/<description>([\s\S]*?)<\/description>/);
+            const desc = descMatch?.[1]?.trim() ?? "";
+            compactedActions.push(`  <action>\n    <name>${actionName}</name>\n    <description>${desc}</description>\n  </action>`);
+        }
+    }
+    const compactedBlock = `<actions>\n${compactedActions.join("\n")}\n</actions>`;
+    return `${prompt.slice(0, actionsStart)}${compactedBlock}${prompt.slice(actionsEnd + "</actions>".length)}`;
+}
+export function compactModelPrompt(prompt) {
+    const hasCodingIntent = hasIntent(prompt, CODING_INTENT_RE);
+    const hasPluginUiIntent = hasIntent(prompt, PLUGIN_UI_INTENT_RE);
+    let next = prompt;
+    next = compactInitialCodeMarker(next);
+    if (!hasCodingIntent) {
+        next = compactCodingActionExamples(next);
+    }
+    // Action compaction is handled by installPromptOptimizations before
+    // compactModelPrompt is called — no need to run it again here.
+    next = compactLoadedPluginLists(next);
+    next = compactEmoteCatalog(next);
+    if (!hasCodingIntent) {
+        next = compactInstalledSkills(next);
+    }
+    if (!hasPluginUiIntent) {
+        next = compactRegistryCatalog(next);
+        next = compactUiCatalog(next);
+    }
+    else {
+        next = compactUiComponentCatalog(next);
+    }
+    if (!hasCodingIntent) {
+        next = compactWorkspaceContextForNonCoding(next);
+    }
+    return next;
+}

package/packages/agent/src/runtime/prompt-optimization.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Prompt optimization layer for eliza.
+ *
+ * Wraps `runtime.useModel()` to apply context-aware action compaction
+ * and optional prompt tracing/capture. Controlled via ELIZA_* env vars.
+ */
+import { type AgentRuntime } from "@elizaos/core";
+export { buildFullParamActionSet, compactActionsForIntent, detectIntentCategories, } from "./prompt-compaction.js";
+export declare function shouldPreserveFullPromptForTrajectoryCapture(): boolean;
+export declare function installPromptOptimizations(runtime: AgentRuntime): void;
+//# sourceMappingURL=prompt-optimization.d.ts.map

package/packages/agent/src/runtime/prompt-optimization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-optimization.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/prompt-optimization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,KAAK,YAAY,EAAwB,MAAM,eAAe,CAAC;AAoBxE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AA6DhC,wBAAgB,4CAA4C,IAAI,OAAO,CAEtE;AA8SD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CA4KtE"}