@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
package/src/bin.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { mkdirSync } from "node:fs";
3
+ import { join } from "node:path";
3
4
  import { fileURLToPath } from "node:url";
4
5
  /**
5
6
  * `mostra-runtime`, the runtime bundle's entry point (D85).
@@ -33,7 +34,10 @@ import {
33
34
  } from "@mostra/protocol";
34
35
  import { checkPlatform, resolveHomePath } from "./home/index.ts";
35
36
  import { type Instance, runtimeVersion, startInstance } from "./instance/index.ts";
36
- import { realPath } from "./platform/index.ts";
37
+ import { openFileLog } from "./log.ts";
38
+ import { readProcess, realPath } from "./platform/index.ts";
39
+
40
+ import { readServerConfig, startServer } from "./server/index.ts";
37
41
  import { installService, serviceStatus, uninstallService } from "./service/index.ts";
38
42
 
39
43
  /** Exit codes, as INTERFACES §9 defines them for the CLI. */
@@ -42,6 +46,7 @@ const EXIT = { ok: 0, failure: 1, usage: 2, environment: 3 } as const;
42
46
  const USAGE = [
43
47
  "usage: mostra-runtime <host|daemon> [--home <dir>] [--bind <address> [--url-host <name>]] [--always-on]",
44
48
  " mostra-runtime service <install|uninstall|status> [--home <dir>] [--no-start]",
49
+ " mostra-runtime server --data <dir> [--config <file>] [--listen <host:port>] [--restored <homeId|all>]",
45
50
  ].join("\n");
46
51
 
47
52
  // A closed stdout or stderr (a starter that read the ready line and left) must not crash the
@@ -135,6 +140,14 @@ async function main(argv: readonly string[]): Promise<number> {
135
140
  const [mode, ...rest] = positionals;
136
141
  if (mode === "service" && !values.help)
137
142
  return await service(rest, values.home, values["no-start"] === true);
143
+ if (mode === "server" && !values.help && rest.length === 0) {
144
+ return await remoteServer({
145
+ data: values.data,
146
+ config: values.config,
147
+ listen: values.listen,
148
+ restored: values.restored ?? [],
149
+ });
150
+ }
138
151
  if (values.help || (mode !== "host" && mode !== "daemon") || rest.length > 0) {
139
152
  (values.help ? process.stdout : process.stderr).write(`${USAGE}\n`);
140
153
  return values.help ? EXIT.ok : EXIT.usage;
@@ -190,6 +203,66 @@ async function main(argv: readonly string[]): Promise<number> {
190
203
  }
191
204
  }
192
205
 
206
+ /**
207
+ * `mostra-runtime server`: the remote server (INTERFACES §18.1). Prints one JSON line on stdout
208
+ * (`{"status":"started","address",…}` or `{"status":"failed","diagnostic"}` with exit 3), then
209
+ * serves until SIGTERM, SIGINT or Ctrl+Break, and stops cleanly: every hosted home is closed and
210
+ * every lock released. Logs go to the data directory's `logs/`.
211
+ */
212
+ async function remoteServer(args: {
213
+ readonly data: string | undefined;
214
+ readonly config: string | undefined;
215
+ readonly listen: string | undefined;
216
+ readonly restored: readonly string[];
217
+ }): Promise<number> {
218
+ if (args.data === undefined) {
219
+ process.stderr.write(`mostra-runtime server needs --data <dir>.\n${USAGE}\n`);
220
+ return EXIT.usage;
221
+ }
222
+ try {
223
+ checkPlatform();
224
+ mkdirSync(args.data, { recursive: true, mode: 0o700 });
225
+ const data = realPath(args.data);
226
+ const config = readServerConfig(args.config, process.env);
227
+ const me = await readProcess(process.pid);
228
+ if (!me) throw new Error("Couldn't read this process's own start time.");
229
+ const log = openFileLog({ dir: join(data, "logs"), mirror });
230
+ const server = await startServer({
231
+ data,
232
+ config,
233
+ ...(args.listen !== undefined ? { listen: args.listen } : {}),
234
+ restored: args.restored,
235
+ runtimeVersion: runtimeVersion(),
236
+ owner: { pid: me.pid, startTime: me.startTime },
237
+ log,
238
+ env: process.env,
239
+ });
240
+ process.stdout.write(
241
+ `${JSON.stringify({ status: "started", pid: process.pid, address: server.address, data })}\n`,
242
+ );
243
+ return await new Promise<number>((resolve) => {
244
+ let stopping = false;
245
+ const stop = (): void => {
246
+ if (stopping) return;
247
+ stopping = true;
248
+ void server.close().then(
249
+ () => resolve(EXIT.ok),
250
+ (error: unknown) => {
251
+ log.error("server.stop_failed", { error });
252
+ resolve(EXIT.failure);
253
+ },
254
+ );
255
+ };
256
+ for (const signal of ["SIGTERM", "SIGINT", "SIGBREAK"] as const) process.on(signal, stop);
257
+ });
258
+ } catch (error) {
259
+ const diagnostic = diagnosticOf(error);
260
+ process.stdout.write(`${JSON.stringify({ status: "failed", diagnostic })}\n`);
261
+ mirror(`${JSON.stringify({ level: "error", diagnostic })}\n`);
262
+ return error instanceof RpcError ? EXIT.environment : EXIT.failure;
263
+ }
264
+ }
265
+
193
266
  /** `mostra-runtime service …`: the home's login service, as one JSON line (D62, RT-08). */
194
267
  async function service(
195
268
  args: readonly string[],
@@ -244,6 +317,10 @@ function parse(argv: readonly string[]) {
244
317
  "no-start": { type: "boolean" },
245
318
  help: { type: "boolean", short: "h" },
246
319
  version: { type: "boolean" },
320
+ data: { type: "string" },
321
+ config: { type: "string" },
322
+ listen: { type: "string" },
323
+ restored: { type: "string", multiple: true },
247
324
  },
248
325
  });
