@mostra/runtime 0.10.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 (245) hide show
  1. package/dist/bin.js +4058 -310
  2. package/dist/bin.js.map +1 -1
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +1 -1
  5. package/dist/{instance-FExcyENK.js → instance-DCiUHvgZ.js} +682 -47
  6. package/dist/instance-DCiUHvgZ.js.map +1 -0
  7. package/dist/reference/cli.md +1322 -0
  8. package/dist/reference/diagnostics.json +1552 -0
  9. package/dist/reference/errors/MOSTRA_A11Y_MINOR.md +23 -0
  10. package/dist/reference/errors/MOSTRA_A11Y_SERIOUS.md +23 -0
  11. package/dist/reference/errors/MOSTRA_ACTION_CANCELLED.md +23 -0
  12. package/dist/reference/errors/MOSTRA_ACTION_EVENT_INVALID.md +23 -0
  13. package/dist/reference/errors/MOSTRA_ACTION_EXPORT_INVALID.md +23 -0
  14. package/dist/reference/errors/MOSTRA_ACTION_INTERRUPTED.md +23 -0
  15. package/dist/reference/errors/MOSTRA_ACTION_PAUSED.md +23 -0
  16. package/dist/reference/errors/MOSTRA_ACTION_RUN_NOT_FOUND.md +23 -0
  17. package/dist/reference/errors/MOSTRA_ACTION_THREW.md +23 -0
  18. package/dist/reference/errors/MOSTRA_ACTION_TOO_LARGE.md +23 -0
  19. package/dist/reference/errors/MOSTRA_ACTION_UNKNOWN_FUNCTION.md +23 -0
  20. package/dist/reference/errors/MOSTRA_ACTION_UNSERIALIZABLE.md +23 -0
  21. package/dist/reference/errors/MOSTRA_ARTIFACT_BUNDLE_INVALID.md +23 -0
  22. package/dist/reference/errors/MOSTRA_ARTIFACT_DIR_NOT_EMPTY.md +23 -0
  23. package/dist/reference/errors/MOSTRA_ARTIFACT_ENTRY_AMBIGUOUS.md +23 -0
  24. package/dist/reference/errors/MOSTRA_ARTIFACT_ID_DROPPED.md +23 -0
  25. package/dist/reference/errors/MOSTRA_ARTIFACT_NOT_FOUND.md +23 -0
  26. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_ENTRY.md +23 -0
  27. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_PAGE.md +23 -0
  28. package/dist/reference/errors/MOSTRA_ARTIFACT_PATCH_REJECTED.md +23 -0
  29. package/dist/reference/errors/MOSTRA_ARTIFACT_PATH_INVALID.md +23 -0
  30. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_MISSING.md +23 -0
  31. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_UNREADABLE.md +23 -0
  32. package/dist/reference/errors/MOSTRA_ARTIFACT_TEMPLATE_UNKNOWN.md +23 -0
  33. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_COLLECTED.md +23 -0
  34. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_NOT_FOUND.md +23 -0
  35. package/dist/reference/errors/MOSTRA_BUILD_CRASHED.md +23 -0
  36. package/dist/reference/errors/MOSTRA_BUILD_FAILED.md +23 -0
  37. package/dist/reference/errors/MOSTRA_BUILD_TIMEOUT.md +23 -0
  38. package/dist/reference/errors/MOSTRA_BUILD_UNRESOLVED.md +23 -0
  39. package/dist/reference/errors/MOSTRA_CLI_CONFIG_UNWRITABLE.md +23 -0
  40. package/dist/reference/errors/MOSTRA_CLI_UNKNOWN_COMMAND.md +23 -0
  41. package/dist/reference/errors/MOSTRA_CLI_USAGE.md +23 -0
  42. package/dist/reference/errors/MOSTRA_CONSOLE_ERROR.md +23 -0
  43. package/dist/reference/errors/MOSTRA_CONSOLE_WARNING.md +23 -0
  44. package/dist/reference/errors/MOSTRA_DEP_INSTALL_FAILED.md +23 -0
  45. package/dist/reference/errors/MOSTRA_DEP_MISSING.md +23 -0
  46. package/dist/reference/errors/MOSTRA_DEP_NOT_FOUND.md +23 -0
  47. package/dist/reference/errors/MOSTRA_DEP_OFFLINE.md +23 -0
  48. package/dist/reference/errors/MOSTRA_DEP_SPEC_INVALID.md +23 -0
  49. package/dist/reference/errors/MOSTRA_DEP_TIMEOUT.md +23 -0
  50. package/dist/reference/errors/MOSTRA_DEP_WARM_CONFLICT.md +23 -0
  51. package/dist/reference/errors/MOSTRA_ENV_BIND_FAILED.md +23 -0
  52. package/dist/reference/errors/MOSTRA_ENV_BROWSER_MISSING.md +23 -0
  53. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_DOWNLOAD_FAILED.md +23 -0
  54. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_INVALID.md +23 -0
  55. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_UNAVAILABLE.md +23 -0
  56. package/dist/reference/errors/MOSTRA_ENV_HELPER_MISSING.md +23 -0
  57. package/dist/reference/errors/MOSTRA_ENV_NODE_UNSUPPORTED.md +23 -0
  58. package/dist/reference/errors/MOSTRA_ENV_PORT_TAKEN.md +23 -0
  59. package/dist/reference/errors/MOSTRA_ENV_RUNTIME_INSTALLING.md +23 -0
  60. package/dist/reference/errors/MOSTRA_ENV_RUNTIME_MISSING.md +23 -0
  61. package/dist/reference/errors/MOSTRA_ENV_SERVICE_FAILED.md +23 -0
  62. package/dist/reference/errors/MOSTRA_ENV_SHELL_MISSING.md +23 -0
  63. package/dist/reference/errors/MOSTRA_ENV_WARM_MISSING.md +23 -0
  64. package/dist/reference/errors/MOSTRA_FIELD_CONFLICT.md +23 -0
  65. package/dist/reference/errors/MOSTRA_FIELD_DUPLICATE_ID.md +23 -0
  66. package/dist/reference/errors/MOSTRA_FIELD_ID_INVALID.md +23 -0
  67. package/dist/reference/errors/MOSTRA_FIELD_ID_UNSTABLE.md +23 -0
  68. package/dist/reference/errors/MOSTRA_FIELD_MUTATION_ID_REUSED.md +23 -0
  69. package/dist/reference/errors/MOSTRA_FIELD_SHARED.md +23 -0
  70. package/dist/reference/errors/MOSTRA_FIELD_TOO_LARGE.md +23 -0
  71. package/dist/reference/errors/MOSTRA_FIELD_UNBOUND.md +23 -0
  72. package/dist/reference/errors/MOSTRA_HOME_DISK_FULL.md +23 -0
  73. package/dist/reference/errors/MOSTRA_HOME_GC_INCOMPLETE.md +23 -0
  74. package/dist/reference/errors/MOSTRA_HOME_GONE.md +23 -0
  75. package/dist/reference/errors/MOSTRA_HOME_INTEGRITY.md +23 -0
  76. package/dist/reference/errors/MOSTRA_HOME_LEDGER_UNREADABLE.md +23 -0
  77. package/dist/reference/errors/MOSTRA_HOME_LOCKED.md +23 -0
  78. package/dist/reference/errors/MOSTRA_HOME_MISMATCH.md +23 -0
  79. package/dist/reference/errors/MOSTRA_HOME_NETWORK_FILESYSTEM.md +23 -0
  80. package/dist/reference/errors/MOSTRA_HOME_NOT_ALWAYS_ON.md +23 -0
  81. package/dist/reference/errors/MOSTRA_HOME_NOT_OWNED.md +23 -0
  82. package/dist/reference/errors/MOSTRA_HOME_SOCKET_TOO_LONG.md +23 -0
  83. package/dist/reference/errors/MOSTRA_HOME_TOO_NEW.md +23 -0
  84. package/dist/reference/errors/MOSTRA_HOST_CONNECTION_CLOSED.md +23 -0
  85. package/dist/reference/errors/MOSTRA_HOST_CURSOR_COMPACTED.md +23 -0
  86. package/dist/reference/errors/MOSTRA_HOST_IDENTITY_UNAVAILABLE.md +23 -0
  87. package/dist/reference/errors/MOSTRA_HOST_INITIALIZE_ORDER.md +23 -0
  88. package/dist/reference/errors/MOSTRA_HOST_INTERNAL_ERROR.md +23 -0
  89. package/dist/reference/errors/MOSTRA_HOST_INVALID_PARAMS.md +23 -0
  90. package/dist/reference/errors/MOSTRA_HOST_MALFORMED.md +23 -0
  91. package/dist/reference/errors/MOSTRA_HOST_MESSAGE_TOO_LARGE.md +23 -0
  92. package/dist/reference/errors/MOSTRA_HOST_METHOD_UNKNOWN.md +23 -0
  93. package/dist/reference/errors/MOSTRA_HOST_NOTIFICATION_UNSUPPORTED.md +23 -0
  94. package/dist/reference/errors/MOSTRA_HOST_PORT_UNSUPPORTED.md +23 -0
  95. package/dist/reference/errors/MOSTRA_HOST_REQUEST_ID_REUSED.md +23 -0
  96. package/dist/reference/errors/MOSTRA_HOST_REVISION_UNSUPPORTED.md +23 -0
  97. package/dist/reference/errors/MOSTRA_HOST_SHUTDOWN_REFUSED.md +23 -0
  98. package/dist/reference/errors/MOSTRA_HOST_SUBSCRIPTION_UNKNOWN.md +23 -0
  99. package/dist/reference/errors/MOSTRA_HOST_TIMEOUT.md +23 -0
  100. package/dist/reference/errors/MOSTRA_HYGIENE_CONTENT_TYPE.md +23 -0
  101. package/dist/reference/errors/MOSTRA_HYGIENE_CSRF_MISSING.md +23 -0
  102. package/dist/reference/errors/MOSTRA_HYGIENE_FRAME_SESSION.md +23 -0
  103. package/dist/reference/errors/MOSTRA_HYGIENE_HEADERS_TOO_LARGE.md +23 -0
  104. package/dist/reference/errors/MOSTRA_HYGIENE_HOST_REFUSED.md +23 -0
  105. package/dist/reference/errors/MOSTRA_HYGIENE_NOT_SERVED.md +23 -0
  106. package/dist/reference/errors/MOSTRA_HYGIENE_ORIGIN_REFUSED.md +23 -0
  107. package/dist/reference/errors/MOSTRA_HYGIENE_RATE_LIMITED.md +23 -0
  108. package/dist/reference/errors/MOSTRA_HYGIENE_REQUEST_MALFORMED.md +23 -0
  109. package/dist/reference/errors/MOSTRA_HYGIENE_SCOPE_DENIED.md +23 -0
  110. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_CONFLICT.md +23 -0
  111. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_MISSING.md +23 -0
  112. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_INVALID.md +23 -0
  113. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_REVOKED.md +23 -0
  114. package/dist/reference/errors/MOSTRA_LIVE_SOURCE_FAILED.md +23 -0
  115. package/dist/reference/errors/MOSTRA_LIVE_TOO_LARGE.md +23 -0
  116. package/dist/reference/errors/MOSTRA_MANIFEST_INVALID.md +23 -0
  117. package/dist/reference/errors/MOSTRA_MANIFEST_NOT_LITERAL.md +23 -0
  118. package/dist/reference/errors/MOSTRA_MANIFEST_UNKNOWN_KEY.md +23 -0
  119. package/dist/reference/errors/MOSTRA_NETWORK_EXTERNAL_FAILED.md +23 -0
  120. package/dist/reference/errors/MOSTRA_NETWORK_REQUEST_FAILED.md +23 -0
  121. package/dist/reference/errors/MOSTRA_PLATFORM_UNSUPPORTED.md +23 -0
  122. package/dist/reference/errors/MOSTRA_PUBLISH_ID_CONFLICT.md +23 -0
  123. package/dist/reference/errors/MOSTRA_PUBLISH_SOURCE_CHANGED.md +23 -0
  124. package/dist/reference/errors/MOSTRA_PUBLISH_VERIFY_FAILED.md +23 -0
  125. package/dist/reference/errors/MOSTRA_REGRESSION_ACTION_REMOVED.md +23 -0
  126. package/dist/reference/errors/MOSTRA_REGRESSION_ARIA.md +23 -0
  127. package/dist/reference/errors/MOSTRA_REGRESSION_FIELD_REMOVED.md +23 -0
  128. package/dist/reference/errors/MOSTRA_REGRESSION_LIVE_REMOVED.md +23 -0
  129. package/dist/reference/errors/MOSTRA_REGRESSION_PAGE_REMOVED.md +23 -0
  130. package/dist/reference/errors/MOSTRA_REGRESSION_PIXELS.md +23 -0
  131. package/dist/reference/errors/MOSTRA_REMOTE_CONFIG_INVALID.md +23 -0
  132. package/dist/reference/errors/MOSTRA_REMOTE_HOME_MOVING.md +23 -0
  133. package/dist/reference/errors/MOSTRA_REMOTE_HOME_SUSPENDED.md +23 -0
  134. package/dist/reference/errors/MOSTRA_REMOTE_LIMIT_REACHED.md +23 -0
  135. package/dist/reference/errors/MOSTRA_REMOTE_LOGIN_FAILED.md +23 -0
  136. package/dist/reference/errors/MOSTRA_REMOTE_NOT_OWNER_INSTANCE.md +23 -0
  137. package/dist/reference/errors/MOSTRA_REMOTE_NO_INSTANCE.md +23 -0
  138. package/dist/reference/errors/MOSTRA_REMOTE_OPERATOR_UNAVAILABLE.md +23 -0
  139. package/dist/reference/errors/MOSTRA_REMOTE_OWNER_OFFLINE.md +23 -0
  140. package/dist/reference/errors/MOSTRA_REMOTE_PAUSED_BY_OPERATOR.md +23 -0
  141. package/dist/reference/errors/MOSTRA_REMOTE_QUEUE_FULL.md +23 -0
  142. package/dist/reference/errors/MOSTRA_REMOTE_RATE_LIMITED.md +23 -0
  143. package/dist/reference/errors/MOSTRA_REMOTE_SIGN_IN_REQUIRED.md +23 -0
  144. package/dist/reference/errors/MOSTRA_REMOTE_UNDER_REVIEW.md +23 -0
  145. package/dist/reference/errors/MOSTRA_REMOTE_UNREACHABLE.md +23 -0
  146. package/dist/reference/errors/MOSTRA_RUNTIME_BLANK.md +23 -0
  147. package/dist/reference/errors/MOSTRA_RUNTIME_NOT_READY.md +23 -0
  148. package/dist/reference/errors/MOSTRA_RUNTIME_PAGE_ERROR.md +23 -0
  149. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_CRASHED.md +23 -0
  150. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_PARKED.md +23 -0
  151. package/dist/reference/errors/MOSTRA_SECRET_MISSING.md +23 -0
  152. package/dist/reference/errors/MOSTRA_SHARE_NOT_ENABLED.md +23 -0
  153. package/dist/reference/errors/MOSTRA_SHARE_NOT_FOUND.md +23 -0
  154. package/dist/reference/errors/MOSTRA_SHARE_PORTS_EXHAUSTED.md +23 -0
  155. package/dist/reference/errors/MOSTRA_SHARE_TOOL_MISSING.md +23 -0
  156. package/dist/reference/errors/MOSTRA_SHARE_TOOL_NOT_READY.md +23 -0
  157. package/dist/reference/errors/MOSTRA_SHARE_TTL_INVALID.md +23 -0
  158. package/dist/reference/errors/MOSTRA_SHARE_TUNNEL_FAILED.md +23 -0
  159. package/dist/reference/errors/MOSTRA_SMOKE_BUDGET.md +23 -0
  160. package/dist/reference/errors/MOSTRA_SMOKE_NO_EFFECT.md +23 -0
  161. package/dist/reference/errors/MOSTRA_SUBMIT_ALREADY.md +23 -0
  162. package/dist/reference/errors/MOSTRA_SUBMIT_BLOCKED.md +23 -0
  163. package/dist/reference/errors/MOSTRA_SUBMIT_CHANNEL_DENIED.md +23 -0
  164. package/dist/reference/errors/MOSTRA_SUBMIT_NOT_FOUND.md +23 -0
  165. package/dist/reference/errors/MOSTRA_SUBMIT_PAUSED.md +23 -0
  166. package/dist/reference/errors/MOSTRA_SUBMIT_POLICY_NONE.md +23 -0
  167. package/dist/reference/errors/MOSTRA_SUBMIT_REVISION_MOVED.md +23 -0
  168. package/dist/reference/errors/MOSTRA_SUBMIT_SIGNAL_INVALID.md +23 -0
  169. package/dist/reference/errors/MOSTRA_SUBMIT_VIEW_INVALID.md +23 -0
  170. package/dist/reference/errors/MOSTRA_TARGET_UNAVAILABLE.md +23 -0
  171. package/dist/reference/errors/MOSTRA_TYPE_ERROR.md +23 -0
  172. package/dist/reference/errors/MOSTRA_TYPE_UNTYPED_PACKAGE.md +23 -0
  173. package/dist/reference/errors/MOSTRA_VERIFY_ACTION_SKIPPED.md +23 -0
  174. package/dist/reference/errors/MOSTRA_VERIFY_BASELINE_MISSING.md +23 -0
  175. package/dist/reference/errors/MOSTRA_VERIFY_CRASHED.md +23 -0
  176. package/dist/reference/errors/MOSTRA_VERIFY_LIVE_FAILED.md +23 -0
  177. package/dist/reference/errors/MOSTRA_VERIFY_NO_BASELINE.md +23 -0
  178. package/dist/reference/errors/MOSTRA_VERIFY_SECRET_MISSING.md +23 -0
  179. package/dist/reference/errors/MOSTRA_VERIFY_SKIP_CONSEQUENCE.md +23 -0
  180. package/dist/reference/errors/MOSTRA_VERIFY_TIMEOUT.md +23 -0
  181. package/dist/reference/self-hosting.md +130 -0
  182. package/dist/reference/telemetry.md +84 -0
  183. package/dist/skill/SKILL.md +122 -0
  184. package/dist/skill/assets/examples/dashboard/index.tsx +161 -0
  185. package/dist/skill/assets/examples/dashboard/live.ts +25 -0
  186. package/dist/skill/assets/examples/dashboard/styles.css +125 -0
  187. package/dist/skill/assets/examples/decision/index.tsx +95 -0
  188. package/dist/skill/assets/examples/decision/styles.css +125 -0
  189. package/dist/skill/assets/examples/inbox/actions.ts +23 -0
  190. package/dist/skill/assets/examples/inbox/index.tsx +109 -0
  191. package/dist/skill/assets/examples/inbox/styles.css +125 -0
  192. package/dist/skill/assets/studio.css +125 -0
  193. package/dist/skill/references/answers.md +217 -0
  194. package/dist/skill/references/design.md +154 -0
  195. package/dist/skill/references/libraries.md +167 -0
  196. package/dist/skill/references/long-lived.md +148 -0
  197. package/dist/skill/references/mcp.md +68 -0
  198. package/dist/skill/references/page.md +131 -0
  199. package/dist/skill/references/server.md +146 -0
  200. package/dist/skill/references/sharing.md +123 -0
  201. package/dist/skill/references/verify.md +71 -0
  202. package/package.json +10 -5
  203. package/src/gateway/actions.ts +20 -0
  204. package/src/gateway/browser.ts +44 -0
  205. package/src/gateway/capabilities.ts +8 -0
  206. package/src/gateway/http.ts +12 -1
  207. package/src/gateway/index.ts +170 -5
  208. package/src/gateway/listener.ts +31 -6
  209. package/src/gateway/routes.ts +8 -0
  210. package/src/gc/index.ts +5 -0
  211. package/src/instance/index.ts +20 -1
  212. package/src/interaction/index.ts +60 -0
  213. package/src/interaction/pause.ts +106 -0
  214. package/src/interaction/submissions.ts +42 -1
  215. package/src/interaction/viewers.ts +34 -1
  216. package/src/ledger/index.ts +20 -1
  217. package/src/ledger/migrations.ts +51 -0
  218. package/src/link/author.ts +215 -0
  219. package/src/link/hosted.ts +37 -1
  220. package/src/link/http.ts +6 -1
  221. package/src/link/index.ts +3 -1
  222. package/src/link/manager.ts +138 -34
  223. package/src/protocol-server/client.ts +53 -0
  224. package/src/protocol-server/index.ts +1 -1
  225. package/src/server/api.ts +514 -72
  226. package/src/server/auth.ts +600 -74
  227. package/src/server/authorize.ts +816 -0
  228. package/src/server/clients.ts +235 -0
  229. package/src/server/config.ts +7 -0
  230. package/src/server/data.ts +59 -1
  231. package/src/server/directory.ts +69 -0
  232. package/src/server/feed.ts +191 -0
  233. package/src/server/handle.ts +172 -0
  234. package/src/server/hosted-pages.ts +532 -0
  235. package/src/server/hosted.ts +519 -18
  236. package/src/server/index.ts +343 -61
  237. package/src/server/mcp.ts +330 -0
  238. package/src/server/metering.ts +156 -0
  239. package/src/server/oauth-clients.ts +510 -0
  240. package/src/server/operator.ts +498 -0
  241. package/src/server/providers.ts +284 -0
  242. package/src/server/remove.ts +148 -0
  243. package/src/server/routing.ts +275 -0
  244. package/src/verify/runner.ts +23 -2
  245. package/dist/instance-FExcyENK.js.map +0 -1
