@elizaos/agent 2.0.0-beta.2 → 2.0.11-beta.5

package/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;AAiCD,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,aAAuC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAQzD,CAAC;AASF,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,CAeN;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAU/D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,MAAM,EAAE,EAC1B,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC9B,GAAG,CAAC,MAAM,CAAC,CAmBb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA6BjE;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYrE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GACnC,MAAM,CAyBR;AA4FD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0BzD"}

package/runtime/prompt-compaction.js

@@ -0,0 +1,395 @@
+/**
+ * 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;
+// View-navigation intent. Keeps the VIEWS action/view/viewType params at full
+// detail for implicit "see a domain surface" requests ("what's on my calendar",
+// "check my messages", "add a feature to my app") — otherwise compaction strips
+// the very fields the planner must fill to open the right view. Broad by design:
+// a false positive only preserves param detail, it never triggers an action.
+const VIEWS_INTENT_RE = /\b(go to|take me to|switch to|navigate to|pull up|bring up|what'?s on|let me see|i want to)\b|\b(open|show|see|view|check)\b[\s\S]{0,40}\b(view|views|page|screen|tab|panel|dashboard|inbox|e-?mail|mail|messages?|calendar|schedule|agenda|wallet|balance|portfolio|finances?|spending|budget|settings|preferences|focus|health|sleep|goals?|routines?|reminders?|contacts?|relationships?|notes?|documents?|files?|todos?|tasks?|automations?|plugins?|companion|feed)\b|\bmy\s+(e-?mail|inbox|messages?|calendar|schedule|agenda|wallet|balance|portfolio|finances?|spending|budget|goals?|routines?|reminders?|health|sleep|contacts?|relationships?|todos?|tasks?|notes?|documents?|files?)\b|\b(add (a |an )?(new )?feature|build (me )?(an? )?app|app builder|coding view)\b|(?:mu[eé]strame|ll[eé]vame a|[aá]breme|abre|ver mi|mi (?:calendario|correo|bandeja|cartera|billetera|finanzas|salud|tareas|documentos|contactos|metas|objetivos))|(?:montre-moi|emm[eè]ne-moi|ouvre|ouvrir|mon (?:calendrier|courrier|portefeuille|agenda)|mes (?:messages|finances|t[aâ]ches|documents|contacts|objectifs))|(?:zeig mir|öffne|mein (?:kalender|postfach)|meine (?:nachrichten|brieftasche|finanzen|aufgaben|ziele|gesundheit))|打开|显示|查看|带我去|我的(?:日历|邮件|消息|钱包|财务|健康|待办|文档|联系人|目标)|開いて|見せて|表示して|私の(?:カレンダー|ウォレット)|열어|보여줘|내\s?(?:캘린더|메시지|지갑)/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.
+ *
+ * Names must match registered Action.name strings. Verified live (2026-05-08):
+ *   TASKS         — plugins/plugin-agent-orchestrator/src/actions/tasks.ts:2029
+ *                   (polymorphic action that subsumes the old START_CODING_TASK
+ *                   / CREATE_TASK / SPAWN_AGENT / CREATE_WORKSPACE /
+ *                   SUBMIT_WORKSPACE / LIST_AGENTS / SEND_TO_AGENT /
+ *                   STOP_AGENT / MANAGE_ISSUES sub-ops)
+ *   RUNTIME       — packages/agent/src/actions/runtime.ts:405 (op:"restart"
+ *                   replaces the old RESTART_AGENT)
+ *   SHELL         — packages/agent/src/actions/terminal.ts:261
+ *   PLAY_EMOTE    — plugins/plugin-companion/src/actions/emote.ts:22
+ *
+ * GitHub issue ops live under GITHUB_ISSUE in plugin-github but that plugin
+ * isn't loaded by default — kept out of the map to avoid validator noise; it
+ * still gets surfaced when present because action listing is dynamic.
+ *
+ * TASKS comes from plugin-agent-orchestrator, which is opt-in (not a default
+ * core plugin). It stays mapped so coding/issues prompts keep its full param
+ * schema WHEN the orchestrator is loaded; it's listed in OPTIONAL_PLUGIN_ACTIONS
+ * below so validateIntentActionMap stays quiet when the plugin is absent.
+ */
+export const INTENT_ACTION_MAP = {
+    coding: new Set(["TASKS"]),
+    terminal: new Set(["SHELL", "RUNTIME"]),
+    issues: new Set(["TASKS"]),
+    emote: new Set(["PLAY_EMOTE"]),
+    plugin_ui: new Set(["RUNTIME"]),
+    wallet: new Set(),
+    views: new Set(["VIEWS"]),
+};
+/**
+ * Mapped actions provided only by opt-in plugins (not loaded by default). They
+ * stay in INTENT_ACTION_MAP so they get full param detail when their plugin is
+ * present, but validateIntentActionMap does not warn when they're unregistered.
+ */
+const OPTIONAL_PLUGIN_ACTIONS = new Set(["TASKS"]);
+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)) {
+                // Opt-in plugin actions are expected to be absent when their plugin
+                // isn't loaded — keep them mapped (for full param detail when present)
+                // without emitting startup noise.
+                if (OPTIONAL_PLUGIN_ACTIONS.has(action))
+                    continue;
+                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");
+    if (hasIntent(prompt, VIEWS_INTENT_RE))
+        categories.push("views");
+    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 summary-only.
+ */
+export function buildFullParamActionSet(intentCategories, extraActions) {
+    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);
+    }
+    // Caller-supplied actions (e.g. the active view's scoped actions) are kept at
+    // full detail regardless of detected intent.
+    if (extraActions) {
+        for (const a of extraActions)
+            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, START_CODING_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 START_CODING_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. Match the markdown header specifically
+    // so example bodies cannot affect the boundary.
+    return prompt.replace(/# (?:Coding|Task) Agent Action Call Examples[\s\S]*?(?=\n# Available Actions)/, "");
+}
+/**
+ * Context-aware action formatting. Replaces the available-actions block in
+ * the prompt with a version where only intent-relevant actions keep full
+ * parameter detail — the rest keep just name + description.
+ *
+ * Supports the current markdown action catalogue emitted by the planner:
+ *   # Available Actions
+ *   - ACTION: description
+ *     parameters: { ...JSON schema summary... }
+ *
+ * If no intents are detected (general chat), only universal actions
+ * (REPLY, NONE, IGNORE) keep full params — all others are summarized.
+ */
+export function compactActionsForIntent(prompt, viewScopedActions) {
+    // 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.
+    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
+    // summary entries so the LLM knows they exist without spending context on params.
+    // Actions scoped to the active view are also kept full so the planner can
+    // drive whatever the user is currently looking at.
+    const fullParamActions = buildFullParamActionSet(intentCategories, viewScopedActions);
+    return compactStructuredActionsBlock(prompt, fullParamActions) ?? prompt;
+}
+/**
+ * Locate and compact a structured "Available Actions" block.
+ */
+function compactStructuredActionsBlock(prompt, fullParamActions) {
+    // The planner emits "# Available Actions" followed by markdown bullets:
+    // "- NAME: description" and optional two-space-indented metadata lines.
+    const headerRe = /^# Available Actions[ \t]*$/m;
+    const headerMatch = headerRe.exec(prompt);
+    if (!headerMatch)
+        return null;
+    const blockStart = headerMatch.index;
+    const headerLine = headerMatch[0];
+    const bodyStart = blockStart + headerLine.length;
+    // Walk forward consuming action entries (`- NAME: ...`) and their
+    // two-space-indented continuation lines. Stop at the next markdown section
+    // or the first non-entry line that is not part of the catalogue.
+    const remainder = prompt.slice(bodyStart);
+    const lines = remainder.split("\n");
+    let consumed = 0;
+    if (lines.length > 0 && lines[0] === "") {
+        consumed = 1;
+    }
+    while (consumed < lines.length) {
+        const line = lines[consumed];
+        if (line.startsWith("# ")) {
+            break;
+        }
+        if (line.startsWith("- ") || line.startsWith("  ")) {
+            consumed += 1;
+            continue;
+        }
+        if (line === "") {
+            const next = lines[consumed + 1];
+            if (next?.startsWith("- ")) {
+                consumed += 1;
+                continue;
+            }
+            break;
+        }
+        break;
+    }
+    const bodyLines = lines.slice(0, consumed);
+    const blockEnd = bodyStart + bodyLines.join("\n").length;
+    const entries = [];
+    let current = null;
+    for (const line of bodyLines) {
+        if (line.startsWith("- ")) {
+            if (current)
+                entries.push(current);
+            const nameMatch = /^- ([A-Z0-9_]+):/.exec(line);
+            const name = nameMatch?.[1] ?? "";
+            current = { name, entryLines: [line] };
+        }
+        else if (current && (line.startsWith("  ") || line === "")) {
+            current.entryLines.push(line);
+        }
+    }
+    if (current)
+        entries.push(current);
+    if (entries.length === 0)
+        return null;
+    const compactedEntries = entries.map((entry) => {
+        if (!entry.name || fullParamActions.has(entry.name)) {
+            return entry.entryLines.join("\n");
+        }
+        // Summary entry: keep only `- NAME: description`; drop parameter schema details.
+        return entry.entryLines[0];
+    });
+    while (compactedEntries.length > 0 &&
+        compactedEntries[compactedEntries.length - 1] === "") {
+        compactedEntries.pop();
+    }
+    const compactedBody = compactedEntries.join("\n");
+    const before = prompt.slice(0, bodyStart);
+    const after = prompt.slice(blockEnd);
+    const separator = bodyLines.length > 0 && bodyLines[0] === "" ? "\n" : "";
+    return `${before}${separator}${compactedBody}${after}`;
+}
+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/runtime/prompt-optimization.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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";
+import type { ElizaConfig } from "../config/types.ts";
+import type { CompactorMessage, CompactorModelCall } from "./conversation-compactor.types.ts";
+import { type ApplyConversationCompactionResult, type ApplyConversationMessageCompactionResult } from "./conversation-compactor-runtime.ts";
+export { buildFullParamActionSet, compactActionsForIntent, detectIntentCategories, } from "./prompt-compaction.ts";
+export interface CapturedModelUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    cacheReadInputTokens?: number;
+    cacheCreationInputTokens?: number;
+    cachedInputTokens?: number;
+    model?: string;
+    provider?: string;
+    isEstimated: boolean;
+    llmCalls: number;
+}
+export interface PromptBudgetResult {
+    prompt: string;
+    originalPromptTokens: number;
+    promptTokens: number;
+    budgetTokens: number;
+    truncated: boolean;
+}
+export declare function shouldPreserveFullPromptForTrajectoryCapture(): boolean;
+export declare function estimateTokenCount(text: string): number;
+export declare function withModelUsageCapture<T>(runtime: AgentRuntime, run: () => Promise<T>): Promise<{
+    result: T;
+    usage: CapturedModelUsage | null;
+}>;
+/**
+ * Async pre-step that runs a conversation-compactor strategy when
+ * `ELIZA_CONVERSATION_COMPACTOR` is set and the prompt is over budget.
+ * Returns the original prompt when the env var is unset, the prompt is under
+ * budget, or the compactor cannot reduce the prompt.
+ *
+ * Logs `[eliza] conversation-compaction strategy=X originalTokens=N
+ * compactedTokens=M latencyMs=L` on a successful compaction.
+ */
+export declare function maybeApplyConversationCompaction(runtime: AgentRuntime, prompt: string, budgetTokens: number, callModel: CompactorModelCall, conversationKeyOrOnResult?: string | ((result: ApplyConversationCompactionResult) => void), maybeOnResult?: (result: ApplyConversationCompactionResult) => void): Promise<string>;
+export declare function maybeApplyConversationMessageCompaction(runtime: AgentRuntime, messages: CompactorMessage[], budgetTokens: number, callModel: CompactorModelCall, conversationKeyOrOnResult?: string | ((result: ApplyConversationMessageCompactionResult) => void), maybeOnResult?: (result: ApplyConversationMessageCompactionResult) => void): Promise<CompactorMessage[]>;
+export declare function fitPromptToTokenBudget(prompt: string, budgetTokens: number): PromptBudgetResult;
+export declare function installPromptOptimizations(runtime: AgentRuntime, config?: ElizaConfig): void;
+//# sourceMappingURL=prompt-optimization.d.ts.map

package/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,EACL,KAAK,YAAY,EAMlB,MAAM,eAAe,CAAC;AAMvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,KAAK,iCAAiC,EACtC,KAAK,wCAAwC,EAQ9C,MAAM,qCAAqC,CAAC;AAsB7C,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AA4EhC,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAwBD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,4CAA4C,IAAI,OAAO,CAEtE;AAqVD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AA+YD,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAA;CAAE,CAAC,CAuB1D;AA0ID;;;;;;;;GAQG;AACH,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,kBAAkB,EAC7B,yBAAyB,CAAC,EACtB,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,iCAAiC,KAAK,IAAI,CAAC,EACzD,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,iCAAiC,KAAK,IAAI,GAClE,OAAO,CAAC,MAAM,CAAC,CAsDjB;AAED,wBAAsB,uCAAuC,CAC3D,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,kBAAkB,EAC7B,yBAAyB,CAAC,EACtB,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,wCAAwC,KAAK,IAAI,CAAC,EAChE,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,wCAAwC,KAAK,IAAI,GACzE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsD7B;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,kBAAkB,CAgCpB;AAoDD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,IAAI,CA8aN"}