@inkeep/impulse-compute 0.1.0 → 0.2.1
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/README.md +16 -12
- package/dist/impulse-compute.mjs +463 -129
- package/dist/internal/launch.js +8 -8
- package/guest/windows/end-of-life.ps1 +15 -0
- package/guest/windows/extend.ps1 +24 -0
- package/guest/windows/lib.ps1 +22 -0
- package/guest/windows/prepare-ssh.ps1 +15 -0
- package/guest/windows/read-host-key.ps1 +2 -0
- package/guest/windows/read-task.ps1 +8 -0
- package/guest/windows/ssh-bootstrap.ps1 +24 -0
- package/package.json +5 -4
- package/team-mac/vm-start.sh +25 -4
package/README.md
CHANGED
|
@@ -1,12 +1,14 @@
|
|
|
1
1
|
# `@inkeep/impulse-compute`
|
|
2
2
|
|
|
3
|
-
openteammate's compute CLI, as one bundled bin with no runtime dependency. It has
|
|
3
|
+
openteammate's compute CLI, as one bundled bin with no runtime dependency. It has three command groups:
|
|
4
4
|
|
|
5
5
|
- `impulse-compute team-mac` lists the team's pool of cloud Macs, holds a ready Mac for one run, and starts, prepares
|
|
6
6
|
and stops a run's macOS VM.
|
|
7
7
|
- `impulse-compute linux-desktop` owns or adopts an X11 desktop session in a Linux guest (an E2B sandbox, or the
|
|
8
8
|
machine it runs on), launches and closes apps in it, captures raw screens and exact window crops, and verifies exact
|
|
9
9
|
crops. It is the `use-cloud-vms` skill's Linux desktop helper.
|
|
10
|
+
- `impulse-compute ec2` creates a Windows EC2 instance for a run, reaches it over SSH through Session Manager,
|
|
11
|
+
checks its status, extends its end and retires it with a release receipt.
|
|
10
12
|
|
|
11
13
|
## Run it
|
|
12
14
|
|
|
@@ -93,6 +95,12 @@ What each command prints on stdout when it exits `0`:
|
|
|
93
95
|
- **The full contract,** its commands and how to use them on a guest are in the `use-cloud-vms` skill's
|
|
94
96
|
`references/computer-use.md`, "The Linux desktop helper".
|
|
95
97
|
|
|
98
|
+
### `ec2`
|
|
99
|
+
|
|
100
|
+
Run `impulse-compute ec2 --help` from the installed package for the five verbs. Each takes a private run directory and an AWS profile. A fresh `create` records its region. Later verbs use that recorded region. Every `ec2` command, including help and version, requires Node 26.10.0 or later with `process.execve`. An unsupported runtime exits 1 and reports the required and detected versions. Commands that write the run directory also require the built-in `node:sqlite` module to be enabled. Live commands need AWS CLI v2, and SSH access needs OpenSSH and the Session Manager plugin.
|
|
101
|
+
|
|
102
|
+
A new record from the packed bin names the package version and the source commit used by the build. The guest scripts resolve relative to the installed bin. [EC2 helper commands and exit codes](../../scripts/ec2-instance/README.md)
|
|
103
|
+
|
|
96
104
|
## What the package holds
|
|
97
105
|
|
|
98
106
|
| Path | Contents |
|
|
@@ -100,12 +108,13 @@ What each command prints on stdout when it exits `0`:
|
|
|
100
108
|
| `dist/impulse-compute.mjs` | The bin: `#!/usr/bin/env node` on line 1, the provenance line on line 2, the CLI, and the bundled packages' licence notices last |
|
|
101
109
|
| `dist/internal/launch.js` | `@inkeep/impulse-owned-process`'s launcher, a second file because that package loads it from beside its own module: the provenance line on line 1, the launcher, the licence notices last |
|
|
102
110
|
| `team-mac/*` | The scripts the CLI runs on a Mac |
|
|
111
|
+
| `guest/windows/*.ps1` | The Windows user-data template, retirement task reader and mover, and SSH scripts read by the EC2 helper |
|
|
103
112
|
|
|
104
113
|
Both JavaScript files are minified with Rolldown's own minifier and ship with no source maps. Neither keeps a comment
|
|
105
114
|
apart from its provenance line and its licence notices. The provenance line is a comment holding JSON that names the
|
|
106
115
|
repository, the commit, the source tree and the lockfile's sha256 the file was built from, and the bundler. Its
|
|
107
|
-
`sources` list names every folder the bin is built from, `packages/compute`, `scripts/offload` and
|
|
108
|
-
`scripts/
|
|
116
|
+
`sources` list names every folder the bin is built from, `packages/compute`, `scripts/offload`, `scripts/linux-desktop` and
|
|
117
|
+
`scripts/ec2-instance`, each with its tree and the sha256 of the lockfile it resolves through: the repository's root
|
|
109
118
|
`pnpm-lock.yaml` for `packages/compute`, a workspace member, and each other folder's own. The build refuses to run
|
|
110
119
|
while any of those folders or the root lockfile has uncommitted changes.
|
|
111
120
|
|
|
@@ -114,12 +123,7 @@ Three packages the `linux-desktop` group bundles through `e2b` publish no licenc
|
|
|
114
123
|
name each with the licence its `package.json` declares; swap them if needed. The build accepts a missing licence file
|
|
115
124
|
only for those three at those licences and for our own `UNLICENSED` `@inkeep/impulse-*` packages.
|
|
116
125
|
|
|
117
|
-
|
|
118
|
-
and the `linux-desktop` group on 4.1.2, each resolved from its own folder's lockfile. No Effect value passes between
|
|
119
|
-
them: the bin hands the `linux-desktop` group its argument strings and takes nothing back, and the group runs its own
|
|
120
|
-
program and sets the exit code itself. The package's test pins that signature at the type level. Moving
|
|
121
|
-
`packages/compute` and `scripts/offload` to the helper's Effect version is an open item; until then, keep that dispatch
|
|
122
|
-
to plain values.
|
|
126
|
+
Each command group resolves Effect and `@effect/platform-node` from its own source root at 4.1.4. The bin passes argument strings to `linux-desktop`, which runs its own program and sets its exit code. The EC2 dispatcher passes arguments and the environment to `runEc2Cli`, then runs the returned program with the EC2 helper’s own Node services. Its output writer applies to EC2 invocations.
|
|
123
127
|
|
|
124
128
|
Both files import only `node:` builtins. The build walks each file's imports and refuses any import of something
|
|
125
129
|
other than a `node:` builtin, and any `import()`, `require` or `createRequire` the walk finds; the package's test runs
|
|
@@ -133,6 +137,6 @@ back to the global `fetch` when the load fails) and for `glob` and `tar` (only i
|
|
|
133
137
|
|
|
134
138
|
## Contributing
|
|
135
139
|
|
|
136
|
-
The source,
|
|
137
|
-
|
|
138
|
-
`scripts/
|
|
140
|
+
The package source, build and tests live under `packages/compute` in the private `inkeep/openteammate` repository.
|
|
141
|
+
The groups are implemented in `scripts/offload` (team-mac), `scripts/linux-desktop` (linux-desktop), and
|
|
142
|
+
`scripts/ec2-instance` (ec2).
|