@e4779/pi-fabric 0.92.17-fork.3

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 (1044) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +181 -0
  3. package/THIRD_PARTY_NOTICES.md +33 -0
  4. package/dist/activity/store.d.ts +33 -0
  5. package/dist/activity/store.d.ts.map +1 -0
  6. package/dist/activity/types.d.ts +104 -0
  7. package/dist/activity/types.d.ts.map +1 -0
  8. package/dist/actors/binding-store.d.ts +17 -0
  9. package/dist/actors/binding-store.d.ts.map +1 -0
  10. package/dist/actors/context.d.ts +13 -0
  11. package/dist/actors/context.d.ts.map +1 -0
  12. package/dist/actors/delivery-policy.d.ts +8 -0
  13. package/dist/actors/delivery-policy.d.ts.map +1 -0
  14. package/dist/actors/directory.d.ts +47 -0
  15. package/dist/actors/directory.d.ts.map +1 -0
  16. package/dist/actors/global-registry.d.ts +47 -0
  17. package/dist/actors/global-registry.d.ts.map +1 -0
  18. package/dist/actors/host-event-observer.d.ts +5 -0
  19. package/dist/actors/host-event-observer.d.ts.map +1 -0
  20. package/dist/actors/host-event-payload.d.ts +14 -0
  21. package/dist/actors/host-event-payload.d.ts.map +1 -0
  22. package/dist/actors/log-store.d.ts +22 -0
  23. package/dist/actors/log-store.d.ts.map +1 -0
  24. package/dist/actors/manager.d.ts +175 -0
  25. package/dist/actors/manager.d.ts.map +1 -0
  26. package/dist/actors/mesh-monitor.d.ts +22 -0
  27. package/dist/actors/mesh-monitor.d.ts.map +1 -0
  28. package/dist/actors/predicate.d.ts +7 -0
  29. package/dist/actors/predicate.d.ts.map +1 -0
  30. package/dist/actors/registry-store.d.ts +15 -0
  31. package/dist/actors/registry-store.d.ts.map +1 -0
  32. package/dist/actors/types.d.ts +218 -0
  33. package/dist/actors/types.d.ts.map +1 -0
  34. package/dist/agents/bash-worktree-add.d.ts +24 -0
  35. package/dist/agents/bash-worktree-add.d.ts.map +1 -0
  36. package/dist/agents/budget-ledger.d.ts +88 -0
  37. package/dist/agents/budget-ledger.d.ts.map +1 -0
  38. package/dist/agents/claude-cli.d.ts +32 -0
  39. package/dist/agents/claude-cli.d.ts.map +1 -0
  40. package/dist/agents/claude-cli.js +17 -0
  41. package/dist/agents/claude-cli.js.map +7 -0
  42. package/dist/agents/clone-first-worktree.d.ts +17 -0
  43. package/dist/agents/clone-first-worktree.d.ts.map +1 -0
  44. package/dist/agents/compact-control.d.ts +32 -0
  45. package/dist/agents/compact-control.d.ts.map +1 -0
  46. package/dist/agents/compact-control.js +129 -0
  47. package/dist/agents/compact-control.js.map +7 -0
  48. package/dist/agents/constants.d.ts +9 -0
  49. package/dist/agents/constants.d.ts.map +1 -0
  50. package/dist/agents/cow-clone.d.ts +8 -0
  51. package/dist/agents/cow-clone.d.ts.map +1 -0
  52. package/dist/agents/handoff-completion.d.ts +4 -0
  53. package/dist/agents/handoff-completion.d.ts.map +1 -0
  54. package/dist/agents/handoff.d.ts +19 -0
  55. package/dist/agents/handoff.d.ts.map +1 -0
  56. package/dist/agents/lifecycle.d.ts +32 -0
  57. package/dist/agents/lifecycle.d.ts.map +1 -0
  58. package/dist/agents/manager.d.ts +75 -0
  59. package/dist/agents/manager.d.ts.map +1 -0
  60. package/dist/agents/pi-binary.d.ts +7 -0
  61. package/dist/agents/pi-binary.d.ts.map +1 -0
  62. package/dist/agents/request.d.ts +13 -0
  63. package/dist/agents/request.d.ts.map +1 -0
  64. package/dist/agents/result.d.ts +8 -0
  65. package/dist/agents/result.d.ts.map +1 -0
  66. package/dist/agents/result.js +9 -0
  67. package/dist/agents/result.js.map +7 -0
  68. package/dist/agents/rm.d.ts +15 -0
  69. package/dist/agents/rm.d.ts.map +1 -0
  70. package/dist/agents/semaphore.d.ts +7 -0
  71. package/dist/agents/semaphore.d.ts.map +1 -0
  72. package/dist/agents/service-provider.d.ts +9 -0
  73. package/dist/agents/service-provider.d.ts.map +1 -0
  74. package/dist/agents/service-schema.d.ts +6 -0
  75. package/dist/agents/service-schema.d.ts.map +1 -0
  76. package/dist/agents/service-types.d.ts +192 -0
  77. package/dist/agents/service-types.d.ts.map +1 -0
  78. package/dist/agents/service.d.ts +36 -0
  79. package/dist/agents/service.d.ts.map +1 -0
  80. package/dist/agents/session-export.d.ts +39 -0
  81. package/dist/agents/session-export.d.ts.map +1 -0
  82. package/dist/agents/session-pins.d.ts +24 -0
  83. package/dist/agents/session-pins.d.ts.map +1 -0
  84. package/dist/agents/thinking-transfer.d.ts +39 -0
  85. package/dist/agents/thinking-transfer.d.ts.map +1 -0
  86. package/dist/agents/transports/herdr-transport.d.ts +10 -0
  87. package/dist/agents/transports/herdr-transport.d.ts.map +1 -0
  88. package/dist/agents/transports/localterm-transport.d.ts +7 -0
  89. package/dist/agents/transports/localterm-transport.d.ts.map +1 -0
  90. package/dist/agents/transports/process-transport.d.ts +7 -0
  91. package/dist/agents/transports/process-transport.d.ts.map +1 -0
  92. package/dist/agents/transports/process-utils.d.ts +33 -0
  93. package/dist/agents/transports/process-utils.d.ts.map +1 -0
  94. package/dist/agents/transports/screen-transport.d.ts +7 -0
  95. package/dist/agents/transports/screen-transport.d.ts.map +1 -0
  96. package/dist/agents/transports/tmux-transport.d.ts +7 -0
  97. package/dist/agents/transports/tmux-transport.d.ts.map +1 -0
  98. package/dist/agents/types.d.ts +280 -0
  99. package/dist/agents/types.d.ts.map +1 -0
  100. package/dist/agents/veda-cli.d.ts +22 -0
  101. package/dist/agents/veda-cli.d.ts.map +1 -0
  102. package/dist/agents/veda-cli.js +13 -0
  103. package/dist/agents/veda-cli.js.map +7 -0
  104. package/dist/agents/worktree-manager.d.ts +14 -0
  105. package/dist/agents/worktree-manager.d.ts.map +1 -0
  106. package/dist/agents/worktree-paths.d.ts +5 -0
  107. package/dist/agents/worktree-paths.d.ts.map +1 -0
  108. package/dist/agents.d.ts +8 -0
  109. package/dist/agents.d.ts.map +1 -0
  110. package/dist/agents.js +761 -0
  111. package/dist/agents.js.map +7 -0
  112. package/dist/async-settlement.d.ts +4 -0
  113. package/dist/async-settlement.d.ts.map +1 -0
  114. package/dist/audit/details.d.ts +86 -0
  115. package/dist/audit/details.d.ts.map +1 -0
  116. package/dist/audit/index.d.ts +4 -0
  117. package/dist/audit/index.d.ts.map +1 -0
  118. package/dist/audit/projection.d.ts +20 -0
  119. package/dist/audit/projection.d.ts.map +1 -0
  120. package/dist/audit/trace.d.ts +99 -0
  121. package/dist/audit/trace.d.ts.map +1 -0
  122. package/dist/capture/catalog.d.ts +30 -0
  123. package/dist/capture/catalog.d.ts.map +1 -0
  124. package/dist/capture/interceptor.d.ts +20 -0
  125. package/dist/capture/interceptor.d.ts.map +1 -0
  126. package/dist/capture/wrapper.d.ts +15 -0
  127. package/dist/capture/wrapper.d.ts.map +1 -0
  128. package/dist/chunks/chunk-2DMJ7MEI.js +1984 -0
  129. package/dist/chunks/chunk-2DMJ7MEI.js.map +7 -0
  130. package/dist/chunks/chunk-2PZWDVJB.js +738 -0
  131. package/dist/chunks/chunk-2PZWDVJB.js.map +7 -0
  132. package/dist/chunks/chunk-2UQV52II.js +440 -0
  133. package/dist/chunks/chunk-2UQV52II.js.map +7 -0
  134. package/dist/chunks/chunk-32BNQ75J.js +1445 -0
  135. package/dist/chunks/chunk-32BNQ75J.js.map +7 -0
  136. package/dist/chunks/chunk-3H7SDWZI.js +467 -0
  137. package/dist/chunks/chunk-3H7SDWZI.js.map +7 -0
  138. package/dist/chunks/chunk-3MEHEH6B.js +41 -0
  139. package/dist/chunks/chunk-3MEHEH6B.js.map +7 -0
  140. package/dist/chunks/chunk-3QECYQGA.js +70 -0
  141. package/dist/chunks/chunk-3QECYQGA.js.map +7 -0
  142. package/dist/chunks/chunk-3WIGAX56.js +644 -0
  143. package/dist/chunks/chunk-3WIGAX56.js.map +7 -0
  144. package/dist/chunks/chunk-3YZUQESG.js +16 -0
  145. package/dist/chunks/chunk-3YZUQESG.js.map +7 -0
  146. package/dist/chunks/chunk-4JETKRFE.js +287 -0
  147. package/dist/chunks/chunk-4JETKRFE.js.map +7 -0
  148. package/dist/chunks/chunk-4SSMGBF4.js +93 -0
  149. package/dist/chunks/chunk-4SSMGBF4.js.map +7 -0
  150. package/dist/chunks/chunk-5SU3YXBS.js +15 -0
  151. package/dist/chunks/chunk-5SU3YXBS.js.map +7 -0
  152. package/dist/chunks/chunk-656HWVFU.js +409 -0
  153. package/dist/chunks/chunk-656HWVFU.js.map +7 -0
  154. package/dist/chunks/chunk-7A6NVHB5.js +1242 -0
  155. package/dist/chunks/chunk-7A6NVHB5.js.map +7 -0
  156. package/dist/chunks/chunk-7TB7NXSL.js +58 -0
  157. package/dist/chunks/chunk-7TB7NXSL.js.map +7 -0
  158. package/dist/chunks/chunk-AAHHYDTO.js +24 -0
  159. package/dist/chunks/chunk-AAHHYDTO.js.map +7 -0
  160. package/dist/chunks/chunk-ARLYAW2A.js +95 -0
  161. package/dist/chunks/chunk-ARLYAW2A.js.map +7 -0
  162. package/dist/chunks/chunk-AYBIR4YV.js +210 -0
  163. package/dist/chunks/chunk-AYBIR4YV.js.map +7 -0
  164. package/dist/chunks/chunk-BOTRGFQQ.js +87 -0
  165. package/dist/chunks/chunk-BOTRGFQQ.js.map +7 -0
  166. package/dist/chunks/chunk-CGPK5WHX.js +96 -0
  167. package/dist/chunks/chunk-CGPK5WHX.js.map +7 -0
  168. package/dist/chunks/chunk-CI56CW53.js +470 -0
  169. package/dist/chunks/chunk-CI56CW53.js.map +7 -0
  170. package/dist/chunks/chunk-CPSW2GW4.js +1466 -0
  171. package/dist/chunks/chunk-CPSW2GW4.js.map +7 -0
  172. package/dist/chunks/chunk-CQFP2RCP.js +64 -0
  173. package/dist/chunks/chunk-CQFP2RCP.js.map +7 -0
  174. package/dist/chunks/chunk-D5WKZONW.js +797 -0
  175. package/dist/chunks/chunk-D5WKZONW.js.map +7 -0
  176. package/dist/chunks/chunk-DLXPTBPL.js +151 -0
  177. package/dist/chunks/chunk-DLXPTBPL.js.map +7 -0
  178. package/dist/chunks/chunk-G4LADAYY.js +287 -0
  179. package/dist/chunks/chunk-G4LADAYY.js.map +7 -0
  180. package/dist/chunks/chunk-GXNR6NRU.js +447 -0
  181. package/dist/chunks/chunk-GXNR6NRU.js.map +7 -0
  182. package/dist/chunks/chunk-IGVDD2HT.js +10 -0
  183. package/dist/chunks/chunk-IGVDD2HT.js.map +7 -0
  184. package/dist/chunks/chunk-J2HV2URQ.js +1125 -0
  185. package/dist/chunks/chunk-J2HV2URQ.js.map +7 -0
  186. package/dist/chunks/chunk-KAD7UWT2.js +99 -0
  187. package/dist/chunks/chunk-KAD7UWT2.js.map +7 -0
  188. package/dist/chunks/chunk-KYXZJNV6.js +227 -0
  189. package/dist/chunks/chunk-KYXZJNV6.js.map +7 -0
  190. package/dist/chunks/chunk-LMAVZN7J.js +8 -0
  191. package/dist/chunks/chunk-LMAVZN7J.js.map +7 -0
  192. package/dist/chunks/chunk-M3S7XITB.js +110 -0
  193. package/dist/chunks/chunk-M3S7XITB.js.map +7 -0
  194. package/dist/chunks/chunk-MGDLRV2R.js +112 -0
  195. package/dist/chunks/chunk-MGDLRV2R.js.map +7 -0
  196. package/dist/chunks/chunk-MGWQOKBV.js +30 -0
  197. package/dist/chunks/chunk-MGWQOKBV.js.map +7 -0
  198. package/dist/chunks/chunk-N5GUXC6F.js +184 -0
  199. package/dist/chunks/chunk-N5GUXC6F.js.map +7 -0
  200. package/dist/chunks/chunk-NQOEHX62.js +215 -0
  201. package/dist/chunks/chunk-NQOEHX62.js.map +7 -0
  202. package/dist/chunks/chunk-OKOHRXGF.js +100 -0
  203. package/dist/chunks/chunk-OKOHRXGF.js.map +7 -0
  204. package/dist/chunks/chunk-OP2KTYQB.js +286 -0
  205. package/dist/chunks/chunk-OP2KTYQB.js.map +7 -0
  206. package/dist/chunks/chunk-OTCASLY2.js +52 -0
  207. package/dist/chunks/chunk-OTCASLY2.js.map +7 -0
  208. package/dist/chunks/chunk-PAN6C3JM.js +42 -0
  209. package/dist/chunks/chunk-PAN6C3JM.js.map +7 -0
  210. package/dist/chunks/chunk-PH7ZJ27F.js +6873 -0
  211. package/dist/chunks/chunk-PH7ZJ27F.js.map +7 -0
  212. package/dist/chunks/chunk-PM5I335G.js +225 -0
  213. package/dist/chunks/chunk-PM5I335G.js.map +7 -0
  214. package/dist/chunks/chunk-PSNXUZMY.js +218 -0
  215. package/dist/chunks/chunk-PSNXUZMY.js.map +7 -0
  216. package/dist/chunks/chunk-PXAICAUT.js +24 -0
  217. package/dist/chunks/chunk-PXAICAUT.js.map +7 -0
  218. package/dist/chunks/chunk-RERA6YWA.js +359 -0
  219. package/dist/chunks/chunk-RERA6YWA.js.map +7 -0
  220. package/dist/chunks/chunk-RNOPHITP.js +1720 -0
  221. package/dist/chunks/chunk-RNOPHITP.js.map +7 -0
  222. package/dist/chunks/chunk-RRGTKHXZ.js +931 -0
  223. package/dist/chunks/chunk-RRGTKHXZ.js.map +7 -0
  224. package/dist/chunks/chunk-SWB2OHYW.js +93 -0
  225. package/dist/chunks/chunk-SWB2OHYW.js.map +7 -0
  226. package/dist/chunks/chunk-T3A5GNCW.js +19 -0
  227. package/dist/chunks/chunk-T3A5GNCW.js.map +7 -0
  228. package/dist/chunks/chunk-TPLMVELH.js +118 -0
  229. package/dist/chunks/chunk-TPLMVELH.js.map +7 -0
  230. package/dist/chunks/chunk-TSRKCXNI.js +17 -0
  231. package/dist/chunks/chunk-TSRKCXNI.js.map +7 -0
  232. package/dist/chunks/chunk-U5FYOMG5.js +119 -0
  233. package/dist/chunks/chunk-U5FYOMG5.js.map +7 -0
  234. package/dist/chunks/chunk-U6CTHPZC.js +1924 -0
  235. package/dist/chunks/chunk-U6CTHPZC.js.map +7 -0
  236. package/dist/chunks/chunk-UDFDF7IY.js +1572 -0
  237. package/dist/chunks/chunk-UDFDF7IY.js.map +7 -0
  238. package/dist/chunks/chunk-UKMQK5VP.js +231 -0
  239. package/dist/chunks/chunk-UKMQK5VP.js.map +7 -0
  240. package/dist/chunks/chunk-UQ4LTUH4.js +2181 -0
  241. package/dist/chunks/chunk-UQ4LTUH4.js.map +7 -0
  242. package/dist/chunks/chunk-UTR3I23Z.js +65 -0
  243. package/dist/chunks/chunk-UTR3I23Z.js.map +7 -0
  244. package/dist/chunks/chunk-VPPIJRNZ.js +50 -0
  245. package/dist/chunks/chunk-VPPIJRNZ.js.map +7 -0
  246. package/dist/chunks/chunk-VRYEGVHR.js +195 -0
  247. package/dist/chunks/chunk-VRYEGVHR.js.map +7 -0
  248. package/dist/chunks/chunk-VRZNFNPB.js +4218 -0
  249. package/dist/chunks/chunk-VRZNFNPB.js.map +7 -0
  250. package/dist/chunks/chunk-VXZZJ44D.js +295 -0
  251. package/dist/chunks/chunk-VXZZJ44D.js.map +7 -0
  252. package/dist/chunks/chunk-W3FRE4VI.js +297 -0
  253. package/dist/chunks/chunk-W3FRE4VI.js.map +7 -0
  254. package/dist/chunks/chunk-WVH324VF.js +60 -0
  255. package/dist/chunks/chunk-WVH324VF.js.map +7 -0
  256. package/dist/chunks/chunk-X7G62ZGH.js +151 -0
  257. package/dist/chunks/chunk-X7G62ZGH.js.map +7 -0
  258. package/dist/chunks/chunk-XB3RJVT4.js +17 -0
  259. package/dist/chunks/chunk-XB3RJVT4.js.map +7 -0
  260. package/dist/chunks/chunk-XT4346N7.js +651 -0
  261. package/dist/chunks/chunk-XT4346N7.js.map +7 -0
  262. package/dist/chunks/chunk-Y7KNRAFL.js +1180 -0
  263. package/dist/chunks/chunk-Y7KNRAFL.js.map +7 -0
  264. package/dist/chunks/chunk-YK5AZ7CZ.js +692 -0
  265. package/dist/chunks/chunk-YK5AZ7CZ.js.map +7 -0
  266. package/dist/chunks/chunk-YU4O6SWQ.js +246 -0
  267. package/dist/chunks/chunk-YU4O6SWQ.js.map +7 -0
  268. package/dist/chunks/chunk-YU62DDKK.js +22 -0
  269. package/dist/chunks/chunk-YU62DDKK.js.map +7 -0
  270. package/dist/chunks/chunk-Z63R5GVN.js +121 -0
  271. package/dist/chunks/chunk-Z63R5GVN.js.map +7 -0
  272. package/dist/chunks/chunk-ZDNGXLEC.js +221 -0
  273. package/dist/chunks/chunk-ZDNGXLEC.js.map +7 -0
  274. package/dist/chunks/chunk-ZZ4LHQYJ.js +777 -0
  275. package/dist/chunks/chunk-ZZ4LHQYJ.js.map +7 -0
  276. package/dist/commands/fabric.d.ts +17 -0
  277. package/dist/commands/fabric.d.ts.map +1 -0
  278. package/dist/compaction/bounds.d.ts +23 -0
  279. package/dist/compaction/bounds.d.ts.map +1 -0
  280. package/dist/compaction/branch-details.d.ts +83 -0
  281. package/dist/compaction/branch-details.d.ts.map +1 -0
  282. package/dist/compaction/branch-summary.d.ts +9 -0
  283. package/dist/compaction/branch-summary.d.ts.map +1 -0
  284. package/dist/compaction/enrichers.d.ts +10 -0
  285. package/dist/compaction/enrichers.d.ts.map +1 -0
  286. package/dist/compaction/hook.d.ts +99 -0
  287. package/dist/compaction/hook.d.ts.map +1 -0
  288. package/dist/compaction/hook.js +22 -0
  289. package/dist/compaction/hook.js.map +7 -0
  290. package/dist/compaction/instructions.d.ts +38 -0
  291. package/dist/compaction/instructions.d.ts.map +1 -0
  292. package/dist/compaction/normalize.d.ts +83 -0
  293. package/dist/compaction/normalize.d.ts.map +1 -0
  294. package/dist/compaction/projections.d.ts +31 -0
  295. package/dist/compaction/projections.d.ts.map +1 -0
  296. package/dist/compaction/qa.d.ts +27 -0
  297. package/dist/compaction/qa.d.ts.map +1 -0
  298. package/dist/compaction/render.d.ts +10 -0
  299. package/dist/compaction/render.d.ts.map +1 -0
  300. package/dist/compaction/threshold.d.ts +5 -0
  301. package/dist/compaction/threshold.d.ts.map +1 -0
  302. package/dist/compaction/trace-events.d.ts +23 -0
  303. package/dist/compaction/trace-events.d.ts.map +1 -0
  304. package/dist/components/catalog.d.ts +25 -0
  305. package/dist/components/catalog.d.ts.map +1 -0
  306. package/dist/components/effect-policy.d.ts +21 -0
  307. package/dist/components/effect-policy.d.ts.map +1 -0
  308. package/dist/components/effect-scope.d.ts +31 -0
  309. package/dist/components/effect-scope.d.ts.map +1 -0
  310. package/dist/components/loader.d.ts +27 -0
  311. package/dist/components/loader.d.ts.map +1 -0
  312. package/dist/components/model-guidance.d.ts +48 -0
  313. package/dist/components/model-guidance.d.ts.map +1 -0
  314. package/dist/components/provider-component.d.ts +31 -0
  315. package/dist/components/provider-component.d.ts.map +1 -0
  316. package/dist/components/supervisor.d.ts +29 -0
  317. package/dist/components/supervisor.d.ts.map +1 -0
  318. package/dist/components/types.d.ts +140 -0
  319. package/dist/components/types.d.ts.map +1 -0
  320. package/dist/config-migrations.d.ts +11 -0
  321. package/dist/config-migrations.d.ts.map +1 -0
  322. package/dist/config.d.ts +282 -0
  323. package/dist/config.d.ts.map +1 -0
  324. package/dist/core/action-arguments.d.ts +12 -0
  325. package/dist/core/action-arguments.d.ts.map +1 -0
  326. package/dist/core/action-registry.d.ts +170 -0
  327. package/dist/core/action-registry.d.ts.map +1 -0
  328. package/dist/core/action-registry.js +20 -0
  329. package/dist/core/action-registry.js.map +7 -0
  330. package/dist/core/action-repair.d.ts +15 -0
  331. package/dist/core/action-repair.d.ts.map +1 -0
  332. package/dist/core/action-result.d.ts +13 -0
  333. package/dist/core/action-result.d.ts.map +1 -0
  334. package/dist/core/agent-dir.d.ts +2 -0
  335. package/dist/core/agent-dir.d.ts.map +1 -0
  336. package/dist/core/approval-controller.d.ts +31 -0
  337. package/dist/core/approval-controller.d.ts.map +1 -0
  338. package/dist/core/atomic-write.d.ts +15 -0
  339. package/dist/core/atomic-write.d.ts.map +1 -0
  340. package/dist/core/auto-approval-classifier.d.ts +17 -0
  341. package/dist/core/auto-approval-classifier.d.ts.map +1 -0
  342. package/dist/core/call-preview.d.ts +8 -0
  343. package/dist/core/call-preview.d.ts.map +1 -0
  344. package/dist/core/child-tool-allowlist.d.ts +3 -0
  345. package/dist/core/child-tool-allowlist.d.ts.map +1 -0
  346. package/dist/core/compact-controller.d.ts +42 -0
  347. package/dist/core/compact-controller.d.ts.map +1 -0
  348. package/dist/core/core-override-guidance.d.ts +7 -0
  349. package/dist/core/core-override-guidance.d.ts.map +1 -0
  350. package/dist/core/damaged-file.d.ts +6 -0
  351. package/dist/core/damaged-file.d.ts.map +1 -0
  352. package/dist/core/direct-tool-approval.d.ts +19 -0
  353. package/dist/core/direct-tool-approval.d.ts.map +1 -0
  354. package/dist/core/effect-conflict.d.ts +3 -0
  355. package/dist/core/effect-conflict.d.ts.map +1 -0
  356. package/dist/core/file-lock.d.ts +12 -0
  357. package/dist/core/file-lock.d.ts.map +1 -0
  358. package/dist/core/kernel-skills.d.ts +3 -0
  359. package/dist/core/kernel-skills.d.ts.map +1 -0
  360. package/dist/core/model-resolution.d.ts +62 -0
  361. package/dist/core/model-resolution.d.ts.map +1 -0
  362. package/dist/core/model-usage.d.ts +8 -0
  363. package/dist/core/model-usage.d.ts.map +1 -0
  364. package/dist/core/pi-arguments.d.ts +3 -0
  365. package/dist/core/pi-arguments.d.ts.map +1 -0
  366. package/dist/core/pi-bash-error.d.ts +9 -0
  367. package/dist/core/pi-bash-error.d.ts.map +1 -0
  368. package/dist/core/pi-tools.d.ts +9 -0
  369. package/dist/core/pi-tools.d.ts.map +1 -0
  370. package/dist/core/provider-bindings.d.ts +47 -0
  371. package/dist/core/provider-bindings.d.ts.map +1 -0
  372. package/dist/core/proxy-contract.d.ts +18 -0
  373. package/dist/core/proxy-contract.d.ts.map +1 -0
  374. package/dist/core/session-context.d.ts +14 -0
  375. package/dist/core/session-context.d.ts.map +1 -0
  376. package/dist/core/shell-jobs.d.ts +99 -0
  377. package/dist/core/shell-jobs.d.ts.map +1 -0
  378. package/dist/core/skill-block.d.ts +10 -0
  379. package/dist/core/skill-block.d.ts.map +1 -0
  380. package/dist/core/skill-dir.d.ts +4 -0
  381. package/dist/core/skill-dir.d.ts.map +1 -0
  382. package/dist/core/skill-prompt.d.ts +3 -0
  383. package/dist/core/skill-prompt.d.ts.map +1 -0
  384. package/dist/core/skill-references.d.ts +7 -0
  385. package/dist/core/skill-references.d.ts.map +1 -0
  386. package/dist/core/stable-hash.d.ts +3 -0
  387. package/dist/core/stable-hash.d.ts.map +1 -0
  388. package/dist/core/system-guidance.d.ts +13 -0
  389. package/dist/core/system-guidance.d.ts.map +1 -0
  390. package/dist/core/token-math.d.ts +16 -0
  391. package/dist/core/token-math.d.ts.map +1 -0
  392. package/dist/core/tool-ownership.d.ts +47 -0
  393. package/dist/core/tool-ownership.d.ts.map +1 -0
  394. package/dist/core/tool-result-proxy.d.ts +18 -0
  395. package/dist/core/tool-result-proxy.d.ts.map +1 -0
  396. package/dist/entropy/active.d.ts +9 -0
  397. package/dist/entropy/active.d.ts.map +1 -0
  398. package/dist/entropy/compiled-store.d.ts +16 -0
  399. package/dist/entropy/compiled-store.d.ts.map +1 -0
  400. package/dist/entropy/compiled-surface.d.ts +57 -0
  401. package/dist/entropy/compiled-surface.d.ts.map +1 -0
  402. package/dist/entropy/compiler.d.ts +27 -0
  403. package/dist/entropy/compiler.d.ts.map +1 -0
  404. package/dist/entropy/corpus.d.ts +22 -0
  405. package/dist/entropy/corpus.d.ts.map +1 -0
  406. package/dist/entropy/fingerprint.d.ts +9 -0
  407. package/dist/entropy/fingerprint.d.ts.map +1 -0
  408. package/dist/entropy/index.d.ts +16 -0
  409. package/dist/entropy/index.d.ts.map +1 -0
  410. package/dist/entropy/index.js +194 -0
  411. package/dist/entropy/index.js.map +7 -0
  412. package/dist/entropy/meter.d.ts +10 -0
  413. package/dist/entropy/meter.d.ts.map +1 -0
  414. package/dist/entropy/normal-form.d.ts +40 -0
  415. package/dist/entropy/normal-form.d.ts.map +1 -0
  416. package/dist/entropy/passes.d.ts +13 -0
  417. package/dist/entropy/passes.d.ts.map +1 -0
  418. package/dist/entropy/pool-store.d.ts +15 -0
  419. package/dist/entropy/pool-store.d.ts.map +1 -0
  420. package/dist/entropy/pool.d.ts +41 -0
  421. package/dist/entropy/pool.d.ts.map +1 -0
  422. package/dist/entropy/presentation.d.ts +12 -0
  423. package/dist/entropy/presentation.d.ts.map +1 -0
  424. package/dist/entropy/sessions.d.ts +47 -0
  425. package/dist/entropy/sessions.d.ts.map +1 -0
  426. package/dist/entropy/surface.d.ts +30 -0
  427. package/dist/entropy/surface.d.ts.map +1 -0
  428. package/dist/entropy/trial.d.ts +38 -0
  429. package/dist/entropy/trial.d.ts.map +1 -0
  430. package/dist/entropy/types.d.ts +181 -0
  431. package/dist/entropy/types.d.ts.map +1 -0
  432. package/dist/execution-service.d.ts +66 -0
  433. package/dist/execution-service.d.ts.map +1 -0
  434. package/dist/fabric-exec-arguments.d.ts +7 -0
  435. package/dist/fabric-exec-arguments.d.ts.map +1 -0
  436. package/dist/fabric-exec-tool.d.ts +8 -0
  437. package/dist/fabric-exec-tool.d.ts.map +1 -0
  438. package/dist/fabric-runtime-state.d.ts +96 -0
  439. package/dist/fabric-runtime-state.d.ts.map +1 -0
  440. package/dist/fabric-runtime-state.js +11928 -0
  441. package/dist/fabric-runtime-state.js.map +7 -0
  442. package/dist/fabric-state.d.ts +95 -0
  443. package/dist/fabric-state.d.ts.map +1 -0
  444. package/dist/failure-progress.d.ts +3 -0
  445. package/dist/failure-progress.d.ts.map +1 -0
  446. package/dist/host-compatibility.d.ts +5 -0
  447. package/dist/host-compatibility.d.ts.map +1 -0
  448. package/dist/index.d.ts +11 -0
  449. package/dist/index.d.ts.map +1 -0
  450. package/dist/index.js +6094 -0
  451. package/dist/index.js.map +7 -0
  452. package/dist/jev/auth.d.ts +5 -0
  453. package/dist/jev/auth.d.ts.map +1 -0
  454. package/dist/jev/browser.d.ts +37 -0
  455. package/dist/jev/browser.d.ts.map +1 -0
  456. package/dist/jev/browser.js +13 -0
  457. package/dist/jev/browser.js.map +7 -0
  458. package/dist/jev/client.d.ts +29 -0
  459. package/dist/jev/client.d.ts.map +1 -0
  460. package/dist/jev/client.js +11 -0
  461. package/dist/jev/client.js.map +7 -0
  462. package/dist/jev/config.d.ts +17 -0
  463. package/dist/jev/config.d.ts.map +1 -0
  464. package/dist/jev/guest-types.d.ts +2 -0
  465. package/dist/jev/guest-types.d.ts.map +1 -0
  466. package/dist/jev/manager.d.ts +36 -0
  467. package/dist/jev/manager.d.ts.map +1 -0
  468. package/dist/jev/observation.d.ts +59 -0
  469. package/dist/jev/observation.d.ts.map +1 -0
  470. package/dist/jev/observation.js +20 -0
  471. package/dist/jev/observation.js.map +7 -0
  472. package/dist/jev/types.d.ts +142 -0
  473. package/dist/jev/types.d.ts.map +1 -0
  474. package/dist/jev/validation.d.ts +8 -0
  475. package/dist/jev/validation.d.ts.map +1 -0
  476. package/dist/jev.d.ts +9 -0
  477. package/dist/jev.d.ts.map +1 -0
  478. package/dist/jev.js +49 -0
  479. package/dist/jev.js.map +7 -0
  480. package/dist/lifecycle/broker.d.ts +30 -0
  481. package/dist/lifecycle/broker.d.ts.map +1 -0
  482. package/dist/lifecycle/delivery-scheduler.d.ts +30 -0
  483. package/dist/lifecycle/delivery-scheduler.d.ts.map +1 -0
  484. package/dist/lifecycle/types.d.ts +91 -0
  485. package/dist/lifecycle/types.d.ts.map +1 -0
  486. package/dist/log-tail.d.ts +11 -0
  487. package/dist/log-tail.d.ts.map +1 -0
  488. package/dist/main-agent.d.ts +70 -0
  489. package/dist/main-agent.d.ts.map +1 -0
  490. package/dist/managed-host.d.ts +22 -0
  491. package/dist/managed-host.d.ts.map +1 -0
  492. package/dist/mcp.d.ts +9 -0
  493. package/dist/mcp.d.ts.map +1 -0
  494. package/dist/mcp.js +21 -0
  495. package/dist/mcp.js.map +7 -0
  496. package/dist/memory/client.d.ts +31 -0
  497. package/dist/memory/client.d.ts.map +1 -0
  498. package/dist/memory/context.d.ts +114 -0
  499. package/dist/memory/context.d.ts.map +1 -0
  500. package/dist/memory/digest.d.ts +48 -0
  501. package/dist/memory/digest.d.ts.map +1 -0
  502. package/dist/memory/digest.js +7 -0
  503. package/dist/memory/digest.js.map +7 -0
  504. package/dist/memory/discovery.d.ts +43 -0
  505. package/dist/memory/discovery.d.ts.map +1 -0
  506. package/dist/memory/discovery.js +25 -0
  507. package/dist/memory/discovery.js.map +7 -0
  508. package/dist/memory/expand-service.d.ts +4 -0
  509. package/dist/memory/expand-service.d.ts.map +1 -0
  510. package/dist/memory/host-source.d.ts +60 -0
  511. package/dist/memory/host-source.d.ts.map +1 -0
  512. package/dist/memory/index.d.ts +113 -0
  513. package/dist/memory/index.d.ts.map +1 -0
  514. package/dist/memory/lineage.d.ts +25 -0
  515. package/dist/memory/lineage.d.ts.map +1 -0
  516. package/dist/memory/normalize.d.ts +188 -0
  517. package/dist/memory/normalize.d.ts.map +1 -0
  518. package/dist/memory/normalize.js +26 -0
  519. package/dist/memory/normalize.js.map +7 -0
  520. package/dist/memory/portable.d.ts +66 -0
  521. package/dist/memory/portable.d.ts.map +1 -0
  522. package/dist/memory/provider.d.ts +15 -0
  523. package/dist/memory/provider.d.ts.map +1 -0
  524. package/dist/memory/recall-service.d.ts +5 -0
  525. package/dist/memory/recall-service.d.ts.map +1 -0
  526. package/dist/memory/regex.d.ts +19 -0
  527. package/dist/memory/regex.d.ts.map +1 -0
  528. package/dist/memory/request-cache.d.ts +49 -0
  529. package/dist/memory/request-cache.d.ts.map +1 -0
  530. package/dist/memory/request-context.d.ts +57 -0
  531. package/dist/memory/request-context.d.ts.map +1 -0
  532. package/dist/memory/request-limits.d.ts +8 -0
  533. package/dist/memory/request-limits.d.ts.map +1 -0
  534. package/dist/memory/search.d.ts +98 -0
  535. package/dist/memory/search.d.ts.map +1 -0
  536. package/dist/memory/search.js +24 -0
  537. package/dist/memory/search.js.map +7 -0
  538. package/dist/memory/sessions-service.d.ts +3 -0
  539. package/dist/memory/sessions-service.d.ts.map +1 -0
  540. package/dist/memory/source-observation.d.ts +28 -0
  541. package/dist/memory/source-observation.d.ts.map +1 -0
  542. package/dist/memory/tokenize.d.ts +24 -0
  543. package/dist/memory/tokenize.d.ts.map +1 -0
  544. package/dist/memory.d.ts +8 -0
  545. package/dist/memory.d.ts.map +1 -0
  546. package/dist/memory.js +119 -0
  547. package/dist/memory.js.map +7 -0
  548. package/dist/mesh/store.d.ts +78 -0
  549. package/dist/mesh/store.d.ts.map +1 -0
  550. package/dist/output-budget.d.ts +12 -0
  551. package/dist/output-budget.d.ts.map +1 -0
  552. package/dist/prewalk/arm.d.ts +8 -0
  553. package/dist/prewalk/arm.d.ts.map +1 -0
  554. package/dist/prewalk/controller.d.ts +66 -0
  555. package/dist/prewalk/controller.d.ts.map +1 -0
  556. package/dist/prewalk/fs-drift.d.ts +19 -0
  557. package/dist/prewalk/fs-drift.d.ts.map +1 -0
  558. package/dist/prewalk/handoff.d.ts +46 -0
  559. package/dist/prewalk/handoff.d.ts.map +1 -0
  560. package/dist/protocol.d.ts +275 -0
  561. package/dist/protocol.d.ts.map +1 -0
  562. package/dist/protocol.js +46 -0
  563. package/dist/protocol.js.map +7 -0
  564. package/dist/providers/agents-actions.d.ts +3 -0
  565. package/dist/providers/agents-actions.d.ts.map +1 -0
  566. package/dist/providers/agents-message-router.d.ts +29 -0
  567. package/dist/providers/agents-message-router.d.ts.map +1 -0
  568. package/dist/providers/agents-progress.d.ts +18 -0
  569. package/dist/providers/agents-progress.d.ts.map +1 -0
  570. package/dist/providers/agents-provider.d.ts +51 -0
  571. package/dist/providers/agents-provider.d.ts.map +1 -0
  572. package/dist/providers/arg-normalization.d.ts +15 -0
  573. package/dist/providers/arg-normalization.d.ts.map +1 -0
  574. package/dist/providers/captured-tools-provider.d.ts +23 -0
  575. package/dist/providers/captured-tools-provider.d.ts.map +1 -0
  576. package/dist/providers/compact-provider.d.ts +14 -0
  577. package/dist/providers/compact-provider.d.ts.map +1 -0
  578. package/dist/providers/components-provider.d.ts +12 -0
  579. package/dist/providers/components-provider.d.ts.map +1 -0
  580. package/dist/providers/jev-provider.d.ts +70 -0
  581. package/dist/providers/jev-provider.d.ts.map +1 -0
  582. package/dist/providers/jev-provider.js +28 -0
  583. package/dist/providers/jev-provider.js.map +7 -0
  584. package/dist/providers/mcp-descriptor-cache.d.ts +47 -0
  585. package/dist/providers/mcp-descriptor-cache.d.ts.map +1 -0
  586. package/dist/providers/mcp-provider.d.ts +47 -0
  587. package/dist/providers/mcp-provider.d.ts.map +1 -0
  588. package/dist/providers/memory-provider.d.ts +32 -0
  589. package/dist/providers/memory-provider.d.ts.map +1 -0
  590. package/dist/providers/memory-provider.js +23 -0
  591. package/dist/providers/memory-provider.js.map +7 -0
  592. package/dist/providers/mesh-provider.d.ts +17 -0
  593. package/dist/providers/mesh-provider.d.ts.map +1 -0
  594. package/dist/providers/pi-bash-cwd.d.ts +49 -0
  595. package/dist/providers/pi-bash-cwd.d.ts.map +1 -0
  596. package/dist/providers/pi-tools-provider.d.ts +25 -0
  597. package/dist/providers/pi-tools-provider.d.ts.map +1 -0
  598. package/dist/providers/schema-provider.d.ts +15 -0
  599. package/dist/providers/schema-provider.d.ts.map +1 -0
  600. package/dist/providers/state-provider.d.ts +16 -0
  601. package/dist/providers/state-provider.d.ts.map +1 -0
  602. package/dist/providers/write-diff-limits.d.ts +5 -0
  603. package/dist/providers/write-diff-limits.d.ts.map +1 -0
  604. package/dist/providers/write-preview.d.ts +3 -0
  605. package/dist/providers/write-preview.d.ts.map +1 -0
  606. package/dist/ref-names.d.ts +2 -0
  607. package/dist/ref-names.d.ts.map +1 -0
  608. package/dist/repairs/active.d.ts +7 -0
  609. package/dist/repairs/active.d.ts.map +1 -0
  610. package/dist/repairs/apply.d.ts +7 -0
  611. package/dist/repairs/apply.d.ts.map +1 -0
  612. package/dist/repairs/catalog-digest.d.ts +5 -0
  613. package/dist/repairs/catalog-digest.d.ts.map +1 -0
  614. package/dist/repairs/classify.d.ts +10 -0
  615. package/dist/repairs/classify.d.ts.map +1 -0
  616. package/dist/repairs/compiler.d.ts +33 -0
  617. package/dist/repairs/compiler.d.ts.map +1 -0
  618. package/dist/repairs/promote.d.ts +4 -0
  619. package/dist/repairs/promote.d.ts.map +1 -0
  620. package/dist/repairs/store.d.ts +10 -0
  621. package/dist/repairs/store.d.ts.map +1 -0
  622. package/dist/repairs/types.d.ts +49 -0
  623. package/dist/repairs/types.d.ts.map +1 -0
  624. package/dist/repeat-guard.d.ts +25 -0
  625. package/dist/repeat-guard.d.ts.map +1 -0
  626. package/dist/residency/actor-client.d.ts +16 -0
  627. package/dist/residency/actor-client.d.ts.map +1 -0
  628. package/dist/residency/actor-client.js +9 -0
  629. package/dist/residency/actor-client.js.map +7 -0
  630. package/dist/residency/client.d.ts +44 -0
  631. package/dist/residency/client.d.ts.map +1 -0
  632. package/dist/residency/host.d.ts +3 -0
  633. package/dist/residency/host.d.ts.map +1 -0
  634. package/dist/residency/host.js +32 -0
  635. package/dist/residency/host.js.map +7 -0
  636. package/dist/residency/launcher-owner.d.ts +7 -0
  637. package/dist/residency/launcher-owner.d.ts.map +1 -0
  638. package/dist/residency/launcher.d.ts +3 -0
  639. package/dist/residency/launcher.d.ts.map +1 -0
  640. package/dist/residency/launcher.js +154 -0
  641. package/dist/residency/launcher.js.map +7 -0
  642. package/dist/residency/pi-entry.d.ts +3 -0
  643. package/dist/residency/pi-entry.d.ts.map +1 -0
  644. package/dist/residency/pi-entry.js +48 -0
  645. package/dist/residency/pi-entry.js.map +7 -0
  646. package/dist/residency/protocol.d.ts +122 -0
  647. package/dist/residency/protocol.d.ts.map +1 -0
  648. package/dist/run-display.d.ts +3 -0
  649. package/dist/run-display.d.ts.map +1 -0
  650. package/dist/runtime/core-override-guest-types.d.ts +15 -0
  651. package/dist/runtime/core-override-guest-types.d.ts.map +1 -0
  652. package/dist/runtime/core-override-guest-types.js +9 -0
  653. package/dist/runtime/core-override-guest-types.js.map +7 -0
  654. package/dist/runtime/core-tool-properties.d.ts +6 -0
  655. package/dist/runtime/core-tool-properties.d.ts.map +1 -0
  656. package/dist/runtime/cpython-child-source.d.ts +2 -0
  657. package/dist/runtime/cpython-child-source.d.ts.map +1 -0
  658. package/dist/runtime/cpython-linux-sandbox.d.ts +2 -0
  659. package/dist/runtime/cpython-linux-sandbox.d.ts.map +1 -0
  660. package/dist/runtime/cpython-runtime.d.ts +9 -0
  661. package/dist/runtime/cpython-runtime.d.ts.map +1 -0
  662. package/dist/runtime/cpython-runtime.js +677 -0
  663. package/dist/runtime/cpython-runtime.js.map +7 -0
  664. package/dist/runtime/dynamic-guest-types.d.ts +3 -0
  665. package/dist/runtime/dynamic-guest-types.d.ts.map +1 -0
  666. package/dist/runtime/dynamic-guest-types.js +8 -0
  667. package/dist/runtime/dynamic-guest-types.js.map +7 -0
  668. package/dist/runtime/guest-code-repair.d.ts +2 -0
  669. package/dist/runtime/guest-code-repair.d.ts.map +1 -0
  670. package/dist/runtime/guest-stack-map.d.ts +11 -0
  671. package/dist/runtime/guest-stack-map.d.ts.map +1 -0
  672. package/dist/runtime/guest-types.d.ts +40 -0
  673. package/dist/runtime/guest-types.d.ts.map +1 -0
  674. package/dist/runtime/guest-types.js +13 -0
  675. package/dist/runtime/guest-types.js.map +7 -0
  676. package/dist/runtime/kernel.d.ts +30 -0
  677. package/dist/runtime/kernel.d.ts.map +1 -0
  678. package/dist/runtime/monty-bridge.d.ts +4 -0
  679. package/dist/runtime/monty-bridge.d.ts.map +1 -0
  680. package/dist/runtime/monty-runtime.d.ts +6 -0
  681. package/dist/runtime/monty-runtime.d.ts.map +1 -0
  682. package/dist/runtime/monty-runtime.js +485 -0
  683. package/dist/runtime/monty-runtime.js.map +7 -0
  684. package/dist/runtime/monty-source.d.ts +10 -0
  685. package/dist/runtime/monty-source.d.ts.map +1 -0
  686. package/dist/runtime/monty-values.d.ts +7 -0
  687. package/dist/runtime/monty-values.d.ts.map +1 -0
  688. package/dist/runtime/node-process-child-source.d.ts +2 -0
  689. package/dist/runtime/node-process-child-source.d.ts.map +1 -0
  690. package/dist/runtime/node-process-runtime.d.ts +10 -0
  691. package/dist/runtime/node-process-runtime.d.ts.map +1 -0
  692. package/dist/runtime/node-process-runtime.js +16 -0
  693. package/dist/runtime/node-process-runtime.js.map +7 -0
  694. package/dist/runtime/orchestration.d.ts +3 -0
  695. package/dist/runtime/orchestration.d.ts.map +1 -0
  696. package/dist/runtime/python-arguments.d.ts +2 -0
  697. package/dist/runtime/python-arguments.d.ts.map +1 -0
  698. package/dist/runtime/python-error-guidance.d.ts +6 -0
  699. package/dist/runtime/python-error-guidance.d.ts.map +1 -0
  700. package/dist/runtime/quickjs-runtime.d.ts +8 -0
  701. package/dist/runtime/quickjs-runtime.d.ts.map +1 -0
  702. package/dist/runtime/quickjs-runtime.js +15 -0
  703. package/dist/runtime/quickjs-runtime.js.map +7 -0
  704. package/dist/runtime/type-checker.d.ts +18 -0
  705. package/dist/runtime/type-checker.d.ts.map +1 -0
  706. package/dist/runtime/type-checker.js +11 -0
  707. package/dist/runtime/type-checker.js.map +7 -0
  708. package/dist/runtime/typescript-kernel.d.ts +14 -0
  709. package/dist/runtime/typescript-kernel.d.ts.map +1 -0
  710. package/dist/runtime/typescript-kernel.js +53 -0
  711. package/dist/runtime/typescript-kernel.js.map +7 -0
  712. package/dist/runtime-paths.d.ts +7 -0
  713. package/dist/runtime-paths.d.ts.map +1 -0
  714. package/dist/runtime-state-builtins.d.ts +26 -0
  715. package/dist/runtime-state-builtins.d.ts.map +1 -0
  716. package/dist/runtime-state-speculation.d.ts +16 -0
  717. package/dist/runtime-state-speculation.d.ts.map +1 -0
  718. package/dist/schema/controller.d.ts +35 -0
  719. package/dist/schema/controller.d.ts.map +1 -0
  720. package/dist/schema/policy.d.ts +2 -0
  721. package/dist/schema/policy.d.ts.map +1 -0
  722. package/dist/schema/types.d.ts +86 -0
  723. package/dist/schema/types.d.ts.map +1 -0
  724. package/dist/schema/workspace.d.ts +19 -0
  725. package/dist/schema/workspace.d.ts.map +1 -0
  726. package/dist/speculation/eligibility.d.ts +22 -0
  727. package/dist/speculation/eligibility.d.ts.map +1 -0
  728. package/dist/speculation/freshness.d.ts +10 -0
  729. package/dist/speculation/freshness.d.ts.map +1 -0
  730. package/dist/speculation/partial-json.d.ts +9 -0
  731. package/dist/speculation/partial-json.d.ts.map +1 -0
  732. package/dist/speculation/python-scanner.d.ts +7 -0
  733. package/dist/speculation/python-scanner.d.ts.map +1 -0
  734. package/dist/speculation/python-scanner.js +166 -0
  735. package/dist/speculation/python-scanner.js.map +7 -0
  736. package/dist/speculation/scanner.d.ts +13 -0
  737. package/dist/speculation/scanner.d.ts.map +1 -0
  738. package/dist/speculation/scanner.js +182 -0
  739. package/dist/speculation/scanner.js.map +7 -0
  740. package/dist/speculation/store.d.ts +41 -0
  741. package/dist/speculation/store.d.ts.map +1 -0
  742. package/dist/speculation/stream-tap.d.ts +30 -0
  743. package/dist/speculation/stream-tap.d.ts.map +1 -0
  744. package/dist/speculation/types.d.ts +44 -0
  745. package/dist/speculation/types.d.ts.map +1 -0
  746. package/dist/state/complexity.d.ts +13 -0
  747. package/dist/state/complexity.d.ts.map +1 -0
  748. package/dist/state/evidence-runner.d.ts +17 -0
  749. package/dist/state/evidence-runner.d.ts.map +1 -0
  750. package/dist/state/store.d.ts +76 -0
  751. package/dist/state/store.d.ts.map +1 -0
  752. package/dist/state/types.d.ts +165 -0
  753. package/dist/state/types.d.ts.map +1 -0
  754. package/dist/storage/retention.d.ts +22 -0
  755. package/dist/storage/retention.d.ts.map +1 -0
  756. package/dist/thinking.d.ts +19 -0
  757. package/dist/thinking.d.ts.map +1 -0
  758. package/dist/topology/control-plane.d.ts +58 -0
  759. package/dist/topology/control-plane.d.ts.map +1 -0
  760. package/dist/topology/participant-directory.d.ts +33 -0
  761. package/dist/topology/participant-directory.d.ts.map +1 -0
  762. package/dist/topology/peer-settle.d.ts +51 -0
  763. package/dist/topology/peer-settle.d.ts.map +1 -0
  764. package/dist/topology/records.d.ts +6 -0
  765. package/dist/topology/records.d.ts.map +1 -0
  766. package/dist/topology/types.d.ts +89 -0
  767. package/dist/topology/types.d.ts.map +1 -0
  768. package/dist/type-error-guidance.d.ts +3 -0
  769. package/dist/type-error-guidance.d.ts.map +1 -0
  770. package/dist/ui/arc-group.d.ts +17 -0
  771. package/dist/ui/arc-group.d.ts.map +1 -0
  772. package/dist/ui/border-status-editor.d.ts +22 -0
  773. package/dist/ui/border-status-editor.d.ts.map +1 -0
  774. package/dist/ui/code-preview-shell.d.ts +11 -0
  775. package/dist/ui/code-preview-shell.d.ts.map +1 -0
  776. package/dist/ui/code-preview.d.ts +53 -0
  777. package/dist/ui/code-preview.d.ts.map +1 -0
  778. package/dist/ui/controller.d.ts +20 -0
  779. package/dist/ui/controller.d.ts.map +1 -0
  780. package/dist/ui/conversation-chrome.d.ts +16 -0
  781. package/dist/ui/conversation-chrome.d.ts.map +1 -0
  782. package/dist/ui/conversation-chrome.js +11 -0
  783. package/dist/ui/conversation-chrome.js.map +7 -0
  784. package/dist/ui/conversation-commands.d.ts +12 -0
  785. package/dist/ui/conversation-commands.d.ts.map +1 -0
  786. package/dist/ui/conversation-history.d.ts +6 -0
  787. package/dist/ui/conversation-history.d.ts.map +1 -0
  788. package/dist/ui/conversation-host.d.ts +7 -0
  789. package/dist/ui/conversation-host.d.ts.map +1 -0
  790. package/dist/ui/conversation-host.js +9 -0
  791. package/dist/ui/conversation-host.js.map +7 -0
  792. package/dist/ui/conversation-native-reader-checkpoint.d.ts +8 -0
  793. package/dist/ui/conversation-native-reader-checkpoint.d.ts.map +1 -0
  794. package/dist/ui/conversation-native-reader-replay.d.ts +10 -0
  795. package/dist/ui/conversation-native-reader-replay.d.ts.map +1 -0
  796. package/dist/ui/conversation-native-reader.d.ts +110 -0
  797. package/dist/ui/conversation-native-reader.d.ts.map +1 -0
  798. package/dist/ui/conversation-native-reader.js +1050 -0
  799. package/dist/ui/conversation-native-reader.js.map +7 -0
  800. package/dist/ui/conversation-queue-store.d.ts +14 -0
  801. package/dist/ui/conversation-queue-store.d.ts.map +1 -0
  802. package/dist/ui/conversation-queue.d.ts +244 -0
  803. package/dist/ui/conversation-queue.d.ts.map +1 -0
  804. package/dist/ui/conversation-render.d.ts +104 -0
  805. package/dist/ui/conversation-render.d.ts.map +1 -0
  806. package/dist/ui/conversation-selection.d.ts +18 -0
  807. package/dist/ui/conversation-selection.d.ts.map +1 -0
  808. package/dist/ui/conversation-shortcut.d.ts +3 -0
  809. package/dist/ui/conversation-shortcut.d.ts.map +1 -0
  810. package/dist/ui/conversation-targets.d.ts +7 -0
  811. package/dist/ui/conversation-targets.d.ts.map +1 -0
  812. package/dist/ui/conversation-targets.js +12 -0
  813. package/dist/ui/conversation-targets.js.map +7 -0
  814. package/dist/ui/conversation-transcript.d.ts +25 -0
  815. package/dist/ui/conversation-transcript.d.ts.map +1 -0
  816. package/dist/ui/conversation.d.ts +219 -0
  817. package/dist/ui/conversation.d.ts.map +1 -0
  818. package/dist/ui/conversation.js +2861 -0
  819. package/dist/ui/conversation.js.map +7 -0
  820. package/dist/ui/core-tool-render.d.ts +20 -0
  821. package/dist/ui/core-tool-render.d.ts.map +1 -0
  822. package/dist/ui/dashboard-detail.d.ts +68 -0
  823. package/dist/ui/dashboard-detail.d.ts.map +1 -0
  824. package/dist/ui/dashboard-fabric-graph.d.ts +50 -0
  825. package/dist/ui/dashboard-fabric-graph.d.ts.map +1 -0
  826. package/dist/ui/dashboard-graph-controller.d.ts +52 -0
  827. package/dist/ui/dashboard-graph-controller.d.ts.map +1 -0
  828. package/dist/ui/dashboard-modal-controller.d.ts +36 -0
  829. package/dist/ui/dashboard-modal-controller.d.ts.map +1 -0
  830. package/dist/ui/dashboard-model.d.ts +111 -0
  831. package/dist/ui/dashboard-model.d.ts.map +1 -0
  832. package/dist/ui/dashboard-presentation.d.ts +6 -0
  833. package/dist/ui/dashboard-presentation.d.ts.map +1 -0
  834. package/dist/ui/dashboard.d.ts +156 -0
  835. package/dist/ui/dashboard.d.ts.map +1 -0
  836. package/dist/ui/dashboard.js +4622 -0
  837. package/dist/ui/dashboard.js.map +7 -0
  838. package/dist/ui/diff-background.d.ts +12 -0
  839. package/dist/ui/diff-background.d.ts.map +1 -0
  840. package/dist/ui/dynamic-border.d.ts +8 -0
  841. package/dist/ui/dynamic-border.d.ts.map +1 -0
  842. package/dist/ui/escape-halt.d.ts +11 -0
  843. package/dist/ui/escape-halt.d.ts.map +1 -0
  844. package/dist/ui/fabric-actor-delivery-selector.d.ts +17 -0
  845. package/dist/ui/fabric-actor-delivery-selector.d.ts.map +1 -0
  846. package/dist/ui/fabric-actor-tool-selector.d.ts +22 -0
  847. package/dist/ui/fabric-actor-tool-selector.d.ts.map +1 -0
  848. package/dist/ui/fabric-code-parser.d.ts +9 -0
  849. package/dist/ui/fabric-code-parser.d.ts.map +1 -0
  850. package/dist/ui/fabric-host-event-selector.d.ts +29 -0
  851. package/dist/ui/fabric-host-event-selector.d.ts.map +1 -0
  852. package/dist/ui/fabric-model-selector.d.ts +64 -0
  853. package/dist/ui/fabric-model-selector.d.ts.map +1 -0
  854. package/dist/ui/fabric-render.d.ts +113 -0
  855. package/dist/ui/fabric-render.d.ts.map +1 -0
  856. package/dist/ui/fabric-thinking-selector.d.ts +26 -0
  857. package/dist/ui/fabric-thinking-selector.d.ts.map +1 -0
  858. package/dist/ui/fabric-title-hint.d.ts +3 -0
  859. package/dist/ui/fabric-title-hint.d.ts.map +1 -0
  860. package/dist/ui/format.d.ts +9 -0
  861. package/dist/ui/format.d.ts.map +1 -0
  862. package/dist/ui/handoff-completion.d.ts +3 -0
  863. package/dist/ui/handoff-completion.d.ts.map +1 -0
  864. package/dist/ui/highlight.d.ts +69 -0
  865. package/dist/ui/highlight.d.ts.map +1 -0
  866. package/dist/ui/model-picker.d.ts +46 -0
  867. package/dist/ui/model-picker.d.ts.map +1 -0
  868. package/dist/ui/model-picker.js +17 -0
  869. package/dist/ui/model-picker.js.map +7 -0
  870. package/dist/ui/preview-lines.d.ts +16 -0
  871. package/dist/ui/preview-lines.d.ts.map +1 -0
  872. package/dist/ui/row-balance.d.ts +29 -0
  873. package/dist/ui/row-balance.d.ts.map +1 -0
  874. package/dist/ui/settings-component.d.ts +26 -0
  875. package/dist/ui/settings-component.d.ts.map +1 -0
  876. package/dist/ui/settings-rpc.d.ts +15 -0
  877. package/dist/ui/settings-rpc.d.ts.map +1 -0
  878. package/dist/ui/settings-section-context.d.ts +18 -0
  879. package/dist/ui/settings-section-context.d.ts.map +1 -0
  880. package/dist/ui/settings-sections-agents.d.ts +5 -0
  881. package/dist/ui/settings-sections-agents.d.ts.map +1 -0
  882. package/dist/ui/settings-sections-execution.d.ts +8 -0
  883. package/dist/ui/settings-sections-execution.d.ts.map +1 -0
  884. package/dist/ui/settings-sections-lifecycle.d.ts +6 -0
  885. package/dist/ui/settings-sections-lifecycle.d.ts.map +1 -0
  886. package/dist/ui/settings-sections-presentation.d.ts +6 -0
  887. package/dist/ui/settings-sections-presentation.d.ts.map +1 -0
  888. package/dist/ui/settings-sections.d.ts +12 -0
  889. package/dist/ui/settings-sections.d.ts.map +1 -0
  890. package/dist/ui/settings-submenus.d.ts +74 -0
  891. package/dist/ui/settings-submenus.d.ts.map +1 -0
  892. package/dist/ui/settings-values.d.ts +63 -0
  893. package/dist/ui/settings-values.d.ts.map +1 -0
  894. package/dist/ui/settings.d.ts +21 -0
  895. package/dist/ui/settings.d.ts.map +1 -0
  896. package/dist/ui/settings.js +1985 -0
  897. package/dist/ui/settings.js.map +7 -0
  898. package/dist/ui/shell-hang-keys.d.ts +11 -0
  899. package/dist/ui/shell-hang-keys.d.ts.map +1 -0
  900. package/dist/ui/shiki-language.d.ts +7 -0
  901. package/dist/ui/shiki-language.d.ts.map +1 -0
  902. package/dist/ui/shiki-theme.d.ts +7 -0
  903. package/dist/ui/shiki-theme.d.ts.map +1 -0
  904. package/dist/ui/snapshot.d.ts +17 -0
  905. package/dist/ui/snapshot.d.ts.map +1 -0
  906. package/dist/ui/spinner.d.ts +6 -0
  907. package/dist/ui/spinner.d.ts.map +1 -0
  908. package/dist/ui/state-file-preview.d.ts +13 -0
  909. package/dist/ui/state-file-preview.d.ts.map +1 -0
  910. package/dist/ui/structured.d.ts +9 -0
  911. package/dist/ui/structured.d.ts.map +1 -0
  912. package/dist/ui/tool-call-timing.d.ts +2 -0
  913. package/dist/ui/tool-call-timing.d.ts.map +1 -0
  914. package/dist/ui/tool-display.d.ts +8 -0
  915. package/dist/ui/tool-display.d.ts.map +1 -0
  916. package/dist/ui/topology.d.ts +162 -0
  917. package/dist/ui/topology.d.ts.map +1 -0
  918. package/dist/ui/transcript-parser.d.ts +18 -0
  919. package/dist/ui/transcript-parser.d.ts.map +1 -0
  920. package/dist/ui/transcript-reader.d.ts +10 -0
  921. package/dist/ui/transcript-reader.d.ts.map +1 -0
  922. package/dist/ui/transcript-sanitization.d.ts +14 -0
  923. package/dist/ui/transcript-sanitization.d.ts.map +1 -0
  924. package/dist/ui/transcript.d.ts +52 -0
  925. package/dist/ui/transcript.d.ts.map +1 -0
  926. package/dist/ui/types.d.ts +84 -0
  927. package/dist/ui/types.d.ts.map +1 -0
  928. package/dist/ui/widget.d.ts +16 -0
  929. package/dist/ui/widget.d.ts.map +1 -0
  930. package/dist/ui/word-diff/alignment.d.ts +6 -0
  931. package/dist/ui/word-diff/alignment.d.ts.map +1 -0
  932. package/dist/ui/word-diff/change-block.d.ts +18 -0
  933. package/dist/ui/word-diff/change-block.d.ts.map +1 -0
  934. package/dist/ui/word-diff/changed-line.d.ts +14 -0
  935. package/dist/ui/word-diff/changed-line.d.ts.map +1 -0
  936. package/dist/ui/word-diff/emphasis.d.ts +9 -0
  937. package/dist/ui/word-diff/emphasis.d.ts.map +1 -0
  938. package/dist/ui/word-diff/line-emphasis.d.ts +7 -0
  939. package/dist/ui/word-diff/line-emphasis.d.ts.map +1 -0
  940. package/dist/ui/word-diff/line-matching.d.ts +10 -0
  941. package/dist/ui/word-diff/line-matching.d.ts.map +1 -0
  942. package/dist/ui/word-diff/line-similarity.d.ts +16 -0
  943. package/dist/ui/word-diff/line-similarity.d.ts.map +1 -0
  944. package/dist/ui/word-diff/normalize.d.ts +3 -0
  945. package/dist/ui/word-diff/normalize.d.ts.map +1 -0
  946. package/dist/ui/word-diff/parse.d.ts +17 -0
  947. package/dist/ui/word-diff/parse.d.ts.map +1 -0
  948. package/dist/ui/word-diff/range-refinement.d.ts +5 -0
  949. package/dist/ui/word-diff/range-refinement.d.ts.map +1 -0
  950. package/dist/ui/word-diff/ranges.d.ts +11 -0
  951. package/dist/ui/word-diff/ranges.d.ts.map +1 -0
  952. package/dist/ui/word-diff/smart-filter.d.ts +3 -0
  953. package/dist/ui/word-diff/smart-filter.d.ts.map +1 -0
  954. package/dist/ui/word-diff/sparse-line-matching.d.ts +25 -0
  955. package/dist/ui/word-diff/sparse-line-matching.d.ts.map +1 -0
  956. package/dist/ui/word-diff/text-boundaries.d.ts +11 -0
  957. package/dist/ui/word-diff/text-boundaries.d.ts.map +1 -0
  958. package/dist/ui/word-diff/token-alignment.d.ts +9 -0
  959. package/dist/ui/word-diff/token-alignment.d.ts.map +1 -0
  960. package/dist/ui/word-diff/token-text-refinement.d.ts +4 -0
  961. package/dist/ui/word-diff/token-text-refinement.d.ts.map +1 -0
  962. package/dist/ui/word-diff/tokens.d.ts +16 -0
  963. package/dist/ui/word-diff/tokens.d.ts.map +1 -0
  964. package/dist/ui/word-diff/types.d.ts +10 -0
  965. package/dist/ui/word-diff/types.d.ts.map +1 -0
  966. package/dist/util.d.ts +3 -0
  967. package/dist/util.d.ts.map +1 -0
  968. package/dist/worker/model-control.d.ts +14 -0
  969. package/dist/worker/model-control.d.ts.map +1 -0
  970. package/dist/worker/model-control.js +118 -0
  971. package/dist/worker/model-control.js.map +7 -0
  972. package/dist/worker/options.d.ts +3 -0
  973. package/dist/worker/options.d.ts.map +1 -0
  974. package/dist/worker/options.js +156 -0
  975. package/dist/worker/options.js.map +7 -0
  976. package/dist/worker/run-record.d.ts +22 -0
  977. package/dist/worker/run-record.d.ts.map +1 -0
  978. package/dist/worker/run-record.js +124 -0
  979. package/dist/worker/run-record.js.map +7 -0
  980. package/dist/worker/session-export.d.ts +45 -0
  981. package/dist/worker/session-export.d.ts.map +1 -0
  982. package/dist/worker/session-export.js +91 -0
  983. package/dist/worker/session-export.js.map +7 -0
  984. package/dist/worker.d.ts +3 -0
  985. package/dist/worker.d.ts.map +1 -0
  986. package/dist/worker.js +1074 -0
  987. package/dist/worker.js.map +7 -0
  988. package/docs/agents.md +618 -0
  989. package/docs/architecture.md +141 -0
  990. package/docs/audit-trace.md +116 -0
  991. package/docs/certification.md +166 -0
  992. package/docs/compaction.md +345 -0
  993. package/docs/component-calculus.md +191 -0
  994. package/docs/components.md +330 -0
  995. package/docs/configuration.md +529 -0
  996. package/docs/entropy.md +214 -0
  997. package/docs/interface.md +210 -0
  998. package/docs/jev.md +289 -0
  999. package/docs/kernels.md +186 -0
  1000. package/docs/memory-recall.md +664 -0
  1001. package/docs/programmatic-compaction.md +205 -0
  1002. package/docs/provider-component-calculus.md +378 -0
  1003. package/docs/providers.md +163 -0
  1004. package/docs/repairs.md +90 -0
  1005. package/docs/residency-runtime.md +82 -0
  1006. package/docs/schema-enforcement.md +166 -0
  1007. package/docs/skills.md +50 -0
  1008. package/docs/speculation.md +171 -0
  1009. package/docs/state-layer.md +197 -0
  1010. package/package.json +135 -0
  1011. package/skillsets/python/fabric-advisor/SKILL.md +29 -0
  1012. package/skillsets/python/fabric-ambient/SKILL.md +44 -0
  1013. package/skillsets/python/fabric-ambient/references/setup.md +67 -0
  1014. package/skillsets/python/fabric-council/SKILL.md +54 -0
  1015. package/skillsets/python/fabric-exec/SKILL.md +74 -0
  1016. package/skillsets/python/fabric-exec/references/agents.md +65 -0
  1017. package/skillsets/python/fabric-exec/references/mcp.md +23 -0
  1018. package/skillsets/python/fabric-exec/references/mesh.md +27 -0
  1019. package/skillsets/python/fabric-fusion/SKILL.md +112 -0
  1020. package/skillsets/python/fabric-guide/SKILL.md +29 -0
  1021. package/skillsets/python/fabric-jev/SKILL.md +162 -0
  1022. package/skillsets/python/fabric-rlm/SKILL.md +120 -0
  1023. package/skillsets/python/fabric-schema/SKILL.md +55 -0
  1024. package/skillsets/python/fabric-spec/SKILL.md +42 -0
  1025. package/skillsets/python/fabric-supervisor/SKILL.md +37 -0
  1026. package/skillsets/python/fabric-swarm/SKILL.md +40 -0
  1027. package/skillsets/python/fabric-workflow/SKILL.md +62 -0
  1028. package/skillsets/typescript/fabric-advisor/SKILL.md +29 -0
  1029. package/skillsets/typescript/fabric-ambient/SKILL.md +44 -0
  1030. package/skillsets/typescript/fabric-ambient/references/setup.md +90 -0
  1031. package/skillsets/typescript/fabric-council/SKILL.md +94 -0
  1032. package/skillsets/typescript/fabric-exec/SKILL.md +142 -0
  1033. package/skillsets/typescript/fabric-exec/references/agents.md +218 -0
  1034. package/skillsets/typescript/fabric-exec/references/mcp.md +49 -0
  1035. package/skillsets/typescript/fabric-exec/references/mesh.md +51 -0
  1036. package/skillsets/typescript/fabric-fusion/SKILL.md +332 -0
  1037. package/skillsets/typescript/fabric-guide/SKILL.md +29 -0
  1038. package/skillsets/typescript/fabric-jev/SKILL.md +159 -0
  1039. package/skillsets/typescript/fabric-rlm/SKILL.md +284 -0
  1040. package/skillsets/typescript/fabric-schema/SKILL.md +121 -0
  1041. package/skillsets/typescript/fabric-spec/SKILL.md +42 -0
  1042. package/skillsets/typescript/fabric-supervisor/SKILL.md +37 -0
  1043. package/skillsets/typescript/fabric-swarm/SKILL.md +80 -0
  1044. package/skillsets/typescript/fabric-workflow/SKILL.md +133 -0
