@elizaos/autonomous 2.0.0-alpha.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,270 @@
+{
+  "name": "@elizaos/autonomous",
+  "version": "2.0.0-alpha.10",
+  "description": "Standalone autonomous agent runtime and backend server package for elizaOS.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://github.com/elizaOS/eliza",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elizaOS/eliza.git",
+    "directory": "packages/autonomous"
+  },
+  "keywords": [
+    "autonomous",
+    "agent",
+    "backend",
+    "runtime",
+    "elizaos"
+  ],
+  "main": "src/index.ts",
+  "bin": {
+    "eliza-autonomous": "./src/bin.ts"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "bun run build:dist",
+    "build:dist": "rm -rf dist && tsc -p tsconfig.build.json && node ../../scripts/prepare-package-dist.mjs packages/autonomous --compiled-prefix=packages/autonomous/src",
+    "typecheck": "test -f ../prompts/dist/typescript/index.ts || (cd ../prompts && bun run build:typescript) && tsc --noEmit -p tsconfig.json",
+    "lint:check": "bunx @biomejs/biome check ./src/actions ./src/api ./src/auth ./src/awareness ./src/bin.ts ./src/cli ./src/cloud ./src/config ./src/contracts ./src/diagnostics ./src/emotes ./src/hooks ./src/index.ts ./src/onboarding-presets.ts ./src/plugins ./src/providers ./src/runtime ./src/security ./src/server ./src/services ./src/shared ./src/testing ./src/triggers ./src/utils ./src/version-resolver.ts",
+    "pack:dry-run": "cd dist && npm pack --dry-run"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./api": "./src/api/index.ts",
+    "./api/agent-admin-routes": "./src/api/agent-admin-routes.ts",
+    "./api/agent-lifecycle-routes": "./src/api/agent-lifecycle-routes.ts",
+    "./api/agent-model": "./src/api/agent-model.ts",
+    "./api/agent-transfer-routes": "./src/api/agent-transfer-routes.ts",
+    "./api/apps-routes": "./src/api/apps-routes.ts",
+    "./api/auth-routes": "./src/api/auth-routes.ts",
+    "./api/bsc-trade": "./src/api/bsc-trade.ts",
+    "./api/bug-report-routes": "./src/api/bug-report-routes.ts",
+    "./api/character-routes": "./src/api/character-routes.ts",
+    "./api/database": "./src/api/database.ts",
+    "./api/diagnostics-routes": "./src/api/diagnostics-routes.ts",
+    "./api/drop-service": "./src/api/drop-service.ts",
+    "./api/cloud-billing-routes": "./src/api/cloud-billing-routes.ts",
+    "./api/cloud-compat-routes": "./src/api/cloud-compat-routes.ts",
+    "./api/cloud-routes": "./src/api/cloud-routes.ts",
+    "./api/cloud-status-routes": "./src/api/cloud-status-routes.ts",
+    "./api/compat-utils": "./src/api/compat-utils.ts",
+    "./api/connector-health": "./src/api/connector-health.ts",
+    "./api/coordinator-wiring": "./src/api/coordinator-wiring.ts",
+    "./api/credit-detection": "./src/api/credit-detection.ts",
+    "./api/http-helpers": "./src/api/http-helpers.ts",
+    "./api/knowledge-service-loader": "./src/api/knowledge-service-loader.ts",
+    "./api/knowledge-routes": "./src/api/knowledge-routes.ts",
+    "./api/memory-bounds": "./src/api/memory-bounds.ts",
+    "./api/models-routes": "./src/api/models-routes.ts",
+    "./api/memory-routes": "./src/api/memory-routes.ts",
+    "./api/merkle-tree": "./src/api/merkle-tree.ts",
+    "./api/nfa-routes": "./src/api/nfa-routes.ts",
+    "./api/nft-verify": "./src/api/nft-verify.ts",
+    "./api/og-tracker": "./src/api/og-tracker.ts",
+    "./api/permissions-routes": "./src/api/permissions-routes.ts",
+    "./api/registry-routes": "./src/api/registry-routes.ts",
+    "./api/route-helpers": "./src/api/route-helpers.ts",
+    "./api/sandbox-routes": "./src/api/sandbox-routes.ts",
+    "./api/early-logs": "./src/api/early-logs.ts",
+    "./api/parse-action-block": "./src/api/parse-action-block.ts",
+    "./api/plugin-validation": "./src/api/plugin-validation.ts",
+    "./api/provider-switch-config": "./src/api/provider-switch-config.ts",
+    "./api/registry-service": "./src/api/registry-service.ts",
+    "./api/server": "./src/api/server.ts",
+    "./api/signal-routes": "./src/api/signal-routes.ts",
+    "./api/stream-route-state": "./src/api/stream-route-state.ts",
+    "./api/stream-routes": "./src/api/stream-routes.ts",
+    "./api/streaming-text": "./src/api/streaming-text.ts",
+    "./api/stream-voice-routes": "./src/api/stream-voice-routes.ts",
+    "./api/subscription-routes": "./src/api/subscription-routes.ts",
+    "./api/terminal-run-limits": "./src/api/terminal-run-limits.ts",
+    "./api/training-backend-check": "./src/api/training-backend-check.ts",
+    "./api/training-routes": "./src/api/training-routes.ts",
+    "./api/training-service-like": "./src/api/training-service-like.ts",
+    "./api/trigger-routes": "./src/api/trigger-routes.ts",
+    "./api/trajectory-routes": "./src/api/trajectory-routes.ts",
+    "./api/tx-service": "./src/api/tx-service.ts",
+    "./api/twitter-verify": "./src/api/twitter-verify.ts",
+    "./api/zip-utils": "./src/api/zip-utils.ts",
+    "./api/wallet": "./src/api/wallet.ts",
+    "./api/wallet-dex-prices": "./src/api/wallet-dex-prices.ts",
+    "./api/wallet-evm-balance": "./src/api/wallet-evm-balance.ts",
+    "./api/wallet-routes": "./src/api/wallet-routes.ts",
+    "./api/wallet-rpc": "./src/api/wallet-rpc.ts",
+    "./api/wallet-trading-profile": "./src/api/wallet-trading-profile.ts",
+    "./api/whatsapp-routes": "./src/api/whatsapp-routes.ts",
+    "./auth": "./src/auth/index.ts",
+    "./auth/anthropic": "./src/auth/anthropic.ts",
+    "./auth/apply-stealth": "./src/auth/apply-stealth.ts",
+    "./auth/claude-code-stealth": "./src/auth/claude-code-stealth.ts",
+    "./auth/credentials": "./src/auth/credentials.ts",
+    "./auth/openai-codex": "./src/auth/openai-codex.ts",
+    "./auth/types": "./src/auth/types.ts",
+    "./actions/emote": "./src/actions/emote.ts",
+    "./actions/restart": "./src/actions/restart.ts",
+    "./actions/send-message": "./src/actions/send-message.ts",
+    "./actions/stream-control": "./src/actions/stream-control.ts",
+    "./actions/switch-stream-source": "./src/actions/switch-stream-source.ts",
+    "./actions/terminal": "./src/actions/terminal.ts",
+    "./awareness/registry": "./src/awareness/registry.ts",
+    "./cli": "./src/cli/index.ts",
+    "./cloud": "./src/cloud/index.ts",
+    "./cloud/auth": "./src/cloud/auth.ts",
+    "./cloud/backup": "./src/cloud/backup.ts",
+    "./cloud/base-url": "./src/cloud/base-url.ts",
+    "./cloud/bridge-client": "./src/cloud/bridge-client.ts",
+    "./cloud/cloud-manager": "./src/cloud/cloud-manager.ts",
+    "./cloud/cloud-proxy": "./src/cloud/cloud-proxy.ts",
+    "./cloud/reconnect": "./src/cloud/reconnect.ts",
+    "./cloud/validate-url": "./src/cloud/validate-url.ts",
+    "./config": "./src/config/index.ts",
+    "./config/character-schema": "./src/config/character-schema.ts",
+    "./config/config": "./src/config/config.ts",
+    "./config/env-vars": "./src/config/env-vars.ts",
+    "./config/includes": "./src/config/includes.ts",
+    "./config/object-utils": "./src/config/object-utils.ts",
+    "./config/paths": "./src/config/paths.ts",
+    "./config/plugin-auto-enable": "./src/config/plugin-auto-enable.ts",
+    "./config/schema": "./src/config/schema.ts",
+    "./config/types": "./src/config/types.ts",
+    "./config/types.agent-defaults": "./src/config/types.agent-defaults.ts",
+    "./config/types.agents": "./src/config/types.agents.ts",
+    "./config/types.gateway": "./src/config/types.gateway.ts",
+    "./config/types.hooks": "./src/config/types.hooks.ts",
+    "./config/types.messages": "./src/config/types.messages.ts",
+    "./config/types.milady": "./src/config/types.milady.ts",
+    "./config/types.tools": "./src/config/types.tools.ts",
+    "./config/zod-schema": "./src/config/zod-schema.ts",
+    "./contracts": "./src/contracts/index.ts",
+    "./contracts/apps": "./src/contracts/apps.ts",
+    "./contracts/awareness": "./src/contracts/awareness.ts",
+    "./contracts/config": "./src/contracts/config.ts",
+    "./contracts/drop": "./src/contracts/drop.ts",
+    "./contracts/onboarding": "./src/contracts/onboarding.ts",
+    "./contracts/permissions": "./src/contracts/permissions.ts",
+    "./contracts/verification": "./src/contracts/verification.ts",
+    "./contracts/wallet": "./src/contracts/wallet.ts",
+    "./emotes/catalog": "./src/emotes/catalog.ts",
+    "./diagnostics/integration-observability": "./src/diagnostics/integration-observability.ts",
+    "./hooks": "./src/hooks/index.ts",
+    "./hooks/discovery": "./src/hooks/discovery.ts",
+    "./hooks/eligibility": "./src/hooks/eligibility.ts",
+    "./hooks/index": "./src/hooks/index.ts",
+    "./hooks/loader": "./src/hooks/loader.ts",
+    "./hooks/registry": "./src/hooks/registry.ts",
+    "./hooks/types": "./src/hooks/types.ts",
+    "./onboarding-presets": "./src/onboarding-presets.ts",
+    "./plugins/custom-rtmp": "./src/plugins/custom-rtmp/index.ts",
+    "./providers/admin-trust": "./src/providers/admin-trust.ts",
+    "./providers/session-bridge": "./src/providers/session-bridge.ts",
+    "./providers/session-utils": "./src/providers/session-utils.ts",
+    "./providers/simple-mode": "./src/providers/simple-mode.ts",
+    "./providers/ui-catalog": "./src/providers/ui-catalog.ts",
+    "./providers/workspace": "./src/providers/workspace.ts",
+    "./providers/workspace-provider": "./src/providers/workspace-provider.ts",
+    "./runtime": "./src/runtime/index.ts",
+    "./runtime/core-plugins": "./src/runtime/core-plugins.ts",
+    "./runtime/embedding-presets": "./src/runtime/embedding-presets.ts",
+    "./runtime/agent-event-service": "./src/runtime/agent-event-service.ts",
+    "./runtime/eliza": "./src/runtime/eliza.ts",
+    "./runtime/custom-actions": "./src/runtime/custom-actions.ts",
+    "./runtime/milady-plugin": "./src/runtime/milady-plugin.ts",
+    "./runtime/cloud-onboarding": "./src/runtime/cloud-onboarding.ts",
+    "./runtime/onboarding-names": "./src/runtime/onboarding-names.ts",
+    "./runtime/restart": "./src/runtime/restart.ts",
+    "./runtime/release-plugin-policy": "./src/runtime/release-plugin-policy.ts",
+    "./runtime/trajectory-persistence": "./src/runtime/trajectory-persistence.ts",
+    "./runtime/version": "./src/runtime/version.ts",
+    "./security/audit-log": "./src/security/audit-log.ts",
+    "./security/network-policy": "./src/security/network-policy.ts",
+    "./server": "./src/server/index.ts",
+    "./shared/ui-catalog-prompt": "./src/shared/ui-catalog-prompt.ts",
+    "./services": "./src/services/index.ts",
+    "./triggers/action": "./src/triggers/action.ts",
+    "./triggers/runtime": "./src/triggers/runtime.ts",
+    "./triggers/scheduling": "./src/triggers/scheduling.ts",
+    "./triggers/types": "./src/triggers/types.ts",
+    "./services/agent-export": "./src/services/agent-export.ts",
+    "./services/app-manager": "./src/services/app-manager.ts",
+    "./services/browser-capture": "./src/services/browser-capture.ts",
+    "./services/coding-agent-context": "./src/services/coding-agent-context.ts",
+    "./services/fallback-training-service": "./src/services/fallback-training-service.ts",
+    "./services/mcp-marketplace": "./src/services/mcp-marketplace.ts",
+    "./services/plugin-manager-types": "./src/services/plugin-manager-types.ts",
+    "./services/privy-wallets": "./src/services/privy-wallets.ts",
+    "./services/registry-client": "./src/services/registry-client.ts",
+    "./services/remote-signing-service": "./src/services/remote-signing-service.ts",
+    "./services/sandbox-engine": "./src/services/sandbox-engine.ts",
+    "./services/sandbox-manager": "./src/services/sandbox-manager.ts",
+    "./services/skill-catalog-client": "./src/services/skill-catalog-client.ts",
+    "./services/skill-marketplace": "./src/services/skill-marketplace.ts",
+    "./services/self-updater": "./src/services/self-updater.ts",
+    "./services/signal-pairing": "./src/services/signal-pairing.ts",
+    "./services/signing-policy": "./src/services/signing-policy.ts",
+    "./services/stream-manager": "./src/services/stream-manager.ts",
+    "./services/tts-stream-bridge": "./src/services/tts-stream-bridge.ts",
+    "./services/update-checker": "./src/services/update-checker.ts",
+    "./services/version-compat": "./src/services/version-compat.ts",
+    "./services/whatsapp-pairing": "./src/services/whatsapp-pairing.ts",
+    "./testing": "./src/testing/index.ts",
+    "./utils/number-parsing": "./src/utils/number-parsing.ts",
+    "./utils/spoken-text": "./src/utils/spoken-text.ts",
+    "./version-resolver": "./src/version-resolver.ts"
+  },
+  "peerDependencies": {
+    "@elizaos/core": "2.0.0-alpha.10",
+    "@elizaos/signal-native": "*"
+  },
+  "peerDependenciesMeta": {
+    "@elizaos/signal-native": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.0",
+    "@elizaos/plugin-coding-agent": "0.1.0-next.1",
+    "@elizaos/plugin-local-embedding": "alpha",
+    "@elizaos/plugin-ollama": "alpha",
+    "@elizaos/plugin-openai": "alpha",
+    "@elizaos/plugin-pdf": "alpha",
+    "@elizaos/plugin-personality": "alpha",
+    "@elizaos/plugin-pi-ai": "alpha",
+    "@elizaos/plugin-plugin-manager": "alpha",
+    "@elizaos/plugin-rolodex": "alpha",
+    "@elizaos/plugin-secrets-manager": "alpha",
+    "@elizaos/plugin-shell": "alpha",
+    "@elizaos/plugin-sql": "alpha",
+    "@elizaos/plugin-todo": "alpha",
+    "@elizaos/plugin-trajectory-logger": "alpha",
+    "@elizaos/plugin-trust": "alpha",
+    "@elizaos/prompts": "2.0.0-alpha.10",
+    "@elizaos/skills": "2.0.0-alpha.10",
+    "@hapi/boom": "^10.0.1",
+    "@mariozechner/pi-ai": "0.52.12",
+    "@noble/curves": "^2.0.1",
+    "@whiskeysockets/baileys": "7.0.0-rc.9",
+    "coding-agent-adapters": "0.12.0",
+    "drizzle-orm": "0.45.1",
+    "ethers": "^6.16.0",
+    "git-workspace-service": "0.4.4",
+    "json5": "^2.2.3",
+    "pg": "^8.16.3",
+    "pino": "^10.3.1",
+    "pty-manager": "1.9.8",
+    "puppeteer-core": "^24.37.5",
+    "qrcode": "^1.5.4",
+    "ws": "^8.19.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@types/pg": "^8.15.2",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.9.3"
+  },
+  "gitHead": "f77b9c9a2906a357415ad9d687ebc75bcf93926d"
+}