249
326
  }
@@ -10,6 +10,7 @@
10
10
  import {
11
11
  CallRequest,
12
12
  type CapabilityScope,
13
+ createDiagnostic,
13
14
  type Diagnostic,
14
15
  LiveRequest,
15
16
  RpcError,
@@ -45,6 +46,12 @@ const STATUS: Readonly<Record<string, number>> = {
45
46
  MOSTRA_VERIFY_ACTION_SKIPPED: 409,
46
47
  MOSTRA_HOME_DISK_FULL: 507,
47
48
  MOSTRA_HOME_GONE: 503,
49
+ // A hosted page's relay (D165 item 4, INTERFACES §4).
50
+ MOSTRA_REMOTE_OWNER_OFFLINE: 503,
51
+ MOSTRA_REMOTE_QUEUE_FULL: 503,
52
+ MOSTRA_REMOTE_SIGN_IN_REQUIRED: 403,
53
+ MOSTRA_REMOTE_RATE_LIMITED: 429,
54
+ MOSTRA_ACTION_PAUSED: 423,
48
55
  };
49
56
 
50
57
  type Handler = (context: RouteContext) => Response | Promise<Response>;
@@ -61,8 +68,8 @@ export interface ActionRoutes {
61
68
  /** Options for {@link actionRoutes}. */
62
69
  export interface ActionRoutesOptions {
63
70
  readonly interaction: Interaction;
64
- readonly actions: Actions;
65
- readonly live: Live;
71
+ readonly actions: Pick<Actions, "call" | "startRun" | "attach" | "cancel">;
72
+ readonly live: Pick<Live, "read">;
66
73
  readonly log: Log;
67
74
  /** The browser-protocol revisions served. */
68
75
  readonly revisions: readonly string[];
@@ -73,8 +80,18 @@ function answer(diagnostic: Diagnostic, status: number): Response {
73
80
  }
74
81
 
75
82
  function failure(error: unknown): Response {
76
- if (error instanceof RpcError)
77
- return answer(error.diagnostic, STATUS[error.diagnostic.code] ?? 500);
83
+ if (error instanceof RpcError) {
84
+ const status = STATUS[error.diagnostic.code] ?? 500;
85
+ // A refusal that says when to try again (a rate limit) says so in `Retry-After` too.
86
+ const retryAfter = (error as { retryAfter?: unknown }).retryAfter;
87
+ if (typeof retryAfter === "number") {
88
+ return jsonResponse(
89
+ { ...error.diagnostic },
90
+ { status, headers: { "retry-after": String(retryAfter) } },
91
+ );
92
+ }
93
+ return answer(error.diagnostic, status);
94
+ }
78
95
  throw error;
79
96
  }
80
97
 
@@ -136,6 +153,21 @@ export function actionRoutes(options: ActionRoutesOptions): ActionRoutes {
136
153
  const may = (page: PageIdentity, fnId: string): boolean =>
137
154
  scopeAllows(page.scopes ?? [], `action:${fnId}` as CapabilityScope);
138
155
 
156
+ /**
157
+ * A paused artifact runs no actions (D165 item 14): a call or a new run is refused before
158
+ * anything is recorded, started or relayed to the owner.
159
+ */
160
+ const paused = (page: PageIdentity): Response | undefined => {
161
+ const pause = interaction.pauseOf(page.artifactId);
162
+ if (!pause) return undefined;
163
+ return answer(
164
+ createDiagnostic("MOSTRA_ACTION_PAUSED", {
165
+ message: `This page is paused${pause.by === "operator" ? " by its server's operator" : ""}: its actions don't run until it is resumed.`,
166
+ }),
167
+ 423,
168
+ );
169
+ };
170
+
139
171
  return {
140
172
  async call(context) {
141
173
  const refused = served(context);
@@ -146,6 +178,8 @@ export function actionRoutes(options: ActionRoutesOptions): ActionRoutes {
146
178
  const page = pageOf(context);
147
179
  // The route checked `action:<fnId>` already (D97 item 4); this keeps the rule in one place.
148
180
  if (!may(page, fnId)) return denied(fnId);
181
+ const pausedNow = paused(page);
182
+ if (pausedNow) return pausedNow;
149
183
  let lines: AsyncIterable<unknown>;
150
184
  const abort = new AbortController();
151
185
  context.request.signal.addEventListener("abort", () => abort.abort(), { once: true });
@@ -199,6 +233,8 @@ export function actionRoutes(options: ActionRoutesOptions): ActionRoutes {
199
233
  if (request instanceof Response) return request;
200
234
  const page = pageOf(context);
201
235
  if (!may(page, request.fnId)) return denied(request.fnId);
236
+ const pausedNow = paused(page);
237
+ if (pausedNow) return pausedNow;
202
238
  try {
203
239
  return jsonResponse(
204
240
  actions.startRun(page, {
@@ -12,6 +12,7 @@ import {
12
12
  type EventRecord,
13
13
  FieldsRequest,
14
14
  FollowRequest,
15
+ type Refusal,
15
16
  RpcError,
16
17
  refusal,
17
18
  ShellSubmitRequest,
@@ -64,6 +65,8 @@ const STATUS: Readonly<Record<string, number>> = {
64
65
  MOSTRA_HOME_DISK_FULL: 507,
65
66
  MOSTRA_HOME_GONE: 503,
66
67
  MOSTRA_HYGIENE_SCOPE_DENIED: 403,
68
+ // A paused artifact takes no answers (D165 item 14).
69
+ MOSTRA_SUBMIT_PAUSED: 423,
67
70
  };
68
71
 
69
72
  /** Options for {@link browserRoutes}. */
@@ -86,6 +89,14 @@ export interface BrowserRoutesOptions {
86
89
  * without an `id`, a poll as its `ephemeral` (LL-04). Absent: neither carries any.
87
90
  */
88
91
  readonly bus?: EphemeralBus;
92
+ /**
93
+ * Before a submit, from the frame or the shell (a remote server's, D165 item 13): a refusal (with
94
+ * when to try again) keeps the draft; nothing is recorded. Absent: every submit goes on.
95
+ */
96
+ readonly admitSubmit?: (
97
+ page: PageIdentity,
98
+ context: RouteContext,
99
+ ) => Promise<(Refusal & { readonly retryAfter?: number }) | undefined>;
89
100
  /** Tells a host with a `trustedControls` port that a trusted control was used (D108). */
90
101
  readonly activated: (event: {
91
102
  readonly artifactId: string;
@@ -177,6 +188,8 @@ export interface BrowserRoutes {
177
188
  readonly stream: Handler;
178
189
  readonly poll: Handler;
179
190
  /** The shell's trusted Submit (the `shell` channel, D40), on the shell origin. */
191
+ /** `events/poll` on the shell origin: the same, without the frame's run and live updates (#119). */
192
+ readonly shellPoll: Handler;
180
193
  readonly shellSubmit: Handler;
181
194
  /** The shell's trusted Choose (D65, D113), on the shell origin. */
182
195
  readonly choose: Handler;
@@ -206,6 +219,35 @@ export function browserRoutes(options: BrowserRoutesOptions): BrowserRoutes {
206
219
  };
207
220
  };
208
221
 
222
+ /** The answer to a submit the server's rules refused before it reached the ledger. */
223
+ const admit = async (
224
+ context: RouteContext,
225
+ request: { readonly viewId: string; readonly expectedRevision: unknown },
226
+ ): Promise<Response | undefined> => {
227
+ if (!options.admitSubmit) return undefined;
228
+ // A repeat of a recorded submit answers that submission, and one a paused page or a view not
229
+ // the page's refuses is refused before anything is recorded: neither spends the submission
230
+ // rates or asks the operator (Fable review of WP-30, 8). The server's per-IP request rate
231
+ // still bounds them, as it bounds every request (`rateLimits.perIp.requests`).
232
+ const page = pageOf(context);
233
+ if (
234
+ !interaction.wouldRecord(page, {
235
+ viewId: request.viewId,
236
+ expectedRevision: Number(request.expectedRevision),
237
+ })
238
+ ) {
239
+ return undefined;
240
+ }
241
+ const refused = await options.admitSubmit(page, context);
242
+ if (!refused) return undefined;
243
+ return jsonResponse(refused.diagnostic, {
244
+ status: refused.status,
245
+ ...(refused.retryAfter !== undefined
246
+ ? { headers: { "retry-after": String(refused.retryAfter) } }
247
+ : {}),
248
+ });
249
+ };
250
+
209
251
  /** The view a stream or poll is for, checked against the page (D104). */
210
252
  const viewOf = (context: RouteContext, page: PageIdentity): Response | undefined => {
211
253
  const view = new URL(context.request.url).searchParams.get("view");
@@ -250,6 +292,8 @@ export function browserRoutes(options: BrowserRoutesOptions): BrowserRoutes {
250
292
  if (refused) return refused;
251
293
  const request = await body(context, SubmitRequest);
252
294
  if (request instanceof Response) return request;
295
+ const admitted = await admit(context, request);
296
+ if (admitted) return admitted;
253
297
  try {
254
298
  return jsonResponse(
255
299
  interaction.submit(pageOf(context), {
@@ -439,107 +483,117 @@ export function browserRoutes(options: BrowserRoutesOptions): BrowserRoutes {
439
483
  });
440
484
  };
441
485
 
442
- const poll = async (context: RouteContext): Promise<Response> => {
443
- const refused = knownRevision(context);
444
- if (refused) return refused;
445
- const page = pageOf(context);
446
- const badView = viewOf(context, page);
447
- if (badView) return badView;
448
- const resume = cursorOf(context.request);
449
- if (resume === "invalid") return malformed("`cursor` must be an event cursor.");
450
- const waitParam = new URL(context.request.url).searchParams.get("wait");
451
- const waitS = waitParam === null ? POLL_MAX_WAIT_S : Number(waitParam);
452
- if (!Number.isInteger(waitS) || waitS < 0 || waitS > POLL_MAX_WAIT_S) {
453
- return malformed(`\`wait\` must be a whole number of seconds from 0 to ${POLL_MAX_WAIT_S}.`);
454
- }
455
- const viewId = viewIdOf(context);
456
- const bus = options.bus;
457
- // Polling views collect their run and live updates between polls (LL-04).
458
- // Taking what is queued also starts the queue, so updates during the wait are kept.
459
- let early = bus?.drain(page.artifactId, viewId) ?? [];
460
- const withEphemeral = <T extends object>(value: T): T & { ephemeral?: unknown[] } => {
461
- const ephemeral = [...early, ...(bus?.drain(page.artifactId, viewId) ?? [])];
462
- early = [];
463
- return ephemeral.length > 0 ? { ...value, ephemeral } : value;
464
- };
465
- if (resume === undefined) {
466
- const snapshot = interaction.pageSnapshot(page);
467
- return jsonResponse(withEphemeral({ cursor: snapshot.cursor, events: [], snapshot }));
468
- }
469
- const revoked = (): Response =>
470
- answer(
471
- refusal(
472
- "MOSTRA_HYGIENE_TOKEN_REVOKED",
473
- "The link this page came from was revoked or has expired.",
474
- 410,
475
- ).diagnostic,
476
- 410,
477
- );
478
- const once = () => {
479
- const read = next(page, resume);
480
- return "snapshot" in read
481
- ? { cursor: read.snapshot.cursor, events: [], snapshot: read.snapshot }
482
- : { cursor: String(read.cursor), events: read.events };
483
- };
484
- try {
485
- const first = once();
486
- if (first.events.length > 0 || "snapshot" in first || waitS === 0 || early.length > 0) {
487
- return jsonResponse(withEphemeral(first));
486
+ /**
487
+ * `events/poll`. The frame's poll also answers with the run and live updates its view collected
488
+ * (LL-04); the shell's poll of the same view leaves them to the frame, which is the one that shows
489
+ * them: taking them made a page on a quick tunnel learn of a finished run only at its next renewal,
490
+ * about 20 s later (#119).
491
+ */
492
+ const pollFor =
493
+ (ephemeral: boolean) =>
494
+ async (context: RouteContext): Promise<Response> => {
495
+ const refused = knownRevision(context);
496
+ if (refused) return refused;
497
+ const page = pageOf(context);
498
+ const badView = viewOf(context, page);
499
+ if (badView) return badView;
500
+ const resume = cursorOf(context.request);
501
+ if (resume === "invalid") return malformed("`cursor` must be an event cursor.");
502
+ const waitParam = new URL(context.request.url).searchParams.get("wait");
503
+ const waitS = waitParam === null ? POLL_MAX_WAIT_S : Number(waitParam);
504
+ if (!Number.isInteger(waitS) || waitS < 0 || waitS > POLL_MAX_WAIT_S) {
505
+ return malformed(
506
+ `\`wait\` must be a whole number of seconds from 0 to ${POLL_MAX_WAIT_S}.`,
507
+ );
488
508
  }
489
- let ended = false;
490
- const stopWaiting = new AbortController();
491
- const result = await new Promise<ReturnType<typeof once>>((resolve, reject) => {
492
- let done = false;
493
- const finish = (value?: ReturnType<typeof once>): void => {
494
- if (done) return;
495
- done = true;
496
- clearTimeout(timer);
497
- unsubscribe();
498
- context.request.signal.removeEventListener("abort", aborted);
499
- // A failing read here (the ledger closing at shutdown, say) answers this request; it
500
- // never escapes the timer as an uncaught exception (Claude review finding 8).
501
- try {
502
- resolve(value ?? once());
503
- } catch (error) {
504
- reject(error);
505
- }
506
- };
507
- const aborted = (): void => finish(first);
508
- const unsubscribe = interaction.onCommit(() =>
509
- setImmediate(() => {
509
+ const viewId = viewIdOf(context);
510
+ const bus = ephemeral ? options.bus : undefined;
511
+ // Polling views collect their run and live updates between polls (LL-04).
512
+ // Taking what is queued also starts the queue, so updates during the wait are kept.
513
+ let early = bus?.drain(page.artifactId, viewId) ?? [];
514
+ const withEphemeral = <T extends object>(value: T): T & { ephemeral?: unknown[] } => {
515
+ const ephemeral = [...early, ...(bus?.drain(page.artifactId, viewId) ?? [])];
516
+ early = [];
517
+ return ephemeral.length > 0 ? { ...value, ephemeral } : value;
518
+ };
519
+ if (resume === undefined) {
520
+ const snapshot = interaction.pageSnapshot(page);
521
+ return jsonResponse(withEphemeral({ cursor: snapshot.cursor, events: [], snapshot }));
522
+ }
523
+ const revoked = (): Response =>
524
+ answer(
525
+ refusal(
526
+ "MOSTRA_HYGIENE_TOKEN_REVOKED",
527
+ "The link this page came from was revoked or has expired.",
528
+ 410,
529
+ ).diagnostic,
530
+ 410,
531
+ );
532
+ const once = () => {
533
+ const read = next(page, resume);
534
+ return "snapshot" in read
535
+ ? { cursor: read.snapshot.cursor, events: [], snapshot: read.snapshot }
536
+ : { cursor: String(read.cursor), events: read.events };
537
+ };
538
+ try {
539
+ const first = once();
540
+ if (first.events.length > 0 || "snapshot" in first || waitS === 0 || early.length > 0) {
541
+ return jsonResponse(withEphemeral(first));
542
+ }
543
+ let ended = false;
544
+ const stopWaiting = new AbortController();
545
+ const result = await new Promise<ReturnType<typeof once>>((resolve, reject) => {
546
+ let done = false;
547
+ const finish = (value?: ReturnType<typeof once>): void => {
510
548
  if (done) return;
511
- // A revoked or expired link ends the poll before it reads anything more.
512
- if (!live(context)) {
513
- ended = true;
514
- finish(first);
515
- return;
516
- }
549
+ done = true;
550
+ clearTimeout(timer);
551
+ unsubscribe();
552
+ context.request.signal.removeEventListener("abort", aborted);
553
+ // A failing read here (the ledger closing at shutdown, say) answers this request; it
554
+ // never escapes the timer as an uncaught exception (Claude review finding 8).
517
555
  try {
518
- const value = once();
519
- if (value.events.length > 0 || "snapshot" in value) finish(value);
556
+ resolve(value ?? once());
520
557
  } catch (error) {
521
- done = true;
522
- clearTimeout(timer);
523
- unsubscribe();
524
558
  reject(error);
525
559
  }
526
- }),
527
- );
528
- const timer = setTimeout(() => finish(), waitS * 1000);
529
- context.request.signal.addEventListener("abort", aborted, { once: true });
530
- // A run or live update for this view answers the poll too.
531
- void bus?.wait(page.artifactId, viewId, waitS * 1000, stopWaiting.signal).then(() => {
532
- if (!done) finish(first);
560
+ };
561
+ const aborted = (): void => finish(first);
562
+ const unsubscribe = interaction.onCommit(() =>
563
+ setImmediate(() => {
564
+ if (done) return;
565
+ // A revoked or expired link ends the poll before it reads anything more.
566
+ if (!live(context)) {
567
+ ended = true;
568
+ finish(first);
569
+ return;
570
+ }
571
+ try {
572
+ const value = once();
573
+ if (value.events.length > 0 || "snapshot" in value) finish(value);
574
+ } catch (error) {
575
+ done = true;
576
+ clearTimeout(timer);
577
+ unsubscribe();
578
+ reject(error);
579
+ }
580
+ }),
581
+ );
582
+ const timer = setTimeout(() => finish(), waitS * 1000);
583
+ context.request.signal.addEventListener("abort", aborted, { once: true });
584
+ // A run or live update for this view answers the poll too.
585
+ void bus?.wait(page.artifactId, viewId, waitS * 1000, stopWaiting.signal).then(() => {
586
+ if (!done) finish(first);
587
+ });
533
588
  });
534
- });
535
- stopWaiting.abort();
536
- // The link is checked again at the end: nothing read after it died leaves (HY-03).
537
- if (ended || !live(context)) return revoked();
538
- return jsonResponse(withEphemeral(result));
539
- } catch (error) {
540
- return failure(error);
541
- }
542
- };
589
+ stopWaiting.abort();
590
+ // The link is checked again at the end: nothing read after it died leaves (HY-03).
591
+ if (ended || !live(context)) return revoked();
592
+ return jsonResponse(withEphemeral(result));
593
+ } catch (error) {
594
+ return failure(error);
595
+ }
596
+ };
543
597
 
544
598
  // ── The shell's own routes (WP-07) ─────────────────────────────────────────────────────
545
599
  // They run on the shell origin behind the shell's session, its exact Origin and its CSRF
@@ -550,6 +604,8 @@ export function browserRoutes(options: BrowserRoutesOptions): BrowserRoutes {
550
604
  if (refused) return refused;
551
605
  const request = await body(context, ShellSubmitRequest);
552
606
  if (request instanceof Response) return request;
607
+ const admitted = await admit(context, request);
608
+ if (admitted) return admitted;
553
609
  const page = pageOf(context);
554
610
  let submission: SubmissionSummary & { readonly duplicate?: true };
555
611
  try {
@@ -648,5 +704,16 @@ export function browserRoutes(options: BrowserRoutesOptions): BrowserRoutes {
648
704
  }
649
705
  };
650
706
 
651
- return { fields, submit, signal, stream, poll, shellSubmit, choose, follow, carry };
707
+ return {
708
+ fields,
709
+ submit,
710
+ signal,
711
+ stream,
712
+ poll: pollFor(true),
713
+ shellPoll: pollFor(false),
714
+ shellSubmit,
715
+ choose,
716
+ follow,
717
+ carry,
718
+ };
652
719
  }
@@ -178,8 +178,11 @@ export interface ResolvedSession {
178
178
  readonly csrf: string;
179
179
  /** The version a frame session entered (D98 item 5). */
180
180
  readonly versionId?: string;
181
- /** How the session authenticates: a cookie, or the frame header of worker mode (D70). */
182
- readonly mode: "cookie" | "worker";
181
+ /**
182
+ * How the session authenticates: a cookie, the frame header of worker mode (D70), or a hosted
183
+ * shell's header (`X-Mostra-Shell`, D165 item 8).
184
+ */
185
+ readonly mode: SessionMode;
183
186
  readonly grant: Grant;
184
187
  /**
185
188
  * The viewer the session acts as: its link's viewer (D104), else the one the host's identity
@@ -216,11 +219,14 @@ interface TokenRow {
216
219
  viewer_id: string | null;
217
220
  }
218
221
 
222
+ /** How a session authenticates (DATA_MODEL §3 `session.mode`). */
223
+ export type SessionMode = "cookie" | "worker" | "header";
224
+
219
225
  interface SessionRow {
220
226
  id: string;
221
227
  token_id: string;
222
228
  origin: string;
223
- mode: "cookie" | "worker";
229
+ mode: SessionMode;
224
230
  csrf: string;
225
231
  version_id: string | null;
226
232
  viewer_id: string | null;
@@ -255,6 +261,11 @@ export interface CapabilitiesOptions {
255
261
  * face, a host's): a launch ticket is only minted for a link whose address is served.
256
262
  */
257
263
  readonly servesShell?: (origin: string) => boolean;
264
+ /**
265
+ * Told each token minted, after its row is written (a remote server indexes its hosted homes'
266
+ * links, so its operator's `revokeLink` finds a link's home, WP-30).
267
+ */
268
+ readonly onMinted?: (token: { readonly tokenId: string; readonly artifactId: string }) => void;
258
269
  }
259
270
 
260
271
  /** What a stream ticket opens (D158 item 5). */
@@ -268,6 +279,7 @@ export class Capabilities {
268
279
  readonly #now: () => number;
269
280
  readonly #shellOrigin: () => string;
270
281
  readonly #servesShell: (origin: string) => boolean;
282
+ readonly #onMinted: CapabilitiesOptions["onMinted"];
271
283
  /** Single-use stream and socket tickets (D158 item 5), by the SHA-256 of their secret. */
272
284
  readonly #streamTickets = new Map<
273
285
  string,
@@ -298,6 +310,7 @@ export class Capabilities {
298
310
  this.#now = options.now;
299
311
  this.#shellOrigin = options.shellOrigin;
300
312
  this.#servesShell = options.servesShell ?? ((origin) => origin === this.#shellOrigin());
313
+ this.#onMinted = options.onMinted;
301
314
  }
302
315
 
303
316
  /** Runs `fn` in the caller's transaction, or in a new one. */
@@ -353,6 +366,7 @@ export class Capabilities {
353
366
  input.pinnedVersion ?? null,
354
367
  shellOrigin,
355
368
  );
369
+ this.#onMinted?.({ tokenId, artifactId: input.artifactId });
356
370
  return {
357
371
  tokenId,
358
372
  secret,
@@ -618,8 +632,11 @@ export class Capabilities {
618
632
  readonly versionId?: string;
619
633
  /** The person the host's identity port named, for a link without a viewer (D143 item 2). */
620
634
  readonly viewerId?: string | undefined;
621
- /** `worker` for a worker-mode frame (D70), whose secret travels in a header; default `cookie`. */
622
- readonly mode?: "cookie" | "worker";
635
+ /**
636
+ * `worker` for a worker-mode frame (D70) and `header` for a hosted shell (D165 item 8), whose
637
+ * secrets travel in headers; default `cookie`.
638
+ */
639
+ readonly mode?: SessionMode;
623
640
  }): {
624
641
  readonly cookie: string;
625
642
  readonly csrf: string;
@@ -655,7 +672,7 @@ export class Capabilities {
655
672
  cookies: readonly string[],
656
673
  origin: string,
657
674
  artifactId: string,
658
- mode: "cookie" | "worker" = "cookie",
675
+ mode: SessionMode = "cookie",
659
676
  ): ResolvedSession | Refusal {
660
677
  let revoked = false;
661
678
  for (const value of cookies) {
@@ -29,6 +29,11 @@ export interface ListenerKind {
29
29
  readonly origin: string;
30
30
  /** The shell's origin: the only page that may frame an artifact (D98 item 4). */
31
31
  readonly shellOrigin: string;
32
+ /**
33
+ * The framers an artifact's documents name, when they are more than its shell: a hosted
34
+ * label's are the shells of its domain an operator also serves it under (INTERFACES §18.6).
35
+ */
36
+ readonly frameAncestors?: string;
32
37
  }
33
38
 
34
39
  /**
@@ -53,6 +58,10 @@ export function documentHeaders(
53
58
  "base-uri 'none'",
54
59
  "form-action 'none'",
55
60
  "object-src 'none'",
61
+ // No string reaches a script sink on the shell: every text a tenant or operator supplies
62
+ // renders as text, and a DOM-injection attempt throws (Trusted Types, HY-09).
63
+ "require-trusted-types-for 'script'",
64
+ "trusted-types 'none'",
56
65
  ].join("; "),
57
66
  "x-frame-options": "DENY",
58
67
  // Popups the artifact frame opens get no opener, so none can navigate this page (D98
@@ -60,7 +69,9 @@ export function documentHeaders(
60
69
  "cross-origin-opener-policy": "same-origin",
61
70
  };
62
71
  }
63
- return { "content-security-policy": `frame-ancestors ${listener.shellOrigin}` };
72
+ return {
73
+ "content-security-policy": `frame-ancestors ${listener.frameAncestors ?? listener.shellOrigin}`,
74
+ };
64
75
  }
65
76
 
66
77
  /** Every header of a request as `[name, value]` pairs, repeats kept. */