@amaranthic/hernex 0.0.0-stage → 0.3.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 (272) hide show
  1. package/CHANGELOG.md +261 -0
  2. package/LICENSE +21 -0
  3. package/README.md +66 -2
  4. package/dist/ai.d.ts +11 -0
  5. package/dist/ai.d.ts.map +1 -0
  6. package/dist/ai.js +11 -0
  7. package/dist/ai.js.map +1 -0
  8. package/dist/checkpoints/FileCheckpointStore.d.ts +95 -0
  9. package/dist/checkpoints/FileCheckpointStore.d.ts.map +1 -0
  10. package/dist/checkpoints/FileCheckpointStore.js +502 -0
  11. package/dist/checkpoints/FileCheckpointStore.js.map +1 -0
  12. package/dist/checkpoints/index.d.ts +7 -0
  13. package/dist/checkpoints/index.d.ts.map +1 -0
  14. package/dist/checkpoints/index.js +7 -0
  15. package/dist/checkpoints/index.js.map +1 -0
  16. package/dist/checkpoints/types.d.ts +157 -0
  17. package/dist/checkpoints/types.d.ts.map +1 -0
  18. package/dist/checkpoints/types.js +6 -0
  19. package/dist/checkpoints/types.js.map +1 -0
  20. package/dist/engine/AgentEngine.d.ts +156 -0
  21. package/dist/engine/AgentEngine.d.ts.map +1 -0
  22. package/dist/engine/AgentEngine.js +290 -0
  23. package/dist/engine/AgentEngine.js.map +1 -0
  24. package/dist/engine/engineConfig.d.ts +138 -0
  25. package/dist/engine/engineConfig.d.ts.map +1 -0
  26. package/dist/engine/engineConfig.js +6 -0
  27. package/dist/engine/engineConfig.js.map +1 -0
  28. package/dist/engine/eventQueue.d.ts +42 -0
  29. package/dist/engine/eventQueue.d.ts.map +1 -0
  30. package/dist/engine/eventQueue.js +93 -0
  31. package/dist/engine/eventQueue.js.map +1 -0
  32. package/dist/engine/index.d.ts +7 -0
  33. package/dist/engine/index.d.ts.map +1 -0
  34. package/dist/engine/index.js +6 -0
  35. package/dist/engine/index.js.map +1 -0
  36. package/dist/engine/runTurn.d.ts +17 -0
  37. package/dist/engine/runTurn.d.ts.map +1 -0
  38. package/dist/engine/runTurn.js +718 -0
  39. package/dist/engine/runTurn.js.map +1 -0
  40. package/dist/errors.d.ts +194 -0
  41. package/dist/errors.d.ts.map +1 -0
  42. package/dist/errors.js +219 -0
  43. package/dist/errors.js.map +1 -0
  44. package/dist/events/checkpointEvents.d.ts +20 -0
  45. package/dist/events/checkpointEvents.d.ts.map +1 -0
  46. package/dist/events/checkpointEvents.js +6 -0
  47. package/dist/events/checkpointEvents.js.map +1 -0
  48. package/dist/events/errorEvents.d.ts +23 -0
  49. package/dist/events/errorEvents.d.ts.map +1 -0
  50. package/dist/events/errorEvents.js +6 -0
  51. package/dist/events/errorEvents.js.map +1 -0
  52. package/dist/events/index.d.ts +11 -0
  53. package/dist/events/index.d.ts.map +1 -0
  54. package/dist/events/index.js +6 -0
  55. package/dist/events/index.js.map +1 -0
  56. package/dist/events/stepEvents.d.ts +68 -0
  57. package/dist/events/stepEvents.d.ts.map +1 -0
  58. package/dist/events/stepEvents.js +6 -0
  59. package/dist/events/stepEvents.js.map +1 -0
  60. package/dist/events/streamEvents.d.ts +41 -0
  61. package/dist/events/streamEvents.d.ts.map +1 -0
  62. package/dist/events/streamEvents.js +6 -0
  63. package/dist/events/streamEvents.js.map +1 -0
  64. package/dist/events/toolEvents.d.ts +64 -0
  65. package/dist/events/toolEvents.d.ts.map +1 -0
  66. package/dist/events/toolEvents.js +6 -0
  67. package/dist/events/toolEvents.js.map +1 -0
  68. package/dist/events/types.d.ts +44 -0
  69. package/dist/events/types.d.ts.map +1 -0
  70. package/dist/events/types.js +25 -0
  71. package/dist/events/types.js.map +1 -0
  72. package/dist/hooks/composeAgentHooks.d.ts +14 -0
  73. package/dist/hooks/composeAgentHooks.d.ts.map +1 -0
  74. package/dist/hooks/composeAgentHooks.js +154 -0
  75. package/dist/hooks/composeAgentHooks.js.map +1 -0
  76. package/dist/hooks/index.d.ts +7 -0
  77. package/dist/hooks/index.d.ts.map +1 -0
  78. package/dist/hooks/index.js +6 -0
  79. package/dist/hooks/index.js.map +1 -0
  80. package/dist/hooks/types.d.ts +133 -0
  81. package/dist/hooks/types.d.ts.map +1 -0
  82. package/dist/hooks/types.js +6 -0
  83. package/dist/hooks/types.js.map +1 -0
  84. package/dist/index.d.ts +28 -0
  85. package/dist/index.d.ts.map +1 -0
  86. package/dist/index.js +26 -0
  87. package/dist/index.js.map +1 -0
  88. package/dist/model/ProviderRegistry.d.ts +62 -0
  89. package/dist/model/ProviderRegistry.d.ts.map +1 -0
  90. package/dist/model/ProviderRegistry.js +114 -0
  91. package/dist/model/ProviderRegistry.js.map +1 -0
  92. package/dist/model/providers/alibaba.d.ts +11 -0
  93. package/dist/model/providers/alibaba.d.ts.map +1 -0
  94. package/dist/model/providers/alibaba.js +16 -0
  95. package/dist/model/providers/alibaba.js.map +1 -0
  96. package/dist/model/providers/anthropic.d.ts +11 -0
  97. package/dist/model/providers/anthropic.d.ts.map +1 -0
  98. package/dist/model/providers/anthropic.js +16 -0
  99. package/dist/model/providers/anthropic.js.map +1 -0
  100. package/dist/model/providers/cohere.d.ts +11 -0
  101. package/dist/model/providers/cohere.d.ts.map +1 -0
  102. package/dist/model/providers/cohere.js +16 -0
  103. package/dist/model/providers/cohere.js.map +1 -0
  104. package/dist/model/providers/compatible.d.ts +11 -0
  105. package/dist/model/providers/compatible.d.ts.map +1 -0
  106. package/dist/model/providers/compatible.js +17 -0
  107. package/dist/model/providers/compatible.js.map +1 -0
  108. package/dist/model/providers/deepseek.d.ts +11 -0
  109. package/dist/model/providers/deepseek.d.ts.map +1 -0
  110. package/dist/model/providers/deepseek.js +16 -0
  111. package/dist/model/providers/deepseek.js.map +1 -0
  112. package/dist/model/providers/google.d.ts +11 -0
  113. package/dist/model/providers/google.d.ts.map +1 -0
  114. package/dist/model/providers/google.js +16 -0
  115. package/dist/model/providers/google.js.map +1 -0
  116. package/dist/model/providers/groq.d.ts +11 -0
  117. package/dist/model/providers/groq.d.ts.map +1 -0
  118. package/dist/model/providers/groq.js +16 -0
  119. package/dist/model/providers/groq.js.map +1 -0
  120. package/dist/model/providers/mistral.d.ts +11 -0
  121. package/dist/model/providers/mistral.d.ts.map +1 -0
  122. package/dist/model/providers/mistral.js +16 -0
  123. package/dist/model/providers/mistral.js.map +1 -0
  124. package/dist/model/providers/openai.d.ts +11 -0
  125. package/dist/model/providers/openai.d.ts.map +1 -0
  126. package/dist/model/providers/openai.js +16 -0
  127. package/dist/model/providers/openai.js.map +1 -0
  128. package/dist/model/providers/openrouter.d.ts +14 -0
  129. package/dist/model/providers/openrouter.d.ts.map +1 -0
  130. package/dist/model/providers/openrouter.js +20 -0
  131. package/dist/model/providers/openrouter.js.map +1 -0
  132. package/dist/model/providers/togetherai.d.ts +11 -0
  133. package/dist/model/providers/togetherai.d.ts.map +1 -0
  134. package/dist/model/providers/togetherai.js +16 -0
  135. package/dist/model/providers/togetherai.js.map +1 -0
  136. package/dist/model/providers/vercelGateway.d.ts +14 -0
  137. package/dist/model/providers/vercelGateway.d.ts.map +1 -0
  138. package/dist/model/providers/vercelGateway.js +19 -0
  139. package/dist/model/providers/vercelGateway.js.map +1 -0
  140. package/dist/model/providers/xai.d.ts +11 -0
  141. package/dist/model/providers/xai.d.ts.map +1 -0
  142. package/dist/model/providers/xai.js +16 -0
  143. package/dist/model/providers/xai.js.map +1 -0
  144. package/dist/model/resolveModel.d.ts +45 -0
  145. package/dist/model/resolveModel.d.ts.map +1 -0
  146. package/dist/model/resolveModel.js +109 -0
  147. package/dist/model/resolveModel.js.map +1 -0
  148. package/dist/model/types.d.ts +98 -0
  149. package/dist/model/types.d.ts.map +1 -0
  150. package/dist/model/types.js +6 -0
  151. package/dist/model/types.js.map +1 -0
  152. package/dist/runtime.d.ts +74 -0
  153. package/dist/runtime.d.ts.map +1 -0
  154. package/dist/runtime.js +41 -0
  155. package/dist/runtime.js.map +1 -0
  156. package/dist/storage/atomicFile.d.ts +28 -0
  157. package/dist/storage/atomicFile.d.ts.map +1 -0
  158. package/dist/storage/atomicFile.js +82 -0
  159. package/dist/storage/atomicFile.js.map +1 -0
  160. package/dist/storage/homeDirectory.d.ts +21 -0
  161. package/dist/storage/homeDirectory.d.ts.map +1 -0
  162. package/dist/storage/homeDirectory.js +36 -0
  163. package/dist/storage/homeDirectory.js.map +1 -0
  164. package/dist/storage/index.d.ts +11 -0
  165. package/dist/storage/index.d.ts.map +1 -0
  166. package/dist/storage/index.js +11 -0
  167. package/dist/storage/index.js.map +1 -0
  168. package/dist/storage/jsonl.d.ts +55 -0
  169. package/dist/storage/jsonl.d.ts.map +1 -0
  170. package/dist/storage/jsonl.js +142 -0
  171. package/dist/storage/jsonl.js.map +1 -0
  172. package/dist/storage/lock.d.ts +70 -0
  173. package/dist/storage/lock.d.ts.map +1 -0
  174. package/dist/storage/lock.js +274 -0
  175. package/dist/storage/lock.js.map +1 -0
  176. package/dist/storage/valueCodec.d.ts +74 -0
  177. package/dist/storage/valueCodec.d.ts.map +1 -0
  178. package/dist/storage/valueCodec.js +165 -0
  179. package/dist/storage/valueCodec.js.map +1 -0
  180. package/dist/storage/workspaceLock.d.ts +38 -0
  181. package/dist/storage/workspaceLock.d.ts.map +1 -0
  182. package/dist/storage/workspaceLock.js +77 -0
  183. package/dist/storage/workspaceLock.js.map +1 -0
  184. package/dist/tasks/TaskManager.d.ts +155 -0
  185. package/dist/tasks/TaskManager.d.ts.map +1 -0
  186. package/dist/tasks/TaskManager.js +810 -0
  187. package/dist/tasks/TaskManager.js.map +1 -0
  188. package/dist/tasks/index.d.ts +7 -0
  189. package/dist/tasks/index.d.ts.map +1 -0
  190. package/dist/tasks/index.js +6 -0
  191. package/dist/tasks/index.js.map +1 -0
  192. package/dist/tasks/types.d.ts +166 -0
  193. package/dist/tasks/types.d.ts.map +1 -0
  194. package/dist/tasks/types.js +8 -0
  195. package/dist/tasks/types.js.map +1 -0
  196. package/dist/threads/FileThreadStore.d.ts +118 -0
  197. package/dist/threads/FileThreadStore.d.ts.map +1 -0
  198. package/dist/threads/FileThreadStore.js +324 -0
  199. package/dist/threads/FileThreadStore.js.map +1 -0
  200. package/dist/threads/index.d.ts +9 -0
  201. package/dist/threads/index.d.ts.map +1 -0
  202. package/dist/threads/index.js +9 -0
  203. package/dist/threads/index.js.map +1 -0
  204. package/dist/threads/transcriptMigration.d.ts +52 -0
  205. package/dist/threads/transcriptMigration.d.ts.map +1 -0
  206. package/dist/threads/transcriptMigration.js +100 -0
  207. package/dist/threads/transcriptMigration.js.map +1 -0
  208. package/dist/threads/transcriptProjection.d.ts +21 -0
  209. package/dist/threads/transcriptProjection.d.ts.map +1 -0
  210. package/dist/threads/transcriptProjection.js +123 -0
  211. package/dist/threads/transcriptProjection.js.map +1 -0
  212. package/dist/threads/types.d.ts +250 -0
  213. package/dist/threads/types.d.ts.map +1 -0
  214. package/dist/threads/types.js +6 -0
  215. package/dist/threads/types.js.map +1 -0
  216. package/dist/tools/AgentTool.d.ts +38 -0
  217. package/dist/tools/AgentTool.d.ts.map +1 -0
  218. package/dist/tools/AgentTool.js +6 -0
  219. package/dist/tools/AgentTool.js.map +1 -0
  220. package/dist/tools/BashTool.d.ts +61 -0
  221. package/dist/tools/BashTool.d.ts.map +1 -0
  222. package/dist/tools/BashTool.js +158 -0
  223. package/dist/tools/BashTool.js.map +1 -0
  224. package/dist/tools/EditFileTool.d.ts +49 -0
  225. package/dist/tools/EditFileTool.d.ts.map +1 -0
  226. package/dist/tools/EditFileTool.js +119 -0
  227. package/dist/tools/EditFileTool.js.map +1 -0
  228. package/dist/tools/GlobTool.d.ts +48 -0
  229. package/dist/tools/GlobTool.d.ts.map +1 -0
  230. package/dist/tools/GlobTool.js +117 -0
  231. package/dist/tools/GlobTool.js.map +1 -0
  232. package/dist/tools/GrepTool.d.ts +76 -0
  233. package/dist/tools/GrepTool.d.ts.map +1 -0
  234. package/dist/tools/GrepTool.js +276 -0
  235. package/dist/tools/GrepTool.js.map +1 -0
  236. package/dist/tools/ReadFileTool.d.ts +51 -0
  237. package/dist/tools/ReadFileTool.d.ts.map +1 -0
  238. package/dist/tools/ReadFileTool.js +153 -0
  239. package/dist/tools/ReadFileTool.js.map +1 -0
  240. package/dist/tools/TaskManagerTool.d.ts +102 -0
  241. package/dist/tools/TaskManagerTool.d.ts.map +1 -0
  242. package/dist/tools/TaskManagerTool.js +132 -0
  243. package/dist/tools/TaskManagerTool.js.map +1 -0
  244. package/dist/tools/ToolExecutionContext.d.ts +61 -0
  245. package/dist/tools/ToolExecutionContext.d.ts.map +1 -0
  246. package/dist/tools/ToolExecutionContext.js +8 -0
  247. package/dist/tools/ToolExecutionContext.js.map +1 -0
  248. package/dist/tools/ToolRegistry.d.ts +82 -0
  249. package/dist/tools/ToolRegistry.d.ts.map +1 -0
  250. package/dist/tools/ToolRegistry.js +116 -0
  251. package/dist/tools/ToolRegistry.js.map +1 -0
  252. package/dist/tools/WriteFileTool.d.ts +46 -0
  253. package/dist/tools/WriteFileTool.d.ts.map +1 -0
  254. package/dist/tools/WriteFileTool.js +92 -0
  255. package/dist/tools/WriteFileTool.js.map +1 -0
  256. package/dist/tools/index.d.ts +17 -0
  257. package/dist/tools/index.d.ts.map +1 -0
  258. package/dist/tools/index.js +17 -0
  259. package/dist/tools/index.js.map +1 -0
  260. package/dist/tools/internal/bashEnvironment.d.ts +20 -0
  261. package/dist/tools/internal/bashEnvironment.d.ts.map +1 -0
  262. package/dist/tools/internal/bashEnvironment.js +65 -0
  263. package/dist/tools/internal/bashEnvironment.js.map +1 -0
  264. package/dist/tools/internal/pathGuard.d.ts +27 -0
  265. package/dist/tools/internal/pathGuard.d.ts.map +1 -0
  266. package/dist/tools/internal/pathGuard.js +99 -0
  267. package/dist/tools/internal/pathGuard.js.map +1 -0
  268. package/dist/tools/prompts.d.ts +33 -0
  269. package/dist/tools/prompts.d.ts.map +1 -0
  270. package/dist/tools/prompts.js +48 -0
  271. package/dist/tools/prompts.js.map +1 -0
  272. package/package.json +65 -4
