@vellumai/assistant 0.12.6-dev.202609301914.f1340c9 → 0.12.6-dev.202609302116.cd99c75
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/ARCHITECTURE.md +6 -11
- package/docs/architecture/integrations.md +5 -5
- package/package.json +1 -1
package/ARCHITECTURE.md
CHANGED
|
@@ -1243,14 +1243,10 @@ graph TB
|
|
|
1243
1243
|
EXEC -->|"file_read / file_write / file_edit"| SB_FILE_TOOLS["Sandbox file tools<br/>path-scoped to sandbox root"]
|
|
1244
1244
|
SB_FILE_TOOLS --> SB_FS
|
|
1245
1245
|
|
|
1246
|
-
EXEC -->|"bash"| WRAP["
|
|
1247
|
-
|
|
1248
|
-
|
|
1249
|
-
|
|
1250
|
-
NATIVE -->|"macOS"| SBPL["sandbox-exec<br/>SBPL profile<br/>deny-default + allow workdir"]
|
|
1251
|
-
NATIVE -->|"Linux"| BWRAP["bwrap<br/>bubblewrap<br/>ro-root + rw-workdir<br/>unshare-net + unshare-pid"]
|
|
1252
|
-
SBPL --> SB_FS["Sandbox filesystem root<br/>$VELLUM_WORKSPACE_DIR"]
|
|
1253
|
-
BWRAP --> SB_FS
|
|
1246
|
+
EXEC -->|"bash"| WRAP["buildShellInvocation()<br/>(packages/environments/shell)"]
|
|
1247
|
+
WRAP --> SHELL["bash -c in $VELLUM_WORKSPACE_DIR<br/>sanitized env (safe-env allowlist)"]
|
|
1248
|
+
SHELL --> SB_FS["Workspace filesystem root<br/>$VELLUM_WORKSPACE_DIR"]
|
|
1249
|
+
SHELL -.->|containerized deployments| CONTAINER["Container boundary<br/>(Docker / remote host) provides<br/>OS-level isolation"]
|
|
1254
1250
|
|
|
1255
1251
|
EXEC -->|"host_file_* / host_bash"| HOST_TOOLS["Host-target tools<br/>(unchanged by backend choice)"]
|
|
1256
1252
|
EXEC -->|"computer_use_* (skill-projected<br/>in CU sessions only)"| SKILL_CU_TOOLS["CU skill tools<br/>(bundled computer-use skill)"]
|
|
@@ -1264,9 +1260,8 @@ graph TB
|
|
|
1264
1260
|
USER --> CHECK
|
|
1265
1261
|
```
|
|
1266
1262
|
|
|
1267
|
-
- **
|
|
1268
|
-
- **
|
|
1269
|
-
- **Host tools unchanged**: `host_bash`, `host_file_read`, `host_file_write`, and `host_file_edit` always execute directly on the host regardless of which sandbox backend is active.
|
|
1263
|
+
- **Workspace scoping (software-enforced)**: `file_read`, `file_write`, and `file_edit` path-check every access against `$VELLUM_WORKSPACE_DIR`, including symlink resolution. `bash` spawns `bash -c` in the workspace directory with a sanitized environment and is not OS-confined on local installs; commands are gated by risk classification and the conversation's auto-approve threshold, with workspace path checks applied to allowlisted commands on non-containerized installs. Containerized deployments (`vellum hatch --remote docker`, remote hosts) get OS-level isolation from the container boundary. Workflow scripts run in a separate QuickJS-WASM sandbox with no ambient capabilities.
|
|
1264
|
+
- **Host tools unchanged**: `host_bash`, `host_file_read`, `host_file_write`, and `host_file_edit` always execute directly on the host regardless of deployment mode.
|
|
1270
1265
|
- Sandbox defaults: `file_*` and `bash` execute within `$VELLUM_WORKSPACE_DIR`.
|
|
1271
1266
|
- Host access is explicit: `host_file_read`, `host_file_write`, `host_file_edit`, and `host_bash` are separate tools.
|
|
1272
1267
|
- Prompt defaults: host tools and `computer_use_*` skill-projected actions default to `ask` unless a trust rule allowlists/denylists them.
|
|
@@ -269,7 +269,7 @@ Scripts executed via the `bash` tool can optionally run through a per-session HT
|
|
|
269
269
|
|
|
270
270
|
### Proxied Bash Execution Path
|
|
271
271
|
|
|
272
|
-
When a bash command requires network access with credential injection, the
|
|
272
|
+
When a bash command requires network access with credential injection, the tool injects proxy environment variables into the spawned shell so all HTTP/HTTPS traffic routes through the session proxy.
|
|
273
273
|
|
|
274
274
|
```mermaid
|
|
275
275
|
graph TB
|
|
@@ -283,8 +283,8 @@ graph TB
|
|
|
283
283
|
PROMPT["Prompt user<br/>persistentDecisionsAllowed: false<br/>(no trust rule saving for proxied bash)"]
|
|
284
284
|
end
|
|
285
285
|
|
|
286
|
-
subgraph "
|
|
287
|
-
|
|
286
|
+
subgraph "Shell Execution"
|
|
287
|
+
SHELL["bash -c spawn<br/>(buildShellInvocation)"]
|
|
288
288
|
ENV_INJECT["Inject env vars:<br/>HTTP_PROXY, HTTPS_PROXY,<br/>NO_PROXY, NODE_EXTRA_CA_CERTS"]
|
|
289
289
|
end
|
|
290
290
|
|
|
@@ -298,8 +298,8 @@ graph TB
|
|
|
298
298
|
BASH_CALL --> EXECUTOR
|
|
299
299
|
EXECUTOR --> PERM
|
|
300
300
|
PERM --> PROMPT
|
|
301
|
-
PROMPT -->|"allowed"|
|
|
302
|
-
|
|
301
|
+
PROMPT -->|"allowed"| SHELL
|
|
302
|
+
SHELL --> ENV_INJECT
|
|
303
303
|
ENV_INJECT -->|"HTTP"| HTTP_FWD
|
|
304
304
|
ENV_INJECT -->|"HTTPS CONNECT"| CONNECT
|
|
305
305
|
CONNECT --> ROUTER
|