agent-valley 4.4.0 → 4.6.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 CHANGED
@@ -182,7 +182,9 @@ linear:
182
182
  in_progress: state-uuid
183
183
  done: state-uuid
184
184
  cancelled: state-uuid
185
-
185
+ # comment_relay:
186
+ # enabled: false
187
+ # ignore_authors: []
186
188
  # GitHub tracker (v0.2+) — used when tracker.kind = github.
187
189
  # github:
188
190
  # token_env: GITHUB_TOKEN
@@ -197,6 +199,7 @@ linear:
197
199
  # comment_relay:
198
200
  # enabled: false
199
201
  # ignore_authors: []
202
+ # pull_request_reviews: false
200
203
 
201
204
  workspace:
202
205
  root: /absolute/path/to/target-repo
@@ -394,7 +397,11 @@ PixiJS-rendered office scene showing real-time actor status:
394
397
 
395
398
  Alongside Linear, GitHub Issues can drive the orchestrator. Set `tracker.kind: github` in `av.yaml` and configure the GitHub section — the domain `IssueTracker` / `WebhookReceiver` ports swap transparently. Both trackers reuse the same orchestration, retry, and delivery pipeline.
396
399
 
397
- With `github.comment_relay.enabled: true` and the webhook subscribed to **Issue comments**, a new comment from a repository owner, member or collaborator on an issue whose actor is running reaches that actor as an added instruction. Codex receives it in the running session; stateless actors such as Claude restart the attempt with the comment. Agent Valley's own comments, bot accounts, outside contributors, `ignore_authors`, edited comments and pull request comments are not relayed. Add the account behind `GITHUB_TOKEN` to `ignore_authors` when actors comment with it.
400
+ ### Comment relay
401
+
402
+ 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.
403
+
404
+ With `pull_request_reviews: true` as well (GitHub tracker only), a submitted review of an open pull request on an Agent Valley branch (`<prefix>/<owner>/<repo>#<issue>`) becomes follow-up work, so PR delivery mode can answer review feedback. The webhook must also send **Pull request reviews**. The same author rules apply, approvals are skipped, and the review summary and its inline comments become the instruction. A running actor receives it like a relayed comment. A delivered issue (Done) is reopened to In Progress and retried with the review as context in the existing worktree; delivery then pushes to the same pull request. Reviews of fork branches, closed pull requests and other branches are ignored. A Linear tracker cannot follow up on GitHub reviews because it has no GitHub webhook receiver.
398
405
 
399
406
  ### Observability (v0.2+)
400
407
 
@@ -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.0",
4
+ "version": "4.6.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"
package/dist/index.js CHANGED
@@ -7900,6 +7900,31 @@ var init_chief_schema = __esm(() => {
7900
7900
  });
7901
7901
  });
7902
7902
 
7903
+ // ../../packages/core/src/config/comment-relay-schema.ts
7904
+ function buildCommentRelayConfig(relay) {
7905
+ return {
7906
+ enabled: relay?.enabled ?? false,
7907
+ ignoreAuthors: relay?.ignore_authors ?? [],
7908
+ pullRequestReviews: relay?.pull_request_reviews ?? false
7909
+ };
7910
+ }
7911
+ var commentRelayProjectSchema, githubCommentRelayProjectSchema, commentRelayMergedSchema;
7912
+ var init_comment_relay_schema = __esm(() => {
7913
+ init_zod();
7914
+ commentRelayProjectSchema = object({
7915
+ enabled: boolean2().optional(),
7916
+ ignore_authors: array(string2().min(1)).optional()
7917
+ });
7918
+ githubCommentRelayProjectSchema = commentRelayProjectSchema.extend({
7919
+ pull_request_reviews: boolean2().optional()
7920
+ });
7921
+ commentRelayMergedSchema = object({
7922
+ enabled: boolean2(),
7923
+ ignoreAuthors: array(string2()),
7924
+ pullRequestReviews: boolean2()
7925
+ }).optional();
7926
+ });
7927
+
7903
7928
  // ../../packages/core/src/config/hardware.ts
7904
7929
  import { cpus, totalmem } from "node:os";
7905
7930
  function detectHardware() {
@@ -15170,11 +15195,7 @@ function mergeConfigs(global2, project, env) {
15170
15195
  owner: project.github.owner ?? "",
15171
15196
  repo: project.github.repo ?? "",
15172
15197
  webhookSecret: project.github.webhook_secret ?? "",
15173
- labels,
15174
- commentRelay: {
15175
- enabled: project.github.comment_relay?.enabled ?? false,
15176
- ignoreAuthors: project.github.comment_relay?.ignore_authors ?? []
15177
- }
15198
+ labels
15178
15199
  };
15179
15200
  githubWorkflowStates = labels;
15180
15201
  }
