@e4779/pi-fabric 0.102.0-fork.16 → 0.105.0-fork.22

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 (562) hide show
  1. package/README.md +44 -13
  2. package/THIRD_PARTY_NOTICES.md +10 -2
  3. package/dist/activity/store.d.ts +3 -0
  4. package/dist/activity/store.d.ts.map +1 -1
  5. package/dist/activity/workflow-items.d.ts +33 -0
  6. package/dist/activity/workflow-items.d.ts.map +1 -0
  7. package/dist/actors/binding-store.d.ts.map +1 -1
  8. package/dist/actors/manager.d.ts +6 -0
  9. package/dist/actors/manager.d.ts.map +1 -1
  10. package/dist/actors/mesh-monitor.d.ts +2 -2
  11. package/dist/actors/mesh-monitor.d.ts.map +1 -1
  12. package/dist/actors/registry-store.d.ts.map +1 -1
  13. package/dist/actors/types.d.ts +11 -0
  14. package/dist/actors/types.d.ts.map +1 -1
  15. package/dist/agents/child-env.d.ts +29 -0
  16. package/dist/agents/child-env.d.ts.map +1 -0
  17. package/dist/agents/fork-seed.d.ts +21 -0
  18. package/dist/agents/fork-seed.d.ts.map +1 -0
  19. package/dist/agents/handoff.d.ts +7 -1
  20. package/dist/agents/handoff.d.ts.map +1 -1
  21. package/dist/agents/hosted-run.d.ts +63 -0
  22. package/dist/agents/hosted-run.d.ts.map +1 -0
  23. package/dist/agents/manager.d.ts +21 -1
  24. package/dist/agents/manager.d.ts.map +1 -1
  25. package/dist/agents/request.d.ts.map +1 -1
  26. package/dist/agents/runner-notice.d.ts +7 -0
  27. package/dist/agents/runner-notice.d.ts.map +1 -0
  28. package/dist/agents/runner-protocol.d.ts +158 -0
  29. package/dist/agents/runner-protocol.d.ts.map +1 -0
  30. package/dist/agents/runner-registry.d.ts +223 -0
  31. package/dist/agents/runner-registry.d.ts.map +1 -0
  32. package/dist/agents/transports/process-transport.d.ts.map +1 -1
  33. package/dist/agents/transports/process-utils.d.ts +4 -1
  34. package/dist/agents/transports/process-utils.d.ts.map +1 -1
  35. package/dist/agents/types.d.ts +89 -4
  36. package/dist/agents/types.d.ts.map +1 -1
  37. package/dist/agents/worktree-manager.d.ts +21 -0
  38. package/dist/agents/worktree-manager.d.ts.map +1 -1
  39. package/dist/agents/write-guard.d.ts +16 -0
  40. package/dist/agents/write-guard.d.ts.map +1 -0
  41. package/dist/agents/write-guard.js +13 -0
  42. package/dist/agents/write-guard.js.map +7 -0
  43. package/dist/agents.js +13 -12
  44. package/dist/agents.js.map +1 -1
  45. package/dist/assessment.d.ts +3 -0
  46. package/dist/assessment.d.ts.map +1 -0
  47. package/dist/assessment.js +15 -0
  48. package/dist/assessment.js.map +7 -0
  49. package/dist/audit/assessment.d.ts +74 -0
  50. package/dist/audit/assessment.d.ts.map +1 -0
  51. package/dist/audit/details.d.ts +4 -0
  52. package/dist/audit/details.d.ts.map +1 -1
  53. package/dist/audit/index.d.ts +1 -0
  54. package/dist/audit/index.d.ts.map +1 -1
  55. package/dist/audit/projection.d.ts +2 -1
  56. package/dist/audit/projection.d.ts.map +1 -1
  57. package/dist/audit/trace.d.ts +16 -1
  58. package/dist/audit/trace.d.ts.map +1 -1
  59. package/dist/cache/leases.d.ts +2 -1
  60. package/dist/cache/leases.d.ts.map +1 -1
  61. package/dist/capture/interceptor.d.ts.map +1 -1
  62. package/dist/chunks/chunk-2USMWEE6.js +81 -0
  63. package/dist/chunks/chunk-2USMWEE6.js.map +7 -0
  64. package/dist/chunks/chunk-2Y24ML7H.js +115 -0
  65. package/dist/chunks/chunk-2Y24ML7H.js.map +7 -0
  66. package/dist/chunks/chunk-3GJJG2FV.js +1329 -0
  67. package/dist/chunks/chunk-3GJJG2FV.js.map +7 -0
  68. package/dist/chunks/{chunk-5VTBHJN3.js → chunk-3KDUMDPZ.js} +153 -29
  69. package/dist/chunks/chunk-3KDUMDPZ.js.map +7 -0
  70. package/dist/chunks/chunk-4RTHQGES.js +189 -0
  71. package/dist/chunks/chunk-4RTHQGES.js.map +7 -0
  72. package/dist/chunks/{chunk-ZZ66L3W5.js → chunk-5MNLVHF5.js} +30 -7
  73. package/dist/chunks/chunk-5MNLVHF5.js.map +7 -0
  74. package/dist/chunks/{chunk-RAO6TQFP.js → chunk-5XBYFSI5.js} +26 -6
  75. package/dist/chunks/chunk-5XBYFSI5.js.map +7 -0
  76. package/dist/chunks/{chunk-J2HV2URQ.js → chunk-7EYJE4TW.js} +1 -1
  77. package/dist/chunks/{chunk-J2HV2URQ.js.map → chunk-7EYJE4TW.js.map} +2 -2
  78. package/dist/chunks/{chunk-57CMH4SW.js → chunk-7JU7Z4XQ.js} +2 -2
  79. package/dist/chunks/chunk-7QKKLBHJ.js +33 -0
  80. package/dist/chunks/chunk-7QKKLBHJ.js.map +7 -0
  81. package/dist/chunks/chunk-7XRUMDV7.js +235 -0
  82. package/dist/chunks/chunk-7XRUMDV7.js.map +7 -0
  83. package/dist/chunks/{chunk-DUJ46TIP.js → chunk-ABJCSNZO.js} +4 -4
  84. package/dist/chunks/chunk-B2Y4364O.js +78 -0
  85. package/dist/chunks/chunk-B2Y4364O.js.map +7 -0
  86. package/dist/chunks/{chunk-4TKPBEPB.js → chunk-BVJBYFHD.js} +9 -3
  87. package/dist/chunks/{chunk-4TKPBEPB.js.map → chunk-BVJBYFHD.js.map} +2 -2
  88. package/dist/chunks/{chunk-KP4ANT6L.js → chunk-C7EEG6SM.js} +2 -2
  89. package/dist/chunks/{chunk-NHMICIEU.js → chunk-CCHZXF6K.js} +3 -3
  90. package/dist/chunks/{chunk-W63E3WEO.js → chunk-CXTTLBUV.js} +3 -2
  91. package/dist/chunks/chunk-CXTTLBUV.js.map +7 -0
  92. package/dist/chunks/{chunk-HOX6VW45.js → chunk-CYMDX3XP.js} +1 -1
  93. package/dist/chunks/{chunk-HOX6VW45.js.map → chunk-CYMDX3XP.js.map} +1 -1
  94. package/dist/chunks/chunk-DK35W6U7.js +259 -0
  95. package/dist/chunks/chunk-DK35W6U7.js.map +7 -0
  96. package/dist/chunks/{chunk-5JN5AWNV.js → chunk-DZ4WN5XJ.js} +3 -3
  97. package/dist/chunks/chunk-EXWS4ZS3.js +6490 -0
  98. package/dist/chunks/chunk-EXWS4ZS3.js.map +7 -0
  99. package/dist/chunks/{chunk-QHYBSIIO.js → chunk-FB24AOIJ.js} +39 -37
  100. package/dist/chunks/{chunk-QHYBSIIO.js.map → chunk-FB24AOIJ.js.map} +1 -1
  101. package/dist/chunks/chunk-FSB2VIRZ.js +435 -0
  102. package/dist/chunks/chunk-FSB2VIRZ.js.map +7 -0
  103. package/dist/chunks/{chunk-PNDYFU64.js → chunk-GJVPP3NN.js} +81 -11
  104. package/dist/chunks/chunk-GJVPP3NN.js.map +7 -0
  105. package/dist/chunks/{chunk-B5D6GA77.js → chunk-GYPDGW27.js} +100 -92
  106. package/dist/chunks/chunk-GYPDGW27.js.map +7 -0
  107. package/dist/chunks/{chunk-LEFBW2GK.js → chunk-IAFI4A2I.js} +44 -2
  108. package/dist/chunks/{chunk-LEFBW2GK.js.map → chunk-IAFI4A2I.js.map} +3 -3
  109. package/dist/chunks/{chunk-PWS2OXLV.js → chunk-IIPKG52D.js} +1 -1
  110. package/dist/chunks/chunk-IIPKG52D.js.map +7 -0
  111. package/dist/chunks/chunk-ITVLKXCI.js +266 -0
  112. package/dist/chunks/chunk-ITVLKXCI.js.map +7 -0
  113. package/dist/chunks/chunk-JKQARSWR.js +265 -0
  114. package/dist/chunks/chunk-JKQARSWR.js.map +7 -0
  115. package/dist/chunks/{chunk-AYBIR4YV.js → chunk-KJZAOENY.js} +6 -4
  116. package/dist/chunks/chunk-KJZAOENY.js.map +7 -0
  117. package/dist/chunks/{chunk-74BA4VSX.js → chunk-KQ6R5EWR.js} +1462 -1405
  118. package/dist/chunks/chunk-KQ6R5EWR.js.map +7 -0
  119. package/dist/chunks/chunk-L22K5BWU.js +180 -0
  120. package/dist/chunks/chunk-L22K5BWU.js.map +7 -0
  121. package/dist/chunks/{chunk-7XJB2USB.js → chunk-LOLCTWJF.js} +4 -4
  122. package/dist/chunks/{chunk-QETG2GVX.js → chunk-M5IN6DMF.js} +34 -31
  123. package/dist/chunks/chunk-M5IN6DMF.js.map +7 -0
  124. package/dist/chunks/{chunk-64O5L7EW.js → chunk-M6IRQ3QT.js} +2 -2
  125. package/dist/chunks/{chunk-TX6E5W7H.js → chunk-NTC2MCB6.js} +1 -1
  126. package/dist/chunks/chunk-NTC2MCB6.js.map +7 -0
  127. package/dist/chunks/{chunk-EPYLZWJV.js → chunk-OVBKQCYL.js} +2 -2
  128. package/dist/chunks/{chunk-YV2PHCDB.js → chunk-PYFJW3HC.js} +16 -2
  129. package/dist/chunks/{chunk-YV2PHCDB.js.map → chunk-PYFJW3HC.js.map} +3 -3
  130. package/dist/chunks/{chunk-Z5Y65YBX.js → chunk-PYQM7KPL.js} +3 -2
  131. package/dist/chunks/{chunk-BEJF2JX2.js → chunk-QLFDPXK7.js} +33 -2
  132. package/dist/chunks/chunk-QLFDPXK7.js.map +7 -0
  133. package/dist/chunks/chunk-QUWC6YCN.js +125 -0
  134. package/dist/chunks/chunk-QUWC6YCN.js.map +7 -0
  135. package/dist/chunks/{chunk-DKVJREDI.js → chunk-QY7YK7M6.js} +2 -2
  136. package/dist/chunks/{chunk-WMJ2AVQQ.js → chunk-R5F6CHW2.js} +34 -18
  137. package/dist/chunks/chunk-R5F6CHW2.js.map +7 -0
  138. package/dist/chunks/chunk-S3IRPDSO.js +57 -0
  139. package/dist/chunks/chunk-S3IRPDSO.js.map +7 -0
  140. package/dist/chunks/{chunk-7BG5COXB.js → chunk-SVDHQUTM.js} +21 -4
  141. package/dist/chunks/chunk-SVDHQUTM.js.map +7 -0
  142. package/dist/chunks/{chunk-HG4DMARW.js → chunk-T5CU2GPZ.js} +116 -26
  143. package/dist/chunks/chunk-T5CU2GPZ.js.map +7 -0
  144. package/dist/chunks/{chunk-RIFG4HS6.js → chunk-TFFZVLR2.js} +141 -9
  145. package/dist/chunks/chunk-TFFZVLR2.js.map +7 -0
  146. package/dist/chunks/{chunk-BUQZBG6O.js → chunk-U2UBUKNQ.js} +136 -136
  147. package/dist/chunks/chunk-U2UBUKNQ.js.map +7 -0
  148. package/dist/chunks/chunk-U366I5K2.js +363 -0
  149. package/dist/chunks/chunk-U366I5K2.js.map +7 -0
  150. package/dist/chunks/{chunk-4NF3S3NM.js → chunk-UTOBAZ5T.js} +1 -1
  151. package/dist/chunks/chunk-UTOBAZ5T.js.map +7 -0
  152. package/dist/chunks/chunk-V73NIH6B.js +127 -0
  153. package/dist/chunks/chunk-V73NIH6B.js.map +7 -0
  154. package/dist/chunks/{chunk-PN4EKNRE.js → chunk-VON4TSO3.js} +132 -12
  155. package/dist/chunks/chunk-VON4TSO3.js.map +7 -0
  156. package/dist/chunks/{chunk-5ZJV4LAX.js → chunk-VPRJOD4Y.js} +4 -4
  157. package/dist/chunks/{chunk-FDIEQEXS.js → chunk-VSDUSNIA.js} +4 -4
  158. package/dist/chunks/chunk-VSDUSNIA.js.map +7 -0
  159. package/dist/chunks/{chunk-RG22JKIC.js → chunk-W7X4XEQU.js} +2 -2
  160. package/dist/chunks/{chunk-LV4IT75S.js → chunk-WLLXKS6I.js} +2 -2
  161. package/dist/chunks/chunk-WOLUDZVR.js +197 -0
  162. package/dist/chunks/chunk-WOLUDZVR.js.map +7 -0
  163. package/dist/chunks/{chunk-YVDBHS4C.js → chunk-WREA4RNR.js} +3 -3
  164. package/dist/chunks/{chunk-QE2JFB7F.js → chunk-WYUV6WL3.js} +16 -6
  165. package/dist/chunks/chunk-WYUV6WL3.js.map +7 -0
  166. package/dist/chunks/{chunk-NGGI6LDC.js → chunk-X2TRSE7D.js} +2 -2
  167. package/dist/chunks/{chunk-VRAGOMN4.js → chunk-YRDCJZZW.js} +34 -1
  168. package/dist/chunks/chunk-YRDCJZZW.js.map +7 -0
  169. package/dist/chunks/{chunk-CC63CY6R.js → chunk-YYSZBD7S.js} +17 -261
  170. package/dist/chunks/chunk-YYSZBD7S.js.map +7 -0
  171. package/dist/chunks/{chunk-A4VP7HDF.js → chunk-ZLNJDTCN.js} +2 -2
  172. package/dist/chunks/{chunk-G4CSXNBT.js → chunk-ZXKYU6CH.js} +42 -5
  173. package/dist/chunks/chunk-ZXKYU6CH.js.map +7 -0
  174. package/dist/cli/decisions.d.ts +8 -0
  175. package/dist/cli/decisions.d.ts.map +1 -0
  176. package/dist/cli/decisions.js +131 -0
  177. package/dist/cli/decisions.js.map +7 -0
  178. package/dist/cli/index.d.ts +3 -0
  179. package/dist/cli/index.d.ts.map +1 -0
  180. package/dist/cli/index.js +56 -0
  181. package/dist/cli/index.js.map +7 -0
  182. package/dist/cli/mesh.d.ts +3 -0
  183. package/dist/cli/mesh.d.ts.map +1 -0
  184. package/dist/cli/mesh.js +126 -0
  185. package/dist/cli/mesh.js.map +7 -0
  186. package/dist/commands/fabric.d.ts.map +1 -1
  187. package/dist/compaction/carry.d.ts +23 -0
  188. package/dist/compaction/carry.d.ts.map +1 -0
  189. package/dist/compaction/hook.d.ts +9 -0
  190. package/dist/compaction/hook.d.ts.map +1 -1
  191. package/dist/compaction/hook.js +6 -6
  192. package/dist/compaction/orphan-repair.d.ts +11 -0
  193. package/dist/compaction/orphan-repair.d.ts.map +1 -0
  194. package/dist/compaction/orphan-repair.js +75 -0
  195. package/dist/compaction/orphan-repair.js.map +7 -0
  196. package/dist/compaction/owner.d.ts +26 -0
  197. package/dist/compaction/owner.d.ts.map +1 -0
  198. package/dist/compaction/owner.js +26 -0
  199. package/dist/compaction/owner.js.map +7 -0
  200. package/dist/compaction/pressure.d.ts +19 -0
  201. package/dist/compaction/pressure.d.ts.map +1 -0
  202. package/dist/compaction/render.d.ts +4 -0
  203. package/dist/compaction/render.d.ts.map +1 -1
  204. package/dist/compaction/threshold.d.ts +6 -1
  205. package/dist/compaction/threshold.d.ts.map +1 -1
  206. package/dist/components/configuration.js +6 -6
  207. package/dist/components/provider-component.d.ts +1 -1
  208. package/dist/components/provider-component.d.ts.map +1 -1
  209. package/dist/config.d.ts +45 -2
  210. package/dist/config.d.ts.map +1 -1
  211. package/dist/core/action-registry.d.ts +5 -1
  212. package/dist/core/action-registry.d.ts.map +1 -1
  213. package/dist/core/action-registry.js +8 -8
  214. package/dist/core/approval-controller.d.ts +5 -1
  215. package/dist/core/approval-controller.d.ts.map +1 -1
  216. package/dist/core/approval-overrides.d.ts +11 -0
  217. package/dist/core/approval-overrides.d.ts.map +1 -0
  218. package/dist/core/atomic-write.d.ts +77 -0
  219. package/dist/core/atomic-write.d.ts.map +1 -1
  220. package/dist/core/compact-controller.d.ts +8 -0
  221. package/dist/core/compact-controller.d.ts.map +1 -1
  222. package/dist/core/file-lock.d.ts.map +1 -1
  223. package/dist/core/foreground-tools.d.ts +45 -0
  224. package/dist/core/foreground-tools.d.ts.map +1 -0
  225. package/dist/core/provider-bindings.d.ts +10 -1
  226. package/dist/core/provider-bindings.d.ts.map +1 -1
  227. package/dist/core/provider-operations.js.map +1 -1
  228. package/dist/core/tool-ownership.d.ts +18 -2
  229. package/dist/core/tool-ownership.d.ts.map +1 -1
  230. package/dist/decisions/command.d.ts +5 -0
  231. package/dist/decisions/command.d.ts.map +1 -0
  232. package/dist/decisions/command.js +74 -0
  233. package/dist/decisions/command.js.map +7 -0
  234. package/dist/decisions/host.d.ts +24 -0
  235. package/dist/decisions/host.d.ts.map +1 -0
  236. package/dist/decisions/store.d.ts +147 -0
  237. package/dist/decisions/store.d.ts.map +1 -0
  238. package/dist/durable.d.ts +38 -0
  239. package/dist/durable.d.ts.map +1 -0
  240. package/dist/durable.js +274 -0
  241. package/dist/durable.js.map +7 -0
  242. package/dist/entropy/index.js +10 -9
  243. package/dist/execution-service.d.ts +41 -1
  244. package/dist/execution-service.d.ts.map +1 -1
  245. package/dist/extension-bootstrap.d.ts +7 -0
  246. package/dist/extension-bootstrap.d.ts.map +1 -0
  247. package/dist/extension-bootstrap.js +51 -0
  248. package/dist/extension-bootstrap.js.map +7 -0
  249. package/dist/extension.d.ts +8 -0
  250. package/dist/extension.d.ts.map +1 -0
  251. package/dist/fabric-exec-tool.d.ts.map +1 -1
  252. package/dist/fabric-runtime-state.d.ts +8 -0
  253. package/dist/fabric-runtime-state.d.ts.map +1 -1
  254. package/dist/fabric-runtime-state.js +2432 -346
  255. package/dist/fabric-runtime-state.js.map +4 -4
  256. package/dist/fabric-state.d.ts +22 -0
  257. package/dist/fabric-state.d.ts.map +1 -1
  258. package/dist/host-compatibility.d.ts +1 -1
  259. package/dist/host-compatibility.d.ts.map +1 -1
  260. package/dist/index.d.ts +5 -6
  261. package/dist/index.d.ts.map +1 -1
  262. package/dist/index.js +68 -6250
  263. package/dist/index.js.map +4 -4
  264. package/dist/jev/observation.js +5 -5
  265. package/dist/jev-fabric/bridge.d.ts +15 -0
  266. package/dist/jev-fabric/bridge.d.ts.map +1 -1
  267. package/dist/jev-fabric/client.js +1 -1
  268. package/dist/jev-fabric/client.js.map +2 -2
  269. package/dist/jev-fabric/operations.d.ts +2 -0
  270. package/dist/jev-fabric/operations.d.ts.map +1 -1
  271. package/dist/jev-fabric/operations.js +1 -1
  272. package/dist/jev-fabric/operations.js.map +2 -2
  273. package/dist/jev-fabric/resolve.js +1 -1
  274. package/dist/jev-fabric/resolve.js.map +2 -2
  275. package/dist/jev.js +9 -9
  276. package/dist/lifecycle/types.d.ts.map +1 -1
  277. package/dist/memory/client.d.ts +3 -0
  278. package/dist/memory/client.d.ts.map +1 -1
  279. package/dist/memory/digest.js +2 -2
  280. package/dist/memory/discovery.js +6 -6
  281. package/dist/memory/expand-service.d.ts.map +1 -1
  282. package/dist/memory/file-worker.d.ts.map +1 -1
  283. package/dist/memory/file-worker.js +10 -9
  284. package/dist/memory/file-worker.js.map +2 -2
  285. package/dist/memory/host-source.d.ts +2 -1
  286. package/dist/memory/host-source.d.ts.map +1 -1
  287. package/dist/memory/normalize.js +5 -5
  288. package/dist/memory/portable.d.ts +3 -1
  289. package/dist/memory/portable.d.ts.map +1 -1
  290. package/dist/memory/request-cache.d.ts +4 -2
  291. package/dist/memory/request-cache.d.ts.map +1 -1
  292. package/dist/memory/request-context.d.ts +3 -0
  293. package/dist/memory/request-context.d.ts.map +1 -1
  294. package/dist/memory/search.js +7 -7
  295. package/dist/memory/worker-provider.d.ts.map +1 -1
  296. package/dist/memory/worker-provider.js +10 -10
  297. package/dist/memory.js +14 -13
  298. package/dist/memory.js.map +2 -2
  299. package/dist/mesh/grants.d.ts +86 -0
  300. package/dist/mesh/grants.d.ts.map +1 -0
  301. package/dist/mesh/store.d.ts +89 -0
  302. package/dist/mesh/store.d.ts.map +1 -1
  303. package/dist/programs/host.d.ts +22 -0
  304. package/dist/programs/host.d.ts.map +1 -0
  305. package/dist/programs/host.js +171 -0
  306. package/dist/programs/host.js.map +7 -0
  307. package/dist/programs/source.d.ts +16 -0
  308. package/dist/programs/source.d.ts.map +1 -0
  309. package/dist/programs/store.d.ts +81 -0
  310. package/dist/programs/store.d.ts.map +1 -0
  311. package/dist/protocol.d.ts +153 -0
  312. package/dist/protocol.d.ts.map +1 -1
  313. package/dist/protocol.js +15 -1
  314. package/dist/providers/agents-actions.d.ts.map +1 -1
  315. package/dist/providers/agents-message-router.d.ts.map +1 -1
  316. package/dist/providers/agents-progress.d.ts.map +1 -1
  317. package/dist/providers/agents-provider.d.ts +3 -0
  318. package/dist/providers/agents-provider.d.ts.map +1 -1
  319. package/dist/providers/cache-provider.d.ts +1 -1
  320. package/dist/providers/cache-provider.d.ts.map +1 -1
  321. package/dist/providers/compact-provider.d.ts +13 -1
  322. package/dist/providers/compact-provider.d.ts.map +1 -1
  323. package/dist/providers/decisions-provider.d.ts +17 -0
  324. package/dist/providers/decisions-provider.d.ts.map +1 -0
  325. package/dist/providers/jev-provider.js +9 -9
  326. package/dist/providers/memory-provider.d.ts.map +1 -1
  327. package/dist/providers/memory-provider.js +9 -9
  328. package/dist/providers/mesh-provider.d.ts +4 -0
  329. package/dist/providers/mesh-provider.d.ts.map +1 -1
  330. package/dist/providers/pi-native-mcp.d.ts.map +1 -1
  331. package/dist/providers/pi-tools-provider.d.ts.map +1 -1
  332. package/dist/providers/programs-provider.d.ts +18 -0
  333. package/dist/providers/programs-provider.d.ts.map +1 -0
  334. package/dist/providers/state-provider.d.ts +4 -1
  335. package/dist/providers/state-provider.d.ts.map +1 -1
  336. package/dist/providers/thinking-provider.d.ts +15 -0
  337. package/dist/providers/thinking-provider.d.ts.map +1 -0
  338. package/dist/residency/actor-client.js +3 -3
  339. package/dist/residency/client.d.ts.map +1 -1
  340. package/dist/residency/host.d.ts +21 -0
  341. package/dist/residency/host.d.ts.map +1 -1
  342. package/dist/residency/host.js +28 -22
  343. package/dist/residency/launcher-owner.d.ts +2 -0
  344. package/dist/residency/launcher-owner.d.ts.map +1 -1
  345. package/dist/residency/launcher.js +35 -20
  346. package/dist/residency/launcher.js.map +3 -3
  347. package/dist/residency/pi-entry.js +26 -22
  348. package/dist/residency/pi-entry.js.map +1 -1
  349. package/dist/residency/protocol.d.ts +12 -2
  350. package/dist/residency/protocol.d.ts.map +1 -1
  351. package/dist/runners.d.ts +9 -0
  352. package/dist/runners.d.ts.map +1 -0
  353. package/dist/runners.js +182 -0
  354. package/dist/runners.js.map +7 -0
  355. package/dist/runtime/core-override-guest-types.js +2 -2
  356. package/dist/runtime/cpython-child-source.d.ts.map +1 -1
  357. package/dist/runtime/cpython-runtime.d.ts.map +1 -1
  358. package/dist/runtime/cpython-runtime.js +35 -7
  359. package/dist/runtime/cpython-runtime.js.map +2 -2
  360. package/dist/runtime/deadline-pause.d.ts +26 -0
  361. package/dist/runtime/deadline-pause.d.ts.map +1 -0
  362. package/dist/runtime/guest-types.d.ts +1 -1
  363. package/dist/runtime/guest-types.d.ts.map +1 -1
  364. package/dist/runtime/guest-types.js +1 -1
  365. package/dist/runtime/kernel.d.ts +3 -0
  366. package/dist/runtime/kernel.d.ts.map +1 -1
  367. package/dist/runtime/monty-runtime.d.ts.map +1 -1
  368. package/dist/runtime/monty-runtime.js +33 -12
  369. package/dist/runtime/monty-runtime.js.map +2 -2
  370. package/dist/runtime/node-process-runtime.d.ts.map +1 -1
  371. package/dist/runtime/node-process-runtime.js +4 -3
  372. package/dist/runtime/orchestration.d.ts.map +1 -1
  373. package/dist/runtime/quickjs-runtime.d.ts.map +1 -1
  374. package/dist/runtime/quickjs-runtime.js +2 -1
  375. package/dist/runtime/typescript-kernel.js +8 -7
  376. package/dist/runtime/typescript-kernel.js.map +1 -1
  377. package/dist/runtime-state-builtins.d.ts.map +1 -1
  378. package/dist/schema/controller.d.ts.map +1 -1
  379. package/dist/schema/policy.d.ts.map +1 -1
  380. package/dist/scope.d.ts +69 -0
  381. package/dist/scope.d.ts.map +1 -0
  382. package/dist/scope.js +37 -0
  383. package/dist/scope.js.map +7 -0
  384. package/dist/speculation/eligibility.d.ts.map +1 -1
  385. package/dist/speculation/python-scanner.js +1 -1
  386. package/dist/speculation/python-scanner.js.map +2 -2
  387. package/dist/speculation/scanner.js +1 -1
  388. package/dist/speculation/scanner.js.map +2 -2
  389. package/dist/state/binding.d.ts +17 -0
  390. package/dist/state/binding.d.ts.map +1 -0
  391. package/dist/state/store.d.ts +8 -2
  392. package/dist/state/store.d.ts.map +1 -1
  393. package/dist/state/types.d.ts +23 -2
  394. package/dist/state/types.d.ts.map +1 -1
  395. package/dist/storage/retention.d.ts +7 -0
  396. package/dist/storage/retention.d.ts.map +1 -1
  397. package/dist/storage/scratch.d.ts.map +1 -1
  398. package/dist/thinking-control.d.ts +64 -0
  399. package/dist/thinking-control.d.ts.map +1 -0
  400. package/dist/thinking-control.js +15 -0
  401. package/dist/thinking-control.js.map +7 -0
  402. package/dist/thinking.d.ts +61 -0
  403. package/dist/thinking.d.ts.map +1 -1
  404. package/dist/topology/control-plane.d.ts +13 -0
  405. package/dist/topology/control-plane.d.ts.map +1 -1
  406. package/dist/topology/participant-directory.d.ts +2 -0
  407. package/dist/topology/participant-directory.d.ts.map +1 -1
  408. package/dist/topology/provider-participants.d.ts +72 -0
  409. package/dist/topology/provider-participants.d.ts.map +1 -0
  410. package/dist/topology/records.d.ts.map +1 -1
  411. package/dist/topology/types.d.ts +13 -3
  412. package/dist/topology/types.d.ts.map +1 -1
  413. package/dist/type-error-guidance.js +170 -0
  414. package/dist/type-error-guidance.js.map +7 -0
  415. package/dist/ui/controller.d.ts.map +1 -1
  416. package/dist/ui/conversation-chrome.d.ts +2 -0
  417. package/dist/ui/conversation-chrome.d.ts.map +1 -1
  418. package/dist/ui/conversation-chrome.js +1 -1
  419. package/dist/ui/conversation-latest.d.ts +10 -0
  420. package/dist/ui/conversation-latest.d.ts.map +1 -0
  421. package/dist/ui/conversation-native-reader.js +2 -1
  422. package/dist/ui/conversation-native-reader.js.map +1 -1
  423. package/dist/ui/conversation-render.d.ts +2 -1
  424. package/dist/ui/conversation-render.d.ts.map +1 -1
  425. package/dist/ui/conversation-scrollbar.d.ts +22 -0
  426. package/dist/ui/conversation-scrollbar.d.ts.map +1 -0
  427. package/dist/ui/conversation-selection.d.ts +2 -2
  428. package/dist/ui/conversation-selection.d.ts.map +1 -1
  429. package/dist/ui/conversation-targets.d.ts.map +1 -1
  430. package/dist/ui/conversation-targets.js +2 -2
  431. package/dist/ui/conversation.d.ts +3 -0
  432. package/dist/ui/conversation.d.ts.map +1 -1
  433. package/dist/ui/conversation.js +253 -34
  434. package/dist/ui/conversation.js.map +4 -4
  435. package/dist/ui/dashboard-fabric-graph.d.ts.map +1 -1
  436. package/dist/ui/dashboard.js +14 -15
  437. package/dist/ui/dashboard.js.map +2 -2
  438. package/dist/ui/image-overlays.d.ts +16 -0
  439. package/dist/ui/image-overlays.d.ts.map +1 -0
  440. package/dist/ui/image-overlays.js +10 -0
  441. package/dist/ui/image-overlays.js.map +7 -0
  442. package/dist/ui/kitty-viewport.d.ts +24 -0
  443. package/dist/ui/kitty-viewport.d.ts.map +1 -0
  444. package/dist/ui/retention.d.ts +14 -0
  445. package/dist/ui/retention.d.ts.map +1 -0
  446. package/dist/ui/settings-sections-execution.d.ts.map +1 -1
  447. package/dist/ui/settings.d.ts.map +1 -1
  448. package/dist/ui/settings.js +27 -16
  449. package/dist/ui/settings.js.map +2 -2
  450. package/dist/ui/transcript.d.ts +2 -1
  451. package/dist/ui/transcript.d.ts.map +1 -1
  452. package/dist/ui/types.d.ts +2 -1
  453. package/dist/ui/types.d.ts.map +1 -1
  454. package/dist/ui/widget.d.ts +4 -2
  455. package/dist/ui/widget.d.ts.map +1 -1
  456. package/dist/verified/generated/authority-kernel.js +1 -1
  457. package/dist/verified/generated/kernel.js +1 -1
  458. package/dist/verified/generated/lifecycle-kernel.js +1 -1
  459. package/dist/verified/generated/manifest.json +7 -7
  460. package/dist/verified/generated/provider-kernel.js +1 -1
  461. package/dist/verified/generated/storage-kernel.js +1 -1
  462. package/dist/worker/options.d.ts.map +1 -1
  463. package/dist/worker/options.js +14 -0
  464. package/dist/worker/options.js.map +2 -2
  465. package/dist/worker/questions.d.ts +46 -0
  466. package/dist/worker/questions.d.ts.map +1 -0
  467. package/dist/worker/questions.js +87 -0
  468. package/dist/worker/questions.js.map +7 -0
  469. package/dist/worker/result.d.ts +3 -0
  470. package/dist/worker/result.d.ts.map +1 -0
  471. package/dist/worker/result.js +7493 -0
  472. package/dist/worker/result.js.map +7 -0
  473. package/dist/worker/run-record.js +10 -113
  474. package/dist/worker/run-record.js.map +3 -3
  475. package/dist/worker/startup.d.ts +8 -0
  476. package/dist/worker/startup.d.ts.map +1 -0
  477. package/dist/worker.js +111 -22
  478. package/dist/worker.js.map +4 -4
  479. package/docs/agents.md +197 -3
  480. package/docs/architecture.md +8 -1
  481. package/docs/audit-trace.md +36 -1
  482. package/docs/background-tasks.md +25 -1
  483. package/docs/certification.md +1 -1
  484. package/docs/compaction.md +64 -0
  485. package/docs/components.md +1 -0
  486. package/docs/configuration.md +105 -10
  487. package/docs/decisions.md +144 -0
  488. package/docs/durable-pi.md +186 -0
  489. package/docs/interface.md +10 -1
  490. package/docs/kitty-images.md +89 -0
  491. package/docs/licenses/typebox-mit.txt +23 -0
  492. package/docs/memory-recall.md +5 -3
  493. package/docs/programmatic-compaction.md +67 -11
  494. package/docs/programs.md +137 -0
  495. package/docs/provider-capabilities.md +23 -1
  496. package/docs/providers.md +158 -0
  497. package/docs/residency-runtime.md +64 -0
  498. package/docs/schema-enforcement.md +5 -3
  499. package/docs/shell-composition.md +6 -6
  500. package/docs/skills.md +2 -1
  501. package/docs/speculation.md +2 -1
  502. package/docs/state-layer.md +26 -4
  503. package/docs/thinking.md +48 -0
  504. package/docs/verified-kernels.md +1 -1
  505. package/package.json +48 -12
  506. package/scripts/test-verified-kernels.mjs +1 -1
  507. package/scripts/verified-kernels.mjs +1 -1
  508. package/skillsets/python/fabric-exec/SKILL.md +2 -2
  509. package/skillsets/python/fabric-exec/references/agents.md +9 -4
  510. package/skillsets/python/fabric-exec/references/mesh.md +9 -0
  511. package/skillsets/python/fabric-graph/SKILL.md +109 -0
  512. package/skillsets/python/fabric-guide/SKILL.md +2 -1
  513. package/skillsets/typescript/fabric-exec/SKILL.md +20 -2
  514. package/skillsets/typescript/fabric-exec/references/agents.md +10 -4
  515. package/skillsets/typescript/fabric-exec/references/mesh.md +10 -0
  516. package/skillsets/typescript/fabric-graph/SKILL.md +112 -0
  517. package/skillsets/typescript/fabric-guide/SKILL.md +2 -1
  518. package/skillsets/typescript/fabric-workflow/SKILL.md +1 -1
  519. package/dist/chunks/chunk-4NF3S3NM.js.map +0 -7
  520. package/dist/chunks/chunk-5VTBHJN3.js.map +0 -7
  521. package/dist/chunks/chunk-74BA4VSX.js.map +0 -7
  522. package/dist/chunks/chunk-7BG5COXB.js.map +0 -7
  523. package/dist/chunks/chunk-AYBIR4YV.js.map +0 -7
  524. package/dist/chunks/chunk-B5D6GA77.js.map +0 -7
  525. package/dist/chunks/chunk-BEJF2JX2.js.map +0 -7
  526. package/dist/chunks/chunk-BUQZBG6O.js.map +0 -7
  527. package/dist/chunks/chunk-CC63CY6R.js.map +0 -7
  528. package/dist/chunks/chunk-FDIEQEXS.js.map +0 -7
  529. package/dist/chunks/chunk-G4CSXNBT.js.map +0 -7
  530. package/dist/chunks/chunk-HG4DMARW.js.map +0 -7
  531. package/dist/chunks/chunk-KAD7UWT2.js +0 -99
  532. package/dist/chunks/chunk-KAD7UWT2.js.map +0 -7
  533. package/dist/chunks/chunk-MGWQOKBV.js +0 -30
  534. package/dist/chunks/chunk-MGWQOKBV.js.map +0 -7
  535. package/dist/chunks/chunk-PN4EKNRE.js.map +0 -7
  536. package/dist/chunks/chunk-PNDYFU64.js.map +0 -7
  537. package/dist/chunks/chunk-PWS2OXLV.js.map +0 -7
  538. package/dist/chunks/chunk-QE2JFB7F.js.map +0 -7
  539. package/dist/chunks/chunk-QETG2GVX.js.map +0 -7
  540. package/dist/chunks/chunk-RAO6TQFP.js.map +0 -7
  541. package/dist/chunks/chunk-RIFG4HS6.js.map +0 -7
  542. package/dist/chunks/chunk-TX6E5W7H.js.map +0 -7
  543. package/dist/chunks/chunk-VRAGOMN4.js.map +0 -7
  544. package/dist/chunks/chunk-W63E3WEO.js.map +0 -7
  545. package/dist/chunks/chunk-WMJ2AVQQ.js.map +0 -7
  546. package/dist/chunks/chunk-ZZ66L3W5.js.map +0 -7
  547. /package/dist/chunks/{chunk-57CMH4SW.js.map → chunk-7JU7Z4XQ.js.map} +0 -0
  548. /package/dist/chunks/{chunk-DUJ46TIP.js.map → chunk-ABJCSNZO.js.map} +0 -0
  549. /package/dist/chunks/{chunk-KP4ANT6L.js.map → chunk-C7EEG6SM.js.map} +0 -0
  550. /package/dist/chunks/{chunk-NHMICIEU.js.map → chunk-CCHZXF6K.js.map} +0 -0
  551. /package/dist/chunks/{chunk-5JN5AWNV.js.map → chunk-DZ4WN5XJ.js.map} +0 -0
  552. /package/dist/chunks/{chunk-7XJB2USB.js.map → chunk-LOLCTWJF.js.map} +0 -0
  553. /package/dist/chunks/{chunk-64O5L7EW.js.map → chunk-M6IRQ3QT.js.map} +0 -0
  554. /package/dist/chunks/{chunk-EPYLZWJV.js.map → chunk-OVBKQCYL.js.map} +0 -0
  555. /package/dist/chunks/{chunk-Z5Y65YBX.js.map → chunk-PYQM7KPL.js.map} +0 -0
  556. /package/dist/chunks/{chunk-DKVJREDI.js.map → chunk-QY7YK7M6.js.map} +0 -0
  557. /package/dist/chunks/{chunk-5ZJV4LAX.js.map → chunk-VPRJOD4Y.js.map} +0 -0
  558. /package/dist/chunks/{chunk-RG22JKIC.js.map → chunk-W7X4XEQU.js.map} +0 -0
  559. /package/dist/chunks/{chunk-LV4IT75S.js.map → chunk-WLLXKS6I.js.map} +0 -0
  560. /package/dist/chunks/{chunk-YVDBHS4C.js.map → chunk-WREA4RNR.js.map} +0 -0
  561. /package/dist/chunks/{chunk-NGGI6LDC.js.map → chunk-X2TRSE7D.js.map} +0 -0
  562. /package/dist/chunks/{chunk-A4VP7HDF.js.map → chunk-ZLNJDTCN.js.map} +0 -0
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/speculation/scanner.ts"],
4
- "sourcesContent": ["import ts from \"typescript\";\nimport { stableJsonHash } from \"../core/stable-hash.js\";\nimport type { FabricSpeculationCandidate } from \"./types.js\";\n\n// Root namespaces the model can call from a fabric program. Calls are emitted\n// as candidates regardless of action so the tap can apply its eligibility\n// policy in one place; args must still be fully literal.\nconst ROOTS = new Set([\"pi\", \"memory\", \"state\", \"schema\", \"compact\", \"components\", \"mcp\"]);\n\nconst LITERAL_FAIL = Symbol(\"literal-fail\");\n\ntype LiteralResult = { ok: true; value: unknown } | { ok: false };\n\nconst literalOk = (value: unknown): LiteralResult => ({ ok: true, value });\nconst LITERAL_FAIL_RESULT: LiteralResult = { ok: false };\n\n// Accept only values that survive a JSON round trip unchanged in structure so\n// the speculation key (stableJsonHash over prepared args) cannot drift from\n// what the real invocation produces.\nconst isJsonShape = (value: unknown): boolean => {\n if (value === null) return true;\n switch (typeof value) {\n case \"string\":\n case \"boolean\":\n return true;\n case \"number\":\n return Number.isFinite(value);\n case \"object\": {\n if (Array.isArray(value)) return value.every(isJsonShape);\n const record = value as Record<string, unknown>;\n return Object.values(record).every(isJsonShape);\n }\n default:\n return false;\n }\n};\n\nconst evalLiteral = (node: ts.Expression): LiteralResult => {\n if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node)) {\n return literalOk(node.text);\n }\n if (ts.isNumericLiteral(node)) {\n if (node.text.endsWith(\"n\")) return LITERAL_FAIL_RESULT; // bigint\n const value = Number(node.text);\n return Number.isFinite(value) ? literalOk(value) : LITERAL_FAIL_RESULT;\n }\n if (\n ts.isPrefixUnaryExpression(node) &&\n (node.operator === ts.SyntaxKind.MinusToken || node.operator === ts.SyntaxKind.PlusToken) &&\n ts.isNumericLiteral(node.operand)\n ) {\n if (node.operand.text.endsWith(\"n\")) return LITERAL_FAIL_RESULT;\n const value = Number(node.operand.text);\n if (!Number.isFinite(value)) return LITERAL_FAIL_RESULT;\n return literalOk(node.operator === ts.SyntaxKind.MinusToken ? -value : value);\n }\n if (node.kind === ts.SyntaxKind.TrueKeyword) return literalOk(true);\n if (node.kind === ts.SyntaxKind.FalseKeyword) return literalOk(false);\n if (node.kind === ts.SyntaxKind.NullKeyword) return literalOk(null);\n if (ts.isArrayLiteralExpression(node)) {\n const items: unknown[] = [];\n for (const element of node.elements) {\n if (ts.isSpreadElement(element) || ts.isOmittedExpression(element)) return LITERAL_FAIL_RESULT;\n const item = evalLiteral(element);\n if (!item.ok) return item;\n items.push(item.value);\n }\n return literalOk(items);\n }\n if (ts.isObjectLiteralExpression(node)) {\n const record: Record<string, unknown> = {};\n for (const property of node.properties) {\n if (!ts.isPropertyAssignment(property)) return LITERAL_FAIL_RESULT;\n const name = property.name;\n if (!ts.isIdentifier(name) && !ts.isStringLiteral(name)) return LITERAL_FAIL_RESULT;\n const value = evalLiteral(property.initializer);\n if (!value.ok) return value;\n record[name.text] = value.value;\n }\n return literalOk(record);\n }\n return LITERAL_FAIL_RESULT;\n};\n\nconst collectBoundNames = (name: ts.BindingName, into: Set<string>): void => {\n if (ts.isIdentifier(name)) {\n into.add(name.text);\n return;\n }\n for (const element of name.elements) {\n if (ts.isBindingElement(element)) collectBoundNames(element.name, into);\n }\n};\n\n/** Property-access chain as segments, e.g. mcp.exa.search -> [\"mcp\",\"exa\",\"search\"]. */\nconst accessChain = (node: ts.Expression): string[] | undefined => {\n const segments: string[] = [];\n let current: ts.Expression = node;\n while (ts.isPropertyAccessExpression(current)) {\n segments.unshift(current.name.text);\n current = current.expression;\n }\n if (!ts.isIdentifier(current)) return undefined;\n segments.unshift(current.text);\n return segments;\n};\n\nconst refFromChain = (segments: string[], tainted: Set<string>): string | undefined => {\n const root = segments[0]!;\n if (!ROOTS.has(root) || tainted.has(root)) return undefined;\n if (segments.length === 2) return `${segments[0]}.${segments[1]}`;\n if (segments.length === 3 && root === \"mcp\") return segments.join(\".\");\n return undefined;\n};\n\n/**\n * Scans a growing partial TypeScript program for completed calls on the spec\n * namespaces whose arguments are all literals. Reparses the full prefix only\n * when newly appended text contains a \")\" \u2014 which is the earliest point a call\n * expression can complete \u2014 so streaming deltas inside string payloads cost a\n * substring scan, not an AST build.\n */\nexport class LiteralCallScanner {\n #scannedLength = 0;\n readonly #tainted = new Set<string>();\n readonly #emitted = new Set<string>();\n\n push(code: string): FabricSpeculationCandidate[] {\n const appended = code.slice(this.#scannedLength);\n const forceScan = code.length < this.#scannedLength;\n if (!forceScan && !appended.includes(\")\")) return [];\n this.#scannedLength = code.length;\n\n const source = ts.createSourceFile(\n \"speculation.ts\",\n code,\n ts.ScriptTarget.ESNext,\n true,\n ts.ScriptKind.TS,\n );\n\n // A local/declared binding that shares a namespace root makes dotted calls\n // ambiguous (e.g. `const pi = { read: () => ... }`); taint that root for\n // the rest of the stream.\n for (const statement of source.statements) {\n this.#collectStatementBindings(statement, this.#tainted);\n }\n\n const candidates: FabricSpeculationCandidate[] = [];\n const visit = (node: ts.Node): void => {\n if (ts.isCallExpression(node)) {\n const segments = accessChain(node.expression);\n if (segments) {\n const ref = refFromChain(segments, this.#tainted);\n if (ref) {\n const args = this.#literalArgs(node);\n if (args !== undefined) {\n const key = `${ref}\\n${stableJsonHash(args)}`;\n if (!this.#emitted.has(key)) {\n this.#emitted.add(key);\n candidates.push({ ref, args });\n }\n }\n }\n }\n }\n ts.forEachChild(node, visit);\n };\n visit(source);\n return candidates;\n }\n\n // Zero-arg calls mean `{}`; a single object literal is the documented\n // fabric calling convention. Positional multi-arg calls are skipped: their\n // normalization lives on the guest bridge, and guessing here would risk\n // keying the speculation store on the wrong argument shape.\n #literalArgs(node: ts.CallExpression): Record<string, unknown> | undefined {\n if (node.arguments.length === 0) return {};\n if (node.arguments.length !== 1) return undefined;\n const only = node.arguments[0]!;\n if (ts.isSpreadElement(only)) return undefined;\n const value = evalLiteral(only);\n if (!value.ok) return undefined;\n if (\n typeof value.value !== \"object\" ||\n value.value === null ||\n Array.isArray(value.value) ||\n !isJsonShape(value.value)\n ) {\n return undefined;\n }\n return value.value as Record<string, unknown>;\n }\n\n #collectStatementBindings(node: ts.Node, into: Set<string>): void {\n const visit = (current: ts.Node): void => {\n if (ts.isVariableDeclaration(current)) collectBoundNames(current.name, into);\n else if (\n (ts.isFunctionDeclaration(current) || ts.isClassDeclaration(current)) &&\n current.name\n ) {\n into.add(current.name.text);\n } else if (\n ts.isFunctionExpression(current) ||\n ts.isArrowFunction(current) ||\n ts.isMethodDeclaration(current)\n ) {\n for (const parameter of current.parameters) collectBoundNames(parameter.name, into);\n } else if (ts.isImportDeclaration(current) && current.importClause) {\n const clause = current.importClause;\n if (clause.name) into.add(clause.name.text);\n if (clause.namedBindings) {\n if (ts.isNamespaceImport(clause.namedBindings)) {\n into.add(clause.namedBindings.name.text);\n } else {\n for (const element of clause.namedBindings.elements) into.add(element.name.text);\n }\n }\n }\n ts.forEachChild(current, visit);\n };\n visit(node);\n }\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import ts from \"typescript\";\nimport { stableJsonHash } from \"../core/stable-hash.js\";\nimport type { FabricSpeculationCandidate } from \"./types.js\";\n\n// Root namespaces the model can call from a fabric program. Calls are emitted\n// as candidates regardless of action so the tap can apply its eligibility\n// policy in one place; args must still be fully literal.\nconst ROOTS = new Set([\"pi\", \"memory\", \"state\", \"schema\", \"compact\", \"thinking\", \"decisions\", \"programs\", \"components\", \"mcp\"]);\n\nconst LITERAL_FAIL = Symbol(\"literal-fail\");\n\ntype LiteralResult = { ok: true; value: unknown } | { ok: false };\n\nconst literalOk = (value: unknown): LiteralResult => ({ ok: true, value });\nconst LITERAL_FAIL_RESULT: LiteralResult = { ok: false };\n\n// Accept only values that survive a JSON round trip unchanged in structure so\n// the speculation key (stableJsonHash over prepared args) cannot drift from\n// what the real invocation produces.\nconst isJsonShape = (value: unknown): boolean => {\n if (value === null) return true;\n switch (typeof value) {\n case \"string\":\n case \"boolean\":\n return true;\n case \"number\":\n return Number.isFinite(value);\n case \"object\": {\n if (Array.isArray(value)) return value.every(isJsonShape);\n const record = value as Record<string, unknown>;\n return Object.values(record).every(isJsonShape);\n }\n default:\n return false;\n }\n};\n\nconst evalLiteral = (node: ts.Expression): LiteralResult => {\n if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node)) {\n return literalOk(node.text);\n }\n if (ts.isNumericLiteral(node)) {\n if (node.text.endsWith(\"n\")) return LITERAL_FAIL_RESULT; // bigint\n const value = Number(node.text);\n return Number.isFinite(value) ? literalOk(value) : LITERAL_FAIL_RESULT;\n }\n if (\n ts.isPrefixUnaryExpression(node) &&\n (node.operator === ts.SyntaxKind.MinusToken || node.operator === ts.SyntaxKind.PlusToken) &&\n ts.isNumericLiteral(node.operand)\n ) {\n if (node.operand.text.endsWith(\"n\")) return LITERAL_FAIL_RESULT;\n const value = Number(node.operand.text);\n if (!Number.isFinite(value)) return LITERAL_FAIL_RESULT;\n return literalOk(node.operator === ts.SyntaxKind.MinusToken ? -value : value);\n }\n if (node.kind === ts.SyntaxKind.TrueKeyword) return literalOk(true);\n if (node.kind === ts.SyntaxKind.FalseKeyword) return literalOk(false);\n if (node.kind === ts.SyntaxKind.NullKeyword) return literalOk(null);\n if (ts.isArrayLiteralExpression(node)) {\n const items: unknown[] = [];\n for (const element of node.elements) {\n if (ts.isSpreadElement(element) || ts.isOmittedExpression(element)) return LITERAL_FAIL_RESULT;\n const item = evalLiteral(element);\n if (!item.ok) return item;\n items.push(item.value);\n }\n return literalOk(items);\n }\n if (ts.isObjectLiteralExpression(node)) {\n const record: Record<string, unknown> = {};\n for (const property of node.properties) {\n if (!ts.isPropertyAssignment(property)) return LITERAL_FAIL_RESULT;\n const name = property.name;\n if (!ts.isIdentifier(name) && !ts.isStringLiteral(name)) return LITERAL_FAIL_RESULT;\n const value = evalLiteral(property.initializer);\n if (!value.ok) return value;\n record[name.text] = value.value;\n }\n return literalOk(record);\n }\n return LITERAL_FAIL_RESULT;\n};\n\nconst collectBoundNames = (name: ts.BindingName, into: Set<string>): void => {\n if (ts.isIdentifier(name)) {\n into.add(name.text);\n return;\n }\n for (const element of name.elements) {\n if (ts.isBindingElement(element)) collectBoundNames(element.name, into);\n }\n};\n\n/** Property-access chain as segments, e.g. mcp.exa.search -> [\"mcp\",\"exa\",\"search\"]. */\nconst accessChain = (node: ts.Expression): string[] | undefined => {\n const segments: string[] = [];\n let current: ts.Expression = node;\n while (ts.isPropertyAccessExpression(current)) {\n segments.unshift(current.name.text);\n current = current.expression;\n }\n if (!ts.isIdentifier(current)) return undefined;\n segments.unshift(current.text);\n return segments;\n};\n\nconst refFromChain = (segments: string[], tainted: Set<string>): string | undefined => {\n const root = segments[0]!;\n if (!ROOTS.has(root) || tainted.has(root)) return undefined;\n if (segments.length === 2) return `${segments[0]}.${segments[1]}`;\n if (segments.length === 3 && root === \"mcp\") return segments.join(\".\");\n return undefined;\n};\n\n/**\n * Scans a growing partial TypeScript program for completed calls on the spec\n * namespaces whose arguments are all literals. Reparses the full prefix only\n * when newly appended text contains a \")\" \u2014 which is the earliest point a call\n * expression can complete \u2014 so streaming deltas inside string payloads cost a\n * substring scan, not an AST build.\n */\nexport class LiteralCallScanner {\n #scannedLength = 0;\n readonly #tainted = new Set<string>();\n readonly #emitted = new Set<string>();\n\n push(code: string): FabricSpeculationCandidate[] {\n const appended = code.slice(this.#scannedLength);\n const forceScan = code.length < this.#scannedLength;\n if (!forceScan && !appended.includes(\")\")) return [];\n this.#scannedLength = code.length;\n\n const source = ts.createSourceFile(\n \"speculation.ts\",\n code,\n ts.ScriptTarget.ESNext,\n true,\n ts.ScriptKind.TS,\n );\n\n // A local/declared binding that shares a namespace root makes dotted calls\n // ambiguous (e.g. `const pi = { read: () => ... }`); taint that root for\n // the rest of the stream.\n for (const statement of source.statements) {\n this.#collectStatementBindings(statement, this.#tainted);\n }\n\n const candidates: FabricSpeculationCandidate[] = [];\n const visit = (node: ts.Node): void => {\n if (ts.isCallExpression(node)) {\n const segments = accessChain(node.expression);\n if (segments) {\n const ref = refFromChain(segments, this.#tainted);\n if (ref) {\n const args = this.#literalArgs(node);\n if (args !== undefined) {\n const key = `${ref}\\n${stableJsonHash(args)}`;\n if (!this.#emitted.has(key)) {\n this.#emitted.add(key);\n candidates.push({ ref, args });\n }\n }\n }\n }\n }\n ts.forEachChild(node, visit);\n };\n visit(source);\n return candidates;\n }\n\n // Zero-arg calls mean `{}`; a single object literal is the documented\n // fabric calling convention. Positional multi-arg calls are skipped: their\n // normalization lives on the guest bridge, and guessing here would risk\n // keying the speculation store on the wrong argument shape.\n #literalArgs(node: ts.CallExpression): Record<string, unknown> | undefined {\n if (node.arguments.length === 0) return {};\n if (node.arguments.length !== 1) return undefined;\n const only = node.arguments[0]!;\n if (ts.isSpreadElement(only)) return undefined;\n const value = evalLiteral(only);\n if (!value.ok) return undefined;\n if (\n typeof value.value !== \"object\" ||\n value.value === null ||\n Array.isArray(value.value) ||\n !isJsonShape(value.value)\n ) {\n return undefined;\n }\n return value.value as Record<string, unknown>;\n }\n\n #collectStatementBindings(node: ts.Node, into: Set<string>): void {\n const visit = (current: ts.Node): void => {\n if (ts.isVariableDeclaration(current)) collectBoundNames(current.name, into);\n else if (\n (ts.isFunctionDeclaration(current) || ts.isClassDeclaration(current)) &&\n current.name\n ) {\n into.add(current.name.text);\n } else if (\n ts.isFunctionExpression(current) ||\n ts.isArrowFunction(current) ||\n ts.isMethodDeclaration(current)\n ) {\n for (const parameter of current.parameters) collectBoundNames(parameter.name, into);\n } else if (ts.isImportDeclaration(current) && current.importClause) {\n const clause = current.importClause;\n if (clause.name) into.add(clause.name.text);\n if (clause.namedBindings) {\n if (ts.isNamespaceImport(clause.namedBindings)) {\n into.add(clause.namedBindings.name.text);\n } else {\n for (const element of clause.namedBindings.elements) into.add(element.name.text);\n }\n }\n }\n ts.forEachChild(current, visit);\n };\n visit(node);\n }\n}\n"],
5
+ "mappings": ";;;;;AAAA,OAAO,QAAQ;AAOf,IAAM,QAAQ,oBAAI,IAAI,CAAC,MAAM,UAAU,SAAS,UAAU,WAAW,YAAY,aAAa,YAAY,cAAc,KAAK,CAAC;AAE9H,IAAM,eAAe,OAAO,cAAc;AAI1C,IAAM,YAAY,CAAC,WAAmC,EAAE,IAAI,MAAM,MAAM;AACxE,IAAM,sBAAqC,EAAE,IAAI,MAAM;AAKvD,IAAM,cAAc,CAAC,UAA4B;AAC/C,MAAI,UAAU,KAAM,QAAO;AAC3B,UAAQ,OAAO,OAAO;AAAA,IACpB,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,OAAO,SAAS,KAAK;AAAA,IAC9B,KAAK,UAAU;AACb,UAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,MAAM,WAAW;AACxD,YAAM,SAAS;AACf,aAAO,OAAO,OAAO,MAAM,EAAE,MAAM,WAAW;AAAA,IAChD;AAAA,IACA;AACE,aAAO;AAAA,EACX;AACF;AAEA,IAAM,cAAc,CAAC,SAAuC;AAC1D,MAAI,GAAG,gBAAgB,IAAI,KAAK,GAAG,gCAAgC,IAAI,GAAG;AACxE,WAAO,UAAU,KAAK,IAAI;AAAA,EAC5B;AACA,MAAI,GAAG,iBAAiB,IAAI,GAAG;AAC7B,QAAI,KAAK,KAAK,SAAS,GAAG,EAAG,QAAO;AACpC,UAAM,QAAQ,OAAO,KAAK,IAAI;AAC9B,WAAO,OAAO,SAAS,KAAK,IAAI,UAAU,KAAK,IAAI;AAAA,EACrD;AACA,MACE,GAAG,wBAAwB,IAAI,MAC9B,KAAK,aAAa,GAAG,WAAW,cAAc,KAAK,aAAa,GAAG,WAAW,cAC/E,GAAG,iBAAiB,KAAK,OAAO,GAChC;AACA,QAAI,KAAK,QAAQ,KAAK,SAAS,GAAG,EAAG,QAAO;AAC5C,UAAM,QAAQ,OAAO,KAAK,QAAQ,IAAI;AACtC,QAAI,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO;AACpC,WAAO,UAAU,KAAK,aAAa,GAAG,WAAW,aAAa,CAAC,QAAQ,KAAK;AAAA,EAC9E;AACA,MAAI,KAAK,SAAS,GAAG,WAAW,YAAa,QAAO,UAAU,IAAI;AAClE,MAAI,KAAK,SAAS,GAAG,WAAW,aAAc,QAAO,UAAU,KAAK;AACpE,MAAI,KAAK,SAAS,GAAG,WAAW,YAAa,QAAO,UAAU,IAAI;AAClE,MAAI,GAAG,yBAAyB,IAAI,GAAG;AACrC,UAAM,QAAmB,CAAC;AAC1B,eAAW,WAAW,KAAK,UAAU;AACnC,UAAI,GAAG,gBAAgB,OAAO,KAAK,GAAG,oBAAoB,OAAO,EAAG,QAAO;AAC3E,YAAM,OAAO,YAAY,OAAO;AAChC,UAAI,CAAC,KAAK,GAAI,QAAO;AACrB,YAAM,KAAK,KAAK,KAAK;AAAA,IACvB;AACA,WAAO,UAAU,KAAK;AAAA,EACxB;AACA,MAAI,GAAG,0BAA0B,IAAI,GAAG;AACtC,UAAM,SAAkC,CAAC;AACzC,eAAW,YAAY,KAAK,YAAY;AACtC,UAAI,CAAC,GAAG,qBAAqB,QAAQ,EAAG,QAAO;AAC/C,YAAM,OAAO,SAAS;AACtB,UAAI,CAAC,GAAG,aAAa,IAAI,KAAK,CAAC,GAAG,gBAAgB,IAAI,EAAG,QAAO;AAChE,YAAM,QAAQ,YAAY,SAAS,WAAW;AAC9C,UAAI,CAAC,MAAM,GAAI,QAAO;AACtB,aAAO,KAAK,IAAI,IAAI,MAAM;AAAA,IAC5B;AACA,WAAO,UAAU,MAAM;AAAA,EACzB;AACA,SAAO;AACT;AAEA,IAAM,oBAAoB,CAAC,MAAsB,SAA4B;AAC3E,MAAI,GAAG,aAAa,IAAI,GAAG;AACzB,SAAK,IAAI,KAAK,IAAI;AAClB;AAAA,EACF;AACA,aAAW,WAAW,KAAK,UAAU;AACnC,QAAI,GAAG,iBAAiB,OAAO,EAAG,mBAAkB,QAAQ,MAAM,IAAI;AAAA,EACxE;AACF;AAGA,IAAM,cAAc,CAAC,SAA8C;AACjE,QAAM,WAAqB,CAAC;AAC5B,MAAI,UAAyB;AAC7B,SAAO,GAAG,2BAA2B,OAAO,GAAG;AAC7C,aAAS,QAAQ,QAAQ,KAAK,IAAI;AAClC,cAAU,QAAQ;AAAA,EACpB;AACA,MAAI,CAAC,GAAG,aAAa,OAAO,EAAG,QAAO;AACtC,WAAS,QAAQ,QAAQ,IAAI;AAC7B,SAAO;AACT;AAEA,IAAM,eAAe,CAAC,UAAoB,YAA6C;AACrF,QAAM,OAAO,SAAS,CAAC;AACvB,MAAI,CAAC,MAAM,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,EAAG,QAAO;AAClD,MAAI,SAAS,WAAW,EAAG,QAAO,GAAG,SAAS,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;AAC/D,MAAI,SAAS,WAAW,KAAK,SAAS,MAAO,QAAO,SAAS,KAAK,GAAG;AACrE,SAAO;AACT;AASO,IAAM,qBAAN,MAAyB;AAAA,EAC9B,iBAAiB;AAAA,EACR,WAAW,oBAAI,IAAY;AAAA,EAC3B,WAAW,oBAAI,IAAY;AAAA,EAEpC,KAAK,MAA4C;AAC/C,UAAM,WAAW,KAAK,MAAM,KAAK,cAAc;AAC/C,UAAM,YAAY,KAAK,SAAS,KAAK;AACrC,QAAI,CAAC,aAAa,CAAC,SAAS,SAAS,GAAG,EAAG,QAAO,CAAC;AACnD,SAAK,iBAAiB,KAAK;AAE3B,UAAM,SAAS,GAAG;AAAA,MAChB;AAAA,MACA;AAAA,MACA,GAAG,aAAa;AAAA,MAChB;AAAA,MACA,GAAG,WAAW;AAAA,IAChB;AAKA,eAAW,aAAa,OAAO,YAAY;AACzC,WAAK,0BAA0B,WAAW,KAAK,QAAQ;AAAA,IACzD;AAEA,UAAM,aAA2C,CAAC;AAClD,UAAM,QAAQ,CAAC,SAAwB;AACrC,UAAI,GAAG,iBAAiB,IAAI,GAAG;AAC7B,cAAM,WAAW,YAAY,KAAK,UAAU;AAC5C,YAAI,UAAU;AACZ,gBAAM,MAAM,aAAa,UAAU,KAAK,QAAQ;AAChD,cAAI,KAAK;AACP,kBAAM,OAAO,KAAK,aAAa,IAAI;AACnC,gBAAI,SAAS,QAAW;AACtB,oBAAM,MAAM,GAAG,GAAG;AAAA,EAAK,eAAe,IAAI,CAAC;AAC3C,kBAAI,CAAC,KAAK,SAAS,IAAI,GAAG,GAAG;AAC3B,qBAAK,SAAS,IAAI,GAAG;AACrB,2BAAW,KAAK,EAAE,KAAK,KAAK,CAAC;AAAA,cAC/B;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AACA,SAAG,aAAa,MAAM,KAAK;AAAA,IAC7B;AACA,UAAM,MAAM;AACZ,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa,MAA8D;AACzE,QAAI,KAAK,UAAU,WAAW,EAAG,QAAO,CAAC;AACzC,QAAI,KAAK,UAAU,WAAW,EAAG,QAAO;AACxC,UAAM,OAAO,KAAK,UAAU,CAAC;AAC7B,QAAI,GAAG,gBAAgB,IAAI,EAAG,QAAO;AACrC,UAAM,QAAQ,YAAY,IAAI;AAC9B,QAAI,CAAC,MAAM,GAAI,QAAO;AACtB,QACE,OAAO,MAAM,UAAU,YACvB,MAAM,UAAU,QAChB,MAAM,QAAQ,MAAM,KAAK,KACzB,CAAC,YAAY,MAAM,KAAK,GACxB;AACA,aAAO;AAAA,IACT;AACA,WAAO,MAAM;AAAA,EACf;AAAA,EAEA,0BAA0B,MAAe,MAAyB;AAChE,UAAM,QAAQ,CAAC,YAA2B;AACxC,UAAI,GAAG,sBAAsB,OAAO,EAAG,mBAAkB,QAAQ,MAAM,IAAI;AAAA,gBAExE,GAAG,sBAAsB,OAAO,KAAK,GAAG,mBAAmB,OAAO,MACnE,QAAQ,MACR;AACA,aAAK,IAAI,QAAQ,KAAK,IAAI;AAAA,MAC5B,WACE,GAAG,qBAAqB,OAAO,KAC/B,GAAG,gBAAgB,OAAO,KAC1B,GAAG,oBAAoB,OAAO,GAC9B;AACA,mBAAW,aAAa,QAAQ,WAAY,mBAAkB,UAAU,MAAM,IAAI;AAAA,MACpF,WAAW,GAAG,oBAAoB,OAAO,KAAK,QAAQ,cAAc;AAClE,cAAM,SAAS,QAAQ;AACvB,YAAI,OAAO,KAAM,MAAK,IAAI,OAAO,KAAK,IAAI;AAC1C,YAAI,OAAO,eAAe;AACxB,cAAI,GAAG,kBAAkB,OAAO,aAAa,GAAG;AAC9C,iBAAK,IAAI,OAAO,cAAc,KAAK,IAAI;AAAA,UACzC,OAAO;AACL,uBAAW,WAAW,OAAO,cAAc,SAAU,MAAK,IAAI,QAAQ,KAAK,IAAI;AAAA,UACjF;AAAA,QACF;AAAA,MACF;AACA,SAAG,aAAa,SAAS,KAAK;AAAA,IAChC;AACA,UAAM,IAAI;AAAA,EACZ;AACF;",
6
6
  "names": []
