agent-valley 4.3.0 → 4.5.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
@@ -194,6 +196,9 @@ linear:
194
196
  # in_progress: valley:wip
195
197
  # done: valley:done
196
198
  # cancelled: valley:cancelled
199
+ # comment_relay:
200
+ # enabled: false
201
+ # ignore_authors: []
197
202
 
198
203
  workspace:
199
204
  root: /absolute/path/to/target-repo
@@ -391,6 +396,10 @@ PixiJS-rendered office scene showing real-time actor status:
391
396
 
392
397
  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.
393
398
 
399
+ ### Comment relay
400
+
401
+ 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
+
394
403
  ### Observability (v0.2+)
395
404
 
396
405
  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:
@@ -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.3.0",
4
+ "version": "4.5.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
@@ -15187,6 +15187,7 @@ function mergeConfigs(global2, project, env) {
15187
15187
  cancelled: project?.linear?.workflow_states?.cancelled ?? ""
15188
15188
  },
15189
15189
  github: githubMerged,
15190
+ commentRelay: resolveCommentRelay(trackerKind === "github" ? project?.github?.comment_relay : project?.linear?.comment_relay),
15190
15191
  workspaceRoot: project?.workspace?.root ?? "",
15191
15192
  agentType: projectActor?.type ?? globalActor?.type ?? defaults.agentType,
15192
15193
  agentTimeout: projectActor?.timeout ?? globalActor?.timeout ?? defaults.agentTimeout,
@@ -15253,7 +15254,10 @@ Symphony cannot start until all config errors are resolved.`);
15253
15254
  process.exit(1);
15254
15255
  }
15255
15256
  }
15256
- var globalConfigSchema, projectConfigSchema, githubConfigSchema, mergedConfigSchema;
15257
+ function resolveCommentRelay(relay) {
15258
+ return { enabled: relay?.enabled ?? false, ignoreAuthors: relay?.ignore_authors ?? [] };
15259
+ }
15260
+ var globalConfigSchema, commentRelayProjectSchema, projectConfigSchema, githubConfigSchema, mergedConfigSchema;
15257
15261
  var init_yaml_loader = __esm(() => {
15258
15262
  init_zod();
15259
15263
  init_skill_matrix_schema();
@@ -15284,6 +15288,10 @@ var init_yaml_loader = __esm(() => {
15284
15288
  }).optional(),
15285
15289
  team: teamConfigSchema.optional()
15286
15290
  }).strict().overwrite(normalizeActorDefaults);
15291
+ commentRelayProjectSchema = object({
15292
+ enabled: boolean2().optional(),
15293
+ ignore_authors: array(string2().min(1)).optional()
15294
+ });
15287
15295
  projectConfigSchema = object({
15288
15296
  tracker: object({
15289
15297
  kind: _enum(["linear", "github"]).optional()
@@ -15298,7 +15306,8 @@ var init_yaml_loader = __esm(() => {
15298
15306
  in_progress: string2().min(1).optional(),
15299
15307
  done: string2().min(1).optional(),
15300
15308
  cancelled: string2().min(1).optional()
15301
- }).optional()
15309
+ }).optional(),
15310
+ comment_relay: commentRelayProjectSchema.optional()
15302
15311
  }).optional(),
15303
15312
  github: object({
15304
15313
  token_env: string2().min(1).optional(),
@@ -15310,7 +15319,8 @@ var init_yaml_loader = __esm(() => {
15310
15319
  in_progress: string2().min(1).optional(),
15311
15320
  done: string2().min(1).optional(),
15312
15321
  cancelled: string2().min(1).optional()
15313
- }).optional()
15322
+ }).optional(),
15323
+ comment_relay: commentRelayProjectSchema.optional()
15314
15324
  }).optional(),
15315
15325
  workspace: object({
15316
15326
  root: string2().min(1).optional()
@@ -15377,6 +15387,10 @@ var init_yaml_loader = __esm(() => {
15377
15387
  cancelled: string2()
15378
15388
  }),
15379
15389
  github: githubConfigSchema.optional(),
15390
+ commentRelay: object({
15391
+ enabled: boolean2(),
15392
+ ignoreAuthors: array(string2())
15393
+ }).optional(),
15380
15394
  workspaceRoot: string2().min(1, `workspace.root is not set.
