@dxos/plugin-observability 0.8.4-main.406dc2a → 0.8.4-main.52d7546f51

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 (195) hide show
  1. package/dist/lib/browser/app-graph-builder-7PBOGFFG.mjs +45 -0
  2. package/dist/lib/browser/app-graph-builder-7PBOGFFG.mjs.map +7 -0
  3. package/dist/lib/browser/chunk-3XZDP7JS.mjs +16 -0
  4. package/dist/lib/browser/chunk-3XZDP7JS.mjs.map +7 -0
  5. package/dist/lib/browser/chunk-T3EKFAAB.mjs +138 -0
  6. package/dist/lib/browser/chunk-T3EKFAAB.mjs.map +7 -0
  7. package/dist/lib/browser/chunk-UTYAG5Z3.mjs +123 -0
  8. package/dist/lib/browser/chunk-UTYAG5Z3.mjs.map +7 -0
  9. package/dist/lib/browser/cli/index.mjs +24 -0
  10. package/dist/lib/browser/cli/index.mjs.map +7 -0
  11. package/dist/lib/browser/client-ready-ZVLSHDH6.mjs +103 -0
  12. package/dist/lib/browser/client-ready-ZVLSHDH6.mjs.map +7 -0
  13. package/dist/lib/browser/index.mjs +73 -102
  14. package/dist/lib/browser/index.mjs.map +4 -4
  15. package/dist/lib/browser/meta.json +1 -1
  16. package/dist/lib/browser/operation-resolver-GJYJZPY3.mjs +79 -0
  17. package/dist/lib/browser/operation-resolver-GJYJZPY3.mjs.map +7 -0
  18. package/dist/lib/browser/react-surface-4RABGTCC.mjs +38 -0
  19. package/dist/lib/browser/react-surface-4RABGTCC.mjs.map +7 -0
  20. package/dist/lib/browser/settings-QQBXDLBH.mjs +36 -0
  21. package/dist/lib/browser/settings-QQBXDLBH.mjs.map +7 -0
  22. package/dist/lib/browser/state-SSUNAB2P.mjs +31 -0
  23. package/dist/lib/browser/state-SSUNAB2P.mjs.map +7 -0
  24. package/dist/lib/browser/types/index.mjs +12 -4
  25. package/dist/lib/node-esm/app-graph-builder-D77CGMCQ.mjs +46 -0
  26. package/dist/lib/node-esm/app-graph-builder-D77CGMCQ.mjs.map +7 -0
  27. package/dist/lib/node-esm/chunk-2ECMMPZY.mjs +18 -0
  28. package/dist/lib/node-esm/chunk-2ECMMPZY.mjs.map +7 -0
  29. package/dist/lib/node-esm/chunk-PE6CKAA6.mjs +124 -0
  30. package/dist/lib/node-esm/chunk-PE6CKAA6.mjs.map +7 -0
  31. package/dist/lib/node-esm/chunk-VC5HVE77.mjs +139 -0
  32. package/dist/lib/node-esm/chunk-VC5HVE77.mjs.map +7 -0
  33. package/dist/lib/node-esm/cli/index.mjs +25 -0
  34. package/dist/lib/node-esm/cli/index.mjs.map +7 -0
  35. package/dist/lib/node-esm/client-ready-JXG727PH.mjs +104 -0
  36. package/dist/lib/node-esm/client-ready-JXG727PH.mjs.map +7 -0
  37. package/dist/lib/node-esm/index.mjs +73 -102
  38. package/dist/lib/node-esm/index.mjs.map +4 -4
  39. package/dist/lib/node-esm/meta.json +1 -1
  40. package/dist/lib/node-esm/operation-resolver-NB7XDO3M.mjs +80 -0
  41. package/dist/lib/node-esm/operation-resolver-NB7XDO3M.mjs.map +7 -0
  42. package/dist/lib/node-esm/react-surface-ZHTRUHHM.mjs +39 -0
  43. package/dist/lib/node-esm/react-surface-ZHTRUHHM.mjs.map +7 -0
  44. package/dist/lib/node-esm/settings-IZ2DBP4E.mjs +37 -0
  45. package/dist/lib/node-esm/settings-IZ2DBP4E.mjs.map +7 -0
  46. package/dist/lib/node-esm/state-3HUC5SJV.mjs +32 -0
  47. package/dist/lib/node-esm/state-3HUC5SJV.mjs.map +7 -0
  48. package/dist/lib/node-esm/types/index.mjs +12 -4
  49. package/dist/types/src/ObservabilityPlugin.d.ts +3 -2
  50. package/dist/types/src/ObservabilityPlugin.d.ts.map +1 -1
  51. package/dist/types/src/capabilities/app-graph-builder/app-graph-builder.d.ts +6 -0
  52. package/dist/types/src/capabilities/app-graph-builder/app-graph-builder.d.ts.map +1 -0
  53. package/dist/types/src/capabilities/app-graph-builder/index.d.ts +3 -0
  54. package/dist/types/src/capabilities/app-graph-builder/index.d.ts.map +1 -0
  55. package/dist/types/src/capabilities/client-ready/client-ready.d.ts +10 -0
  56. package/dist/types/src/capabilities/client-ready/client-ready.d.ts.map +1 -0
  57. package/dist/types/src/capabilities/client-ready/index.d.ts +4 -0
  58. package/dist/types/src/capabilities/client-ready/index.d.ts.map +1 -0
  59. package/dist/types/src/capabilities/index.d.ts +6 -16
  60. package/dist/types/src/capabilities/index.d.ts.map +1 -1
  61. package/dist/types/src/capabilities/operation-resolver/index.d.ts +5 -0
  62. package/dist/types/src/capabilities/operation-resolver/index.d.ts.map +1 -0
  63. package/dist/types/src/capabilities/operation-resolver/operation-resolver.d.ts +7 -0
  64. package/dist/types/src/capabilities/operation-resolver/operation-resolver.d.ts.map +1 -0
  65. package/dist/types/src/capabilities/react-surface/index.d.ts +3 -0
  66. package/dist/types/src/capabilities/react-surface/index.d.ts.map +1 -0
  67. package/dist/types/src/capabilities/react-surface/react-surface.d.ts +5 -0
  68. package/dist/types/src/capabilities/react-surface/react-surface.d.ts.map +1 -0
  69. package/dist/types/src/capabilities/settings/index.d.ts +7 -0
  70. package/dist/types/src/capabilities/settings/index.d.ts.map +1 -0
  71. package/dist/types/src/capabilities/settings/settings.d.ts +10 -0
  72. package/dist/types/src/capabilities/settings/settings.d.ts.map +1 -0
  73. package/dist/types/src/capabilities/state/index.d.ts +11 -0
  74. package/dist/types/src/capabilities/state/index.d.ts.map +1 -0
  75. package/dist/types/src/capabilities/state/state.d.ts +13 -0
  76. package/dist/types/src/capabilities/state/state.d.ts.map +1 -0
  77. package/dist/types/src/cli/index.d.ts +2 -0
  78. package/dist/types/src/cli/index.d.ts.map +1 -0
  79. package/dist/types/src/cli/plugin.d.ts +3 -0
  80. package/dist/types/src/cli/plugin.d.ts.map +1 -0
  81. package/dist/types/src/components/FeedbackForm.d.ts +3 -3
  82. package/dist/types/src/components/FeedbackForm.d.ts.map +1 -1
  83. package/dist/types/src/components/FeedbackForm.stories.d.ts +35 -0
  84. package/dist/types/src/components/FeedbackForm.stories.d.ts.map +1 -0
  85. package/dist/types/src/components/HelpContainer.d.ts +1 -0
  86. package/dist/types/src/components/HelpContainer.d.ts.map +1 -1
  87. package/dist/types/src/components/ObservabilitySettings.d.ts +4 -2
  88. package/dist/types/src/components/ObservabilitySettings.d.ts.map +1 -1
  89. package/dist/types/src/index.d.ts +1 -2
  90. package/dist/types/src/index.d.ts.map +1 -1
  91. package/dist/types/src/meta.d.ts +2 -2
  92. package/dist/types/src/meta.d.ts.map +1 -1
  93. package/dist/types/src/translations.d.ts +3 -2
  94. package/dist/types/src/translations.d.ts.map +1 -1
  95. package/dist/types/src/types/capabilities.d.ts +27 -0
  96. package/dist/types/src/types/capabilities.d.ts.map +1 -0
  97. package/dist/types/src/types/events.d.ts +6 -0
  98. package/dist/types/src/types/events.d.ts.map +1 -0
  99. package/dist/types/src/types/index.d.ts +2 -0
  100. package/dist/types/src/types/index.d.ts.map +1 -1
  101. package/dist/types/src/types/schema.d.ts +57 -307
  102. package/dist/types/src/types/schema.d.ts.map +1 -1
  103. package/dist/types/tsconfig.tsbuildinfo +1 -1
  104. package/package.json +45 -33
  105. package/src/ObservabilityPlugin.ts +47 -46
  106. package/src/capabilities/app-graph-builder/app-graph-builder.ts +43 -0
  107. package/src/capabilities/app-graph-builder/index.ts +7 -0
  108. package/src/capabilities/client-ready/client-ready.ts +85 -0
  109. package/src/capabilities/client-ready/index.ts +9 -0
  110. package/src/capabilities/index.ts +6 -10
  111. package/src/capabilities/operation-resolver/index.ts +7 -0
  112. package/src/capabilities/operation-resolver/operation-resolver.ts +77 -0
  113. package/src/capabilities/react-surface/index.ts +7 -0
  114. package/src/capabilities/react-surface/react-surface.tsx +35 -0
  115. package/src/capabilities/settings/index.ts +7 -0
  116. package/src/capabilities/settings/settings.ts +34 -0
  117. package/src/capabilities/state/index.ts +7 -0
  118. package/src/capabilities/state/state.ts +30 -0
  119. package/src/cli/index.ts +5 -0
  120. package/src/cli/plugin.ts +28 -0
  121. package/src/components/FeedbackForm.stories.tsx +33 -0
  122. package/src/components/FeedbackForm.tsx +15 -66
  123. package/src/components/HelpContainer.tsx +40 -25
  124. package/src/components/ObservabilitySettings.tsx +19 -14
  125. package/src/index.ts +1 -2
  126. package/src/meta.ts +7 -2
  127. package/src/translations.ts +3 -2
  128. package/src/types/capabilities.ts +34 -0
  129. package/src/types/events.ts +15 -0
  130. package/src/types/index.ts +2 -0
  131. package/src/types/schema.ts +62 -194
  132. package/dist/lib/browser/app-graph-builder-MBPI6TGN.mjs +0 -44
  133. package/dist/lib/browser/app-graph-builder-MBPI6TGN.mjs.map +0 -7
  134. package/dist/lib/browser/chunk-5VM6D2EF.mjs +0 -179
  135. package/dist/lib/browser/chunk-5VM6D2EF.mjs.map +0 -7
  136. package/dist/lib/browser/chunk-G754T676.mjs +0 -18
  137. package/dist/lib/browser/chunk-G754T676.mjs.map +0 -7
  138. package/dist/lib/browser/chunk-RS66U4WR.mjs +0 -191
  139. package/dist/lib/browser/chunk-RS66U4WR.mjs.map +0 -7
  140. package/dist/lib/browser/chunk-SCJ3DALL.mjs +0 -11
  141. package/dist/lib/browser/chunk-SCJ3DALL.mjs.map +0 -7
  142. package/dist/lib/browser/client-ready-IV2NFN4M.mjs +0 -102
  143. package/dist/lib/browser/client-ready-IV2NFN4M.mjs.map +0 -7
  144. package/dist/lib/browser/intent-resolver-IZTKLP6N.mjs +0 -77
  145. package/dist/lib/browser/intent-resolver-IZTKLP6N.mjs.map +0 -7
  146. package/dist/lib/browser/react-surface-N7WRUNJ2.mjs +0 -32
  147. package/dist/lib/browser/react-surface-N7WRUNJ2.mjs.map +0 -7
  148. package/dist/lib/browser/settings-JOZ5BZDO.mjs +0 -25
  149. package/dist/lib/browser/settings-JOZ5BZDO.mjs.map +0 -7
  150. package/dist/lib/browser/state-OVWHPB7K.mjs +0 -26
  151. package/dist/lib/browser/state-OVWHPB7K.mjs.map +0 -7
  152. package/dist/lib/node-esm/app-graph-builder-LHLEY5QQ.mjs +0 -45
  153. package/dist/lib/node-esm/app-graph-builder-LHLEY5QQ.mjs.map +0 -7
  154. package/dist/lib/node-esm/chunk-4SMSG2RN.mjs +0 -13
  155. package/dist/lib/node-esm/chunk-4SMSG2RN.mjs.map +0 -7
  156. package/dist/lib/node-esm/chunk-H3QRVOIY.mjs +0 -180
  157. package/dist/lib/node-esm/chunk-H3QRVOIY.mjs.map +0 -7
  158. package/dist/lib/node-esm/chunk-SCOMEIPJ.mjs +0 -192
  159. package/dist/lib/node-esm/chunk-SCOMEIPJ.mjs.map +0 -7
  160. package/dist/lib/node-esm/chunk-ZS4YMD63.mjs +0 -19
  161. package/dist/lib/node-esm/chunk-ZS4YMD63.mjs.map +0 -7
  162. package/dist/lib/node-esm/client-ready-SL6BA2IP.mjs +0 -103
  163. package/dist/lib/node-esm/client-ready-SL6BA2IP.mjs.map +0 -7
  164. package/dist/lib/node-esm/intent-resolver-VW7XPMBG.mjs +0 -78
  165. package/dist/lib/node-esm/intent-resolver-VW7XPMBG.mjs.map +0 -7
  166. package/dist/lib/node-esm/react-surface-3PNZVMXB.mjs +0 -33
  167. package/dist/lib/node-esm/react-surface-3PNZVMXB.mjs.map +0 -7
  168. package/dist/lib/node-esm/settings-2AOUWDQY.mjs +0 -26
  169. package/dist/lib/node-esm/settings-2AOUWDQY.mjs.map +0 -7
  170. package/dist/lib/node-esm/state-5UHYHOJV.mjs +0 -27
  171. package/dist/lib/node-esm/state-5UHYHOJV.mjs.map +0 -7
  172. package/dist/types/src/capabilities/app-graph-builder.d.ts +0 -4
  173. package/dist/types/src/capabilities/app-graph-builder.d.ts.map +0 -1
  174. package/dist/types/src/capabilities/capabilities.d.ts +0 -12
  175. package/dist/types/src/capabilities/capabilities.d.ts.map +0 -1
  176. package/dist/types/src/capabilities/client-ready.d.ts +0 -10
  177. package/dist/types/src/capabilities/client-ready.d.ts.map +0 -1
  178. package/dist/types/src/capabilities/intent-resolver.d.ts +0 -7
  179. package/dist/types/src/capabilities/intent-resolver.d.ts.map +0 -1
  180. package/dist/types/src/capabilities/react-surface.d.ts +0 -4
  181. package/dist/types/src/capabilities/react-surface.d.ts.map +0 -1
  182. package/dist/types/src/capabilities/settings.d.ts +0 -4
  183. package/dist/types/src/capabilities/settings.d.ts.map +0 -1
  184. package/dist/types/src/capabilities/state.d.ts +0 -6
  185. package/dist/types/src/capabilities/state.d.ts.map +0 -1
  186. package/dist/types/src/events.d.ts +0 -5
  187. package/dist/types/src/events.d.ts.map +0 -1
  188. package/src/capabilities/app-graph-builder.ts +0 -47
  189. package/src/capabilities/capabilities.ts +0 -23
  190. package/src/capabilities/client-ready.ts +0 -98
  191. package/src/capabilities/intent-resolver.ts +0 -69
  192. package/src/capabilities/react-surface.tsx +0 -27
  193. package/src/capabilities/settings.ts +0 -21
  194. package/src/capabilities/state.ts +0 -22
  195. package/src/events.ts +0 -14
