@elizaos/agent 2.0.0-alpha.358 → 2.0.0-alpha.376

package/packages/agent/src/actions/get-self-status.js

@@ -8,7 +8,7 @@
  *
  * @module actions/get-self-status
  */
-import { getGlobalAwarenessRegistry } from "@elizaos/shared/awareness";
+import { getGlobalAwarenessRegistry, } from "@elizaos/shared";
 const VALID_MODULES = [
     "all",
     "runtime",

package/packages/agent/src/actions/grounded-action-reply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grounded-action-reply.d.ts","sourceRoot":"","sources":["../../../../../src/actions/grounded-action-reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAYhF,KAAK,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5D,KAAK,6BAA6B,GAAG;IACnC,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAuEF,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,KAAK,GAAG,SAAS,GACvB,YAAY,EAAE,CAmChB;AAED,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,KAAK,GAAG,SAAS,GACvB,MAAM,EAAE,CAEV;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,GAAG,SAAS,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAuB3B;AAiCD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,KAAK,SAAI,GACR,MAAM,EAAE,CAsBV;AA4CD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0CxB;AAaD,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,MAAM,CAAC,CA8DjB"}
+{"version":3,"file":"grounded-action-reply.d.ts","sourceRoot":"","sources":["../../../../../src/actions/grounded-action-reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAchF,KAAK,mBAAmB,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5D,KAAK,6BAA6B,GAAG;IACnC,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAuEF,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,KAAK,GAAG,SAAS,GACvB,YAAY,EAAE,CAmChB;AAED,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,KAAK,GAAG,SAAS,GACvB,MAAM,EAAE,CAEV;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,GAAG,SAAS,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAuB3B;AAiCD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,KAAK,SAAI,GACR,MAAM,EAAE,CAsBV;AA4CD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0CxB;AAaD,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,MAAM,CAAC,CA8DjB"}

package/packages/agent/src/actions/grounded-action-reply.js

@@ -1,6 +1,5 @@
 import { getTrajectoryContext, ModelType, parseJSONObjectFromText, parseKeyValueXml, } from "@elizaos/core";
-import { getRecentMessagesData } from "@elizaos/shared/recent-messages-state";
-import { asRecord } from "@elizaos/shared/type-guards";
+import { asRecord, getRecentMessagesData, } from "@elizaos/shared";
 import { loadTrajectoryByStepId } from "../runtime/trajectory-internals.js";
 import { recentConversationTexts } from "./recent-conversation-texts.js";
 function truncateText(value, maxLength) {

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

@@ -1,18 +1,26 @@
 export * from "./agent-inbox.js";
 export * from "./app-control.js";
+export * from "./configure-plugin.js";
+export * from "./connector-control.js";
 export * from "./context-signal.js";
 export * from "./eject-plugin.js";
+export * from "./extract-params.js";
 export * from "./get-self-status.js";
 export * from "./grounded-action-reply.js";
 export * from "./install-plugin.js";
 export * from "./list-ejected.js";
+export * from "./list-installed-plugins.js";
 export * from "./log-level.js";
 export * from "./media.js";
 export * from "./reinject-plugin.js";
 export * from "./restart.js";
 export * from "./send-message.js";
+export * from "./settings-actions.js";
 export * from "./stream-control.js";
 export * from "./sync-plugin.js";
 export * from "./terminal.ts";
+export * from "./toggle-plugin.js";
+export * from "./uninstall-plugin.js";
+export * from "./update-plugin.js";
 export * from "./web-search.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/actions/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/actions/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

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

@@ -1,17 +1,25 @@
 export * from "./agent-inbox.js";
 export * from "./app-control.js";
+export * from "./configure-plugin.js";
+export * from "./connector-control.js";
 export * from "./context-signal.js";
 export * from "./eject-plugin.js";
+export * from "./extract-params.js";
 export * from "./get-self-status.js";
 export * from "./grounded-action-reply.js";
 export * from "./install-plugin.js";
 export * from "./list-ejected.js";
+export * from "./list-installed-plugins.js";
 export * from "./log-level.js";
 export * from "./media.js";
 export * from "./reinject-plugin.js";
 export * from "./restart.js";
 export * from "./send-message.js";
+export * from "./settings-actions.js";
 export * from "./stream-control.js";
 export * from "./sync-plugin.js";
 export * from "./terminal.js";
+export * from "./toggle-plugin.js";
+export * from "./uninstall-plugin.js";
+export * from "./update-plugin.js";
 export * from "./web-search.js";

package/packages/agent/src/actions/list-installed-plugins.d.ts

@@ -0,0 +1,11 @@
+/**
+ * LIST_INSTALLED_PLUGINS — enumerate plugins known to the runtime.
+ *
+ * Calls GET /api/plugins (the same endpoint used by PluginsView's `loadPlugins`
+ * via `client.getPlugins()`) and filters by status.
+ *
+ * @module actions/list-installed-plugins
+ */
+import type { Action } from "@elizaos/core";
+export declare const listInstalledPluginsAction: Action;
+//# sourceMappingURL=list-installed-plugins.d.ts.map

package/packages/agent/src/actions/list-installed-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-installed-plugins.d.ts","sourceRoot":"","sources":["../../../../../src/actions/list-installed-plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,eAAe,CAAC;AA6D3E,eAAO,MAAM,0BAA0B,EAAE,MAwHxC,CAAC"}

package/packages/agent/src/actions/list-installed-plugins.js

@@ -0,0 +1,142 @@
+/**
+ * LIST_INSTALLED_PLUGINS — enumerate plugins known to the runtime.
+ *
+ * Calls GET /api/plugins (the same endpoint used by PluginsView's `loadPlugins`
+ * via `client.getPlugins()`) and filters by status.
+ *
+ * @module actions/list-installed-plugins
+ */
+import { logger } from "@elizaos/core";
+import { resolveServerOnlyPort } from "@elizaos/shared";
+import { hasOwnerAccess } from "../security/access.js";
+function getApiBase() {
+    const port = resolveServerOnlyPort(process.env);
+    return `http://localhost:${port}`;
+}
+function isPluginListFilter(value) {
+    return (value === "all" ||
+        value === "enabled" ||
+        value === "disabled" ||
+        value === "installed" ||
+        value === "available");
+}
+function matchesFilter(plugin, filter) {
+    switch (filter) {
+        case "enabled":
+            return plugin.enabled === true;
+        case "disabled":
+            return plugin.enabled === false;
+        case "installed":
+            return plugin.isActive === true || plugin.enabled === true;
+        case "available":
+            return plugin.isActive !== true && plugin.enabled === false;
+        default:
+            return true;
+    }
+}
+export const listInstalledPluginsAction = {
+    name: "LIST_INSTALLED_PLUGINS",
+    similes: [
+        "LIST_PLUGINS",
+        "SHOW_PLUGINS",
+        "ENUMERATE_PLUGINS",
+        "WHICH_PLUGINS",
+        "GET_PLUGINS",
+    ],
+    description: "List the plugins known to this agent. Filter by 'all', 'enabled', " +
+        "'disabled', 'installed' (loaded), or 'available' (known but not loaded). " +
+        "Defaults to 'all'.",
+    validate: async (runtime, message) => {
+        return hasOwnerAccess(runtime, message);
+    },
+    handler: async (runtime, message, _state, options) => {
+        if (!(await hasOwnerAccess(runtime, message))) {
+            return {
+                success: false,
+                text: "Permission denied: only the owner may list plugins.",
+            };
+        }
+        const params = options?.parameters;
+        const filter = isPluginListFilter(params?.filter)
+            ? params.filter
+            : "all";
+        try {
+            const base = getApiBase();
+            const resp = await fetch(`${base}/api/plugins`, {
+                signal: AbortSignal.timeout(15_000),
+            });
+            const data = (await resp.json().catch(() => ({})));
+            if (!resp.ok) {
+                return {
+                    success: false,
+                    text: `Failed to list plugins (${resp.status}).`,
+                };
+            }
+            const allPlugins = Array.isArray(data.plugins) ? data.plugins : [];
+            const matching = allPlugins.filter((plugin) => matchesFilter(plugin, filter));
+            if (matching.length === 0) {
+                return {
+                    success: true,
+                    text: `No plugins match filter '${filter}'.`,
+                    data: { filter, count: 0, plugins: [] },
+                };
+            }
+            const lines = matching.map((plugin) => {
+                const status = plugin.enabled ? "enabled" : "disabled";
+                const active = plugin.isActive ? " active" : "";
+                const ver = plugin.version ? `@${plugin.version}` : "";
+                return `- ${plugin.name}${ver} [${plugin.id}] (${status}${active})`;
+            });
+            return {
+                success: true,
+                text: [
+                    `Plugins matching '${filter}' (${matching.length}/${allPlugins.length}):`,
+                    ...lines,
+                ].join("\n"),
+                data: { filter, count: matching.length, plugins: matching },
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error(`[list-installed-plugins] error: ${msg}`);
+            return { success: false, text: `Failed to list plugins: ${msg}` };
+        }
+    },
+    parameters: [
+        {
+            name: "filter",
+            description: "Which plugins to list: 'all' (default), 'enabled', 'disabled', 'installed', or 'available'.",
+            required: false,
+            schema: {
+                type: "string",
+                enum: ["all", "enabled", "disabled", "installed", "available"],
+            },
+        },
+    ],
+    examples: [
+        [
+            {
+                name: "{{name1}}",
+                content: { text: "Which plugins are enabled?" },
+            },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: "Plugins matching 'enabled' (2/12):\n- Discord [discord] (enabled active)\n- OpenAI [openai] (enabled active)",
+                },
+            },
+        ],
+        [
+            {
+                name: "{{name1}}",
+                content: { text: "Show me every plugin." },
+            },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: "Plugins matching 'all' (3/3):\n- Discord [discord] (enabled active)\n- Telegram [telegram] (disabled)\n- OpenAI [openai] (enabled active)",
+                },
+            },
+        ],
+    ],
+};

