Skip to content

Commit 329e013

Browse files
authored
Merge branch 'develop' into dependabot/github_actions/actions/upload-artifact-7
2 parents a82876d + af90ccc commit 329e013

7 files changed

Lines changed: 236 additions & 345 deletions

File tree

.github/workflows/sandbox-live-smoke.yml

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ on:
2626
- "packages/agent/scripts/live-sandbox-smoke.ts"
2727
- "packages/agent/src/services/e2b-capability-router.ts"
2828
- "packages/agent/src/services/e2b-capability-router.test.ts"
29-
- "packages/cloud-services/coding-satellite/**"
29+
- "packages/cloud-services/coding-remote-runner/**"
3030
- "packages/cloud-shared/src/lib/config/containers-env.ts"
3131
- "packages/cloud-shared/src/lib/services/coding-containers.ts"
3232
- "plugins/plugin-elizacloud/**"
@@ -39,7 +39,7 @@ on:
3939
- "packages/agent/scripts/live-sandbox-smoke.ts"
4040
- "packages/agent/src/services/e2b-capability-router.ts"
4141
- "packages/agent/src/services/e2b-capability-router.test.ts"
42-
- "packages/cloud-services/coding-satellite/**"
42+
- "packages/cloud-services/coding-remote-runner/**"
4343
- "packages/cloud-shared/src/lib/config/containers-env.ts"
4444
- "packages/cloud-shared/src/lib/services/coding-containers.ts"
4545
- "plugins/plugin-elizacloud/**"
@@ -58,18 +58,18 @@ env:
5858
E2B_ACCESS_TOKEN: ${{ secrets.E2B_ACCESS_TOKEN }}
5959
E2B_SANDBOX_ID: ${{ vars.E2B_SANDBOX_ID || secrets.E2B_SANDBOX_ID }}
6060
ELIZA_CLOUD_SANDBOX_API_BASE_URL: ${{ vars.ELIZA_CLOUD_SANDBOX_API_BASE_URL || vars.ELIZA_CLOUD_API_BASE_URL || 'https://api.elizacloud.ai/api/v1' }}
61-
ELIZA_CLOUD_SANDBOX_BASE_URL: ${{ vars.ELIZA_CLOUD_SANDBOX_BASE_URL || vars.ELIZA_CLOUD_SATELLITE_RUNNER_URL }}
62-
ELIZA_CLOUD_SATELLITE_RUNNER_URL: ${{ vars.ELIZA_CLOUD_SATELLITE_RUNNER_URL || vars.ELIZA_CLOUD_SANDBOX_BASE_URL }}
61+
ELIZA_CLOUD_SANDBOX_BASE_URL: ${{ vars.ELIZA_CLOUD_SANDBOX_BASE_URL || vars.ELIZA_CLOUD_REMOTE_RUNNER_URL }}
62+
ELIZA_CLOUD_REMOTE_RUNNER_URL: ${{ vars.ELIZA_CLOUD_REMOTE_RUNNER_URL || vars.ELIZA_CLOUD_SANDBOX_BASE_URL }}
6363
ELIZA_CLOUD_SANDBOX_TOKEN: ${{ secrets.ELIZA_CLOUD_SANDBOX_TOKEN || secrets.ELIZACLOUD_API_KEY || secrets.ELIZAOS_CLOUD_API_KEY }}
6464
ELIZA_CLOUD_SANDBOX_ACCESS_URL: ${{ vars.ELIZA_CLOUD_SANDBOX_ACCESS_URL }}
6565
ELIZA_CLOUD_SANDBOX_IMAGE: ${{ vars.ELIZA_CLOUD_SANDBOX_IMAGE }}
66-
ELIZA_CLOUD_SATELLITE_IMAGE: ${{ vars.ELIZA_CLOUD_SATELLITE_IMAGE }}
67-
ELIZA_CLOUD_CODING_SATELLITE_IMAGE: ${{ vars.ELIZA_CLOUD_CODING_SATELLITE_IMAGE }}
68-
ELIZA_HOME_SATELLITE_URL: ${{ vars.ELIZA_HOME_SATELLITE_URL }}
69-
ELIZA_HOME_SATELLITE_TOKEN: ${{ secrets.ELIZA_HOME_SATELLITE_TOKEN }}
70-
ELIZA_HOME_SATELLITE_ACCESS_URL: ${{ vars.ELIZA_HOME_SATELLITE_ACCESS_URL }}
71-
ELIZA_HOME_SATELLITE_SSH_TARGET: ${{ vars.ELIZA_HOME_SATELLITE_SSH_TARGET }}
72-
ELIZA_HOME_SATELLITE_SSH_LOCAL_PORT: ${{ vars.ELIZA_HOME_SATELLITE_SSH_LOCAL_PORT }}
66+
ELIZA_CLOUD_REMOTE_RUNNER_IMAGE: ${{ vars.ELIZA_CLOUD_REMOTE_RUNNER_IMAGE }}
67+
ELIZA_CLOUD_CODING_REMOTE_RUNNER_IMAGE: ${{ vars.ELIZA_CLOUD_CODING_REMOTE_RUNNER_IMAGE }}
68+
ELIZA_HOME_REMOTE_RUNNER_URL: ${{ vars.ELIZA_HOME_REMOTE_RUNNER_URL }}
69+
ELIZA_HOME_REMOTE_RUNNER_TOKEN: ${{ secrets.ELIZA_HOME_REMOTE_RUNNER_TOKEN }}
70+
ELIZA_HOME_REMOTE_RUNNER_ACCESS_URL: ${{ vars.ELIZA_HOME_REMOTE_RUNNER_ACCESS_URL }}
71+
ELIZA_HOME_REMOTE_RUNNER_SSH_TARGET: ${{ vars.ELIZA_HOME_REMOTE_RUNNER_SSH_TARGET }}
72+
ELIZA_HOME_REMOTE_RUNNER_SSH_LOCAL_PORT: ${{ vars.ELIZA_HOME_REMOTE_RUNNER_SSH_LOCAL_PORT }}
7373
OPENCODE_SERVER_USERNAME: ${{ vars.OPENCODE_SERVER_USERNAME || 'opencode' }}
7474
OPENCODE_SERVER_PASSWORD: ${{ secrets.OPENCODE_SERVER_PASSWORD }}
7575
CODEX_BIN: ${{ vars.CODEX_BIN || 'codex' }}

