aegis-arun 0.2.0 → 0.2.3
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/LICENSE +32 -0
- package/README.md +71 -60
- package/package.json +49 -18
- package/vendor/x86_64-pc-windows-msvc/aegis-relay.exe +0 -0
- package/vendor/x86_64-pc-windows-msvc/arun.exe +0 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Aleksandar Kolev
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Retroactive application
|
|
26
|
+
|
|
27
|
+
This licence applies retroactively to every earlier version of Aegis, including
|
|
28
|
+
those published on npm as `aegis-arun` before this file existed. Versions
|
|
29
|
+
`0.1.0`, `0.2.0`, and `0.2.2` were published with a `UNLICENSED` manifest
|
|
30
|
+
because no licence had been chosen yet; npm does not allow a published
|
|
31
|
+
version's licence to be changed afterwards, so those versions still display
|
|
32
|
+
`UNLICENSED` on the registry. The grant above covers them all.
|
package/README.md
CHANGED
|
@@ -1,61 +1,72 @@
|
|
|
1
|
-
# Aegis — Terminal Agent Runtime
|
|
2
|
-
|
|
3
|
-
Aegis (`aegis`, also `arun`) is a Rust terminal agent runtime. It connects to supported model providers, runs tools through permission-filtered capabilities, and records task progress and evidence in a durable SQLite event log. You can follow work in the terminal, steer an active task, and inspect its results without handing control to a provider CLI.
|
|
4
|
-
|
|
5
|
-
## Get started
|
|
6
|
-
|
|
7
|
-
Launch `aegis` or `arun` with no arguments to open the interactive terminal. Choose a provider, sign in or configure a compatible custom endpoint, select a model, review workspace access, and describe the task. Aegis creates and follows the task for you; you do not need to enter run or attach commands.
|
|
8
|
-
|
|
9
|
-
ChatGPT and Grok use Aegis-owned direct HTTP flows. Browser approval is the recommended desktop sign-in flow; a device-code option is available for remote or headless terminals. Custom endpoints use an OpenAI-compatible interface. Claude subscription sign-in is pending. See [provider status and evidence](docs/direct-providers.md) and [browser sign-in boundaries](docs/browser-signin.md).
|
|
10
|
-
|
|
11
|
-
For a source build and advanced CLI use:
|
|
12
|
-
|
|
13
|
-
```powershell
|
|
14
|
-
cargo build --release
|
|
15
|
-
target/release/arun login chatgpt
|
|
16
|
-
target/release/arun run "Inspect this repository" --provider chatgpt
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
The npm package `aegis-arun@0.2.0` is published on npm. Install it globally and launch either command:
|
|
20
|
-
|
|
21
|
-
```sh
|
|
22
|
-
npm install --global aegis-arun
|
|
23
|
-
aegis
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
The package supports Windows x64 and Linux x64/arm64; macOS is unsupported. Published packages download a platform-specific runtime. Local native builds require Node 20+ and Rust. See [npm publishing](docs/npm-publishing.md) for package and release details.
|
|
27
|
-
|
|
28
|
-
## Working in the terminal
|
|
29
|
-
|
|
30
|
-
The interactive interface keeps ordinary terminal scrollback rather than taking over an alternate screen. It shows readable tool activity and results, supports steering an active task from the composer, and provides searchable menus and keyboard controls. Use `/` for the command catalog; F1 explains keyboard controls. Set `NO_COLOR=1` to disable colors or `AEGIS_REDUCED_MOTION=1` to reduce animation. See [terminal behavior and verification](docs/terminal-ui.md).
|
|
31
|
-
|
|
32
|
-
Aegis asks when intent or a decision is unclear. An unanswered question blocks dependent work, while independent work can continue. Ctrl+C interrupts active work; Ctrl+D detaches from a task. F3 opens saved tasks and recovery choices, and F5 starts a fresh conversation without deleting task history. Advanced users can inspect tasks with commands such as `arun status <run-id>`, `arun replay <run-id>`, `arun artifacts <run-id>`, and `arun metrics <run-id>`.
|
|
33
|
-
|
|
34
|
-
## Permissions and evidence
|
|
35
|
-
|
|
36
|
-
Workspace reads and search are available by default. Writes require permission; command execution is disabled unless a specific program and locally available container image are granted. Process workers use a network-disabled container with a read-only root filesystem and resource limits. Images are not pulled implicitly during task execution. Trusted-host MCP servers are an explicit exception and are not sandboxed. See [runtime contracts](docs/contracts.md) for details.
|
|
37
|
-
|
|
38
|
-
Task completion is not established by a model's claim alone. Successful operations produce evidence artifacts; explicit user requirements are tracked separately and need current-revision evidence. Interrupted operations with uncertain external effects are paused for reconciliation rather than blindly replayed. Independent completion checks can be configured, but their availability and scope should be reviewed for each project. See [task controls and proof boundaries](docs/control-surface.md).
|
|
39
|
-
|
|
40
|
-
Aegis records provider-reported usage when available and labels missing or estimated measurements rather than treating them as exact. Deadlines and resource limits still apply; there is no task-level model-turn or token cap. Metrics are measurements, not a guarantee of provider billing accuracy or task efficiency.
|
|
41
|
-
|
|
42
|
-
## Build and validate
|
|
43
|
-
|
|
44
|
-
```powershell
|
|
45
|
-
cargo test
|
|
46
|
-
cargo test --test docker -- --ignored
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
The ignored Docker test requires a running Docker daemon and the local `node:22-alpine` image. The npm package smoke test is run after building the native binary with `npm run build:native`, then `npm run test:package`. These checks do not establish live inference, hosted sign-in, or interactive UI quality. Review [verification notes](docs/verification.md) for dated observations and known gaps.
|
|
50
|
-
|
|
51
|
-
## Further documentation
|
|
52
|
-
|
|
53
|
-
- [Current provider evidence and remaining work](docs/direct-providers.md)
|
|
54
|
-
- [Terminal UI behavior](docs/terminal-ui.md)
|
|
55
|
-
- [Task controls and evidence boundaries](docs/control-surface.md)
|
|
56
|
-
- [Runtime contracts](docs/contracts.md)
|
|
57
|
-
- [Saved-chat continuation](docs/saved-chat-continuation.md)
|
|
58
|
-
- [npm release process](docs/npm-publishing.md)
|
|
59
|
-
- [Windows local setup](relay/local/README.md)
|
|
60
|
-
|
|
1
|
+
# Aegis — Terminal Agent Runtime
|
|
2
|
+
|
|
3
|
+
Aegis (`aegis`, also `arun`) is a Rust terminal agent runtime. It connects to supported model providers, runs tools through permission-filtered capabilities, and records task progress and evidence in a durable SQLite event log. You can follow work in the terminal, steer an active task, and inspect its results without handing control to a provider CLI.
|
|
4
|
+
|
|
5
|
+
## Get started
|
|
6
|
+
|
|
7
|
+
Launch `aegis` or `arun` with no arguments to open the interactive terminal. Choose a provider, sign in or configure a compatible custom endpoint, select a model, review workspace access, and describe the task. Aegis creates and follows the task for you; you do not need to enter run or attach commands.
|
|
8
|
+
|
|
9
|
+
ChatGPT and Grok use Aegis-owned direct HTTP flows. Browser approval is the recommended desktop sign-in flow; a device-code option is available for remote or headless terminals. Custom endpoints use an OpenAI-compatible interface. Claude subscription sign-in is pending. See [provider status and evidence](docs/direct-providers.md) and [browser sign-in boundaries](docs/browser-signin.md).
|
|
10
|
+
|
|
11
|
+
For a source build and advanced CLI use:
|
|
12
|
+
|
|
13
|
+
```powershell
|
|
14
|
+
cargo build --release
|
|
15
|
+
target/release/arun login chatgpt
|
|
16
|
+
target/release/arun run "Inspect this repository" --provider chatgpt
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
The npm package `aegis-arun@0.2.0` is published on npm. Install it globally and launch either command:
|
|
20
|
+
|
|
21
|
+
```sh
|
|
22
|
+
npm install --global aegis-arun
|
|
23
|
+
aegis
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
The package supports Windows x64 and Linux x64/arm64; macOS is unsupported. Published packages download a platform-specific runtime. Local native builds require Node 20+ and Rust. See [npm publishing](docs/npm-publishing.md) for package and release details.
|
|
27
|
+
|
|
28
|
+
## Working in the terminal
|
|
29
|
+
|
|
30
|
+
The interactive interface keeps ordinary terminal scrollback rather than taking over an alternate screen. It shows readable tool activity and results, supports steering an active task from the composer, and provides searchable menus and keyboard controls. Use `/` for the command catalog; F1 explains keyboard controls. Set `NO_COLOR=1` to disable colors or `AEGIS_REDUCED_MOTION=1` to reduce animation. See [terminal behavior and verification](docs/terminal-ui.md).
|
|
31
|
+
|
|
32
|
+
Aegis asks when intent or a decision is unclear. An unanswered question blocks dependent work, while independent work can continue. Ctrl+C interrupts active work; Ctrl+D detaches from a task. F3 opens saved tasks and recovery choices, and F5 starts a fresh conversation without deleting task history. Advanced users can inspect tasks with commands such as `arun status <run-id>`, `arun replay <run-id>`, `arun artifacts <run-id>`, and `arun metrics <run-id>`.
|
|
33
|
+
|
|
34
|
+
## Permissions and evidence
|
|
35
|
+
|
|
36
|
+
Workspace reads and search are available by default. Writes require permission; command execution is disabled unless a specific program and locally available container image are granted. Process workers use a network-disabled container with a read-only root filesystem and resource limits. Images are not pulled implicitly during task execution. Trusted-host MCP servers are an explicit exception and are not sandboxed. See [runtime contracts](docs/contracts.md) for details.
|
|
37
|
+
|
|
38
|
+
Task completion is not established by a model's claim alone. Successful operations produce evidence artifacts; explicit user requirements are tracked separately and need current-revision evidence. Interrupted operations with uncertain external effects are paused for reconciliation rather than blindly replayed. Independent completion checks can be configured, but their availability and scope should be reviewed for each project. See [task controls and proof boundaries](docs/control-surface.md).
|
|
39
|
+
|
|
40
|
+
Aegis records provider-reported usage when available and labels missing or estimated measurements rather than treating them as exact. Deadlines and resource limits still apply; there is no task-level model-turn or token cap. Metrics are measurements, not a guarantee of provider billing accuracy or task efficiency.
|
|
41
|
+
|
|
42
|
+
## Build and validate
|
|
43
|
+
|
|
44
|
+
```powershell
|
|
45
|
+
cargo test
|
|
46
|
+
cargo test --test docker -- --ignored
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
The ignored Docker test requires a running Docker daemon and the local `node:22-alpine` image. The npm package smoke test is run after building the native binary with `npm run build:native`, then `npm run test:package`. These checks do not establish live inference, hosted sign-in, or interactive UI quality. Review [verification notes](docs/verification.md) for dated observations and known gaps.
|
|
50
|
+
|
|
51
|
+
## Further documentation
|
|
52
|
+
|
|
53
|
+
- [Current provider evidence and remaining work](docs/direct-providers.md)
|
|
54
|
+
- [Terminal UI behavior](docs/terminal-ui.md)
|
|
55
|
+
- [Task controls and evidence boundaries](docs/control-surface.md)
|
|
56
|
+
- [Runtime contracts](docs/contracts.md)
|
|
57
|
+
- [Saved-chat continuation](docs/saved-chat-continuation.md)
|
|
58
|
+
- [npm release process](docs/npm-publishing.md)
|
|
59
|
+
- [Windows local setup](relay/local/README.md)
|
|
60
|
+
|
|
61
|
+
## Contributing
|
|
62
|
+
|
|
63
|
+
Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) first — it
|
|
64
|
+
covers the build, the checks CI runs, and the bar for changes that touch
|
|
65
|
+
permissions, evidence, or credential storage.
|
|
66
|
+
|
|
67
|
+
## License
|
|
68
|
+
|
|
69
|
+
MIT. See [LICENSE](LICENSE). The licence applies retroactively to versions
|
|
70
|
+
published before it was added.
|
|
71
|
+
|
|
61
72
|
Aegis is under active development. Provider compatibility, account access, packaging, and verification status can change; consult the linked evidence notes rather than assuming every documented path has been independently validated.
|
package/package.json
CHANGED
|
@@ -1,18 +1,49 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "aegis-arun",
|
|
3
|
-
"version": "0.2.
|
|
4
|
-
"description": "A durable terminal agent with direct account sign-in and custom endpoints",
|
|
5
|
-
"type": "module",
|
|
6
|
-
"license": "
|
|
7
|
-
"engines": {
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
"
|
|
11
|
-
"
|
|
12
|
-
"
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
1
|
+
{
|
|
2
|
+
"name": "aegis-arun",
|
|
3
|
+
"version": "0.2.3",
|
|
4
|
+
"description": "A durable terminal agent with direct account sign-in and custom endpoints",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"engines": {
|
|
8
|
+
"node": ">=20"
|
|
9
|
+
},
|
|
10
|
+
"bin": {
|
|
11
|
+
"aegis": "bin/aegis.mjs",
|
|
12
|
+
"arun": "bin/aegis.mjs"
|
|
13
|
+
},
|
|
14
|
+
"files": [
|
|
15
|
+
"bin",
|
|
16
|
+
"scripts/install.mjs",
|
|
17
|
+
"scripts/platform.mjs",
|
|
18
|
+
"scripts/windows-host.mjs",
|
|
19
|
+
"scripts/windows-host.ps1",
|
|
20
|
+
"scripts/windows-host-install.mjs",
|
|
21
|
+
"scripts/whatsapp-cli.mjs",
|
|
22
|
+
"relay/local",
|
|
23
|
+
"vendor",
|
|
24
|
+
"LICENSE",
|
|
25
|
+
"README.md"
|
|
26
|
+
],
|
|
27
|
+
"scripts": {
|
|
28
|
+
"postinstall": "node scripts/install.mjs",
|
|
29
|
+
"build:native": "node scripts/build-native.mjs",
|
|
30
|
+
"test:package": "node scripts/package-smoke.mjs",
|
|
31
|
+
"test": "node --test tests/npm/*.test.mjs"
|
|
32
|
+
},
|
|
33
|
+
"repository": {
|
|
34
|
+
"type": "git",
|
|
35
|
+
"url": "https://github.com/aleksandarkolev-st/aegis.git"
|
|
36
|
+
},
|
|
37
|
+
"keywords": [
|
|
38
|
+
"agent",
|
|
39
|
+
"terminal",
|
|
40
|
+
"cli",
|
|
41
|
+
"mcp",
|
|
42
|
+
"rust",
|
|
43
|
+
"automation",
|
|
44
|
+
"codex",
|
|
45
|
+
"claude",
|
|
46
|
+
"grok",
|
|
47
|
+
"whatsapp"
|
|
48
|
+
]
|
|
49
|
+
}
|
|
Binary file
|
|
Binary file
|