@oh-my-pi/pi-coding-agent 15.10.10 → 15.10.12

package/dist/types/config/models-config.d.ts

@@ -0,0 +1,385 @@
+/**
+ * models.json config file handle and provider configuration validation.
+ */
+import type { Api, ModelSpec } from "@oh-my-pi/pi-ai/types";
+import { ConfigFile } from "./config-file";
+import { type ProviderAuthMode, type ProviderDiscovery } from "./models-config-schema";
+export type ProviderValidationMode = "models-config" | "runtime-register";
+export interface ProviderValidationModel {
+    id: string;
+    api?: Api;
+    contextWindow?: number;
+    maxTokens?: number;
+}
+export interface ProviderValidationConfig {
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    apiKey?: string;
+    api?: Api;
+    auth?: ProviderAuthMode;
+    oauthConfigured?: boolean;
+    discovery?: ProviderDiscovery;
+    compat?: ModelSpec<Api>["compat"];
+    disableStrictTools?: boolean;
+    modelOverrides?: Record<string, unknown>;
+    models: ProviderValidationModel[];
+}
+export declare function validateProviderConfiguration(providerName: string, config: ProviderValidationConfig, mode: ProviderValidationMode): void;
+export declare const ModelsConfigFile: ConfigFile<{
+    providers?: Record<string, {
+        baseUrl?: string | undefined;
+        apiKey?: string | undefined;
+        api?: "anthropic-messages" | "azure-openai-responses" | "google-generative-ai" | "google-vertex" | "openai-codex-responses" | "openai-completions" | "openai-responses" | undefined;
+        headers?: Record<string, string> | undefined;
+        compat?: {
+            supportsStore?: boolean | undefined;
+            supportsDeveloperRole?: boolean | undefined;
+            supportsMultipleSystemMessages?: boolean | undefined;
+            supportsReasoningEffort?: boolean | undefined;
+            reasoningEffortMap?: {
+                minimal?: string | undefined;
+                low?: string | undefined;
+                medium?: string | undefined;
+                high?: string | undefined;
+                xhigh?: string | undefined;
+            } | undefined;
+            maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+            supportsUsageInStreaming?: boolean | undefined;
+            requiresToolResultName?: boolean | undefined;
+            requiresMistralToolIds?: boolean | undefined;
+            requiresAssistantAfterToolResult?: boolean | undefined;
+            requiresThinkingAsText?: boolean | undefined;
+            reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+            requiresReasoningContentForToolCalls?: boolean | undefined;
+            allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+            requiresAssistantContentForToolCalls?: boolean | undefined;
+            supportsToolChoice?: boolean | undefined;
+            disableReasoningOnForcedToolChoice?: boolean | undefined;
+            disableReasoningOnToolChoice?: boolean | undefined;
+            thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+            openRouterRouting?: {
+                only?: string[] | undefined;
+                order?: string[] | undefined;
+            } | undefined;
+            vercelGatewayRouting?: {
+                only?: string[] | undefined;
+                order?: string[] | undefined;
+            } | undefined;
+            extraBody?: Record<string, unknown> | undefined;
+            cacheControlFormat?: "anthropic" | undefined;
+            supportsStrictMode?: boolean | undefined;
+            toolStrictMode?: "all_strict" | "none" | undefined;
+            streamIdleTimeoutMs?: number | undefined;
+            supportsLongPromptCacheRetention?: boolean | undefined;
+            supportsReasoningParams?: boolean | undefined;
+            alwaysSendMaxTokens?: boolean | undefined;
+            strictResponsesPairing?: boolean | undefined;
+            requiresToolResultId?: boolean | undefined;
+            replayUnsignedThinking?: boolean | undefined;
+            whenThinking?: {
+                supportsStore?: boolean | undefined;
+                supportsDeveloperRole?: boolean | undefined;
+                supportsMultipleSystemMessages?: boolean | undefined;
+                supportsReasoningEffort?: boolean | undefined;
+                reasoningEffortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                } | undefined;
+                maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                supportsUsageInStreaming?: boolean | undefined;
+                requiresToolResultName?: boolean | undefined;
+                requiresMistralToolIds?: boolean | undefined;
+                requiresAssistantAfterToolResult?: boolean | undefined;
+                requiresThinkingAsText?: boolean | undefined;
+                reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+                requiresReasoningContentForToolCalls?: boolean | undefined;
+                allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                requiresAssistantContentForToolCalls?: boolean | undefined;
+                supportsToolChoice?: boolean | undefined;
+                disableReasoningOnForcedToolChoice?: boolean | undefined;
+                disableReasoningOnToolChoice?: boolean | undefined;
+                thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+                openRouterRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                vercelGatewayRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+                cacheControlFormat?: "anthropic" | undefined;
+                supportsStrictMode?: boolean | undefined;
+                toolStrictMode?: "all_strict" | "none" | undefined;
+                streamIdleTimeoutMs?: number | undefined;
+                supportsLongPromptCacheRetention?: boolean | undefined;
+                supportsReasoningParams?: boolean | undefined;
+                alwaysSendMaxTokens?: boolean | undefined;
+                strictResponsesPairing?: boolean | undefined;
+                requiresToolResultId?: boolean | undefined;
+                replayUnsignedThinking?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        authHeader?: boolean | undefined;
+        auth?: "apiKey" | "none" | "oauth" | undefined;
+        discovery?: {
+            type: "llama.cpp" | "lm-studio" | "ollama" | "openai-models-list" | "proxy";
+        } | undefined;
+        models?: {
+            id: string;
+            name?: string | undefined;
+            api?: "anthropic-messages" | "azure-openai-responses" | "google-generative-ai" | "google-vertex" | "openai-codex-responses" | "openai-completions" | "openai-responses" | undefined;
+            baseUrl?: string | undefined;
+            reasoning?: boolean | undefined;
+            thinking?: {
+                mode: "anthropic-adaptive" | "anthropic-budget-effort" | "budget" | "effort" | "google-level";
+                efforts: ("high" | "low" | "medium" | "minimal" | "xhigh")[];
+                defaultLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
+                effortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                } | undefined;
+                supportsDisplay?: boolean | undefined;
+            } | undefined;
+            input?: ("image" | "text")[] | undefined;
+            cost?: {
+                input: number;
+                output: number;
+                cacheRead: number;
+                cacheWrite: number;
+            } | undefined;
+            premiumMultiplier?: number | undefined;
+            contextWindow?: number | undefined;
+            maxTokens?: number | undefined;
+            omitMaxOutputTokens?: boolean | undefined;
+            headers?: Record<string, string> | undefined;
+            compat?: {
+                supportsStore?: boolean | undefined;
+                supportsDeveloperRole?: boolean | undefined;
+                supportsMultipleSystemMessages?: boolean | undefined;
+                supportsReasoningEffort?: boolean | undefined;
+                reasoningEffortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                } | undefined;
+                maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                supportsUsageInStreaming?: boolean | undefined;
+                requiresToolResultName?: boolean | undefined;
+                requiresMistralToolIds?: boolean | undefined;
+                requiresAssistantAfterToolResult?: boolean | undefined;
+                requiresThinkingAsText?: boolean | undefined;
+                reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+                requiresReasoningContentForToolCalls?: boolean | undefined;
+                allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                requiresAssistantContentForToolCalls?: boolean | undefined;
+                supportsToolChoice?: boolean | undefined;
+                disableReasoningOnForcedToolChoice?: boolean | undefined;
+                disableReasoningOnToolChoice?: boolean | undefined;
+                thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+                openRouterRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                vercelGatewayRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+                cacheControlFormat?: "anthropic" | undefined;
+                supportsStrictMode?: boolean | undefined;
+                toolStrictMode?: "all_strict" | "none" | undefined;
+                streamIdleTimeoutMs?: number | undefined;
+                supportsLongPromptCacheRetention?: boolean | undefined;
+                supportsReasoningParams?: boolean | undefined;
+                alwaysSendMaxTokens?: boolean | undefined;
+                strictResponsesPairing?: boolean | undefined;
+                requiresToolResultId?: boolean | undefined;
+                replayUnsignedThinking?: boolean | undefined;
+                whenThinking?: {
+                    supportsStore?: boolean | undefined;
+                    supportsDeveloperRole?: boolean | undefined;
+                    supportsMultipleSystemMessages?: boolean | undefined;
+                    supportsReasoningEffort?: boolean | undefined;
+                    reasoningEffortMap?: {
+                        minimal?: string | undefined;
+                        low?: string | undefined;
+                        medium?: string | undefined;
+                        high?: string | undefined;
+                        xhigh?: string | undefined;
+                    } | undefined;
+                    maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                    supportsUsageInStreaming?: boolean | undefined;
+                    requiresToolResultName?: boolean | undefined;
+                    requiresMistralToolIds?: boolean | undefined;
+                    requiresAssistantAfterToolResult?: boolean | undefined;
+                    requiresThinkingAsText?: boolean | undefined;
+                    reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+                    requiresReasoningContentForToolCalls?: boolean | undefined;
+                    allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                    requiresAssistantContentForToolCalls?: boolean | undefined;
+                    supportsToolChoice?: boolean | undefined;
+                    disableReasoningOnForcedToolChoice?: boolean | undefined;
+                    disableReasoningOnToolChoice?: boolean | undefined;
+                    thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+                    openRouterRouting?: {
+                        only?: string[] | undefined;
+                        order?: string[] | undefined;
+                    } | undefined;
+                    vercelGatewayRouting?: {
+                        only?: string[] | undefined;
+                        order?: string[] | undefined;
+                    } | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    cacheControlFormat?: "anthropic" | undefined;
+                    supportsStrictMode?: boolean | undefined;
+                    toolStrictMode?: "all_strict" | "none" | undefined;
+                    streamIdleTimeoutMs?: number | undefined;
+                    supportsLongPromptCacheRetention?: boolean | undefined;
+                    supportsReasoningParams?: boolean | undefined;
+                    alwaysSendMaxTokens?: boolean | undefined;
+                    strictResponsesPairing?: boolean | undefined;
+                    requiresToolResultId?: boolean | undefined;
+                    replayUnsignedThinking?: boolean | undefined;
+                } | undefined;
+            } | undefined;
+            contextPromotionTarget?: string | undefined;
+        }[] | undefined;
+        modelOverrides?: Record<string, {
+            name?: string | undefined;
+            reasoning?: boolean | undefined;
+            thinking?: {
+                mode: "anthropic-adaptive" | "anthropic-budget-effort" | "budget" | "effort" | "google-level";
+                efforts: ("high" | "low" | "medium" | "minimal" | "xhigh")[];
+                defaultLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
+                effortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                } | undefined;
+                supportsDisplay?: boolean | undefined;
+            } | undefined;
+            input?: ("image" | "text")[] | undefined;
+            cost?: {
+                input?: number | undefined;
+                output?: number | undefined;
+                cacheRead?: number | undefined;
+                cacheWrite?: number | undefined;
+            } | undefined;
+            premiumMultiplier?: number | undefined;
+            contextWindow?: number | undefined;
+            maxTokens?: number | undefined;
+            omitMaxOutputTokens?: boolean | undefined;
+            headers?: Record<string, string> | undefined;
+            compat?: {
+                supportsStore?: boolean | undefined;
+                supportsDeveloperRole?: boolean | undefined;
+                supportsMultipleSystemMessages?: boolean | undefined;
+                supportsReasoningEffort?: boolean | undefined;
+                reasoningEffortMap?: {
+                    minimal?: string | undefined;
+                    low?: string | undefined;
+                    medium?: string | undefined;
+                    high?: string | undefined;
+                    xhigh?: string | undefined;
+                } | undefined;
+                maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                supportsUsageInStreaming?: boolean | undefined;
+                requiresToolResultName?: boolean | undefined;
+                requiresMistralToolIds?: boolean | undefined;
+                requiresAssistantAfterToolResult?: boolean | undefined;
+                requiresThinkingAsText?: boolean | undefined;
+                reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+                requiresReasoningContentForToolCalls?: boolean | undefined;
+                allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                requiresAssistantContentForToolCalls?: boolean | undefined;
+                supportsToolChoice?: boolean | undefined;
+                disableReasoningOnForcedToolChoice?: boolean | undefined;
+                disableReasoningOnToolChoice?: boolean | undefined;
+                thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+                openRouterRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                vercelGatewayRouting?: {
+                    only?: string[] | undefined;
+                    order?: string[] | undefined;
+                } | undefined;
+                extraBody?: Record<string, unknown> | undefined;
+                cacheControlFormat?: "anthropic" | undefined;
+                supportsStrictMode?: boolean | undefined;
+                toolStrictMode?: "all_strict" | "none" | undefined;
+                streamIdleTimeoutMs?: number | undefined;
+                supportsLongPromptCacheRetention?: boolean | undefined;
+                supportsReasoningParams?: boolean | undefined;
+                alwaysSendMaxTokens?: boolean | undefined;
+                strictResponsesPairing?: boolean | undefined;
+                requiresToolResultId?: boolean | undefined;
+                replayUnsignedThinking?: boolean | undefined;
+                whenThinking?: {
+                    supportsStore?: boolean | undefined;
+                    supportsDeveloperRole?: boolean | undefined;
+                    supportsMultipleSystemMessages?: boolean | undefined;
+                    supportsReasoningEffort?: boolean | undefined;
+                    reasoningEffortMap?: {
+                        minimal?: string | undefined;
+                        low?: string | undefined;
+                        medium?: string | undefined;
+                        high?: string | undefined;
+                        xhigh?: string | undefined;
+                    } | undefined;
+                    maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
+                    supportsUsageInStreaming?: boolean | undefined;
+                    requiresToolResultName?: boolean | undefined;
+                    requiresMistralToolIds?: boolean | undefined;
+                    requiresAssistantAfterToolResult?: boolean | undefined;
+                    requiresThinkingAsText?: boolean | undefined;
+                    reasoningContentField?: "reasoning" | "reasoning_content" | "reasoning_text" | undefined;
+                    requiresReasoningContentForToolCalls?: boolean | undefined;
+                    allowsSyntheticReasoningContentForToolCalls?: boolean | undefined;
+                    requiresAssistantContentForToolCalls?: boolean | undefined;
+                    supportsToolChoice?: boolean | undefined;
+                    disableReasoningOnForcedToolChoice?: boolean | undefined;
+                    disableReasoningOnToolChoice?: boolean | undefined;
+                    thinkingFormat?: "openai" | "openrouter" | "qwen" | "qwen-chat-template" | "zai" | undefined;
+                    openRouterRouting?: {
+                        only?: string[] | undefined;
+                        order?: string[] | undefined;
+                    } | undefined;
+                    vercelGatewayRouting?: {
+                        only?: string[] | undefined;
+                        order?: string[] | undefined;
+                    } | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    cacheControlFormat?: "anthropic" | undefined;
+                    supportsStrictMode?: boolean | undefined;
+                    toolStrictMode?: "all_strict" | "none" | undefined;
+                    streamIdleTimeoutMs?: number | undefined;
+                    supportsLongPromptCacheRetention?: boolean | undefined;
+                    supportsReasoningParams?: boolean | undefined;
+                    alwaysSendMaxTokens?: boolean | undefined;
+                    strictResponsesPairing?: boolean | undefined;
+                    requiresToolResultId?: boolean | undefined;
+                    replayUnsignedThinking?: boolean | undefined;
+                } | undefined;
+            } | undefined;
+            contextPromotionTarget?: string | undefined;
+        }> | undefined;
+        disableStrictTools?: boolean | undefined;
+        transport?: "pi-native" | undefined;
+    }> | undefined;
+    equivalence?: {
+        overrides?: Record<string, string> | undefined;
+        exclude?: string[] | undefined;
+    } | undefined;
+}>;

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 {
@@ -101,10 +101,6 @@ export interface ModelTagsSettings {
 }
 export declare const DEFAULT_BASH_INTERCEPTOR_RULES: BashInterceptorRule[];
 export declare const SETTINGS_SCHEMA: {
-    readonly lastChangelogVersion: {
-        readonly type: "string";
-        readonly default: undefined;
-    };
     readonly setupVersion: {
         readonly type: "number";
         readonly default: 0;
@@ -718,7 +714,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly defaultThinkingLevel: {
         readonly type: "enum";
-        readonly values: readonly [...import("@oh-my-pi/pi-ai").Effort[], "auto"];
+        readonly values: readonly [...import("@oh-my-pi/pi-catalog").Effort[], "auto"];
         readonly default: "high";
         readonly ui: {
             readonly tab: "model";
@@ -991,7 +987,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "retry.maxRetries": {
         readonly type: "number";
-        readonly default: 3;
+        readonly default: 10;
         readonly ui: {
             readonly tab: "model";
             readonly label: "Retry Attempts";
@@ -1016,7 +1012,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "retry.baseDelayMs": {
         readonly type: "number";
-        readonly default: 2000;
+        readonly default: 500;
     };
     readonly "retry.maxDelayMs": {
         readonly type: "number";
@@ -2304,6 +2300,15 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the lsp tool for language server protocol";
         };
     };
+    readonly "lsp.lazy": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "editing";
+            readonly label: "Lazy LSP Startup";
+            readonly description: "Start language servers on first use (lsp tool or editing a matching file type) instead of at session startup";
+        };
+    };
     readonly "lsp.formatOnWrite": {
         readonly type: "boolean";
         readonly default: false;
@@ -2387,6 +2392,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;
@@ -2415,6 +2434,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: {};
@@ -3891,6 +3919,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 {
@@ -4046,6 +4077,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

@@ -11,7 +11,7 @@
  *   const isolated = Settings.isolated({ "compaction.enabled": false });
  */
 import { procmgr } from "@oh-my-pi/pi-utils";
-import type { ModelRole } from "../config/model-registry";
+import type { ModelRole } from "../config/model-roles";
 import { AgentStorage } from "../session/agent-storage";
 import { type EditMode } from "../utils/edit-mode";
 import { type BashInterceptorRule, type GroupPrefix, type GroupTypeMap, type SettingPath, type SettingValue } from "./settings-schema";
@@ -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/debug/log-viewer.d.ts

@@ -63,6 +63,6 @@ export declare class DebugLogViewerComponent implements Component {
     constructor(options: DebugLogViewerComponentOptions);
     handleInput(keyData: string): void;
     invalidate(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }
 export {};

package/dist/types/debug/raw-sse.d.ts

@@ -14,5 +14,5 @@ export declare class RawSseViewerComponent implements Component {
     constructor(options: RawSseViewerOptions);
     handleInput(keyData: string): void;
     invalidate(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }

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/backend.d.ts

@@ -18,8 +18,6 @@ export interface ExecutorBackendExecOptions {
      */
     idleTimeoutMs: number;
     reset: boolean;
-    artifactPath: string | undefined;
-    artifactId: string | undefined;
     onChunk: (chunk: string) => void;
     /**
      * Live status events (read/write/agent/…) delivered as they are emitted,

package/dist/types/eval/idle-timeout.d.ts

@@ -6,8 +6,6 @@
  * `agent()`/`parallel()`/`completion()` work is ignored completely, then {@link resume}
  * starts a fresh timeout window once the runtime gets control back.
  *
- * The active timer self-reschedules instead of being torn down on every
- * activity event, so frequent activity costs one timestamp write per event.
  * Pause is reference-counted because `parallel()` can have multiple bridge calls
  * in flight at once.
  */
@@ -18,8 +16,6 @@ export declare class IdleTimeout {
     get signal(): AbortSignal;
     /** Configured active timeout window in milliseconds. */
     get idleMs(): number;
-    /** Record runtime activity, pushing the active deadline forward by `idleMs`. */
-    bump(): void;
     /** Suspend timeout accounting while control is delegated to host-side work. */
     pause(): void;
     /** Resume timeout accounting with a fresh timeout window. */