@coasys/ad4m 0.13.0-test-flows-1 → 0.13.1-staging.1

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 (813) hide show
  1. package/README.md +1 -0
  2. package/lib/index.cjs +6796 -6849
  3. package/lib/index.js +6757 -6820
  4. package/lib/src/Ad4mClient.d.ts +12 -4
  5. package/lib/src/Ad4mClient.js +15 -11
  6. package/lib/src/Literal.js +3 -3
  7. package/lib/src/agent/Agent.d.ts +4 -1
  8. package/lib/src/agent/Agent.js +6 -0
  9. package/lib/src/agent/AgentClient.d.ts +9 -23
  10. package/lib/src/agent/AgentClient.js +68 -148
  11. package/lib/src/ai/AIClient.d.ts +10 -6
  12. package/lib/src/ai/AIClient.js +29 -27
  13. package/lib/src/apiClient.d.ts +54 -42
  14. package/lib/src/apiClient.js +279 -252
  15. package/lib/src/expression/Expression.d.ts +13 -4
  16. package/lib/src/expression/Expression.js +0 -1
  17. package/lib/src/expression/ExpressionClient.js +1 -1
  18. package/lib/src/generated/api/AIPromptExamples.d.ts +4 -0
  19. package/lib/src/generated/api/AIPromptExamples.js +2 -0
  20. package/lib/src/generated/api/AIPromptExamplesInput.d.ts +4 -0
  21. package/lib/src/generated/api/AIPromptExamplesInput.js +2 -0
  22. package/lib/src/generated/api/AITask.d.ts +11 -0
  23. package/lib/src/generated/api/AITaskInput.d.ts +8 -0
  24. package/lib/src/generated/api/AddAgentInfosRequest.d.ts +3 -0
  25. package/lib/src/generated/api/AddAgentInfosRequest.js +2 -0
  26. package/lib/src/generated/api/AddLinkExpressionRequest.d.ts +2 -2
  27. package/lib/src/generated/api/AddLinkRequest.d.ts +2 -2
  28. package/lib/src/generated/api/AddLinksBulkRequest.d.ts +2 -2
  29. package/lib/src/generated/api/AddSdnaRequest.d.ts +2 -2
  30. package/lib/src/generated/api/Agent.d.ts +6 -0
  31. package/lib/src/generated/api/AgentAddEntanglementProofsParams.d.ts +9 -0
  32. package/lib/src/generated/api/AgentByDidParams.d.ts +3 -0
  33. package/lib/src/generated/api/AgentByDidParams.js +2 -0
  34. package/lib/src/generated/api/AgentRemoveAppParams.d.ts +3 -0
  35. package/lib/src/generated/api/AgentRemoveAppParams.js +2 -0
  36. package/lib/src/generated/api/AgentRevokeTokenParams.d.ts +3 -0
  37. package/lib/src/generated/api/AgentRevokeTokenParams.js +2 -0
  38. package/lib/src/generated/api/AgentSignature.d.ts +4 -0
  39. package/lib/src/generated/api/AgentSignature.js +2 -0
  40. package/lib/src/generated/api/AgentStatus.d.ts +8 -0
  41. package/lib/src/generated/api/AgentStatusChangedEvent.d.ts +7 -0
  42. package/lib/src/generated/api/AgentUpdatedEvent.d.ts +7 -0
  43. package/lib/src/generated/api/AiAddModelParams.d.ts +4 -0
  44. package/lib/src/generated/api/AiAddTaskParams.d.ts +4 -0
  45. package/lib/src/generated/api/AiDiscoverModelsParams.d.ts +8 -0
  46. package/lib/src/generated/api/AiDiscoverModelsParams.js +2 -0
  47. package/lib/src/generated/api/AiGetDefaultModelParams.d.ts +4 -0
  48. package/lib/src/generated/api/AiIdParams.d.ts +3 -0
  49. package/lib/src/generated/api/AiIdParams.js +2 -0
  50. package/lib/src/generated/api/AiModelLoadingStatusParams.d.ts +7 -0
  51. package/lib/src/generated/api/AiModelLoadingStatusParams.js +2 -0
  52. package/lib/src/generated/api/AiSetDefaultModelParams.d.ts +5 -0
  53. package/lib/src/generated/api/AiSetDefaultModelParams.js +1 -0
  54. package/lib/src/generated/api/AiTranscriptionCloseParams.d.ts +3 -0
  55. package/lib/src/generated/api/AiTranscriptionCloseParams.js +2 -0
  56. package/lib/src/generated/api/AiTranscriptionOpenParams.d.ts +5 -0
  57. package/lib/src/generated/api/AiTranscriptionOpenParams.js +1 -0
  58. package/lib/src/generated/api/AiUpdateModelParams.d.ts +5 -0
  59. package/lib/src/generated/api/AiUpdateModelParams.js +1 -0
  60. package/lib/src/generated/api/AiUpdateTaskParams.d.ts +4 -0
  61. package/lib/src/generated/api/AiUpdateTaskParams.js +1 -0
  62. package/lib/src/generated/api/Apps.d.ts +7 -0
  63. package/lib/src/generated/api/Apps.js +1 -0
  64. package/lib/src/generated/api/AuthInfo.d.ts +10 -0
  65. package/lib/src/generated/api/AuthInfo.js +1 -0
  66. package/lib/src/generated/api/AuthInfoInput.d.ts +4 -4
  67. package/lib/src/generated/api/AutoProcessorEvent.d.ts +89 -0
  68. package/lib/src/generated/api/AutoProcessorEvent.js +1 -0
  69. package/lib/src/generated/api/AutoProcessorNeighbourhoodState.d.ts +32 -0
  70. package/lib/src/generated/api/AutoProcessorNeighbourhoodState.js +1 -0
  71. package/lib/src/generated/api/AutoProcessorStep.d.ts +7 -0
  72. package/lib/src/generated/api/AutoProcessorStep.js +2 -0
  73. package/lib/src/generated/api/BroadcastRequest.d.ts +5 -0
  74. package/lib/src/generated/api/BroadcastRequest.js +2 -0
  75. package/lib/src/generated/api/Capability.d.ts +5 -0
  76. package/lib/src/generated/api/Capability.js +1 -0
  77. package/lib/src/generated/api/CreateSubjectRequest.d.ts +2 -2
  78. package/lib/src/generated/api/CreateUserRequest.d.ts +4 -0
  79. package/lib/src/generated/api/CreateUserRequest.js +2 -0
  80. package/lib/src/generated/api/DateTime.d.ts +1 -0
  81. package/lib/src/generated/api/DateTime.js +2 -0
  82. package/lib/src/generated/api/DecoratedExpressionProof.d.ts +6 -0
  83. package/lib/src/generated/api/DecoratedExpressionProof.js +2 -0
  84. package/lib/src/generated/api/DecoratedLinkExpression.d.ts +10 -0
  85. package/lib/src/generated/api/DecoratedLinkExpression.js +1 -0
  86. package/lib/src/generated/api/DecoratedNeighbourhoodExpression.d.ts +8 -0
  87. package/lib/src/generated/api/DecoratedNeighbourhoodExpression.js +1 -0
  88. package/lib/src/generated/api/DecoratedPerspective.d.ts +4 -0
  89. package/lib/src/generated/api/DecoratedPerspective.js +1 -0
  90. package/lib/src/generated/api/DisposeQueryRequest.d.ts +3 -0
  91. package/lib/src/generated/api/DisposeQueryRequest.js +2 -0
  92. package/lib/src/generated/api/EntanglementProof.d.ts +8 -0
  93. package/lib/src/generated/api/EntanglementProof.js +2 -0
  94. package/lib/src/generated/api/EntanglementProofInput.d.ts +1 -1
  95. package/lib/src/generated/api/EntanglementProofPreflightRequest.d.ts +4 -0
  96. package/lib/src/generated/api/EntanglementProofPreflightRequest.js +2 -0
  97. package/lib/src/generated/api/EntanglementProofsWrapper.d.ts +7 -0
  98. package/lib/src/generated/api/EntanglementProofsWrapper.js +1 -0
  99. package/lib/src/generated/api/Events.d.ts +46 -0
  100. package/lib/src/generated/api/Events.js +17 -0
  101. package/lib/src/generated/api/ExceptionInfo.d.ts +7 -0
  102. package/lib/src/generated/api/ExceptionInfo.js +1 -0
  103. package/lib/src/generated/api/ExceptionOccurredEvent.d.ts +7 -0
  104. package/lib/src/generated/api/ExceptionOccurredEvent.js +1 -0
  105. package/lib/src/generated/api/ExceptionType.d.ts +1 -0
  106. package/lib/src/generated/api/ExceptionType.js +2 -0
  107. package/lib/src/generated/api/ExecuteCommandsRequest.d.ts +4 -2
  108. package/lib/src/generated/api/ExportRequest.d.ts +1 -1
  109. package/lib/src/generated/api/ExpressionInteractRequest.d.ts +5 -0
  110. package/lib/src/generated/api/ExpressionInteractRequest.js +1 -0
  111. package/lib/src/generated/api/ExpressionProofInput.d.ts +4 -4
  112. package/lib/src/generated/api/ExpressionRendered.d.ts +11 -0
  113. package/lib/src/generated/api/ExpressionRendered.js +1 -0
  114. package/lib/src/generated/api/ExpressionUrlRequest.d.ts +3 -0
  115. package/lib/src/generated/api/ExpressionUrlRequest.js +2 -0
  116. package/lib/src/generated/api/FireOutcome.d.ts +14 -0
  117. package/lib/src/generated/api/FireOutcome.js +2 -0
  118. package/lib/src/generated/api/FriendSendMessageRequest.d.ts +1 -1
  119. package/lib/src/generated/api/HostRate.d.ts +7 -0
  120. package/lib/src/generated/api/HostRate.js +2 -0
  121. package/lib/src/generated/api/HostingInfoResult.d.ts +13 -0
  122. package/lib/src/generated/api/HostingInfoResult.js +1 -0
  123. package/lib/src/generated/api/HostingInfoUser.d.ts +9 -0
  124. package/lib/src/generated/api/HostingInfoUser.js +2 -0
  125. package/lib/src/generated/api/HostingRequestPaymentResult.d.ts +4 -0
  126. package/lib/src/generated/api/HostingRequestPaymentResult.js +2 -0
  127. package/lib/src/generated/api/HostingUserInfo.d.ts +6 -0
  128. package/lib/src/generated/api/HostingUserInfo.js +2 -0
  129. package/lib/src/generated/api/HostingVersionInfo.d.ts +7 -0
  130. package/lib/src/generated/api/HostingVersionInfo.js +2 -0
  131. package/lib/src/generated/api/HostingWalletResult.d.ts +8 -0
  132. package/lib/src/generated/api/HostingWalletResult.js +1 -0
  133. package/lib/src/generated/api/Icon.d.ts +3 -0
  134. package/lib/src/generated/api/Icon.js +2 -0
  135. package/lib/src/generated/api/ImportResult.d.ts +15 -0
  136. package/lib/src/generated/api/ImportResult.js +1 -0
  137. package/lib/src/generated/api/ImportStats.d.ts +7 -0
  138. package/lib/src/generated/api/ImportStats.js +2 -0
  139. package/lib/src/generated/api/InteractionCall.d.ts +4 -0
  140. package/lib/src/generated/api/InteractionCall.js +2 -0
  141. package/lib/src/generated/api/InteractionCallWrapper.d.ts +6 -0
  142. package/lib/src/generated/api/InteractionCallWrapper.js +2 -0
  143. package/lib/src/generated/api/InteractionMeta.d.ts +6 -0
  144. package/lib/src/generated/api/InteractionMeta.js +1 -0
  145. package/lib/src/generated/api/InteractionParameter.d.ts +4 -0
  146. package/lib/src/generated/api/InteractionParameter.js +2 -0
  147. package/lib/src/generated/api/KeepAliveQueryRequest.d.ts +3 -0
  148. package/lib/src/generated/api/KeepAliveQueryRequest.js +2 -0
  149. package/lib/src/generated/api/LanguageAddressParams.d.ts +3 -0
  150. package/lib/src/generated/api/LanguageAddressParams.js +2 -0
  151. package/lib/src/generated/api/LanguageHandle.d.ts +9 -0
  152. package/lib/src/generated/api/LanguageHandle.js +1 -0
  153. package/lib/src/generated/api/LanguageListParams.d.ts +3 -0
  154. package/lib/src/generated/api/LanguageListParams.js +2 -0
  155. package/lib/src/generated/api/LanguageMeta.d.ts +11 -0
  156. package/lib/src/generated/api/LanguageMeta.js +2 -0
  157. package/lib/src/generated/api/LanguageMetaInput.d.ts +2 -2
  158. package/lib/src/generated/api/LanguageRef.d.ts +4 -0
  159. package/lib/src/generated/api/LanguageRef.js +2 -0
  160. package/lib/src/generated/api/LanguageSettingsWrapper.d.ts +6 -0
  161. package/lib/src/generated/api/LanguageSettingsWrapper.js +2 -0
  162. package/lib/src/generated/api/LanguageWriteSettingsParams.d.ts +4 -0
  163. package/lib/src/generated/api/LanguageWriteSettingsParams.js +2 -0
  164. package/lib/src/generated/api/LinkExpressionInput.d.ts +1 -1
  165. package/lib/src/generated/api/LinkInput.d.ts +1 -1
  166. package/lib/src/generated/api/LinkMutationRequest.d.ts +12 -0
  167. package/lib/src/generated/api/LinkMutationRequest.js +1 -0
  168. package/lib/src/generated/api/LinkMutationsRequest.d.ts +5 -0
  169. package/lib/src/generated/api/LinkMutationsRequest.js +1 -0
  170. package/lib/src/generated/api/LinkStatus.d.ts +1 -1
  171. package/lib/src/generated/api/LinkUpdateInput.d.ts +5 -0
  172. package/lib/src/generated/api/LinkUpdateInput.js +1 -0
  173. package/lib/src/generated/api/LocalModel.d.ts +7 -0
  174. package/lib/src/generated/api/LocalModel.js +1 -0
  175. package/lib/src/generated/api/LocalModelInput.d.ts +7 -0
  176. package/lib/src/generated/api/LocalModelInput.js +1 -0
  177. package/lib/src/generated/api/MessageReceivedEvent.d.ts +7 -0
  178. package/lib/src/generated/api/MessageReceivedEvent.js +1 -0
  179. package/lib/src/generated/api/Model.d.ts +10 -0
  180. package/lib/src/generated/api/Model.js +1 -0
  181. package/lib/src/generated/api/ModelApi.d.ts +17 -0
  182. package/lib/src/generated/api/ModelApi.js +1 -0
  183. package/lib/src/generated/api/ModelApiInput.d.ts +11 -0
  184. package/lib/src/generated/api/ModelApiInput.js +2 -0
  185. package/lib/src/generated/api/ModelApiType.d.ts +1 -0
  186. package/lib/src/generated/api/ModelApiType.js +2 -0
  187. package/lib/src/generated/api/ModelInput.d.ts +9 -0
  188. package/lib/src/generated/api/ModelInput.js +1 -0
  189. package/lib/src/generated/api/ModelType.d.ts +1 -1
  190. package/lib/src/generated/api/Neighbourhood.d.ts +5 -0
  191. package/lib/src/generated/api/Neighbourhood.js +1 -0
  192. package/lib/src/generated/api/NeighbourhoodBroadcastParams.d.ts +7 -0
  193. package/lib/src/generated/api/NeighbourhoodBroadcastParams.js +1 -0
  194. package/lib/src/generated/api/NeighbourhoodOnlineStatusParams.d.ts +6 -0
  195. package/lib/src/generated/api/NeighbourhoodOnlineStatusParams.js +1 -0
  196. package/lib/src/generated/api/NeighbourhoodPerspectivePayload.d.ts +7 -0
  197. package/lib/src/generated/api/NeighbourhoodPerspectivePayload.js +1 -0
  198. package/lib/src/generated/api/NeighbourhoodPhase.d.ts +6 -0
  199. package/lib/src/generated/api/NeighbourhoodPhase.js +2 -0
  200. package/lib/src/generated/api/NeighbourhoodSignalFilter.d.ts +8 -0
  201. package/lib/src/generated/api/NeighbourhoodSignalFilter.js +1 -0
  202. package/lib/src/generated/api/NeighbourhoodSignalParams.d.ts +7 -0
  203. package/lib/src/generated/api/NeighbourhoodSignalParams.js +1 -0
  204. package/lib/src/generated/api/NeighbourhoodSignedPerspective.d.ts +8 -0
  205. package/lib/src/generated/api/NeighbourhoodSignedPerspective.js +1 -0
  206. package/lib/src/generated/api/NeighbourhoodUuidParams.d.ts +3 -0
  207. package/lib/src/generated/api/NeighbourhoodUuidParams.js +2 -0
  208. package/lib/src/generated/api/Notification.d.ts +16 -0
  209. package/lib/src/generated/api/Notification.js +2 -0
  210. package/lib/src/generated/api/NotificationGrantRequest.d.ts +6 -0
  211. package/lib/src/generated/api/NotificationGrantRequest.js +2 -0
  212. package/lib/src/generated/api/NotificationInput.d.ts +1 -1
  213. package/lib/src/generated/api/NotificationTriggeredEvent.d.ts +9 -0
  214. package/lib/src/generated/api/NotificationTriggeredEvent.js +1 -0
  215. package/lib/src/generated/api/OnlineAgent.d.ts +5 -0
  216. package/lib/src/generated/api/OnlineAgent.js +1 -0
  217. package/lib/src/generated/api/OutputRef.d.ts +12 -0
  218. package/lib/src/generated/api/OutputRef.js +2 -0
  219. package/lib/src/generated/api/OverlayView.d.ts +24 -0
  220. package/lib/src/generated/api/OverlayView.js +1 -0
  221. package/lib/src/generated/api/Perspective.d.ts +4 -0
  222. package/lib/src/generated/api/Perspective.js +1 -0
  223. package/lib/src/generated/api/PerspectiveAddAutoProcessorParams.d.ts +26 -0
  224. package/lib/src/generated/api/PerspectiveAddAutoProcessorParams.js +2 -0
  225. package/lib/src/generated/api/PerspectiveAddLinkExpressionParams.d.ts +7 -0
  226. package/lib/src/generated/api/PerspectiveAddLinkExpressionParams.js +1 -0
  227. package/lib/src/generated/api/PerspectiveAddLinkParams.d.ts +7 -0
  228. package/lib/src/generated/api/PerspectiveAddLinkParams.js +1 -0
  229. package/lib/src/generated/api/PerspectiveAddLinksParams.d.ts +7 -0
  230. package/lib/src/generated/api/PerspectiveAddLinksParams.js +1 -0
  231. package/lib/src/generated/api/PerspectiveAddSdnaParams.d.ts +14 -0
  232. package/lib/src/generated/api/PerspectiveAddSdnaParams.js +1 -0
  233. package/lib/src/generated/api/PerspectiveAddSdnaResult.d.ts +4 -0
  234. package/lib/src/generated/api/PerspectiveAddSdnaResult.js +2 -0
  235. package/lib/src/generated/api/PerspectiveCommitBatchParams.d.ts +4 -0
  236. package/lib/src/generated/api/PerspectiveCommitBatchParams.js +2 -0
  237. package/lib/src/generated/api/PerspectiveCreateSubjectParams.d.ts +7 -0
  238. package/lib/src/generated/api/PerspectiveCreateSubjectParams.js +2 -0
  239. package/lib/src/generated/api/PerspectiveEvaluateGettersParams.d.ts +9 -0
  240. package/lib/src/generated/api/PerspectiveEvaluateGettersParams.js +2 -0
  241. package/lib/src/generated/api/PerspectiveExecuteCommandsParams.d.ts +7 -0
  242. package/lib/src/generated/api/PerspectiveExecuteCommandsParams.js +2 -0
  243. package/lib/src/generated/api/PerspectiveExpression.d.ts +8 -0
  244. package/lib/src/generated/api/PerspectiveExpression.js +1 -0
  245. package/lib/src/generated/api/PerspectiveFlowProposalParams.d.ts +4 -0
  246. package/lib/src/generated/api/PerspectiveFlowProposalParams.js +2 -0
  247. package/lib/src/generated/api/PerspectiveFlowReceiptVerdict.d.ts +12 -0
  248. package/lib/src/generated/api/PerspectiveFlowReceiptVerdict.js +1 -0
  249. package/lib/src/generated/api/PerspectiveFlowValidOutputsParams.d.ts +8 -0
  250. package/lib/src/generated/api/PerspectiveFlowValidOutputsParams.js +2 -0
  251. package/lib/src/generated/api/PerspectiveGetSubjectDataParams.d.ts +5 -0
  252. package/lib/src/generated/api/PerspectiveGetSubjectDataParams.js +2 -0
  253. package/lib/src/generated/api/PerspectiveHandle.d.ts +10 -0
  254. package/lib/src/generated/api/PerspectiveHandle.js +1 -0
  255. package/lib/src/generated/api/PerspectiveLinkDiff.d.ts +9 -0
  256. package/lib/src/generated/api/PerspectiveLinkDiff.js +1 -0
  257. package/lib/src/generated/api/PerspectiveLinkMutationsParams.d.ts +6 -0
  258. package/lib/src/generated/api/PerspectiveLinkMutationsParams.js +1 -0
  259. package/lib/src/generated/api/PerspectiveLinkUpdatedWithOwner.d.ts +7 -0
  260. package/lib/src/generated/api/PerspectiveLinkUpdatedWithOwner.js +1 -0
  261. package/lib/src/generated/api/PerspectiveLinkWithOwner.d.ts +6 -0
  262. package/lib/src/generated/api/PerspectiveLinkWithOwner.js +1 -0
  263. package/lib/src/generated/api/PerspectiveMintFlowReceiptParams.d.ts +4 -0
  264. package/lib/src/generated/api/PerspectiveMintFlowReceiptParams.js +2 -0
  265. package/lib/src/generated/api/PerspectiveMintFlowReceiptResult.d.ts +9 -0
  266. package/lib/src/generated/api/PerspectiveMintFlowReceiptResult.js +1 -0
  267. package/lib/src/generated/api/PerspectiveModelQueryParams.d.ts +8 -0
  268. package/lib/src/generated/api/PerspectiveModelQueryParams.js +2 -0
  269. package/lib/src/generated/api/PerspectiveModelSubscribeResult.d.ts +7 -0
  270. package/lib/src/generated/api/PerspectiveModelSubscribeResult.js +2 -0
  271. package/lib/src/generated/api/PerspectiveNamedShacl.d.ts +6 -0
  272. package/lib/src/generated/api/PerspectiveNamedShacl.js +1 -0
  273. package/lib/src/generated/api/PerspectiveProposeFlowTransitionParams.d.ts +8 -0
  274. package/lib/src/generated/api/PerspectiveProposeFlowTransitionParams.js +1 -0
  275. package/lib/src/generated/api/PerspectiveQueryLinksParams.d.ts +15 -0
  276. package/lib/src/generated/api/PerspectiveQueryLinksParams.js +2 -0
  277. package/lib/src/generated/api/PerspectiveQueryParams.d.ts +4 -0
  278. package/lib/src/generated/api/PerspectiveQueryParams.js +2 -0
  279. package/lib/src/generated/api/PerspectiveQuerySubscriptionFilter.d.ts +6 -0
  280. package/lib/src/generated/api/PerspectiveQuerySubscriptionFilter.js +2 -0
  281. package/lib/src/generated/api/PerspectiveReceiptOutcome.d.ts +1 -0
  282. package/lib/src/generated/api/PerspectiveReceiptOutcome.js +2 -0
  283. package/lib/src/generated/api/PerspectiveRejectFlowProposalResult.d.ts +3 -0
  284. package/lib/src/generated/api/PerspectiveRejectFlowProposalResult.js +2 -0
  285. package/lib/src/generated/api/PerspectiveRemoveAutoProcessorParams.d.ts +4 -0
  286. package/lib/src/generated/api/PerspectiveRemoveAutoProcessorParams.js +2 -0
  287. package/lib/src/generated/api/PerspectiveRemoveLinkParams.d.ts +6 -0
  288. package/lib/src/generated/api/PerspectiveRemoveLinkParams.js +1 -0
  289. package/lib/src/generated/api/PerspectiveRemoveLinksParams.d.ts +6 -0
  290. package/lib/src/generated/api/PerspectiveRemoveLinksParams.js +1 -0
  291. package/lib/src/generated/api/PerspectiveRemovedWithOwner.d.ts +5 -0
  292. package/lib/src/generated/api/PerspectiveRemovedWithOwner.js +2 -0
  293. package/lib/src/generated/api/PerspectiveResolveInterpretationParams.d.ts +8 -0
  294. package/lib/src/generated/api/PerspectiveResolveInterpretationParams.js +2 -0
  295. package/lib/src/generated/api/PerspectiveShacl.d.ts +5 -0
  296. package/lib/src/generated/api/PerspectiveShacl.js +1 -0
  297. package/lib/src/generated/api/PerspectiveShaclNameParams.d.ts +4 -0
  298. package/lib/src/generated/api/PerspectiveShaclNameParams.js +2 -0
  299. package/lib/src/generated/api/PerspectiveSparqlParams.d.ts +8 -0
  300. package/lib/src/generated/api/PerspectiveSparqlParams.js +2 -0
  301. package/lib/src/generated/api/PerspectiveState.d.ts +1 -0
  302. package/lib/src/generated/api/PerspectiveState.js +2 -0
  303. package/lib/src/generated/api/PerspectiveStateFilter.d.ts +7 -0
  304. package/lib/src/generated/api/PerspectiveStateFilter.js +1 -0
  305. package/lib/src/generated/api/PerspectiveSubjectClassesOfParams.d.ts +4 -0
  306. package/lib/src/generated/api/PerspectiveSubjectClassesOfParams.js +2 -0
  307. package/lib/src/generated/api/PerspectiveSubscribeQueryResult.d.ts +4 -0
  308. package/lib/src/generated/api/PerspectiveSubscribeQueryResult.js +2 -0
  309. package/lib/src/generated/api/PerspectiveSubscriptionParams.d.ts +4 -0
  310. package/lib/src/generated/api/PerspectiveSubscriptionParams.js +2 -0
  311. package/lib/src/generated/api/PerspectiveUnsignedInput.d.ts +4 -0
  312. package/lib/src/generated/api/PerspectiveUnsignedInput.js +1 -0
  313. package/lib/src/generated/api/PerspectiveUpdateLinkParams.d.ts +8 -0
  314. package/lib/src/generated/api/PerspectiveUpdateLinkParams.js +1 -0
  315. package/lib/src/generated/api/PerspectiveUpdateParams.d.ts +4 -0
  316. package/lib/src/generated/api/PerspectiveUpdateParams.js +2 -0
  317. package/lib/src/generated/api/PerspectiveUuidParams.d.ts +3 -0
  318. package/lib/src/generated/api/PerspectiveUuidParams.js +2 -0
  319. package/lib/src/generated/api/PerspectiveVerifyFlowReceiptParams.d.ts +9 -0
  320. package/lib/src/generated/api/PerspectiveVerifyFlowReceiptParams.js +1 -0
  321. package/lib/src/generated/api/PerspectiveWithOwner.d.ts +6 -0
  322. package/lib/src/generated/api/PerspectiveWithOwner.js +1 -0
  323. package/lib/src/generated/api/ProposeOutcome.d.ts +45 -0
  324. package/lib/src/generated/api/ProposeOutcome.js +1 -0
  325. package/lib/src/generated/api/PublicPerspectiveInput.d.ts +4 -0
  326. package/lib/src/generated/api/PublicPerspectiveInput.js +1 -0
  327. package/lib/src/generated/api/PublishNeighbourhoodRequest.d.ts +2 -2
  328. package/lib/src/generated/api/RemoveLinkRequest.d.ts +1 -1
  329. package/lib/src/generated/api/RemoveLinksBulkRequest.d.ts +1 -1
  330. package/lib/src/generated/api/RequestCapabilityRequest.d.ts +4 -0
  331. package/lib/src/generated/api/RequestCapabilityRequest.js +1 -0
  332. package/lib/src/generated/api/RequestPaymentRequest.d.ts +3 -0
  333. package/lib/src/generated/api/RequestPaymentRequest.js +2 -0
  334. package/lib/src/generated/api/Resource.d.ts +4 -0
  335. package/lib/src/generated/api/Resource.js +2 -0
  336. package/lib/src/generated/api/RpcMethods.d.ts +841 -0
  337. package/lib/src/generated/api/RpcMethods.js +86 -0
  338. package/lib/src/generated/api/RunInterpretationRequest.d.ts +27 -1
  339. package/lib/src/generated/api/RunInterpretationWithHarnessRequest.d.ts +52 -0
  340. package/lib/src/generated/api/RunInterpretationWithHarnessRequest.js +1 -0
  341. package/lib/src/generated/api/RuntimeComputeLogParams.d.ts +14 -0
  342. package/lib/src/generated/api/RuntimeComputeLogParams.js +2 -0
  343. package/lib/src/generated/api/RuntimeFriendStatusParams.d.ts +3 -0
  344. package/lib/src/generated/api/RuntimeFriendStatusParams.js +2 -0
  345. package/lib/src/generated/api/RuntimeGrantNotificationParams.d.ts +4 -0
  346. package/lib/src/generated/api/RuntimeGrantNotificationParams.js +2 -0
  347. package/lib/src/generated/api/RuntimeImportPerspectiveResult.d.ts +4 -0
  348. package/lib/src/generated/api/RuntimeImportPerspectiveResult.js +2 -0
  349. package/lib/src/generated/api/RuntimeImportResult.d.ts +6 -0
  350. package/lib/src/generated/api/RuntimeImportResult.js +1 -0
  351. package/lib/src/generated/api/RuntimeInfo.d.ts +5 -0
  352. package/lib/src/generated/api/RuntimeInfo.js +2 -0
  353. package/lib/src/generated/api/RuntimeNotificationIdParams.d.ts +3 -0
  354. package/lib/src/generated/api/RuntimeNotificationIdParams.js +2 -0
  355. package/lib/src/generated/api/RuntimeSendFriendMessageParams.d.ts +8 -0
  356. package/lib/src/generated/api/RuntimeSendFriendMessageParams.js +1 -0
  357. package/lib/src/generated/api/RuntimeSetFreeHostingEnabledParams.d.ts +3 -0
  358. package/lib/src/generated/api/RuntimeSetFreeHostingEnabledParams.js +2 -0
  359. package/lib/src/generated/api/RuntimeUnytSendHotParams.d.ts +4 -0
  360. package/lib/src/generated/api/RuntimeUnytSendHotParams.js +2 -0
  361. package/lib/src/generated/api/RuntimeUnytWalletHistoryParams.d.ts +4 -0
  362. package/lib/src/generated/api/RuntimeUnytWalletHistoryParams.js +2 -0
  363. package/lib/src/generated/api/RuntimeUpdateNotificationParams.d.ts +11 -0
  364. package/lib/src/generated/api/RuntimeUpdateNotificationParams.js +2 -0
  365. package/lib/src/generated/api/SentMessage.d.ts +5 -0
  366. package/lib/src/generated/api/SentMessage.js +1 -0
  367. package/lib/src/generated/api/SetHostRatesRequest.d.ts +4 -0
  368. package/lib/src/generated/api/SetHostRatesRequest.js +1 -0
  369. package/lib/src/generated/api/SetHotWalletAddressRequest.d.ts +3 -0
  370. package/lib/src/generated/api/SetHotWalletAddressRequest.js +2 -0
  371. package/lib/src/generated/api/SetOnlineStatusRequest.d.ts +4 -0
  372. package/lib/src/generated/api/SetOnlineStatusRequest.js +2 -0
  373. package/lib/src/generated/api/SetUnytMembraneProofRequest.d.ts +6 -0
  374. package/lib/src/generated/api/SetUnytMembraneProofRequest.js +2 -0
  375. package/lib/src/generated/api/SetUserFreeAccessRequest.d.ts +4 -0
  376. package/lib/src/generated/api/SetUserFreeAccessRequest.js +2 -0
  377. package/lib/src/generated/api/ShaclLinkTriple.d.ts +10 -0
  378. package/lib/src/generated/api/ShaclLinkTriple.js +2 -0
  379. package/lib/src/generated/api/SignalRequest.d.ts +5 -0
  380. package/lib/src/generated/api/SignalRequest.js +2 -0
  381. package/lib/src/generated/api/SubscribeQueryRequest.d.ts +3 -0
  382. package/lib/src/generated/api/SubscribeQueryRequest.js +2 -0
  383. package/lib/src/generated/api/TokenizerSource.d.ts +5 -0
  384. package/lib/src/generated/api/TokenizerSource.js +2 -0
  385. package/lib/src/generated/api/TokenizerSourceInput.d.ts +5 -0
  386. package/lib/src/generated/api/TokenizerSourceInput.js +2 -0
  387. package/lib/src/generated/api/TranscriptionTextFilter.d.ts +5 -0
  388. package/lib/src/generated/api/TranscriptionTextFilter.js +2 -0
  389. package/lib/src/generated/api/TriggeredNotification.d.ts +6 -0
  390. package/lib/src/generated/api/TriggeredNotification.js +1 -0
  391. package/lib/src/generated/api/TrustedAgentsWrapper.d.ts +6 -0
  392. package/lib/src/generated/api/TrustedAgentsWrapper.js +2 -0
  393. package/lib/src/generated/api/UnlockAgentRequest.d.ts +1 -1
  394. package/lib/src/generated/api/UnytVersionInfo.d.ts +19 -0
  395. package/lib/src/generated/api/UnytVersionInfo.js +2 -0
  396. package/lib/src/generated/api/UpdateLinkRequest.d.ts +1 -1
  397. package/lib/src/generated/api/UpdateProfileRequest.d.ts +5 -0
  398. package/lib/src/generated/api/UpdateProfileRequest.js +1 -0
  399. package/lib/src/generated/api/UserCreationResult.d.ts +5 -0
  400. package/lib/src/generated/api/UserCreationResult.js +2 -0
  401. package/lib/src/generated/api/UserStatistics.d.ts +2 -1
  402. package/lib/src/generated/api/UserStatistics.js +0 -1
  403. package/lib/src/generated/api/UsersAppInfo.d.ts +6 -0
  404. package/lib/src/generated/api/UsersAppInfo.js +2 -0
  405. package/lib/src/generated/api/UsersEmailParams.d.ts +3 -0
  406. package/lib/src/generated/api/UsersEmailParams.js +2 -0
  407. package/lib/src/generated/api/UsersEmailTestAction.d.ts +1 -0
  408. package/lib/src/generated/api/UsersEmailTestAction.js +2 -0
  409. package/lib/src/generated/api/UsersEmailTestParams.d.ts +14 -0
  410. package/lib/src/generated/api/UsersEmailTestParams.js +1 -0
  411. package/lib/src/generated/api/UsersEmailTestResult.d.ts +5 -0
  412. package/lib/src/generated/api/UsersEmailTestResult.js +2 -0
  413. package/lib/src/generated/api/UsersLoginParams.d.ts +8 -0
  414. package/lib/src/generated/api/UsersLoginParams.js +2 -0
  415. package/lib/src/generated/api/UsersRequestVerificationParams.d.ts +5 -0
  416. package/lib/src/generated/api/UsersRequestVerificationParams.js +1 -0
  417. package/lib/src/generated/api/UsersSetCreditsParams.d.ts +4 -0
  418. package/lib/src/generated/api/UsersSetCreditsParams.js +2 -0
  419. package/lib/src/generated/api/UsersVerifyEmailParams.d.ts +12 -0
  420. package/lib/src/generated/api/UsersVerifyEmailParams.js +2 -0
  421. package/lib/src/generated/api/ValidOutput.d.ts +29 -0
  422. package/lib/src/generated/api/ValidOutput.js +1 -0
  423. package/lib/src/generated/api/VoiceActivityParamsInput.d.ts +7 -0
  424. package/lib/src/generated/api/VoiceActivityParamsInput.js +2 -0
  425. package/lib/src/generated/api/index.d.ts +8 -0
  426. package/lib/src/generated/api/index.js +5 -3
  427. package/lib/src/generated/api/serde_json/JsonValue.d.ts +3 -0
  428. package/lib/src/generated/api/serde_json/JsonValue.js +2 -0
  429. package/lib/src/index.d.ts +2 -3
  430. package/lib/src/index.js +1 -3
  431. package/lib/src/language/LanguageClient.d.ts +3 -3
  432. package/lib/src/language/LanguageClient.js +6 -6
  433. package/lib/src/language/LanguageMeta.d.ts +1 -1
  434. package/lib/src/links/Links.d.ts +16 -5
  435. package/lib/src/links/Links.js +34 -0
  436. package/lib/src/model/Ad4mModel.js +131 -68
  437. package/lib/src/model/ModelQueryBuilder.d.ts +22 -1
  438. package/lib/src/model/ModelQueryBuilder.js +55 -16
  439. package/lib/src/model/decorators.d.ts +20 -2
  440. package/lib/src/model/decorators.js +43 -7
  441. package/lib/src/model/query-sparql.js +2 -3
  442. package/lib/src/model/shacl-gen.js +27 -9
  443. package/lib/src/model/types.d.ts +12 -0
  444. package/lib/src/neighbourhood/Neighbourhood.d.ts +1 -1
  445. package/lib/src/neighbourhood/NeighbourhoodClient.d.ts +5 -5
  446. package/lib/src/neighbourhood/NeighbourhoodClient.js +15 -15
  447. package/lib/src/notifyListeners.d.ts +2 -0
  448. package/lib/src/notifyListeners.js +12 -0
  449. package/lib/src/perspectives/AutoProcessor.d.ts +12 -80
  450. package/lib/src/perspectives/FlowInstance.d.ts +10 -2
  451. package/lib/src/perspectives/FlowInstance.js +23 -1
  452. package/lib/src/perspectives/FlowModels.d.ts +38 -1
  453. package/lib/src/perspectives/FlowModels.js +39 -2
  454. package/lib/src/perspectives/InterpretationModels.d.ts +2 -0
  455. package/lib/src/perspectives/InterpretationModels.js +6 -0
  456. package/lib/src/perspectives/Perspective.d.ts +8 -1
  457. package/lib/src/perspectives/Perspective.js +11 -0
  458. package/lib/src/perspectives/PerspectiveClient.d.ts +15 -51
  459. package/lib/src/perspectives/PerspectiveClient.js +58 -225
  460. package/lib/src/perspectives/PerspectiveDiff.d.ts +1 -1
  461. package/lib/src/perspectives/PerspectiveHandle.d.ts +15 -8
  462. package/lib/src/perspectives/PerspectiveHandle.js +25 -9
  463. package/lib/src/perspectives/PerspectiveProxy.d.ts +38 -64
  464. package/lib/src/perspectives/PerspectiveProxy.js +143 -215
  465. package/lib/src/perspectives/WakerSubscriptionManager.js +4 -8
  466. package/lib/src/runtime/RuntimeClient.d.ts +15 -27
  467. package/lib/src/runtime/RuntimeClient.js +57 -113
  468. package/lib/src/runtime/RuntimeTypes.d.ts +2 -2
  469. package/lib/src/runtime/RuntimeTypes.js +2 -2
  470. package/lib/src/shacl/SHACLFlow.d.ts +27 -2
  471. package/lib/src/shacl/SHACLFlow.js +55 -11
  472. package/lib/src/shacl/SHACLShape.d.ts +3 -0
  473. package/lib/src/shacl/SHACLShape.js +169 -321
  474. package/package.json +15 -16
  475. package/src/Ad4mClient.test.ts +403 -138
  476. package/src/Ad4mClient.ts +16 -12
  477. package/src/Literal.test.ts +32 -0
  478. package/src/Literal.ts +3 -3
  479. package/src/agent/Agent.ts +8 -0
  480. package/src/agent/AgentClient.ts +87 -195
  481. package/src/agent/mutatePublicPerspective.test.ts +110 -0
  482. package/src/ai/AIClient.ts +40 -43
  483. package/src/ai/transcription-stream.test.ts +54 -0
  484. package/src/apiClient.test.ts +613 -185
  485. package/src/apiClient.ts +282 -288
  486. package/src/cache/cache.test.ts +7 -8
  487. package/src/expression/Expression.ts +12 -3
  488. package/src/expression/ExpressionClient.ts +6 -7
  489. package/src/generated/api/AIPromptExamples.ts +3 -0
  490. package/src/generated/api/AIPromptExamplesInput.ts +3 -0
  491. package/src/generated/api/AITask.ts +4 -0
  492. package/src/generated/api/AITaskInput.ts +4 -0
  493. package/src/generated/api/AddAgentInfosRequest.ts +3 -0
  494. package/src/generated/api/AddLinkExpressionRequest.ts +1 -1
  495. package/src/generated/api/AddLinkRequest.ts +1 -1
  496. package/src/generated/api/AddLinksBulkRequest.ts +1 -1
  497. package/src/generated/api/AddSdnaRequest.ts +1 -1
  498. package/src/generated/api/Agent.ts +4 -0
  499. package/src/generated/api/AgentAddEntanglementProofsParams.ts +8 -0
  500. package/src/generated/api/AgentByDidParams.ts +3 -0
  501. package/src/generated/api/AgentRemoveAppParams.ts +3 -0
  502. package/src/generated/api/AgentRevokeTokenParams.ts +3 -0
  503. package/src/generated/api/AgentSignature.ts +3 -0
  504. package/src/generated/api/AgentStatus.ts +4 -0
  505. package/src/generated/api/AgentStatusChangedEvent.ts +7 -0
  506. package/src/generated/api/AgentUpdatedEvent.ts +7 -0
  507. package/src/generated/api/AiAddModelParams.ts +4 -0
  508. package/src/generated/api/AiAddTaskParams.ts +4 -0
  509. package/src/generated/api/AiDiscoverModelsParams.ts +7 -0
  510. package/src/generated/api/AiGetDefaultModelParams.ts +4 -0
  511. package/src/generated/api/AiIdParams.ts +3 -0
  512. package/src/generated/api/AiModelLoadingStatusParams.ts +6 -0
  513. package/src/generated/api/AiSetDefaultModelParams.ts +4 -0
  514. package/src/generated/api/AiTranscriptionCloseParams.ts +3 -0
  515. package/src/generated/api/AiTranscriptionOpenParams.ts +4 -0
  516. package/src/generated/api/AiUpdateModelParams.ts +4 -0
  517. package/src/generated/api/AiUpdateTaskParams.ts +4 -0
  518. package/src/generated/api/Apps.ts +4 -0
  519. package/src/generated/api/AuthInfo.ts +4 -0
  520. package/src/generated/api/AuthInfoInput.ts +1 -1
  521. package/src/generated/api/AutoProcessorEvent.ts +90 -0
  522. package/src/generated/api/AutoProcessorNeighbourhoodState.ts +33 -0
  523. package/src/generated/api/AutoProcessorStep.ts +9 -0
  524. package/src/generated/api/BroadcastRequest.ts +3 -0
  525. package/src/generated/api/Capability.ts +4 -0
  526. package/src/generated/api/CreateSubjectRequest.ts +1 -1
  527. package/src/generated/api/CreateUserRequest.ts +3 -0
  528. package/src/generated/api/DateTime.ts +3 -0
  529. package/src/generated/api/DecoratedExpressionProof.ts +3 -0
  530. package/src/generated/api/DecoratedLinkExpression.ts +6 -0
  531. package/src/generated/api/DecoratedNeighbourhoodExpression.ts +5 -0
  532. package/src/generated/api/DecoratedPerspective.ts +4 -0
  533. package/src/generated/api/DisposeQueryRequest.ts +3 -0
  534. package/src/generated/api/EntanglementProof.ts +3 -0
  535. package/src/generated/api/EntanglementProofInput.ts +1 -1
  536. package/src/generated/api/EntanglementProofPreflightRequest.ts +3 -0
  537. package/src/generated/api/EntanglementProofsWrapper.ts +7 -0
  538. package/src/generated/api/Events.ts +66 -0
  539. package/src/generated/api/ExceptionInfo.ts +4 -0
  540. package/src/generated/api/ExceptionOccurredEvent.ts +7 -0
  541. package/src/generated/api/ExceptionType.ts +3 -0
  542. package/src/generated/api/ExecuteCommandsRequest.ts +1 -1
  543. package/src/generated/api/ExportRequest.ts +1 -1
  544. package/src/generated/api/ExpressionInteractRequest.ts +4 -0
  545. package/src/generated/api/ExpressionProofInput.ts +1 -1
  546. package/src/generated/api/ExpressionRendered.ts +6 -0
  547. package/src/generated/api/ExpressionUrlRequest.ts +3 -0
  548. package/src/generated/api/FireOutcome.ts +11 -0
  549. package/src/generated/api/FriendSendMessageRequest.ts +1 -1
  550. package/src/generated/api/HostRate.ts +6 -0
  551. package/src/generated/api/HostingInfoResult.ts +13 -0
  552. package/src/generated/api/HostingInfoUser.ts +7 -0
  553. package/src/generated/api/HostingRequestPaymentResult.ts +3 -0
  554. package/src/generated/api/HostingUserInfo.ts +3 -0
  555. package/src/generated/api/HostingVersionInfo.ts +7 -0
  556. package/src/generated/api/HostingWalletResult.ts +8 -0
  557. package/src/generated/api/Icon.ts +3 -0
  558. package/src/generated/api/ImportResult.ts +4 -0
  559. package/src/generated/api/ImportStats.ts +3 -0
  560. package/src/generated/api/InteractionCall.ts +3 -0
  561. package/src/generated/api/InteractionCallWrapper.ts +6 -0
  562. package/src/generated/api/InteractionMeta.ts +4 -0
  563. package/src/generated/api/InteractionParameter.ts +3 -0
  564. package/src/generated/api/KeepAliveQueryRequest.ts +3 -0
  565. package/src/generated/api/LanguageAddressParams.ts +3 -0
  566. package/src/generated/api/LanguageHandle.ts +4 -0
  567. package/src/generated/api/LanguageListParams.ts +3 -0
  568. package/src/generated/api/LanguageMeta.ts +3 -0
  569. package/src/generated/api/LanguageMetaInput.ts +1 -1
  570. package/src/generated/api/LanguageRef.ts +3 -0
  571. package/src/generated/api/LanguageSettingsWrapper.ts +6 -0
  572. package/src/generated/api/LanguageWriteSettingsParams.ts +3 -0
  573. package/src/generated/api/LinkExpressionInput.ts +1 -1
  574. package/src/generated/api/LinkInput.ts +1 -1
  575. package/src/generated/api/LinkMutationRequest.ts +8 -0
  576. package/src/generated/api/LinkMutationsRequest.ts +4 -0
  577. package/src/generated/api/LinkStatus.ts +1 -1
  578. package/src/generated/api/LinkUpdateInput.ts +4 -0
  579. package/src/generated/api/LocalModel.ts +4 -0
  580. package/src/generated/api/LocalModelInput.ts +4 -0
  581. package/src/generated/api/MessageReceivedEvent.ts +7 -0
  582. package/src/generated/api/Model.ts +6 -0
  583. package/src/generated/api/ModelApi.ts +14 -0
  584. package/src/generated/api/ModelApiInput.ts +8 -0
  585. package/src/generated/api/ModelApiType.ts +3 -0
  586. package/src/generated/api/ModelInput.ts +6 -0
  587. package/src/generated/api/ModelType.ts +1 -1
  588. package/src/generated/api/Neighbourhood.ts +4 -0
  589. package/src/generated/api/NeighbourhoodBroadcastParams.ts +4 -0
  590. package/src/generated/api/NeighbourhoodOnlineStatusParams.ts +4 -0
  591. package/src/generated/api/NeighbourhoodPerspectivePayload.ts +9 -0
  592. package/src/generated/api/NeighbourhoodPhase.ts +8 -0
  593. package/src/generated/api/NeighbourhoodSignalFilter.ts +5 -0
  594. package/src/generated/api/NeighbourhoodSignalParams.ts +4 -0
  595. package/src/generated/api/NeighbourhoodSignedPerspective.ts +8 -0
  596. package/src/generated/api/NeighbourhoodUuidParams.ts +3 -0
  597. package/src/generated/api/Notification.ts +7 -0
  598. package/src/generated/api/NotificationGrantRequest.ts +6 -0
  599. package/src/generated/api/NotificationInput.ts +1 -1
  600. package/src/generated/api/NotificationTriggeredEvent.ts +8 -0
  601. package/src/generated/api/OnlineAgent.ts +4 -0
  602. package/src/generated/api/OutputRef.ts +11 -0
  603. package/src/generated/api/OverlayView.ts +25 -0
  604. package/src/generated/api/Perspective.ts +4 -0
  605. package/src/generated/api/PerspectiveAddAutoProcessorParams.ts +11 -0
  606. package/src/generated/api/PerspectiveAddLinkExpressionParams.ts +4 -0
  607. package/src/generated/api/PerspectiveAddLinkParams.ts +4 -0
  608. package/src/generated/api/PerspectiveAddLinksParams.ts +4 -0
  609. package/src/generated/api/PerspectiveAddSdnaParams.ts +7 -0
  610. package/src/generated/api/PerspectiveAddSdnaResult.ts +6 -0
  611. package/src/generated/api/PerspectiveCommitBatchParams.ts +3 -0
  612. package/src/generated/api/PerspectiveCreateSubjectParams.ts +3 -0
  613. package/src/generated/api/PerspectiveEvaluateGettersParams.ts +6 -0
  614. package/src/generated/api/PerspectiveExecuteCommandsParams.ts +3 -0
  615. package/src/generated/api/PerspectiveExpression.ts +5 -0
  616. package/src/generated/api/PerspectiveFlowProposalParams.ts +3 -0
  617. package/src/generated/api/PerspectiveFlowReceiptVerdict.ts +8 -0
  618. package/src/generated/api/PerspectiveFlowValidOutputsParams.ts +7 -0
  619. package/src/generated/api/PerspectiveGetSubjectDataParams.ts +3 -0
  620. package/src/generated/api/PerspectiveHandle.ts +5 -0
  621. package/src/generated/api/PerspectiveLinkDiff.ts +7 -0
  622. package/src/generated/api/PerspectiveLinkMutationsParams.ts +4 -0
  623. package/src/generated/api/PerspectiveLinkUpdatedWithOwner.ts +4 -0
  624. package/src/generated/api/PerspectiveLinkWithOwner.ts +4 -0
  625. package/src/generated/api/PerspectiveMintFlowReceiptParams.ts +3 -0
  626. package/src/generated/api/PerspectiveMintFlowReceiptResult.ts +9 -0
  627. package/src/generated/api/PerspectiveModelQueryParams.ts +6 -0
  628. package/src/generated/api/PerspectiveModelSubscribeResult.ts +6 -0
  629. package/src/generated/api/PerspectiveNamedShacl.ts +4 -0
  630. package/src/generated/api/PerspectiveProposeFlowTransitionParams.ts +4 -0
  631. package/src/generated/api/PerspectiveQueryLinksParams.ts +11 -0
  632. package/src/generated/api/PerspectiveQueryParams.ts +3 -0
  633. package/src/generated/api/PerspectiveQuerySubscriptionFilter.ts +3 -0
  634. package/src/generated/api/PerspectiveReceiptOutcome.ts +3 -0
  635. package/src/generated/api/PerspectiveRejectFlowProposalResult.ts +3 -0
  636. package/src/generated/api/PerspectiveRemoveAutoProcessorParams.ts +3 -0
  637. package/src/generated/api/PerspectiveRemoveLinkParams.ts +4 -0
  638. package/src/generated/api/PerspectiveRemoveLinksParams.ts +4 -0
  639. package/src/generated/api/PerspectiveRemovedWithOwner.ts +3 -0
  640. package/src/generated/api/PerspectiveResolveInterpretationParams.ts +6 -0
  641. package/src/generated/api/PerspectiveShacl.ts +4 -0
  642. package/src/generated/api/PerspectiveShaclNameParams.ts +3 -0
  643. package/src/generated/api/PerspectiveSparqlParams.ts +7 -0
  644. package/src/generated/api/PerspectiveState.ts +3 -0
  645. package/src/generated/api/PerspectiveStateFilter.ts +5 -0
  646. package/src/generated/api/PerspectiveSubjectClassesOfParams.ts +3 -0
  647. package/src/generated/api/PerspectiveSubscribeQueryResult.ts +3 -0
  648. package/src/generated/api/PerspectiveSubscriptionParams.ts +3 -0
  649. package/src/generated/api/PerspectiveUnsignedInput.ts +4 -0
  650. package/src/generated/api/PerspectiveUpdateLinkParams.ts +5 -0
  651. package/src/generated/api/PerspectiveUpdateParams.ts +3 -0
  652. package/src/generated/api/PerspectiveUuidParams.ts +3 -0
  653. package/src/generated/api/PerspectiveVerifyFlowReceiptParams.ts +9 -0
  654. package/src/generated/api/PerspectiveWithOwner.ts +4 -0
  655. package/src/generated/api/ProposeOutcome.ts +46 -0
  656. package/src/generated/api/PublicPerspectiveInput.ts +4 -0
  657. package/src/generated/api/PublishNeighbourhoodRequest.ts +2 -2
  658. package/src/generated/api/RemoveLinkRequest.ts +1 -1
  659. package/src/generated/api/RemoveLinksBulkRequest.ts +1 -1
  660. package/src/generated/api/RequestCapabilityRequest.ts +4 -0
  661. package/src/generated/api/RequestPaymentRequest.ts +3 -0
  662. package/src/generated/api/Resource.ts +3 -0
  663. package/src/generated/api/RpcMethods.ts +419 -0
  664. package/src/generated/api/RunInterpretationRequest.ts +28 -2
  665. package/src/generated/api/RunInterpretationWithHarnessRequest.ts +51 -0
  666. package/src/generated/api/RuntimeComputeLogParams.ts +15 -0
  667. package/src/generated/api/RuntimeFriendStatusParams.ts +3 -0
  668. package/src/generated/api/RuntimeGrantNotificationParams.ts +3 -0
  669. package/src/generated/api/RuntimeImportPerspectiveResult.ts +3 -0
  670. package/src/generated/api/RuntimeImportResult.ts +8 -0
  671. package/src/generated/api/RuntimeInfo.ts +3 -0
  672. package/src/generated/api/RuntimeNotificationIdParams.ts +3 -0
  673. package/src/generated/api/RuntimeSendFriendMessageParams.ts +8 -0
  674. package/src/generated/api/RuntimeSetFreeHostingEnabledParams.ts +3 -0
  675. package/src/generated/api/RuntimeUnytSendHotParams.ts +3 -0
  676. package/src/generated/api/RuntimeUnytWalletHistoryParams.ts +3 -0
  677. package/src/generated/api/RuntimeUpdateNotificationParams.ts +3 -0
  678. package/src/generated/api/SentMessage.ts +4 -0
  679. package/src/generated/api/SetHostRatesRequest.ts +4 -0
  680. package/src/generated/api/SetHotWalletAddressRequest.ts +3 -0
  681. package/src/generated/api/SetOnlineStatusRequest.ts +3 -0
  682. package/src/generated/api/SetUnytMembraneProofRequest.ts +7 -0
  683. package/src/generated/api/SetUserFreeAccessRequest.ts +3 -0
  684. package/src/generated/api/ShaclLinkTriple.ts +8 -0
  685. package/src/generated/api/SignalRequest.ts +3 -0
  686. package/src/generated/api/SubscribeQueryRequest.ts +3 -0
  687. package/src/generated/api/TokenizerSource.ts +3 -0
  688. package/src/generated/api/TokenizerSourceInput.ts +3 -0
  689. package/src/generated/api/TranscriptionTextFilter.ts +3 -0
  690. package/src/generated/api/TriggeredNotification.ts +4 -0
  691. package/src/generated/api/TrustedAgentsWrapper.ts +6 -0
  692. package/src/generated/api/UnlockAgentRequest.ts +1 -1
  693. package/src/generated/api/UnytVersionInfo.ts +20 -0
  694. package/src/generated/api/UpdateLinkRequest.ts +1 -1
  695. package/src/generated/api/UpdateProfileRequest.ts +4 -0
  696. package/src/generated/api/UserCreationResult.ts +3 -0
  697. package/src/generated/api/UserStatistics.ts +2 -1
  698. package/src/generated/api/UsersAppInfo.ts +6 -0
  699. package/src/generated/api/UsersEmailParams.ts +3 -0
  700. package/src/generated/api/UsersEmailTestAction.ts +3 -0
  701. package/src/generated/api/UsersEmailTestParams.ts +12 -0
  702. package/src/generated/api/UsersEmailTestResult.ts +7 -0
  703. package/src/generated/api/UsersLoginParams.ts +7 -0
  704. package/src/generated/api/UsersRequestVerificationParams.ts +4 -0
  705. package/src/generated/api/UsersSetCreditsParams.ts +3 -0
  706. package/src/generated/api/UsersVerifyEmailParams.ts +11 -0
  707. package/src/generated/api/ValidOutput.ts +30 -0
  708. package/src/generated/api/VoiceActivityParamsInput.ts +3 -0
  709. package/src/generated/api/index.ts +11 -2
  710. package/src/generated/api/serde_json/JsonValue.ts +3 -0
  711. package/src/index.ts +2 -3
  712. package/src/language/LanguageClient.ts +12 -13
  713. package/src/links/Links.ts +49 -3
  714. package/src/model/Ad4mModel.test.ts +308 -25
  715. package/src/model/Ad4mModel.ts +136 -73
  716. package/src/model/ModelQueryBuilder.ts +65 -18
  717. package/src/model/decorators.ts +64 -9
  718. package/src/model/query-sparql.ts +2 -3
  719. package/src/model/relation-filtering.test.ts +191 -0
  720. package/src/model/shacl-gen.ts +19 -9
  721. package/src/model/shacl-roundtrip.test.ts +52 -0
  722. package/src/model/types.ts +12 -0
  723. package/src/neighbourhood/NeighbourhoodClient.test.ts +60 -0
  724. package/src/neighbourhood/NeighbourhoodClient.ts +27 -27
  725. package/src/neighbourhood/NeighbourhoodProxy.test.ts +14 -9
  726. package/src/notifyListeners.test.ts +19 -0
  727. package/src/notifyListeners.ts +10 -0
  728. package/src/perspectives/AutoProcessor.ts +13 -82
  729. package/src/perspectives/FlowInstance.ts +29 -2
  730. package/src/perspectives/FlowModels.ts +47 -2
  731. package/src/perspectives/InterpretationModels.ts +4 -0
  732. package/src/perspectives/Perspective.ts +18 -2
  733. package/src/perspectives/PerspectiveClient.test.ts +122 -45
  734. package/src/perspectives/PerspectiveClient.ts +106 -303
  735. package/src/perspectives/PerspectiveHandle.ts +32 -9
  736. package/src/perspectives/PerspectiveProxy.test.ts +198 -194
  737. package/src/perspectives/PerspectiveProxy.ts +159 -226
  738. package/src/perspectives/WakerSubscriptionManager.test.ts +54 -1
  739. package/src/perspectives/WakerSubscriptionManager.ts +4 -8
  740. package/src/perspectives/link-updated-type.test.ts +55 -0
  741. package/src/perspectives/listener-leaks.test.ts +204 -0
  742. package/src/perspectives/shacl-rpc.test.ts +22 -27
  743. package/src/runtime/RuntimeClient.ts +75 -157
  744. package/src/runtime/RuntimeTypes.ts +3 -3
  745. package/src/shacl/SHACLFlow.test.ts +49 -1
  746. package/src/shacl/SHACLFlow.ts +66 -11
  747. package/src/shacl/SHACLShape.test.ts +160 -16
  748. package/src/shacl/SHACLShape.ts +160 -438
  749. package/lib/shims/reflect-metadata.d.ts +0 -0
  750. package/lib/shims/reflect-metadata.js +0 -0
  751. package/lib/shims/type-graphql.d.ts +0 -32
  752. package/lib/shims/type-graphql.js +0 -70
  753. package/lib/src/PubSub.d.ts +0 -17
  754. package/lib/src/PubSub.js +0 -17
  755. package/lib/src/agent/AgentResolver.d.ts +0 -30
  756. package/lib/src/agent/AgentResolver.js +0 -325
  757. package/lib/src/ai/AIResolver.d.ts +0 -75
  758. package/lib/src/ai/AIResolver.js +0 -455
  759. package/lib/src/buildSchema.d.ts +0 -1
  760. package/lib/src/buildSchema.js +0 -38
  761. package/lib/src/expression/ExpressionResolver.d.ts +0 -10
  762. package/lib/src/expression/ExpressionResolver.js +0 -106
  763. package/lib/src/language/LanguageContext.d.ts +0 -37
  764. package/lib/src/language/LanguageContext.js +0 -2
  765. package/lib/src/language/LanguageResolver.d.ts +0 -19
  766. package/lib/src/language/LanguageResolver.js +0 -143
  767. package/lib/src/links/Links.test.js +0 -33
  768. package/lib/src/model/Ad4mModel.test.js +0 -2055
  769. package/lib/src/model/Subject.d.ts +0 -25
  770. package/lib/src/model/Subject.js +0 -164
  771. package/lib/src/model/hydration-batch.d.ts +0 -34
  772. package/lib/src/model/hydration-batch.js +0 -147
  773. package/lib/src/model/hydration-batching.test.d.ts +0 -7
  774. package/lib/src/model/hydration-batching.test.js +0 -456
  775. package/lib/src/model/model-manifest.d.ts +0 -41
  776. package/lib/src/model/model-manifest.js +0 -11
  777. package/lib/src/model/prolog-facts.d.ts +0 -37
  778. package/lib/src/model/prolog-facts.js +0 -134
  779. package/lib/src/model/query-cache.test.js +0 -43
  780. package/lib/src/model/query-prolog.d.ts +0 -15
  781. package/lib/src/model/query-prolog.js +0 -140
  782. package/lib/src/model/query-sparql-batch.d.ts +0 -17
  783. package/lib/src/model/query-sparql-batch.js +0 -260
  784. package/lib/src/model/query-sparql.test.js +0 -312
  785. package/lib/src/model/relation-filtering.test.js +0 -838
  786. package/lib/src/model/subscription-delta.test.d.ts +0 -24
  787. package/lib/src/model/subscription-delta.test.js +0 -180
  788. package/lib/src/model/subscription-pool.d.ts +0 -39
  789. package/lib/src/model/subscription-pool.js +0 -165
  790. package/lib/src/neighbourhood/NeighbourhoodProxy.test.js +0 -73
  791. package/lib/src/neighbourhood/NeighbourhoodResolver.d.ts +0 -24
  792. package/lib/src/neighbourhood/NeighbourhoodResolver.js +0 -182
  793. package/lib/src/perspectives/Perspective.test.js +0 -20
  794. package/lib/src/perspectives/PerspectiveClient.test.js +0 -224
  795. package/lib/src/perspectives/PerspectiveResolver.d.ts +0 -56
  796. package/lib/src/perspectives/PerspectiveResolver.js +0 -519
  797. package/lib/src/runtime/RuntimeResolver.d.ts +0 -173
  798. package/lib/src/runtime/RuntimeResolver.js +0 -1122
  799. package/lib/src/schema.gql +0 -631
  800. package/lib/src/shacl/SHACLFlow.test.js +0 -205
  801. package/lib/src/shacl/SHACLShape.test.js +0 -418
  802. package/lib/src/unwrapApolloResult.d.ts +0 -2
  803. package/lib/src/unwrapApolloResult.js +0 -14
  804. /package/lib/src/{links/Links.test.d.ts → generated/api/AITask.js} +0 -0
  805. /package/lib/src/{model/Ad4mModel.test.d.ts → generated/api/AITaskInput.js} +0 -0
  806. /package/lib/src/{model/query-cache.test.d.ts → generated/api/Agent.js} +0 -0
  807. /package/lib/src/{model/query-sparql.test.d.ts → generated/api/AgentAddEntanglementProofsParams.js} +0 -0
  808. /package/lib/src/{model/relation-filtering.test.d.ts → generated/api/AgentStatus.js} +0 -0
  809. /package/lib/src/{neighbourhood/NeighbourhoodProxy.test.d.ts → generated/api/AgentStatusChangedEvent.js} +0 -0
  810. /package/lib/src/{perspectives/Perspective.test.d.ts → generated/api/AgentUpdatedEvent.js} +0 -0
  811. /package/lib/src/{perspectives/PerspectiveClient.test.d.ts → generated/api/AiAddModelParams.js} +0 -0
  812. /package/lib/src/{shacl/SHACLFlow.test.d.ts → generated/api/AiAddTaskParams.js} +0 -0
  813. /package/lib/src/{shacl/SHACLShape.test.d.ts → generated/api/AiGetDefaultModelParams.js} +0 -0
