pi-sessions 0.5.1 → 0.6.0

package/README.md

@@ -20,7 +20,7 @@
 
 ## Install
 
-Requires Pi `0.80.2` or newer.
+Requires Pi `0.80.2` or newer and Node `>=24 <26`.
 
 **From npm** (recommended):
 
@@ -51,14 +51,15 @@ What session did I implement the db layer?
 
 ## Features
 
-| Extension          | Surface                               | What it does                                            |
-| ------------------ | ------------------------------------- | ------------------------------------------------------- |
-| Session Search     | `session_search` pi tool              | Search through old sessions                             |
-| Session Ask        | `session_ask` pi tool                 | Ask questions about old sessions                        |
-| Session Handoff    | `/handoff`, `session_handoff` pi tool | Start a focused new session; alternative to compaction  |
-| Session Picker     | `Alt+O`                               | Reference old sessions in your prompt                   |
-| Session Index      | `/session-index` slash command        | Shows index status and rebuilds the local session index |
-| Session Auto Title | in background, `/title` slash command | Give sessions titles                                    |
+| Extension          | Surface                                              | What it does                                            |
+| ------------------ | ---------------------------------------------------- | ------------------------------------------------------- |
+| Session Search     | `session_search` pi tool                             | Search through old sessions                             |
+| Session Ask        | `session_ask` pi tool                                | Ask questions about old sessions                        |
+| Session Handoff    | `/handoff`, `session_handoff` pi tool                | Start a focused new session; alternative to compaction  |
+| Session Messaging  | `session_list_live`, `session_send_message` pi tools | Send messages between running Pi sessions               |
+| Session Picker     | `Alt+O`                                              | Reference old sessions in your prompt                   |
+| Session Index      | `/session-index` slash command                       | Shows index status and rebuilds the local session index |
+| Session Auto Title | in background, `/title` slash command                | Give sessions titles                                    |
 
 ## Session Handoff
 
@@ -86,6 +87,15 @@ When running in Ghostty on macOS, pi-sessions also exposes a `session_handoff` t
 
 If background handoffs ever target the wrong pane, run `/handoff --identify` from the intended source pane to refresh the in-memory Ghostty terminal binding.
 
+## Session Messaging
+
+Agents can coordinate with other currently running Pi sessions:
+
+- `session_list_live` lists other live sessions
+- `session_send_message` sends a message to a live session
+
+Incoming messages start the recipient agent when idle and steer it when already running. Inactive sessions cannot receive messages, but you can still use `session_search` and `session_ask` with them.
+
 ## Session picker
 
 Directly reference prior sessions by looking them up by contents.

package/extensions/session-ask.ts

@@ -3,16 +3,16 @@ import { complete } from "@earendil-works/pi-ai/compat";
 import type { ExtensionAPI, Theme } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
