@machina.ai/cell-cli-core 1.38.1-rc2 → 1.40.1-rc2

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 (822) hide show
  1. package/dist/docs/AFTER_MERGE_PROMPT.md +1 -1
  2. package/dist/docs/admin/enterprise-controls.md +1 -1
  3. package/dist/docs/changelogs/index.md +42 -0
  4. package/dist/docs/changelogs/latest.md +254 -361
  5. package/dist/docs/changelogs/preview.md +237 -406
  6. package/dist/docs/cli/acp-mode.md +6 -6
  7. package/dist/docs/cli/auto-memory.md +143 -0
  8. package/dist/docs/cli/checkpointing.md +5 -5
  9. package/dist/docs/cli/cli-reference.md +12 -11
  10. package/dist/docs/cli/creating-skills.md +2 -2
  11. package/dist/docs/cli/custom-commands.md +15 -14
  12. package/dist/docs/cli/enterprise.md +17 -14
  13. package/dist/docs/cli/gemini-ignore.md +2 -2
  14. package/dist/docs/cli/generation-settings.md +21 -20
  15. package/dist/docs/cli/model-routing.md +2 -2
  16. package/dist/docs/cli/model-steering.md +1 -1
  17. package/dist/docs/cli/plan-mode.md +11 -6
  18. package/dist/docs/cli/sandbox.md +7 -5
  19. package/dist/docs/cli/settings.md +32 -28
  20. package/dist/docs/cli/system-prompt.md +8 -8
  21. package/dist/docs/cli/telemetry.md +18 -11
  22. package/dist/docs/cli/themes.md +2 -2
  23. package/dist/docs/cli/trusted-folders.md +41 -13
  24. package/dist/docs/cli/tutorials/mcp-setup.md +1 -1
  25. package/dist/docs/cli/tutorials/memory-management.md +3 -1
  26. package/dist/docs/cli/tutorials/plan-mode-steering.md +2 -2
  27. package/dist/docs/cli/tutorials/session-management.md +1 -1
  28. package/dist/docs/cli/tutorials/shell-commands.md +1 -1
  29. package/dist/docs/cli/tutorials/task-planning.md +3 -3
  30. package/dist/docs/core/index.md +5 -6
  31. package/dist/docs/core/local-model-routing.md +1 -1
  32. package/dist/docs/core/remote-agents.md +1 -1
  33. package/dist/docs/core/subagents.md +38 -8
  34. package/dist/docs/extensions/best-practices.md +5 -4
  35. package/dist/docs/extensions/reference.md +6 -5
  36. package/dist/docs/extensions/releasing.md +6 -5
  37. package/dist/docs/extensions/writing-extensions.md +11 -11
  38. package/dist/docs/get-started/{authentication.md → authentication.mdx} +139 -93
  39. package/dist/docs/get-started/gemini-3.md +1 -1
  40. package/dist/docs/get-started/index.md +4 -4
  41. package/dist/docs/get-started/installation.mdx +201 -0
  42. package/dist/docs/hooks/best-practices.md +18 -17
  43. package/dist/docs/hooks/index.md +10 -8
  44. package/dist/docs/hooks/reference.md +10 -10
  45. package/dist/docs/ide-integration/ide-companion-spec.md +14 -14
  46. package/dist/docs/ide-integration/index.md +4 -4
  47. package/dist/docs/index.md +2 -2
  48. package/dist/docs/integration-tests.md +84 -2
  49. package/dist/docs/issue-and-pr-automation.md +8 -7
  50. package/dist/docs/npm.md +2 -2
  51. package/dist/docs/reference/commands.md +11 -11
  52. package/dist/docs/reference/configuration.md +150 -47
  53. package/dist/docs/reference/keyboard-shortcuts.md +79 -2
  54. package/dist/docs/reference/memport.md +2 -3
  55. package/dist/docs/reference/policy-engine.md +60 -26
  56. package/dist/docs/reference/tools.md +38 -4
  57. package/dist/docs/release-confidence.md +1 -1
  58. package/dist/docs/releases.md +19 -19
  59. package/dist/docs/resources/faq.md +5 -5
  60. package/dist/docs/resources/tos-privacy.md +10 -9
  61. package/dist/docs/resources/troubleshooting.md +17 -16
  62. package/dist/docs/resources/uninstall.md +5 -4
  63. package/dist/docs/sidebar.json +13 -1
  64. package/dist/docs/tools/ask-user.md +3 -3
  65. package/dist/docs/tools/file-system.md +7 -7
  66. package/dist/docs/tools/mcp-resources.md +44 -0
  67. package/dist/docs/tools/mcp-server.md +42 -39
  68. package/dist/docs/tools/shell.md +5 -5
  69. package/dist/docs/tools/tracker.md +61 -0
  70. package/dist/package.json +5 -4
  71. package/dist/src/agent/content-utils.d.ts +0 -6
  72. package/dist/src/agent/content-utils.js +0 -14
  73. package/dist/src/agent/content-utils.js.map +1 -1
  74. package/dist/src/agent/content-utils.test.js +1 -18
  75. package/dist/src/agent/content-utils.test.js.map +1 -1
  76. package/dist/src/agent/event-translator.js +8 -3
  77. package/dist/src/agent/event-translator.js.map +1 -1
  78. package/dist/src/agent/event-translator.test.js +14 -9
  79. package/dist/src/agent/event-translator.test.js.map +1 -1
  80. package/dist/src/agent/legacy-agent-session.js +9 -3
  81. package/dist/src/agent/legacy-agent-session.js.map +1 -1
  82. package/dist/src/agent/legacy-agent-session.test.js +4 -3
  83. package/dist/src/agent/legacy-agent-session.test.js.map +1 -1
  84. package/dist/src/agent/tool-display-utils.d.ts +30 -0
  85. package/dist/src/agent/tool-display-utils.js +69 -0
  86. package/dist/src/agent/tool-display-utils.js.map +1 -0
  87. package/dist/src/agent/tool-display-utils.test.js +101 -0
  88. package/dist/src/agent/tool-display-utils.test.js.map +1 -0
  89. package/dist/src/agent/types.d.ts +25 -5
  90. package/dist/src/agents/a2aUtils.js +28 -15
  91. package/dist/src/agents/a2aUtils.js.map +1 -1
  92. package/dist/src/agents/a2aUtils.test.js +43 -0
  93. package/dist/src/agents/a2aUtils.test.js.map +1 -1
  94. package/dist/src/agents/agent-tool.d.ts +31 -0
  95. package/dist/src/agents/agent-tool.js +155 -0
  96. package/dist/src/agents/agent-tool.js.map +1 -0
  97. package/dist/src/agents/agent-tool.test.js +110 -0
  98. package/dist/src/agents/agent-tool.test.js.map +1 -0
  99. package/dist/src/agents/agentLoader.d.ts +79 -4
  100. package/dist/src/agents/agentLoader.js +40 -2
  101. package/dist/src/agents/agentLoader.js.map +1 -1
  102. package/dist/src/agents/agentLoader.test.js +32 -0
  103. package/dist/src/agents/agentLoader.test.js.map +1 -1
  104. package/dist/src/agents/browser/analyzeScreenshot.js +1 -1
  105. package/dist/src/agents/browser/analyzeScreenshot.js.map +1 -1
  106. package/dist/src/agents/browser/analyzeScreenshot.test.js +19 -7
  107. package/dist/src/agents/browser/analyzeScreenshot.test.js.map +1 -1
  108. package/dist/src/agents/browser/browserAgentInvocation.d.ts +2 -2
  109. package/dist/src/agents/browser/browserAgentInvocation.js +2 -1
  110. package/dist/src/agents/browser/browserAgentInvocation.js.map +1 -1
  111. package/dist/src/agents/browser/browserAgentInvocation.test.js +61 -17
  112. package/dist/src/agents/browser/browserAgentInvocation.test.js.map +1 -1
  113. package/dist/src/agents/browser/mcpToolWrapper.js +1 -1
  114. package/dist/src/agents/browser/mcpToolWrapper.js.map +1 -1
  115. package/dist/src/agents/browser/mcpToolWrapper.test.js +22 -10
  116. package/dist/src/agents/browser/mcpToolWrapper.test.js.map +1 -1
  117. package/dist/src/agents/codebase-investigator.js +2 -2
  118. package/dist/src/agents/codebase-investigator.js.map +1 -1
  119. package/dist/src/agents/generalist-agent.js +3 -2
  120. package/dist/src/agents/generalist-agent.js.map +1 -1
  121. package/dist/src/agents/generalist-agent.test.js +1 -0
  122. package/dist/src/agents/generalist-agent.test.js.map +1 -1
  123. package/dist/src/agents/local-executor.d.ts +1 -1
  124. package/dist/src/agents/local-executor.js +10 -7
  125. package/dist/src/agents/local-executor.js.map +1 -1
  126. package/dist/src/agents/local-executor.test.js +5 -3
  127. package/dist/src/agents/local-executor.test.js.map +1 -1
  128. package/dist/src/agents/local-invocation.d.ts +2 -2
  129. package/dist/src/agents/local-invocation.js +8 -2
  130. package/dist/src/agents/local-invocation.js.map +1 -1
  131. package/dist/src/agents/local-invocation.test.js +29 -13
  132. package/dist/src/agents/local-invocation.test.js.map +1 -1
  133. package/dist/src/agents/registry.d.ts +2 -0
  134. package/dist/src/agents/registry.js +20 -19
  135. package/dist/src/agents/registry.js.map +1 -1
  136. package/dist/src/agents/registry.test.js +19 -30
  137. package/dist/src/agents/registry.test.js.map +1 -1
  138. package/dist/src/agents/remote-invocation.d.ts +3 -4
  139. package/dist/src/agents/remote-invocation.js +2 -1
  140. package/dist/src/agents/remote-invocation.js.map +1 -1
  141. package/dist/src/agents/remote-invocation.test.js +45 -18
  142. package/dist/src/agents/remote-invocation.test.js.map +1 -1
  143. package/dist/src/agents/skill-extraction-agent.d.ts +3 -2
  144. package/dist/src/agents/skill-extraction-agent.js +99 -56
  145. package/dist/src/agents/skill-extraction-agent.js.map +1 -1
  146. package/dist/src/agents/skill-extraction-agent.test.js +54 -0
  147. package/dist/src/agents/skill-extraction-agent.test.js.map +1 -0
  148. package/dist/src/availability/policyCatalog.js +1 -1
  149. package/dist/src/availability/policyCatalog.js.map +1 -1
  150. package/dist/src/availability/policyCatalog.test.js +1 -1
  151. package/dist/src/availability/policyCatalog.test.js.map +1 -1
  152. package/dist/src/code_assist/oauth2.js +14 -4
  153. package/dist/src/code_assist/oauth2.js.map +1 -1
  154. package/dist/src/commands/memory.d.ts +77 -0
  155. package/dist/src/commands/memory.js +494 -0
  156. package/dist/src/commands/memory.js.map +1 -1
  157. package/dist/src/commands/memory.test.js +720 -1
  158. package/dist/src/commands/memory.test.js.map +1 -1
  159. package/dist/src/config/config-agents-reload.test.js +26 -31
  160. package/dist/src/config/config-agents-reload.test.js.map +1 -1
  161. package/dist/src/config/config.d.ts +24 -10
  162. package/dist/src/config/config.js +148 -82
  163. package/dist/src/config/config.js.map +1 -1
  164. package/dist/src/config/config.test.js +373 -10
  165. package/dist/src/config/config.test.js.map +1 -1
  166. package/dist/src/config/constants.d.ts +1 -0
  167. package/dist/src/config/constants.js +2 -0
  168. package/dist/src/config/constants.js.map +1 -1
  169. package/dist/src/config/defaultModelConfigs.js +7 -7
  170. package/dist/src/config/defaultModelConfigs.js.map +1 -1
  171. package/dist/src/config/memory.js +1 -1
  172. package/dist/src/config/memory.js.map +1 -1
  173. package/dist/src/config/path-validation.test.js +15 -6
  174. package/dist/src/config/path-validation.test.js.map +1 -1
  175. package/dist/src/config/projectRegistry.js +113 -32
  176. package/dist/src/config/projectRegistry.js.map +1 -1
  177. package/dist/src/config/projectRegistry.test.js +51 -0
  178. package/dist/src/config/projectRegistry.test.js.map +1 -1
  179. package/dist/src/config/storage.d.ts +5 -1
  180. package/dist/src/config/storage.js +14 -1
  181. package/dist/src/config/storage.js.map +1 -1
  182. package/dist/src/config/storage.test.js +12 -0
  183. package/dist/src/config/storage.test.js.map +1 -1
  184. package/dist/src/confirmation-bus/message-bus.d.ts +4 -1
  185. package/dist/src/confirmation-bus/message-bus.js +39 -1
  186. package/dist/src/confirmation-bus/message-bus.js.map +1 -1
  187. package/dist/src/confirmation-bus/message-bus.test.js +43 -0
  188. package/dist/src/confirmation-bus/message-bus.test.js.map +1 -1
  189. package/dist/src/context/config/configLoader.d.ts +13 -0
  190. package/dist/src/context/config/configLoader.js +65 -0
  191. package/dist/src/context/config/configLoader.js.map +1 -0
  192. package/dist/src/context/config/configLoader.test.d.ts +6 -0
  193. package/dist/src/context/config/configLoader.test.js +79 -0
  194. package/dist/src/context/config/configLoader.test.js.map +1 -0
  195. package/dist/src/context/config/profiles.d.ts +17 -0
  196. package/dist/src/context/config/profiles.js +93 -0
  197. package/dist/src/context/config/profiles.js.map +1 -0
  198. package/dist/src/context/config/registry.d.ts +21 -0
  199. package/dist/src/context/config/registry.js +32 -0
  200. package/dist/src/context/config/registry.js.map +1 -0
  201. package/dist/src/context/config/schema.d.ts +45 -0
  202. package/dist/src/context/config/schema.js +47 -0
  203. package/dist/src/context/config/schema.js.map +1 -0
  204. package/dist/src/context/config/types.d.ts +39 -0
  205. package/dist/src/context/config/types.js +7 -0
  206. package/dist/src/context/config/types.js.map +1 -0
  207. package/dist/src/context/contextManager.barrier.test.d.ts +6 -0
  208. package/dist/src/context/contextManager.barrier.test.js +56 -0
  209. package/dist/src/context/contextManager.barrier.test.js.map +1 -0
  210. package/dist/src/context/contextManager.d.ts +49 -0
  211. package/dist/src/context/contextManager.js +120 -0
  212. package/dist/src/context/contextManager.js.map +1 -0
  213. package/dist/src/context/eventBus.d.ts +28 -0
  214. package/dist/src/context/eventBus.js +27 -0
  215. package/dist/src/context/eventBus.js.map +1 -0
  216. package/dist/src/context/graph/behaviorRegistry.d.ts +28 -0
  217. package/dist/src/context/graph/behaviorRegistry.js +14 -0
  218. package/dist/src/context/graph/behaviorRegistry.js.map +1 -0
  219. package/dist/src/context/graph/builtinBehaviors.d.ts +11 -0
  220. package/dist/src/context/graph/builtinBehaviors.js +145 -0
  221. package/dist/src/context/graph/builtinBehaviors.js.map +1 -0
  222. package/dist/src/context/graph/fromGraph.d.ts +9 -0
  223. package/dist/src/context/graph/fromGraph.js +34 -0
  224. package/dist/src/context/graph/fromGraph.js.map +1 -0
  225. package/dist/src/context/graph/mapper.d.ts +16 -0
  226. package/dist/src/context/graph/mapper.js +16 -0
  227. package/dist/src/context/graph/mapper.js.map +1 -0
  228. package/dist/src/context/graph/render.d.ts +15 -0
  229. package/dist/src/context/graph/render.js +72 -0
  230. package/dist/src/context/graph/render.js.map +1 -0
  231. package/dist/src/context/graph/toGraph.d.ts +10 -0
  232. package/dist/src/context/graph/toGraph.js +172 -0
  233. package/dist/src/context/graph/toGraph.js.map +1 -0
  234. package/dist/src/context/graph/types.d.ts +139 -0
  235. package/dist/src/context/graph/types.js +36 -0
  236. package/dist/src/context/graph/types.js.map +1 -0
  237. package/dist/src/context/historyObserver.d.ts +27 -0
  238. package/dist/src/context/historyObserver.js +64 -0
  239. package/dist/src/context/historyObserver.js.map +1 -0
  240. package/dist/src/context/pipeline/contextWorkingBuffer.d.ts +33 -0
  241. package/dist/src/context/pipeline/contextWorkingBuffer.js +197 -0
  242. package/dist/src/context/pipeline/contextWorkingBuffer.js.map +1 -0
  243. package/dist/src/context/pipeline/contextWorkingBuffer.test.d.ts +6 -0
  244. package/dist/src/context/pipeline/contextWorkingBuffer.test.js +89 -0
  245. package/dist/src/context/pipeline/contextWorkingBuffer.test.js.map +1 -0
  246. package/dist/src/context/pipeline/environment.d.ts +27 -0
  247. package/dist/src/context/pipeline/environment.js +2 -0
  248. package/dist/src/context/pipeline/environment.js.map +1 -0
  249. package/dist/src/context/pipeline/environmentImpl.d.ts +28 -0
  250. package/dist/src/context/pipeline/environmentImpl.js +40 -0
  251. package/dist/src/context/pipeline/environmentImpl.js.map +1 -0
  252. package/dist/src/context/pipeline/environmentImpl.test.d.ts +1 -0
  253. package/dist/src/context/pipeline/environmentImpl.test.js +32 -0
  254. package/dist/src/context/pipeline/environmentImpl.test.js.map +1 -0
  255. package/dist/src/context/pipeline/inbox.d.ts +15 -0
  256. package/dist/src/context/pipeline/inbox.js +52 -0
  257. package/dist/src/context/pipeline/inbox.js.map +1 -0
  258. package/dist/src/context/pipeline/inbox.test.d.ts +1 -0
  259. package/dist/src/context/pipeline/inbox.test.js +36 -0
  260. package/dist/src/context/pipeline/inbox.test.js.map +1 -0
  261. package/dist/src/context/pipeline/orchestrator.d.ts +22 -0
  262. package/dist/src/context/pipeline/orchestrator.js +126 -0
  263. package/dist/src/context/pipeline/orchestrator.js.map +1 -0
  264. package/dist/src/context/pipeline/orchestrator.test.d.ts +6 -0
  265. package/dist/src/context/pipeline/orchestrator.test.js +154 -0
  266. package/dist/src/context/pipeline/orchestrator.test.js.map +1 -0
  267. package/dist/src/context/pipeline.d.ts +52 -0
  268. package/dist/src/context/pipeline.js +7 -0
  269. package/dist/src/context/pipeline.js.map +1 -0
  270. package/dist/src/context/processors/blobDegradationProcessor.d.ts +6 -0
  271. package/dist/src/context/processors/blobDegradationProcessor.js +127 -0
  272. package/dist/src/context/processors/blobDegradationProcessor.js.map +1 -0
  273. package/dist/src/context/processors/blobDegradationProcessor.test.d.ts +6 -0
  274. package/dist/src/context/processors/blobDegradationProcessor.test.js +72 -0
  275. package/dist/src/context/processors/blobDegradationProcessor.test.js.map +1 -0
  276. package/dist/src/context/processors/historyTruncationProcessor.d.ts +11 -0
  277. package/dist/src/context/processors/historyTruncationProcessor.js +61 -0
  278. package/dist/src/context/processors/historyTruncationProcessor.js.map +1 -0
  279. package/dist/src/context/processors/nodeDistillationProcessor.d.ts +8 -0
  280. package/dist/src/context/processors/nodeDistillationProcessor.js +167 -0
  281. package/dist/src/context/processors/nodeDistillationProcessor.js.map +1 -0
  282. package/dist/src/context/processors/nodeDistillationProcessor.test.d.ts +6 -0
  283. package/dist/src/context/processors/nodeDistillationProcessor.test.js +77 -0
  284. package/dist/src/context/processors/nodeDistillationProcessor.test.js.map +1 -0
  285. package/dist/src/context/processors/nodeTruncationProcessor.d.ts +8 -0
  286. package/dist/src/context/processors/nodeTruncationProcessor.js +109 -0
  287. package/dist/src/context/processors/nodeTruncationProcessor.js.map +1 -0
  288. package/dist/src/context/processors/nodeTruncationProcessor.test.d.ts +6 -0
  289. package/dist/src/context/processors/nodeTruncationProcessor.test.js +71 -0
  290. package/dist/src/context/processors/nodeTruncationProcessor.test.js.map +1 -0
  291. package/dist/src/context/processors/rollingSummaryProcessor.d.ts +8 -0
  292. package/dist/src/context/processors/rollingSummaryProcessor.js +129 -0
  293. package/dist/src/context/processors/rollingSummaryProcessor.js.map +1 -0
  294. package/dist/src/context/processors/rollingSummaryProcessor.test.d.ts +1 -0
  295. package/dist/src/context/processors/rollingSummaryProcessor.test.js +60 -0
  296. package/dist/src/context/processors/rollingSummaryProcessor.test.js.map +1 -0
  297. package/dist/src/context/processors/stateSnapshotAsyncProcessor.d.ts +9 -0
  298. package/dist/src/context/processors/stateSnapshotAsyncProcessor.js +75 -0
  299. package/dist/src/context/processors/stateSnapshotAsyncProcessor.js.map +1 -0
  300. package/dist/src/context/processors/stateSnapshotAsyncProcessor.test.d.ts +1 -0
  301. package/dist/src/context/processors/stateSnapshotAsyncProcessor.test.js +80 -0
  302. package/dist/src/context/processors/stateSnapshotAsyncProcessor.test.js.map +1 -0
  303. package/dist/src/context/processors/stateSnapshotProcessor.d.ts +9 -0
  304. package/dist/src/context/processors/stateSnapshotProcessor.js +130 -0
  305. package/dist/src/context/processors/stateSnapshotProcessor.js.map +1 -0
  306. package/dist/src/context/processors/stateSnapshotProcessor.test.d.ts +1 -0
  307. package/dist/src/context/processors/stateSnapshotProcessor.test.js +91 -0
  308. package/dist/src/context/processors/stateSnapshotProcessor.test.js.map +1 -0
  309. package/dist/src/context/processors/toolMaskingProcessor.d.ts +8 -0
  310. package/dist/src/context/processors/toolMaskingProcessor.js +194 -0
  311. package/dist/src/context/processors/toolMaskingProcessor.js.map +1 -0
  312. package/dist/src/context/processors/toolMaskingProcessor.test.d.ts +1 -0
  313. package/dist/src/context/processors/toolMaskingProcessor.test.js +50 -0
  314. package/dist/src/context/processors/toolMaskingProcessor.test.js.map +1 -0
  315. package/dist/src/context/system-tests/lifecycle.golden.test.d.ts +6 -0
  316. package/dist/src/context/system-tests/lifecycle.golden.test.js +195 -0
  317. package/dist/src/context/system-tests/lifecycle.golden.test.js.map +1 -0
  318. package/dist/src/context/system-tests/simulationHarness.d.ts +41 -0
  319. package/dist/src/context/system-tests/simulationHarness.js +88 -0
  320. package/dist/src/context/system-tests/simulationHarness.js.map +1 -0
  321. package/dist/src/context/testing/contextTestUtils.d.ts +44 -0
  322. package/dist/src/context/testing/contextTestUtils.js +176 -0
  323. package/dist/src/context/testing/contextTestUtils.js.map +1 -0
  324. package/dist/src/context/testing/testProfile.d.ts +7 -0
  325. package/dist/src/context/testing/testProfile.js +20 -0
  326. package/dist/src/context/testing/testProfile.js.map +1 -0
  327. package/dist/src/context/tracer.d.ts +19 -0
  328. package/dist/src/context/tracer.js +79 -0
  329. package/dist/src/context/tracer.js.map +1 -0
  330. package/dist/src/context/tracer.test.d.ts +6 -0
  331. package/dist/src/context/tracer.test.js +71 -0
  332. package/dist/src/context/tracer.test.js.map +1 -0
  333. package/dist/src/context/utils/contextTokenCalculator.d.ts +53 -0
  334. package/dist/src/context/utils/contextTokenCalculator.js +97 -0
  335. package/dist/src/context/utils/contextTokenCalculator.js.map +1 -0
  336. package/dist/src/context/utils/snapshotGenerator.d.ts +12 -0
  337. package/dist/src/context/utils/snapshotGenerator.js +43 -0
  338. package/dist/src/context/utils/snapshotGenerator.js.map +1 -0
  339. package/dist/src/core/agentChatHistory.d.ts +26 -0
  340. package/dist/src/core/agentChatHistory.js +50 -0
  341. package/dist/src/core/agentChatHistory.js.map +1 -0
  342. package/dist/src/core/client.js +3 -1
  343. package/dist/src/core/client.js.map +1 -1
  344. package/dist/src/core/client.test.js +4 -0
  345. package/dist/src/core/client.test.js.map +1 -1
  346. package/dist/src/core/contentGenerator.d.ts +8 -1
  347. package/dist/src/core/contentGenerator.js +46 -4
  348. package/dist/src/core/contentGenerator.js.map +1 -1
  349. package/dist/src/core/contentGenerator.test.js +174 -8
  350. package/dist/src/core/contentGenerator.test.js.map +1 -1
  351. package/dist/src/core/coreToolHookTriggers.d.ts +1 -1
  352. package/dist/src/core/coreToolHookTriggers.js +5 -1
  353. package/dist/src/core/coreToolHookTriggers.js.map +1 -1
  354. package/dist/src/core/coreToolHookTriggers.test.js +1 -1
  355. package/dist/src/core/coreToolHookTriggers.test.js.map +1 -1
  356. package/dist/src/core/geminiChat.d.ts +2 -1
  357. package/dist/src/core/geminiChat.js +7 -2
  358. package/dist/src/core/geminiChat.js.map +1 -1
  359. package/dist/src/core/geminiChat.test.js +19 -6
  360. package/dist/src/core/geminiChat.test.js.map +1 -1
  361. package/dist/src/core/geminiChat_network_retry.test.js +42 -0
  362. package/dist/src/core/geminiChat_network_retry.test.js.map +1 -1
  363. package/dist/src/core/localLiteRtLmClient.js +2 -0
  364. package/dist/src/core/localLiteRtLmClient.js.map +1 -1
  365. package/dist/src/core/localLiteRtLmClient.test.js +7 -0
  366. package/dist/src/core/localLiteRtLmClient.test.js.map +1 -1
  367. package/dist/src/core/loggingContentGenerator.js +19 -6
  368. package/dist/src/core/loggingContentGenerator.js.map +1 -1
  369. package/dist/src/core/loggingContentGenerator.test.js +55 -0
  370. package/dist/src/core/loggingContentGenerator.test.js.map +1 -1
  371. package/dist/src/core/prompts-substitution.test.js +1 -0
  372. package/dist/src/core/prompts-substitution.test.js.map +1 -1
  373. package/dist/src/core/prompts.d.ts +1 -1
  374. package/dist/src/core/prompts.js +2 -2
  375. package/dist/src/core/prompts.js.map +1 -1
  376. package/dist/src/core/prompts.test.js +39 -8
  377. package/dist/src/core/prompts.test.js.map +1 -1
  378. package/dist/src/generated/git-commit.d.ts +2 -2
  379. package/dist/src/generated/git-commit.js +2 -2
  380. package/dist/src/hooks/hookRunner.js +8 -0
  381. package/dist/src/hooks/hookRunner.js.map +1 -1
  382. package/dist/src/hooks/hookRunner.test.js +23 -0
  383. package/dist/src/hooks/hookRunner.test.js.map +1 -1
  384. package/dist/src/ide/ide-client.js +3 -4
  385. package/dist/src/ide/ide-client.js.map +1 -1
  386. package/dist/src/index.d.ts +7 -3
  387. package/dist/src/index.js +7 -2
  388. package/dist/src/index.js.map +1 -1
  389. package/dist/src/mcp/mcpLauncher.js +1 -1
  390. package/dist/src/mcp/mcpLauncher.js.map +1 -1
  391. package/dist/src/mcp/oauth-provider.test.js +24 -17
  392. package/dist/src/mcp/oauth-provider.test.js.map +1 -1
  393. package/dist/src/policy/config.d.ts +2 -0
  394. package/dist/src/policy/config.js +67 -12
  395. package/dist/src/policy/config.js.map +1 -1
  396. package/dist/src/policy/core-tools-mapping.test.d.ts +6 -0
  397. package/dist/src/policy/core-tools-mapping.test.js +44 -0
  398. package/dist/src/policy/core-tools-mapping.test.js.map +1 -0
  399. package/dist/src/policy/policies/agents.toml +10 -0
  400. package/dist/src/policy/policies/plan.toml +17 -43
  401. package/dist/src/policy/policies/read-only.toml +24 -38
  402. package/dist/src/policy/policy-engine.d.ts +1 -1
  403. package/dist/src/policy/policy-engine.js +72 -67
  404. package/dist/src/policy/policy-engine.js.map +1 -1
  405. package/dist/src/policy/policy-engine.test.js +71 -4
  406. package/dist/src/policy/policy-engine.test.js.map +1 -1
  407. package/dist/src/policy/sandboxPolicyManager.js +4 -4
  408. package/dist/src/policy/sandboxPolicyManager.js.map +1 -1
  409. package/dist/src/policy/shell-safety-regression.test.d.ts +6 -0
  410. package/dist/src/policy/shell-safety-regression.test.js +86 -0
  411. package/dist/src/policy/shell-safety-regression.test.js.map +1 -0
  412. package/dist/src/policy/shell-safety.test.js +24 -0
  413. package/dist/src/policy/shell-safety.test.js.map +1 -1
  414. package/dist/src/policy/shell-substitution.test.d.ts +6 -0
  415. package/dist/src/policy/shell-substitution.test.js +75 -0
  416. package/dist/src/policy/shell-substitution.test.js.map +1 -0
  417. package/dist/src/policy/toml-loader.test.js +25 -11
  418. package/dist/src/policy/toml-loader.test.js.map +1 -1
  419. package/dist/src/policy/types.d.ts +6 -2
  420. package/dist/src/policy/types.js +4 -2
  421. package/dist/src/policy/types.js.map +1 -1
  422. package/dist/src/prompts/promptProvider.d.ts +1 -1
  423. package/dist/src/prompts/promptProvider.js +41 -24
  424. package/dist/src/prompts/promptProvider.js.map +1 -1
  425. package/dist/src/prompts/promptProvider.test.js +36 -2
  426. package/dist/src/prompts/promptProvider.test.js.map +1 -1
  427. package/dist/src/prompts/snippets-memory-v2.test.d.ts +6 -0
  428. package/dist/src/prompts/snippets-memory-v2.test.js +94 -0
  429. package/dist/src/prompts/snippets-memory-v2.test.js.map +1 -0
  430. package/dist/src/prompts/snippets.d.ts +19 -1
  431. package/dist/src/prompts/snippets.js +33 -6
  432. package/dist/src/prompts/snippets.js.map +1 -1
  433. package/dist/src/prompts/snippets.legacy.d.ts +6 -1
  434. package/dist/src/prompts/snippets.legacy.js +14 -7
  435. package/dist/src/prompts/snippets.legacy.js.map +1 -1
  436. package/dist/src/prompts/utils.test.js +1 -0
  437. package/dist/src/prompts/utils.test.js.map +1 -1
  438. package/dist/src/routing/modelRouterService.js +1 -1
  439. package/dist/src/routing/modelRouterService.js.map +1 -1
  440. package/dist/src/sandbox/linux/LinuxSandboxManager.d.ts +2 -0
  441. package/dist/src/sandbox/linux/LinuxSandboxManager.js +43 -19
  442. package/dist/src/sandbox/linux/LinuxSandboxManager.js.map +1 -1
  443. package/dist/src/sandbox/linux/LinuxSandboxManager.test.js +16 -0
  444. package/dist/src/sandbox/linux/LinuxSandboxManager.test.js.map +1 -1
  445. package/dist/src/sandbox/linux/bwrapArgsBuilder.d.ts +3 -7
  446. package/dist/src/sandbox/linux/bwrapArgsBuilder.js +96 -105
  447. package/dist/src/sandbox/linux/bwrapArgsBuilder.js.map +1 -1
  448. package/dist/src/sandbox/linux/bwrapArgsBuilder.test.js +144 -41
  449. package/dist/src/sandbox/linux/bwrapArgsBuilder.test.js.map +1 -1
  450. package/dist/src/sandbox/macos/MacOsSandboxManager.js +19 -10
  451. package/dist/src/sandbox/macos/MacOsSandboxManager.js.map +1 -1
  452. package/dist/src/sandbox/macos/MacOsSandboxManager.test.js +24 -37
  453. package/dist/src/sandbox/macos/MacOsSandboxManager.test.js.map +1 -1
  454. package/dist/src/sandbox/macos/seatbeltArgsBuilder.d.ts +3 -9
  455. package/dist/src/sandbox/macos/seatbeltArgsBuilder.js +129 -96
  456. package/dist/src/sandbox/macos/seatbeltArgsBuilder.js.map +1 -1
  457. package/dist/src/sandbox/macos/seatbeltArgsBuilder.test.js +78 -77
  458. package/dist/src/sandbox/macos/seatbeltArgsBuilder.test.js.map +1 -1
  459. package/dist/src/sandbox/utils/fsUtils.d.ts +2 -3
  460. package/dist/src/sandbox/utils/fsUtils.js +12 -27
  461. package/dist/src/sandbox/utils/fsUtils.js.map +1 -1
  462. package/dist/src/sandbox/utils/fsUtils.test.js +87 -29
  463. package/dist/src/sandbox/utils/fsUtils.test.js.map +1 -1
  464. package/dist/src/sandbox/windows/GeminiSandbox.cs +186 -77
  465. package/dist/src/sandbox/windows/WindowsSandboxManager.d.ts +4 -16
  466. package/dist/src/sandbox/windows/WindowsSandboxManager.js +138 -204
  467. package/dist/src/sandbox/windows/WindowsSandboxManager.js.map +1 -1
  468. package/dist/src/sandbox/windows/WindowsSandboxManager.test.js +105 -122
  469. package/dist/src/sandbox/windows/WindowsSandboxManager.test.js.map +1 -1
  470. package/dist/src/scheduler/policy.js +1 -2
  471. package/dist/src/scheduler/policy.js.map +1 -1
  472. package/dist/src/scheduler/policy.test.js +58 -2
  473. package/dist/src/scheduler/policy.test.js.map +1 -1
  474. package/dist/src/scheduler/scheduler.d.ts +2 -1
  475. package/dist/src/scheduler/scheduler.js +13 -14
  476. package/dist/src/scheduler/scheduler.js.map +1 -1
  477. package/dist/src/scheduler/scheduler.test.js +66 -0
  478. package/dist/src/scheduler/scheduler.test.js.map +1 -1
  479. package/dist/src/scheduler/scheduler_hooks.test.js +1 -0
  480. package/dist/src/scheduler/scheduler_hooks.test.js.map +1 -1
  481. package/dist/src/scheduler/scheduler_parallel.test.js +2 -0
  482. package/dist/src/scheduler/scheduler_parallel.test.js.map +1 -1
  483. package/dist/src/scheduler/tool-executor.js +2 -0
  484. package/dist/src/scheduler/tool-executor.js.map +1 -1
  485. package/dist/src/services/chatRecordingService.d.ts +12 -153
  486. package/dist/src/services/chatRecordingService.js +444 -350
  487. package/dist/src/services/chatRecordingService.js.map +1 -1
  488. package/dist/src/services/chatRecordingService.test.js +174 -128
  489. package/dist/src/services/chatRecordingService.test.js.map +1 -1
  490. package/dist/src/services/chatRecordingTypes.d.ts +111 -0
  491. package/dist/src/services/chatRecordingTypes.js +10 -0
  492. package/dist/src/services/chatRecordingTypes.js.map +1 -0
  493. package/dist/src/services/gitService.d.ts +2 -0
  494. package/dist/src/services/gitService.js +10 -1
  495. package/dist/src/services/gitService.js.map +1 -1
  496. package/dist/src/services/gitService.test.js +6 -2
  497. package/dist/src/services/gitService.test.js.map +1 -1
  498. package/dist/src/services/keychainService.d.ts +2 -2
  499. package/dist/src/services/keychainService.js +9 -9
  500. package/dist/src/services/keychainService.js.map +1 -1
  501. package/dist/src/services/keychainService.test.js +7 -7
  502. package/dist/src/services/keychainService.test.js.map +1 -1
  503. package/dist/src/services/keychainTypes.d.ts +1 -1
  504. package/dist/src/services/memoryPatchUtils.d.ts +42 -0
  505. package/dist/src/services/memoryPatchUtils.js +216 -0
  506. package/dist/src/services/memoryPatchUtils.js.map +1 -0
  507. package/dist/src/services/memoryService.d.ts +21 -1
  508. package/dist/src/services/memoryService.js +405 -64
  509. package/dist/src/services/memoryService.js.map +1 -1
  510. package/dist/src/services/memoryService.test.js +686 -2
  511. package/dist/src/services/memoryService.test.js.map +1 -1
  512. package/dist/src/services/sandboxManager.d.ts +33 -19
  513. package/dist/src/services/sandboxManager.integration.test.js +728 -266
  514. package/dist/src/services/sandboxManager.integration.test.js.map +1 -1
  515. package/dist/src/services/sandboxManager.js +65 -62
  516. package/dist/src/services/sandboxManager.js.map +1 -1
  517. package/dist/src/services/sandboxManager.test.js +17 -114
  518. package/dist/src/services/sandboxManager.test.js.map +1 -1
  519. package/dist/src/services/sandboxedFileSystemService.js +72 -62
  520. package/dist/src/services/sandboxedFileSystemService.js.map +1 -1
  521. package/dist/src/services/sessionSummaryUtils.d.ts +1 -1
  522. package/dist/src/services/sessionSummaryUtils.js +111 -38
  523. package/dist/src/services/sessionSummaryUtils.js.map +1 -1
  524. package/dist/src/services/sessionSummaryUtils.test.js +204 -51
  525. package/dist/src/services/sessionSummaryUtils.test.js.map +1 -1
  526. package/dist/src/services/shellExecutionService.d.ts +19 -0
  527. package/dist/src/services/shellExecutionService.js +88 -34
  528. package/dist/src/services/shellExecutionService.js.map +1 -1
  529. package/dist/src/services/shellExecutionService.test.js +38 -4
  530. package/dist/src/services/shellExecutionService.test.js.map +1 -1
  531. package/dist/src/telemetry/activity-monitor.js +1 -0
  532. package/dist/src/telemetry/activity-monitor.js.map +1 -1
  533. package/dist/src/telemetry/config.js +3 -0
  534. package/dist/src/telemetry/config.js.map +1 -1
  535. package/dist/src/telemetry/conseca-logger.js +18 -20
  536. package/dist/src/telemetry/conseca-logger.js.map +1 -1
  537. package/dist/src/telemetry/conseca-logger.test.js +100 -0
  538. package/dist/src/telemetry/conseca-logger.test.js.map +1 -1
  539. package/dist/src/telemetry/event-loop-monitor.d.ts +17 -0
  540. package/dist/src/telemetry/event-loop-monitor.js +76 -0
  541. package/dist/src/telemetry/event-loop-monitor.js.map +1 -0
  542. package/dist/src/telemetry/index.d.ts +2 -1
  543. package/dist/src/telemetry/index.js +2 -1
  544. package/dist/src/telemetry/index.js.map +1 -1
  545. package/dist/src/telemetry/llmRole.d.ts +2 -1
  546. package/dist/src/telemetry/llmRole.js +1 -0
  547. package/dist/src/telemetry/llmRole.js.map +1 -1
  548. package/dist/src/telemetry/loggers.test.js +184 -8
  549. package/dist/src/telemetry/loggers.test.js.map +1 -1
  550. package/dist/src/telemetry/memory-monitor.d.ts +1 -0
  551. package/dist/src/telemetry/memory-monitor.js +8 -1
  552. package/dist/src/telemetry/memory-monitor.js.map +1 -1
  553. package/dist/src/telemetry/memory-monitor.test.js +6 -1
  554. package/dist/src/telemetry/memory-monitor.test.js.map +1 -1
  555. package/dist/src/telemetry/metrics.d.ts +12 -0
  556. package/dist/src/telemetry/metrics.js +19 -0
  557. package/dist/src/telemetry/metrics.js.map +1 -1
  558. package/dist/src/telemetry/sdk.js +20 -1
  559. package/dist/src/telemetry/sdk.js.map +1 -1
  560. package/dist/src/telemetry/trace.d.ts +23 -6
  561. package/dist/src/telemetry/trace.js +71 -22
  562. package/dist/src/telemetry/trace.js.map +1 -1
  563. package/dist/src/telemetry/trace.test.js +79 -15
  564. package/dist/src/telemetry/trace.test.js.map +1 -1
  565. package/dist/src/telemetry/types.js +61 -15
  566. package/dist/src/telemetry/types.js.map +1 -1
  567. package/dist/src/test-utils/mock-tool.d.ts +3 -2
  568. package/dist/src/test-utils/mock-tool.js +4 -3
  569. package/dist/src/test-utils/mock-tool.js.map +1 -1
  570. package/dist/src/tools/activate-skill.js +1 -1
  571. package/dist/src/tools/activate-skill.js.map +1 -1
  572. package/dist/src/tools/activate-skill.test.js +6 -2
  573. package/dist/src/tools/activate-skill.test.js.map +1 -1
  574. package/dist/src/tools/ask-user.d.ts +2 -2
  575. package/dist/src/tools/ask-user.js +1 -1
  576. package/dist/src/tools/ask-user.js.map +1 -1
  577. package/dist/src/tools/ask-user.test.js +9 -3
  578. package/dist/src/tools/ask-user.test.js.map +1 -1
  579. package/dist/src/tools/complete-task.d.ts +2 -2
  580. package/dist/src/tools/complete-task.js +1 -1
  581. package/dist/src/tools/complete-task.js.map +1 -1
  582. package/dist/src/tools/complete-task.test.js +9 -3
  583. package/dist/src/tools/complete-task.test.js.map +1 -1
  584. package/dist/src/tools/definitions/base-declarations.d.ts +2 -0
  585. package/dist/src/tools/definitions/base-declarations.js +3 -0
  586. package/dist/src/tools/definitions/base-declarations.js.map +1 -1
  587. package/dist/src/tools/definitions/coreTools.d.ts +3 -1
  588. package/dist/src/tools/definitions/coreTools.js +13 -1
  589. package/dist/src/tools/definitions/coreTools.js.map +1 -1
  590. package/dist/src/tools/definitions/model-family-sets/default-legacy.js +29 -1
  591. package/dist/src/tools/definitions/model-family-sets/default-legacy.js.map +1 -1
  592. package/dist/src/tools/definitions/model-family-sets/gemini-3.js +29 -1
  593. package/dist/src/tools/definitions/model-family-sets/gemini-3.js.map +1 -1
  594. package/dist/src/tools/definitions/types.d.ts +2 -0
  595. package/dist/src/tools/edit.js +20 -4
  596. package/dist/src/tools/edit.js.map +1 -1
  597. package/dist/src/tools/edit.test.js +41 -18
  598. package/dist/src/tools/edit.test.js.map +1 -1
  599. package/dist/src/tools/enter-plan-mode.d.ts +2 -2
  600. package/dist/src/tools/enter-plan-mode.js +1 -1
  601. package/dist/src/tools/enter-plan-mode.js.map +1 -1
  602. package/dist/src/tools/enter-plan-mode.test.js +10 -4
  603. package/dist/src/tools/enter-plan-mode.test.js.map +1 -1
  604. package/dist/src/tools/exit-plan-mode.d.ts +2 -2
  605. package/dist/src/tools/exit-plan-mode.js +9 -12
  606. package/dist/src/tools/exit-plan-mode.js.map +1 -1
  607. package/dist/src/tools/exit-plan-mode.test.js +44 -17
  608. package/dist/src/tools/exit-plan-mode.test.js.map +1 -1
  609. package/dist/src/tools/get-internal-docs.js +6 -3
  610. package/dist/src/tools/get-internal-docs.js.map +1 -1
  611. package/dist/src/tools/get-internal-docs.test.js +4 -4
  612. package/dist/src/tools/get-internal-docs.test.js.map +1 -1
  613. package/dist/src/tools/glob.js +1 -1
  614. package/dist/src/tools/glob.js.map +1 -1
  615. package/dist/src/tools/glob.test.js +16 -16
  616. package/dist/src/tools/glob.test.js.map +1 -1
  617. package/dist/src/tools/grep.js +21 -12
  618. package/dist/src/tools/grep.js.map +1 -1
  619. package/dist/src/tools/grep.test.js +18 -18
  620. package/dist/src/tools/grep.test.js.map +1 -1
  621. package/dist/src/tools/line-endings.test.js +3 -3
  622. package/dist/src/tools/line-endings.test.js.map +1 -1
  623. package/dist/src/tools/list-mcp-resources.d.ts +24 -0
  624. package/dist/src/tools/list-mcp-resources.js +74 -0
  625. package/dist/src/tools/list-mcp-resources.js.map +1 -0
  626. package/dist/src/tools/list-mcp-resources.test.d.ts +6 -0
  627. package/dist/src/tools/list-mcp-resources.test.js +79 -0
  628. package/dist/src/tools/list-mcp-resources.test.js.map +1 -0
  629. package/dist/src/tools/ls.js +2 -2
  630. package/dist/src/tools/ls.js.map +1 -1
  631. package/dist/src/tools/ls.test.js +21 -21
  632. package/dist/src/tools/ls.test.js.map +1 -1
  633. package/dist/src/tools/mcp-client-manager.d.ts +3 -1
  634. package/dist/src/tools/mcp-client-manager.js +24 -1
  635. package/dist/src/tools/mcp-client-manager.js.map +1 -1
  636. package/dist/src/tools/mcp-client-manager.test.js +43 -0
  637. package/dist/src/tools/mcp-client-manager.test.js.map +1 -1
  638. package/dist/src/tools/mcp-client.js +10 -12
  639. package/dist/src/tools/mcp-client.js.map +1 -1
  640. package/dist/src/tools/mcp-client.test.js +14 -2
  641. package/dist/src/tools/mcp-client.test.js.map +1 -1
  642. package/dist/src/tools/mcp-tool.d.ts +2 -2
  643. package/dist/src/tools/mcp-tool.js +1 -1
  644. package/dist/src/tools/mcp-tool.js.map +1 -1
  645. package/dist/src/tools/mcp-tool.test.js +51 -21
  646. package/dist/src/tools/mcp-tool.test.js.map +1 -1
  647. package/dist/src/tools/memoryTool.d.ts +4 -3
  648. package/dist/src/tools/memoryTool.js +43 -14
  649. package/dist/src/tools/memoryTool.js.map +1 -1
  650. package/dist/src/tools/memoryTool.test.js +29 -9
  651. package/dist/src/tools/memoryTool.test.js.map +1 -1
  652. package/dist/src/tools/read-file.js +1 -1
  653. package/dist/src/tools/read-file.js.map +1 -1
  654. package/dist/src/tools/read-file.test.js +17 -17
  655. package/dist/src/tools/read-file.test.js.map +1 -1
  656. package/dist/src/tools/read-many-files.js +4 -4
  657. package/dist/src/tools/read-many-files.js.map +1 -1
  658. package/dist/src/tools/read-many-files.test.js +70 -24
  659. package/dist/src/tools/read-many-files.test.js.map +1 -1
  660. package/dist/src/tools/read-mcp-resource.d.ts +25 -0
  661. package/dist/src/tools/read-mcp-resource.js +120 -0
  662. package/dist/src/tools/read-mcp-resource.js.map +1 -0
  663. package/dist/src/tools/read-mcp-resource.test.d.ts +6 -0
  664. package/dist/src/tools/read-mcp-resource.test.js +110 -0
  665. package/dist/src/tools/read-mcp-resource.test.js.map +1 -0
  666. package/dist/src/tools/ripGrep.d.ts +3 -2
  667. package/dist/src/tools/ripGrep.js +26 -55
  668. package/dist/src/tools/ripGrep.js.map +1 -1
  669. package/dist/src/tools/ripGrep.test.js +113 -167
  670. package/dist/src/tools/ripGrep.test.js.map +1 -1
  671. package/dist/src/tools/shell.d.ts +2 -2
  672. package/dist/src/tools/shell.js +51 -21
  673. package/dist/src/tools/shell.js.map +1 -1
  674. package/dist/src/tools/shell.test.js +479 -76
  675. package/dist/src/tools/shell.test.js.map +1 -1
  676. package/dist/src/tools/shellBackgroundTools.d.ts +3 -3
  677. package/dist/src/tools/shellBackgroundTools.integration.test.js +6 -2
  678. package/dist/src/tools/shellBackgroundTools.integration.test.js.map +1 -1
  679. package/dist/src/tools/shellBackgroundTools.js +2 -2
  680. package/dist/src/tools/shellBackgroundTools.js.map +1 -1
  681. package/dist/src/tools/shellBackgroundTools.test.js +30 -10
  682. package/dist/src/tools/shellBackgroundTools.test.js.map +1 -1
  683. package/dist/src/tools/tool-error.d.ts +1 -0
  684. package/dist/src/tools/tool-error.js +1 -0
  685. package/dist/src/tools/tool-error.js.map +1 -1
  686. package/dist/src/tools/tool-names.d.ts +5 -4
  687. package/dist/src/tools/tool-names.js +8 -2
  688. package/dist/src/tools/tool-names.js.map +1 -1
  689. package/dist/src/tools/tool-registry.js +137 -114
  690. package/dist/src/tools/tool-registry.js.map +1 -1
  691. package/dist/src/tools/tool-registry.test.js +3 -1
  692. package/dist/src/tools/tool-registry.test.js.map +1 -1
  693. package/dist/src/tools/tools.d.ts +6 -6
  694. package/dist/src/tools/tools.js +6 -2
  695. package/dist/src/tools/tools.js.map +1 -1
  696. package/dist/src/tools/topicTool.d.ts +2 -2
  697. package/dist/src/tools/topicTool.js +1 -1
  698. package/dist/src/tools/topicTool.js.map +1 -1
  699. package/dist/src/tools/topicTool.test.js +6 -2
  700. package/dist/src/tools/topicTool.test.js.map +1 -1
  701. package/dist/src/tools/trackerTools.d.ts +7 -7
  702. package/dist/src/tools/trackerTools.js +6 -6
  703. package/dist/src/tools/trackerTools.js.map +1 -1
  704. package/dist/src/tools/web-fetch.js +1 -1
  705. package/dist/src/tools/web-fetch.js.map +1 -1
  706. package/dist/src/tools/web-fetch.test.js +59 -23
  707. package/dist/src/tools/web-fetch.test.js.map +1 -1
  708. package/dist/src/tools/web-search.js +1 -1
  709. package/dist/src/tools/web-search.js.map +1 -1
  710. package/dist/src/tools/web-search.test.js +5 -5
  711. package/dist/src/tools/web-search.test.js.map +1 -1
  712. package/dist/src/tools/write-file.js +22 -4
  713. package/dist/src/tools/write-file.js.map +1 -1
  714. package/dist/src/tools/write-file.test.js +29 -11
  715. package/dist/src/tools/write-file.test.js.map +1 -1
  716. package/dist/src/tools/write-todos.js +1 -1
  717. package/dist/src/tools/write-todos.js.map +1 -1
  718. package/dist/src/utils/compatibility.js +6 -1
  719. package/dist/src/utils/compatibility.js.map +1 -1
  720. package/dist/src/utils/compatibility.test.js +23 -0
  721. package/dist/src/utils/compatibility.test.js.map +1 -1
  722. package/dist/src/utils/errors.d.ts +3 -0
  723. package/dist/src/utils/errors.js +6 -0
  724. package/dist/src/utils/errors.js.map +1 -1
  725. package/dist/src/utils/fileUtils.d.ts +1 -2
  726. package/dist/src/utils/fileUtils.js +80 -40
  727. package/dist/src/utils/fileUtils.js.map +1 -1
  728. package/dist/src/utils/fileUtils.test.js +61 -0
  729. package/dist/src/utils/fileUtils.test.js.map +1 -1
  730. package/dist/src/utils/filesearch/fileSearch.d.ts +2 -0
  731. package/dist/src/utils/filesearch/fileSearch.js +97 -6
  732. package/dist/src/utils/filesearch/fileSearch.js.map +1 -1
  733. package/dist/src/utils/filesearch/fileSearch.test.js +54 -0
  734. package/dist/src/utils/filesearch/fileSearch.test.js.map +1 -1
  735. package/dist/src/utils/filesearch/fileWatcher.d.ts +25 -0
  736. package/dist/src/utils/filesearch/fileWatcher.js +86 -0
  737. package/dist/src/utils/filesearch/fileWatcher.js.map +1 -0
  738. package/dist/src/utils/filesearch/fileWatcher.test.js +142 -0
  739. package/dist/src/utils/filesearch/fileWatcher.test.js.map +1 -0
  740. package/dist/src/utils/getFolderStructure.js +4 -2
  741. package/dist/src/utils/getFolderStructure.js.map +1 -1
  742. package/dist/src/utils/gitIgnoreParser.js +1 -1
  743. package/dist/src/utils/gitIgnoreParser.js.map +1 -1
  744. package/dist/src/utils/googleQuotaErrors.d.ts +2 -1
  745. package/dist/src/utils/googleQuotaErrors.js +30 -35
  746. package/dist/src/utils/googleQuotaErrors.js.map +1 -1
  747. package/dist/src/utils/googleQuotaErrors.test.js +24 -0
  748. package/dist/src/utils/googleQuotaErrors.test.js.map +1 -1
  749. package/dist/src/utils/ignoreFileParser.js +1 -1
  750. package/dist/src/utils/ignoreFileParser.js.map +1 -1
  751. package/dist/src/utils/memoryDiscovery.js +15 -5
  752. package/dist/src/utils/memoryDiscovery.js.map +1 -1
  753. package/dist/src/utils/oauth-flow.js +17 -5
  754. package/dist/src/utils/oauth-flow.js.map +1 -1
  755. package/dist/src/utils/oauth-flow.test.js +20 -0
  756. package/dist/src/utils/oauth-flow.test.js.map +1 -1
  757. package/dist/src/utils/paths.d.ts +9 -0
  758. package/dist/src/utils/paths.js +37 -0
  759. package/dist/src/utils/paths.js.map +1 -1
  760. package/dist/src/utils/paths.test.js +45 -1
  761. package/dist/src/utils/paths.test.js.map +1 -1
  762. package/dist/src/utils/planUtils.d.ts +11 -2
  763. package/dist/src/utils/planUtils.js +43 -11
  764. package/dist/src/utils/planUtils.js.map +1 -1
  765. package/dist/src/utils/planUtils.test.js +10 -9
  766. package/dist/src/utils/planUtils.test.js.map +1 -1
  767. package/dist/src/utils/process-utils.d.ts +2 -1
  768. package/dist/src/utils/process-utils.js +64 -33
  769. package/dist/src/utils/process-utils.js.map +1 -1
  770. package/dist/src/utils/process-utils.test.js +9 -0
  771. package/dist/src/utils/process-utils.test.js.map +1 -1
  772. package/dist/src/utils/retry.js +18 -6
  773. package/dist/src/utils/retry.js.map +1 -1
  774. package/dist/src/utils/retry.test.js +30 -0
  775. package/dist/src/utils/retry.test.js.map +1 -1
  776. package/dist/src/utils/sessionOperations.js +3 -2
  777. package/dist/src/utils/sessionOperations.js.map +1 -1
  778. package/dist/src/utils/shell-utils.d.ts +2 -0
  779. package/dist/src/utils/shell-utils.js +237 -107
  780. package/dist/src/utils/shell-utils.js.map +1 -1
  781. package/dist/src/utils/tool-utils.d.ts +1 -29
  782. package/dist/src/utils/tool-utils.js +0 -39
  783. package/dist/src/utils/tool-utils.js.map +1 -1
  784. package/dist/src/utils/tool-utils.test.js +2 -76
  785. package/dist/src/utils/tool-utils.test.js.map +1 -1
  786. package/dist/src/utils/tool-visibility.d.ts +40 -0
  787. package/dist/src/utils/tool-visibility.js +111 -0
  788. package/dist/src/utils/tool-visibility.js.map +1 -0
  789. package/dist/src/utils/tool-visibility.test.d.ts +6 -0
  790. package/dist/src/utils/tool-visibility.test.js +96 -0
  791. package/dist/src/utils/tool-visibility.test.js.map +1 -0
  792. package/dist/src/utils/trust.d.ts +64 -0
  793. package/dist/src/utils/trust.js +276 -0
  794. package/dist/src/utils/trust.js.map +1 -0
  795. package/dist/src/utils/trust.test.d.ts +6 -0
  796. package/dist/src/utils/trust.test.js +159 -0
  797. package/dist/src/utils/trust.test.js.map +1 -0
  798. package/dist/tsconfig.tsbuildinfo +1 -1
  799. package/package.json +5 -4
  800. package/dist/docs/get-started/installation.md +0 -181
  801. package/dist/src/agents/memory-manager-agent.d.ts +0 -25
  802. package/dist/src/agents/memory-manager-agent.js +0 -138
  803. package/dist/src/agents/memory-manager-agent.js.map +0 -1
  804. package/dist/src/agents/memory-manager-agent.test.js +0 -123
  805. package/dist/src/agents/memory-manager-agent.test.js.map +0 -1
  806. package/dist/src/agents/subagent-tool-wrapper.d.ts +0 -38
  807. package/dist/src/agents/subagent-tool-wrapper.js +0 -58
  808. package/dist/src/agents/subagent-tool-wrapper.js.map +0 -1
  809. package/dist/src/agents/subagent-tool-wrapper.test.js +0 -123
  810. package/dist/src/agents/subagent-tool-wrapper.test.js.map +0 -1
  811. package/dist/src/agents/subagent-tool.d.ts +0 -18
  812. package/dist/src/agents/subagent-tool.js +0 -134
  813. package/dist/src/agents/subagent-tool.js.map +0 -1
  814. package/dist/src/agents/subagent-tool.test.js +0 -287
  815. package/dist/src/agents/subagent-tool.test.js.map +0 -1
  816. package/dist/src/policy/policies/tracker.toml +0 -34
  817. package/dist/src/prompts/snippets-memory-manager.test.js +0 -31
  818. package/dist/src/prompts/snippets-memory-manager.test.js.map +0 -1
  819. /package/dist/src/{agents/memory-manager-agent.test.d.ts → agent/tool-display-utils.test.d.ts} +0 -0
  820. /package/dist/src/agents/{subagent-tool.test.d.ts → agent-tool.test.d.ts} +0 -0
  821. /package/dist/src/{prompts/snippets-memory-manager.test.d.ts → agents/skill-extraction-agent.test.d.ts} +0 -0
  822. /package/dist/src/{agents/subagent-tool-wrapper.test.d.ts → utils/filesearch/fileWatcher.test.d.ts} +0 -0
