@felan-ai/daemon 0.0.0-stage → 0.1.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 (288) hide show
  1. package/LICENSE +21 -0
  2. package/NOTICE +69 -0
  3. package/README.md +61 -2
  4. package/dist/client.d.ts +5 -0
  5. package/dist/client.d.ts.map +1 -0
  6. package/dist/client.js +4 -0
  7. package/dist/client.js.map +1 -0
  8. package/dist/daemon/admission.d.ts +39 -0
  9. package/dist/daemon/admission.d.ts.map +1 -0
  10. package/dist/daemon/admission.js +175 -0
  11. package/dist/daemon/admission.js.map +1 -0
  12. package/dist/daemon/agent-logs.d.ts +11 -0
  13. package/dist/daemon/agent-logs.d.ts.map +1 -0
  14. package/dist/daemon/agent-logs.js +31 -0
  15. package/dist/daemon/agent-logs.js.map +1 -0
  16. package/dist/daemon/bootstrap.d.ts +7 -0
  17. package/dist/daemon/bootstrap.d.ts.map +1 -0
  18. package/dist/daemon/bootstrap.js +4 -0
  19. package/dist/daemon/bootstrap.js.map +1 -0
  20. package/dist/daemon/broker.d.ts +94 -0
  21. package/dist/daemon/broker.d.ts.map +1 -0
  22. package/dist/daemon/broker.js +374 -0
  23. package/dist/daemon/broker.js.map +1 -0
  24. package/dist/daemon/commands.d.ts +47 -0
  25. package/dist/daemon/commands.d.ts.map +1 -0
  26. package/dist/daemon/commands.js +639 -0
  27. package/dist/daemon/commands.js.map +1 -0
  28. package/dist/daemon/control-recovery.d.ts +9 -0
  29. package/dist/daemon/control-recovery.d.ts.map +1 -0
  30. package/dist/daemon/control-recovery.js +68 -0
  31. package/dist/daemon/control-recovery.js.map +1 -0
  32. package/dist/daemon/control-state.d.ts +1915 -0
  33. package/dist/daemon/control-state.d.ts.map +1 -0
  34. package/dist/daemon/control-state.js +154 -0
  35. package/dist/daemon/control-state.js.map +1 -0
  36. package/dist/daemon/control-store.d.ts +113 -0
  37. package/dist/daemon/control-store.d.ts.map +1 -0
  38. package/dist/daemon/control-store.js +901 -0
  39. package/dist/daemon/control-store.js.map +1 -0
  40. package/dist/daemon/execution-policy.d.ts +15 -0
  41. package/dist/daemon/execution-policy.d.ts.map +1 -0
  42. package/dist/daemon/execution-policy.js +42 -0
  43. package/dist/daemon/execution-policy.js.map +1 -0
  44. package/dist/daemon/execution-services.d.ts +5 -0
  45. package/dist/daemon/execution-services.d.ts.map +1 -0
  46. package/dist/daemon/execution-services.js +73 -0
  47. package/dist/daemon/execution-services.js.map +1 -0
  48. package/dist/daemon/executions.d.ts +134 -0
  49. package/dist/daemon/executions.d.ts.map +1 -0
  50. package/dist/daemon/executions.js +486 -0
  51. package/dist/daemon/executions.js.map +1 -0
  52. package/dist/daemon/extension-ui.d.ts +24 -0
  53. package/dist/daemon/extension-ui.d.ts.map +1 -0
  54. package/dist/daemon/extension-ui.js +161 -0
  55. package/dist/daemon/extension-ui.js.map +1 -0
  56. package/dist/daemon/fanout.d.ts +40 -0
  57. package/dist/daemon/fanout.d.ts.map +1 -0
  58. package/dist/daemon/fanout.js +304 -0
  59. package/dist/daemon/fanout.js.map +1 -0
  60. package/dist/daemon/headless-json.d.ts +3 -0
  61. package/dist/daemon/headless-json.d.ts.map +1 -0
  62. package/dist/daemon/headless-json.js +20 -0
  63. package/dist/daemon/headless-json.js.map +1 -0
  64. package/dist/daemon/host-config.d.ts +61 -0
  65. package/dist/daemon/host-config.d.ts.map +1 -0
  66. package/dist/daemon/host-config.js +167 -0
  67. package/dist/daemon/host-config.js.map +1 -0
  68. package/dist/daemon/host-services.d.ts +61 -0
  69. package/dist/daemon/host-services.d.ts.map +1 -0
  70. package/dist/daemon/host-services.js +2 -0
  71. package/dist/daemon/host-services.js.map +1 -0
  72. package/dist/daemon/ipc.d.ts +14 -0
  73. package/dist/daemon/ipc.d.ts.map +1 -0
  74. package/dist/daemon/ipc.js +233 -0
  75. package/dist/daemon/ipc.js.map +1 -0
  76. package/dist/daemon/legacy-sessions.d.ts +48 -0
  77. package/dist/daemon/legacy-sessions.d.ts.map +1 -0
  78. package/dist/daemon/legacy-sessions.js +328 -0
  79. package/dist/daemon/legacy-sessions.js.map +1 -0
  80. package/dist/daemon/lifecycle.d.ts +44 -0
  81. package/dist/daemon/lifecycle.d.ts.map +1 -0
  82. package/dist/daemon/lifecycle.js +164 -0
  83. package/dist/daemon/lifecycle.js.map +1 -0
  84. package/dist/daemon/main.d.ts +3 -0
  85. package/dist/daemon/main.d.ts.map +1 -0
  86. package/dist/daemon/main.js +83 -0
  87. package/dist/daemon/main.js.map +1 -0
  88. package/dist/daemon/message-display.d.ts +4 -0
  89. package/dist/daemon/message-display.d.ts.map +1 -0
  90. package/dist/daemon/message-display.js +20 -0
  91. package/dist/daemon/message-display.js.map +1 -0
  92. package/dist/daemon/native-ownership.d.ts +13 -0
  93. package/dist/daemon/native-ownership.d.ts.map +1 -0
  94. package/dist/daemon/native-ownership.js +173 -0
  95. package/dist/daemon/native-ownership.js.map +1 -0
  96. package/dist/daemon/operational-log.d.ts +23 -0
  97. package/dist/daemon/operational-log.d.ts.map +1 -0
  98. package/dist/daemon/operational-log.js +79 -0
  99. package/dist/daemon/operational-log.js.map +1 -0
  100. package/dist/daemon/ownership.d.ts +35 -0
  101. package/dist/daemon/ownership.d.ts.map +1 -0
  102. package/dist/daemon/ownership.js +395 -0
  103. package/dist/daemon/ownership.js.map +1 -0
  104. package/dist/daemon/persistence.d.ts +110 -0
  105. package/dist/daemon/persistence.d.ts.map +1 -0
  106. package/dist/daemon/persistence.js +540 -0
  107. package/dist/daemon/persistence.js.map +1 -0
  108. package/dist/daemon/process-adapter.d.ts +23 -0
  109. package/dist/daemon/process-adapter.d.ts.map +1 -0
  110. package/dist/daemon/process-adapter.js +2 -0
  111. package/dist/daemon/process-adapter.js.map +1 -0
  112. package/dist/daemon/processes.d.ts +102 -0
  113. package/dist/daemon/processes.d.ts.map +1 -0
  114. package/dist/daemon/processes.js +691 -0
  115. package/dist/daemon/processes.js.map +1 -0
  116. package/dist/daemon/profile-storage.d.ts +16 -0
  117. package/dist/daemon/profile-storage.d.ts.map +1 -0
  118. package/dist/daemon/profile-storage.js +148 -0
  119. package/dist/daemon/profile-storage.js.map +1 -0
  120. package/dist/daemon/projection.d.ts +110 -0
  121. package/dist/daemon/projection.d.ts.map +1 -0
  122. package/dist/daemon/projection.js +661 -0
  123. package/dist/daemon/projection.js.map +1 -0
  124. package/dist/daemon/provider-loader.d.ts +28 -0
  125. package/dist/daemon/provider-loader.d.ts.map +1 -0
  126. package/dist/daemon/provider-loader.js +376 -0
  127. package/dist/daemon/provider-loader.js.map +1 -0
  128. package/dist/daemon/provider.d.ts +92 -0
  129. package/dist/daemon/provider.d.ts.map +1 -0
  130. package/dist/daemon/provider.js +31 -0
  131. package/dist/daemon/provider.js.map +1 -0
  132. package/dist/daemon/registry.d.ts +209 -0
  133. package/dist/daemon/registry.d.ts.map +1 -0
  134. package/dist/daemon/registry.js +1591 -0
  135. package/dist/daemon/registry.js.map +1 -0
  136. package/dist/daemon/runtime-dependencies.d.ts +5 -0
  137. package/dist/daemon/runtime-dependencies.d.ts.map +1 -0
  138. package/dist/daemon/runtime-dependencies.js +31 -0
  139. package/dist/daemon/runtime-dependencies.js.map +1 -0
  140. package/dist/daemon/server.d.ts +110 -0
  141. package/dist/daemon/server.d.ts.map +1 -0
  142. package/dist/daemon/server.js +556 -0
  143. package/dist/daemon/server.js.map +1 -0
  144. package/dist/daemon/service.d.ts +38 -0
  145. package/dist/daemon/service.d.ts.map +1 -0
  146. package/dist/daemon/service.js +275 -0
  147. package/dist/daemon/service.js.map +1 -0
  148. package/dist/daemon/session-cursor.d.ts +3 -0
  149. package/dist/daemon/session-cursor.d.ts.map +1 -0
  150. package/dist/daemon/session-cursor.js +4 -0
  151. package/dist/daemon/session-cursor.js.map +1 -0
  152. package/dist/daemon/session-execution.d.ts +88 -0
  153. package/dist/daemon/session-execution.d.ts.map +1 -0
  154. package/dist/daemon/session-execution.js +2 -0
  155. package/dist/daemon/session-execution.js.map +1 -0
  156. package/dist/daemon/session-executions.d.ts +5 -0
  157. package/dist/daemon/session-executions.d.ts.map +1 -0
  158. package/dist/daemon/session-executions.js +146 -0
  159. package/dist/daemon/session-executions.js.map +1 -0
  160. package/dist/daemon/session-files.d.ts +28 -0
  161. package/dist/daemon/session-files.d.ts.map +1 -0
  162. package/dist/daemon/session-files.js +189 -0
  163. package/dist/daemon/session-files.js.map +1 -0
  164. package/dist/daemon/session-lifecycle-contracts.d.ts +104 -0
  165. package/dist/daemon/session-lifecycle-contracts.d.ts.map +1 -0
  166. package/dist/daemon/session-lifecycle-contracts.js +2 -0
  167. package/dist/daemon/session-lifecycle-contracts.js.map +1 -0
  168. package/dist/daemon/session-lifecycle.d.ts +26 -0
  169. package/dist/daemon/session-lifecycle.d.ts.map +1 -0
  170. package/dist/daemon/session-lifecycle.js +246 -0
  171. package/dist/daemon/session-lifecycle.js.map +1 -0
  172. package/dist/daemon/session-runtime.d.ts +64 -0
  173. package/dist/daemon/session-runtime.d.ts.map +1 -0
  174. package/dist/daemon/session-runtime.js +3 -0
  175. package/dist/daemon/session-runtime.js.map +1 -0
  176. package/dist/daemon/session-services.d.ts +6 -0
  177. package/dist/daemon/session-services.d.ts.map +1 -0
  178. package/dist/daemon/session-services.js +144 -0
  179. package/dist/daemon/session-services.js.map +1 -0
  180. package/dist/daemon/shutdown-error.d.ts +12 -0
  181. package/dist/daemon/shutdown-error.d.ts.map +1 -0
  182. package/dist/daemon/shutdown-error.js +51 -0
  183. package/dist/daemon/shutdown-error.js.map +1 -0
  184. package/dist/daemon/supervisor.d.ts +28 -0
  185. package/dist/daemon/supervisor.d.ts.map +1 -0
  186. package/dist/daemon/supervisor.js +159 -0
  187. package/dist/daemon/supervisor.js.map +1 -0
  188. package/dist/daemon/target.d.ts +55 -0
  189. package/dist/daemon/target.d.ts.map +1 -0
  190. package/dist/daemon/target.js +191 -0
  191. package/dist/daemon/target.js.map +1 -0
  192. package/dist/daemon/tree.d.ts +7 -0
  193. package/dist/daemon/tree.d.ts.map +1 -0
  194. package/dist/daemon/tree.js +126 -0
  195. package/dist/daemon/tree.js.map +1 -0
  196. package/dist/daemon/ui-vocabulary.d.ts +29 -0
  197. package/dist/daemon/ui-vocabulary.d.ts.map +1 -0
  198. package/dist/daemon/ui-vocabulary.js +323 -0
  199. package/dist/daemon/ui-vocabulary.js.map +1 -0
  200. package/dist/daemon/worker.d.ts +5 -0
  201. package/dist/daemon/worker.d.ts.map +1 -0
  202. package/dist/daemon/worker.js +49 -0
  203. package/dist/daemon/worker.js.map +1 -0
  204. package/dist/index.d.ts +4 -0
  205. package/dist/index.d.ts.map +1 -0
  206. package/dist/index.js +12 -0
  207. package/dist/index.js.map +1 -0
  208. package/dist/lock.d.ts +27 -0
  209. package/dist/lock.d.ts.map +1 -0
  210. package/dist/lock.js +432 -0
  211. package/dist/lock.js.map +1 -0
  212. package/dist/logger.d.ts +9 -0
  213. package/dist/logger.d.ts.map +1 -0
  214. package/dist/logger.js +56 -0
  215. package/dist/logger.js.map +1 -0
  216. package/dist/remote/backoff.d.ts +17 -0
  217. package/dist/remote/backoff.d.ts.map +1 -0
  218. package/dist/remote/backoff.js +18 -0
  219. package/dist/remote/backoff.js.map +1 -0
  220. package/dist/remote/batch.d.ts +3 -0
  221. package/dist/remote/batch.d.ts.map +1 -0
  222. package/dist/remote/batch.js +27 -0
  223. package/dist/remote/batch.js.map +1 -0
  224. package/dist/remote/command-journal.d.ts +30 -0
  225. package/dist/remote/command-journal.d.ts.map +1 -0
  226. package/dist/remote/command-journal.js +72 -0
  227. package/dist/remote/command-journal.js.map +1 -0
  228. package/dist/remote/commands.d.ts +48 -0
  229. package/dist/remote/commands.d.ts.map +1 -0
  230. package/dist/remote/commands.js +145 -0
  231. package/dist/remote/commands.js.map +1 -0
  232. package/dist/remote/connector.d.ts +135 -0
  233. package/dist/remote/connector.d.ts.map +1 -0
  234. package/dist/remote/connector.js +1069 -0
  235. package/dist/remote/connector.js.map +1 -0
  236. package/dist/remote/content.d.ts +17 -0
  237. package/dist/remote/content.d.ts.map +1 -0
  238. package/dist/remote/content.js +116 -0
  239. package/dist/remote/content.js.map +1 -0
  240. package/dist/remote/outbox.d.ts +52 -0
  241. package/dist/remote/outbox.d.ts.map +1 -0
  242. package/dist/remote/outbox.js +321 -0
  243. package/dist/remote/outbox.js.map +1 -0
  244. package/dist/remote/platform.d.ts +53 -0
  245. package/dist/remote/platform.d.ts.map +1 -0
  246. package/dist/remote/platform.js +231 -0
  247. package/dist/remote/platform.js.map +1 -0
  248. package/dist/remote/realtime.d.ts +45 -0
  249. package/dist/remote/realtime.d.ts.map +1 -0
  250. package/dist/remote/realtime.js +265 -0
  251. package/dist/remote/realtime.js.map +1 -0
  252. package/dist/remote/sharing.d.ts +16 -0
  253. package/dist/remote/sharing.d.ts.map +1 -0
  254. package/dist/remote/sharing.js +24 -0
  255. package/dist/remote/sharing.js.map +1 -0
  256. package/dist/remote/state.d.ts +52 -0
  257. package/dist/remote/state.d.ts.map +1 -0
  258. package/dist/remote/state.js +156 -0
  259. package/dist/remote/state.js.map +1 -0
  260. package/dist/remote/text.d.ts +11 -0
  261. package/dist/remote/text.d.ts.map +1 -0
  262. package/dist/remote/text.js +188 -0
  263. package/dist/remote/text.js.map +1 -0
  264. package/dist/remote/token.d.ts +39 -0
  265. package/dist/remote/token.d.ts.map +1 -0
  266. package/dist/remote/token.js +238 -0
  267. package/dist/remote/token.js.map +1 -0
  268. package/dist/runtime-factory.d.ts +12 -0
  269. package/dist/runtime-factory.d.ts.map +1 -0
  270. package/dist/runtime-factory.js +12 -0
  271. package/dist/runtime-factory.js.map +1 -0
  272. package/dist/session-history.d.ts +29 -0
  273. package/dist/session-history.d.ts.map +1 -0
  274. package/dist/session-history.js +374 -0
  275. package/dist/session-history.js.map +1 -0
  276. package/dist/setup/dependencies.d.ts +15 -0
  277. package/dist/setup/dependencies.d.ts.map +1 -0
  278. package/dist/setup/dependencies.js +2 -0
  279. package/dist/setup/dependencies.js.map +1 -0
  280. package/dist/setup/open.d.ts +8 -0
  281. package/dist/setup/open.d.ts.map +1 -0
  282. package/dist/setup/open.js +16 -0
  283. package/dist/setup/open.js.map +1 -0
  284. package/dist/version.d.ts +2 -0
  285. package/dist/version.d.ts.map +1 -0
  286. package/dist/version.js +4 -0
  287. package/dist/version.js.map +1 -0
  288. package/package.json +65 -3