package/packages/agent/src/actions/log-level.js

@@ -1,5 +1,5 @@
 import { elizaLogger, } from "@elizaos/core";
-import { getValidationKeywordTerms, textIncludesKeywordTerm, } from "@elizaos/shared/validation-keywords";
+import { getValidationKeywordTerms, textIncludesKeywordTerm, } from "@elizaos/shared";
 const LOG_LEVEL_COMMAND_TERMS = getValidationKeywordTerms("action.logLevel.command", {
     includeAllLocales: true,
 });

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

@@ -0,0 +1,12 @@
+/**
+ * Log inspection actions — let the agent introspect its own log buffer.
+ *
+ * QUERY_LOGS  → GET /api/logs (filterable)
+ * EXPORT_LOGS → POST /api/logs/export (json or csv)
+ * CLEAR_LOGS  → DELETE /api/logs
+ */
+import type { Action } from "@elizaos/core";
+export declare const queryLogsAction: Action;
+export declare const exportLogsAction: Action;
+export declare const clearLogsAction: Action;
+//# sourceMappingURL=logs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../../../src/actions/logs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAgC,MAAM,eAAe,CAAC;AAyD1E,eAAO,MAAM,eAAe,EAAE,MAmI7B,CAAC;AAaF,eAAO,MAAM,gBAAgB,EAAE,MA4G9B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MA4C7B,CAAC"}

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