@@ -0,0 +1,60 @@
1
+ import { ApiClient } from "../apiClient";
2
+ import { PerspectiveExpression } from "../perspectives/Perspective";
3
+ import { NeighbourhoodClient } from "./NeighbourhoodClient";
4
+
5
+ /** A socket that opens at once and acknowledges every request, so the test can push server events. */
6
+ class FakeWebSocket {
7
+ static last: FakeWebSocket;
8
+ readyState = 0;
9
+ onopen: (() => void) | null = null;
10
+ onmessage: ((event: { data: string }) => void) | null = null;
11
+ onerror: ((e: unknown) => void) | null = null;
12
+ onclose: (() => void) | null = null;
13
+ constructor(public url: string) {
14
+ FakeWebSocket.last = this;
15
+ queueMicrotask(() => { this.readyState = 1; this.onopen?.(); });
16
+ }
17
+ send(data: string) {
18
+ const { id } = JSON.parse(data);
19
+ queueMicrotask(() => this.push({ id, result: true }));
20
+ }
21
+ close() { this.readyState = 3; }
22
+ push(message: Record<string, unknown>) { this.onmessage?.({ data: JSON.stringify(message) }); }
23
+ }
24
+
25
+ const handle = (uuid: string) => ({ uuid, name: null, neighbourhood: null, sharedUrl: null, state: "SYNCED", owners: null });
26
+ const signal = {
27
+ author: "did:test:alice",
28
+ timestamp: "2026-01-01T00:00:00Z",
29
+ data: { links: [] },
30
+ proof: { key: "key", signature: "sig", valid: true, invalid: false },
31
+ };
32
+ /** A `signal` event exactly as the executor sends it. */
33
+ const signalEvent = (perspectiveUuid: string) =>
34
+ ({ type: "signal", perspectiveUuid, perspective: handle(perspectiveUuid), signal, recipient: null });
35
+
36
+ describe("NeighbourhoodClient signal routing", () => {
37
+ const api = new ApiClient("http://localhost:0", undefined, FakeWebSocket as unknown as new (url: string) => WebSocket);
38
+ afterAll(() => api.closeAll());
39
+
40
+ it("delivers a signal only to the handlers of the perspective it belongs to", async () => {
41
+ const client = new NeighbourhoodClient("http://localhost:0", undefined, api);
42
+
43
+ const receivedA: PerspectiveExpression[] = [];
44
+ const receivedB: PerspectiveExpression[] = [];
45
+ await client.addSignalHandler("uuid-A", (s) => { receivedA.push(s) });
46
+ await client.addSignalHandler("uuid-B", (s) => { receivedB.push(s) });
47
+ expect(api.watchedEvents()).toEqual({ signal: ["uuid-A", "uuid-B"] });
48
+
49
+ FakeWebSocket.last.push(signalEvent("uuid-A"));
50
+
51
+ expect(receivedA).toHaveLength(1);
52
+ expect(receivedA[0]).toMatchObject({ author: "did:test:alice", data: { links: [] } });
53
+ expect(receivedB).toEqual([]);
54
+
55
+ // A signal for a perspective without handlers reaches no handler.
56
+ FakeWebSocket.last.push(signalEvent("uuid-C"));
57
+ expect(receivedA).toHaveLength(1);
58
+ expect(receivedB).toEqual([]);
59
+ });
60
+ });
@@ -1,11 +1,10 @@
1
- import { ApiClient } from "../apiClient"
1
+ import {ApiClient, CallOptions } from '../apiClient'
2
2
  import { Address } from "../Address"
