@mostra/protocol 0.8.0 → 0.10.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 (224) hide show
  1. package/dist/actions.d.ts +30 -4
  2. package/dist/actions.d.ts.map +1 -1
  3. package/dist/actions.js +14 -4
  4. package/dist/actions.js.map +1 -1
  5. package/dist/artifact.d.ts +2 -1
  6. package/dist/artifact.d.ts.map +1 -1
  7. package/dist/artifact.js +2 -1
  8. package/dist/artifact.js.map +1 -1
  9. package/dist/browser.d.ts +5 -0
  10. package/dist/browser.d.ts.map +1 -1
  11. package/dist/browser.js +7 -2
  12. package/dist/browser.js.map +1 -1
  13. package/dist/capability.d.ts +0 -9
  14. package/dist/capability.d.ts.map +1 -1
  15. package/dist/capability.js +1 -17
  16. package/dist/capability.js.map +1 -1
  17. package/dist/diagnostics/codes/artifact.d.ts +1 -1
  18. package/dist/diagnostics/codes/artifact.d.ts.map +1 -1
  19. package/dist/diagnostics/codes/artifact.js +45 -1
  20. package/dist/diagnostics/codes/artifact.js.map +1 -1
  21. package/dist/diagnostics/codes/env.d.ts +1 -1
  22. package/dist/diagnostics/codes/env.d.ts.map +1 -1
  23. package/dist/diagnostics/codes/env.js +12 -1
  24. package/dist/diagnostics/codes/env.js.map +1 -1
  25. package/dist/diagnostics/codes/home.d.ts +1 -1
  26. package/dist/diagnostics/codes/home.d.ts.map +1 -1
  27. package/dist/diagnostics/codes/home.js +12 -1
  28. package/dist/diagnostics/codes/home.js.map +1 -1
  29. package/dist/diagnostics/codes/index.d.ts +3 -2
  30. package/dist/diagnostics/codes/index.d.ts.map +1 -1
  31. package/dist/diagnostics/codes/index.js +3 -1
  32. package/dist/diagnostics/codes/index.js.map +1 -1
  33. package/dist/diagnostics/codes/remote.d.ts +8 -0
  34. package/dist/diagnostics/codes/remote.d.ts.map +1 -0
  35. package/dist/diagnostics/codes/remote.js +99 -0
  36. package/dist/diagnostics/codes/remote.js.map +1 -0
  37. package/dist/diagnostics/codes/submit.js +3 -3
  38. package/dist/diagnostics/codes/submit.js.map +1 -1
  39. package/dist/diagnostics/diagnostic.d.ts +1 -1
  40. package/dist/diagnostics/diagnostic.d.ts.map +1 -1
  41. package/dist/diagnostics/diagnostic.js +2 -1
  42. package/dist/diagnostics/diagnostic.js.map +1 -1
  43. package/dist/duration.d.ts +13 -0
  44. package/dist/duration.d.ts.map +1 -0
  45. package/dist/duration.js +27 -0
  46. package/dist/duration.js.map +1 -0
  47. package/dist/hygiene.d.ts +4 -1
  48. package/dist/hygiene.d.ts.map +1 -1
  49. package/dist/hygiene.js +4 -0
  50. package/dist/hygiene.js.map +1 -1
  51. package/dist/ids.d.ts +17 -1
  52. package/dist/ids.d.ts.map +1 -1
  53. package/dist/ids.js +9 -1
  54. package/dist/ids.js.map +1 -1
  55. package/dist/index.d.ts +30 -8
  56. package/dist/index.js +30 -8
  57. package/dist/interaction.d.ts +28 -2
  58. package/dist/interaction.d.ts.map +1 -1
  59. package/dist/interaction.js +20 -5
  60. package/dist/interaction.js.map +1 -1
  61. package/dist/manifest.d.ts +59 -14
  62. package/dist/manifest.d.ts.map +1 -1
  63. package/dist/manifest.js +63 -15
  64. package/dist/manifest.js.map +1 -1
  65. package/dist/methods/artifact/export.d.ts +40 -0
  66. package/dist/methods/artifact/export.d.ts.map +1 -0
  67. package/dist/methods/artifact/export.js +36 -0
  68. package/dist/methods/artifact/export.js.map +1 -0
  69. package/dist/methods/artifact/import.d.ts +23 -0
  70. package/dist/methods/artifact/import.d.ts.map +1 -0
  71. package/dist/methods/artifact/import.js +25 -0
  72. package/dist/methods/artifact/import.js.map +1 -0
  73. package/dist/methods/artifact/publish.d.ts +2 -1
  74. package/dist/methods/artifact/publish.d.ts.map +1 -1
  75. package/dist/methods/artifact/publish.js +1 -1
  76. package/dist/methods/hosted/push.d.ts +76 -0
  77. package/dist/methods/hosted/push.d.ts.map +1 -0
  78. package/dist/methods/hosted/push.js +71 -0
  79. package/dist/methods/hosted/push.js.map +1 -0
  80. package/dist/methods/hosted/submission.d.ts +18 -0
  81. package/dist/methods/hosted/submission.d.ts.map +1 -0
  82. package/dist/methods/hosted/submission.js +23 -0
  83. package/dist/methods/hosted/submission.js.map +1 -0
  84. package/dist/methods/index.d.ts.map +1 -1
  85. package/dist/methods/index.js +38 -2
  86. package/dist/methods/index.js.map +1 -1
  87. package/dist/methods/instance/status.d.ts +3 -0
  88. package/dist/methods/instance/status.d.ts.map +1 -1
  89. package/dist/methods/instance/status.js +3 -1
  90. package/dist/methods/instance/status.js.map +1 -1
  91. package/dist/methods/mostra/initialize.d.ts +17 -3
  92. package/dist/methods/mostra/initialize.d.ts.map +1 -1
  93. package/dist/methods/mostra/initialize.js +11 -3
  94. package/dist/methods/mostra/initialize.js.map +1 -1
  95. package/dist/methods/port/relay-call.d.ts +33 -0
  96. package/dist/methods/port/relay-call.d.ts.map +1 -0
  97. package/dist/methods/port/relay-call.js +31 -0
  98. package/dist/methods/port/relay-call.js.map +1 -0
  99. package/dist/methods/port/relay-cancel.d.ts +16 -0
  100. package/dist/methods/port/relay-cancel.d.ts.map +1 -0
  101. package/dist/methods/port/relay-cancel.js +21 -0
  102. package/dist/methods/port/relay-cancel.js.map +1 -0
  103. package/dist/methods/port/relay-live.d.ts +25 -0
  104. package/dist/methods/port/relay-live.d.ts.map +1 -0
  105. package/dist/methods/port/relay-live.js +32 -0
  106. package/dist/methods/port/relay-live.js.map +1 -0
  107. package/dist/methods/port/relay-reconcile.d.ts +39 -0
  108. package/dist/methods/port/relay-reconcile.d.ts.map +1 -0
  109. package/dist/methods/port/relay-reconcile.js +35 -0
  110. package/dist/methods/port/relay-reconcile.js.map +1 -0
  111. package/dist/methods/port/relay-run.d.ts +47 -0
  112. package/dist/methods/port/relay-run.d.ts.map +1 -0
  113. package/dist/methods/port/relay-run.js +41 -0
  114. package/dist/methods/port/relay-run.js.map +1 -0
  115. package/dist/methods/port/submissions-deliver.d.ts +8 -0
  116. package/dist/methods/port/submissions-deliver.d.ts.map +1 -1
  117. package/dist/methods/port/submissions-deliver.js +4 -2
  118. package/dist/methods/port/submissions-deliver.js.map +1 -1
  119. package/dist/methods/relay/call-batch.d.ts +26 -0
  120. package/dist/methods/relay/call-batch.d.ts.map +1 -0
  121. package/dist/methods/relay/call-batch.js +30 -0
  122. package/dist/methods/relay/call-batch.js.map +1 -0
  123. package/dist/methods/relay/effect.d.ts +31 -0
  124. package/dist/methods/relay/effect.d.ts.map +1 -0
  125. package/dist/methods/relay/effect.js +30 -0
  126. package/dist/methods/relay/effect.js.map +1 -0
  127. package/dist/methods/relay/live-value.d.ts +33 -0
  128. package/dist/methods/relay/live-value.d.ts.map +1 -0
  129. package/dist/methods/relay/live-value.js +32 -0
  130. package/dist/methods/relay/live-value.js.map +1 -0
  131. package/dist/methods/relay/run-update.d.ts +46 -0
  132. package/dist/methods/relay/run-update.d.ts.map +1 -0
  133. package/dist/methods/relay/run-update.js +45 -0
  134. package/dist/methods/relay/run-update.js.map +1 -0
  135. package/dist/methods/remote/login-wait.d.ts +30 -0
  136. package/dist/methods/remote/login-wait.d.ts.map +1 -0
  137. package/dist/methods/remote/login-wait.js +36 -0
  138. package/dist/methods/remote/login-wait.js.map +1 -0
  139. package/dist/methods/remote/login.d.ts +41 -0
  140. package/dist/methods/remote/login.d.ts.map +1 -0
  141. package/dist/methods/remote/login.js +37 -0
  142. package/dist/methods/remote/login.js.map +1 -0
  143. package/dist/methods/remote/logout.d.ts +25 -0
  144. package/dist/methods/remote/logout.d.ts.map +1 -0
  145. package/dist/methods/remote/logout.js +28 -0
  146. package/dist/methods/remote/logout.js.map +1 -0
  147. package/dist/methods/remote/status.d.ts +14 -0
  148. package/dist/methods/remote/status.d.ts.map +1 -0
  149. package/dist/methods/remote/status.js +22 -0
  150. package/dist/methods/remote/status.js.map +1 -0
  151. package/dist/methods/remote/token.d.ts +19 -0
  152. package/dist/methods/remote/token.d.ts.map +1 -0
  153. package/dist/methods/remote/token.js +24 -0
  154. package/dist/methods/remote/token.js.map +1 -0
  155. package/dist/methods/share/start.d.ts +5 -2
  156. package/dist/methods/share/start.d.ts.map +1 -1
  157. package/dist/methods/share/start.js +6 -3
  158. package/dist/methods/share/start.js.map +1 -1
  159. package/dist/methods/state/patch.d.ts +7 -0
  160. package/dist/methods/state/patch.d.ts.map +1 -1
  161. package/dist/methods/state/patch.js +2 -1
  162. package/dist/methods/state/patch.js.map +1 -1
  163. package/dist/methods/view/url.d.ts +2 -1
  164. package/dist/methods/view/url.d.ts.map +1 -1
  165. package/dist/methods/view/url.js +2 -1
  166. package/dist/methods/view/url.js.map +1 -1
  167. package/dist/policy.d.ts +18 -0
  168. package/dist/policy.d.ts.map +1 -0
  169. package/dist/policy.js +23 -0
  170. package/dist/policy.js.map +1 -0
  171. package/dist/remote.d.ts +55 -0
  172. package/dist/remote.d.ts.map +1 -0
  173. package/dist/remote.js +52 -0
  174. package/dist/remote.js.map +1 -0
  175. package/dist/view.d.ts +1 -1
  176. package/dist/view.js +1 -1
  177. package/dist/view.js.map +1 -1
  178. package/package.json +2 -2
  179. package/schemas/protocol.draft-07.json +1607 -126
  180. package/schemas/protocol.schema.json +1543 -126
  181. package/src/actions.ts +45 -5
  182. package/src/browser.ts +6 -0
  183. package/src/capability.ts +0 -23
  184. package/src/diagnostics/codes/artifact.ts +48 -0
  185. package/src/diagnostics/codes/env.ts +12 -0
  186. package/src/diagnostics/codes/home.ts +12 -0
  187. package/src/diagnostics/codes/index.ts +6 -2
  188. package/src/diagnostics/codes/remote.ts +113 -0
  189. package/src/diagnostics/codes/submit.ts +3 -3
  190. package/src/diagnostics/diagnostic.ts +3 -1
  191. package/src/duration.ts +29 -0
  192. package/src/hygiene.ts +12 -1
  193. package/src/ids.ts +33 -1
  194. package/src/index.ts +124 -8
  195. package/src/interaction.ts +42 -2
  196. package/src/manifest.ts +115 -24
  197. package/src/methods/artifact/export.ts +68 -0
  198. package/src/methods/artifact/import.ts +39 -0
  199. package/src/methods/hosted/push.ts +146 -0
  200. package/src/methods/hosted/submission.ts +34 -0
  201. package/src/methods/index.ts +36 -0
  202. package/src/methods/instance/status.ts +4 -0
  203. package/src/methods/mostra/initialize.ts +19 -3
  204. package/src/methods/port/relay-call.ts +58 -0
  205. package/src/methods/port/relay-cancel.ts +33 -0
  206. package/src/methods/port/relay-live.ts +48 -0
  207. package/src/methods/port/relay-reconcile.ts +71 -0
  208. package/src/methods/port/relay-run.ts +80 -0
  209. package/src/methods/port/submissions-deliver.ts +13 -1
  210. package/src/methods/relay/call-batch.ts +52 -0
  211. package/src/methods/relay/effect.ts +55 -0
  212. package/src/methods/relay/live-value.ts +54 -0
  213. package/src/methods/relay/run-update.ts +81 -0
  214. package/src/methods/remote/login-wait.ts +55 -0
  215. package/src/methods/remote/login.ts +72 -0
  216. package/src/methods/remote/logout.ts +42 -0
  217. package/src/methods/remote/status.ts +34 -0
  218. package/src/methods/remote/token.ts +39 -0
  219. package/src/methods/share/start.ts +12 -4
  220. package/src/methods/state/patch.ts +6 -0
  221. package/src/methods/view/url.ts +2 -1
  222. package/src/policy.ts +30 -0
  223. package/src/remote.ts +89 -0
  224. package/src/view.ts +1 -1
package/dist/index.js CHANGED
@@ -1,6 +1,8 @@
1
- import { ArtifactId, CommentId, Cursor, DeliveryId, MutationId, RunId, ShareId, SubmissionId, ThreadId, TokenId, VersionId, ViewId, ViewerId } from "./ids.js";
2
- import { ACTION_ARGS_MAX, ACTION_RESULT_MAX, ActionError, Batches, CallRequest, LIVE_KEY_PATTERN, LIVE_RING_DEFAULT, LIVE_RING_MAX, LIVE_VALUE_MAX, LiveRequest, RUN_KEY_MAX, RUN_LOG_MAX, RUN_LOG_TRUNCATED, RUN_STATUSES, RunAttachRequest, RunCancelRequest, RunProgress, RunRequest, RunState, SECRET_NAME_PATTERN, SECRET_VALUE_MAX, isFinalRunStatus } from "./actions.js";
3
- import { ARTIFACT_MANIFEST_KEYS, ArtifactLink, ArtifactManifest, SubmissionPolicy } from "./manifest.js";
1
+ import { AccountId, ArtifactId, CommentId, Cursor, DeliveryId, HomeId, LinkId, MutationId, RouteId, RunId, ShareId, SubmissionId, ThreadId, TokenId, VersionId, ViewId, ViewerId } from "./ids.js";
2
+ import { ACTION_ARGS_MAX, ACTION_RESULT_MAX, ActionError, Batches, CallRequest, LIVE_KEY_PATTERN, LIVE_RING_DEFAULT, LIVE_RING_MAX, LIVE_VALUE_MAX, LiveRequest, READABLE_LIVE_KEY_PATTERN, RUN_KEY_MAX, RUN_LOG_MAX, RUN_LOG_TRUNCATED, RUN_STATUSES, RunAttachRequest, RunCancelRequest, RunProgress, RunRequest, RunState, SECRET_NAME_PATTERN, SECRET_VALUE_MAX, TALLY_LIVE_PREFIX, isFinalRunStatus } from "./actions.js";
3
+ import { Duration, durationMs } from "./duration.js";
4
+ import { SubmissionPolicy } from "./policy.js";
5
+ import { ARTIFACT_MANIFEST_KEYS, ArtifactLink, ArtifactManifest, HOSTED_OFFLINE_LIMIT_DEFAULT, HOSTED_OFFLINE_LIMIT_MAX_MS, HostedSettings, TALLY_CHOICES_MAX, TALLY_CHOICES_MIN, TallySpec, manifestProblem } from "./manifest.js";
4
6
  import { ArtifactDetail, ArtifactRef, ArtifactSummary, PublishReceipt, SourceRef, VersionSummary } from "./artifact.js";
