@baldaworks/acprun 0.1.8 → 0.1.9
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 +24 -4
- package/package.json +25 -9
package/README.md
CHANGED
|
@@ -7,9 +7,9 @@
|
|
|
7
7
|
[](https://www.npmjs.com/package/@baldaworks/acprun)
|
|
8
8
|
[](LICENSE)
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## ACP Registry client and agent runner
|
|
11
11
|
|
|
12
|
-
`acprun` is a CLI
|
|
12
|
+
`acprun` is a CLI for discovering, inspecting, resolving, and running agents published in the [Agent Client Protocol (ACP) Registry](https://agentclientprotocol.com). It supports native binaries, `npx`, and `uvx`.
|
|
13
13
|
|
|
14
14
|
It transparently handles distribution resolution across:
|
|
15
15
|
- **Binary Archives**: Detects host OS and CPU architecture (`linux-x86_64`, `linux-aarch64`, `darwin-aarch64`, `darwin-x86_64`, `windows-x86_64`, `windows-aarch64`), downloads `.zip` or `.tar.gz` archives, validates optional SHA256 integrity checksums, safely extracts to local user cache (with strict Zip Slip protection), sets `0755` executable permissions, and builds the command vector.
|
|
@@ -21,18 +21,28 @@ It transparently handles distribution resolution across:
|
|
|
21
21
|
|
|
22
22
|
## Installation and quick start
|
|
23
23
|
|
|
24
|
+
Install `acprun` through either npm launcher or as a Go binary.
|
|
25
|
+
|
|
24
26
|
### npm package (recommended)
|
|
25
27
|
|
|
26
28
|
For repeated direct shell use, install the npm launcher globally:
|
|
27
29
|
|
|
30
|
+
```bash
|
|
31
|
+
npm install --global acprun@latest
|
|
32
|
+
acprun version
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
The equivalent scoped package is also available as `@baldaworks/acprun`:
|
|
36
|
+
|
|
28
37
|
```bash
|
|
29
38
|
npm install --global @baldaworks/acprun@latest
|
|
30
|
-
acprun --version
|
|
31
39
|
```
|
|
32
40
|
|
|
33
41
|
For one-shot execution without global installation, run the complete `npx` command:
|
|
34
42
|
|
|
35
43
|
```bash
|
|
44
|
+
npx --yes acprun@latest list
|
|
45
|
+
# Equivalent scoped launcher:
|
|
36
46
|
npx --yes @baldaworks/acprun@latest list
|
|
37
47
|
```
|
|
38
48
|
|
|
@@ -42,6 +52,8 @@ npx --yes @baldaworks/acprun@latest list
|
|
|
42
52
|
go install github.com/baldaworks/acprun/cmd/acprun@latest
|
|
43
53
|
```
|
|
44
54
|
|
|
55
|
+
These packages install the `acprun` CLI. When running an agent, `acprun` selects that agent's binary, `npx`, or `uvx` distribution from the Registry.
|
|
56
|
+
|
|
45
57
|
---
|
|
46
58
|
|
|
47
59
|
## One-shot agent execution
|
|
@@ -168,7 +180,15 @@ acprun cache clean --manifests-only
|
|
|
168
180
|
|
|
169
181
|
## Distribution
|
|
170
182
|
|
|
171
|
-
The npm distribution uses CGO-disabled native executables for macOS and Linux on AMD64/ARM64 and Windows AMD64/ARM64 behind the [`@baldaworks/acprun`](https://www.npmjs.com/package/@baldaworks/acprun)
|
|
183
|
+
The npm distribution uses CGO-disabled native executables for macOS and Linux on AMD64/ARM64 and Windows AMD64/ARM64 behind the equivalent [`acprun`](https://www.npmjs.com/package/acprun) and [`@baldaworks/acprun`](https://www.npmjs.com/package/@baldaworks/acprun) launchers. Both launchers share the same scoped platform packages.
|
|
184
|
+
|
|
185
|
+
Description, keywords, and MIT license metadata are defined once in `.omnidist/omnidist.yaml` and inherited by both npm launchers.
|
|
186
|
+
|
|
187
|
+
### Release setup
|
|
188
|
+
|
|
189
|
+
Tag-triggered releases stage and verify the npm packages before publishing and attach native binaries to the GitHub release. Configure the `NPM_PUBLISH_TOKEN` GitHub Actions repository secret before the next release.
|
|
190
|
+
|
|
191
|
+
The npm publishing account must have permission to publish both launcher names and the shared scoped platform packages. The workflow checks that the token is present before building. A failed upload can leave some npm packages published; retain the release logs and inspect registry state before retrying with the omnidist npm publish command.
|
|
172
192
|
|
|
173
193
|
---
|
|
174
194
|
|
package/package.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"bin": {
|
|
3
3
|
"acprun": "acprun.js"
|
|
4
4
|
},
|
|
5
|
-
"description": "
|
|
5
|
+
"description": "CLI to discover, inspect, resolve, and run agents from the Agent Client Protocol (ACP) Registry using native binaries, npx, or uvx",
|
|
6
6
|
"engines": {
|
|
7
7
|
"node": "\u003e=16"
|
|
8
8
|
},
|
|
@@ -11,15 +11,31 @@
|
|
|
11
11
|
"README.md",
|
|
12
12
|
"LICENSE"
|
|
13
13
|
],
|
|
14
|
-
"
|
|
14
|
+
"keywords": [
|
|
15
|
+
"acp",
|
|
16
|
+
"agent-client-protocol",
|
|
17
|
+
"ai-agents",
|
|
18
|
+
"coding-agents",
|
|
19
|
+
"agent-runner",
|
|
20
|
+
"agent-registry",
|
|
21
|
+
"registry",
|
|
22
|
+
"cli",
|
|
23
|
+
"npx",
|
|
24
|
+
"uvx"
|
|
25
|
+
],
|
|
26
|
+
"license": "MIT",
|
|
15
27
|
"name": "@baldaworks/acprun",
|
|
16
28
|
"optionalDependencies": {
|
|
17
|
-
"@baldaworks/acprun-darwin-arm64": "0.1.
|
|
18
|
-
"@baldaworks/acprun-darwin-x64": "0.1.
|
|
19
|
-
"@baldaworks/acprun-linux-arm64": "0.1.
|
|
20
|
-
"@baldaworks/acprun-linux-x64": "0.1.
|
|
21
|
-
"@baldaworks/acprun-win32-arm64": "0.1.
|
|
22
|
-
"@baldaworks/acprun-win32-x64": "0.1.
|
|
29
|
+
"@baldaworks/acprun-darwin-arm64": "0.1.9",
|
|
30
|
+
"@baldaworks/acprun-darwin-x64": "0.1.9",
|
|
31
|
+
"@baldaworks/acprun-linux-arm64": "0.1.9",
|
|
32
|
+
"@baldaworks/acprun-linux-x64": "0.1.9",
|
|
33
|
+
"@baldaworks/acprun-win32-arm64": "0.1.9",
|
|
34
|
+
"@baldaworks/acprun-win32-x64": "0.1.9"
|
|
35
|
+
},
|
|
36
|
+
"repository": {
|
|
37
|
+
"type": "git",
|
|
38
|
+
"url": "git+https://github.com/baldaworks/acprun.git"
|
|
23
39
|
},
|
|
24
|
-
"version": "0.1.
|
|
40
|
+
"version": "0.1.9"
|
|
25
41
|
}
|