-import { type RenderedSessionTree, renderSessionTreeMarkdown } from "./session-search/extract.js";
+import { type RenderedSessionTree, renderSessionTreeMarkdown } from "./session-search/extract.ts";
 import {
   getIndexStatus,
   getSessionById,
   INDEX_SCHEMA_VERSION,
   openIndexDatabase,
   type SessionLineageRow,
-} from "./shared/session-index/index.js";
-import { formatSessionTitleOrShortId, isExactSessionId } from "./shared/session-ui.js";
-import { loadSettings } from "./shared/settings.js";
+} from "./shared/session-index/index.ts";
+import { formatSessionTitleOrShortId, isExactSessionId } from "./shared/session-ui.ts";
+import { loadSettings } from "./shared/settings.ts";
 
 const SESSION_ASK_SYSTEM_PROMPT = `You are analyzing a Pi coding session transcript. The transcript includes the entire session tree, including abandoned branches and summaries.
 

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

@@ -1,6 +1,6 @@
 import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 import type { AutocompleteItem } from "@earendil-works/pi-tui";
-import { isTuiMode } from "../shared/pi-mode.js";
+import { isTuiMode } from "../shared/pi-mode.ts";
 
 export const TITLE_USAGE = "Usage: /title [this|folder|pi] [-f]";
 

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

@@ -1,13 +1,13 @@
 import { buildSessionContext, type ExtensionContext } from "@earendil-works/pi-coding-agent";
-import type { AutoTitleSettings } from "../shared/settings.js";
-import type { AutoTitleFailure } from "./generate.js";
+import type { AutoTitleSettings } from "../shared/settings.ts";
+import type { AutoTitleFailure } from "./generate.ts";
 import {
   type AutoTitleMode,
   type AutoTitlePersistedState,
   type AutoTitleTrigger,
   createAutoTitleState,
   getLatestAutoTitleState,
-} from "./state.js";
+} from "./state.ts";
 
 export interface SessionAutoTitleStateSnapshot {
   currentSessionFile: string | undefined;

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

@@ -4,8 +4,8 @@ import { join } from "node:path";
 import type { Api, Model, TextContent, UserMessage } from "@earendil-works/pi-ai";
 import { completeSimple } from "@earendil-works/pi-ai/compat";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-import type { AutoTitleContext } from "./context.js";
-import type { AutoTitleTrigger } from "./state.js";
+import type { AutoTitleContext } from "./context.ts";
+import type { AutoTitleTrigger } from "./state.ts";
 
 const AUTO_TITLE_REQUEST_TIMEOUT_MS = 15_000;
 const AUTO_TITLE_MAX_TOKENS = 64;

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

@@ -1,6 +1,6 @@
 import type { Api, Model } from "@earendil-works/pi-ai";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { ModelReference } from "../shared/settings.js";
+import { ModelReference } from "../shared/settings.ts";
 
 const DEFAULT_AUTO_TITLE_FALLBACK_MODELS: readonly ModelReference[] = [
   new ModelReference("google", "gemini-flash-lite-latest"),

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

@@ -6,19 +6,19 @@ import type {
   SessionInfo,
 } from "@earendil-works/pi-coding-agent";
 import { SessionManager } from "@earendil-works/pi-coding-agent";
-import type { RetitleMode, RetitleScope } from "./command.js";
-import { buildAutoTitleContext } from "./context.js";
-import type { AutoTitleTriggerPlan, SessionAutoTitleController } from "./controller.js";
+import type { RetitleMode, RetitleScope } from "./command.ts";
+import { buildAutoTitleContext } from "./context.ts";
+import type { AutoTitleTriggerPlan, SessionAutoTitleController } from "./controller.ts";
 import {
   type AutoTitleGenerationResult,
   createAutoTitleFailure,
   generateAutoTitle,
-} from "./generate.js";
+} from "./generate.ts";
 import {
   AUTO_TITLE_STATE_CUSTOM_TYPE,
   type AutoTitlePersistedState,
   createAutoTitleState,
-} from "./state.js";
+} from "./state.ts";
 
 export interface RetitleScopeScan {
   scope: Exclude<RetitleScope, "this">;

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

@@ -1,6 +1,6 @@
 import type { SessionEntry } from "@earendil-works/pi-coding-agent";
 import { type Static, Type } from "typebox";
-import { safeParseTypeBoxValue } from "../shared/typebox.js";
+import { safeParseTypeBoxValue } from "../shared/typebox.ts";
 
 export const AUTO_TITLE_STATE_CUSTOM_TYPE = "pi-sessions.auto-title";
 export const AUTO_TITLE_STATE_VERSION = 1;

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

@@ -7,9 +7,9 @@ import {
 } from "@earendil-works/pi-coding-agent";
 import type { Focusable, TUI } from "@earendil-works/pi-tui";
 import { matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import type { RetitleCommandOutcome, RetitleMode, RetitleScope } from "./command.js";
-import type { AutoRetitleStatus, SessionAutoTitleController } from "./controller.js";
-import type { AutoTitleFailure } from "./generate.js";
+import type { RetitleCommandOutcome, RetitleMode, RetitleScope } from "./command.ts";
+import type { AutoRetitleStatus, SessionAutoTitleController } from "./controller.ts";
+import type { AutoTitleFailure } from "./generate.ts";
 import {
   buildBulkRetitleMessage,
   buildRetitleScopeScan,
@@ -20,7 +20,7 @@ import {
   type RetitleScopeScan,
   runBulkRetitle,
   runRetitlePlan,
-} from "./retitle.js";
+} from "./retitle.ts";
 
 interface RetitleWizardOptions {
   initialInvocation?: {

package/extensions/session-auto-title.ts

@@ -11,29 +11,29 @@ import {
   getRetitleArgumentCompletions,
   type RetitleCommandInvocation,
   type RetitleCommandOutcome,
-} from "./session-auto-title/command.js";
+} from "./session-auto-title/command.ts";
 import {
   createSessionAutoTitleController,
   type SessionAutoTitleController,
-} from "./session-auto-title/controller.js";
-import { resolveAutoTitleModel } from "./session-auto-title/model.js";
+} from "./session-auto-title/controller.ts";
+import { resolveAutoTitleModel } from "./session-auto-title/model.ts";
 import {
   buildRetitleScopeScan,
   notifyBulkRetitleResult,
   persistAutoTitleState,
   runBulkRetitle,
   runRetitlePlan,
-} from "./session-auto-title/retitle.js";
-import { showRetitleWizard } from "./session-auto-title/wizard.js";
-import { isTuiMode } from "./shared/pi-mode.js";
-import { loadSettings } from "./shared/settings.js";
+} from "./session-auto-title/retitle.ts";
+import { showRetitleWizard } from "./session-auto-title/wizard.ts";
+import { isTuiMode } from "./shared/pi-mode.ts";
+import { loadSettings } from "./shared/settings.ts";
 
 export {
   createSessionAutoTitleCommandHandler,
   getRetitleArgumentCompletions,
   parseRetitleCommand,
   TITLE_USAGE,
-} from "./session-auto-title/command.js";
+} from "./session-auto-title/command.ts";
 
 interface TitleRunState {
   controller: SessionAutoTitleController;

package/extensions/session-handoff/extract.ts

@@ -19,7 +19,7 @@ import {
   serializeConversation,
 } from "@earendil-works/pi-coding-agent";
 import { type Static, Type } from "typebox";
-import { parseTypeBoxValue } from "../shared/typebox.js";
+import { parseTypeBoxValue } from "../shared/typebox.ts";
 
 const MAX_RELEVANT_FILES = 12;
 const MAX_OPEN_QUESTIONS = 8;
@@ -88,6 +88,7 @@ export async function generateHandoffDraft(
   goal: string,
   thinkingLevel: ThinkingLevel | undefined,
   signal?: AbortSignal,
+  requestResponse = false,
 ): Promise<HandoffDraftResult | undefined> {
   if (!ctx.model) {
     throw new Error("No model is available for handoff.");
@@ -99,6 +100,7 @@ export async function generateHandoffDraft(
     goal,
     thinkingLevel,
     signal,
+    requestResponse,
   );
 }
 
@@ -108,6 +110,7 @@ export async function generateHandoffDraftFromSessionManager(
   goal: string,
   thinkingLevel: ThinkingLevel | undefined,
   signal?: AbortSignal,
+  requestResponse = false,
 ): Promise<HandoffDraftResult | undefined> {
   if (!ctx.model) {
     throw new Error("No model is available for handoff.");
@@ -139,7 +142,7 @@ export async function generateHandoffDraftFromSessionManager(
   const sessionPath = sourceSessionManager.getSessionFile();
 
   return {
-    draft: assembleHandoffDraft(sessionId, sessionPath, handoffContext, goal),
+    draft: assembleHandoffDraft(sessionId, sessionPath, handoffContext, goal, requestResponse),
     context: handoffContext,
     sessionId,
     sessionPath,
@@ -241,8 +244,9 @@ export function assembleHandoffDraft(
   sessionPath: string | undefined,
   handoffContext: HandoffContext,
   goal: string,
+  requestResponse = false,
 ): string {
-  const sections = [buildContinuityLine(sessionId, sessionPath)];
+  const sections = [buildContinuityLine(sessionId, sessionPath, requestResponse)];
   const nextTask = handoffContext.nextTask.trim() || goal.trim();
 
   if (nextTask) {
@@ -326,8 +330,17 @@ function extractHandoffContextFromArguments(
   };
 }
 
-function buildContinuityLine(sessionId: string, _sessionPath: string | undefined): string {
-  return `Continuing work from session ${sessionId}. When you lack specific information you can use session_ask.`;
+function buildContinuityLine(
+  sessionId: string,
+  _sessionPath: string | undefined,
+  requestResponse: boolean,
+): string {
+  const base = `Continuing work from session ${sessionId}. When you lack specific information you can use session_ask.`;
+  if (!requestResponse) {
+    return base;
+  }
+
+  return `${base} When this work is complete, send that session a completion report with session_send_message.`;
 }
 
 function normalizeStringArray(value: unknown, limit: number): string[] {

package/extensions/session-handoff/metadata.ts

@@ -1,7 +1,7 @@
 import { Buffer } from "node:buffer";
 import type { CustomEntry, SessionEntry } from "@earendil-works/pi-coding-agent";
 import { type Static, Type } from "typebox";
-import { safeParseTypeBoxValue } from "../shared/typebox.js";
+import { safeParseTypeBoxValue } from "../shared/typebox.ts";
 
 export const HANDOFF_METADATA_CUSTOM_TYPE = "pi-sessions.handoff";
 export const HANDOFF_BOOTSTRAP_ENV = "PI_SESSIONS_HANDOFF_BOOTSTRAP";
@@ -30,6 +30,7 @@ export const CHILD_GENERATED_HANDOFF_BOOTSTRAP_SCHEMA = Type.Object({
   goal: Type.String(),
   title: Type.String(),
   parentSessionFile: Type.String(),
+  requestResponse: Type.Optional(Type.Boolean()),
 });
 
 export const HANDOFF_BOOTSTRAP_SCHEMA = Type.Union([
@@ -80,6 +81,7 @@ export function createChildGeneratedHandoffBootstrap(options: {
   goal: string;
   title: string;
   parentSessionFile: string;
+  requestResponse?: boolean | undefined;
 }): ChildGeneratedHandoffBootstrap {
   return {
     mode: "generate",
@@ -87,6 +89,7 @@ export function createChildGeneratedHandoffBootstrap(options: {
     goal: options.goal.trim(),
     title: options.title.trim(),
     parentSessionFile: options.parentSessionFile,
+    ...(options.requestResponse === undefined ? {} : { requestResponse: options.requestResponse }),
   };
 }
 

package/extensions/session-handoff/picker.ts

@@ -11,8 +11,8 @@ import {
 import {
   stripSearchSnippetMarkers,
   transformSearchSnippetMatches,
-} from "../shared/search-snippet.js";
-import { listSessionPickerItems, normalizeDisplayText, type SessionPickerItem } from "./query.js";
+} from "../shared/search-snippet.ts";
+import { listSessionPickerItems, normalizeDisplayText, type SessionPickerItem } from "./query.ts";
 
 const MAX_VISIBLE_BROWSE_ROWS = 10;
 const MAX_VISIBLE_SEARCH_ROWS = 4;

package/extensions/session-handoff/query.ts

@@ -1,7 +1,7 @@
-import { stripSearchSnippetMarkers } from "../shared/search-snippet.js";
+import { stripSearchSnippetMarkers } from "../shared/search-snippet.ts";
 import {
   getIndexStatus,
-  getLineageSessions,
+  getLineageRelationMap,
   getSessionByPath,
   INDEX_SCHEMA_VERSION,
   openIndexDatabase,
@@ -9,9 +9,9 @@ import {
   type SessionIndexDatabase,
   type SessionLineageRelation,
   searchSessions,
-} from "../shared/session-index/index.js";
-import { shortenSessionId } from "../shared/session-ui.js";
-import { formatCompactRelativeTime } from "../shared/time.js";
+} from "../shared/session-index/index.ts";
+import { shortenSessionId } from "../shared/session-ui.ts";
+import { formatCompactRelativeTime } from "../shared/time.ts";
 
 export const SESSION_TOKEN_PREFIX = "@session:";
 
@@ -127,9 +127,7 @@ function buildPresentationContext(
   return {
     currentSessionId,
     relationBySessionId: currentSessionId
-      ? new Map(
-          getLineageSessions(db, currentSessionId).map((row) => [row.sessionId, row.relation]),
-        )
+      ? getLineageRelationMap(db, currentSessionId)
       : new Map<string, SessionLineageRelation>(),
   };
 }

package/extensions/session-handoff/refs.ts

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { parseSessionFile } from "../session-search/extract.js";
+import { parseSessionFile } from "../session-search/extract.ts";
 import {
   getIndexStatus,
   getSessionById,
@@ -7,7 +7,7 @@ import {
   openIndexDatabase,
   type SessionLineageRow,
   type SessionOrigin,
-} from "../shared/session-index/index.js";
+} from "../shared/session-index/index.ts";
 
 const HANDOFF_REF_PREFIX = "@handoff/";
 const SESSION_REFERENCE_HELP =

package/extensions/session-handoff/spawn.ts

@@ -8,7 +8,7 @@ import {
   type SessionHeader,
   type SessionInfoEntry,
 } from "@earendil-works/pi-coding-agent";
-import { HANDOFF_BOOTSTRAP_ENV } from "./metadata.js";
+import { HANDOFF_BOOTSTRAP_ENV } from "./metadata.ts";
 
 const GHOSTTY_MACOS_ONLY_MESSAGE = "Split handoff currently supports Ghostty on macOS only.";
 const GHOSTTY_REQUIRED_MESSAGE = "Split handoff requires running inside Ghostty.";

package/extensions/session-handoff.ts

@@ -15,7 +15,7 @@ import {
   generateHandoffDraft,
   generateHandoffDraftFromSessionManager,
   type HandoffDraftResult,
-} from "./session-handoff/extract.js";
+} from "./session-handoff/extract.ts";
 import {
   type ChildGeneratedHandoffBootstrap,
   createChildGeneratedHandoffBootstrap,
@@ -29,14 +29,14 @@ import {
   hasUserMessages,
   isChildGeneratedHandoffBootstrap,
   parseHandoffBootstrap,
-} from "./session-handoff/metadata.js";
-import { openSessionReferencePicker } from "./session-handoff/picker.js";
-import { SESSION_TOKEN_PREFIX } from "./session-handoff/query.js";
+} from "./session-handoff/metadata.ts";
+import { openSessionReferencePicker } from "./session-handoff/picker.ts";
+import { SESSION_TOKEN_PREFIX } from "./session-handoff/query.ts";
 import {
   renderStrongModal,
   reviewHandoffDraft,
   reviewHandoffDraftForSend,
-} from "./session-handoff/review.js";
+} from "./session-handoff/review.ts";
 import {
   buildPiResumeCommand,
   createHandoffSession,
@@ -45,9 +45,9 @@ import {
   isGhosttyHandoffAvailable,
   launchSplitHandoffSession,
   validateSplitHandoffPrerequisites,
-} from "./session-handoff/spawn.js";
-import { isTuiMode } from "./shared/pi-mode.js";
-import { loadSettings } from "./shared/settings.js";
+} from "./session-handoff/spawn.ts";
+import { isTuiMode } from "./shared/pi-mode.ts";
+import { loadSettings } from "./shared/settings.ts";
 
 const HANDOFF_USAGE = "Usage: /handoff [--left|--right|--up|--down] <goal for new thread>";
 const TOOL_HANDOFF_PROVISIONAL_TITLE = "Session handoff";
@@ -58,6 +58,7 @@ interface HandoffToolParams {
   goal: string;
   splitDirection: HandoffSplitDirection;
   cwd?: string | undefined;
+  requestResponse?: boolean | undefined;
 }
 
 interface HandoffToolDetails {
@@ -110,6 +111,12 @@ export default function sessionHandoffExtension(pi: ExtensionAPI): void {
               "Optional target working directory. Relative paths resolve from the current session cwd.",
           }),
         ),
+        requestResponse: Type.Optional(
+          Type.Boolean({
+            description:
+              "Whether the child session should report completion/results of its task back to this session.",
+          }),
+        ),
       }),
       async execute(_toolCallId, params: HandoffToolParams, _signal, _onUpdate, ctx) {
         return executeSessionHandoffTool(pi, params, ctx, identifiedGhosttyTerminalId);
@@ -388,6 +395,7 @@ async function executeSessionHandoffTool(
     return createHandoffToolError("No conversation to hand off.");
   }
 
+  const requestResponse = params.requestResponse ?? false;
   const createdSession = createHandoffSession({
     cwd: targetCwd.path,
     sessionDir: ctx.sessionManager.getSessionDir(),
@@ -400,6 +408,7 @@ async function executeSessionHandoffTool(
       goal,
       title: TOOL_HANDOFF_PROVISIONAL_TITLE,
       parentSessionFile,
+      requestResponse,
     }),
   );
   const model = formatModelArgument(ctx.model, pi.getThinkingLevel());
@@ -482,6 +491,7 @@ async function startChildGeneratedHandoff(
           bootstrap.goal,
           thinkingLevel,
           signal,
+          bootstrap.requestResponse ?? false,
         ),
     );
     if (!generatedDraft) {

package/extensions/session-hooks.ts

@@ -1,7 +1,7 @@
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { HANDOFF_BOOTSTRAP_ENV, parseHandoffBootstrap } from "./session-handoff/metadata.js";
-import { createSessionHookController } from "./session-search/hooks.js";
-import { loadSettings } from "./shared/settings.js";
+import { HANDOFF_BOOTSTRAP_ENV, parseHandoffBootstrap } from "./session-handoff/metadata.ts";
+import { createSessionHookController } from "./session-search/hooks.ts";
+import { loadSettings } from "./shared/settings.ts";
 
 interface SessionStartLifecycleEvent {
   reason?: "startup" | "reload" | "new" | "resume" | "fork";

package/extensions/session-index.ts

@@ -5,10 +5,10 @@ import {
   type Theme,
 } from "@earendil-works/pi-coding-agent";
 import { type Focusable, matchesKey, visibleWidth } from "@earendil-works/pi-tui";
-import { type ReindexResult, rebuildSessionIndex } from "./session-search/reindex.js";
-import { isTuiMode } from "./shared/pi-mode.js";
-import { getIndexStatus, type SessionIndexStatus } from "./shared/session-index/index.js";
-import { loadSettings } from "./shared/settings.js";
+import { type ReindexResult, rebuildSessionIndex } from "./session-search/reindex.ts";
+import { isTuiMode } from "./shared/pi-mode.ts";
+import { getIndexStatus, type SessionIndexStatus } from "./shared/session-index/index.ts";
+import { loadSettings } from "./shared/settings.ts";
 
 type SessionIndexAction = "reindex" | undefined;