@abloatai/ablo 0.35.0 → 0.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (622) hide show
  1. package/AGENTS.md +2 -2
  2. package/CHANGELOG.md +71 -1929
  3. package/NOTICE +2 -2
  4. package/README.md +23 -532
  5. package/assets/banner.png +0 -0
  6. package/dist/auth.d.ts +2 -0
  7. package/dist/auth.d.ts.map +1 -0
  8. package/dist/auth.js +2 -0
  9. package/dist/auth.js.map +1 -0
  10. package/dist/client.d.ts +3 -0
  11. package/dist/client.d.ts.map +1 -0
  12. package/dist/client.js +3 -0
  13. package/dist/client.js.map +1 -0
  14. package/dist/coordination.d.ts +2 -0
  15. package/dist/coordination.d.ts.map +1 -0
  16. package/dist/coordination.js +2 -0
  17. package/dist/coordination.js.map +1 -0
  18. package/dist/index.d.ts +3 -112
  19. package/dist/index.d.ts.map +1 -0
  20. package/dist/index.js +3 -161
  21. package/dist/index.js.map +1 -0
  22. package/dist/react.d.ts +4 -0
  23. package/dist/react.d.ts.map +1 -0
  24. package/dist/react.js +3 -0
  25. package/dist/react.js.map +1 -0
  26. package/dist/schema.d.ts +2 -0
  27. package/dist/schema.d.ts.map +1 -0
  28. package/dist/schema.js +2 -0
  29. package/dist/schema.js.map +1 -0
  30. package/dist/server.d.ts +2 -0
  31. package/dist/server.d.ts.map +1 -0
  32. package/dist/server.js +2 -0
  33. package/dist/server.js.map +1 -0
  34. package/dist/source-conformance.d.ts +2 -0
  35. package/dist/source-conformance.d.ts.map +1 -0
  36. package/dist/source-conformance.js +2 -0
  37. package/dist/source-conformance.js.map +1 -0
  38. package/dist/source-drizzle.d.ts +2 -0
  39. package/dist/source-drizzle.d.ts.map +1 -0
  40. package/dist/source-drizzle.js +2 -0
  41. package/dist/source-drizzle.js.map +1 -0
  42. package/dist/source-kysely.d.ts +2 -0
  43. package/dist/source-kysely.d.ts.map +1 -0
  44. package/dist/source-kysely.js +2 -0
  45. package/dist/source-kysely.js.map +1 -0
  46. package/dist/source-next.d.ts +2 -0
  47. package/dist/source-next.d.ts.map +1 -0
  48. package/dist/source-next.js +2 -0
  49. package/dist/source-next.js.map +1 -0
  50. package/dist/source.d.ts +2 -0
  51. package/dist/source.d.ts.map +1 -0
  52. package/dist/source.js +2 -0
  53. package/dist/source.js.map +1 -0
  54. package/dist/wire.d.ts +2 -0
  55. package/dist/wire.d.ts.map +1 -0
  56. package/dist/wire.js +2 -0
  57. package/dist/wire.js.map +1 -0
  58. package/docs/agents.md +2 -2
  59. package/docs/api-keys.md +13 -12
  60. package/docs/api.md +15 -53
  61. package/docs/audit.md +4 -3
  62. package/docs/cli.md +11 -11
  63. package/docs/client-behavior.md +9 -9
  64. package/docs/concurrency-convention.md +28 -42
  65. package/docs/coordination.md +228 -86
  66. package/docs/data-sources.md +5 -5
  67. package/docs/debugging.md +34 -12
  68. package/docs/deployment.md +8 -8
  69. package/docs/examples/agent-human.md +4 -4
  70. package/docs/examples/ai-sdk-tool.md +1 -1
  71. package/docs/examples/existing-python-backend.md +15 -4
  72. package/docs/examples/nextjs.md +27 -6
  73. package/docs/examples/scoped-agent.md +3 -3
  74. package/docs/examples/server-agent.md +2 -2
  75. package/docs/groups.md +57 -3
  76. package/docs/guarantees.md +37 -10
  77. package/docs/how-it-works.md +32 -8
  78. package/docs/idempotency.md +6 -6
  79. package/docs/identity.md +24 -24
  80. package/docs/index.md +8 -8
  81. package/docs/integration-guide.md +38 -16
  82. package/docs/internal/README.md +18 -0
  83. package/docs/internal/agent-fleet-coordination-design.md +171 -0
  84. package/docs/internal/agent-orchestration.md +58 -0
  85. package/docs/internal/commit-identifiers.md +91 -0
  86. package/docs/internal/concurrency-open-decisions.md +37 -0
  87. package/docs/internal/data-source-reverse-channel.md +150 -0
  88. package/docs/internal/per-field-conflict-detection.md +165 -0
  89. package/docs/internal/postgres-replication.md +64 -0
  90. package/docs/internal/serializable-schema.md +119 -0
  91. package/docs/internal/structure.md +32 -0
  92. package/docs/mcp.md +9 -9
  93. package/docs/migration.md +37 -18
  94. package/docs/projects.md +1 -1
  95. package/docs/quickstart.md +2 -2
  96. package/docs/react.md +24 -13
  97. package/docs/schema-contract.md +3 -3
  98. package/docs/sessions.md +91 -37
  99. package/docs/webhooks.md +9 -9
  100. package/examples/README.md +2 -2
  101. package/examples/data-source/README.md +1 -1
  102. package/examples/data-source/ablo-driver.ts +1 -1
  103. package/examples/data-source/customer-server.ts +1 -1
  104. package/examples/data-source/run.ts +1 -1
  105. package/examples/data-source/schema.ts +1 -1
  106. package/examples/quickstart.ts +2 -2
  107. package/llms.txt +12 -12
  108. package/package.json +64 -174
  109. package/dist/BaseSyncedStore.d.ts +0 -823
  110. package/dist/BaseSyncedStore.js +0 -1955
  111. package/dist/Database.d.ts +0 -335
  112. package/dist/Database.js +0 -1500
  113. package/dist/InstanceCache.d.ts +0 -233
  114. package/dist/InstanceCache.js +0 -1164
  115. package/dist/LazyReferenceCollection.d.ts +0 -177
  116. package/dist/LazyReferenceCollection.js +0 -461
  117. package/dist/Model.d.ts +0 -444
  118. package/dist/Model.js +0 -909
  119. package/dist/ModelRegistry.d.ts +0 -221
  120. package/dist/ModelRegistry.js +0 -537
  121. package/dist/NetworkMonitor.d.ts +0 -26
  122. package/dist/NetworkMonitor.js +0 -77
  123. package/dist/RuntimeContext.d.ts +0 -52
  124. package/dist/RuntimeContext.js +0 -80
  125. package/dist/SyncClient.d.ts +0 -551
  126. package/dist/SyncClient.js +0 -2199
  127. package/dist/adapters/alwaysOnline.d.ts +0 -14
  128. package/dist/adapters/alwaysOnline.js +0 -17
  129. package/dist/adapters/inMemoryStorage.d.ts +0 -31
  130. package/dist/adapters/inMemoryStorage.js +0 -110
  131. package/dist/ai-sdk/coordinatedTool.d.ts +0 -120
  132. package/dist/ai-sdk/coordinatedTool.js +0 -134
  133. package/dist/ai-sdk/coordinationContext.d.ts +0 -46
  134. package/dist/ai-sdk/coordinationContext.js +0 -106
  135. package/dist/ai-sdk/index.d.ts +0 -121
  136. package/dist/ai-sdk/index.js +0 -121
  137. package/dist/ai-sdk/wrap.d.ts +0 -65
  138. package/dist/ai-sdk/wrap.js +0 -39
  139. package/dist/auth/index.d.ts +0 -1
  140. package/dist/auth/index.js +0 -8
  141. package/dist/batching/index.d.ts +0 -55
  142. package/dist/batching/index.js +0 -147
  143. package/dist/cli.cjs +0 -288600
  144. package/dist/client/Ablo.d.ts +0 -231
  145. package/dist/client/Ablo.js +0 -149
  146. package/dist/client/abloClient.d.ts +0 -309
  147. package/dist/client/abloClient.js +0 -13
  148. package/dist/client/clientPrelude.d.ts +0 -52
  149. package/dist/client/clientPrelude.js +0 -60
  150. package/dist/client/consoleLogger.d.ts +0 -35
  151. package/dist/client/consoleLogger.js +0 -44
  152. package/dist/client/coreClient.d.ts +0 -60
  153. package/dist/client/coreClient.js +0 -118
  154. package/dist/client/createInternalComponents.d.ts +0 -46
  155. package/dist/client/createInternalComponents.js +0 -92
  156. package/dist/client/createModelProxy.d.ts +0 -228
  157. package/dist/client/createModelProxy.js +0 -818
  158. package/dist/client/humans.d.ts +0 -48
  159. package/dist/client/humans.js +0 -52
  160. package/dist/client/modelRegistration.d.ts +0 -10
  161. package/dist/client/modelRegistration.js +0 -312
  162. package/dist/client/options.d.ts +0 -461
  163. package/dist/client/options.js +0 -7
  164. package/dist/client/reactiveEngine.d.ts +0 -48
  165. package/dist/client/reactiveEngine.js +0 -910
  166. package/dist/client/resourceTypes.d.ts +0 -12
  167. package/dist/client/resourceTypes.js +0 -10
  168. package/dist/client/schemaConfig.d.ts +0 -44
  169. package/dist/client/schemaConfig.js +0 -185
  170. package/dist/client/validateAbloOptions.d.ts +0 -42
  171. package/dist/client/validateAbloOptions.js +0 -43
  172. package/dist/client/wsMutationExecutor.d.ts +0 -27
  173. package/dist/client/wsMutationExecutor.js +0 -72
  174. package/dist/context.d.ts +0 -29
  175. package/dist/context.js +0 -58
  176. package/dist/coordination/ClaimLog.d.ts +0 -26
  177. package/dist/coordination/ClaimLog.js +0 -32
  178. package/dist/coordination/index.d.ts +0 -1
  179. package/dist/coordination/index.js +0 -8
  180. package/dist/core/DatabaseManager.d.ts +0 -105
  181. package/dist/core/DatabaseManager.js +0 -387
  182. package/dist/core/QueryProcessor.d.ts +0 -75
  183. package/dist/core/QueryProcessor.js +0 -255
  184. package/dist/core/QueryView.d.ts +0 -79
  185. package/dist/core/QueryView.js +0 -218
  186. package/dist/core/StoreManager.d.ts +0 -112
  187. package/dist/core/StoreManager.js +0 -302
  188. package/dist/core/ViewRegistry.d.ts +0 -20
  189. package/dist/core/ViewRegistry.js +0 -55
  190. package/dist/core/index.d.ts +0 -33
  191. package/dist/core/index.js +0 -48
  192. package/dist/core/openIDBWithTimeout.d.ts +0 -65
  193. package/dist/core/openIDBWithTimeout.js +0 -153
  194. package/dist/core/queryUtils.d.ts +0 -45
  195. package/dist/core/queryUtils.js +0 -69
  196. package/dist/core/storeContract.d.ts +0 -145
  197. package/dist/core/storeContract.js +0 -12
  198. package/dist/docs/catalog.d.ts +0 -72
  199. package/dist/docs/catalog.js +0 -227
  200. package/dist/docs/index.d.ts +0 -10
  201. package/dist/docs/index.js +0 -10
  202. package/dist/environment.d.ts +0 -1
  203. package/dist/environment.js +0 -8
  204. package/dist/interfaces/index.d.ts +0 -311
  205. package/dist/interfaces/index.js +0 -9
  206. package/dist/keys/index.d.ts +0 -1
  207. package/dist/keys/index.js +0 -8
  208. package/dist/mutators/RecordingMutation.d.ts +0 -36
  209. package/dist/mutators/RecordingMutation.js +0 -182
  210. package/dist/mutators/Transaction.d.ts +0 -40
  211. package/dist/mutators/Transaction.js +0 -58
  212. package/dist/mutators/UndoManager.d.ts +0 -258
  213. package/dist/mutators/UndoManager.js +0 -658
  214. package/dist/mutators/defineMutators.d.ts +0 -60
  215. package/dist/mutators/defineMutators.js +0 -18
  216. package/dist/mutators/inverseOp.d.ts +0 -126
  217. package/dist/mutators/inverseOp.js +0 -71
  218. package/dist/mutators/mutateActions.d.ts +0 -45
  219. package/dist/mutators/mutateActions.js +0 -105
  220. package/dist/mutators/readerActions.d.ts +0 -33
  221. package/dist/mutators/readerActions.js +0 -57
  222. package/dist/mutators/undoApply.d.ts +0 -51
  223. package/dist/mutators/undoApply.js +0 -117
  224. package/dist/policy/index.d.ts +0 -21
  225. package/dist/policy/index.js +0 -20
  226. package/dist/query/client.d.ts +0 -61
  227. package/dist/query/client.js +0 -137
  228. package/dist/query/types.d.ts +0 -85
  229. package/dist/query/types.js +0 -16
  230. package/dist/react/AbloProvider.d.ts +0 -230
  231. package/dist/react/AbloProvider.js +0 -455
  232. package/dist/react/ClientSideSuspense.d.ts +0 -36
  233. package/dist/react/ClientSideSuspense.js +0 -17
  234. package/dist/react/DefaultFallback.d.ts +0 -24
  235. package/dist/react/DefaultFallback.js +0 -43
  236. package/dist/react/context.d.ts +0 -55
  237. package/dist/react/context.js +0 -29
  238. package/dist/react/index.d.ts +0 -61
  239. package/dist/react/index.js +0 -66
  240. package/dist/react/internalContext.d.ts +0 -33
  241. package/dist/react/internalContext.js +0 -3
  242. package/dist/react/useAblo.d.ts +0 -75
  243. package/dist/react/useAblo.js +0 -102
  244. package/dist/react/useCurrentUserId.d.ts +0 -22
  245. package/dist/react/useCurrentUserId.js +0 -34
  246. package/dist/react/useErrorListener.d.ts +0 -20
  247. package/dist/react/useErrorListener.js +0 -38
  248. package/dist/react/useMutationFailureListener.d.ts +0 -26
  249. package/dist/react/useMutationFailureListener.js +0 -38
  250. package/dist/react/useMutators.d.ts +0 -56
  251. package/dist/react/useMutators.js +0 -84
  252. package/dist/react/useReactive.d.ts +0 -35
  253. package/dist/react/useReactive.js +0 -123
  254. package/dist/react/useSyncStatus.d.ts +0 -59
  255. package/dist/react/useSyncStatus.js +0 -76
  256. package/dist/react/useUndoScope.d.ts +0 -34
  257. package/dist/react/useUndoScope.js +0 -81
  258. package/dist/schema/coordination.d.ts +0 -112
  259. package/dist/schema/coordination.js +0 -129
  260. package/dist/schema/ddl.d.ts +0 -97
  261. package/dist/schema/ddl.js +0 -491
  262. package/dist/schema/ddlLock.d.ts +0 -35
  263. package/dist/schema/ddlLock.js +0 -46
  264. package/dist/schema/diff.d.ts +0 -225
  265. package/dist/schema/diff.js +0 -289
  266. package/dist/schema/generate.d.ts +0 -19
  267. package/dist/schema/generate.js +0 -86
  268. package/dist/schema/index.d.ts +0 -41
  269. package/dist/schema/index.js +0 -76
  270. package/dist/schema/queries.d.ts +0 -201
  271. package/dist/schema/queries.js +0 -144
  272. package/dist/schema/select.d.ts +0 -40
  273. package/dist/schema/select.js +0 -87
  274. package/dist/schema/serialize.d.ts +0 -115
  275. package/dist/schema/serialize.js +0 -262
  276. package/dist/schema/sugar.d.ts +0 -109
  277. package/dist/schema/sugar.js +0 -83
  278. package/dist/schema/syncDeltaRow.d.ts +0 -6
  279. package/dist/schema/syncDeltaRow.js +0 -6
  280. package/dist/server/adapter.d.ts +0 -173
  281. package/dist/server/adapter.js +0 -18
  282. package/dist/server/commit.d.ts +0 -107
  283. package/dist/server/commit.js +0 -1
  284. package/dist/server/index.d.ts +0 -14
  285. package/dist/server/index.js +0 -2
  286. package/dist/server/readConfig.d.ts +0 -80
  287. package/dist/server/readConfig.js +0 -8
  288. package/dist/server/storageMode.d.ts +0 -23
  289. package/dist/server/storageMode.js +0 -17
  290. package/dist/source/adapter.d.ts +0 -81
  291. package/dist/source/adapter.js +0 -22
  292. package/dist/source/adapters/drizzle.d.ts +0 -48
  293. package/dist/source/adapters/drizzle.js +0 -219
  294. package/dist/source/adapters/kysely.d.ts +0 -42
  295. package/dist/source/adapters/kysely.js +0 -205
  296. package/dist/source/adapters/kyselyMutationCore.d.ts +0 -76
  297. package/dist/source/adapters/kyselyMutationCore.js +0 -125
  298. package/dist/source/adapters/memory.d.ts +0 -13
  299. package/dist/source/adapters/memory.js +0 -130
  300. package/dist/source/adapters/prisma.d.ts +0 -63
  301. package/dist/source/adapters/prisma.js +0 -202
  302. package/dist/source/conformance.d.ts +0 -37
  303. package/dist/source/conformance.js +0 -215
  304. package/dist/source/connector.d.ts +0 -95
  305. package/dist/source/connector.js +0 -266
  306. package/dist/source/connectorProtocol.d.ts +0 -154
  307. package/dist/source/connectorProtocol.js +0 -163
  308. package/dist/source/contract.d.ts +0 -195
  309. package/dist/source/contract.js +0 -164
  310. package/dist/source/factory.d.ts +0 -92
  311. package/dist/source/factory.js +0 -286
  312. package/dist/source/footprint.d.ts +0 -111
  313. package/dist/source/footprint.js +0 -0
  314. package/dist/source/idempotency.d.ts +0 -61
  315. package/dist/source/idempotency.js +0 -144
  316. package/dist/source/index.d.ts +0 -23
  317. package/dist/source/index.js +0 -30
  318. package/dist/source/migrations.d.ts +0 -21
  319. package/dist/source/migrations.js +0 -103
  320. package/dist/source/next.d.ts +0 -32
  321. package/dist/source/next.js +0 -25
  322. package/dist/source/pushQueue.d.ts +0 -134
  323. package/dist/source/pushQueue.js +0 -256
  324. package/dist/source/signing.d.ts +0 -92
  325. package/dist/source/signing.js +0 -162
  326. package/dist/source/types.d.ts +0 -401
  327. package/dist/source/types.js +0 -59
  328. package/dist/stores/ObjectStore.d.ts +0 -115
  329. package/dist/stores/ObjectStore.js +0 -393
  330. package/dist/stores/ObjectStoreContract.d.ts +0 -38
  331. package/dist/stores/ObjectStoreContract.js +0 -1
  332. package/dist/stores/SyncActionStore.d.ts +0 -97
  333. package/dist/stores/SyncActionStore.js +0 -504
  334. package/dist/stores/syncAction.d.ts +0 -26
  335. package/dist/stores/syncAction.js +0 -16
  336. package/dist/surface.d.ts +0 -36
  337. package/dist/surface.js +0 -75
  338. package/dist/sync/BootstrapFetcher.d.ts +0 -280
  339. package/dist/sync/BootstrapFetcher.js +0 -962
  340. package/dist/sync/ConnectionManager.d.ts +0 -8
  341. package/dist/sync/ConnectionManager.js +0 -8
  342. package/dist/sync/OnDemandLoader.d.ts +0 -228
  343. package/dist/sync/OnDemandLoader.js +0 -742
  344. package/dist/sync/SubscriptionManager.d.ts +0 -159
  345. package/dist/sync/SubscriptionManager.js +0 -243
  346. package/dist/sync/SyncWebSocket.d.ts +0 -173
  347. package/dist/sync/SyncWebSocket.js +0 -438
  348. package/dist/sync/awaitClaimGrant.d.ts +0 -6
  349. package/dist/sync/awaitClaimGrant.js +0 -6
  350. package/dist/sync/bootstrapApply.d.ts +0 -70
  351. package/dist/sync/bootstrapApply.js +0 -73
  352. package/dist/sync/commitFrames.d.ts +0 -8
  353. package/dist/sync/commitFrames.js +0 -8
  354. package/dist/sync/contextPorts.d.ts +0 -18
  355. package/dist/sync/contextPorts.js +0 -31
  356. package/dist/sync/createClaimStream.d.ts +0 -7
  357. package/dist/sync/createClaimStream.js +0 -7
  358. package/dist/sync/createPresenceStream.d.ts +0 -69
  359. package/dist/sync/createPresenceStream.js +0 -200
  360. package/dist/sync/createSnapshot.d.ts +0 -29
  361. package/dist/sync/createSnapshot.js +0 -118
  362. package/dist/sync/credentialLifecycle.d.ts +0 -7
  363. package/dist/sync/credentialLifecycle.js +0 -7
  364. package/dist/sync/deltaPipeline.d.ts +0 -113
  365. package/dist/sync/deltaPipeline.js +0 -261
  366. package/dist/sync/groupChange.d.ts +0 -113
  367. package/dist/sync/groupChange.js +0 -242
  368. package/dist/sync/participants.d.ts +0 -115
  369. package/dist/sync/participants.js +0 -344
  370. package/dist/sync/persistedPrefix.d.ts +0 -12
  371. package/dist/sync/persistedPrefix.js +0 -22
  372. package/dist/sync/schemaDrift.d.ts +0 -55
  373. package/dist/sync/schemaDrift.js +0 -53
  374. package/dist/sync/schemas.d.ts +0 -70
  375. package/dist/sync/schemas.js +0 -94
  376. package/dist/sync/syncCursor.d.ts +0 -40
  377. package/dist/sync/syncCursor.js +0 -55
  378. package/dist/sync/syncPlan.d.ts +0 -54
  379. package/dist/sync/syncPlan.js +0 -50
  380. package/dist/sync/wsFrameHandlers.d.ts +0 -8
  381. package/dist/sync/wsFrameHandlers.js +0 -8
  382. package/dist/testing/fixtures/bootstrap.d.ts +0 -49
  383. package/dist/testing/fixtures/bootstrap.js +0 -59
  384. package/dist/testing/fixtures/deltas.d.ts +0 -83
  385. package/dist/testing/fixtures/deltas.js +0 -136
  386. package/dist/testing/fixtures/httpResponses.d.ts +0 -70
  387. package/dist/testing/fixtures/httpResponses.js +0 -90
  388. package/dist/testing/fixtures/models.d.ts +0 -83
  389. package/dist/testing/fixtures/models.js +0 -272
  390. package/dist/testing/helpers/reactWrapper.d.ts +0 -69
  391. package/dist/testing/helpers/reactWrapper.js +0 -67
  392. package/dist/testing/helpers/syncEngineHarness.d.ts +0 -54
  393. package/dist/testing/helpers/syncEngineHarness.js +0 -73
  394. package/dist/testing/helpers/wait.d.ts +0 -30
  395. package/dist/testing/helpers/wait.js +0 -49
  396. package/dist/testing/index.d.ts +0 -23
  397. package/dist/testing/index.js +0 -33
  398. package/dist/testing/mocks/FakeDatabase.d.ts +0 -18
  399. package/dist/testing/mocks/FakeDatabase.js +0 -10
  400. package/dist/testing/mocks/MockMutationExecutor.d.ts +0 -87
  401. package/dist/testing/mocks/MockMutationExecutor.js +0 -186
  402. package/dist/testing/mocks/MockNetworkMonitor.d.ts +0 -20
  403. package/dist/testing/mocks/MockNetworkMonitor.js +0 -46
  404. package/dist/testing/mocks/MockSyncContext.d.ts +0 -51
  405. package/dist/testing/mocks/MockSyncContext.js +0 -72
  406. package/dist/testing/mocks/MockSyncStore.d.ts +0 -88
  407. package/dist/testing/mocks/MockSyncStore.js +0 -171
  408. package/dist/testing/mocks/MockWebSocket.d.ts +0 -71
  409. package/dist/testing/mocks/MockWebSocket.js +0 -118
  410. package/dist/transaction/ablo.d.ts +0 -88
  411. package/dist/transaction/ablo.js +0 -33
  412. package/dist/transaction/auth/apiKey.d.ts +0 -152
  413. package/dist/transaction/auth/apiKey.js +0 -419
  414. package/dist/transaction/auth/bootstrapScope.d.ts +0 -15
  415. package/dist/transaction/auth/bootstrapScope.js +0 -1
  416. package/dist/transaction/auth/capability.d.ts +0 -177
  417. package/dist/transaction/auth/capability.js +0 -199
  418. package/dist/transaction/auth/credentialEndpoint.d.ts +0 -61
  419. package/dist/transaction/auth/credentialEndpoint.js +0 -86
  420. package/dist/transaction/auth/credentialPolicy.d.ts +0 -148
  421. package/dist/transaction/auth/credentialPolicy.js +0 -125
  422. package/dist/transaction/auth/credentialSource.d.ts +0 -30
  423. package/dist/transaction/auth/credentialSource.js +0 -55
  424. package/dist/transaction/auth/hostedEndpoints.d.ts +0 -21
  425. package/dist/transaction/auth/hostedEndpoints.js +0 -21
  426. package/dist/transaction/auth/identity.d.ts +0 -55
  427. package/dist/transaction/auth/identity.js +0 -210
  428. package/dist/transaction/auth/index.d.ts +0 -162
  429. package/dist/transaction/auth/index.js +0 -304
  430. package/dist/transaction/auth/schemas.d.ts +0 -59
  431. package/dist/transaction/auth/schemas.js +0 -85
  432. package/dist/transaction/auth/sessionMint.d.ts +0 -28
  433. package/dist/transaction/auth/sessionMint.js +0 -85
  434. package/dist/transaction/coordination/awaitClaimGrant.d.ts +0 -49
  435. package/dist/transaction/coordination/awaitClaimGrant.js +0 -112
  436. package/dist/transaction/coordination/claimHeartbeatLoop.d.ts +0 -50
  437. package/dist/transaction/coordination/claimHeartbeatLoop.js +0 -88
  438. package/dist/transaction/coordination/claimMeta.d.ts +0 -49
  439. package/dist/transaction/coordination/claimMeta.js +0 -52
  440. package/dist/transaction/coordination/createClaimStream.d.ts +0 -64
  441. package/dist/transaction/coordination/createClaimStream.js +0 -475
  442. package/dist/transaction/coordination/events.d.ts +0 -74
  443. package/dist/transaction/coordination/events.js +0 -7
  444. package/dist/transaction/coordination/index.d.ts +0 -19
  445. package/dist/transaction/coordination/index.js +0 -44
  446. package/dist/transaction/coordination/locator.d.ts +0 -83
  447. package/dist/transaction/coordination/locator.js +0 -82
  448. package/dist/transaction/coordination/schema.d.ts +0 -1473
  449. package/dist/transaction/coordination/schema.js +0 -1013
  450. package/dist/transaction/coordination/targetConflict.d.ts +0 -2
  451. package/dist/transaction/coordination/targetConflict.js +0 -103
  452. package/dist/transaction/coordination/trace.d.ts +0 -78
  453. package/dist/transaction/coordination/trace.js +0 -138
  454. package/dist/transaction/durableWrites.d.ts +0 -62
  455. package/dist/transaction/durableWrites.js +0 -71
  456. package/dist/transaction/environment.d.ts +0 -105
  457. package/dist/transaction/environment.js +0 -108
  458. package/dist/transaction/errorCodes.d.ts +0 -403
  459. package/dist/transaction/errorCodes.js +0 -480
  460. package/dist/transaction/errors.d.ts +0 -428
  461. package/dist/transaction/errors.js +0 -686
  462. package/dist/transaction/index.d.ts +0 -20
  463. package/dist/transaction/index.js +0 -20
  464. package/dist/transaction/keys/index.d.ts +0 -87
  465. package/dist/transaction/keys/index.js +0 -207
  466. package/dist/transaction/log/syncDeltaRow.d.ts +0 -158
  467. package/dist/transaction/log/syncDeltaRow.js +0 -95
  468. package/dist/transaction/logPosition.d.ts +0 -97
  469. package/dist/transaction/logPosition.js +0 -125
  470. package/dist/transaction/logger.d.ts +0 -16
  471. package/dist/transaction/logger.js +0 -7
  472. package/dist/transaction/observability.d.ts +0 -53
  473. package/dist/transaction/observability.js +0 -19
  474. package/dist/transaction/persistence.d.ts +0 -12
  475. package/dist/transaction/persistence.js +0 -11
  476. package/dist/transaction/plugin.d.ts +0 -192
  477. package/dist/transaction/plugin.js +0 -87
  478. package/dist/transaction/policy/types.d.ts +0 -217
  479. package/dist/transaction/policy/types.js +0 -126
  480. package/dist/transaction/resources/functionalUpdate.d.ts +0 -79
  481. package/dist/transaction/resources/functionalUpdate.js +0 -87
  482. package/dist/transaction/resources/httpResources.d.ts +0 -266
  483. package/dist/transaction/resources/httpResources.js +0 -7
  484. package/dist/transaction/resources/modelOperations.d.ts +0 -319
  485. package/dist/transaction/resources/modelOperations.js +0 -12
  486. package/dist/transaction/resources/mutationOptions.d.ts +0 -66
  487. package/dist/transaction/resources/mutationOptions.js +0 -9
  488. package/dist/transaction/resources/where.d.ts +0 -85
  489. package/dist/transaction/resources/where.js +0 -70
  490. package/dist/transaction/resources/writeOptionsSchema.d.ts +0 -47
  491. package/dist/transaction/resources/writeOptionsSchema.js +0 -73
  492. package/dist/transaction/schema/field.d.ts +0 -126
  493. package/dist/transaction/schema/field.js +0 -265
  494. package/dist/transaction/schema/loadStrategy.d.ts +0 -45
  495. package/dist/transaction/schema/loadStrategy.js +0 -46
  496. package/dist/transaction/schema/model.d.ts +0 -379
  497. package/dist/transaction/schema/model.js +0 -123
  498. package/dist/transaction/schema/openapi.d.ts +0 -57
  499. package/dist/transaction/schema/openapi.js +0 -340
  500. package/dist/transaction/schema/relation.d.ts +0 -199
  501. package/dist/transaction/schema/relation.js +0 -104
  502. package/dist/transaction/schema/residency.d.ts +0 -29
  503. package/dist/transaction/schema/residency.js +0 -25
  504. package/dist/transaction/schema/roles.d.ts +0 -249
  505. package/dist/transaction/schema/roles.js +0 -230
  506. package/dist/transaction/schema/schema.d.ts +0 -324
  507. package/dist/transaction/schema/schema.js +0 -305
  508. package/dist/transaction/schema/tenancy.d.ts +0 -139
  509. package/dist/transaction/schema/tenancy.js +0 -190
  510. package/dist/transaction/transactionLayer.d.ts +0 -82
  511. package/dist/transaction/transactionLayer.js +0 -24
  512. package/dist/transaction/transactions/settlement/commitEnvelope.d.ts +0 -143
  513. package/dist/transaction/transactions/settlement/commitEnvelope.js +0 -161
  514. package/dist/transaction/transactions/settlement/httpCommitEnvelope.d.ts +0 -53
  515. package/dist/transaction/transactions/settlement/httpCommitEnvelope.js +0 -207
  516. package/dist/transaction/transactions/settlement/idempotencyKey.d.ts +0 -10
  517. package/dist/transaction/transactions/settlement/idempotencyKey.js +0 -9
  518. package/dist/transaction/transactions/settlement/pendingWrite.d.ts +0 -112
  519. package/dist/transaction/transactions/settlement/pendingWrite.js +0 -20
  520. package/dist/transaction/transport/commitFrames.d.ts +0 -90
  521. package/dist/transaction/transport/commitFrames.js +0 -134
  522. package/dist/transaction/transport/connectionManager.d.ts +0 -215
  523. package/dist/transaction/transport/connectionManager.js +0 -673
  524. package/dist/transaction/transport/credentialLifecycle.d.ts +0 -177
  525. package/dist/transaction/transport/credentialLifecycle.js +0 -324
  526. package/dist/transaction/transport/heartbeat.d.ts +0 -65
  527. package/dist/transaction/transport/heartbeat.js +0 -93
  528. package/dist/transaction/transport/httpClient.d.ts +0 -123
  529. package/dist/transaction/transport/httpClient.js +0 -145
  530. package/dist/transaction/transport/httpOptions.d.ts +0 -33
  531. package/dist/transaction/transport/httpOptions.js +0 -12
  532. package/dist/transaction/transport/httpTransport.d.ts +0 -8
  533. package/dist/transaction/transport/httpTransport.js +0 -1276
  534. package/dist/transaction/transport/networkProbe.d.ts +0 -84
  535. package/dist/transaction/transport/networkProbe.js +0 -207
  536. package/dist/transaction/transport/wsFrameHandlers.d.ts +0 -128
  537. package/dist/transaction/transport/wsFrameHandlers.js +0 -429
  538. package/dist/transaction/transport/wsTransport.d.ts +0 -576
  539. package/dist/transaction/transport/wsTransport.js +0 -1017
  540. package/dist/transaction/types/assertExact.d.ts +0 -17
  541. package/dist/transaction/types/assertExact.js +0 -1
  542. package/dist/transaction/types/global.d.ts +0 -107
  543. package/dist/transaction/types/global.js +0 -40
  544. package/dist/transaction/types/index.d.ts +0 -205
  545. package/dist/transaction/types/index.js +0 -56
  546. package/dist/transaction/types/modelData.d.ts +0 -10
  547. package/dist/transaction/types/modelData.js +0 -9
  548. package/dist/transaction/types/participant.d.ts +0 -20
  549. package/dist/transaction/types/participant.js +0 -10
  550. package/dist/transaction/types/streams.d.ts +0 -540
  551. package/dist/transaction/types/streams.js +0 -11
  552. package/dist/transaction/utils/asyncIterator.d.ts +0 -34
  553. package/dist/transaction/utils/asyncIterator.js +0 -135
  554. package/dist/transaction/utils/duration.d.ts +0 -25
  555. package/dist/transaction/utils/duration.js +0 -45
  556. package/dist/transaction/utils/json.d.ts +0 -57
  557. package/dist/transaction/utils/json.js +0 -276
  558. package/dist/transaction/wire/accountResponses.d.ts +0 -351
  559. package/dist/transaction/wire/accountResponses.js +0 -255
  560. package/dist/transaction/wire/auth.d.ts +0 -49
  561. package/dist/transaction/wire/auth.js +0 -57
  562. package/dist/transaction/wire/bootstrapReason.d.ts +0 -9
  563. package/dist/transaction/wire/bootstrapReason.js +0 -8
  564. package/dist/transaction/wire/claimEvent.d.ts +0 -76
  565. package/dist/transaction/wire/claimEvent.js +0 -73
  566. package/dist/transaction/wire/claims.d.ts +0 -463
  567. package/dist/transaction/wire/claims.js +0 -229
  568. package/dist/transaction/wire/commit.d.ts +0 -603
  569. package/dist/transaction/wire/commit.js +0 -321
  570. package/dist/transaction/wire/delta.d.ts +0 -250
  571. package/dist/transaction/wire/delta.js +0 -147
  572. package/dist/transaction/wire/errorEnvelope.d.ts +0 -72
  573. package/dist/transaction/wire/errorEnvelope.js +0 -123
  574. package/dist/transaction/wire/feedCursor.d.ts +0 -60
  575. package/dist/transaction/wire/feedCursor.js +0 -82
  576. package/dist/transaction/wire/feedEvent.d.ts +0 -177
  577. package/dist/transaction/wire/feedEvent.js +0 -39
  578. package/dist/transaction/wire/frames.d.ts +0 -194
  579. package/dist/transaction/wire/frames.js +0 -50
  580. package/dist/transaction/wire/inboundFrames.d.ts +0 -552
  581. package/dist/transaction/wire/inboundFrames.js +0 -116
  582. package/dist/transaction/wire/index.d.ts +0 -50
  583. package/dist/transaction/wire/index.js +0 -74
  584. package/dist/transaction/wire/listEnvelope.d.ts +0 -37
  585. package/dist/transaction/wire/listEnvelope.js +0 -42
  586. package/dist/transaction/wire/modelResponses.d.ts +0 -85
  587. package/dist/transaction/wire/modelResponses.js +0 -43
  588. package/dist/transaction/wire/protocol.d.ts +0 -38
  589. package/dist/transaction/wire/protocol.js +0 -38
  590. package/dist/transaction/wire/protocolVersion.d.ts +0 -73
  591. package/dist/transaction/wire/protocolVersion.js +0 -83
  592. package/dist/transactions/mutations/MutationQueue.d.ts +0 -655
  593. package/dist/transactions/mutations/MutationQueue.js +0 -2797
  594. package/dist/transactions/mutations/MutationStore.d.ts +0 -20
  595. package/dist/transactions/mutations/MutationStore.js +0 -53
  596. package/dist/transactions/mutations/UnconfirmedWrites.d.ts +0 -82
  597. package/dist/transactions/mutations/UnconfirmedWrites.js +0 -104
  598. package/dist/transactions/mutations/coalesceRules.d.ts +0 -58
  599. package/dist/transactions/mutations/coalesceRules.js +0 -140
  600. package/dist/transactions/mutations/commitLatency.d.ts +0 -52
  601. package/dist/transactions/mutations/commitLatency.js +0 -130
  602. package/dist/transactions/mutations/commitOutboxStore.d.ts +0 -28
  603. package/dist/transactions/mutations/commitOutboxStore.js +0 -26
  604. package/dist/transactions/mutations/commitPayload.d.ts +0 -164
  605. package/dist/transactions/mutations/commitPayload.js +0 -152
  606. package/dist/transactions/mutations/deltaConfirmation.d.ts +0 -59
  607. package/dist/transactions/mutations/deltaConfirmation.js +0 -233
  608. package/dist/transactions/mutations/durableWriteStore.d.ts +0 -14
  609. package/dist/transactions/mutations/durableWriteStore.js +0 -12
  610. package/dist/transactions/mutations/optimisticApply.d.ts +0 -49
  611. package/dist/transactions/mutations/optimisticApply.js +0 -65
  612. package/dist/transactions/mutations/replayValidation.d.ts +0 -186
  613. package/dist/transactions/mutations/replayValidation.js +0 -163
  614. package/dist/utils/mobxSetup.d.ts +0 -53
  615. package/dist/utils/mobxSetup.js +0 -330
  616. package/dist/webhooks/events.d.ts +0 -43
  617. package/dist/webhooks/events.js +0 -42
  618. package/dist/webhooks/index.d.ts +0 -8
  619. package/dist/webhooks/index.js +0 -8
  620. package/dist/wire/index.d.ts +0 -1
  621. package/dist/wire/index.js +0 -8
  622. package/docs/interaction-model.md +0 -99
