@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 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 two command groups:
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/linux-desktop`, each with its tree and the sha256 of the lockfile it resolves through: the repository's root
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
- The bin carries two copies of Effect and of `@effect/platform-node`: `team-mac`, from `scripts/offload`, runs on 4.0.7,
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, the build and the tests are in `inkeep/openteammate`, a private repository: the package under
137
- `packages/compute`, the `team-mac` group under `scripts/offload` and the `linux-desktop` group under
138
- `scripts/linux-desktop`.
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).