@@ -15191,6 +15212,7 @@ function mergeConfigs(global2, project, env) {
15191
15212
  cancelled: project?.linear?.workflow_states?.cancelled ?? ""
15192
15213
  },
15193
15214
  github: githubMerged,
15215
+ commentRelay: buildCommentRelayConfig(trackerKind === "github" ? project?.github?.comment_relay : project?.linear?.comment_relay),
15194
15216
  workspaceRoot: project?.workspace?.root ?? "",
15195
15217
  agentType: projectActor?.type ?? globalActor?.type ?? defaults.agentType,
15196
15218
  agentTimeout: projectActor?.timeout ?? globalActor?.timeout ?? defaults.agentTimeout,
@@ -15264,6 +15286,7 @@ var init_yaml_loader = __esm(() => {
15264
15286
  init_actor_schema();
15265
15287
  init_budget_schema();
15266
15288
  init_chief_schema();
15289
+ init_comment_relay_schema();
15267
15290
  init_hardware();
15268
15291
  init_observability_schema();
15269
15292
  init_project_config_path();
@@ -15302,7 +15325,8 @@ var init_yaml_loader = __esm(() => {
15302
15325
  in_progress: string2().min(1).optional(),
15303
15326
  done: string2().min(1).optional(),
15304
15327
  cancelled: string2().min(1).optional()
15305
- }).optional()
15328
+ }).optional(),
15329
+ comment_relay: commentRelayProjectSchema.optional()
15306
15330
  }).optional(),
15307
15331
  github: object({
15308
15332
  token_env: string2().min(1).optional(),
@@ -15315,10 +15339,7 @@ var init_yaml_loader = __esm(() => {
15315
15339
  done: string2().min(1).optional(),
15316
15340
  cancelled: string2().min(1).optional()
15317
15341
  }).optional(),
15318
- comment_relay: object({
15319
- enabled: boolean2().optional(),
15320
- ignore_authors: array(string2().min(1)).optional()
15321
- }).optional()
15342
+ comment_relay: githubCommentRelayProjectSchema.optional()
15322
15343
  }).optional(),
