agent-valley 4.5.0 → 4.7.0
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 +12 -0
- package/dist/assets/plugin.json +1 -1
- package/dist/index.js +2167 -944
- package/dist/supervisor.js +68 -16
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -205,6 +205,10 @@ workspace:
|
|
|
205
205
|
|
|
206
206
|
delivery:
|
|
207
207
|
mode: merge # merge (auto merge+push) or pr (create draft PR)
|
|
208
|
+
# pull_request_reviews:
|
|
209
|
+
# enabled: false
|
|
210
|
+
# webhook_secret: whsec_xxx # Linear tracker only; the GitHub tracker uses github.webhook_secret
|
|
211
|
+
# ignore_authors: []
|
|
208
212
|
|
|
209
213
|
prompt: |
|
|
210
214
|
You are working on {{issue.identifier}}: {{issue.title}}.
|
|
@@ -400,6 +404,10 @@ Alongside Linear, GitHub Issues can drive the orchestrator. Set `tracker.kind: g
|
|
|
400
404
|
|
|
401
405
|
With `comment_relay.enabled: true` under the active tracker (`github:` or `linear:`), a new comment on an issue whose actor is running reaches that actor as an added instruction. GitHub relays repository owners, members and collaborators and needs the webhook subscribed to **Issue comments**; Linear relays workspace users (members and guests) and needs **Comment** events. Codex receives the comment in the running session; stateless actors such as Claude restart the attempt with it. Agent Valley's own comments (its hidden marker or the `Symphony:` prefix), bots and integrations, outside contributors, `ignore_authors`, edited or deleted comments and pull request comments are not relayed. `ignore_authors` accepts GitHub logins and Linear emails, user ids or names; add the account actors comment with when it is a person's token.
|
|
402
406
|
|
|
407
|
+
### Pull request review follow-up
|
|
408
|
+
|
|
409
|
+
PR delivery mode can answer review feedback whichever service tracks the issues. With `delivery.pull_request_reviews.enabled: true`, a submitted review of an open pull request on an Agent Valley branch becomes follow-up work for the issue in the branch name (`feature/ACR-42` → Linear `ACR-42`, `feature/my-org/my-repo#42` → GitHub issue #42). Issues and code can live in different places: Linear issues with GitHub pull requests, or GitHub issues in one repository delivered to another. Point a GitHub webhook on each code repository at `/api/webhook/github` with **Pull request reviews**; on repositories other than the GitHub tracker's, send only that event. With the GitHub tracker the endpoint verifies `github.webhook_secret`, so every webhook uses that secret; with Linear, set `delivery.pull_request_reviews.webhook_secret`. Repository owners, members and collaborators count; approvals, bots, `ignore_authors` (GitHub logins), fork branches and closed pull requests are skipped. The review summary and its inline comments, read through the authenticated `gh` CLI that PR delivery already uses, become the instruction. A running actor receives it like a relayed comment. A delivered (Done) issue is moved back to In Progress and retried with the review as context in its existing worktree, after the retry delay; delivery then pushes to the same pull request.
|
|
410
|
+
|
|
403
411
|
### Observability (v0.2+)
|
|
404
412
|
|
|
405
413
|
OpenTelemetry OTLP HTTP traces and Prometheus metrics ship built in but **default to off**. Enable per deployment via the `observability` section in `av.yaml`. When enabled:
|
|
@@ -440,6 +448,10 @@ Failed actor runs are retried with exponential backoff (`60s × 2^(attempt-1)`,
|
|
|
440
448
|
|
|
441
449
|
On boot, the orchestrator fetches all Todo + In Progress issues from the configured tracker and reconciles the DAG cache. Existing in-progress issues resume automatically.
|
|
442
450
|
|
|
451
|
+
### Durable State
|
|
452
|
+
|
|
453
|
+
Everything the orchestrator must remember across a restart lives in one SQLite file, `.agent-valley/state.db` inside the workspace root: active attempts, the retry queue, pending finalizations, the DAG cache, budget usage and webhook delivery keys. Each store writes in a transaction, so a crash never leaves a half-written record, and a tracker redelivery after a restart is still rejected. The first boot after upgrading imports the earlier `run-state.json`, `dag-cache.json` and `budget-usage.json` snapshots and renames them `*.migrated`.
|
|
454
|
+
|
|
443
455
|
---
|
|
444
456
|
|
|
445
457
|
## Development
|
package/dist/assets/plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
|
|
3
3
|
"name": "av",
|
|
4
|
-
"version": "4.
|
|
4
|
+
"version": "4.7.0",
|
|
5
5
|
"description": "Delegate repository goals to Agent Valley and inspect mission progress and verification evidence.",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "Agent Valley"
|