@oh-my-pi/pi-coding-agent 15.10.11 → 15.11.0

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

@@ -1,2 +1 @@
 export * from "./job-manager";
-export * from "./support";

package/dist/types/cli/args.d.ts

@@ -8,6 +8,7 @@ export interface Args {
     allowHome?: boolean;
     provider?: string;
     model?: string;
+    config?: string[];
     smol?: string;
     slow?: string;
     plan?: string;

package/dist/types/cli/gallery-fixtures/types.d.ts

@@ -34,6 +34,11 @@ export interface GalleryFixture {
      * real one keeps the gallery honest for these tools.
      */
     customRendered?: boolean;
+    /**
+     * Renderer-registry key to use when the fixture key is a variant of a tool
+     * (e.g. `irc_wait` → `irc`). Defaults to the fixture key.
+     */
+    renderer?: string;
     /**
      * Arguments shown during the streaming state — a partial view of {@link args}
      * as if the tool-call JSON were still arriving. May include `__partialJson`

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

@@ -10,6 +10,7 @@
  */
 import type { CommandEntry } from "@oh-my-pi/pi-utils/cli";
 export declare const commands: CommandEntry[];
+export declare function reservedTopLevelWordMessage(first: string | undefined, argc?: number): string | undefined;
 /**
  * Return true when `first` matches a registered subcommand name or alias.
  *
@@ -17,3 +18,14 @@ export declare const commands: CommandEntry[];
  * runner skips ahead to the default `launch` command.
  */
 export declare function isSubcommand(first: string | undefined): boolean;
+export type ResolvedCliArgv = {
+    argv: string[];
+} | {
+    error: string;
+};
+/**
+ * Decide what the CLI runner should do with raw argv: reject bare reserved
+ * management words, pass help/version through untouched, and route everything
+ * that is not a known subcommand to `launch`.
+ */
+export declare function resolveCliArgv(argv: string[]): ResolvedCliArgv;

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

@@ -47,6 +47,10 @@ export default class Index extends Command {
             description: string;
             options: string[];
         };
+        config: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
         print: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
             char: string;
             description: string;

package/dist/types/config/api-key-resolver.d.ts

@@ -4,6 +4,8 @@ export interface ApiKeyResolverOptions {
     sessionId?: string;
     /** Provider base URL hint forwarded to the auth-storage cascade. */
     baseUrl?: string;
+    /** Provider model id forwarded to model-scoped usage ranking/backoff. */
+    modelId?: string;
 }
 /**
  * Minimal slice of `ModelRegistry` the resolver needs. Typed structurally so
@@ -13,6 +15,7 @@ export interface ApiKeyResolverOptions {
 export interface ApiKeyResolverRegistry {
     getApiKeyForProvider(provider: string, sessionId?: string, options?: {
         baseUrl?: string;
+        modelId?: string;
         forceRefresh?: boolean;
         signal?: AbortSignal;
     }): Promise<string | undefined>;

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

@@ -23,6 +23,7 @@ interface AppKeybindings {
     "app.clipboard.pasteTextRaw": true;
     "app.clipboard.copyLine": true;
     "app.clipboard.copyPrompt": true;
+    "app.agents.hub": true;
     "app.session.new": true;
     "app.session.tree": true;
     "app.session.fork": true;
@@ -268,9 +269,13 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: [];
         readonly description: "Resume session";
     };
+    readonly "app.agents.hub": {
+        readonly defaultKeys: "alt+a";
+        readonly description: "Open the agent hub";
+    };
     readonly "app.session.observe": {
         readonly defaultKeys: "ctrl+s";
-        readonly description: "Observe subagent sessions";
+        readonly description: "Open the agent hub";
     };
     readonly "app.session.togglePath": {
         readonly defaultKeys: "ctrl+p";

package/dist/types/config/model-registry.d.ts

@@ -148,6 +148,7 @@ export declare class ModelRegistry {
      */
     getApiKeyForProvider(provider: string, sessionId?: string, options?: {
         baseUrl?: string;
+        modelId?: string;
         forceRefresh?: boolean;
         signal?: AbortSignal;
     }): Promise<string | undefined>;

package/dist/types/config/model-resolver.d.ts

@@ -174,6 +174,24 @@ export declare function resolveModelScope(patterns: string[], modelRegistry: Pic
  * rather than falling back to the global default (see issue #1022).
  */
 export declare function resolveAllowedModels(modelRegistry: Pick<ModelRegistry, "getAvailable" | "getCanonicalVariants">, settings: Settings | undefined, preferences?: ModelMatchPreferences): Promise<Model<Api>[]>;
+/**
+ * Synchronous subset of {@link resolveAllowedModels} for contexts where async is unavailable
+ * (e.g. `getAvailableModels()` which is called from the ACP model-list advertisement, RPC
+ * `get_available_models`, and the `/model` slash command). Uses the same effective
+ * `enabledModels` scope semantics as startup resolution:
+ *
+ * - Glob selectors match `provider/modelId` and bare model id
+ * - Exact canonical ids expand to all available concrete variants
+ * - Exact `provider/modelId`, bare ids, provider-scoped fuzzy, and substring selectors
+ *   resolve through the shared model-pattern matcher
+ * - Optional `:thinkingLevel` suffixes are stripped only when valid
+ *
+ * When no pattern resolves to any model (misconfiguration / typo) an empty list is returned,
+ * consistent with the empty-list contract of {@link resolveAllowedModels}. Callers that render
+ * a UI picker should treat an empty list as "hide the picker entry", matching how the SDK
+ * surfaces the same misconfiguration during session initialization.
+ */
+export declare function filterAvailableModelsByEnabledPatterns(available: Model<Api>[], patterns: readonly string[], registry: Pick<ModelRegistry, "getCanonicalVariants">): Model<Api>[];
 export interface ResolveCliModelResult {
     model: Model<Api> | undefined;
     selector?: string;

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

@@ -62,7 +62,7 @@ export type AnyUiMetadata = UiBase & {
 };
 interface BooleanDef {
     type: "boolean";
-    default: boolean;
+    default: boolean | undefined;
     ui?: UiBoolean;
 }
 interface StringDef {
@@ -1326,12 +1326,12 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "compaction.strategy": {
         readonly type: "enum";
-        readonly values: readonly ["context-full", "handoff", "shake", "off"];
+        readonly values: readonly ["context-full", "handoff", "shake", "snapcompact", "off"];
         readonly default: "context-full";
         readonly ui: {
             readonly tab: "context";
             readonly label: "Compaction Strategy";
-            readonly description: "Choose in-place context-full maintenance, auto-handoff, surgical shake (drop heavy content), or disable auto maintenance (off)";
+            readonly description: "Choose in-place context-full maintenance, auto-handoff, surgical shake (drop heavy content), snapcompact (archive history as dense images), or disable auto maintenance (off)";
             readonly options: readonly [{
                 readonly value: "context-full";
                 readonly label: "Context-full";
@@ -1344,6 +1344,10 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "shake";
                 readonly label: "Shake";
                 readonly description: "Drop heavy content (tool results + large blocks) in place; recover via artifact";
+            }, {
+                readonly value: "snapcompact";
+                readonly label: "Snapcompact";
+                readonly description: "Archive history onto dense bitmap images the model reads back; no LLM call";
             }, {
                 readonly value: "off";
                 readonly label: "Off";
@@ -1563,6 +1567,15 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "compaction.supersedeReads": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "context";
+            readonly label: "Supersede Stale Reads";
+            readonly description: "Prune older read results when the same file is read again (cache-aware, runs every turn)";
+        };
+    };
     readonly "branchSummary.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -2392,6 +2405,20 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: number;
     };
+    readonly "shellMinimizer.sourceOutlineLevel": {
+        readonly type: "enum";
+        readonly values: readonly ["default", "aggressive"];
+        readonly default: "default";
+        readonly ui: {
+            readonly tab: "editing";
+            readonly label: "Shell Minimizer Source Outline";
+            readonly description: "Source outline mode for cat/read of source files: default or aggressive";
+        };
+    };
+    readonly "shellMinimizer.legacyFilters": {
+        readonly type: "boolean";
+        readonly default: undefined;
+    };
     readonly "eval.py": {
         readonly type: "boolean";
         readonly default: true;
@@ -2420,6 +2447,15 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Whether to keep IPython kernel alive across calls";
         };
     };
+    readonly "python.interpreter": {
+        readonly type: "string";
+        readonly default: "";
+        readonly ui: {
+            readonly tab: "editing";
+            readonly label: "Python Interpreter";
+            readonly description: "Optional path to an exact Python executable. When set, automatic Python runtime discovery is skipped.";
+        };
+    };
     readonly "tools.approval": {
         readonly type: "record";
         readonly default: {};
@@ -2599,22 +2635,13 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the ast_edit tool for structural AST rewrites";
         };
     };
-    readonly "irc.enabled": {
-        readonly type: "boolean";
-        readonly default: true;
-        readonly ui: {
-            readonly tab: "tools";
-            readonly label: "IRC";
-            readonly description: "Enable agent-to-agent IRC messaging via the irc tool";
-        };
-    };
     readonly "irc.timeoutMs": {
         readonly type: "number";
         readonly default: 120000;
         readonly ui: {
             readonly tab: "tools";
             readonly label: "IRC Timeout";
-            readonly description: "Drop IRC messages whose recipient does not respond within this many milliseconds (0 disables the timeout)";
+            readonly description: "Default timeout for irc wait (and send await:true) in milliseconds; 0 disables the timeout";
             readonly options: readonly [{
                 readonly value: "0";
                 readonly label: "Disabled";
@@ -2811,7 +2838,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly ui: {
             readonly tab: "tools";
             readonly label: "Async Execution";
-            readonly description: "Enable async bash commands and background task execution";
+            readonly description: "Enable async bash commands";
         };
     };
     readonly "async.maxJobs": {
@@ -3056,27 +3083,13 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Encourage the agent to delegate work to subagents unless changes are trivial";
         };
     };
-    readonly "task.simple": {
-        readonly type: "enum";
-        readonly values: readonly ["default", "schema-free", "independent"];
-        readonly default: "schema-free";
+    readonly "task.batch": {
+        readonly type: "boolean";
+        readonly default: true;
         readonly ui: {
             readonly tab: "tasks";
-            readonly label: "Task Input Mode";
-            readonly description: "How much shared structure the task tool accepts (default, schema-free, or independent)";
-            readonly options: readonly [{
-                readonly value: "default";
-                readonly label: "Default";
-                readonly description: "Shared context and custom task schema are available";
-            }, {
-                readonly value: "schema-free";
-                readonly label: "Schema-free";
-                readonly description: "Shared context stays available, but custom task schema is disabled";
-            }, {
-                readonly value: "independent";
-                readonly label: "Independent";
-                readonly description: "No shared context or custom task schema; each task must stand alone";
-            }];
+            readonly label: "Batch Task Calls";
+            readonly description: "Switch the task tool to its batch shape: one call carries { agent, context, tasks[] } — one subagent per item (with per-item isolation) and a required shared context prepended to every assignment. Each spawn still runs as an independent background agent with the normal idle/parked lifecycle. Disable to restore the flat single-spawn schema.";
         };
     };
     readonly "task.maxConcurrency": {
@@ -3173,6 +3186,38 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "task.agentIdleTtlMs": {
+        readonly type: "number";
+        readonly default: 420000;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly label: "Agent Idle TTL";
+            readonly description: "How long an idle subagent stays live in memory before being parked to disk (ms). Parked agents are revived automatically when messaged or resumed. 0 keeps idle agents live until exit.";
+        };
+    };
+    readonly "task.softRequestBudget": {
+        readonly type: "number";
+        readonly default: 90;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly label: "Soft Subagent Request Budget";
+            readonly description: "Soft per-subagent request budget (assistant requests per run). Crossing it injects one steering notice asking the subagent to wrap up; at 1.5x the budget the run is aborted gracefully, salvaging partial output. 0 disables the guard. Bundled explore/quick_task agents use a lower built-in budget.";
+            readonly options: readonly [{
+                readonly value: "0";
+                readonly label: "Disabled";
+            }, {
+                readonly value: "40";
+                readonly label: "40 requests";
+            }, {
+                readonly value: "90";
+                readonly label: "90 requests";
+                readonly description: "Default";
+            }, {
+                readonly value: "150";
+                readonly label: "150 requests";
+            }];
+        };
+    };
     readonly "task.disabledAgents": {
         readonly type: "array";
         readonly default: string[];
@@ -3896,6 +3941,9 @@ export type SettingPath = keyof Schema;
 /** Infer the value type for a setting path */
 export type SettingValue<P extends SettingPath> = Schema[P] extends {
     type: "boolean";
+    default: undefined;
+} ? boolean | undefined : Schema[P] extends {
+    type: "boolean";
 } ? boolean : Schema[P] extends {
     type: "string";
 } ? string | undefined : Schema[P] extends {
@@ -3930,7 +3978,7 @@ export type StatusLineSeparatorStyle = SettingValue<"statusLine.separator">;
 export type TreeFilterMode = SettingValue<"treeFilterMode">;
 export interface CompactionSettings {
     enabled: boolean;
-    strategy: "context-full" | "handoff" | "shake" | "off";
+    strategy: "context-full" | "handoff" | "shake" | "snapcompact" | "off";
     thresholdPercent: number;
     thresholdTokens: number;
     reserveTokens: number;
@@ -3942,6 +3990,7 @@ export interface CompactionSettings {
     idleEnabled: boolean;
     idleThresholdTokens: number;
     idleTimeoutSeconds: number;
+    supersedeReads: boolean;
 }
 export interface ContextPromotionSettings {
     enabled: boolean;
@@ -4051,6 +4100,8 @@ export interface ShellMinimizerSettings {
     only: string[];
     except: string[];
     maxCaptureBytes: number;
+    sourceOutlineLevel: "default" | "aggressive";
+    legacyFilters: boolean | undefined;
 }
 /** Map group prefix -> typed settings interface */
 export interface GroupTypeMap {

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

@@ -30,6 +30,8 @@ export interface SettingsOptions {
     inMemory?: boolean;
     /** Initial overrides */
     overrides?: Partial<Record<SettingPath, unknown>>;
+    /** Extra config.yml-style overlays loaded after global/project settings */
+    configFiles?: string[];
 }
 export declare class Settings {
     #private;
@@ -54,6 +56,11 @@ export declare class Settings {
      * Returns the merged value from global + project + overrides, or the default.
      */
     get<P extends SettingPath>(path: P): SettingValue<P>;
+    /**
+     * Whether `path` has an explicitly configured value (global config, project
+     * config, or runtime override) rather than falling back to the schema default.
+     */
+    isConfigured(path: SettingPath): boolean;
     /**
      * Set a setting value (sync).
      * Updates global settings and queues a background save.

package/dist/types/edit/hashline/noop-loop-guard.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Per-session guard against subagents looping on byte-identical no-op edits.
+ *
+ * A hashline patch can apply cleanly yet produce no change when the body rows
+ * are already byte-identical to the targeted lines. {@link executeHashlineSingle}
+ * surfaces a soft hint ("re-read the file before issuing another edit"), but in
+ * the wild some models ignore the hint and keep re-issuing the same bytes
+ * (issue #2081 captured 182 such repeats in 205 calls before the user aborted).
+ *
+ * This module tracks consecutive byte-identical no-op edits per canonical file
+ * path within a single session. Once the same payload no-ops {@link NOOP_HARD_LIMIT}
+ * times in a row the caller is expected to escalate from a soft text result to
+ * a thrown {@link ToolError} so the agent loop sees a tool *failure* — empirically
+ * far more effective at breaking the cycle than the soft hint alone.
+ *
+ * A successful (non-noop) commit for a path resets that path's counter; a
+ * different payload on the same path also resets it because the body hash
+ * changed, which is a sign of model progress and deserves another soft hint.
+ */
+interface NoopLoopEntry {
+    /** Hash of the most recent input that no-op'd on this canonical path. */
+    hash: string;
+    /** Consecutive no-op count for the same `hash` on this path. */
+    count: number;
+}
+/** Cross-session-safe state slot held on the `ToolSession`. */
+export interface NoopLoopGuard {
+    entries: Map<string, NoopLoopEntry>;
+}
+/**
+ * After this many consecutive byte-identical no-op edits on the same path,
+ * {@link recordNoopEdit} returns `escalate: true`. Picked deliberately small
+ * so the soft hint still fires once or twice before we escalate — the model
+ * deserves a chance to recover, but a tight bound is what actually breaks
+ * loops in practice.
+ */
+export declare const NOOP_HARD_LIMIT = 3;
+interface NoopLoopGuardOwner {
+    noopLoopGuard?: NoopLoopGuard;
+}
+/** Lazily create the per-session guard, mirroring `getFileSnapshotStore`. */
+export declare function getNoopLoopGuard(session: NoopLoopGuardOwner): NoopLoopGuard;
+/** Result of recording one no-op against the guard. */
+export interface NoopRecordResult {
+    /** Consecutive identical no-op count, including the current one. */
+    count: number;
+    /** True once `count >= NOOP_HARD_LIMIT` and the caller MUST escalate. */
+    escalate: boolean;
+}
+/**
+ * Record a no-op edit for `canonicalPath` keyed by `inputHash` (a stable hash
+ * of the raw patch input bytes). Returns the running consecutive-no-op count
+ * and whether the caller should escalate from a soft text result to a thrown
+ * error.
+ *
+ * `inputHash` is intentionally derived from the raw model-authored bytes
+ * rather than from file content: when the model emits a different payload
+ * (even whitespace-only) that's progress and earns a fresh soft hint, but
+ * re-issuing the same bytes after being warned is what we want to break.
+ */
+export declare function recordNoopEdit(session: NoopLoopGuardOwner, canonicalPath: string, inputHash: string): NoopRecordResult;
+/**
+ * Clear the no-op counter for `canonicalPath`. Call after a non-noop commit
+ * for the same path so a future no-op starts fresh from the soft hint.
+ */
+export declare function resetNoopEdit(session: NoopLoopGuardOwner, canonicalPath: string): void;
+/**
+ * Stable hash of the raw patch input. Bun's `Bun.hash` is xxHash64 — fast,
+ * non-cryptographic, more than adequate for "is this the same payload?".
+ */
+export declare function hashPatchInput(input: string): string;
+export {};

package/dist/types/eval/py/executor.d.ts

@@ -25,6 +25,11 @@ export interface PythonExecutorOptions {
     kernelOwnerId?: string;
     /** Kernel mode (session reuse vs per-call) */
     kernelMode?: PythonKernelMode;
+    /**
+     * Explicit interpreter path (`python.interpreter` resolved from the
+     * session's settings). Skips automatic runtime discovery when set.
+     */
+    interpreter?: string;
     /** Restart the kernel before executing */
     reset?: boolean;
     /** Session file path for accessing task outputs */

package/dist/types/eval/py/kernel.d.ts

@@ -45,6 +45,11 @@ interface KernelLifecycleOptions {
 interface KernelStartOptions extends KernelLifecycleOptions {
     cwd: string;
     env?: Record<string, string | undefined>;
+    /**
+     * Explicit interpreter path (`python.interpreter` from the session's
+     * settings). When set, runtime discovery is skipped entirely.
+     */
+    interpreter?: string;
 }
 interface KernelShutdownOptions {
     signal?: AbortSignal;
@@ -57,7 +62,7 @@ export interface PythonKernelAvailability {
     /** The probed-working runtime, when one was found. */
     runtime?: PythonRuntime;
 }
-export declare function checkPythonKernelAvailability(cwd: string): Promise<PythonKernelAvailability>;
+export declare function checkPythonKernelAvailability(cwd: string, interpreter?: string): Promise<PythonKernelAvailability>;
 export declare class PythonKernel {
     #private;
     readonly id: string;

package/dist/types/eval/py/runtime.d.ts

@@ -15,6 +15,15 @@ export declare function filterEnv(env: Record<string, string | undefined>): Reco
  * Detect virtual environment path from VIRTUAL_ENV or common locations.
  */
 export declare function resolveVenvPath(cwd: string): string | undefined;
+/**
+ * Resolve an explicitly configured interpreter (`python.interpreter`) into a
+ * runtime, bypassing discovery. Does not probe or validate the executable —
+ * callers must check it actually runs. `~` expands to the home directory and
+ * relative paths resolve against `cwd`. When the interpreter sits inside a
+ * virtualenv (a `pyvenv.cfg` above its bin dir), the venv activation env is
+ * applied so subprocesses and `pip` resolve consistently.
+ */
+export declare function resolveExplicitPythonRuntime(interpreter: string, cwd: string, baseEnv: Record<string, string | undefined>): PythonRuntime;
 /**
  * Enumerate candidate Python runtimes in priority order: an active/project venv,
  * the managed `~/.omp/python-env`, then the system interpreter on PATH. Every

package/dist/types/exec/bash-executor.d.ts

@@ -10,6 +10,8 @@ export interface BashExecutorOptions {
     sessionKey?: string;
     /** Additional environment variables to inject */
     env?: Record<string, string>;
+    /** Run through the configured user shell instead of brush parsing directly. */
+    useUserShell?: boolean;
     /** Artifact path/id for full output storage */
     artifactPath?: string;
     artifactId?: string;