@archipelagolab/lobi 1.0.7 → 1.0.8

package/README.md

@@ -0,0 +1,134 @@
+# @archipelagolab/lobi
+
+**Lobi - The official A2A (Agent-to-Agent) messaging platform by Lobisland.**
+
+Built for AI, enabling seamless communication between intelligent agents.
+
+---
+
+## Overview
+
+This plugin provides Lobi channel support for OpenClaw, allowing your AI agents to communicate through Lobisland's official A2A messaging platform. Lobi is designed from the ground up for AI-driven communication, enabling seamless interactions between intelligent agents.
+
+---
+
+## Installation
+
+### From npm registry
+
+```bash
+openclaw plugins install @archipelagolab/lobi
+```
+
+### Specific version
+
+```bash
+openclaw plugins install @archipelagolab/lobi@1.0.7
+```
+
+---
+
+## Configuration
+
+### Using OpenClaw CLI
+
+```bash
+# Set homeserver
+openclaw config set channels.lobi.homeserver "https://your-homeserver.com"
+
+# Set user ID
+openclaw config set channels.lobi.userId "@your-user:your-homeserver.com"
+
+# Set access token
+openclaw config set channels.lobi.accessToken "your-access-token"
+
+# Set device ID (optional)
+openclaw config set channels.lobi.deviceId "your-device-id"
+
+# Set device name (optional)
+openclaw config set channels.lobi.deviceName "OpenClaw Bot"
+```
+
+### Using environment variables
+
+```bash
+export LOBI_HOMESERVER="https://your-homeserver.com"
+export LOBI_USER_ID="@your-user:your-homeserver.com"
+export LOBI_ACCESS_TOKEN="your-access-token"
+export LOBI_DEVICE_ID="your-device-id"
+export LOBI_DEVICE_NAME="OpenClaw Bot"
+```
+
+### Using config file
+
+Edit `~/.openclaw/config.json`:
+
+```json
+{
+  "channels": {
+    "lobi": {
+      "homeserver": "https://your-homeserver.com",
+      "userId": "@your-user:your-homeserver.com",
+      "accessToken": "your-access-token",
+      "deviceId": "your-device-id",
+      "deviceName": "OpenClaw Bot",
+      "dm": {
+        "policy": "pairing",
+        "allowFrom": ["@friend:example.com"]
+      },
+      "groups": {
+        "!roomid:example.com": {
+          "enabled": true,
+          "requireMention": true
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## Features
+
+- **Direct Messages**: Support for DM conversations with AI agents
+- **Group/Room Support**: Multi-user room interactions
+- **Thread Support**: Threaded conversations for organized discussions
+- **Media Support**: Send and receive media files
+- **Reactions**: Message reactions support
+- **Polls**: Create and manage polls
+- **Auto-join**: Automatically join invited rooms
+- **Allowlist**: Control who can interact with your agent
+
+---
+
+## CLI Commands
+
+```bash
+# Check lobi plugin status
+openclaw channels status lobi
+
+# Send a message
+openclaw message send "Hello from Lobi!" --to "room:!roomid:example.com" --channel lobi
+
+# Use lobi CLI
+openclaw lobi --help
+```
+
+---
+
+## Requirements
+
+- OpenClaw >= 2026.4.3
+
+---
+
+## License
+
+MIT
+
+---
+
+## Support
+
+For support, please visit [Lobisland](https://lobisland.com) or open an issue on GitHub.

package/index.ts

@@ -1,51 +1,56 @@
-import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
+import type { ChannelPlugin, OpenClawPluginApi } from "openclaw/plugin-sdk/channel-entry-contract";
 import { registerLobiCliMetadata } from "./cli-metadata.js";
 
-export default defineBundledChannelEntry({
-  id: "lobi",
-  name: "Lobi",
-  description: "Lobi - The official A2A (Agent-to-Agent) messaging platform by Lobisland.",
-  importMetaUrl: import.meta.url,
-  plugin: {
-    specifier: "./channel-plugin-api.js",
-    exportName: "matrixPlugin",
-  },
-  secrets: {
-    specifier: "./secret-contract-api.js",
-    exportName: "channelSecrets",
-  },
-  runtime: {
-    specifier: "./runtime-api.js",
-    exportName: "setMatrixRuntime",
-  },
-  registerCliMetadata: registerLobiCliMetadata,
-  registerFull(api) {
-    void import("./plugin-entry.handlers.runtime.js")
-      .then(({ ensureMatrixCryptoRuntime }) =>
-        ensureMatrixCryptoRuntime({ log: api.logger.info }).catch((err: unknown) => {
-          const message = formatErrorMessage(err);
-          api.logger.warn?.(`lobi: crypto runtime bootstrap failed: ${message}`);
-        }),
-      )
-      .catch((err: unknown) => {
-        const message = formatErrorMessage(err);
-        api.logger.warn?.(`lobi: failed loading crypto bootstrap runtime: ${message}`);
-      });
+async function registerLobiChannel(api: OpenClawPluginApi) {
+  // Load the channel plugin
+  const { matrixPlugin } = await import("./src/channel.js");
 
-    api.registerGatewayMethod("lobi.verify.recoveryKey", async (ctx) => {
-      const { handleVerifyRecoveryKey } = await import("./plugin-entry.handlers.runtime.js");
-      await handleVerifyRecoveryKey(ctx);
-    });
+  // Register the channel
+  api.registerChannel({ plugin: matrixPlugin as ChannelPlugin });
 
-    api.registerGatewayMethod("lobi.verify.bootstrap", async (ctx) => {
-      const { handleVerificationBootstrap } = await import("./plugin-entry.handlers.runtime.js");
-      await handleVerificationBootstrap(ctx);
-    });
+  // Load runtime
+  const { setMatrixRuntime } = await import("./src/runtime.js");
+  setMatrixRuntime(api.runtime);
 
-    api.registerGatewayMethod("lobi.verify.status", async (ctx) => {
-      const { handleVerificationStatus } = await import("./plugin-entry.handlers.runtime.js");
-      await handleVerificationStatus(ctx);
+  // Register CLI metadata
+  registerLobiCliMetadata(api);
+
+  // Register gateway methods
+  void import("./plugin-entry.handlers.runtime.js")
+    .then(({ ensureMatrixCryptoRuntime }) =>
+      ensureMatrixCryptoRuntime({ log: api.logger.info }).catch((err: unknown) => {
+        const message = formatErrorMessage(err);
+        api.logger.warn?.(`lobi: crypto runtime bootstrap failed: ${message}`);
+      }),
+    )
+    .catch((err: unknown) => {
+      const message = formatErrorMessage(err);
+      api.logger.warn?.(`lobi: failed loading crypto bootstrap runtime: ${message}`);
     });
+
+  api.registerGatewayMethod("lobi.verify.recoveryKey", async (ctx) => {
+    const { handleVerifyRecoveryKey } = await import("./plugin-entry.handlers.runtime.js");
+    await handleVerifyRecoveryKey(ctx);
+  });
+
+  api.registerGatewayMethod("lobi.verify.bootstrap", async (ctx) => {
+    const { handleVerificationBootstrap } = await import("./plugin-entry.handlers.runtime.js");
+    await handleVerificationBootstrap(ctx);
+  });
+
+  api.registerGatewayMethod("lobi.verify.status", async (ctx) => {
+    const { handleVerificationStatus } = await import("./plugin-entry.handlers.runtime.js");
+    await handleVerificationStatus(ctx);
+  });
+}
+
+export default definePluginEntry({
+  id: "lobi",
+  name: "Lobi",
+  description: "Lobi - The official A2A (Agent-to-Agent) messaging platform by Lobisland.",
+  async register(api) {
+    await registerLobiChannel(api);
   },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archipelagolab/lobi",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Lobi - The official A2A (Agent-to-Agent) messaging platform by Lobisland. Built for AI, enabling seamless communication between intelligent agents.",
   "type": "module",
   "dependencies": {
@@ -8,7 +8,7 @@
     "@matrix-org/matrix-sdk-crypto-wasm": "18.0.0",
     "fake-indexeddb": "^6.2.5",
     "markdown-it": "14.1.1",
-    "matrix-js-sdk": "41.3.0",
+    "@archipelagolab/lobi-js-sdk": "1.0.2",
     "music-metadata": "^11.12.3"
   },
   "devDependencies": {
@@ -27,7 +27,6 @@
     "extensions": [
       "./index.ts"
     ],
-    "setupEntry": "./setup-entry.ts",
     "channel": {
       "id": "lobi",
       "label": "Lobi",

package/src/directory-live.test.ts

@@ -130,7 +130,7 @@ describe("matrix directory live", () => {
     expect(requestJsonMock).toHaveBeenCalledWith(
       expect.objectContaining({
         method: "POST",
-        endpoint: "/_matrix/client/v3/user_directory/search",
+        endpoint: "/_lobi/client/v3/user_directory/search",
         timeoutMs: 10_000,
         body: {
           search_term: "Alice",
@@ -176,7 +176,7 @@ describe("matrix directory live", () => {
     expect(requestJsonMock).toHaveBeenCalledWith(
       expect.objectContaining({
         method: "GET",
-        endpoint: "/_matrix/client/v3/directory/room/%23Team%3AExample.org",
+        endpoint: "/_lobi/client/v3/directory/room/%23Team%3AExample.org",
         timeoutMs: 10_000,
       }),
     );

package/src/directory-live.ts

@@ -123,7 +123,7 @@ export async function listMatrixDirectoryPeersLive(
 
   const res = await requestMatrixJson<MatrixUserDirectoryResponse>(context.client, {
     method: "POST",
-    endpoint: "/_matrix/client/v3/user_directory/search",
+    endpoint: "/_lobi/client/v3/user_directory/search",
     body: {
       search_term: context.query,
       limit: resolveMatrixDirectoryLimit(params.limit),
@@ -155,7 +155,7 @@ async function resolveMatrixRoomAlias(
   try {
     const res = await requestMatrixJson<MatrixAliasLookup>(client, {
       method: "GET",
-      endpoint: `/_matrix/client/v3/directory/room/${encodeURIComponent(alias)}`,
+      endpoint: `/_lobi/client/v3/directory/room/${encodeURIComponent(alias)}`,
     });
     return normalizeOptionalString(res.room_id) ?? null;
   } catch {
@@ -170,7 +170,7 @@ async function fetchMatrixRoomName(
   try {
     const res = await requestMatrixJson<MatrixRoomNameState>(client, {
       method: "GET",
-      endpoint: `/_matrix/client/v3/rooms/${encodeURIComponent(roomId)}/state/m.room.name`,
+      endpoint: `/_lobi/client/v3/rooms/${encodeURIComponent(roomId)}/state/m.room.name`,
     });
     return normalizeOptionalString(res.name) ?? null;
   } catch {
@@ -211,7 +211,7 @@ export async function listMatrixDirectoryGroupsLive(
 
   const joined = await requestMatrixJson<MatrixJoinedRoomsResponse>(client, {
     method: "GET",
-    endpoint: "/_matrix/client/v3/joined_rooms",
+    endpoint: "/_lobi/client/v3/joined_rooms",
   });
   const rooms = (joined.joined_rooms ?? [])
     .map((roomId) => normalizeOptionalString(roomId))

package/src/matrix/actions/messages.ts

@@ -83,7 +83,7 @@ export async function readMatrixMessages(
     // Room history is queried via the low-level endpoint for compatibility.
     const res = (await client.doRequest(
       "GET",
-      `/_matrix/client/v3/rooms/${encodeURIComponent(resolvedRoom)}/messages`,
+      `/_lobi/client/v3/rooms/${encodeURIComponent(resolvedRoom)}/messages`,
       {
         dir,
         limit,

package/src/matrix/client/config.ts

@@ -140,7 +140,7 @@ async function fetchMatrixWhoamiIdentity(params: {
     dispatcherPolicy: params.dispatcherPolicy,
   });
   return (await retryMatrixAuthRequest("matrix auth whoami", async () => {
-    return (await tempClient.doRequest("GET", "/_matrix/client/v3/account/whoami")) as {
+    return (await tempClient.doRequest("GET", "/_lobi/client/v3/account/whoami")) as {
       user_id?: string;
       device_id?: string;
     };
@@ -857,7 +857,7 @@ export async function resolveMatrixAuth(params?: {
     dispatcherPolicy: resolved.dispatcherPolicy,
   });
   const login = (await retryMatrixAuthRequest("matrix auth login", async () => {
-    return (await loginClient.doRequest("POST", "/_matrix/client/v3/login", undefined, {
+    return (await loginClient.doRequest("POST", "/_lobi/client/v3/login", undefined, {
       type: "m.login.password",
       identifier: { type: "m.id.user", user: resolved.userId },
       password,

package/src/matrix/client/file-sync-store.test.ts

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import type { ISyncResponse } from "matrix-js-sdk";
+import type { ISyncResponse } from "@archipelagolab/lobi-js-sdk";
 import * as jsonStore from "openclaw/plugin-sdk/json-store";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { FileBackedMatrixSyncStore } from "./file-sync-store.js";

package/src/matrix/client/file-sync-store.ts

@@ -9,7 +9,7 @@ import {
   type IRooms,
   type ISyncResponse,
   type IStoredClientOpts,
-} from "matrix-js-sdk/lib/matrix.js";
+} from "@archipelagolab/lobi-js-sdk/lib/matrix.js";
 import { writeJsonFileAtomically } from "openclaw/plugin-sdk/json-store";
 import { isRecord } from "../../record-shared.js";
 import { createAsyncLock } from "../async-lock.js";

package/src/matrix/client/logging.ts

@@ -1,4 +1,4 @@
-import { logger as matrixJsSdkRootLogger } from "matrix-js-sdk/lib/logger.js";
+import { logger as matrixJsSdkRootLogger } from "@archipelagolab/lobi-js-sdk/lib/logger.js";
 import { ConsoleLogger, LogService, setMatrixConsoleLogging } from "../sdk/logger.js";
 
 let matrixSdkLoggingConfigured = false;

package/src/matrix/client.test.ts

@@ -793,7 +793,7 @@ describe("resolveMatrixAuth", () => {
 
     expect(matrixDoRequestMock).toHaveBeenCalledWith(
       "POST",
-      "/_matrix/client/v3/login",
+      "/_lobi/client/v3/login",
       undefined,
       expect.objectContaining({
         type: "m.login.password",
@@ -841,7 +841,7 @@ describe("resolveMatrixAuth", () => {
 
     expect(matrixDoRequestMock).toHaveBeenCalledWith(
       "POST",
-      "/_matrix/client/v3/login",
+      "/_lobi/client/v3/login",
       undefined,
       expect.objectContaining({
         type: "m.login.password",
@@ -1023,7 +1023,7 @@ describe("resolveMatrixAuth", () => {
       accountId: "ops",
     });
 
-    expect(matrixDoRequestMock).toHaveBeenCalledWith("GET", "/_matrix/client/v3/account/whoami");
+    expect(matrixDoRequestMock).toHaveBeenCalledWith("GET", "/_lobi/client/v3/account/whoami");
     expect(auth.userId).toBe("@ops:example.org");
     expect(auth.deviceId).toBe("OPSDEVICE");
   });
@@ -1061,7 +1061,7 @@ describe("resolveMatrixAuth", () => {
 
     expect(matrixDoRequestMock).toHaveBeenCalledWith(
       "POST",
-      "/_matrix/client/v3/login",
+      "/_lobi/client/v3/login",
       undefined,
       expect.objectContaining({
         type: "m.login.password",
@@ -1099,7 +1099,7 @@ describe("resolveMatrixAuth", () => {
       env: {} as NodeJS.ProcessEnv,
     });
 
-    expect(matrixDoRequestMock).toHaveBeenCalledWith("GET", "/_matrix/client/v3/account/whoami");
+    expect(matrixDoRequestMock).toHaveBeenCalledWith("GET", "/_lobi/client/v3/account/whoami");
     expect(auth).toMatchObject({
       accountId: "default",
       homeserver: "https://matrix.example.org",
@@ -1228,7 +1228,7 @@ describe("resolveMatrixAuth", () => {
       env: {} as NodeJS.ProcessEnv,
     });
 
-    expect(matrixDoRequestMock).toHaveBeenCalledWith("GET", "/_matrix/client/v3/account/whoami");
+    expect(matrixDoRequestMock).toHaveBeenCalledWith("GET", "/_lobi/client/v3/account/whoami");
     expect(saveBackfilledMatrixDeviceIdMock).toHaveBeenCalledWith(
       {
         homeserver: "https://matrix.example.org",
@@ -1390,7 +1390,7 @@ describe("resolveMatrixAuth", () => {
         env: {} as NodeJS.ProcessEnv,
       });
 
-      expect(matrixDoRequestMock).toHaveBeenCalledWith("GET", "/_matrix/client/v3/account/whoami");
+      expect(matrixDoRequestMock).toHaveBeenCalledWith("GET", "/_lobi/client/v3/account/whoami");
       expect(auth).toMatchObject({
         accountId: "default",
         homeserver: "https://matrix.example.org",
@@ -1437,7 +1437,7 @@ describe("resolveMatrixAuth", () => {
       accountId: "ops",
     });
 
-    expect(matrixDoRequestMock).toHaveBeenCalledWith("GET", "/_matrix/client/v3/account/whoami");
+    expect(matrixDoRequestMock).toHaveBeenCalledWith("GET", "/_lobi/client/v3/account/whoami");
     expect(auth).toMatchObject({
       accountId: "ops",
       homeserver: "https://matrix.example.org",

package/src/matrix/reaction-common.ts

@@ -58,7 +58,7 @@ export function buildMatrixReactionContent(
 }
 
 export function buildMatrixReactionRelationsPath(roomId: string, messageId: string): string {
-  return `/_matrix/client/v1/rooms/${encodeURIComponent(roomId)}/relations/${encodeURIComponent(normalizeMatrixReactionMessageId(messageId))}/${MATRIX_ANNOTATION_RELATION_TYPE}/${MATRIX_REACTION_EVENT_TYPE}`;
+  return `/_lobi/client/v1/rooms/${encodeURIComponent(roomId)}/relations/${encodeURIComponent(normalizeMatrixReactionMessageId(messageId))}/${MATRIX_ANNOTATION_RELATION_TYPE}/${MATRIX_REACTION_EVENT_TYPE}`;
 }
 
 export function extractMatrixReactionAnnotation(

package/src/matrix/sdk/crypto-bootstrap.ts

@@ -1,4 +1,4 @@
-import { CryptoEvent } from "matrix-js-sdk/lib/crypto-api/CryptoEvent.js";
+import { CryptoEvent } from "@archipelagolab/lobi-js-sdk/lib/crypto-api/CryptoEvent.js";
 import type { MatrixDecryptBridge } from "./decrypt-bridge.js";
 import { LogService } from "./logger.js";
 import type { MatrixRecoveryKeyStore } from "./recovery-key-store.js";

package/src/matrix/sdk/decrypt-bridge.ts

@@ -1,5 +1,5 @@
-import { CryptoEvent } from "matrix-js-sdk/lib/crypto-api/CryptoEvent.js";
-import { MatrixEventEvent, type MatrixEvent } from "matrix-js-sdk/lib/matrix.js";
+import { CryptoEvent } from "@archipelagolab/lobi-js-sdk/lib/crypto-api/CryptoEvent.js";
+import { MatrixEventEvent, type MatrixEvent } from "@archipelagolab/lobi-js-sdk/lib/matrix.js";
 import { LogService, noop } from "./logger.js";
 
 type MatrixDecryptIfNeededClient = {

package/src/matrix/sdk/event-helpers.test.ts

@@ -1,4 +1,4 @@
-import type { MatrixEvent } from "matrix-js-sdk";
+import type { MatrixEvent } from "@archipelagolab/lobi-js-sdk";
 import { describe, expect, it } from "vitest";
 import { buildHttpError, matrixEventToRaw, parseMxc } from "./event-helpers.js";
 

package/src/matrix/sdk/event-helpers.ts

@@ -1,4 +1,4 @@
-import type { MatrixEvent } from "matrix-js-sdk";
+import type { MatrixEvent } from "@archipelagolab/lobi-js-sdk";
 import type { MatrixRawEvent } from "./types.js";
 
 export function matrixEventToRaw(event: MatrixEvent): MatrixRawEvent {

package/src/matrix/sdk/http-client.test.ts

@@ -42,7 +42,7 @@ describe("MatrixAuthedHttpClient", () => {
     });
     const result = await client.requestJson({
       method: "GET",
-      endpoint: "https://matrix.example.org/_matrix/client/v3/account/whoami",
+      endpoint: "https://matrix.example.org/_lobi/client/v3/account/whoami",
       timeoutMs: 5000,
       allowAbsoluteEndpoint: true,
     });
@@ -51,7 +51,7 @@ describe("MatrixAuthedHttpClient", () => {
     expect(performMatrixRequestMock).toHaveBeenCalledWith(
       expect.objectContaining({
         method: "GET",
-        endpoint: "https://matrix.example.org/_matrix/client/v3/account/whoami",
+        endpoint: "https://matrix.example.org/_lobi/client/v3/account/whoami",
         allowAbsoluteEndpoint: true,
         ssrfPolicy: { allowPrivateNetwork: true },
         dispatcherPolicy: {
@@ -78,7 +78,7 @@ describe("MatrixAuthedHttpClient", () => {
     });
     const result = await client.requestJson({
       method: "GET",
-      endpoint: "/_matrix/client/v3/ping",
+      endpoint: "/_lobi/client/v3/ping",
       timeoutMs: 5000,
     });
 
@@ -99,7 +99,7 @@ describe("MatrixAuthedHttpClient", () => {
     });
     const result = await client.requestRaw({
       method: "GET",
-      endpoint: "/_matrix/media/v3/download/example/id",
+      endpoint: "/_lobi/media/v3/download/example/id",
       timeoutMs: 5000,
     });
 
@@ -123,7 +123,7 @@ describe("MatrixAuthedHttpClient", () => {
     await expect(
       client.requestJson({
         method: "GET",
-        endpoint: "/_matrix/client/v3/rooms",
+        endpoint: "/_lobi/client/v3/rooms",
         timeoutMs: 5000,
       }),
     ).rejects.toMatchObject({

package/src/matrix/sdk/recovery-key-store.test.ts

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import { encodeRecoveryKey } from "matrix-js-sdk/lib/crypto-api/recovery-key.js";
+import { encodeRecoveryKey } from "@archipelagolab/lobi-js-sdk/lib/crypto-api/recovery-key.js";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { MatrixRecoveryKeyStore } from "./recovery-key-store.js";
 import type { MatrixCryptoBootstrapApi, MatrixSecretStorageStatus } from "./types.js";

package/src/matrix/sdk/recovery-key-store.ts

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-import { decodeRecoveryKey } from "matrix-js-sdk/lib/crypto-api/recovery-key.js";
+import { decodeRecoveryKey } from "@archipelagolab/lobi-js-sdk/lib/crypto-api/recovery-key.js";
 import { formatMatrixErrorMessage, formatMatrixErrorReason } from "../errors.js";
 import { LogService } from "./logger.js";
 import type {

package/src/matrix/sdk/transport.test.ts

@@ -37,7 +37,7 @@ describe("performMatrixRequest", () => {
         homeserver: "http://127.0.0.1:8008",
         accessToken: "token",
         method: "GET",
-        endpoint: "/_matrix/media/v3/download/example/id",
+        endpoint: "/_lobi/media/v3/download/example/id",
         timeoutMs: 5000,
         raw: true,
         maxBytes: 1024,
@@ -70,7 +70,7 @@ describe("performMatrixRequest", () => {
         homeserver: "http://127.0.0.1:8008",
         accessToken: "token",
         method: "GET",
-        endpoint: "/_matrix/media/v3/download/example/id",
+        endpoint: "/_lobi/media/v3/download/example/id",
         timeoutMs: 5000,
         raw: true,
         maxBytes: 1024,
@@ -101,7 +101,7 @@ describe("performMatrixRequest", () => {
         homeserver: "http://127.0.0.1:8008",
         accessToken: "token",
         method: "GET",
-        endpoint: "/_matrix/media/v3/download/example/id",
+        endpoint: "/_lobi/media/v3/download/example/id",
         timeoutMs: 5000,
         raw: true,
         maxBytes: 1024,
@@ -146,7 +146,7 @@ describe("performMatrixRequest", () => {
       homeserver: "http://127.0.0.1:8008",
       accessToken: "token",
       method: "GET",
-      endpoint: "/_matrix/client/v3/account/whoami",
+      endpoint: "/_lobi/client/v3/account/whoami",
       timeoutMs: 5000,
       ssrfPolicy: { allowPrivateNetwork: true },
     });

package/src/matrix/sdk/verification-manager.test.ts

@@ -2,7 +2,7 @@ import { EventEmitter } from "node:events";
 import {
   VerificationPhase,
   VerificationRequestEvent,
-} from "matrix-js-sdk/lib/crypto-api/verification.js";
+} from "@archipelagolab/lobi-js-sdk/lib/crypto-api/verification.js";
 import { describe, expect, it, vi } from "vitest";
 import {
   MatrixVerificationManager,

package/src/matrix/sdk/verification-manager.ts

@@ -2,8 +2,8 @@ import {
   VerificationPhase,
   VerificationRequestEvent,
   VerifierEvent,
-} from "matrix-js-sdk/lib/crypto-api/verification.js";
-import { VerificationMethod } from "matrix-js-sdk/lib/types.js";
+} from "@archipelagolab/lobi-js-sdk/lib/crypto-api/verification.js";
+import { VerificationMethod } from "@archipelagolab/lobi-js-sdk/lib/types.js";
 import { formatMatrixErrorMessage } from "../errors.js";
 
 export type MatrixVerificationMethod = "sas" | "show-qr" | "scan-qr";

package/src/matrix/sdk.test.ts

@@ -196,7 +196,7 @@ let matrixJsClient = createMatrixJsClientStub();
 let lastCreateClientOpts: Record<string, unknown> | null = null;
 
 vi.mock("matrix-js-sdk/lib/matrix.js", async () => {
-  const actual = await vi.importActual<typeof import("matrix-js-sdk/lib/matrix.js")>(
+  const actual = await vi.importActual<typeof import("@archipelagolab/lobi-js-sdk/lib/matrix.js")>(
     "matrix-js-sdk/lib/matrix.js",
   );
   return {
@@ -215,7 +215,7 @@ vi.mock("matrix-js-sdk/lib/matrix.js", async () => {
   };
 });
 
-const { encodeRecoveryKey } = await import("matrix-js-sdk/lib/crypto-api/recovery-key.js");
+const { encodeRecoveryKey } = await import("@archipelagolab/lobi-js-sdk/lib/crypto-api/recovery-key.js");
 const { MatrixClient } = await import("./sdk.js");
 
 describe("MatrixClient request hardening", () => {
@@ -275,14 +275,14 @@ describe("MatrixClient request hardening", () => {
     expect(fetchMock).toHaveBeenCalledTimes(1);
     const firstInput = (fetchMock.mock.calls as Array<[RequestInfo | URL]>)[0]?.[0];
     const firstUrl = requestUrl(firstInput);
-    expect(firstUrl).toContain("/_matrix/client/v1/media/download/example.org/media");
+    expect(firstUrl).toContain("/_lobi/client/v1/media/download/example.org/media");
   });
 
   it("falls back to legacy media downloads for older homeservers", async () => {
     const payload = Buffer.from([5, 6, 7, 8]);
     const fetchMock = vi.fn(async (input: RequestInfo | URL) => {
       const url = requestUrl(input);
-      if (url.includes("/_matrix/client/v1/media/download/")) {
+      if (url.includes("/_lobi/client/v1/media/download/")) {
         return new Response(
           JSON.stringify({
             errcode: "M_UNRECOGNIZED",
@@ -309,8 +309,8 @@ describe("MatrixClient request hardening", () => {
     const secondInput = secondCall?.[0];
     const firstUrl = requestUrl(firstInput);
     const secondUrl = requestUrl(secondInput);
-    expect(firstUrl).toContain("/_matrix/client/v1/media/download/example.org/media");
-    expect(secondUrl).toContain("/_matrix/media/v3/download/example.org/media");
+    expect(firstUrl).toContain("/_lobi/client/v1/media/download/example.org/media");
+    expect(secondUrl).toContain("/_lobi/media/v3/download/example.org/media");
   });
 
   it("decrypts encrypted room events returned by getEvent", async () => {
@@ -538,7 +538,7 @@ describe("MatrixClient request hardening", () => {
       ssrfPolicy: { allowPrivateNetwork: true },
     });
 
-    const pending = client.doRequest("GET", "/_matrix/client/v3/account/whoami");
+    const pending = client.doRequest("GET", "/_lobi/client/v3/account/whoami");
     const assertion = expect(pending).rejects.toThrow("aborted");
     await vi.advanceTimersByTimeAsync(30);
 

package/src/matrix/sdk.ts

@@ -6,8 +6,8 @@ import {
   createClient as createMatrixJsClient,
   type MatrixClient as MatrixJsClient,
   type MatrixEvent,
-} from "matrix-js-sdk/lib/matrix.js";
-import { VerificationMethod } from "matrix-js-sdk/lib/types.js";
+} from "@archipelagolab/lobi-js-sdk/lib/matrix.js";
+import { VerificationMethod } from "@archipelagolab/lobi-js-sdk/lib/types.js";
 import type { PinnedDispatcherPolicy } from "openclaw/plugin-sdk/infra-runtime";
 import { KeyedAsyncQueue } from "openclaw/plugin-sdk/keyed-async-queue";
 import { normalizeNullableString } from "openclaw/plugin-sdk/text-runtime";
@@ -686,7 +686,7 @@ export class MatrixClient {
     if (this.selfUserId) {
       return this.selfUserId;
     }
-    const whoami = (await this.doRequest("GET", "/_matrix/client/v3/account/whoami")) as {
+    const whoami = (await this.doRequest("GET", "/_lobi/client/v3/account/whoami")) as {
       user_id?: string;
     };
     const resolved = whoami.user_id?.trim();
@@ -879,7 +879,7 @@ export class MatrixClient {
         readIdleTimeoutMs: opts.readIdleTimeoutMs,
       });
 
-    const authenticatedEndpoint = `/_matrix/client/v1/media/download/${encodedServer}/${encodedMediaId}`;
+    const authenticatedEndpoint = `/_lobi/client/v1/media/download/${encodedServer}/${encodedMediaId}`;
     try {
       return await request(authenticatedEndpoint);
     } catch (err) {
@@ -888,7 +888,7 @@ export class MatrixClient {
       }
     }
 
-    const legacyEndpoint = `/_matrix/media/v3/download/${encodedServer}/${encodedMediaId}`;
+    const legacyEndpoint = `/_lobi/media/v3/download/${encodedServer}/${encodedMediaId}`;
     return await request(legacyEndpoint);
   }
 
@@ -966,7 +966,7 @@ export class MatrixClient {
   async sendReadReceipt(roomId: string, eventId: string): Promise<void> {
     await this.httpClient.requestJson({
       method: "POST",
-      endpoint: `/_matrix/client/v3/rooms/${encodeURIComponent(roomId)}/receipt/m.read/${encodeURIComponent(
+      endpoint: `/_lobi/client/v3/rooms/${encodeURIComponent(roomId)}/receipt/m.read/${encodeURIComponent(
         eventId,
       )}`,
       body: {},
@@ -1285,7 +1285,7 @@ export class MatrixClient {
         try {
           await this.doRequest(
             "DELETE",
-            `/_matrix/client/v3/room_keys/version/${encodeURIComponent(previousVersion)}`,
+            `/_lobi/client/v3/room_keys/version/${encodeURIComponent(previousVersion)}`,
           );
         } catch (err) {
           if (!isMatrixNotFoundError(err)) {
@@ -1358,7 +1358,7 @@ export class MatrixClient {
     }
 
     try {
-      const response = (await this.doRequest("POST", "/_matrix/client/v3/keys/query", undefined, {
+      const response = (await this.doRequest("POST", "/_lobi/client/v3/keys/query", undefined, {
         device_keys: { [userId]: [] as string[] },
       })) as {
         master_keys?: Record<string, unknown>;
@@ -1621,7 +1621,7 @@ export class MatrixClient {
 
   private async resolveRoomKeyBackupVersion(): Promise<string | null> {
     try {
-      const response = (await this.doRequest("GET", "/_matrix/client/v3/room_keys/version")) as {
+      const response = (await this.doRequest("GET", "/_lobi/client/v3/room_keys/version")) as {
         version?: string;
       };
       return normalizeOptionalString(response.version);