@elizaos/agent 2.0.0-alpha.437 → 2.0.0-alpha.438

package/apps/app-lifeops/src/lifeops/telegram-local-client.js

@@ -198,6 +198,33 @@ function parseNumericId(value) {
 function readOutboxMaxId(dialog) {
     return parseNumericId(dialog?.dialog?.readOutboxMaxId);
 }
+function firstNonEmptyTelegramId(values) {
+    for (const value of values) {
+        const serialized = serializeTelegramId(value);
+        if (serialized.length > 0) {
+            return serialized;
+        }
+    }
+    return null;
+}
+function messagePeerId(message) {
+    const peer = message.peerId;
+    return firstNonEmptyTelegramId([
+        peer?.userId,
+        peer?.chatId,
+        peer?.channelId,
+    ]);
+}
+function messageSenderId(message) {
+    return firstNonEmptyTelegramId([message.fromId?.userId]);
+}
+function findDialogForMessage(message, dialogs) {
+    const peerId = messagePeerId(message);
+    if (!peerId) {
+        return null;
+    }
+    return (dialogs.find((dialog) => serializeTelegramId(dialog.id) === peerId) ?? null);
+}
 function isGlobalSearchScope(scope) {
     const normalized = scope?.trim().toLowerCase();
     return (!normalized ||
@@ -225,8 +252,12 @@ export async function sendTelegramAccountMessage(args) {
         const dialogs = Array.from(await client.getDialogs({ limit: MAX_TARGET_LOOKUP_DIALOGS }));
         const entity = await resolveTelegramTarget(client, args.target, dialogs);
         const sent = await client.sendMessage(entity, { message: args.message });
+        const messageId = sent?.id !== undefined ? serializeTelegramId(sent.id) : "";
+        if (messageId.length === 0) {
+            throw new Error("Telegram send did not return a message id.");
+        }
         return {
-            messageId: sent?.id !== undefined ? serializeTelegramId(sent.id) : null,
+            messageId,
         };
     });
 }
@@ -249,22 +280,30 @@ export async function searchTelegramMessages(args) {
         return messages
             .filter((message) => Boolean(message))
             .slice(0, limit)
-            .map((message) => ({
-            id: message.id !== undefined
-                ? serializeTelegramId(message.id) || null
-                : null,
-            dialogId: dialog?.id !== undefined
-                ? serializeTelegramId(dialog.id) || null
-                : null,
-            dialogTitle: dialog ? normalizeDialogTitle(dialog) : null,
-            username: typeof dialog?.entity?.username === "string" &&
-                dialog.entity.username.trim().length > 0
-                ? dialog.entity.username.trim()
-                : null,
-            content: normalizeMessageContent(message),
-            timestamp: toIsoDate(message.date),
-            outgoing: message.out === true,
-        }));
+            .map((message) => {
+            const messageDialog = dialog ?? findDialogForMessage(message, dialogs);
+            const dialogId = messageDialog?.id !== undefined
+                ? serializeTelegramId(messageDialog.id) || null
+                : null;
+            const username = typeof messageDialog?.entity?.username === "string" &&
+                messageDialog.entity.username.trim().length > 0
+                ? messageDialog.entity.username.trim()
+                : null;
+            return {
+                id: message.id !== undefined
+                    ? serializeTelegramId(message.id) || null
+                    : null,
+                dialogId,
+                threadId: dialogId,
+                dialogTitle: messageDialog ? normalizeDialogTitle(messageDialog) : null,
+                username,
+                peerId: messagePeerId(message),
+                senderId: messageSenderId(message),
+                content: normalizeMessageContent(message),
+                timestamp: toIsoDate(message.date),
+                outgoing: message.out === true,
+            };
+        });
     });
 }
 export async function getTelegramReadReceipts(args) {
@@ -359,7 +398,11 @@ export async function verifyTelegramLocalConnector(args) {
         try {
             const entity = await resolveTelegramTarget(client, target, dialogs);
             const sent = await client.sendMessage(entity, { message });
-            messageId = sent?.id !== undefined ? serializeTelegramId(sent.id) : null;
+            const sentMessageId = sent?.id !== undefined ? serializeTelegramId(sent.id) : "";
+            if (sentMessageId.length === 0) {
+                throw new Error("Telegram send did not return a message id.");
+            }
+            messageId = sentMessageId;
         }
         catch (error) {
             sendError = error instanceof Error ? error.message : String(error);

package/apps/app-lifeops/src/lifeops/whatsapp-client.d.ts

@@ -6,10 +6,17 @@ export interface WhatsAppCredentials {
 export interface WhatsAppMessage {
     id: string;
     from: string;
+    channelId: string;
     timestamp: string;
     type: "text" | "image" | "audio" | "document" | "unknown";
     text?: string;
     mediaId?: string;
+    metadata?: {
+        displayPhoneNumber?: string;
+        phoneNumberId?: string;
+        contactName?: string;
+        waId?: string;
+    };
 }
 export interface WhatsAppSendRequest {
     to: string;

package/apps/app-lifeops/src/lifeops/whatsapp-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"whatsapp-client.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/lifeops/whatsapp-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,aAAc,SAAQ,KAAK;aAGpB,MAAM,EAAE,MAAM;aACd,IAAI,CAAC,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO;CAKjC;AAOD,wBAAgB,8BAA8B,CAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,mBAAmB,GAAG,IAAI,CAY5B;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAqD1C;AA0CD;;;;GAIG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,OAAO,GACf,eAAe,EAAE,CAMnB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,eAAe,EAAE,CAI9D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,eAAe,EAAE,CAE7D;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,EAAE,CA0EhF"}
+{"version":3,"file":"whatsapp-client.d.ts","sourceRoot":"","sources":["../../../../../../../apps/app-lifeops/src/lifeops/whatsapp-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE;QACT,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,aAAc,SAAQ,KAAK;aAGpB,MAAM,EAAE,MAAM;aACd,IAAI,CAAC,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO;CAKjC;AAOD,wBAAgB,8BAA8B,CAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,mBAAmB,GAAG,IAAI,CAY5B;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAsD1C;AA4DD;;;;GAIG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,OAAO,GACf,eAAe,EAAE,CAMnB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,eAAe,EAAE,CAI9D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,eAAe,EAAE,CAE7D;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,GACf,eAAe,EAAE,CAuGnB"}

package/apps/app-lifeops/src/lifeops/whatsapp-client.js

@@ -49,7 +49,8 @@ export async function sendWhatsAppMessage(creds, req) {
     });
     const body = (await response.json().catch(() => ({})));
     if (!response.ok) {
-        const errorMessage = body.error?.message ?? `WhatsApp request failed with HTTP ${response.status}`;
+        const errorMessage = body.error?.message ??
+            `WhatsApp request failed with HTTP ${response.status}`;
         logger.warn({
             boundary: "lifeops",
             integration: "whatsapp",
@@ -65,11 +66,24 @@ export async function sendWhatsAppMessage(creds, req) {
     return { ok: true, messageId };
 }
 function mapMessageType(raw) {
-    if (raw === "text" || raw === "image" || raw === "audio" || raw === "document") {
+    if (raw === "text" ||
+        raw === "image" ||
+        raw === "audio" ||
+        raw === "document") {
         return raw;
     }
     return "unknown";
 }
+function whatsappTimestampToIso(raw) {
+    const value = typeof raw === "string" && raw.trim().length > 0 ? Number(raw) : raw;
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return null;
+    }
+    return new Date(value * 1000).toISOString();
+}
+function optionalString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
 // ---------------------------------------------------------------------------
 // Inbound message buffer
 // ---------------------------------------------------------------------------
@@ -151,6 +165,25 @@ export function parseWhatsAppWebhookMessages(payload) {
             const value = change.value;
             if (!value || typeof value !== "object")
                 continue;
+            const webhookValue = value;
+            const rawContacts = webhookValue.contacts;
+            const contactByWaId = new Map();
+            if (Array.isArray(rawContacts)) {
+                for (const contact of rawContacts) {
+                    if (!contact || typeof contact !== "object")
+                        continue;
+                    const c = contact;
+                    const waId = optionalString(c.wa_id);
+                    if (!waId)
+                        continue;
+                    contactByWaId.set(waId, {
+                        name: optionalString(c.profile?.name),
+                        waId,
+                    });
+                }
+            }
+            const displayPhoneNumber = optionalString(webhookValue.metadata?.display_phone_number);
+            const phoneNumberId = optionalString(webhookValue.metadata?.phone_number_id);
             const rawMessages = value.messages;
             if (!Array.isArray(rawMessages))
                 continue;
@@ -160,20 +193,9 @@ export function parseWhatsAppWebhookMessages(payload) {
                 const m = msg;
                 if (typeof m.id !== "string" || typeof m.from !== "string")
                     continue;
-                // WhatsApp timestamps are unix seconds as string; convert to ISO.
-                let isoTimestamp;
-                if (typeof m.timestamp === "string") {
-                    const asNumber = Number(m.timestamp);
-                    isoTimestamp = Number.isFinite(asNumber)
-                        ? new Date(asNumber * 1000).toISOString()
-                        : new Date().toISOString();
-                }
-                else if (typeof m.timestamp === "number") {
-                    isoTimestamp = new Date(m.timestamp * 1000).toISOString();
-                }
-                else {
-                    isoTimestamp = new Date().toISOString();
-                }
+                const isoTimestamp = whatsappTimestampToIso(m.timestamp);
+                if (!isoTimestamp)
+                    continue;
                 const type = mapMessageType(m.type);
                 const text = type === "text" && typeof m.text?.body === "string"
                     ? m.text.body
@@ -185,13 +207,22 @@ export function parseWhatsAppWebhookMessages(payload) {
                         : type === "document" && typeof m.document?.id === "string"
                             ? m.document.id
                             : undefined;
+                const contact = contactByWaId.get(m.from);
+                const metadata = {
+                    ...(displayPhoneNumber ? { displayPhoneNumber } : {}),
+                    ...(phoneNumberId ? { phoneNumberId } : {}),
+                    ...(contact?.name ? { contactName: contact.name } : {}),
+                    ...(contact?.waId ? { waId: contact.waId } : {}),
+                };
                 messages.push({
                     id: m.id,
                     from: m.from,
+                    channelId: m.from,
                     timestamp: isoTimestamp,
                     type,
                     ...(text !== undefined ? { text } : {}),
                     ...(mediaId !== undefined ? { mediaId } : {}),
+                    ...(Object.keys(metadata).length > 0 ? { metadata } : {}),
                 });
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/agent",
-  "version": "2.0.0-alpha.437",
+  "version": "2.0.0-alpha.438",
   "description": "Standalone elizaOS-based agent and backend server package.",
   "type": "module",
   "license": "MIT",
@@ -467,7 +467,7 @@
     "@elizaos/app-steward": "^0.0.0",
     "@elizaos/app-task-coordinator": "^0.0.0",
     "@elizaos/app-training": "^0.0.1",
-    "@elizaos/core": "^2.0.0-alpha.437",
+    "@elizaos/core": "^2.0.0-alpha.438",
     "@elizaos/plugin-agent-orchestrator": "^0.6.2-alpha.0",
     "@elizaos/plugin-browser-bridge": "^0.1.0",
     "@elizaos/plugin-local-embedding": "^2.0.0-alpha.12",
@@ -476,8 +476,8 @@
     "@elizaos/plugin-solana": "^2.0.0-alpha.6",
     "@elizaos/plugin-sql": "^2.0.0-alpha.19",
     "@elizaos/plugin-wechat": "^0.1.0",
-    "@elizaos/shared": "^2.0.0-alpha.437",
-    "@elizaos/skills": "^2.0.0-alpha.437",
+    "@elizaos/shared": "^2.0.0-alpha.438",
+    "@elizaos/skills": "^2.0.0-alpha.438",
     "@hapi/boom": "^10.0.1",
     "@noble/curves": "^2.0.1",
     "@solana/web3.js": "^1.98.4",

package/packages/agent/src/actions/terminal.d.ts

@@ -2,11 +2,11 @@
  * SHELL_COMMAND action — runs a shell command on the server.
  *
  * When triggered the action:
- *   1. Extracts the command from the parameters, NL text, or MCP-style JSON
+ *   1. Extracts the command from parameters or MCP-style JSON
  *   2. POSTs to the local API server to execute it
  *   3. The API broadcasts output via WebSocket for real-time display
- *   4. Optionally captures the output and stores it in bounded clipboard state
- *   5. Returns a descriptive text response
+ *   4. Captures the output for the post-action LLM response
+ *   5. Stores the full output as a document attachment for follow-up actions
  *
  * @module actions/terminal
  */

package/packages/agent/src/actions/terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../../../src/actions/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,MAAM,EAKP,MAAM,eAAe,CAAC;AAqVvB,eAAO,MAAM,cAAc,EAAE,MAgJ5B,CAAC"}
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../../../src/actions/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAyOvB,eAAO,MAAM,cAAc,EAAE,MA2H5B,CAAC"}

package/packages/agent/src/actions/terminal.js

@@ -2,47 +2,33 @@
  * SHELL_COMMAND action — runs a shell command on the server.
  *
  * When triggered the action:
- *   1. Extracts the command from the parameters, NL text, or MCP-style JSON
+ *   1. Extracts the command from parameters or MCP-style JSON
  *   2. POSTs to the local API server to execute it
  *   3. The API broadcasts output via WebSocket for real-time display
- *   4. Optionally captures the output and stores it in bounded clipboard state
- *   5. Returns a descriptive text response
+ *   4. Captures the output for the post-action LLM response
+ *   5. Stores the full output as a document attachment for follow-up actions
  *
  * @module actions/terminal
  */
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-import { logger } from "@elizaos/core";
+import { ContentType, logger, stringToUuid } from "@elizaos/core";
 import { hasOwnerAccess } from "../security/access.js";
 /** API port for posting terminal requests. */
 const API_PORT = process.env.API_PORT || process.env.SERVER_PORT || "2138";
+const TERMINAL_ACTION_NAME = "SHELL_COMMAND";
 const FAIL = { success: false, text: "" };
-let cachedClipboardStoreFn;
-function parseBooleanFlag(value) {
-    if (value === true) {
-        return true;
-    }
-    if (typeof value === "string") {
-        return /^(true|1|yes|y|on)$/i.test(value.trim());
-    }
-    return false;
-}
 function readStringValue(value) {
     return typeof value === "string" && value.trim() ? value.trim() : undefined;
 }
+function isJsonRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 function parseJsonArguments(value) {
     if (typeof value !== "string" || !value.trim()) {
         return undefined;
     }
     try {
         const parsed = JSON.parse(value);
-        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        if (isJsonRecord(parsed)) {
             return parsed;
         }
     }
@@ -51,27 +37,6 @@ function parseJsonArguments(value) {
     }
     return undefined;
 }
-function resolveClipboardRequested(params, argumentParams, message) {
-    return [
-        params.addToClipboard,
-        params.persistToClipboard,
-        params.saveToClipboard,
-        argumentParams?.addToClipboard,
-        argumentParams?.persistToClipboard,
-        argumentParams?.saveToClipboard,
-        message?.content?.addToClipboard,
-        message?.content?.persistToClipboard,
-        message?.content?.saveToClipboard,
-    ].some((value) => parseBooleanFlag(value));
-}
-function resolveClipboardTitle(params, argumentParams, message) {
-    return (readStringValue(params.clipboardTitle) ??
-        readStringValue(params.title) ??
-        readStringValue(argumentParams?.clipboardTitle) ??
-        readStringValue(argumentParams?.title) ??
-        readStringValue(message?.content?.clipboardTitle) ??
-        readStringValue(message?.content?.title));
-}
 /**
  * Extract a command from handler options and message text.
  *
@@ -79,9 +44,8 @@ function resolveClipboardTitle(params, argumentParams, message) {
  *   1. `parameters.command` — explicit parameter
  *   2. `parameters.shellCommand` — explicit alias
  *   3. `parameters.arguments` — MCP-style JSON string like `{"command":"ls"}`
- *   4. Natural language extraction from message text
  */
-function getCommand(options, _message) {
+function getCommand(options) {
     const params = (options?.parameters ?? {});
     const argumentParams = parseJsonArguments(params.arguments);
     // The planner must extract the command as an explicit `command` param.
@@ -95,19 +59,13 @@ function getCommand(options, _message) {
         readStringValue(argumentParams?.command) ??
         readStringValue(argumentParams?.shellCommand));
 }
-function resolveTerminalInput(options, message) {
-    const params = (options?.parameters ?? {});
-    const argumentParams = parseJsonArguments(params.arguments);
+function resolveTerminalInput(options) {
     return {
-        command: getCommand(options, message),
-        addToClipboard: resolveClipboardRequested(params, argumentParams, message),
-        clipboardTitle: resolveClipboardTitle(params, argumentParams, message),
+        command: getCommand(options),
     };
 }
 function normalizeCapturedRun(command, value) {
-    const data = value && typeof value === "object" && !Array.isArray(value)
-        ? value
-        : {};
+    const data = isJsonRecord(value) ? value : {};
     const exitCode = typeof data.exitCode === "number" && Number.isFinite(data.exitCode)
         ? data.exitCode
         : Number(data.exitCode ?? 0) || 0;
@@ -125,24 +83,6 @@ function normalizeCapturedRun(command, value) {
             : undefined,
     };
 }
-async function getClipboardStoreFn() {
-    if (cachedClipboardStoreFn !== undefined) {
-        return cachedClipboardStoreFn;
-    }
-    try {
-        const clipboardModule = "@elizaos/core/advanced-capabilities/clipboard/index";
-        const mod = (await import(__rewriteRelativeImportExtension(/* @vite-ignore */ clipboardModule)));
-        cachedClipboardStoreFn =
-            typeof mod.maybeStoreTaskClipboardItem === "function"
-                ? mod.maybeStoreTaskClipboardItem
-                : null;
-    }
-    catch (error) {
-        cachedClipboardStoreFn = null;
-        logger.warn(`[terminal] Clipboard plugin unavailable; shell output will not be persisted (${error instanceof Error ? error.message : String(error)})`);
-    }
-    return cachedClipboardStoreFn;
-}
 function formatOutputBlock(content) {
     return content.trimEnd() || "(empty)";
 }
@@ -164,81 +104,79 @@ function buildCommandArtifactContent(result) {
         .filter(Boolean)
         .join("\n");
 }
-async function maybeStoreCommandOutput(runtime, message, input, result) {
-    if (!input.addToClipboard) {
-        return {
-            requested: false,
-            stored: false,
-        };
+function buildOutputPreview(content, maxLength = 3_000) {
+    const trimmed = content.trimEnd();
+    if (trimmed.length <= maxLength) {
+        return formatOutputBlock(trimmed);
     }
-    if (!runtime) {
-        return {
-            requested: true,
-            stored: false,
-            reason: "Runtime unavailable; command output could not be added to the clipboard.",
-        };
+    return `${trimmed.slice(0, maxLength).trimEnd()}\n\n[... ${trimmed.length - maxLength} chars omitted; use the attachment for full output ...]`;
+}
+async function createCommandOutputAttachment(runtime, message, result) {
+    if (!runtime?.createMemory) {
+        return undefined;
     }
-    const clipboardMessage = {
-        ...message,
-        content: {
-            ...message.content,
-            addToClipboard: true,
-            ...(input.clipboardTitle ? { clipboardTitle: input.clipboardTitle } : {}),
-        },
+    const attachmentId = stringToUuid(`terminal-output:${message.id ?? message.roomId}:${result.runId ?? result.command}:${Date.now()}`);
+    const title = `Shell output: ${result.command}`;
+    const attachment = {
+        id: attachmentId,
+        url: `memory://terminal-output/${attachmentId}`,
+        title,
+        source: TERMINAL_ACTION_NAME,
+        description: `Full stdout/stderr for \`${result.command}\` (exit ${result.exitCode}).`,
+        text: buildCommandArtifactContent(result),
+        contentType: ContentType.DOCUMENT,
     };
-    const storeClipboardItem = await getClipboardStoreFn();
-    if (!storeClipboardItem) {
-        return {
-            requested: true,
-            stored: false,
-            reason: "Clipboard plugin unavailable; command output could not be added to the clipboard.",
-        };
+    try {
+        const memoryId = await runtime.createMemory({
+            id: stringToUuid(`terminal-output-memory:${attachmentId}`),
+            entityId: runtime.agentId,
+            agentId: runtime.agentId,
+            roomId: message.roomId,
+            createdAt: Date.now(),
+            content: {
+                text: `Stored terminal output attachment ${attachment.id}: ${attachment.title}`,
+                source: TERMINAL_ACTION_NAME,
+                attachments: [attachment],
+            },
+        }, "messages");
+        return { attachment, memoryId };
+    }
+    catch (error) {
+        logger.warn(`[terminal] Failed to store shell output attachment (${error instanceof Error ? error.message : String(error)})`);
+        return { attachment };
     }
-    return storeClipboardItem(runtime, clipboardMessage, {
-        fallbackTitle: input.clipboardTitle ?? result.command,
-        content: buildCommandArtifactContent(result),
-        sourceType: "command",
-        sourceId: result.command,
-        sourceLabel: result.command,
-    });
 }
-function buildCapturedResponseText(result, clipboardResult) {
-    const clipboardItem = clipboardResult.stored
-        ? clipboardResult.item
-        : undefined;
-    const clipboardSnapshot = clipboardResult.stored
-        ? clipboardResult.snapshot
-        : undefined;
+function buildCapturedResponseText(result, outputAttachment) {
+    const outputContent = buildCommandArtifactContent(result);
     return [
-        `Executed shell command: \`${result.command}\``,
+        `Shell command completed: \`${result.command}\``,
         `Exit code: ${result.exitCode}`,
         result.timedOut
             ? `Timed out${typeof result.maxDurationMs === "number" ? ` after ${result.maxDurationMs} ms` : ""}.`
             : "",
         result.truncated ? "Captured output truncated to 128 KB." : "",
-        clipboardResult.requested
-            ? clipboardResult.stored
-                ? `${clipboardResult.replaced ? "Updated" : "Added"} clipboard item ${clipboardItem?.id ?? "unknown"}: ${clipboardItem?.title ?? result.command}`
-                : `Clipboard add skipped: ${clipboardResult.reason}`
-            : "",
-        clipboardSnapshot
-            ? `Clipboard usage: ${clipboardSnapshot.items.length}/${clipboardSnapshot.maxItems}.`
-            : "",
-        clipboardSnapshot
-            ? "Clear unused clipboard state when it is no longer needed."
+        outputAttachment
+            ? `Full output attachment: ${outputAttachment.attachment.id} (${outputAttachment.attachment.title})`
             : "",
+        outputAttachment?.memoryId
+            ? `Attachment memory: ${outputAttachment.memoryId}`
+            : outputAttachment
+                ? "Attachment memory could not be persisted; full output is still present in this action result."
+                : "No attachment was stored for this output.",
         "",
-        "STDOUT:",
-        formatOutputBlock(result.stdout),
+        "Output preview:",
+        buildOutputPreview(outputContent),
         "",
-        "STDERR:",
-        formatOutputBlock(result.stderr),
+        "Next-step contract for the planner:",
+        "- Decide whether to reply to the user, stay silent, or continue with another action.",
+        "- If the output should be kept for this task, call SAVE_ATTACHMENT_TO_CLIPBOARD with the attachmentId above.",
+        "- If replying, answer naturally from the output instead of echoing this report.",
     ]
         .filter(Boolean)
         .join("\n");
 }
 export const terminalAction = {
-    name: "SHELL_COMMAND",
+    name: TERMINAL_ACTION_NAME,
     similes: [
         "RUN_IN_TERMINAL",
         "RUN_COMMAND",
@@ -252,7 +190,7 @@ export const terminalAction = {
     description: "Run a single explicit shell command that the user provided directly. " +
         "Only use when the user gives a specific command like 'run ls -la' or 'execute npm install'. " +
         "Do NOT use for building projects, creating websites, or multi-step work — use CREATE_TASK instead. " +
-        "Set addToClipboard=true to capture the command output, return it inline, and store it in bounded clipboard state.",
+        "The command output is captured as a document attachment for post-action planning. After the run, decide whether to reply, stay silent, continue with another action, or save the attachment via the clipboard plugin.",
     validate: async (runtime, message) => {
         // Permission is the only gate here. Whether the action is relevant to the
         // current request is the planner's job — not a regex / keyword scan in
@@ -267,7 +205,7 @@ export const terminalAction = {
                 text: "Permission denied: only the owner may run terminal commands.",
             };
         }
-        const input = resolveTerminalInput(options, message);
+        const input = resolveTerminalInput(options);
         const command = input.command;
         if (!command) {
             return FAIL;
@@ -279,27 +217,24 @@ export const terminalAction = {
                 body: JSON.stringify({
                     command,
                     clientId: "runtime-terminal-action",
-                    ...(input.addToClipboard ? { captureOutput: true } : {}),
+                    captureOutput: true,
                 }),
             });
             if (!response.ok) {
                 return FAIL;
             }
-            if (!input.addToClipboard) {
-                return {
-                    text: `Running in terminal: \`${command}\``,
-                    success: true,
-                    data: { command },
-                };
-            }
-            const capturedRun = normalizeCapturedRun(command, await response.json());
-            const clipboardResult = await maybeStoreCommandOutput(runtime, message, input, capturedRun);
+            const responseBody = (await response.json());
+            const capturedRun = normalizeCapturedRun(command, responseBody);
+            const outputAttachment = await createCommandOutputAttachment(runtime, message, capturedRun);
             return {
-                text: buildCapturedResponseText(capturedRun, clipboardResult),
+                text: buildCapturedResponseText(capturedRun, outputAttachment),
                 success: true,
                 data: {
+                    actionName: TERMINAL_ACTION_NAME,
                     ...capturedRun,
-                    clipboard: clipboardResult,
+                    outputAttachment: outputAttachment?.attachment,
+                    outputAttachmentMemoryId: outputAttachment?.memoryId,
+                    suppressVisibleCallback: true,
                 },
             };
         }
@@ -314,18 +249,6 @@ export const terminalAction = {
             required: true,
             schema: { type: "string" },
         },
-        {
-            name: "addToClipboard",
-            description: "When true, wait for the command to finish, capture stdout/stderr, and store the result in bounded clipboard state.",
-            required: false,
-            schema: { type: "boolean" },
-        },
-        {
-            name: "clipboardTitle",
-            description: "Optional clipboard title to use when addToClipboard=true.",
-            required: false,
-            schema: { type: "string" },
-        },
     ],
     examples: [
         [
@@ -338,7 +261,7 @@ export const terminalAction = {
             {
                 name: "{{agentName}}",
                 content: {
-                    text: "Running in terminal: `ls -la`",
+                    text: "The directory listing completed. It shows the current files and folders in your home directory.",
                 },
             },
         ],
@@ -352,7 +275,7 @@ export const terminalAction = {
             {
                 name: "{{agentName}}",
                 content: {
-                    text: "Executed shell command: `git status`\nExit code: 0",
+                    text: "The `git status` output was captured. I saved the full output as an attachment and can keep it in the clipboard if it is useful for the next step.",
                 },
             },
         ],