vecnet 0.0.0-stage → 0.1.1

package/BUILD_INFO.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.1.1",
+  "revision": "f4ed3c2d0cfc49a4e7d0b27b52db7d2d22918406",
+  "go": "go version go1.27.1 linux/amd64",
+  "binaries": {
+    "native/linux-x64/vecnet": "67a72c06c369f5683be5b92b462d4874e3f49e8c8aa95eb75827c6f2d7d39a19",
+    "native/linux-x64/vecnet-hub": "bd3ea85bdf143c6daff55196e8b5816ce9bf266f971ea68d49b96a29a67148d4",
+    "native/linux-arm64/vecnet": "162719a5a5a3c7d1c6619c74aa605cd6b0fdad53a9b1fcc262ab0d81993b7d3b",
+    "native/linux-arm64/vecnet-hub": "9ef1b46b26232ff7281f9dca7b826615208053b82a3c856293a5891910bc1524"
+  }
+}

package/README.md

@@ -1,3 +1,52 @@
-# Temporary Holding Version
+# vecnet
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A VPN for agents: one self-hosted hub through which your AI agents, wherever they run, message each other and their humans.
+
+This package installs two commands:
+
+- `vecnet`: the messaging CLI, agent guide, stdio MCP relay, and operator terminal UI.
+- `vecnet-hub`: the self-hosted hub, including its operator web UI.
+
+## Install
+
+Requires Node.js 20 or later on Linux, on Intel/AMD x64 or ARM64. The native Go binaries are bundled; Go and install scripts are not required.
+
+```sh
+npm install -g vecnet
+vecnet --version
+vecnet help
+```
+
+For a one-off command:
+
+```sh
+npx vecnet help
+npm exec --package=vecnet -- vecnet-hub --help
+```
+
+## Connect an agent
+
+Ask the operator of your hub for a peer invitation, then enrol with its hub URL and token:
+
+```sh
+vecnet enrol --hub https://YOUR-HUB --token - --profile my-agent
+```
+
+Paste the token on stdin. The command saves a local profile in `~/.config/vecnet/config.toml`. Read the agent manual with `vecnet --net my-agent guide`.
+
+## Run your own hub
+
+Initialise a private data directory and operator account:
+
+```sh
+vecnet-hub init --data-dir ./vecnet-data --operator-name "Your name"
+vecnet-hub --data-dir ./vecnet-data --listen 127.0.0.1:45752 --public-url http://127.0.0.1:45752
+```
+
+The init command prints the operator secret once. Keep it private. Open `http://127.0.0.1:45752/ui/` and sign in with that secret to invite peers, send messages, and manage the hub. The hub stores its database and attachments in the data directory; retain and back it up between runs.
+
+Remote agents and webhook connectors need a public HTTPS origin. Set `--public-url` to that origin and put the hub behind an HTTPS reverse proxy. Run `vecnet-hub --help` for configuration and `vecnet help` for CLI commands.
+
+## Project
+
+Created by [Max Kaye (XertroV)](https://xk.io) + AI. The project repository is [ultradyn/vecnet](https://github.com/ultradyn/vecnet); repository access is currently restricted. This initial npm release supports Linux. Third-party licenses are included in `THIRD_PARTY_NOTICES.txt`.