@pixelbyte-software/pixcode 1.54.7 → 1.54.9

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 (290) hide show
  1. package/CODE_OF_CONDUCT.md +41 -41
  2. package/CONTRIBUTING.md +155 -155
  3. package/LICENSE +718 -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 +418 -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-D-4VRH1a.js → index-Bm6uAqKU.js} +186 -184
  15. package/dist/assets/index-Dz1luE0u.css +32 -0
  16. package/dist/clear-cache.html +85 -85
  17. package/dist/convert-icons.md +52 -52
  18. package/dist/docs.html +308 -308
  19. package/dist/features.html +133 -133
  20. package/dist/generate-icons.js +48 -48
  21. package/dist/humans.txt +15 -15
  22. package/dist/icons/codex-white.svg +3 -3
  23. package/dist/icons/codex.svg +3 -3
  24. package/dist/icons/cursor-white.svg +11 -11
  25. package/dist/icons/qwen-logo.svg +14 -14
  26. package/dist/index.html +59 -59
  27. package/dist/landing.html +268 -268
  28. package/dist/llms-full.txt +119 -119
  29. package/dist/llms.txt +53 -53
  30. package/dist/manifest.json +60 -60
  31. package/dist/openapi.yaml +1696 -1696
  32. package/dist/orchestration.html +125 -125
  33. package/dist/robots.txt +4 -4
  34. package/dist/site.css +692 -692
  35. package/dist/sitemap.xml +51 -51
  36. package/dist/sw.js +132 -132
  37. package/dist-server/server/cli.js +100 -100
  38. package/dist-server/server/daemon/manager.js +33 -33
  39. package/dist-server/server/daemon-manager.js +64 -64
  40. package/dist-server/server/index.js +148 -14
  41. package/dist-server/server/index.js.map +1 -1
  42. package/dist-server/server/projects.js +16 -6
  43. package/dist-server/server/projects.js.map +1 -1
  44. package/dist-server/server/routes/auth.js +17 -5
  45. package/dist-server/server/routes/auth.js.map +1 -1
  46. package/dist-server/server/routes/commands.js +25 -25
  47. package/dist-server/server/routes/git.js +17 -17
  48. package/dist-server/server/routes/live-view.js +46 -46
  49. package/dist-server/server/services/public-api-manifest.js +51 -51
  50. package/package.json +224 -224
  51. package/scripts/fix-node-pty.js +67 -67
  52. package/scripts/github/create-v1.38-issues.mjs +351 -351
  53. package/scripts/github/create-vscode-workbench-issues.mjs +121 -121
  54. package/scripts/smoke/backend-resource-bounds.mjs +152 -152
  55. package/scripts/smoke/changes-panel-layout.mjs +48 -48
  56. package/scripts/smoke/chat-composer-fixed-layout.mjs +55 -55
  57. package/scripts/smoke/chat-message-timeline-order.mjs +41 -41
  58. package/scripts/smoke/chat-realtime-hydration.mjs +44 -44
  59. package/scripts/smoke/chat-session-provider-pools.mjs +35 -35
  60. package/scripts/smoke/chat-session-state.mjs +19 -19
  61. package/scripts/smoke/code-editor-theme.mjs +55 -55
  62. package/scripts/smoke/code-editor-vscode-engine.mjs +91 -91
  63. package/scripts/smoke/command-center-agent-writes.mjs +79 -79
  64. package/scripts/smoke/command-center-non-git.mjs +46 -46
  65. package/scripts/smoke/context-packet.mjs +43 -43
  66. package/scripts/smoke/control-room-ux-redesign.mjs +91 -91
  67. package/scripts/smoke/daemon-entrypoint.mjs +20 -20
  68. package/scripts/smoke/default-landing-routing.mjs +33 -33
  69. package/scripts/smoke/desktop-native-notifications.mjs +30 -30
  70. package/scripts/smoke/desktop-tray-icon.mjs +33 -33
  71. package/scripts/smoke/discord-release-workflow.mjs +24 -24
  72. package/scripts/smoke/git-install-update.mjs +255 -255
  73. package/scripts/smoke/handoff-artifact-protocol.mjs +50 -50
  74. package/scripts/smoke/live-view-diagnostics.mjs +53 -53
  75. package/scripts/smoke/live-view-environment.mjs +92 -92
  76. package/scripts/smoke/live-view-integration.mjs +450 -450
  77. package/scripts/smoke/mac-desktop-runtime.mjs +37 -37
  78. package/scripts/smoke/mobile-tunnel-guidance.mjs +29 -29
  79. package/scripts/smoke/mobile-ux.mjs +76 -76
  80. package/scripts/smoke/model-registry.mjs +36 -36
  81. package/scripts/smoke/multi-project-ui.mjs +45 -45
  82. package/scripts/smoke/multi-worker-slots.mjs +42 -42
  83. package/scripts/smoke/notification-center.mjs +87 -87
  84. package/scripts/smoke/notification-inapp-preference.mjs +23 -23
  85. package/scripts/smoke/notification-taxonomy.mjs +58 -58
  86. package/scripts/smoke/orchestration-api.mjs +172 -172
  87. package/scripts/smoke/orchestration-execution-dashboard.mjs +33 -33
  88. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  89. package/scripts/smoke/orchestration-mobile-scroll.mjs +29 -29
  90. package/scripts/smoke/orchestration-model-sync.mjs +30 -30
  91. package/scripts/smoke/orchestration-permission-fallback.mjs +34 -34
  92. package/scripts/smoke/orchestration-runtime-guards.mjs +48 -48
  93. package/scripts/smoke/orchestration-user-facing-output.mjs +25 -25
  94. package/scripts/smoke/permission-policy.mjs +50 -50
  95. package/scripts/smoke/pixcode-workbench-1-48.mjs +167 -167
  96. package/scripts/smoke/provider-models-opencode-live.mjs +66 -66
  97. package/scripts/smoke/provider-rest-api.mjs +124 -124
  98. package/scripts/smoke/provider-selection-status.mjs +52 -52
  99. package/scripts/smoke/run-state-refresh.mjs +52 -52
  100. package/scripts/smoke/runtime-manager.mjs +99 -99
  101. package/scripts/smoke/shell-manual-disconnect.mjs +30 -30
  102. package/scripts/smoke/side-panel-editor-layout.mjs +34 -34
  103. package/scripts/smoke/static-root-routing.mjs +21 -21
  104. package/scripts/smoke/strict-handoff-compact.mjs +60 -60
  105. package/scripts/smoke/taskmaster-config.mjs +24 -24
  106. package/scripts/smoke/taskmaster-execution-telegram.mjs +3 -3
  107. package/scripts/smoke/taskmaster-onboarding.mjs +3 -3
  108. package/scripts/smoke/taskmaster-run-graph.mjs +3 -3
  109. package/scripts/smoke/telegram-control.mjs +331 -331
  110. package/scripts/smoke/tunnel-persistence.mjs +56 -56
  111. package/scripts/smoke/update-issue-progress.mjs +69 -69
  112. package/scripts/smoke/update-ux.mjs +55 -55
  113. package/scripts/smoke/v138-completion.mjs +132 -132
  114. package/scripts/smoke/v138-desktop-release-hardening.mjs +69 -69
  115. package/scripts/smoke/v138-diagnostics.mjs +63 -63
  116. package/scripts/smoke/v138-issue-planner.mjs +33 -33
  117. package/scripts/smoke/v143-remote-control.mjs +76 -76
  118. package/scripts/smoke/v144-production-loop.mjs +47 -47
  119. package/scripts/smoke/v145-platformization.mjs +46 -46
  120. package/scripts/smoke/v146-control-room-ui.mjs +150 -150
  121. package/scripts/smoke/version-modal-autoshow.mjs +29 -29
  122. package/scripts/smoke/vscode-workbench-layout.mjs +63 -63
  123. package/scripts/smoke/vscode-workbench-polish.mjs +461 -461
  124. package/scripts/smoke/workflow-fallback-replay.mjs +56 -56
  125. package/scripts/smoke/workflow-templates.mjs +43 -43
  126. package/scripts/smoke/workflow-trace-timeline.mjs +46 -46
  127. package/scripts/update-git-install.mjs +298 -298
  128. package/server/claude-sdk.js +927 -927
  129. package/server/cli.js +1106 -1106
  130. package/server/constants/config.js +4 -4
  131. package/server/cursor-cli.js +344 -344
  132. package/server/daemon/manager.js +563 -563
  133. package/server/daemon-manager.js +964 -964
  134. package/server/database/db.js +988 -988
  135. package/server/database/json-store.js +197 -197
  136. package/server/gemini-cli.js +550 -550
  137. package/server/gemini-response-handler.js +79 -79
  138. package/server/index.js +5659 -5529
  139. package/server/load-env.js +35 -35
  140. package/server/middleware/account-lockout.js +112 -112
  141. package/server/middleware/auth.js +277 -277
  142. package/server/middleware/rate-limiter.js +87 -87
  143. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  144. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +63 -63
  145. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +286 -286
  146. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  147. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  148. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  149. package/server/modules/orchestration/a2a/adapters/json-event.adapter.test.ts +60 -60
  150. package/server/modules/orchestration/a2a/adapters/json-event.adapter.ts +101 -101
  151. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  152. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  153. package/server/modules/orchestration/a2a/agent-card.ts +55 -55
  154. package/server/modules/orchestration/a2a/auth.middleware.ts +29 -29
  155. package/server/modules/orchestration/a2a/bus.ts +46 -46
  156. package/server/modules/orchestration/a2a/routes.ts +586 -586
  157. package/server/modules/orchestration/a2a/task-dispatcher.ts +345 -345
  158. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  159. package/server/modules/orchestration/a2a/types.ts +126 -126
  160. package/server/modules/orchestration/a2a/validator.ts +113 -113
  161. package/server/modules/orchestration/index.ts +99 -99
  162. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  163. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  164. package/server/modules/orchestration/preview/types.ts +19 -19
  165. package/server/modules/orchestration/security/permission-policy.ts +401 -401
  166. package/server/modules/orchestration/tasks/orchestration-task-store.ts +41 -41
  167. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +81 -81
  168. package/server/modules/orchestration/tasks/orchestration-task.service.ts +201 -201
  169. package/server/modules/orchestration/tasks/orchestration-task.types.ts +40 -40
  170. package/server/modules/orchestration/tasks/task-run-graph.ts +155 -155
  171. package/server/modules/orchestration/workflows/approval-queue.ts +106 -106
  172. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  173. package/server/modules/orchestration/workflows/context-packet.ts +186 -186
  174. package/server/modules/orchestration/workflows/handoff-artifact.ts +175 -175
  175. package/server/modules/orchestration/workflows/workflow-fallback-policy.ts +161 -161
  176. package/server/modules/orchestration/workflows/workflow-replay.ts +254 -254
  177. package/server/modules/orchestration/workflows/workflow-runner.ts +2062 -2062
  178. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  179. package/server/modules/orchestration/workflows/workflow-templates.ts +272 -272
  180. package/server/modules/orchestration/workflows/workflow-trace.ts +424 -424
  181. package/server/modules/orchestration/workflows/workflow.routes.ts +586 -586
  182. package/server/modules/orchestration/workflows/workflow.types.ts +111 -111
  183. package/server/modules/orchestration/workflows/workspace-target.ts +122 -122
  184. package/server/modules/orchestration/workspace/docker-workspace.ts +136 -136
  185. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  186. package/server/modules/orchestration/workspace/types.ts +52 -52
  187. package/server/modules/orchestration/workspace/workspace-manager.ts +102 -102
  188. package/server/modules/orchestration/workspace/worktree-workspace.ts +126 -126
  189. package/server/modules/providers/index.ts +2 -2
  190. package/server/modules/providers/list/claude/claude-auth.provider.ts +146 -146
  191. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  192. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  193. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  194. package/server/modules/providers/list/codex/codex-auth.provider.ts +117 -117
  195. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  196. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  197. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  198. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +147 -147
  199. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  200. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  201. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  202. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +173 -173
  203. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  204. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  205. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  206. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +131 -131
  207. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +286 -286
  208. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +146 -146
  209. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  210. package/server/modules/providers/provider.registry.ts +40 -40
  211. package/server/modules/providers/provider.routes.ts +982 -982
  212. package/server/modules/providers/services/mcp.service.ts +86 -86
  213. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  214. package/server/modules/providers/services/sessions.service.ts +45 -45
  215. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  216. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  217. package/server/modules/providers/tests/mcp.test.ts +293 -293
  218. package/server/openai-codex.js +468 -468
  219. package/server/opencode-cli.js +491 -491
  220. package/server/opencode-response-handler.js +111 -111
  221. package/server/projects.js +3135 -3125
  222. package/server/qwen-code-cli.js +410 -410
  223. package/server/routes/agent.js +1451 -1451
  224. package/server/routes/auth.js +298 -286
  225. package/server/routes/codex.js +20 -20
  226. package/server/routes/commands.js +581 -581
  227. package/server/routes/cursor.js +61 -61
  228. package/server/routes/diagnostics.js +44 -44
  229. package/server/routes/gemini.js +25 -25
  230. package/server/routes/git.js +1822 -1822
  231. package/server/routes/live-view.js +434 -434
  232. package/server/routes/mcp-utils.js +13 -13
  233. package/server/routes/messages.js +97 -97
  234. package/server/routes/network.js +143 -143
  235. package/server/routes/platformization.js +231 -231
  236. package/server/routes/plugins.js +690 -690
  237. package/server/routes/production-agent-loop.js +90 -90
  238. package/server/routes/projects.js +918 -918
  239. package/server/routes/public-api.js +34 -34
  240. package/server/routes/qwen.js +27 -27
  241. package/server/routes/remote.js +56 -56
  242. package/server/routes/settings.js +321 -321
  243. package/server/routes/telegram.js +163 -163
  244. package/server/routes/user.js +125 -125
  245. package/server/routes/webhooks.js +63 -63
  246. package/server/services/control-room.js +102 -102
  247. package/server/services/diagnostics.js +165 -165
  248. package/server/services/external-access.js +403 -403
  249. package/server/services/install-jobs.js +715 -715
  250. package/server/services/live-view.js +956 -956
  251. package/server/services/managed-runtimes.js +493 -493
  252. package/server/services/model-registry.js +144 -144
  253. package/server/services/notification-orchestrator.js +365 -365
  254. package/server/services/notification-taxonomy.js +204 -204
  255. package/server/services/platformization.js +1052 -1052
  256. package/server/services/production-agent-loop.js +248 -248
  257. package/server/services/provider-cli-versions.js +149 -149
  258. package/server/services/provider-credentials.js +189 -189
  259. package/server/services/provider-models.js +396 -396
  260. package/server/services/public-api-manifest.js +181 -181
  261. package/server/services/qr-login.js +126 -126
  262. package/server/services/remote-connection.js +127 -127
  263. package/server/services/runtime-manager.js +323 -323
  264. package/server/services/startup-update.js +259 -259
  265. package/server/services/telegram/bot.js +393 -393
  266. package/server/services/telegram/control-center.js +2453 -2453
  267. package/server/services/telegram/telegram-gateway.js +314 -314
  268. package/server/services/telegram/telegram-http-client.js +201 -201
  269. package/server/services/telegram/translations.js +470 -470
  270. package/server/services/webhooks.js +216 -216
  271. package/server/sessionManager.js +225 -225
  272. package/server/setup-wizard.js +283 -283
  273. package/server/shared/interfaces.ts +54 -54
  274. package/server/shared/types.ts +172 -172
  275. package/server/shared/utils.ts +193 -193
  276. package/server/tsconfig.json +36 -36
  277. package/server/utils/colors.js +21 -21
  278. package/server/utils/commandParser.js +305 -305
  279. package/server/utils/frontmatter.js +18 -18
  280. package/server/utils/gitConfig.js +34 -34
  281. package/server/utils/plugin-loader.js +461 -461
  282. package/server/utils/plugin-process-manager.js +185 -185
  283. package/server/utils/port-access.js +227 -227
  284. package/server/utils/runtime-paths.js +37 -37
  285. package/server/utils/security-log.js +84 -84
  286. package/server/utils/url-detection.js +71 -71
  287. package/server/vite-daemon.js +79 -79
  288. package/shared/modelConstants.js +161 -161
  289. package/shared/networkHosts.js +22 -22
  290. package/dist/assets/index-DvudRU5X.css +0 -32
@@ -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
+ }