@juanbenjumea/pi-agy 0.7.5 → 0.7.6
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/CHANGELOG.md +5 -0
- package/package.json +1 -1
- package/skills/agy/SKILL.md +16 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.7.6
|
|
4
|
+
|
|
5
|
+
- Document background tasks and the Antigravity provider in the agent-facing skill guide (usage, lifecycle, and the narrowed background-servers rule), and ignore session-local `.pi/` todo state.
|
|
6
|
+
- Full 297-test gate plus typecheck and package checks pass.
|
|
7
|
+
|
|
3
8
|
## 0.7.5
|
|
4
9
|
|
|
5
10
|
- Fix CI-only event-loop drain in background tasks: per-task and shutdown timers hold the loop so timeouts always fire, and shutdown clears task timers so abandoned runs cannot pin process exit. (0.7.4 never reached npm — its publish run caught this.)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@juanbenjumea/pi-agy",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.6",
|
|
4
4
|
"description": "Reliable Antigravity delegation for Pi — quota-aware runs, resumable tasks, repo verification, cancellation, and trustworthy diff summaries.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
package/skills/agy/SKILL.md
CHANGED
|
@@ -47,8 +47,21 @@ agy_agents
|
|
|
47
47
|
agy_execute prompt="Investigate the crash" agent=gsd-debugger mode=plan
|
|
48
48
|
agy_history
|
|
49
49
|
agy_usage
|
|
50
|
+
agy_execute prompt="Migrate the build to ESM" mode=plan background=true
|
|
51
|
+
agy_tasks action=list
|
|
52
|
+
agy_tasks action=status handle=<handle>
|
|
53
|
+
agy_tasks action=collect handle=<handle>
|
|
54
|
+
agy_tasks action=cancel handle=<handle>
|
|
50
55
|
```
|
|
51
56
|
|
|
57
|
+
Background runs (`background=true`) return a task handle immediately instead
|
|
58
|
+
of blocking the turn. Poll with `agy_tasks status`, collect the terminal
|
|
59
|
+
result with `agy_tasks collect` (which frees the record), and cancel strays
|
|
60
|
+
with `agy_tasks cancel`. Runs keep their `timeout_ms` deadline, serialize on
|
|
61
|
+
the per-directory lock, record sessions on completion, and die with the Pi
|
|
62
|
+
session — collect promptly, since uncollected payloads do not survive restart
|
|
63
|
+
(conversations stay resumable via `agy_history`).
|
|
64
|
+
|
|
52
65
|
## Modes
|
|
53
66
|
|
|
54
67
|
| Mode | Purpose |
|
|
@@ -62,7 +75,7 @@ agy_usage
|
|
|
62
75
|
- **Default to `mode=plan`** for exploration; escalate to `accept-edits` only for scoped batches.
|
|
63
76
|
- **Always review the `git diff`** after agy runs with `accept-edits`.
|
|
64
77
|
- **Run `just ci`** (or the project gate) after write modes in this repo.
|
|
65
|
-
- **Never use agy for irreversible production changes or
|
|
78
|
+
- **Never use agy for irreversible production changes or unowned background servers/watchers.** Delegations are bounded; timeout/cancellation kills the full process tree rather than releasing unowned work. The managed exception is `background=true`, whose runs stay timeout-owned, cancellable, lock-serialized, and die with the session.
|
|
66
79
|
- Reuse `conversation_id` or `continue=true` for multi-step plan → implement → review.
|
|
67
80
|
- Use `agent` only when the user requests a configured custom agent; call `agy_agents` first when the exact name is unknown. Recorded agent identity is restored on resume.
|
|
68
81
|
- Keep `context=none` (default) unless the task depends on prior Pi discussion; prefer `summary` over `recent` to minimize disclosure. Context handoff excludes system prompts, thinking, tool arguments/results, images, and custom messages.
|
|
@@ -86,3 +99,5 @@ agy_usage
|
|
|
86
99
|
- **Diff summary** — accept-edits results append newly-dirty files only; pre-existing dirt is listed separately, never misattributed.
|
|
87
100
|
- **Per-directory lock** — serializes concurrent agy calls on the same tree across Pi processes (symlink-aware).
|
|
88
101
|
- **Cancellation** — abort/timeout kills the full agy process tree, and streamed records plus responses are size-bounded; a fully delivered result survives cancellation or timeout, and the conversation stays resumable.
|
|
102
|
+
- **Background tasks** — `agy_execute background=true` detaches with a task handle; `agy_tasks` polls, collects, and cancels. Timeout-owned, lock-serialized, session-recorded, reaped on shutdown.
|
|
103
|
+
- **Antigravity provider** — `antigravity/*` models in Pi's `/model` picker with live catalog discovery, a persistent stream-json driver, and a localhost MCP bridge: read-only Pi context plus mutating Pi tools via parked calls and real shadow `toolCall` turns (normal permissions and review apply). Toggle with `/agy bridge on|off`; attached images are staged as files agy can open.
|