@elizaos/agent 2.0.0-alpha.441 → 2.0.0-alpha.501

package/packages/typescript/src/action-docs.js

@@ -1,4 +1,5 @@
 import { allActionDocs, allEvaluatorDocs } from "./generated/action-docs.js";
+import { compressPromptDescription } from "./utils/prompt-compression.js";
 const coreActionDocByName = allActionDocs.reduce((acc, doc) => {
     acc[doc.name] = doc;
     return acc;
@@ -7,7 +8,8 @@ function toActionParameter(param) {
     return {
         name: param.name,
         description: param.description,
-        descriptionCompressed: param.descriptionCompressed,
+        descriptionCompressed: param.descriptionCompressed ??
+            compressPromptDescription(param.description),
         required: param.required,
         schema: {
             ...param.schema,
@@ -16,6 +18,12 @@ function toActionParameter(param) {
         examples: param.examples ? [...param.examples] : undefined,
     };
 }
+function ensureParameterCompressed(parameters) {
+    return parameters.map((p) => ({
+        ...p,
+        descriptionCompressed: p.descriptionCompressed ?? compressPromptDescription(p.description),
+    }));
+}
 /**
  * Merge canonical docs (description/similes/parameters) into an action definition.
  *
@@ -23,18 +31,34 @@ function toActionParameter(param) {
  * - does not overwrite an existing action.description
  * - does not overwrite existing action.similes
  * - does not overwrite existing action.parameters
+ *
+ * Always fills `descriptionCompressed` (and parameter-level compressed descriptions)
+ * when absent, matching Python `compress_prompt_description` so prompt compression
+ * is on for every registered action — including plugins with no canonical spec row.
  */
 export function withCanonicalActionDocs(action) {
     const doc = coreActionDocByName[action.name];
-    if (!doc)
-        return action;
+    const mergedDescription = (doc ? action.description || doc.description : action.description) ?? "";
+    const descriptionCompressed = action.descriptionCompressed ??
+        doc?.descriptionCompressed ??
+        compressPromptDescription(mergedDescription);
+    if (!doc) {
+        const parameters = (action.parameters?.length ?? 0)
+            ? ensureParameterCompressed(action.parameters ?? [])
+            : action.parameters;
+        return {
+            ...action,
+            descriptionCompressed,
+            parameters,
+        };
+    }
     const parameters = action.parameters && action.parameters.length > 0
-        ? action.parameters
+        ? ensureParameterCompressed(action.parameters)
         : (doc.parameters ?? []).map(toActionParameter);
     return {
         ...action,
         description: action.description || doc.description,
-        descriptionCompressed: action.descriptionCompressed || doc.descriptionCompressed,
+        descriptionCompressed,
         similes: action.similes && action.similes.length > 0
             ? action.similes
             : doc.similes

package/packages/typescript/src/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../../typescript/src/actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,MAAM,EAEN,eAAe,EAEf,gBAAgB,EAGhB,MAAM,SAAS,CAAC;AAwBjB,eAAO,MAAM,qBAAqB,GACjC,aAAa,MAAM,EAAE,EACrB,OAAO,MAAM,EACb,aAAgB,KACd,MA8CF,CAAC;AAmBF;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,MAAM,GACjB,MAAM,CAgBR;AA8GD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,SAAY,GAAG,MAAM,CAM7E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,SAAY,GAAG,MAAM,CAwCzE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CA0B5E;AAuBD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAChC,WAAW,EAAE,OAAO,GAClB,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAyE/B;AA+HD,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,gBAAgB,GAAG,SAAS,GAC3C;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAyC5E"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../../typescript/src/actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,MAAM,EAEN,eAAe,EAEf,gBAAgB,EAGhB,MAAM,SAAS,CAAC;AAwBjB,eAAO,MAAM,qBAAqB,GACjC,aAAa,MAAM,EAAE,EACrB,OAAO,MAAM,EACb,aAAgB,KACd,MA8CF,CAAC;AAmBF;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,MAAM,GACjB,MAAM,CAgBR;AAsHD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,SAAY,GAAG,MAAM,CAM7E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,SAAY,GAAG,MAAM,CAwCzE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CA0B5E;AAuBD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAChC,WAAW,EAAE,OAAO,GAClB,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAyE/B;AA+ID,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,gBAAgB,GAAG,SAAS,GAC3C;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAyC5E"}

package/packages/typescript/src/actions.js

@@ -127,7 +127,9 @@ function shuffleActions(items, seed = "actions") {
 }
 function formatActionSimiles(action) {
     const similes = [
-        ...new Set((action.similes ?? []).map((simile) => simile.trim())),
+        ...new Set((action.similes ?? [])
+            .filter((simile) => typeof simile === "string")
+            .map((simile) => simile.trim())),
     ].filter((simile) => simile.length > 0);
     if (similes.length === 0) {
         return null;
@@ -136,7 +138,9 @@ function formatActionSimiles(action) {
 }
 function formatActionTags(action) {
     const tags = [
-        ...new Set((action.tags ?? []).map((tag) => tag.trim())),
+        ...new Set((action.tags ?? [])
+            .filter((tag) => typeof tag === "string")
+            .map((tag) => tag.trim())),
     ].filter((tag) => tag.length > 0 && tag !== "always-include");
     if (tags.length === 0) {
         return null;
@@ -356,7 +360,19 @@ function extractXmlChildren(xml) {
         }
         const closeIdx = searchStart - closeSeq.length;
         const innerRaw = xml.slice(startTagEnd + 1, closeIdx).trim();
-        pairs.push({ key: tag, value: innerRaw });
+        // LLM-tolerance: if the tag is a generic `<param name="X">value</param>`,
+        // prefer the `name` attribute as the key. Some planners emit attribute-
+        // named params instead of tag-named ones, and the canonical handler
+        // expects key=actual-param-name not key="param".
+        let resolvedKey = tag;
+        if (tag.toLowerCase() === "param") {
+            const nameAttrMatch = startTagText.match(/\bname\s*=\s*(?:"([^"]+)"|'([^']+)'|([A-Za-z0-9_-]+))/);
+            const candidate = nameAttrMatch?.[1] ?? nameAttrMatch?.[2] ?? nameAttrMatch?.[3];
+            if (candidate && candidate.length > 0) {
+                resolvedKey = candidate;
+            }
+        }
+        pairs.push({ key: resolvedKey, value: innerRaw });
         i = searchStart;
     }
     return pairs;

package/packages/typescript/src/features/advanced-capabilities/actions/removeContact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"removeContact.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/actions/removeContact.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACX,MAAM,EAQN,MAAM,yBAAyB,CAAC;AAkBjC,eAAO,MAAM,mBAAmB,EAAE,MAsHjC,CAAC"}
+{"version":3,"file":"removeContact.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/actions/removeContact.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACX,MAAM,EAQN,MAAM,yBAAyB,CAAC;AAkBjC,eAAO,MAAM,mBAAmB,EAAE,MAyIjC,CAAC"}

package/packages/typescript/src/features/advanced-capabilities/actions/removeContact.js

@@ -13,6 +13,7 @@ export const removeContactAction = {
     name: spec.name,
     similes: spec.similes ? [...spec.similes] : [],
     description: spec.description,
+    suppressPostActionContinuation: true,
     examples: (spec.examples ?? []),
     validate: async (runtime, message, _state) => {
         const hasService = !!runtime.getService("relationships");
@@ -53,14 +54,22 @@ export const removeContactAction = {
                 await callback?.({
                     text: "I couldn't determine which contact to remove. Please specify the contact name.",
                 });
-                return;
+                return {
+                    success: false,
+                    text: "I couldn't determine which contact to remove. Please specify the contact name.",
+                    data: { actionName: "REMOVE_CONTACT" },
+                };
             }
             const confirmed = parsed.confirmed?.trim().toLowerCase();
             if (confirmed !== "yes") {
                 await callback?.({
                     text: `To remove ${parsed.contactName} from your contacts, please confirm by saying "yes, remove ${parsed.contactName}".`,
                 });
-                return;
+                return {
+                    success: false,
+                    text: `To remove ${parsed.contactName} from your contacts, please confirm by saying "yes, remove ${parsed.contactName}".`,
+                    data: { actionName: "REMOVE_CONTACT", confirmationRequired: true },
+                };
             }
             const contacts = await relationshipsService.searchContacts({
                 searchTerm: parsed.contactName,
@@ -69,7 +78,11 @@ export const removeContactAction = {
                 await callback?.({
                     text: `I couldn't find a contact named "${parsed.contactName}" in the relationships.`,
                 });
-                return;
+                return {
+                    success: false,
+                    text: `I couldn't find a contact named "${parsed.contactName}" in the relationships.`,
+                    data: { actionName: "REMOVE_CONTACT" },
+                };
             }
             const contact = contacts[0];
             const removed = await relationshipsService.removeContact(contact.entityId);
@@ -83,7 +96,7 @@ export const removeContactAction = {
                 return {
                     success: true,
                     values: { contactId: contact.entityId },
-                    data: { success: true },
+                    data: { actionName: "REMOVE_CONTACT", success: true },
                     text: responseText,
                 };
             }
@@ -97,6 +110,12 @@ export const removeContactAction = {
                 text: "I encountered an error while removing the contact. Please try again.",
                 error: error instanceof Error ? error.message : "Unknown error",
             });
+            return {
+                success: false,
+                text: "I encountered an error while removing the contact. Please try again.",
+                error: error instanceof Error ? error.message : String(error),
+                data: { actionName: "REMOVE_CONTACT" },
+            };
         }
     },
 };

package/packages/typescript/src/features/advanced-capabilities/actions/scheduleFollowUp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduleFollowUp.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/actions/scheduleFollowUp.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACX,MAAM,EAQN,MAAM,yBAAyB,CAAC;AAqBjC,eAAO,MAAM,sBAAsB,EAAE,MAkLpC,CAAC"}
+{"version":3,"file":"scheduleFollowUp.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/actions/scheduleFollowUp.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACX,MAAM,EAQN,MAAM,yBAAyB,CAAC;AAqBjC,eAAO,MAAM,sBAAsB,EAAE,MAoLpC,CAAC"}

package/packages/typescript/src/features/advanced-capabilities/actions/scheduleFollowUp.js

@@ -16,6 +16,7 @@ export const scheduleFollowUpAction = {
     description: spec.description,
     similes: spec.similes ? [...spec.similes] : [],
     examples: (spec.examples ?? []),
+    suppressPostActionContinuation: true,
     validate: async (runtime, message, _state) => {
         if (runtime.actions.some((action) => action.name === "OWNER_RELATIONSHIP" ||
             action.name === "RELATIONSHIP")) {
@@ -123,6 +124,7 @@ export const scheduleFollowUpAction = {
                 taskId: task.id ?? "",
             },
             data: {
+                actionName: "SCHEDULE_FOLLOW_UP",
                 contactId: entityId,
                 contactName: resolvedContactName,
                 scheduledAt: scheduledAt.toISOString(),

package/packages/typescript/src/features/advanced-capabilities/actions/searchContacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchContacts.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/actions/searchContacts.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACX,MAAM,EAQN,MAAM,yBAAyB,CAAC;AAoBjC,eAAO,MAAM,oBAAoB,EAAE,MA6MlC,CAAC"}
+{"version":3,"file":"searchContacts.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/actions/searchContacts.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACX,MAAM,EAQN,MAAM,yBAAyB,CAAC;AAoBjC,eAAO,MAAM,oBAAoB,EAAE,MA+MlC,CAAC"}

package/packages/typescript/src/features/advanced-capabilities/actions/searchContacts.js

@@ -13,6 +13,7 @@ export const searchContactsAction = {
     name: spec.name,
     description: spec.description,
     similes: spec.similes ? [...spec.similes] : [],
+    suppressPostActionContinuation: true,
     examples: (spec.examples ?? []),
     validate: async (runtime, message, _state) => {
         // Check if RelationshipsService is available
@@ -161,6 +162,7 @@ export const searchContactsAction = {
                 criteria,
             },
             data: {
+                actionName: "SEARCH_CONTACTS",
                 count: contactDetails.length,
                 criteria,
                 contacts: contactDetails.map((d) => ({

package/packages/typescript/src/features/advanced-capabilities/actions/updateContact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateContact.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/actions/updateContact.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACX,MAAM,EAQN,MAAM,yBAAyB,CAAC;AAoCjC,eAAO,MAAM,mBAAmB,EAAE,MA8MjC,CAAC"}
+{"version":3,"file":"updateContact.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/actions/updateContact.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACX,MAAM,EAQN,MAAM,yBAAyB,CAAC;AAoCjC,eAAO,MAAM,mBAAmB,EAAE,MAkOjC,CAAC"}

package/packages/typescript/src/features/advanced-capabilities/actions/updateContact.js

@@ -26,6 +26,7 @@ export const updateContactAction = {
     name: spec.name,
     similes: spec.similes ? [...spec.similes] : [],
     description: spec.description,
+    suppressPostActionContinuation: true,
     examples: (spec.examples ?? []),
     validate: async (runtime, message, _state) => {
         const hasService = !!runtime.getService("relationships");
@@ -67,7 +68,11 @@ export const updateContactAction = {
                 await callback?.({
                     text: "I couldn't understand the update request. Please try again.",
                 });
-                return;
+                return {
+                    success: false,
+                    text: "I couldn't understand the update request. Please try again.",
+                    data: { actionName: "UPDATE_CONTACT" },
+                };
             }
             const contactName = parsed.contactName?.trim();
             if (!contactName) {
@@ -75,7 +80,11 @@ export const updateContactAction = {
                 await callback?.({
                     text: "I couldn't determine which contact to update. Please specify the contact name.",
                 });
-                return;
+                return {
+                    success: false,
+                    text: "I couldn't determine which contact to update. Please specify the contact name.",
+                    data: { actionName: "UPDATE_CONTACT" },
+                };
             }
             // Find the contact entity
             const contacts = await relationshipsService.searchContacts({
@@ -85,7 +94,11 @@ export const updateContactAction = {
                 await callback?.({
                     text: `I couldn't find a contact named "${contactName}" in the relationships.`,
                 });
-                return;
+                return {
+                    success: false,
+                    text: `I couldn't find a contact named "${contactName}" in the relationships.`,
+                    data: { actionName: "UPDATE_CONTACT" },
+                };
             }
             const contact = contacts[0];
             const operation = parsed.operation || "replace";
@@ -178,6 +191,7 @@ export const updateContactAction = {
                         tagsStr: updateData.tags?.join(",") ?? "",
                     },
                     data: {
+                        actionName: "UPDATE_CONTACT",
                         success: true,
                         updatedFieldsStr: Object.keys(updateData).join(","),
                     },
@@ -194,6 +208,12 @@ export const updateContactAction = {
                 text: "I encountered an error while updating the contact. Please try again.",
                 error: error instanceof Error ? error.message : "Unknown error",
             });
+            return {
+                success: false,
+                text: "I encountered an error while updating the contact. Please try again.",
+                error: error instanceof Error ? error.message : String(error),
+                data: { actionName: "UPDATE_CONTACT" },
+            };
         }
     },
 };

package/packages/typescript/src/features/advanced-capabilities/clipboard/actions/read-attachment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-attachment.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/actions/read-attachment.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,MAAM,EAQX,MAAM,4BAA4B,CAAC;AAQpC,eAAO,MAAM,oBAAoB,EAAE,MA8HlC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"read-attachment.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/actions/read-attachment.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,MAAM,EAQX,MAAM,4BAA4B,CAAC;AAQpC,eAAO,MAAM,oBAAoB,EAAE,MAsIlC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/packages/typescript/src/features/advanced-capabilities/clipboard/actions/read-attachment.js

@@ -5,6 +5,7 @@ export const readAttachmentAction = {
     name: "READ_ATTACHMENT",
     similes: ["OPEN_ATTACHMENT", "INSPECT_ATTACHMENT"],
     description: "Read a stored attachment by attachment ID. Use this instead of relying on inline attachment descriptions in the conversation context. Set addToClipboard=true to keep the result in bounded task clipboard state.",
+    suppressPostActionContinuation: true,
     validate: async (runtime, message) => {
         const isAttachmentRequest = typeof message.content.attachmentId === "string" ||
             /attachment|image|screenshot|file/i.test(String(message.content.text ?? ""));
@@ -32,7 +33,11 @@ export const readAttachmentAction = {
                         source: message.content.source,
                     });
                 }
-                return { success: false, text: fallback };
+                return {
+                    success: false,
+                    text: fallback,
+                    data: { actionName: "READ_ATTACHMENT" },
+                };
             }
             const storedContent = result.content.trim();
             const clipboardResult = await maybeStoreTaskClipboardItem(runtime, message, {
@@ -83,10 +88,12 @@ export const readAttachmentAction = {
                 success: true,
                 text: responseText,
                 data: {
+                    actionName: "READ_ATTACHMENT",
                     attachmentId: result.attachment.id,
                     attachment: result.attachment,
                     content: storedContent,
                     clipboard: clipboardResult,
+                    suppressActionResultClipboard: clipboardResult.requested,
                 },
             };
         }
@@ -104,6 +111,7 @@ export const readAttachmentAction = {
                 success: false,
                 text: "Failed to read attachment",
                 error: errorMessage,
+                data: { actionName: "READ_ATTACHMENT" },
             };
         }
     },

package/packages/typescript/src/features/advanced-capabilities/clipboard/actions/read-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/actions/read-file.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,MAAM,EAGX,KAAK,aAAa,EAElB,KAAK,MAAM,EAGX,KAAK,KAAK,EACV,MAAM,4BAA4B,CAAC;AAKpC,KAAK,aAAa,GAAG;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAmGF,wBAAsB,uBAAuB,CAC5C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,EACb,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACpC,OAAO,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC,CA8CD;AAED,eAAO,MAAM,cAAc,EAAE,MAiG5B,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/actions/read-file.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,MAAM,EAGX,KAAK,aAAa,EAElB,KAAK,MAAM,EAGX,KAAK,KAAK,EACV,MAAM,4BAA4B,CAAC;AAKpC,KAAK,aAAa,GAAG;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAmGF,wBAAsB,uBAAuB,CAC5C,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,EACb,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACpC,OAAO,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC,CA8CD;AAED,eAAO,MAAM,cAAc,EAAE,MAqG5B,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/packages/typescript/src/features/advanced-capabilities/clipboard/actions/read-file.js

@@ -116,6 +116,7 @@ export const readFileAction = {
     name: "READ_FILE",
     similes: ["OPEN_FILE", "LOAD_FILE"],
     description: "Read a local text file for the current task. Returns the file content so the agent can reference it. Set addToClipboard=true to keep the read result in bounded task clipboard state.",
+    suppressPostActionContinuation: true,
     validate: async (_runtime, message) => {
         if (typeof message.content.filePath === "string" ||
             typeof message.content.path === "string") {
@@ -171,8 +172,10 @@ export const readFileAction = {
                 success: true,
                 text: responseText,
                 data: {
+                    actionName: "READ_FILE",
                     ...result,
                     clipboard: clipboardResult,
+                    suppressActionResultClipboard: clipboardResult.requested,
                 },
             };
         }
@@ -190,6 +193,7 @@ export const readFileAction = {
                 success: false,
                 text: "Failed to read file",
                 error: errorMessage,
+                data: { actionName: "READ_FILE" },
             };
         }
     },

package/packages/typescript/src/features/advanced-capabilities/clipboard/actions/save-attachment-to-clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"save-attachment-to-clipboard.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/actions/save-attachment-to-clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,MAAM,EAQX,MAAM,4BAA4B,CAAC;AA4CpC,eAAO,MAAM,+BAA+B,EAAE,MAuH7C,CAAC;AAEF,eAAe,+BAA+B,CAAC"}
+{"version":3,"file":"save-attachment-to-clipboard.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/actions/save-attachment-to-clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,MAAM,EAQX,MAAM,4BAA4B,CAAC;AA4CpC,eAAO,MAAM,+BAA+B,EAAE,MA8H7C,CAAC;AAEF,eAAe,+BAA+B,CAAC"}

package/packages/typescript/src/features/advanced-capabilities/clipboard/actions/save-attachment-to-clipboard.js

@@ -28,6 +28,8 @@ export const saveAttachmentToClipboardAction = {
         "SAVE_OUTPUT_TO_CLIPBOARD",
     ],
     description: "Save a stored conversation attachment into bounded task clipboard state. Use after an action produces an attachment that should remain available for chained work.",
+    suppressActionResultClipboard: true,
+    suppressPostActionContinuation: true,
     validate: async (runtime, message, _state) => {
         if (resolveAttachmentId(message, undefined)) {
             return true;
@@ -51,7 +53,11 @@ export const saveAttachmentToClipboardAction = {
                     actions: ["SAVE_ATTACHMENT_TO_CLIPBOARD_FAILED"],
                     source: message.content.source,
                 });
-                return { success: false, text };
+                return {
+                    success: false,
+                    text,
+                    data: { actionName: "SAVE_ATTACHMENT_TO_CLIPBOARD" },
+                };
             }
             const title = resolveTitle(message, options);
             const content = result.content.trim();
@@ -105,6 +111,7 @@ export const saveAttachmentToClipboardAction = {
                 success: false,
                 text: "Failed to save attachment to clipboard",
                 error: errorMessage,
+                data: { actionName: "SAVE_ATTACHMENT_TO_CLIPBOARD" },
             };
         }
     },

package/packages/typescript/src/features/advanced-capabilities/clipboard/types.d.ts

@@ -58,7 +58,7 @@ export interface ClipboardConfig {
     allowedExtensions?: string[];
 }
 export declare const TASK_CLIPBOARD_MAX_ITEMS = 5;
-export type TaskClipboardSourceType = "manual" | "command" | "file" | "attachment" | "image_attachment" | "channel" | "conversation_search" | "entity" | "entity_search";
+export type TaskClipboardSourceType = "manual" | "command" | "file" | "attachment" | "image_attachment" | "channel" | "conversation_search" | "entity" | "entity_search" | "action_result";
 export interface TaskClipboardItem {
     /** Stable clipboard item ID exposed to the agent context. */
     id: string;

package/packages/typescript/src/features/advanced-capabilities/clipboard/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC9B,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,8BAA8B;IAC9B,UAAU,EAAE,IAAI,CAAC;IACjB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACrC,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACpC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACrC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACtC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC/B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,MAAM,MAAM,uBAAuB,GAChC,QAAQ,GACR,SAAS,GACT,MAAM,GACN,YAAY,GACZ,kBAAkB,GAClB,SAAS,GACT,qBAAqB,GACrB,QAAQ,GACR,eAAe,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IACjC,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,EAAE,uBAAuB,CAAC;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/clipboard/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC9B,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,8BAA8B;IAC9B,UAAU,EAAE,IAAI,CAAC;IACjB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACrC,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACpC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACrC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACtC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC/B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,MAAM,MAAM,uBAAuB,GAChC,QAAQ,GACR,SAAS,GACT,MAAM,GACN,YAAY,GACZ,kBAAkB,GAClB,SAAS,GACT,qBAAqB,GACrB,QAAQ,GACR,eAAe,GACf,eAAe,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IACjC,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,EAAE,uBAAuB,CAAC;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/packages/typescript/src/features/advanced-capabilities/evaluators/factExtractor.js

@@ -335,7 +335,7 @@ async function insertFact(ctx, args) {
 }
 async function applyStrengthen(ctx, op) {
     const fact = ctx.candidatesById.get(op.factId);
-    if (!fact || !fact.id)
+    if (!fact?.id)
         return false;
     await applyStrengthenForMemory(ctx, fact);
     return true;
@@ -400,7 +400,7 @@ async function applyStrengthenForMemory(ctx, fact) {
 }
 async function applyDecay(ctx, op) {
     const fact = ctx.candidatesById.get(op.factId);
-    if (!fact || !fact.id)
+    if (!fact?.id)
         return false;
     const nextConfidence = clamp01(pickFactConfidence(fact) - DECAY_DELTA);
     if (nextConfidence < FACT_DECAY_FLOOR) {

package/packages/typescript/src/features/advanced-capabilities/experience/actions/record-experience.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"record-experience.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/experience/actions/record-experience.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,MAAM,EAKN,MAAM,iCAAiC,CAAC;AAezC,eAAO,MAAM,sBAAsB,EAAE,MAiJpC,CAAC"}
+{"version":3,"file":"record-experience.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/experience/actions/record-experience.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,MAAM,EAKN,MAAM,iCAAiC,CAAC;AAezC,eAAO,MAAM,sBAAsB,EAAE,MAkJpC,CAAC"}

package/packages/typescript/src/features/advanced-capabilities/experience/actions/record-experience.js

@@ -88,6 +88,7 @@ export const recordExperienceAction = {
             learning: sanitizedLearning,
             domain: detectExperienceDomain(sanitizedLearning),
             tags: ["manual", "explicit"],
+            associatedEntityIds: message.entityId ? [message.entityId] : [],
             sourceMessageIds: message.id ? [message.id] : undefined,
             sourceRoomId: message.roomId,
             sourceTriggerMessageId: message.id,

package/packages/typescript/src/features/advanced-capabilities/experience/actions/search-experiences.d.ts

@@ -0,0 +1,3 @@
+import type { Action } from "../../../../types/components.ts";
+export declare const searchExperiencesAction: Action;
+//# sourceMappingURL=search-experiences.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/experience/actions/search-experiences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-experiences.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/experience/actions/search-experiences.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,MAAM,EAKN,MAAM,iCAAiC,CAAC;AASzC,eAAO,MAAM,uBAAuB,EAAE,MAkIrC,CAAC"}

package/packages/typescript/src/features/advanced-capabilities/experience/actions/search-experiences.js

@@ -0,0 +1,110 @@
+import { logger } from "../../../../logger.js";
+import { formatExperienceForPrompt } from "../utils/experienceFormatter.js";
+const SEARCH_EXPERIENCES = "SEARCH_EXPERIENCES";
+export const searchExperiencesAction = {
+    name: SEARCH_EXPERIENCES,
+    similes: [
+        "FIND_EXPERIENCES",
+        "SEARCH_MEMORY_GRAPH",
+        "EXPLORE_EXPERIENCES",
+        "WHAT_HAVE_I_LEARNED",
+    ],
+    description: "Search the agent's experience graph, return compact learnings, and provide follow-up actions for copying or chaining results.",
+    examples: [
+        [
+            {
+                name: "{{user}}",
+                content: {
+                    text: "Search experiences about TypeScript build failures",
+                    actions: [SEARCH_EXPERIENCES],
+                },
+            },
+            {
+                name: "{{agent}}",
+                content: {
+                    text: "I found matching experiences and a small related graph.",
+                },
+            },
+        ],
+    ],
+    validate: async (runtime, message, _state, _options) => {
+        const text = typeof message.content.text === "string"
+            ? message.content.text.toLowerCase()
+            : "";
+        if (!runtime.getService("EXPERIENCE")) {
+            return false;
+        }
+        return (/\b(experience|experiences|learned|learning|memory graph)\b/.test(text) &&
+            /\b(search|find|explore|what|show|recall|know)\b/.test(text));
+    },
+    async handler(runtime, message, _state, _options, callback) {
+        const experienceService = runtime.getService("EXPERIENCE");
+        if (!experienceService) {
+            return {
+                success: false,
+                text: "Experience service is unavailable.",
+            };
+        }
+        const query = extractExperienceSearchQuery(message);
+        const experiences = await experienceService.queryExperiences({
+            query,
+            limit: 7,
+            minConfidence: 0.3,
+            includeRelated: true,
+        });
+        const graph = await experienceService.getExperienceGraph({
+            query,
+            limit: 20,
+            minConfidence: 0.3,
+            includeRelated: true,
+        });
+        const resultText = experiences.length > 0
+            ? experiences
+                .map((experience, index) => formatExperienceForPrompt(experience, index))
+                .join("\n\n")
+            : `No experiences found for "${query}".`;
+        const text = `[EXPERIENCE SEARCH]\nQuery: ${query}\nMatches: ${experiences.length}\nGraph: ${graph.nodes.length} nodes, ${graph.links.length} links\n\n${resultText}`;
+        if (callback) {
+            await callback({
+                text,
+                actions: [SEARCH_EXPERIENCES],
+                source: message.content.source,
+            }, SEARCH_EXPERIENCES);
+        }
+        logger.info(`[SearchExperiencesAction] Returned ${experiences.length} experiences for query "${query}"`);
+        return {
+            success: true,
+            text,
+            data: {
+                query,
+                experiences,
+                graph,
+                postActions: [
+                    {
+                        id: "copy-experience-results",
+                        label: "Copy experience search results",
+                        action: "CLIPBOARD_WRITE",
+                        input: {
+                            title: `Experience search: ${query}`,
+                            content: resultText,
+                            tags: ["experience-search", "experience-graph"],
+                        },
+                    },
+                ],
+            },
+            values: {
+                experienceSearchQuery: query,
+                experienceSearchCount: String(experiences.length),
+            },
+            continueChain: experiences.length > 0,
+        };
+    },
+};
+function extractExperienceSearchQuery(message) {
+    const text = typeof message.content.text === "string" ? message.content.text : "";
+    const normalized = text
+        .replace(/^\s*(?:please\s+)?(?:search|find|explore|show|recall)\s+(?:my\s+|the\s+)?(?:experience|experiences|memory graph|learnings?)\s*(?:for|about|on)?\s*/i, "")
+        .replace(/^\s*what\s+(?:do\s+you|have\s+you|did\s+you)\s+(?:know|learn|remember)\s+(?:about|on)?\s*/i, "")
+        .trim();
+    return normalized || text.trim() || "recent useful experiences";
+}

package/packages/typescript/src/features/advanced-capabilities/experience/evaluators/experienceEvaluator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"experienceEvaluator.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/experience/evaluators/experienceEvaluator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEX,SAAS,EAGT,MAAM,iCAAiC,CAAC;AAgCzC,eAAO,MAAM,mBAAmB,EAAE,SAoQjC,CAAC"}
+{"version":3,"file":"experienceEvaluator.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/experience/evaluators/experienceEvaluator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEX,SAAS,EAGT,MAAM,iCAAiC,CAAC;AAgCzC,eAAO,MAAM,mBAAmB,EAAE,SAqQjC,CAAC"}

package/packages/typescript/src/features/advanced-capabilities/experience/evaluators/experienceEvaluator.js

@@ -172,6 +172,7 @@ export const experienceEvaluator = {
                 sourceTriggerMessageId: provenance.sourceTriggerMessageId,
                 sourceTrajectoryId: provenance.sourceTrajectoryId,
                 sourceTrajectoryStepId: provenance.sourceTrajectoryStepId,
+                associatedEntityIds: provenance.associatedEntityIds,
                 extractionMethod: "experience_evaluator",
                 extractionReason: sanitizedReason,
             });
@@ -274,10 +275,14 @@ function buildExperienceProvenance(triggerMessage, recentMessages) {
     const sourceMessageIds = recentMessages
         .map((recentMessage) => recentMessage.id)
         .filter((id) => typeof id === "string");
+    const associatedEntityIds = Array.from(new Set(recentMessages
+        .map((recentMessage) => recentMessage.entityId)
+        .filter((entityId) => typeof entityId === "string")));
     return {
         sourceMessageIds: sourceMessageIds.length > 0 ? sourceMessageIds : undefined,
         sourceRoomId: triggerMessage.roomId,
         sourceTriggerMessageId: triggerMessage.id,
+        associatedEntityIds,
         sourceTrajectoryId: readMetadataString(triggerMessage, "trajectoryId"),
         sourceTrajectoryStepId: readMetadataString(triggerMessage, "trajectoryStepId"),
     };

package/packages/typescript/src/features/advanced-capabilities/experience/index.d.ts

@@ -2,6 +2,7 @@
  * Experience learning bundled with advanced capabilities.
  */
 export { recordExperienceAction } from "./actions/record-experience.ts";
+export { searchExperiencesAction } from "./actions/search-experiences.ts";
 export { experienceEvaluator } from "./evaluators/experienceEvaluator.ts";
 export { experienceProvider } from "./providers/experienceProvider.ts";
 export type { ExperienceService } from "./service.ts";