pi-sessions 0.13.0 → 0.14.0

package/README.md

@@ -34,7 +34,7 @@
 
 ## Install
 
-Requires Pi `0.87.1` or newer and Node `>=24 <26`.
+Requires Pi `0.99.1` or newer and Node `>=24 <26`.
 
 **From npm** (recommended):
 

package/extensions/session-ask/install.ts

@@ -12,10 +12,12 @@ import { isExactSessionId } from "../shared/session-ui.ts";
 import type { SessionSettings } from "../shared/settings.ts";
 import { runSessionAskAgent } from "./agent.ts";
 import { renderSessionAskResult } from "./renderer.ts";
-import type {
-  SessionAskProgressDetails,
-  SessionAskRelevantFile,
-  SessionAskResultDetails,
+import {
+  SESSION_ASK_OUTPUT_SCHEMA,
+  type SessionAskOutput,
+  type SessionAskProgressDetails,
+  type SessionAskRelevantFile,
+  type SessionAskResultDetails,
 } from "./tool-contract.ts";
 
 interface SessionAskToolParams {
@@ -39,6 +41,7 @@ export function installAsk(
     name: "session_ask",
     label: "Session Ask",
     description: "Interrogate a Pi session transcript",
+    annotations: { readOnlyHint: true, openWorldHint: false },
     promptSnippet: "Recall information, decisions, or reasoning from a Pi session by id",
     promptGuidelines: [
       "Use session_ask with focused questions rather than broad recap requests.",
@@ -56,6 +59,7 @@ export function installAsk(
         description: "What to find in that session's transcript",
       }),
     }),
+    outputSchema: SESSION_ASK_OUTPUT_SCHEMA,
     async execute(_toolCallId, params: SessionAskToolParams, signal, onUpdate, ctx) {
       const sessionId = params.session.trim();
       if (!sessionId) {
@@ -110,6 +114,7 @@ export function installAsk(
             },
           ],
           details,
+          structuredContent: formatSessionAskOutput(details),
         };
       }
 
@@ -179,6 +184,7 @@ export function installAsk(
           },
         ],
         details,
+        structuredContent: formatSessionAskOutput(details),
       };
     },
     renderResult: renderSessionAskResult,
@@ -217,6 +223,15 @@ function resolveSessionAskTarget(
   }
 }
 
