@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
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A hosted home's events for its operator (INTERFACES §18.6, D165 item 9): `submission.accepted`
|
|
3
|
+
* (with the submission's Results), `version.pushed`, `run.ended` and `roster.completed` (D168), and
|
|
4
|
+
* an invitation for each expected respondent with an email whom the roster added or gave a new
|
|
5
|
+
* personal link (`roster.changed`'s `added` and `relinked`), read from the home's own
|
|
6
|
+
* event log after `operator_cursor` and handed to the server's durable outbound queue, so each is
|
|
7
|
+
* delivered at least once with a stable ID (`<home>:<incarnation>:<cursor>`). The cursor moves
|
|
8
|
+
* only after the queue holds what was read; a crash between them hands the same events again,
|
|
9
|
+
* under the same IDs. Submissions are counted for metering on the same read. Each event carries
|
|
10
|
+
* its route's label beside its ID (D167).
|
|
11
|
+
*
|
|
12
|
+
* With neither an events nor a metering port, the cursor follows the head, so an operator added
|
|
13
|
+
* later starts from then rather than from the home's whole history.
|
|
14
|
+
*/
|
|
15
|
+
import type { OperatorEvent } from "@mostra/protocol/operator";
|
|
16
|
+
import type { Interaction } from "../interaction/index.ts";
|
|
17
|
+
import type { Ledger } from "../ledger/index.ts";
|
|
18
|
+
import type { Log } from "../log.ts";
|
|
19
|
+
import type { Meter } from "./metering.ts";
|
|
20
|
+
import type { Operator } from "./operator.ts";
|
|
21
|
+
|
|
22
|
+
/** How many events one read takes. */
|
|
23
|
+
const PAGE = 200;
|
|
24
|
+
|
|
25
|
+
/** Options for {@link createOperatorFeed}. */
|
|
26
|
+
export interface OperatorFeedOptions {
|
|
27
|
+
readonly homeId: string;
|
|
28
|
+
readonly ledger: Ledger;
|
|
29
|
+
readonly interaction: Interaction;
|
|
30
|
+
readonly operator: Operator;
|
|
31
|
+
readonly meter: Meter;
|
|
32
|
+
readonly account: () => string;
|
|
33
|
+
/** Who sends the home's invitations: its owner's name and how it was verified. */
|
|
34
|
+
readonly sender?: () => { readonly name?: string; readonly verifiedBy?: string };
|
|
35
|
+
readonly routeOf: (
|
|
36
|
+
artifactId: string,
|
|
37
|
+
) => { readonly id: string; readonly label: string } | undefined;
|
|
38
|
+
readonly incarnation: () => string;
|
|
39
|
+
readonly log: Log;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** The feed of one open hosted home. */
|
|
43
|
+
export interface OperatorFeed {
|
|
44
|
+
/** Reads what is new now (after every commit, and when the home opens). */
|
|
45
|
+
scan(): void;
|
|
46
|
+
stop(): void;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
interface EventRow {
|
|
50
|
+
readonly cursor: number;
|
|
51
|
+
readonly artifact_id: string | null;
|
|
52
|
+
readonly type: string;
|
|
53
|
+
readonly payload_json: string;
|
|
54
|
+
readonly at: string;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
const RUN_ENDS = new Map([
|
|
58
|
+
["action.succeeded", "succeeded"],
|
|
59
|
+
["action.failed", "failed"],
|
|
60
|
+
["action.cancelled", "cancelled"],
|
|
61
|
+
["action.unknown", "unknown"],
|
|
62
|
+
]);
|
|
63
|
+
|
|
64
|
+
/** Starts the feed of a home. */
|
|
65
|
+
export function createOperatorFeed(options: OperatorFeedOptions): OperatorFeed {
|
|
66
|
+
const { ledger, operator, meter, log } = options;
|
|
67
|
+
const wanted = operator.has.events || meter.on || operator.has.invitations;
|
|
68
|
+
let stopped = false;
|
|
69
|
+
let scheduled = false;
|
|
70
|
+
|
|
71
|
+
const cursorOf = (): number =>
|
|
72
|
+
ledger.read(
|
|
73
|
+
(db) =>
|
|
74
|
+
db.get<{ cursor: number }>("SELECT cursor FROM operator_cursor WHERE id = 1")?.cursor ?? -1,
|
|
75
|
+
);
|
|
76
|
+
/**
|
|
77
|
+
* Moves the cursor forward. It writes only when the cursor moves, since every write is a commit
|
|
78
|
+
* that schedules another read: a write that changed nothing would read again for ever.
|
|
79
|
+
*/
|
|
80
|
+
const setCursor = (cursor: number): void => {
|
|
81
|
+
if (cursor <= cursorOf()) return;
|
|
82
|
+
ledger.write((db) =>
|
|
83
|
+
db.run(
|
|
84
|
+
`INSERT INTO operator_cursor (id, cursor) VALUES (1, ?)
|
|
85
|
+
ON CONFLICT (id) DO UPDATE SET cursor = MAX(cursor, excluded.cursor)`,
|
|
86
|
+
cursor,
|
|
87
|
+
),
|
|
88
|
+
);
|
|
89
|
+
};
|
|
90
|
+
const head = (): number =>
|
|
91
|
+
ledger.read(
|
|
92
|
+
(db) => db.get<{ head: number | null }>("SELECT MAX(cursor) AS head FROM event")?.head ?? 0,
|
|
93
|
+
);
|
|
94
|
+
|
|
95
|
+
const toEvent = (row: EventRow): OperatorEvent | undefined => {
|
|
96
|
+
if (row.artifact_id === null) return undefined;
|
|
97
|
+
const route = options.routeOf(row.artifact_id);
|
|
98
|
+
if (!route) return undefined;
|
|
99
|
+
const payload = JSON.parse(row.payload_json) as Record<string, unknown>;
|
|
100
|
+
const base = {
|
|
101
|
+
eventId: `${options.homeId}:${options.incarnation()}:${row.cursor}`,
|
|
102
|
+
account: options.account(),
|
|
103
|
+
home: options.homeId,
|
|
104
|
+
routeId: route.id,
|
|
105
|
+
label: route.label,
|
|
106
|
+
artifactId: row.artifact_id,
|
|
107
|
+
at: row.at,
|
|
108
|
+
};
|
|
109
|
+
if (row.type === "submission.created") {
|
|
110
|
+
const results = options.interaction.resultsOf(String(payload["submissionId"]));
|
|
111
|
+
return results ? { ...base, kind: "submission.accepted", payload: results } : undefined;
|
|
112
|
+
}
|
|
113
|
+
if (row.type === "version.published") {
|
|
114
|
+
return {
|
|
115
|
+
...base,
|
|
116
|
+
kind: "version.pushed",
|
|
117
|
+
payload: { versionId: payload["versionId"], number: payload["number"] },
|
|
118
|
+
};
|
|
119
|
+
}
|
|
120
|
+
if (row.type === "roster.completed") {
|
|
121
|
+
return {
|
|
122
|
+
...base,
|
|
123
|
+
kind: "roster.completed",
|
|
124
|
+
payload: {
|
|
125
|
+
round: payload["round"],
|
|
126
|
+
respondents: payload["respondents"],
|
|
127
|
+
submissions: payload["submissions"],
|
|
128
|
+
},
|
|
129
|
+
};
|
|
130
|
+
}
|
|
131
|
+
const status = RUN_ENDS.get(row.type);
|
|
132
|
+
if (status !== undefined) {
|
|
133
|
+
return {
|
|
134
|
+
...base,
|
|
135
|
+
kind: "run.ended",
|
|
136
|
+
payload: { runId: payload["runId"], action: payload["action"], status },
|
|
137
|
+
};
|
|
138
|
+
}
|
|
139
|
+
return undefined;
|
|
140
|
+
};
|
|
141
|
+
|
|
142
|
+
/**
|
|
143
|
+
* The invitations a roster change calls for (D168): one per respondent it added or gave a new
|
|
144
|
+
* link, who has an email and is still expected, keyed by their link's token, so a repeated read
|
|
145
|
+
* enqueues nothing new and a later link gets an invitation of its own.
|
|
146
|
+
*/
|
|
147
|
+
const invite = (row: EventRow): void => {
|
|
148
|
+
if (row.artifact_id === null) return;
|
|
149
|
+
const route = options.routeOf(row.artifact_id);
|
|
150
|
+
if (!route) return;
|
|
151
|
+
const payload = JSON.parse(row.payload_json) as {
|
|
152
|
+
added?: readonly { ref?: unknown }[];
|
|
153
|
+
relinked?: readonly unknown[];
|
|
154
|
+
};
|
|
155
|
+
const refs = new Set<string>([
|
|
156
|
+
...(payload.added ?? []).flatMap((entry) =>
|
|
157
|
+
typeof entry.ref === "string" ? [entry.ref] : [],
|
|
158
|
+
),
|
|
159
|
+
...(payload.relinked ?? []).filter((ref): ref is string => typeof ref === "string"),
|
|
160
|
+
]);
|
|
161
|
+
if (refs.size === 0) return;
|
|
162
|
+
const artifactId = row.artifact_id;
|
|
163
|
+
const found = ledger.read((db) => ({
|
|
164
|
+
title: db.get<{ title: string }>("SELECT title FROM artifact WHERE id = ?", artifactId)
|
|
165
|
+
?.title,
|
|
166
|
+
entries: [...refs].flatMap((ref) => {
|
|
167
|
+
const entry = db.get<{
|
|
168
|
+
ref: string;
|
|
169
|
+
name: string | null;
|
|
170
|
+
email: string | null;
|
|
171
|
+
token_id: string | null;
|
|
172
|
+
}>(
|
|
173
|
+
"SELECT ref, name, email, token_id FROM roster_entry WHERE artifact_id = ? AND ref = ?",
|
|
174
|
+
artifactId,
|
|
175
|
+
ref,
|
|
176
|
+
);
|
|
177
|
+
return entry && entry.email !== null && entry.token_id !== null ? [entry] : [];
|
|
178
|
+
}),
|
|
179
|
+
}));
|
|
180
|
+
const sender = options.sender?.() ?? {};
|
|
181
|
+
for (const entry of found.entries) {
|
|
182
|
+
operator.enqueue({
|
|
183
|
+
port: "invitations",
|
|
184
|
+
invitation: {
|
|
185
|
+
invitationId: `${options.homeId}:${entry.token_id}`,
|
|
186
|
+
account: options.account(),
|
|
187
|
+
home: options.homeId,
|
|
188
|
+
routeId: route.id,
|
|
189
|
+
label: route.label,
|
|
190
|
+
artifactId,
|
|
191
|
+
title: found.title ?? "",
|
|
192
|
+
respondent: {
|
|
193
|
+
ref: entry.ref,
|
|
194
|
+
...(entry.name !== null ? { name: entry.name } : {}),
|
|
195
|
+
email: entry.email as string,
|
|
196
|
+
},
|
|
197
|
+
sender: {
|
|
198
|
+
...(sender.name !== undefined ? { name: sender.name } : {}),
|
|
199
|
+
...(sender.verifiedBy !== undefined ? { verifiedBy: sender.verifiedBy } : {}),
|
|
200
|
+
},
|
|
201
|
+
tokenId: entry.token_id as string,
|
|
202
|
+
at: row.at,
|
|
203
|
+
},
|
|
204
|
+
});
|
|
205
|
+
}
|
|
206
|
+
};
|
|
207
|
+
|
|
208
|
+
const scan = (): void => {
|
|
209
|
+
scheduled = false;
|
|
210
|
+
if (stopped) return;
|
|
211
|
+
try {
|
|
212
|
+
let cursor = cursorOf();
|
|
213
|
+
if (!wanted || cursor < 0) {
|
|
214
|
+
// No port reads the feed, or it starts now: from the head, never the whole history.
|
|
215
|
+
setCursor(Math.max(0, head()));
|
|
216
|
+
if (!wanted) return;
|
|
217
|
+
cursor = Math.max(0, cursorOf());
|
|
218
|
+
}
|
|
219
|
+
for (;;) {
|
|
220
|
+
const rows = ledger.read((db) =>
|
|
221
|
+
db.all<EventRow>(
|
|
222
|
+
`SELECT cursor, artifact_id, type, payload_json, at FROM event WHERE cursor > ?
|
|
223
|
+
AND type IN ('submission.created', 'version.published', 'action.succeeded',
|
|
224
|
+
'action.failed', 'action.cancelled', 'action.unknown',
|
|
225
|
+
'roster.changed', 'roster.completed')
|
|
226
|
+
ORDER BY cursor LIMIT ?`,
|
|
227
|
+
cursor,
|
|
228
|
+
PAGE,
|
|
229
|
+
),
|
|
230
|
+
);
|
|
231
|
+
for (const row of rows) {
|
|
232
|
+
if (row.type === "roster.changed") {
|
|
233
|
+
if (operator.has.invitations) invite(row);
|
|
234
|
+
continue;
|
|
235
|
+
}
|
|
236
|
+
const event = toEvent(row);
|
|
237
|
+
if (!event) continue;
|
|
238
|
+
if (event.kind === "submission.accepted") {
|
|
239
|
+
meter.add("submissions", {
|
|
240
|
+
account: event.account,
|
|
241
|
+
home: event.home,
|
|
242
|
+
artifactId: event.artifactId,
|
|
243
|
+
routeId: event.routeId,
|
|
244
|
+
});
|
|
245
|
+
}
|
|
246
|
+
if (operator.has.events) operator.enqueue({ port: "events", event });
|
|
247
|
+
}
|
|
248
|
+
// Up to the last event read, or the head when nothing matched past the cursor.
|
|
249
|
+
const last = rows.at(-1)?.cursor;
|
|
250
|
+
if (last === undefined) {
|
|
251
|
+
setCursor(Math.max(cursor, head()));
|
|
252
|
+
return;
|
|
253
|
+
}
|
|
254
|
+
setCursor(last);
|
|
255
|
+
cursor = last;
|
|
256
|
+
if (rows.length < PAGE) return;
|
|
257
|
+
}
|
|
258
|
+
} catch (error) {
|
|
259
|
+
log.warn("operator.feed_failed", { home: options.homeId, error });
|
|
260
|
+
}
|
|
261
|
+
};
|
|
262
|
+
|
|
263
|
+
const unsubscribe = ledger.onCommit(() => {
|
|
264
|
+
if (scheduled || stopped) return;
|
|
265
|
+
scheduled = true;
|
|
266
|
+
setImmediate(scan);
|
|
267
|
+
});
|
|
268
|
+
scan();
|
|
269
|
+
|
|
270
|
+
return {
|
|
271
|
+
scan,
|
|
272
|
+
stop() {
|
|
273
|
+
stopped = true;
|
|
274
|
+
unsubscribe();
|
|
275
|
+
},
|
|
276
|
+
};
|
|
277
|
+
}
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The server handle an operator module receives (INTERFACES §18.6, D165 item 9): quarantine,
|
|
3
|
+
* pause, suspension, link revocation, moving and restoring homes, and deletion. Every target names
|
|
4
|
+
* a hosted route (`rte_…`), never a bare artifact or version ID, since those repeat across homes
|
|
5
|
+
* when a project is copied: acting on one route never touches another home hosting the same
|
|
6
|
+
* artifact ID or an identical version. Each call is durable when it resolves.
|
|
7
|
+
*/
|
|
8
|
+
import { createDiagnostic, RpcError } from "@mostra/protocol";
|
|
9
|
+
import { OPERATOR_REVISION, type ServerHandle } from "@mostra/protocol/operator";
|
|
10
|
+
import type { Ledger } from "../ledger/index.ts";
|
|
11
|
+
import type { Log } from "../log.ts";
|
|
12
|
+
import type { DataDirectory } from "./data.ts";
|
|
13
|
+
import type { HostedHome } from "./hosted.ts";
|
|
14
|
+
|
|
15
|
+
/** Options for {@link createHandle}. */
|
|
16
|
+
export interface HandleOptions {
|
|
17
|
+
readonly apiOrigin: string;
|
|
18
|
+
/** The data directory; set once it is open (the handle is made before the operator loads). */
|
|
19
|
+
readonly data: () => DataDirectory<HostedHome>;
|
|
20
|
+
readonly directory: () => Ledger;
|
|
21
|
+
/** Closes the bindings of a suspended home at once (the API origin's). */
|
|
22
|
+
readonly suspended: (homeId: string) => void;
|
|
23
|
+
readonly log: Log;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
function unknownTarget(message: string): RpcError {
|
|
27
|
+
return new RpcError(createDiagnostic("MOSTRA_HOST_INVALID_PARAMS", { message }));
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Builds the handle. */
|
|
31
|
+
export function createHandle(options: HandleOptions): ServerHandle {
|
|
32
|
+
const { log } = options;
|
|
33
|
+
|
|
34
|
+
/** A route's home and artifact; an unknown route is refused, never guessed. */
|
|
35
|
+
const route = (routeId: string): { readonly home: string; readonly artifactId: string } => {
|
|
36
|
+
const row = options
|
|
37
|
+
.directory()
|
|
38
|
+
.read((db) =>
|
|
39
|
+
db.get<{ home_id: string; artifact_id: string }>(
|
|
40
|
+
"SELECT home_id, artifact_id FROM artifact_route WHERE id = ?",
|
|
41
|
+
routeId,
|
|
42
|
+
),
|
|
43
|
+
);
|
|
44
|
+
if (!row) throw unknownTarget(`No hosted route ${routeId}.`);
|
|
45
|
+
return { home: row.home_id, artifactId: row.artifact_id };
|
|
46
|
+
};
|
|
47
|
+
|
|
48
|
+
const homeOf = async (homeId: string): Promise<HostedHome> =>
|
|
49
|
+
(await options.data().home(homeId)).assembled;
|
|
50
|
+
|
|
51
|
+
const knownHome = (homeId: string): void => {
|
|
52
|
+
const found = options
|
|
53
|
+
.directory()
|
|
54
|
+
.read((db) => db.get("SELECT 1 FROM home WHERE id = ?", homeId));
|
|
55
|
+
if (!found) throw unknownTarget(`No hosted home ${homeId}.`);
|
|
56
|
+
};
|
|
57
|
+
|
|
58
|
+
return {
|
|
59
|
+
revision: OPERATOR_REVISION,
|
|
60
|
+
apiOrigin: options.apiOrigin,
|
|
61
|
+
|
|
62
|
+
async quarantine(target, reason) {
|
|
63
|
+
const found = route(target.routeId);
|
|
64
|
+
const home = await homeOf(found.home);
|
|
65
|
+
home.quarantine(
|
|
66
|
+
found.artifactId,
|
|
67
|
+
"versionId" in target ? target.versionId : undefined,
|
|
68
|
+
reason,
|
|
69
|
+
);
|
|
70
|
+
log.info("operator.quarantine", { routeId: target.routeId });
|
|
71
|
+
},
|
|
72
|
+
|
|
73
|
+
async release(target) {
|
|
74
|
+
const found = route(target.routeId);
|
|
75
|
+
const home = await homeOf(found.home);
|
|
76
|
+
home.release(found.artifactId, "versionId" in target ? target.versionId : undefined);
|
|
77
|
+
log.info("operator.release", { routeId: target.routeId });
|
|
78
|
+
},
|
|
79
|
+
|
|
80
|
+
async pause(routeId, reason) {
|
|
81
|
+
const found = route(routeId);
|
|
82
|
+
(await homeOf(found.home)).pause(found.artifactId, { paused: true, by: "operator", reason });
|
|
83
|
+
log.info("operator.pause", { routeId });
|
|
84
|
+
},
|
|
85
|
+
|
|
86
|
+
async resume(routeId) {
|
|
87
|
+
const found = route(routeId);
|
|
88
|
+
(await homeOf(found.home)).pause(found.artifactId, { paused: false, by: "operator" });
|
|
89
|
+
log.info("operator.resume", { routeId });
|
|
90
|
+
},
|
|
91
|
+
|
|
92
|
+
async suspendHome(homeId, reason) {
|
|
93
|
+
knownHome(homeId);
|
|
94
|
+
options
|
|
95
|
+
.directory()
|
|
96
|
+
.write((db) =>
|
|
97
|
+
db.run(
|
|
98
|
+
"UPDATE home SET suspended_at = COALESCE(suspended_at, ?), suspend_reason = ? WHERE id = ?",
|
|
99
|
+
new Date().toISOString(),
|
|
100
|
+
reason.slice(0, 1_000),
|
|
101
|
+
homeId,
|
|
102
|
+
),
|
|
103
|
+
);
|
|
104
|
+
options.suspended(homeId);
|
|
105
|
+
await options.data().closeHome(homeId);
|
|
106
|
+
log.info("operator.suspend_home", { home: homeId });
|
|
107
|
+
},
|
|
108
|
+
|
|
109
|
+
async resumeHome(homeId) {
|
|
110
|
+
knownHome(homeId);
|
|
111
|
+
options
|
|
112
|
+
.directory()
|
|
113
|
+
.write((db) =>
|
|
114
|
+
db.run("UPDATE home SET suspended_at = NULL, suspend_reason = NULL WHERE id = ?", homeId),
|
|
115
|
+
);
|
|
116
|
+
log.info("operator.resume_home", { home: homeId });
|
|
117
|
+
},
|
|
118
|
+
|
|
119
|
+
async revokeLinks(routeId) {
|
|
120
|
+
const found = route(routeId);
|
|
121
|
+
const count = (await homeOf(found.home)).revokeLinks(found.artifactId);
|
|
122
|
+
log.info("operator.revoke_links", { routeId, count });
|
|
123
|
+
return count;
|
|
124
|
+
},
|
|
125
|
+
|
|
126
|
+
async revokeLink(tokenId) {
|
|
127
|
+
const row = options
|
|
128
|
+
.directory()
|
|
129
|
+
.read((db) =>
|
|
130
|
+
db.get<{ home_id: string }>(
|
|
131
|
+
"SELECT home_id FROM hosted_token WHERE token_id = ?",
|
|
132
|
+
tokenId,
|
|
133
|
+
),
|
|
134
|
+
);
|
|
135
|
+
if (!row) throw unknownTarget(`No hosted link ${tokenId}.`);
|
|
136
|
+
if (!(await homeOf(row.home_id)).revokeLink(tokenId)) {
|
|
137
|
+
throw unknownTarget(`No hosted link ${tokenId}.`);
|
|
138
|
+
}
|
|
139
|
+
log.info("operator.revoke_link", { tokenId });
|
|
140
|
+
},
|
|
141
|
+
|
|
142
|
+
async drainHome(homeId) {
|
|
143
|
+
knownHome(homeId);
|
|
144
|
+
options.suspended(homeId);
|
|
145
|
+
await options.data().drain(homeId);
|
|
146
|
+
},
|
|
147
|
+
|
|
148
|
+
async releaseHome(homeId) {
|
|
149
|
+
knownHome(homeId);
|
|
150
|
+
options.data().undrain(homeId);
|
|
151
|
+
},
|
|
152
|
+
|
|
153
|
+
async restored(homeId) {
|
|
154
|
+
knownHome(homeId);
|
|
155
|
+
await options.data().restored(homeId);
|
|
156
|
+
log.info("operator.restored", { home: homeId });
|
|
157
|
+
},
|
|
158
|
+
|
|
159
|
+
async remove(routeId) {
|
|
160
|
+
const found = route(routeId);
|
|
161
|
+
const home = await homeOf(found.home);
|
|
162
|
+
try {
|
|
163
|
+
await home.remove(found.artifactId);
|
|
164
|
+
} finally {
|
|
165
|
+
// The home reopens from its ledger on its next request, holding nothing of the artifact,
|
|
166
|
+
// and nothing a removal cut off part-way left open in it (second Fable review, 8).
|
|
167
|
+
await options.data().closeHome(found.home);
|
|
168
|
+
}
|
|
169
|
+
log.info("operator.remove", { routeId });
|
|
170
|
+
},
|
|
171
|
+
};
|
|
172
|
+
}
|