agents-relay 2.0.256 → 2.0.257

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.
Files changed (39) hide show
  1. package/README.md +26 -13
  2. package/dist/agent-script-discovery.js +56 -0
  3. package/dist/cli-coordinator.js +71 -0
  4. package/dist/cli-help.js +36 -30
  5. package/dist/cli-job-create.js +37 -4
  6. package/dist/cli.js +21 -12
  7. package/dist/dag-result-contract.js +2 -2
  8. package/dist/{shortcut-stage-contract.js → dag-stage-contract.js} +1 -1
  9. package/dist/dag-task-runtime.js +4 -33
  10. package/dist/dashboard-jel.js +8 -12
  11. package/dist/job-execution-slot.js +3 -11
  12. package/dist/pool.js +2 -13
  13. package/dist/reconciler.js +5 -28
  14. package/dist/relay-job-snapshot-reads.js +2 -5
  15. package/dist/relay-workflow-operations.js +2 -3
  16. package/dist/relayd-control.js +5 -0
  17. package/dist/relayd.js +1 -3
  18. package/dist/runtime-status.js +0 -33
  19. package/dist/script-task-adapter.js +2 -2
  20. package/dist/task-inactivity-watchdog.js +3 -6
  21. package/dist/worker-failure-recovery.js +1 -1
  22. package/dist/workflow/action-ledger.js +1 -1
  23. package/dist/workflow/contracts.js +0 -28
  24. package/dist/workflow/definitions-v2.js +1 -8
  25. package/dist/workflow/runtime.js +0 -9
  26. package/package.json +6 -6
  27. package/skills/agents-relay/SKILL.md +41 -20
  28. package/skills/agents-relay/contracts/event-contract.md +4 -5
  29. package/skills/agents-relay/contracts/task-job-contract.md +35 -1
  30. package/workflow/job-lifecycle.mmd +0 -8
  31. package/workflow/task-lifecycle.mmd +1 -26
  32. package/dist/agent-shortcut.js +0 -587
  33. package/dist/cli-shortcut-local.js +0 -50
  34. package/dist/cli-shortcut.js +0 -267
  35. package/dist/reconciler-shortcut.js +0 -74
  36. package/dist/shortcut-node-revision.js +0 -21
  37. package/dist/shortcut-node-worker.js +0 -144
  38. package/dist/shortcut-review-wake.js +0 -64
  39. package/dist/shortcut-worker-runner.js +0 -64
@@ -55,12 +55,11 @@ waiting/terminal event on behalf of its host. An inbox acknowledgement is not
55
55
  approval. No Git commit, content snapshot or SHA is required for human Review.
56
56
 
57
57
  For new DAG executions, the Coordinator creates normal Agent Tasks; a review
58
- belongs to the corresponding Agent child, not the Coordinator. The ordinary
59
- Reconciler (not the external Shortcut start CLI) schedules their retries and
60
- revisions. A Script Task on `changes_requested` may use its own Agent Model
58
+ belongs to the corresponding Agent child, not the Coordinator. The ordinary Reconciler schedules their retries and revisions and
59
+ immediately dispatches dependency-ready successors after terminal events
60
+ when capacity is available. A Script Task on `changes_requested` may use its own Agent Model
61
61
  executor in a **new execution of that same Task**; after a fresh approval,
62
- Script verifies the revised artifacts. Legacy running Shortcut checkpoints
63
- retain the earlier foreground-runner resume behavior until completion.
62
+ Script verifies the revised artifacts. No direct Shortcut Runner or special execution-mode receipt path remains.
64
63
 
65
64
  The Job stays ACTIVE; the Task does not requeue until a matching
66
65
  `task.interactive_decision` is durably accepted and the Task Graph selects
