@oh-my-pi/pi-coding-agent 16.1.21 → 16.1.23

package/dist/types/cli/gc-cli.d.ts

@@ -0,0 +1,58 @@
+export interface GcCommandFlags {
+    apply?: boolean;
+    json?: boolean;
+    agentDir?: string;
+    blobs?: boolean;
+    archive?: boolean;
+    wal?: boolean;
+    coldArchiveAfterDays?: number;
+    retainNewestGlobal?: number;
+    retainNewestPerCwd?: number;
+}
+export interface GcCommandArgs {
+    flags: GcCommandFlags;
+}
+export interface BlobGcResult {
+    referenced: number;
+    candidates: number;
+    wouldDelete: number;
+    deleted: number;
+    bytes: number;
+    errors: string[];
+}
+export interface ArchiveGcResult {
+    scanned: number;
+    skippedActive: number;
+    keptNewestGlobal: number;
+    keptNewestPerCwd: number;
+    wouldArchive: number;
+    archived: number;
+    historyRowsDeleted: number;
+    ftsRebuilt: boolean;
+    errors: string[];
+}
+export interface WalCheckpointResult {
+    dbPath: string;
+    walBytes: number;
+    wouldCheckpoint: boolean;
+    checkpointed: boolean;
+    busy: number;
+    log: number;
+    checkpointedFrames: number;
+}
+export interface WalGcResult {
+    databases: WalCheckpointResult[];
+    walBytes: number;
+    wouldCheckpoint: boolean;
+    checkpointed: boolean;
+}
+export interface GcResult {
+    agentDir: string;
+    apply: boolean;
+    blobs?: BlobGcResult;
+    archive?: ArchiveGcResult;
+    wal?: WalGcResult;
+    lockPath: string;
+}
+export declare function collectGcErrors(result: GcResult): string[];
+export declare function runGcCommand(args: GcCommandArgs): Promise<GcResult>;

package/dist/types/commands/gc.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Run on-disk storage maintenance.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Gc extends Command {
+    static description: string;
+    static flags: {
+        apply: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        json: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "agent-dir": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        blobs: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        archive: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        wal: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "cold-archive-after-days": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            description: string;
+        };
+        "retain-newest-global": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            description: string;
+        };
+        "retain-newest-per-cwd": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            description: string;
+        };
+    };
+    run(): Promise<void>;
+}

package/dist/types/config/settings-schema.d.ts

@@ -745,6 +745,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Render Markdown H1 headings at 2x scale using Kitty's OSC 66 text-sizing protocol. Only takes effect on Kitty terminals; ignored everywhere else. Off by default.";
         };
     };
+    readonly "tui.renderMermaid": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly group: "Display";
+            readonly label: "Render Mermaid Diagrams";
+            readonly description: "Render Mermaid fenced code blocks as ASCII diagrams";
+        };
+    };
     readonly "tui.hyperlinks": {
         readonly type: "enum";
         readonly values: readonly ["off", "auto", "always"];
@@ -1709,6 +1719,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Automatically compact context when it gets too large";
         };
     };
