pi-sessions 0.7.0 → 0.7.2

package/extensions/session-ask.ts

@@ -39,9 +39,8 @@ export default function sessionAskExtension(pi: ExtensionAPI): void {
     name: "session_ask",
     label: "Session Ask",
     description: "Interrogate a Pi session",
-    promptSnippet:
-      "Use when you have a session id and want to recall information, decisions, reasoning, etc from it",
-    promptGuidelines: ["Prefer focused follow-up questions over broad recap requests"],
+    promptSnippet: "Recall information, decisions, or reasoning from a Pi session by id",
+    promptGuidelines: ["Use session_ask with focused questions rather than broad recap requests."],
     parameters: Type.Object({
       session: Type.String({
         description: "Bare UUID for the session",

package/extensions/session-handoff.ts

@@ -87,16 +87,15 @@ export default function sessionHandoffExtension(pi: ExtensionAPI): void {
         "Start a background pi session in a terminal split based on the current session",
       promptGuidelines: [
         "Use session_handoff only when it is clear the work should be forked to a new context.",
-        "Prefer using session_handoff by direction of the user, not as an unsolicited default.",
-        "The goal should capture enough detail to encompass the ask and include any directions the next sessions should consider.",
-        "Only request a response when there is a specific ask-and-response expectation: the user asked for a report back, or the current session needs the child result before it can continue. Do not set requestResponse for independent or unrelated background work; most split-off tasks should run without reporting back.",
-        "Only capable of a background handoff; to replace the current session, tell the user to run /handoff instead.",
+        "Reach for session_handoff by direction of the user, not as an unsolicited default.",
+        "session_handoff should only request a response when there is a specific ask-and-response expectation: the user asked for a report back, or this session needs the child result to continue. Leave it off by default and for independent background work.",
+        "session_handoff can only fork a background session; to replace the current session, tell the user to run /handoff instead.",
       ],
       executionMode: "sequential",
       parameters: Type.Object({
         goal: Type.String({
           description:
-            "Goal for the new session, including enough detail to capture the user's ask and any directions the next prompt should consider.",
+            "Goal for the new session. Capture enough detail to encompass the ask and any directions the next session should consider.",
         }),
         splitDirection: Type.Union(
           [Type.Literal("left"), Type.Literal("right"), Type.Literal("up"), Type.Literal("down")],

package/extensions/session-messaging/broker/spawn.ts

@@ -39,7 +39,7 @@ export async function spawnSessionMessagingBrokerIfNeeded(): Promise<void> {
       detached: true,
       stdio: "ignore",
       windowsHide: process.platform === "win32",
-      env: { ...process.env, NODE_NO_WARNINGS: "1" },
+      env: brokerSpawnEnv(),
     });
     child.unref();
     await waitForBroker();
@@ -162,3 +162,19 @@ function releaseSpawnLock(): void {
     unlinkSync(brokerSpawnLockPath);
   } catch {}
 }
+
+function brokerSpawnEnv(): NodeJS.ProcessEnv {
+  // NODE_NO_WARNINGS silences Node's experimental-TypeScript warning when the
+  // broker is launched as `node process.ts`. Redundant while stdio is ignored,
+  // but cheap insurance if that changes or an older Node revives the warning.
+  const env: NodeJS.ProcessEnv = { ...process.env, NODE_NO_WARNINGS: "1" };
+  // process.execPath is the Pi executable. As a Bun-compiled binary it treats a
+  // positional path as a file argument to the agent, not a script to run, which
+  // would relaunch a full agent session and recurse. BUN_BE_BUN makes it behave
+  // as the Bun CLI and execute process.ts directly. It is set whenever Bun is the
+  // runtime (compiled binary or `bun run`) and ignored by a plain Node launch.
+  if (process.versions.bun) {
+    env.BUN_BE_BUN = "1";
+  }
+  return env;
+}

package/extensions/session-messaging/pi/tools.ts

@@ -14,7 +14,7 @@ export function registerSessionMessagingTools(
     description: "Send a message to another live pi session",
     promptSnippet: "Send a message to another live pi session",
     promptGuidelines: [
-      "Use session_search with live: true to discover targetable sessions. Usually it is best to exclude all other filters and simply get a list of all live sessions",
+      "Before session_send_message, use session_search with live: true (no other filters) to list all live sessions and find the target.",
     ],
     parameters: SEND_MESSAGE_PARAMS,
     renderCall(args, theme, context) {

package/extensions/session-search.ts

@@ -64,10 +64,10 @@ export default function sessionSearchExtension(
     name: "session_search",
     label: "Session Search",
     description: "Search Pi sessions",
-    promptSnippet: "Use when you need to locate a session to do a detailed follow-up",
+    promptSnippet: "Locate Pi sessions for follow-up",
     promptGuidelines: [
-      "Omit query to list matching sessions chronologically",
-      "Once you have the right session id, switch to session_ask for questions about that session",
+      "Omit queries in session_search to list matching sessions chronologically.",
+      "After session_search finds a session id, switch to session_ask for questions about it.",
     ],
     parameters: Type.Object({
       query: Type.Optional(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-sessions",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "type": "module",
   "description": "Pi session search, ask, handoff, messaging, auto-titling, and indexing tools",
   "license": "MIT",
@@ -41,6 +41,9 @@
     "check": "biome check . && tsc --noEmit && vitest run",
     "prepare": "husky || true"
   },
+  "dependencies": {
+    "typebox": "^1.1.38"
+  },
   "devDependencies": {
     "@biomejs/biome": "^2.4.14",
     "@earendil-works/pi-agent-core": "^0.80.2",
@@ -50,7 +53,6 @@
     "@types/node": "^25.6.2",
     "husky": "^9.1.7",
     "lint-staged": "^17.0.3",
-    "typebox": "^1.1.38",
     "typescript": "^6.0.3",
     "vitest": "^4.1.5"
   },
@@ -58,8 +60,7 @@
     "@earendil-works/pi-agent-core": ">=0.80.2",
     "@earendil-works/pi-ai": ">=0.80.2",
     "@earendil-works/pi-coding-agent": ">=0.80.2",
-    "@earendil-works/pi-tui": ">=0.80.2",
-    "typebox": ">=1.1.24"
+    "@earendil-works/pi-tui": ">=0.80.2"
   },
   "lint-staged": {
     "*.{js,cjs,mjs,jsx,ts,tsx,json,jsonc}": "biome check --write --no-errors-on-unmatched"