@coasys/ad4m 0.13.0-test-2 → 0.13.0-test-4

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 (347) hide show
  1. package/README.md +2 -25
  2. package/jest-setup.ts +1 -1
  3. package/lib/index.cjs +2805 -10556
  4. package/lib/index.js +2513 -10322
  5. package/lib/src/Ad4mClient.d.ts +7 -3
  6. package/lib/src/Ad4mClient.js +29 -13
  7. package/lib/src/agent/Agent.js +26 -272
  8. package/lib/src/agent/AgentClient.d.ts +10 -21
  9. package/lib/src/agent/AgentClient.js +75 -427
  10. package/lib/src/agent/AgentStatus.js +2 -37
  11. package/lib/src/ai/AIClient.d.ts +12 -4
  12. package/lib/src/ai/AIClient.js +81 -285
  13. package/lib/src/ai/AITypes.d.ts +55 -0
  14. package/lib/src/ai/AITypes.js +18 -0
  15. package/lib/src/ai/Tasks.js +10 -133
  16. package/lib/src/apiClient.d.ts +52 -0
  17. package/lib/src/apiClient.js +231 -0
  18. package/lib/src/expression/Expression.d.ts +1 -1
  19. package/lib/src/expression/Expression.js +13 -122
  20. package/lib/src/expression/ExpressionClient.d.ts +3 -3
  21. package/lib/src/expression/ExpressionClient.js +13 -76
  22. package/lib/src/expression/ExpressionRef.js +2 -25
  23. package/lib/src/generated/api/AIModelLoadingStatus.d.ts +7 -0
  24. package/lib/src/generated/api/AIModelLoadingStatus.js +2 -0
  25. package/lib/src/generated/api/AddLinkExpressionRequest.d.ts +6 -0
  26. package/lib/src/generated/api/AddLinkExpressionRequest.js +1 -0
  27. package/lib/src/generated/api/AddLinkRequest.d.ts +6 -0
  28. package/lib/src/generated/api/AddLinkRequest.js +1 -0
  29. package/lib/src/generated/api/AddLinksBulkRequest.d.ts +6 -0
  30. package/lib/src/generated/api/AddLinksBulkRequest.js +1 -0
  31. package/lib/src/generated/api/AddSdnaRequest.d.ts +6 -0
  32. package/lib/src/generated/api/AddSdnaRequest.js +2 -0
  33. package/lib/src/generated/api/ApplyTemplateRequest.d.ts +4 -0
  34. package/lib/src/generated/api/ApplyTemplateRequest.js +2 -0
  35. package/lib/src/generated/api/AuthInfoInput.d.ts +10 -0
  36. package/lib/src/generated/api/AuthInfoInput.js +1 -0
  37. package/lib/src/generated/api/CapabilityInput.d.ts +5 -0
  38. package/lib/src/generated/api/CapabilityInput.js +1 -0
  39. package/lib/src/generated/api/CommitBatchRequest.d.ts +3 -0
  40. package/lib/src/generated/api/CommitBatchRequest.js +2 -0
  41. package/lib/src/generated/api/ComputeLogEntry.d.ts +9 -0
  42. package/lib/src/generated/api/ComputeLogEntry.js +2 -0
  43. package/lib/src/generated/api/CreateExpressionRequest.d.ts +4 -0
  44. package/lib/src/generated/api/CreateExpressionRequest.js +2 -0
  45. package/lib/src/generated/api/CreatePerspectiveRequest.d.ts +3 -0
  46. package/lib/src/generated/api/CreatePerspectiveRequest.js +2 -0
  47. package/lib/src/generated/api/CreateSubjectRequest.d.ts +6 -0
  48. package/lib/src/generated/api/CreateSubjectRequest.js +2 -0
  49. package/lib/src/generated/api/EmbedRequest.d.ts +4 -0
  50. package/lib/src/generated/api/EmbedRequest.js +2 -0
  51. package/lib/src/generated/api/EntanglementProofInput.d.ts +6 -0
  52. package/lib/src/generated/api/EntanglementProofInput.js +2 -0
  53. package/lib/src/generated/api/ExecuteCommandsRequest.d.ts +4 -0
  54. package/lib/src/generated/api/ExecuteCommandsRequest.js +2 -0
  55. package/lib/src/generated/api/ExportRequest.d.ts +5 -0
  56. package/lib/src/generated/api/ExportRequest.js +2 -0
  57. package/lib/src/generated/api/ExpressionManyRequest.d.ts +3 -0
  58. package/lib/src/generated/api/ExpressionManyRequest.js +2 -0
  59. package/lib/src/generated/api/ExpressionProof.d.ts +4 -0
  60. package/lib/src/generated/api/ExpressionProof.js +2 -0
  61. package/lib/src/generated/api/ExpressionProofInput.d.ts +6 -0
  62. package/lib/src/generated/api/ExpressionProofInput.js +2 -0
  63. package/lib/src/generated/api/FriendSendMessageRequest.d.ts +3 -0
  64. package/lib/src/generated/api/FriendSendMessageRequest.js +2 -0
  65. package/lib/src/generated/api/FriendsListRequest.d.ts +3 -0
  66. package/lib/src/generated/api/FriendsListRequest.js +2 -0
  67. package/lib/src/generated/api/GenerateAgentRequest.d.ts +3 -0
  68. package/lib/src/generated/api/GenerateAgentRequest.js +2 -0
  69. package/lib/src/generated/api/GenerateJwtRequest.d.ts +4 -0
  70. package/lib/src/generated/api/GenerateJwtRequest.js +2 -0
  71. package/lib/src/generated/api/GetSubjectDataRequest.d.ts +4 -0
  72. package/lib/src/generated/api/GetSubjectDataRequest.js +2 -0
  73. package/lib/src/generated/api/ImportAgentRequest.d.ts +6 -0
  74. package/lib/src/generated/api/ImportAgentRequest.js +2 -0
  75. package/lib/src/generated/api/ImportRequest.d.ts +4 -0
  76. package/lib/src/generated/api/ImportRequest.js +2 -0
  77. package/lib/src/generated/api/JoinNeighbourhoodRequest.d.ts +3 -0
  78. package/lib/src/generated/api/JoinNeighbourhoodRequest.js +2 -0
  79. package/lib/src/generated/api/LanguageMetaInput.d.ts +6 -0
  80. package/lib/src/generated/api/LanguageMetaInput.js +2 -0
  81. package/lib/src/generated/api/Link.d.ts +5 -0
  82. package/lib/src/generated/api/Link.js +2 -0
  83. package/lib/src/generated/api/LinkExpression.d.ts +10 -0
  84. package/lib/src/generated/api/LinkExpression.js +1 -0
  85. package/lib/src/generated/api/LinkExpressionInput.d.ts +10 -0
  86. package/lib/src/generated/api/LinkExpressionInput.js +1 -0
  87. package/lib/src/generated/api/LinkInput.d.ts +5 -0
  88. package/lib/src/generated/api/LinkInput.js +2 -0
  89. package/lib/src/generated/api/LinkLanguageTemplatesRequest.d.ts +3 -0
  90. package/lib/src/generated/api/LinkLanguageTemplatesRequest.js +2 -0
  91. package/lib/src/generated/api/LinkMutations.d.ts +6 -0
  92. package/lib/src/generated/api/LinkMutations.js +1 -0
  93. package/lib/src/generated/api/LinkStatus.d.ts +1 -0
  94. package/lib/src/generated/api/LinkStatus.js +2 -0
  95. package/lib/src/generated/api/LockAgentRequest.d.ts +3 -0
  96. package/lib/src/generated/api/LockAgentRequest.js +2 -0
  97. package/lib/src/generated/api/ModelType.d.ts +1 -0
  98. package/lib/src/generated/api/ModelType.js +2 -0
  99. package/lib/src/generated/api/NotificationInput.d.ts +10 -0
  100. package/lib/src/generated/api/NotificationInput.js +2 -0
  101. package/lib/src/generated/api/OpenLinkRequest.d.ts +3 -0
  102. package/lib/src/generated/api/OpenLinkRequest.js +2 -0
  103. package/lib/src/generated/api/PermitCapabilityRequest.d.ts +3 -0
  104. package/lib/src/generated/api/PermitCapabilityRequest.js +2 -0
  105. package/lib/src/generated/api/PerspectiveInput.d.ts +4 -0
  106. package/lib/src/generated/api/PerspectiveInput.js +1 -0
  107. package/lib/src/generated/api/PromptRequest.d.ts +4 -0
  108. package/lib/src/generated/api/PromptRequest.js +2 -0
  109. package/lib/src/generated/api/PublishLanguageRequest.d.ts +5 -0
  110. package/lib/src/generated/api/PublishLanguageRequest.js +1 -0
  111. package/lib/src/generated/api/PublishNeighbourhoodRequest.d.ts +6 -0
  112. package/lib/src/generated/api/PublishNeighbourhoodRequest.js +1 -0
  113. package/lib/src/generated/api/QueryRequest.d.ts +7 -0
  114. package/lib/src/generated/api/QueryRequest.js +2 -0
  115. package/lib/src/generated/api/RemoveLinkRequest.d.ts +5 -0
  116. package/lib/src/generated/api/RemoveLinkRequest.js +1 -0
  117. package/lib/src/generated/api/RemoveLinksBulkRequest.d.ts +5 -0
  118. package/lib/src/generated/api/RemoveLinksBulkRequest.js +1 -0
  119. package/lib/src/generated/api/ResourceInput.d.ts +4 -0
  120. package/lib/src/generated/api/ResourceInput.js +2 -0
  121. package/lib/src/generated/api/SetDefaultModelRequest.d.ts +4 -0
  122. package/lib/src/generated/api/SetDefaultModelRequest.js +1 -0
  123. package/lib/src/generated/api/SetFreeHostingEnabledRequest.d.ts +3 -0
  124. package/lib/src/generated/api/SetFreeHostingEnabledRequest.js +2 -0
  125. package/lib/src/generated/api/SetMultiUserRequest.d.ts +3 -0
  126. package/lib/src/generated/api/SetMultiUserRequest.js +2 -0
  127. package/lib/src/generated/api/SetStatusRequest.d.ts +3 -0
  128. package/lib/src/generated/api/SetStatusRequest.js +2 -0
  129. package/lib/src/generated/api/SignMessageRequest.d.ts +3 -0
  130. package/lib/src/generated/api/SignMessageRequest.js +2 -0
  131. package/lib/src/generated/api/TrustedAgentsRequest.d.ts +3 -0
  132. package/lib/src/generated/api/TrustedAgentsRequest.js +2 -0
  133. package/lib/src/generated/api/UnlockAgentRequest.d.ts +4 -0
  134. package/lib/src/generated/api/UnlockAgentRequest.js +2 -0
  135. package/lib/src/generated/api/UpdateLinkRequest.d.ts +7 -0
  136. package/lib/src/generated/api/UpdateLinkRequest.js +1 -0
  137. package/lib/src/generated/api/UpdatePerspectiveRequest.d.ts +3 -0
  138. package/lib/src/generated/api/UpdatePerspectiveRequest.js +2 -0
  139. package/lib/src/generated/api/UserStatistics.d.ts +9 -0
  140. package/lib/src/generated/api/UserStatistics.js +2 -0
  141. package/lib/src/generated/api/VerificationRequestResult.d.ts +6 -0
  142. package/lib/src/generated/api/VerificationRequestResult.js +2 -0
  143. package/lib/src/generated/api/VerifySignatureRequest.d.ts +5 -0
  144. package/lib/src/generated/api/VerifySignatureRequest.js +2 -0
  145. package/lib/src/generated/api/WriteSettingsRequest.d.ts +3 -0
  146. package/lib/src/generated/api/WriteSettingsRequest.js +2 -0
  147. package/lib/src/generated/api/index.d.ts +42 -0
  148. package/lib/src/generated/api/index.js +7 -0
  149. package/lib/src/index.d.ts +6 -2
  150. package/lib/src/index.js +6 -2
  151. package/lib/src/jestSetup.d.ts +0 -1
  152. package/lib/src/jestSetup.js +1 -1
  153. package/lib/src/language/Icon.js +2 -21
  154. package/lib/src/language/Language.d.ts +26 -214
  155. package/lib/src/language/Language.js +32 -72
  156. package/lib/src/language/LanguageClient.d.ts +2 -2
  157. package/lib/src/language/LanguageClient.js +15 -105
  158. package/lib/src/language/LanguageHandle.js +2 -41
  159. package/lib/src/language/LanguageMeta.js +4 -75
  160. package/lib/src/language/LanguageRef.js +2 -25
  161. package/lib/src/links/Links.js +14 -111
  162. package/lib/src/model/Ad4mModel.d.ts +81 -38
  163. package/lib/src/model/Ad4mModel.js +651 -408
  164. package/lib/src/model/Ad4mModel.test.js +488 -750
  165. package/lib/src/model/ModelQueryBuilder.d.ts +28 -21
  166. package/lib/src/model/ModelQueryBuilder.js +160 -195
  167. package/lib/src/model/decorators.d.ts +22 -0
  168. package/lib/src/model/decorators.js +7 -0
  169. package/lib/src/model/hydration-batching.test.d.ts +7 -0
  170. package/lib/src/model/hydration-batching.test.js +456 -0
  171. package/lib/src/model/hydration.d.ts +8 -60
  172. package/lib/src/model/hydration.js +41 -541
  173. package/lib/src/model/index.d.ts +0 -4
  174. package/lib/src/model/index.js +0 -4
  175. package/lib/src/model/model-manifest.d.ts +41 -0
  176. package/lib/src/model/model-manifest.js +11 -0
  177. package/lib/src/model/query-sparql.d.ts +36 -22
  178. package/lib/src/model/query-sparql.js +188 -53
  179. package/lib/src/model/query-sparql.test.d.ts +1 -0
  180. package/lib/src/model/query-sparql.test.js +312 -0
  181. package/lib/src/model/query-utils.js +4 -0
  182. package/lib/src/model/shacl-gen.js +4 -0
  183. package/lib/src/model/subscription-delta.test.d.ts +24 -0
  184. package/lib/src/model/subscription-delta.test.js +180 -0
  185. package/lib/src/model/subscription-pool.js +48 -2
  186. package/lib/src/model/types.d.ts +58 -1
  187. package/lib/src/model/types.js +4 -1
  188. package/lib/src/neighbourhood/Neighbourhood.js +4 -32
  189. package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +3 -3
  190. package/lib/src/neighbourhood/NeighbourhoodClient.js +40 -203
  191. package/lib/src/perspectives/LinkQuery.js +2 -42
  192. package/lib/src/perspectives/Perspective.d.ts +1 -1
  193. package/lib/src/perspectives/Perspective.js +10 -52
  194. package/lib/src/perspectives/PerspectiveClient.d.ts +12 -15
  195. package/lib/src/perspectives/PerspectiveClient.js +168 -400
  196. package/lib/src/perspectives/PerspectiveClient.test.d.ts +1 -0
  197. package/lib/src/perspectives/PerspectiveClient.test.js +224 -0
  198. package/lib/src/perspectives/PerspectiveDiff.js +4 -31
  199. package/lib/src/perspectives/PerspectiveHandle.js +3 -43
  200. package/lib/src/perspectives/PerspectiveProxy.d.ts +95 -71
  201. package/lib/src/perspectives/PerspectiveProxy.js +288 -310
  202. package/lib/src/runtime/RuntimeClient.d.ts +6 -6
  203. package/lib/src/runtime/RuntimeClient.js +93 -467
  204. package/lib/src/runtime/RuntimeTypes.d.ts +101 -0
  205. package/lib/src/runtime/RuntimeTypes.js +45 -0
  206. package/lib/src/shacl/SHACLShape.d.ts +7 -0
  207. package/lib/src/shacl/SHACLShape.js +19 -0
  208. package/lib/src/shacl/SHACLShape.test.js +82 -0
  209. package/lib/src/typeDefs.js +3 -628
  210. package/package.json +9 -24
  211. package/rollup.config.js +0 -7
  212. package/src/Ad4mClient.test.ts +1182 -1288
  213. package/src/Ad4mClient.ts +30 -15
  214. package/src/agent/Agent.ts +0 -99
  215. package/src/agent/AgentClient.ts +112 -526
  216. package/src/agent/AgentStatus.ts +0 -12
  217. package/src/ai/AIClient.ts +96 -296
  218. package/src/ai/AITypes.ts +66 -0
  219. package/src/ai/Tasks.ts +0 -52
  220. package/src/apiClient.ts +283 -0
  221. package/src/expression/Expression.ts +3 -43
  222. package/src/expression/ExpressionClient.ts +14 -77
  223. package/src/expression/ExpressionRef.ts +0 -6
  224. package/src/generated/api/AIModelLoadingStatus.ts +3 -0
  225. package/src/generated/api/AddLinkExpressionRequest.ts +4 -0
  226. package/src/generated/api/AddLinkRequest.ts +4 -0
  227. package/src/generated/api/AddLinksBulkRequest.ts +4 -0
  228. package/src/generated/api/AddSdnaRequest.ts +3 -0
  229. package/src/generated/api/ApplyTemplateRequest.ts +3 -0
  230. package/src/generated/api/AuthInfoInput.ts +4 -0
  231. package/src/generated/api/CapabilityInput.ts +4 -0
  232. package/src/generated/api/CommitBatchRequest.ts +3 -0
  233. package/src/generated/api/ComputeLogEntry.ts +3 -0
  234. package/src/generated/api/CreateExpressionRequest.ts +3 -0
  235. package/src/generated/api/CreatePerspectiveRequest.ts +3 -0
  236. package/src/generated/api/CreateSubjectRequest.ts +3 -0
  237. package/src/generated/api/EmbedRequest.ts +3 -0
  238. package/src/generated/api/EntanglementProofInput.ts +3 -0
  239. package/src/generated/api/ExecuteCommandsRequest.ts +3 -0
  240. package/src/generated/api/ExportRequest.ts +3 -0
  241. package/src/generated/api/ExpressionManyRequest.ts +3 -0
  242. package/src/generated/api/ExpressionProof.ts +3 -0
  243. package/src/generated/api/ExpressionProofInput.ts +3 -0
  244. package/src/generated/api/FriendSendMessageRequest.ts +3 -0
  245. package/src/generated/api/FriendsListRequest.ts +3 -0
  246. package/src/generated/api/GenerateAgentRequest.ts +3 -0
  247. package/src/generated/api/GenerateJwtRequest.ts +3 -0
  248. package/src/generated/api/GetSubjectDataRequest.ts +3 -0
  249. package/src/generated/api/ImportAgentRequest.ts +3 -0
  250. package/src/generated/api/ImportRequest.ts +3 -0
  251. package/src/generated/api/JoinNeighbourhoodRequest.ts +3 -0
  252. package/src/generated/api/LanguageMetaInput.ts +3 -0
  253. package/src/generated/api/Link.ts +3 -0
  254. package/src/generated/api/LinkExpression.ts +6 -0
  255. package/src/generated/api/LinkExpressionInput.ts +6 -0
  256. package/src/generated/api/LinkInput.ts +3 -0
  257. package/src/generated/api/LinkLanguageTemplatesRequest.ts +3 -0
  258. package/src/generated/api/LinkMutations.ts +5 -0
  259. package/src/generated/api/LinkStatus.ts +3 -0
  260. package/src/generated/api/LockAgentRequest.ts +3 -0
  261. package/src/generated/api/ModelType.ts +3 -0
  262. package/src/generated/api/NotificationInput.ts +3 -0
  263. package/src/generated/api/OpenLinkRequest.ts +3 -0
  264. package/src/generated/api/PermitCapabilityRequest.ts +3 -0
  265. package/src/generated/api/PerspectiveInput.ts +4 -0
  266. package/src/generated/api/PromptRequest.ts +3 -0
  267. package/src/generated/api/PublishLanguageRequest.ts +4 -0
  268. package/src/generated/api/PublishNeighbourhoodRequest.ts +4 -0
  269. package/src/generated/api/QueryRequest.ts +6 -0
  270. package/src/generated/api/RemoveLinkRequest.ts +4 -0
  271. package/src/generated/api/RemoveLinksBulkRequest.ts +4 -0
  272. package/src/generated/api/ResourceInput.ts +3 -0
  273. package/src/generated/api/SetDefaultModelRequest.ts +4 -0
  274. package/src/generated/api/SetFreeHostingEnabledRequest.ts +3 -0
  275. package/src/generated/api/SetMultiUserRequest.ts +3 -0
  276. package/src/generated/api/SetStatusRequest.ts +3 -0
  277. package/src/generated/api/SignMessageRequest.ts +3 -0
  278. package/src/generated/api/TrustedAgentsRequest.ts +3 -0
  279. package/src/generated/api/UnlockAgentRequest.ts +3 -0
  280. package/src/generated/api/UpdateLinkRequest.ts +5 -0
  281. package/src/generated/api/UpdatePerspectiveRequest.ts +3 -0
  282. package/src/generated/api/UserStatistics.ts +3 -0
  283. package/src/generated/api/VerificationRequestResult.ts +3 -0
  284. package/src/generated/api/VerifySignatureRequest.ts +3 -0
  285. package/src/generated/api/WriteSettingsRequest.ts +3 -0
  286. package/src/generated/api/index.ts +49 -0
  287. package/src/index.ts +6 -2
  288. package/src/jestSetup.ts +1 -1
  289. package/src/language/Icon.ts +0 -4
  290. package/src/language/Language.ts +50 -292
  291. package/src/language/LanguageClient.ts +21 -132
  292. package/src/language/LanguageHandle.ts +0 -14
  293. package/src/language/LanguageMeta.ts +0 -29
  294. package/src/language/LanguageRef.ts +0 -7
  295. package/src/links/Links.ts +0 -37
  296. package/src/model/Ad4mModel.test.ts +827 -808
  297. package/src/model/Ad4mModel.ts +676 -457
  298. package/src/model/ModelQueryBuilder.ts +199 -217
  299. package/src/model/decorators.ts +29 -0
  300. package/src/model/hydration.ts +17 -572
  301. package/src/model/index.ts +0 -4
  302. package/src/model/query-sparql.test.ts +360 -0
  303. package/src/model/query-sparql.ts +203 -56
  304. package/src/model/query-utils.ts +4 -0
  305. package/src/model/shacl-gen.ts +5 -0
  306. package/src/model/types.ts +62 -1
  307. package/src/neighbourhood/Neighbourhood.ts +0 -9
  308. package/src/neighbourhood/NeighbourhoodClient.ts +42 -207
  309. package/src/neighbourhood/NeighbourhoodProxy.test.ts +34 -36
  310. package/src/perspectives/LinkQuery.ts +0 -15
  311. package/src/perspectives/Perspective.ts +1 -12
  312. package/src/perspectives/PerspectiveClient.test.ts +262 -0
  313. package/src/perspectives/PerspectiveClient.ts +227 -412
  314. package/src/perspectives/PerspectiveDiff.ts +0 -8
  315. package/src/perspectives/PerspectiveHandle.ts +1 -12
  316. package/src/perspectives/PerspectiveProxy.test.ts +41 -0
  317. package/src/perspectives/PerspectiveProxy.ts +325 -348
  318. package/src/runtime/RuntimeClient.ts +112 -474
  319. package/src/runtime/RuntimeTypes.ts +144 -0
  320. package/src/shacl/SHACLShape.test.ts +94 -0
  321. package/src/shacl/SHACLShape.ts +27 -0
  322. package/src/typeDefs.ts +3 -5
  323. package/tsconfig.json +3 -7
  324. package/lib/src/model/query-surreal.d.ts +0 -44
  325. package/lib/src/model/query-surreal.js +0 -249
  326. package/lib/src/model/surreal-utils.d.ts +0 -42
  327. package/lib/src/model/surreal-utils.js +0 -128
  328. package/shims/reflect-metadata.ts +0 -0
  329. package/shims/type-graphql.ts +0 -75
  330. package/src/PubSub.ts +0 -17
  331. package/src/agent/AgentResolver.ts +0 -263
  332. package/src/ai/AIResolver.ts +0 -372
  333. package/src/buildSchema.ts +0 -43
  334. package/src/expression/ExpressionResolver.ts +0 -64
  335. package/src/language/LanguageContext.ts +0 -37
  336. package/src/language/LanguageResolver.ts +0 -98
  337. package/src/model/Subject.ts +0 -159
  338. package/src/model/hydration-batch.ts +0 -205
  339. package/src/model/prolog-facts.ts +0 -145
  340. package/src/model/query-prolog.ts +0 -148
  341. package/src/model/query-sparql-batch.ts +0 -301
  342. package/src/model/subscription-pool.ts +0 -163
  343. package/src/neighbourhood/NeighbourhoodResolver.ts +0 -100
  344. package/src/perspectives/PerspectiveResolver.ts +0 -364
  345. package/src/runtime/RuntimeResolver.ts +0 -749
  346. package/src/unwrapApolloResult.ts +0 -16
  347. package/tsconfig-browser.json +0 -82
