You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit de2f834
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: .agents/skills/build-openshell-mxc-windows/SKILL.md
+6Lines changed: 6 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -154,6 +154,8 @@ mise run --skip-tools windows:build:x64
154
154
mise run --skip-tools windows:build:arm64
155
155
mise run --skip-tools windows:test:x64
156
156
mise run --skip-tools windows:test:unsupported:x64
157
+
mise run --skip-tools windows:test:mxc-real:x64
158
+
mise run --skip-tools windows:test:mxc-real:arm64
157
159
```
158
160
159
161
For full validation, detect the Windows host architecture first and choose the
@@ -235,6 +237,8 @@ crypto dependency builds.
235
237
|`windows:test:arm64`| Runs native ARM64 workspace tests with `--no-fail-fast` and the same package exclusions. Rejects non-ARM64 hosts. |
236
238
|`windows:test:unsupported:x64`| Re-runs focused `openshell-gateway` tests for unsupported Windows driver behavior. |
237
239
|`windows:test:unsupported:arm64`| Re-runs the same focused contracts natively on ARM64. Rejects non-ARM64 hosts. |
240
+
|`windows:test:mxc-real:x64`| Runs the serial, ignored real-`wxc-exec` integration suite natively on x64 through the MSVC wrapper. Rejects non-x64 hosts. |
241
+
|`windows:test:mxc-real:arm64`| Runs the same real-`wxc-exec` suite natively on ARM64. Rejects non-ARM64 hosts. |
238
242
|`windows:artifacts`| Reports size and SHA256 for release artifacts that exist. |
239
243
|`windows:ci`| Runs the full ordered x64-host Windows CI lane, plus ARM64 check/build when not skipped. |
240
244
@@ -292,6 +296,8 @@ Useful log files:
292
296
|`test-aarch64-pc-windows-msvc.log`| Full native ARM64 workspace test output. |
On native Windows, the MXC driver cannot rely on Linux Landlock or setuid. It
14
+
maps portable static filesystem and UI controls from `SandboxPolicy` into MXC
15
+
configuration. UI controls are available only with the MXC
16
+
`process_container` backend; all omitted UI fields retain deny-by-default
17
+
values, and other compute runtimes reject an explicit UI policy.
18
+
11
19
## Policy Areas
12
20
13
21
| Area | Enforcement |
14
22
|---|---|
15
23
| Filesystem | Landlock restricts read-only and read-write paths. |
16
24
| Process | The supervisor launches the agent as an unprivileged user with reduced capabilities. |
25
+
| UI | Within an explicit UI section, omitted display, clipboard, and input-injection fields deny. The MXC driver's OpenShell `process_container` backend (MXC containment `processcontainer`) can selectively enable them. Other configured backends reject the entire explicit section before provisioning. |
17
26
| Network | The proxy evaluates destination, port, calling binary, and optional L7 rules. |
18
27
| Inference |`inference.local` is configured through gateway inference settings, not OPA network policy. |
19
28
| Runtime settings | Typed settings are delivered with policy and can be global or sandbox scoped. |
20
29
21
-
Filesystemand process policy are startup-time controls. Network policy is
30
+
Filesystem, process, and UI policy are startup-time controls. Network policy is
22
31
dynamic and can be hot-reloaded when the new policy validates successfully.
23
32
33
+
The UI schema names portable capabilities rather than Windows primitives:
34
+
graphical output, directional clipboard access, and synthetic input. The
35
+
configured compute driver advertises whether it completely enforces this
36
+
contract. Any explicit section, including `{}`, is rejected before driver
37
+
validation or provisioning when that capability is false. The MXC
38
+
`process_container` mapper translates the fields to MXC's top-level `ui` object
39
+
under its `processcontainer` containment value and treats omitted fields inside
40
+
the section as deny. That object is common to MXC's 0.8 stable and 0.9
41
+
development schemas. Both schema lines reject it for `isolation_session`, so
42
+
that backend advertises no support and the mapper also rejects it in depth.
43
+
Linux, macOS, and other non-MXC paths advertise no support: explicit UI policy
44
+
fails closed, while an absent section leaves their runtime behavior unchanged.
45
+
24
46
Before applying Landlock, the supervisor enriches baseline filesystem paths that
25
47
the runtime needs. Missing baseline paths are skipped so one absent runtime path
26
48
does not weaken the whole ruleset. When GPU devices are present, GPU baseline
Copy file name to clipboardExpand all lines: crates/openshell-driver-mxc/README.md
+5-3Lines changed: 5 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,6 +19,7 @@ readiness; there is no in-sandbox supervisor or `ConnectSupervisor` relay.
19
19
| Capability | MXC driver |
20
20
|---|---|
21
21
| Filesystem policy | Read-only/read-write grants come only from `SandboxPolicy`. `process_container` enforces default-deny; `isolation_session` is an explicit grant-only compatibility mode. |
22
+
| UI policy |`process_container` advertises complete support and maps portable graphical UI, clipboard-direction, and input-injection controls to MXC; omitted fields inside an explicit section deny. `isolation_session` advertises no support, so the gateway rejects any explicit section before provisioning. |
22
23
| Network policy | Rejected synchronously during sandbox creation until an enforcing egress path is bound. |
23
24
| Process policy | Unsupported; MXC supplies OS isolation only. |
without leaving a partial sandbox. There is no in-process policy side channel
76
77
or MXC-specific gateway composition variant.
77
78
78
-
`EmbeddedPolicyMapper` calls the embedded [`policy_map`](src/policy_map/) module directly and normalizes filesystem paths to Windows form. It does not add gateway-configured host paths. The policy supplied for the sandbox is the only source of filesystem grants.
79
+
`EmbeddedPolicyMapper` calls the embedded [`policy_map`](src/policy_map/) module directly and normalizes filesystem paths to Windows form. It does not add gateway-configured host paths. The policy supplied for the sandbox is the only source of filesystem grants. For `process_container`, the driver advertises `supports_ui_policy = true` and the mapper emits the top-level `ui` object shared by MXC's 0.8 stable and 0.9 development schemas, with restrictive defaults or the exact requested clipboard direction, graphical UI setting, and input-injection setting. `isolation_session` advertises false, so the gateway rejects explicit UI policy before the driver RPC; the mapper also rejects it before lifecycle side effects as defense in depth.
79
80
80
81
The mapper retains an internal policy-splitting seam for future development, but the runtime exposes no governed-egress switch. Any network rule fails closed until an enforcing proxy is implemented and bound to the sandbox lifecycle.
81
82
82
-
Parity and matrix tests under [`tests/`](tests/) cover the mapper on the Windows MSVC lane. The driver performs this mapping automatically; there is no separate policy-export command or example.
83
+
Parity and matrix tests under [`tests/`](tests/) cover the mapper on the Windows MSVC lane. The real-MXC lane also dry-runs every clipboard direction against the installed schema. The driver performs this mapping automatically; there is no separate policy-export command or example.
83
84
84
85
## Packaging the demo for the demo box
85
86
@@ -98,7 +99,8 @@ exits 0 rather than failing.
98
99
99
100
| Task | What it runs | When to use |
100
101
|---|---|---|
101
-
|`windows:test:mxc-real:x64`|`tests/wxc_exec_real.rs` — Tier-2 invoker tests with `--ignored --test-threads=1`| Pre-merge on any Windows host that has `wxc-exec`; dry-run tests always pass; enforcement tests probe-gate themselves |
102
+
|`windows:test:mxc-real:x64`| Native x64 `tests/wxc_exec_real.rs` — Tier-2 invoker tests with `--ignored --test-threads=1`| Pre-merge on an x64 Windows host with `wxc-exec`; dry-run tests always pass; enforcement tests probe-gate themselves |
103
+
|`windows:test:mxc-real:arm64`| Native ARM64 `tests/wxc_exec_real.rs` with the same contract | Pre-merge on an ARM64 Windows host with `wxc-exec`|
102
104
|`windows:e2e:mxc`|`examples/run-mxc-e2e.ps1` — Tier-3 scenario runner, real binary, probe-gated | Demo box / nightly; needs the gateway + CLI binaries in the script directory |
103
105
|`windows:e2e:mxc:mock`| Same runner with `-Mock` — wiring-only, no real `wxc-exec` needed | Any Windows host (CI, dev machine); validates wiring and the network-reject scenario |
0 commit comments