@kodax-ai/kodax 0.7.44 → 0.7.46

package/dist/types-chunks/{bash-prefix-extractor.d-DdoSeghD.d.ts → bash-prefix-extractor.d-BICYx8pt.d.ts}

@@ -1,9 +1,9 @@
-import { g as KodaXGoalState, s as KodaXSessionLineage, x as KodaXSessionScope, y as KodaXSessionStorage, i as KodaXJsonValue, k as KodaXSessionArtifactLedgerEntry, S as SessionErrorMetadata } from './types.d-HBbWT-iA.js';
-import { W as KodaXTokenUsage, m as KodaXMessage, D as KodaXReasoningMode, k as KodaXHarnessProfile, R as KodaXTaskWorkIntent, H as KodaXReviewScale, N as KodaXTaskComplexity, a as KodaXAmaFanoutClass, P as KodaXTaskRoutingDecision, Q as KodaXTaskType, I as KodaXRiskLevel, i as KodaXExecutionMode, c as KodaXAmaProfile, d as KodaXAmaTactic, b as KodaXAmaFanoutPolicy } from './types.d-B1uGoVTE.js';
-import { f as AgentMessage, av as StopHookFn, C as ChildTaskRegistry, p as CompactionUpdate, v as Guardrail, s as DiscoveredInstance, az as TaskAbortRegistry, aa as RunnerToolCall, aE as ToolGuardrail } from './types.d-DM8zEJgF.js';
 import { M as McpConnectMode, a as McpServerConfig, b as McpServersConfig, c as McpTransportKind } from './config.d-BfJUXxC0.js';
+import { g as KodaXGoalState, s as KodaXSessionLineage, x as KodaXSessionScope, y as KodaXSessionStorage, i as KodaXJsonValue, k as KodaXSessionArtifactLedgerEntry, S as SessionErrorMetadata } from './types.d-B_MIIApc.js';
+import { X as KodaXTokenUsage, n as KodaXMessage, E as KodaXReasoningMode, k as KodaXHarnessProfile, S as KodaXTaskWorkIntent, I as KodaXReviewScale, O as KodaXTaskComplexity, a as KodaXAmaFanoutClass, Q as KodaXTaskRoutingDecision, R as KodaXTaskType, J as KodaXRiskLevel, i as KodaXExecutionMode, c as KodaXAmaProfile, d as KodaXAmaTactic, b as KodaXAmaFanoutPolicy } from './types.d-Cf-GCzac.js';
+import { f as AgentMessage, av as StopHookFn, C as ChildTaskRegistry, p as CompactionUpdate, v as Guardrail, s as DiscoveredInstance, az as TaskAbortRegistry, aa as RunnerToolCall, aE as ToolGuardrail } from './types.d-D2RNa5Y7.js';
 import { C as CapabilityKind, b as CapabilityResult } from './capability.d-3C62G8Eq.js';