+function formatSessionAskOutput(details: SessionAskResultDetails): SessionAskOutput {
+  return {
+    sessionId: details.sessionId,
+    sessionName: details.sessionName,
+    answer: details.answer,
+    relevantFiles: details.relevantFiles,
+  };
+}
+
 function formatSessionAskHeader(sessionId: string, sessionName: string, question: string): string {
   return [
     `session: ${sessionId}`,

package/extensions/session-ask/tool-contract.ts

@@ -22,6 +22,14 @@ export const SESSION_ASK_RESULT_DETAILS_SCHEMA = Type.Object({
   sessionPath: Type.String({ minLength: 1 }),
 });
 
+export const SESSION_ASK_OUTPUT_SCHEMA = Type.Object({
+  sessionId: Type.String(),
+  sessionName: Type.String(),
+  answer: Type.String(),
+  relevantFiles: Type.Array(SESSION_ASK_RELEVANT_FILE_SCHEMA),
+});
+
 export type SessionAskRelevantFile = Static<typeof SESSION_ASK_RELEVANT_FILE_SCHEMA>;
 export type SessionAskProgressDetails = Static<typeof SESSION_ASK_PROGRESS_DETAILS_SCHEMA>;
 export type SessionAskResultDetails = Static<typeof SESSION_ASK_RESULT_DETAILS_SCHEMA>;
+export type SessionAskOutput = Static<typeof SESSION_ASK_OUTPUT_SCHEMA>;

package/extensions/session-auto-title/wizard.ts

@@ -165,10 +165,7 @@ class RetitleWizardPanel implements Focusable {
     }
     if (result) return result;
     if (event.type === "wheel" && this.step.kind === "scope" && event.wheelDelta) {
-      this.selectedIndex = Math.max(
-        0,
-        Math.min(2, this.selectedIndex + Math.sign(event.wheelDelta)),
-      );
+      this.selectedIndex = Math.max(0, Math.min(2, this.selectedIndex + event.wheelDelta));
       this.requestRender();
       return { handled: true };
     }

package/extensions/session-handoff/board.ts

@@ -203,7 +203,7 @@ export class HandoffBoard implements Focusable {
       return { handled: true };
     }
     if (event.type === "wheel" && event.wheelDelta && this.rowHitAt(event)) {
-      if (!this.busy) this.moveSelection(Math.sign(event.wheelDelta));
+      if (!this.busy) this.moveSelection(event.wheelDelta);
       return { handled: true };
     }
     return undefined;

package/extensions/session-handoff/install.ts

@@ -31,6 +31,10 @@ import { buildHandoffLaunchSchema, buildHandoffPromptGuidelines } from "./tool-s
 import { buildHandoffToolView } from "./tool-view-model.ts";
 import { formatHandoffError } from "./ui.ts";
 
+const SESSION_TOKEN_PROMPT_SECTION = "pi_sessions_session_token";
+const SESSION_TOKEN_PROMPT =
+  "When the user references @session:<uuid>, treat it as a session token. If you call session_ask, pass only the UUID value, not the @session: prefix.";
+
 interface HandoffToolRendererState {
   callComponent?: HandoffToolComponent | undefined;
 }
@@ -64,6 +68,8 @@ export function installHandoff(
       name: "session_handoff",
       label: "Session Handoff",
       description: "Start a new Pi session with a self-contained task.",
+      // Nested calls write no toolResult entry, so the board would never see the launch receipt.
+      exposure: "model-only",
       promptSnippet:
         "Delegate bounded work to a background subagent or hand off context to another Pi session",
       promptGuidelines: buildHandoffPromptGuidelines(launchTargets, models, roster),
@@ -196,11 +202,7 @@ export function installHandoff(
         (await splitBackend.identifyTerminalId(ctx.cwd)) ?? identifiedGhosttyTerminalId;
     }
 
-    return {
-      systemPrompt:
-        event.systemPrompt +
-        "\n\nWhen the user references @session:<uuid>, treat it as a session token. If you call session_ask, pass only the UUID value, not the @session: prefix.",
-    };
+    event.systemPromptOptions.sections[SESSION_TOKEN_PROMPT_SECTION] = SESSION_TOKEN_PROMPT;
   });
 
   return {

package/extensions/session-handoff/picker.ts

@@ -178,7 +178,7 @@ export class SessionReferencePickerComponent implements Focusable {
       return undefined;
     }
     if (event.type === "wheel" && event.wheelDelta && this.sessionAt(event)) {
-      this.moveSelection(event.wheelDelta < 0 ? -1 : 1);
+      this.moveSelection(event.wheelDelta);
       return { handled: true };
     }
     if (event.type !== "click" || event.button !== "left") return undefined;

package/extensions/session-handoff/spawn.ts

@@ -63,8 +63,8 @@ export function formatHandoffLaunchFailure(error: string, prepared: PreparedHand
   return `${error} Created handoff session ${prepared.sessionId}; start it manually with: ${prepared.resumeCommand}`;
 }
 
-// Pi intentionally defers writing a new session until an assistant response
-// exists, so a prepared child needs one explicit initial flush of the
+// Pi intentionally defers writing a new session until it holds a user or
+// assistant message, so a prepared child needs one explicit initial flush of the
 // manager-assembled state to be discoverable by `pi --session-id`.
 function flushPreparedSession(manager: SessionManager): void {
   const sessionFile = manager.getSessionFile();

package/extensions/session-messaging/pi/reachable-tool.ts

@@ -77,6 +77,7 @@ export function createSessionReachableTool(deps: SessionReachableDeps): ToolDefi
       "Before session_send_message, use session_reachable to find the target session id.",
     ],
     parameters: subagentsAvailable ? SESSION_REACHABLE_PARAMS : SESSION_REACHABLE_USER_PARAMS,
+    outputSchema: SESSION_REACHABLE_TOOL_DETAILS_SCHEMA,
     renderResult(result, options, theme, context) {
       const output = result.content.find((item) => item.type === "text")?.text ?? "";
       if (context.isError) {
@@ -108,6 +109,7 @@ export function createSessionReachableTool(deps: SessionReachableDeps): ToolDefi
       return {
         content: [{ type: "text" as const, text: JSON.stringify(details, null, 2) }],
         details,
+        structuredContent: details,
       };
     },
   });

package/extensions/session-search/extract.ts

@@ -633,11 +633,17 @@ function extractMessageFileTouches(
   message: AgentMessage,
   cwd: string,
 ): SessionFileTouch[] {
-  if (message.role !== "assistant" || !Array.isArray(message.content)) {
+  let toolCalls: { name: string; arguments?: Record<string, unknown> | undefined }[];
+  if (message.role === "assistant" && Array.isArray(message.content)) {
+    toolCalls = message.content.filter(isToolCallBlock);
+  } else if (message.role === "toolResult" && message.nestedCalls) {
+    // Calls made through ctx.executeTool(), e.g. from a codemode script, only appear here.
+    toolCalls = message.nestedCalls.calls;
+  } else {
     return [];
   }
 
-  return message.content.filter(isToolCallBlock).flatMap((toolCall) => {
+  return toolCalls.flatMap((toolCall) => {
     const rawPath = stringValue(toolCall.arguments?.path);
     const op = getToolCallFileTouchOp(toolCall.name);
     if (!rawPath || !op) {

package/extensions/session-search/install.ts

@@ -10,10 +10,12 @@ import {
 } from "../shared/session-index/index.ts";
 import type { SessionSettings } from "../shared/settings.ts";
 import { renderSessionSearchResult } from "./renderer.ts";
-import type {
-  SessionSearchResult,
-  SessionSearchToolDetails,
-  SessionSearchToolParams,
+import {
+  SESSION_SEARCH_OUTPUT_SCHEMA,
+  type SessionSearchOutput,
+  type SessionSearchResult,
+  type SessionSearchToolDetails,
+  type SessionSearchToolParams,
 } from "./tool-contract.ts";
 
 const DEFAULT_SESSION_SEARCH_LIMIT = 6;
@@ -30,6 +32,7 @@ export function installSearch(pi: ExtensionAPI, deps: SearchInstallDeps): void {
     name: "session_search",
     label: "Session Search",
     description: "Search Pi sessions",
+    annotations: { readOnlyHint: true, openWorldHint: false },
     promptSnippet: "Locate Pi sessions for follow-up",
     promptGuidelines: [
       "Omit queries in session_search to list matching sessions chronologically.",
@@ -104,6 +107,7 @@ export function installSearch(pi: ExtensionAPI, deps: SearchInstallDeps): void {
         }),
       ),
     }),
+    outputSchema: SESSION_SEARCH_OUTPUT_SCHEMA,
     async execute(_toolCallId, params: SessionSearchToolParams, _signal, onUpdate, ctx) {
       const validationError = validateSearchParams(params);
       if (validationError) {
@@ -130,6 +134,7 @@ export function installSearch(pi: ExtensionAPI, deps: SearchInstallDeps): void {
             },
           ],
           details,
+          structuredContent: formatSearchOutput(results),
         };
       });
     },
@@ -170,6 +175,24 @@ function formatSearchResultsForModel(details: SessionSearchToolDetails): string
   );
 }
 
+function formatSearchOutput(results: SessionSearchResult[]): SessionSearchOutput {
+  return {
+    results: results.map((result) => ({
+      sessionId: result.sessionId,
+      sessionName: result.sessionName,
+      cwd: result.cwd,
+      startedAt: result.startedAt,
+      modifiedAt: result.modifiedAt,
+      messageCount: result.messageCount,
+      snippet: stripSearchSnippetMarkers(result.snippet) ?? result.snippet,
+      hitCount: result.hitCount,
+      ...(result.sessionOrigin ? { sessionOrigin: result.sessionOrigin } : {}),
+      ...(result.relation ? { relation: result.relation } : {}),
+      ...(result.parentSessionId ? { parentSessionId: result.parentSessionId } : {}),
+    })),
+  };
+}
+
 function formatSearchResultForModel(result: SessionSearchResult): SessionSearchResult {
   return {
     ...result,

package/extensions/session-search/tool-contract.ts

@@ -1,8 +1,11 @@
-import type {
-  SearchSessionResult,
-  SearchSort,
-  SessionIndexStatus,
-  SessionKind,
+import { type Static, Type } from "typebox";
+import {
+  SESSION_LINEAGE_RELATION_SCHEMA,
+  SESSION_ORIGIN_SCHEMA,
+  type SearchSessionResult,
+  type SearchSort,
+  type SessionIndexStatus,
+  type SessionKind,
 } from "../shared/session-index/index.ts";
 
 export interface SessionSearchToolParams {
@@ -29,3 +32,23 @@ export interface SessionSearchToolDetails {
   results: SessionSearchResult[];
   status?: SessionIndexStatus | undefined;
 }
+
+export const SESSION_SEARCH_OUTPUT_SCHEMA = Type.Object({
+  results: Type.Array(
+    Type.Object({
+      sessionId: Type.String(),
+      sessionName: Type.String(),
+      cwd: Type.String(),
+      startedAt: Type.String(),
+      modifiedAt: Type.String(),
+      messageCount: Type.Number(),
+      snippet: Type.String(),
+      hitCount: Type.Number(),
+      sessionOrigin: Type.Optional(SESSION_ORIGIN_SCHEMA),
+      relation: Type.Optional(SESSION_LINEAGE_RELATION_SCHEMA),
+      parentSessionId: Type.Optional(Type.String()),
+    }),
+  ),
+});
+
+export type SessionSearchOutput = Static<typeof SESSION_SEARCH_OUTPUT_SCHEMA>;

package/extensions/subagents/report.ts

@@ -43,6 +43,7 @@ export function createSubmitTaskReportTool(
     label: "Submit task report",
     description:
       "Send a report to the parent session and end the current turn. Use it when the delegated task or requested follow-up is done, blocked, or cannot be completed.",
+    exposure: "model-only",
     promptSnippet: "Submit the current task report to the parent session and end the turn",
     promptGuidelines: [
       "Call submit_task_report exactly once as the final tool call for every delegated task or follow-up that expects a response.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-sessions",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "type": "module",
   "description": "Pi session search, ask, handoff, messaging, auto-titling, and indexing tools",
   "license": "MIT",
@@ -38,10 +38,10 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.10",
-    "@earendil-works/pi-agent-core": "^0.87.1",
-    "@earendil-works/pi-ai": "^0.87.1",
-    "@earendil-works/pi-coding-agent": "^0.87.1",
-    "@earendil-works/pi-tui": "^0.87.1",
+    "@earendil-works/pi-agent-core": "^0.99.1",
+    "@earendil-works/pi-ai": "^0.99.1",
+    "@earendil-works/pi-coding-agent": "^0.99.1",
+    "@earendil-works/pi-tui": "^0.99.1",
     "@types/node": "^24.13.3",
     "strip-ansi": "^7.2.0",
     "typebox": "1.3.27",
@@ -49,9 +49,10 @@
     "vitest": "^4.1.11"
   },
   "peerDependencies": {
-    "@earendil-works/pi-agent-core": ">=0.87.1",
-    "@earendil-works/pi-ai": ">=0.87.1",
-    "@earendil-works/pi-coding-agent": ">=0.87.1",
-    "@earendil-works/pi-tui": ">=0.87.1"
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
   }
 }