package/package.json CHANGED
@@ -1,9 +1,13 @@
1
1
  {
2
2
  "name": "@dxos/plugin-observability",
3
- "version": "0.8.4-main.406dc2a",
3
+ "version": "0.8.4-main.52d7546f51",
4
4
  "description": "DXOS app framework plugin for hooking up app observability",
5
5
  "homepage": "https://dxos.org",
6
6
  "bugs": "https://github.com/dxos/dxos/issues",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "https://github.com/dxos/dxos"
10
+ },
7
11
  "license": "MIT",
8
12
  "author": "DXOS.org",
9
13
  "sideEffects": true,
@@ -15,6 +19,12 @@
15
19
  "browser": "./dist/lib/browser/index.mjs",
16
20
  "node": "./dist/lib/node-esm/index.mjs"
17
21
  },
22
+ "./cli": {
23
+ "source": "./src/cli/index.ts",
24
+ "types": "./dist/types/src/cli/index.d.ts",
25
+ "browser": "./dist/lib/browser/cli/index.mjs",
26
+ "node": "./dist/lib/node-esm/cli/index.mjs"
27
+ },
18
28
  "./types": {
19
29
  "source": "./src/types/index.ts",
20
30
  "types": "./dist/types/src/types/index.d.ts",
@@ -35,44 +45,46 @@
35
45
  "src"
36
46
  ],