5
7
  import { DIAGNOSTIC_AREAS, Diagnostic, DiagnosticFix, DiagnosticLocation, DiagnosticPhase, DiagnosticSeverity } from "./diagnostics/diagnostic.js";
6
8
  import { DEFAULT_DOCS_BASE, docsUrl } from "./diagnostics/spec.js";
@@ -10,11 +12,11 @@ import { receivable } from "./receive.js";
10
12
  import { RpcPeer, parseParams } from "./rpc/peer.js";
11
13
  import { ControlsPolicy, REVIEW_SET_ID_PATTERN, SubmitChannel, TrustedControl, VersionRef, ViewContext, ViewContextWire, readViewContext } from "./view.js";
12
14
  import { BRIDGE_FIELDS_MAX, BRIDGE_MESSAGES, BRIDGE_TEXT_MAX, CONTROL_LABEL_MAX, MCP_APPS_PROTOCOL_VERSION, OPEN_LINK_SCHEMES, connectBridge, mostraControlsRequest, mostraFieldFocus, mostraFields, mostraFlush, mostraFrameSessionEntered, mostraFrameSessionFailed, mostraPage, mostraReady, mostraVersionAvailable, uiInitialize, uiInitialized, uiOpenLink, uiSizeChanged } from "./bridge.js";
13
- import { Actor, DeliveryStatus, DocumentRevision, EventFilter, EventRecord, EventTypePattern, FIELD_ID_MAX_LENGTH, FieldConflict, FieldOp, FieldState, MutationResult, ResultComment, Results, SIGNAL_NAME_PATTERN, SubmissionSummary, Viewer, ViewerSpec, WaitCondition, isFieldId } from "./interaction.js";
14
- import { BROWSER_PROTOCOL_REVISION, BROWSER_PROTOCOL_REVISIONS, CarryOver, ChooseRequest, DocumentSnapshot, EnterRequest, EnterResult, FRAME_SESSION_HEADER, FieldsRequest, FollowRequest, FrameSessionFacts, FrameTicket, OrphanedField, PollResult, SIGNAL_PAYLOAD_MAX_BYTES, ShellSubmitRequest, SignalRequest, StreamSnapshot, StreamTicket, StreamTicketRequest, SubmitRequest } from "./browser.js";
15
+ import { Actor, DeliveryStatus, DocumentRevision, EventFilter, EventOrigin, EventRecord, EventTypePattern, FIELD_ID_MAX_LENGTH, FieldConflict, FieldOp, FieldState, MutationResult, ResultComment, Results, SIGNAL_NAME_PATTERN, SubmissionSummary, Viewer, ViewerSpec, WaitCondition, isFieldId } from "./interaction.js";
16
+ import { BROWSER_PROTOCOL_REVISION, BROWSER_PROTOCOL_REVISIONS, CarryOver, ChooseRequest, DocumentSnapshot, EnterRequest, EnterResult, FRAME_SESSION_HEADER, FieldsRequest, FollowRequest, FrameSessionFacts, FrameTicket, OrphanedField, PollResult, SHELL_SESSION_HEADER, SIGNAL_PAYLOAD_MAX_BYTES, ShellSubmitRequest, SignalRequest, StreamSnapshot, StreamTicket, StreamTicketRequest, SubmitRequest } from "./browser.js";
15
17
  import { BUNDLE_NAME, BUNDLE_PLATFORMS, BUNDLE_SETUP_MARKER, BundleAsset, BundleBrowser, BundleFileEntry, BundleFiles, BundleInfo, BundleLinkEntry, BundlePins, BundlePlatformSchema, BundleSetup, bundleAssetName, isWindowsBundle } from "./bundle.js";
16
18
  import { canonicalJson } from "./canonical.js";
17
- import { ALL_SCOPES, CapabilityScope, Duration, durationMs, normalizeScopes, scopeAllows } from "./capability.js";
19
+ import { ALL_SCOPES, CapabilityScope, normalizeScopes, scopeAllows } from "./capability.js";
18
20
  import { a11yDiagnosticCodes } from "./diagnostics/codes/a11y.js";
19
21
  import { actionDiagnosticCodes } from "./diagnostics/codes/action.js";
20
22
  import { artifactDiagnosticCodes } from "./diagnostics/codes/artifact.js";
@@ -33,6 +35,7 @@ import { networkDiagnosticCodes } from "./diagnostics/codes/network.js";
33
35
  import { platformDiagnosticCodes } from "./diagnostics/codes/platform.js";
34
36
  import { publishDiagnosticCodes } from "./diagnostics/codes/publish.js";
35
37
  import { regressionDiagnosticCodes } from "./diagnostics/codes/regression.js";
38
+ import { remoteDiagnosticCodes } from "./diagnostics/codes/remote.js";
36
39
  import { runtimeDiagnosticCodes } from "./diagnostics/codes/runtime.js";
37
40
  import { secretDiagnosticCodes } from "./diagnostics/codes/secret.js";
38
41
  import { shareDiagnosticCodes } from "./diagnostics/codes/share.js";
@@ -45,7 +48,9 @@ import { createDiagnostic, diagnosticCatalog } from "./diagnostics/codes/index.j
45
48
  import { CSRF_HEADER, checkRequest, headerValue, isJsonContentType, refusal, safeEqual, safePath } from "./hygiene.js";
46
49
  import { defineMethod } from "./method.js";
47
50
  import { artifactCreateMethod } from "./methods/artifact/create.js";
51
+ import { ExportClass, artifactExportMethod } from "./methods/artifact/export.js";
48
52
  import { artifactGetMethod } from "./methods/artifact/get.js";
53
+ import { artifactImportMethod } from "./methods/artifact/import.js";
49
54
  import { artifactListMethod } from "./methods/artifact/list.js";
50
55
  import { artifactPublishMethod } from "./methods/artifact/publish.js";
51
56
  import { ARTIFACT_PROGRESS, ArtifactProgressParams, DEFAULT_VIEWPORTS, ScreenshotPolicy, VERIFY_PROBE, VERIFY_REPORT, VERIFY_RUNNER_METHODS, VerifyVerdict, ariaSummary, estimateImageTokens, viewportsFor } from "./verify.js";
@@ -58,7 +63,11 @@ import { EVENTS_READ_MAX, eventsReadMethod } from "./methods/events/read.js";
58
63
  import { EVENTS_NOTIFY, EventsNotifyParams, eventsSubscribeMethod } from "./methods/events/subscribe.js";
59
64
  import { eventsUnsubscribeMethod } from "./methods/events/unsubscribe.js";
60
65
  import { gcRunMethod } from "./methods/gc/run.js";
66
+ import { HostedRoute, VersionPush, hostedPushMethod } from "./methods/hosted/push.js";
67
+ import { SubmissionEnvelope, portSubmissionsDeliverMethod } from "./methods/port/submissions-deliver.js";
68
+ import { hostedSubmissionMethod } from "./methods/hosted/submission.js";
61
69
  import { instanceCheckMethod } from "./methods/instance/check.js";
70
+ import { OwnerLinkInfo, RemoteLink, ServerOrigin } from "./remote.js";
62
71
  import { HOST_PROTOCOL_REVISIONS, Revision, negotiateRevision } from "./revision.js";
63
72
  import { CLI_CLIENT_NAME, ClientCapabilities, ClientInfo, DependencyPolicy, HomeConfig, InstanceCapabilities, InstanceInfo, PortName, mostraInitializeMethod } from "./methods/mostra/initialize.js";
64
73
  import { PUBLIC_SHARE_DEFAULT_TTL, PUBLIC_SHARE_MAX_TTL_MS, Share, ShareVia, shareStartMethod } from "./methods/share/start.js";
@@ -68,10 +77,23 @@ import { mostraShutdownMethod } from "./methods/mostra/shutdown.js";
68
77
  import { ExternalBase, OriginString, portAddressingExternalBaseMethod } from "./methods/port/addressing-external-base.js";
69
78
  import { DraftMirror, portDraftsMirrorMethod } from "./methods/port/drafts-mirror.js";
70
79
  import { portIdentityResolveMethod } from "./methods/port/identity-resolve.js";
80
+ import { RelayViewer, portRelayRunMethod } from "./methods/port/relay-run.js";
81
+ import { portRelayCallMethod } from "./methods/port/relay-call.js";
82
+ import { portRelayCancelMethod } from "./methods/port/relay-cancel.js";
83
+ import { portRelayLiveMethod } from "./methods/port/relay-live.js";
84
+ import { portRelayReconcileMethod } from "./methods/port/relay-reconcile.js";
71
85
  import { portSecretsGetMethod } from "./methods/port/secrets-get.js";
72
- import { SubmissionEnvelope, portSubmissionsDeliverMethod } from "./methods/port/submissions-deliver.js";
73
86
  import { portTrustedControlsActivatedMethod } from "./methods/port/trusted-controls-activated.js";
74
87
  import { portTrustedControlsPolicyMethod } from "./methods/port/trusted-controls-policy.js";
88
+ import { relayCallBatchMethod } from "./methods/relay/call-batch.js";
89
+ import { relayEffectMethod } from "./methods/relay/effect.js";
90
+ import { relayLiveValueMethod } from "./methods/relay/live-value.js";
91
+ import { relayRunUpdateMethod } from "./methods/relay/run-update.js";
92
+ import { remoteLoginMethod } from "./methods/remote/login.js";
93
+ import { remoteLoginWaitMethod } from "./methods/remote/login-wait.js";
94
+ import { remoteLogoutMethod } from "./methods/remote/logout.js";
95
+ import { remoteStatusMethod } from "./methods/remote/status.js";
96
+ import { remoteTokenMethod } from "./methods/remote/token.js";
75
97
  import { ResultsMarkdown, resultsGetMethod } from "./methods/results/get.js";
76
98
  import { secretDeleteMethod } from "./methods/secret/delete.js";
77
99
  import { SecretEntry, secretSetMethod } from "./methods/secret/set.js";
@@ -90,4 +112,4 @@ import { hostMethods, hostNotifications } from "./methods/index.js";
90
112
  import { LineSplitter, MAX_LINE_LENGTH, encodeLine } from "./rpc/lines.js";
91
113
  import { ARGUMENT_BIGINT_DIGITS_MAX, RemoteError, SerializationError, UNSERIALIZABLE_CODE, ValueReader, ValueWriter, checkArgumentFrames, deserializeAll, fromBase64, serializeAll, toBase64, wireError } from "./serializer.js";
92
114
  import { DEFAULT_WORKER_LIMITS, ServerEmitParams, ServerLiveValueParams, ServerLogParams, ServerProgressParams, ServerSecretParams, ServerSignalParams, ServerStateGetParams, ServerStatePatchParams, WORKER_CHANNEL_REVISION, WORKER_METHODS, WorkerBatchParams, WorkerCallOutcome, WorkerCallParams, WorkerPingResult, WorkerStartParams, WorkerStartResult, WorkerVersionRef } from "./worker.js";
