@mostra/runtime 0.9.0 → 0.11.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 (279) hide show
  1. package/dist/bin.js +6628 -9
  2. package/dist/bin.js.map +1 -1
  3. package/dist/builder/child/main.js +2 -2
  4. package/dist/{child-Chiavhdx.js → child-BmNZ4a70.js} +2 -2
  5. package/dist/{child-Chiavhdx.js.map → child-BmNZ4a70.js.map} +1 -1
  6. package/dist/deps/child/install.js +1 -1
  7. package/dist/{directories-mJ1qlVht.js → directories-BLJjeSPD.js} +5 -5
  8. package/dist/directories-BLJjeSPD.js.map +1 -0
  9. package/dist/{files-FygSJIzK.js → files-DGeWuE4I.js} +2 -2
  10. package/dist/{files-FygSJIzK.js.map → files-DGeWuE4I.js.map} +1 -1
  11. package/dist/index.d.ts +2 -0
  12. package/dist/index.d.ts.map +1 -1
  13. package/dist/index.js +2 -2
  14. package/dist/{instance-EnaZPs14.js → instance-DCiUHvgZ.js} +3835 -255
  15. package/dist/instance-DCiUHvgZ.js.map +1 -0
  16. package/dist/reference/cli.md +1322 -0
  17. package/dist/reference/diagnostics.json +1552 -0
  18. package/dist/reference/errors/MOSTRA_A11Y_MINOR.md +23 -0
  19. package/dist/reference/errors/MOSTRA_A11Y_SERIOUS.md +23 -0
  20. package/dist/reference/errors/MOSTRA_ACTION_CANCELLED.md +23 -0
  21. package/dist/reference/errors/MOSTRA_ACTION_EVENT_INVALID.md +23 -0
  22. package/dist/reference/errors/MOSTRA_ACTION_EXPORT_INVALID.md +23 -0
  23. package/dist/reference/errors/MOSTRA_ACTION_INTERRUPTED.md +23 -0
  24. package/dist/reference/errors/MOSTRA_ACTION_PAUSED.md +23 -0
  25. package/dist/reference/errors/MOSTRA_ACTION_RUN_NOT_FOUND.md +23 -0
  26. package/dist/reference/errors/MOSTRA_ACTION_THREW.md +23 -0
  27. package/dist/reference/errors/MOSTRA_ACTION_TOO_LARGE.md +23 -0
  28. package/dist/reference/errors/MOSTRA_ACTION_UNKNOWN_FUNCTION.md +23 -0
  29. package/dist/reference/errors/MOSTRA_ACTION_UNSERIALIZABLE.md +23 -0
  30. package/dist/reference/errors/MOSTRA_ARTIFACT_BUNDLE_INVALID.md +23 -0
  31. package/dist/reference/errors/MOSTRA_ARTIFACT_DIR_NOT_EMPTY.md +23 -0
  32. package/dist/reference/errors/MOSTRA_ARTIFACT_ENTRY_AMBIGUOUS.md +23 -0
  33. package/dist/reference/errors/MOSTRA_ARTIFACT_ID_DROPPED.md +23 -0
  34. package/dist/reference/errors/MOSTRA_ARTIFACT_NOT_FOUND.md +23 -0
  35. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_ENTRY.md +23 -0
  36. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_PAGE.md +23 -0
  37. package/dist/reference/errors/MOSTRA_ARTIFACT_PATCH_REJECTED.md +23 -0
  38. package/dist/reference/errors/MOSTRA_ARTIFACT_PATH_INVALID.md +23 -0
  39. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_MISSING.md +23 -0
  40. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_UNREADABLE.md +23 -0
  41. package/dist/reference/errors/MOSTRA_ARTIFACT_TEMPLATE_UNKNOWN.md +23 -0
  42. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_COLLECTED.md +23 -0
  43. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_NOT_FOUND.md +23 -0
  44. package/dist/reference/errors/MOSTRA_BUILD_CRASHED.md +23 -0
  45. package/dist/reference/errors/MOSTRA_BUILD_FAILED.md +23 -0
  46. package/dist/reference/errors/MOSTRA_BUILD_TIMEOUT.md +23 -0
  47. package/dist/reference/errors/MOSTRA_BUILD_UNRESOLVED.md +23 -0
  48. package/dist/reference/errors/MOSTRA_CLI_CONFIG_UNWRITABLE.md +23 -0
  49. package/dist/reference/errors/MOSTRA_CLI_UNKNOWN_COMMAND.md +23 -0
  50. package/dist/reference/errors/MOSTRA_CLI_USAGE.md +23 -0
  51. package/dist/reference/errors/MOSTRA_CONSOLE_ERROR.md +23 -0
  52. package/dist/reference/errors/MOSTRA_CONSOLE_WARNING.md +23 -0
  53. package/dist/reference/errors/MOSTRA_DEP_INSTALL_FAILED.md +23 -0
  54. package/dist/reference/errors/MOSTRA_DEP_MISSING.md +23 -0
  55. package/dist/reference/errors/MOSTRA_DEP_NOT_FOUND.md +23 -0
  56. package/dist/reference/errors/MOSTRA_DEP_OFFLINE.md +23 -0
  57. package/dist/reference/errors/MOSTRA_DEP_SPEC_INVALID.md +23 -0
  58. package/dist/reference/errors/MOSTRA_DEP_TIMEOUT.md +23 -0
  59. package/dist/reference/errors/MOSTRA_DEP_WARM_CONFLICT.md +23 -0
  60. package/dist/reference/errors/MOSTRA_ENV_BIND_FAILED.md +23 -0
  61. package/dist/reference/errors/MOSTRA_ENV_BROWSER_MISSING.md +23 -0
  62. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_DOWNLOAD_FAILED.md +23 -0
  63. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_INVALID.md +23 -0
  64. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_UNAVAILABLE.md +23 -0
  65. package/dist/reference/errors/MOSTRA_ENV_HELPER_MISSING.md +23 -0
  66. package/dist/reference/errors/MOSTRA_ENV_NODE_UNSUPPORTED.md +23 -0
  67. package/dist/reference/errors/MOSTRA_ENV_PORT_TAKEN.md +23 -0
  68. package/dist/reference/errors/MOSTRA_ENV_RUNTIME_INSTALLING.md +23 -0
  69. package/dist/reference/errors/MOSTRA_ENV_RUNTIME_MISSING.md +23 -0
  70. package/dist/reference/errors/MOSTRA_ENV_SERVICE_FAILED.md +23 -0
  71. package/dist/reference/errors/MOSTRA_ENV_SHELL_MISSING.md +23 -0
  72. package/dist/reference/errors/MOSTRA_ENV_WARM_MISSING.md +23 -0
  73. package/dist/reference/errors/MOSTRA_FIELD_CONFLICT.md +23 -0
  74. package/dist/reference/errors/MOSTRA_FIELD_DUPLICATE_ID.md +23 -0
  75. package/dist/reference/errors/MOSTRA_FIELD_ID_INVALID.md +23 -0
  76. package/dist/reference/errors/MOSTRA_FIELD_ID_UNSTABLE.md +23 -0
  77. package/dist/reference/errors/MOSTRA_FIELD_MUTATION_ID_REUSED.md +23 -0
  78. package/dist/reference/errors/MOSTRA_FIELD_SHARED.md +23 -0
  79. package/dist/reference/errors/MOSTRA_FIELD_TOO_LARGE.md +23 -0
  80. package/dist/reference/errors/MOSTRA_FIELD_UNBOUND.md +23 -0
  81. package/dist/reference/errors/MOSTRA_HOME_DISK_FULL.md +23 -0
  82. package/dist/reference/errors/MOSTRA_HOME_GC_INCOMPLETE.md +23 -0
  83. package/dist/reference/errors/MOSTRA_HOME_GONE.md +23 -0
  84. package/dist/reference/errors/MOSTRA_HOME_INTEGRITY.md +23 -0
  85. package/dist/reference/errors/MOSTRA_HOME_LEDGER_UNREADABLE.md +23 -0
  86. package/dist/reference/errors/MOSTRA_HOME_LOCKED.md +23 -0
  87. package/dist/reference/errors/MOSTRA_HOME_MISMATCH.md +23 -0
  88. package/dist/reference/errors/MOSTRA_HOME_NETWORK_FILESYSTEM.md +23 -0
  89. package/dist/reference/errors/MOSTRA_HOME_NOT_ALWAYS_ON.md +23 -0
  90. package/dist/reference/errors/MOSTRA_HOME_NOT_OWNED.md +23 -0
  91. package/dist/reference/errors/MOSTRA_HOME_SOCKET_TOO_LONG.md +23 -0
  92. package/dist/reference/errors/MOSTRA_HOME_TOO_NEW.md +23 -0
  93. package/dist/reference/errors/MOSTRA_HOST_CONNECTION_CLOSED.md +23 -0
  94. package/dist/reference/errors/MOSTRA_HOST_CURSOR_COMPACTED.md +23 -0
  95. package/dist/reference/errors/MOSTRA_HOST_IDENTITY_UNAVAILABLE.md +23 -0
  96. package/dist/reference/errors/MOSTRA_HOST_INITIALIZE_ORDER.md +23 -0
  97. package/dist/reference/errors/MOSTRA_HOST_INTERNAL_ERROR.md +23 -0
  98. package/dist/reference/errors/MOSTRA_HOST_INVALID_PARAMS.md +23 -0
  99. package/dist/reference/errors/MOSTRA_HOST_MALFORMED.md +23 -0
  100. package/dist/reference/errors/MOSTRA_HOST_MESSAGE_TOO_LARGE.md +23 -0
  101. package/dist/reference/errors/MOSTRA_HOST_METHOD_UNKNOWN.md +23 -0
  102. package/dist/reference/errors/MOSTRA_HOST_NOTIFICATION_UNSUPPORTED.md +23 -0
  103. package/dist/reference/errors/MOSTRA_HOST_PORT_UNSUPPORTED.md +23 -0
  104. package/dist/reference/errors/MOSTRA_HOST_REQUEST_ID_REUSED.md +23 -0
  105. package/dist/reference/errors/MOSTRA_HOST_REVISION_UNSUPPORTED.md +23 -0
  106. package/dist/reference/errors/MOSTRA_HOST_SHUTDOWN_REFUSED.md +23 -0
  107. package/dist/reference/errors/MOSTRA_HOST_SUBSCRIPTION_UNKNOWN.md +23 -0
  108. package/dist/reference/errors/MOSTRA_HOST_TIMEOUT.md +23 -0
  109. package/dist/reference/errors/MOSTRA_HYGIENE_CONTENT_TYPE.md +23 -0
  110. package/dist/reference/errors/MOSTRA_HYGIENE_CSRF_MISSING.md +23 -0
  111. package/dist/reference/errors/MOSTRA_HYGIENE_FRAME_SESSION.md +23 -0
  112. package/dist/reference/errors/MOSTRA_HYGIENE_HEADERS_TOO_LARGE.md +23 -0
  113. package/dist/reference/errors/MOSTRA_HYGIENE_HOST_REFUSED.md +23 -0
  114. package/dist/reference/errors/MOSTRA_HYGIENE_NOT_SERVED.md +23 -0
  115. package/dist/reference/errors/MOSTRA_HYGIENE_ORIGIN_REFUSED.md +23 -0
  116. package/dist/reference/errors/MOSTRA_HYGIENE_RATE_LIMITED.md +23 -0
  117. package/dist/reference/errors/MOSTRA_HYGIENE_REQUEST_MALFORMED.md +23 -0
  118. package/dist/reference/errors/MOSTRA_HYGIENE_SCOPE_DENIED.md +23 -0
  119. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_CONFLICT.md +23 -0
  120. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_MISSING.md +23 -0
  121. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_INVALID.md +23 -0
  122. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_REVOKED.md +23 -0
  123. package/dist/reference/errors/MOSTRA_LIVE_SOURCE_FAILED.md +23 -0
  124. package/dist/reference/errors/MOSTRA_LIVE_TOO_LARGE.md +23 -0
  125. package/dist/reference/errors/MOSTRA_MANIFEST_INVALID.md +23 -0
  126. package/dist/reference/errors/MOSTRA_MANIFEST_NOT_LITERAL.md +23 -0
  127. package/dist/reference/errors/MOSTRA_MANIFEST_UNKNOWN_KEY.md +23 -0
  128. package/dist/reference/errors/MOSTRA_NETWORK_EXTERNAL_FAILED.md +23 -0
  129. package/dist/reference/errors/MOSTRA_NETWORK_REQUEST_FAILED.md +23 -0
  130. package/dist/reference/errors/MOSTRA_PLATFORM_UNSUPPORTED.md +23 -0
  131. package/dist/reference/errors/MOSTRA_PUBLISH_ID_CONFLICT.md +23 -0
  132. package/dist/reference/errors/MOSTRA_PUBLISH_SOURCE_CHANGED.md +23 -0
  133. package/dist/reference/errors/MOSTRA_PUBLISH_VERIFY_FAILED.md +23 -0
  134. package/dist/reference/errors/MOSTRA_REGRESSION_ACTION_REMOVED.md +23 -0
  135. package/dist/reference/errors/MOSTRA_REGRESSION_ARIA.md +23 -0
  136. package/dist/reference/errors/MOSTRA_REGRESSION_FIELD_REMOVED.md +23 -0
  137. package/dist/reference/errors/MOSTRA_REGRESSION_LIVE_REMOVED.md +23 -0
  138. package/dist/reference/errors/MOSTRA_REGRESSION_PAGE_REMOVED.md +23 -0
  139. package/dist/reference/errors/MOSTRA_REGRESSION_PIXELS.md +23 -0
  140. package/dist/reference/errors/MOSTRA_REMOTE_CONFIG_INVALID.md +23 -0
  141. package/dist/reference/errors/MOSTRA_REMOTE_HOME_MOVING.md +23 -0
  142. package/dist/reference/errors/MOSTRA_REMOTE_HOME_SUSPENDED.md +23 -0
  143. package/dist/reference/errors/MOSTRA_REMOTE_LIMIT_REACHED.md +23 -0
  144. package/dist/reference/errors/MOSTRA_REMOTE_LOGIN_FAILED.md +23 -0
  145. package/dist/reference/errors/MOSTRA_REMOTE_NOT_OWNER_INSTANCE.md +23 -0
  146. package/dist/reference/errors/MOSTRA_REMOTE_NO_INSTANCE.md +23 -0
  147. package/dist/reference/errors/MOSTRA_REMOTE_OPERATOR_UNAVAILABLE.md +23 -0
  148. package/dist/reference/errors/MOSTRA_REMOTE_OWNER_OFFLINE.md +23 -0
  149. package/dist/reference/errors/MOSTRA_REMOTE_PAUSED_BY_OPERATOR.md +23 -0
  150. package/dist/reference/errors/MOSTRA_REMOTE_QUEUE_FULL.md +23 -0
  151. package/dist/reference/errors/MOSTRA_REMOTE_RATE_LIMITED.md +23 -0
  152. package/dist/reference/errors/MOSTRA_REMOTE_SIGN_IN_REQUIRED.md +23 -0
  153. package/dist/reference/errors/MOSTRA_REMOTE_UNDER_REVIEW.md +23 -0
  154. package/dist/reference/errors/MOSTRA_REMOTE_UNREACHABLE.md +23 -0
  155. package/dist/reference/errors/MOSTRA_RUNTIME_BLANK.md +23 -0
  156. package/dist/reference/errors/MOSTRA_RUNTIME_NOT_READY.md +23 -0
  157. package/dist/reference/errors/MOSTRA_RUNTIME_PAGE_ERROR.md +23 -0
  158. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_CRASHED.md +23 -0
  159. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_PARKED.md +23 -0
  160. package/dist/reference/errors/MOSTRA_SECRET_MISSING.md +23 -0
  161. package/dist/reference/errors/MOSTRA_SHARE_NOT_ENABLED.md +23 -0
  162. package/dist/reference/errors/MOSTRA_SHARE_NOT_FOUND.md +23 -0
  163. package/dist/reference/errors/MOSTRA_SHARE_PORTS_EXHAUSTED.md +23 -0
  164. package/dist/reference/errors/MOSTRA_SHARE_TOOL_MISSING.md +23 -0
  165. package/dist/reference/errors/MOSTRA_SHARE_TOOL_NOT_READY.md +23 -0
  166. package/dist/reference/errors/MOSTRA_SHARE_TTL_INVALID.md +23 -0
  167. package/dist/reference/errors/MOSTRA_SHARE_TUNNEL_FAILED.md +23 -0
  168. package/dist/reference/errors/MOSTRA_SMOKE_BUDGET.md +23 -0
  169. package/dist/reference/errors/MOSTRA_SMOKE_NO_EFFECT.md +23 -0
  170. package/dist/reference/errors/MOSTRA_SUBMIT_ALREADY.md +23 -0
  171. package/dist/reference/errors/MOSTRA_SUBMIT_BLOCKED.md +23 -0
  172. package/dist/reference/errors/MOSTRA_SUBMIT_CHANNEL_DENIED.md +23 -0
  173. package/dist/reference/errors/MOSTRA_SUBMIT_NOT_FOUND.md +23 -0
  174. package/dist/reference/errors/MOSTRA_SUBMIT_PAUSED.md +23 -0
  175. package/dist/reference/errors/MOSTRA_SUBMIT_POLICY_NONE.md +23 -0
  176. package/dist/reference/errors/MOSTRA_SUBMIT_REVISION_MOVED.md +23 -0
  177. package/dist/reference/errors/MOSTRA_SUBMIT_SIGNAL_INVALID.md +23 -0
  178. package/dist/reference/errors/MOSTRA_SUBMIT_VIEW_INVALID.md +23 -0
  179. package/dist/reference/errors/MOSTRA_TARGET_UNAVAILABLE.md +23 -0
  180. package/dist/reference/errors/MOSTRA_TYPE_ERROR.md +23 -0
  181. package/dist/reference/errors/MOSTRA_TYPE_UNTYPED_PACKAGE.md +23 -0
  182. package/dist/reference/errors/MOSTRA_VERIFY_ACTION_SKIPPED.md +23 -0
  183. package/dist/reference/errors/MOSTRA_VERIFY_BASELINE_MISSING.md +23 -0
  184. package/dist/reference/errors/MOSTRA_VERIFY_CRASHED.md +23 -0
  185. package/dist/reference/errors/MOSTRA_VERIFY_LIVE_FAILED.md +23 -0
  186. package/dist/reference/errors/MOSTRA_VERIFY_NO_BASELINE.md +23 -0
  187. package/dist/reference/errors/MOSTRA_VERIFY_SECRET_MISSING.md +23 -0
  188. package/dist/reference/errors/MOSTRA_VERIFY_SKIP_CONSEQUENCE.md +23 -0
  189. package/dist/reference/errors/MOSTRA_VERIFY_TIMEOUT.md +23 -0
  190. package/dist/reference/self-hosting.md +130 -0
  191. package/dist/reference/telemetry.md +84 -0
  192. package/dist/skill/SKILL.md +122 -0
  193. package/dist/skill/assets/examples/dashboard/index.tsx +161 -0
  194. package/dist/skill/assets/examples/dashboard/live.ts +25 -0
  195. package/dist/skill/assets/examples/dashboard/styles.css +125 -0
  196. package/dist/skill/assets/examples/decision/index.tsx +95 -0
  197. package/dist/skill/assets/examples/decision/styles.css +125 -0
  198. package/dist/skill/assets/examples/inbox/actions.ts +23 -0
  199. package/dist/skill/assets/examples/inbox/index.tsx +109 -0
  200. package/dist/skill/assets/examples/inbox/styles.css +125 -0
  201. package/dist/skill/assets/studio.css +125 -0
  202. package/dist/skill/references/answers.md +217 -0
  203. package/dist/skill/references/design.md +154 -0
  204. package/dist/skill/references/libraries.md +167 -0
  205. package/dist/skill/references/long-lived.md +148 -0
  206. package/dist/skill/references/mcp.md +68 -0
  207. package/dist/skill/references/page.md +131 -0
  208. package/dist/skill/references/server.md +146 -0
  209. package/dist/skill/references/sharing.md +123 -0
  210. package/dist/skill/references/verify.md +71 -0
  211. package/package.json +12 -5
  212. package/src/actions/index.ts +163 -10
  213. package/src/bin.ts +78 -1
  214. package/src/gateway/actions.ts +40 -4
  215. package/src/gateway/browser.ts +162 -95
  216. package/src/gateway/capabilities.ts +23 -6
  217. package/src/gateway/http.ts +12 -1
  218. package/src/gateway/index.ts +282 -20
  219. package/src/gateway/listener.ts +31 -6
  220. package/src/gateway/routes.ts +23 -7
  221. package/src/gc/index.ts +19 -0
  222. package/src/instance/index.ts +60 -2
  223. package/src/interaction/ephemeral.ts +32 -23
  224. package/src/interaction/events.ts +21 -1
  225. package/src/interaction/imports.ts +317 -0
  226. package/src/interaction/index.ts +228 -15
  227. package/src/interaction/outbox.ts +9 -0
  228. package/src/interaction/pause.ts +106 -0
  229. package/src/interaction/results.ts +8 -1
  230. package/src/interaction/runs.ts +52 -2
  231. package/src/interaction/submissions.ts +59 -2
  232. package/src/interaction/tally.ts +129 -0
  233. package/src/interaction/viewers.ts +34 -1
  234. package/src/ledger/index.ts +124 -10
  235. package/src/ledger/migrations.ts +234 -0
  236. package/src/ledger/types.ts +8 -0
  237. package/src/link/author.ts +215 -0
  238. package/src/link/binding.ts +289 -0
  239. package/src/link/hosted.ts +101 -0
  240. package/src/link/http.ts +141 -0
  241. package/src/link/index.ts +10 -0
  242. package/src/link/manager.ts +1489 -0
  243. package/src/link/relay.ts +512 -0
  244. package/src/live/index.ts +112 -2
  245. package/src/platform/filesystems.ts +78 -0
  246. package/src/platform/index.ts +1 -0
  247. package/src/protocol-server/client.ts +53 -0
  248. package/src/protocol-server/index.ts +19 -2
  249. package/src/protocol-server/server.ts +38 -7
  250. package/src/protocol-server/websocket.ts +161 -0
  251. package/src/publish/bundle.ts +398 -0
  252. package/src/publish/manifest.ts +9 -0
  253. package/src/publish/methods.ts +12 -1
  254. package/src/publish/publisher.ts +127 -0
  255. package/src/registry/index.ts +35 -14
  256. package/src/server/api.ts +881 -0
  257. package/src/server/auth.ts +1139 -0
  258. package/src/server/authorize.ts +816 -0
  259. package/src/server/clients.ts +235 -0
  260. package/src/server/config.ts +228 -0
  261. package/src/server/data.ts +427 -0
  262. package/src/server/directory.ts +210 -0
  263. package/src/server/feed.ts +191 -0
  264. package/src/server/handle.ts +172 -0
  265. package/src/server/hosted-pages.ts +532 -0
  266. package/src/server/hosted.ts +1323 -0
  267. package/src/server/index.ts +650 -0
  268. package/src/server/mcp.ts +330 -0
  269. package/src/server/metering.ts +156 -0
  270. package/src/server/oauth-clients.ts +510 -0
  271. package/src/server/operator.ts +498 -0
  272. package/src/server/providers.ts +284 -0
  273. package/src/server/relay.ts +1163 -0
  274. package/src/server/remove.ts +148 -0
  275. package/src/server/routing.ts +275 -0
  276. package/src/share/index.ts +110 -6
  277. package/src/verify/runner.ts +23 -2
  278. package/dist/directories-mJ1qlVht.js.map +0 -1
  279. package/dist/instance-EnaZPs14.js.map +0 -1
