@kodax-ai/kodax 0.7.72 → 0.7.74

package/dist/types-chunks/{utils.d-gmn3c5U4.d.ts → utils.d-D0wPxz8y.d.ts}

@@ -1,11 +1,94 @@
-import { k as KodaXMessage, F as KodaXReasoningMode, d as KodaXCustomProviderConfig, p as KodaXProviderCapabilityProfile } from './types.d-Cqaw71Ax.js';
-import { M as KodaXContextTokenSnapshot, ah as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, a4 as KodaXRepoIntelligenceMode, $ as KodaXOptions, ai as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-CHJO5y94.js';
-import { bW as KodaXSessionUiHistoryItem, bL as KodaXSessionLineage, bC as KodaXSessionArtifactLedgerEntry, bm as KodaXExtensionSessionState, bl as KodaXExtensionSessionRecord, bS as KodaXSessionRuntimeInfo, ea as WorkflowProcessSource } from './types.d-DH1mvdcl.js';
-import { d as AgentsFile, j as AutoModeStats, p as KodaXMcpServersConfig } from './guardrail.d-auV61_h5.js';
+import { k as KodaXMessage, F as KodaXReasoningMode, d as KodaXCustomProviderConfig, p as KodaXProviderCapabilityProfile } from './types.d-CSmF0t0n.js';
+import { O as KodaXContextTokenSnapshot, aj as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, a6 as KodaXRepoIntelligenceMode, a1 as KodaXOptions, ak as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-r1beOESM.js';
+import { bX as KodaXSessionUiHistoryItem, bM as KodaXSessionLineage, bD as KodaXSessionArtifactLedgerEntry, bn as KodaXExtensionSessionState, bm as KodaXExtensionSessionRecord, bT as KodaXSessionRuntimeInfo, eb as WorkflowProcessSource } from './types.d-sRLugmjy.js';
+import { d as AgentsFile, r as AutoModeStats, x as KodaXMcpServersConfig } from './guardrail.d-qjuKJZ31.js';
 import * as readline from 'readline';
-import { R as PermissionMode, L as LearningBinding, E as LearningSurfaceSnapshot } from './public-api.d--IDNJsu1.js';
+import { R as PermissionMode, L as LearningBinding, E as LearningSurfaceSnapshot } from './public-api.d-CX4B11qY.js';
 import { SpawnSyncReturns } from 'child_process';
 
+/**
+ * Permission Config - 2-level permission configuration load/save
+ *
+ * Priority: project-level (.kodax/config.local.json) > user-level (~/.kodax/config.json)
+ * 优先级：项目级 (.kodax/config.local.json) > 用户级 (~/.kodax/config.json)
+ *
+ * Pattern format (ONLY for Bash tool in accept-edits mode):
+ * - "Bash(npm install)" - exact command match
+ * - "Bash(git commit:*)" - prefix wildcard (matches "git commit -m 'msg'" etc.)
+ * - "Bash(npm:*)" - command prefix wildcard (matches "npm install", "npm run" etc.)
+ *
+ * Note: Bash(*) is REJECTED for safety. Use specific command patterns.
+ * Note: Other tools don't need patterns:
+ * - Read/Glob/Grep: Always allowed (project-external is enforced confirmation)
+ * - Edit/Write: Auto-allowed in accept-edits, blocked in plan
+ */
+
+/**
+ * Auto-mode classifier configuration. Read from `~/.kodax/config.json` (user-
+ * level only — project-level is intentionally not consulted, matching
+ * `permissionMode`'s scope) plus the `KODAX_AUTO_MODE_*` env override family.
+ */
+interface AutoModeSettings {
+    /**
+     * Starting engine for the session.
+     * - `'llm'` (default): classifier runs on every non-Tier-1 tool call
+     * - `'rules'`: classifier skipped; deterministic workspace/temp Tier 2 applies
+     * Engine downgrades stay sticky within the session regardless of this value.
+     */
+    engine?: 'llm' | 'rules';
+    /**
+     * Classifier model spec — `"provider:model"` or `"model"` (provider then
+     * inherits from the main session). Feeds layer 4 of `resolveClassifierModel`.
+     */
+    classifierModel?: string;
+    /** sideQuery timeout in ms. Default 20_000. */
+    timeoutMs?: number;
+    /**
+     * Issue 143 (WS3): speculative-classify quiet window in ms. Default 500.
+     * The window only controls "resolve instantly vs wait for the verdict" — the
+     * classifier verdict is always adopted (WS1), so this never decides
+     * "dialog vs no dialog". `0` disables the speculative race (synchronous
+     * classify). Lets users on slow/remote providers widen the window so a fast
+     * local classify still short-circuits while a slow one simply waits.
+     */
+    speculativeWindowMs?: number;
+}
+interface ResolvedAutoModeSettings {
+    readonly engine: 'llm' | 'rules';
+    readonly classifierModel?: string;
+    readonly classifierModelEnv?: string;
+    readonly timeoutMs?: number;
+    readonly speculativeWindowMs?: number;
+}
+interface ResolveAutoModeSettingsInput {
+    readonly settings?: AutoModeSettings;
+    readonly env?: NodeJS.ProcessEnv | Readonly<Record<string, string | undefined>>;
+}
+/**
+ * Load auto-mode settings from `~/.kodax/config.json` and apply the
+ * `KODAX_AUTO_MODE_*` env override family. This wrapper performs one
+ * filesystem read; `resolveAutoModeSettings()` is the pure counterpart.
+ *
+ * Env priority (highest first):
+ *   - KODAX_AUTO_MODE_ENGINE: 'llm' | 'rules' — overrides settings.engine
+ *   - KODAX_AUTO_MODE_CLASSIFIER_MODEL: model spec — surfaced as `classifierModelEnv`
+ *     so it reaches `AutoModeGuardrailConfig.envVar` (the resolver's layer 2)
+ *   - KODAX_AUTO_MODE_TIMEOUT_MS: integer ms — overrides settings.timeoutMs
+ *   - KODAX_AUTO_SPECULATIVE_WINDOW_MS: integer ms (0 disables) — overrides
+ *     settings.speculativeWindowMs (Issue 143 WS3; reuses the same env name
+ *     speculative.ts reads, so a single var controls the knob everywhere)
+ *
+ * Invalid env values fall through to settings (defensive: a typo in an env
+ * var must not silently disable the classifier).
+ */
+declare function loadAutoModeSettings(env?: NodeJS.ProcessEnv): ResolvedAutoModeSettings;
+/**
+ * Resolve Auto settings from caller-owned data without reading global files.
+ * SDK hosts can therefore share the REPL's validation and precedence rules
+ * while retaining ownership of their own configuration source.
+ */
+declare function resolveAutoModeSettings(input?: ResolveAutoModeSettingsInput): ResolvedAutoModeSettings;
+
 /**
  * KodaX Interactive Context Management - 交互式上下文管理
  */
@@ -165,7 +248,7 @@ interface CommandCallbacks {
     setThinking?: (enabled: boolean) => void;
     setReasoningMode?: (mode: KodaXReasoningMode) => void;
     setAgentMode?: (mode: KodaXAgentMode) => void;
-    setPermissionMode?: (mode: PermissionMode) => void;
+    setPermissionMode?: (mode: PermissionMode) => void | Promise<void>;
     setRepoIntelligenceRuntime?: (update: {
         mode?: KodaXRepoIntelligenceMode;
         trace?: boolean;
@@ -238,13 +321,13 @@ interface CommandCallbacks {
      * guardrail state through it. Used by `/auto-engine` (show), `/auto-denials`,
      * and the status bar engine indicator.
      */
-    getAutoModeStats?: () => AutoModeStats | undefined;
+    getAutoModeStats?: () => AutoModeStats | undefined | Promise<AutoModeStats | undefined>;
     /**
      * FEATURE_092 phase 2b.8: manual engine setter for `/auto-engine llm|rules`.
      * No-op when the guardrail hasn't been constructed yet. Threshold downgrades
      * still operate normally — a subsequent denial cross will downgrade again.
      */
-    setAutoModeEngine?: (engine: 'llm' | 'rules') => void;
+    setAutoModeEngine?: (engine: 'llm' | 'rules') => void | Promise<void>;
     ui: UIContext;
 }
 interface CommandResultData {
@@ -428,6 +511,7 @@ declare function loadConfig(): {
     reasoningCeiling?: KodaXReasoningMode;
     agentMode?: KodaXAgentMode;
     permissionMode?: string;
+    autoMode?: AutoModeSettings;
     locale?: string;
     providerModels?: Record<string, string[]>;
     customProviders?: KodaXCustomProviderConfig[];
@@ -599,5 +683,5 @@ declare function resolveRuntimeEffortSelection(input: {
 declare function getGitRoot(cwd?: string): Promise<string | null>;
 declare function rateLimitedCall<T>(fn: () => Promise<T>): Promise<T>;
 
-export { registerConfiguredCustomProviders as A, resolveRuntimeEffortSelection as B, resolveRuntimeModelSelection as D, resolveRuntimeProviderSelection as E, saveConfig as F, touchContext as G, KODAX_CONFIG_FILE as K, PREVIEW_MAX_LENGTH as P, KODAX_DIR as i, KODAX_EXAMPLE_CONFIG_FILE as j, KODAX_INTEGRATION_EXAMPLE_FILES as k, KODAX_SESSIONS_DIR as l, KODAX_VERSION as m, createInteractiveContext as o, ensureExampleConfigFile as p, ensureExampleConfigFiles as q, getGitRoot as r, getProviderList as s, getProviderModel as t, getVersion as u, hydrateProcessEnvFromShell as v, isProviderConfigured as w, loadConfig as x, prepareRuntimeConfig as y, rateLimitedCall as z };
-export type { Command as C, InteractiveContext as I, RuntimeSurfaceMode as R, CommandCallbacks as a, CommandDefinition as b, CommandInfo as c, CommandInvocationRequest as d, CommandSource as e, CommandWorkflowInvocationRequest as f, CurrentConfig as g, InteractiveMode as h, RuntimeSurfaceStatus as n };
+export { loadConfig as B, prepareRuntimeConfig as D, rateLimitedCall as E, registerConfiguredCustomProviders as F, resolveAutoModeSettings as G, resolveRuntimeEffortSelection as H, resolveRuntimeModelSelection as J, KODAX_CONFIG_FILE as K, resolveRuntimeProviderSelection as L, saveConfig as M, touchContext as N, PREVIEW_MAX_LENGTH as P, KODAX_DIR as i, KODAX_EXAMPLE_CONFIG_FILE as j, KODAX_INTEGRATION_EXAMPLE_FILES as k, KODAX_SESSIONS_DIR as l, KODAX_VERSION as m, createInteractiveContext as q, ensureExampleConfigFile as r, ensureExampleConfigFiles as s, getGitRoot as t, getProviderList as u, getProviderModel as v, getVersion as w, hydrateProcessEnvFromShell as x, isProviderConfigured as y, loadAutoModeSettings as z };
+export type { AutoModeSettings as A, Command as C, InteractiveContext as I, ResolveAutoModeSettingsInput as R, CommandCallbacks as a, CommandDefinition as b, CommandInfo as c, CommandInvocationRequest as d, CommandSource as e, CommandWorkflowInvocationRequest as f, CurrentConfig as g, InteractiveMode as h, ResolvedAutoModeSettings as n, RuntimeSurfaceMode as o, RuntimeSurfaceStatus as p };