@pixelbyte-software/pixcode 1.54.9 → 1.54.11

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 (288) hide show
  1. package/CODE_OF_CONDUCT.md +41 -41
  2. package/CONTRIBUTING.md +156 -156
  3. package/LICENSE +21 -718
  4. package/README.de.md +169 -169
  5. package/README.ja.md +167 -167
  6. package/README.ko.md +167 -167
  7. package/README.md +435 -418
  8. package/README.ru.md +169 -169
  9. package/README.tr.md +298 -298
  10. package/README.zh-CN.md +167 -167
  11. package/SECURITY.md +46 -46
  12. package/dist/api-automation.html +110 -110
  13. package/dist/api-docs.html +548 -548
  14. package/dist/assets/{index-Bm6uAqKU.js → index-Bcqs_1vc.js} +114 -114
  15. package/dist/clear-cache.html +85 -85
  16. package/dist/convert-icons.md +52 -52
  17. package/dist/docs.html +308 -308
  18. package/dist/features.html +133 -133
  19. package/dist/generate-icons.js +48 -48
  20. package/dist/humans.txt +15 -15
  21. package/dist/icons/codex-white.svg +3 -3
  22. package/dist/icons/codex.svg +3 -3
  23. package/dist/icons/cursor-white.svg +11 -11
  24. package/dist/icons/qwen-logo.svg +14 -14
  25. package/dist/index.html +58 -58
  26. package/dist/landing.html +268 -268
  27. package/dist/llms-full.txt +119 -119
  28. package/dist/llms.txt +53 -53
  29. package/dist/manifest.json +60 -60
  30. package/dist/openapi.yaml +1696 -1696
  31. package/dist/orchestration.html +125 -125
  32. package/dist/robots.txt +4 -4
  33. package/dist/site.css +692 -692
  34. package/dist/sitemap.xml +51 -51
  35. package/dist/sw.js +132 -132
  36. package/dist-server/server/cli.js +100 -100
  37. package/dist-server/server/daemon/manager.js +33 -33
  38. package/dist-server/server/daemon-manager.js +64 -64
  39. package/dist-server/server/index.js +13 -0
  40. package/dist-server/server/index.js.map +1 -1
  41. package/dist-server/server/routes/agent.js +10 -1
  42. package/dist-server/server/routes/agent.js.map +1 -1
  43. package/dist-server/server/routes/commands.js +25 -25
  44. package/dist-server/server/routes/git.js +17 -17
  45. package/dist-server/server/routes/live-view.js +46 -46
  46. package/dist-server/server/services/public-api-manifest.js +51 -51
  47. package/dist-server/server/sessionManager.js +5 -5
  48. package/dist-server/server/sessionManager.js.map +1 -1
  49. package/package.json +224 -224
  50. package/scripts/fix-node-pty.js +67 -67
  51. package/scripts/github/create-v1.38-issues.mjs +351 -351
  52. package/scripts/github/create-vscode-workbench-issues.mjs +121 -121
  53. package/scripts/smoke/backend-resource-bounds.mjs +152 -152
  54. package/scripts/smoke/changes-panel-layout.mjs +48 -48
  55. package/scripts/smoke/chat-composer-fixed-layout.mjs +55 -55
  56. package/scripts/smoke/chat-message-timeline-order.mjs +41 -41
  57. package/scripts/smoke/chat-realtime-hydration.mjs +44 -44
  58. package/scripts/smoke/chat-session-provider-pools.mjs +35 -35
  59. package/scripts/smoke/chat-session-state.mjs +19 -19
  60. package/scripts/smoke/code-editor-theme.mjs +55 -55
  61. package/scripts/smoke/code-editor-vscode-engine.mjs +91 -91
  62. package/scripts/smoke/command-center-agent-writes.mjs +79 -79
  63. package/scripts/smoke/command-center-non-git.mjs +46 -46
  64. package/scripts/smoke/context-packet.mjs +43 -43
  65. package/scripts/smoke/control-room-ux-redesign.mjs +91 -91
  66. package/scripts/smoke/daemon-entrypoint.mjs +20 -20
  67. package/scripts/smoke/default-landing-routing.mjs +33 -33
  68. package/scripts/smoke/desktop-native-notifications.mjs +30 -30
  69. package/scripts/smoke/desktop-tray-icon.mjs +33 -33
  70. package/scripts/smoke/discord-release-workflow.mjs +24 -24
  71. package/scripts/smoke/git-install-update.mjs +255 -255
  72. package/scripts/smoke/handoff-artifact-protocol.mjs +50 -50
  73. package/scripts/smoke/live-view-diagnostics.mjs +53 -53
  74. package/scripts/smoke/live-view-environment.mjs +92 -92
  75. package/scripts/smoke/live-view-integration.mjs +450 -450
  76. package/scripts/smoke/mac-desktop-runtime.mjs +37 -37
  77. package/scripts/smoke/mobile-tunnel-guidance.mjs +29 -29
  78. package/scripts/smoke/mobile-ux.mjs +76 -76
  79. package/scripts/smoke/model-registry.mjs +36 -36
  80. package/scripts/smoke/multi-project-ui.mjs +45 -45
  81. package/scripts/smoke/multi-worker-slots.mjs +42 -42
  82. package/scripts/smoke/notification-center.mjs +87 -87
  83. package/scripts/smoke/notification-inapp-preference.mjs +23 -23
  84. package/scripts/smoke/notification-taxonomy.mjs +58 -58
  85. package/scripts/smoke/orchestration-api.mjs +172 -172
  86. package/scripts/smoke/orchestration-execution-dashboard.mjs +33 -33
  87. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  88. package/scripts/smoke/orchestration-mobile-scroll.mjs +29 -29
  89. package/scripts/smoke/orchestration-model-sync.mjs +30 -30
  90. package/scripts/smoke/orchestration-permission-fallback.mjs +34 -34
  91. package/scripts/smoke/orchestration-runtime-guards.mjs +48 -48
  92. package/scripts/smoke/orchestration-user-facing-output.mjs +25 -25
  93. package/scripts/smoke/permission-policy.mjs +50 -50
  94. package/scripts/smoke/pixcode-workbench-1-48.mjs +167 -167
  95. package/scripts/smoke/provider-models-opencode-live.mjs +66 -66
  96. package/scripts/smoke/provider-rest-api.mjs +124 -124
  97. package/scripts/smoke/provider-selection-status.mjs +52 -52
  98. package/scripts/smoke/run-state-refresh.mjs +52 -52
  99. package/scripts/smoke/runtime-manager.mjs +99 -99
  100. package/scripts/smoke/shell-manual-disconnect.mjs +30 -30
  101. package/scripts/smoke/side-panel-editor-layout.mjs +34 -34
  102. package/scripts/smoke/static-root-routing.mjs +21 -21
  103. package/scripts/smoke/strict-handoff-compact.mjs +60 -60
  104. package/scripts/smoke/taskmaster-config.mjs +24 -24
  105. package/scripts/smoke/taskmaster-execution-telegram.mjs +3 -3
  106. package/scripts/smoke/taskmaster-onboarding.mjs +3 -3
  107. package/scripts/smoke/taskmaster-run-graph.mjs +3 -3
  108. package/scripts/smoke/telegram-control.mjs +331 -331
  109. package/scripts/smoke/tunnel-persistence.mjs +56 -56
  110. package/scripts/smoke/update-issue-progress.mjs +69 -69
  111. package/scripts/smoke/update-ux.mjs +55 -55
  112. package/scripts/smoke/v138-completion.mjs +132 -132
  113. package/scripts/smoke/v138-desktop-release-hardening.mjs +69 -69
  114. package/scripts/smoke/v138-diagnostics.mjs +63 -63
  115. package/scripts/smoke/v138-issue-planner.mjs +33 -33
  116. package/scripts/smoke/v143-remote-control.mjs +76 -76
  117. package/scripts/smoke/v144-production-loop.mjs +47 -47
  118. package/scripts/smoke/v145-platformization.mjs +46 -46
  119. package/scripts/smoke/v146-control-room-ui.mjs +150 -150
  120. package/scripts/smoke/version-modal-autoshow.mjs +29 -29
  121. package/scripts/smoke/vscode-workbench-layout.mjs +63 -63
  122. package/scripts/smoke/vscode-workbench-polish.mjs +461 -461
  123. package/scripts/smoke/workflow-fallback-replay.mjs +56 -56
  124. package/scripts/smoke/workflow-templates.mjs +43 -43
  125. package/scripts/smoke/workflow-trace-timeline.mjs +46 -46
  126. package/scripts/update-git-install.mjs +298 -298
  127. package/server/claude-sdk.js +927 -927
  128. package/server/cli.js +1106 -1106
  129. package/server/constants/config.js +4 -4
  130. package/server/cursor-cli.js +344 -344
  131. package/server/daemon/manager.js +563 -563
  132. package/server/daemon-manager.js +964 -964
  133. package/server/database/db.js +988 -988
  134. package/server/database/json-store.js +197 -197
  135. package/server/gemini-cli.js +550 -550
  136. package/server/gemini-response-handler.js +79 -79
  137. package/server/index.js +5671 -5659
  138. package/server/load-env.js +35 -35
  139. package/server/middleware/account-lockout.js +112 -112
  140. package/server/middleware/auth.js +277 -277
  141. package/server/middleware/rate-limiter.js +87 -87
  142. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  143. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +63 -63
  144. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +286 -286
  145. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  146. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  147. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  148. package/server/modules/orchestration/a2a/adapters/json-event.adapter.test.ts +60 -60
  149. package/server/modules/orchestration/a2a/adapters/json-event.adapter.ts +101 -101
  150. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  151. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  152. package/server/modules/orchestration/a2a/agent-card.ts +55 -55
  153. package/server/modules/orchestration/a2a/auth.middleware.ts +29 -29
  154. package/server/modules/orchestration/a2a/bus.ts +46 -46
  155. package/server/modules/orchestration/a2a/routes.ts +586 -586
  156. package/server/modules/orchestration/a2a/task-dispatcher.ts +345 -345
  157. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  158. package/server/modules/orchestration/a2a/types.ts +126 -126
  159. package/server/modules/orchestration/a2a/validator.ts +113 -113
  160. package/server/modules/orchestration/index.ts +99 -99
  161. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  162. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  163. package/server/modules/orchestration/preview/types.ts +19 -19
  164. package/server/modules/orchestration/security/permission-policy.ts +401 -401
  165. package/server/modules/orchestration/tasks/orchestration-task-store.ts +41 -41
  166. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +81 -81
  167. package/server/modules/orchestration/tasks/orchestration-task.service.ts +201 -201
  168. package/server/modules/orchestration/tasks/orchestration-task.types.ts +40 -40
  169. package/server/modules/orchestration/tasks/task-run-graph.ts +155 -155
  170. package/server/modules/orchestration/workflows/approval-queue.ts +106 -106
  171. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  172. package/server/modules/orchestration/workflows/context-packet.ts +186 -186
  173. package/server/modules/orchestration/workflows/handoff-artifact.ts +175 -175
  174. package/server/modules/orchestration/workflows/workflow-fallback-policy.ts +161 -161
  175. package/server/modules/orchestration/workflows/workflow-replay.ts +254 -254
  176. package/server/modules/orchestration/workflows/workflow-runner.ts +2062 -2062
  177. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  178. package/server/modules/orchestration/workflows/workflow-templates.ts +272 -272
  179. package/server/modules/orchestration/workflows/workflow-trace.ts +424 -424
  180. package/server/modules/orchestration/workflows/workflow.routes.ts +586 -586
  181. package/server/modules/orchestration/workflows/workflow.types.ts +111 -111
  182. package/server/modules/orchestration/workflows/workspace-target.ts +122 -122
  183. package/server/modules/orchestration/workspace/docker-workspace.ts +136 -136
  184. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  185. package/server/modules/orchestration/workspace/types.ts +52 -52
  186. package/server/modules/orchestration/workspace/workspace-manager.ts +102 -102
  187. package/server/modules/orchestration/workspace/worktree-workspace.ts +126 -126
  188. package/server/modules/providers/index.ts +2 -2
  189. package/server/modules/providers/list/claude/claude-auth.provider.ts +146 -146
  190. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  191. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  192. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  193. package/server/modules/providers/list/codex/codex-auth.provider.ts +117 -117
  194. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  195. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  196. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  197. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +147 -147
  198. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  199. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  200. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  201. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +173 -173
  202. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  203. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  204. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  205. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +131 -131
  206. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +286 -286
  207. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +146 -146
  208. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  209. package/server/modules/providers/provider.registry.ts +40 -40
  210. package/server/modules/providers/provider.routes.ts +982 -982
  211. package/server/modules/providers/services/mcp.service.ts +86 -86
  212. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  213. package/server/modules/providers/services/sessions.service.ts +45 -45
  214. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  215. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  216. package/server/modules/providers/tests/mcp.test.ts +293 -293
  217. package/server/openai-codex.js +468 -468
  218. package/server/opencode-cli.js +491 -491
  219. package/server/opencode-response-handler.js +111 -111
  220. package/server/projects.js +3135 -3135
  221. package/server/qwen-code-cli.js +410 -410
  222. package/server/routes/agent.js +1462 -1451
  223. package/server/routes/auth.js +298 -298
  224. package/server/routes/codex.js +20 -20
  225. package/server/routes/commands.js +581 -581
  226. package/server/routes/cursor.js +61 -61
  227. package/server/routes/diagnostics.js +44 -44
  228. package/server/routes/gemini.js +25 -25
  229. package/server/routes/git.js +1822 -1822
  230. package/server/routes/live-view.js +434 -434
  231. package/server/routes/mcp-utils.js +13 -13
  232. package/server/routes/messages.js +97 -97
  233. package/server/routes/network.js +143 -143
  234. package/server/routes/platformization.js +231 -231
  235. package/server/routes/plugins.js +690 -690
  236. package/server/routes/production-agent-loop.js +90 -90
  237. package/server/routes/projects.js +918 -918
  238. package/server/routes/public-api.js +34 -34
  239. package/server/routes/qwen.js +27 -27
  240. package/server/routes/remote.js +56 -56
  241. package/server/routes/settings.js +321 -321
  242. package/server/routes/telegram.js +163 -163
  243. package/server/routes/user.js +125 -125
  244. package/server/routes/webhooks.js +63 -63
  245. package/server/services/control-room.js +102 -102
  246. package/server/services/diagnostics.js +165 -165
  247. package/server/services/external-access.js +403 -403
  248. package/server/services/install-jobs.js +715 -715
  249. package/server/services/live-view.js +956 -956
  250. package/server/services/managed-runtimes.js +493 -493
  251. package/server/services/model-registry.js +144 -144
  252. package/server/services/notification-orchestrator.js +365 -365
  253. package/server/services/notification-taxonomy.js +204 -204
  254. package/server/services/platformization.js +1052 -1052
  255. package/server/services/production-agent-loop.js +248 -248
  256. package/server/services/provider-cli-versions.js +149 -149
  257. package/server/services/provider-credentials.js +189 -189
  258. package/server/services/provider-models.js +396 -396
  259. package/server/services/public-api-manifest.js +181 -181
  260. package/server/services/qr-login.js +126 -126
  261. package/server/services/remote-connection.js +127 -127
  262. package/server/services/runtime-manager.js +323 -323
  263. package/server/services/startup-update.js +259 -259
  264. package/server/services/telegram/bot.js +393 -393
  265. package/server/services/telegram/control-center.js +2453 -2453
  266. package/server/services/telegram/telegram-gateway.js +314 -314
  267. package/server/services/telegram/telegram-http-client.js +201 -201
  268. package/server/services/telegram/translations.js +470 -470
  269. package/server/services/webhooks.js +216 -216
  270. package/server/sessionManager.js +225 -225
  271. package/server/setup-wizard.js +283 -283
  272. package/server/shared/interfaces.ts +54 -54
  273. package/server/shared/types.ts +172 -172
  274. package/server/shared/utils.ts +193 -193
  275. package/server/tsconfig.json +36 -36
  276. package/server/utils/colors.js +21 -21
  277. package/server/utils/commandParser.js +305 -305
  278. package/server/utils/frontmatter.js +18 -18
  279. package/server/utils/gitConfig.js +34 -34
  280. package/server/utils/plugin-loader.js +461 -461
  281. package/server/utils/plugin-process-manager.js +185 -185
  282. package/server/utils/port-access.js +227 -227
  283. package/server/utils/runtime-paths.js +37 -37
  284. package/server/utils/security-log.js +84 -84
  285. package/server/utils/url-detection.js +71 -71
  286. package/server/vite-daemon.js +79 -79
  287. package/shared/modelConstants.js +161 -161
  288. package/shared/networkHosts.js +22 -22