37
47
  "dependencies": {
38
- "@preact-signals/safe-react": "^0.9.0",
39
- "@preact/signals-core": "^1.12.1",
40
- "effect": "3.18.3",
48
+ "@effect-atom/atom": "^0.5.1",
49
+ "@effect-atom/atom-react": "^0.5.0",
50
+ "effect": "3.19.16",
41
51
  "localforage": "^1.10.0",
42
- "@dxos/app-framework": "0.8.4-main.406dc2a",
43
- "@dxos/async": "0.8.4-main.406dc2a",
44
- "@dxos/context": "0.8.4-main.406dc2a",
45
- "@dxos/echo": "0.8.4-main.406dc2a",
46
- "@dxos/live-object": "0.8.4-main.406dc2a",
47
- "@dxos/invariant": "0.8.4-main.406dc2a",
48
- "@dxos/local-storage": "0.8.4-main.406dc2a",
49
- "@dxos/log": "0.8.4-main.406dc2a",
50
- "@dxos/observability": "0.8.4-main.406dc2a",
51
- "@dxos/protocols": "0.8.4-main.406dc2a",
52
- "@dxos/react-client": "0.8.4-main.406dc2a",
53
- "@dxos/plugin-graph": "0.8.4-main.406dc2a",
54
- "@dxos/react-ui-form": "0.8.4-main.406dc2a",
55
- "@dxos/util": "0.8.4-main.406dc2a",
56
- "@dxos/react-ui-stack": "0.8.4-main.406dc2a"
52
+ "@dxos/app-toolkit": "0.8.4-main.52d7546f51",
53
+ "@dxos/app-framework": "0.8.4-main.52d7546f51",
54
+ "@dxos/async": "0.8.4-main.52d7546f51",
55
+ "@dxos/context": "0.8.4-main.52d7546f51",
56
+ "@dxos/effect": "0.8.4-main.52d7546f51",
57
+ "@dxos/invariant": "0.8.4-main.52d7546f51",
58
+ "@dxos/echo": "0.8.4-main.52d7546f51",
59
+ "@dxos/log": "0.8.4-main.52d7546f51",
60
+ "@dxos/observability": "0.8.4-main.52d7546f51",
61
+ "@dxos/operation": "0.8.4-main.52d7546f51",
62
+ "@dxos/plugin-graph": "0.8.4-main.52d7546f51",
63
+ "@dxos/protocols": "0.8.4-main.52d7546f51",
64
+ "@dxos/react-client": "0.8.4-main.52d7546f51",
65
+ "@dxos/react-hooks": "0.8.4-main.52d7546f51",
66
+ "@dxos/react-ui-form": "0.8.4-main.52d7546f51",
67
+ "@dxos/react-ui-stack": "0.8.4-main.52d7546f51",
68
+ "@dxos/util": "0.8.4-main.52d7546f51"
57
69
  },
