@wrongstack/core 0.77.0 → 0.84.1

package/dist/{config-Dy0CK_o6.d.ts → config-_DZ7dN-T.d.ts}

@@ -1,5 +1,5 @@
-import { W as WireFamily } from './models-registry-BcYJDKLm.js';
-import { a as Capabilities, P as Permission } from './context-y87Jc5ei.js';
+import { W as WireFamily } from './models-registry-Be3osGt5.js';
+import { a as Capabilities, P as Permission } from './context-ToHAp4-U.js';
 
 /**
  * Lifecycle hook types — the pure, serializable contract shared by the config
@@ -27,20 +27,20 @@ type HookMatcher = string;
 interface HookInput {
     event: HookEvent;
     /** Present for PreToolUse / PostToolUse. */
-    toolName?: string;
+    toolName?: string | undefined;
     /** Tool arguments (PreToolUse / PostToolUse). */
-    toolInput?: unknown;
+    toolInput?: unknown | undefined;
     /** Tool result preview (PostToolUse only). */
     toolResult?: {
         content: string;
         isError: boolean;
     };
     /** The submitted user text (UserPromptSubmit only). */
-    prompt?: string;
+    prompt?: string | undefined;
     /** Absolute working directory of the session. */
     cwd: string;
     /** Active session id, when known. */
-    sessionId?: string;
+    sessionId?: string | undefined;
 }
 /**
  * What a hook returns. Every field is optional — an empty object (or a hook
@@ -51,9 +51,9 @@ interface HookOutcome {
      * `block` stops the action (PreToolUse → tool not run; UserPromptSubmit →
      * turn short-circuited). `allow` is the explicit no-op. Omitted = allow.
      */
-    decision?: 'block' | 'allow';
+    decision?: 'block' | 'allow' | undefined;
     /** Human-readable reason, surfaced to the model when blocking. */
-    reason?: string;
+    reason?: string | undefined;
     /**
      * PreToolUse only: replacement tool arguments. The executor swaps these in
      * and RE-VALIDATES them against the tool's input schema before running.
@@ -64,7 +64,7 @@ interface HookOutcome {
      * (PostToolUse), the user message (UserPromptSubmit), or the system preamble
      * (SessionStart).
      */
-    additionalContext?: string;
+    additionalContext?: string | undefined;
 }
 /** An in-process hook function (registered via the plugin API). */
 type InProcessHook = (input: HookInput) => HookOutcome | void | Promise<HookOutcome | void>;