@@ -12,13 +12,14 @@
12
12
  */
13
13
  import { createHash, randomBytes } from "node:crypto";
14
14
  import { linkSync, mkdirSync, writeFileSync } from "node:fs";
15
- import { copyFile, readFile, rm } from "node:fs/promises";
15
+ import { copyFile, readFile, rm, stat } from "node:fs/promises";
16
16
  import type { IncomingMessage, ServerResponse } from "node:http";
17
17
  import { isAbsolute, join, relative } from "node:path";
18
18
  import {
19
19
  ArtifactManifest,
20
20
  artifactGetMethod,
21
21
  artifactListMethod,
22
+ artifactPauseMethod,
22
23
  createDiagnostic,
23
24
  type HostedPushParams,
24
25
  type HostedPushResult,
@@ -26,13 +27,15 @@ import {
26
27
  hostedPushMethod,
27
28
  hostedSubmissionMethod,
28
29
  type InstanceInfo,
30
+ type PausedBy,
29
31
  RouteId,
30
32
  RpcError,
31
33
  remoteTokenMethod,
34
+ viewUrlMethod,
32
35
  } from "@mostra/protocol";
33
36
  import type { Addressing } from "../addressing/index.ts";
34
37
  import { coverageMatcher, readFieldCoverage, readServerFunctions } from "../builder/index.ts";
35
- import { noFaults } from "../faults.ts";
38
+ import { type Faults, noFaults } from "../faults.ts";
36
39
  import {
37
40
  Capabilities,
38
41
  capabilityKey,
@@ -45,12 +48,25 @@ import { createEphemeralBus, createInteraction, type Interaction } from "../inte
45
48
  import type { Ledger } from "../ledger/index.ts";
46
49
  import { createLive, liveMethods } from "../live/index.ts";
47
50
  import type { Log } from "../log.ts";
48
- import { handler, ProtocolServer, type Session } from "../protocol-server/index.ts";
51
+ import { removeTree } from "../platform/index.ts";
52
+ import {
53
+ handler,
54
+ type MethodHandler,
55
+ ProtocolServer,
56
+ type Session,
57
+ } from "../protocol-server/index.ts";
49
58
  import { canonicalRef, listingDigest, versionIdFor } from "../publish/index.ts";
50
59
  import { openRegistry, type Registry } from "../registry/index.ts";
51
60
  import type { Authorization } from "./auth.ts";
61
+ import type { ClientAddresses, RateLimiter } from "./clients.ts";
52
62
  import { rotateIncarnation } from "./data.ts";
63
+ import { createOperatorFeed, type OperatorFeed } from "./feed.ts";
64
+ import { type HomeOwner, type HostedPagesOptions, hostedPages } from "./hosted-pages.ts";
65
+ import type { Meter } from "./metering.ts";
66
+ import type { Operator } from "./operator.ts";
53
67
  import { createHostedRelay } from "./relay.ts";
68
+ import { purgeArtifact } from "./remove.ts";
69
+ import type { Routing } from "./routing.ts";
54
70
 
55
71
  /** Lower-case Crockford base32, for route labels (one DNS label, 130 bits). */
56
72
  const LABEL_ALPHABET = "0123456789abcdefghjkmnpqrstvwxyz";
@@ -92,10 +108,37 @@ export interface HostedHome {
92
108
  readonly protocol: ProtocolServer;
93
109
  /** The home's current incarnation (DATA_MODEL §7.2). */
94
110
  incarnation(): string;
95
- /** The SHA-256s of client files a pending push of this home names as missing. */
96
- wanted(sha256: string): boolean;
111
+ /**
112
+ * The size a pending push of this home gives a client file it names as missing, or `undefined`
113
+ * when none names it: an upload must bring exactly those bytes (Fable review of WP-30, 2).
114
+ */
115
+ wanted(sha256: string): number | undefined;
97
116
  /** Records a file this home uploaded (`PUT /files/<sha256>`, §18.2). */
98
117
  uploaded(sha256: string): void;
118
+ /** Pauses or resumes an artifact as its owner or the operator (D165 item 14). */
119
+ pause(
120
+ artifactId: string,
121
+ change: { readonly paused: boolean; readonly by: PausedBy; readonly reason?: string },
122
+ ): { readonly paused: boolean; readonly by?: PausedBy };
123
+ /** Quarantines an artifact, or one version of it, here only (D165 item 9). */
124
+ quarantine(artifactId: string, versionId: string | undefined, reason: string): void;
125
+ /** Ends a quarantine: the artifact's, or one version's. */
126
+ release(artifactId: string, versionId: string | undefined): void;
127
+ /** Revokes every live link of an artifact; answers how many were live. */
128
+ revokeLinks(artifactId: string): number;
129
+ /** Revokes one link; `false` when this home has no such link. */
130
+ revokeLink(tokenId: string): boolean;
131
+ /**
132
+ * Removes an artifact and everything of it from this home (`ServerHandle.remove`): its rows, its
133
+ * version files no other version of the home names, and its route; its label is kept issued
134
+ * forever, never served again (DATA_MODEL §7.5).
135
+ */
136
+ remove(artifactId: string): Promise<{ readonly rows: number }>;
137
+ /**
138
+ * The session of the account's default owner instance, while it is connected: where remote MCP's
139
+ * authoring goes (D165 items 1b, 5). The newest session of the link is its own.
140
+ */
141
+ defaultOwnerSession(): number | undefined;
99
142
  /** Whether a binding is open, a stream or poll is served, or a delivery waits. */
100
143
  busy(): boolean;
101
144
  /**
@@ -131,6 +174,8 @@ export interface HostedHomeOptions {
131
174
  /** The shell's built files. */
132
175
  readonly shellDir: string | undefined;
133
176
  /** The relay's server settings (`relay` in the configuration, D165 item 4). */
177
+ /** The test fault points (`MOSTRA_TEST_FAULTS`); none by default. */
178
+ readonly faults?: Faults;
134
179
  readonly relay?: {
135
180
  readonly waitingRunsPerArtifact?: number | undefined;
136
181
  readonly drainPerSecond?: number | undefined;
@@ -141,6 +186,26 @@ export interface HostedHomeOptions {
141
186
  /** `rateLimits.perLink.relayedRuns`, in milliseconds. */
142
187
  readonly perLink?: { readonly count: number; readonly perMs: number } | undefined;
143
188
  };
189
+ /** What the server lends every hosted home: its operator, client addresses and rates (WP-30). */
190
+ readonly services?: HostedServices;
191
+ }
192
+
193
+ /** What the server lends every hosted home (WP-30). */
194
+ export interface HostedServices {
195
+ readonly operator: Operator;
196
+ readonly clients: ClientAddresses;
197
+ readonly rates: RateLimiter;
198
+ readonly rateLimits: HostedPagesOptions["rateLimits"];
199
+ /** Who owns a home, as its pages' sender line names them. */
200
+ readonly owner: (homeId: string) => HomeOwner;
201
+ readonly signInOffered: () => boolean;
202
+ readonly madeWith?: { readonly href?: string } | undefined;
203
+ /** The server's routing by exact `Host`: operator hosts, their frames and link hosts (D167). */
204
+ readonly routing: Routing;
205
+ /** The server's meter: views here, submissions through the operator feed. */
206
+ readonly meter: Meter;
207
+ /** Viewer sign-in on the authorization server (INTERFACES §18.4). */
208
+ readonly signin?: HostedPagesOptions["signin"];
144
209
  }
145
210
 
146
211
  function refuse(code: Parameters<typeof createDiagnostic>[0], message: string): RpcError {
@@ -149,10 +214,11 @@ function refuse(code: Parameters<typeof createDiagnostic>[0], message: string):
149
214
 
150
215
  /** Opens the parts of a hosted home over its ledger. */
151
216
  export async function openHostedHome(options: HostedHomeOptions): Promise<HostedHome> {
217
+ const faults = options.faults ?? noFaults;
152
218
  const { id, dir, ledger, directory, log } = options;
153
219
  const registry = await openRegistry({ home: dir, ledger });
154
- /** Pending pushes: version ID → the client files still missing. */
155
- const pending = new Map<string, Set<string>>();
220
+ /** Pending pushes: version ID → each missing client file's SHA-256 and the size its listing gives. */
221
+ const pending = new Map<string, Map<string, number>>();
156
222
  let incarnation = options.incarnation;
157
223
 
158
224
  const ownerLinkOf = (artifactId: string): string | undefined =>
@@ -207,11 +273,22 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
207
273
  /** The route of an artifact on this home, minted on its first push by `link`. */
208
274
  const routeFor = (artifactId: string, link: string): HostedRoute =>
209
275
  directory.write((db) => {
210
- const found = db.get<{ id: string; label: string; owner_link_id: string }>(
211
- "SELECT id, label, owner_link_id FROM artifact_route WHERE home_id = ? AND artifact_id = ?",
276
+ const found = db.get<{
277
+ id: string;
278
+ label: string;
279
+ owner_link_id: string;
280
+ removing_json: string | null;
281
+ }>(
282
+ "SELECT id, label, owner_link_id, removing_json FROM artifact_route WHERE home_id = ? AND artifact_id = ?",
212
283
  id,
213
284
  artifactId,
214
285
  );
286
+ if (found?.removing_json != null) {
287
+ throw refuse(
288
+ "MOSTRA_REMOTE_HOME_MOVING",
289
+ "This artifact is being removed from the server; push it again once that's done.",
290
+ );
291
+ }
215
292
  if (found) {
216
293
  if (found.owner_link_id !== link) {
217
294
  const owner = db.get<{ name: string }>(
@@ -252,10 +329,11 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
252
329
 
253
330
  // ── Hosted pages (INTERFACES §18.4) ────────────────────────────────────────────────────
254
331
 
332
+ // A route being removed serves nothing (its removal finishes on the next call).
255
333
  const routeOf = (artifactId: string): { id: string; label: string } | undefined =>
256
334
  directory.read((db) =>
257
335
  db.get<{ id: string; label: string }>(
258
- "SELECT id, label FROM artifact_route WHERE home_id = ? AND artifact_id = ?",
336
+ "SELECT id, label FROM artifact_route WHERE home_id = ? AND artifact_id = ? AND removing_json IS NULL",
259
337
  id,
260
338
  artifactId,
261
339
  ),
@@ -264,20 +342,44 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
264
342
  directory.read(
265
343
  (db) =>
266
344
  db.get<{ artifact_id: string }>(
267
- "SELECT artifact_id FROM artifact_route WHERE id = ? AND home_id = ?",
345
+ "SELECT artifact_id FROM artifact_route WHERE id = ? AND home_id = ? AND removing_json IS NULL",
268
346
  routeId,
269
347
  id,
270
348
  )?.artifact_id,
271
349
  );
272
350
  const domains = [options.domains.active, ...options.domains.spares];
273
351
  const originOf = (host: string): string => `${options.scheme}://${host}`;
352
+ /** The host of one of this server's origins, or `undefined` for another scheme. */
353
+ const hostOfOrigin = (origin: string): string | undefined =>
354
+ origin.startsWith(`${options.scheme}://`) ? origin.slice(options.scheme.length + 3) : undefined;
355
+ /** Whether a shell origin is this home's: a configured apex, or an operator host of it. */
356
+ const servesShell = (origin: string): boolean => {
357
+ const host = hostOfOrigin(origin);
358
+ if (host === undefined) return false;
359
+ return options.services
360
+ ? options.services.routing.servesShell(id, host)
361
+ : domains.includes(host);
362
+ };
274
363
  const capabilities: Capabilities = new Capabilities({
275
364
  ledger,
276
365
  log,
277
366
  key: capabilityKey(dir, log),
278
367
  now: () => Date.now(),
279
368
  shellOrigin: () => originOf(options.domains.active),
280
- servesShell: (origin) => domains.some((domain) => originOf(domain) === origin),
369
+ servesShell,
370
+ // Every hosted link is indexed in the directory, so the operator's `revokeLink` finds its home.
371
+ onMinted: ({ tokenId, artifactId }) => {
372
+ const route = routeOf(artifactId);
373
+ if (!route) return;
374
+ directory.write((db) =>
375
+ db.run(
376
+ "INSERT OR IGNORE INTO hosted_token (token_id, home_id, route_id) VALUES (?, ?, ?)",
377
+ tokenId,
378
+ id,
379
+ route.id,
380
+ ),
381
+ );
382
+ },
281
383
  });
282
384
  // A hosted home binds nothing: its faces are served through the front. These answer the few
283
385
  // questions the gateway asks of loopback addressing, none of which a hosted face reaches.
@@ -382,13 +484,68 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
382
484
  activated: () => undefined,
383
485
  hosted: {
384
486
  shellOrigin: () => originOf(options.domains.active),
385
- servesShell: (origin) => domains.some((domain) => originOf(domain) === origin),
487
+ servesShell,
386
488
  shellPath: (artifactId) => `/a/${routeOf(artifactId)?.id ?? artifactId}`,
387
489
  artifactOrigin: (artifactId, shellOrigin) => {
388
490
  const route = routeOf(artifactId);
389
- const domain = domains.find((candidate) => originOf(candidate) === shellOrigin);
390
- return route && domain ? originOf(`${route.label}.${domain}`) : undefined;
491
+ const host = hostOfOrigin(shellOrigin);
492
+ if (!route || host === undefined) return undefined;
493
+ const frameDomain = options.services
494
+ ? options.services.routing.frameDomainOf(id, route.id, host)
495
+ : domains.includes(host)
496
+ ? host
497
+ : undefined;
498
+ return frameDomain === undefined ? undefined : originOf(`${route.label}.${frameDomain}`);
391
499
  },
500
+ ...(options.services
501
+ ? {
502
+ // A new link goes on the operator's host for it when it names one that serves this
503
+ // route (D167, `routing.linkHost`), else on the active domain.
504
+ linkOrigin: async (artifactId: string) => {
505
+ const services = options.services as HostedServices;
506
+ const route = routeOf(artifactId);
507
+ if (!route || !services.operator.has.linkHost) return undefined;
508
+ const wanted = await services.operator.linkHost({
509
+ account: services.owner(id).account,
510
+ home: id,
511
+ routeId: route.id,
512
+ });
513
+ if (wanted === null) return undefined;
514
+ const host = await services.routing.linkHost(id, route.id, wanted);
515
+ return host === undefined ? undefined : originOf(host);
516
+ },
517
+ frameAncestors: (artifactId: string, frameOrigin: string) => {
518
+ const route = routeOf(artifactId);
519
+ const host = hostOfOrigin(frameOrigin);
520
+ if (!route || host === undefined) return "";
521
+ const frameDomain = host.slice(host.indexOf(".") + 1);
522
+ return (options.services as HostedServices).routing
523
+ .ancestorsOf(id, route.id, frameDomain)
524
+ .map(originOf)
525
+ .join(" ");
526
+ },
527
+ }
528
+ : {}),
529
+ ...(options.services
530
+ ? hostedPages({
531
+ homeId: id,
532
+ ledger,
533
+ interaction,
534
+ capabilities,
535
+ artifact: (artifactId) => registry.get({ artifactId }),
536
+ routeOf,
537
+ owner: () => (options.services as HostedServices).owner(id),
538
+ signInOffered: options.services.signInOffered,
539
+ operator: options.services.operator,
540
+ clients: options.services.clients,
541
+ rates: options.services.rates,
542
+ rateLimits: options.services.rateLimits,
543
+ madeWith: options.services.madeWith,
544
+ ...(options.services.signin ? { signin: options.services.signin } : {}),
545
+ viewed: (input) => metered(input.artifactId, input.viewerId),
546
+ log,
547
+ })
548
+ : {}),
392
549
  },
393
550
  });
394
551
  /** The faces of a domain: its shell, and a route's frames, opened when first asked for. */
@@ -469,6 +626,98 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
469
626
  ),
470
627
  );
471
628
 
629
+ /**
630
+ * Quarantines a route's artifact, or one version of it, in this home only (D165 item 9): its
631
+ * links show the neutral "under review" page and its files are withheld; data is kept. An
632
+ * identical version in another home is untouched, since the row is this home's.
633
+ */
634
+ const quarantine = (artifactId: string, versionId: string | undefined, reason: string): void => {
635
+ ledger.write((db) =>
636
+ db.run(
637
+ `INSERT INTO quarantine (artifact_id, version_id, reason, at) VALUES (?, ?, ?, ?)
638
+ ON CONFLICT (artifact_id, version_id) DO UPDATE SET reason = excluded.reason`,
639
+ artifactId,
640
+ versionId ?? "",
641
+ reason.slice(0, 1_000),
642
+ new Date().toISOString(),
643
+ ),
644
+ );
645
+ log.info("server.quarantined", { home: id, artifactId, versionId: versionId ?? null });
646
+ };
647
+
648
+ /**
649
+ * `view/url` on a hosted home under the operator's `limits` (`link`): refused with its words, and
650
+ * refused for now when the operator doesn't answer, since a link creates something (D165 item 9).
651
+ */
652
+ const limitedLinks = (method: MethodHandler): MethodHandler => ({
653
+ definition: method.definition,
654
+ async handle(params, session) {
655
+ const services = options.services;
656
+ if (services) {
657
+ const ref = (params as { artifact?: unknown }).artifact;
658
+ const artifactId = registry.get(canonicalRef(ref as never)).id;
659
+ const route = routeOf(artifactId);
660
+ const verdict = await services.operator.limit({
661
+ account: services.owner(id).account,
662
+ home: id,
663
+ artifact: artifactId,
664
+ ...(route ? { routeId: route.id } : {}),
665
+ operation: "link",
666
+ });
667
+ if (verdict.allowed === "unavailable") {
668
+ throw refuse(
669
+ "MOSTRA_REMOTE_OPERATOR_UNAVAILABLE",
670
+ "The server's operator didn't answer in time; try minting the link again.",
671
+ );
672
+ }
673
+ if (verdict.allowed === false) throw refuse("MOSTRA_REMOTE_LIMIT_REACHED", verdict.message);
674
+ }
675
+ return method.handle(params, session);
676
+ },
677
+ });
678
+
679
+ /**
680
+ * A view for metering, under the viewer's monthly pseudonymous key (D167): the account for a
681
+ * signed-in viewer, the viewer for a link minted with one, the route's key for anyone else.
682
+ */
683
+ const metered = (artifactId: string, viewerId: string): void => {
684
+ const meter = options.services?.meter;
685
+ if (!meter?.on) return;
686
+ const viewer = ledger.read((db) =>
687
+ db.get<{ kind: string; external_ref: string | null }>(
688
+ "SELECT kind, external_ref FROM viewer WHERE id = ?",
689
+ viewerId,
690
+ ),
691
+ );
692
+ const subject =
693
+ viewer?.kind === "account" || viewer?.kind === "anonymous"
694
+ ? `${viewer.kind}:${viewer.external_ref ?? viewerId}`
695
+ : `viewer:${id}:${viewerId}`;
696
+ const route = routeOf(artifactId);
697
+ meter.add("views", {
698
+ account: (options.services as HostedServices).owner(id).account,
699
+ home: id,
700
+ artifactId,
701
+ ...(route ? { routeId: route.id } : {}),
702
+ dimensions: { viewerKey: meter.viewerKey(subject) },
703
+ });
704
+ };
705
+
706
+ /** The live links of an artifact, revoked; answers how many were live. */
707
+ const revokeLinks = (artifactId: string): number => {
708
+ const tokens = ledger.read((db) =>
709
+ db
710
+ .all<{ id: string }>(
711
+ "SELECT id FROM token WHERE artifact_id = ? AND revoked_at IS NULL",
712
+ artifactId,
713
+ )
714
+ .map((row) => row.id),
715
+ );
716
+ let revoked = 0;
717
+ for (const tokenId of tokens) if (capabilities.revoke(tokenId) === "revoked") revoked += 1;
718
+ return revoked;
719
+ };
720
+
472
721
  const push = async (params: HostedPushParams, session: Session): Promise<HostedPushResult> => {
473
722
  const link = session.link?.instanceId;
474
723
  if (link === undefined || session.attributes["linkId"] !== link) {
@@ -527,6 +776,24 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
527
776
  if (!manifest.success)
528
777
  throw refuse("MOSTRA_HOME_INTEGRITY", "The pushed artifact manifest isn't valid.");
529
778
 
779
+ const services = options.services;
780
+ // A first push hosts the artifact: the operator's `limits` judge it as a share, failing
781
+ // closed when it doesn't answer (D165 item 9).
782
+ if (services && routeOf(params.artifactId) === undefined) {
783
+ const verdict = await services.operator.limit({
784
+ account: services.owner(id).account,
785
+ home: id,
786
+ artifact: params.artifactId,
787
+ operation: "share",
788
+ });
789
+ if (verdict.allowed === "unavailable") {
790
+ throw refuse(
791
+ "MOSTRA_REMOTE_OPERATOR_UNAVAILABLE",
792
+ "The server's operator didn't answer in time; the share is tried again later.",
793
+ );
794
+ }
795
+ if (verdict.allowed === false) throw refuse("MOSTRA_REMOTE_LIMIT_REACHED", verdict.message);
796
+ }
530
797
  const route = routeFor(params.artifactId, link);
531
798
  if (registry.hasVersion(version.versionId)) {
532
799
  const known = registry
@@ -541,9 +808,66 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
541
808
  }
542
809
  // Only client files are stored: server code never reaches the server (D165 item 3).
543
810
  const clientFiles = version.listing.filter(([path]) => path.startsWith("client/"));
811
+ // The sizes a listing gives are what the storage limit is asked with, so each is held to the
812
+ // bytes: one file has one size, a file this home holds already has the size it has on disk, and
813
+ // an upload brings exactly the size given (Fable review of WP-30, 2).
814
+ const sizes = new Map<string, number>();
815
+ for (const [path, , sha, size] of clientFiles) {
816
+ if (!Number.isSafeInteger(size) || size < 0 || (sizes.get(sha) ?? size) !== size) {
817
+ throw refuse(
818
+ "MOSTRA_HOME_INTEGRITY",
819
+ `The listing gives ${path} a size its bytes can't have.`,
820
+ );
821
+ }
822
+ sizes.set(sha, size);
823
+ }
824
+ for (const [sha, size] of sizes) {
825
+ const held = directory.read((db) =>
826
+ db.get("SELECT 1 FROM home_file WHERE home_id = ? AND sha256 = ?", id, sha),
827
+ );
828
+ if (held === undefined) continue;
829
+ const onDisk = await stat(join(options.filesDir, sha)).then(
830
+ (found) => found.size,
831
+ () => undefined,
832
+ );
833
+ if (onDisk !== undefined && onDisk !== size) {
834
+ throw refuse(
835
+ "MOSTRA_HOME_INTEGRITY",
836
+ "The listing gives a held file another size than its bytes.",
837
+ );
838
+ }
839
+ }
840
+ // The operator's `limits` on a push and the bytes it stores: refused for good with its words,
841
+ // and refused for now (fail closed) when the operator doesn't answer (D165 item 9).
842
+ if (services) {
843
+ const owner = services.owner(id).account;
844
+ for (const [operation, quantity] of [
845
+ ["version.push", 1],
846
+ ["storage", [...sizes.values()].reduce((sum, size) => sum + size, 0)],
847
+ ] as const) {
848
+ const verdict = await services.operator.limit({
849
+ account: owner,
850
+ home: id,
851
+ artifact: params.artifactId,
852
+ routeId: route.routeId,
853
+ operation,
854
+ quantity,
855
+ });
856
+ if (verdict.allowed === "unavailable") {
857
+ throw refuse(
858
+ "MOSTRA_REMOTE_OPERATOR_UNAVAILABLE",
859
+ "The server's operator didn't answer in time; the push is tried again later.",
860
+ );
861
+ }
862
+ if (verdict.allowed === false) throw refuse("MOSTRA_REMOTE_LIMIT_REACHED", verdict.message);
863
+ }
864
+ }
544
865
  const missing = missingOf([...new Set(clientFiles.map(([, , sha]) => sha))]);
545
866
  if (missing.length > 0) {
546
- pending.set(version.versionId, new Set(missing));
867
+ pending.set(
868
+ version.versionId,
869
+ new Map(missing.map((sha) => [sha, sizes.get(sha) as number])),
870
+ );
547
871
  return { status: "missing", files: missing, route };
548
872
  }
549
873
  pending.delete(version.versionId);
@@ -615,6 +939,31 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
615
939
  artifactId: params.artifactId,
616
940
  versionId: version.versionId,
617
941
  });
942
+ // The operator's after-push hook reads the client files; its answer can quarantine the
943
+ // version afterwards, never holding up serving it (D165 item 9).
944
+ if (services?.operator.has.pushed) {
945
+ const files = clientFiles.map(([path]) => path);
946
+ const shaOf = new Map(clientFiles.map(([path, , sha]) => [path, sha]));
947
+ services.operator.pushed(
948
+ {
949
+ routeId: route.routeId,
950
+ label: route.label,
951
+ artifactId: params.artifactId,
952
+ home: id,
953
+ versionId: version.versionId,
954
+ manifest: manifest.data,
955
+ files,
956
+ read: async (path) => {
957
+ const sha = shaOf.get(path);
958
+ if (sha === undefined) throw new Error(`No client file ${path} in this version.`);
959
+ return new Uint8Array(await readFile(join(options.filesDir, sha)));
960
+ },
961
+ },
962
+ async (reason) => {
963
+ quarantine(params.artifactId, version.versionId, reason);
964
+ },
965
+ );
966
+ }
618
967
  return { status: "complete", versionId: version.versionId, number: committed.version, route };
619
968
  };
620
969
 
@@ -726,7 +1075,21 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
726
1075
  }
727
1076
  return envelope;
728
1077
  }),
729
- ...gateway.methods(),
1078
+ ...gateway
1079
+ .methods()
1080
+ .map((method) =>
1081
+ method.definition.method === viewUrlMethod.method ? limitedLinks(method) : method,
1082
+ ),
1083
+ handler(artifactPauseMethod, (params) => {
1084
+ // The account's own instances pause and resume as the owner; only the operator, through
1085
+ // its handle, resumes an operator's pause (D165 item 14).
1086
+ const artifactId = registry.get(canonicalRef(params.artifact)).id;
1087
+ return interaction.pause(artifactId, {
1088
+ paused: params.paused,
1089
+ by: "owner",
1090
+ ...(params.reason !== undefined ? { reason: params.reason } : {}),
1091
+ });
1092
+ }),
730
1093
  ...relay.methods(),
731
1094
  ...liveMethods(live, (ref) => registry.get(canonicalRef(ref)).id),
732
1095
  handler(remoteTokenMethod, (params, session) => {
@@ -747,6 +1110,20 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
747
1110
  });
748
1111
  interaction.start();
749
1112
  live.start();
1113
+ // The operator's feed of this home's events, and its submissions for metering (§18.6).
1114
+ const feed: OperatorFeed | undefined = options.services
1115
+ ? createOperatorFeed({
1116
+ homeId: id,
1117
+ ledger,
1118
+ interaction,
1119
+ operator: options.services.operator,
1120
+ meter: options.services.meter,
1121
+ account: () => (options.services as HostedServices).owner(id).account,
1122
+ routeOf,
1123
+ incarnation: () => incarnation,
1124
+ log,
1125
+ })
1126
+ : undefined;
750
1127
 
751
1128
  return {
752
1129
  id,
@@ -756,7 +1133,13 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
756
1133
  interaction,
757
1134
  protocol,
758
1135
  incarnation: () => incarnation,
759
- wanted: (sha) => [...pending.values()].some((files) => files.has(sha)),
1136
+ wanted: (sha) => {
1137
+ for (const files of pending.values()) {
1138
+ const size = files.get(sha);
1139
+ if (size !== undefined) return size;
1140
+ }
1141
+ return undefined;
1142
+ },
760
1143
  uploaded(sha) {
761
1144
  directory.write((db) => {
762
1145
  const added = db.run(
@@ -773,9 +1156,127 @@ export async function openHostedHome(options: HostedHomeOptions): Promise<Hosted
773
1156
  });
774
1157
  for (const files of pending.values()) files.delete(sha);
775
1158
  },
1159
+ pause: (artifactId, change) => interaction.pause(artifactId, change),
1160
+ quarantine,
1161
+ release(artifactId, versionId) {
1162
+ ledger.write((db) =>
1163
+ db.run(
1164
+ versionId === undefined
1165
+ ? "DELETE FROM quarantine WHERE artifact_id = ?"
1166
+ : "DELETE FROM quarantine WHERE artifact_id = ? AND version_id = ?",
1167
+ ...(versionId === undefined ? [artifactId] : [artifactId, versionId]),
1168
+ ),
1169
+ );
1170
+ },
1171
+ revokeLinks,
1172
+ revokeLink: (tokenId) => capabilities.revoke(tokenId) !== "unknown",
1173
+ async remove(artifactId) {
1174
+ /** The client files a version's listing names. */
1175
+ const clientFilesOf = async (versionId: string): Promise<string[]> => {
1176
+ try {
1177
+ const listing = JSON.parse(
1178
+ await readFile(join(registry.store.versionDir(versionId), "listing.json"), "utf8"),
1179
+ ) as [string, boolean, string, number][];
1180
+ return listing.filter(([path]) => path.startsWith("client/")).map(([, , sha]) => sha);
1181
+ } catch {
1182
+ return [];
1183
+ }
1184
+ };
1185
+ // The plan is recorded in the directory before anything goes, so a removal cut off between
1186
+ // the two databases is finished by the next call, from the same plan (Fable review, 4).
1187
+ const recorded = directory.read(
1188
+ (db) =>
1189
+ db.get<{ removing_json: string | null }>(
1190
+ "SELECT removing_json FROM artifact_route WHERE home_id = ? AND artifact_id = ?",
1191
+ id,
1192
+ artifactId,
1193
+ )?.removing_json,
1194
+ );
1195
+ let plan: { readonly versions: string[]; readonly going: string[] };
1196
+ if (recorded != null) plan = JSON.parse(recorded) as typeof plan;
1197
+ else {
1198
+ const versions = registry.get({ artifactId }).versions.map((version) => version.id);
1199
+ const files = new Set<string>();
1200
+ for (const versionId of versions)
1201
+ for (const sha of await clientFilesOf(versionId)) files.add(sha);
1202
+ plan = { versions, going: [...files] };
1203
+ directory.write((db) =>
1204
+ db.run(
1205
+ "UPDATE artifact_route SET removing_json = ? WHERE home_id = ? AND artifact_id = ?",
1206
+ JSON.stringify(plan),
1207
+ id,
1208
+ artifactId,
1209
+ ),
1210
+ );
1211
+ }
1212
+ const versions = plan.versions;
1213
+ const going = new Set(plan.going);
1214
+ if (registry.list({}).some((summary) => summary.id === artifactId)) revokeLinks(artifactId);
1215
+ const removed = ledger.removal((db) => purgeArtifact(db, artifactId));
1216
+ // A test cuts the removal off here, between its two databases (`remove:after-purge`).
1217
+ faults.at("remove:after-purge");
1218
+ // Files another version of this home still names stay this home's.
1219
+ const kept = new Set<string>();
1220
+ for (const other of registry.list({})) {
1221
+ for (const version of registry.get({ artifactId: other.id }).versions) {
1222
+ for (const sha of await clientFilesOf(version.id)) kept.add(sha);
1223
+ }
1224
+ }
1225
+ const route = directory.read((db) =>
1226
+ db.get<{ id: string }>(
1227
+ "SELECT id FROM artifact_route WHERE home_id = ? AND artifact_id = ?",
1228
+ id,
1229
+ artifactId,
1230
+ ),
1231
+ );
1232
+ directory.write((db) => {
1233
+ for (const sha of going) {
1234
+ if (kept.has(sha)) continue;
1235
+ if (
1236
+ db.run("DELETE FROM home_file WHERE home_id = ? AND sha256 = ?", id, sha).changes > 0
1237
+ ) {
1238
+ db.run(
1239
+ `UPDATE file_ref SET homes = homes - 1,
1240
+ unreferenced_at = CASE WHEN homes - 1 = 0 THEN ? ELSE NULL END
1241
+ WHERE sha256 = ?`,
1242
+ new Date().toISOString(),
1243
+ sha,
1244
+ );
1245
+ }
1246
+ }
1247
+ if (route) {
1248
+ db.run("DELETE FROM hosted_token WHERE route_id = ?", route.id);
1249
+ // The route goes; its label stays in `label_issued`, never issued again.
1250
+ db.run("DELETE FROM artifact_route WHERE id = ?", route.id);
1251
+ }
1252
+ });
1253
+ for (const versionId of versions) {
1254
+ await removeTree(registry.store.versionDir(versionId)).catch((error: unknown) =>
1255
+ log.warn("server.remove_files_failed", { versionId, error }),
1256
+ );
1257
+ }
1258
+ const rows = Object.values(removed).reduce((sum, count) => sum + count, 0);
1259
+ log.info("server.artifact_removed", { home: id, artifactId, rows });
1260
+ return { rows };
1261
+ },
1262
+ defaultOwnerSession() {
1263
+ const link = directory.read(
1264
+ (db) =>
1265
+ db.get<{ id: string }>(
1266
+ "SELECT id FROM instance_link WHERE home_id = ? AND is_default = 1 AND revoked_at IS NULL",
1267
+ id,
1268
+ )?.id,
1269
+ );
1270
+ if (link === undefined) return undefined;
1271
+ return protocol
1272
+ .registrants("relay")
1273
+ .filter((entry) => entry.owner === link)
1274
+ .at(-1)?.session;
1275
+ },
776
1276
  busy: () => protocol.connections > 0 || bus.activeViews() > 0 || relay.busy(),
777
1277
  serve,
778
1278
  async stop() {
1279
+ feed?.stop();
779
1280
  relay.stop();
780
1281
  live.stop();
781
1282
  interaction.stop();