agent-conveyor 0.1.20 → 0.1.21
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/package.json
CHANGED
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-conveyor",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.21",
|
|
4
4
|
"description": "Codex operator skills for Agent Conveyor manager-worker setup.",
|
|
5
5
|
"skills": [
|
|
6
6
|
"conveyor-create-pair",
|
|
7
7
|
"conveyor-create-worker-set",
|
|
8
|
-
"conveyor-check-status"
|
|
8
|
+
"conveyor-check-status",
|
|
9
|
+
"conveyor-whats-next-nudger"
|
|
9
10
|
],
|
|
10
11
|
"requires": {
|
|
11
12
|
"npmPackage": "agent-conveyor",
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: conveyor-whats-next-nudger
|
|
3
|
+
description: Run a bounded Agent Conveyor "what's next?" nudger loop for an existing Codex app manager/worker pair or worker set.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Conveyor What's Next Nudger
|
|
7
|
+
|
|
8
|
+
Use this skill when the operator wants an existing Agent Conveyor Codex app
|
|
9
|
+
manager/worker pair or worker set to continue through a bounded number of
|
|
10
|
+
manager-approved follow-up passes. This skill does not create sessions, publish,
|
|
11
|
+
schedule, push, open PRs, merge, or archive workers unless the operator
|
|
12
|
+
explicitly grants that separate authority.
|
|
13
|
+
|
|
14
|
+
## Rules
|
|
15
|
+
|
|
16
|
+
- Operator-facing only.
|
|
17
|
+
- Codex app native sessions only.
|
|
18
|
+
- Use `.codex-workers/workerctl.db` under the current project unless the
|
|
19
|
+
operator explicitly gives another path.
|
|
20
|
+
- Require a bounded loop count before continuing; default to 1 extra pass if
|
|
21
|
+
the operator says "one more" and 2 passes if the operator gives no count.
|
|
22
|
+
- Treat worker "done" and "what's next" suggestions as claims until the
|
|
23
|
+
manager verifies receipts.
|
|
24
|
+
- Continue only when the manager records concrete evidence and the proposed
|
|
25
|
+
next slice is in scope, reversible, and consistent with current authority.
|
|
26
|
+
- Keep manager closeout/control-plane proof out of worker acceptance criteria;
|
|
27
|
+
use it in the manager final report instead.
|
|
28
|
+
- Do not inspect private content, publish externally, or perform repo shipping
|
|
29
|
+
actions unless the existing task policy explicitly permits the narrow action.
|
|
30
|
+
- Keep visible Codex session sections for consumed work:
|
|
31
|
+
`CONVEYOR POLL`, `CONVEYOR RECEIVED`, `WORK`, `CONVEYOR SEND`, `DISPATCH`.
|
|
32
|
+
|
|
33
|
+
## Default Ledger
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
mkdir -p .codex-workers
|
|
37
|
+
LEDGER="$PWD/.codex-workers/workerctl.db"
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Operator Flow
|
|
41
|
+
|
|
42
|
+
1. Identify the task or campaign. If the task is unknown, list candidates:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
conveyor tasks --path "$LEDGER" --json
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
2. Inspect current status before nudging:
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
TASK="example-task"
|
|
52
|
+
conveyor app-loop-status "$TASK" --path "$LEDGER" --json
|
|
53
|
+
conveyor loop-status "$TASK" --path "$LEDGER" --json
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
3. Ask the manager, not the worker directly, to evaluate the completed pass and
|
|
57
|
+
choose one of:
|
|
58
|
+
- stop with verified evidence;
|
|
59
|
+
- request a narrow revision;
|
|
60
|
+
- ask the worker "what's next?" and continue for one bounded pass.
|
|
61
|
+
|
|
62
|
+
Use the manager's inbox or visible app wake path for the existing setup. If the
|
|
63
|
+
setup exposes `app-wakeup-plan` or `app-wakeup-dispatch`, prefer that prepared
|
|
64
|
+
wake path over ad hoc direct prompts:
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
conveyor app-wakeup-plan "$TASK" --path "$LEDGER" --json
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
4. When the manager approves another pass, queue exactly one continuation or
|
|
71
|
+
worker nudge with a narrow instruction and an iteration budget. Prefer loop
|
|
72
|
+
continuation for Ralph-loop tasks:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
RUN="loop-run-id-from-loop-status"
|
|
76
|
+
NEXT_ITERATION="2"
|
|
77
|
+
conveyor enqueue-continue-iteration "$TASK" \
|
|
78
|
+
--loop-run "$RUN" \
|
|
79
|
+
--requested-iteration "$NEXT_ITERATION" \
|
|
80
|
+
--message "Manager approved one more pass. Before acting, print visible CONVEYOR sections, summarize the verified prior evidence, propose the next narrow slice, do the work only if in scope, then notify the manager with receipts." \
|
|
81
|
+
--path "$LEDGER" \
|
|
82
|
+
--json
|
|
83
|
+
conveyor dispatch --watch --watch-iterations 1 --interval 2 \
|
|
84
|
+
--dispatcher-id dispatch-local \
|
|
85
|
+
--path "$LEDGER" \
|
|
86
|
+
--json
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
If the task is not a Ralph loop, use the existing setup's generated
|
|
90
|
+
`enqueue-nudge-worker` or manager-approved assignment command instead. Do not
|
|
91
|
+
invent new shipping authority.
|
|
92
|
+
|
|
93
|
+
5. After each worker pass, require all of:
|
|
94
|
+
- durable worker-to-manager notification receipt;
|
|
95
|
+
- one Dispatch receipt routing that notification;
|
|
96
|
+
- manager verification of artifacts, tests, screenshots, dashboard records,
|
|
97
|
+
or other task-specific evidence;
|
|
98
|
+
- explicit manager decision: continue, revise, stop, or block.
|
|
99
|
+
|
|
100
|
+
6. Stop when the bounded pass count is exhausted, evidence is insufficient, the
|
|
101
|
+
next proposed slice is out of scope, or the manager recommends stopping.
|
|
102
|
+
Report a compact receipt with task, ledger, passes used, manager decision,
|
|
103
|
+
evidence checked, blockers, and the exact next action.
|
|
104
|
+
|
|
105
|
+
## Final Receipt
|
|
106
|
+
|
|
107
|
+
End with:
|
|
108
|
+
|
|
109
|
+
- `task`
|
|
110
|
+
- `ledger`
|
|
111
|
+
- `passes_requested`
|
|
112
|
+
- `passes_completed`
|
|
113
|
+
- `manager_decision`
|
|
114
|
+
- `evidence_checked`
|
|
115
|
+
- `blockers`
|
|
116
|
+
- `next_action`
|