package/src/actions/emote.ts

@@ -0,0 +1,101 @@
+/**
+ * PLAY_EMOTE action — plays an emote animation on the avatar.
+ *
+ * When triggered the action:
+ *   1. Extracts the emote ID from required structured parameters
+ *   2. Looks up the emote in the catalog
+ *   3. POSTs to the local API server to trigger the animation
+ *   4. Returns success without posting chat text
+ *
+ * @module actions/emote
+ */
+
+import type { Action, HandlerOptions } from "@elizaos/core";
+import { AGENT_EMOTE_BY_ID } from "../emotes/catalog";
+
+/** API port for posting emote requests. */
+const API_PORT = process.env.API_PORT || process.env.SERVER_PORT || "2138";
+
+export const emoteAction: Action = {
+  name: "PLAY_EMOTE",
+
+  similes: [
+    "EMOTE",
+    "ANIMATE",
+    "GESTURE",
+    "DANCE",
+    "WAVE",
+    "PLAY_ANIMATION",
+    "DO_EMOTE",
+    "PERFORM",
+  ],
+
+  description:
+    "Play a one-shot emote animation on the avatar, then return to idle. " +
+    "This is a silent non-blocking visual side action that does not create " +
+    "chat text on its own. Only call it when you set the required emote " +
+    "parameter to a valid emote ID. If you also want speech, chain it " +
+    "before, after, or alongside other actions in the same turn " +
+    "(for example with REPLY, SEND_MESSAGE, or stream actions).",
+
+  validate: async (_runtime, _message, _state) => {
+    // Always valid — the handler will check if the emote exists.
+    return true;
+  },
+
+  handler: async (_runtime, _message, _state, options) => {
+    try {
+      const params = (options as HandlerOptions | undefined)?.parameters;
+      const emoteId =
+        typeof params?.emote === "string" ? params.emote.trim() : "";
+
+      if (!emoteId) {
+        return { text: "", success: false };
+      }
+
+      // Look up the emote in the catalog.
+      const emote = AGENT_EMOTE_BY_ID.get(emoteId);
+      if (!emote) {
+        return {
+          text: "",
+          success: false,
+        };
+      }
+
+      // POST to the local API server to trigger the emote.
+      const response = await fetch(`http://localhost:${API_PORT}/api/emote`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ emoteId: emote.id }),
+      });
+
+      if (!response.ok) {
+        return {
+          text: "",
+          success: false,
+        };
+      }
+
+      return {
+        text: "",
+        success: true,
+        data: { emoteId: emote.id },
+      };
+    } catch (_err) {
+      return {
+        text: "",
+        success: false,
+      };
+    }
+  },
+
+  parameters: [
+    {
+      name: "emote",
+      description:
+        "Required emote ID to play once silently before returning to idle",
+      required: true,
+      schema: { type: "string" as const },
+    },
+  ],
+};

