@xopcai/xopc 0.0.313 → 0.0.314

package/dist/browser-ext/dist/assets/{auth-C3yV1y_l.js → auth-DKo-NMUY.js}

@@ -5301,6 +5301,7 @@ function endpointHelloSigningPayload(payload) {
 }
 
 const REALTIME_PROTOCOL_VERSION = 2;
+const REALTIME_MAX_CLIENT_FRAME_BYTES = 256 * 1024;
 const REALTIME_HEARTBEAT_INTERVAL_MS = 15e3;
 const REALTIME_HEARTBEAT_TIMEOUT_MS = 45e3;
 const REALTIME_CAPABILITIES = ["realtime.capability-negotiation.v1"];
@@ -5394,6 +5395,16 @@ class RealtimeConnectionError extends Error {
   }
   retryable;
 }
+class RealtimeFrameTooLargeError extends Error {
+  constructor(bytes, maxBytes) {
+    super(`Realtime client frame is ${bytes} bytes; maximum is ${maxBytes} bytes`);
+    this.bytes = bytes;
+    this.maxBytes = maxBytes;
+    this.name = "RealtimeFrameTooLargeError";
+  }
+  bytes;
+  maxBytes;
+}
 function frameText(data) {
   if (typeof data === "string") return data;
   if (data instanceof ArrayBuffer) return new TextDecoder().decode(data);
@@ -5632,6 +5643,7 @@ class RealtimeClient {
       this.cursors.set(message.payload.topic, message.payload.seq);
     } else if (message.kind === "realtime.subscribed") {
       this.cursors.set(message.payload.topic, message.payload.cursor);
+      this.options.onSubscribed?.(message.payload);
     } else if (message.kind === "realtime.gap") {
       this.cursors.set(message.payload.topic, message.payload.earliestSeq - 1);
       return this.options.onGap?.(message.payload);
@@ -5658,7 +5670,12 @@ class RealtimeClient {
   }
   send(message) {
     if (!this.socket || this.socket.readyState !== 1) return;
-    this.socket.send(JSON.stringify(message));
+    const data = JSON.stringify(message);
+    const bytes = new TextEncoder().encode(data).byteLength;
+    if (bytes > REALTIME_MAX_CLIENT_FRAME_BYTES) {
+      throw new RealtimeFrameTooLargeError(bytes, REALTIME_MAX_CLIENT_FRAME_BYTES);
+    }
+    this.socket.send(data);
   }
   scheduleReconnect(error) {
     if (!this.shouldReconnect) return;

package/dist/browser-ext/dist/background.js

@@ -1,4 +1,4 @@
-import { j as endpointToolContentSchema, E as ENDPOINT_PROTOCOL_VERSION, e as canonicalJson, T as TAB_BINDING_PREFIX, f as captureTabWithPermission, P as PENDING_CONTEXT_KEY, x as t, q as readProfile, s as registerBrowserEndpoint, m as getAccessProfile, a as RealtimeClient, g as createBrowserEndpointHello, l as gatewayFetch, R as REALTIME_PROTOCOL_VERSION } from './assets/auth-C3yV1y_l.js';
+import { j as endpointToolContentSchema, E as ENDPOINT_PROTOCOL_VERSION, e as canonicalJson, T as TAB_BINDING_PREFIX, f as captureTabWithPermission, P as PENDING_CONTEXT_KEY, x as t, q as readProfile, s as registerBrowserEndpoint, m as getAccessProfile, a as RealtimeClient, g as createBrowserEndpointHello, l as gatewayFetch, R as REALTIME_PROTOCOL_VERSION } from './assets/auth-DKo-NMUY.js';
 
 const BROWSER_EXTENSION_PROTOCOL_VERSION = 5;
 const BROWSER_CONTROL_ENDPOINT_TOOL_NAME = "browser.control";
@@ -563,6 +563,9 @@ class EndpointToolHostController {
   }
   normalizeError(error) {
     if (error instanceof EndpointToolClientError) return error;
+    if (error instanceof Error && error.name === "RealtimeFrameTooLargeError") {
+      return new EndpointToolClientError("RESULT_TOO_LARGE", error.message);
+    }
     if (error instanceof TypeError) {
       return new EndpointToolClientError("INVALID_ARGUMENTS", error.message);
     }
@@ -1144,6 +1147,69 @@ function diff(previous, next) {
   };
 }
 
+const MAX_BROWSER_CONTROL_RESULT_BYTES = 224 * 1024;
+function utf8Bytes(value) {
+  return new TextEncoder().encode(JSON.stringify(value)).byteLength;
+}
+function observationOf(result) {
+  return result.ok ? result.receipt.observation : result.error.observation;
+}
+function withObservation(result, observation) {
+  return result.ok ? { ...result, receipt: { ...result.receipt, observation } } : { ...result, error: { ...result.error, observation } };
+}
+function truncatedObservation(observation, options) {
+  return {
+    ...observation,
+    nodes: observation.nodes.slice(0, options.nodeCount),
+    ...options.visualOmitted ? { visual: void 0 } : {},
+    ...options.changesOmitted ? { changes: { added: [], changed: [], removed: [] } } : {},
+    truncation: {
+      omittedNodeCount: observation.nodes.length - options.nodeCount,
+      visualOmitted: options.visualOmitted,
+      changesOmitted: options.changesOmitted
+    }
+  };
+}
+function fitBrowserControlResultToFrame(result, maxBytes = MAX_BROWSER_CONTROL_RESULT_BYTES) {
+  if (utf8Bytes(result) <= maxBytes) return result;
+  const observation = observationOf(result);
+  if (!observation) return result;
+  const withoutVisual = withObservation(result, truncatedObservation(observation, {
+    nodeCount: observation.nodes.length,
+    visualOmitted: Boolean(observation.visual),
+    changesOmitted: false
+  }));
+  if (utf8Bytes(withoutVisual) <= maxBytes) return withoutVisual;
+  const withoutChanges = withObservation(result, truncatedObservation(observation, {
+    nodeCount: observation.nodes.length,
+    visualOmitted: Boolean(observation.visual),
+    changesOmitted: true
+  }));
+  if (utf8Bytes(withoutChanges) <= maxBytes) return withoutChanges;
+  let low = 0;
+  let high = observation.nodes.length;
+  let fitted = withObservation(result, truncatedObservation(observation, {
+    nodeCount: 0,
+    visualOmitted: Boolean(observation.visual),
+    changesOmitted: true
+  }));
+  while (low <= high) {
+    const nodeCount = Math.floor((low + high) / 2);
+    const candidate = withObservation(result, truncatedObservation(observation, {
+      nodeCount,
+      visualOmitted: Boolean(observation.visual),
+      changesOmitted: true
+    }));
+    if (utf8Bytes(candidate) <= maxBytes) {
+      fitted = candidate;
+      low = nodeCount + 1;
+    } else {
+      high = nodeCount - 1;
+    }
+  }
+  return fitted;
+}
+
 const log = createLogger("Background");
 const BACKGROUND_CLIENT_ID_KEY = "xopc.browser.background-client-id";
 const RECONNECT_ALARM = "xopc.browser.reconnect";
@@ -1173,7 +1239,7 @@ const browserToolRegistry = new EndpointToolRegistry([{
       timeoutMs: typeof args.timeoutMs === "number" ? args.timeoutMs : 3e4,
       visualFallback: args.visualFallback !== false
     });
-    return { content: [{ type: "json", value: result.result }] };
+    return { content: [{ type: "json", value: fitBrowserControlResultToFrame(result.result) }] };
   }
 }]);
 const endpointHost = new EndpointToolHostController({

package/dist/browser-ext/dist/sidepanel.html

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>xopc</title>
     <script type="module" crossorigin src="./sidepanel.js"></script>
-    <link rel="modulepreload" crossorigin href="./assets/auth-C3yV1y_l.js">
+    <link rel="modulepreload" crossorigin href="./assets/auth-DKo-NMUY.js">
     <link rel="stylesheet" crossorigin href="./assets/sidepanel-DD6GEMvc.css">
   </head>
   <body>

package/dist/browser-ext/dist/sidepanel.js

@@ -1,4 +1,4 @@
-import { x as t, M as MAX_BROWSER_CONTEXTS_PER_TURN, c as browserPageContextsInputSchema, l as gatewayFetch, k as extensionLocale, o as openDatabase, a as RealtimeClient, R as REALTIME_PROTOCOL_VERSION, b as activeTabId, h as currentTabDescriptor, T as TAB_BINDING_PREFIX, m as getAccessProfile, u as runWithTabSiteAccess, P as PENDING_CONTEXT_KEY, f as captureTabWithPermission, p as pairGateway, w as setAutoConnectEnabled, r as readPendingBrowserPairing, q as readProfile, i as discoverLocalGateway, v as saveExtensionLocalePreference, t as revokeAndForgetProfile, d as cancelPendingBrowserPairing, n as loadExtensionLocalePreference } from './assets/auth-C3yV1y_l.js';
+import { x as t, M as MAX_BROWSER_CONTEXTS_PER_TURN, c as browserPageContextsInputSchema, l as gatewayFetch, k as extensionLocale, o as openDatabase, a as RealtimeClient, R as REALTIME_PROTOCOL_VERSION, b as activeTabId, h as currentTabDescriptor, T as TAB_BINDING_PREFIX, m as getAccessProfile, u as runWithTabSiteAccess, P as PENDING_CONTEXT_KEY, f as captureTabWithPermission, p as pairGateway, w as setAutoConnectEnabled, r as readPendingBrowserPairing, q as readProfile, i as discoverLocalGateway, v as saveExtensionLocalePreference, t as revokeAndForgetProfile, d as cancelPendingBrowserPairing, n as loadExtensionLocalePreference } from './assets/auth-DKo-NMUY.js';
 
 const OTHER_ACTIVITY = {
   category: "other",

package/dist/browser-ext/manifest.json

@@ -3,7 +3,7 @@
   "minimum_chrome_version": "120",
   "default_locale": "en",
   "name": "__MSG_appName__",
-  "version": "0.0.313",
+  "version": "0.0.314",
   "description": "__MSG_appDescription__",
   "key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqnpr4vpLC/nmvy+wiOWk3SWlp2nEZkFijfk8ivGw7StNZgCK90nOMvwhdEtlkk3GOWDvdVnq8HxCsM3UNQ8FnGUyerpH1FJXqXuradxeHf8ZxFjiQU/mIWfnKbUuONWQORon3/pigyoXoK/VUXgg0Wbm/rbVwsS0bv+25R6m+mZgBspOLeKuoH7ivhL+48WV6POtMBsFPZweY26477EM7ukh+56Ff5ENevB8ymxBBn7qK5ZoeZd2a23U8ioX5TsHfe6fnrjitPWjIxD8G0NoKQxcaa/Mo+xs+T6UiLKxP0wjz5bm7jB5H+CXtkRJqzBWUB0h+RSLJckzZfA8BAJrRwIDAQAB",
   "permissions": [

package/dist/extensions/feishu/src/adapters/cli-login.js

@@ -1,6 +1,6 @@
 import { mergeDistinctSenderIds } from "../../../../src/channels/pairing/preseed-allow-from.js";
 import { beginAppRegistration, initAppRegistration, pollAppRegistration, printQrCode } from "../auth/app-registration.js";
-import fsSync from "node:fs";
+import fs from "node:fs";
 import { confirm, input, select } from "@inquirer/prompts";
 //#region extensions/feishu/src/adapters/cli-login.ts
 /**
@@ -11,14 +11,14 @@ import { confirm, input, select } from "@inquirer/prompts";
 */
 function loadConfigFromPath(configPath) {
 	try {
-		const raw = fsSync.readFileSync(configPath, "utf8");
+		const raw = fs.readFileSync(configPath, "utf8");
 		return JSON.parse(raw);
 	} catch {
 		return {};
 	}
 }
 function writeConfigToPath(configPath, config) {
-	fsSync.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf8");
+	fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf8");
 }
 function isFeishuConfigured(config) {
 	const feishu = config.channels?.feishu;

package/dist/extensions/feishu/src/outbound/media-load.js

@@ -1,6 +1,6 @@
-import { getMimeType } from "../../../../src/channels/media.js";
-import { getWorkspacePath } from "../../../../src/config/workspace-path-helpers.js";
 import { checkFileSafety } from "../../../../src/agent/prompt/safety.js";
+import { getWorkspacePath } from "../../../../src/config/workspace-path-helpers.js";
+import { getMimeType } from "../../../../src/channels/media.js";
 import path from "node:path";
 import { promises } from "node:fs";
 import { Readable } from "node:stream";

package/dist/extensions/telegram/src/inbound-processor.js

@@ -1,6 +1,7 @@
 import { createLogger } from "../../../src/utils/logger/index.js";
 import { init_logger } from "../../../src/utils/logger.js";
 import { resolveRoute } from "../../../src/routing/resolve-route.js";
+import { checkMentionInTranscription } from "../../../src/voice/stt/mention.js";
 import { normalizeTelegramCommandName, parseSlashCommand } from "../../../src/chat-commands/command-parse.js";
 import { answerClarificationTextFromChannel } from "../../../src/gateway/clarify-runtime.js";
 import { buildTelegramUpdateKey, telegramUpdateDedupe } from "./dedupe.js";
@@ -8,7 +9,6 @@ import "../../../src/routing/index.js";
 import { resolveTelegramGroupContext } from "./group-config-resolver.js";
 import { buildTelegramConversationId } from "./conversation-id.js";
 import { resolveTelegramFocusedConversationId } from "./focus-handler.js";
-import { checkMentionInTranscription } from "../../../src/voice/stt/mention.js";
 //#region extensions/telegram/src/inbound-processor.ts
 init_logger();
 const log = createLogger("TelegramInboundProcessor");

package/dist/extensions/telegram/src/outbound-sender.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../../../src/utils/logger/index.js";
 import { init_logger } from "../../../src/utils/logger.js";
+import { createRetryRunner, isRecoverableNetworkError } from "../../../src/infra/retry.js";
 import { buildSendOptions, parseDataUrl, resolveMediaMethod } from "./send-options.js";
 import { splitTelegramCaption } from "./caption.js";
 import { markdownToTelegramChunks, renderTelegramHtmlText } from "./format.js";
 import { sentMessageCache } from "./sent-cache.js";
-import { createRetryRunner, isRecoverableNetworkError } from "../../../src/infra/retry.js";
 import { isTelegramHtmlParseError } from "./errors.js";
 import { InputFile } from "grammy";
 //#region extensions/telegram/src/outbound-sender.ts

package/dist/extensions/telegram/src/plugin.js

@@ -1,17 +1,17 @@
 import { createLogger } from "../../../src/utils/logger/index.js";
 import { init_logger } from "../../../src/utils/logger.js";
 import { TelegramConfigSchema, init_config_schema } from "./config-schema.js";
-import { generateConversationId } from "../../../src/chat-commands/session-key.js";
+import { isSTTAvailable } from "../../../src/voice/stt/availability.js";
 import { registerChannelExecApprovalHandler } from "../../../src/channels/exec-approval-runtime.js";
+import { generateConversationId } from "../../../src/chat-commands/session-key.js";
+import { answerClarificationChoiceFromChannel } from "../../../src/gateway/clarify-runtime.js";
 import { resolveStandardPairingPath } from "../../../src/channels/pairing/paths.js";
 import { issuePairingChallenge } from "../../../src/channels/pairing/pairing-challenge.js";
 import { createStandardPairingAdapter } from "../../../src/channels/pairing/pairing-store-adapter.js";
 import "./pairing-config-resolver.js";
-import { answerClarificationChoiceFromChannel } from "../../../src/gateway/clarify-runtime.js";
 import { createTimeoutAbortSignal } from "./timeout-abort.js";
 import { createInboundDebouncer } from "../../../src/infra/debounce.js";
 import { getMimeType } from "../../../src/channels/media.js";
-import { isSTTAvailable } from "../../../src/voice/stt/availability.js";
 import { TelegramAccountManager } from "./account-manager.js";
 import { createOutboundSender } from "./outbound-sender.js";
 import { createTelegramCommandHandler } from "./command-handler.js";

package/dist/extensions/telegram/xopc.extension.json

@@ -2,7 +2,7 @@
   "id": "telegram",
   "name": "Telegram Channel",
   "description": "Bundled Telegram Bot channel (private workspace sources; ships inside @xopcai/xopc dist/)",
-  "version": "0.0.313",
+  "version": "0.0.314",
   "kind": "channel",
   "main": "src/index.js",
   "channels": [

package/dist/extensions/weixin/src/api/api.js

@@ -2,7 +2,7 @@ import { hasProxyEnv } from "../../../../src/infra/http-proxy-env.js";
 import { logger } from "../util/logger.js";
 import { redactBody, redactUrl } from "../util/redact.js";
 import path from "node:path";
-import fsSync from "node:fs";
+import fs from "node:fs";
 import { fileURLToPath } from "node:url";
 import crypto from "node:crypto";
 import { Agent, EnvHttpProxyAgent, fetch as fetch$1 } from "undici";
@@ -11,7 +11,7 @@ function readPackageJson() {
 	try {
 		const dir = path.dirname(fileURLToPath(import.meta.url));
 		const pkgPath = path.resolve(dir, "..", "..", "package.json");
-		return JSON.parse(fsSync.readFileSync(pkgPath, "utf-8"));
+		return JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
 	} catch {
 		return {};
 	}

package/dist/extensions/weixin/src/auth/accounts.js

@@ -3,7 +3,7 @@ import { normalizeWeixinAccountId } from "./weixin-account-id.js";
 import { resolveWeixinRootDir } from "../storage/state-dir.js";
 import { deleteGetUpdatesBuf } from "../storage/sync-buf.js";
 import path from "node:path";
-import fsSync from "node:fs";
+import fs from "node:fs";
 //#region extensions/weixin/src/auth/accounts.ts
 const DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com";
 const CDN_BASE_URL = "https://novac2c.cdn.weixin.qq.com/c2c";
@@ -16,8 +16,8 @@ function resolveAccountIndexPath() {
 function listIndexedWeixinAccountIds() {
 	const filePath = resolveAccountIndexPath();
 	try {
-		if (!fsSync.existsSync(filePath)) return [];
-		const raw = fsSync.readFileSync(filePath, "utf-8");
+		if (!fs.existsSync(filePath)) return [];
+		const raw = fs.readFileSync(filePath, "utf-8");
 		const parsed = JSON.parse(raw);
 		if (!Array.isArray(parsed)) return [];
 		return parsed.filter((id) => typeof id === "string" && id.trim() !== "");
@@ -27,16 +27,16 @@ function listIndexedWeixinAccountIds() {
 }
 function registerWeixinAccountId(accountId) {
 	const dir = resolveWeixinStateDir();
-	fsSync.mkdirSync(dir, { recursive: true });
+	fs.mkdirSync(dir, { recursive: true });
 	const existing = listIndexedWeixinAccountIds();
 	if (existing.includes(accountId)) return;
 	const updated = [...existing, accountId];
-	fsSync.writeFileSync(resolveAccountIndexPath(), JSON.stringify(updated, null, 2), "utf-8");
+	fs.writeFileSync(resolveAccountIndexPath(), JSON.stringify(updated, null, 2), "utf-8");
 }
 function unregisterWeixinAccountId(accountId) {
 	const existing = listIndexedWeixinAccountIds();
 	const updated = existing.filter((id) => id !== accountId);
-	if (updated.length !== existing.length) fsSync.writeFileSync(resolveAccountIndexPath(), JSON.stringify(updated, null, 2), "utf-8");
+	if (updated.length !== existing.length) fs.writeFileSync(resolveAccountIndexPath(), JSON.stringify(updated, null, 2), "utf-8");
 }
 function clearStaleAccountsForUserId(currentAccountId, userId, onClearContextTokens) {
 	if (!userId) return;
@@ -59,7 +59,7 @@ function resolveAccountPath(accountId) {
 }
 function readAccountFile(filePath) {
 	try {
-		if (fsSync.existsSync(filePath)) return JSON.parse(fsSync.readFileSync(filePath, "utf-8"));
+		if (fs.existsSync(filePath)) return JSON.parse(fs.readFileSync(filePath, "utf-8"));
 	} catch {}
 	return null;
 }
@@ -68,7 +68,7 @@ function loadWeixinAccount(accountId) {
 }
 function saveWeixinAccount(accountId, update) {
 	const dir = resolveAccountsDir();
-	fsSync.mkdirSync(dir, { recursive: true });
+	fs.mkdirSync(dir, { recursive: true });
 	const existing = loadWeixinAccount(accountId) ?? {};
 	const token = update.token?.trim() || existing.token;
 	const baseUrl = update.baseUrl?.trim() || existing.baseUrl;
@@ -82,9 +82,9 @@ function saveWeixinAccount(accountId, update) {
 		...userId ? { userId } : {}
 	};
 	const filePath = resolveAccountPath(accountId);
-	fsSync.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
+	fs.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
 	try {
-		fsSync.chmodSync(filePath, 384);
+		fs.chmodSync(filePath, 384);
 	} catch {}
 }
 function clearWeixinAccount(accountId) {
@@ -92,10 +92,10 @@ function clearWeixinAccount(accountId) {
 	const dir = resolveAccountsDir();
 	const accountFiles = [`${accountId}.json`, `${accountId}.context-tokens.json`];
 	for (const file of accountFiles) try {
-		fsSync.unlinkSync(path.join(dir, file));
+		fs.unlinkSync(path.join(dir, file));
 	} catch {}
 	try {
-		fsSync.unlinkSync(resolveFrameworkAllowFromPath(accountId));
+		fs.unlinkSync(resolveFrameworkAllowFromPath(accountId));
 	} catch {}
 }
 function weixinSection(cfg) {

package/dist/extensions/weixin/src/messaging/debug-mode.js

@@ -1,7 +1,7 @@
 import { logger } from "../util/logger.js";
 import { resolveWeixinRootDir } from "../storage/state-dir.js";
 import path from "node:path";
-import fsSync from "node:fs";
+import fs from "node:fs";
 //#region extensions/weixin/src/messaging/debug-mode.ts
 /**
 * Per-bot debug mode toggle, persisted to disk so it survives gateway restarts.
@@ -17,7 +17,7 @@ function resolveDebugModePath() {
 }
 function loadState() {
 	try {
-		const raw = fsSync.readFileSync(resolveDebugModePath(), "utf-8");
+		const raw = fs.readFileSync(resolveDebugModePath(), "utf-8");
 		const parsed = JSON.parse(raw);
 		if (parsed && typeof parsed.accounts === "object") return parsed;
 	} catch {}
@@ -25,8 +25,8 @@ function loadState() {
 }
 function saveState(state) {
 	const filePath = resolveDebugModePath();
-	fsSync.mkdirSync(path.dirname(filePath), { recursive: true });
-	fsSync.writeFileSync(filePath, JSON.stringify(state, null, 2), "utf-8");
+	fs.mkdirSync(path.dirname(filePath), { recursive: true });
+	fs.writeFileSync(filePath, JSON.stringify(state, null, 2), "utf-8");
 }
 /** Toggle debug mode for a bot account. Returns the new state. */
 function toggleDebugMode(accountId) {
@@ -50,7 +50,7 @@ function isDebugMode(accountId) {
 */
 function _resetForTest() {
 	try {
-		fsSync.unlinkSync(resolveDebugModePath());
+		fs.unlinkSync(resolveDebugModePath());
 	} catch {}
 }
 //#endregion

package/dist/extensions/weixin/src/messaging/inbound.js

@@ -4,7 +4,7 @@ import { MessageItemType } from "../api/types.js";
 import { canonicalWeixinPeerId, normalizeWeixinAccountId } from "../auth/weixin-account-id.js";
 import { resolveWeixinRootDir } from "../storage/state-dir.js";
 import path from "node:path";
-import fsSync from "node:fs";
+import fs from "node:fs";
 //#region extensions/weixin/src/messaging/inbound.ts
 /**
 * contextToken is issued per-message by the Weixin getupdates API and must
@@ -66,8 +66,8 @@ function persistContextTokens(accountId) {
 	const filePath = canonicalContextTokenFilePath(accountId);
 	try {
 		const dir = path.dirname(filePath);
-		fsSync.mkdirSync(dir, { recursive: true });
-		fsSync.writeFileSync(filePath, JSON.stringify(tokens, null, 0), "utf-8");
+		fs.mkdirSync(dir, { recursive: true });
+		fs.writeFileSync(filePath, JSON.stringify(tokens, null, 0), "utf-8");
 	} catch (err) {
 		logger.warn(`persistContextTokens: failed to write ${filePath}: ${String(err)}`);
 	}
@@ -81,8 +81,8 @@ function restoreContextTokens(accountId) {
 	const norm = normalizeWeixinAccountId(accountId);
 	const filePath = canonicalContextTokenFilePath(accountId);
 	try {
-		if (fsSync.existsSync(filePath)) {
-			const raw = fsSync.readFileSync(filePath, "utf-8");
+		if (fs.existsSync(filePath)) {
+			const raw = fs.readFileSync(filePath, "utf-8");
 			const tokens = JSON.parse(raw);
 			for (const [userId, val] of Object.entries(tokens)) {
 				const entry = parsePersistedPeerVal(val);
@@ -104,7 +104,7 @@ function clearContextTokensForAccount(accountId) {
 	for (const k of [...contextTokenStore.keys()]) if (k.startsWith(prefix)) contextTokenStore.delete(k);
 	try {
 		const filePath = canonicalContextTokenFilePath(accountId);
-		if (fsSync.existsSync(filePath)) fsSync.unlinkSync(filePath);
+		if (fs.existsSync(filePath)) fs.unlinkSync(filePath);
 	} catch (err) {
 		logger.warn(`clearContextTokensForAccount: failed to remove context tokens file: ${String(err)}`);
 	}
@@ -114,9 +114,9 @@ function tryHydratePeerEntryFromDisk(accountId, userId) {
 	const peer = normalizeIlinkUserIdForContext(userId);
 	const norm = normalizeWeixinAccountId(accountId);
 	const filePath = canonicalContextTokenFilePath(accountId);
-	if (!fsSync.existsSync(filePath)) return void 0;
+	if (!fs.existsSync(filePath)) return void 0;
 	try {
-		const raw = fsSync.readFileSync(filePath, "utf-8");
+		const raw = fs.readFileSync(filePath, "utf-8");
 		const tokens = JSON.parse(raw);
 		for (const [jsonKey, val] of Object.entries(tokens)) {
 			const entry = parsePersistedPeerVal(val);
@@ -198,11 +198,11 @@ function findContextTokenEntriesByPeer(peerUserId) {
 function tryHydrateAnyAccountContextTokenFromDisk(peerUserId) {
 	const peer = normalizeIlinkUserIdForContext(peerUserId);
 	const accountsDir = path.join(resolveWeixinRootDir(), "accounts");
-	if (!fsSync.existsSync(accountsDir)) return void 0;
+	if (!fs.existsSync(accountsDir)) return void 0;
 	const hits = [];
 	let names;
 	try {
-		names = fsSync.readdirSync(accountsDir);
+		names = fs.readdirSync(accountsDir);
 	} catch {
 		return;
 	}
@@ -212,7 +212,7 @@ function tryHydrateAnyAccountContextTokenFromDisk(peerUserId) {
 		const accountFromFile = name.slice(0, -20);
 		const filePath = path.join(accountsDir, name);
 		try {
-			const raw = fsSync.readFileSync(filePath, "utf-8");
+			const raw = fs.readFileSync(filePath, "utf-8");
 			const tokens = JSON.parse(raw);
 			for (const [jsonKey, val] of Object.entries(tokens)) {
 				const entry = parsePersistedPeerVal(val);