The best way to control Claude Code, Codex and more from any computer or phone
fix(devices): rename EAS Simulator to Expo Simulators (#36951)
Hirbod committed
Nov 14, 2026 at 22:38 UTC
88c42f471b0ccebb9d404e334b2179664fc22239
32 files changed
+104
-102
apps/server/graphql.config.ts
+1
-1
@@ -1,7 +1,7 @@
1
import { defineConfig } from "@effect/graphql-generator/Config";
2
3
// `schema/expo.graphql` is api.expo.dev's schema, read by introspection
4
-// (`vp run generate:expo-schema`). The EAS Simulator operations are the ones
4
+// (`vp run generate:expo-schema`). The Expo Simulators operations are the ones
5
// eas-cli's `simulator:*` commands send; Expo does not document them.
6
export default defineConfig({
7
schema: "./schema/expo.graphql",
apps/server/src/device/DeviceHost.ts
+1
-1
@@ -139,7 +139,7 @@ export interface DeviceOperations {
139
deviceId: string,
140
) => Effect.Effect<AgentDeviceBinding, DeviceHostUnavailableError>;
141
/**
142
- * Set by hosts that end devices on their own (EAS stops sessions at their
142
+ * Set by hosts that end devices on their own (Expo stops sessions at their
143
* limits), so a session on a device the host stops listing is dropped.
144
*/
145
readonly endsDevices?: boolean;
apps/server/src/device/DeviceHubProxy.ts
+1
-1
@@ -155,7 +155,7 @@ const proxyHttp = Effect.fn("DeviceHubProxy.proxyHttp")(function* (
155
const response = yield* httpClient.execute(upstreamRequest);
156
const headers: Record<string, string> = {};
157
for (const [name, value] of Object.entries(response.headers)) {
158
- // A cookie from an upstream such as an EAS session's preview host would land on T3's origin.
158
+ // A cookie from an upstream such as an Expo Simulators session's preview host would land on T3's origin.
159
if (
160
name === "content-encoding" ||
161
name === "transfer-encoding" ||
apps/server/src/device/DeviceService.test.ts
+1
-1
@@ -347,7 +347,7 @@ const fixture = Effect.fn("fixture")(function* (
347
}),
348
),
349
);
350
- // The host ending a device on its own, as EAS does at a session's limits.
350
+ // The host ending a device on its own, as Expo does at a session's limits.
351
const endDevice = () => {
352
booted = false;
353
};
apps/server/src/device/DeviceService.ts
+3
-3
@@ -163,7 +163,7 @@ export class DeviceService extends Context.Service<
163
readonly testHost: (
164
config: SshDeviceHostConfig,
165
) => Effect.Effect<DeviceHostSummary, DeviceError>;
166
- /** Who an Expo credential signs in as and which EAS projects it can run sessions under. */
166
+ /** Who an Expo credential signs in as and which Expo projects it can run sessions under. */
167
readonly easAccount: (
168
input: DeviceEasAccountInput,
169
) => Effect.Effect<DeviceEasAccount, DeviceEasAccountError>;
@@ -598,7 +598,7 @@ export const makeWithHosts = Effect.fn("DeviceService.makeWithHosts")(function*
598
),
599
...devices.filter((device) => !incompletePlatforms.includes(device.platform)),
600
],
601
- // A host that ends devices itself (EAS stops sessions at their limits)
601
+ // A host that ends devices itself (Expo stops sessions at their limits)
602
// leaves sessions on devices it no longer lists with nothing to stream.
603
// Other hosts can miss a device for one listing, so theirs stay.
604
sessions: ready.devices.endsDevices
@@ -1127,7 +1127,7 @@ export const makeWithHosts = Effect.fn("DeviceService.makeWithHosts")(function*
1127
easAccount: Effect.fn("DeviceService.easAccount")(function () {
1128
return Effect.fail(
1129
new DeviceEasAccountError({
1130
- reason: "EAS accounts are unavailable in this device service.",
1130
+ reason: "Expo accounts are unavailable in this device service.",
1131
}),
1132
);
1133
}),
apps/server/src/device/EasDeviceHost.test.ts
+6
-6
@@ -26,7 +26,7 @@ const APP_ID = "d763fcb8-d37c-41ea-a773-b54a0ab4a454";
26
const config = (overrides: Partial<EasDeviceHostConfig> = {}): EasDeviceHostConfig => ({
27
kind: "eas",
28
id: "eas",
29
- label: "EAS Simulator",
29
+ label: "Expo Simulators",
30
appId: APP_ID,
31
accessToken: "expo-token",
32
maxSessionMinutes: 25,
@@ -174,7 +174,7 @@ const fakeExpo = (
174
node: {
175
id: "someone-else",
176
status: "IN_PROGRESS",
177
- name: "T3 Code · EAS Simulator · 000000",
177
+ name: "T3 Code · Expo Simulators · 000000",
178
},
179
},
180
...(options.active ?? []).map((node) => ({ node })),
@@ -260,7 +260,7 @@ const makeHost = (
260
Effect.provideService(Scope.Scope, scope),
261
);
262
263
-describe("EAS Simulator host", () => {
263
+describe("Expo Simulators host", () => {
264
it.effect("starts a bounded session and routes its stream and agent to that session", () =>
265
Effect.gen(function* () {
266
const expo = fakeExpo();
@@ -433,13 +433,13 @@ describe("EAS Simulator host", () => {
433
yield* ready.devices.boot(catalogDevice!);
434
const refused = yield* ready.devices.boot(catalogDevice!).pipe(Effect.flip);
435
expect(refused.message).toBe(
436
- "EAS Simulator is unavailable: EAS Simulator is limited to 1 running session. Close one in the Device panel first.",
436
+ "Expo Simulators is unavailable: Expo Simulators is limited to 1 running session. Close one in the Device panel first.",
437
);
438
expect(expo.named("T3CreateEasSimulatorSession")).toHaveLength(1);
439
}).pipe(Effect.scoped, Effect.provide(layer)),
440
);
441
442
- it.effect("tells concurrent sessions apart although EAS gives each the same UDID", () =>
442
+ it.effect("tells concurrent sessions apart although Expo gives each the same UDID", () =>
443
Effect.gen(function* () {
444
const expo = fakeExpo();
445
const scope = yield* Scope.make();
@@ -610,7 +610,7 @@ describe("EAS Simulator host", () => {
610
}).pipe(Effect.scoped, Effect.provide(layer)),
611
);
612
613
- it.effect("asks for an EAS project before starting anything when none can be found", () =>
613
+ it.effect("asks for an Expo project before starting anything when none can be found", () =>
614
Effect.gen(function* () {
615
const expo = fakeExpo();
616
const host = yield* makeHost(expo, config({ appId: undefined }), yield* Scope.make());
apps/server/src/device/EasDeviceHost.ts
+22
-20
@@ -1,5 +1,5 @@
1
/**
2
- * Cloud simulators from EAS Simulator. A device exists only while a session
2
+ * Cloud simulators from Expo Simulators. A device exists only while a session
3
* runs, and every session bills the Expo account until it stops, so this host
4
* bounds each one, stops all of them when it stops, and stops sessions a
5
* previous server left behind. It never touches sessions it did not start.
@@ -59,14 +59,14 @@ const decodeServeEmuApi = Schema.decodeUnknownEffect(
59
*/
60
const PLATFORMS = {
61
ios: {
62
- name: "iPhone (EAS Simulator)",
62
+ name: "iPhone (Expo Simulator)",
63
hubPrefix: "/vendor/serve-sim",
64
previewPrefix: "",
65
protocol: "serve-sim",
66
remoteDeviceId: (api: unknown) => decodeServeSimApi(api).pipe(Effect.map((api) => api.device)),
67
},
68
android: {
69
- name: "Android (EAS Simulator)",
69
+ name: "Android (Expo Simulator)",
70
hubPrefix: "/vendor/serve-emu",
71
previewPrefix: "/vendor/serve-emu",
72
protocol: "serve-emu",
@@ -74,7 +74,7 @@ const PLATFORMS = {
74
},
75
} as const;
76
77
-/** EAS picks the simulator model; one entry starts a session. */
77
+/** Expo picks the simulator model; one entry starts a session. */
78
const CATALOG: ReadonlyArray<DeviceHost.HostDevice> = [
79
{
80
id: "eas-ios",
@@ -163,7 +163,7 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
163
>();
164
const hostId = config.id;
165
const ledgerPath = path.join(server.stateDir, "device", "eas", `${hostId}.json`);
166
- // Keyed by Expo's session id, which is also the device id: every EAS
166
+ // Keyed by Expo's session id, which is also the device id: every Expo
167
// simulator reports the same remote device id, so that id cannot tell sessions apart.
168
const sessions = new Map<string, RunningSession>();
169
const checkedAt = new Map<string, number>();
@@ -239,7 +239,7 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
239
Effect.flatMap(decodeLedger),
240
Effect.mapError((cause) =>
241
unavailable(
242
- `The record of running EAS sessions at ${ledgerPath} could not be read. Fix or remove it.`,
242
+ `The record of running Expo Simulators sessions at ${ledgerPath} could not be read. Fix or remove it.`,
243
cause,
244
),
245
),
@@ -256,7 +256,7 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
256
Effect.provide(services),
257
Effect.mapError((cause) =>
258
unavailable(
259
- `The record of running EAS sessions at ${ledgerPath} could not be written.`,
259
+ `The record of running Expo Simulators sessions at ${ledgerPath} could not be written.`,
260
cause,
261
),
262
),
@@ -267,13 +267,13 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
267
entries.map((entry) => (entry.name === name ? { ...entry, refused: true } : entry)),
268
).pipe(
269
Effect.catch((cause) =>
270
- Effect.logWarning("Could not update the EAS session record", { name, cause }),
270
+ Effect.logWarning("Could not update the Expo Simulators session record", { name, cause }),
271
),
272
);
273
const forgetEntry = (name: string) =>
274
writeLedger((entries) => entries.filter((entry) => entry.name !== name)).pipe(
275
Effect.catch((cause) =>
276
- Effect.logWarning("Could not update the EAS session record", { name, cause }),
276
+ Effect.logWarning("Could not update the Expo Simulators session record", { name, cause }),
277
),
278
);
279
@@ -282,7 +282,7 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
282
expo.stop(sessionId).pipe(
283
Effect.andThen(forgetEntry(name)),
284
Effect.tapError((cause) =>
285
- Effect.logWarning("Could not stop EAS Simulator session", { sessionId, cause }),
285
+ Effect.logWarning("Could not stop Expo Simulators session", { sessionId, cause }),
286
),
287
);
288
@@ -403,7 +403,7 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
403
},
404
reapLock.withPermit,
405
Effect.catch((cause) =>
406
- Effect.logWarning("Could not stop recorded EAS Simulator sessions", { cause }),
406
+ Effect.logWarning("Could not stop recorded Expo Simulators sessions", { cause }),
407
),
408
);
409
@@ -439,7 +439,9 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
439
hostId,
440
deviceId: sessionId,
441
reason: "launch_failed",
442
- cause: new Error(`EAS Simulator session ended (${session.status}) before it was ready`),
442
+ cause: new Error(
443
+ `Expo Simulators session ended (${session.status}) before it was ready`,
444
+ ),
445
});
446
}
447
if (session.status === "IN_PROGRESS" && session.endpoints) return session.endpoints;
@@ -456,7 +458,7 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
458
hostId,
459
deviceId: sessionId,
460
reason: "timeout",
459
- cause: new Error("EAS Simulator session did not start in time"),
461
+ cause: new Error("Expo Simulators session did not start in time"),
462
}),
463
),
464
}),
@@ -504,7 +506,7 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
506
);
507
if (!appId) {
508
return yield* unavailable(
507
- "No EAS project to run the session under. Choose one for this host in Settings, or open the device from a thread whose project names extra.eas.projectId in app.json or its app config.",
509
+ "No Expo project to run the session under. Choose one for this host in Settings, or open the device from a thread whose project names extra.eas.projectId in app.json or its app config.",
510
);
511
}
512
const access = yield* expo
@@ -512,7 +514,7 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
514
.pipe(Effect.mapError((error) => unavailable(error.message, error)));
515
if (!access.available) {
516
return yield* unavailable(
515
- `EAS Simulator is not enabled for the ${access.account} Expo account.`,
517
+ `Expo Simulators is not enabled for the ${access.account} Expo account.`,
518
);
519
}
520
const entry = { name, appId, recordedAt: yield* Clock.currentTimeMillis };
@@ -593,7 +595,7 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
595
hostId,
596
deviceId: sessionId,
597
reason: "launch_failed",
596
- cause: new Error("EAS Simulator returned no preview endpoint"),
598
+ cause: new Error("Expo Simulators returned no preview endpoint"),
599
});
600
}
601
const origin = new URL(endpoints.preview.url).origin;
@@ -767,7 +769,7 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
769
new DeviceOperationError({
770
operation: "screenshot",
771
reason: "request_failed",
770
- cause: new Error("The EAS Simulator session is not running"),
772
+ cause: new Error("The Expo Simulator is not running"),
773
}),
774
),
775
onSome: (session) =>
@@ -795,7 +797,7 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
797
}),
798
agentEndpoint: (deviceId) =>
799
Option.match(sessionFor(deviceId), {
798
- onNone: () => Effect.fail(unavailable("This EAS Simulator device is no longer running.")),
800
+ onNone: () => Effect.fail(unavailable("This Expo Simulator is no longer running.")),
801
onSome: (session) =>
802
Effect.succeed({ ...session.agent, agentDeviceId: session.remoteDeviceId }),
803
}),
@@ -858,11 +860,11 @@ export const make = Effect.fn("EasDeviceHost.make")(function* (config: EasDevice
860
onNone: () => Effect.void,
861
onSome: (running) => releaseAgentDeviceSession(http, running.agent)(session),
862
}),
861
- // Device settings run simctl on the simulator's own machine, which EAS does not expose.
863
+ // Device settings run simctl on the simulator's own machine, which Expo does not expose.
864
run: () =>
865
Effect.succeed({
866
stdout: "",
865
- stderr: "EAS Simulator devices cannot run host commands.",
867
+ stderr: "Devices from Expo Simulators cannot run host commands.",
868
code: 127,
869
}),
870
helpers: { serveSimAxSettings: null, serveSimCli: null },
apps/server/src/device/ExpoApi.test.ts
+1
-1
@@ -154,7 +154,7 @@ describe("Expo API", () => {
154
.availability("app-1")
155
.pipe(Effect.flip);
156
expect(graphQl.message).toBe(
157
- "Expo could not check EAS Simulator access: Feature not enabled",
157
+ "Expo could not check Expo Simulators access: Feature not enabled",
158
);
159
const rejected = yield* makeExpoApi(respond(new Response("no", { status: 401 })), credential)
160
.stop("session-1")
apps/server/src/device/ExpoApi.ts
+2
-2
@@ -1,5 +1,5 @@
1
/**
2
- * Expo's GraphQL API for EAS Simulator sessions. The operations in
2
+ * Expo's GraphQL API for Expo Simulators sessions. The operations in
3
* `ExpoApi.graphql` are the ones eas-cli's `simulator:*` commands send; their
4
* client is generated from `schema/expo.graphql` (`vp run generate`).
5
*/
@@ -313,7 +313,7 @@ export const makeExpoApi = (http: HttpClient.HttpClient, credential: ExpoCredent
313
),
314
),
315
availability: (appId: string) =>
316
- call("check EAS Simulator access", (expo) =>
316
+ call("check Expo Simulators access", (expo) =>
317
expo.T3EasSimulatorAvailability({ appId, filter: [DEVICE_RUN_SESSIONS_GATE] }),
318
).pipe(
319
Effect.map(({ app }) => {
apps/server/src/device/easProjectId.test.ts
+1
-1
@@ -246,7 +246,7 @@ it.effect("gives no answer when an app's config is there but cannot be read", ()
246
}).pipe(Effect.scoped, Effect.provide(layer)),
247
);
248
249
-it.effect("does not guess between apps that name different EAS projects", () =>
249
+it.effect("does not guess between apps that name different Expo projects", () =>
250
Effect.gen(function* () {
251
const root = yield* workspace({
252
"apps/one/app.json": JSON.stringify({ expo: { extra: { eas: { projectId: ID_A } } } }),
apps/server/src/device/easProjectId.ts
+2
-2
@@ -33,7 +33,7 @@ const SPREAD_LATER = /\.\.\./;
33
// Space, a comment, or an opening parenthesis: what may sit between `...`
34
// and the thing spread. Sticky, so the scan moves through the file once.
35
const SPREAD_FILLER = /(?:\s+|\/\/[^\n\r\u2028\u2029]*|\/\*(?:[^*]|\*(?!\/))*\*\/|\()/y;
36
-// `config`'s `extra` and `extra.eas` entries, the holders of the EAS id
36
+// `config`'s `extra` and `extra.eas` entries, the holders of the Expo project id
37
// (dotted, optional-chained or in brackets).
38
const EXTRA_OF_CONFIG = String.raw`config(?:\s*\??\.\s*extra|\s*(?:\?\.)?\s*\[\s*["'\x60]extra["'\x60]\s*\])`;
39
const EAS_OF_CONFIG =
@@ -197,7 +197,7 @@ const projectIdsOf = Effect.fn("easProjectId.projectIdsOf")(function* (dir: stri
197
});
198
199
/**
200
- * The EAS project of a workspace's Expo app: its root, or one app below
200
+ * The Expo project of a workspace's Expo app: its root, or one app below
201
* `apps/` or `packages/`. None when there is none, a config is ambiguous, or
202
* the apps disagree, so the caller asks for an explicit choice instead of
203
* billing the wrong project.
apps/server/src/device/localSshDeviceHost.test.ts
+1
-1
@@ -83,7 +83,7 @@ it.effect("removes only self targets from a fanned-out host list", () =>
83
const eas = {
84
kind: "eas" as const,
85
id: "eas",
86
- label: "EAS Simulator",
86
+ label: "Expo Simulators",
87
accessToken: "",
88
maxSessionMinutes: 30,
89
idleMinutes: 10,
apps/server/src/mcp/McpDeviceToolkit.test.ts
+1
-1
@@ -135,7 +135,7 @@ const layerDeviceServiceMock = Layer.mock(DeviceService.DeviceService)({
135
screenshot: () => Effect.succeed({ device, png }),
136
close: () => Effect.void,
137
testHost: () => Effect.die("not used"),
138
- // As for an EAS device, agent-device knows the device by a different id than T3.
138
+ // As for an Expo device, agent-device knows the device by a different id than T3.
139
agentTarget: () =>
140
Effect.succeed({
141
agentDeviceId: "SIM-UDID",
apps/server/src/mcp/toolkits/device/handlers.ts
+2
-2
@@ -49,7 +49,7 @@ export function agentDeviceQuickStart(
49
.filter(Boolean)
50
.join(" ")
51
: host?.kind === "eas"
52
- ? "This is an EAS Simulator session in the cloud. It bills the Expo account per minute until it stops, so call device_close with shutdown: true when you are done. It starts with no apps installed: install-from-source <url> installs a build from a URL (iOS needs a .tar.gz containing a .app), and install uploads one from this machine."
52
+ ? "This is an Expo Simulators session in the cloud. It bills the Expo account per minute until it stops, so call device_close with shutdown: true when you are done. It starts with no apps installed: install-from-source <url> installs a build from a URL (iOS needs a .tar.gz containing a .app), and install uploads one from this machine."
53
: device.platform === "ios"
54
? "First use builds an XCTest runner and can take a couple of minutes; later commands are fast."
55
: "The Android snapshot helper installs itself on first use.";
@@ -275,7 +275,7 @@ const handlers = {
275
after.devices.find(
276
(candidate) => candidate.hostId === session.hostId && candidate.id === session.deviceId,
277
) ?? target;
278
- // Target the opened device: an EAS device and its agent-device daemon
278
+ // Target the opened device: an Expo device and its agent-device daemon
279
// exist only once its session runs, and Android ids change on boot.
280
const opened = {
281
threadId: scope.thread.threadId,
apps/server/src/mcp/toolkits/device/tools.ts
+1
-1
@@ -58,7 +58,7 @@ const DeviceOpenTool = Tool.make("device_open", {
58
FileSystem.FileSystem,
59
Path.Path,
60
ServerConfig.ServerConfig,
61
- // The thread's project can name the EAS project a cloud device runs under.
61
+ // The thread's project can name the Expo project a cloud device runs under.
62
ProjectService.ProjectService,
63
],
64
})
apps/server/src/serverSettings.test.ts
+3
-3
@@ -1469,7 +1469,7 @@ it.layer(Layer.mergeAll(NodeServices.layer, NodeCrypto.layer))("server settings"
1469
{
1470
kind: "eas",
1471
id: "eas",
1472
- label: "EAS Simulator",
1472
+ label: "Expo Simulators",
1473
accessToken: "expo-secret",
1474
maxSessionMinutes: 30,
1475
idleMinutes: 10,
@@ -1786,7 +1786,7 @@ it.layer(Layer.mergeAll(NodeServices.layer, NodeCrypto.layer))("server settings"
1786
{
1787
kind: "eas",
1788
id: "eas",
1789
- label: "EAS Simulator",
1789
+ label: "Expo Simulators",
1790
accessToken: easReference,
1791
maxSessionMinutes: 30,
1792
idleMinutes: 10,
@@ -1906,7 +1906,7 @@ it.layer(Layer.mergeAll(NodeServices.layer, NodeCrypto.layer))("server settings"
1906
{
1907
kind: "eas",
1908
id: "eas",
1909
- label: "EAS Simulator",
1909
+ label: "Expo Simulators",
1910
accessToken: personal("Expo/token"),
1911
maxSessionMinutes: 30,
1912
idleMinutes: 10,
apps/server/src/settingsSecrets.ts
+1
-1
@@ -235,7 +235,7 @@ function mapSecretFieldGroups(
235
) as EasDeviceHostConfig,
236
);
237
238
- // Its own prefix: an EAS and a Simlock host may share an id.
238
+ // Its own prefix: an Expo and a Simlock host may share an id.
239
const simlockDeviceHosts = settings.simlockDeviceHosts.map(
240
(host) =>
241
mapFields(
apps/web/src/components/device/DeviceSetup.tsx
+1
-1
@@ -138,7 +138,7 @@ export function platformSetupStatus(state: DeviceServiceState, platform: DeviceP
138
ready: true,
139
message:
140
remoteHost?.kind === "eas"
141
- ? `${remoteHost.label} starts ${platform === "ios" ? "iOS Simulators" : "Android emulators"} in the cloud with EAS Simulator.`
141
+ ? `${remoteHost.label} starts ${platform === "ios" ? "iOS Simulators" : "Android emulators"} in the cloud with Expo Simulators.`
142
: platform === "ios"
143
? `Xcode and iOS Simulator are available${location}.`
144
: `The Android SDK and Emulator are available${location}.`,
apps/web/src/components/device/DeviceWorkspace.tsx
+1
-1
@@ -33,7 +33,7 @@ export function DeviceWorkspace(props: {
33
// A capture always finishes, even if the panel hides or closes meanwhile; the user asked for it.
34
const capturing = useRef(false);
35
const access = useDeviceHubAccess(props.environmentId, props.device.hostId);
36
- // Settings and tools run commands on the device's own machine, which EAS and Simlock do not expose.
36
+ // Settings and tools run commands on the device's own machine, which Expo and Simlock do not expose.
37
const runsHostCommands = props.hostKind === "local" || props.hostKind === "ssh";
38
const controls = useDeviceControls({
39
...props,
apps/web/src/components/settings/DeviceSourcesSettings.tsx
+4
-4
@@ -84,7 +84,7 @@ interface SourceRow {
84
readonly description: ReactNode;
85
readonly environments: ReadonlyArray<SourceEnvironment>;
86
/**
87
- * One machine or account every environment reaches the same way (an SSH host, EAS, a Simlock
87
+ * One machine or account every environment reaches the same way (an SSH host, Expo, a Simlock
88
* pool), so its platforms are the same for all of them. Local simulators differ per machine.
89
*/
90
readonly shared: boolean;
@@ -262,7 +262,7 @@ export function DeviceSourcesSettings(props: {
262
),
263
},
264
})),
265
- remove ? "EAS host not removed everywhere" : "EAS host not saved everywhere",
265
+ remove ? "Expo host not removed everywhere" : "Expo host not saved everywhere",
266
);
267
if (saved) setEditing(null);
268
};
@@ -460,7 +460,7 @@ export function DeviceSourcesSettings(props: {
460
key: `eas:${host.id}`,
461
shared: true,
462
title: host.label,
463
- kind: "EAS",
463
+ kind: "Expo",
464
description: easSessionLimits(host),
465
environments: active.map((member) => {
466
const added = (member.settings?.easDeviceHosts ?? []).some(
@@ -551,7 +551,7 @@ export function DeviceSourcesSettings(props: {
551
})
552
}
553
>
554
- EAS Simulator
554
+ Expo Simulators
555
</MenuItem>
556
) : null}
557
{props.supportsSimlock && simlockEnabled ? (
apps/web/src/components/settings/EasDeviceHostEditor.tsx
+6
-6
@@ -174,7 +174,7 @@ export function EasDeviceHostEditor(props: {
174
}}
175
>
176
<DialogHeader>
177
- <DialogTitle>{props.isNew ? "Add EAS host" : "Edit EAS host"}</DialogTitle>
177
+ <DialogTitle>{props.isNew ? "Add Expo host" : "Edit Expo host"}</DialogTitle>
178
<DialogDescription>
179
The environment's server signs in to Expo and starts the sessions. Without a token
180
here it uses EXPO_TOKEN, then its eas login.
@@ -277,7 +277,7 @@ export function EasDeviceHostEditor(props: {
277
</Button>
278
</div>
279
<div className="space-y-1.5 text-sm">
280
- <span>EAS project</span>
280
+ <span>Expo project</span>
281
<Select
282
value={draft.appId ?? FROM_THREAD_PROJECT}
283
disabled={props.busy}
@@ -289,7 +289,7 @@ export function EasDeviceHostEditor(props: {
289
});
290
}}
291
>
292
- <SelectTrigger size="sm" aria-label="EAS project">
292
+ <SelectTrigger size="sm" aria-label="Expo project">
293
<SelectValue>
294
{(value: string) =>
295
value === FROM_THREAD_PROJECT
@@ -321,10 +321,10 @@ export function EasDeviceHostEditor(props: {
321
{limit("idleMinutes", "Idle minutes", 60)}
322
</div>
323
<p className="text-xs text-muted-foreground">
324
- Expo allows sessions of up to 40 minutes on free accounts and 115 on paid ones, and
325
- ends one after the idle minutes without activity, so idle minutes must be smaller than
324
+ Expo Simulators needs a paid Expo account. A session runs for up to 115 minutes and
325
+ stops early when it is idle for the idle minutes, so idle minutes must be less than
326
session minutes.
327
- {props.isNew ? null : " Saving restarts this host, which stops its running sessions."}
327
+ {props.isNew ? null : " Saving restarts this host and stops its running sessions."}
328
</p>
329
{problem === null ? null : (
330
<p className="text-xs text-destructive" role="alert">
apps/web/src/components/settings/SecretsSettings.logic.test.ts
+2
-2
@@ -29,7 +29,7 @@ const settings = Schema.decodeSync(ServerSettings)({
29
hub: { kind: "cliproxy", url: "https://hub.test", managementKey: personal("op://hub") },
30
},
31
easDeviceHosts: [
32
- { kind: "eas", id: "eas", label: "EAS Simulator", accessToken: personal("op://expo") },
32
+ { kind: "eas", id: "eas", label: "Expo Simulators", accessToken: personal("op://expo") },
33
],
34
simlockDeviceHosts: [
35
{
@@ -51,7 +51,7 @@ it.each([
51
"Codex · CODEX_TOKEN",
52
"GitHub · github.com",
53
"https://hub.test · Management Key",
54
- "EAS Simulator · Access Token",
54
+ "Expo Simulators · Access Token",
55
"Simlock Pool · Agent Token",
56
"Voice · OpenAI",
57
],
apps/web/src/components/settings/easDeviceHostsSettings.logic.test.ts
+2
-2
@@ -7,8 +7,8 @@ import {
7
updateEasDeviceHosts,
8
} from "./easDeviceHostsSettings.logic";
9
10
-describe("EAS device host settings", () => {
11
- it("rejects limits EAS does not allow", () => {
10
+describe("Expo device host settings", () => {
11
+ it("rejects limits Expo does not allow", () => {
12
expect(Option.isSome(parseEasDeviceHostDraft(newEasDeviceHost("eas")))).toBe(true);
13
expect(
14
Option.isNone(parseEasDeviceHostDraft({ ...newEasDeviceHost("eas"), maxSessionMinutes: 10 })),
apps/web/src/components/settings/easDeviceHostsSettings.logic.ts
+2
-2
@@ -9,14 +9,14 @@ export const parseEasDeviceHostDraft = Schema.decodeUnknownOption(EasDeviceHostC
9
export const newEasDeviceHost = (id: string): EasDeviceHostConfigType => ({
10
kind: "eas",
11
id,
12
- label: "EAS Simulator",
12
+ label: "Expo Simulators",
13
accessToken: "",
14
maxSessionMinutes: 30,
15
idleMinutes: 10,
16
maxConcurrentSessions: 2,
17
});
18
19
-/** Adds, replaces, or removes one EAS host. */
19
+/** Adds, replaces, or removes one Expo host. */
20
/**
21
* With `keepToken`, the environment keeps the token it holds: a saved token arrives redacted, and
22
* one environment's token says nothing about another's. One new to the host uses its own Expo login.
apps/web/src/state/device.ts
+1
-1
@@ -169,7 +169,7 @@ export const NO_DEVICE_PROBE_ATOM = Atom.make(AsyncResult.initial<void, never>()
169
);
170
171
/**
172
- * The Expo account an EAS host editor shows as it opens, for the saved
172
+ * The Expo account an Expo host editor shows as it opens, for the saved
173
* credential. Each open checks again; edits and manual checks use the command.
174
*/
175
export const deviceEasAccountCheck = createEnvironmentRpcQueryAtomFamily(connectionAtomRuntime, {
docs/internals/devices.md
+6
-6
@@ -26,10 +26,10 @@ operations, so a host whose devices live elsewhere only replaces them.
26
SSH hosts forward both endpoints to server loopback. Every proxied request
27
also carries the host id; device ids alone are not unique across hosts.
28
29
-## EAS Simulator hosts are billed sessions
29
+## Expo hosts run billed sessions
30
31
-An [EAS host](../../apps/server/src/device/EasDeviceHost.ts) has no machine:
32
-each opened device is an EAS Simulator session that bills the Expo account
31
+An [Expo host](../../apps/server/src/device/EasDeviceHost.ts) has no machine:
32
+each opened device is an Expo Simulators session that bills the Expo account
33
until it stops. Every session is created with the host's run and idle limits,
34
the host refuses to start past its session limit, and closing the host stops
35
its sessions. Sessions it starts are recorded under the state directory and
@@ -42,7 +42,7 @@ route each request (`DeviceHostReady.upstream`) and adds the session token serve
42
clients never hold it. Agent config files are written per device
43
(`DeviceOperations.agentEndpoint`), which is why `device_open` opens the
44
device before targeting it. Device settings and tools run `simctl` or `adb` on
45
-the device's machine, which EAS does not expose, so they are unavailable there.
45
+the device's machine, which Expo does not expose, so they are unavailable there.
46
47
## Simlock hosts lease through the agent-device front
48
@@ -145,12 +145,12 @@ WebCodecs is secure-context only, so the viewer probes `isConfigSupported` and f
145
MJPEG on iOS when decoding is unavailable. Android's SEMU socket has no MJPEG;
146
there the panel reports that it cannot decode.
147
148
-serve-sim can also be locked to WebRTC, as on EAS Simulator, and then refuses
148
+serve-sim can also be locked to WebRTC, as on Expo Simulators, and then refuses
149
AVCC with a 409 naming the transport. The viewer still asks for AVCC first, so
150
hubs that serve it pay nothing, and switches on that 409, or when its MJPEG
151
image fails in a browser that has `RTCPeerConnection`. Offers are not trickled:
152
serve-sim takes one offer with every candidate. The video element only feeds
153
the same canvas sink, so the panel and the mobile WebView keep one surface.
154
Android asks serve-emu's `/api` before opening its video socket and streams
155
-WebRTC when it is advertised (EAS Simulator), keeping a separate `video=0`
155
+WebRTC when it is advertised (Expo Simulators), keeping a separate `video=0`
156
socket for input so input can reconnect without restarting video.
docs/user/devices.md
+1
-1
@@ -94,7 +94,7 @@ started from then on; your own Device panel is unaffected.
94
The device stream goes through the environment server, so it works over the
95
local network, Tailscale, and T3 Connect. Live video needs a secure page
96
(HTTPS or localhost); on a plain-HTTP remote origin iOS falls back to a slower
97
-still-image stream and Android cannot show video, except on EAS Simulator.
97
+still-image stream and Android cannot show video, except on Expo Simulators.
98
99
## SSH device hosts
100
packages/client-runtime/src/device/stream.ts
+2
-2
@@ -66,7 +66,7 @@ const webRtcSettingsSchema = Schema.Struct({
66
iceServers: Schema.optionalKey(Schema.Array(iceServerSchema)),
67
iceTransportPolicy: Schema.optionalKey(Schema.Literals(["all", "relay"])),
68
});
69
-// serve-sim reports its stream settings as `streamSettings` (EAS) or `stream`.
69
+// serve-sim reports its stream settings as `streamSettings` (Expo) or `stream`.
70
const serveSimApiSchema = Schema.Struct({
71
streamSettings: Schema.optionalKey(Schema.Unknown),
72
stream: Schema.optionalKey(Schema.Unknown),
@@ -864,7 +864,7 @@ export function createDeviceStreamClient(
864
};
865
866
/**
867
- * serve-sim can be locked to WebRTC (EAS Simulator always is), and then
867
+ * serve-sim can be locked to WebRTC (an Expo Simulator always is), and then
868
* refuses AVCC and MJPEG; serve-emu advertises WebRTC the same way. An
869
* unreadable answer keeps the default path.
870
*/
packages/client-runtime/src/state/device.ts
+2
-2
@@ -16,9 +16,9 @@ export function createDeviceEnvironmentAtoms<R, E>(
16
mode: "serial" as const,
17
key: ({ environmentId }: { environmentId: string }) => environmentId,
18
};
19
- // An EAS Simulator start can take minutes; it must not hold up powering off
19
+ // Starting an Expo Simulator can take minutes; it must not hold up powering off
20
// another device or turning device support off, so each device opens in its
21
- // own lane. Every EAS start opens the same catalog device, so the thread is
21
+ // own lane. Every Expo start opens the same catalog device, so the thread is
22
// part of the lane too.
23
const openConcurrency = {
24
mode: "serial" as const,
packages/contracts/src/device.test.ts
+9
-9
@@ -14,7 +14,7 @@ const decodeSshHosts = Schema.decodeUnknownSync(SshDeviceHostConfigs);
14
const decodeEas = Schema.decodeUnknownSync(EasDeviceHostConfigs);
15
const encodeState = Schema.encodeSync(DeviceServiceState);
16
const decodeState = Schema.decodeUnknownSync(DeviceServiceState);
17
-// The host summary as clients decoded it before EAS hosts existed.
17
+// The host summary as clients decoded it before Expo hosts existed.
18
const decodeOlderState = Schema.decodeUnknownSync(
19
Schema.Struct({
20
hosts: Schema.Array(
@@ -24,15 +24,15 @@ const decodeOlderState = Schema.decodeUnknownSync(
24
);
25
26
describe("configured device hosts", () => {
27
- it("reads SSH hosts saved before hosts had a kind, and bounds EAS sessions", () => {
27
+ it("reads SSH hosts saved before hosts had a kind, and bounds Expo Simulators sessions", () => {
28
expect(decodeSshHosts([{ id: "mac", label: "Mac mini", target: "julius@mac" }])).toEqual([
29
{ kind: "ssh", id: "mac", label: "Mac mini", target: "julius@mac" },
30
]);
31
- expect(decodeEas([{ kind: "eas", id: "eas", label: "EAS Simulator" }])).toEqual([
31
+ expect(decodeEas([{ kind: "eas", id: "eas", label: "Expo Simulators" }])).toEqual([
32
{
33
kind: "eas",
34
id: "eas",
35
- label: "EAS Simulator",
35
+ label: "Expo Simulators",
36
accessToken: "",
37
maxSessionMinutes: 30,
38
idleMinutes: 10,
@@ -40,21 +40,21 @@ describe("configured device hosts", () => {
40
},
41
]);
42
expect(() =>
43
- decodeEas([{ kind: "eas", id: "eas", label: "EAS", maxSessionMinutes: 600 }]),
43
+ decodeEas([{ kind: "eas", id: "eas", label: "Expo", maxSessionMinutes: 600 }]),
44
).toThrow();
45
// The default idle limit of 10 is not smaller than a session limit of 10.
46
expect(() =>
47
- decodeEas([{ kind: "eas", id: "eas", label: "EAS", maxSessionMinutes: 10 }]),
47
+ decodeEas([{ kind: "eas", id: "eas", label: "Expo", maxSessionMinutes: 10 }]),
48
).toThrow();
49
});
50
51
- it("marks the EAS access token as a secret setting", () => {
51
+ it("marks the Expo access token as a secret setting", () => {
52
expect(secretSettingsFields(EasDeviceHostConfig)).toEqual(["accessToken"]);
53
expect(secretSettingsFields(SimlockDeviceHostConfig)).toEqual(["agentToken"]);
54
});
55
});
56
57
-describe("device state for clients from before EAS hosts", () => {
57
+describe("device state for clients from before Expo hosts", () => {
58
const summary = {
59
label: "Host",
60
platforms: [],
@@ -77,7 +77,7 @@ describe("device state for clients from before EAS hosts", () => {
77
revision: 1,
78
};
79
80
- it("sends EAS and Simlock hosts where an older client does not look, and reads them back", () => {
80
+ it("sends Expo and Simlock hosts where an older client does not look, and reads them back", () => {
81
const wire = encodeState(state);
82
expect(decodeOlderState(wire).hosts.map((host) => host.id)).toEqual(["local"]);
83
expect(decodeState(wire).hosts).toEqual(state.hosts);
packages/contracts/src/device.ts
+11
-11
@@ -20,7 +20,7 @@ const ConfiguredDeviceHostId = DeviceHostId.check(
20
);
21
22
export const SshDeviceHostConfig = Schema.Struct({
23
- // Hosts saved before EAS hosts existed carry no kind.
23
+ // Hosts saved before Expo hosts existed carry no kind.
24
kind: Schema.Literal("ssh").pipe(Schema.withDecodingDefaultKey(Effect.succeed("ssh" as const))),
25
id: ConfiguredDeviceHostId,
26
label: TrimmedNonEmptyString,
@@ -31,14 +31,14 @@ export const SshDeviceHostConfig = Schema.Struct({
31
export type SshDeviceHostConfig = typeof SshDeviceHostConfig.Type;
32
33
/**
34
- * Cloud simulators from EAS Simulator. Sessions bill the Expo account until
34
+ * Cloud simulators from Expo Simulators. Sessions bill the Expo account until
35
* they stop, so every one is bounded. The Expo credential is not stored here.
36
*/
37
export const EasDeviceHostConfig = Schema.Struct({
38
kind: Schema.Literal("eas"),
39
id: ConfiguredDeviceHostId,
40
label: TrimmedNonEmptyString,
41
- /** EAS project that sessions run under, when the project's app config does not name one. */
41
+ /** Expo project that sessions run under, when the project's app config does not name one. */
42
appId: Schema.optional(TrimmedNonEmptyString),
43
/**
44
* Expo access token, kept in the secret store, or the secret provider to read
@@ -49,7 +49,7 @@ export const EasDeviceHostConfig = Schema.Struct({
49
Schema.withDecodingDefaultKey(Effect.succeed("")),
50
Schema.annotateKey({ settingsSecret: true }),
51
),
52
- /** EAS allows at most 40 minutes on free accounts and 115 on paid ones. */
52
+ /** Expo Simulators needs a paid Expo account, and allows sessions of at most 115 minutes. */
53
maxSessionMinutes: Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 115 })).pipe(
54
Schema.withDecodingDefaultKey(Effect.succeed(30)),
55
),
@@ -60,7 +60,7 @@ export const EasDeviceHostConfig = Schema.Struct({
60
Schema.withDecodingDefaultKey(Effect.succeed(2)),
61
),
62
}).check(
63
- // EAS requires the idle limit to be smaller than the session limit.
63
+ // Expo requires the idle limit to be smaller than the session limit.
64
Schema.makeFilter(
65
(host: { readonly idleMinutes: number; readonly maxSessionMinutes: number }) =>
66
host.idleMinutes < host.maxSessionMinutes ||
@@ -109,16 +109,16 @@ export const SshDeviceHostConfigs = Schema.Array(SshDeviceHostConfig).check(uniq
109
110
/**
111
* Kept apart from the SSH hosts in settings: servers and clients from before
112
- * EAS hosts decode `deviceHosts` as SSH hosts and would reject the whole file
113
- * or snapshot over one EAS entry.
112
+ * Expo hosts decode `deviceHosts` as SSH hosts and would reject the whole file
113
+ * or snapshot over one Expo entry.
114
*/
115
export const EasDeviceHostConfigs = Schema.Array(EasDeviceHostConfig).check(uniqueHostIds);
116
117
-/** Kept apart from the other host lists for the same reason as EAS hosts. */
117
+/** Kept apart from the other host lists for the same reason as Expo hosts. */
118
export const SimlockDeviceHostConfigs = Schema.Array(SimlockDeviceHostConfig).check(uniqueHostIds);
119
120
export const DeviceEasAccountInput = Schema.Struct({
121
- /** A saved EAS host whose stored token is checked when no new token is given. */
121
+ /** A saved Expo host whose stored token is checked when no new token is given. */
122
hostId: Schema.optional(DeviceHostId),
123
accessToken: Schema.optional(SettingsSecretValue),
124
});
@@ -264,7 +264,7 @@ const deviceServiceStateFields = {
264
supportsHostRetry: Schema.optional(Schema.Boolean),
265
supportsToolUpdate: Schema.optional(Schema.Boolean),
266
supportsToolInspection: Schema.optional(Schema.Boolean),
267
- /** Servers from before EAS hosts ignore `easDeviceHosts`, so clients offer them only when set. */
267
+ /** Servers from before Expo hosts ignore `easDeviceHosts`, so clients offer them only when set. */
268
supportsEasHosts: Schema.optional(Schema.Boolean),
269
/** Servers from before Simlock hosts ignore `simlockDeviceHosts`. */
270
supportsSimlockHosts: Schema.optional(Schema.Boolean),
@@ -283,7 +283,7 @@ const deviceServiceStateFields = {
283
};
284
285
/**
286
- * EAS host summaries travel as `easHosts`: clients from before EAS hosts
286
+ * Expo host summaries travel as `easHosts`: clients from before Expo hosts
287
* decode `hosts` with a `local | ssh` kind and would reject the whole state.
288
* Decoded, every host is in `hosts`.
289
*/
packages/contracts/src/settings.test.ts
+4
-4
@@ -418,17 +418,17 @@ describe("ServerSettings environment icon", () => {
418
419
const decodeDeviceHostSettings = Schema.decodeSync(ServerSettings);
420
421
-// `deviceHosts` as it was decoded before EAS hosts existed: an SSH host needs a target.
421
+// `deviceHosts` as it was decoded before Expo hosts existed: an SSH host needs a target.
422
const decodeOlderDeviceHostSettings = Schema.decodeUnknownSync(
423
Schema.Struct({
424
deviceHosts: Schema.Array(Schema.Struct({ id: Schema.String, target: Schema.String })),
425
}),
426
);
427
428
-it("keeps EAS hosts out of the SSH host list servers and clients before EAS hosts decode", () => {
428
+it("keeps Expo hosts out of the SSH host list servers and clients before Expo hosts decode", () => {
429
const settings = decodeDeviceHostSettings({
430
deviceHosts: [{ id: "mini", label: "Mac mini", target: "user@mini" }],
431
- easDeviceHosts: [{ kind: "eas", id: "eas", label: "EAS Simulator" }],
431
+ easDeviceHosts: [{ kind: "eas", id: "eas", label: "Expo Simulators" }],
432
});
433
const wire = encodeServerSettings(settings);
434
expect(decodeOlderDeviceHostSettings(wire).deviceHosts).toEqual([
@@ -439,7 +439,7 @@ it("keeps EAS hosts out of the SSH host list servers and clients before EAS host
439
440
it("validates remote device hosts and rejects ambiguous host ids", () => {
441
const host = { id: "mini", label: "Mac mini", target: "user@mini", port: 2222 };
442
- // Hosts saved before EAS hosts existed have no `kind`; they are SSH hosts.
442
+ // Hosts saved before Expo hosts existed have no `kind`; they are SSH hosts.
443
expect(decodeDeviceHostSettings({ deviceHosts: [host] }).deviceHosts).toEqual([
444
{ kind: "ssh", ...host },
445
]);