@mostra/runtime 0.10.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 +4058 -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-DCiUHvgZ.js} +682 -47
- 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 +10 -5
- package/src/gateway/actions.ts +20 -0
- package/src/gateway/browser.ts +44 -0
- package/src/gateway/capabilities.ts +8 -0
- package/src/gateway/http.ts +12 -1
- package/src/gateway/index.ts +170 -5
- package/src/gateway/listener.ts +31 -6
- package/src/gateway/routes.ts +8 -0
- package/src/gc/index.ts +5 -0
- package/src/instance/index.ts +20 -1
- package/src/interaction/index.ts +60 -0
- package/src/interaction/pause.ts +106 -0
- package/src/interaction/submissions.ts +42 -1
- package/src/interaction/viewers.ts +34 -1
- package/src/ledger/index.ts +20 -1
- package/src/ledger/migrations.ts +51 -0
- package/src/link/author.ts +215 -0
- package/src/link/hosted.ts +37 -1
- package/src/link/http.ts +6 -1
- package/src/link/index.ts +3 -1
- package/src/link/manager.ts +138 -34
- 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 +69 -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 +519 -18
- package/src/server/index.ts +343 -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 +498 -0
- package/src/server/providers.ts +284 -0
- package/src/server/remove.ts +148 -0
- package/src/server/routing.ts +275 -0
- package/src/verify/runner.ts +23 -2
- package/dist/instance-FExcyENK.js.map +0 -1
package/src/link/manager.ts
CHANGED
|
@@ -26,12 +26,16 @@ import {
|
|
|
26
26
|
type HostedRoute,
|
|
27
27
|
hostedPushMethod,
|
|
28
28
|
hostedSubmissionMethod,
|
|
29
|
+
LinkId,
|
|
29
30
|
type ListingEntry,
|
|
30
31
|
type MethodDefinition,
|
|
32
|
+
portRelayAuthorMethod,
|
|
31
33
|
portSubmissionsDeliverMethod,
|
|
32
34
|
type RemoteLink,
|
|
35
|
+
type RemoteLinkResult,
|
|
33
36
|
type RemoteLoginResult,
|
|
34
37
|
RpcError,
|
|
38
|
+
remoteLinkMethod,
|
|
35
39
|
remoteLoginMethod,
|
|
36
40
|
remoteLoginWaitMethod,
|
|
37
41
|
remoteLogoutMethod,
|
|
@@ -126,11 +130,17 @@ function loginFailed(message: string): RpcError {
|
|
|
126
130
|
}
|
|
127
131
|
|
|
128
132
|
/** What the link keeps for a server in `<home>/keys/remote/<server key>.json` (DATA_MODEL §7.3). */
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
133
|
+
/**
|
|
134
|
+
* How this home signs in to a server: a person's sign-in (the device grant's refresh token, rotated
|
|
135
|
+
* at every use) or a key the server's operator issued (`remote/link`, D167), used as is.
|
|
136
|
+
*/
|
|
137
|
+
type Credentials =
|
|
138
|
+
| { readonly server: string; readonly instanceId: string; readonly refreshToken: string }
|
|
139
|
+
| { readonly server: string; readonly instanceId: string; readonly key: string };
|
|
140
|
+
|
|
141
|
+
/** The secret a home's credentials hold. */
|
|
142
|
+
const credentialSecret = (credentials: Credentials): string =>
|
|
143
|
+
"key" in credentials ? credentials.key : credentials.refreshToken;
|
|
134
144
|
|
|
135
145
|
/** A `remote_link` row. */
|
|
136
146
|
interface LinkRow {
|
|
@@ -166,6 +176,8 @@ export interface LinkOptions {
|
|
|
166
176
|
readonly actions: OwnerRelayOptions["actions"];
|
|
167
177
|
/** Hosted pages' live interest changed. */
|
|
168
178
|
readonly liveChanged?: () => void;
|
|
179
|
+
/** Answers remote MCP's relayed authoring (`port/relay.author`, D165 item 5). */
|
|
180
|
+
readonly author?: (server: string, params: unknown) => Promise<unknown>;
|
|
169
181
|
/** The clock (tests move it). */
|
|
170
182
|
readonly now?: () => number;
|
|
171
183
|
}
|
|
@@ -209,6 +221,8 @@ export interface Link {
|
|
|
209
221
|
* first it was shared to.
|
|
210
222
|
*/
|
|
211
223
|
hostedOn(artifactId: string): string | undefined;
|
|
224
|
+
/** Every server an artifact is hosted on now, in the order it was shared to them. */
|
|
225
|
+
hostedServers(artifactId: string): string[];
|
|
212
226
|
/**
|
|
213
227
|
* Calls a method on a server's hosted home for this home's client: a hosted artifact's
|
|
214
228
|
* `state/*` and `live/push` (D165 item 1). `MOSTRA_REMOTE_UNREACHABLE` when it can't be reached.
|
|
@@ -272,8 +286,11 @@ export function createLink(options: LinkOptions): Link {
|
|
|
272
286
|
if (!existsSync(file)) return undefined;
|
|
273
287
|
try {
|
|
274
288
|
const parsed = JSON.parse(readFileSync(file, "utf8")) as Credentials;
|
|
275
|
-
|
|
276
|
-
|
|
289
|
+
const secret =
|
|
290
|
+
(parsed as { refreshToken?: unknown; key?: unknown }).refreshToken ??
|
|
291
|
+
(parsed as { key?: unknown }).key;
|
|
292
|
+
if (parsed.server !== server || typeof secret !== "string") return undefined;
|
|
293
|
+
options.protect(secret);
|
|
277
294
|
return parsed;
|
|
278
295
|
} catch {
|
|
279
296
|
return undefined;
|
|
@@ -281,7 +298,7 @@ export function createLink(options: LinkOptions): Link {
|
|
|
281
298
|
};
|
|
282
299
|
const writeCredentials = (credentials: Credentials): void => {
|
|
283
300
|
mkdirSync(keysDir, { recursive: true, mode: 0o700 });
|
|
284
|
-
options.protect(credentials
|
|
301
|
+
options.protect(credentialSecret(credentials));
|
|
285
302
|
// Written beside it, then renamed: a crash never leaves half a token (as secrets are, D131).
|
|
286
303
|
const target = credentialsFile(credentials.server);
|
|
287
304
|
const temporary = `${target}.${process.pid}.tmp`;
|
|
@@ -343,6 +360,9 @@ export function createLink(options: LinkOptions): Link {
|
|
|
343
360
|
try {
|
|
344
361
|
const credentials = readCredentials(connection.server);
|
|
345
362
|
if (!credentials) throw loginFailed(`This home isn't signed in to ${connection.server}.`);
|
|
363
|
+
// An operator's key is the bearer itself: nothing to refresh, and the server asks the
|
|
364
|
+
// operator again while the binding is open.
|
|
365
|
+
if ("key" in credentials) return credentials.key;
|
|
346
366
|
const answer = await postForm(
|
|
347
367
|
connection.server,
|
|
348
368
|
"/oauth/token",
|
|
@@ -555,6 +575,16 @@ export function createLink(options: LinkOptions): Link {
|
|
|
555
575
|
const onRequest =
|
|
556
576
|
(connection: Connection) =>
|
|
557
577
|
(method: string, params: unknown): unknown => {
|
|
578
|
+
if (method === portRelayAuthorMethod.method) {
|
|
579
|
+
if (!options.author) {
|
|
580
|
+
throw new RpcError(
|
|
581
|
+
createDiagnostic("MOSTRA_REMOTE_NO_INSTANCE", {
|
|
582
|
+
message: "This instance takes no authoring from a chat host.",
|
|
583
|
+
}),
|
|
584
|
+
);
|
|
585
|
+
}
|
|
586
|
+
return options.author(connection.server, params);
|
|
587
|
+
}
|
|
558
588
|
if (relay.handles(method)) {
|
|
559
589
|
return relay.request(
|
|
560
590
|
connection.server,
|
|
@@ -960,6 +990,91 @@ export function createLink(options: LinkOptions): Link {
|
|
|
960
990
|
return last.server;
|
|
961
991
|
};
|
|
962
992
|
|
|
993
|
+
/** Records this home's link to a server, rebinding its marks only to the same link (WP-29). */
|
|
994
|
+
const recordLink = (
|
|
995
|
+
server: string,
|
|
996
|
+
account: { readonly id: string; readonly name?: string | undefined },
|
|
997
|
+
instanceId: string,
|
|
998
|
+
isDefault: boolean,
|
|
999
|
+
): void => {
|
|
1000
|
+
ledger.write((db) =>
|
|
1001
|
+
db.run(
|
|
1002
|
+
`INSERT INTO remote_link (server, account_id, account_name, instance_id, is_default, linked_at, state)
|
|
1003
|
+
VALUES (?, ?, ?, ?, ?, ?, 'signed-in')
|
|
1004
|
+
ON CONFLICT (server) DO UPDATE SET
|
|
1005
|
+
-- Another link (after --forget, or another account) starts with no marks: a mark
|
|
1006
|
+
-- of the old link would make the new one's home look restored (Opus review of
|
|
1007
|
+
-- WP-29, 9).
|
|
1008
|
+
relay_mark = CASE WHEN remote_link.instance_id IS excluded.instance_id
|
|
1009
|
+
AND remote_link.account_id = excluded.account_id THEN remote_link.relay_mark ELSE 0 END,
|
|
1010
|
+
follow_cursor = CASE WHEN remote_link.instance_id IS excluded.instance_id
|
|
1011
|
+
AND remote_link.account_id = excluded.account_id THEN remote_link.follow_cursor ELSE NULL END,
|
|
1012
|
+
incarnation = CASE WHEN remote_link.instance_id IS excluded.instance_id
|
|
1013
|
+
AND remote_link.account_id = excluded.account_id THEN remote_link.incarnation ELSE NULL END,
|
|
1014
|
+
account_id = excluded.account_id, account_name = excluded.account_name,
|
|
1015
|
+
instance_id = excluded.instance_id, is_default = excluded.is_default, linked_at = excluded.linked_at,
|
|
1016
|
+
state = 'signed-in'`,
|
|
1017
|
+
server,
|
|
1018
|
+
account.id,
|
|
1019
|
+
account.name ?? null,
|
|
1020
|
+
instanceId,
|
|
1021
|
+
isDefault ? 1 : 0,
|
|
1022
|
+
new Date(now()).toISOString(),
|
|
1023
|
+
),
|
|
1024
|
+
);
|
|
1025
|
+
};
|
|
1026
|
+
|
|
1027
|
+
/**
|
|
1028
|
+
* Links this home with a key the server's operator issued (`remote/link`, D167): the server says
|
|
1029
|
+
* which account and instance link the key binds, the key is kept like a refresh token, and the
|
|
1030
|
+
* binding opens with it at once.
|
|
1031
|
+
*/
|
|
1032
|
+
const linkWithKey = async (
|
|
1033
|
+
requested: string,
|
|
1034
|
+
key: string,
|
|
1035
|
+
makeDefault: boolean,
|
|
1036
|
+
): Promise<RemoteLinkResult> => {
|
|
1037
|
+
const server = serverOrigin(requested);
|
|
1038
|
+
options.protect(key);
|
|
1039
|
+
const answer = await postForm(
|
|
1040
|
+
server,
|
|
1041
|
+
"/link",
|
|
1042
|
+
makeDefault ? { default: "1" } : {},
|
|
1043
|
+
connectTo,
|
|
1044
|
+
key,
|
|
1045
|
+
);
|
|
1046
|
+
const account = answer.json["account"] as { id?: unknown; name?: unknown } | undefined;
|
|
1047
|
+
const instanceId = answer.json["instanceId"];
|
|
1048
|
+
if (
|
|
1049
|
+
answer.status !== 200 ||
|
|
1050
|
+
typeof account?.id !== "string" ||
|
|
1051
|
+
typeof instanceId !== "string" ||
|
|
1052
|
+
!LinkId.is(instanceId)
|
|
1053
|
+
) {
|
|
1054
|
+
throw loginFailed(
|
|
1055
|
+
`${server} didn't admit this key (${String(answer.json["message"] ?? answer.status)}).`,
|
|
1056
|
+
);
|
|
1057
|
+
}
|
|
1058
|
+
const name = typeof account.name === "string" ? account.name : undefined;
|
|
1059
|
+
const isDefault = answer.json["default"] === true;
|
|
1060
|
+
writeCredentials({ server, key, instanceId });
|
|
1061
|
+
recordLink(server, { id: account.id, name }, instanceId, isDefault);
|
|
1062
|
+
const previous = connections.get(server);
|
|
1063
|
+
if (previous) {
|
|
1064
|
+
await previous.binding.stop();
|
|
1065
|
+
if (previous.refreshTimer) clearTimeout(previous.refreshTimer);
|
|
1066
|
+
connections.delete(server);
|
|
1067
|
+
}
|
|
1068
|
+
connect(server);
|
|
1069
|
+
log.info("link.linked_with_key", { server, instanceId });
|
|
1070
|
+
return {
|
|
1071
|
+
server,
|
|
1072
|
+
account: { id: account.id, ...(name !== undefined ? { name } : {}) },
|
|
1073
|
+
instanceId,
|
|
1074
|
+
default: isDefault,
|
|
1075
|
+
};
|
|
1076
|
+
};
|
|
1077
|
+
|
|
963
1078
|
/** Starts a sign-in: the device grant's code, then polls for the token in the background. */
|
|
964
1079
|
const login = async (
|
|
965
1080
|
requested: string | undefined,
|
|
@@ -1047,31 +1162,7 @@ export function createLink(options: LinkOptions): Link {
|
|
|
1047
1162
|
const accessToken = String(answer.json["access_token"]);
|
|
1048
1163
|
options.protect(accessToken);
|
|
1049
1164
|
writeCredentials({ server, refreshToken, instanceId });
|
|
1050
|
-
|
|
1051
|
-
db.run(
|
|
1052
|
-
`INSERT INTO remote_link (server, account_id, account_name, instance_id, is_default, linked_at, state)
|
|
1053
|
-
VALUES (?, ?, ?, ?, ?, ?, 'signed-in')
|
|
1054
|
-
ON CONFLICT (server) DO UPDATE SET
|
|
1055
|
-
-- Another link (after --forget, or another account) starts with no marks: a mark
|
|
1056
|
-
-- of the old link would make the new one's home look restored (Opus review of
|
|
1057
|
-
-- WP-29, 9).
|
|
1058
|
-
relay_mark = CASE WHEN remote_link.instance_id IS excluded.instance_id
|
|
1059
|
-
AND remote_link.account_id = excluded.account_id THEN remote_link.relay_mark ELSE 0 END,
|
|
1060
|
-
follow_cursor = CASE WHEN remote_link.instance_id IS excluded.instance_id
|
|
1061
|
-
AND remote_link.account_id = excluded.account_id THEN remote_link.follow_cursor ELSE NULL END,
|
|
1062
|
-
incarnation = CASE WHEN remote_link.instance_id IS excluded.instance_id
|
|
1063
|
-
AND remote_link.account_id = excluded.account_id THEN remote_link.incarnation ELSE NULL END,
|
|
1064
|
-
account_id = excluded.account_id, account_name = excluded.account_name,
|
|
1065
|
-
instance_id = excluded.instance_id, is_default = excluded.is_default, linked_at = excluded.linked_at,
|
|
1066
|
-
state = 'signed-in'`,
|
|
1067
|
-
server,
|
|
1068
|
-
account.id,
|
|
1069
|
-
account.name ?? null,
|
|
1070
|
-
instanceId,
|
|
1071
|
-
answer.json["mostra_default"] === true ? 1 : 0,
|
|
1072
|
-
new Date(now()).toISOString(),
|
|
1073
|
-
),
|
|
1074
|
-
);
|
|
1165
|
+
recordLink(server, account, instanceId, answer.json["mostra_default"] === true);
|
|
1075
1166
|
const previous = connections.get(server);
|
|
1076
1167
|
if (previous) {
|
|
1077
1168
|
await previous.binding.stop();
|
|
@@ -1132,6 +1223,9 @@ export function createLink(options: LinkOptions): Link {
|
|
|
1132
1223
|
methods() {
|
|
1133
1224
|
return [
|
|
1134
1225
|
handler(remoteLoginMethod, (params) => login(params.server, params.default === true)),
|
|
1226
|
+
handler(remoteLinkMethod, (params) =>
|
|
1227
|
+
linkWithKey(params.server, params.key, params.default === true),
|
|
1228
|
+
),
|
|
1135
1229
|
handler(remoteLoginWaitMethod, async (params) => {
|
|
1136
1230
|
const pending = logins.get(params.loginId);
|
|
1137
1231
|
if (!pending) throw invalid(`No sign-in ${params.loginId} is in progress.`);
|
|
@@ -1175,7 +1269,8 @@ export function createLink(options: LinkOptions): Link {
|
|
|
1175
1269
|
if (connection.pushTimer) clearTimeout(connection.pushTimer);
|
|
1176
1270
|
connections.delete(server);
|
|
1177
1271
|
}
|
|
1178
|
-
|
|
1272
|
+
// An operator's key is the operator's to revoke: signing out only forgets it here.
|
|
1273
|
+
if (credentials && "refreshToken" in credentials) {
|
|
1179
1274
|
try {
|
|
1180
1275
|
await postForm(
|
|
1181
1276
|
server,
|
|
@@ -1328,6 +1423,15 @@ export function createLink(options: LinkOptions): Link {
|
|
|
1328
1423
|
}
|
|
1329
1424
|
return true;
|
|
1330
1425
|
},
|
|
1426
|
+
hostedServers: (artifactId) =>
|
|
1427
|
+
ledger.read((db) =>
|
|
1428
|
+
db
|
|
1429
|
+
.all<{ server: string }>(
|
|
1430
|
+
"SELECT server FROM hosted_artifact WHERE artifact_id = ? AND stopped_at IS NULL AND route_id != '' ORDER BY shared_at",
|
|
1431
|
+
artifactId,
|
|
1432
|
+
)
|
|
1433
|
+
.map((row) => row.server),
|
|
1434
|
+
),
|
|
1331
1435
|
hostedOn: (artifactId) =>
|
|
1332
1436
|
ledger.read(
|
|
1333
1437
|
(db) =>
|
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
* The client end of the home socket, used by a starter that finds another supervisor holding the
|
|
3
3
|
* home (D81) and by tests. SDKs and the CLI implement the same few steps in their own packages.
|
|
4
4
|
*/
|
|
5
|
+
|
|
6
|
+
import { PassThrough } from "node:stream";
|
|
5
7
|
import {
|
|
6
8
|
type ClientInfo,
|
|
7
9
|
createDiagnostic,
|
|
@@ -12,6 +14,7 @@ import {
|
|
|
12
14
|
RpcPeer,
|
|
13
15
|
} from "@mostra/protocol";
|
|
14
16
|
import { ControlConnectError, connectControl } from "../platform/index.ts";
|
|
17
|
+
import type { ProtocolServer } from "./server.ts";
|
|
15
18
|
import { pump, writeLine } from "./streams.ts";
|
|
16
19
|
|
|
17
20
|
/** An open client connection to an instance's socket. */
|
|
@@ -93,3 +96,53 @@ export async function attach(
|
|
|
93
96
|
throw error;
|
|
94
97
|
}
|
|
95
98
|
}
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* Opens a session with a protocol server in this process, over a pair of in-memory streams, so a
|
|
102
|
+
* part of the runtime acts as a client exactly as any host does (invariant 11): the same framing,
|
|
103
|
+
* initialize, validation and session rules. `attributes` are the session's, as a transport sets
|
|
104
|
+
* them (a remote MCP request's account and home). The caller closes the returned client.
|
|
105
|
+
*/
|
|
106
|
+
export async function attachInProcess(
|
|
107
|
+
server: ProtocolServer,
|
|
108
|
+
client: ClientInfo,
|
|
109
|
+
attributes: Readonly<Record<string, unknown>> = {},
|
|
110
|
+
timeoutMs = 5000,
|
|
111
|
+
): Promise<{ client: SocketClient; result: MostraInitializeResult }> {
|
|
112
|
+
const toServer = new PassThrough();
|
|
113
|
+
const toClient = new PassThrough();
|
|
114
|
+
const peer = new RpcPeer({ send: (message) => void writeLine(toServer, message) });
|
|
115
|
+
let markClosed: () => void = () => {};
|
|
116
|
+
const closed = new Promise<void>((done) => {
|
|
117
|
+
markClosed = done;
|
|
118
|
+
});
|
|
119
|
+
server.serve("stdio", toServer, toClient, undefined, attributes);
|
|
120
|
+
pump(
|
|
121
|
+
{ input: toClient, output: toServer },
|
|
122
|
+
() => peer,
|
|
123
|
+
() => {
|
|
124
|
+
peer.close();
|
|
125
|
+
markClosed();
|
|
126
|
+
},
|
|
127
|
+
);
|
|
128
|
+
const connection: SocketClient = {
|
|
129
|
+
peer,
|
|
130
|
+
closed,
|
|
131
|
+
close: () => {
|
|
132
|
+
peer.close();
|
|
133
|
+
toServer.end();
|
|
134
|
+
toClient.end();
|
|
135
|
+
},
|
|
136
|
+
};
|
|
137
|
+
try {
|
|
138
|
+
const result = await peer.call(
|
|
139
|
+
mostraInitializeMethod,
|
|
140
|
+
{ client, revisions: [...HOST_PROTOCOL_REVISIONS], capabilities: {}, ports: [] },
|
|
141
|
+
{ timeoutMs },
|
|
142
|
+
);
|
|
143
|
+
return { client: connection, result };
|
|
144
|
+
} catch (error) {
|
|
145
|
+
connection.close();
|
|
146
|
+
throw error;
|
|
147
|
+
}
|
|
148
|
+
}
|
|
@@ -20,7 +20,7 @@ import {
|
|
|
20
20
|
} from "@mostra/protocol";
|
|
21
21
|
import { handler, type MethodHandler } from "./server.ts";
|
|
22
22
|
|
|
23
|
-
export { attach, type SocketClient } from "./client.ts";
|
|
23
|
+
export { attach, attachInProcess, type SocketClient } from "./client.ts";
|
|
24
24
|
export {
|
|
25
25
|
handler,
|
|
26
26
|
type MethodHandler,
|