host-execution-mcp 1.0.0

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 (126) hide show
  1. package/CHANGELOG.md +330 -0
  2. package/LICENSE +21 -0
  3. package/README.md +92 -0
  4. package/SECURITY.md +72 -0
  5. package/dist/access/docker-runtime.d.ts +38 -0
  6. package/dist/access/docker-runtime.js +61 -0
  7. package/dist/access/docker-runtime.js.map +1 -0
  8. package/dist/access/index.d.ts +110 -0
  9. package/dist/access/index.js +174 -0
  10. package/dist/access/index.js.map +1 -0
  11. package/dist/access/paradi-auth.d.ts +33 -0
  12. package/dist/access/paradi-auth.js +89 -0
  13. package/dist/access/paradi-auth.js.map +1 -0
  14. package/dist/access/paradi-transport.d.ts +10 -0
  15. package/dist/access/paradi-transport.js +39 -0
  16. package/dist/access/paradi-transport.js.map +1 -0
  17. package/dist/access/paradi-username.d.ts +5 -0
  18. package/dist/access/paradi-username.js +14 -0
  19. package/dist/access/paradi-username.js.map +1 -0
  20. package/dist/access/probe.d.ts +14 -0
  21. package/dist/access/probe.js +63 -0
  22. package/dist/access/probe.js.map +1 -0
  23. package/dist/access/session-pool.d.ts +25 -0
  24. package/dist/access/session-pool.js +46 -0
  25. package/dist/access/session-pool.js.map +1 -0
  26. package/dist/access/ssh-transport.d.ts +16 -0
  27. package/dist/access/ssh-transport.js +74 -0
  28. package/dist/access/ssh-transport.js.map +1 -0
  29. package/dist/access/types.d.ts +43 -0
  30. package/dist/access/types.js +21 -0
  31. package/dist/access/types.js.map +1 -0
  32. package/dist/config.d.ts +52 -0
  33. package/dist/config.js +179 -0
  34. package/dist/config.js.map +1 -0
  35. package/dist/index.d.ts +2 -0
  36. package/dist/index.js +19 -0
  37. package/dist/index.js.map +1 -0
  38. package/dist/instructions.d.ts +4 -0
  39. package/dist/instructions.js +93 -0
  40. package/dist/instructions.js.map +1 -0
  41. package/dist/kubectl/runner.d.ts +32 -0
  42. package/dist/kubectl/runner.js +79 -0
  43. package/dist/kubectl/runner.js.map +1 -0
  44. package/dist/server.d.ts +3 -0
  45. package/dist/server.js +24 -0
  46. package/dist/server.js.map +1 -0
  47. package/dist/ssh/access-client.d.ts +62 -0
  48. package/dist/ssh/access-client.js +470 -0
  49. package/dist/ssh/access-client.js.map +1 -0
  50. package/dist/ssh/access-errors.d.ts +53 -0
  51. package/dist/ssh/access-errors.js +180 -0
  52. package/dist/ssh/access-errors.js.map +1 -0
  53. package/dist/ssh/access-sftp.d.ts +14 -0
  54. package/dist/ssh/access-sftp.js +456 -0
  55. package/dist/ssh/access-sftp.js.map +1 -0
  56. package/dist/ssh/bastion-client.d.ts +60 -0
  57. package/dist/ssh/bastion-client.js +423 -0
  58. package/dist/ssh/bastion-client.js.map +1 -0
  59. package/dist/ssh/bastion-errors.d.ts +62 -0
  60. package/dist/ssh/bastion-errors.js +190 -0
  61. package/dist/ssh/bastion-errors.js.map +1 -0
  62. package/dist/ssh/hop1-sftp.d.ts +14 -0
  63. package/dist/ssh/hop1-sftp.js +437 -0
  64. package/dist/ssh/hop1-sftp.js.map +1 -0
  65. package/dist/tools/copy-job-schemas.d.ts +709 -0
  66. package/dist/tools/copy-job-schemas.js +48 -0
  67. package/dist/tools/copy-job-schemas.js.map +1 -0
  68. package/dist/tools/register.d.ts +14 -0
  69. package/dist/tools/register.js +619 -0
  70. package/dist/tools/register.js.map +1 -0
  71. package/dist/tools/remote-schemas.d.ts +879 -0
  72. package/dist/tools/remote-schemas.js +214 -0
  73. package/dist/tools/remote-schemas.js.map +1 -0
  74. package/dist/utils/copy-executor.d.ts +41 -0
  75. package/dist/utils/copy-executor.js +231 -0
  76. package/dist/utils/copy-executor.js.map +1 -0
  77. package/dist/utils/copy-job-manager.d.ts +34 -0
  78. package/dist/utils/copy-job-manager.js +400 -0
  79. package/dist/utils/copy-job-manager.js.map +1 -0
  80. package/dist/utils/copy-job-store.d.ts +18 -0
  81. package/dist/utils/copy-job-store.js +104 -0
  82. package/dist/utils/copy-job-store.js.map +1 -0
  83. package/dist/utils/copy-job-types.d.ts +133 -0
  84. package/dist/utils/copy-job-types.js +37 -0
  85. package/dist/utils/copy-job-types.js.map +1 -0
  86. package/dist/utils/copy-transfer.d.ts +59 -0
  87. package/dist/utils/copy-transfer.js +86 -0
  88. package/dist/utils/copy-transfer.js.map +1 -0
  89. package/dist/utils/remote-copy.d.ts +14 -0
  90. package/dist/utils/remote-copy.js +115 -0
  91. package/dist/utils/remote-copy.js.map +1 -0
  92. package/dist/utils/remote-executor.d.ts +15 -0
  93. package/dist/utils/remote-executor.js +34 -0
  94. package/dist/utils/remote-executor.js.map +1 -0
  95. package/dist/utils/remote-target.d.ts +22 -0
  96. package/dist/utils/remote-target.js +75 -0
  97. package/dist/utils/remote-target.js.map +1 -0
  98. package/dist/utils/result.d.ts +87 -0
  99. package/dist/utils/result.js +81 -0
  100. package/dist/utils/result.js.map +1 -0
  101. package/dist/utils/shell-quote.d.ts +22 -0
  102. package/dist/utils/shell-quote.js +55 -0
  103. package/dist/utils/shell-quote.js.map +1 -0
  104. package/dist/utils/timeout.d.ts +1 -0
  105. package/dist/utils/timeout.js +18 -0
  106. package/dist/utils/timeout.js.map +1 -0
  107. package/dist/utils/truncate.d.ts +5 -0
  108. package/dist/utils/truncate.js +12 -0
  109. package/dist/utils/truncate.js.map +1 -0
  110. package/dist/version.d.ts +1 -0
  111. package/dist/version.js +7 -0
  112. package/dist/version.js.map +1 -0
  113. package/docs/AGENT_GUIDE.md +161 -0
  114. package/docs/CONFIGURATION.md +130 -0
  115. package/docs/COPY_SPECIALIZED_TEST_CHECKLIST.md +9 -0
  116. package/docs/HOP1_E2E_CHECKLIST.md +128 -0
  117. package/docs/HOP1_E2E_RESULTS.json +647 -0
  118. package/docs/PARADI_ACCESS_PLAN.md +272 -0
  119. package/docs/REMOTE_COPY_JOB_API.md +92 -0
  120. package/docs/TODO.md +66 -0
  121. package/docs/USER_GUIDE.zh-CN.md +93 -0
  122. package/docs/clients/claude-desktop.json.example +12 -0
  123. package/docs/clients/cursor-npx.json.example +12 -0
  124. package/docs/clients/cursor.json.example +12 -0
  125. package/docs/clients/vscode.json.example +12 -0
  126. package/package.json +65 -0
