@oh-my-pi/pi-coding-agent 17.2.5 → 17.2.6

package/dist/types/session/agent-session-types.d.ts

@@ -357,6 +357,11 @@ export interface FreshSessionResult {
     sessionId: string;
     closedProviderSessions: number;
 }
+/** Outcome of an in-place `/reset` conversation-context reset. */
+export interface ResetSessionContextResult {
+    /** Number of live messages dropped from the model's context. */
+    droppedCount: number;
+}
 /** Queued user content restored to the editor. */
 export type RestoredQueuedMessage = {
     text: string;

package/dist/types/session/agent-session.d.ts

@@ -37,6 +37,7 @@ import { GoalRuntime } from "../goals/runtime.js";
 import type { GoalModeState } from "../goals/state.js";
 import type { HindsightSessionState } from "../hindsight/state.js";
 import type { IrcMessage } from "../irc/bus.js";
+import type { DaemonCompletionNotification } from "../launch/protocol.js";
 import { type MnemopiSessionState } from "../mnemopi/state.js";
 import { type PlanApprovalDetails } from "../plan-mode/approved-plan.js";
 import type { PlanModeState } from "../plan-mode/state.js";
@@ -49,7 +50,7 @@ import type { TodoPhase } from "../tools/todo.js";
 import type { InspectImageMode } from "../utils/inspect-image-mode.js";
 import type { VibeModeState } from "../vibe/state.js";
 import type { AgentSessionEventListener } from "./agent-session-events.js";
-import type { AgentSessionConfig, AgentSessionDisposeOptions, AsyncJobSnapshot, CommandMetadataChangedListener, ContextUsageBreakdown, FollowUpOptions, FreshSessionResult, HandoffResult, ModelCycleResult, Prewalk, PromptOptions, ResolvedRoleModel, RestoredQueuedMessage, RoleModelCycle, RoleModelCycleResult, SessionHandoffOptions, SessionOAuthAccountList, SessionStats, UsageFallbackConfirmation } from "./agent-session-types.js";
+import type { AgentSessionConfig, AgentSessionDisposeOptions, AsyncJobSnapshot, CommandMetadataChangedListener, ContextUsageBreakdown, FollowUpOptions, FreshSessionResult, HandoffResult, ModelCycleResult, Prewalk, PromptOptions, ResetSessionContextResult, ResolvedRoleModel, RestoredQueuedMessage, RoleModelCycle, RoleModelCycleResult, SessionHandoffOptions, SessionOAuthAccountList, SessionStats, UsageFallbackConfirmation } from "./agent-session-types.js";
 import type { ClientBridge } from "./client-bridge.js";
 import { type CustomMessage, type CustomMessagePayload } from "./messages.js";
 import { type AdvisorStats } from "./session-advisors.js";
@@ -180,6 +181,8 @@ export declare class AgentSession {
      * Multiple listeners can be added. Returns unsubscribe function for this listener.
      */
     subscribe(listener: AgentSessionEventListener): () => void;
+    /** Register cleanup that runs when this AgentSession adopts a different session ID. */
+    registerSessionChangeCallback(callback: () => void): () => void;
     subscribeCommandMetadataChanged(listener: CommandMetadataChangedListener): () => void;
     /** Run one abortable auto-learn capture outside the primary agent loop. */
     runAutolearnCapture(capture: (signal: AbortSignal) => Promise<void>): Promise<void>;
@@ -199,6 +202,25 @@ export declare class AgentSession {
     beginDispose(): void;
     dispose(options?: AgentSessionDisposeOptions): Promise<void>;
     freshSession(): FreshSessionResult | undefined;
+    /**
+     * Reset the current conversation in place: drop every message, queued turn,
+     * and pending tool call from the model's context while keeping the session
+     * itself — its id, title, cwd, model, settings, and on-disk transcript all
+     * survive. The next turn is sent with only the base system prompt plus the
+     * project rules/AGENTS.md.
+     *
+     * This is the in-place sibling of {@link newSession}: it reuses the same
+     * conversation-boundary teardown (drop the conversation, rotate provider-side
+     * session state so providers that keep history server-side resume nothing,
+     * re-prime the advisors, and undo any memory promotion) but skips minting a
+     * new session id and opening a fresh transcript file. Unlike
+     * {@link freshSession} (which only rotates provider stream state) it also
+     * clears the conversation.
+     *
+     * Returns `undefined` without mutating anything while a response is
+     * streaming or a foreground bash/python execution is in flight.
+     */
+    resetSessionContext(): Promise<ResetSessionContextResult | undefined>;
     /** Full agent state */
     get state(): AgentState;
     /** Current model (may be undefined if not yet selected) */
@@ -476,6 +498,7 @@ export declare class AgentSession {
      */
     followUp(text: string, images?: ImageContent[], options?: FollowUpOptions): Promise<void>;
     queueDeferredMessage(message: CustomMessage): void;
+    queueLaunchCompletion(notification: DaemonCompletionNotification): Promise<void>;
     /**
      * Send a custom message to the session. Creates a CustomMessageEntry.
      *
@@ -805,7 +828,8 @@ export declare class AgentSession {
         selectedImages: ImageContent[];
         cancelled: boolean;
     }>;
-    branchFromBtw(question: string, assistantMessage: AssistantMessage): Promise<{
+    /** Promotes a completed /btw answer from the explicitly authorized session and leaf. */
+    branchFromBtw(question: string, assistantMessage: AssistantMessage, leafId: string, sessionId: string): Promise<{
         cancelled: boolean;
         sessionFile: string | undefined;
     }>;

package/dist/types/session/launch-completion.d.ts

@@ -0,0 +1,10 @@
+import type { DaemonCompletionNotification } from "../launch/protocol.js";
+import type { CustomMessage } from "./messages.js";
+/** Yield-queue kind for broker-owned supervised process completions. */
+export declare const LAUNCH_COMPLETION_MESSAGE_TYPE = "launch-completion";
+/** One broker completion awaiting injection into its owning session. */
+export type LaunchCompletionEntry = DaemonCompletionNotification;
+/** Whether a broker completion belongs to the primary session or its advisor. */
+export declare function isLaunchCompletionOwner(owner: string, sessionId: string): boolean;
+/** Build one model-visible notification per terminal supervised process exit. */
+export declare function buildLaunchCompletionBatchMessage(entries: LaunchCompletionEntry[]): CustomMessage;

package/dist/types/session/session-entries.d.ts

@@ -31,6 +31,8 @@ export interface SessionHeader {
      */
     additionalDirectories?: string[];
     parentSession?: string;
+    /** Prior absolute JSONL locations recorded by successful session moves. */
+    previousSessionFiles?: string[];
     /** Provider prompt-cache identity inherited by exact-route full forks. */
     providerPromptCacheKey?: string;
 }
@@ -102,6 +104,17 @@ export interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {
     /** True if generated by an extension, false if pi-generated */
     fromExtension?: boolean;
 }
+/**
+ * Pure marker entry recorded by `/reset` (resetSessionContext). It carries no
+ * payload — its presence on the branch is a durable boundary the collapsed
+ * live transcript and the model-context rebuild start emission after, so a
+ * rebuild (theme change, focus attach, /shake, resume) does not resurrect the
+ * pre-reset conversation. The on-disk record and the plain `transcript:true`
+ * export path keep the full pre-reset history.
+ */
+export interface ResetBoundaryEntry extends SessionEntryBase {
+    type: "reset_boundary";
+}
 /**
  * Custom entry for extensions to store extension-specific data in the session.
  * Use customType to identify your extension's entries.
@@ -135,6 +148,7 @@ declare module "@oh-my-pi/pi-agent-core/compaction/entries" {
     interface CustomCompactionSessionEntries {
         titleChange: TitleChangeEntry;
         credentialPin: CredentialPinEntry;
+        resetBoundary: ResetBoundaryEntry;
     }
 }
 /** TTSR injection entry - tracks which time-traveling rules have been injected this session. */
@@ -210,7 +224,7 @@ export interface CustomMessageEntry<T = unknown> extends SessionEntryBase {
     attribution?: MessageAttribution;
 }
 /** Session entry - has id/parentId for tree structure (returned by "read" methods in SessionManager) */
-export type SessionEntry = SessionMessageEntry | ThinkingLevelChangeEntry | ModelChangeEntry | ServiceTierChangeEntry | CompactionEntry | BranchSummaryEntry | CustomEntry | CustomMessageEntry | LabelEntry | TitleChangeEntry | TtsrInjectionEntry | SessionInitEntry | ModeChangeEntry | CredentialPinEntry;
+export type SessionEntry = SessionMessageEntry | ThinkingLevelChangeEntry | ModelChangeEntry | ServiceTierChangeEntry | CompactionEntry | BranchSummaryEntry | CustomEntry | CustomMessageEntry | LabelEntry | TitleChangeEntry | TtsrInjectionEntry | SessionInitEntry | ModeChangeEntry | CredentialPinEntry | ResetBoundaryEntry;
 /** Raw logical file entry after loaders strip any fixed-width title slot. */
 export type FileEntry = SessionHeader | SessionEntry;
 /** Physical JSONL entry before slot-aware loaders fold the title slot. */

package/dist/types/session/session-manager.d.ts

@@ -233,6 +233,13 @@ export declare class SessionManager {
         readSummarize?: boolean;
     }): string;
     appendCompaction<T = unknown>(summary: string, shortSummary: string | undefined, firstKeptEntryId: string, tokensBefore: number, details?: T, fromExtension?: boolean, preserveData?: Record<string, unknown>): string;
+    /**
+     * Append the durable conversation boundary recorded by `/reset`. The
+     * collapsed live transcript and the model-context rebuild start after the
+     * latest one, while the full history stays on disk (the plain
+     * `transcript:true` export walks it unchanged).
+     */
+    appendResetBoundary(): string;
     appendCustomEntry(customType: string, data?: unknown): string;
     /**
      * Rewrite the session file after in-place entry updates (e.g. pruning old tool

package/dist/types/session/yield-queue.d.ts

@@ -1,4 +1,4 @@
-import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
+import { type AgentMessage } from "@oh-my-pi/pi-agent-core";
 export interface YieldDispatcher<P> {
     /** Drop entries already delivered through another path. Called per-entry at flush time. */
     isStale?(entry: P): boolean;
@@ -19,7 +19,10 @@ export declare class YieldQueue {
     constructor(options: YieldQueueOptions);
     register<P>(kind: string, dispatcher: YieldDispatcher<P>): () => void;
     enqueue<P>(kind: string, entry: P): void;
+    enqueueWithReceipt<P>(kind: string, entry: P): Promise<void>;
     has(kind?: string): boolean;
+    /** Arrange an idle flush for entries queued near the end of a streaming run. */
+    requestIdleFlush(): void;
     flush(mode: YieldFlushMode): Promise<void>;
     /**
      * Snapshot and remove all queued entries, returning one lazy thunk per kind.
@@ -33,5 +36,7 @@ export declare class YieldQueue {
     /** Drop queued entries. With `kind`, drop only that kind's entries (leaving
      *  any pending idle-flush for other kinds intact); otherwise drop everything. */
     clear(kind?: string): void;
+    /** Clear a scheduled-flush latch when its host task is cancelled before running. */
+    cancelIdleFlushScheduling(): void;
 }
 export {};

package/dist/types/tools/index.d.ts

@@ -10,6 +10,7 @@ import type { Skill } from "../extensibility/skills.js";
 import type { GoalModeState, GoalRuntime } from "../goals/index.js";
 import type { HindsightSessionState } from "../hindsight/state.js";
 import type { LocalProtocolOptions } from "../internal-urls/index.js";
+import type { DaemonCompletionNotification } from "../launch/protocol.js";
 import type { MCPManager } from "../mcp/index.js";
 import type { MnemopiSessionState } from "../mnemopi/state.js";
 import type { PlanModeState } from "../plan-mode/state.js";
@@ -115,6 +116,8 @@ export interface ToolSession {
     additionalDirectories?: string[];
     /** Whether UI is available */
     hasUI: boolean;
+    /** Whether this session has begun disposal. */
+    isDisposed?: () => boolean;
     /**
      * Suppress the spawn specialization/coordination advisory appended to `task`
      * results. Set by internal/programmatic callers (e.g. the commit agent's
@@ -345,6 +348,12 @@ export interface ToolSession {
     noopLoopGuard?: import("../edit/hashline/noop-loop-guard.js").NoopLoopGuard;
     /** Queue a hidden message to be injected at the next agent turn. */
     queueDeferredMessage?(message: CustomMessage): void;
+    /** Queue a broker supervised-process completion for the owning session. */
+    queueLaunchCompletion?(notification: DaemonCompletionNotification): Promise<void>;
+    /** Register cleanup that runs when this session is disposed; returns a handle that removes the cleanup. */
+    registerDisposeCallback?(callback: () => void): (() => void) | void;
+    /** Register cleanup that runs when this ToolSession adopts a different session ID. */
+    registerSessionChangeCallback?(callback: () => void): (() => void) | void;
     /** Queue late LSP diagnostics (arrived after an edit/write returned) to be shown
      *  in the transcript and delivered to the model at the next yield, like background
      *  job results. */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "17.2.5",
+	"version": "17.2.6",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -52,17 +52,17 @@
 		"@agentclientprotocol/sdk": "1.2.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "17.2.5",
-		"@oh-my-pi/omp-stats": "17.2.5",
-		"@oh-my-pi/pi-agent-core": "17.2.5",
-		"@oh-my-pi/pi-ai": "17.2.5",
-		"@oh-my-pi/pi-catalog": "17.2.5",
-		"@oh-my-pi/pi-mnemopi": "17.2.5",
-		"@oh-my-pi/pi-natives": "17.2.5",
-		"@oh-my-pi/pi-tui": "17.2.5",
-		"@oh-my-pi/pi-utils": "17.2.5",
-		"@oh-my-pi/pi-wire": "17.2.5",
-		"@oh-my-pi/snapcompact": "17.2.5",
+		"@oh-my-pi/hashline": "17.2.6",
+		"@oh-my-pi/omp-stats": "17.2.6",
+		"@oh-my-pi/pi-agent-core": "17.2.6",
+		"@oh-my-pi/pi-ai": "17.2.6",
+		"@oh-my-pi/pi-catalog": "17.2.6",
+		"@oh-my-pi/pi-mnemopi": "17.2.6",
+		"@oh-my-pi/pi-natives": "17.2.6",
+		"@oh-my-pi/pi-tui": "17.2.6",
+		"@oh-my-pi/pi-utils": "17.2.6",
+		"@oh-my-pi/pi-wire": "17.2.6",
+		"@oh-my-pi/snapcompact": "17.2.6",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/api-logs": "^0.220.0",
 		"@opentelemetry/context-async-hooks": "^2.9.0",