@yuriai/web 0.2.31 → 0.2.32-beta.10

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 (201) hide show
  1. package/README.md +19 -0
  2. package/dist/assets/{AgentAvatar-DLAQkFQe.js → AgentAvatar-DLzcNrQ0.js} +1 -1
  3. package/dist/assets/AssistantContactStatus-Bf1yg0yx.js +3 -0
  4. package/dist/assets/{AssistantUnreadBadge-BynxNQMk.js → AssistantUnreadBadge-BUFyxUrT.js} +1 -1
  5. package/dist/assets/{AssistantView-CDZyA9ft.js → AssistantView-CELFybSr.js} +1 -1
  6. package/dist/assets/{DiagramView-DdVFGHQQ.js → DiagramView-DV4P3-Wg.js} +1 -1
  7. package/dist/assets/{FadeInOnReveal-C9a7XnAh.js → FadeInOnReveal-BRrU2ivL.js} +1 -1
  8. package/dist/assets/{GuiPluginSurface-v8r-Hex5.js → GuiPluginSurface-NOHaJGy2.js} +1 -1
  9. package/dist/assets/{GuiPluginWindow-Ba1HfrjQ.js → GuiPluginWindow-BykPaQeY.js} +1 -1
  10. package/dist/assets/Icon-OJf0qBKf.js +1 -0
  11. package/dist/assets/{ImageLoadingPlaceholder-Dcy5lc7F.js → ImageLoadingPlaceholder-DlQbo9CM.js} +1 -1
  12. package/dist/assets/{LoadingImage-BxjJ_Xyj.js → LoadingImage-sZ5omN5L.js} +1 -1
  13. package/dist/assets/MarkdownRenderer-BFR9FWQL.js +2 -0
  14. package/dist/assets/MarkdownRendererImpl-iZFUMI3M.js +10 -0
  15. package/dist/assets/{MarkstreamRendererImpl-EpBnVy9J.css → MarkstreamRendererImpl-C6aiJnjl.css} +1 -1
  16. package/dist/assets/MarkstreamRendererImpl-DjC_Y4LS.js +3 -0
  17. package/dist/assets/{MobileDetailNavigation-o54juFXD.js → MobileDetailNavigation-BOZpHdI2.js} +1 -1
  18. package/dist/assets/{MobileResizableSheet-sV9XR-0k.js → MobileResizableSheet-DuAi_epR.js} +1 -1
  19. package/dist/assets/{MobileShareBridge-oqBZ_f6M.js → MobileShareBridge-D1DrqLWf.js} +1 -1
  20. package/dist/assets/MobileTabPageHeader-BT9gWugr.js +2 -0
  21. package/dist/assets/{MultiRunWindow-7W_86vL6.js → MultiRunWindow-C0GYNaUU.js} +1 -1
  22. package/dist/assets/{OnboardingScreen-CnkijSLE.js → OnboardingScreen-CqsI0632.js} +1 -1
  23. package/dist/assets/{OverlayScrollbar-CCtBTJQj.js → OverlayScrollbar-CZD1yU06.js} +1 -1
  24. package/dist/assets/SettingsView-BYO8LY5A.js +29 -0
  25. package/dist/assets/{SettingsWindow-C0HiNvXh.js → SettingsWindow-CM0Ph9WD.js} +1 -1
  26. package/dist/assets/SetupTourDialog-BYlSBPKZ.js +1 -0
  27. package/dist/assets/SetupTourDialog-DrL_4ODI.css +1 -0
  28. package/dist/assets/{TerminalView-y36H_fIe.js → TerminalView-DnyEAShU.js} +1 -1
  29. package/dist/assets/{ToolOutputDialog-BfjBeqGS.js → ToolOutputDialog-BWONfWze.js} +1 -1
  30. package/dist/assets/{VoiceSettings-BONwzGgR.js → VoiceSettings-Ru_0ySgM.js} +2 -2
  31. package/dist/assets/{YuriLogo-BA5FWp-g.js → YuriLogo-CMUoGUHc.js} +1 -1
  32. package/dist/assets/YuriWordmark-DHYo0FlR.js +1 -0
  33. package/dist/assets/{appThemeRegistry-BsLMp3bc.js → appThemeRegistry-BMlAlm0m.js} +1 -1
  34. package/dist/assets/{button-CBjOhOI0.js → button-C-gRcs_2.js} +1 -1
  35. package/dist/assets/{capgoAdapter-DjlyVxy_.js → capgoAdapter-GdNfjwXs.js} +1 -1
  36. package/dist/assets/checkbox-BrJBzET8.js +1 -0
  37. package/dist/assets/{collapsible-B0j5IQ0T.js → collapsible-B7esGYLd.js} +1 -1
  38. package/dist/assets/{context-menu-C4e_bpls.js → context-menu-DWn1nSZC.js} +1 -1
  39. package/dist/assets/desktopHosts-BLU1tGSX.js +1 -0
  40. package/dist/assets/{desktopRelayRestore-AE3_TnQz.js → desktopRelayRestore-2BIIs8mZ.js} +1 -1
  41. package/dist/assets/{diagram-WPmk0Qh6.js → diagram-Bnra5_6g.js} +1 -1
  42. package/dist/assets/{dialog-Dx3IT7dQ.js → dialog-3UseH0hM.js} +1 -1
  43. package/dist/assets/{es-JU--16Gd.js → es-J7a_sZ1u.js} +2 -2
  44. package/dist/assets/{fileMentionTouchSelection-Bizsisaj.js → fileMentionTouchSelection-ByaQJcTS.js} +1 -1
  45. package/dist/assets/{fr-BUZcRuMk.js → fr-BYxUMKWp.js} +2 -2
  46. package/dist/assets/{gitApi-CNgEj6X5.js → gitApi-BdwvoQFb.js} +1 -1
  47. package/dist/assets/historyImportQueries-C8VK9R5_.js +1 -0
  48. package/dist/assets/host-z9PU8q1e.js +1 -0
  49. package/dist/assets/{input-CEJGM-TS.js → input-CmLlZdeD.js} +1 -1
  50. package/dist/assets/insertionBoundaries-BpQ6nLjP.js +1 -0
  51. package/dist/assets/{ja-BwtVLTXD.js → ja-DCdBiJmD.js} +2 -2
  52. package/dist/assets/{ko--sLsRFpA.js → ko-D-Nb_RJY.js} +2 -2
  53. package/dist/assets/main-Dosy2jXg.js +2 -0
  54. package/dist/assets/main-oBh-dk5-.js +169 -0
  55. package/dist/assets/{markdownHeightCache-D6iSNJG2.js → markdownHeightCache-xNkQdlqi.js} +1 -1
  56. package/dist/assets/{mcpQueries-DVSsZeuk.js → mcpQueries-C8zsTQqJ.js} +1 -1
  57. package/dist/assets/miniChat-CI8ryDGT.js +2 -0
  58. package/dist/assets/mobile-e_mTK3dh.js +2 -0
  59. package/dist/assets/{mobileBackNavigation-Dmbf0kw1.js → mobileBackNavigation-sB7c0Pi4.js} +1 -1
  60. package/dist/assets/multirun-DbmgWrsY.js +3 -0
  61. package/dist/assets/{native-config-BaRHaY4y.js → native-config-C_mwkFzh.js} +1 -1
  62. package/dist/assets/{pl-C4_4J5yA.js → pl-AmU4w3aM.js} +2 -2
  63. package/dist/assets/{projectMeta-rrpZdm8D.js → projectMeta-1iUbVl_M.js} +1 -1
  64. package/dist/assets/{pt-BR-DvNC5K1q.js → pt-BR-BI4ft-Fj.js} +2 -2
  65. package/dist/assets/pwa-BdUAGhLt.js +2 -0
  66. package/dist/assets/{queue-abort-optimistic-CSkERbr4.js → queue-abort-optimistic-BwDsaym5.js} +1 -1
  67. package/dist/assets/react-a6PrrNTm.js +1 -0
  68. package/dist/assets/{readiness-BnO7IaZV.js → readiness-D2N0DtZF.js} +1 -1
  69. package/dist/assets/{renderElectronMiniChatApp-Bq3iNKtr.js → renderElectronMiniChatApp-DV0cNt_O.js} +2 -2
  70. package/dist/assets/{renderMobileApp-DiNeMgwp.js → renderMobileApp-b7--jT5z.js} +7 -7
  71. package/dist/assets/{runtimeConfig-BHOiBANF.js → runtimeConfig-DxmJLWUO.js} +1 -1
  72. package/dist/assets/runtimeEndpointReset-jYAYa3Rh.js +149 -0
  73. package/dist/assets/{select-bKMw5JE8.js → select-J8r9SxHt.js} +1 -1
  74. package/dist/assets/sessionLookup-CUQqj2N4.js +1 -0
  75. package/dist/assets/{sortable-tabs-strip-3sKiA7T1.js → sortable-tabs-strip-CiP6RIQa.js} +1 -1
  76. package/dist/assets/{speechSettingsQueries-BDDxw8LP.js → speechSettingsQueries-B3ziGQvb.js} +1 -1
  77. package/dist/assets/src-GtPQ8f4o.css +2 -0
  78. package/dist/assets/{store-X3lU0obe.js → store-OjrIiXCx.js} +5 -5
  79. package/dist/assets/{textarea-EsaDD051.js → textarea-BHgcxJdC.js} +1 -1
  80. package/dist/assets/{tooltip-LLDL5nIZ.js → tooltip-Degmpxnd.js} +1 -1
  81. package/dist/assets/tour-DDI0Zg7l.js +1 -0
  82. package/dist/assets/types-QETHY-S7.js +2 -0
  83. package/dist/assets/{uk-Dvj0JjiC.js → uk-CbdByxxj.js} +2 -2
  84. package/dist/assets/{useAppFontEffects-wIWWE59b.js → useAppFontEffects-LADr3Zl1.js} +53 -53
  85. package/dist/assets/useDesktopWindowControlsLayout-BVNnRHtc.js +1 -0
  86. package/dist/assets/{useDictation-DlEHSN6P.js → useDictation-DFVJpRbm.js} +1 -1
  87. package/dist/assets/{useEffectiveDirectory-DzqpWUC3.js → useEffectiveDirectory-8tqfGdV5.js} +1 -1
  88. package/dist/assets/{useMobileNavigationStore-BWLhXqci.js → useMobileNavigationStore-CLUFv-TZ.js} +13 -13
  89. package/dist/assets/usePluginsStore-B_SIDwsK.js +1 -0
  90. package/dist/assets/useStreamingTextThrottle-VhgGU_te.js +1 -0
  91. package/dist/assets/{useWorkerHighlightedLines-DMS69wKa.js → useWorkerHighlightedLines-jlxakDGs.js} +1 -1
  92. package/dist/assets/{vendor-markstream-react-DfLaSG3W.js → vendor-markstream-react-6zxyQLCD.js} +1 -1
  93. package/dist/assets/{zh-CN-2Y6u8t24.js → zh-CN-ufEVDbXp.js} +2 -2
  94. package/dist/assets/{zh-TW-Z5wVv4Fb.js → zh-TW-DTBlZ4YC.js} +2 -2
  95. package/dist/index.html +8 -8
  96. package/dist/mini-chat.html +8 -8
  97. package/dist/mobile.html +8 -8
  98. package/package.json +1 -1
  99. package/server/index.js +3 -0
  100. package/server/lib/client-auth/pairing.js +2 -0
  101. package/server/lib/client-auth/pairing.test.js +29 -0
  102. package/server/lib/config-sync/DOCUMENTATION.md +8 -4
  103. package/server/lib/config-sync/index.js +1 -1
  104. package/server/lib/config-sync/magpie-auth.js +10 -4
  105. package/server/lib/config-sync/magpie-auth.test.js +4 -0
  106. package/server/lib/config-sync/magpie.js +28 -22
  107. package/server/lib/config-sync/magpie.test.js +127 -2
  108. package/server/lib/config-sync/plugins.js +44 -0
  109. package/server/lib/config-sync/plugins.test.js +64 -0
  110. package/server/lib/config-sync/tar.js +61 -1
  111. package/server/lib/content-search/DOCUMENTATION.md +9 -0
  112. package/server/lib/content-search/routes.js +18 -1
  113. package/server/lib/content-search/routes.test.js +21 -0
  114. package/server/lib/content-search/runtime.js +7 -3
  115. package/server/lib/content-search/runtime.test.js +26 -0
  116. package/server/lib/gui-customization/DOCUMENTATION.md +21 -1
  117. package/server/lib/gui-customization/session-skill.js +2 -2
  118. package/server/lib/gui-customization/session-skill.test.js +3 -1
  119. package/server/lib/gui-customization/skill/SKILL.md +5 -1
  120. package/server/lib/gui-customization/skill/references/global-pages.md +1 -1
  121. package/server/lib/gui-customization/skill/references/gui-api.md +4 -1
  122. package/server/lib/gui-customization/skill/references/icons.md +134 -0
  123. package/server/lib/gui-customization/skill/references/plugin-styles.md +112 -0
  124. package/server/lib/gui-customization/skill/references/ui-surfaces.md +2 -0
  125. package/server/lib/gui-customization/skill/references/work-status.md +110 -0
  126. package/server/lib/history-import/AGENT_CONNECT_LICENSE +21 -0
  127. package/server/lib/history-import/DOCUMENTATION.md +223 -0
  128. package/server/lib/history-import/dev-proxy.integration.test.js +56 -0
  129. package/server/lib/history-import/events.js +322 -0
  130. package/server/lib/history-import/events.test.js +110 -0
  131. package/server/lib/history-import/installations.js +39 -0
  132. package/server/lib/history-import/installations.test.js +24 -0
  133. package/server/lib/history-import/native.js +49 -0
  134. package/server/lib/history-import/native.test.js +42 -0
  135. package/server/lib/history-import/routes.js +48 -0
  136. package/server/lib/history-import/routes.test.js +55 -0
  137. package/server/lib/history-import/service.js +374 -0
  138. package/server/lib/history-import/service.test.js +538 -0
  139. package/server/lib/history-import/settings.js +146 -0
  140. package/server/lib/history-import/settings.test.js +88 -0
  141. package/server/lib/history-import/sources.js +184 -0
  142. package/server/lib/history-import/sources.test.js +190 -0
  143. package/server/lib/history-import/sqlite.js +187 -0
  144. package/server/lib/history-import/store.js +58 -0
  145. package/server/lib/history-import/store.test.js +84 -0
  146. package/server/lib/history-import/targets.js +24 -0
  147. package/server/lib/host-update/DOCUMENTATION.md +6 -0
  148. package/server/lib/host-update/routes.test.js +1 -1
  149. package/server/lib/notifications/native-stream.relay.test.js +1 -0
  150. package/server/lib/opencode/DOCUMENTATION.md +14 -0
  151. package/server/lib/opencode/core-routes.js +1 -0
  152. package/server/lib/opencode/feature-routes-runtime.js +11 -1
  153. package/server/lib/opencode/plugin-routes.test.js +1 -0
  154. package/server/lib/opencode/plugins.js +1 -1
  155. package/server/lib/opencode/plugins.test.js +3 -2
  156. package/server/lib/opencode/proxy.js +29 -4
  157. package/server/lib/opencode/proxy.test.js +85 -1
  158. package/server/lib/opencode/server-utils-runtime.js +2 -0
  159. package/server/lib/opencode/settings-runtime.js +8 -6
  160. package/server/lib/opencode/settings-runtime.test.js +44 -0
  161. package/server/lib/opencode/yuri-routes.js +1 -1
  162. package/server/lib/relay/DOCUMENTATION.md +1 -1
  163. package/server/lib/relay/host-client.js +3 -1
  164. package/server/lib/relay/host-client.test.js +1 -0
  165. package/server/lib/relay/reasoning-projection.e2e.test.ts +1 -0
  166. package/server/lib/relay/relay-server.e2e.test.ts +32 -17
  167. package/server/lib/relay/service.js +2 -0
  168. package/server/lib/relay/tunnel-host.js +26 -1
  169. package/server/lib/relay/tunnel-host.test.js +27 -3
  170. package/server/lib/remote-desktop/runtime.test.js +2 -2
  171. package/server/lib/ui-auth/DOCUMENTATION.md +3 -0
  172. package/server/lib/ui-auth/ui-auth.js +27 -0
  173. package/server/lib/ui-auth/ui-auth.test.js +42 -1
  174. package/server/plugin-gui-proxy.test.js +1 -1
  175. package/dist/assets/AssistantContactStatus-DZGGspw4.js +0 -3
  176. package/dist/assets/Icon-Bh3TaKoN.js +0 -1
  177. package/dist/assets/MarkdownRenderer-CS6Pia5D.js +0 -2
  178. package/dist/assets/MarkdownRendererImpl-Bdwe3qUr.js +0 -10
  179. package/dist/assets/MarkstreamRendererImpl-CCQj9IkL.js +0 -3
  180. package/dist/assets/MobileTabPageHeader-CptcDWNS.js +0 -2
  181. package/dist/assets/SettingsView-CkJpYIMe.js +0 -29
  182. package/dist/assets/SetupTourDialog-BcEbaEO3.js +0 -1
  183. package/dist/assets/SetupTourDialog-CUzqT2sw.css +0 -1
  184. package/dist/assets/YuriWordmark-Cr1vkcue.js +0 -1
  185. package/dist/assets/desktopHosts-CMglnUdS.js +0 -1
  186. package/dist/assets/host-CBfSyi4l.js +0 -1
  187. package/dist/assets/insertionBoundaries-CgYf6gys.js +0 -1
  188. package/dist/assets/main-B8FcBwPM.js +0 -169
  189. package/dist/assets/main-DrqtyqDc.js +0 -2
  190. package/dist/assets/miniChat-CgeCl4RY.js +0 -2
  191. package/dist/assets/mobile-DAhJKHUq.js +0 -2
  192. package/dist/assets/multirun-BbWnHeaY.js +0 -3
  193. package/dist/assets/pwa-Dm_DJEr9.js +0 -2
  194. package/dist/assets/react-Bwr5-XPi.js +0 -1
  195. package/dist/assets/runtimeEndpointReset-DGxT24oE.js +0 -149
  196. package/dist/assets/sessionLookup-DGNxfDsP.js +0 -1
  197. package/dist/assets/src-PTWgTO6W.css +0 -2
  198. package/dist/assets/tour-Db44qwfs.js +0 -1
  199. package/dist/assets/types-Cl7nTpsb.js +0 -2
  200. package/dist/assets/useDesktopWindowControlsLayout-CdUr9mCZ.js +0 -1
  201. package/dist/assets/usePluginsStore-aZl0WTK8.js +0 -1
