@mostra/runtime 0.10.0 → 0.12.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 (257) hide show
  1. package/dist/bin.js +4178 -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-CBUlOmzG.js} +1892 -85
  6. package/dist/instance-CBUlOmzG.js.map +1 -0
  7. package/dist/reference/cli.md +1432 -0
  8. package/dist/reference/diagnostics.json +1579 -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_TEAM_PRESENCE_RATE_LIMITED.md +23 -0
  172. package/dist/reference/errors/MOSTRA_TEAM_ROSTER_POLICY.md +23 -0
  173. package/dist/reference/errors/MOSTRA_TEAM_ROSTER_TOO_LARGE.md +23 -0
  174. package/dist/reference/errors/MOSTRA_TYPE_ERROR.md +23 -0
  175. package/dist/reference/errors/MOSTRA_TYPE_UNTYPED_PACKAGE.md +23 -0
  176. package/dist/reference/errors/MOSTRA_VERIFY_ACTION_SKIPPED.md +23 -0
  177. package/dist/reference/errors/MOSTRA_VERIFY_BASELINE_MISSING.md +23 -0
  178. package/dist/reference/errors/MOSTRA_VERIFY_CRASHED.md +23 -0
  179. package/dist/reference/errors/MOSTRA_VERIFY_LIVE_FAILED.md +23 -0
  180. package/dist/reference/errors/MOSTRA_VERIFY_NO_BASELINE.md +23 -0
  181. package/dist/reference/errors/MOSTRA_VERIFY_SECRET_MISSING.md +23 -0
  182. package/dist/reference/errors/MOSTRA_VERIFY_SKIP_CONSEQUENCE.md +23 -0
  183. package/dist/reference/errors/MOSTRA_VERIFY_TIMEOUT.md +23 -0
  184. package/dist/reference/self-hosting.md +130 -0
  185. package/dist/reference/telemetry.md +84 -0
  186. package/dist/skill/SKILL.md +124 -0
  187. package/dist/skill/assets/examples/dashboard/index.tsx +161 -0
  188. package/dist/skill/assets/examples/dashboard/live.ts +25 -0
  189. package/dist/skill/assets/examples/dashboard/styles.css +125 -0
  190. package/dist/skill/assets/examples/decision/index.tsx +95 -0
  191. package/dist/skill/assets/examples/decision/styles.css +125 -0
  192. package/dist/skill/assets/examples/inbox/actions.ts +23 -0
  193. package/dist/skill/assets/examples/inbox/index.tsx +109 -0
  194. package/dist/skill/assets/examples/inbox/styles.css +125 -0
  195. package/dist/skill/assets/studio.css +125 -0
  196. package/dist/skill/references/answers.md +219 -0
  197. package/dist/skill/references/design.md +154 -0
  198. package/dist/skill/references/libraries.md +167 -0
  199. package/dist/skill/references/long-lived.md +148 -0
  200. package/dist/skill/references/mcp.md +68 -0
  201. package/dist/skill/references/page.md +131 -0
  202. package/dist/skill/references/server.md +146 -0
  203. package/dist/skill/references/sharing.md +123 -0
  204. package/dist/skill/references/teams.md +78 -0
  205. package/dist/skill/references/verify.md +71 -0
  206. package/package.json +10 -5
  207. package/src/gateway/actions.ts +20 -0
  208. package/src/gateway/browser.ts +128 -1
  209. package/src/gateway/capabilities.ts +8 -0
  210. package/src/gateway/http.ts +12 -1
  211. package/src/gateway/index.ts +210 -6
  212. package/src/gateway/listener.ts +31 -6
  213. package/src/gateway/routes.ts +8 -0
  214. package/src/gateway/team.ts +181 -0
  215. package/src/gc/index.ts +5 -0
  216. package/src/instance/index.ts +22 -2
  217. package/src/interaction/ephemeral.ts +21 -0
  218. package/src/interaction/events.ts +17 -0
  219. package/src/interaction/index.ts +325 -20
  220. package/src/interaction/pause.ts +106 -0
  221. package/src/interaction/roster.ts +585 -0
  222. package/src/interaction/submissions.ts +42 -1
  223. package/src/interaction/team.ts +426 -0
  224. package/src/interaction/viewers.ts +34 -1
  225. package/src/interaction/wait.ts +150 -0
  226. package/src/ledger/index.ts +20 -1
  227. package/src/ledger/migrations.ts +86 -0
  228. package/src/link/author.ts +215 -0
  229. package/src/link/hosted.ts +51 -4
  230. package/src/link/http.ts +6 -1
  231. package/src/link/index.ts +3 -1
  232. package/src/link/manager.ts +169 -35
  233. package/src/protocol-server/client.ts +53 -0
  234. package/src/protocol-server/index.ts +1 -1
  235. package/src/server/api.ts +514 -72
  236. package/src/server/auth.ts +600 -74
  237. package/src/server/authorize.ts +816 -0
  238. package/src/server/clients.ts +235 -0
  239. package/src/server/config.ts +7 -0
  240. package/src/server/data.ts +59 -1
  241. package/src/server/directory.ts +91 -0
  242. package/src/server/feed.ts +277 -0
  243. package/src/server/handle.ts +172 -0
  244. package/src/server/hosted-pages.ts +532 -0
  245. package/src/server/hosted.ts +551 -18
  246. package/src/server/index.ts +353 -61
  247. package/src/server/mcp.ts +330 -0
  248. package/src/server/metering.ts +156 -0
  249. package/src/server/oauth-clients.ts +510 -0
  250. package/src/server/operator.ts +557 -0
  251. package/src/server/providers.ts +284 -0
  252. package/src/server/remove.ts +148 -0
  253. package/src/server/routing.ts +275 -0
  254. package/src/share/index.ts +50 -2
  255. package/src/verify/index.ts +7 -0
  256. package/src/verify/runner.ts +27 -2
  257. package/dist/instance-FExcyENK.js.map +0 -1
