pi-better-subagents 0.26.2 → 0.27.1

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
@@ -36,12 +36,29 @@ authorized, write the result, and return. Pending CI is a valid handoff, not a p
36
36
  The hook refuses recognized `gh run watch`, `gh pr checks --watch`, and bundled
37
37
  delivery-watcher commands through `bash` and `run_application`. Short status reads,
38
38
  failed-log retrieval, and legitimate long local tests and builds remain allowed.
39
- If background tools are explicitly available to a child, recognized watcher
40
- commands are refused there too. Coordinator sessions are unaffected.
41
-
42
- This is an operational ownership guard, not a security boundary or a classifier
43
- for arbitrary programs. Indirect scripts and custom polling implementations still
44
- rely on the worker handoff contract. Command permissions and timeouts are unchanged.
39
+ Workers retain ownership of their assigned validation. When Background Tasks is
40
+ loaded, default workers receive a guarded bridge to supervised local operations.
41
+ They launch a known long command with `bg_task_spawn`, continue independent work,
42
+ and call `wait_for_operations` when only the operation remains. The worker saves
43
+ the wait result and exits, releasing its capacity slot. Once the operation settles,
44
+ the same conversation resumes to read the evidence, acknowledge its interpretation,
45
+ and finish the assignment. A completed parked attempt does not complete the assignment.
46
+
47
+ When the guarded bridge is unavailable, workers hand back the exact command, cwd,
48
+ required environment variable names (never secret values), current evidence and
49
+ remaining validation. The coordinator runs the command through background tools
50
+ and inspects its terminal result. Shell polling and detachment are not substitutes.
51
+
52
+ Explicit tool exclusions and clean loadouts remain authoritative. The bridge does
53
+ not expand permissions: an operation must satisfy both the captured worker policy
54
+ and the current Background Tasks policy. Parking requires Pi SDK 0.82.1 or later,
55
+ a saved conversation, and a registered continuation adapter. If any prerequisite
56
+ cannot be proved, parking is refused or held with a reason.
57
+
58
+ The coordinator owns established command-only jobs and external delivery waits.
59
+ Use `watch_delivery` for supported merge observation. Recognized external watcher
60
+ commands remain refused in workers, including through their background bridge.
61
+ Command permissions and timeouts are unchanged.
45
62
 
46
63
  ## Install
47
64