@oh-my-pi/pi-coding-agent 16.0.4 → 16.0.6

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

@@ -209,10 +209,51 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Pause the main agent for up to 30 seconds if the advisor falls behind by this many turns. Off disables catch-up delays.";
         };
     };
+    readonly "advisor.immuneTurns": {
+        readonly type: "number";
+        readonly default: 1;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Advisor";
+            readonly label: "Advisor Immune Turns";
+            readonly description: "After an advisor concern or blocker interrupts, route further concerns/blockers non-interruptingly for this many primary turns.";
+            readonly options: readonly [{
+                readonly value: "0";
+                readonly label: "0 turns";
+                readonly description: "Allow every concern/blocker to interrupt.";
+            }, {
+                readonly value: "1";
+                readonly label: "1 turn";
+                readonly description: "Default.";
+            }, {
+                readonly value: "2";
+                readonly label: "2 turns";
+            }, {
+                readonly value: "3";
+                readonly label: "3 turns";
+            }, {
+                readonly value: "4";
+                readonly label: "4 turns";
+            }, {
+                readonly value: "5";
+                readonly label: "5 turns";
+            }];
+        };
+    };
     readonly shellPath: {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly "git.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Git";
+            readonly label: "Enable Git Integration";
+            readonly description: "Show git branch, status, and PR information in the TUI and watch repository metadata.";
+        };
+    };
     readonly extensions: {
         readonly type: "array";
         readonly default: string[];
@@ -678,6 +719,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Prevent images from being sent to LLM providers";
         };
     };
+    readonly "images.describeForTextModels": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Vision";
+            readonly label: "Describe Images for Text Models";
+            readonly description: "When an image is attached to a model without vision support, save it under local:// and inject a description from a vision-capable model instead of dropping it";
+        };
+    };
     readonly "tui.maxInlineImageColumns": {
         readonly type: "number";
         readonly default: 100;
@@ -714,6 +765,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Wrap paths and URLs in OSC 8 hyperlinks for terminal-native click-to-open (auto: detect support; off: never; always: unconditional)";
         };
     };
+    readonly "tui.tight": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly group: "Display";
+            readonly label: "Tight Layout";
+            readonly description: "Remove the 1-character horizontal padding from the left and right of the terminal output";
+        };
+    };
     readonly "display.tabWidth": {
         readonly type: "number";
         readonly default: 3;
@@ -794,6 +855,26 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Hide thinking blocks in assistant responses";
         };
     };
+    readonly "model.loopGuard.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Thinking";
+            readonly label: "Loop Guard";
+            readonly description: "Enable automatic stream loop detection for Gemini and DeepSeek models";
+        };
+    };
+    readonly "model.loopGuard.checkAssistantContent": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Thinking";
+            readonly label: "Loop Guard Scan Prose";
+            readonly description: "Apply loop guard to assistant prose messages in addition to thinking logs";
+        };
+    };
     readonly repeatToolDescriptions: {
         readonly type: "boolean";
         readonly default: false;
@@ -1336,6 +1417,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Skip welcome screen and startup status messages";
         };
     };
