pi-squire 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -6,6 +6,23 @@ follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-10-02
+
+### Fixed
+
+- The README links `CONTRIBUTING.md` on GitHub, since it is not in the npm
+  package and its relative link 404s on pi.dev.
+
+## [0.2.1] - 2026-10-02
+
+### Fixed
+
+- A delegate's task now arrives as a user prompt labelled `[delegate]` instead
+  of a `[mailbox]` message. Pi 1.0.0 started the injected message's turn
+  without the system prompt, so a fresh delegate saw no context files, skills
+  or role paragraph until after its first tool call, and could reject them as
+  an injection (earendil-works/pi#5581).
+
 ## [0.2.0] - 2026-10-02
 
 ### Breaking
@@ -69,6 +86,8 @@ 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.2.0...HEAD
+[Unreleased]: https://github.com/gvanderclay/pi-squire/compare/v0.2.2...HEAD
+[0.2.2]: https://github.com/gvanderclay/pi-squire/compare/v0.2.1...v0.2.2
+[0.2.1]: https://github.com/gvanderclay/pi-squire/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/gvanderclay/pi-squire/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/gvanderclay/pi-squire/releases/tag/v0.1.0

package/README.md

@@ -364,8 +364,18 @@ provider's own README carries the contract.
 recorded delegation's request is taken over. `pi-squire` sets `handled`, so
 the provider injects nothing, and shows the parent the result message above.
 The reply's request copies fill the quoted task and its `cur/` path is the
-envelope it names. A reply to a request this session did not delegate, and
-every request, is left to the provider. `pi-squire` reads `from` and requires
+envelope it names. A reply to a request this session did not delegate is left
+to the provider.
+
+Inside a delegate, `pi-squire` also takes over the task: a `request` whose
+`from` is the parent's address. It sets `handled` and sends the task as a user
+prompt labelled `[delegate]`, so the run starts the way a typed prompt does.
+Pi 1.0.0 starts a turn for an injected custom message without preparing the
+system prompt, so a fresh delegate's first request would otherwise carry no
+context files, skills or role paragraph
+([earendil-works/pi#5581](https://github.com/earendil-works/pi/issues/5581)).
+The provider still arms the automatic answer for a request a listener took
+over. Every other message to the delegate is left to the provider. `pi-squire` reads `from` and requires
 it to be the sender's address, which for a delegate is its session id; a reply
 from any other sender is left to the provider, even when it answers a recorded
 request. The provider's README carries the contract.
@@ -420,7 +430,7 @@ A `message:*` provider must:
 
 ## Contributing
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) to set up, run the tests and open a pull
+See [CONTRIBUTING.md](https://github.com/gvanderclay/pi-squire/blob/main/CONTRIBUTING.md) to set up, run the tests and open a pull
 request. Changes by release are in [CHANGELOG.md](CHANGELOG.md).
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-squire",
-	"version": "0.2.0",
+	"version": "0.2.2",
 	"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/child.ts

@@ -8,6 +8,13 @@
 // taking over — typing here, or stopping a run — turns it off for the rest of
 // the session, with a notice; `/auto-exit` turns it back on. Modelled on
 // edxeth/pi-subagents' `auto-exit` (README "Child lifecycle", `cf6dbf4`).
+//
+// It also takes over the parent's task request on `message:inbound` and sends
+// it as a user prompt. Pi 1.0.0 starts a custom-message turn without preparing
+// the system prompt, so a fresh delegate's first request would carry no
+// AGENTS.md, skills or role addendum (earendil-works/pi#5581). The provider
+// still arms the automatic answer for a request a listener took over.
+// ponytail: drop the takeover once #5581 lands and the minimum Pi has it.
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 
 /** The launch variable that carries the parent's resolved setting. */
@@ -19,7 +26,24 @@ const ON_NOTICE = "delegate: auto-exit is on; this delegate closes after its nex
 
 type Message = { role?: string; stopReason?: unknown };
 
-export function registerChild(pi: ExtensionAPI): void {
+type Inbound = { envelope?: { from?: unknown; kind?: unknown; body?: unknown }; handled?: boolean };
+
+export function registerChild(pi: ExtensionAPI, parent: string): void {
+	let current: ExtensionContext | undefined;
+	pi.on("session_start", async (_event, ctx) => {
+		current = ctx;
+	});
+	pi.events.on("message:inbound", (data) => {
+		const payload = data as Inbound;
+		const envelope = payload?.envelope;
+		if (payload.handled === true || envelope?.kind !== "request" || envelope.from !== parent) return;
+		payload.handled = true;
+		const text = `[delegate] Your task, from the session that started you (${parent}). Your final message this turn goes back to it automatically.\n\n${String(envelope.body ?? "")}`;
+		Promise.resolve(pi.sendUserMessage(text, { deliverAs: "steer" })).catch((err) =>
+			current?.ui.notify(`delegate: could not start the task: ${(err as Error).message}`, "error"),
+		);
+	});
+
 	let armed = process.env[AUTO_EXIT_ENV] === "1";
 	/** Whether the run that just ended finished normally: not stopped, not failed. */
 	let completed = false;

package/src/index.ts

@@ -255,8 +255,9 @@ function toolDescription(agents: readonly Agent[]): string {
  */
 export default function delegate(pi: ExtensionAPI, tmux: TmuxClient = createTmuxClient()): void {
 	// A delegate registers only its auto-exit side: `delegate` is one level deep (Q27).
-	if ((process.env[PARENT_ENV] ?? "") !== "") {
-		registerChild(pi);
+	const parentId = process.env[PARENT_ENV] ?? "";
+	if (parentId !== "") {
+		registerChild(pi, parentId);
 		return;
 	}