@@ -3,12 +3,21 @@
3
3
  * Copyright 2025 Google LLC
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
+ import * as fs from 'node:fs/promises';
7
+ import * as os from 'node:os';
8
+ import * as path from 'node:path';
6
9
  import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
7
- import { addMemory, listMemoryFiles, refreshMemory, showMemory, } from './memory.js';
10
+ import { Storage } from '../config/storage.js';
11
+ import { addMemory, dismissInboxSkill, listInboxSkills, listInboxPatches, applyInboxPatch, dismissInboxPatch, listMemoryFiles, moveInboxSkill, refreshMemory, showMemory, } from './memory.js';
8
12
  import * as memoryDiscovery from '../utils/memoryDiscovery.js';
9
13
  vi.mock('../utils/memoryDiscovery.js', () => ({
10
14
  refreshServerHierarchicalMemory: vi.fn(),
11
15
  }));
16
+ vi.mock('../config/storage.js', () => ({
17
+ Storage: {
18
+ getUserSkillsDir: vi.fn(),
19
+ },
20
+ }));
12
21
  const mockRefresh = vi.mocked(memoryDiscovery.refreshServerHierarchicalMemory);
13
22
  describe('memory commands', () => {
14
23
  let mockConfig;
@@ -151,5 +160,715 @@ describe('memory commands', () => {
151
160
  }
152
161
  });
153
162
  });
