@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,498 @@
1
+ /**
2
+ * The remote server's operator boundary at run time (ARCHITECTURE §15.10, INTERFACES §18.6, D165
3
+ * items 9, 11): the operator module a configuration names, loaded in process, and every call into
4
+ * it. Each call has its time limit and its answer is checked against `@mostra/protocol/operator`'s
5
+ * schemas; a call that throws, times out or answers what the schema refuses counts as no answer,
6
+ * and each port's caller says what no answer means (`limits`: operations that create fail closed,
7
+ * viewer input proceeds; `routing`: nothing is served; `policy`: nothing is added). Outbound
8
+ * deliveries (`metering`, `events`) are kept in the directory's `outbound` table and retried with
9
+ * backoff until the operator takes them, at least once and idempotent by their IDs, across
10
+ * restarts.
11
+ *
12
+ * Without an operator module every port is its no-op default, and this module does nothing but
13
+ * answer "allowed".
14
+ */
15
+ import { pathToFileURL } from "node:url";
16
+ import { createDiagnostic, RpcError } from "@mostra/protocol";
17
+ import {
18
+ AccountResolution,
19
+ AuthenticatedCredential,
20
+ type ChatHostPolicy,
21
+ ChatHostPolicy as ChatHostPolicySchema,
22
+ type CredentialResource,
23
+ type IdentityProvider,
24
+ LimitAnswer,
25
+ type LimitQuery,
26
+ LinkHost,
27
+ LinkPolicy,
28
+ type LinkQuery,
29
+ type MeterBatch,
30
+ OPERATOR_TIME_LIMITS,
31
+ type OperatorEvent,
32
+ type OperatorPorts,
33
+ PushedAnswer,
34
+ type PushedVersion,
35
+ RoutingAnswer,
36
+ type ServerHandle,
37
+ type SignInIdentity,
38
+ } from "@mostra/protocol/operator";
39
+ import type * as z from "zod";
40
+ import type { Ledger } from "../ledger/index.ts";
41
+ import type { Log } from "../log.ts";
42
+
43
+ /** What `limits` decided: allowed, refused with the operator's words, or no answer in time. */
44
+ export type LimitVerdict =
45
+ | { readonly allowed: true }
46
+ | {
47
+ readonly allowed: false;
48
+ readonly code: string;
49
+ readonly message: string;
50
+ readonly retryAfterMs?: number;
51
+ }
52
+ | { readonly allowed: "unavailable" };
53
+
54
+ /** What `accounts.resolve` decided, or that the server's own accounts decide (no port). */
55
+ export type ResolveVerdict = AccountResolution | { readonly default: true } | "unavailable";
56
+
57
+ /** The operator module at run time. */
58
+ export interface Operator {
59
+ /** Which ports the module implements. */
60
+ readonly has: {
61
+ readonly limits: boolean;
62
+ readonly metering: boolean;
63
+ readonly accounts: boolean;
64
+ readonly authenticate: boolean;
65
+ readonly status: boolean;
66
+ readonly abuse: boolean;
67
+ readonly pushed: boolean;
68
+ readonly policy: boolean;
69
+ readonly routing: boolean;
70
+ readonly linkHost: boolean;
71
+ readonly events: boolean;
72
+ readonly identity: boolean;
73
+ };
74
+ limit(q: LimitQuery): Promise<LimitVerdict>;
75
+ linkPolicy(q: LinkQuery): Promise<LinkPolicy>;
76
+ chatHost(client: { name: string; redirectHost?: string }): Promise<ChatHostPolicy | null>;
77
+ /** The operator's answer for a host the server doesn't serve itself, or `unavailable`. */
78
+ route(host: string): Promise<RoutingAnswer | "unavailable">;
79
+ /** The shell host a new link of a route is minted on; `null` for the active domain. */
80
+ linkHost(q: { account: string; home: string; routeId: string }): Promise<string | null>;
81
+ /** The identity providers the module supplies now (none on failure). */
82
+ providers(): Promise<readonly IdentityProvider[]>;
83
+ resolve(identity: SignInIdentity, steps: number): Promise<ResolveVerdict>;
84
+ /** An operator-issued credential, or `null` (unknown, refused, or no answer). */
85
+ authenticate(
86
+ bearer: string,
87
+ resource: CredentialResource,
88
+ ): Promise<z.infer<typeof AuthenticatedCredential>>;
89
+ /** An account's status as the operator says, or `undefined` with no answer. */
90
+ status(account: string): Promise<"active" | "suspended" | undefined>;
91
+ report(r: Parameters<NonNullable<OperatorPorts["abuse"]>["report"]>[0]): Promise<void>;
92
+ /** The after-push hook: never blocks serving; its answer may quarantine the version after. */
93
+ pushed(v: PushedVersion, quarantine: (reason: string) => Promise<void>): void;
94
+ /** Keeps an outbound delivery durably, to deliver at least once (INTERFACES §18.6). */
95
+ enqueue(
96
+ item:
97
+ | { readonly port: "events"; readonly event: OperatorEvent }
98
+ | { readonly port: "metering"; readonly batch: MeterBatch },
99
+ ): void;
100
+ /** Delivers what waits now (tests; the dispatcher does it on its own). */
101
+ flush(): Promise<void>;
102
+ stop(): void;
103
+ }
104
+
105
+ /** Options for {@link loadOperator}. */
106
+ export interface OperatorOptions {
107
+ /** The module's path (`operator` in the configuration), or `undefined` for none. */
108
+ readonly path: string | undefined;
109
+ readonly handle: ServerHandle;
110
+ readonly directory: Ledger;
111
+ readonly log: Log;
112
+ readonly now?: () => number;
113
+ /** How often the outbound dispatcher looks for work; tests shorten it. */
114
+ readonly dispatchMs?: number;
115
+ }
116
+
117
+ function configInvalid(message: string): RpcError {
118
+ return new RpcError(createDiagnostic("MOSTRA_REMOTE_CONFIG_INVALID", { message }));
119
+ }
120
+
121
+ class Timeout extends Error {}
122
+
123
+ /** Races a call against its time limit. */
124
+ async function within<T>(limitMs: number, call: () => T | Promise<T>): Promise<T> {
125
+ let timer: NodeJS.Timeout | undefined;
126
+ try {
127
+ return await Promise.race([
128
+ Promise.resolve().then(call),
129
+ new Promise<never>((_, reject) => {
130
+ timer = setTimeout(() => reject(new Timeout(`no answer within ${limitMs} ms`)), limitMs);
131
+ timer.unref();
132
+ }),
133
+ ]);
134
+ } finally {
135
+ if (timer) clearTimeout(timer);
136
+ }
137
+ }
138
+
139
+ /** The longest an outbound delivery waits between attempts. */
140
+ const OUTBOUND_MAX_BACKOFF_MS = 5 * 60_000;
141
+
142
+ /**
143
+ * Loads the operator module a configuration names and starts its outbound dispatcher. A module
144
+ * that can't be loaded, or whose default export isn't a function, stops the server before it
145
+ * serves anything (`MOSTRA_REMOTE_CONFIG_INVALID`, naming `operator`).
146
+ */
147
+ export async function loadOperator(options: OperatorOptions): Promise<Operator> {
148
+ const { log, directory } = options;
149
+ const now = options.now ?? (() => Date.now());
150
+ let ports: OperatorPorts = {};
151
+ if (options.path !== undefined) {
152
+ let loaded: { default?: unknown };
153
+ try {
154
+ loaded = (await import(pathToFileURL(options.path).href)) as { default?: unknown };
155
+ } catch (error) {
156
+ throw configInvalid(
157
+ `The configuration key \`operator\` names a module that can't be loaded: ${(error as Error).message}.`,
158
+ );
159
+ }
160
+ if (typeof loaded.default !== "function") {
161
+ throw configInvalid(
162
+ "The configuration key `operator` names a module whose default export isn't a function of the server's handle.",
163
+ );
164
+ }
165
+ try {
166
+ ports = ((await (loaded.default as (server: ServerHandle) => unknown)(options.handle)) ??
167
+ {}) as OperatorPorts;
168
+ } catch (error) {
169
+ throw configInvalid(
170
+ `The operator module's default export failed: ${(error as Error).message}.`,
171
+ );
172
+ }
173
+ if (typeof ports !== "object") {
174
+ throw configInvalid("The operator module's default export didn't return its ports.");
175
+ }
176
+ log.info("operator.loaded", {
177
+ ports: Object.keys(ports).filter((key) => (ports as Record<string, unknown>)[key]),
178
+ });
179
+ }
180
+
181
+ /** One call into the module: time-limited, its answer checked; `undefined` for no answer. */
182
+ const ask = async <T>(
183
+ port: string,
184
+ limitMs: number,
185
+ schema: z.ZodType<T>,
186
+ call: () => unknown,
187
+ ): Promise<{ readonly value: T } | undefined> => {
188
+ try {
189
+ const answer = await within(limitMs, call);
190
+ const checked = schema.safeParse(answer);
191
+ if (!checked.success) {
192
+ log.warn("operator.answer_refused", {
193
+ port,
194
+ issue: checked.error.issues[0]?.message ?? "invalid",
195
+ });
196
+ return undefined;
197
+ }
198
+ return { value: checked.data };
199
+ } catch (error) {
200
+ log.warn("operator.no_answer", {
201
+ port,
202
+ why: error instanceof Timeout ? "timeout" : "error",
203
+ message: (error as Error).message,
204
+ });
205
+ return undefined;
206
+ }
207
+ };
208
+
209
+ /** Answers the operator allowed to keep, by key, until their time. */
210
+ const cache = new Map<string, { readonly value: unknown; readonly until: number }>();
211
+ const cached = <T>(key: string): T | undefined => {
212
+ const hit = cache.get(key);
213
+ if (!hit) return undefined;
214
+ if (hit.until <= now()) {
215
+ cache.delete(key);
216
+ return undefined;
217
+ }
218
+ return hit.value as T;
219
+ };
220
+ const keep = (key: string, value: unknown, forMs: number | undefined): void => {
221
+ if (forMs === undefined || forMs <= 0) return;
222
+ if (cache.size >= 10_000) cache.delete(cache.keys().next().value as string);
223
+ cache.set(key, { value, until: now() + forMs });
224
+ };
225
+
226
+ // ── outbound ────────────────────────────────────────────────────────────────────────────
227
+
228
+ let dispatching: Promise<void> | undefined;
229
+ const deliverOne = async (row: {
230
+ id: string;
231
+ port: string;
232
+ payload_json: string;
233
+ attempts: number;
234
+ }): Promise<void> => {
235
+ const payload = JSON.parse(row.payload_json) as unknown;
236
+ try {
237
+ await within(OPERATOR_TIME_LIMITS.outbound, () =>
238
+ row.port === "events"
239
+ ? ports.events?.deliver(payload as OperatorEvent)
240
+ : ports.metering?.record(payload as MeterBatch),
241
+ );
242
+ directory.write((db) => db.run("DELETE FROM outbound WHERE id = ?", row.id));
243
+ } catch (error) {
244
+ const delay = Math.min(OUTBOUND_MAX_BACKOFF_MS, 1_000 * 2 ** Math.min(row.attempts, 20));
245
+ directory.write((db) =>
246
+ db.run(
247
+ "UPDATE outbound SET attempts = attempts + 1, next_attempt_at = ? WHERE id = ?",
248
+ new Date(now() + delay).toISOString(),
249
+ row.id,
250
+ ),
251
+ );
252
+ log.warn("operator.outbound_failed", {
253
+ port: row.port,
254
+ attempts: row.attempts + 1,
255
+ message: (error as Error).message,
256
+ });
257
+ }
258
+ };
259
+ const dispatch = (): Promise<void> => {
260
+ dispatching ??= (async () => {
261
+ // Yield first: a turn that found nothing would otherwise end, and clear `dispatching`,
262
+ // before `??=` stored it, leaving a finished turn registered for ever (WP-29 met the same).
263
+ await Promise.resolve();
264
+ try {
265
+ for (;;) {
266
+ // The oldest rows of each port, due or not: a port whose oldest delivery waits for its
267
+ // retry waits whole, so an operator sees a home's events in the order they happened.
268
+ const rows = directory.read((db) =>
269
+ (["events", "metering"] as const).flatMap((port) =>
270
+ db.all<{
271
+ id: string;
272
+ port: string;
273
+ payload_json: string;
274
+ attempts: number;
275
+ next_attempt_at: string;
276
+ }>(
277
+ "SELECT id, port, payload_json, attempts, next_attempt_at FROM outbound WHERE port = ? ORDER BY rowid LIMIT 50",
278
+ port,
279
+ ),
280
+ ),
281
+ );
282
+ const due = new Date(now()).toISOString();
283
+ if (rows.every((row) => row.next_attempt_at > due)) return;
284
+ const blocked = new Set<string>();
285
+ let delivered = 0;
286
+ for (const row of rows) {
287
+ if (blocked.has(row.port)) continue;
288
+ if (row.next_attempt_at > due) {
289
+ blocked.add(row.port);
290
+ continue;
291
+ }
292
+ const before = row.attempts;
293
+ await deliverOne(row);
294
+ const still = directory.read((db) =>
295
+ db.get<{ attempts: number }>("SELECT attempts FROM outbound WHERE id = ?", row.id),
296
+ );
297
+ if (still && still.attempts > before) blocked.add(row.port);
298
+ else delivered += 1;
299
+ }
300
+ if (delivered === 0) return;
301
+ }
302
+ } finally {
303
+ dispatching = undefined;
304
+ }
305
+ })();
306
+ return dispatching;
307
+ };
308
+ const timer =
309
+ ports.events || ports.metering
310
+ ? setInterval(() => void dispatch(), options.dispatchMs ?? 1_000)
311
+ : undefined;
312
+ timer?.unref();
313
+
314
+ const has = {
315
+ limits: typeof ports.limits?.check === "function",
316
+ metering: typeof ports.metering?.record === "function",
317
+ accounts: typeof ports.accounts?.resolve === "function",
318
+ authenticate: typeof ports.accounts?.authenticate === "function",
319
+ status: typeof ports.accounts?.status === "function",
320
+ abuse: typeof ports.abuse?.report === "function",
321
+ pushed: typeof ports.abuse?.pushed === "function",
322
+ policy: typeof ports.policy?.link === "function",
323
+ routing: typeof ports.routing?.resolve === "function",
324
+ linkHost: typeof ports.routing?.linkHost === "function",
325
+ events: typeof ports.events?.deliver === "function",
326
+ identity: typeof ports.identity?.providers === "function",
327
+ };
328
+
329
+ return {
330
+ has,
331
+
332
+ async limit(q) {
333
+ if (!has.limits) return { allowed: true };
334
+ const key = `limits\u0000${JSON.stringify(q)}`;
335
+ const hit = cached<LimitVerdict>(key);
336
+ if (hit) return hit;
337
+ const answer = await ask("limits", OPERATOR_TIME_LIMITS.limits, LimitAnswer, () =>
338
+ ports.limits?.check(q),
339
+ );
340
+ if (!answer) return { allowed: "unavailable" };
341
+ const verdict: LimitVerdict = answer.value.allowed
342
+ ? { allowed: true }
343
+ : {
344
+ allowed: false,
345
+ code: answer.value.code,
346
+ message: answer.value.message,
347
+ ...(answer.value.retryAfterMs !== undefined
348
+ ? { retryAfterMs: answer.value.retryAfterMs }
349
+ : {}),
350
+ };
351
+ keep(key, verdict, answer.value.cacheForMs);
352
+ return verdict;
353
+ },
354
+
355
+ async linkPolicy(q) {
356
+ if (!has.policy) return {};
357
+ const key = `policy\u0000${q.routeId}\u0000${q.tokenId ?? ""}`;
358
+ const hit = cached<LinkPolicy>(key);
359
+ if (hit) return hit;
360
+ const answer = await ask("policy", OPERATOR_TIME_LIMITS.policy, LinkPolicy, () =>
361
+ ports.policy?.link(q),
362
+ );
363
+ if (!answer) return {};
364
+ keep(key, answer.value, answer.value.cacheForMs);
365
+ return answer.value;
366
+ },
367
+
368
+ async chatHost(client) {
369
+ if (typeof ports.policy?.chatHost !== "function") return null;
370
+ const answer = await ask(
371
+ "policy.chatHost",
372
+ OPERATOR_TIME_LIMITS.policy,
373
+ ChatHostPolicySchema.nullable(),
374
+ () => ports.policy?.chatHost?.(client),
375
+ );
376
+ return answer?.value ?? null;
377
+ },
378
+
379
+ async route(host) {
380
+ if (!has.routing) return null;
381
+ const key = `routing\u0000${host}`;
382
+ const hit = cache.get(key);
383
+ if (hit && hit.until > now()) return hit.value as RoutingAnswer;
384
+ const answer = await ask("routing", OPERATOR_TIME_LIMITS.routing, RoutingAnswer, () =>
385
+ ports.routing?.resolve(host),
386
+ );
387
+ if (!answer) return "unavailable";
388
+ keep(key, answer.value, answer.value?.cacheForMs);
389
+ return answer.value;
390
+ },
391
+
392
+ async linkHost(q) {
393
+ if (!has.linkHost) return null;
394
+ const answer = await ask("routing.linkHost", OPERATOR_TIME_LIMITS.routing, LinkHost, () =>
395
+ ports.routing?.linkHost?.(q),
396
+ );
397
+ return answer?.value ?? null;
398
+ },
399
+
400
+ async providers() {
401
+ if (!has.identity) return [];
402
+ try {
403
+ const found = await within(OPERATOR_TIME_LIMITS.identity, () =>
404
+ ports.identity?.providers(),
405
+ );
406
+ return (Array.isArray(found) ? found : []).filter(
407
+ (provider: IdentityProvider) =>
408
+ typeof provider?.id === "string" &&
409
+ /^[a-z][a-z0-9-]{0,31}$/.test(provider.id) &&
410
+ typeof provider.authorize === "function" &&
411
+ typeof provider.callback === "function",
412
+ );
413
+ } catch (error) {
414
+ log.warn("operator.no_answer", { port: "identity", message: (error as Error).message });
415
+ return [];
416
+ }
417
+ },
418
+
419
+ async resolve(identity, steps) {
420
+ if (!has.accounts) return { default: true };
421
+ const answer = await ask(
422
+ "accounts.resolve",
423
+ OPERATOR_TIME_LIMITS.accounts,
424
+ AccountResolution,
425
+ () => ports.accounts?.resolve(identity, { steps }),
426
+ );
427
+ return answer ? answer.value : "unavailable";
428
+ },
429
+
430
+ async authenticate(bearer, resource) {
431
+ if (!has.authenticate) return null;
432
+ const answer = await ask(
433
+ "accounts.authenticate",
434
+ OPERATOR_TIME_LIMITS.authenticate,
435
+ AuthenticatedCredential,
436
+ () => ports.accounts?.authenticate?.(bearer, { resource }),
437
+ );
438
+ return answer?.value ?? null;
439
+ },
440
+
441
+ async status(account) {
442
+ if (typeof ports.accounts?.status !== "function") return undefined;
443
+ try {
444
+ const found = await within(OPERATOR_TIME_LIMITS.accounts, () =>
445
+ ports.accounts?.status?.(account),
446
+ );
447
+ return found === "active" || found === "suspended" ? found : undefined;
448
+ } catch {
449
+ return undefined;
450
+ }
451
+ },
452
+
453
+ async report(r) {
454
+ if (!has.abuse) return;
455
+ try {
456
+ await within(OPERATOR_TIME_LIMITS.policy * 5, () => ports.abuse?.report(r));
457
+ } catch (error) {
458
+ log.warn("operator.no_answer", { port: "abuse.report", message: (error as Error).message });
459
+ }
460
+ },
461
+
462
+ pushed(v, quarantine) {
463
+ if (!has.pushed) return;
464
+ void ask("abuse.pushed", OPERATOR_TIME_LIMITS.pushed, PushedAnswer, () =>
465
+ ports.abuse?.pushed?.(v),
466
+ ).then(async (answer) => {
467
+ const reason = answer?.value?.quarantine?.reason;
468
+ if (reason !== undefined) {
469
+ await quarantine(reason).catch((error: unknown) =>
470
+ log.error("operator.quarantine_failed", { error }),
471
+ );
472
+ }
473
+ });
474
+ },
475
+
476
+ enqueue(item) {
477
+ if (item.port === "events" ? !has.events : !has.metering) return;
478
+ const id = item.port === "events" ? item.event.eventId : item.batch.batchId;
479
+ const payload = item.port === "events" ? item.event : item.batch;
480
+ directory.write((db) =>
481
+ db.run(
482
+ "INSERT OR IGNORE INTO outbound (id, port, payload_json, attempts, next_attempt_at) VALUES (?, ?, ?, 0, ?)",
483
+ `${item.port}:${id}`,
484
+ item.port,
485
+ JSON.stringify(payload),
486
+ new Date(now()).toISOString(),
487
+ ),
488
+ );
489
+ void dispatch();
490
+ },
491
+
492
+ flush: () => dispatch(),
493
+
494
+ stop() {
495
+ if (timer) clearInterval(timer);
496
+ },
497
+ };
498
+ }