@geekbeer/minion 1.0.0 → 1.0.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 +105 -0
- package/minion-cli.sh +4 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
# @geekbeer/minion
|
|
2
|
+
|
|
3
|
+
AI Agent runtime for Minion - manages heartbeat, status, and skill deployment on VPS.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g @geekbeer/minion
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Usage
|
|
12
|
+
|
|
13
|
+
### Setup (VPS)
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
minion-cli setup \
|
|
17
|
+
--hq-url https://minion.geekbeer.co.jp \
|
|
18
|
+
--minion-id <MINION_ID> \
|
|
19
|
+
--api-token <API_TOKEN> \
|
|
20
|
+
--setup-tunnel \
|
|
21
|
+
--non-interactive
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
### Service Management
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
minion-cli start # Start the minion agent
|
|
28
|
+
minion-cli stop # Stop the minion agent
|
|
29
|
+
minion-cli restart # Restart the minion agent
|
|
30
|
+
minion-cli status # Show service status
|
|
31
|
+
minion-cli health # Run health check
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### Logging
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
minion-cli log -m "Task completed" -l info -s skill-name
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## npm公開手順
|
|
41
|
+
|
|
42
|
+
### 初回セットアップ
|
|
43
|
+
|
|
44
|
+
1. npmにログイン:
|
|
45
|
+
```bash
|
|
46
|
+
npm login
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
2. `geekbeer` organizationがnpmに存在することを確認(なければ作成):
|
|
50
|
+
```bash
|
|
51
|
+
npm org create geekbeer
|
|
52
|
+
```
|
|
53
|
+
または https://www.npmjs.com/org/create から作成。
|
|
54
|
+
|
|
55
|
+
### パッケージ公開
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
cd packages/minion
|
|
59
|
+
|
|
60
|
+
# 含まれるファイルを事前確認
|
|
61
|
+
npm pack --dry-run
|
|
62
|
+
|
|
63
|
+
# 公開
|
|
64
|
+
npm publish --access public
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
`publishConfig.access: "public"` が `package.json` に設定済みのため、`--access public` は省略可能。
|
|
68
|
+
|
|
69
|
+
### バージョンアップ & 再公開
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
cd packages/minion
|
|
73
|
+
|
|
74
|
+
# バージョンを上げる(patch: 1.0.0 → 1.0.1)
|
|
75
|
+
npm version patch
|
|
76
|
+
|
|
77
|
+
# または minor: 1.0.0 → 1.1.0
|
|
78
|
+
npm version minor
|
|
79
|
+
|
|
80
|
+
# または major: 1.0.0 → 2.0.0
|
|
81
|
+
npm version major
|
|
82
|
+
|
|
83
|
+
# 公開
|
|
84
|
+
npm publish
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 公開確認
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
npm view @geekbeer/minion
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## Environment Variables
|
|
94
|
+
|
|
95
|
+
| Variable | Description | Default |
|
|
96
|
+
|----------|-------------|---------|
|
|
97
|
+
| `HQ_URL` | Minion HQ server URL | - |
|
|
98
|
+
| `API_TOKEN` | Authentication token | - |
|
|
99
|
+
| `MINION_ID` | Minion UUID | - |
|
|
100
|
+
| `AGENT_PORT` | Agent API listen port | `3001` |
|
|
101
|
+
| `HEARTBEAT_INTERVAL` | Heartbeat interval (ms) | `30000` |
|
|
102
|
+
|
|
103
|
+
## License
|
|
104
|
+
|
|
105
|
+
MIT
|
package/minion-cli.sh
CHANGED
|
@@ -90,6 +90,10 @@ do_setup() {
|
|
|
90
90
|
SETUP_TUNNEL=true
|
|
91
91
|
shift
|
|
92
92
|
;;
|
|
93
|
+
--non-interactive)
|
|
94
|
+
# Accepted for cloud-init compatibility (setup is always non-interactive)
|
|
95
|
+
shift
|
|
96
|
+
;;
|
|
93
97
|
*)
|
|
94
98
|
echo "Unknown option: $1"
|
|
95
99
|
echo "Usage: minion-cli setup [--hq-url <URL>] [--minion-id <UUID>] [--api-token <TOKEN>] [--setup-tunnel]"
|