@@ -1,1344 +1,1238 @@
1
- import { buildSchema } from "type-graphql"
2
-
3
- import { createServer } from 'http';
4
- import { ApolloServer } from '@apollo/server';
5
- import { expressMiddleware } from '@apollo/server/express4';
6
- import { ApolloServerPluginDrainHttpServer } from '@apollo/server/plugin/drainHttpServer'
7
-
8
- import { WebSocketServer } from 'ws';
9
- import { GraphQLWsLink } from "@apollo/client/link/subscriptions";
10
- import { useServer } from 'graphql-ws/lib/use/ws';
11
-
12
- import { ApolloClient, InMemoryCache } from "@apollo/client/core";
13
-
14
- import { createClient } from 'graphql-ws';
15
- import Websocket from "ws";
16
- import express from 'express';
17
-
18
- import AgentResolver from "./agent/AgentResolver"
19
- import { Ad4mClient } from "./Ad4mClient";
20
- import { Perspective, PerspectiveUnsignedInput } from "./perspectives/Perspective";
21
- import { Link, LinkExpression, LinkExpressionInput, LinkInput, LinkMutations } from "./links/Links";
22
- import LanguageResolver from "./language/LanguageResolver";
23
- import NeighbourhoodResolver from "./neighbourhood/NeighbourhoodResolver";
24
- import PerspectiveResolver from "./perspectives/PerspectiveResolver";
25
- import RuntimeResolver from "./runtime/RuntimeResolver";
26
- import ExpressionResolver from "./expression/ExpressionResolver";
27
- import AIResolver from './ai/AIResolver'
28
- import { AuthInfoInput, EntanglementProofInput, CapabilityInput, ResourceInput } from "./agent/Agent";
29
- import { LanguageMetaInput } from "./language/LanguageMeta";
30
- import { InteractionCall } from "./language/Language";
31
- import { PerspectiveState } from "./perspectives/PerspectiveHandle";
32
-
33
- jest.setTimeout(15000)
34
-
35
- async function createGqlServer(port: number) {
36
- const schema = await buildSchema({
37
- resolvers: [
38
- AgentResolver,
39
- ExpressionResolver,
40
- LanguageResolver,
41
- NeighbourhoodResolver,
42
- PerspectiveResolver,
43
- RuntimeResolver,
44
- AIResolver
45
- ]
46
- })
47
-
48
- const app = express();
49
- const httpServer = createServer(app);
50
-
51
- let serverCleanup: any;
52
- const server = new ApolloServer({
53
- schema,
54
- plugins: [
55
- ApolloServerPluginDrainHttpServer({ httpServer }),
56
- {
57
- async serverWillStart() {
58
- return {
59
- async drainServer() {
60
- await serverCleanup.dispose();
61
- },
62
- };
63
- },
64
- },
65
- ],
1
+ import { Ad4mClient } from './Ad4mClient';
2
+ import { Perspective } from './perspectives/Perspective';
3
+ import { LinkQuery } from './perspectives/LinkQuery';
4
+
5
+ // Save original WebSocket so we can restore it after the suite
6
+ const originalWebSocket = (global as any).WebSocket;
7
+
8
+ /**
9
+ * Test architecture:
10
+ *
11
+ * The AD4M server exposes NO REST endpoints for authenticated operations.
12
+ * Everything goes through WebSocket RPC at /api/v1/ws.
13
+ *
14
+ * MockWebSocket intercepts all WS RPC messages and resolves them directly
15
+ * from a response map — no HTTP server, no Express, no REST translation.
16
+ *
17
+ * Server-side unauthenticated WS RPC types (empty token allowed):
18
+ * user.create, user.login, user.verifyEmail, user.requestVerification,
19
+ * user.multiUserEnabled, runtime.info, runtime.tlsDomain
20
+ *
21
+ * The only real HTTP endpoints on the server are:
22
+ * GET / — server info
23
+ * GET /health — health check
24
+ * POST /api/v1/ai/transcription/feed — binary PCM audio (not JSON)
25
+ */
26
+
27
+ // ===================== WS RPC MOCK RESPONSES =====================
28
+ // Each key is a WS RPC message type. The value is either a static response
29
+ // or a function (params) => response for dynamic behaviour.
30
+
31
+ type RpcHandler = unknown | ((params: Record<string, unknown>) => unknown);
32
+
33
+ const MOCK_RESPONSES: Record<string, RpcHandler> = {
34
+ // ── Agent ──
35
+ 'agent.get': { did: 'did:test:123', perspective: new Perspective(), directMessageLanguage: 'lang://dm' },
36
+ 'agent.status': { did: 'did:test:123', didDocument: 'doc', isInitialized: true, isUnlocked: true },
37
+ 'agent.generate': { did: 'did:test:generated', didDocument: 'doc', isInitialized: true, isUnlocked: true },
38
+ 'agent.lock': { did: 'did:test:123', isInitialized: true, isUnlocked: false },
39
+ 'agent.unlock': { did: 'did:test:123', isInitialized: true, isUnlocked: true },
40
+ 'agent.import': { did: 'did:test:imported', isInitialized: true, isUnlocked: true },
41
+ 'agent.byDid': (p: Record<string, unknown>) => ({ did: p.did, perspective: new Perspective() }),
42
+ 'agent.updateProfile': { did: 'did:test:123', perspective: new Perspective(), directMessageLanguage: 'lang://dm' },
43
+ 'agent.sign': 'signed-message-data',
44
+ 'agent.isLocked': false,
45
+ 'agent.requestCapability': 'request-id-123',
46
+ 'agent.permitCapability': 'permitted-token',
47
+ 'agent.generateJwt': 'jwt-token-abc',
48
+ 'agent.getApps': [{ requestId: 'app1', auth: {}, token: 'tok', revoked: false }],
49
+ 'agent.removeApp': [],
50
+ 'agent.revokeToken': [],
51
+ 'agent.getTrustedAgents': ['did:trusted:1'],
52
+ 'agent.addTrustedAgents': ['did:trusted:1', 'did:trusted:2'],
53
+ 'agent.deleteTrustedAgents': ['did:trusted:1'],
54
+ 'agent.getEntanglementProofs': ['proof1', 'proof2'],
55
+ 'agent.addEntanglementProofs': [{ did: 'did:test:123', deviceKey: 'key1', deviceKeyType: 'type1' }],
56
+ 'agent.deleteEntanglementProofs': [],
57
+ 'agent.entanglementProofPreflight': { did: 'did:test:123', deviceKey: 'key1', deviceKeyType: 'type1' },
58
+
59
+ // ── Perspectives ──
60
+ 'perspective.all': [{ uuid: 'uuid-1', name: 'test-perspective', sharedUrl: null, neighbourhood: null, state: 'Synced' }],
61
+ 'perspective.get': (p: Record<string, unknown>) => ({
62
+ uuid: p.uuid, name: 'test-perspective', sharedUrl: null, neighbourhood: null, state: 'Synced',
63
+ }),
64
+ 'perspective.create': (p: Record<string, unknown>) => ({
65
+ uuid: 'uuid-new', name: p.name, sharedUrl: null, neighbourhood: null, state: 'Synced',
66
+ }),
67
+ 'perspective.update': (p: Record<string, unknown>) => ({
68
+ uuid: p.uuid, name: p.name, sharedUrl: null, neighbourhood: null, state: 'Synced',
69
+ }),
70
+ 'perspective.remove': true,
71
+ 'perspective.snapshot': {
72
+ links: [{ author: 'did:test:123', timestamp: '2024-01-01', data: { source: 's', predicate: 'p', target: 't' }, proof: { valid: true } }],
73
+ },
74
+ 'perspective.publishSnapshot': 'Qm123',
75
+ 'perspective.queryLinks': [
76
+ { author: 'did:test:123', timestamp: '2024-01-01', data: { source: 's', predicate: 'p', target: 't' }, proof: { valid: true } },
77
+ ],
78
+ 'perspective.addLink': {
79
+ author: 'did:test:123', timestamp: '2024-01-01',
80
+ data: { source: 's', predicate: 'p', target: 't' }, proof: { valid: true },
81
+ },
82
+ 'perspective.addLinkExpression': {
83
+ author: 'did:test:123', timestamp: '2024-01-01',
84
+ data: { source: 's', predicate: 'p', target: 't' }, proof: { valid: true },
85
+ },
86
+ 'perspective.addLinks': [
87
+ { author: 'did:test:123', timestamp: '2024-01-01', data: { source: 's', predicate: 'p', target: 't' }, proof: { valid: true } },
88
+ ],
89
+ 'perspective.removeLinks': [],
90
+ 'perspective.linkMutations': {
91
+ additions: [{ author: 'did:test:123', timestamp: '2024-01-01', data: { source: 'a', predicate: 'p', target: 't' }, proof: { valid: true } }],
92
+ removals: [],
93
+ },
94
+ 'perspective.updateLink': {
95
+ author: 'did:test:123', timestamp: '2024-01-01',
96
+ data: { source: 'new-s', predicate: 'p', target: 't' }, proof: { valid: true },
97
+ },
98
+ 'perspective.removeLink': true,
99
+ 'perspective.queryProlog': JSON.stringify([{ X: 'test' }]),
100
+ 'perspective.querySparql': JSON.stringify([{ id: '1' }]),
101
+ 'perspective.addSdna': true,
102
+ 'perspective.executeCommands': true,
103
+ 'perspective.createSubject': true,
104
+ 'perspective.getSubjectData': '{"name":"test"}',
105
+ 'perspective.createBatch': 'batch-id-1',
106
+ 'perspective.commitBatch': { additions: [], removals: [] },
107
+ 'perspective.subscribeQuery': true,
108
+ 'perspective.keepAliveQuery': true,
109
+ 'perspective.disposeQuery': true,
110
+
111
+ // ── Languages ──
112
+ 'language.all': [{ name: 'test-lang', address: 'lang://test', settings: '{}', icon: null, constructorIcon: null }],
113
+ 'language.get': (p: Record<string, unknown>) => ({
114
+ name: 'test-lang', address: p.address, settings: '{}', icon: null, constructorIcon: null,
115
+ }),
116
+ 'language.meta': {
117
+ name: 'test-lang', address: 'lang://test', description: 'A test language',
118
+ author: 'did:test:123', templated: false, templateSourceLanguageAddress: null,
119
+ templateAppliedParams: null, possibleTemplateParams: null, sourceCodeLink: null,
120
+ },
121
+ 'language.source': 'source-code-here',
122
+ 'language.writeSettings': true,
123
+ 'language.applyTemplate': { name: 'applied-lang', address: 'lang://applied' },
124
+ 'language.publish': {
125
+ name: 'published-lang', address: 'lang://published', description: 'Published',
126
+ author: 'did:test:123', templated: false,
127
+ },
128
+ 'language.remove': true,
129
+
130
+ // ── Neighbourhoods ──
131
+ 'neighbourhood.publish': 'neighbourhood://published',
132
+ 'neighbourhood.join': {
133
+ uuid: 'uuid-joined', name: 'joined-neighbourhood', sharedUrl: 'neighbourhood://url',
134
+ neighbourhood: {}, state: 'Synced',
135
+ },
136
+ 'neighbourhood.otherAgents': ['did:other:1', 'did:other:2'],
137
+ 'neighbourhood.hasTelepresence': true,
138
+ 'neighbourhood.onlineAgents': [{ did: 'did:test:1', status: new Perspective() }],
139
+ 'neighbourhood.setOnlineStatus': true,
140
+ 'neighbourhood.sendSignal': true,
141
+ 'neighbourhood.sendBroadcast': true,
142
+
143
+ // ── Expressions ──
144
+ 'expression.get': (p: Record<string, unknown>) => {
145
+ if (p.raw === true) return 'raw-expression-data';
146
+ return {
147
+ author: 'did:test:123', timestamp: '2024-01-01', data: '{"content":"hello"}',
148
+ language: { address: 'lang://test' }, proof: { valid: true },
149
+ };
150
+ },
151
+ 'expression.getMany': [
152
+ { author: 'did:test:1', timestamp: '2023-01-01', data: { type: 'test' }, language: { address: 'lang://test' }, proof: { valid: true } },
153
+ ],
154
+ 'expression.create': 'Qm-expression-hash',
155
+ 'expression.interactions': [{ label: 'interact1', name: 'doSomething', parameters: [] }],
156
+ 'expression.interact': 'interaction-result',
157
+
158
+ // ── Runtime ──
159
+ 'runtime.info': { ad4mExecutorVersion: '0.1.0', isUnlocked: true, isInitialized: true },
160
+ 'runtime.tlsDomain': 'test.domain.com',
161
+ 'runtime.quit': true,
162
+ 'runtime.openLink': true,
163
+ 'runtime.friends': ['did:friend:1', 'did:friend:2'],
164
+ 'runtime.addFriends': ['did:friend:1', 'did:friend:2', 'did:friend:3'],
165
+ 'runtime.removeFriends': ['did:friend:1'],
166
+ 'runtime.friendStatus': (p: Record<string, unknown>) => ({
167
+ author: p.did, timestamp: '2023-01-01', data: JSON.stringify({ recipe_name: 'test' }), proof: { valid: true },
168
+ }),
169
+ 'runtime.sendFriendMessage': true,
170
+ 'runtime.inbox': [{ author: 'did:friend:1', timestamp: '2024-01-01', data: new Perspective() }],
171
+ 'runtime.outbox': [],
172
+ 'runtime.notifications': [],
173
+ 'runtime.createNotification': true,
174
+ 'runtime.updateNotification': true,
175
+ 'runtime.grantNotification': true,
176
+ 'runtime.deleteNotification': true,
177
+ 'runtime.setStatus': true,
178
+ 'runtime.linkLanguageTemplates': ['lang://template1'],
179
+ 'runtime.addLinkLanguageTemplates': ['lang://template1', 'lang://template2'],
180
+ 'runtime.removeLinkLanguageTemplates': ['lang://template1'],
181
+ 'runtime.hcAgentInfos': ['hc-agent-info-1', 'hc-agent-info-2'],
182
+ 'runtime.addHcAgentInfos': true,
183
+ 'runtime.networkMetrics': 'metrics-data',
184
+ 'runtime.restartHolochain': true,
185
+ 'runtime.verifySignature': true,
186
+ 'runtime.exportData': true,
187
+ 'runtime.importData': { success: true, count: 5 },
188
+ 'runtime.freeHostingEnabled': false,
189
+ 'runtime.setFreeHostingEnabled': true,
190
+ 'runtime.computeLog': [],
191
+
192
+ // ── AI ──
193
+ 'ai.models': [{ id: 'model-1', name: 'GPT-Test', modelType: 'LLM', api: 'openai' }],
194
+ 'ai.addModel': 'model-new-id',
195
+ 'ai.updateModel': true,
196
+ 'ai.removeModel': true,
197
+ 'ai.setDefaultModel': true,
198
+ 'ai.getDefaultModel': { id: 'model-1', name: 'GPT-Test', modelType: 'LLM' },
199
+ 'ai.tasks': [{ taskId: 'task-1', name: 'summarize', modelId: 'model-1', systemPrompt: 'Summarize', promptExamples: [] }],
200
+ 'ai.addTask': { taskId: 'task-new', name: 'new-task', modelId: 'model-1', systemPrompt: 'Do stuff', promptExamples: [] },
201
+ 'ai.updateTask': { taskId: 'task-1', name: 'updated', modelId: 'model-1', systemPrompt: 'Updated', promptExamples: [] },
202
+ 'ai.removeTask': { taskId: 'task-1', name: 'summarize', modelId: 'model-1', systemPrompt: 'Summarize', promptExamples: [] },
203
+ 'ai.prompt': 'This is the AI response',
204
+ 'ai.modelLoadingStatus': { model: 'model-1', progress: 100, status: 'loaded' },
205
+
206
+ // ── Users (unauthenticated on server — empty token allowed) ──
207
+ 'user.create': { success: true, did: 'did:test:new-user' },
208
+ 'user.login': 'login-jwt-token',
209
+ 'user.verifyEmail': 'verified-token',
210
+ 'user.requestVerification': { success: true, message: 'Verification email sent', requiresPassword: false, isExistingUser: true },
211
+ 'user.list': [{ email: 'user@test.com', credits: 100, freeAccess: false }],
212
+ 'user.multiUserEnabled': false,
213
+ 'user.setMultiUserEnabled': true,
214
+ 'user.credits': true,
215
+ 'user.freeAccess': true,
216
+ 'user.wallet': '0x1234567890abcdef',
217
+ 'user.emailTest': (p: Record<string, unknown>) => {
218
+ if (p.action === 'get-code') return '123456';
219
+ return true;
220
+ },
221
+
222
+ // ── Hosting ──
223
+ 'hosting.info': { email: 'test@test.com' },
224
+ 'hosting.setHotWallet': true,
225
+ 'hosting.requestPayment': { paymentUrl: 'https://pay.test' },
226
+
227
+ // ── Runtime: host rates & Unyt ──
228
+ 'runtime.getHostRates': JSON.stringify([{ description: 'Link write', priceInHOT: 0.001 }]),
229
+ 'runtime.setHostRates': true,
230
+ 'runtime.unytAgentKey': 'unyt-agent-key-123',
231
+ 'runtime.unytHotAgentPubkey': 'unyt-hot-pubkey-456',
232
+ 'runtime.unytWalletBalance': '1000.50',
233
+ 'runtime.unytWalletHistory': '[]',
234
+ 'runtime.unytVersionInfo': '{"version":"0.1.0"}',
235
+ 'runtime.unytSetMembraneProof': { success: true, message: 'ok' },
236
+ 'runtime.unytReinstallDna': { success: true, message: 'reinstalled' },
237
+ 'runtime.unytSendHot': { success: true, message: 'sent' },
238
+ };
239
+
240
+ // ===================== MOCK WEBSOCKET =====================
241
+
242
+ /** Tracks the last RPC call for test assertions. */
243
+ let lastRpcCall: { type: string; params: Record<string, unknown> } | null = null;
244
+
245
+ class MockWebSocket {
246
+ static instances: MockWebSocket[] = [];
247
+ static CONNECTING = 0;
248
+ static OPEN = 1;
249
+ static CLOSING = 2;
250
+ static CLOSED = 3;
251
+
252
+ onopen: ((event: any) => void) | null = null;
253
+ onmessage: ((event: { data: string }) => void) | null = null;
254
+ onerror: ((event: any) => void) | null = null;
255
+ onclose: ((event: any) => void) | null = null;
256
+ readyState: number = MockWebSocket.CONNECTING;
257
+ closed = false;
258
+ url: string;
259
+
260
+ close() {
261
+ this.closed = true;
262
+ this.readyState = MockWebSocket.CLOSED;
263
+ this.onclose?.({});
264
+ }
265
+
266
+ send(data: string) {
267
+ try {
268
+ const parsed = JSON.parse(data);
269
+
270
+ // Ping/pong keepalive
271
+ if (parsed.type === 'ping') {
272
+ setTimeout(() => {
273
+ this.onmessage?.({ data: JSON.stringify({ type: 'pong' }) });
274
+ }, 0);
275
+ return;
276
+ }
277
+
278
+ // RPC call — resolve directly from MOCK_RESPONSES
279
+ const { id, type: msgType, params: rpcParams } = parsed;
280
+ const params = (rpcParams && typeof rpcParams === 'object')
281
+ ? rpcParams as Record<string, unknown>
282
+ : {} as Record<string, unknown>;
283
+
284
+ // Track for assertions
285
+ lastRpcCall = { type: msgType, params };
286
+
287
+ const handler = MOCK_RESPONSES[msgType];
288
+ if (handler === undefined) {
289
+ setTimeout(() => {
290
+ this.onmessage?.({ data: JSON.stringify({ id, error: { code: 404, message: `Unknown RPC type: ${msgType}` } }) });
291
+ }, 0);
292
+ return;
293
+ }
294
+
295
+ const result = typeof handler === 'function'
296
+ ? (handler as (p: Record<string, unknown>) => unknown)(params)
297
+ : handler;
298
+
299
+ setTimeout(() => {
300
+ this.onmessage?.({ data: JSON.stringify({ id, result }) });
301
+ }, 0);
302
+ } catch { /* malformed JSON — ignore */ }
303
+ }
304
+
305
+ /** Simulate server pushing an event to the client. */
306
+ emit(payload: unknown) {
307
+ this.onmessage?.({ data: JSON.stringify(payload) });
308
+ }
309
+
310
+ constructor(url: string) {
311
+ this.url = url;
312
+ MockWebSocket.instances.push(this);
313
+ // Simulate async connection open
314
+ setTimeout(() => {
315
+ if (this.readyState === MockWebSocket.CONNECTING) {
316
+ this.readyState = MockWebSocket.OPEN;
317
+ this.onopen?.({});
318
+ }
319
+ }, 0);
320
+ }
321
+ }
322
+
323
+ // Copy static constants to prototype (matches real WebSocket)
324
+ Object.defineProperty(MockWebSocket.prototype, 'CONNECTING', { value: 0 });
325
+ Object.defineProperty(MockWebSocket.prototype, 'OPEN', { value: 1 });
326
+ Object.defineProperty(MockWebSocket.prototype, 'CLOSING', { value: 2 });
327
+ Object.defineProperty(MockWebSocket.prototype, 'CLOSED', { value: 3 });
328
+
329
+ /** Return the last element of an array (avoids Array.prototype.at which needs ES2022 lib). */
330
+ function lastOf<T>(arr: T[]): T {
331
+ return arr[arr.length - 1];
332
+ }
333
+
334
+ // ===================== TEST SETUP =====================
335
+
336
+ let ad4m: Ad4mClient;
337
+
338
+ beforeAll(() => {
339
+ (global as any).WebSocket = MockWebSocket as any;
340
+ // Ad4mClient takes an HTTP base URL; apiClient converts to ws:// internally
341
+ ad4m = new Ad4mClient('http://127.0.0.1:12000', 'test-token', false);
342
+ });
343
+
344
+ afterAll(() => {
345
+ (global as any).WebSocket = originalWebSocket;
346
+ });
347
+
348
+ beforeEach(() => {
349
+ lastRpcCall = null;
350
+ MockWebSocket.instances = [];
351
+ });
352
+
353
+ // ===================== AGENT TESTS =====================
354
+ describe('AgentClient', () => {
355
+ test('me() returns agent with DID', async () => {
356
+ const agent = await ad4m.agent.me();
357
+ expect(agent.did).toBe('did:test:123');
358
+ expect(agent.directMessageLanguage).toBe('lang://dm');
66
359
  });
67
360
 
361
+ test('status() returns agent status', async () => {
362
+ const status = await ad4m.agent.status();
363
+ expect(status.isInitialized).toBe(true);
364
+ expect(status.isUnlocked).toBe(true);
365
+ });
68
366
 
69
- // Creating the WebSocket server
70
- const wsServer = new WebSocketServer({
71
- // This is the `httpServer` we created in a previous step.
72
- server: httpServer,
73
- // Pass a different path here if your ApolloServer serves at
74
- // a different path.
75
- path: '/subscriptions',
367
+ test('generate() sends passphrase and returns status', async () => {
368
+ const status = await ad4m.agent.generate('secret123');
369
+ expect(lastRpcCall!.params.passphrase).toBe('secret123');
370
+ expect(status.did).toBe('did:test:generated');
76
371
  });
77
372
 
78
- // Hand in the schema we just created and have the
79
- // WebSocketServer start listening.
80
- serverCleanup = useServer({ schema }, wsServer);
373
+ test('lock() locks the agent', async () => {
374
+ const status = await ad4m.agent.lock('secret123');
375
+ expect(lastRpcCall!.params.passphrase).toBe('secret123');
376
+ expect(status.isUnlocked).toBe(false);
377
+ });
81
378
 
82
- await server.start()
83
- app.use('/graphql', expressMiddleware(server));
84
- // server.applyMiddleware({ app });
85
- httpServer.listen({ port })
86
- return port
87
- }
379
+ test('unlock() unlocks the agent', async () => {
380
+ const status = await ad4m.agent.unlock('secret123');
381
+ expect(lastRpcCall!.params.passphrase).toBe('secret123');
382
+ expect(lastRpcCall!.params.holochain).toBe(true);
383
+ expect(status.isUnlocked).toBe(true);
384
+ });
88
385
 
89
- describe('Ad4mClient', () => {
90
- let ad4mClient
91
- let apolloClient
386
+ test('import() imports a DID keystore', async () => {
387
+ const status = await ad4m.agent.import({
388
+ did: 'did:test:import', didDocument: 'doc', keystore: 'ks', passphrase: 'pass',
389
+ });
390
+ expect(lastRpcCall!.params.did).toBe('did:test:import');
391
+ expect(status.did).toBe('did:test:imported');
392
+ });
393
+
394
+ test('byDID() fetches agent by DID', async () => {
395
+ const agent = await ad4m.agent.byDID('did:test:other');
396
+ expect(agent.did).toBe('did:test:other');
397
+ });
92
398
 
93
- beforeAll(async () => {
94
- let port = await createGqlServer(4000);
399
+ test('signMessage() signs a message', async () => {
400
+ const signed = await ad4m.agent.signMessage('hello');
401
+ expect(lastRpcCall!.params.message).toBe('hello');
402
+ expect(signed).toBe('signed-message-data');
403
+ });
95
404
 
96
- console.log(`GraphQL server listening at: http://localhost:${port}/graphql`)
405
+ test('isLocked() returns lock status', async () => {
406
+ const locked = await ad4m.agent.isLocked();
407
+ expect(locked).toBe(false);
408
+ });
97
409
 
98
- const wsLink = new GraphQLWsLink(createClient({
99
- url: `ws://localhost:${port}/subscriptions`,
100
- webSocketImpl: Websocket
101
- }));
410
+ test('getEntanglementProofs() returns proofs', async () => {
411
+ const proofs = await ad4m.agent.getEntanglementProofs();
412
+ expect(proofs).toEqual(['proof1', 'proof2']);
413
+ });
102
414
 
415
+ test('addEntanglementProofs() sends proofs', async () => {
416
+ const result = await ad4m.agent.addEntanglementProofs([{ did: 'd', deviceKey: 'k', deviceKeyType: 't', didSigningKeyId: 'sk', deviceKeySignedByDid: 'sig1', didSignedByDeviceKey: 'sig2' }]);
417
+ expect(result).toHaveLength(1);
418
+ });
103
419
 
420
+ test('deleteEntanglementProofs() deletes proofs', async () => {
421
+ const result = await ad4m.agent.deleteEntanglementProofs([{ did: 'd', deviceKey: 'k', deviceKeyType: 't', didSigningKeyId: 'sk', deviceKeySignedByDid: 'sig1', didSignedByDeviceKey: 'sig2' }]);
422
+ expect(result).toEqual([]);
423
+ });
104
424
 
105
- apolloClient = new ApolloClient({
106
- link: wsLink,
107
- cache: new InMemoryCache(),
108
- defaultOptions: {
109
- watchQuery: {
110
- fetchPolicy: 'network-only',
111
- nextFetchPolicy: 'network-only'
112
- },
113
- }
425
+ test('requestCapability() returns request ID', async () => {
426
+ const id = await ad4m.agent.requestCapability({ appName: 'test', appDesc: 'test', appDomain: 'test', appUrl: 'test', capabilities: [] } as any);
427
+ expect(id).toBe('request-id-123');
428
+ });
429
+
430
+ test('permitCapability() returns token', async () => {
431
+ const token = await ad4m.agent.permitCapability('auth-string');
432
+ expect(token).toBe('permitted-token');
433
+ });
434
+
435
+ test('generateJwt() returns JWT', async () => {
436
+ const jwt = await ad4m.agent.generateJwt('req-1', 'rand-1');
437
+ expect(lastRpcCall!.params.requestId).toBe('req-1');
438
+ expect(jwt).toBe('jwt-token-abc');
439
+ });
440
+
441
+ test('getApps() returns apps list', async () => {
442
+ const apps = await ad4m.agent.getApps();
443
+ expect(apps).toHaveLength(1);
444
+ });
445
+
446
+ test('removeApp() removes an app', async () => {
447
+ const result = await ad4m.agent.removeApp('app1');
448
+ expect(result).toEqual([]);
449
+ });
450
+
451
+ test('revokeToken() revokes a token', async () => {
452
+ const result = await ad4m.agent.revokeToken('app1');
453
+ expect(result).toEqual([]);
454
+ });
455
+
456
+ test('agent-updated event unwraps nested agent payload', async () => {
457
+ const freshClient = new Ad4mClient('http://127.0.0.1:12000', 'test-token', false);
458
+ const callback = jest.fn();
459
+ freshClient.agent.addUpdatedListener(callback);
460
+ freshClient.agent.subscribeAgentUpdated();
461
+
462
+ const ws = lastOf(MockWebSocket.instances);
463
+
464
+ ws.emit({
465
+ type: 'agent-updated',
466
+ agent: { did: 'did:test:updated', directMessageLanguage: 'lang://dm2', perspective: null, isInitialized: true, isUnlocked: true },
114
467
  });
115
468
 
116
- console.log("GraphQL client connected")
117
-
118
- ad4mClient = new Ad4mClient(apolloClient)
119
-
120
- console.log("GraphQL client connected")
121
- })
122
-
123
- describe('.agent', () => {
124
- it('me() smoke test', async () => {
125
- const agent = await ad4mClient.agent.me()
126
- expect(agent.did).toBe('did:ad4m:test')
127
- })
128
-
129
- it('status() smoke test', async () => {
130
- const agentStatus = await ad4mClient.agent.status()
131
- expect(agentStatus.did).toBe('did:ad4m:test')
132
- expect(agentStatus.isUnlocked).toBe(false)
133
- })
134
-
135
- it('import() smoke test', async () => {
136
- const did = "did:test:test"
137
- const didDocument = "did document test"
138
- const keystore = "test"
139
- const passphrase = "secret"
140
-
141
- const agentStatus = await ad4mClient.agent.import({
142
- did, didDocument, keystore, passphrase
143
- })
144
-
145
- expect(agentStatus.did).toBe(did)
146
- expect(agentStatus.didDocument).toBe(didDocument)
147
- expect(agentStatus.isInitialized).toBe(true)
148
- expect(agentStatus.isUnlocked).toBe(true)
149
- })
150
-
151
- it('generate() smoke test', async () => {
152
- const agentStatus = await ad4mClient.agent.generate("passphrase")
153
- expect(agentStatus.did).toBeDefined()
154
- expect(agentStatus.isInitialized).toBeTruthy()
155
- })
156
-
157
- it('lock() smoke test', async () => {
158
- const agentStatus = await ad4mClient.agent.lock('secret')
159
- expect(agentStatus.did).toBe("did:ad4m:test")
160
- expect(agentStatus.isUnlocked).toBe(false)
161
- })
162
-
163
- it('unlock() smoke test', async () => {
164
- const agentStatus = await ad4mClient.agent.unlock('secret', false)
165
- expect(agentStatus.did).toBe("did:ad4m:test")
166
- expect(agentStatus.isUnlocked).toBe(true)
167
- })
168
-
169
- it('byDID() smoke test', async () => {
170
- const agent = await ad4mClient.agent.byDID('did:method:12345')
171
- expect(agent.did).toBe('did:method:12345')
172
- })
173
-
174
- it('updatePublicPerspective() smoke test', async () => {
175
- const perspective = new Perspective()
176
- const link = new LinkExpression()
177
- link.author = 'did:method:12345'
178
- link.timestamp = new Date().toString()
179
- link.data = new Link({source: 'root', target: 'perspective://Qm34589a3ccc0'})
180
- link.proof = { signature: 'asdfasdf', key: 'asdfasdf' }
181
- perspective.links.push(link)
182
-
183
- const agent = await ad4mClient.agent.updatePublicPerspective(perspective)
184
- expect(agent.did).toBe('did:ad4m:test')
185
- expect(agent.perspective.links.length).toBe(1)
186
- expect(agent.perspective.links[0].data.source).toBe('root')
187
- expect(agent.perspective.links[0].data.target).toBe('perspective://Qm34589a3ccc0')
188
- })
189
-
190
- it('mutatePublicPerspective() smoke test', async () => {
191
- let additionLink = new Link({source: 'root', target: 'perspective://Qm34589a3ccc0'})
192
- const removalLink = new LinkExpression()
193
- removalLink.author = "did:ad4m:test"
194
- removalLink.timestamp = Date.now().toString()
195
- removalLink.data = {
196
- source: 'root2',
197
- target: 'perspective://Qm34589a3ccc0'
198
- }
199
- removalLink.proof = {
200
- signature: '',
201
- key: '',
202
- valid: true
203
- }
469
+ expect(callback).toHaveBeenCalledTimes(1);
470
+ const received = callback.mock.calls[0][0];
471
+ expect(received.did).toBe('did:test:updated');
472
+ expect(received.directMessageLanguage).toBe('lang://dm2');
473
+ expect(received).not.toHaveProperty('type');
474
+ });
204
475
 
476
+ test('agent-status-changed event unwraps nested agent payload', async () => {
477
+ const freshClient = new Ad4mClient('http://127.0.0.1:12000', 'test-token', false);
478
+ const callback = jest.fn();
479
+ freshClient.agent.addAgentStatusChangedListener(callback);
480
+ freshClient.agent.subscribeAgentStatusChanged();
205
481
 
206
- //Note; here we dont get the links above since mutatePublicPerspective relies on a snapshot which returns the default test link for perspectives
207
- const agent = await ad4mClient.agent.mutatePublicPerspective({additions: [additionLink], removals: [removalLink]} as LinkMutations)
208
- expect(agent.did).toBe('did:ad4m:test')
209
- expect(agent.perspective.links.length).toBe(1)
210
- expect(agent.perspective.links[0].data.source).toBe('root')
211
- expect(agent.perspective.links[0].data.target).toBe('neighbourhood://Qm12345')
212
- })
213
-
214
- it('updateDirectMessageLanguage() smoke test', async () => {
215
- const agent = await ad4mClient.agent.updateDirectMessageLanguage("abcd")
216
- expect(agent.directMessageLanguage).toBe('abcd')
217
- })
218
-
219
- it('entanglementProof() smoke tests', async () => {
220
- const addProof = await ad4mClient.agent.addEntanglementProofs([new EntanglementProofInput("did:key:hash", "did-key-id", "ethereum", "ethAddr", "sig", "sig2")]);
221
- expect(addProof[0].did).toBe("did:key:hash")
222
- expect(addProof[0].didSigningKeyId).toBe("did-key-id")
223
- expect(addProof[0].deviceKeyType).toBe("ethereum")
224
- expect(addProof[0].deviceKey).toBe("ethAddr")
225
- expect(addProof[0].deviceKeySignedByDid).toBe("sig")
226
- expect(addProof[0].didSignedByDeviceKey).toBe("sig2")
227
-
228
- const getProofs = await ad4mClient.agent.getEntanglementProofs();
229
- expect(getProofs[0].did).toBe("did:key:hash")
230
- expect(getProofs[0].didSigningKeyId).toBe("did-key-id")
231
- expect(getProofs[0].deviceKeyType).toBe("ethereum")
232
- expect(getProofs[0].deviceKey).toBe("ethAddr")
233
- expect(getProofs[0].deviceKeySignedByDid).toBe("sig")
234
- expect(getProofs[0].didSignedByDeviceKey).toBe("sig2")
235
-
236
- const deleteProofs = await ad4mClient.agent.deleteEntanglementProofs([new EntanglementProofInput("did:key:hash", "did-key-id", "ethereum", "ethAddr", "sig", "sig2")]);
237
- expect(deleteProofs[0].did).toBe("did:key:hash")
238
- expect(deleteProofs[0].didSigningKeyId).toBe("did-key-id")
239
- expect(deleteProofs[0].deviceKeyType).toBe("ethereum")
240
- expect(deleteProofs[0].deviceKey).toBe("ethAddr")
241
- expect(deleteProofs[0].deviceKeySignedByDid).toBe("sig")
242
- expect(deleteProofs[0].didSignedByDeviceKey).toBe("sig2")
243
-
244
- const preflight = await ad4mClient.agent.entanglementProofPreFlight("ethAddr", "ethereum");
245
- expect(preflight.did).toBe("did:key:hash")
246
- expect(preflight.didSigningKeyId).toBe("did-key-id")
247
- expect(preflight.deviceKeyType).toBe("ethereum")
248
- expect(preflight.deviceKey).toBe("ethAddr")
249
- expect(preflight.deviceKeySignedByDid).toBe("sig")
250
- expect(preflight.didSignedByDeviceKey).toBe(null)
251
- })
252
-
253
- it('requestCapability() smoke tests', async () => {
254
- const requestId = await ad4mClient.agent.requestCapability({
255
- appName: "demo-app",
256
- appDesc: "demo-desc",
257
- appDomain: "demo.test.org",
258
- appUrl: "https://demo-link",
259
- appIconPath: "/some/image/path",
260
- capabilities: [
261
- {
262
- with: {
263
- "domain":"agent",
264
- "pointers":["*"]
265
- } as ResourceInput,
266
- can: ["QUERY"]
267
- }] as CapabilityInput[]
268
- } as AuthInfoInput)
269
- expect(requestId).toBe("test-request-id")
270
- })
271
-
272
-
273
- it('agentGetApps() smoke tests', async () => {
274
- const apps = await ad4mClient.agent.getApps()
275
- expect(apps.length).toBe(0)
276
- })
277
-
278
- it('agentPermitCapability() smoke tests', async () => {
279
- const rand = await ad4mClient.agent.permitCapability('{"requestId":"4f30e2e2-d307-4f2b-b0a0-6dac4ca4af26","auth":{"appName":"demo-app","appDesc":"demo-desc","appUrl":"demo-url","capabilities":[{"with":{"domain":"agent","pointers":["*"]},"can":["QUERY"]}]}}')
280
- expect(rand).toBe("123")
281
- })
282
-
283
- it('agentGenerateJwt() smoke tests', async () => {
284
- const jwt = await ad4mClient.agent.generateJwt("test-request-id", "123")
285
- expect(jwt).toBe("test-jwt")
286
- })
287
-
288
- it('agentRevokeToken() smoke tests', async () => {
289
- const newApps = await ad4mClient.agent.revokeToken('test-request-id')
290
- expect(newApps.length).toBe(1)
291
- expect(newApps[0].revoked).toBe(true)
292
- })
293
-
294
- it('agentRemoveToken() smoke tests', async () => {
295
- const newApps = await ad4mClient.agent.removeApp('test-request-id')
296
- expect(newApps.length).toBe(0)
297
- })
298
-
299
- it('agentIsLocked() smoke tests', async () => {
300
- const status = await ad4mClient.agent.isLocked()
301
- expect(status).toBe(false)
302
- })
303
-
304
- it('agentSignMessage() smoke tests', async () => {
305
- const sig = await ad4mClient.agent.signMessage("test-message")
306
- expect(sig.signature).toBe("test-message-signature")
307
- expect(sig.publicKey).toBe("test-public-key")
308
- })
309
- })
310
-
311
- describe('.expression', () => {
312
- it('get() smoke test', async () => {
313
- const nonExisting = await ad4mClient.expression.get("wrong address")
314
- expect(nonExisting).toBeNull()
315
-
316
- const expression = await ad4mClient.expression.get("neighbourhood://Qm123")
317
- expect(expression).toBeDefined()
318
- expect(expression.author).toBe('did:ad4m:test')
319
- expect(expression.data).toBe("{\"type\":\"test expression\",\"content\":\"test\"}")
320
- })
321
-
322
- it('getMany() smoke test', async () => {
323
- const getMany = await ad4mClient.expression.getMany(["hash1", "hash2"]);
324
- expect(getMany.length).toBe(2);
325
- expect(getMany[0].author).toBe('did:ad4m:test');
326
- expect(getMany[0].data).toBe("{\"type\":\"test expression\",\"content\":\"test\"}");
327
- expect(getMany[1]).toBeNull();
328
- })
329
-
330
- it('getRaw() smoke test', async () => {
331
- const nonExisting = await ad4mClient.expression.getRaw("wrong address")
332
- expect(nonExisting).toBeNull()
333
-
334
- const expressionRaw = await ad4mClient.expression.getRaw("neighbourhood://Qm123")
335
- expect(expressionRaw).toBeDefined()
336
- const expression = JSON.parse(expressionRaw)
337
- expect(expression.author).toBe('did:ad4m:test')
338
- expect(expression.data).toBe("{\"type\":\"test expression\",\"content\":\"test\"}")
339
- })
340
-
341
- it('create() smoke test', async () => {
342
- const address = await ad4mClient.expression.create('content', 'Qmabcdf')
343
- expect(address.toString()).toBe("Qm1234")
344
-
345
- const address2 = await ad4mClient.expression.create({content: 'json'}, 'Qmabcdf')
346
- expect(address2.toString()).toBe("Qm1234")
347
- })
348
-
349
- it('interactions() smoke test', async () => {
350
- const interactions = await ad4mClient.expression.interactions('Qmabcdf')
351
- expect(interactions.length).toBe(1)
352
- const i = interactions[0]
353
- expect(i.label).toBe("Add a comment")
354
- expect(i.name).toBe("add_comment")
355
- expect(i.parameters.length).toBe(1)
356
- const param = i.parameters[0]
357
- expect(param.name).toBe('comment')
358
- expect(param.type).toBe('string')
359
- })
360
-
361
- it('interact() smoke test', async () => {
362
- const call = new InteractionCall('add_comment', { content: 'test'})
363
- const result = await ad4mClient.expression.interact('Qmabcdf', call)
364
- expect(result.toString()).toBe("test result")
365
- })
366
- })
367
-
368
- describe('.langauges', () => {
369
- it('byAddress() smoke test', async () => {
370
- const language = await ad4mClient.languages.byAddress('test-language-address')
371
- expect(language.address).toBe('test-language-address')
372
- })
373
-
374
- it('byFilter() smoke test', async () => {
375
- const languages = await ad4mClient.languages.byFilter('linksAdapter')
376
- expect(languages.length).toBe(1)
377
- expect(languages[0].name).toBe('test-links-language')
378
- })
379
-
380
- it('all() smoke test', async () => {
381
- const languages = await ad4mClient.languages.all()
382
- expect(languages.length).toBe(1)
383
- expect(languages[0].name).toBe('test-links-language')
384
- })
385
-
386
- it('writeSettings() smoke test', async () => {
387
- const result = await ad4mClient.languages.writeSettings(
388
- 'test-language-address',
389
- JSON.stringify({testSetting: true})
390
- )
391
- expect(result).toBe(true)
392
- })
393
-
394
- it('applyTemplateAndPublish() smoke test', async () => {
395
- const language = await ad4mClient.languages.applyTemplateAndPublish(
396
- 'languageHash',
397
- '{"name": "test-templating"}',
398
- )
399
- expect(language.name).toBe('languageHash-clone')
400
- })
401
-
402
- it('publish() smoke test', async () => {
403
- let input = new LanguageMetaInput()
404
- input.name = "test language 1"
405
- input.description = "Language for smoke testing"
406
- input.possibleTemplateParams = ['uuid', 'name', 'membrane']
407
- input.sourceCodeLink = "https://github.com/perspect3vism/test-language"
408
-
409
- const languageMeta = await ad4mClient.languages.publish(
410
- '/some/language/path/',
411
- input,
412
- )
413
- expect(languageMeta.name).toBe(input.name)
414
- expect(languageMeta.description).toBe(input.description)
415
- expect(languageMeta.possibleTemplateParams).toStrictEqual(input.possibleTemplateParams)
416
- expect(languageMeta.sourceCodeLink).toBe(input.sourceCodeLink)
417
- expect(languageMeta.address).toBe("Qm12345")
418
- expect(languageMeta.author).toBe("did:test:me")
419
- expect(languageMeta.templateSourceLanguageAddress).toBe("Qm12345")
420
- expect(languageMeta.templateAppliedParams).toBe(JSON.stringify({uuid: 'asdfsdaf', name: 'test template'}))
421
- })
422
-
423
- it('meta() smoke test', async () => {
424
- let input = new LanguageMetaInput()
425
- input.name = "test language 1"
426
- input.description = "Language for smoke testing"
427
- input.possibleTemplateParams = ['uuid', 'name', 'membrane']
428
- input.sourceCodeLink = "https://github.com/perspect3vism/test-language"
429
-
430
- const languageMeta = await ad4mClient.languages.meta("Qm12345")
431
-
432
- expect(languageMeta.name).toBe("test-language")
433
- expect(languageMeta.address).toBe("Qm12345")
434
- expect(languageMeta.description).toBe("Language meta for testing")
435
- expect(languageMeta.author).toBe("did:test:me")
436
- expect(languageMeta.templated).toBe(true)
437
- expect(languageMeta.templateSourceLanguageAddress).toBe("Qm12345")
438
- expect(languageMeta.templateAppliedParams).toBe(JSON.stringify({uuid: 'asdfsdaf', name: 'test template'}))
439
- expect(languageMeta.possibleTemplateParams).toStrictEqual(['uuid', 'name'])
440
- expect(languageMeta.sourceCodeLink).toBe("https://github.com/perspect3vism/ad4m")
441
- })
442
-
443
- it('source() smoke test', async () => {
444
- const source = await ad4mClient.languages.source("Qm12345")
445
- expect(source).toBe("var test = 'language source code'")
446
- })
447
-
448
- it('remove() smoke test', async () => {
449
- const result = await ad4mClient.languages.remove("Qm12345");
450
- expect(result).toBe(true);
451
- })
452
- })
453
-
454
- describe('.neighbourhood', () => {
455
- const testPerspective = new Perspective()
456
- const linkExpr = new LinkExpression()
457
- linkExpr.author = 'did:method:12345'
458
- linkExpr.timestamp = new Date().toString()
459
- linkExpr.data = new Link({source: 'root', target: 'perspective://Qm34589a3ccc0'})
460
- linkExpr.proof = { signature: 'asdfasdf', key: 'asdfasdf' }
461
- testPerspective.links.push(linkExpr)
462
-
463
- const testUnsignedPerspective = new PerspectiveUnsignedInput()
464
- const link = new Link({
465
- source: 'root', target: 'perspective://Qm34589a3ccc0'
466
- })
467
- testUnsignedPerspective.links.push(link)
468
-
469
- it('publishFromPerspective() smoke test', async () => {
470
- const expressionRef = await ad4mClient.neighbourhood.publishFromPerspective('UUID', 'test-link-lang', new Perspective())
471
- expect(expressionRef).toBe('neighbourhood://neighbourhoodAddress')
472
- })
473
-
474
- it('joinFromUrl() smoke test', async () => {
475
- const perspective = await ad4mClient.neighbourhood.joinFromUrl('neighbourhood://Qm3sdf3dfwhsafd')
476
- expect(perspective.sharedUrl).toBe('neighbourhood://Qm3sdf3dfwhsafd')
477
- expect(perspective.uuid).toBeTruthy()
478
- expect(perspective.name).toBeTruthy()
479
- })
480
-
481
- it('hasTelepresenceAdapter() smoke test', async () => {
482
- const result = await ad4mClient.neighbourhood.hasTelepresenceAdapter('01234')
483
- expect(result).toBe(true)
484
- })
485
-
486
- it('otherAgents() smoke test', async () => {
487
- const agents = await ad4mClient.neighbourhood.otherAgents('01234')
488
- expect(agents.length).toBe(1)
489
- expect(agents[0]).toBe('did:test:other')
490
- })
491
-
492
- it('onlineAgents() smoke test', async () => {
493
- const agents = await ad4mClient.neighbourhood.onlineAgents('01234')
494
- expect(agents.length).toBe(1)
495
- expect(agents[0].did).toBe('did:test:online')
496
- const status = agents[0].status
497
- expect(status.author).toBe('did:ad4m:test')
498
- expect(status.data.links.length).toBe(1)
499
- const link = status.data.links[0]
500
- expect(link.author).toBe('did:ad4m:test')
501
- expect(link.data.source).toBe('root')
502
- })
503
-
504
- it('setOnlineStatus() smoke test', async () => {
505
- const result = await ad4mClient.neighbourhood.setOnlineStatus('01234', testPerspective)
506
- expect(result).toBe(true)
507
- })
508
-
509
- it('setOnlineStatusU() smoke test', async () => {
510
- const result = await ad4mClient.neighbourhood.setOnlineStatusU('01234', testUnsignedPerspective)
511
- expect(result).toBe(true)
512
- })
513
-
514
- it('sendSignal() smoke test', async () => {
515
- const result = await ad4mClient.neighbourhood.sendSignal('01234', "did:test:recipient", testPerspective)
516
- expect(result).toBe(true)
517
- })
518
-
519
- it('sendSignaU() smoke test', async () => {
520
- const result = await ad4mClient.neighbourhood.sendSignalU('01234', "did:test:recipient", testUnsignedPerspective)
521
- expect(result).toBe(true)
522
- })
523
-
524
- it('sendBroadcast() smoke test', async () => {
525
- const result = await ad4mClient.neighbourhood.sendBroadcast('01234', testPerspective)
526
- expect(result).toBe(true)
527
- })
528
-
529
- it('sendBroadcastU() smoke test', async () => {
530
- const result = await ad4mClient.neighbourhood.sendBroadcastU('01234', testUnsignedPerspective)
531
- expect(result).toBe(true)
532
- })
533
-
534
- it('can be accessed via NeighbourhoodProxy', async () => {
535
- const perspective = await ad4mClient.perspective.byUUID('00001')
536
- const nh = await perspective.getNeighbourhoodProxy()
537
-
538
- expect(await nh.hasTelepresenceAdapter()).toBe(true)
539
- expect(await nh.otherAgents()).toStrictEqual(['did:test:other'])
540
- expect((await nh.onlineAgents())[0].did).toStrictEqual('did:test:online')
541
- expect(await nh.setOnlineStatus(testPerspective)).toBe(true)
542
- expect(await nh.sendSignal('did:test:recipient', testPerspective)).toBe(true)
543
- expect(await nh.sendBroadcast(testPerspective)).toBe(true)
544
-
545
- nh.addSignalHandler((perspective) => {
546
- //..
547
- })
548
- })
549
- })
550
-
551
- describe('.perspective', () => {
552
- it('all() smoke test',async () => {
553
- const perspectives = await ad4mClient.perspective.all()
554
- expect(perspectives.length).toBe(2)
555
- const p1 = perspectives[0]
556
- const p2 = perspectives[1]
557
- expect(p1.name).toBe('test-perspective-1')
558
- expect(p2.name).toBe('test-perspective-2')
559
- expect(p1.uuid).toBe('00001')
560
- expect(p2.uuid).toBe('00002')
561
- expect(p2.sharedUrl).toBe('neighbourhood://Qm12345')
562
- expect(p2.neighbourhood.data.linkLanguage).toBe("language://Qm12345")
563
- })
564
-
565
- it('byUUID() smoke test', async () => {
566
- const p = await ad4mClient.perspective.byUUID('00004')
567
- expect(p.uuid).toBe('00004')
568
- expect(p.name).toBe('test-perspective-1')
569
- })
570
-
571
- it('snapshotByUUID() smoke test', async () => {
572
- const ps = await ad4mClient.perspective.snapshotByUUID('00004')
573
- expect(ps.links.length).toBe(1)
574
- expect(ps.links[0].author).toBe('did:ad4m:test')
575
- expect(ps.links[0].data.source).toBe('root')
576
- expect(ps.links[0].data.target).toBe('neighbourhood://Qm12345')
577
- })
578
-
579
- it('publishSnapshotByUUID() smoke test', async () => {
580
- const snapshotUrl = await ad4mClient.perspective.publishSnapshotByUUID('00004')
581
- expect(snapshotUrl).toBe('perspective://Qm12345')
582
-
583
- })
584
-
585
- it('queryLinks() smoke test', async () => {
586
- const links = await ad4mClient.perspective.queryLinks('000001', {source: 'root'})
587
- expect(links.length).toBe(1)
588
- expect(links[0].data.source).toBe('root')
589
- expect(links[0].data.target).toBe('neighbourhood://Qm12345')
590
- })
591
-
592
- it('queryProlog() smoke test', async () => {
593
- let result = await ad4mClient.perspective.queryProlog('000001', "link(X, 2).")
594
- expect(result.length).toBe(1)
595
- expect(result[0].X).toBe(1)
596
-
597
- const proxy = await ad4mClient.perspective.byUUID('000001')
598
- result = await proxy.infer("link(X, 2).")
599
- expect(result.length).toBe(1)
600
- expect(result[0].X).toBe(1)
601
- })
602
-
603
- it('add() smoke test', async () => {
604
- const p = await ad4mClient.perspective.add('p-name')
605
- expect(p.uuid).toBe('00006')
606
- expect(p.name).toBe('p-name')
607
- })
608
-
609
- it('update() smoke test', async () => {
610
- const p = await ad4mClient.perspective.update('00001', 'new-name')
611
- expect(p.uuid).toBe('00001')
612
- expect(p.name).toBe('new-name')
613
- })
614
-
615
- it('remove() smoke test', async () => {
616
- const r = await ad4mClient.perspective.remove('000001')
617
- expect(r).toBeTruthy()
618
- })
619
-
620
- it('addLink() smoke test', async () => {
621
- const link = await ad4mClient.perspective.addLink('00001', {source: 'root', target: 'lang://Qm123', predicate: 'p'})
622
- expect(link.author).toBe('did:ad4m:test')
623
- expect(link.data.source).toBe('root')
624
- expect(link.data.predicate).toBe('p')
625
- expect(link.data.target).toBe('lang://Qm123')
626
- expect(link.status).toBe('shared')
627
- })
628
-
629
- it('addLocalLink() smoke test', async () => {
630
- const link = await ad4mClient.perspective.addLink('00001', {source: 'root', target: 'lang://Qm123', predicate: 'p'}, 'local')
631
- expect(link.author).toBe('did:ad4m:test')
632
- expect(link.data.source).toBe('root')
633
- expect(link.data.predicate).toBe('p')
634
- expect(link.data.target).toBe('lang://Qm123')
635
- expect(link.status).toBe('local')
636
- })
637
-
638
- it('addLinks() smoke test', async () => {
639
- const links = await ad4mClient.perspective.addLinks('00001', [
640
- {source: 'root', target: 'lang://Qm123', predicate: 'p'},
641
- {source: 'root', target: 'lang://Qm123', predicate: 'p'}
642
- ])
643
- expect(links.length).toBe(2)
644
- expect(links[0].author).toBe('did:ad4m:test')
645
- expect(links[0].data.source).toBe('root')
646
- expect(links[0].data.predicate).toBe('p')
647
- expect(links[0].data.target)
648
- })
649
-
650
- it('removeLinks() smoke test', async () => {
651
- const links = await ad4mClient.perspective.removeLinks('00001', [
652
- {author: '', timestamp: '', proof: {signature: '', key: ''}, data: {source: 'root', target: 'lang://Qm123', predicate: 'p'}},
653
- {author: '', timestamp: '', proof: {signature: '', key: ''}, data: {source: 'root', target: 'lang://Qm123', predicate: 'p'}}
654
- ])
655
- expect(links.length).toBe(2)
656
- expect(links[0].author).toBe('did:ad4m:test')
657
- expect(links[0].data.source).toBe('root')
658
- expect(links[0].data.predicate).toBe('p')
659
- expect(links[0].data.target)
660
- })
661
-
662
- it('linkMutations() smoke test', async () => {
663
- const mutations = await ad4mClient.perspective.linkMutations('00001', {
664
- additions: [
665
- {source: 'root', target: 'lang://Qm123', predicate: 'p'},
666
- {source: 'root', target: 'lang://Qm123', predicate: 'p'}
667
- ],
668
- removals: [
669
- {author: '', timestamp: '', proof: {signature: '', key: ''}, data: {source: 'root', target: 'lang://Qm123', predicate: 'p'}},
670
- {author: '', timestamp: '', proof: {signature: '', key: ''}, data: {source: 'root', target: 'lang://Qm123', predicate: 'p'}}
671
- ]
672
- });
673
- expect(mutations.additions.length).toBe(2)
674
- expect(mutations.removals.length).toBe(2)
675
-
676
- expect(mutations.additions[0].author).toBe('did:ad4m:test')
677
- expect(mutations.additions[0].data.source).toBe('root')
678
- expect(mutations.additions[0].data.predicate).toBe('p')
679
- expect(mutations.additions[0].data.target).toBe('lang://Qm123')
680
-
681
- expect(mutations.removals[0].author).toBe('did:ad4m:test')
682
- expect(mutations.removals[0].data.source).toBe('root')
683
- expect(mutations.removals[0].data.predicate).toBe('p')
684
- expect(mutations.removals[0].data.target).toBe('lang://Qm123')
685
- })
686
-
687
- it('addLinkExpression() smoke test', async () => {
688
- const testLink = new LinkExpression()
689
- testLink.author = "did:ad4m:test"
690
- testLink.timestamp = Date.now().toString()
691
- testLink.data = {
692
- source: 'root',
693
- target: 'lang://Qm123',
694
- predicate: 'p'
695
- }
696
- testLink.proof = {
697
- signature: '',
698
- key: '',
699
- valid: true
700
- }
701
- const link = await ad4mClient.perspective.addLinkExpression('00001', testLink);
702
- expect(link.author).toBe('did:ad4m:test')
703
- expect(link.data.source).toBe('root')
704
- expect(link.data.predicate).toBe('p')
705
- expect(link.data.target).toBe('lang://Qm123')
706
- })
707
-
708
- it('addListener() smoke test', async () => {
709
- let perspective = await ad4mClient.perspective.byUUID('00004')
710
-
711
- const testLink = new LinkExpression()
712
- testLink.author = "did:ad4m:test"
713
- testLink.timestamp = Date.now().toString()
714
- testLink.data = {
715
- source: 'root',
716
- target: 'neighbourhood://Qm12345'
717
- }
718
- testLink.proof = {
719
- signature: '',
720
- key: '',
721
- valid: true
722
- }
482
+ const ws = lastOf(MockWebSocket.instances);
723
483
 
724
- const linkAdded = jest.fn()
725
- const linkRemoved = jest.fn()
484
+ ws.emit({
485
+ type: 'agent-status-changed',
486
+ agent: { did: 'did:test:status', isInitialized: true, isUnlocked: false },
487
+ });
726
488
 
727
- await perspective.addListener('link-added', linkAdded)
728
- const link = new LinkExpressionInput()
729
- link.source = 'root'
730
- link.target = 'perspective://Qm34589a3ccc0'
731
- await perspective.add(link)
489
+ expect(callback).toHaveBeenCalledTimes(1);
490
+ const received = callback.mock.calls[0][0];
491
+ expect(received.did).toBe('did:test:status');
492
+ expect(received.isUnlocked).toBe(false);
493
+ expect(received).not.toHaveProperty('type');
494
+ });
495
+ });
496
+
497
+ // ===================== PERSPECTIVE TESTS =====================
498
+ describe('PerspectiveClient', () => {
499
+ test('all() returns perspective proxies', async () => {
500
+ const perspectives = await ad4m.perspective.all();
501
+ expect(perspectives).toHaveLength(1);
502
+ expect(perspectives[0].uuid).toBe('uuid-1');
503
+ });
732
504
 
733
- expect(linkAdded).toBeCalledTimes(1)
734
- expect(linkRemoved).toBeCalledTimes(0)
505
+ test('byUUID() returns a perspective proxy', async () => {
506
+ const p = await ad4m.perspective.byUUID('uuid-1');
507
+ expect(p).not.toBeNull();
508
+ expect(p!.uuid).toBe('uuid-1');
509
+ });
735
510
 
736
- perspective = await ad4mClient.perspective.byUUID('00004')
511
+ test('snapshotByUUID() returns snapshot', async () => {
512
+ const snapshot = await ad4m.perspective.snapshotByUUID('uuid-1');
513
+ expect(snapshot).not.toBeNull();
514
+ expect(snapshot!.links).toHaveLength(1);
515
+ });
737
516
 
738
- await perspective.addListener('link-removed', linkRemoved)
739
- await perspective.remove(testLink)
517
+ test('add() creates a new perspective', async () => {
518
+ const p = await ad4m.perspective.add('new-perspective');
519
+ expect(lastRpcCall!.params.name).toBe('new-perspective');
520
+ expect(p.uuid).toBe('uuid-new');
521
+ });
740
522
 
741
- expect(linkAdded).toBeCalledTimes(1)
742
- expect(linkRemoved).toBeCalledTimes(1)
743
- })
523
+ test('update() updates a perspective name', async () => {
524
+ const p = await ad4m.perspective.update('uuid-1', 'renamed');
525
+ expect(lastRpcCall!.params.name).toBe('renamed');
526
+ expect(p.name).toBe('renamed');
527
+ });
744
528
 
745
- it('removeListener() smoke test', async () => {
746
- let perspective = await ad4mClient.perspective.byUUID('00004')
529
+ test('remove() deletes a perspective', async () => {
530
+ const result = await ad4m.perspective.remove('uuid-1');
531
+ expect(result.perspectiveRemove).toBe(true);
532
+ });
747
533
 
748
- const linkAdded = jest.fn()
534
+ test('queryLinks() queries links with parameters', async () => {
535
+ const links = await ad4m.perspective.queryLinks('uuid-1', new LinkQuery({ source: 'src', predicate: 'pred' }));
536
+ expect(links).toHaveLength(1);
537
+ expect(lastRpcCall!.params.source).toBe('src');
538
+ expect(lastRpcCall!.params.predicate).toBe('pred');
539
+ });
749
540
 
750
- await perspective.addListener('link-added', linkAdded)
751
- await perspective.add({source: 'root', target: 'neighbourhood://Qm12345'})
541
+ test('addLink() adds a link', async () => {
542
+ const link = await ad4m.perspective.addLink('uuid-1', { source: 's', predicate: 'p', target: 't' });
543
+ expect(link.data.source).toBe('s');
544
+ expect(lastRpcCall!.params.link).toEqual({ source: 's', predicate: 'p', target: 't' });
545
+ });
752
546
 
753
- expect(linkAdded).toBeCalledTimes(1)
547
+ test('addLinks() adds multiple links', async () => {
548
+ const links = await ad4m.perspective.addLinks('uuid-1', [
549
+ { source: 's1', predicate: 'p', target: 't1' },
550
+ { source: 's2', predicate: 'p', target: 't2' },
551
+ ]);
552
+ expect(links).toHaveLength(1);
553
+ expect(lastRpcCall!.params.links).toHaveLength(2);
554
+ });
754
555
 
755
- linkAdded.mockClear();
556
+ test('removeLinks() forwards batchId in the bulk remove request', async () => {
557
+ const removed = await ad4m.perspective.removeLinks('uuid-1', [{
558
+ author: 'a', timestamp: 't',
559
+ data: { source: 's', predicate: 'p', target: 't' },
560
+ proof: { valid: true },
561
+ }] as any, 'batch-id-1');
562
+ expect(removed).toHaveLength(0);
563
+ expect(lastRpcCall!.type).toBe('perspective.removeLinks');
564
+ expect(lastRpcCall!.params.links).toHaveLength(1);
565
+ expect(lastRpcCall!.params.batchId).toBe('batch-id-1');
566
+ });
567
+
568
+ test('updateLink() updates a link', async () => {
569
+ const link = await ad4m.perspective.updateLink('uuid-1',
570
+ { author: 'a', timestamp: 't', data: { source: 's', predicate: 'p', target: 't' }, proof: { valid: true } } as any,
571
+ { source: 'new-s', predicate: 'p', target: 't' },
572
+ );
573
+ expect(link.data.source).toBe('new-s');
574
+ });
575
+
576
+ test('removeLink() removes a link', async () => {
577
+ const result = await ad4m.perspective.removeLink('uuid-1', {
578
+ author: 'a', timestamp: 't',
579
+ data: { source: 's', predicate: 'p', target: 't' },
580
+ proof: { valid: true },
581
+ } as any);
582
+ expect(result).toBe(true);
583
+ });
756
584
 
757
- perspective = await ad4mClient.perspective.byUUID('00004')
585
+ test('linkMutations() applies mutations', async () => {
586
+ const result = await ad4m.perspective.linkMutations('uuid-1', {
587
+ additions: [{ source: 'a', predicate: 'p', target: 't' }],
588
+ removals: [],
589
+ });
590
+ expect(result.additions).toHaveLength(1);
591
+ });
758
592
 
759
- await perspective.removeListener('link-added', linkAdded)
760
- await perspective.add({source: 'root', target: 'neighbourhood://Qm123456'})
593
+ test('addSdna() adds SDNA', async () => {
594
+ const result = await ad4m.perspective.addSdna('uuid-1', 'TestClass', 'code', 'subject_class');
595
+ expect(result).toBe(true);
596
+ });
761
597
 
762
- expect(linkAdded).toBeCalledTimes(1)
763
- })
598
+ test('queryProlog() runs prolog query', async () => {
599
+ const result = await ad4m.perspective.queryProlog('uuid-1', 'test(X)');
600
+ expect(result).toEqual([{ X: 'test' }]);
601
+ });
764
602
 
765
- it('addSyncStateChangeListener() smoke test', async () => {
766
- let perspective = await ad4mClient.perspective.byUUID('00004')
603
+ test('subscribeToQueryUpdates() routes through the WebSocket endpoint', async () => {
604
+ const freshClient = new Ad4mClient('http://127.0.0.1:12000', 'test-token', false);
605
+ const callback = jest.fn();
606
+ const unsubscribe = freshClient.perspective.subscribeToQueryUpdates('sub-1', callback);
607
+ const ws = lastOf(MockWebSocket.instances);
767
608
 
768
- const syncState = jest.fn()
609
+ expect(ws.url).toBe('ws://127.0.0.1:12000/api/v1/ws?token=test-token');
769
610
 
770
- await perspective.addSyncStateChangeListener(syncState)
771
- await perspective.add({source: 'root', target: 'neighbourhood://Qm12345'})
611
+ unsubscribe();
612
+ expect(ws.closed).toBe(true);
613
+ });
772
614
 
773
- expect(syncState).toBeCalledTimes(1)
774
- expect(syncState).toBeCalledWith(PerspectiveState.Synced)
775
- })
615
+ test('perspective lifecycle subscriptions use the WebSocket endpoint', async () => {
616
+ const freshClient = new Ad4mClient('http://127.0.0.1:12000', 'test-token', false);
617
+ freshClient.perspective.addPerspectiveAddedListener(jest.fn());
618
+ freshClient.perspective.subscribePerspectiveAdded();
776
619
 
777
- it('updateLink() smoke test', async () => {
778
- const link = await ad4mClient.perspective.updateLink(
779
- '00001',
780
- {author: '', timestamp: '', proof: {signature: '', key: ''}, data:{source: 'root', target: 'none'}},
781
- {source: 'root', target: 'lang://Qm123', predicate: 'p'})
782
- expect(link.author).toBe('did:ad4m:test')
783
- expect(link.data.source).toBe('root')
784
- expect(link.data.predicate).toBe('p')
785
- expect(link.data.target).toBe('lang://Qm123')
786
- })
620
+ const ws = lastOf(MockWebSocket.instances);
621
+ expect(ws.url).toBe('ws://127.0.0.1:12000/api/v1/ws?token=test-token');
622
+ });
787
623
 
788
- it('removeLink() smoke test', async () => {
789
- const r = await ad4mClient.perspective.removeLink('00001', {author: '', timestamp: '', proof: {signature: '', key: ''}, data:{source: 'root', target: 'none'}})
790
- expect(r).toBeTruthy()
791
- })
624
+ test('perspective-scoped link subscriptions ignore events for other perspectives', async () => {
625
+ const freshClient = new Ad4mClient('http://127.0.0.1:12000', 'test-token', false);
626
+ const linkAddedCallback = jest.fn();
627
+ const linkRemovedCallback = jest.fn();
628
+ const linkUpdatedCallback = jest.fn();
792
629
 
793
- it('addSdna() smoke test', async () => {
794
- const r = await ad4mClient.perspective.addSdna('00001', "Test", 'subject_class("Test", test)', 'subject_class');
795
- expect(r).toBeTruthy()
796
- })
630
+ await freshClient.perspective.addPerspectiveLinkAddedListener('uuid-1', [linkAddedCallback]);
631
+ await freshClient.perspective.addPerspectiveLinkRemovedListener('uuid-1', [linkRemovedCallback]);
632
+ await freshClient.perspective.addPerspectiveLinkUpdatedListener('uuid-1', [linkUpdatedCallback]);
797
633
 
798
- it('executeCommands() smoke test', async () => {
799
- const result = await ad4mClient.perspective.executeCommands(
800
- '00001',
801
- 'command1; command2',
802
- 'expression1',
803
- 'param1, param2'
804
- );
805
- expect(result).toBeTruthy();
806
- })
634
+ const ws = lastOf(MockWebSocket.instances);
635
+ expect(ws.url).toBe('ws://127.0.0.1:12000/api/v1/ws?token=test-token');
807
636
 
808
- it('getSubjectData() smoke test', async () => {
809
- const result = await ad4mClient.perspective.getSubjectData('00001', 'Test', 'test');
810
- expect(result).toBe("");
637
+ // Events for a different perspective should be ignored
638
+ ws.emit({
639
+ type: 'link-added',
640
+ perspectiveUuid: 'uuid-2',
641
+ link: { author: 'did:test:123', timestamp: '2024-01-01T00:00:00.000Z', data: { source: 'test://other-added', predicate: 'test://has', target: 'test://value' }, proof: { valid: true } },
642
+ });
643
+ ws.emit({
644
+ type: 'link-removed',
645
+ perspectiveUuid: 'uuid-2',
646
+ link: { author: 'did:test:123', timestamp: '2024-01-01T00:00:00.000Z', data: { source: 'test://other-removed', predicate: 'test://has', target: 'test://value' }, proof: { valid: true } },
647
+ });
648
+ ws.emit({
649
+ type: 'link-updated',
650
+ perspectiveUuid: 'uuid-2',
651
+ oldLink: { author: 'did:test:123', timestamp: '2024-01-01T00:00:00.000Z', data: { source: 'test://other-old', predicate: 'test://has', target: 'test://value' }, proof: { valid: true } },
652
+ newLink: { author: 'did:test:123', timestamp: '2024-01-01T00:00:00.000Z', data: { source: 'test://other-new', predicate: 'test://has', target: 'test://value' }, proof: { valid: true } },
811
653
  });
812
654
 
813
- it('createSubject() smoke test', async () => {
814
- const result = await ad4mClient.perspective.createSubject(
815
- '00001',
816
- 'command1; command2',
817
- 'expression1',
818
- );
819
- expect(result).toBeTruthy();
820
- })
821
- })
822
-
823
- describe('.runtime', () => {
824
- it('quit() smoke test', async () => {
825
- const r = await ad4mClient.runtime.quit()
826
- expect(r).toBeTruthy()
827
- })
828
-
829
- it('openLink() smoke test', async () => {
830
- const r = await ad4mClient.runtime.openLink('https://ad4m.dev')
831
- expect(r).toBeTruthy()
832
- })
833
-
834
- it('addTrustedAgents() smoke test', async () => {
835
- const r = await ad4mClient.runtime.addTrustedAgents(["agentPubKey"]);
836
- expect(r).toStrictEqual([ 'agentPubKey' ])
837
- })
838
-
839
- it('deleteTrustedAgents() smoke test', async () => {
840
- const r = await ad4mClient.runtime.deleteTrustedAgents(["agentPubKey"]);
841
- expect(r).toStrictEqual([])
842
- })
843
-
844
- it('getTrustedAgents() smoke test', async () => {
845
- const r = await ad4mClient.runtime.getTrustedAgents();
846
- expect(r).toStrictEqual([ 'agentPubKey' ])
847
- })
848
-
849
- it('addKnownLinkLanguageTemplates() smoke test', async () => {
850
- const r = await ad4mClient.runtime.addKnownLinkLanguageTemplates(["Qm1337"]);
851
- expect(r).toStrictEqual([ 'Qm1337' ])
852
- })
853
-
854
- it('removeKnownLinkLanguageTemplates() smoke test', async () => {
855
- const r = await ad4mClient.runtime.removeKnownLinkLanguageTemplates(["Qm12345abcdef"]);
856
- expect(r).toStrictEqual([])
857
- })
858
-
859
- it('knownLinkLanguageTemplates() smoke test', async () => {
860
- const r = await ad4mClient.runtime.knownLinkLanguageTemplates();
861
- expect(r).toStrictEqual([ 'Qm12345abcdef' ])
862
- })
863
-
864
- it('addFriends() smoke test', async () => {
865
- const r = await ad4mClient.runtime.addFriends(["did:test:another_friend"]);
866
- expect(r).toStrictEqual([ 'did:test:another_friend' ])
867
- })
868
-
869
- it('removeFriends() smoke test', async () => {
870
- const r = await ad4mClient.runtime.removeFriends(["did:test:friend"]);
871
- expect(r).toStrictEqual([])
872
- })
873
-
874
- it('friends() smoke test', async () => {
875
- const r = await ad4mClient.runtime.friends();
876
- expect(r).toStrictEqual([ 'did:test:friend' ])
877
- })
878
-
879
- it('hcAgentInfos smoke test', async () => {
880
- const agentInfos = JSON.parse(await ad4mClient.runtime.hcAgentInfos())
881
- expect(agentInfos.length).toBe(4)
882
- expect(agentInfos[0].agent).toBeDefined()
883
- expect(agentInfos[0].signature).toBeDefined()
884
- expect(agentInfos[0].agent_info).toBeDefined()
885
- })
886
-
887
- it('hcAddAgentInfos smoke test', async () => {
888
- await ad4mClient.runtime.hcAddAgentInfos("agent infos string")
889
- })
890
-
891
- it('ververifyStringSignedByDid() smoke test', async () => {
892
- const verify = await ad4mClient.runtime.verifyStringSignedByDid("did", "didSigningKeyId", "data", "signedData")
893
- expect(verify).toBe(true)
894
- })
895
-
896
- it('setStatus smoke test', async () => {
897
- const link = new LinkExpression()
898
- link.author = 'did:method:12345'
899
- link.timestamp = new Date().toString()
900
- link.data = new Link({source: 'root', target: 'perspective://Qm34589a3ccc0'})
901
- link.proof = { signature: 'asdfasdf', key: 'asdfasdf' }
902
- await ad4mClient.runtime.setStatus(new Perspective([link]))
903
- })
904
-
905
- it('friendStatus smoke test', async () => {
906
- const statusExpr = await ad4mClient.runtime.friendStatus("did:ad4m:test")
907
- expect(statusExpr.author).toBe("did:ad4m:test")
908
- const statusPersp = statusExpr.data
909
- expect(statusPersp.links.length).toBe(1)
910
- expect(statusPersp.links[0].data.source).toBe('root')
911
- expect(statusPersp.links[0].data.target).toBe('neighbourhood://Qm12345')
912
- })
913
-
914
- it('friendSendMessage smoke test', async () => {
915
- const link = new LinkExpression()
916
- link.author = 'did:method:12345'
917
- link.timestamp = new Date().toString()
918
- link.data = new Link({source: 'root', target: 'perspective://Qm34589a3ccc0'})
919
- link.proof = { signature: 'asdfasdf', key: 'asdfasdf' }
920
- await ad4mClient.runtime.friendSendMessage('did:ad4m:test', new Perspective([link]))
921
- })
922
-
923
- it('messageInbox smoke test', async () => {
924
- const messages = await ad4mClient.runtime.messageInbox()
925
- expect(messages.length).toBe(1)
926
- const message = messages[0]
927
- expect(message.author).toBe("did:ad4m:test")
928
- const messagePersp = message.data
929
- expect(messagePersp.links.length).toBe(1)
930
- expect(messagePersp.links[0].data.source).toBe('root')
931
- expect(messagePersp.links[0].data.target).toBe('neighbourhood://Qm12345')
932
- })
933
-
934
- it('messageOutbox smoke test', async () => {
935
- const sentMessages = await ad4mClient.runtime.messageOutbox("did:ad4m:test")
936
- expect(sentMessages.length).toBe(1)
937
- const sentMessage = sentMessages[0]
938
- expect(sentMessage.recipient).toBe("did:test:recipient")
939
- const message = sentMessage.message
940
- expect(message.author).toBe("did:ad4m:test")
941
- const messagePersp = message.data
942
- expect(messagePersp.links.length).toBe(1)
943
- expect(messagePersp.links[0].data.source).toBe('root')
944
- expect(messagePersp.links[0].data.target).toBe('neighbourhood://Qm12345')
945
- })
946
-
947
- it('runtimeInfo smoke test', async () => {
948
- const runtimeInfo = await ad4mClient.runtime.info();
949
- expect(runtimeInfo.ad4mExecutorVersion).toBe("x.x.x");
950
- expect(runtimeInfo.isInitialized).toBe(true);
951
- expect(runtimeInfo.isUnlocked).toBe(true);
952
- })
953
-
954
- it('requestInstallNotification smoke test', async () => {
955
- await ad4mClient.runtime.requestInstallNotification({
956
- description: "Test description",
957
- appName: "Test app name",
958
- appUrl: "https://example.com",
959
- appIconPath: "https://example.com/icon",
960
- trigger: "triple(X, ad4m://has_type, flux://message)",
961
- perspectiveIds: ["u983ud-jdhh38d"],
962
- webhookUrl: "https://example.com/webhook",
963
- webhookAuth: "test-auth",
964
- });
965
- })
966
-
967
- it('grantNotification smoke test', async () => {
968
- await ad4mClient.runtime.grantNotification("test-notification");
969
- })
970
-
971
- it('notifications smoke test', async () => {
972
- const notifications = await ad4mClient.runtime.notifications();
973
- expect(notifications.length).toBe(1);
974
- })
975
-
976
- it('updateNotification smoke test', async () => {
977
- await ad4mClient.runtime.updateNotification("test-notification", {
978
- description: "Test description",
979
- appName: "Test app name",
980
- appUrl: "https://example.com",
981
- appIconPath: "https://example.com/icon",
982
- trigger: "triple(X, ad4m://has_type, flux://message)",
983
- perspectiveIds: ["u983ud-jdhh38d"],
984
- webhookUrl: "https://example.com/webhook",
985
- webhookAuth: "test-auth",
986
- });
987
- })
988
-
989
- it('removeNotification smoke test', async () => {
990
- await ad4mClient.runtime.removeNotification("test-notification");
991
- })
992
- })
993
-
994
- describe('Ad4mClient subscriptions', () => {
995
- describe('ad4mClient without subscription', () => {
996
- let ad4mClientWithoutSubscription: Ad4mClient
997
-
998
- beforeEach(() => {
999
- ad4mClientWithoutSubscription = new Ad4mClient(apolloClient, false)
1000
- })
1001
-
1002
- it('agent subscribeAgentUpdated smoke test', async () => {
1003
- const agentUpdatedCallback = jest.fn()
1004
- ad4mClientWithoutSubscription.agent.addUpdatedListener(agentUpdatedCallback)
1005
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1006
- expect(agentUpdatedCallback).toBeCalledTimes(0)
1007
-
1008
- ad4mClientWithoutSubscription.agent.subscribeAgentUpdated()
1009
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1010
- await ad4mClientWithoutSubscription.agent.updateDirectMessageLanguage("lang://test");
1011
- expect(agentUpdatedCallback).toBeCalledTimes(1)
1012
- })
1013
-
1014
- it('agent subscribeAgentStatusChanged smoke test', async () => {
1015
- const agentStatusChangedCallback = jest.fn()
1016
- ad4mClientWithoutSubscription.agent.addAgentStatusChangedListener(agentStatusChangedCallback)
1017
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1018
- expect(agentStatusChangedCallback).toBeCalledTimes(0)
1019
-
1020
- ad4mClientWithoutSubscription.agent.subscribeAgentStatusChanged()
1021
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1022
- await ad4mClientWithoutSubscription.agent.unlock("test", false);
1023
- expect(agentStatusChangedCallback).toBeCalledTimes(1)
1024
- })
1025
-
1026
- it('agent subscribeAppsChanged smoke test', async () => {
1027
- const appsChangedCallback = jest.fn()
1028
- ad4mClientWithoutSubscription.agent.addAppChangedListener(appsChangedCallback)
1029
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1030
- expect(appsChangedCallback).toBeCalledTimes(0)
1031
-
1032
- ad4mClientWithoutSubscription.agent.subscribeAppsChanged()
1033
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1034
- await ad4mClientWithoutSubscription.agent.removeApp("test");
1035
- expect(appsChangedCallback).toBeCalledTimes(1)
1036
- })
1037
-
1038
- it('perspective subscribePerspectiveAdded smoke test', async () => {
1039
- const perspectiveAddedCallback = jest.fn()
1040
- ad4mClientWithoutSubscription.perspective.addPerspectiveAddedListener(perspectiveAddedCallback)
1041
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1042
- expect(perspectiveAddedCallback).toBeCalledTimes(0)
1043
-
1044
- ad4mClientWithoutSubscription.perspective.subscribePerspectiveAdded()
1045
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1046
- await ad4mClientWithoutSubscription.perspective.add('p-name-1');
1047
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1048
- expect(perspectiveAddedCallback).toBeCalledTimes(1)
1049
- })
1050
-
1051
- it('perspective subscribePerspectiveUpdated smoke test', async () => {
1052
- const perspectiveUpdatedCallback = jest.fn()
1053
- ad4mClientWithoutSubscription.perspective.addPerspectiveUpdatedListener(perspectiveUpdatedCallback)
1054
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1055
- expect(perspectiveUpdatedCallback).toBeCalledTimes(0)
1056
-
1057
- ad4mClientWithoutSubscription.perspective.subscribePerspectiveUpdated()
1058
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1059
- await ad4mClientWithoutSubscription.perspective.update('00006', 'p-test2');
1060
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1061
- expect(perspectiveUpdatedCallback).toBeCalledTimes(1)
1062
- })
1063
-
1064
- it('perspective subscribePerspectiveRemoved smoke test', async () => {
1065
- const perspectiveRemovedCallback = jest.fn()
1066
- ad4mClientWithoutSubscription.perspective.addPerspectiveRemovedListener(perspectiveRemovedCallback)
1067
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1068
- expect(perspectiveRemovedCallback).toBeCalledTimes(0)
1069
-
1070
- ad4mClientWithoutSubscription.perspective.subscribePerspectiveRemoved()
1071
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1072
- await ad4mClientWithoutSubscription.perspective.remove('00006');
1073
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1074
- expect(perspectiveRemovedCallback).toBeCalledTimes(1)
1075
- })
1076
- })
1077
-
1078
- describe('ad4mClient with subscription', () => {
1079
- let ad4mClientWithSubscription
1080
-
1081
- beforeEach(() => {
1082
- ad4mClientWithSubscription = new Ad4mClient(apolloClient, true)
1083
- })
1084
-
1085
- it('agent subscribeAgentUpdated smoke test', async () => {
1086
- const agentUpdatedCallback = jest.fn()
1087
- ad4mClientWithSubscription.agent.addUpdatedListener(agentUpdatedCallback)
1088
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1089
- expect(agentUpdatedCallback).toBeCalledTimes(0)
1090
-
1091
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1092
- await ad4mClientWithSubscription.agent.updateDirectMessageLanguage("lang://test");
1093
- expect(agentUpdatedCallback).toBeCalledTimes(1)
1094
- })
1095
-
1096
- it('agent subscribeAgentStatusChanged smoke test', async () => {
1097
- const agentStatusChangedCallback = jest.fn()
1098
- ad4mClientWithSubscription.agent.addAgentStatusChangedListener(agentStatusChangedCallback)
1099
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1100
- expect(agentStatusChangedCallback).toBeCalledTimes(0)
1101
-
1102
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1103
- await ad4mClientWithSubscription.agent.unlock("test", false);
1104
- expect(agentStatusChangedCallback).toBeCalledTimes(1)
1105
- })
1106
-
1107
- it('agent subscribeAppsChanged smoke test', async () => {
1108
- const appsChangedCallback = jest.fn()
1109
- ad4mClientWithSubscription.agent.addAppChangedListener(appsChangedCallback)
1110
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1111
- expect(appsChangedCallback).toBeCalledTimes(0)
1112
-
1113
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1114
- await ad4mClientWithSubscription.agent.removeApp("test");
1115
- expect(appsChangedCallback).toBeCalledTimes(1)
1116
- })
1117
-
1118
- it('perspective subscribePerspectiveAdded smoke test', async () => {
1119
- const perspectiveAddedCallback = jest.fn()
1120
- ad4mClientWithSubscription.perspective.addPerspectiveAddedListener(perspectiveAddedCallback)
1121
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1122
- expect(perspectiveAddedCallback).toBeCalledTimes(0)
1123
-
1124
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1125
- await ad4mClientWithSubscription.perspective.add('p-name-1');
1126
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1127
- expect(perspectiveAddedCallback).toBeCalledTimes(1)
1128
- })
1129
-
1130
- it('perspective subscribePerspectiveUpdated smoke test', async () => {
1131
- const perspectiveUpdatedCallback = jest.fn()
1132
- ad4mClientWithSubscription.perspective.addPerspectiveUpdatedListener(perspectiveUpdatedCallback)
1133
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1134
- expect(perspectiveUpdatedCallback).toBeCalledTimes(0)
1135
-
1136
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1137
- await ad4mClientWithSubscription.perspective.update('00006', 'p-test2');
1138
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1139
- expect(perspectiveUpdatedCallback).toBeCalledTimes(1)
1140
- })
1141
-
1142
- it('perspective subscribePerspectiveRemoved smoke test', async () => {
1143
- const perspectiveRemovedCallback = jest.fn()
1144
- ad4mClientWithSubscription.perspective.addPerspectiveRemovedListener(perspectiveRemovedCallback)
1145
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1146
- expect(perspectiveRemovedCallback).toBeCalledTimes(0)
1147
-
1148
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1149
- await ad4mClientWithSubscription.perspective.remove('00006');
1150
- await new Promise<void>(resolve => setTimeout(resolve, 100))
1151
- expect(perspectiveRemovedCallback).toBeCalledTimes(1)
1152
- })
1153
- })
1154
- })
1155
- describe('.ai', () => {
1156
- it('getModels smoke test', async () => {
1157
- const models = await ad4mClient.ai.getModels();
1158
- expect(models).toBeDefined();
1159
- expect(Array.isArray(models)).toBe(true);
1160
- if (models.length > 0) {
1161
- const model = models[0];
1162
- expect(model).toHaveProperty('name');
1163
- expect(model).toHaveProperty('id');
1164
- expect(model).toHaveProperty('modelType');
1165
- if (model.api) {
1166
- expect(model.api).toHaveProperty('baseUrl');
1167
- expect(model.api).toHaveProperty('apiKey');
1168
- expect(model.api).toHaveProperty('model');
1169
- expect(model.api).toHaveProperty('apiType');
1170
- }
1171
- if (model.local) {
1172
- expect(model.local).toHaveProperty('fileName');
1173
- if (model.local.tokenizerSource) {
1174
- expect(model.local.tokenizerSource).toHaveProperty('repo');
1175
- expect(model.local.tokenizerSource).toHaveProperty('revision');
1176
- expect(model.local.tokenizerSource).toHaveProperty('fileName');
1177
- }
1178
- expect(model.local).toHaveProperty('huggingfaceRepo');
1179
- expect(model.local).toHaveProperty('revision');
1180
- }
1181
- }
1182
- })
1183
-
1184
- it('addModel smoke test', async () => {
1185
- const newModel = {
1186
- name: "New Test Model",
1187
- api: {
1188
- baseUrl: "https://api.newexample.com",
1189
- apiKey: "new-test-api-key",
1190
- apiType: "OpenAi",
1191
- model: "gpt-4o"
1192
- },
1193
- local: {
1194
- fileName: "new-test-model.bin",
1195
- tokenizerSource: {
1196
- repo: "test-repo",
1197
- revision: "main",
1198
- fileName: "tokenizer.json"
1199
- },
1200
- huggingfaceRepo: "test-repo",
1201
- revision: "main"
1202
- },
1203
- modelType: "LLM"
1204
- };
1205
- const result = await ad4mClient.ai.addModel(newModel);
1206
- expect(result).toBe("new-model-id");
1207
- })
1208
-
1209
- it('updateModel smoke test', async () => {
1210
- const modelId = "test-model-id";
1211
- const updatedModel = {
1212
- name: "Updated Test Model",
1213
- api: {
1214
- baseUrl: "https://api.updatedexample.com",
1215
- apiKey: "updated-test-api-key",
1216
- apiType: "OpenAi",
1217
- model: "gpt-4o"
1218
- },
1219
- local: {
1220
- fileName: "updated-test-model.bin",
1221
- tokenizerSource: {
1222
- repo: "test-repo",
1223
- revision: "main",
1224
- fileName: "tokenizer.json"
1225
- },
1226
- huggingfaceRepo: "test-repo",
1227
- revision: "main"
1228
- },
1229
- modelType: "LLM"
1230
- };
1231
- const result = await ad4mClient.ai.updateModel(modelId, updatedModel);
1232
- expect(result).toBe(true);
1233
- })
1234
-
1235
- it('removeModel smoke test', async () => {
1236
- const modelName = "Test Model to Remove";
1237
- const result = await ad4mClient.ai.removeModel(modelName);
1238
- expect(result).toBe(true);
1239
- })
1240
-
1241
- // skip this because ModelType is a string enum that can't be annotated for
1242
- // TypeGraphQL without changing it to a real enum.
1243
- // This all works with the Rust resolvers in AD4M,
1244
- // as the intergration tests demonstrate.
1245
- it.skip('setDefaultModel and getDefaultModel smoke test', async () => {
1246
- const modelName = "Test Model";
1247
- const modelType = "LLM";
1248
-
1249
- const setResult = await ad4mClient.ai.setDefaultModel(modelType, modelName);
1250
- expect(setResult).toBe(true);
1251
-
1252
- const defaultModel = await ad4mClient.ai.getDefaultModel(modelType);
1253
- expect(defaultModel).toBeDefined();
1254
- expect(defaultModel.name).toBe("Default Test Model");
1255
- expect(defaultModel.api).toBeDefined();
1256
- expect(defaultModel.api.baseUrl).toBe("https://api.example.com");
1257
- expect(defaultModel.api.apiKey).toBe("test-api-key");
1258
- expect(defaultModel.api.apiType).toBe("OpenAi");
1259
- expect(defaultModel.local).toBeDefined();
1260
- expect(defaultModel.local.fileName).toBe("test-model.bin");
1261
- if (defaultModel.local.tokenizerSource) {
1262
- expect(defaultModel.local.tokenizerSource.repo).toBe("test-repo");
1263
- expect(defaultModel.local.tokenizerSource.revision).toBe("main");
1264
- expect(defaultModel.local.tokenizerSource.fileName).toBe("tokenizer.json");
1265
- }
1266
- expect(defaultModel.local.huggingfaceRepo).toBe("test-repo");
1267
- expect(defaultModel.local.revision).toBe("main");
1268
- expect(defaultModel.modelType).toBe(modelType);
1269
- })
1270
-
1271
- it('embed()', async () => {
1272
- const vector = await ad4mClient.ai.embed("model", "test ets")
1273
- expect(vector[0]).toEqual(0)
1274
- expect(vector[1]).toEqual(10)
1275
- expect(vector[2]).toEqual(20)
1276
- expect(vector[3]).toEqual(30)
1277
- })
1278
-
1279
- it('tasks()', async () => {
1280
- const tasks = await ad4mClient.ai.tasks()
1281
- expect(tasks.length).toBe(2)
1282
- expect(tasks[0].taskId).toBe("task_id")
1283
- expect(tasks[0].modelId).toBe("modelId")
1284
- })
1285
-
1286
- it('addTask()', async () => {
1287
- const task = await ad4mClient.ai.addTask("task_name", "model_id", "system prompt", []);
1288
- expect(task.name).toBe("task_name")
1289
- expect(task.taskId).toBe("task_id")
1290
- expect(task.modelId).toBe("model_id")
1291
- expect(task.systemPrompt).toBe("system prompt")
655
+ expect(linkAddedCallback).not.toHaveBeenCalled();
656
+ expect(linkRemovedCallback).not.toHaveBeenCalled();
657
+ expect(linkUpdatedCallback).not.toHaveBeenCalled();
658
+
659
+ // Events for the correct perspective should fire
660
+ const addedLink = {
661
+ author: 'did:test:123', timestamp: '2024-01-01T00:00:00.000Z',
662
+ data: { source: 'test://added', predicate: 'test://has', target: 'test://value' }, proof: { valid: true },
663
+ };
664
+ const removedLink = {
665
+ author: 'did:test:123', timestamp: '2024-01-01T00:00:00.000Z',
666
+ data: { source: 'test://removed', predicate: 'test://has', target: 'test://value' }, proof: { valid: true },
667
+ };
668
+
669
+ ws.emit({ type: 'link-added', perspectiveUuid: 'uuid-1', link: addedLink });
670
+ ws.emit({ type: 'link-removed', perspectiveUuid: 'uuid-1', link: removedLink });
671
+ ws.emit({
672
+ type: 'link-updated',
673
+ perspectiveUuid: 'uuid-1',
674
+ oldLink: { author: 'did:test:123', timestamp: '2024-01-01T00:00:00.000Z', data: { source: 'test://updated-old', predicate: 'test://has', target: 'test://value' }, proof: { valid: true } },
675
+ newLink: { author: 'did:test:123', timestamp: '2024-01-01T00:00:00.000Z', data: { source: 'test://updated-new', predicate: 'test://has', target: 'test://value' }, proof: { valid: true } },
1292
676
  });
1293
677
 
1294
- it('removeTask()', async () => {
1295
- const task = await ad4mClient.ai.removeTask("task_id", "system prompt", []);
1296
- expect(task.taskId).toBe("task_id")
1297
- expect(task.modelId).toBe("model_id")
1298
- expect(task.systemPrompt).toBe("system prompt")
678
+ expect(linkAddedCallback).toHaveBeenCalledWith(addedLink);
679
+ expect(linkRemovedCallback).toHaveBeenCalledWith(removedLink);
680
+ expect(linkUpdatedCallback).toHaveBeenCalledTimes(1);
681
+ });
682
+
683
+ test('runtime exception subscriptions normalize PascalCase exception types', async () => {
684
+ const freshClient = new Ad4mClient('http://127.0.0.1:12000', 'test-token', false);
685
+ const callback = jest.fn(() => null);
686
+ freshClient.runtime.addExceptionCallback(callback);
687
+ freshClient.runtime.subscribeExceptionOccurred();
688
+
689
+ const ws = lastOf(MockWebSocket.instances);
690
+ ws.emit({
691
+ type: 'exception-occurred',
692
+ exception: {
693
+ title: 'Request to authenticate application',
694
+ message: 'demo-app is waiting for authentication',
695
+ type: 'CapabilityRequested',
696
+ addon: '{}',
697
+ },
698
+ });
699
+
700
+ expect(callback).toHaveBeenCalledWith({
701
+ title: 'Request to authenticate application',
702
+ message: 'demo-app is waiting for authentication',
703
+ type: 'CAPABILITY_REQUESTED',
704
+ addon: '{}',
1299
705
  });
706
+ });
707
+
708
+ test('subscribeToQueryUpdates() ignores unrelated events and accepts object results', async () => {
709
+ const freshClient = new Ad4mClient('http://127.0.0.1:12000', 'test-token', false);
710
+ const callback = jest.fn();
711
+ const unsubscribe = freshClient.perspective.subscribeToQueryUpdates('sub-1', callback);
712
+ const ws = lastOf(MockWebSocket.instances);
1300
713
 
1301
- it('updateTask()', async () => {
1302
- const task = await ad4mClient.ai.updateTask("task_id", {
1303
- name: "task_name",
1304
- modelId: "model_id",
1305
- systemPrompt: "system prompt",
1306
- promptExamples: []
1307
- });
1308
- expect(task.name).toBe("task_name")
1309
- expect(task.taskId).toBe("task_id")
1310
- expect(task.modelId).toBe("model_id")
1311
- expect(task.systemPrompt).toBe("system prompt")
714
+ ws.emit({ type: 'perspective-added', perspective: { uuid: 'uuid-ignored' } });
715
+ ws.emit({ type: 'query-subscription-update', subscriptionId: 'sub-2', result: { ignored: true } });
716
+ expect(callback).not.toHaveBeenCalled();
717
+
718
+ ws.emit({
719
+ type: 'query-subscription-update',
720
+ subscriptionId: 'sub-1',
721
+ result: [{ id: 'community://1', name: 'REST Smoke Community' }],
1312
722
  });
723
+ expect(callback).toHaveBeenCalledWith([{ id: 'community://1', name: 'REST Smoke Community' }]);
1313
724
 
1314
- it('modelLoadingStatus()', async () => {
1315
- const status = await ad4mClient.ai.modelLoadingStatus("model_id");
1316
- expect(status.status).toBe("loaded")
725
+ unsubscribe();
726
+ ws.emit({
727
+ type: 'query-subscription-update',
728
+ subscriptionId: 'sub-1',
729
+ result: [{ id: 'community://2', name: 'Should not arrive' }],
1317
730
  });
731
+ expect(callback).toHaveBeenCalledTimes(1);
732
+ });
733
+
734
+ test('publishSnapshotByUUID() publishes a snapshot', async () => {
735
+ const hash = await ad4m.perspective.publishSnapshotByUUID('uuid-1');
736
+ expect(hash).toBe('Qm123');
737
+ });
738
+
739
+ test('createBatch() creates a batch', async () => {
740
+ const batchId = await ad4m.perspective.createBatch('uuid-1');
741
+ expect(batchId).toBe('batch-id-1');
742
+ });
743
+
744
+ test('commitBatch() commits a batch', async () => {
745
+ const result = await ad4m.perspective.commitBatch('uuid-1', 'batch-id-1');
746
+ expect(result.additions).toEqual([]);
747
+ });
748
+ });
749
+
750
+ // ===================== LANGUAGE TESTS =====================
751
+ describe('LanguageClient', () => {
752
+ test('all() returns all languages', async () => {
753
+ const langs = await ad4m.languages.all();
754
+ expect(langs).toHaveLength(1);
755
+ expect(langs[0].name).toBe('test-lang');
756
+ });
1318
757
 
1319
- it('prompt()', async () => {
1320
- const prompt = await ad4mClient.ai.prompt("task_id", "Do something");
1321
- console.log(prompt)
1322
- expect(prompt).toBe("output")
1323
- })
758
+ test('byFilter() filters languages', async () => {
759
+ await ad4m.languages.byFilter('test');
760
+ expect(lastRpcCall!.params.filter).toBe('test');
761
+ });
762
+
763
+ test('byAddress() returns a language handle', async () => {
764
+ const lang = await ad4m.languages.byAddress('lang://test');
765
+ expect(lang.name).toBe('test-lang');
766
+ });
767
+
768
+ test('meta() returns language meta', async () => {
769
+ const meta = await ad4m.languages.meta('lang://test');
770
+ expect(meta.name).toBe('test-lang');
771
+ expect(meta.author).toBe('did:test:123');
772
+ });
773
+
774
+ test('source() returns source code', async () => {
775
+ const source = await ad4m.languages.source('lang://test');
776
+ expect(source).toBe('source-code-here');
777
+ });
778
+
779
+ test('writeSettings() writes language settings', async () => {
780
+ const result = await ad4m.languages.writeSettings('lang://test', '{"key":"value"}');
781
+ expect(result).toBe(true);
782
+ expect(lastRpcCall!.params.settings).toBe('{"key":"value"}');
783
+ });
784
+
785
+ test('applyTemplateAndPublish() applies a template', async () => {
786
+ const ref = await ad4m.languages.applyTemplateAndPublish('lang://source', '{"param":"value"}');
787
+ expect(ref.name).toBe('applied-lang');
788
+ expect(ref.address).toBe('lang://applied');
789
+ });
1324
790
 
1325
- it('openTranscriptionStream(), closeTranscriptionStream(), feedTranscriptionStream() & aiTranscriptionText subscription', async () => {
1326
- const streamCallback = jest.fn()
1327
- const streamId = await ad4mClient.ai.openTranscriptionStream("model_id", streamCallback);
1328
- expect(streamId).toBeTruthy()
1329
- expect(streamId).toBe("streamId")
1330
- expect(streamCallback).toBeCalledTimes(0)
791
+ test('publish() publishes a language', async () => {
792
+ const meta = await ad4m.languages.publish('/path/to/lang', { name: 'my-lang', description: 'desc' } as any);
793
+ expect(meta.name).toBe('published-lang');
794
+ });
1331
795
 
1332
- await new Promise<void>(resolve => setTimeout(resolve, 100))
796
+ test('remove() removes a language', async () => {
797
+ const result = await ad4m.languages.remove('lang://test');
798
+ expect(result).toBe(true);
799
+ });
800
+ });
801
+
802
+ // ===================== NEIGHBOURHOOD TESTS =====================
803
+ describe('NeighbourhoodClient', () => {
804
+ test('publishFromPerspective() publishes a neighbourhood', async () => {
805
+ const url = await ad4m.neighbourhood.publishFromPerspective(
806
+ 'uuid-1', 'lang://link', new Perspective(),
807
+ );
808
+ expect(url).toBe('neighbourhood://published');
809
+ expect(lastRpcCall!.params.perspectiveUUID).toBe('uuid-1');
810
+ });
1333
811
 
1334
- await ad4mClient.ai.feedTranscriptionStream(streamId, [0, 10, 20, 30]);
812
+ test('joinFromUrl() joins a neighbourhood', async () => {
813
+ const handle = await ad4m.neighbourhood.joinFromUrl('neighbourhood://test');
814
+ expect(handle.uuid).toBe('uuid-joined');
815
+ expect(lastRpcCall!.params.url).toBe('neighbourhood://test');
816
+ });
1335
817
 
1336
- await new Promise<void>(resolve => setTimeout(resolve, 100))
818
+ test('otherAgents() returns other agents', async () => {
819
+ const agents = await ad4m.neighbourhood.otherAgents('uuid-1');
820
+ expect(agents).toEqual(['did:other:1', 'did:other:2']);
821
+ });
1337
822
 
1338
- expect(streamCallback).toBeCalledTimes(1)
823
+ test('hasTelepresenceAdapter() checks adapter', async () => {
824
+ const has = await ad4m.neighbourhood.hasTelepresenceAdapter('uuid-1');
825
+ expect(has).toBe(true);
826
+ });
827
+
828
+ test('onlineAgents() returns online agents', async () => {
829
+ const agents = await ad4m.neighbourhood.onlineAgents('uuid-1');
830
+ expect(agents).toHaveLength(1);
831
+ });
832
+
833
+ test('setOnlineStatus() sets status', async () => {
834
+ const result = await ad4m.neighbourhood.setOnlineStatus('uuid-1', new Perspective());
835
+ expect(result).toBe(true);
836
+ });
837
+
838
+ test('sendSignal() sends a signal', async () => {
839
+ const result = await ad4m.neighbourhood.sendSignal('uuid-1', 'did:other:1', new Perspective());
840
+ expect(result).toBe(true);
841
+ expect(lastRpcCall!.params.remoteAgentDid).toBe('did:other:1');
842
+ });
843
+
844
+ test('sendBroadcast() sends a broadcast', async () => {
845
+ const result = await ad4m.neighbourhood.sendBroadcast('uuid-1', new Perspective(), true);
846
+ expect(result).toBe(true);
847
+ expect(lastRpcCall!.params.loopback).toBe(true);
848
+ });
849
+ });
850
+
851
+ // ===================== EXPRESSION TESTS =====================
852
+ describe('ExpressionClient', () => {
853
+ test('get() returns an expression', async () => {
854
+ const expr = await ad4m.expression.get('lang://test/Qm123');
855
+ expect(expr.author).toBe('did:test:123');
856
+ });
857
+
858
+ test('getMany() returns multiple expressions', async () => {
859
+ const exprs = await ad4m.expression.getMany(['url1', 'url2']);
860
+ expect(exprs).toHaveLength(1);
861
+ });
862
+
863
+ test('getRaw() returns raw expression', async () => {
864
+ const raw = await ad4m.expression.getRaw('lang://test/Qm123');
865
+ expect(raw).toBe('raw-expression-data');
866
+ });
1339
867
 
1340
- const stream = await ad4mClient.ai.closeTranscriptionStream(streamId)
1341
- expect(stream).toBeTruthy()
1342
- })
1343
- })
1344
- })
868
+ test('create() creates an expression', async () => {
869
+ const hash = await ad4m.expression.create({ content: 'hello' }, 'lang://test');
870
+ expect(hash).toBe('Qm-expression-hash');
871
+ expect(lastRpcCall!.params.languageAddress).toBe('lang://test');
872
+ });
873
+
874
+ test('interactions() returns interaction meta', async () => {
875
+ const interactions = await ad4m.expression.interactions('lang://test/Qm123');
876
+ expect(interactions).toHaveLength(1);
877
+ expect(interactions[0].label).toBe('interact1');
878
+ });
879
+
880
+ test('interact() calls an interaction', async () => {
881
+ const result = await ad4m.expression.interact('lang://test/Qm123', { name: 'doSomething', parameters: {} } as any);
882
+ expect(result).toBe('interaction-result');
883
+ });
884
+ });
885
+
886
+ // ===================== RUNTIME TESTS =====================
887
+ describe('RuntimeClient', () => {
888
+ test('info() returns runtime info', async () => {
889
+ const info = await ad4m.runtime.info();
890
+ expect(info.ad4mExecutorVersion).toBe('0.1.0');
891
+ });
892
+
893
+ test('tlsDomain() returns TLS domain', async () => {
894
+ const domain = await ad4m.runtime.tlsDomain();
895
+ expect(domain).toBe('test.domain.com');
896
+ });
897
+
898
+ test('quit() quits the runtime', async () => {
899
+ const result = await ad4m.runtime.quit();
900
+ expect(result).toBe(true);
901
+ });
902
+
903
+ test('friends() returns friends list', async () => {
904
+ const friends = await ad4m.runtime.friends();
905
+ expect(friends).toEqual(['did:friend:1', 'did:friend:2']);
906
+ });
907
+
908
+ test('addFriends() adds friends', async () => {
909
+ const result = await ad4m.runtime.addFriends(['did:friend:3']);
910
+ expect(result).toHaveLength(3);
911
+ expect(lastRpcCall!.params.dids).toEqual(['did:friend:3']);
912
+ });
913
+
914
+ test('removeFriends() removes friends', async () => {
915
+ const result = await ad4m.runtime.removeFriends(['did:friend:2']);
916
+ expect(result).toEqual(['did:friend:1']);
917
+ });
918
+
919
+ test('getTrustedAgents() returns trusted agents', async () => {
920
+ const agents = await ad4m.runtime.getTrustedAgents();
921
+ expect(agents).toEqual(['did:trusted:1']);
922
+ });
923
+
924
+ test('addTrustedAgents() adds trusted agents', async () => {
925
+ const result = await ad4m.runtime.addTrustedAgents(['did:trusted:2']);
926
+ expect(result).toHaveLength(2);
927
+ });
928
+
929
+ test('deleteTrustedAgents() removes trusted agents', async () => {
930
+ const result = await ad4m.runtime.deleteTrustedAgents(['did:trusted:2']);
931
+ expect(result).toEqual(['did:trusted:1']);
932
+ });
933
+
934
+ test('knownLinkLanguageTemplates() returns templates', async () => {
935
+ const templates = await ad4m.runtime.knownLinkLanguageTemplates();
936
+ expect(templates).toEqual(['lang://template1']);
937
+ });
938
+
939
+ test('hcAgentInfos() returns agent infos list', async () => {
940
+ const infos = await ad4m.runtime.hcAgentInfos();
941
+ expect(infos).toEqual(['hc-agent-info-1', 'hc-agent-info-2']);
942
+ });
943
+
944
+ test('hcAddAgentInfos() sends array payload and returns boolean', async () => {
945
+ const result = await ad4m.runtime.hcAddAgentInfos(['hc-agent-info-1', 'hc-agent-info-2']);
946
+ expect(result).toBe(true);
947
+ expect(lastRpcCall!.params.agentInfos).toEqual(['hc-agent-info-1', 'hc-agent-info-2']);
948
+ });
949
+
950
+ test('verifyStringSignedByDid() verifies signature', async () => {
951
+ const result = await ad4m.runtime.verifyStringSignedByDid('did:test:1', 'key-1', 'data', 'signed');
952
+ expect(result).toBe(true);
953
+ expect(lastRpcCall!.params.did).toBe('did:test:1');
954
+ });
955
+
956
+ test('friendStatus() gets friend status', async () => {
957
+ const status = await ad4m.runtime.friendStatus('did:friend:1');
958
+ expect(status.author).toBe('did:friend:1');
959
+ });
960
+
961
+ test('friendSendMessage() sends a message', async () => {
962
+ const result = await ad4m.runtime.friendSendMessage('did:friend:1', new Perspective());
963
+ expect(result).toBe(true);
964
+ });
965
+
966
+ test('messageInbox() returns inbox messages', async () => {
967
+ const msgs = await ad4m.runtime.messageInbox();
968
+ expect(msgs).toHaveLength(1);
969
+ });
970
+
971
+ test('openLink() opens a link', async () => {
972
+ const result = await ad4m.runtime.openLink('https://example.com');
973
+ expect(result).toBe(true);
974
+ expect(lastRpcCall!.params.url).toBe('https://example.com');
975
+ });
976
+
977
+ test('notifications() returns notifications', async () => {
978
+ const notifications = await ad4m.runtime.notifications();
979
+ expect(notifications).toEqual([]);
980
+ });
981
+
982
+ test('grantNotification() grants a notification', async () => {
983
+ const result = await ad4m.runtime.grantNotification('notif-1');
984
+ expect(result).toBe(true);
985
+ });
986
+
987
+ test('exportDb() exports the database', async () => {
988
+ const result = await ad4m.runtime.exportDb('/tmp/export');
989
+ expect(result).toBe(true);
990
+ });
991
+
992
+ test('multiUserEnabled() checks multi-user status', async () => {
993
+ const enabled = await ad4m.runtime.multiUserEnabled();
994
+ expect(enabled).toBe(false);
995
+ });
996
+
997
+ test('setMultiUserEnabled() enables multi-user', async () => {
998
+ const result = await ad4m.runtime.setMultiUserEnabled(true);
999
+ expect(result).toBe(true);
1000
+ });
1001
+
1002
+ test('restartHolochain() restarts holochain', async () => {
1003
+ const result = await ad4m.runtime.restartHolochain();
1004
+ expect(result).toBe(true);
1005
+ });
1006
+ });
1007
+
1008
+ // ===================== AI TESTS =====================
1009
+ describe('AIClient', () => {
1010
+ test('getModels() returns models', async () => {
1011
+ const models = await ad4m.ai.getModels();
1012
+ expect(models).toHaveLength(1);
1013
+ expect(models[0].name).toBe('GPT-Test');
1014
+ });
1015
+
1016
+ test('addModel() adds a model', async () => {
1017
+ const id = await ad4m.ai.addModel({ name: 'New Model', modelType: 'LLM' } as any);
1018
+ expect(id).toBe('model-new-id');
1019
+ expect(lastRpcCall!.params.model).toBeDefined();
1020
+ expect((lastRpcCall!.params.model as any).type).toBe('LLM');
1021
+ expect((lastRpcCall!.params.model as any).modelType).toBeUndefined();
1022
+ });
1023
+
1024
+ test('updateModel() updates a model', async () => {
1025
+ const result = await ad4m.ai.updateModel('model-1', { name: 'Updated', modelType: 'EMBEDDING' } as any);
1026
+ expect(result).toBe(true);
1027
+ expect((lastRpcCall!.params.model as any).type).toBe('EMBEDDING');
1028
+ expect((lastRpcCall!.params.model as any).modelType).toBeUndefined();
1029
+ });
1030
+
1031
+ test('removeModel() removes a model', async () => {
1032
+ const result = await ad4m.ai.removeModel('model-1');
1033
+ expect(result).toBe(true);
1034
+ });
1035
+
1036
+ test('tasks() returns tasks', async () => {
1037
+ const tasks = await ad4m.ai.tasks();
1038
+ expect(tasks).toHaveLength(1);
1039
+ });
1040
+
1041
+ test('addTask() adds a task', async () => {
1042
+ const task = await ad4m.ai.addTask('new-task', 'model-1', 'Do stuff', []);
1043
+ expect(task.name).toBe('new-task');
1044
+ });
1045
+
1046
+ test('removeTask() removes a task', async () => {
1047
+ const task = await ad4m.ai.removeTask('task-1');
1048
+ expect(task.name).toBe('summarize');
1049
+ });
1050
+
1051
+ test('prompt() sends a prompt', async () => {
1052
+ const response = await ad4m.ai.prompt('task-1', 'Hello AI');
1053
+ expect(response).toBe('This is the AI response');
1054
+ expect(lastRpcCall!.params.taskId).toBe('task-1');
1055
+ expect(lastRpcCall!.params.prompt).toBe('Hello AI');
1056
+ });
1057
+
1058
+ test('modelLoadingStatus() returns status', async () => {
1059
+ const status = await ad4m.ai.modelLoadingStatus('model-1');
1060
+ expect(status.progress).toBe(100);
1061
+ });
1062
+
1063
+ test('setDefaultModel() sets default', async () => {
1064
+ const result = await ad4m.ai.setDefaultModel('LLM' as any, 'model-1');
1065
+ expect(result).toBe(true);
1066
+ });
1067
+ });
1068
+
1069
+ // ===================== USER/AUTH TESTS =====================
1070
+ describe('User and Auth', () => {
1071
+ test('createUser() creates a user', async () => {
1072
+ const result = await ad4m.agent.createUser('test@test.com', 'password');
1073
+ expect(result.success).toBe(true);
1074
+ });
1075
+
1076
+ test('loginUser() returns JWT', async () => {
1077
+ const jwt = await ad4m.agent.loginUser('test@test.com', 'password');
1078
+ expect(jwt).toBe('login-jwt-token');
1079
+ });
1080
+
1081
+ test('verifyEmailCode() returns token', async () => {
1082
+ const token = await ad4m.agent.verifyEmailCode('test@test.com', '123456', 'login');
1083
+ expect(token).toBe('verified-token');
1084
+ });
1085
+
1086
+ test('hostingUserInfo() returns user info', async () => {
1087
+ const info = await ad4m.agent.hostingUserInfo();
1088
+ expect(info.email).toBe('test@test.com');
1089
+ });
1090
+
1091
+ test('requestLoginVerification() sends email and returns result', async () => {
1092
+ const result = await ad4m.agent.requestLoginVerification('test@test.com');
1093
+ expect(result.success).toBe(true);
1094
+ expect(result.isExistingUser).toBe(true);
1095
+ expect(lastRpcCall!.params.email).toBe('test@test.com');
1096
+ });
1097
+
1098
+ test('setHotWalletAddress() sends address', async () => {
1099
+ const result = await ad4m.agent.setHotWalletAddress('0xABC');
1100
+ expect(result).toBe(true);
1101
+ expect(lastRpcCall!.params.address).toBe('0xABC');
1102
+ });
1103
+
1104
+ test('requestPayment() sends amount', async () => {
1105
+ const result = await ad4m.agent.requestPayment('100');
1106
+ expect(lastRpcCall!.params.amountHOT).toBe('100');
1107
+ });
1108
+ });
1109
+
1110
+ // ===================== MULTI-USER EXTENDED TESTS =====================
1111
+ describe('Multi-user and Hosting', () => {
1112
+ test('listUsers() returns user statistics', async () => {
1113
+ const users = await ad4m.runtime.listUsers();
1114
+ expect(users).toHaveLength(1);
1115
+ expect(users[0].email).toBe('user@test.com');
1116
+ });
1117
+
1118
+ test('setUserCredits() sets credits for a user', async () => {
1119
+ const result = await ad4m.runtime.setUserCredits('user@test.com', 500);
1120
+ expect(result).toBe(true);
1121
+ expect(lastRpcCall!.params.email).toBe('user@test.com');
1122
+ expect(lastRpcCall!.params.amount).toBe(500);
1123
+ });
1124
+
1125
+ test('setUserFreeAccess() toggles free access', async () => {
1126
+ const result = await ad4m.runtime.setUserFreeAccess('user@test.com', true);
1127
+ expect(result).toBe(true);
1128
+ expect(lastRpcCall!.params.email).toBe('user@test.com');
1129
+ expect(lastRpcCall!.params.enabled).toBe(true);
1130
+ });
1131
+
1132
+ test('userWalletAddress() returns wallet address', async () => {
1133
+ const addr = await ad4m.runtime.userWalletAddress('user@test.com');
1134
+ expect(addr).toBe('0x1234567890abcdef');
1135
+ });
1136
+
1137
+ test('emailTestModeEnable() enables email test mode', async () => {
1138
+ const result = await ad4m.runtime.emailTestModeEnable();
1139
+ expect(result).toBe(true);
1140
+ expect(lastRpcCall!.params.action).toBe('enable');
1141
+ });
1142
+
1143
+ test('emailTestModeDisable() disables email test mode', async () => {
1144
+ const result = await ad4m.runtime.emailTestModeDisable();
1145
+ expect(result).toBe(true);
1146
+ expect(lastRpcCall!.params.action).toBe('disable');
1147
+ });
1148
+
1149
+ test('emailTestClearCodes() clears test codes', async () => {
1150
+ const result = await ad4m.runtime.emailTestClearCodes();
1151
+ expect(result).toBe(true);
1152
+ expect(lastRpcCall!.params.action).toBe('clear-codes');
1153
+ });
1154
+
1155
+ test('getHostRates() returns parsed rates', async () => {
1156
+ const rates = await ad4m.runtime.getHostRates();
1157
+ expect(rates).toHaveLength(1);
1158
+ expect(rates[0].description).toBe('Link write');
1159
+ expect(rates[0].priceInHOT).toBe(0.001);
1160
+ });
1161
+
1162
+ test('setHostRates() sends rates JSON', async () => {
1163
+ const result = await ad4m.runtime.setHostRates(JSON.stringify([{ description: 'test', priceInHOT: 1 }]));
1164
+ expect(result).toBe(true);
1165
+ });
1166
+ });
1167
+
1168
+ // ===================== UNYT / mHOT TESTS =====================
1169
+ describe('Unyt Integration', () => {
1170
+ test('unytAgentKey() returns agent key', async () => {
1171
+ const key = await ad4m.runtime.unytAgentKey();
1172
+ expect(key).toBe('unyt-agent-key-123');
1173
+ });
1174
+
1175
+ test('unytHotAgentPubkey() returns pubkey', async () => {
1176
+ const key = await ad4m.runtime.unytHotAgentPubkey();
1177
+ expect(key).toBe('unyt-hot-pubkey-456');
1178
+ });
1179
+
1180
+ test('unytWalletBalance() returns balance', async () => {
1181
+ const balance = await ad4m.runtime.unytWalletBalance();
1182
+ expect(balance).toBe('1000.50');
1183
+ });
1184
+
1185
+ test('unytWalletHistory() returns history', async () => {
1186
+ const history = await ad4m.runtime.unytWalletHistory();
1187
+ expect(history).toBe('[]');
1188
+ });
1189
+
1190
+ test('unytVersionInfo() returns version info', async () => {
1191
+ const info = await ad4m.runtime.unytVersionInfo();
1192
+ expect(info).toContain('version');
1193
+ });
1194
+
1195
+ test('unytSetMembraneProof() sets proof', async () => {
1196
+ const result = await ad4m.runtime.unytSetMembraneProof('proof-data');
1197
+ expect(result.success).toBe(true);
1198
+ expect(lastRpcCall!.params.proof).toBe('proof-data');
1199
+ });
1200
+
1201
+ test('unytReinstallDna() reinstalls DNA', async () => {
1202
+ const result = await ad4m.runtime.unytReinstallDna();
1203
+ expect(result.success).toBe(true);
1204
+ });
1205
+
1206
+ test('unytSendHot() sends HOT tokens', async () => {
1207
+ const result = await ad4m.runtime.unytSendHot('recipient-123', '50');
1208
+ expect(result.success).toBe(true);
1209
+ expect(lastRpcCall!.params.recipient).toBe('recipient-123');
1210
+ expect(lastRpcCall!.params.amount).toBe('50');
1211
+ });
1212
+ });
1213
+
1214
+ // ===================== AD4M CLIENT INTEGRATION =====================
1215
+ describe('Ad4mClient', () => {
1216
+ test('all sub-clients are accessible', () => {
1217
+ expect(ad4m.agent).toBeDefined();
1218
+ expect(ad4m.expression).toBeDefined();
1219
+ expect(ad4m.languages).toBeDefined();
1220
+ expect(ad4m.neighbourhood).toBeDefined();
1221
+ expect(ad4m.perspective).toBeDefined();
1222
+ expect(ad4m.runtime).toBeDefined();
1223
+ expect(ad4m.ai).toBeDefined();
1224
+ });
1225
+
1226
+ test('token is passed via WebSocket URL query param', async () => {
1227
+ const freshClient = new Ad4mClient('http://127.0.0.1:12000', 'my-secret-token', false);
1228
+ await freshClient.agent.me();
1229
+ const ws = lastOf(MockWebSocket.instances);
1230
+ expect(ws.url).toBe('ws://127.0.0.1:12000/api/v1/ws?token=my-secret-token');
1231
+ });
1232
+
1233
+ test('WS RPC message contains type and params', async () => {
1234
+ await ad4m.agent.generate('pass');
1235
+ expect(lastRpcCall!.type).toBe('agent.generate');
1236
+ expect(lastRpcCall!.params).toBeDefined();
1237
+ });
1238
+ });