3
3
  import { DID } from "../DID"
4
4
  import { OnlineAgent, TelepresenceSignalCallback } from "../language/Language"
5
- import { Perspective, PerspectiveUnsignedInput } from "../perspectives/Perspective"
5
+ import { Perspective, PerspectiveExpression, PerspectiveUnsignedInput } from "../perspectives/Perspective"
6
6
  import { PerspectiveHandle } from "../perspectives/PerspectiveHandle"
7
7
  import { NeighbourhoodProxy } from "./NeighbourhoodProxy"
8
- import type { JoinNeighbourhoodRequest, PublishNeighbourhoodRequest } from "../generated/api"
9
8
 
10
9
  export class NeighbourhoodClient {
11
10
  #apiClient: ApiClient
@@ -19,62 +18,64 @@ export class NeighbourhoodClient {
19
18
  async publishFromPerspective(
20
19
  perspectiveUUID: string,
21
20
  linkLanguage: Address,
22
- meta: Perspective
21
+ meta: Perspective,
22
+ options?: CallOptions,
23
23
  ): Promise<string> {
24
- return this.#apiClient.call<string>('neighbourhood.publish', {
25
- perspectiveUUID, linkLanguage, meta
26
- })
24
+ return this.#apiClient.call('neighbourhood.publish', {
25
+ perspectiveUuid: perspectiveUUID, linkLanguage, meta: Perspective.toWire(meta)
26
+ }, options)
27
27
  }