15381
15395
  Fix: Add workspace.root to av.yaml`).refine((v) => v.startsWith("/"), `workspace.root must be an absolute path.
15382
15396
  Fix: Set workspace.root: /absolute/path in av.yaml`),
@@ -15187,6 +15187,7 @@ function mergeConfigs(global, project, env) {
15187
15187
  cancelled: project?.linear?.workflow_states?.cancelled ?? ""
15188
15188
  },
15189
15189
  github: githubMerged,
15190
+ commentRelay: resolveCommentRelay(trackerKind === "github" ? project?.github?.comment_relay : project?.linear?.comment_relay),
15190
15191
  workspaceRoot: project?.workspace?.root ?? "",
15191
15192
  agentType: projectActor?.type ?? globalActor?.type ?? defaults.agentType,
15192
15193
  agentTimeout: projectActor?.timeout ?? globalActor?.timeout ?? defaults.agentTimeout,
@@ -15253,7 +15254,10 @@ Symphony cannot start until all config errors are resolved.`);
15253
15254
  process.exit(1);
15254
15255
  }
15255
15256
  }
15256
- var globalConfigSchema, projectConfigSchema, githubConfigSchema, mergedConfigSchema;
15257
+ function resolveCommentRelay(relay) {
15258
+ return { enabled: relay?.enabled ?? false, ignoreAuthors: relay?.ignore_authors ?? [] };
15259
+ }
15260
+ var globalConfigSchema, commentRelayProjectSchema, projectConfigSchema, githubConfigSchema, mergedConfigSchema;
15257
15261
  var init_yaml_loader = __esm(() => {
15258
15262
  init_zod();
15259
15263
  init_skill_matrix_schema();
@@ -15284,6 +15288,10 @@ var init_yaml_loader = __esm(() => {
15284
15288
  }).optional(),
15285
15289
  team: teamConfigSchema.optional()
15286
15290
  }).strict().overwrite(normalizeActorDefaults);
15291
+ commentRelayProjectSchema = object({
15292
+ enabled: boolean2().optional(),
15293
+ ignore_authors: array(string2().min(1)).optional()
15294
+ });
15287
15295
  projectConfigSchema = object({
15288
15296
  tracker: object({
15289
15297
  kind: _enum(["linear", "github"]).optional()
@@ -15298,7 +15306,8 @@ var init_yaml_loader = __esm(() => {
15298
15306
  in_progress: string2().min(1).optional(),
15299
15307
  done: string2().min(1).optional(),
15300
15308
  cancelled: string2().min(1).optional()
15301
- }).optional()
15309
+ }).optional(),
15310
+ comment_relay: commentRelayProjectSchema.optional()
15302
15311
  }).optional(),
15303
15312
  github: object({
15304
15313
  token_env: string2().min(1).optional(),
@@ -15310,7 +15319,8 @@ var init_yaml_loader = __esm(() => {
15310
15319
  in_progress: string2().min(1).optional(),
15311
15320
  done: string2().min(1).optional(),
15312
15321
  cancelled: string2().min(1).optional()
15313
- }).optional()
15322
+ }).optional(),
15323
+ comment_relay: commentRelayProjectSchema.optional()
15314
15324
  }).optional(),
15315
15325
  workspace: object({
15316
15326
  root: string2().min(1).optional()
@@ -15377,6 +15387,10 @@ var init_yaml_loader = __esm(() => {
15377
15387
  cancelled: string2()
15378
15388
  }),
15379
15389
  github: githubConfigSchema.optional(),
15390
+ commentRelay: object({
15391
+ enabled: boolean2(),
15392
+ ignoreAuthors: array(string2())
15393
+ }).optional(),
15380
15394
  workspaceRoot: string2().min(1, `workspace.root is not set.
15381
15395
  Fix: Add workspace.root to av.yaml`).refine((v) => v.startsWith("/"), `workspace.root must be an absolute path.
15382
15396
  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.3.0",
3
+ "version": "4.5.0",
4
4
  "type": "module",
5
5
  "engines": {
6
6
  "node": ">=26.10.0",