+    readonly "startup.showSplash": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Startup & Updates";
+            readonly label: "Show Startup Splash";
+            readonly description: "Show the full animated setup splash on normal interactive startup without rerunning setup. Quiet Startup still suppresses it.";
+        };
+    };
     readonly "startup.setupWizard": {
         readonly type: "boolean";
         readonly default: true;
@@ -1550,7 +1641,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "contextPromotion.enabled": {
         readonly type: "boolean";
-        readonly default: true;
+        readonly default: false;
         readonly ui: {
             readonly tab: "context";
             readonly group: "General";
@@ -1875,7 +1966,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "tools.format": {
         readonly type: "enum";
-        readonly values: readonly ["auto", "native", "glm", "hermes", "kimi", "xml", "anthropic", "deepseek", "harmony", "pi", "qwen3", "gemini", "gemma"];
+        readonly values: readonly ["auto", "native", "glm", "hermes", "kimi", "xml", "anthropic", "deepseek", "harmony", "pi", "qwen3", "gemini", "gemma", "minimax"];
         readonly default: "auto";
         readonly ui: {
             readonly tab: "context";
@@ -1934,6 +2025,10 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "gemma";
                 readonly label: "Gemma";
                 readonly description: "Use the Gemma owned dialect.";
+            }, {
+                readonly value: "minimax";
+                readonly label: "MiniMax";
+                readonly description: "Use the MiniMax owned dialect.";
             }];
         };
     };
@@ -4052,7 +4147,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "providers.webSearch": {
         readonly type: "enum";
-        readonly values: readonly ["auto", "tavily", "perplexity", "brave", "jina", "kimi", "anthropic", "gemini", "codex", "zai", "exa", "parallel", "kagi", "synthetic", "searxng"];
+        readonly values: readonly ["auto", ...SearchProviderId[]];
         readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
@@ -4063,34 +4158,18 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "auto";
                 readonly label: "Auto";
                 readonly description: "Automatically uses the first configured web-search provider";
-            }, {
-                readonly value: "tavily";
-                readonly label: "Tavily";
-                readonly description: "Requires TAVILY_API_KEY";
             }, {
                 readonly value: "perplexity";
                 readonly label: "Perplexity";
                 readonly description: "Uses auth when configured; explicit selection falls back to anonymous search";
             }, {
-                readonly value: "brave";
-                readonly label: "Brave";
-                readonly description: "Requires BRAVE_API_KEY";
-            }, {
-                readonly value: "jina";
-                readonly label: "Jina";
-                readonly description: "Requires JINA_API_KEY";
-            }, {
-                readonly value: "kimi";
-                readonly label: "Kimi";
-                readonly description: "Requires MOONSHOT_SEARCH_API_KEY or MOONSHOT_API_KEY";
+                readonly value: "gemini";
+                readonly label: "Gemini";
+                readonly description: "Google Search grounding via Gemini (uses google-gemini-cli or google-antigravity OAuth)";
             }, {
                 readonly value: "anthropic";
                 readonly label: "Anthropic";
                 readonly description: "Claude's native web_search tool (uses Anthropic OAuth or ANTHROPIC_API_KEY)";
-            }, {
-                readonly value: "gemini";
-                readonly label: "Gemini";
-                readonly description: "Google Search grounding via Gemini (uses google-gemini-cli or google-antigravity OAuth)";
             }, {
                 readonly value: "codex";
                 readonly label: "OpenAI";
@@ -4104,13 +4183,29 @@ export declare const SETTINGS_SCHEMA: {
                 readonly label: "Exa";
                 readonly description: "Uses Exa API when EXA_API_KEY is set; falls back to Exa MCP";
             }, {
-                readonly value: "parallel";
-                readonly label: "Parallel";
-                readonly description: "Requires PARALLEL_API_KEY";
+                readonly value: "jina";
+                readonly label: "Jina";
+                readonly description: "Requires JINA_API_KEY";
             }, {
                 readonly value: "kagi";
                 readonly label: "Kagi";
                 readonly description: "Requires KAGI_API_KEY and Kagi Search API beta access";
+            }, {
+                readonly value: "tavily";
+                readonly label: "Tavily";
+                readonly description: "Requires TAVILY_API_KEY";
+            }, {
+                readonly value: "brave";
+                readonly label: "Brave";
+                readonly description: "Requires BRAVE_API_KEY";
+            }, {
+                readonly value: "kimi";
+                readonly label: "Kimi";
+                readonly description: "Requires MOONSHOT_SEARCH_API_KEY or MOONSHOT_API_KEY";
+            }, {
+                readonly value: "parallel";
+                readonly label: "Parallel";
+                readonly description: "Requires PARALLEL_API_KEY";
             }, {
                 readonly value: "synthetic";
                 readonly label: "Synthetic";
@@ -4132,6 +4227,30 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Providers that web_search should never use, even as fallbacks";
         };
     };
+    readonly "providers.antigravityEndpoint": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "production", "sandbox"];
+        readonly default: "auto";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Antigravity Endpoint Mode";
+            readonly description: "Endpoint routing strategy for google-antigravity providers (chat, search, image, discovery)";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Try production endpoint, fail over to sandbox on 5xx/429";
+            }, {
+                readonly value: "production";
+                readonly label: "Production Only";
+                readonly description: "Force production endpoint only";
+            }, {
+                readonly value: "sandbox";
+                readonly label: "Sandbox Only";
+                readonly description: "Force sandbox endpoint only";
+            }];
+        };
+    };
     readonly "providers.image": {
         readonly type: "enum";
         readonly values: readonly ["auto", "openai", "antigravity", "xai", "gemini", "openrouter"];

package/dist/types/edit/hashline/params.d.ts

@@ -1,11 +1,7 @@
-/**
- * Zod schema for the `edit` tool's hashline mode payload. The schema is
- * deliberately permissive (`.passthrough()`) so providers can attach extra
- * keys without rejection; only `input` is required. `_input` is accepted as a
- * provider-emitted alias for `input`.
- */
-import { z } from "zod/v4";
-export declare const hashlineEditParamsSchema: z.ZodPreprocess<z.ZodObject<{
-    input: z.ZodString;
-}, z.core.$loose>>;
-export type HashlineParams = z.infer<typeof hashlineEditParamsSchema>;
+export declare const hashlineEditParamsSchema: import("arktype/internal/variants/object.ts").ObjectType<(In: {
+    input?: string | undefined;
+    _input?: string | undefined;
+}) => import("arktype/internal/attributes.ts").To<{
+    input: string;
+}>, {}>;
+export type HashlineParams = Parameters<typeof hashlineEditParamsSchema.assert>[0];

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

@@ -2,7 +2,7 @@ import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallb
 import type { ToolExample } from "@oh-my-pi/pi-ai";
 import type { ToolSession } from "../tools";
 import { type EditMode } from "../utils/edit-mode";
-import { type HashlineParams, hashlineEditParamsSchema } from "./hashline";
+import { hashlineEditParamsSchema } from "./hashline";
 import { type ApplyPatchParams, applyPatchSchema } from "./modes/apply-patch";
 import { type PatchParams, patchEditSchema } from "./modes/patch";
 import { type ReplaceParams, replaceEditSchema } from "./modes/replace";
@@ -20,6 +20,7 @@ export * from "./normalize";
 export * from "./renderer";
 export * from "./streaming";
 type TInput = typeof replaceEditSchema | typeof patchEditSchema | typeof hashlineEditParamsSchema | typeof applyPatchSchema;
+type HashlineParams = typeof hashlineEditParamsSchema.infer;
 type EditParams = ReplaceParams | PatchParams | HashlineParams | ApplyPatchParams;
 export declare class EditTool implements AgentTool<TInput> {
     #private;

package/dist/types/edit/modes/apply-patch.d.ts

@@ -7,12 +7,11 @@
  * LSP writethrough, fs-cache invalidation, diagnostics) is shared with
  * the `patch` mode.
  */
-import { z } from "zod/v4";
 import type { PatchEditEntry } from "./patch";
-export declare const applyPatchSchema: z.ZodObject<{
-    input: z.ZodString;
-}, z.core.$strip>;
-export type ApplyPatchParams = z.infer<typeof applyPatchSchema>;
+export declare const applyPatchSchema: import("arktype/internal/variants/object.ts").ObjectType<{
+    input: string;
+}, {}>;
+export type ApplyPatchParams = typeof applyPatchSchema.infer;
 export type ApplyPatchEntry = PatchEditEntry & {
     path: string;
 };

package/dist/types/edit/modes/patch.d.ts

@@ -5,7 +5,6 @@
  * for robust handling of whitespace and formatting differences.
  */
 import type { AgentToolResult } from "@oh-my-pi/pi-agent-core";
-import { z } from "zod/v4";
 import { type WritethroughCallback, type WritethroughDeferredHandle } from "../../lsp";
 import type { ToolSession } from "../../tools";
 import type { EditToolDetails, LspBatchRequest } from "../renderer";
@@ -61,29 +60,21 @@ export declare function computePatchDiff(input: PatchInput, cwd: string, options
 } | {
     error: string;
 }>;
-export declare const patchEditEntrySchema: z.ZodObject<{
-    op: z.ZodOptional<z.ZodEnum<{
-        create: "create";
-        delete: "delete";
-        update: "update";
-    }>>;
-    rename: z.ZodOptional<z.ZodString>;
-    diff: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export declare const patchEditSchema: z.ZodObject<{
-    path: z.ZodString;
-    edits: z.ZodArray<z.ZodObject<{
-        op: z.ZodOptional<z.ZodEnum<{
-            create: "create";
-            delete: "delete";
-            update: "update";
-        }>>;
-        rename: z.ZodOptional<z.ZodString>;
-        diff: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-export type PatchEditEntry = z.infer<typeof patchEditEntrySchema>;
-export type PatchParams = z.infer<typeof patchEditSchema>;
+export declare const patchEditEntrySchema: import("arktype/internal/variants/object.ts").ObjectType<{
+    op?: "create" | "delete" | "update" | undefined;
+    rename?: string | undefined;
+    diff?: string | undefined;
+}, {}>;
+export type PatchEditEntry = typeof patchEditEntrySchema.infer;
+export declare const patchEditSchema: import("arktype/internal/variants/object.ts").ObjectType<{
+    path: string;
+    edits: {
+        op?: "create" | "delete" | "update" | undefined;
+        rename?: string | undefined;
+        diff?: string | undefined;
+    }[];
+}, {}>;
+export type PatchParams = typeof patchEditSchema.infer;
 export interface ExecutePatchSingleOptions {
     session: ToolSession;
     path: string;

package/dist/types/edit/modes/replace.d.ts

@@ -5,7 +5,6 @@
  * fallback strategies for finding text in files.
  */
 import type { AgentToolResult } from "@oh-my-pi/pi-agent-core";
-import { z } from "zod/v4";
 import type { WritethroughCallback, WritethroughDeferredHandle } from "../../lsp";
 import type { ToolSession } from "../../tools";
 import type { EditToolDetails, LspBatchRequest } from "../renderer";
@@ -113,21 +112,21 @@ export declare function findContextLine(lines: string[], context: string, startF
     allowFuzzy?: boolean;
     skipFunctionFallback?: boolean;
 }): ContextLineResult;
-export declare const replaceEditEntrySchema: z.ZodObject<{
-    old_text: z.ZodString;
-    new_text: z.ZodString;
-    all: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strict>;
-export declare const replaceEditSchema: z.ZodObject<{
-    path: z.ZodString;
-    edits: z.ZodArray<z.ZodObject<{
-        old_text: z.ZodString;
-        new_text: z.ZodString;
-        all: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-export type ReplaceEditEntry = z.infer<typeof replaceEditEntrySchema>;
-export type ReplaceParams = z.infer<typeof replaceEditSchema>;
+export declare const replaceEditEntrySchema: import("arktype/internal/variants/object.ts").ObjectType<{
+    old_text: string;
+    new_text: string;
+    all?: boolean | undefined;
+}, {}>;
+export declare const replaceEditSchema: import("arktype/internal/variants/object.ts").ObjectType<{
+    path: string;
+    edits: {
+        old_text: string;
+        new_text: string;
+        all?: boolean | undefined;
+    }[];
+}, {}>;
+export type ReplaceEditEntry = typeof replaceEditEntrySchema.infer;
+export type ReplaceParams = typeof replaceEditSchema.infer;
 export interface ExecuteReplaceSingleOptions {
     session: ToolSession;
     path: string;
@@ -139,4 +138,4 @@ export interface ExecuteReplaceSingleOptions {
     writethrough: WritethroughCallback;
     beginDeferredDiagnosticsForPath: (path: string) => WritethroughDeferredHandle;
 }
-export declare function executeReplaceSingle(options: ExecuteReplaceSingleOptions): Promise<AgentToolResult<EditToolDetails, typeof replaceEditEntrySchema>>;
+export declare function executeReplaceSingle(options: ExecuteReplaceSingleOptions): Promise<AgentToolResult<EditToolDetails, ReplaceEditEntry>>;

package/dist/types/eval/js/index.d.ts

@@ -1,5 +1,6 @@
 import type { ToolSession } from "../../tools";
 import { type ExecutorBackendExecOptions, type ExecutorBackendResult } from "../backend";
+export declare function namespaceSessionId(sessionId: string): string;
 declare const _default: {
     id: "js";
     label: string;

package/dist/types/extensibility/custom-commands/types.d.ts

@@ -5,7 +5,8 @@
  * Unlike markdown commands which expand to prompts, custom commands can execute
  * arbitrary logic with full access to the hook context.
  */
-import type { z } from "zod/v4";
+import type * as arktype from "arktype";
+import type * as zod from "zod/v4";
 import type { ExecOptions, ExecResult, HookCommandContext } from "../../extensibility/hooks/types";
 import type * as PiCodingAgent from "../../index";
 import type * as TypeBox from "../typebox";
@@ -21,8 +22,10 @@ export interface CustomCommandAPI {
     exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
     /** Injected zod-backed typebox shim (legacy/compat). */
     typebox: typeof TypeBox;
-    /** Injected zod module for Zod-authored custom commands. */
-    zod: typeof z;
+    /** Injected arktype module for validation in custom commands. */
+    arktype: typeof arktype;
+    /** Injected zod/v4 module for canonical command validation. */
+    zod: typeof zod;
     /** Injected pi-coding-agent exports */
     pi: typeof PiCodingAgent;
 }

package/dist/types/extensibility/custom-tools/types.d.ts

@@ -9,7 +9,8 @@ import type { CompactionResult } from "@oh-my-pi/pi-agent-core/compaction";
 import type { FetchImpl, Model, Static, TSchema } from "@oh-my-pi/pi-ai";
 import type { Component } from "@oh-my-pi/pi-tui";
 import type { logger as PiLogger } from "@oh-my-pi/pi-utils";
-import type { z } from "zod/v4";
+import type { type as ArkType } from "arktype";
+import type * as zod from "zod/v4";
 import type { Rule } from "../../capability/rule";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { Settings } from "../../config/settings";
@@ -50,10 +51,12 @@ export interface CustomToolAPI {
     hasUI: boolean;
     /** File logger for error/warning/debug messages */
     logger: typeof PiLogger;
-    /** Injected zod-backed typebox shim (legacy/compat — Zod-authored tools are preferred). */
+    /** Injected typebox shim (legacy/compat — arktype-authored tools are preferred). */
     typebox: typeof TypeBox;
-    /** Injected zod module for Zod-authored custom tools. */
-    zod: typeof z;
+    /** Injected arktype module for arktype-authored custom tools. */
+    arktype: typeof ArkType;
+    /** Injected zod/v4 module for canonical parameter schemas. */
+    zod: typeof zod;
     /** Injected pi-coding-agent exports */
     pi: typeof PiCodingAgent;
     /** Push a preview action that can later be resolved with the hidden resolve tool */
@@ -172,7 +175,7 @@ export interface CustomTool<TParams extends TSchema = TSchema, TDetails = any> {
     strict?: boolean;
     /** Description for LLM */
     description: string;
-    /** Parameter schema (Zod or TypeBox; TypeBox is auto-lifted to Zod at registration). */
+    /** Parameter schema (arktype, TypeBox, or legacy formats). */
     parameters: TParams;
     /** If true, tool is excluded unless explicitly listed in --tools or agent's tools field */
     hidden?: boolean;

package/dist/types/extensibility/extensions/runner.d.ts

@@ -8,7 +8,7 @@ import type { ModelRegistry } from "../../config/model-registry";
 import type { Settings } from "../../config/settings";
 import type { MemoryRuntimeContext } from "../../memory-backend";
 import type { SessionManager } from "../../session/session-manager";
-import type { AfterProviderResponseEvent, AssistantThinkingRenderer, BeforeAgentStartEvent, BeforeAgentStartEventResult, BeforeProviderRequestEvent, BeforeProviderRequestEventResult, ContextEvent, Extension, ExtensionActions, ExtensionCommandContext, ExtensionCommandContextActions, ExtensionContext, ExtensionContextActions, ExtensionError, ExtensionEvent, ExtensionFlag, ExtensionRuntime, ExtensionShortcut, ExtensionUIContext, InputEvent, InputEventResult, MessageRenderer, RegisteredCommand, RegisteredTool, ResourcesDiscoverEvent, SessionBeforeBranchResult, SessionBeforeCompactResult, SessionBeforeSwitchResult, SessionBeforeTreeResult, SessionCompactingResult, ToolCallEvent, ToolCallEventResult, ToolResultEvent, ToolResultEventResult, UserBashEvent, UserBashEventResult, UserPythonEvent, UserPythonEventResult } from "./types";
+import type { AfterProviderResponseEvent, AssistantThinkingRenderer, BeforeAgentStartEvent, BeforeAgentStartEventResult, BeforeProviderRequestEvent, BeforeProviderRequestEventResult, ContextEvent, Extension, ExtensionActions, ExtensionCommandContext, ExtensionCommandContextActions, ExtensionContext, ExtensionContextActions, ExtensionError, ExtensionEvent, ExtensionFlag, ExtensionRuntime, ExtensionShortcut, ExtensionUIContext, InputEvent, InputEventResult, MessageRenderer, RegisteredCommand, RegisteredTool, ResourcesDiscoverEvent, SessionBeforeBranchResult, SessionBeforeCompactResult, SessionBeforeSwitchResult, SessionBeforeTreeResult, SessionCompactingResult, SessionStopEvent, SessionStopEventResult, ToolCallEvent, ToolCallEventResult, ToolResultEvent, ToolResultEventResult, UserBashEvent, UserBashEventResult, UserPythonEvent, UserPythonEventResult } from "./types";
 /** Combined result from all before_agent_start handlers */
 interface BeforeAgentStartCombinedResult {
     messages?: NonNullable<BeforeAgentStartEventResult["message"]>[];
@@ -43,7 +43,9 @@ type RunnerEmitResult<TEvent extends RunnerEmitEvent> = TEvent extends {
     type: "session_before_tree";
 } ? SessionBeforeTreeResult | undefined : TEvent extends {
     type: "session.compacting";
-} ? SessionCompactingResult | undefined : undefined;
+} ? SessionCompactingResult | undefined : TEvent extends {
+    type: "session_stop";
+} ? SessionStopEventResult | undefined : undefined;
 export type NewSessionHandler = (options?: {
     parentSession?: string;
     setup?: (sessionManager: SessionManager) => Promise<void>;
@@ -92,6 +94,7 @@ export declare class ExtensionRunner {
      * {@link onError} via {@link emit}'s normal isolation.
      */
     emitCredentialDisabled(event: CredentialDisabledEvent): Promise<void>;
+    emitSessionStop(event: Omit<SessionStopEvent, "type">): Promise<SessionStopEventResult | undefined>;
     getUIContext(): ExtensionUIContext;
     hasUI(): boolean;
     getExtensionPaths(): string[];

package/dist/types/extensibility/extensions/types.d.ts

@@ -13,7 +13,8 @@ import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context,
 import type { OAuthCredentials, OAuthLoginCallbacks } from "@oh-my-pi/pi-ai/oauth/types";
 import type { AutocompleteItem, Component, EditorTheme, KeyId, TUI } from "@oh-my-pi/pi-tui";
 import type { logger as PiLogger } from "@oh-my-pi/pi-utils";
-import type { z } from "zod/v4";
+import type { Type as arktype } from "arktype";
+import type * as zod from "zod/v4";
 import type { KeybindingsManager } from "../../config/keybindings";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { EditToolDetails } from "../../edit";
@@ -29,7 +30,7 @@ import type { ReadonlySessionManager, SessionManager } from "../../session/sessi
 import type { BashToolDetails, BashToolInput, FindToolDetails, FindToolInput, ReadToolDetails, ReadToolInput, SearchToolDetails, SearchToolInput, WriteToolInput } from "../../tools";
 import type { ApprovalMode } from "../../tools/approval";
 import type { EventBus } from "../../utils/event-bus";
-import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, GoalUpdatedEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
+import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, GoalUpdatedEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionStopEvent, SessionStopEventResult, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
 import type { SlashCommandInfo } from "../slash-commands";
 import type * as TypeBox from "../typebox";
 export type { AppKeybinding, KeybindingsManager } from "../../config/keybindings";
@@ -161,11 +162,11 @@ export interface ExtensionUIContext {
     setToolsExpanded(expanded: boolean): void;
 }
 export interface ContextUsage {
-    /** Estimated context tokens, or null if unknown (e.g. right after compaction, before next LLM response). */
-    tokens: number | null;
+    /** Estimated context tokens. */
+    tokens: number;
     contextWindow: number;
-    /** Context usage as percentage of context window, or null if tokens is unknown. */
-    percent: number | null;
+    /** Context usage as percentage of context window. */
+    percent: number;
 }
 export interface CompactOptions {
     onComplete?: (result: CompactionResult) => void;
@@ -347,7 +348,7 @@ export interface BeforeAgentStartEvent {
     images?: ImageContent[];
     systemPrompt: string[];
 }
-export type { AgentEndEvent, AgentStartEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
+export type { AgentEndEvent, AgentStartEvent, SessionStopEvent, SessionStopEventResult, TurnEndEvent, TurnStartEvent, } from "../shared-events";
 /** Fired when a message starts (user, assistant, or toolResult) */
 export interface MessageStartEvent {
     type: "message_start";
@@ -542,7 +543,7 @@ export declare function isToolCallEventType<TName extends string, TInput extends
     input: TInput;
 };
 /** Union of all event types */
-export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | AutoCompactionStartEvent | AutoCompactionEndEvent | AutoRetryStartEvent | AutoRetryEndEvent | TtsrTriggeredEvent | TodoReminderEvent | GoalUpdatedEvent | CredentialDisabledEvent | UserBashEvent | UserPythonEvent | InputEvent | ToolCallEvent | ToolResultEvent | ToolApprovalRequestedEvent | ToolApprovalResolvedEvent;
+export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | SessionStopEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | AutoCompactionStartEvent | AutoCompactionEndEvent | AutoRetryStartEvent | AutoRetryEndEvent | TtsrTriggeredEvent | TodoReminderEvent | GoalUpdatedEvent | CredentialDisabledEvent | UserBashEvent | UserPythonEvent | InputEvent | ToolCallEvent | ToolResultEvent | ToolApprovalRequestedEvent | ToolApprovalResolvedEvent;
 export interface ContextEventResult {
     messages?: AgentMessage[];
 }
@@ -601,8 +602,10 @@ export interface ExtensionAPI {
     logger: typeof PiLogger;
     /** Injected zod-backed typebox shim for legacy `Type.Object(...)` parameter authoring. */
     typebox: typeof TypeBox;
-    /** Injected zod module for Zod-authored extension tools (canonical going forward). */
-    zod: typeof z;
+    /** Injected arktype module for arktype-authored extension tools (canonical going forward). */
+    arktype: typeof arktype;
+    /** Injected zod/v4 module for canonical extension tool parameter schemas. */
+    zod: typeof zod;
     /** Injected pi-coding-agent exports for accessing SDK utilities */
     pi: typeof PiCodingAgent;
     on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
@@ -623,6 +626,7 @@ export interface ExtensionAPI {
     on(event: "before_agent_start", handler: ExtensionHandler<BeforeAgentStartEvent, BeforeAgentStartEventResult>): void;
     on(event: "agent_start", handler: ExtensionHandler<AgentStartEvent>): void;
     on(event: "agent_end", handler: ExtensionHandler<AgentEndEvent>): void;
+    on(event: "session_stop", handler: ExtensionHandler<SessionStopEvent, SessionStopEventResult>): void;
     on(event: "turn_start", handler: ExtensionHandler<TurnStartEvent>): void;
     on(event: "turn_end", handler: ExtensionHandler<TurnEndEvent>): void;
     on(event: "message_start", handler: ExtensionHandler<MessageStartEvent>): void;

package/dist/types/extensibility/hooks/types.d.ts

@@ -1,7 +1,8 @@
 import type { ImageContent, Message, Model, TextContent } from "@oh-my-pi/pi-ai";
 import type { Component, TUI } from "@oh-my-pi/pi-tui";
 import type { logger as PiLogger } from "@oh-my-pi/pi-utils";
-import type { z } from "zod/v4";
+import type { Type } from "arktype";
+import type * as zod from "zod/v4";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { EditToolDetails } from "../../edit";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
@@ -417,10 +418,12 @@ export interface HookAPI {
     exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
     /** File logger for error/warning/debug messages */
     logger: typeof PiLogger;
-    /** Injected zod-backed typebox shim (legacy/compat — prefer `zod`). */
+    /** Injected zod-backed typebox shim (legacy/compat — prefer `arktype`). */
     typebox: typeof TypeBox;
-    /** Injected zod module for Zod-authored hooks. */
-    zod: typeof z;
+    /** Injected arktype module for arktype-authored hooks. */
+    arktype: typeof Type;
+    /** Injected zod/v4 module for canonical hook validation. */
+    zod: typeof zod;
     /** Injected pi-coding-agent exports */
     pi: typeof PiCodingAgent;
 }