@retaw106/mmc-oc 0.0.0-stage → 1.2.2

package/dist/config/schema/magic-context.d.ts

@@ -0,0 +1,805 @@
+import { z } from "zod";
+export declare const DEFAULT_EXECUTE_THRESHOLD_PERCENTAGE = 65;
+export declare const EXECUTE_THRESHOLD_CAP_MESSAGE = "execute_threshold is capped at 90% for cache safety: output capacity is reserved from the usable context window, and the remaining 10% absorbs mid-turn growth before the absolute 95% emergency wall. Use a value between 20 and 90.";
+export declare const DEFAULT_HISTORIAN_TIMEOUT_MS = 600000;
+export declare const DEFAULT_HISTORY_BUDGET_PERCENTAGE = 0.15;
+export declare const PROTECTED_TOKENS_MIN = 4000;
+/** Valid thinking levels for Pi subagents. Maps to Pi's --thinking CLI flag.
+ *  Off: disable reasoning. Minimal/low/medium/high/xhigh/max: increasing reasoning depth.
+ *  `max` was added in Pi 0.83.0.
+ *  Pi-only — OpenCode uses `variant` in agent config instead. */
+export declare const PiThinkingLevelSchema: z.ZodOptional<z.ZodEnum<{
+    off: "off";
+    minimal: "minimal";
+    low: "low";
+    medium: "medium";
+    high: "high";
+    xhigh: "xhigh";
+    max: "max";
+}>>;
+export type PiThinkingLevel = z.infer<typeof PiThinkingLevelSchema>;
+/** Pi-only child-process controls. This block is intentionally optional so an
+ * absent allowlist preserves Pi's normal extension discovery behavior. */
+export declare const PiConfigSchema: z.ZodOptional<z.ZodObject<{
+    subagent_extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+export type PiConfig = NonNullable<z.infer<typeof PiConfigSchema>>;
+/**
+ * Route the built-in prompt surface without changing guidance or tool registration.
+ * Project config can choose preset routing; only user config can provide override text.
+ */
+export declare const PromptSurfacePresetSchema: z.ZodEnum<{
+    full: "full";
+    light: "light";
+}>;
+export type { PromptSurfacePreset } from "../../shared/prompt-surface";
+export declare const PromptSurfaceConfigSchema: z.ZodObject<{
+    default: z.ZodDefault<z.ZodEnum<{
+        full: "full";
+        light: "light";
+    }>>;
+    models: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        full: "full";
+        light: "light";
+    }>>>;
+    guidance_override_path: z.ZodOptional<z.ZodString>;
+    tool_descriptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type PromptSurfaceConfig = z.infer<typeof PromptSurfaceConfigSchema>;
+/**
+ * The flat model-resolution fields are the only fields that move into harness
+ * blocks. Keeping this inventory next to the schema gives the loader migration
+ * an exhaustive contract instead of a catch-all rule.
+ */
+export declare const PER_HARNESS_MIGRATION_INVENTORY: {
+    readonly historian: {
+        readonly retained: readonly ["temperature", "top_p", "prompt", "tools", "disable", "description", "mode", "color", "maxSteps", "permission", "maxTokens", "two_pass", "disallowed_tools"];
+        readonly migrated_execution: readonly ["model", "fallback_models", "variant", "thinking_level"];
+    };
+};
+/** Harness keys that own independent hidden-agent model-selection blocks. */
+export declare const PER_HARNESS_MODEL_KEYS: readonly ["opencode", "pi"];
+export declare const OcEntrySchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    model: z.ZodString;
+    variant: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>;
+export type OcEntry = z.infer<typeof OcEntrySchema>;
+export declare const PiEntrySchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    model: z.ZodString;
+    thinking_level: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+}, z.core.$strict>]>;
+export type PiEntry = z.infer<typeof PiEntrySchema>;
+/** Strict model-resolution block used by historian.opencode. */
+export declare const OpenCodeHarnessBlockSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        model: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>;
+    fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        model: z.ZodString;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>>;
+    variant: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type OpenCodeHarnessBlock = z.infer<typeof OpenCodeHarnessBlockSchema>;
+/** Strict model-resolution block used by historian.pi. */
+export declare const PiHarnessBlockSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        model: z.ZodString;
+        thinking_level: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            minimal: "minimal";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            max: "max";
+        }>>;
+    }, z.core.$strict>]>>;
+    fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        model: z.ZodString;
+        thinking_level: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            minimal: "minimal";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            max: "max";
+        }>>;
+    }, z.core.$strict>]>>>;
+    thinking_level: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+}, z.core.$strict>;
+export type PiHarnessBlock = z.infer<typeof PiHarnessBlockSchema>;
+export declare const ConfigProfileSchema: z.ZodObject<{
+    historian: z.ZodOptional<z.ZodObject<{
+        opencode: z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        pi: z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                thinking_level: z.ZodOptional<z.ZodEnum<{
+                    off: "off";
+                    minimal: "minimal";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    xhigh: "xhigh";
+                    max: "max";
+                }>>;
+            }, z.core.$strict>]>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                thinking_level: z.ZodOptional<z.ZodEnum<{
+                    off: "off";
+                    minimal: "minimal";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    xhigh: "xhigh";
+                    max: "max";
+                }>>;
+            }, z.core.$strict>]>>>;
+            thinking_level: z.ZodOptional<z.ZodEnum<{
+                off: "off";
+                minimal: "minimal";
+                low: "low";
+                medium: "medium";
+                high: "high";
+                xhigh: "xhigh";
+                max: "max";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ConfigProfile = z.infer<typeof ConfigProfileSchema>;
+export declare const ConfigProfilesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    historian: z.ZodOptional<z.ZodObject<{
+        opencode: z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        pi: z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                thinking_level: z.ZodOptional<z.ZodEnum<{
+                    off: "off";
+                    minimal: "minimal";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    xhigh: "xhigh";
+                    max: "max";
+                }>>;
+            }, z.core.$strict>]>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                thinking_level: z.ZodOptional<z.ZodEnum<{
+                    off: "off";
+                    minimal: "minimal";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    xhigh: "xhigh";
+                    max: "max";
+                }>>;
+            }, z.core.$strict>]>>>;
+            thinking_level: z.ZodOptional<z.ZodEnum<{
+                off: "off";
+                minimal: "minimal";
+                low: "low";
+                medium: "medium";
+                high: "high";
+                xhigh: "xhigh";
+                max: "max";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>;
+export type ConfigProfiles = z.infer<typeof ConfigProfilesSchema>;
+/**
+ * Historian metadata remains harness-independent. Only model resolution moves to
+ * the strict opencode and pi blocks; two_pass and disallowed_tools stay here.
+ */
+export declare const HistorianConfigSchema: z.ZodOptional<z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+        subagent: "subagent";
+        primary: "primary";
+        all: "all";
+    }>>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    top_p: z.ZodOptional<z.ZodNumber>;
+    prompt: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    disable: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    color: z.ZodOptional<z.ZodString>;
+    maxSteps: z.ZodOptional<z.ZodNumber>;
+    permission: z.ZodOptional<z.ZodObject<{
+        edit: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+        }>>;
+        bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+        }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+        }>>]>>;
+        webfetch: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+        }>>;
+        doom_loop: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+        }>>;
+        external_directory: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+        }>>;
+    }, z.core.$strip>>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    expand_tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>>;
+    opencode: z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            model: z.ZodString;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>>;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    pi: z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            model: z.ZodString;
+            thinking_level: z.ZodOptional<z.ZodEnum<{
+                off: "off";
+                minimal: "minimal";
+                low: "low";
+                medium: "medium";
+                high: "high";
+                xhigh: "xhigh";
+                max: "max";
+            }>>;
+        }, z.core.$strict>]>>;
+        fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            model: z.ZodString;
+            thinking_level: z.ZodOptional<z.ZodEnum<{
+                off: "off";
+                minimal: "minimal";
+                low: "low";
+                medium: "medium";
+                high: "high";
+                xhigh: "xhigh";
+                max: "max";
+            }>>;
+        }, z.core.$strict>]>>>;
+        thinking_level: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            minimal: "minimal";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            max: "max";
+        }>>;
+    }, z.core.$strict>>;
+    two_pass: z.ZodDefault<z.ZodBoolean>;
+    disallowed_tools: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        read: "read";
+        "*": "*";
+        aft_outline: "aft_outline";
+        aft_zoom: "aft_zoom";
+        aft_search: "aft_search";
+    }>>>;
+}, z.core.$strip>>;
+export type HistorianConfig = NonNullable<z.infer<typeof HistorianConfigSchema>>;
+export interface MagicContextConfig {
+    enabled: boolean;
+    /** User-level setting that lets a session in the canonical home directory use project memory. */
+    allow_home_project: boolean;
+    /** DEPRECATED no-op: the auto-update check was removed (2026-10-05) — the package is
+     *  private-registry-only, so public npm checks always failed. The key is still accepted
+     *  (USER config only; project configs stripped) so existing configs keep parsing. */
+    auto_update?: boolean;
+    /** Output language for generated Magic Context prose. USER config only. */
+    language?: string;
+    /** Active user-owned model profile after user/project resolution. */
+    profile?: string;
+    /** Named user-owned model profiles. Declarations are consumed during resolution. */
+    profiles?: ConfigProfiles;
+    historian?: HistorianConfig;
+    cache_ttl: string | {
+        default: string;
+        [modelKey: string]: string;
+    };
+    /** Preset routing for guidance and provider-visible prompt surfaces. */
+    prompt_surface: PromptSurfaceConfig;
+    /** User-only output-token reservation override. Zero disables reservation. */
+    output_reserve?: number | {
+        default: number;
+        [modelKey: string]: number;
+    };
+    /** User-only model metadata inputs. */
+    models?: {
+        window_overlay_path?: string;
+    };
+    /** TUI toast lifetime in milliseconds for Magic Context notifications. Default: 5000. */
+    toast_duration_ms?: number;
+    execute_threshold_percentage: number | {
+        default: number;
+        [modelKey: string]: number;
+    };
+    /** Absolute token thresholds per model. When set for a given model (or via `default`),
+     *  this overrides `execute_threshold_percentage` for that model. Useful for hard caps
+     *  matching provider input limits. Values above 90% × context_limit are clamped with a warning. */
+    execute_threshold_tokens?: {
+        default?: number;
+        [modelKey: string]: number | undefined;
+    };
+    protected_tokens?: number;
+    clear_reasoning_age: number;
+    history_budget_percentage: number;
+    historian_timeout_ms: number;
+    commit_cluster_trigger: {
+        enabled: boolean;
+        min_clusters: number;
+    };
+    /** Per-connection SQLite tuning for Magic Context's own context.db. */
+    sqlite: {
+        cache_size_mb: number;
+        mmap_size_mb: number;
+    };
+    /**
+     * Keep shared-storage permissions under an external operator's control.
+     * USER config only; project configs cannot weaken local data privacy.
+     */
+    storage: {
+        enforce_private_permissions: boolean;
+    };
+    /**
+     * Controls whether and where Magic Context augments the system prompt
+     * (`## Magic Context` guidance, sticky date)
+     * inside `experimental.chat.system.transform`.
+     *
+     * Internal OpenCode hidden agents (title, summary, compaction) are
+     * always skipped automatically — that's a separate code path.
+     */
+    system_prompt_injection: {
+        /** When false, NO injection happens for ANY agent — global escape hatch. */
+        enabled: boolean;
+        /**
+         * If the agent's system prompt contains any of these substrings,
+         * skip ALL Magic Context injection for that call. Lets users opt
+         * specific agents out (e.g. read-only QA agents that deny our
+         * `mmc_*` tools and don't need the guidance). The default marker
+         * `<!-- magic-context: skip -->` is meant to be added inside the
+         * user's custom agent prompt.
+         */
+        skip_signatures: string[];
+    };
+    /** Inject elapsed-time markers between user messages and date ranges on
+     *  compartments so the agent has a wall-clock sense of the session.
+     *  Graduated from `experimental.temporal_awareness`; default: true. */
+    temporal_awareness: boolean;
+    /** Debug: when true, keep the child sessions Magic Context spawns for its
+     *  own subagents (historian) instead
+     *  of deleting them on success. For short-term inspection/data collection;
+     *  kept sessions accumulate until manually cleared. Default false. */
+    keep_subagents: boolean;
+    /** Enable loopback-only diagnostic RPCs that expose memory usage and heap snapshots. */
+    debug_rpc?: boolean;
+    /**
+     * When true (default), deterministic inoperability (schema fence, storage
+     * open/migration failure) blocks the primary-session transform with a loud
+     * recovery error instead of silently falling through to native compaction.
+     * USER config only — project tier cannot set this. Not recommended to disable.
+     */
+    fail_closed_blocking: boolean;
+    /**
+     * Compaction-off mode gate. When `enabled` is false Magic Context stops
+     * managing the context window and keeps only its knowledge layer, letting
+     * the harness's native compaction (or nothing) own the window. USER config
+     * only — project tier `compaction.enabled` is stripped for security.
+     * Boot-resolved: changing it requires a process restart.
+     */
+    compaction: {
+        enabled: boolean;
+    };
+    /** Pi-only controls for Magic Context's OpenCode-parity todowrite surface. */
+    todowrite: {
+        enabled: boolean;
+        overlay: boolean;
+    };
+    /** Pi-only child-process extension controls. */
+    pi?: PiConfig;
+    /** Content-aware reclaim of tool output that a later call supersedes, added
+     *  to the normal age-based auto-drop: superseded todowrite/mmc_reduce/meta
+     *  outputs are dropped, and older edits to a file are compressed to a marker
+     *  that keeps only the filePath. Only runs on a transform pass that is
+     *  already rewriting the messages, so it never triggers a prompt-cache miss
+     *  on its own; when off, the messages sent to the model are byte-identical to
+     *  the age-based-only behavior. Experimental, opt-in, default off until cache
+     *  stability is proven. */
+    smart_drops: boolean;
+    /**
+     * Age-tier caveman compression for long user/assistant text parts.
+     * Graduated from `experimental.caveman_text_compression`; opt-in, default off.
+     *
+     * Active only for primary sessions when enabled; never for subagents.
+     * Buckets eligible (outside-protected-tail) messages into four age
+     * tiers by tag position — oldest 20% → ultra, next 20% → full,
+     * next 20% → lite, newest 40% → untouched — and rewrites the text
+     * part in place.
+     * Always compresses from the original source (source_contents), so
+     * tier shifts produce the same result as if the target depth were
+     * applied directly to the original text.
+     *
+     * Disabled by default because it rewrites agent-visible history.
+     */
+    caveman_text_compression: {
+        enabled: boolean;
+        /** Text parts shorter than this (characters) are left untouched. */
+        min_chars: number;
+    };
+    memory: {
+        enabled: boolean;
+        injection_budget_tokens: number;
+        auto_promote: boolean;
+        /** Appends a compact hint to new user messages when mmc_search finds
+         *  highly-related memories or conversation. Does NOT
+         *  inject full content — just vague fragments that nudge the agent to
+         *  run mmc_search for full context if relevant. Graduated from
+         *  `experimental.auto_search`; enabled by default. Independent of
+         *  `memory.enabled` — it can still surface conversation hints when
+         *  the memory store is off. */
+        auto_search: {
+            enabled: boolean;
+            /** Top hit score must exceed this threshold for the hint to fire. */
+            score_threshold: number;
+            /** Minimum user message length in characters (skip short prompts). */
+            min_prompt_chars: number;
+        };
+    };
+    /**
+     * Automatic memory-maintenance run controls (plan 10, dreamer replacement).
+     * USER config only — the whole group is stripped from project-tier config:
+     * a cloned repository must not raise run budgets, relax cooldowns/backoff,
+     * or loosen the anomaly guard to weaponize the maintenance task.
+     */
+    maintenance: {
+        enabled: boolean;
+        /** Per-run four-dimensional budget (decision 9; provisional, calibrated in P3/P4). */
+        budgets: {
+            inputTokens: number;
+            outputTokens: number;
+            toolSteps: number;
+            wallMs: number;
+        };
+        /** Inter-run cooldown and failure-backoff schedule (decision 10; provisional). */
+        cooldowns: {
+            interRunMs: number;
+            backoffScheduleMs: number[];
+            backoffCapMs: number;
+            maxRetries: number;
+        };
+        /** Anomaly guard: single-run change-volume dual gate (decision 11).
+         *  Defaults are P1/P2 TEST defaults — production values are calibrated
+         *  against real-model samples in P3. */
+        anomalyThreshold: {
+            absoluteRows: number;
+            poolFraction: number;
+        };
+    };
+}
+export declare const MagicContextConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    allow_home_project: z.ZodDefault<z.ZodBoolean>;
+    auto_update: z.ZodOptional<z.ZodBoolean>;
+    language: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodString>;
+    profiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        historian: z.ZodOptional<z.ZodObject<{
+            opencode: z.ZodOptional<z.ZodObject<{
+                model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    model: z.ZodString;
+                    variant: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>]>>;
+                fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    model: z.ZodString;
+                    variant: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>]>>>;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            pi: z.ZodOptional<z.ZodObject<{
+                model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    model: z.ZodString;
+                    thinking_level: z.ZodOptional<z.ZodEnum<{
+                        off: "off";
+                        minimal: "minimal";
+                        low: "low";
+                        medium: "medium";
+                        high: "high";
+                        xhigh: "xhigh";
+                        max: "max";
+                    }>>;
+                }, z.core.$strict>]>>;
+                fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    model: z.ZodString;
+                    thinking_level: z.ZodOptional<z.ZodEnum<{
+                        off: "off";
+                        minimal: "minimal";
+                        low: "low";
+                        medium: "medium";
+                        high: "high";
+                        xhigh: "xhigh";
+                        max: "max";
+                    }>>;
+                }, z.core.$strict>]>>>;
+                thinking_level: z.ZodOptional<z.ZodEnum<{
+                    off: "off";
+                    minimal: "minimal";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    xhigh: "xhigh";
+                    max: "max";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    historian: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodOptional<z.ZodEnum<{
+            subagent: "subagent";
+            primary: "primary";
+            all: "all";
+        }>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        top_p: z.ZodOptional<z.ZodNumber>;
+        prompt: z.ZodOptional<z.ZodString>;
+        tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+        disable: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        maxSteps: z.ZodOptional<z.ZodNumber>;
+        permission: z.ZodOptional<z.ZodObject<{
+            edit: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
+            bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>]>>;
+            webfetch: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
+            doom_loop: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
+            external_directory: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
+        }, z.core.$strip>>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        expand_tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>>;
+        opencode: z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                variant: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>>;
+            variant: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        pi: z.ZodOptional<z.ZodObject<{
+            model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                thinking_level: z.ZodOptional<z.ZodEnum<{
+                    off: "off";
+                    minimal: "minimal";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    xhigh: "xhigh";
+                    max: "max";
+                }>>;
+            }, z.core.$strict>]>>;
+            fallback_models: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                model: z.ZodString;
+                thinking_level: z.ZodOptional<z.ZodEnum<{
+                    off: "off";
+                    minimal: "minimal";
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                    xhigh: "xhigh";
+                    max: "max";
+                }>>;
+            }, z.core.$strict>]>>>;
+            thinking_level: z.ZodOptional<z.ZodEnum<{
+                off: "off";
+                minimal: "minimal";
+                low: "low";
+                medium: "medium";
+                high: "high";
+                xhigh: "xhigh";
+                max: "max";
+            }>>;
+        }, z.core.$strict>>;
+        two_pass: z.ZodDefault<z.ZodBoolean>;
+        disallowed_tools: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            read: "read";
+            "*": "*";
+            aft_outline: "aft_outline";
+            aft_zoom: "aft_zoom";
+            aft_search: "aft_search";
+        }>>>;
+    }, z.core.$strip>>;
+    cache_ttl: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        default: z.ZodString;
+    }, z.core.$catchall<z.ZodString>>]>>;
+    prompt_surface: z.ZodDefault<z.ZodObject<{
+        default: z.ZodDefault<z.ZodEnum<{
+            full: "full";
+            light: "light";
+        }>>;
+        models: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+            full: "full";
+            light: "light";
+        }>>>;
+        guidance_override_path: z.ZodOptional<z.ZodString>;
+        tool_descriptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    output_reserve: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+        default: z.ZodNumber;
+    }, z.core.$catchall<z.ZodNumber>>]>>;
+    models: z.ZodOptional<z.ZodObject<{
+        window_overlay_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    toast_duration_ms: z.ZodDefault<z.ZodNumber>;
+    execute_threshold_percentage: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+        default: z.ZodNumber;
+    }, z.core.$catchall<z.ZodNumber>>]>>;
+    execute_threshold_tokens: z.ZodOptional<z.ZodObject<{
+        default: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$catchall<z.ZodNumber>>>;
+    protected_tokens: z.ZodOptional<z.ZodNumber>;
+    clear_reasoning_age: z.ZodDefault<z.ZodNumber>;
+    history_budget_percentage: z.ZodDefault<z.ZodNumber>;
+    historian_timeout_ms: z.ZodDefault<z.ZodNumber>;
+    commit_cluster_trigger: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        min_clusters: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    system_prompt_injection: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        skip_signatures: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    sqlite: z.ZodDefault<z.ZodObject<{
+        cache_size_mb: z.ZodDefault<z.ZodNumber>;
+        mmap_size_mb: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    storage: z.ZodDefault<z.ZodObject<{
+        enforce_private_permissions: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    temporal_awareness: z.ZodDefault<z.ZodBoolean>;
+    keep_subagents: z.ZodDefault<z.ZodBoolean>;
+    debug_rpc: z.ZodDefault<z.ZodBoolean>;
+    fail_closed_blocking: z.ZodDefault<z.ZodBoolean>;
+    compaction: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    todowrite: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        overlay: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    pi: z.ZodOptional<z.ZodObject<{
+        subagent_extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    smart_drops: z.ZodDefault<z.ZodBoolean>;
+    caveman_text_compression: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        min_chars: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    memory: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        injection_budget_tokens: z.ZodDefault<z.ZodNumber>;
+        auto_promote: z.ZodDefault<z.ZodBoolean>;
+        auto_search: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            score_threshold: z.ZodDefault<z.ZodNumber>;
+            min_prompt_chars: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    maintenance: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        budgets: z.ZodDefault<z.ZodObject<{
+            inputTokens: z.ZodDefault<z.ZodNumber>;
+            outputTokens: z.ZodDefault<z.ZodNumber>;
+            toolSteps: z.ZodDefault<z.ZodNumber>;
+            wallMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        cooldowns: z.ZodDefault<z.ZodObject<{
+            interRunMs: z.ZodDefault<z.ZodNumber>;
+            backoffScheduleMs: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+            backoffCapMs: z.ZodDefault<z.ZodNumber>;
+            maxRetries: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        anomalyThreshold: z.ZodDefault<z.ZodObject<{
+            absoluteRows: z.ZodDefault<z.ZodNumber>;
+            poolFraction: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Settings whose fresh values can be used by later agent runs without changing rendered prompt bytes. */
+export declare const LIVE_RELOAD_CONFIG_PATHS: readonly ["toast_duration_ms", "historian.opencode.model", "historian.opencode.fallback_models", "historian.opencode.variant", "historian.pi.model", "historian.pi.fallback_models", "historian.pi.thinking_level", "historian.two_pass", "historian.expand_tools", "historian.maxTokens", "historian_timeout_ms", "commit_cluster_trigger.enabled", "commit_cluster_trigger.min_clusters", "memory.auto_promote"];
+/**
+ * Derived default protected_tokens formula:
+ * clamp(round(0.05 × usableSoft), min(16000, round(0.08 × usableSoft)), 64000)
+ *
+ * Sizing table:
+ *   100k -> 8,000
+ *   200k -> 16,000
+ *   372k -> 18,600
+ *   872k -> 43,600
+ *   1M   -> 50,000
+ */
+export declare function deriveDefaultProtectedTokens(usableSoft: number): number;
+//# sourceMappingURL=magic-context.d.ts.map