@abot-ai/runtime 1.4.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1233) hide show
  1. package/README.md +20 -8
  2. package/dist/scripts/runtime-model-addition.d.ts +1 -1
  3. package/dist/scripts/runtime-model-addition.js +1 -1
  4. package/dist/src/capabilities/tool-executor.d.ts +4 -0
  5. package/dist/src/capabilities/tool-executor.js +9 -1
  6. package/dist/src/capabilities/tool-media.d.ts +21 -0
  7. package/dist/src/capabilities/tool-media.js +39 -0
  8. package/dist/src/capabilities/tool-request-resources.d.ts +17 -0
  9. package/dist/src/capabilities/tool-request-resources.js +1 -0
  10. package/dist/src/capabilities/tool-types.d.ts +9 -1
  11. package/dist/src/cli/host-companion-bundle.mjs +6391 -306
  12. package/dist/src/cli/host-companion-entry.js +14 -4
  13. package/dist/src/cli/host-companion-setup-target.d.ts +3 -0
  14. package/dist/src/cli/host-companion-setup-target.js +23 -0
  15. package/dist/src/cli/host-companion-startup.d.ts +2 -2
  16. package/dist/src/cli/host-companion-startup.js +23 -9
  17. package/dist/src/cli/host-companion.d.ts +1 -0
  18. package/dist/src/cli/host-companion.js +19 -19
  19. package/dist/{plugins/system/source → src/computer-access}/application-launch.js +1 -1
  20. package/dist/src/computer-access/client.d.ts +19 -0
  21. package/dist/src/computer-access/client.js +1 -0
  22. package/dist/{plugins/system/source → src/computer-access}/commands.js +1 -1
  23. package/dist/{plugins/system/source → src/computer-access}/companion/autostart.d.ts +2 -0
  24. package/dist/{plugins/system/source → src/computer-access}/companion/autostart.js +19 -2
  25. package/dist/src/computer-access/companion/broker-client.d.ts +10 -0
  26. package/dist/src/computer-access/companion/broker-client.js +149 -0
  27. package/dist/{plugins/system/source → src/computer-access}/companion/broker-location.js +11 -3
  28. package/dist/{plugins/system/source → src/computer-access}/companion/broker-server.js +22 -2
  29. package/dist/{plugins/system/source → src/computer-access}/companion/connection.d.ts +8 -2
  30. package/dist/{plugins/system/source → src/computer-access}/companion/connection.js +43 -3
  31. package/dist/src/computer-access/companion/local-installation.d.ts +13 -0
  32. package/dist/src/computer-access/companion/local-installation.js +142 -0
  33. package/dist/src/computer-access/companion/local-setup-process.d.ts +18 -0
  34. package/dist/src/computer-access/companion/local-setup-process.js +127 -0
  35. package/dist/{plugins/system/source → src/computer-access}/companion/native-address.d.ts +2 -2
  36. package/dist/{plugins/system/source → src/computer-access}/companion/native-address.js +24 -7
  37. package/dist/src/computer-access/companion/native-build-identity.d.ts +2 -0
  38. package/dist/src/computer-access/companion/native-build-identity.js +8 -0
  39. package/dist/src/computer-access/companion/native-loopback-lookup.d.ts +7 -0
  40. package/dist/src/computer-access/companion/native-loopback-lookup.js +33 -0
  41. package/dist/{plugins/system/source → src/computer-access}/companion/native-messages.js +9 -2
  42. package/dist/src/computer-access/companion/native-notifications.d.ts +16 -0
  43. package/dist/src/computer-access/companion/native-notifications.js +84 -0
  44. package/dist/src/computer-access/companion/native-observations.d.ts +15 -0
  45. package/dist/src/computer-access/companion/native-observations.js +67 -0
  46. package/dist/src/computer-access/companion/native-replacement.d.ts +19 -0
  47. package/dist/src/computer-access/companion/native-replacement.js +120 -0
  48. package/dist/src/computer-access/companion/native-runtime-installation.d.ts +15 -0
  49. package/dist/src/computer-access/companion/native-runtime-installation.js +218 -0
  50. package/dist/{plugins/system/source → src/computer-access}/companion/native-session.d.ts +5 -1
  51. package/dist/{plugins/system/source → src/computer-access}/companion/native-session.js +100 -13
  52. package/dist/{plugins/system/source → src/computer-access}/companion/native-state.d.ts +9 -4
  53. package/dist/{plugins/system/source → src/computer-access}/companion/native-state.js +25 -3
  54. package/dist/{plugins/system/source → src/computer-access}/companion/native-supervisor.d.ts +3 -0
  55. package/dist/src/computer-access/companion/native-supervisor.js +157 -0
  56. package/dist/src/computer-access/companion/notification-directory-ownership.d.ts +13 -0
  57. package/dist/src/computer-access/companion/notification-directory-ownership.js +112 -0
  58. package/dist/src/computer-access/companion/notification-directory-windows.d.ts +3 -0
  59. package/dist/src/computer-access/companion/notification-directory-windows.js +15 -0
  60. package/dist/src/computer-access/companion/notification-directory.d.ts +5 -0
  61. package/dist/src/computer-access/companion/notification-directory.js +72 -0
  62. package/dist/src/computer-access/companion/notification-installation.d.ts +10 -0
  63. package/dist/src/computer-access/companion/notification-installation.js +214 -0
  64. package/dist/src/computer-access/companion/notification-linux.d.ts +20 -0
  65. package/dist/src/computer-access/companion/notification-linux.js +207 -0
  66. package/dist/src/computer-access/companion/notification-locations.d.ts +12 -0
  67. package/dist/src/computer-access/companion/notification-locations.js +20 -0
  68. package/dist/src/computer-access/companion/notification-macos.d.ts +11 -0
  69. package/dist/src/computer-access/companion/notification-macos.js +143 -0
  70. package/dist/src/computer-access/companion/notification-process.d.ts +10 -0
  71. package/dist/src/computer-access/companion/notification-process.js +49 -0
  72. package/dist/src/computer-access/companion/notification-protocol.d.ts +15 -0
  73. package/dist/src/computer-access/companion/notification-protocol.js +73 -0
  74. package/dist/src/computer-access/companion/notification-readiness-state.d.ts +9 -0
  75. package/dist/src/computer-access/companion/notification-readiness-state.js +32 -0
  76. package/dist/src/computer-access/companion/notification-readiness.d.ts +4 -0
  77. package/dist/src/computer-access/companion/notification-readiness.js +36 -0
  78. package/dist/src/computer-access/companion/notification-windows.d.ts +5 -0
  79. package/dist/src/computer-access/companion/notification-windows.js +137 -0
  80. package/dist/src/computer-access/companion/observation-broker.d.ts +4 -0
  81. package/dist/src/computer-access/companion/observation-broker.js +61 -0
  82. package/dist/src/computer-access/companion/observation-capture-policy.d.ts +7 -0
  83. package/dist/src/computer-access/companion/observation-capture-policy.js +7 -0
  84. package/dist/src/computer-access/companion/observation-client.d.ts +4 -0
  85. package/dist/src/computer-access/companion/observation-client.js +107 -0
  86. package/dist/src/computer-access/companion/observation-connection.d.ts +24 -0
  87. package/dist/src/computer-access/companion/observation-connection.js +120 -0
  88. package/dist/src/computer-access/companion/observation-filter.d.ts +12 -0
  89. package/dist/src/computer-access/companion/observation-filter.js +180 -0
  90. package/dist/src/computer-access/companion/observation-linux.d.ts +1 -0
  91. package/dist/src/computer-access/companion/observation-linux.js +228 -0
  92. package/dist/src/computer-access/companion/observation-macos-permission.d.ts +2 -0
  93. package/dist/src/computer-access/companion/observation-macos-permission.js +26 -0
  94. package/dist/src/computer-access/companion/observation-macos.d.ts +1 -0
  95. package/dist/src/computer-access/companion/observation-macos.js +189 -0
  96. package/dist/src/computer-access/companion/observation-process.d.ts +16 -0
  97. package/dist/src/computer-access/companion/observation-process.js +154 -0
  98. package/dist/src/computer-access/companion/observation-protocol.d.ts +16 -0
  99. package/dist/src/computer-access/companion/observation-protocol.js +95 -0
  100. package/dist/src/computer-access/companion/observation-redaction.d.ts +9 -0
  101. package/dist/src/computer-access/companion/observation-redaction.js +140 -0
  102. package/dist/src/computer-access/companion/observation-windows.d.ts +1 -0
  103. package/dist/src/computer-access/companion/observation-windows.js +173 -0
  104. package/dist/{plugins/system/source → src/computer-access}/companion/pairing-store.d.ts +6 -0
  105. package/dist/{plugins/system/source → src/computer-access}/companion/pairing-store.js +44 -0
  106. package/dist/{plugins/system/source → src/computer-access}/companion/process-owner-identity.d.ts +1 -0
  107. package/dist/{plugins/system/source → src/computer-access}/companion/process-owner-identity.js +14 -4
  108. package/dist/{plugins/system/source → src/computer-access}/companion/protocol.d.ts +18 -3
  109. package/dist/{plugins/system/source → src/computer-access}/companion/protocol.js +13 -0
  110. package/dist/src/computer-access/companion/release-version.d.ts +7 -0
  111. package/dist/src/computer-access/companion/release-version.js +12 -0
  112. package/dist/src/computer-access/computer/action-input.d.ts +8 -0
  113. package/dist/src/computer-access/computer/action-input.js +107 -0
  114. package/dist/src/computer-access/computer/companion-backend.d.ts +3 -0
  115. package/dist/src/computer-access/computer/companion-backend.js +73 -0
  116. package/dist/src/computer-access/computer/companion-sessions.d.ts +25 -0
  117. package/dist/src/computer-access/computer/companion-sessions.js +189 -0
  118. package/dist/src/computer-access/computer/desktop-action-queue.d.ts +1 -0
  119. package/dist/src/computer-access/computer/desktop-action-queue.js +41 -0
  120. package/dist/src/computer-access/computer/linux-backend.d.ts +3 -0
  121. package/dist/src/computer-access/computer/linux-backend.js +16 -0
  122. package/dist/src/computer-access/computer/linux-desktop.d.ts +1 -0
  123. package/dist/src/computer-access/computer/linux-desktop.js +165 -0
  124. package/dist/src/computer-access/computer/linux-frame.d.ts +2 -0
  125. package/dist/src/computer-access/computer/linux-frame.js +29 -0
  126. package/dist/src/computer-access/computer/linux-helper.d.ts +1 -0
  127. package/dist/src/computer-access/computer/linux-helper.js +161 -0
  128. package/dist/src/computer-access/computer/linux-input.d.ts +2 -0
  129. package/dist/src/computer-access/computer/linux-input.js +174 -0
  130. package/dist/src/computer-access/computer/linux-portal-source.d.ts +2 -0
  131. package/dist/src/computer-access/computer/linux-portal-source.js +62 -0
  132. package/dist/src/computer-access/computer/linux-portal.d.ts +2 -0
  133. package/dist/src/computer-access/computer/linux-portal.js +268 -0
  134. package/dist/src/computer-access/computer/linux-topology.d.ts +2 -0
  135. package/dist/src/computer-access/computer/linux-topology.js +92 -0
  136. package/dist/src/computer-access/computer/linux-x11.d.ts +2 -0
  137. package/dist/src/computer-access/computer/linux-x11.js +217 -0
  138. package/dist/src/computer-access/computer/macos-backend.d.ts +3 -0
  139. package/dist/src/computer-access/computer/macos-backend.js +28 -0
  140. package/dist/src/computer-access/computer/macos-capture.d.ts +1 -0
  141. package/dist/src/computer-access/computer/macos-capture.js +117 -0
  142. package/dist/src/computer-access/computer/macos-desktop.d.ts +1 -0
  143. package/dist/src/computer-access/computer/macos-desktop.js +185 -0
  144. package/dist/src/computer-access/computer/macos-helper.d.ts +1 -0
  145. package/dist/src/computer-access/computer/macos-helper.js +117 -0
  146. package/dist/src/computer-access/computer/macos-input.d.ts +1 -0
  147. package/dist/src/computer-access/computer/macos-input.js +267 -0
  148. package/dist/src/computer-access/computer/macos-prerequisites.d.ts +2 -0
  149. package/dist/src/computer-access/computer/macos-prerequisites.js +25 -0
  150. package/dist/src/computer-access/computer/macos-topology.d.ts +2 -0
  151. package/dist/src/computer-access/computer/macos-topology.js +34 -0
  152. package/dist/src/computer-access/computer/native-backend.d.ts +3 -0
  153. package/dist/src/computer-access/computer/native-backend.js +10 -0
  154. package/dist/src/computer-access/computer/native-protocol.d.ts +129 -0
  155. package/dist/src/computer-access/computer/native-protocol.js +1 -0
  156. package/dist/src/computer-access/computer/native-validation.d.ts +7 -0
  157. package/dist/src/computer-access/computer/native-validation.js +152 -0
  158. package/dist/src/computer-access/computer/unix-native-process.d.ts +12 -0
  159. package/dist/src/computer-access/computer/unix-native-process.js +155 -0
  160. package/dist/src/computer-access/computer/unix-native-results.d.ts +7 -0
  161. package/dist/src/computer-access/computer/unix-native-results.js +73 -0
  162. package/dist/src/computer-access/computer/windows-accessibility-script.d.ts +2 -0
  163. package/dist/src/computer-access/computer/windows-accessibility-script.js +87 -0
  164. package/dist/src/computer-access/computer/windows-backend.d.ts +7 -0
  165. package/dist/src/computer-access/computer/windows-backend.js +50 -0
  166. package/dist/src/computer-access/computer/windows-capture-script.d.ts +2 -0
  167. package/dist/src/computer-access/computer/windows-capture-script.js +69 -0
  168. package/dist/src/computer-access/computer/windows-desktop-script.d.ts +2 -0
  169. package/dist/src/computer-access/computer/windows-desktop-script.js +129 -0
  170. package/dist/src/computer-access/computer/windows-helper-process.d.ts +18 -0
  171. package/dist/src/computer-access/computer/windows-helper-process.js +93 -0
  172. package/dist/src/computer-access/computer/windows-helper-script.d.ts +2 -0
  173. package/dist/src/computer-access/computer/windows-helper-script.js +17 -0
  174. package/dist/src/computer-access/computer/windows-input-script.d.ts +2 -0
  175. package/dist/src/computer-access/computer/windows-input-script.js +171 -0
  176. package/dist/src/computer-access/computer/windows-keyboard-script.d.ts +2 -0
  177. package/dist/src/computer-access/computer/windows-keyboard-script.js +81 -0
  178. package/dist/src/computer-access/computer/windows-native-script.d.ts +2 -0
  179. package/dist/src/computer-access/computer/windows-native-script.js +157 -0
  180. package/dist/src/computer-access/computer/windows-result.d.ts +4 -0
  181. package/dist/src/computer-access/computer/windows-result.js +105 -0
  182. package/dist/src/computer-access/computer/windows-topology-script.d.ts +2 -0
  183. package/dist/src/computer-access/computer/windows-topology-script.js +80 -0
  184. package/dist/{plugins/system/source → src/computer-access}/handlers.d.ts +1 -1
  185. package/dist/{plugins/system/source → src/computer-access}/handlers.js +1 -1
  186. package/dist/{plugins/system/source → src/computer-access}/host-evidence.d.ts +1 -1
  187. package/dist/{plugins/system/source → src/computer-access}/host-evidence.js +1 -1
  188. package/dist/{plugins/system/source → src/computer-access}/process-result.d.ts +1 -1
  189. package/dist/{plugins/system/source → src/computer-access}/process-result.js +1 -1
  190. package/dist/src/model-gateway/client/chat.js +5 -2
  191. package/dist/src/model-gateway/client/input-token-count.js +2 -1
  192. package/dist/src/model-gateway/client/message-projection.js +1 -0
  193. package/dist/src/model-gateway/client/raw.js +5 -3
  194. package/dist/src/model-gateway/observability/content-trace-policy.d.ts +2 -0
  195. package/dist/src/model-gateway/observability/content-trace-policy.js +7 -0
  196. package/dist/src/model-gateway/observability/provider-trace.js +17 -4
  197. package/dist/src/model-gateway/observability/tool-media-privacy.d.ts +6 -0
  198. package/dist/src/model-gateway/observability/tool-media-privacy.js +50 -0
  199. package/dist/src/model-gateway/protocol/message-contract.js +16 -2
  200. package/dist/src/model-gateway/providers/ollama/adapter.js +6 -5
  201. package/dist/src/model-gateway/providers/ollama/message-projection.js +2 -0
  202. package/dist/src/model-gateway/providers/openai/adapter.js +10 -7
  203. package/dist/src/model-gateway/providers/openai/image-content.d.ts +8 -0
  204. package/dist/src/model-gateway/providers/openai/image-content.js +28 -0
  205. package/dist/src/model-gateway/providers/openai/input-token-count.js +3 -2
  206. package/dist/src/model-gateway/providers/openai/payload.js +5 -2
  207. package/dist/src/model-gateway/types.d.ts +5 -1
  208. package/dist/src/plugin-sdk/computer-access.d.ts +13 -0
  209. package/dist/src/plugin-sdk/computer-access.js +11 -0
  210. package/dist/src/plugin-sdk/index.d.ts +2 -0
  211. package/dist/src/plugin-sdk/index.js +1 -0
  212. package/dist/src/plugin-sdk/results.d.ts +1 -1
  213. package/dist/src/plugin-sdk/results.js +2 -0
  214. package/dist/src/runtime/adapters/co-worker-resources.d.ts +13 -0
  215. package/dist/src/runtime/adapters/co-worker-resources.js +74 -0
  216. package/dist/src/runtime/adapters/config-file-transaction.js +7 -0
  217. package/dist/src/runtime/adapters/default-session-adapters.d.ts +1 -1
  218. package/dist/src/runtime/adapters/file-session-store.js +2 -0
  219. package/dist/src/runtime/adapters/long-term-memory/file-repository.js +2 -0
  220. package/dist/src/runtime/adapters/long-term-memory/migration-backup.d.ts +3 -0
  221. package/dist/src/runtime/adapters/long-term-memory/migration-backup.js +44 -0
  222. package/dist/src/runtime/adapters/passive-learning-runtime.d.ts +28 -0
  223. package/dist/src/runtime/adapters/passive-learning-runtime.js +28 -0
  224. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/approval.d.ts +4 -1
  225. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/approval.js +25 -16
  226. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/prepared-execution.d.ts +16 -0
  227. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/prepared-execution.js +152 -0
  228. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/prepared-snapshot.d.ts +28 -0
  229. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/prepared-snapshot.js +118 -0
  230. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/run.js +13 -86
  231. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/tool-media-execution.d.ts +12 -0
  232. package/dist/src/runtime/adapters/registered-tool-normal-invocations/execution/tool-media-execution.js +30 -0
  233. package/dist/src/runtime/adapters/registered-tool-normal-invocations/executor.js +2 -0
  234. package/dist/src/runtime/adapters/registered-tool-normal-invocations/shared/contracts.d.ts +8 -1
  235. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/contracts.d.ts +2 -0
  236. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/execution.js +30 -58
  237. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/payload-observability.js +1 -1
  238. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/prepared-execution.d.ts +17 -0
  239. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/prepared-execution.js +65 -0
  240. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/prepared-snapshot.d.ts +15 -0
  241. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/prepared-snapshot.js +53 -0
  242. package/dist/src/runtime/adapters/registered-tool-worker-capabilities/result-evidence.js +10 -7
  243. package/dist/src/runtime/adapters/registered-tool-worker-capabilities.js +1 -0
  244. package/dist/src/runtime/adapters/scheduler-runtime.js +8 -4
  245. package/dist/src/runtime/attachments/request-tool-media-snapshot.d.ts +23 -0
  246. package/dist/src/runtime/attachments/request-tool-media-snapshot.js +101 -0
  247. package/dist/src/runtime/attachments/request-tool-media.d.ts +36 -0
  248. package/dist/src/runtime/attachments/request-tool-media.js +119 -0
  249. package/dist/src/runtime/attachments/tool-image-validation.d.ts +6 -0
  250. package/dist/src/runtime/attachments/tool-image-validation.js +83 -0
  251. package/dist/src/runtime/capabilities/configured-tool-registry.js +1 -1
  252. package/dist/src/runtime/capabilities/request-module-preparation.d.ts +2 -1
  253. package/dist/src/runtime/capabilities/request-module-preparation.js +3 -13
  254. package/dist/src/runtime/capabilities/request-property-narrowing.d.ts +3 -0
  255. package/dist/src/runtime/capabilities/request-property-narrowing.js +20 -0
  256. package/dist/src/runtime/capabilities/request-tool-resources.d.ts +33 -0
  257. package/dist/src/runtime/capabilities/request-tool-resources.js +92 -0
  258. package/dist/src/runtime/capabilities/request-tool-state.d.ts +13 -0
  259. package/dist/src/runtime/capabilities/request-tool-state.js +75 -0
  260. package/dist/src/runtime/capabilities/scheduling/job-list-page.d.ts +1 -1
  261. package/dist/src/runtime/composition.d.ts +6 -2
  262. package/dist/src/runtime/context/request-context-contracts.d.ts +2 -0
  263. package/dist/src/runtime/context/request-context.js +5 -1
  264. package/dist/src/runtime/context/semantic-compaction/snapshot.d.ts +9 -0
  265. package/dist/src/runtime/context/semantic-compaction/snapshot.js +20 -0
  266. package/dist/src/runtime/context/semantic-compaction/store.d.ts +2 -0
  267. package/dist/src/runtime/context/semantic-compaction/store.js +7 -0
  268. package/dist/src/runtime/context/session-memory/contracts.d.ts +7 -2
  269. package/dist/src/runtime/context/session-memory/controller.js +24 -3
  270. package/dist/src/runtime/context/session-memory/selection.js +9 -4
  271. package/dist/src/runtime/context/session-memory/snapshot-state.d.ts +9 -0
  272. package/dist/src/runtime/context/session-memory/snapshot-state.js +21 -0
  273. package/dist/src/runtime/context/session-memory/snapshot.d.ts +5 -0
  274. package/dist/src/runtime/context/session-memory/snapshot.js +9 -0
  275. package/dist/src/runtime/context/tool-media-projection.d.ts +10 -0
  276. package/dist/src/runtime/context/tool-media-projection.js +97 -0
  277. package/dist/src/runtime/lifecycle/request-finalizer.d.ts +4 -0
  278. package/dist/src/runtime/lifecycle/request-finalizer.js +45 -16
  279. package/dist/src/runtime/local-application.d.ts +27 -1
  280. package/dist/src/runtime/local-application.js +31 -3
  281. package/dist/src/runtime/local-host/app-learning-dispatch.d.ts +3 -0
  282. package/dist/src/runtime/local-host/app-learning-dispatch.js +54 -0
  283. package/dist/src/runtime/local-host/app-owner.js +54 -24
  284. package/dist/src/runtime/local-host/app-request-approvals.d.ts +18 -0
  285. package/dist/src/runtime/local-host/app-request-approvals.js +150 -0
  286. package/dist/src/runtime/local-host/app-request-control.d.ts +18 -2
  287. package/dist/src/runtime/local-host/app-request-control.js +153 -62
  288. package/dist/src/runtime/local-host/app-request-delivery.d.ts +16 -0
  289. package/dist/src/runtime/local-host/app-request-delivery.js +59 -0
  290. package/dist/src/runtime/local-host/client-learning.d.ts +10 -0
  291. package/dist/src/runtime/local-host/client-learning.js +45 -0
  292. package/dist/src/runtime/local-host/client-requests.d.ts +14 -2
  293. package/dist/src/runtime/local-host/client-requests.js +198 -41
  294. package/dist/src/runtime/local-host/client-services.d.ts +1 -1
  295. package/dist/src/runtime/local-host/contracts.d.ts +2 -0
  296. package/dist/src/runtime/local-host/learning-events.d.ts +4 -0
  297. package/dist/src/runtime/local-host/learning-events.js +24 -0
  298. package/dist/src/runtime/local-host/learning-preferences-input.d.ts +3 -0
  299. package/dist/src/runtime/local-host/learning-preferences-input.js +72 -0
  300. package/dist/src/runtime/local-host/pending-client-request.d.ts +40 -0
  301. package/dist/src/runtime/local-host/pending-client-request.js +152 -0
  302. package/dist/src/runtime/local-host/reconnectable-connection.d.ts +4 -0
  303. package/dist/src/runtime/local-host/reconnectable-connection.js +96 -0
  304. package/dist/src/runtime/local-host/request-approval-contracts.d.ts +31 -0
  305. package/dist/src/runtime/local-host/request-approval-contracts.js +1 -0
  306. package/dist/src/runtime/local-host/saved-approvals.d.ts +30 -0
  307. package/dist/src/runtime/local-host/saved-approvals.js +334 -0
  308. package/dist/src/runtime/local-host/startup-connection.d.ts +4 -1
  309. package/dist/src/runtime/local-host/startup-connection.js +1 -1
  310. package/dist/src/runtime/local-host/transport.js +5 -32
  311. package/dist/src/runtime/long-term-memory/automatic-management.d.ts +3 -0
  312. package/dist/src/runtime/long-term-memory/automatic-management.js +6 -0
  313. package/dist/src/runtime/long-term-memory/background-save-queue.js +1 -0
  314. package/dist/src/runtime/long-term-memory/candidate-preparation.d.ts +1 -2
  315. package/dist/src/runtime/long-term-memory/candidate-preparation.js +5 -4
  316. package/dist/src/runtime/long-term-memory/candidate-processing.d.ts +5 -3
  317. package/dist/src/runtime/long-term-memory/candidate-processing.js +78 -31
  318. package/dist/src/runtime/long-term-memory/change-notifications.d.ts +10 -0
  319. package/dist/src/runtime/long-term-memory/change-notifications.js +45 -0
  320. package/dist/src/runtime/long-term-memory/contracts.d.ts +24 -3
  321. package/dist/src/runtime/long-term-memory/conversation-authoring/context.d.ts +14 -0
  322. package/dist/src/runtime/long-term-memory/conversation-authoring/context.js +55 -0
  323. package/dist/src/runtime/long-term-memory/conversation-authoring/contract.d.ts +54 -0
  324. package/dist/src/runtime/long-term-memory/conversation-authoring/contract.js +86 -0
  325. package/dist/src/runtime/long-term-memory/conversation-authoring/prompt.d.ts +4 -0
  326. package/dist/src/runtime/long-term-memory/conversation-authoring/prompt.js +19 -0
  327. package/dist/src/runtime/long-term-memory/conversation-candidates.d.ts +29 -0
  328. package/dist/src/runtime/long-term-memory/conversation-candidates.js +71 -0
  329. package/dist/src/runtime/long-term-memory/diagnostics.js +10 -0
  330. package/dist/src/runtime/long-term-memory/management/contracts.d.ts +5 -0
  331. package/dist/src/runtime/long-term-memory/management/mutations.js +25 -3
  332. package/dist/src/runtime/long-term-memory/management/queries.js +6 -2
  333. package/dist/src/runtime/long-term-memory/management/search.js +5 -1
  334. package/dist/src/runtime/long-term-memory/management/validation.d.ts +2 -0
  335. package/dist/src/runtime/long-term-memory/management/validation.js +8 -0
  336. package/dist/src/runtime/long-term-memory/maturation/apply-diagnostics.d.ts +10 -0
  337. package/dist/src/runtime/long-term-memory/maturation/apply-diagnostics.js +47 -0
  338. package/dist/src/runtime/long-term-memory/maturation/authoring-policy.d.ts +2 -0
  339. package/dist/src/runtime/long-term-memory/maturation/authoring-policy.js +6 -0
  340. package/dist/src/runtime/long-term-memory/maturation/candidate-promotion.d.ts +12 -0
  341. package/dist/src/runtime/long-term-memory/maturation/candidate-promotion.js +51 -0
  342. package/dist/src/runtime/long-term-memory/maturation/context.d.ts +12 -0
  343. package/dist/src/runtime/long-term-memory/maturation/context.js +67 -0
  344. package/dist/src/runtime/long-term-memory/maturation/contracts.d.ts +120 -0
  345. package/dist/src/runtime/long-term-memory/maturation/contracts.js +1 -0
  346. package/dist/src/runtime/long-term-memory/maturation/conversation-evidence.d.ts +3 -0
  347. package/dist/src/runtime/long-term-memory/maturation/conversation-evidence.js +16 -0
  348. package/dist/src/runtime/long-term-memory/maturation/current-bindings.d.ts +4 -0
  349. package/dist/src/runtime/long-term-memory/maturation/current-bindings.js +53 -0
  350. package/dist/src/runtime/long-term-memory/maturation/decision-envelope.d.ts +22 -0
  351. package/dist/src/runtime/long-term-memory/maturation/decision-envelope.js +66 -0
  352. package/dist/src/runtime/long-term-memory/maturation/decisions.d.ts +5 -0
  353. package/dist/src/runtime/long-term-memory/maturation/decisions.js +131 -0
  354. package/dist/src/runtime/long-term-memory/maturation/embedding-binding.d.ts +5 -0
  355. package/dist/src/runtime/long-term-memory/maturation/embedding-binding.js +20 -0
  356. package/dist/src/runtime/long-term-memory/maturation/embedding-reservation.d.ts +3 -0
  357. package/dist/src/runtime/long-term-memory/maturation/embedding-reservation.js +17 -0
  358. package/dist/src/runtime/long-term-memory/maturation/evidence-contracts.d.ts +33 -0
  359. package/dist/src/runtime/long-term-memory/maturation/evidence-contracts.js +1 -0
  360. package/dist/src/runtime/long-term-memory/maturation/evidence.d.ts +7 -0
  361. package/dist/src/runtime/long-term-memory/maturation/evidence.js +42 -0
  362. package/dist/src/runtime/long-term-memory/maturation/maintenance-clock.d.ts +31 -0
  363. package/dist/src/runtime/long-term-memory/maturation/maintenance-clock.js +118 -0
  364. package/dist/src/runtime/long-term-memory/maturation/maintenance.d.ts +5 -0
  365. package/dist/src/runtime/long-term-memory/maturation/maintenance.js +40 -0
  366. package/dist/src/runtime/long-term-memory/maturation/memory-update.d.ts +12 -0
  367. package/dist/src/runtime/long-term-memory/maturation/memory-update.js +43 -0
  368. package/dist/src/runtime/long-term-memory/maturation/overview.d.ts +4 -0
  369. package/dist/src/runtime/long-term-memory/maturation/overview.js +30 -0
  370. package/dist/src/runtime/long-term-memory/maturation/policy.d.ts +5 -0
  371. package/dist/src/runtime/long-term-memory/maturation/policy.js +15 -0
  372. package/dist/src/runtime/long-term-memory/maturation/receipt-capacity.d.ts +8 -0
  373. package/dist/src/runtime/long-term-memory/maturation/receipt-capacity.js +33 -0
  374. package/dist/src/runtime/long-term-memory/maturation/retention-lifecycle.d.ts +13 -0
  375. package/dist/src/runtime/long-term-memory/maturation/retention-lifecycle.js +56 -0
  376. package/dist/src/runtime/long-term-memory/maturation/retention.d.ts +8 -0
  377. package/dist/src/runtime/long-term-memory/maturation/retention.js +42 -0
  378. package/dist/src/runtime/long-term-memory/maturation/scheduled-review.d.ts +11 -0
  379. package/dist/src/runtime/long-term-memory/maturation/scheduled-review.js +97 -0
  380. package/dist/src/runtime/long-term-memory/maturation/service.d.ts +7 -0
  381. package/dist/src/runtime/long-term-memory/maturation/service.js +105 -0
  382. package/dist/src/runtime/long-term-memory/maturation/source-state.d.ts +4 -0
  383. package/dist/src/runtime/long-term-memory/maturation/source-state.js +66 -0
  384. package/dist/src/runtime/long-term-memory/maturation/sources.d.ts +3 -0
  385. package/dist/src/runtime/long-term-memory/maturation/sources.js +12 -0
  386. package/dist/src/runtime/long-term-memory/maturation/state.d.ts +3 -0
  387. package/dist/src/runtime/long-term-memory/maturation/state.js +84 -0
  388. package/dist/src/runtime/long-term-memory/maturation/transition.d.ts +11 -0
  389. package/dist/src/runtime/long-term-memory/maturation/transition.js +126 -0
  390. package/dist/src/runtime/long-term-memory/maturation/write-targets.d.ts +4 -0
  391. package/dist/src/runtime/long-term-memory/maturation/write-targets.js +22 -0
  392. package/dist/src/runtime/long-term-memory/observation-contracts.d.ts +40 -0
  393. package/dist/src/runtime/long-term-memory/observation-contracts.js +1 -0
  394. package/dist/src/runtime/long-term-memory/observation-persistence.d.ts +10 -0
  395. package/dist/src/runtime/long-term-memory/observation-persistence.js +78 -0
  396. package/dist/src/runtime/long-term-memory/observation-receipt-retention.d.ts +3 -0
  397. package/dist/src/runtime/long-term-memory/observation-receipt-retention.js +18 -0
  398. package/dist/src/runtime/long-term-memory/observation-source.d.ts +3 -0
  399. package/dist/src/runtime/long-term-memory/observation-source.js +24 -0
  400. package/dist/src/runtime/long-term-memory/observation-state.d.ts +4 -0
  401. package/dist/src/runtime/long-term-memory/observation-state.js +58 -0
  402. package/dist/src/runtime/long-term-memory/projection.js +17 -1
  403. package/dist/src/runtime/long-term-memory/repository-state.js +105 -4
  404. package/dist/src/runtime/long-term-memory/service.js +32 -3
  405. package/dist/src/runtime/model/invalid-output-failure.d.ts +13 -0
  406. package/dist/src/runtime/model/invalid-output-failure.js +96 -0
  407. package/dist/src/runtime/model/invocation-identity.d.ts +2 -0
  408. package/dist/src/runtime/model/invocation-identity.js +6 -0
  409. package/dist/src/runtime/model/invoke-raw-step.js +5 -1
  410. package/dist/src/runtime/model/invoke-step.js +32 -14
  411. package/dist/src/runtime/model/invoke-structured-step.d.ts +1 -0
  412. package/dist/src/runtime/model/invoke-structured-step.js +4 -1
  413. package/dist/src/runtime/model/model-context-budget.d.ts +5 -0
  414. package/dist/src/runtime/model/model-context-budget.js +8 -0
  415. package/dist/src/runtime/model/model-step-port.d.ts +4 -0
  416. package/dist/src/runtime/model/provider-completion.d.ts +5 -2
  417. package/dist/src/runtime/model/provider-completion.js +7 -3
  418. package/dist/src/runtime/orchestration/capability-adapters/result.d.ts +2 -0
  419. package/dist/src/runtime/orchestration/capability-adapters/result.js +3 -0
  420. package/dist/src/runtime/orchestration/final-response/authoring-contract.d.ts +3 -1
  421. package/dist/src/runtime/orchestration/final-response/authoring-contract.js +5 -30
  422. package/dist/src/runtime/orchestration/final-response/finalization.d.ts +2 -0
  423. package/dist/src/runtime/orchestration/final-response/finalization.js +8 -2
  424. package/dist/src/runtime/orchestration/final-response/format.js +8 -28
  425. package/dist/src/runtime/orchestration/final-response/invoke.d.ts +2 -0
  426. package/dist/src/runtime/orchestration/final-response/invoke.js +1 -0
  427. package/dist/src/runtime/orchestration/lifecycle/execution-budgets.d.ts +8 -0
  428. package/dist/src/runtime/orchestration/lifecycle/execution-budgets.js +13 -0
  429. package/dist/src/runtime/orchestration/lifecycle/request-lifecycle.d.ts +21 -0
  430. package/dist/src/runtime/orchestration/lifecycle/request-lifecycle.js +121 -14
  431. package/dist/src/runtime/orchestration/role-calls/candidate-validation.js +2 -1
  432. package/dist/src/runtime/orchestration/role-calls/checkpoint-contract.d.ts +8 -0
  433. package/dist/src/runtime/orchestration/role-calls/checkpoint-contract.js +1 -0
  434. package/dist/src/runtime/orchestration/role-calls/checkpoint-state.d.ts +4 -0
  435. package/dist/src/runtime/orchestration/role-calls/checkpoint-state.js +79 -0
  436. package/dist/src/runtime/orchestration/role-calls/checkpoint.d.ts +8 -0
  437. package/dist/src/runtime/orchestration/role-calls/checkpoint.js +15 -0
  438. package/dist/src/runtime/orchestration/role-calls/child-return.js +3 -2
  439. package/dist/src/runtime/orchestration/role-calls/command-dispatch/child-transitions.js +4 -3
  440. package/dist/src/runtime/orchestration/role-calls/contracts.d.ts +2 -0
  441. package/dist/src/runtime/orchestration/role-calls/contracts.js +1 -0
  442. package/dist/src/runtime/orchestration/role-calls/index.d.ts +1 -0
  443. package/dist/src/runtime/orchestration/role-calls/index.js +1 -0
  444. package/dist/src/runtime/orchestration/role-calls/ledger.d.ts +2 -0
  445. package/dist/src/runtime/orchestration/role-calls/ledger.js +8 -5
  446. package/dist/src/runtime/orchestration/role-calls/operation-supervision-issuance.d.ts +2 -0
  447. package/dist/src/runtime/orchestration/role-calls/operation-supervision-issuance.js +5 -0
  448. package/dist/src/runtime/orchestration/role-calls/role-result-text.d.ts +2 -0
  449. package/dist/src/runtime/orchestration/role-calls/role-result-text.js +4 -0
  450. package/dist/src/runtime/orchestration/role-executors/activation/loop.d.ts +6 -6
  451. package/dist/src/runtime/orchestration/role-executors/activation/loop.js +40 -5
  452. package/dist/src/runtime/orchestration/role-executors/activation/model-output-failure.d.ts +3 -0
  453. package/dist/src/runtime/orchestration/role-executors/activation/model-output-failure.js +98 -0
  454. package/dist/src/runtime/orchestration/role-executors/activation/result-normalization.d.ts +1 -1
  455. package/dist/src/runtime/orchestration/role-executors/activation/result-normalization.js +6 -5
  456. package/dist/src/runtime/orchestration/role-executors/approval-continuation.d.ts +20 -0
  457. package/dist/src/runtime/orchestration/role-executors/approval-continuation.js +34 -0
  458. package/dist/src/runtime/orchestration/role-executors/child-invocation/entered-child.d.ts +19 -0
  459. package/dist/src/runtime/orchestration/role-executors/child-invocation/entered-child.js +55 -0
  460. package/dist/src/runtime/orchestration/role-executors/child-invocation/state-validation.d.ts +5 -5
  461. package/dist/src/runtime/orchestration/role-executors/child-invocation/state-validation.js +2 -2
  462. package/dist/src/runtime/orchestration/role-executors/child-invocation/transaction.d.ts +7 -7
  463. package/dist/src/runtime/orchestration/role-executors/child-invocation/transaction.js +47 -15
  464. package/dist/src/runtime/orchestration/role-executors/contracts.d.ts +37 -20
  465. package/dist/src/runtime/orchestration/role-executors/registry.js +13 -6
  466. package/dist/src/runtime/orchestration/state-head-checkpoint.d.ts +4 -0
  467. package/dist/src/runtime/orchestration/state-head-checkpoint.js +10 -0
  468. package/dist/src/runtime/orchestration/state-head-contracts.d.ts +100 -0
  469. package/dist/src/runtime/orchestration/state-head-contracts.js +1 -0
  470. package/dist/src/runtime/orchestration/state-head.d.ts +2 -99
  471. package/dist/src/runtime/orchestration/state-head.js +4 -3
  472. package/dist/src/runtime/orchestration/worker-capabilities/approval-contracts.d.ts +47 -0
  473. package/dist/src/runtime/orchestration/worker-capabilities/approval-contracts.js +6 -0
  474. package/dist/src/runtime/orchestration/worker-capabilities/binding/adapter-normalization.js +3 -0
  475. package/dist/src/runtime/orchestration/worker-capabilities/binding/bound-capability-session.d.ts +2 -0
  476. package/dist/src/runtime/orchestration/worker-capabilities/binding/bound-capability-session.js +4 -0
  477. package/dist/src/runtime/orchestration/worker-capabilities/binding/create-binding.d.ts +2 -0
  478. package/dist/src/runtime/orchestration/worker-capabilities/binding/create-binding.js +1 -0
  479. package/dist/src/runtime/orchestration/worker-capabilities/contracts.d.ts +19 -2
  480. package/dist/src/runtime/orchestration/worker-capabilities/execution/approval-group.d.ts +30 -0
  481. package/dist/src/runtime/orchestration/worker-capabilities/execution/approval-group.js +171 -0
  482. package/dist/src/runtime/orchestration/worker-capabilities/execution/invocation-preparation.js +12 -0
  483. package/dist/src/runtime/orchestration/worker-capabilities/execution/ledger-transaction.d.ts +3 -0
  484. package/dist/src/runtime/orchestration/worker-capabilities/execution/ledger-transaction.js +37 -52
  485. package/dist/src/runtime/orchestration/worker-capabilities/execution/preparation-rejection.d.ts +66 -0
  486. package/dist/src/runtime/orchestration/worker-capabilities/execution/preparation-rejection.js +37 -0
  487. package/dist/src/runtime/orchestration/worker-capabilities/execution/settle-prepared.d.ts +15 -0
  488. package/dist/src/runtime/orchestration/worker-capabilities/execution/settle-prepared.js +43 -0
  489. package/dist/src/runtime/orchestration/worker-capabilities/execution.d.ts +3 -0
  490. package/dist/src/runtime/orchestration/worker-capabilities/execution.js +4 -1
  491. package/dist/src/runtime/orchestration/worker-capabilities/index.d.ts +2 -0
  492. package/dist/src/runtime/orchestration/worker-capabilities/index.js +2 -0
  493. package/dist/src/runtime/orchestration/worker-capabilities/payload-author.js +2 -4
  494. package/dist/src/runtime/passive-learning/active-batches.d.ts +11 -0
  495. package/dist/src/runtime/passive-learning/active-batches.js +29 -0
  496. package/dist/src/runtime/passive-learning/activity-permissions.d.ts +7 -0
  497. package/dist/src/runtime/passive-learning/activity-permissions.js +88 -0
  498. package/dist/src/runtime/passive-learning/analysis-clock.d.ts +14 -0
  499. package/dist/src/runtime/passive-learning/analysis-clock.js +46 -0
  500. package/dist/src/runtime/passive-learning/analysis-schedule.d.ts +6 -0
  501. package/dist/src/runtime/passive-learning/analysis-schedule.js +69 -0
  502. package/dist/src/runtime/passive-learning/application-catalog.d.ts +13 -0
  503. package/dist/src/runtime/passive-learning/application-catalog.js +29 -0
  504. package/dist/src/runtime/passive-learning/application-controls.d.ts +10 -0
  505. package/dist/src/runtime/passive-learning/application-controls.js +14 -0
  506. package/dist/src/runtime/passive-learning/application-pending.d.ts +15 -0
  507. package/dist/src/runtime/passive-learning/application-pending.js +44 -0
  508. package/dist/src/runtime/passive-learning/application-policy.d.ts +7 -0
  509. package/dist/src/runtime/passive-learning/application-policy.js +26 -0
  510. package/dist/src/runtime/passive-learning/background-dependencies.d.ts +38 -0
  511. package/dist/src/runtime/passive-learning/background-dependencies.js +1 -0
  512. package/dist/src/runtime/passive-learning/background-lifecycle.d.ts +22 -0
  513. package/dist/src/runtime/passive-learning/background-lifecycle.js +75 -0
  514. package/dist/src/runtime/passive-learning/batch-lifecycle.d.ts +7 -0
  515. package/dist/src/runtime/passive-learning/batch-lifecycle.js +48 -0
  516. package/dist/src/runtime/passive-learning/batch-partition.d.ts +10 -0
  517. package/dist/src/runtime/passive-learning/batch-partition.js +46 -0
  518. package/dist/src/runtime/passive-learning/batch-receipt.d.ts +15 -0
  519. package/dist/src/runtime/passive-learning/batch-receipt.js +34 -0
  520. package/dist/src/runtime/passive-learning/collection-source.d.ts +24 -0
  521. package/dist/src/runtime/passive-learning/collection-source.js +96 -0
  522. package/dist/src/runtime/passive-learning/collection-window-clock.d.ts +21 -0
  523. package/dist/src/runtime/passive-learning/collection-window-clock.js +55 -0
  524. package/dist/src/runtime/passive-learning/contracts.d.ts +168 -0
  525. package/dist/src/runtime/passive-learning/contracts.js +1 -0
  526. package/dist/src/runtime/passive-learning/control-policy.d.ts +9 -0
  527. package/dist/src/runtime/passive-learning/control-policy.js +52 -0
  528. package/dist/src/runtime/passive-learning/independent-preferences.d.ts +2 -0
  529. package/dist/src/runtime/passive-learning/independent-preferences.js +39 -0
  530. package/dist/src/runtime/passive-learning/journal.d.ts +37 -0
  531. package/dist/src/runtime/passive-learning/journal.js +185 -0
  532. package/dist/src/runtime/passive-learning/maturation-preferences.d.ts +8 -0
  533. package/dist/src/runtime/passive-learning/maturation-preferences.js +40 -0
  534. package/dist/src/runtime/passive-learning/memory-review-format.d.ts +51 -0
  535. package/dist/src/runtime/passive-learning/memory-review-format.js +21 -0
  536. package/dist/src/runtime/passive-learning/model.d.ts +11 -0
  537. package/dist/src/runtime/passive-learning/model.js +230 -0
  538. package/dist/src/runtime/passive-learning/proactive/agent.d.ts +59 -0
  539. package/dist/src/runtime/passive-learning/proactive/agent.js +363 -0
  540. package/dist/src/runtime/passive-learning/proactive/contracts.d.ts +90 -0
  541. package/dist/src/runtime/passive-learning/proactive/contracts.js +136 -0
  542. package/dist/src/runtime/passive-learning/proactive/model-output.d.ts +3 -0
  543. package/dist/src/runtime/passive-learning/proactive/model-output.js +52 -0
  544. package/dist/src/runtime/passive-learning/proactive/model.d.ts +73 -0
  545. package/dist/src/runtime/passive-learning/proactive/model.js +121 -0
  546. package/dist/src/runtime/passive-learning/proactive/prompt.d.ts +1 -0
  547. package/dist/src/runtime/passive-learning/proactive/prompt.js +8 -0
  548. package/dist/src/runtime/passive-learning/proactive/staged-agent-review.d.ts +16 -0
  549. package/dist/src/runtime/passive-learning/proactive/staged-agent-review.js +54 -0
  550. package/dist/src/runtime/passive-learning/proactive/staged-context.d.ts +29 -0
  551. package/dist/src/runtime/passive-learning/proactive/staged-context.js +66 -0
  552. package/dist/src/runtime/passive-learning/proactive/staged-format.d.ts +5 -0
  553. package/dist/src/runtime/passive-learning/proactive/staged-format.js +22 -0
  554. package/dist/src/runtime/passive-learning/proactive/staged-output.d.ts +16 -0
  555. package/dist/src/runtime/passive-learning/proactive/staged-output.js +85 -0
  556. package/dist/src/runtime/passive-learning/proactive/staged-progress-store.d.ts +18 -0
  557. package/dist/src/runtime/passive-learning/proactive/staged-progress-store.js +73 -0
  558. package/dist/src/runtime/passive-learning/proactive/staged-prompt.d.ts +4 -0
  559. package/dist/src/runtime/passive-learning/proactive/staged-prompt.js +15 -0
  560. package/dist/src/runtime/passive-learning/proactive/staged-review.d.ts +5 -0
  561. package/dist/src/runtime/passive-learning/proactive/staged-review.js +41 -0
  562. package/dist/src/runtime/passive-learning/proactive/store.d.ts +65 -0
  563. package/dist/src/runtime/passive-learning/proactive/store.js +372 -0
  564. package/dist/src/runtime/passive-learning/process-batch.d.ts +16 -0
  565. package/dist/src/runtime/passive-learning/process-batch.js +90 -0
  566. package/dist/src/runtime/passive-learning/processing-budget-policy.d.ts +14 -0
  567. package/dist/src/runtime/passive-learning/processing-budget-policy.js +33 -0
  568. package/dist/src/runtime/passive-learning/processing-cycle.d.ts +42 -0
  569. package/dist/src/runtime/passive-learning/processing-cycle.js +155 -0
  570. package/dist/src/runtime/passive-learning/processing-pass.d.ts +29 -0
  571. package/dist/src/runtime/passive-learning/processing-pass.js +104 -0
  572. package/dist/src/runtime/passive-learning/processing-trigger.d.ts +7 -0
  573. package/dist/src/runtime/passive-learning/processing-trigger.js +31 -0
  574. package/dist/src/runtime/passive-learning/queue.d.ts +29 -0
  575. package/dist/src/runtime/passive-learning/queue.js +182 -0
  576. package/dist/src/runtime/passive-learning/reassessment-receipt.d.ts +20 -0
  577. package/dist/src/runtime/passive-learning/reassessment-receipt.js +18 -0
  578. package/dist/src/runtime/passive-learning/reassessment-state.d.ts +25 -0
  579. package/dist/src/runtime/passive-learning/reassessment-state.js +156 -0
  580. package/dist/src/runtime/passive-learning/resources/admission.d.ts +23 -0
  581. package/dist/src/runtime/passive-learning/resources/admission.js +92 -0
  582. package/dist/src/runtime/passive-learning/resources/budget.d.ts +21 -0
  583. package/dist/src/runtime/passive-learning/resources/budget.js +78 -0
  584. package/dist/src/runtime/passive-learning/resources/contracts.d.ts +29 -0
  585. package/dist/src/runtime/passive-learning/resources/contracts.js +26 -0
  586. package/dist/src/runtime/passive-learning/resources/day-window.d.ts +3 -0
  587. package/dist/src/runtime/passive-learning/resources/day-window.js +39 -0
  588. package/dist/src/runtime/passive-learning/resources/gateway.d.ts +13 -0
  589. package/dist/src/runtime/passive-learning/resources/gateway.js +38 -0
  590. package/dist/src/runtime/passive-learning/resources/store.d.ts +13 -0
  591. package/dist/src/runtime/passive-learning/resources/store.js +96 -0
  592. package/dist/src/runtime/passive-learning/review-batch.d.ts +20 -0
  593. package/dist/src/runtime/passive-learning/review-batch.js +56 -0
  594. package/dist/src/runtime/passive-learning/review-capacity.d.ts +5 -0
  595. package/dist/src/runtime/passive-learning/review-capacity.js +19 -0
  596. package/dist/src/runtime/passive-learning/review-decision-adapter.d.ts +17 -0
  597. package/dist/src/runtime/passive-learning/review-decision-adapter.js +145 -0
  598. package/dist/src/runtime/passive-learning/review-invocation.d.ts +7 -0
  599. package/dist/src/runtime/passive-learning/review-invocation.js +47 -0
  600. package/dist/src/runtime/passive-learning/review-method.d.ts +3 -0
  601. package/dist/src/runtime/passive-learning/review-method.js +11 -0
  602. package/dist/src/runtime/passive-learning/review-output.d.ts +2 -0
  603. package/dist/src/runtime/passive-learning/review-output.js +17 -0
  604. package/dist/src/runtime/passive-learning/review-progress.d.ts +25 -0
  605. package/dist/src/runtime/passive-learning/review-progress.js +59 -0
  606. package/dist/src/runtime/passive-learning/review-references.d.ts +63 -0
  607. package/dist/src/runtime/passive-learning/review-references.js +44 -0
  608. package/dist/src/runtime/passive-learning/review-response-format.d.ts +4 -0
  609. package/dist/src/runtime/passive-learning/review-response-format.js +72 -0
  610. package/dist/src/runtime/passive-learning/scheduled-reassessment.d.ts +52 -0
  611. package/dist/src/runtime/passive-learning/scheduled-reassessment.js +262 -0
  612. package/dist/src/runtime/passive-learning/service-status.d.ts +24 -0
  613. package/dist/src/runtime/passive-learning/service-status.js +61 -0
  614. package/dist/src/runtime/passive-learning/service.d.ts +16 -0
  615. package/dist/src/runtime/passive-learning/service.js +469 -0
  616. package/dist/src/runtime/passive-learning/staged-learning-assessment.d.ts +11 -0
  617. package/dist/src/runtime/passive-learning/staged-learning-assessment.js +30 -0
  618. package/dist/src/runtime/passive-learning/staged-learning-authoring.d.ts +11 -0
  619. package/dist/src/runtime/passive-learning/staged-learning-authoring.js +29 -0
  620. package/dist/src/runtime/passive-learning/staged-learning-changes.d.ts +5 -0
  621. package/dist/src/runtime/passive-learning/staged-learning-changes.js +56 -0
  622. package/dist/src/runtime/passive-learning/staged-learning-review.d.ts +5 -0
  623. package/dist/src/runtime/passive-learning/staged-learning-review.js +55 -0
  624. package/dist/src/runtime/passive-learning/staged-learning-selection.d.ts +18 -0
  625. package/dist/src/runtime/passive-learning/staged-learning-selection.js +57 -0
  626. package/dist/src/runtime/passive-learning/staged-learning-stage.d.ts +75 -0
  627. package/dist/src/runtime/passive-learning/staged-learning-stage.js +60 -0
  628. package/dist/src/runtime/passive-learning/staged-learning-timing.d.ts +3 -0
  629. package/dist/src/runtime/passive-learning/staged-learning-timing.js +20 -0
  630. package/dist/src/runtime/passive-learning/staged-review-call.d.ts +23 -0
  631. package/dist/src/runtime/passive-learning/staged-review-call.js +135 -0
  632. package/dist/src/runtime/passive-learning/status-projection.d.ts +10 -0
  633. package/dist/src/runtime/passive-learning/status-projection.js +148 -0
  634. package/dist/src/runtime/passive-learning/store.d.ts +14 -0
  635. package/dist/src/runtime/passive-learning/store.js +155 -0
  636. package/dist/src/runtime/ports.d.ts +7 -1
  637. package/dist/src/runtime/request/approval-continuation.d.ts +24 -0
  638. package/dist/src/runtime/request/approval-continuation.js +62 -0
  639. package/dist/src/runtime/request/approval-wait/activation-events.d.ts +31 -0
  640. package/dist/src/runtime/request/approval-wait/activation-events.js +153 -0
  641. package/dist/src/runtime/request/approval-wait/approval-gate.d.ts +9 -0
  642. package/dist/src/runtime/request/approval-wait/approval-gate.js +65 -0
  643. package/dist/src/runtime/request/approval-wait/failure.d.ts +8 -0
  644. package/dist/src/runtime/request/approval-wait/failure.js +27 -0
  645. package/dist/src/runtime/request/approval-wait/park.d.ts +15 -0
  646. package/dist/src/runtime/request/approval-wait/park.js +89 -0
  647. package/dist/src/runtime/request/approval-wait/preflight.d.ts +5 -0
  648. package/dist/src/runtime/request/approval-wait/preflight.js +155 -0
  649. package/dist/src/runtime/request/approval-wait/snapshot-data.d.ts +2 -0
  650. package/dist/src/runtime/request/approval-wait/snapshot-data.js +31 -0
  651. package/dist/src/runtime/request/approval-wait/snapshot.d.ts +38 -0
  652. package/dist/src/runtime/request/approval-wait/snapshot.js +21 -0
  653. package/dist/src/runtime/request/bound-runtime-handler.js +10 -4
  654. package/dist/src/runtime/request/cancellation.d.ts +15 -0
  655. package/dist/src/runtime/request/cancellation.js +14 -0
  656. package/dist/src/runtime/request/capability-execution-freshness.d.ts +8 -0
  657. package/dist/src/runtime/request/capability-execution-freshness.js +28 -0
  658. package/dist/src/runtime/request/contracts.d.ts +17 -1
  659. package/dist/src/runtime/request/execution-facets.js +13 -0
  660. package/dist/src/runtime/request/execution-scope-surfaces.js +19 -0
  661. package/dist/src/runtime/request/handler.d.ts +6 -1
  662. package/dist/src/runtime/request/handler.js +201 -189
  663. package/dist/src/runtime/request/interruption.d.ts +5 -0
  664. package/dist/src/runtime/request/interruption.js +11 -0
  665. package/dist/src/runtime/request/plan-event-projection.d.ts +1 -0
  666. package/dist/src/runtime/request/plan-event-projection.js +1 -1
  667. package/dist/src/runtime/request/prepared-execution.d.ts +80 -0
  668. package/dist/src/runtime/request/prepared-execution.js +210 -0
  669. package/dist/src/runtime/request/result.d.ts +1 -0
  670. package/dist/src/runtime/request/role-call-policy.d.ts +4 -0
  671. package/dist/src/runtime/request/role-call-policy.js +16 -0
  672. package/dist/src/runtime/request/root-child-completion.d.ts +17 -0
  673. package/dist/src/runtime/request/root-child-completion.js +23 -0
  674. package/dist/src/runtime/request/root-execution-contracts.d.ts +45 -0
  675. package/dist/src/runtime/request/root-execution-contracts.js +1 -0
  676. package/dist/src/runtime/request/root-execution-kernel.d.ts +6 -4
  677. package/dist/src/runtime/request/root-execution-kernel.js +89 -45
  678. package/dist/src/runtime/request/root-invalid-output-progress.d.ts +4 -0
  679. package/dist/src/runtime/request/root-invalid-output-progress.js +16 -0
  680. package/dist/src/runtime/request/root-invalid-output.d.ts +21 -0
  681. package/dist/src/runtime/request/root-invalid-output.js +130 -0
  682. package/dist/src/runtime/request/root-response-commit.d.ts +7 -0
  683. package/dist/src/runtime/request/root-response-commit.js +15 -0
  684. package/dist/src/runtime/request/runner.d.ts +14 -2
  685. package/dist/src/runtime/request/runner.js +61 -21
  686. package/dist/src/runtime/request/session-admission.d.ts +4 -2
  687. package/dist/src/runtime/request/session-admission.js +13 -2
  688. package/dist/src/runtime/request/session-artifact-path-persistence.d.ts +1 -1
  689. package/dist/src/runtime/request/session-store.d.ts +1 -1
  690. package/dist/src/runtime/request/tool-approval-wait.d.ts +4 -0
  691. package/dist/src/runtime/request/tool-approval-wait.js +14 -0
  692. package/dist/src/runtime/request/worker-capability-composition.js +1 -0
  693. package/dist/src/runtime/runtime-environment.d.ts +5 -3
  694. package/dist/src/runtime/runtime-environment.js +53 -5
  695. package/dist/src/runtime/runtime-host-scheduler-ownership.js +12 -1
  696. package/dist/src/runtime/scheduler/contracts.d.ts +6 -2
  697. package/dist/src/runtime/scheduler/file-store.d.ts +1 -1
  698. package/dist/src/runtime/scheduler/file-store.js +2 -2
  699. package/dist/src/runtime/scheduler/job-management.js +4 -2
  700. package/dist/src/runtime/scheduler/journal-index-state.d.ts +1 -1
  701. package/dist/src/runtime/scheduler/journal-store.d.ts +3 -1
  702. package/dist/src/runtime/scheduler/journal-store.js +16 -3
  703. package/dist/src/runtime/scheduler/run-records.js +1 -0
  704. package/dist/src/runtime/scheduler/schedule-validation.js +2 -0
  705. package/dist/src/runtime/scheduler/scheduler-engine.js +2 -1
  706. package/dist/src/runtime/scheduler/snapshot-validation.js +3 -1
  707. package/dist/src/runtime/scheduler/tool-permission-mode.d.ts +5 -0
  708. package/dist/src/runtime/scheduler/tool-permission-mode.js +14 -0
  709. package/dist/src/runtime/session/cancelled-response.d.ts +12 -0
  710. package/dist/src/runtime/session/cancelled-response.js +39 -0
  711. package/dist/src/runtime/session/request-activation.d.ts +3 -0
  712. package/dist/src/runtime/session/request-activation.js +43 -0
  713. package/dist/src/runtime/session/request-history.js +8 -1
  714. package/dist/src/runtime/session/request-session.d.ts +3 -0
  715. package/dist/src/runtime/session/request-session.js +15 -0
  716. package/dist/src/runtime/session/session-lifecycle-store.js +19 -0
  717. package/dist/src/runtime/session/session-title.js +19 -2
  718. package/dist/src/runtime/steps/auditor-decision/input.js +1 -0
  719. package/dist/src/runtime/steps/auditor-decision/run.js +1 -0
  720. package/dist/src/runtime/steps/degraded-finalization/input.d.ts +1 -0
  721. package/dist/src/runtime/steps/degraded-finalization/input.js +1 -1
  722. package/dist/src/runtime/steps/degraded-finalization/model-authored.d.ts +8 -0
  723. package/dist/src/runtime/steps/degraded-finalization/model-authored.js +81 -0
  724. package/dist/src/runtime/steps/degraded-finalization/render.js +2 -1
  725. package/dist/src/runtime/steps/execution-agent/input.js +18 -14
  726. package/dist/src/runtime/steps/execution-agent/response-input.d.ts +1 -0
  727. package/dist/src/runtime/steps/execution-agent/response-input.js +1 -0
  728. package/dist/src/runtime/steps/execution-agent/response-run.js +15 -3
  729. package/dist/src/runtime/steps/model-step-timeout.d.ts +9 -0
  730. package/dist/src/runtime/steps/model-step-timeout.js +13 -1
  731. package/dist/src/runtime/steps/planner-decision/contracts.d.ts +0 -1
  732. package/dist/src/runtime/steps/planner-decision/contracts.js +1 -2
  733. package/dist/src/runtime/steps/planner-decision/format.js +3 -15
  734. package/dist/src/runtime/steps/planner-decision/parser.js +9 -4
  735. package/dist/src/runtime/steps/planner-decision/prompt.js +1 -2
  736. package/dist/src/runtime/steps/supervisor-decision/input.d.ts +1 -1
  737. package/dist/src/runtime/steps/supervisor-decision/input.js +16 -12
  738. package/dist/src/runtime/steps/supervisor-decision/resume.js +2 -2
  739. package/dist/src/runtime/steps/supervisor-response/input.d.ts +3 -0
  740. package/dist/src/runtime/steps/supervisor-response/input.js +3 -0
  741. package/dist/src/runtime/steps/supervisor-response/memory-authoring.d.ts +2 -0
  742. package/dist/src/runtime/steps/supervisor-response/memory-authoring.js +6 -41
  743. package/dist/src/runtime/steps/supervisor-response/prompt.d.ts +2 -0
  744. package/dist/src/runtime/steps/supervisor-response/prompt.js +9 -2
  745. package/dist/src/runtime/steps/supervisor-response/run.js +22 -7
  746. package/dist/src/runtime/steps/worker-decision/contracts.d.ts +0 -1
  747. package/dist/src/runtime/steps/worker-decision/contracts.js +0 -2
  748. package/dist/src/runtime/steps/worker-decision/format.js +2 -11
  749. package/dist/src/runtime/steps/worker-decision/parser/action-validation.d.ts +1 -1
  750. package/dist/src/runtime/steps/worker-decision/parser/action-validation.js +5 -3
  751. package/dist/src/runtime/steps/worker-decision/prompt.js +9 -16
  752. package/dist/src/runtime/steps/worker-decision/result-author.js +1 -15
  753. package/dist/src/runtime/steps/worker-decision/run.js +7 -0
  754. package/dist/src/runtime/streaming/request-callbacks.d.ts +8 -1
  755. package/dist/src/runtime/streaming/request-callbacks.js +12 -4
  756. package/dist/src/sessions/assistant-initiative.d.ts +26 -0
  757. package/dist/src/sessions/assistant-initiative.js +60 -0
  758. package/dist/src/sessions/context-window.js +2 -0
  759. package/dist/src/sessions/durable-session-commit.d.ts +9 -0
  760. package/dist/src/sessions/durable-session-commit.js +51 -0
  761. package/dist/src/sessions/memory/source.d.ts +2 -0
  762. package/dist/src/sessions/memory/source.js +20 -3
  763. package/dist/src/sessions/record/projection.js +9 -0
  764. package/dist/src/sessions/request-lifecycle/activation-transitions.d.ts +4 -0
  765. package/dist/src/sessions/request-lifecycle/activation-transitions.js +140 -0
  766. package/dist/src/sessions/request-lifecycle/approval-decisions.d.ts +3 -0
  767. package/dist/src/sessions/request-lifecycle/approval-decisions.js +109 -0
  768. package/dist/src/sessions/request-lifecycle/continuation-blobs.d.ts +13 -0
  769. package/dist/src/sessions/request-lifecycle/continuation-blobs.js +114 -0
  770. package/dist/src/sessions/request-lifecycle/continuation-cleanup.d.ts +7 -0
  771. package/dist/src/sessions/request-lifecycle/continuation-cleanup.js +49 -0
  772. package/dist/src/sessions/request-lifecycle/contracts.d.ts +169 -0
  773. package/dist/src/sessions/request-lifecycle/contracts.js +1 -0
  774. package/dist/src/sessions/request-lifecycle/projection.d.ts +4 -0
  775. package/dist/src/sessions/request-lifecycle/projection.js +30 -0
  776. package/dist/src/sessions/request-lifecycle/record-operations.d.ts +27 -0
  777. package/dist/src/sessions/request-lifecycle/record-operations.js +109 -0
  778. package/dist/src/sessions/request-lifecycle/service.d.ts +12 -0
  779. package/dist/src/sessions/request-lifecycle/service.js +95 -0
  780. package/dist/src/sessions/request-lifecycle/terminal-transitions.d.ts +5 -0
  781. package/dist/src/sessions/request-lifecycle/terminal-transitions.js +103 -0
  782. package/dist/src/sessions/request-lifecycle/wait-initial-decisions.d.ts +4 -0
  783. package/dist/src/sessions/request-lifecycle/wait-initial-decisions.js +34 -0
  784. package/dist/src/sessions/session-service.d.ts +4 -0
  785. package/dist/src/sessions/session-service.js +52 -11
  786. package/dist/src/sessions/session-store.d.ts +1 -1
  787. package/dist/src/sessions/session-store.js +9 -1
  788. package/dist/src/sessions/types.d.ts +12 -2
  789. package/dist/src/shared/model-step-registry-data.json +9 -0
  790. package/dist/src/shared/model-step-registry.d.ts +9 -0
  791. package/dist/src/shared/model-step-registry.generated.d.ts +9 -0
  792. package/dist/src/shared/model-step-registry.generated.js +9 -0
  793. package/dist/src/shared/passive-observation.d.ts +46 -0
  794. package/dist/src/shared/passive-observation.js +2 -0
  795. package/dist/src/web-ui/app/ARCHITECTURE.md +40 -3
  796. package/dist/src/web-ui/app/app-bootstrap.js +45 -2
  797. package/dist/src/web-ui/app/app-dom.js +23 -0
  798. package/dist/src/web-ui/app/app-page-bindings.js +46 -0
  799. package/dist/src/web-ui/app/app-realtime-transport.js +42 -0
  800. package/dist/src/web-ui/app/app-state.js +1 -0
  801. package/dist/src/web-ui/app/app.js +90 -76
  802. package/dist/src/web-ui/app/components/composer-actions.d.ts +4 -0
  803. package/dist/src/web-ui/app/components/composer-actions.js +20 -0
  804. package/dist/src/web-ui/app/components/config-workspace/calibration-disclosure.js +39 -0
  805. package/dist/src/web-ui/app/components/config-workspace/config-model.js +3 -5
  806. package/dist/src/web-ui/app/components/config-workspace/dashboard-rendering.js +3 -20
  807. package/dist/src/web-ui/app/components/config-workspace/model-removal.js +105 -0
  808. package/dist/src/web-ui/app/components/config-workspace/model-rendering.js +67 -38
  809. package/dist/src/web-ui/app/components/config-workspace/model-setup-entry.js +6 -3
  810. package/dist/src/web-ui/app/components/config-workspace/raw-config-repair.js +1 -1
  811. package/dist/src/web-ui/app/components/config-workspace/workspace-events.js +19 -42
  812. package/dist/src/web-ui/app/components/config-workspace/workspace-mutations.js +1 -1
  813. package/dist/src/web-ui/app/components/config-workspace/workspace-persistence.js +0 -2
  814. package/dist/src/web-ui/app/components/config-workspace/workspace-view.js +66 -51
  815. package/dist/src/web-ui/app/components/config-workspace.js +23 -7
  816. package/dist/src/web-ui/app/components/conversation-activity.js +33 -29
  817. package/dist/src/web-ui/app/components/conversation-file-focus.js +3 -0
  818. package/dist/src/web-ui/app/components/conversation-reasoning.d.ts +9 -0
  819. package/dist/src/web-ui/app/components/conversation-reasoning.js +46 -0
  820. package/dist/src/web-ui/app/components/conversation-role-cards.d.ts +1 -8
  821. package/dist/src/web-ui/app/components/conversation-role-cards.js +24 -57
  822. package/dist/src/web-ui/app/components/conversation-sources.js +2 -2
  823. package/dist/src/web-ui/app/components/conversation-tool-evidence.js +6 -0
  824. package/dist/src/web-ui/app/components/conversation-tools.js +1 -1
  825. package/dist/src/web-ui/app/components/conversation-view.js +16 -35
  826. package/dist/src/web-ui/app/components/dashboard/activity.js +1 -1
  827. package/dist/src/web-ui/app/components/dashboard/approvals.js +168 -0
  828. package/dist/src/web-ui/app/components/dashboard/recent-conversations.js +16 -22
  829. package/dist/src/web-ui/app/components/dashboard/workspace.js +53 -58
  830. package/dist/src/web-ui/app/components/home-guidance/daily-review-entry.js +24 -0
  831. package/dist/src/web-ui/app/components/home-guidance/daily-review.js +80 -0
  832. package/dist/src/web-ui/app/components/home-guidance/home-guidance.js +160 -0
  833. package/dist/src/web-ui/app/components/home-guidance/suggestion-policy.js +35 -0
  834. package/dist/src/web-ui/app/components/long-term-memory/manager.js +8 -1
  835. package/dist/src/web-ui/app/components/long-term-memory/record-list.js +7 -0
  836. package/dist/src/web-ui/app/components/long-term-memory/view-model.js +3 -0
  837. package/dist/src/web-ui/app/components/long-term-memory/workspace.js +48 -0
  838. package/dist/src/web-ui/app/components/model-setup/rendering.js +1 -1
  839. package/dist/src/web-ui/app/components/model-setup/save-flow.js +11 -6
  840. package/dist/src/web-ui/app/components/model-setup/save-outcome.js +16 -0
  841. package/dist/src/web-ui/app/components/model-setup/wizard.d.ts +1 -0
  842. package/dist/src/web-ui/app/components/model-setup/wizard.js +4 -0
  843. package/dist/src/web-ui/app/components/notifications/dom.js +33 -0
  844. package/dist/src/web-ui/app/components/notifications/focus.js +56 -0
  845. package/dist/src/web-ui/app/components/notifications/home-entry.js +35 -0
  846. package/dist/src/web-ui/app/components/notifications/presentation.js +123 -0
  847. package/dist/src/web-ui/app/components/notifications/workspace.js +115 -0
  848. package/dist/src/web-ui/app/components/onboarding-workspace-access.js +53 -0
  849. package/dist/src/web-ui/app/components/operations-section.js +9 -2
  850. package/dist/src/web-ui/app/components/passive-learning/activity-controls.js +91 -0
  851. package/dist/src/web-ui/app/components/passive-learning/agent-motion.js +37 -0
  852. package/dist/src/web-ui/app/components/passive-learning/agent-state.js +131 -0
  853. package/dist/src/web-ui/app/components/passive-learning/agent-view.js +40 -0
  854. package/dist/src/web-ui/app/components/passive-learning/application-actions.js +22 -0
  855. package/dist/src/web-ui/app/components/passive-learning/applications-view.js +126 -0
  856. package/dist/src/web-ui/app/components/passive-learning/batch-detail.js +143 -0
  857. package/dist/src/web-ui/app/components/passive-learning/computer-update-notice.js +13 -0
  858. package/dist/src/web-ui/app/components/passive-learning/diagnostics-view.js +28 -0
  859. package/dist/src/web-ui/app/components/passive-learning/failure-copy.js +141 -0
  860. package/dist/src/web-ui/app/components/passive-learning/home.js +101 -0
  861. package/dist/src/web-ui/app/components/passive-learning/knowledge-view.js +137 -0
  862. package/dist/src/web-ui/app/components/passive-learning/macos-collection-consent.js +78 -0
  863. package/dist/src/web-ui/app/components/passive-learning/macos-collection-restart-notice.js +52 -0
  864. package/dist/src/web-ui/app/components/passive-learning/memory.js +235 -0
  865. package/dist/src/web-ui/app/components/passive-learning/presentation.js +183 -0
  866. package/dist/src/web-ui/app/components/passive-learning/processing-state.js +13 -0
  867. package/dist/src/web-ui/app/components/passive-learning/proposal-notifications.js +106 -0
  868. package/dist/src/web-ui/app/components/passive-learning/proposal-read-state.js +23 -0
  869. package/dist/src/web-ui/app/components/passive-learning/proposal-view.js +23 -0
  870. package/dist/src/web-ui/app/components/passive-learning/settings-view.js +82 -0
  871. package/dist/src/web-ui/app/components/passive-learning/settings.js +178 -0
  872. package/dist/src/web-ui/app/components/passive-learning/usage-view.js +60 -0
  873. package/dist/src/web-ui/app/components/passive-learning/workspace-view.js +67 -0
  874. package/dist/src/web-ui/app/components/plugins/rendering.js +2 -2
  875. package/dist/src/web-ui/app/components/project-session-groups.js +66 -10
  876. package/dist/src/web-ui/app/components/project-session-preview.js +52 -0
  877. package/dist/src/web-ui/app/components/runtime-config-activation.js +16 -12
  878. package/dist/src/web-ui/app/components/runtime-setup/configuration-recovery.js +3 -3
  879. package/dist/src/web-ui/app/components/runtime-setup/connection-form.js +1 -1
  880. package/dist/src/web-ui/app/components/runtime-setup/optional-steps.js +4 -0
  881. package/dist/src/web-ui/app/components/runtime-setup-guide.d.ts +3 -1
  882. package/dist/src/web-ui/app/components/runtime-setup-guide.js +3 -1
  883. package/dist/src/web-ui/app/components/schedules/details.js +10 -4
  884. package/dist/src/web-ui/app/components/schedules/form.js +9 -1
  885. package/dist/src/web-ui/app/components/schedules/workspace-state.js +3 -1
  886. package/dist/src/web-ui/app/components/schedules/workspace.js +23 -28
  887. package/dist/src/web-ui/app/components/session-sidebar-drag.js +58 -0
  888. package/dist/src/web-ui/app/components/session-sidebar-sections.js +43 -0
  889. package/dist/src/web-ui/app/components/spark-conversation-actions.js +62 -0
  890. package/dist/src/web-ui/app/components/startup-screen.js +30 -0
  891. package/dist/src/web-ui/app/components/system-host/macos-connection-actions.js +92 -0
  892. package/dist/src/web-ui/app/components/system-host/macos-permission-dialog.js +95 -0
  893. package/dist/src/web-ui/app/components/system-host/macos-permissions.js +36 -0
  894. package/dist/src/web-ui/app/components/system-host/macos-setup.js +91 -0
  895. package/dist/src/web-ui/app/components/system-host/manager.js +48 -1
  896. package/dist/src/web-ui/app/components/system-host/rendering.js +78 -22
  897. package/dist/src/web-ui/app/components/system-host/setup-notice.js +2 -2
  898. package/dist/src/web-ui/app/components/tool-approval-card.js +8 -6
  899. package/dist/src/web-ui/app/components/workspace-shell.js +89 -11
  900. package/dist/src/web-ui/app/computer-access-feature.js +67 -0
  901. package/dist/src/web-ui/app/configuration-feature.js +84 -27
  902. package/dist/src/web-ui/app/controllers/app-event-bindings.js +92 -58
  903. package/dist/src/web-ui/app/controllers/chat-request-controller.js +1 -1
  904. package/dist/src/web-ui/app/controllers/composer-queue-controller.d.ts +2 -2
  905. package/dist/src/web-ui/app/controllers/composer-queue-controller.js +12 -5
  906. package/dist/src/web-ui/app/controllers/composer-stop-controller.d.ts +9 -0
  907. package/dist/src/web-ui/app/controllers/composer-stop-controller.js +64 -0
  908. package/dist/src/web-ui/app/controllers/composer-submit-controller.d.ts +4 -0
  909. package/dist/src/web-ui/app/controllers/composer-submit-controller.js +44 -6
  910. package/dist/src/web-ui/app/controllers/conversation-read-state-controller.js +3 -0
  911. package/dist/src/web-ui/app/controllers/conversation-session-controller.d.ts +10 -2
  912. package/dist/src/web-ui/app/controllers/conversation-session-controller.js +62 -19
  913. package/dist/src/web-ui/app/controllers/conversation-view-feature.js +15 -1
  914. package/dist/src/web-ui/app/controllers/daily-memory-review.js +151 -0
  915. package/dist/src/web-ui/app/controllers/dashboard-approvals-controller.js +141 -0
  916. package/dist/src/web-ui/app/controllers/dashboard-controller.js +59 -17
  917. package/dist/src/web-ui/app/controllers/long-term-memory/controller.d.ts +3 -0
  918. package/dist/src/web-ui/app/controllers/long-term-memory/controller.js +11 -1
  919. package/dist/src/web-ui/app/controllers/long-term-memory/state.js +1 -0
  920. package/dist/src/web-ui/app/controllers/notification-presence.js +68 -0
  921. package/dist/src/web-ui/app/controllers/notifications-controller.js +153 -0
  922. package/dist/src/web-ui/app/controllers/operations-controller.d.ts +4 -2
  923. package/dist/src/web-ui/app/controllers/operations-controller.js +27 -4
  924. package/dist/src/web-ui/app/controllers/passive-learning-controller.js +458 -0
  925. package/dist/src/web-ui/app/controllers/realtime-event-controller.d.ts +1 -1
  926. package/dist/src/web-ui/app/controllers/realtime-event-controller.js +53 -6
  927. package/dist/src/web-ui/app/controllers/request-lifecycle-controller.d.ts +12 -0
  928. package/dist/src/web-ui/app/controllers/request-lifecycle-controller.js +59 -0
  929. package/dist/src/web-ui/app/controllers/runtime-selection-controller.js +0 -2
  930. package/dist/src/web-ui/app/controllers/schedules-controller.js +108 -32
  931. package/dist/src/web-ui/app/controllers/session-controller.js +16 -42
  932. package/dist/src/web-ui/app/controllers/session-sidebar-controller.js +159 -0
  933. package/dist/src/web-ui/app/controllers/tool-approval-controller.d.ts +3 -0
  934. package/dist/src/web-ui/app/controllers/tool-approval-controller.js +65 -4
  935. package/dist/src/web-ui/app/controllers/workspace-route-controller.js +336 -0
  936. package/dist/src/web-ui/app/dashboard-feature.js +20 -5
  937. package/dist/src/web-ui/app/favicon.svg +12 -0
  938. package/dist/src/web-ui/app/index.html +224 -43
  939. package/dist/src/web-ui/app/lib/approval-decision-command.js +14 -0
  940. package/dist/src/web-ui/app/lib/configuration-pages.js +31 -0
  941. package/dist/src/web-ui/app/lib/conversation-role-model.js +4 -1
  942. package/dist/src/web-ui/app/lib/dashboard-presentation.js +1 -0
  943. package/dist/src/web-ui/app/lib/event-presentation.d.ts +1 -0
  944. package/dist/src/web-ui/app/lib/event-presentation.js +25 -4
  945. package/dist/src/web-ui/app/lib/event-refresh.js +85 -0
  946. package/dist/src/web-ui/app/lib/live-region.js +96 -0
  947. package/dist/src/web-ui/app/lib/request-lifecycle-view.d.ts +23 -0
  948. package/dist/src/web-ui/app/lib/request-lifecycle-view.js +83 -0
  949. package/dist/src/web-ui/app/lib/request-stop-state.js +53 -0
  950. package/dist/src/web-ui/app/lib/schedule-presentation.js +10 -0
  951. package/dist/src/web-ui/app/lib/session-archive-visibility.js +4 -0
  952. package/dist/src/web-ui/app/lib/session-sidebar-order.js +35 -0
  953. package/dist/src/web-ui/app/lib/spark-proposal-message.js +6 -0
  954. package/dist/src/web-ui/app/lib/tool-activity-event.js +2 -1
  955. package/dist/src/web-ui/app/lib/tool-activity-model.js +30 -7
  956. package/dist/src/web-ui/app/lib/tool-approval-activity.d.ts +4 -0
  957. package/dist/src/web-ui/app/lib/tool-approval-activity.js +33 -0
  958. package/dist/src/web-ui/app/lib/tool-computer-activity-fields.js +74 -0
  959. package/dist/src/web-ui/app/lib/workspace-change.js +34 -0
  960. package/dist/src/web-ui/app/lib/workspace-route.d.ts +21 -0
  961. package/dist/src/web-ui/app/lib/workspace-route.js +60 -0
  962. package/dist/src/web-ui/app/notifications-feature.js +95 -0
  963. package/dist/src/web-ui/app/passive-learning-feature.js +98 -0
  964. package/dist/src/web-ui/app/projects-feature.js +47 -3
  965. package/dist/src/web-ui/app/runtime-onboarding-feature.js +5 -1
  966. package/dist/src/web-ui/app/schedules-feature.js +60 -7
  967. package/dist/src/web-ui/app/services/client-preferences.d.ts +8 -0
  968. package/dist/src/web-ui/app/services/client-preferences.js +5 -0
  969. package/dist/src/web-ui/app/services/home-guidance-preferences.js +47 -0
  970. package/dist/src/web-ui/app/services/runtime-web-client/configuration.js +6 -0
  971. package/dist/src/web-ui/app/services/runtime-web-client/learning.js +72 -0
  972. package/dist/src/web-ui/app/services/runtime-web-client/memory.js +5 -2
  973. package/dist/src/web-ui/app/services/runtime-web-client/notifications.d.ts +30 -0
  974. package/dist/src/web-ui/app/services/runtime-web-client/notifications.js +27 -0
  975. package/dist/src/web-ui/app/services/runtime-web-client/schedules.js +9 -0
  976. package/dist/src/web-ui/app/services/runtime-web-client/system-host.js +4 -2
  977. package/dist/src/web-ui/app/services/runtime-web-client/tool-approvals.d.ts +20 -0
  978. package/dist/src/web-ui/app/services/runtime-web-client/tool-approvals.js +72 -0
  979. package/dist/src/web-ui/app/services/runtime-web-client.d.ts +68 -5
  980. package/dist/src/web-ui/app/services/runtime-web-client.js +50 -12
  981. package/dist/src/web-ui/app/services/session-sidebar-preferences.js +42 -0
  982. package/dist/src/web-ui/app/services/spark-conversation-preferences.js +27 -0
  983. package/dist/src/web-ui/app/styles/00-tokens-base.css +59 -46
  984. package/dist/src/web-ui/app/styles/10-shell-sessions.css +46 -338
  985. package/dist/src/web-ui/app/styles/11-workspace-header-width.css +99 -0
  986. package/dist/src/web-ui/app/styles/11-workspace-rail.css +360 -0
  987. package/dist/src/web-ui/app/styles/12-conversation-sidebar.css +136 -22
  988. package/dist/src/web-ui/app/styles/13-projects.css +152 -34
  989. package/dist/src/web-ui/app/styles/14-startup-screen.css +37 -0
  990. package/dist/src/web-ui/app/styles/18-dashboard.css +126 -97
  991. package/dist/src/web-ui/app/styles/19-dashboard-approvals.css +108 -0
  992. package/dist/src/web-ui/app/styles/19-home-guidance.css +110 -0
  993. package/dist/src/web-ui/app/styles/19-runtime-setup.css +0 -9
  994. package/dist/src/web-ui/app/styles/20-chat-composer.css +86 -222
  995. package/dist/src/web-ui/app/styles/21-composer-controls.css +10 -10
  996. package/dist/src/web-ui/app/styles/22-composer-context-window.css +7 -7
  997. package/dist/src/web-ui/app/styles/23-composer-plan.css +9 -9
  998. package/dist/src/web-ui/app/styles/24-composer-stop.css +44 -0
  999. package/dist/src/web-ui/app/styles/24-conversation-role-cards.css +214 -85
  1000. package/dist/src/web-ui/app/styles/25-conversation-sources.css +5 -5
  1001. package/dist/src/web-ui/app/styles/26-message-content.css +84 -5
  1002. package/dist/src/web-ui/app/styles/27-conversation-tools.css +4 -4
  1003. package/dist/src/web-ui/app/styles/28-conversation-status.css +2 -2
  1004. package/dist/src/web-ui/app/styles/28-tool-approval-card.css +161 -0
  1005. package/dist/src/web-ui/app/styles/29-conversation-file-preview.css +2 -2
  1006. package/dist/src/web-ui/app/styles/29-spark-conversation.css +19 -0
  1007. package/dist/src/web-ui/app/styles/30-inspector-config.css +60 -84
  1008. package/dist/src/web-ui/app/styles/35-memory-onboarding.css +10 -10
  1009. package/dist/src/web-ui/app/styles/36-memory-management.css +19 -18
  1010. package/dist/src/web-ui/app/styles/37-config-operations.css +70 -56
  1011. package/dist/src/web-ui/app/styles/37-runtime-activation.css +16 -2
  1012. package/dist/src/web-ui/app/styles/38-schedule-workspace.css +114 -76
  1013. package/dist/src/web-ui/app/styles/38-schedules.css +61 -52
  1014. package/dist/src/web-ui/app/styles/39-memory-workspace.css +80 -0
  1015. package/dist/src/web-ui/app/styles/39-passive-learning.css +226 -0
  1016. package/dist/src/web-ui/app/styles/40-config-workspace.css +65 -96
  1017. package/dist/src/web-ui/app/styles/41-co-worker-agent.css +113 -0
  1018. package/dist/src/web-ui/app/styles/41-plugin-management.css +36 -10
  1019. package/dist/src/web-ui/app/styles/42-co-worker-settings.css +55 -0
  1020. package/dist/src/web-ui/app/styles/42-runtime-setup-plugins.css +6 -6
  1021. package/dist/src/web-ui/app/styles/43-co-worker-applications.css +19 -0
  1022. package/dist/src/web-ui/app/styles/43-model-setup.css +4 -4
  1023. package/dist/src/web-ui/app/styles/44-model-provider-cards.css +36 -17
  1024. package/dist/src/web-ui/app/styles/46-system-host.css +109 -4
  1025. package/dist/src/web-ui/app/styles/47-config-controls.css +178 -0
  1026. package/dist/src/web-ui/app/styles/48-notifications.css +97 -0
  1027. package/dist/src/web-ui/app/styles/49-macos-permission.css +225 -0
  1028. package/dist/src/web-ui/app/styles/90-responsive.css +19 -16
  1029. package/dist/src/web-ui/app/styles/91-schedules-responsive.css +15 -4
  1030. package/dist/src/web-ui/app/styles/92-dashboard-responsive.css +22 -26
  1031. package/dist/src/web-ui/app/styles/93-compact-viewport.css +21 -0
  1032. package/dist/src/web-ui/app/styles/foundation.css +3 -92
  1033. package/dist/src/web-ui/app/styles.css +17 -0
  1034. package/dist/src/web-ui/app/ui-behavior.d.ts +1 -1
  1035. package/dist/src/web-ui/app/ui-behavior.js +5 -0
  1036. package/dist/src/web-ui/config-dashboard-backend.d.ts +6 -0
  1037. package/dist/src/web-ui/config-dashboard-backend.js +69 -39
  1038. package/dist/src/web-ui/forwarded-loopback-policy.js +1 -1
  1039. package/dist/src/web-ui/local-runtime/api-router.d.ts +4 -1
  1040. package/dist/src/web-ui/local-runtime/api-router.js +40 -4
  1041. package/dist/src/web-ui/local-runtime/approval-request-attachment.d.ts +15 -0
  1042. package/dist/src/web-ui/local-runtime/approval-request-attachment.js +58 -0
  1043. package/dist/src/web-ui/local-runtime/environment-registry.d.ts +2 -0
  1044. package/dist/src/web-ui/local-runtime/environment-registry.js +1 -0
  1045. package/dist/src/web-ui/local-runtime/learning-notifications.d.ts +2 -0
  1046. package/dist/src/web-ui/local-runtime/learning-notifications.js +20 -0
  1047. package/dist/src/web-ui/local-runtime/learning-routes.d.ts +19 -0
  1048. package/dist/src/web-ui/local-runtime/learning-routes.js +184 -0
  1049. package/dist/src/web-ui/local-runtime/managed-tool-approvals.d.ts +15 -0
  1050. package/dist/src/web-ui/local-runtime/managed-tool-approvals.js +121 -0
  1051. package/dist/src/web-ui/local-runtime/memory-management-input.js +4 -0
  1052. package/dist/src/web-ui/local-runtime/memory-management-response.d.ts +3 -1
  1053. package/dist/src/web-ui/local-runtime/memory-management-response.js +17 -3
  1054. package/dist/src/web-ui/local-runtime/model-removal.d.ts +13 -0
  1055. package/dist/src/web-ui/local-runtime/model-removal.js +74 -0
  1056. package/dist/src/web-ui/local-runtime/model-setup-catalog.js +3 -1
  1057. package/dist/src/web-ui/local-runtime/model-setup-input.js +10 -1
  1058. package/dist/src/web-ui/local-runtime/model-setup-profile-file.d.ts +17 -0
  1059. package/dist/src/web-ui/local-runtime/model-setup-profile-file.js +121 -0
  1060. package/dist/src/web-ui/local-runtime/model-setup-retry.d.ts +1 -1
  1061. package/dist/src/web-ui/local-runtime/model-setup-retry.js +8 -6
  1062. package/dist/src/web-ui/local-runtime/model-setup-routes.js +4 -2
  1063. package/dist/src/web-ui/local-runtime/model-setup-service.d.ts +5 -0
  1064. package/dist/src/web-ui/local-runtime/model-setup-service.js +70 -25
  1065. package/dist/src/web-ui/local-runtime/model-setup-validation.d.ts +2 -1
  1066. package/dist/src/web-ui/local-runtime/model-setup-validation.js +2 -1
  1067. package/dist/src/web-ui/local-runtime/pending-tool-approvals.d.ts +29 -0
  1068. package/dist/src/web-ui/local-runtime/pending-tool-approvals.js +104 -0
  1069. package/dist/src/web-ui/local-runtime/realtime-controller.d.ts +1 -0
  1070. package/dist/src/web-ui/local-runtime/realtime-controller.js +21 -2
  1071. package/dist/src/web-ui/local-runtime/realtime-hub.d.ts +8 -0
  1072. package/dist/src/web-ui/local-runtime/realtime-hub.js +44 -4
  1073. package/dist/src/web-ui/local-runtime/request-cancellation-route.d.ts +8 -0
  1074. package/dist/src/web-ui/local-runtime/request-cancellation-route.js +34 -0
  1075. package/dist/src/web-ui/local-runtime/request-execution.d.ts +4 -2
  1076. package/dist/src/web-ui/local-runtime/request-execution.js +33 -42
  1077. package/dist/src/web-ui/local-runtime/runtime-availability.js +1 -1
  1078. package/dist/src/web-ui/local-runtime/runtime-setup-service.js +1 -1
  1079. package/dist/src/web-ui/local-runtime/session-routes.d.ts +3 -1
  1080. package/dist/src/web-ui/local-runtime/session-routes.js +20 -6
  1081. package/dist/src/web-ui/local-runtime/tool-approval-routes.d.ts +21 -0
  1082. package/dist/src/web-ui/local-runtime/tool-approval-routes.js +70 -0
  1083. package/dist/src/web-ui/local-runtime/workspace-notifications.d.ts +4 -0
  1084. package/dist/src/web-ui/local-runtime/workspace-notifications.js +15 -0
  1085. package/dist/src/web-ui/local-runtime-backend.d.ts +4 -0
  1086. package/dist/src/web-ui/local-runtime-backend.js +39 -4
  1087. package/dist/src/web-ui/notifications/contracts.d.ts +51 -0
  1088. package/dist/src/web-ui/notifications/contracts.js +8 -0
  1089. package/dist/src/web-ui/notifications/delivery-queue.d.ts +6 -0
  1090. package/dist/src/web-ui/notifications/delivery-queue.js +12 -0
  1091. package/dist/src/web-ui/notifications/desktop-delivery.d.ts +14 -0
  1092. package/dist/src/web-ui/notifications/desktop-delivery.js +109 -0
  1093. package/dist/src/web-ui/notifications/event-projection.d.ts +3 -0
  1094. package/dist/src/web-ui/notifications/event-projection.js +126 -0
  1095. package/dist/src/web-ui/notifications/presence.d.ts +9 -0
  1096. package/dist/src/web-ui/notifications/presence.js +46 -0
  1097. package/dist/src/web-ui/notifications/query.d.ts +14 -0
  1098. package/dist/src/web-ui/notifications/query.js +91 -0
  1099. package/dist/src/web-ui/notifications/request-input.d.ts +11 -0
  1100. package/dist/src/web-ui/notifications/request-input.js +47 -0
  1101. package/dist/src/web-ui/notifications/routes.d.ts +15 -0
  1102. package/dist/src/web-ui/notifications/routes.js +125 -0
  1103. package/dist/src/web-ui/notifications/service.d.ts +42 -0
  1104. package/dist/src/web-ui/notifications/service.js +131 -0
  1105. package/dist/src/web-ui/notifications/storage-schema.d.ts +15 -0
  1106. package/dist/src/web-ui/notifications/storage-schema.js +170 -0
  1107. package/dist/src/web-ui/notifications/store.d.ts +26 -0
  1108. package/dist/src/web-ui/notifications/store.js +185 -0
  1109. package/dist/src/web-ui/server.js +1 -1
  1110. package/dist/src/web-ui/session-read-state/projection.js +3 -0
  1111. package/dist/src/web-ui/system-host-service.d.ts +1 -1
  1112. package/dist/src/web-ui/system-host-service.js +19 -10
  1113. package/dist/src/web-ui/system-host-setup/companion-linux.d.ts +3 -0
  1114. package/dist/src/web-ui/system-host-setup/companion-linux.js +50 -0
  1115. package/dist/src/web-ui/system-host-setup/companion-macos.js +11 -2
  1116. package/dist/src/web-ui/system-host-setup/companion-windows.js +5 -2
  1117. package/dist/src/web-ui/system-host-setup/installer-contract.d.ts +2 -1
  1118. package/dist/src/web-ui/system-host-setup/installer-contract.js +18 -5
  1119. package/dist/src/web-ui/system-host-setup/installers.js +15 -2
  1120. package/dist/src/web-ui/system-host-setup/local-connection.d.ts +21 -0
  1121. package/dist/src/web-ui/system-host-setup/local-connection.js +77 -0
  1122. package/dist/src/web-ui/system-host-setup/local-setup-availability.d.ts +7 -0
  1123. package/dist/src/web-ui/system-host-setup/local-setup-availability.js +44 -0
  1124. package/dist/src/web-ui/system-host-setup/readiness.d.ts +8 -4
  1125. package/dist/src/web-ui/system-host-setup/readiness.js +72 -43
  1126. package/dist/src/web-ui/system-host-setup/routes.d.ts +4 -1
  1127. package/dist/src/web-ui/system-host-setup/routes.js +48 -15
  1128. package/dist/src/web-ui/system-host-startup-diagnostic.d.ts +2 -0
  1129. package/dist/src/web-ui/system-host-startup-diagnostic.js +53 -0
  1130. package/docs/architecture.md +15 -0
  1131. package/docs/installation.md +96 -19
  1132. package/docs/known-limitations.md +17 -3
  1133. package/docs/long-term-memory.md +210 -2
  1134. package/docs/plugins.md +11 -1
  1135. package/docs/projects-and-full-plus.md +21 -22
  1136. package/package.json +6 -2
  1137. package/plugins/capability-brief/src/index.cjs +5 -0
  1138. package/plugins/code-outline/src/index.cjs +5 -0
  1139. package/plugins/document-reader/plugin.json +2 -2
  1140. package/plugins/document-reader/skills/document_reader_skill/SKILL.md +7 -0
  1141. package/plugins/document-reader/source/handler.ts +5 -3
  1142. package/plugins/document-reader/src/index.cjs +10 -3
  1143. package/plugins/exec/source/handlers.ts +29 -279
  1144. package/plugins/exec/source/index.ts +12 -0
  1145. package/plugins/exec/source/process-manager.ts +33 -44
  1146. package/plugins/exec/source/process-output-buffer.ts +44 -0
  1147. package/plugins/exec/source/request-resources.ts +203 -0
  1148. package/plugins/exec/source/result-presentation.ts +275 -0
  1149. package/plugins/exec/src/index.cjs +410 -236
  1150. package/plugins/filesystem/src/index.cjs +5 -0
  1151. package/plugins/json-inspector/src/index.cjs +5 -0
  1152. package/plugins/local-search/src/index.cjs +5 -0
  1153. package/plugins/memory/src/index.cjs +5 -0
  1154. package/plugins/project-orientation/src/index.cjs +5 -0
  1155. package/plugins/system/README.md +113 -0
  1156. package/plugins/system/plugin.json +560 -2
  1157. package/plugins/system/skills/system_actions/SKILL.md +12 -0
  1158. package/plugins/system/source/computer/desktop-bindings.ts +270 -0
  1159. package/plugins/system/source/computer/handlers.ts +160 -0
  1160. package/plugins/system/source/computer/observation-output.ts +145 -0
  1161. package/plugins/system/source/computer/observation-result.ts +122 -0
  1162. package/plugins/system/source/computer/public-action.ts +53 -0
  1163. package/plugins/system/source/computer/request-computers.ts +154 -0
  1164. package/plugins/system/source/computer/request-modules.ts +90 -0
  1165. package/plugins/system/source/host-dispatch.ts +5 -18
  1166. package/plugins/system/source/index.ts +5 -3
  1167. package/plugins/system/source/request-system-modules.ts +48 -12
  1168. package/plugins/system/source/request-target-snapshot.ts +13 -5
  1169. package/plugins/system/src/index.cjs +5578 -1173
  1170. package/plugins/system-probe/src/index.cjs +5 -0
  1171. package/plugins/web/src/index.cjs +5 -0
  1172. package/src/runtime/README.md +14 -1
  1173. package/src/runtime/local-host/README.md +66 -4
  1174. package/src/runtime/scheduler/README.md +8 -2
  1175. package/dist/plugins/system/source/companion/native-supervisor.js +0 -93
  1176. package/dist/src/runtime/long-term-memory/candidate-persistence.d.ts +0 -16
  1177. package/dist/src/runtime/long-term-memory/candidate-persistence.js +0 -109
  1178. package/plugins/system/source/application-catalog.ts +0 -237
  1179. package/plugins/system/source/application-launch.ts +0 -113
  1180. package/plugins/system/source/application-observation.ts +0 -78
  1181. package/plugins/system/source/commands.ts +0 -106
  1182. package/plugins/system/source/companion/autostart.ts +0 -185
  1183. package/plugins/system/source/companion/broker-client.ts +0 -183
  1184. package/plugins/system/source/companion/broker-location.ts +0 -89
  1185. package/plugins/system/source/companion/broker-server.ts +0 -169
  1186. package/plugins/system/source/companion/connection.ts +0 -211
  1187. package/plugins/system/source/companion/liveness.ts +0 -23
  1188. package/plugins/system/source/companion/native-address.ts +0 -55
  1189. package/plugins/system/source/companion/native-identity.ts +0 -26
  1190. package/plugins/system/source/companion/native-messages.ts +0 -100
  1191. package/plugins/system/source/companion/native-session.ts +0 -268
  1192. package/plugins/system/source/companion/native-state.ts +0 -135
  1193. package/plugins/system/source/companion/native-supervisor.ts +0 -98
  1194. package/plugins/system/source/companion/pairing-store.ts +0 -110
  1195. package/plugins/system/source/companion/private-store.ts +0 -58
  1196. package/plugins/system/source/companion/process-owner-identity.ts +0 -190
  1197. package/plugins/system/source/companion/protocol.ts +0 -108
  1198. package/plugins/system/source/contracts.ts +0 -44
  1199. package/plugins/system/source/elevation.ts +0 -88
  1200. package/plugins/system/source/handlers.ts +0 -120
  1201. package/plugins/system/source/host-evidence.ts +0 -72
  1202. package/plugins/system/source/host-observation.ts +0 -66
  1203. package/plugins/system/source/process-result.ts +0 -111
  1204. package/plugins/system/source/process-runner.ts +0 -104
  1205. package/plugins/system/source/target-observation.ts +0 -43
  1206. package/plugins/system/source/targets.ts +0 -147
  1207. /package/dist/{plugins/system/source → src/computer-access}/application-catalog.d.ts +0 -0
  1208. /package/dist/{plugins/system/source → src/computer-access}/application-catalog.js +0 -0
  1209. /package/dist/{plugins/system/source → src/computer-access}/application-launch.d.ts +0 -0
  1210. /package/dist/{plugins/system/source → src/computer-access}/application-observation.d.ts +0 -0
  1211. /package/dist/{plugins/system/source → src/computer-access}/application-observation.js +0 -0
  1212. /package/dist/{plugins/system/source → src/computer-access}/commands.d.ts +0 -0
  1213. /package/dist/{plugins/system/source → src/computer-access}/companion/broker-location.d.ts +0 -0
  1214. /package/dist/{plugins/system/source → src/computer-access}/companion/broker-server.d.ts +0 -0
  1215. /package/dist/{plugins/system/source → src/computer-access}/companion/liveness.d.ts +0 -0
  1216. /package/dist/{plugins/system/source → src/computer-access}/companion/liveness.js +0 -0
  1217. /package/dist/{plugins/system/source → src/computer-access}/companion/native-identity.d.ts +0 -0
  1218. /package/dist/{plugins/system/source → src/computer-access}/companion/native-identity.js +0 -0
  1219. /package/dist/{plugins/system/source → src/computer-access}/companion/native-messages.d.ts +0 -0
  1220. /package/dist/{plugins/system/source → src/computer-access}/companion/private-store.d.ts +0 -0
  1221. /package/dist/{plugins/system/source → src/computer-access}/companion/private-store.js +0 -0
  1222. /package/dist/{plugins/system/source → src/computer-access}/contracts.d.ts +0 -0
  1223. /package/dist/{plugins/system/source → src/computer-access}/contracts.js +0 -0
  1224. /package/dist/{plugins/system/source → src/computer-access}/elevation.d.ts +0 -0
  1225. /package/dist/{plugins/system/source → src/computer-access}/elevation.js +0 -0
  1226. /package/dist/{plugins/system/source → src/computer-access}/host-observation.d.ts +0 -0
  1227. /package/dist/{plugins/system/source → src/computer-access}/host-observation.js +0 -0
  1228. /package/dist/{plugins/system/source → src/computer-access}/process-runner.d.ts +0 -0
  1229. /package/dist/{plugins/system/source → src/computer-access}/process-runner.js +0 -0
  1230. /package/dist/{plugins/system/source → src/computer-access}/target-observation.d.ts +0 -0
  1231. /package/dist/{plugins/system/source → src/computer-access}/target-observation.js +0 -0
  1232. /package/dist/{plugins/system/source → src/computer-access}/targets.d.ts +0 -0
  1233. /package/dist/{plugins/system/source → src/computer-access}/targets.js +0 -0
