@amaranthic/hernex 0.0.0-stage → 0.2.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 (259) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +66 -2
  3. package/dist/ai.d.ts +11 -0
  4. package/dist/ai.d.ts.map +1 -0
  5. package/dist/ai.js +11 -0
  6. package/dist/ai.js.map +1 -0
  7. package/dist/checkpoints/FileCheckpointStore.d.ts +95 -0
  8. package/dist/checkpoints/FileCheckpointStore.d.ts.map +1 -0
  9. package/dist/checkpoints/FileCheckpointStore.js +412 -0
  10. package/dist/checkpoints/FileCheckpointStore.js.map +1 -0
  11. package/dist/checkpoints/index.d.ts +7 -0
  12. package/dist/checkpoints/index.d.ts.map +1 -0
  13. package/dist/checkpoints/index.js +7 -0
  14. package/dist/checkpoints/index.js.map +1 -0
  15. package/dist/checkpoints/types.d.ts +157 -0
  16. package/dist/checkpoints/types.d.ts.map +1 -0
  17. package/dist/checkpoints/types.js +6 -0
  18. package/dist/checkpoints/types.js.map +1 -0
  19. package/dist/engine/AgentEngine.d.ts +156 -0
  20. package/dist/engine/AgentEngine.d.ts.map +1 -0
  21. package/dist/engine/AgentEngine.js +288 -0
  22. package/dist/engine/AgentEngine.js.map +1 -0
  23. package/dist/engine/engineConfig.d.ts +138 -0
  24. package/dist/engine/engineConfig.d.ts.map +1 -0
  25. package/dist/engine/engineConfig.js +6 -0
  26. package/dist/engine/engineConfig.js.map +1 -0
  27. package/dist/engine/eventQueue.d.ts +42 -0
  28. package/dist/engine/eventQueue.d.ts.map +1 -0
  29. package/dist/engine/eventQueue.js +93 -0
  30. package/dist/engine/eventQueue.js.map +1 -0
  31. package/dist/engine/index.d.ts +7 -0
  32. package/dist/engine/index.d.ts.map +1 -0
  33. package/dist/engine/index.js +6 -0
  34. package/dist/engine/index.js.map +1 -0
  35. package/dist/engine/runTurn.d.ts +17 -0
  36. package/dist/engine/runTurn.d.ts.map +1 -0
  37. package/dist/engine/runTurn.js +684 -0
  38. package/dist/engine/runTurn.js.map +1 -0
  39. package/dist/errors.d.ts +142 -0
  40. package/dist/errors.d.ts.map +1 -0
  41. package/dist/errors.js +174 -0
  42. package/dist/errors.js.map +1 -0
  43. package/dist/events/checkpointEvents.d.ts +20 -0
  44. package/dist/events/checkpointEvents.d.ts.map +1 -0
  45. package/dist/events/checkpointEvents.js +6 -0
  46. package/dist/events/checkpointEvents.js.map +1 -0
  47. package/dist/events/errorEvents.d.ts +23 -0
  48. package/dist/events/errorEvents.d.ts.map +1 -0
  49. package/dist/events/errorEvents.js +6 -0
  50. package/dist/events/errorEvents.js.map +1 -0
  51. package/dist/events/index.d.ts +11 -0
  52. package/dist/events/index.d.ts.map +1 -0
  53. package/dist/events/index.js +6 -0
  54. package/dist/events/index.js.map +1 -0
  55. package/dist/events/stepEvents.d.ts +68 -0
  56. package/dist/events/stepEvents.d.ts.map +1 -0
  57. package/dist/events/stepEvents.js +6 -0
  58. package/dist/events/stepEvents.js.map +1 -0
  59. package/dist/events/streamEvents.d.ts +41 -0
  60. package/dist/events/streamEvents.d.ts.map +1 -0
  61. package/dist/events/streamEvents.js +6 -0
  62. package/dist/events/streamEvents.js.map +1 -0
  63. package/dist/events/toolEvents.d.ts +62 -0
  64. package/dist/events/toolEvents.d.ts.map +1 -0
  65. package/dist/events/toolEvents.js +6 -0
  66. package/dist/events/toolEvents.js.map +1 -0
  67. package/dist/events/types.d.ts +37 -0
  68. package/dist/events/types.d.ts.map +1 -0
  69. package/dist/events/types.js +6 -0
  70. package/dist/events/types.js.map +1 -0
  71. package/dist/hooks/composeAgentHooks.d.ts +14 -0
  72. package/dist/hooks/composeAgentHooks.d.ts.map +1 -0
  73. package/dist/hooks/composeAgentHooks.js +142 -0
  74. package/dist/hooks/composeAgentHooks.js.map +1 -0
  75. package/dist/hooks/index.d.ts +7 -0
  76. package/dist/hooks/index.d.ts.map +1 -0
  77. package/dist/hooks/index.js +6 -0
  78. package/dist/hooks/index.js.map +1 -0
  79. package/dist/hooks/types.d.ts +133 -0
  80. package/dist/hooks/types.d.ts.map +1 -0
  81. package/dist/hooks/types.js +6 -0
  82. package/dist/hooks/types.js.map +1 -0
  83. package/dist/index.d.ts +26 -0
  84. package/dist/index.d.ts.map +1 -0
  85. package/dist/index.js +25 -0
  86. package/dist/index.js.map +1 -0
  87. package/dist/model/ProviderRegistry.d.ts +62 -0
  88. package/dist/model/ProviderRegistry.d.ts.map +1 -0
  89. package/dist/model/ProviderRegistry.js +114 -0
  90. package/dist/model/ProviderRegistry.js.map +1 -0
  91. package/dist/model/providers/alibaba.d.ts +11 -0
  92. package/dist/model/providers/alibaba.d.ts.map +1 -0
  93. package/dist/model/providers/alibaba.js +16 -0
  94. package/dist/model/providers/alibaba.js.map +1 -0
  95. package/dist/model/providers/anthropic.d.ts +11 -0
  96. package/dist/model/providers/anthropic.d.ts.map +1 -0
  97. package/dist/model/providers/anthropic.js +16 -0
  98. package/dist/model/providers/anthropic.js.map +1 -0
  99. package/dist/model/providers/cohere.d.ts +11 -0
  100. package/dist/model/providers/cohere.d.ts.map +1 -0
  101. package/dist/model/providers/cohere.js +16 -0
  102. package/dist/model/providers/cohere.js.map +1 -0
  103. package/dist/model/providers/compatible.d.ts +11 -0
  104. package/dist/model/providers/compatible.d.ts.map +1 -0
  105. package/dist/model/providers/compatible.js +17 -0
  106. package/dist/model/providers/compatible.js.map +1 -0
  107. package/dist/model/providers/deepseek.d.ts +11 -0
  108. package/dist/model/providers/deepseek.d.ts.map +1 -0
  109. package/dist/model/providers/deepseek.js +16 -0
  110. package/dist/model/providers/deepseek.js.map +1 -0
  111. package/dist/model/providers/google.d.ts +11 -0
  112. package/dist/model/providers/google.d.ts.map +1 -0
  113. package/dist/model/providers/google.js +16 -0
  114. package/dist/model/providers/google.js.map +1 -0
  115. package/dist/model/providers/groq.d.ts +11 -0
  116. package/dist/model/providers/groq.d.ts.map +1 -0
  117. package/dist/model/providers/groq.js +16 -0
  118. package/dist/model/providers/groq.js.map +1 -0
  119. package/dist/model/providers/mistral.d.ts +11 -0
  120. package/dist/model/providers/mistral.d.ts.map +1 -0
  121. package/dist/model/providers/mistral.js +16 -0
  122. package/dist/model/providers/mistral.js.map +1 -0
  123. package/dist/model/providers/openai.d.ts +11 -0
  124. package/dist/model/providers/openai.d.ts.map +1 -0
  125. package/dist/model/providers/openai.js +16 -0
  126. package/dist/model/providers/openai.js.map +1 -0
  127. package/dist/model/providers/openrouter.d.ts +14 -0
  128. package/dist/model/providers/openrouter.d.ts.map +1 -0
  129. package/dist/model/providers/openrouter.js +20 -0
  130. package/dist/model/providers/openrouter.js.map +1 -0
  131. package/dist/model/providers/togetherai.d.ts +11 -0
  132. package/dist/model/providers/togetherai.d.ts.map +1 -0
  133. package/dist/model/providers/togetherai.js +16 -0
  134. package/dist/model/providers/togetherai.js.map +1 -0
  135. package/dist/model/providers/vercelGateway.d.ts +14 -0
  136. package/dist/model/providers/vercelGateway.d.ts.map +1 -0
  137. package/dist/model/providers/vercelGateway.js +19 -0
  138. package/dist/model/providers/vercelGateway.js.map +1 -0
  139. package/dist/model/providers/xai.d.ts +11 -0
  140. package/dist/model/providers/xai.d.ts.map +1 -0
  141. package/dist/model/providers/xai.js +16 -0
  142. package/dist/model/providers/xai.js.map +1 -0
  143. package/dist/model/resolveModel.d.ts +45 -0
  144. package/dist/model/resolveModel.d.ts.map +1 -0
  145. package/dist/model/resolveModel.js +109 -0
  146. package/dist/model/resolveModel.js.map +1 -0
  147. package/dist/model/types.d.ts +98 -0
  148. package/dist/model/types.d.ts.map +1 -0
  149. package/dist/model/types.js +6 -0
  150. package/dist/model/types.js.map +1 -0
  151. package/dist/runtime.d.ts +74 -0
  152. package/dist/runtime.d.ts.map +1 -0
  153. package/dist/runtime.js +41 -0
  154. package/dist/runtime.js.map +1 -0
  155. package/dist/storage/atomicFile.d.ts +28 -0
  156. package/dist/storage/atomicFile.d.ts.map +1 -0
  157. package/dist/storage/atomicFile.js +56 -0
  158. package/dist/storage/atomicFile.js.map +1 -0
  159. package/dist/storage/homeDirectory.d.ts +21 -0
  160. package/dist/storage/homeDirectory.d.ts.map +1 -0
  161. package/dist/storage/homeDirectory.js +36 -0
  162. package/dist/storage/homeDirectory.js.map +1 -0
  163. package/dist/storage/index.d.ts +10 -0
  164. package/dist/storage/index.d.ts.map +1 -0
  165. package/dist/storage/index.js +10 -0
  166. package/dist/storage/index.js.map +1 -0
  167. package/dist/storage/jsonl.d.ts +46 -0
  168. package/dist/storage/jsonl.d.ts.map +1 -0
  169. package/dist/storage/jsonl.js +121 -0
  170. package/dist/storage/jsonl.js.map +1 -0
  171. package/dist/storage/lock.d.ts +47 -0
  172. package/dist/storage/lock.d.ts.map +1 -0
  173. package/dist/storage/lock.js +126 -0
  174. package/dist/storage/lock.js.map +1 -0
  175. package/dist/storage/valueCodec.d.ts +68 -0
  176. package/dist/storage/valueCodec.d.ts.map +1 -0
  177. package/dist/storage/valueCodec.js +140 -0
  178. package/dist/storage/valueCodec.js.map +1 -0
  179. package/dist/tasks/TaskManager.d.ts +155 -0
  180. package/dist/tasks/TaskManager.d.ts.map +1 -0
  181. package/dist/tasks/TaskManager.js +774 -0
  182. package/dist/tasks/TaskManager.js.map +1 -0
  183. package/dist/tasks/index.d.ts +7 -0
  184. package/dist/tasks/index.d.ts.map +1 -0
  185. package/dist/tasks/index.js +6 -0
  186. package/dist/tasks/index.js.map +1 -0
  187. package/dist/tasks/types.d.ts +160 -0
  188. package/dist/tasks/types.d.ts.map +1 -0
  189. package/dist/tasks/types.js +8 -0
  190. package/dist/tasks/types.js.map +1 -0
  191. package/dist/threads/FileThreadStore.d.ts +118 -0
  192. package/dist/threads/FileThreadStore.d.ts.map +1 -0
  193. package/dist/threads/FileThreadStore.js +320 -0
  194. package/dist/threads/FileThreadStore.js.map +1 -0
  195. package/dist/threads/index.d.ts +7 -0
  196. package/dist/threads/index.d.ts.map +1 -0
  197. package/dist/threads/index.js +7 -0
  198. package/dist/threads/index.js.map +1 -0
  199. package/dist/threads/types.d.ts +230 -0
  200. package/dist/threads/types.d.ts.map +1 -0
  201. package/dist/threads/types.js +6 -0
  202. package/dist/threads/types.js.map +1 -0
  203. package/dist/tools/AgentTool.d.ts +38 -0
  204. package/dist/tools/AgentTool.d.ts.map +1 -0
  205. package/dist/tools/AgentTool.js +6 -0
  206. package/dist/tools/AgentTool.js.map +1 -0
  207. package/dist/tools/BashTool.d.ts +61 -0
  208. package/dist/tools/BashTool.d.ts.map +1 -0
  209. package/dist/tools/BashTool.js +142 -0
  210. package/dist/tools/BashTool.js.map +1 -0
  211. package/dist/tools/EditFileTool.d.ts +49 -0
  212. package/dist/tools/EditFileTool.d.ts.map +1 -0
  213. package/dist/tools/EditFileTool.js +114 -0
  214. package/dist/tools/EditFileTool.js.map +1 -0
  215. package/dist/tools/GlobTool.d.ts +48 -0
  216. package/dist/tools/GlobTool.d.ts.map +1 -0
  217. package/dist/tools/GlobTool.js +117 -0
  218. package/dist/tools/GlobTool.js.map +1 -0
  219. package/dist/tools/GrepTool.d.ts +73 -0
  220. package/dist/tools/GrepTool.d.ts.map +1 -0
  221. package/dist/tools/GrepTool.js +250 -0
  222. package/dist/tools/GrepTool.js.map +1 -0
  223. package/dist/tools/ReadFileTool.d.ts +51 -0
  224. package/dist/tools/ReadFileTool.d.ts.map +1 -0
  225. package/dist/tools/ReadFileTool.js +153 -0
  226. package/dist/tools/ReadFileTool.js.map +1 -0
  227. package/dist/tools/TaskManagerTool.d.ts +102 -0
  228. package/dist/tools/TaskManagerTool.d.ts.map +1 -0
  229. package/dist/tools/TaskManagerTool.js +130 -0
  230. package/dist/tools/TaskManagerTool.js.map +1 -0
  231. package/dist/tools/ToolExecutionContext.d.ts +61 -0
  232. package/dist/tools/ToolExecutionContext.d.ts.map +1 -0
  233. package/dist/tools/ToolExecutionContext.js +8 -0
  234. package/dist/tools/ToolExecutionContext.js.map +1 -0
  235. package/dist/tools/ToolRegistry.d.ts +82 -0
  236. package/dist/tools/ToolRegistry.d.ts.map +1 -0
  237. package/dist/tools/ToolRegistry.js +116 -0
  238. package/dist/tools/ToolRegistry.js.map +1 -0
  239. package/dist/tools/WriteFileTool.d.ts +46 -0
  240. package/dist/tools/WriteFileTool.d.ts.map +1 -0
  241. package/dist/tools/WriteFileTool.js +87 -0
  242. package/dist/tools/WriteFileTool.js.map +1 -0
  243. package/dist/tools/index.d.ts +17 -0
  244. package/dist/tools/index.d.ts.map +1 -0
  245. package/dist/tools/index.js +17 -0
  246. package/dist/tools/index.js.map +1 -0
  247. package/dist/tools/internal/bashEnvironment.d.ts +20 -0
  248. package/dist/tools/internal/bashEnvironment.d.ts.map +1 -0
  249. package/dist/tools/internal/bashEnvironment.js +65 -0
  250. package/dist/tools/internal/bashEnvironment.js.map +1 -0
  251. package/dist/tools/internal/pathGuard.d.ts +27 -0
  252. package/dist/tools/internal/pathGuard.d.ts.map +1 -0
  253. package/dist/tools/internal/pathGuard.js +99 -0
  254. package/dist/tools/internal/pathGuard.js.map +1 -0
  255. package/dist/tools/prompts.d.ts +33 -0
  256. package/dist/tools/prompts.d.ts.map +1 -0
  257. package/dist/tools/prompts.js +48 -0
  258. package/dist/tools/prompts.js.map +1 -0
  259. package/package.json +64 -4