+    readonly "compaction.midTurnEnabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "context";
+            readonly group: "Compaction";
+            readonly label: "Mid-Turn Compaction";
+            readonly description: "Check thresholds at safe mid-turn tool-loop boundaries before the next provider request";
+        };
+    };
     readonly "compaction.strategy": {
         readonly type: "enum";
         readonly values: readonly ["context-full", "handoff", "shake", "snapcompact", "off"];
@@ -5062,6 +5082,30 @@ export declare const SETTINGS_SCHEMA: {
         readonly values: readonly ["unset", "granted", "denied"];
         readonly default: "unset";
     };
+    readonly "gc.blobs": {
+        readonly type: "boolean";
+        readonly default: true;
+    };
+    readonly "gc.archive": {
+        readonly type: "boolean";
+        readonly default: true;
+    };
+    readonly "gc.wal": {
+        readonly type: "boolean";
+        readonly default: true;
+    };
+    readonly "gc.coldArchiveAfterDays": {
+        readonly type: "number";
+        readonly default: 30;
+    };
+    readonly "gc.retainNewestGlobal": {
+        readonly type: "number";
+        readonly default: 20;
+    };
+    readonly "gc.retainNewestPerCwd": {
+        readonly type: "number";
+        readonly default: 10;
+    };
     readonly "thinkingBudgets.minimal": {
         readonly type: "number";
         readonly default: 1024;
@@ -5133,6 +5177,7 @@ export interface CompactionSettings {
     thresholdTokens: number;
     reserveTokens: number;
     keepRecentTokens: number;
+    midTurnEnabled: boolean;
     handoffSaveToDisk: boolean;
     autoContinue: boolean;
     remoteEnabled: boolean;
@@ -5262,6 +5307,14 @@ export interface CodexResetsSettings {
     minBlockedMinutes: number;
     keepCredits: number;
 }
+export interface GcSettings {
+    blobs: boolean;
+    archive: boolean;
+    wal: boolean;
+    coldArchiveAfterDays: number;
+    retainNewestGlobal: number;
+    retainNewestPerCwd: number;
+}
 /** Map group prefix -> typed settings interface */
 export interface GroupTypeMap {
     compaction: CompactionSettings;
@@ -5281,6 +5334,7 @@ export interface GroupTypeMap {
     cycleOrder: string[];
     shellMinimizer: ShellMinimizerSettings;
     codexResets: CodexResetsSettings;
+    gc: GcSettings;
 }
 export type GroupPrefix = keyof GroupTypeMap;
 export {};

package/dist/types/config/settings.d.ts

@@ -28,6 +28,8 @@ export interface SettingsOptions {
     agentDir?: string;
     /** Don't persist to disk (for tests) */
     inMemory?: boolean;
+    /** Read config sources without opening storage or writing migrations */
+    readOnly?: boolean;
     /** Initial overrides */
     overrides?: Partial<Record<SettingPath, unknown>>;
     /** Extra config.yml-style overlays loaded after global/project settings */
@@ -41,6 +43,15 @@ export declare class Settings {
      * Call once at startup before accessing `settings`.
      */
     static init(options?: SettingsOptions): Promise<Settings>;
+    /**
+     * Load effective settings from config.yml and project providers without
+     * opening agent.db, migrating legacy settings, or writing marker files.
+     */
+    static loadReadOnly(options?: SettingsOptions): Promise<Settings>;
+    /**
+     * Load a persisted settings instance without touching the global singleton.
+     */
+    static loadIsolated(options?: SettingsOptions): Promise<Settings>;
     /**
      * Create an isolated instance for testing.
      * Does not affect the global singleton.

package/dist/types/mcp/transports/stdio.d.ts

@@ -5,15 +5,39 @@
  * Messages are newline-delimited JSON.
  */
 import type { MCPRequestOptions, MCPStdioServerConfig, MCPTransport } from "../../mcp/types";
-/** Subprocess argv for launching an MCP stdio server. */
+/** Subprocess argv and platform-derived spawn flags for an MCP stdio server. */
 export interface StdioSpawnCommand {
     cmd: string[];
+    /**
+     * Hide the Windows console window for the direct child.
+     *
+     * Windows uses this only when the OMP host has no console to share. When
+     * the host is running inside a terminal, `windowsHide: true` maps to
+     * `CREATE_NO_WINDOW`, which strips that inheritable console from hidden
+     * `cmd.exe` / PowerShell wrapper chains. Their console grandchildren then
+     * allocate fresh visible conhost windows during startup or reconnects
+     * (#3567).
+     */
     windowsHide?: boolean;
+    /**
+     * Run the subprocess in its own session.
+     *
+     * POSIX: `true`. Detach → `setsid`, so the MCP process tree has no
+     * controlling terminal and terminal job-control signals (Ctrl+Z SIGTSTP,
+     * background-read SIGTTIN) cannot stop stdio servers such as
+     * `chrome-devtools-mcp` and leave our read loop blocked on silent pipes.
+     *
+     * Windows: `false`. There is no SIGTSTP/SIGTTIN to escape, and Windows
+     * wrapper chains must stay in the OMP console session so nested console
+     * grandchildren keep stdout routed through our pipe (#3544).
+     */
+    detached: boolean;
 }
 /** Inputs used to resolve platform-specific stdio spawn behavior. */
 export interface ResolveStdioSpawnOptions {
     cwd: string;
     env: Record<string, string | undefined>;
+    hostHasInheritableConsole?: boolean;
     platform?: NodeJS.Platform;
 }
 /**

package/dist/types/mcp/transports/stdio.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/modes/theme/mermaid-rendering.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/modes/theme/theme.d.ts

@@ -347,6 +347,7 @@ export declare function getThemeExportColors(themeName?: string): Promise<{
  */
 export declare function highlightCode(code: string, lang?: string, highlightTheme?: Theme): string[];
 export declare function getSymbolTheme(): SymbolTheme;
+export declare function setMarkdownMermaidRendering(enabled: boolean): void;
 export declare function getMarkdownTheme(): MarkdownTheme;
 export declare function getSelectListTheme(): SelectListTheme;
 export declare function getEditorTheme(): EditorTheme;

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

@@ -60,10 +60,19 @@ export declare function recoverOrphanedBackups(sessionDir: string, storage: Sess
  * file's lifecycle {@link SessionStatus}.
  */
 export declare function listSessions(sessionDir: string, storage: SessionStorage): Promise<SessionInfo[]>;
+/**
+ * List sessions without repairing orphaned backups or mutating the directory.
+ */
+export declare function listSessionsReadOnly(sessionDir: string, storage: SessionStorage): Promise<SessionInfo[]>;
 /** List all sessions across all project directories (newest first). */
 export declare function listAllSessions(storage?: SessionStorage): Promise<SessionInfo[]>;
 /** Exported for testing */
 export declare function findMostRecentSession(sessionDir: string, storage?: SessionStorage): Promise<string | null>;
 /** Get recent sessions for display in the welcome screen. */
 export declare function getRecentSessions(sessionDir: string, limit?: number, storage?: SessionStorage): Promise<RecentSessionInfo[]>;
-export declare function resolveResumableSession(sessionArg: string, cwd: string, sessionDir?: string, storage?: SessionStorage): Promise<ResolvedSessionMatch | undefined>;
+/** Controls cross-directory fallback for resumable session lookup. */
+export interface ResolveResumableSessionOptions {
+    /** Search default global session buckets after the active/custom session directory misses. */
+    allowGlobalFallback?: boolean;
+}
+export declare function resolveResumableSession(sessionArg: string, cwd: string, sessionDir?: string, storageOrOptions?: SessionStorage | ResolveResumableSessionOptions, options?: ResolveResumableSessionOptions): Promise<ResolvedSessionMatch | undefined>;

package/dist/types/system-prompt.d.ts

@@ -112,6 +112,8 @@ export interface BuildSystemPromptOptions {
     personality?: Personality;
     /** Whether to include the workspace directory tree in the system prompt. Default: false */
     includeWorkspaceTree?: boolean;
+    /** Whether Mermaid fenced blocks render as terminal ASCII diagrams. Default: true */
+    renderMermaid?: boolean;
 }
 /** Result of building provider-facing system prompt messages. */
 export interface BuildSystemPromptResult {

package/dist/types/tools/plan-mode-guard.d.ts

@@ -6,6 +6,13 @@ import type { ToolSession } from ".";
  *  resolver surfaces the real error. Exported for callers (e.g. `write`) that
  *  make scheme/bridge-routing decisions before {@link resolvePlanPath} runs. */
 export declare function unwrapHashlineHeaderPath(targetPath: string): string;
+/** True when `targetPath` resolves into the session-local artifact sandbox.
+ *  Routes through {@link resolvePlanPath} so the guard and the eventual write
+ *  always agree on the absolute target (including bracketed hashline headers,
+ *  `local://` URLs, and bare absolute paths). Files inside the sandbox are not
+ *  part of the working tree, so plan mode treats them as freely writable
+ *  scratch/plan space — and tag-based path recovery may rebind onto them. */
+export declare function targetsLocalSandbox(session: ToolSession, targetPath: string): boolean;
 /**
  * Resolve a write/edit target to its absolute filesystem path, honoring the
  * `local://` and `vault://` schemes. Plain paths resolve against the session cwd.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "16.1.21",
+	"version": "16.1.23",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -48,17 +48,17 @@
 		"@agentclientprotocol/sdk": "0.25.0",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "16.1.21",
-		"@oh-my-pi/omp-stats": "16.1.21",
-		"@oh-my-pi/pi-agent-core": "16.1.21",
-		"@oh-my-pi/pi-ai": "16.1.21",
-		"@oh-my-pi/pi-catalog": "16.1.21",
-		"@oh-my-pi/pi-mnemopi": "16.1.21",
-		"@oh-my-pi/pi-natives": "16.1.21",
-		"@oh-my-pi/pi-tui": "16.1.21",
-		"@oh-my-pi/pi-utils": "16.1.21",
-		"@oh-my-pi/pi-wire": "16.1.21",
-		"@oh-my-pi/snapcompact": "16.1.21",
+		"@oh-my-pi/hashline": "16.1.23",
+		"@oh-my-pi/omp-stats": "16.1.23",
+		"@oh-my-pi/pi-agent-core": "16.1.23",
+		"@oh-my-pi/pi-ai": "16.1.23",
+		"@oh-my-pi/pi-catalog": "16.1.23",
+		"@oh-my-pi/pi-mnemopi": "16.1.23",
+		"@oh-my-pi/pi-natives": "16.1.23",
+		"@oh-my-pi/pi-tui": "16.1.23",
+		"@oh-my-pi/pi-utils": "16.1.23",
+		"@oh-my-pi/pi-wire": "16.1.23",
+		"@oh-my-pi/snapcompact": "16.1.23",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",

package/scripts/bench-guard.ts

@@ -22,7 +22,7 @@ import * as path from "node:path";
 
 const THRESHOLD = 1.05; // 5% regression budget
 const BASELINE_PATH = path.join(import.meta.dir, "..", "bench", "boot-baseline.json");
-const BENCH_COMMAND = "PI_TIMING=x bun src/cli.ts";
+const BENCH_COMMAND = "PI_TIMING=x PI_STRICT_EDIT_MODE=1 bun src/cli.ts";
 const cwd = path.join(import.meta.dir, "..");
 
 function medianOf(hyperfineJson: string): number {