@@ -0,0 +1,300 @@
+/**
+ * Log inspection actions — let the agent introspect its own log buffer.
+ *
+ * QUERY_LOGS  → GET /api/logs (filterable)
+ * EXPORT_LOGS → POST /api/logs/export (json or csv)
+ * CLEAR_LOGS  → DELETE /api/logs
+ */
+import { logger } from "@elizaos/core";
+import { resolveServerOnlyPort } from "@elizaos/shared";
+import { hasOwnerAccess } from "../security/access.js";
+const LOG_LEVELS = ["debug", "info", "warn", "error"];
+function getApiBase() {
+    return `http://localhost:${resolveServerOnlyPort(process.env)}`;
+}
+function parseSince(since) {
+    if (!since)
+        return undefined;
+    const numeric = Number(since);
+    if (Number.isFinite(numeric) && numeric > 0) {
+        return numeric;
+    }
+    const parsed = Date.parse(since);
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+function formatLogPreview(entries, limit) {
+    const slice = entries.slice(0, limit);
+    if (slice.length === 0) {
+        return "No log entries match.";
+    }
+    const lines = slice.map((entry) => {
+        const ts = new Date(entry.timestamp).toISOString();
+        const tagPart = entry.tags.length > 0 ? ` [${entry.tags.join(",")}]` : "";
+        return `${ts} ${entry.level.toUpperCase().padEnd(5)} ${entry.source}${tagPart}: ${entry.message}`;
+    });
+    return lines.join("\n");
+}
+export const queryLogsAction = {
+    name: "QUERY_LOGS",
+    similes: [
+        "READ_LOGS",
+        "GET_LOGS",
+        "INSPECT_LOGS",
+        "VIEW_LOGS",
+        "LOOKUP_LOGS",
+    ],
+    description: "Read recent log entries from the agent's in-memory log buffer. Filter by source, level (debug/info/warn/error), tags, or since-timestamp.",
+    validate: async (runtime, message) => hasOwnerAccess(runtime, message),
+    handler: async (runtime, message, _state, options) => {
+        if (!(await hasOwnerAccess(runtime, message))) {
+            return {
+                success: false,
+                text: "Permission denied: only the owner may read logs.",
+            };
+        }
+        const params = options?.parameters;
+        const limit = Math.max(1, Math.min(200, Math.floor(params?.limit ?? 50)));
+        const tagFilter = (params?.tags ?? []).map((t) => t.trim()).filter(Boolean);
+        const sinceMs = parseSince(params?.since);
+        const search = new URLSearchParams();
+        if (params?.source)
+            search.set("source", params.source);
+        if (params?.level && LOG_LEVELS.includes(params.level)) {
+            search.set("level", params.level);
+        }
+        // Server only supports a single tag filter; use the first if multiple.
+        if (tagFilter.length > 0)
+            search.set("tag", tagFilter[0]);
+        if (sinceMs !== undefined)
+            search.set("since", String(sinceMs));
+        const qs = search.toString();
+        const url = `${getApiBase()}/api/logs${qs ? `?${qs}` : ""}`;
+        try {
+            const resp = await fetch(url, {
+                signal: AbortSignal.timeout(10_000),
+            });
+            if (!resp.ok) {
+                return {
+                    success: false,
+                    text: `Failed to load logs: HTTP ${resp.status}`,
+                };
+            }
+            const data = (await resp.json());
+            // Apply additional client-side tag filtering when multiple tags requested.
+            const entries = tagFilter.length > 1
+                ? data.entries.filter((entry) => tagFilter.every((tag) => entry.tags.includes(tag)))
+                : data.entries;
+            const preview = formatLogPreview(entries, limit);
+            return {
+                success: true,
+                text: preview,
+                values: {
+                    count: entries.length,
+                    totalSources: data.sources.length,
+                },
+                data: {
+                    actionName: "QUERY_LOGS",
+                    entries: entries.slice(0, limit),
+                    sources: data.sources,
+                    tags: data.tags,
+                },
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`[query-logs] failed: ${msg}`);
+            return { success: false, text: `Failed to load logs: ${msg}` };
+        }
+    },
+    parameters: [
+        {
+            name: "source",
+            description: "Optional source filter (e.g. agent, server, plugins).",
+            required: false,
+            schema: { type: "string" },
+        },
+        {
+            name: "level",
+            description: "Optional log level filter.",
+            required: false,
+            schema: { type: "string", enum: [...LOG_LEVELS] },
+        },
+        {
+            name: "tags",
+            description: "Optional tag filter list. Server applies the first tag; remaining tags are intersected client-side.",
+            required: false,
+            schema: { type: "array", items: { type: "string" } },
+        },
+        {
+            name: "since",
+            description: "Optional ISO timestamp or epoch-ms cutoff. Only entries at or after this time are returned.",
+            required: false,
+            schema: { type: "string" },
+        },
+        {
+            name: "limit",
+            description: "Maximum number of entries to include in the preview (1-200).",
+            required: false,
+            schema: { type: "number" },
+        },
+    ],
+    examples: [
+        [
+            {
+                name: "{{name1}}",
+                content: { text: "Show me the last 20 error logs from the agent." },
+            },
+            {
+                name: "{{agentName}}",
+                content: {
+                    text: "Showing recent agent error log entries...",
+                    action: "QUERY_LOGS",
+                },
+            },
+        ],
+    ],
+};
+export const exportLogsAction = {
+    name: "EXPORT_LOGS",
+    similes: ["DOWNLOAD_LOGS", "DUMP_LOGS", "SAVE_LOGS"],
+    description: "Export the agent's log buffer to JSON or CSV via POST /api/logs/export.",
+    validate: async (runtime, message) => hasOwnerAccess(runtime, message),
+    handler: async (runtime, message, _state, options) => {
+        if (!(await hasOwnerAccess(runtime, message))) {
+            return {
+                success: false,
+                text: "Permission denied: only the owner may export logs.",
+            };
+        }
+        const params = options?.parameters;
+        const format = params?.format === "csv" ? "csv" : "json";
+        const filter = params?.filter ?? {};
+        const body = { format };
+        if (typeof filter.source === "string" && filter.source.trim()) {
+            body.source = filter.source.trim();
+        }
+        if (filter.level && LOG_LEVELS.includes(filter.level)) {
+            body.level = filter.level;
+        }
+        if (Array.isArray(filter.tags)) {
+            const tags = filter.tags
+                .map((t) => (typeof t === "string" ? t.trim() : ""))
+                .filter(Boolean);
+            if (tags.length > 0)
+                body.tags = tags;
+        }
+        if (typeof filter.since === "string" && filter.since.trim()) {
+            body.since = filter.since;
+        }
+        if (typeof filter.limit === "number" && Number.isFinite(filter.limit)) {
+            body.limit = filter.limit;
+        }
+        try {
+            const resp = await fetch(`${getApiBase()}/api/logs/export`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(15_000),
+            });
+            if (!resp.ok) {
+                const text = await resp.text().catch(() => "");
+                return {
+                    success: false,
+                    text: `Failed to export logs: HTTP ${resp.status}${text ? ` — ${text}` : ""}`,
+                };
+            }
+            const contentType = resp.headers.get("content-type") ?? "";
+            const disposition = resp.headers.get("content-disposition") ?? "";
+            const filenameMatch = disposition.match(/filename="?([^";]+)"?/i);
+            const filename = filenameMatch?.[1] ?? `logs.${format}`;
+            const buffer = Buffer.from(await resp.arrayBuffer());
+            let entryCount;
+            if (contentType.includes("application/json")) {
+                const parsed = JSON.parse(buffer.toString("utf-8"));
+                entryCount = Array.isArray(parsed.entries)
+                    ? parsed.entries.length
+                    : undefined;
+            }
+            return {
+                success: true,
+                text: `Exported ${entryCount ?? "log"} entries as ${format} (${buffer.byteLength} bytes).`,
+                values: {
+                    format,
+                    bytes: buffer.byteLength,
+                    ...(entryCount !== undefined ? { count: entryCount } : {}),
+                },
+                data: {
+                    actionName: "EXPORT_LOGS",
+                    format,
+                    filename,
+                    contentType,
+                    bytes: buffer.byteLength,
+                    base64: buffer.toString("base64"),
+                },
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`[export-logs] failed: ${msg}`);
+            return { success: false, text: `Failed to export logs: ${msg}` };
+        }
+    },
+    parameters: [
+        {
+            name: "format",
+            description: "Export format: json or csv.",
+            required: true,
+            schema: { type: "string", enum: ["json", "csv"] },
+        },
+        {
+            name: "filter",
+            description: "Optional log filter (same shape as QUERY_LOGS parameters).",
+            required: false,
+            schema: { type: "object" },
+        },
+    ],
+    examples: [],
+};
+export const clearLogsAction = {
+    name: "CLEAR_LOGS",
+    similes: ["WIPE_LOGS", "RESET_LOGS", "EMPTY_LOGS"],
+    description: "Clear the agent's in-memory log buffer via DELETE /api/logs.",
+    validate: async (runtime, message) => hasOwnerAccess(runtime, message),
+    handler: async (runtime, message) => {
+        if (!(await hasOwnerAccess(runtime, message))) {
+            return {
+                success: false,
+                text: "Permission denied: only the owner may clear logs.",
+            };
+        }
+        try {
+            const resp = await fetch(`${getApiBase()}/api/logs`, {
+                method: "DELETE",
+                signal: AbortSignal.timeout(10_000),
+            });
+            if (!resp.ok) {
+                return {
+                    success: false,
+                    text: `Failed to clear logs: HTTP ${resp.status}`,
+                };
+            }
+            const data = (await resp.json().catch(() => ({})));
+            const cleared = typeof data.cleared === "number" && Number.isFinite(data.cleared)
+                ? data.cleared
+                : 0;
+            return {
+                success: true,
+                text: `Cleared ${cleared} log entries.`,
+                values: { cleared },
+                data: { actionName: "CLEAR_LOGS", cleared },
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`[clear-logs] failed: ${msg}`);
+            return { success: false, text: `Failed to clear logs: ${msg}` };
+        }
+    },
+    parameters: [],
+    examples: [],
+};