package/src/actions/restart.ts

@@ -0,0 +1,101 @@
+/**
+ * RESTART_AGENT action — gracefully restarts the agent.
+ *
+ * When triggered the action:
+ *   1. Persists a "Restarting…" memory so the event is visible in logs
+ *   2. Returns a brief restart notice to the caller
+ *   3. After a short delay (so the response can flush), invokes
+ *      {@link requestRestart} which delegates to the registered
+ *      {@link RestartHandler}.
+ *
+ * In CLI mode the default handler exits with code 75 so the runner script
+ * rebuilds and relaunches. In headless / Electron mode a custom handler
+ * performs an in-process restart (stop → re-init → hot-swap references).
+ *
+ * @module actions/restart
+ */
+
+import crypto from "node:crypto";
+import type { Action, HandlerOptions, Memory, UUID } from "@elizaos/core";
+import { logger } from "@elizaos/core";
+import { requestRestart } from "../runtime/restart";
+
+/** Small delay (ms) before restarting so the response has time to flush. */
+const SHUTDOWN_DELAY_MS = 1_500;
+
+export const restartAction: Action = {
+  name: "RESTART_AGENT",
+
+  similes: [
+    "RESTART",
+    "REBOOT",
+    "RELOAD",
+    "REFRESH",
+    "RESPAWN",
+    "RESTART_SELF",
+    "REBOOT_AGENT",
+    "RELOAD_AGENT",
+  ],
+
+  description:
+    "Restart the agent process. This stops the runtime, rebuilds if source " +
+    "files changed, and relaunches — picking up new code, config, or plugins.",
+
+  validate: async (_runtime, _message, _state) => {
+    // Always valid — the registered handler decides how (or whether) to restart.
+    return true;
+  },
+
+  handler: async (runtime, message, _state, options) => {
+    // This action declares parameters, so the runtime provides HandlerOptions.
+    const params = (options as HandlerOptions | undefined)?.parameters;
+    const reason =
+      typeof params?.reason === "string" ? params.reason : undefined;
+
+    const restartText = reason ? `Restarting… (${reason})` : "Restarting…";
+
+    logger.info(`[milady] ${restartText}`);
+
+    // Persist a "Restarting…" memory so it shows up in the message log.
+    try {
+      const restartMemory: Memory = {
+        id: crypto.randomUUID() as UUID,
+        entityId: runtime.agentId,
+        roomId: message.roomId,
+        worldId: message.worldId,
+        content: {
+          text: restartText,
+          source: "milady",
+          type: "system",
+        },
+      };
+      await runtime.createMemory(restartMemory, "messages");
+    } catch (err) {
+      // Non-fatal — the restart still proceeds even if the memory write fails.
+      const msg = err instanceof Error ? err.message : String(err);
+      logger.warn(`[milady] Could not persist restart memory: ${msg}`);
+    }
+
+    // Schedule the restart slightly after returning so the response can be
+    // delivered to the user / channel before the process bounces.
+    setTimeout(() => {
+      requestRestart(reason);
+    }, SHUTDOWN_DELAY_MS);
+
+    return {
+      text: restartText,
+      success: true,
+      values: { restarting: true },
+      data: { reason },
+    };
+  },
+
+  parameters: [
+    {
+      name: "reason",
+      description: "Optional reason for the restart (logged for diagnostics).",
+      required: false,
+      schema: { type: "string" as const },
+    },
+  ],
+};

