@archipelagolab/lobi 1.0.1 → 1.0.5

package/index.ts

@@ -1,65 +0,0 @@
-import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
-import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
-import { registerMatrixCliMetadata } from "./cli-metadata.js";
-
-export default defineBundledChannelEntry({
-  id: "lobi",
-  name: "Lobi",
-  description: "Lobi - The official A2A (Agent-to-Agent) messaging platform by Lobisland. Designed from the ground up for AI-driven communication, enabling seamless interactions between intelligent agents.",
-  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: registerMatrixCliMetadata,
-  registerFull(api) {
-    // Initialize default Lobi configuration if not exists
-    const config = api.config.loadConfig();
-    if (!config.channels?.lobi) {
-      api.config.updateConfig({
-        channels: {
-          ...config.channels,
-          lobi: {
-            homeserver: "https://lobi.lobisland.com/",
-          },
-        },
-      });
-      api.logger.info?.("[lobi] Initialized default configuration with Lobisland homeserver.");
-    }
-
-    void import("./plugin-entry.handlers.runtime.js")
-      .then(({ ensureMatrixCryptoRuntime }) =>
-        ensureMatrixCryptoRuntime({ log: api.logger.info }).catch((err: unknown) => {
-          const message = formatErrorMessage(err);
-          api.logger.warn?.(`matrix: crypto runtime bootstrap failed: ${message}`);
-        }),
-      )
-      .catch((err: unknown) => {
-        const message = formatErrorMessage(err);
-        api.logger.warn?.(`matrix: 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);
-    });
-  },
-});

package/plugin-entry.handlers.runtime.ts

@@ -1 +0,0 @@
-export * from "./src/plugin-entry.runtime.ts";

package/runtime-api.ts

@@ -1,54 +0,0 @@
-// Keep the external runtime API light so Jiti callers can resolve Matrix config
-// helpers without traversing the full plugin-sdk/runtime graph or bootstrapping
-// matrix-js-sdk during plain runtime-api import.
-export * from "./src/auth-precedence.js";
-export {
-  requiresExplicitMatrixDefaultAccount,
-  resolveMatrixDefaultOrOnlyAccountId,
-} from "./src/account-selection.js";
-export * from "./src/account-selection.js";
-export * from "./src/env-vars.js";
-export * from "./src/storage-paths.js";
-export { ensureMatrixSdkInstalled, isMatrixSdkAvailable } from "./src/matrix/deps.js";
-export {
-  assertHttpUrlTargetsPrivateNetwork,
-  closeDispatcher,
-  createPinnedDispatcher,
-  resolvePinnedHostnameWithPolicy,
-  ssrfPolicyFromDangerouslyAllowPrivateNetwork,
-  ssrfPolicyFromAllowPrivateNetwork,
-  type LookupFn,
-  type SsrFPolicy,
-} from "openclaw/plugin-sdk/ssrf-runtime";
-export {
-  setMatrixThreadBindingIdleTimeoutBySessionKey,
-  setMatrixThreadBindingMaxAgeBySessionKey,
-} from "./src/matrix/thread-bindings-shared.js";
-export { setMatrixRuntime } from "./src/runtime.js";
-export { writeJsonFileAtomically } from "openclaw/plugin-sdk/json-store";
-export type {
-  ChannelDirectoryEntry,
-  ChannelMessageActionContext,
-  OpenClawConfig,
-  PluginRuntime,
-  RuntimeLogger,
-  RuntimeEnv,
-  WizardPrompter,
-} from "openclaw/plugin-sdk/matrix-runtime-shared";
-export { formatZonedTimestamp } from "openclaw/plugin-sdk/matrix-runtime-shared";
-
-export function chunkTextForOutbound(text: string, limit: number): string[] {
-  const chunks: string[] = [];
-  let remaining = text;
-  while (remaining.length > limit) {
-    const window = remaining.slice(0, limit);
-    const splitAt = Math.max(window.lastIndexOf("\n"), window.lastIndexOf(" "));
-    const breakAt = splitAt > 0 ? splitAt : limit;
-    chunks.push(remaining.slice(0, breakAt).trimEnd());
-    remaining = remaining.slice(breakAt).trimStart();
-  }
-  if (remaining.length > 0 || text.length === 0) {
-    chunks.push(remaining);
-  }
-  return chunks;
-}

package/runtime-heavy-api.ts

@@ -1 +0,0 @@
-export * from "./src/matrix-migration.runtime.js";

package/scripts/migrate-to-lobi.sh

@@ -1,72 +0,0 @@
-#!/bin/bash
-# migrate-to-lobi.sh
-# 将 Matrix 插件从 _matrix 路径迁移到 _lobi 路径
-
-set -e
-
-echo "=== Matrix to Lobi 迁移脚本 ==="
-echo ""
-
-# 颜色输出
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-# 检查是否在正确的目录
-if [ ! -f "package.json" ] || [ ! -d "src" ]; then
-    echo -e "${RED}错误: 请在 extensions/matrix 目录下运行此脚本${NC}"
-    exit 1
-fi
-
-echo -e "${YELLOW}步骤 1: 修改 package.json 使用 Fork 的 SDK${NC}"
-# 备份原文件
-cp package.json package.json.backup
-# 替换依赖名称
-sed -i '' 's/"matrix-js-sdk": "41.3.0"/"@your-org\/lobi-js-sdk": "41.3.0-lobi.1"/' package.json
-echo -e "${GREEN}✓ package.json 已修改${NC}"
-
-echo ""
-echo -e "${YELLOW}步骤 2: 替换源码中的导入路径${NC}"
-# 替换所有 matrix-js-sdk 导入为 @your-org/lobi-js-sdk
-find src -type f -name "*.ts" ! -name "*.test.ts" -exec sed -i '' 's/from "matrix-js-sdk/from "@your-org\/lobi-js-sdk/g' {} +
-find src -type f -name "*.ts" ! -name "*.test.ts" -exec sed -i '' "s/from 'matrix-js-sdk/from '@your-org\/lobi-js-sdk/g" {} +
-echo -e "${GREEN}✓ 导入路径已替换${NC}"
-
-echo ""
-echo -e "${YELLOW}步骤 3: 替换硬编码的 _matrix API 路径${NC}"
-# 替换所有硬编码的 _matrix 路径为 _lobi
-find src -type f -name "*.ts" ! -name "*.test.ts" -exec sed -i '' 's/\/_matrix\//\/_lobi\//g' {} +
-echo -e "${GREEN}✓ API 路径已替换${NC}"
-
-echo ""
-echo -e "${YELLOW}步骤 4: 验证修改${NC}"
-echo "检查是否还有残留的 matrix-js-sdk 引用:"
-REMAINING=$(grep -r "matrix-js-sdk" src --include="*.ts" ! --include="*.test.ts" | wc -l)
-if [ "$REMAINING" -gt 0 ]; then
-    echo -e "${YELLOW}警告: 发现 $REMAINING 处残留的 matrix-js-sdk 引用:${NC}"
-    grep -r "matrix-js-sdk" src --include="*.ts" ! --include="*.test.ts"
-else
-    echo -e "${GREEN}✓ 无残留的 matrix-js-sdk 引用${NC}"
-fi
-
-echo ""
-echo "检查是否还有残留的 _matrix 路径:"
-REMAINING_MATRIX=$(grep -r "\/_matrix\/" src --include="*.ts" ! --include="*.test.ts" | wc -l)
-if [ "$REMAINING_MATRIX" -gt 0 ]; then
-    echo -e "${YELLOW}警告: 发现 $REMAINING_MATRIX 处残留的 _matrix 路径:${NC}"
-    grep -r "\/_matrix\/" src --include="*.ts" ! --include="*.test.ts"
-else
-    echo -e "${GREEN}✓ 无残留的 _matrix 路径${NC}"
-fi
-
-echo ""
-echo -e "${GREEN}=== 迁移完成！===${NC}"
-echo ""
-echo "下一步操作:"
-echo "1. 确保已发布 @your-org/lobi-js-sdk 到 npm"
-echo "2. 运行 pnpm install 安装新依赖"
-echo "3. 运行 pnpm build 构建插件"
-echo "4. 运行测试验证功能"
-echo ""
-echo "如需恢复，请执行: mv package.json.backup package.json"

package/secret-contract-api.ts

@@ -1,5 +0,0 @@
-export {
-  channelSecrets,
-  collectRuntimeConfigAssignments,
-  secretTargetRegistryEntries,
-} from "./src/secret-contract.js";

package/setup-entry.ts

@@ -1,13 +0,0 @@
-import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract";
-
-export default defineBundledChannelSetupEntry({
-  importMetaUrl: import.meta.url,
-  plugin: {
-    specifier: "./channel-plugin-api.js",
-    exportName: "matrixPlugin",
-  },
-  secrets: {
-    specifier: "./secret-contract-api.js",
-    exportName: "channelSecrets",
-  },
-});

package/src/account-selection.test.ts

@@ -1,124 +0,0 @@
-import type { OpenClawConfig } from "openclaw/plugin-sdk/config-runtime";
-import { describe, expect, it } from "vitest";
-import {
-  findMatrixAccountEntry,
-  requiresExplicitMatrixDefaultAccount,
-  resolveConfiguredMatrixAccountIds,
-  resolveMatrixDefaultOrOnlyAccountId,
-} from "./account-selection.js";
-import { getMatrixScopedEnvVarNames } from "./env-vars.js";
-
-describe("matrix account selection", () => {
-  it("resolves configured account ids from non-canonical account keys", () => {
-    const cfg: OpenClawConfig = {
-      channels: {
-        matrix: {
-          accounts: {
-            "Team Ops": { homeserver: "https://matrix.example.org" },
-          },
-        },
-      },
-    };
-
-    expect(resolveConfiguredMatrixAccountIds(cfg)).toEqual(["team-ops"]);
-    expect(resolveMatrixDefaultOrOnlyAccountId(cfg)).toBe("team-ops");
-  });
-
-  it("matches the default account against normalized Matrix account keys", () => {
-    const cfg: OpenClawConfig = {
-      channels: {
-        matrix: {
-          defaultAccount: "Team Ops",
-          accounts: {
-            "Ops Bot": { homeserver: "https://matrix.example.org" },
-            "Team Ops": { homeserver: "https://matrix.example.org" },
-          },
-        },
-      },
-    };
-
-    expect(resolveMatrixDefaultOrOnlyAccountId(cfg)).toBe("team-ops");
-    expect(requiresExplicitMatrixDefaultAccount(cfg)).toBe(false);
-  });
-
-  it("requires an explicit default when multiple Matrix accounts exist without one", () => {
-    const cfg: OpenClawConfig = {
-      channels: {
-        matrix: {
-          accounts: {
-            ops: { homeserver: "https://matrix.example.org" },
-            alerts: { homeserver: "https://matrix.example.org" },
-          },
-        },
-      },
-    };
-
-    expect(requiresExplicitMatrixDefaultAccount(cfg)).toBe(true);
-  });
-
-  it("finds the raw Matrix account entry by normalized account id", () => {
-    const cfg: OpenClawConfig = {
-      channels: {
-        matrix: {
-          accounts: {
-            "Team Ops": {
-              homeserver: "https://matrix.example.org",
-              userId: "@ops:example.org",
-            },
-          },
-        },
-      },
-    };
-
-    expect(findMatrixAccountEntry(cfg, "team-ops")).toEqual({
-      homeserver: "https://matrix.example.org",
-      userId: "@ops:example.org",
-    });
-  });
-
-  it("discovers env-backed named Matrix accounts during enumeration", () => {
-    const keys = getMatrixScopedEnvVarNames("team-ops");
-    const cfg: OpenClawConfig = {
-      channels: {
-        matrix: {},
-      },
-    };
-    const env = {
-      [keys.homeserver]: "https://matrix.example.org",
-      [keys.accessToken]: "secret",
-    } satisfies NodeJS.ProcessEnv;
-
-    expect(resolveConfiguredMatrixAccountIds(cfg, env)).toEqual(["team-ops"]);
-    expect(resolveMatrixDefaultOrOnlyAccountId(cfg, env)).toBe("team-ops");
-    expect(requiresExplicitMatrixDefaultAccount(cfg, env)).toBe(false);
-  });
-
-  it("treats mixed default and named env-backed Matrix accounts as multi-account", () => {
-    const keys = getMatrixScopedEnvVarNames("team-ops");
-    const cfg: OpenClawConfig = {
-      channels: {
-        matrix: {},
-      },
-    };
-    const env = {
-      LOBI_HOMESERVER: "https://matrix.example.org",
-      LOBI_ACCESS_TOKEN: "default-secret",
-      [keys.homeserver]: "https://matrix.example.org",
-      [keys.accessToken]: "team-secret",
-    } satisfies NodeJS.ProcessEnv;
-
-    expect(resolveConfiguredMatrixAccountIds(cfg, env)).toEqual(["default", "team-ops"]);
-    expect(requiresExplicitMatrixDefaultAccount(cfg, env)).toBe(true);
-  });
-
-  it("discovers default Matrix accounts backed only by global env vars", () => {
-    const cfg: OpenClawConfig = {};
-    const env = {
-      LOBI_HOMESERVER: "https://matrix.example.org",
-      LOBI_ACCESS_TOKEN: "default-secret",
-    } satisfies NodeJS.ProcessEnv;
-
-    expect(resolveConfiguredMatrixAccountIds(cfg, env)).toEqual(["default"]);
-    expect(resolveMatrixDefaultOrOnlyAccountId(cfg, env)).toBe("default");
-  });
-});

package/src/account-selection.ts

@@ -1,226 +0,0 @@
-import {
-  listCombinedAccountIds,
-  listConfiguredAccountIds,
-  resolveListedDefaultAccountId,
-  resolveNormalizedAccountEntry,
-} from "openclaw/plugin-sdk/account-core";
-import {
-  DEFAULT_ACCOUNT_ID,
-  normalizeAccountId,
-  normalizeOptionalAccountId,
-} from "openclaw/plugin-sdk/account-id";
-import type { OpenClawConfig } from "openclaw/plugin-sdk/config-runtime";
-import { hasConfiguredSecretInput } from "openclaw/plugin-sdk/secret-input";
-import { normalizeOptionalString } from "openclaw/plugin-sdk/text-runtime";
-import {
-  resolveMatrixAccountStringValues,
-  type MatrixResolvedStringField,
-} from "./auth-precedence.js";
-import { getLobiScopedEnvVarNames as getMatrixScopedEnvVarNames, listLobiEnvAccountIds as listMatrixEnvAccountIds } from "./env-vars.js";
-import { isRecord } from "./record-shared.js";
-
-type MatrixTopologyStringSources = Partial<Record<MatrixResolvedStringField, string>>;
-
-function readConfiguredMatrixString(value: unknown): string {
-  return normalizeOptionalString(value) ?? "";
-}
-
-function readConfiguredMatrixSecretSource(value: unknown): string {
-  return hasConfiguredSecretInput(value) ? "configured" : "";
-}
-
-function resolveMatrixChannelStringSources(
-  entry: Record<string, unknown> | null,
-): MatrixTopologyStringSources {
-  if (!entry) {
-    return {};
-  }
-  return {
-    homeserver: readConfiguredMatrixString(entry.homeserver),
-    userId: readConfiguredMatrixString(entry.userId),
-    accessToken: readConfiguredMatrixSecretSource(entry.accessToken),
-    password: readConfiguredMatrixSecretSource(entry.password),
-    deviceId: readConfiguredMatrixString(entry.deviceId),
-    deviceName: readConfiguredMatrixString(entry.deviceName),
-  };
-}
-
-const DEFAULT_LOBI_HOMESERVER = "https://lobi.lobisland.com/";
-
-function readEnvLobiString(env: NodeJS.ProcessEnv, key: string): string {
-  const value = normalizeOptionalString(env[key]);
-  if (key === "LOBI_HOMESERVER" && !value) {
-    return DEFAULT_LOBI_HOMESERVER;
-  }
-  return value ?? "";
-}
-
-function resolveScopedLobiEnvStringSources(
-  accountId: string,
-  env: NodeJS.ProcessEnv,
-): MatrixTopologyStringSources {
-  const keys = getMatrixScopedEnvVarNames(accountId);
-  return {
-    homeserver: readEnvLobiString(env, keys.homeserver),
-    userId: readEnvLobiString(env, keys.userId),
-    accessToken: readEnvLobiString(env, keys.accessToken),
-    password: readEnvLobiString(env, keys.password),
-    deviceId: readEnvLobiString(env, keys.deviceId),
-    deviceName: readEnvLobiString(env, keys.deviceName),
-  };
-}
-
-function resolveGlobalLobiEnvStringSources(env: NodeJS.ProcessEnv): MatrixTopologyStringSources {
-  return {
-    homeserver: readEnvLobiString(env, "LOBI_HOMESERVER"),
-    userId: readEnvLobiString(env, "LOBI_USER_ID"),
-    accessToken: readEnvLobiString(env, "LOBI_ACCESS_TOKEN"),
-    password: readEnvLobiString(env, "LOBI_PASSWORD"),
-    deviceId: readEnvLobiString(env, "LOBI_DEVICE_ID"),
-    deviceName: readEnvLobiString(env, "LOBI_DEVICE_NAME"),
-  };
-}
-
-function hasUsableResolvedMatrixAuth(values: {
-  homeserver: string;
-  userId: string;
-  accessToken: string;
-}): boolean {
-  // Account discovery must keep homeserver+userId shapes because auth can still
-  // resolve through cached Matrix credentials even when no fresh token/password
-  // is present in config or env.
-  return Boolean(values.homeserver && (values.accessToken || values.userId));
-}
-
-function hasFreshResolvedMatrixAuth(values: {
-  homeserver: string;
-  userId: string;
-  accessToken: string;
-  password: string;
-}): boolean {
-  return Boolean(values.homeserver && (values.accessToken || (values.userId && values.password)));
-}
-
-function resolveEffectiveMatrixAccountSources(params: {
-  channel: Record<string, unknown> | null;
-  accountId: string;
-  env: NodeJS.ProcessEnv;
-}): ReturnType<typeof resolveMatrixAccountStringValues> {
-  const normalizedAccountId = normalizeAccountId(params.accountId);
-  return resolveMatrixAccountStringValues({
-    accountId: normalizedAccountId,
-    scopedEnv: resolveScopedLobiEnvStringSources(normalizedAccountId, params.env),
-    channel: resolveMatrixChannelStringSources(params.channel),
-    globalEnv: resolveGlobalLobiEnvStringSources(params.env),
-  });
-}
-
-function hasUsableEffectiveMatrixAccountSource(params: {
-  channel: Record<string, unknown> | null;
-  accountId: string;
-  env: NodeJS.ProcessEnv;
-}): boolean {
-  return hasUsableResolvedMatrixAuth(resolveEffectiveMatrixAccountSources(params));
-}
-
-function hasFreshEffectiveMatrixAccountSource(params: {
-  channel: Record<string, unknown> | null;
-  accountId: string;
-  env: NodeJS.ProcessEnv;
-}): boolean {
-  return hasFreshResolvedMatrixAuth(resolveEffectiveMatrixAccountSources(params));
-}
-
-function hasConfiguredDefaultMatrixAccountSource(params: {
-  channel: Record<string, unknown> | null;
-  env: NodeJS.ProcessEnv;
-}): boolean {
-  return hasFreshEffectiveMatrixAccountSource({
-    channel: params.channel,
-    accountId: DEFAULT_ACCOUNT_ID,
-    env: params.env,
-  });
-}
-
-export function resolveMatrixChannelConfig(cfg: OpenClawConfig): Record<string, unknown> | null {
-  return isRecord(cfg.channels?.matrix) ? cfg.channels.lobi : null;
-}
-
-export function findMatrixAccountEntry(
-  cfg: OpenClawConfig,
-  accountId: string,
-): Record<string, unknown> | null {
-  const channel = resolveMatrixChannelConfig(cfg);
-  if (!channel) {
-    return null;
-  }
-
-  const accounts = isRecord(channel.accounts) ? channel.accounts : null;
-  if (!accounts) {
-    return null;
-  }
-  const entry = resolveNormalizedAccountEntry(accounts, accountId, normalizeAccountId);
-  return isRecord(entry) ? entry : null;
-}
-
-export function resolveConfiguredMatrixAccountIds(
-  cfg: OpenClawConfig,
-  env: NodeJS.ProcessEnv = process.env,
-): string[] {
-  const channel = resolveMatrixChannelConfig(cfg);
-  const configuredAccountIds = listConfiguredAccountIds({
-    accounts: channel && isRecord(channel.accounts) ? channel.accounts : undefined,
-    normalizeAccountId,
-  });
-  if (hasConfiguredDefaultMatrixAccountSource({ channel, env })) {
-    configuredAccountIds.push(DEFAULT_ACCOUNT_ID);
-  }
-  const readyEnvAccountIds = listMatrixEnvAccountIds(env).filter((accountId) =>
-    normalizeAccountId(accountId) === DEFAULT_ACCOUNT_ID
-      ? hasConfiguredDefaultMatrixAccountSource({ channel, env })
-      : hasUsableEffectiveMatrixAccountSource({ channel, accountId, env }),
-  );
-  return listCombinedAccountIds({
-    configuredAccountIds,
-    additionalAccountIds: readyEnvAccountIds,
-    fallbackAccountIdWhenEmpty: channel ? DEFAULT_ACCOUNT_ID : undefined,
-  });
-}
-
-export function resolveMatrixDefaultOrOnlyAccountId(
-  cfg: OpenClawConfig,
-  env: NodeJS.ProcessEnv = process.env,
-): string {
-  const channel = resolveMatrixChannelConfig(cfg);
-  if (!channel) {
-    return DEFAULT_ACCOUNT_ID;
-  }
-
-  const configuredDefault = normalizeOptionalAccountId(
-    typeof channel.defaultAccount === "string" ? channel.defaultAccount : undefined,
-  );
-  const configuredAccountIds = resolveConfiguredMatrixAccountIds(cfg, env);
-  return resolveListedDefaultAccountId({
-    accountIds: configuredAccountIds,
-    configuredDefaultAccountId: configuredDefault,
-    ambiguousFallbackAccountId: DEFAULT_ACCOUNT_ID,
-  });
-}
-
-export function requiresExplicitMatrixDefaultAccount(
-  cfg: OpenClawConfig,
-  env: NodeJS.ProcessEnv = process.env,
-): boolean {
-  const channel = resolveMatrixChannelConfig(cfg);
-  if (!channel) {
-    return false;
-  }
-  const configuredAccountIds = resolveConfiguredMatrixAccountIds(cfg, env);
-  if (configuredAccountIds.length <= 1) {
-    return false;
-  }
-  const configuredDefault = normalizeOptionalAccountId(
-    typeof channel.defaultAccount === "string" ? channel.defaultAccount : undefined,
-  );
-  return !(configuredDefault && configuredAccountIds.includes(configuredDefault));
-}