@elizaos/plugin-matrix 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/providers/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":""}

package/dist/service.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Matrix service implementation for ElizaOS.
+ *
+ * This service provides Matrix messaging capabilities using matrix-js-sdk.
+ */
+import { type Content, type IAgentRuntime, type Memory, Service } from "@elizaos/core";
+import { type IMatrixService, type MatrixMessageSendOptions, type MatrixRoom, type MatrixSendResult } from "./types.js";
+/**
+ * Serialized form of an IndexedDB database: object-store schemas plus their
+ * records. v8.serialize handles the structured-clone values (typed arrays,
+ * Maps, etc.) the rust-crypto store writes, so this shape round-trips losslessly.
+ */
+export type CryptoStoreSnapshot = {
+    version: number;
+    stores: Record<string, {
+        schema: {
+            keyPath: IDBObjectStore["keyPath"];
+            autoIncrement: boolean;
+            indexes: {
+                name: string;
+                keyPath: IDBIndex["keyPath"];
+                unique: boolean;
+                multiEntry: boolean;
+            }[];
+        };
+        records: {
+            key: IDBValidKey;
+            value: unknown;
+        }[];
+    }>;
+};
+/**
+ * Read every object store of an IndexedDB database into a serializable snapshot:
+ * each store's schema (keyPath, autoIncrement, indexes) plus all of its records.
+ * Pure over the global `indexedDB`, so it is unit-testable with fake-indexeddb.
+ */
+export declare function snapshotDb(name: string): Promise<CryptoStoreSnapshot>;
+/**
+ * Recreate an IndexedDB database from a snapshot: delete any existing db, build
+ * the stores + indexes in an upgrade transaction, then replay the records.
+ * Keyless stores re-supply the out-of-line key; keyPath stores derive it.
+ * Pure over the global `indexedDB`, so it is unit-testable with fake-indexeddb.
+ */
+export declare function restoreDb(name: string, snapshot: CryptoStoreSnapshot): Promise<void>;
+/**
+ * Matrix messaging service for ElizaOS agents.
+ */
+export declare class MatrixService extends Service implements IMatrixService {
+    static serviceType: string;
+    capabilityDescription: string;
+    protected runtime: IAgentRuntime;
+    private states;
+    private defaultAccountId;
+    /**
+     * Start the Matrix service.
+     */
+    static start(runtime: IAgentRuntime): Promise<MatrixService>;
+    /**
+     * Stop the Matrix service.
+     */
+    static stopRuntime(runtime: IAgentRuntime): Promise<void>;
+    static registerSendHandlers(runtime: IAgentRuntime, service: MatrixService, accountId?: string): void;
+    /**
+     * Initialize the Matrix service.
+     */
+    private initialize;
+    /**
+     * Load settings from runtime.
+     */
+    private loadSettings;
+    /**
+     * Validate the settings.
+     */
+    private validateSettings;
+    /**
+     * Initialize end-to-end encryption for an account when MATRIX_ENCRYPTION is
+     * enabled. Most homeservers (including Continuwuity) encrypt rooms by
+     * default, so without crypto the client can neither decrypt inbound nor
+     * encrypt outbound messages — it would silently drop everything.
+     *
+     * The rust-crypto store persists in IndexedDB. This runtime (Bun/Node) has no
+     * native IndexedDB, so `fake-indexeddb/auto` installs a global one and the
+     * whole crypto state — device identity, cross-signing, and inbound megolm
+     * sessions — is snapshotted to an encrypted file via saveCryptoStore and
+     * restored before init via restoreCryptoStore. A stable device keeps the
+     * curve25519/ed25519 identity across restarts, so senders treat it as the
+     * same trusted device and keep sharing room keys (including forwarded history
+     * keys at join), which is what makes history decryptable.
+     *
+     * Non-fatal by construction: if anything in the persistence path fails we fall
+     * back to an in-memory store so the Matrix connection still comes up. Never
+     * throws.
+     */
+    private initCrypto;
+    /**
+     * Self-cross-sign this device so cohort senders running "exclude insecure
+     * devices" (MSC4153) share megolm room keys to it — the thing that makes
+     * encrypted cohort messages decryptable. The device otherwise carries an empty
+     * cross-signing identity and is structurally skipped by those senders.
+     *
+     * Works with only an access token: MSC3967 (implemented by the homeserver) lets
+     * the FIRST device-signing-key upload through with no UIA, so we send auth=null
+     * and soft-fail (log, never throw) if the server still demands a password we
+     * don't have. Idempotent + non-fatal: the signing keys persist in the
+     * snapshotted rust store, so isCrossSigningReady() short-circuits this on every
+     * later boot, and any failure leaves the Matrix connection untouched.
+     */
+    private ensureCrossSigning;
+    /**
+     * Restore the persisted rust-crypto IndexedDB store from the encrypted at-rest
+     * file into the live (fake-indexeddb) global, replacing whatever is there.
+     * Must run BEFORE initRustCrypto so the store is populated when the crypto
+     * stack opens it.
+     *
+     * Strictly additive and non-fatal: any failure (missing file, corrupt data,
+     * token rotation making decrypt impossible) only warns and returns, leaving an
+     * empty store so the device starts fresh.
+     */
+    private restoreCryptoStore;
+    /**
+     * Snapshot the live rust-crypto IndexedDB store and persist it, encrypted at
+     * rest, so the device identity and room keys survive a process restart. The
+     * snapshot contains PRIVATE device keys, so it is written 0600 and encrypted
+     * under a token-derived key. Atomic (tmp + rename) so a crash mid-write can
+     * never truncate the live file. Strictly additive and non-fatal: failures only
+     * warn and never affect the Matrix connection.
+     */
+    private saveCryptoStore;
+    /**
+     * Start the periodic crypto-store snapshot for an account. The interval is
+     * unref'd so it never keeps the process alive on its own, and its handle is
+     * stored on the account state so stop() can clear it.
+     */
+    private startCryptoSnapshot;
+    /**
+     * Set up event handlers for the Matrix client.
+     */
+    private setupEventHandlers;
+    /**
+     * Let allow-listed users verify this device via SAS (emoji) verification from
+     * their own Matrix client. On homeservers where the bot can't self-cross-sign
+     * (no MSC3967 + no password), this is how senders come to trust the device and
+     * start sharing megolm keys to it — and the verifying user's client also
+     * gossips the room keys it already holds, backfilling history.
+     *
+     * Fail-closed: with no MATRIX_VERIFY_ALLOWLIST nothing is accepted, so this is
+     * inert unless explicitly configured. The verified trust persists in the
+     * snapshotted crypto store, so it is a one-time action per user.
+     */
+    private setupVerificationAutoAccept;
+    private handleVerificationRequest;
+    /**
+     * Wait for the verifier to materialize. The bot is a pure responder: the
+     * initiator (e.g. Element) sends the m.key.verification.start, which creates
+     * the verifier on our side. We only start SAS ourselves as a fallback, after a
+     * short grace period, for the rare initiator that waits for the responder to
+     * start — starting eagerly would race the initiator's start ("glare") and the
+     * two sides would compute the SAS over different start events, failing the
+     * match. Resolves undefined if the request is cancelled or completes first.
+     */
+    private awaitVerifier;
+    /**
+     * Handle an incoming room message.
+     */
+    private handleRoomMessage;
+    /**
+     * Feed an inbound Matrix message into the core message loop and wire a
+     * callback that posts the agent's reply back to the same room. Mirrors the
+     * connector pattern used by plugin-discord: emit EventType.MESSAGE_RECEIVED
+     * with a core Memory and a HandlerCallback. The bootstrap message handler
+     * runs the agent, decides whether to respond, and invokes the callback.
+     */
+    private dispatchToAgent;
+    /**
+     * Connect to Matrix.
+     */
+    private connect;
+    /**
+     * Shutdown the service.
+     */
+    stop(): Promise<void>;
+    isConnected(): boolean;
+    getAccountId(runtime?: IAgentRuntime): string;
+    getUserId(): string;
+    getHomeserver(): string;
+    getJoinedRooms(accountId?: string): Promise<MatrixRoom[]>;
+    /**
+     * Read recent messages straight from the SDK's live room timeline (kept in
+     * sync by the RoomEvent.Timeline listener), newest-first. Unlike the agent's
+     * own memory DB, this surfaces room activity the agent never persisted —
+     * e.g. a busy room where the bot was never mentioned.
+     */
+    getRoomMessages(matrixRoomId: string, limit: number, accountId?: string): Promise<Memory[]>;
+    sendMessage(text: string, options?: MatrixMessageSendOptions): Promise<MatrixSendResult>;
+    sendReaction(roomId: string, eventId: string, emoji: string, accountId?: string): Promise<MatrixSendResult>;
+    joinRoom(roomIdOrAlias: string, accountId?: string): Promise<string>;
+    leaveRoom(roomId: string, accountId?: string): Promise<void>;
+    sendTyping(roomId: string, typing: boolean, timeout?: number, accountId?: string): Promise<void>;
+    sendReadReceipt(roomId: string, eventId: string, accountId?: string): Promise<void>;
+    sendRoomMessage(roomIdOrAlias: string, content: Content): Promise<void>;
+    sendDirectMessage(roomIdOrAlias: string, content: Content): Promise<void>;
+    private handleSendMessage;
+    private getState;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,241 @@
+/**
+ * Type definitions for the Matrix plugin.
+ */
+import type { IAgentRuntime, Service } from "@elizaos/core";
+/** Maximum message length for Matrix */
+export declare const MAX_MATRIX_MESSAGE_LENGTH = 4000;
+/** Service name constant */
+export declare const MATRIX_SERVICE_NAME = "matrix";
+/** Event types emitted by the Matrix plugin */
+export declare enum MatrixEventTypes {
+    MESSAGE_RECEIVED = "MATRIX_MESSAGE_RECEIVED",
+    MESSAGE_SENT = "MATRIX_MESSAGE_SENT",
+    ROOM_JOINED = "MATRIX_ROOM_JOINED",
+    ROOM_LEFT = "MATRIX_ROOM_LEFT",
+    INVITE_RECEIVED = "MATRIX_INVITE_RECEIVED",
+    REACTION_RECEIVED = "MATRIX_REACTION_RECEIVED",
+    TYPING_RECEIVED = "MATRIX_TYPING_RECEIVED",
+    SYNC_COMPLETE = "MATRIX_SYNC_COMPLETE",
+    CONNECTION_READY = "MATRIX_CONNECTION_READY",
+    CONNECTION_LOST = "MATRIX_CONNECTION_LOST"
+}
+/** Configuration settings for the Matrix plugin */
+export interface MatrixSettings {
+    /** Connector account identifier for this Matrix bot instance */
+    accountId?: string;
+    /** Matrix homeserver URL */
+    homeserver: string;
+    /** Matrix user ID (@user:homeserver) */
+    userId: string;
+    /** Access token for authentication */
+    accessToken: string;
+    /**
+     * Account password — only used to satisfy user-interactive auth when
+     * self-cross-signing on homeservers that require it for the device-signing-key
+     * upload (i.e. no MSC3967). Absent ⇒ cross-signing is attempted token-only and
+     * skipped if the server demands a password.
+     */
+    password?: string;
+    /** Device ID for this session */
+    deviceId?: string;
+    /** Rooms to auto-join */
+    rooms: string[];
+    /** Whether to auto-accept invites */
+    autoJoin: boolean;
+    /** Enable end-to-end encryption */
+    encryption: boolean;
+    /** Require mention to respond in rooms */
+    requireMention: boolean;
+    /**
+     * Matrix user IDs allowed to verify this device via SAS (emoji) verification.
+     * When one of them starts a verification from their own client, the bot auto-
+     * accepts and auto-confirms, so their client then shares megolm room keys to
+     * this now-trusted device. Fail-closed: empty ⇒ no verification is accepted.
+     */
+    verifyAllowlist: string[];
+    /**
+     * Whether this account is the HUMAN owner's personal account (acting as the
+     * user) rather than the agent's own identity. A personal account is exposed as
+     * an OWNER connector behind the owner_binding access gate (acting as the user
+     * requires a verified binding); the default account — the agent's own Matrix
+     * identity — is an AGENT connector with the open gate (acting as the bot is
+     * frictionless).
+     */
+    personal: boolean;
+    /** Whether this configuration is enabled */
+    enabled: boolean;
+}
+/** Information about a Matrix user */
+export interface MatrixUserInfo {
+    /** Matrix user ID (@user:homeserver) */
+    userId: string;
+    /** Display name */
+    displayName?: string;
+    /** Avatar URL */
+    avatarUrl?: string;
+}
+/** Represents a Matrix room */
+export interface MatrixRoom {
+    /** Room ID (!room:homeserver) */
+    roomId: string;
+    /** Room name */
+    name?: string;
+    /** Room topic */
+    topic?: string;
+    /** Room alias (#alias:homeserver) */
+    canonicalAlias?: string;
+    /** Whether room is encrypted */
+    isEncrypted: boolean;
+    /** Whether this is a direct message room */
+    isDirect: boolean;
+    /** Member count */
+    memberCount: number;
+}
+/** Represents a Matrix message */
+export interface MatrixMessage {
+    /** Event ID */
+    eventId: string;
+    /** Room ID */
+    roomId: string;
+    /** Sender user ID */
+    sender: string;
+    /** Sender info */
+    senderInfo: MatrixUserInfo;
+    /** Message content */
+    content: string;
+    /** Message type (m.text, m.image, etc.) */
+    msgType: string;
+    /** Formatted body (HTML) */
+    formattedBody?: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Thread root event ID */
+    threadId?: string;
+    /** Reply-to event ID */
+    replyTo?: string;
+    /** Whether this is an edit */
+    isEdit: boolean;
+    /** Original event ID if this is an edit */
+    replacesEventId?: string;
+}
+/** Options for sending a message */
+export interface MatrixMessageSendOptions {
+    /** Connector account identifier */
+    accountId?: string;
+    /** Room ID or alias to send to */
+    roomId?: string;
+    /** Event ID to reply to */
+    replyTo?: string;
+    /** Thread root event ID */
+    threadId?: string;
+    /** Format as HTML */
+    formatted?: boolean;
+    /** Media URL to attach */
+    mediaUrl?: string;
+}
+/** Result from sending a message */
+export interface MatrixSendResult {
+    /** Whether the send succeeded */
+    success: boolean;
+    /** Event ID of the sent message */
+    eventId?: string;
+    /** Room ID */
+    roomId?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/** Interface for the Matrix service */
+export interface IMatrixService extends Service {
+    /** Check if the service is connected */
+    isConnected(): boolean;
+    /** Get the user ID */
+    getUserId(): string;
+    /** Get the homeserver URL */
+    getHomeserver(): string;
+    /** Get joined rooms */
+    getJoinedRooms(): Promise<MatrixRoom[]>;
+    /** Send a message */
+    sendMessage(text: string, options?: MatrixMessageSendOptions): Promise<MatrixSendResult>;
+    /** Send a reaction */
+    sendReaction(roomId: string, eventId: string, emoji: string): Promise<MatrixSendResult>;
+    /** Join a room */
+    joinRoom(roomIdOrAlias: string): Promise<string>;
+    /** Leave a room */
+    leaveRoom(roomId: string): Promise<void>;
+    /** Send typing indicator */
+    sendTyping(roomId: string, typing: boolean, timeout?: number): Promise<void>;
+    /** Send read receipt */
+    sendReadReceipt(roomId: string, eventId: string): Promise<void>;
+}
+/** Payload for MESSAGE_RECEIVED event */
+export interface MatrixMessageReceivedPayload {
+    message: MatrixMessage;
+    room: MatrixRoom;
+    runtime: IAgentRuntime;
+}
+/** Payload for MESSAGE_SENT event */
+export interface MatrixMessageSentPayload {
+    roomId: string;
+    eventId: string;
+    content: string;
+}
+/** Payload for ROOM_JOINED event */
+export interface MatrixRoomJoinedPayload {
+    room: MatrixRoom;
+}
+/** Payload for INVITE_RECEIVED event */
+export interface MatrixInviteReceivedPayload {
+    roomId: string;
+    inviter: string;
+}
+/**
+ * Check if a string is a valid Matrix user ID.
+ */
+export declare function isValidMatrixUserId(userId: string): boolean;
+/**
+ * Check if a string is a valid Matrix room ID.
+ */
+export declare function isValidMatrixRoomId(roomId: string): boolean;
+/**
+ * Check if a string is a valid Matrix room alias.
+ */
+export declare function isValidMatrixRoomAlias(alias: string): boolean;
+/**
+ * Extract the localpart from a Matrix ID.
+ */
+export declare function getMatrixLocalpart(matrixId: string): string;
+/**
+ * Extract the server part from a Matrix ID.
+ */
+export declare function getMatrixServerpart(matrixId: string): string;
+/**
+ * Get the best display name for a Matrix user.
+ */
+export declare function getMatrixUserDisplayName(user: MatrixUserInfo): string;
+/**
+ * Convert a media URL to an HTTP URL via homeserver.
+ */
+export declare function matrixMxcToHttp(mxcUrl: string, homeserver: string): string | undefined;
+/** Base error class for Matrix plugin errors */
+export declare class MatrixPluginError extends Error {
+    constructor(message: string);
+}
+/** Error when the Matrix service is not initialized */
+export declare class MatrixServiceNotInitializedError extends MatrixPluginError {
+    constructor(message?: string);
+}
+/** Error when the Matrix client is not connected */
+export declare class MatrixNotConnectedError extends MatrixPluginError {
+    constructor(message?: string);
+}
+/** Error when there is a configuration problem */
+export declare class MatrixConfigurationError extends MatrixPluginError {
+    settingName?: string;
+    constructor(message: string, settingName?: string);
+}
+/** Error when an API call fails */
+export declare class MatrixApiError extends MatrixPluginError {
+    errcode?: string;
+    constructor(message: string, errcode?: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/workflow-credential-provider.d.ts

@@ -0,0 +1,21 @@
+import { type IAgentRuntime, Service } from "@elizaos/core";
+type CredentialProviderResult = {
+    status: "credential_data";
+    data: Record<string, unknown>;
+} | {
+    status: "needs_auth";
+    authUrl: string;
+} | null;
+export declare class MatrixWorkflowCredentialProvider extends Service {
+    static readonly serviceType = "workflow_credential_provider";
+    capabilityDescription: string;
+    static start(runtime: IAgentRuntime): Promise<MatrixWorkflowCredentialProvider>;
+    stop(): Promise<void>;
+    resolve(_userId: string, credType: string): Promise<CredentialProviderResult>;
+    checkCredentialTypes(credTypes: string[]): {
+        supported: string[];
+        unsupported: string[];
+    };
+}
+export {};
+//# sourceMappingURL=workflow-credential-provider.d.ts.map

package/dist/workflow-credential-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-credential-provider.d.ts","sourceRoot":"","sources":["../src/workflow-credential-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAK5D,KAAK,wBAAwB,GACzB;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC5D;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC,IAAI,CAAC;AAIT,qBAAa,gCAAiC,SAAQ,OAAO;IAC3D,gBAAyB,WAAW,kCAAqC;IAChE,qBAAqB,SAAyD;WAE1E,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gCAAgC,CAAC;IAI/E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAErB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAWnF,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE;CAM1F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-matrix",
-  "version": "2.0.3-beta.5",
+  "version": "2.0.3-beta.7",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -54,7 +54,7 @@
     "matrix-js-sdk": "^41.4.0"
   },
   "peerDependencies": {
-    "@elizaos/core": "2.0.3-beta.5"
+    "@elizaos/core": "2.0.3-beta.7"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.14",
@@ -126,5 +126,5 @@
       }
     }
   },
-  "gitHead": "ff6157011c9459670021cc28a6797592a78b8817"
+  "gitHead": "61094f10458d11055c75b3dd0bae374e3f66bac5"
 }