58
70
  "devDependencies": {
59
- "@effect-rx/rx-react": "0.42.4",
60
- "@effect/platform": "0.92.1",
61
- "@types/react": "~19.2.2",
62
- "react": "~19.2.0",
71
+ "@effect-atom/atom-react": "^0.5.0",
72
+ "@effect/platform": "0.94.4",
73
+ "@types/react": "~19.2.7",
74
+ "react": "~19.2.3",
63
75
  "vite": "7.1.9",
64
- "@dxos/react-ui-theme": "0.8.4-main.406dc2a",
65
- "@dxos/react-ui": "0.8.4-main.406dc2a",
66
- "@dxos/storybook-utils": "0.8.4-main.406dc2a"
76
+ "@dxos/react-ui": "0.8.4-main.52d7546f51",
77
+ "@dxos/ui-theme": "0.8.4-main.52d7546f51",
78
+ "@dxos/storybook-utils": "0.8.4-main.52d7546f51"
67
79
  },
68
80
  "peerDependencies": {
69
- "@effect-rx/rx-react": "^0.34.1",
70
- "@effect/platform": "^0.80.12",
71
- "effect": "^3.13.3",
72
- "react": "^19.0.0",
73
- "react-dom": "^19.0.0",
74
- "@dxos/react-ui-theme": "0.8.4-main.406dc2a",
75
- "@dxos/react-ui": "0.8.4-main.406dc2a"
81
+ "@effect-atom/atom-react": "^0.5.0",
82
+ "@effect/platform": "0.94.4",
83
+ "effect": "3.19.16",
84
+ "react": "~19.2.3",
85
+ "react-dom": "~19.2.3",
86
+ "@dxos/ui-theme": "0.8.4-main.52d7546f51",
87
+ "@dxos/react-ui": "0.8.4-main.52d7546f51"
76
88
  },