93
- export { ACTION_ARGS_MAX, ACTION_RESULT_MAX, ALL_SCOPES, ARGUMENT_BIGINT_DIGITS_MAX, ARTIFACT_MANIFEST_KEYS, ARTIFACT_PROGRESS, ActionError, Actor, AddedPackage, ArtifactDetail, ArtifactId, ArtifactLink, ArtifactManifest, ArtifactProgressParams, ArtifactRef, ArtifactSummary, BRIDGE_FIELDS_MAX, BRIDGE_MESSAGES, BRIDGE_TEXT_MAX, BROWSER_PROTOCOL_REVISION, BROWSER_PROTOCOL_REVISIONS, BUNDLE_NAME, BUNDLE_PLATFORMS, BUNDLE_SETUP_MARKER, Batches, BundleAsset, BundleBrowser, BundleFileEntry, BundleFiles, BundleInfo, BundleLinkEntry, BundlePins, BundlePlatformSchema, BundleSetup, CLI_CLIENT_NAME, CONTROL_LABEL_MAX, CSRF_HEADER, CallRequest, CapabilityLink, CapabilityScope, CarryOver, ChildProcessStatus, ChooseRequest, ClientCapabilities, ClientInfo, CommentId, ControlsPolicy, Cursor, DEFAULT_DOCS_BASE, DEFAULT_VIEWPORTS, DEFAULT_WORKER_LIMITS, DEV_NOTIFY, DIAGNOSTIC_AREAS, DeliveryCounts, DeliveryId, DeliveryStatus, DependencyPolicy, DevNotifyParams, Diagnostic, DiagnosticFix, DiagnosticLocation, DiagnosticPhase, DiagnosticSeverity, DocumentRevision, DocumentSnapshot, DraftMirror, Duration, EVENTS_NOTIFY, EVENTS_READ_MAX, EnterRequest, EnterResult, EventFilter, EventRecord, EventTypePattern, EventsNotifyParams, ExternalBase, FIELD_ID_MAX_LENGTH, FRAME_SESSION_HEADER, FieldConflict, FieldOp, FieldState, FieldsRequest, FollowRequest, FrameSessionFacts, FrameTicket, GatewayStatus, HOST_PROTOCOL_REVISIONS, HomeConfig, InstanceCapabilities, InstanceInfo, JSON_RPC_ERROR_CODES, JsonRpcErrorObject, JsonRpcFailure, JsonRpcNotification, JsonRpcRequest, JsonRpcSuccess, LIVE_KEY_PATTERN, LIVE_RING_DEFAULT, LIVE_RING_MAX, LIVE_VALUE_MAX, LineSplitter, LiveRequest, MAX_LINE_LENGTH, MCP_APPS_PROTOCOL_VERSION, MutationId, MutationResult, OPEN_LINK_SCHEMES, OriginString, OrphanedField, PUBLIC_SHARE_DEFAULT_TTL, PUBLIC_SHARE_MAX_TTL_MS, PollResult, PortName, PublishReceipt, REVIEW_SET_ID_PATTERN, RUN_KEY_MAX, RUN_LOG_MAX, RUN_LOG_TRUNCATED, RUN_STATUSES, RemoteError, ResultComment, Results, ResultsMarkdown, Revision, RpcError, RpcPeer, RunAttachRequest, RunCancelRequest, RunId, RunProgress, RunRequest, RunState, SECRET_NAME_PATTERN, SECRET_VALUE_MAX, SIGNAL_NAME_PATTERN, SIGNAL_PAYLOAD_MAX_BYTES, ScreenshotPolicy, SecretEntry, SerializationError, ServerEmitParams, ServerLiveValueParams, ServerLogParams, ServerProgressParams, ServerSecretParams, ServerSignalParams, ServerStateGetParams, ServerStatePatchParams, Share, ShareId, ShareVia, ShellSubmitRequest, SignalRequest, SourceRef, StreamSnapshot, StreamTicket, StreamTicketRequest, SubmissionEnvelope, SubmissionId, SubmissionPolicy, SubmissionSummary, SubmitChannel, SubmitRequest, ThreadId, TokenId, TrustedControl, UNSERIALIZABLE_CODE, VERIFY_PROBE, VERIFY_REPORT, VERIFY_RUNNER_METHODS, ValueReader, ValueWriter, VerifyVerdict, VersionId, VersionRef, VersionSummary, ViewContext, ViewContextWire, ViewId, Viewer, ViewerId, ViewerSpec, WAIT_MAX_MS, WORKER_CHANNEL_REVISION, WORKER_METHODS, WaitCondition, WorkerBatchParams, WorkerCallOutcome, WorkerCallParams, WorkerPingResult, WorkerStartParams, WorkerStartResult, WorkerStatus, WorkerVersionRef, a11yDiagnosticCodes, actionDiagnosticCodes, ariaSummary, artifactCreateMethod, artifactDiagnosticCodes, artifactGetMethod, artifactListMethod, artifactPublishMethod, artifactVerifyMethod, buildDiagnosticCodes, bundleAssetName, canonicalJson, checkArgumentFrames, checkRequest, classifyMessage, cliDiagnosticCodes, connectBridge, consoleDiagnosticCodes, createDiagnostic, defineMethod, depDiagnosticCodes, depsAddMethod, deserializeAll, devStartMethod, devStopMethod, diagnosticCatalog, docsUrl, durationMs, encodeLine, envDiagnosticCodes, estimateImageTokens, eventsAckMethod, eventsReadMethod, eventsSubscribeMethod, eventsUnsubscribeMethod, fieldDiagnosticCodes, fromBase64, gcRunMethod, headerValue, homeDiagnosticCodes, hostDiagnosticCodes, hostMethods, hostNotifications, hygieneDiagnosticCodes, instanceCheckMethod, instanceStatusMethod, isFieldId, isFinalRunStatus, isJsonContentType, isWindowsBundle, liveDiagnosticCodes, livePushMethod, manifestDiagnosticCodes, mostraControlsRequest, mostraFieldFocus, mostraFields, mostraFlush, mostraFrameSessionEntered, mostraFrameSessionFailed, mostraInitializeMethod, mostraPage, mostraReady, mostraShutdownMethod, mostraVersionAvailable, negotiateRevision, networkDiagnosticCodes, normalizeScopes, parseParams, platformDiagnosticCodes, portAddressingExternalBaseMethod, portDraftsMirrorMethod, portIdentityResolveMethod, portSecretsGetMethod, portSubmissionsDeliverMethod, portTrustedControlsActivatedMethod, portTrustedControlsPolicyMethod, publishDiagnosticCodes, readViewContext, receivable, refusal, regressionDiagnosticCodes, resultsGetMethod, runtimeDiagnosticCodes, safeEqual, safePath, scopeAllows, secretDeleteMethod, secretDiagnosticCodes, secretListMethod, secretSetMethod, serializeAll, shareDiagnosticCodes, shareListMethod, shareStartMethod, shareStopMethod, smokeDiagnosticCodes, stateGetMethod, statePatchMethod, submitDiagnosticCodes, targetDiagnosticCodes, toBase64, typeDiagnosticCodes, uiInitialize, uiInitialized, uiOpenLink, uiSizeChanged, verifyDiagnosticCodes, viewDefaultMethod, viewLaunchMethod, viewRevokeMethod, viewRotateMethod, viewUrlMethod, viewportsFor, waitMethod, wireError };
115
+ export { ACTION_ARGS_MAX, ACTION_RESULT_MAX, ALL_SCOPES, ARGUMENT_BIGINT_DIGITS_MAX, ARTIFACT_MANIFEST_KEYS, ARTIFACT_PROGRESS, AccountId, ActionError, Actor, AddedPackage, ArtifactDetail, ArtifactId, ArtifactLink, ArtifactManifest, ArtifactProgressParams, ArtifactRef, ArtifactSummary, BRIDGE_FIELDS_MAX, BRIDGE_MESSAGES, BRIDGE_TEXT_MAX, BROWSER_PROTOCOL_REVISION, BROWSER_PROTOCOL_REVISIONS, BUNDLE_NAME, BUNDLE_PLATFORMS, BUNDLE_SETUP_MARKER, Batches, BundleAsset, BundleBrowser, BundleFileEntry, BundleFiles, BundleInfo, BundleLinkEntry, BundlePins, BundlePlatformSchema, BundleSetup, CLI_CLIENT_NAME, CONTROL_LABEL_MAX, CSRF_HEADER, CallRequest, CapabilityLink, CapabilityScope, CarryOver, ChildProcessStatus, ChooseRequest, ClientCapabilities, ClientInfo, CommentId, ControlsPolicy, Cursor, DEFAULT_DOCS_BASE, DEFAULT_VIEWPORTS, DEFAULT_WORKER_LIMITS, DEV_NOTIFY, DIAGNOSTIC_AREAS, DeliveryCounts, DeliveryId, DeliveryStatus, DependencyPolicy, DevNotifyParams, Diagnostic, DiagnosticFix, DiagnosticLocation, DiagnosticPhase, DiagnosticSeverity, DocumentRevision, DocumentSnapshot, DraftMirror, Duration, EVENTS_NOTIFY, EVENTS_READ_MAX, EnterRequest, EnterResult, EventFilter, EventOrigin, EventRecord, EventTypePattern, EventsNotifyParams, ExportClass, ExternalBase, FIELD_ID_MAX_LENGTH, FRAME_SESSION_HEADER, FieldConflict, FieldOp, FieldState, FieldsRequest, FollowRequest, FrameSessionFacts, FrameTicket, GatewayStatus, HOSTED_OFFLINE_LIMIT_DEFAULT, HOSTED_OFFLINE_LIMIT_MAX_MS, HOST_PROTOCOL_REVISIONS, HomeConfig, HomeId, HostedRoute, HostedSettings, InstanceCapabilities, InstanceInfo, JSON_RPC_ERROR_CODES, JsonRpcErrorObject, JsonRpcFailure, JsonRpcNotification, JsonRpcRequest, JsonRpcSuccess, LIVE_KEY_PATTERN, LIVE_RING_DEFAULT, LIVE_RING_MAX, LIVE_VALUE_MAX, LineSplitter, LinkId, LiveRequest, MAX_LINE_LENGTH, MCP_APPS_PROTOCOL_VERSION, MutationId, MutationResult, OPEN_LINK_SCHEMES, OriginString, OrphanedField, OwnerLinkInfo, PUBLIC_SHARE_DEFAULT_TTL, PUBLIC_SHARE_MAX_TTL_MS, PollResult, PortName, PublishReceipt, READABLE_LIVE_KEY_PATTERN, REVIEW_SET_ID_PATTERN, RUN_KEY_MAX, RUN_LOG_MAX, RUN_LOG_TRUNCATED, RUN_STATUSES, RelayViewer, RemoteError, RemoteLink, ResultComment, Results, ResultsMarkdown, Revision, RouteId, RpcError, RpcPeer, RunAttachRequest, RunCancelRequest, RunId, RunProgress, RunRequest, RunState, SECRET_NAME_PATTERN, SECRET_VALUE_MAX, SHELL_SESSION_HEADER, SIGNAL_NAME_PATTERN, SIGNAL_PAYLOAD_MAX_BYTES, ScreenshotPolicy, SecretEntry, SerializationError, ServerEmitParams, ServerLiveValueParams, ServerLogParams, ServerOrigin, ServerProgressParams, ServerSecretParams, ServerSignalParams, ServerStateGetParams, ServerStatePatchParams, Share, ShareId, ShareVia, ShellSubmitRequest, SignalRequest, SourceRef, StreamSnapshot, StreamTicket, StreamTicketRequest, SubmissionEnvelope, SubmissionId, SubmissionPolicy, SubmissionSummary, SubmitChannel, SubmitRequest, TALLY_CHOICES_MAX, TALLY_CHOICES_MIN, TALLY_LIVE_PREFIX, TallySpec, ThreadId, TokenId, TrustedControl, UNSERIALIZABLE_CODE, VERIFY_PROBE, VERIFY_REPORT, VERIFY_RUNNER_METHODS, ValueReader, ValueWriter, VerifyVerdict, VersionId, VersionPush, VersionRef, VersionSummary, ViewContext, ViewContextWire, ViewId, Viewer, ViewerId, ViewerSpec, WAIT_MAX_MS, WORKER_CHANNEL_REVISION, WORKER_METHODS, WaitCondition, WorkerBatchParams, WorkerCallOutcome, WorkerCallParams, WorkerPingResult, WorkerStartParams, WorkerStartResult, WorkerStatus, WorkerVersionRef, a11yDiagnosticCodes, actionDiagnosticCodes, ariaSummary, artifactCreateMethod, artifactDiagnosticCodes, artifactExportMethod, artifactGetMethod, artifactImportMethod, artifactListMethod, artifactPublishMethod, artifactVerifyMethod, buildDiagnosticCodes, bundleAssetName, canonicalJson, checkArgumentFrames, checkRequest, classifyMessage, cliDiagnosticCodes, connectBridge, consoleDiagnosticCodes, createDiagnostic, defineMethod, depDiagnosticCodes, depsAddMethod, deserializeAll, devStartMethod, devStopMethod, diagnosticCatalog, docsUrl, durationMs, encodeLine, envDiagnosticCodes, estimateImageTokens, eventsAckMethod, eventsReadMethod, eventsSubscribeMethod, eventsUnsubscribeMethod, fieldDiagnosticCodes, fromBase64, gcRunMethod, headerValue, homeDiagnosticCodes, hostDiagnosticCodes, hostMethods, hostNotifications, hostedPushMethod, hostedSubmissionMethod, hygieneDiagnosticCodes, instanceCheckMethod, instanceStatusMethod, isFieldId, isFinalRunStatus, isJsonContentType, isWindowsBundle, liveDiagnosticCodes, livePushMethod, manifestDiagnosticCodes, manifestProblem, mostraControlsRequest, mostraFieldFocus, mostraFields, mostraFlush, mostraFrameSessionEntered, mostraFrameSessionFailed, mostraInitializeMethod, mostraPage, mostraReady, mostraShutdownMethod, mostraVersionAvailable, negotiateRevision, networkDiagnosticCodes, normalizeScopes, parseParams, platformDiagnosticCodes, portAddressingExternalBaseMethod, portDraftsMirrorMethod, portIdentityResolveMethod, portRelayCallMethod, portRelayCancelMethod, portRelayLiveMethod, portRelayReconcileMethod, portRelayRunMethod, portSecretsGetMethod, portSubmissionsDeliverMethod, portTrustedControlsActivatedMethod, portTrustedControlsPolicyMethod, publishDiagnosticCodes, readViewContext, receivable, refusal, regressionDiagnosticCodes, relayCallBatchMethod, relayEffectMethod, relayLiveValueMethod, relayRunUpdateMethod, remoteDiagnosticCodes, remoteLoginMethod, remoteLoginWaitMethod, remoteLogoutMethod, remoteStatusMethod, remoteTokenMethod, resultsGetMethod, runtimeDiagnosticCodes, safeEqual, safePath, scopeAllows, secretDeleteMethod, secretDiagnosticCodes, secretListMethod, secretSetMethod, serializeAll, shareDiagnosticCodes, shareListMethod, shareStartMethod, shareStopMethod, smokeDiagnosticCodes, stateGetMethod, statePatchMethod, submitDiagnosticCodes, targetDiagnosticCodes, toBase64, typeDiagnosticCodes, uiInitialize, uiInitialized, uiOpenLink, uiSizeChanged, verifyDiagnosticCodes, viewDefaultMethod, viewLaunchMethod, viewRevokeMethod, viewRotateMethod, viewUrlMethod, viewportsFor, waitMethod, wireError };
@@ -1,10 +1,15 @@
1
- import { ArtifactLink, SubmissionPolicy } from "./manifest.js";
1
+ import { SubmissionPolicy } from "./policy.js";
2
+ import { ArtifactLink } from "./manifest.js";
2
3
  import { ControlsPolicy, SubmitChannel, TrustedControl } from "./view.js";
3
4
  import { Cursor } from "./ids.js";
4
5
  import * as z from "zod";
5
6
  //#region src/interaction.d.ts
6
7
  /** How Mostra knows a viewer (DATA_MODEL §3 `viewer.kind`). */
7
- export type ViewerKind = "local" | "tailnet" | "token" | "host";
8
+ /**
9
+ * How Mostra knows a viewer: `account` and `anonymous` are hosted links' (a signed-in person, and
10
+ * one per browser who isn't signed in, D165 item 8).
11
+ */
12
+ export type ViewerKind = "local" | "tailnet" | "token" | "host" | "account" | "anonymous";
8
13
  /**
9
14
  * A person who views an artifact (PRODUCT vocabulary). The home's local user is one viewer of kind
10
15
  * `local`; a link minted with `viewer` acts as a viewer of kind `token` (D104).
@@ -130,6 +135,23 @@ export interface MutationResult {
130
135
  }
131
136
  /** The Zod schema of the `MutationResult` type. */
132
137
  export declare const MutationResult: z.ZodType<MutationResult>;
138
+ /**
139
+ * Where an owner instance's copy of a hosted record came from (INTERFACES §18.2, D165 item 1): the
140
+ * server, the hosted home, its incarnation and the record's cursor there (a submission's is the
141
+ * cursor of its `submission.created`).
142
+ */
143
+ export interface EventOrigin {
144
+ /** The server's API origin. */
145
+ readonly server: string;
146
+ /** The hosted home's `hom_` ID. */
147
+ readonly home: string;
148
+ /** The hosted home's incarnation when the record was copied. */
149
+ readonly incarnation: string;
150
+ /** The record's cursor in the hosted home. */
151
+ readonly cursor: Cursor;
152
+ }
153
+ /** The Zod schema of the `EventOrigin` type. */
154
+ export declare const EventOrigin: z.ZodType<EventOrigin>;
133
155
  /**
134
156
  * One durable event (DATA_MODEL §4). Its cursor is its stable ID and its place in the home-wide
135
157
  * order; `seq` orders an artifact's own events without gaps.
@@ -151,6 +173,8 @@ export interface EventRecord {
151
173
  readonly causation?: Readonly<Record<string, string>>;
152
174
  /** The event's data; sensitive field values are redacted (D52). */
153
175
  readonly payload: Readonly<Record<string, unknown>>;
176
+ /** For an event an owner instance copied from its hosted home: where it came from. */
177
+ readonly origin?: EventOrigin;
154
178
  }
155
179
  /** The Zod schema of the `EventRecord` type. */
156
180
  export declare const EventRecord: z.ZodType<EventRecord>;
