@relkit/langchain 0.0.0-stage → 0.7.10

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 (663) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +48 -2
  3. package/dist/client-contract-metadata.d.ts +31 -0
  4. package/dist/client-contract-metadata.d.ts.map +1 -0
  5. package/dist/client-contract-metadata.js +129 -0
  6. package/dist/client-contract-metadata.js.map +1 -0
  7. package/dist/client-contract-metadata.types.d.ts +59 -0
  8. package/dist/client-contract-metadata.types.d.ts.map +1 -0
  9. package/dist/client-contract-metadata.types.js +3 -0
  10. package/dist/client-contract-metadata.types.js.map +1 -0
  11. package/dist/client-contract-schema.d.ts +66 -0
  12. package/dist/client-contract-schema.d.ts.map +1 -0
  13. package/dist/client-contract-schema.js +153 -0
  14. package/dist/client-contract-schema.js.map +1 -0
  15. package/dist/continuation-validation.d.ts +9 -0
  16. package/dist/continuation-validation.d.ts.map +1 -0
  17. package/dist/continuation-validation.js +9 -0
  18. package/dist/continuation-validation.js.map +1 -0
  19. package/dist/deepagent-bucket-backend.d.ts +33 -0
  20. package/dist/deepagent-bucket-backend.d.ts.map +1 -0
  21. package/dist/deepagent-bucket-backend.js +47 -0
  22. package/dist/deepagent-bucket-backend.js.map +1 -0
  23. package/dist/deepagent-bucket-backend.types.d.ts +6 -0
  24. package/dist/deepagent-bucket-backend.types.d.ts.map +1 -0
  25. package/dist/deepagent-bucket-backend.types.js +2 -0
  26. package/dist/deepagent-bucket-backend.types.js.map +1 -0
  27. package/dist/deepagent-bucket-client.types.d.ts +25 -0
  28. package/dist/deepagent-bucket-client.types.d.ts.map +1 -0
  29. package/dist/deepagent-bucket-client.types.js +3 -0
  30. package/dist/deepagent-bucket-client.types.js.map +1 -0
  31. package/dist/deepagent-bucket-delete.d.ts +28 -0
  32. package/dist/deepagent-bucket-delete.d.ts.map +1 -0
  33. package/dist/deepagent-bucket-delete.js +64 -0
  34. package/dist/deepagent-bucket-delete.js.map +1 -0
  35. package/dist/deepagent-bucket-error.d.ts +17 -0
  36. package/dist/deepagent-bucket-error.d.ts.map +1 -0
  37. package/dist/deepagent-bucket-error.js +17 -0
  38. package/dist/deepagent-bucket-error.js.map +1 -0
  39. package/dist/deepagent-bucket-file-data.d.ts +40 -0
  40. package/dist/deepagent-bucket-file-data.d.ts.map +1 -0
  41. package/dist/deepagent-bucket-file-data.js +115 -0
  42. package/dist/deepagent-bucket-file-data.js.map +1 -0
  43. package/dist/deepagent-bucket-file-index.d.ts +34 -0
  44. package/dist/deepagent-bucket-file-index.d.ts.map +1 -0
  45. package/dist/deepagent-bucket-file-index.js +82 -0
  46. package/dist/deepagent-bucket-file-index.js.map +1 -0
  47. package/dist/deepagent-bucket-files.d.ts +5 -0
  48. package/dist/deepagent-bucket-files.d.ts.map +1 -0
  49. package/dist/deepagent-bucket-files.js +4 -0
  50. package/dist/deepagent-bucket-files.js.map +1 -0
  51. package/dist/deepagent-bucket-files.types.d.ts +8 -0
  52. package/dist/deepagent-bucket-files.types.d.ts.map +1 -0
  53. package/dist/deepagent-bucket-files.types.js +3 -0
  54. package/dist/deepagent-bucket-files.types.js.map +1 -0
  55. package/dist/deepagent-bucket-format.d.ts +59 -0
  56. package/dist/deepagent-bucket-format.d.ts.map +1 -0
  57. package/dist/deepagent-bucket-format.js +72 -0
  58. package/dist/deepagent-bucket-format.js.map +1 -0
  59. package/dist/deepagent-bucket-glob.d.ts +26 -0
  60. package/dist/deepagent-bucket-glob.d.ts.map +1 -0
  61. package/dist/deepagent-bucket-glob.js +66 -0
  62. package/dist/deepagent-bucket-glob.js.map +1 -0
  63. package/dist/deepagent-bucket-grep.d.ts +32 -0
  64. package/dist/deepagent-bucket-grep.d.ts.map +1 -0
  65. package/dist/deepagent-bucket-grep.js +73 -0
  66. package/dist/deepagent-bucket-grep.js.map +1 -0
  67. package/dist/deepagent-bucket-path.d.ts +67 -0
  68. package/dist/deepagent-bucket-path.d.ts.map +1 -0
  69. package/dist/deepagent-bucket-path.js +121 -0
  70. package/dist/deepagent-bucket-path.js.map +1 -0
  71. package/dist/deepagent-bucket-read.d.ts +65 -0
  72. package/dist/deepagent-bucket-read.d.ts.map +1 -0
  73. package/dist/deepagent-bucket-read.js +77 -0
  74. package/dist/deepagent-bucket-read.js.map +1 -0
  75. package/dist/deepagent-bucket-scope.d.ts +43 -0
  76. package/dist/deepagent-bucket-scope.d.ts.map +1 -0
  77. package/dist/deepagent-bucket-scope.js +40 -0
  78. package/dist/deepagent-bucket-scope.js.map +1 -0
  79. package/dist/deepagent-bucket-search.d.ts +22 -0
  80. package/dist/deepagent-bucket-search.d.ts.map +1 -0
  81. package/dist/deepagent-bucket-search.js +60 -0
  82. package/dist/deepagent-bucket-search.js.map +1 -0
  83. package/dist/deepagent-bucket-service.d.ts +17 -0
  84. package/dist/deepagent-bucket-service.d.ts.map +1 -0
  85. package/dist/deepagent-bucket-service.js +16 -0
  86. package/dist/deepagent-bucket-service.js.map +1 -0
  87. package/dist/deepagent-bucket-transfer.d.ts +52 -0
  88. package/dist/deepagent-bucket-transfer.d.ts.map +1 -0
  89. package/dist/deepagent-bucket-transfer.js +73 -0
  90. package/dist/deepagent-bucket-transfer.js.map +1 -0
  91. package/dist/deepagent-bucket-write.d.ts +55 -0
  92. package/dist/deepagent-bucket-write.d.ts.map +1 -0
  93. package/dist/deepagent-bucket-write.js +88 -0
  94. package/dist/deepagent-bucket-write.js.map +1 -0
  95. package/dist/define-agent-build.d.ts +12 -0
  96. package/dist/define-agent-build.d.ts.map +1 -0
  97. package/dist/define-agent-build.js +60 -0
  98. package/dist/define-agent-build.js.map +1 -0
  99. package/dist/define-agent-deep.d.ts +30 -0
  100. package/dist/define-agent-deep.d.ts.map +1 -0
  101. package/dist/define-agent-deep.js +125 -0
  102. package/dist/define-agent-deep.js.map +1 -0
  103. package/dist/define-agent-deep.types.d.ts +23 -0
  104. package/dist/define-agent-deep.types.d.ts.map +1 -0
  105. package/dist/define-agent-deep.types.js +3 -0
  106. package/dist/define-agent-deep.types.js.map +1 -0
  107. package/dist/define-agent-native-middleware.d.ts +34 -0
  108. package/dist/define-agent-native-middleware.d.ts.map +1 -0
  109. package/dist/define-agent-native-middleware.js +83 -0
  110. package/dist/define-agent-native-middleware.js.map +1 -0
  111. package/dist/define-agent-native-model.d.ts +16 -0
  112. package/dist/define-agent-native-model.d.ts.map +1 -0
  113. package/dist/define-agent-native-model.js +23 -0
  114. package/dist/define-agent-native-model.js.map +1 -0
  115. package/dist/define-agent-native-tools.d.ts +30 -0
  116. package/dist/define-agent-native-tools.d.ts.map +1 -0
  117. package/dist/define-agent-native-tools.js +72 -0
  118. package/dist/define-agent-native-tools.js.map +1 -0
  119. package/dist/define-agent-native.d.ts +6 -0
  120. package/dist/define-agent-native.d.ts.map +1 -0
  121. package/dist/define-agent-native.js +5 -0
  122. package/dist/define-agent-native.js.map +1 -0
  123. package/dist/define-agent-native.types.d.ts +36 -0
  124. package/dist/define-agent-native.types.d.ts.map +1 -0
  125. package/dist/define-agent-native.types.js +3 -0
  126. package/dist/define-agent-native.types.js.map +1 -0
  127. package/dist/define-agent-validation.d.ts +45 -0
  128. package/dist/define-agent-validation.d.ts.map +1 -0
  129. package/dist/define-agent-validation.js +92 -0
  130. package/dist/define-agent-validation.js.map +1 -0
  131. package/dist/define-agent.d.ts +41 -0
  132. package/dist/define-agent.d.ts.map +1 -0
  133. package/dist/define-agent.js +59 -0
  134. package/dist/define-agent.js.map +1 -0
  135. package/dist/define-agent.types.d.ts +54 -0
  136. package/dist/define-agent.types.d.ts.map +1 -0
  137. package/dist/define-agent.types.js +3 -0
  138. package/dist/define-agent.types.js.map +1 -0
  139. package/dist/define-graph-build.d.ts +12 -0
  140. package/dist/define-graph-build.d.ts.map +1 -0
  141. package/dist/define-graph-build.js +86 -0
  142. package/dist/define-graph-build.js.map +1 -0
  143. package/dist/define-graph-error.d.ts +17 -0
  144. package/dist/define-graph-error.d.ts.map +1 -0
  145. package/dist/define-graph-error.js +17 -0
  146. package/dist/define-graph-error.js.map +1 -0
  147. package/dist/define-graph-node.d.ts +42 -0
  148. package/dist/define-graph-node.d.ts.map +1 -0
  149. package/dist/define-graph-node.js +97 -0
  150. package/dist/define-graph-node.js.map +1 -0
  151. package/dist/define-graph-node.types.d.ts +38 -0
  152. package/dist/define-graph-node.types.d.ts.map +1 -0
  153. package/dist/define-graph-node.types.js +3 -0
  154. package/dist/define-graph-node.types.js.map +1 -0
  155. package/dist/define-graph.d.ts +44 -0
  156. package/dist/define-graph.d.ts.map +1 -0
  157. package/dist/define-graph.js +72 -0
  158. package/dist/define-graph.js.map +1 -0
  159. package/dist/define-graph.types.d.ts +69 -0
  160. package/dist/define-graph.types.d.ts.map +1 -0
  161. package/dist/define-graph.types.js +3 -0
  162. package/dist/define-graph.types.js.map +1 -0
  163. package/dist/define-persistence-guards.d.ts +32 -0
  164. package/dist/define-persistence-guards.d.ts.map +1 -0
  165. package/dist/define-persistence-guards.js +55 -0
  166. package/dist/define-persistence-guards.js.map +1 -0
  167. package/dist/define-persistence.d.ts +33 -0
  168. package/dist/define-persistence.d.ts.map +1 -0
  169. package/dist/define-persistence.js +112 -0
  170. package/dist/define-persistence.js.map +1 -0
  171. package/dist/define-persistence.types.d.ts +30 -0
  172. package/dist/define-persistence.types.d.ts.map +1 -0
  173. package/dist/define-persistence.types.js +3 -0
  174. package/dist/define-persistence.types.js.map +1 -0
  175. package/dist/graph-compile-error.d.ts +17 -0
  176. package/dist/graph-compile-error.d.ts.map +1 -0
  177. package/dist/graph-compile-error.js +17 -0
  178. package/dist/graph-compile-error.js.map +1 -0
  179. package/dist/graph-compile.d.ts +32 -0
  180. package/dist/graph-compile.d.ts.map +1 -0
  181. package/dist/graph-compile.js +94 -0
  182. package/dist/graph-compile.js.map +1 -0
  183. package/dist/graph-continuation-error.d.ts +17 -0
  184. package/dist/graph-continuation-error.d.ts.map +1 -0
  185. package/dist/graph-continuation-error.js +17 -0
  186. package/dist/graph-continuation-error.js.map +1 -0
  187. package/dist/graph-continuation-validation.d.ts +22 -0
  188. package/dist/graph-continuation-validation.d.ts.map +1 -0
  189. package/dist/graph-continuation-validation.js +67 -0
  190. package/dist/graph-continuation-validation.js.map +1 -0
  191. package/dist/graph-continuation-waiting.d.ts +23 -0
  192. package/dist/graph-continuation-waiting.d.ts.map +1 -0
  193. package/dist/graph-continuation-waiting.js +53 -0
  194. package/dist/graph-continuation-waiting.js.map +1 -0
  195. package/dist/graph-continuation.d.ts +43 -0
  196. package/dist/graph-continuation.d.ts.map +1 -0
  197. package/dist/graph-continuation.js +82 -0
  198. package/dist/graph-continuation.js.map +1 -0
  199. package/dist/graph-continuation.types.d.ts +11 -0
  200. package/dist/graph-continuation.types.d.ts.map +1 -0
  201. package/dist/graph-continuation.types.js +3 -0
  202. package/dist/graph-continuation.types.js.map +1 -0
  203. package/dist/graph-definition.d.ts +36 -0
  204. package/dist/graph-definition.d.ts.map +1 -0
  205. package/dist/graph-definition.js +90 -0
  206. package/dist/graph-definition.js.map +1 -0
  207. package/dist/graph-edge-destinations.d.ts +42 -0
  208. package/dist/graph-edge-destinations.d.ts.map +1 -0
  209. package/dist/graph-edge-destinations.js +100 -0
  210. package/dist/graph-edge-destinations.js.map +1 -0
  211. package/dist/graph-edge-mutations.d.ts +19 -0
  212. package/dist/graph-edge-mutations.d.ts.map +1 -0
  213. package/dist/graph-edge-mutations.js +62 -0
  214. package/dist/graph-edge-mutations.js.map +1 -0
  215. package/dist/graph-edge-mutations.types.d.ts +9 -0
  216. package/dist/graph-edge-mutations.types.d.ts.map +1 -0
  217. package/dist/graph-edge-mutations.types.js +2 -0
  218. package/dist/graph-edge-mutations.types.js.map +1 -0
  219. package/dist/graph-edges.d.ts +24 -0
  220. package/dist/graph-edges.d.ts.map +1 -0
  221. package/dist/graph-edges.js +37 -0
  222. package/dist/graph-edges.js.map +1 -0
  223. package/dist/graph-edges.types.d.ts +47 -0
  224. package/dist/graph-edges.types.d.ts.map +1 -0
  225. package/dist/graph-edges.types.js +3 -0
  226. package/dist/graph-edges.types.js.map +1 -0
  227. package/dist/graph-execution-symbol.d.ts +3 -0
  228. package/dist/graph-execution-symbol.d.ts.map +1 -0
  229. package/dist/graph-execution-symbol.js +3 -0
  230. package/dist/graph-execution-symbol.js.map +1 -0
  231. package/dist/graph-interruption.d.ts +84 -0
  232. package/dist/graph-interruption.d.ts.map +1 -0
  233. package/dist/graph-interruption.js +119 -0
  234. package/dist/graph-interruption.js.map +1 -0
  235. package/dist/graph-interruption.types.d.ts +16 -0
  236. package/dist/graph-interruption.types.d.ts.map +1 -0
  237. package/dist/graph-interruption.types.js +3 -0
  238. package/dist/graph-interruption.types.js.map +1 -0
  239. package/dist/graph-node-schema-validation.d.ts +9 -0
  240. package/dist/graph-node-schema-validation.d.ts.map +1 -0
  241. package/dist/graph-node-schema-validation.js +16 -0
  242. package/dist/graph-node-schema-validation.js.map +1 -0
  243. package/dist/graph-node-symbol.d.ts +3 -0
  244. package/dist/graph-node-symbol.d.ts.map +1 -0
  245. package/dist/graph-node-symbol.js +3 -0
  246. package/dist/graph-node-symbol.js.map +1 -0
  247. package/dist/graph-node-validation-error.d.ts +17 -0
  248. package/dist/graph-node-validation-error.d.ts.map +1 -0
  249. package/dist/graph-node-validation-error.js +17 -0
  250. package/dist/graph-node-validation-error.js.map +1 -0
  251. package/dist/graph-node-validation-value.d.ts +64 -0
  252. package/dist/graph-node-validation-value.d.ts.map +1 -0
  253. package/dist/graph-node-validation-value.js +117 -0
  254. package/dist/graph-node-validation-value.js.map +1 -0
  255. package/dist/graph-node-validation.d.ts +65 -0
  256. package/dist/graph-node-validation.d.ts.map +1 -0
  257. package/dist/graph-node-validation.js +113 -0
  258. package/dist/graph-node-validation.js.map +1 -0
  259. package/dist/graph-persistence-release.d.ts +16 -0
  260. package/dist/graph-persistence-release.d.ts.map +1 -0
  261. package/dist/graph-persistence-release.js +43 -0
  262. package/dist/graph-persistence-release.js.map +1 -0
  263. package/dist/graph-persistence.d.ts +39 -0
  264. package/dist/graph-persistence.d.ts.map +1 -0
  265. package/dist/graph-persistence.js +111 -0
  266. package/dist/graph-persistence.js.map +1 -0
  267. package/dist/graph-persistence.types.d.ts +21 -0
  268. package/dist/graph-persistence.types.d.ts.map +1 -0
  269. package/dist/graph-persistence.types.js +3 -0
  270. package/dist/graph-persistence.types.js.map +1 -0
  271. package/dist/graph-runtime-error.d.ts +17 -0
  272. package/dist/graph-runtime-error.d.ts.map +1 -0
  273. package/dist/graph-runtime-error.js +17 -0
  274. package/dist/graph-runtime-error.js.map +1 -0
  275. package/dist/graph-runtime-execution.d.ts +28 -0
  276. package/dist/graph-runtime-execution.d.ts.map +1 -0
  277. package/dist/graph-runtime-execution.js +69 -0
  278. package/dist/graph-runtime-execution.js.map +1 -0
  279. package/dist/graph-runtime-identity.d.ts +15 -0
  280. package/dist/graph-runtime-identity.d.ts.map +1 -0
  281. package/dist/graph-runtime-identity.js +14 -0
  282. package/dist/graph-runtime-identity.js.map +1 -0
  283. package/dist/graph-runtime-identity.types.d.ts +5 -0
  284. package/dist/graph-runtime-identity.types.d.ts.map +1 -0
  285. package/dist/graph-runtime-identity.types.js +2 -0
  286. package/dist/graph-runtime-identity.types.js.map +1 -0
  287. package/dist/graph-runtime-stream-state.d.ts +8 -0
  288. package/dist/graph-runtime-stream-state.d.ts.map +1 -0
  289. package/dist/graph-runtime-stream-state.js +67 -0
  290. package/dist/graph-runtime-stream-state.js.map +1 -0
  291. package/dist/graph-runtime-stream.d.ts +16 -0
  292. package/dist/graph-runtime-stream.d.ts.map +1 -0
  293. package/dist/graph-runtime-stream.js +49 -0
  294. package/dist/graph-runtime-stream.js.map +1 -0
  295. package/dist/graph-runtime-stream.types.d.ts +13 -0
  296. package/dist/graph-runtime-stream.types.d.ts.map +1 -0
  297. package/dist/graph-runtime-stream.types.js +2 -0
  298. package/dist/graph-runtime-stream.types.js.map +1 -0
  299. package/dist/graph-runtime.d.ts +21 -0
  300. package/dist/graph-runtime.d.ts.map +1 -0
  301. package/dist/graph-runtime.js +74 -0
  302. package/dist/graph-runtime.js.map +1 -0
  303. package/dist/graph-runtime.types.d.ts +8 -0
  304. package/dist/graph-runtime.types.d.ts.map +1 -0
  305. package/dist/graph-runtime.types.js +3 -0
  306. package/dist/graph-runtime.types.js.map +1 -0
  307. package/dist/graph-state-schema.d.ts +35 -0
  308. package/dist/graph-state-schema.d.ts.map +1 -0
  309. package/dist/graph-state-schema.js +65 -0
  310. package/dist/graph-state-schema.js.map +1 -0
  311. package/dist/graph-subgraph-symbol.d.ts +5 -0
  312. package/dist/graph-subgraph-symbol.d.ts.map +1 -0
  313. package/dist/graph-subgraph-symbol.js +5 -0
  314. package/dist/graph-subgraph-symbol.js.map +1 -0
  315. package/dist/graph-subgraph.d.ts +46 -0
  316. package/dist/graph-subgraph.d.ts.map +1 -0
  317. package/dist/graph-subgraph.js +82 -0
  318. package/dist/graph-subgraph.js.map +1 -0
  319. package/dist/graph-subgraph.types.d.ts +20 -0
  320. package/dist/graph-subgraph.types.d.ts.map +1 -0
  321. package/dist/graph-subgraph.types.js +3 -0
  322. package/dist/graph-subgraph.types.js.map +1 -0
  323. package/dist/graph-workflow-error.d.ts +17 -0
  324. package/dist/graph-workflow-error.d.ts.map +1 -0
  325. package/dist/graph-workflow-error.js +17 -0
  326. package/dist/graph-workflow-error.js.map +1 -0
  327. package/dist/graph-workflow.d.ts +37 -0
  328. package/dist/graph-workflow.d.ts.map +1 -0
  329. package/dist/graph-workflow.js +86 -0
  330. package/dist/graph-workflow.js.map +1 -0
  331. package/dist/graph-workflow.types.d.ts +41 -0
  332. package/dist/graph-workflow.types.d.ts.map +1 -0
  333. package/dist/graph-workflow.types.js +3 -0
  334. package/dist/graph-workflow.types.js.map +1 -0
  335. package/dist/index.d.ts +32 -0
  336. package/dist/index.d.ts.map +1 -0
  337. package/dist/index.js +28 -0
  338. package/dist/index.js.map +1 -0
  339. package/dist/native-agent-interruption-error.d.ts +17 -0
  340. package/dist/native-agent-interruption-error.d.ts.map +1 -0
  341. package/dist/native-agent-interruption-error.js +17 -0
  342. package/dist/native-agent-interruption-error.js.map +1 -0
  343. package/dist/native-agent-interruption-schema.d.ts +66 -0
  344. package/dist/native-agent-interruption-schema.d.ts.map +1 -0
  345. package/dist/native-agent-interruption-schema.js +141 -0
  346. package/dist/native-agent-interruption-schema.js.map +1 -0
  347. package/dist/native-agent-interruption-schema.types.d.ts +16 -0
  348. package/dist/native-agent-interruption-schema.types.d.ts.map +1 -0
  349. package/dist/native-agent-interruption-schema.types.js +3 -0
  350. package/dist/native-agent-interruption-schema.types.js.map +1 -0
  351. package/dist/native-agent-interruption-validation.d.ts +19 -0
  352. package/dist/native-agent-interruption-validation.d.ts.map +1 -0
  353. package/dist/native-agent-interruption-validation.js +107 -0
  354. package/dist/native-agent-interruption-validation.js.map +1 -0
  355. package/dist/native-agent-interruption.d.ts +55 -0
  356. package/dist/native-agent-interruption.d.ts.map +1 -0
  357. package/dist/native-agent-interruption.js +85 -0
  358. package/dist/native-agent-interruption.js.map +1 -0
  359. package/dist/native-agent-interruption.types.d.ts +5 -0
  360. package/dist/native-agent-interruption.types.d.ts.map +1 -0
  361. package/dist/native-agent-interruption.types.js +2 -0
  362. package/dist/native-agent-interruption.types.js.map +1 -0
  363. package/dist/persistence-error.d.ts +17 -0
  364. package/dist/persistence-error.d.ts.map +1 -0
  365. package/dist/persistence-error.js +17 -0
  366. package/dist/persistence-error.js.map +1 -0
  367. package/dist/persistence-symbol.d.ts +3 -0
  368. package/dist/persistence-symbol.d.ts.map +1 -0
  369. package/dist/persistence-symbol.js +3 -0
  370. package/dist/persistence-symbol.js.map +1 -0
  371. package/dist/runtime-approval-decision.d.ts +13 -0
  372. package/dist/runtime-approval-decision.d.ts.map +1 -0
  373. package/dist/runtime-approval-decision.js +21 -0
  374. package/dist/runtime-approval-decision.js.map +1 -0
  375. package/dist/runtime-dependencies.d.ts +7 -0
  376. package/dist/runtime-dependencies.d.ts.map +1 -0
  377. package/dist/runtime-dependencies.js +10 -0
  378. package/dist/runtime-dependencies.js.map +1 -0
  379. package/dist/runtime-effect-error.d.ts +18 -0
  380. package/dist/runtime-effect-error.d.ts.map +1 -0
  381. package/dist/runtime-effect-error.js +19 -0
  382. package/dist/runtime-effect-error.js.map +1 -0
  383. package/dist/runtime-errors.d.ts +11 -0
  384. package/dist/runtime-errors.d.ts.map +1 -0
  385. package/dist/runtime-errors.js +15 -0
  386. package/dist/runtime-errors.js.map +1 -0
  387. package/dist/runtime-failure-diagnostics.d.ts +10 -0
  388. package/dist/runtime-failure-diagnostics.d.ts.map +1 -0
  389. package/dist/runtime-failure-diagnostics.js +61 -0
  390. package/dist/runtime-failure-diagnostics.js.map +1 -0
  391. package/dist/runtime-integration.d.ts +10 -0
  392. package/dist/runtime-integration.d.ts.map +1 -0
  393. package/dist/runtime-integration.js +9 -0
  394. package/dist/runtime-integration.js.map +1 -0
  395. package/dist/runtime-invoke.d.ts +27 -0
  396. package/dist/runtime-invoke.d.ts.map +1 -0
  397. package/dist/runtime-invoke.js +77 -0
  398. package/dist/runtime-invoke.js.map +1 -0
  399. package/dist/runtime-loop-context.types.d.ts +22 -0
  400. package/dist/runtime-loop-context.types.d.ts.map +1 -0
  401. package/dist/runtime-loop-context.types.js +2 -0
  402. package/dist/runtime-loop-context.types.js.map +1 -0
  403. package/dist/runtime-loop-execution.d.ts +4 -0
  404. package/dist/runtime-loop-execution.d.ts.map +1 -0
  405. package/dist/runtime-loop-execution.js +61 -0
  406. package/dist/runtime-loop-execution.js.map +1 -0
  407. package/dist/runtime-loop-state.d.ts +13 -0
  408. package/dist/runtime-loop-state.d.ts.map +1 -0
  409. package/dist/runtime-loop-state.js +57 -0
  410. package/dist/runtime-loop-state.js.map +1 -0
  411. package/dist/runtime-loop-telemetry.d.ts +5 -0
  412. package/dist/runtime-loop-telemetry.d.ts.map +1 -0
  413. package/dist/runtime-loop-telemetry.js +62 -0
  414. package/dist/runtime-loop-telemetry.js.map +1 -0
  415. package/dist/runtime-loop-values.d.ts +52 -0
  416. package/dist/runtime-loop-values.d.ts.map +1 -0
  417. package/dist/runtime-loop-values.js +85 -0
  418. package/dist/runtime-loop-values.js.map +1 -0
  419. package/dist/runtime-loop.d.ts +36 -0
  420. package/dist/runtime-loop.d.ts.map +1 -0
  421. package/dist/runtime-loop.js +45 -0
  422. package/dist/runtime-loop.js.map +1 -0
  423. package/dist/runtime-loop.types.d.ts +8 -0
  424. package/dist/runtime-loop.types.d.ts.map +1 -0
  425. package/dist/runtime-loop.types.js +3 -0
  426. package/dist/runtime-loop.types.js.map +1 -0
  427. package/dist/runtime-model-error.d.ts +17 -0
  428. package/dist/runtime-model-error.d.ts.map +1 -0
  429. package/dist/runtime-model-error.js +17 -0
  430. package/dist/runtime-model-error.js.map +1 -0
  431. package/dist/runtime-model.d.ts +31 -0
  432. package/dist/runtime-model.d.ts.map +1 -0
  433. package/dist/runtime-model.js +126 -0
  434. package/dist/runtime-model.js.map +1 -0
  435. package/dist/runtime-model.types.d.ts +22 -0
  436. package/dist/runtime-model.types.d.ts.map +1 -0
  437. package/dist/runtime-model.types.js +3 -0
  438. package/dist/runtime-model.types.js.map +1 -0
  439. package/dist/runtime-native-agent-build.d.ts +40 -0
  440. package/dist/runtime-native-agent-build.d.ts.map +1 -0
  441. package/dist/runtime-native-agent-build.js +77 -0
  442. package/dist/runtime-native-agent-build.js.map +1 -0
  443. package/dist/runtime-native-agent.d.ts +30 -0
  444. package/dist/runtime-native-agent.d.ts.map +1 -0
  445. package/dist/runtime-native-agent.js +84 -0
  446. package/dist/runtime-native-agent.js.map +1 -0
  447. package/dist/runtime-native-agent.types.d.ts +21 -0
  448. package/dist/runtime-native-agent.types.d.ts.map +1 -0
  449. package/dist/runtime-native-agent.types.js +3 -0
  450. package/dist/runtime-native-agent.types.js.map +1 -0
  451. package/dist/runtime-native-event-tools.d.ts +28 -0
  452. package/dist/runtime-native-event-tools.d.ts.map +1 -0
  453. package/dist/runtime-native-event-tools.js +88 -0
  454. package/dist/runtime-native-event-tools.js.map +1 -0
  455. package/dist/runtime-native-events-helpers.d.ts +30 -0
  456. package/dist/runtime-native-events-helpers.d.ts.map +1 -0
  457. package/dist/runtime-native-events-helpers.js +74 -0
  458. package/dist/runtime-native-events-helpers.js.map +1 -0
  459. package/dist/runtime-native-events.d.ts +45 -0
  460. package/dist/runtime-native-events.d.ts.map +1 -0
  461. package/dist/runtime-native-events.js +89 -0
  462. package/dist/runtime-native-events.js.map +1 -0
  463. package/dist/runtime-native-limits.d.ts +18 -0
  464. package/dist/runtime-native-limits.d.ts.map +1 -0
  465. package/dist/runtime-native-limits.js +59 -0
  466. package/dist/runtime-native-limits.js.map +1 -0
  467. package/dist/runtime-native-messages.d.ts +24 -0
  468. package/dist/runtime-native-messages.d.ts.map +1 -0
  469. package/dist/runtime-native-messages.js +83 -0
  470. package/dist/runtime-native-messages.js.map +1 -0
  471. package/dist/runtime-native-messages.types.d.ts +7 -0
  472. package/dist/runtime-native-messages.types.d.ts.map +1 -0
  473. package/dist/runtime-native-messages.types.js +2 -0
  474. package/dist/runtime-native-messages.types.js.map +1 -0
  475. package/dist/runtime-native-public-state.d.ts +22 -0
  476. package/dist/runtime-native-public-state.d.ts.map +1 -0
  477. package/dist/runtime-native-public-state.js +44 -0
  478. package/dist/runtime-native-public-state.js.map +1 -0
  479. package/dist/runtime-native-public-tools.d.ts +15 -0
  480. package/dist/runtime-native-public-tools.d.ts.map +1 -0
  481. package/dist/runtime-native-public-tools.js +39 -0
  482. package/dist/runtime-native-public-tools.js.map +1 -0
  483. package/dist/runtime-native-public.d.ts +28 -0
  484. package/dist/runtime-native-public.d.ts.map +1 -0
  485. package/dist/runtime-native-public.js +165 -0
  486. package/dist/runtime-native-public.js.map +1 -0
  487. package/dist/runtime-native-public.types.d.ts +5 -0
  488. package/dist/runtime-native-public.types.d.ts.map +1 -0
  489. package/dist/runtime-native-public.types.js +3 -0
  490. package/dist/runtime-native-public.types.js.map +1 -0
  491. package/dist/runtime-native-response-format.d.ts +15 -0
  492. package/dist/runtime-native-response-format.d.ts.map +1 -0
  493. package/dist/runtime-native-response-format.js +46 -0
  494. package/dist/runtime-native-response-format.js.map +1 -0
  495. package/dist/runtime-native-subagents.d.ts +47 -0
  496. package/dist/runtime-native-subagents.d.ts.map +1 -0
  497. package/dist/runtime-native-subagents.js +50 -0
  498. package/dist/runtime-native-subagents.js.map +1 -0
  499. package/dist/runtime-native-subagents.types.d.ts +7 -0
  500. package/dist/runtime-native-subagents.types.d.ts.map +1 -0
  501. package/dist/runtime-native-subagents.types.js +2 -0
  502. package/dist/runtime-native-subagents.types.js.map +1 -0
  503. package/dist/runtime-native-support.d.ts +67 -0
  504. package/dist/runtime-native-support.d.ts.map +1 -0
  505. package/dist/runtime-native-support.js +112 -0
  506. package/dist/runtime-native-support.js.map +1 -0
  507. package/dist/runtime-native-support.types.d.ts +9 -0
  508. package/dist/runtime-native-support.types.d.ts.map +1 -0
  509. package/dist/runtime-native-support.types.js +2 -0
  510. package/dist/runtime-native-support.types.js.map +1 -0
  511. package/dist/runtime-native-tool-build.d.ts +12 -0
  512. package/dist/runtime-native-tool-build.d.ts.map +1 -0
  513. package/dist/runtime-native-tool-build.js +81 -0
  514. package/dist/runtime-native-tool-build.js.map +1 -0
  515. package/dist/runtime-native-tool-build.types.d.ts +14 -0
  516. package/dist/runtime-native-tool-build.types.d.ts.map +1 -0
  517. package/dist/runtime-native-tool-build.types.js +2 -0
  518. package/dist/runtime-native-tool-build.types.js.map +1 -0
  519. package/dist/runtime-native-tools-identity.d.ts +15 -0
  520. package/dist/runtime-native-tools-identity.d.ts.map +1 -0
  521. package/dist/runtime-native-tools-identity.js +14 -0
  522. package/dist/runtime-native-tools-identity.js.map +1 -0
  523. package/dist/runtime-native-tools.d.ts +29 -0
  524. package/dist/runtime-native-tools.d.ts.map +1 -0
  525. package/dist/runtime-native-tools.js +65 -0
  526. package/dist/runtime-native-tools.js.map +1 -0
  527. package/dist/runtime-native-tools.types.d.ts +21 -0
  528. package/dist/runtime-native-tools.types.d.ts.map +1 -0
  529. package/dist/runtime-native-tools.types.js +3 -0
  530. package/dist/runtime-native-tools.types.js.map +1 -0
  531. package/dist/runtime-service.d.ts +15 -0
  532. package/dist/runtime-service.d.ts.map +1 -0
  533. package/dist/runtime-service.js +20 -0
  534. package/dist/runtime-service.js.map +1 -0
  535. package/dist/runtime-service.types.d.ts +12 -0
  536. package/dist/runtime-service.types.d.ts.map +1 -0
  537. package/dist/runtime-service.types.js +3 -0
  538. package/dist/runtime-service.types.js.map +1 -0
  539. package/dist/runtime-state-schemas.d.ts +19 -0
  540. package/dist/runtime-state-schemas.d.ts.map +1 -0
  541. package/dist/runtime-state-schemas.js +58 -0
  542. package/dist/runtime-state-schemas.js.map +1 -0
  543. package/dist/runtime-strict-response-schema.d.ts +9 -0
  544. package/dist/runtime-strict-response-schema.d.ts.map +1 -0
  545. package/dist/runtime-strict-response-schema.js +67 -0
  546. package/dist/runtime-strict-response-schema.js.map +1 -0
  547. package/dist/runtime-tool-adapter.d.ts +34 -0
  548. package/dist/runtime-tool-adapter.d.ts.map +1 -0
  549. package/dist/runtime-tool-adapter.js +66 -0
  550. package/dist/runtime-tool-adapter.js.map +1 -0
  551. package/dist/runtime-tool-dispatcher.d.ts +32 -0
  552. package/dist/runtime-tool-dispatcher.d.ts.map +1 -0
  553. package/dist/runtime-tool-dispatcher.js +67 -0
  554. package/dist/runtime-tool-dispatcher.js.map +1 -0
  555. package/dist/runtime-tool-events.d.ts +49 -0
  556. package/dist/runtime-tool-events.d.ts.map +1 -0
  557. package/dist/runtime-tool-events.js +106 -0
  558. package/dist/runtime-tool-events.js.map +1 -0
  559. package/dist/runtime-tool-events.types.d.ts +8 -0
  560. package/dist/runtime-tool-events.types.d.ts.map +1 -0
  561. package/dist/runtime-tool-events.types.js +3 -0
  562. package/dist/runtime-tool-events.types.js.map +1 -0
  563. package/dist/runtime-tool-invocation.d.ts +19 -0
  564. package/dist/runtime-tool-invocation.d.ts.map +1 -0
  565. package/dist/runtime-tool-invocation.js +74 -0
  566. package/dist/runtime-tool-invocation.js.map +1 -0
  567. package/dist/runtime-tool-lookup.d.ts +56 -0
  568. package/dist/runtime-tool-lookup.d.ts.map +1 -0
  569. package/dist/runtime-tool-lookup.js +71 -0
  570. package/dist/runtime-tool-lookup.js.map +1 -0
  571. package/dist/runtime-tools.d.ts +35 -0
  572. package/dist/runtime-tools.d.ts.map +1 -0
  573. package/dist/runtime-tools.js +78 -0
  574. package/dist/runtime-tools.js.map +1 -0
  575. package/dist/runtime-tools.types.d.ts +7 -0
  576. package/dist/runtime-tools.types.d.ts.map +1 -0
  577. package/dist/runtime-tools.types.js +2 -0
  578. package/dist/runtime-tools.types.js.map +1 -0
  579. package/dist/runtime-utils.d.ts +56 -0
  580. package/dist/runtime-utils.d.ts.map +1 -0
  581. package/dist/runtime-utils.js +106 -0
  582. package/dist/runtime-utils.js.map +1 -0
  583. package/dist/runtime.d.ts +47 -0
  584. package/dist/runtime.d.ts.map +1 -0
  585. package/dist/runtime.js +90 -0
  586. package/dist/runtime.js.map +1 -0
  587. package/dist/runtime.types.d.ts +77 -0
  588. package/dist/runtime.types.d.ts.map +1 -0
  589. package/dist/runtime.types.js +3 -0
  590. package/dist/runtime.types.js.map +1 -0
  591. package/dist/signal-deadline.d.ts +12 -0
  592. package/dist/signal-deadline.d.ts.map +1 -0
  593. package/dist/signal-deadline.js +21 -0
  594. package/dist/signal-deadline.js.map +1 -0
  595. package/dist/signal.d.ts +64 -0
  596. package/dist/signal.d.ts.map +1 -0
  597. package/dist/signal.js +136 -0
  598. package/dist/signal.js.map +1 -0
  599. package/dist/signal.types.d.ts +35 -0
  600. package/dist/signal.types.d.ts.map +1 -0
  601. package/dist/signal.types.js +3 -0
  602. package/dist/signal.types.js.map +1 -0
  603. package/dist/testing/agent-approvals.d.ts +8 -0
  604. package/dist/testing/agent-approvals.d.ts.map +1 -0
  605. package/dist/testing/agent-approvals.js +98 -0
  606. package/dist/testing/agent-approvals.js.map +1 -0
  607. package/dist/testing/agent-approvals.types.d.ts +24 -0
  608. package/dist/testing/agent-approvals.types.d.ts.map +1 -0
  609. package/dist/testing/agent-approvals.types.js +3 -0
  610. package/dist/testing/agent-approvals.types.js.map +1 -0
  611. package/dist/testing/agent-harness.types.d.ts +25 -0
  612. package/dist/testing/agent-harness.types.d.ts.map +1 -0
  613. package/dist/testing/agent-harness.types.js +3 -0
  614. package/dist/testing/agent-harness.types.js.map +1 -0
  615. package/dist/testing/agent-state-invocation.d.ts +4 -0
  616. package/dist/testing/agent-state-invocation.d.ts.map +1 -0
  617. package/dist/testing/agent-state-invocation.js +41 -0
  618. package/dist/testing/agent-state-invocation.js.map +1 -0
  619. package/dist/testing/agent-state-lifecycle.d.ts +6 -0
  620. package/dist/testing/agent-state-lifecycle.d.ts.map +1 -0
  621. package/dist/testing/agent-state-lifecycle.js +36 -0
  622. package/dist/testing/agent-state-lifecycle.js.map +1 -0
  623. package/dist/testing/agent-state-setup.d.ts +18 -0
  624. package/dist/testing/agent-state-setup.d.ts.map +1 -0
  625. package/dist/testing/agent-state-setup.js +52 -0
  626. package/dist/testing/agent-state-setup.js.map +1 -0
  627. package/dist/testing/agent-state.d.ts +12 -0
  628. package/dist/testing/agent-state.d.ts.map +1 -0
  629. package/dist/testing/agent-state.js +40 -0
  630. package/dist/testing/agent-state.js.map +1 -0
  631. package/dist/testing/agents-model-native.d.ts +37 -0
  632. package/dist/testing/agents-model-native.d.ts.map +1 -0
  633. package/dist/testing/agents-model-native.js +111 -0
  634. package/dist/testing/agents-model-native.js.map +1 -0
  635. package/dist/testing/agents-model-operations.d.ts +28 -0
  636. package/dist/testing/agents-model-operations.d.ts.map +1 -0
  637. package/dist/testing/agents-model-operations.js +91 -0
  638. package/dist/testing/agents-model-operations.js.map +1 -0
  639. package/dist/testing/agents-model.d.ts +25 -0
  640. package/dist/testing/agents-model.d.ts.map +1 -0
  641. package/dist/testing/agents-model.js +72 -0
  642. package/dist/testing/agents-model.js.map +1 -0
  643. package/dist/testing/agents-model.types.d.ts +24 -0
  644. package/dist/testing/agents-model.types.d.ts.map +1 -0
  645. package/dist/testing/agents-model.types.js +3 -0
  646. package/dist/testing/agents-model.types.js.map +1 -0
  647. package/dist/testing/agents-types.d.ts +3 -0
  648. package/dist/testing/agents-types.d.ts.map +1 -0
  649. package/dist/testing/agents-types.js +2 -0
  650. package/dist/testing/agents-types.js.map +1 -0
  651. package/dist/testing/agents-utils.d.ts +26 -0
  652. package/dist/testing/agents-utils.d.ts.map +1 -0
  653. package/dist/testing/agents-utils.js +79 -0
  654. package/dist/testing/agents-utils.js.map +1 -0
  655. package/dist/testing/agents.d.ts +26 -0
  656. package/dist/testing/agents.d.ts.map +1 -0
  657. package/dist/testing/agents.js +64 -0
  658. package/dist/testing/agents.js.map +1 -0
  659. package/dist/testing/agents.types.d.ts +113 -0
  660. package/dist/testing/agents.types.d.ts.map +1 -0
  661. package/dist/testing/agents.types.js +3 -0
  662. package/dist/testing/agents.types.js.map +1 -0
  663. package/package.json +191 -4
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-read.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-read.ts"],"names":[],"mappings":"AAAA,2HAA2H;AAE3H,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAwB,MAAM,+BAA+B,CAAC;AAQtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;iFAO/B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,CAAC,CAWxB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;iFA2B5B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,SAAI,EACV,KAAK,SAAM,GACV,OAAO,CAAC,UAAU,CAAC,CAWrB"}
@@ -0,0 +1,77 @@
1
+ /** Reads normalized native files from the selected bucket, applying the backend's content and missing-file conventions. */
2
+ import { Effect } from "effect";
3
+ import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
4
+ import { DeepAgentBucket, deepAgentBucketLayer } from "./deepagent-bucket-service.js";
5
+ import { readFileDataEffect } from "./deepagent-bucket-file-data.js";
6
+ import { errorMessage, isControlFailure, isTextMimeType, normalizedPage, } from "./deepagent-bucket-files.js";
7
+ /** Reads the full file payload from the current bucket service.
8
+ * @param path - Virtual file path.
9
+ * @returns An Effect with raw data or a tagged bucket failure.
10
+ * @example Effect.runPromise(Effect.provide(readBucketRawEffect("/a.md"), deepAgentBucketLayer(context)));
11
+ */
12
+ export const readBucketRawEffect = Effect.fn("Agents.bucket.readRaw")(function* (path) {
13
+ yield* DeepAgentBucket;
14
+ const data = yield* readFileDataEffect(path);
15
+ return data === undefined ? { error: `File '${path}' not found` } : { data };
16
+ }, (effect) => observeAgent("bucket.read-raw", effect));
17
+ /** Reads the full file payload for existing DeepAgents Promise callers.
18
+ * @param context - Bound bucket client and prefix.
19
+ * @param path - Virtual file path.
20
+ * @returns Raw data or a legacy error result.
21
+ * @throws A cancellation or timeout failure from the bucket client.
22
+ * @example await readBucketRaw(context, "/a.md");
23
+ */
24
+ export function readBucketRaw(context, path) {
25
+ return Effect.runPromise(readBucketRawEffect(path).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => isControlFailure(failure.cause)
26
+ ? Effect.fail(failure.cause)
27
+ : Effect.succeed({ error: errorMessage(failure.cause) })), Effect.provide(deepAgentBucketLayer(context))));
28
+ }
29
+ /** Reads a paged text file or an unmodified binary payload.
30
+ * @param path - Virtual file path.
31
+ * @param offset - Zero-based text line offset.
32
+ * @param limit - Maximum number of text lines.
33
+ * @returns An Effect with page data or a tagged bucket failure.
34
+ * @example Effect.runPromise(Effect.provide(readBucketEffect("/a.md", 0, 50), deepAgentBucketLayer(context)));
35
+ */
36
+ export const readBucketEffect = Effect.fn("Agents.bucket.read")(function* (path, offset = 0, limit = 500) {
37
+ yield* DeepAgentBucket;
38
+ const data = yield* readFileDataEffect(path);
39
+ if (data === undefined)
40
+ return { error: `File '${path}' not found` };
41
+ if (!isTextMimeType(data.mimeType))
42
+ return { content: data.content, mimeType: data.mimeType };
43
+ if (typeof data.content !== "string") {
44
+ return { error: `File '${path}' has binary content but text MIME type` };
45
+ }
46
+ const page = normalizedPage(offset, limit);
47
+ const lines = data.content.split("\n");
48
+ const totalLines = lines.at(-1) === "" ? lines.length - 1 : lines.length;
49
+ const selected = lines.slice(page.offset, page.offset + page.limit);
50
+ if (selected.length === 0 || page.offset >= totalLines || page.limit === 0) {
51
+ return { content: selected.join("\n"), mimeType: data.mimeType };
52
+ }
53
+ const endLine = Math.min(page.offset + selected.length, totalLines);
54
+ return {
55
+ content: selected.join("\n"),
56
+ mimeType: data.mimeType,
57
+ totalLines,
58
+ startLine: page.offset + 1,
59
+ endLine,
60
+ ...(endLine < totalLines ? { nextOffset: endLine } : {}),
61
+ };
62
+ }, (effect) => observeAgent("bucket.read", effect));
63
+ /** Reads a file for existing DeepAgents Promise callers.
64
+ * @param context - Bound bucket client and prefix.
65
+ * @param path - Virtual file path.
66
+ * @param offset - Zero-based text line offset.
67
+ * @param limit - Maximum number of text lines.
68
+ * @returns A text page, binary content, or legacy error result.
69
+ * @throws A cancellation or timeout failure from the bucket client.
70
+ * @example await readBucket(context, "/a.md", 0, 50);
71
+ */
72
+ export function readBucket(context, path, offset = 0, limit = 500) {
73
+ return Effect.runPromise(readBucketEffect(path, offset, limit).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => isControlFailure(failure.cause)
74
+ ? Effect.fail(failure.cause)
75
+ : Effect.succeed({ error: errorMessage(failure.cause) })), Effect.provide(deepAgentBucketLayer(context))));
76
+ }
77
+ //# sourceMappingURL=deepagent-bucket-read.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-read.js","sourceRoot":"","sources":["../src/deepagent-bucket-read.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ /** Owns bucket backend access for an agent invocation and closes acquired resources only after the scoped operation settles. */
2
+ import { Effect } from "effect";
3
+ import type { DeepAgentBucketClient } from "./deepagent-bucket-files.js";
4
+ /** Creates a private filesystem partition for one exact agent thread.
5
+ * @param bucket - Bucket client shared by thread backends.
6
+ * @param agentId - Agent identity included in the private prefix.
7
+ * @param threadId - Required thread identity.
8
+ * @returns An Effect with a thread backend or DeepAgentBucketFailure.
9
+ * @example Effect.runSync(createThreadBucketBackendEffect(bucket, "agent", "thread"));
10
+ */
11
+ export declare const createThreadBucketBackendEffect: (bucket: DeepAgentBucketClient, agentId: string, threadId: string) => Effect.Effect<Readonly<{
12
+ ls: (path: string) => Promise<import("deepagents").LsResult>;
13
+ read: (path: string, offset?: number, limit?: number) => Promise<import("deepagents").ReadResult>;
14
+ readRaw: (path: string) => Promise<import("deepagents").ReadRawResult>;
15
+ write: (path: string, content: string) => Promise<import("deepagents").WriteResult>;
16
+ edit: (path: string, oldText: string, newText: string, replaceAll?: boolean) => Promise<import("deepagents").EditResult>;
17
+ grep: (pattern: string, path?: string | null, glob?: string | null, maxCount?: number | null) => Promise<import("deepagents").GrepResult>;
18
+ glob: (pattern: string, path?: string) => Promise<import("deepagents").GlobResult>;
19
+ delete: (path: string) => Promise<import("deepagents").DeleteResult>;
20
+ uploadFiles: (files: Array<[string, Uint8Array]>) => Promise<import("deepagents").FileUploadResponse[]>;
21
+ downloadFiles: (paths: string[]) => Promise<import("deepagents").FileDownloadResponse[]>;
22
+ }>, import("./deepagent-bucket-error.js").DeepAgentBucketFailure, never>;
23
+ /** Creates a private thread backend for existing synchronous callers.
24
+ * @param bucket - Bucket client shared by thread backends.
25
+ * @param agentId - Agent identity included in the private prefix.
26
+ * @param threadId - Required thread identity.
27
+ * @returns A backend scoped to the agent and thread.
28
+ * @throws The original invalid bucket or thread error.
29
+ * @example const backend = createThreadBucketBackend(bucket, "agent", "thread");
30
+ */
31
+ export declare function createThreadBucketBackend(bucket: DeepAgentBucketClient, agentId: string, threadId: string): Readonly<{
32
+ ls: (path: string) => Promise<import("deepagents").LsResult>;
33
+ read: (path: string, offset?: number, limit?: number) => Promise<import("deepagents").ReadResult>;
34
+ readRaw: (path: string) => Promise<import("deepagents").ReadRawResult>;
35
+ write: (path: string, content: string) => Promise<import("deepagents").WriteResult>;
36
+ edit: (path: string, oldText: string, newText: string, replaceAll?: boolean) => Promise<import("deepagents").EditResult>;
37
+ grep: (pattern: string, path?: string | null, glob?: string | null, maxCount?: number | null) => Promise<import("deepagents").GrepResult>;
38
+ glob: (pattern: string, path?: string) => Promise<import("deepagents").GlobResult>;
39
+ delete: (path: string) => Promise<import("deepagents").DeleteResult>;
40
+ uploadFiles: (files: Array<[string, Uint8Array]>) => Promise<import("deepagents").FileUploadResponse[]>;
41
+ downloadFiles: (paths: string[]) => Promise<import("deepagents").FileDownloadResponse[]>;
42
+ }>;
43
+ //# sourceMappingURL=deepagent-bucket-scope.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-scope.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-scope.ts"],"names":[],"mappings":"AAAA,gIAAgI;AAGhI,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;wEAc3C,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM;;;;;;;;;;;GAOjB"}
@@ -0,0 +1,40 @@
1
+ /** Owns bucket backend access for an agent invocation and closes acquired resources only after the scoped operation settles. */
2
+ import { createHash } from "node:crypto";
3
+ import { Effect } from "effect";
4
+ import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
5
+ import { createDeepAgentBucketBackendEffect } from "./deepagent-bucket-backend.js";
6
+ import { deepAgentBucketFailure } from "./deepagent-bucket-error.js";
7
+ /** Creates a private filesystem partition for one exact agent thread.
8
+ * @param bucket - Bucket client shared by thread backends.
9
+ * @param agentId - Agent identity included in the private prefix.
10
+ * @param threadId - Required thread identity.
11
+ * @returns An Effect with a thread backend or DeepAgentBucketFailure.
12
+ * @example Effect.runSync(createThreadBucketBackendEffect(bucket, "agent", "thread"));
13
+ */
14
+ export const createThreadBucketBackendEffect = Effect.fn("Agents.bucket.thread")(function* (bucket, agentId, threadId) {
15
+ const prefix = yield* Effect.try({
16
+ try: () => {
17
+ if (typeof threadId !== "string" || threadId.length === 0) {
18
+ throw new TypeError("DeepAgents bucket backend requires threadId");
19
+ }
20
+ return `agents/${digest(agentId)}/threads/${digest(threadId)}`;
21
+ },
22
+ catch: deepAgentBucketFailure,
23
+ });
24
+ return yield* createDeepAgentBucketBackendEffect(bucket, { prefix });
25
+ }, (effect) => observeAgent("bucket.thread", effect));
26
+ /** Creates a private thread backend for existing synchronous callers.
27
+ * @param bucket - Bucket client shared by thread backends.
28
+ * @param agentId - Agent identity included in the private prefix.
29
+ * @param threadId - Required thread identity.
30
+ * @returns A backend scoped to the agent and thread.
31
+ * @throws The original invalid bucket or thread error.
32
+ * @example const backend = createThreadBucketBackend(bucket, "agent", "thread");
33
+ */
34
+ export function createThreadBucketBackend(bucket, agentId, threadId) {
35
+ return Effect.runSync(createThreadBucketBackendEffect(bucket, agentId, threadId).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => Effect.fail(failure.cause))));
36
+ }
37
+ function digest(value) {
38
+ return createHash("sha256").update(value).digest("hex");
39
+ }
40
+ //# sourceMappingURL=deepagent-bucket-scope.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-scope.js","sourceRoot":"","sources":["../src/deepagent-bucket-scope.ts"],"names":[],"mappings":"AAAA,gIAAgI;AAEhI,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAC9E,QAAQ,CAAC,EAAE,MAA6B,EAAE,OAAe,EAAE,QAAgB;IACzE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC/B,GAAG,EAAE,GAAG,EAAE;YACR,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1D,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,UAAU,MAAM,CAAC,OAAO,CAAC,YAAY,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjE,CAAC;QACD,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,CAAC,kCAAkC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACvE,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAClD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAA6B,EAC7B,OAAe,EACf,QAAgB;IAEhB,OAAO,MAAM,CAAC,OAAO,CACnB,+BAA+B,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,CAC7D,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACnF,CACF,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}
@@ -0,0 +1,22 @@
1
+ /** Coordinates native bucket listing and content search, sharing normalized paths and file metadata with the read backend. */
2
+ import type { FileInfo, LsResult } from "deepagents";
3
+ import { Effect } from "effect";
4
+ import { DeepAgentBucket } from "./deepagent-bucket-service.js";
5
+ import { type DeepAgentBucketContext } from "./deepagent-bucket-files.js";
6
+ /** Lists direct files and child directories through bounded metadata IO.
7
+ * @param path - Virtual directory to list.
8
+ * @returns An Effect with ordered files or DeepAgentBucketFailure.
9
+ * @example Effect.runPromise(Effect.provide(listDirectoryEffect("/"), deepAgentBucketLayer(context)));
10
+ */
11
+ export declare const listDirectoryEffect: (path: string) => Effect.Effect<{
12
+ files: FileInfo[];
13
+ }, import("./deepagent-bucket-error.js").DeepAgentBucketFailure, DeepAgentBucket>;
14
+ /** Lists a virtual directory for existing DeepAgents Promise callers.
15
+ * @param context - Bound bucket client and prefix.
16
+ * @param path - Virtual directory to list.
17
+ * @returns Ordered files or an error result.
18
+ * @throws A cancellation or control failure.
19
+ * @example await listDirectory(context, "/notes");
20
+ */
21
+ export declare function listDirectory(context: DeepAgentBucketContext, path: string): Promise<LsResult>;
22
+ //# sourceMappingURL=deepagent-bucket-search.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-search.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-search.ts"],"names":[],"mappings":"AAAA,8HAA8H;AAE9H,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAGxC,OAAO,EAAE,eAAe,EAAwB,MAAM,+BAA+B,CAAC;AACtF,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,6BAA6B,CAAC;AAGrC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;iFAoC/B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAW9F"}
@@ -0,0 +1,60 @@
1
+ /** Coordinates native bucket listing and content search, sharing normalized paths and file metadata with the read backend. */
2
+ import { Effect, Result } from "effect";
3
+ import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
4
+ import { deepAgentBucketFailure } from "./deepagent-bucket-error.js";
5
+ import { DeepAgentBucket, deepAgentBucketLayer } from "./deepagent-bucket-service.js";
6
+ import { errorMessage, isControlFailure, virtualPath, } from "./deepagent-bucket-files.js";
7
+ import { infoForEffect } from "./deepagent-bucket-file-index.js";
8
+ /** Lists direct files and child directories through bounded metadata IO.
9
+ * @param path - Virtual directory to list.
10
+ * @returns An Effect with ordered files or DeepAgentBucketFailure.
11
+ * @example Effect.runPromise(Effect.provide(listDirectoryEffect("/"), deepAgentBucketLayer(context)));
12
+ */
13
+ export const listDirectoryEffect = Effect.fn("Agents.bucket.list")(function* (path) {
14
+ const context = yield* DeepAgentBucket;
15
+ const directory = yield* Effect.try({
16
+ try: () => virtualPath(path, true),
17
+ catch: deepAgentBucketFailure,
18
+ });
19
+ const keyPrefix = directory === "/" ? `${context.prefix}/` : `${context.prefix}${directory}`;
20
+ const keys = [
21
+ ...(yield* Effect.tryPromise({
22
+ try: () => context.bucket.list(keyPrefix),
23
+ catch: deepAgentBucketFailure,
24
+ })),
25
+ ].sort();
26
+ const directories = new Set();
27
+ const direct = [];
28
+ for (const key of keys) {
29
+ const relative = key.slice(keyPrefix.length);
30
+ const separator = relative.indexOf("/");
31
+ if (separator >= 0)
32
+ directories.add(relative.slice(0, separator));
33
+ else if (relative !== "")
34
+ direct.push(key);
35
+ }
36
+ const outcomes = yield* Effect.forEach(direct, (key) => Effect.result(infoForEffect(key)), {
37
+ concurrency: 8,
38
+ });
39
+ const firstFailure = outcomes.find(Result.isFailure);
40
+ if (firstFailure !== undefined)
41
+ return yield* Effect.fail(firstFailure.failure);
42
+ const files = outcomes.flatMap((outcome) => Result.isSuccess(outcome) && outcome.success !== undefined ? [outcome.success] : []);
43
+ for (const name of directories) {
44
+ files.push({ path: `${directory}${name}/`, is_dir: true, size: 0, modified_at: "" });
45
+ }
46
+ return { files: files.sort((left, right) => left.path.localeCompare(right.path)) };
47
+ }, (effect) => observeAgent("bucket.list", effect));
48
+ /** Lists a virtual directory for existing DeepAgents Promise callers.
49
+ * @param context - Bound bucket client and prefix.
50
+ * @param path - Virtual directory to list.
51
+ * @returns Ordered files or an error result.
52
+ * @throws A cancellation or control failure.
53
+ * @example await listDirectory(context, "/notes");
54
+ */
55
+ export function listDirectory(context, path) {
56
+ return Effect.runPromise(listDirectoryEffect(path).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => isControlFailure(failure.cause)
57
+ ? Effect.fail(failure.cause)
58
+ : Effect.succeed({ error: errorMessage(failure.cause) })), Effect.provide(deepAgentBucketLayer(context))));
59
+ }
60
+ //# sourceMappingURL=deepagent-bucket-search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-search.js","sourceRoot":"","sources":["../src/deepagent-bucket-search.ts"],"names":[],"mappings":"AAAA,8HAA8H;AAG9H,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,WAAW,GAEZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAChE,QAAQ,CAAC,EAAE,IAAY;IACrB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAClC,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;QAClC,KAAK,EAAE,sBAAsB;KAC9B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;IAC7F,MAAM,IAAI,GAAG;QACX,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YAC3B,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;YACzC,KAAK,EAAE,sBAAsB;SAC9B,CAAC,CAAC;KACJ,CAAC,IAAI,EAAE,CAAC;IACT,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,SAAS,IAAI,CAAC;YAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;aAC7D,IAAI,QAAQ,KAAK,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE;QACzF,WAAW,EAAE,CAAC;KACf,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACrD,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAChF,MAAM,KAAK,GAAe,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACrD,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CACpF,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,SAAS,GAAG,IAAI,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AACrF,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAChD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAA+B,EAAE,IAAY;IACzE,OAAO,MAAM,CAAC,UAAU,CACtB,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,CAC5B,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE,CACpD,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAC5B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAC3D,EACD,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAC9C,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,17 @@
1
+ /** Provides the Effect service used by native bucket operations, translating selected provider access into the backend's typed operation boundary. */
2
+ import { Context, Layer } from "effect";
3
+ import type { DeepAgentBucketContext } from "./deepagent-bucket-files.types.js";
4
+ declare const DeepAgentBucket_base: Context.ServiceClass<DeepAgentBucket, "relkit/agents/DeepAgentBucket", DeepAgentBucketContext>;
5
+ /** Injectable bucket context for DeepAgents filesystem operations.
6
+ * @example Effect.provide(listDirectoryEffect("/"), deepAgentBucketLayer(context));
7
+ */
8
+ export declare class DeepAgentBucket extends DeepAgentBucket_base {
9
+ }
10
+ /** Provides one bucket client and path prefix to an Effect operation.
11
+ * @param context - Validated bucket and prefix.
12
+ * @returns A Layer with the bucket service.
13
+ * @example deepAgentBucketLayer({ bucket, prefix: "threads/one" });
14
+ */
15
+ export declare function deepAgentBucketLayer(context: DeepAgentBucketContext): Layer.Layer<DeepAgentBucket, never, never>;
16
+ export {};
17
+ //# sourceMappingURL=deepagent-bucket-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-service.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-service.ts"],"names":[],"mappings":"AAAA,sJAAsJ;AAEtJ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;;AAEhF;;GAEG;AACH,qBAAa,eAAgB,SAAQ,oBAEpC;CAAG;AAEJ;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,8CAEnE"}
@@ -0,0 +1,16 @@
1
+ /** Provides the Effect service used by native bucket operations, translating selected provider access into the backend's typed operation boundary. */
2
+ import { Context, Layer } from "effect";
3
+ /** Injectable bucket context for DeepAgents filesystem operations.
4
+ * @example Effect.provide(listDirectoryEffect("/"), deepAgentBucketLayer(context));
5
+ */
6
+ export class DeepAgentBucket extends Context.Service()("relkit/agents/DeepAgentBucket") {
7
+ }
8
+ /** Provides one bucket client and path prefix to an Effect operation.
9
+ * @param context - Validated bucket and prefix.
10
+ * @returns A Layer with the bucket service.
11
+ * @example deepAgentBucketLayer({ bucket, prefix: "threads/one" });
12
+ */
13
+ export function deepAgentBucketLayer(context) {
14
+ return Layer.succeed(DeepAgentBucket, context);
15
+ }
16
+ //# sourceMappingURL=deepagent-bucket-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-service.js","sourceRoot":"","sources":["../src/deepagent-bucket-service.ts"],"names":[],"mappings":"AAAA,sJAAsJ;AAEtJ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAGxC;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,OAAO,CAAC,OAAO,EAA2C,CAC7F,+BAA+B,CAChC;CAAG;AAEJ;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,OAAO,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC"}
@@ -0,0 +1,52 @@
1
+ /** Transfers native file content between backend requests and bucket objects while retaining per-file success and failure results. */
2
+ import type { FileDownloadResponse, FileUploadResponse } from "deepagents";
3
+ import { Effect } from "effect";
4
+ import { DeepAgentBucket } from "./deepagent-bucket-service.js";
5
+ import type { DeepAgentBucketContext } from "./deepagent-bucket-files.types.js";
6
+ /** Uploads files in input order so repeated paths retain last-write behavior.
7
+ * @param files - Virtual paths and bytes to store.
8
+ * @returns An Effect with one response per file or a tagged control failure.
9
+ * @example Effect.runPromise(Effect.provide(uploadBucketFilesEffect([["/a", bytes]]), deepAgentBucketLayer(context)));
10
+ */
11
+ export declare const uploadBucketFilesEffect: (files: [string, Uint8Array<ArrayBufferLike>][]) => Effect.Effect<({
12
+ path: string;
13
+ error: null;
14
+ } | {
15
+ path: string;
16
+ error: "invalid_path";
17
+ })[], import("./deepagent-bucket-error.js").DeepAgentBucketFailure, DeepAgentBucket>;
18
+ /** Uploads files for existing DeepAgents Promise callers.
19
+ * @param context - Bound bucket client and prefix.
20
+ * @param files - Virtual paths and bytes to store.
21
+ * @returns One response per file in input order.
22
+ * @throws A cancellation or timeout failure from the bucket client.
23
+ * @example await uploadBucketFiles(context, [["/a", bytes]]);
24
+ */
25
+ export declare function uploadBucketFiles(context: DeepAgentBucketContext, files: Array<[string, Uint8Array]>): Promise<FileUploadResponse[]>;
26
+ /** Downloads files in input order with a result for each path.
27
+ * @param paths - Virtual paths to read.
28
+ * @returns An Effect with one response per path or a tagged control failure.
29
+ * @example Effect.runPromise(Effect.provide(downloadBucketFilesEffect(["/a"]), deepAgentBucketLayer(context)));
30
+ */
31
+ export declare const downloadBucketFilesEffect: (paths: string[]) => Effect.Effect<({
32
+ path: string;
33
+ content: null;
34
+ error: "file_not_found";
35
+ } | {
36
+ path: string;
37
+ content: Uint8Array<ArrayBufferLike>;
38
+ error: null;
39
+ } | {
40
+ path: string;
41
+ content: null;
42
+ error: "invalid_path";
43
+ })[], import("./deepagent-bucket-error.js").DeepAgentBucketFailure, DeepAgentBucket>;
44
+ /** Downloads files for existing DeepAgents Promise callers.
45
+ * @param context - Bound bucket client and prefix.
46
+ * @param paths - Virtual paths to read.
47
+ * @returns One response per path in input order.
48
+ * @throws A cancellation or timeout failure from the bucket client.
49
+ * @example await downloadBucketFiles(context, ["/a"]);
50
+ */
51
+ export declare function downloadBucketFiles(context: DeepAgentBucketContext, paths: string[]): Promise<FileDownloadResponse[]>;
52
+ //# sourceMappingURL=deepagent-bucket-transfer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-transfer.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-transfer.ts"],"names":[],"mappings":"AAAA,sIAAsI;AAEtI,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,eAAe,EAAwB,MAAM,+BAA+B,CAAC;AAGtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;oFA4BnC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GACjC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAO/B;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;oFA6BrC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAOjC"}
@@ -0,0 +1,73 @@
1
+ /** Transfers native file content between backend requests and bucket objects while retaining per-file success and failure results. */
2
+ import { Effect } from "effect";
3
+ import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
4
+ import { deepAgentBucketFailure } from "./deepagent-bucket-error.js";
5
+ import { DeepAgentBucket, deepAgentBucketLayer } from "./deepagent-bucket-service.js";
6
+ import { putFileDataEffect } from "./deepagent-bucket-file-data.js";
7
+ import { bucketKey, isControlFailure, virtualPath } from "./deepagent-bucket-files.js";
8
+ /** Uploads files in input order so repeated paths retain last-write behavior.
9
+ * @param files - Virtual paths and bytes to store.
10
+ * @returns An Effect with one response per file or a tagged control failure.
11
+ * @example Effect.runPromise(Effect.provide(uploadBucketFilesEffect([["/a", bytes]]), deepAgentBucketLayer(context)));
12
+ */
13
+ export const uploadBucketFilesEffect = Effect.fn("Agents.bucket.upload")(function* (files) {
14
+ yield* DeepAgentBucket;
15
+ return yield* Effect.forEach(files, ([path, content]) => Effect.gen(function* () {
16
+ const normalized = yield* Effect.try({
17
+ try: () => {
18
+ if (!(content instanceof Uint8Array))
19
+ throw new TypeError("File content must be bytes");
20
+ return virtualPath(path);
21
+ },
22
+ catch: deepAgentBucketFailure,
23
+ });
24
+ yield* putFileDataEffect(normalized, content);
25
+ return { path: normalized, error: null };
26
+ }).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => isControlFailure(failure.cause)
27
+ ? Effect.fail(failure)
28
+ : Effect.succeed({ path, error: "invalid_path" }))), { concurrency: 1 });
29
+ }, (effect) => observeAgent("bucket.upload", effect));
30
+ /** Uploads files for existing DeepAgents Promise callers.
31
+ * @param context - Bound bucket client and prefix.
32
+ * @param files - Virtual paths and bytes to store.
33
+ * @returns One response per file in input order.
34
+ * @throws A cancellation or timeout failure from the bucket client.
35
+ * @example await uploadBucketFiles(context, [["/a", bytes]]);
36
+ */
37
+ export function uploadBucketFiles(context, files) {
38
+ return Effect.runPromise(uploadBucketFilesEffect(files).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => Effect.fail(failure.cause)), Effect.provide(deepAgentBucketLayer(context))));
39
+ }
40
+ /** Downloads files in input order with a result for each path.
41
+ * @param paths - Virtual paths to read.
42
+ * @returns An Effect with one response per path or a tagged control failure.
43
+ * @example Effect.runPromise(Effect.provide(downloadBucketFilesEffect(["/a"]), deepAgentBucketLayer(context)));
44
+ */
45
+ export const downloadBucketFilesEffect = Effect.fn("Agents.bucket.download")(function* (paths) {
46
+ const context = yield* DeepAgentBucket;
47
+ return yield* Effect.forEach(paths, (path) => Effect.gen(function* () {
48
+ const key = yield* Effect.try({
49
+ try: () => bucketKey(context, path),
50
+ catch: deepAgentBucketFailure,
51
+ });
52
+ const content = yield* Effect.tryPromise({
53
+ try: () => context.bucket.get(key),
54
+ catch: deepAgentBucketFailure,
55
+ });
56
+ return content === undefined
57
+ ? { path, content: null, error: "file_not_found" }
58
+ : { path: virtualPath(path), content, error: null };
59
+ }).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => isControlFailure(failure.cause)
60
+ ? Effect.fail(failure)
61
+ : Effect.succeed({ path, content: null, error: "invalid_path" }))), { concurrency: 1 });
62
+ }, (effect) => observeAgent("bucket.download", effect));
63
+ /** Downloads files for existing DeepAgents Promise callers.
64
+ * @param context - Bound bucket client and prefix.
65
+ * @param paths - Virtual paths to read.
66
+ * @returns One response per path in input order.
67
+ * @throws A cancellation or timeout failure from the bucket client.
68
+ * @example await downloadBucketFiles(context, ["/a"]);
69
+ */
70
+ export function downloadBucketFiles(context, paths) {
71
+ return Effect.runPromise(downloadBucketFilesEffect(paths).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => Effect.fail(failure.cause)), Effect.provide(deepAgentBucketLayer(context))));
72
+ }
73
+ //# sourceMappingURL=deepagent-bucket-transfer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-transfer.js","sourceRoot":"","sources":["../src/deepagent-bucket-transfer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,55 @@
1
+ /** Applies native file writes and edits to the selected bucket and updates the shared file index after successful storage mutations. */
2
+ import type { EditResult, WriteResult } from "deepagents";
3
+ import { Effect } from "effect";
4
+ import { DeepAgentBucket } from "./deepagent-bucket-service.js";
5
+ import type { DeepAgentBucketContext } from "./deepagent-bucket-files.types.js";
6
+ /** Writes a text file through the current bucket service.
7
+ * @param path - Virtual file path.
8
+ * @param content - Text to write.
9
+ * @returns An Effect with the written path or a tagged bucket failure.
10
+ * @example Effect.runPromise(Effect.provide(writeBucketEffect("/a.md", "hi"), deepAgentBucketLayer(context)));
11
+ */
12
+ export declare const writeBucketEffect: (path: string, content: string) => Effect.Effect<{
13
+ path: string;
14
+ filesUpdate: null;
15
+ }, import("./deepagent-bucket-error.js").DeepAgentBucketFailure, DeepAgentBucket>;
16
+ /** Writes text for existing DeepAgents Promise callers.
17
+ * @param context - Bound bucket client and prefix.
18
+ * @param path - Virtual file path.
19
+ * @param content - Text to write.
20
+ * @returns The written path or a legacy error result.
21
+ * @throws A cancellation or timeout failure from the bucket client.
22
+ * @example await writeBucket(context, "/a.md", "hi");
23
+ */
24
+ export declare function writeBucket(context: DeepAgentBucketContext, path: string, content: string): Promise<WriteResult>;
25
+ /** Replaces text with the existing DeepAgents edit rules.
26
+ * @param path - Virtual file path.
27
+ * @param oldText - Existing text to replace.
28
+ * @param newText - Replacement text.
29
+ * @param replaceAll - Whether multiple occurrences may be replaced.
30
+ * @returns An Effect with edit details or a tagged bucket failure.
31
+ * @example Effect.runPromise(Effect.provide(editBucketEffect("/a.md", "old", "new"), deepAgentBucketLayer(context)));
32
+ */
33
+ export declare const editBucketEffect: (path: string, oldText: string, newText: string, replaceAll?: any) => Effect.Effect<{
34
+ error: string;
35
+ path?: never;
36
+ filesUpdate?: never;
37
+ occurrences?: never;
38
+ } | {
39
+ path: string;
40
+ filesUpdate: null;
41
+ occurrences: number;
42
+ error?: never;
43
+ }, import("./deepagent-bucket-error.js").DeepAgentBucketFailure, DeepAgentBucket>;
44
+ /** Edits text for existing DeepAgents Promise callers.
45
+ * @param context - Bound bucket client and prefix.
46
+ * @param path - Virtual file path.
47
+ * @param oldText - Existing text to replace.
48
+ * @param newText - Replacement text.
49
+ * @param replaceAll - Whether multiple occurrences may be replaced.
50
+ * @returns Edit details or a legacy error result.
51
+ * @throws A cancellation or timeout failure from the bucket client.
52
+ * @example await editBucket(context, "/a.md", "old", "new", true);
53
+ */
54
+ export declare function editBucket(context: DeepAgentBucketContext, path: string, oldText: string, newText: string, replaceAll?: boolean): Promise<EditResult>;
55
+ //# sourceMappingURL=deepagent-bucket-write.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-write.d.ts","sourceRoot":"","sources":["../src/deepagent-bucket-write.ts"],"names":[],"mappings":"AAAA,wIAAwI;AAExI,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,eAAe,EAAwB,MAAM,+BAA+B,CAAC;AAGtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;iFAc7B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC,CAWtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;iFAyB5B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,UAAQ,GACjB,OAAO,CAAC,UAAU,CAAC,CAWrB"}
@@ -0,0 +1,88 @@
1
+ /** Applies native file writes and edits to the selected bucket and updates the shared file index after successful storage mutations. */
2
+ import { Effect } from "effect";
3
+ import { observeAgent } from "@relkit/agents/internal/agent-telemetry";
4
+ import { deepAgentBucketFailure } from "./deepagent-bucket-error.js";
5
+ import { DeepAgentBucket, deepAgentBucketLayer } from "./deepagent-bucket-service.js";
6
+ import { putFileDataEffect, readFileDataEffect } from "./deepagent-bucket-file-data.js";
7
+ import { errorMessage, isControlFailure, virtualPath } from "./deepagent-bucket-files.js";
8
+ /** Writes a text file through the current bucket service.
9
+ * @param path - Virtual file path.
10
+ * @param content - Text to write.
11
+ * @returns An Effect with the written path or a tagged bucket failure.
12
+ * @example Effect.runPromise(Effect.provide(writeBucketEffect("/a.md", "hi"), deepAgentBucketLayer(context)));
13
+ */
14
+ export const writeBucketEffect = Effect.fn("Agents.bucket.write")(function* (path, content) {
15
+ yield* DeepAgentBucket;
16
+ const normalized = yield* Effect.try({
17
+ try: () => {
18
+ if (typeof content !== "string")
19
+ throw new TypeError("File content must be a string");
20
+ return virtualPath(path);
21
+ },
22
+ catch: deepAgentBucketFailure,
23
+ });
24
+ yield* putFileDataEffect(normalized, content);
25
+ return { path: normalized, filesUpdate: null };
26
+ }, (effect) => observeAgent("bucket.write", effect));
27
+ /** Writes text for existing DeepAgents Promise callers.
28
+ * @param context - Bound bucket client and prefix.
29
+ * @param path - Virtual file path.
30
+ * @param content - Text to write.
31
+ * @returns The written path or a legacy error result.
32
+ * @throws A cancellation or timeout failure from the bucket client.
33
+ * @example await writeBucket(context, "/a.md", "hi");
34
+ */
35
+ export function writeBucket(context, path, content) {
36
+ return Effect.runPromise(writeBucketEffect(path, content).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => isControlFailure(failure.cause)
37
+ ? Effect.fail(failure.cause)
38
+ : Effect.succeed({ error: errorMessage(failure.cause) })), Effect.provide(deepAgentBucketLayer(context))));
39
+ }
40
+ /** Replaces text with the existing DeepAgents edit rules.
41
+ * @param path - Virtual file path.
42
+ * @param oldText - Existing text to replace.
43
+ * @param newText - Replacement text.
44
+ * @param replaceAll - Whether multiple occurrences may be replaced.
45
+ * @returns An Effect with edit details or a tagged bucket failure.
46
+ * @example Effect.runPromise(Effect.provide(editBucketEffect("/a.md", "old", "new"), deepAgentBucketLayer(context)));
47
+ */
48
+ export const editBucketEffect = Effect.fn("Agents.bucket.edit")(function* (path, oldText, newText, replaceAll = false) {
49
+ yield* DeepAgentBucket;
50
+ const normalized = yield* Effect.try({
51
+ try: () => virtualPath(path),
52
+ catch: deepAgentBucketFailure,
53
+ });
54
+ const data = yield* readFileDataEffect(normalized);
55
+ if (data === undefined)
56
+ return { error: `Error: File '${normalized}' not found` };
57
+ if (typeof data.content !== "string")
58
+ return { error: `Error: File '${normalized}' is binary` };
59
+ if (oldText === "" && data.content !== "") {
60
+ return { error: "Error: oldString cannot be empty when file has content" };
61
+ }
62
+ const occurrences = oldText === "" ? 0 : data.content.split(oldText).length - 1;
63
+ if (oldText !== "" && occurrences === 0) {
64
+ return { error: `Error: String not found in file: '${oldText}'` };
65
+ }
66
+ if (occurrences > 1 && !replaceAll) {
67
+ return { error: `Error: String '${oldText}' has multiple occurrences (${occurrences})` };
68
+ }
69
+ const content = oldText === "" ? newText : data.content.split(oldText).join(newText);
70
+ yield* putFileDataEffect(normalized, content);
71
+ return { path: normalized, filesUpdate: null, occurrences };
72
+ }, (effect) => observeAgent("bucket.edit", effect));
73
+ /** Edits text for existing DeepAgents Promise callers.
74
+ * @param context - Bound bucket client and prefix.
75
+ * @param path - Virtual file path.
76
+ * @param oldText - Existing text to replace.
77
+ * @param newText - Replacement text.
78
+ * @param replaceAll - Whether multiple occurrences may be replaced.
79
+ * @returns Edit details or a legacy error result.
80
+ * @throws A cancellation or timeout failure from the bucket client.
81
+ * @example await editBucket(context, "/a.md", "old", "new", true);
82
+ */
83
+ export function editBucket(context, path, oldText, newText, replaceAll = false) {
84
+ return Effect.runPromise(editBucketEffect(path, oldText, newText, replaceAll).pipe(Effect.catchTag("DeepAgentBucketFailure", (failure) => isControlFailure(failure.cause)
85
+ ? Effect.fail(failure.cause)
86
+ : Effect.succeed({ error: errorMessage(failure.cause) })), Effect.provide(deepAgentBucketLayer(context))));
87
+ }
88
+ //# sourceMappingURL=deepagent-bucket-write.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deepagent-bucket-write.js","sourceRoot":"","sources":["../src/deepagent-bucket-write.ts"],"names":[],"mappings":"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"}