15323
15344
  workspace: object({
15324
15345
  root: string2().min(1).optional()
@@ -15370,11 +15391,7 @@ var init_yaml_loader = __esm(() => {
15370
15391
  Fix: Add it to av.yaml`),
15371
15392
  cancelled: string2().min(1, `github.labels.cancelled is not set.
15372
15393
  Fix: Add it to av.yaml`)
15373
- }),
15374
- commentRelay: object({
15375
- enabled: boolean2(),
15376
- ignoreAuthors: array(string2())
15377
- }).optional()
15394
+ })
15378
15395
  });
15379
15396
  mergedConfigSchema = object({
15380
15397
  trackerKind: _enum(["linear", "github"]),
@@ -15389,6 +15406,7 @@ var init_yaml_loader = __esm(() => {
15389
15406
  cancelled: string2()
15390
15407
  }),
15391
15408
  github: githubConfigSchema.optional(),
15409
+ commentRelay: commentRelayMergedSchema,
15392
15410
  workspaceRoot: string2().min(1, `workspace.root is not set.
15393
15411
  Fix: Add workspace.root to av.yaml`).refine((v) => v.startsWith("/"), `workspace.root must be an absolute path.
15394
15412
  Fix: Set workspace.root: /absolute/path in av.yaml`),
@@ -7892,6 +7892,31 @@ var init_chief_schema = __esm(() => {
7892
7892
  });
7893
7893
  });
7894
7894
 
7895
+ // ../../packages/core/src/config/comment-relay-schema.ts
7896
+ function buildCommentRelayConfig(relay) {
7897
+ return {
7898
+ enabled: relay?.enabled ?? false,
7899
+ ignoreAuthors: relay?.ignore_authors ?? [],
7900
+ pullRequestReviews: relay?.pull_request_reviews ?? false
7901
+ };
7902
+ }
7903
+ var commentRelayProjectSchema, githubCommentRelayProjectSchema, commentRelayMergedSchema;
7904
+ var init_comment_relay_schema = __esm(() => {
7905
+ init_zod();
7906
+ commentRelayProjectSchema = object({
7907
+ enabled: boolean2().optional(),
7908
+ ignore_authors: array(string2().min(1)).optional()
7909
+ });
7910
+ githubCommentRelayProjectSchema = commentRelayProjectSchema.extend({
7911
+ pull_request_reviews: boolean2().optional()
7912
+ });
7913
+ commentRelayMergedSchema = object({
7914
+ enabled: boolean2(),
7915
+ ignoreAuthors: array(string2()),
7916
+ pullRequestReviews: boolean2()
7917
+ }).optional();
7918
+ });
7919
+
7895
7920
  // ../../packages/core/src/config/hardware.ts
7896
7921
  import { cpus, totalmem } from "node:os";
7897
7922
  function detectHardware() {
@@ -15170,11 +15195,7 @@ function mergeConfigs(global, project, env) {
15170
15195
  owner: project.github.owner ?? "",
15171
15196
  repo: project.github.repo ?? "",
15172
15197
  webhookSecret: project.github.webhook_secret ?? "",
15173
- labels,
15174
- commentRelay: {
15175
- enabled: project.github.comment_relay?.enabled ?? false,
15176
- ignoreAuthors: project.github.comment_relay?.ignore_authors ?? []
15177
- }
15198
+ labels
15178
15199
  };
15179
15200
  githubWorkflowStates = labels;
15180
15201
  }
@@ -15191,6 +15212,7 @@ function mergeConfigs(global, project, env) {
15191
15212
  cancelled: project?.linear?.workflow_states?.cancelled ?? ""
15192
15213
  },
15193
15214
  github: githubMerged,
15215
+ commentRelay: buildCommentRelayConfig(trackerKind === "github" ? project?.github?.comment_relay : project?.linear?.comment_relay),
15194
15216
  workspaceRoot: project?.workspace?.root ?? "",
15195
15217
  agentType: projectActor?.type ?? globalActor?.type ?? defaults.agentType,
15196
15218
  agentTimeout: projectActor?.timeout ?? globalActor?.timeout ?? defaults.agentTimeout,
@@ -15264,6 +15286,7 @@ var init_yaml_loader = __esm(() => {
15264
15286
  init_actor_schema();
15265
15287
  init_budget_schema();
15266
15288
  init_chief_schema();
15289
+ init_comment_relay_schema();
15267
15290
  init_hardware();
15268
15291
  init_observability_schema();
15269
15292
  init_project_config_path();
@@ -15302,7 +15325,8 @@ var init_yaml_loader = __esm(() => {
15302
15325
  in_progress: string2().min(1).optional(),
15303
15326
  done: string2().min(1).optional(),
15304
15327
  cancelled: string2().min(1).optional()
15305
- }).optional()
15328
+ }).optional(),
15329
+ comment_relay: commentRelayProjectSchema.optional()
15306
15330
  }).optional(),
15307
15331
  github: object({
15308
15332
  token_env: string2().min(1).optional(),
@@ -15315,10 +15339,7 @@ var init_yaml_loader = __esm(() => {
15315
15339
  done: string2().min(1).optional(),
15316
15340
  cancelled: string2().min(1).optional()
15317
15341
  }).optional(),
15318
- comment_relay: object({
15319
- enabled: boolean2().optional(),
15320
- ignore_authors: array(string2().min(1)).optional()
15321
- }).optional()
15342
+ comment_relay: githubCommentRelayProjectSchema.optional()
15322
15343
  }).optional(),
15323
15344
  workspace: object({
15324
15345
  root: string2().min(1).optional()
@@ -15370,11 +15391,7 @@ var init_yaml_loader = __esm(() => {
15370
15391
  Fix: Add it to av.yaml`),
15371
15392
  cancelled: string2().min(1, `github.labels.cancelled is not set.
15372
15393
  Fix: Add it to av.yaml`)
15373
- }),
15374
- commentRelay: object({
15375
- enabled: boolean2(),
15376
- ignoreAuthors: array(string2())
15377
- }).optional()
15394
+ })
15378
15395
  });
15379
15396
  mergedConfigSchema = object({
15380
15397
  trackerKind: _enum(["linear", "github"]),
@@ -15389,6 +15406,7 @@ var init_yaml_loader = __esm(() => {
15389
15406
  cancelled: string2()
15390
15407
  }),
15391
15408
  github: githubConfigSchema.optional(),
15409
+ commentRelay: commentRelayMergedSchema,
15392
15410
  workspaceRoot: string2().min(1, `workspace.root is not set.
15393
15411
  Fix: Add workspace.root to av.yaml`).refine((v) => v.startsWith("/"), `workspace.root must be an absolute path.
15394
15412
  Fix: Set workspace.root: /absolute/path in av.yaml`),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-valley",
3
- "version": "4.4.0",
3
+ "version": "4.6.0",
4
4
  "type": "module",
5
5
  "engines": {
6
6
  "node": ">=26.10.0",