@@ -336,6 +360,8 @@ export interface Results {
336
360
  readonly digest: string;
337
361
  readonly delivery: DeliveryState;
338
362
  readonly deliveries: readonly DeliveryStatus[];
363
+ /** For a submission imported from a hosted home: where it came from (D165 item 1). */
364
+ readonly origin?: EventOrigin;
339
365
  };
340
366
  /** The draft's fields by ID, dotted IDs nested (D52). */
341
367
  readonly answers: Readonly<Record<string, unknown>>;
@@ -1 +1 @@
1
- {"version":3,"file":"interaction.d.ts","names":[],"sources":["../src/interaction.ts"],"mappings":";;;;;;YAyBY;;;;;iBAMK;;WAEN;;WAEA,MAAM;;WAEN;;WAEA;;;qBAIE,QAAQ,EAAE,QAAQ;;;;;iBAgBd;;WAEN;;WAEA;;;qBAIE,YAAY,EAAE,QAAQ;;iBAWlB;;WAEN;;WAEA;;WAEA;;;qBAIE,OAAO,EAAE,QAAQ;;qBAcjB;;;;;wBAMG,UAAU,cAAc;;YAY5B;;;;;YAMA;;qBAGC,kBAAkB,EAAE,QAAQ;;;;;iBAYxB;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;;qBAIE,SAAS,EAAE,QAAQ;;iBAgBf;;WAEN;;WAEA,UAAU;;WAEV,YAAY;;WAEZ;;WAEA;;WAEA;;WAEA;;;qBAIE,YAAY,EAAE,QAAQ;;;;;iBAmBlB;;WAEN;;WAEA,UAAU;;WAEV;;WAEA;;WAEA,YAAY;;WAEZ;;;qBAIE,eAAe,EAAE,QAAQ;;iBAerB;;WAEN,UAAU;;WAEV;;WAEA,oBAAoB;;;qBAIlB,gBAAgB,EAAE,QAAQ;;;;;iBAkBtB;;WAEN,QAAQ;;WAER;;WAEA;;WAEA;;WAEA;;WAEA,OAAO;;WAEP,YAAY,SAAS;;WAErB,SAAS,SAAS;;;qBAIhB,aAAa,EAAE,QAAQ;;;;;YAqBxB;;qBAGC,kBAAkB,EAAE,QAAQ;;;;;;iBAaxB;;WAEN;;WAEA,iBAAiB;;;qBAIf,aAAa,EAAE,QAAQ;;;;;YAexB;;qBAGC,qBAAqB;;qBAGrB,eAAe,EAAE,QAAQ;;YAc1B;;iBAGK;;WAEN;;;;;WAKA;;WAEA,OAAO;;WAEP;;WAEA;;;;;WAKA;;WAEA;;;qBAIE,gBAAgB,EAAE,QAAQ;;iBAgBtB;;WAEN;;WAEA;;WAEA;;WAEA,SAAS;;WAET;;WAEA;;WAEA;;WAEA;;WAEA,eAAe;;WAEf;;WAEA,UAAU;;WAEV,sBAAsB;;WAEtB;;;qBAIE,mBAAmB,EAAE,QAAQ;;iBAuBzB;;WAEN;;WAEA;;WAEA;;WAEA;;;iBAIM;;WAEN;;WAEA;;WAEA;;;iBAIM;;WAEN;;WAEA;;WAEA;aACE,QAAQ;aACR;aACA;;;WAGF;aACE;;aAEA;aACA,OAAO;aACP,WAAW;aACX;aACA;aACA;eACE;eACA;eACA;;aAEF;aACA;eAAmB;eAAwB;;;;WAG7C;aAAiB;aAAuB;aAAwB;;;;;;;;iBAQ1D;;WAEN;aACE;aACA;aACA;aACA;aACA,gBAAgB;;;WAGlB;aACE;aACA;aACA;;aAEA;aACA,QAAQ;aACR,SAAS;aACT,QAAQ;aACR;aACA;aACA;;aAEA;;aAEA;aACA,eAAe;aACf,gBAAgB;aAChB;aACA,UAAU;aACV,qBAAqB;;;WAGvB,SAAS,SAAS;;WAElB;aACE;aACA;aACA;aACA;aACA,OAAO;;;WAGT,QAAQ,SAAS;;WAEjB;aACE;aACA;aACA;;;WAGF,mBAAmB;;WAEnB;aACE;aACA;aACA;aACA;;;WAGF;aACE;aACA;aACA;aACA;;;WAGF;aACE;aACA;aACA;;;WAGF;;WAEA;;;qBAWE,eAAe,EAAE,QAAQ;;qBAkCzB,SAAS,EAAE,QAAQ"}
1
+ {"version":3,"file":"interaction.d.ts","names":[],"sources":["../src/interaction.ts"],"mappings":";;;;;;;;;;;YA6BY;;;;;iBAMK;;WAEN;;WAEA,MAAM;;WAEN;;WAEA;;;qBAIE,QAAQ,EAAE,QAAQ;;;;;iBAgBd;;WAEN;;WAEA;;;qBAIE,YAAY,EAAE,QAAQ;;iBAWlB;;WAEN;;WAEA;;WAEA;;;qBAIE,OAAO,EAAE,QAAQ;;qBAcjB;;;;;wBAMG,UAAU,cAAc;;YAY5B;;;;;YAMA;;qBAGC,kBAAkB,EAAE,QAAQ;;;;;iBAYxB;;WAEN;;WAEA;;WAEA;;WAEA;;WAEA;;WAEA;;;qBAIE,SAAS,EAAE,QAAQ;;iBAgBf;;WAEN;;WAEA,UAAU;;WAEV,YAAY;;WAEZ;;WAEA;;WAEA;;WAEA;;;qBAIE,YAAY,EAAE,QAAQ;;;;;iBAmBlB;;WAEN;;WAEA,UAAU;;WAEV;;WAEA;;WAEA,YAAY;;WAEZ;;;qBAIE,eAAe,EAAE,QAAQ;;iBAerB;;WAEN,UAAU;;WAEV;;WAEA,oBAAoB;;;qBAIlB,gBAAgB,EAAE,QAAQ;;;;;;iBAmBtB;;WAEN;;WAEA;;WAEA;;WAEA,QAAQ;;;qBAIN,aAAa,EAAE,QAAQ;;;;;iBAiBnB;;WAEN,QAAQ;;WAER;;WAEA;;WAEA;;WAEA;;WAEA,OAAO;;WAEP,YAAY,SAAS;;WAErB,SAAS,SAAS;;WAElB,SAAS;;;qBAIP,aAAa,EAAE,QAAQ;;;;;YAsBxB;;qBAGC,kBAAkB,EAAE,QAAQ;;;;;;iBAaxB;;WAEN;;WAEA,iBAAiB;;;qBAIf,aAAa,EAAE,QAAQ;;;;;YAexB;;qBAGC,qBAAqB;;qBAGrB,eAAe,EAAE,QAAQ;;YAc1B;;iBAGK;;WAEN;;;;;WAKA;;WAEA,OAAO;;WAEP;;WAEA;;;;;WAKA;;WAEA;;;qBAIE,gBAAgB,EAAE,QAAQ;;iBAgBtB;;WAEN;;WAEA;;WAEA;;WAEA,SAAS;;WAET;;WAEA;;WAEA;;WAEA;;WAEA,eAAe;;WAEf;;WAEA,UAAU;;WAEV,sBAAsB;;WAEtB;;;qBAIE,mBAAmB,EAAE,QAAQ;;iBAuBzB;;WAEN;;WAEA;;WAEA;;WAEA;;;iBAIM;;WAEN;;WAEA;;WAEA;;;iBAIM;;WAEN;;WAEA;;WAEA;aACE,QAAQ;aACR;aACA;;;WAGF;aACE;;aAEA;aACA,OAAO;aACP,WAAW;aACX;aACA;aACA;eACE;eACA;eACA;;aAEF;aACA;eAAmB;eAAwB;;;;WAG7C;aAAiB;aAAuB;aAAwB;;;;;;;;iBAQ1D;;WAEN;aACE;aACA;aACA;aACA;aACA,gBAAgB;;;WAGlB;aACE;aACA;aACA;;aAEA;aACA,QAAQ;aACR,SAAS;aACT,QAAQ;aACR;aACA;aACA;;aAEA;;aAEA;aACA,eAAe;aACf,gBAAgB;aAChB;aACA,UAAU;aACV,qBAAqB;;aAErB,SAAS;;;WAGX,SAAS,SAAS;;WAElB;aACE;aACA;aACA;aACA;aACA,OAAO;;;WAGT,QAAQ,SAAS;;WAEjB;aACE;aACA;aACA;;;WAGF,mBAAmB;;WAEnB;aACE;aACA;aACA;aACA;;;WAGF;aACE;aACA;aACA;aACA;;;WAGF;aACE;aACA;aACA;;;WAGF;;WAEA;;;qBAWE,eAAe,EAAE,QAAQ;;qBAkCzB,SAAS,EAAE,QAAQ"}
@@ -1,6 +1,7 @@
1
1
  import { wireRegistry } from "./wire-registry.js";
2
2
  import { ArtifactId, Cursor, DeliveryId, SubmissionId, VersionId, ViewId, ViewerId } from "./ids.js";
3
- import { ArtifactLink, SubmissionPolicy } from "./manifest.js";
3
+ import { SubmissionPolicy } from "./policy.js";
4
+ import { ArtifactLink } from "./manifest.js";
4
5
  import { ControlsPolicy, SubmitChannel, TrustedControl } from "./view.js";
5
6
  import * as z from "zod";
6
7
  //#region src/interaction.ts
@@ -17,7 +18,9 @@ const Viewer = z.object({
17
18
  "local",
18
19
  "tailnet",
19
20
  "token",
20
- "host"
21
+ "host",
22
+ "account",
23
+ "anonymous"
21
24
  ]),
22
25
  name: z.string().exactOptional(),
23
26
  ref: z.string().exactOptional()
@@ -107,6 +110,16 @@ const MutationResult = z.object({
107
110
  id: "MutationResult",
108
111
  description: "A mutation's outcome: the revision after it, the applied field IDs, the conflicts."
109
112
  });
113
+ /** The Zod schema of the `EventOrigin` type. */
114
+ const EventOrigin = z.object({
115
+ server: z.string().min(1),
116
+ home: z.string().min(1),
117
+ incarnation: z.string().min(1),
118
+ cursor: Cursor.schema
119
+ }).register(wireRegistry, {
120
+ id: "EventOrigin",
121
+ description: "Where an owner's copy of a hosted record came from: server, home, incarnation, cursor."
122
+ });
110
123
  /** The Zod schema of the `EventRecord` type. */