package/packages/agent/src/actions/manage-tasks.js

@@ -3,7 +3,7 @@
  * workbench tasks via natural language.
  */
 import { ModelType, parseKeyValueXml, } from "@elizaos/core";
-import { findKeywordTermMatch, getValidationKeywordTerms, } from "@elizaos/shared/validation-keywords";
+import { findKeywordTermMatch, getValidationKeywordTerms, } from "@elizaos/shared";
 import { readTaskCompleted, readTaskMetadata, toWorkbenchTask, WORKBENCH_TASK_TAG, } from "../api/workbench-helpers.js";
 import { hasOwnerAccess } from "../security/access.js";
 import { readTriggerConfig } from "../triggers/runtime.js";

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

@@ -12,7 +12,7 @@
  *
  * @module actions/media
  */
-import { isElizaCloudServiceSelectedInConfig } from "@elizaos/shared/contracts";
+import { isElizaCloudServiceSelectedInConfig } from "@elizaos/shared";
 import { loadElizaConfig } from "../config/config.js";
 import { createAudioProvider, createImageProvider, createVideoProvider, createVisionProvider, } from "../providers/media-provider.js";
 function getMediaProviderOptions() {

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

@@ -0,0 +1,12 @@
+/**
+ * Memory introspection actions.
+ *
+ * RECALL_MEMORY_FILTERED → GET /api/memories/browse or /api/memories/by-entity/:id
+ * FORGET_MEMORY          → DELETE /api/memories/:id
+ * EDIT_MEMORY            → PATCH /api/memories/:id (server re-embeds)
+ */
+import type { Action } from "@elizaos/core";
+export declare const recallMemoryFilteredAction: Action;
+export declare const forgetMemoryAction: Action;
+export declare const editMemoryAction: Action;
+//# sourceMappingURL=memories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../../../../src/actions/memories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAgC,MAAM,eAAe,CAAC;AAoC1E,eAAO,MAAM,0BAA0B,EAAE,MAiIxC,CAAC;AAWF,eAAO,MAAM,kBAAkB,EAAE,MA+EhC,CAAC;AAkBF,eAAO,MAAM,gBAAgB,EAAE,MAoG9B,CAAC"}