package/dist/lock.js ADDED
@@ -0,0 +1,432 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { lstat, mkdir, realpath, rename, rmdir, stat, utimes } from 'node:fs/promises';
3
+ import { resolve } from 'node:path';
4
+ const DEFAULT_STALE_MS = 10_000;
5
+ const MINIMUM_STALE_MS = 2_000;
6
+ const MINIMUM_UPDATE_MS = 1_000;
7
+ export async function withLocalFileLock(path, options, operation) {
8
+ const lock = await acquireLocalFileLock(path, {
9
+ ...options,
10
+ preservePathOnRelease: true,
11
+ });
12
+ try {
13
+ lock.throwIfCompromised();
14
+ const result = await operation(lock);
15
+ lock.throwIfCompromised();
16
+ return result;
17
+ }
18
+ finally {
19
+ await lock.release();
20
+ await lock.retire(options.stale ?? DEFAULT_STALE_MS);
21
+ }
22
+ }
23
+ export async function acquireLocalFileLock(path, options = {}) {
24
+ const controller = new AbortController();
25
+ let compromiseError;
26
+ const canonicalPath = options.realpath === false ? resolve(path) : await realpath(path);
27
+ const lockPath = options.lockfilePath ?? `${canonicalPath}.lock`;
28
+ const staleMs = Math.max(options.stale ?? DEFAULT_STALE_MS, MINIMUM_STALE_MS);
29
+ const requestedUpdateMs = options.update ?? staleMs / 2;
30
+ const updateMs = Math.max(Math.min(requestedUpdateMs, staleMs / 2), MINIMUM_UPDATE_MS);
31
+ const state = await acquireLockState(canonicalPath, lockPath, staleMs, updateMs, options.retries, (error) => {
32
+ compromiseError ??= error;
33
+ controller.abort(error);
34
+ });
35
+ scheduleHeartbeat(state);
36
+ const isCurrent = async () => {
37
+ if (compromiseError)
38
+ return false;
39
+ const current = await readLockIdentity(lockPath);
40
+ return current !== undefined && sameLockIdentity(current, state.identity);
41
+ };
42
+ let released = false;
43
+ return {
44
+ compromised: controller.signal,
45
+ isCompromised: () => compromiseError !== undefined,
46
+ isCurrent,
47
+ throwIfCompromised(message) {
48
+ if (!compromiseError)
49
+ return;
50
+ if (message === undefined)
51
+ throw compromiseError;
52
+ throw new Error(message, { cause: compromiseError });
53
+ },
54
+ async retire(retireStaleMs) {
55
+ if (!options.preservePathOnRelease || !(await isCurrent()))
56
+ return;
57
+ const retiredAt = new Date(Date.now() - Math.max(retireStaleMs, MINIMUM_STALE_MS) - 1_000);
58
+ await setTimes(lockPath, retiredAt).catch(() => { });
59
+ },
60
+ async release() {
61
+ if (released)
62
+ return;
63
+ released = true;
64
+ const owned = state.status === 'active';
65
+ state.status = 'released';
66
+ clearHeartbeat(state);
67
+ await state.heartbeat;
68
+ if (!owned || options.preservePathOnRelease)
69
+ return;
70
+ await removeLockIfCurrent(lockPath, state.identity);
71
+ },
72
+ };
73
+ }
74
+ async function acquireLockState(targetPath, lockPath, staleMs, updateMs, retries, onCompromised) {
75
+ const retryDelays = createRetryDelays(retries);
76
+ let lastError;
77
+ for (let attempt = 0; attempt <= retryDelays.length; attempt += 1) {
78
+ try {
79
+ await acquireLockDirectory(targetPath, lockPath, staleMs);
80
+ return await initializeLockState(targetPath, lockPath, staleMs, updateMs, onCompromised);
81
+ }
82
+ catch (error) {
83
+ lastError = error;
84
+ const retryDelay = retryDelays[attempt];
85
+ if (retryDelay === undefined)
86
+ throw error;
87
+ await delay(retryDelay);
88
+ }
89
+ }
90
+ throw lastError;
91
+ }
92
+ async function acquireLockDirectory(targetPath, lockPath, staleMs) {
93
+ try {
94
+ await mkdir(lockPath);
95
+ return;
96
+ }
97
+ catch (error) {
98
+ if (!hasErrorCode(error, 'EEXIST'))
99
+ throw error;
100
+ }
101
+ let stats;
102
+ try {
103
+ stats = await stat(lockPath);
104
+ }
105
+ catch (error) {
106
+ if (!hasErrorCode(error, 'ENOENT'))
107
+ throw error;
108
+ return makeDirectoryWithoutStaleRecovery(targetPath, lockPath);
109
+ }
110
+ if (stats.mtime.getTime() >= Date.now() - staleMs)
111
+ throw lockHeldError(targetPath);
112
+ if (!(await reclaimStaleLock(lockPath, stats)))
113
+ throw lockHeldError(targetPath);
114
+ await makeDirectoryWithoutStaleRecovery(targetPath, lockPath);
115
+ }
116
+ async function reclaimStaleLock(lockPath, observed) {
117
+ const claimPath = lockClaimPath(lockPath, 'reclaim');
118
+ try {
119
+ await rename(lockPath, claimPath);
120
+ }
121
+ catch (error) {
122
+ if (hasErrorCode(error, 'ENOENT'))
123
+ return true;
124
+ throw error;
125
+ }
126
+ let claimed;
127
+ try {
128
+ claimed = await lstat(claimPath);
129
+ }
130
+ catch (error) {
131
+ if (hasErrorCode(error, 'ENOENT'))
132
+ return true;
133
+ await restoreClaim(claimPath, lockPath);
134
+ throw error;
135
+ }
136
+ if (!sameLockIdentity(claimed, lockIdentity(observed))
137
+ || claimed.mtime.getTime() !== observed.mtime.getTime()) {
138
+ await restoreClaim(claimPath, lockPath);
139
+ return false;
140
+ }
141
+ try {
142
+ await rmdir(claimPath);
143
+ return true;
144
+ }
145
+ catch (error) {
146
+ await restoreClaim(claimPath, lockPath);
147
+ if (isDirectoryNotEmpty(error))
148
+ return false;
149
+ if (hasErrorCode(error, 'ENOENT'))
150
+ return true;
151
+ throw error;
152
+ }
153
+ }
154
+ async function makeDirectoryWithoutStaleRecovery(targetPath, lockPath) {
155
+ try {
156
+ await mkdir(lockPath);
157
+ }
158
+ catch (error) {
159
+ if (hasErrorCode(error, 'EEXIST'))
160
+ throw lockHeldError(targetPath);
161
+ throw error;
162
+ }
163
+ }
164
+ async function initializeLockState(targetPath, lockPath, staleMs, updateMs, onCompromised) {
165
+ let identity;
166
+ try {
167
+ let initialStats;
168
+ try {
169
+ initialStats = await lstat(lockPath);
170
+ }
171
+ catch (error) {
172
+ if (hasErrorCode(error, 'ENOENT'))
173
+ throw lockHeldError(targetPath);
174
+ throw error;
175
+ }
176
+ identity = lockIdentity(initialStats);
177
+ const probeTime = new Date(Math.ceil(Date.now() / 1_000) * 1_000 + 5);
178
+ try {
179
+ await setTimes(lockPath, probeTime);
180
+ }
181
+ catch (error) {
182
+ if (hasErrorCode(error, 'ENOENT'))
183
+ throw lockHeldError(targetPath);
184
+ throw error;
185
+ }
186
+ let stats;
187
+ try {
188
+ stats = await stat(lockPath);
189
+ }
190
+ catch (error) {
191
+ if (hasErrorCode(error, 'ENOENT'))
192
+ throw lockHeldError(targetPath);
193
+ throw error;
194
+ }
195
+ if (!sameLockIdentity(stats, identity))
196
+ throw lockHeldError(targetPath);
197
+ return {
198
+ lockPath,
199
+ identity,
200
+ staleMs,
201
+ updateMs,
202
+ precision: stats.mtime.getTime() % 1_000 === 0 ? 'seconds' : 'milliseconds',
203
+ onCompromised,
204
+ status: 'active',
205
+ mtime: stats.mtime,
206
+ lastUpdateMs: Date.now(),
207
+ updateDelayMs: undefined,
208
+ updateTimer: undefined,
209
+ heartbeat: undefined,
210
+ };
211
+ }
212
+ catch (error) {
213
+ if (identity)
214
+ await removeLockIfCurrent(lockPath, identity).catch(() => { });
215
+ throw error;
216
+ }
217
+ }
218
+ function scheduleHeartbeat(state) {
219
+ if (state.status !== 'active' || state.updateTimer)
220
+ return;
221
+ state.updateTimer = setTimeout(() => {
222
+ state.updateTimer = undefined;
223
+ const heartbeat = updateHeartbeat(state).catch((error) => {
224
+ if (state.status === 'active')
225
+ compromiseLock(state, toCompromisedError(error));
226
+ }).finally(() => {
227
+ if (state.heartbeat === heartbeat)
228
+ state.heartbeat = undefined;
229
+ });
230
+ state.heartbeat = heartbeat;
231
+ }, state.updateDelayMs ?? state.updateMs);
232
+ state.updateTimer.unref();
233
+ }
234
+ async function updateHeartbeat(state) {
235
+ if (state.status !== 'active')
236
+ return;
237
+ let stats;
238
+ try {
239
+ stats = await stat(state.lockPath);
240
+ }
241
+ catch (error) {
242
+ if (state.status !== 'active')
243
+ return;
244
+ if (hasErrorCode(error, 'ENOENT') || heartbeatOverdue(state)) {
245
+ compromiseLock(state, toCompromisedError(error));
246
+ }
247
+ else {
248
+ state.updateDelayMs = MINIMUM_UPDATE_MS;
249
+ scheduleHeartbeat(state);
250
+ }
251
+ return;
252
+ }
253
+ if (state.status !== 'active')
254
+ return;
255
+ if (!sameLockIdentity(stats, state.identity) || stats.mtime.getTime() !== state.mtime.getTime()) {
256
+ compromiseLock(state, compromisedError('Unable to update lock within the stale threshold'));
257
+ return;
258
+ }
259
+ const mtime = currentMtime(state.precision);
260
+ try {
261
+ await setTimes(state.lockPath, mtime);
262
+ }
263
+ catch (error) {
264
+ if (state.status !== 'active')
265
+ return;
266
+ if (hasErrorCode(error, 'ENOENT') || heartbeatOverdue(state)) {
267
+ compromiseLock(state, toCompromisedError(error));
268
+ }
269
+ else {
270
+ state.updateDelayMs = MINIMUM_UPDATE_MS;
271
+ scheduleHeartbeat(state);
272
+ }
273
+ return;
274
+ }
275
+ if (state.status !== 'active')
276
+ return;
277
+ let confirmed;
278
+ try {
279
+ confirmed = await stat(state.lockPath);
280
+ }
281
+ catch (error) {
282
+ if (state.status !== 'active')
283
+ return;
284
+ state.mtime = mtime;
285
+ if (hasErrorCode(error, 'ENOENT') || heartbeatOverdue(state)) {
286
+ compromiseLock(state, toCompromisedError(error));
287
+ }
288
+ else {
289
+ state.updateDelayMs = MINIMUM_UPDATE_MS;
290
+ scheduleHeartbeat(state);
291
+ }
292
+ return;
293
+ }
294
+ if (state.status !== 'active')
295
+ return;
296
+ if (!sameLockIdentity(confirmed, state.identity) || confirmed.mtime.getTime() !== mtime.getTime()) {
297
+ compromiseLock(state, compromisedError('Unable to update lock within the stale threshold'));
298
+ return;
299
+ }
300
+ state.mtime = mtime;
301
+ state.lastUpdateMs = Date.now();
302
+ state.updateDelayMs = undefined;
303
+ scheduleHeartbeat(state);
304
+ }
305
+ function heartbeatOverdue(state) {
306
+ return state.lastUpdateMs + state.staleMs < Date.now();
307
+ }
308
+ function compromiseLock(state, error) {
309
+ if (state.status !== 'active')
310
+ return;
311
+ state.status = 'compromised';
312
+ clearHeartbeat(state);
313
+ state.onCompromised(error);
314
+ }
315
+ function clearHeartbeat(state) {
316
+ if (!state.updateTimer)
317
+ return;
318
+ clearTimeout(state.updateTimer);
319
+ state.updateTimer = undefined;
320
+ }
321
+ function currentMtime(precision) {
322
+ const now = Date.now();
323
+ return new Date(precision === 'seconds' ? Math.ceil(now / 1_000) * 1_000 : now);
324
+ }
325
+ function createRetryDelays(retries) {
326
+ const options = typeof retries === 'number' ? { retries } : retries;
327
+ const count = Math.max(0, Math.floor(options?.retries ?? (options ? 10 : 0)));
328
+ const factor = options?.factor ?? 2;
329
+ const minTimeout = options?.minTimeout ?? 1_000;
330
+ const maxTimeout = options?.maxTimeout ?? Number.POSITIVE_INFINITY;
331
+ if (minTimeout > maxTimeout)
332
+ throw new Error('minTimeout is greater than maxTimeout');
333
+ return Array.from({ length: count }, (_, attempt) => {
334
+ const random = options?.randomize ? Math.random() + 1 : 1;
335
+ return Math.min(Math.round(random * minTimeout * factor ** attempt), maxTimeout);
336
+ }).sort((left, right) => left - right);
337
+ }
338
+ function lockHeldError(path) {
339
+ return Object.assign(new Error('Lock file is already being held'), { code: 'ELOCKED', file: path });
340
+ }
341
+ function compromisedError(message, cause) {
342
+ return Object.assign(new Error(message, cause === undefined ? undefined : { cause }), { code: 'ECOMPROMISED' });
343
+ }
344
+ function toCompromisedError(error) {
345
+ if (error instanceof Error)
346
+ return compromisedError(error.message, error);
347
+ return compromisedError('Unable to update lock within the stale threshold', error);
348
+ }
349
+ async function removeLockIfCurrent(lockPath, identity) {
350
+ const current = await readLockIdentity(lockPath);
351
+ if (!current || !sameLockIdentity(current, identity))
352
+ return;
353
+ const claimPath = lockClaimPath(lockPath, 'release');
354
+ try {
355
+ await rename(lockPath, claimPath);
356
+ }
357
+ catch (error) {
358
+ if (hasErrorCode(error, 'ENOENT'))
359
+ return;
360
+ throw error;
361
+ }
362
+ let claimed;
363
+ try {
364
+ claimed = await readLockIdentity(claimPath);
365
+ }
366
+ catch (error) {
367
+ await restoreClaim(claimPath, lockPath);
368
+ throw error;
369
+ }
370
+ if (!claimed || !sameLockIdentity(claimed, identity)) {
371
+ await restoreClaim(claimPath, lockPath);
372
+ return;
373
+ }
374
+ try {
375
+ await rmdir(claimPath);
376
+ }
377
+ catch (error) {
378
+ await restoreClaim(claimPath, lockPath);
379
+ if (!hasErrorCode(error, 'ENOENT'))
380
+ throw error;
381
+ }
382
+ }
383
+ async function restoreClaim(claimPath, lockPath) {
384
+ try {
385
+ await lstat(lockPath);
386
+ return;
387
+ }
388
+ catch (error) {
389
+ if (!hasErrorCode(error, 'ENOENT'))
390
+ throw error;
391
+ }
392
+ try {
393
+ await rename(claimPath, lockPath);
394
+ }
395
+ catch (error) {
396
+ if (hasErrorCode(error, 'ENOENT') || hasErrorCode(error, 'EEXIST') || hasErrorCode(error, 'ENOTEMPTY'))
397
+ return;
398
+ throw error;
399
+ }
400
+ }
401
+ function lockClaimPath(lockPath, operation) {
402
+ return `${lockPath}.${operation}-${process.pid}-${randomUUID()}`;
403
+ }
404
+ async function readLockIdentity(path) {
405
+ try {
406
+ return lockIdentity(await lstat(path));
407
+ }
408
+ catch (error) {
409
+ if (hasErrorCode(error, 'ENOENT'))
410
+ return undefined;
411
+ throw error;
412
+ }
413
+ }
414
+ function lockIdentity(stats) {
415
+ return { dev: stats.dev, ino: stats.ino, birthtimeMs: stats.birthtimeMs };
416
+ }
417
+ function sameLockIdentity(left, right) {
418
+ return left.dev === right.dev && left.ino === right.ino && left.birthtimeMs === right.birthtimeMs;
419
+ }
420
+ function hasErrorCode(error, code) {
421
+ return typeof error === 'object' && error !== null && Reflect.get(error, 'code') === code;
422
+ }
423
+ function isDirectoryNotEmpty(error) {
424
+ return hasErrorCode(error, 'ENOTEMPTY') || hasErrorCode(error, 'EEXIST');
425
+ }
426
+ function delay(milliseconds) {
427
+ return new Promise((resolveDelay) => setTimeout(resolveDelay, milliseconds));
428
+ }
429
+ function setTimes(path, time) {
430
+ return utimes(path, time, time);
431
+ }
432
+ //# sourceMappingURL=lock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lock.js","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiDpC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,OAA6B,EAC7B,SAA8C;IAE9C,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE;QAC5C,GAAG,OAAO;QACV,qBAAqB,EAAE,IAAI;KAC5B,CAAC,CAAC;IACH,IAAI,CAAC;QACH,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,gBAAgB,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,UAAgC,EAAE;IAElC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,eAAkC,CAAC;IACvC,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,IAAI,GAAG,aAAa,OAAO,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;IAC9E,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QAC1G,eAAe,KAAK,KAAK,CAAC;QAC1B,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACzB,MAAM,SAAS,GAAG,KAAK,IAAsB,EAAE;QAC7C,IAAI,eAAe;YAAE,OAAO,KAAK,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,OAAO,KAAK,SAAS,IAAI,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5E,CAAC,CAAC;IACF,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO;QACL,WAAW,EAAE,UAAU,CAAC,MAAM;QAC9B,aAAa,EAAE,GAAG,EAAE,CAAC,eAAe,KAAK,SAAS;QAClD,SAAS;QACT,kBAAkB,CAAC,OAAgB;YACjC,IAAI,CAAC,eAAe;gBAAE,OAAO;YAC7B,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,eAAe,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,aAAqB;YAChC,IAAI,CAAC,OAAO,CAAC,qBAAqB,IAAI,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC;gBAAE,OAAO;YACnE,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,KAAK,CAAC,CAAC;YAC3F,MAAM,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,CAAC,OAAO;YACX,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC;YACxC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC;YAC1B,cAAc,CAAC,KAAK,CAAC,CAAC;YACtB,MAAM,KAAK,CAAC,SAAS,CAAC;YACtB,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,qBAAqB;gBAAE,OAAO;YACpD,MAAM,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,UAAkB,EAClB,QAAgB,EAChB,OAAe,EACf,QAAgB,EAChB,OAAwC,EACxC,aAAqC;IAErC,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,SAAkB,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC;YACH,MAAM,oBAAoB,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC1D,OAAO,MAAM,mBAAmB,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC3F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,UAAU,KAAK,SAAS;gBAAE,MAAM,KAAK,CAAC;YAC1C,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,UAAkB,EAClB,QAAgB,EAChB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,MAAM,KAAK,CAAC;IAClD,CAAC;IAED,IAAI,KAAY,CAAC;IACjB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,MAAM,KAAK,CAAC;QAChD,OAAO,iCAAiC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;QAAE,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAEnF,IAAI,CAAC,CAAC,MAAM,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAAE,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAChF,MAAM,iCAAiC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,QAAgB,EAAE,QAAe;IAC/D,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,OAAc,CAAC;IACnB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxC,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;WACjD,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1D,MAAM,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxC,IAAI,mBAAmB,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7C,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iCAAiC,CAC9C,UAAkB,EAClB,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;QACnE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,UAAkB,EAClB,QAAgB,EAChB,OAAe,EACf,QAAgB,EAChB,aAAqC;IAErC,IAAI,QAAkC,CAAC;IACvC,IAAI,CAAC;QACH,IAAI,YAAmB,CAAC;QACxB,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAAE,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;YACnE,MAAM,KAAK,CAAC;QACd,CAAC;QACD,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAAE,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;YACnE,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,KAAY,CAAC;QACjB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAAE,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;YACnE,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;QACxE,OAAO;YACL,QAAQ;YACR,QAAQ;YACR,OAAO;YACP,QAAQ;YACR,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc;YAC3E,aAAa;YACb,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,aAAa,EAAE,SAAS;YACxB,WAAW,EAAE,SAAS;YACtB,SAAS,EAAE,SAAS;SACrB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,QAAQ;YAAE,MAAM,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5E,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAgB;IACzC,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO;IAC3D,KAAK,CAAC,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE;QAClC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC;QAC9B,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAChE,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAAE,cAAc,CAAC,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACd,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;gBAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;QACjE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAC9B,CAAC,EAAE,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,KAAgB;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO;IACtC,IAAI,KAAY,CAAC;IACjB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO;QACtC,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,cAAc,CAAC,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,aAAa,GAAG,iBAAiB,CAAC;YACxC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO;IACtC,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAChG,cAAc,CAAC,KAAK,EAAE,gBAAgB,CAAC,kDAAkD,CAAC,CAAC,CAAC;QAC5F,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO;QACtC,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,cAAc,CAAC,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,aAAa,GAAG,iBAAiB,CAAC;YACxC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO;IACtC,IAAI,SAAgB,CAAC;IACrB,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO;QACtC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,cAAc,CAAC,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,aAAa,GAAG,iBAAiB,CAAC;YACxC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO;IACtC,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAClG,cAAc,CAAC,KAAK,EAAE,gBAAgB,CAAC,kDAAkD,CAAC,CAAC,CAAC;QAC5F,OAAO;IACT,CAAC;IACD,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC;IAChC,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAgB;IACxC,OAAO,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,cAAc,CAAC,KAAgB,EAAE,KAAY;IACpD,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO;IACtC,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC;IAC7B,cAAc,CAAC,KAAK,CAAC,CAAC;IACtB,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,cAAc,CAAC,KAAgB;IACtC,IAAI,CAAC,KAAK,CAAC,WAAW;QAAE,OAAO;IAC/B,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAChC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC;AAChC,CAAC;AAED,SAAS,YAAY,CAAC,SAAiC;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAwC;IACjE,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC;IAChD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,MAAM,CAAC,iBAAiB,CAAC;IACnE,IAAI,UAAU,GAAG,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACtF,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,GAAG,MAAM,IAAI,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe,EAAE,KAAe;IACxD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;AAClH,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1E,OAAO,gBAAgB,CAAC,kDAAkD,EAAE,KAAK,CAAC,CAAC;AACrF,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,QAAgB,EAChB,QAAsB;IAEtB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC;QAAE,OAAO;IAC7D,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO;QAC1C,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,OAAiC,CAAC;IACtC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxC,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;QACrD,MAAM,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,MAAM,KAAK,CAAC;IAClD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,SAAiB,EAAE,QAAgB;IAC7D,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,MAAM,KAAK,CAAC;IAClD,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC;YAAE,OAAO;QAC/G,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,SAAgC;IACvE,OAAO,GAAG,QAAQ,IAAI,SAAS,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,EAAE,CAAC;AACnE,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QACpD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAiD;IACrE,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;AAC5E,CAAC;AAED,SAAS,gBAAgB,CACvB,IAAgD,EAChD,KAAmB;IAEnB,OAAO,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,CAAC;AACpG,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,IAAY;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAC5F,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,KAAK,CAAC,YAAoB;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAU;IACxC,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC"}
@@ -0,0 +1,9 @@
1
+ import { type Logger, type LoggerLevel, type LogRecord } from '@felan-ai/agent-core';
2
+ export declare const FELAN_LOG_LEVEL_ENV = "FELAN_LOG_LEVEL";
3
+ export declare const LOCAL_AGENT_LOG_PATH: string;
4
+ export declare function resolveLocalLoggerLevel(value?: string | undefined): LoggerLevel;
5
+ export declare function createLocalAgentLogger(agentStorageRoot: string, level?: LoggerLevel): Logger;
6
+ export declare function appendLocalLogLine(agentStorageRoot: string, record: LogRecord): Promise<void>;
7
+ /** Masks credential-shaped substrings in diagnostics that may quote provider responses or credential files. */
8
+ export declare function redact(value: string): string;
9
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,oBAAoB,QAA8B,CAAC;AAEhE,wBAAgB,uBAAuB,CACrC,KAAK,GAAE,MAAM,GAAG,SAA4C,GAC3D,WAAW,CAIb;AAED,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,MAAM,EACxB,KAAK,GAAE,WAAuC,GAC7C,MAAM,CAUR;AAED,wBAAsB,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBnG;AAED,+GAA+G;AAC/G,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW5C"}
package/dist/logger.js ADDED
@@ -0,0 +1,56 @@
1
+ import { appendFile, mkdir } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+ import { createLogger, createSilentLogger, isLoggerLevel, } from '@felan-ai/agent-core';
4
+ export const FELAN_LOG_LEVEL_ENV = 'FELAN_LOG_LEVEL';
5
+ export const LOCAL_AGENT_LOG_PATH = join('logs', 'felan.jsonl');
6
+ export function resolveLocalLoggerLevel(value = process.env[FELAN_LOG_LEVEL_ENV]) {
7
+ const spec = value?.trim().toLowerCase();
8
+ if (!spec)
9
+ return 'debug';
10
+ return isLoggerLevel(spec) ? spec : 'debug';
11
+ }
12
+ export function createLocalAgentLogger(agentStorageRoot, level = resolveLocalLoggerLevel()) {
13
+ if (level === 'off')
14
+ return createSilentLogger();
15
+ return createLogger({
16
+ level,
17
+ destination: {
18
+ write: (record) => {
19
+ void appendLocalLogLine(agentStorageRoot, record);
20
+ },
21
+ },
22
+ });
23
+ }
24
+ export async function appendLocalLogLine(agentStorageRoot, record) {
25
+ try {
26
+ const directory = join(agentStorageRoot, 'logs');
27
+ await mkdir(directory, { recursive: true });
28
+ const payload = {
29
+ time: record.time,
30
+ level: record.level,
31
+ ...record.fields,
32
+ };
33
+ if (record.msg !== undefined)
34
+ payload.msg = record.msg;
35
+ await appendFile(join(agentStorageRoot, LOCAL_AGENT_LOG_PATH), `${redact(JSON.stringify(payload))}\n`, {
36
+ encoding: 'utf8',
37
+ });
38
+ }
39
+ catch {
40
+ /* logging must not affect the session */
41
+ }
42
+ }
43
+ /** Masks credential-shaped substrings in diagnostics that may quote provider responses or credential files. */
44
+ export function redact(value) {
45
+ return value
46
+ .replace(/\bBearer\s+[^\s,;]+/giu, 'Bearer [redacted]')
47
+ .replace(/\b([a-z][a-z0-9+.-]*:\/\/)[^\s/?#@:]+:[^\s/?#@]*@/giu, '$1[redacted]@')
48
+ .replace(/([?&](?:code|state|token|access_token|refresh_token|client_secret|key|api[_-]?key)=)[^&#\s]*/giu, '$1[redacted]')
49
+ .replace(/(["']?\b[\w-]*(?:api[_-]?key|token|secret|password|authorization|credential)[\w-]*["']?\s*[:=]\s*)("[^"]*"|'[^']*'|[^\s,;}&]+)/giu, '$1[redacted]')
50
+ .replace(/\bfln_pat_[A-Za-z0-9_-]+/gu, '[redacted]')
51
+ .replace(/\b(?:sk|pk|rk)-[A-Za-z0-9_-]{8,}/gu, '[redacted]')
52
+ .replace(/\b(?:gh[pousr]_|github_pat_|xox[abpr]-|AKIA)[A-Za-z0-9_-]{8,}/gu, '[redacted]')
53
+ .replace(/\bAIza[0-9A-Za-z_-]{20,}/gu, '[redacted]')
54
+ .replace(/\beyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/gu, '[redacted]');
55
+ }
56
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,GAId,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEhE,MAAM,UAAU,uBAAuB,CACrC,QAA4B,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAE5D,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC;IAC1B,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,gBAAwB,EACxB,QAAqB,uBAAuB,EAAE;IAE9C,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,kBAAkB,EAAE,CAAC;IACjD,OAAO,YAAY,CAAC;QAClB,KAAK;QACL,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE;gBAChB,KAAK,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;YACpD,CAAC;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,gBAAwB,EAAE,MAAiB;IAClF,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,OAAO,GAA4B;YACvC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,MAAM,CAAC,MAAM;SACjB,CAAC;QACF,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACvD,MAAM,UAAU,CAAC,IAAI,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;YACrG,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;IAC3C,CAAC;AACH,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,KAAK;SACT,OAAO,CAAC,wBAAwB,EAAE,mBAAmB,CAAC;SACtD,OAAO,CAAC,sDAAsD,EAAE,eAAe,CAAC;SAChF,OAAO,CAAC,iGAAiG,EAAE,cAAc,CAAC;SAC1H,OAAO,CAAC,mIAAmI,EAAE,cAAc,CAAC;SAC5J,OAAO,CAAC,4BAA4B,EAAE,YAAY,CAAC;SACnD,OAAO,CAAC,oCAAoC,EAAE,YAAY,CAAC;SAC3D,OAAO,CAAC,iEAAiE,EAAE,YAAY,CAAC;SACxF,OAAO,CAAC,4BAA4B,EAAE,YAAY,CAAC;SACnD,OAAO,CAAC,0DAA0D,EAAE,YAAY,CAAC,CAAC;AACvF,CAAC"}
@@ -0,0 +1,17 @@
1
+ export interface RetryOptions {
2
+ baseMs?: number;
3
+ capMs?: number;
4
+ random?: () => number;
5
+ }
6
+ export declare function retryDelay(attempt: number, options?: RetryOptions): number;
7
+ export interface TimerHandle {
8
+ unref?(): unknown;
9
+ }
10
+ export interface RemoteClock {
11
+ now(): number;
12
+ setTimeout(callback: () => void, delay: number): TimerHandle;
13
+ clearTimeout(timer: TimerHandle): void;
14
+ }
15
+ export declare const systemClock: RemoteClock;
16
+ export declare function schedule(clock: RemoteClock, callback: () => void, delay: number): TimerHandle;
17
+ //# sourceMappingURL=backoff.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../../src/remote/backoff.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAM9E;AAED,MAAM,WAAW,WAAW;IAAG,KAAK,CAAC,IAAI,OAAO,CAAA;CAAE;AAClD,MAAM,WAAW,WAAW;IAC1B,GAAG,IAAI,MAAM,CAAC;IACd,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7D,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CACxC;AAED,eAAO,MAAM,WAAW,EAAE,WAIzB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAI7F"}
@@ -0,0 +1,18 @@
1
+ export function retryDelay(attempt, options = {}) {
2
+ const base = options.baseMs ?? 1_000;
3
+ const cap = options.capMs ?? 60_000;
4
+ const ceiling = Math.min(cap, base * 2 ** Math.min(Math.max(0, attempt), 30));
5
+ const random = Math.min(1, Math.max(0, (options.random ?? Math.random)()));
6
+ return Math.ceil(ceiling * (0.5 + random * 0.5));
7
+ }
8
+ export const systemClock = {
9
+ now: () => Date.now(),
10
+ setTimeout: (callback, delay) => setTimeout(callback, delay),
11
+ clearTimeout: timer => clearTimeout(timer),
12
+ };
13
+ export function schedule(clock, callback, delay) {
14
+ const timer = clock.setTimeout(callback, Math.max(0, delay));
15
+ timer.unref?.();
16
+ return timer;
17
+ }
18
+ //# sourceMappingURL=backoff.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backoff.js","sourceRoot":"","sources":["../../src/remote/backoff.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,UAAwB,EAAE;IACpE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC;AASD,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,UAAU,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC;IAC5D,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,KAAsC,CAAC;CAC5E,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,KAAkB,EAAE,QAAoB,EAAE,KAAa;IAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7D,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAChB,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -0,0 +1,3 @@
1
+ import { type PublishedEvent, type PublishedSession } from '@felan-ai/session-protocol';
2
+ export declare function publicationBatches(session: PublishedSession, events: readonly PublishedEvent[]): PublishedEvent[][];
3
+ //# sourceMappingURL=batch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/remote/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE5G,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,EAAE,EAAE,CAenH"}
@@ -0,0 +1,27 @@
1
+ import { PUBLICATION_LIMITS } from '@felan-ai/session-protocol';
2
+ export function publicationBatches(session, events) {
3
+ const envelopeBytes = Buffer.byteLength(JSON.stringify({ p_session: session, p_events: [] }));
4
+ if (envelopeBytes > PUBLICATION_LIMITS.batchBytes)
5
+ throw new Error('Publication session exceeds the batch byte limit.');
6
+ const batches = [];
7
+ let batch = [];
8
+ let bytes = envelopeBytes;
9
+ for (const event of events) {
10
+ const eventBytes = Buffer.byteLength(JSON.stringify(event));
11
+ if (event.session !== session.session)
12
+ throw new Error('Publication event belongs to another session.');
13
+ if (Buffer.byteLength(JSON.stringify(event.change)) > PUBLICATION_LIMITS.changeBytes || envelopeBytes + eventBytes > PUBLICATION_LIMITS.batchBytes)
14
+ throw new Error('Publication event exceeds the byte limit.');
15
+ if (batch.length >= PUBLICATION_LIMITS.eventsPerBatch || bytes + eventBytes + (batch.length ? 1 : 0) > PUBLICATION_LIMITS.batchBytes) {
16
+ batches.push(batch);
17
+ batch = [];
18
+ bytes = envelopeBytes;
19
+ }
20
+ bytes += eventBytes + (batch.length ? 1 : 0);
21
+ batch.push(event);
22
+ }
23
+ if (batch.length || !batches.length)
24
+ batches.push(batch);
25
+ return batches;
26
+ }
27
+ //# sourceMappingURL=batch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"batch.js","sourceRoot":"","sources":["../../src/remote/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA8C,MAAM,4BAA4B,CAAC;AAE5G,MAAM,UAAU,kBAAkB,CAAC,OAAyB,EAAE,MAAiC;IAC7F,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9F,IAAI,aAAa,GAAG,kBAAkB,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACxH,MAAM,OAAO,GAAuB,EAAE,CAAC;IAAC,IAAI,KAAK,GAAqB,EAAE,CAAC;IAAC,IAAI,KAAK,GAAG,aAAa,CAAC;IACpG,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5D,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACxG,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,kBAAkB,CAAC,WAAW,IAAI,aAAa,GAAG,UAAU,GAAG,kBAAkB,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACjN,IAAI,KAAK,CAAC,MAAM,IAAI,kBAAkB,CAAC,cAAc,IAAI,KAAK,GAAG,UAAU,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,UAAU,EAAE,CAAC;YACrI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAC,KAAK,GAAG,EAAE,CAAC;YAAC,KAAK,GAAG,aAAa,CAAC;QACzD,CAAC;QACD,KAAK,IAAI,UAAU,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,30 @@
1
+ import type { RemoteDatabase } from '../daemon/persistence.js';
2
+ import { type ClientEnvelope, type RemoteCommandOutcome } from '@felan-ai/session-protocol';
3
+ export type RemoteCommandJournalEntry = {
4
+ id: string;
5
+ identity: string;
6
+ state: 'dispatching';
7
+ request: ClientEnvelope;
8
+ createdSession?: string;
9
+ } | {
10
+ id: string;
11
+ identity: string;
12
+ state: 'completed';
13
+ outcome: RemoteCommandOutcome;
14
+ };
15
+ export interface CommandJournal {
16
+ get(id: string): RemoteCommandJournalEntry | undefined;
17
+ write(entry: RemoteCommandJournalEntry): void;
18
+ forget(id: string): void;
19
+ }
20
+ export declare class RemoteCommandJournal implements CommandJournal {
21
+ private readonly database;
22
+ private readonly capacity;
23
+ private count;
24
+ constructor(database: RemoteDatabase, capacity?: number);
25
+ get(id: string): RemoteCommandJournalEntry | undefined;
26
+ write(entry: RemoteCommandJournalEntry): void;
27
+ forget(id: string): void;
28
+ private validate;
29
+ }
30
+ //# sourceMappingURL=command-journal.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"command-journal.d.ts","sourceRoot":"","sources":["../../src/remote/command-journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAoE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAG9J,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACxG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAExF,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS,CAAC;IACvD,KAAK,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC9C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qBAAa,oBAAqB,YAAW,cAAc;IAE7C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAkB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IADhF,OAAO,CAAC,KAAK,CAAqB;gBACL,QAAQ,EAAE,cAAc,EAAmB,QAAQ,SAAO;IAKvF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS;IAStD,KAAK,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI;IAW7C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQxB,OAAO,CAAC,QAAQ;CAmBjB"}