-import { K as KodaXBaseProvider } from './base.d-FUJahC0i.js';
+import { K as KodaXBaseProvider } from './base.d-BdJKSPO2.js';
 import { a as CostTracker } from './cost-tracker.d-wRtyEW9d.js';
 
 /**
@@ -790,6 +790,162 @@ interface ProviderResiliencePolicy extends ProviderResilienceConfig {
     provider: string;
 }
 
+/**
+ * FEATURE_200 Phase F (v0.7.45) — MCP domain types extracted from types.ts.
+ * Thin KodaX-facing aliases over the @kodax-ai/agent MCP types. Re-exported
+ * from ../types.ts so all `../types` importers are unaffected.
+ */
+
+type KodaXMcpTransport = McpTransportKind;
+type KodaXMcpConnectMode = McpConnectMode;
+type KodaXMcpServerConfig = McpServerConfig;
+/** Flat map of MCP server configs, keyed under `mcpServers` in config.json. */
+type KodaXMcpServersConfig = McpServersConfig;
+
+/**
+ * FEATURE_200 Phase F (v0.7.45) — Todo domain types extracted from types.ts.
+ * Self-contained (no other coding-type deps); re-exported from ../types.ts
+ * so all `../types` importers are unaffected.
+ */
+/**
+ * Status of a planned todo item. Lifecycle: pending → in_progress →
+ * (completed | failed | skipped). Failed items are reset to pending
+ * when the next iteration begins (Evaluator revise verdict). Skipped
+ * is for Planner-side merging of two obligations into one.
+ */
+type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'skipped' | 'cancelled';
+/**
+ * FEATURE_114 v0.7.36: Per-step deterministic evaluator hint. When a
+ * todo item carries an `evaluator`, the runner runs the corresponding
+ * deterministic check (build / test / lint) at the moment its status
+ * transitions to `completed`. Failure surfaces stderr in the next
+ * tool result so the Worker can self-correct. No LLM-as-judge
+ * variant — Phase 0.7 industry survey said 4/4 codebases reject
+ * per-step LLM verification.
+ */
+type TodoEvaluatorHint = 'build' | 'test' | 'lint';
+/**
+ * One row in the planner-produced todo list. Subject is the short
+ * imperative title (shown in the UI row + throttle reminder); the
+ * optional description carries fuller context for downstream consumers
+ * that need the full work instruction. Sourced from Scout's existing
+ * `executionObligations: string[]` payload (each string becomes the
+ * `subject` of one seed item, no `description`). Status is advanced
+ * via the `todo_update` tool by Scout (H0 path) / Worker / Generator /
+ * Planner.
+ *
+ * v0.7.42 — `content` field renamed to `subject` to match claudecode V2
+ * `TaskSchema` (TaskCreateTool's required `subject` + `description`
+ * pair). KodaX makes `description` optional because trivial single-line
+ * steps don't need it; weaker models reach the API more easily without
+ * the forced second-string burden.
+ *
+ * `owner` partitions the list when child agents run in parallel under
+ * `dispatch_child_task`; "main" is the parent thread.
+ */
+interface TodoItem {
+    readonly id: string;
+    /** Brief imperative title — the row label users see in the plan list. */
+    readonly subject: string;
+    /**
+     * Optional fuller description / context. Read by the executing role
+     * when picking up an item (claudecode V2 `TaskGet`-style detail view).
+     * Not rendered in the compact plan-list row.
+     */
+    readonly description?: string;
+    readonly status: TodoStatus;
+    readonly owner?: string;
+    /** Index into the originating `executionObligations: string[]` array (0-based). */
+    readonly sourceObligationIndex?: number;
+    /** Optional note attached on a status transition (e.g. failure reason). */
+    readonly note?: string;
+    /**
+     * FEATURE_114 v0.7.36: per-step deterministic evaluator hint. When
+     * present, the runner runs the corresponding deterministic check on
+     * `pending → completed` and surfaces stderr / exit code in the next
+     * tool result on failure.
+     */
+    readonly evaluator?: TodoEvaluatorHint;
+    /**
+     * FEATURE_149 v0.7.38 (Slice C4) — present-continuous form of `content`,
+     * used by the spinner status line while this item is `in_progress`.
+     * Mirrors Claude Code's [`Spinner.tsx:169`](c:/Works/claudecode/src/components/Spinner.tsx#L169)
+     * `currentTodo?.activeForm` lookup. Examples:
+     *   content: "Run failing test"  → activeForm: "Running failing test"
+     *   content: "Refactor auth"     → activeForm: "Refactoring auth"
+     *   content: "Verify build"      → activeForm: "Verifying build"
+     *
+     * Optional. When absent, the spinner falls back to a generic verb (no
+     * regression vs pre-FEATURE_149 behavior). When the LLM provides
+     * activeForm via `todo_update`, the spinner picks it up live without
+     * waiting for the round to end — that's the user-visible "working on X
+     * now" feel CC achieves.
+     */
+    readonly activeForm?: string;
+    /**
+     * FEATURE_170 v0.7.41 — opaque per-task metadata bag carried alongside
+     * the item. Surface for downstream consumers (extension hooks, eval
+     * harnesses, future swarm features) to attach arbitrary structured
+     * context without forcing a schema change. UI does NOT render this.
+     * Empty / undefined when the LLM does not supply it.
+     */
+    readonly metadata?: Record<string, unknown>;
+}
+type TodoList = readonly TodoItem[];
+
+/**
+ * FEATURE_200 Phase F (v0.7.45) — repo-intelligence domain types extracted
+ * from types.ts. Self-contained; re-exported from ../types.ts (and 4 members
+ * re-imported there for internal use). `../types` importers unaffected.
+ */
+type KodaXRepoIntelligenceMode = 'auto' | 'off' | 'oss' | 'premium-shared' | 'premium-native';
+type KodaXRepoIntelligenceResolvedMode = 'off' | 'oss' | 'premium-shared' | 'premium-native';
+interface KodaXRepoIntelligenceCapability {
+    mode: KodaXRepoIntelligenceResolvedMode;
+    engine: 'oss' | 'premium';
+    bridge: 'none' | 'shared' | 'native';
+    level: 'basic' | 'enhanced';
+    status: 'ok' | 'limited' | 'unavailable' | 'warming';
+    warnings: string[];
+    contractVersion?: number;
+}
+interface KodaXRepoIntelligenceTrace {
+    mode: KodaXRepoIntelligenceResolvedMode;
+    engine: 'oss' | 'premium';
+    bridge: 'none' | 'shared' | 'native';
+    triggeredAt: string;
+    source: 'fallback' | 'premium';
+    daemonLatencyMs?: number;
+    cliLatencyMs?: number;
+    cacheHit?: boolean;
+    capsuleBytes?: number;
+    capsuleEstimatedTokens?: number;
+}
+/**
+ * Repo-intelligence retrieval trace event. Emitted by agent / managed-task
+ * pipelines (`emitRepoIntelligenceTrace` / `emitManagedRepoIntelligenceTrace`)
+ * at `routing` / `preturn` / `module` / `impact` / `task-snapshot` stages,
+ * consumed by REPL `json-events` (stdout JSONL contract), `cli-events`
+ * (interactive REPL), and `acp_server`.
+ *
+ * Note: FEATURE_083 (v0.7.24) initially marked this as superseded by
+ * `EvidenceSpan` in `@kodax-ai/agent`. **FEATURE_086 (v0.7.27) re-evaluated
+ * and retained it**: `EvidenceSpanData` is a generic
+ * `{ source, queryPreview?, resultCount?, cacheHit?, error? }` abstraction
+ * that does not carry the repo-intelligence-specific `stage` enum,
+ * `capability`, or `trace` bundle. The `stage` enum in particular is a
+ * typed contract that UI consumers (json-events schema) depend on;
+ * flattening it into a bag of attributes would drop type safety and break
+ * downstream script compatibility. This type is therefore a product
+ * feature of repo-intelligence, not legacy trace plumbing.
+ */
+interface KodaXRepoIntelligenceTraceEvent {
+    stage: 'routing' | 'preturn' | 'module' | 'impact' | 'task-snapshot';
+    summary: string;
+    capability?: KodaXRepoIntelligenceCapability;
+    trace?: KodaXRepoIntelligenceTrace;
+}
+
 interface KodaXEvents {
     onTextDelta?: (text: string) => void;
     onThinkingDelta?: (text: string) => void;
@@ -1008,6 +1164,22 @@ interface KodaXSessionOptions {
     scope?: KodaXSessionScope;
     storage?: KodaXSessionStorage;
     initialMessages?: KodaXMessage[];
+    /**
+     * Persistence ownership signal (FEATURE_173 dual-writer fix).
+     *
+     * When `true`, a higher-level host (the interactive REPL) owns writing
+     * this session to `storage` — it persists the full lineage / uiHistory /
+     * artifactLedger incrementally via `appendSessionDelta`. The runner MUST
+     * NOT also snapshot the session: `saveSessionSnapshot` early-returns so
+     * the runner's flat full-rewrite `storage.save` can never race / clobber
+     * the host's richer incremental writes (which regressed `activeEntryId`
+     * to the first round on resume).
+     *
+     * `storage` is still consulted for LOAD (resume / `resolveInitialMessages`
+     * tier 2). When absent (print CLI, ACP, SDK headless), the runner remains
+     * the sole writer — unchanged behaviour, fail-safe default.
+     */
+    persistedByHost?: boolean;
 }
 interface KodaXContextTokenSnapshot {
     /** Current best-known token count for the full conversation context. */
@@ -1030,143 +1202,6 @@ interface KodaXProviderPolicyHints {
     workIntent?: KodaXTaskWorkIntent;
 }
 
-type KodaXMcpTransport = McpTransportKind;
-type KodaXMcpConnectMode = McpConnectMode;
-type KodaXMcpServerConfig = McpServerConfig;
-/** Flat map of MCP server configs, keyed under `mcpServers` in config.json. */
-type KodaXMcpServersConfig = McpServersConfig;
-type KodaXRepoIntelligenceMode = 'auto' | 'off' | 'oss' | 'premium-shared' | 'premium-native';
-type KodaXRepoIntelligenceResolvedMode = 'off' | 'oss' | 'premium-shared' | 'premium-native';
-interface KodaXRepoIntelligenceCapability {
-    mode: KodaXRepoIntelligenceResolvedMode;
-    engine: 'oss' | 'premium';
-    bridge: 'none' | 'shared' | 'native';
-    level: 'basic' | 'enhanced';
-    status: 'ok' | 'limited' | 'unavailable' | 'warming';
-    warnings: string[];
-    contractVersion?: number;
-}
-interface KodaXRepoIntelligenceTrace {
-    mode: KodaXRepoIntelligenceResolvedMode;
-    engine: 'oss' | 'premium';
-    bridge: 'none' | 'shared' | 'native';
-    triggeredAt: string;
-    source: 'fallback' | 'premium';
-    daemonLatencyMs?: number;
-    cliLatencyMs?: number;
-    cacheHit?: boolean;
-    capsuleBytes?: number;
-    capsuleEstimatedTokens?: number;
-}
-/**
- * Repo-intelligence retrieval trace event. Emitted by agent / managed-task
- * pipelines (`emitRepoIntelligenceTrace` / `emitManagedRepoIntelligenceTrace`)
- * at `routing` / `preturn` / `module` / `impact` / `task-snapshot` stages,
- * consumed by REPL `json-events` (stdout JSONL contract), `cli-events`
- * (interactive REPL), and `acp_server`.
- *
- * Note: FEATURE_083 (v0.7.24) initially marked this as superseded by
- * `EvidenceSpan` in `@kodax-ai/agent`. **FEATURE_086 (v0.7.27) re-evaluated
- * and retained it**: `EvidenceSpanData` is a generic
- * `{ source, queryPreview?, resultCount?, cacheHit?, error? }` abstraction
- * that does not carry the repo-intelligence-specific `stage` enum,
- * `capability`, or `trace` bundle. The `stage` enum in particular is a
- * typed contract that UI consumers (json-events schema) depend on;
- * flattening it into a bag of attributes would drop type safety and break
- * downstream script compatibility. This type is therefore a product
- * feature of repo-intelligence, not legacy trace plumbing.
- */
-interface KodaXRepoIntelligenceTraceEvent {
-    stage: 'routing' | 'preturn' | 'module' | 'impact' | 'task-snapshot';
-    summary: string;
-    capability?: KodaXRepoIntelligenceCapability;
-    trace?: KodaXRepoIntelligenceTrace;
-}
-/**
- * Status of a planned todo item. Lifecycle: pending → in_progress →
- * (completed | failed | skipped). Failed items are reset to pending
- * when the next iteration begins (Evaluator revise verdict). Skipped
- * is for Planner-side merging of two obligations into one.
- */
-type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'skipped' | 'cancelled';
-/**
- * FEATURE_114 v0.7.36: Per-step deterministic evaluator hint. When a
- * todo item carries an `evaluator`, the runner runs the corresponding
- * deterministic check (build / test / lint) at the moment its status
- * transitions to `completed`. Failure surfaces stderr in the next
- * tool result so the Worker can self-correct. No LLM-as-judge
- * variant — Phase 0.7 industry survey said 4/4 codebases reject
- * per-step LLM verification.
- */
-type TodoEvaluatorHint = 'build' | 'test' | 'lint';
-/**
- * One row in the planner-produced todo list. Subject is the short
- * imperative title (shown in the UI row + throttle reminder); the
- * optional description carries fuller context for downstream consumers
- * that need the full work instruction. Sourced from Scout's existing
- * `executionObligations: string[]` payload (each string becomes the
- * `subject` of one seed item, no `description`). Status is advanced
- * via the `todo_update` tool by Scout (H0 path) / Worker / Generator /
- * Planner.
- *
- * v0.7.42 — `content` field renamed to `subject` to match claudecode V2
- * `TaskSchema` (TaskCreateTool's required `subject` + `description`
- * pair). KodaX makes `description` optional because trivial single-line
- * steps don't need it; weaker models reach the API more easily without
- * the forced second-string burden.
- *
- * `owner` partitions the list when child agents run in parallel under
- * `dispatch_child_task`; "main" is the parent thread.
- */
-interface TodoItem {
-    readonly id: string;
-    /** Brief imperative title — the row label users see in the plan list. */
-    readonly subject: string;
-    /**
-     * Optional fuller description / context. Read by the executing role
-     * when picking up an item (claudecode V2 `TaskGet`-style detail view).
-     * Not rendered in the compact plan-list row.
-     */
-    readonly description?: string;
-    readonly status: TodoStatus;
-    readonly owner?: string;
-    /** Index into the originating `executionObligations: string[]` array (0-based). */
-    readonly sourceObligationIndex?: number;
-    /** Optional note attached on a status transition (e.g. failure reason). */
-    readonly note?: string;
-    /**
-     * FEATURE_114 v0.7.36: per-step deterministic evaluator hint. When
-     * present, the runner runs the corresponding deterministic check on
-     * `pending → completed` and surfaces stderr / exit code in the next
-     * tool result on failure.
-     */
-    readonly evaluator?: TodoEvaluatorHint;
-    /**
-     * FEATURE_149 v0.7.38 (Slice C4) — present-continuous form of `content`,
-     * used by the spinner status line while this item is `in_progress`.
-     * Mirrors Claude Code's [`Spinner.tsx:169`](c:/Works/claudecode/src/components/Spinner.tsx#L169)
-     * `currentTodo?.activeForm` lookup. Examples:
-     *   content: "Run failing test"  → activeForm: "Running failing test"
-     *   content: "Refactor auth"     → activeForm: "Refactoring auth"
-     *   content: "Verify build"      → activeForm: "Verifying build"
-     *
-     * Optional. When absent, the spinner falls back to a generic verb (no
-     * regression vs pre-FEATURE_149 behavior). When the LLM provides
-     * activeForm via `todo_update`, the spinner picks it up live without
-     * waiting for the round to end — that's the user-visible "working on X
-     * now" feel CC achieves.
-     */
-    readonly activeForm?: string;
-    /**
-     * FEATURE_170 v0.7.41 — opaque per-task metadata bag carried alongside
-     * the item. Surface for downstream consumers (extension hooks, eval
-     * harnesses, future swarm features) to attach arbitrary structured
-     * context without forcing a schema change. UI does NOT render this.
-     * Empty / undefined when the LLM does not supply it.
-     */
-    readonly metadata?: Record<string, unknown>;
-}
-type TodoList = readonly TodoItem[];
 interface KodaXRepoRoutingSignals {
     workspaceRoot?: string;
     changedFileCount: number;
@@ -1290,6 +1325,14 @@ interface KodaXChildContextBundle {
      * preserves byte-identical v0.7.42 baseline dispatch behavior.
      */
     specialistName?: string;
+    /**
+     * FEATURE_102 Phase 2 (v0.7.45) — explicit per-dispatch provider/model the
+     * dispatching agent chose for this child (e.g. a cross-family second review).
+     * Priority in child-executor: `bundle.provider/model` > specialist's declared
+     * model > parent default. Omitting both inherits the parent (byte-identical).
+     */
+    provider?: string;
+    model?: string;
 }
 /**
  * FEATURE_120 v0.7.39 Phase 4 — model tier hint. Tier semantics:

package/dist/types-chunks/{file-tracker.d-DOfaoCbJ.d.ts → file-tracker.d-BNTIvsdb.d.ts}

@@ -1,6 +1,6 @@
-import { m as KodaXMessage } from './types.d-B1uGoVTE.js';
-import { f as AgentMessage, ag as SessionEntry, ae as Session, ah as SessionExtension, m as CompactionDetails, u as FileOperations } from './types.d-DM8zEJgF.js';
-import { s as KodaXSessionLineage, i as KodaXJsonValue, a as KodaXCompactMemorySeed, o as KodaXSessionEntry, z as KodaXSessionTreeNode, r as KodaXSessionLabelEntry, q as KodaXSessionGoalEntry, v as KodaXSessionNavigationOptions, k as KodaXSessionArtifactLedgerEntry } from './types.d-HBbWT-iA.js';
+import { n as KodaXMessage } from './types.d-Cf-GCzac.js';
+import { f as AgentMessage, ag as SessionEntry, ae as Session, ah as SessionExtension, m as CompactionDetails, u as FileOperations } from './types.d-D2RNa5Y7.js';
+import { s as KodaXSessionLineage, i as KodaXJsonValue, a as KodaXCompactMemorySeed, o as KodaXSessionEntry, z as KodaXSessionTreeNode, r as KodaXSessionLabelEntry, q as KodaXSessionGoalEntry, v as KodaXSessionNavigationOptions, k as KodaXSessionArtifactLedgerEntry } from './types.d-B_MIIApc.js';
 
 /**
  * @kodax-ai/agent Constants
@@ -457,7 +457,14 @@ declare class LineageCompaction implements CompactionPolicy {
 
 /**
  * 生成会话 ID
- * 格式: YYYYMMDD_HHMMSS
+ * 格式: YYYYMMDD_HHMMSS_<suffix>  (suffix = ms 低位 + 随机, base36)
+ *
+ * FEATURE_219 (v0.7.46): the date-prefix is preserved (sortable +
+ * human-readable), but a per-call suffix makes the id GLOBALLY unique.
+ * Under the pre-FEATURE_219 flat layout the filename collision silently
+ * masked two same-second sessions (overwrite risk); under the per-project
+ * directory layout the same id could otherwise exist in two project folders
+ * and make `loadSession(id)` ambiguous. See ADR-038 §7.
  */
 declare function generateSessionId(): Promise<string>;
 /**

package/dist/types-chunks/{resolver.d-B7ZnVuuf.d.ts → resolver.d-DkgJlEzr.d.ts}

@@ -1,6 +1,6 @@
-import { D as KodaXReasoningMode, U as KodaXThinkingBudgetMap, V as KodaXThinkingDepth, r as KodaXProviderConfig, C as KodaXReasoningCapability, F as KodaXReasoningRequest, Q as KodaXTaskType, E as KodaXReasoningOverride, X as KodaXToolDefinition, m as KodaXMessage, z as KodaXProviderStreamOptions, J as KodaXStreamResult, n as KodaXModelDescriptor, q as KodaXProviderCapabilityProfile, h as KodaXCustomProviderConfig } from './types.d-B1uGoVTE.js';
+import { E as KodaXReasoningMode, V as KodaXThinkingBudgetMap, W as KodaXThinkingDepth, s as KodaXProviderConfig, D as KodaXReasoningCapability, G as KodaXReasoningRequest, R as KodaXTaskType, F as KodaXReasoningOverride, a2 as KodaXVerifyCredentialResult, Y as KodaXToolDefinition, n as KodaXMessage, A as KodaXProviderStreamOptions, L as KodaXStreamResult, o as KodaXModelDescriptor, r as KodaXProviderCapabilityProfile, a3 as KodaXVerifyStrategy, h as KodaXCustomProviderConfig, m as KodaXListModelsResult } from './types.d-Cf-GCzac.js';
 import Anthropic from '@anthropic-ai/sdk';
-import { K as KodaXBaseProvider } from './base.d-FUJahC0i.js';
+import { K as KodaXBaseProvider } from './base.d-BdJKSPO2.js';
 import OpenAI from 'openai';
 
 /**
@@ -64,6 +64,24 @@ declare abstract class KodaXAnthropicCompatProvider extends KodaXBaseProvider {
     protected client: Anthropic;
     protected initClient(): void;
     protected onStaleConnection(): void;
+    /**
+     * FEATURE_216 v0.7.45 — Lightweight credential verification.
+     * Dispatches by `this.config.verifyStrategy`:
+     *   - `count-tokens` (default for Anthropic protocol): 0-token
+     *     `messages.countTokens()` — empirically reliable across 5/5
+     *     Anthropic-compat providers tested (anthropic / zhipu-coding /
+     *     kimi-code / minimax-coding / ark-coding).
+     *   - `models-list`: 0-token `models.list()` — supported by Anthropic
+     *     SDK 0.80+; not used by any Anthropic built-in but available
+     *     for custom providers that explicitly opt-in.
+     *   - `minimal-message`: ~7-token `messages.create({max_tokens:1})`
+     *     fallback for Anthropic-compat providers whose `count_tokens`
+     *     endpoint returns 404 (mimo / mimo-coding empirically).
+     */
+    verifyCredential(opts?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<KodaXVerifyCredentialResult>;
     /**
      * FEATURE_116 (v0.7.37) — Wrap a string `system` prompt as a single
      * cacheable text block. v1 treats the entire system prompt as one cache
@@ -107,6 +125,26 @@ declare abstract class KodaXOpenAICompatProvider extends KodaXBaseProvider {
     protected client: OpenAI;
     protected initClient(): void;
     protected onStaleConnection(): void;
+    /**
+     * FEATURE_216 v0.7.45 — Lightweight credential verification.
+     * Dispatches by `this.config.verifyStrategy`:
+     *   - `models-list` (default for OpenAI protocol): 0-token
+     *     `models.list()` — empirically reliable for openai-compat
+     *     providers where `/v1/models` gates on auth (kimi / qwen /
+     *     deepseek confirmed). Verified by opencode `setup-recording-env.ts`
+     *     for OPENAI_API_KEY proper.
+     *   - `minimal-message`: ~6-token `chat.completions.create({max_tokens:1})`
+     *     fallback for OpenAI-compat providers whose `/v1/models` is
+     *     publicly accessible (zhipu — false-positive risk).
+     *   - `count-tokens`: NOT supported on OpenAI protocol. Custom provider
+     *     validator rejects this combo at config time; built-in providers
+     *     never declare it. Orchestrator returns `unsupported` if it slips
+     *     through, surfacing the misconfiguration.
+     */
+    verifyCredential(opts?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<KodaXVerifyCredentialResult>;
     /**
      * FEATURE_116 (v0.7.37) — Strip any `cache-boundary` markers from
      * KodaXMessage content arrays before they reach OpenAI wire
@@ -154,7 +192,7 @@ declare abstract class KodaXOpenAICompatProvider extends KodaXBaseProvider {
  * Provider 注册表 - 统一管理所有 Provider
  */
 
-type ProviderName = 'anthropic' | 'openai' | 'deepseek' | 'kimi' | 'kimi-code' | 'qwen' | 'zhipu' | 'zhipu-coding' | 'minimax-coding' | 'mimo-coding' | 'ark-coding' | 'gemini-cli' | 'codex-cli';
+type ProviderName = 'anthropic' | 'openai' | 'deepseek' | 'kimi' | 'kimi-code' | 'qwen' | 'zhipu' | 'zhipu-coding' | 'minimax-coding' | 'mimo-coding' | 'mimo' | 'ark-coding' | 'gemini-cli' | 'codex-cli';
 /**
  * Per-provider static metadata. v0.7.43 promoted this from a partial
  * descriptor (`models: string[]`) to the full capability surface so
@@ -193,6 +231,12 @@ type ProviderSnapshot = {
     readonly thinkingBudgetCap?: number;
     /** Whether the provider supports `thinking_budget` / native reasoning. */
     readonly supportsThinking?: boolean;
+    /**
+     * FEATURE_216 v0.7.45 — Which verify primitive this provider supports
+     * for credential checks. Mirrors `provider-capabilities.types.ts`
+     * ProviderSnapshot's required field.
+     */
+    readonly verifyStrategy: KodaXVerifyStrategy;
 };
 declare const KODAX_PROVIDER_SNAPSHOTS: Record<ProviderName, ProviderSnapshot>;
 declare const KODAX_PROVIDERS: Record<string, () => KodaXBaseProvider>;
@@ -405,6 +449,38 @@ declare function resolveModelCapabilities(providerName: string, modelId: string)
  * checking `process.env[snapshot.apiKeyEnv]` if they care.
  */
 declare function listAllModelCapabilities(): KodaXModelCapabilities[];
+/**
+ * FEATURE_216 v0.7.45 — Top-level lightweight credential verification
+ * for any registered provider (built-in / custom / runtime).
+ *
+ * Never throws. Short-circuits before hitting the provider ctor for:
+ *   - unknown provider name → `unsupported`
+ *   - cli-bridge / `verifyStrategy='unsupported'` → `unsupported`
+ *   - env var missing → `unconfigured`  (avoids the `getApiKey()` throw)
+ *
+ * Otherwise instantiates via `resolveProvider(name)` and delegates to
+ * `provider.verifyCredential(opts)`. Cost: 0 tokens (count-tokens /
+ * models-list strategies) or ~6-7 tokens (minimal-message strategy).
+ */
+declare function verifyProviderCredential(name: string, opts?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<KodaXVerifyCredentialResult>;
+/**
+ * FEATURE_216 v0.7.45 — Returns the static model list KodaX maintains
+ * for a provider. Distinct from credential verification: this is for
+ * model-picker UIs in SDK consumers. Sourced from
+ * `provider-capabilities.json` for built-in providers + the custom
+ * registry for user-configured ones. Always `source: 'static'` in
+ * v0.7.45 — KodaX-curated list is the authoritative source per
+ * FEATURE_198 ("KodaX self-maintained snapshot is the only reliable
+ * source" — upstream `/v1/models` is noisy/inconsistent across
+ * providers). Future versions may add an opt-in upstream refresh.
+ */
+declare function listProviderModels(name: string, _opts?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<KodaXListModelsResult>;
 
-export { registerCustomProviders as $, getModelCapabilities as A, getProvider as B, getProviderConfiguredCapabilityProfile as C, getProviderConfiguredReasoningCapability as D, getProviderList as E, getProviderModel as F, getProviderModelDescriptors as G, getProviderModels as H, getReasoningCapability as I, getRuntimeModelProvider as J, KODAX_DEFAULT_PROVIDER as K, getRuntimeModelProviderNames as L, isCustomProviderName as M, isKnownProvider as N, isProviderConfigured as O, isProviderName as Q, isReasoningEnabled as R, isRuntimeModelProviderName as S, listAllModelCapabilities as T, listBuiltinModelCapabilities as U, listCustomProviderModelCapabilities as V, loadReasoningOverride as W, mapDepthToOpenAIReasoningEffort as X, normalizeReasoningRequest as Y, reasoningCapabilityToOverride as Z, reasoningOverrideToCapability as _, KODAX_DEFAULT_THINKING_BUDGETS as a, registerModelProvider as a0, resolveModelCapabilities as a1, resolveProvider as a2, resolveProviderModelDescriptors as a3, resolveThinkingBudget as a4, saveReasoningOverride as a5, validateCustomProviderConfig as a6, KODAX_PROVIDERS as b, KODAX_PROVIDER_SNAPSHOTS as c, KODAX_REASONING_MODE_SEQUENCE as d, KODAX_REASONING_SAFETY_RESERVE as e, KodaXAnthropicCompatProvider as f, KodaXError as g, KodaXNetworkError as i, KodaXOpenAICompatProvider as j, KodaXProviderError as k, KodaXRateLimitError as l, KodaXToolCallIdError as m, buildReasoningOverrideKey as n, clampThinkingBudget as o, clearReasoningOverride as p, clearRuntimeModelProviders as q, createCustomProvider as r, getAvailableProviderNames as s, getCustomModelCapabilities as t, getCustomProvider as u, getCustomProviderList as v, getCustomProviderModelDescriptors as w, getCustomProviderModels as x, getCustomProviderNames as y, getDefaultThinkingDepthForMode as z };
+export { reasoningOverrideToCapability as $, getModelCapabilities as A, getProvider as B, getProviderConfiguredCapabilityProfile as C, getProviderConfiguredReasoningCapability as D, getProviderList as E, getProviderModel as F, getProviderModelDescriptors as G, getProviderModels as H, getReasoningCapability as I, getRuntimeModelProvider as J, KODAX_DEFAULT_PROVIDER as K, getRuntimeModelProviderNames as L, isCustomProviderName as M, isKnownProvider as N, isProviderConfigured as O, isProviderName as Q, isReasoningEnabled as R, isRuntimeModelProviderName as S, listAllModelCapabilities as T, listBuiltinModelCapabilities as U, listCustomProviderModelCapabilities as V, listProviderModels as W, loadReasoningOverride as X, mapDepthToOpenAIReasoningEffort as Y, normalizeReasoningRequest as Z, reasoningCapabilityToOverride as _, KODAX_DEFAULT_THINKING_BUDGETS as a, registerCustomProviders as a0, registerModelProvider as a1, resolveModelCapabilities as a2, resolveProvider as a3, resolveProviderModelDescriptors as a4, resolveThinkingBudget as a5, saveReasoningOverride as a6, validateCustomProviderConfig as a7, verifyProviderCredential as a8, KODAX_PROVIDERS as b, KODAX_PROVIDER_SNAPSHOTS as c, KODAX_REASONING_MODE_SEQUENCE as d, KODAX_REASONING_SAFETY_RESERVE as e, KodaXAnthropicCompatProvider as f, KodaXError as g, KodaXNetworkError as i, KodaXOpenAICompatProvider as j, KodaXProviderError as k, KodaXRateLimitError as l, KodaXToolCallIdError as m, buildReasoningOverrideKey as n, clampThinkingBudget as o, clearReasoningOverride as p, clearRuntimeModelProviders as q, createCustomProvider as r, getAvailableProviderNames as s, getCustomModelCapabilities as t, getCustomProvider as u, getCustomProviderList as v, getCustomProviderModelDescriptors as w, getCustomProviderModels as x, getCustomProviderNames as y, getDefaultThinkingDepthForMode as z };
 export type { ProviderName as P, KodaXModelCapabilities as h };