7
7
  }
@@ -0,0 +1,17 @@
1
+ import type { FabricSchemaMode } from "../config.js";
2
+ import type { StateCertificateBinding, StateCertificateObserved, StateCertificateRequester } from "./types.js";
3
+ export declare const STATE_BINDING_MAX_KEYS = 16;
4
+ export declare const STATE_BINDING_VALUE_MAX_CHARS = 512;
5
+ /** Validate a caller binding; throws a descriptive error instead of dropping input. */
6
+ export declare const normalizeStateBinding: (value: unknown) => StateCertificateBinding | undefined;
7
+ /** Lenient read-side parse: malformed stored bindings fold as absent. */
8
+ export declare const toStateBinding: (value: unknown) => StateCertificateBinding | undefined;
9
+ export declare const toStateObserved: (value: unknown) => StateCertificateObserved | undefined;
10
+ export declare const toStateRequester: (value: unknown) => StateCertificateRequester | undefined;
11
+ export declare const toStateSchemaMode: (value: unknown) => FabricSchemaMode | undefined;
12
+ /**
13
+ * Observe HEAD and worktree cleanliness for `cwd`. Returns undefined outside a
14
+ * git work tree or before the first commit; a failed status probe omits `dirty`.
15
+ */
16
+ export declare const observeGitWorkspace: (cwd: string, signal?: AbortSignal) => Promise<StateCertificateObserved | undefined>;
17
+ //# sourceMappingURL=binding.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/state/binding.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAOpB,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAWjD,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,GAChC,OAAO,OAAO,KACb,uBAAuB,GAAG,SA8B5B,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,uBAAuB,GAAG,SAMzE,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,wBAAwB,GAAG,SAU3E,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,yBAAyB,GAAG,SACjB,CAAC;AAE9D,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,gBAAgB,GAAG,SAC0B,CAAC;AAwCjG;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,KAAK,MAAM,EACX,SAAS,WAAW,KACnB,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAe9C,CAAC"}
@@ -1,6 +1,7 @@
1
1
  import { MeshStore, type MeshEvent, type MeshIdentity, type MeshStateEntry } from "../mesh/store.js";
