@theokit/sdk 0.0.0-compat-580-20260905204608
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.
- package/CHANGELOG.md +7923 -0
- package/LICENSE +201 -0
- package/README.md +114 -0
- package/dist/a2a/agent-mailbox.d.cts +54 -0
- package/dist/a2a/agent-mailbox.d.ts +54 -0
- package/dist/a2a/index.cjs +138 -0
- package/dist/a2a/index.cjs.map +1 -0
- package/dist/a2a/index.d.cts +10 -0
- package/dist/a2a/index.d.ts +10 -0
- package/dist/a2a/index.js +125 -0
- package/dist/a2a/index.js.map +1 -0
- package/dist/a2a/message-bus.d.cts +118 -0
- package/dist/a2a/message-bus.d.ts +118 -0
- package/dist/a2a/subagent.d.cts +231 -0
- package/dist/a2a/subagent.d.ts +231 -0
- package/dist/a2a/types.d.cts +45 -0
- package/dist/a2a/types.d.ts +45 -0
- package/dist/agent-ARLOD4JX.cjs +67 -0
- package/dist/agent-ARLOD4JX.cjs.map +1 -0
- package/dist/agent-C3KO5LKm.d.cts +1871 -0
- package/dist/agent-CvmTR9uf.d.ts +1871 -0
- package/dist/agent-N6WJ54ML.js +58 -0
- package/dist/agent-N6WJ54ML.js.map +1 -0
- package/dist/agent-builder.d.ts +72 -0
- package/dist/agent-factory-registry-UU46BUMU.cjs +16 -0
- package/dist/agent-factory-registry-UU46BUMU.cjs.map +1 -0
- package/dist/agent-factory-registry-ZVTABLEY.js +3 -0
- package/dist/agent-factory-registry-ZVTABLEY.js.map +1 -0
- package/dist/agent-factory.d.ts +24 -0
- package/dist/agent-generate.d.ts +12 -0
- package/dist/agent-session-store-AFML3AXC.js +6 -0
- package/dist/agent-session-store-AFML3AXC.js.map +1 -0
- package/dist/agent-session-store-MTSIY3MH.cjs +23 -0
- package/dist/agent-session-store-MTSIY3MH.cjs.map +1 -0
- package/dist/agent.d.ts +276 -0
- package/dist/auth/index.cjs +306 -0
- package/dist/auth/index.cjs.map +1 -0
- package/dist/auth/index.d.cts +34 -0
- package/dist/auth/index.d.ts +34 -0
- package/dist/auth/index.js +247 -0
- package/dist/auth/index.js.map +1 -0
- package/dist/batch-I6T6MXZO.cjs +263 -0
- package/dist/batch-I6T6MXZO.cjs.map +1 -0
- package/dist/batch-US4F6WPK.js +260 -0
- package/dist/batch-US4F6WPK.js.map +1 -0
- package/dist/chunk-24MGQDK3.js +31 -0
- package/dist/chunk-24MGQDK3.js.map +1 -0
- package/dist/chunk-24SYBZPL.cjs +121 -0
- package/dist/chunk-24SYBZPL.cjs.map +1 -0
- package/dist/chunk-2HPNT6HH.cjs +3373 -0
- package/dist/chunk-2HPNT6HH.cjs.map +1 -0
- package/dist/chunk-2SFBB54R.js +23 -0
- package/dist/chunk-2SFBB54R.js.map +1 -0
- package/dist/chunk-2WXHA33T.js +105 -0
- package/dist/chunk-2WXHA33T.js.map +1 -0
- package/dist/chunk-2XC6KDJM.js +22 -0
- package/dist/chunk-2XC6KDJM.js.map +1 -0
- package/dist/chunk-2XRAWOZZ.js +172 -0
- package/dist/chunk-2XRAWOZZ.js.map +1 -0
- package/dist/chunk-2ZPEDVLM.cjs +59 -0
- package/dist/chunk-2ZPEDVLM.cjs.map +1 -0
- package/dist/chunk-3EE6LVWT.cjs +29 -0
- package/dist/chunk-3EE6LVWT.cjs.map +1 -0
- package/dist/chunk-3JHIFQ4I.js +102 -0
- package/dist/chunk-3JHIFQ4I.js.map +1 -0
- package/dist/chunk-44I6UYVH.js +133 -0
- package/dist/chunk-44I6UYVH.js.map +1 -0
- package/dist/chunk-47TF32NQ.js +79 -0
- package/dist/chunk-47TF32NQ.js.map +1 -0
- package/dist/chunk-4A3SKJ53.cjs +297 -0
- package/dist/chunk-4A3SKJ53.cjs.map +1 -0
- package/dist/chunk-4HS6FFGL.cjs +433 -0
- package/dist/chunk-4HS6FFGL.cjs.map +1 -0
- package/dist/chunk-4MMWFSCD.js +25 -0
- package/dist/chunk-4MMWFSCD.js.map +1 -0
- package/dist/chunk-4NLCWGH7.cjs +177 -0
- package/dist/chunk-4NLCWGH7.cjs.map +1 -0
- package/dist/chunk-55GB6JYQ.js +208 -0
- package/dist/chunk-55GB6JYQ.js.map +1 -0
- package/dist/chunk-5WKQDIGO.js +136 -0
- package/dist/chunk-5WKQDIGO.js.map +1 -0
- package/dist/chunk-67SBTGMA.cjs +457 -0
- package/dist/chunk-67SBTGMA.cjs.map +1 -0
- package/dist/chunk-6LHQPOMI.cjs +193 -0
- package/dist/chunk-6LHQPOMI.cjs.map +1 -0
- package/dist/chunk-6M2OIS4Y.js +158 -0
- package/dist/chunk-6M2OIS4Y.js.map +1 -0
- package/dist/chunk-6PWOWXMC.js +121 -0
- package/dist/chunk-6PWOWXMC.js.map +1 -0
- package/dist/chunk-6X6ID4MO.js +20 -0
- package/dist/chunk-6X6ID4MO.js.map +1 -0
- package/dist/chunk-7A6535RA.cjs +231 -0
- package/dist/chunk-7A6535RA.cjs.map +1 -0
- package/dist/chunk-7FDKWDA2.cjs +135 -0
- package/dist/chunk-7FDKWDA2.cjs.map +1 -0
- package/dist/chunk-7I5Z3UBJ.js +10 -0
- package/dist/chunk-7I5Z3UBJ.js.map +1 -0
- package/dist/chunk-7JJ3A6AT.cjs +88 -0
- package/dist/chunk-7JJ3A6AT.cjs.map +1 -0
- package/dist/chunk-7SZAV6QG.js +593 -0
- package/dist/chunk-7SZAV6QG.js.map +1 -0
- package/dist/chunk-A4RAL2ER.cjs +51 -0
- package/dist/chunk-A4RAL2ER.cjs.map +1 -0
- package/dist/chunk-AA27GEYS.cjs +12 -0
- package/dist/chunk-AA27GEYS.cjs.map +1 -0
- package/dist/chunk-AAEZSPTC.js +133 -0
- package/dist/chunk-AAEZSPTC.js.map +1 -0
- package/dist/chunk-AGACYRJ2.js +11 -0
- package/dist/chunk-AGACYRJ2.js.map +1 -0
- package/dist/chunk-ALUN2B4W.js +356 -0
- package/dist/chunk-ALUN2B4W.js.map +1 -0
- package/dist/chunk-ANMJJD6D.cjs +18 -0
- package/dist/chunk-ANMJJD6D.cjs.map +1 -0
- package/dist/chunk-ATT276RD.cjs +173 -0
- package/dist/chunk-ATT276RD.cjs.map +1 -0
- package/dist/chunk-AW6F6HZR.js +166 -0
- package/dist/chunk-AW6F6HZR.js.map +1 -0
- package/dist/chunk-AWINL3ZC.js +109 -0
- package/dist/chunk-AWINL3ZC.js.map +1 -0
- package/dist/chunk-BJUJT5ED.cjs +186 -0
- package/dist/chunk-BJUJT5ED.cjs.map +1 -0
- package/dist/chunk-BUUUWQMB.cjs +34 -0
- package/dist/chunk-BUUUWQMB.cjs.map +1 -0
- package/dist/chunk-BV2MWEMV.cjs +26 -0
- package/dist/chunk-BV2MWEMV.cjs.map +1 -0
- package/dist/chunk-CFE6QF2Q.js +221 -0
- package/dist/chunk-CFE6QF2Q.js.map +1 -0
- package/dist/chunk-CZJ6Q7CW.js +183 -0
- package/dist/chunk-CZJ6Q7CW.js.map +1 -0
- package/dist/chunk-D3CCY3A2.cjs +10995 -0
- package/dist/chunk-D3CCY3A2.cjs.map +1 -0
- package/dist/chunk-D6POWE7E.cjs +210 -0
- package/dist/chunk-D6POWE7E.cjs.map +1 -0
- package/dist/chunk-DMRT67Y6.js +100 -0
- package/dist/chunk-DMRT67Y6.js.map +1 -0
- package/dist/chunk-DQZU7JK6.cjs +125 -0
- package/dist/chunk-DQZU7JK6.cjs.map +1 -0
- package/dist/chunk-EFMFILPG.js +77 -0
- package/dist/chunk-EFMFILPG.js.map +1 -0
- package/dist/chunk-EH6XD3FY.js +222 -0
- package/dist/chunk-EH6XD3FY.js.map +1 -0
- package/dist/chunk-EIQFAOFD.js +229 -0
- package/dist/chunk-EIQFAOFD.js.map +1 -0
- package/dist/chunk-EPSICJLZ.js +79 -0
- package/dist/chunk-EPSICJLZ.js.map +1 -0
- package/dist/chunk-EXTRW7GW.cjs +155 -0
- package/dist/chunk-EXTRW7GW.cjs.map +1 -0
- package/dist/chunk-FD2UT76F.js +3 -0
- package/dist/chunk-FD2UT76F.js.map +1 -0
- package/dist/chunk-FJWQP6EE.js +122 -0
- package/dist/chunk-FJWQP6EE.js.map +1 -0
- package/dist/chunk-FRITRLZQ.cjs +24 -0
- package/dist/chunk-FRITRLZQ.cjs.map +1 -0
- package/dist/chunk-FUSDYC2B.cjs +280 -0
- package/dist/chunk-FUSDYC2B.cjs.map +1 -0
- package/dist/chunk-G7BLGBRN.js +43 -0
- package/dist/chunk-G7BLGBRN.js.map +1 -0
- package/dist/chunk-GBCVPKHE.js +282 -0
- package/dist/chunk-GBCVPKHE.js.map +1 -0
- package/dist/chunk-GHX4P3V2.cjs +34 -0
- package/dist/chunk-GHX4P3V2.cjs.map +1 -0
- package/dist/chunk-GZV6AVRL.cjs +282 -0
- package/dist/chunk-GZV6AVRL.cjs.map +1 -0
- package/dist/chunk-H73MEMQB.js +31 -0
- package/dist/chunk-H73MEMQB.js.map +1 -0
- package/dist/chunk-HCT4HPCL.cjs +235 -0
- package/dist/chunk-HCT4HPCL.cjs.map +1 -0
- package/dist/chunk-HFEJE7AC.js +424 -0
- package/dist/chunk-HFEJE7AC.js.map +1 -0
- package/dist/chunk-HKCKOAIO.js +57 -0
- package/dist/chunk-HKCKOAIO.js.map +1 -0
- package/dist/chunk-HUFSABUZ.cjs +48 -0
- package/dist/chunk-HUFSABUZ.cjs.map +1 -0
- package/dist/chunk-HW7SEELD.cjs +46 -0
- package/dist/chunk-HW7SEELD.cjs.map +1 -0
- package/dist/chunk-HY66GLM6.js +13 -0
- package/dist/chunk-HY66GLM6.js.map +1 -0
- package/dist/chunk-I2PWY7VM.cjs +27 -0
- package/dist/chunk-I2PWY7VM.cjs.map +1 -0
- package/dist/chunk-IJ7M6GOG.cjs +28 -0
- package/dist/chunk-IJ7M6GOG.cjs.map +1 -0
- package/dist/chunk-IU5N5224.cjs +288 -0
- package/dist/chunk-IU5N5224.cjs.map +1 -0
- package/dist/chunk-IUMAQURF.js +130 -0
- package/dist/chunk-IUMAQURF.js.map +1 -0
- package/dist/chunk-J7J7J2GN.cjs +377 -0
- package/dist/chunk-J7J7J2GN.cjs.map +1 -0
- package/dist/chunk-JLRLCBJ4.cjs +108 -0
- package/dist/chunk-JLRLCBJ4.cjs.map +1 -0
- package/dist/chunk-JMDDYA22.js +171 -0
- package/dist/chunk-JMDDYA22.js.map +1 -0
- package/dist/chunk-JNAA4G4H.js +43 -0
- package/dist/chunk-JNAA4G4H.js.map +1 -0
- package/dist/chunk-JOFVLOFY.js +268 -0
- package/dist/chunk-JOFVLOFY.js.map +1 -0
- package/dist/chunk-K2BQQ445.js +30 -0
- package/dist/chunk-K2BQQ445.js.map +1 -0
- package/dist/chunk-K2VMFZQ5.js +487 -0
- package/dist/chunk-K2VMFZQ5.js.map +1 -0
- package/dist/chunk-K3NH62DG.js +3343 -0
- package/dist/chunk-K3NH62DG.js.map +1 -0
- package/dist/chunk-KGANQYP7.cjs +172 -0
- package/dist/chunk-KGANQYP7.cjs.map +1 -0
- package/dist/chunk-KRD3GQAA.cjs +71 -0
- package/dist/chunk-KRD3GQAA.cjs.map +1 -0
- package/dist/chunk-KTTHHYEW.cjs +45 -0
- package/dist/chunk-KTTHHYEW.cjs.map +1 -0
- package/dist/chunk-KVNWIAO4.js +68 -0
- package/dist/chunk-KVNWIAO4.js.map +1 -0
- package/dist/chunk-KVSAY6NZ.cjs +497 -0
- package/dist/chunk-KVSAY6NZ.cjs.map +1 -0
- package/dist/chunk-LOHMT36V.cjs +178 -0
- package/dist/chunk-LOHMT36V.cjs.map +1 -0
- package/dist/chunk-LX7SEXOQ.js +152 -0
- package/dist/chunk-LX7SEXOQ.js.map +1 -0
- package/dist/chunk-MUUQ2WFJ.cjs +4 -0
- package/dist/chunk-MUUQ2WFJ.cjs.map +1 -0
- package/dist/chunk-N6OOOYFZ.js +281 -0
- package/dist/chunk-N6OOOYFZ.js.map +1 -0
- package/dist/chunk-NAF4L3T6.js +22 -0
- package/dist/chunk-NAF4L3T6.js.map +1 -0
- package/dist/chunk-NINIJCHU.cjs +23 -0
- package/dist/chunk-NINIJCHU.cjs.map +1 -0
- package/dist/chunk-NJWYQWDL.js +43 -0
- package/dist/chunk-NJWYQWDL.js.map +1 -0
- package/dist/chunk-NQTD6QOW.cjs +226 -0
- package/dist/chunk-NQTD6QOW.cjs.map +1 -0
- package/dist/chunk-NQTNSHSB.cjs +843 -0
- package/dist/chunk-NQTNSHSB.cjs.map +1 -0
- package/dist/chunk-NVXXWAU7.cjs +13 -0
- package/dist/chunk-NVXXWAU7.cjs.map +1 -0
- package/dist/chunk-NYQ3IS7K.cjs +130 -0
- package/dist/chunk-NYQ3IS7K.cjs.map +1 -0
- package/dist/chunk-O6USDERH.js +165 -0
- package/dist/chunk-O6USDERH.js.map +1 -0
- package/dist/chunk-OBA6YK2R.cjs +8 -0
- package/dist/chunk-OBA6YK2R.cjs.map +1 -0
- package/dist/chunk-OQRGVTQF.js +169 -0
- package/dist/chunk-OQRGVTQF.js.map +1 -0
- package/dist/chunk-OR6XIWLB.js +19 -0
- package/dist/chunk-OR6XIWLB.js.map +1 -0
- package/dist/chunk-OYD3U3LY.js +10981 -0
- package/dist/chunk-OYD3U3LY.js.map +1 -0
- package/dist/chunk-PRZ3BES7.cjs +79 -0
- package/dist/chunk-PRZ3BES7.cjs.map +1 -0
- package/dist/chunk-PY2RQOA7.js +6 -0
- package/dist/chunk-PY2RQOA7.js.map +1 -0
- package/dist/chunk-Q5EWJPRY.js +18 -0
- package/dist/chunk-Q5EWJPRY.js.map +1 -0
- package/dist/chunk-QATRS7JD.cjs +158 -0
- package/dist/chunk-QATRS7JD.cjs.map +1 -0
- package/dist/chunk-QC55H6RJ.cjs +601 -0
- package/dist/chunk-QC55H6RJ.cjs.map +1 -0
- package/dist/chunk-QDM3OHUT.cjs +134 -0
- package/dist/chunk-QDM3OHUT.cjs.map +1 -0
- package/dist/chunk-QKLOP4VC.cjs +90 -0
- package/dist/chunk-QKLOP4VC.cjs.map +1 -0
- package/dist/chunk-QOGNZMHD.cjs +34 -0
- package/dist/chunk-QOGNZMHD.cjs.map +1 -0
- package/dist/chunk-QWD3CZWE.cjs +108 -0
- package/dist/chunk-QWD3CZWE.cjs.map +1 -0
- package/dist/chunk-QWD4RDZ3.cjs +136 -0
- package/dist/chunk-QWD4RDZ3.cjs.map +1 -0
- package/dist/chunk-QYLZQ43D.cjs +172 -0
- package/dist/chunk-QYLZQ43D.cjs.map +1 -0
- package/dist/chunk-R7WIIPUR.js +27 -0
- package/dist/chunk-R7WIIPUR.js.map +1 -0
- package/dist/chunk-RQMCOFAI.cjs +85 -0
- package/dist/chunk-RQMCOFAI.cjs.map +1 -0
- package/dist/chunk-SA6K24NB.cjs +25 -0
- package/dist/chunk-SA6K24NB.cjs.map +1 -0
- package/dist/chunk-SADXXGWU.js +809 -0
- package/dist/chunk-SADXXGWU.js.map +1 -0
- package/dist/chunk-SAGRF4IB.js +25 -0
- package/dist/chunk-SAGRF4IB.js.map +1 -0
- package/dist/chunk-SVQIW5RJ.js +81 -0
- package/dist/chunk-SVQIW5RJ.js.map +1 -0
- package/dist/chunk-TA3K7SBK.js +180 -0
- package/dist/chunk-TA3K7SBK.js.map +1 -0
- package/dist/chunk-TFG5IBZS.cjs +139 -0
- package/dist/chunk-TFG5IBZS.cjs.map +1 -0
- package/dist/chunk-TMKTSYDS.cjs +21 -0
- package/dist/chunk-TMKTSYDS.cjs.map +1 -0
- package/dist/chunk-UADQJBHR.cjs +172 -0
- package/dist/chunk-UADQJBHR.cjs.map +1 -0
- package/dist/chunk-UBR5PWD7.js +275 -0
- package/dist/chunk-UBR5PWD7.js.map +1 -0
- package/dist/chunk-UKMBRMGT.js +22 -0
- package/dist/chunk-UKMBRMGT.js.map +1 -0
- package/dist/chunk-V22DZIXO.js +147 -0
- package/dist/chunk-V22DZIXO.js.map +1 -0
- package/dist/chunk-VE6DFSKU.js +107 -0
- package/dist/chunk-VE6DFSKU.js.map +1 -0
- package/dist/chunk-VPK6PHIE.cjs +211 -0
- package/dist/chunk-VPK6PHIE.cjs.map +1 -0
- package/dist/chunk-VTYY7XL5.cjs +15 -0
- package/dist/chunk-VTYY7XL5.cjs.map +1 -0
- package/dist/chunk-VWUXIVEI.js +583 -0
- package/dist/chunk-VWUXIVEI.js.map +1 -0
- package/dist/chunk-WE22OXQA.js +48 -0
- package/dist/chunk-WE22OXQA.js.map +1 -0
- package/dist/chunk-WMWEI3NS.js +120 -0
- package/dist/chunk-WMWEI3NS.js.map +1 -0
- package/dist/chunk-WS5ULCL4.js +204 -0
- package/dist/chunk-WS5ULCL4.js.map +1 -0
- package/dist/chunk-XB4GI5RZ.js +115 -0
- package/dist/chunk-XB4GI5RZ.js.map +1 -0
- package/dist/chunk-XU6MLSC6.js +455 -0
- package/dist/chunk-XU6MLSC6.js.map +1 -0
- package/dist/chunk-XYFGKVZ7.js +15 -0
- package/dist/chunk-XYFGKVZ7.js.map +1 -0
- package/dist/chunk-Y2KYR2ED.cjs +118 -0
- package/dist/chunk-Y2KYR2ED.cjs.map +1 -0
- package/dist/chunk-YIFFF23U.cjs +109 -0
- package/dist/chunk-YIFFF23U.cjs.map +1 -0
- package/dist/chunk-YJNYDJ2T.cjs +27 -0
- package/dist/chunk-YJNYDJ2T.cjs.map +1 -0
- package/dist/chunk-YSTXFWQE.cjs +127 -0
- package/dist/chunk-YSTXFWQE.cjs.map +1 -0
- package/dist/chunk-Z2JFX372.cjs +595 -0
- package/dist/chunk-Z2JFX372.cjs.map +1 -0
- package/dist/chunk-Z3NTRKIC.cjs +111 -0
- package/dist/chunk-Z3NTRKIC.cjs.map +1 -0
- package/dist/chunk-ZF2LDKQQ.cjs +20 -0
- package/dist/chunk-ZF2LDKQQ.cjs.map +1 -0
- package/dist/client/index.cjs +73 -0
- package/dist/client/index.cjs.map +1 -0
- package/dist/client/index.d.cts +12 -0
- package/dist/client/index.d.ts +12 -0
- package/dist/client/index.js +71 -0
- package/dist/client/index.js.map +1 -0
- package/dist/client/theokit-client.d.cts +60 -0
- package/dist/client/theokit-client.d.ts +60 -0
- package/dist/client/types.d.cts +51 -0
- package/dist/client/types.d.ts +51 -0
- package/dist/compact-session-BHTPCIHA.cjs +61 -0
- package/dist/compact-session-BHTPCIHA.cjs.map +1 -0
- package/dist/compact-session-W4WLJTHA.js +24 -0
- package/dist/compact-session-W4WLJTHA.js.map +1 -0
- package/dist/compaction.cjs +66 -0
- package/dist/compaction.cjs.map +1 -0
- package/dist/compaction.d.cts +240 -0
- package/dist/compaction.d.ts +240 -0
- package/dist/compaction.js +5 -0
- package/dist/compaction.js.map +1 -0
- package/dist/concurrency.cjs +23 -0
- package/dist/concurrency.cjs.map +1 -0
- package/dist/concurrency.d.cts +22 -0
- package/dist/concurrency.d.ts +22 -0
- package/dist/concurrency.js +17 -0
- package/dist/concurrency.js.map +1 -0
- package/dist/context/index.cjs +37 -0
- package/dist/context/index.cjs.map +1 -0
- package/dist/context/index.d.cts +78 -0
- package/dist/context/index.d.ts +78 -0
- package/dist/context/index.js +20 -0
- package/dist/context/index.js.map +1 -0
- package/dist/context-4QOEWRDF.cjs +23 -0
- package/dist/context-4QOEWRDF.cjs.map +1 -0
- package/dist/context-Z3CFTT3H.js +6 -0
- package/dist/context-Z3CFTT3H.js.map +1 -0
- package/dist/create-skill.d.ts +40 -0
- package/dist/cron-C3PhZED0.d.cts +246 -0
- package/dist/cron-crfMMdAw.d.ts +246 -0
- package/dist/cron.cjs +68 -0
- package/dist/cron.cjs.map +1 -0
- package/dist/cron.d.cts +7 -0
- package/dist/cron.d.ts +7 -0
- package/dist/cron.js +59 -0
- package/dist/cron.js.map +1 -0
- package/dist/define-tool.d.ts +86 -0
- package/dist/errors-CLOAyuiv.d.ts +569 -0
- package/dist/errors-DrDEgyz1.d.cts +569 -0
- package/dist/errors-base-B5g01neU.d.cts +75 -0
- package/dist/errors-base-B5g01neU.d.ts +75 -0
- package/dist/errors-base.d.ts +73 -0
- package/dist/errors.cjs +89 -0
- package/dist/errors.cjs.map +1 -0
- package/dist/errors.d.cts +4 -0
- package/dist/errors.d.ts +4 -0
- package/dist/errors.js +4 -0
- package/dist/errors.js.map +1 -0
- package/dist/eval.cjs +1056 -0
- package/dist/eval.cjs.map +1 -0
- package/dist/eval.d.cts +77 -0
- package/dist/eval.d.ts +77 -0
- package/dist/eval.js +1042 -0
- package/dist/eval.js.map +1 -0
- package/dist/event-bus.d.ts +42 -0
- package/dist/executor-XQAOQOHD.cjs +993 -0
- package/dist/executor-XQAOQOHD.cjs.map +1 -0
- package/dist/executor-ZNDQDX6Q.js +989 -0
- package/dist/executor-ZNDQDX6Q.js.map +1 -0
- package/dist/filesystem/index.cjs +204 -0
- package/dist/filesystem/index.cjs.map +1 -0
- package/dist/filesystem/index.d.cts +12 -0
- package/dist/filesystem/index.d.ts +12 -0
- package/dist/filesystem/index.js +195 -0
- package/dist/filesystem/index.js.map +1 -0
- package/dist/filesystem/local-filesystem.d.cts +54 -0
- package/dist/filesystem/local-filesystem.d.ts +54 -0
- package/dist/filesystem/types.d.cts +136 -0
- package/dist/filesystem/types.d.ts +136 -0
- package/dist/fork-agent-S2EPIML7.js +61 -0
- package/dist/fork-agent-S2EPIML7.js.map +1 -0
- package/dist/fork-agent-WAEQI2DL.cjs +64 -0
- package/dist/fork-agent-WAEQI2DL.cjs.map +1 -0
- package/dist/fs-session-store-77JU46UZ.js +10 -0
- package/dist/fs-session-store-77JU46UZ.js.map +1 -0
- package/dist/fs-session-store-E4U3P56L.cjs +19 -0
- package/dist/fs-session-store-E4U3P56L.cjs.map +1 -0
- package/dist/generate-object-BXV7BZRP.js +7 -0
- package/dist/generate-object-BXV7BZRP.js.map +1 -0
- package/dist/generate-object-YBI2TDJ3.cjs +20 -0
- package/dist/generate-object-YBI2TDJ3.cjs.map +1 -0
- package/dist/generate-object.d.ts +111 -0
- package/dist/index-manager-3UNPYH34.cjs +26 -0
- package/dist/index-manager-3UNPYH34.cjs.map +1 -0
- package/dist/index-manager-W7FDMGEG.js +17 -0
- package/dist/index-manager-W7FDMGEG.js.map +1 -0
- package/dist/index.cjs +2487 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +4166 -0
- package/dist/index.d.ts +4166 -0
- package/dist/index.js +2289 -0
- package/dist/index.js.map +1 -0
- package/dist/inject-session-SUM6TDJF.js +27 -0
- package/dist/inject-session-SUM6TDJF.js.map +1 -0
- package/dist/inject-session-W6A46J3E.cjs +29 -0
- package/dist/inject-session-W6A46J3E.cjs.map +1 -0
- package/dist/interactive/index.cjs +35 -0
- package/dist/interactive/index.cjs.map +1 -0
- package/dist/interactive/index.d.cts +12 -0
- package/dist/interactive/index.d.ts +12 -0
- package/dist/interactive/index.js +30 -0
- package/dist/interactive/index.js.map +1 -0
- package/dist/interactive/types.d.cts +95 -0
- package/dist/interactive/types.d.ts +95 -0
- package/dist/internal/agent/batch.d.ts +11 -0
- package/dist/internal/agent/helpers.d.ts +1 -0
- package/dist/internal/agent-loop/budget-gate.d.ts +1 -0
- package/dist/internal/agent-loop/doom-loop-tracker.d.ts +22 -0
- package/dist/internal/agent-loop/live-events.d.ts +46 -0
- package/dist/internal/agent-loop/loop-context-init.d.ts +2 -0
- package/dist/internal/agent-loop/loop-finalize.d.ts +25 -0
- package/dist/internal/agent-loop/loop-llm-stream.d.ts +1 -0
- package/dist/internal/agent-loop/loop-thinking-steps.d.ts +28 -0
- package/dist/internal/agent-loop/loop.d.ts +7 -0
- package/dist/internal/agent-loop/message-builders.d.ts +21 -0
- package/dist/internal/agent-loop/replay-messages.d.ts +41 -0
- package/dist/internal/agent-loop/tool-dispatch.d.ts +27 -0
- package/dist/internal/agent-loop/tool-executors.d.ts +1 -0
- package/dist/internal/agent-loop/tool-result-guard.d.ts +20 -0
- package/dist/internal/agent-loop/tool-timeout.d.ts +23 -0
- package/dist/internal/agent-loop/types.d.ts +43 -0
- package/dist/internal/agent-loop/usage-and-cost.d.ts +25 -0
- package/dist/internal/auth/api-key-prefix.d.ts +23 -0
- package/dist/internal/auth/api-key-validator.d.ts +46 -0
- package/dist/internal/auth/credential-availability.d.ts +61 -0
- package/dist/internal/auth/credential-store.d.ts +77 -0
- package/dist/internal/auth/oauth-device.d.ts +54 -0
- package/dist/internal/auth/oauth-engine.d.ts +21 -0
- package/dist/internal/auth/resolve-credential.d.ts +56 -0
- package/dist/internal/auth/types.d.ts +175 -0
- package/dist/internal/base-url.d.ts +14 -0
- package/dist/internal/budget/compute-cost.d.ts +28 -0
- package/dist/internal/budget/pricing-registry.d.ts +36 -0
- package/dist/internal/budget/tracker/budget-tracker.d.ts +11 -0
- package/dist/internal/budget/tracker/budget.d.ts +34 -0
- package/dist/internal/budget/usage-accumulator.d.ts +46 -0
- package/dist/internal/cloud-agent/cloud-agent.d.ts +1 -0
- package/dist/internal/cloud-agent/cloud-config-serializer.d.ts +3 -0
- package/dist/internal/cloud-agent/cloud-run.d.ts +1 -0
- package/dist/internal/cloud-agent/cloud-tool-parity.d.ts +1 -0
- package/dist/internal/cloud-agent/index.d.ts +7 -0
- package/dist/internal/cloud-agent/real-cloud-run.d.ts +2 -0
- package/dist/internal/cloud-agent/types.d.ts +56 -0
- package/dist/internal/concurrency/abort-utils.d.ts +21 -0
- package/dist/internal/concurrency/async-local-storage.d.ts +20 -0
- package/dist/internal/concurrency/async-semaphore.d.ts +24 -0
- package/dist/internal/concurrency/delegation-depth.d.ts +27 -0
- package/dist/internal/concurrency/map-with-concurrency.d.ts +28 -0
- package/dist/internal/concurrency/subagent-credentials.d.ts +112 -0
- package/dist/internal/diagnostics.d.ts +69 -0
- package/dist/internal/emit-run-event.d.ts +16 -0
- package/dist/internal/env.d.ts +1 -0
- package/dist/internal/error-mappers/anthropic.d.ts +30 -0
- package/dist/internal/error-mappers/bedrock.d.ts +16 -0
- package/dist/internal/error-mappers/default-retriable.d.ts +1 -0
- package/dist/internal/error-mappers/ollama.d.ts +41 -0
- package/dist/internal/error-mappers/openai-compatible.d.ts +25 -0
- package/dist/internal/error-mappers/shared.d.ts +23 -0
- package/dist/internal/error-mappers/vertex.d.ts +15 -0
- package/dist/internal/eval/aggregate.d.ts +9 -0
- package/dist/internal/eval/assert.d.ts +27 -0
- package/dist/internal/eval/code-runner.d.ts +28 -0
- package/dist/internal/eval/dataset-iter.d.ts +9 -0
- package/dist/internal/eval/runner.d.ts +9 -0
- package/dist/internal/eval/single-flight.d.ts +17 -0
- package/dist/internal/eval/telemetry.d.ts +23 -0
- package/dist/internal/eval/trials.d.ts +19 -0
- package/dist/internal/global-singleton.d.ts +16 -0
- package/dist/internal/http.d.ts +1 -0
- package/dist/internal/ids.d.ts +1 -0
- package/dist/internal/judge/judge-call.d.ts +48 -0
- package/dist/internal/judge/parse-verdict.d.ts +11 -0
- package/dist/internal/llm/abort-error.d.ts +1 -0
- package/dist/internal/llm/anthropic-shared.d.ts +100 -0
- package/dist/internal/llm/anthropic.d.ts +9 -0
- package/dist/internal/llm/bedrock-anthropic.d.ts +36 -0
- package/dist/internal/llm/bedrock-token-cache.d.ts +18 -0
- package/dist/internal/llm/credential-pool-context.d.ts +11 -0
- package/dist/internal/llm/credential-pool-types.d.ts +22 -0
- package/dist/internal/llm/credential-pool.d.ts +18 -0
- package/dist/internal/llm/fallback-client.d.ts +1 -0
- package/dist/internal/llm/fault-injection.d.ts +50 -0
- package/dist/internal/llm/finish.d.ts +1 -0
- package/dist/internal/llm/hermes-tool-extract.d.ts +11 -0
- package/dist/internal/llm/model-capabilities.d.ts +40 -0
- package/dist/internal/llm/model-identifier.d.ts +58 -0
- package/dist/internal/llm/model-option.d.ts +38 -0
- package/dist/internal/llm/ollama-native.d.ts +27 -0
- package/dist/internal/llm/openai-messages.d.ts +2 -0
- package/dist/internal/llm/openai.d.ts +146 -0
- package/dist/internal/llm/pool-aware-client.d.ts +16 -0
- package/dist/internal/llm/prompt-cache-key.d.ts +1 -0
- package/dist/internal/llm/responses.d.ts +97 -0
- package/dist/internal/llm/retry.d.ts +22 -0
- package/dist/internal/llm/retrying-client.d.ts +53 -0
- package/dist/internal/llm/router.d.ts +40 -0
- package/dist/internal/llm/sse.d.ts +21 -0
- package/dist/internal/llm/stream-relay.d.ts +17 -0
- package/dist/internal/llm/tool-result-content.d.ts +40 -0
- package/dist/internal/llm/transport-error.d.ts +9 -0
- package/dist/internal/llm/types.d.ts +226 -0
- package/dist/internal/llm/vertex-anthropic.d.ts +40 -0
- package/dist/internal/llm/vertex-auth.d.ts +30 -0
- package/dist/internal/llm/vertex-gemini.d.ts +28 -0
- package/dist/internal/llm/vertex-router.d.ts +21 -0
- package/dist/internal/local-agent/index.d.ts +6 -0
- package/dist/internal/local-agent/local-agent-bootstrap.d.ts +37 -0
- package/dist/internal/local-agent/local-agent-capabilities.d.ts +38 -0
- package/dist/internal/local-agent/local-agent-dispatch.d.ts +57 -0
- package/dist/internal/local-agent/local-agent-invalidate.d.ts +1 -0
- package/dist/internal/local-agent/local-agent-lifecycle.d.ts +13 -0
- package/dist/internal/local-agent/local-agent-memory-direct.d.ts +12 -0
- package/dist/internal/local-agent/local-agent-memory-hooks.d.ts +41 -0
- package/dist/internal/local-agent/local-agent-memory-provider.d.ts +57 -0
- package/dist/internal/local-agent/local-agent-memory.d.ts +1 -0
- package/dist/internal/local-agent/local-agent-personality-extensions.d.ts +43 -0
- package/dist/internal/local-agent/local-agent-runtime-extensions.d.ts +13 -0
- package/dist/internal/local-agent/local-agent-send.d.ts +42 -0
- package/dist/internal/local-agent/local-agent-task-wrap.d.ts +11 -0
- package/dist/internal/local-agent/local-agent.d.ts +1 -0
- package/dist/internal/local-agent/local-option-keys.d.ts +2 -0
- package/dist/internal/local-agent/local-run.d.ts +1 -0
- package/dist/internal/local-agent/mcp-pool.d.ts +43 -0
- package/dist/internal/local-agent/real-local-run-mcp.d.ts +26 -0
- package/dist/internal/local-agent/real-local-run-options.d.ts +26 -0
- package/dist/internal/local-agent/real-local-run-provider.d.ts +13 -0
- package/dist/internal/local-agent/real-local-run-tools.d.ts +55 -0
- package/dist/internal/local-agent/real-local-run.d.ts +4 -0
- package/dist/internal/mcp/client.d.ts +16 -0
- package/dist/internal/mcp/handshake-timeout.d.ts +53 -0
- package/dist/internal/mcp/oauth.d.ts +19 -0
- package/dist/internal/mcp/token-storage.d.ts +52 -0
- package/dist/internal/memory/active-memory-cache.d.ts +10 -0
- package/dist/internal/memory/active-memory-types.d.ts +8 -0
- package/dist/internal/memory/active-memory.d.ts +56 -0
- package/dist/internal/memory/adapters/azure-openai-embedding.d.cts +2 -0
- package/dist/internal/memory/adapters/azure-openai-embedding.d.ts +2 -0
- package/dist/internal/memory/adapters/catalog.d.cts +1 -0
- package/dist/internal/memory/adapters/catalog.d.ts +1 -0
- package/dist/internal/memory/adapters/cohere-embedding.d.cts +2 -0
- package/dist/internal/memory/adapters/cohere-embedding.d.ts +2 -0
- package/dist/internal/memory/adapters/deepinfra-embedding.d.cts +2 -0
- package/dist/internal/memory/adapters/deepinfra-embedding.d.ts +2 -0
- package/dist/internal/memory/adapters/gemini-embedding.d.cts +2 -0
- package/dist/internal/memory/adapters/gemini-embedding.d.ts +2 -0
- package/dist/internal/memory/adapters/index.cjs +30 -0
- package/dist/internal/memory/adapters/index.cjs.map +1 -0
- package/dist/internal/memory/adapters/index.d.cts +18 -0
- package/dist/internal/memory/adapters/index.d.ts +18 -0
- package/dist/internal/memory/adapters/index.js +13 -0
- package/dist/internal/memory/adapters/index.js.map +1 -0
- package/dist/internal/memory/adapters/jina-embedding.d.cts +2 -0
- package/dist/internal/memory/adapters/jina-embedding.d.ts +2 -0
- package/dist/internal/memory/adapters/mistral-embedding.d.cts +2 -0
- package/dist/internal/memory/adapters/mistral-embedding.d.ts +2 -0
- package/dist/internal/memory/adapters/ollama-embedding.d.cts +34 -0
- package/dist/internal/memory/adapters/ollama-embedding.d.ts +34 -0
- package/dist/internal/memory/adapters/openai-compatible.d.cts +96 -0
- package/dist/internal/memory/adapters/openai-compatible.d.ts +96 -0
- package/dist/internal/memory/adapters/openai-embedding.d.cts +12 -0
- package/dist/internal/memory/adapters/openai-embedding.d.ts +12 -0
- package/dist/internal/memory/adapters/openrouter-embedding.d.cts +2 -0
- package/dist/internal/memory/adapters/openrouter-embedding.d.ts +2 -0
- package/dist/internal/memory/adapters/voyage-embedding.d.cts +2 -0
- package/dist/internal/memory/adapters/voyage-embedding.d.ts +2 -0
- package/dist/internal/memory/corpus-sync.d.ts +23 -0
- package/dist/internal/memory/dreaming/diary.d.ts +41 -0
- package/dist/internal/memory/dreaming/phases.d.ts +35 -0
- package/dist/internal/memory/dreaming/run.d.ts +10 -0
- package/dist/internal/memory/embedding-adapter.d.ts +42 -0
- package/dist/internal/memory/embedding-cache.d.ts +42 -0
- package/dist/internal/memory/escape-like-pattern.d.ts +22 -0
- package/dist/internal/memory/index-db.d.ts +67 -0
- package/dist/internal/memory/index-manager-contract.d.ts +48 -0
- package/dist/internal/memory/index-manager-dispatch.d.ts +23 -0
- package/dist/internal/memory/index-manager-helpers.d.ts +20 -0
- package/dist/internal/memory/index-manager.d.ts +44 -0
- package/dist/internal/memory/index-repository.d.ts +58 -0
- package/dist/internal/memory/index-schema.d.ts +21 -0
- package/dist/internal/memory/lance-index.d.ts +46 -0
- package/dist/internal/memory/lance-memory-adapter.d.ts +45 -0
- package/dist/internal/memory/memory-index.d.ts +67 -0
- package/dist/internal/memory/migrate-sqlite-to-lance.d.ts +58 -0
- package/dist/internal/memory/migration.d.ts +9 -0
- package/dist/internal/memory/sdk-memory-peer-loader.d.ts +74 -0
- package/dist/internal/memory/sqlite-vec-loader.d.ts +1 -0
- package/dist/internal/memory/storage/chunk-markdown.d.cts +2 -0
- package/dist/internal/memory/storage/chunk-markdown.d.ts +2 -0
- package/dist/internal/memory/storage/index.cjs +141 -0
- package/dist/internal/memory/storage/index.cjs.map +1 -0
- package/dist/internal/memory/storage/index.d.cts +28 -0
- package/dist/internal/memory/storage/index.d.ts +28 -0
- package/dist/internal/memory/storage/index.js +16 -0
- package/dist/internal/memory/storage/index.js.map +1 -0
- package/dist/internal/memory/storage/list-markdown.d.cts +1 -0
- package/dist/internal/memory/storage/list-markdown.d.ts +1 -0
- package/dist/internal/memory/storage/markdown-store.d.cts +48 -0
- package/dist/internal/memory/storage/markdown-store.d.ts +48 -0
- package/dist/internal/memory/storage/memory-file.d.cts +90 -0
- package/dist/internal/memory/storage/memory-file.d.ts +90 -0
- package/dist/internal/memory/storage/memory-root.d.cts +119 -0
- package/dist/internal/memory/storage/memory-root.d.ts +119 -0
- package/dist/internal/memory/storage/reader.d.cts +8 -0
- package/dist/internal/memory/storage/reader.d.ts +8 -0
- package/dist/internal/memory/storage/session-loader.d.cts +35 -0
- package/dist/internal/memory/storage/session-loader.d.ts +35 -0
- package/dist/internal/memory/storage/session-summary-writer.d.cts +50 -0
- package/dist/internal/memory/storage/session-summary-writer.d.ts +50 -0
- package/dist/internal/memory/storage/threat-scan.d.cts +62 -0
- package/dist/internal/memory/storage/threat-scan.d.ts +62 -0
- package/dist/internal/memory/storage/transcript-store.d.cts +38 -0
- package/dist/internal/memory/storage/transcript-store.d.ts +38 -0
- package/dist/internal/memory/storage/wiki-loader.d.cts +27 -0
- package/dist/internal/memory/storage/wiki-loader.d.ts +27 -0
- package/dist/internal/memory/tools.d.ts +21 -0
- package/dist/internal/memory/types.d.ts +78 -0
- package/dist/internal/memory/vec-index.d.ts +28 -0
- package/dist/internal/persistence/atomic-write.d.cts +107 -0
- package/dist/internal/persistence/atomic-write.d.ts +107 -0
- package/dist/internal/persistence/cwd-mutex.d.cts +35 -0
- package/dist/internal/persistence/cwd-mutex.d.ts +35 -0
- package/dist/internal/persistence/exclusive-create.d.cts +53 -0
- package/dist/internal/persistence/exclusive-create.d.ts +53 -0
- package/dist/internal/persistence/file-lock.d.cts +54 -0
- package/dist/internal/persistence/file-lock.d.ts +54 -0
- package/dist/internal/persistence/fs-session-store.d.cts +68 -0
- package/dist/internal/persistence/fs-session-store.d.ts +68 -0
- package/dist/internal/persistence/fts5-sanitize.d.cts +44 -0
- package/dist/internal/persistence/fts5-sanitize.d.ts +44 -0
- package/dist/internal/persistence/index.cjs +127 -0
- package/dist/internal/persistence/index.cjs.map +1 -0
- package/dist/internal/persistence/index.d.cts +33 -0
- package/dist/internal/persistence/index.d.ts +33 -0
- package/dist/internal/persistence/index.js +40 -0
- package/dist/internal/persistence/index.js.map +1 -0
- package/dist/internal/persistence/jsonl.d.cts +43 -0
- package/dist/internal/persistence/jsonl.d.ts +43 -0
- package/dist/internal/persistence/markdown-config-loader.d.cts +35 -0
- package/dist/internal/persistence/markdown-config-loader.d.ts +35 -0
- package/dist/internal/persistence/pagination.d.cts +21 -0
- package/dist/internal/persistence/pagination.d.ts +21 -0
- package/dist/internal/persistence/paths.d.cts +137 -0
- package/dist/internal/persistence/paths.d.ts +137 -0
- package/dist/internal/persistence/persistence-schema.d.cts +29 -0
- package/dist/internal/persistence/persistence-schema.d.ts +29 -0
- package/dist/internal/persistence/schema-version.d.cts +227 -0
- package/dist/internal/persistence/schema-version.d.ts +227 -0
- package/dist/internal/persistence/session-artifacts.d.cts +27 -0
- package/dist/internal/persistence/session-artifacts.d.ts +27 -0
- package/dist/internal/persistence/session-dir.d.cts +1 -0
- package/dist/internal/persistence/session-dir.d.ts +1 -0
- package/dist/internal/persistence/session-transcript.d.cts +128 -0
- package/dist/internal/persistence/session-transcript.d.ts +128 -0
- package/dist/internal/persistence/session-writer.d.cts +104 -0
- package/dist/internal/persistence/session-writer.d.ts +104 -0
- package/dist/internal/persistence/sqlite-cas.d.cts +61 -0
- package/dist/internal/persistence/sqlite-cas.d.ts +61 -0
- package/dist/internal/persistence/sqlite-open.d.cts +61 -0
- package/dist/internal/persistence/sqlite-open.d.ts +61 -0
- package/dist/internal/persistence/sqlite-wal.d.cts +54 -0
- package/dist/internal/persistence/sqlite-wal.d.ts +54 -0
- package/dist/internal/persistence/transcript-ops.d.cts +99 -0
- package/dist/internal/persistence/transcript-ops.d.ts +99 -0
- package/dist/internal/personality/context.d.ts +17 -0
- package/dist/internal/personality/registry.d.ts +17 -0
- package/dist/internal/personality/store.d.ts +27 -0
- package/dist/internal/personality/switch.d.ts +36 -0
- package/dist/internal/personality/types.d.ts +18 -0
- package/dist/internal/plugins/context.d.cts +21 -0
- package/dist/internal/plugins/context.d.ts +21 -0
- package/dist/internal/plugins/enabled-names.d.cts +1 -0
- package/dist/internal/plugins/enabled-names.d.ts +1 -0
- package/dist/internal/plugins/index.d.cts +9 -0
- package/dist/internal/plugins/index.d.ts +9 -0
- package/dist/internal/plugins/lifecycle.d.cts +15 -0
- package/dist/internal/plugins/lifecycle.d.ts +15 -0
- package/dist/internal/plugins/manager.d.cts +57 -0
- package/dist/internal/plugins/manager.d.ts +57 -0
- package/dist/internal/plugins/plugin-guards.d.cts +13 -0
- package/dist/internal/plugins/plugin-guards.d.ts +13 -0
- package/dist/internal/plugins/types.d.cts +26 -0
- package/dist/internal/plugins/types.d.ts +26 -0
- package/dist/internal/providers/builtin/anthropic.d.ts +2 -0
- package/dist/internal/providers/builtin/bedrock.d.ts +25 -0
- package/dist/internal/providers/builtin/cerebras.d.ts +5 -0
- package/dist/internal/providers/builtin/cohere.d.ts +8 -0
- package/dist/internal/providers/builtin/deepinfra.d.ts +2 -0
- package/dist/internal/providers/builtin/gemini.d.ts +10 -0
- package/dist/internal/providers/builtin/google.d.ts +6 -0
- package/dist/internal/providers/builtin/groq.d.ts +2 -0
- package/dist/internal/providers/builtin/index.d.ts +20 -0
- package/dist/internal/providers/builtin/llamacpp.d.ts +1 -0
- package/dist/internal/providers/builtin/lmstudio.d.ts +1 -0
- package/dist/internal/providers/builtin/mistral.d.ts +2 -0
- package/dist/internal/providers/builtin/ollama.d.ts +17 -0
- package/dist/internal/providers/builtin/openai-chatgpt.d.ts +14 -0
- package/dist/internal/providers/builtin/openai-compatible.d.ts +1 -0
- package/dist/internal/providers/builtin/openai.d.ts +2 -0
- package/dist/internal/providers/builtin/openrouter.d.ts +2 -0
- package/dist/internal/providers/builtin/perplexity.d.ts +5 -0
- package/dist/internal/providers/builtin/together.d.ts +2 -0
- package/dist/internal/providers/builtin/vertex.d.ts +27 -0
- package/dist/internal/providers/builtin/xai.d.ts +2 -0
- package/dist/internal/providers/catalog-loader.d.ts +55 -0
- package/dist/internal/providers/catalog-schema.d.ts +202 -0
- package/dist/internal/providers/catalog-source-models-dev.d.ts +80 -0
- package/dist/internal/providers/discovery.d.ts +14 -0
- package/dist/internal/providers/index.d.ts +8 -0
- package/dist/internal/providers/register-plugin-providers.d.ts +22 -0
- package/dist/internal/providers/registry.d.ts +13 -0
- package/dist/internal/providers/types.d.ts +11 -0
- package/dist/internal/retry/circuit-breaker.d.ts +26 -0
- package/dist/internal/retry/with-retry.d.ts +40 -0
- package/dist/internal/runtime/compat/compat-config-file.d.ts +31 -0
- package/dist/internal/runtime/compat/foreign-config-sources.d.ts +139 -0
- package/dist/internal/runtime/compression/compression-attempt.d.ts +24 -0
- package/dist/internal/runtime/compression/compression-config.d.ts +33 -0
- package/dist/internal/runtime/compression/compression-decision.d.ts +10 -0
- package/dist/internal/runtime/compression/compression-helpers.d.ts +18 -0
- package/dist/internal/runtime/compression/compression-model-registry.d.ts +41 -0
- package/dist/internal/runtime/compression/compression-summarizer.d.ts +34 -0
- package/dist/internal/runtime/config/default-model.d.ts +1 -0
- package/dist/internal/runtime/config/providers-manager.d.ts +1 -0
- package/dist/internal/runtime/config/workspace-dir.d.ts +9 -0
- package/dist/internal/runtime/context/context-aggregator.d.ts +26 -0
- package/dist/internal/runtime/context/context-discovery-runner.d.ts +80 -0
- package/dist/internal/runtime/context/context-discovery.d.ts +79 -0
- package/dist/internal/runtime/context/context-frontmatter.d.ts +16 -0
- package/dist/internal/runtime/context/context-glob.d.ts +1 -0
- package/dist/internal/runtime/context/context-import-resolver.d.ts +41 -0
- package/dist/internal/runtime/context/context-loaders.d.ts +42 -0
- package/dist/internal/runtime/context/context-manager.d.ts +28 -0
- package/dist/internal/runtime/context/context-mdc-parser.d.ts +25 -0
- package/dist/internal/runtime/context/context-rules-frontmatter.d.ts +99 -0
- package/dist/internal/runtime/context/context-yaml-lite.d.ts +26 -0
- package/dist/internal/runtime/context/project-instructions.d.ts +66 -0
- package/dist/internal/runtime/context/yaml-frontmatter.d.ts +20 -0
- package/dist/internal/runtime/fixtures/fixture-events.d.ts +12 -0
- package/dist/internal/runtime/fixtures/fixture-mode.d.ts +24 -0
- package/dist/internal/runtime/fixtures/fixture-responder.d.ts +1 -0
- package/dist/internal/runtime/fixtures/fixture-run-base.d.ts +96 -0
- package/dist/internal/runtime/fixtures/fixture-scripts.d.ts +21 -0
- package/dist/internal/runtime/fixtures/types.d.ts +1 -0
- package/dist/internal/runtime/hooks/hooks-executor.d.ts +49 -0
- package/dist/internal/runtime/hooks/hooks-source.d.ts +35 -0
- package/dist/internal/runtime/lifecycle/context-budget-event.d.ts +25 -0
- package/dist/internal/runtime/lifecycle/env-policy.d.ts +29 -0
- package/dist/internal/runtime/lifecycle/fork-agent.d.ts +15 -0
- package/dist/internal/runtime/lifecycle/goal-marker.d.ts +13 -0
- package/dist/internal/runtime/lifecycle/post-run-lifecycle.d.ts +16 -0
- package/dist/internal/runtime/lifecycle/run-to-completion.d.ts +22 -0
- package/dist/internal/runtime/lifecycle/run-until.d.ts +21 -0
- package/dist/internal/runtime/lifecycle/spawn-collect.d.ts +8 -0
- package/dist/internal/runtime/lifecycle/stream-to-completion.d.ts +31 -0
- package/dist/internal/runtime/lifecycle/wrap-completion-check-run.d.ts +30 -0
- package/dist/internal/runtime/memory-glue/memory-provider.d.ts +11 -0
- package/dist/internal/runtime/memory-glue/memory-store.d.ts +4 -0
- package/dist/internal/runtime/memory-glue/select-facts.d.ts +63 -0
- package/dist/internal/runtime/model-selection.d.ts +14 -0
- package/dist/internal/runtime/plugin-loader/plugin-bundles.d.ts +22 -0
- package/dist/internal/runtime/plugin-loader/plugin-frontmatter.d.ts +17 -0
- package/dist/internal/runtime/plugin-loader/plugins-manager.d.ts +1 -0
- package/dist/internal/runtime/processors/run-processors.d.ts +10 -0
- package/dist/internal/runtime/processors/tripwire-run.d.ts +16 -0
- package/dist/internal/runtime/processors/wrap-output-run.d.ts +18 -0
- package/dist/internal/runtime/registry/agent-factory-registry.d.ts +19 -0
- package/dist/internal/runtime/registry/agent-registry-contract.d.ts +31 -0
- package/dist/internal/runtime/registry/agent-registry-store.d.ts +75 -0
- package/dist/internal/runtime/registry/agent-registry.d.ts +6 -0
- package/dist/internal/runtime/registry/live-agent-registry.d.ts +132 -0
- package/dist/internal/runtime/registry/run-registry.d.ts +4 -0
- package/dist/internal/runtime/skills/discover-skills.d.ts +103 -0
- package/dist/internal/runtime/skills/skill-frontmatter.d.ts +6 -0
- package/dist/internal/runtime/skills/skills-block.d.ts +18 -0
- package/dist/internal/runtime/skills/skills-manager.d.ts +1 -0
- package/dist/internal/runtime/skills/subagent-tool-scope.d.ts +25 -0
- package/dist/internal/runtime/skills/subagents-loader.d.ts +1 -0
- package/dist/internal/runtime/system-prompt/escape.d.ts +1 -0
- package/dist/internal/runtime/system-prompt/local-assembly.d.ts +2 -0
- package/dist/internal/runtime/system-prompt/native-reasoning.d.ts +25 -0
- package/dist/internal/runtime/system-prompt/pipeline.d.ts +1 -0
- package/dist/internal/runtime/system-prompt/safe-call.d.ts +1 -0
- package/dist/internal/runtime/system-prompt/sources/active-memory-provider.d.ts +1 -0
- package/dist/internal/runtime/system-prompt/sources/base-provider.d.ts +1 -0
- package/dist/internal/runtime/system-prompt/sources/context-provider.d.ts +1 -0
- package/dist/internal/runtime/system-prompt/sources/memory-provider.d.ts +6 -0
- package/dist/internal/runtime/system-prompt/sources/reasoning-provider.d.ts +1 -0
- package/dist/internal/runtime/system-prompt/sources/skills-provider.d.ts +1 -0
- package/dist/internal/runtime/system-prompt/system-prompt.d.ts +1 -0
- package/dist/internal/runtime/system-prompt/types.d.ts +5 -0
- package/dist/internal/runtime/tools/shell-tool.d.ts +7 -0
- package/dist/internal/runtime/validation/validate-agent-options.d.ts +1 -0
- package/dist/internal/runtime/validation/validate-response.d.ts +18 -0
- package/dist/internal/scorers/levenshtein.d.ts +11 -0
- package/dist/internal/scorers/llm-judge.d.ts +41 -0
- package/dist/internal/security/index.cjs +52 -0
- package/dist/internal/security/index.cjs.map +1 -0
- package/dist/internal/security/index.d.cts +19 -0
- package/dist/internal/security/index.d.ts +19 -0
- package/dist/internal/security/index.js +7 -0
- package/dist/internal/security/index.js.map +1 -0
- package/dist/internal/security/path-containment.d.cts +24 -0
- package/dist/internal/security/path-containment.d.ts +24 -0
- package/dist/internal/security/path-guard.d.cts +166 -0
- package/dist/internal/security/path-guard.d.ts +166 -0
- package/dist/internal/security/redact.d.cts +74 -0
- package/dist/internal/security/redact.d.ts +74 -0
- package/dist/internal/security/test-reset.d.cts +10 -0
- package/dist/internal/security/test-reset.d.ts +10 -0
- package/dist/internal/session/agent-session-store.d.ts +65 -0
- package/dist/internal/session/agent-session.d.ts +48 -0
- package/dist/internal/session/compact-session.d.ts +97 -0
- package/dist/internal/session/index.d.ts +7 -0
- package/dist/internal/session/inject-session.d.ts +15 -0
- package/dist/internal/session/session-cache.d.ts +31 -0
- package/dist/internal/session/types.d.ts +46 -0
- package/dist/internal/structured-output-helpers.d.ts +54 -0
- package/dist/internal/task/registry.d.ts +60 -0
- package/dist/internal/task/ring-buffer.d.ts +10 -0
- package/dist/internal/task/store.d.ts +145 -0
- package/dist/internal/task/subscribe.d.ts +15 -0
- package/dist/internal/task/task-id.d.ts +22 -0
- package/dist/internal/task/task-run-event-bridge.d.ts +10 -0
- package/dist/internal/task/telemetry.d.ts +27 -0
- package/dist/internal/telemetry/adapter-registry.d.ts +12 -0
- package/dist/internal/telemetry/adapters/arize.d.ts +2 -0
- package/dist/internal/telemetry/adapters/braintrust.d.ts +7 -0
- package/dist/internal/telemetry/adapters/datadog.d.ts +2 -0
- package/dist/internal/telemetry/adapters/langfuse.d.ts +2 -0
- package/dist/internal/telemetry/adapters/langsmith.d.ts +7 -0
- package/dist/internal/telemetry/adapters/posthog.d.ts +2 -0
- package/dist/internal/telemetry/adapters/sentry.d.ts +2 -0
- package/dist/internal/telemetry/safe-require.d.ts +1 -0
- package/dist/internal/telemetry/span-names.d.ts +10 -0
- package/dist/internal/telemetry/tracer-loader.d.ts +20 -0
- package/dist/internal/telemetry/tracer.d.ts +57 -0
- package/dist/internal/tool-dispatch/repair-middleware.d.ts +34 -0
- package/dist/internal/tool-dispatch/strip-think.d.ts +22 -0
- package/dist/internal/tool-registry/personality-filter.d.ts +37 -0
- package/dist/internal/workflow/ctx.d.ts +24 -0
- package/dist/internal/workflow/error-shape.d.ts +7 -0
- package/dist/internal/workflow/event-stream.d.ts +13 -0
- package/dist/internal/workflow/evented-executor.d.ts +42 -0
- package/dist/internal/workflow/executor-helpers.d.ts +30 -0
- package/dist/internal/workflow/executor.d.ts +16 -0
- package/dist/internal/workflow/retry-policy.d.ts +14 -0
- package/dist/internal/workflow/run-id.d.ts +9 -0
- package/dist/internal/workflow/scheduler.d.ts +23 -0
- package/dist/internal/workflow/single-flight.d.ts +18 -0
- package/dist/internal/workflow/snapshot-store.d.ts +23 -0
- package/dist/internal/workflow/step-agent.d.ts +12 -0
- package/dist/internal/workflow/step-branch.d.ts +10 -0
- package/dist/internal/workflow/step-dowhile.d.ts +8 -0
- package/dist/internal/workflow/step-execution.d.ts +25 -0
- package/dist/internal/workflow/step-fn.d.ts +10 -0
- package/dist/internal/workflow/step-foreach.d.ts +11 -0
- package/dist/internal/workflow/step-parallel.d.ts +17 -0
- package/dist/internal/workflow/step-sleep.d.ts +7 -0
- package/dist/internal/workflow/telemetry.d.ts +21 -0
- package/dist/internal/zod-to-json-schema.d.ts +11 -0
- package/dist/job-queue.d.ts +68 -0
- package/dist/judge-call-46M2E5FA.cjs +22 -0
- package/dist/judge-call-46M2E5FA.cjs.map +1 -0
- package/dist/judge-call-FGUNNWEI.js +5 -0
- package/dist/judge-call-FGUNNWEI.js.map +1 -0
- package/dist/mcp-auth.cjs +314 -0
- package/dist/mcp-auth.cjs.map +1 -0
- package/dist/mcp-auth.d.cts +19 -0
- package/dist/mcp-auth.d.ts +19 -0
- package/dist/mcp-auth.js +307 -0
- package/dist/mcp-auth.js.map +1 -0
- package/dist/messages.cjs +24 -0
- package/dist/messages.cjs.map +1 -0
- package/dist/messages.d.cts +33 -0
- package/dist/messages.d.ts +33 -0
- package/dist/messages.js +20 -0
- package/dist/messages.js.map +1 -0
- package/dist/models.cjs +295 -0
- package/dist/models.cjs.map +1 -0
- package/dist/models.d.cts +18 -0
- package/dist/models.d.ts +18 -0
- package/dist/models.js +286 -0
- package/dist/models.js.map +1 -0
- package/dist/oauth-transaction-store-5RIR6D5C.js +5 -0
- package/dist/oauth-transaction-store-5RIR6D5C.js.map +1 -0
- package/dist/oauth-transaction-store-SXIE57OD.cjs +38 -0
- package/dist/oauth-transaction-store-SXIE57OD.cjs.map +1 -0
- package/dist/path-safety.cjs +39 -0
- package/dist/path-safety.cjs.map +1 -0
- package/dist/path-safety.d.cts +16 -0
- package/dist/path-safety.d.ts +16 -0
- package/dist/path-safety.js +6 -0
- package/dist/path-safety.js.map +1 -0
- package/dist/permission-engine.d.ts +134 -0
- package/dist/persistence.cjs +197 -0
- package/dist/persistence.cjs.map +1 -0
- package/dist/persistence.d.cts +40 -0
- package/dist/persistence.d.ts +40 -0
- package/dist/persistence.js +100 -0
- package/dist/persistence.js.map +1 -0
- package/dist/project.cjs +45 -0
- package/dist/project.cjs.map +1 -0
- package/dist/project.d.cts +14 -0
- package/dist/project.d.ts +14 -0
- package/dist/project.js +42 -0
- package/dist/project.js.map +1 -0
- package/dist/provider-catalog.json +1295 -0
- package/dist/providers.cjs +23 -0
- package/dist/providers.cjs.map +1 -0
- package/dist/providers.d.cts +31 -0
- package/dist/providers.d.ts +31 -0
- package/dist/providers.js +10 -0
- package/dist/providers.js.map +1 -0
- package/dist/registry-BZQFYRTL.cjs +46 -0
- package/dist/registry-BZQFYRTL.cjs.map +1 -0
- package/dist/registry-DMWCJKRF.js +9 -0
- package/dist/registry-DMWCJKRF.js.map +1 -0
- package/dist/retry.cjs +14 -0
- package/dist/retry.cjs.map +1 -0
- package/dist/retry.d.cts +35 -0
- package/dist/retry.d.ts +35 -0
- package/dist/retry.js +5 -0
- package/dist/retry.js.map +1 -0
- package/dist/run-CTAdRU3U.d.cts +1813 -0
- package/dist/run-CTAdRU3U.d.ts +1813 -0
- package/dist/run-to-completion-DRO77625.js +3 -0
- package/dist/run-to-completion-DRO77625.js.map +1 -0
- package/dist/run-to-completion-X4OWM673.cjs +48 -0
- package/dist/run-to-completion-X4OWM673.cjs.map +1 -0
- package/dist/run-until-6D6TQ4JN.js +146 -0
- package/dist/run-until-6D6TQ4JN.js.map +1 -0
- package/dist/run-until-DG2KXWB2.cjs +149 -0
- package/dist/run-until-DG2KXWB2.cjs.map +1 -0
- package/dist/sandbox/bwrap.d.cts +112 -0
- package/dist/sandbox/bwrap.d.ts +112 -0
- package/dist/sandbox/index.cjs +495 -0
- package/dist/sandbox/index.cjs.map +1 -0
- package/dist/sandbox/index.d.cts +13 -0
- package/dist/sandbox/index.d.ts +13 -0
- package/dist/sandbox/index.js +451 -0
- package/dist/sandbox/index.js.map +1 -0
- package/dist/sandbox/linux-sandbox.d.cts +218 -0
- package/dist/sandbox/linux-sandbox.d.ts +218 -0
- package/dist/sandbox/local-sandbox.d.cts +66 -0
- package/dist/sandbox/local-sandbox.d.ts +66 -0
- package/dist/sandbox/provision.d.cts +60 -0
- package/dist/sandbox/provision.d.ts +60 -0
- package/dist/sandbox/seccomp.d.cts +16 -0
- package/dist/sandbox/seccomp.d.ts +16 -0
- package/dist/sandbox/shell-escape.d.cts +8 -0
- package/dist/sandbox/shell-escape.d.ts +8 -0
- package/dist/sandbox/types.d.cts +143 -0
- package/dist/sandbox/types.d.ts +143 -0
- package/dist/sanitize/coerce.d.cts +1 -0
- package/dist/sanitize/coerce.d.ts +1 -0
- package/dist/sanitize/index.cjs +12 -0
- package/dist/sanitize/index.cjs.map +1 -0
- package/dist/sanitize/index.d.cts +9 -0
- package/dist/sanitize/index.d.ts +9 -0
- package/dist/sanitize/index.js +3 -0
- package/dist/sanitize/index.js.map +1 -0
- package/dist/sanitize/sanitize-tool-input.d.cts +11 -0
- package/dist/sanitize/sanitize-tool-input.d.ts +11 -0
- package/dist/sanitize/types.d.cts +52 -0
- package/dist/sanitize/types.d.ts +52 -0
- package/dist/scorers.d.ts +181 -0
- package/dist/sdk-agent-BOiKqOgL.d.cts +940 -0
- package/dist/sdk-agent-D4a_BR_6.d.ts +940 -0
- package/dist/server/auth/errors.d.cts +54 -0
- package/dist/server/auth/errors.d.ts +54 -0
- package/dist/server/auth/index.cjs +210 -0
- package/dist/server/auth/index.cjs.map +1 -0
- package/dist/server/auth/index.d.cts +244 -0
- package/dist/server/auth/index.d.ts +244 -0
- package/dist/server/auth/index.js +189 -0
- package/dist/server/auth/index.js.map +1 -0
- package/dist/server/auth/oauth-transaction-store.d.cts +52 -0
- package/dist/server/auth/oauth-transaction-store.d.ts +52 -0
- package/dist/server/auth/orchestrator.d.cts +15 -0
- package/dist/server/auth/orchestrator.d.ts +15 -0
- package/dist/server/auth/types.d.cts +109 -0
- package/dist/server/auth/types.d.ts +109 -0
- package/dist/server/auth/validate-return-to.d.cts +27 -0
- package/dist/server/auth/validate-return-to.d.ts +27 -0
- package/dist/server/errors-envelope.cjs +101 -0
- package/dist/server/errors-envelope.cjs.map +1 -0
- package/dist/server/errors-envelope.d.cts +67 -0
- package/dist/server/errors-envelope.d.ts +67 -0
- package/dist/server/errors-envelope.js +95 -0
- package/dist/server/errors-envelope.js.map +1 -0
- package/dist/session-transcript-LGHSNVY5.cjs +62 -0
- package/dist/session-transcript-LGHSNVY5.cjs.map +1 -0
- package/dist/session-transcript-VTBTCGQX.js +5 -0
- package/dist/session-transcript-VTBTCGQX.js.map +1 -0
- package/dist/skills.cjs +25 -0
- package/dist/skills.cjs.map +1 -0
- package/dist/skills.d.cts +19 -0
- package/dist/skills.d.ts +19 -0
- package/dist/skills.js +8 -0
- package/dist/skills.js.map +1 -0
- package/dist/stream-object-HBFMIZLD.js +7 -0
- package/dist/stream-object-HBFMIZLD.js.map +1 -0
- package/dist/stream-object-QSKHISDJ.cjs +20 -0
- package/dist/stream-object-QSKHISDJ.cjs.map +1 -0
- package/dist/stream-object.d.ts +73 -0
- package/dist/stream-to-completion-QV5HCL3J.js +30 -0
- package/dist/stream-to-completion-QV5HCL3J.js.map +1 -0
- package/dist/stream-to-completion-SRISU5AB.cjs +32 -0
- package/dist/stream-to-completion-SRISU5AB.cjs.map +1 -0
- package/dist/subagents-loader-DOBTTICM.js +7 -0
- package/dist/subagents-loader-DOBTTICM.js.map +1 -0
- package/dist/subagents-loader-GEHYCMEX.cjs +16 -0
- package/dist/subagents-loader-GEHYCMEX.cjs.map +1 -0
- package/dist/subagents-loader.cjs +35 -0
- package/dist/subagents-loader.cjs.map +1 -0
- package/dist/subagents-loader.d.cts +90 -0
- package/dist/subagents-loader.d.ts +90 -0
- package/dist/subagents-loader.js +32 -0
- package/dist/subagents-loader.js.map +1 -0
- package/dist/subagents.cjs +18 -0
- package/dist/subagents.cjs.map +1 -0
- package/dist/subagents.d.cts +14 -0
- package/dist/subagents.d.ts +14 -0
- package/dist/subagents.js +15 -0
- package/dist/subagents.js.map +1 -0
- package/dist/subscription/define-subscription.d.cts +71 -0
- package/dist/subscription/define-subscription.d.ts +71 -0
- package/dist/subscription/index.cjs +408 -0
- package/dist/subscription/index.cjs.map +1 -0
- package/dist/subscription/index.d.cts +20 -0
- package/dist/subscription/index.d.ts +20 -0
- package/dist/subscription/index.js +400 -0
- package/dist/subscription/index.js.map +1 -0
- package/dist/subscription/internal/backpressure.d.cts +24 -0
- package/dist/subscription/internal/backpressure.d.ts +24 -0
- package/dist/subscription/internal/server-integration.d.cts +22 -0
- package/dist/subscription/internal/server-integration.d.ts +22 -0
- package/dist/subscription/internal/sse-encoder.d.cts +13 -0
- package/dist/subscription/internal/sse-encoder.d.ts +13 -0
- package/dist/subscription/internal/sse-parser.d.cts +15 -0
- package/dist/subscription/internal/sse-parser.d.ts +15 -0
- package/dist/subscription/internal/subscription-runtime.d.cts +21 -0
- package/dist/subscription/internal/subscription-runtime.d.ts +21 -0
- package/dist/subscription/internal/types.d.cts +11 -0
- package/dist/subscription/internal/types.d.ts +11 -0
- package/dist/subscription/internal/ws-adapter-node.d.cts +10 -0
- package/dist/subscription/internal/ws-adapter-node.d.ts +10 -0
- package/dist/subscription/theokit-subscribe.d.cts +54 -0
- package/dist/subscription/theokit-subscribe.d.ts +54 -0
- package/dist/subscription/types.d.cts +158 -0
- package/dist/subscription/types.d.ts +158 -0
- package/dist/task-errors.d.ts +58 -0
- package/dist/task-store.cjs +23 -0
- package/dist/task-store.cjs.map +1 -0
- package/dist/task-store.d.cts +10 -0
- package/dist/task-store.d.ts +10 -0
- package/dist/task-store.js +6 -0
- package/dist/task-store.js.map +1 -0
- package/dist/tool-error.d.ts +30 -0
- package/dist/types/agent-prims.d.ts +137 -0
- package/dist/types/agent.d.ts +947 -0
- package/dist/types/batch.d.ts +121 -0
- package/dist/types/budget-tracker.d.ts +80 -0
- package/dist/types/budget.d.ts +97 -0
- package/dist/types/content-blocks.d.ts +50 -0
- package/dist/types/context.d.ts +96 -0
- package/dist/types/conversation.d.ts +127 -0
- package/dist/types/cron.d.ts +172 -0
- package/dist/types/env-policy.d.ts +21 -0
- package/dist/types/eval.d.ts +255 -0
- package/dist/types/fork.d.ts +52 -0
- package/dist/types/goal-events.d.ts +144 -0
- package/dist/types/index.d.ts +19 -0
- package/dist/types/mcp.d.ts +90 -0
- package/dist/types/memory-adapter.d.ts +189 -0
- package/dist/types/memory-provider.d.ts +206 -0
- package/dist/types/messages-base.d.ts +24 -0
- package/dist/types/messages.d.ts +161 -0
- package/dist/types/plugin.d.ts +308 -0
- package/dist/types/processors.d.ts +87 -0
- package/dist/types/provider-profile.d.ts +116 -0
- package/dist/types/providers.d.ts +116 -0
- package/dist/types/run-events.d.ts +197 -0
- package/dist/types/run.d.ts +671 -0
- package/dist/types/sdk-agent.d.ts +342 -0
- package/dist/types/session-message.d.ts +62 -0
- package/dist/types/session-record.d.ts +103 -0
- package/dist/types/session-store.d.ts +104 -0
- package/dist/types/task.d.ts +146 -0
- package/dist/types/theokit.d.ts +73 -0
- package/dist/types/trajectory.d.ts +52 -0
- package/dist/types/updates.d.ts +184 -0
- package/dist/types/usage.d.ts +64 -0
- package/dist/types/workflow.d.ts +426 -0
- package/dist/workflow-as-tool.d.ts +66 -0
- package/dist/workflow-errors.d.ts +164 -0
- package/dist/workflow.cjs +100 -0
- package/dist/workflow.cjs.map +1 -0
- package/dist/workflow.d.cts +911 -0
- package/dist/workflow.d.ts +911 -0
- package/dist/workflow.js +11 -0
- package/dist/workflow.js.map +1 -0
- package/docs/adr/README.md +2604 -0
- package/docs/error-codes.md +253 -0
- package/docs/harness-capability-map.md +1435 -0
- package/docs/memory-decisions.md +265 -0
- package/package.json +455 -0
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type { MemoryRoot } from "./memory-root.js";
|
|
2
|
+
/**
|
|
3
|
+
* Optional on-disk persistence for Active Memory recall transcripts (ADR D6).
|
|
4
|
+
*
|
|
5
|
+
* Writes one JSON file per run under
|
|
6
|
+
* `.theokit/memory/transcripts/active-memory/<runId>.json` when the agent
|
|
7
|
+
* passes `persistTranscripts: true`. Failures are swallowed with a stderr
|
|
8
|
+
* warning so transcript IO never crashes the agent run.
|
|
9
|
+
*
|
|
10
|
+
* Shared with `@theokit/sdk-memory` through the semver-exempt `internal/memory-store`
|
|
11
|
+
* sub-path, so it carries no internal-visibility tag. `stripInternal` matches that tag as TEXT
|
|
12
|
+
* anywhere in the block, so naming it here — even in backticks, even to say it is absent — deletes
|
|
13
|
+
* this symbol from the published declarations and forces the satellite back onto a copy. Measured:
|
|
14
|
+
* the first draft of this very note did exactly that. See #430 and #463.
|
|
15
|
+
*/
|
|
16
|
+
export interface ActiveMemoryTranscript {
|
|
17
|
+
runId: string;
|
|
18
|
+
startedAtMs: number;
|
|
19
|
+
userText: string;
|
|
20
|
+
queryMode: string;
|
|
21
|
+
status: string;
|
|
22
|
+
durationMs: number;
|
|
23
|
+
summary: string | undefined;
|
|
24
|
+
hits: ReadonlyArray<{
|
|
25
|
+
path: string;
|
|
26
|
+
startLine: number;
|
|
27
|
+
endLine: number;
|
|
28
|
+
score: number;
|
|
29
|
+
snippet: string;
|
|
30
|
+
}>;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Write one active-memory recall transcript under `<memory root>/transcripts/active-memory`.
|
|
34
|
+
*
|
|
35
|
+
* Never throws. Transcript IO is observability, and observability must not break the run it merely
|
|
36
|
+
* observes — a failure is reported through the diagnostics sink and swallowed.
|
|
37
|
+
*/
|
|
38
|
+
export declare function persistActiveMemoryTranscript(root: MemoryRoot, transcript: ActiveMemoryTranscript): Promise<void>;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type { MemoryRoot } from "./memory-root.js";
|
|
2
|
+
/**
|
|
3
|
+
* Optional on-disk persistence for Active Memory recall transcripts (ADR D6).
|
|
4
|
+
*
|
|
5
|
+
* Writes one JSON file per run under
|
|
6
|
+
* `.theokit/memory/transcripts/active-memory/<runId>.json` when the agent
|
|
7
|
+
* passes `persistTranscripts: true`. Failures are swallowed with a stderr
|
|
8
|
+
* warning so transcript IO never crashes the agent run.
|
|
9
|
+
*
|
|
10
|
+
* Shared with `@theokit/sdk-memory` through the semver-exempt `internal/memory-store`
|
|
11
|
+
* sub-path, so it carries no internal-visibility tag. `stripInternal` matches that tag as TEXT
|
|
12
|
+
* anywhere in the block, so naming it here — even in backticks, even to say it is absent — deletes
|
|
13
|
+
* this symbol from the published declarations and forces the satellite back onto a copy. Measured:
|
|
14
|
+
* the first draft of this very note did exactly that. See #430 and #463.
|
|
15
|
+
*/
|
|
16
|
+
export interface ActiveMemoryTranscript {
|
|
17
|
+
runId: string;
|
|
18
|
+
startedAtMs: number;
|
|
19
|
+
userText: string;
|
|
20
|
+
queryMode: string;
|
|
21
|
+
status: string;
|
|
22
|
+
durationMs: number;
|
|
23
|
+
summary: string | undefined;
|
|
24
|
+
hits: ReadonlyArray<{
|
|
25
|
+
path: string;
|
|
26
|
+
startLine: number;
|
|
27
|
+
endLine: number;
|
|
28
|
+
score: number;
|
|
29
|
+
snippet: string;
|
|
30
|
+
}>;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Write one active-memory recall transcript under `<memory root>/transcripts/active-memory`.
|
|
34
|
+
*
|
|
35
|
+
* Never throws. Transcript IO is observability, and observability must not break the run it merely
|
|
36
|
+
* observes — a failure is reported through the diagnostics sink and swallowed.
|
|
37
|
+
*/
|
|
38
|
+
export declare function persistActiveMemoryTranscript(root: MemoryRoot, transcript: ActiveMemoryTranscript): Promise<void>;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { MemoryRoot } from "./memory-root.js";
|
|
2
|
+
/**
|
|
3
|
+
* Wiki supplement discovery (ADR Phase 10 of memory-system-peer-project-parity).
|
|
4
|
+
*
|
|
5
|
+
* Wiki files live under `.theokit/memory/wiki/*.md`. They are READ-ONLY —
|
|
6
|
+
* the SDK never writes here. Each indexed chunk carries `source="wiki"` so
|
|
7
|
+
* `memory_search { corpus: "wiki" }` and `corpus: "all"` can scope hits.
|
|
8
|
+
*
|
|
9
|
+
* Shared with `@theokit/sdk-memory` through the semver-exempt `internal/memory-store`
|
|
10
|
+
* sub-path, so it carries no internal-visibility tag. `stripInternal` matches that tag as TEXT
|
|
11
|
+
* anywhere in the block, so naming it here — even in backticks, even to say it is absent — deletes
|
|
12
|
+
* this symbol from the published declarations and forces the satellite back onto a copy. Measured:
|
|
13
|
+
* the first draft of this very note did exactly that. See #430 and #463.
|
|
14
|
+
*/
|
|
15
|
+
export interface WikiFile {
|
|
16
|
+
absolutePath: string;
|
|
17
|
+
relPath: string;
|
|
18
|
+
}
|
|
19
|
+
/** `<memory root>/wiki`. Takes the RESOLVED ROOT — see `storage/memory-root.ts` (#463). */
|
|
20
|
+
export declare function wikiDir(root: MemoryRoot): string;
|
|
21
|
+
/**
|
|
22
|
+
* Every wiki supplement under `<memory root>/wiki`, as `{ absolutePath, relPath }` records.
|
|
23
|
+
*
|
|
24
|
+
* Returns `[]` when the directory does not exist. These are read-only supplements the indexer tags
|
|
25
|
+
* with `source="wiki"`, so `memory_search({ corpus: "wiki" })` can scope to them.
|
|
26
|
+
*/
|
|
27
|
+
export declare function discoverWikiFiles(root: MemoryRoot): Promise<WikiFile[]>;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { MemoryRoot } from "./memory-root.js";
|
|
2
|
+
/**
|
|
3
|
+
* Wiki supplement discovery (ADR Phase 10 of memory-system-peer-project-parity).
|
|
4
|
+
*
|
|
5
|
+
* Wiki files live under `.theokit/memory/wiki/*.md`. They are READ-ONLY —
|
|
6
|
+
* the SDK never writes here. Each indexed chunk carries `source="wiki"` so
|
|
7
|
+
* `memory_search { corpus: "wiki" }` and `corpus: "all"` can scope hits.
|
|
8
|
+
*
|
|
9
|
+
* Shared with `@theokit/sdk-memory` through the semver-exempt `internal/memory-store`
|
|
10
|
+
* sub-path, so it carries no internal-visibility tag. `stripInternal` matches that tag as TEXT
|
|
11
|
+
* anywhere in the block, so naming it here — even in backticks, even to say it is absent — deletes
|
|
12
|
+
* this symbol from the published declarations and forces the satellite back onto a copy. Measured:
|
|
13
|
+
* the first draft of this very note did exactly that. See #430 and #463.
|
|
14
|
+
*/
|
|
15
|
+
export interface WikiFile {
|
|
16
|
+
absolutePath: string;
|
|
17
|
+
relPath: string;
|
|
18
|
+
}
|
|
19
|
+
/** `<memory root>/wiki`. Takes the RESOLVED ROOT — see `storage/memory-root.ts` (#463). */
|
|
20
|
+
export declare function wikiDir(root: MemoryRoot): string;
|
|
21
|
+
/**
|
|
22
|
+
* Every wiki supplement under `<memory root>/wiki`, as `{ absolutePath, relPath }` records.
|
|
23
|
+
*
|
|
24
|
+
* Returns `[]` when the directory does not exist. These are read-only supplements the indexer tags
|
|
25
|
+
* with `source="wiki"`, so `memory_search({ corpus: "wiki" })` can scope to them.
|
|
26
|
+
*/
|
|
27
|
+
export declare function discoverWikiFiles(root: MemoryRoot): Promise<WikiFile[]>;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { MemoryIndex } from "./memory-index.js";
|
|
2
|
+
import type { MemoryRoot } from "./storage/memory-root.js";
|
|
3
|
+
export interface MemoryTool extends MemoryToolJson {
|
|
4
|
+
execute(input: Record<string, unknown>): Promise<string>;
|
|
5
|
+
}
|
|
6
|
+
export interface MemorySearchToolOptions {
|
|
7
|
+
index: MemoryIndex;
|
|
8
|
+
/** Cap on the JSON response size (EC-10 of edge-case review). Default 16384. */
|
|
9
|
+
maxTotalChars?: number;
|
|
10
|
+
}
|
|
11
|
+
export declare function createMemorySearchTool(opts: MemorySearchToolOptions): MemoryTool;
|
|
12
|
+
export interface MemoryGetToolOptions {
|
|
13
|
+
/**
|
|
14
|
+
* The RESOLVED memory root the tool may read inside — not a cwd (#463).
|
|
15
|
+
*
|
|
16
|
+
* This guard used to derive its own root from `cwd` while `appendFact` wrote somewhere else, so
|
|
17
|
+
* a relocated memory was unreadable by the tool whose whole job is reading memory.
|
|
18
|
+
*/
|
|
19
|
+
root: MemoryRoot;
|
|
20
|
+
}
|
|
21
|
+
export declare function createMemoryGetTool(opts: MemoryGetToolOptions): MemoryTool;
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
export interface MemoryConfig {
|
|
2
|
+
enabled: boolean;
|
|
3
|
+
namespace?: string;
|
|
4
|
+
userId?: string;
|
|
5
|
+
scope?: "agent" | "user" | "team";
|
|
6
|
+
storePath?: string;
|
|
7
|
+
/**
|
|
8
|
+
* Absolute path (or `~/`-prefixed) of the memory root. Defaults to `<cwd>/.theokit/memory`.
|
|
9
|
+
* See `storage/memory-root.ts` for why a relative value is refused rather than resolved.
|
|
10
|
+
*/
|
|
11
|
+
directory?: string;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* What a fact IS, which is what decides whether it ages (#389).
|
|
15
|
+
*
|
|
16
|
+
* The four are the distinctions that matter for retention and recall: a preference stays true until
|
|
17
|
+
* the user changes their mind, a project fact goes stale when the code moves, a reference either
|
|
18
|
+
* resolves or 404s, and feedback records a correction that was given. Without them, recall ranks one
|
|
19
|
+
* undifferentiated corpus and pruning has no basis to prefer a durable fact over a transient one.
|
|
20
|
+
*
|
|
21
|
+
* A kind is never INFERRED. A wrong kind is worse than none, because it makes retention and recall
|
|
22
|
+
* confident about the wrong thing — so a fact whose author did not say stays untyped.
|
|
23
|
+
*
|
|
24
|
+
* Four, not more, and deliberately: a wider vocabulary exists to drive differentiated retention, and
|
|
25
|
+
* there is no retention here to differentiate. See `packages/sdk/docs/memory-decisions.md` § 2.
|
|
26
|
+
*/
|
|
27
|
+
export type MemoryKind = "user" | "feedback" | "project" | "reference";
|
|
28
|
+
/** The four values {@link MemoryKind} admits, for runtime validation at the storage boundary. */
|
|
29
|
+
export declare const MEMORY_KINDS: readonly MemoryKind[];
|
|
30
|
+
export interface MemoryFact {
|
|
31
|
+
text: string;
|
|
32
|
+
/**
|
|
33
|
+
* A short concept name for this memory — what the index shows in its link, and what the file is
|
|
34
|
+
* named after.
|
|
35
|
+
*
|
|
36
|
+
* Optional because the common write path has only a sentence. When absent it is derived, and the
|
|
37
|
+
* derivation is mechanical on purpose: the interop partner's names are authored by a model that
|
|
38
|
+
* knows the subject, and a heuristic will not match that. An explicit field with a fallback is
|
|
39
|
+
* honest; a fallback presented as authorship is not.
|
|
40
|
+
*/
|
|
41
|
+
title?: string;
|
|
42
|
+
/**
|
|
43
|
+
* The one-line summary the index shows after the dash and the frontmatter carries.
|
|
44
|
+
*
|
|
45
|
+
* Absent means "same as `text`", which is what a single-sentence memory should produce.
|
|
46
|
+
*/
|
|
47
|
+
description?: string;
|
|
48
|
+
/**
|
|
49
|
+
* What this fact is (#389). Absent means untyped, which is what a hand-written bullet under
|
|
50
|
+
* `## Facts` stays — those files are already on disk in consumers' repositories and the store's
|
|
51
|
+
* own header invites editing them.
|
|
52
|
+
*/
|
|
53
|
+
kind?: MemoryKind;
|
|
54
|
+
/**
|
|
55
|
+
* ISO 8601 instant this fact was last written, stamped BY THE SDK.
|
|
56
|
+
*
|
|
57
|
+
* Supplying it does nothing: a timestamp a caller can set is a timestamp that can lie about when
|
|
58
|
+
* something was learned, and the whole point is to weigh a note from this morning against one
|
|
59
|
+
* from four months ago. Absent on a fact written before this existed, or hand-added.
|
|
60
|
+
*/
|
|
61
|
+
modified?: string;
|
|
62
|
+
/**
|
|
63
|
+
* How many times this exact text has been recorded. Absent means one — uncorroborated.
|
|
64
|
+
*
|
|
65
|
+
* Gates CONFIDENCE, never presence: an uncorroborated fact is still recalled, and still
|
|
66
|
+
* reaches the model. It reaches it MARKED, so a single write cannot pass itself off as
|
|
67
|
+
* something the store has seen confirmed. Blocking it outright would break the system's
|
|
68
|
+
* central promise, which is that a fact written once is available in the next session.
|
|
69
|
+
*/
|
|
70
|
+
observations?: number;
|
|
71
|
+
}
|
|
72
|
+
export { redactSecrets } from "../security/index.js";
|
|
73
|
+
/**
|
|
74
|
+
* Resolve the legacy JSON memory path used pre-ADR-D8 (kept for migration
|
|
75
|
+
* helpers + tests). Centralized here so `migration.ts` and the legacy-aware
|
|
76
|
+
* `runtime/memory-store.ts` don't duplicate the path logic (jscpd cleanup).
|
|
77
|
+
*/
|
|
78
|
+
export declare function legacyMemoryJsonPath(cwd: string, config: MemoryConfig): string;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { EmbeddingRuntime } from "./embedding-adapter.js";
|
|
2
|
+
import type { MemoryDb } from "./index-db.js";
|
|
3
|
+
export declare const META_KEY_MODEL = "embedding.model";
|
|
4
|
+
export declare const META_KEY_DIMENSION = "embedding.dimension";
|
|
5
|
+
export interface EmbeddingIdentity {
|
|
6
|
+
providerId: string;
|
|
7
|
+
model: string;
|
|
8
|
+
dimension: number;
|
|
9
|
+
}
|
|
10
|
+
export declare function readEmbeddingIdentity(db: MemoryDb): EmbeddingIdentity | undefined;
|
|
11
|
+
export declare function writeEmbeddingIdentity(db: MemoryDb, identity: EmbeddingIdentity): void;
|
|
12
|
+
export declare function identityMatches(a: EmbeddingIdentity, b: EmbeddingIdentity): boolean;
|
|
13
|
+
export declare function dropVectorIndex(db: MemoryDb): void;
|
|
14
|
+
export declare function createVectorIndex(db: MemoryDb, dimension: number): void;
|
|
15
|
+
/** Pack a Float32Array into a Buffer suitable for sqlite-vec BLOB binding. */
|
|
16
|
+
export declare function packVector(vec: ReadonlyArray<number>): Buffer;
|
|
17
|
+
export declare function upsertEmbedding(db: MemoryDb, chunkId: number, vec: ReadonlyArray<number>): void;
|
|
18
|
+
export interface VectorHitRow {
|
|
19
|
+
chunk_id: number;
|
|
20
|
+
distance: number;
|
|
21
|
+
}
|
|
22
|
+
export declare function vectorSearch(db: MemoryDb, query: ReadonlyArray<number>, k: number): VectorHitRow[];
|
|
23
|
+
export interface EmbedAllArgs {
|
|
24
|
+
db: MemoryDb;
|
|
25
|
+
runtime: EmbeddingRuntime;
|
|
26
|
+
}
|
|
27
|
+
/** Embed every chunk that doesn't yet have a vector. */
|
|
28
|
+
export declare function embedMissingChunks(args: EmbedAllArgs): Promise<number>;
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* M107 — temp-file creation control, shared by `replaceFileAtomic`,
|
|
3
|
+
* `atomicWriteJson` and `atomicWriteText`.
|
|
4
|
+
*
|
|
5
|
+
* Both fields are OPTIONAL and the default is byte-identical to the behavior
|
|
6
|
+
* before M107. See `replaceFileAtomic` for why the mode reassertion
|
|
7
|
+
* is conditional.
|
|
8
|
+
*
|
|
9
|
+
*/
|
|
10
|
+
export interface AtomicWriteFileOptions {
|
|
11
|
+
/**
|
|
12
|
+
* Permission bits of the created file. Default: `0o600`, the previous fixed
|
|
13
|
+
* literal — filtered by the `umask`, as it always was. When provided, the mode is
|
|
14
|
+
* reasserted on the descriptor, so the `umask` cannot silently
|
|
15
|
+
* clearing bits the caller asked for.
|
|
16
|
+
*/
|
|
17
|
+
mode?: number;
|
|
18
|
+
/**
|
|
19
|
+
* Create the temp file with `wx` (exclusive creation) instead of `w`. Default:
|
|
20
|
+
* `false` — the previous flag. With `true`, a pre-existing temp file becomes
|
|
21
|
+
* `EEXIST` instead of being truncated.
|
|
22
|
+
*/
|
|
23
|
+
exclusive?: boolean;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* U-9 — the file a leftover temp was replacing, or `undefined` if this is not one of ours.
|
|
27
|
+
*
|
|
28
|
+
* A crash between the open and the rename leaves `<file>.<pid>.<hex>.tmp` behind, and nothing here
|
|
29
|
+
* collects it: this module creates temps and has no opinion about sweeping them. A consumer that
|
|
30
|
+
* wants to has to know the format — which lived only in the implementation, so one copied it out of
|
|
31
|
+
* a compiled chunk as a regex. That copy would have gone on reporting "nothing to collect" the day
|
|
32
|
+
* the format changed, which is the quietest possible way for a cleanup to stop working.
|
|
33
|
+
*
|
|
34
|
+
* Deliberately strict: the pid must be digits and the suffix exactly 16 hex characters. Matching any
|
|
35
|
+
* `.tmp` would claim editors' swap files and other tools' scratch, on a path whose purpose is
|
|
36
|
+
* deleting them.
|
|
37
|
+
*/
|
|
38
|
+
export declare function atomicWriteTempTarget(name: string): string | undefined;
|
|
39
|
+
/**
|
|
40
|
+
* Atomic file replacement: write content to a per-call unique tmp path,
|
|
41
|
+
* fsync, then rename over the target. Crash mid-write leaves either the old
|
|
42
|
+
* file intact or the new file complete — never a half-written file.
|
|
43
|
+
*
|
|
44
|
+
* The tmp suffix is `<pid>.<rand>.tmp` so parallel processes (and concurrent
|
|
45
|
+
* burst writes within one process) never collide on the same tmp path — a
|
|
46
|
+
* race that would manifest as `ENOENT` on `rename` after the rival process
|
|
47
|
+
* already moved its tmp into place.
|
|
48
|
+
*
|
|
49
|
+
* Mirrors peer-project's `replaceFileAtomic` from
|
|
50
|
+
* `reference/peer-project/packages/memory-host-sdk/src/host/fs-utils.ts` with
|
|
51
|
+
* the multi-writer robustness fix.
|
|
52
|
+
*
|
|
53
|
+
* ## M107 — `options` is optional, and the default is byte-identical
|
|
54
|
+
*
|
|
55
|
+
* The third parameter is additive: every earlier caller still compiles and
|
|
56
|
+
* writing exactly the same bytes, with the same mode, to the same path.
|
|
57
|
+
*
|
|
58
|
+
* The mode reassertion (`handle.chmod`) is **conditional on `mode !== undefined`**,
|
|
59
|
+
* and that is not cosmetic. `open`'s mode argument is filtered by the `umask`,
|
|
60
|
+
* which only CLEARS bits — measured in this codebase before the change:
|
|
61
|
+
*
|
|
62
|
+
* ```
|
|
63
|
+
* umask 0o002 -> 0o600 umask 0o022 -> 0o600 umask 0o200 -> 0o400
|
|
64
|
+
* ```
|
|
65
|
+
*
|
|
66
|
+
* An unconditional `chmod` would take the third case from `0o400` to `0o600` — a
|
|
67
|
+
* an on-disk change for every caller that asked for nothing, including external
|
|
68
|
+
* consumers. When the caller DOES ask for a mode, however, letting the `umask` decide
|
|
69
|
+
* silently is the defect this parameter exists to close; hence the reassertion.
|
|
70
|
+
*
|
|
71
|
+
* It goes on the DESCRIPTOR, before the `rename`, never after: chmod-ing the final
|
|
72
|
+
* final one would leave a window where it carries the `umask`'s mode — a known anti-pattern.
|
|
73
|
+
* The chosen shape passes the mode as an `open` argument.
|
|
74
|
+
*
|
|
75
|
+
*/
|
|
76
|
+
export declare function replaceFileAtomic(filePath: string, content: string, options?: AtomicWriteFileOptions): Promise<void>;
|
|
77
|
+
/**
|
|
78
|
+
* Options for `atomicWriteJson`.
|
|
79
|
+
*
|
|
80
|
+
*/
|
|
81
|
+
export interface AtomicWriteJsonOptions extends AtomicWriteFileOptions {
|
|
82
|
+
/** Indent passed to `JSON.stringify`. Default: 2. */
|
|
83
|
+
indent?: number;
|
|
84
|
+
/** Whether to append a trailing newline (POSIX convention). Default: true. */
|
|
85
|
+
trailingNewline?: boolean;
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Typed JSON atomic write helper.
|
|
89
|
+
*
|
|
90
|
+
* Serializes `data` to JSON, then delegates to `replaceFileAtomic`. The
|
|
91
|
+
* parent directory is auto-created (recursive `mkdir`) to make this helper
|
|
92
|
+
* safe for callers who haven't ensured the directory exists (EC-4 in the
|
|
93
|
+
* persistence-state-hardening plan).
|
|
94
|
+
*
|
|
95
|
+
* Throws `TypeError` on circular refs or `undefined` data (propagates from
|
|
96
|
+
* `JSON.stringify`).
|
|
97
|
+
*
|
|
98
|
+
*/
|
|
99
|
+
export declare function atomicWriteJson<T>(filePath: string, data: T, options?: AtomicWriteJsonOptions): Promise<void>;
|
|
100
|
+
/**
|
|
101
|
+
* Atomic text write. Same crash-safety guarantees as `replaceFileAtomic` +
|
|
102
|
+
* auto-mkdir of the parent directory. Written for `theokit-migrate-config` (T4.1, EC-2 MUST FIX) so
|
|
103
|
+
* a crash mid-migration left previous MD files intact rather than corrupting them; that CLI is no
|
|
104
|
+
* longer published, and the guarantee is the reason every other caller uses this too.
|
|
105
|
+
*
|
|
106
|
+
*/
|
|
107
|
+
export declare function atomicWriteText(filePath: string, content: string): Promise<void>;
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* M107 — temp-file creation control, shared by `replaceFileAtomic`,
|
|
3
|
+
* `atomicWriteJson` and `atomicWriteText`.
|
|
4
|
+
*
|
|
5
|
+
* Both fields are OPTIONAL and the default is byte-identical to the behavior
|
|
6
|
+
* before M107. See `replaceFileAtomic` for why the mode reassertion
|
|
7
|
+
* is conditional.
|
|
8
|
+
*
|
|
9
|
+
*/
|
|
10
|
+
export interface AtomicWriteFileOptions {
|
|
11
|
+
/**
|
|
12
|
+
* Permission bits of the created file. Default: `0o600`, the previous fixed
|
|
13
|
+
* literal — filtered by the `umask`, as it always was. When provided, the mode is
|
|
14
|
+
* reasserted on the descriptor, so the `umask` cannot silently
|
|
15
|
+
* clearing bits the caller asked for.
|
|
16
|
+
*/
|
|
17
|
+
mode?: number;
|
|
18
|
+
/**
|
|
19
|
+
* Create the temp file with `wx` (exclusive creation) instead of `w`. Default:
|
|
20
|
+
* `false` — the previous flag. With `true`, a pre-existing temp file becomes
|
|
21
|
+
* `EEXIST` instead of being truncated.
|
|
22
|
+
*/
|
|
23
|
+
exclusive?: boolean;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* U-9 — the file a leftover temp was replacing, or `undefined` if this is not one of ours.
|
|
27
|
+
*
|
|
28
|
+
* A crash between the open and the rename leaves `<file>.<pid>.<hex>.tmp` behind, and nothing here
|
|
29
|
+
* collects it: this module creates temps and has no opinion about sweeping them. A consumer that
|
|
30
|
+
* wants to has to know the format — which lived only in the implementation, so one copied it out of
|
|
31
|
+
* a compiled chunk as a regex. That copy would have gone on reporting "nothing to collect" the day
|
|
32
|
+
* the format changed, which is the quietest possible way for a cleanup to stop working.
|
|
33
|
+
*
|
|
34
|
+
* Deliberately strict: the pid must be digits and the suffix exactly 16 hex characters. Matching any
|
|
35
|
+
* `.tmp` would claim editors' swap files and other tools' scratch, on a path whose purpose is
|
|
36
|
+
* deleting them.
|
|
37
|
+
*/
|
|
38
|
+
export declare function atomicWriteTempTarget(name: string): string | undefined;
|
|
39
|
+
/**
|
|
40
|
+
* Atomic file replacement: write content to a per-call unique tmp path,
|
|
41
|
+
* fsync, then rename over the target. Crash mid-write leaves either the old
|
|
42
|
+
* file intact or the new file complete — never a half-written file.
|
|
43
|
+
*
|
|
44
|
+
* The tmp suffix is `<pid>.<rand>.tmp` so parallel processes (and concurrent
|
|
45
|
+
* burst writes within one process) never collide on the same tmp path — a
|
|
46
|
+
* race that would manifest as `ENOENT` on `rename` after the rival process
|
|
47
|
+
* already moved its tmp into place.
|
|
48
|
+
*
|
|
49
|
+
* Mirrors peer-project's `replaceFileAtomic` from
|
|
50
|
+
* `reference/peer-project/packages/memory-host-sdk/src/host/fs-utils.ts` with
|
|
51
|
+
* the multi-writer robustness fix.
|
|
52
|
+
*
|
|
53
|
+
* ## M107 — `options` is optional, and the default is byte-identical
|
|
54
|
+
*
|
|
55
|
+
* The third parameter is additive: every earlier caller still compiles and
|
|
56
|
+
* writing exactly the same bytes, with the same mode, to the same path.
|
|
57
|
+
*
|
|
58
|
+
* The mode reassertion (`handle.chmod`) is **conditional on `mode !== undefined`**,
|
|
59
|
+
* and that is not cosmetic. `open`'s mode argument is filtered by the `umask`,
|
|
60
|
+
* which only CLEARS bits — measured in this codebase before the change:
|
|
61
|
+
*
|
|
62
|
+
* ```
|
|
63
|
+
* umask 0o002 -> 0o600 umask 0o022 -> 0o600 umask 0o200 -> 0o400
|
|
64
|
+
* ```
|
|
65
|
+
*
|
|
66
|
+
* An unconditional `chmod` would take the third case from `0o400` to `0o600` — a
|
|
67
|
+
* an on-disk change for every caller that asked for nothing, including external
|
|
68
|
+
* consumers. When the caller DOES ask for a mode, however, letting the `umask` decide
|
|
69
|
+
* silently is the defect this parameter exists to close; hence the reassertion.
|
|
70
|
+
*
|
|
71
|
+
* It goes on the DESCRIPTOR, before the `rename`, never after: chmod-ing the final
|
|
72
|
+
* final one would leave a window where it carries the `umask`'s mode — a known anti-pattern.
|
|
73
|
+
* The chosen shape passes the mode as an `open` argument.
|
|
74
|
+
*
|
|
75
|
+
*/
|
|
76
|
+
export declare function replaceFileAtomic(filePath: string, content: string, options?: AtomicWriteFileOptions): Promise<void>;
|
|
77
|
+
/**
|
|
78
|
+
* Options for `atomicWriteJson`.
|
|
79
|
+
*
|
|
80
|
+
*/
|
|
81
|
+
export interface AtomicWriteJsonOptions extends AtomicWriteFileOptions {
|
|
82
|
+
/** Indent passed to `JSON.stringify`. Default: 2. */
|
|
83
|
+
indent?: number;
|
|
84
|
+
/** Whether to append a trailing newline (POSIX convention). Default: true. */
|
|
85
|
+
trailingNewline?: boolean;
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Typed JSON atomic write helper.
|
|
89
|
+
*
|
|
90
|
+
* Serializes `data` to JSON, then delegates to `replaceFileAtomic`. The
|
|
91
|
+
* parent directory is auto-created (recursive `mkdir`) to make this helper
|
|
92
|
+
* safe for callers who haven't ensured the directory exists (EC-4 in the
|
|
93
|
+
* persistence-state-hardening plan).
|
|
94
|
+
*
|
|
95
|
+
* Throws `TypeError` on circular refs or `undefined` data (propagates from
|
|
96
|
+
* `JSON.stringify`).
|
|
97
|
+
*
|
|
98
|
+
*/
|
|
99
|
+
export declare function atomicWriteJson<T>(filePath: string, data: T, options?: AtomicWriteJsonOptions): Promise<void>;
|
|
100
|
+
/**
|
|
101
|
+
* Atomic text write. Same crash-safety guarantees as `replaceFileAtomic` +
|
|
102
|
+
* auto-mkdir of the parent directory. Written for `theokit-migrate-config` (T4.1, EC-2 MUST FIX) so
|
|
103
|
+
* a crash mid-migration left previous MD files intact rather than corrupting them; that CLI is no
|
|
104
|
+
* longer published, and the guarantee is the reason every other caller uses this too.
|
|
105
|
+
*
|
|
106
|
+
*/
|
|
107
|
+
export declare function atomicWriteText(filePath: string, content: string): Promise<void>;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Run `fn` after every earlier `withCwdMutex` call for the same `key` has settled, and return
|
|
3
|
+
* what `fn` returns.
|
|
4
|
+
*
|
|
5
|
+
* Calls with the same key run strictly in the order they were made — FIFO, never concurrent.
|
|
6
|
+
* Calls with different keys never wait on each other. The key is an opaque string: two callers
|
|
7
|
+
* serialize against each other exactly when they pass equal keys, so a shared key IS the
|
|
8
|
+
* contract, and a mismatched one silently buys no protection at all.
|
|
9
|
+
*
|
|
10
|
+
* A rejection does not poison the queue. The next waiter runs whether the previous `fn` fulfilled
|
|
11
|
+
* or rejected, and the rejection is delivered only to the caller whose `fn` threw. This function
|
|
12
|
+
* neither retries nor swallows: the returned promise rejects with whatever `fn` rejected with.
|
|
13
|
+
*
|
|
14
|
+
* There is no timeout and no cancellation. An `fn` that never settles blocks that key for the
|
|
15
|
+
* lifetime of the process.
|
|
16
|
+
*
|
|
17
|
+
* **Scope — this is an in-process lock only.** State is a module-scoped Map, so it serializes
|
|
18
|
+
* callers that share one module instance and nothing else. Two processes, two worker threads, or
|
|
19
|
+
* two copies of the SDK resolved into the same tree do not see each other's queue. When the
|
|
20
|
+
* resource is a file that other processes can also write, use `withFileLock` from
|
|
21
|
+
* `./file-lock.ts` instead — it takes an OS-level lock and layers this mutex underneath, so it
|
|
22
|
+
* gives both guarantees. Reach for `withCwdMutex` directly when the shared state is in memory, or
|
|
23
|
+
* when the file is one only this process touches.
|
|
24
|
+
*
|
|
25
|
+
* Extracted packages (`@theokit/sdk-budget`, `@theokit/sdk-memory`) import this from
|
|
26
|
+
* `@theokit/sdk` rather than reimplementing it, precisely so the Map is the same one: a per-package
|
|
27
|
+
* copy would give each package its own queue and let their writes race.
|
|
28
|
+
*
|
|
29
|
+
* The Map is module-scoped, so nothing survives a process restart or a fresh module instance, and
|
|
30
|
+
* its entries are never removed — pass keys from a bounded set rather than from arbitrary input.
|
|
31
|
+
* Signature and semantics will not change before sdk-core v3.0.
|
|
32
|
+
*
|
|
33
|
+
* @public
|
|
34
|
+
*/
|
|
35
|
+
export declare function withCwdMutex<T>(key: string, fn: () => Promise<T>): Promise<T>;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Run `fn` after every earlier `withCwdMutex` call for the same `key` has settled, and return
|
|
3
|
+
* what `fn` returns.
|
|
4
|
+
*
|
|
5
|
+
* Calls with the same key run strictly in the order they were made — FIFO, never concurrent.
|
|
6
|
+
* Calls with different keys never wait on each other. The key is an opaque string: two callers
|
|
7
|
+
* serialize against each other exactly when they pass equal keys, so a shared key IS the
|
|
8
|
+
* contract, and a mismatched one silently buys no protection at all.
|
|
9
|
+
*
|
|
10
|
+
* A rejection does not poison the queue. The next waiter runs whether the previous `fn` fulfilled
|
|
11
|
+
* or rejected, and the rejection is delivered only to the caller whose `fn` threw. This function
|
|
12
|
+
* neither retries nor swallows: the returned promise rejects with whatever `fn` rejected with.
|
|
13
|
+
*
|
|
14
|
+
* There is no timeout and no cancellation. An `fn` that never settles blocks that key for the
|
|
15
|
+
* lifetime of the process.
|
|
16
|
+
*
|
|
17
|
+
* **Scope — this is an in-process lock only.** State is a module-scoped Map, so it serializes
|
|
18
|
+
* callers that share one module instance and nothing else. Two processes, two worker threads, or
|
|
19
|
+
* two copies of the SDK resolved into the same tree do not see each other's queue. When the
|
|
20
|
+
* resource is a file that other processes can also write, use `withFileLock` from
|
|
21
|
+
* `./file-lock.ts` instead — it takes an OS-level lock and layers this mutex underneath, so it
|
|
22
|
+
* gives both guarantees. Reach for `withCwdMutex` directly when the shared state is in memory, or
|
|
23
|
+
* when the file is one only this process touches.
|
|
24
|
+
*
|
|
25
|
+
* Extracted packages (`@theokit/sdk-budget`, `@theokit/sdk-memory`) import this from
|
|
26
|
+
* `@theokit/sdk` rather than reimplementing it, precisely so the Map is the same one: a per-package
|
|
27
|
+
* copy would give each package its own queue and let their writes race.
|
|
28
|
+
*
|
|
29
|
+
* The Map is module-scoped, so nothing survives a process restart or a fresh module instance, and
|
|
30
|
+
* its entries are never removed — pass keys from a bounded set rather than from arbitrary input.
|
|
31
|
+
* Signature and semantics will not change before sdk-core v3.0.
|
|
32
|
+
*
|
|
33
|
+
* @public
|
|
34
|
+
*/
|
|
35
|
+
export declare function withCwdMutex<T>(key: string, fn: () => Promise<T>): Promise<T>;
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* O_EXCL exclusive file creation (ADR D82).
|
|
3
|
+
*
|
|
4
|
+
* `createExclusive(path, data, { mode })` creates a file in a single
|
|
5
|
+
* syscall (`open(path, "wx", mode)`). Returns `true` if created, `false`
|
|
6
|
+
* if it already existed (EEXIST swallowed — caller decides). All other
|
|
7
|
+
* errors propagate.
|
|
8
|
+
*
|
|
9
|
+
* Default mode is 0o600 (owner-only) — EC-2 fix from edge-case review:
|
|
10
|
+
* token files, lockfiles, and PID files MUST NOT default to world-
|
|
11
|
+
* readable 0o644 under typical umask 022. Callers writing non-sensitive
|
|
12
|
+
* files can pass `mode: 0o644` explicitly.
|
|
13
|
+
*
|
|
14
|
+
* NFS not honoring O_EXCL is documented (D61 — same stance as
|
|
15
|
+
* `withFileLock`); the SDK target is ext4/APFS/NTFS.
|
|
16
|
+
*
|
|
17
|
+
* @internal
|
|
18
|
+
*/
|
|
19
|
+
export interface CreateExclusiveOptions {
|
|
20
|
+
/** Unix mode for the new file (default 0o600 — owner-only). */
|
|
21
|
+
mode?: number;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Create `path` holding `data`, but only if it does not exist yet. Returns `true` when this call
|
|
25
|
+
* created it, `false` when it was already there.
|
|
26
|
+
*
|
|
27
|
+
* The check and the create are one `open(path, "wx")` syscall, so of N processes racing to create
|
|
28
|
+
* the same path exactly one gets `true` — no window between testing and writing. The content is
|
|
29
|
+
* written after the create, so the `false` branch tells you the file exists, not that another
|
|
30
|
+
* writer has finished filling it.
|
|
31
|
+
*
|
|
32
|
+
* Only `EEXIST` becomes `false`. Every other error propagates: a missing parent directory is
|
|
33
|
+
* `ENOENT`, an unwritable one `EACCES`. This never creates directories.
|
|
34
|
+
*
|
|
35
|
+
* The file is created with mode 0600 unless `options.mode` says otherwise, and the mode is
|
|
36
|
+
* subject to the process umask. That default is deliberate — the callers are token files,
|
|
37
|
+
* lockfiles and PID files, and 0644 under a typical umask would make them world-readable.
|
|
38
|
+
*
|
|
39
|
+
* **Choosing between this and the locks.** `createExclusive` claims a NAME once and is the right
|
|
40
|
+
* tool for first-writer-wins: seeding a config, electing a single owner, writing a credential
|
|
41
|
+
* exactly once. It cannot guard repeated updates, because a file that already exists always loses.
|
|
42
|
+
* For read-modify-write on a path several writers touch, take a lock instead —
|
|
43
|
+
* {@link withFileLock} across processes, `withCwdMutex` when the writers are all in this one. For
|
|
44
|
+
* an in-place update guarded by a version column in SQLite, `casUpdate` is the equivalent
|
|
45
|
+
* primitive.
|
|
46
|
+
*
|
|
47
|
+
* Atomicity is the filesystem's `O_EXCL`, which NFS does not reliably honor; the SDK targets
|
|
48
|
+
* ext4, APFS and NTFS.
|
|
49
|
+
*
|
|
50
|
+
* Semver-exempt: reachable via the `@theokit/sdk/internal/persistence` sub-path, which the package
|
|
51
|
+
* declares in `exports` but does NOT cover with its semver contract.
|
|
52
|
+
*/
|
|
53
|
+
export declare function createExclusive(path: string, data: string | Uint8Array, options?: CreateExclusiveOptions): Promise<boolean>;
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* O_EXCL exclusive file creation (ADR D82).
|
|
3
|
+
*
|
|
4
|
+
* `createExclusive(path, data, { mode })` creates a file in a single
|
|
5
|
+
* syscall (`open(path, "wx", mode)`). Returns `true` if created, `false`
|
|
6
|
+
* if it already existed (EEXIST swallowed — caller decides). All other
|
|
7
|
+
* errors propagate.
|
|
8
|
+
*
|
|
9
|
+
* Default mode is 0o600 (owner-only) — EC-2 fix from edge-case review:
|
|
10
|
+
* token files, lockfiles, and PID files MUST NOT default to world-
|
|
11
|
+
* readable 0o644 under typical umask 022. Callers writing non-sensitive
|
|
12
|
+
* files can pass `mode: 0o644` explicitly.
|
|
13
|
+
*
|
|
14
|
+
* NFS not honoring O_EXCL is documented (D61 — same stance as
|
|
15
|
+
* `withFileLock`); the SDK target is ext4/APFS/NTFS.
|
|
16
|
+
*
|
|
17
|
+
* @internal
|
|
18
|
+
*/
|
|
19
|
+
export interface CreateExclusiveOptions {
|
|
20
|
+
/** Unix mode for the new file (default 0o600 — owner-only). */
|
|
21
|
+
mode?: number;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Create `path` holding `data`, but only if it does not exist yet. Returns `true` when this call
|
|
25
|
+
* created it, `false` when it was already there.
|
|
26
|
+
*
|
|
27
|
+
* The check and the create are one `open(path, "wx")` syscall, so of N processes racing to create
|
|
28
|
+
* the same path exactly one gets `true` — no window between testing and writing. The content is
|
|
29
|
+
* written after the create, so the `false` branch tells you the file exists, not that another
|
|
30
|
+
* writer has finished filling it.
|
|
31
|
+
*
|
|
32
|
+
* Only `EEXIST` becomes `false`. Every other error propagates: a missing parent directory is
|
|
33
|
+
* `ENOENT`, an unwritable one `EACCES`. This never creates directories.
|
|
34
|
+
*
|
|
35
|
+
* The file is created with mode 0600 unless `options.mode` says otherwise, and the mode is
|
|
36
|
+
* subject to the process umask. That default is deliberate — the callers are token files,
|
|
37
|
+
* lockfiles and PID files, and 0644 under a typical umask would make them world-readable.
|
|
38
|
+
*
|
|
39
|
+
* **Choosing between this and the locks.** `createExclusive` claims a NAME once and is the right
|
|
40
|
+
* tool for first-writer-wins: seeding a config, electing a single owner, writing a credential
|
|
41
|
+
* exactly once. It cannot guard repeated updates, because a file that already exists always loses.
|
|
42
|
+
* For read-modify-write on a path several writers touch, take a lock instead —
|
|
43
|
+
* {@link withFileLock} across processes, `withCwdMutex` when the writers are all in this one. For
|
|
44
|
+
* an in-place update guarded by a version column in SQLite, `casUpdate` is the equivalent
|
|
45
|
+
* primitive.
|
|
46
|
+
*
|
|
47
|
+
* Atomicity is the filesystem's `O_EXCL`, which NFS does not reliably honor; the SDK targets
|
|
48
|
+
* ext4, APFS and NTFS.
|
|
49
|
+
*
|
|
50
|
+
* Semver-exempt: reachable via the `@theokit/sdk/internal/persistence` sub-path, which the package
|
|
51
|
+
* declares in `exports` but does NOT cover with its semver contract.
|
|
52
|
+
*/
|
|
53
|
+
export declare function createExclusive(path: string, data: string | Uint8Array, options?: CreateExclusiveOptions): Promise<boolean>;
|