From 2befbc5e60d1f3e3c0a373d854a3feb8a8affb48 Mon Sep 17 00:00:00 2001
From: Vincent Koc <vincentkoc@ieee.org>
Date: Tue, 31 Mar 2026 17:42:37 +0900
Subject: [PATCH] fix(matrix): restore local helper seams

---
 extensions/matrix/src/cli.ts               | 3 +--
 extensions/matrix/src/matrix/poll-types.ts | 2 +-
 src/config/schema.base.generated.ts        | 2 +-
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/extensions/matrix/src/cli.ts b/extensions/matrix/src/cli.ts
index 59e06d5d72f..b06f38ffc33 100644
--- a/extensions/matrix/src/cli.ts
+++ b/extensions/matrix/src/cli.ts
@@ -1,6 +1,4 @@
 import type { Command } from "commander";
-import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
-import { formatZonedTimestamp, type ChannelSetupInput } from "openclaw/plugin-sdk/matrix";
 import { resolveMatrixAccount, resolveMatrixAccountConfig } from "./matrix/accounts.js";
 import { withResolvedActionClient, withStartedActionClient } from "./matrix/actions/client.js";
 import { listMatrixOwnDevices, pruneMatrixStaleGatewayDevices } from "./matrix/actions/devices.js";
@@ -24,6 +22,7 @@ import {
   type MatrixDirectRoomCandidate,
 } from "./matrix/direct-management.js";
 import { applyMatrixProfileUpdate, type MatrixProfileUpdateResult } from "./profile-update.js";
+import { formatZonedTimestamp, normalizeAccountId, type ChannelSetupInput } from "./runtime-api.js";
 import { getMatrixRuntime } from "./runtime.js";
 import { matrixSetupAdapter } from "./setup-core.js";
 import type { CoreConfig } from "./types.js";
diff --git a/extensions/matrix/src/matrix/poll-types.ts b/extensions/matrix/src/matrix/poll-types.ts
index 23743df64ee..90cc2bea132 100644
--- a/extensions/matrix/src/matrix/poll-types.ts
+++ b/extensions/matrix/src/matrix/poll-types.ts
@@ -7,7 +7,7 @@
  * - m.poll.end - Closes a poll
  */
 
-import { normalizePollInput, type PollInput } from "openclaw/plugin-sdk/matrix";
+import { normalizePollInput, type PollInput } from "../runtime-api.js";
 
 export const M_POLL_START = "m.poll.start" as const;
 export const M_POLL_RESPONSE = "m.poll.response" as const;
diff --git a/src/config/schema.base.generated.ts b/src/config/schema.base.generated.ts
index 916ff7434ad..266a90ea5a8 100644
--- a/src/config/schema.base.generated.ts
+++ b/src/config/schema.base.generated.ts
@@ -13445,7 +13445,7 @@ export const GENERATED_BASE_CONFIG_SCHEMA = {
     },
     "agents.defaults.memorySearch.qmd.extraCollections.name": {
       label: "QMD Extra Collection Name",
-      help: "Use this to preserve a stable collection label for shared transcript roots; omit it only when you want the default agent-scoped name.",
+      help: "Preserves the configured collection label only when the path points outside the agent workspace; paths inside the workspace stay agent-scoped even if a name is provided. Use this for shared cross-agent transcript roots that live outside the workspace.",
       tags: ["advanced"],
     },
     "agents.defaults.memorySearch.qmd.extraCollections.pattern": {