pi-sessions 0.7.1 → 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/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.1",
+  "version": "0.7.2",
   "type": "module",
   "description": "Pi session search, ask, handoff, messaging, auto-titling, and indexing tools",
   "license": "MIT",