2
- import type { AdvanceHeadInput, StateCertificate, StateComplexityResult, StateComplexitySummary, StateGoal, StateHead, StateTransitionInput, StateTransitionRecord, VerificationReport } from "./types.js";
3
- export type { AdvanceHeadInput, StateCertificate, StateComplexityResult, StateComplexitySummary, StateGoal, StateHead, StateTransitionInput, StateTransitionKind, StateTransitionRecord, VerificationReport, } from "./types.js";
2
+ import type { FabricSchemaMode } from "../config.js";
3
+ import type { AdvanceHeadInput, StateCertificate, StateCertificateRequester, StateComplexityResult, StateComplexitySummary, StateGoal, StateHead, StateTransitionInput, StateTransitionRecord, VerificationReport } from "./types.js";
4
+ export type { AdvanceHeadInput, StateCertificate, StateCertificateBinding, StateCertificateObserved, StateCertificateRequester, StateComplexityResult, StateComplexitySummary, StateGoal, StateHead, StateTransitionInput, StateTransitionKind, StateTransitionRecord, VerificationReport, } from "./types.js";
4
5
  export declare const STATE_TOPIC = "fabric.state";
5
6
  export declare const CURRENT_KEY = "state/current";
6
7
  export declare const GOAL_KEY = "state/goal";