@@ -0,0 +1,664 @@
1
+ # Memory & Recall
2
+
3
+ Pi Fabric's `memory` provider searches Pi session JSONL files or explicit
4
+ host-backed session sources. The retained source records remain authoritative;
5
+ the memory index holds derived, disposable state.
6
+
7
+ Structural extraction is the only indexing method. Regexes never classify
8
+ goals, preferences, errors, or other prose concepts. Roles, tool names,
9
+ timestamps, entry IDs, operation addresses, exact `ref`/`provider`/`action`
10
+ identities, execution outcomes, tool errors, and tool argument paths all come
11
+ from typed session fields.
12
+
13
+ ## Retrieval workflow
14
+
15
+ Treat recall as navigation and expansion as reading:
16
+
17
+ 1. `memory.recall` locates ranked, bounded evidence.
18
+ 2. Inspect entry snippets directly. Every hit has one copy-ready `follow` call.
19
+ 3. Run `await tools.call(hit.follow)` to expand an entry or resolve a cold session.
20
+ 4. Continue any paged result with `await tools.call(result.next)` until `next` is `null`.
21
+ 5. Use guest-local `memory.walk` when TypeScript should scan, filter, reduce, join,
22
+ or traverse complete normalized records.
23
+
24
+ These calls are the supported session-data API. Consumers should not open,
25
+ scan, or parse Pi session files themselves. Follow calls carry source hashes and
26
+ selected lineages without duplicating that integrity metadata on each hit;
27
+ single-session page continuations preserve the same bindings. Coverage explains
28
+ when indexed absence is not authoritative.
29
+
30
+ ## Portable host sources
31
+
32
+ The lightweight `pi-fabric/memory` entry exports `PortableMemorySource`,
33
+ `MEMORY_SOURCE_INTERFACE_VERSION`, `defineMemorySource`,
34
+ `createMemorySourceRegistry`, `createMemorySourceClient`, and
35
+ `memoryActionSchemas`. It does not load the extension or UI runtime.
36
+
37
+ ```ts
38
+ import {
39
+ createMemorySourceClient,
40
+ createMemorySourceRegistry,
41
+ type PortableMemorySource,
42
+ } from "pi-fabric/memory";
43
+
44
+ function recallClient(authorizedSource: PortableMemorySource) {
45
+ const sources = createMemorySourceRegistry();
46
+ sources.register(authorizedSource);
47
+ return createMemorySourceClient({ sources, config: { maxSessions: 32 } });
48
+ }
49
+ ```
50
+
51
+ A source implements interface version `1`, has an opaque stable `id`, and
52
+ provides `listSessions({ limit, signal? })` and
53
+ `loadSession(sessionKey, { signal? })`. Session descriptors have an opaque
54
+ `sessionKey` and content-sensitive `revision`; snapshots add standard Pi
55
+ `records`. Optional `authorize(action, sessionKey)` is rechecked around
56
+ asynchronous reads. Bind principals and permissions in the host, never in
57
+ model-supplied arguments. The host also owns sanitization and retention.
58
+
59
+ Lists may return a descriptor array or `{ sessions, coverage }`; snapshots
60
+ also support `coverage: { complete: false, reason }`. Report every partial
61
+ projection or enumeration cap; a truncated archive is never presented as
62
+ complete. The engine preserves these reasons alongside its own work budgets.
63
+
64
+ Client `recall`, `expand`, and `sessions` calls require `args.source` and accept
65
+ `{ signal }` as their second argument. They use only the registered source,
66
+ never implicit filesystem discovery. Provider actions accept the same optional
67
+ `source` argument; omitting it preserves the normal filesystem behavior.
68
+ Source-qualified follow pointers and guest `memory.walk` retain this binding.
69
+
70
+ Host records reuse the normal branch, normalization, ranking, structural trace,
71
+ coverage, and lossless expansion paths. Revision/content hashes and lineage
72
+ fingerprints reject stale follow pointers. Host shards are rebuilt within
73
+ bounds for each call and are not persisted to the filesystem index.
74
+
75
+ These are explicit retrieval primitives. Fabric does not automatically recall
76
+ before a turn, inject historical context, choose bot/group permissions, or
77
+ require a hosted memory vendor. Such recipes belong to the embedding product.
78
+
79
+ ## Active branches
80
+
81
+ `memory.recall`, `memory.sessions`, and `memory.expand` accept
82
+ `branches: "active" | "all"`. Every scope defaults to `"active"`, including
83
+ `project`, `global`, and explicit `session:<id-or-path>` scopes. Only records
84
+ carried on each session's active parent-linked path contribute to hot text,
85
+ cold vocabulary, structural addresses, hits, and entry counts, so an
86
+ abandoned sibling cannot match by default. `branches: "all"` asks explicitly
87
+ for every branch. Expansion results and session rows identify their branch
88
+ mode; recall follow calls preserve it.
89
+
90
+ For the current live session, every memory action calls the extension
91
+ context's live `SessionManager.getBranch()` and `getLeafId()` getters.
92
+ These live reads observe `/tree` navigation even when no new record has
93
+ been appended. For another persisted session, Fabric follows Pi 0.80.6's
94
+ persisted semantics. The last persisted non-header entry serves as the
95
+ leaf, duplicate IDs resolve to the last record in the ID map, and Fabric
96
+ walks `parentId` links from that leaf to a root. Append order never counts as one transcript. When a parent
97
+ cycle occurs, Fabric stops defensively and marks coverage incomplete with
98
+ `invalid_parent_graph`.
99
+
100
+ Each derived record carries `branches` and a SHA-256 `lineageFingerprint`
101
+ over the selected branch mode, leaf, and active path IDs. Active and all
102
+ caches use separate filenames. Branch mode, lineage fingerprint, and privacy
103
+ settings all feed cache policy, so navigation, an append, or a policy change
104
+ rebuilds the relevant derived record without contaminating the other mode.
105
+ `sourceHash` still covers the complete JSONL source, including off-lineage
106
+ records.
107
+
108
+ ## Cache V6
109
+
110
+ Cache records carry `cacheVersion: 6`. Fabric removes older or malformed
111
+ records and rebuilds them from source. Rebuilding from source replaces any
112
+ migration of old records into V6. Refresh also clears orphan records,
113
+ records whose encoded cache path fails to match their source identity, and
114
+ records for deleted source sessions.
115
+
116
+ Every cache record stores the exact session file path, branch mode, lineage
117
+ fingerprint, privacy policy, and a SHA-256 `sourceHash`, along with source
118
+ mtime and size. A same-size rewrite that preserves mtime still invalidates
119
+ the record. Fabric creates cache directories with `0700` permissions and
120
+ cache files with `0600` permissions on a best-effort basis.
121
+
122
+ A hot shard holds bounded normalized entry text plus `indexCoverage`. Each
123
+ cold digest contains:
124
+
125
+ ```ts
126
+ {
127
+ cacheVersion: 6,
128
+ kind: "digest",
129
+ sessionId, file, cwd,
130
+ mtime, size, sourceHash,
131
+ branches, lineageFingerprint, policy,
132
+ firstTs, lastTs, entryCount,
133
+ filesTouched, toolHistogram, errorCount,
134
+ vocabulary, // sorted unique canonical strings, no posting lists
135
+ addresses, // structural identity + ref/provider/action/outcome postings
136
+ indexCoverage,
137
+ cacheBytes, cacheSourceRatio
138
+ }
139
+ ```
140
+
141
+ Cold vocabulary maps each exact lexical term only to the session that
142
+ contains it. The digest keeps no per-term entry indices. Structural address
143
+ tuples separately keep exact entry identity, role/tool/time, and persisted
144
+ `ref`/`provider`/`action`/`outcome` fields. A cold lexical result remains a
145
+ compact session candidate whose `follow` call carries its exact source and
146
+ hash bindings. It never appears as an inferred lexical entry range. Exact
147
+ lexical entry matches come back only after following that call.
148
+
149
+ `maxColdVocabularyBytes` bounds vocabulary construction for each session.
150
+ `maxColdCacheBytes` is a hard per-session cap on the persisted cache.
151
+ Reaching either cap sets `indexCoverage.complete` to false with an explicit
152
+ reason. The cache-size cap can force structural addresses or vocabulary to
153
+ persist as exact prefixes only. Fabric always reports this state as
154
+ `max_cold_cache_bytes` and never treats it as complete. `cacheSourceRatio`
155
+ divides persisted cache bytes by source bytes.
156
+
157
+ ## Capability heads and exact structural retrieval
158
+
159
+ Fabric separates capability navigation from memory evidence.
160
+ `tools.catalog()` returns a deterministic current tree:
161
+
162
+ ```text
163
+ Fabric capabilities
164
+ └── provider head
165
+ └── action head
166
+ ```
167
+
168
+ Provider/action names, descriptions, and descriptor hashes describe the
169
+ currently registered catalog. Full schemas stay available through
170
+ `tools.search()` and `tools.describe()`. A caller can use this metadata to
171
+ choose an action ref. Fabric never copies it into session entries.
172
+ Historical evidence comes from session records alone. Catalog descriptor
173
+ changes can shift discovery ranking. Historical structural membership stays
174
+ intact.
175
+
176
+ `memory.recall` accepts exact structural filters:
177
+
178
+ - `ref`, for example `pi.grep`.
179
+ - `provider`, for example `pi`.
180
+ - `action`, for example `grep`.
181
+ - `outcome`: one of `succeeded | failed | aborted | timed_out`.
182
+ - the existing `role`, `tool`, `since`, and `until` filters.
183
+
184
+ With no `query` present, persisted typed fields alone decide membership. A
185
+ `query` value constrains lexical or explicit-regex search with the same exact
186
+ filters. The result does not echo request diagnostics; the call already records
187
+ them. Catalog description text never becomes a lexical match.
188
+
189
+ ```ts
190
+ const heads = await tools.search({ query: "search source files" });
191
+ const history = await memory.recall({
192
+ scope: "project",
193
+ ref: heads[0]?.ref,
194
+ });
195
+ const failures = await memory.recall({
196
+ scope: "project",
197
+ query: "timeout",
198
+ ref: "agents.run",
199
+ outcome: "failed",
200
+ });
201
+ ```
202
+
203
+ A complete cold structural posting proves that the selected session contains
204
+ a matching typed entry. The cold response remains an integrity-bound session
205
+ candidate. A combined cold lexical + structural candidate cannot prove that
206
+ both conditions occur on the same entry, because cold vocabulary has no
207
+ posting lists. Coverage reports
208
+ `cold_structural_filter_requires_hydration`; follow the candidate before
209
+ claiming entry-level co-location.
210
+
211
+ ## Exact lexical queries
212
+
213
+ Callers choose `queryMode` explicitly:
214
+
215
+ - `"literal"` is the default token mode.
216
+ - `"phrase"` performs a case-insensitive contiguous text search after Unicode
217
+ normalization.
218
+ - `"regex"` requires an explicit opt-in.
219
+
220
+ Literal mode does not inspect punctuation to guess whether input is a regular
221
+ expression. It never compiles input with `RegExp`; a path such as `src/foo.ts`
222
+ stays literal text. Quotes are punctuation only in literal mode; quoted words
223
+ still become independent canonical terms and never turn into regex syntax.
224
+
225
+ `tokenize.ts` is the single canonical tokenizer for literal queries, hot BM25
226
+ scoring, and cold vocabulary creation. It applies Unicode NFKC normalization,
227
+ extracts Unicode letters, numbers, and `_` characters, then lowercases them.
228
+ Literal terms match through exact canonical-token equality. Fabric applies no
229
+ stemming, synonym expansion, or semantic regex classification.
230
+
231
+ Multi-term literal queries default to `queryMatch: "any"` so recall does not
232
+ silently lose an answer whose wording differs from the query. BM25 relevance
233
+ is weighted by typed provenance: assistant and user prose ranks ahead of
234
+ tool-call plumbing unless structural filters explicitly request operations.
235
+ Every exact entry is ranked individually; context-segment grouping cannot give
236
+ thousands of neighbors one shared score.
237
+
238
+ The response is still hard-bounded, so broad discovery cannot flood model
239
+ context. Request `queryMatch: "all"` when every canonical term must occur in
240
+ one indexed entry:
241
+
242
+ ```ts
243
+ memory.recall({
244
+ query: '"Use CEF" "Stage 1" browser Heddlework',
245
+ queryMatch: "all"
246
+ })
247
+ ```
248
+
249
+ Use `queryMode: "phrase"` when word order and adjacency are material. The
250
+ request is not echoed in the compact result.
251
+
252
+ In a cold session with complete coverage, every unique canonical token of the
253
+ normalized source text occurs exactly once in the sorted vocabulary. An
254
+ `all` query requires every term in that vocabulary, but the vocabulary cannot
255
+ prove same-entry co-location. Phrase adjacency cannot be proved either. Both
256
+ cases return an explicit incomplete cold-coverage reason until the session is
257
+ resolved. Rare terms stay exactly discoverable as
258
+ long as the configured vocabulary and cache bounds hold. Exceeding a bound
259
+ makes an empty result explicitly non-authoritative.
260
+
261
+ Unicode scalar count sets the hot-text limit. Raw UTF-16 code units play no
262
+ part. A cut cannot split a surrogate pair, and the shard text remains valid
263
+ UTF-8. Hot shards retain no separate complete tail vocabulary, so truncating
264
+ any normalized entry sets shard `indexCoverage.complete: false` with reason
265
+ `max_entry_chars`. A token that occurs only after the cut cannot yield an
266
+ authoritative no-match. Recall returns no hit and reports that reason through
267
+ `coverage`. Expansion still re-reads the complete source record.
268
+
269
+ ## Bounded regular expressions
270
+
271
+ Regex mode runs JavaScript regex inside a disposable worker thread. The host
272
+ never evaluates an untrusted pattern. Fabric terminates the worker forcibly
273
+ at the hard timeout, so catastrophic backtracking cannot continue on the
274
+ host thread. Four limits bound regex execution:
275
+
276
+ - UTF-8 pattern byte count.
277
+ - haystack item count.
278
+ - aggregate UTF-8 haystack bytes.
279
+ - wall-clock worker timeout.
280
+
281
+ A hot haystack is normalized entry text. A cold haystack is one bounded
282
+ canonical vocabulary term. Transcript prose never serves as a cold
283
+ haystack. Invalid patterns, oversized patterns, haystack truncation,
284
+ worker failures, and timeouts each return structured query coverage. A timeout, for example, returns `coverage.complete: false`, the
285
+ reason `regex_timeout`, and a structured `coverage.error`. An incomplete
286
+ regex result never counts as an authoritative no-match.
287
+
288
+ ## Tiers, refresh, and work budgets
289
+
290
+ The `memory.hotSessions` most recently modified sessions stay hot. Every
291
+ older session is cold. Once a session crosses the boundary, Fabric drops
292
+ the old derived tier record after building the replacement. Explicit
293
+ hydration re-reads source without promoting a cold session.
294
+
295
+ Session count and aggregate source bytes bound cache synchronization.
296
+ Cache cleanup follows budgets on inspected cache files and aggregate
297
+ cache bytes. The cleanup byte budget is shared with
298
+ `maxSyncSourceBytes`. Reaching a work budget stops additional indexing
299
+ and sets `coverage.complete: false`. All eligible sessions remain
300
+ counted. Fabric bounds every background job, and the index needs no
301
+ database dependency.
302
+
303
+ Query mode and no-query browse mode both discover every eligible session.
304
+ `memory.maxSessions` limits session listing only. Search materialization
305
+ works under explicit deterministic per-call budgets: 50,000 filtered hot
306
+ entry candidates, 10,000 cold digest candidates, and 10,000 ranked result
307
+ candidates. Hitting one of these marks coverage incomplete with
308
+ `candidate_entry_budget`, `candidate_digest_budget`, or
309
+ `candidate_item_budget`. Public totals count the retained exact entry hits
310
+ and cold session candidates after filtering. Unknown omitted candidates stay
311
+ outside those totals.
312
+ Coverage reports:
313
+
314
+ ```ts
315
+ coverage: {
316
+ complete: boolean,
317
+ indexedSessions: number,
318
+ eligibleSessions: number,
319
+ staleSessions: number,
320
+ incompleteSessions: number,
321
+ reasons: string[],
322
+ error?: { code: string, message: string }
323
+ }
324
+ ```
325
+
326
+ An empty `hits` array is authoritative only when cache/index coverage and
327
+ query execution coverage are both complete. Otherwise `coverage.reasons` names
328
+ causes such as source unavailability, `max_entry_chars`, duplicate identities,
329
+ vocabulary, file-metadata, or cache caps, candidate or synchronization budgets,
330
+ or regex limits.
331
+
332
+ ## Scopes
333
+
334
+ | Scope | Meaning |
335
+ | --- | --- |
336
+ | `session` | The current session, or the newest session for the current cwd. |
337
+ | `project` | All sessions in the current cwd's Pi session directory. |
338
+ | `global` | Sessions under the agent directory. This scope requires an explicit request and can never be the default. |
339
+ | `session:<id-or-path>` | One source session, resolved explicitly without promotion. |
340
+
341
+ Duplicate session IDs are ambiguous. `session:<id>` and `memory.expand`
342
+ reject an ambiguous ID with `ambiguous_session` and list the candidate paths.
343
+ Normal recall navigation does not require extracting a path: copy the hit
344
+ `follow` call unchanged.
345
+ Duplicate normalized entry IDs and operation addresses also mark index
346
+ coverage incomplete, with `duplicate_entry_id` or
347
+ `duplicate_operation_address`. Stable-address expansion demands exactly one
348
+ record. Zero matches return `address_not_found`. More than one match
349
+ returns `ambiguous_address`. Fabric returns no source records in either case.
350
+
351
+ ## Compact results and call tokens
352
+
353
+ `memory.recall` returns one flat, bounded hit stream:
354
+
355
+ ```ts
356
+ type FabricCall = {
357
+ ref: "memory.recall" | "memory.expand";
358
+ args: Record<string, unknown>;
359
+ };
360
+
361
+ type RecallPage = {
362
+ total: number;
363
+ hits: MemoryHit[];
364
+ next: FabricCall | null;
365
+ coverage: MemoryCoverage;
366
+ error?: MemoryError;
367
+ };
368
+ ```
369
+
370
+ `total` is the retained pre-page count of exact entry hits plus cold session
371
+ candidates. `hits.length` is the returned count. The request already records
372
+ query semantics, so results do not echo query terms, modes, filters, offsets,
373
+ or redundant counts and prose.
374
+
375
+ A hot or explicitly resolved entry hit carries evidence plus one action:
376
+
377
+ ```ts
378
+ {
379
+ kind: "entry",
380
+ sessionId,
381
+ tier,
382
+ index,
383
+ entryId,
384
+ parentId,
385
+ operationAddress,
386
+ type,
387
+ role,
388
+ tool,
389
+ ref,
390
+ provider,
391
+ action,
392
+ outcome,
393
+ timestamp,
394
+ isError,
395
+ score,
396
+ snippet,
397
+ truncated,
398
+ follow: { ref: "memory.expand", args: { /* integrity-bound selector */ } }
399
+ }
400
+ ```
401
+
402
+ A cold candidate cannot claim an exact source entry. It carries only
403
+ session-level evidence and a recall action:
404
+
405
+ ```ts
406
+ {
407
+ kind: "session",
408
+ sessionId,
409
+ tier: "cold",
410
+ cwd,
411
+ lastTimestamp,
412
+ score,
413
+ matchedTerms,
414
+ matchedStructuralEntries,
415
+ follow: { ref: "memory.recall", args: { /* integrity-bound request */ } }
416
+ }
417
+ ```
418
+
419
+ The integrity arguments live only inside `follow`; they are not duplicated in
420
+ separate source or action-specific pointer objects. Dispatch either hit without
421
+ branch-specific plumbing:
422
+
423
+ ```ts
424
+ const detail = await tools.call(hit.follow);
425
+ ```
426
+
427
+ When a statically typed result is useful, discriminate the hit and call the
428
+ known provider method:
429
+
430
+ ```ts
431
+ const detail = hit.kind === "entry"
432
+ ? await memory.expand(hit.follow.args)
433
+ : await memory.recall(hit.follow.args);
434
+ ```
435
+
436
+ Recall ranks one mixed stream and then paginates it. `pageSize` is a request
437
+ ceiling, not permission to exceed the hard 30,000-character JSON envelope.
438
+ If more retained items remain, `next` is another complete call token:
439
+
440
+ ```ts
441
+ let page = await memory.recall({ query: "timeout", scope: "project" });
442
+ while (page.next !== null) {
443
+ page = await memory.recall(page.next.args);
444
+ }
445
+ ```
446
+
447
+ A single-session continuation includes exact source-hash and lineage bindings;
448
+ an append or branch change returns `stale_pointer`, preventing a silent page
449
+ shift. Each project or global call takes a fresh, nontransactional snapshot.
450
+ Every snippet is independently bounded and reports only whether it was
451
+ truncated.
452
+
453
+ An optional inclusive `entryRange` can bound explicit single-session recall.
454
+ Both endpoints must be valid normalized indices. Out-of-range or negative
455
+ addresses return `index_out_of_bounds`; Fabric never clamps them.
456
+
457
+ ## Expansion and guest-local computation
458
+
459
+ `memory.expand` re-reads full, untruncated normalized records. It accepts
460
+ indices, stable entry IDs, operation addresses, or an inclusive range.
461
+ `before` and `after` add adjacent entries around exactly one selected anchor:
462
+
463
+ ```ts
464
+ const exact = await memory.expand(hit.follow.args);
465
+ const around = await memory.expand({
466
+ ...hit.follow.args,
467
+ before: 2,
468
+ after: 3,
469
+ });
470
+ const operation = await memory.expand({
471
+ session,
472
+ operationAddresses: ["entry-uuid/7"],
473
+ });
474
+ ```
475
+
476
+ Expansion results use `entries`. Recall and expansion both call the capability
477
+ field `tool`. Expanded records include Pi's `parentId`, so code can reconstruct
478
+ branch relationships under `branches: "all"`; `parentEntryId` remains the
479
+ separate carrier link for extracted Fabric child records.
480
+
481
+ Expansion never silently slices away a long record. Every returned chunk has
482
+ `textRange: { start, end, total, complete }`. A partial final entry returns a
483
+ non-null `next`; follow it to reconstruct the exact text:
484
+
485
+ ```ts
486
+ let chunk = await memory.expand(args);
487
+ while (chunk.next !== null && chunk.next !== undefined) {
488
+ chunk = await memory.expand(chunk.next.args);
489
+ }
490
+ ```
491
+
492
+ The default aggregate text budget is 20,000 characters and `maxChars` can
493
+ request a smaller chunk. Valid typed operation and branch-fact payloads stay
494
+ available as bounded structured fields. Oversized structured payloads set
495
+ `structuredTruncated` and stay out of the envelope.
496
+
497
+ For arbitrary filtering, projection, aggregation, joins, and parent traversal,
498
+ the query language is the surrounding TypeScript. `memory.walk` is a
499
+ guest-only combinator, not a fourth host action and not a serialized callback:
500
+
501
+ ```ts
502
+ const failedFiles = new Set<string>();
503
+ const parents = new Map<string, string | null>();
504
+
505
+ const walk = await memory.walk(
506
+ { session, branches: "all" },
507
+ async (entry) => {
508
+ if (entry.entryId) parents.set(entry.entryId, entry.parentId);
509
+ if (entry.outcome === "failed") {
510
+ for (const file of entry.filesTouched ?? []) {
511
+ if (file) failedFiles.add(file);
512
+ }
513
+ }
514
+ return failedFiles.size < 20; // exactly false stops early
515
+ },
516
+ );
517
+
518
+ return { files: [...failedFiles], visited: walk.visited };
519
+ ```
520
+
521
+ With no selector, `memory.walk` obtains an integrity-bound session range and
522
+ visits the whole normalized session. With a selector, it visits only that
523
+ selection and optional context. Start it from an original selection, not a
524
+ continuation with a nonzero `textOffset`, because every callback receives a
525
+ complete entry. The helper follows all expansion pages, validates continuity,
526
+ and reassembles each `textRange` fully before invoking the visitor,
527
+ awaits async visitors and nested tool calls, and returns `{visited, stopped}`.
528
+ A provider error is returned as `walk.error`. Functions remain inside the guest
529
+ runtime, isolated by default; no predicate source or closure crosses the host
530
+ bridge.
531
+
532
+ This is the Python replacement boundary: the host supplies bounded search and
533
+ lossless normalized records; the fabric program supplies callbacks, maps,
534
+ sets, joins, reductions, and the small final `return`. Do not add JSONPath,
535
+ SQL, projection, grouping, or host-evaluated predicate fields, and do not open
536
+ Pi session JSONL directly.
537
+
538
+ During recall follow calls and expansion, Fabric compares the expected source
539
+ hash and lineage fingerprint with the selected live or persisted session. A
540
+ rewrite, append, or active-leaf navigation that changes a binding returns
541
+ `stale_pointer` and no source content. Under active mode, an off-lineage stable
542
+ address returns `address_not_found`; `branches: "all"` is the explicit way to
543
+ read it.
544
+
545
+ A valid `FabricExecutionTraceV1` on an outer `fabric_exec` result emits one
546
+ child record per operation, placed immediately after the outer normalized
547
+ entry. Each child keeps `parentEntryId`, `operationAddress`, the exact
548
+ `tool`, `ref`, `provider`, `action`, typed `filesTouched`, `outcome`, and a
549
+ bounded structured `operation` object. Expansion re-reads and
550
+ re-normalizes source. Fabric never reconstructs operations from output
551
+ prose.
552
+
553
+ Valid `FabricBranchSummaryDetailsV1` and V2 envelopes emit typed child
554
+ records for user, phase, and operation facts. Under V2, they also emit
555
+ children for named `fabricRun` facts. Run children keep the bounded declared
556
+ name and description, the paired aggregate outcome, and the original call
557
+ address. They index as `fabric_exec` and expand by that operation address.
558
+ Other children keep the original fact address, the
559
+ ref/provider/action/tool/outcome/arguments values, and the structurally
560
+ derived paths, plus `carrierEntryId`, `carrierParentId`, and
561
+ `carrierFromId`. Operation facts expand by their original operation address.
562
+ User and phase facts use that address as their stable entry ID. Fabric
563
+ deduplicates repeated nested summaries by exact fact address in source
564
+ order, which keeps the earliest carrier deterministic. Inside each consumed
565
+ details envelope, addresses must be unique. Fabric rejects an envelope with
566
+ a duplicate address and marks coverage incomplete. Unknown or malformed
567
+ details and all branch-summary prose remain non-semantic.
568
+
569
+ ## Local-cache privacy and deletion
570
+
571
+ Treat the memory index as local derived state. It sets no encryption or
572
+ semantic-privacy boundary. Depending on configuration and tier, cache JSON
573
+ can retain plaintext lexical vocabulary, cwd and file paths, source
574
+ pointers and hashes, structural tool and capability metadata, selected
575
+ user/assistant/custom-message content, tool arguments, and selected tool
576
+ output when the default `indexToolOutput: true` applies. Cold vocabulary
577
+ holds no posting lists. The exact words still appear in it as plaintext.
578
+ Thinking text stays excluded by default. Enabling it explicitly stores it
579
+ as plaintext. Fabric runs no secret scanning. Privacy here comes from
580
+ structural inclusion or exclusion, and regex classification plays no
581
+ part.
582
+
583
+ Fabric requests `0700` for cache directories and `0600` for cache files.
584
+ These permissions are best effort and inherit the host filesystem, account,
585
+ backup, and administrative trust model. The cache stays unencrypted. Fabric
586
+ reads project configuration only for a project that Pi has marked trusted.
587
+ Otherwise, only global Fabric configuration applies. A `global` memory
588
+ search is an explicit scope, never the default. Under that explicit scope,
589
+ global indexing still creates local derived records for the sessions that
590
+ the call selects.
591
+
592
+ Deleting a Pi session removes the source of truth. A later memory refresh
593
+ removes the orphaned cache records on a best-effort basis. When immediate
594
+ cache removal is required, delete the configured `memory.indexDir` as
595
+ well.
596
+ Removing that directory is safe, because every record is disposable and
597
+ rebuilt from the remaining session JSONL. Cache deletion leaves source
598
+ sessions, filesystem backups, and copies outside the index directory
599
+ untouched.
600
+
601
+ ## Benchmarking capability-head retrieval
602
+
603
+ After changes to discovery, structural postings, ranking, or cache layout,
604
+ run the deterministic synthetic benchmark:
605
+
606
+ ```sh
607
+ bun run benchmark:memory-heads
608
+ ```
609
+
610
+ The benchmark reports catalog head selection separately from source
611
+ retrieval, hot exact operation-address recall, cold session recall, combined
612
+ lexical + structural retrieval, negative controls, the cold digest/source
613
+ ratio, and p50/p95/p99 search latency. The command fails when catalog
614
+ description text leaks into lexical matches, structural provenance is lost,
615
+ cold combined candidates omit the hydration requirement, or a nonexistent
616
+ ref returns history. Repository tests cover source JSONL, branches, staleness, and cache generation.
617
+ The synthetic timing corpus covers the measured search paths.
618
+
619
+ ## Configuration
620
+
621
+ ```json
622
+ {
623
+ "memory": {
624
+ "enabled": true,
625
+ "indexDir": "~/.pi/agent/fabric/memory-index",
626
+ "maxSessions": 500,
627
+ "maxEntryChars": 2000,
628
+ "indexThinking": false,
629
+ "indexToolOutput": true,
630
+ "hotSessions": 50,
631
+ "maxColdVocabularyBytes": 524288,
632
+ "maxColdCacheBytes": 1048576,
633
+ "maxSyncSessions": 10000,
634
+ "maxSyncSourceBytes": 536870912,
635
+ "maxCacheCleanupFiles": 100000,
636
+ "regexMaxPatternBytes": 1024,
637
+ "regexMaxHaystackTerms": 20000,
638
+ "regexMaxHaystackBytes": 2097152,
639
+ "regexTimeoutMs": 250
640
+ }
641
+ }
642
+ ```
643
+
644
+ - `maxSessions`: limits session-list discovery only. Candidate and indexing
645
+ budgets control recall.
646
+ - `maxEntryChars`: Unicode-scalar limit for persisted hot entry text. Any
647
+ cut marks lexical coverage incomplete, and expand still re-reads full
648
+ source.
649
+ - `indexThinking`: when true, assistant thinking blocks enter normalized
650
+ text and lexical vocabulary. Default: false.
651
+ - `indexToolOutput`: when true, tool-result bodies, bash output, and typed
652
+ Fabric operation results enter derived text. Default: true. Coding recall then includes tool outputs. When false, typed tool name/ref/action,
653
+ error/outcome, and structurally extracted path metadata stay searchable.
654
+ Output bodies do not.
655
+ - `hotSessions`: count of globally newest sessions that keep hot shards.
656
+ - `maxColdVocabularyBytes`: per-session bound on the canonical vocabulary.
657
+ - `maxColdCacheBytes`: hard per-session bound on the cold cache file.
658
+ - `maxSyncSessions` / `maxSyncSourceBytes`: work budgets for synchronous
659
+ indexing.
660
+ - `maxCacheCleanupFiles`: count budget for synchronous cache-file cleanup.
661
+ Cleanup bytes draw on `maxSyncSourceBytes`.
662
+ - `regexMaxPatternBytes`, `regexMaxHaystackTerms`,
663
+ `regexMaxHaystackBytes`, `regexTimeoutMs`: bounds on isolated regex
664
+ execution.