package/src/actions/send-message.ts

@@ -0,0 +1,168 @@
+import type { Action, Content, HandlerOptions } from "@elizaos/core";
+
+type MessageTransportService = {
+  sendDirectMessage?: (
+    targetEntityId: string,
+    content: Content,
+  ) => Promise<void>;
+  sendRoomMessage?: (targetRoomId: string, content: Content) => Promise<void>;
+};
+
+export const sendMessageAction: Action = {
+  name: "SEND_MESSAGE",
+  similes: ["DM", "MESSAGE", "SEND_DM", "POST_MESSAGE"],
+  description:
+    "Send a message to a user or room on a specific platform/service using explicit parameters.",
+
+  validate: async () => true,
+
+  handler: async (runtime, _message, _state, options) => {
+    const params = (options as HandlerOptions | undefined)?.parameters;
+    const targetType =
+      params?.targetType === "user" || params?.targetType === "room"
+        ? params.targetType
+        : null;
+    const source =
+      typeof params?.source === "string" ? params.source.trim() : "";
+    const target =
+      typeof params?.target === "string" ? params.target.trim() : "";
+    const text = typeof params?.text === "string" ? params.text.trim() : "";
+
+    if (!targetType || !source || !target || !text) {
+      return {
+        text: "SEND_MESSAGE requires targetType, source, target, and text parameters.",
+        success: false,
+        values: {
+          success: false,
+          error: "INVALID_PARAMETERS",
+        },
+        data: {
+          actionName: "SEND_MESSAGE",
+          targetType,
+          source: source || null,
+          target: target || null,
+        },
+      };
+    }
+
+    const service = runtime.getService(
+      source,
+    ) as MessageTransportService | null;
+    if (!service) {
+      return {
+        text: `Message service '${source}' is not available.`,
+        success: false,
+        values: {
+          success: false,
+          error: "SERVICE_NOT_FOUND",
+        },
+        data: {
+          actionName: "SEND_MESSAGE",
+          targetType,
+          source,
+          target,
+        },
+      };
+    }
+
+    if (targetType === "user") {
+      if (!service.sendDirectMessage) {
+        return {
+          text: `Direct messaging is not supported by '${source}'.`,
+          success: false,
+          values: {
+            success: false,
+            error: "DIRECT_MESSAGE_UNSUPPORTED",
+          },
+          data: {
+            actionName: "SEND_MESSAGE",
+            targetType,
+            source,
+            target,
+          },
+        };
+      }
+      await service.sendDirectMessage(target, { text, source });
+      return {
+        text: `Message sent to user ${target} on ${source}.`,
+        success: true,
+        values: {
+          success: true,
+          targetType,
+          source,
+          target,
+        },
+        data: {
+          actionName: "SEND_MESSAGE",
+          targetType,
+          source,
+          target,
+          text,
+        },
+      };
+    }
+
+    if (!service.sendRoomMessage) {
+      return {
+        text: `Room messaging is not supported by '${source}'.`,
+        success: false,
+        values: {
+          success: false,
+          error: "ROOM_MESSAGE_UNSUPPORTED",
+        },
+        data: {
+          actionName: "SEND_MESSAGE",
+          targetType,
+          source,
+          target,
+        },
+      };
+    }
+    await service.sendRoomMessage(target, { text, source });
+    return {
+      text: `Message sent to room ${target} on ${source}.`,
+      success: true,
+      values: {
+        success: true,
+        targetType,
+        source,
+        target,
+      },
+      data: {
+        actionName: "SEND_MESSAGE",
+        targetType,
+        source,
+        target,
+        text,
+      },
+    };
+  },
+
+  parameters: [
+    {
+      name: "targetType",
+      description: "Target entity type: user or room.",
+      required: true,
+      schema: { type: "string" as const, enum: ["user", "room"] },
+    },
+    {
+      name: "source",
+      description: "Messaging source/service name (e.g. telegram, discord).",
+      required: true,
+      schema: { type: "string" as const },
+    },
+    {
+      name: "target",
+      description:
+        "Target identifier. For users: entity ID/username. For rooms: room ID/name.",
+      required: true,
+      schema: { type: "string" as const },
+    },
+    {
+      name: "text",
+      description: "Message text to send.",
+      required: true,
+      schema: { type: "string" as const },
+    },
+  ],
+};