28
28
 
29
- async joinFromUrl(url: string): Promise<PerspectiveHandle> {
30
- return this.#apiClient.call<PerspectiveHandle>('neighbourhood.join', { url })
29
+ async joinFromUrl(url: string, options?: CallOptions): Promise<PerspectiveHandle> {
30
+ return PerspectiveHandle.fromWire(await this.#apiClient.call('neighbourhood.join', { url }, options))
31
31
  }
32
32
 
33
33
  async otherAgents(perspectiveUUID: string): Promise<DID[]> {
34
- return this.#apiClient.call<DID[]>('neighbourhood.otherAgents', { uuid: perspectiveUUID })
34
+ return this.#apiClient.call('neighbourhood.otherAgents', { uuid: perspectiveUUID })
35
35
  }
36
36
 
37
37
  async hasTelepresenceAdapter(perspectiveUUID: string): Promise<boolean> {
38
- return this.#apiClient.call<boolean>('neighbourhood.hasTelepresence', { uuid: perspectiveUUID })
38
+ return this.#apiClient.call('neighbourhood.hasTelepresence', { uuid: perspectiveUUID })
39
39
  }
40
40
 
41
41
  async onlineAgents(perspectiveUUID: string): Promise<OnlineAgent[]> {
42
- return this.#apiClient.call<OnlineAgent[]>('neighbourhood.onlineAgents', { uuid: perspectiveUUID })
42
+ const agents = await this.#apiClient.call('neighbourhood.onlineAgents', { uuid: perspectiveUUID })
43
+ return agents.map(({ did, status }) => ({ did, status: PerspectiveExpression.fromWire(status) }))
43
44
  }
44
45
 
45
46
  async setOnlineStatus(perspectiveUUID: string, status: Perspective): Promise<boolean> {
46
- return this.#apiClient.call<boolean>('neighbourhood.setOnlineStatus', { uuid: perspectiveUUID, status })
47
+ return this.#apiClient.call('neighbourhood.setOnlineStatus', { uuid: perspectiveUUID, status: Perspective.toWire(status) })
47
48
  }
48
49
 
49
50
  async setOnlineStatusU(perspectiveUUID: string, status: PerspectiveUnsignedInput): Promise<boolean> {
50
- return this.#apiClient.call<boolean>('neighbourhood.setOnlineStatus', { uuid: perspectiveUUID, status, signed: false })
51
+ return this.#apiClient.call('neighbourhood.setOnlineStatus', { uuid: perspectiveUUID, status, signed: false })
51
52
  }
52
53
 
53
54
  async sendSignal(perspectiveUUID: string, remoteAgentDid: string, payload: Perspective): Promise<boolean> {
54
- return this.#apiClient.call<boolean>('neighbourhood.sendSignal', {
55
- uuid: perspectiveUUID, remoteAgentDid, payload
55
+ return this.#apiClient.call('neighbourhood.sendSignal', {
56
+ uuid: perspectiveUUID, remoteAgentDid, payload: Perspective.toWire(payload)
56
57
  })
57
58
  }