packages/agent/docs/e2b-capability-routing.md

Lines changed: 32 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,8 @@ Active providers:
1515
| Provider | Runner | Use |
1616
| --- | --- | --- |
1717
| `e2b` | E2B SDK sandbox | Hosted coding sandbox when E2B credentials are configured. |
18-
| `eliza-cloud` | Eliza Cloud Satellite HTTP runner | Managed cloud runner and coding-agent container path. |
19-
| `home` | Home Satellite HTTP runner | User-owned machine reachable directly, through Eliza Cloud routing, or through SSH tunnel. |
18+
| `eliza-cloud` | Eliza Cloud remote runner HTTP runner | Managed cloud runner and coding-agent container path. |
19+
| `home` | Home remote runner HTTP runner | User-owned machine reachable directly, through Eliza Cloud routing, or through SSH tunnel. |
2020

2121
Direct `vercel`, `cloudflare`, and `rivet` providers are intentionally disabled
2222
until they are exposed through Eliza Cloud or another reviewed product option.
@@ -26,16 +26,16 @@ until they are exposed through Eliza Cloud or another reviewed product option.
2626
Select the provider:
2727

2828
```text
29-
ELIZA_CODING_SATELLITE_RUNNER=e2b
30-
ELIZA_CODING_SATELLITE_RUNNER=eliza-cloud
31-
ELIZA_CODING_SATELLITE_RUNNER=home
29+
ELIZA_CODING_REMOTE_RUNNER=e2b
30+
ELIZA_CODING_REMOTE_RUNNER=eliza-cloud
31+
ELIZA_CODING_REMOTE_RUNNER=home
3232
```
3333

34-
`ELIZA_SATELLITE_RUNNER` is also accepted. E2B additionally accepts the legacy
34+
`ELIZA_REMOTE_RUNNER` is also accepted. E2B additionally accepts the legacy
3535
flag:
3636

3737
```text
38-
ELIZA_E2B_SATELLITE_RUNNER=1
38+
ELIZA_E2B_REMOTE_RUNNER=1
3939
```
4040

