@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/gateway/listener.ts
CHANGED
|
@@ -39,6 +39,35 @@ export const MAX_HEADER_SIZE: number = 1024 * 1024;
|
|
|
39
39
|
*/
|
|
40
40
|
export const KEEP_ALIVE_MS: number = 305_000;
|
|
41
41
|
|
|
42
|
+
/**
|
|
43
|
+
* Ends a server's connections when it stops, without leaving them in TIME_WAIT on its side (#132):
|
|
44
|
+
* a connection the server closes first stays in TIME_WAIT on the server's port for minutes, and
|
|
45
|
+
* Windows refuses a browser's next connect from a random local port that meets one of them with
|
|
46
|
+
* `ERR_NO_BUFFER_SPACE`, the more often as a restarted instance listens on the same leased ports
|
|
47
|
+
* (D99). A reset (`SO_LINGER` 0) leaves nothing behind; whatever a stopping server still had on a
|
|
48
|
+
* connection was being cut anyway. Answers the function that stops it.
|
|
49
|
+
*/
|
|
50
|
+
export function resetOnClose(server: Server): () => Promise<void> {
|
|
51
|
+
const sockets = new Set<Socket>();
|
|
52
|
+
server.on("connection", (socket: Socket) => {
|
|
53
|
+
sockets.add(socket);
|
|
54
|
+
socket.once("close", () => sockets.delete(socket));
|
|
55
|
+
});
|
|
56
|
+
return () =>
|
|
57
|
+
new Promise((resolve) => {
|
|
58
|
+
if (!server.listening) return resolve();
|
|
59
|
+
// Before `close()`, which since Node.js 19 ends idle connections itself, with a FIN.
|
|
60
|
+
for (const socket of sockets) {
|
|
61
|
+
if (socket.destroyed) continue;
|
|
62
|
+
if (typeof socket.resetAndDestroy === "function" && socket.readyState === "open") {
|
|
63
|
+
socket.resetAndDestroy();
|
|
64
|
+
} else socket.destroy();
|
|
65
|
+
}
|
|
66
|
+
server.close(() => resolve());
|
|
67
|
+
server.closeAllConnections();
|
|
68
|
+
});
|
|
69
|
+
}
|
|
70
|
+
|
|
42
71
|
/** A listener: its server and its Hono app. */
|
|
43
72
|
export interface Listener {
|
|
44
73
|
readonly server: Server;
|
|
@@ -302,15 +331,11 @@ export function createListener(options: {
|
|
|
302
331
|
// An idle connection waits for its next request without these two limits, which count from a
|
|
303
332
|
// request's first byte.
|
|
304
333
|
server.keepAliveTimeout = KEEP_ALIVE_MS;
|
|
334
|
+
const stop = resetOnClose(server);
|
|
305
335
|
|
|
306
336
|
return {
|
|
307
337
|
server,
|
|
308
338
|
app,
|
|
309
|
-
close:
|
|
310
|
-
new Promise((resolve) => {
|
|
311
|
-
if (!server.listening) return resolve();
|
|
312
|
-
server.close(() => resolve());
|
|
313
|
-
server.closeAllConnections();
|
|
314
|
-
}),
|
|
339
|
+
close: stop,
|
|
315
340
|
};
|
|
316
341
|
}
|
package/src/gateway/routes.ts
CHANGED
|
@@ -75,6 +75,11 @@ export interface RouteContext {
|
|
|
75
75
|
readonly document: boolean;
|
|
76
76
|
/** The address of the connection's peer: on a face, the tunnel's own process (D158 item 2). */
|
|
77
77
|
readonly remote: string | undefined;
|
|
78
|
+
/**
|
|
79
|
+
* The client's address: on a remote server the one its trusted proxies name (the forwarded
|
|
80
|
+
* address read from the right, D165 item 13), elsewhere the connection's peer.
|
|
81
|
+
*/
|
|
82
|
+
readonly client: string | undefined;
|
|
78
83
|
}
|
|
79
84
|
|
|
80
85
|
/** What a listener contributes to every route's checks. */
|
|
@@ -96,6 +101,8 @@ export interface ListenerChecks {
|
|
|
96
101
|
readonly mode?: () => SessionMode;
|
|
97
102
|
/** Whether event streams pass to this listener's browsers; `false` behind a quick tunnel. */
|
|
98
103
|
readonly streams?: () => boolean;
|
|
104
|
+
/** The client's address of a request (a remote server's trusted proxies); default its peer. */
|
|
105
|
+
readonly client?: (incoming: import("node:http").IncomingMessage) => string | undefined;
|
|
99
106
|
}
|
|
100
107
|
|
|
101
108
|
/** Logs a refusal without any of the request's capability material, and answers it. */
|
|
@@ -242,6 +249,7 @@ export function mount(
|
|
|
242
249
|
...(session ? { session } : {}),
|
|
243
250
|
document,
|
|
244
251
|
remote: incoming.socket.remoteAddress,
|
|
252
|
+
client: checks.client ? checks.client(incoming) : incoming.socket.remoteAddress,
|
|
245
253
|
});
|
|
246
254
|
};
|
|
247
255
|
if (route.method === "GET") app.get(route.path, handle);
|
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The roster's host methods (D121, D168; CO-01, CO-03, CO-07): `roster/add` names expected
|
|
3
|
+
* respondents and gives each a personal link, `roster/remove` stops expecting them, `roster/get`
|
|
4
|
+
* reads everyone's status. They live with the gateway because a personal link is a capability
|
|
5
|
+
* link (D97): minted here, with the respondent's viewer (D104), in the same transaction as the
|
|
6
|
+
* roster's change. The roster itself, its rounds and its completion are the interaction core's.
|
|
7
|
+
*/
|
|
8
|
+
import {
|
|
9
|
+
type Actor,
|
|
10
|
+
ALL_SCOPES,
|
|
11
|
+
type ArtifactDetail,
|
|
12
|
+
type ArtifactRef,
|
|
13
|
+
type CapabilityLink,
|
|
14
|
+
createDiagnostic,
|
|
15
|
+
durationMs,
|
|
16
|
+
normalizeScopes,
|
|
17
|
+
type Roster,
|
|
18
|
+
RpcError,
|
|
19
|
+
rosterAddMethod,
|
|
20
|
+
rosterGetMethod,
|
|
21
|
+
rosterRemoveMethod,
|
|
22
|
+
} from "@mostra/protocol";
|
|
23
|
+
import type { Interaction } from "../interaction/index.ts";
|
|
24
|
+
import { type Ledger, recordedResult, recordResult, requestKey } from "../ledger/index.ts";
|
|
25
|
+
import { handler, type MethodHandler, type Session } from "../protocol-server/index.ts";
|
|
26
|
+
import type { Capabilities, MintedToken } from "./capabilities.ts";
|
|
27
|
+
|
|
28
|
+
/** What the roster methods need of the gateway. */
|
|
29
|
+
export interface RosterMethodsOptions {
|
|
30
|
+
readonly ledger: Ledger;
|
|
31
|
+
readonly interaction: Interaction;
|
|
32
|
+
readonly capabilities: Capabilities;
|
|
33
|
+
readonly artifacts: { get(ref: ArtifactRef): ArtifactDetail };
|
|
34
|
+
/** The version a request names, or the latest. */
|
|
35
|
+
readonly versionOf: (
|
|
36
|
+
detail: ArtifactDetail,
|
|
37
|
+
wanted: number | string | undefined,
|
|
38
|
+
) => { readonly id: string; readonly number: number; readonly collected?: string } | undefined;
|
|
39
|
+
/** Where the artifact's links point now (D97 item 10). */
|
|
40
|
+
readonly linkBase: (artifactId: string) => Promise<string>;
|
|
41
|
+
/** A minted token as a capability link. */
|
|
42
|
+
readonly link: (token: MintedToken) => CapabilityLink;
|
|
43
|
+
/** What a link refused for its collected version says. */
|
|
44
|
+
readonly collected: (number: number) => RpcError;
|
|
45
|
+
/** Asks whether `count` new links may be minted, throwing to refuse (an operator's `limits`). */
|
|
46
|
+
readonly linkLimit?: (artifactId: string, count: number) => Promise<void>;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** Who changed the roster: the client that called. */
|
|
50
|
+
function actorOf(session: Session): Actor {
|
|
51
|
+
return { kind: "agent", ...(session.client ? { id: session.client.name } : {}) };
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** The roster's host methods. */
|
|
55
|
+
export function rosterMethods(options: RosterMethodsOptions): MethodHandler[] {
|
|
56
|
+
const { ledger, interaction, capabilities } = options;
|
|
57
|
+
|
|
58
|
+
const live = (tokenId: string): boolean => capabilities.grant(tokenId)?.live === true;
|
|
59
|
+
const roster = (artifactId: string): Roster => interaction.roster(artifactId, live);
|
|
60
|
+
|
|
61
|
+
return [
|
|
62
|
+
handler(rosterAddMethod, async (params, session) => {
|
|
63
|
+
const detail = options.artifacts.get(params.artifact);
|
|
64
|
+
const version = options.versionOf(detail, params.version);
|
|
65
|
+
if (!version) {
|
|
66
|
+
throw new RpcError(
|
|
67
|
+
createDiagnostic("MOSTRA_ARTIFACT_VERSION_NOT_FOUND", {
|
|
68
|
+
message:
|
|
69
|
+
params.version === undefined
|
|
70
|
+
? `The artifact ${detail.id} has no published version.`
|
|
71
|
+
: `The artifact ${detail.id} has no version ${params.version}.`,
|
|
72
|
+
}),
|
|
73
|
+
);
|
|
74
|
+
}
|
|
75
|
+
if (version.collected !== undefined) throw options.collected(version.number);
|
|
76
|
+
const base = await options.linkBase(detail.id);
|
|
77
|
+
const scopes = normalizeScopes(params.scopes ?? ALL_SCOPES).join(" ");
|
|
78
|
+
const pinned = params.version === undefined ? undefined : version.number;
|
|
79
|
+
/**
|
|
80
|
+
* Whether a respondent's link is the one this request would mint: it works here (D97 items
|
|
81
|
+
* 5, 10) with the same scopes, the same pinned version, and an expiry exactly when a `ttl` is
|
|
82
|
+
* asked for (Opus review 6). Otherwise the respondent gets a new link; the old one isn't
|
|
83
|
+
* revoked, since they may hold it already.
|
|
84
|
+
*/
|
|
85
|
+
const reusable = (tokenId: string): boolean => {
|
|
86
|
+
const grant = capabilities.grant(tokenId);
|
|
87
|
+
return (
|
|
88
|
+
grant?.live === true &&
|
|
89
|
+
grant.shellOrigin === base &&
|
|
90
|
+
normalizeScopes(grant.scopes).join(" ") === scopes &&
|
|
91
|
+
grant.pinnedVersion === pinned &&
|
|
92
|
+
(grant.expiresAt !== undefined) === (params.ttl !== undefined)
|
|
93
|
+
);
|
|
94
|
+
};
|
|
95
|
+
const key = requestKey("roster/add", params);
|
|
96
|
+
// An operator's limit counts the links this call will mint: respondents whose link is kept
|
|
97
|
+
// mint none, and a replay of a recorded call mints nothing (Opus review 10).
|
|
98
|
+
if (options.linkLimit) {
|
|
99
|
+
const replay =
|
|
100
|
+
key !== undefined && ledger.read((db) => recordedResult(db, key)) !== undefined;
|
|
101
|
+
if (!replay) {
|
|
102
|
+
const current = new Map(
|
|
103
|
+
interaction.roster(detail.id, live).respondents.map((one) => [one.ref, one.tokenId]),
|
|
104
|
+
);
|
|
105
|
+
let fresh = 0;
|
|
106
|
+
for (const ref of new Set(params.respondents.map((one) => one.ref))) {
|
|
107
|
+
const tokenId = current.get(ref);
|
|
108
|
+
if (tokenId === undefined || !reusable(tokenId)) fresh += 1;
|
|
109
|
+
}
|
|
110
|
+
if (fresh > 0) await options.linkLimit(detail.id, fresh);
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
const minted = new Map<string, MintedToken>();
|
|
114
|
+
const tokens = ledger.write((db) => {
|
|
115
|
+
if (key !== undefined) {
|
|
116
|
+
const row = recordedResult<{ tokens: { ref: string; tokenId: string }[] }>(db, key);
|
|
117
|
+
if (row) return row.tokens;
|
|
118
|
+
}
|
|
119
|
+
const added = interaction.addRespondents(db, {
|
|
120
|
+
artifactId: detail.id,
|
|
121
|
+
respondents: params.respondents,
|
|
122
|
+
actor: actorOf(session),
|
|
123
|
+
// A respondent keeps the personal link they have while it is the one this request would
|
|
124
|
+
// mint; a revoked, expired or moved one, or one of other scopes, version or expiry, is
|
|
125
|
+
// replaced by a new one for the same viewer.
|
|
126
|
+
link: (viewerId, current) => {
|
|
127
|
+
if (current !== undefined && reusable(current)) return current;
|
|
128
|
+
const token = capabilities.mint(
|
|
129
|
+
{
|
|
130
|
+
artifactId: detail.id,
|
|
131
|
+
scopes: params.scopes,
|
|
132
|
+
ttlMs: params.ttl === undefined ? undefined : durationMs(params.ttl),
|
|
133
|
+
pinnedVersion: pinned,
|
|
134
|
+
viewerId,
|
|
135
|
+
shellOrigin: base,
|
|
136
|
+
},
|
|
137
|
+
db,
|
|
138
|
+
);
|
|
139
|
+
minted.set(token.tokenId, token);
|
|
140
|
+
return token.tokenId;
|
|
141
|
+
},
|
|
142
|
+
});
|
|
143
|
+
const recorded = added.tokens.map((token) => ({ ref: token.ref, tokenId: token.tokenId }));
|
|
144
|
+
// Only token IDs are recorded: the ledger never holds a link's secret (D97 item 2).
|
|
145
|
+
if (key !== undefined) recordResult(db, key, { tokens: recorded });
|
|
146
|
+
return recorded;
|
|
147
|
+
});
|
|
148
|
+
const links = tokens.map(({ ref, tokenId }) => {
|
|
149
|
+
const token = minted.get(tokenId) ?? capabilities.reveal(tokenId);
|
|
150
|
+
if (!token) {
|
|
151
|
+
throw new RpcError(
|
|
152
|
+
createDiagnostic("MOSTRA_HYGIENE_TOKEN_REVOKED", {
|
|
153
|
+
message: `The personal link of ${ref} can't be shown again: the home's capability key changed. Add them again to give them a new one.`,
|
|
154
|
+
}),
|
|
155
|
+
);
|
|
156
|
+
}
|
|
157
|
+
return { ref, link: options.link(token) };
|
|
158
|
+
});
|
|
159
|
+
return { roster: roster(detail.id), links };
|
|
160
|
+
}),
|
|
161
|
+
handler(rosterRemoveMethod, (params, session) => {
|
|
162
|
+
const detail = options.artifacts.get(params.artifact);
|
|
163
|
+
const key = requestKey("roster/remove", params);
|
|
164
|
+
const removed = ledger.write((db) => {
|
|
165
|
+
if (key !== undefined) {
|
|
166
|
+
const row = recordedResult<{ removed: string[] }>(db, key);
|
|
167
|
+
if (row) return row.removed;
|
|
168
|
+
}
|
|
169
|
+
const outcome = interaction.removeRespondents(db, {
|
|
170
|
+
artifactId: detail.id,
|
|
171
|
+
refs: params.refs,
|
|
172
|
+
actor: actorOf(session),
|
|
173
|
+
});
|
|
174
|
+
if (key !== undefined) recordResult(db, key, { removed: outcome.removed });
|
|
175
|
+
return [...outcome.removed];
|
|
176
|
+
});
|
|
177
|
+
return { roster: roster(detail.id), removed };
|
|
178
|
+
}),
|
|
179
|
+
handler(rosterGetMethod, (params) => roster(options.artifacts.get(params.artifact).id)),
|
|
180
|
+
];
|
|
181
|
+
}
|
package/src/gc/index.ts
CHANGED
|
@@ -213,6 +213,11 @@ export const EXEMPT_COLUMNS: readonly ExemptColumn[] = [
|
|
|
213
213
|
column: "schema_migration.runtime_version",
|
|
214
214
|
reason: "the runtime release that ran a migration",
|
|
215
215
|
},
|
|
216
|
+
{
|
|
217
|
+
column: "quarantine.version_id",
|
|
218
|
+
reason:
|
|
219
|
+
"an operator's quarantine of a hosted version (WP-30), which withholds it and keeps nothing; a hosted home runs no gc",
|
|
220
|
+
},
|
|
216
221
|
];
|
|
217
222
|
|
|
218
223
|
/** The versions some source keeps. */
|
package/src/instance/index.ts
CHANGED
|
@@ -80,7 +80,14 @@ import {
|
|
|
80
80
|
type Interaction,
|
|
81
81
|
redactEvents,
|
|
82
82
|
} from "../interaction/index.ts";
|
|
83
|
-
import {
|
|
83
|
+
import {
|
|
84
|
+
createLink,
|
|
85
|
+
createOwnerAuthor,
|
|
86
|
+
forwardHosted,
|
|
87
|
+
hostedState,
|
|
88
|
+
type Link,
|
|
89
|
+
pauseHandler,
|
|
90
|
+
} from "../link/index.ts";
|
|
84
91
|
import { createLive, type LatestLive, liveMethods } from "../live/index.ts";
|
|
85
92
|
import type { Environment, Log } from "../log.ts";
|
|
86
93
|
import { helperPath, type LaunchPipe, realPath } from "../platform/index.ts";
|
|
@@ -760,6 +767,16 @@ async function assemble(home: OwnedHome, options: StartInstanceOptions): Promise
|
|
|
760
767
|
actions,
|
|
761
768
|
liveChanged: () => live.reconcile(),
|
|
762
769
|
now: () => Date.now() + clockOffset,
|
|
770
|
+
// Remote MCP's authoring runs here, on this home's own protocol server (D165 item 5).
|
|
771
|
+
author: (from, params) => author(from, params),
|
|
772
|
+
});
|
|
773
|
+
const author = createOwnerAuthor({
|
|
774
|
+
home: home.path,
|
|
775
|
+
env: environment,
|
|
776
|
+
log,
|
|
777
|
+
runtimeVersion: runtimeVersion(),
|
|
778
|
+
protocol: () => server,
|
|
779
|
+
hostedOn: (artifactId) => link.hostedServers(artifactId),
|
|
763
780
|
});
|
|
764
781
|
const stopPushingPublishes = interaction.onPublished((artifactId, versionId) =>
|
|
765
782
|
link.published(artifactId, versionId),
|
|
@@ -876,11 +893,14 @@ async function assemble(home: OwnedHome, options: StartInstanceOptions): Promise
|
|
|
876
893
|
dependenciesAdded: (artifact) => dev.dependenciesChanged(artifact),
|
|
877
894
|
}),
|
|
878
895
|
...dev.methods(),
|
|
879
|
-
|
|
896
|
+
// A hosted artifact's roster is its hosted home's, like its state (D165 item 1, D168).
|
|
897
|
+
...forwardHosted(link, (ref) => registry.get(canonicalRef(ref)).id, gateway.methods()),
|
|
880
898
|
...shares.methods(),
|
|
881
899
|
...link.methods(),
|
|
882
900
|
// A hosted artifact's state and live values act on its hosted home (D165 item 1).
|
|
883
901
|
...forwardHosted(link, (ref) => registry.get(canonicalRef(ref)).id, interaction.methods()),
|
|
902
|
+
// Pausing acts here and on every server the artifact is hosted on (D165 item 14).
|
|
903
|
+
pauseHandler(link, (ref) => registry.get(canonicalRef(ref)).id, interaction.pause),
|
|
884
904
|
...secretMethods(secrets, (ref) => registry.get(canonicalRef(ref)).id),
|
|
885
905
|
...gcMethods(
|
|
886
906
|
createGc({
|
|
@@ -46,6 +46,14 @@ function coalesceInto(
|
|
|
46
46
|
queue: EphemeralMessage[],
|
|
47
47
|
message: EphemeralMessage,
|
|
48
48
|
): void {
|
|
49
|
+
if (message.kind === "respondents" || message.kind === "presence") {
|
|
50
|
+
// A page's roster and presence are whole states: the newest replaces any still queued.
|
|
51
|
+
for (let index = queue.length - 1; index >= 0; index--) {
|
|
52
|
+
if ((queue[index] as EphemeralMessage).kind === message.kind) queue.splice(index, 1);
|
|
53
|
+
}
|
|
54
|
+
queue.push(message);
|
|
55
|
+
return;
|
|
56
|
+
}
|
|
49
57
|
if (message.kind === "live") {
|
|
50
58
|
const latestMode = view.live.get(message.live.key)?.window === undefined;
|
|
51
59
|
if (latestMode && message.live.value !== undefined) {
|
|
@@ -124,6 +132,15 @@ export interface EphemeralBus {
|
|
|
124
132
|
publishRun(artifactId: string, message: Extract<EphemeralMessage, { kind: "run" }>): void;
|
|
125
133
|
/** Sends a live update to every view reading the source. */
|
|
126
134
|
publishLive(artifactId: string, message: Extract<EphemeralMessage, { kind: "live" }>): void;
|
|
135
|
+
/**
|
|
136
|
+
* Sends one view its own roster or presence (D168), when it listens or polls now: each view's
|
|
137
|
+
* is its own, under the visibility policy.
|
|
138
|
+
*/
|
|
139
|
+
send(
|
|
140
|
+
artifactId: string,
|
|
141
|
+
viewId: string,
|
|
142
|
+
message: Extract<EphemeralMessage, { kind: "respondents" | "presence" }>,
|
|
143
|
+
): void;
|
|
127
144
|
/** Hears the view's messages as they come (an open event stream); returns the stop. */
|
|
128
145
|
listen(
|
|
129
146
|
artifactId: string,
|
|
@@ -256,6 +273,10 @@ export function createEphemeralBus(
|
|
|
256
273
|
if ((view.live.get(message.live.key)?.until ?? 0) > at) deliver(view, message);
|
|
257
274
|
}
|
|
258
275
|
},
|
|
276
|
+
send(artifactId, viewId, message) {
|
|
277
|
+
const view = views.get(viewId);
|
|
278
|
+
if (view && view.artifactId === artifactId) deliver(view, message);
|
|
279
|
+
},
|
|
259
280
|
listen(artifactId, viewId, listener) {
|
|
260
281
|
const view = viewOf(artifactId, viewId);
|
|
261
282
|
view.listeners.add(listener);
|
|
@@ -308,6 +308,11 @@ export interface CompactionSummary {
|
|
|
308
308
|
readonly number: unknown;
|
|
309
309
|
readonly cursor: number;
|
|
310
310
|
};
|
|
311
|
+
/**
|
|
312
|
+
* Where the roster stood at the range's end (D168): whether it was complete, and its latest
|
|
313
|
+
* completion, so `submitted:all` still reads it once its events are replaced.
|
|
314
|
+
*/
|
|
315
|
+
readonly roster?: { readonly complete: boolean; readonly completed?: EventRecord };
|
|
311
316
|
}
|
|
312
317
|
|
|
313
318
|
/**
|
|
@@ -335,6 +340,7 @@ export function compactEvents(
|
|
|
335
340
|
let removed = 0;
|
|
336
341
|
let from = first.cursor;
|
|
337
342
|
let latestVersion: CompactionSummary["latestVersion"];
|
|
343
|
+
let roster: CompactionSummary["roster"];
|
|
338
344
|
for (const row of rows) {
|
|
339
345
|
if (row.type === COMPACTED) {
|
|
340
346
|
// An earlier summary folds into this one, with everything it covered.
|
|
@@ -344,10 +350,20 @@ export function compactEvents(
|
|
|
344
350
|
for (const [type, count] of Object.entries(earlier.types))
|
|
345
351
|
types[type] = (types[type] ?? 0) + count;
|
|
346
352
|
if (earlier.latestVersion) latestVersion = earlier.latestVersion;
|
|
353
|
+
if (earlier.roster) roster = earlier.roster;
|
|
347
354
|
continue;
|
|
348
355
|
}
|
|
349
356
|
removed += 1;
|
|
350
357
|
types[row.type] = (types[row.type] ?? 0) + 1;
|
|
358
|
+
if (row.type === "roster.completed") {
|
|
359
|
+
roster = { complete: true, completed: eventRecord(row) };
|
|
360
|
+
} else if (row.type === "roster.changed") {
|
|
361
|
+
const complete = (JSON.parse(row.payload_json) as { complete?: unknown }).complete === true;
|
|
362
|
+
roster = {
|
|
363
|
+
complete,
|
|
364
|
+
...(complete && roster?.completed ? { completed: roster.completed } : {}),
|
|
365
|
+
};
|
|
366
|
+
}
|
|
351
367
|
if (row.type === "version.published") {
|
|
352
368
|
const payload = JSON.parse(row.payload_json) as { versionId?: unknown; number?: unknown };
|
|
353
369
|
latestVersion = { versionId: payload.versionId, number: payload.number, cursor: row.cursor };
|
|
@@ -359,6 +375,7 @@ export function compactEvents(
|
|
|
359
375
|
removed,
|
|
360
376
|
types,
|
|
361
377
|
...(latestVersion ? { latestVersion } : {}),
|
|
378
|
+
...(roster ? { roster } : {}),
|
|
362
379
|
};
|
|
363
380
|
db.run("DELETE FROM event WHERE artifact_id = ? AND cursor < ?", artifactId, before);
|
|
364
381
|
db.run(
|