58
59
 
59
60
  async sendSignalU(perspectiveUUID: string, remoteAgentDid: string, payload: PerspectiveUnsignedInput): Promise<boolean> {
60
- return this.#apiClient.call<boolean>('neighbourhood.sendSignal', {
61
+ return this.#apiClient.call('neighbourhood.sendSignal', {
61
62
  uuid: perspectiveUUID, remoteAgentDid, payload, signed: false
62
63
  })
63
64
  }
64
65
 
65
66
  async sendBroadcast(perspectiveUUID: string, payload: Perspective, loopback: boolean = false): Promise<boolean> {
66
- return this.#apiClient.call<boolean>('neighbourhood.sendBroadcast', {
67
- uuid: perspectiveUUID, payload, loopback
67
+ return this.#apiClient.call('neighbourhood.sendBroadcast', {
68
+ uuid: perspectiveUUID, payload: Perspective.toWire(payload), loopback
68
69
  })
69
70
  }
70
71
 
71
72
  async sendBroadcastU(perspectiveUUID: string, payload: PerspectiveUnsignedInput, loopback: boolean = false): Promise<boolean> {
72
- return this.#apiClient.call<boolean>('neighbourhood.sendBroadcast', {
73
+ return this.#apiClient.call('neighbourhood.sendBroadcast', {
73
74
  uuid: perspectiveUUID, payload, loopback, signed: false
74
75
  })