package/docs/webhooks.md CHANGED
@@ -25,7 +25,7 @@ There are two ways data flows out of Ablo, and they're for different jobs:
25
25
  | | reaches | use it for |
26
26
  |---|---|---|
27
27
  | **Realtime** (`useAblo`, WSS) | your live UI | instant, optimistic rendering |
28
- | **Webhooks** (this page) | your database | a durable copy you own analytics, backups, server logic |
28
+ | **Webhooks** (this page) | your database | a durable copy you own: analytics, backups, server logic |
29
29
 
30
30
  Most apps use both: the realtime stream for the UI, the webhook stream to keep
31
31
  their database in sync. This page is the webhook stream.
@@ -34,8 +34,8 @@ If you know Stripe, you already know the shape:
34
34
 
35
35
  | Stripe | Ablo |
36
36
  |---|---|
37
- | `stripe.x.create(...)` make the change | the Ablo client make the change (+ live sync) |
38
- | `/stripe-webhook` confirm and persist | `/api/ablo/[...all]` persist into your database |
37
+ | `stripe.x.create(...)`: make the change | the Ablo client: make the change (+ live sync) |
38
+ | `/stripe-webhook`: confirm and persist | `/api/ablo/[...all]`: persist into your database |
39
39
  | Stripe owns the charges | Ablo owns the transaction log |