@@ -71,6 +72,11 @@ export declare class StateStore {
71
72
  timeoutMs?: number;
72
73
  signal?: AbortSignal | undefined;
73
74
  identity: MeshIdentity;
75
+ /** Caller claims to bind; `commit` is checked against the observed HEAD. */
76
+ binding?: Record<string, string>;
77
+ /** Defaults to "host"; the state provider passes "program". */
78
+ requestedBy?: StateCertificateRequester;
79
+ schemaMode?: FabricSchemaMode;
74
80
  }): Promise<VerificationReport>;
75
81
  }
76
82
  //# sourceMappingURL=store.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/state/store.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/state/store.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,4 @@
1
+ import type { FabricSchemaMode } from "../config.js";
1
2
  import type { MeshIdentity } from "../mesh/store.js";
2
3
  export type StateTransitionKind = "state" | "representation";
3
4
  type StateCertificationStatus = "pending" | "certified";
@@ -122,7 +123,24 @@ export interface StateCertificationHead {
122
123
  toOmittedBytes?: number;
123
124
  version: number;
124
125
  }
125
- export interface StateCertificate {
126
+ /** Caller-supplied claims a certificate is bound to (commit, specDigest, ...). */
127
+ export type StateCertificateBinding = Record<string, string>;
128
+ /** Facts the host observed itself in the verification cwd before evidence ran. */
129
+ export interface StateCertificateObserved {
130
+ commit?: string;
131
+ dirty?: boolean;
132
+ }
133
+ /** "program": through the state provider action surface; "host": direct host code. */
134
+ export type StateCertificateRequester = "program" | "host";
135
+ /** Additive bound-certificate fields; older certificates fold without them. */
136
+ export interface StateCertificateBindingFields {
137
+ binding?: StateCertificateBinding;
138
+ observed?: StateCertificateObserved;
139
+ issuer?: "host";
140
+ requestedBy?: StateCertificateRequester;
141
+ schemaMode?: FabricSchemaMode;
142
+ }
143
+ export interface StateCertificate extends StateCertificateBindingFields {
126
144
  certificateId: string;
127
145
  sequence: number;
128
146
  certificationStatus: "certified";
@@ -134,7 +152,7 @@ export interface StateCertificate {
134
152
  current: boolean;
135
153
  }
136
154
  export interface VerificationFailure {
137
- reason: "missing-target" | "missing-evidence" | "nonzero-exit" | "execution-error" | "reporting-error";
155
+ reason: "missing-target" | "missing-evidence" | "nonzero-exit" | "execution-error" | "reporting-error" | "binding-mismatch" | "binding-unobserved";
138
156
  message: string;
139
157
  transitionId?: string;
140
158
  label?: string;
@@ -153,6 +171,9 @@ export interface VerificationReport {
153
171
  failures: VerificationFailure[];
154
172
  certificate?: StateCertificate;
155
173
  reportingError?: string;
174
+ binding?: StateCertificateBinding;
175
+ observed?: StateCertificateObserved;
176
+ requestedBy?: StateCertificateRequester;
156
177
  }
157
178
  export interface AdvanceHeadInput {
158
179
  payload: StateHeadValue;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,11 @@
1
1
  export declare const FABRIC_RUN_ROOT_PREFIX = "pi-fabric-runs-";
2
+ /**
3
+ * A run root is heartbeated by each retention sweep of its owner, every 15
4
+ * minutes (`RETENTION_SWEEP_INTERVAL_MS` in agents/manager.ts). Across PID
5
+ * namespaces a signal probe means nothing, so three missed sweeps prove the
6
+ * owner dead.
7
+ */
8
+ export declare const RUN_ROOT_HEARTBEAT_TTL_MS: number;
2
9
  export interface RetentionSweepResult {
3
10
  removedRoots: string[];
4
11
  removedRuns: string[];
@@ -1 +1 @@
1
- {"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/storage/retention.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAmBxD,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAwBD,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,YAAgB,KAAG,IAGlE,CAAC;AACF,eAAO,MAAM,gBAAgB,SAJW,MAAM,mBAAqB,IAIlB,CAAC;AAClD,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,YAAgB,EAAE,yBAAuB,KAAG,IAG3F,CAAC;AAuCF,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,OAItD,CAAC;AACF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,OAOjD,CAAC;AAkBF,eAAO,MAAM,iBAAiB,GAAI,SAAS;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B,EAAE,MAAM,CAAC;IACnC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,KAAG,oBA0BH,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,SAAS;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,KAAG,MAAM,EAeT,CAAC"}
1
+ {"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/storage/retention.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAGxD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,QAAkB,CAAC;AAmBzD,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAwBD,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,YAAgB,KAAG,IAGlE,CAAC;AACF,eAAO,MAAM,gBAAgB,SAJW,MAAM,mBAAqB,IAIlB,CAAC;AAClD,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,YAAgB,EAAE,yBAAuB,KAAG,IAG3F,CAAC;AAsDF,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,OAItD,CAAC;AACF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,OAOjD,CAAC;AAkBF,eAAO,MAAM,iBAAiB,GAAI,SAAS;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B,EAAE,MAAM,CAAC;IACnC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,KAAG,oBA0BH,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,SAAS;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,KAAG,MAAM,EAeT,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"scratch.d.ts","sourceRoot":"","sources":["../../src/storage/scratch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AACzD,eAAO,MAAM,kBAAkB,QAAuB,CAAC;AACvD,eAAO,MAAM,iBAAiB,QAAkB,CAAC;AACjD,eAAO,MAAM,uBAAuB,QAAsB,CAAC;AAC3D,eAAO,MAAM,iBAAiB,QAAoB,CAAC;AACnD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,KAAK,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;AAkBrD,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,OAI1C,CAAC;AACF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,EAAE,CAAC,KAAK,GAAG,SAMnD,CAAC;AAiBF,eAAO,MAAM,aAAa,GAAI,MAAM,WAAW,EAAE,iBAAsB,KAAG,MAazE,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,IAQhD,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAOD,kGAAkG;AAClG,eAAO,MAAM,YAAY,GAAU,SAAS,mBAAmB,KAAG,OAAO,CAAC,kBAAkB,CAwE3F,CAAC;AAIF,eAAO,MAAM,oBAAoB,GAAI,iBAAsB,KAAG,IAQ7D,CAAC"}
1
+ {"version":3,"file":"scratch.d.ts","sourceRoot":"","sources":["../../src/storage/scratch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAKzB,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AACzD,eAAO,MAAM,kBAAkB,QAAuB,CAAC;AACvD,eAAO,MAAM,iBAAiB,QAAkB,CAAC;AACjD,eAAO,MAAM,uBAAuB,QAAsB,CAAC;AAC3D,eAAO,MAAM,iBAAiB,QAAoB,CAAC;AACnD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,KAAK,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;AAuBrD,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,OAI1C,CAAC;AAgBF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,EAAE,CAAC,KAAK,GAAG,SAMnD,CAAC;AAiBF,eAAO,MAAM,aAAa,GAAI,MAAM,WAAW,EAAE,iBAAsB,KAAG,MAczE,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,IAQhD,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAOD,kGAAkG;AAClG,eAAO,MAAM,YAAY,GAAU,SAAS,mBAAmB,KAAG,OAAO,CAAC,kBAAkB,CAwE3F,CAAC;AAIF,eAAO,MAAM,oBAAoB,GAAI,iBAAsB,KAAG,IAQ7D,CAAC"}
@@ -0,0 +1,64 @@
1
+ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
2
+ import { FABRIC_THINKING_ENTRY_TYPE, type FabricThinking, type FabricThinkingBounds, type FabricThinkingModel } from "./thinking.js";
3
+ export { FABRIC_THINKING_ENTRY_TYPE };
4
+ export declare const MAX_THINKING_OVERRIDE_TURNS = 20;
5
+ export declare const MAX_THINKING_REASON_CHARS = 256;
6
+ export type FabricThinkingScope = "turn" | "turns" | "session";
7
+ export interface FabricThinkingOverride {
8
+ level: FabricThinking;
9
+ scope: FabricThinkingScope;
10
+ /** `turns` scope only: agent_end events left before reverting. */
11
+ remainingTurns?: number;
12
+ reason?: string;
13
+ setAt: number;
14
+ }
15
+ export interface FabricThinkingStatus {
16
+ level: FabricThinking;
17
+ /** Model-supported levels inside the effective bounds. */
18
+ available: FabricThinking[];
19
+ /** Effective inclusive bounds; unbounded ends resolve to the model's levels. */
20
+ bounds: {
21
+ min: FabricThinking;
22
+ max: FabricThinking;
23
+ };
24
+ /** Level restored when the override ends (the current level without one). */
25
+ baseline: FabricThinking;
26
+ override?: FabricThinkingOverride;
27
+ }
28
+ export interface FabricThinkingSetResult extends FabricThinkingStatus {
29
+ clamped?: true;
30
+ requested?: FabricThinking;
31
+ }
32
+ export interface FabricThinkingSetInput {
33
+ level: FabricThinking;
34
+ scope?: FabricThinkingScope;
35
+ turns?: number;
36
+ reason?: string;
37
+ }
38
+ type ThinkingHost = Pick<ExtensionAPI, "getThinkingLevel" | "setThinkingLevel" | "appendEntry">;
39
+ type ThinkingContext = Pick<ExtensionContext, "sessionManager"> & {
40
+ model?: FabricThinkingModel | undefined;
41
+ };
42
+ export declare class FabricThinkingController {
43
+ #private;
44
+ private readonly host;
45
+ private readonly bounds;
46
+ constructor(host: ThinkingHost, bounds: () => FabricThinkingBounds);
47
+ /** Session switch or tree navigation: replay the branch on next use. */
48
+ invalidate(): void;
49
+ status(context: ThinkingContext): FabricThinkingStatus;
50
+ set(input: FabricThinkingSetInput, context: ThinkingContext): FabricThinkingSetResult;
51
+ reset(context: ThinkingContext): FabricThinkingStatus;
52
+ /**
53
+ * agent_end boundary: count down `turns`, end `turn`. If someone else changed
54
+ * the level since Fabric applied it (user, another extension), the override
55
+ * ends without restoring the baseline: Fabric never fights for the setting.
56
+ */
57
+ agentEnded(context: ThinkingContext): void;
58
+ /**
59
+ * Child sessions: move a level that lies outside the inherited bounds back
60
+ * inside them. Pi's own model clamp may otherwise overshoot a parent's max.
61
+ */
62
+ enforceBounds(context: ThinkingContext): void;
63
+ }
64
+ //# sourceMappingURL=thinking-control.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"thinking-control.d.ts","sourceRoot":"","sources":["../src/thinking-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAEL,0BAA0B,EAK1B,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,eAAe,CAAC;AASvB,OAAO,EAAE,0BAA0B,EAAE,CAAC;AAEtC,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,cAAc,CAAC;IACtB,0DAA0D;IAC1D,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,gFAAgF;IAChF,MAAM,EAAE;QAAE,GAAG,EAAE,cAAc,CAAC;QAAC,GAAG,EAAE,cAAc,CAAA;KAAE,CAAC;IACrD,6EAA6E;IAC7E,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAWD,KAAK,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,aAAa,CAAC,CAAC;AAChG,KAAK,eAAe,GAAG,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAA;CAAE,CAAC;AA2B9G,qBAAa,wBAAwB;;IAMjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,oBAAoB;IAGrD,wEAAwE;IACxE,UAAU,IAAI,IAAI;IAKlB,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,oBAAoB;IAmBtD,GAAG,CAAC,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,eAAe,GAAG,uBAAuB;IA2CrF,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,oBAAoB;IAWrD;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAc1C;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;CAmC9C"}
@@ -0,0 +1,15 @@
1
+ import {
2
+ FabricThinkingController,
3
+ MAX_THINKING_OVERRIDE_TURNS,
4
+ MAX_THINKING_REASON_CHARS
5
+ } from "./chunks/chunk-L22K5BWU.js";
6
+ import {
7
+ FABRIC_THINKING_ENTRY_TYPE
8
+ } from "./chunks/chunk-V73NIH6B.js";
9
+ export {
10
+ FABRIC_THINKING_ENTRY_TYPE,
11
+ FabricThinkingController,
12
+ MAX_THINKING_OVERRIDE_TURNS,
13
+ MAX_THINKING_REASON_CHARS
14
+ };
15
+ //# sourceMappingURL=thinking-control.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": [],
4
+ "sourcesContent": [],
5
+ "mappings": "",
6
+ "names": []
7
+ }
@@ -16,4 +16,65 @@ export declare const THINKING_LEVELS: readonly FabricThinking[];
16
16
  export declare const isFabricThinking: (value: unknown) => value is FabricThinking;
17
17
  /** Human-readable label for a thinking level (shown in pickers and settings). */
18
18
  export declare const thinkingLabel: (level: FabricThinking) => string;
19
+ /**
20
+ * Inclusive thinking-level bounds. An absent end is unbounded on that side
21
+ * (the active model's levels decide). Bounds only ever narrow across process
22
+ * boundaries: a child intersects its own configuration with the parent's
23
+ * bounds received through PI_FABRIC_THINKING_BOUNDS.
24
+ */
25
+ export interface FabricThinkingBounds {
26
+ min?: FabricThinking;
27
+ max?: FabricThinking;
28
+ }
29
+ /** Environment variable carrying a parent's effective bounds into a Pi child. */
30
+ export declare const FABRIC_THINKING_BOUNDS_ENV = "PI_FABRIC_THINKING_BOUNDS";
31
+ /** Session custom entry recording the active Fabric thinking override. */
32
+ export declare const FABRIC_THINKING_ENTRY_TYPE = "pi-fabric-thinking";
33
+ export declare const thinkingRank: (level: FabricThinking) => number;
34
+ /**
35
+ * Validate a bounds object from configuration, arguments, or the environment.
36
+ * Unknown keys, unknown level names and inverted ranges are rejected: bounds
37
+ * are a ceiling policy, so a malformed value fails closed instead of widening.
38
+ */
39
+ export declare const normalizeThinkingBounds: (value: unknown, where: string) => FabricThinkingBounds;
40
+ /**
41
+ * Narrow `outer` by `inner` without ever widening it. When the two ranges do
42
+ * not overlap the outer (parent) range wins unchanged: it is the cost policy.
43
+ */
44
+ export declare const intersectThinkingBounds: (outer: FabricThinkingBounds, inner: FabricThinkingBounds) => FabricThinkingBounds;
45
+ /**
46
+ * True when every explicit end of `inner` lies inside `outer`. An omitted end
47
+ * inherits the outer end, so `{min:"low"}` fits inside `{max:"high"}`.
48
+ */
49
+ export declare const thinkingBoundsWithin: (inner: FabricThinkingBounds, outer: FabricThinkingBounds) => boolean;
50
+ /**
51
+ * Effective bounds for a child run: requested bounds must lie inside the
52
+ * parent's (fail closed), then narrow them. No request inherits the parent.
53
+ */
54
+ export declare const childThinkingBounds: (parent: FabricThinkingBounds, requested: FabricThinkingBounds | undefined) => FabricThinkingBounds;
55
+ /** Clamp a level into inclusive bounds (no model knowledge). */
56
+ export declare const clampThinkingToBounds: (level: FabricThinking, bounds: FabricThinkingBounds) => FabricThinking;
57
+ /** Levels allowed by bounds, optionally restricted to a model's supported levels. */
58
+ export declare const thinkingLevelsWithin: (bounds: FabricThinkingBounds, supported?: readonly FabricThinking[]) => FabricThinking[];
59
+ /**
60
+ * Pick the allowed level for a request: clamp into bounds, then use pi-ai's
61
+ * next-highest-then-lower fallback restricted to `allowed`. Undefined when
62
+ * nothing is allowed.
63
+ */
64
+ export declare const selectThinkingLevel: (requested: FabricThinking, allowed: readonly FabricThinking[]) => FabricThinking | undefined;
65
+ /** Structural subset of a pi-ai Model; mirrors getSupportedThinkingLevels. */
66
+ export interface FabricThinkingModel {
67
+ reasoning?: boolean;
68
+ thinkingLevelMap?: Partial<Record<string, string | null>>;
69
+ }
70
+ /**
71
+ * Supported levels for a model, matching pi-ai getSupportedThinkingLevels
72
+ * without importing it (Fabric keeps pi-ai out of its eager graph). No model
73
+ * means Pi offers every level.
74
+ */
75
+ export declare const modelThinkingLevels: (model: FabricThinkingModel | undefined) => FabricThinking[];
76
+ /** Bounds inherited from a parent Fabric; malformed values throw (fail closed). */
77
+ export declare const inheritedThinkingBounds: (env?: NodeJS.ProcessEnv) => FabricThinkingBounds | undefined;
78
+ /** Compact JSON for PI_FABRIC_THINKING_BOUNDS; undefined when unbounded. */
79
+ export declare const serializeThinkingBounds: (bounds: FabricThinkingBounds) => string | undefined;
19
80
  //# sourceMappingURL=thinking.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"thinking.d.ts","sourceRoot":"","sources":["../src/thinking.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAE7F,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,EAAE,cAAyB,CAAC;AAEhE,2EAA2E;AAC3E,eAAO,MAAM,eAAe,EAAE,SAAS,cAAc,EAQpD,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cAC0B,CAAC;AAYtF,iFAAiF;AACjF,eAAO,MAAM,aAAa,GAAI,OAAO,cAAc,KAAG,MAAuB,CAAC"}
1
+ {"version":3,"file":"thinking.d.ts","sourceRoot":"","sources":["../src/thinking.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAE7F,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,EAAE,cAAyB,CAAC;AAEhE,2EAA2E;AAC3E,eAAO,MAAM,eAAe,EAAE,SAAS,cAAc,EAQpD,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cAC0B,CAAC;AAYtF,iFAAiF;AACjF,eAAO,MAAM,aAAa,GAAI,OAAO,cAAc,KAAG,MAAuB,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB;AAED,iFAAiF;AACjF,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AACtE,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAE/D,eAAO,MAAM,YAAY,GAAI,OAAO,cAAc,KAAG,MAAwC,CAAC;AAE9F;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,EAAE,OAAO,MAAM,KAAG,oBAqBvE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,oBAAoB,EAC3B,OAAO,oBAAoB,KAC1B,oBAUF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,oBAAoB,EAC3B,OAAO,oBAAoB,KAC1B,OAKF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,oBAAoB,EAC5B,WAAW,oBAAoB,GAAG,SAAS,KAC1C,oBASF,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,qBAAqB,GAChC,OAAO,cAAc,EACrB,QAAQ,oBAAoB,KAC3B,cAIF,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,oBAAoB,EAC5B,YAAW,SAAS,cAAc,EAAoB,KACrD,cAAc,EAE+D,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,cAAc,EACzB,SAAS,SAAS,cAAc,EAAE,KACjC,cAAc,GAAG,SAUnB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC3D;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,mBAAmB,GAAG,SAAS,KAAG,cAAc,EAS1F,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,GAClC,MAAK,MAAM,CAAC,UAAwB,KACnC,oBAAoB,GAAG,SAUzB,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,GAAI,QAAQ,oBAAoB,KAAG,MAAM,GAAG,SAGjE,CAAC"}
@@ -1,5 +1,7 @@
1
1
  import type { FabricActorRunBinding } from "../actors/types.js";
2
2
  import { MeshStore, type MeshIdentity } from "../mesh/store.js";
3
+ import type { FabricMessageSender } from "../protocol.js";
4
+ export declare const STALE_INCARNATION_ERROR = "Fabric control command targets a previous owner incarnation; the owner restarted. Re-resolve the participant and retry.";
3
5
  export type FabricControlOperation = "steer" | "followUp" | "stop" | "ask" | "cancel";
4
6
  export interface FabricControlCommand {
5
7
  version: 1;
@@ -12,8 +14,12 @@ export interface FabricControlCommand {
12
14
  triggerTurn?: boolean;
13
15
  binding?: FabricActorRunBinding;
14
16
  cancelCommandId?: string;
17
+ /** Owner process incarnation the requester resolved; absent from older senders. */
18
+ ownerIncarnation?: string;
15
19
  requestedAt: number;
16
20
  deadlineAt?: number;
21
+ /** The command event's host stamp, copied by the receiving owner; never read from command data. */
22
+ sender?: FabricMessageSender;
17
23
  }
18
24
  export interface FabricControlAcceptance {
19
25
  accepted: boolean;
@@ -39,6 +45,11 @@ export interface FabricControlInput {
39
45
  data?: unknown;
40
46
  triggerTurn?: boolean;
41
47
  binding?: FabricActorRunBinding;
48
+ /**
49
+ * The target participant record's `ownerIncarnation`. When set, a restarted
50
+ * owner refuses the command and acknowledgements from other incarnations are ignored.
51
+ */
52
+ ownerIncarnation?: string;
42
53
  }
43
54
  export interface FabricControlRequestOptions {
44
55
  timeoutMs?: number;
@@ -50,6 +61,8 @@ export declare class FabricControlPlane {
50
61
  readonly identity: MeshIdentity;
51
62
  readonly options: FabricControlPlaneOptions;
52
63
  constructor(mesh: MeshStore, identity: MeshIdentity, options: FabricControlPlaneOptions);
64
+ /** Random per-instance id; owners stamp it on participant records they publish. */
65
+ get incarnation(): string;
53
66
  start(handler: FabricControlHandler): void;
54
67
  request(ownerHostId: string, targetId: string, operation: FabricControlOperation, input?: FabricControlInput, ownerIdentityId?: string): Promise<FabricControlResult>;
55
68
  requestResult<T>(ownerHostId: string, targetId: string, operation: FabricControlOperation, input?: FabricControlInput, ownerIdentityId?: string, options?: FabricControlRequestOptions): Promise<T>;
@@ -1 +1 @@
1
- {"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../../src/topology/control-plane.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAkB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUhF,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEtF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,sBAAsB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,uBAAuB,CAAC,GAAG,uBAAuB,CAAC;AA4DhE,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAeD,qBAAa,kBAAkB;;IAkB3B,QAAQ,CAAC,IAAI,EAAE,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,YAAY;IAC/B,QAAQ,CAAC,OAAO,EAAE,yBAAyB;gBAFlC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,yBAAyB;IAU7C,KAAK,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAQpC,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,sBAAsB,EACjC,KAAK,GAAE,kBAAuB,EAC9B,eAAe,SAAc,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAiBzB,aAAa,CAAC,CAAC,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,sBAAsB,EACjC,KAAK,GAAE,kBAAuB,EAC9B,eAAe,SAAc,EAC7B,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,CAAC,CAAC;IA8IP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAsS7B"}
1
+ {"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../../src/topology/control-plane.ts"],"names":[],"mappings":"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"}
@@ -8,6 +8,8 @@ export interface ParticipantDirectoryOptions {
8
8
  identity: MeshIdentity;
9
9
  selfOwnerHostId?: string;
10
10
  selfOwnerIdentityId?: string;
11
+ /** This host's control-plane incarnation, stamped on every record it writes. */
12
+ ownerIncarnation?: string;
11
13
  heartbeatMs?: number;
12
14
  leaseMs?: number;
13
15
  }
@@ -1 +1 @@
1
- {"version":3,"file":"participant-directory.d.ts","sourceRoot":"","sources":["../../src/topology/participant-directory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAuB,MAAM,kBAAkB,CAAC;AACrF,OAAO,KAAK,EAEV,qBAAqB,EAErB,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACf,MAAM,YAAY,CAAC;AAoNpB,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,yBAAyB,GAAG,MAAM,uBAAuB,EAAE,CAAC;AAExE,qBAAa,oBAAqB,YAAW,uBAAuB;;IAchE,QAAQ,CAAC,IAAI,EAAE,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,2BAA2B;gBADpC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,2BAA2B;IAM/C,cAAc,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,IAAI;IASvD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB5B,eAAe,IAAI,IAAI;IAcjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B,IAAI,CACF,OAAO,GAAE,4BAAiC,EAC1C,GAAG,SAAa,GACf,qBAAqB,EAAE;IA2E1B,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,qBAAqB,GAAG,SAAS;IAKpE,IAAI,CAAC,GAAG,SAAa,GAAG,qBAAqB;IAsC7C,QAAQ,CAAC,GAAG,SAAa,GAAG,qBAAqB,EAAE;IAInD,KAAK,CAAC,GAAG,SAAa,GAAG,cAAc,EAAE;IASzC,IAAI,CAAC,IAAI,EAAE,mBAAmB,GAAG,uBAAuB;IAwBlD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuN7B"}
1
+ {"version":3,"file":"participant-directory.d.ts","sourceRoot":"","sources":["../../src/topology/participant-directory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAuB,MAAM,kBAAkB,CAAC;AACrF,OAAO,KAAK,EAEV,qBAAqB,EAErB,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACf,MAAM,YAAY,CAAC;AAkOpB,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,yBAAyB,GAAG,MAAM,uBAAuB,EAAE,CAAC;AAExE,qBAAa,oBAAqB,YAAW,uBAAuB;;IAchE,QAAQ,CAAC,IAAI,EAAE,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,2BAA2B;gBADpC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,2BAA2B;IAM/C,cAAc,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,IAAI;IASvD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB5B,eAAe,IAAI,IAAI;IAcjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B,IAAI,CACF,OAAO,GAAE,4BAAiC,EAC1C,GAAG,SAAa,GACf,qBAAqB,EAAE;IA2E1B,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,qBAAqB,GAAG,SAAS;IAKpE,IAAI,CAAC,GAAG,SAAa,GAAG,qBAAqB;IAyC7C,QAAQ,CAAC,GAAG,SAAa,GAAG,qBAAqB,EAAE;IAInD,KAAK,CAAC,GAAG,SAAa,GAAG,cAAc,EAAE;IASzC,IAAI,CAAC,IAAI,EAAE,mBAAmB,GAAG,uBAAuB;IA2BlD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAgO7B"}
@@ -0,0 +1,72 @@
1
+ import type { AgentUsage } from "../agents/types.js";
2
+ import type { FabricAgentMessageResult } from "../main-agent.js";
3
+ import type { FabricInvocationParticipants, FabricParticipantSettlement } from "../protocol.js";
4
+ import type { FabricControlAcceptance, FabricControlCommand, FabricControlPlane, FabricControlResult } from "./control-plane.js";
5
+ import type { FabricParticipantCapability, FabricParticipantRecord, FabricParticipantSource } from "./types.js";
6
+ export declare const PROVIDER_PARTICIPANT_PREFIX = "provider:";
7
+ /** Owned-work cancellation reason passed to `stop()` when a program ends early. */
8
+ export declare const PROGRAM_CANCELLED_REASON = "program_cancelled";
9
+ /** Total bound for the parallel owned-work stop sweep after cancellation. */
10
+ export declare const OWNED_WORK_STOP_TIMEOUT_MS = 5000;
11
+ export type ProviderParticipantStatus = "running" | FabricParticipantSettlement["status"];
12
+ export interface ProviderParticipantStopOutcome {
13
+ ref: string;
14
+ outcome: "confirmed" | "unconfirmed";
15
+ /** Why a stop is unconfirmed: the provider declined, threw, or missed the deadline. */
16
+ detail?: "declined" | "error" | "timeout";
17
+ }
18
+ export interface ProviderParticipantInfo {
19
+ ref: string;
20
+ provider: string;
21
+ id: string;
22
+ label: string;
23
+ kind?: string;
24
+ detached: boolean;
25
+ status: ProviderParticipantStatus;
26
+ startedAt: number;
27
+ updatedAt: number;
28
+ finishedAt?: number;
29
+ phase?: string;
30
+ message?: string;
31
+ summary?: string;
32
+ usage?: AgentUsage;
33
+ capabilities: FabricParticipantCapability[];
34
+ }
35
+ export declare const isProviderParticipantRef: (value: string) => boolean;
36
+ /**
37
+ * Session-owned registry of provider-registered participants. Providers reach
38
+ * it only through the per-invocation `context.participants` view, which binds
39
+ * the provider name, so one provider cannot register or impersonate another's
40
+ * refs. Callbacks run in this process; remote hosts reach them through the
41
+ * participant control plane.
42
+ */
43
+ export declare class ProviderParticipantRegistry {
44
+ #private;
45
+ /** Per-invocation, provider-bound registration view handed to `invoke`. */
46
+ view(provider: string, invocationId: string): FabricInvocationParticipants;
47
+ subscribe(listener: () => void): () => void;
48
+ has(ref: string): boolean;
49
+ get(ref: string): ProviderParticipantInfo | undefined;
50
+ list(): ProviderParticipantInfo[];
51
+ /** Directory records; the directory stamps owner host and identity on publish. */
52
+ records(rootId: string, ownerHostId: string, ownerIdentityId: string): FabricParticipantRecord[];
53
+ stop(ref: string, reason?: string): Promise<ProviderParticipantStopOutcome>;
54
+ deliver(ref: string, operation: "steer" | "followUp", message: string): Promise<void>;
55
+ /**
56
+ * Stop every unsettled, non-detached participant registered during the
57
+ * invocation, in parallel, within one shared deadline.
58
+ */
59
+ cancelInvocation(invocationId: string, reason?: string, timeoutMs?: number): Promise<ProviderParticipantStopOutcome[]>;
60
+ /** Forget a withdrawn provider's participants; their handles become inert. */
61
+ releaseProvider(provider: string): number;
62
+ /** Session shutdown: forget every participant without calling providers. */
63
+ releaseAll(): void;
64
+ }
65
+ /**
66
+ * Route `agents.stop/steer/followUp` for a `provider:` ref: local callbacks
67
+ * when this session owns it, otherwise the owner's control plane.
68
+ */
69
+ export declare const controlProviderParticipant: (registry: ProviderParticipantRegistry | undefined, directory: Pick<FabricParticipantSource, "get">, control: Pick<FabricControlPlane, "request"> | undefined, ref: string, operation: "stop" | "steer" | "followUp", message?: string, data?: unknown) => Promise<ProviderParticipantStopOutcome | FabricAgentMessageResult | FabricControlResult>;
70
+ /** Owner side of a remote control command aimed at a `provider:` ref. */
71
+ export declare const acceptProviderParticipantControl: (registry: ProviderParticipantRegistry | undefined, command: FabricControlCommand) => Promise<FabricControlAcceptance>;
72
+ //# sourceMappingURL=provider-participants.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider-participants.d.ts","sourceRoot":"","sources":["../../src/topology/provider-participants.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/topology/records.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAM1D,eAAO,MAAM,uBAAuB,GAClC,SAAS,KAAK,CAAC,cAAc,GAAG,eAAe,CAAC,EAChD,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,iBAAiB,MAAM,EACvB,UAAU,MAAM,EAChB,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7B,uBAAuB,EA4CzB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,OAAO,eAAe,EACtB,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,iBAAiB,MAAM,EACvB,UAAU,MAAM,KACf,uBA0BD,CAAC"}
1
+ {"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/topology/records.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAM1D,eAAO,MAAM,uBAAuB,GAClC,SAAS,KAAK,CAAC,cAAc,GAAG,eAAe,CAAC,EAChD,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,iBAAiB,MAAM,EACvB,UAAU,MAAM,EAChB,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7B,uBAAuB,EAgDzB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,OAAO,eAAe,EACtB,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,iBAAiB,MAAM,EACvB,UAAU,MAAM,KACf,uBA4BD,CAAC"}
@@ -1,7 +1,8 @@
1
1
  import type { FabricAgentRunner, FabricAgentTransport } from "../config.js";
2
2
  import type { MeshIdentity } from "../mesh/store.js";
3
3
  import type { AgentUsage } from "../agents/types.js";
4
- export type FabricParticipantKind = "root" | "agent" | "actor";
4
+ /** `provider`: work a Fabric provider registered through `context.participants`. */
5
+ export type FabricParticipantKind = "root" | "agent" | "actor" | "provider";
5
6
  export type FabricParticipantResidency = "session" | "durable";
6
7
  export type FabricParticipantScope = "local" | "lineage" | "project";
7
8
  export type FabricParticipantCapability = "steer" | "followUp" | "stop" | "ask" | "actor-bindings" | "attach" | "fabric";
@@ -12,6 +13,12 @@ export interface FabricParticipantRecord {
12
13
  rootId: string;
13
14
  ownerHostId: string;
14
15
  ownerIdentityId: string;
16
+ /**
17
+ * Control-plane incarnation of the owner process that wrote this record.
18
+ * Requesters copy it onto control commands so a restarted owner can refuse
19
+ * commands meant for its previous process. Absent on older records.
20
+ */
21
+ ownerIncarnation?: string;
15
22
  parentId?: string;
16
23
  name: string;
17
24
  /**
@@ -21,8 +28,11 @@ export interface FabricParticipantRecord {
21
28
  label?: string;
22
29
  status: string;
23
30
  residency?: FabricParticipantResidency;
24
- runner: FabricAgentRunner;
25
- transport: FabricAgentTransport | "host";
31
+ /** Absent only for `provider` participants, which have no agent runner. */
32
+ runner?: FabricAgentRunner;
33
+ /** Registering provider name for `provider` participants. */
34
+ provider?: string;
35
+ transport: FabricAgentTransport | "host" | "hosted";
26
36
  capabilities: FabricParticipantCapability[];
27
37
  cwd?: string;
28
38
  sessionId?: string;