@@ -0,0 +1,320 @@
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 } from "../storage/jsonl.js";
12
+ import { withFileLock } from "../storage/lock.js";
13
+ /** Regular expression for validating safe thread identifiers. */
14
+ const THREAD_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
15
+ /**
16
+ * File-backed ThreadStore implementation managing thread session directories,
17
+ * metadata snapshots, and append-only transcripts.
18
+ */
19
+ export class FileThreadStore {
20
+ rootDir;
21
+ /**
22
+ * Initializes a new FileThreadStore instance.
23
+ *
24
+ * @param options - Optional configuration options including custom home directory.
25
+ */
26
+ constructor(options) {
27
+ this.rootDir = resolveHomeDirectory(options);
28
+ }
29
+ /**
30
+ * Validates that a thread identifier conforms to safe naming grammar.
31
+ *
32
+ * @param threadId - Candidate identifier to validate.
33
+ * @throws Error if threadId is empty, invalid, or contains path traversal characters.
34
+ */
35
+ validateThreadId(threadId) {
36
+ if (!threadId || typeof threadId !== "string" || !THREAD_ID_PATTERN.test(threadId)) {
37
+ throw new Error(`Invalid thread identifier: "${threadId}"`);
38
+ }
39
+ }
40
+ /**
41
+ * Resolves the canonical directory for a given thread identifier.
42
+ *
43
+ * @param threadId - Safe thread identifier.
44
+ * @returns Absolute path to the thread directory.
45
+ */
46
+ getThreadDir(threadId) {
47
+ this.validateThreadId(threadId);
48
+ return path.join(this.rootDir, "threads", threadId);
49
+ }
50
+ /**
51
+ * Resolves the out-of-directory lock file path for a thread.
52
+ *
53
+ * @param threadId - Safe thread identifier.
54
+ * @returns Absolute path to the thread lock file located in `<rootDir>/locks/threads/<threadId>.lock`.
55
+ */
56
+ getLockPath(threadId) {
57
+ this.validateThreadId(threadId);
58
+ return path.join(this.rootDir, "locks", "threads", `${threadId}.lock`);
59
+ }
60
+ /**
61
+ * Creates a new thread directory and initializes its `thread.json` metadata.
62
+ *
63
+ * @param input - Thread creation parameters.
64
+ * @returns Newly created thread metadata.
65
+ */
66
+ async createThread(input) {
67
+ const id = input.id ?? randomUUID();
68
+ this.validateThreadId(id);
69
+ const threadsParent = path.join(this.rootDir, "threads");
70
+ await mkdir(threadsParent, { recursive: true });
71
+ const threadDir = this.getThreadDir(id);
72
+ if (existsSync(threadDir)) {
73
+ throw new Error(`Thread already exists: "${id}"`);
74
+ }
75
+ try {
76
+ await mkdir(threadDir, { recursive: false });
77
+ }
78
+ catch (mkdirError) {
79
+ const error = mkdirError;
80
+ if (error?.code === "EEXIST") {
81
+ throw new Error(`Thread already exists: "${id}"`);
82
+ }
83
+ throw mkdirError;
84
+ }
85
+ const now = new Date().toISOString();
86
+ const initialUsage = {
87
+ promptTokens: 0,
88
+ completionTokens: 0,
89
+ totalTokens: 0,
90
+ reasoningTokens: 0,
91
+ };
92
+ const metadata = {
93
+ version: 1,
94
+ id,
95
+ createdAt: now,
96
+ updatedAt: now,
97
+ title: input.title,
98
+ tags: input.tags ?? [],
99
+ workingDirectory: input.workingDirectory,
100
+ model: input.model,
101
+ provider: input.provider,
102
+ reasoning: input.reasoning,
103
+ turnCount: 0,
104
+ status: "idle",
105
+ activeTranscriptSequence: 0,
106
+ usage: initialUsage,
107
+ };
108
+ const metadataPath = path.join(threadDir, "thread.json");
109
+ await atomicWriteFile(metadataPath, JSON.stringify(metadata, null, 2));
110
+ return metadata;
111
+ }
112
+ /**
113
+ * Internal unlocked helper to read thread metadata without acquiring a file lock.
114
+ *
115
+ * @param threadId - Safe thread identifier.
116
+ * @returns Thread metadata snapshot or undefined if not found.
117
+ */
118
+ async getThreadUnlocked(threadId) {
119
+ const metadataPath = path.join(this.getThreadDir(threadId), "thread.json");
120
+ if (!existsSync(metadataPath)) {
121
+ return undefined;
122
+ }
123
+ const raw = await readFile(metadataPath, "utf-8");
124
+ return JSON.parse(raw);
125
+ }
126
+ /**
127
+ * Retrieves metadata for an existing thread session under file lock.
128
+ *
129
+ * @param threadId - Safe thread identifier.
130
+ * @returns Thread metadata snapshot or undefined if not found.
131
+ */
132
+ async getThread(threadId) {
133
+ this.validateThreadId(threadId);
134
+ const lockPath = this.getLockPath(threadId);
135
+ return await withFileLock(lockPath, async () => {
136
+ return this.getThreadUnlocked(threadId);
137
+ });
138
+ }
139
+ /**
140
+ * Lists available thread metadata snapshots matching optional filters.
141
+ *
142
+ * @param options - Filtering and pagination options.
143
+ * @returns Readonly array of thread metadata summaries.
144
+ */
145
+ async listThreads(options) {
146
+ const threadsRoot = path.join(this.rootDir, "threads");
147
+ if (!existsSync(threadsRoot)) {
148
+ return [];
149
+ }
150
+ const { readdir } = await import("node:fs/promises");
151
+ const entries = await readdir(threadsRoot, { withFileTypes: true });
152
+ const list = [];
153
+ for (const entry of entries) {
154
+ if (entry.isDirectory() && THREAD_ID_PATTERN.test(entry.name)) {
155
+ const thread = await this.getThread(entry.name);
156
+ if (thread) {
157
+ if (!options?.workingDirectory ||
158
+ thread.workingDirectory === options.workingDirectory) {
159
+ list.push(thread);
160
+ }
161
+ }
162
+ }
163
+ }
164
+ list.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
165
+ return options?.limit && options.limit > 0
166
+ ? list.slice(0, options.limit)
167
+ : list;
168
+ }
169
+ /**
170
+ * Updates an existing thread's metadata fields using an explicit UpdateThreadInput patch.
171
+ *
172
+ * @param threadId - Safe thread identifier.
173
+ * @param patch - Allowed metadata patch fields.
174
+ * @returns Updated thread metadata snapshot.
175
+ */
176
+ async updateThread(threadId, patch) {
177
+ this.validateThreadId(threadId);
178
+ const lockPath = this.getLockPath(threadId);
179
+ return await withFileLock(lockPath, async () => {
180
+ const current = await this.getThreadUnlocked(threadId);
181
+ if (!current) {
182
+ throw new Error(`Thread not found: "${threadId}"`);
183
+ }
184
+ const updated = {
185
+ ...current,
186
+ title: patch.title !== undefined ? patch.title : current.title,
187
+ tags: patch.tags !== undefined ? patch.tags : current.tags,
188
+ model: patch.model !== undefined ? patch.model : current.model,
189
+ provider: patch.provider !== undefined ? patch.provider : current.provider,
190
+ reasoning: patch.reasoning !== undefined ? patch.reasoning : current.reasoning,
191
+ updatedAt: new Date().toISOString(),
192
+ };
193
+ const metadataPath = path.join(this.getThreadDir(threadId), "thread.json");
194
+ await atomicWriteFile(metadataPath, JSON.stringify(updated, null, 2));
195
+ return updated;
196
+ });
197
+ }
198
+ /**
199
+ * Deletes a thread directory and its contents under external file lock.
200
+ *
201
+ * @param threadId - Safe thread identifier.
202
+ * @returns True if thread existed and was deleted, false otherwise.
203
+ */
204
+ async deleteThread(threadId) {
205
+ this.validateThreadId(threadId);
206
+ const lockPath = this.getLockPath(threadId);
207
+ return await withFileLock(lockPath, async () => {
208
+ const threadDir = this.getThreadDir(threadId);
209
+ if (!existsSync(threadDir)) {
210
+ return false;
211
+ }
212
+ await rm(threadDir, { recursive: true, force: true });
213
+ return true;
214
+ });
215
+ }
216
+ /**
217
+ * Appends an entry to the append-only thread transcript log under thread lock.
218
+ * Updates active sequence, turnCount, status, lastUserPromptPreview, and usage.
219
+ *
220
+ * @param threadId - Safe thread identifier.
221
+ * @param entry - New unsequenced transcript entry.
222
+ * @returns Sequenced and persisted transcript entry.
223
+ */
224
+ async appendTranscript(threadId, entry) {
225
+ this.validateThreadId(threadId);
226
+ const lockPath = this.getLockPath(threadId);
227
+ return await withFileLock(lockPath, async () => {
228
+ const current = await this.getThreadUnlocked(threadId);
229
+ if (!current) {
230
+ throw new Error(`Thread not found: "${threadId}"`);
231
+ }
232
+ const sequence = current.activeTranscriptSequence + 1;
233
+ const fullEntry = { ...entry, sequence };
234
+ const threadDir = this.getThreadDir(threadId);
235
+ const transcriptPath = path.join(threadDir, "transcript.jsonl");
236
+ await appendJsonl(transcriptPath, fullEntry);
237
+ let turnCount = current.turnCount;
238
+ let status = current.status;
239
+ let lastUserPromptPreview = current.lastUserPromptPreview;
240
+ let usage = current.usage;
241
+ if (entry.type === "turnStarted") {
242
+ turnCount += 1;
243
+ status = "running";
244
+ lastUserPromptPreview = entry.userPrompt;
245
+ }
246
+ else if (entry.type === "turnFinished") {
247
+ status = entry.finishReason === "error" ? "error" : "idle";
248
+ if (entry.usage) {
249
+ usage = {
250
+ promptTokens: (current.usage.promptTokens ?? 0) + (entry.usage.promptTokens ?? 0),
251
+ completionTokens: (current.usage.completionTokens ?? 0) +
252
+ (entry.usage.completionTokens ?? 0),
253
+ totalTokens: (current.usage.totalTokens ?? 0) + (entry.usage.totalTokens ?? 0),
254
+ reasoningTokens: (current.usage.reasoningTokens ?? 0) +
255
+ (entry.usage.reasoningTokens ?? 0),
256
+ };
257
+ }
258
+ }
259
+ const updatedMetadata = {
260
+ ...current,
261
+ turnCount,
262
+ status,
263
+ activeTranscriptSequence: sequence,
264
+ lastUserPromptPreview,
265
+ usage,
266
+ updatedAt: new Date().toISOString(),
267
+ };
268
+ const metadataPath = path.join(threadDir, "thread.json");
269
+ await atomicWriteFile(metadataPath, JSON.stringify(updatedMetadata, null, 2));
270
+ return fullEntry;
271
+ });
272
+ }
273
+ /**
274
+ * Internal unlocked helper to read the transcript entries from disk.
275
+ *
276
+ * @param threadId - Safe thread identifier.
277
+ * @returns Readonly array of sequenced transcript entries.
278
+ */
279
+ async getTranscriptUnlocked(threadId) {
280
+ const transcriptPath = path.join(this.getThreadDir(threadId), "transcript.jsonl");
281
+ if (!existsSync(transcriptPath)) {
282
+ return [];
283
+ }
284
+ return await readJsonl(transcriptPath);
285
+ }
286
+ /**
287
+ * Reads the full append-only transcript log for a thread session under thread lock.
288
+ *
289
+ * @param threadId - Safe thread identifier.
290
+ * @returns Readonly array of sequenced transcript entries.
291
+ */
292
+ async getTranscript(threadId) {
293
+ this.validateThreadId(threadId);
294
+ const lockPath = this.getLockPath(threadId);
295
+ return await withFileLock(lockPath, async () => {
296
+ return this.getTranscriptUnlocked(threadId);
297
+ });
298
+ }
299
+ /**
300
+ * Projects conversational model messages from the authoritative transcript under thread lock.
301
+ *
302
+ * @param threadId - Safe thread identifier.
303
+ * @returns Readonly array of ModelMessage items for model invocation.
304
+ */
305
+ async getMessages(threadId) {
306
+ this.validateThreadId(threadId);
307
+ const lockPath = this.getLockPath(threadId);
308
+ return await withFileLock(lockPath, async () => {
309
+ const transcript = await this.getTranscriptUnlocked(threadId);
310
+ const messages = [];
311
+ for (const entry of transcript) {
312
+ if (entry.type === "modelMessage") {
313
+ messages.push(entry.message);
314
+ }
315
+ }
316
+ return messages;
317
+ });
318
+ }
319
+ }
320
+ //# sourceMappingURL=FileThreadStore.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FileThreadStore.js","sources":["../../src/threads/FileThreadStore.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * @fileoverview Threads subsystem exports.
3
+ * @packageDocumentation
4
+ */
5
+ export * from "./types.js";
6
+ export * from "./FileThreadStore.js";
7
+ //# 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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * @fileoverview Threads subsystem exports.
3
+ * @packageDocumentation
4
+ */
5
+ export * from "./types.js";
6
+ export * from "./FileThreadStore.js";
7
+ //# 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"}
@@ -0,0 +1,230 @@
1
+ /**
2
+ * @fileoverview Thread session, transcript entries, and store contracts.
3
+ * @packageDocumentation
4
+ */
5
+ import type { StepTokenUsage } from "../events/stepEvents.js";
6
+ import type { ModelMessage } from "../model/types.js";
7
+ /**
8
+ * Thread session lifecycle status.
9
+ */
10
+ export type ThreadStatus = "idle" | "running" | "error";
11
+ /**
12
+ * Supported reasoning effort levels in the native Vercel AI SDK v7.
13
+ */
14
+ export type AgentReasoningLevel = "provider-default" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
15
+ /**
16
+ * Persisted summary metadata for a conversational thread.
17
+ */
18
+ export interface ThreadMetadata {
19
+ /** Schema version identifier. */
20
+ readonly version: 1;
21
+ /** Unique safe thread identifier. */
22
+ readonly id: string;
23
+ /** ISO 8601 creation timestamp string. */
24
+ readonly createdAt: string;
25
+ /** ISO 8601 last update timestamp string. */
26
+ readonly updatedAt: string;
27
+ /** Optional human-readable title. */
28
+ readonly title?: string | null | undefined;
29
+ /** Categorization tags for thread discovery. */
30
+ readonly tags: readonly string[];
31
+ /** Canonical workspace root directory for this thread. */
32
+ readonly workingDirectory: string;
33
+ /** Model identifier bound to this thread session. */
34
+ readonly model?: string | null | undefined;
35
+ /** Provider identifier bound to this thread session. */
36
+ readonly provider?: string | null | undefined;
37
+ /** Optional reasoning effort level. */
38
+ readonly reasoning?: string | null | undefined;
39
+ /** Cumulative count of executed agent turns. */
40
+ readonly turnCount: number;
41
+ /** Current lifecycle status of the thread session. */
42
+ readonly status: ThreadStatus;
43
+ /** Highest sequence number written to the append-only transcript. */
44
+ readonly activeTranscriptSequence: number;
45
+ /** Preview snippet of the most recent user prompt. */
46
+ readonly lastUserPromptPreview?: string | null | undefined;
47
+ /** Cumulative token consumption for the thread. */
48
+ readonly usage: StepTokenUsage;
49
+ }
50
+ /**
51
+ * Authoritative append-only log entries recorded in transcript.jsonl.
52
+ */
53
+ export type TranscriptEntry = {
54
+ readonly type: "turnStarted";
55
+ readonly sequence: number;
56
+ readonly turnIndex: number;
57
+ readonly userPrompt: string;
58
+ readonly timestamp: number;
59
+ } | {
60
+ readonly type: "modelMessage";
61
+ readonly sequence: number;
62
+ readonly message: ModelMessage;
63
+ readonly timestamp: number;
64
+ } | {
65
+ readonly type: "toolCall";
66
+ readonly sequence: number;
67
+ readonly callId: string;
68
+ readonly toolName: string;
69
+ readonly parameters: unknown;
70
+ readonly timestamp: number;
71
+ } | {
72
+ readonly type: "toolResult";
73
+ readonly sequence: number;
74
+ readonly callId: string;
75
+ readonly toolName: string;
76
+ readonly result: unknown;
77
+ readonly isError: boolean;
78
+ readonly timestamp: number;
79
+ } | {
80
+ readonly type: "checkpointRef";
81
+ readonly sequence: number;
82
+ readonly checkpointId: string;
83
+ readonly checkpointSequence: number;
84
+ readonly timestamp: number;
85
+ } | {
86
+ readonly type: "turnFinished";
87
+ readonly sequence: number;
88
+ readonly turnIndex: number;
89
+ readonly finishReason: string;
90
+ readonly usage?: StepTokenUsage | undefined;
91
+ readonly timestamp: number;
92
+ };
93
+ /**
94
+ * Input entry for appending to a thread's transcript before sequence assignment.
95
+ */
96
+ export type NewTranscriptEntry = {
97
+ readonly type: "turnStarted";
98
+ readonly turnIndex: number;
99
+ readonly userPrompt: string;
100
+ readonly timestamp: number;
101
+ } | {
102
+ readonly type: "modelMessage";
103
+ readonly message: ModelMessage;
104
+ readonly timestamp: number;
105
+ } | {
106
+ readonly type: "toolCall";
107
+ readonly callId: string;
108
+ readonly toolName: string;
109
+ readonly parameters: unknown;
110
+ readonly timestamp: number;
111
+ } | {
112
+ readonly type: "toolResult";
113
+ readonly callId: string;
114
+ readonly toolName: string;
115
+ readonly result: unknown;
116
+ readonly isError: boolean;
117
+ readonly timestamp: number;
118
+ } | {
119
+ readonly type: "checkpointRef";
120
+ readonly checkpointId: string;
121
+ readonly checkpointSequence: number;
122
+ readonly timestamp: number;
123
+ } | {
124
+ readonly type: "turnFinished";
125
+ readonly turnIndex: number;
126
+ readonly finishReason: string;
127
+ readonly usage?: StepTokenUsage | undefined;
128
+ readonly timestamp: number;
129
+ };
130
+ /**
131
+ * Parameters for creating a new thread session.
132
+ */
133
+ export interface CreateThreadInput {
134
+ /** Optional custom safe identifier. If omitted, a random UUID is generated. */
135
+ readonly id?: string | undefined;
136
+ /** Optional human-readable title. */
137
+ readonly title?: string | undefined;
138
+ /** Categorization tags. */
139
+ readonly tags?: readonly string[] | undefined;
140
+ /** Canonical workspace root directory. */
141
+ readonly workingDirectory: string;
142
+ /** Target model identifier. */
143
+ readonly model?: string | undefined;
144
+ /** Target provider identifier. */
145
+ readonly provider?: string | undefined;
146
+ /** Target reasoning effort level. */
147
+ readonly reasoning?: string | undefined;
148
+ }
149
+ /**
150
+ * Allowed mutation patch parameters for updating thread metadata.
151
+ */
152
+ export interface UpdateThreadInput {
153
+ /** Updated title or null to clear. */
154
+ readonly title?: string | null | undefined;
155
+ /** Updated tags list. */
156
+ readonly tags?: readonly string[] | undefined;
157
+ /** Updated model identifier or null to clear. */
158
+ readonly model?: string | null | undefined;
159
+ /** Updated provider identifier or null to clear. */
160
+ readonly provider?: string | null | undefined;
161
+ /** Updated reasoning effort level or null to clear. */
162
+ readonly reasoning?: string | null | undefined;
163
+ }
164
+ /**
165
+ * Authoritative thread store contract managing thread metadata and transcripts.
166
+ */
167
+ export interface ThreadStore {
168
+ /**
169
+ * Creates a new persistent thread session.
170
+ *
171
+ * @param input - Thread creation options including workspace directory.
172
+ * @returns Newly created thread metadata snapshot.
173
+ */
174
+ createThread(input: CreateThreadInput): Promise<ThreadMetadata>;
175
+ /**
176
+ * Retrieves metadata for an existing thread session.
177
+ *
178
+ * @param threadId - Safe thread identifier.
179
+ * @returns Thread metadata or undefined if not found.
180
+ */
181
+ getThread(threadId: string): Promise<ThreadMetadata | undefined>;
182
+ /**
183
+ * Lists available thread metadata snapshots matching optional filters.
184
+ *
185
+ * @param options - Filtering and pagination options.
186
+ * @returns Readonly array of thread metadata summaries.
187
+ */
188
+ listThreads(options?: {
189
+ readonly workingDirectory?: string | undefined;
190
+ readonly limit?: number | undefined;
191
+ }): Promise<readonly ThreadMetadata[]>;
192
+ /**
193
+ * Updates an existing thread's metadata fields using an explicit patch.
194
+ *
195
+ * @param threadId - Safe thread identifier.
196
+ * @param patch - Allowed metadata patch fields.
197
+ * @returns Updated thread metadata snapshot.
198
+ */
199
+ updateThread(threadId: string, patch: UpdateThreadInput): Promise<ThreadMetadata>;
200
+ /**
201
+ * Deletes a thread directory and its associated persistent artifacts.
202
+ *
203
+ * @param threadId - Safe thread identifier.
204
+ * @returns True if thread existed and was removed, false otherwise.
205
+ */
206
+ deleteThread(threadId: string): Promise<boolean>;
207
+ /**
208
+ * Appends an entry to the append-only thread transcript log under thread lock.
209
+ *
210
+ * @param threadId - Safe thread identifier.
211
+ * @param entry - New unsequenced transcript entry.
212
+ * @returns Sequenced and persisted transcript entry.
213
+ */
214
+ appendTranscript(threadId: string, entry: NewTranscriptEntry): Promise<TranscriptEntry>;
215
+ /**
216
+ * Reads the full append-only transcript log for a thread session.
217
+ *
218
+ * @param threadId - Safe thread identifier.
219
+ * @returns Readonly array of sequenced transcript entries.
220
+ */
221
+ getTranscript(threadId: string): Promise<readonly TranscriptEntry[]>;
222
+ /**
223
+ * Projects conversational model messages from the authoritative transcript.
224
+ *
225
+ * @param threadId - Safe thread identifier.
226
+ * @returns Readonly array of ModelMessage items for model invocation.
227
+ */
228
+ getMessages(threadId: string): Promise<readonly ModelMessage[]>;
229
+ }
230
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sources":["../../src/threads/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @fileoverview Thread session, transcript entries, and store contracts.
3
+ * @packageDocumentation
4
+ */
5
+ export {};
6
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sources":["../../src/threads/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * @fileoverview Universal interface contract for tools operating inside Hernex.
3
+ * @packageDocumentation
4
+ */
5
+ import type { z } from "zod";
6
+ import type { ToolExecutionContext } from "./ToolExecutionContext.js";
7
+ /**
8
+ * Universal interface contract for tools operating inside Hernex.
9
+ *
10
+ * @typeParam TInput - The Zod schema type defining and validating input parameters.
11
+ * @typeParam TOutput - The return type produced upon successful tool execution.
12
+ */
13
+ export interface AgentTool<TInput extends z.ZodTypeAny = z.ZodTypeAny, TOutput = unknown> {
14
+ /**
15
+ * Unique name of the tool exposed to the language model (e.g. 'readFile', 'bash').
16
+ * Must follow strict camelCase or PascalCase conventions.
17
+ */
18
+ readonly name: string;
19
+ /**
20
+ * Detailed instruction prompt and description provided directly to the model
21
+ * to guide parameter formulation and tool selection.
22
+ */
23
+ readonly description: string;
24
+ /**
25
+ * Declarative Zod schema used for runtime parameter parsing, validation,
26
+ * and automatic JSON Schema derivation for model function calling.
27
+ */
28
+ readonly inputSchema: TInput;
29
+ /**
30
+ * Executes the tool logic using validated parameters and the current execution context.
31
+ *
32
+ * @param parameters - The validated parameters inferred from the tool's input schema.
33
+ * @param context - Execution context containing thread ID, working directory, and signals.
34
+ * @returns A promise resolving to the tool output data.
35
+ */
36
+ execute(parameters: z.infer<TInput>, context: ToolExecutionContext): Promise<TOutput>;
37
+ }
38
+ //# sourceMappingURL=AgentTool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AgentTool.d.ts","sources":["../../src/tools/AgentTool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,SAAS,CACxB,MAAM,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EAC1C,OAAO,GAAG,OAAO;IAEjB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;;;OAMG;IACH,OAAO,CACL,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @fileoverview Universal interface contract for tools operating inside Hernex.
3
+ * @packageDocumentation
4
+ */
5
+ export {};
6
+ //# sourceMappingURL=AgentTool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AgentTool.js","sources":["../../src/tools/AgentTool.ts"],"names":[],"mappings":"AAAA;;;GAGG"}