@elizaos/ui 2.0.0-alpha.344 → 2.0.0-alpha.346

package/packages/typescript/src/services/message.js

@@ -13,7 +13,9 @@ import { ModelType } from "../types/model";
 import { incomingPipelineHookContext, modelStreamChunkPipelineHookContext, outgoingPipelineHookContext, parallelWithShouldRespondPipelineHookContext, preShouldRespondPipelineHookContext, } from "../types/pipeline-hooks";
 import { asUUID, ChannelType, ContentType } from "../types/primitives";
 import { composePromptFromState, getLocalServerUrl, parseBooleanFromText, parseJSONObjectFromText, parseKeyValueXml, truncateToCompleteSentence, } from "../utils";
+import { collectActionResultSizeWarnings, formatActionResultsForPrompt, trimActionResultForPromptState, } from "../utils/action-results";
 import { AVAILABLE_CONTEXTS_STATE_KEY, attachAvailableContexts, CONTEXT_ROUTING_STATE_KEY, getActiveRoutingContexts, mergeContextRouting, parseContextRoutingMetadata, setContextRoutingMetadata, } from "../utils/context-routing";
+import { getUserMessageText } from "../utils/message-text";
 import { createStreamingContext, MarkableExtractor, ResponseStreamExtractor, } from "../utils/streaming";
 import { extractFirstSentence, hasFirstSentence, } from "../utils/text-splitting";
 import { OPTIMIZED_PROMPT_SERVICE, } from "./optimized-prompt";
@@ -718,18 +720,32 @@ function unwrapPlannerIdentifier(value) {
         return nameMatch[1].trim();
     }
     const actionMatch = trimmed.match(/^<action\b[^>]*>([\s\S]*?)<\/action>$/i);