@@ -0,0 +1,48 @@
1
+ import { createHistoryImportService } from './service.js';
2
+ import { hasPreviewProxyCredential } from '../opencode/core-routes.js';
3
+
4
+ export function registerHistoryImportRoutes(app, { express, uiAuthController, service: provided, ...dependencies }) {
5
+ const service = provided ?? createHistoryImportService(dependencies);
6
+ // All routes inherit the Host UI/client authentication gate. Plans and jobs
7
+ // additionally belong to the authenticated device (or the local owner UI).
8
+ const owner = async (req, res) => {
9
+ if (hasPreviewProxyCredential(req)) throw Object.assign(new Error('forbidden'), { code: 'forbidden' });
10
+ const context = await uiAuthController?.resolveAuthContext(req, res, { allowUrlToken: false });
11
+ if (!context || context.type === 'client' && !context.clientId) throw Object.assign(new Error('authentication_required'), { code: 'authentication_required' });
12
+ return context.type === 'client' ? `client:${context.clientId}` : 'owner';
13
+ };
14
+ const handle = (operation) => async (req, res) => {
15
+ res.setHeader('Cache-Control', 'no-store');
16
+ try { res.json(await operation(req, await owner(req, res))); }
17
+ catch (error) {
18
+ const code = typeof error?.code === 'string' && /^[a-z_]+$/.test(error.code) ? error.code : 'import_failed';
19
+ const status = code === 'authentication_required' ? 401 : code === 'forbidden' ? 403 : ['import_busy', 'plan_expired', 'source_changed', 'target_changed'].includes(code) ? 409
20
+ : ['source_too_large', 'settings_too_large', 'too_many_files', 'too_many_sessions'].includes(code) ? 413
21
+ : code === 'import_failed' ? 500 : 400;
22
+ res.status(status).json({ code });
23
+ }
24
+ };
25
+ const json = express.json({ limit: '2mb' });
26
+ app.post('/api/yuri/history-import/scan', json, handle((req, actor) => service.scan(req.body ?? {}, actor)));
27
+ app.post('/api/yuri/history-import/imported', json, handle((req, actor) => service.imported(req.body ?? {}, actor)));
28
+ app.post('/api/yuri/history-import/preview', json, handle((req, actor) => service.preview(req.body ?? {}, actor)));
29
+ app.post('/api/yuri/history-import/start', json, handle((req, actor) => service.start(req.body ?? {}, actor)));
30
+ app.post('/api/yuri/history-import/resume', json, handle((req, actor) => {
31
+ const origin = req.headers.origin;
32
+ if (actor === 'owner' && (req.headers['sec-fetch-site'] === 'cross-site' || origin && origin !== `${req.protocol}://${req.get('host')}`)) {
33
+ throw Object.assign(new Error('forbidden'), { code: 'forbidden' });
34
+ }
35
+ return service.resume(req.body ?? {}, actor);
36
+ }));
37
+ app.post('/api/yuri/history-import/dismiss', json, handle((req, actor) => {
38
+ const origin = req.headers.origin;
39
+ if (actor === 'owner' && (req.headers['sec-fetch-site'] === 'cross-site' || origin && origin !== `${req.protocol}://${req.get('host')}`)) {
40
+ throw Object.assign(new Error('forbidden'), { code: 'forbidden' });
41
+ }
42
+ return service.dismiss(req.body ?? {}, actor);
43
+ }));
44
+ app.get('/api/yuri/history-import/jobs', handle((_req, actor) => service.jobs(actor)));
45
+ app.get('/api/yuri/history-import/job', handle((req, actor) => service.status(typeof req.query.id === 'string' ? req.query.id : undefined, actor)));
46
+ app.post('/api/yuri/history-import/cancel', json, handle((req, actor) => service.cancel(req.body?.id, actor)));
47
+ return service;
48
+ }
@@ -0,0 +1,55 @@
1
+ import express from 'express';
2
+ import request from 'supertest';
3
+ import { expect, test, vi } from 'vitest';
4
+ import { registerHistoryImportRoutes } from './routes.js';
5
+
6
+ const setup = (context = { type: 'client', clientId: 'device' }) => {
7
+ const app = express();
8
+ const service = { scan: vi.fn(async () => ({ sessions: [] })), imported: vi.fn(async () => ({ states: {} })), preview: vi.fn(), start: vi.fn(), resume: vi.fn(async () => ({ id: 'job' })), dismiss: vi.fn(() => ({ id: 'job' })), jobs: vi.fn(() => []), status: vi.fn(), cancel: vi.fn() };
9
+ const resolveAuthContext = vi.fn(async () => context);
10
+ registerHistoryImportRoutes(app, { express, service, uiAuthController: { resolveAuthContext } });
11
+ return { app, service, resolveAuthContext };
12
+ };
13
+ test('owned routes parse their own body, prohibit URL-token auth and scope requests to the authenticated device', async () => {
14
+ const { app, service, resolveAuthContext } = setup();
15
+ const response = await request(app).post('/api/yuri/history-import/scan').send({ sources: ['claude'] });
16
+ expect(response.status).toBe(200); expect(response.headers['cache-control']).toBe('no-store');
17
+ expect(service.scan).toHaveBeenCalledWith({ sources: ['claude'] }, 'client:device');
18
+ expect(resolveAuthContext.mock.calls[0][2]).toEqual({ allowUrlToken: false });
19
+ const badges = await request(app).post('/api/yuri/history-import/imported').send({ scanID: 'scan', directory: '/workspace' });
20
+ expect(badges.status).toBe(200); expect(badges.headers['cache-control']).toBe('no-store');
21
+ expect(service.imported).toHaveBeenCalledWith({ scanID: 'scan', directory: '/workspace' }, 'client:device');
22
+ expect((await request(app).get('/api/yuri/history-import/jobs')).body).toEqual([]);
23
+ expect(service.jobs).toHaveBeenCalledWith('client:device');
24
+ expect((await request(app).post('/api/yuri/history-import/resume').send({ id: 'job', confirm: true })).body).toEqual({ id: 'job' });
25
+ expect(service.resume).toHaveBeenCalledWith({ id: 'job', confirm: true }, 'client:device');
26
+ expect((await request(app).post('/api/yuri/history-import/dismiss').send({ id: 'job' })).body).toEqual({ id: 'job' });
27
+ expect(service.dismiss).toHaveBeenCalledWith({ id: 'job' }, 'client:device');
28
+ });
29
+ test('unauthenticated requests do not invoke the importer', async () => {
30
+ const { app, service } = setup(null);
31
+ expect((await request(app).post('/api/yuri/history-import/scan').send({})).status).toBe(401);
32
+ expect(service.scan).not.toHaveBeenCalled();
33
+ expect((await request(app).post('/api/yuri/history-import/resume').send({ id: 'job', confirm: true })).status).toBe(401);
34
+ expect((await request(app).get('/api/yuri/history-import/jobs')).status).toBe(401);
35
+ expect(service.resume).not.toHaveBeenCalled();
36
+ expect((await request(app).post('/api/yuri/history-import/dismiss').send({ id: 'job' })).status).toBe(401);
37
+ expect(service.dismiss).not.toHaveBeenCalled();
38
+ });
39
+ test('preview credentials cannot enumerate jobs or resume an import even with an owner cookie', async () => {
40
+ const { app, service } = setup({ type: 'session' });
41
+ expect((await request(app).get('/api/yuri/history-import/jobs?yuri_preview_token=preview')).status).toBe(403);
42
+ expect((await request(app).post('/api/yuri/history-import/resume').set('Cookie', 'yuri_preview_token=preview').send({ id: 'job', confirm: true })).status).toBe(403);
43
+ expect((await request(app).post('/api/yuri/history-import/resume').set('Origin', 'https://other.example').send({ id: 'job', confirm: true })).status).toBe(403);
44
+ expect(service.jobs).not.toHaveBeenCalled(); expect(service.resume).not.toHaveBeenCalled();
45
+ expect((await request(app).post('/api/yuri/history-import/dismiss').set('Origin', 'https://other.example').send({ id: 'job' })).status).toBe(403);
46
+ expect(service.dismiss).not.toHaveBeenCalled();
47
+ });
48
+ test('errors expose only stable codes, never upstream bodies or file contents', async () => {
49
+ const { app, service } = setup();
50
+ service.scan.mockRejectedValue(new Error('private content must never be returned'));
51
+ const response = await request(app).post('/api/yuri/history-import/scan').send({});
52
+ expect(response.status).toBe(500); expect(response.body).toEqual({ code: 'import_failed' });
53
+ service.scan.mockRejectedValue(Object.assign(new Error('private'), { code: 'source_changed' }));
54
+ expect((await request(app).post('/api/yuri/history-import/scan').send({})).status).toBe(409);
55
+ });
@@ -0,0 +1,374 @@
1
+ import path from 'node:path';
2
+ import { randomUUID } from 'node:crypto';
3
+ import { setImmediate } from 'node:timers/promises';
4
+ import { digest, fail, combineSessions, toNativeTransfer } from './events.js';
5
+ import { discoverSources, readSource } from './sources.js';
6
+ import { planSettings, applySettings, settingsConfigFingerprint } from './settings.js';
7
+ import { createImportStore } from './store.js';
8
+ import { detectSourceInstallations } from './installations.js';
9
+ import { ensureImportDirectory, resolveImportDirectory } from './targets.js';
10
+ import { discoverNative, nativeRevision } from './native.js';
11
+
12
+ const TTL = 30 * 60 * 1000;
13
+ const errorCode = (error) => typeof error?.code === 'string' && /^[a-z_]+$/.test(error.code) ? error.code : 'import_failed';
14
+ const same = (left, right) => JSON.stringify(left) === JSON.stringify(right);
15
+ const notFound = (error) => error?.status === 404 || error?.response?.status === 404
16
+ || error?._tag === 'SessionNotFoundError' || error?._tag === 'Session.NotFoundError';
17
+ const sourceKinds = ['claude', 'codex', 'cursor', 'dsh', 'opencode'];
18
+ const sourceKey = (item) => `${item.source}:${item.namespace}:${item.id}`;
19
+ const targetID = (items, parentID, merge = false) => `ses_${digest({ version: 1, mode: merge ? 'merge' : 'separate', parentID, sources: items.map(({ source, namespace, id, hash, directory }) => ({ source, namespace, id, hash, directory })) }).slice(0, 32)}`;
20
+ const provenanceFor = (group, merge = false) => ({ version: 1, mode: merge ? 'merge' : 'separate', usage: 'unknown', sources: group.map(({ source, namespace, id, hash }) => ({ source, namespace, id, hash })) });
21
+
22
+ export function createHistoryImportService({ dataDir, createClient, getRuntimeIdentity, registerProject,
23
+ onImported = () => {}, discover = discoverSources, detect = detectSourceInstallations, read = readSource, defaults, store: suppliedStore }) {
24
+ const scans = new Map(); const plans = new Map();
25
+ let active; let running; let scanning = false; let store = suppliedStore;
26
+ const receipts = () => store ??= createImportStore(path.join(dataDir, 'history-import.sqlite'));
27
+ const identity = () => digest(getRuntimeIdentity());
28
+ const prune = (map) => { for (const [id, entry] of map) if (entry.expires < Date.now()) map.delete(id); };
29
+ const remember = (map, entry) => {
30
+ prune(map); if (map.size >= 8) fail('too_many_plans');
31
+ const id = randomUUID(); map.set(id, { ...entry, expires: Date.now() + TTL }); return id;
32
+ };
33
+ const owned = (map, id, owner) => {
34
+ prune(map); const item = map.get(id);
35
+ if (!item || item.owner !== owner || item.runtime !== identity()) fail('plan_expired');
36
+ return item;
37
+ };
38
+ const targetDirectory = resolveImportDirectory;
39
+ const discoverAll = async (input = {}) => {
40
+ const sources = input.sources ?? sourceKinds;
41
+ if (!Array.isArray(sources) || !sources.length || sources.some((source) => !sourceKinds.includes(source))) fail('invalid_source');
42
+ if (input.limitPerSource !== undefined && (!Number.isInteger(input.limitPerSource) || input.limitPerSource < 1 || input.limitPerSource > 10)) fail('invalid_preview_limit');
43
+ if (input.includeCounts !== undefined && typeof input.includeCounts !== 'boolean') fail('invalid_source');
44
+ if (input.roots !== undefined && (!Array.isArray(input.roots) || input.roots.length > 16
45
+ || input.roots.some((root) => !sourceKinds.includes(root.source) || root.source === 'opencode' || typeof root.path !== 'string' || !path.isAbsolute(root.path)))) fail('invalid_source');
46
+ const external = sources.filter((source) => source !== 'opencode');
47
+ const result = external.length ? await discover({ ...input, sources: external }, defaults) : { sessions: [], errors: [], descriptors: new Map() };
48
+ if (!sources.includes('opencode')) return result;
49
+ const native = await discoverNative(createClient(), identity(), input);
50
+ const combined = [...result.sessions, ...native.sessions];
51
+ const sessions = combined.slice(0, 5000); const keys = new Set(sessions.map((session) => session.key));
52
+ const overflow = [...new Set(combined.slice(5000).map((session) => session.source))].map((source) => ({ source, code: 'too_many_sessions' }));
53
+ return { sessions, errors: [...result.errors, ...native.errors, ...overflow],
54
+ descriptors: new Map([...result.descriptors, ...native.descriptors].filter(([key]) => keys.has(key))), counts: input.includeCounts ? { ...result.counts, ...native.counts } : undefined };
55
+ };
56
+ const readRecord = async (descriptor) => {
57
+ if (descriptor.source !== 'opencode') return read(descriptor);
58
+ const info = await createClient().session.get({ sessionID: descriptor.sessionID }, { signal: AbortSignal.timeout(10000) });
59
+ if (info.id !== descriptor.sessionID) fail('session_conflict');
60
+ return { ...nativeRevision(info, descriptor.namespace), title: info.title || info.id, events: [], warnings: [], descriptor, native: info };
61
+ };
62
+ const scan = async (input, owner) => {
63
+ if (scanning || active) fail('import_busy');
64
+ scanning = true; const runtime = identity();
65
+ try {
66
+ const result = await discoverAll(input);
67
+ const installations = await detect((input?.sources ?? sourceKinds).filter((source) => source !== 'opencode'));
68
+ if ((input?.sources ?? sourceKinds).includes('opencode')) installations.opencode = result.errors.some((error) => error.source === 'opencode') ? null : true;
69
+ if (runtime !== identity()) fail('runtime_changed');
70
+ const sampled = input?.limitPerSource !== undefined;
71
+ const id = remember(scans, { owner, runtime, sampled, descriptors: result.descriptors });
72
+ return { id, host: true, sampled, installations, counts: result.counts, sessions: result.sessions, errors: result.errors };
73
+ } finally { scanning = false; }
74
+ };
75
+ const imported = async (input, owner) => {
76
+ const source = owned(scans, input.scanID, owner);
77
+ if (!source.sampled) fail('incomplete_scan');
78
+ const revisions = [...source.descriptors].map(([key, descriptor]) => ({ key, ...descriptor.revision })).filter((item) => item.id);
79
+ if (revisions.length > 50) fail('invalid_selection');
80
+ const bySource = new Map(revisions.map((item) => [sourceKey(item), item]));
81
+ const resolved = new Map();
82
+ const resolve = async (item, visiting = new Set()) => {
83
+ if (resolved.has(item.key)) return resolved.get(item.key);
84
+ if (visiting.has(item.key)) return null;
85
+ visiting.add(item.key);
86
+ const directory = await targetDirectory(item.directory || input.directory || '', true);
87
+ let parentID;
88
+ if (item.parentID) {
89
+ const parent = bySource.get(`${item.source}:${item.namespace}:${item.parentID}`);
90
+ if (!parent) return null;
91
+ const resolvedParent = await resolve(parent, visiting);
92
+ if (!resolvedParent) return null;
93
+ parentID = resolvedParent.sessionID;
94
+ }
95
+ const normalized = { ...item, directory };
96
+ const result = { directory, sessionID: item.source === 'opencode' ? item.id : targetID([normalized], parentID), provenance: provenanceFor([item]) };
97
+ resolved.set(item.key, result); return result;
98
+ };
99
+ const states = {}; const pending = [...revisions]; const client = createClient(); const signal = AbortSignal.timeout(5000);
100
+ await Promise.all(Array.from({ length: 4 }, async () => {
101
+ while (pending.length) {
102
+ const item = pending.shift(); states[item.key] = 'unknown';
103
+ if (signal.aborted || source.runtime !== identity()) continue;
104
+ try {
105
+ const expected = await resolve(item);
106
+ if (!expected) continue;
107
+ const existing = await client.session.get({ sessionID: expected.sessionID }, { signal });
108
+ if (existing.id === expected.sessionID && existing.location?.directory === expected.directory
109
+ && (item.source === 'opencode' || same(existing.metadata?.historyImport, expected.provenance))) states[item.key] = 'imported';
110
+ } catch (error) { if (notFound(error)) states[item.key] = 'available'; }
111
+ }
112
+ }));
113
+ if (source.runtime !== identity()) fail('runtime_changed');
114
+ return { states };
115
+ };
116
+ const prepare = async (input, owner, progress) => {
117
+ const source = owned(scans, input.scanID, owner);
118
+ if (source.sampled) fail('incomplete_scan');
119
+ if (!Array.isArray(input.sessions) || !input.sessions.length || input.sessions.length > 5000
120
+ || new Set(input.sessions.map((item) => item.key)).size !== input.sessions.length) fail('invalid_selection');
121
+ const selected = []; const settings = []; const configHashes = {}; const settingsSeen = new Set(); const failures = [];
122
+ for (const item of input.sessions) {
123
+ if (progress && !progress.valid()) fail('runtime_changed');
124
+ try {
125
+ const descriptor = source.descriptors.get(item.key);
126
+ if (!descriptor) fail('invalid_selection');
127
+ const directory = await targetDirectory(item.directory, true);
128
+ const session = await readRecord(descriptor);
129
+ const settingKey = `${session.source}:${session.directory}:${directory}`;
130
+ if (session.source === 'opencode' && directory !== session.directory) fail('invalid_target');
131
+ if (session.source !== 'opencode' && input.settings === true && !settingsSeen.has(settingKey)) {
132
+ settingsSeen.add(settingKey);
133
+ try {
134
+ const additions = await planSettings(session.source, session.directory, directory);
135
+ if (settings.length + additions.length > 200 || [...settings, ...additions].reduce((bytes, rule) => bytes + Buffer.byteLength(rule.content), 0) > 4 * 1024 * 1024) fail('settings_too_large');
136
+ const fingerprint = await settingsConfigFingerprint(directory);
137
+ settings.push(...additions); configHashes[directory] = fingerprint;
138
+ } catch (error) {
139
+ if (!progress) throw error;
140
+ failures.push({ key: `settings-${digest(settingKey)}`, phase: 'settings', status: 'failed', code: errorCode(error) });
141
+ }
142
+ }
143
+ selected.push({ key: item.key, descriptor, hash: session.hash, id: session.id, source: session.source,
144
+ namespace: session.namespace, parentID: session.parentID, directory, title: session.title,
145
+ messages: session.events.length, warnings: session.warnings });
146
+ } catch (error) {
147
+ if (!progress) throw error;
148
+ failures.push({ key: item.key, phase: 'validation', status: 'failed', code: errorCode(error) });
149
+ }
150
+ progress?.advance();
151
+ await setImmediate();
152
+ }
153
+ if (input.merge === true && (selected.some((item) => item.source === 'opencode') || selected.length < 2 || new Set(selected.map((item) => item.directory)).size !== 1)) fail('invalid_merge');
154
+ if (source.runtime !== identity()) fail('runtime_changed');
155
+ const selectedIDs = new Set(selected.map((item) => `${item.source}:${item.namespace}:${item.id}`));
156
+ if (selectedIDs.size !== selected.length) fail('invalid_selection');
157
+ for (const item of selected) if (item.parentID && !selectedIDs.has(`${item.source}:${item.namespace}:${item.parentID}`)) item.warnings = [...item.warnings, 'parent_detached'];
158
+ const id = remember(plans, { owner, runtime: source.runtime, selected, settings, configHashes, failures, merge: input.merge === true });
159
+ return { id, merge: input.merge === true, sessions: selected.map(({ descriptor: _, namespace: _namespace, ...item }) => item),
160
+ settings: settings.map(({ sourceDirectory: _, ...item }) => item), expires: Date.now() + TTL };
161
+ };
162
+ const preview = (input, owner) => prepare(input, owner);
163
+
164
+ // A deterministic target ID plus provenance verification makes retries safe
165
+ // after timeout, process restart, and a receipt write failure. 409 alone is not
166
+ // treated as success. No append/overwrite API or prompt execution is used.
167
+ const importOne = async (client, transfer, provenance) => {
168
+ const verify = (existing) => {
169
+ if (existing.id !== transfer.info.id || !same(existing.metadata?.historyImport, provenance) || existing.location?.directory !== transfer.location.directory) fail('session_conflict');
170
+ return existing;
171
+ };
172
+ try { return { session: verify(await client.session.get({ sessionID: transfer.info.id }, { signal: AbortSignal.timeout(30000) })), status: 'skipped' }; }
173
+ catch (error) { if (!notFound(error)) throw error; }
174
+ try {
175
+ await client.session.import(transfer, { signal: AbortSignal.timeout(60000) });
176
+ return { session: verify(await client.session.get({ sessionID: transfer.info.id }, { signal: AbortSignal.timeout(30000) })), status: 'imported' };
177
+ }
178
+ catch (error) {
179
+ // A response may be lost after commit. Recover only by exact authority.
180
+ try { return { session: verify(await client.session.get({ sessionID: transfer.info.id }, { signal: AbortSignal.timeout(30000) })), status: 'skipped' }; }
181
+ catch (verification) { if (verification?.code === 'session_conflict') throw verification; throw error; }
182
+ }
183
+ };
184
+ const run = async (job, plan, decisions) => {
185
+ let position = 0; let failed = false;
186
+ const record = (result) => {
187
+ receipts().append(job.id, position++, result); if (result.status === 'failed') failed = true;
188
+ receipts().progress(job.id, { phase: 'importing', completed: position, total: job.total });
189
+ };
190
+ const valid = () => !job.cancelled && plan.runtime === identity();
191
+ const mapID = new Map(); const successful = new Set(); const registered = new Set();
192
+ const pending = [...plan.selected]; const ordered = []; const visited = new Set(); const blocked = new Map();
193
+ const bySource = new Map(pending.map((item) => [sourceKey(item), item]));
194
+ const visit = (item) => {
195
+ const chain = []; const positions = new Map(); let current = item;
196
+ while (current && !visited.has(sourceKey(current))) {
197
+ const key = sourceKey(current);
198
+ if (positions.has(key)) {
199
+ for (const cyclic of chain.slice(positions.get(key))) blocked.set(sourceKey(cyclic), 'invalid_parent_graph');
200
+ break;
201
+ }
202
+ positions.set(key, chain.length); chain.push(current);
203
+ current = bySource.get(`${current.source}:${current.namespace}:${current.parentID}`);
204
+ }
205
+ for (const entry of chain.reverse()) {
206
+ const key = sourceKey(entry); const parentKey = `${entry.source}:${entry.namespace}:${entry.parentID}`;
207
+ if (!blocked.has(key) && blocked.has(parentKey)) blocked.set(key, 'parent_failed');
208
+ if (!blocked.has(key)) ordered.push(entry);
209
+ visited.add(key);
210
+ }
211
+ };
212
+ try {
213
+ for (const failure of plan.failures ?? []) record(failure);
214
+ if (plan.merge) ordered.push(...pending);
215
+ else for (const item of pending) visit(item);
216
+ for (const item of pending) if (blocked.has(sourceKey(item))) record({ key: item.key, phase: 'session', status: 'failed', code: blocked.get(sourceKey(item)) });
217
+ for (const item of ordered) mapID.set(sourceKey(item), item.source === 'opencode' ? item.id : targetID([item], mapID.get(`${item.source}:${item.namespace}:${item.parentID}`)));
218
+ const client = createClient();
219
+ const groups = plan.merge ? [plan.selected] : ordered.map((item) => [item]);
220
+ for (const group of groups) {
221
+ if (!valid()) break;
222
+ const item = group[0]; const key = group.map((entry) => entry.key).join(':');
223
+ const parentKey = `${item.source}:${item.namespace}:${item.parentID}`;
224
+ const parentID = !plan.merge && mapID.has(parentKey) ? mapID.get(parentKey) : undefined;
225
+ const sessionID = item.source === 'opencode' ? item.id : targetID(group, parentID, plan.merge);
226
+ try {
227
+ const sessions = [];
228
+ for (const entry of group) {
229
+ const session = await readRecord(entry.descriptor);
230
+ if (session.hash !== entry.hash) fail('source_changed');
231
+ if (await targetDirectory(entry.directory, true) !== entry.directory) fail('target_changed');
232
+ sessions.push(session);
233
+ }
234
+ if (parentID && !successful.has(parentKey)) fail('parent_failed');
235
+ if (!valid()) break;
236
+ if (item.source === 'opencode') {
237
+ await targetDirectory(item.directory, false);
238
+ if (!valid()) break;
239
+ if (!registered.has(item.directory)) { await registerProject({ path: item.directory }); registered.add(item.directory); }
240
+ if (!valid()) break;
241
+ let index = 'refreshed';
242
+ try { await onImported(sessions[0].native); } catch { index = 'failed'; }
243
+ successful.add(sourceKey(item));
244
+ record({ key, phase: 'session', sessionID, directory: item.directory, status: 'skipped', project: 'registered', index });
245
+ if (index === 'failed') failed = true;
246
+ continue;
247
+ }
248
+ const provenance = provenanceFor(group, plan.merge);
249
+ const session = plan.merge ? { title: sessions.map((entry) => entry.title).join(' + ').slice(0, 200), events: combineSessions(sessions) } : sessions[0];
250
+ const transfer = toNativeTransfer(session, item.directory, sessionID, provenance, parentID);
251
+ await ensureImportDirectory(item.directory);
252
+ if (!valid()) break;
253
+ if (!registered.has(item.directory)) { await registerProject({ path: item.directory }); registered.add(item.directory); }
254
+ if (!valid()) break;
255
+ const result = await importOne(client, transfer, provenance);
256
+ successful.add(sourceKey(item));
257
+ const project = 'registered'; let index = 'refreshed';
258
+ try { if (valid()) await onImported(result.session); } catch { index = 'failed'; }
259
+ record({ key, phase: 'session', sessionID, directory: item.directory, status: result.status, project, index });
260
+ if (project === 'failed' || index === 'failed') failed = true;
261
+ } catch (error) { record({ key, phase: 'session', sessionID, status: 'failed', code: errorCode(error) }); }
262
+ await setImmediate();
263
+ }
264
+ const hashes = { ...plan.configHashes };
265
+ for (const item of plan.settings) {
266
+ if (!valid()) break;
267
+ try {
268
+ if (!registered.has(item.directory)) fail('project_unavailable');
269
+ const result = await applySettings(item, decisions[item.key] ?? 'keep', hashes[item.directory]);
270
+ hashes[item.directory] = result.configHash ?? hashes[item.directory];
271
+ record({ key: item.key, phase: 'settings', status: result.status, target: item.target });
272
+ } catch (error) { record({ key: item.key, phase: 'settings', status: 'failed', code: errorCode(error) }); }
273
+ }
274
+ receipts().finish(job.id, !valid() ? job.cancelled ? 'cancelled' : 'interrupted' : failed ? 'partial' : 'completed');
275
+ } catch (error) {
276
+ const progress = receipts().get(job.id, job.owner, job.runtime)?.progress;
277
+ receipts().progress(job.id, { ...(progress ?? { phase: 'importing', completed: position, total: job.total }), code: errorCode(error) });
278
+ receipts().finish(job.id, 'interrupted');
279
+ } finally { if (active === job) active = undefined; }
280
+ };
281
+ const runSources = async (job, input) => {
282
+ const valid = () => !job.cancelled && job.runtime === identity();
283
+ let scanID; let planID;
284
+ try {
285
+ receipts().progress(job.id, { phase: 'scanning', completed: 0, total: 0 });
286
+ const found = await discoverAll({ sources: input.sources });
287
+ if (!valid()) { receipts().finish(job.id, job.cancelled ? 'cancelled' : 'interrupted'); return; }
288
+ let completed = 0;
289
+ const total = found.sessions.length;
290
+ receipts().progress(job.id, { phase: 'validating', completed, total });
291
+ scanID = remember(scans, { owner: job.owner, runtime: job.runtime, sampled: false, descriptors: found.descriptors });
292
+ const prepared = total ? await prepare({ scanID, sessions: found.sessions.map((session) => ({ key: session.key, directory: session.directory || input.directory || '' })), settings: false, merge: false }, job.owner, {
293
+ valid, advance: () => receipts().progress(job.id, { phase: 'validating', completed: ++completed, total }),
294
+ }) : null;
295
+ planID = prepared?.id;
296
+ if (!valid()) { receipts().finish(job.id, job.cancelled ? 'cancelled' : 'interrupted'); return; }
297
+ const plan = prepared ? owned(plans, prepared.id, job.owner) : { runtime: job.runtime, selected: [], settings: [], configHashes: {}, failures: [], merge: false };
298
+ plan.failures.push(...found.errors.map((error, index) => ({ key: `scan-${index}`, phase: 'scan', status: 'failed', code: error.code })));
299
+ job.total = plan.selected.length + plan.settings.length + plan.failures.length;
300
+ receipts().progress(job.id, { phase: 'importing', completed: 0, total: job.total }, job.total);
301
+ await run(job, plan, {});
302
+ } catch (error) {
303
+ const progress = receipts().get(job.id, job.owner, job.runtime)?.progress;
304
+ receipts().progress(job.id, { ...(progress ?? { phase: 'scanning', completed: 0, total: 0 }), code: errorCode(error) });
305
+ receipts().finish(job.id, !valid() ? job.cancelled ? 'cancelled' : 'interrupted' : 'partial');
306
+ } finally {
307
+ scans.delete(scanID); plans.delete(planID);
308
+ if (active === job) active = undefined;
309
+ }
310
+ };
311
+ const start = async (input, owner) => {
312
+ if (input.confirm !== true) fail('confirmation_required');
313
+ if (input.sources !== undefined) {
314
+ if (!Array.isArray(input.sources) || !input.sources.length || new Set(input.sources).size !== input.sources.length
315
+ || input.sources.some((source) => !sourceKinds.includes(source))) fail('invalid_source');
316
+ if (input.directory != null && (typeof input.directory !== 'string' || !path.isAbsolute(input.directory) || input.directory.length > 4096)) fail('invalid_target');
317
+ if (active || scanning) fail('import_busy');
318
+ const job = { id: randomUUID(), owner, runtime: identity(), cancelled: false, total: 0 };
319
+ const request = { sources: [...input.sources], directory: input.directory ?? null };
320
+ receipts().create(job.id, owner, job.runtime, 0, request); active = job;
321
+ running = runSources(job, request);
322
+ return receipts().get(job.id, owner, job.runtime);
323
+ }
324
+ const plan = owned(plans, input.planID, owner);
325
+ if (plan.jobID) return receipts().get(plan.jobID, owner, plan.runtime);
326
+ if (active) fail('import_busy');
327
+ const decisions = input.decisions ?? {};
328
+ if (!decisions || typeof decisions !== 'object' || Array.isArray(decisions)
329
+ || Object.entries(decisions).some(([key, value]) => !plan.settings.some((item) => item.key === key) || !['keep', 'replace', 'copy'].includes(value))) fail('invalid_selection');
330
+ const id = randomUUID(); const job = { id, owner, runtime: plan.runtime, cancelled: false, total: (plan.merge ? 1 : plan.selected.length) + plan.settings.length };
331
+ receipts().create(id, owner, plan.runtime, job.total);
332
+ plan.jobID = id; active = job;
333
+ // Host-owned work survives dialog dismissal. The persistent receipts expose
334
+ // partial/cancelled/interrupted runs; re-previewing safely retries them.
335
+ running = run(job, plan, decisions);
336
+ return receipts().get(id, owner, plan.runtime);
337
+ };
338
+ const resume = async (input, owner) => {
339
+ if (input.confirm !== true) fail('confirmation_required');
340
+ const runtime = identity(); const previous = receipts().get(input.id, owner, runtime);
341
+ if (!previous) fail('job_missing');
342
+ if (previous.dismissed) fail('job_dismissed');
343
+ if (['completed', 'partial'].includes(previous.state) || active?.id === input.id && active.owner === owner) return previous;
344
+ if (active || scanning) fail('import_busy');
345
+ const request = receipts().request(input.id, owner, runtime);
346
+ if (!request) fail('resume_request_missing');
347
+ if (!Array.isArray(request.sources) || !request.sources.length || new Set(request.sources).size !== request.sources.length
348
+ || request.sources.some((source) => !sourceKinds.includes(source))) fail('invalid_source');
349
+ if (request.directory != null && (typeof request.directory !== 'string' || !path.isAbsolute(request.directory) || request.directory.length > 4096)) fail('invalid_target');
350
+ const job = { id: previous.id, owner, runtime, cancelled: false, total: 0 };
351
+ receipts().restart(job.id, request); active = job;
352
+ running = runSources(job, request);
353
+ return receipts().get(job.id, owner, runtime);
354
+ };
355
+ return {
356
+ scan, imported, preview, start, resume,
357
+ jobs: (owner) => receipts().unfinished(owner, identity()),
358
+ dismiss: (input, owner) => {
359
+ const runtime = identity(); const job = receipts().get(input.id, owner, runtime);
360
+ if (!job) fail('job_missing');
361
+ if (job.state === 'running' || active?.id === job.id) fail('import_busy');
362
+ if (!receipts().dismiss(job.id, owner, runtime)) fail('import_busy');
363
+ return { id: job.id };
364
+ },
365
+ status: (id, owner) => id ? receipts().get(id, owner, identity()) : receipts().latest(owner, identity()),
366
+ cancel: (id, owner) => {
367
+ const status = receipts().get(id, owner, identity());
368
+ if (!status) fail('job_missing');
369
+ if (active?.id === id && active.owner === owner) active.cancelled = true;
370
+ return status;
371
+ },
372
+ close: async () => { if (active) active.cancelled = true; await running; store?.close(); },
373
+ };
374
+ }