@xl0/pi-lovely-agents 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -2,6 +2,72 @@
 
 ## [Unreleased]
 
+## [0.1.3] - 2026-09-20
+
+### Breaking Changes
+
+- Remove foreground mode and the `backgroundAgents` setting: agent calls wait up to `waitMs` and then detach, and Follow-ups are always accepted without waiting for their result.
+- Remove provider-limit suspension, automatic recovery, and the `/continue` command: a run that hits a quota or rate limit fails like any other provider error and notifies the parent.
+- Remove the `active/` task index and the discard support for unsupported metadata versions; such records remain a diagnostic until deleted by hand.
+- Ignore project Agent Definitions and workspace settings unless Pi evaluated project trust or a `/trust` decision is saved; ignored resources are reported as warnings. Ancestor `.pi/agents` directories owned by another user are skipped.
+
+### Changed
+
+- Accept a list of Task References in `task_discard` and `task_stop`, so cleaning up many tasks takes one call; a bad reference is reported without abandoning the rest.
+- Require Pi 0.86.1 or newer; child prompts are now rendered by Pi, with the tool list and rules added as prompt sections.
+- Replace the shipped `scripts/prune-tasks.ts` with **`/lovely-agents` → Prune discarded tasks**, which shows a dry run and asks before deleting.
+- Write Bash output straight to `output.log` from the command, preserving the order of stdout and stderr, and read tails on demand instead of copying them into task metadata while it runs.
+- Log agent inputs in `history.md` as the child session receives them, mark run ends as `<run N outcome>`, and no longer fail a run when writing the history log fails.
+- Report a single descendant count per agent task instead of per-state summaries, and omit descendants from notifications.
+- Use one task ordering everywhere: Agents before Bash, active states first, newest created first.
+- Keep Lovely tools and their schemas static instead of hiding tools and parameters as settings change; disabled Bash and depth limits are rejected when called, and `waitMs` is ignored while background agents are disabled.
+
+### Fixed
+
+- Fix a scheduler deadlock when an agent waits on several tasks in parallel at full capacity.
+- Return the execution permit of a promoted Follow-up when the task is stopped before it starts.
+- Stop detached descendants when an `agent` call is cancelled before detachment.
+- Deliver notifications to idle or suspended child agents without starting a turn outside the scheduler.
+- Resend notifications dropped when the parent turn is aborted before they are delivered.
+- Reclaim a stale session lease left by a crashed process whose PID this process reuses.
+- Settle Bash tasks when the shell exits, killing leftover background jobs that keep its pipes open.
+- Include tool-specific guidelines in child system prompts.
+- Reject symlinked task directories before reading or mutating task metadata.
+- Keep tasks controllable after the system clock steps backwards.
+- Reopen a provider gate after successful tool-use turns, not only final replies.
+- Limit streaming reply snapshots to two durable writes per second.
+- Accept Bash stdin sent immediately after a task is reported running, instead of failing before the process is spawned.
+- Stop timed `task_output` waits from failing when the directory watcher reports an already-renamed temporary metadata file.
+- Keep unrelated staged changes out of the release commit.
+- Show a persistent session-ownership warning and disable Lovely Agents initialization when another Pi process owns the session's tasks.
+
+## [0.1.2] - 2026-09-10
+
+### Breaking Changes
+
+- Keep discarded task files at their original paths and return `taskDirectory` with `state: "discarded"` from `task_discard`.
+
+### Added
+
+- Retrieve retained results by run index with `task_output(run: N)`, including after discard, and identify runs in results and completion notices.
+- Browse non-discarded tasks through an `active/` index and safely prune discarded tasks with the dry-run-first `scripts/prune-tasks.ts` command.
+- Report child progress in task inspection and the panel with `task_update` without notifying the parent.
+- Scroll live output with keyboard navigation, Bash tail-following, and visible exit codes or termination signals.
+- Read shorter Bash output tails with `task_output(lines: N)`.
+
+### Changed
+
+- Group Agents and Bash separately and list active tasks first.
+- Show the latest Bash output in UTF-8-safe completion previews.
+- Clarify Steer acceptance and Follow-up conversion, and expose process-wide capacity and Bash queue reasons.
+- Guide agents to delegate independent implementation work and keep coupled changes in the parent.
+
+### Fixed
+
+- Keep output waits attached to the selected run across Follow-ups.
+- Deliver pending completion notifications for discarded tasks.
+- Prevent another Pi process from claiming tasks whose cleanup failed.
+
 ## [0.1.1] - 2026-09-06
 
 - Publish through GitHub Actions with npm provenance.

package/README.md

@@ -83,14 +83,19 @@ agents get the normal tools and extensions; a role description is not a sandbox.
 
 Open **`/lovely-agents` → Tasks**, or press **Down with an empty editor** to focus
 the task list below it.
+Agents and Bash appear in separate groups, active tasks first within each group.
 
 - **Arrow keys** select a task; **Enter** opens its actions.
-- **Live output** shows what it has produced so far.
+- **Live output** scrolls with arrows, PgUp/PgDn, Home/End. Bash opens at the
+  bottom and follows new output; scrolling up pauses following, End resumes it.
+  Its fixed header includes the exit code and termination signal.
 - **Inputs / history** shows earlier requests and results.
 - **Follow-up** adds another request after the agent's current work.