77
89
  "publishConfig": {
78
90
  "access": "public"
@@ -2,69 +2,70 @@
2
2
  // Copyright 2025 DXOS.org
3
3
  //
4
4
 
5
- import { Capabilities, Events, allOf, contributes, defineModule, definePlugin } from '@dxos/app-framework';
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { ActivationEvent, ActivationEvents, Capability, Plugin } from '@dxos/app-framework';
8
+ import { AppActivationEvents, AppPlugin } from '@dxos/app-toolkit';
6
9
  import { type Observability } from '@dxos/observability';
7
10
 
8
11
  import {
9
12
  AppGraphBuilder,
10
13
  ClientReady,
11
- IntentResolver,
12
- ObservabilityCapabilities,
13
14
  ObservabilitySettings,
14
15
  ObservabilityState,
16
+ OperationResolver,
15
17
  ReactSurface,
16
18
  } from './capabilities';
17
- import { ClientReadyEvent, ObservabilityEvents } from './events';
18
19
  import { meta } from './meta';
19
20
  import { translations } from './translations';
21
+ import { ClientReadyEvent, ObservabilityEvents } from './types';
22
+ import { ObservabilityCapabilities } from './types';
20
23
 
21
24
  export type ObservabilityPluginOptions = {
22
25
  namespace: string;
23
- observability: () => Promise<Observability>;
26
+ observability: () => Promise<Observability.Observability>;
24
27
  };
25
28
 
26
- export const ObservabilityPlugin = definePlugin<ObservabilityPluginOptions>(meta, ({ namespace, observability }) => [
27
- defineModule({
28
- id: `${meta.id}/module/observability`,
29
- activatesOn: Events.Startup,
30
- activate: async () => contributes(ObservabilityCapabilities.Observability, await observability()),
31
- }),
32
- defineModule({
33
- id: `${meta.id}/module/settings`,
34
- activatesOn: Events.SetupSettings,
29
+ export const ObservabilityPlugin = Plugin.define<ObservabilityPluginOptions>(meta).pipe(
30
+ AppPlugin.addAppGraphModule({ activate: AppGraphBuilder }),
31
+ AppPlugin.addSurfaceModule({ activate: ReactSurface }),
32
+ AppPlugin.addTranslationsModule({ translations }),
33
+ Plugin.addModule(({ namespace, observability }) => ({
34
+ id: 'observability',
35
+ activatesOn: ActivationEvents.Startup,
36
+ activate: () =>
37
+ Effect.gen(function* () {
38
+ const obs = yield* Effect.tryPromise(() => observability());
39
+ return Capability.contributes(ObservabilityCapabilities.Observability, obs);
40
+ }),
41
+ })),
42
+ Plugin.addModule({
43
+ activatesOn: AppActivationEvents.SetupSettings,
35
44
  activate: ObservabilitySettings,
36
45
  }),
37
- defineModule({
38
- id: `${meta.id}/module/state`,
39
- activatesOn: Events.Startup,
46
+ Plugin.addModule(({ namespace }) => ({
47
+ id: Capability.getModuleTag(ObservabilityState),
48
+ activatesOn: ActivationEvents.Startup,
40
49
  activatesAfter: [ObservabilityEvents.StateReady],
41
50
  activate: () => ObservabilityState({ namespace }),
42
- }),
43
- defineModule({
44
- id: `${meta.id}/module/translations`,
45
- activatesOn: Events.SetupTranslations,
46
- activate: () => contributes(Capabilities.Translations, translations),
47
- }),
48
- defineModule({
49
- id: `${meta.id}/module/intent-resolver`,
50
- activatesOn: Events.SetupIntentResolver,
51
- activate: (context) => IntentResolver({ context, namespace }),
52
- }),
53
- defineModule({
54
- id: `${meta.id}/module/react-surface`,
55
- activatesOn: Events.SetupReactSurface,
56
- activate: ReactSurface,
57
- }),
58
- defineModule({
59
- id: `${meta.id}/module/app-graph-builder`,
60
- activatesOn: Events.SetupAppGraph,
61
- activate: AppGraphBuilder,
62
- }),
63
- defineModule({
64
- id: `${meta.id}/module/client-ready`,
65
- activatesOn: allOf(Events.DispatcherReady, ObservabilityEvents.StateReady, ClientReadyEvent),
66
- activate: async (context) => {
67
- return ClientReady({ context, observability: await observability(), namespace });
68
- },
69
- }),
70
- ]);
51
+ })),
52
+ Plugin.addModule(({ namespace }) => ({
53
+ id: Capability.getModuleTag(OperationResolver),
54
+ activatesOn: ActivationEvents.SetupOperationResolver,
55
+ activate: () => OperationResolver({ namespace }),
56
+ })),
57
+ Plugin.addModule(({ namespace, observability }) => ({
58
+ id: Capability.getModuleTag(ClientReady),
59
+ activatesOn: ActivationEvent.allOf(
60
+ ActivationEvents.OperationInvokerReady,
61
+ ObservabilityEvents.StateReady,
62
+ ClientReadyEvent,
63
+ ),
64
+ activate: () =>
65
+ Effect.gen(function* () {
66
+ const obs = yield* Effect.tryPromise(() => observability());
67
+ return yield* ClientReady({ namespace, observability: obs });
68
+ }),
69
+ })),
70
+ Plugin.make,
71
+ );
@@ -0,0 +1,43 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capability } from '@dxos/app-framework';
8
+ import { AppCapabilities } from '@dxos/app-toolkit';
9
+ import { GraphBuilder, NodeMatcher } from '@dxos/plugin-graph';
10
+
11
+ import { meta } from '../../meta';
12
+
13
+ // NOTE: Copied from @dxos/plugin-deck to break circular dependency.
14
+ const ATTENDABLE_PATH_SEPARATOR = '~';
15
+
16
+ const DECK_COMPANION_TYPE = 'dxos.org/plugin/deck/deck-companion';
17
+
18
+ export default Capability.makeModule(
19
+ Effect.fnUntraced(function* () {
20
+ const extensions = yield* Effect.all([
21
+ GraphBuilder.createExtension({
22
+ id: `${meta.id}/help`,
23
+ match: NodeMatcher.whenRoot,
24
+ connector: (node) =>
25
+ Effect.succeed([
26
+ {
27
+ id: [node.id, 'help'].join(ATTENDABLE_PATH_SEPARATOR),
28
+ type: DECK_COMPANION_TYPE,
29
+ data: null,
30
+ properties: {
31
+ label: ['help label', { ns: meta.id }],
32
+ icon: 'ph--question--regular',
33
+ disposition: 'hidden',
34
+ position: 'hoist',
35
+ },
36
+ },
37
+ ]),
38
+ }),
39
+ ]);
40
+
41
+ return Capability.contributes(AppCapabilities.AppGraphBuilder, extensions);
42
+ }),
43
+ );
@@ -0,0 +1,7 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { Capability } from '@dxos/app-framework';
6
+
7
+ export const AppGraphBuilder = Capability.lazy('AppGraphBuilder', () => import('./app-graph-builder'));
@@ -0,0 +1,85 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capabilities, Capability } from '@dxos/app-framework';
8
+ import { LayoutOperation, SettingsOperation } from '@dxos/app-toolkit';
9
+ import { type Observability, ObservabilityProvider } from '@dxos/observability';
10
+
11
+ import { meta } from '../../meta';
12
+ import { ClientCapability, ObservabilityCapabilities, ObservabilityOperation } from '../../types';
13
+
14
+ export type ClientReadyOptions = {
15
+ namespace: string;
16
+ observability: Observability.Observability;
17
+ };
18
+
19
+ export default Capability.makeModule(
20
+ Effect.fnUntraced(function* (props?: ClientReadyOptions) {
21
+ const { observability } = props!;
22
+ const manager = yield* Capability.get(Capabilities.PluginManager);
23
+ const { invokePromise } = yield* Capability.get(Capabilities.OperationInvoker);
24
+ const registry = yield* Capability.get(Capabilities.AtomRegistry);
25
+ const stateAtom = yield* Capability.get(ObservabilityCapabilities.State);
26
+ const client = yield* Capability.get(ClientCapability);
27
+
28
+ const sendPrivacyNotice = async () => {
29
+ const environment = client?.config?.values.runtime?.app?.env?.DX_ENVIRONMENT;
30
+ const notify =
31
+ environment && environment !== 'ci' && !environment.endsWith('.local') && !environment.endsWith('.lan');
32
+ const state = registry.get(stateAtom);
33
+ if (!state.notified && notify) {
34
+ await invokePromise(LayoutOperation.AddToast, {
35
+ id: `${meta.id}/notice`,
36
+ title: ['observability toast label', { ns: meta.id }],
37
+ description: ['observability toast description', { ns: meta.id }],
38
+ duration: Infinity,
39
+ icon: 'ph--info--regular',
40
+ actionLabel: ['observability toast action label', { ns: meta.id }],
41
+ actionAlt: ['observability toast action alt', { ns: meta.id }],
42
+ closeLabel: ['observability toast close label', { ns: meta.id }],
43
+ onAction: () => invokePromise(SettingsOperation.Open, { plugin: meta.id }),
44
+ });
45
+
46
+ registry.set(stateAtom, { ...registry.get(stateAtom), notified: true });
47
+ }
48
+ };
49
+
50
+ // Ensure errors are tagged with enabled plugins to help with reproductions.
51
+ const enabledPlugins = manager.getEnabled();
52
+ for (const plugin of enabledPlugins) {
53
+ observability.setTags({ [`pluginEnabled-${plugin}`]: 'true' }, 'errors');
54
+ }
55
+
56
+ yield* Effect.tryPromise(() =>
57
+ invokePromise(ObservabilityOperation.SendEvent, {
58
+ name: 'page.load',
59
+ properties: {
60
+ // TODO(wittjosiah): These apis are deprecated. Is there a better way to find this information?
61
+ loadDuration: window.performance.timing.loadEventEnd - window.performance.timing.loadEventStart,
62
+ },
63
+ }),
64
+ );
65
+
66
+ // Add client data providers.
67
+ yield* observability.addDataProvider(ObservabilityProvider.Client.identityProvider(client.services.services));
68
+ yield* observability.addDataProvider(ObservabilityProvider.Client.networkMetricsProvider(client.services.services));
69
+ yield* observability.addDataProvider(ObservabilityProvider.Client.runtimeMetricsProvider(client.services.services));
70
+ yield* observability.addDataProvider(ObservabilityProvider.Client.spacesMetricsProvider(client));
71
+
72
+ if (client.halo.identity.get()) {
73
+ yield* Effect.tryPromise(() => sendPrivacyNotice());
74
+ } else {
75
+ const subscription = client.halo.identity.subscribe(async (identity) => {
76
+ if (identity && observability) {
77
+ await sendPrivacyNotice();
78
+ subscription.unsubscribe();
79
+ }
80
+ });
81
+ }
82
+
83
+ return Capability.contributes(ObservabilityCapabilities.Observability, observability, () => observability.close());
84
+ }),
85
+ );
@@ -0,0 +1,9 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { Capability } from '@dxos/app-framework';
6
+
7
+ import { type ClientReadyOptions } from './client-ready';
8
+
9
+ export const ClientReady = Capability.lazy<ClientReadyOptions>('ClientReady', () => import('./client-ready'));
@@ -2,13 +2,9 @@
2
2
  // Copyright 2025 DXOS.org
3
3
  //
4
4
 
5
- import { lazy } from '@dxos/app-framework';
6
-
7
- export const AppGraphBuilder = lazy(() => import('./app-graph-builder'));
8
- export const ClientReady = lazy(() => import('./client-ready'));
9
- export const IntentResolver = lazy(() => import('./intent-resolver'));
10
- export const ReactSurface = lazy(() => import('./react-surface'));
11
- export const ObservabilitySettings = lazy(() => import('./settings'));
12
- export const ObservabilityState = lazy(() => import('./state'));
13
-
14
- export * from './capabilities';
5
+ export * from './app-graph-builder';
6
+ export * from './client-ready';
7
+ export * from './operation-resolver';
8
+ export * from './react-surface';
9
+ export * from './settings';
10
+ export * from './state';
@@ -0,0 +1,7 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { Capability } from '@dxos/app-framework';
6
+
7
+ export const OperationResolver = Capability.lazy('OperationResolver', () => import('./operation-resolver'));
@@ -0,0 +1,77 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capabilities, Capability } from '@dxos/app-framework';
8
+ import { AppCapabilities } from '@dxos/app-toolkit';
9
+ import { Observability } from '@dxos/observability';
10
+ import { OperationResolver } from '@dxos/operation';
11
+
12
+ import { type ObservabilitySettingsProps } from '../../components';
13
+ import { meta } from '../../meta';
14
+ import { ObservabilityCapabilities, ObservabilityOperation } from '../../types';
15
+
16
+ export default Capability.makeModule(
17
+ Effect.fnUntraced(function* (props?: { namespace: string }) {
18
+ const { namespace } = props!;
19
+ const capabilities = yield* Capability.Service;
20
+
21
+ return Capability.contributes(Capabilities.OperationResolver, [
22
+ //
23
+ // Toggle
24
+ //
25
+ OperationResolver.make({
26
+ operation: ObservabilityOperation.Toggle,
27
+ handler: Effect.fnUntraced(function* (input) {
28
+ const observability = yield* Capability.get(ObservabilityCapabilities.Observability);
29
+ const registry = capabilities.get(Capabilities.AtomRegistry);
30
+ const allSettings = capabilities.getAll(AppCapabilities.Settings);
31
+ const settingsObj = allSettings.find((s: AppCapabilities.Settings) => s.prefix === meta.id);
32
+ if (!settingsObj) {
33
+ return false;
34
+ }
35
+ const settings = registry.get(settingsObj.atom) as ObservabilitySettingsProps;
36
+ const newEnabled = input.state ?? !settings.enabled;
37
+ registry.set(settingsObj.atom, { ...settings, enabled: newEnabled });
38
+ observability.events.captureEvent('observability.toggle', {
39
+ enabled: newEnabled,
40
+ });
41
+
42
+ if (newEnabled) {
43
+ yield* observability.enable();
44
+ } else {
45
+ yield* observability.disable();
46
+ }
47
+ yield* Effect.promise(() => Observability.storeObservabilityDisabled(namespace, !newEnabled));
48
+ return newEnabled;
49
+ }),
50
+ }),
51
+
52
+ //
53
+ // SendEvent
54
+ //
55
+ OperationResolver.make({
56
+ operation: ObservabilityOperation.SendEvent,
57
+ handler: Effect.fnUntraced(function* (input) {
58
+ // NOTE: This is to ensure that events fired before observability is ready are still sent.
59
+ const observability = yield* Capability.waitFor(ObservabilityCapabilities.Observability);
60
+ const properties = input.properties ?? {};
61
+ observability.events.captureEvent(input.name, properties);
62
+ }),
63
+ }),
64
+
65
+ //
66
+ // CaptureUserFeedback
67
+ //
68
+ OperationResolver.make({
69
+ operation: ObservabilityOperation.CaptureUserFeedback,
70
+ handler: Effect.fnUntraced(function* (input) {
71
+ const observability = yield* Capability.get(ObservabilityCapabilities.Observability);
72
+ observability.feedback.captureUserFeedback({ message: input.message, includeLogs: input.includeLogs });
73
+ }),
74
+ }),
75
+ ]);
76
+ }),
77
+ );
@@ -0,0 +1,7 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { Capability } from '@dxos/app-framework';
6
+
7
+ export const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));
@@ -0,0 +1,35 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+ import React from 'react';
7
+
8
+ import { Capabilities, Capability } from '@dxos/app-framework';
9
+ import { Surface, useSettingsState } from '@dxos/app-framework/ui';
10
+ import { AppCapabilities } from '@dxos/app-toolkit';
11
+
12
+ import { HelpContainer, ObservabilitySettings, type ObservabilitySettingsProps } from '../../components';
13
+ import { meta } from '../../meta';
14
+
15
+ export default Capability.makeModule(() =>
16
+ Effect.succeed(
17
+ Capability.contributes(Capabilities.ReactSurface, [
18
+ Surface.create({
19
+ id: meta.id,
20
+ role: 'article',
21
+ filter: (data): data is { subject: AppCapabilities.Settings } =>
22
+ AppCapabilities.isSettings(data.subject) && data.subject.prefix === meta.id,
23
+ component: ({ data: { subject } }) => {
24
+ const { settings, updateSettings } = useSettingsState<ObservabilitySettingsProps>(subject.atom);
25
+ return <ObservabilitySettings settings={settings} onSettingsChange={updateSettings} />;
26
+ },
27
+ }),
28
+ Surface.create({
29
+ id: `${meta.id}/help`,
30
+ role: 'deck-companion--help',
31
+ component: () => <HelpContainer />,
32
+ }),
33
+ ]),
34
+ ),
35
+ );
@@ -0,0 +1,7 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { Capability } from '@dxos/app-framework';
6
+
7
+ export const ObservabilitySettings = Capability.lazy('ObservabilitySettings', () => import('./settings'));
@@ -0,0 +1,34 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capability } from '@dxos/app-framework';
8
+ import { AppCapabilities } from '@dxos/app-toolkit';
9
+ import { createKvsStore } from '@dxos/effect';
10
+
11
+ import { ObservabilitySettingsSchema } from '../../components';
12
+ import { meta } from '../../meta';
13
+ import { ObservabilityCapabilities } from '../../types';
14
+
15
+ export default Capability.makeModule(() =>
16
+ Effect.sync(() => {
17
+ const settingsAtom = createKvsStore({
18
+ key: meta.id,
19
+ schema: ObservabilitySettingsSchema,
20
+ defaultValue: () => ({
21
+ enabled: true,
22
+ }),
23
+ });
24
+
25
+ return [
26
+ Capability.contributes(ObservabilityCapabilities.Settings, settingsAtom),
27
+ Capability.contributes(AppCapabilities.Settings, {
28
+ prefix: meta.id,
29
+ schema: ObservabilitySettingsSchema,
30
+ atom: settingsAtom,
31
+ }),
32
+ ];
33
+ }),
34
+ );
@@ -0,0 +1,7 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { Capability } from '@dxos/app-framework';
6
+
7
+ export const ObservabilityState = Capability.lazy('ObservabilityState', () => import('./state'));
@@ -0,0 +1,30 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capabilities, Capability } from '@dxos/app-framework';
8
+ import { createKvsStore } from '@dxos/effect';
9
+ import { Observability } from '@dxos/observability';
10
+
11
+ import { meta } from '../../meta';
12
+ import { ObservabilityCapabilities } from '../../types';
13
+
14
+ export default Capability.makeModule(
15
+ Effect.fnUntraced(function* (props?: { namespace: string }) {
16
+ const { namespace } = props!;
17
+ const stateAtom = createKvsStore({
18
+ key: meta.id,
19
+ schema: ObservabilityCapabilities.StateSchema,
20
+ defaultValue: () => ({}),
21
+ });
22
+
23
+ // NOTE: Group is set at runtime, not persisted.
24
+ const group = yield* Effect.tryPromise(() => Observability.getObservabilityGroup(namespace));
25
+ const registry = yield* Capability.get(Capabilities.AtomRegistry);
26
+ registry.set(stateAtom, { ...registry.get(stateAtom), group });
27
+
28
+ return Capability.contributes(ObservabilityCapabilities.State, stateAtom);
29
+ }),
30
+ );
@@ -0,0 +1,5 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ export * from './plugin';
@@ -0,0 +1,28 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capabilities, Capability, Plugin } from '@dxos/app-framework';
8
+ import { AppPlugin } from '@dxos/app-toolkit';
9
+ import { OperationResolver } from '@dxos/operation';
10
+
11
+ import { meta } from '../meta';
12
+ import { ObservabilityOperation } from '../types';
13
+
14
+ // TODO(wittjosiah): Hook up.
15
+ export const ObservabilityPlugin = Plugin.define(meta).pipe(
16
+ AppPlugin.addOperationResolverModule({
17
+ activate: () =>
18
+ Effect.succeed(
19
+ Capability.contributes(Capabilities.OperationResolver, [
20
+ OperationResolver.make({
21
+ operation: ObservabilityOperation.SendEvent,
22
+ handler: () => Effect.void,
23
+ }),
24
+ ]),
25
+ ),
26
+ }),
27
+ Plugin.make,
28
+ );