@xioflow/kernel 0.2.0 → 0.4.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 (86) hide show
  1. package/README.md +116 -15
  2. package/dist/capability/check.d.ts +32 -0
  3. package/dist/capability/check.d.ts.map +1 -0
  4. package/dist/capability/check.js +136 -0
  5. package/dist/capability/check.js.map +1 -0
  6. package/dist/capability/index.d.ts +3 -0
  7. package/dist/capability/index.d.ts.map +1 -0
  8. package/dist/capability/index.js +3 -0
  9. package/dist/capability/index.js.map +1 -0
  10. package/dist/capability/path-utils.d.ts +11 -0
  11. package/dist/capability/path-utils.d.ts.map +1 -0
  12. package/dist/capability/path-utils.js +46 -0
  13. package/dist/capability/path-utils.js.map +1 -0
  14. package/dist/confinement/bubblewrap.d.ts +8 -0
  15. package/dist/confinement/bubblewrap.d.ts.map +1 -0
  16. package/dist/confinement/bubblewrap.js +45 -0
  17. package/dist/confinement/bubblewrap.js.map +1 -0
  18. package/dist/confinement/detector.d.ts +4 -0
  19. package/dist/confinement/detector.d.ts.map +1 -0
  20. package/dist/confinement/detector.js +35 -0
  21. package/dist/confinement/detector.js.map +1 -0
  22. package/dist/confinement/index.d.ts +5 -0
  23. package/dist/confinement/index.d.ts.map +1 -0
  24. package/dist/confinement/index.js +5 -0
  25. package/dist/confinement/index.js.map +1 -0
  26. package/dist/confinement/sandbox-exec.d.ts +8 -0
  27. package/dist/confinement/sandbox-exec.d.ts.map +1 -0
  28. package/dist/confinement/sandbox-exec.js +30 -0
  29. package/dist/confinement/sandbox-exec.js.map +1 -0
  30. package/dist/confinement/srt.d.ts +8 -0
  31. package/dist/confinement/srt.d.ts.map +1 -0
  32. package/dist/confinement/srt.js +41 -0
  33. package/dist/confinement/srt.js.map +1 -0
  34. package/dist/domain.d.ts +46 -2
  35. package/dist/domain.d.ts.map +1 -1
  36. package/dist/domain.js +209 -18
  37. package/dist/domain.js.map +1 -1
  38. package/dist/driver/node-driver.d.ts.map +1 -1
  39. package/dist/driver/node-driver.js +46 -36
  40. package/dist/driver/node-driver.js.map +1 -1
  41. package/dist/driver/types.d.ts +13 -0
  42. package/dist/driver/types.d.ts.map +1 -1
  43. package/dist/index.d.ts +4 -0
  44. package/dist/index.d.ts.map +1 -1
  45. package/dist/index.js +4 -0
  46. package/dist/index.js.map +1 -1
  47. package/dist/quick-run.d.ts +27 -0
  48. package/dist/quick-run.d.ts.map +1 -0
  49. package/dist/quick-run.js +75 -0
  50. package/dist/quick-run.js.map +1 -0
  51. package/dist/recovery/engine.d.ts +7 -0
  52. package/dist/recovery/engine.d.ts.map +1 -1
  53. package/dist/recovery/engine.js +174 -4
  54. package/dist/recovery/engine.js.map +1 -1
  55. package/dist/snapshot/git-shadow.d.ts +49 -0
  56. package/dist/snapshot/git-shadow.d.ts.map +1 -0
  57. package/dist/snapshot/git-shadow.js +359 -0
  58. package/dist/snapshot/git-shadow.js.map +1 -0
  59. package/dist/store/schema.d.ts +1 -1
  60. package/dist/store/schema.d.ts.map +1 -1
  61. package/dist/store/schema.js +31 -0
  62. package/dist/store/schema.js.map +1 -1
  63. package/dist/store/sqlite.d.ts +17 -1
  64. package/dist/store/sqlite.d.ts.map +1 -1
  65. package/dist/store/sqlite.js +193 -58
  66. package/dist/store/sqlite.js.map +1 -1
  67. package/dist/supervisor/drainer.d.ts +17 -0
  68. package/dist/supervisor/drainer.d.ts.map +1 -0
  69. package/dist/supervisor/drainer.js +200 -0
  70. package/dist/supervisor/drainer.js.map +1 -0
  71. package/dist/supervisor/service.d.ts +24 -0
  72. package/dist/supervisor/service.d.ts.map +1 -0
  73. package/dist/supervisor/service.js +588 -0
  74. package/dist/supervisor/service.js.map +1 -0
  75. package/dist/supervisor/supervisor.d.ts +62 -4
  76. package/dist/supervisor/supervisor.d.ts.map +1 -1
  77. package/dist/supervisor/supervisor.js +1037 -562
  78. package/dist/supervisor/supervisor.js.map +1 -1
  79. package/dist/testing/contract-suite.d.ts.map +1 -1
  80. package/dist/testing/contract-suite.js +748 -2
  81. package/dist/testing/contract-suite.js.map +1 -1
  82. package/dist/types.d.ts +175 -2
  83. package/dist/types.d.ts.map +1 -1
  84. package/dist/types.js +39 -1
  85. package/dist/types.js.map +1 -1
  86. package/package.json +1 -1