@@ -0,0 +1,400 @@
1
+ import { bashSingleQuote } from "./shell-quote.js";
2
+ import { assertCopyEndpointsAllowed, executeRemoteCopy, } from "./copy-executor.js";
3
+ import { createTransferId, DEFAULT_PROGRESS_INTERVAL_MS } from "./copy-transfer.js";
4
+ import { engineProgressToJobProgress, isTerminalCopyJobStatus, } from "./copy-job-types.js";
5
+ import { CopyJobStore } from "./copy-job-store.js";
6
+ function nowIso() {
7
+ return new Date().toISOString();
8
+ }
9
+ /** Build a simple plan description for observability (engine still runs as one executeRemoteCopy). */
10
+ export function buildCopyPlan(source, dest) {
11
+ const src = source.target;
12
+ const dst = dest.target;
13
+ if ((src === "local" && dst === "landing") ||
14
+ (src === "landing" && dst === "local")) {
15
+ return [
16
+ {
17
+ index: 0,
18
+ kind: "sftp",
19
+ source,
20
+ dest,
21
+ status: "queued",
22
+ },
23
+ ];
24
+ }
25
+ if (src === "landing" && dst === "landing") {
26
+ return [{ index: 0, kind: "landing-cp", source, dest, status: "queued" }];
27
+ }
28
+ if ((src === "pod" && dst === "landing") ||
29
+ (src === "landing" && dst === "pod")) {
30
+ return [{ index: 0, kind: "kubectl", source, dest, status: "queued" }];
31
+ }
32
+ if ((src === "host" && dst === "landing") ||
33
+ (src === "landing" && dst === "host")) {
34
+ return [{ index: 0, kind: "scp", source, dest, status: "queued" }];
35
+ }
36
+ return [
37
+ {
38
+ index: 0,
39
+ kind: "pipeline",
40
+ source,
41
+ dest,
42
+ status: "queued",
43
+ },
44
+ ];
45
+ }
46
+ async function probeSourceSize(accessClient, source, timeoutMs) {
47
+ try {
48
+ if (source.target === "local") {
49
+ const { default: fs } = await import("node:fs/promises");
50
+ const st = await fs.stat(source.path);
51
+ return st.isFile() ? st.size : undefined;
52
+ }
53
+ if (source.target === "landing") {
54
+ const raw = await accessClient.exec(`stat -c%s ${bashSingleQuote(source.path)} 2>/dev/null || wc -c < ${bashSingleQuote(source.path)}`, timeoutMs);
55
+ const n = Number.parseInt(raw.stdout.trim(), 10);
56
+ return Number.isFinite(n) ? n : undefined;
57
+ }
58
+ if (source.target === "pod") {
59
+ const ns = source.namespace;
60
+ const pod = source.pod;
61
+ const c = source.container ? ` -c ${bashSingleQuote(source.container)}` : "";
62
+ const inner = `stat -c%s ${bashSingleQuote(source.path)} 2>/dev/null || wc -c < ${bashSingleQuote(source.path)}`;
63
+ const raw = await accessClient.exec(`kubectl exec -n ${bashSingleQuote(ns)} ${bashSingleQuote(pod)}${c} -- bash -lc ${bashSingleQuote(inner)}`, timeoutMs);
64
+ const n = Number.parseInt(raw.stdout.trim(), 10);
65
+ return Number.isFinite(n) ? n : undefined;
66
+ }
67
+ }
68
+ catch {
69
+ return undefined;
70
+ }
71
+ return undefined;
72
+ }
73
+ function estimateSeconds(sizeBytes) {
74
+ if (sizeBytes === undefined || sizeBytes <= 0) {
75
+ return undefined;
76
+ }
77
+ const bytesPerSec = 8 * 1024 * 1024;
78
+ return Math.max(5, Math.ceil(sizeBytes / bytesPerSec));
79
+ }
80
+ export class CopyJobManager {
81
+ deps;
82
+ store;
83
+ active = new Map();
84
+ executeCopy;
85
+ /** Resolves after orphan reconcile on startup. */
86
+ ready;
87
+ constructor(deps, store, executeCopy = executeRemoteCopy, options) {
88
+ this.deps = deps;
89
+ this.store = store ?? new CopyJobStore();
90
+ this.executeCopy = executeCopy;
91
+ this.ready =
92
+ options?.reconcileOnStart === false
93
+ ? Promise.resolve(0)
94
+ : this.reconcileOrphans();
95
+ }
96
+ get jobStorePath() {
97
+ return this.store.jobsDir;
98
+ }
99
+ /** Mark in-process jobs left as running/queued after MCP restart as failed. */
100
+ async reconcileOrphans() {
101
+ const ids = await this.store.listIds();
102
+ let count = 0;
103
+ for (const id of ids) {
104
+ try {
105
+ const updated = await this.store.update(id, (current) => {
106
+ if (isTerminalCopyJobStatus(current.status)) {
107
+ return current;
108
+ }
109
+ count += 1;
110
+ return {
111
+ ...current,
112
+ status: "failed",
113
+ error: "MCP restarted; in-process worker lost",
114
+ finishedAt: nowIso(),
115
+ plan: current.plan.map((h) => isTerminalCopyJobStatus(h.status) ? h : { ...h, status: "failed" }),
116
+ };
117
+ });
118
+ void updated;
119
+ }
120
+ catch {
121
+ // ignore corrupt/missing
122
+ }
123
+ }
124
+ return count;
125
+ }
126
+ async start(request) {
127
+ await this.ready;
128
+ // Fail before creating a job record (Paradi: target=host is not a second hop).
129
+ assertCopyEndpointsAllowed(this.deps.config, request.source, request.dest);
130
+ const transferId = createTransferId();
131
+ const createdAt = nowIso();
132
+ const totalTimeoutMs = request.totalTimeoutMs ?? request.timeoutMs ?? this.deps.config.defaultTimeoutMs;
133
+ const size = await probeSourceSize(this.deps.accessClient, request.source, Math.min(15_000, totalTimeoutMs));
134
+ const estimatedSeconds = estimateSeconds(size);
135
+ const record = {
136
+ transferId,
137
+ status: "queued",
138
+ source: request.source,
139
+ dest: request.dest,
140
+ options: {
141
+ skipIfComplete: request.skipIfComplete === true,
142
+ verify: request.verify ?? "size",
143
+ progressIntervalMs: request.progressIntervalMs ?? DEFAULT_PROGRESS_INTERVAL_MS,
144
+ totalTimeoutMs,
145
+ recursive: request.recursive ?? true,
146
+ },
147
+ plan: buildCopyPlan(request.source, request.dest),
148
+ progress: {
149
+ transferredBytes: 0,
150
+ totalBytes: size,
151
+ percent: 0,
152
+ },
153
+ estimatedSeconds,
154
+ createdAt,
155
+ updatedAt: createdAt,
156
+ };
157
+ await this.store.write(record);
158
+ const controller = new AbortController();
159
+ const promise = this.runJob(transferId, controller.signal);
160
+ this.active.set(transferId, { controller, promise });
161
+ void promise.finally(() => {
162
+ this.active.delete(transferId);
163
+ });
164
+ await this.store.update(transferId, (current) => {
165
+ if (isTerminalCopyJobStatus(current.status)) {
166
+ return current;
167
+ }
168
+ return {
169
+ ...current,
170
+ status: "running",
171
+ startedAt: nowIso(),
172
+ plan: current.plan.map((h) => isTerminalCopyJobStatus(h.status) ? h : { ...h, status: "running" }),
173
+ };
174
+ });
175
+ return {
176
+ transferId,
177
+ status: "running",
178
+ source: {
179
+ target: request.source.target,
180
+ path: request.source.path,
181
+ size,
182
+ },
183
+ dest: {
184
+ target: request.dest.target,
185
+ path: request.dest.path,
186
+ },
187
+ estimatedSeconds,
188
+ jobStorePath: this.store.jobPath(transferId),
189
+ message: "Copy job started in background. Do not block the chat waiting. Poll remote_copy_status with transferId, or inspect jobStorePath. Cancel aborts local↔landing SFTP promptly; kubectl/scp on landing is best-effort.",
190
+ createdAt,
191
+ };
192
+ }
193
+ async status(transferId) {
194
+ await this.ready;
195
+ const record = await this.store.read(transferId);
196
+ if (!record) {
197
+ throw new Error(`Unknown transferId: ${transferId}`);
198
+ }
199
+ return {
200
+ transferId: record.transferId,
201
+ status: record.status,
202
+ progress: record.progress,
203
+ source: { target: record.source.target, path: record.source.path },
204
+ dest: { target: record.dest.target, path: record.dest.path },
205
+ skippedBytes: record.progress.skippedBytes,
206
+ skipped: record.progress.skipped,
207
+ skipReason: record.progress.skipReason,
208
+ verified: record.verified,
209
+ speedBps: record.progress.speedBps,
210
+ etaSeconds: record.progress.etaSeconds ?? record.estimatedSeconds,
211
+ error: record.error,
212
+ createdAt: record.createdAt,
213
+ updatedAt: record.updatedAt,
214
+ finishedAt: record.finishedAt,
215
+ };
216
+ }
217
+ async cancel(transferId) {
218
+ await this.ready;
219
+ const record = await this.store.read(transferId);
220
+ if (!record) {
221
+ throw new Error(`Unknown transferId: ${transferId}`);
222
+ }
223
+ if (isTerminalCopyJobStatus(record.status)) {
224
+ return {
225
+ transferId,
226
+ status: record.status,
227
+ message: `Job already finished with status=${record.status}`,
228
+ };
229
+ }
230
+ const active = this.active.get(transferId);
231
+ active?.controller.abort();
232
+ const updated = await this.store.update(transferId, (current) => {
233
+ if (isTerminalCopyJobStatus(current.status)) {
234
+ return current;
235
+ }
236
+ return {
237
+ ...current,
238
+ status: "cancelled",
239
+ error: "Cancelled by remote_copy_cancel",
240
+ finishedAt: nowIso(),
241
+ plan: current.plan.map((h) => h.status === "running" || h.status === "queued"
242
+ ? { ...h, status: "cancelled" }
243
+ : h),
244
+ };
245
+ });
246
+ if (!isTerminalCopyJobStatus(updated.status)) {
247
+ // Should be unreachable after fence update
248
+ return {
249
+ transferId,
250
+ status: "cancelled",
251
+ message: `Cancel requested; Job file: ${this.store.jobPath(transferId)}`,
252
+ };
253
+ }
254
+ return {
255
+ transferId,
256
+ status: updated.status,
257
+ message: updated.status === "cancelled"
258
+ ? `Cancel requested; SFTP abort signaled (kubectl/scp best-effort). Job file: ${this.store.jobPath(transferId)}`
259
+ : `Job already finished with status=${updated.status}`,
260
+ };
261
+ }
262
+ async runJob(transferId, signal) {
263
+ const record = await this.store.read(transferId);
264
+ if (!record) {
265
+ return;
266
+ }
267
+ if (record.status === "cancelled" || signal.aborted) {
268
+ await this.store
269
+ .update(transferId, (current) => {
270
+ if (isTerminalCopyJobStatus(current.status)) {
271
+ return current;
272
+ }
273
+ return {
274
+ ...current,
275
+ status: "cancelled",
276
+ error: current.error ?? "Cancelled before start",
277
+ finishedAt: nowIso(),
278
+ };
279
+ })
280
+ .catch(() => undefined);
281
+ return;
282
+ }
283
+ try {
284
+ if (signal.aborted) {
285
+ throw new Error("Copy aborted");
286
+ }
287
+ const result = await this.executeCopy(this.deps, record.source, record.dest, {
288
+ recursive: record.options.recursive,
289
+ skipIfComplete: record.options.skipIfComplete,
290
+ verify: record.options.verify,
291
+ progressIntervalMs: record.options.progressIntervalMs,
292
+ totalTimeoutMs: record.options.totalTimeoutMs,
293
+ transferId,
294
+ signal,
295
+ onProgress: (p) => {
296
+ if (signal.aborted) {
297
+ return;
298
+ }
299
+ const progress = engineProgressToJobProgress(p, 0);
300
+ void this.store
301
+ .update(transferId, (current) => {
302
+ if (current.status === "cancelled") {
303
+ return current;
304
+ }
305
+ return {
306
+ ...current,
307
+ status: "running",
308
+ progress,
309
+ updatedAt: nowIso(),
310
+ };
311
+ })
312
+ .catch(() => undefined);
313
+ },
314
+ });
315
+ if (signal.aborted) {
316
+ await this.store.update(transferId, (current) => {
317
+ if (current.status === "cancelled") {
318
+ return current;
319
+ }
320
+ return {
321
+ ...current,
322
+ status: "cancelled",
323
+ finishedAt: nowIso(),
324
+ error: "Cancelled during transfer",
325
+ };
326
+ });
327
+ return;
328
+ }
329
+ if (result.exitCode !== 0) {
330
+ await this.store.update(transferId, (current) => {
331
+ if (current.status === "cancelled") {
332
+ return current;
333
+ }
334
+ return {
335
+ ...current,
336
+ status: "failed",
337
+ error: result.message || result.stderr || `exitCode=${result.exitCode}`,
338
+ finishedAt: nowIso(),
339
+ verified: result.verified,
340
+ progress: {
341
+ transferredBytes: result.bytes ?? current.progress.transferredBytes,
342
+ totalBytes: result.totalBytes ?? current.progress.totalBytes,
343
+ percent: result.totalBytes && result.bytes
344
+ ? Math.min(100, (result.bytes / result.totalBytes) * 100)
345
+ : current.progress.percent,
346
+ skippedBytes: result.skippedBytes,
347
+ skipped: result.skipped,
348
+ skipReason: result.skipReason,
349
+ },
350
+ plan: current.plan.map((h) => ({ ...h, status: "failed" })),
351
+ };
352
+ });
353
+ return;
354
+ }
355
+ await this.store.update(transferId, (current) => {
356
+ if (current.status === "cancelled") {
357
+ return current;
358
+ }
359
+ return {
360
+ ...current,
361
+ status: "success",
362
+ finishedAt: nowIso(),
363
+ verified: result.verified,
364
+ progress: {
365
+ transferredBytes: result.bytes ?? result.totalBytes ?? 0,
366
+ totalBytes: result.totalBytes ?? result.bytes,
367
+ percent: 100,
368
+ skippedBytes: result.skippedBytes,
369
+ skipped: result.skipped,
370
+ skipReason: result.skipReason,
371
+ },
372
+ plan: current.plan.map((h) => ({ ...h, status: "success" })),
373
+ };
374
+ });
375
+ }
376
+ catch (error) {
377
+ const message = error instanceof Error ? error.message : String(error);
378
+ const code = error instanceof Error ? error.code : undefined;
379
+ const aborted = signal.aborted || message === "Copy aborted";
380
+ const timedOut = code === "TIMEOUT" || /total timeout|timed out/i.test(message);
381
+ const terminal = aborted ? "cancelled" : timedOut ? "timeout" : "failed";
382
+ await this.store.update(transferId, (current) => {
383
+ if (isTerminalCopyJobStatus(current.status)) {
384
+ return current;
385
+ }
386
+ return {
387
+ ...current,
388
+ status: terminal,
389
+ error: message,
390
+ finishedAt: nowIso(),
391
+ plan: current.plan.map((h) => ({
392
+ ...h,
393
+ status: terminal,
394
+ })),
395
+ };
396
+ });
397
+ }
398
+ }
399
+ }
400
+ //# sourceMappingURL=copy-job-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"copy-job-manager.js","sourceRoot":"","sources":["../../src/utils/copy-job-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import type { CopyJobRecord } from "./copy-job-types.js";
2
+ export declare function defaultCopyJobRoot(): string;
3
+ export declare class CopyJobStore {
4
+ readonly rootDir: string;
5
+ readonly jobsDir: string;
6
+ /** Serialize writes per transferId (Windows rename races). */
7
+ private readonly writeChains;
8
+ constructor(rootDir?: string);
9
+ jobPath(transferId: string): string;
10
+ ensureDirs(): Promise<void>;
11
+ listIds(): Promise<string[]>;
12
+ private enqueueWrite;
13
+ write(record: CopyJobRecord): Promise<void>;
14
+ read(transferId: string): Promise<CopyJobRecord | undefined>;
15
+ update(transferId: string, patch: Partial<CopyJobRecord> | ((current: CopyJobRecord) => CopyJobRecord)): Promise<CopyJobRecord>;
16
+ private readUnlocked;
17
+ private writeUnlocked;
18
+ }
@@ -0,0 +1,104 @@
1
+ import fs from "node:fs/promises";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import crypto from "node:crypto";
5
+ const DEFAULT_ROOT = path.join(os.homedir(), ".agent-compose", "remote-copy");
6
+ export function defaultCopyJobRoot() {
7
+ return (process.env.ACCESS_COPY_JOB_ROOT?.trim() ||
8
+ DEFAULT_ROOT);
9
+ }
10
+ export class CopyJobStore {
11
+ rootDir;
12
+ jobsDir;
13
+ /** Serialize writes per transferId (Windows rename races). */
14
+ writeChains = new Map();
15
+ constructor(rootDir = defaultCopyJobRoot()) {
16
+ this.rootDir = rootDir;
17
+ this.jobsDir = path.join(rootDir, "jobs");
18
+ }
19
+ jobPath(transferId) {
20
+ if (!/^copy-[A-Za-z0-9-]+$/.test(transferId)) {
21
+ throw new Error(`Invalid transferId: ${transferId}`);
22
+ }
23
+ return path.join(this.jobsDir, `${transferId}.json`);
24
+ }
25
+ async ensureDirs() {
26
+ await fs.mkdir(this.jobsDir, { recursive: true });
27
+ }
28
+ async listIds() {
29
+ await this.ensureDirs();
30
+ const names = await fs.readdir(this.jobsDir);
31
+ return names
32
+ .filter((n) => /^copy-[A-Za-z0-9-]+\.json$/.test(n))
33
+ .map((n) => n.slice(0, -".json".length));
34
+ }
35
+ async enqueueWrite(transferId, fn) {
36
+ const prev = this.writeChains.get(transferId) ?? Promise.resolve();
37
+ const next = prev.then(fn, fn);
38
+ const tracked = next.then(() => {
39
+ if (this.writeChains.get(transferId) === tracked) {
40
+ this.writeChains.delete(transferId);
41
+ }
42
+ }, () => {
43
+ if (this.writeChains.get(transferId) === tracked) {
44
+ this.writeChains.delete(transferId);
45
+ }
46
+ });
47
+ this.writeChains.set(transferId, tracked);
48
+ await next;
49
+ }
50
+ async write(record) {
51
+ await this.enqueueWrite(record.transferId, async () => {
52
+ await this.writeUnlocked(record);
53
+ });
54
+ }
55
+ async read(transferId) {
56
+ return this.readUnlocked(transferId);
57
+ }
58
+ async update(transferId, patch) {
59
+ let next;
60
+ await this.enqueueWrite(transferId, async () => {
61
+ const current = await this.readUnlocked(transferId);
62
+ if (!current) {
63
+ throw new Error(`Unknown transferId: ${transferId}`);
64
+ }
65
+ next =
66
+ typeof patch === "function"
67
+ ? patch(current)
68
+ : {
69
+ ...current,
70
+ ...patch,
71
+ };
72
+ next.updatedAt = new Date().toISOString();
73
+ await this.writeUnlocked(next);
74
+ });
75
+ return next;
76
+ }
77
+ async readUnlocked(transferId) {
78
+ try {
79
+ const raw = await fs.readFile(this.jobPath(transferId), "utf8");
80
+ const parsed = JSON.parse(raw);
81
+ if (typeof parsed.transferId !== "string" || typeof parsed.status !== "string") {
82
+ return undefined;
83
+ }
84
+ return parsed;
85
+ }
86
+ catch {
87
+ return undefined;
88
+ }
89
+ }
90
+ async writeUnlocked(record) {
91
+ await this.ensureDirs();
92
+ const finalPath = this.jobPath(record.transferId);
93
+ const tmp = `${finalPath}.${process.pid}.${crypto.randomBytes(4).toString("hex")}.tmp`;
94
+ await fs.writeFile(tmp, `${JSON.stringify(record, null, 2)}\n`, "utf8");
95
+ try {
96
+ await fs.rename(tmp, finalPath);
97
+ }
98
+ catch {
99
+ await fs.unlink(finalPath).catch(() => undefined);
100
+ await fs.rename(tmp, finalPath);
101
+ }
102
+ }
103
+ }
104
+ //# sourceMappingURL=copy-job-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"copy-job-store.js","sourceRoot":"","sources":["../../src/utils/copy-job-store.ts"],"names":[],"mappings":"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"}