-- **Steer** redirects work already in progress.
+- **Steer** queues input for a live streaming run. Without a live target it becomes
+  a Follow-up. Queued input can be lost on stop.
 - **Stop** cancels the work but keeps its files. An agent can take a new request later.
-- **Discard** stops and archives it, removing it from the list. It does not delete the files.
+- **Discard** stops it and removes it from active work. Files stay in place and
+  results remain readable, but it cannot receive new input.
 - **Esc** returns to the editor.
 
 You can also ask Pi directly:
@@ -102,6 +107,14 @@ You can also ask Pi directly:
 Tool calls and notifications are compact by default. **Ctrl+O** expands their
 full contents.
 
+Children can call `task_update({ progress: "Root cause found; testing the fix" })`
+to report meaningful milestones or blockers in up to 240 characters. Progress
+replaces the initial-input preview in the panel and appears in task inspection.
+It does not rename the task, change its lifecycle state, notify or wake the parent.
+Each new run clears the report; earlier reports remain with their run's result.
+Default-tool children get this tool automatically. If a Definition has an explicit
+`tools` list, include `task_update` to allow progress reporting.
+
 ## Background Bash
 
 Ask Pi to run a long command in the background:
@@ -110,6 +123,8 @@ Ask Pi to run a long command in the background:
 
 The command appears alongside agent tasks. You can inspect its output or stop
 it from the same menu. Normal, short Bash commands still work as before.
+Detached completion automatically notifies Pi and wakes an idle parent.
+Synchronous completion and explicit stops do not send a completion notice.
 
 For a command that needs input, **Write stdin** sends exactly what you type;
 include a newline if the command expects one. **Close stdin** sends EOF: “there
@@ -124,16 +139,20 @@ Background Bash currently supports Linux and macOS, not Windows.
 Open **`/lovely-agents` → Configuration**. Settings can apply to all projects or
 just this workspace; workspace settings win.
 
-**Background agents** and **Background Bash** are both on by default. Turn off
-Background agents if you want Pi to wait for agents to finish instead of leaving
-work running. Turning either switch off does not stop tasks already accepted.
+**Background Bash** is on by default. Turning it off does not stop tasks already
+accepted.
 
 Agent work and Bash jobs have separate concurrency limits, both initially 4.
 Extra work queues until a slot is free. Pi initially waits up to 30 seconds for
 an agent result before leaving it in the background.
+These limits are shared process-wide, not per conversation. The roster reports
+held/max execution permits; task lists show only the current parent's tasks.
 
-Under **Models**, choose additional models Pi may use for agents. You can also
-configure these optional shortcuts:
+Under **Models**, choose additional models Pi may use for agents. Unavailable
+entries warn and are skipped without dropping available ones; saved IDs remain
+intact. An empty selection includes the parent model, but a nonempty selection
+with no available entries does not fall back to it. You can also configure
+these optional shortcuts:
 
 | Alias | Suggested use |
 | --- | --- |
@@ -152,24 +171,40 @@ Long results aren't lost. Pi's output-reading tool returns at most **2,000 lines
 or 50 KiB** at a time, with a truncation notice and a file path when capped.
 These are snapshots, not pages to assemble by repeatedly reading. Full agent
 replies are in `history.md`; full Bash output is in `output.log`.
+Each agent assignment has a 1-based run index, shown in tool results and notices.
+`task_output(id, run: 2)` retrieves that run even after later Follow-ups start.
+Omit `run` for the current snapshot; `lines: 20` requests a shorter Bash tail.
+Older runs completed before this feature may require reading `history.md`.
 
-If Pi asks to wait for a result, the wait ends when the run finishes, pauses on
-a provider limit, or reaches the requested timeout. A timeout returns the
+If Pi asks to wait for a result, the wait ends when the run finishes or reaches
+the requested timeout. A timeout returns the
 latest output—it does not stop the task.
+The wait stays attached to the selected run; a later Follow-up cannot replace
+its answer. Prefer completion notices or a meaningful wait over short polling.
 
 Tasks belong to the Pi conversation that started them. **`/reload` keeps work
 running; quitting or switching conversations stops it.** After a crash, lost
 work is marked interrupted rather than silently restarted. Agent conversations
 can receive a new request; Bash commands must be started again.
 
-Background agents pause on provider quota or rate limits. A successful request
-using the affected model can resume them. If your main conversation ended with
-an error or was aborted, **`/continue`** resumes it and eligible paused agents.
+An agent that hits a provider quota or rate limit fails like any other provider
+error; Pi is notified and can send it a Follow-up once the limit clears.
 
 Task files live in `.pi/lovely-agents/` under your working directory and are
 ignored by Git. They include conversation history and command output, so treat
-them as potentially sensitive. Discarded tasks move to its `archive/` directory;
-there is no automatic deletion.
+them as potentially sensitive. Each task keeps its original
+`<parent-session>/<task-id>/` path.
+Keep tasks until dependent work is integrated, then discard what is no longer
+needed.
+
+There is no automatic deletion. **`/lovely-agents` → Prune discarded tasks**
+shows what would be deleted in this workspace and asks before deleting.
+
+Pruning skips nothing silently: it refuses while another Pi process has a
+session open here, and retains non-discarded tasks, pending
+notifications, unknown/corrupt records, and unsafe or still-needed descendants.
+Crash leftovers stay until
+their parent is reopened; abandoned sessions are not automatically collected.
 
 ## Development