@@ -0,0 +1,191 @@
1
+ /**
2
+ * A hosted home's events for its operator (INTERFACES §18.6, D165 item 9): `submission.accepted`
3
+ * (with the submission's Results), `version.pushed` and `run.ended`, read from the home's own
4
+ * event log after `operator_cursor` and handed to the server's durable outbound queue, so each is
5
+ * delivered at least once with a stable ID (`<home>:<incarnation>:<cursor>`). The cursor moves
6
+ * only after the queue holds what was read; a crash between them hands the same events again,
7
+ * under the same IDs. Submissions are counted for metering on the same read. Each event carries
8
+ * its route's label beside its ID (D167).
9
+ *
10
+ * With neither an events nor a metering port, the cursor follows the head, so an operator added
11
+ * later starts from then rather than from the home's whole history.
12
+ */
13
+ import type { OperatorEvent } from "@mostra/protocol/operator";
14
+ import type { Interaction } from "../interaction/index.ts";
15
+ import type { Ledger } from "../ledger/index.ts";
16
+ import type { Log } from "../log.ts";
17
+ import type { Meter } from "./metering.ts";
18
+ import type { Operator } from "./operator.ts";
19
+
20
+ /** How many events one read takes. */
21
+ const PAGE = 200;
22
+
23
+ /** Options for {@link createOperatorFeed}. */
24
+ export interface OperatorFeedOptions {
25
+ readonly homeId: string;
26
+ readonly ledger: Ledger;
27
+ readonly interaction: Interaction;
28
+ readonly operator: Operator;
29
+ readonly meter: Meter;
30
+ readonly account: () => string;
31
+ readonly routeOf: (
32
+ artifactId: string,
33
+ ) => { readonly id: string; readonly label: string } | undefined;
34
+ readonly incarnation: () => string;
35
+ readonly log: Log;
36
+ }
37
+
38
+ /** The feed of one open hosted home. */
39
+ export interface OperatorFeed {
40
+ /** Reads what is new now (after every commit, and when the home opens). */
41
+ scan(): void;
42
+ stop(): void;
43
+ }
44
+
45
+ interface EventRow {
46
+ readonly cursor: number;
47
+ readonly artifact_id: string | null;
48
+ readonly type: string;
49
+ readonly payload_json: string;
50
+ readonly at: string;
51
+ }
52
+
53
+ const RUN_ENDS = new Map([
54
+ ["action.succeeded", "succeeded"],
55
+ ["action.failed", "failed"],
56
+ ["action.cancelled", "cancelled"],
57
+ ["action.unknown", "unknown"],
58
+ ]);
59
+
60
+ /** Starts the feed of a home. */
61
+ export function createOperatorFeed(options: OperatorFeedOptions): OperatorFeed {
62
+ const { ledger, operator, meter, log } = options;
63
+ const wanted = operator.has.events || meter.on;
64
+ let stopped = false;
65
+ let scheduled = false;
66
+
67
+ const cursorOf = (): number =>
68
+ ledger.read(
69
+ (db) =>
70
+ db.get<{ cursor: number }>("SELECT cursor FROM operator_cursor WHERE id = 1")?.cursor ?? -1,
71
+ );
72
+ /**
73
+ * Moves the cursor forward. It writes only when the cursor moves, since every write is a commit
74
+ * that schedules another read: a write that changed nothing would read again for ever.
75
+ */
76
+ const setCursor = (cursor: number): void => {
77
+ if (cursor <= cursorOf()) return;
78
+ ledger.write((db) =>
79
+ db.run(
80
+ `INSERT INTO operator_cursor (id, cursor) VALUES (1, ?)
81
+ ON CONFLICT (id) DO UPDATE SET cursor = MAX(cursor, excluded.cursor)`,
82
+ cursor,
83
+ ),
84
+ );
85
+ };
86
+ const head = (): number =>
87
+ ledger.read(
88
+ (db) => db.get<{ head: number | null }>("SELECT MAX(cursor) AS head FROM event")?.head ?? 0,
89
+ );
90
+
91
+ const toEvent = (row: EventRow): OperatorEvent | undefined => {
92
+ if (row.artifact_id === null) return undefined;
93
+ const route = options.routeOf(row.artifact_id);
94
+ if (!route) return undefined;
95
+ const payload = JSON.parse(row.payload_json) as Record<string, unknown>;
96
+ const base = {
97
+ eventId: `${options.homeId}:${options.incarnation()}:${row.cursor}`,
98
+ account: options.account(),
99
+ home: options.homeId,
100
+ routeId: route.id,
101
+ label: route.label,
102
+ artifactId: row.artifact_id,
103
+ at: row.at,
104
+ };
105
+ if (row.type === "submission.created") {
106
+ const results = options.interaction.resultsOf(String(payload["submissionId"]));
107
+ return results ? { ...base, kind: "submission.accepted", payload: results } : undefined;
108
+ }
109
+ if (row.type === "version.published") {
110
+ return {
111
+ ...base,
112
+ kind: "version.pushed",
113
+ payload: { versionId: payload["versionId"], number: payload["number"] },
114
+ };
115
+ }
116
+ const status = RUN_ENDS.get(row.type);
117
+ if (status !== undefined) {
118
+ return {
119
+ ...base,
120
+ kind: "run.ended",
121
+ payload: { runId: payload["runId"], action: payload["action"], status },
122
+ };
123
+ }
124
+ return undefined;
125
+ };
126
+
127
+ const scan = (): void => {
128
+ scheduled = false;
129
+ if (stopped) return;
130
+ try {
131
+ let cursor = cursorOf();
132
+ if (!wanted || cursor < 0) {
133
+ // No port reads the feed, or it starts now: from the head, never the whole history.
134
+ setCursor(Math.max(0, head()));
135
+ if (!wanted) return;
136
+ cursor = Math.max(0, cursorOf());
137
+ }
138
+ for (;;) {
139
+ const rows = ledger.read((db) =>
140
+ db.all<EventRow>(
141
+ `SELECT cursor, artifact_id, type, payload_json, at FROM event WHERE cursor > ?
142
+ AND type IN ('submission.created', 'version.published', 'action.succeeded',
143
+ 'action.failed', 'action.cancelled', 'action.unknown')
144
+ ORDER BY cursor LIMIT ?`,
145
+ cursor,
146
+ PAGE,
147
+ ),
148
+ );
149
+ for (const row of rows) {
150
+ const event = toEvent(row);
151
+ if (!event) continue;
152
+ if (event.kind === "submission.accepted") {
153
+ meter.add("submissions", {
154
+ account: event.account,
155
+ home: event.home,
156
+ artifactId: event.artifactId,
157
+ routeId: event.routeId,
158
+ });
159
+ }
160
+ if (operator.has.events) operator.enqueue({ port: "events", event });
161
+ }
162
+ // Up to the last event read, or the head when nothing matched past the cursor.
163
+ const last = rows.at(-1)?.cursor;
164
+ if (last === undefined) {
165
+ setCursor(Math.max(cursor, head()));
166
+ return;
167
+ }
168
+ setCursor(last);
169
+ cursor = last;
170
+ if (rows.length < PAGE) return;
171
+ }
172
+ } catch (error) {
173
+ log.warn("operator.feed_failed", { home: options.homeId, error });
174
+ }
175
+ };
176
+
177
+ const unsubscribe = ledger.onCommit(() => {
178
+ if (scheduled || stopped) return;
179
+ scheduled = true;
180
+ setImmediate(scan);
181
+ });
182
+ scan();
183
+
184
+ return {
185
+ scan,
186
+ stop() {
187
+ stopped = true;
188
+ unsubscribe();
189
+ },
190
+ };
191
+ }
@@ -0,0 +1,172 @@
1
+ /**
2
+ * The server handle an operator module receives (INTERFACES §18.6, D165 item 9): quarantine,
3
+ * pause, suspension, link revocation, moving and restoring homes, and deletion. Every target names
4
+ * a hosted route (`rte_…`), never a bare artifact or version ID, since those repeat across homes
5
+ * when a project is copied: acting on one route never touches another home hosting the same
6
+ * artifact ID or an identical version. Each call is durable when it resolves.
7
+ */
8
+ import { createDiagnostic, RpcError } from "@mostra/protocol";
9
+ import { OPERATOR_REVISION, type ServerHandle } from "@mostra/protocol/operator";
10
+ import type { Ledger } from "../ledger/index.ts";
11
+ import type { Log } from "../log.ts";
12
+ import type { DataDirectory } from "./data.ts";
13
+ import type { HostedHome } from "./hosted.ts";
14
+
15
+ /** Options for {@link createHandle}. */
16
+ export interface HandleOptions {
17
+ readonly apiOrigin: string;
18
+ /** The data directory; set once it is open (the handle is made before the operator loads). */
19
+ readonly data: () => DataDirectory<HostedHome>;
20
+ readonly directory: () => Ledger;
21
+ /** Closes the bindings of a suspended home at once (the API origin's). */
22
+ readonly suspended: (homeId: string) => void;
23
+ readonly log: Log;
24
+ }
25
+
26
+ function unknownTarget(message: string): RpcError {
27
+ return new RpcError(createDiagnostic("MOSTRA_HOST_INVALID_PARAMS", { message }));
28
+ }
29
+
30
+ /** Builds the handle. */
31
+ export function createHandle(options: HandleOptions): ServerHandle {
32
+ const { log } = options;
33
+
34
+ /** A route's home and artifact; an unknown route is refused, never guessed. */
35
+ const route = (routeId: string): { readonly home: string; readonly artifactId: string } => {
36
+ const row = options
37
+ .directory()
38
+ .read((db) =>
39
+ db.get<{ home_id: string; artifact_id: string }>(
40
+ "SELECT home_id, artifact_id FROM artifact_route WHERE id = ?",
41
+ routeId,
42
+ ),
43
+ );
44
+ if (!row) throw unknownTarget(`No hosted route ${routeId}.`);
45
+ return { home: row.home_id, artifactId: row.artifact_id };
46
+ };
47
+
48
+ const homeOf = async (homeId: string): Promise<HostedHome> =>
49
+ (await options.data().home(homeId)).assembled;
50
+
51
+ const knownHome = (homeId: string): void => {
52
+ const found = options
53
+ .directory()
54
+ .read((db) => db.get("SELECT 1 FROM home WHERE id = ?", homeId));
55
+ if (!found) throw unknownTarget(`No hosted home ${homeId}.`);
56
+ };
57
+
58
+ return {
59
+ revision: OPERATOR_REVISION,
60
+ apiOrigin: options.apiOrigin,
61
+
62
+ async quarantine(target, reason) {
63
+ const found = route(target.routeId);
64
+ const home = await homeOf(found.home);
65
+ home.quarantine(
66
+ found.artifactId,
67
+ "versionId" in target ? target.versionId : undefined,
68
+ reason,
69
+ );
70
+ log.info("operator.quarantine", { routeId: target.routeId });
71
+ },
72
+
73
+ async release(target) {
74
+ const found = route(target.routeId);
75
+ const home = await homeOf(found.home);
76
+ home.release(found.artifactId, "versionId" in target ? target.versionId : undefined);
77
+ log.info("operator.release", { routeId: target.routeId });
78
+ },
79
+
80
+ async pause(routeId, reason) {
81
+ const found = route(routeId);
82
+ (await homeOf(found.home)).pause(found.artifactId, { paused: true, by: "operator", reason });
83
+ log.info("operator.pause", { routeId });
84
+ },
85
+
86
+ async resume(routeId) {
87
+ const found = route(routeId);
88
+ (await homeOf(found.home)).pause(found.artifactId, { paused: false, by: "operator" });
89
+ log.info("operator.resume", { routeId });
90
+ },
91
+
92
+ async suspendHome(homeId, reason) {
93
+ knownHome(homeId);
94
+ options
95
+ .directory()
96
+ .write((db) =>
97
+ db.run(
98
+ "UPDATE home SET suspended_at = COALESCE(suspended_at, ?), suspend_reason = ? WHERE id = ?",
99
+ new Date().toISOString(),
100
+ reason.slice(0, 1_000),
101
+ homeId,
102
+ ),
103
+ );
104
+ options.suspended(homeId);
105
+ await options.data().closeHome(homeId);
106
+ log.info("operator.suspend_home", { home: homeId });
107
+ },
108
+
109
+ async resumeHome(homeId) {
110
+ knownHome(homeId);
111
+ options
112
+ .directory()
113
+ .write((db) =>
114
+ db.run("UPDATE home SET suspended_at = NULL, suspend_reason = NULL WHERE id = ?", homeId),
115
+ );
116
+ log.info("operator.resume_home", { home: homeId });
117
+ },
118
+
119
+ async revokeLinks(routeId) {
120
+ const found = route(routeId);
121
+ const count = (await homeOf(found.home)).revokeLinks(found.artifactId);
122
+ log.info("operator.revoke_links", { routeId, count });
123
+ return count;
124
+ },
125
+
126
+ async revokeLink(tokenId) {
127
+ const row = options
128
+ .directory()
129
+ .read((db) =>
130
+ db.get<{ home_id: string }>(
131
+ "SELECT home_id FROM hosted_token WHERE token_id = ?",
132
+ tokenId,
133
+ ),
134
+ );
135
+ if (!row) throw unknownTarget(`No hosted link ${tokenId}.`);
136
+ if (!(await homeOf(row.home_id)).revokeLink(tokenId)) {
137
+ throw unknownTarget(`No hosted link ${tokenId}.`);
138
+ }
139
+ log.info("operator.revoke_link", { tokenId });
140
+ },
141
+
142
+ async drainHome(homeId) {
143
+ knownHome(homeId);
144
+ options.suspended(homeId);
145
+ await options.data().drain(homeId);
146
+ },
147
+
148
+ async releaseHome(homeId) {
149
+ knownHome(homeId);
150
+ options.data().undrain(homeId);
151
+ },
152
+
153
+ async restored(homeId) {
154
+ knownHome(homeId);
155
+ await options.data().restored(homeId);
156
+ log.info("operator.restored", { home: homeId });
157
+ },
158
+
159
+ async remove(routeId) {
160
+ const found = route(routeId);
161
+ const home = await homeOf(found.home);
162
+ try {
163
+ await home.remove(found.artifactId);
164
+ } finally {
165
+ // The home reopens from its ledger on its next request, holding nothing of the artifact,
166
+ // and nothing a removal cut off part-way left open in it (second Fable review, 8).
167
+ await options.data().closeHome(found.home);
168
+ }
169
+ log.info("operator.remove", { routeId });
170
+ },
171
+ };
172
+ }