@@ -1,421 +1,421 @@
1
- import crypto from 'node:crypto';
2
- import os from 'node:os';
3
- import path from 'node:path';
4
-
5
- import type { IProviderSessions } from '@/shared/interfaces.js';
6
- import type { AnyRecord, FetchHistoryOptions, FetchHistoryResult, NormalizedMessage } from '@/shared/types.js';
7
- import { createNormalizedMessage, generateMessageId, readObjectRecord } from '@/shared/utils.js';
8
-
9
- const PROVIDER = 'cursor';
10
-
11
- type CursorDbBlob = {
12
- rowid: number;
13
- id: string;
14
- data?: Buffer;
15
- };
16
-
17
- type CursorJsonBlob = CursorDbBlob & {
18
- parsed: AnyRecord;
19
- };
20
-
21
- type CursorMessageBlob = {
22
- id: string;
23
- sequence: number;
24
- rowid: number;
25
- content: AnyRecord;
26
- };
27
-
28
- function sanitizeCursorSessionId(sessionId: string): string {
29
- const normalized = sessionId.trim();
30
- if (!normalized) {
31
- throw new Error('Cursor session id is required.');
32
- }
33
-
34
- if (
35
- normalized.includes('..')
36
- || normalized.includes(path.posix.sep)
37
- || normalized.includes(path.win32.sep)
38
- || normalized !== path.basename(normalized)
39
- ) {
40
- throw new Error(`Invalid cursor session id "${sessionId}".`);
41
- }
42
-
43
- return normalized;
44
- }
45
-
46
- export class CursorSessionsProvider implements IProviderSessions {
47
- /**
48
- * Loads Cursor's SQLite blob DAG and returns message blobs in conversation
49
- * order. Cursor history is stored as content-addressed blobs rather than JSONL.
50
- */
51
- private async loadCursorBlobs(sessionId: string, projectPath: string): Promise<CursorMessageBlob[]> {
52
- // Lazy-import better-sqlite3 so the module doesn't fail if it's unavailable
53
- const { default: Database } = await import('better-sqlite3');
54
-
55
- const cwdId = crypto.createHash('md5').update(projectPath || process.cwd()).digest('hex');
56
- const safeSessionId = sanitizeCursorSessionId(sessionId);
57
- const baseChatsPath = path.join(os.homedir(), '.cursor', 'chats', cwdId);
58
- const storeDbPath = path.join(baseChatsPath, safeSessionId, 'store.db');
59
- const resolvedBaseChatsPath = path.resolve(baseChatsPath);
60
- const resolvedStoreDbPath = path.resolve(storeDbPath);
61
- const relativeStorePath = path.relative(resolvedBaseChatsPath, resolvedStoreDbPath);
62
- if (relativeStorePath.startsWith('..') || path.isAbsolute(relativeStorePath)) {
63
- throw new Error(`Invalid cursor session path for "${sessionId}".`);
64
- }
65
-
66
- const db = new Database(resolvedStoreDbPath, { readonly: true, fileMustExist: true });
67
-
68
- try {
69
- const allBlobs = db.prepare<[], CursorDbBlob>('SELECT rowid, id, data FROM blobs').all();
70
-
71
- const blobMap = new Map<string, CursorDbBlob>();
72
- const parentRefs = new Map<string, string[]>();
73
- const childRefs = new Map<string, string[]>();
74
- const jsonBlobs: CursorJsonBlob[] = [];
75
-
76
- for (const blob of allBlobs) {
77
- blobMap.set(blob.id, blob);
78
-
79
- if (blob.data && blob.data[0] === 0x7B) {
80
- try {
81
- const parsed = JSON.parse(blob.data.toString('utf8')) as AnyRecord;
82
- jsonBlobs.push({ ...blob, parsed });
83
- } catch {
84
- // Cursor can include binary or partial blobs; only JSON blobs become messages.
85
- }
86
- }
87
- }
88
-
89
- for (const blob of allBlobs) {
90
- if (!blob.data || blob.data[0] === 0x7B) {
91
- continue;
92
- }
93
-
94
- const parents: string[] = [];
95
- let i = 0;
96
- while (i < blob.data.length - 33) {
97
- if (blob.data[i] === 0x0A && blob.data[i + 1] === 0x20) {
98
- const parentHash = blob.data.slice(i + 2, i + 34).toString('hex');
99
- if (blobMap.has(parentHash)) {
100
- parents.push(parentHash);
101
- }
102
- i += 34;
103
- } else {
104
- i++;
105
- }
106
- }
107
-
108
- if (parents.length > 0) {
109
- parentRefs.set(blob.id, parents);
110
- for (const parentId of parents) {
111
- if (!childRefs.has(parentId)) {
112
- childRefs.set(parentId, []);
113
- }
114
- childRefs.get(parentId)?.push(blob.id);
115
- }
116
- }
117
- }
118
-
119
- const visited = new Set<string>();
120
- const sorted: CursorDbBlob[] = [];
121
- const visit = (nodeId: string): void => {
122
- if (visited.has(nodeId)) {
123
- return;
124
- }
125
- visited.add(nodeId);
126
- for (const parentId of parentRefs.get(nodeId) || []) {
127
- visit(parentId);
128
- }
129
- const blob = blobMap.get(nodeId);
130
- if (blob) {
131
- sorted.push(blob);
132
- }
133
- };
134
-
135
- for (const blob of allBlobs) {
136
- if (!parentRefs.has(blob.id)) {
137
- visit(blob.id);
138
- }
139
- }
140
- for (const blob of allBlobs) {
141
- visit(blob.id);
142
- }
143
-
144
- const messageOrder = new Map<string, number>();
145
- let orderIndex = 0;
146
- for (const blob of sorted) {
147
- if (blob.data && blob.data[0] !== 0x7B) {
148
- for (const jsonBlob of jsonBlobs) {
149
- try {
150
- const idBytes = Buffer.from(jsonBlob.id, 'hex');
151
- if (blob.data.includes(idBytes) && !messageOrder.has(jsonBlob.id)) {
152
- messageOrder.set(jsonBlob.id, orderIndex++);
153
- }
154
- } catch {
155
- // Ignore malformed blob ids that cannot be decoded as hex.
156
- }
157
- }
158
- }
159
- }
160
-
161
- const sortedJsonBlobs = jsonBlobs.sort((a, b) => {
162
- const aOrder = messageOrder.get(a.id) ?? Number.MAX_SAFE_INTEGER;
163
- const bOrder = messageOrder.get(b.id) ?? Number.MAX_SAFE_INTEGER;
164
- return aOrder !== bOrder ? aOrder - bOrder : a.rowid - b.rowid;
165
- });
166
-
167
- const messages: CursorMessageBlob[] = [];
168
- for (let idx = 0; idx < sortedJsonBlobs.length; idx++) {
169
- const blob = sortedJsonBlobs[idx];
170
- const parsed = blob.parsed;
171
- const role = parsed?.role || parsed?.message?.role;
172
- if (role === 'system') {
173
- continue;
174
- }
175
- messages.push({
176
- id: blob.id,
177
- sequence: idx + 1,
178
- rowid: blob.rowid,
179
- content: parsed,
180
- });
181
- }
182
-
183
- return messages;
184
- } finally {
185
- db.close();
186
- }
187
- }
188
-
189
- /**
190
- * Normalizes live Cursor CLI NDJSON events. Persisted Cursor history is
191
- * normalized from SQLite blobs in fetchHistory().
192
- */
193
- normalizeMessage(rawMessage: unknown, sessionId: string | null): NormalizedMessage[] {
194
- const raw = readObjectRecord(rawMessage);
195
- if (raw?.type === 'assistant' && raw.message?.content?.[0]?.text) {
196
- return [createNormalizedMessage({
197
- kind: 'stream_delta',
198
- content: raw.message.content[0].text,
199
- sessionId,
200
- provider: PROVIDER,
201
- })];
202
- }
203
-
204
- if (typeof rawMessage === 'string' && rawMessage.trim()) {
205
- return [createNormalizedMessage({
206
- kind: 'stream_delta',
207
- content: rawMessage,
208
- sessionId,
209
- provider: PROVIDER,
210
- })];
211
- }
212
-
213
- return [];
214
- }
215
-
216
- /**
217
- * Fetches and paginates Cursor session history from its project-scoped store.db.
218
- */
219
- async fetchHistory(
220
- sessionId: string,
221
- options: FetchHistoryOptions = {},
222
- ): Promise<FetchHistoryResult> {
223
- const { projectPath = '', limit = null, offset = 0 } = options;
224
-
225
- try {
226
- const blobs = await this.loadCursorBlobs(sessionId, projectPath);
227
- const allNormalized = this.normalizeCursorBlobs(blobs, sessionId);
228
- const total = allNormalized.length;
229
-
230
- if (limit !== null) {
231
- const start = offset;
232
- const page = limit === 0
233
- ? []
234
- : allNormalized.slice(start, start + limit);
235
- const hasMore = limit === 0
236
- ? start < total
237
- : start + limit < total;
238
- return {
239
- messages: page,
240
- total,
241
- hasMore,
242
- offset,
243
- limit,
244
- };
245
- }
246
-
247
- return {
248
- messages: allNormalized,
249
- total,
250
- hasMore: false,
251
- offset: 0,
252
- limit: null,
253
- };
254
- } catch (error) {
255
- const message = error instanceof Error ? error.message : String(error);
256
- console.warn(`[CursorProvider] Failed to load session ${sessionId}:`, message);
257
- return { messages: [], total: 0, hasMore: false, offset: 0, limit: null };
258
- }
259
- }
260
-
261
- /**
262
- * Converts Cursor SQLite message blobs into normalized messages and attaches
263
- * matching tool results to their tool_use entries.
264
- */
265
- private normalizeCursorBlobs(blobs: CursorMessageBlob[], sessionId: string | null): NormalizedMessage[] {
266
- const messages: NormalizedMessage[] = [];
267
- const toolUseMap = new Map<string, NormalizedMessage>();
268
- const baseTime = Date.now();
269
-
270
- for (let i = 0; i < blobs.length; i++) {
271
- const blob = blobs[i];
272
- const content = blob.content;
273
- const ts = new Date(baseTime + (blob.sequence ?? i) * 100).toISOString();
274
- const baseId = blob.id || generateMessageId('cursor');
275
-
276
- try {
277
- if (!content?.role || !content?.content) {
278
- if (content?.message?.role && content?.message?.content) {
279
- if (content.message.role === 'system') {
280
- continue;
281
- }
282
- const role = content.message.role === 'user' ? 'user' : 'assistant';
283
- let text = '';
284
- if (Array.isArray(content.message.content)) {
285
- text = content.message.content
286
- .map((part: string | AnyRecord) => typeof part === 'string' ? part : part?.text || '')
287
- .filter(Boolean)
288
- .join('\n');
289
- } else if (typeof content.message.content === 'string') {
290
- text = content.message.content;
291
- }
292
- if (text?.trim()) {
293
- messages.push(createNormalizedMessage({
294
- id: baseId,
295
- sessionId,
296
- timestamp: ts,
297
- provider: PROVIDER,
298
- kind: 'text',
299
- role,
300
- content: text,
301
- sequence: blob.sequence,
302
- rowid: blob.rowid,
303
- }));
304
- }
305
- }
306
- continue;
307
- }
308
-
309
- if (content.role === 'system') {
310
- continue;
311
- }
312
-
313
- if (content.role === 'tool') {
314
- const toolItems = Array.isArray(content.content) ? content.content : [];
315
- for (const item of toolItems) {
316
- if (item?.type !== 'tool-result') {
317
- continue;
318
- }
319
- const toolCallId = item.toolCallId || content.id;
320
- messages.push(createNormalizedMessage({
321
- id: `${baseId}_tr`,
322
- sessionId,
323
- timestamp: ts,
324
- provider: PROVIDER,
325
- kind: 'tool_result',
326
- toolId: toolCallId,
327
- content: item.result || '',
328
- isError: false,
329
- }));
330
- }
331
- continue;
332
- }
333
-
334
- const role = content.role === 'user' ? 'user' : 'assistant';
335
-
336
- if (Array.isArray(content.content)) {
337
- for (let partIdx = 0; partIdx < content.content.length; partIdx++) {
338
- const part = content.content[partIdx];
339
-
340
- if (part?.type === 'text' && part?.text) {
341
- messages.push(createNormalizedMessage({
342
- id: `${baseId}_${partIdx}`,
343
- sessionId,
344
- timestamp: ts,
345
- provider: PROVIDER,
346
- kind: 'text',
347
- role,
348
- content: part.text,
349
- sequence: blob.sequence,
350
- rowid: blob.rowid,
351
- }));
352
- } else if (part?.type === 'reasoning' && part?.text) {
353
- messages.push(createNormalizedMessage({
354
- id: `${baseId}_${partIdx}`,
355
- sessionId,
356
- timestamp: ts,
357
- provider: PROVIDER,
358
- kind: 'thinking',
359
- content: part.text,
360
- }));
361
- } else if (part?.type === 'tool-call' || part?.type === 'tool_use') {
362
- const rawToolName = part.toolName || part.name || 'Unknown Tool';
363
- const toolName = rawToolName === 'ApplyPatch' ? 'Edit' : rawToolName;
364
- const toolId = part.toolCallId || part.id || `tool_${i}_${partIdx}`;
365
- const message = createNormalizedMessage({
366
- id: `${baseId}_${partIdx}`,
367
- sessionId,
368
- timestamp: ts,
369
- provider: PROVIDER,
370
- kind: 'tool_use',
371
- toolName,
372
- toolInput: part.args || part.input,
373
- toolId,
374
- });
375
- messages.push(message);
376
- toolUseMap.set(toolId, message);
377
- }
378
- }
379
- } else if (typeof content.content === 'string' && content.content.trim()) {
380
- messages.push(createNormalizedMessage({
381
- id: baseId,
382
- sessionId,
383
- timestamp: ts,
384
- provider: PROVIDER,
385
- kind: 'text',
386
- role,
387
- content: content.content,
388
- sequence: blob.sequence,
389
- rowid: blob.rowid,
390
- }));
391
- }
392
- } catch (error) {
393
- console.warn('Error normalizing cursor blob:', error);
394
- }
395
- }
396
-
397
- for (const msg of messages) {
398
- if (msg.kind === 'tool_result' && msg.toolId && toolUseMap.has(msg.toolId)) {
399
- const toolUse = toolUseMap.get(msg.toolId);
400
- if (toolUse) {
401
- toolUse.toolResult = {
402
- content: msg.content,
403
- isError: msg.isError,
404
- };
405
- }
406
- }
407
- }
408
-
409
- messages.sort((a, b) => {
410
- if (a.sequence !== undefined && b.sequence !== undefined) {
411
- return a.sequence - b.sequence;
412
- }
413
- if (a.rowid !== undefined && b.rowid !== undefined) {
414
- return a.rowid - b.rowid;
415
- }
416
- return new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime();
417
- });
418
-
419
- return messages;
420
- }
421
- }
1
+ import crypto from 'node:crypto';
2
+ import os from 'node:os';
3
+ import path from 'node:path';
4
+
5
+ import type { IProviderSessions } from '@/shared/interfaces.js';
6
+ import type { AnyRecord, FetchHistoryOptions, FetchHistoryResult, NormalizedMessage } from '@/shared/types.js';
7
+ import { createNormalizedMessage, generateMessageId, readObjectRecord } from '@/shared/utils.js';
8
+
9
+ const PROVIDER = 'cursor';
10
+
11
+ type CursorDbBlob = {
12
+ rowid: number;
13
+ id: string;
14
+ data?: Buffer;
15
+ };
16
+
17
+ type CursorJsonBlob = CursorDbBlob & {
18
+ parsed: AnyRecord;
19
+ };
20
+
21
+ type CursorMessageBlob = {
22
+ id: string;
23
+ sequence: number;
24
+ rowid: number;
25
+ content: AnyRecord;
26
+ };
27
+
28
+ function sanitizeCursorSessionId(sessionId: string): string {
29
+ const normalized = sessionId.trim();
30
+ if (!normalized) {
31
+ throw new Error('Cursor session id is required.');
32
+ }
33
+
34
+ if (
35
+ normalized.includes('..')
36
+ || normalized.includes(path.posix.sep)
37
+ || normalized.includes(path.win32.sep)
38
+ || normalized !== path.basename(normalized)
39
+ ) {
40
+ throw new Error(`Invalid cursor session id "${sessionId}".`);
41
+ }
42
+
43
+ return normalized;
44
+ }
45
+
46
+ export class CursorSessionsProvider implements IProviderSessions {
47
+ /**
48
+ * Loads Cursor's SQLite blob DAG and returns message blobs in conversation
49
+ * order. Cursor history is stored as content-addressed blobs rather than JSONL.
50
+ */
51
+ private async loadCursorBlobs(sessionId: string, projectPath: string): Promise<CursorMessageBlob[]> {
52
+ // Lazy-import better-sqlite3 so the module doesn't fail if it's unavailable
53
+ const { default: Database } = await import('better-sqlite3');
54
+
55
+ const cwdId = crypto.createHash('md5').update(projectPath || process.cwd()).digest('hex');
56
+ const safeSessionId = sanitizeCursorSessionId(sessionId);
57
+ const baseChatsPath = path.join(os.homedir(), '.cursor', 'chats', cwdId);
58
+ const storeDbPath = path.join(baseChatsPath, safeSessionId, 'store.db');
59
+ const resolvedBaseChatsPath = path.resolve(baseChatsPath);
60
+ const resolvedStoreDbPath = path.resolve(storeDbPath);
61
+ const relativeStorePath = path.relative(resolvedBaseChatsPath, resolvedStoreDbPath);
62
+ if (relativeStorePath.startsWith('..') || path.isAbsolute(relativeStorePath)) {
63
+ throw new Error(`Invalid cursor session path for "${sessionId}".`);
64
+ }
65
+
66
+ const db = new Database(resolvedStoreDbPath, { readonly: true, fileMustExist: true });
67
+
68
+ try {
69
+ const allBlobs = db.prepare<[], CursorDbBlob>('SELECT rowid, id, data FROM blobs').all();
70
+
71
+ const blobMap = new Map<string, CursorDbBlob>();
72
+ const parentRefs = new Map<string, string[]>();
73
+ const childRefs = new Map<string, string[]>();
74
+ const jsonBlobs: CursorJsonBlob[] = [];
75
+
76
+ for (const blob of allBlobs) {
77
+ blobMap.set(blob.id, blob);
78
+
79
+ if (blob.data && blob.data[0] === 0x7B) {
80
+ try {
81
+ const parsed = JSON.parse(blob.data.toString('utf8')) as AnyRecord;
82
+ jsonBlobs.push({ ...blob, parsed });
83
+ } catch {
84
+ // Cursor can include binary or partial blobs; only JSON blobs become messages.
85
+ }
86
+ }
87
+ }
88
+
89
+ for (const blob of allBlobs) {
90
+ if (!blob.data || blob.data[0] === 0x7B) {
91
+ continue;
92
+ }
93
+
94
+ const parents: string[] = [];
95
+ let i = 0;
96
+ while (i < blob.data.length - 33) {
97
+ if (blob.data[i] === 0x0A && blob.data[i + 1] === 0x20) {
98
+ const parentHash = blob.data.slice(i + 2, i + 34).toString('hex');
99
+ if (blobMap.has(parentHash)) {
100
+ parents.push(parentHash);
101
+ }
102
+ i += 34;
103
+ } else {
104
+ i++;
105
+ }
106
+ }
107
+
108
+ if (parents.length > 0) {
109
+ parentRefs.set(blob.id, parents);
110
+ for (const parentId of parents) {
111
+ if (!childRefs.has(parentId)) {
112
+ childRefs.set(parentId, []);
113
+ }
114
+ childRefs.get(parentId)?.push(blob.id);
115
+ }
116
+ }
117
+ }
118
+
119
+ const visited = new Set<string>();
120
+ const sorted: CursorDbBlob[] = [];
121
+ const visit = (nodeId: string): void => {
122
+ if (visited.has(nodeId)) {
123
+ return;
124
+ }
125
+ visited.add(nodeId);
126
+ for (const parentId of parentRefs.get(nodeId) || []) {
127
+ visit(parentId);
128
+ }
129
+ const blob = blobMap.get(nodeId);
130
+ if (blob) {
131
+ sorted.push(blob);
132
+ }
133
+ };
134
+
135
+ for (const blob of allBlobs) {
136
+ if (!parentRefs.has(blob.id)) {
137
+ visit(blob.id);
138
+ }
139
+ }
140
+ for (const blob of allBlobs) {
141
+ visit(blob.id);
142
+ }
143
+
144
+ const messageOrder = new Map<string, number>();
145
+ let orderIndex = 0;
146
+ for (const blob of sorted) {
147
+ if (blob.data && blob.data[0] !== 0x7B) {
148
+ for (const jsonBlob of jsonBlobs) {
149
+ try {
150
+ const idBytes = Buffer.from(jsonBlob.id, 'hex');
151
+ if (blob.data.includes(idBytes) && !messageOrder.has(jsonBlob.id)) {
152
+ messageOrder.set(jsonBlob.id, orderIndex++);
153
+ }
154
+ } catch {
155
+ // Ignore malformed blob ids that cannot be decoded as hex.
156
+ }
157
+ }
158
+ }
159
+ }
160
+
161
+ const sortedJsonBlobs = jsonBlobs.sort((a, b) => {
162
+ const aOrder = messageOrder.get(a.id) ?? Number.MAX_SAFE_INTEGER;
163
+ const bOrder = messageOrder.get(b.id) ?? Number.MAX_SAFE_INTEGER;
164
+ return aOrder !== bOrder ? aOrder - bOrder : a.rowid - b.rowid;
165
+ });
166
+
167
+ const messages: CursorMessageBlob[] = [];
168
+ for (let idx = 0; idx < sortedJsonBlobs.length; idx++) {
169
+ const blob = sortedJsonBlobs[idx];
170
+ const parsed = blob.parsed;
171
+ const role = parsed?.role || parsed?.message?.role;
172
+ if (role === 'system') {
173
+ continue;
174
+ }
175
+ messages.push({
176
+ id: blob.id,
177
+ sequence: idx + 1,
178
+ rowid: blob.rowid,
179
+ content: parsed,
180
+ });
181
+ }
182
+
183
+ return messages;
184
+ } finally {
185
+ db.close();
186
+ }
187
+ }
188
+
189
+ /**
190
+ * Normalizes live Cursor CLI NDJSON events. Persisted Cursor history is
191
+ * normalized from SQLite blobs in fetchHistory().
192
+ */
193
+ normalizeMessage(rawMessage: unknown, sessionId: string | null): NormalizedMessage[] {
194
+ const raw = readObjectRecord(rawMessage);
195
+ if (raw?.type === 'assistant' && raw.message?.content?.[0]?.text) {
196
+ return [createNormalizedMessage({
197
+ kind: 'stream_delta',
198
+ content: raw.message.content[0].text,
199
+ sessionId,
200
+ provider: PROVIDER,
201
+ })];
202
+ }
203
+
204
+ if (typeof rawMessage === 'string' && rawMessage.trim()) {
205
+ return [createNormalizedMessage({
206
+ kind: 'stream_delta',
207
+ content: rawMessage,
208
+ sessionId,
209
+ provider: PROVIDER,
210
+ })];
211
+ }
212
+
213
+ return [];
214
+ }
215
+
216
+ /**
217
+ * Fetches and paginates Cursor session history from its project-scoped store.db.
218
+ */
219
+ async fetchHistory(
220
+ sessionId: string,
221
+ options: FetchHistoryOptions = {},
222
+ ): Promise<FetchHistoryResult> {
223
+ const { projectPath = '', limit = null, offset = 0 } = options;
224
+
225
+ try {
226
+ const blobs = await this.loadCursorBlobs(sessionId, projectPath);
227
+ const allNormalized = this.normalizeCursorBlobs(blobs, sessionId);
228
+ const total = allNormalized.length;
229
+
230
+ if (limit !== null) {
231
+ const start = offset;
232
+ const page = limit === 0
233
+ ? []
234
+ : allNormalized.slice(start, start + limit);
235
+ const hasMore = limit === 0
236
+ ? start < total
237
+ : start + limit < total;
238
+ return {
239
+ messages: page,
240
+ total,
241
+ hasMore,
242
+ offset,
243
+ limit,
244
+ };
245
+ }
246
+
247
+ return {
248
+ messages: allNormalized,
249
+ total,
250
+ hasMore: false,
251
+ offset: 0,
252
+ limit: null,
253
+ };
254
+ } catch (error) {
255
+ const message = error instanceof Error ? error.message : String(error);
256
+ console.warn(`[CursorProvider] Failed to load session ${sessionId}:`, message);
257
+ return { messages: [], total: 0, hasMore: false, offset: 0, limit: null };
258
+ }
259
+ }
260
+
261
+ /**
262
+ * Converts Cursor SQLite message blobs into normalized messages and attaches
263
+ * matching tool results to their tool_use entries.
264
+ */
265
+ private normalizeCursorBlobs(blobs: CursorMessageBlob[], sessionId: string | null): NormalizedMessage[] {
266
+ const messages: NormalizedMessage[] = [];
267
+ const toolUseMap = new Map<string, NormalizedMessage>();
268
+ const baseTime = Date.now();
269
+
270
+ for (let i = 0; i < blobs.length; i++) {
271
+ const blob = blobs[i];
272
+ const content = blob.content;
273
+ const ts = new Date(baseTime + (blob.sequence ?? i) * 100).toISOString();
274
+ const baseId = blob.id || generateMessageId('cursor');
275
+
276
+ try {
277
+ if (!content?.role || !content?.content) {
278
+ if (content?.message?.role && content?.message?.content) {
279
+ if (content.message.role === 'system') {
280
+ continue;
281
+ }
282
+ const role = content.message.role === 'user' ? 'user' : 'assistant';
283
+ let text = '';
284
+ if (Array.isArray(content.message.content)) {
285
+ text = content.message.content
286
+ .map((part: string | AnyRecord) => typeof part === 'string' ? part : part?.text || '')
287
+ .filter(Boolean)
288
+ .join('\n');
289
+ } else if (typeof content.message.content === 'string') {
290
+ text = content.message.content;
291
+ }
292
+ if (text?.trim()) {
293
+ messages.push(createNormalizedMessage({
294
+ id: baseId,
295
+ sessionId,
296
+ timestamp: ts,
297
+ provider: PROVIDER,
298
+ kind: 'text',
299
+ role,
300
+ content: text,
301
+ sequence: blob.sequence,
302
+ rowid: blob.rowid,
303
+ }));
304
+ }
305
+ }
306
+ continue;
307
+ }
308
+
309
+ if (content.role === 'system') {
310
+ continue;
311
+ }
312
+
313
+ if (content.role === 'tool') {
314
+ const toolItems = Array.isArray(content.content) ? content.content : [];
315
+ for (const item of toolItems) {
316
+ if (item?.type !== 'tool-result') {
317
+ continue;
318
+ }
319
+ const toolCallId = item.toolCallId || content.id;
320
+ messages.push(createNormalizedMessage({
321
+ id: `${baseId}_tr`,
322
+ sessionId,
323
+ timestamp: ts,
324
+ provider: PROVIDER,
325
+ kind: 'tool_result',
326
+ toolId: toolCallId,
327
+ content: item.result || '',
328
+ isError: false,
329
+ }));
330
+ }
331
+ continue;
332
+ }
333
+
334
+ const role = content.role === 'user' ? 'user' : 'assistant';
335
+
336
+ if (Array.isArray(content.content)) {
337
+ for (let partIdx = 0; partIdx < content.content.length; partIdx++) {
338
+ const part = content.content[partIdx];
339
+
340
+ if (part?.type === 'text' && part?.text) {
341
+ messages.push(createNormalizedMessage({
342
+ id: `${baseId}_${partIdx}`,
343
+ sessionId,
344
+ timestamp: ts,
345
+ provider: PROVIDER,
346
+ kind: 'text',
347
+ role,
348
+ content: part.text,
349
+ sequence: blob.sequence,
350
+ rowid: blob.rowid,
351
+ }));
352
+ } else if (part?.type === 'reasoning' && part?.text) {
353
+ messages.push(createNormalizedMessage({
354
+ id: `${baseId}_${partIdx}`,
355
+ sessionId,
356
+ timestamp: ts,
357
+ provider: PROVIDER,
358
+ kind: 'thinking',
359
+ content: part.text,
360
+ }));
361
+ } else if (part?.type === 'tool-call' || part?.type === 'tool_use') {
362
+ const rawToolName = part.toolName || part.name || 'Unknown Tool';
363
+ const toolName = rawToolName === 'ApplyPatch' ? 'Edit' : rawToolName;
364
+ const toolId = part.toolCallId || part.id || `tool_${i}_${partIdx}`;
365
+ const message = createNormalizedMessage({
366
+ id: `${baseId}_${partIdx}`,
367
+ sessionId,
368
+ timestamp: ts,
369
+ provider: PROVIDER,
370
+ kind: 'tool_use',
371
+ toolName,
372
+ toolInput: part.args || part.input,
373
+ toolId,
374
+ });
375
+ messages.push(message);
376
+ toolUseMap.set(toolId, message);
377
+ }
378
+ }
379
+ } else if (typeof content.content === 'string' && content.content.trim()) {
380
+ messages.push(createNormalizedMessage({
381
+ id: baseId,
382
+ sessionId,
383
+ timestamp: ts,
384
+ provider: PROVIDER,
385
+ kind: 'text',
386
+ role,
387
+ content: content.content,
388
+ sequence: blob.sequence,
389
+ rowid: blob.rowid,
390
+ }));
391
+ }
392
+ } catch (error) {
393
+ console.warn('Error normalizing cursor blob:', error);
394
+ }
395
+ }
396
+
397
+ for (const msg of messages) {
398
+ if (msg.kind === 'tool_result' && msg.toolId && toolUseMap.has(msg.toolId)) {
399
+ const toolUse = toolUseMap.get(msg.toolId);
400
+ if (toolUse) {
401
+ toolUse.toolResult = {
402
+ content: msg.content,
403
+ isError: msg.isError,
404
+ };
405
+ }
406
+ }
407
+ }
408
+
409
+ messages.sort((a, b) => {
410
+ if (a.sequence !== undefined && b.sequence !== undefined) {
411
+ return a.sequence - b.sequence;
412
+ }
413
+ if (a.rowid !== undefined && b.rowid !== undefined) {
414
+ return a.rowid - b.rowid;
415
+ }
416
+ return new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime();
417
+ });
418
+
419
+ return messages;
420
+ }
421
+ }