@@ -77,9 +77,9 @@ interface ShellHook {
     /** Command line run via the platform shell. */
     command: string;
     /** Tool-name matcher (defaults to `*`). */
-    matcher?: HookMatcher;
+    matcher?: HookMatcher | undefined;
     /** Per-invocation timeout in ms (default 5000). */
-    timeoutMs?: number;
+    timeoutMs?: number | undefined;
 }
 /** A registered hook entry, discriminated by transport. */
 type HookEntry = {
@@ -87,13 +87,13 @@ type HookEntry = {
     event: HookEvent;
     matcher: HookMatcher;
     hook: InProcessHook;
-    owner?: string;
+    owner?: string | undefined;
 } | {
     kind: 'shell';
     event: HookEvent;
     matcher: HookMatcher;
     command: string;
-    timeoutMs?: number;
+    timeoutMs?: number | undefined;
 };
 
 type ContextWindowModeId = 'balanced' | 'frugal' | 'deep' | 'archival';
@@ -116,48 +116,48 @@ interface ContextWindowMode {
 interface ContextWindowPolicy extends ContextWindowMode {
 }
 interface ContextWindowConfigLike {
-    mode?: ContextWindowModeId | string;
-    warnThreshold?: number;
-    softThreshold?: number;
-    hardThreshold?: number;
-    preserveK?: number;
-    eliseThreshold?: number;
+    mode?: ContextWindowModeId | string | undefined;
+    warnThreshold?: number | undefined;
+    softThreshold?: number | undefined;
+    hardThreshold?: number | undefined;
+    preserveK?: number | undefined;
+    eliseThreshold?: number | undefined;
 }
 declare const DEFAULT_CONTEXT_WINDOW_MODE_ID: ContextWindowModeId;
 declare const CONTEXT_WINDOW_MODES: readonly ContextWindowMode[];
 declare function listContextWindowModes(): ContextWindowMode[];
 declare function getContextWindowMode(id: string | null | undefined): ContextWindowMode | null;
 declare function isContextWindowModeId(id: string): id is ContextWindowModeId;
-declare function resolveContextWindowPolicy(config?: ContextWindowConfigLike, overrideMode?: string | null): ContextWindowPolicy;
+declare function resolveContextWindowPolicy(config?: ContextWindowConfigLike, overrideMode?: string | null | undefined): ContextWindowPolicy;
 declare function formatContextWindowModeList(activeId?: string | null): string;
 
 interface ContextConfig {
     /** Context-window policy mode. Controls compaction thresholds and preservation depth. */
-    mode?: ContextWindowModeId;
+    mode?: ContextWindowModeId | undefined;
     warnThreshold: number;
     softThreshold: number;
     hardThreshold: number;
     /** Enable automatic compaction when thresholds are crossed (default: true). */
-    autoCompact?: boolean;
+    autoCompact?: boolean | undefined;
     /**
      * Model used for LLM-assisted summarization in IntelligentCompactor.
      * Falls back to the main model when omitted.
      */
-    summarizerModel?: string;
+    summarizerModel?: string | undefined;
     /**
      * Override the effective context window size (in tokens). Use this when
      * you want the compactor to trigger earlier than the provider's actual
      * maxContext. Defaults to the provider's reported maxContext.
      */
-    effectiveMaxContext?: number;
-    maxSessionTokens?: number;
-    maxDailyTokens?: number;
+    effectiveMaxContext?: number | undefined;
+    maxSessionTokens?: number | undefined;
+    maxDailyTokens?: number | undefined;
     preserveK: number;
     eliseThreshold: number;
     /** Compactor strategy: 'hybrid' (default, fast rules), 'intelligent' (LLM summarization), 'selective' (LLM-driven selection). */
-    strategy?: 'hybrid' | 'intelligent' | 'selective';
+    strategy?: 'hybrid' | 'intelligent' | 'selective' | undefined;
     /** Enable LLM-driven selective compaction (default: false for backward compat). */
-    llmSelector?: boolean;
+    llmSelector?: boolean | undefined;
 }
 interface ToolsConfig {
     defaultExecutionStrategy: 'parallel' | 'sequential' | 'smart';
@@ -169,7 +169,7 @@ interface ToolsConfig {
      * When true (default), the agent automatically extends its iteration
      * limit by 100 when hit. Set to false to require user confirmation.
      */
-    autoExtendLimit?: boolean;
+    autoExtendLimit?: boolean | undefined;
 }
 interface ProviderApiKey {
     /** Short human-readable label (e.g. "personal", "work", "rate-limit-backup"). */
@@ -190,14 +190,14 @@ interface ProviderConfig {
      * mirrors the active entry into this field so downstream consumers
      * (provider construction, wire adapters) need no changes.
      */
-    apiKey?: string;
+    apiKey?: string | undefined;
     /** Multiple keys for the same provider — pick one with `activeKey`. */
-    apiKeys?: ProviderApiKey[];
+    apiKeys?: ProviderApiKey[] | undefined;
     /** Label of the entry in `apiKeys` to use. Defaults to the first one. */
-    activeKey?: string;
-    baseUrl?: string;
+    activeKey?: string | undefined;
+    baseUrl?: string | undefined;
     headers?: Record<string, string>;
-    model?: string;
+    model?: string | undefined;
     quirks?: Record<string, unknown>;
     capabilities?: Record<string, unknown>;
     /**
@@ -205,11 +205,11 @@ interface ProviderConfig {
      * constructed without consulting the models.dev catalog — useful for
      * self-hosted endpoints, internal proxies, or for working offline.
      */
-    family?: WireFamily;
+    family?: WireFamily | undefined;
     /** Custom env var names to probe when `apiKey` is missing. */
-    envVars?: string[];
+    envVars?: string[] | undefined;
     /** Optional list of models the user wants visible for this provider. */
-    models?: string[];
+    models?: string[] | undefined;
     /**
      * Provider-relative custom model definitions (maps modelId → definition).
      * Each entry adds/overrides a model for this provider with optional
@@ -226,33 +226,33 @@ interface ProviderConfig {
 interface ModelMatrixEntry {
     /** Provider registry id (e.g. "anthropic", "minimax", "zai"). When omitted,
      *  the leader's provider is used with this entry's model. */
-    provider?: string;
+    provider?: string | undefined;
     /** Model id to run for the matched role/phase/default. */
     model: string;
 }
 interface MCPServerConfig {
     /** Human-readable description shown in `wstack mcp list`. */
-    description?: string;
+    description?: string | undefined;
     name: string;
     transport: 'stdio' | 'sse' | 'streamable-http';
-    command?: string;
-    args?: string[];
+    command?: string | undefined;
+    args?: string[] | undefined;
     env?: Record<string, string>;
-    url?: string;
+    url?: string | undefined;
     headers?: Record<string, string>;
-    enabled?: boolean;
-    allowedTools?: string[];
-    permission?: Permission;
-    startupTimeoutMs?: number;
-    requestTimeoutMs?: number;
+    enabled?: boolean | undefined;
+    allowedTools?: string[] | undefined;
+    permission?: Permission | undefined;
+    startupTimeoutMs?: number | undefined;
+    requestTimeoutMs?: number | undefined;
 }
 interface LogConfig {
     level: 'error' | 'warn' | 'info' | 'debug' | 'trace';
-    file?: string;
+    file?: string | undefined;
 }
 interface PluginConfig {
     name: string;
-    enabled?: boolean;
+    enabled?: boolean | undefined;
     options?: Record<string, unknown>;
 }
 /**
@@ -277,7 +277,7 @@ interface FeaturesConfig {
 }
 interface AutonomyConfig {
     /** ms to wait before auto-proceeding in 'auto' mode. Default: 45000. */
-    autoProceedDelayMs?: number;
+    autoProceedDelayMs?: number | undefined;
 }
 /**
  * Automatic codebase symbol-index maintenance. Keeps the `codebase-search`
@@ -301,15 +301,15 @@ interface IndexingConfig {
  */
 interface LaunchConfig {
     /** Interactive mode: 'tui' (Ink TUI) or 'repl' (readline REPL). */
-    mode?: 'tui' | 'repl';
+    mode?: 'tui' | 'repl' | undefined;
     /** Start with Director mode on (fleet manifest + multi-agent orchestration). */
-    director?: boolean;
+    director?: boolean | undefined;
     /**
      * Launch-time autonomy mode (binary choice from pre-launch prompt).
      * 'off' = stops after each turn; 'auto' = self-driving.
      * Distinct from `AutonomyConfig.defaultMode` which also supports 'suggest'.
      */
-    autonomy?: 'off' | 'auto';
+    autonomy?: 'off' | 'auto' | undefined;
 }
 /**
  * Controls how much detail is persisted to the per-session JSONL log
@@ -325,7 +325,7 @@ interface SessionLoggingConfig {
      * - "full"     → Also persist full request payloads (very large).
      *                Consider enabling a separate replay log instead.
      */
-    auditLevel?: 'minimal' | 'standard' | 'full';
+    auditLevel?: 'minimal' | 'standard' | 'full' | undefined;
     /**
      * Sampling configuration for high-volume events (especially relevant at
      * `auditLevel: "full"`).
@@ -338,7 +338,7 @@ interface SessionLoggingConfig {
              * - 1 = no sampling (every message is logged)
              * - 8 = default (first message + every 8th)
              */
-            sampleRate?: number;
+            sampleRate?: number | undefined;
         };
     };
 }