@@ -0,0 +1,120 @@
1
+ import WebSocket from "ws";
2
+ import { OBSERVATION_LEASE_MS, OBSERVATION_WIRE_LIMIT, isPassiveCollectorEvent, } from "./observation-protocol.js";
3
+ /** One device, one environment owner. Lifetime is bounded by both transports and a lease. */
4
+ export class HostObservationConnection {
5
+ client;
6
+ deviceId;
7
+ capable = false;
8
+ lease;
9
+ attach(client, deviceId, capable) {
10
+ this.client = client;
11
+ this.deviceId = deviceId;
12
+ this.capable = capable;
13
+ }
14
+ subscribe(input) {
15
+ if (this.client?.readyState !== WebSocket.OPEN)
16
+ throw new Error("host_disconnected");
17
+ if (!this.capable)
18
+ throw new Error("host_observations_unsupported");
19
+ if (this.lease)
20
+ throw new Error("host_observations_already_owned");
21
+ const lease = {
22
+ ownerId: input.ownerId,
23
+ leaseId: input.leaseId,
24
+ emit: input.onEvent,
25
+ deadline: setTimeout(() => this.expire(lease), OBSERVATION_LEASE_MS),
26
+ sequence: 0,
27
+ };
28
+ this.lease = lease;
29
+ this.send({
30
+ type: "observe_start",
31
+ ownerId: input.ownerId,
32
+ leaseId: input.leaseId,
33
+ excludedApplications: input.excludedApplications,
34
+ });
35
+ return {
36
+ renew: () => {
37
+ if (this.lease !== lease)
38
+ throw new Error("host_observation_lease_expired");
39
+ clearTimeout(lease.deadline);
40
+ lease.deadline = setTimeout(() => this.expire(lease), OBSERVATION_LEASE_MS);
41
+ this.send({
42
+ type: "observe_renew",
43
+ ownerId: lease.ownerId,
44
+ leaseId: lease.leaseId,
45
+ });
46
+ },
47
+ close: () => this.release(lease),
48
+ };
49
+ }
50
+ receive(client, message) {
51
+ if (client !== this.client)
52
+ throw new Error("host_observation_source_mismatch");
53
+ const lease = this.lease;
54
+ if (!lease)
55
+ return;
56
+ if (message.leaseId !== lease.leaseId || message.ownerId !== lease.ownerId)
57
+ return;
58
+ if (!isPassiveCollectorEvent(message.event))
59
+ throw new Error("invalid_host_observation");
60
+ if (Buffer.byteLength(JSON.stringify(message)) > OBSERVATION_WIRE_LIMIT)
61
+ throw new Error("host_observation_too_large");
62
+ if (message.event.type === "observation") {
63
+ if (message.event.observation.sequence <= lease.sequence)
64
+ return;
65
+ lease.sequence = message.event.observation.sequence;
66
+ }
67
+ lease.emit({
68
+ ...message.event,
69
+ deviceId: this.deviceId,
70
+ ownerId: lease.ownerId,
71
+ leaseId: lease.leaseId,
72
+ });
73
+ }
74
+ disconnect() {
75
+ const lease = this.lease;
76
+ if (lease) {
77
+ lease.emit({
78
+ type: "status",
79
+ state: "disconnected",
80
+ reason: "host_disconnected",
81
+ deviceId: this.deviceId,
82
+ ownerId: lease.ownerId,
83
+ leaseId: lease.leaseId,
84
+ });
85
+ this.release(lease);
86
+ }
87
+ this.client = undefined;
88
+ this.deviceId = undefined;
89
+ this.capable = false;
90
+ }
91
+ send(control) {
92
+ if (this.client?.readyState !== WebSocket.OPEN)
93
+ return;
94
+ this.client.send(JSON.stringify(control));
95
+ }
96
+ expire(lease) {
97
+ if (this.lease !== lease)
98
+ return;
99
+ lease.emit({
100
+ type: "status",
101
+ state: "stopped",
102
+ reason: "lease_expired",
103
+ deviceId: this.deviceId,
104
+ ownerId: lease.ownerId,
105
+ leaseId: lease.leaseId,
106
+ });
107
+ this.release(lease);
108
+ }
109
+ release(lease) {
110
+ if (this.lease !== lease)
111
+ return;
112
+ this.lease = undefined;
113
+ clearTimeout(lease.deadline);
114
+ this.send({
115
+ type: "observe_stop",
116
+ ownerId: lease.ownerId,
117
+ leaseId: lease.leaseId,
118
+ });
119
+ }
120
+ }
@@ -0,0 +1,12 @@
1
+ import type { PassiveCollectorEvent } from "../../shared/passive-observation.js";
2
+ /** Bounded source-aware deduplication; returning to a source remains an activity observation. */
3
+ export declare class ObservationFilter {
4
+ private readonly excludedApplications;
5
+ private readonly sourceIdentityKey;
6
+ private sequence;
7
+ private lastStatus?;
8
+ private lastSource?;
9
+ private readonly fingerprints;
10
+ constructor(excludedApplications?: readonly string[]);
11
+ accept(value: unknown): PassiveCollectorEvent | undefined;
12
+ }
@@ -0,0 +1,180 @@
1
+ import { createHash, createHmac, randomBytes, randomUUID } from "node:crypto";
2
+ import { isHostRecord } from "./protocol.js";
3
+ import { redactObservationSource, redactObservationText, } from "./observation-redaction.js";
4
+ import { isPassiveCollectorEvent, isObservationOwner, OBSERVATION_CONTENT_LIMIT, OBSERVATION_WIRE_LIMIT, } from "./observation-protocol.js";
5
+ // Include the previous title so tabs opened before an update are also excluded.
6
+ const OWN_WEB_UI_TITLES = ["ABot Runtime — Workspace", "ABot Runtime"];
7
+ const BROWSER_WINDOW_NAMES = [
8
+ "Mozilla Firefox",
9
+ "Mozilla Firefox (Private Browsing)",
10
+ "Google Chrome",
11
+ "Chromium",
12
+ "Microsoft Edge",
13
+ "Brave",
14
+ "Safari",
15
+ ];
16
+ const BROWSER_WINDOW_SUFFIXES = BROWSER_WINDOW_NAMES.flatMap((browser) => [
17
+ ` — ${browser}`,
18
+ ` - ${browser}`,
19
+ ]);
20
+ function isOwnWebUiWindowTitle(title) {
21
+ if (typeof title !== "string")
22
+ return false;
23
+ if (OWN_WEB_UI_TITLES.includes(title))
24
+ return true;
25
+ const suffix = BROWSER_WINDOW_SUFFIXES.find((candidate) => title.endsWith(candidate));
26
+ if (!suffix)
27
+ return false;
28
+ return OWN_WEB_UI_TITLES.includes(title.slice(0, -suffix.length));
29
+ }
30
+ function hasBoundedSourceMetadata(source) {
31
+ if (!isObservationOwner(source.app))
32
+ return false;
33
+ if (typeof source.windowId !== "string")
34
+ return false;
35
+ if (source.windowId.length === 0)
36
+ return false;
37
+ if (source.windowId.length > 256)
38
+ return false;
39
+ for (const field of ["documentId", "title", "url"]) {
40
+ if (source[field] === undefined)
41
+ continue;
42
+ if (typeof source[field] !== "string")
43
+ return false;
44
+ if (source[field].length > 4096)
45
+ return false;
46
+ }
47
+ return true;
48
+ }
49
+ function boundedObservation(observation) {
50
+ let bounded = observation;
51
+ while (Buffer.byteLength(JSON.stringify(bounded)) >
52
+ OBSERVATION_WIRE_LIMIT - 1024 &&
53
+ bounded.content.length > 0) {
54
+ bounded = {
55
+ ...bounded,
56
+ content: bounded.content.slice(0, Math.floor(bounded.content.length * 0.75)),
57
+ coverage: "partial",
58
+ coverageReason: "transport_content_limit",
59
+ };
60
+ }
61
+ return bounded;
62
+ }
63
+ /** Bounded source-aware deduplication; returning to a source remains an activity observation. */
64
+ export class ObservationFilter {
65
+ excludedApplications;
66
+ // Private to one collector lease: source identity must not retain or expose raw secrets.
67
+ sourceIdentityKey = randomBytes(32);
68
+ sequence = 0;
69
+ lastStatus;
70
+ lastSource;
71
+ fingerprints = new Map();
72
+ constructor(excludedApplications = []) {
73
+ this.excludedApplications = excludedApplications;
74
+ }
75
+ accept(value) {
76
+ if (isPassiveCollectorEvent(value) && value.type === "status") {
77
+ if (value.state === "paused")
78
+ this.lastSource = undefined;
79
+ const reason = value.reason === undefined
80
+ ? undefined
81
+ : redactObservationText(value.reason).slice(0, 512);
82
+ const identity = JSON.stringify([value.state, reason]);
83
+ if (identity === this.lastStatus)
84
+ return undefined;
85
+ this.lastStatus = identity;
86
+ return {
87
+ type: "status",
88
+ state: value.state,
89
+ ...(reason === undefined ? {} : { reason }),
90
+ };
91
+ }
92
+ if (!isHostRecord(value) ||
93
+ value.type !== "snapshot" ||
94
+ !isHostRecord(value.source))
95
+ return undefined;
96
+ if (typeof value.beforeKey !== "string" ||
97
+ value.beforeKey !== value.afterKey)
98
+ return undefined;
99
+ if (value.secure === true || value.locked === true)
100
+ return undefined;
101
+ if (typeof value.content !== "string" ||
102
+ typeof value.source.app !== "string")
103
+ return undefined;
104
+ const rawSource = {
105
+ app: value.source.app,
106
+ processId: value.source.processId,
107
+ windowId: value.source.windowId,
108
+ documentId: value.source.documentId,
109
+ title: value.source.title,
110
+ url: value.source.url,
111
+ };
112
+ if (!hasBoundedSourceMetadata(rawSource))
113
+ return undefined;
114
+ if (isOwnWebUiWindowTitle(rawSource.title)) {
115
+ this.lastSource = undefined;
116
+ return undefined;
117
+ }
118
+ const isExcludedApplication = this.excludedApplications.some((app) => app.toLocaleLowerCase() === rawSource.app.toLocaleLowerCase());
119
+ if (isExcludedApplication) {
120
+ this.lastSource = undefined;
121
+ return undefined;
122
+ }
123
+ const sourceKey = createHmac("sha256", this.sourceIdentityKey)
124
+ .update(JSON.stringify([
125
+ rawSource.app,
126
+ rawSource.processId,
127
+ rawSource.windowId,
128
+ rawSource.documentId,
129
+ rawSource.title,
130
+ rawSource.url,
131
+ ]))
132
+ .digest("hex");
133
+ const source = redactObservationSource(rawSource, sourceKey);
134
+ const content = redactObservationText(value.content)
135
+ .replace(/\r\n?/gu, "\n")
136
+ .replace(/[ \t]+\n/gu, "\n")
137
+ .trim();
138
+ const fingerprint = createHash("sha256").update(content).digest("hex");
139
+ const previous = this.fingerprints.get(sourceKey);
140
+ const duplicate = previous?.fingerprint === fingerprint;
141
+ if (duplicate && this.lastSource === sourceKey)
142
+ return undefined;
143
+ const truncated = content.length > OBSERVATION_CONTENT_LIMIT;
144
+ let coverageReason = typeof value.coverageReason === "string"
145
+ ? redactObservationText(value.coverageReason).slice(0, 512)
146
+ : undefined;
147
+ if (truncated)
148
+ coverageReason = "content_limit";
149
+ const observation = {
150
+ id: randomUUID(),
151
+ timestamp: new Date().toISOString(),
152
+ sequence: this.sequence + 1,
153
+ source,
154
+ content: duplicate ? "" : content.slice(0, OBSERVATION_CONTENT_LIMIT),
155
+ ...(duplicate ? { revisitsObservationId: previous.observationId } : {}),
156
+ kind: duplicate ? "activity" : value.kind === "edit" ? "edit" : "view",
157
+ extraction: value.extraction,
158
+ coverage: truncated
159
+ ? "partial"
160
+ : value.coverage,
161
+ coverageReason,
162
+ };
163
+ const event = {
164
+ type: "observation",
165
+ observation: boundedObservation(observation),
166
+ };
167
+ if (!isPassiveCollectorEvent(event))
168
+ return undefined;
169
+ this.sequence += 1;
170
+ this.lastSource = sourceKey;
171
+ this.fingerprints.delete(sourceKey);
172
+ this.fingerprints.set(sourceKey, {
173
+ fingerprint,
174
+ observationId: duplicate ? previous.observationId : observation.id,
175
+ });
176
+ if (this.fingerprints.size > 128)
177
+ this.fingerprints.delete(this.fingerprints.keys().next().value);
178
+ return event;
179
+ }
180
+ }
@@ -0,0 +1 @@
1
+ export declare const LINUX_OBSERVATION_SCRIPT: string;
@@ -0,0 +1,228 @@
1
+ /** Requires the session's AT-SPI, GLib and D-Bus Python bindings; never installs dependencies. */
2
+ import { OBSERVATION_CAPTURE_POLICY as policy } from "./observation-capture-policy.js";
3
+ export const LINUX_OBSERVATION_SCRIPT = String.raw `
4
+ import os, json, time, sys
5
+ def emit(value):
6
+ print(json.dumps(value, ensure_ascii=False), flush=True)
7
+ try:
8
+ import pyatspi
9
+ import dbus
10
+ from gi.repository import GLib
11
+ from dbus.mainloop.glib import DBusGMainLoop
12
+ except ImportError:
13
+ emit({'type':'status','state':'unavailable','reason':'linux_atspi_python_dependencies_missing'})
14
+ sys.exit(0)
15
+ if not (os.environ.get('DISPLAY') or os.environ.get('WAYLAND_DISPLAY')):
16
+ emit({'type':'status','state':'unavailable','reason':'graphical_session_unavailable'})
17
+ sys.exit(0)
18
+ DBusGMainLoop(set_as_default=True)
19
+ bus = dbus.SessionBus()
20
+ excluded = {str(x).casefold() for x in json.loads(os.environ.get('ABOT_OBSERVATION_EXCLUSIONS','[]'))}
21
+ lock_source = None
22
+ for name, path, interface in [('org.freedesktop.ScreenSaver','/org/freedesktop/ScreenSaver','org.freedesktop.ScreenSaver'),('org.gnome.ScreenSaver','/org/gnome/ScreenSaver','org.gnome.ScreenSaver')]:
23
+ try:
24
+ candidate = dbus.Interface(bus.get_object(name,path), interface)
25
+ candidate.GetActive(timeout=1)
26
+ lock_source = candidate
27
+ break
28
+ except Exception:
29
+ pass
30
+ if lock_source is None:
31
+ emit({'type':'status','state':'unavailable','reason':'session_lock_state_unavailable'})
32
+ sys.exit(0)
33
+ pending = 0
34
+ maximum = 0
35
+ last_capture = -${policy.minimumIntervalMs / 1000}
36
+ burst_started = 0
37
+ burst_captures = 0
38
+ noise_paused = False
39
+ editing = False
40
+ editing_key = None
41
+ editing_document = None
42
+ def active():
43
+ desktop = pyatspi.Registry.getDesktop(0)
44
+ for app in desktop:
45
+ if app is None: continue
46
+ for window in app:
47
+ if window is not None and window.getState().contains(pyatspi.STATE_ACTIVE):
48
+ return app, window
49
+ return None, None
50
+ def process_id(app):
51
+ return int(app.get_process_id())
52
+ def object_id(item):
53
+ return str(item.path)
54
+ def document_scope(window):
55
+ queue, count = [window], 0
56
+ started = time.monotonic()
57
+ while queue and count < 400 and time.monotonic()-started < 0.25:
58
+ item = queue.pop(0)
59
+ count += 1
60
+ if not item.getState().contains(pyatspi.STATE_SHOWING): continue
61
+ if item.getState().contains(pyatspi.STATE_FOCUSED):
62
+ ancestor, found = item, None
63
+ for depth in range(32):
64
+ if ancestor is None: break
65
+ if ancestor == window: return found
66
+ if found is None and ancestor.getRole() in [pyatspi.ROLE_DOCUMENT_FRAME,pyatspi.ROLE_DOCUMENT_WEB,pyatspi.ROLE_DOCUMENT_TEXT]: found = ancestor
67
+ ancestor = ancestor.parent
68
+ for child in item:
69
+ if len(queue) >= 400: break
70
+ if child is not None: queue.append(child)
71
+ return None
72
+ def documents(window):
73
+ document = document_scope(window)
74
+ return object_id(document) if document is not None else ''
75
+ def visible_leaf(item, window):
76
+ try:
77
+ rect = item.queryComponent().getExtents(pyatspi.DESKTOP_COORDS)
78
+ frame = window.queryComponent().getExtents(pyatspi.DESKTOP_COORDS)
79
+ return rect.width > 0 and rect.height > 0 and frame.width > 0 and frame.height > 0 and rect.x < frame.x + frame.width and rect.x + rect.width > frame.x and rect.y < frame.y + frame.height and rect.y + rect.height > frame.y
80
+ except (NotImplementedError, AttributeError):
81
+ return False
82
+ def window_key(app, window):
83
+ return str(process_id(app)) + ':' + object_id(window) + ':' + str(window.name)
84
+ def identity(app, window):
85
+ return window_key(app,window) + ':' + documents(window)
86
+ def capture():
87
+ global pending, maximum, editing, last_capture, burst_started, burst_captures, noise_paused
88
+ if pending: GLib.source_remove(pending)
89
+ if maximum: GLib.source_remove(maximum)
90
+ pending = maximum = 0
91
+ now = time.monotonic()
92
+ if noise_paused:
93
+ noise_paused, burst_captures = False, 0
94
+ if now-last_capture < ${policy.minimumIntervalMs / 1000}:
95
+ pending = GLib.timeout_add(max(1,int((${policy.minimumIntervalMs / 1000}-(now-last_capture))*1000)),capture)
96
+ return False
97
+ if now-burst_started > ${policy.burstWindowMs / 1000}:
98
+ burst_started, burst_captures = now, 0
99
+ if not editing: burst_captures += 1
100
+ if burst_captures > ${policy.burstLimit}:
101
+ noise_paused = True
102
+ emit({'type':'status','state':'paused','reason':'continuous_activity'})
103
+ pending = GLib.timeout_add(${policy.resumeQuietMs},capture)
104
+ return False
105
+ last_capture = now
106
+ kind = 'edit' if editing else 'view'
107
+ editing = False
108
+ try:
109
+ if bool(lock_source.GetActive(timeout=1)):
110
+ emit({'type':'status','state':'paused','reason':'screen_locked'})
111
+ return False
112
+ app, window = active()
113
+ if window is None: return False
114
+ app_name = str(app.name)
115
+ if app_name.casefold() in excluded:
116
+ emit({'type':'status','state':'paused','reason':'application_excluded'})
117
+ return False
118
+ key = identity(app, window)
119
+ document_ids = documents(window)
120
+ edit_matches = editing_key == window_key(app,window)
121
+ if editing_document and editing_document not in document_ids.split('|'): edit_matches = False
122
+ kind = 'edit' if kind == 'edit' and edit_matches else 'view'
123
+ content_root = document_scope(window)
124
+ queue, parts, seen = [content_root if content_root is not None else window], [], set()
125
+ started = time.monotonic()
126
+ count = 0
127
+ while queue and count < 600 and time.monotonic()-started < 0.4 and sum(map(len,parts)) < 24000:
128
+ item = queue.pop(0)
129
+ count += 1
130
+ state = item.getState()
131
+ if item.getRole() == pyatspi.ROLE_PASSWORD_TEXT: continue
132
+ if not state.contains(pyatspi.STATE_SHOWING): continue
133
+ if content_root is None and item.getRole() in [pyatspi.ROLE_DOCUMENT_FRAME,pyatspi.ROLE_DOCUMENT_WEB,pyatspi.ROLE_DOCUMENT_TEXT]: continue
134
+ text = ''
135
+ # Read leaf text/editable values, not a parent document that could include protected descendants.
136
+ if item.childCount == 0 and visible_leaf(item,window):
137
+ try:
138
+ text_api = item.queryText()
139
+ text = text_api.getText(0,min(text_api.characterCount,24000))
140
+ except (NotImplementedError, AttributeError):
141
+ if item.getRole() in [pyatspi.ROLE_LABEL,pyatspi.ROLE_TEXT,pyatspi.ROLE_HEADING]: text = item.name or ''
142
+ if text and text not in seen:
143
+ seen.add(text)
144
+ parts.append(text)
145
+ for child in item:
146
+ if len(queue) >= 600: break
147
+ if child is not None: queue.append(child)
148
+ after_app, after_window = active()
149
+ if after_window is None or identity(after_app,after_window) != key or bool(lock_source.GetActive(timeout=1)): return False
150
+ emit({'type':'snapshot','source':{'app':app_name,'processId':process_id(app),'windowId':object_id(window),'documentId':documents(window),'title':str(window.name)},'content':'\n'.join(parts),'kind':kind,'extraction':'atspi','coverage':'partial' if parts else 'metadata_only','coverageReason':'visible_accessibility_subset','beforeKey':key,'afterKey':key})
151
+ emit({'type':'status','state':'partial','reason':'atspi_application_coverage'})
152
+ except Exception:
153
+ emit({'type':'status','state':'partial','reason':'accessibility_read_unavailable'})
154
+ return False
155
+ def schedule_capture():
156
+ global pending, maximum
157
+ if pending: GLib.source_remove(pending)
158
+ pending = GLib.timeout_add(${policy.resumeQuietMs} if noise_paused else 1200, capture)
159
+ if not noise_paused and not maximum: maximum = GLib.timeout_add(5000, capture)
160
+ def changed(event=None, *args, switched=False):
161
+ global pending, maximum, editing, editing_key, editing_document, noise_paused, burst_captures, burst_started
162
+ if switched:
163
+ noise_paused, burst_captures, burst_started = False, 0, time.monotonic()
164
+ if event is not None and hasattr(event,'type'):
165
+ try:
166
+ event_type = str(event.type)
167
+ editable_event = event_type.startswith('object:text-changed') and event.source.getState().contains(pyatspi.STATE_EDITABLE)
168
+ if noise_paused and not editable_event and not event_type.startswith('window:activate'):
169
+ schedule_capture()
170
+ return
171
+ app, current = active()
172
+ if current is None: return
173
+ source = event.source
174
+ ancestor = source
175
+ document = None
176
+ for depth in range(32):
177
+ if ancestor is None or ancestor == current: break
178
+ if ancestor.getRole() in [pyatspi.ROLE_DOCUMENT_FRAME,pyatspi.ROLE_DOCUMENT_WEB,pyatspi.ROLE_DOCUMENT_TEXT]: document = object_id(ancestor)
179
+ ancestor = ancestor.parent
180
+ if ancestor != current: return
181
+ if editable_event:
182
+ editing = True
183
+ editing_key = window_key(app,current)
184
+ editing_document = document
185
+ if editing or event_type.startswith('window:activate'):
186
+ noise_paused, burst_captures, burst_started = False, 0, time.monotonic()
187
+ except Exception: return
188
+ schedule_capture()
189
+ pyatspi.Registry.registerEventListener(changed,'window:activate','object:state-changed:focused','object:property-change:accessible-name','object:text-changed','object:children-changed','object:visible-data-changed')
190
+ bus.add_signal_receiver(changed, signal_name='ActiveChanged')
191
+ if os.environ.get('DISPLAY') and not os.environ.get('WAYLAND_DISPLAY'):
192
+ # X11 root-property notifications supplement accessibility focus events, without polling.
193
+ try:
194
+ import ctypes
195
+ x11 = ctypes.CDLL('libX11.so.6')
196
+ x11.XOpenDisplay.restype = ctypes.c_void_p
197
+ x11.XDefaultRootWindow.argtypes = [ctypes.c_void_p]
198
+ x11.XDefaultRootWindow.restype = ctypes.c_ulong
199
+ x11.XConnectionNumber.argtypes = [ctypes.c_void_p]
200
+ x11.XSelectInput.argtypes = [ctypes.c_void_p,ctypes.c_ulong,ctypes.c_long]
201
+ x11.XPending.argtypes = [ctypes.c_void_p]
202
+ x11.XNextEvent.argtypes = [ctypes.c_void_p,ctypes.c_void_p]
203
+ x11.XInternAtom.argtypes = [ctypes.c_void_p,ctypes.c_char_p,ctypes.c_int]
204
+ x11.XInternAtom.restype = ctypes.c_ulong
205
+ class XPropertyEvent(ctypes.Structure):
206
+ _fields_ = [('type',ctypes.c_int),('serial',ctypes.c_ulong),('send_event',ctypes.c_int),('display',ctypes.c_void_p),('window',ctypes.c_ulong),('atom',ctypes.c_ulong),('time',ctypes.c_ulong),('state',ctypes.c_int)]
207
+ display = x11.XOpenDisplay(None)
208
+ if display:
209
+ active_window_atom = x11.XInternAtom(display,b'_NET_ACTIVE_WINDOW',False)
210
+ x11.XSelectInput(display,x11.XDefaultRootWindow(display),1 << 22)
211
+ def xchanged(fd, condition):
212
+ event = (ctypes.c_long * 24)()
213
+ switched = False
214
+ for count in range(64):
215
+ if not x11.XPending(display): break
216
+ x11.XNextEvent(display,ctypes.byref(event))
217
+ property_event = ctypes.cast(ctypes.byref(event),ctypes.POINTER(XPropertyEvent)).contents
218
+ if property_event.type == 28 and property_event.atom == active_window_atom:
219
+ switched = True
220
+ if switched: changed(switched=True)
221
+ return True
222
+ GLib.io_add_watch(x11.XConnectionNumber(display),GLib.IO_IN,xchanged)
223
+ except Exception:
224
+ emit({'type':'status','state':'partial','reason':'x11_events_unavailable_atspi_only'})
225
+ emit({'type':'status','state':'partial','reason':'wayland_atspi_coverage' if os.environ.get('WAYLAND_DISPLAY') else 'x11_atspi_coverage'})
226
+ changed()
227
+ pyatspi.Registry.start()
228
+ `;
@@ -0,0 +1,2 @@
1
+ /** Pure Swift permission gate; injected effects keep native tests free of TCC requests. */
2
+ export declare const MACOS_OBSERVATION_PERMISSION_SCRIPT: string;
@@ -0,0 +1,26 @@
1
+ /** Pure Swift permission gate; injected effects keep native tests free of TCC requests. */
2
+ export const MACOS_OBSERVATION_PERMISSION_SCRIPT = String.raw `
3
+ func waitForMacObservationPermission(
4
+ isTrusted: () -> Bool,
5
+ requestPermission: () -> Void,
6
+ now: () -> Double,
7
+ wait: (Double) -> Void,
8
+ reportRequired: () -> Void,
9
+ reportTimeout: () -> Void
10
+ ) -> Bool {
11
+ if isTrusted() { return true }
12
+ let deadline = now() + 120
13
+ requestPermission()
14
+ reportRequired()
15
+ while true {
16
+ let remaining = deadline - now()
17
+ let permissionWaitExpired = remaining <= 0
18
+ if permissionWaitExpired {
19
+ reportTimeout()
20
+ return false
21
+ }
22
+ wait(min(2, remaining))
23
+ if isTrusted() { return true }
24
+ }
25
+ }
26
+ `;
@@ -0,0 +1 @@
1
+ export declare const MACOS_OBSERVATION_SCRIPT: string;