40
40
  | you mirror charges into your database | you mirror the log into your database |
41
41
 
@@ -50,11 +50,11 @@ Every delivery is a batch of events. Each event:
50
50
  | field | meaning |
51
51
  |---|---|
52
52
  | `type` | `"<model>.<verb>"` with the model name lowercased, e.g. `task.updated` |
53
- | `model` | the model name exactly as declared in your schema the table to write |
53
+ | `model` | the model name exactly as declared in your schema: the table to write |
54
54
  | `objectId` | the changed row's id |
55
55
  | `data` | the post-change row, or `null` on delete (like Stripe's `event.data.object`) |
56
- | `syncId` | monotonic log position **dedupe and order by this** |
57
- | `id` | `String(syncId)` the event id |
56
+ | `syncId` | monotonic log position: **dedupe and order by this** |
57
+ | `id` | `String(syncId)`: the event id |
58
58
  | `createdAt` | ISO commit timestamp |
59
59
 
60
60
  ```ts
@@ -200,8 +200,8 @@ sequenceDiagram
200
200
 
201
201
  | behavior | how it works |
202
202
  |---|---|
203
- | **Ordering** | Every event carries `syncId`, a monotonic log position. Apply in `syncId` order Ablo guarantees the order because it owns the log. |
204
- | **Retries** | A non-`2xx` (or no response within the timeout) is retried with backoff: immediate, 5s, 5m, 30m, 2h, 5h, 10h, 10h 8 attempts over ~32h. |
203
+ | **Ordering** | Every event carries `syncId`, a monotonic log position. Apply in `syncId` order: Ablo guarantees the order because it owns the log. |
204
+ | **Retries** | A non-`2xx` (or no response within the timeout) is retried with backoff: immediate, 5s, 5m, 30m, 2h, 5h, 10h, 10h: 8 attempts over ~32h. |
205
205
  | **Auto-disable** | After the retries exhaust, the endpoint is marked `disabled` and delivery stops until you `ablo webhooks enable <id>`. |
206
206
  | **Replay** | Nothing is lost on failure: the log *is* the durable buffer, and delivery resumes from the endpoint's cursor once it's healthy. |
207
207
 
@@ -213,7 +213,7 @@ sequenceDiagram
213
213
  - **Return `2xx` fast.** Acknowledge first, then do slow work asynchronously.
214
214
  - **Subscribe to only what you need.** Set `enabledEvents` to the models you
215
215
  mirror (`['*']` is the default = all).
216
- - **Roll secrets periodically.** `ablo webhooks roll <id>` mints a new secret;
216
+ - **Roll secrets periodically:** `ablo webhooks roll <id>` mints a new secret;
217
217
  Standard Webhooks supports a rotation window so in-flight events still verify.
218
218
  - **Verify the raw body.** Frameworks that re-serialize JSON will break the
219
219
  signature — verify the bytes you received.
@@ -37,7 +37,7 @@ no `package.json`, so Node resolves the entry path against the package
37
37
  root and a bare `quickstart.ts` won't be found.
38
38
 
39
39
  ```bash
40
- cd packages/sync-engine
40
+ cd packages/ablo
41
41
  ABLO_API_KEY=sk_test_... npx tsx examples/quickstart.ts
42
42
  ```
43
43
 
@@ -50,7 +50,7 @@ orchestrator drives the customer handler in-process so signer and
50
50
  verifier exchange real signed bytes without leaving the process.
51
51
 
52
52
  ```bash
53
- cd packages/sync-engine
53
+ cd packages/ablo
54
54
  npx tsx examples/data-source/run.ts
55
55
  ```
56
56
 
@@ -16,7 +16,7 @@ when they want Ablo to coordinate writes against rows stored in
16
16
  ## Run
17
17
 
18
18
  ```bash
19
- cd packages/sync-engine
19
+ cd packages/ablo
20
20
  npx tsx examples/data-source/run.ts
21
21
  ```
22
22
 
@@ -19,7 +19,7 @@
19
19
  import {
20
20
  signAbloSourceRequest,
21
21
  type Ablo,
22
- } from '@abloatai/ablo';
22
+ } from '@ablo/ablo';
23
23
 
24
24
  export interface AbloDriverOptions {
25
25
  /**
@@ -15,7 +15,7 @@
15
15
  * inside a transaction. The shape of the handlers stays identical.
16
16
  */
17
17
 
18
- import Ablo, { dataSource, sourceEventForOperation } from '@abloatai/ablo';
18
+ import Ablo, { dataSource, sourceEventForOperation } from '@ablo/ablo';
19
19
  import { schema } from './schema';
20
20
 
21
21
  type TaskRow = {
@@ -4,7 +4,7 @@
4
4
  * Run (from the package root — the examples/ folder has no package.json
5
5
  * of its own, so Node resolves module paths against the package root):
6
6
  *
7
- * cd packages/sync-engine
7
+ * cd packages/ablo
8
8
  * npx tsx examples/data-source/run.ts
9
9
  *
10
10
  * What this proves:
@@ -12,7 +12,7 @@
12
12
  * side without the other is a compile error.
13
13
  */
14
14
 
15
- import { defineSchema, model, z } from '@abloatai/ablo/schema';
15
+ import { defineSchema, model, z } from '@ablo/ablo/schema';
16
16
 
17
17
  export const schema = defineSchema({
18
18
  tasks: model({
@@ -6,8 +6,8 @@
6
6
  * ABLO_API_KEY=sk_test_... npx tsx examples/quickstart.ts
7
7
  */
8
8
 
9
- import Ablo from '@abloatai/ablo';
10
- import { defineSchema, model, z } from '@abloatai/ablo/schema';
9
+ import Ablo from '@ablo/ablo';
10
+ import { defineSchema, model, z } from '@ablo/ablo/schema';
11
11
 
12
12
  const schema = defineSchema({
13
13
  weatherReports: model({
package/llms.txt CHANGED
@@ -1,18 +1,18 @@
1
1
  # Ablo
2
2
 
3
- Ablo is the agentic coordination layer: one API for AI agents, apps, and services to claim, change, and confirm the same rows.
3
+ Ablo is collaboration infrastructure for AI agents: one API for agents, apps, and services to claim, change, and confirm the same rows.
4
4
 
5
- Here is the problem it solves. Two agents reach for `report_stockholm` at once. One claims the row, does slow work (an LLM call, a fetch, a chain of tools), and commits. The second is neither rejected nor allowed to clobber: it waits in line, is handed the row as it now stands, and proceeds. Claims don't lock. If another writer holds the row, `claim` waits for them, re-reads the fresh row, then hands it to you — so writers serialize instead of colliding. A person editing that row is simply another holder; the agent waits behind them the same way.
5
+ Here is the problem it solves. Two agents reach for `report_stockholm` at once. One claims the row, does slow work (an LLM call, a fetch, a chain of tools), and commits. The second is neither rejected nor allowed to clobber: it waits in line, is handed the row as it now stands, and proceeds. Claims don't lock. If another writer holds the row, `claim` waits for them, re-reads the fresh row, then hands it to you — so writers serialize instead of colliding. A person editing that row is simply another holder; the agent waits behind them the same way. And a claim is as narrow as its target: name a `path`, a `range`, or a `field` and two claims on non-overlapping parts of the same row are both granted — region locking within one row, with no queueing between regions.
6
6
 
7
7
  Use AI SDK for the agent loop. Use Ablo when agent reads and writes must persist, coordinate with concurrent work, and leave an audit trail.
8
8
 
9
- ## Surfaces pick by who is calling
9
+ ## Surfaces: pick by who is calling
10
10
 
11
11
  Every surface reaches the same coordinated state. They are not interchangeable.
12
12
 
13
13
  - SDK, `@abloatai/ablo` with `transport: 'http'` — THE AGENTS THEMSELVES. Stateless, request/response, nothing held open; the credential is the identity. This is the main path — default to it.
14
14
  - Coordination MCP, `@abloatai/mcp` — an agent living inside an MCP host (Claude, Cursor). Two jobs: MANAGING your Ablo the way the CLI does (`get_schema`, `list_projects`, `create_project`, `tail_logs`, `get_usage`), and claim/commit as tools over your rows. Call `get_schema` first — it is the only way to learn the model names every data tool needs. `init`, `push`, `pull`, `generate` have no tools (they touch your repo); run those in a shell.
15
- - `humans()` with `@abloatai/ablo/react` — the interfaces a person watches agent work arrive in. The bare client is the coordination layer (commit, read, observe, claim); `humans()` is the PLUGIN that adds the local watchable copy, live queries, and presence. It `requires: { duplex: true }`, so a `transport: 'http'` agent is rejected at construction rather than left holding a subscription that never delivers. It is installed by default on a socket client with no `plugins` list. There is no `agents()` plugin — agents are the default caller, not a special one. A browser NEVER receives the secret key; mint a session token.
15
+ - `humans()` with `@abloatai/humans/react` — the interfaces a person watches agent work arrive in. The bare client is the coordination layer (commit, read, observe, claim); `humans()` is the plugin that adds the local watchable copy, live queries, and presence. It `requires: { duplex: true }`, so a `transport: 'http'` agent is rejected at construction rather than left holding a subscription that never delivers. It remains the compatibility default for omitted `plugins`; new code should install it explicitly from `@abloatai/humans`. There is no `agents()` plugin — agents are the default caller, not a special one. A browser NEVER receives the secret key; mint a session token.
16
16
  - CLI, `ablo` — scaffolding, schema push, connecting a database. Terminals and CI. Agents must run it non-interactively (see the CLI section below).
17
17
  - REST, `/api/v1` — runtimes with no SDK.
18
18
  - Integration-helper MCP, hosted `/api/mcp` — teaching a coding assistant the SDK WHILE BUILDING an integration. Docs, schema lint, and scaffolds only; it has NO per-model data tools and cannot touch application rows.
@@ -50,7 +50,7 @@ const schema = defineSchema({
50
50
 
51
51
  const ablo = Ablo({ schema, apiKey: process.env.ABLO_API_KEY });
52
52
 
53
- const report = await ablo.weatherReports.retrieve({ id: 'report_stockholm' });
53
+ const report = await ablo.weatherReports.get({ id: 'report_stockholm' });
54
54
  if (!report) throw new Error('Row not found');
55
55
 
56
56
  // Claim the row (waits if someone else holds it), read the fresh copy off
@@ -74,9 +74,9 @@ For full integrations, use `integration-guide` as the canonical doc. It covers
74
74
  the same model API across your own Data Source-backed app databases,
75
75
  React selectors, multiplayer, and future agent workers.
76
76
 
77
- Reads come in two flavors, and you pick by whether you can wait. `retrieve({ id })`
77
+ Reads come in two flavors, and you pick by whether you can wait. `get({ id })`
78
78
  (one row) and `list({ where })` (many) are async — they answer from the local
79
- graph and fall back to the server, so await them. `local.retrieve(id)`,
79
+ graph and fall back to the server, so await them. `local.get(id)`,
80
80
  `local.list({ where })`, and `local.count({ where })` are the same reads narrowed
81
81
  to what has already synced: nothing to await, reactive in render. There is no
82
82
  second verb to learn — `local.` is the only difference. The query reads accept
@@ -88,7 +88,7 @@ Workers import the same app schema and select `transport: 'http'`. The transport
88
88
  changes; the typed `ablo.<model>` contract does not. There is no public
89
89
  schema-less or string-keyed model client.
90
90
 
91
- React reads should use selector `useAblo`: `useAblo((ablo) => ablo.weatherReports.local.retrieve(id))` (synchronous local read, reactive in render).
91
+ React reads should use selector `useAblo`: `useAblo((ablo) => ablo.weatherReports.local.get(id))` (synchronous local read, reactive in render).
92
92
  Use zero-argument `useAblo()` only when a component needs the client for an
93
93
  event handler or effect. The selector form above is the complete reactive
94
94
  surface — every read goes through it.
@@ -117,7 +117,7 @@ A change to one row reaches other rows three ways. ROUTING: a write fans out to
117
117
  ## Claimed Behavior
118
118
 
119
119
  Reads never silently block. Schema reads stay open while a row is claimed.
120
- Typed reads through `ablo.<model>.retrieve({ id })` return the row by default,
120
+ Typed reads through `ablo.<model>.get({ id })` return the row by default,
121
121
  even while it is claimed. Pass `ifClaimed: 'fail'` to throw
122
122
  `AbloClaimedError`, and inspect active coordination separately through
123
123
  `ablo.<model>.claim.state({ id })`.
@@ -205,10 +205,10 @@ Going live is three things, each done with a `sk_live_` key: register the produc
205
205
 
206
206
  Import from these public paths only:
207
207
 
208
- - `@abloatai/ablo` — `Ablo`, errors, typed model clients, claims, and `dataSource`.
208
+ - `@abloatai/ablo` — headless HTTP `Ablo`, errors, typed model clients, claims, durable observation, and `dataSource`.
209
+ - `@abloatai/ablo/client` — reactive WebSocket client, presence, and the human-facing materializer.
209
210
  - `@abloatai/ablo/schema` — schema DSL.
210
211
  - `@abloatai/ablo/react` — React provider and hooks.
211
- - `@abloatai/ablo/testing` — test harnesses and mocks.
212
212
  - `@abloatai/ablo/source` — `dataSource`, the `DataSourceAdapter` spine, `prismaDataSource`. For a customer-canonical Data Source endpoint.
213
213
  - `@abloatai/ablo/source/next` — `dataSourceNext` (Next.js App Router `{ POST }`).
214
214
  - `@abloatai/ablo/source/drizzle` — `drizzleDataSource`.
@@ -217,7 +217,7 @@ Import from these public paths only:
217
217
 
218
218
  Do not teach `/api`, `/agent`, `/ai-sdk`, `/core`, `/realtime`, or internal subpaths. (`/source` IS public — it's the Data Source endpoint surface above.)
219
219
 
220
- ## CLI agents run it NON-INTERACTIVELY
220
+ ## CLI: agents run it NON-INTERACTIVELY
221
221
 
222
222
  `ablo init` and other prompts need a TTY; an agent/CI run has none and will HANG. Always:
223
223
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@abloatai/ablo",
3
- "version": "0.35.0",
4
- "description": "The Collaboration Layer For AI Agents",
3
+ "version": "0.37.0",
4
+ "description": "The public Ablo SDK for coordinated reads, commits, claims, observation, and reactive applications.",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
7
7
  "engines": {
@@ -9,237 +9,127 @@
9
9
  },
10
10
  "main": "./dist/index.js",
11
11
  "types": "./dist/index.d.ts",
12
- "bin": {
13
- "ablo": "./dist/cli.cjs"
14
- },
15
12
  "exports": {
16
13
  ".": {
17
14
  "types": "./dist/index.d.ts",
18
15
  "import": "./dist/index.js",
19
16
  "default": "./dist/index.js"
20
17
  },
21
- "./schema": {
22
- "types": "./dist/schema/index.d.ts",
23
- "import": "./dist/schema/index.js",
24
- "default": "./dist/schema/index.js"
25
- },
26
- "./coordination": {
27
- "types": "./dist/coordination/index.d.ts",
28
- "import": "./dist/coordination/index.js",
29
- "default": "./dist/coordination/index.js"
18
+ "./client": {
19
+ "types": "./dist/client.d.ts",
20
+ "import": "./dist/client.js",
21
+ "default": "./dist/client.js"
30
22
  },
31
23
  "./react": {
32
- "types": "./dist/react/index.d.ts",
33
- "import": "./dist/react/index.js",
34
- "default": "./dist/react/index.js"
35
- },
36
- "./testing": {
37
- "types": "./dist/testing/index.d.ts",
38
- "import": "./dist/testing/index.js",
39
- "default": "./dist/testing/index.js"
40
- },
41
- "./core": {
42
- "types": "./dist/core/index.d.ts",
43
- "import": "./dist/core/index.js",
44
- "default": "./dist/core/index.js"
45
- },
46
- "./batching": {
47
- "types": "./dist/batching/index.d.ts",
48
- "import": "./dist/batching/index.js",
49
- "default": "./dist/batching/index.js"
24
+ "types": "./dist/react.d.ts",
25
+ "import": "./dist/react.js",
26
+ "default": "./dist/react.js"
50
27
  },
51
- "./ai-sdk": {
52
- "types": "./dist/ai-sdk/index.d.ts",
53
- "import": "./dist/ai-sdk/index.js",
54
- "default": "./dist/ai-sdk/index.js"
28
+ "./schema": {
29
+ "types": "./dist/schema.d.ts",
30
+ "import": "./dist/schema.js",
31
+ "default": "./dist/schema.js"
55
32
  },
56
33
  "./source": {
57
- "types": "./dist/source/index.d.ts",
58
- "import": "./dist/source/index.js",
59
- "default": "./dist/source/index.js"
34
+ "types": "./dist/source.d.ts",
35
+ "import": "./dist/source.js",
36
+ "default": "./dist/source.js"
60
37
  },
61
- "./source/conformance": {
62
- "types": "./dist/source/conformance.d.ts",
63
- "import": "./dist/source/conformance.js",
64
- "default": "./dist/source/conformance.js"
38
+ "./source/next": {
39
+ "types": "./dist/source-next.d.ts",
40
+ "import": "./dist/source-next.js",
41
+ "default": "./dist/source-next.js"
65
42
  },
66
43
  "./source/drizzle": {
67
- "types": "./dist/source/adapters/drizzle.d.ts",
68
- "import": "./dist/source/adapters/drizzle.js",
69
- "default": "./dist/source/adapters/drizzle.js"
44
+ "types": "./dist/source-drizzle.d.ts",
45
+ "import": "./dist/source-drizzle.js",
46
+ "default": "./dist/source-drizzle.js"
70
47
  },
71
48
  "./source/kysely": {
72
- "types": "./dist/source/adapters/kysely.d.ts",
73
- "import": "./dist/source/adapters/kysely.js",
74
- "default": "./dist/source/adapters/kysely.js"
49
+ "types": "./dist/source-kysely.d.ts",
50
+ "import": "./dist/source-kysely.js",
51
+ "default": "./dist/source-kysely.js"
75
52
  },
76
- "./source/next": {
77
- "types": "./dist/source/next.d.ts",
78
- "import": "./dist/source/next.js",
79
- "default": "./dist/source/next.js"
53
+ "./source/conformance": {
54
+ "types": "./dist/source-conformance.d.ts",
55
+ "import": "./dist/source-conformance.js",
56
+ "default": "./dist/source-conformance.js"
80
57
  },
81
- "./keys": {
82
- "types": "./dist/keys/index.d.ts",
83
- "import": "./dist/keys/index.js",
84
- "default": "./dist/keys/index.js"
58
+ "./server": {
59
+ "types": "./dist/server.d.ts",
60
+ "import": "./dist/server.js",
61
+ "default": "./dist/server.js"
85
62
  },
86
63
  "./auth": {
87
- "types": "./dist/auth/index.d.ts",
88
- "import": "./dist/auth/index.js",
89
- "default": "./dist/auth/index.js"
64
+ "types": "./dist/auth.d.ts",
65
+ "import": "./dist/auth.js",
66
+ "default": "./dist/auth.js"
90
67
  },
91
- "./environment": {
92
- "types": "./dist/environment.d.ts",
93
- "import": "./dist/environment.js",
94
- "default": "./dist/environment.js"
68
+ "./coordination": {
69
+ "types": "./dist/coordination.d.ts",
70
+ "import": "./dist/coordination.js",
71
+ "default": "./dist/coordination.js"
95
72
  },
96
73
  "./wire": {
97
- "types": "./dist/wire/index.d.ts",
98
- "import": "./dist/wire/index.js",
99
- "default": "./dist/wire/index.js"
100
- },
101
- "./server": {
102
- "types": "./dist/server/index.d.ts",
103
- "import": "./dist/server/index.js",
104
- "default": "./dist/server/index.js"
105
- },
106
- "./webhooks": {
107
- "types": "./dist/webhooks/index.d.ts",
108
- "import": "./dist/webhooks/index.js",
109
- "default": "./dist/webhooks/index.js"
110
- },
111
- "./docs": {
112
- "types": "./dist/docs/index.d.ts",
113
- "import": "./dist/docs/index.js",
114
- "default": "./dist/docs/index.js"
74
+ "types": "./dist/wire.d.ts",
75
+ "import": "./dist/wire.js",
76
+ "default": "./dist/wire.js"
115
77
  }
116
78
  },
117
79
  "files": [
118
80
  "dist",
119
- "!dist/__type_probe.*",
120
- "docs/*.md",
121
- "docs/examples/*.md",
81
+ "docs",
122
82
  "examples",
83
+ "assets",
123
84
  "AGENTS.md",
85
+ "CHANGELOG.md",
124
86
  "llms.txt",
125
87
  "LICENSE",
126
88
  "NOTICE",
127
89
  "README.md",
128
- "CHANGELOG.md"
90
+ "package.json"
129
91
  ],
130
92
  "scripts": {
131
93
  "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
132
- "build": "npm run clean && tsc -p tsconfig.build.json && npm run build:cli",
133
- "build:cli": "tsup --config tsup.cli.config.ts",
134
- "typecheck": "npm run typecheck:src && npm run typecheck:cli && npm run typecheck:scripts",
135
- "typecheck:src": "tsc -p tsconfig.json",
136
- "typecheck:cli": "tsc -p tsconfig.cli.json",
137
- "typecheck:scripts": "tsc -p tsconfig.scripts.json",
138
- "prepack": "node scripts/strip-source-condition.mjs",
94
+ "build": "npm run clean && tsc -p tsconfig.build.json",
95
+ "prepack": "npm run build && node scripts/strip-source-condition.mjs",
139
96
  "postpack": "node scripts/restore-source-condition.mjs",
140
97
  "pack:check": "node scripts/pack-check.mjs",
141
- "lint": "npm run lint:imports && npm run lint:errors && npm run lint:docs && npm run lint:docs-site",
142
- "build:docs": "node scripts/build-blume-docs.mjs",
143
- "lint:docs-site": "node scripts/build-blume-docs.mjs --check",
144
- "lint:imports": "node scripts/check-js-extensions.mjs",
98
+ "typecheck": "tsc --noEmit",
99
+ "test": "vitest run",
145
100
  "generate:errors": "tsx scripts/generate-error-docs.mts",
146
101
  "lint:errors": "tsx scripts/check-error-docs.mts",
102
+ "build:docs": "node scripts/build-blume-docs.mjs",
147
103
  "lint:docs": "node scripts/check-doc-drift.mjs",
148
- "lint:eslint": "eslint . --cache",
149
- "lint:pkg": "publint",
150
- "prepublishOnly": "npm run build && npm run lint:pkg",
151
- "check:dist": "node scripts/check-dist-fresh.mjs",
152
- "pretest": "node scripts/check-dist-fresh.mjs",
153
- "test": "jest",
154
- "test:quickstart": "node scripts/test-quickstart.mjs",
155
- "test:unit": "jest --testPathPatterns __tests__/unit",
156
- "test:integration": "jest --testPathPatterns __tests__/integration",
157
- "test:contract": "jest --testPathPatterns __tests__/contract",
158
- "test:property": "jest --testPathPatterns __tests__/property",
159
- "test:coverage": "jest --coverage",
160
- "test:e2e": "E2E_TEST=true jest --config jest.e2e.config.ts",
161
- "test:e2e:up": "docker compose -f docker-compose.test.yml up -d --wait",
162
- "test:e2e:down": "docker compose -f docker-compose.test.yml down -v",
163
- "test:e2e:run": "node scripts/run-e2e.mjs"
104
+ "lint:pkg": "publint"
164
105
  },
165
106
  "publishConfig": {
166
107
  "access": "public",
167
108
  "provenance": true,
168
109
  "registry": "https://registry.npmjs.org"
169
110
  },
170
- "keywords": [
171
- "state-management",
172
- "realtime",
173
- "multiplayer",
174
- "local-first",
175
- "collaborative",
176
- "agents",
177
- "ai",
178
- "commit",
179
- "intent",
180
- "api",
181
- "typescript"
182
- ],
183
111
  "repository": {
184
112
  "type": "git",
185
- "url": "git+https://github.com/Abloatai/ablo.git"
113
+ "url": "git+https://github.com/Abloatai/ablo.git",
114
+ "directory": "packages/ablo"
186
115
  },
187
- "homepage": "https://github.com/Abloatai/ablo#readme",
188
- "bugs": {
189
- "url": "https://github.com/Abloatai/ablo/issues"
116
+ "dependencies": {
117
+ "@abloatai/humans": "^0.37.0",
118
+ "@abloatai/transaction": "^0.37.0"
190
119
  },
191
120
  "peerDependencies": {
192
- "react": "^19.0.0",
193
- "drizzle-orm": ">=0.44.0",
194
- "ai": "^6.0.0"
121
+ "react": "^19.2.8"
195
122
  },
196
123
  "peerDependenciesMeta": {
197
124
  "react": {
198
125
  "optional": true
199
- },
200
- "drizzle-orm": {
201
- "optional": true
202
- },
203
- "ai": {
204
- "optional": true
205
126
  }
206
127
  },
207
- "dependencies": {
208
- "jiti": "^2.7.0",
209
- "mobx": "^6.13.7",
210
- "mobx-react-lite": "^4.0.0",
211
- "uuid": "^11.1.0",
212
- "zod": "^4.4.3"
213
- },
214
128
  "devDependencies": {
215
- "@ai-sdk/provider": "^3.0.0",
216
- "@clack/prompts": "^0.11.0",
217
- "@jest/globals": "^30.2.0",
218
- "@prisma/client": "^7.3.0",
219
- "@types/jest": "^30.0.0",
220
- "@types/node": "^22.0.0",
221
129
  "@types/react": "^19.0.0",
222
- "@types/uuid": "^10.0.0",
223
- "@testing-library/react": "^16.0.0",
224
- "ai": "^6.0.0",
225
- "drizzle-orm": "^0.45.2",
226
- "eslint-plugin-react-hooks": "^7.0.1",
227
- "fake-indexeddb": "^6.0.0",
228
- "fast-check": "^3.0.0",
229
- "globals": "^16.5.0",
230
- "jest": "^30.2.0",
231
- "jest-environment-jsdom": "^30.2.0",
232
- "jest-environment-node": "^30.2.0",
233
- "picocolors": "^1.1.0",
234
- "postgres": "^3.4.0",
235
- "react": "^19.0.0",
236
- "react-dom": "^19.0.0",
237
- "ts-jest": "^29.4.5",
238
- "ts-morph": "^26.0.0",
239
- "tsup": "^8.0.0",
240
- "tsx": "^4.19.0",
241
- "typescript": "^5.8.3",
242
- "publint": "^0.3.21",
243
- "ws": "^8.18.0"
130
+ "react": "^19.2.8",
131
+ "tsx": "^4.20.3",
132
+ "typescript": "npm:@typescript/typescript6@^6.0.2",
133
+ "vitest": "^4.1.4"
244
134
  }
245
135
  }