@@ -0,0 +1,200 @@
1
+ import * as crypto from 'node:crypto';
2
+ import fs from 'node:fs';
3
+ export function trimToValidUtf8(buf) {
4
+ const len = buf.length;
5
+ for (let i = 1; i <= Math.min(3, len); i++) {
6
+ const b = buf[len - i];
7
+ if ((b & 0xc0) === 0xc0) {
8
+ const needed = (b & 0xe0) === 0xc0 ? 2 : (b & 0xf0) === 0xe0 ? 3 : (b & 0xf8) === 0xf0 ? 4 : 1;
9
+ if (i < needed) {
10
+ return Buffer.from(buf.subarray(0, len - i));
11
+ }
12
+ break;
13
+ }
14
+ else if ((b & 0x80) === 0) {
15
+ break;
16
+ }
17
+ }
18
+ return buf;
19
+ }
20
+ export function trimStartToValidUtf8(buf) {
21
+ let start = 0;
22
+ while (start < buf.length && (buf[start] & 0xc0) === 0x80) {
23
+ start++;
24
+ }
25
+ return Buffer.from(buf.subarray(start));
26
+ }
27
+ export function setupStreamDrainer(stream, maxBytes, spillFilePath, onChunk, onData, spillInitError) {
28
+ const overhead = maxBytes >= 80 ? Math.min(64, Math.floor(maxBytes / 4)) : 0;
29
+ const effectiveMax = maxBytes - overhead;
30
+ const headMaxBytes = overhead > 0 ? Math.floor(effectiveMax * 0.75) : maxBytes;
31
+ const tailMaxBytes = overhead > 0 ? Math.max(0, effectiveMax - headMaxBytes) : 0;
32
+ const headChunks = [];
33
+ let headBytes = 0;
34
+ let bytesSeen = 0;
35
+ let isTruncated = false;
36
+ let spillFd = null;
37
+ let spillError = spillInitError;
38
+ const hash = crypto.createHash('sha256');
39
+ let isFinalized = false;
40
+ let outputHash = undefined;
41
+ const tailRing = tailMaxBytes > 0 ? Buffer.alloc(tailMaxBytes) : null;
42
+ let tailHead = 0;
43
+ let tailCount = 0;
44
+ if (spillFilePath && !spillError) {
45
+ try {
46
+ spillFd = fs.openSync(spillFilePath, 'w');
47
+ }
48
+ catch (openErr) {
49
+ spillError = openErr.message || String(openErr);
50
+ spillFd = null;
51
+ }
52
+ }
53
+ const doFinalize = () => {
54
+ if (isFinalized)
55
+ return;
56
+ isFinalized = true;
57
+ if (spillFd !== null) {
58
+ try {
59
+ fs.fsyncSync(spillFd);
60
+ fs.closeSync(spillFd);
61
+ }
62
+ catch (syncErr) {
63
+ spillError = spillError || syncErr.message || String(syncErr);
64
+ }
65
+ spillFd = null;
66
+ }
67
+ if (!spillError) {
68
+ try {
69
+ outputHash = hash.digest('hex');
70
+ }
71
+ catch { }
72
+ }
73
+ else {
74
+ outputHash = undefined;
75
+ }
76
+ };
77
+ const finishPromise = new Promise((resolve) => {
78
+ const finalize = () => {
79
+ doFinalize();
80
+ resolve();
81
+ };
82
+ stream.on('data', (chunk) => {
83
+ if (isFinalized) {
84
+ // finalize 之后,流继续读走数据避免堵塞或 SIGPIPE,但跳过 hash、落盘和转发
85
+ return;
86
+ }
87
+ const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
88
+ bytesSeen += buf.length;
89
+ if (onChunk) {
90
+ try {
91
+ onChunk(buf.length);
92
+ }
93
+ catch { }
94
+ }
95
+ // 持续落盘转储全部流与写盘同链哈希 (P0-9)
96
+ if (spillFd !== null) {
97
+ try {
98
+ fs.writeSync(spillFd, buf);
99
+ hash.update(buf);
100
+ }
101
+ catch (writeErr) {
102
+ spillError = spillError || writeErr.message || String(writeErr);
103
+ try {
104
+ fs.closeSync(spillFd);
105
+ }
106
+ catch { }
107
+ spillFd = null;
108
+ }
109
+ }
110
+ else if (!spillFilePath && !spillError) {
111
+ try {
112
+ hash.update(buf);
113
+ }
114
+ catch { }
115
+ }
116
+ if (onData) {
117
+ onData(buf);
118
+ }
119
+ // Head 内存有界保留
120
+ if (headBytes < headMaxBytes) {
121
+ if (headBytes + buf.length <= headMaxBytes) {
122
+ headChunks.push(buf);
123
+ headBytes += buf.length;
124
+ }
125
+ else {
126
+ const remaining = headMaxBytes - headBytes;
127
+ if (remaining > 0) {
128
+ headChunks.push(buf.subarray(0, remaining));
129
+ headBytes += remaining;
130
+ }
131
+ isTruncated = true;
132
+ }
133
+ }
134
+ else {
135
+ isTruncated = true;
136
+ }
137
+ if (bytesSeen > maxBytes) {
138
+ isTruncated = true;
139
+ }
140
+ // Tail 环形缓冲保留
141
+ if (tailRing !== null && tailMaxBytes > 0) {
142
+ if (buf.length >= tailMaxBytes) {
143
+ buf.copy(tailRing, 0, buf.length - tailMaxBytes);
144
+ tailHead = 0;
145
+ tailCount = tailMaxBytes;
146
+ }
147
+ else {
148
+ for (let i = 0; i < buf.length; i++) {
149
+ tailRing[tailHead] = buf[i];
150
+ tailHead = (tailHead + 1) % tailMaxBytes;
151
+ }
152
+ tailCount = Math.min(tailMaxBytes, tailCount + buf.length);
153
+ }
154
+ }
155
+ });
156
+ stream.on('end', finalize);
157
+ stream.on('close', finalize);
158
+ stream.on('error', finalize);
159
+ });
160
+ return {
161
+ getResult: () => {
162
+ doFinalize();
163
+ let content;
164
+ if (bytesSeen <= maxBytes) {
165
+ content = Buffer.concat(headChunks).toString('utf8');
166
+ }
167
+ else {
168
+ const rawHead = trimToValidUtf8(Buffer.concat(headChunks));
169
+ let cleanTail = Buffer.alloc(0);
170
+ if (tailRing !== null && tailCount > 0) {
171
+ const rawTail = Buffer.alloc(tailCount);
172
+ if (tailCount < tailMaxBytes) {
173
+ tailRing.copy(rawTail, 0, 0, tailCount);
174
+ }
175
+ else {
176
+ const part1 = tailRing.subarray(tailHead, tailMaxBytes);
177
+ const part2 = tailRing.subarray(0, tailHead);
178
+ part1.copy(rawTail, 0);
179
+ part2.copy(rawTail, part1.length);
180
+ }
181
+ cleanTail = trimStartToValidUtf8(rawTail);
182
+ }
183
+ const truncatedBytes = Math.max(0, bytesSeen - rawHead.length - cleanTail.length);
184
+ const marker = `\n[... truncated ${truncatedBytes} bytes ...]\n`;
185
+ content = rawHead.toString('utf8') + marker + cleanTail.toString('utf8');
186
+ }
187
+ return {
188
+ content,
189
+ isTruncated,
190
+ outputRef: isTruncated && spillFilePath && !spillError ? spillFilePath : undefined,
191
+ outputHash: !spillError ? outputHash : undefined,
192
+ bytesSeen,
193
+ spillError,
194
+ };
195
+ },
196
+ finishPromise,
197
+ forceFinalize: doFinalize,
198
+ };
199
+ }
200
+ //# sourceMappingURL=drainer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drainer.js","sourceRoot":"","sources":["../../src/supervisor/drainer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { ExecutionDomain } from '../domain.js';
2
+ import { PlatformDriver } from '../driver/types.js';
3
+ import { ServiceSpec, ServiceHandle } from '../types.js';
4
+ import { ProcessSupervisor } from './supervisor.js';
5
+ export declare class ServiceSupervisor {
6
+ private domain;
7
+ private driver;
8
+ private supervisor;
9
+ private activeServices;
10
+ constructor(domain: ExecutionDomain, driver: PlatformDriver, supervisor: ProcessSupervisor);
11
+ startService(spec: ServiceSpec): Promise<ServiceHandle>;
12
+ private spawnInstance;
13
+ private setupReadiness;
14
+ private handleInstanceExit;
15
+ stopService(serviceId: string, graceMs?: number): Promise<void>;
16
+ /**
17
+ * 显式停止的唯一终态写入点:只有驱动确认整组已停且观测到根进程退出,才记录实例结果并释放 service 租约;
18
+ * 否则实例记为 indeterminate、租约保留,等待人工裁决(与 ProcessSupervisor 的 No premature release 一致)。
19
+ */
20
+ private finalizeStop;
21
+ close(): void;
22
+ private computeServiceFingerprint;
23
+ }
24
+ //# sourceMappingURL=service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/supervisor/service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAA2C,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EACL,WAAW,EACX,aAAa,EAKd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AA8BpD,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,UAAU;IALpB,OAAO,CAAC,cAAc,CAA0C;IAEhE,YACU,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,iBAAiB,EACnC;IAES,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAyGnE;YAEa,aAAa;IAoG3B,OAAO,CAAC,cAAc;YAyFR,kBAAkB;IAiKnB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDjF;IAED;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoEb,KAAK,IAAI,IAAI,CAWnB;IAED,OAAO,CAAC,yBAAyB;CAWlC"}