@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.
Files changed (245) hide show
  1. package/dist/bin.js +4058 -310
  2. package/dist/bin.js.map +1 -1
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +1 -1
  5. package/dist/{instance-FExcyENK.js → instance-DCiUHvgZ.js} +682 -47
  6. package/dist/instance-DCiUHvgZ.js.map +1 -0
  7. package/dist/reference/cli.md +1322 -0
  8. package/dist/reference/diagnostics.json +1552 -0
  9. package/dist/reference/errors/MOSTRA_A11Y_MINOR.md +23 -0
  10. package/dist/reference/errors/MOSTRA_A11Y_SERIOUS.md +23 -0
  11. package/dist/reference/errors/MOSTRA_ACTION_CANCELLED.md +23 -0
  12. package/dist/reference/errors/MOSTRA_ACTION_EVENT_INVALID.md +23 -0
  13. package/dist/reference/errors/MOSTRA_ACTION_EXPORT_INVALID.md +23 -0
  14. package/dist/reference/errors/MOSTRA_ACTION_INTERRUPTED.md +23 -0
  15. package/dist/reference/errors/MOSTRA_ACTION_PAUSED.md +23 -0
  16. package/dist/reference/errors/MOSTRA_ACTION_RUN_NOT_FOUND.md +23 -0
  17. package/dist/reference/errors/MOSTRA_ACTION_THREW.md +23 -0
  18. package/dist/reference/errors/MOSTRA_ACTION_TOO_LARGE.md +23 -0
  19. package/dist/reference/errors/MOSTRA_ACTION_UNKNOWN_FUNCTION.md +23 -0
  20. package/dist/reference/errors/MOSTRA_ACTION_UNSERIALIZABLE.md +23 -0
  21. package/dist/reference/errors/MOSTRA_ARTIFACT_BUNDLE_INVALID.md +23 -0
  22. package/dist/reference/errors/MOSTRA_ARTIFACT_DIR_NOT_EMPTY.md +23 -0
  23. package/dist/reference/errors/MOSTRA_ARTIFACT_ENTRY_AMBIGUOUS.md +23 -0
  24. package/dist/reference/errors/MOSTRA_ARTIFACT_ID_DROPPED.md +23 -0
  25. package/dist/reference/errors/MOSTRA_ARTIFACT_NOT_FOUND.md +23 -0
  26. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_ENTRY.md +23 -0
  27. package/dist/reference/errors/MOSTRA_ARTIFACT_NO_PAGE.md +23 -0
  28. package/dist/reference/errors/MOSTRA_ARTIFACT_PATCH_REJECTED.md +23 -0
  29. package/dist/reference/errors/MOSTRA_ARTIFACT_PATH_INVALID.md +23 -0
  30. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_MISSING.md +23 -0
  31. package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_UNREADABLE.md +23 -0
  32. package/dist/reference/errors/MOSTRA_ARTIFACT_TEMPLATE_UNKNOWN.md +23 -0
  33. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_COLLECTED.md +23 -0
  34. package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_NOT_FOUND.md +23 -0
  35. package/dist/reference/errors/MOSTRA_BUILD_CRASHED.md +23 -0
  36. package/dist/reference/errors/MOSTRA_BUILD_FAILED.md +23 -0
  37. package/dist/reference/errors/MOSTRA_BUILD_TIMEOUT.md +23 -0
  38. package/dist/reference/errors/MOSTRA_BUILD_UNRESOLVED.md +23 -0
  39. package/dist/reference/errors/MOSTRA_CLI_CONFIG_UNWRITABLE.md +23 -0
  40. package/dist/reference/errors/MOSTRA_CLI_UNKNOWN_COMMAND.md +23 -0
  41. package/dist/reference/errors/MOSTRA_CLI_USAGE.md +23 -0
  42. package/dist/reference/errors/MOSTRA_CONSOLE_ERROR.md +23 -0
  43. package/dist/reference/errors/MOSTRA_CONSOLE_WARNING.md +23 -0
  44. package/dist/reference/errors/MOSTRA_DEP_INSTALL_FAILED.md +23 -0
  45. package/dist/reference/errors/MOSTRA_DEP_MISSING.md +23 -0
  46. package/dist/reference/errors/MOSTRA_DEP_NOT_FOUND.md +23 -0
  47. package/dist/reference/errors/MOSTRA_DEP_OFFLINE.md +23 -0
  48. package/dist/reference/errors/MOSTRA_DEP_SPEC_INVALID.md +23 -0
  49. package/dist/reference/errors/MOSTRA_DEP_TIMEOUT.md +23 -0
  50. package/dist/reference/errors/MOSTRA_DEP_WARM_CONFLICT.md +23 -0
  51. package/dist/reference/errors/MOSTRA_ENV_BIND_FAILED.md +23 -0
  52. package/dist/reference/errors/MOSTRA_ENV_BROWSER_MISSING.md +23 -0
  53. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_DOWNLOAD_FAILED.md +23 -0
  54. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_INVALID.md +23 -0
  55. package/dist/reference/errors/MOSTRA_ENV_BUNDLE_UNAVAILABLE.md +23 -0
  56. package/dist/reference/errors/MOSTRA_ENV_HELPER_MISSING.md +23 -0
  57. package/dist/reference/errors/MOSTRA_ENV_NODE_UNSUPPORTED.md +23 -0
  58. package/dist/reference/errors/MOSTRA_ENV_PORT_TAKEN.md +23 -0
  59. package/dist/reference/errors/MOSTRA_ENV_RUNTIME_INSTALLING.md +23 -0
  60. package/dist/reference/errors/MOSTRA_ENV_RUNTIME_MISSING.md +23 -0
  61. package/dist/reference/errors/MOSTRA_ENV_SERVICE_FAILED.md +23 -0
  62. package/dist/reference/errors/MOSTRA_ENV_SHELL_MISSING.md +23 -0
  63. package/dist/reference/errors/MOSTRA_ENV_WARM_MISSING.md +23 -0
  64. package/dist/reference/errors/MOSTRA_FIELD_CONFLICT.md +23 -0
  65. package/dist/reference/errors/MOSTRA_FIELD_DUPLICATE_ID.md +23 -0
  66. package/dist/reference/errors/MOSTRA_FIELD_ID_INVALID.md +23 -0
  67. package/dist/reference/errors/MOSTRA_FIELD_ID_UNSTABLE.md +23 -0
  68. package/dist/reference/errors/MOSTRA_FIELD_MUTATION_ID_REUSED.md +23 -0
  69. package/dist/reference/errors/MOSTRA_FIELD_SHARED.md +23 -0
  70. package/dist/reference/errors/MOSTRA_FIELD_TOO_LARGE.md +23 -0
  71. package/dist/reference/errors/MOSTRA_FIELD_UNBOUND.md +23 -0
  72. package/dist/reference/errors/MOSTRA_HOME_DISK_FULL.md +23 -0
  73. package/dist/reference/errors/MOSTRA_HOME_GC_INCOMPLETE.md +23 -0
  74. package/dist/reference/errors/MOSTRA_HOME_GONE.md +23 -0
  75. package/dist/reference/errors/MOSTRA_HOME_INTEGRITY.md +23 -0
  76. package/dist/reference/errors/MOSTRA_HOME_LEDGER_UNREADABLE.md +23 -0
  77. package/dist/reference/errors/MOSTRA_HOME_LOCKED.md +23 -0
  78. package/dist/reference/errors/MOSTRA_HOME_MISMATCH.md +23 -0
  79. package/dist/reference/errors/MOSTRA_HOME_NETWORK_FILESYSTEM.md +23 -0
  80. package/dist/reference/errors/MOSTRA_HOME_NOT_ALWAYS_ON.md +23 -0
  81. package/dist/reference/errors/MOSTRA_HOME_NOT_OWNED.md +23 -0
  82. package/dist/reference/errors/MOSTRA_HOME_SOCKET_TOO_LONG.md +23 -0
  83. package/dist/reference/errors/MOSTRA_HOME_TOO_NEW.md +23 -0
  84. package/dist/reference/errors/MOSTRA_HOST_CONNECTION_CLOSED.md +23 -0
  85. package/dist/reference/errors/MOSTRA_HOST_CURSOR_COMPACTED.md +23 -0
  86. package/dist/reference/errors/MOSTRA_HOST_IDENTITY_UNAVAILABLE.md +23 -0
  87. package/dist/reference/errors/MOSTRA_HOST_INITIALIZE_ORDER.md +23 -0
  88. package/dist/reference/errors/MOSTRA_HOST_INTERNAL_ERROR.md +23 -0
  89. package/dist/reference/errors/MOSTRA_HOST_INVALID_PARAMS.md +23 -0
  90. package/dist/reference/errors/MOSTRA_HOST_MALFORMED.md +23 -0
  91. package/dist/reference/errors/MOSTRA_HOST_MESSAGE_TOO_LARGE.md +23 -0
  92. package/dist/reference/errors/MOSTRA_HOST_METHOD_UNKNOWN.md +23 -0
  93. package/dist/reference/errors/MOSTRA_HOST_NOTIFICATION_UNSUPPORTED.md +23 -0
  94. package/dist/reference/errors/MOSTRA_HOST_PORT_UNSUPPORTED.md +23 -0
  95. package/dist/reference/errors/MOSTRA_HOST_REQUEST_ID_REUSED.md +23 -0
  96. package/dist/reference/errors/MOSTRA_HOST_REVISION_UNSUPPORTED.md +23 -0
  97. package/dist/reference/errors/MOSTRA_HOST_SHUTDOWN_REFUSED.md +23 -0
  98. package/dist/reference/errors/MOSTRA_HOST_SUBSCRIPTION_UNKNOWN.md +23 -0
  99. package/dist/reference/errors/MOSTRA_HOST_TIMEOUT.md +23 -0
  100. package/dist/reference/errors/MOSTRA_HYGIENE_CONTENT_TYPE.md +23 -0
  101. package/dist/reference/errors/MOSTRA_HYGIENE_CSRF_MISSING.md +23 -0
  102. package/dist/reference/errors/MOSTRA_HYGIENE_FRAME_SESSION.md +23 -0
  103. package/dist/reference/errors/MOSTRA_HYGIENE_HEADERS_TOO_LARGE.md +23 -0
  104. package/dist/reference/errors/MOSTRA_HYGIENE_HOST_REFUSED.md +23 -0
  105. package/dist/reference/errors/MOSTRA_HYGIENE_NOT_SERVED.md +23 -0
  106. package/dist/reference/errors/MOSTRA_HYGIENE_ORIGIN_REFUSED.md +23 -0
  107. package/dist/reference/errors/MOSTRA_HYGIENE_RATE_LIMITED.md +23 -0
  108. package/dist/reference/errors/MOSTRA_HYGIENE_REQUEST_MALFORMED.md +23 -0
  109. package/dist/reference/errors/MOSTRA_HYGIENE_SCOPE_DENIED.md +23 -0
  110. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_CONFLICT.md +23 -0
  111. package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_MISSING.md +23 -0
  112. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_INVALID.md +23 -0
  113. package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_REVOKED.md +23 -0
  114. package/dist/reference/errors/MOSTRA_LIVE_SOURCE_FAILED.md +23 -0
  115. package/dist/reference/errors/MOSTRA_LIVE_TOO_LARGE.md +23 -0
  116. package/dist/reference/errors/MOSTRA_MANIFEST_INVALID.md +23 -0
  117. package/dist/reference/errors/MOSTRA_MANIFEST_NOT_LITERAL.md +23 -0
  118. package/dist/reference/errors/MOSTRA_MANIFEST_UNKNOWN_KEY.md +23 -0
  119. package/dist/reference/errors/MOSTRA_NETWORK_EXTERNAL_FAILED.md +23 -0
  120. package/dist/reference/errors/MOSTRA_NETWORK_REQUEST_FAILED.md +23 -0
  121. package/dist/reference/errors/MOSTRA_PLATFORM_UNSUPPORTED.md +23 -0
  122. package/dist/reference/errors/MOSTRA_PUBLISH_ID_CONFLICT.md +23 -0
  123. package/dist/reference/errors/MOSTRA_PUBLISH_SOURCE_CHANGED.md +23 -0
  124. package/dist/reference/errors/MOSTRA_PUBLISH_VERIFY_FAILED.md +23 -0
  125. package/dist/reference/errors/MOSTRA_REGRESSION_ACTION_REMOVED.md +23 -0
  126. package/dist/reference/errors/MOSTRA_REGRESSION_ARIA.md +23 -0
  127. package/dist/reference/errors/MOSTRA_REGRESSION_FIELD_REMOVED.md +23 -0
  128. package/dist/reference/errors/MOSTRA_REGRESSION_LIVE_REMOVED.md +23 -0
  129. package/dist/reference/errors/MOSTRA_REGRESSION_PAGE_REMOVED.md +23 -0
  130. package/dist/reference/errors/MOSTRA_REGRESSION_PIXELS.md +23 -0
  131. package/dist/reference/errors/MOSTRA_REMOTE_CONFIG_INVALID.md +23 -0
  132. package/dist/reference/errors/MOSTRA_REMOTE_HOME_MOVING.md +23 -0
  133. package/dist/reference/errors/MOSTRA_REMOTE_HOME_SUSPENDED.md +23 -0
  134. package/dist/reference/errors/MOSTRA_REMOTE_LIMIT_REACHED.md +23 -0
  135. package/dist/reference/errors/MOSTRA_REMOTE_LOGIN_FAILED.md +23 -0
  136. package/dist/reference/errors/MOSTRA_REMOTE_NOT_OWNER_INSTANCE.md +23 -0
  137. package/dist/reference/errors/MOSTRA_REMOTE_NO_INSTANCE.md +23 -0
  138. package/dist/reference/errors/MOSTRA_REMOTE_OPERATOR_UNAVAILABLE.md +23 -0
  139. package/dist/reference/errors/MOSTRA_REMOTE_OWNER_OFFLINE.md +23 -0
  140. package/dist/reference/errors/MOSTRA_REMOTE_PAUSED_BY_OPERATOR.md +23 -0
  141. package/dist/reference/errors/MOSTRA_REMOTE_QUEUE_FULL.md +23 -0
  142. package/dist/reference/errors/MOSTRA_REMOTE_RATE_LIMITED.md +23 -0
  143. package/dist/reference/errors/MOSTRA_REMOTE_SIGN_IN_REQUIRED.md +23 -0
  144. package/dist/reference/errors/MOSTRA_REMOTE_UNDER_REVIEW.md +23 -0
  145. package/dist/reference/errors/MOSTRA_REMOTE_UNREACHABLE.md +23 -0
  146. package/dist/reference/errors/MOSTRA_RUNTIME_BLANK.md +23 -0
  147. package/dist/reference/errors/MOSTRA_RUNTIME_NOT_READY.md +23 -0
  148. package/dist/reference/errors/MOSTRA_RUNTIME_PAGE_ERROR.md +23 -0
  149. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_CRASHED.md +23 -0
  150. package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_PARKED.md +23 -0
  151. package/dist/reference/errors/MOSTRA_SECRET_MISSING.md +23 -0
  152. package/dist/reference/errors/MOSTRA_SHARE_NOT_ENABLED.md +23 -0
  153. package/dist/reference/errors/MOSTRA_SHARE_NOT_FOUND.md +23 -0
  154. package/dist/reference/errors/MOSTRA_SHARE_PORTS_EXHAUSTED.md +23 -0
  155. package/dist/reference/errors/MOSTRA_SHARE_TOOL_MISSING.md +23 -0
  156. package/dist/reference/errors/MOSTRA_SHARE_TOOL_NOT_READY.md +23 -0
  157. package/dist/reference/errors/MOSTRA_SHARE_TTL_INVALID.md +23 -0
  158. package/dist/reference/errors/MOSTRA_SHARE_TUNNEL_FAILED.md +23 -0
  159. package/dist/reference/errors/MOSTRA_SMOKE_BUDGET.md +23 -0
  160. package/dist/reference/errors/MOSTRA_SMOKE_NO_EFFECT.md +23 -0
  161. package/dist/reference/errors/MOSTRA_SUBMIT_ALREADY.md +23 -0
  162. package/dist/reference/errors/MOSTRA_SUBMIT_BLOCKED.md +23 -0
  163. package/dist/reference/errors/MOSTRA_SUBMIT_CHANNEL_DENIED.md +23 -0
  164. package/dist/reference/errors/MOSTRA_SUBMIT_NOT_FOUND.md +23 -0
  165. package/dist/reference/errors/MOSTRA_SUBMIT_PAUSED.md +23 -0
  166. package/dist/reference/errors/MOSTRA_SUBMIT_POLICY_NONE.md +23 -0
  167. package/dist/reference/errors/MOSTRA_SUBMIT_REVISION_MOVED.md +23 -0
  168. package/dist/reference/errors/MOSTRA_SUBMIT_SIGNAL_INVALID.md +23 -0
  169. package/dist/reference/errors/MOSTRA_SUBMIT_VIEW_INVALID.md +23 -0
  170. package/dist/reference/errors/MOSTRA_TARGET_UNAVAILABLE.md +23 -0
  171. package/dist/reference/errors/MOSTRA_TYPE_ERROR.md +23 -0
  172. package/dist/reference/errors/MOSTRA_TYPE_UNTYPED_PACKAGE.md +23 -0
  173. package/dist/reference/errors/MOSTRA_VERIFY_ACTION_SKIPPED.md +23 -0
  174. package/dist/reference/errors/MOSTRA_VERIFY_BASELINE_MISSING.md +23 -0
  175. package/dist/reference/errors/MOSTRA_VERIFY_CRASHED.md +23 -0
  176. package/dist/reference/errors/MOSTRA_VERIFY_LIVE_FAILED.md +23 -0
  177. package/dist/reference/errors/MOSTRA_VERIFY_NO_BASELINE.md +23 -0
  178. package/dist/reference/errors/MOSTRA_VERIFY_SECRET_MISSING.md +23 -0
  179. package/dist/reference/errors/MOSTRA_VERIFY_SKIP_CONSEQUENCE.md +23 -0
  180. package/dist/reference/errors/MOSTRA_VERIFY_TIMEOUT.md +23 -0
  181. package/dist/reference/self-hosting.md +130 -0
  182. package/dist/reference/telemetry.md +84 -0
  183. package/dist/skill/SKILL.md +122 -0
  184. package/dist/skill/assets/examples/dashboard/index.tsx +161 -0
  185. package/dist/skill/assets/examples/dashboard/live.ts +25 -0
  186. package/dist/skill/assets/examples/dashboard/styles.css +125 -0
  187. package/dist/skill/assets/examples/decision/index.tsx +95 -0
  188. package/dist/skill/assets/examples/decision/styles.css +125 -0
  189. package/dist/skill/assets/examples/inbox/actions.ts +23 -0
  190. package/dist/skill/assets/examples/inbox/index.tsx +109 -0
  191. package/dist/skill/assets/examples/inbox/styles.css +125 -0
  192. package/dist/skill/assets/studio.css +125 -0
  193. package/dist/skill/references/answers.md +217 -0
  194. package/dist/skill/references/design.md +154 -0
  195. package/dist/skill/references/libraries.md +167 -0
  196. package/dist/skill/references/long-lived.md +148 -0
  197. package/dist/skill/references/mcp.md +68 -0
  198. package/dist/skill/references/page.md +131 -0
  199. package/dist/skill/references/server.md +146 -0
  200. package/dist/skill/references/sharing.md +123 -0
  201. package/dist/skill/references/verify.md +71 -0
  202. package/package.json +10 -5
  203. package/src/gateway/actions.ts +20 -0
  204. package/src/gateway/browser.ts +44 -0
  205. package/src/gateway/capabilities.ts +8 -0
  206. package/src/gateway/http.ts +12 -1
  207. package/src/gateway/index.ts +170 -5
  208. package/src/gateway/listener.ts +31 -6
  209. package/src/gateway/routes.ts +8 -0
  210. package/src/gc/index.ts +5 -0
  211. package/src/instance/index.ts +20 -1
  212. package/src/interaction/index.ts +60 -0
  213. package/src/interaction/pause.ts +106 -0
  214. package/src/interaction/submissions.ts +42 -1
  215. package/src/interaction/viewers.ts +34 -1
  216. package/src/ledger/index.ts +20 -1
  217. package/src/ledger/migrations.ts +51 -0
  218. package/src/link/author.ts +215 -0
  219. package/src/link/hosted.ts +37 -1
  220. package/src/link/http.ts +6 -1
  221. package/src/link/index.ts +3 -1
  222. package/src/link/manager.ts +138 -34
  223. package/src/protocol-server/client.ts +53 -0
  224. package/src/protocol-server/index.ts +1 -1
  225. package/src/server/api.ts +514 -72
  226. package/src/server/auth.ts +600 -74
  227. package/src/server/authorize.ts +816 -0
  228. package/src/server/clients.ts +235 -0
  229. package/src/server/config.ts +7 -0
  230. package/src/server/data.ts +59 -1
  231. package/src/server/directory.ts +69 -0
  232. package/src/server/feed.ts +191 -0
  233. package/src/server/handle.ts +172 -0
  234. package/src/server/hosted-pages.ts +532 -0
  235. package/src/server/hosted.ts +519 -18
  236. package/src/server/index.ts +343 -61
  237. package/src/server/mcp.ts +330 -0
  238. package/src/server/metering.ts +156 -0
  239. package/src/server/oauth-clients.ts +510 -0
  240. package/src/server/operator.ts +498 -0
  241. package/src/server/providers.ts +284 -0
  242. package/src/server/remove.ts +148 -0
  243. package/src/server/routing.ts +275 -0
  244. package/src/verify/runner.ts +23 -2
  245. package/dist/instance-FExcyENK.js.map +0 -1
@@ -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
- interface Credentials {
130
- readonly server: string;
131
- readonly refreshToken: string;
132
- readonly instanceId: string;
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
- if (parsed.server !== server || typeof parsed.refreshToken !== "string") return undefined;
276
- options.protect(parsed.refreshToken);
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.refreshToken);
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
- ledger.write((db) =>
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
- if (credentials) {
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,