@@ -0,0 +1,324 @@
1
+ /**
2
+ * @fileoverview Filesystem-backed ThreadStore with durable thread.json and transcript.jsonl.
3
+ * @packageDocumentation
4
+ */
5
+ import { randomUUID } from "node:crypto";
6
+ import { existsSync } from "node:fs";
7
+ import { mkdir, readFile, rm } from "node:fs/promises";
8
+ import path from "node:path";
9
+ import { atomicWriteFile } from "../storage/atomicFile.js";
10
+ import { resolveHomeDirectory, } from "../storage/homeDirectory.js";
11
+ import { appendJsonl, readJsonl, writeJsonl } from "../storage/jsonl.js";
12
+ import { withFileLock } from "../storage/lock.js";
13
+ import { runTranscriptMigrationPipeline } from "./transcriptMigration.js";
14
+ import { projectModelMessages } from "./transcriptProjection.js";
15
+ /** Regular expression for validating safe thread identifiers. */
16
+ const THREAD_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
17
+ /**
18
+ * File-backed ThreadStore implementation managing thread directories,
19
+ * metadata snapshots, and append-only transcripts.
20
+ */
21
+ export class FileThreadStore {
22
+ rootDir;
23
+ /**
24
+ * Initializes a new FileThreadStore instance.
25
+ *
26
+ * @param options - Optional configuration options including custom home directory.
27
+ */
28
+ constructor(options) {
29
+ this.rootDir = resolveHomeDirectory(options);
30
+ }
31
+ /**
32
+ * Validates that a thread identifier conforms to safe naming grammar.
33
+ *
34
+ * @param threadId - Candidate identifier to validate.
35
+ * @throws Error if threadId is empty, invalid, or contains path traversal characters.
36
+ */
37
+ validateThreadId(threadId) {
38
+ if (!threadId ||
39
+ typeof threadId !== "string" ||
40
+ !THREAD_ID_PATTERN.test(threadId)) {
41
+ throw new Error(`Invalid thread identifier: "${threadId}"`);
42
+ }
43
+ }
44
+ /**
45
+ * Resolves the canonical directory for a given thread identifier.
46
+ *
47
+ * @param threadId - Safe thread identifier.
48
+ * @returns Absolute path to the thread directory.
49
+ */
50
+ getThreadDir(threadId) {
51
+ this.validateThreadId(threadId);
52
+ return path.join(this.rootDir, "threads", threadId);
53
+ }
54
+ /**
55
+ * Resolves the out-of-directory lock file path for a thread.
56
+ *
57
+ * @param threadId - Safe thread identifier.
58
+ * @returns Absolute path to the thread lock file located in `<rootDir>/locks/threads/<threadId>.lock`.
59
+ */
60
+ getLockPath(threadId) {
61
+ this.validateThreadId(threadId);
62
+ return path.join(this.rootDir, "locks", "threads", `${threadId}.lock`);
63
+ }
64
+ /**
65
+ * Creates a new thread directory and initializes its `thread.json` metadata.
66
+ *
67
+ * @param input - Thread creation parameters.
68
+ * @returns Newly created thread metadata.
69
+ */
70
+ async createThread(input) {
71
+ const id = input.id ?? randomUUID();
72
+ this.validateThreadId(id);
73
+ const threadsParent = path.join(this.rootDir, "threads");
74
+ await mkdir(threadsParent, { recursive: true });
75
+ const threadDir = this.getThreadDir(id);
76
+ if (existsSync(threadDir)) {
77
+ throw new Error(`Thread already exists: "${id}"`);
78
+ }
79
+ try {
80
+ await mkdir(threadDir, { recursive: false });
81
+ }
82
+ catch (mkdirError) {
83
+ const error = mkdirError;
84
+ if (error?.code === "EEXIST") {
85
+ throw new Error(`Thread already exists: "${id}"`);
86
+ }
87
+ throw mkdirError;
88
+ }
89
+ const now = new Date().toISOString();
90
+ const initialUsage = {
91
+ promptTokens: 0,
92
+ completionTokens: 0,
93
+ totalTokens: 0,
94
+ reasoningTokens: 0,
95
+ };
96
+ const metadata = {
97
+ version: 1,
98
+ id,
99
+ createdAt: now,
100
+ updatedAt: now,
101
+ title: input.title,
102
+ tags: input.tags ?? [],
103
+ workingDirectory: input.workingDirectory,
104
+ model: input.model,
105
+ provider: input.provider,
106
+ reasoning: input.reasoning,
107
+ turnCount: 0,
108
+ status: "idle",
109
+ activeTranscriptSequence: 0,
110
+ usage: initialUsage,
111
+ };
112
+ const metadataPath = path.join(threadDir, "thread.json");
113
+ await atomicWriteFile(metadataPath, JSON.stringify(metadata, null, 2));
114
+ return metadata;
115
+ }
116
+ /**
117
+ * Internal unlocked helper to read thread metadata without acquiring a file lock.
118
+ *
119
+ * @param threadId - Safe thread identifier.
120
+ * @returns Thread metadata snapshot or undefined if not found.
121
+ */
122
+ async getThreadUnlocked(threadId) {
123
+ const metadataPath = path.join(this.getThreadDir(threadId), "thread.json");
124
+ if (!existsSync(metadataPath)) {
125
+ return undefined;
126
+ }
127
+ const raw = await readFile(metadataPath, "utf-8");
128
+ return JSON.parse(raw);
129
+ }
130
+ /**
131
+ * Retrieves metadata for an existing thread under file lock.
132
+ *
133
+ * @param threadId - Safe thread identifier.
134
+ * @returns Thread metadata snapshot or undefined if not found.
135
+ */
136
+ async getThread(threadId) {
137
+ this.validateThreadId(threadId);
138
+ const lockPath = this.getLockPath(threadId);
139
+ return await withFileLock(lockPath, async () => {
140
+ return this.getThreadUnlocked(threadId);
141
+ });
142
+ }
143
+ /**
144
+ * Lists available thread metadata snapshots matching optional filters.
145
+ *
146
+ * @param options - Filtering and pagination options.
147
+ * @returns Readonly array of thread metadata summaries.
148
+ */
149
+ async listThreads(options) {
150
+ const threadsRoot = path.join(this.rootDir, "threads");
151
+ if (!existsSync(threadsRoot)) {
152
+ return [];
153
+ }
154
+ const { readdir } = await import("node:fs/promises");
155
+ const entries = await readdir(threadsRoot, { withFileTypes: true });
156
+ const list = [];
157
+ for (const entry of entries) {
158
+ if (entry.isDirectory() && THREAD_ID_PATTERN.test(entry.name)) {
159
+ const thread = await this.getThread(entry.name);
160
+ if (thread) {
161
+ if (!options?.workingDirectory ||
162
+ thread.workingDirectory === options.workingDirectory) {
163
+ list.push(thread);
164
+ }
165
+ }
166
+ }
167
+ }
168
+ list.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
169
+ return options?.limit && options.limit > 0
170
+ ? list.slice(0, options.limit)
171
+ : list;
172
+ }
173
+ /**
174
+ * Updates an existing thread's metadata fields using an explicit UpdateThreadInput patch.
175
+ *
176
+ * @param threadId - Safe thread identifier.
177
+ * @param patch - Allowed metadata patch fields.
178
+ * @returns Updated thread metadata snapshot.
179
+ */
180
+ async updateThread(threadId, patch) {
181
+ this.validateThreadId(threadId);
182
+ const lockPath = this.getLockPath(threadId);
183
+ return await withFileLock(lockPath, async () => {
184
+ const current = await this.getThreadUnlocked(threadId);
185
+ if (!current) {
186
+ throw new Error(`Thread not found: "${threadId}"`);
187
+ }
188
+ const updated = {
189
+ ...current,
190
+ title: patch.title !== undefined ? patch.title : current.title,
191
+ tags: patch.tags !== undefined ? patch.tags : current.tags,
192
+ model: patch.model !== undefined ? patch.model : current.model,
193
+ provider: patch.provider !== undefined ? patch.provider : current.provider,
194
+ reasoning: patch.reasoning !== undefined ? patch.reasoning : current.reasoning,
195
+ updatedAt: new Date().toISOString(),
196
+ };
197
+ const metadataPath = path.join(this.getThreadDir(threadId), "thread.json");
198
+ await atomicWriteFile(metadataPath, JSON.stringify(updated, null, 2));
199
+ return updated;
200
+ });
201
+ }
202
+ /**
203
+ * Deletes a thread directory and its contents under external file lock.
204
+ *
205
+ * @param threadId - Safe thread identifier.
206
+ * @returns True if thread existed and was deleted, false otherwise.
207
+ */
208
+ async deleteThread(threadId) {
209
+ this.validateThreadId(threadId);
210
+ const lockPath = this.getLockPath(threadId);
211
+ return await withFileLock(lockPath, async () => {
212
+ const threadDir = this.getThreadDir(threadId);
213
+ if (!existsSync(threadDir)) {
214
+ return false;
215
+ }
216
+ await rm(threadDir, { recursive: true, force: true });
217
+ return true;
218
+ });
219
+ }
220
+ /**
221
+ * Appends an entry to the append-only thread transcript log under thread lock.
222
+ * Updates active sequence, turnCount, status, lastUserPromptPreview, and usage.
223
+ *
224
+ * @param threadId - Safe thread identifier.
225
+ * @param entry - New unsequenced transcript entry.
226
+ * @returns Sequenced and persisted transcript entry.
227
+ */
228
+ async appendTranscript(threadId, entry) {
229
+ this.validateThreadId(threadId);
230
+ const lockPath = this.getLockPath(threadId);
231
+ return await withFileLock(lockPath, async () => {
232
+ const current = await this.getThreadUnlocked(threadId);
233
+ if (!current) {
234
+ throw new Error(`Thread not found: "${threadId}"`);
235
+ }
236
+ const sequence = current.activeTranscriptSequence + 1;
237
+ const fullEntry = { ...entry, sequence };
238
+ const threadDir = this.getThreadDir(threadId);
239
+ const transcriptPath = path.join(threadDir, "transcript.jsonl");
240
+ await appendJsonl(transcriptPath, fullEntry);
241
+ let turnCount = current.turnCount;
242
+ let status = current.status;
243
+ let lastUserPromptPreview = current.lastUserPromptPreview;
244
+ let usage = current.usage;
245
+ if (entry.type === "turnStarted") {
246
+ turnCount += 1;
247
+ status = "running";
248
+ lastUserPromptPreview = entry.userPrompt;
249
+ }
250
+ else if (entry.type === "turnFinished") {
251
+ status = entry.finishReason === "error" ? "error" : "idle";
252
+ if (entry.usage) {
253
+ usage = {
254
+ promptTokens: (current.usage.promptTokens ?? 0) +
255
+ (entry.usage.promptTokens ?? 0),
256
+ completionTokens: (current.usage.completionTokens ?? 0) +
257
+ (entry.usage.completionTokens ?? 0),
258
+ totalTokens: (current.usage.totalTokens ?? 0) + (entry.usage.totalTokens ?? 0),
259
+ reasoningTokens: (current.usage.reasoningTokens ?? 0) +
260
+ (entry.usage.reasoningTokens ?? 0),
261
+ };
262
+ }
263
+ }
264
+ const updatedMetadata = {
265
+ ...current,
266
+ turnCount,
267
+ status,
268
+ activeTranscriptSequence: sequence,
269
+ lastUserPromptPreview,
270
+ usage,
271
+ updatedAt: new Date().toISOString(),
272
+ };
273
+ const metadataPath = path.join(threadDir, "thread.json");
274
+ await atomicWriteFile(metadataPath, JSON.stringify(updatedMetadata, null, 2));
275
+ return fullEntry;
276
+ });
277
+ }
278
+ /**
279
+ * Internal unlocked helper to read the transcript entries from disk.
280
+ *
281
+ * @param threadId - Safe thread identifier.
282
+ * @returns Readonly array of sequenced transcript entries.
283
+ */
284
+ async getTranscriptUnlocked(threadId) {
285
+ const transcriptPath = path.join(this.getThreadDir(threadId), "transcript.jsonl");
286
+ if (!existsSync(transcriptPath)) {
287
+ return [];
288
+ }
289
+ const rawEntries = await readJsonl(transcriptPath);
290
+ const { entries, wasMigrated } = runTranscriptMigrationPipeline(rawEntries);
291
+ if (wasMigrated) {
292
+ await writeJsonl(transcriptPath, entries);
293
+ }
294
+ return entries;
295
+ }
296
+ /**
297
+ * Reads the full append-only transcript log for a thread under thread lock.
298
+ *
299
+ * @param threadId - Safe thread identifier.
300
+ * @returns Readonly array of sequenced transcript entries.
301
+ */
302
+ async getTranscript(threadId) {
303
+ this.validateThreadId(threadId);
304
+ const lockPath = this.getLockPath(threadId);
305
+ return await withFileLock(lockPath, async () => {
306
+ return this.getTranscriptUnlocked(threadId);
307
+ });
308
+ }
309
+ /**
310
+ * Projects conversational model messages from the authoritative transcript under thread lock.
311
+ *
312
+ * @param threadId - Safe thread identifier.
313
+ * @returns Readonly array of ModelMessage items for model invocation.
314
+ */
315
+ async getMessages(threadId) {
316
+ this.validateThreadId(threadId);
317
+ const lockPath = this.getLockPath(threadId);
318
+ return await withFileLock(lockPath, async () => {
319
+ const transcript = await this.getTranscriptUnlocked(threadId);
320
+ return projectModelMessages(transcript);
321
+ });
322
+ }
323
+ }
324
+ //# sourceMappingURL=FileThreadStore.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FileThreadStore.js","sources":["../../src/threads/FileThreadStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,oBAAoB,GAErB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAWjE,iEAAiE;AACjE,MAAM,iBAAiB,GAAG,mCAAmC,CAAC;AAE9D;;;GAGG;AACH,MAAM,OAAO,eAAe;IACT,OAAO,CAAS;IAEjC;;;;OAIG;IACH,YAAmB,OAAqC;QACtD,IAAI,CAAC,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,QAAgB;QACvC,IACE,CAAC,QAAQ;YACT,OAAO,QAAQ,KAAK,QAAQ;YAC5B,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,EACjC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,GAAG,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,YAAY,CAAC,QAAgB;QACnC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACK,WAAW,CAAC,QAAgB;QAClC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAC;IACzE,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,YAAY,CAAC,KAAwB;QAChD,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,UAAU,EAAE,CAAC;QACpC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAE1B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACzD,MAAM,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhD,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,UAAU,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,UAA+B,CAAC;YAC9C,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,UAAU,CAAC;QACnB,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,YAAY,GAAmB;YACnC,YAAY,EAAE,CAAC;YACf,gBAAgB,EAAE,CAAC;YACnB,WAAW,EAAE,CAAC;YACd,eAAe,EAAE,CAAC;SACnB,CAAC;QAEF,MAAM,QAAQ,GAAmB;YAC/B,OAAO,EAAE,CAAC;YACV,EAAE;YACF,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;YACtB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,MAAM;YACd,wBAAwB,EAAE,CAAC;YAC3B,KAAK,EAAE,YAAY;SACpB,CAAC;QAEF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACzD,MAAM,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEvE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,iBAAiB,CAC7B,QAAgB;QAEhB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC;QAC3E,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,SAAS,CACpB,QAAgB;QAEhB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,MAAM,YAAY,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC7C,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,WAAW,CAAC,OAGxB;QACC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,MAAM,IAAI,GAAqB,EAAE,CAAC;QAElC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChD,IAAI,MAAM,EAAE,CAAC;oBACX,IACE,CAAC,OAAO,EAAE,gBAAgB;wBAC1B,MAAM,CAAC,gBAAgB,KAAK,OAAO,CAAC,gBAAgB,EACpD,CAAC;wBACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACpB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CACP,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CACpE,CAAC;QAEF,OAAO,OAAO,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC;YACxC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC;YAC9B,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,YAAY,CACvB,QAAgB,EAChB,KAAwB;QAExB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAE5C,OAAO,MAAM,YAAY,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACvD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,GAAG,CAAC,CAAC;YACrD,CAAC;YAED,MAAM,OAAO,GAAmB;gBAC9B,GAAG,OAAO;gBACV,KAAK,EAAE,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK;gBAC9D,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI;gBAC1D,KAAK,EAAE,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK;gBAC9D,QAAQ,EACN,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ;gBAClE,SAAS,EACP,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS;gBACrE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;YAEF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC5B,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAC3B,aAAa,CACd,CAAC;YACF,MAAM,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACtE,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,YAAY,CAAC,QAAgB;QACxC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAE5C,OAAO,MAAM,YAAY,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,gBAAgB,CAC3B,QAAgB,EAChB,KAAyB;QAEzB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAE5C,OAAO,MAAM,YAAY,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACvD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,GAAG,CAAC,CAAC;YACrD,CAAC;YAED,MAAM,QAAQ,GAAG,OAAO,CAAC,wBAAwB,GAAG,CAAC,CAAC;YACtD,MAAM,SAAS,GAAG,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAqB,CAAC;YAE5D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;YAChE,MAAM,WAAW,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;YAE7C,IAAI,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;YAClC,IAAI,MAAM,GAAiB,OAAO,CAAC,MAAM,CAAC;YAC1C,IAAI,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;YAC1D,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAE1B,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACjC,SAAS,IAAI,CAAC,CAAC;gBACf,MAAM,GAAG,SAAS,CAAC;gBACnB,qBAAqB,GAAG,KAAK,CAAC,UAAU,CAAC;YAC3C,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBACzC,MAAM,GAAG,KAAK,CAAC,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC3D,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;oBAChB,KAAK,GAAG;wBACN,YAAY,EACV,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;4BACjC,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;wBACjC,gBAAgB,EACd,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC;4BACrC,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC;wBACrC,WAAW,EACT,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;wBACnE,eAAe,EACb,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC;4BACpC,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC;qBACrC,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,eAAe,GAAmB;gBACtC,GAAG,OAAO;gBACV,SAAS;gBACT,MAAM;gBACN,wBAAwB,EAAE,QAAQ;gBAClC,qBAAqB;gBACrB,KAAK;gBACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;YAEF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YACzD,MAAM,eAAe,CACnB,YAAY,EACZ,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,CACzC,CAAC;YAEF,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,qBAAqB,CACjC,QAAgB;QAEhB,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAC9B,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAC3B,kBAAkB,CACnB,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,SAAS,CAA0B,cAAc,CAAC,CAAC;QAC5E,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,8BAA8B,CAAC,UAAU,CAAC,CAAC;QAE5E,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,UAAU,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,aAAa,CACxB,QAAgB;QAEhB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,MAAM,YAAY,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC7C,OAAO,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,WAAW,CAAC,QAAgB;QACvC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,MAAM,YAAY,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YAC9D,OAAO,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * @fileoverview Threads subsystem exports.
3
+ * @packageDocumentation
4
+ */
5
+ export * from "./types.js";
6
+ export * from "./FileThreadStore.js";
7
+ export * from "./transcriptMigration.js";
8
+ export * from "./transcriptProjection.js";
9
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sources":["../../src/threads/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * @fileoverview Threads subsystem exports.
3
+ * @packageDocumentation
4
+ */
5
+ export * from "./types.js";
6
+ export * from "./FileThreadStore.js";
7
+ export * from "./transcriptMigration.js";
8
+ export * from "./transcriptProjection.js";
9
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sources":["../../src/threads/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC"}
@@ -0,0 +1,52 @@
1
+ /**
2
+ * @fileoverview Extensible versioned migration pipeline for thread transcript entries.
3
+ * @packageDocumentation
4
+ */
5
+ import type { TranscriptEntry } from "./types.js";
6
+ /** Current canonical schema version for transcript entries. */
7
+ export declare const CURRENT_TRANSCRIPT_VERSION = 2;
8
+ /**
9
+ * Contract for a discrete step migration function in the transcript migration pipeline.
10
+ */
11
+ export interface TranscriptMigration {
12
+ /** Source schema version this migration upgrades from. */
13
+ readonly fromVersion: number;
14
+ /** Destination schema version this migration produces. */
15
+ readonly toVersion: number;
16
+ /**
17
+ * Transforms an array of transcript records to the next schema version.
18
+ *
19
+ * @param entries - Raw records conforming to fromVersion.
20
+ * @returns Upgraded records conforming to toVersion.
21
+ */
22
+ migrate(entries: readonly Record<string, unknown>[]): readonly Record<string, unknown>[];
23
+ }
24
+ /**
25
+ * Migration 1 -> 2:
26
+ * - Assigns version: 2 to all entries.
27
+ * - Enforces turn attribution: links modelMessage, toolCall, toolResult, and checkpointRef
28
+ * entries to the owning turnIndex between turnStarted and turnFinished boundaries.
29
+ * - External conversational messages outside turns retain turnIndex: undefined.
30
+ */
31
+ export declare const migrateV1ToV2: TranscriptMigration;
32
+ /**
33
+ * Result returned by the transcript migration pipeline.
34
+ */
35
+ export interface MigrationPipelineResult {
36
+ /** Final migrated entries at CURRENT_TRANSCRIPT_VERSION. */
37
+ readonly entries: readonly TranscriptEntry[];
38
+ /** Whether any migration was executed. */
39
+ readonly wasMigrated: boolean;
40
+ }
41
+ /**
42
+ * Runs the registered versioned migration pipeline over raw transcript entries.
43
+ *
44
+ * If all entries already conform to CURRENT_TRANSCRIPT_VERSION, returns immediately
45
+ * without mutation. Otherwise, applies each necessary migration sequentially
46
+ * to lazily upgrade older records to the current canonical version.
47
+ *
48
+ * @param rawEntries - Raw parsed JSONL objects from the transcript file.
49
+ * @returns Migrated entries and a boolean flag indicating if upgrades were applied.
50
+ */
51
+ export declare function runTranscriptMigrationPipeline(rawEntries: readonly Record<string, unknown>[]): MigrationPipelineResult;
52
+ //# sourceMappingURL=transcriptMigration.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transcriptMigration.d.ts","sources":["../../src/threads/transcriptMigration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,OAAO,CACL,OAAO,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC1C,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACvC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,mBA6C3B,CAAC;AAKF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC7C,uBAAuB,CAwCzB"}
@@ -0,0 +1,100 @@
1
+ /**
2
+ * @fileoverview Extensible versioned migration pipeline for thread transcript entries.
3
+ * @packageDocumentation
4
+ */
5
+ /** Current canonical schema version for transcript entries. */
6
+ export const CURRENT_TRANSCRIPT_VERSION = 2;
7
+ /**
8
+ * Migration 1 -> 2:
9
+ * - Assigns version: 2 to all entries.
10
+ * - Enforces turn attribution: links modelMessage, toolCall, toolResult, and checkpointRef
11
+ * entries to the owning turnIndex between turnStarted and turnFinished boundaries.
12
+ * - External conversational messages outside turns retain turnIndex: undefined.
13
+ */
14
+ export const migrateV1ToV2 = {
15
+ fromVersion: 1,
16
+ toVersion: CURRENT_TRANSCRIPT_VERSION,
17
+ migrate(entries) {
18
+ let currentTurnIndex;
19
+ return entries.map((rawEntry) => {
20
+ const entry = {
21
+ ...rawEntry,
22
+ version: CURRENT_TRANSCRIPT_VERSION,
23
+ };
24
+ if (entry["type"] === "turnStarted") {
25
+ currentTurnIndex =
26
+ typeof entry["turnIndex"] === "number"
27
+ ? entry["turnIndex"]
28
+ : undefined;
29
+ return entry;
30
+ }
31
+ if (entry["type"] === "turnFinished") {
32
+ const turnFinishedIndex = typeof entry["turnIndex"] === "number"
33
+ ? entry["turnIndex"]
34
+ : currentTurnIndex;
35
+ currentTurnIndex = undefined;
36
+ return {
37
+ ...entry,
38
+ turnIndex: turnFinishedIndex,
39
+ };
40
+ }
41
+ // Associate in-turn events with active turn
42
+ if (currentTurnIndex !== undefined) {
43
+ return {
44
+ ...entry,
45
+ turnIndex: currentTurnIndex,
46
+ };
47
+ }
48
+ return entry;
49
+ });
50
+ },
51
+ };
52
+ /** Registered ordered migrations. */
53
+ const registeredMigrations = [migrateV1ToV2];
54
+ /**
55
+ * Runs the registered versioned migration pipeline over raw transcript entries.
56
+ *
57
+ * If all entries already conform to CURRENT_TRANSCRIPT_VERSION, returns immediately
58
+ * without mutation. Otherwise, applies each necessary migration sequentially
59
+ * to lazily upgrade older records to the current canonical version.
60
+ *
61
+ * @param rawEntries - Raw parsed JSONL objects from the transcript file.
62
+ * @returns Migrated entries and a boolean flag indicating if upgrades were applied.
63
+ */
64
+ export function runTranscriptMigrationPipeline(rawEntries) {
65
+ if (rawEntries.length === 0) {
66
+ return {
67
+ entries: [],
68
+ wasMigrated: false,
69
+ };
70
+ }
71
+ // Detect minimum version across entries (unversioned entries default to 1)
72
+ let lowestVersion = CURRENT_TRANSCRIPT_VERSION;
73
+ for (const entry of rawEntries) {
74
+ const v = typeof entry.version === "number" ? entry.version : 1;
75
+ if (v < lowestVersion) {
76
+ lowestVersion = v;
77
+ }
78
+ }
79
+ if (lowestVersion >= CURRENT_TRANSCRIPT_VERSION) {
80
+ return {
81
+ entries: rawEntries,
82
+ wasMigrated: false,
83
+ };
84
+ }
85
+ let currentEntries = rawEntries;
86
+ let currentVersion = lowestVersion;
87
+ let wasMigrated = false;
88
+ for (const migration of registeredMigrations) {
89
+ if (migration.fromVersion >= currentVersion) {
90
+ currentEntries = migration.migrate(currentEntries);
91
+ currentVersion = migration.toVersion;
92
+ wasMigrated = true;
93
+ }
94
+ }
95
+ return {
96
+ entries: currentEntries,
97
+ wasMigrated,
98
+ };
99
+ }
100
+ //# sourceMappingURL=transcriptMigration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transcriptMigration.js","sources":["../../src/threads/transcriptMigration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAqB5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB;IAChD,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,0BAA0B;IACrC,OAAO,CACL,OAA2C;QAE3C,IAAI,gBAAoC,CAAC;QAEzC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC9B,MAAM,KAAK,GAA4B;gBACrC,GAAG,QAAQ;gBACX,OAAO,EAAE,0BAA0B;aACpC,CAAC;YAEF,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,aAAa,EAAE,CAAC;gBACpC,gBAAgB;oBACd,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,QAAQ;wBACpC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;wBACpB,CAAC,CAAC,SAAS,CAAC;gBAChB,OAAO,KAAK,CAAC;YACf,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,cAAc,EAAE,CAAC;gBACrC,MAAM,iBAAiB,GACrB,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,QAAQ;oBACpC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;oBACpB,CAAC,CAAC,gBAAgB,CAAC;gBACvB,gBAAgB,GAAG,SAAS,CAAC;gBAC7B,OAAO;oBACL,GAAG,KAAK;oBACR,SAAS,EAAE,iBAAiB;iBAC7B,CAAC;YACJ,CAAC;YAED,4CAA4C;YAC5C,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACnC,OAAO;oBACL,GAAG,KAAK;oBACR,SAAS,EAAE,gBAAgB;iBAC5B,CAAC;YACJ,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,qCAAqC;AACrC,MAAM,oBAAoB,GAAmC,CAAC,aAAa,CAAC,CAAC;AAY7E;;;;;;;;;GASG;AACH,MAAM,UAAU,8BAA8B,CAC5C,UAA8C;IAE9C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,IAAI,aAAa,GAAG,0BAA0B,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC;YACtB,aAAa,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,IAAI,aAAa,IAAI,0BAA0B,EAAE,CAAC;QAChD,OAAO;YACL,OAAO,EAAE,UAAmD;YAC5D,WAAW,EAAE,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,GAAuC,UAAU,CAAC;IACpE,IAAI,cAAc,GAAG,aAAa,CAAC;IACnC,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,MAAM,SAAS,IAAI,oBAAoB,EAAE,CAAC;QAC7C,IAAI,SAAS,CAAC,WAAW,IAAI,cAAc,EAAE,CAAC;YAC5C,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACnD,cAAc,GAAG,SAAS,CAAC,SAAS,CAAC;YACrC,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,cAAuD;QAChE,WAAW;KACZ,CAAC;AACJ,CAAC"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * @fileoverview Conversational model message projection from append-only transcript logs.
3
+ * @packageDocumentation
4
+ */
5
+ import type { ModelMessage } from "../model/types.js";
6
+ import type { TranscriptEntry } from "./types.js";
7
+ /**
8
+ * Projects conversational model messages from an authoritative transcript log.
9
+ *
10
+ * Implements deterministic replay invariants:
11
+ * - Excludes entries belonging to failed, vetoed, or uncommitted turns so the resumed
12
+ * engine history matches the live post-failure engine state.
13
+ * - Preserves user, assistant, and externally added messages in correct chronological order.
14
+ * - Reconstructs standard AI SDK v7 `role: "tool"` messages containing `tool-result` blocks
15
+ * from persisted `toolResult` entries in exact correspondence to assistant `tool-call`s.
16
+ *
17
+ * @param transcript - Ordered array of sequenced transcript entries.
18
+ * @returns Reconstructed array of ModelMessage items for seeding or resuming the model.
19
+ */
20
+ export declare function projectModelMessages(transcript: readonly TranscriptEntry[]): readonly ModelMessage[];
21
+ //# sourceMappingURL=transcriptProjection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transcriptProjection.d.ts","sources":["../../src/threads/transcriptProjection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAuBlD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,SAAS,eAAe,EAAE,GACrC,SAAS,YAAY,EAAE,CAkHzB"}