});

it("shares managers between ESM and alternate-loaded module instances", async () => {

const viaJiti = await loadThreadBindingsViaAlternateLoader();

const viaAlternateLoader = await loadThreadBindingsViaAlternateLoader();

createThreadBindingManager({

cfg: EMPTY_DISCORD_TEST_CONFIG,

});

expect(getThreadBindingManager("work")).not.toBeNull();

expect(viaJiti.getThreadBindingManager("work")).not.toBeNull();

expect(viaAlternateLoader.getThreadBindingManager("work")).not.toBeNull();

});

});

lastPersistedAtMs: number;

};

// Plugin hooks can load this module via Jiti while core imports it via ESM.

// Store mutable state on globalThis so both loader paths share one registry.

// Plugin hooks can load this module through a separate runtime path while core

// imports it via ESM. Store mutable state on globalThis so both paths share one

// registry.

const THREAD_BINDINGS_STATE_KEY = Symbol.for("openclaw.discordThreadBindingsState");

let threadBindingsState: ThreadBindingsGlobalState | undefined;

### Fixes

- Plugins/bundled runtimes: ship bundled plugin runtime sidecars like WhatsApp `light-runtime-api.js`, Matrix `runtime-api.js`, and other plugin runtime entry files in the npm package again, so global installs stop failing on missing bundled plugin runtime surfaces.

- Plugins/Matrix: avoid duplicate `resolveMatrixAccountStringValues` runtime-api exports under Jiti so bundled Matrix installs no longer crash at startup with `Cannot redefine property: resolveMatrixAccountStringValues`. Fixes #52909 and #52891. Thanks @vincentkoc.

- Plugins/Matrix: avoid duplicate `resolveMatrixAccountStringValues` runtime-api exports under source loaders so bundled Matrix installs no longer crash at startup with `Cannot redefine property: resolveMatrixAccountStringValues`. Fixes #52909 and #52891. Thanks @vincentkoc.

## 2026.3.22

);

}, 240_000);

it("does not use Jiti when only a TypeScript Matrix runtime shim exists", async () => {

it("does not load when only a TypeScript Matrix runtime shim exists", async () => {

const fixtureRoot = makeFixtureRoot(".tmp-matrix-runtime-ts-only-");

writeOpenClawPackageFixture(fixtureRoot);

writeSourceRuntimeWrapperFixture(fixtureRoot, { runtimeExtension: ".ts" });

writeFixtureFile(

fixtureRoot,

"node_modules/jiti/index.js",

"throw new Error('matrix wrapper must not require jiti');\n",

);

await expect(

importFixtureModule(fixtureRoot, "extensions/matrix/src/plugin-entry.runtime.js"),

import path from "node:path";

import { loadRuntimeApiExportTypesViaJiti } from "openclaw/plugin-sdk/plugin-test-contracts";

import { runDirectImportSmoke } from "openclaw/plugin-sdk/plugin-test-contracts";

import { describe, expect, it } from "vitest";

describe("zalo runtime api", () => {

it("loads the narrow runtime api without reentering setup surfaces", () => {

const runtimeApiPath = path.join(process.cwd(), "extensions", "zalo", "runtime-api.ts");

it("loads the narrow runtime api without reentering setup surfaces", async () => {

const stdout = await runDirectImportSmoke(

`const runtime = await import("./extensions/zalo/runtime-api.ts");

process.stdout.write(JSON.stringify({

hasZaloPlugin: Object.hasOwn(runtime, "zaloPlugin"),

hasZaloSetupWizard: Object.hasOwn(runtime, "zaloSetupWizard"),

type: typeof runtime.setZaloRuntime,

}));`,

);

expect(

loadRuntimeApiExportTypesViaJiti({

modulePath: runtimeApiPath,

exportNames: ["setZaloRuntime"],

realPluginSdkSpecifiers: ["openclaw/plugin-sdk/runtime-store"],

}),

).toEqual({

setZaloRuntime: "function",

});

});

expect(stdout).toBe('{"hasZaloPlugin":false,"hasZaloSetupWizard":false,"type":"function"}');

}, 45_000);

});

"test/helpers/plugins/contracts-testkit.ts",

"test/helpers/plugins/direct-smoke.ts",

"test/helpers/plugins/directory.ts",

"test/helpers/plugins/jiti-runtime-api.ts",

"test/helpers/plugins/onboard-config.ts",

"test/helpers/plugins/outbound-delivery.ts",

"test/helpers/plugins/package-manifest-contract.ts",

uniqueSortedStrings,

} from "./test-helpers/contracts-testkit.js";

export { runDirectImportSmoke } from "./test-helpers/direct-smoke.js";

export { loadRuntimeApiExportTypesViaJiti } from "./test-helpers/jiti-runtime-api.js";

export { describePackageManifestContract } from "./test-helpers/package-manifest-contract.js";

export { pluginRegistrationContractCases } from "./test-helpers/plugin-registration-contract-cases.js";

export { describePluginRegistrationContract } from "./test-helpers/plugin-registration-contract.js";