pi-squire 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -6,6 +6,30 @@ follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-10-15
+
+### Added
+
+- Every delegate now starts with `PI_UNATTENDED=1` in its environment, a
+  general signal that no human is watching the session. Delegates run as a
+  full TUI, so extensions that open a dialog, such as a handoff gate or an
+  approval prompt, waited on nobody and stalled the delegate; they can read
+  this variable to skip the dialog instead. The test that pins the child's
+  exact environment now includes it.
+
+## [0.5.1] - 2026-10-14
+
+### Changed
+
+- The `delegate` tool's description now tells the parent to keep working or
+  end its turn while a delegate runs, since the result starts its next turn
+  on its own; the launch message says the same in place of pointing at
+  `delegation_status`. GPT parents asked their own delegates for the result
+  with `session_mail_ask`, so each report arrived twice.
+- The `delegation_status` description now says to call it to check on a
+  delegation that seems stuck or to find its files, not to wait for a result,
+  which arrives as a message on its own.
+
 ## [0.5.0] - 2026-10-13
 
 ### Changed
@@ -215,7 +239,9 @@ author's dotfiles; the changes below are against that copy.
 
 - The published file list includes `child.ts`, which `index.ts` imports.
 
-[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.5.0...HEAD
+[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/gvanderclay/pi-squire/compare/v0.5.1...v0.6.0
+[0.5.1]: https://github.com/gvanderclay/pi-squire/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/gvanderclay/pi-squire/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/gvanderclay/pi-squire/compare/v0.3.2...v0.4.0
 [0.3.2]: https://github.com/gvanderclay/pi-squire/compare/v0.3.1...v0.3.2

package/README.md

@@ -178,7 +178,11 @@ variable of its own. `PI_DELEGATE_PARENT` and `PI_DELEGATE_AUTO_EXIT` are set
 for the child, never read as configuration by the parent. The window starts
 with the tmux server's environment plus only these from the parent:
 `PI_CODING_AGENT_DIR`, `PI_CODING_AGENT_SESSION_DIR` (when the parent has it
-set), `PI_DELEGATE_PARENT` and `PI_DELEGATE_AUTO_EXIT`. Anything else the
+set), `PI_DELEGATE_PARENT` and `PI_DELEGATE_AUTO_EXIT`, and it always gets `PI_UNATTENDED=1`.
+`PI_UNATTENDED=1` is a general signal, not specific to pi-squire: no human is
+watching this session, even though it runs in a TUI. Other extensions may read
+it to skip a dialog or confirmation instead of waiting on one, and any other
+runner that starts Pi unattended can set it too. Anything else the
 parent process has, such as a `CLAUDE_CONFIG_DIR` set by a shell alias,
 reaches the child only through a `session:launch` contributor. `--model` and
 `--thinking` override the agent's defaults for one call, and an unknown value
@@ -557,8 +561,8 @@ Other extensions may rely on:
 - the `[delegate]` result text and the closed-without-a-result text;
 - `AGENT.md`'s frontmatter keys and its location,
   `<agent dir>/agents/<name>/AGENT.md`;
-- the child environment variables `PI_DELEGATE_PARENT` and
-  `PI_DELEGATE_AUTO_EXIT`.
+- the child environment variables `PI_DELEGATE_PARENT`,
+  `PI_DELEGATE_AUTO_EXIT` and `PI_UNATTENDED=1`.
 
 A `message:*` provider must:
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-squire",
-	"version": "0.5.0",
+	"version": "0.6.0",
 	"description": "Starts a delegate Pi session in a background tmux window, sends it the task over message:*, and shows the parent its result",
 	"keywords": [
 		"pi-package",

package/src/index.ts

@@ -312,7 +312,7 @@ function thinkingProblem(value: string): string | undefined {
 /** The `delegate` tool's description: what delegation does, and the roster as it stands. */
 function toolDescription(agents: readonly Agent[]): string {
 	const intro =
-		"Hand a self-contained task to a delegate Pi session in a background tmux window, so it works while you do not. Each call starts the delegation at once; the delegate runs in this session's working directory and agent root and reports back later as one message. Use it when the work is self-contained and you would rather keep your own context for it.";
+		"Hand a self-contained task to a delegate Pi session in a background tmux window, so it works while you do not. Each call starts the delegation at once; the delegate runs in this session's working directory and agent root and reports back later as one message. While it runs, keep working or end your turn: its result starts your next turn on its own, so there is no need to ask the delegate for it or poll delegation_status. Use it when the work is self-contained and you would rather keep your own context for it.";
 	if (agents.length === 0) {
 		return `${intro}\n\nNo agents are defined yet. Add ${join(
 			getAgentDir(),
@@ -469,6 +469,8 @@ export default function delegate(
 			PI_CODING_AGENT_DIR: getAgentDir(),
 			[PARENT_ENV]: parent,
 			[AUTO_EXIT_ENV]: start.autoExit ? "1" : "0",
+			// A general signal for any extension: no human watches this session, so don't wait on a dialog.
+			PI_UNATTENDED: "1",
 		};
 		if (start.rest.length > 0) env[FALLBACK_ENV] = start.rest.join(",");
 		const sessionDir = process.env[SESSION_DIR_ENV];
@@ -581,7 +583,7 @@ export default function delegate(
 			const launched = await launch(start, ctx);
 			ctx.ui.notify(started(launched, start), "info");
 			return toolResult(
-				`Started delegation ${launched.id}: ${start.agent.name} (${start.model}, thinking ${start.thinking}) in window ${launched.windowName}. It runs in the background and its result arrives as a message; delegation_status reports it and delegation_close ends it.${start.skipped.length > 0 ? ` ${fallbackNote(start)}` : ""}${start.notices.map((line) => ` ${line}`).join("")}`,
+				`Started delegation ${launched.id}: ${start.agent.name} (${start.model}, thinking ${start.thinking}) in window ${launched.windowName}. It runs in the background, and its result arrives as a message that starts your next turn on its own; delegation_close ends it.${start.skipped.length > 0 ? ` ${fallbackNote(start)}` : ""}${start.notices.map((line) => ` ${line}`).join("")}`,
 				{
 					outcome: "started",
 					id: launched.id,

package/src/tracking.ts

@@ -263,7 +263,7 @@ function statusTool(results: Results, tmux: TmuxClient, readingErrors: () => Rea
 		name: "delegation_status",
 		label: "Delegation status",
 		description:
-			"The delegations this session started, each reported as running (the window is open and no result has arrived yet), done (with the result envelope's status) or closed (closed with delegation_close, or its window is gone). A delegation whose window went with no reply is reported closed without a result until a late reply makes it done. Names the delegation id, agent, session name, model, thinking, window, delegate session path and result envelope path. A running delegation also shows when its session file was last written; a long gap may mean it is stuck but does not prove it. A delegate's window being open means it is connected, not that its task is unfinished or finished; only a result means done.",
+			"The delegations this session started, each reported as running (the window is open and no result has arrived yet), done (with the result envelope's status) or closed (closed with delegation_close, or its window is gone). A delegation whose window went with no reply is reported closed without a result until a late reply makes it done. Call it to check on a delegation that seems stuck or to find its files; a result arrives as a message on its own, so there is no need to call it to wait for one. Names the delegation id, agent, session name, model, thinking, window, delegate session path and result envelope path. A running delegation also shows when its session file was last written; a long gap may mean it is stuck but does not prove it. A delegate's window being open means it is connected, not that its task is unfinished or finished; only a result means done.",
 		parameters: Type.Object({
 			id: Type.Optional(Type.String({ description: "One delegation id; omit to report every delegation." })),
 		}),