@pantheon.ai/agents 0.0.10 → 0.0.12
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 +43 -6
- package/dist/index.js +2311 -151
- package/package.json +3 -1
package/README.md
CHANGED
|
@@ -1,16 +1,43 @@
|
|
|
1
1
|
# `@pantheon.ai/agents`
|
|
2
2
|
|
|
3
|
-
This package
|
|
3
|
+
This package provides the `pantheon-agents` CLI for managing agent configs and tasks backed by a TiDB/MySQL task list.
|
|
4
|
+
|
|
5
|
+
It includes:
|
|
4
6
|
|
|
5
7
|
- A **runner loop** (`pantheon-agents run <agent>`) that executes queued tasks via Pantheon and persists status/output to TiDB.
|
|
6
8
|
- A **client-facing server** (`pantheon-agents server`) that exposes the same task operations over **HTTP REST** and **MCP (HTTP+SSE)**.
|
|
7
9
|
|
|
8
|
-
##
|
|
10
|
+
## Build
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
npm run -w @pantheon.ai/agents build
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## Environment variables
|
|
17
|
+
|
|
18
|
+
- `DATABASE_URL` (required): MySQL/TiDB connection string for the task list database.
|
|
19
|
+
- `PANTHEON_API_KEY` (required for some commands): Used to query/execute Pantheon branches.
|
|
20
|
+
- `PANTHEON_AGENTS_API_TOKEN` (optional): Bearer token for API auth when running `pantheon-agents server` (defaults for `--token`).
|
|
21
|
+
|
|
22
|
+
Command requirements:
|
|
23
|
+
|
|
24
|
+
- `pantheon-agents add-task|delete-task|show-config|show-tasks`: requires `DATABASE_URL`
|
|
25
|
+
- `pantheon-agents run`: requires `DATABASE_URL` + `PANTHEON_API_KEY`
|
|
26
|
+
- `pantheon-agents config`: requires `DATABASE_URL`, and requires `PANTHEON_API_KEY` when `--bootstrap` is enabled (default) or when `--root-branch-id` is not provided
|
|
27
|
+
- `pantheon-agents reconfig`: requires `DATABASE_URL` + `PANTHEON_API_KEY`
|
|
28
|
+
- `pantheon-agents server`: requires `DATABASE_URL`; auth uses `--token` or env `PANTHEON_AGENTS_API_TOKEN` (unless `--no-auth`)
|
|
9
29
|
|
|
10
|
-
|
|
11
|
-
- `PANTHEON_API_KEY` is required for the runner loop (`pantheon-agents run`) and bootstrap config flows.
|
|
30
|
+
Notes:
|
|
12
31
|
|
|
13
|
-
|
|
32
|
+
- `PANTHEON_API_KEY` is also required for config-related server endpoints/tools that read Pantheon branch output or re-bootstrap configs.
|
|
33
|
+
|
|
34
|
+
## Show tasks output modes
|
|
35
|
+
|
|
36
|
+
- Default: concise one-line entries.
|
|
37
|
+
- Table output: use `--no-concise`.
|
|
38
|
+
- JSON output: use `--json`.
|
|
39
|
+
|
|
40
|
+
## DB schema / migrations
|
|
14
41
|
|
|
15
42
|
The schema lives in `packages/agents/src/db/schema/tidb.sql`.
|
|
16
43
|
|
|
@@ -59,6 +86,15 @@ curl -sS -H "Authorization: Bearer $TOKEN" \\
|
|
|
59
86
|
|
|
60
87
|
curl -sS -H "Authorization: Bearer $TOKEN" \\
|
|
61
88
|
-X DELETE http://127.0.0.1:8000/api/v1/agents/<agent>/tasks/<task_id>
|
|
89
|
+
|
|
90
|
+
# Get agent config (includes bootstrap branch output)
|
|
91
|
+
curl -sS -H "Authorization: Bearer $TOKEN" \\
|
|
92
|
+
http://127.0.0.1:8000/api/v1/agents/<agent>/configs/<project_id>
|
|
93
|
+
|
|
94
|
+
# Re-bootstrap agent config (like `pantheon-agents reconfig`)
|
|
95
|
+
curl -sS -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \\
|
|
96
|
+
-X POST http://127.0.0.1:8000/api/v1/agents/<agent>/configs/<project_id>/reconfig \\
|
|
97
|
+
-d '{ "role": "reviewer", "skills": ["style-reviewer"] }'
|
|
62
98
|
```
|
|
63
99
|
|
|
64
100
|
### MCP (HTTP+SSE)
|
|
@@ -73,4 +109,5 @@ Tools:
|
|
|
73
109
|
- `tasks.create`
|
|
74
110
|
- `tasks.cancel`
|
|
75
111
|
- `tasks.delete`
|
|
76
|
-
|
|
112
|
+
- `configs.get`
|
|
113
|
+
- `configs.reconfig`
|