-    if (!actionMatch) {
-        return trimmed;
-    }
-    const inner = actionMatch[1].trim();
-    if (!inner) {
-        return "";
-    }
-    const nestedNameMatch = inner.match(/<name\b[^>]*>([\s\S]*?)<\/name>/i);
-    if (nestedNameMatch) {
-        return nestedNameMatch[1].trim();
+    if (actionMatch) {
+        const inner = actionMatch[1].trim();
+        if (!inner) {
+            return "";
+        }
+        const nestedNameMatch = inner.match(/<name\b[^>]*>([\s\S]*?)<\/name>/i);
+        if (nestedNameMatch) {
+            return nestedNameMatch[1].trim();
+        }
+        return /<[A-Za-z][^>]*>/.test(inner) ? trimmed : inner;
+    }
+    // Tolerate malformed planner output where the closing </action> is missing
+    // or extra content trails the action body. Symptom in prod logs:
+    //   "Dropping unknown planner action (actionName=<action><name>REPLY</name>)"
+    // The planner LLM occasionally emits an unclosed <action> wrapper around a
+    // well-formed <name>X</name>. Falling through to "return trimmed" treats
+    // the whole XML chunk as the action identifier, which then fails to match
+    // any registered action and the bot goes silent. If the input begins with
+    // <action> and contains a <name>X</name>, prefer that name.
+    if (/^<action\b[^>]*>/i.test(trimmed)) {
+        const looseNameMatch = trimmed.match(/<name\b[^>]*>([\s\S]*?)<\/name>/i);
+        if (looseNameMatch) {
+            return looseNameMatch[1].trim();
+        }
     }
-    return /<[A-Za-z][^>]*>/.test(inner) ? trimmed : inner;
+    return trimmed;
 }
 const PLANNER_ACTION_ALIASES = new Map([
     ["BULK_RESCHEDULE", "OWNER_CALENDAR"],
@@ -1146,9 +1162,7 @@ function findDirectOwnedActionSuggestion(runtime, messageText) {
     return null;
 }
 export function suggestOwnedActionFromMetadata(runtime, message) {
-    const messageText = typeof message.content?.text === "string"
-        ? message.content.text.trim()
-        : "";
+    const messageText = getUserMessageText(message);
     if (messageText.length === 0 ||
         !ACTION_OWNERSHIP_TRIGGER_PATTERNS.some((pattern) => pattern.test(messageText))) {
         return null;
@@ -1247,7 +1261,7 @@ function shouldAttemptActionRescue(runtime, message, state, responseContent) {
     return true;
 }
 function getMessageText(message) {
-    return typeof message.content?.text === "string" ? message.content.text : "";
+    return getUserMessageText(message);
 }
 function looksLikeOwnershipSensitiveRequest(message) {
     const text = getMessageText(message).toLowerCase();
@@ -1565,19 +1579,24 @@ export function shouldEmitPlannerPreamble(runtime, responseContent) {
         normalizedFirstAction !== normalizeActionIdentifier("IGNORE") &&
         normalizedFirstAction !== normalizeActionIdentifier("STOP"));
 }
+// Actions that are passive bookkeeping / chitchat. Safe to drop when a
+// turn-owning action (one that sets suppressPostActionContinuation = true,
+// e.g. SPAWN_AGENT) is also picked for the same turn. Keeping them around
+// alongside explicit delegation produces duplicate user-visible noise:
+// "Created task X" message followed by the actual delegated result.
+const PASSIVE_TURN_ACTIONS = new Set(["REPLY", "MANAGE_TASKS"].map(normalizeActionIdentifier));
 export function stripReplyWhenActionOwnsTurn(runtime, actions) {
     if (!actions || actions.length <= 1) {
         return Array.isArray(actions) ? [...actions] : [];
     }
-    const normalizedReply = normalizeActionIdentifier("REPLY");
-    const hasReply = actions.some((action) => normalizeActionIdentifier(action) === normalizedReply);
-    if (!hasReply) {
+    const hasPassive = actions.some((action) => PASSIVE_TURN_ACTIONS.has(normalizeActionIdentifier(action)));
+    if (!hasPassive) {
         return [...actions];
     }
     const actionLookup = buildRuntimeActionLookup(runtime);
     const ownedActions = actions.filter((action) => {
         const normalized = normalizeActionIdentifier(action);
-        if (!normalized || normalized === normalizedReply) {
+        if (!normalized || PASSIVE_TURN_ACTIONS.has(normalized)) {
             return false;
         }
         return (resolveRuntimeAction(actionLookup, action)
@@ -1586,13 +1605,13 @@ export function stripReplyWhenActionOwnsTurn(runtime, actions) {
     if (ownedActions.length === 0) {
         return [...actions];
     }
-    const filtered = actions.filter((action) => normalizeActionIdentifier(action) !== normalizedReply);
+    const filtered = actions.filter((action) => !PASSIVE_TURN_ACTIONS.has(normalizeActionIdentifier(action)));
     runtime.logger.info({
         src: "service:message",
         originalActions: actions,
         filteredActions: filtered,
-        replySuppressedBy: ownedActions,
-    }, "Dropped REPLY because another selected action already owns the turn");
+        suppressedBy: ownedActions,
+    }, "Dropped passive actions because another selected action already owns the turn");
     return filtered.length > 0 ? filtered : ["REPLY"];
 }
 function callbackTextPreview(content) {
@@ -1768,34 +1787,7 @@ function shouldWaitForUserAfterIncompleteReflection(responseContent, actionResul
         return normalizeActionIdentifier(actionName) === "REPLY";
     });
 }
-function formatActionResultsForPrompt(actionResults) {
-    if (actionResults.length === 0) {
-        return "No action results available.";
-    }
-    return [
-        "# Action Results",
-        ...actionResults.map((result, index) => {
-            const actionNameValue = result.data?.actionName;
-            const actionName = typeof actionNameValue === "string"
-                ? actionNameValue
-                : "Unknown Action";
-            const lines = [
-                `${index + 1}. ${actionName} - ${result.success === false ? "failed" : "succeeded"}`,
-            ];
-            if (typeof result.text === "string" && result.text.trim()) {
-                lines.push(`Output: ${result.text.trim().slice(0, 2000)}`);
-            }
-            if (result.error) {
-                const errorText = result.error instanceof Error
-                    ? result.error.message
-                    : String(result.error);
-                lines.push(`Error: ${errorText.slice(0, 1000)}`);
-            }
-            return lines.join("\n");
-        }),
-    ].join("\n\n");
-}
-function withActionResults(state, actionResults) {
+export function withActionResultsForPrompt(state, actionResults) {
     return {
         ...state,
         values: {
@@ -1808,6 +1800,23 @@ function withActionResults(state, actionResults) {
         },
     };
 }
+const withActionResults = withActionResultsForPrompt;
+function preparePromptActionResult(runtime, message, result) {
+    for (const warning of collectActionResultSizeWarnings(result)) {
+        runtime.logger.warn({
+            src: "service:message",
+            agentId: runtime.agentId,
+            messageId: message.id,
+            roomId: message.roomId,
+            action: warning.actionName,
+            field: warning.field,
+            rawCharLength: warning.rawCharLength,
+            estimatedTokens: warning.estimatedTokens,
+            thresholdTokens: warning.thresholdTokens,
+        }, "Action result exceeds prompt-size warning threshold");
+    }
+    return trimActionResultForPromptState(result);
+}
 function withTaskCompletion(state, taskCompletion) {
     if (!taskCompletion) {
         return state;
@@ -1827,52 +1836,6 @@ function withTaskCompletion(state, taskCompletion) {
         },
     };
 }
-function getStructuredOutputFailure(state) {
-    const candidate = state.data?.structuredOutputFailure;
-    if (!candidate || typeof candidate !== "object") {
-        return null;
-    }
-    return candidate;
-}
-function summarizeStructuredOutputFailure(failure) {
-    if (!failure) {
-        return "Structured output parsing failed, but no additional diagnostics were recorded.";
-    }
-    const parts = [
-        `Kind: ${failure.kind}`,
-        `Model: ${failure.model}`,
-        `Format: ${failure.format}`,
-        `Attempts: ${failure.attempts}/${failure.maxRetries + 1}`,
-    ];
-    if (failure.key) {
-        parts.push(`Key: ${failure.key}`);
-    }
-    if (failure.parseError) {
-        parts.push(`Error: ${failure.parseError}`);
-    }
-    if (failure.issues && failure.issues.length > 0) {
-        parts.push(`Issues: ${failure.issues.join(" | ")}`);
-    }
-    if (failure.responsePreview) {
-        parts.push(`Response Preview:\n${failure.responsePreview}`);
-    }
-    return parts.join("\n");
-}
-function summarizeActionResultsForUser(actionResults) {
-    if (actionResults.length === 0) {
-        return "";
-    }
-    const summary = actionResults
-        .slice(-3)
-        .map((result) => {
-        const actionName = typeof result.data?.actionName === "string"
-            ? result.data.actionName
-            : "unknown action";
-        return `${actionName} (${result.success === false ? "failed" : "succeeded"})`;
-    })
-        .join(", ");
-    return `Completed action state before the error: ${summary}.`;
-}
 function withContextRoutingValues(state, contextRoutingStateValues) {
     if (!contextRoutingStateValues) {
         return state;
@@ -2406,6 +2369,9 @@ export class DefaultMessageService {
                 // Ensure latestResponseIds is cleaned up even if processMessage
                 // threw before reaching its own cleanup at the end of the method.
                 clearLatestResponseId(runtime.agentId, message.roomId, responseId);
+                if (message.id) {
+                    runtime.stateCache.delete(`${message.id}_action_results`);
+                }
             }
         });
     }
@@ -4345,7 +4311,6 @@ Output ONLY the continuation, starting immediately after the last character abov
         }
     }
     async buildStructuredFailureReply(runtime, message, state, responseId, stage) {
-        const failure = getStructuredOutputFailure(state);
         const recentMessages = typeof state.values?.recentMessages === "string" &&
             state.values.recentMessages.trim().length > 0
             ? state.values.recentMessages
@@ -4354,35 +4319,29 @@ Output ONLY the continuation, starting immediately after the last character abov
                 : typeof message.content.text === "string"
                     ? message.content.text
                     : "(unavailable)";
-        const actionResults = Array.isArray(state.data?.actionResults)
-            ? state.data.actionResults
-            : [];
         const failurePrompt = [
-            "You are recovering from an internal structured-output failure while responding to a user.",
-            "Write the next user-facing reply in plain language.",
-            "",
-            "Rules:",
-            "- Explain what failed and why using only the diagnostics below.",
-            "- Mention any completed or failed actions if action results are available.",
-            "- Be transparent, concise, and avoid inventing causes.",
-            "- If the model returned malformed XML, TOON, or JSON, say that clearly.",
-            "- Suggest the most useful next step for the user.",
-            "- Return only the reply text. No XML, JSON, TOON, bullet labels, or <think>.",
+            "You hit a transient model error and have to send a short user-facing reply.",
+            "Write a one or two sentence reply in plain language.",
             "",
-            `Failure Stage: ${stage}`,
-            "",
-            "Structured Failure Diagnostics:",
-            summarizeStructuredOutputFailure(failure),
+            "Hard rules:",
+            "- Stay in character. Keep your usual voice and tone.",
+            "- NEVER mention internal mechanism words such as: planner, action_planner,",
+            "  XML, TOON, JSON, schema, structured output, model, retries, sonnet,",
+            "  opus, claude, anthropic, prompt, parse, parser, xml plan, decision",
+            "  loop, runtime, dispatch, or hand off. The user does not know or care",
+            "  what those are.",
+            "- Do not use em-dashes or en-dashes. Use a plain hyphen, period, or comma.",
+            "- Just acknowledge that something went wrong and suggest a retry.",
+            '  Examples: "something flaked, try again in a sec",',
+            '  "weird hiccup, give me another shot in a moment",',
+            '  "got stuck on my end, retry that?"',
+            "- If the user already gave a clear command and you can plausibly act,",
+            "  acknowledge it and offer to take the action directly. Keep it short.",
+            "- Return only the reply text. No labels, no XML, no JSON, no <think>.",
             "",
             "Recent Conversation:",
             recentMessages,
             "",
-            "Action Results So Far:",
-            typeof state.values?.actionResults === "string" &&
-                state.values.actionResults.trim().length > 0
-                ? state.values.actionResults
-                : "No action results available.",
-            "",
             "Reply:",
         ].join("\n");
         let replyText = "";
@@ -4426,21 +4385,17 @@ Output ONLY the continuation, starting immediately after the last character abov
             }
         }
         if (!replyText) {
-            const failureReason = failure?.parseError ??
-                failure?.issues?.[0] ??
-                "the model returned output that did not match the required format";
-            replyText = [
-                `I hit an internal parsing error while ${stage}.`,
-                `Reason: ${failureReason}.`,
-                summarizeActionResultsForUser(actionResults),
-                "Please try again or ask me to retry the last step.",
-            ]
-                .filter(Boolean)
-                .join(" ");
+            // Last-ditch fallback when every model call above also failed.
+            // Voice-neutral so any character can ship this default; characters
+            // can override with their own phrasing via
+            // character.templates.transientFailureReply.
+            replyText =
+                runtime.character.templates?.transientFailureReply ||
+                    "Something went wrong on my end. Please try again.";
         }
         replyText = truncateToCompleteSentence(replyText.trim(), 2000);
         const responseContent = {
-            thought: `Explain the structured-output failure during ${stage}.`,
+            thought: `Handle a temporary reply failure during ${stage}.`,
             actions: ["REPLY"],
             providers: [],
             text: replyText,
@@ -4483,7 +4438,7 @@ Output ONLY the continuation, starting immediately after the last character abov
                 maxIterations: opts.maxMultiStepIterations,
             }, "Starting multi-step iteration");
             accumulatedState = withContextRoutingValues((await runtime.composeState(message, ["RECENT_MESSAGES", "ACTION_STATE", "PROVIDERS"], false, false)), contextRoutingStateValues);
-            accumulatedState.data.actionResults = traceActionResult;
+            accumulatedState = withActionResults(accumulatedState, traceActionResult);
             // Use dynamicPromptExecFromState for structured decision output
             const optimizedPlannerService = runtime.getService(OPTIMIZED_PROMPT_SERVICE);
             const baselinePlannerTemplate = runtime.character.templates?.multiStepDecisionTemplate ||
@@ -4680,12 +4635,12 @@ Output ONLY the continuation, starting immediately after the last character abov
             for (const result of providerResults) {
                 if (result.status === "fulfilled") {
                     const { providerName, success, text, error } = result.value;
-                    traceActionResult.push({
+                    traceActionResult.push(preparePromptActionResult(runtime, message, {
                         data: { actionName: providerName },
                         success,
                         text,
                         error,
-                    });
+                    }));
                     if (callback) {
                         await callback({
                             text: `🔎 Provider executed: ${providerName}`,
@@ -4755,6 +4710,7 @@ Output ONLY the continuation, starting immediately after the last character abov
             runtime.logger.warn({ src: "service:message", maxIterations: opts.maxMultiStepIterations }, "Reached maximum iterations, forcing completion");
         }
         accumulatedState = withContextRoutingValues((await runtime.composeState(message, ["RECENT_MESSAGES", "ACTION_STATE"], false, false)), contextRoutingStateValues);
+        accumulatedState = withActionResults(accumulatedState, traceActionResult);
         // Use dynamicPromptExecFromState for final summary generation
         // Stream the final summary for better UX
         const summary = await runtime.dynamicPromptExecFromState({

package/packages/typescript/src/utils/action-results.d.ts

@@ -0,0 +1,33 @@
+import type { ActionResult } from "../types/components";
+export declare const MAX_PROMPTED_ACTION_RESULTS = 8;
+export declare const MAX_ACTION_RESULT_TEXT_CHARS = 4000;
+export declare const MAX_ACTION_RESULT_ERROR_CHARS = 2000;
+export declare const ACTION_RESULT_OVERSIZE_WARNING_TOKENS = 10000;
+export declare const ACTION_RESULT_TOKEN_ESTIMATE_CHARS = 4;
+export declare const ACTION_RESULT_FULL_OUTPUT_REFERENCE_KEYS: Set<string>;
+export declare const ACTION_RESULT_FULL_ERROR_REFERENCE_KEYS: Set<string>;
+export type ActionResultTextField = "text" | "error";
+export interface ActionResultSizeWarning {
+    actionName: string;
+    field: ActionResultTextField;
+    rawCharLength: number;
+    estimatedTokens: number;
+    thresholdTokens: number;
+}
+export interface ActionResultReferences {
+    text?: string;
+    error?: string;
+}
+export declare function estimateActionResultTokens(text: string): number;
+export declare function getActionResultActionName(result: ActionResult): string;
+export declare function stringifyActionResultError(error: ActionResult["error"]): string | undefined;
+export declare function getActionResultReference(result: ActionResult, field: ActionResultTextField): string | undefined;
+export declare function truncateMiddle(text: string, maxChars: number, reference?: string): string;
+export declare function collectActionResultSizeWarnings(result: ActionResult, thresholdTokens?: number): ActionResultSizeWarning[];
+export declare function trimActionResultForPromptState<T extends ActionResult>(result: T, references?: ActionResultReferences): T;
+export declare function formatActionResultsForPrompt(actionResults: ActionResult[], options?: {
+    header?: string;
+    maxResults?: number;
+    preserveAbsoluteIndex?: boolean;
+}): string;
+//# sourceMappingURL=action-results.d.ts.map

package/packages/typescript/src/utils/action-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-results.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/utils/action-results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAClD,eAAO,MAAM,qCAAqC,QAAQ,CAAC;AAC3D,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAEpD,eAAO,MAAM,wCAAwC,aAYnD,CAAC;AAEH,eAAO,MAAM,uCAAuC,aASlD,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAKtE;AAED,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAC1B,MAAM,GAAG,SAAS,CAKpB;AAkBD,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,qBAAqB,GAC1B,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,cAAc,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GAChB,MAAM,CAoBR;AAED,wBAAgB,+BAA+B,CAC9C,MAAM,EAAE,YAAY,EACpB,eAAe,SAAwC,GACrD,uBAAuB,EAAE,CAwB3B;AAED,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,YAAY,EACpE,MAAM,EAAE,CAAC,EACT,UAAU,GAAE,sBAA2B,GACrC,CAAC,CAiCH;AAED,wBAAgB,4BAA4B,CAC3C,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,GAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC3B,GACJ,MAAM,CA4DR"}

package/packages/typescript/src/utils/action-results.js

@@ -0,0 +1,169 @@
+export const MAX_PROMPTED_ACTION_RESULTS = 8;
+export const MAX_ACTION_RESULT_TEXT_CHARS = 4000;
+export const MAX_ACTION_RESULT_ERROR_CHARS = 2000;
+export const ACTION_RESULT_OVERSIZE_WARNING_TOKENS = 10000;
+export const ACTION_RESULT_TOKEN_ESTIMATE_CHARS = 4;
+export const ACTION_RESULT_FULL_OUTPUT_REFERENCE_KEYS = new Set([
+    "fullOutputPath",
+    "fullOutputFile",
+    "outputPath",
+    "outputFile",
+    "outputFilePath",
+    "stdoutPath",
+    "stdoutFile",
+    "artifactPath",
+    "resultPath",
+    "filePath",
+    "path",
+]);
+export const ACTION_RESULT_FULL_ERROR_REFERENCE_KEYS = new Set([
+    "fullErrorPath",
+    "fullErrorFile",
+    "errorPath",
+    "errorFile",
+    "stderrPath",
+    "stderrFile",
+    "logPath",
+    "logFile",
+]);
+export function estimateActionResultTokens(text) {
+    return Math.ceil(text.length / ACTION_RESULT_TOKEN_ESTIMATE_CHARS);
+}
+export function getActionResultActionName(result) {
+    const actionNameValue = result.data?.actionName;
+    return typeof actionNameValue === "string" && actionNameValue.trim()
+        ? actionNameValue.trim()
+        : "Unknown Action";
+}
+export function stringifyActionResultError(error) {
+    if (error === undefined || error === null) {
+        return undefined;
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+function getReferenceFromData(data, keys) {
+    if (!data) {
+        return undefined;
+    }
+    for (const key of keys) {
+        const value = data[key];
+        if (typeof value === "string" && value.trim()) {
+            return value.trim();
+        }
+    }
+    return undefined;
+}
+export function getActionResultReference(result, field) {
+    return getReferenceFromData(result.data, field === "text"
+        ? ACTION_RESULT_FULL_OUTPUT_REFERENCE_KEYS
+        : ACTION_RESULT_FULL_ERROR_REFERENCE_KEYS);
+}
+export function truncateMiddle(text, maxChars, reference) {
+    const trimmed = text.trim();
+    if (trimmed.length <= maxChars) {
+        return trimmed;
+    }
+    let marker = "\n\n[... chars omitted ...]\n\n";
+    let available = Math.max(0, maxChars - marker.length);
+    let headChars = Math.ceil(available / 2);
+    let tailChars = Math.floor(available / 2);
+    const omittedChars = Math.max(0, trimmed.length - headChars - tailChars);
+    marker = `\n\n[... ${omittedChars} chars omitted ...]\n\n`;
+    available = Math.max(0, maxChars - marker.length);
+    headChars = Math.ceil(available / 2);
+    tailChars = Math.floor(available / 2);
+    const rendered = `${trimmed.slice(0, headChars)}${marker}${trimmed.slice(trimmed.length - tailChars)}`;
+    return reference ? `${rendered}\n\nFull output: ${reference}` : rendered;
+}
+export function collectActionResultSizeWarnings(result, thresholdTokens = ACTION_RESULT_OVERSIZE_WARNING_TOKENS) {
+    const actionName = getActionResultActionName(result);
+    const fields = [
+        { field: "text", text: result.text },
+        { field: "error", text: stringifyActionResultError(result.error) },
+    ];
+    return fields.flatMap(({ field, text }) => {
+        if (!text) {
+            return [];
+        }
+        const estimatedTokens = estimateActionResultTokens(text);
+        return estimatedTokens > thresholdTokens
+            ? [
+                {
+                    actionName,
+                    field,
+                    rawCharLength: text.length,
+                    estimatedTokens,
+                    thresholdTokens,
+                },
+            ]
+            : [];
+    });
+}
+export function trimActionResultForPromptState(result, references = {}) {
+    const textReference = references.text ?? getActionResultReference(result, "text");
+    const errorReference = references.error ?? getActionResultReference(result, "error");
+    const data = { ...(result.data ?? {}) };
+    if (textReference) {
+        data.fullOutputPath = textReference;
+    }
+    if (errorReference) {
+        data.fullErrorPath = errorReference;
+    }
+    const text = typeof result.text === "string"
+        ? truncateMiddle(result.text, MAX_ACTION_RESULT_TEXT_CHARS, textReference)
+        : result.text;
+    const errorText = stringifyActionResultError(result.error);
+    const error = errorText === undefined
+        ? result.error
+        : truncateMiddle(errorText, MAX_ACTION_RESULT_ERROR_CHARS, errorReference);
+    return {
+        ...result,
+        ...(text !== undefined ? { text } : {}),
+        ...(error !== undefined ? { error } : {}),
+        data,
+    };
+}
+export function formatActionResultsForPrompt(actionResults, options = {}) {
+    const { header = "# Current Chain Action Results", maxResults = MAX_PROMPTED_ACTION_RESULTS, preserveAbsoluteIndex = true, } = options;
+    if (actionResults.length === 0) {
+        return "No action results available.";
+    }
+    const rendered = actionResults.length > maxResults
+        ? actionResults.slice(-maxResults)
+        : actionResults;
+    const truncatedCount = actionResults.length - rendered.length;
+    const omittedNote = truncatedCount > 0
+        ? [`(${truncatedCount} earlier action result(s) omitted.)`]
+        : [];
+    return [
+        header,
+        ...omittedNote,
+        ...rendered.map((result, index) => {
+            const displayIndex = preserveAbsoluteIndex
+                ? truncatedCount + index + 1
+                : index + 1;
+            const status = result.success === false ? "failed" : "succeeded";
+            const lines = [
+                `${displayIndex}. ${getActionResultActionName(result)} - ${status}`,
+            ];
+            if (typeof result.text === "string" && result.text.trim()) {
+                lines.push(`Output: ${result.text.trim()}`);
+            }
+            const errorText = stringifyActionResultError(result.error);
+            if (errorText) {
+                lines.push(`Error: ${errorText}`);
+            }
+            const outputReference = getActionResultReference(result, "text");
+            if (outputReference &&
+                !lines.some((line) => line.includes(outputReference))) {
+                lines.push(`Full output: ${outputReference}`);
+            }
+            const errorReference = getActionResultReference(result, "error");
+            if (errorReference &&
+                !lines.some((line) => line.includes(errorReference))) {
+                lines.push(`Full error: ${errorReference}`);
+            }
+            return lines.join("\n");
+        }),
+    ].join("\n\n");
+}

package/packages/typescript/src/utils/context-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-catalog.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/utils/context-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE1E,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAqG7D,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAsB/D,CAAC;AAUF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAOpE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,EAAE,CAO1E"}
+{"version":3,"file":"context-catalog.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/utils/context-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE1E,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CA8G7D,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAwB/D,CAAC;AAUF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAOpE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,EAAE,CAO1E"}

package/packages/typescript/src/utils/context-catalog.js

@@ -38,6 +38,7 @@ export const ACTION_CONTEXT_MAP = {
     WEB_SEARCH: ["knowledge", "browser"],
     SUMMARIZE: ["knowledge"],
     ANALYZE: ["knowledge"],
+    CREATE_TASK: ["code", "automation"],
     BROWSER_SESSION: ["browser"],
     BROWSE: ["browser"],
     SCREENSHOT: ["browser", "media"],
@@ -46,6 +47,14 @@ export const ACTION_CONTEXT_MAP = {
     TYPE_TEXT: ["browser"],
     EXTRACT_PAGE: ["browser", "knowledge"],
     SPAWN_AGENT: ["code", "automation"],
+    SEND_TO_AGENT: ["code", "automation"],
+    LIST_AGENTS: ["code", "automation"],
+    STOP_AGENT: ["code", "automation"],
+    TASK_HISTORY: ["code", "automation"],
+    TASK_CONTROL: ["code", "automation"],
+    TASK_SHARE: ["code", "automation"],
+    PROVISION_WORKSPACE: ["code", "automation"],
+    FINALIZE_WORKSPACE: ["code", "automation"],
     KILL_AGENT: ["code", "automation"],
     UPDATE_AGENT: ["code", "system"],
     RUN_SCRIPT: ["code", "automation"],
@@ -115,6 +124,8 @@ export const PROVIDER_CONTEXT_MAP = {
     walletPortfolio: ["wallet"],
     tokenPrices: ["wallet", "knowledge"],
     chainInfo: ["wallet"],
+    CODING_AGENT_EXAMPLES: ["code", "automation"],
+    ACTIVE_WORKSPACE_CONTEXT: ["code", "automation"],
     contacts: ["social"],
     trustScores: ["social"],
     platformIdentity: ["social"],

package/packages/typescript/src/utils/context-routing.d.ts

@@ -15,9 +15,12 @@ export declare function getContextRoutingFromState(state: State | null | undefin
 export declare function getContextRoutingFromMessage(message: Memory): ContextRoutingDecision;
 export declare function mergeContextRouting(state: State | null | undefined, message: Memory): ContextRoutingDecision;
 export declare function getActiveRoutingContexts(routing: ContextRoutingDecision): AgentContext[];
+export declare function getActiveRoutingContextsForTurn(state: State | null | undefined, message: Memory): AgentContext[];
 export declare function shouldIncludeByContext(declaredContexts: AgentContext[] | undefined, activeContexts: AgentContext[] | undefined): boolean;
 export declare function setContextRoutingMetadata(message: Memory, routing: ContextRoutingDecision): void;
 export declare function deriveAvailableContexts(actions: Action[], providers: Provider[]): AgentContext[];
+export declare function inferContextRoutingFromText(text: string | null | undefined): ContextRoutingDecision;
+export declare function inferContextRoutingFromMessage(message: Pick<Memory, "content">): ContextRoutingDecision;
 export declare function attachAvailableContexts(state: State, runtime: {
     actions: Action[];
     providers: Provider[];

package/packages/typescript/src/utils/context-routing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-routing.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/utils/context-routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAM5C,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAChE,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAChE,eAAO,MAAM,yBAAyB,qBAAqB,CAAC;AAI5D,MAAM,WAAW,sBAAsB;IACtC,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,iBAAiB,CAAC,EAAE,YAAY,EAAE,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AA2CD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,CAI/D;AAED,wBAAgB,2BAA2B,CAC1C,GAAG,EAAE,OAAO,GACV,sBAAsB,CAiBxB;AAED,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAC7B,sBAAsB,CAGxB;AAED,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,MAAM,GACb,sBAAsB,CAQxB;AAED,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,GACb,sBAAsB,CAyBxB;AAED,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,sBAAsB,GAC7B,YAAY,EAAE,CAehB;AAED,wBAAgB,sBAAsB,CACrC,gBAAgB,EAAE,YAAY,EAAE,GAAG,SAAS,EAC5C,cAAc,EAAE,YAAY,EAAE,GAAG,SAAS,GACxC,OAAO,CAcT;AAED,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,sBAAsB,GAC7B,IAAI,CAiBN;AAED,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,QAAQ,EAAE,GACnB,YAAY,EAAE,CAmBhB;AAED,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,QAAQ,EAAE,CAAA;CAAE,GACnD,KAAK,CAYP"}
+{"version":3,"file":"context-routing.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/utils/context-routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAO5C,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAChE,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAChE,eAAO,MAAM,yBAAyB,qBAAqB,CAAC;AAI5D,MAAM,WAAW,sBAAsB;IACtC,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,iBAAiB,CAAC,EAAE,YAAY,EAAE,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AA2CD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,CAI/D;AAED,wBAAgB,2BAA2B,CAC1C,GAAG,EAAE,OAAO,GACV,sBAAsB,CAiBxB;AAED,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAC7B,sBAAsB,CAGxB;AAED,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,MAAM,GACb,sBAAsB,CAQxB;AAED,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,GACb,sBAAsB,CAyBxB;AAED,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,sBAAsB,GAC7B,YAAY,EAAE,CAehB;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,GACb,YAAY,EAAE,CAEhB;AAED,wBAAgB,sBAAsB,CACrC,gBAAgB,EAAE,YAAY,EAAE,GAAG,SAAS,EAC5C,cAAc,EAAE,YAAY,EAAE,GAAG,SAAS,GACxC,OAAO,CAcT;AAED,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,sBAAsB,GAC7B,IAAI,CAiBN;AAED,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,QAAQ,EAAE,GACnB,YAAY,EAAE,CAmBhB;AA8DD,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,sBAAsB,CA6BxB;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,GAC9B,sBAAsB,CAQxB;AAED,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,QAAQ,EAAE,CAAA;CAAE,GACnD,KAAK,CAYP"}