4141
If no provider is selected, the router auto-selects `eliza-cloud` when a direct
@@ -64,7 +64,7 @@ ELIZA_E2B_REQUEST_TIMEOUT_MS
6464
```text
6565
ELIZA_CLOUD_SANDBOX_API_BASE_URL
6666
ELIZA_CLOUD_SANDBOX_BASE_URL
67-
ELIZA_CLOUD_SATELLITE_RUNNER_URL
67+
ELIZA_CLOUD_REMOTE_RUNNER_URL
6868
ELIZA_CLOUD_RUNNER_URL
6969
ELIZA_CLOUD_SANDBOX_TOKEN
7070
ELIZA_CLOUD_API_KEY
@@ -73,8 +73,8 @@ ELIZAOS_CLOUD_API_KEY
7373
ELIZACLOUD_API_KEY
7474
ELIZA_CLOUD_SANDBOX_ACCESS_URL
7575
ELIZA_CLOUD_SANDBOX_IMAGE
76-
ELIZA_CLOUD_SATELLITE_IMAGE
77-
ELIZA_CLOUD_CODING_SATELLITE_IMAGE
76+
ELIZA_CLOUD_REMOTE_RUNNER_IMAGE
77+
ELIZA_CLOUD_CODING_REMOTE_RUNNER_IMAGE
7878
ELIZA_CLOUD_SANDBOX_WORKDIR
7979
ELIZA_CLOUD_SANDBOX_HOST_WORKSPACE_ROOT
8080
ELIZA_CLOUD_SANDBOX_BOOTSTRAP_GIT_URL
@@ -83,48 +83,48 @@ ELIZA_CLOUD_SANDBOX_TIMEOUT_MS
8383
ELIZA_CLOUD_SANDBOX_REQUEST_TIMEOUT_MS
8484
```
8585

86-
`ELIZA_CLOUD_SANDBOX_BASE_URL`, `ELIZA_CLOUD_SATELLITE_RUNNER_URL`, and
87-
`ELIZA_CLOUD_RUNNER_URL` are direct Satellite HTTP URLs and must expose
86+
`ELIZA_CLOUD_SANDBOX_BASE_URL`, `ELIZA_CLOUD_REMOTE_RUNNER_URL`, and
87+
`ELIZA_CLOUD_RUNNER_URL` are direct remote runner HTTP URLs and must expose
8888
`/v1/health`, `/v1/fs/entries`, `/v1/fs/file`, and `/v1/processes/run`.
8989

90-
If no direct Satellite URL is set, `eliza-cloud` uses the Cloud API at
90+
If no direct remote runner URL is set, `eliza-cloud` uses the Cloud API at
9191
`ELIZA_CLOUD_SANDBOX_API_BASE_URL` or the default
9292
`https://api.elizacloud.ai/api/v1`, then posts to
9393
`/coding-containers` with `ELIZA_CLOUD_SANDBOX_TOKEN`, `ELIZA_CLOUD_API_KEY`,
9494
`ELIZAOS_CLOUD_API_KEY`, or `ELIZACLOUD_API_KEY`. The returned container URL is
95-
then treated as the Satellite HTTP runner URL.
95+
then treated as the remote runner HTTP runner URL.
9696

97-
The Cloud control plane should use the coding Satellite image from
98-
`packages/cloud-services/coding-satellite`. Publish it and set:
97+
The Cloud control plane should use the coding remote runner image from
98+
`packages/cloud-services/coding-remote-runner`. Publish it and set:
9999

100100
```text
101-
ELIZA_CLOUD_CODING_SATELLITE_IMAGE=ghcr.io/elizaos/coding-satellite:<tag>
101+
ELIZA_CLOUD_CODING_REMOTE_RUNNER_IMAGE=ghcr.io/elizaos/coding-remote-runner:<tag>
102102
```
103103

104104
## Home
105105

106106
```text
107-
ELIZA_HOME_SATELLITE_URL
107+
ELIZA_HOME_REMOTE_RUNNER_URL
108108
ELIZA_HOME_RUNNER_URL
109-
ELIZA_HOME_SATELLITE_TOKEN
110-
ELIZA_HOME_SATELLITE_ACCESS_URL
109+
ELIZA_HOME_REMOTE_RUNNER_TOKEN
110+
ELIZA_HOME_REMOTE_RUNNER_ACCESS_URL
111111
ELIZA_HOME_ACCESS_URL
112-
ELIZA_HOME_SATELLITE_WORKDIR
113-
ELIZA_HOME_SATELLITE_HOST_WORKSPACE_ROOT
114-
ELIZA_HOME_SATELLITE_BOOTSTRAP_GIT_URL
115-
ELIZA_HOME_SATELLITE_BOOTSTRAP_GIT_REF
116-
ELIZA_HOME_SATELLITE_TIMEOUT_MS
117-
ELIZA_HOME_SATELLITE_REQUEST_TIMEOUT_MS
112+
ELIZA_HOME_REMOTE_RUNNER_WORKDIR
113+
ELIZA_HOME_REMOTE_RUNNER_HOST_WORKSPACE_ROOT
114+
ELIZA_HOME_REMOTE_RUNNER_BOOTSTRAP_GIT_URL
115+
ELIZA_HOME_REMOTE_RUNNER_BOOTSTRAP_GIT_REF
116+
ELIZA_HOME_REMOTE_RUNNER_TIMEOUT_MS
117+
ELIZA_HOME_REMOTE_RUNNER_REQUEST_TIMEOUT_MS
118118
```
119119

