@kodelyth/matrix 2026.5.42 → 2026.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (205) hide show
  1. package/klaw.plugin.json +891 -3
  2. package/package.json +18 -6
  3. package/CHANGELOG.md +0 -321
  4. package/SPEC-SUPPORT.md +0 -116
  5. package/api.ts +0 -38
  6. package/auth-presence.ts +0 -56
  7. package/channel-plugin-api.ts +0 -3
  8. package/cli-metadata.ts +0 -11
  9. package/contract-api.ts +0 -17
  10. package/doctor-contract-api.ts +0 -1
  11. package/helper-api.ts +0 -3
  12. package/index.ts +0 -55
  13. package/plugin-entry.handlers.runtime.ts +0 -1
  14. package/runtime-api.ts +0 -72
  15. package/runtime-heavy-api.ts +0 -1
  16. package/runtime-setter-api.ts +0 -3
  17. package/secret-contract-api.ts +0 -5
  18. package/setup-entry.ts +0 -17
  19. package/setup-plugin-api.ts +0 -3
  20. package/src/account-selection.ts +0 -223
  21. package/src/actions.ts +0 -346
  22. package/src/approval-auth.ts +0 -25
  23. package/src/approval-handler.runtime.ts +0 -592
  24. package/src/approval-ids.ts +0 -6
  25. package/src/approval-native.ts +0 -345
  26. package/src/approval-reaction-auth.ts +0 -45
  27. package/src/approval-reactions.ts +0 -313
  28. package/src/auth-precedence.ts +0 -61
  29. package/src/channel-account-paths.ts +0 -97
  30. package/src/channel.runtime.ts +0 -17
  31. package/src/channel.setup.ts +0 -48
  32. package/src/channel.ts +0 -667
  33. package/src/cli-metadata.ts +0 -19
  34. package/src/cli.ts +0 -2298
  35. package/src/config-adapter.ts +0 -41
  36. package/src/config-schema.ts +0 -159
  37. package/src/config-ui-hints.ts +0 -56
  38. package/src/directory-live.ts +0 -238
  39. package/src/doctor-contract.ts +0 -287
  40. package/src/doctor.ts +0 -262
  41. package/src/env-vars.ts +0 -92
  42. package/src/exec-approval-resolver.ts +0 -23
  43. package/src/exec-approvals.ts +0 -287
  44. package/src/group-mentions.ts +0 -41
  45. package/src/legacy-crypto-inspector-availability.ts +0 -60
  46. package/src/legacy-crypto.ts +0 -531
  47. package/src/legacy-state.ts +0 -156
  48. package/src/matrix/account-config.ts +0 -175
  49. package/src/matrix/accounts.ts +0 -194
  50. package/src/matrix/actions/client.ts +0 -31
  51. package/src/matrix/actions/devices.ts +0 -34
  52. package/src/matrix/actions/limits.ts +0 -6
  53. package/src/matrix/actions/messages.ts +0 -129
  54. package/src/matrix/actions/pins.ts +0 -63
  55. package/src/matrix/actions/polls.ts +0 -109
  56. package/src/matrix/actions/profile.ts +0 -37
  57. package/src/matrix/actions/reactions.ts +0 -59
  58. package/src/matrix/actions/room.ts +0 -71
  59. package/src/matrix/actions/summary.ts +0 -88
  60. package/src/matrix/actions/types.ts +0 -63
  61. package/src/matrix/actions/verification.ts +0 -589
  62. package/src/matrix/actions.ts +0 -37
  63. package/src/matrix/active-client.ts +0 -26
  64. package/src/matrix/async-lock.ts +0 -18
  65. package/src/matrix/backup-health.ts +0 -124
  66. package/src/matrix/client/config-runtime-api.ts +0 -9
  67. package/src/matrix/client/config-secret-input.runtime.ts +0 -1
  68. package/src/matrix/client/config.ts +0 -853
  69. package/src/matrix/client/create-client.ts +0 -105
  70. package/src/matrix/client/env-auth.ts +0 -95
  71. package/src/matrix/client/file-sync-store.ts +0 -289
  72. package/src/matrix/client/logging.ts +0 -140
  73. package/src/matrix/client/migration-snapshot.runtime.ts +0 -1
  74. package/src/matrix/client/private-network-host.ts +0 -1
  75. package/src/matrix/client/runtime.ts +0 -4
  76. package/src/matrix/client/shared.ts +0 -316
  77. package/src/matrix/client/storage.ts +0 -543
  78. package/src/matrix/client/types.ts +0 -50
  79. package/src/matrix/client/url-validation.ts +0 -73
  80. package/src/matrix/client-bootstrap.ts +0 -173
  81. package/src/matrix/client.ts +0 -23
  82. package/src/matrix/config-paths.ts +0 -31
  83. package/src/matrix/config-update.ts +0 -292
  84. package/src/matrix/credentials-read.ts +0 -208
  85. package/src/matrix/credentials-write.runtime.ts +0 -35
  86. package/src/matrix/credentials.ts +0 -95
  87. package/src/matrix/deps.ts +0 -309
  88. package/src/matrix/device-health.ts +0 -29
  89. package/src/matrix/direct-management.ts +0 -349
  90. package/src/matrix/direct-room.ts +0 -128
  91. package/src/matrix/draft-stream.ts +0 -225
  92. package/src/matrix/encryption-guidance.ts +0 -24
  93. package/src/matrix/errors.ts +0 -21
  94. package/src/matrix/format.ts +0 -426
  95. package/src/matrix/legacy-crypto-inspector.ts +0 -95
  96. package/src/matrix/media-errors.ts +0 -20
  97. package/src/matrix/media-text.ts +0 -162
  98. package/src/matrix/monitor/access-state.ts +0 -145
  99. package/src/matrix/monitor/ack-config.ts +0 -27
  100. package/src/matrix/monitor/allowlist.ts +0 -89
  101. package/src/matrix/monitor/auto-join.ts +0 -86
  102. package/src/matrix/monitor/config.ts +0 -569
  103. package/src/matrix/monitor/context-summary.ts +0 -43
  104. package/src/matrix/monitor/direct.ts +0 -296
  105. package/src/matrix/monitor/events.ts +0 -397
  106. package/src/matrix/monitor/handler.ts +0 -2266
  107. package/src/matrix/monitor/inbound-dedupe.ts +0 -267
  108. package/src/matrix/monitor/index.ts +0 -540
  109. package/src/matrix/monitor/legacy-crypto-restore.ts +0 -139
  110. package/src/matrix/monitor/location.ts +0 -108
  111. package/src/matrix/monitor/media.ts +0 -119
  112. package/src/matrix/monitor/mentions.ts +0 -256
  113. package/src/matrix/monitor/reaction-events.ts +0 -197
  114. package/src/matrix/monitor/recent-invite.ts +0 -30
  115. package/src/matrix/monitor/replies.ts +0 -136
  116. package/src/matrix/monitor/reply-context.ts +0 -92
  117. package/src/matrix/monitor/room-history.ts +0 -301
  118. package/src/matrix/monitor/room-info.ts +0 -126
  119. package/src/matrix/monitor/rooms.ts +0 -52
  120. package/src/matrix/monitor/route.ts +0 -179
  121. package/src/matrix/monitor/runtime-api.ts +0 -28
  122. package/src/matrix/monitor/startup-verification.ts +0 -237
  123. package/src/matrix/monitor/startup.ts +0 -218
  124. package/src/matrix/monitor/status.ts +0 -120
  125. package/src/matrix/monitor/sync-lifecycle.ts +0 -91
  126. package/src/matrix/monitor/task-runner.ts +0 -38
  127. package/src/matrix/monitor/test-events.ts +0 -21
  128. package/src/matrix/monitor/thread-context.ts +0 -108
  129. package/src/matrix/monitor/threads.ts +0 -85
  130. package/src/matrix/monitor/types.ts +0 -30
  131. package/src/matrix/monitor/verification-events.ts +0 -643
  132. package/src/matrix/monitor/verification-utils.ts +0 -46
  133. package/src/matrix/outbound-media-runtime.ts +0 -1
  134. package/src/matrix/poll-summary.ts +0 -110
  135. package/src/matrix/poll-types.ts +0 -429
  136. package/src/matrix/probe.runtime.ts +0 -4
  137. package/src/matrix/probe.ts +0 -97
  138. package/src/matrix/profile.ts +0 -184
  139. package/src/matrix/reaction-common.ts +0 -147
  140. package/src/matrix/sdk/crypto-bootstrap.ts +0 -438
  141. package/src/matrix/sdk/crypto-facade.ts +0 -242
  142. package/src/matrix/sdk/crypto-node.runtime.ts +0 -17
  143. package/src/matrix/sdk/crypto-runtime.ts +0 -14
  144. package/src/matrix/sdk/decrypt-bridge.ts +0 -410
  145. package/src/matrix/sdk/event-helpers.ts +0 -83
  146. package/src/matrix/sdk/http-client.ts +0 -87
  147. package/src/matrix/sdk/idb-persistence-lock.ts +0 -51
  148. package/src/matrix/sdk/idb-persistence.ts +0 -288
  149. package/src/matrix/sdk/logger.ts +0 -108
  150. package/src/matrix/sdk/read-response-with-limit.ts +0 -19
  151. package/src/matrix/sdk/recovery-key-store.ts +0 -453
  152. package/src/matrix/sdk/timeout-abort-signal.ts +0 -1
  153. package/src/matrix/sdk/transport-runtime-api.ts +0 -18
  154. package/src/matrix/sdk/transport.ts +0 -352
  155. package/src/matrix/sdk/types.ts +0 -245
  156. package/src/matrix/sdk/verification-manager.ts +0 -795
  157. package/src/matrix/sdk/verification-status.ts +0 -23
  158. package/src/matrix/sdk.ts +0 -2152
  159. package/src/matrix/send/client.ts +0 -93
  160. package/src/matrix/send/formatting.ts +0 -189
  161. package/src/matrix/send/media.ts +0 -244
  162. package/src/matrix/send/targets.ts +0 -104
  163. package/src/matrix/send/types.ts +0 -131
  164. package/src/matrix/send.ts +0 -660
  165. package/src/matrix/session-store-metadata.ts +0 -108
  166. package/src/matrix/startup-abort.ts +0 -44
  167. package/src/matrix/subagent-hooks.ts +0 -308
  168. package/src/matrix/sync-state.ts +0 -27
  169. package/src/matrix/target-ids.ts +0 -79
  170. package/src/matrix/thread-bindings-shared.ts +0 -206
  171. package/src/matrix/thread-bindings.ts +0 -580
  172. package/src/matrix-migration.runtime.ts +0 -9
  173. package/src/migration-config.ts +0 -243
  174. package/src/migration-snapshot-backup.ts +0 -116
  175. package/src/migration-snapshot.ts +0 -53
  176. package/src/onboarding.ts +0 -775
  177. package/src/outbound.ts +0 -248
  178. package/src/plugin-entry.runtime.js +0 -115
  179. package/src/plugin-entry.runtime.ts +0 -70
  180. package/src/profile-update.ts +0 -71
  181. package/src/record-shared.ts +0 -3
  182. package/src/resolve-targets.ts +0 -175
  183. package/src/resolver.runtime.ts +0 -5
  184. package/src/resolver.ts +0 -21
  185. package/src/runtime-api.ts +0 -106
  186. package/src/runtime.ts +0 -13
  187. package/src/secret-contract.ts +0 -174
  188. package/src/session-route.ts +0 -126
  189. package/src/setup-bootstrap.ts +0 -102
  190. package/src/setup-config.ts +0 -222
  191. package/src/setup-contract.ts +0 -90
  192. package/src/setup-core.ts +0 -146
  193. package/src/setup-dm-policy.ts +0 -15
  194. package/src/setup-surface.ts +0 -4
  195. package/src/startup-maintenance.ts +0 -114
  196. package/src/storage-paths.ts +0 -92
  197. package/src/thread-binding-api.ts +0 -23
  198. package/src/tool-actions.runtime.ts +0 -1
  199. package/src/tool-actions.ts +0 -498
  200. package/src/types.ts +0 -257
  201. package/subagent-hooks-api.ts +0 -31
  202. package/test-api.ts +0 -21
  203. package/thread-binding-api.ts +0 -4
  204. package/thread-bindings-runtime.ts +0 -4
  205. package/tsconfig.json +0 -16
