@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,123 @@
1
+ /**
2
+ * @fileoverview Conversational model message projection from append-only transcript logs.
3
+ * @packageDocumentation
4
+ */
5
+ import { toJsonValue } from "../events/types.js";
6
+ /**
7
+ * Type guard identifying tool-call content parts in assistant messages.
8
+ */
9
+ function isToolCallPart(part) {
10
+ return (typeof part === "object" &&
11
+ part !== null &&
12
+ part.type === "tool-call" &&
13
+ typeof part.toolCallId === "string");
14
+ }
15
+ /**
16
+ * Projects conversational model messages from an authoritative transcript log.
17
+ *
18
+ * Implements deterministic replay invariants:
19
+ * - Excludes entries belonging to failed, vetoed, or uncommitted turns so the resumed
20
+ * engine history matches the live post-failure engine state.
21
+ * - Preserves user, assistant, and externally added messages in correct chronological order.
22
+ * - Reconstructs standard AI SDK v7 `role: "tool"` messages containing `tool-result` blocks
23
+ * from persisted `toolResult` entries in exact correspondence to assistant `tool-call`s.
24
+ *
25
+ * @param transcript - Ordered array of sequenced transcript entries.
26
+ * @returns Reconstructed array of ModelMessage items for seeding or resuming the model.
27
+ */
28
+ export function projectModelMessages(transcript) {
29
+ if (transcript.length === 0) {
30
+ return [];
31
+ }
32
+ // 1. Identify committed vs failed/uncommitted turns
33
+ const startedTurns = new Set();
34
+ const finishedTurns = new Set();
35
+ const committedTurns = new Set();
36
+ const failedOrVetoedTurns = new Set();
37
+ for (const entry of transcript) {
38
+ if (entry.type === "turnStarted" && typeof entry.turnIndex === "number") {
39
+ startedTurns.add(entry.turnIndex);
40
+ }
41
+ if (entry.type === "turnFinished" && typeof entry.turnIndex === "number") {
42
+ finishedTurns.add(entry.turnIndex);
43
+ if (entry.finishReason === "error" || entry.finishReason === "vetoed") {
44
+ failedOrVetoedTurns.add(entry.turnIndex);
45
+ }
46
+ else {
47
+ committedTurns.add(entry.turnIndex);
48
+ }
49
+ }
50
+ }
51
+ // 2. Index tool results by callId for fast lookup
52
+ const toolResultsByCallId = new Map();
53
+ for (const entry of transcript) {
54
+ if (entry.type === "toolResult") {
55
+ toolResultsByCallId.set(entry.callId, {
56
+ toolName: entry.toolName,
57
+ result: entry.result,
58
+ isError: entry.isError,
59
+ });
60
+ }
61
+ }
62
+ // 3. Project messages
63
+ const messages = [];
64
+ for (const entry of transcript) {
65
+ // Check turn commitment policy:
66
+ // If turnIndex is present, skip if turn is failed/vetoed, uncommitted, or not committed
67
+ if (entry.turnIndex !== undefined) {
68
+ if (failedOrVetoedTurns.has(entry.turnIndex)) {
69
+ continue;
70
+ }
71
+ if (startedTurns.has(entry.turnIndex) &&
72
+ !finishedTurns.has(entry.turnIndex)) {
73
+ continue;
74
+ }
75
+ if (!committedTurns.has(entry.turnIndex)) {
76
+ continue;
77
+ }
78
+ }
79
+ if (entry.type === "modelMessage") {
80
+ const msg = entry.message;
81
+ // Handle assistant messages containing tool-call parts
82
+ if (msg.role === "assistant" && Array.isArray(msg.content)) {
83
+ messages.push(msg);
84
+ // Find tool calls
85
+ const toolCallParts = [];
86
+ for (const part of msg.content) {
87
+ if (isToolCallPart(part)) {
88
+ toolCallParts.push(part);
89
+ }
90
+ }
91
+ if (toolCallParts.length > 0) {
92
+ const matchingResults = toolCallParts
93
+ .map((tc) => {
94
+ const res = toolResultsByCallId.get(tc.toolCallId);
95
+ if (!res) {
96
+ return null;
97
+ }
98
+ return {
99
+ type: "tool-result",
100
+ toolCallId: tc.toolCallId,
101
+ toolName: res.toolName,
102
+ output: typeof res.result === "string"
103
+ ? { type: "text", value: res.result }
104
+ : { type: "json", value: toJsonValue(res.result) },
105
+ };
106
+ })
107
+ .filter((item) => item !== null);
108
+ if (matchingResults.length > 0) {
109
+ messages.push({
110
+ role: "tool",
111
+ content: matchingResults,
112
+ });
113
+ }
114
+ }
115
+ }
116
+ else {
117
+ messages.push(msg);
118
+ }
119
+ }
120
+ }
121
+ return messages;
122
+ }
123
+ //# sourceMappingURL=transcriptProjection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transcriptProjection.js","sources":["../../src/threads/transcriptProjection.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,250 @@
1
+ /**
2
+ * @fileoverview Threads, 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 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. */
34
+ readonly model?: string | null | undefined;
35
+ /** Provider identifier bound to this thread. */
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. */
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 version?: number | undefined;
55
+ readonly type: "turnStarted";
56
+ readonly sequence: number;
57
+ readonly turnIndex: number;
58
+ readonly userPrompt: string;
59
+ readonly timestamp: number;
60
+ } | {
61
+ readonly version?: number | undefined;
62
+ readonly type: "modelMessage";
63
+ readonly sequence: number;
64
+ readonly turnIndex?: number | undefined;
65
+ readonly message: ModelMessage;
66
+ readonly timestamp: number;
67
+ } | {
68
+ readonly version?: number | undefined;
69
+ readonly type: "toolCall";
70
+ readonly sequence: number;
71
+ readonly turnIndex?: number | undefined;
72
+ readonly callId: string;
73
+ readonly toolName: string;
74
+ readonly parameters: unknown;
75
+ readonly timestamp: number;
76
+ } | {
77
+ readonly version?: number | undefined;
78
+ readonly type: "toolResult";
79
+ readonly sequence: number;
80
+ readonly turnIndex?: number | undefined;
81
+ readonly callId: string;
82
+ readonly toolName: string;
83
+ readonly result: unknown;
84
+ readonly isError: boolean;
85
+ readonly timestamp: number;
86
+ } | {
87
+ readonly version?: number | undefined;
88
+ readonly type: "checkpointRef";
89
+ readonly sequence: number;
90
+ readonly turnIndex?: number | undefined;
91
+ readonly checkpointId: string;
92
+ readonly checkpointSequence: number;
93
+ readonly timestamp: number;
94
+ } | {
95
+ readonly version?: number | undefined;
96
+ readonly type: "turnFinished";
97
+ readonly sequence: number;
98
+ readonly turnIndex: number;
99
+ readonly finishReason: string;
100
+ readonly usage?: StepTokenUsage | undefined;
101
+ readonly timestamp: number;
102
+ };
103
+ /**
104
+ * Input entry for appending to a thread's transcript before sequence assignment.
105
+ */
106
+ export type NewTranscriptEntry = {
107
+ readonly version?: number | undefined;
108
+ readonly type: "turnStarted";
109
+ readonly turnIndex: number;
110
+ readonly userPrompt: string;
111
+ readonly timestamp: number;
112
+ } | {
113
+ readonly version?: number | undefined;
114
+ readonly type: "modelMessage";
115
+ readonly turnIndex?: number | undefined;
116
+ readonly message: ModelMessage;
117
+ readonly timestamp: number;
118
+ } | {
119
+ readonly version?: number | undefined;
120
+ readonly type: "toolCall";
121
+ readonly turnIndex?: number | undefined;
122
+ readonly callId: string;
123
+ readonly toolName: string;
124
+ readonly parameters: unknown;
125
+ readonly timestamp: number;
126
+ } | {
127
+ readonly version?: number | undefined;
128
+ readonly type: "toolResult";
129
+ readonly turnIndex?: number | undefined;
130
+ readonly callId: string;
131
+ readonly toolName: string;
132
+ readonly result: unknown;
133
+ readonly isError: boolean;
134
+ readonly timestamp: number;
135
+ } | {
136
+ readonly version?: number | undefined;
137
+ readonly type: "checkpointRef";
138
+ readonly turnIndex?: number | undefined;
139
+ readonly checkpointId: string;
140
+ readonly checkpointSequence: number;
141
+ readonly timestamp: number;
142
+ } | {
143
+ readonly version?: number | undefined;
144
+ readonly type: "turnFinished";
145
+ readonly turnIndex: number;
146
+ readonly finishReason: string;
147
+ readonly usage?: StepTokenUsage | undefined;
148
+ readonly timestamp: number;
149
+ };
150
+ /**
151
+ * Parameters for creating a new thread.
152
+ */
153
+ export interface CreateThreadInput {
154
+ /** Optional custom safe identifier. If omitted, a random UUID is generated. */
155
+ readonly id?: string | undefined;
156
+ /** Optional human-readable title. */
157
+ readonly title?: string | undefined;
158
+ /** Categorization tags. */
159
+ readonly tags?: readonly string[] | undefined;
160
+ /** Canonical workspace root directory. */
161
+ readonly workingDirectory: string;
162
+ /** Target model identifier. */
163
+ readonly model?: string | undefined;
164
+ /** Target provider identifier. */
165
+ readonly provider?: string | undefined;
166
+ /** Target reasoning effort level. */
167
+ readonly reasoning?: string | undefined;
168
+ }
169
+ /**
170
+ * Allowed mutation patch parameters for updating thread metadata.
171
+ */
172
+ export interface UpdateThreadInput {
173
+ /** Updated title or null to clear. */
174
+ readonly title?: string | null | undefined;
175
+ /** Updated tags list. */
176
+ readonly tags?: readonly string[] | undefined;
177
+ /** Updated model identifier or null to clear. */
178
+ readonly model?: string | null | undefined;
179
+ /** Updated provider identifier or null to clear. */
180
+ readonly provider?: string | null | undefined;
181
+ /** Updated reasoning effort level or null to clear. */
182
+ readonly reasoning?: string | null | undefined;
183
+ }
184
+ /**
185
+ * Authoritative thread store contract managing thread metadata and transcripts.
186
+ */
187
+ export interface ThreadStore {
188
+ /**
189
+ * Creates a new persistent thread.
190
+ *
191
+ * @param input - Thread creation options including workspace directory.
192
+ * @returns Newly created thread metadata snapshot.
193
+ */
194
+ createThread(input: CreateThreadInput): Promise<ThreadMetadata>;
195
+ /**
196
+ * Retrieves metadata for an existing thread.
197
+ *
198
+ * @param threadId - Safe thread identifier.
199
+ * @returns Thread metadata or undefined if not found.
200
+ */
201
+ getThread(threadId: string): Promise<ThreadMetadata | undefined>;
202
+ /**
203
+ * Lists available thread metadata snapshots matching optional filters.
204
+ *
205
+ * @param options - Filtering and pagination options.
206
+ * @returns Readonly array of thread metadata summaries.
207
+ */
208
+ listThreads(options?: {
209
+ readonly workingDirectory?: string | undefined;
210
+ readonly limit?: number | undefined;
211
+ }): Promise<readonly ThreadMetadata[]>;
212
+ /**
213
+ * Updates an existing thread's metadata fields using an explicit patch.
214
+ *
215
+ * @param threadId - Safe thread identifier.
216
+ * @param patch - Allowed metadata patch fields.
217
+ * @returns Updated thread metadata snapshot.
218
+ */
219
+ updateThread(threadId: string, patch: UpdateThreadInput): Promise<ThreadMetadata>;
220
+ /**
221
+ * Deletes a thread directory and its associated persistent artifacts.
222
+ *
223
+ * @param threadId - Safe thread identifier.
224
+ * @returns True if thread existed and was removed, false otherwise.
225
+ */
226
+ deleteThread(threadId: string): Promise<boolean>;
227
+ /**
228
+ * Appends an entry to the append-only thread transcript log under thread lock.
229
+ *
230
+ * @param threadId - Safe thread identifier.
231
+ * @param entry - New unsequenced transcript entry.
232
+ * @returns Sequenced and persisted transcript entry.
233
+ */
234
+ appendTranscript(threadId: string, entry: NewTranscriptEntry): Promise<TranscriptEntry>;
235
+ /**
236
+ * Reads the full append-only transcript log for a thread.
237
+ *
238
+ * @param threadId - Safe thread identifier.
239
+ * @returns Readonly array of sequenced transcript entries.
240
+ */
241
+ getTranscript(threadId: string): Promise<readonly TranscriptEntry[]>;
242
+ /**
243
+ * Projects conversational model messages from the authoritative transcript.
244
+ *
245
+ * @param threadId - Safe thread identifier.
246
+ * @returns Readonly array of ModelMessage items for model invocation.
247
+ */
248
+ getMessages(threadId: string): Promise<readonly ModelMessage[]>;
249
+ }
250
+ //# 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 Threads, 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"}
@@ -0,0 +1,61 @@
1
+ /**
2
+ * @fileoverview Built-in tool for executing shell commands in the workspace.
3
+ * Delegates process creation, streaming output, timeouts, and lifecycle management
4
+ * directly to the TaskManager instance injected in ToolExecutionContext.
5
+ * @packageDocumentation
6
+ */
7
+ import { z } from "zod";
8
+ import type { AgentTool } from "./AgentTool.js";
9
+ import type { ToolExecutionContext } from "./ToolExecutionContext.js";
10
+ /**
11
+ * Input parameter schema for BashTool.
12
+ */
13
+ export declare const bashInputSchema: z.ZodObject<{
14
+ command: z.ZodString;
15
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
16
+ waitMsBeforeAsync: z.ZodOptional<z.ZodNumber>;
17
+ }, z.core.$strip>;
18
+ /**
19
+ * Result structure produced by BashTool.
20
+ */
21
+ export interface BashOutput {
22
+ /** Execution status of the command or task. */
23
+ readonly status: "running" | "exited" | "killed" | "failed";
24
+ /** The command string executed. */
25
+ readonly command: string;
26
+ /** Unique task identifier managed by TaskManager. */
27
+ readonly taskId: string;
28
+ /** Captured stdout and stderr output text. */
29
+ readonly output: string;
30
+ /** Process exit code, or null if running or terminated by signal without code. */
31
+ readonly exitCode: number | null;
32
+ /** Total elapsed time in milliseconds. */
33
+ readonly durationMs: number;
34
+ /** Whether the output was truncated due to buffer limits. */
35
+ readonly outputTruncated: boolean;
36
+ }
37
+ /**
38
+ * Built-in tool for executing shell commands.
39
+ * Commands run with the current operating system user's privileges in the workspace directory.
40
+ * The environment is filtered to avoid credential leakage, but execution is not an isolated sandbox.
41
+ */
42
+ export declare class BashTool implements AgentTool<typeof bashInputSchema, BashOutput> {
43
+ static readonly toolName = "bash";
44
+ readonly name = "bash";
45
+ readonly description: string;
46
+ readonly inputSchema: z.ZodObject<{
47
+ command: z.ZodString;
48
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
49
+ waitMsBeforeAsync: z.ZodOptional<z.ZodNumber>;
50
+ }, z.core.$strip>;
51
+ /**
52
+ * Executes a shell command by delegating to the context TaskManager.
53
+ *
54
+ * @param parameters - Validated parameters containing command, timeoutMs, and waitMsBeforeAsync.
55
+ * @param context - The execution context with workingDirectory, taskManager, and emitProgress.
56
+ * @returns A promise resolving to the command execution output.
57
+ * @throws Error if context.taskManager is not configured.
58
+ */
59
+ execute(parameters: z.infer<typeof bashInputSchema>, context: ToolExecutionContext): Promise<BashOutput>;
60
+ }
61
+ //# sourceMappingURL=BashTool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BashTool.d.ts","sources":["../../src/tools/BashTool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAkBtE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;iBAyB1B,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC5D,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED;;;;GAIG;AACH,qBAAa,QAAS,YAAW,SAAS,CAAC,OAAO,eAAe,EAAE,UAAU,CAAC;IAC5E,gBAAuB,QAAQ,UAAU;IAEzC,SAAgB,IAAI,UAAqB;IACzC,SAAgB,WAAW,SAAmB;IAC9C,SAAgB,WAAW;;;;sBAAmB;IAE9C;;;;;;;OAOG;IACU,OAAO,CAClB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,EAC3C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC,CA8GrB;CACF"}