120120
Optional SSH tunnel metadata for Settings:
121121

122122
```text
123-
ELIZA_HOME_SATELLITE_SSH_TARGET=user@home.example
123+
ELIZA_HOME_REMOTE_RUNNER_SSH_TARGET=user@home.example
124124
ELIZA_HOME_SSH_TARGET=user@home.example
125-
ELIZA_HOME_SATELLITE_SSH_IDENTITY=/path/to/key
125+
ELIZA_HOME_REMOTE_RUNNER_SSH_IDENTITY=/path/to/key
126126
ELIZA_HOME_SSH_IDENTITY=/path/to/key
127-
ELIZA_HOME_SATELLITE_SSH_LOCAL_PORT=32468
127+
ELIZA_HOME_REMOTE_RUNNER_SSH_LOCAL_PORT=32468
128128
```
129129

130130
The app only renders a copyable SSH tunnel command. It does not spawn or manage
@@ -208,10 +208,10 @@ The opencode server provides:
208208
| `/find`, `/find/file`, `/file`, `/file/content`, `/file/status` | Workspace search and file reads. |
209209
| `/vcs` and `/session/:id/diff` | VCS status and session diff. |
210210

211-
The Satellite HTTP runner remains the outer capability boundary. opencode is an
211+
The remote runner HTTP runner remains the outer capability boundary. opencode is an
212212
agent runner inside E2B, Eliza Cloud, or Home, not a fourth sandbox provider.
213213

214-
## Satellite HTTP Contract
214+
## remote runner HTTP Contract
215215

216216
Eliza Cloud and Home use the same HTTP runner shape:
217217

@@ -284,7 +284,7 @@ Mobile does not need Electrobun. It talks to the same Eliza agent runtime, and
284284
the runtime routes coding capabilities to a reachable provider:
285285

286286
- E2B for hosted sandbox execution.
287-
- Eliza Cloud for managed cloud Satellite execution.
287+
- Eliza Cloud for managed cloud remote runner execution.
288288
- Home for a user-owned machine reachable by direct URL, cloud routing, or SSH tunnel.
289289

290290
Results return through normal chat, trace, and dynamic-view channels.

packages/agent/src/runtime/eliza.ts

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3976,19 +3976,19 @@ export async function startEliza(
39763976
}
39773977
};
39783978

3979-
const registerCloudSandboxRunner = async (): Promise<void> => {
3979+
const registerRemoteCodingRunner = async (): Promise<void> => {
39803980
if (isBundledMobileRuntime()) return;
39813981
try {
3982-
const { registerE2BSatelliteCapabilityRouterIfEnabled } =
3982+
const { registerE2BRemoteCapabilityRouterIfEnabled } =
39833983
await loadE2BCapabilityRouterModule();
39843984
const result =
3985-
await registerE2BSatelliteCapabilityRouterIfEnabled(runtime);
3985+
await registerE2BRemoteCapabilityRouterIfEnabled(runtime);
39863986
if (result.registered) {
3987-
logger.info("[eliza] Cloud sandbox runner registered");
3987+
logger.info("[eliza] Remote coding runner registered");
39883988
}
39893989
} catch (err) {
39903990
logger.warn(
3991-
`[eliza] Cloud sandbox runner registration failed: ${formatError(err)}`,
3991+
`[eliza] Remote coding runner registration failed: ${formatError(err)}`,
39923992
);
39933993
}
39943994
};
@@ -4142,7 +4142,7 @@ export async function startEliza(
41424142
const initializeRuntimeServices = async (): Promise<void> => {
41434143
await runStewardEvmPreBoot();
41444144
await registerConnectorSetupService();
4145-
await registerCloudSandboxRunner();
4145+
await registerRemoteCodingRunner();
41464146
await initializeCoreRuntime();
41474147
await syncRemoteCapabilityPluginsIfAvailable();
41484148
await applyPluginRoleGatingIfAvailable();
@@ -4477,9 +4477,9 @@ export async function startEliza(
44774477
}
44784478
if (!isBundledMobileRuntime()) {
44794479
try {
4480-
const { registerE2BSatelliteCapabilityRouterIfEnabled } =
4480+
const { registerE2BRemoteCapabilityRouterIfEnabled } =
44814481
await loadE2BCapabilityRouterModule();
4482-
await registerE2BSatelliteCapabilityRouterIfEnabled(newRuntime);
4482+
await registerE2BRemoteCapabilityRouterIfEnabled(newRuntime);
44834483
} catch {
44844484
// non-fatal
44854485
}

packages/agent/src/services/e2b-capability-router.coding-satellite.test.ts

Lines changed: 0 additions & 109 deletions
This file was deleted.

0 commit comments

Comments
 (0)