111
124
  const EventRecord = z.object({
112
125
  cursor: Cursor.schema,
@@ -116,7 +129,8 @@ const EventRecord = z.object({
116
129
  at: z.iso.datetime(),
117
130
  actor: Actor,
118
131
  causation: z.record(z.string(), z.string()).exactOptional(),
119
- payload: z.record(z.string(), z.unknown())
132
+ payload: z.record(z.string(), z.unknown()),
133
+ origin: EventOrigin.exactOptional()
120
134
  }).register(wireRegistry, {
121
135
  id: "EventRecord",
122
136
  description: "One durable event: cursor, artifact, per-artifact sequence, type, time, actor, payload."
@@ -260,7 +274,8 @@ const Results = z.object({
260
274
  "rejected",
261
275
  "undeliverable"
262
276
  ]),
263
- deliveries: z.array(DeliveryStatus).readonly()
277
+ deliveries: z.array(DeliveryStatus).readonly(),
278
+ origin: EventOrigin.exactOptional()
264
279
  }),
265
280
  answers: z.record(z.string(), z.unknown()),
266
281
  fields: z.array(z.object({
@@ -301,6 +316,6 @@ const Results = z.object({
301
316
  description: "The complete submission: artifact, submission facts, answers, fields, state, choices, comments, orphans, actions, signals."
302
317
  });
303
318
  //#endregion
304
- export { Actor, ControlsPolicy, DeliveryStatus, DocumentRevision, EventFilter, EventRecord, EventTypePattern, FIELD_ID_MAX_LENGTH, FieldConflict, FieldOp, FieldState, MutationResult, ResultComment, Results, SIGNAL_NAME_PATTERN, SubmissionSummary, SubmitChannel, TrustedControl, Viewer, ViewerSpec, WaitCondition, isFieldId };
319
+ export { Actor, ControlsPolicy, DeliveryStatus, DocumentRevision, EventFilter, EventOrigin, EventRecord, EventTypePattern, FIELD_ID_MAX_LENGTH, FieldConflict, FieldOp, FieldState, MutationResult, ResultComment, Results, SIGNAL_NAME_PATTERN, SubmissionSummary, SubmitChannel, TrustedControl, Viewer, ViewerSpec, WaitCondition, isFieldId };
305
320
 
306
321
  //# sourceMappingURL=interaction.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"interaction.js","names":[],"sources":["../src/interaction.ts"],"sourcesContent":["/**\n * The interaction ledger's wire types (INTERFACES §4, §6, §7, §8; DATA_MODEL §3, §4): viewers,\n * fields and their mutations, events and their filters, `wait` conditions, submissions, deliveries\n * and results. The host protocol methods (`state/*`, `results/get`, `wait`, `events/*`), the\n * submissions and drafts ports, and the browser protocol all speak these shapes.\n */\nimport * as z from \"zod\";\nimport {\n ArtifactId,\n Cursor,\n DeliveryId,\n SubmissionId,\n VersionId,\n ViewerId,\n ViewId,\n} from \"./ids.ts\";\nimport { ArtifactLink, SubmissionPolicy } from \"./manifest.ts\";\nimport type { SubmitChannel } from \"./view.ts\";\nimport { wireRegistry } from \"./wire-registry.ts\";\n\nexport { ControlsPolicy, SubmitChannel, TrustedControl } from \"./view.ts\";\n\n// ── Viewers and actors ────────────────────────────────────────────────────────────────────\n\n/** How Mostra knows a viewer (DATA_MODEL §3 `viewer.kind`). */\nexport type ViewerKind = \"local\" | \"tailnet\" | \"token\" | \"host\";\n\n/**\n * A person who views an artifact (PRODUCT vocabulary). The home's local user is one viewer of kind\n * `local`; a link minted with `viewer` acts as a viewer of kind `token` (D104).\n */\nexport interface Viewer {\n /** The viewer's ID. */\n readonly id: string;\n /** How Mostra knows the viewer. */\n readonly kind: ViewerKind;\n /** The display name, when one is known. */\n readonly name?: string;\n /** The host's own key for this person, as given to `view/url` (D104). */\n readonly ref?: string;\n}\n\n/** The Zod schema of the `Viewer` type. */\nexport const Viewer: z.ZodType<Viewer> = z\n .object({\n id: ViewerId.schema,\n kind: z.enum([\"local\", \"tailnet\", \"token\", \"host\"]),\n name: z.string().exactOptional(),\n ref: z.string().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"Viewer\",\n description: \"A person who views an artifact: ID, kind, display name and the host's own key.\",\n });\n\n/**\n * The person a capability link acts for (`view/url`'s `viewer`, D104): the host's stable key for\n * them, such as an email or an account ID, and a display name.\n */\nexport interface ViewerSpec {\n /** The host's stable key for this person: the same `ref` always names the same viewer. */\n readonly ref: string;\n /** The name people see; updated when given again. */\n readonly name?: string;\n}\n\n/** The Zod schema of the `ViewerSpec` type. */\nexport const ViewerSpec: z.ZodType<ViewerSpec> = z\n .object({\n ref: z.string().min(1).max(256),\n name: z.string().min(1).max(256).exactOptional(),\n })\n .register(wireRegistry, {\n id: \"ViewerSpec\",\n description: \"The person a capability link acts for: the host's stable key and a display name.\",\n });\n\n/** Who caused an event or wrote a field (DATA_MODEL §4). */\nexport interface Actor {\n /** Who: a viewer, an agent (a protocol client), a host, or Mostra itself. */\n readonly kind: \"viewer\" | \"agent\" | \"host\" | \"mostra\";\n /** A viewer's ID, or the protocol client's name for agents and hosts. */\n readonly id?: string;\n /** A display name, when one is known. */\n readonly name?: string;\n}\n\n/** The Zod schema of the `Actor` type. */\nexport const Actor: z.ZodType<Actor> = z\n .object({\n kind: z.enum([\"viewer\", \"agent\", \"host\", \"mostra\"]),\n id: z.string().exactOptional(),\n name: z.string().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"Actor\",\n description: \"Who caused an event or wrote a field: a viewer, an agent, a host or Mostra.\",\n });\n\n// ── Fields and mutations ──────────────────────────────────────────────────────────────────\n\n/** The longest field ID, in UTF-16 code units. */\nexport const FIELD_ID_MAX_LENGTH = 256;\n\n/**\n * Whether `id` is a field ID (D52): 1 to 256 characters without control characters; dots separate\n * the parts that nest in results, so none is empty.\n */\nexport function isFieldId(id: unknown): id is string {\n return (\n typeof id === \"string\" &&\n id.length >= 1 &&\n id.length <= FIELD_ID_MAX_LENGTH &&\n // biome-ignore lint/suspicious/noControlCharactersInRegex: control characters are what it refuses.\n !/[\\u0000-\\u001f\\u007f]/.test(id) &&\n !id.split(\".\").includes(\"\")\n );\n}\n\n/** Which document a field belongs to: the viewer's draft, or the artifact's shared state (D63). */\nexport type FieldScope = \"viewer\" | \"artifact\";\n\n/**\n * A document revision: the decimal string of a document's monotonic counter (DATA_MODEL §3).\n * `\"0\"` is a document nothing has written yet.\n */\nexport type DocumentRevision = string;\n\n/** The Zod schema of the `DocumentRevision` type. */\nexport const DocumentRevision: z.ZodType<DocumentRevision> = z\n .string()\n .regex(/^(0|[1-9][0-9]{0,15})$/)\n .register(wireRegistry, {\n id: \"DocumentRevision\",\n description: \"A draft's or artifact state's revision: a non-negative decimal integer string.\",\n });\n\n/**\n * One change to one field. Exactly one of `value` and `delete` is given. The optional metadata\n * travels with the field into results and decides what events redact (D52, D106).\n */\nexport interface FieldOp {\n /** The field ID (D52). */\n readonly id: string;\n /** The new value: any JSON value, `null` included. */\n readonly value?: unknown;\n /** Removes the field. */\n readonly delete?: true;\n /** The label people see in results and the shell's blocker list. */\n readonly label?: string;\n /** Whether the shell asks for it before submit. */\n readonly required?: boolean;\n /** Kept in submissions and results, redacted from events and logs (D52). */\n readonly sensitive?: boolean;\n}\n\n/** The Zod schema of the `FieldOp` type. */\nexport const FieldOp: z.ZodType<FieldOp> = z\n .object({\n id: z.string().min(1).max(FIELD_ID_MAX_LENGTH),\n value: z.unknown().exactOptional(),\n delete: z.literal(true).exactOptional(),\n label: z.string().max(1024).exactOptional(),\n required: z.boolean().exactOptional(),\n sensitive: z.boolean().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"FieldOp\",\n description:\n \"One change to one field: a value or a delete, with optional label, required and sensitive.\",\n }) as z.ZodType<FieldOp>;\n\n/** A field's current state. */\nexport interface FieldState {\n /** The field's value: any JSON value. */\n readonly value: unknown;\n /** The document revision that last wrote it. */\n readonly revision: DocumentRevision;\n /** Who wrote it last. */\n readonly updatedBy?: Actor;\n /** When it was written last. */\n readonly updatedAt: string;\n /** The label people see. */\n readonly label?: string;\n /** Whether the shell asks for it before submit. */\n readonly required?: boolean;\n /** Whether events and logs redact its value (D52). */\n readonly sensitive?: boolean;\n}\n\n/** The Zod schema of the `FieldState` type. */\nexport const FieldState: z.ZodType<FieldState> = z\n .object({\n value: z.unknown(),\n revision: DocumentRevision,\n updatedBy: Actor.exactOptional(),\n updatedAt: z.iso.datetime(),\n label: z.string().exactOptional(),\n required: z.boolean().exactOptional(),\n sensitive: z.boolean().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"FieldState\",\n description: \"A field's current value, the revision that wrote it, who wrote it and when.\",\n }) as z.ZodType<FieldState>;\n\n/**\n * A field op that wasn't applied because the field changed after the mutation's base revision\n * (D22, FAILURE_MODEL §5): what the field holds now, so the writer can keep theirs or take it.\n */\nexport interface FieldConflict {\n /** The field's ID. */\n readonly id: string;\n /** The revision that last changed the field. */\n readonly revision: DocumentRevision;\n /** Its current value; absent when it was deleted. */\n readonly value?: unknown;\n /** `true` when the field was deleted. */\n readonly deleted?: true;\n /** Who changed it. */\n readonly updatedBy?: Actor;\n /** When it changed. */\n readonly updatedAt?: string;\n}\n\n/** The Zod schema of the `FieldConflict` type. */\nexport const FieldConflict: z.ZodType<FieldConflict> = z\n .object({\n id: z.string(),\n revision: DocumentRevision,\n value: z.unknown().exactOptional(),\n deleted: z.literal(true).exactOptional(),\n updatedBy: Actor.exactOptional(),\n updatedAt: z.iso.datetime().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"FieldConflict\",\n description: \"A field op not applied because the field changed after the base revision.\",\n }) as z.ZodType<FieldConflict>;\n\n/** What a mutation did: the document's revision after it, the ops applied, and the conflicts. */\nexport interface MutationResult {\n /** The document's revision after the mutation; unchanged when nothing applied. */\n readonly revision: DocumentRevision;\n /** The field IDs whose ops were applied. */\n readonly applied: readonly string[];\n /** The ops not applied, with what each field holds now. */\n readonly conflicts: readonly FieldConflict[];\n}\n\n/** The Zod schema of the `MutationResult` type. */\nexport const MutationResult: z.ZodType<MutationResult> = z\n .object({\n revision: DocumentRevision,\n applied: z.array(z.string()).readonly(),\n conflicts: z.array(FieldConflict).readonly(),\n })\n .register(wireRegistry, {\n id: \"MutationResult\",\n description:\n \"A mutation's outcome: the revision after it, the applied field IDs, the conflicts.\",\n });\n\n// ── Events ────────────────────────────────────────────────────────────────────────────────\n\n/**\n * One durable event (DATA_MODEL §4). Its cursor is its stable ID and its place in the home-wide\n * order; `seq` orders an artifact's own events without gaps.\n */\nexport interface EventRecord {\n /** The event's stable ID and home-wide position. */\n readonly cursor: Cursor;\n /** The artifact, or `null` for a home-wide event. */\n readonly artifactId: string | null;\n /** The artifact's sequence number, or `null` for a home-wide event. */\n readonly seq: number | null;\n /** The type from DATA_MODEL §4's catalog. */\n readonly type: string;\n /** When it was appended. */\n readonly at: string;\n /** Who caused it. */\n readonly actor: Actor;\n /** What caused it: a run, a mutation, a submission. */\n readonly causation?: Readonly<Record<string, string>>;\n /** The event's data; sensitive field values are redacted (D52). */\n readonly payload: Readonly<Record<string, unknown>>;\n}\n\n/** The Zod schema of the `EventRecord` type. */\nexport const EventRecord: z.ZodType<EventRecord> = z\n .object({\n cursor: Cursor.schema,\n artifactId: ArtifactId.schema.nullable(),\n seq: z.int().min(1).nullable(),\n type: z.string(),\n at: z.iso.datetime(),\n actor: Actor,\n causation: z.record(z.string(), z.string()).exactOptional(),\n payload: z.record(z.string(), z.unknown()),\n })\n .register(wireRegistry, {\n id: \"EventRecord\",\n description:\n \"One durable event: cursor, artifact, per-artifact sequence, type, time, actor, payload.\",\n }) as z.ZodType<EventRecord>;\n\n/**\n * An event type, or a family of them: `submission.created`, or `submission.*` for every type that\n * starts with `submission.`.\n */\nexport type EventTypePattern = string;\n\n/** The Zod schema of the `EventTypePattern` type. */\nexport const EventTypePattern: z.ZodType<EventTypePattern> = z\n .string()\n .regex(/^[a-z][a-zA-Z0-9_-]*(\\.[a-zA-Z0-9_-]+)*(\\.\\*)?$/)\n .register(wireRegistry, {\n id: \"EventTypePattern\",\n description: \"An event type (submission.created) or a family of them (submission.*).\",\n });\n\n/**\n * Which events a reader wants (IN-08, H-09). Both parts are optional, and an event must pass both.\n * `artifact.compacted` always passes for a matching artifact, so a filtered reader still learns of\n * a compaction (DATA_MODEL §4).\n */\nexport interface EventFilter {\n /** Only these artifacts' events; absent: every artifact's, and home-wide ones. */\n readonly artifacts?: readonly string[];\n /** Only these types; absent: every type. */\n readonly types?: readonly EventTypePattern[];\n}\n\n/** The Zod schema of the `EventFilter` type. */\nexport const EventFilter: z.ZodType<EventFilter> = z\n .object({\n artifacts: z.array(ArtifactId.schema).max(1000).readonly().exactOptional(),\n types: z.array(EventTypePattern).max(100).readonly().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"EventFilter\",\n description:\n \"Which events a reader wants: these artifacts' and these types (patterns allowed).\",\n });\n\n/**\n * What `wait` waits for (ARCHITECTURE §6, D103): `submitted`, `signal:<name>`, `state:<fieldId>`\n * or `event:<type pattern>`.\n */\nexport type WaitCondition = string;\n\n/** A signal's name: letters, digits, `.`, `_` and `-`, starting with a letter or digit (D106). */\nexport const SIGNAL_NAME_PATTERN: RegExp = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;\n\n/** The Zod schema of the `WaitCondition` type. */\nexport const WaitCondition: z.ZodType<WaitCondition> = z\n .string()\n .regex(\n // biome-ignore lint/suspicious/noControlCharactersInRegex: field IDs exclude control characters.\n /^(submitted|signal:[A-Za-z0-9][A-Za-z0-9._-]{0,63}|state:[^\\u0000-\\u001f\\u007f]{1,256}|event:[a-z][a-zA-Z0-9_-]*(\\.[a-zA-Z0-9_-]+)*(\\.\\*)?)$/,\n )\n .register(wireRegistry, {\n id: \"WaitCondition\",\n description: \"What wait waits for: submitted, signal:<name>, state:<fieldId> or event:<type>.\",\n });\n\n// ── Submissions, deliveries and results ──────────────────────────────────────────────────\n\n/** A delivery's state (FAILURE_MODEL §4). */\nexport type DeliveryState = \"pending\" | \"delivered\" | \"rejected\" | \"undeliverable\";\n\n/** One submission's delivery to one host (D105). */\nexport interface DeliveryStatus {\n /** The delivery's stable ID (`dlv_`), repeated by every redelivery. */\n readonly deliveryId: string;\n /**\n * The host: its client name. Empty for Mostra's built-in adapter, which takes submissions when no\n * host does; client names are never empty, so no host can be mistaken for it (D105).\n */\n readonly owner: string;\n /** Where the delivery stands. */\n readonly state: DeliveryState;\n /** How many times Mostra called the host for it. */\n readonly attempts: number;\n /** The host's reason, for a rejection. */\n readonly reason?: string;\n /**\n * `true` while a pending delivery waits: its host isn't connected, or an attempt failed and it\n * will be retried (D47's \"Pending delivery\"). Absent while the first attempt is under way.\n */\n readonly waiting?: true;\n /** When its state last changed. */\n readonly updatedAt: string;\n}\n\n/** The Zod schema of the `DeliveryStatus` type. */\nexport const DeliveryStatus: z.ZodType<DeliveryStatus> = z\n .object({\n deliveryId: DeliveryId.schema,\n owner: z.string(),\n state: z.enum([\"pending\", \"delivered\", \"rejected\", \"undeliverable\"]),\n attempts: z.int().min(0),\n reason: z.string().exactOptional(),\n waiting: z.literal(true).exactOptional(),\n updatedAt: z.iso.datetime(),\n })\n .register(wireRegistry, {\n id: \"DeliveryStatus\",\n description: \"One submission's delivery to one host: owner, state, attempts and reason.\",\n });\n\n/** A submission as a submit answers it (INTERFACES §4). */\nexport interface SubmissionSummary {\n /** The submission's ID. */\n readonly id: string;\n /** When it was made. */\n readonly at: string;\n /** The draft epoch it closed (D103); 1 outside `epochs`. */\n readonly epoch: number;\n /** Where the submit came from (D40). */\n readonly channel: SubmitChannel;\n /** The version the view showed. */\n readonly versionId: string;\n /** That version's number. */\n readonly version: number;\n /** The view it was made from. */\n readonly viewId: string;\n /** Whether a newer version existed when the viewer submitted (H-10). */\n readonly staleView: boolean;\n /** The draft revision it was made from. */\n readonly draftRevision: DocumentRevision;\n /** SHA-256 of the snapshot's canonical JSON (RFC 8785), lowercase hex. */\n readonly digest: string;\n /** Every delivery's state, summed up: the worst of them. */\n readonly delivery: DeliveryState;\n /** Each host's delivery, so a viewer sees which host has it (IN-13). */\n readonly deliveries?: readonly DeliveryStatus[];\n /** `true` when this submit repeated an earlier one and got it back (D22). */\n readonly duplicate?: true;\n}\n\n/** The Zod schema of the `SubmissionSummary` type. */\nexport const SubmissionSummary: z.ZodType<SubmissionSummary> = z\n .object({\n id: SubmissionId.schema,\n at: z.iso.datetime(),\n epoch: z.int().min(1),\n channel: z.enum([\"shell\", \"artifact\"]),\n versionId: VersionId.schema,\n version: z.int().min(1),\n viewId: ViewId.schema,\n staleView: z.boolean(),\n draftRevision: DocumentRevision,\n digest: z.string().regex(/^[0-9a-f]{64}$/),\n delivery: z.enum([\"pending\", \"delivered\", \"rejected\", \"undeliverable\"]),\n deliveries: z.array(DeliveryStatus).readonly().exactOptional(),\n duplicate: z.literal(true).exactOptional(),\n })\n .register(wireRegistry, {\n id: \"SubmissionSummary\",\n description:\n \"A submission as a submit answers it: ID, time, epoch, version, view, digest, delivery.\",\n });\n\n/** A rectangle in CSS pixels, relative to its frame. */\nexport interface Rect {\n /** Distance from the frame's left edge. */\n readonly x: number;\n /** Distance from the frame's top edge. */\n readonly y: number;\n /** Width. */\n readonly width: number;\n /** Height. */\n readonly height: number;\n}\n\n/** A viewport: its size in CSS pixels and its device pixel ratio. */\nexport interface Viewport {\n /** Width in CSS pixels. */\n readonly width: number;\n /** Height in CSS pixels. */\n readonly height: number;\n /** Device pixel ratio. */\n readonly dpr: number;\n}\n\n/** One comment thread in results (INTERFACES §8; built by the review layer, WP-20). */\nexport interface ResultComment {\n /** The thread's ID. */\n readonly threadId: string;\n /** Whether the thread is open or resolved. */\n readonly status: \"open\" | \"resolved\";\n /** The thread's messages, oldest first, each with its author. */\n readonly messages: readonly {\n readonly author: Viewer;\n readonly at: string;\n readonly text: string;\n }[];\n /** Every layer of the anchor that applies (D23). */\n readonly anchor: {\n readonly reviewId?: string;\n /** W3C Web Annotation selectors. */\n readonly selectors?: readonly unknown[];\n readonly rect?: Rect;\n readonly viewport?: Viewport;\n readonly page?: string;\n readonly candidateId?: string;\n readonly terminal?: {\n readonly rows: readonly [number, number];\n readonly cols: readonly [number, number];\n readonly t?: number;\n };\n readonly time?: number;\n readonly slide?: { readonly index: number; readonly step: number };\n };\n /** The screenshot crop, always stored (D23). */\n readonly crop: { readonly path: string; readonly width: number; readonly height: number };\n}\n\n/**\n * The complete submission (INTERFACES §8): what `results/get`, `mostra results` and the\n * submissions port carry. Everything in it comes from the immutable submission and the version it\n * names, never from the live draft (IN-06).\n */\nexport interface Results {\n /** The artifact, with the metadata of the version the viewer saw. */\n readonly artifact: {\n readonly id: string;\n readonly title: string;\n readonly description?: string;\n readonly family?: string;\n readonly links: readonly ArtifactLink[];\n };\n /** The submission's facts: when, how, by whom, from which version and view, and its delivery. */\n readonly submission: {\n readonly id: string;\n readonly at: string;\n readonly epoch: number;\n /** The same viewer's previous submission, under `epochs` (D103). */\n readonly previous?: string;\n readonly policy: SubmissionPolicy;\n readonly channel: SubmitChannel;\n readonly viewer: Viewer;\n readonly versionId: string;\n readonly version: number;\n readonly viewId: string;\n /** Whether a newer version existed when the viewer submitted (H-10). */\n readonly staleView: boolean;\n /** The newest version's number at the time, when the view was stale. */\n readonly latestVersion?: number;\n readonly draftRevision: DocumentRevision;\n readonly stateRevision?: DocumentRevision;\n readonly digest: string;\n readonly delivery: DeliveryState;\n readonly deliveries: readonly DeliveryStatus[];\n };\n /** The draft's fields by ID, dotted IDs nested (D52). */\n readonly answers: Readonly<Record<string, unknown>>;\n /** Every field in `answers` and `state`, with its label and scope. */\n readonly fields: readonly {\n readonly id: string;\n readonly label?: string;\n readonly required?: boolean;\n readonly sensitive?: boolean;\n readonly scope: FieldScope;\n }[];\n /** Artifact state at `stateRevision`, dotted IDs nested (D63). */\n readonly state?: Readonly<Record<string, unknown>>;\n /** The review sets' choices: the fields `review.<set>.choice` (D65). */\n readonly choices: readonly {\n readonly reviewSetId: string;\n readonly candidateId: string;\n readonly label?: string;\n }[];\n /** Comment threads with their anchors and crops (WP-20). */\n readonly comments: readonly ResultComment[];\n /** Answers a newer version couldn't map (D42). */\n readonly orphaned: readonly {\n readonly id: string;\n readonly label?: string;\n readonly value: unknown;\n readonly fromVersion: number;\n }[];\n /** Action runs started in this view (WP-08). */\n readonly actions: readonly {\n readonly runId: string;\n readonly action: string;\n readonly status: string;\n readonly at: string;\n }[];\n /** Signals raised in this view before the submission: the newest 100, within 1 MiB of payloads. */\n readonly signals: readonly {\n readonly name: string;\n readonly at: string;\n readonly payload?: unknown;\n }[];\n /** How many older signals of the view the limit left out; absent when none. */\n readonly signalsOmitted?: number;\n /** Set when compaction removed events of this view before it submitted, so signals may be missing. */\n readonly signalsCompacted?: true;\n}\n\nconst RectSchema = z.object({\n x: z.number(),\n y: z.number(),\n width: z.number(),\n height: z.number(),\n});\n\n/** The Zod schema of the `ResultComment` type. */\nexport const ResultComment: z.ZodType<ResultComment> = z\n .object({\n threadId: z.string(),\n status: z.enum([\"open\", \"resolved\"]),\n messages: z\n .array(z.object({ author: Viewer, at: z.iso.datetime(), text: z.string() }))\n .readonly(),\n anchor: z.object({\n reviewId: z.string().exactOptional(),\n selectors: z.array(z.unknown()).readonly().exactOptional(),\n rect: RectSchema.exactOptional(),\n viewport: z\n .object({ width: z.number(), height: z.number(), dpr: z.number() })\n .exactOptional(),\n page: z.string().exactOptional(),\n candidateId: z.string().exactOptional(),\n terminal: z\n .object({\n rows: z.tuple([z.int(), z.int()]).readonly(),\n cols: z.tuple([z.int(), z.int()]).readonly(),\n t: z.number().exactOptional(),\n })\n .exactOptional(),\n time: z.number().exactOptional(),\n slide: z.object({ index: z.int(), step: z.int() }).exactOptional(),\n }),\n crop: z.object({ path: z.string(), width: z.int(), height: z.int() }),\n })\n .register(wireRegistry, {\n id: \"ResultComment\",\n description: \"One comment thread in results: messages, anchor layers and the screenshot crop.\",\n }) as z.ZodType<ResultComment>;\n\n/** The Zod schema of the `Results` type. */\nexport const Results: z.ZodType<Results> = z\n .object({\n artifact: z.object({\n id: ArtifactId.schema,\n title: z.string(),\n description: z.string().exactOptional(),\n family: z.string().exactOptional(),\n links: z.array(ArtifactLink).readonly(),\n }),\n submission: z.object({\n id: SubmissionId.schema,\n at: z.iso.datetime(),\n epoch: z.int().min(1),\n previous: SubmissionId.schema.exactOptional(),\n policy: SubmissionPolicy,\n channel: z.enum([\"shell\", \"artifact\"]),\n viewer: Viewer,\n versionId: VersionId.schema,\n version: z.int().min(1),\n viewId: ViewId.schema,\n staleView: z.boolean(),\n latestVersion: z.int().min(1).exactOptional(),\n draftRevision: DocumentRevision,\n stateRevision: DocumentRevision.exactOptional(),\n digest: z.string().regex(/^[0-9a-f]{64}$/),\n delivery: z.enum([\"pending\", \"delivered\", \"rejected\", \"undeliverable\"]),\n deliveries: z.array(DeliveryStatus).readonly(),\n }),\n answers: z.record(z.string(), z.unknown()),\n fields: z\n .array(\n z.object({\n id: z.string(),\n label: z.string().exactOptional(),\n required: z.boolean().exactOptional(),\n sensitive: z.boolean().exactOptional(),\n scope: z.enum([\"viewer\", \"artifact\"]),\n }),\n )\n .readonly(),\n state: z.record(z.string(), z.unknown()).exactOptional(),\n choices: z\n .array(\n z.object({\n reviewSetId: z.string(),\n candidateId: z.string(),\n label: z.string().exactOptional(),\n }),\n )\n .readonly(),\n comments: z.array(ResultComment).readonly(),\n orphaned: z\n .array(\n z.object({\n id: z.string(),\n label: z.string().exactOptional(),\n value: z.unknown(),\n fromVersion: z.int().min(1),\n }),\n )\n .readonly(),\n actions: z\n .array(\n z.object({\n runId: z.string(),\n action: z.string(),\n status: z.string(),\n at: z.iso.datetime(),\n }),\n )\n .readonly(),\n signals: z\n .array(\n z.object({ name: z.string(), at: z.iso.datetime(), payload: z.unknown().exactOptional() }),\n )\n .readonly(),\n signalsOmitted: z.int().min(1).exactOptional(),\n signalsCompacted: z.literal(true).exactOptional(),\n })\n .register(wireRegistry, {\n id: \"Results\",\n description:\n \"The complete submission: artifact, submission facts, answers, fields, state, choices, comments, orphans, actions, signals.\",\n }) as z.ZodType<Results>;\n"],"mappings":"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"}
1
+ {"version":3,"file":"interaction.js","names":[],"sources":["../src/interaction.ts"],"sourcesContent":["/**\n * The interaction ledger's wire types (INTERFACES §4, §6, §7, §8; DATA_MODEL §3, §4): viewers,\n * fields and their mutations, events and their filters, `wait` conditions, submissions, deliveries\n * and results. The host protocol methods (`state/*`, `results/get`, `wait`, `events/*`), the\n * submissions and drafts ports, and the browser protocol all speak these shapes.\n */\nimport * as z from \"zod\";\nimport {\n ArtifactId,\n Cursor,\n DeliveryId,\n SubmissionId,\n VersionId,\n ViewerId,\n ViewId,\n} from \"./ids.ts\";\nimport { ArtifactLink, SubmissionPolicy } from \"./manifest.ts\";\nimport type { SubmitChannel } from \"./view.ts\";\nimport { wireRegistry } from \"./wire-registry.ts\";\n\nexport { ControlsPolicy, SubmitChannel, TrustedControl } from \"./view.ts\";\n\n// ── Viewers and actors ────────────────────────────────────────────────────────────────────\n\n/** How Mostra knows a viewer (DATA_MODEL §3 `viewer.kind`). */\n/**\n * How Mostra knows a viewer: `account` and `anonymous` are hosted links' (a signed-in person, and\n * one per browser who isn't signed in, D165 item 8).\n */\nexport type ViewerKind = \"local\" | \"tailnet\" | \"token\" | \"host\" | \"account\" | \"anonymous\";\n\n/**\n * A person who views an artifact (PRODUCT vocabulary). The home's local user is one viewer of kind\n * `local`; a link minted with `viewer` acts as a viewer of kind `token` (D104).\n */\nexport interface Viewer {\n /** The viewer's ID. */\n readonly id: string;\n /** How Mostra knows the viewer. */\n readonly kind: ViewerKind;\n /** The display name, when one is known. */\n readonly name?: string;\n /** The host's own key for this person, as given to `view/url` (D104). */\n readonly ref?: string;\n}\n\n/** The Zod schema of the `Viewer` type. */\nexport const Viewer: z.ZodType<Viewer> = z\n .object({\n id: ViewerId.schema,\n kind: z.enum([\"local\", \"tailnet\", \"token\", \"host\", \"account\", \"anonymous\"]),\n name: z.string().exactOptional(),\n ref: z.string().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"Viewer\",\n description: \"A person who views an artifact: ID, kind, display name and the host's own key.\",\n });\n\n/**\n * The person a capability link acts for (`view/url`'s `viewer`, D104): the host's stable key for\n * them, such as an email or an account ID, and a display name.\n */\nexport interface ViewerSpec {\n /** The host's stable key for this person: the same `ref` always names the same viewer. */\n readonly ref: string;\n /** The name people see; updated when given again. */\n readonly name?: string;\n}\n\n/** The Zod schema of the `ViewerSpec` type. */\nexport const ViewerSpec: z.ZodType<ViewerSpec> = z\n .object({\n ref: z.string().min(1).max(256),\n name: z.string().min(1).max(256).exactOptional(),\n })\n .register(wireRegistry, {\n id: \"ViewerSpec\",\n description: \"The person a capability link acts for: the host's stable key and a display name.\",\n });\n\n/** Who caused an event or wrote a field (DATA_MODEL §4). */\nexport interface Actor {\n /** Who: a viewer, an agent (a protocol client), a host, or Mostra itself. */\n readonly kind: \"viewer\" | \"agent\" | \"host\" | \"mostra\";\n /** A viewer's ID, or the protocol client's name for agents and hosts. */\n readonly id?: string;\n /** A display name, when one is known. */\n readonly name?: string;\n}\n\n/** The Zod schema of the `Actor` type. */\nexport const Actor: z.ZodType<Actor> = z\n .object({\n kind: z.enum([\"viewer\", \"agent\", \"host\", \"mostra\"]),\n id: z.string().exactOptional(),\n name: z.string().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"Actor\",\n description: \"Who caused an event or wrote a field: a viewer, an agent, a host or Mostra.\",\n });\n\n// ── Fields and mutations ──────────────────────────────────────────────────────────────────\n\n/** The longest field ID, in UTF-16 code units. */\nexport const FIELD_ID_MAX_LENGTH = 256;\n\n/**\n * Whether `id` is a field ID (D52): 1 to 256 characters without control characters; dots separate\n * the parts that nest in results, so none is empty.\n */\nexport function isFieldId(id: unknown): id is string {\n return (\n typeof id === \"string\" &&\n id.length >= 1 &&\n id.length <= FIELD_ID_MAX_LENGTH &&\n // biome-ignore lint/suspicious/noControlCharactersInRegex: control characters are what it refuses.\n !/[\\u0000-\\u001f\\u007f]/.test(id) &&\n !id.split(\".\").includes(\"\")\n );\n}\n\n/** Which document a field belongs to: the viewer's draft, or the artifact's shared state (D63). */\nexport type FieldScope = \"viewer\" | \"artifact\";\n\n/**\n * A document revision: the decimal string of a document's monotonic counter (DATA_MODEL §3).\n * `\"0\"` is a document nothing has written yet.\n */\nexport type DocumentRevision = string;\n\n/** The Zod schema of the `DocumentRevision` type. */\nexport const DocumentRevision: z.ZodType<DocumentRevision> = z\n .string()\n .regex(/^(0|[1-9][0-9]{0,15})$/)\n .register(wireRegistry, {\n id: \"DocumentRevision\",\n description: \"A draft's or artifact state's revision: a non-negative decimal integer string.\",\n });\n\n/**\n * One change to one field. Exactly one of `value` and `delete` is given. The optional metadata\n * travels with the field into results and decides what events redact (D52, D106).\n */\nexport interface FieldOp {\n /** The field ID (D52). */\n readonly id: string;\n /** The new value: any JSON value, `null` included. */\n readonly value?: unknown;\n /** Removes the field. */\n readonly delete?: true;\n /** The label people see in results and the shell's blocker list. */\n readonly label?: string;\n /** Whether the shell asks for it before submit. */\n readonly required?: boolean;\n /** Kept in submissions and results, redacted from events and logs (D52). */\n readonly sensitive?: boolean;\n}\n\n/** The Zod schema of the `FieldOp` type. */\nexport const FieldOp: z.ZodType<FieldOp> = z\n .object({\n id: z.string().min(1).max(FIELD_ID_MAX_LENGTH),\n value: z.unknown().exactOptional(),\n delete: z.literal(true).exactOptional(),\n label: z.string().max(1024).exactOptional(),\n required: z.boolean().exactOptional(),\n sensitive: z.boolean().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"FieldOp\",\n description:\n \"One change to one field: a value or a delete, with optional label, required and sensitive.\",\n }) as z.ZodType<FieldOp>;\n\n/** A field's current state. */\nexport interface FieldState {\n /** The field's value: any JSON value. */\n readonly value: unknown;\n /** The document revision that last wrote it. */\n readonly revision: DocumentRevision;\n /** Who wrote it last. */\n readonly updatedBy?: Actor;\n /** When it was written last. */\n readonly updatedAt: string;\n /** The label people see. */\n readonly label?: string;\n /** Whether the shell asks for it before submit. */\n readonly required?: boolean;\n /** Whether events and logs redact its value (D52). */\n readonly sensitive?: boolean;\n}\n\n/** The Zod schema of the `FieldState` type. */\nexport const FieldState: z.ZodType<FieldState> = z\n .object({\n value: z.unknown(),\n revision: DocumentRevision,\n updatedBy: Actor.exactOptional(),\n updatedAt: z.iso.datetime(),\n label: z.string().exactOptional(),\n required: z.boolean().exactOptional(),\n sensitive: z.boolean().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"FieldState\",\n description: \"A field's current value, the revision that wrote it, who wrote it and when.\",\n }) as z.ZodType<FieldState>;\n\n/**\n * A field op that wasn't applied because the field changed after the mutation's base revision\n * (D22, FAILURE_MODEL §5): what the field holds now, so the writer can keep theirs or take it.\n */\nexport interface FieldConflict {\n /** The field's ID. */\n readonly id: string;\n /** The revision that last changed the field. */\n readonly revision: DocumentRevision;\n /** Its current value; absent when it was deleted. */\n readonly value?: unknown;\n /** `true` when the field was deleted. */\n readonly deleted?: true;\n /** Who changed it. */\n readonly updatedBy?: Actor;\n /** When it changed. */\n readonly updatedAt?: string;\n}\n\n/** The Zod schema of the `FieldConflict` type. */\nexport const FieldConflict: z.ZodType<FieldConflict> = z\n .object({\n id: z.string(),\n revision: DocumentRevision,\n value: z.unknown().exactOptional(),\n deleted: z.literal(true).exactOptional(),\n updatedBy: Actor.exactOptional(),\n updatedAt: z.iso.datetime().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"FieldConflict\",\n description: \"A field op not applied because the field changed after the base revision.\",\n }) as z.ZodType<FieldConflict>;\n\n/** What a mutation did: the document's revision after it, the ops applied, and the conflicts. */\nexport interface MutationResult {\n /** The document's revision after the mutation; unchanged when nothing applied. */\n readonly revision: DocumentRevision;\n /** The field IDs whose ops were applied. */\n readonly applied: readonly string[];\n /** The ops not applied, with what each field holds now. */\n readonly conflicts: readonly FieldConflict[];\n}\n\n/** The Zod schema of the `MutationResult` type. */\nexport const MutationResult: z.ZodType<MutationResult> = z\n .object({\n revision: DocumentRevision,\n applied: z.array(z.string()).readonly(),\n conflicts: z.array(FieldConflict).readonly(),\n })\n .register(wireRegistry, {\n id: \"MutationResult\",\n description:\n \"A mutation's outcome: the revision after it, the applied field IDs, the conflicts.\",\n });\n\n// ── Events ────────────────────────────────────────────────────────────────────────────────\n\n/**\n * Where an owner instance's copy of a hosted record came from (INTERFACES §18.2, D165 item 1): the\n * server, the hosted home, its incarnation and the record's cursor there (a submission's is the\n * cursor of its `submission.created`).\n */\nexport interface EventOrigin {\n /** The server's API origin. */\n readonly server: string;\n /** The hosted home's `hom_` ID. */\n readonly home: string;\n /** The hosted home's incarnation when the record was copied. */\n readonly incarnation: string;\n /** The record's cursor in the hosted home. */\n readonly cursor: Cursor;\n}\n\n/** The Zod schema of the `EventOrigin` type. */\nexport const EventOrigin: z.ZodType<EventOrigin> = z\n .object({\n server: z.string().min(1),\n home: z.string().min(1),\n incarnation: z.string().min(1),\n cursor: Cursor.schema,\n })\n .register(wireRegistry, {\n id: \"EventOrigin\",\n description:\n \"Where an owner's copy of a hosted record came from: server, home, incarnation, cursor.\",\n }) as z.ZodType<EventOrigin>;\n\n/**\n * One durable event (DATA_MODEL §4). Its cursor is its stable ID and its place in the home-wide\n * order; `seq` orders an artifact's own events without gaps.\n */\nexport interface EventRecord {\n /** The event's stable ID and home-wide position. */\n readonly cursor: Cursor;\n /** The artifact, or `null` for a home-wide event. */\n readonly artifactId: string | null;\n /** The artifact's sequence number, or `null` for a home-wide event. */\n readonly seq: number | null;\n /** The type from DATA_MODEL §4's catalog. */\n readonly type: string;\n /** When it was appended. */\n readonly at: string;\n /** Who caused it. */\n readonly actor: Actor;\n /** What caused it: a run, a mutation, a submission. */\n readonly causation?: Readonly<Record<string, string>>;\n /** The event's data; sensitive field values are redacted (D52). */\n readonly payload: Readonly<Record<string, unknown>>;\n /** For an event an owner instance copied from its hosted home: where it came from. */\n readonly origin?: EventOrigin;\n}\n\n/** The Zod schema of the `EventRecord` type. */\nexport const EventRecord: z.ZodType<EventRecord> = z\n .object({\n cursor: Cursor.schema,\n artifactId: ArtifactId.schema.nullable(),\n seq: z.int().min(1).nullable(),\n type: z.string(),\n at: z.iso.datetime(),\n actor: Actor,\n causation: z.record(z.string(), z.string()).exactOptional(),\n payload: z.record(z.string(), z.unknown()),\n origin: EventOrigin.exactOptional(),\n })\n .register(wireRegistry, {\n id: \"EventRecord\",\n description:\n \"One durable event: cursor, artifact, per-artifact sequence, type, time, actor, payload.\",\n }) as z.ZodType<EventRecord>;\n\n/**\n * An event type, or a family of them: `submission.created`, or `submission.*` for every type that\n * starts with `submission.`.\n */\nexport type EventTypePattern = string;\n\n/** The Zod schema of the `EventTypePattern` type. */\nexport const EventTypePattern: z.ZodType<EventTypePattern> = z\n .string()\n .regex(/^[a-z][a-zA-Z0-9_-]*(\\.[a-zA-Z0-9_-]+)*(\\.\\*)?$/)\n .register(wireRegistry, {\n id: \"EventTypePattern\",\n description: \"An event type (submission.created) or a family of them (submission.*).\",\n });\n\n/**\n * Which events a reader wants (IN-08, H-09). Both parts are optional, and an event must pass both.\n * `artifact.compacted` always passes for a matching artifact, so a filtered reader still learns of\n * a compaction (DATA_MODEL §4).\n */\nexport interface EventFilter {\n /** Only these artifacts' events; absent: every artifact's, and home-wide ones. */\n readonly artifacts?: readonly string[];\n /** Only these types; absent: every type. */\n readonly types?: readonly EventTypePattern[];\n}\n\n/** The Zod schema of the `EventFilter` type. */\nexport const EventFilter: z.ZodType<EventFilter> = z\n .object({\n artifacts: z.array(ArtifactId.schema).max(1000).readonly().exactOptional(),\n types: z.array(EventTypePattern).max(100).readonly().exactOptional(),\n })\n .register(wireRegistry, {\n id: \"EventFilter\",\n description:\n \"Which events a reader wants: these artifacts' and these types (patterns allowed).\",\n });\n\n/**\n * What `wait` waits for (ARCHITECTURE §6, D103): `submitted`, `signal:<name>`, `state:<fieldId>`\n * or `event:<type pattern>`.\n */\nexport type WaitCondition = string;\n\n/** A signal's name: letters, digits, `.`, `_` and `-`, starting with a letter or digit (D106). */\nexport const SIGNAL_NAME_PATTERN: RegExp = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;\n\n/** The Zod schema of the `WaitCondition` type. */\nexport const WaitCondition: z.ZodType<WaitCondition> = z\n .string()\n .regex(\n // biome-ignore lint/suspicious/noControlCharactersInRegex: field IDs exclude control characters.\n /^(submitted|signal:[A-Za-z0-9][A-Za-z0-9._-]{0,63}|state:[^\\u0000-\\u001f\\u007f]{1,256}|event:[a-z][a-zA-Z0-9_-]*(\\.[a-zA-Z0-9_-]+)*(\\.\\*)?)$/,\n )\n .register(wireRegistry, {\n id: \"WaitCondition\",\n description: \"What wait waits for: submitted, signal:<name>, state:<fieldId> or event:<type>.\",\n });\n\n// ── Submissions, deliveries and results ──────────────────────────────────────────────────\n\n/** A delivery's state (FAILURE_MODEL §4). */\nexport type DeliveryState = \"pending\" | \"delivered\" | \"rejected\" | \"undeliverable\";\n\n/** One submission's delivery to one host (D105). */\nexport interface DeliveryStatus {\n /** The delivery's stable ID (`dlv_`), repeated by every redelivery. */\n readonly deliveryId: string;\n /**\n * The host: its client name. Empty for Mostra's built-in adapter, which takes submissions when no\n * host does; client names are never empty, so no host can be mistaken for it (D105).\n */\n readonly owner: string;\n /** Where the delivery stands. */\n readonly state: DeliveryState;\n /** How many times Mostra called the host for it. */\n readonly attempts: number;\n /** The host's reason, for a rejection. */\n readonly reason?: string;\n /**\n * `true` while a pending delivery waits: its host isn't connected, or an attempt failed and it\n * will be retried (D47's \"Pending delivery\"). Absent while the first attempt is under way.\n */\n readonly waiting?: true;\n /** When its state last changed. */\n readonly updatedAt: string;\n}\n\n/** The Zod schema of the `DeliveryStatus` type. */\nexport const DeliveryStatus: z.ZodType<DeliveryStatus> = z\n .object({\n deliveryId: DeliveryId.schema,\n owner: z.string(),\n state: z.enum([\"pending\", \"delivered\", \"rejected\", \"undeliverable\"]),\n attempts: z.int().min(0),\n reason: z.string().exactOptional(),\n waiting: z.literal(true).exactOptional(),\n updatedAt: z.iso.datetime(),\n })\n .register(wireRegistry, {\n id: \"DeliveryStatus\",\n description: \"One submission's delivery to one host: owner, state, attempts and reason.\",\n });\n\n/** A submission as a submit answers it (INTERFACES §4). */\nexport interface SubmissionSummary {\n /** The submission's ID. */\n readonly id: string;\n /** When it was made. */\n readonly at: string;\n /** The draft epoch it closed (D103); 1 outside `epochs`. */\n readonly epoch: number;\n /** Where the submit came from (D40). */\n readonly channel: SubmitChannel;\n /** The version the view showed. */\n readonly versionId: string;\n /** That version's number. */\n readonly version: number;\n /** The view it was made from. */\n readonly viewId: string;\n /** Whether a newer version existed when the viewer submitted (H-10). */\n readonly staleView: boolean;\n /** The draft revision it was made from. */\n readonly draftRevision: DocumentRevision;\n /** SHA-256 of the snapshot's canonical JSON (RFC 8785), lowercase hex. */\n readonly digest: string;\n /** Every delivery's state, summed up: the worst of them. */\n readonly delivery: DeliveryState;\n /** Each host's delivery, so a viewer sees which host has it (IN-13). */\n readonly deliveries?: readonly DeliveryStatus[];\n /** `true` when this submit repeated an earlier one and got it back (D22). */\n readonly duplicate?: true;\n}\n\n/** The Zod schema of the `SubmissionSummary` type. */\nexport const SubmissionSummary: z.ZodType<SubmissionSummary> = z\n .object({\n id: SubmissionId.schema,\n at: z.iso.datetime(),\n epoch: z.int().min(1),\n channel: z.enum([\"shell\", \"artifact\"]),\n versionId: VersionId.schema,\n version: z.int().min(1),\n viewId: ViewId.schema,\n staleView: z.boolean(),\n draftRevision: DocumentRevision,\n digest: z.string().regex(/^[0-9a-f]{64}$/),\n delivery: z.enum([\"pending\", \"delivered\", \"rejected\", \"undeliverable\"]),\n deliveries: z.array(DeliveryStatus).readonly().exactOptional(),\n duplicate: z.literal(true).exactOptional(),\n })\n .register(wireRegistry, {\n id: \"SubmissionSummary\",\n description:\n \"A submission as a submit answers it: ID, time, epoch, version, view, digest, delivery.\",\n });\n\n/** A rectangle in CSS pixels, relative to its frame. */\nexport interface Rect {\n /** Distance from the frame's left edge. */\n readonly x: number;\n /** Distance from the frame's top edge. */\n readonly y: number;\n /** Width. */\n readonly width: number;\n /** Height. */\n readonly height: number;\n}\n\n/** A viewport: its size in CSS pixels and its device pixel ratio. */\nexport interface Viewport {\n /** Width in CSS pixels. */\n readonly width: number;\n /** Height in CSS pixels. */\n readonly height: number;\n /** Device pixel ratio. */\n readonly dpr: number;\n}\n\n/** One comment thread in results (INTERFACES §8; built by the review layer, WP-20). */\nexport interface ResultComment {\n /** The thread's ID. */\n readonly threadId: string;\n /** Whether the thread is open or resolved. */\n readonly status: \"open\" | \"resolved\";\n /** The thread's messages, oldest first, each with its author. */\n readonly messages: readonly {\n readonly author: Viewer;\n readonly at: string;\n readonly text: string;\n }[];\n /** Every layer of the anchor that applies (D23). */\n readonly anchor: {\n readonly reviewId?: string;\n /** W3C Web Annotation selectors. */\n readonly selectors?: readonly unknown[];\n readonly rect?: Rect;\n readonly viewport?: Viewport;\n readonly page?: string;\n readonly candidateId?: string;\n readonly terminal?: {\n readonly rows: readonly [number, number];\n readonly cols: readonly [number, number];\n readonly t?: number;\n };\n readonly time?: number;\n readonly slide?: { readonly index: number; readonly step: number };\n };\n /** The screenshot crop, always stored (D23). */\n readonly crop: { readonly path: string; readonly width: number; readonly height: number };\n}\n\n/**\n * The complete submission (INTERFACES §8): what `results/get`, `mostra results` and the\n * submissions port carry. Everything in it comes from the immutable submission and the version it\n * names, never from the live draft (IN-06).\n */\nexport interface Results {\n /** The artifact, with the metadata of the version the viewer saw. */\n readonly artifact: {\n readonly id: string;\n readonly title: string;\n readonly description?: string;\n readonly family?: string;\n readonly links: readonly ArtifactLink[];\n };\n /** The submission's facts: when, how, by whom, from which version and view, and its delivery. */\n readonly submission: {\n readonly id: string;\n readonly at: string;\n readonly epoch: number;\n /** The same viewer's previous submission, under `epochs` (D103). */\n readonly previous?: string;\n readonly policy: SubmissionPolicy;\n readonly channel: SubmitChannel;\n readonly viewer: Viewer;\n readonly versionId: string;\n readonly version: number;\n readonly viewId: string;\n /** Whether a newer version existed when the viewer submitted (H-10). */\n readonly staleView: boolean;\n /** The newest version's number at the time, when the view was stale. */\n readonly latestVersion?: number;\n readonly draftRevision: DocumentRevision;\n readonly stateRevision?: DocumentRevision;\n readonly digest: string;\n readonly delivery: DeliveryState;\n readonly deliveries: readonly DeliveryStatus[];\n /** For a submission imported from a hosted home: where it came from (D165 item 1). */\n readonly origin?: EventOrigin;\n };\n /** The draft's fields by ID, dotted IDs nested (D52). */\n readonly answers: Readonly<Record<string, unknown>>;\n /** Every field in `answers` and `state`, with its label and scope. */\n readonly fields: readonly {\n readonly id: string;\n readonly label?: string;\n readonly required?: boolean;\n readonly sensitive?: boolean;\n readonly scope: FieldScope;\n }[];\n /** Artifact state at `stateRevision`, dotted IDs nested (D63). */\n readonly state?: Readonly<Record<string, unknown>>;\n /** The review sets' choices: the fields `review.<set>.choice` (D65). */\n readonly choices: readonly {\n readonly reviewSetId: string;\n readonly candidateId: string;\n readonly label?: string;\n }[];\n /** Comment threads with their anchors and crops (WP-20). */\n readonly comments: readonly ResultComment[];\n /** Answers a newer version couldn't map (D42). */\n readonly orphaned: readonly {\n readonly id: string;\n readonly label?: string;\n readonly value: unknown;\n readonly fromVersion: number;\n }[];\n /** Action runs started in this view (WP-08). */\n readonly actions: readonly {\n readonly runId: string;\n readonly action: string;\n readonly status: string;\n readonly at: string;\n }[];\n /** Signals raised in this view before the submission: the newest 100, within 1 MiB of payloads. */\n readonly signals: readonly {\n readonly name: string;\n readonly at: string;\n readonly payload?: unknown;\n }[];\n /** How many older signals of the view the limit left out; absent when none. */\n readonly signalsOmitted?: number;\n /** Set when compaction removed events of this view before it submitted, so signals may be missing. */\n readonly signalsCompacted?: true;\n}\n\nconst RectSchema = z.object({\n x: z.number(),\n y: z.number(),\n width: z.number(),\n height: z.number(),\n});\n\n/** The Zod schema of the `ResultComment` type. */\nexport const ResultComment: z.ZodType<ResultComment> = z\n .object({\n threadId: z.string(),\n status: z.enum([\"open\", \"resolved\"]),\n messages: z\n .array(z.object({ author: Viewer, at: z.iso.datetime(), text: z.string() }))\n .readonly(),\n anchor: z.object({\n reviewId: z.string().exactOptional(),\n selectors: z.array(z.unknown()).readonly().exactOptional(),\n rect: RectSchema.exactOptional(),\n viewport: z\n .object({ width: z.number(), height: z.number(), dpr: z.number() })\n .exactOptional(),\n page: z.string().exactOptional(),\n candidateId: z.string().exactOptional(),\n terminal: z\n .object({\n rows: z.tuple([z.int(), z.int()]).readonly(),\n cols: z.tuple([z.int(), z.int()]).readonly(),\n t: z.number().exactOptional(),\n })\n .exactOptional(),\n time: z.number().exactOptional(),\n slide: z.object({ index: z.int(), step: z.int() }).exactOptional(),\n }),\n crop: z.object({ path: z.string(), width: z.int(), height: z.int() }),\n })\n .register(wireRegistry, {\n id: \"ResultComment\",\n description: \"One comment thread in results: messages, anchor layers and the screenshot crop.\",\n }) as z.ZodType<ResultComment>;\n\n/** The Zod schema of the `Results` type. */\nexport const Results: z.ZodType<Results> = z\n .object({\n artifact: z.object({\n id: ArtifactId.schema,\n title: z.string(),\n description: z.string().exactOptional(),\n family: z.string().exactOptional(),\n links: z.array(ArtifactLink).readonly(),\n }),\n submission: z.object({\n id: SubmissionId.schema,\n at: z.iso.datetime(),\n epoch: z.int().min(1),\n previous: SubmissionId.schema.exactOptional(),\n policy: SubmissionPolicy,\n channel: z.enum([\"shell\", \"artifact\"]),\n viewer: Viewer,\n versionId: VersionId.schema,\n version: z.int().min(1),\n viewId: ViewId.schema,\n staleView: z.boolean(),\n latestVersion: z.int().min(1).exactOptional(),\n draftRevision: DocumentRevision,\n stateRevision: DocumentRevision.exactOptional(),\n digest: z.string().regex(/^[0-9a-f]{64}$/),\n delivery: z.enum([\"pending\", \"delivered\", \"rejected\", \"undeliverable\"]),\n deliveries: z.array(DeliveryStatus).readonly(),\n origin: EventOrigin.exactOptional(),\n }),\n answers: z.record(z.string(), z.unknown()),\n fields: z\n .array(\n z.object({\n id: z.string(),\n label: z.string().exactOptional(),\n required: z.boolean().exactOptional(),\n sensitive: z.boolean().exactOptional(),\n scope: z.enum([\"viewer\", \"artifact\"]),\n }),\n )\n .readonly(),\n state: z.record(z.string(), z.unknown()).exactOptional(),\n choices: z\n .array(\n z.object({\n reviewSetId: z.string(),\n candidateId: z.string(),\n label: z.string().exactOptional(),\n }),\n )\n .readonly(),\n comments: z.array(ResultComment).readonly(),\n orphaned: z\n .array(\n z.object({\n id: z.string(),\n label: z.string().exactOptional(),\n value: z.unknown(),\n fromVersion: z.int().min(1),\n }),\n )\n .readonly(),\n actions: z\n .array(\n z.object({\n runId: z.string(),\n action: z.string(),\n status: z.string(),\n at: z.iso.datetime(),\n }),\n )\n .readonly(),\n signals: z\n .array(\n z.object({ name: z.string(), at: z.iso.datetime(), payload: z.unknown().exactOptional() }),\n )\n .readonly(),\n signalsOmitted: z.int().min(1).exactOptional(),\n signalsCompacted: z.literal(true).exactOptional(),\n })\n .register(wireRegistry, {\n id: \"Results\",\n description:\n \"The complete submission: artifact, submission facts, answers, fields, state, choices, comments, orphans, actions, signals.\",\n }) as z.ZodType<Results>;\n"],"mappings":"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"}
@@ -1,3 +1,5 @@
1
+ import { Duration } from "./duration.js";
2
+ import { SubmissionPolicy } from "./policy.js";
1
3
  import * as z from "zod";
2
4
  //#region src/manifest.d.ts
3
5
  /** The families Mostra's templates and gallery know; any other string is allowed too. */
@@ -9,18 +11,6 @@ export interface ArtifactLink {
9
11
  /** The other artifact's ID. */
10
12
  readonly artifact: string;
11
13
  }
12
- /**
13
- * The submission policy an artifact requests (D10, D39, D63). The host decides the policy in force;
14
- * the manifest only asks for one.
15
- */
16
- export type SubmissionPolicy = {
17
- readonly policy: "once";
18
- readonly scope?: "per-artifact" | "per-viewer";
19
- } | {
20
- readonly policy: "epochs";
21
- } | {
22
- readonly policy: "none";
23
- };
24
14
  /** A live terminal session the artifact declares (ROUND-3 §5.1, D65). */
25
15
  export interface TerminalSpec {
26
16
  /** The program and its arguments. */
@@ -46,6 +36,45 @@ export type DemoSpec = {
46
36
  readonly attach: number;
47
37
  readonly bridge?: boolean;
48
38
  };
39
+ /**
40
+ * A count by choice the artifact opts into (D165 item 12, RM-07): every accepted submission adds
41
+ * one to the choice its viewer-scoped `field` holds, counted in the submit transaction, and viewers
42
+ * read the counts with `useLive("$tally/<field>")`. A value outside `choices`, or none, counts
43
+ * nothing, so free text is never shown.
44
+ */
45
+ export interface TallySpec {
46
+ /** The viewer-scoped field whose value is counted. */
47
+ readonly field: string;
48
+ /** The values counted: 2 to 50 distinct strings. */
49
+ readonly choices: readonly string[];
50
+ /** Below this many answers (default 0), viewers see only the total, never the counts. */
51
+ readonly minTotal?: number;
52
+ }
53
+ /** How the artifact behaves on a remote server (D165, INTERFACES §18). */
54
+ export interface HostedSettings {
55
+ /**
56
+ * Relayed action runs while the owner instance is away (D165 item 4): `queue` (the default)
57
+ * waits up to `limit` (default `24h`, at most `7d`), `fail` ends a run at once.
58
+ */
59
+ readonly offline?: {
60
+ readonly actions?: "queue" | "fail";
61
+ readonly limit?: Duration;
62
+ };
63
+ /** Who may trigger relayed actions (D159): `signed-in` (the default) or anyone with the `link`. */
64
+ readonly actions?: "signed-in" | "link";
65
+ /** Who may submit (D165 item 13): anyone with the `link` (the default), or `signed-in` viewers. */
66
+ readonly submissions?: "link" | "signed-in";
67
+ /** Link previews (D161): `generic` (the default) or the artifact's `title`. */
68
+ readonly preview?: "generic" | "title";
69
+ }
70
+ /** The longest offline limit a hosted artifact may set: 7 days (D165 item 4). */
71
+ export declare const HOSTED_OFFLINE_LIMIT_MAX_MS: number;
72
+ /** The offline limit of a hosted artifact that sets none: 24 hours (D165 item 4). */
73
+ export declare const HOSTED_OFFLINE_LIMIT_DEFAULT: Duration;
74
+ /** The fewest and most choices a tally counts (INTERFACES §18.4). */
75
+ export declare const TALLY_CHOICES_MIN = 2;
76
+ /** The most choices a tally counts. */
77
+ export declare const TALLY_CHOICES_MAX = 50;
49
78
  /** The artifact manifest (INTERFACES §2.2). Every field except `title` is optional. */
50
79
  export interface ArtifactManifest {
51
80
  /** The artifact's ID. Written by `mostra new`; without one, the artifact is bound to its source path at first publish (D51). */
@@ -84,14 +113,30 @@ export interface ArtifactManifest {
84
113
  readonly extraChecks?: readonly string[];
85
114
  readonly smoke?: boolean;
86
115
  };
116
+ /** Counts by choice of fixed-choice fields (D165 item 12). */
117
+ readonly tally?: readonly TallySpec[];
118
+ /** How the artifact behaves on a remote server (D165). */
119
+ readonly hosted?: HostedSettings;
87
120
  }
88
121
  /** The keys of the artifact manifest, in INTERFACES §2.2 order. Other keys are warnings (FAILURE_MODEL §10). */
89
122
  export declare const ARTIFACT_MANIFEST_KEYS: readonly (keyof ArtifactManifest)[];
90
123
  /** The Zod schema of the `ArtifactLink` type. */
91
124
  export declare const ArtifactLink: z.ZodType<ArtifactLink>;
92
- /** The Zod schema of the `SubmissionPolicy` type. */
93
- export declare const SubmissionPolicy: z.ZodType<SubmissionPolicy>;
125
+ /** The Zod schema of the `TallySpec` type. */
126
+ export declare const TallySpec: z.ZodType<TallySpec>;
127
+ /** The Zod schema of the `HostedSettings` type. */
128
+ export declare const HostedSettings: z.ZodType<HostedSettings>;
94
129
  /** The Zod schema of the `ArtifactManifest` type. Objects stay open, so newer keys pass through. */
95
130
  export declare const ArtifactManifest: z.ZodType<ArtifactManifest>;
131
+ /**
132
+ * The rules of a manifest that JSON Schema can't state, checked after its schema by everything
133
+ * that reads a manifest (D165 items 4, 12): a tally's choices are distinct, each field is tallied
134
+ * once, and an offline limit is at most 7 days. Answers the first problem, with its field's path.
135
+ */
136
+ export declare function manifestProblem(manifest: ArtifactManifest): {
137
+ readonly path: string;
138
+ readonly message: string;
139
+ } | undefined;
96
140
  //#endregion
141
+ export { SubmissionPolicy };
97
142
  //# sourceMappingURL=manifest.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"manifest.d.ts","names":[],"sources":["../src/manifest.ts"],"mappings":";;;YAeY;;iBAaK;;WAEN;;WAEA;;;;;;YAOC;WACG;WAAyB;;WACzB;;WACA;;;iBAGE;;WAEN;;WAEA;;WAEA,MAAM,SAAS;;WAEf;;WAEA;;WAEA;;;YAIC;WAEG;WACA;WACA;WACA;;WAEA;WAAyB;;;iBAGvB;;WAEN;;WAEA;;WAEA;;WAEA,SAAS;;WAET,iBAAiB;;WAEjB;;WAEA,aAAa;;WAEb;aAAiB;aAAkC;;;WAEnD,YAAY,SAAS,eAAe;;WAEpC,QAAQ,SAAS,eAAe;;WAEhC;aACE;aACA;aACA;;;WAGF;aACE;aACA;aACA;aACA;;;;qBAKA,wCAAwC;;qBAkBxC,cAAc,EAAE,QAAQ;;qBAQxB,kBAAkB,EAAE,QAAQ;;qBAkC5B,kBAAkB,EAAE,QAAQ"}
1
+ {"version":3,"file":"manifest.d.ts","names":[],"sources":["../src/manifest.ts"],"mappings":";;;;;YAoBY;;iBAaK;;WAEN;;WAEA;;;iBAIM;;WAEN;;WAEA;;WAEA,MAAM,SAAS;;WAEf;;WAEA;;WAEA;;;YAIC;WAEG;WACA;WACA;WACA;;WAEA;WAAyB;;;;;;;;iBAQvB;;WAEN;;WAEA;;WAEA;;;iBAIM;;;;;WAKN;aAAqB;aAAqC,QAAQ;;;WAElE;;WAEA;;WAEA;;;qBAIE;;qBAGA,8BAA8B;;qBAG9B;;qBAEA;;iBAGI;;WAEN;;WAEA;;WAEA;;WAEA,SAAS;;WAET,iBAAiB;;WAEjB;;WAEA,aAAa;;WAEb;aAAiB;aAAkC;;;WAEnD,YAAY,SAAS,eAAe;;WAEpC,QAAQ,SAAS,eAAe;;WAEhC;aACE;aACA;aACA;;;WAGF;aACE;aACA;aACA;aACA;;;WAGF,iBAAiB;;WAEjB,SAAS;;;qBAIP,wCAAwC;;qBAoBxC,cAAc,EAAE,QAAQ;;qBA2BxB,WAAW,EAAE,QAAQ;;qBAiBrB,gBAAgB,EAAE,QAAQ;;qBAmB1B,kBAAkB,EAAE,QAAQ;;;;;;wBA8CzB,gBACd,UAAU;WACE;WAAuB"}