@@ -31,11 +31,17 @@ import {
31
31
  type FieldState,
32
32
  MutationId,
33
33
  type MutationResult,
34
+ type PausedBy,
35
+ RESULTS_LIST_MAX,
36
+ type RespondentSpec,
34
37
  type Results,
38
+ type Roster,
39
+ type RosterForPage,
35
40
  RpcError,
36
41
  type RunState,
37
42
  refusal,
38
43
  resultsGetMethod,
44
+ resultsListMethod,
39
45
  type StreamSnapshot,
40
46
  type SubmissionEnvelope,
41
47
  type SubmissionSummary,
@@ -44,6 +50,7 @@ import {
44
50
  scopeAllows,
45
51
  stateGetMethod,
46
52
  statePatchMethod,
53
+ type TeamVisibility,
47
54
  type Viewer,
48
55
  type ViewerSpec,
49
56
  waitMethod,
@@ -62,7 +69,22 @@ import {
62
69
  } from "./fields.ts";
63
70
  import { type ImportSource, importSubmission } from "./imports.ts";
64
71
  import { type HostConnections, Outbox } from "./outbox.ts";
72
+ import { type Pause, pauseOf, setPause } from "./pause.ts";
65
73
  import { buildResults, CHOICE, resultsMarkdown, submissionFor } from "./results.ts";
74
+ import {
75
+ addRespondents,
76
+ peerKey,
77
+ ROSTER_EVENTS,
78
+ type RosterViewer,
79
+ readRoster,
80
+ removeRespondents,
81
+ rosterForPage,
82
+ rosterForPages,
83
+ type SubmissionStanding,
84
+ settleRoster,
85
+ submissionStanding,
86
+ teamVisibility,
87
+ } from "./roster.ts";
66
88
  import {
67
89
  appendRunOutput,
68
90
  createOrJoinRun,
@@ -88,13 +110,17 @@ import {
88
110
  SubmitConflict,
89
111
  submissionSummary,
90
112
  submit,
113
+ wouldRecord,
91
114
  } from "./submissions.ts";
92
115
  import { Subscriptions } from "./subscriptions.ts";
93
116
  import {
94
117
  localViewerId,
118
+ nameAnonymous,
95
119
  openView,
96
120
  viewControls,
97
121
  viewer,
122
+ viewerForAccount,
123
+ viewerForAnonymous,
98
124
  viewerForHost,
99
125
  viewerForLink,
100
126
  viewerForSpec,
@@ -108,6 +134,7 @@ export { appendEvent, compactEvents, redactEvents } from "./events.ts";
108
134
  export { followEvents, type ImportSource, importedDeliveryId } from "./imports.ts";
109
135
  export type { HostConnections } from "./outbox.ts";
110
136
  export { policyInForce } from "./policy.ts";
137
+ export { peerKey } from "./roster.ts";
111
138
  export {
112
139
  appendRunOutput,
113
140
  finishRun,
@@ -122,6 +149,7 @@ export {
122
149
  } from "./runs.ts";
123
150
  export { SubmitConflict } from "./submissions.ts";
124
151
  export { tallyField, tallyState } from "./tally.ts";
152
+ export { createTeamTraffic, type TeamTraffic } from "./team.ts";
125
153
 
126
154
  /** How the interaction core finds an artifact a host names. */
127
155
  export interface InteractionArtifacts {
@@ -164,6 +192,12 @@ export interface InteractionOptions {
164
192
  * get no delivery events. The owner, its agent and hosts keep every delivery state.
165
193
  */
166
194
  readonly sentOnly?: boolean;
195
+ /**
196
+ * Whether a viewer is the artifact's owner, who sees every respondent and every present viewer
197
+ * whatever the visibility policy (CO-07): on a local home the home's local user (the default),
198
+ * on a hosted home the account that owns it.
199
+ */
200
+ readonly isOwner?: (viewer: { readonly kind: string; readonly ref: string }) => boolean;
167
201
  }
168
202
 
169
203
  /** The delivery events only the owner, its agent and hosts see on a hosted home (D165 item 1a). */
@@ -191,6 +225,17 @@ export interface Interaction {
191
225
  /** Stops delivering; pending deliveries stay in the outbox. */
192
226
  stop(): void;
193
227
 
228
+ /**
229
+ * Pauses or resumes an artifact as its owner or its server's operator (D165 item 14, RM-09);
230
+ * the owner resuming an operator's pause is `MOSTRA_REMOTE_PAUSED_BY_OPERATOR`.
231
+ */
232
+ pause(
233
+ artifactId: string,
234
+ change: { readonly paused: boolean; readonly by: PausedBy; readonly reason?: string },
235
+ ): { readonly paused: boolean; readonly by?: PausedBy };
236
+ /** The artifact's pause, or `undefined` when it isn't paused. */
237
+ pauseOf(artifactId: string): Pause | undefined;
238
+
194
239
  /** The viewer a capability token's sessions act as (D104): its own, or the home's local user. */
195
240
  viewerOf(tokenViewerId: string | undefined): string;
196
241
  /** A viewer by ID (D104). */
@@ -203,6 +248,12 @@ export interface Interaction {
203
248
  viewerForTailnet(spec: ViewerSpec): string;
204
249
  /** A link's own viewer, for a tunnel visitor nobody named (D158 item 2). */
205
250
  viewerForLink(tokenId: string, name: string): string;
251
+ /** A signed-in account on a hosted link (D165 item 8), named as its provider verified it. */
252
+ viewerForAccount(accountId: string, name?: string): string;
253
+ /** An anonymous viewer on a hosted link, by the route's derived browser key (D165 item 8). */
254
+ viewerForAnonymous(key: string): string;
255
+ /** Sets an anonymous viewer's self-chosen name, unverified; `false` for any other viewer. */
256
+ nameAnonymous(viewerId: string, name: string | null): boolean;
206
257
  /** Records a frame load of a version (D104), with the controls in force (D108); returns its ID. */
207
258
  openView(input: {
208
259
  readonly artifactId: string;
@@ -235,6 +286,16 @@ export interface Interaction {
235
286
  * `hosted/submission`, FAILURE_MODEL §11.2); `undefined` when `owner` has no delivery of it.
236
287
  */
237
288
  envelopeFor(submissionId: string, owner: string): SubmissionEnvelope | undefined;
289
+ /** A submission's full Results (§8), built from the immutable submission alone. */
290
+ resultsOf(submissionId: string): Results | undefined;
291
+ /**
292
+ * Whether a page's submit would be judged afresh: not a repeat of a recorded one, not refused by
293
+ * its view or a pause. Only such a submit is admitted by a hosted home's rates and limits.
294
+ */
295
+ wouldRecord(
296
+ page: PageIdentity,
297
+ input: { readonly viewId: string; readonly expectedRevision: number },
298
+ ): boolean;
238
299
  /** A viewer's submit (IN-05); `SubmitConflict` under a closed `once`. */
239
300
  submit(
240
301
  page: PageIdentity,
@@ -400,6 +461,43 @@ export interface Interaction {
400
461
  onTallied(listener: (artifactId: string, fields: readonly string[]) => void): () => void;
401
462
  /** How many host subscriptions are open. */
402
463
  subscriptionCount(): number;
464
+
465
+ // ── Teams (WP-31, D168) ──────────────────────────────────────────────────────────────────────
466
+ /**
467
+ * Adds expected respondents inside the caller's transaction (CO-01); `link` gives each one's
468
+ * personal link's token in the same transaction. Settles the roster.
469
+ */
470
+ addRespondents(
471
+ db: LedgerDb,
472
+ input: {
473
+ readonly artifactId: string;
474
+ readonly respondents: readonly RespondentSpec[];
475
+ readonly actor: Actor;
476
+ readonly link: (viewerId: string, current: string | undefined) => string;
477
+ },
478
+ ): { readonly tokens: readonly { readonly ref: string; readonly tokenId: string }[] };
479
+ /** Removes expected respondents inside the caller's transaction; settles the roster. */
480
+ removeRespondents(
481
+ db: LedgerDb,
482
+ input: { readonly artifactId: string; readonly refs: readonly string[]; readonly actor: Actor },
483
+ ): { readonly removed: readonly string[] };
484
+ /** The whole roster (CO-03); `live` says whether a personal link's token still works. */
485
+ roster(artifactId: string, live?: (tokenId: string) => boolean): Roster;
486
+ /** The roster as a page may see it (CO-07). */
487
+ rosterForPage(page: PageIdentity): RosterForPage;
488
+ /** The roster as each of an artifact's pages may see it, from one read (in their order). */
489
+ rostersForPages(artifactId: string, viewerIds: readonly string[]): RosterForPage[];
490
+ /** What viewers of an artifact see of each other (CO-07). */
491
+ visibility(artifactId: string): TeamVisibility;
492
+ /** Whether a page's viewer is the artifact's owner, who sees everyone (CO-07). */
493
+ isOwner(viewerId: string): boolean;
494
+ /** A viewer as a page sees them: their key on this artifact, name and kind (D168). */
495
+ peer(artifactId: string, viewerId: string): { readonly key: string } & RosterViewer;
496
+ /**
497
+ * Hears an artifact whose respondents' status may have changed (a view opened, a draft written,
498
+ * a submission, a roster change), after the commit; returns the stop.
499
+ */
500
+ onTeam(listener: (artifactId: string) => void): () => void;
403
501
  }
404
502
 
405
503
  function runNotFound(runId: string): RpcError {
@@ -429,6 +527,9 @@ function visibleTo(
429
527
  run: (runId: string) => RunRow | undefined,
430
528
  ): boolean {
431
529
  const viewerId = page.viewerId;
530
+ // The roster's events name refs and emails: pages read the roster through its own route,
531
+ // under the visibility policy (CO-07, D168).
532
+ if (ROSTER_EVENTS.has(event.type)) return false;
432
533
  if (event.type.startsWith("draft.")) return event.payload["viewerId"] === viewerId;
433
534
  if (event.type.startsWith("host.")) return false;
434
535
  if (event.type.startsWith("action.")) {
@@ -445,12 +546,38 @@ function visibleTo(
445
546
  }
446
547
 
447
548
  /**
448
- * Another viewer as a page sees them: kind and display name, never their viewer or view IDs
449
- * (D104; Claude review finding 12). The name stays, so a conflict can say who changed a field.
549
+ * Another viewer as a page sees them: kind, display name and their key on this artifact, never
550
+ * their viewer or view IDs (D104; Claude review finding 12). The name stays, so a conflict can say
551
+ * who changed a field, and the key lets a page tell two people of one name apart and match the
552
+ * writer of a shared field to a respondent or a present viewer (D168, CO-05).
553
+ */
554
+ function actorForPage(actor: Actor, viewerId: string, artifactId: string): Actor {
555
+ if (actor.kind !== "viewer" || actor.id === undefined) return actor;
556
+ const key = peerKey(artifactId, actor.id);
557
+ if (actor.id === viewerId) return { ...actor, key };
558
+ return { kind: "viewer", ...(actor.name !== undefined ? { name: actor.name } : {}), key };
559
+ }
560
+
561
+ /**
562
+ * How a page sees an event of a submission (CO-07, D168): its own as it is; another viewer's
563
+ * under `once` for the whole artifact as it is, since it closes every draft; otherwise only its
564
+ * `submission.created`, and only as the visibility allows: none under `private`, without a name
565
+ * or key under `counts`, named under `names`. Another viewer's deliveries tell a page nothing it
566
+ * needs, so they never reach it there.
450
567
  */
451
- function actorForPage(actor: Actor, viewerId: string): Actor {
452
- if (actor.kind !== "viewer" || actor.id === viewerId) return actor;
453
- return { kind: "viewer", ...(actor.name !== undefined ? { name: actor.name } : {}) };
568
+ function submissionShown(
569
+ event: EventRecord,
570
+ viewerId: string,
571
+ standing: SubmissionStanding,
572
+ submitterOf: (submissionId: string) => string | undefined,
573
+ ): "as-is" | "hidden" | "anonymous" {
574
+ const submitter =
575
+ event.type === "submission.created"
576
+ ? String(event.payload["viewerId"] ?? "")
577
+ : submitterOf(String(event.payload["submissionId"] ?? ""));
578
+ if (submitter === viewerId || standing.closesAll) return "as-is";
579
+ if (event.type !== "submission.created" || standing.visibility === "private") return "hidden";
580
+ return standing.visibility === "counts" ? "anonymous" : "as-is";
454
581
  }
455
582
 
456
583
  /** An event as a page sees it: other viewers' identities left out. */
@@ -467,14 +594,18 @@ function eventForPage(event: EventRecord, viewerId: string): EventRecord {
467
594
  if (event.actor.kind !== "viewer") return { ...event, payload };
468
595
  }
469
596
  const own = event.actor.kind !== "viewer" || event.actor.id === viewerId;
470
- if (own) return event;
597
+ if (own) {
598
+ return event.actor.kind === "viewer"
599
+ ? { ...event, actor: actorForPage(event.actor, viewerId, event.artifactId ?? "") }
600
+ : event;
601
+ }
471
602
  const { viewerId: _viewer, viewId: _view, ...payload } = event.payload as Record<string, unknown>;
472
603
  const causation = event.causation
473
604
  ? Object.fromEntries(Object.entries(event.causation).filter(([key]) => key !== "viewId"))
474
605
  : undefined;
475
606
  return {
476
607
  ...event,
477
- actor: actorForPage(event.actor, viewerId),
608
+ actor: actorForPage(event.actor, viewerId, event.artifactId ?? ""),
478
609
  ...(causation ? { causation } : {}),
479
610
  payload,
480
611
  };
@@ -484,11 +615,14 @@ function eventForPage(event: EventRecord, viewerId: string): EventRecord {
484
615
  function fieldsForPage(
485
616
  fields: Record<string, FieldState>,
486
617
  viewerId: string,
618
+ artifactId: string,
487
619
  ): Record<string, FieldState> {
488
620
  return Object.fromEntries(
489
621
  Object.entries(fields).map(([id, field]) => [
490
622
  id,
491
- field.updatedBy ? { ...field, updatedBy: actorForPage(field.updatedBy, viewerId) } : field,
623
+ field.updatedBy
624
+ ? { ...field, updatedBy: actorForPage(field.updatedBy, viewerId, artifactId) }
625
+ : field,
492
626
  ]),
493
627
  );
494
628
  }
@@ -524,6 +658,17 @@ export function createInteraction(options: InteractionOptions): Interaction {
524
658
  }
525
659
  };
526
660
  const tallyListeners = new Set<(artifactId: string, fields: readonly string[]) => void>();
661
+ const teamListeners = new Set<(artifactId: string) => void>();
662
+ /** Tells the team routes an artifact's respondents' status may have changed (D168). */
663
+ const touched = (artifactId: string): void => {
664
+ for (const listener of teamListeners) {
665
+ try {
666
+ listener(artifactId);
667
+ } catch (error) {
668
+ log.error("interaction.team_listener_failed", { error });
669
+ }
670
+ }
671
+ };
527
672
  const { ledger, log, hosts } = options;
528
673
  const outbox = new Outbox({
529
674
  ledger,
@@ -564,6 +709,18 @@ export function createInteraction(options: InteractionOptions): Interaction {
564
709
  ...(session.client ? { id: session.client.name } : {}),
565
710
  });
566
711
 
712
+ /** Whether a viewer is the artifact's owner (CO-07): the local user, or a hosted home's account. */
713
+ const ownerOf = (db: LedgerDb, viewerId: string): boolean => {
714
+ const row = db.get<{ kind: string; external_ref: string }>(
715
+ "SELECT kind, external_ref FROM viewer WHERE id = ?",
716
+ viewerId,
717
+ );
718
+ if (!row) return false;
719
+ return options.isOwner
720
+ ? options.isOwner({ kind: row.kind, ref: row.external_ref })
721
+ : row.kind === "local";
722
+ };
723
+
567
724
  return {
568
725
  start() {
569
726
  outbox.start();
@@ -588,8 +745,16 @@ export function createInteraction(options: InteractionOptions): Interaction {
588
745
  viewerForHost: (spec) => ledger.write((db) => viewerForHost(db, spec)),
589
746
  viewerForTailnet: (spec) => ledger.write((db) => viewerForTailnet(db, spec)),
590
747
  viewerForLink: (tokenId, name) => ledger.write((db) => viewerForLink(db, tokenId, name)),
748
+ viewerForAccount: (accountId, name) =>
749
+ ledger.write((db) => viewerForAccount(db, accountId, name)),
750
+ viewerForAnonymous: (key) => ledger.write((db) => viewerForAnonymous(db, key)),
751
+ nameAnonymous: (viewerId, name) => ledger.write((db) => nameAnonymous(db, viewerId, name)),
752
+ pause: (artifactId, change) => ledger.write((db) => setPause(db, artifactId, change)),
753
+ pauseOf: (artifactId) => ledger.read((db) => pauseOf(db, artifactId)),
591
754
  openView(input) {
592
- return ledger.write((db) => openView(db, input));
755
+ const viewId = ledger.write((db) => openView(db, input));
756
+ touched(input.artifactId);
757
+ return viewId;
593
758
  },
594
759
  viewControls(page, viewId) {
595
760
  return ledger.read((db) =>
@@ -637,18 +802,25 @@ export function createInteraction(options: InteractionOptions): Interaction {
637
802
  ...outcome.result,
638
803
  conflicts: outcome.result.conflicts.map((conflict) =>
639
804
  conflict.updatedBy
640
- ? { ...conflict, updatedBy: actorForPage(conflict.updatedBy, page.viewerId) }
805
+ ? {
806
+ ...conflict,
807
+ updatedBy: actorForPage(conflict.updatedBy, page.viewerId, page.artifactId),
808
+ }
641
809
  : conflict,
642
810
  ),
643
811
  };
644
- if (outcome.changed && input.scope === "viewer")
812
+ if (outcome.changed && input.scope === "viewer") {
645
813
  outbox.mirror(page.artifactId, page.viewerId);
814
+ touched(page.artifactId);
815
+ }
646
816
  return result;
647
817
  },
648
818
  importSubmission(envelope, source) {
649
819
  const owners = options.deliveryOwners?.(envelope.artifactId) ?? outbox.owners();
650
- const answer = ledger.write((db) =>
651
- importSubmission(db, {
820
+ let created = false;
821
+ const answer = ledger.write((db) => {
822
+ const held = db.get("SELECT 1 FROM submission WHERE id = ?", envelope.submissionId);
823
+ const result = importSubmission(db, {
652
824
  envelope,
653
825
  source,
654
826
  owners,
@@ -658,8 +830,16 @@ export function createInteraction(options: InteractionOptions): Interaction {
658
830
  artifactId,
659
831
  source.server,
660
832
  ) !== undefined,
661
- }),
662
- );
833
+ });
834
+ created =
835
+ held === undefined &&
836
+ db.get("SELECT 1 FROM submission WHERE id = ?", envelope.submissionId) !== undefined;
837
+ // An imported submission settles the roster like a local one, in its own transaction
838
+ // (D168 item 3, Opus review 5): whatever it completes is recorded with it.
839
+ if (created) settleRoster(db, envelope.artifactId, new Date().toISOString());
840
+ return result;
841
+ });
842
+ if (created) touched(envelope.artifactId);
663
843
  log.info("interaction.imported", {
664
844
  artifactId: envelope.artifactId,
665
845
  submissionId: envelope.submissionId,
@@ -667,6 +847,15 @@ export function createInteraction(options: InteractionOptions): Interaction {
667
847
  });
668
848
  return answer;
669
849
  },
850
+ resultsOf(submissionId) {
851
+ return ledger.read((db) => {
852
+ const submission = db.get<SubmissionRow>(
853
+ "SELECT * FROM submission WHERE id = ?",
854
+ submissionId,
855
+ );
856
+ return submission ? buildResults(db, submission) : undefined;
857
+ });
858
+ },
670
859
  envelopeFor(submissionId, owner) {
671
860
  return ledger.read((db) => {
672
861
  const delivery = db.get<{ id: string; attempts: number }>(
@@ -691,11 +880,23 @@ export function createInteraction(options: InteractionOptions): Interaction {
691
880
  };
692
881
  });
693
882
  },
883
+ wouldRecord(page, input) {
884
+ return ledger.read((db) =>
885
+ wouldRecord(db, {
886
+ artifactId: page.artifactId,
887
+ viewerId: page.viewerId,
888
+ ...(page.tokenId !== undefined ? { tokenId: page.tokenId } : {}),
889
+ viewId: input.viewId,
890
+ expectedRevision: input.expectedRevision,
891
+ }),
892
+ );
893
+ },
894
+
694
895
  submit(page, input) {
695
896
  const owners = options.deliveryOwners?.(page.artifactId) ?? outbox.owners();
696
897
  const outcome = asPage(() =>
697
- ledger.write((db) =>
698
- submit(db, {
898
+ ledger.write((db) => {
899
+ const made = submit(db, {
699
900
  artifactId: page.artifactId,
700
901
  viewerId: page.viewerId,
701
902
  ...(page.tokenId !== undefined ? { tokenId: page.tokenId } : {}),
@@ -704,9 +905,13 @@ export function createInteraction(options: InteractionOptions): Interaction {
704
905
  channel: input.channel,
705
906
  owners,
706
907
  covers: options.coverage,
707
- }),
708
- ),
908
+ });
909
+ // A roster completed by this submission says so in the same transaction (CO-02).
910
+ if (made.created) settleRoster(db, page.artifactId, new Date().toISOString());
911
+ return made;
912
+ }),
709
913
  );
914
+ if (outcome.created) touched(page.artifactId);
710
915
  if (outcome.tallied) {
711
916
  for (const listener of tallyListeners) {
712
917
  try {
@@ -841,7 +1046,10 @@ export function createInteraction(options: InteractionOptions): Interaction {
841
1046
  draft: documentSnapshot(db, page.artifactId, page.viewerId),
842
1047
  state: (() => {
843
1048
  const state = documentSnapshot(db, page.artifactId, null);
844
- return { ...state, fields: fieldsForPage(state.fields, page.viewerId) };
1049
+ return {
1050
+ ...state,
1051
+ fields: fieldsForPage(state.fields, page.viewerId, page.artifactId),
1052
+ };
845
1053
  })(),
846
1054
  ...(latestOwn ? { submission: forPage(submissionSummary(db, latestOwn)) } : {}),
847
1055
  ...(() => {
@@ -876,6 +1084,20 @@ export function createInteraction(options: InteractionOptions): Interaction {
876
1084
  if (!runs.has(runId)) runs.set(runId, runById(db, page.artifactId, runId));
877
1085
  return runs.get(runId);
878
1086
  };
1087
+ const standing = submissionStanding(db, page.artifactId, ownerOf(db, page.viewerId));
1088
+ const submitters = new Map<string, string | undefined>();
1089
+ const submitterOf = (submissionId: string): string | undefined => {
1090
+ if (!submitters.has(submissionId)) {
1091
+ submitters.set(
1092
+ submissionId,
1093
+ db.get<{ viewer_id: string }>(
1094
+ "SELECT viewer_id FROM submission WHERE id = ?",
1095
+ submissionId,
1096
+ )?.viewer_id,
1097
+ );
1098
+ }
1099
+ return submitters.get(submissionId);
1100
+ };
879
1101
  for (;;) {
880
1102
  const read = readEvents(db, {
881
1103
  filter: { artifacts: [page.artifactId] },
@@ -886,6 +1108,15 @@ export function createInteraction(options: InteractionOptions): Interaction {
886
1108
  if (events.length === limit) return { events, cursor: String(cursor) };
887
1109
  cursor = Number(event.cursor);
888
1110
  if (options.sentOnly && DELIVERY_EVENTS.has(event.type)) continue;
1111
+ if (event.type.startsWith("submission.")) {
1112
+ const shown = submissionShown(event, page.viewerId, standing, submitterOf);
1113
+ if (shown === "hidden") continue;
1114
+ const seen = eventForPage(event, page.viewerId);
1115
+ events.push(
1116
+ shown === "anonymous" ? { ...seen, actor: { kind: seen.actor.kind } } : seen,
1117
+ );
1118
+ continue;
1119
+ }
889
1120
  if (visibleTo(event, page, runOf)) events.push(eventForPage(event, page.viewerId));
890
1121
  }
891
1122
  cursor = Math.max(cursor, Number(read.cursor));
@@ -942,6 +1173,33 @@ export function createInteraction(options: InteractionOptions): Interaction {
942
1173
  };
943
1174
  });
944
1175
  }),
1176
+ handler(resultsListMethod, (params) => {
1177
+ const artifactId = options.artifacts.resolve(params.artifact);
1178
+ const after = params.after === undefined ? 0 : Number(params.after);
1179
+ const limit = params.limit ?? RESULTS_LIST_MAX;
1180
+ return ledger.read((db) => {
1181
+ const rows = db.all<SubmissionRow>(
1182
+ "SELECT * FROM submission WHERE artifact_id = ? AND position > ? ORDER BY position LIMIT ?",
1183
+ artifactId,
1184
+ after,
1185
+ limit + 1,
1186
+ );
1187
+ const page = rows.slice(0, limit);
1188
+ return {
1189
+ results: page.map((row) => {
1190
+ const results = buildResults(db, row);
1191
+ return params.format === "md"
1192
+ ? {
1193
+ submissionId: row.id,
1194
+ markdown: resultsMarkdown(results, JSON.parse(row.snapshot_json) as Snapshot),
1195
+ }
1196
+ : results;
1197
+ }),
1198
+ cursor: String(page.at(-1)?.position ?? after),
1199
+ more: rows.length > limit,
1200
+ };
1201
+ });
1202
+ }),
945
1203
  handler(waitMethod, (params, session) =>
946
1204
  waitFor({
947
1205
  ledger,
@@ -1170,5 +1428,52 @@ export function createInteraction(options: InteractionOptions): Interaction {
1170
1428
  return () => tallyListeners.delete(listener);
1171
1429
  },
1172
1430
  subscriptionCount: () => subscriptions.size,
1431
+
1432
+ addRespondents(db, input) {
1433
+ const added = addRespondents(db, { ...input, now: new Date().toISOString() });
1434
+ queueMicrotask(() => touched(input.artifactId));
1435
+ return added;
1436
+ },
1437
+ removeRespondents(db, input) {
1438
+ const removed = removeRespondents(db, { ...input, now: new Date().toISOString() });
1439
+ queueMicrotask(() => touched(input.artifactId));
1440
+ return removed;
1441
+ },
1442
+ roster: (artifactId, live) => ledger.read((db) => readRoster(db, artifactId, live)),
1443
+ rosterForPage(page) {
1444
+ return ledger.read((db) =>
1445
+ rosterForPage(db, {
1446
+ artifactId: page.artifactId,
1447
+ viewerId: page.viewerId,
1448
+ owner: ownerOf(db, page.viewerId),
1449
+ viewerOf: (viewerId) => viewer(db, viewerId),
1450
+ }),
1451
+ );
1452
+ },
1453
+ rostersForPages(artifactId, viewerIds) {
1454
+ return ledger.read((db) =>
1455
+ rosterForPages(db, {
1456
+ artifactId,
1457
+ pages: viewerIds.map((viewerId) => ({ viewerId, owner: ownerOf(db, viewerId) })),
1458
+ viewerOf: (viewerId) => viewer(db, viewerId),
1459
+ }),
1460
+ );
1461
+ },
1462
+ visibility: (artifactId) => ledger.read((db) => teamVisibility(db, artifactId)),
1463
+ isOwner: (viewerId) => ledger.read((db) => ownerOf(db, viewerId)),
1464
+ peer(artifactId, viewerId) {
1465
+ const record = ledger.read((db) => viewer(db, viewerId));
1466
+ return {
1467
+ key: peerKey(artifactId, viewerId),
1468
+ id: record.id,
1469
+ kind: record.kind,
1470
+ ...(record.name !== undefined ? { name: record.name } : {}),
1471
+ ...(record.verified !== undefined ? { verified: record.verified } : {}),
1472
+ };
1473
+ },
1474
+ onTeam(listener) {
1475
+ teamListeners.add(listener);
1476
+ return () => teamListeners.delete(listener);
1477
+ },
1173
1478
  };
1174
1479
  }
@@ -0,0 +1,106 @@
1
+ /**
2
+ * Pausing an artifact (D165 item 14, RM-09): a paused artifact stays viewable and its shell says
3
+ * so; it takes no submissions (the submit transaction refuses them) and runs no actions until it
4
+ * is resumed, and every draft is kept. The owner pauses and resumes its own pause; an operator's
5
+ * pause is resumed only by the operator. One row per party that paused it (`artifact_pause`,
6
+ * DATA_MODEL §7.2), in local and hosted homes alike; each change appends `artifact.paused` or
7
+ * `artifact.resumed`, so open pages learn of it.
8
+ */
9
+ import { createDiagnostic, type PausedBy, RpcError } from "@mostra/protocol";
10
+ import type { LedgerDb } from "../ledger/index.ts";
11
+ import { appendEvent } from "./events.ts";
12
+
13
+ /** An artifact's pause, while it is paused. */
14
+ export interface Pause {
15
+ readonly by: PausedBy;
16
+ readonly reason?: string;
17
+ readonly at: string;
18
+ }
19
+
20
+ /**
21
+ * The artifact's pause, or `undefined` when it isn't paused: the operator's when both paused it,
22
+ * since only the operator lifts that one.
23
+ */
24
+ export function pauseOf(db: LedgerDb, artifactId: string): Pause | undefined {
25
+ const row = db.get<{ by: PausedBy; reason: string | null; paused_at: string }>(
26
+ "SELECT by, reason, paused_at FROM artifact_pause WHERE artifact_id = ? ORDER BY by = 'operator' DESC LIMIT 1",
27
+ artifactId,
28
+ );
29
+ return row
30
+ ? { by: row.by, ...(row.reason !== null ? { reason: row.reason } : {}), at: row.paused_at }
31
+ : undefined;
32
+ }
33
+
34
+ /**
35
+ * Pauses or resumes an artifact, in the caller's write transaction, as `by`. The owner's pause and
36
+ * the operator's are kept apart (one row each): pausing again keeps the earlier pause of the same
37
+ * party, and a resume lifts only its own party's, so the artifact takes answers again once no
38
+ * pause is left. The owner resuming while the operator's pause stands is
39
+ * `MOSTRA_REMOTE_PAUSED_BY_OPERATOR`, and changes nothing.
40
+ */
41
+ export function setPause(
42
+ db: LedgerDb,
43
+ artifactId: string,
44
+ change: { readonly paused: boolean; readonly by: PausedBy; readonly reason?: string },
45
+ ): { readonly paused: boolean; readonly by?: PausedBy } {
46
+ const own = db.get<{ by: PausedBy }>(
47
+ "SELECT by FROM artifact_pause WHERE artifact_id = ? AND by = ?",
48
+ artifactId,
49
+ change.by,
50
+ );
51
+ const actor = change.by === "operator" ? { kind: "mostra" as const } : { kind: "agent" as const };
52
+ if (change.paused) {
53
+ if (!own) {
54
+ const before = pauseOf(db, artifactId);
55
+ db.run(
56
+ "INSERT INTO artifact_pause (artifact_id, by, reason, paused_at) VALUES (?, ?, ?, ?)",
57
+ artifactId,
58
+ change.by,
59
+ change.reason ?? null,
60
+ new Date().toISOString(),
61
+ );
62
+ // Open pages learn of a change they can see: a first pause, or the operator's over the owner's.
63
+ if (before === undefined || change.by === "operator") {
64
+ appendEvent(db, {
65
+ artifactId,
66
+ type: "artifact.paused",
67
+ actor,
68
+ payload: {
69
+ by: change.by,
70
+ ...(change.reason !== undefined ? { reason: change.reason } : {}),
71
+ },
72
+ });
73
+ }
74
+ }
75
+ const now = pauseOf(db, artifactId) as Pause;
76
+ return { paused: true, by: now.by };
77
+ }
78
+ // The owner can't lift a pause while the operator's stands: nothing changes, its own included.
79
+ if (change.by === "owner" && pauseOf(db, artifactId)?.by === "operator") {
80
+ throw new RpcError(
81
+ createDiagnostic("MOSTRA_REMOTE_PAUSED_BY_OPERATOR", {
82
+ message: "The server's operator paused this artifact; only the operator resumes it.",
83
+ }),
84
+ );
85
+ }
86
+ if (own) {
87
+ db.run("DELETE FROM artifact_pause WHERE artifact_id = ? AND by = ?", artifactId, change.by);
88
+ }
89
+ const left = pauseOf(db, artifactId);
90
+ if (left === undefined) {
91
+ if (own) {
92
+ appendEvent(db, { artifactId, type: "artifact.resumed", actor, payload: { by: change.by } });
93
+ }
94
+ return { paused: false };
95
+ }
96
+ // The operator lifted its own pause; the owner's stays, and so does the page's notice.
97
+ if (own) {
98
+ appendEvent(db, {
99
+ artifactId,
100
+ type: "artifact.paused",
101
+ actor: { kind: "agent" },
102
+ payload: { by: left.by, ...(left.reason !== undefined ? { reason: left.reason } : {}) },
103
+ });
104
+ }
105
+ return { paused: true, by: left.by };
106
+ }