75
76
  }
76
77
 
77
- dispatchSignal(perspectiveUUID: string, signal: unknown) {
78
+ dispatchSignal(perspectiveUUID: string, signal: PerspectiveExpression) {
78
79
  const handlers = this.#signalHandlers.get(perspectiveUUID)
79
80
  if (handlers) {
80
81
  for (const handler of handlers) {
@@ -88,14 +89,13 @@ export class NeighbourhoodClient {
88
89
  }
89
90
 
90
91
  async subscribeToSignals(perspectiveUUID: string): Promise<void> {
91
- const unsub = this.#apiClient.subscribe(
92
- (data) => {
93
- if (data.type === 'signal') {
94
- this.dispatchSignal(perspectiveUUID, data.signal)
95
- }
96
- }
92
+ const unsub = this.#apiClient.on(
93
+ 'signal',
94
+ (event) => this.dispatchSignal(perspectiveUUID, PerspectiveExpression.fromWire(event.signal)),
95
+ { perspective: perspectiveUUID },
97
96
  )
98
97
  this.#signalUnsubscribers.set(perspectiveUUID, unsub)
98
+ await this.#apiClient.watchApplied()
99
99
  }
100
100
 
101
101
  async addSignalHandler(perspectiveUUID: string, handler: TelepresenceSignalCallback): Promise<void> {
@@ -1,7 +1,10 @@
1
1
  import { NeighbourhoodClient } from "./NeighbourhoodClient";
2
2
  import { NeighbourhoodProxy } from "./NeighbourhoodProxy";
3
+ import { Perspective, PerspectiveExpression } from "../perspectives/Perspective";
3
4
 
4
- // Mock ApiClient's subscribe to avoid real WebSocket connections
5
+ const signal = new PerspectiveExpression("did:test:alice", "2026-01-01T00:00:00Z", new Perspective(), { key: "key", signature: "sig" });
6
+
7
+ // Mock ApiClient's on() to avoid real WebSocket connections
5
8
  jest.mock('../apiClient', () => {
6
9
  return {
7
10
  ApiClient: jest.fn().mockImplementation(() => ({
@@ -9,7 +12,8 @@ jest.mock('../apiClient', () => {
9
12
  post: jest.fn(),
10
13
  put: jest.fn(),
11
14
  delete: jest.fn(),
12
- subscribe: jest.fn().mockReturnValue(() => {}),
15
+ on: jest.fn().mockReturnValue(() => {}),
16
+ watchApplied: jest.fn().mockResolvedValue(undefined),
13
17
  }))
14
18
  };
15
19
  });
@@ -38,7 +42,7 @@ describe("NeighbourhoodProxy", () => {
38
42
  neighbourhoodProxy.addSignalHandler(handler2);
39
43
  await promise;
40
44
 
41
- neighbourhoodClient.dispatchSignal(neighbourhoodURI, true);
45
+ neighbourhoodClient.dispatchSignal(neighbourhoodURI, signal);
42
46
 
43
47
  expect(callbacks).toBe(2);
44
48
  });
@@ -46,18 +50,19 @@ describe("NeighbourhoodProxy", () => {
46
50
  it("should not add multiple subscriptions when removing and adding another signal handler", async () => {
47
51
  const neighbourhoodURI = "did://123";
48
52
 
49
- // Track subscribe calls via the mock
50
- let subscribeCallCount = 0;
53
+ // Track on() calls via the mock
54
+ let onCallCount = 0;
51
55
  const { ApiClient } = jest.requireMock('../apiClient');
52
56
  ApiClient.mockImplementation(() => ({
53
57
  get: jest.fn(),
54
58
  post: jest.fn(),
55
59
  put: jest.fn(),
56
60
  delete: jest.fn(),
57
- subscribe: jest.fn().mockImplementation(() => {
58
- subscribeCallCount++;
61
+ on: jest.fn().mockImplementation(() => {
62
+ onCallCount++;
59
63
  return () => {};
60
64
  }),
65
+ watchApplied: jest.fn().mockResolvedValue(undefined),
61
66
  }));
62
67
 
63
68
  const neighbourhoodClient = new NeighbourhoodClient("http://localhost:0", "test-token");
@@ -86,10 +91,10 @@ describe("NeighbourhoodProxy", () => {
86
91
  await neighbourhoodProxy.addSignalHandler(handler2);
87
92
 
88
93
  // Check that subscription was re-created (handler1 removed = unsub, handler2 added = new sub)
89
- expect(subscribeCallCount).toBe(2);
94
+ expect(onCallCount).toBe(2);
90
95
 
91
96
  // Dispatch signal
92
- neighbourhoodClient.dispatchSignal(neighbourhoodURI, true);
97
+ neighbourhoodClient.dispatchSignal(neighbourhoodURI, signal);
93
98
 
94
99
  // Check that only handler2 was called (handler1 was removed)
95
100
  expect(callbacks1).toBe(0);
@@ -0,0 +1,19 @@
1
+ import { callSafely } from './notifyListeners'
2
+
3
+ describe('callSafely', () => {
4
+ it('logs a throw or a rejection with the label and raises neither', async () => {
5
+ const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {})
6
+ const unhandled = jest.fn()
7
+ process.on('unhandledRejection', unhandled)
8
+
9
+ callSafely(() => { throw new Error('sync boom') }, 'label:')
10
+ callSafely(async () => { throw new Error('async boom') }, 'label:')
11
+ await new Promise((r) => setTimeout(r, 0))
12
+
13
+ expect(errorSpy.mock.calls.map(([label, e]) => [label, (e as Error).message]))
14
+ .toEqual([['label:', 'sync boom'], ['label:', 'async boom']])
15
+ expect(unhandled).not.toHaveBeenCalled()
16
+ process.off('unhandledRejection', unhandled)
17
+ errorSpy.mockRestore()
18
+ })
19
+ })
@@ -0,0 +1,10 @@
1
+ /** Call `callback`. A throw, or a rejected promise from an async callback, is logged, not raised. */
2
+ export function callSafely<A extends unknown[]>(callback: (...args: A) => unknown, label: string, ...args: A): void {
3
+ const log = (e: unknown) => console.error(label, e)
4
+ try {
5
+ const result = callback(...args)
6
+ if (result instanceof Promise) result.catch(log)
7
+ } catch (e) {
8
+ log(e)
9
+ }
10
+ }
@@ -90,66 +90,6 @@ export type AutoProcessorStep =
90
90
  | "emptyTranscript"
91
91
  | "failed";
92
92
 
93
- /** A single step-signal from one auto-processor pass on one perspective. */
94
- export interface AutoProcessorEvent {
95
- type: "auto-processor-event";
96
- perspectiveUuid: string;
97
- processorId: string;
98
- /** DID of the agent that ran the pass (which peer claimed/processed/backed off). */
99
- agentDid?: string;
100
- step: AutoProcessorStep;
101
- /** The batch's source item ids (present from `batchReady` onward). */
102
- itemIds: string[];
103
- /**
104
- * Content hash of the batch — the same value
105
- * {@link AutoProcessorNeighbourhoodStateEvent.batchKey} carries, and the
106
- * key that joins the two streams.
107
- *
108
- * A UI that renders one row per pass subscribes to both: the
109
- * perspective-scoped neighbourhood stream opens the row (and names the
110
- * claimant), while this DID-scoped stream fills in the fine-grained
111
- * steps and LLM I/O for the pass this agent is running. Matching them on
112
- * `processorId` alone breaks as soon as a processor runs a second pass;
113
- * matching on `itemIds` means re-implementing the Rust SHA-256 and its
114
- * exact serialization. So both streams carry the same key.
115
- *
116
- * Present from `batchReady` onward. Optional on the type because a
117
- * pre-#903 executor does not send it — treat its absence as "cannot
118
- * correlate", not as an error.
119
- */
120
- batchKey?: string;
121
- /** Instance base URIs written by the pass (present on `processed`). */
122
- bases: string[];
123
- /** Free-form context for the step (a holder/elected DID, an error, …). */
124
- detail?: string;
125
- /** Raw LLM prompt this pass fed the model. Present ONLY on
126
- * `llmRequestSent` events, and only when the processor was configured
127
- * with `emitDebugEvents: true`. Never carried on `processed`. */
128
- llmInput?: string;
129
- /** Raw LLM response this pass received. Present ONLY on
130
- * `llmResponseReceived` events, and only when the processor was
131
- * configured with `emitDebugEvents: true`. Never carried on `processed`. */
132
- llmOutput?: string;
133
- /**
134
- * Name of the tool the harness LLM invoked (or that just returned).
135
- * Present on `toolCall` + `toolResult` events (harness path only).
136
- */
137
- toolName?: string;
138
- /**
139
- * JSON-encoded arguments the LLM sent to the tool. Present ONLY on
140
- * `toolCall`; absent on `toolResult` where {@link toolResult} carries
141
- * the return text instead.
142
- */
143
- toolArgsJson?: string;
144
- /**
145
- * The tool's return text. Present ONLY on `toolResult`; may be
146
- * pre-truncated by the emitter with an `…[truncated for event]`
147
- * marker when the tool returns a large payload (e.g. a `_query`
148
- * result). Consumers wanting the full text can re-run the tool.
149
- */
150
- toolResult?: string;
151
- }
152
-
153
93
  /**
154
94
  * Coarse-grained phase of a neighbourhood-state event.
155
95
  *
@@ -160,28 +100,6 @@ export interface AutoProcessorEvent {
160
100
  */
161
101
  export type NeighbourhoodPhase = "claimed" | "finished" | "abandoned";
162
102
 
163
- /**
164
- * `auto-processor-neighbourhood-state` — perspective-scoped observability
165
- * event. Fires when THIS executor claims, finishes, or abandons a batch.
166
- * Anyone with perspective read access sees it, so a UI can render "someone
167
- * is auto-processing this" without receiving the batch payload or LLM I/O.
168
- *
169
- * Cross-executor visibility (peer's claim reaching us via Holochain sync) is
170
- * NOT covered here; consumers who need that subscribe to `link-added` and
171
- * filter for the `has_claim` predicate on the shared perspective.
172
- */
173
- export interface AutoProcessorNeighbourhoodStateEvent {
174
- type: "auto-processor-neighbourhood-state";
175
- perspectiveUuid: string;
176
- processorId: string;
177
- /** DID that claimed the batch — the pass owner's DID. */
178
- claimantDid: string;
179
- /** SHA-256 hex of the batch's item-id set — merge `claimed` + `finished`
180
- * for the same key to render a single row in a UI. */
181
- batchKey: string;
182
- phase: NeighbourhoodPhase;
183
- }
184
-
185
103
  /**
186
104
  * Opt a one-shot `runInterpretation` call into the same event streams a
187
105
  * standing watch produces.
@@ -289,6 +207,13 @@ export interface AddAutoProcessorConfig {
289
207
  * see `RawScope`; the Rust watcher rejects `Model` scopes at runtime.
290
208
  */
291
209
  mintScope?: RawScope;
210
+ /**
211
+ * Tool-call budget for the interpretation-pass harness this processor
212
+ * runs. Omit / `0` → single-shot LLM path. `N > 0` → engage the
213
+ * tool-calling harness with a cap of N calls per pass. Round-tripped
214
+ * through the SDNA via `AutoProcessorConfig.maxToolCalls`.
215
+ */
216
+ maxToolCalls?: number;
292
217
  /**
293
218
  * Enable full debug observability: persists the raw LLM prompt + response
294
219
  * on the pass's `InterpretationRun` (`debugPrompt` / `debugResponse`) AND
@@ -315,3 +240,9 @@ export interface InterpretationOverlayInfo {
315
240
  /** `[realPredicate, stagedValue]` pairs — the model's proposed values. */
316
241
  inferred: [string, any][];
317
242
  }
243
+
244
+ /** A step signal from one auto-processor pass (`auto-processor-event`). */
245
+ export type { AutoProcessorEvent } from "../generated/api/AutoProcessorEvent";
246
+ /** This executor claimed, finished or abandoned a batch
247
+ * (`auto-processor-neighbourhood-state`). */
248
+ export type { AutoProcessorNeighbourhoodState as AutoProcessorNeighbourhoodStateEvent } from "../generated/api/AutoProcessorNeighbourhoodState";
@@ -59,6 +59,7 @@ import { PerspectiveProxy } from "./PerspectiveProxy";
59
59
  import { Ad4mModel } from "../model/Ad4mModel";
60
60
  import { FlowInstanceRecord, FlowTransitionProposal } from "./FlowModels";
61
61
  import { SHACLFlow, FlowState, FlowTransition } from "../shacl/SHACLFlow";
62
+ import type { JsonValue } from "../generated/api/serde_json/JsonValue";
62
63
 
63
64
  /** One fired flow transition, as returned by {@link FlowInstance.acceptProposal}
64
65
  * (and, engine-side, by every consensus pass). */
@@ -171,7 +172,8 @@ export interface FlowReceiptVerdict {
171
172
  * `verifyFlowReceipt`, never by inspection). */
172
173
  export interface FlowMintedReceipt {
173
174
  receiptUri: string;
174
- receipt: object;
175
+ /** The serialized `FlowReceipt`; pass it back to `verifyFlowReceipt`. */
176
+ receipt: JsonValue;
175
177
  }
176
178
 
177
179
  /**
@@ -232,7 +234,13 @@ export class FlowInstance {
232
234
  }
233
235
 
234
236
  /**
235
- * Mint a new `FlowInstance` on the given perspective (design doc §4.3).
237
+ * Start `flowName` on `baseExpression`: mint a new `FlowInstance` on the
238
+ * given perspective (design doc §4.3), or return the one already running
239
+ * there. Calling it twice, or from two clients, does not leave two runs;
240
+ * where two mints raced, every caller gets the earliest.
241
+ *
242
+ * A flow runs on a subject once: a run that has reached its last state is
243
+ * returned too, not replaced by a new one.
236
244
  *
237
245
  * Idempotently registers the hardwired `FlowInstanceRecord` +
238
246
  * `FlowTransitionProposal` @Model classes on first call — the on-graph
@@ -281,6 +289,25 @@ export class FlowInstance {
281
289
  // flow author who wants a specific state as the entry point must give
282
290
  // it the lowest `value` in the set.
283
291
  //
292
+ // A run already on this subject for this flow is the one to return:
293
+ // minting another would leave two runs, each with its own state, and
294
+ // every reader choosing between them. Two clients starting at the same
295
+ // moment can still both mint; the earliest run (then the lowest id) is
296
+ // the one each of them gets back from here on.
297
+ const existing = await FlowInstanceRecord.findAll(perspective, {
298
+ where: { flowUri: flow.flowUri, subject: baseExpression },
299
+ });
300
+ if (existing.length > 0) {
301
+ const startedAt = (r: FlowInstanceRecord) => {
302
+ const v = (r as any).createdAt;
303
+ return typeof v === "number" ? v : Number.POSITIVE_INFINITY;
304
+ };
305
+ const [first] = [...existing].sort(
306
+ (a, b) => startedAt(a) - startedAt(b) || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0),
307
+ );
308
+ return FlowInstance.wrap(perspective, flow, first);
309
+ }
310
+
284
311
  // Store the flow's URI, not the bare name — see FlowInstanceRecord's
285
312
  // docstring for the collision-across-modules argument (James PR #929 R5).
286
313
  const record = await FlowInstanceRecord.create(perspective, {
@@ -23,6 +23,25 @@ import { Ad4mModel } from "../model/Ad4mModel";
23
23
  import { HasMany, Optional, Property } from "../model/decorators";
24
24
  import { Model } from "../model/decorators";
25
25
 
26
+ /**
27
+ * The engine's proposer rule (`self_authored_proposer`: a `proposer` link
28
+ * signed by the DID it names) as a getter. Must match the `proposer` getter in
29
+ * `hardwired_sdna/flow_transition_proposal.json` byte for byte, as
30
+ * `ACCEPTED_BY_GETTER` must.
31
+ */
32
+ export const PROPOSER_GETTER =
33
+ 'SELECT ?target WHERE { ?source <ad4m://flow/proposer> ?target . FILTER EXISTS { ?_claim <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( ?source <ad4m://flow/proposer> ?target )>> ; <ad4m://ontology/author> ?_author ; <ad4m://ontology/proofValid> ?_valid . FILTER(STR(?_author) = STR(?target) && STR(?_valid) = "true") } }';
34
+
35
+ /**
36
+ * The engine's vote rule (`signed_by`: the link's author is the DID it names,
37
+ * and its signature verified) as a getter over the link's reifier. Must match
38
+ * the `acceptedBy` getter in `hardwired_sdna/flow_transition_proposal.json`
39
+ * byte for byte: whichever side registers the class first decides the stored
40
+ * shape.
41
+ */
42
+ export const ACCEPTED_BY_GETTER =
43
+ 'SELECT ?target WHERE { ?source <ad4m://acceptedBy> ?target . FILTER EXISTS { ?_vote <http://www.w3.org/1999/02/22-rdf-syntax-ns#reifies> <<( ?source <ad4m://acceptedBy> ?target )>> ; <ad4m://ontology/author> ?_author ; <ad4m://ontology/proofValid> ?_valid . FILTER(STR(?_author) = STR(?target) && STR(?_valid) = "true") } }';
44
+
26
45
  // ── FlowTransitionProposal ──────────────────────────────────────────────────
27
46
  // Mirrors the Rust hardwired `flow_transition_proposal.json` SDNA (once wired
28
47
  // on the engine side; see file header). One node per proposed transition; the
@@ -53,8 +72,13 @@ export class FlowTransitionProposal extends Ad4mModel {
53
72
  @Property({ through: "ad4m://flow/to_state", required: true })
54
73
  toState: string = "";
55
74
 
56
- /** DID of the agent that issued the proposal. */
57
- @Property({ through: "ad4m://flow/proposer", required: true })
75
+ /**
76
+ * DID of the agent that issued the proposal, read the way the engine reads
77
+ * it: only from a `proposer` link signed by the DID it names. Any member
78
+ * can write a `proposer` link naming someone else, and an unchecked read
79
+ * would show that DID instead (and drop the real proposer from the voters).
80
+ */
81
+ @Property({ through: "ad4m://flow/proposer", required: true, getter: PROPOSER_GETTER, datatype: "xsd:string" })
58
82
  proposer: string = "";
59
83
 
60
84
  /**
@@ -124,6 +148,27 @@ export class FlowTransitionProposal extends Ad4mModel {
124
148
  @Optional({ through: "ad4m://flow/rationale" })
125
149
  rationale?: string;
126
150
 
151
+ /**
152
+ * DIDs that accepted this proposal, as the consensus engine counts them:
153
+ * an `ad4m://acceptedBy` link counts only when it is signed by the DID it
154
+ * names, since anyone can write one naming someone else, and each DID once.
155
+ * The proposer's vote is implicit and the proposer may also accept, so the
156
+ * voters are the *set* `{ proposer } ∪ acceptedBy`, not its sum.
157
+ * Read-only: vote with `acceptProposal`, withdraw with `rejectProposal`.
158
+ */
159
+ @HasMany({ through: "ad4m://acceptedBy", getter: ACCEPTED_BY_GETTER, readOnly: true })
160
+ acceptedBy: string[] = [];
161
+
162
+ /**
163
+ * `"fired"` once this replica's consensus pass has recorded the transition
164
+ * this proposal settled. Per-replica bookkeeping, never an input to the
165
+ * engine's own derivation. Only this replica's own `Local` mark is read:
166
+ * a Shared one a peer wrote says nothing about what happened here.
167
+ * Read-only.
168
+ */
169
+ @Optional({ through: "ad4m://flow/resolved_as", readOnly: true, local: true })
170
+ resolvedAs?: string;
171
+
127
172
  // "When was this proposal written?" is answered by `Ad4mModel`'s built-in
128
173
  // `createdAt`, synthesized on hydration from the earliest link timestamp
129
174
  // of the proposal's own links (all written together during create_subject).
@@ -56,6 +56,10 @@ export class AutoProcessorConfig extends Ad4mModel {
56
56
  @HasMany({ through: "ad4m://interpretation_class", datatype: "xsd:string" })
57
57
  interpretationClasses: string[] = [];
58
58
 
59
+ /** Flow URIs (`{namespace}{name}Flow`) this processor runs flow features on; empty = off. */
60
+ @HasMany({ through: "ad4m://flow", datatype: "xsd:string" })
61
+ flows: string[] = [];
62
+
59
63
  /** Quiet-window (ms) after the last new item before a pass runs. */
60
64
  @Property({ through: "ad4m://debounce_ms", required: true })
61
65
  debounceMs: string = "200";
@@ -1,6 +1,9 @@
1
1
  import { ExpressionGeneric } from "../expression/Expression";
2
- import { Link, LinkExpression, LinkExpressionInput, LinkInput } from "../links/Links";
2
+ import { Link, LinkExpression, LinkExpressionInput, LinkInput, linkExpressionToWire } from "../links/Links";
3
3
  import { LinkQuery } from "./LinkQuery";
4
+ import type { DecoratedPerspective } from "../generated/api/DecoratedPerspective";
5
+ import type { Perspective as WirePerspective } from "../generated/api/Perspective";
6
+ import type { PerspectiveExpression as WirePerspectiveExpression } from "../generated/api/PerspectiveExpression";
4
7
 
5
8
  /** A Perspective represents subjective meaning, encoded through
6
9
  * associations between expressions, a.k.a. Links, that is a graph
@@ -25,6 +28,15 @@ export class Perspective {
25
28
  this.links = []
26
29
  }
27
30
  }
31
+
32
+ /** Build a Perspective (with its query helpers) from the executor's wire shape. */
33
+ static fromWire(wire: DecoratedPerspective | null): Perspective {
34
+ return new Perspective((wire?.links ?? []).map(LinkExpression.fromWire))
35
+ }
36
+
37
+ static toWire(perspective: Perspective): WirePerspective {
38
+ return { links: perspective.links.map(linkExpressionToWire) }
39
+ }
28
40
 
29
41
  /** Convenience function for filtering links just like with PerspectiveProxy */
30
42
  get(query: LinkQuery): LinkExpression[] {
@@ -104,4 +116,8 @@ export class PerspectiveUnsignedInput {
104
116
  return obj
105
117
  }
106
118
  }
107
- export class PerspectiveExpression extends ExpressionGeneric(Perspective) {};
119
+ export class PerspectiveExpression extends ExpressionGeneric(Perspective) {
120
+ static fromWire(wire: WirePerspectiveExpression): PerspectiveExpression {
121
+ return new PerspectiveExpression(wire.author, wire.timestamp, Perspective.fromWire(wire.data), wire.proof)
122
+ }
123
+ };