@@ -42,6 +42,30 @@ Each dependency edge may also declare `dependencyValidity`: `order-only` (the de
42
42
 
43
43
  A later Planner round must inspect the existing semantic tree and attach review, revision, re-review, validation rerun, release correction, or recovery work to the existing artifact subtree. Independent milestones remain roots. `plan-N` records are provenance/history and must never be semantic parents. Existing terminal Tasks remain immutable historical evidence and may continue to own later work.
44
44
 
45
+ ### Declarative Agent DAG and Coordinator ownership
46
+
47
+ For an executable `agentGraph`, create the Job and its Coordinator Task
48
+ atomically through `job create --coordinator-graph-file ...` (with input,
49
+ output, project/workspace paths); activate it with
50
+ `job run --id JOB --task-id coordinator`. This is an alternative to an
51
+ initial Planner, **not** a separate Job mode or nested runner.
52
+
53
+ The Coordinator stays durable and does not consume a Worker lease. Each graph
54
+ node materializes as an independently durable Agent Task, with its own
55
+ `parentTaskId`, dependency edges, execution identity, standard retry and
56
+ human review. Its Script or Model executor follows the same Task lifecycle.
57
+ On accepted terminal completion the local Job Reconciler immediately
58
+ considers newly ready dependent nodes, launching independent branches in
59
+ parallel when global capacity permits. `QUEUED` is a persisted recovery and
60
+ capacity boundary, not a reason to wait for the next global scan.
61
+
62
+ `Request Changes` on an Agent's human Preview requeues the **same Agent Task**
63
+ with feedback, not a fresh revision Task. The Task's new execution can use a
64
+ Model executor for edits and return to Script for validation. A Task cannot
65
+ claim success from a preview-delivery acknowledgement or a process exit.
66
+ The normal Job Final Review and Git Merge are unchanged by Coordinator
67
+ creation and run independently of whether a Planner was needed initially.
68
+
45
69
  ### Task input vs result
46
70
 
47
71
  A Task input records **what is known and what has already been decided before execution**. A Task result records **what execution discovered and what was actually done**.
@@ -165,7 +189,17 @@ A newly created zero-task DRAFT Job waits for explicit initial planning (`plan`
165
189
 
166
190
  ## Task evidence and head identity
167
191
 
168
- For Git-versioned Neo Project Interactive Previews, bind a verified full 40-character Git Commit SHA as the sole review revision (`data.interactive.commitSha`, and `data.interactive.revision` must equal it). Compiled media cache hashes, legacy Markcut `revisionId` and `contentHash` must not be used as the Event Review identity. The Producer creates the Stage Commit before requesting Preview; Relay continues to own the decision and Task lifecycle. Generic non-video interactions are not made into Git commits by this contract.
192
+ For a **Job Final Review of committed source**, the existing immutable
193
+ `head_sha` identifies the code target. Do **not** apply that requirement to
194
+ **Agent Task interactive Preview**: `review.preview` uses the current
195
+ `jobId`/`taskId`/`executionId` and the durable Relay decision associated
196
+ with that Task. The task stops awaiting its human decision; a new revision
197
+ may be requested by resuming the same Task with feedback. No Git SHA,
198
+ content snapshot, additional revision Task or automatic Git commit is a
199
+ prerequisite. Git source/version history and the Task's human review event
200
+ history answer different questions. If an Agent chooses to commit a verified
201
+ artifact separately, use a meaningful descriptive Git message; do not use
202
+ review delivery itself to create commits or tags.
169
203
 
170
204
  ### Canonical Neo Project runs boundary
171
205
 
@@ -13,8 +13,6 @@ cancelDraft["action: effect.cancelActiveTasks"]
13
13
  cancelActive["action: effect.cancelActiveTasks"]
14
14
  localCompletionGuard["guard: localCompletionAllowed"]
15
15
  localMergeReadyGuard["guard: localMergeReady"]
16
- shortcutCompletionGuard["guard: shortcutCompletionAllowed"]
17
- contentCompletionGuard["guard: contentCompletionAllowed"]
18
16
  localMergeDelivery["action: effect.deliverLocalMerge"]
19
17
 
20
18
  draft -->|on: activate| active
@@ -30,12 +28,6 @@ cancelActive --> cancelled
30
28
  active -->|on: local.completed| localCompletionGuard
31
29
  localCompletionGuard -->|true| completed
32
30
  localCompletionGuard -->|false| active
33
- active -->|on: content.completed| contentCompletionGuard
34
- contentCompletionGuard -->|true| completed
35
- contentCompletionGuard -->|false| active
36
- active -->|on: shortcut.completed| shortcutCompletionGuard
37
- shortcutCompletionGuard -->|true| completed
38
- shortcutCompletionGuard -->|false| active
39
31
 
40
32
  active -->|on: local.merge.requested| localMergeReadyGuard
41
33
  localMergeReadyGuard -->|true| localMergeDelivery
@@ -24,9 +24,6 @@ depSat["guard: dependenciesSatisfied"]
24
24
  depUnsat["guard: dependenciesUnsatisfied"]
25
25
  runnable["guard: runnable"]
26
26
  dispatchable["guard: dispatchable"]
27
- shortcutExecution["guard: shortcutExecution"]
28
- shortcutHasGraph["guard: shortcutHasGraph"]
29
- shortcutDirectInvocation["guard: shortcutDirectInvocation"]
30
27
  recoverStart["guard: recoverableExecution"]
31
28
  recoverComplete["guard: recoverableExecution"]
32
29
  recoverBlocked["guard: recoverableExecution"]
@@ -37,7 +34,6 @@ recoveryReopenClearError["action: mutation.clearError"]
37
34
  recoveryReopenClearReason["action: mutation.clearFailureReason"]
38
35
  recoveryReopenClearLease["action: mutation.clearLease"]
39
36
  recoveryReopenClearExecution["action: mutation.clearExecution"]
40
- shortcutRecoveryRequired["action: mutation.markShortcutRecoveryRequired"]
41
37
 
42
38
  plannerRetryAvailable["guard: retryAvailable"]
43
39
  platformFallbackSafe["guard: platformFallbackSafe"]
@@ -67,9 +63,6 @@ reconcileDraftClearReason["action: mutation.clearFailureReason"]
67
63
  reconcileQueuedClearError["action: mutation.clearError"]
68
64
  reconcileQueuedClearReason["action: mutation.clearFailureReason"]
69
65
  dispatchLaunch["action: effect.launchTask"]
70
- shortcutLaunch["action: effect.launchShortcut"]
71
- shortcutResultCorrelated["guard: shortcutResultCorrelated"]
72
- shortcutResume["action: effect.resumeShortcut"]
73
66
  startClearError["action: mutation.clearError"]
74
67
  startClearReason["action: mutation.clearFailureReason"]
75
68
  reviewStartClearError["action: mutation.clearError"]
@@ -113,16 +106,9 @@ queued -->|on: reconcile| runnable
113
106
  runnable -->|true| reconcileQueuedClearError
114
107
  reconcileQueuedClearError --> reconcileQueuedClearReason
115
108
  reconcileQueuedClearReason --> queued
116
- queued -->|on: dispatch| shortcutExecution
117
- shortcutExecution -->|true| shortcutHasGraph
118
- shortcutExecution -->|false| dispatchable
119
- shortcutHasGraph -->|true| shortcutDirectInvocation
120
- shortcutDirectInvocation -->|true| shortcutLaunch
121
- shortcutDirectInvocation -->|false| queued
122
- shortcutHasGraph -->|false| queued
109
+ queued -->|on: dispatch| dispatchable
123
110
  dispatchable -->|true| dispatchLaunch
124
111
  dispatchLaunch --> queued
125
- shortcutLaunch --> queued
126
112
  queued -->|on: task.started| startClearError
127
113
  startClearError --> startClearReason
128
114
  startClearReason --> running
@@ -143,7 +129,6 @@ queuedBlockAllowed -->|true| blocked
143
129
  queuedBlockAllowed -->|false| failed
144
130
  queued -->|on: fail| failed
145
131
  queued -->|on: effect.launchTask.failed| failed
146
- queued -->|on: effect.launchShortcut.failed| failed
147
132
  queued -->|on: watchdog.failed| failed
148
133
  queued -->|on: worker.delivery_failed| failed
149
134
  queued -->|on: worker.start_ack_failed| failed
@@ -181,14 +166,6 @@ running -->|on: task.blocked| runningBlockAllowed
181
166
  runningBlockAllowed -->|true| blocked
182
167
  runningBlockAllowed -->|false| failed
183
168
  running -->|on: task.progress| running
184
- running -->|on: shortcut.waiting| shortcutWaitReleaseLease
185
- shortcutWaitReleaseLease["action: mutation.clearLease"]
186
- shortcutWaitReleaseLease --> running
187
- running -->|on: shortcut.result| shortcutResultCorrelated
188
- shortcutResultCorrelated -->|true| shortcutResume
189
- shortcutResultCorrelated -->|false| running
190
- shortcutResume --> running
191
- running -->|on: effect.resumeShortcut.failed| failed
192
169
  running -->|on: review.approved| reviewApproveRunningClearError
193
170
  reviewApproveRunningClearError --> reviewApproveRunningClearReason
194
171
  reviewApproveRunningClearReason --> succeeded
@@ -200,8 +177,6 @@ running -->|on: task.completed| completeClearError
200
177
  completeClearError --> completeClearReason
201
178
  completeClearReason --> succeeded
202
179
  running -->|on: task.failed| failed
203
- running -->|on: shortcut.failed| shortcutRecoveryRequired
204
- shortcutRecoveryRequired --> failed
205
180
  running -->|on: worker.platform_failure| runningPlatformFailureQuarantine
206
181
  runningPlatformFailureQuarantine["action: mutation.quarantinePlatformFailure"]
207
182
  runningPlatformFailureQuarantine --> failed