163
+ describe('listInboxSkills', () => {
164
+ let tmpDir;
165
+ let skillsDir;
166
+ let memoryTempDir;
167
+ let inboxConfig;
168
+ async function writeSkillMd(dirName, name, description) {
169
+ const dir = path.join(skillsDir, dirName);
170
+ await fs.mkdir(dir, { recursive: true });
171
+ await fs.writeFile(path.join(dir, 'SKILL.md'), `---\nname: ${name}\ndescription: ${description}\n---\nBody content here\n`);
172
+ }
173
+ beforeEach(async () => {
174
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'inbox-test-'));
175
+ skillsDir = path.join(tmpDir, 'skills-memory');
176
+ memoryTempDir = path.join(tmpDir, 'memory-temp');
177
+ await fs.mkdir(skillsDir, { recursive: true });
178
+ await fs.mkdir(memoryTempDir, { recursive: true });
179
+ inboxConfig = {
180
+ storage: {
181
+ getProjectSkillsMemoryDir: () => skillsDir,
182
+ getProjectMemoryTempDir: () => memoryTempDir,
183
+ getProjectSkillsDir: () => path.join(tmpDir, 'project-skills'),
184
+ },
185
+ };
186
+ });
187
+ afterEach(async () => {
188
+ await fs.rm(tmpDir, { recursive: true, force: true });
189
+ });
190
+ it('should return inbox skills with name, description, and extractedAt', async () => {
191
+ await writeSkillMd('my-skill', 'my-skill', 'A test skill');
192
+ await writeSkillMd('other-skill', 'other-skill', 'Another skill');
193
+ const stateContent = JSON.stringify({
194
+ runs: [
195
+ {
196
+ runAt: '2025-01-15T10:00:00Z',
197
+ sessionIds: ['sess-1'],
198
+ skillsCreated: ['my-skill'],
199
+ },
200
+ {
201
+ runAt: '2025-01-16T12:00:00Z',
202
+ sessionIds: ['sess-2'],
203
+ skillsCreated: ['other-skill'],
204
+ },
205
+ ],
206
+ });
207
+ await fs.writeFile(path.join(memoryTempDir, '.extraction-state.json'), stateContent);
208
+ const skills = await listInboxSkills(inboxConfig);
209
+ expect(skills).toHaveLength(2);
210
+ const mySkill = skills.find((s) => s.dirName === 'my-skill');
211
+ expect(mySkill).toBeDefined();
212
+ expect(mySkill.name).toBe('my-skill');
213
+ expect(mySkill.description).toBe('A test skill');
214
+ expect(mySkill.extractedAt).toBe('2025-01-15T10:00:00Z');
215
+ const otherSkill = skills.find((s) => s.dirName === 'other-skill');
216
+ expect(otherSkill).toBeDefined();
217
+ expect(otherSkill.name).toBe('other-skill');
218
+ expect(otherSkill.description).toBe('Another skill');
219
+ expect(otherSkill.extractedAt).toBe('2025-01-16T12:00:00Z');
220
+ });
221
+ it('should return an empty array when the inbox is empty', async () => {
222
+ const skills = await listInboxSkills(inboxConfig);
223
+ expect(skills).toEqual([]);
224
+ });
225
+ it('should return an empty array when the inbox directory does not exist', async () => {
226
+ const missingConfig = {
227
+ storage: {
228
+ getProjectSkillsMemoryDir: () => path.join(tmpDir, 'nonexistent-dir'),
229
+ getProjectMemoryTempDir: () => memoryTempDir,
230
+ },
231
+ };
232
+ const skills = await listInboxSkills(missingConfig);
233
+ expect(skills).toEqual([]);
234
+ });
235
+ });
236
+ describe('moveInboxSkill', () => {
237
+ let tmpDir;
238
+ let skillsDir;
239
+ let globalSkillsDir;
240
+ let projectSkillsDir;
241
+ let moveConfig;
242
+ async function writeSkillMd(dirName, name, description) {
243
+ const dir = path.join(skillsDir, dirName);
244
+ await fs.mkdir(dir, { recursive: true });
245
+ await fs.writeFile(path.join(dir, 'SKILL.md'), `---\nname: ${name}\ndescription: ${description}\n---\nBody content here\n`);
246
+ }
247
+ beforeEach(async () => {
248
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'move-test-'));
249
+ skillsDir = path.join(tmpDir, 'skills-memory');
250
+ globalSkillsDir = path.join(tmpDir, 'global-skills');
251
+ projectSkillsDir = path.join(tmpDir, 'project-skills');
252
+ await fs.mkdir(skillsDir, { recursive: true });
253
+ moveConfig = {
254
+ storage: {
255
+ getProjectSkillsMemoryDir: () => skillsDir,
256
+ getProjectSkillsDir: () => projectSkillsDir,
257
+ },
258
+ };
259
+ vi.mocked(Storage.getUserSkillsDir).mockReturnValue(globalSkillsDir);
260
+ });
261
+ afterEach(async () => {
262
+ await fs.rm(tmpDir, { recursive: true, force: true });
263
+ });
264
+ it('should move a skill to global skills directory', async () => {
265
+ await writeSkillMd('my-skill', 'my-skill', 'A test skill');
266
+ const result = await moveInboxSkill(moveConfig, 'my-skill', 'global');
267
+ expect(result.success).toBe(true);
268
+ expect(result.message).toBe('Moved "my-skill" to ~/.cell-cli/skills.');
269
+ // Verify the skill was copied to global
270
+ const targetSkill = await fs.readFile(path.join(globalSkillsDir, 'my-skill', 'SKILL.md'), 'utf-8');
271
+ expect(targetSkill).toContain('name: my-skill');
272
+ // Verify the skill was removed from inbox
273
+ await expect(fs.access(path.join(skillsDir, 'my-skill'))).rejects.toThrow();
274
+ });
275
+ it('should move a skill to project skills directory', async () => {
276
+ await writeSkillMd('my-skill', 'my-skill', 'A test skill');
277
+ const result = await moveInboxSkill(moveConfig, 'my-skill', 'project');
278
+ expect(result.success).toBe(true);
279
+ expect(result.message).toBe('Moved "my-skill" to .cell-cli/skills.');
280
+ // Verify the skill was copied to project
281
+ const targetSkill = await fs.readFile(path.join(projectSkillsDir, 'my-skill', 'SKILL.md'), 'utf-8');
282
+ expect(targetSkill).toContain('name: my-skill');
283
+ // Verify the skill was removed from inbox
284
+ await expect(fs.access(path.join(skillsDir, 'my-skill'))).rejects.toThrow();
285
+ });
286
+ it('should return an error when the source skill does not exist', async () => {
287
+ const result = await moveInboxSkill(moveConfig, 'nonexistent', 'global');
288
+ expect(result.success).toBe(false);
289
+ expect(result.message).toBe('Skill "nonexistent" not found in inbox.');
290
+ });
291
+ it('should reject invalid skill directory names', async () => {
292
+ const result = await moveInboxSkill(moveConfig, '../escape', 'global');
293
+ expect(result.success).toBe(false);
294
+ expect(result.message).toBe('Invalid skill name.');
295
+ });
296
+ it('should return an error when the target already exists', async () => {
297
+ await writeSkillMd('my-skill', 'my-skill', 'A test skill');
298
+ // Pre-create the target
299
+ const targetDir = path.join(globalSkillsDir, 'my-skill');
300
+ await fs.mkdir(targetDir, { recursive: true });
301
+ await fs.writeFile(path.join(targetDir, 'SKILL.md'), 'existing content');
302
+ const result = await moveInboxSkill(moveConfig, 'my-skill', 'global');
303
+ expect(result.success).toBe(false);
304
+ expect(result.message).toBe('A skill named "my-skill" already exists in global skills.');
305
+ });
306
+ it('should detect conflicts based on the normalized skill name', async () => {
307
+ await writeSkillMd('inbox-skill', 'gke:prs-troubleshooter', 'A test skill');
308
+ await fs.mkdir(path.join(globalSkillsDir, 'existing-gke-prs-troubleshooter'), { recursive: true });
309
+ await fs.writeFile(path.join(globalSkillsDir, 'existing-gke-prs-troubleshooter', 'SKILL.md'), [
310
+ '---',
311
+ 'name: gke-prs-troubleshooter',
312
+ 'description: Existing skill',
313
+ '---',
314
+ 'Existing body content',
315
+ '',
316
+ ].join('\n'));
317
+ const result = await moveInboxSkill(moveConfig, 'inbox-skill', 'global');
318
+ expect(result.success).toBe(false);
319
+ expect(result.message).toBe('A skill named "gke-prs-troubleshooter" already exists in global skills.');
320
+ await expect(fs.access(path.join(skillsDir, 'inbox-skill', 'SKILL.md'))).resolves.toBeUndefined();
321
+ await expect(fs.access(path.join(globalSkillsDir, 'inbox-skill'))).rejects.toThrow();
322
+ });
323
+ });
324
+ describe('dismissInboxSkill', () => {
325
+ let tmpDir;
326
+ let skillsDir;
327
+ let dismissConfig;
328
+ async function writeSkillMd(dirName, name, description) {
329
+ const dir = path.join(skillsDir, dirName);
330
+ await fs.mkdir(dir, { recursive: true });
331
+ await fs.writeFile(path.join(dir, 'SKILL.md'), `---\nname: ${name}\ndescription: ${description}\n---\nBody content here\n`);
332
+ }
333
+ beforeEach(async () => {
334
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'dismiss-test-'));
335
+ skillsDir = path.join(tmpDir, 'skills-memory');
336
+ await fs.mkdir(skillsDir, { recursive: true });
337
+ dismissConfig = {
338
+ storage: {
339
+ getProjectSkillsMemoryDir: () => skillsDir,
340
+ },
341
+ };
342
+ });
343
+ afterEach(async () => {
344
+ await fs.rm(tmpDir, { recursive: true, force: true });
345
+ });
346
+ it('should remove a skill from the inbox', async () => {
347
+ await writeSkillMd('my-skill', 'my-skill', 'A test skill');
348
+ const result = await dismissInboxSkill(dismissConfig, 'my-skill');
349
+ expect(result.success).toBe(true);
350
+ expect(result.message).toBe('Dismissed "my-skill" from inbox.');
351
+ // Verify the skill directory was removed
352
+ await expect(fs.access(path.join(skillsDir, 'my-skill'))).rejects.toThrow();
353
+ });
354
+ it('should return an error when the skill does not exist', async () => {
355
+ const result = await dismissInboxSkill(dismissConfig, 'nonexistent');
356
+ expect(result.success).toBe(false);
357
+ expect(result.message).toBe('Skill "nonexistent" not found in inbox.');
358
+ });
359
+ it('should reject invalid skill directory names', async () => {
360
+ const result = await dismissInboxSkill(dismissConfig, 'nested\\skill');
361
+ expect(result.success).toBe(false);
362
+ expect(result.message).toBe('Invalid skill name.');
363
+ });
364
+ });
365
+ describe('listInboxPatches', () => {
366
+ let tmpDir;
367
+ let skillsDir;
368
+ let memoryTempDir;
369
+ let patchConfig;
370
+ beforeEach(async () => {
371
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'patch-list-test-'));
372
+ skillsDir = path.join(tmpDir, 'skills-memory');
373
+ memoryTempDir = path.join(tmpDir, 'memory-temp');
374
+ await fs.mkdir(skillsDir, { recursive: true });
375
+ await fs.mkdir(memoryTempDir, { recursive: true });
376
+ patchConfig = {
377
+ storage: {
378
+ getProjectSkillsMemoryDir: () => skillsDir,
379
+ getProjectMemoryTempDir: () => memoryTempDir,
380
+ },
381
+ };
382
+ });
383
+ afterEach(async () => {
384
+ await fs.rm(tmpDir, { recursive: true, force: true });
385
+ });
386
+ it('should return empty array when no patches exist', async () => {
387
+ const result = await listInboxPatches(patchConfig);
388
+ expect(result).toEqual([]);
389
+ });
390
+ it('should return empty array when directory does not exist', async () => {
391
+ const badConfig = {
392
+ storage: {
393
+ getProjectSkillsMemoryDir: () => path.join(tmpDir, 'nonexistent-dir'),
394
+ getProjectMemoryTempDir: () => memoryTempDir,
395
+ },
396
+ };
397
+ const result = await listInboxPatches(badConfig);
398
+ expect(result).toEqual([]);
399
+ });
400
+ it('should return parsed patch entries', async () => {
401
+ const targetFile = path.join(tmpDir, 'target.md');
402
+ const patchContent = [
403
+ `--- ${targetFile}`,
404
+ `+++ ${targetFile}`,
405
+ '@@ -1,3 +1,4 @@',
406
+ ' line1',
407
+ ' line2',
408
+ '+line2.5',
409
+ ' line3',
410
+ '',
411
+ ].join('\n');
412
+ await fs.writeFile(path.join(skillsDir, 'update-skill.patch'), patchContent);
413
+ const result = await listInboxPatches(patchConfig);
414
+ expect(result).toHaveLength(1);
415
+ expect(result[0].fileName).toBe('update-skill.patch');
416
+ expect(result[0].name).toBe('update-skill');
417
+ expect(result[0].entries).toHaveLength(1);
418
+ expect(result[0].entries[0].targetPath).toBe(targetFile);
419
+ expect(result[0].entries[0].diffContent).toContain('+line2.5');
420
+ });
421
+ it('should use each patch file mtime for extractedAt', async () => {
422
+ const firstTarget = path.join(tmpDir, 'first.md');
423
+ const secondTarget = path.join(tmpDir, 'second.md');
424
+ const firstTimestamp = new Date('2025-01-15T10:00:00.000Z');
425
+ const secondTimestamp = new Date('2025-01-16T12:00:00.000Z');
426
+ await fs.writeFile(path.join(memoryTempDir, '.extraction-state.json'), JSON.stringify({
427
+ runs: [
428
+ {
429
+ runAt: '2025-02-01T00:00:00Z',
430
+ sessionIds: ['later-run'],
431
+ skillsCreated: [],
432
+ },
433
+ ],
434
+ }));
435
+ await fs.writeFile(path.join(skillsDir, 'first.patch'), [
436
+ `--- ${firstTarget}`,
437
+ `+++ ${firstTarget}`,
438
+ '@@ -1,1 +1,1 @@',
439
+ '-before',
440
+ '+after',
441
+ '',
442
+ ].join('\n'));
443
+ await fs.writeFile(path.join(skillsDir, 'second.patch'), [
444
+ `--- ${secondTarget}`,
445
+ `+++ ${secondTarget}`,
446
+ '@@ -1,1 +1,1 @@',
447
+ '-before',
448
+ '+after',
449
+ '',
450
+ ].join('\n'));
451
+ await fs.utimes(path.join(skillsDir, 'first.patch'), firstTimestamp, firstTimestamp);
452
+ await fs.utimes(path.join(skillsDir, 'second.patch'), secondTimestamp, secondTimestamp);
453
+ const result = await listInboxPatches(patchConfig);
454
+ const firstPatch = result.find((patch) => patch.fileName === 'first.patch');
455
+ const secondPatch = result.find((patch) => patch.fileName === 'second.patch');
456
+ expect(firstPatch?.extractedAt).toBe(firstTimestamp.toISOString());
457
+ expect(secondPatch?.extractedAt).toBe(secondTimestamp.toISOString());
458
+ });
459
+ it('should skip patches with no hunks', async () => {
460
+ await fs.writeFile(path.join(skillsDir, 'empty.patch'), 'not a valid patch');
461
+ const result = await listInboxPatches(patchConfig);
462
+ expect(result).toEqual([]);
463
+ });
464
+ });
465
+ describe('applyInboxPatch', () => {
466
+ let tmpDir;
467
+ let skillsDir;
468
+ let memoryTempDir;
469
+ let globalSkillsDir;
470
+ let projectSkillsDir;
471
+ let applyConfig;
472
+ beforeEach(async () => {
473
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'patch-apply-test-'));
474
+ skillsDir = path.join(tmpDir, 'skills-memory');
475
+ memoryTempDir = path.join(tmpDir, 'memory-temp');
476
+ globalSkillsDir = path.join(tmpDir, 'global-skills');
477
+ projectSkillsDir = path.join(tmpDir, 'project-skills');
478
+ await fs.mkdir(skillsDir, { recursive: true });
479
+ await fs.mkdir(memoryTempDir, { recursive: true });
480
+ await fs.mkdir(globalSkillsDir, { recursive: true });
481
+ await fs.mkdir(projectSkillsDir, { recursive: true });
482
+ applyConfig = {
483
+ storage: {
484
+ getProjectSkillsMemoryDir: () => skillsDir,
485
+ getProjectMemoryTempDir: () => memoryTempDir,
486
+ getProjectSkillsDir: () => projectSkillsDir,
487
+ },
488
+ isTrustedFolder: () => true,
489
+ };
490
+ vi.mocked(Storage.getUserSkillsDir).mockReturnValue(globalSkillsDir);
491
+ });
492
+ afterEach(async () => {
493
+ await fs.rm(tmpDir, { recursive: true, force: true });
494
+ });
495
+ it('should apply a valid patch and delete it', async () => {
496
+ const targetFile = path.join(projectSkillsDir, 'target.md');
497
+ await fs.writeFile(targetFile, 'line1\nline2\nline3\n');
498
+ const patchContent = [
499
+ `--- ${targetFile}`,
500
+ `+++ ${targetFile}`,
501
+ '@@ -1,3 +1,4 @@',
502
+ ' line1',
503
+ ' line2',
504
+ '+line2.5',
505
+ ' line3',
506
+ '',
507
+ ].join('\n');
508
+ const patchPath = path.join(skillsDir, 'good.patch');
509
+ await fs.writeFile(patchPath, patchContent);
510
+ const result = await applyInboxPatch(applyConfig, 'good.patch');
511
+ expect(result.success).toBe(true);
512
+ expect(result.message).toContain('Applied patch to 1 file');
513
+ // Verify target was modified
514
+ const modified = await fs.readFile(targetFile, 'utf-8');
515
+ expect(modified).toContain('line2.5');
516
+ // Verify patch was deleted
517
+ await expect(fs.access(patchPath)).rejects.toThrow();
518
+ });
519
+ it('should apply a multi-file patch', async () => {
520
+ const file1 = path.join(globalSkillsDir, 'file1.md');
521
+ const file2 = path.join(projectSkillsDir, 'file2.md');
522
+ await fs.writeFile(file1, 'aaa\nbbb\nccc\n');
523
+ await fs.writeFile(file2, 'xxx\nyyy\nzzz\n');
524
+ const patchContent = [
525
+ `--- ${file1}`,
526
+ `+++ ${file1}`,
527
+ '@@ -1,3 +1,4 @@',
528
+ ' aaa',
529
+ ' bbb',
530
+ '+bbb2',
531
+ ' ccc',
532
+ `--- ${file2}`,
533
+ `+++ ${file2}`,
534
+ '@@ -1,3 +1,4 @@',
535
+ ' xxx',
536
+ ' yyy',
537
+ '+yyy2',
538
+ ' zzz',
539
+ '',
540
+ ].join('\n');
541
+ await fs.writeFile(path.join(skillsDir, 'multi.patch'), patchContent);
542
+ const result = await applyInboxPatch(applyConfig, 'multi.patch');
543
+ expect(result.success).toBe(true);
544
+ expect(result.message).toContain('2 files');
545
+ expect(await fs.readFile(file1, 'utf-8')).toContain('bbb2');
546
+ expect(await fs.readFile(file2, 'utf-8')).toContain('yyy2');
547
+ });
548
+ it('should apply repeated file blocks against the cumulative patched content', async () => {
549
+ const targetFile = path.join(projectSkillsDir, 'target.md');
550
+ await fs.writeFile(targetFile, 'alpha\nbeta\ngamma\ndelta\n');
551
+ await fs.writeFile(path.join(skillsDir, 'multi-section.patch'), [
552
+ `--- ${targetFile}`,
553
+ `+++ ${targetFile}`,
554
+ '@@ -1,4 +1,5 @@',
555
+ ' alpha',
556
+ ' beta',
557
+ '+beta2',
558
+ ' gamma',
559
+ ' delta',
560
+ `--- ${targetFile}`,
561
+ `+++ ${targetFile}`,
562
+ '@@ -2,4 +2,5 @@',
563
+ ' beta',
564
+ ' beta2',
565
+ ' gamma',
566
+ '+gamma2',
567
+ ' delta',
568
+ '',
569
+ ].join('\n'));
570
+ const result = await applyInboxPatch(applyConfig, 'multi-section.patch');
571
+ expect(result.success).toBe(true);
572
+ expect(result.message).toContain('Applied patch to 1 file');
573
+ expect(await fs.readFile(targetFile, 'utf-8')).toBe('alpha\nbeta\nbeta2\ngamma\ngamma2\ndelta\n');
574
+ });
575
+ it('should reject /dev/null patches that target an existing skill file', async () => {
576
+ const targetFile = path.join(projectSkillsDir, 'existing-skill.md');
577
+ await fs.writeFile(targetFile, 'original content\n');
578
+ const patchPath = path.join(skillsDir, 'bad-new-file.patch');
579
+ await fs.writeFile(patchPath, [
580
+ '--- /dev/null',
581
+ `+++ ${targetFile}`,
582
+ '@@ -0,0 +1 @@',
583
+ '+replacement content',
584
+ '',
585
+ ].join('\n'));
586
+ const result = await applyInboxPatch(applyConfig, 'bad-new-file.patch');
587
+ expect(result.success).toBe(false);
588
+ expect(result.message).toContain('target already exists');
589
+ expect(await fs.readFile(targetFile, 'utf-8')).toBe('original content\n');
590
+ await expect(fs.access(patchPath)).resolves.toBeUndefined();
591
+ });
592
+ it('should fail when patch does not exist', async () => {
593
+ const result = await applyInboxPatch(applyConfig, 'missing.patch');
594
+ expect(result.success).toBe(false);
595
+ expect(result.message).toContain('not found');
596
+ });
597
+ it('should reject invalid patch file names', async () => {
598
+ const outsidePatch = path.join(tmpDir, 'outside.patch');
599
+ await fs.writeFile(outsidePatch, 'outside patch content');
600
+ const result = await applyInboxPatch(applyConfig, '../outside.patch');
601
+ expect(result.success).toBe(false);
602
+ expect(result.message).toBe('Invalid patch file name.');
603
+ await expect(fs.access(outsidePatch)).resolves.toBeUndefined();
604
+ });
605
+ it('should fail when target file does not exist', async () => {
606
+ const missingFile = path.join(projectSkillsDir, 'missing-target.md');
607
+ const patchContent = [
608
+ `--- ${missingFile}`,
609
+ `+++ ${missingFile}`,
610
+ '@@ -1,3 +1,4 @@',
611
+ ' a',
612
+ ' b',
613
+ '+c',
614
+ ' d',
615
+ '',
616
+ ].join('\n');
617
+ await fs.writeFile(path.join(skillsDir, 'bad-target.patch'), patchContent);
618
+ const result = await applyInboxPatch(applyConfig, 'bad-target.patch');
619
+ expect(result.success).toBe(false);
620
+ expect(result.message).toContain('Target file not found');
621
+ });
622
+ it('should reject targets outside the global and workspace skill roots', async () => {
623
+ const outsideFile = path.join(tmpDir, 'outside.md');
624
+ await fs.writeFile(outsideFile, 'line1\nline2\nline3\n');
625
+ const patchContent = [
626
+ `--- ${outsideFile}`,
627
+ `+++ ${outsideFile}`,
628
+ '@@ -1,3 +1,4 @@',
629
+ ' line1',
630
+ ' line2',
631
+ '+line2.5',
632
+ ' line3',
633
+ '',
634
+ ].join('\n');
635
+ const patchPath = path.join(skillsDir, 'outside.patch');
636
+ await fs.writeFile(patchPath, patchContent);
637
+ const result = await applyInboxPatch(applyConfig, 'outside.patch');
638
+ expect(result.success).toBe(false);
639
+ expect(result.message).toContain('outside the global/workspace skill directories');
640
+ expect(await fs.readFile(outsideFile, 'utf-8')).not.toContain('line2.5');
641
+ await expect(fs.access(patchPath)).resolves.toBeUndefined();
642
+ });
643
+ it('should reject targets that escape the skill root through a symlinked parent', async () => {
644
+ const outsideDir = path.join(tmpDir, 'outside-dir');
645
+ const linkDir = path.join(projectSkillsDir, 'linked');
646
+ await fs.mkdir(outsideDir, { recursive: true });
647
+ await fs.symlink(outsideDir, linkDir, process.platform === 'win32' ? 'junction' : 'dir');
648
+ const outsideFile = path.join(outsideDir, 'escaped.md');
649
+ await fs.writeFile(outsideFile, 'line1\nline2\nline3\n');
650
+ const patchPath = path.join(skillsDir, 'symlink.patch');
651
+ await fs.writeFile(patchPath, [
652
+ `--- ${path.join(linkDir, 'escaped.md')}`,
653
+ `+++ ${path.join(linkDir, 'escaped.md')}`,
654
+ '@@ -1,3 +1,4 @@',
655
+ ' line1',
656
+ ' line2',
657
+ '+line2.5',
658
+ ' line3',
659
+ '',
660
+ ].join('\n'));
661
+ const result = await applyInboxPatch(applyConfig, 'symlink.patch');
662
+ expect(result.success).toBe(false);
663
+ expect(result.message).toContain('outside the global/workspace skill directories');
664
+ expect(await fs.readFile(outsideFile, 'utf-8')).not.toContain('line2.5');
665
+ await expect(fs.access(patchPath)).resolves.toBeUndefined();
666
+ });
667
+ it('should reject patches that contain no hunks', async () => {
668
+ await fs.writeFile(path.join(skillsDir, 'empty.patch'), [
669
+ `--- ${path.join(projectSkillsDir, 'target.md')}`,
670
+ `+++ ${path.join(projectSkillsDir, 'target.md')}`,
671
+ '',
672
+ ].join('\n'));
673
+ const result = await applyInboxPatch(applyConfig, 'empty.patch');
674
+ expect(result.success).toBe(false);
675
+ expect(result.message).toContain('contains no valid hunks');
676
+ });
677
+ it('should reject project-scope patches when the workspace is untrusted', async () => {
678
+ const targetFile = path.join(projectSkillsDir, 'target.md');
679
+ await fs.writeFile(targetFile, 'line1\nline2\nline3\n');
680
+ const patchPath = path.join(skillsDir, 'workspace.patch');
681
+ await fs.writeFile(patchPath, [
682
+ `--- ${targetFile}`,
683
+ `+++ ${targetFile}`,
684
+ '@@ -1,3 +1,4 @@',
685
+ ' line1',
686
+ ' line2',
687
+ '+line2.5',
688
+ ' line3',
689
+ '',
690
+ ].join('\n'));
691
+ const untrustedConfig = {
692
+ storage: applyConfig.storage,
693
+ isTrustedFolder: () => false,
694
+ };
695
+ const result = await applyInboxPatch(untrustedConfig, 'workspace.patch');
696
+ expect(result.success).toBe(false);
697
+ expect(result.message).toContain('Project skill patches are unavailable until this workspace is trusted.');
698
+ expect(await fs.readFile(targetFile, 'utf-8')).toBe('line1\nline2\nline3\n');
699
+ await expect(fs.access(patchPath)).resolves.toBeUndefined();
700
+ });
701
+ it('should reject project-scope patches through a symlinked project skills root when the workspace is untrusted', async () => {
702
+ const realProjectSkillsDir = path.join(tmpDir, 'project-skills-real');
703
+ const symlinkedProjectSkillsDir = path.join(tmpDir, 'project-skills-link');
704
+ await fs.mkdir(realProjectSkillsDir, { recursive: true });
705
+ await fs.symlink(realProjectSkillsDir, symlinkedProjectSkillsDir, process.platform === 'win32' ? 'junction' : 'dir');
706
+ projectSkillsDir = symlinkedProjectSkillsDir;
707
+ const targetFile = path.join(realProjectSkillsDir, 'target.md');
708
+ await fs.writeFile(targetFile, 'line1\nline2\nline3\n');
709
+ const patchPath = path.join(skillsDir, 'workspace-symlink.patch');
710
+ await fs.writeFile(patchPath, [
711
+ `--- ${targetFile}`,
712
+ `+++ ${targetFile}`,
713
+ '@@ -1,3 +1,4 @@',
714
+ ' line1',
715
+ ' line2',
716
+ '+line2.5',
717
+ ' line3',
718
+ '',
719
+ ].join('\n'));
720
+ const untrustedConfig = {
721
+ storage: applyConfig.storage,
722
+ isTrustedFolder: () => false,
723
+ };
724
+ const result = await applyInboxPatch(untrustedConfig, 'workspace-symlink.patch');
725
+ expect(result.success).toBe(false);
726
+ expect(result.message).toContain('Project skill patches are unavailable until this workspace is trusted.');
727
+ expect(await fs.readFile(targetFile, 'utf-8')).toBe('line1\nline2\nline3\n');
728
+ await expect(fs.access(patchPath)).resolves.toBeUndefined();
729
+ });
730
+ it('should reject patches with mismatched diff headers', async () => {
731
+ const sourceFile = path.join(projectSkillsDir, 'source.md');
732
+ const targetFile = path.join(projectSkillsDir, 'target.md');
733
+ await fs.writeFile(sourceFile, 'aaa\nbbb\nccc\n');
734
+ await fs.writeFile(targetFile, 'xxx\nyyy\nzzz\n');
735
+ const patchPath = path.join(skillsDir, 'mismatched-headers.patch');
736
+ await fs.writeFile(patchPath, [
737
+ `--- ${sourceFile}`,
738
+ `+++ ${targetFile}`,
739
+ '@@ -1,3 +1,4 @@',
740
+ ' xxx',
741
+ ' yyy',
742
+ '+yyy2',
743
+ ' zzz',
744
+ '',
745
+ ].join('\n'));
746
+ const result = await applyInboxPatch(applyConfig, 'mismatched-headers.patch');
747
+ expect(result.success).toBe(false);
748
+ expect(result.message).toContain('invalid diff headers');
749
+ expect(await fs.readFile(sourceFile, 'utf-8')).toBe('aaa\nbbb\nccc\n');
750
+ expect(await fs.readFile(targetFile, 'utf-8')).toBe('xxx\nyyy\nzzz\n');
751
+ await expect(fs.access(patchPath)).resolves.toBeUndefined();
752
+ });
753
+ it('should strip git-style a/ and b/ prefixes and apply successfully', async () => {
754
+ const targetFile = path.join(projectSkillsDir, 'prefixed.md');
755
+ await fs.writeFile(targetFile, 'line1\nline2\nline3\n');
756
+ const patchPath = path.join(skillsDir, 'git-prefix.patch');
757
+ await fs.writeFile(patchPath, [
758
+ `--- a/${targetFile}`,
759
+ `+++ b/${targetFile}`,
760
+ '@@ -1,3 +1,4 @@',
761
+ ' line1',
762
+ ' line2',
763
+ '+line2.5',
764
+ ' line3',
765
+ '',
766
+ ].join('\n'));
767
+ const result = await applyInboxPatch(applyConfig, 'git-prefix.patch');
768
+ expect(result.success).toBe(true);
769
+ expect(result.message).toContain('Applied patch to 1 file');
770
+ expect(await fs.readFile(targetFile, 'utf-8')).toBe('line1\nline2\nline2.5\nline3\n');
771
+ await expect(fs.access(patchPath)).rejects.toThrow();
772
+ });
773
+ it('should not write any files if one patch in a multi-file set fails', async () => {
774
+ const file1 = path.join(projectSkillsDir, 'file1.md');
775
+ await fs.writeFile(file1, 'aaa\nbbb\nccc\n');
776
+ const missingFile = path.join(projectSkillsDir, 'missing.md');
777
+ const patchContent = [
778
+ `--- ${file1}`,
779
+ `+++ ${file1}`,
780
+ '@@ -1,3 +1,4 @@',
781
+ ' aaa',
782
+ ' bbb',
783
+ '+bbb2',
784
+ ' ccc',
785
+ `--- ${missingFile}`,
786
+ `+++ ${missingFile}`,
787
+ '@@ -1,3 +1,4 @@',
788
+ ' x',
789
+ ' y',
790
+ '+z',
791
+ ' w',
792
+ '',
793
+ ].join('\n');
794
+ await fs.writeFile(path.join(skillsDir, 'partial.patch'), patchContent);
795
+ const result = await applyInboxPatch(applyConfig, 'partial.patch');
796
+ expect(result.success).toBe(false);
797
+ // Verify file1 was NOT modified (dry-run failed)
798
+ const content = await fs.readFile(file1, 'utf-8');
799
+ expect(content).not.toContain('bbb2');
800
+ });
801
+ it('should roll back earlier file updates if a later commit step fails', async () => {
802
+ const file1 = path.join(projectSkillsDir, 'file1.md');
803
+ await fs.writeFile(file1, 'aaa\nbbb\nccc\n');
804
+ const conflictPath = path.join(projectSkillsDir, 'conflict');
805
+ const nestedNewFile = path.join(conflictPath, 'nested.md');
806
+ const patchPath = path.join(skillsDir, 'rollback.patch');
807
+ await fs.writeFile(patchPath, [
808
+ `--- ${file1}`,
809
+ `+++ ${file1}`,
810
+ '@@ -1,3 +1,4 @@',
811
+ ' aaa',
812
+ ' bbb',
813
+ '+bbb2',
814
+ ' ccc',
815
+ '--- /dev/null',
816
+ `+++ ${conflictPath}`,
817
+ '@@ -0,0 +1 @@',
818
+ '+new file content',
819
+ '--- /dev/null',
820
+ `+++ ${nestedNewFile}`,
821
+ '@@ -0,0 +1 @@',
822
+ '+nested new file content',
823
+ '',
824
+ ].join('\n'));
825
+ const result = await applyInboxPatch(applyConfig, 'rollback.patch');
826
+ expect(result.success).toBe(false);
827
+ expect(result.message).toContain('could not be applied atomically');
828
+ expect(await fs.readFile(file1, 'utf-8')).toBe('aaa\nbbb\nccc\n');
829
+ expect((await fs.stat(conflictPath)).isDirectory()).toBe(true);
830
+ await expect(fs.access(nestedNewFile)).rejects.toThrow();
831
+ await expect(fs.access(patchPath)).resolves.toBeUndefined();
832
+ });
833
+ });
834
+ describe('dismissInboxPatch', () => {
835
+ let tmpDir;
836
+ let skillsDir;
837
+ let dismissPatchConfig;
838
+ beforeEach(async () => {
839
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'patch-dismiss-test-'));
840
+ skillsDir = path.join(tmpDir, 'skills-memory');
841
+ await fs.mkdir(skillsDir, { recursive: true });
842
+ dismissPatchConfig = {
843
+ storage: {
844
+ getProjectSkillsMemoryDir: () => skillsDir,
845
+ },
846
+ };
847
+ });
848
+ afterEach(async () => {
849
+ await fs.rm(tmpDir, { recursive: true, force: true });
850
+ });
851
+ it('should delete the patch file and return success', async () => {
852
+ const patchPath = path.join(skillsDir, 'old.patch');
853
+ await fs.writeFile(patchPath, 'some patch content');
854
+ const result = await dismissInboxPatch(dismissPatchConfig, 'old.patch');
855
+ expect(result.success).toBe(true);
856
+ expect(result.message).toContain('Dismissed');
857
+ await expect(fs.access(patchPath)).rejects.toThrow();
858
+ });
859
+ it('should return error when patch does not exist', async () => {
860
+ const result = await dismissInboxPatch(dismissPatchConfig, 'nonexistent.patch');
861
+ expect(result.success).toBe(false);
862
+ expect(result.message).toContain('not found');
863
+ });
864
+ it('should reject invalid patch file names', async () => {
865
+ const outsidePatch = path.join(tmpDir, 'outside.patch');
866
+ await fs.writeFile(outsidePatch, 'outside patch content');
867
+ const result = await dismissInboxPatch(dismissPatchConfig, '../outside.patch');
868
+ expect(result.success).toBe(false);
869
+ expect(result.message).toBe('Invalid patch file name.');
870
+ await expect(fs.access(outsidePatch)).resolves.toBeUndefined();
871
+ });
872
+ });
154
873
  });
155
874
  //# sourceMappingURL=memory.test.js.map