@mostra/runtime 0.9.0 → 0.11.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 +6628 -9
- package/dist/bin.js.map +1 -1
- package/dist/builder/child/main.js +2 -2
- package/dist/{child-Chiavhdx.js → child-BmNZ4a70.js} +2 -2
- package/dist/{child-Chiavhdx.js.map → child-BmNZ4a70.js.map} +1 -1
- package/dist/deps/child/install.js +1 -1
- package/dist/{directories-mJ1qlVht.js → directories-BLJjeSPD.js} +5 -5
- package/dist/directories-BLJjeSPD.js.map +1 -0
- package/dist/{files-FygSJIzK.js → files-DGeWuE4I.js} +2 -2
- package/dist/{files-FygSJIzK.js.map → files-DGeWuE4I.js.map} +1 -1
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -2
- package/dist/{instance-EnaZPs14.js → instance-DCiUHvgZ.js} +3835 -255
- package/dist/instance-DCiUHvgZ.js.map +1 -0
- package/dist/reference/cli.md +1322 -0
- package/dist/reference/diagnostics.json +1552 -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_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 +122 -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 +217 -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/verify.md +71 -0
- package/package.json +12 -5
- package/src/actions/index.ts +163 -10
- package/src/bin.ts +78 -1
- package/src/gateway/actions.ts +40 -4
- package/src/gateway/browser.ts +162 -95
- package/src/gateway/capabilities.ts +23 -6
- package/src/gateway/http.ts +12 -1
- package/src/gateway/index.ts +282 -20
- package/src/gateway/listener.ts +31 -6
- package/src/gateway/routes.ts +23 -7
- package/src/gc/index.ts +19 -0
- package/src/instance/index.ts +60 -2
- package/src/interaction/ephemeral.ts +32 -23
- package/src/interaction/events.ts +21 -1
- package/src/interaction/imports.ts +317 -0
- package/src/interaction/index.ts +228 -15
- package/src/interaction/outbox.ts +9 -0
- package/src/interaction/pause.ts +106 -0
- package/src/interaction/results.ts +8 -1
- package/src/interaction/runs.ts +52 -2
- package/src/interaction/submissions.ts +59 -2
- package/src/interaction/tally.ts +129 -0
- package/src/interaction/viewers.ts +34 -1
- package/src/ledger/index.ts +124 -10
- package/src/ledger/migrations.ts +234 -0
- package/src/ledger/types.ts +8 -0
- package/src/link/author.ts +215 -0
- package/src/link/binding.ts +289 -0
- package/src/link/hosted.ts +101 -0
- package/src/link/http.ts +141 -0
- package/src/link/index.ts +10 -0
- package/src/link/manager.ts +1489 -0
- package/src/link/relay.ts +512 -0
- package/src/live/index.ts +112 -2
- package/src/platform/filesystems.ts +78 -0
- package/src/platform/index.ts +1 -0
- package/src/protocol-server/client.ts +53 -0
- package/src/protocol-server/index.ts +19 -2
- package/src/protocol-server/server.ts +38 -7
- package/src/protocol-server/websocket.ts +161 -0
- package/src/publish/bundle.ts +398 -0
- package/src/publish/manifest.ts +9 -0
- package/src/publish/methods.ts +12 -1
- package/src/publish/publisher.ts +127 -0
- package/src/registry/index.ts +35 -14
- package/src/server/api.ts +881 -0
- package/src/server/auth.ts +1139 -0
- package/src/server/authorize.ts +816 -0
- package/src/server/clients.ts +235 -0
- package/src/server/config.ts +228 -0
- package/src/server/data.ts +427 -0
- package/src/server/directory.ts +210 -0
- package/src/server/feed.ts +191 -0
- package/src/server/handle.ts +172 -0
- package/src/server/hosted-pages.ts +532 -0
- package/src/server/hosted.ts +1323 -0
- package/src/server/index.ts +650 -0
- 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 +498 -0
- package/src/server/providers.ts +284 -0
- package/src/server/relay.ts +1163 -0
- package/src/server/remove.ts +148 -0
- package/src/server/routing.ts +275 -0
- package/src/share/index.ts +110 -6
- package/src/verify/runner.ts +23 -2
- package/dist/directories-mJ1qlVht.js.map +0 -1
- package/dist/instance-EnaZPs14.js.map +0 -1
package/src/bin.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { mkdirSync } from "node:fs";
|
|
3
|
+
import { join } from "node:path";
|
|
3
4
|
import { fileURLToPath } from "node:url";
|
|
4
5
|
/**
|
|
5
6
|
* `mostra-runtime`, the runtime bundle's entry point (D85).
|
|
@@ -33,7 +34,10 @@ import {
|
|
|
33
34
|
} from "@mostra/protocol";
|
|
34
35
|
import { checkPlatform, resolveHomePath } from "./home/index.ts";
|
|
35
36
|
import { type Instance, runtimeVersion, startInstance } from "./instance/index.ts";
|
|
36
|
-
import {
|
|
37
|
+
import { openFileLog } from "./log.ts";
|
|
38
|
+
import { readProcess, realPath } from "./platform/index.ts";
|
|
39
|
+
|
|
40
|
+
import { readServerConfig, startServer } from "./server/index.ts";
|
|
37
41
|
import { installService, serviceStatus, uninstallService } from "./service/index.ts";
|
|
38
42
|
|
|
39
43
|
/** Exit codes, as INTERFACES §9 defines them for the CLI. */
|
|
@@ -42,6 +46,7 @@ const EXIT = { ok: 0, failure: 1, usage: 2, environment: 3 } as const;
|
|
|
42
46
|
const USAGE = [
|
|
43
47
|
"usage: mostra-runtime <host|daemon> [--home <dir>] [--bind <address> [--url-host <name>]] [--always-on]",
|
|
44
48
|
" mostra-runtime service <install|uninstall|status> [--home <dir>] [--no-start]",
|
|
49
|
+
" mostra-runtime server --data <dir> [--config <file>] [--listen <host:port>] [--restored <homeId|all>]",
|
|
45
50
|
].join("\n");
|
|
46
51
|
|
|
47
52
|
// A closed stdout or stderr (a starter that read the ready line and left) must not crash the
|
|
@@ -135,6 +140,14 @@ async function main(argv: readonly string[]): Promise<number> {
|
|
|
135
140
|
const [mode, ...rest] = positionals;
|
|
136
141
|
if (mode === "service" && !values.help)
|
|
137
142
|
return await service(rest, values.home, values["no-start"] === true);
|
|
143
|
+
if (mode === "server" && !values.help && rest.length === 0) {
|
|
144
|
+
return await remoteServer({
|
|
145
|
+
data: values.data,
|
|
146
|
+
config: values.config,
|
|
147
|
+
listen: values.listen,
|
|
148
|
+
restored: values.restored ?? [],
|
|
149
|
+
});
|
|
150
|
+
}
|
|
138
151
|
if (values.help || (mode !== "host" && mode !== "daemon") || rest.length > 0) {
|
|
139
152
|
(values.help ? process.stdout : process.stderr).write(`${USAGE}\n`);
|
|
140
153
|
return values.help ? EXIT.ok : EXIT.usage;
|
|
@@ -190,6 +203,66 @@ async function main(argv: readonly string[]): Promise<number> {
|
|
|
190
203
|
}
|
|
191
204
|
}
|
|
192
205
|
|
|
206
|
+
/**
|
|
207
|
+
* `mostra-runtime server`: the remote server (INTERFACES §18.1). Prints one JSON line on stdout
|
|
208
|
+
* (`{"status":"started","address",…}` or `{"status":"failed","diagnostic"}` with exit 3), then
|
|
209
|
+
* serves until SIGTERM, SIGINT or Ctrl+Break, and stops cleanly: every hosted home is closed and
|
|
210
|
+
* every lock released. Logs go to the data directory's `logs/`.
|
|
211
|
+
*/
|
|
212
|
+
async function remoteServer(args: {
|
|
213
|
+
readonly data: string | undefined;
|
|
214
|
+
readonly config: string | undefined;
|
|
215
|
+
readonly listen: string | undefined;
|
|
216
|
+
readonly restored: readonly string[];
|
|
217
|
+
}): Promise<number> {
|
|
218
|
+
if (args.data === undefined) {
|
|
219
|
+
process.stderr.write(`mostra-runtime server needs --data <dir>.\n${USAGE}\n`);
|
|
220
|
+
return EXIT.usage;
|
|
221
|
+
}
|
|
222
|
+
try {
|
|
223
|
+
checkPlatform();
|
|
224
|
+
mkdirSync(args.data, { recursive: true, mode: 0o700 });
|
|
225
|
+
const data = realPath(args.data);
|
|
226
|
+
const config = readServerConfig(args.config, process.env);
|
|
227
|
+
const me = await readProcess(process.pid);
|
|
228
|
+
if (!me) throw new Error("Couldn't read this process's own start time.");
|
|
229
|
+
const log = openFileLog({ dir: join(data, "logs"), mirror });
|
|
230
|
+
const server = await startServer({
|
|
231
|
+
data,
|
|
232
|
+
config,
|
|
233
|
+
...(args.listen !== undefined ? { listen: args.listen } : {}),
|
|
234
|
+
restored: args.restored,
|
|
235
|
+
runtimeVersion: runtimeVersion(),
|
|
236
|
+
owner: { pid: me.pid, startTime: me.startTime },
|
|
237
|
+
log,
|
|
238
|
+
env: process.env,
|
|
239
|
+
});
|
|
240
|
+
process.stdout.write(
|
|
241
|
+
`${JSON.stringify({ status: "started", pid: process.pid, address: server.address, data })}\n`,
|
|
242
|
+
);
|
|
243
|
+
return await new Promise<number>((resolve) => {
|
|
244
|
+
let stopping = false;
|
|
245
|
+
const stop = (): void => {
|
|
246
|
+
if (stopping) return;
|
|
247
|
+
stopping = true;
|
|
248
|
+
void server.close().then(
|
|
249
|
+
() => resolve(EXIT.ok),
|
|
250
|
+
(error: unknown) => {
|
|
251
|
+
log.error("server.stop_failed", { error });
|
|
252
|
+
resolve(EXIT.failure);
|
|
253
|
+
},
|
|
254
|
+
);
|
|
255
|
+
};
|
|
256
|
+
for (const signal of ["SIGTERM", "SIGINT", "SIGBREAK"] as const) process.on(signal, stop);
|
|
257
|
+
});
|
|
258
|
+
} catch (error) {
|
|
259
|
+
const diagnostic = diagnosticOf(error);
|
|
260
|
+
process.stdout.write(`${JSON.stringify({ status: "failed", diagnostic })}\n`);
|
|
261
|
+
mirror(`${JSON.stringify({ level: "error", diagnostic })}\n`);
|
|
262
|
+
return error instanceof RpcError ? EXIT.environment : EXIT.failure;
|
|
263
|
+
}
|
|
264
|
+
}
|
|
265
|
+
|
|
193
266
|
/** `mostra-runtime service …`: the home's login service, as one JSON line (D62, RT-08). */
|
|
194
267
|
async function service(
|
|
195
268
|
args: readonly string[],
|
|
@@ -244,6 +317,10 @@ function parse(argv: readonly string[]) {
|
|
|
244
317
|
"no-start": { type: "boolean" },
|
|
245
318
|
help: { type: "boolean", short: "h" },
|
|
246
319
|
version: { type: "boolean" },
|
|
320
|
+
data: { type: "string" },
|
|
321
|
+
config: { type: "string" },
|
|
322
|
+
listen: { type: "string" },
|
|
323
|
+
restored: { type: "string", multiple: true },
|
|
247
324
|
},
|
|
248
325
|
});
|
|
249
326
|
}
|
package/src/gateway/actions.ts
CHANGED
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
import {
|
|
11
11
|
CallRequest,
|
|
12
12
|
type CapabilityScope,
|
|
13
|
+
createDiagnostic,
|
|
13
14
|
type Diagnostic,
|
|
14
15
|
LiveRequest,
|
|
15
16
|
RpcError,
|
|
@@ -45,6 +46,12 @@ const STATUS: Readonly<Record<string, number>> = {
|
|
|
45
46
|
MOSTRA_VERIFY_ACTION_SKIPPED: 409,
|
|
46
47
|
MOSTRA_HOME_DISK_FULL: 507,
|
|
47
48
|
MOSTRA_HOME_GONE: 503,
|
|
49
|
+
// A hosted page's relay (D165 item 4, INTERFACES §4).
|
|
50
|
+
MOSTRA_REMOTE_OWNER_OFFLINE: 503,
|
|
51
|
+
MOSTRA_REMOTE_QUEUE_FULL: 503,
|
|
52
|
+
MOSTRA_REMOTE_SIGN_IN_REQUIRED: 403,
|
|
53
|
+
MOSTRA_REMOTE_RATE_LIMITED: 429,
|
|
54
|
+
MOSTRA_ACTION_PAUSED: 423,
|
|
48
55
|
};
|
|
49
56
|
|
|
50
57
|
type Handler = (context: RouteContext) => Response | Promise<Response>;
|
|
@@ -61,8 +68,8 @@ export interface ActionRoutes {
|
|
|
61
68
|
/** Options for {@link actionRoutes}. */
|
|
62
69
|
export interface ActionRoutesOptions {
|
|
63
70
|
readonly interaction: Interaction;
|
|
64
|
-
readonly actions: Actions
|
|
65
|
-
readonly live: Live
|
|
71
|
+
readonly actions: Pick<Actions, "call" | "startRun" | "attach" | "cancel">;
|
|
72
|
+
readonly live: Pick<Live, "read">;
|
|
66
73
|
readonly log: Log;
|
|
67
74
|
/** The browser-protocol revisions served. */
|
|
68
75
|
readonly revisions: readonly string[];
|
|
@@ -73,8 +80,18 @@ function answer(diagnostic: Diagnostic, status: number): Response {
|
|
|
73
80
|
}
|
|
74
81
|
|
|
75
82
|
function failure(error: unknown): Response {
|
|
76
|
-
if (error instanceof RpcError)
|
|
77
|
-
|
|
83
|
+
if (error instanceof RpcError) {
|
|
84
|
+
const status = STATUS[error.diagnostic.code] ?? 500;
|
|
85
|
+
// A refusal that says when to try again (a rate limit) says so in `Retry-After` too.
|
|
86
|
+
const retryAfter = (error as { retryAfter?: unknown }).retryAfter;
|
|
87
|
+
if (typeof retryAfter === "number") {
|
|
88
|
+
return jsonResponse(
|
|
89
|
+
{ ...error.diagnostic },
|
|
90
|
+
{ status, headers: { "retry-after": String(retryAfter) } },
|
|
91
|
+
);
|
|
92
|
+
}
|
|
93
|
+
return answer(error.diagnostic, status);
|
|
94
|
+
}
|
|
78
95
|
throw error;
|
|
79
96
|
}
|
|
80
97
|
|
|
@@ -136,6 +153,21 @@ export function actionRoutes(options: ActionRoutesOptions): ActionRoutes {
|
|
|
136
153
|
const may = (page: PageIdentity, fnId: string): boolean =>
|
|
137
154
|
scopeAllows(page.scopes ?? [], `action:${fnId}` as CapabilityScope);
|
|
138
155
|
|
|
156
|
+
/**
|
|
157
|
+
* A paused artifact runs no actions (D165 item 14): a call or a new run is refused before
|
|
158
|
+
* anything is recorded, started or relayed to the owner.
|
|
159
|
+
*/
|
|
160
|
+
const paused = (page: PageIdentity): Response | undefined => {
|
|
161
|
+
const pause = interaction.pauseOf(page.artifactId);
|
|
162
|
+
if (!pause) return undefined;
|
|
163
|
+
return answer(
|
|
164
|
+
createDiagnostic("MOSTRA_ACTION_PAUSED", {
|
|
165
|
+
message: `This page is paused${pause.by === "operator" ? " by its server's operator" : ""}: its actions don't run until it is resumed.`,
|
|
166
|
+
}),
|
|
167
|
+
423,
|
|
168
|
+
);
|
|
169
|
+
};
|
|
170
|
+
|
|
139
171
|
return {
|
|
140
172
|
async call(context) {
|
|
141
173
|
const refused = served(context);
|
|
@@ -146,6 +178,8 @@ export function actionRoutes(options: ActionRoutesOptions): ActionRoutes {
|
|
|
146
178
|
const page = pageOf(context);
|
|
147
179
|
// The route checked `action:<fnId>` already (D97 item 4); this keeps the rule in one place.
|
|
148
180
|
if (!may(page, fnId)) return denied(fnId);
|
|
181
|
+
const pausedNow = paused(page);
|
|
182
|
+
if (pausedNow) return pausedNow;
|
|
149
183
|
let lines: AsyncIterable<unknown>;
|
|
150
184
|
const abort = new AbortController();
|
|
151
185
|
context.request.signal.addEventListener("abort", () => abort.abort(), { once: true });
|
|
@@ -199,6 +233,8 @@ export function actionRoutes(options: ActionRoutesOptions): ActionRoutes {
|
|
|
199
233
|
if (request instanceof Response) return request;
|
|
200
234
|
const page = pageOf(context);
|
|
201
235
|
if (!may(page, request.fnId)) return denied(request.fnId);
|
|
236
|
+
const pausedNow = paused(page);
|
|
237
|
+
if (pausedNow) return pausedNow;
|
|
202
238
|
try {
|
|
203
239
|
return jsonResponse(
|
|
204
240
|
actions.startRun(page, {
|
package/src/gateway/browser.ts
CHANGED
|
@@ -12,6 +12,7 @@ import {
|
|
|
12
12
|
type EventRecord,
|
|
13
13
|
FieldsRequest,
|
|
14
14
|
FollowRequest,
|
|
15
|
+
type Refusal,
|
|
15
16
|
RpcError,
|
|
16
17
|
refusal,
|
|
17
18
|
ShellSubmitRequest,
|
|
@@ -64,6 +65,8 @@ const STATUS: Readonly<Record<string, number>> = {
|
|
|
64
65
|
MOSTRA_HOME_DISK_FULL: 507,
|
|
65
66
|
MOSTRA_HOME_GONE: 503,
|
|
66
67
|
MOSTRA_HYGIENE_SCOPE_DENIED: 403,
|
|
68
|
+
// A paused artifact takes no answers (D165 item 14).
|
|
69
|
+
MOSTRA_SUBMIT_PAUSED: 423,
|
|
67
70
|
};
|
|
68
71
|
|
|
69
72
|
/** Options for {@link browserRoutes}. */
|
|
@@ -86,6 +89,14 @@ export interface BrowserRoutesOptions {
|
|
|
86
89
|
* without an `id`, a poll as its `ephemeral` (LL-04). Absent: neither carries any.
|
|
87
90
|
*/
|
|
88
91
|
readonly bus?: EphemeralBus;
|
|
92
|
+
/**
|
|
93
|
+
* Before a submit, from the frame or the shell (a remote server's, D165 item 13): a refusal (with
|
|
94
|
+
* when to try again) keeps the draft; nothing is recorded. Absent: every submit goes on.
|
|
95
|
+
*/
|
|
96
|
+
readonly admitSubmit?: (
|
|
97
|
+
page: PageIdentity,
|
|
98
|
+
context: RouteContext,
|
|
99
|
+
) => Promise<(Refusal & { readonly retryAfter?: number }) | undefined>;
|
|
89
100
|
/** Tells a host with a `trustedControls` port that a trusted control was used (D108). */
|
|
90
101
|
readonly activated: (event: {
|
|
91
102
|
readonly artifactId: string;
|
|
@@ -177,6 +188,8 @@ export interface BrowserRoutes {
|
|
|
177
188
|
readonly stream: Handler;
|
|
178
189
|
readonly poll: Handler;
|
|
179
190
|
/** The shell's trusted Submit (the `shell` channel, D40), on the shell origin. */
|
|
191
|
+
/** `events/poll` on the shell origin: the same, without the frame's run and live updates (#119). */
|
|
192
|
+
readonly shellPoll: Handler;
|
|
180
193
|
readonly shellSubmit: Handler;
|
|
181
194
|
/** The shell's trusted Choose (D65, D113), on the shell origin. */
|
|
182
195
|
readonly choose: Handler;
|
|
@@ -206,6 +219,35 @@ export function browserRoutes(options: BrowserRoutesOptions): BrowserRoutes {
|
|
|
206
219
|
};
|
|
207
220
|
};
|
|
208
221
|
|
|
222
|
+
/** The answer to a submit the server's rules refused before it reached the ledger. */
|
|
223
|
+
const admit = async (
|
|
224
|
+
context: RouteContext,
|
|
225
|
+
request: { readonly viewId: string; readonly expectedRevision: unknown },
|
|
226
|
+
): Promise<Response | undefined> => {
|
|
227
|
+
if (!options.admitSubmit) return undefined;
|
|
228
|
+
// A repeat of a recorded submit answers that submission, and one a paused page or a view not
|
|
229
|
+
// the page's refuses is refused before anything is recorded: neither spends the submission
|
|
230
|
+
// rates or asks the operator (Fable review of WP-30, 8). The server's per-IP request rate
|
|
231
|
+
// still bounds them, as it bounds every request (`rateLimits.perIp.requests`).
|
|
232
|
+
const page = pageOf(context);
|
|
233
|
+
if (
|
|
234
|
+
!interaction.wouldRecord(page, {
|
|
235
|
+
viewId: request.viewId,
|
|
236
|
+
expectedRevision: Number(request.expectedRevision),
|
|
237
|
+
})
|
|
238
|
+
) {
|
|
239
|
+
return undefined;
|
|
240
|
+
}
|
|
241
|
+
const refused = await options.admitSubmit(page, context);
|
|
242
|
+
if (!refused) return undefined;
|
|
243
|
+
return jsonResponse(refused.diagnostic, {
|
|
244
|
+
status: refused.status,
|
|
245
|
+
...(refused.retryAfter !== undefined
|
|
246
|
+
? { headers: { "retry-after": String(refused.retryAfter) } }
|
|
247
|
+
: {}),
|
|
248
|
+
});
|
|
249
|
+
};
|
|
250
|
+
|
|
209
251
|
/** The view a stream or poll is for, checked against the page (D104). */
|
|
210
252
|
const viewOf = (context: RouteContext, page: PageIdentity): Response | undefined => {
|
|
211
253
|
const view = new URL(context.request.url).searchParams.get("view");
|
|
@@ -250,6 +292,8 @@ export function browserRoutes(options: BrowserRoutesOptions): BrowserRoutes {
|
|
|
250
292
|
if (refused) return refused;
|
|
251
293
|
const request = await body(context, SubmitRequest);
|
|
252
294
|
if (request instanceof Response) return request;
|
|
295
|
+
const admitted = await admit(context, request);
|
|
296
|
+
if (admitted) return admitted;
|
|
253
297
|
try {
|
|
254
298
|
return jsonResponse(
|
|
255
299
|
interaction.submit(pageOf(context), {
|
|
@@ -439,107 +483,117 @@ export function browserRoutes(options: BrowserRoutesOptions): BrowserRoutes {
|
|
|
439
483
|
});
|
|
440
484
|
};
|
|
441
485
|
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
};
|
|
465
|
-
if (resume === undefined) {
|
|
466
|
-
const snapshot = interaction.pageSnapshot(page);
|
|
467
|
-
return jsonResponse(withEphemeral({ cursor: snapshot.cursor, events: [], snapshot }));
|
|
468
|
-
}
|
|
469
|
-
const revoked = (): Response =>
|
|
470
|
-
answer(
|
|
471
|
-
refusal(
|
|
472
|
-
"MOSTRA_HYGIENE_TOKEN_REVOKED",
|
|
473
|
-
"The link this page came from was revoked or has expired.",
|
|
474
|
-
410,
|
|
475
|
-
).diagnostic,
|
|
476
|
-
410,
|
|
477
|
-
);
|
|
478
|
-
const once = () => {
|
|
479
|
-
const read = next(page, resume);
|
|
480
|
-
return "snapshot" in read
|
|
481
|
-
? { cursor: read.snapshot.cursor, events: [], snapshot: read.snapshot }
|
|
482
|
-
: { cursor: String(read.cursor), events: read.events };
|
|
483
|
-
};
|
|
484
|
-
try {
|
|
485
|
-
const first = once();
|
|
486
|
-
if (first.events.length > 0 || "snapshot" in first || waitS === 0 || early.length > 0) {
|
|
487
|
-
return jsonResponse(withEphemeral(first));
|
|
486
|
+
/**
|
|
487
|
+
* `events/poll`. The frame's poll also answers with the run and live updates its view collected
|
|
488
|
+
* (LL-04); the shell's poll of the same view leaves them to the frame, which is the one that shows
|
|
489
|
+
* them: taking them made a page on a quick tunnel learn of a finished run only at its next renewal,
|
|
490
|
+
* about 20 s later (#119).
|
|
491
|
+
*/
|
|
492
|
+
const pollFor =
|
|
493
|
+
(ephemeral: boolean) =>
|
|
494
|
+
async (context: RouteContext): Promise<Response> => {
|
|
495
|
+
const refused = knownRevision(context);
|
|
496
|
+
if (refused) return refused;
|
|
497
|
+
const page = pageOf(context);
|
|
498
|
+
const badView = viewOf(context, page);
|
|
499
|
+
if (badView) return badView;
|
|
500
|
+
const resume = cursorOf(context.request);
|
|
501
|
+
if (resume === "invalid") return malformed("`cursor` must be an event cursor.");
|
|
502
|
+
const waitParam = new URL(context.request.url).searchParams.get("wait");
|
|
503
|
+
const waitS = waitParam === null ? POLL_MAX_WAIT_S : Number(waitParam);
|
|
504
|
+
if (!Number.isInteger(waitS) || waitS < 0 || waitS > POLL_MAX_WAIT_S) {
|
|
505
|
+
return malformed(
|
|
506
|
+
`\`wait\` must be a whole number of seconds from 0 to ${POLL_MAX_WAIT_S}.`,
|
|
507
|
+
);
|
|
488
508
|
}
|
|
489
|
-
|
|
490
|
-
const
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
509
|
+
const viewId = viewIdOf(context);
|
|
510
|
+
const bus = ephemeral ? options.bus : undefined;
|
|
511
|
+
// Polling views collect their run and live updates between polls (LL-04).
|
|
512
|
+
// Taking what is queued also starts the queue, so updates during the wait are kept.
|
|
513
|
+
let early = bus?.drain(page.artifactId, viewId) ?? [];
|
|
514
|
+
const withEphemeral = <T extends object>(value: T): T & { ephemeral?: unknown[] } => {
|
|
515
|
+
const ephemeral = [...early, ...(bus?.drain(page.artifactId, viewId) ?? [])];
|
|
516
|
+
early = [];
|
|
517
|
+
return ephemeral.length > 0 ? { ...value, ephemeral } : value;
|
|
518
|
+
};
|
|
519
|
+
if (resume === undefined) {
|
|
520
|
+
const snapshot = interaction.pageSnapshot(page);
|
|
521
|
+
return jsonResponse(withEphemeral({ cursor: snapshot.cursor, events: [], snapshot }));
|
|
522
|
+
}
|
|
523
|
+
const revoked = (): Response =>
|
|
524
|
+
answer(
|
|
525
|
+
refusal(
|
|
526
|
+
"MOSTRA_HYGIENE_TOKEN_REVOKED",
|
|
527
|
+
"The link this page came from was revoked or has expired.",
|
|
528
|
+
410,
|
|
529
|
+
).diagnostic,
|
|
530
|
+
410,
|
|
531
|
+
);
|
|
532
|
+
const once = () => {
|
|
533
|
+
const read = next(page, resume);
|
|
534
|
+
return "snapshot" in read
|
|
535
|
+
? { cursor: read.snapshot.cursor, events: [], snapshot: read.snapshot }
|
|
536
|
+
: { cursor: String(read.cursor), events: read.events };
|
|
537
|
+
};
|
|
538
|
+
try {
|
|
539
|
+
const first = once();
|
|
540
|
+
if (first.events.length > 0 || "snapshot" in first || waitS === 0 || early.length > 0) {
|
|
541
|
+
return jsonResponse(withEphemeral(first));
|
|
542
|
+
}
|
|
543
|
+
let ended = false;
|
|
544
|
+
const stopWaiting = new AbortController();
|
|
545
|
+
const result = await new Promise<ReturnType<typeof once>>((resolve, reject) => {
|
|
546
|
+
let done = false;
|
|
547
|
+
const finish = (value?: ReturnType<typeof once>): void => {
|
|
510
548
|
if (done) return;
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
549
|
+
done = true;
|
|
550
|
+
clearTimeout(timer);
|
|
551
|
+
unsubscribe();
|
|
552
|
+
context.request.signal.removeEventListener("abort", aborted);
|
|
553
|
+
// A failing read here (the ledger closing at shutdown, say) answers this request; it
|
|
554
|
+
// never escapes the timer as an uncaught exception (Claude review finding 8).
|
|
517
555
|
try {
|
|
518
|
-
|
|
519
|
-
if (value.events.length > 0 || "snapshot" in value) finish(value);
|
|
556
|
+
resolve(value ?? once());
|
|
520
557
|
} catch (error) {
|
|
521
|
-
done = true;
|
|
522
|
-
clearTimeout(timer);
|
|
523
|
-
unsubscribe();
|
|
524
558
|
reject(error);
|
|
525
559
|
}
|
|
526
|
-
}
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
560
|
+
};
|
|
561
|
+
const aborted = (): void => finish(first);
|
|
562
|
+
const unsubscribe = interaction.onCommit(() =>
|
|
563
|
+
setImmediate(() => {
|
|
564
|
+
if (done) return;
|
|
565
|
+
// A revoked or expired link ends the poll before it reads anything more.
|
|
566
|
+
if (!live(context)) {
|
|
567
|
+
ended = true;
|
|
568
|
+
finish(first);
|
|
569
|
+
return;
|
|
570
|
+
}
|
|
571
|
+
try {
|
|
572
|
+
const value = once();
|
|
573
|
+
if (value.events.length > 0 || "snapshot" in value) finish(value);
|
|
574
|
+
} catch (error) {
|
|
575
|
+
done = true;
|
|
576
|
+
clearTimeout(timer);
|
|
577
|
+
unsubscribe();
|
|
578
|
+
reject(error);
|
|
579
|
+
}
|
|
580
|
+
}),
|
|
581
|
+
);
|
|
582
|
+
const timer = setTimeout(() => finish(), waitS * 1000);
|
|
583
|
+
context.request.signal.addEventListener("abort", aborted, { once: true });
|
|
584
|
+
// A run or live update for this view answers the poll too.
|
|
585
|
+
void bus?.wait(page.artifactId, viewId, waitS * 1000, stopWaiting.signal).then(() => {
|
|
586
|
+
if (!done) finish(first);
|
|
587
|
+
});
|
|
533
588
|
});
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
}
|
|
542
|
-
};
|
|
589
|
+
stopWaiting.abort();
|
|
590
|
+
// The link is checked again at the end: nothing read after it died leaves (HY-03).
|
|
591
|
+
if (ended || !live(context)) return revoked();
|
|
592
|
+
return jsonResponse(withEphemeral(result));
|
|
593
|
+
} catch (error) {
|
|
594
|
+
return failure(error);
|
|
595
|
+
}
|
|
596
|
+
};
|
|
543
597
|
|
|
544
598
|
// ── The shell's own routes (WP-07) ─────────────────────────────────────────────────────
|
|
545
599
|
// They run on the shell origin behind the shell's session, its exact Origin and its CSRF
|
|
@@ -550,6 +604,8 @@ export function browserRoutes(options: BrowserRoutesOptions): BrowserRoutes {
|
|
|
550
604
|
if (refused) return refused;
|
|
551
605
|
const request = await body(context, ShellSubmitRequest);
|
|
552
606
|
if (request instanceof Response) return request;
|
|
607
|
+
const admitted = await admit(context, request);
|
|
608
|
+
if (admitted) return admitted;
|
|
553
609
|
const page = pageOf(context);
|
|
554
610
|
let submission: SubmissionSummary & { readonly duplicate?: true };
|
|
555
611
|
try {
|
|
@@ -648,5 +704,16 @@ export function browserRoutes(options: BrowserRoutesOptions): BrowserRoutes {
|
|
|
648
704
|
}
|
|
649
705
|
};
|
|
650
706
|
|
|
651
|
-
return {
|
|
707
|
+
return {
|
|
708
|
+
fields,
|
|
709
|
+
submit,
|
|
710
|
+
signal,
|
|
711
|
+
stream,
|
|
712
|
+
poll: pollFor(true),
|
|
713
|
+
shellPoll: pollFor(false),
|
|
714
|
+
shellSubmit,
|
|
715
|
+
choose,
|
|
716
|
+
follow,
|
|
717
|
+
carry,
|
|
718
|
+
};
|
|
652
719
|
}
|
|
@@ -178,8 +178,11 @@ export interface ResolvedSession {
|
|
|
178
178
|
readonly csrf: string;
|
|
179
179
|
/** The version a frame session entered (D98 item 5). */
|
|
180
180
|
readonly versionId?: string;
|
|
181
|
-
/**
|
|
182
|
-
|
|
181
|
+
/**
|
|
182
|
+
* How the session authenticates: a cookie, the frame header of worker mode (D70), or a hosted
|
|
183
|
+
* shell's header (`X-Mostra-Shell`, D165 item 8).
|
|
184
|
+
*/
|
|
185
|
+
readonly mode: SessionMode;
|
|
183
186
|
readonly grant: Grant;
|
|
184
187
|
/**
|
|
185
188
|
* The viewer the session acts as: its link's viewer (D104), else the one the host's identity
|
|
@@ -216,11 +219,14 @@ interface TokenRow {
|
|
|
216
219
|
viewer_id: string | null;
|
|
217
220
|
}
|
|
218
221
|
|
|
222
|
+
/** How a session authenticates (DATA_MODEL §3 `session.mode`). */
|
|
223
|
+
export type SessionMode = "cookie" | "worker" | "header";
|
|
224
|
+
|
|
219
225
|
interface SessionRow {
|
|
220
226
|
id: string;
|
|
221
227
|
token_id: string;
|
|
222
228
|
origin: string;
|
|
223
|
-
mode:
|
|
229
|
+
mode: SessionMode;
|
|
224
230
|
csrf: string;
|
|
225
231
|
version_id: string | null;
|
|
226
232
|
viewer_id: string | null;
|
|
@@ -255,6 +261,11 @@ export interface CapabilitiesOptions {
|
|
|
255
261
|
* face, a host's): a launch ticket is only minted for a link whose address is served.
|
|
256
262
|
*/
|
|
257
263
|
readonly servesShell?: (origin: string) => boolean;
|
|
264
|
+
/**
|
|
265
|
+
* Told each token minted, after its row is written (a remote server indexes its hosted homes'
|
|
266
|
+
* links, so its operator's `revokeLink` finds a link's home, WP-30).
|
|
267
|
+
*/
|
|
268
|
+
readonly onMinted?: (token: { readonly tokenId: string; readonly artifactId: string }) => void;
|
|
258
269
|
}
|
|
259
270
|
|
|
260
271
|
/** What a stream ticket opens (D158 item 5). */
|
|
@@ -268,6 +279,7 @@ export class Capabilities {
|
|
|
268
279
|
readonly #now: () => number;
|
|
269
280
|
readonly #shellOrigin: () => string;
|
|
270
281
|
readonly #servesShell: (origin: string) => boolean;
|
|
282
|
+
readonly #onMinted: CapabilitiesOptions["onMinted"];
|
|
271
283
|
/** Single-use stream and socket tickets (D158 item 5), by the SHA-256 of their secret. */
|
|
272
284
|
readonly #streamTickets = new Map<
|
|
273
285
|
string,
|
|
@@ -298,6 +310,7 @@ export class Capabilities {
|
|
|
298
310
|
this.#now = options.now;
|
|
299
311
|
this.#shellOrigin = options.shellOrigin;
|
|
300
312
|
this.#servesShell = options.servesShell ?? ((origin) => origin === this.#shellOrigin());
|
|
313
|
+
this.#onMinted = options.onMinted;
|
|
301
314
|
}
|
|
302
315
|
|
|
303
316
|
/** Runs `fn` in the caller's transaction, or in a new one. */
|
|
@@ -353,6 +366,7 @@ export class Capabilities {
|
|
|
353
366
|
input.pinnedVersion ?? null,
|
|
354
367
|
shellOrigin,
|
|
355
368
|
);
|
|
369
|
+
this.#onMinted?.({ tokenId, artifactId: input.artifactId });
|
|
356
370
|
return {
|
|
357
371
|
tokenId,
|
|
358
372
|
secret,
|
|
@@ -618,8 +632,11 @@ export class Capabilities {
|
|
|
618
632
|
readonly versionId?: string;
|
|
619
633
|
/** The person the host's identity port named, for a link without a viewer (D143 item 2). */
|
|
620
634
|
readonly viewerId?: string | undefined;
|
|
621
|
-
/**
|
|
622
|
-
|
|
635
|
+
/**
|
|
636
|
+
* `worker` for a worker-mode frame (D70) and `header` for a hosted shell (D165 item 8), whose
|
|
637
|
+
* secrets travel in headers; default `cookie`.
|
|
638
|
+
*/
|
|
639
|
+
readonly mode?: SessionMode;
|
|
623
640
|
}): {
|
|
624
641
|
readonly cookie: string;
|
|
625
642
|
readonly csrf: string;
|
|
@@ -655,7 +672,7 @@ export class Capabilities {
|
|
|
655
672
|
cookies: readonly string[],
|
|
656
673
|
origin: string,
|
|
657
674
|
artifactId: string,
|
|
658
|
-
mode:
|
|
675
|
+
mode: SessionMode = "cookie",
|
|
659
676
|
): ResolvedSession | Refusal {
|
|
660
677
|
let revoked = false;
|
|
661
678
|
for (const value of cookies) {
|
package/src/gateway/http.ts
CHANGED
|
@@ -29,6 +29,11 @@ export interface ListenerKind {
|
|
|
29
29
|
readonly origin: string;
|
|
30
30
|
/** The shell's origin: the only page that may frame an artifact (D98 item 4). */
|
|
31
31
|
readonly shellOrigin: string;
|
|
32
|
+
/**
|
|
33
|
+
* The framers an artifact's documents name, when they are more than its shell: a hosted
|
|
34
|
+
* label's are the shells of its domain an operator also serves it under (INTERFACES §18.6).
|
|
35
|
+
*/
|
|
36
|
+
readonly frameAncestors?: string;
|
|
32
37
|
}
|
|
33
38
|
|
|
34
39
|
/**
|
|
@@ -53,6 +58,10 @@ export function documentHeaders(
|
|
|
53
58
|
"base-uri 'none'",
|
|
54
59
|
"form-action 'none'",
|
|
55
60
|
"object-src 'none'",
|
|
61
|
+
// No string reaches a script sink on the shell: every text a tenant or operator supplies
|
|
62
|
+
// renders as text, and a DOM-injection attempt throws (Trusted Types, HY-09).
|
|
63
|
+
"require-trusted-types-for 'script'",
|
|
64
|
+
"trusted-types 'none'",
|
|
56
65
|
].join("; "),
|
|
57
66
|
"x-frame-options": "DENY",
|
|
58
67
|
// Popups the artifact frame opens get no opener, so none can navigate this page (D98
|
|
@@ -60,7 +69,9 @@ export function documentHeaders(
|
|
|
60
69
|
"cross-origin-opener-policy": "same-origin",
|
|
61
70
|
};
|
|
62
71
|
}
|
|
63
|
-
return {
|
|
72
|
+
return {
|
|
73
|
+
"content-security-policy": `frame-ancestors ${listener.frameAncestors ?? listener.shellOrigin}`,
|
|
74
|
+
};
|
|
64
75
|
}
|
|
65
76
|
|
|
66
77
|
/** Every header of a request as `[name, value]` pairs, repeats kept. */
|