@@ -1,61 +0,0 @@
1
- import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "klaw/plugin-sdk/account-id";
2
-
3
- export type MatrixResolvedStringField =
4
- | "homeserver"
5
- | "userId"
6
- | "accessToken"
7
- | "password"
8
- | "deviceId"
9
- | "deviceName";
10
-
11
- export type MatrixResolvedStringValues = Record<MatrixResolvedStringField, string>;
12
-
13
- type MatrixStringSourceMap = Partial<Record<MatrixResolvedStringField, string>>;
14
-
15
- const MATRIX_DEFAULT_ACCOUNT_AUTH_ONLY_FIELDS = new Set<MatrixResolvedStringField>([
16
- "userId",
17
- "accessToken",
18
- "password",
19
- "deviceId",
20
- ]);
21
-
22
- function resolveMatrixStringSourceValue(value: string | undefined): string {
23
- return typeof value === "string" ? value : "";
24
- }
25
-
26
- function shouldAllowBaseAuthFallback(accountId: string, field: MatrixResolvedStringField): boolean {
27
- return (
28
- normalizeAccountId(accountId) === DEFAULT_ACCOUNT_ID ||
29
- !MATRIX_DEFAULT_ACCOUNT_AUTH_ONLY_FIELDS.has(field)
30
- );
31
- }
32
-
33
- export function resolveMatrixAccountStringValues(params: {
34
- accountId: string;
35
- account?: MatrixStringSourceMap;
36
- scopedEnv?: MatrixStringSourceMap;
37
- channel?: MatrixStringSourceMap;
38
- globalEnv?: MatrixStringSourceMap;
39
- }): MatrixResolvedStringValues {
40
- const fields: MatrixResolvedStringField[] = [
41
- "homeserver",
42
- "userId",
43
- "accessToken",
44
- "password",
45
- "deviceId",
46
- "deviceName",
47
- ];
48
- const resolved = {} as MatrixResolvedStringValues;
49
-
50
- for (const field of fields) {
51
- resolved[field] =
52
- resolveMatrixStringSourceValue(params.account?.[field]) ||
53
- resolveMatrixStringSourceValue(params.scopedEnv?.[field]) ||
54
- (shouldAllowBaseAuthFallback(params.accountId, field)
55
- ? resolveMatrixStringSourceValue(params.channel?.[field]) ||
56
- resolveMatrixStringSourceValue(params.globalEnv?.[field])
57
- : "");
58
- }
59
-
60
- return resolved;
61
- }
@@ -1,97 +0,0 @@
1
- import { createPairingPrefixStripper } from "klaw/plugin-sdk/channel-pairing";
2
- import { PAIRING_APPROVED_MESSAGE } from "klaw/plugin-sdk/channel-status";
3
- import type { PinnedDispatcherPolicy, SsrFPolicy } from "klaw/plugin-sdk/ssrf-dispatcher";
4
- import { formatMatrixErrorMessage } from "./matrix/errors.js";
5
- import type { MatrixProbe } from "./matrix/probe.js";
6
- import type { CoreConfig } from "./types.js";
7
-
8
- type ResolveMatrixAuth = (params: { cfg: CoreConfig; accountId?: string }) => Promise<{
9
- homeserver: string;
10
- accessToken: string;
11
- userId: string;
12
- deviceId?: string;
13
- allowPrivateNetwork?: boolean;
14
- ssrfPolicy?: SsrFPolicy;
15
- dispatcherPolicy?: PinnedDispatcherPolicy;
16
- }>;
17
-
18
- type ProbeMatrix = (params: {
19
- homeserver: string;
20
- accessToken: string;
21
- userId: string;
22
- deviceId?: string;
23
- timeoutMs: number;
24
- accountId?: string;
25
- allowPrivateNetwork?: boolean;
26
- ssrfPolicy?: SsrFPolicy;
27
- dispatcherPolicy?: PinnedDispatcherPolicy;
28
- }) => Promise<MatrixProbe>;
29
-
30
- type SendMessageMatrix = (
31
- to: string,
32
- message: string,
33
- options: { cfg: CoreConfig; accountId?: string },
34
- ) => Promise<unknown>;
35
-
36
- export function createMatrixProbeAccount(params: {
37
- resolveMatrixAuth: ResolveMatrixAuth;
38
- probeMatrix: ProbeMatrix;
39
- }) {
40
- return async ({
41
- account,
42
- timeoutMs,
43
- cfg,
44
- }: {
45
- account: { accountId?: string };
46
- timeoutMs?: number;
47
- cfg: unknown;
48
- }): Promise<MatrixProbe> => {
49
- try {
50
- const auth = await params.resolveMatrixAuth({
51
- cfg: cfg as CoreConfig,
52
- accountId: account.accountId,
53
- });
54
- return await params.probeMatrix({
55
- homeserver: auth.homeserver,
56
- accessToken: auth.accessToken,
57
- userId: auth.userId,
58
- deviceId: auth.deviceId,
59
- timeoutMs: timeoutMs ?? 5_000,
60
- accountId: account.accountId,
61
- allowPrivateNetwork: auth.allowPrivateNetwork,
62
- ssrfPolicy: auth.ssrfPolicy,
63
- dispatcherPolicy: auth.dispatcherPolicy,
64
- });
65
- } catch (err) {
66
- return {
67
- ok: false,
68
- error: formatMatrixErrorMessage(err),
69
- elapsedMs: 0,
70
- };
71
- }
72
- };
73
- }
74
-
75
- export function createMatrixPairingText(sendMessageMatrix: SendMessageMatrix) {
76
- return {
77
- idLabel: "matrixUserId",
78
- message: PAIRING_APPROVED_MESSAGE,
79
- normalizeAllowEntry: createPairingPrefixStripper(/^matrix:/i),
80
- notify: async ({
81
- id,
82
- message,
83
- cfg,
84
- accountId,
85
- }: {
86
- id: string;
87
- message: string;
88
- cfg: CoreConfig;
89
- accountId?: string;
90
- }) => {
91
- await sendMessageMatrix(`user:${id}`, message, {
92
- cfg,
93
- ...(accountId ? { accountId } : {}),
94
- });
95
- },
96
- };
97
- }
@@ -1,17 +0,0 @@
1
- import { listMatrixDirectoryGroupsLive, listMatrixDirectoryPeersLive } from "./directory-live.js";
2
- import { resolveMatrixAuth } from "./matrix/client.js";
3
- import { probeMatrix } from "./matrix/probe.js";
4
- import { sendMessageMatrix, sendTypingMatrix } from "./matrix/send.js";
5
- import { matrixOutbound } from "./outbound.js";
6
- import { resolveMatrixTargets } from "./resolve-targets.js";
7
-
8
- export const matrixChannelRuntime = {
9
- listMatrixDirectoryGroupsLive,
10
- listMatrixDirectoryPeersLive,
11
- matrixOutbound,
12
- probeMatrix,
13
- resolveMatrixAuth,
14
- resolveMatrixTargets,
15
- sendMessageMatrix,
16
- sendTypingMatrix,
17
- };
@@ -1,48 +0,0 @@
1
- import { describeAccountSnapshot } from "klaw/plugin-sdk/account-helpers";
2
- import type { ChannelPlugin } from "klaw/plugin-sdk/channel-core";
3
- import { matrixConfigAdapter } from "./config-adapter.js";
4
- import { MatrixChannelConfigSchema } from "./config-schema.js";
5
- import { resolveMatrixAccount, type ResolvedMatrixAccount } from "./matrix/accounts.js";
6
- import { createMatrixSetupWizardProxy, matrixSetupAdapter } from "./setup-core.js";
7
-
8
- const matrixSetupWizard = createMatrixSetupWizardProxy(async () => ({
9
- matrixSetupWizard: (await import("./setup-surface.js")).matrixSetupWizard,
10
- }));
11
-
12
- export const matrixSetupPlugin: ChannelPlugin<ResolvedMatrixAccount> = {
13
- id: "matrix",
14
- meta: {
15
- id: "matrix",
16
- label: "Matrix",
17
- selectionLabel: "Matrix (plugin)",
18
- docsPath: "/channels/matrix",
19
- docsLabel: "matrix",
20
- blurb: "open protocol; configure a homeserver + access token.",
21
- order: 70,
22
- quickstartAllowFrom: true,
23
- },
24
- setupWizard: matrixSetupWizard,
25
- setup: matrixSetupAdapter,
26
- capabilities: {
27
- chatTypes: ["direct", "group", "thread"],
28
- polls: true,
29
- reactions: true,
30
- threads: true,
31
- media: true,
32
- },
33
- reload: { configPrefixes: ["channels.matrix"] },
34
- configSchema: MatrixChannelConfigSchema,
35
- config: {
36
- ...matrixConfigAdapter,
37
- isConfigured: (account) => account.configured,
38
- describeAccount: (account) =>
39
- describeAccountSnapshot({
40
- account,
41
- configured: account.configured,
42
- extra: {
43
- baseUrl: account.homeserver,
44
- },
45
- }),
46
- hasConfiguredState: ({ cfg }) => resolveMatrixAccount({ cfg }).configured,
47
- },
48
- };