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