@@ -349,7 +349,7 @@ interface SyncConfig {
     /** GitHub token (fine-grained PAT). Encrypted at rest via SecretVault. */
     githubToken: string;
     categories: SyncCategory[];
-    lastSyncedAt?: string;
+    lastSyncedAt?: string | undefined;
 }
 /**
  * Per-model capability overrides the user can define in their config.
@@ -358,30 +358,30 @@ interface SyncConfig {
  */
 interface CustomModelDefinition {
     /** Provider this model belongs to. Defaults to the owning ProviderConfig. */
-    provider?: string;
+    provider?: string | undefined;
     /** Optional display name. */
-    name?: string;
+    name?: string | undefined;
     /** Capability overrides — only specified fields are overlaid. */
-    capabilities?: Partial<Capabilities>;
+    capabilities?: Partial<Capabilities> | undefined;
     /**
      * Max output tokens. If not specified, the provider family default
      * or catalog entry is used.
      */
-    maxOutput?: number;
+    maxOutput?: number | undefined;
 }
 interface Config {
     version: 1;
     provider: string;
     model: string;
-    apiKey?: string;
-    baseUrl?: string;
+    apiKey?: string | undefined;
+    baseUrl?: string | undefined;
     /**
      * Maximum number of subagent tasks the fleet coordinator dispatches
      * simultaneously. Extra tasks queue until a slot frees. Default: 4.
      * Overridden by WRONGSTACK_MAX_CONCURRENT env var and --max-concurrent
      * CLI flag. Change at runtime with /fleet concurrency <n>.
      */
-    maxConcurrent?: number;
+    maxConcurrent?: number | undefined;
     providers?: Record<string, ProviderConfig>;
     /**
      * Top-level custom models (maps modelId → definition). Merged with
@@ -407,7 +407,7 @@ interface Config {
      * provider), `provider/model`, or `provider model`. The primary is always
      * re-tried first at the start of every user turn. See `createFallbackModelExtension`.
      */
-    fallbackModels?: string[];
+    fallbackModels?: string[] | undefined;
     /**
      * Lifecycle shell hooks, keyed by event. Each command receives the hook
      * `HookInput` JSON on stdin; a JSON `HookOutcome` on stdout (and exit code 2
@@ -415,29 +415,31 @@ interface Config {
      * the plugin API. Disabled entirely under `--bare` / `--no-hooks`.
      */
     hooks?: Partial<Record<HookEvent, ShellHook[]>>;
-    plugins?: (string | PluginConfig)[];
+    plugins?: (string | PluginConfig)[] | undefined;
     log: LogConfig;
     features: FeaturesConfig;
-    yolo?: boolean;
+    yolo?: boolean | undefined;
     /** When true, show lightweight LLM-predicted next steps after each turn (/next). */
-    nextPrediction?: boolean;
-    cwd?: string;
+    nextPrediction?: boolean | undefined;
+    cwd?: string | undefined;
     /** Autonomy mode configuration (auto-proceed delay, etc.). */
-    autonomy?: AutonomyConfig;
+    autonomy?: AutonomyConfig | undefined;
+    /** Show rotating launch hints on startup. Default: true. Set to false to suppress. */
+    hints?: boolean | undefined;
     /** Automatic codebase symbol-index maintenance (session-start + live updates). */
-    indexing?: IndexingConfig;
+    indexing?: IndexingConfig | undefined;
     /** Saved launch preferences — restored on next boot for one-line confirmation. */
-    launch?: LaunchConfig;
+    launch?: LaunchConfig | undefined;
     /**
      * Session logging & audit configuration.
      * Controls what gets written to the persistent JSONL transcript.
      */
-    session?: SessionLoggingConfig;
+    session?: SessionLoggingConfig | undefined;
     /**
      * Cloud sync configuration. Stored separately in sync.json to avoid
      * accidentally committing the GitHub token to project configs.
      */
-    sync?: SyncConfig;
+    sync?: SyncConfig | undefined;
     /**
      * Per-plugin namespaced config sections. Each plugin reads its own
      * subtree via `ConfigStore.getExtension(pluginName)`. Plugins should
@@ -454,8 +456,8 @@ interface Config {
 }
 interface ConfigLoader {
     load(opts?: {
-        cliFlags?: Partial<Config>;
-        cwd?: string;
+        cliFlags?: Partial<Config> | undefined;
+        cwd?: string | undefined;
     }): Promise<Config>;
     /** Load and decrypt the sync config from ~/.wrongstack/sync.json. */
     loadSyncConfig(): Promise<SyncConfig | null>;