@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,138 @@
1
+ /**
2
+ * @fileoverview Configuration contracts for instantiating and running the AgentEngine.
3
+ * @packageDocumentation
4
+ */
5
+ import type { HernexModelInput } from "../model/types.js";
6
+ import type { ProviderRegistry } from "../model/ProviderRegistry.js";
7
+ import type { AgentHooks } from "../hooks/index.js";
8
+ import type { AgentReasoningLevel, ThreadStore } from "../threads/index.js";
9
+ import type { CheckpointStore } from "../checkpoints/index.js";
10
+ import type { TaskManager } from "../tools/index.js";
11
+ import type { ToolRegistry } from "../tools/index.js";
12
+ /**
13
+ * Static configuration options for instantiating an AgentEngine.
14
+ */
15
+ export interface AgentEngineConfig {
16
+ /**
17
+ * Unique identifier of the conversational thread session.
18
+ */
19
+ readonly threadId: string;
20
+ /**
21
+ * Root working directory for tool operations and relative path resolution.
22
+ */
23
+ readonly workingDirectory: string;
24
+ /**
25
+ * Model specification formatted as "provider/model_id" or a pre-instantiated LanguageModel.
26
+ */
27
+ readonly model: HernexModelInput;
28
+ /**
29
+ * Mandatory API key used for resolving provider credentials.
30
+ */
31
+ readonly apiKey: string;
32
+ /**
33
+ * Mandatory base URL for the model provider endpoint.
34
+ */
35
+ readonly baseUrl: string;
36
+ /**
37
+ * Tool registry supplying available agent tools and schema definitions.
38
+ */
39
+ readonly tools: ToolRegistry;
40
+ /**
41
+ * Optional custom provider registry for isolated resolution.
42
+ */
43
+ readonly providerRegistry?: ProviderRegistry | undefined;
44
+ /**
45
+ * Optional system instructions passed to the model across all turns.
46
+ */
47
+ readonly instructions?: string | undefined;
48
+ /**
49
+ * Optional TaskManager instance for background shell process management.
50
+ */
51
+ readonly taskManager?: TaskManager | undefined;
52
+ /**
53
+ * Optional consumer lifecycle and authorization hooks.
54
+ */
55
+ readonly hooks?: AgentHooks | undefined;
56
+ /**
57
+ * Optional top-level reasoning/thinking effort level for the model.
58
+ * Controls how much reasoning the model performs before generating a response.
59
+ */
60
+ readonly reasoning?: AgentReasoningLevel | undefined;
61
+ /**
62
+ * Maximum autonomous tool-execution steps allowed within a single turn before stopping.
63
+ * Defaults to 25.
64
+ */
65
+ readonly maxSteps?: number | undefined;
66
+ /**
67
+ * Whether to persist the conversation thread, metadata, and transcript to disk.
68
+ * Defaults to false (completely in-memory and ephemeral).
69
+ */
70
+ readonly persist?: boolean | undefined;
71
+ /**
72
+ * Whether to enable content-addressed file delta checkpoints.
73
+ * Invariant: Requires `persist: true`. If `persist` is false, checkpointing is strictly disabled.
74
+ * Defaults to false.
75
+ */
76
+ readonly checkpoint?: boolean | undefined;
77
+ /**
78
+ * Optional global abort signal for cancelling in-flight engine operations.
79
+ */
80
+ readonly abortSignal?: AbortSignal | undefined;
81
+ /**
82
+ * Optional custom persistent ThreadStore backing this engine instance.
83
+ * If omitted and `persist: true`, a FileThreadStore is instantiated automatically.
84
+ */
85
+ readonly threadStore?: ThreadStore | undefined;
86
+ /**
87
+ * Optional custom CheckpointStore backing this engine instance.
88
+ * If omitted and `persist: true` & `checkpoint: true`, a FileCheckpointStore is instantiated automatically.
89
+ */
90
+ readonly checkpointStore?: CheckpointStore | undefined;
91
+ }
92
+ /**
93
+ * Options provided when executing a single autonomous turn via runTurn.
94
+ */
95
+ export interface RunTurnOptions {
96
+ /**
97
+ * The user message or prompt initiating the turn.
98
+ */
99
+ readonly userPrompt: string;
100
+ /**
101
+ * One-based sequence index for the active turn within the thread session.
102
+ * Defaults to 1 if not specified.
103
+ */
104
+ readonly turnIndex?: number;
105
+ /**
106
+ * Optional per-turn instructions appended to or overriding base instructions.
107
+ */
108
+ readonly instructions?: string;
109
+ /**
110
+ * Optional per-turn reasoning effort level overriding the engine-level setting.
111
+ */
112
+ readonly reasoning?: AgentReasoningLevel;
113
+ /**
114
+ * Optional per-turn model override formatted as "provider/model_id" or a LanguageModel.
115
+ */
116
+ readonly model?: HernexModelInput;
117
+ /**
118
+ * Optional API key override for the per-turn model.
119
+ */
120
+ readonly apiKey?: string;
121
+ /**
122
+ * Optional base URL override for the per-turn model endpoint.
123
+ */
124
+ readonly baseUrl?: string;
125
+ /**
126
+ * Maximum autonomous steps for this specific turn.
127
+ */
128
+ readonly maxSteps?: number;
129
+ /**
130
+ * Optional abort signal for cancelling this specific turn.
131
+ */
132
+ readonly abortSignal?: AbortSignal;
133
+ /**
134
+ * Optional product-defined metadata passed through to turn hooks.
135
+ */
136
+ readonly metadataOverride?: Readonly<Record<string, unknown>>;
137
+ }
138
+ //# sourceMappingURL=engineConfig.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engineConfig.d.ts","sources":["../../src/engine/engineConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAE/C;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAExC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAErD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEvC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAE/C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAE/C;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC/D"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @fileoverview Configuration contracts for instantiating and running the AgentEngine.
3
+ * @packageDocumentation
4
+ */
5
+ export {};
6
+ //# sourceMappingURL=engineConfig.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engineConfig.js","sources":["../../src/engine/engineConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * @fileoverview High-performance asynchronous event queue for decoupled progress and lifecycle streaming.
3
+ * @packageDocumentation
4
+ */
5
+ /**
6
+ * Lightweight asynchronous queue enabling push-based streaming without timer polling.
7
+ *
8
+ * @typeParam T - The item type emitted by the queue.
9
+ */
10
+ export declare class AsyncEventQueue<T> implements AsyncIterable<T> {
11
+ private readonly items;
12
+ private readonly waitingConsumers;
13
+ private isClosed;
14
+ private failureError;
15
+ /**
16
+ * Pushes a new item into the queue. Wakes waiting consumers immediately.
17
+ *
18
+ * @param item - The item to enqueue.
19
+ */
20
+ push(item: T): void;
21
+ /**
22
+ * Closes the queue gracefully, signaling completion to consumers.
23
+ */
24
+ close(): void;
25
+ /**
26
+ * Signals a fatal error to any waiting or future consumers.
27
+ *
28
+ * @param error - Error instance or message.
29
+ */
30
+ error(error: unknown): void;
31
+ /**
32
+ * Fetches the next item from the queue asynchronously.
33
+ *
34
+ * @returns A promise resolving to the next IteratorResult.
35
+ */
36
+ next(): Promise<IteratorResult<T>>;
37
+ /**
38
+ * Implements the AsyncIterable protocol.
39
+ */
40
+ [Symbol.asyncIterator](): AsyncIterator<T>;
41
+ }
42
+ //# sourceMappingURL=eventQueue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"eventQueue.d.ts","sources":["../../src/engine/eventQueue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAGzB;IACR,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAiB;IAErC;;;;OAIG;IACI,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAUzB;IAED;;OAEG;IACI,KAAK,IAAI,IAAI,CASnB;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAUjC;IAED;;;;OAIG;IACU,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAa9C;IAED;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAQhD;CACF"}
@@ -0,0 +1,93 @@
1
+ /**
2
+ * @fileoverview High-performance asynchronous event queue for decoupled progress and lifecycle streaming.
3
+ * @packageDocumentation
4
+ */
5
+ /**
6
+ * Lightweight asynchronous queue enabling push-based streaming without timer polling.
7
+ *
8
+ * @typeParam T - The item type emitted by the queue.
9
+ */
10
+ export class AsyncEventQueue {
11
+ items = [];
12
+ waitingConsumers = [];
13
+ isClosed = false;
14
+ failureError = null;
15
+ /**
16
+ * Pushes a new item into the queue. Wakes waiting consumers immediately.
17
+ *
18
+ * @param item - The item to enqueue.
19
+ */
20
+ push(item) {
21
+ if (this.isClosed) {
22
+ return;
23
+ }
24
+ if (this.waitingConsumers.length > 0) {
25
+ const consumer = this.waitingConsumers.shift();
26
+ consumer.resolve({ value: item, done: false });
27
+ }
28
+ else {
29
+ this.items.push(item);
30
+ }
31
+ }
32
+ /**
33
+ * Closes the queue gracefully, signaling completion to consumers.
34
+ */
35
+ close() {
36
+ if (this.isClosed) {
37
+ return;
38
+ }
39
+ this.isClosed = true;
40
+ while (this.waitingConsumers.length > 0) {
41
+ const consumer = this.waitingConsumers.shift();
42
+ consumer.resolve({ value: undefined, done: true });
43
+ }
44
+ }
45
+ /**
46
+ * Signals a fatal error to any waiting or future consumers.
47
+ *
48
+ * @param error - Error instance or message.
49
+ */
50
+ error(error) {
51
+ if (this.isClosed) {
52
+ return;
53
+ }
54
+ this.isClosed = true;
55
+ this.failureError = error;
56
+ while (this.waitingConsumers.length > 0) {
57
+ const consumer = this.waitingConsumers.shift();
58
+ consumer.reject(error);
59
+ }
60
+ }
61
+ /**
62
+ * Fetches the next item from the queue asynchronously.
63
+ *
64
+ * @returns A promise resolving to the next IteratorResult.
65
+ */
66
+ async next() {
67
+ if (this.items.length > 0) {
68
+ return { value: this.items.shift(), done: false };
69
+ }
70
+ if (this.failureError) {
71
+ throw this.failureError;
72
+ }
73
+ if (this.isClosed) {
74
+ return { value: undefined, done: true };
75
+ }
76
+ return new Promise((resolve, reject) => {
77
+ this.waitingConsumers.push({ resolve, reject });
78
+ });
79
+ }
80
+ /**
81
+ * Implements the AsyncIterable protocol.
82
+ */
83
+ [Symbol.asyncIterator]() {
84
+ return {
85
+ next: () => this.next(),
86
+ return: async () => {
87
+ this.close();
88
+ return { value: undefined, done: true };
89
+ },
90
+ };
91
+ }
92
+ }
93
+ //# sourceMappingURL=eventQueue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"eventQueue.js","sources":["../../src/engine/eventQueue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,OAAO,eAAe;IACT,KAAK,GAAQ,EAAE,CAAC;IAChB,gBAAgB,GAG5B,EAAE,CAAC;IACA,QAAQ,GAAG,KAAK,CAAC;IACjB,YAAY,GAAY,IAAI,CAAC;IAErC;;;;OAIG;IACI,IAAI,CAAC,IAAO;QACjB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAG,CAAC;YAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAG,CAAC;YAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAyB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAc;QACzB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAG,CAAC;YAChD,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,IAAI;QACf,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,YAAY,CAAC;QAC1B,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,SAAyB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC1D,CAAC;QACD,OAAO,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE;YACvB,MAAM,EAAE,KAAK,IAAI,EAAE;gBACjB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,OAAO,EAAE,KAAK,EAAE,SAAyB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAC1D,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * @fileoverview Core engine subsystem exports for Hernex.
3
+ * @packageDocumentation
4
+ */
5
+ export type { AgentEngineConfig, RunTurnOptions, } from "./engineConfig.js";
6
+ export { AgentEngine } from "./AgentEngine.js";
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,iBAAiB,EACjB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @fileoverview Core engine subsystem exports for Hernex.
3
+ * @packageDocumentation
4
+ */
5
+ export { AgentEngine } from "./AgentEngine.js";
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * @fileoverview Autonomous multi-step turn runner for the agent engine microkernel.
3
+ * @packageDocumentation
4
+ */
5
+ import type { ModelMessage } from "../model/types.js";
6
+ import type { AgentEvent } from "../events/index.js";
7
+ import type { AgentEngineConfig, RunTurnOptions } from "./engineConfig.js";
8
+ /**
9
+ * Runs a single autonomous turn within the agent engine microkernel.
10
+ *
11
+ * @param config - The active engine configuration.
12
+ * @param options - Per-turn options including user prompt and overrides.
13
+ * @param conversationMessages - Mutable array of thread conversation messages.
14
+ * @returns An async generator yielding pure serializable `AgentEvent` objects.
15
+ */
16
+ export declare function runTurn(config: AgentEngineConfig, options: RunTurnOptions, conversationMessages: ModelMessage[]): AsyncGenerator<AgentEvent, void, void>;
17
+ //# sourceMappingURL=runTurn.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runTurn.d.ts","sources":["../../src/engine/runTurn.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,oBAAoB,CAAC;AAG3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAiF3E;;;;;;;GAOG;AACH,wBAAuB,OAAO,CAC5B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,cAAc,EACvB,oBAAoB,EAAE,YAAY,EAAE,GACnC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAsrBxC"}